From 7e466f7bee41d88e01d22e3a4c904e0e578630c9 Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Mon, 8 Jun 2020 12:58:25 -0700
Subject: [PATCH 0001/1164] Do not un-escape \ characters when parsing MONITOR
 output

Prior to this, escaped slashes ("\\") were un-escaped. This caused the strings
"foo\x92" and "foo\\x92" to be represented the same way in the output.

Fixes #1349
---
 redis/client.py       | 5 ++++-
 tests/test_monitor.py | 7 +++++++
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/redis/client.py b/redis/client.py
index 3471895d6b..5cf778ca24 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -3344,7 +3344,10 @@ def next_command(self):
         m = self.monitor_re.match(command_data)
         db_id, client_info, command = m.groups()
         command = ' '.join(self.command_re.findall(command))
-        command = command.replace('\\"', '"').replace('\\\\', '\\')
+        # Redis escapes double quotes because each piece of the command
+        # string is surrounded by double quotes. We don't have that
+        # requirement so remove the escaping and leave the quote.
+        command = command.replace('\\"', '"')
 
         if client_info == 'lua':
             client_address = 'lua'
diff --git a/tests/test_monitor.py b/tests/test_monitor.py
index 0e39ec064d..ee5dc6e39c 100644
--- a/tests/test_monitor.py
+++ b/tests/test_monitor.py
@@ -34,6 +34,13 @@ def test_command_with_binary_data(self, r):
             response = wait_for_command(r, m, 'GET foo\\x92')
             assert response['command'] == 'GET foo\\x92'
 
+    def test_command_with_escaped_data(self, r):
+        with r.monitor() as m:
+            byte_string = b'foo\\x92'
+            r.get(byte_string)
+            response = wait_for_command(r, m, 'GET foo\\\\x92')
+            assert response['command'] == 'GET foo\\\\x92'
+
     def test_lua_script(self, r):
         with r.monitor() as m:
             script = 'return redis.call("GET", "foo")'

From 67ae97addcb8344554f703d8ec6e0b7433b84f71 Mon Sep 17 00:00:00 2001
From: Roey Prat <roey.prat@redislabs.com>
Date: Mon, 29 Jun 2020 10:34:46 +0300
Subject: [PATCH 0002/1164] mark and close stale issues and PRs

---
 .github/workflows/stale-issues.yml | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 .github/workflows/stale-issues.yml

diff --git a/.github/workflows/stale-issues.yml b/.github/workflows/stale-issues.yml
new file mode 100644
index 0000000000..562cd582b1
--- /dev/null
+++ b/.github/workflows/stale-issues.yml
@@ -0,0 +1,20 @@
+name: "Close stale issues"
+on:
+  schedule:
+  - cron: "0 0 * * *"
+
+jobs:
+  stale:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/stale@v3
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        stale-issue-message: 'This issue is marked stale. It will be closed in 30 days if it is not updated.'
+        stale-pr-message: 'This pull request is marked stale. It will be closed in 30 days if it is not updated.'
+        days-before-stale: 365
+        days-before-close: 30
+        stale-issue-label: "Stale"
+        stale-pr-label: "Stale"
+        operations-per-run: 10
+        remove-stale-when-updated: true

From d71379186e75441909657cd2f6395e89583078fd Mon Sep 17 00:00:00 2001
From: Andrew Brookins <a.m.brookins@gmail.com>
Date: Fri, 26 Jun 2020 10:07:57 -0700
Subject: [PATCH 0003/1164] Fix acl_setuser docstring

Fix the docstring for acl_setuser() so that it refers to the correct parameter name,`passwords`.
---
 redis/client.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/client.py b/redis/client.py
index 5cf778ca24..9de90fbd9a 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -993,7 +993,7 @@ def acl_setuser(self, username, enabled=False, nopass=False,
         ``passwords`` if specified is a list of plain text passwords
         to add to or remove from the user. Each password must be prefixed with
         a '+' to add or a '-' to remove. For convenience, the value of
-        ``add_passwords`` can be a simple prefixed string when adding or
+        ``passwords`` can be a simple prefixed string when adding or
         removing a single password.
 
         ``hashed_passwords`` if specified is a list of SHA-256 hashed passwords

From 67c2fca8bb2208d57f74ad34da52c0ca2d9e29dc Mon Sep 17 00:00:00 2001
From: Roey Prat <roey.prat@redislabs.com>
Date: Mon, 29 Jun 2020 21:58:03 +0300
Subject: [PATCH 0004/1164] upgrade tests to use redis 6.0.5

---
 .travis.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index d530e4af3f..05dd94c25f 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -32,7 +32,7 @@ matrix:
     - python: pypy3
       env: TOXENV=pypy3-hiredis
 before_install:
-  - wget https://github.com/antirez/redis/archive/6.0-rc1.tar.gz && mkdir redis_install && tar -xvzf 6.0-rc1.tar.gz -C redis_install && cd redis_install/redis-6.0-rc1 && make && src/redis-server --daemonize yes && cd ../..
+  - wget https://github.com/antirez/redis/archive/6.0.5.tar.gz && mkdir redis_install && tar -xvzf 6.0.5.tar.gz -C redis_install && cd redis_install/redis-6.0.5 && make && src/redis-server --daemonize yes && cd ../..
   - redis-cli info
 install:
   - pip install codecov tox

From 4dca0db0092d260c228f4d25e588faebc7927f8f Mon Sep 17 00:00:00 2001
From: Rick van Hattem <wolph@wol.ph>
Date: Mon, 29 Jun 2020 23:38:33 +0200
Subject: [PATCH 0005/1164] Add `redis.sentinel.Sentinel` module documentation
 (#1165)

Added directive to document Sentinel module.
---
 docs/index.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/index.rst b/docs/index.rst
index e441beef74..bc1a4fac41 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -21,3 +21,6 @@ Contents:
 
 .. automodule:: redis
    :members:
+
+.. automodule:: redis.sentinel
+   :members:

From a67a47d5c3f4cd22b4a9658aa4b182593906ec39 Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Mon, 29 Jun 2020 14:46:46 -0700
Subject: [PATCH 0006/1164] changelog

---
 CHANGES | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGES b/CHANGES
index 98f3f73679..e20ef3bfe8 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,4 +1,4 @@
-* (in development)
+* 3.5.3 (June 1, 2020)
     * Restore try/except clauses to __del__ methods. These will be removed
       in 4.0 when more explicit resource management if enforced. #1339
     * Update the master_address when Sentinels promote a new master. #847

From 10fb0c5814709fd6dca1fc666fbfd8b172fb08bc Mon Sep 17 00:00:00 2001
From: Roey Prat <roey.prat@redislabs.com>
Date: Sun, 5 Jul 2020 09:15:08 +0300
Subject: [PATCH 0007/1164] documentation: fix ssl typos in the changelog

---
 CHANGES | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGES b/CHANGES
index e20ef3bfe8..03b2354e9d 100644
--- a/CHANGES
+++ b/CHANGES
@@ -459,7 +459,7 @@
     * Fixed a bug where some encodings (like utf-16) were unusable on Python 3
       as command names and literals would get encoded.
     * Added an SSLConnection class that allows for secure connections through
-      stunnel or other means. Construct and SSL connection with the sll=True
+      stunnel or other means. Construct an SSL connection with the ssl=True
       option on client classes, using the rediss:// scheme from an URL, or
       by passing the SSLConnection class to a connection pool's
       connection_class argument. Thanks https://github.com/oranagra.

From 7e28b233391e673732fd47d8f78a0364aa5561be Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Wed, 8 Jul 2020 18:59:31 +0000
Subject: [PATCH 0008/1164] WIP: All processes in a single container

---
 Dockerfile                           | 18 ++++++++++++
 build_tools/bootstrap.sh             |  3 +-
 build_tools/build_redis.sh           |  7 ++---
 build_tools/install_redis.sh         | 16 ++++-------
 build_tools/install_sentinel.sh      | 17 ++++--------
 build_tools/redis-configs/001-master |  1 +
 build_tools/redis-configs/002-slave  |  1 +
 build_tools/redis_vars.sh            | 41 +++-------------------------
 build_tools/sentinel-configs/001-1   |  1 +
 build_tools/sentinel-configs/002-2   |  1 +
 build_tools/sentinel-configs/003-3   |  1 +
 build_tools/start.sh                 |  9 ++++++
 docker-compose.yml                   | 13 +++++++++
 13 files changed, 64 insertions(+), 65 deletions(-)
 create mode 100644 Dockerfile
 create mode 100755 build_tools/start.sh
 create mode 100644 docker-compose.yml

diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000000..898f5bfec4
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,18 @@
+FROM ubuntu:20.04
+
+COPY build_tools /build_tools
+
+RUN /build_tools/bootstrap.sh
+RUN /build_tools/build_redis.sh
+RUN /build_tools/install_redis.sh
+RUN /build_tools/install_sentinel.sh
+
+COPY build_tools/start.sh /var/lib/redis/start.sh
+
+EXPOSE 6379
+EXPOSE 6380
+EXPOSE 26379
+EXPOSE 26380
+EXPOSE 26381
+
+CMD /var/lib/redis/start.sh
diff --git a/build_tools/bootstrap.sh b/build_tools/bootstrap.sh
index a5a0d2ce83..7125326de8 100755
--- a/build_tools/bootstrap.sh
+++ b/build_tools/bootstrap.sh
@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
 
 # need make to build redis
-sudo apt-get install make
+apt-get update
+apt-get install -y make apt-utils wget build-essential
diff --git a/build_tools/build_redis.sh b/build_tools/build_redis.sh
index 379c6cc936..f530bf0860 100755
--- a/build_tools/build_redis.sh
+++ b/build_tools/build_redis.sh
@@ -1,11 +1,8 @@
 #!/usr/bin/env bash
 
-source /home/vagrant/redis-py/build_tools/redis_vars.sh
+source /build_tools/redis_vars.sh
 
-pushd /home/vagrant
-
-uninstall_all_sentinel_instances
-uninstall_all_redis_instances
+pushd /tmp
 
 # create a clean directory for redis
 rm -rf $REDIS_DIR
diff --git a/build_tools/install_redis.sh b/build_tools/install_redis.sh
index fd53a1ca88..0e9d4b2259 100755
--- a/build_tools/install_redis.sh
+++ b/build_tools/install_redis.sh
@@ -1,28 +1,25 @@
 #!/usr/bin/env bash
 
-source /home/vagrant/redis-py/build_tools/redis_vars.sh
+source /build_tools/redis_vars.sh
 
-for filename in `ls $VAGRANT_REDIS_CONF_DIR`; do
+for filename in `ls $BUILD_REDIS_CONF_DIR`; do
     # cuts the order prefix off of the filename, e.g. 001-master -> master
     PROCESS_NAME=redis-`echo $filename | cut -f 2- -d -`
     echo "======================================"
     echo "INSTALLING REDIS SERVER: $PROCESS_NAME"
     echo "======================================"
 
-    # make sure the instance is uninstalled (it should be already)
-    uninstall_instance $PROCESS_NAME
-
     # base config
     mkdir -p $REDIS_CONF_DIR
     cp $REDIS_BUILD_DIR/redis.conf $REDIS_CONF_DIR/$PROCESS_NAME.conf
     # override config values from file
-    cat $VAGRANT_REDIS_CONF_DIR/$filename >> $REDIS_CONF_DIR/$PROCESS_NAME.conf
+    cat $BUILD_REDIS_CONF_DIR/$filename >> $REDIS_CONF_DIR/$PROCESS_NAME.conf
 
     # replace placeholder variables in init.d script
-    cp $VAGRANT_DIR/redis_init_script /etc/init.d/$PROCESS_NAME
+    cp $BUILD_DIR/redis_init_script /etc/init.d/$PROCESS_NAME
     sed -i "s/{{ PROCESS_NAME }}/$PROCESS_NAME/g" /etc/init.d/$PROCESS_NAME
     # need to read the config file to find out what port this instance will run on
-    port=`grep port $VAGRANT_REDIS_CONF_DIR/$filename | cut -f 2 -d " "`
+    port=`grep port $BUILD_REDIS_CONF_DIR/$filename | cut -f 2 -d " "`
     sed -i "s/{{ PORT }}/$port/g" /etc/init.d/$PROCESS_NAME
     chmod 755 /etc/init.d/$PROCESS_NAME
 
@@ -31,7 +28,4 @@ for filename in `ls $VAGRANT_REDIS_CONF_DIR`; do
 
     # save the $PROCESS_NAME into installed instances file
     echo $PROCESS_NAME >> $REDIS_INSTALLED_INSTANCES_FILE
-
-    # start redis
-    /etc/init.d/$PROCESS_NAME start
 done
diff --git a/build_tools/install_sentinel.sh b/build_tools/install_sentinel.sh
index 0597208ccf..0aa21effb9 100755
--- a/build_tools/install_sentinel.sh
+++ b/build_tools/install_sentinel.sh
@@ -1,28 +1,26 @@
 #!/usr/bin/env bash
 
-source /home/vagrant/redis-py/build_tools/redis_vars.sh
+source /build_tools/redis_vars.sh
 
-for filename in `ls $VAGRANT_SENTINEL_CONF_DIR`; do
+
+for filename in `ls $BUILD_SENTINEL_CONF_DIR`; do
     # cuts the order prefix off of the filename, e.g. 001-master -> master
     PROCESS_NAME=sentinel-`echo $filename | cut -f 2- -d -`
     echo "========================================="
     echo "INSTALLING SENTINEL SERVER: $PROCESS_NAME"
     echo "========================================="
 
-    # make sure the instance is uninstalled (it should be already)
-    uninstall_instance $PROCESS_NAME
-
     # base config
     mkdir -p $REDIS_CONF_DIR
     cp $REDIS_BUILD_DIR/sentinel.conf $REDIS_CONF_DIR/$PROCESS_NAME.conf
     # override config values from file
-    cat $VAGRANT_SENTINEL_CONF_DIR/$filename >> $REDIS_CONF_DIR/$PROCESS_NAME.conf
+    cat $BUILD_SENTINEL_CONF_DIR/$filename >> $REDIS_CONF_DIR/$PROCESS_NAME.conf
 
     # replace placeholder variables in init.d script
-    cp $VAGRANT_DIR/sentinel_init_script /etc/init.d/$PROCESS_NAME
+    cp $BUILD_DIR/sentinel_init_script /etc/init.d/$PROCESS_NAME
     sed -i "s/{{ PROCESS_NAME }}/$PROCESS_NAME/g" /etc/init.d/$PROCESS_NAME
     # need to read the config file to find out what port this instance will run on
-    port=`grep port $VAGRANT_SENTINEL_CONF_DIR/$filename | cut -f 2 -d " "`
+    port=`grep port $BUILD_SENTINEL_CONF_DIR/$filename | cut -f 2 -d " "`
     sed -i "s/{{ PORT }}/$port/g" /etc/init.d/$PROCESS_NAME
     chmod 755 /etc/init.d/$PROCESS_NAME
 
@@ -31,7 +29,4 @@ for filename in `ls $VAGRANT_SENTINEL_CONF_DIR`; do
 
     # save the $PROCESS_NAME into installed instances file
     echo $PROCESS_NAME >> $SENTINEL_INSTALLED_INSTANCES_FILE
-
-    # start redis
-    /etc/init.d/$PROCESS_NAME start
 done
diff --git a/build_tools/redis-configs/001-master b/build_tools/redis-configs/001-master
index 8591f1a61e..cd1c984a93 100644
--- a/build_tools/redis-configs/001-master
+++ b/build_tools/redis-configs/001-master
@@ -6,3 +6,4 @@ unixsocket /tmp/redis_master.sock
 unixsocketperm 777
 dbfilename master.rdb
 dir /var/lib/redis/backups
+logfile /var/log/redis-master
diff --git a/build_tools/redis-configs/002-slave b/build_tools/redis-configs/002-slave
index 13eb77ec4d..b51cb8464c 100644
--- a/build_tools/redis-configs/002-slave
+++ b/build_tools/redis-configs/002-slave
@@ -6,5 +6,6 @@ unixsocket /tmp/redis-slave.sock
 unixsocketperm 777
 dbfilename slave.rdb
 dir /var/lib/redis/backups
+logfile /var/log/redis-slave
 
 slaveof 127.0.0.1 6379
diff --git a/build_tools/redis_vars.sh b/build_tools/redis_vars.sh
index c52dd4cf37..b80ff5550e 100755
--- a/build_tools/redis_vars.sh
+++ b/build_tools/redis_vars.sh
@@ -1,10 +1,10 @@
 #!/usr/bin/env bash
 
-VAGRANT_DIR=/home/vagrant/redis-py/build_tools
-VAGRANT_REDIS_CONF_DIR=$VAGRANT_DIR/redis-configs
-VAGRANT_SENTINEL_CONF_DIR=$VAGRANT_DIR/sentinel-configs
+BUILD_DIR=/build_tools
+BUILD_REDIS_CONF_DIR=$BUILD_DIR/redis-configs
+BUILD_SENTINEL_CONF_DIR=$BUILD_DIR/sentinel-configs
 REDIS_VERSION=3.2.0
-REDIS_DOWNLOAD_DIR=/home/vagrant/redis-downloads
+REDIS_DOWNLOAD_DIR=/tmp/redis-downloads
 REDIS_PACKAGE=redis-$REDIS_VERSION.tar.gz
 REDIS_BUILD_DIR=$REDIS_DOWNLOAD_DIR/redis-$REDIS_VERSION
 REDIS_DIR=/var/lib/redis
@@ -13,36 +13,3 @@ REDIS_CONF_DIR=$REDIS_DIR/conf
 REDIS_SAVE_DIR=$REDIS_DIR/backups
 REDIS_INSTALLED_INSTANCES_FILE=$REDIS_DIR/redis-instances
 SENTINEL_INSTALLED_INSTANCES_FILE=$REDIS_DIR/sentinel-instances
-
-function uninstall_instance() {
-    # Expects $1 to be the init.d filename, e.g. redis-nodename or
-    # sentinel-nodename
-
-    if [ -a /etc/init.d/$1 ]; then
-
-        echo "======================================"
-        echo "UNINSTALLING REDIS SERVER: $1"
-        echo "======================================"
-
-        /etc/init.d/$1 stop
-        update-rc.d -f $1 remove
-        rm -f /etc/init.d/$1
-    fi;
-    rm -f $REDIS_CONF_DIR/$1.conf
-}
-
-function uninstall_all_redis_instances() {
-    if [ -a $REDIS_INSTALLED_INSTANCES_FILE ]; then
-        cat $REDIS_INSTALLED_INSTANCES_FILE | while read line; do
-            uninstall_instance $line;
-        done;
-    fi
-}
-
-function uninstall_all_sentinel_instances() {
-    if [ -a $SENTINEL_INSTALLED_INSTANCES_FILE ]; then
-        cat $SENTINEL_INSTALLED_INSTANCES_FILE | while read line; do
-            uninstall_instance $line;
-        done;
-    fi
-}
diff --git a/build_tools/sentinel-configs/001-1 b/build_tools/sentinel-configs/001-1
index eccc3d1f84..d12979fc0f 100644
--- a/build_tools/sentinel-configs/001-1
+++ b/build_tools/sentinel-configs/001-1
@@ -1,6 +1,7 @@
 pidfile /var/run/sentinel-1.pid
 port 26379
 daemonize yes
+logfile /var/log/redis-sentinel-1
 
 # short timeout for sentinel tests
 sentinel down-after-milliseconds mymaster 500
diff --git a/build_tools/sentinel-configs/002-2 b/build_tools/sentinel-configs/002-2
index 0cd28019c4..9ab89348a4 100644
--- a/build_tools/sentinel-configs/002-2
+++ b/build_tools/sentinel-configs/002-2
@@ -1,6 +1,7 @@
 pidfile /var/run/sentinel-2.pid
 port 26380
 daemonize yes
+logfile /var/log/redis-sentinel-2
 
 # short timeout for sentinel tests
 sentinel down-after-milliseconds mymaster 500
diff --git a/build_tools/sentinel-configs/003-3 b/build_tools/sentinel-configs/003-3
index c7f4fcd335..b971b2ff45 100644
--- a/build_tools/sentinel-configs/003-3
+++ b/build_tools/sentinel-configs/003-3
@@ -1,6 +1,7 @@
 pidfile /var/run/sentinel-3.pid
 port 26381
 daemonize yes
+logfile /var/log/redis-sentinel-3
 
 # short timeout for sentinel tests
 sentinel down-after-milliseconds mymaster 500
diff --git a/build_tools/start.sh b/build_tools/start.sh
new file mode 100755
index 0000000000..c394b949aa
--- /dev/null
+++ b/build_tools/start.sh
@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+
+/etc/init.d/redis-master start
+/etc/init.d/redis-slave start
+/etc/init.d/sentinel-1 start
+/etc/init.d/sentinel-2 start
+/etc/init.d/sentinel-3 start
+
+tail -f /var/log/redis-master /var/log/redis-slave /var/log/redis-sentinel-1 /var/log/redis-sentinel-2 /var/log/redis-sentinel-3 
diff --git a/docker-compose.yml b/docker-compose.yml
new file mode 100644
index 0000000000..9c61dd4cd8
--- /dev/null
+++ b/docker-compose.yml
@@ -0,0 +1,13 @@
+version: "3.8"
+
+services:
+  redis-py:
+    build: ./
+    ports:
+      - "6379:6379"
+      - "6380:6380"
+      - "26379:26379"
+      - "26380:26380"
+      - "26381:26381"
+    volumes:
+       - .:/mnt/redis-py

From afb4594cbe8dbbfaaa618819fedaf3e823f8f846 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Wed, 8 Jul 2020 23:31:14 +0000
Subject: [PATCH 0009/1164] Use one container per process

---
 Dockerfile                   | 18 ------------------
 docker-compose.yml           | 22 ++++++++++++++++++----
 docker/master/Dockerfile     |  7 +++++++
 docker/master/redis.conf     |  9 +++++++++
 docker/sentinel_1/Dockerfile |  7 +++++++
 docker/sentinel_1/redis.conf |  7 +++++++
 docker/sentinel_2/Dockerfile |  7 +++++++
 docker/sentinel_2/redis.conf |  7 +++++++
 docker/sentinel_3/Dockerfile |  7 +++++++
 docker/sentinel_3/redis.conf |  7 +++++++
 docker/slave/Dockerfile      |  7 +++++++
 docker/slave/redis.conf      | 11 +++++++++++
 12 files changed, 94 insertions(+), 22 deletions(-)
 delete mode 100644 Dockerfile
 create mode 100644 docker/master/Dockerfile
 create mode 100644 docker/master/redis.conf
 create mode 100644 docker/sentinel_1/Dockerfile
 create mode 100644 docker/sentinel_1/redis.conf
 create mode 100644 docker/sentinel_2/Dockerfile
 create mode 100644 docker/sentinel_2/redis.conf
 create mode 100644 docker/sentinel_3/Dockerfile
 create mode 100644 docker/sentinel_3/redis.conf
 create mode 100644 docker/slave/Dockerfile
 create mode 100644 docker/slave/redis.conf

diff --git a/Dockerfile b/Dockerfile
deleted file mode 100644
index 898f5bfec4..0000000000
--- a/Dockerfile
+++ /dev/null
@@ -1,18 +0,0 @@
-FROM ubuntu:20.04
-
-COPY build_tools /build_tools
-
-RUN /build_tools/bootstrap.sh
-RUN /build_tools/build_redis.sh
-RUN /build_tools/install_redis.sh
-RUN /build_tools/install_sentinel.sh
-
-COPY build_tools/start.sh /var/lib/redis/start.sh
-
-EXPOSE 6379
-EXPOSE 6380
-EXPOSE 26379
-EXPOSE 26380
-EXPOSE 26381
-
-CMD /var/lib/redis/start.sh
diff --git a/docker-compose.yml b/docker-compose.yml
index 9c61dd4cd8..f335f3c73e 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,13 +1,27 @@
 version: "3.8"
 
 services:
-  redis-py:
-    build: ./
+  master:
+    build: docker/master
     ports:
       - "6379:6379"
+
+  slave:
+    build: docker/slave
+    ports:
       - "6380:6380"
+
+  sentinel_1:
+    build: docker/sentinel_1
+    ports:
       - "26379:26379"
+
+  sentinel_2:
+    build: docker/sentinel_2
+    ports:
       - "26380:26380"
+
+  sentinel_3:
+    build: docker/sentinel_3
+    ports:
       - "26381:26381"
-    volumes:
-       - .:/mnt/redis-py
diff --git a/docker/master/Dockerfile b/docker/master/Dockerfile
new file mode 100644
index 0000000000..c51249db3a
--- /dev/null
+++ b/docker/master/Dockerfile
@@ -0,0 +1,7 @@
+FROM redis:6.0.5-buster
+
+COPY redis.conf /etc/conf/redis/redis.conf
+
+EXPOSE 6379
+
+CMD redis-server
diff --git a/docker/master/redis.conf b/docker/master/redis.conf
new file mode 100644
index 0000000000..cd1c984a93
--- /dev/null
+++ b/docker/master/redis.conf
@@ -0,0 +1,9 @@
+pidfile /var/run/redis-master.pid
+bind *
+port 6379
+daemonize yes
+unixsocket /tmp/redis_master.sock
+unixsocketperm 777
+dbfilename master.rdb
+dir /var/lib/redis/backups
+logfile /var/log/redis-master
diff --git a/docker/sentinel_1/Dockerfile b/docker/sentinel_1/Dockerfile
new file mode 100644
index 0000000000..016d873f9b
--- /dev/null
+++ b/docker/sentinel_1/Dockerfile
@@ -0,0 +1,7 @@
+FROM redis:6.0.5-buster
+
+COPY redis.conf /etc/conf/redis/redis.conf
+
+EXPOSE 26379
+
+CMD redis-server
diff --git a/docker/sentinel_1/redis.conf b/docker/sentinel_1/redis.conf
new file mode 100644
index 0000000000..d12979fc0f
--- /dev/null
+++ b/docker/sentinel_1/redis.conf
@@ -0,0 +1,7 @@
+pidfile /var/run/sentinel-1.pid
+port 26379
+daemonize yes
+logfile /var/log/redis-sentinel-1
+
+# short timeout for sentinel tests
+sentinel down-after-milliseconds mymaster 500
diff --git a/docker/sentinel_2/Dockerfile b/docker/sentinel_2/Dockerfile
new file mode 100644
index 0000000000..1a379beb4e
--- /dev/null
+++ b/docker/sentinel_2/Dockerfile
@@ -0,0 +1,7 @@
+FROM redis:6.0.5-buster
+
+COPY redis.conf /etc/conf/redis/redis.conf
+
+EXPOSE 26380
+
+CMD redis-server
diff --git a/docker/sentinel_2/redis.conf b/docker/sentinel_2/redis.conf
new file mode 100644
index 0000000000..9ab89348a4
--- /dev/null
+++ b/docker/sentinel_2/redis.conf
@@ -0,0 +1,7 @@
+pidfile /var/run/sentinel-2.pid
+port 26380
+daemonize yes
+logfile /var/log/redis-sentinel-2
+
+# short timeout for sentinel tests
+sentinel down-after-milliseconds mymaster 500
diff --git a/docker/sentinel_3/Dockerfile b/docker/sentinel_3/Dockerfile
new file mode 100644
index 0000000000..e1e92d8c16
--- /dev/null
+++ b/docker/sentinel_3/Dockerfile
@@ -0,0 +1,7 @@
+FROM redis:6.0.5-buster
+
+COPY redis.conf /etc/conf/redis/redis.conf
+
+EXPOSE 26381
+
+CMD redis-server
diff --git a/docker/sentinel_3/redis.conf b/docker/sentinel_3/redis.conf
new file mode 100644
index 0000000000..b971b2ff45
--- /dev/null
+++ b/docker/sentinel_3/redis.conf
@@ -0,0 +1,7 @@
+pidfile /var/run/sentinel-3.pid
+port 26381
+daemonize yes
+logfile /var/log/redis-sentinel-3
+
+# short timeout for sentinel tests
+sentinel down-after-milliseconds mymaster 500
diff --git a/docker/slave/Dockerfile b/docker/slave/Dockerfile
new file mode 100644
index 0000000000..f9bd1ad004
--- /dev/null
+++ b/docker/slave/Dockerfile
@@ -0,0 +1,7 @@
+FROM redis:6.0.5-buster
+
+COPY redis.conf /etc/conf/redis/redis.conf
+
+EXPOSE 6380
+
+CMD redis-server
diff --git a/docker/slave/redis.conf b/docker/slave/redis.conf
new file mode 100644
index 0000000000..b51cb8464c
--- /dev/null
+++ b/docker/slave/redis.conf
@@ -0,0 +1,11 @@
+pidfile /var/run/redis-slave.pid
+bind *
+port 6380
+daemonize yes
+unixsocket /tmp/redis-slave.sock
+unixsocketperm 777
+dbfilename slave.rdb
+dir /var/lib/redis/backups
+logfile /var/log/redis-slave
+
+slaveof 127.0.0.1 6379

From 08e99c6cba06946293f3ddb8fc72b78a9d3058fe Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Wed, 8 Jul 2020 16:55:07 -0700
Subject: [PATCH 0010/1164] Ignore venv and env directories

---
 .gitignore | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.gitignore b/.gitignore
index 7de7594812..a9b10171fe 100644
--- a/.gitignore
+++ b/.gitignore
@@ -11,3 +11,5 @@ vagrant/.vagrant
 .eggs
 .idea
 .coverage
+env
+venv

From e7f9e3fce5d01929527d14b6b5938dd8daef8836 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Wed, 8 Jul 2020 16:55:19 -0700
Subject: [PATCH 0011/1164] Skip flake8 checks on virtualenv dirs

---
 setup.cfg | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.cfg b/setup.cfg
index e57440c71f..6500cd872c 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -36,7 +36,7 @@ python_requires = >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
 hiredis = hiredis>=0.1.3
 
 [flake8]
-exclude = .venv,.tox,dist,docs,build,*.egg,redis_install
+exclude = .venv,.tox,dist,docs,build,*.egg,redis_install,env,venv
 
 [bdist_wheel]
 universal = 1

From bd1d7936c11b3fd750a3e48a2e554f2f0b317d19 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Wed, 8 Jul 2020 17:18:11 -0700
Subject: [PATCH 0012/1164] Revert build_tools to Vagrant versions

---
 build_tools/bootstrap.sh             |  3 +-
 build_tools/build_redis.sh           |  7 +++--
 build_tools/install_redis.sh         | 16 +++++++----
 build_tools/install_sentinel.sh      | 17 ++++++++----
 build_tools/redis-configs/001-master |  1 -
 build_tools/redis-configs/002-slave  |  1 -
 build_tools/redis_vars.sh            | 41 +++++++++++++++++++++++++---
 build_tools/sentinel-configs/001-1   |  1 -
 build_tools/sentinel-configs/002-2   |  1 -
 build_tools/sentinel-configs/003-3   |  1 -
 build_tools/start.sh                 |  9 ------
 11 files changed, 65 insertions(+), 33 deletions(-)
 delete mode 100755 build_tools/start.sh

diff --git a/build_tools/bootstrap.sh b/build_tools/bootstrap.sh
index 7125326de8..a5a0d2ce83 100755
--- a/build_tools/bootstrap.sh
+++ b/build_tools/bootstrap.sh
@@ -1,5 +1,4 @@
 #!/usr/bin/env bash
 
 # need make to build redis
-apt-get update
-apt-get install -y make apt-utils wget build-essential
+sudo apt-get install make
diff --git a/build_tools/build_redis.sh b/build_tools/build_redis.sh
index f530bf0860..379c6cc936 100755
--- a/build_tools/build_redis.sh
+++ b/build_tools/build_redis.sh
@@ -1,8 +1,11 @@
 #!/usr/bin/env bash
 
-source /build_tools/redis_vars.sh
+source /home/vagrant/redis-py/build_tools/redis_vars.sh
 
-pushd /tmp
+pushd /home/vagrant
+
+uninstall_all_sentinel_instances
+uninstall_all_redis_instances
 
 # create a clean directory for redis
 rm -rf $REDIS_DIR
diff --git a/build_tools/install_redis.sh b/build_tools/install_redis.sh
index 0e9d4b2259..fd53a1ca88 100755
--- a/build_tools/install_redis.sh
+++ b/build_tools/install_redis.sh
@@ -1,25 +1,28 @@
 #!/usr/bin/env bash
 
-source /build_tools/redis_vars.sh
+source /home/vagrant/redis-py/build_tools/redis_vars.sh
 
-for filename in `ls $BUILD_REDIS_CONF_DIR`; do
+for filename in `ls $VAGRANT_REDIS_CONF_DIR`; do
     # cuts the order prefix off of the filename, e.g. 001-master -> master
     PROCESS_NAME=redis-`echo $filename | cut -f 2- -d -`
     echo "======================================"
     echo "INSTALLING REDIS SERVER: $PROCESS_NAME"
     echo "======================================"
 
+    # make sure the instance is uninstalled (it should be already)
+    uninstall_instance $PROCESS_NAME
+
     # base config
     mkdir -p $REDIS_CONF_DIR
     cp $REDIS_BUILD_DIR/redis.conf $REDIS_CONF_DIR/$PROCESS_NAME.conf
     # override config values from file
-    cat $BUILD_REDIS_CONF_DIR/$filename >> $REDIS_CONF_DIR/$PROCESS_NAME.conf
+    cat $VAGRANT_REDIS_CONF_DIR/$filename >> $REDIS_CONF_DIR/$PROCESS_NAME.conf
 
     # replace placeholder variables in init.d script
-    cp $BUILD_DIR/redis_init_script /etc/init.d/$PROCESS_NAME
+    cp $VAGRANT_DIR/redis_init_script /etc/init.d/$PROCESS_NAME
     sed -i "s/{{ PROCESS_NAME }}/$PROCESS_NAME/g" /etc/init.d/$PROCESS_NAME
     # need to read the config file to find out what port this instance will run on
-    port=`grep port $BUILD_REDIS_CONF_DIR/$filename | cut -f 2 -d " "`
+    port=`grep port $VAGRANT_REDIS_CONF_DIR/$filename | cut -f 2 -d " "`
     sed -i "s/{{ PORT }}/$port/g" /etc/init.d/$PROCESS_NAME
     chmod 755 /etc/init.d/$PROCESS_NAME
 
@@ -28,4 +31,7 @@ for filename in `ls $BUILD_REDIS_CONF_DIR`; do
 
     # save the $PROCESS_NAME into installed instances file
     echo $PROCESS_NAME >> $REDIS_INSTALLED_INSTANCES_FILE
+
+    # start redis
+    /etc/init.d/$PROCESS_NAME start
 done
diff --git a/build_tools/install_sentinel.sh b/build_tools/install_sentinel.sh
index 0aa21effb9..0597208ccf 100755
--- a/build_tools/install_sentinel.sh
+++ b/build_tools/install_sentinel.sh
@@ -1,26 +1,28 @@
 #!/usr/bin/env bash
 
-source /build_tools/redis_vars.sh
+source /home/vagrant/redis-py/build_tools/redis_vars.sh
 
-
-for filename in `ls $BUILD_SENTINEL_CONF_DIR`; do
+for filename in `ls $VAGRANT_SENTINEL_CONF_DIR`; do
     # cuts the order prefix off of the filename, e.g. 001-master -> master
     PROCESS_NAME=sentinel-`echo $filename | cut -f 2- -d -`
     echo "========================================="
     echo "INSTALLING SENTINEL SERVER: $PROCESS_NAME"
     echo "========================================="
 
+    # make sure the instance is uninstalled (it should be already)
+    uninstall_instance $PROCESS_NAME
+
     # base config
     mkdir -p $REDIS_CONF_DIR
     cp $REDIS_BUILD_DIR/sentinel.conf $REDIS_CONF_DIR/$PROCESS_NAME.conf
     # override config values from file
-    cat $BUILD_SENTINEL_CONF_DIR/$filename >> $REDIS_CONF_DIR/$PROCESS_NAME.conf
+    cat $VAGRANT_SENTINEL_CONF_DIR/$filename >> $REDIS_CONF_DIR/$PROCESS_NAME.conf
 
     # replace placeholder variables in init.d script
-    cp $BUILD_DIR/sentinel_init_script /etc/init.d/$PROCESS_NAME
+    cp $VAGRANT_DIR/sentinel_init_script /etc/init.d/$PROCESS_NAME
     sed -i "s/{{ PROCESS_NAME }}/$PROCESS_NAME/g" /etc/init.d/$PROCESS_NAME
     # need to read the config file to find out what port this instance will run on
-    port=`grep port $BUILD_SENTINEL_CONF_DIR/$filename | cut -f 2 -d " "`
+    port=`grep port $VAGRANT_SENTINEL_CONF_DIR/$filename | cut -f 2 -d " "`
     sed -i "s/{{ PORT }}/$port/g" /etc/init.d/$PROCESS_NAME
     chmod 755 /etc/init.d/$PROCESS_NAME
 
@@ -29,4 +31,7 @@ for filename in `ls $BUILD_SENTINEL_CONF_DIR`; do
 
     # save the $PROCESS_NAME into installed instances file
     echo $PROCESS_NAME >> $SENTINEL_INSTALLED_INSTANCES_FILE
+
+    # start redis
+    /etc/init.d/$PROCESS_NAME start
 done
diff --git a/build_tools/redis-configs/001-master b/build_tools/redis-configs/001-master
index cd1c984a93..8591f1a61e 100644
--- a/build_tools/redis-configs/001-master
+++ b/build_tools/redis-configs/001-master
@@ -6,4 +6,3 @@ unixsocket /tmp/redis_master.sock
 unixsocketperm 777
 dbfilename master.rdb
 dir /var/lib/redis/backups
-logfile /var/log/redis-master
diff --git a/build_tools/redis-configs/002-slave b/build_tools/redis-configs/002-slave
index b51cb8464c..13eb77ec4d 100644
--- a/build_tools/redis-configs/002-slave
+++ b/build_tools/redis-configs/002-slave
@@ -6,6 +6,5 @@ unixsocket /tmp/redis-slave.sock
 unixsocketperm 777
 dbfilename slave.rdb
 dir /var/lib/redis/backups
-logfile /var/log/redis-slave
 
 slaveof 127.0.0.1 6379
diff --git a/build_tools/redis_vars.sh b/build_tools/redis_vars.sh
index b80ff5550e..c52dd4cf37 100755
--- a/build_tools/redis_vars.sh
+++ b/build_tools/redis_vars.sh
@@ -1,10 +1,10 @@
 #!/usr/bin/env bash
 
-BUILD_DIR=/build_tools
-BUILD_REDIS_CONF_DIR=$BUILD_DIR/redis-configs
-BUILD_SENTINEL_CONF_DIR=$BUILD_DIR/sentinel-configs
+VAGRANT_DIR=/home/vagrant/redis-py/build_tools
+VAGRANT_REDIS_CONF_DIR=$VAGRANT_DIR/redis-configs
+VAGRANT_SENTINEL_CONF_DIR=$VAGRANT_DIR/sentinel-configs
 REDIS_VERSION=3.2.0
-REDIS_DOWNLOAD_DIR=/tmp/redis-downloads
+REDIS_DOWNLOAD_DIR=/home/vagrant/redis-downloads
 REDIS_PACKAGE=redis-$REDIS_VERSION.tar.gz
 REDIS_BUILD_DIR=$REDIS_DOWNLOAD_DIR/redis-$REDIS_VERSION
 REDIS_DIR=/var/lib/redis
@@ -13,3 +13,36 @@ REDIS_CONF_DIR=$REDIS_DIR/conf
 REDIS_SAVE_DIR=$REDIS_DIR/backups
 REDIS_INSTALLED_INSTANCES_FILE=$REDIS_DIR/redis-instances
 SENTINEL_INSTALLED_INSTANCES_FILE=$REDIS_DIR/sentinel-instances
+
+function uninstall_instance() {
+    # Expects $1 to be the init.d filename, e.g. redis-nodename or
+    # sentinel-nodename
+
+    if [ -a /etc/init.d/$1 ]; then
+
+        echo "======================================"
+        echo "UNINSTALLING REDIS SERVER: $1"
+        echo "======================================"
+
+        /etc/init.d/$1 stop
+        update-rc.d -f $1 remove
+        rm -f /etc/init.d/$1
+    fi;
+    rm -f $REDIS_CONF_DIR/$1.conf
+}
+
+function uninstall_all_redis_instances() {
+    if [ -a $REDIS_INSTALLED_INSTANCES_FILE ]; then
+        cat $REDIS_INSTALLED_INSTANCES_FILE | while read line; do
+            uninstall_instance $line;
+        done;
+    fi
+}
+
+function uninstall_all_sentinel_instances() {
+    if [ -a $SENTINEL_INSTALLED_INSTANCES_FILE ]; then
+        cat $SENTINEL_INSTALLED_INSTANCES_FILE | while read line; do
+            uninstall_instance $line;
+        done;
+    fi
+}
diff --git a/build_tools/sentinel-configs/001-1 b/build_tools/sentinel-configs/001-1
index d12979fc0f..eccc3d1f84 100644
--- a/build_tools/sentinel-configs/001-1
+++ b/build_tools/sentinel-configs/001-1
@@ -1,7 +1,6 @@
 pidfile /var/run/sentinel-1.pid
 port 26379
 daemonize yes
-logfile /var/log/redis-sentinel-1
 
 # short timeout for sentinel tests
 sentinel down-after-milliseconds mymaster 500
diff --git a/build_tools/sentinel-configs/002-2 b/build_tools/sentinel-configs/002-2
index 9ab89348a4..0cd28019c4 100644
--- a/build_tools/sentinel-configs/002-2
+++ b/build_tools/sentinel-configs/002-2
@@ -1,7 +1,6 @@
 pidfile /var/run/sentinel-2.pid
 port 26380
 daemonize yes
-logfile /var/log/redis-sentinel-2
 
 # short timeout for sentinel tests
 sentinel down-after-milliseconds mymaster 500
diff --git a/build_tools/sentinel-configs/003-3 b/build_tools/sentinel-configs/003-3
index b971b2ff45..c7f4fcd335 100644
--- a/build_tools/sentinel-configs/003-3
+++ b/build_tools/sentinel-configs/003-3
@@ -1,7 +1,6 @@
 pidfile /var/run/sentinel-3.pid
 port 26381
 daemonize yes
-logfile /var/log/redis-sentinel-3
 
 # short timeout for sentinel tests
 sentinel down-after-milliseconds mymaster 500
diff --git a/build_tools/start.sh b/build_tools/start.sh
deleted file mode 100755
index c394b949aa..0000000000
--- a/build_tools/start.sh
+++ /dev/null
@@ -1,9 +0,0 @@
-#!/usr/bin/env bash
-
-/etc/init.d/redis-master start
-/etc/init.d/redis-slave start
-/etc/init.d/sentinel-1 start
-/etc/init.d/sentinel-2 start
-/etc/init.d/sentinel-3 start
-
-tail -f /var/log/redis-master /var/log/redis-slave /var/log/redis-sentinel-1 /var/log/redis-sentinel-2 /var/log/redis-sentinel-3 

From 58ca166a9c7228f24fdd074c4785fe7303851cd4 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Thu, 9 Jul 2020 14:53:00 -0700
Subject: [PATCH 0013/1164] WIP on base image

---
 Makefile                     | 12 ++++++++++++
 docker-compose.yml           |  6 ++++++
 docker/base/Dockerfile       |  1 +
 docker/master/Dockerfile     |  2 +-
 docker/sentinel_1/Dockerfile |  2 +-
 docker/sentinel_2/Dockerfile |  2 +-
 docker/sentinel_3/Dockerfile |  2 +-
 docker/slave/Dockerfile      |  2 +-
 tests/conftest.py            | 11 +++++++++--
 9 files changed, 33 insertions(+), 7 deletions(-)
 create mode 100644 Makefile
 create mode 100644 docker/base/Dockerfile

diff --git a/Makefile b/Makefile
new file mode 100644
index 0000000000..fb3e0b6ab6
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,12 @@
+.PHONY: base
+
+build:
+	docker build -t redis-py-base docker/base
+	docker-compose down
+	docker-compose build
+
+dev:
+	docker-compose up -d
+
+test: dev
+	docker-compose run test tox --redis-url="redis://master:6379/9"
diff --git a/docker-compose.yml b/docker-compose.yml
index f335f3c73e..c7a7c0a2b0 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -25,3 +25,9 @@ services:
     build: docker/sentinel_3
     ports:
       - "26381:26381"
+
+  test:
+    image: fkrull/multi-python:latest
+    working_dir: /redis-py
+    volumes:
+      - .:/redis-py
diff --git a/docker/base/Dockerfile b/docker/base/Dockerfile
new file mode 100644
index 0000000000..ab973861da
--- /dev/null
+++ b/docker/base/Dockerfile
@@ -0,0 +1 @@
+FROM redis:6.0.5-buster
diff --git a/docker/master/Dockerfile b/docker/master/Dockerfile
index c51249db3a..af81fb30c0 100644
--- a/docker/master/Dockerfile
+++ b/docker/master/Dockerfile
@@ -1,4 +1,4 @@
-FROM redis:6.0.5-buster
+FROM redis-py-base:latest
 
 COPY redis.conf /etc/conf/redis/redis.conf
 
diff --git a/docker/sentinel_1/Dockerfile b/docker/sentinel_1/Dockerfile
index 016d873f9b..e3c3e7b16d 100644
--- a/docker/sentinel_1/Dockerfile
+++ b/docker/sentinel_1/Dockerfile
@@ -1,4 +1,4 @@
-FROM redis:6.0.5-buster
+FROM redis-py-base:latest
 
 COPY redis.conf /etc/conf/redis/redis.conf
 
diff --git a/docker/sentinel_2/Dockerfile b/docker/sentinel_2/Dockerfile
index 1a379beb4e..cd59777d3c 100644
--- a/docker/sentinel_2/Dockerfile
+++ b/docker/sentinel_2/Dockerfile
@@ -1,4 +1,4 @@
-FROM redis:6.0.5-buster
+FROM redis-py-base:latest
 
 COPY redis.conf /etc/conf/redis/redis.conf
 
diff --git a/docker/sentinel_3/Dockerfile b/docker/sentinel_3/Dockerfile
index e1e92d8c16..2e81a15500 100644
--- a/docker/sentinel_3/Dockerfile
+++ b/docker/sentinel_3/Dockerfile
@@ -1,4 +1,4 @@
-FROM redis:6.0.5-buster
+FROM redis-py-base:latest
 
 COPY redis.conf /etc/conf/redis/redis.conf
 
diff --git a/docker/slave/Dockerfile b/docker/slave/Dockerfile
index f9bd1ad004..74c1fb0903 100644
--- a/docker/slave/Dockerfile
+++ b/docker/slave/Dockerfile
@@ -1,4 +1,4 @@
-FROM redis:6.0.5-buster
+FROM redis-py-base:latest
 
 COPY redis.conf /etc/conf/redis/redis.conf
 
diff --git a/tests/conftest.py b/tests/conftest.py
index 7d64609be8..4398175b1e 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -14,14 +14,21 @@
 
 
 REDIS_INFO = {}
-default_redis_url = "redis://localhost:6379/9"
+DEFAULT_REDIS_URL = "redis://localhost:6379/9"
+DEFAULT_REDIS_MASTER_HOST = "localhost"
+
 
 
 def pytest_addoption(parser):
-    parser.addoption('--redis-url', default=default_redis_url,
+    parser.addoption('--redis-url', default=DEFAULT_REDIS_URL,
                      action="store",
                      help="Redis connection string,"
                           " defaults to `%(default)s`")
+    parser.addoption('--master-host', default=DEFAULT_REDIS_MASTER_HOST,
+                     action="store",
+                     help="Redis master hostname,"
+                          " defaults to `%(default)s`")
+
 
 
 def _get_info(redis_url):

From c31ea12e89141dd90a69180060ae386948831f19 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Thu, 9 Jul 2020 16:15:23 -0700
Subject: [PATCH 0014/1164] Pass the master hostname to tests

---
 Makefile                      |  3 ++-
 tests/conftest.py             |  7 +++++-
 tests/test_connection_pool.py | 42 ++++++++++++++++++++++-------------
 tests/test_multiprocessing.py | 16 ++++++-------
 tests/test_sentinel.py        | 35 +++++++++++++++++------------
 5 files changed, 63 insertions(+), 40 deletions(-)

diff --git a/Makefile b/Makefile
index fb3e0b6ab6..ad1eb55f8d 100644
--- a/Makefile
+++ b/Makefile
@@ -9,4 +9,5 @@ dev:
 	docker-compose up -d
 
 test: dev
-	docker-compose run test tox --redis-url="redis://master:6379/9"
+	find . -name "*.pyc" -exec rm -f {} \;
+	docker-compose run test tox -- --redis-url="redis://master:6379/9" --redis-master-host=master
diff --git a/tests/conftest.py b/tests/conftest.py
index 4398175b1e..4a745df005 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -24,7 +24,7 @@ def pytest_addoption(parser):
                      action="store",
                      help="Redis connection string,"
                           " defaults to `%(default)s`")
-    parser.addoption('--master-host', default=DEFAULT_REDIS_MASTER_HOST,
+    parser.addoption('--redis-master-host', default=DEFAULT_REDIS_MASTER_HOST,
                      action="store",
                      help="Redis master hostname,"
                           " defaults to `%(default)s`")
@@ -163,6 +163,11 @@ def mock_cluster_resp_slaves(request, **kwargs):
     return _gen_cluster_mock_resp(r, response)
 
 
+@pytest.fixture(scope="module")
+def master_host(request):
+    yield request.config.getoption("--redis-master-host")
+
+
 def wait_for_command(client, monitor, command):
     # issue a command with a key name that's local to this process.
     # if we find a command with our key before the command we're waiting
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 080e3df5b5..2f8ffbf034 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -43,21 +43,25 @@ def test_connection_creation(self):
         assert isinstance(connection, DummyConnection)
         assert connection.kwargs == connection_kwargs
 
-    def test_multiple_connections(self):
-        pool = self.get_pool()
+    def test_multiple_connections(self, master_host):
+        connection_kwargs = {'host': master_host}
+        pool = self.get_pool(connection_kwargs=connection_kwargs)
         c1 = pool.get_connection('_')
         c2 = pool.get_connection('_')
         assert c1 != c2
 
-    def test_max_connections(self):
-        pool = self.get_pool(max_connections=2)
+    def test_max_connections(self, master_host):
+        connection_kwargs = {'host': master_host}
+        pool = self.get_pool(max_connections=2,
+                             connection_kwargs=connection_kwargs)
         pool.get_connection('_')
         pool.get_connection('_')
         with pytest.raises(redis.ConnectionError):
             pool.get_connection('_')
 
-    def test_reuse_previously_released_connection(self):
-        pool = self.get_pool()
+    def test_reuse_previously_released_connection(self, master_host):
+        connection_kwargs = {'host': master_host}
+        pool = self.get_pool(connection_kwargs=connection_kwargs)
         c1 = pool.get_connection('_')
         pool.release(c1)
         c2 = pool.get_connection('_')
@@ -98,22 +102,25 @@ def get_pool(self, connection_kwargs=None, max_connections=10, timeout=20):
                                             **connection_kwargs)
         return pool
 
-    def test_connection_creation(self):
-        connection_kwargs = {'foo': 'bar', 'biz': 'baz'}
+    def test_connection_creation(self, master_host):
+        connection_kwargs = {'foo': 'bar', 'biz': 'baz', 'host': master_host}
         pool = self.get_pool(connection_kwargs=connection_kwargs)
         connection = pool.get_connection('_')
         assert isinstance(connection, DummyConnection)
         assert connection.kwargs == connection_kwargs
 
-    def test_multiple_connections(self):
-        pool = self.get_pool()
+    def test_multiple_connections(self, master_host):
+        connection_kwargs = {'host': master_host}
+        pool = self.get_pool(connection_kwargs=connection_kwargs)
         c1 = pool.get_connection('_')
         c2 = pool.get_connection('_')
         assert c1 != c2
 
-    def test_connection_pool_blocks_until_timeout(self):
+    def test_connection_pool_blocks_until_timeout(self, master_host):
         "When out of connections, block for timeout seconds, then raise"
-        pool = self.get_pool(max_connections=1, timeout=0.1)
+        connection_kwargs = {'host': master_host}
+        pool = self.get_pool(max_connections=1, timeout=0.1,
+                             connection_kwargs=connection_kwargs)
         pool.get_connection('_')
 
         start = time.time()
@@ -122,12 +129,14 @@ def test_connection_pool_blocks_until_timeout(self):
         # we should have waited at least 0.1 seconds
         assert time.time() - start >= 0.1
 
-    def connection_pool_blocks_until_another_connection_released(self):
+    def test_connection_pool_blocks_until_another_connection_released(self, master_host):
         """
         When out of connections, block until another connection is released
         to the pool
         """
-        pool = self.get_pool(max_connections=1, timeout=2)
+        connection_kwargs = {'host': master_host}
+        pool = self.get_pool(max_connections=1, timeout=2,
+                             connection_kwargs=connection_kwargs)
         c1 = pool.get_connection('_')
 
         def target():
@@ -139,8 +148,9 @@ def target():
         pool.get_connection('_')
         assert time.time() - start >= 0.1
 
-    def test_reuse_previously_released_connection(self):
-        pool = self.get_pool()
+    def test_reuse_previously_released_connection(self, master_host):
+        connection_kwargs = {'host': master_host}
+        pool = self.get_pool(connection_kwargs=connection_kwargs)
         c1 = pool.get_connection('_')
         pool.release(c1)
         c2 = pool.get_connection('_')
diff --git a/tests/test_multiprocessing.py b/tests/test_multiprocessing.py
index 3f81606836..235e3cee0f 100644
--- a/tests/test_multiprocessing.py
+++ b/tests/test_multiprocessing.py
@@ -30,12 +30,12 @@ def r(self, request):
             request=request,
             single_connection_client=False)
 
-    def test_close_connection_in_child(self):
+    def test_close_connection_in_child(self, master_host):
         """
         A connection owned by a parent and closed by a child doesn't
         destroy the file descriptors so a parent can still use it.
         """
-        conn = Connection()
+        conn = Connection(host=master_host)
         conn.send_command('ping')
         assert conn.read_response() == b'PONG'
 
@@ -56,12 +56,12 @@ def target(conn):
         conn.send_command('ping')
         assert conn.read_response() == b'PONG'
 
-    def test_close_connection_in_parent(self):
+    def test_close_connection_in_parent(self, master_host):
         """
         A connection owned by a parent is unusable by a child if the parent
         (the owning process) closes the connection.
         """
-        conn = Connection()
+        conn = Connection(host=master_host)
         conn.send_command('ping')
         assert conn.read_response() == b'PONG'
 
@@ -84,12 +84,12 @@ def target(conn, ev):
         assert proc.exitcode == 0
 
     @pytest.mark.parametrize('max_connections', [1, 2, None])
-    def test_pool(self, max_connections):
+    def test_pool(self, max_connections, master_host):
         """
         A child will create its own connections when using a pool created
         by a parent.
         """
-        pool = ConnectionPool.from_url('redis://localhost',
+        pool = ConnectionPool.from_url('redis://{}'.format(master_host),
                                        max_connections=max_connections)
 
         conn = pool.get_connection('ping')
@@ -119,12 +119,12 @@ def target(pool):
             assert conn.read_response() == b'PONG'
 
     @pytest.mark.parametrize('max_connections', [1, 2, None])
-    def test_close_pool_in_main(self, max_connections):
+    def test_close_pool_in_main(self, max_connections, master_host):
         """
         A child process that uses the same pool as its parent isn't affected
         when the parent disconnects all connections within the pool.
         """
-        pool = ConnectionPool.from_url('redis://localhost',
+        pool = ConnectionPool.from_url('redis://{}'.format(master_host),
                                        max_connections=max_connections)
 
         conn = pool.get_connection('ping')
diff --git a/tests/test_sentinel.py b/tests/test_sentinel.py
index 1081e2b3f3..c247c723bf 100644
--- a/tests/test_sentinel.py
+++ b/tests/test_sentinel.py
@@ -1,3 +1,5 @@
+import socket
+
 import pytest
 
 from redis import exceptions
@@ -7,6 +9,11 @@
 import redis.sentinel
 
 
+@pytest.fixture(scope="module")
+def master_ip(master_host):
+    yield socket.gethostbyname(master_host)
+
+
 class SentinelTestClient(object):
     def __init__(self, cluster, id):
         self.cluster = cluster
@@ -54,10 +61,10 @@ def client(self, host, port, **kwargs):
 
 
 @pytest.fixture()
-def cluster(request):
+def cluster(request, master_ip):
     def teardown():
         redis.sentinel.Redis = saved_Redis
-    cluster = SentinelTestCluster()
+    cluster = SentinelTestCluster(ip=master_ip)
     saved_Redis = redis.sentinel.Redis
     redis.sentinel.Redis = cluster.client
     request.addfinalizer(teardown)
@@ -69,9 +76,9 @@ def sentinel(request, cluster):
     return Sentinel([('foo', 26379), ('bar', 26379)])
 
 
-def test_discover_master(sentinel):
+def test_discover_master(sentinel, master_ip):
     address = sentinel.discover_master('mymaster')
-    assert address == ('127.0.0.1', 6379)
+    assert address == (master_ip, 6379)
 
 
 def test_discover_master_error(sentinel):
@@ -79,32 +86,32 @@ def test_discover_master_error(sentinel):
         sentinel.discover_master('xxx')
 
 
-def test_discover_master_sentinel_down(cluster, sentinel):
+def test_discover_master_sentinel_down(cluster, sentinel, master_ip):
     # Put first sentinel 'foo' down
     cluster.nodes_down.add(('foo', 26379))
     address = sentinel.discover_master('mymaster')
-    assert address == ('127.0.0.1', 6379)
+    assert address == (master_ip, 6379)
     # 'bar' is now first sentinel
     assert sentinel.sentinels[0].id == ('bar', 26379)
 
 
-def test_discover_master_sentinel_timeout(cluster, sentinel):
+def test_discover_master_sentinel_timeout(cluster, sentinel, master_ip):
     # Put first sentinel 'foo' down
     cluster.nodes_timeout.add(('foo', 26379))
     address = sentinel.discover_master('mymaster')
-    assert address == ('127.0.0.1', 6379)
+    assert address == (master_ip, 6379)
     # 'bar' is now first sentinel
     assert sentinel.sentinels[0].id == ('bar', 26379)
 
 
-def test_master_min_other_sentinels(cluster):
+def test_master_min_other_sentinels(cluster, master_ip):
     sentinel = Sentinel([('foo', 26379)], min_other_sentinels=1)
     # min_other_sentinels
     with pytest.raises(MasterNotFoundError):
         sentinel.discover_master('mymaster')
     cluster.master['num-other-sentinels'] = 2
     address = sentinel.discover_master('mymaster')
-    assert address == ('127.0.0.1', 6379)
+    assert address == (master_ip, 6379)
 
 
 def test_master_odown(cluster, sentinel):
@@ -153,10 +160,10 @@ def test_discover_slaves(cluster, sentinel):
         ('slave0', 1234), ('slave1', 1234)]
 
 
-def test_master_for(cluster, sentinel):
+def test_master_for(cluster, sentinel, master_ip):
     master = sentinel.master_for('mymaster', db=9)
     assert master.ping()
-    assert master.connection_pool.master_address == ('127.0.0.1', 6379)
+    assert master.connection_pool.master_address == (master_ip, 6379)
 
     # Use internal connection check
     master = sentinel.master_for('mymaster', db=9, check_connection=True)
@@ -179,7 +186,7 @@ def test_slave_for_slave_not_found_error(cluster, sentinel):
         slave.ping()
 
 
-def test_slave_round_robin(cluster, sentinel):
+def test_slave_round_robin(cluster, sentinel, master_ip):
     cluster.slaves = [
         {'ip': 'slave0', 'port': 6379, 'is_odown': False, 'is_sdown': False},
         {'ip': 'slave1', 'port': 6379, 'is_odown': False, 'is_sdown': False},
@@ -189,6 +196,6 @@ def test_slave_round_robin(cluster, sentinel):
     assert next(rotator) in (('slave0', 6379), ('slave1', 6379))
     assert next(rotator) in (('slave0', 6379), ('slave1', 6379))
     # Fallback to master
-    assert next(rotator) == ('127.0.0.1', 6379)
+    assert next(rotator) == (master_ip, 6379)
     with pytest.raises(SlaveNotFoundError):
         next(rotator)

From a1e5a7685fda4fc8ebe6456988c18e14724bb05a Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Thu, 9 Jul 2020 16:30:10 -0700
Subject: [PATCH 0015/1164] Fix flake8 errors

---
 setup.cfg                     | 2 +-
 tests/conftest.py             | 2 --
 tests/test_connection_pool.py | 2 +-
 3 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/setup.cfg b/setup.cfg
index 6500cd872c..430cba081e 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -36,7 +36,7 @@ python_requires = >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
 hiredis = hiredis>=0.1.3
 
 [flake8]
-exclude = .venv,.tox,dist,docs,build,*.egg,redis_install,env,venv
+exclude = .venv,.tox,dist,docs,build,*.egg,redis_install,env,venv,.undodir
 
 [bdist_wheel]
 universal = 1
diff --git a/tests/conftest.py b/tests/conftest.py
index 4a745df005..704a7e37eb 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -18,7 +18,6 @@
 DEFAULT_REDIS_MASTER_HOST = "localhost"
 
 
-
 def pytest_addoption(parser):
     parser.addoption('--redis-url', default=DEFAULT_REDIS_URL,
                      action="store",
@@ -30,7 +29,6 @@ def pytest_addoption(parser):
                           " defaults to `%(default)s`")
 
 
-
 def _get_info(redis_url):
     client = redis.Redis.from_url(redis_url)
     info = client.info()
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 2f8ffbf034..40ac3407db 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -129,7 +129,7 @@ def test_connection_pool_blocks_until_timeout(self, master_host):
         # we should have waited at least 0.1 seconds
         assert time.time() - start >= 0.1
 
-    def test_connection_pool_blocks_until_another_connection_released(self, master_host):
+    def test_connection_pool_blocks_until_another_connection_released(self, master_host):  # noqa: E501
         """
         When out of connections, block until another connection is released
         to the pool

From e0460b2f5004d068b83a4b701413d9ac64e0e04f Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Fri, 10 Jul 2020 10:54:16 -0700
Subject: [PATCH 0016/1164] Use the existing --redis-url param to get master
 host

---
 Makefile          |  2 +-
 tests/conftest.py | 16 +++++++---------
 2 files changed, 8 insertions(+), 10 deletions(-)

diff --git a/Makefile b/Makefile
index ad1eb55f8d..1b29336489 100644
--- a/Makefile
+++ b/Makefile
@@ -10,4 +10,4 @@ dev:
 
 test: dev
 	find . -name "*.pyc" -exec rm -f {} \;
-	docker-compose run test tox -- --redis-url="redis://master:6379/9" --redis-master-host=master
+	docker-compose run test tox -- --redis-url=redis://master:6379/9
diff --git a/tests/conftest.py b/tests/conftest.py
index 704a7e37eb..caca8cc51d 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -4,6 +4,7 @@
 import redis
 from mock import Mock
 
+from redis._compat import urlparse
 from distutils.version import StrictVersion
 
 
@@ -14,19 +15,14 @@
 
 
 REDIS_INFO = {}
-DEFAULT_REDIS_URL = "redis://localhost:6379/9"
-DEFAULT_REDIS_MASTER_HOST = "localhost"
+default_redis_url = "redis://localhost:6379/9"
 
 
 def pytest_addoption(parser):
-    parser.addoption('--redis-url', default=DEFAULT_REDIS_URL,
+    parser.addoption('--redis-url', default=default_redis_url,
                      action="store",
                      help="Redis connection string,"
                           " defaults to `%(default)s`")
-    parser.addoption('--redis-master-host', default=DEFAULT_REDIS_MASTER_HOST,
-                     action="store",
-                     help="Redis master hostname,"
-                          " defaults to `%(default)s`")
 
 
 def _get_info(redis_url):
@@ -161,9 +157,11 @@ def mock_cluster_resp_slaves(request, **kwargs):
     return _gen_cluster_mock_resp(r, response)
 
 
-@pytest.fixture(scope="module")
+@pytest.fixture(scope="session")
 def master_host(request):
-    yield request.config.getoption("--redis-master-host")
+    url = request.config.getoption("--redis-url")
+    parts = urlparse(url)
+    yield parts.hostname
 
 
 def wait_for_command(client, monitor, command):

From b5c2f2e650d152c5f1da5f5e3be9ebe4189972a4 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Fri, 10 Jul 2020 11:26:36 -0700
Subject: [PATCH 0017/1164] Don't shut down containers when building

---
 Makefile | 1 -
 1 file changed, 1 deletion(-)

diff --git a/Makefile b/Makefile
index 1b29336489..f86cbad5e3 100644
--- a/Makefile
+++ b/Makefile
@@ -2,7 +2,6 @@
 
 build:
 	docker build -t redis-py-base docker/base
-	docker-compose down
 	docker-compose build
 
 dev:

From cec8e77b510eae7720cdf7258deb0a0085a9af12 Mon Sep 17 00:00:00 2001
From: Roey Prat <roey.prat@redislabs.com>
Date: Mon, 13 Jul 2020 19:41:29 +0300
Subject: [PATCH 0018/1164] Support for loading, unloading and listing Redis
 Modules (#1360)

* Support for loading, unloading and listing Redis Modules

* minor fixes for flake

* unit test for module list - only the empty use case

* ModuleError should inherit from ResponseError rather than RedisError

Co-authored-by: Vamsi Atluri <vamc19@gmail.com>
---
 redis/client.py        | 33 +++++++++++++++++++++++++++++++++
 redis/connection.py    | 13 +++++++++++++
 redis/exceptions.py    |  4 ++++
 tests/test_commands.py |  5 +++++
 4 files changed, 55 insertions(+)

diff --git a/redis/client.py b/redis/client.py
index 9de90fbd9a..9653f7d294 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -22,6 +22,7 @@
     ResponseError,
     TimeoutError,
     WatchError,
+    ModuleError,
 )
 
 SYM_EMPTY = b''
@@ -516,6 +517,12 @@ def parse_acl_getuser(response, **options):
     return data
 
 
+def parse_module_result(response):
+    if isinstance(response, ModuleError):
+        raise response
+    return True
+
+
 class Redis(object):
     """
     Implementation of the Redis protocol.
@@ -656,6 +663,10 @@ class Redis(object):
             'XPENDING': parse_xpending,
             'ZADD': parse_zadd,
             'ZSCAN': parse_zscan,
+            'MODULE LOAD': parse_module_result,
+            'MODULE UNLOAD': parse_module_result,
+            'MODULE LIST': lambda response: [pairs_to_dict(module)
+                                             for module in response],
         }
     )
 
@@ -3306,6 +3317,28 @@ def _georadiusgeneric(self, command, *args, **kwargs):
 
         return self.execute_command(command, *pieces, **kwargs)
 
+    # MODULE COMMANDS
+    def module_load(self, path):
+        """
+        Loads the module from ``path``.
+        Raises ``ModuleError`` if a module is not found at ``path``.
+        """
+        return self.execute_command('MODULE LOAD', path)
+
+    def module_unload(self, name):
+        """
+        Unloads the module ``name``.
+        Raises ``ModuleError`` if ``name`` is not in loaded modules.
+        """
+        return self.execute_command('MODULE UNLOAD', name)
+
+    def module_list(self):
+        """
+        Returns a list of dictionaries containing the name and version of
+        all loaded modules.
+        """
+        return self.execute_command('MODULE LIST')
+
 
 StrictRedis = Redis
 
diff --git a/redis/connection.py b/redis/connection.py
index e3c9b66287..b08aee9cd5 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -29,6 +29,7 @@
     RedisError,
     ResponseError,
     TimeoutError,
+    ModuleError,
 )
 from redis.utils import HIREDIS_AVAILABLE
 
@@ -90,6 +91,14 @@
 SERVER_CLOSED_CONNECTION_ERROR = "Connection closed by server."
 
 SENTINEL = object()
+MODULE_LOAD_ERROR = 'Error loading the extension. ' \
+                    'Please check the server logs.'
+NO_SUCH_MODULE_ERROR = 'Error unloading module: no such module with that name'
+MODULE_UNLOAD_NOT_POSSIBLE_ERROR = 'Error unloading module: operation not ' \
+                                   'possible.'
+MODULE_EXPORTS_DATA_TYPES_ERROR = "Error unloading module: the module " \
+                                  "exports one or more module-side data " \
+                                  "types, can't unload"
 
 
 class Encoder(object):
@@ -146,6 +155,10 @@ class BaseParser(object):
             # in uppercase
             'wrong number of arguments for \'AUTH\' command':
                 AuthenticationWrongNumberOfArgsError,
+            MODULE_LOAD_ERROR: ModuleError,
+            MODULE_EXPORTS_DATA_TYPES_ERROR: ModuleError,
+            NO_SUCH_MODULE_ERROR: ModuleError,
+            MODULE_UNLOAD_NOT_POSSIBLE_ERROR: ModuleError,
         },
         'EXECABORT': ExecAbortError,
         'LOADING': BusyLoadingError,
diff --git a/redis/exceptions.py b/redis/exceptions.py
index 760af66f52..ca2ad870b6 100644
--- a/redis/exceptions.py
+++ b/redis/exceptions.py
@@ -57,6 +57,10 @@ class NoPermissionError(ResponseError):
     pass
 
 
+class ModuleError(ResponseError):
+    pass
+
+
 class LockError(RedisError, ValueError):
     "Errors acquiring or releasing a lock"
     # NOTE: For backwards compatability, this class derives from ValueError.
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 65e877ca7a..adaa9fcb55 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2629,6 +2629,11 @@ def test_memory_usage(self, r):
         r.set('foo', 'bar')
         assert isinstance(r.memory_usage('foo'), int)
 
+    @skip_if_server_version_lt('4.0.0')
+    def test_module_list(self, r):
+        assert isinstance(r.module_list(), list)
+        assert not r.module_list()
+
 
 class TestBinarySave(object):
 

From 142a44a075df4f371320d6da2b8341db62fa5d15 Mon Sep 17 00:00:00 2001
From: Roey Prat <roey.prat@redislabs.com>
Date: Mon, 13 Jul 2020 20:20:59 +0300
Subject: [PATCH 0019/1164] fix typo (#1367)

---
 redis/exceptions.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/exceptions.py b/redis/exceptions.py
index ca2ad870b6..91eb3c7257 100644
--- a/redis/exceptions.py
+++ b/redis/exceptions.py
@@ -63,7 +63,7 @@ class ModuleError(ResponseError):
 
 class LockError(RedisError, ValueError):
     "Errors acquiring or releasing a lock"
-    # NOTE: For backwards compatability, this class derives from ValueError.
+    # NOTE: For backwards compatibility, this class derives from ValueError.
     # This was originally chosen to behave like threading.Lock.
     pass
 

From 61ece12e785ee70871dbc04d41ca5e760d8c401f Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Mon, 13 Jul 2020 18:59:25 +0000
Subject: [PATCH 0020/1164] Add guide to contributing

---
 CONTRIBUTING.rst | 80 ++++++++++++++++++++++++++++++++++++++++++++++++
 README.rst       |  6 ++++
 2 files changed, 86 insertions(+)
 create mode 100644 CONTRIBUTING.rst

diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
new file mode 100644
index 0000000000..6823540617
--- /dev/null
+++ b/CONTRIBUTING.rst
@@ -0,0 +1,80 @@
+Contributing
+============
+
+Introduction
+------------
+
+First off, thank you for considering contributing to redis-py. We value community contributions!
+
+What Kinds of Contributions We Need
+-----------------------------------
+
+You may already know what you want to contribute -- a fix for a bug you encountered, or a new feature your team wants to use.
+
+If you don't know what to contribute, keep an open mind! Improving documentation, bug triaging, or writing tutorials are all examples of helpful contributions that mean less work for you.
+
+Contributions We are Not Looking For
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Please, don't use the issue tracker for support questions. Check whether the #redis-py IRC channel on Freenode can help with your issue. If your problem is not strictly #redis-py specific, #redis is generally more active. Stack Overflow is also worth considering.
+
+Your First Contribution
+-----------------------
+Unsure where to begin contributing to Atom? You can start by looking through help-wanted issues: https://github.com/andymccurdy/redis-py/issues?q=is%3Aopen+is%3Aissue+label%3ahelp-wanted
+
+Never contributed to open source before? Here are a couple of friendly tutorials:
+
+- http://makeapullrequest.com/
+- http://www.firsttimersonly.com/
+- https://github.com/andymccurdy/redis-py/issues?q=is%3Aopen+is%3Aissue+label%3ahelp-wanted
+
+Getting Started
+---------------
+
+Here's how to get started with your code contribution:
+
+1. Create your own fork of redis-py
+2. When you've checked out the fork locally, build the docker containers: `make build`
+2. Do the changes in your fork
+3. Make sure the tests pass by running: `make test`
+4. If you like the change and think the project could use it, send a pull request
+
+How to Report a Bug
+-------------------
+
+Security Vulnerabilities
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+**NOTE**: If you find a security vulnerability, do NOT open an issue. Email Andy McCurdy (sedrik@gmail.com) instead.
+
+In order to determine whether you are dealing with a security issue, ask yourself these two questions:
+
+* Can I access something that's not mine, or something I shouldn't have access to?
+* Can I disable something for other people?
+
+If the answer to either of those two questions are "yes", then you're probably dealing with a security issue. Note that even if you answer "no" to both questions, you may still be dealing with a security issue, so if you're unsure, just email Andy at sedrik@gmail.com.
+
+Everything Else
+^^^^^^^^^^^^^^^
+
+When filing an issue, make sure to answer these five questions:
+
+1. What version of redis-py are you using?
+2. What version of redis are you using?
+3. What did you do?
+4. What did you expect to see?
+5. What did you see instead?
+
+General questions should go to the redis-py mailing list instead of the issue tracker.
+
+How to Suggest a Feature or Enhancement
+---------------------------------------
+
+If you'd like to contribute a new feature, make sure you check our issue list to see if someone has already proposed it. Work may already be under way on the feature you want -- or we may have rejected a feature like it already.
+
+If you don't see anything, open a new issue that describes the feature you would like and how it should work.
+
+Code Review Process
+-------------------
+
+The core team looks at Pull Requests on a regular basis. We will give feedback as as soon as possible. After feedback, we expect a response within two weeks. After that time, we may close your PR if it isn't showing any activity.
diff --git a/README.rst b/README.rst
index 3f8de91466..4f2cec840b 100644
--- a/README.rst
+++ b/README.rst
@@ -47,6 +47,12 @@ or from source:
 
     $ python setup.py install
 
+Contributing
+------------
+
+Want to contribute a feature, bug report, or report an issue? Check out our `guide to
+contributing <https://github.com/andymccurdy/redis-py/blob/master/CONTRIBUTING.rst>`_.
+
 
 Getting Started
 ---------------

From c5c9e81a40d8899b3f7c1ca72cdd7502dfc3fa8c Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Mon, 13 Jul 2020 19:02:54 +0000
Subject: [PATCH 0021/1164] Remove references to maling lists and IRC channels

---
 CONTRIBUTING.rst | 14 +++-----------
 1 file changed, 3 insertions(+), 11 deletions(-)

diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index 6823540617..7e623c4599 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -6,27 +6,21 @@ Introduction
 
 First off, thank you for considering contributing to redis-py. We value community contributions!
 
-What Kinds of Contributions We Need
------------------------------------
+Contributions We Need
+----------------------
 
 You may already know what you want to contribute -- a fix for a bug you encountered, or a new feature your team wants to use.
 
 If you don't know what to contribute, keep an open mind! Improving documentation, bug triaging, or writing tutorials are all examples of helpful contributions that mean less work for you.
 
-Contributions We are Not Looking For
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Please, don't use the issue tracker for support questions. Check whether the #redis-py IRC channel on Freenode can help with your issue. If your problem is not strictly #redis-py specific, #redis is generally more active. Stack Overflow is also worth considering.
-
 Your First Contribution
 -----------------------
-Unsure where to begin contributing to Atom? You can start by looking through help-wanted issues: https://github.com/andymccurdy/redis-py/issues?q=is%3Aopen+is%3Aissue+label%3ahelp-wanted
+Unsure where to begin contributing? You can start by looking through help-wanted issues: https://github.com/andymccurdy/redis-py/issues?q=is%3Aopen+is%3Aissue+label%3ahelp-wanted
 
 Never contributed to open source before? Here are a couple of friendly tutorials:
 
 - http://makeapullrequest.com/
 - http://www.firsttimersonly.com/
-- https://github.com/andymccurdy/redis-py/issues?q=is%3Aopen+is%3Aissue+label%3ahelp-wanted
 
 Getting Started
 ---------------
@@ -65,8 +59,6 @@ When filing an issue, make sure to answer these five questions:
 4. What did you expect to see?
 5. What did you see instead?
 
-General questions should go to the redis-py mailing list instead of the issue tracker.
-
 How to Suggest a Feature or Enhancement
 ---------------------------------------
 

From af3771b1479caec3e7396b952cb78a60a6e98253 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Mon, 13 Jul 2020 19:06:14 +0000
Subject: [PATCH 0022/1164] Attempt to use docker for travis testing

---
 .travis.yml | 46 +++++++---------------------------------------
 1 file changed, 7 insertions(+), 39 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index 05dd94c25f..615a0c9ed8 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,42 +1,10 @@
 language: python
-cache: pip
-matrix:
-  include:
-    - env: TOXENV=flake8
-    - python: 2.7
-      env: TOXENV=py27-plain
-    - python: 2.7
-      env: TOXENV=py27-hiredis
-    - python: 3.5
-      env: TOXENV=py35-plain
-    - python: 3.5
-      env: TOXENV=py35-hiredis
-    - python: 3.6
-      env: TOXENV=py36-plain
-    - python: 3.6
-      env: TOXENV=py36-hiredis
-    - python: 3.7
-      env: TOXENV=py37-plain
-    - python: 3.7
-      env: TOXENV=py37-hiredis
-    - python: 3.8
-      env: TOXENV=py38-plain
-    - python: 3.8
-      env: TOXENV=py38-hiredis
-    - python: pypy
-      env: TOXENV=pypy-plain
-    - python: pypy
-      env: TOXENV=pypy-hiredis
-    - python: pypy3
-      env: TOXENV=pypy3-plain
-    - python: pypy3
-      env: TOXENV=pypy3-hiredis
+
+services:
+  - docker
+
 before_install:
-  - wget https://github.com/antirez/redis/archive/6.0.5.tar.gz && mkdir redis_install && tar -xvzf 6.0.5.tar.gz -C redis_install && cd redis_install/redis-6.0.5 && make && src/redis-server --daemonize yes && cd ../..
-  - redis-cli info
-install:
-  - pip install codecov tox
+  - make build
+
 script:
-  - tox
-after_success:
-  - "if [[ $TOXENV != 'flake8' ]]; then codecov; fi"
+  - make test

From b4b1d9702964aee9ba38d16a067cf5dbc21d5d44 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Mon, 13 Jul 2020 19:09:10 +0000
Subject: [PATCH 0023/1164] WIP on travis config

---
 .travis.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.travis.yml b/.travis.yml
index 615a0c9ed8..8b51c30777 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,5 +1,8 @@
 language: python
 
+env:
+  - DOCKER_COMPOSE_VERSION=1.26.2
+
 services:
   - docker
 

From 867b28d341b42124e4af7e787312354544391183 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Mon, 13 Jul 2020 19:14:45 +0000
Subject: [PATCH 0024/1164] Install the version of compose that we need

---
 .travis.yml      |  6 ++++++
 CONTRIBUTING.rst | 12 ++++++++++++
 2 files changed, 18 insertions(+)

diff --git a/.travis.yml b/.travis.yml
index 8b51c30777..62e01729c7 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -3,6 +3,12 @@ language: python
 env:
   - DOCKER_COMPOSE_VERSION=1.26.2
 
+before_install:
+  - sudo rm /usr/local/bin/docker-compose
+  - curl -L https://github.com/docker/compose/releases/download/${DOCKER_COMPOSE_VERSION}/docker-compose-`uname -s`-`uname -m` > docker-compose
+  - chmod +x docker-compose
+  - sudo mv docker-compose /usr/local/bin
+
 services:
   - docker
 
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index 7e623c4599..177dfaa3fc 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -33,6 +33,18 @@ Here's how to get started with your code contribution:
 3. Make sure the tests pass by running: `make test`
 4. If you like the change and think the project could use it, send a pull request
 
+Troubleshooting
+^^^^^^^^^^^^^^^
+
+If you get any errors when running `make build` or `make test`, make sure that you
+are using supported versions of Docker and docker-compose.
+
+The included Dockerfiles and docker-compose.yml file work with the following
+versions of Docker and docker-compose:
+
+* Docker 19.03.12
+* docker-compose 1.26.2
+
 How to Report a Bug
 -------------------
 

From e01cc2f549a01e865f6898632e1532997a9e6401 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Mon, 13 Jul 2020 19:20:14 +0000
Subject: [PATCH 0025/1164] WIP

---
 .travis.yml | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index 62e01729c7..bb943738e4 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -12,8 +12,6 @@ before_install:
 services:
   - docker
 
-before_install:
-  - make build
-
 script:
+  - make build
   - make test

From e4954ba0b7eb7b2250c7d32a1707851ad19ae12f Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Mon, 13 Jul 2020 19:27:31 +0000
Subject: [PATCH 0026/1164] No need for Python in the test build anymore

---
 .travis.yml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index bb943738e4..0e3b1f9496 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,5 +1,3 @@
-language: python
-
 env:
   - DOCKER_COMPOSE_VERSION=1.26.2
 

From 27c4af489db75bf264407e1135ac0e42c9e8ee96 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Mon, 13 Jul 2020 19:32:37 +0000
Subject: [PATCH 0027/1164] Fix numbering

---
 CONTRIBUTING.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index 177dfaa3fc..90a00eb228 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -29,9 +29,9 @@ Here's how to get started with your code contribution:
 
 1. Create your own fork of redis-py
 2. When you've checked out the fork locally, build the docker containers: `make build`
-2. Do the changes in your fork
-3. Make sure the tests pass by running: `make test`
-4. If you like the change and think the project could use it, send a pull request
+3. Do the changes in your fork
+4. Make sure the tests pass by running: `make test`
+5. If you like the change and think the project could use it, send a pull request
 
 Troubleshooting
 ^^^^^^^^^^^^^^^

From 266e2066e1e6ae46c8830dc049c89d50bf463231 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Mon, 13 Jul 2020 19:35:51 +0000
Subject: [PATCH 0028/1164] Format CLI commands correctly for RST

---
 CONTRIBUTING.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index 90a00eb228..c6990f224c 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -28,15 +28,15 @@ Getting Started
 Here's how to get started with your code contribution:
 
 1. Create your own fork of redis-py
-2. When you've checked out the fork locally, build the docker containers: `make build`
+2. When you've checked out the fork locally, build the docker containers: ``make build``
 3. Do the changes in your fork
-4. Make sure the tests pass by running: `make test`
+4. Make sure the tests pass by running: ``make test``
 5. If you like the change and think the project could use it, send a pull request
 
 Troubleshooting
 ^^^^^^^^^^^^^^^
 
-If you get any errors when running `make build` or `make test`, make sure that you
+If you get any errors when running ``make build`` or ``make test``, make sure that you
 are using supported versions of Docker and docker-compose.
 
 The included Dockerfiles and docker-compose.yml file work with the following

From 639a8dc11858f87ee571791bb751315de690541b Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Mon, 13 Jul 2020 22:13:06 +0000
Subject: [PATCH 0029/1164] Update PHONY targets

---
 Makefile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Makefile b/Makefile
index f86cbad5e3..54d2db1424 100644
--- a/Makefile
+++ b/Makefile
@@ -1,4 +1,4 @@
-.PHONY: base
+.PHONY: build dev test
 
 build:
 	docker build -t redis-py-base docker/base

From a10751d94bbf2dd9bfc2f8946f5a3934df41b346 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Mon, 13 Jul 2020 23:14:26 +0000
Subject: [PATCH 0030/1164] Improvements based on review feedback:

1. All make targets are now PHONY.

2. Cleaned up the 'dev' target so that it passes --build
   to docker-compose.

3. Added pypy-specific tox environments. And added a new
   Dockerfile to build an image for the "test" container
   that contains pypy and pypy3.

4. Added a `make clean` target. It removes containers but
   requires the user to confirm.

5. Specify the depends_on order for slave -> master and
   made all sentinels depend on the slave coming up. The
   container running doesn't mean that redis is actually
   ready though, so I wrapped the "test" target in the
   Makefile with a wait script that waits until
   master is responding on port 6379.
---
 Makefile               |  14 ++--
 docker-compose.yml     |  12 ++-
 docker/test/Dockerfile |   3 +
 tox.ini                |  12 +++
 util/wait-for-it.sh    | 183 +++++++++++++++++++++++++++++++++++++++++
 5 files changed, 217 insertions(+), 7 deletions(-)
 create mode 100644 docker/test/Dockerfile
 create mode 100755 util/wait-for-it.sh

diff --git a/Makefile b/Makefile
index 54d2db1424..d64d4403d0 100644
--- a/Makefile
+++ b/Makefile
@@ -1,12 +1,14 @@
 .PHONY: build dev test
 
-build:
+base:
 	docker build -t redis-py-base docker/base
-	docker-compose build
 
-dev:
-	docker-compose up -d
+dev: base
+	docker-compose up -d --build
 
 test: dev
-	find . -name "*.pyc" -exec rm -f {} \;
-	docker-compose run test tox -- --redis-url=redis://master:6379/9
+	docker-compose run test util/wait-for-it.sh master:6379 -- tox -- --redis-url=redis://master:6379/9
+
+clean:
+	docker-compose stop
+	docker-compose rm
diff --git a/docker-compose.yml b/docker-compose.yml
index c7a7c0a2b0..12d92b6e4a 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -8,26 +8,36 @@ services:
 
   slave:
     build: docker/slave
+    depends_on:
+      - "master"
     ports:
       - "6380:6380"
 
   sentinel_1:
     build: docker/sentinel_1
+    depends_on:
+      - "slave"
     ports:
       - "26379:26379"
 
   sentinel_2:
     build: docker/sentinel_2
+    depends_on:
+      - "slave"
     ports:
       - "26380:26380"
 
   sentinel_3:
     build: docker/sentinel_3
+    depends_on:
+      - "slave"
     ports:
       - "26381:26381"
 
   test:
-    image: fkrull/multi-python:latest
+    build: docker/test
     working_dir: /redis-py
+    depends_on:
+      - "sentinel_3"
     volumes:
       - .:/redis-py
diff --git a/docker/test/Dockerfile b/docker/test/Dockerfile
new file mode 100644
index 0000000000..768b081847
--- /dev/null
+++ b/docker/test/Dockerfile
@@ -0,0 +1,3 @@
+FROM fkrull/multi-python:latest
+
+RUN apt install -y pypy pypy3
diff --git a/tox.ini b/tox.ini
index 9518954940..da92df6ebc 100644
--- a/tox.ini
+++ b/tox.ini
@@ -17,3 +17,15 @@ deps = flake8
 commands = flake8
 skipsdist = true
 skip_install = true
+
+[testenv:pypy-plain]
+basepython = pypy
+
+[testenv:pypy-hiredis]
+basepython = pypy
+
+[testenv:pypy3-plain]
+basepython = pypy3
+
+[testenv:pypy3-hiredis]
+basepython = pypy3
diff --git a/util/wait-for-it.sh b/util/wait-for-it.sh
new file mode 100755
index 0000000000..b931da1fb9
--- /dev/null
+++ b/util/wait-for-it.sh
@@ -0,0 +1,183 @@
+#!/usr/bin/env bash
+# Use this script to test if a given TCP host/port are available
+
+WAITFORIT_cmdname=${0##*/}
+
+echoerr() { if [[ $WAITFORIT_QUIET -ne 1 ]]; then echo "$@" 1>&2; fi }
+
+usage()
+{
+    cat << USAGE >&2
+Usage:
+    $WAITFORIT_cmdname host:port [-s] [-t timeout] [-- command args]
+    -h HOST | --host=HOST       Host or IP under test
+    -p PORT | --port=PORT       TCP port under test
+                                Alternatively, you specify the host and port as host:port
+    -s | --strict               Only execute subcommand if the test succeeds
+    -q | --quiet                Don't output any status messages
+    -t TIMEOUT | --timeout=TIMEOUT
+                                Timeout in seconds, zero for no timeout
+    -- COMMAND ARGS             Execute command with args after the test finishes
+USAGE
+    exit 1
+}
+
+wait_for()
+{
+    if [[ $WAITFORIT_TIMEOUT -gt 0 ]]; then
+        echoerr "$WAITFORIT_cmdname: waiting $WAITFORIT_TIMEOUT seconds for $WAITFORIT_HOST:$WAITFORIT_PORT"
+    else
+        echoerr "$WAITFORIT_cmdname: waiting for $WAITFORIT_HOST:$WAITFORIT_PORT without a timeout"
+    fi
+    WAITFORIT_start_ts=$(date +%s)
+    while :
+    do
+        if [[ $WAITFORIT_ISBUSY -eq 1 ]]; then
+            nc -z $WAITFORIT_HOST $WAITFORIT_PORT
+            WAITFORIT_result=$?
+        else
+            (echo > /dev/tcp/$WAITFORIT_HOST/$WAITFORIT_PORT) >/dev/null 2>&1
+            WAITFORIT_result=$?
+        fi
+        if [[ $WAITFORIT_result -eq 0 ]]; then
+            WAITFORIT_end_ts=$(date +%s)
+            echoerr "$WAITFORIT_cmdname: $WAITFORIT_HOST:$WAITFORIT_PORT is available after $((WAITFORIT_end_ts - WAITFORIT_start_ts)) seconds"
+            break
+        fi
+        sleep 1
+    done
+    return $WAITFORIT_result
+}
+
+wait_for_wrapper()
+{
+    # In order to support SIGINT during timeout: http://unix.stackexchange.com/a/57692
+    if [[ $WAITFORIT_QUIET -eq 1 ]]; then
+        timeout $WAITFORIT_BUSYTIMEFLAG $WAITFORIT_TIMEOUT $0 --quiet --child --host=$WAITFORIT_HOST --port=$WAITFORIT_PORT --timeout=$WAITFORIT_TIMEOUT &
+    else
+        timeout $WAITFORIT_BUSYTIMEFLAG $WAITFORIT_TIMEOUT $0 --child --host=$WAITFORIT_HOST --port=$WAITFORIT_PORT --timeout=$WAITFORIT_TIMEOUT &
+    fi
+    WAITFORIT_PID=$!
+    trap "kill -INT -$WAITFORIT_PID" INT
+    wait $WAITFORIT_PID
+    WAITFORIT_RESULT=$?
+    if [[ $WAITFORIT_RESULT -ne 0 ]]; then
+        echoerr "$WAITFORIT_cmdname: timeout occurred after waiting $WAITFORIT_TIMEOUT seconds for $WAITFORIT_HOST:$WAITFORIT_PORT"
+    fi
+    return $WAITFORIT_RESULT
+}
+
+# process arguments
+while [[ $# -gt 0 ]]
+do
+    case "$1" in
+        *:* )
+        WAITFORIT_hostport=(${1//:/ })
+        WAITFORIT_HOST=${WAITFORIT_hostport[0]}
+        WAITFORIT_PORT=${WAITFORIT_hostport[1]}
+        shift 1
+        ;;
+        --child)
+        WAITFORIT_CHILD=1
+        shift 1
+        ;;
+        -q | --quiet)
+        WAITFORIT_QUIET=1
+        shift 1
+        ;;
+        -s | --strict)
+        WAITFORIT_STRICT=1
+        shift 1
+        ;;
+        -h)
+        WAITFORIT_HOST="$2"
+        if [[ $WAITFORIT_HOST == "" ]]; then break; fi
+        shift 2
+        ;;
+        --host=*)
+        WAITFORIT_HOST="${1#*=}"
+        shift 1
+        ;;
+        -p)
+        WAITFORIT_PORT="$2"
+        if [[ $WAITFORIT_PORT == "" ]]; then break; fi
+        shift 2
+        ;;
+        --port=*)
+        WAITFORIT_PORT="${1#*=}"
+        shift 1
+        ;;
+        -t)
+        WAITFORIT_TIMEOUT="$2"
+        if [[ $WAITFORIT_TIMEOUT == "" ]]; then break; fi
+        shift 2
+        ;;
+        --timeout=*)
+        WAITFORIT_TIMEOUT="${1#*=}"
+        shift 1
+        ;;
+        --)
+        shift
+        WAITFORIT_CLI=("$@")
+        break
+        ;;
+        --help)
+        usage
+        ;;
+        *)
+        echoerr "Unknown argument: $1"
+        usage
+        ;;
+    esac
+done
+
+if [[ "$WAITFORIT_HOST" == "" || "$WAITFORIT_PORT" == "" ]]; then
+    echoerr "Error: you need to provide a host and port to test."
+    usage
+fi
+
+WAITFORIT_TIMEOUT=${WAITFORIT_TIMEOUT:-15}
+WAITFORIT_STRICT=${WAITFORIT_STRICT:-0}
+WAITFORIT_CHILD=${WAITFORIT_CHILD:-0}
+WAITFORIT_QUIET=${WAITFORIT_QUIET:-0}
+
+# Check to see if timeout is from busybox?
+WAITFORIT_TIMEOUT_PATH=$(type -p timeout)
+WAITFORIT_TIMEOUT_PATH=$(realpath $WAITFORIT_TIMEOUT_PATH 2>/dev/null || readlink -f $WAITFORIT_TIMEOUT_PATH)
+
+WAITFORIT_BUSYTIMEFLAG=""
+if [[ $WAITFORIT_TIMEOUT_PATH =~ "busybox" ]]; then
+    WAITFORIT_ISBUSY=1
+    # Check if busybox timeout uses -t flag
+    # (recent Alpine versions don't support -t anymore)
+    if timeout &>/dev/stdout | grep -q -e '-t '; then
+        WAITFORIT_BUSYTIMEFLAG="-t"
+    fi
+else
+    WAITFORIT_ISBUSY=0
+fi
+
+if [[ $WAITFORIT_CHILD -gt 0 ]]; then
+    wait_for
+    WAITFORIT_RESULT=$?
+    exit $WAITFORIT_RESULT
+else
+    if [[ $WAITFORIT_TIMEOUT -gt 0 ]]; then
+        wait_for_wrapper
+        WAITFORIT_RESULT=$?
+    else
+        wait_for
+        WAITFORIT_RESULT=$?
+    fi
+fi
+
+if [[ $WAITFORIT_CLI != "" ]]; then
+    if [[ $WAITFORIT_RESULT -ne 0 && $WAITFORIT_STRICT -eq 1 ]]; then
+        echoerr "$WAITFORIT_cmdname: strict mode, refusing to execute subprocess"
+        exit $WAITFORIT_RESULT
+    fi
+    exec "${WAITFORIT_CLI[@]}"
+else
+    exit $WAITFORIT_RESULT
+fi
+

From 73b694dc02782844cf709e34933dbd1126b2a536 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Tue, 14 Jul 2020 02:39:44 +0000
Subject: [PATCH 0031/1164] Second try to add pypy and pypy3 to test runs

---
 docker/test/Dockerfile | 2 +-
 tox.ini                | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docker/test/Dockerfile b/docker/test/Dockerfile
index 768b081847..e57baf9c46 100644
--- a/docker/test/Dockerfile
+++ b/docker/test/Dockerfile
@@ -1,3 +1,3 @@
 FROM fkrull/multi-python:latest
 
-RUN apt install -y pypy pypy3
+RUN apt install -y pypy pypy-dev pypy3-dev
diff --git a/tox.ini b/tox.ini
index da92df6ebc..f9dbe276f7 100644
--- a/tox.ini
+++ b/tox.ini
@@ -1,6 +1,6 @@
 [tox]
 minversion = 2.4
-envlist = {py27,py35,py36,py37,py38,py,py3}-{plain,hiredis}, flake8
+envlist = {py27,py35,py36,py37,py38,py,py3,pypy,pypy3}-{plain,hiredis}, flake8
 
 [testenv]
 deps =

From 59bb043253638c927c3f324523fc3fd529803aaf Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Tue, 14 Jul 2020 04:30:30 +0000
Subject: [PATCH 0032/1164] Clean up cache files; delete root-owned .tox
 files...

---
 .dockerignore | 3 +++
 Makefile      | 2 ++
 2 files changed, 5 insertions(+)
 create mode 100644 .dockerignore

diff --git a/.dockerignore b/.dockerignore
new file mode 100644
index 0000000000..08ea4a6294
--- /dev/null
+++ b/.dockerignore
@@ -0,0 +1,3 @@
+**/__pycache__
+**/*.pyc
+.tox
diff --git a/Makefile b/Makefile
index d64d4403d0..371e7089f0 100644
--- a/Makefile
+++ b/Makefile
@@ -7,8 +7,10 @@ dev: base
 	docker-compose up -d --build
 
 test: dev
+	docker-compose run test find . -type f -name '*.py[co]' -delete -o -type d -name __pycache__ -delete
 	docker-compose run test util/wait-for-it.sh master:6379 -- tox -- --redis-url=redis://master:6379/9
 
 clean:
 	docker-compose stop
 	docker-compose rm
+	rm -rf .tox

From 7dfcd3bfffc20dcee30cd047bb527112f28b1e5d Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Tue, 14 Jul 2020 04:30:53 +0000
Subject: [PATCH 0033/1164] Attempt to fix a timing bug

---
 tests/test_connection_pool.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 40ac3407db..e6e8e58a63 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -143,8 +143,8 @@ def target():
             time.sleep(0.1)
             pool.release(c1)
 
-        Thread(target=target).start()
         start = time.time()
+        Thread(target=target).start()
         pool.get_connection('_')
         assert time.time() - start >= 0.1
 

From 8fb3f97c4ec502e337140d9c6e89c9661da6b54f Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Tue, 14 Jul 2020 04:33:15 +0000
Subject: [PATCH 0034/1164] Remove a rm command that would not work anyway

---
 Makefile | 1 -
 1 file changed, 1 deletion(-)

diff --git a/Makefile b/Makefile
index 371e7089f0..d4bfd9d395 100644
--- a/Makefile
+++ b/Makefile
@@ -13,4 +13,3 @@ test: dev
 clean:
 	docker-compose stop
 	docker-compose rm
-	rm -rf .tox

From b2ef59b6a8f292871842c0c168f22641e58c68aa Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Tue, 14 Jul 2020 04:37:16 +0000
Subject: [PATCH 0035/1164] Remove .tox from container side

---
 Makefile | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/Makefile b/Makefile
index d4bfd9d395..c305f47768 100644
--- a/Makefile
+++ b/Makefile
@@ -8,7 +8,8 @@ dev: base
 
 test: dev
 	docker-compose run test find . -type f -name '*.py[co]' -delete -o -type d -name __pycache__ -delete
-	docker-compose run test util/wait-for-it.sh master:6379 -- tox -- --redis-url=redis://master:6379/9
+	docker-compose run test util/wait-for-it.sh master:6379 -- tox -e py3-plain -- --redis-url=redis://master:6379/9
+	docker-compose run test rm -rf .tox
 
 clean:
 	docker-compose stop

From df50cf617bc256d63a942eacb17ebe865041334c Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Tue, 14 Jul 2020 04:40:35 +0000
Subject: [PATCH 0036/1164] Test all testenvs

---
 Makefile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Makefile b/Makefile
index c305f47768..4d8a3d50cc 100644
--- a/Makefile
+++ b/Makefile
@@ -8,7 +8,7 @@ dev: base
 
 test: dev
 	docker-compose run test find . -type f -name '*.py[co]' -delete -o -type d -name __pycache__ -delete
-	docker-compose run test util/wait-for-it.sh master:6379 -- tox -e py3-plain -- --redis-url=redis://master:6379/9
+	docker-compose run test util/wait-for-it.sh master:6379 -- tox -- --redis-url=redis://master:6379/9
 	docker-compose run test rm -rf .tox
 
 clean:

From aef6d4b362dfacf2db3c23f06b2e1c09719e8836 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Tue, 14 Jul 2020 23:57:11 +0000
Subject: [PATCH 0037/1164] Move test Dockerfile into root, use COPY

---
 docker/test/Dockerfile => Dockerfile | 1 +
 Makefile                             | 4 +---
 docker-compose.yml                   | 4 +---
 tox.ini                              | 3 +++
 4 files changed, 6 insertions(+), 6 deletions(-)
 rename docker/test/Dockerfile => Dockerfile (81%)

diff --git a/docker/test/Dockerfile b/Dockerfile
similarity index 81%
rename from docker/test/Dockerfile
rename to Dockerfile
index e57baf9c46..cd530ef2cd 100644
--- a/docker/test/Dockerfile
+++ b/Dockerfile
@@ -1,3 +1,4 @@
 FROM fkrull/multi-python:latest
 
 RUN apt install -y pypy pypy-dev pypy3-dev
+COPY . /redis-py
diff --git a/Makefile b/Makefile
index 4d8a3d50cc..a3ebfa92fb 100644
--- a/Makefile
+++ b/Makefile
@@ -7,9 +7,7 @@ dev: base
 	docker-compose up -d --build
 
 test: dev
-	docker-compose run test find . -type f -name '*.py[co]' -delete -o -type d -name __pycache__ -delete
-	docker-compose run test util/wait-for-it.sh master:6379 -- tox -- --redis-url=redis://master:6379/9
-	docker-compose run test rm -rf .tox
+	docker-compose run --rm test util/wait-for-it.sh master:6379 -- tox -- --redis-url=redis://master:6379/9
 
 clean:
 	docker-compose stop
diff --git a/docker-compose.yml b/docker-compose.yml
index 12d92b6e4a..631e2f8fb3 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -35,9 +35,7 @@ services:
       - "26381:26381"
 
   test:
-    build: docker/test
+    build: .
     working_dir: /redis-py
     depends_on:
       - "sentinel_3"
-    volumes:
-      - .:/redis-py
diff --git a/tox.ini b/tox.ini
index f9dbe276f7..b7d0a6a4c0 100644
--- a/tox.ini
+++ b/tox.ini
@@ -1,3 +1,6 @@
+[pytest]
+addopts = -s
+
 [tox]
 minversion = 2.4
 envlist = {py27,py35,py36,py37,py38,py,py3,pypy,pypy3}-{plain,hiredis}, flake8

From 55326cad46444899b58ceaddf98958f33e4fd7b3 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Wed, 15 Jul 2020 19:46:33 +0000
Subject: [PATCH 0038/1164] Include wait-for-it.sh copyright & license

---
 util/wait-for-it.sh | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/util/wait-for-it.sh b/util/wait-for-it.sh
index b931da1fb9..ed711aec1b 100755
--- a/util/wait-for-it.sh
+++ b/util/wait-for-it.sh
@@ -1,5 +1,26 @@
 #!/usr/bin/env bash
 # Use this script to test if a given TCP host/port are available
+#
+# The MIT License (MIT)
+# Copyright (c) 2016 Giles Hall
+
+# Permission is hereby granted, free of charge, to any person obtaining a copy of
+# this software and associated documentation files (the "Software"), to deal in
+# the Software without restriction, including without limitation the rights to
+# use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+# of the Software, and to permit persons to whom the Software is furnished to do
+# so, subject to the following conditions:
+
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
 
 WAITFORIT_cmdname=${0##*/}
 

From 273c8fee6c486b10e6e9823b0dd8645a363530d1 Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Wed, 15 Jul 2020 13:07:06 -0700
Subject: [PATCH 0039/1164] remove unnecessary tox environments

---
 tox.ini | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tox.ini b/tox.ini
index b7d0a6a4c0..30682fb9aa 100644
--- a/tox.ini
+++ b/tox.ini
@@ -3,7 +3,7 @@ addopts = -s
 
 [tox]
 minversion = 2.4
-envlist = {py27,py35,py36,py37,py38,py,py3,pypy,pypy3}-{plain,hiredis}, flake8
+envlist = {py27,py35,py36,py37,py38,pypy,pypy3}-{plain,hiredis}, flake8
 
 [testenv]
 deps =

From a5508b141e15b752f97263325b5114fb0b48476a Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Wed, 15 Jul 2020 13:08:43 -0700
Subject: [PATCH 0040/1164] force removal of docker images rather than ask the
 user if it's ok

---
 Makefile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Makefile b/Makefile
index a3ebfa92fb..9cce0ffaea 100644
--- a/Makefile
+++ b/Makefile
@@ -11,4 +11,4 @@ test: dev
 
 clean:
 	docker-compose stop
-	docker-compose rm
+	docker-compose rm -f

From 0fe33ba87d3d2a2dc84750489fccc193ac79d298 Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Wed, 15 Jul 2020 13:16:40 -0700
Subject: [PATCH 0041/1164] update PHONY targets

---
 Makefile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Makefile b/Makefile
index 9cce0ffaea..d21d4f4526 100644
--- a/Makefile
+++ b/Makefile
@@ -1,4 +1,4 @@
-.PHONY: build dev test
+.PHONY: base clean dev test
 
 base:
 	docker build -t redis-py-base docker/base

From 694f4054fa7a04a7dc5125a22ce237b8d3ef50fc Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Wed, 15 Jul 2020 20:19:10 +0000
Subject: [PATCH 0042/1164] Clean up the wait-for-it.sh license

---
 util/wait-for-it.sh | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/util/wait-for-it.sh b/util/wait-for-it.sh
index ed711aec1b..c7a08d4381 100755
--- a/util/wait-for-it.sh
+++ b/util/wait-for-it.sh
@@ -1,19 +1,19 @@
 #!/usr/bin/env bash
 # Use this script to test if a given TCP host/port are available
 #
-# The MIT License (MIT)
 # Copyright (c) 2016 Giles Hall
-
+# The MIT License (MIT)
+#
 # Permission is hereby granted, free of charge, to any person obtaining a copy of
 # this software and associated documentation files (the "Software"), to deal in
 # the Software without restriction, including without limitation the rights to
 # use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
 # of the Software, and to permit persons to whom the Software is furnished to do
 # so, subject to the following conditions:
-
+#
 # The above copyright notice and this permission notice shall be included in all
 # copies or substantial portions of the Software.
-
+#
 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

From 462fd34a7844a49556f8db5c0af23d81a353c9ed Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Wed, 15 Jul 2020 14:10:30 -0700
Subject: [PATCH 0043/1164] master/slave configs for docker

---
 docker/master/Dockerfile |  4 ++--
 docker/master/redis.conf |  8 +-------
 docker/slave/Dockerfile  |  4 ++--
 docker/slave/redis.conf  | 11 ++---------
 4 files changed, 7 insertions(+), 20 deletions(-)

diff --git a/docker/master/Dockerfile b/docker/master/Dockerfile
index af81fb30c0..1f4bd7391a 100644
--- a/docker/master/Dockerfile
+++ b/docker/master/Dockerfile
@@ -1,7 +1,7 @@
 FROM redis-py-base:latest
 
-COPY redis.conf /etc/conf/redis/redis.conf
+COPY redis.conf /usr/local/etc/redis/redis.conf
 
 EXPOSE 6379
 
-CMD redis-server
+CMD [ "redis-server", "/usr/local/etc/redis/redis.conf" ]
diff --git a/docker/master/redis.conf b/docker/master/redis.conf
index cd1c984a93..271bfaacf2 100644
--- a/docker/master/redis.conf
+++ b/docker/master/redis.conf
@@ -1,9 +1,3 @@
-pidfile /var/run/redis-master.pid
 bind *
 port 6379
-daemonize yes
-unixsocket /tmp/redis_master.sock
-unixsocketperm 777
-dbfilename master.rdb
-dir /var/lib/redis/backups
-logfile /var/log/redis-master
+save ""
diff --git a/docker/slave/Dockerfile b/docker/slave/Dockerfile
index 74c1fb0903..7b6bdbe1b9 100644
--- a/docker/slave/Dockerfile
+++ b/docker/slave/Dockerfile
@@ -1,7 +1,7 @@
 FROM redis-py-base:latest
 
-COPY redis.conf /etc/conf/redis/redis.conf
+COPY redis.conf /usr/local/etc/redis/redis.conf
 
 EXPOSE 6380
 
-CMD redis-server
+CMD [ "redis-server", "/usr/local/etc/redis/redis.conf" ]
diff --git a/docker/slave/redis.conf b/docker/slave/redis.conf
index b51cb8464c..e2d8aba5ef 100644
--- a/docker/slave/redis.conf
+++ b/docker/slave/redis.conf
@@ -1,11 +1,4 @@
-pidfile /var/run/redis-slave.pid
 bind *
 port 6380
-daemonize yes
-unixsocket /tmp/redis-slave.sock
-unixsocketperm 777
-dbfilename slave.rdb
-dir /var/lib/redis/backups
-logfile /var/log/redis-slave
-
-slaveof 127.0.0.1 6379
+save ""
+slaveof master 6379

From 26b611e9732ae655c47f768fa5b8771cb69572f2 Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Wed, 15 Jul 2020 15:15:03 -0700
Subject: [PATCH 0044/1164] update configs to bind to explicit addresses.
 configure sentinel

---
 docker/master/redis.conf     |  2 +-
 docker/sentinel_1/Dockerfile |  4 ++--
 docker/sentinel_1/redis.conf | 10 +++++-----
 docker/sentinel_2/Dockerfile |  4 ++--
 docker/sentinel_2/redis.conf | 10 +++++-----
 docker/sentinel_3/Dockerfile |  4 ++--
 docker/sentinel_3/redis.conf | 10 +++++-----
 docker/slave/redis.conf      |  2 +-
 8 files changed, 23 insertions(+), 23 deletions(-)

diff --git a/docker/master/redis.conf b/docker/master/redis.conf
index 271bfaacf2..ed007666b6 100644
--- a/docker/master/redis.conf
+++ b/docker/master/redis.conf
@@ -1,3 +1,3 @@
-bind *
+bind master 127.0.0.1
 port 6379
 save ""
diff --git a/docker/sentinel_1/Dockerfile b/docker/sentinel_1/Dockerfile
index e3c3e7b16d..3c3f8c2952 100644
--- a/docker/sentinel_1/Dockerfile
+++ b/docker/sentinel_1/Dockerfile
@@ -1,7 +1,7 @@
 FROM redis-py-base:latest
 
-COPY redis.conf /etc/conf/redis/redis.conf
+COPY redis.conf /usr/local/etc/redis/redis.conf
 
 EXPOSE 26379
 
-CMD redis-server
+CMD [ "redis-sentinel", "/usr/local/etc/redis/redis.conf" ]
diff --git a/docker/sentinel_1/redis.conf b/docker/sentinel_1/redis.conf
index d12979fc0f..fc9aa68c29 100644
--- a/docker/sentinel_1/redis.conf
+++ b/docker/sentinel_1/redis.conf
@@ -1,7 +1,7 @@
-pidfile /var/run/sentinel-1.pid
+bind sentinel_1 127.0.0.1
 port 26379
-daemonize yes
-logfile /var/log/redis-sentinel-1
 
-# short timeout for sentinel tests
-sentinel down-after-milliseconds mymaster 500
+sentinel monitor redis-py-test master 6379 2
+sentinel down-after-milliseconds redis-py-test 5000
+sentinel failover-timeout redis-py-test 60000
+sentinel parallel-syncs redis-py-test 1
diff --git a/docker/sentinel_2/Dockerfile b/docker/sentinel_2/Dockerfile
index cd59777d3c..dc3c3323d9 100644
--- a/docker/sentinel_2/Dockerfile
+++ b/docker/sentinel_2/Dockerfile
@@ -1,7 +1,7 @@
 FROM redis-py-base:latest
 
-COPY redis.conf /etc/conf/redis/redis.conf
+COPY redis.conf /usr/local/etc/redis/redis.conf
 
 EXPOSE 26380
 
-CMD redis-server
+CMD [ "redis-sentinel", "/usr/local/etc/redis/redis.conf" ]
diff --git a/docker/sentinel_2/redis.conf b/docker/sentinel_2/redis.conf
index 9ab89348a4..264443cbd4 100644
--- a/docker/sentinel_2/redis.conf
+++ b/docker/sentinel_2/redis.conf
@@ -1,7 +1,7 @@
-pidfile /var/run/sentinel-2.pid
+bind sentinel_2 127.0.0.1
 port 26380
-daemonize yes
-logfile /var/log/redis-sentinel-2
 
-# short timeout for sentinel tests
-sentinel down-after-milliseconds mymaster 500
+sentinel monitor redis-py-test master 6379 2
+sentinel down-after-milliseconds redis-py-test 5000
+sentinel failover-timeout redis-py-test 60000
+sentinel parallel-syncs redis-py-test 1
diff --git a/docker/sentinel_3/Dockerfile b/docker/sentinel_3/Dockerfile
index 2e81a15500..f0d48c9511 100644
--- a/docker/sentinel_3/Dockerfile
+++ b/docker/sentinel_3/Dockerfile
@@ -1,7 +1,7 @@
 FROM redis-py-base:latest
 
-COPY redis.conf /etc/conf/redis/redis.conf
+COPY redis.conf /usr/local/etc/redis/redis.conf
 
 EXPOSE 26381
 
-CMD redis-server
+CMD [ "redis-sentinel", "/usr/local/etc/redis/redis.conf" ]
diff --git a/docker/sentinel_3/redis.conf b/docker/sentinel_3/redis.conf
index b971b2ff45..b0827f1f45 100644
--- a/docker/sentinel_3/redis.conf
+++ b/docker/sentinel_3/redis.conf
@@ -1,7 +1,7 @@
-pidfile /var/run/sentinel-3.pid
+bind sentinel_3 127.0.0.1
 port 26381
-daemonize yes
-logfile /var/log/redis-sentinel-3
 
-# short timeout for sentinel tests
-sentinel down-after-milliseconds mymaster 500
+sentinel monitor redis-py-test master 6379 2
+sentinel down-after-milliseconds redis-py-test 5000
+sentinel failover-timeout redis-py-test 60000
+sentinel parallel-syncs redis-py-test 1
diff --git a/docker/slave/redis.conf b/docker/slave/redis.conf
index e2d8aba5ef..629ac70c62 100644
--- a/docker/slave/redis.conf
+++ b/docker/slave/redis.conf
@@ -1,4 +1,4 @@
-bind *
+bind slave 127.0.0.1
 port 6380
 save ""
 slaveof master 6379

From 8c7a8160c7d3a7f4325c77aba4a563004f77cf27 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Wed, 15 Jul 2020 22:24:46 +0000
Subject: [PATCH 0045/1164] Check that we're subscribed to the right channels

---
 tests/test_pubsub.py | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index 31b60be373..bf134831c4 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -475,11 +475,8 @@ def test_pubsub_channels(self, r):
         p.subscribe('foo', 'bar', 'baz', 'quux')
         for i in range(4):
             assert wait_for_message(p)['type'] == 'subscribe'
-        channels = sorted(r.pubsub_channels())
-        # assert channels == [b'bar', b'baz', b'foo', b'quux']
-        if channels != [b'bar', b'baz', b'foo', b'quux']:
-            import pdb
-            pdb.set_trace()
+        expected = [b'bar', b'baz', b'foo', b'quux']
+        assert all([channel in r.pubsub_channels() for channel in expected])
 
     @skip_if_server_version_lt('2.8.0')
     def test_pubsub_numsub(self, r):

From 54a8656fd40f45f008eb5fe12b0c31892fb6f654 Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Wed, 15 Jul 2020 15:24:45 -0700
Subject: [PATCH 0046/1164] rename sentinel configs to sentinel.conf for
 clarity

---
 docker/sentinel_1/Dockerfile                    | 4 ++--
 docker/sentinel_1/{redis.conf => sentinel.conf} | 0
 docker/sentinel_2/Dockerfile                    | 4 ++--
 docker/sentinel_2/{redis.conf => sentinel.conf} | 0
 docker/sentinel_3/Dockerfile                    | 4 ++--
 docker/sentinel_3/{redis.conf => sentinel.conf} | 0
 6 files changed, 6 insertions(+), 6 deletions(-)
 rename docker/sentinel_1/{redis.conf => sentinel.conf} (100%)
 rename docker/sentinel_2/{redis.conf => sentinel.conf} (100%)
 rename docker/sentinel_3/{redis.conf => sentinel.conf} (100%)

diff --git a/docker/sentinel_1/Dockerfile b/docker/sentinel_1/Dockerfile
index 3c3f8c2952..66f6a75e5b 100644
--- a/docker/sentinel_1/Dockerfile
+++ b/docker/sentinel_1/Dockerfile
@@ -1,7 +1,7 @@
 FROM redis-py-base:latest
 
-COPY redis.conf /usr/local/etc/redis/redis.conf
+COPY sentinel.conf /usr/local/etc/redis/sentinel.conf
 
 EXPOSE 26379
 
-CMD [ "redis-sentinel", "/usr/local/etc/redis/redis.conf" ]
+CMD [ "redis-sentinel", "/usr/local/etc/redis/sentinel.conf" ]
diff --git a/docker/sentinel_1/redis.conf b/docker/sentinel_1/sentinel.conf
similarity index 100%
rename from docker/sentinel_1/redis.conf
rename to docker/sentinel_1/sentinel.conf
diff --git a/docker/sentinel_2/Dockerfile b/docker/sentinel_2/Dockerfile
index dc3c3323d9..1c0bb92e23 100644
--- a/docker/sentinel_2/Dockerfile
+++ b/docker/sentinel_2/Dockerfile
@@ -1,7 +1,7 @@
 FROM redis-py-base:latest
 
-COPY redis.conf /usr/local/etc/redis/redis.conf
+COPY sentinel.conf /usr/local/etc/redis/sentinel.conf
 
 EXPOSE 26380
 
-CMD [ "redis-sentinel", "/usr/local/etc/redis/redis.conf" ]
+CMD [ "redis-sentinel", "/usr/local/etc/redis/sentinel.conf" ]
diff --git a/docker/sentinel_2/redis.conf b/docker/sentinel_2/sentinel.conf
similarity index 100%
rename from docker/sentinel_2/redis.conf
rename to docker/sentinel_2/sentinel.conf
diff --git a/docker/sentinel_3/Dockerfile b/docker/sentinel_3/Dockerfile
index f0d48c9511..cf1ec21b70 100644
--- a/docker/sentinel_3/Dockerfile
+++ b/docker/sentinel_3/Dockerfile
@@ -1,7 +1,7 @@
 FROM redis-py-base:latest
 
-COPY redis.conf /usr/local/etc/redis/redis.conf
+COPY sentinel.conf /usr/local/etc/redis/sentinel.conf
 
 EXPOSE 26381
 
-CMD [ "redis-sentinel", "/usr/local/etc/redis/redis.conf" ]
+CMD [ "redis-sentinel", "/usr/local/etc/redis/sentinel.conf" ]
diff --git a/docker/sentinel_3/redis.conf b/docker/sentinel_3/sentinel.conf
similarity index 100%
rename from docker/sentinel_3/redis.conf
rename to docker/sentinel_3/sentinel.conf

From 1f5b2a6cd31ad4298bf6be174796b8aa3d3913db Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Wed, 15 Jul 2020 15:37:13 -0700
Subject: [PATCH 0047/1164] no longer need to `make build`. `make test` will do
 everything

---
 .travis.yml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index 0e3b1f9496..4b09cfcced 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -11,5 +11,4 @@ services:
   - docker
 
 script:
-  - make build
   - make test

From c8dc6a6b0908cf01232dd3491168dfe9ce8d7732 Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Wed, 15 Jul 2020 15:37:39 -0700
Subject: [PATCH 0048/1164] rename absurdly long test name

---
 tests/test_connection_pool.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index e6e8e58a63..c49ecda8b6 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -129,7 +129,7 @@ def test_connection_pool_blocks_until_timeout(self, master_host):
         # we should have waited at least 0.1 seconds
         assert time.time() - start >= 0.1
 
-    def test_connection_pool_blocks_until_another_connection_released(self, master_host):  # noqa: E501
+    def test_connection_pool_blocks_until_conn_available(self, master_host):
         """
         When out of connections, block until another connection is released
         to the pool

From 07abda77af8938fb119e02ee2f94524a96f68947 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Wed, 15 Jul 2020 22:47:50 +0000
Subject: [PATCH 0049/1164] Remove Vagrant files

---
 build_tools/.bash_profile            |  1 -
 build_tools/bootstrap.sh             |  4 ---
 build_tools/build_redis.sh           | 29 ----------------
 build_tools/install_redis.sh         | 37 ---------------------
 build_tools/install_sentinel.sh      | 37 ---------------------
 build_tools/redis-configs/001-master |  8 -----
 build_tools/redis-configs/002-slave  | 10 ------
 build_tools/redis_init_script        | 49 ----------------------------
 build_tools/redis_vars.sh            | 48 ---------------------------
 build_tools/sentinel-configs/001-1   |  6 ----
 build_tools/sentinel-configs/002-2   |  6 ----
 build_tools/sentinel-configs/003-3   |  6 ----
 build_tools/sentinel_init_script     | 49 ----------------------------
 vagrant/Vagrantfile                  | 27 ---------------
 14 files changed, 317 deletions(-)
 delete mode 100644 build_tools/.bash_profile
 delete mode 100755 build_tools/bootstrap.sh
 delete mode 100755 build_tools/build_redis.sh
 delete mode 100755 build_tools/install_redis.sh
 delete mode 100755 build_tools/install_sentinel.sh
 delete mode 100644 build_tools/redis-configs/001-master
 delete mode 100644 build_tools/redis-configs/002-slave
 delete mode 100755 build_tools/redis_init_script
 delete mode 100755 build_tools/redis_vars.sh
 delete mode 100644 build_tools/sentinel-configs/001-1
 delete mode 100644 build_tools/sentinel-configs/002-2
 delete mode 100644 build_tools/sentinel-configs/003-3
 delete mode 100755 build_tools/sentinel_init_script
 delete mode 100644 vagrant/Vagrantfile

diff --git a/build_tools/.bash_profile b/build_tools/.bash_profile
deleted file mode 100644
index b023cf70a7..0000000000
--- a/build_tools/.bash_profile
+++ /dev/null
@@ -1 +0,0 @@
-PATH=$PATH:/var/lib/redis/bin
diff --git a/build_tools/bootstrap.sh b/build_tools/bootstrap.sh
deleted file mode 100755
index a5a0d2ce83..0000000000
--- a/build_tools/bootstrap.sh
+++ /dev/null
@@ -1,4 +0,0 @@
-#!/usr/bin/env bash
-
-# need make to build redis
-sudo apt-get install make
diff --git a/build_tools/build_redis.sh b/build_tools/build_redis.sh
deleted file mode 100755
index 379c6cc936..0000000000
--- a/build_tools/build_redis.sh
+++ /dev/null
@@ -1,29 +0,0 @@
-#!/usr/bin/env bash
-
-source /home/vagrant/redis-py/build_tools/redis_vars.sh
-
-pushd /home/vagrant
-
-uninstall_all_sentinel_instances
-uninstall_all_redis_instances
-
-# create a clean directory for redis
-rm -rf $REDIS_DIR
-mkdir -p $REDIS_BIN_DIR
-mkdir -p $REDIS_CONF_DIR
-mkdir -p $REDIS_SAVE_DIR
-
-# download, unpack and build redis
-mkdir -p $REDIS_DOWNLOAD_DIR
-cd $REDIS_DOWNLOAD_DIR
-rm -f $REDIS_PACKAGE
-rm -rf $REDIS_BUILD_DIR
-wget http://download.redis.io/releases/$REDIS_PACKAGE
-tar zxvf $REDIS_PACKAGE
-cd $REDIS_BUILD_DIR
-make
-cp src/redis-server $REDIS_DIR/bin
-cp src/redis-cli $REDIS_DIR/bin
-cp src/redis-sentinel $REDIS_DIR/bin
-
-popd
diff --git a/build_tools/install_redis.sh b/build_tools/install_redis.sh
deleted file mode 100755
index fd53a1ca88..0000000000
--- a/build_tools/install_redis.sh
+++ /dev/null
@@ -1,37 +0,0 @@
-#!/usr/bin/env bash
-
-source /home/vagrant/redis-py/build_tools/redis_vars.sh
-
-for filename in `ls $VAGRANT_REDIS_CONF_DIR`; do
-    # cuts the order prefix off of the filename, e.g. 001-master -> master
-    PROCESS_NAME=redis-`echo $filename | cut -f 2- -d -`
-    echo "======================================"
-    echo "INSTALLING REDIS SERVER: $PROCESS_NAME"
-    echo "======================================"
-
-    # make sure the instance is uninstalled (it should be already)
-    uninstall_instance $PROCESS_NAME
-
-    # base config
-    mkdir -p $REDIS_CONF_DIR
-    cp $REDIS_BUILD_DIR/redis.conf $REDIS_CONF_DIR/$PROCESS_NAME.conf
-    # override config values from file
-    cat $VAGRANT_REDIS_CONF_DIR/$filename >> $REDIS_CONF_DIR/$PROCESS_NAME.conf
-
-    # replace placeholder variables in init.d script
-    cp $VAGRANT_DIR/redis_init_script /etc/init.d/$PROCESS_NAME
-    sed -i "s/{{ PROCESS_NAME }}/$PROCESS_NAME/g" /etc/init.d/$PROCESS_NAME
-    # need to read the config file to find out what port this instance will run on
-    port=`grep port $VAGRANT_REDIS_CONF_DIR/$filename | cut -f 2 -d " "`
-    sed -i "s/{{ PORT }}/$port/g" /etc/init.d/$PROCESS_NAME
-    chmod 755 /etc/init.d/$PROCESS_NAME
-
-    # and tell update-rc.d about it
-    update-rc.d $PROCESS_NAME defaults 98
-
-    # save the $PROCESS_NAME into installed instances file
-    echo $PROCESS_NAME >> $REDIS_INSTALLED_INSTANCES_FILE
-
-    # start redis
-    /etc/init.d/$PROCESS_NAME start
-done
diff --git a/build_tools/install_sentinel.sh b/build_tools/install_sentinel.sh
deleted file mode 100755
index 0597208ccf..0000000000
--- a/build_tools/install_sentinel.sh
+++ /dev/null
@@ -1,37 +0,0 @@
-#!/usr/bin/env bash
-
-source /home/vagrant/redis-py/build_tools/redis_vars.sh
-
-for filename in `ls $VAGRANT_SENTINEL_CONF_DIR`; do
-    # cuts the order prefix off of the filename, e.g. 001-master -> master
-    PROCESS_NAME=sentinel-`echo $filename | cut -f 2- -d -`
-    echo "========================================="
-    echo "INSTALLING SENTINEL SERVER: $PROCESS_NAME"
-    echo "========================================="
-
-    # make sure the instance is uninstalled (it should be already)
-    uninstall_instance $PROCESS_NAME
-
-    # base config
-    mkdir -p $REDIS_CONF_DIR
-    cp $REDIS_BUILD_DIR/sentinel.conf $REDIS_CONF_DIR/$PROCESS_NAME.conf
-    # override config values from file
-    cat $VAGRANT_SENTINEL_CONF_DIR/$filename >> $REDIS_CONF_DIR/$PROCESS_NAME.conf
-
-    # replace placeholder variables in init.d script
-    cp $VAGRANT_DIR/sentinel_init_script /etc/init.d/$PROCESS_NAME
-    sed -i "s/{{ PROCESS_NAME }}/$PROCESS_NAME/g" /etc/init.d/$PROCESS_NAME
-    # need to read the config file to find out what port this instance will run on
-    port=`grep port $VAGRANT_SENTINEL_CONF_DIR/$filename | cut -f 2 -d " "`
-    sed -i "s/{{ PORT }}/$port/g" /etc/init.d/$PROCESS_NAME
-    chmod 755 /etc/init.d/$PROCESS_NAME
-
-    # and tell update-rc.d about it
-    update-rc.d $PROCESS_NAME defaults 99
-
-    # save the $PROCESS_NAME into installed instances file
-    echo $PROCESS_NAME >> $SENTINEL_INSTALLED_INSTANCES_FILE
-
-    # start redis
-    /etc/init.d/$PROCESS_NAME start
-done
diff --git a/build_tools/redis-configs/001-master b/build_tools/redis-configs/001-master
deleted file mode 100644
index 8591f1a61e..0000000000
--- a/build_tools/redis-configs/001-master
+++ /dev/null
@@ -1,8 +0,0 @@
-pidfile /var/run/redis-master.pid
-bind *
-port 6379
-daemonize yes
-unixsocket /tmp/redis_master.sock
-unixsocketperm 777
-dbfilename master.rdb
-dir /var/lib/redis/backups
diff --git a/build_tools/redis-configs/002-slave b/build_tools/redis-configs/002-slave
deleted file mode 100644
index 13eb77ec4d..0000000000
--- a/build_tools/redis-configs/002-slave
+++ /dev/null
@@ -1,10 +0,0 @@
-pidfile /var/run/redis-slave.pid
-bind *
-port 6380
-daemonize yes
-unixsocket /tmp/redis-slave.sock
-unixsocketperm 777
-dbfilename slave.rdb
-dir /var/lib/redis/backups
-
-slaveof 127.0.0.1 6379
diff --git a/build_tools/redis_init_script b/build_tools/redis_init_script
deleted file mode 100755
index 04cb2dbc7c..0000000000
--- a/build_tools/redis_init_script
+++ /dev/null
@@ -1,49 +0,0 @@
-#!/bin/sh
-
-### BEGIN INIT INFO
-# Provides:          redis-server
-# Required-Start:    $syslog
-# Required-Stop:     $syslog
-# Default-Start:     2 3 4 5
-# Default-Stop:      0 1 6
-# Short-Description: Start redis-server at boot time
-# Description:       Control redis-server.
-### END INIT INFO
-
-REDISPORT={{ PORT }}
-PIDFILE=/var/run/{{ PROCESS_NAME }}.pid
-CONF=/var/lib/redis/conf/{{ PROCESS_NAME }}.conf
-
-EXEC=/var/lib/redis/bin/redis-server
-CLIEXEC=/var/lib/redis/bin/redis-cli
-
-case "$1" in
-    start)
-        if [ -f $PIDFILE ]
-        then
-                echo "$PIDFILE exists, process is already running or crashed"
-        else
-                echo "Starting Redis server..."
-                $EXEC $CONF
-        fi
-        ;;
-    stop)
-        if [ ! -f $PIDFILE ]
-        then
-                echo "$PIDFILE does not exist, process is not running"
-        else
-                PID=$(cat $PIDFILE)
-                echo "Stopping ..."
-                $CLIEXEC -p $REDISPORT shutdown
-                while [ -x /proc/${PID} ]
-                do
-                    echo "Waiting for Redis to shutdown ..."
-                    sleep 1
-                done
-                echo "Redis stopped"
-        fi
-        ;;
-    *)
-        echo "Please use start or stop as first argument"
-        ;;
-esac
diff --git a/build_tools/redis_vars.sh b/build_tools/redis_vars.sh
deleted file mode 100755
index c52dd4cf37..0000000000
--- a/build_tools/redis_vars.sh
+++ /dev/null
@@ -1,48 +0,0 @@
-#!/usr/bin/env bash
-
-VAGRANT_DIR=/home/vagrant/redis-py/build_tools
-VAGRANT_REDIS_CONF_DIR=$VAGRANT_DIR/redis-configs
-VAGRANT_SENTINEL_CONF_DIR=$VAGRANT_DIR/sentinel-configs
-REDIS_VERSION=3.2.0
-REDIS_DOWNLOAD_DIR=/home/vagrant/redis-downloads
-REDIS_PACKAGE=redis-$REDIS_VERSION.tar.gz
-REDIS_BUILD_DIR=$REDIS_DOWNLOAD_DIR/redis-$REDIS_VERSION
-REDIS_DIR=/var/lib/redis
-REDIS_BIN_DIR=$REDIS_DIR/bin
-REDIS_CONF_DIR=$REDIS_DIR/conf
-REDIS_SAVE_DIR=$REDIS_DIR/backups
-REDIS_INSTALLED_INSTANCES_FILE=$REDIS_DIR/redis-instances
-SENTINEL_INSTALLED_INSTANCES_FILE=$REDIS_DIR/sentinel-instances
-
-function uninstall_instance() {
-    # Expects $1 to be the init.d filename, e.g. redis-nodename or
-    # sentinel-nodename
-
-    if [ -a /etc/init.d/$1 ]; then
-
-        echo "======================================"
-        echo "UNINSTALLING REDIS SERVER: $1"
-        echo "======================================"
-
-        /etc/init.d/$1 stop
-        update-rc.d -f $1 remove
-        rm -f /etc/init.d/$1
-    fi;
-    rm -f $REDIS_CONF_DIR/$1.conf
-}
-
-function uninstall_all_redis_instances() {
-    if [ -a $REDIS_INSTALLED_INSTANCES_FILE ]; then
-        cat $REDIS_INSTALLED_INSTANCES_FILE | while read line; do
-            uninstall_instance $line;
-        done;
-    fi
-}
-
-function uninstall_all_sentinel_instances() {
-    if [ -a $SENTINEL_INSTALLED_INSTANCES_FILE ]; then
-        cat $SENTINEL_INSTALLED_INSTANCES_FILE | while read line; do
-            uninstall_instance $line;
-        done;
-    fi
-}
diff --git a/build_tools/sentinel-configs/001-1 b/build_tools/sentinel-configs/001-1
deleted file mode 100644
index eccc3d1f84..0000000000
--- a/build_tools/sentinel-configs/001-1
+++ /dev/null
@@ -1,6 +0,0 @@
-pidfile /var/run/sentinel-1.pid
-port 26379
-daemonize yes
-
-# short timeout for sentinel tests
-sentinel down-after-milliseconds mymaster 500
diff --git a/build_tools/sentinel-configs/002-2 b/build_tools/sentinel-configs/002-2
deleted file mode 100644
index 0cd28019c4..0000000000
--- a/build_tools/sentinel-configs/002-2
+++ /dev/null
@@ -1,6 +0,0 @@
-pidfile /var/run/sentinel-2.pid
-port 26380
-daemonize yes
-
-# short timeout for sentinel tests
-sentinel down-after-milliseconds mymaster 500
diff --git a/build_tools/sentinel-configs/003-3 b/build_tools/sentinel-configs/003-3
deleted file mode 100644
index c7f4fcd335..0000000000
--- a/build_tools/sentinel-configs/003-3
+++ /dev/null
@@ -1,6 +0,0 @@
-pidfile /var/run/sentinel-3.pid
-port 26381
-daemonize yes
-
-# short timeout for sentinel tests
-sentinel down-after-milliseconds mymaster 500
diff --git a/build_tools/sentinel_init_script b/build_tools/sentinel_init_script
deleted file mode 100755
index 1d94804e9c..0000000000
--- a/build_tools/sentinel_init_script
+++ /dev/null
@@ -1,49 +0,0 @@
-#!/bin/sh
-
-### BEGIN INIT INFO
-# Provides:          redis-sentintel
-# Required-Start:    $syslog
-# Required-Stop:     $syslog
-# Default-Start:     2 3 4 5
-# Default-Stop:      0 1 6
-# Short-Description: Start redis-sentinel at boot time
-# Description:       Control redis-sentinel.
-### END INIT INFO
-
-SENTINELPORT={{ PORT }}
-PIDFILE=/var/run/{{ PROCESS_NAME }}.pid
-CONF=/var/lib/redis/conf/{{ PROCESS_NAME }}.conf
-
-EXEC=/var/lib/redis/bin/redis-sentinel
-CLIEXEC=/var/lib/redis/bin/redis-cli
-
-case "$1" in
-    start)
-        if [ -f $PIDFILE ]
-        then
-                echo "$PIDFILE exists, process is already running or crashed"
-        else
-                echo "Starting Redis Sentinel..."
-                $EXEC $CONF
-        fi
-        ;;
-    stop)
-        if [ ! -f $PIDFILE ]
-        then
-                echo "$PIDFILE does not exist, process is not running"
-        else
-                PID=$(cat $PIDFILE)
-                echo "Stopping ..."
-                $CLIEXEC -p $SENTINELPORT shutdown
-                while [ -x /proc/${PID} ]
-                do
-                    echo "Waiting for Sentinel to shutdown ..."
-                    sleep 1
-                done
-                echo "Sentinel stopped"
-        fi
-        ;;
-    *)
-        echo "Please use start or stop as first argument"
-        ;;
-esac
diff --git a/vagrant/Vagrantfile b/vagrant/Vagrantfile
deleted file mode 100644
index 3ee7aee364..0000000000
--- a/vagrant/Vagrantfile
+++ /dev/null
@@ -1,27 +0,0 @@
-# -*- mode: ruby -*-
-# vi: set ft=ruby :
-
-# Vagrantfile API/syntax version. Don't touch unless you know what you're doing!
-VAGRANTFILE_API_VERSION = "2"
-
-Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
-  # ubuntu 64bit image
-  config.vm.box = "hashicorp/precise64"
-
-  # map the root of redis-py to /home/vagrant/redis-py
-  config.vm.synced_folder "../", "/home/vagrant/redis-py"
-
-  # install the redis server
-  config.vm.provision :shell, :path => "../build_tools/bootstrap.sh"
-  config.vm.provision :shell, :path => "../build_tools/build_redis.sh"
-  config.vm.provision :shell, :path => "../build_tools/install_redis.sh"
-  config.vm.provision :shell, :path => "../build_tools/install_sentinel.sh"
-  config.vm.provision :file, :source => "../build_tools/.bash_profile", :destination => "/home/vagrant/.bash_profile"
-
-  # setup forwarded ports
-  config.vm.network "forwarded_port", guest: 6379, host: 6379
-  config.vm.network "forwarded_port", guest: 6380, host: 6380
-  config.vm.network "forwarded_port", guest: 26379, host: 26379
-  config.vm.network "forwarded_port", guest: 26380, host: 26380
-  config.vm.network "forwarded_port", guest: 26381, host: 26381
-end

From 6feed6e2da6315bf016e41c1075fe46986b46dc1 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Wed, 15 Jul 2020 23:02:57 +0000
Subject: [PATCH 0050/1164] Flesh out the docker env docs

---
 CONTRIBUTING.rst | 48 +++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 43 insertions(+), 5 deletions(-)

diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index c6990f224c..cecc418e7c 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -28,15 +28,53 @@ Getting Started
 Here's how to get started with your code contribution:
 
 1. Create your own fork of redis-py
-2. When you've checked out the fork locally, build the docker containers: ``make build``
-3. Do the changes in your fork
-4. Make sure the tests pass by running: ``make test``
+2. Do the changes in your fork
+3. If you need a development environment, run ``make dev``
+4. While developing, make sure the tests pass: ``make test``
 5. If you like the change and think the project could use it, send a pull request
 
+The Development Environment
+---------------------------
+
+Running `make dev` will create a Docker-based development environment that starts the following containers:
+
+* A master node
+* A slave node
+* Three sentinel nodes
+* A test container
+
+The slave is a replica of the master node, while the sentinels monitor it.
+
+Docker Tips
+^^^^^^^^^^^
+
+There are a few tips that can help you work with this environment:
+
+To get a bash shell inside of a container:
+
+``docker-compose run sentinel_1 /bin/bash``
+
+Containers run a minimal Debian image that probably lacks tools you want to use. To install packages, first get a bash session (see previous tip) and then run:
+
+``apt update && apt install <package>``
+
+You can see the combined logging output of all containers like this:
+
+``docker-compose logs``
+
+The command `make test` runs all tests in all tested Python environments. To run the tests in a single environment, like Python 3.6, use a command like this:
+
+``docker-compose run test tox -e py36 -- --redis-url=redis://master:6379/9``
+
+Here, the flag ``-e py36`` runs tests against the Python 3.6 tox environment. And note from the example that whenever you run tests like this, instead of using `make test`, you need to pass `-- --redis-url=redis://master:6379/9``. This points the tests at the "master" container.
+
+Our test suite uses ``pytest``. You can run a specific test suite against a specific Python version like this:
+
+``docker-compose run test tox -e py36 -- --redis-url=redis://master:6379/9 tests/test_commands.py``
+
 Troubleshooting
 ^^^^^^^^^^^^^^^
-
-If you get any errors when running ``make build`` or ``make test``, make sure that you
+If you get any errors when running ``make dev`` or ``make test``, make sure that you
 are using supported versions of Docker and docker-compose.
 
 The included Dockerfiles and docker-compose.yml file work with the following

From adebdc39302d81e58c7c9a39d667139db9166f1f Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Wed, 15 Jul 2020 23:10:51 +0000
Subject: [PATCH 0051/1164] Editing the contrib guide

---
 CONTRIBUTING.rst | 18 +++++++++++-------
 1 file changed, 11 insertions(+), 7 deletions(-)

diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index cecc418e7c..dbc1ffa9b4 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -11,7 +11,7 @@ Contributions We Need
 
 You may already know what you want to contribute -- a fix for a bug you encountered, or a new feature your team wants to use.
 
-If you don't know what to contribute, keep an open mind! Improving documentation, bug triaging, or writing tutorials are all examples of helpful contributions that mean less work for you.
+If you don't know what to contribute, keep an open mind! Improving documentation, bug triaging, and writing tutorials are all examples of helpful contributions that mean less work for you.
 
 Your First Contribution
 -----------------------
@@ -30,20 +30,24 @@ Here's how to get started with your code contribution:
 1. Create your own fork of redis-py
 2. Do the changes in your fork
 3. If you need a development environment, run ``make dev``
-4. While developing, make sure the tests pass: ``make test``
+4. While developing, make sure the tests pass by running ``make test``
 5. If you like the change and think the project could use it, send a pull request
 
 The Development Environment
 ---------------------------
 
-Running `make dev` will create a Docker-based development environment that starts the following containers:
+Running ``make dev`` will create a Docker-based development environment that starts the following containers:
 
-* A master node
-* A slave node
-* Three sentinel nodes
+* A master Redis node
+* A slave Redis node
+* Three sentinel Redis nodes
 * A test container
 
-The slave is a replica of the master node, while the sentinels monitor it.
+The slave is a replica of the master node, using the `leader-follower replication <https://redis.io/topics/replication>`_ feature.
+
+The sentinels monitor the master node in a `sentinel high-availability configuration <https://redis.io/topics/sentinel>`_.
+
+Meanwhile, the `test` container hosts the code from your checkout of `redis-py` and allows running tests against many Python versions.
 
 Docker Tips
 ^^^^^^^^^^^

From 61af925aa41a34f64a5a7bf6d330a99062661aa6 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Wed, 15 Jul 2020 23:12:58 +0000
Subject: [PATCH 0052/1164] Editing

---
 CONTRIBUTING.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index dbc1ffa9b4..bfb4a27bd4 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -15,7 +15,7 @@ If you don't know what to contribute, keep an open mind! Improving documentation
 
 Your First Contribution
 -----------------------
-Unsure where to begin contributing? You can start by looking through help-wanted issues: https://github.com/andymccurdy/redis-py/issues?q=is%3Aopen+is%3Aissue+label%3ahelp-wanted
+Unsure where to begin contributing? You can start by looking through `help-wanted issues <https://github.com/andymccurdy/redis-py/issues?q=is%3Aopen+is%3Aissue+label%3ahelp-wanted>`_.
 
 Never contributed to open source before? Here are a couple of friendly tutorials:
 
@@ -47,7 +47,7 @@ The slave is a replica of the master node, using the `leader-follower replicatio
 
 The sentinels monitor the master node in a `sentinel high-availability configuration <https://redis.io/topics/sentinel>`_.
 
-Meanwhile, the `test` container hosts the code from your checkout of `redis-py` and allows running tests against many Python versions.
+Meanwhile, the `test` container hosts the code from your checkout of ``redis-py`` and allows running tests against many Python versions.
 
 Docker Tips
 ^^^^^^^^^^^

From 344f589a52110b9d24da42b8c9f3590fde2b58a0 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Wed, 15 Jul 2020 23:13:52 +0000
Subject: [PATCH 0053/1164] Editing

---
 CONTRIBUTING.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index bfb4a27bd4..e2db60f2ef 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -52,7 +52,7 @@ Meanwhile, the `test` container hosts the code from your checkout of ``redis-py`
 Docker Tips
 ^^^^^^^^^^^
 
-There are a few tips that can help you work with this environment:
+Following are a few tips that can help you work with the Docker-based development environment.
 
 To get a bash shell inside of a container:
 

From f67ab19ba9f45d63f7afc12e1aa9a994c4bff3da Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Wed, 15 Jul 2020 23:19:00 +0000
Subject: [PATCH 0054/1164] Editing

---
 CONTRIBUTING.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index e2db60f2ef..6dc745b329 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -56,7 +56,9 @@ Following are a few tips that can help you work with the Docker-based developmen
 
 To get a bash shell inside of a container:
 
-``docker-compose run sentinel_1 /bin/bash``
+``docker-compose run <service> /bin/bash``
+ 
+**Note**: The term "service" refers to the "services" defined in the `docker-compose.yml` file: "master", "slave", "sentinel_1", "sentinel_2", "sentinel_3", "tests".
 
 Containers run a minimal Debian image that probably lacks tools you want to use. To install packages, first get a bash session (see previous tip) and then run:
 

From 5c32b2320efd1e4bbae5a1bbf141426ce68b91fd Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Wed, 15 Jul 2020 23:21:15 +0000
Subject: [PATCH 0055/1164] Editing

---
 CONTRIBUTING.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index 6dc745b329..c54fc10748 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -56,27 +56,27 @@ Following are a few tips that can help you work with the Docker-based developmen
 
 To get a bash shell inside of a container:
 
-``docker-compose run <service> /bin/bash``
+``$ docker-compose run <service> /bin/bash``
  
-**Note**: The term "service" refers to the "services" defined in the `docker-compose.yml` file: "master", "slave", "sentinel_1", "sentinel_2", "sentinel_3", "tests".
+**Note**: The term "service" refers to the "services" defined in the ``docker-compose.yml`` file: "master", "slave", "sentinel_1", "sentinel_2", "sentinel_3", "test".
 
 Containers run a minimal Debian image that probably lacks tools you want to use. To install packages, first get a bash session (see previous tip) and then run:
 
-``apt update && apt install <package>``
+``$ apt update && apt install <package>``
 
 You can see the combined logging output of all containers like this:
 
-``docker-compose logs``
+``$ docker-compose logs``
 
 The command `make test` runs all tests in all tested Python environments. To run the tests in a single environment, like Python 3.6, use a command like this:
 
-``docker-compose run test tox -e py36 -- --redis-url=redis://master:6379/9``
+``$ docker-compose run test tox -e py36 -- --redis-url=redis://master:6379/9``
 
 Here, the flag ``-e py36`` runs tests against the Python 3.6 tox environment. And note from the example that whenever you run tests like this, instead of using `make test`, you need to pass `-- --redis-url=redis://master:6379/9``. This points the tests at the "master" container.
 
 Our test suite uses ``pytest``. You can run a specific test suite against a specific Python version like this:
 
-``docker-compose run test tox -e py36 -- --redis-url=redis://master:6379/9 tests/test_commands.py``
+``$ docker-compose run test tox -e py36 -- --redis-url=redis://master:6379/9 tests/test_commands.py``
 
 Troubleshooting
 ^^^^^^^^^^^^^^^

From 11ef996e664446e11c70fb5fff815c7acb25b9cb Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Wed, 15 Jul 2020 23:23:54 +0000
Subject: [PATCH 0056/1164] Editing docs

---
 CONTRIBUTING.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index c54fc10748..edaa7b6773 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -72,7 +72,7 @@ The command `make test` runs all tests in all tested Python environments. To run
 
 ``$ docker-compose run test tox -e py36 -- --redis-url=redis://master:6379/9``
 
-Here, the flag ``-e py36`` runs tests against the Python 3.6 tox environment. And note from the example that whenever you run tests like this, instead of using `make test`, you need to pass `-- --redis-url=redis://master:6379/9``. This points the tests at the "master" container.
+Here, the flag ``-e py36`` runs tests against the Python 3.6 tox environment. And note from the example that whenever you run tests like this, instead of using `make test`, you need to pass ``-- --redis-url=redis://master:6379/9``. This points the tests at the "master" container.
 
 Our test suite uses ``pytest``. You can run a specific test suite against a specific Python version like this:
 

From 4cf1d83460eb25cc4dfdee090b212ff42456cd1c Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Wed, 15 Jul 2020 16:35:54 -0700
Subject: [PATCH 0057/1164] restore codecov

---
 .travis.yml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.travis.yml b/.travis.yml
index 4b09cfcced..d31fea063d 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,3 +1,6 @@
+language: python
+cache: pip
+
 env:
   - DOCKER_COMPOSE_VERSION=1.26.2
 
@@ -10,5 +13,11 @@ before_install:
 services:
   - docker
 
+install:
+  - pip install codecov
+
 script:
   - make test
+
+after_success:
+  - codecov

From 5ab3a8d158db34e3267e9b102b3b98949355b320 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Thu, 16 Jul 2020 00:46:19 +0000
Subject: [PATCH 0058/1164] Try running codecov in the test container

---
 .travis.yml | 8 +-------
 Dockerfile  | 5 ++++-
 2 files changed, 5 insertions(+), 8 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index d31fea063d..8e90fab1d8 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,6 +1,3 @@
-language: python
-cache: pip
-
 env:
   - DOCKER_COMPOSE_VERSION=1.26.2
 
@@ -13,11 +10,8 @@ before_install:
 services:
   - docker
 
-install:
-  - pip install codecov
-
 script:
   - make test
 
 after_success:
-  - codecov
+  - docker-compose run test codecov
diff --git a/Dockerfile b/Dockerfile
index cd530ef2cd..185a477b72 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -1,4 +1,7 @@
 FROM fkrull/multi-python:latest
 
-RUN apt install -y pypy pypy-dev pypy3-dev
+RUN apt update && apt install -y pypy pypy-dev pypy3-dev curl
+RUN curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py && python3.8 get-pip.py
+RUN pip install codecov
+
 COPY . /redis-py

From 841d5cead05c18a9d2ad212ed2bee46670c5dff8 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Thu, 16 Jul 2020 00:48:34 +0000
Subject: [PATCH 0059/1164] Try to pass the codecov token...

---
 .travis.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index 8e90fab1d8..95940af002 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -14,4 +14,4 @@ script:
   - make test
 
 after_success:
-  - docker-compose run test codecov
+  - docker-compose run -e CODECOV_TOKEN=$CODECOV_TOKEN test codecov

From 8c7d2da53714c6c41364790ebbd68c10dbe38d83 Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Thu, 16 Jul 2020 14:40:29 -0700
Subject: [PATCH 0060/1164] testing docker-entry

---
 .travis.yml        |  3 ---
 Dockerfile         |  2 ++
 Makefile           | 14 +++++++-------
 docker-compose.yml |  4 +++-
 docker-entry.sh    | 17 +++++++++++++++++
 5 files changed, 29 insertions(+), 11 deletions(-)
 create mode 100755 docker-entry.sh

diff --git a/.travis.yml b/.travis.yml
index 95940af002..4b09cfcced 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -12,6 +12,3 @@ services:
 
 script:
   - make test
-
-after_success:
-  - docker-compose run -e CODECOV_TOKEN=$CODECOV_TOKEN test codecov
diff --git a/Dockerfile b/Dockerfile
index 185a477b72..3bcc3ec40c 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -4,4 +4,6 @@ RUN apt update && apt install -y pypy pypy-dev pypy3-dev curl
 RUN curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py && python3.8 get-pip.py
 RUN pip install codecov
 
+WORKDIR /redis-py
+
 COPY . /redis-py
diff --git a/Makefile b/Makefile
index d21d4f4526..7c331355af 100644
--- a/Makefile
+++ b/Makefile
@@ -1,14 +1,14 @@
 .PHONY: base clean dev test
 
 base:
-	docker build -t redis-py-base docker/base
+		docker build -t redis-py-base docker/base
 
-dev: base
-	docker-compose up -d --build
+dev:	base
+		docker-compose up -d --build
 
-test: dev
-	docker-compose run --rm test util/wait-for-it.sh master:6379 -- tox -- --redis-url=redis://master:6379/9
+test:	dev
+		docker-compose run --rm -e TRAVIS test /redis-py/docker-entry.sh
 
 clean:
-	docker-compose stop
-	docker-compose rm -f
+		docker-compose stop
+		docker-compose rm -f
diff --git a/docker-compose.yml b/docker-compose.yml
index 631e2f8fb3..3adf9c2404 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -36,6 +36,8 @@ services:
 
   test:
     build: .
-    working_dir: /redis-py
     depends_on:
       - "sentinel_3"
+    environment:
+      REDIS_MASTER_HOST: master
+      REDIS_MASTER_PORT: "6379"
diff --git a/docker-entry.sh b/docker-entry.sh
new file mode 100755
index 0000000000..d1f232c48e
--- /dev/null
+++ b/docker-entry.sh
@@ -0,0 +1,17 @@
+#!/bin/sh
+
+# This is the entrypoint for "make clean". It invokes Tox. If running
+# within the CI environment, it also runs codecov
+
+set -eu
+
+REDIS_MASTER="${REDIS_MASTER_HOST}":"${REDIS_MASTER_PORT}"
+echo "Testing against Redis Server: ${REDIS_MASTER}"
+
+# use the wait-for-it util to ensure the server is running before invoking Tox
+util/wait-for-it.sh ${REDIS_MASTER} -- tox -- --redis-url=redis://"${REDIS_MASTER}"/9
+
+# if the TRAVIS env var is defined, invoke "codecov"
+if [ ! -z ${TRAVIS-} ]; then
+    codecov
+fi

From 59b460a0f2d3a70739cf67a7c42f7cc59114a8dd Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Thu, 16 Jul 2020 15:14:25 -0700
Subject: [PATCH 0061/1164] pass travis/codecov env vars to docker

---
 Makefile           |  2 +-
 docker-compose.yml | 27 +++++++++++++++++++++++++--
 docker-entry.sh    |  2 +-
 3 files changed, 27 insertions(+), 4 deletions(-)

diff --git a/Makefile b/Makefile
index 7c331355af..0d0964345a 100644
--- a/Makefile
+++ b/Makefile
@@ -7,7 +7,7 @@ dev:	base
 		docker-compose up -d --build
 
 test:	dev
-		docker-compose run --rm -e TRAVIS test /redis-py/docker-entry.sh
+		docker-compose run --rm test /redis-py/docker-entry.sh
 
 clean:
 		docker-compose stop
diff --git a/docker-compose.yml b/docker-compose.yml
index 3adf9c2404..b76bf8357c 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -39,5 +39,28 @@ services:
     depends_on:
       - "sentinel_3"
     environment:
-      REDIS_MASTER_HOST: master
-      REDIS_MASTER_PORT: "6379"
+      - REDIS_MASTER_HOST=master
+      - REDIS_MASTER_PORT=6379
+      - CI_BUILD_ID
+      - CI_BUILD_URL
+      - CI_JOB_ID
+      - CODECOV_ENV
+      - CODECOV_SLUG
+      - CODECOV_TOKEN
+      - CODECOV_URL
+      - SHIPPABLE
+      - TRAVIS
+      - TRAVIS_BRANCH
+      - TRAVIS_COMMIT
+      - TRAVIS_JOB_ID
+      - TRAVIS_JOB_NUMBER
+      - TRAVIS_OS_NAME
+      - TRAVIS_PULL_REQUEST
+      - TRAVIS_REPO_SLUG
+      - TRAVIS_TAG
+      - VCS_BRANCH_NAME
+      - VCS_COMMIT_ID
+      - VCS_PULL_REQUEST
+      - VCS_SLUG
+      - VCS_TAG
+
diff --git a/docker-entry.sh b/docker-entry.sh
index d1f232c48e..4722f3529e 100755
--- a/docker-entry.sh
+++ b/docker-entry.sh
@@ -1,6 +1,6 @@
 #!/bin/sh
 
-# This is the entrypoint for "make clean". It invokes Tox. If running
+# This is the entrypoint for "make test". It invokes Tox. If running
 # within the CI environment, it also runs codecov
 
 set -eu

From 07dd8e332f39eefe04543c9cad6e2c70a6eec981 Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Thu, 16 Jul 2020 15:49:52 -0700
Subject: [PATCH 0062/1164] debug

---
 docker-compose.yml | 49 +++++++++++++++++++++++-----------------------
 docker-entry.sh    |  3 +++
 2 files changed, 27 insertions(+), 25 deletions(-)

diff --git a/docker-compose.yml b/docker-compose.yml
index b76bf8357c..bc5f6d82af 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -39,28 +39,27 @@ services:
     depends_on:
       - "sentinel_3"
     environment:
-      - REDIS_MASTER_HOST=master
-      - REDIS_MASTER_PORT=6379
-      - CI_BUILD_ID
-      - CI_BUILD_URL
-      - CI_JOB_ID
-      - CODECOV_ENV
-      - CODECOV_SLUG
-      - CODECOV_TOKEN
-      - CODECOV_URL
-      - SHIPPABLE
-      - TRAVIS
-      - TRAVIS_BRANCH
-      - TRAVIS_COMMIT
-      - TRAVIS_JOB_ID
-      - TRAVIS_JOB_NUMBER
-      - TRAVIS_OS_NAME
-      - TRAVIS_PULL_REQUEST
-      - TRAVIS_REPO_SLUG
-      - TRAVIS_TAG
-      - VCS_BRANCH_NAME
-      - VCS_COMMIT_ID
-      - VCS_PULL_REQUEST
-      - VCS_SLUG
-      - VCS_TAG
-
+      REDIS_MASTER_HOST: master
+      REDIS_MASTER_PORT: 6379
+      CI_BUILD_ID:
+      CI_BUILD_URL:
+      CI_JOB_ID:
+      CODECOV_ENV:
+      CODECOV_SLUG:
+      CODECOV_TOKEN:
+      CODECOV_URL:
+      SHIPPABLE:
+      TRAVIS:
+      TRAVIS_BRANCH:
+      TRAVIS_COMMIT:
+      TRAVIS_JOB_ID:
+      TRAVIS_JOB_NUMBER:
+      TRAVIS_OS_NAME:
+      TRAVIS_PULL_REQUEST:
+      TRAVIS_REPO_SLUG:
+      TRAVIS_TAG:
+      VCS_BRANCH_NAME:
+      VCS_COMMIT_ID:
+      VCS_PULL_REQUEST:
+      VCS_SLUG:
+      VCS_TAG:
diff --git a/docker-entry.sh b/docker-entry.sh
index 4722f3529e..ddaa81bd86 100755
--- a/docker-entry.sh
+++ b/docker-entry.sh
@@ -8,6 +8,9 @@ set -eu
 REDIS_MASTER="${REDIS_MASTER_HOST}":"${REDIS_MASTER_PORT}"
 echo "Testing against Redis Server: ${REDIS_MASTER}"
 
+#debug
+echo `bash <(curl -s https://codecov.io/env)`
+
 # use the wait-for-it util to ensure the server is running before invoking Tox
 util/wait-for-it.sh ${REDIS_MASTER} -- tox -- --redis-url=redis://"${REDIS_MASTER}"/9
 

From d582494b2507a7aa18945bb6d3d6ca2a185b0c27 Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Thu, 16 Jul 2020 15:52:22 -0700
Subject: [PATCH 0063/1164] debug

---
 docker-entry.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docker-entry.sh b/docker-entry.sh
index ddaa81bd86..17835be1fe 100755
--- a/docker-entry.sh
+++ b/docker-entry.sh
@@ -1,4 +1,4 @@
-#!/bin/sh
+#!/bin/bash
 
 # This is the entrypoint for "make test". It invokes Tox. If running
 # within the CI environment, it also runs codecov

From e5c7bfdaf5a95ffe13843f0a216750125c0cebf9 Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Thu, 16 Jul 2020 16:21:39 -0700
Subject: [PATCH 0064/1164] debug

---
 .travis.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index 4b09cfcced..e285810f87 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -11,4 +11,4 @@ services:
   - docker
 
 script:
-  - make test
+  - echo `bash <(curl -s https://codecov.io/env)`

From cbf7b27926fccee325a5ca2e2fb3a28426677620 Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Thu, 16 Jul 2020 16:25:51 -0700
Subject: [PATCH 0065/1164] debug

---
 .travis.yml     | 2 +-
 docker-entry.sh | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index e285810f87..4b09cfcced 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -11,4 +11,4 @@ services:
   - docker
 
 script:
-  - echo `bash <(curl -s https://codecov.io/env)`
+  - make test
diff --git a/docker-entry.sh b/docker-entry.sh
index 17835be1fe..36f25d371c 100755
--- a/docker-entry.sh
+++ b/docker-entry.sh
@@ -9,7 +9,8 @@ REDIS_MASTER="${REDIS_MASTER_HOST}":"${REDIS_MASTER_PORT}"
 echo "Testing against Redis Server: ${REDIS_MASTER}"
 
 #debug
-echo `bash <(curl -s https://codecov.io/env)`
+echo "travis job id: ${TRAVIS_JOB_ID}"
+exit 0
 
 # use the wait-for-it util to ensure the server is running before invoking Tox
 util/wait-for-it.sh ${REDIS_MASTER} -- tox -- --redis-url=redis://"${REDIS_MASTER}"/9

From 2bff16169a65de70e8a77510080f314d3c35837c Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Thu, 16 Jul 2020 16:28:40 -0700
Subject: [PATCH 0066/1164] debug

---
 docker-entry.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docker-entry.sh b/docker-entry.sh
index 36f25d371c..320cca78e2 100755
--- a/docker-entry.sh
+++ b/docker-entry.sh
@@ -9,7 +9,7 @@ REDIS_MASTER="${REDIS_MASTER_HOST}":"${REDIS_MASTER_PORT}"
 echo "Testing against Redis Server: ${REDIS_MASTER}"
 
 #debug
-echo "travis job id: ${TRAVIS_JOB_ID}"
+env
 exit 0
 
 # use the wait-for-it util to ensure the server is running before invoking Tox

From fe89d3159bfb493cc20085b9180e4450e6f222be Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Thu, 16 Jul 2020 16:42:11 -0700
Subject: [PATCH 0067/1164] debug

---
 docker-compose.yml | 1 +
 docker-entry.sh    | 1 +
 2 files changed, 2 insertions(+)

diff --git a/docker-compose.yml b/docker-compose.yml
index bc5f6d82af..247688ad8c 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -41,6 +41,7 @@ services:
     environment:
       REDIS_MASTER_HOST: master
       REDIS_MASTER_PORT: 6379
+      CI:
       CI_BUILD_ID:
       CI_BUILD_URL:
       CI_JOB_ID:
diff --git a/docker-entry.sh b/docker-entry.sh
index 320cca78e2..6e3fb91485 100755
--- a/docker-entry.sh
+++ b/docker-entry.sh
@@ -10,6 +10,7 @@ echo "Testing against Redis Server: ${REDIS_MASTER}"
 
 #debug
 env
+codecov
 exit 0
 
 # use the wait-for-it util to ensure the server is running before invoking Tox

From d878df7280be7c4365ee1522d23f37d961735257 Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Thu, 16 Jul 2020 16:45:24 -0700
Subject: [PATCH 0068/1164] debug

---
 docker-entry.sh | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/docker-entry.sh b/docker-entry.sh
index 6e3fb91485..e05cc2296c 100755
--- a/docker-entry.sh
+++ b/docker-entry.sh
@@ -8,11 +8,6 @@ set -eu
 REDIS_MASTER="${REDIS_MASTER_HOST}":"${REDIS_MASTER_PORT}"
 echo "Testing against Redis Server: ${REDIS_MASTER}"
 
-#debug
-env
-codecov
-exit 0
-
 # use the wait-for-it util to ensure the server is running before invoking Tox
 util/wait-for-it.sh ${REDIS_MASTER} -- tox -- --redis-url=redis://"${REDIS_MASTER}"/9
 

From 7da4b55a2831db4d0d0da616322fd491ddb9c3d6 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Fri, 17 Jul 2020 19:27:40 +0000
Subject: [PATCH 0069/1164] Try running codecov from tox

---
 .gitignore      |  1 +
 Dockerfile      |  4 +---
 docker-entry.sh |  2 +-
 tox.ini         | 16 +++++++++++++++-
 4 files changed, 18 insertions(+), 5 deletions(-)

diff --git a/.gitignore b/.gitignore
index a9b10171fe..b59bcdf097 100644
--- a/.gitignore
+++ b/.gitignore
@@ -13,3 +13,4 @@ vagrant/.vagrant
 .coverage
 env
 venv
+coverage.xml
diff --git a/Dockerfile b/Dockerfile
index 3bcc3ec40c..eba66f09ed 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -1,8 +1,6 @@
 FROM fkrull/multi-python:latest
 
-RUN apt update && apt install -y pypy pypy-dev pypy3-dev curl
-RUN curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py && python3.8 get-pip.py
-RUN pip install codecov
+RUN apt update && apt install -y pypy pypy-dev pypy3-dev
 
 WORKDIR /redis-py
 
diff --git a/docker-entry.sh b/docker-entry.sh
index e05cc2296c..efcd20521e 100755
--- a/docker-entry.sh
+++ b/docker-entry.sh
@@ -13,5 +13,5 @@ util/wait-for-it.sh ${REDIS_MASTER} -- tox -- --redis-url=redis://"${REDIS_MASTE
 
 # if the TRAVIS env var is defined, invoke "codecov"
 if [ ! -z ${TRAVIS-} ]; then
-    codecov
+    tox -e codecov
 fi
diff --git a/tox.ini b/tox.ini
index 30682fb9aa..0a01fef06e 100644
--- a/tox.ini
+++ b/tox.ini
@@ -1,5 +1,5 @@
 [pytest]
-addopts = -s
+addopts = -s --cov-report=term-missing --cov redis
 
 [tox]
 minversion = 2.4
@@ -10,6 +10,7 @@ deps =
     coverage
     mock
     pytest >= 2.7.0
+    pytest-cov >= 2.10.0
 extras =
     hiredis: hiredis
 commands = {envpython} -b -m coverage run -m pytest -W always {posargs}
@@ -32,3 +33,16 @@ basepython = pypy3
 
 [testenv:pypy3-hiredis]
 basepython = pypy3
+
+[testenv:codecov]
+deps = codecov
+commands = codecov
+passenv =
+  REDIS_*
+  CI
+  CI_*
+  CODECOV_*
+  SHIPPABLE
+  TRAVIS
+  TRAVIS_*
+  VCS_*

From 884c3d3ddf0e3e9e7d5cbc60656306015c536f88 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Fri, 17 Jul 2020 20:06:28 +0000
Subject: [PATCH 0070/1164] Attempt to combine coverage files

---
 tox.ini | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/tox.ini b/tox.ini
index 0a01fef06e..919ad6a49c 100644
--- a/tox.ini
+++ b/tox.ini
@@ -13,7 +13,9 @@ deps =
     pytest-cov >= 2.10.0
 extras =
     hiredis: hiredis
-commands = {envpython} -b -m coverage run -m pytest -W always {posargs}
+commands =
+    {envpython} -b -m coverage run -p -m pytest -W always {posargs}
+    {envpython} -b -m coverage combine --append
 
 [testenv:flake8]
 basepython = python3.6

From 07c26758d8a8af28845d534a29b0d35269126108 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Fri, 17 Jul 2020 20:13:29 +0000
Subject: [PATCH 0071/1164] Use the -a flag instead of "combine"

---
 tox.ini | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/tox.ini b/tox.ini
index 919ad6a49c..13ffb5b2ad 100644
--- a/tox.ini
+++ b/tox.ini
@@ -14,8 +14,7 @@ deps =
 extras =
     hiredis: hiredis
 commands =
-    {envpython} -b -m coverage run -p -m pytest -W always {posargs}
-    {envpython} -b -m coverage combine --append
+    {envpython} -b -m coverage run -a -m pytest -W always {posargs}
 
 [testenv:flake8]
 basepython = python3.6

From 4c6cd16bc9ebe75f34a5934cab1e67d1ab8f0bf9 Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Fri, 17 Jul 2020 20:43:51 +0000
Subject: [PATCH 0072/1164] Go back to "merge" -- -a failed

---
 tox.ini | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/tox.ini b/tox.ini
index 13ffb5b2ad..919ad6a49c 100644
--- a/tox.ini
+++ b/tox.ini
@@ -14,7 +14,8 @@ deps =
 extras =
     hiredis: hiredis
 commands =
-    {envpython} -b -m coverage run -a -m pytest -W always {posargs}
+    {envpython} -b -m coverage run -p -m pytest -W always {posargs}
+    {envpython} -b -m coverage combine --append
 
 [testenv:flake8]
 basepython = python3.6

From 4565195a93cd50400038f6d2a9a3ad759e0811bc Mon Sep 17 00:00:00 2001
From: Andrew Brookins <andrew.brookins@redislabs.com>
Date: Fri, 17 Jul 2020 21:46:37 +0000
Subject: [PATCH 0073/1164] Remove unnecessary pytest-cov dep

---
 .coveragerc     | 2 ++
 docker-entry.sh | 1 +
 tox.ini         | 7 +++++--
 3 files changed, 8 insertions(+), 2 deletions(-)
 create mode 100644 .coveragerc

diff --git a/.coveragerc b/.coveragerc
new file mode 100644
index 0000000000..9be06b93ca
--- /dev/null
+++ b/.coveragerc
@@ -0,0 +1,2 @@
+[run]
+source = redis
diff --git a/docker-entry.sh b/docker-entry.sh
index efcd20521e..f1c7baa086 100755
--- a/docker-entry.sh
+++ b/docker-entry.sh
@@ -10,6 +10,7 @@ echo "Testing against Redis Server: ${REDIS_MASTER}"
 
 # use the wait-for-it util to ensure the server is running before invoking Tox
 util/wait-for-it.sh ${REDIS_MASTER} -- tox -- --redis-url=redis://"${REDIS_MASTER}"/9
+tox -e covreport
 
 # if the TRAVIS env var is defined, invoke "codecov"
 if [ ! -z ${TRAVIS-} ]; then
diff --git a/tox.ini b/tox.ini
index 919ad6a49c..e36191104a 100644
--- a/tox.ini
+++ b/tox.ini
@@ -1,5 +1,5 @@
 [pytest]
-addopts = -s --cov-report=term-missing --cov redis
+addopts = -s
 
 [tox]
 minversion = 2.4
@@ -10,7 +10,6 @@ deps =
     coverage
     mock
     pytest >= 2.7.0
-    pytest-cov >= 2.10.0
 extras =
     hiredis: hiredis
 commands =
@@ -48,3 +47,7 @@ passenv =
   TRAVIS
   TRAVIS_*
   VCS_*
+
+[testenv:covreport]
+deps = coverage
+commands = coverage report

From a4ccbe471b9bd2c1ec86bf6d5b08a110088e4161 Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Mon, 20 Jul 2020 13:25:52 -0700
Subject: [PATCH 0074/1164] add the covreport env to the list of default envs
 tox runs

---
 docker-entry.sh | 1 -
 tox.ini         | 2 +-
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/docker-entry.sh b/docker-entry.sh
index f1c7baa086..efcd20521e 100755
--- a/docker-entry.sh
+++ b/docker-entry.sh
@@ -10,7 +10,6 @@ echo "Testing against Redis Server: ${REDIS_MASTER}"
 
 # use the wait-for-it util to ensure the server is running before invoking Tox
 util/wait-for-it.sh ${REDIS_MASTER} -- tox -- --redis-url=redis://"${REDIS_MASTER}"/9
-tox -e covreport
 
 # if the TRAVIS env var is defined, invoke "codecov"
 if [ ! -z ${TRAVIS-} ]; then
diff --git a/tox.ini b/tox.ini
index e36191104a..3007f119c7 100644
--- a/tox.ini
+++ b/tox.ini
@@ -3,7 +3,7 @@ addopts = -s
 
 [tox]
 minversion = 2.4
-envlist = {py27,py35,py36,py37,py38,pypy,pypy3}-{plain,hiredis}, flake8
+envlist = {py27,py35,py36,py37,py38,pypy,pypy3}-{plain,hiredis}, flake8, covreport
 
 [testenv]
 deps =

From f24b7f2b66172f9df7143b57d324ffb41bca979b Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Mon, 20 Jul 2020 13:26:15 -0700
Subject: [PATCH 0075/1164] make the slowlog_get test more resilient to
 multiple clients being connected

---
 tests/test_commands.py | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/tests/test_commands.py b/tests/test_commands.py
index 65e877ca7a..1f2c97d057 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -433,12 +433,10 @@ def test_slowlog_get(self, r, slowlog):
     def test_slowlog_get_limit(self, r, slowlog):
         assert r.slowlog_reset()
         r.get('foo')
-        r.get('bar')
         slowlog = r.slowlog_get(1)
         assert isinstance(slowlog, list)
-        commands = [log['command'] for log in slowlog]
-        assert b'GET foo' not in commands
-        assert b'GET bar' in commands
+        # only one command, based on the number we passed to slowlog_get()
+        assert len(slowlog) == 1
 
     def test_slowlog_length(self, r, slowlog):
         r.get('foo')

From 458ded5ece062a961cd7093933b3ed68e4e7a6c4 Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Mon, 20 Jul 2020 13:51:40 -0700
Subject: [PATCH 0076/1164] run the codecov env by default and disable when
 running outside Travis

---
 docker-entry.sh | 12 +++++++-----
 tox.ini         |  2 +-
 2 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/docker-entry.sh b/docker-entry.sh
index efcd20521e..f63a8c5f14 100755
--- a/docker-entry.sh
+++ b/docker-entry.sh
@@ -1,17 +1,19 @@
 #!/bin/bash
 
 # This is the entrypoint for "make test". It invokes Tox. If running
-# within the CI environment, it also runs codecov
+# outside the CI environment, it disables uploading the coverage report to codecov
 
 set -eu
 
 REDIS_MASTER="${REDIS_MASTER_HOST}":"${REDIS_MASTER_PORT}"
 echo "Testing against Redis Server: ${REDIS_MASTER}"
 
+# skip the "codecov" env if not running on Travis
+if [ -z ${TRAVIS-} ]; then
+    echo "Skipping codecov"
+    export TOX_SKIP_ENV="codecov"
+fi
+
 # use the wait-for-it util to ensure the server is running before invoking Tox
 util/wait-for-it.sh ${REDIS_MASTER} -- tox -- --redis-url=redis://"${REDIS_MASTER}"/9
 
-# if the TRAVIS env var is defined, invoke "codecov"
-if [ ! -z ${TRAVIS-} ]; then
-    tox -e codecov
-fi
diff --git a/tox.ini b/tox.ini
index 3007f119c7..d1d97f4906 100644
--- a/tox.ini
+++ b/tox.ini
@@ -3,7 +3,7 @@ addopts = -s
 
 [tox]
 minversion = 2.4
-envlist = {py27,py35,py36,py37,py38,pypy,pypy3}-{plain,hiredis}, flake8, covreport
+envlist = {py27,py35,py36,py37,py38,pypy,pypy3}-{plain,hiredis}, flake8, covreport, codecov
 
 [testenv]
 deps =

From 1f988d85662ec748a0111d4a6aa4e31effd020cd Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Mon, 20 Jul 2020 14:21:11 -0700
Subject: [PATCH 0077/1164] changelog

---
 CHANGES | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES b/CHANGES
index 03b2354e9d..fc4de47c44 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,6 @@
+* (in development)
+    * Provide a development and testing environment via docker. Thanks
+      @abrookins. #1365
 * 3.5.3 (June 1, 2020)
     * Restore try/except clauses to __del__ methods. These will be removed
       in 4.0 when more explicit resource management if enforced. #1339

From f001927f91ba3c22cb892bbf1e39b34fd47693bc Mon Sep 17 00:00:00 2001
From: Paul Spooren <mail@aparcar.org>
Date: Wed, 22 Jul 2020 12:09:12 -1000
Subject: [PATCH 0078/1164] LPOS: add new command (#1354)

Added the LPOS command from Redis 6.0.6

Fixes #1353
---
 docker/base/Dockerfile |  2 +-
 redis/client.py        | 36 ++++++++++++++++++++++++++++++++++++
 tests/test_commands.py | 32 ++++++++++++++++++++++++++++++++
 3 files changed, 69 insertions(+), 1 deletion(-)

diff --git a/docker/base/Dockerfile b/docker/base/Dockerfile
index ab973861da..8e952b8e4d 100644
--- a/docker/base/Dockerfile
+++ b/docker/base/Dockerfile
@@ -1 +1 @@
-FROM redis:6.0.5-buster
+FROM redis:6.0.6-buster
diff --git a/redis/client.py b/redis/client.py
index 9653f7d294..5c95e9fa65 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -2030,6 +2030,42 @@ def rpushx(self, name, value):
         "Push ``value`` onto the tail of the list ``name`` if ``name`` exists"
         return self.execute_command('RPUSHX', name, value)
 
+    def lpos(self, name, value, rank=None, count=None, maxlen=None):
+        """
+        Get position of ``value`` within the list ``name``
+
+         If specified, ``rank`` indicates the "rank" of the first element to
+         return in case there are multiple copies of ``value`` in the list.
+         By default, LPOS returns the position of the first occurrence of
+         ``value`` in the list. When ``rank`` 2, LPOS returns the position of
+         the second ``value`` in the list. If ``rank`` is negative, LPOS
+         searches the list in reverse. For example, -1 would return the
+         position of the last occurrence of ``value`` and -2 would return the
+         position of the next to last occurrence of ``value``.
+
+         If specified, ``count`` indicates that LPOS should return a list of
+         up to ``count`` positions. A ``count`` of 2 would return a list of
+         up to 2 positions. A ``count`` of 0 returns a list of all positions
+         matching ``value``. When ``count`` is specified and but ``value``
+         does not exist in the list, an empty list is returned.
+
+         If specified, ``maxlen`` indicates the maximum number of list
+         elements to scan. A ``maxlen`` of 1000 will only return the
+         position(s) of items within the first 1000 entries in the list.
+         A ``maxlen`` of 0 (the default) will scan the entire list.
+        """
+        pieces = [name, value]
+        if rank is not None:
+            pieces.extend(['RANK', rank])
+
+        if count is not None:
+            pieces.extend(['COUNT', count])
+
+        if maxlen is not None:
+            pieces.extend(['MAXLEN', maxlen])
+
+        return self.execute_command('LPOS', *pieces)
+
     def sort(self, name, start=None, num=None, by=None, get=None,
              desc=False, alpha=False, store=None, groups=False):
         """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index c68f14c2c4..91bcbb3098 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1052,6 +1052,38 @@ def test_rpush(self, r):
         assert r.rpush('a', '3', '4') == 4
         assert r.lrange('a', 0, -1) == [b'1', b'2', b'3', b'4']
 
+    @skip_if_server_version_lt('6.0.6')
+    def test_lpos(self, r):
+        assert r.rpush('a', 'a', 'b', 'c', '1', '2', '3', 'c', 'c') == 8
+        assert r.lpos('a', 'a') == 0
+        assert r.lpos('a', 'c') == 2
+
+        assert r.lpos('a', 'c', rank=1) == 2
+        assert r.lpos('a', 'c', rank=2) == 6
+        assert r.lpos('a', 'c', rank=4) is None
+        assert r.lpos('a', 'c', rank=-1) == 7
+        assert r.lpos('a', 'c', rank=-2) == 6
+
+        assert r.lpos('a', 'c', count=0) == [2, 6, 7]
+        assert r.lpos('a', 'c', count=1) == [2]
+        assert r.lpos('a', 'c', count=2) == [2, 6]
+        assert r.lpos('a', 'c', count=100) == [2, 6, 7]
+
+        assert r.lpos('a', 'c', count=0, rank=2) == [6, 7]
+        assert r.lpos('a', 'c', count=2, rank=-1) == [7, 6]
+
+        assert r.lpos('axxx', 'c', count=0, rank=2) == []
+        assert r.lpos('axxx', 'c') is None
+
+        assert r.lpos('a', 'x', count=2) == []
+        assert r.lpos('a', 'x') is None
+
+        assert r.lpos('a', 'a', count=0, maxlen=1) == [0]
+        assert r.lpos('a', 'c', count=0, maxlen=1) == []
+        assert r.lpos('a', 'c', count=0, maxlen=3) == [2]
+        assert r.lpos('a', 'c', count=0, maxlen=3, rank=-1) == [7, 6]
+        assert r.lpos('a', 'c', count=0, maxlen=7, rank=2) == [6]
+
     def test_rpushx(self, r):
         assert r.rpushx('a', 'b') == 0
         assert r.lrange('a', 0, -1) == []

From 20ec5d771d5116f51735b1d7912447e75c8c3d53 Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Wed, 22 Jul 2020 16:47:25 -0700
Subject: [PATCH 0079/1164] changelog

---
 CHANGES | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/CHANGES b/CHANGES
index fc4de47c44..2988fde6a5 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,6 +1,8 @@
 * (in development)
     * Provide a development and testing environment via docker. Thanks
       @abrookins. #1365
+    * Added support for the LPOS command available in Redis 6.0.6. Thanks
+      @aparcar #1353/#1354
 * 3.5.3 (June 1, 2020)
     * Restore try/except clauses to __del__ methods. These will be removed
       in 4.0 when more explicit resource management if enforced. #1339

From c6f13c3b69d32257ab75ba9d824e5b555f91572c Mon Sep 17 00:00:00 2001
From: Jon Banafato <jon@jonafato.com>
Date: Fri, 24 Jul 2020 17:55:33 -0400
Subject: [PATCH 0080/1164] Fix some documentation formatting

Fix a few broken links and class references, move a docstring, and fix a
code block.
---
 redis/connection.py | 39 ++++++++++++++++++++-------------------
 redis/sentinel.py   | 22 ++++++++++++----------
 2 files changed, 32 insertions(+), 29 deletions(-)

diff --git a/redis/connection.py b/redis/connection.py
index b08aee9cd5..22d3902995 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -958,7 +958,18 @@ def to_bool(value):
 
 
 class ConnectionPool(object):
-    "Generic connection pool"
+    """
+    Create a connection pool. ``If max_connections`` is set, then this
+    object raises :py:class:`~redis.ConnectionError` when the pool's
+    limit is reached.
+
+    By default, TCP connections are created unless ``connection_class``
+    is specified. Use :py:class:`~redis.UnixDomainSocketConnection` for
+    unix sockets.
+
+    Any additional keyword arguments are passed to the constructor of
+    ``connection_class``.
+    """
     @classmethod
     def from_url(cls, url, db=None, decode_components=False, **kwargs):
         """
@@ -972,10 +983,10 @@ def from_url(cls, url, db=None, decode_components=False, **kwargs):
 
         Three URL schemes are supported:
 
-        - ```redis://``
+        - `redis://
           <https://www.iana.org/assignments/uri-schemes/prov/redis>`_ creates a
           normal TCP socket connection
-        - ```rediss://``
+        - `rediss://
           <https://www.iana.org/assignments/uri-schemes/prov/rediss>`_ creates
           a SSL wrapped TCP socket connection
         - ``unix://`` creates a Unix Domain Socket connection
@@ -1084,16 +1095,6 @@ def from_url(cls, url, db=None, decode_components=False, **kwargs):
 
     def __init__(self, connection_class=Connection, max_connections=None,
                  **connection_kwargs):
-        """
-        Create a connection pool. If max_connections is set, then this
-        object raises redis.ConnectionError when the pool's limit is reached.
-
-        By default, TCP connections are created unless connection_class is
-        specified. Use redis.UnixDomainSocketConnection for unix sockets.
-
-        Any additional keyword arguments are passed to the constructor of
-        connection_class.
-        """
         max_connections = max_connections or 2 ** 31
         if not isinstance(max_connections, (int, long)) or max_connections < 0:
             raise ValueError('"max_connections" must be a positive integer')
@@ -1291,14 +1292,14 @@ class BlockingConnectionPool(ConnectionPool):
         >>> client = Redis(connection_pool=BlockingConnectionPool())
 
     It performs the same function as the default
-    ``:py:class: ~redis.connection.ConnectionPool`` implementation, in that,
+    :py:class:`~redis.ConnectionPool` implementation, in that,
     it maintains a pool of reusable connections that can be shared by
     multiple redis clients (safely across threads if required).
 
     The difference is that, in the event that a client tries to get a
     connection from the pool when all of connections are in use, rather than
-    raising a ``:py:class: ~redis.exceptions.ConnectionError`` (as the default
-    ``:py:class: ~redis.connection.ConnectionPool`` implementation does), it
+    raising a :py:class:`~redis.ConnectionError` (as the default
+    :py:class:`~redis.ConnectionPool` implementation does), it
     makes the client wait ("blocks") for a specified number of seconds until
     a connection becomes available.
 
@@ -1309,11 +1310,11 @@ class BlockingConnectionPool(ConnectionPool):
     Use ``timeout`` to tell it either how many seconds to wait for a connection
     to become available, or to block forever:
 
-        # Block forever.
+        >>> # Block forever.
         >>> pool = BlockingConnectionPool(timeout=None)
 
-        # Raise a ``ConnectionError`` after five seconds if a connection is
-        # not available.
+        >>> # Raise a ``ConnectionError`` after five seconds if a connection is
+        >>> # not available.
         >>> pool = BlockingConnectionPool(timeout=5)
     """
     def __init__(self, max_connections=50, timeout=20,
diff --git a/redis/sentinel.py b/redis/sentinel.py
index 2b212ea8bf..203c859bcc 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -244,18 +244,20 @@ def master_for(self, service_name, redis_class=Redis,
         """
         Returns a redis client instance for the ``service_name`` master.
 
-        A SentinelConnectionPool class is used to retrive the master's
-        address before establishing a new connection.
+        A :py:class:`~redis.sentinel.SentinelConnectionPool` class is
+        used to retrive the master's address before establishing a new
+        connection.
 
         NOTE: If the master's address has changed, any cached connections to
         the old master are closed.
 
-        By default clients will be a redis.Redis instance. Specify a
-        different class to the ``redis_class`` argument if you desire
-        something different.
+        By default clients will be a :py:class:`~redis.Redis` instance.
+        Specify a different class to the ``redis_class`` argument if you
+        desire something different.
 
-        The ``connection_pool_class`` specifies the connection pool to use.
-        The SentinelConnectionPool will be used by default.
+        The ``connection_pool_class`` specifies the connection pool to
+        use.  The :py:class:`~redis.sentinel.SentinelConnectionPool`
+        will be used by default.
 
         All other keyword arguments are merged with any connection_kwargs
         passed to this class and passed to the connection pool as keyword
@@ -275,9 +277,9 @@ def slave_for(self, service_name, redis_class=Redis,
         A SentinelConnectionPool class is used to retrive the slave's
         address before establishing a new connection.
 
-        By default clients will be a redis.Redis instance. Specify a
-        different class to the ``redis_class`` argument if you desire
-        something different.
+        By default clients will be a :py:class:`~redis.Redis` instance.
+        Specify a different class to the ``redis_class`` argument if you
+        desire something different.
 
         The ``connection_pool_class`` specifies the connection pool to use.
         The SentinelConnectionPool will be used by default.

From 8c5a41baf0bd2a1388d601e5b49d06b91997ccb8 Mon Sep 17 00:00:00 2001
From: Jon Dufresne <jon.dufresne@gmail.com>
Date: Thu, 6 Aug 2020 15:15:02 -0700
Subject: [PATCH 0081/1164] Remove support for end-of-life Python 2.7 (#1318)

Remove support for end-of-life Python 2.7

Python 2.7 is end of life. It is no longer receiving bug fixes,
including for security issues. Python 2.7 went EOL on 2020-01-01. For
additional details on support Python versions, see:

Supported: https://devguide.python.org/#status-of-python-branches
EOL: https://devguide.python.org/devcycle/#end-of-life-branches

Removing support for EOL Pythons will reduce testing and maintenance
resources while allowing the library to move towards a modern Python 3
style. Python 2.7 users can continue to use the previous version of
redis-py.

Was able to simplify the code:

- Removed redis._compat module
- Removed __future__ imports
- Removed object from class definition (all classes are new style)
- Removed long (Python 3 unified numeric types)
- Removed deprecated __nonzero__ method
- Use simpler Python 3 super() syntax
- Use unified OSError exception
- Use yield from syntax

Co-authored-by: Andy McCurdy <andy@andymccurdy.com>
---
 .dockerignore                          |   2 +
 CHANGES                                |   1 +
 README.rst                             |   2 +-
 benchmarks/base.py                     |   5 +-
 benchmarks/basic_operations.py         |  12 +-
 benchmarks/command_packer_benchmark.py |   5 +-
 docs/conf.py                           |  26 +-
 redis/_compat.py                       | 188 -----------
 redis/client.py                        | 420 ++++++++++++-------------
 redis/connection.py                    | 129 +++-----
 redis/lock.py                          |  10 +-
 redis/sentinel.py                      |  20 +-
 redis/utils.py                         |  15 +-
 setup.cfg                              |   8 +-
 tests/conftest.py                      |   8 +-
 tests/test_commands.py                 |  38 ++-
 tests/test_connection.py               |   2 +-
 tests/test_connection_pool.py          |  20 +-
 tests/test_encoding.py                 |  31 +-
 tests/test_lock.py                     |   6 +-
 tests/test_monitor.py                  |   8 +-
 tests/test_multiprocessing.py          |   2 +-
 tests/test_pipeline.py                 |  27 +-
 tests/test_pubsub.py                   |  36 +--
 tests/test_scripting.py                |   3 +-
 tests/test_sentinel.py                 |   5 +-
 tox.ini                                |   3 +-
 27 files changed, 378 insertions(+), 654 deletions(-)
 delete mode 100644 redis/_compat.py

diff --git a/.dockerignore b/.dockerignore
index 08ea4a6294..7b9bc9b2df 100644
--- a/.dockerignore
+++ b/.dockerignore
@@ -1,3 +1,5 @@
 **/__pycache__
 **/*.pyc
 .tox
+.coverage
+.coverage.*
diff --git a/CHANGES b/CHANGES
index 2988fde6a5..b164991b8f 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,4 +1,5 @@
 * (in development)
+    * Removed support for end of life Python 2.7.
     * Provide a development and testing environment via docker. Thanks
       @abrookins. #1365
     * Added support for the LPOS command available in Redis 6.0.6. Thanks
diff --git a/README.rst b/README.rst
index 4f2cec840b..438e33e513 100644
--- a/README.rst
+++ b/README.rst
@@ -87,7 +87,7 @@ provide an upgrade path for users migrating from 2.X to 3.0.
 Python Version Support
 ^^^^^^^^^^^^^^^^^^^^^^
 
-redis-py 3.0 supports Python 2.7 and Python 3.5+.
+redis-py supports Python 3.5+.
 
 
 Client Classes: Redis and StrictRedis
diff --git a/benchmarks/base.py b/benchmarks/base.py
index 44e93414ff..8c13afe34d 100644
--- a/benchmarks/base.py
+++ b/benchmarks/base.py
@@ -3,10 +3,9 @@
 import redis
 import sys
 import timeit
-from redis._compat import izip
 
 
-class Benchmark(object):
+class Benchmark:
     ARGUMENTS = ()
 
     def __init__(self):
@@ -34,7 +33,7 @@ def run_benchmark(self):
         group_names = [group['name'] for group in self.ARGUMENTS]
         group_values = [group['values'] for group in self.ARGUMENTS]
         for value_set in itertools.product(*group_values):
-            pairs = list(izip(group_names, value_set))
+            pairs = list(zip(group_names, value_set))
             arg_string = ', '.join(['%s=%s' % (p[0], p[1]) for p in pairs])
             sys.stdout.write('Benchmark: %s... ' % arg_string)
             sys.stdout.flush()
diff --git a/benchmarks/basic_operations.py b/benchmarks/basic_operations.py
index a4b675d7ba..9446343251 100644
--- a/benchmarks/basic_operations.py
+++ b/benchmarks/basic_operations.py
@@ -1,13 +1,8 @@
-from __future__ import print_function
 import redis
 import time
-import sys
 from functools import wraps
 from argparse import ArgumentParser
 
-if sys.version_info[0] == 3:
-    long = int
-
 
 def parse_args():
     parser = ArgumentParser()
@@ -47,9 +42,9 @@ def run():
 def timer(func):
     @wraps(func)
     def wrapper(*args, **kwargs):
-        start = time.clock()
+        start = time.monotonic()
         ret = func(*args, **kwargs)
-        duration = time.clock() - start
+        duration = time.monotonic() - start
         if 'num' in kwargs:
             count = kwargs['num']
         else:
@@ -57,7 +52,7 @@ def wrapper(*args, **kwargs):
         print('{} - {} Requests'.format(func.__name__, count))
         print('Duration  = {}'.format(duration))
         print('Rate = {}'.format(count/duration))
-        print('')
+        print()
         return ret
     return wrapper
 
@@ -185,7 +180,6 @@ def hmset(conn, num, pipeline_size, data_size):
 
     set_data = {'str_value': 'string',
                 'int_value': 123456,
-                'long_value': long(123456),
                 'float_value': 123456.0}
     for i in range(num):
         conn.hmset('hmset_key', set_data)
diff --git a/benchmarks/command_packer_benchmark.py b/benchmarks/command_packer_benchmark.py
index 1216df6775..823a8c8469 100644
--- a/benchmarks/command_packer_benchmark.py
+++ b/benchmarks/command_packer_benchmark.py
@@ -1,7 +1,6 @@
 import socket
 from redis.connection import (Connection, SYM_STAR, SYM_DOLLAR, SYM_EMPTY,
                               SYM_CRLF)
-from redis._compat import imap
 from base import Benchmark
 
 
@@ -29,7 +28,7 @@ def pack_command(self, *args):
         args_output = SYM_EMPTY.join([
             SYM_EMPTY.join(
                 (SYM_DOLLAR, str(len(k)).encode(), SYM_CRLF, k, SYM_CRLF))
-            for k in imap(self.encoder.encode, args)])
+            for k in map(self.encoder.encode, args)])
         output = SYM_EMPTY.join(
             (SYM_STAR, str(len(args)).encode(), SYM_CRLF, args_output))
         return output
@@ -61,7 +60,7 @@ def pack_command(self, *args):
         buff = SYM_EMPTY.join(
             (SYM_STAR, str(len(args)).encode(), SYM_CRLF))
 
-        for k in imap(self.encoder.encode, args):
+        for k in map(self.encoder.encode, args):
             if len(buff) > 6000 or len(k) > 6000:
                 buff = SYM_EMPTY.join(
                     (buff, SYM_DOLLAR, str(len(k)).encode(), SYM_CRLF))
diff --git a/docs/conf.py b/docs/conf.py
index 690be037db..3eb3f33ef2 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-#
 # redis-py documentation build configuration file, created by
 # sphinx-quickstart on Fri Feb  8 00:47:08 2013.
 #
@@ -43,8 +41,8 @@
 master_doc = 'index'
 
 # General information about the project.
-project = u'redis-py'
-copyright = u'2016, Andy McCurdy'
+project = 'redis-py'
+copyright = '2016, Andy McCurdy'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
@@ -188,8 +186,8 @@
 # (source start file, target name, title, author, documentclass
 # [howto/manual]).
 latex_documents = [
-    ('index', 'redis-py.tex', u'redis-py Documentation',
-     u'Andy McCurdy', 'manual'),
+    ('index', 'redis-py.tex', 'redis-py Documentation',
+     'Andy McCurdy', 'manual'),
 ]
 
 # The name of an image file (relative to this directory) to place at the top of
@@ -218,8 +216,8 @@
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
 man_pages = [
-    ('index', 'redis-py', u'redis-py Documentation',
-     [u'Andy McCurdy'], 1)
+    ('index', 'redis-py', 'redis-py Documentation',
+     ['Andy McCurdy'], 1)
 ]
 
 # If true, show URL addresses after external links.
@@ -232,8 +230,8 @@
 # (source start file, target name, title, author,
 #  dir menu entry, description, category)
 texinfo_documents = [
-    ('index', 'redis-py', u'redis-py Documentation',
-     u'Andy McCurdy', 'redis-py',
+    ('index', 'redis-py', 'redis-py Documentation',
+     'Andy McCurdy', 'redis-py',
      'One line description of project.', 'Miscellaneous'),
 ]
 
@@ -246,7 +244,7 @@
 # How to display URL addresses: 'footnote', 'no', or 'inline'.
 #texinfo_show_urls = 'footnote'
 
-epub_title = u'redis-py'
-epub_author = u'Andy McCurdy'
-epub_publisher = u'Andy McCurdy'
-epub_copyright = u'2011, Andy McCurdy'
+epub_title = 'redis-py'
+epub_author = 'Andy McCurdy'
+epub_publisher = 'Andy McCurdy'
+epub_copyright = '2011, Andy McCurdy'
diff --git a/redis/_compat.py b/redis/_compat.py
deleted file mode 100644
index a0036de31e..0000000000
--- a/redis/_compat.py
+++ /dev/null
@@ -1,188 +0,0 @@
-"""Internal module for Python 2 backwards compatibility."""
-# flake8: noqa
-import errno
-import socket
-import sys
-
-
-def sendall(sock, *args, **kwargs):
-    return sock.sendall(*args, **kwargs)
-
-
-def shutdown(sock, *args, **kwargs):
-    return sock.shutdown(*args, **kwargs)
-
-
-def ssl_wrap_socket(context, sock, *args, **kwargs):
-    return context.wrap_socket(sock, *args, **kwargs)
-
-
-# For Python older than 3.5, retry EINTR.
-if sys.version_info[0] < 3 or (sys.version_info[0] == 3 and
-                               sys.version_info[1] < 5):
-    # Adapted from https://bugs.python.org/review/23863/patch/14532/54418
-    import time
-
-    # Wrapper for handling interruptable system calls.
-    def _retryable_call(s, func, *args, **kwargs):
-        # Some modules (SSL) use the _fileobject wrapper directly and
-        # implement a smaller portion of the socket interface, thus we
-        # need to let them continue to do so.
-        timeout, deadline = None, 0.0
-        attempted = False
-        try:
-            timeout = s.gettimeout()
-        except AttributeError:
-            pass
-
-        if timeout:
-            deadline = time.time() + timeout
-
-        try:
-            while True:
-                if attempted and timeout:
-                    now = time.time()
-                    if now >= deadline:
-                        raise socket.error(errno.EWOULDBLOCK, "timed out")
-                    else:
-                        # Overwrite the timeout on the socket object
-                        # to take into account elapsed time.
-                        s.settimeout(deadline - now)
-                try:
-                    attempted = True
-                    return func(*args, **kwargs)
-                except socket.error as e:
-                    if e.args[0] == errno.EINTR:
-                        continue
-                    raise
-        finally:
-            # Set the existing timeout back for future
-            # calls.
-            if timeout:
-                s.settimeout(timeout)
-
-    def recv(sock, *args, **kwargs):
-        return _retryable_call(sock, sock.recv, *args, **kwargs)
-
-    def recv_into(sock, *args, **kwargs):
-        return _retryable_call(sock, sock.recv_into, *args, **kwargs)
-
-else:  # Python 3.5 and above automatically retry EINTR
-    def recv(sock, *args, **kwargs):
-        return sock.recv(*args, **kwargs)
-
-    def recv_into(sock, *args, **kwargs):
-        return sock.recv_into(*args, **kwargs)
-
-if sys.version_info[0] < 3:
-    # In Python 3, the ssl module raises socket.timeout whereas it raises
-    # SSLError in Python 2. For compatibility between versions, ensure
-    # socket.timeout is raised for both.
-    import functools
-
-    try:
-        from ssl import SSLError as _SSLError
-    except ImportError:
-        class _SSLError(Exception):
-            """A replacement in case ssl.SSLError is not available."""
-            pass
-
-    _EXPECTED_SSL_TIMEOUT_MESSAGES = (
-        "The handshake operation timed out",
-        "The read operation timed out",
-        "The write operation timed out",
-    )
-
-    def _handle_ssl_timeout(func):
-        @functools.wraps(func)
-        def wrapper(*args, **kwargs):
-            try:
-                return func(*args, **kwargs)
-            except _SSLError as e:
-                message = len(e.args) == 1 and unicode(e.args[0]) or ''
-                if any(x in message for x in _EXPECTED_SSL_TIMEOUT_MESSAGES):
-                    # Raise socket.timeout for compatibility with Python 3.
-                    raise socket.timeout(*e.args)
-                raise
-        return wrapper
-
-    recv = _handle_ssl_timeout(recv)
-    recv_into = _handle_ssl_timeout(recv_into)
-    sendall = _handle_ssl_timeout(sendall)
-    shutdown = _handle_ssl_timeout(shutdown)
-    ssl_wrap_socket = _handle_ssl_timeout(ssl_wrap_socket)
-
-if sys.version_info[0] < 3:
-    from urllib import unquote
-    from urlparse import parse_qs, urlparse
-    from itertools import imap, izip
-    from string import letters as ascii_letters
-    from Queue import Queue
-
-    # special unicode handling for python2 to avoid UnicodeDecodeError
-    def safe_unicode(obj, *args):
-        """ return the unicode representation of obj """
-        try:
-            return unicode(obj, *args)
-        except UnicodeDecodeError:
-            # obj is byte string
-            ascii_text = str(obj).encode('string_escape')
-            return unicode(ascii_text)
-
-    def iteritems(x):
-        return x.iteritems()
-
-    def iterkeys(x):
-        return x.iterkeys()
-
-    def itervalues(x):
-        return x.itervalues()
-
-    def nativestr(x):
-        return x if isinstance(x, str) else x.encode('utf-8', 'replace')
-
-    def next(x):
-        return x.next()
-
-    unichr = unichr
-    xrange = xrange
-    basestring = basestring
-    unicode = unicode
-    long = long
-    BlockingIOError = socket.error
-else:
-    from urllib.parse import parse_qs, unquote, urlparse
-    from string import ascii_letters
-    from queue import Queue
-
-    def iteritems(x):
-        return iter(x.items())
-
-    def iterkeys(x):
-        return iter(x.keys())
-
-    def itervalues(x):
-        return iter(x.values())
-
-    def nativestr(x):
-        return x if isinstance(x, str) else x.decode('utf-8', 'replace')
-
-    def safe_unicode(value):
-        if isinstance(value, bytes):
-            value = value.decode('utf-8', 'replace')
-        return str(value)
-
-    next = next
-    unichr = chr
-    imap = map
-    izip = zip
-    xrange = range
-    basestring = str
-    unicode = str
-    long = int
-    BlockingIOError = BlockingIOError
-
-try:  # Python 3
-    from queue import LifoQueue, Empty, Full
-except ImportError:  # Python 2
-    from Queue import LifoQueue, Empty, Full
diff --git a/redis/client.py b/redis/client.py
index 5c95e9fa65..881fd65bd1 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1,4 +1,3 @@
-from __future__ import unicode_literals
 from itertools import chain
 import datetime
 import warnings
@@ -7,8 +6,6 @@
 import time as mod_time
 import re
 import hashlib
-from redis._compat import (basestring, imap, iteritems, iterkeys,
-                           itervalues, izip, long, nativestr, safe_unicode)
 from redis.connection import (ConnectionPool, UnixDomainSocketConnection,
                               SSLConnection)
 from redis.lock import Lock
@@ -24,6 +21,7 @@
     WatchError,
     ModuleError,
 )
+from redis.utils import safe_str, str_if_bytes
 
 SYM_EMPTY = b''
 EMPTY_RESPONSE = 'EMPTY_RESPONSE'
@@ -35,7 +33,7 @@ def list_or_args(keys, args):
         iter(keys)
         # a string or bytes instance can be iterated, but indicates
         # keys wasn't passed as a list
-        if isinstance(keys, (basestring, bytes)):
+        if isinstance(keys, (bytes, str)):
             keys = [keys]
         else:
             keys = list(keys)
@@ -61,45 +59,38 @@ def string_keys_to_dict(key_string, callback):
     return dict.fromkeys(key_string.split(), callback)
 
 
-def dict_merge(*dicts):
-    merged = {}
-    for d in dicts:
-        merged.update(d)
-    return merged
-
-
 class CaseInsensitiveDict(dict):
     "Case insensitive dict implementation. Assumes string keys only."
 
     def __init__(self, data):
-        for k, v in iteritems(data):
+        for k, v in data.items():
             self[k.upper()] = v
 
     def __contains__(self, k):
-        return super(CaseInsensitiveDict, self).__contains__(k.upper())
+        return super().__contains__(k.upper())
 
     def __delitem__(self, k):
-        super(CaseInsensitiveDict, self).__delitem__(k.upper())
+        super().__delitem__(k.upper())
 
     def __getitem__(self, k):
-        return super(CaseInsensitiveDict, self).__getitem__(k.upper())
+        return super().__getitem__(k.upper())
 
     def get(self, k, default=None):
-        return super(CaseInsensitiveDict, self).get(k.upper(), default)
+        return super().get(k.upper(), default)
 
     def __setitem__(self, k, v):
-        super(CaseInsensitiveDict, self).__setitem__(k.upper(), v)
+        super().__setitem__(k.upper(), v)
 
     def update(self, data):
         data = CaseInsensitiveDict(data)
-        super(CaseInsensitiveDict, self).update(data)
+        super().update(data)
 
 
 def parse_debug_object(response):
     "Parse the results of Redis's DEBUG OBJECT command into a Python dict"
     # The 'type' of the object is the first item in the response, but isn't
     # prefixed with a name
-    response = nativestr(response)
+    response = str_if_bytes(response)
     response = 'type:' + response
     response = dict(kv.split(':') for kv in response.split())
 
@@ -123,7 +114,7 @@ def parse_object(response, infotype):
 def parse_info(response):
     "Parse the result of Redis's INFO command into a Python dict"
     info = {}
-    response = nativestr(response)
+    response = str_if_bytes(response)
 
     def get_value(value):
         if ',' not in value or '=' not in value:
@@ -163,7 +154,7 @@ def parse_memory_stats(response, **kwargs):
     stats = pairs_to_dict(response,
                           decode_keys=True,
                           decode_string_values=True)
-    for key, value in iteritems(stats):
+    for key, value in stats.items():
         if key.startswith('db.'):
             stats[key] = pairs_to_dict(value,
                                        decode_keys=True,
@@ -211,52 +202,48 @@ def parse_sentinel_state(item):
 
 
 def parse_sentinel_master(response):
-    return parse_sentinel_state(imap(nativestr, response))
+    return parse_sentinel_state(map(str_if_bytes, response))
 
 
 def parse_sentinel_masters(response):
     result = {}
     for item in response:
-        state = parse_sentinel_state(imap(nativestr, item))
+        state = parse_sentinel_state(map(str_if_bytes, item))
         result[state['name']] = state
     return result
 
 
 def parse_sentinel_slaves_and_sentinels(response):
-    return [parse_sentinel_state(imap(nativestr, item)) for item in response]
+    return [parse_sentinel_state(map(str_if_bytes, item)) for item in response]
 
 
 def parse_sentinel_get_master(response):
     return response and (response[0], int(response[1])) or None
 
 
-def nativestr_if_bytes(value):
-    return nativestr(value) if isinstance(value, bytes) else value
-
-
 def pairs_to_dict(response, decode_keys=False, decode_string_values=False):
     "Create a dict given a list of key/value pairs"
     if response is None:
         return {}
     if decode_keys or decode_string_values:
         # the iter form is faster, but I don't know how to make that work
-        # with a nativestr() map
+        # with a str_if_bytes() map
         keys = response[::2]
         if decode_keys:
-            keys = imap(nativestr, keys)
+            keys = map(str_if_bytes, keys)
         values = response[1::2]
         if decode_string_values:
-            values = imap(nativestr_if_bytes, values)
-        return dict(izip(keys, values))
+            values = map(str_if_bytes, values)
+        return dict(zip(keys, values))
     else:
         it = iter(response)
-        return dict(izip(it, it))
+        return dict(zip(it, it))
 
 
 def pairs_to_dict_typed(response, type_info):
     it = iter(response)
     result = {}
-    for key, value in izip(it, it):
+    for key, value in zip(it, it):
         if key in type_info:
             try:
                 value = type_info[key](value)
@@ -277,7 +264,7 @@ def zset_score_pairs(response, **options):
         return response
     score_cast_func = options.get('score_cast_func', float)
     it = iter(response)
-    return list(izip(it, imap(score_cast_func, it)))
+    return list(zip(it, map(score_cast_func, it)))
 
 
 def sort_return_tuples(response, **options):
@@ -288,7 +275,7 @@ def sort_return_tuples(response, **options):
     if not response or not options.get('groups'):
         return response
     n = options['groups']
-    return list(izip(*[response[i::n] for i in range(n)]))
+    return list(zip(*[response[i::n] for i in range(n)]))
 
 
 def int_or_none(response):
@@ -297,12 +284,6 @@ def int_or_none(response):
     return int(response)
 
 
-def nativestr_or_none(response):
-    if response is None:
-        return None
-    return nativestr(response)
-
-
 def parse_stream_list(response):
     if response is None:
         return None
@@ -315,12 +296,12 @@ def parse_stream_list(response):
     return data
 
 
-def pairs_to_dict_with_nativestr_keys(response):
+def pairs_to_dict_with_str_keys(response):
     return pairs_to_dict(response, decode_keys=True)
 
 
 def parse_list_of_dicts(response):
-    return list(imap(pairs_to_dict_with_nativestr_keys, response))
+    return list(map(pairs_to_dict_with_str_keys, response))
 
 
 def parse_xclaim(response, **options):
@@ -349,7 +330,7 @@ def parse_xread(response):
 def parse_xpending(response, **options):
     if options.get('parse_detail', False):
         return parse_xpending_range(response)
-    consumers = [{'name': n, 'pending': long(p)} for n, p in response[3] or []]
+    consumers = [{'name': n, 'pending': int(p)} for n, p in response[3] or []]
     return {
         'pending': response[0],
         'min': response[1],
@@ -360,7 +341,7 @@ def parse_xpending(response, **options):
 
 def parse_xpending_range(response):
     k = ('message_id', 'consumer', 'time_since_delivered', 'times_delivered')
-    return [dict(izip(k, r)) for r in response]
+    return [dict(zip(k, r)) for r in response]
 
 
 def float_or_none(response):
@@ -370,7 +351,7 @@ def float_or_none(response):
 
 
 def bool_ok(response):
-    return nativestr(response) == 'OK'
+    return str_if_bytes(response) == 'OK'
 
 
 def parse_zadd(response, **options):
@@ -383,32 +364,32 @@ def parse_zadd(response, **options):
 
 def parse_client_list(response, **options):
     clients = []
-    for c in nativestr(response).splitlines():
+    for c in str_if_bytes(response).splitlines():
         # Values might contain '='
         clients.append(dict(pair.split('=', 1) for pair in c.split(' ')))
     return clients
 
 
 def parse_config_get(response, **options):
-    response = [nativestr(i) if i is not None else None for i in response]
+    response = [str_if_bytes(i) if i is not None else None for i in response]
     return response and pairs_to_dict(response) or {}
 
 
 def parse_scan(response, **options):
     cursor, r = response
-    return long(cursor), r
+    return int(cursor), r
 
 
 def parse_hscan(response, **options):
     cursor, r = response
-    return long(cursor), r and pairs_to_dict(r) or {}
+    return int(cursor), r and pairs_to_dict(r) or {}
 
 
 def parse_zscan(response, **options):
     score_cast_func = options.get('score_cast_func', float)
     cursor, r = response
     it = iter(r)
-    return long(cursor), list(izip(it, imap(score_cast_func, it)))
+    return int(cursor), list(zip(it, map(score_cast_func, it)))
 
 
 def parse_slowlog_get(response, **options):
@@ -422,7 +403,7 @@ def parse_slowlog_get(response, **options):
 
 
 def parse_cluster_info(response, **options):
-    response = nativestr(response)
+    response = str_if_bytes(response)
     return dict(line.split(':') for line in response.splitlines() if line)
 
 
@@ -445,10 +426,7 @@ def _parse_node_line(line):
 
 
 def parse_cluster_nodes(response, **options):
-    response = nativestr(response)
-    raw_lines = response
-    if isinstance(response, basestring):
-        raw_lines = response.splitlines()
+    raw_lines = str_if_bytes(response).splitlines()
     return dict(_parse_node_line(line) for line in raw_lines)
 
 
@@ -488,9 +466,9 @@ def parse_pubsub_numsub(response, **options):
 
 
 def parse_client_kill(response, **options):
-    if isinstance(response, (long, int)):
-        return int(response)
-    return nativestr(response) == 'OK'
+    if isinstance(response, int):
+        return response
+    return str_if_bytes(response) == 'OK'
 
 
 def parse_acl_getuser(response, **options):
@@ -499,9 +477,9 @@ def parse_acl_getuser(response, **options):
     data = pairs_to_dict(response, decode_keys=True)
 
     # convert everything but user-defined data in 'keys' to native strings
-    data['flags'] = list(map(nativestr, data['flags']))
-    data['passwords'] = list(map(nativestr, data['passwords']))
-    data['commands'] = nativestr(data['commands'])
+    data['flags'] = list(map(str_if_bytes, data['flags']))
+    data['passwords'] = list(map(str_if_bytes, data['passwords']))
+    data['commands'] = str_if_bytes(data['commands'])
 
     # split 'commands' into separate 'categories' and 'commands' lists
     commands, categories = [], []
@@ -523,7 +501,7 @@ def parse_module_result(response):
     return True
 
 
-class Redis(object):
+class Redis:
     """
     Implementation of the Redis protocol.
 
@@ -533,13 +511,13 @@ class Redis(object):
     Connection and Pipeline derive from this, implementing how
     the commands are sent and received to the Redis server
     """
-    RESPONSE_CALLBACKS = dict_merge(
-        string_keys_to_dict(
+    RESPONSE_CALLBACKS = {
+        **string_keys_to_dict(
             'AUTH EXPIRE EXPIREAT HEXISTS HMSET MOVE MSETNX PERSIST '
             'PSETEX RENAMENX SISMEMBER SMOVE SETEX SETNX',
             bool
         ),
-        string_keys_to_dict(
+        **string_keys_to_dict(
             'BITCOUNT BITPOS DECRBY DEL EXISTS GEOADD GETBIT HDEL HLEN '
             'HSTRLEN INCRBY LINSERT LLEN LPUSHX PFADD PFCOUNT RPUSHX SADD '
             'SCARD SDIFFSTORE SETBIT SETRANGE SINTERSTORE SREM STRLEN '
@@ -547,128 +525,126 @@ class Redis(object):
             'ZREMRANGEBYLEX ZREMRANGEBYRANK ZREMRANGEBYSCORE',
             int
         ),
-        string_keys_to_dict(
+        **string_keys_to_dict(
             'INCRBYFLOAT HINCRBYFLOAT',
             float
         ),
-        string_keys_to_dict(
+        **string_keys_to_dict(
             # these return OK, or int if redis-server is >=1.3.4
             'LPUSH RPUSH',
-            lambda r: isinstance(r, (long, int)) and r or nativestr(r) == 'OK'
+            lambda r: isinstance(r, int) and r or str_if_bytes(r) == 'OK'
         ),
-        string_keys_to_dict('SORT', sort_return_tuples),
-        string_keys_to_dict('ZSCORE ZINCRBY GEODIST', float_or_none),
-        string_keys_to_dict(
+        **string_keys_to_dict('SORT', sort_return_tuples),
+        **string_keys_to_dict('ZSCORE ZINCRBY GEODIST', float_or_none),
+        **string_keys_to_dict(
             'FLUSHALL FLUSHDB LSET LTRIM MSET PFMERGE READONLY READWRITE '
             'RENAME SAVE SELECT SHUTDOWN SLAVEOF SWAPDB WATCH UNWATCH ',
             bool_ok
         ),
-        string_keys_to_dict('BLPOP BRPOP', lambda r: r and tuple(r) or None),
-        string_keys_to_dict(
+        **string_keys_to_dict('BLPOP BRPOP', lambda r: r and tuple(r) or None),
+        **string_keys_to_dict(
             'SDIFF SINTER SMEMBERS SUNION',
             lambda r: r and set(r) or set()
         ),
-        string_keys_to_dict(
+        **string_keys_to_dict(
             'ZPOPMAX ZPOPMIN ZRANGE ZRANGEBYSCORE ZREVRANGE ZREVRANGEBYSCORE',
             zset_score_pairs
         ),
-        string_keys_to_dict('BZPOPMIN BZPOPMAX', \
-                            lambda r: r and (r[0], r[1], float(r[2])) or None),
-        string_keys_to_dict('ZRANK ZREVRANK', int_or_none),
-        string_keys_to_dict('XREVRANGE XRANGE', parse_stream_list),
-        string_keys_to_dict('XREAD XREADGROUP', parse_xread),
-        string_keys_to_dict('BGREWRITEAOF BGSAVE', lambda r: True),
-        {
-            'ACL CAT': lambda r: list(map(nativestr, r)),
-            'ACL DELUSER': int,
-            'ACL GENPASS': nativestr,
-            'ACL GETUSER': parse_acl_getuser,
-            'ACL LIST': lambda r: list(map(nativestr, r)),
-            'ACL LOAD': bool_ok,
-            'ACL SAVE': bool_ok,
-            'ACL SETUSER': bool_ok,
-            'ACL USERS': lambda r: list(map(nativestr, r)),
-            'ACL WHOAMI': nativestr,
-            'CLIENT GETNAME': lambda r: r and nativestr(r),
-            'CLIENT ID': int,
-            'CLIENT KILL': parse_client_kill,
-            'CLIENT LIST': parse_client_list,
-            'CLIENT SETNAME': bool_ok,
-            'CLIENT UNBLOCK': lambda r: r and int(r) == 1 or False,
-            'CLIENT PAUSE': bool_ok,
-            'CLUSTER ADDSLOTS': bool_ok,
-            'CLUSTER COUNT-FAILURE-REPORTS': lambda x: int(x),
-            'CLUSTER COUNTKEYSINSLOT': lambda x: int(x),
-            'CLUSTER DELSLOTS': bool_ok,
-            'CLUSTER FAILOVER': bool_ok,
-            'CLUSTER FORGET': bool_ok,
-            'CLUSTER INFO': parse_cluster_info,
-            'CLUSTER KEYSLOT': lambda x: int(x),
-            'CLUSTER MEET': bool_ok,
-            'CLUSTER NODES': parse_cluster_nodes,
-            'CLUSTER REPLICATE': bool_ok,
-            'CLUSTER RESET': bool_ok,
-            'CLUSTER SAVECONFIG': bool_ok,
-            'CLUSTER SET-CONFIG-EPOCH': bool_ok,
-            'CLUSTER SETSLOT': bool_ok,
-            'CLUSTER SLAVES': parse_cluster_nodes,
-            'CONFIG GET': parse_config_get,
-            'CONFIG RESETSTAT': bool_ok,
-            'CONFIG SET': bool_ok,
-            'DEBUG OBJECT': parse_debug_object,
-            'GEOHASH': lambda r: list(map(nativestr_or_none, r)),
-            'GEOPOS': lambda r: list(map(lambda ll: (float(ll[0]),
-                                         float(ll[1]))
-                                         if ll is not None else None, r)),
-            'GEORADIUS': parse_georadius_generic,
-            'GEORADIUSBYMEMBER': parse_georadius_generic,
-            'HGETALL': lambda r: r and pairs_to_dict(r) or {},
-            'HSCAN': parse_hscan,
-            'INFO': parse_info,
-            'LASTSAVE': timestamp_to_datetime,
-            'MEMORY PURGE': bool_ok,
-            'MEMORY STATS': parse_memory_stats,
-            'MEMORY USAGE': int_or_none,
-            'OBJECT': parse_object,
-            'PING': lambda r: nativestr(r) == 'PONG',
-            'PUBSUB NUMSUB': parse_pubsub_numsub,
-            'RANDOMKEY': lambda r: r and r or None,
-            'SCAN': parse_scan,
-            'SCRIPT EXISTS': lambda r: list(imap(bool, r)),
-            'SCRIPT FLUSH': bool_ok,
-            'SCRIPT KILL': bool_ok,
-            'SCRIPT LOAD': nativestr,
-            'SENTINEL GET-MASTER-ADDR-BY-NAME': parse_sentinel_get_master,
-            'SENTINEL MASTER': parse_sentinel_master,
-            'SENTINEL MASTERS': parse_sentinel_masters,
-            'SENTINEL MONITOR': bool_ok,
-            'SENTINEL REMOVE': bool_ok,
-            'SENTINEL SENTINELS': parse_sentinel_slaves_and_sentinels,
-            'SENTINEL SET': bool_ok,
-            'SENTINEL SLAVES': parse_sentinel_slaves_and_sentinels,
-            'SET': lambda r: r and nativestr(r) == 'OK',
-            'SLOWLOG GET': parse_slowlog_get,
-            'SLOWLOG LEN': int,
-            'SLOWLOG RESET': bool_ok,
-            'SSCAN': parse_scan,
-            'TIME': lambda x: (int(x[0]), int(x[1])),
-            'XCLAIM': parse_xclaim,
-            'XGROUP CREATE': bool_ok,
-            'XGROUP DELCONSUMER': int,
-            'XGROUP DESTROY': bool,
-            'XGROUP SETID': bool_ok,
-            'XINFO CONSUMERS': parse_list_of_dicts,
-            'XINFO GROUPS': parse_list_of_dicts,
-            'XINFO STREAM': parse_xinfo_stream,
-            'XPENDING': parse_xpending,
-            'ZADD': parse_zadd,
-            'ZSCAN': parse_zscan,
-            'MODULE LOAD': parse_module_result,
-            'MODULE UNLOAD': parse_module_result,
-            'MODULE LIST': lambda response: [pairs_to_dict(module)
-                                             for module in response],
-        }
-    )
+        **string_keys_to_dict('BZPOPMIN BZPOPMAX', \
+                              lambda r:
+                              r and (r[0], r[1], float(r[2])) or None),
+        **string_keys_to_dict('ZRANK ZREVRANK', int_or_none),
+        **string_keys_to_dict('XREVRANGE XRANGE', parse_stream_list),
+        **string_keys_to_dict('XREAD XREADGROUP', parse_xread),
+        **string_keys_to_dict('BGREWRITEAOF BGSAVE', lambda r: True),
+        'ACL CAT': lambda r: list(map(str_if_bytes, r)),
+        'ACL DELUSER': int,
+        'ACL GENPASS': str_if_bytes,
+        'ACL GETUSER': parse_acl_getuser,
+        'ACL LIST': lambda r: list(map(str_if_bytes, r)),
+        'ACL LOAD': bool_ok,
+        'ACL SAVE': bool_ok,
+        'ACL SETUSER': bool_ok,
+        'ACL USERS': lambda r: list(map(str_if_bytes, r)),
+        'ACL WHOAMI': str_if_bytes,
+        'CLIENT GETNAME': str_if_bytes,
+        'CLIENT ID': int,
+        'CLIENT KILL': parse_client_kill,
+        'CLIENT LIST': parse_client_list,
+        'CLIENT SETNAME': bool_ok,
+        'CLIENT UNBLOCK': lambda r: r and int(r) == 1 or False,
+        'CLIENT PAUSE': bool_ok,
+        'CLUSTER ADDSLOTS': bool_ok,
+        'CLUSTER COUNT-FAILURE-REPORTS': lambda x: int(x),
+        'CLUSTER COUNTKEYSINSLOT': lambda x: int(x),
+        'CLUSTER DELSLOTS': bool_ok,
+        'CLUSTER FAILOVER': bool_ok,
+        'CLUSTER FORGET': bool_ok,
+        'CLUSTER INFO': parse_cluster_info,
+        'CLUSTER KEYSLOT': lambda x: int(x),
+        'CLUSTER MEET': bool_ok,
+        'CLUSTER NODES': parse_cluster_nodes,
+        'CLUSTER REPLICATE': bool_ok,
+        'CLUSTER RESET': bool_ok,
+        'CLUSTER SAVECONFIG': bool_ok,
+        'CLUSTER SET-CONFIG-EPOCH': bool_ok,
+        'CLUSTER SETSLOT': bool_ok,
+        'CLUSTER SLAVES': parse_cluster_nodes,
+        'CONFIG GET': parse_config_get,
+        'CONFIG RESETSTAT': bool_ok,
+        'CONFIG SET': bool_ok,
+        'DEBUG OBJECT': parse_debug_object,
+        'GEOHASH': lambda r: list(map(str_if_bytes, r)),
+        'GEOPOS': lambda r: list(map(lambda ll: (float(ll[0]),
+                                     float(ll[1]))
+                                     if ll is not None else None, r)),
+        'GEORADIUS': parse_georadius_generic,
+        'GEORADIUSBYMEMBER': parse_georadius_generic,
+        'HGETALL': lambda r: r and pairs_to_dict(r) or {},
+        'HSCAN': parse_hscan,
+        'INFO': parse_info,
+        'LASTSAVE': timestamp_to_datetime,
+        'MEMORY PURGE': bool_ok,
+        'MEMORY STATS': parse_memory_stats,
+        'MEMORY USAGE': int_or_none,
+        'MODULE LOAD': parse_module_result,
+        'MODULE UNLOAD': parse_module_result,
+        'MODULE LIST': lambda r: [pairs_to_dict(m) for m in r],
+        'OBJECT': parse_object,
+        'PING': lambda r: str_if_bytes(r) == 'PONG',
+        'PUBSUB NUMSUB': parse_pubsub_numsub,
+        'RANDOMKEY': lambda r: r and r or None,
+        'SCAN': parse_scan,
+        'SCRIPT EXISTS': lambda r: list(map(bool, r)),
+        'SCRIPT FLUSH': bool_ok,
+        'SCRIPT KILL': bool_ok,
+        'SCRIPT LOAD': str_if_bytes,
+        'SENTINEL GET-MASTER-ADDR-BY-NAME': parse_sentinel_get_master,
+        'SENTINEL MASTER': parse_sentinel_master,
+        'SENTINEL MASTERS': parse_sentinel_masters,
+        'SENTINEL MONITOR': bool_ok,
+        'SENTINEL REMOVE': bool_ok,
+        'SENTINEL SENTINELS': parse_sentinel_slaves_and_sentinels,
+        'SENTINEL SET': bool_ok,
+        'SENTINEL SLAVES': parse_sentinel_slaves_and_sentinels,
+        'SET': lambda r: r and str_if_bytes(r) == 'OK',
+        'SLOWLOG GET': parse_slowlog_get,
+        'SLOWLOG LEN': int,
+        'SLOWLOG RESET': bool_ok,
+        'SSCAN': parse_scan,
+        'TIME': lambda x: (int(x[0]), int(x[1])),
+        'XCLAIM': parse_xclaim,
+        'XGROUP CREATE': bool_ok,
+        'XGROUP DELCONSUMER': int,
+        'XGROUP DESTROY': bool,
+        'XGROUP SETID': bool_ok,
+        'XINFO CONSUMERS': parse_list_of_dicts,
+        'XINFO GROUPS': parse_list_of_dicts,
+        'XINFO STREAM': parse_xinfo_stream,
+        'XPENDING': parse_xpending,
+        'ZADD': parse_zadd,
+        'ZSCAN': parse_zscan,
+    }
 
     @classmethod
     def from_url(cls, url, db=None, **kwargs):
@@ -1233,7 +1209,7 @@ def client_pause(self, timeout):
         Suspend all the Redis clients for the specified amount of time
         :param timeout: milliseconds to pause clients
         """
-        if not isinstance(timeout, (int, long)):
+        if not isinstance(timeout, int):
             raise DataError("CLIENT PAUSE timeout must be an integer")
         return self.execute_command('CLIENT PAUSE', str(timeout))
 
@@ -1688,7 +1664,7 @@ def mset(self, mapping):
         can be cast to a string via str().
         """
         items = []
-        for pair in iteritems(mapping):
+        for pair in mapping.items():
             items.extend(pair)
         return self.execute_command('MSET', *items)
 
@@ -1700,7 +1676,7 @@ def msetnx(self, mapping):
         Returns a boolean indicating if the operation was successful.
         """
         items = []
-        for pair in iteritems(mapping):
+        for pair in mapping.items():
             items.extend(pair)
         return self.execute_command('MSETNX', *items)
 
@@ -2109,7 +2085,7 @@ def sort(self, name, start=None, num=None, by=None, get=None,
             # Otherwise assume it's an interable and we want to get multiple
             # values. We can't just iterate blindly because strings are
             # iterable.
-            if isinstance(get, (bytes, basestring)):
+            if isinstance(get, (bytes, str)):
                 pieces.append(b'GET')
                 pieces.append(get)
             else:
@@ -2125,7 +2101,7 @@ def sort(self, name, start=None, num=None, by=None, get=None,
             pieces.append(store)
 
         if groups:
-            if not get or isinstance(get, (bytes, basestring)) or len(get) < 2:
+            if not get or isinstance(get, (bytes, str)) or len(get) < 2:
                 raise DataError('when using "groups" the "get" argument '
                                 'must be specified and contain at least '
                                 'two keys')
@@ -2177,8 +2153,7 @@ def scan_iter(self, match=None, count=None, _type=None):
         while cursor != 0:
             cursor, data = self.scan(cursor=cursor, match=match,
                                      count=count, _type=_type)
-            for item in data:
-                yield item
+            yield from data
 
     def sscan(self, name, cursor=0, match=None, count=None):
         """
@@ -2209,8 +2184,7 @@ def sscan_iter(self, name, match=None, count=None):
         while cursor != 0:
             cursor, data = self.sscan(name, cursor=cursor,
                                       match=match, count=count)
-            for item in data:
-                yield item
+            yield from data
 
     def hscan(self, name, cursor=0, match=None, count=None):
         """
@@ -2241,8 +2215,7 @@ def hscan_iter(self, name, match=None, count=None):
         while cursor != 0:
             cursor, data = self.hscan(name, cursor=cursor,
                                       match=match, count=count)
-            for item in data.items():
-                yield item
+            yield from data.items()
 
     def zscan(self, name, cursor=0, match=None, count=None,
               score_cast_func=float):
@@ -2281,8 +2254,7 @@ def zscan_iter(self, name, match=None, count=None,
             cursor, data = self.zscan(name, cursor=cursor, match=match,
                                       count=count,
                                       score_cast_func=score_cast_func)
-            for item in data:
-                yield item
+            yield from data
 
     # SET COMMANDS
     def sadd(self, name, *values):
@@ -2386,7 +2358,7 @@ def xadd(self, name, fields, id='*', maxlen=None, approximate=True):
         """
         pieces = []
         if maxlen is not None:
-            if not isinstance(maxlen, (int, long)) or maxlen < 1:
+            if not isinstance(maxlen, int) or maxlen < 1:
                 raise DataError('XADD maxlen must be a positive integer')
             pieces.append(b'MAXLEN')
             if approximate:
@@ -2395,7 +2367,7 @@ def xadd(self, name, fields, id='*', maxlen=None, approximate=True):
         pieces.append(id)
         if not isinstance(fields, dict) or len(fields) == 0:
             raise DataError('XADD fields must be a non-empty dict')
-        for pair in iteritems(fields):
+        for pair in fields.items():
             pieces.extend(pair)
         return self.execute_command('XADD', name, *pieces)
 
@@ -2424,7 +2396,7 @@ def xclaim(self, name, groupname, consumername, min_idle_time, message_ids,
         justid: optional boolean, false by default. Return just an array of IDs
          of messages successfully claimed, without returning the actual message
         """
-        if not isinstance(min_idle_time, (int, long)) or min_idle_time < 0:
+        if not isinstance(min_idle_time, int) or min_idle_time < 0:
             raise DataError("XCLAIM min_idle_time must be a non negative "
                             "integer")
         if not isinstance(message_ids, (list, tuple)) or not message_ids:
@@ -2436,15 +2408,15 @@ def xclaim(self, name, groupname, consumername, min_idle_time, message_ids,
         pieces.extend(list(message_ids))
 
         if idle is not None:
-            if not isinstance(idle, (int, long)):
+            if not isinstance(idle, int):
                 raise DataError("XCLAIM idle must be an integer")
             pieces.extend((b'IDLE', str(idle)))
         if time is not None:
-            if not isinstance(time, (int, long)):
+            if not isinstance(time, int):
                 raise DataError("XCLAIM time must be an integer")
             pieces.extend((b'TIME', str(time)))
         if retrycount is not None:
-            if not isinstance(retrycount, (int, long)):
+            if not isinstance(retrycount, int):
                 raise DataError("XCLAIM retrycount must be an integer")
             pieces.extend((b'RETRYCOUNT', str(retrycount)))
 
@@ -2560,7 +2532,7 @@ def xpending_range(self, name, groupname, min, max, count,
             if min is None or max is None or count is None:
                 raise DataError("XPENDING must be provided with min, max "
                                 "and count parameters, or none of them. ")
-            if not isinstance(count, (int, long)) or count < -1:
+            if not isinstance(count, int) or count < -1:
                 raise DataError("XPENDING count must be a integer >= -1")
             pieces.extend((min, max, str(count)))
         if consumername is not None:
@@ -2584,7 +2556,7 @@ def xrange(self, name, min='-', max='+', count=None):
         """
         pieces = [min, max]
         if count is not None:
-            if not isinstance(count, (int, long)) or count < 1:
+            if not isinstance(count, int) or count < 1:
                 raise DataError('XRANGE count must be a positive integer')
             pieces.append(b'COUNT')
             pieces.append(str(count))
@@ -2602,19 +2574,19 @@ def xread(self, streams, count=None, block=None):
         """
         pieces = []
         if block is not None:
-            if not isinstance(block, (int, long)) or block < 0:
+            if not isinstance(block, int) or block < 0:
                 raise DataError('XREAD block must be a non-negative integer')
             pieces.append(b'BLOCK')
             pieces.append(str(block))
         if count is not None:
-            if not isinstance(count, (int, long)) or count < 1:
+            if not isinstance(count, int) or count < 1:
                 raise DataError('XREAD count must be a positive integer')
             pieces.append(b'COUNT')
             pieces.append(str(count))
         if not isinstance(streams, dict) or len(streams) == 0:
             raise DataError('XREAD streams must be a non empty dict')
         pieces.append(b'STREAMS')
-        keys, values = izip(*iteritems(streams))
+        keys, values = zip(*streams.items())
         pieces.extend(keys)
         pieces.extend(values)
         return self.execute_command('XREAD', *pieces)
@@ -2634,12 +2606,12 @@ def xreadgroup(self, groupname, consumername, streams, count=None,
         """
         pieces = [b'GROUP', groupname, consumername]
         if count is not None:
-            if not isinstance(count, (int, long)) or count < 1:
+            if not isinstance(count, int) or count < 1:
                 raise DataError("XREADGROUP count must be a positive integer")
             pieces.append(b'COUNT')
             pieces.append(str(count))
         if block is not None:
-            if not isinstance(block, (int, long)) or block < 0:
+            if not isinstance(block, int) or block < 0:
                 raise DataError("XREADGROUP block must be a non-negative "
                                 "integer")
             pieces.append(b'BLOCK')
@@ -2666,7 +2638,7 @@ def xrevrange(self, name, max='+', min='-', count=None):
         """
         pieces = [max, min]
         if count is not None:
-            if not isinstance(count, (int, long)) or count < 1:
+            if not isinstance(count, int) or count < 1:
                 raise DataError('XREVRANGE count must be a positive integer')
             pieces.append(b'COUNT')
             pieces.append(str(count))
@@ -2729,7 +2701,7 @@ def zadd(self, name, mapping, nx=False, xx=False, ch=False, incr=False):
         if incr:
             pieces.append(b'INCR')
             options['as_score'] = True
-        for pair in iteritems(mapping):
+        for pair in mapping.items():
             pieces.append(pair[1])
             pieces.append(pair[0])
         return self.execute_command('ZADD', name, *pieces, **options)
@@ -3015,7 +2987,7 @@ def zunionstore(self, dest, keys, aggregate=None):
     def _zaggregate(self, command, dest, keys, aggregate=None):
         pieces = [command, dest, len(keys)]
         if isinstance(keys, dict):
-            keys, weights = iterkeys(keys), itervalues(keys)
+            keys, weights = keys.keys(), keys.values()
         else:
             weights = None
         pieces.extend(keys)
@@ -3117,7 +3089,7 @@ def hmset(self, name, mapping):
         if not mapping:
             raise DataError("'hmset' with 'mapping' of length 0")
         items = []
-        for pair in iteritems(mapping):
+        for pair in mapping.items():
             items.extend(pair)
         return self.execute_command('HMSET', name, *items)
 
@@ -3379,7 +3351,7 @@ def module_list(self):
 StrictRedis = Redis
 
 
-class Monitor(object):
+class Monitor:
     """
     Monitor is useful for handling the MONITOR command to the redis server.
     next_command() method returns one command from monitor
@@ -3445,7 +3417,7 @@ def listen(self):
             yield self.next_command()
 
 
-class PubSub(object):
+class PubSub:
     """
     PubSub provides publish, subscribe and listen support to Redis channels.
 
@@ -3513,12 +3485,12 @@ def on_connect(self, connection):
         self.pending_unsubscribe_patterns.clear()
         if self.channels:
             channels = {}
-            for k, v in iteritems(self.channels):
+            for k, v in self.channels.items():
                 channels[self.encoder.decode(k, force=True)] = v
             self.subscribe(**channels)
         if self.patterns:
             patterns = {}
-            for k, v in iteritems(self.patterns):
+            for k, v in self.patterns.items():
                 patterns[self.encoder.decode(k, force=True)] = v
             self.psubscribe(**patterns)
 
@@ -3601,7 +3573,7 @@ def _normalize_keys(self, data):
         """
         encode = self.encoder.encode
         decode = self.encoder.decode
-        return {decode(encode(k)): v for k, v in iteritems(data)}
+        return {decode(encode(k)): v for k, v in data.items()}
 
     def psubscribe(self, *args, **kwargs):
         """
@@ -3615,7 +3587,7 @@ def psubscribe(self, *args, **kwargs):
             args = list_or_args(args[0], args[1:])
         new_patterns = dict.fromkeys(args)
         new_patterns.update(kwargs)
-        ret_val = self.execute_command('PSUBSCRIBE', *iterkeys(new_patterns))
+        ret_val = self.execute_command('PSUBSCRIBE', *new_patterns.keys())
         # update the patterns dict AFTER we send the command. we don't want to
         # subscribe twice to these patterns, once for the command and again
         # for the reconnection.
@@ -3649,7 +3621,7 @@ def subscribe(self, *args, **kwargs):
             args = list_or_args(args[0], args[1:])
         new_channels = dict.fromkeys(args)
         new_channels.update(kwargs)
-        ret_val = self.execute_command('SUBSCRIBE', *iterkeys(new_channels))
+        ret_val = self.execute_command('SUBSCRIBE', *new_channels.keys())
         # update the channels dict AFTER we send the command. we don't want to
         # subscribe twice to these channels, once for the command and again
         # for the reconnection.
@@ -3704,7 +3676,7 @@ def handle_message(self, response, ignore_subscribe_messages=False):
         with a message handler, the handler is invoked instead of a parsed
         message being returned.
         """
-        message_type = nativestr(response[0])
+        message_type = str_if_bytes(response[0])
         if message_type == 'pmessage':
             message = {
                 'type': message_type,
@@ -3758,11 +3730,11 @@ def handle_message(self, response, ignore_subscribe_messages=False):
         return message
 
     def run_in_thread(self, sleep_time=0, daemon=False):
-        for channel, handler in iteritems(self.channels):
+        for channel, handler in self.channels.items():
             if handler is None:
                 raise PubSubError("Channel: '%s' has no handler registered" %
                                   channel)
-        for pattern, handler in iteritems(self.patterns):
+        for pattern, handler in self.patterns.items():
             if handler is None:
                 raise PubSubError("Pattern: '%s' has no handler registered" %
                                   pattern)
@@ -3774,7 +3746,7 @@ def run_in_thread(self, sleep_time=0, daemon=False):
 
 class PubSubWorkerThread(threading.Thread):
     def __init__(self, pubsub, sleep_time, daemon=False):
-        super(PubSubWorkerThread, self).__init__()
+        super().__init__()
         self.daemon = daemon
         self.pubsub = pubsub
         self.sleep_time = sleep_time
@@ -3845,12 +3817,8 @@ def __del__(self):
     def __len__(self):
         return len(self.command_stack)
 
-    def __nonzero__(self):
-        "Pipeline instances should  always evaluate to True on Python 2.7"
-        return True
-
     def __bool__(self):
-        "Pipeline instances should  always evaluate to True on Python 3+"
+        "Pipeline instances should always evaluate to True"
         return True
 
     def reset(self):
@@ -4007,7 +3975,7 @@ def _execute_transaction(self, connection, commands, raise_on_error):
 
         # We have to run response callbacks manually
         data = []
-        for r, cmd in izip(response, commands):
+        for r, cmd in zip(response, commands):
             if not isinstance(r, Exception):
                 args, options = cmd
                 command_name = args[0]
@@ -4040,9 +4008,9 @@ def raise_first_error(self, commands, response):
                 raise r
 
     def annotate_exception(self, exception, number, command):
-        cmd = ' '.join(imap(safe_unicode, command))
+        cmd = ' '.join(map(safe_str, command))
         msg = 'Command # %d (%s) of pipeline caused error: %s' % (
-            number, cmd, safe_unicode(exception.args[0]))
+            number, cmd, exception.args[0])
         exception.args = (msg,) + exception.args[1:]
 
     def parse_response(self, connection, command_name, **options):
@@ -4063,7 +4031,7 @@ def load_scripts(self):
         # get buffered in the pipeline.
         exists = immediate('SCRIPT EXISTS', *shas)
         if not all(exists):
-            for s, exist in izip(scripts, exists):
+            for s, exist in zip(scripts, exists):
                 if not exist:
                     s.sha = immediate('SCRIPT LOAD', s.script)
 
@@ -4117,7 +4085,7 @@ def unwatch(self):
         return self.watching and self.execute_command('UNWATCH') or True
 
 
-class Script(object):
+class Script:
     "An executable Lua script object returned by ``register_script``"
 
     def __init__(self, registered_client, script):
@@ -4125,7 +4093,7 @@ def __init__(self, registered_client, script):
         self.script = script
         # Precalculate and store the SHA1 hex digest of the script.
 
-        if isinstance(script, basestring):
+        if isinstance(script, str):
             # We need the encoding from the client in order to generate an
             # accurate byte representation of the script
             encoder = registered_client.connection_pool.get_encoder()
@@ -4151,7 +4119,7 @@ def __call__(self, keys=[], args=[], client=None):
             return client.evalsha(self.sha, len(keys), *args)
 
 
-class BitFieldOperation(object):
+class BitFieldOperation:
     """
     Command builder for BITFIELD commands.
     """
diff --git a/redis/connection.py b/redis/connection.py
index 22d3902995..a29f9b2fa6 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1,7 +1,8 @@
-from __future__ import unicode_literals
 from distutils.version import StrictVersion
 from itertools import chain
 from time import time
+from queue import LifoQueue, Empty, Full
+from urllib.parse import parse_qs, unquote, urlparse
 import errno
 import io
 import os
@@ -9,11 +10,6 @@
 import threading
 import warnings
 
-from redis._compat import (xrange, imap, unicode, long,
-                           nativestr, basestring, iteritems,
-                           LifoQueue, Empty, Full, urlparse, parse_qs,
-                           recv, recv_into, unquote, BlockingIOError,
-                           sendall, shutdown, ssl_wrap_socket)
 from redis.exceptions import (
     AuthenticationError,
     AuthenticationWrongNumberOfArgsError,
@@ -31,7 +27,7 @@
     TimeoutError,
     ModuleError,
 )
-from redis.utils import HIREDIS_AVAILABLE
+from redis.utils import HIREDIS_AVAILABLE, str_if_bytes
 
 try:
     import ssl
@@ -50,16 +46,6 @@
     else:
         NONBLOCKING_EXCEPTION_ERROR_NUMBERS[ssl.SSLError] = 2
 
-# In Python 2.7 a socket.error is raised for a nonblocking read.
-# The _compat module aliases BlockingIOError to socket.error to be
-# Python 2/3 compatible.
-# However this means that all socket.error exceptions need to be handled
-# properly within these exception handlers.
-# We need to make sure socket.error is included in these handlers and
-# provide a dummy error number that will never match a real exception.
-if socket.error not in NONBLOCKING_EXCEPTION_ERROR_NUMBERS:
-    NONBLOCKING_EXCEPTION_ERROR_NUMBERS[socket.error] = -999999
-
 NONBLOCKING_EXCEPTIONS = tuple(NONBLOCKING_EXCEPTION_ERROR_NUMBERS.keys())
 
 if HIREDIS_AVAILABLE:
@@ -101,7 +87,7 @@
                                   "types, can't unload"
 
 
-class Encoder(object):
+class Encoder:
     "Encode strings to bytes-like and decode bytes-like to strings"
 
     def __init__(self, encoding, encoding_errors, decode_responses):
@@ -117,17 +103,14 @@ def encode(self, value):
             # special case bool since it is a subclass of int
             raise DataError("Invalid input of type: 'bool'. Convert to a "
                             "bytes, string, int or float first.")
-        elif isinstance(value, float):
+        elif isinstance(value, (int, float)):
             value = repr(value).encode()
-        elif isinstance(value, (int, long)):
-            # python 2 repr() on longs is '123L', so use str() instead
-            value = str(value).encode()
-        elif not isinstance(value, basestring):
+        elif not isinstance(value, str):
             # a value we don't know how to deal with. throw an error
             typename = type(value).__name__
             raise DataError("Invalid input of type: '%s'. Convert to a "
                             "bytes, string, int or float first." % typename)
-        if isinstance(value, unicode):
+        if isinstance(value, str):
             value = value.encode(self.encoding, self.encoding_errors)
         return value
 
@@ -141,7 +124,7 @@ def decode(self, value, force=False):
         return value
 
 
-class BaseParser(object):
+class BaseParser:
     EXCEPTION_CLASSES = {
         'ERR': {
             'max number of clients reached': ConnectionError,
@@ -180,7 +163,7 @@ def parse_error(self, response):
         return ResponseError(response)
 
 
-class SocketBuffer(object):
+class SocketBuffer:
     def __init__(self, socket, socket_read_size, socket_timeout):
         self._sock = socket
         self.socket_read_size = socket_read_size
@@ -208,7 +191,7 @@ def _read_from_socket(self, length=None, timeout=SENTINEL,
             if custom_timeout:
                 sock.settimeout(timeout)
             while True:
-                data = recv(self._sock, socket_read_size)
+                data = self._sock.recv(socket_read_size)
                 # an empty string indicates the server shutdown the socket
                 if isinstance(data, bytes) and len(data) == 0:
                     raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
@@ -345,7 +328,7 @@ def read_response(self):
 
         # server returned an error
         if byte == b'-':
-            response = nativestr(response)
+            response = response.decode('utf-8', errors='replace')
             error = self.parse_error(response)
             # if the error is a ConnectionError, raise immediately so the user
             # is notified
@@ -361,7 +344,7 @@ def read_response(self):
             pass
         # int value
         elif byte == b':':
-            response = long(response)
+            response = int(response)
         # bulk response
         elif byte == b'$':
             length = int(response)
@@ -373,7 +356,7 @@ def read_response(self):
             length = int(response)
             if length == -1:
                 return None
-            response = [self.read_response() for i in xrange(length)]
+            response = [self.read_response() for i in range(length)]
         if isinstance(response, bytes):
             response = self.encoder.decode(response)
         return response
@@ -437,12 +420,12 @@ def read_from_socket(self, timeout=SENTINEL, raise_on_timeout=True):
             if custom_timeout:
                 sock.settimeout(timeout)
             if HIREDIS_USE_BYTE_BUFFER:
-                bufflen = recv_into(self._sock, self._buffer)
+                bufflen = self._sock.recv_into(self._buffer)
                 if bufflen == 0:
                     raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
                 self._reader.feed(self._buffer, 0, bufflen)
             else:
-                buffer = recv(self._sock, self.socket_read_size)
+                buffer = self._sock.recv(self.socket_read_size)
                 # an empty string indicates the server shutdown the socket
                 if not isinstance(buffer, bytes) or len(buffer) == 0:
                     raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
@@ -507,7 +490,7 @@ def read_response(self):
     DefaultParser = PythonParser
 
 
-class Connection(object):
+class Connection:
     "Manages TCP communication to and from a Redis server"
 
     def __init__(self, host='localhost', port=6379, db=0, password=None,
@@ -606,7 +589,7 @@ def _connect(self):
                 # TCP_KEEPALIVE
                 if self.socket_keepalive:
                     sock.setsockopt(socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1)
-                    for k, v in iteritems(self.socket_keepalive_options):
+                    for k, v in self.socket_keepalive_options.items():
                         sock.setsockopt(socket.IPPROTO_TCP, k, v)
 
                 # set the socket_connect_timeout before we connect
@@ -619,14 +602,14 @@ def _connect(self):
                 sock.settimeout(self.socket_timeout)
                 return sock
 
-            except socket.error as _:
+            except OSError as _:
                 err = _
                 if sock is not None:
                     sock.close()
 
         if err is not None:
             raise err
-        raise socket.error("socket.getaddrinfo returned an empty list")
+        raise OSError("socket.getaddrinfo returned an empty list")
 
     def _error_message(self, exception):
         # args for socket.error can either be (errno, "message")
@@ -662,19 +645,19 @@ def on_connect(self):
                 self.send_command('AUTH', self.password, check_health=False)
                 auth_response = self.read_response()
 
-            if nativestr(auth_response) != 'OK':
+            if str_if_bytes(auth_response) != 'OK':
                 raise AuthenticationError('Invalid Username or Password')
 
         # if a client_name is given, set it
         if self.client_name:
             self.send_command('CLIENT', 'SETNAME', self.client_name)
-            if nativestr(self.read_response()) != 'OK':
+            if str_if_bytes(self.read_response()) != 'OK':
                 raise ConnectionError('Error setting client name')
 
         # if a database is specified, switch to it
         if self.db:
             self.send_command('SELECT', self.db)
-            if nativestr(self.read_response()) != 'OK':
+            if str_if_bytes(self.read_response()) != 'OK':
                 raise ConnectionError('Invalid Database')
 
     def disconnect(self):
@@ -684,9 +667,9 @@ def disconnect(self):
             return
         try:
             if os.getpid() == self.pid:
-                shutdown(self._sock, socket.SHUT_RDWR)
+                self._sock.shutdown(socket.SHUT_RDWR)
             self._sock.close()
-        except socket.error:
+        except OSError:
             pass
         self._sock = None
 
@@ -695,13 +678,13 @@ def check_health(self):
         if self.health_check_interval and time() > self.next_health_check:
             try:
                 self.send_command('PING', check_health=False)
-                if nativestr(self.read_response()) != 'PONG':
+                if str_if_bytes(self.read_response()) != 'PONG':
                     raise ConnectionError(
                         'Bad response from PING health check')
             except (ConnectionError, TimeoutError):
                 self.disconnect()
                 self.send_command('PING', check_health=False)
-                if nativestr(self.read_response()) != 'PONG':
+                if str_if_bytes(self.read_response()) != 'PONG':
                     raise ConnectionError(
                         'Bad response from PING health check')
 
@@ -716,7 +699,7 @@ def send_packed_command(self, command, check_health=True):
             if isinstance(command, str):
                 command = [command]
             for item in command:
-                sendall(self._sock, item)
+                self._sock.sendall(item)
         except socket.timeout:
             self.disconnect()
             raise TimeoutError("Timeout writing to socket")
@@ -777,7 +760,7 @@ def pack_command(self, *args):
         # arguments to be sent separately, so split the first argument
         # manually. These arguments should be bytestrings so that they are
         # not encoded.
-        if isinstance(args[0], unicode):
+        if isinstance(args[0], str):
             args = tuple(args[0].encode().split()) + args[1:]
         elif b' ' in args[0]:
             args = tuple(args[0].split()) + args[1:]
@@ -785,7 +768,7 @@ def pack_command(self, *args):
         buff = SYM_EMPTY.join((SYM_STAR, str(len(args)).encode(), SYM_CRLF))
 
         buffer_cutoff = self._buffer_cutoff
-        for arg in imap(self.encoder.encode, args):
+        for arg in map(self.encoder.encode, args):
             # to avoid large string mallocs, chunk the command into the
             # output list if we're sending large values or memoryviews
             arg_length = len(arg)
@@ -838,13 +821,13 @@ def __init__(self, ssl_keyfile=None, ssl_certfile=None,
         if not ssl_available:
             raise RedisError("Python wasn't built with SSL support")
 
-        super(SSLConnection, self).__init__(**kwargs)
+        super().__init__(**kwargs)
 
         self.keyfile = ssl_keyfile
         self.certfile = ssl_certfile
         if ssl_cert_reqs is None:
             ssl_cert_reqs = ssl.CERT_NONE
-        elif isinstance(ssl_cert_reqs, basestring):
+        elif isinstance(ssl_cert_reqs, str):
             CERT_REQS = {
                 'none': ssl.CERT_NONE,
                 'optional': ssl.CERT_OPTIONAL,
@@ -861,27 +844,16 @@ def __init__(self, ssl_keyfile=None, ssl_certfile=None,
 
     def _connect(self):
         "Wrap the socket with SSL support"
-        sock = super(SSLConnection, self)._connect()
-        if hasattr(ssl, "create_default_context"):
-            context = ssl.create_default_context()
-            context.check_hostname = self.check_hostname
-            context.verify_mode = self.cert_reqs
-            if self.certfile and self.keyfile:
-                context.load_cert_chain(certfile=self.certfile,
-                                        keyfile=self.keyfile)
-            if self.ca_certs:
-                context.load_verify_locations(self.ca_certs)
-            sock = ssl_wrap_socket(context, sock, server_hostname=self.host)
-        else:
-            # In case this code runs in a version which is older than 2.7.9,
-            # we want to fall back to old code
-            sock = ssl_wrap_socket(ssl,
-                                   sock,
-                                   cert_reqs=self.cert_reqs,
-                                   keyfile=self.keyfile,
-                                   certfile=self.certfile,
-                                   ca_certs=self.ca_certs)
-        return sock
+        sock = super()._connect()
+        context = ssl.create_default_context()
+        context.check_hostname = self.check_hostname
+        context.verify_mode = self.cert_reqs
+        if self.certfile and self.keyfile:
+            context.load_cert_chain(certfile=self.certfile,
+                                    keyfile=self.keyfile)
+        if self.ca_certs:
+            context.load_verify_locations(self.ca_certs)
+        return context.wrap_socket(sock, server_hostname=self.host)
 
 
 class UnixDomainSocketConnection(Connection):
@@ -941,7 +913,7 @@ def _error_message(self, exception):
 def to_bool(value):
     if value is None or value == '':
         return None
-    if isinstance(value, basestring) and value.upper() in FALSE_STRINGS:
+    if isinstance(value, str) and value.upper() in FALSE_STRINGS:
         return False
     return bool(value)
 
@@ -957,7 +929,7 @@ def to_bool(value):
 }
 
 
-class ConnectionPool(object):
+class ConnectionPool:
     """
     Create a connection pool. ``If max_connections`` is set, then this
     object raises :py:class:`~redis.ConnectionError` when the pool's
@@ -1019,7 +991,7 @@ def from_url(cls, url, db=None, decode_components=False, **kwargs):
         url = urlparse(url)
         url_options = {}
 
-        for name, value in iteritems(parse_qs(url.query)):
+        for name, value in parse_qs(url.query).items():
             if value and len(value) > 0:
                 parser = URL_QUERY_ARGUMENT_PARSERS.get(name)
                 if parser:
@@ -1096,7 +1068,7 @@ def from_url(cls, url, db=None, decode_components=False, **kwargs):
     def __init__(self, connection_class=Connection, max_connections=None,
                  **connection_kwargs):
         max_connections = max_connections or 2 ** 31
-        if not isinstance(max_connections, (int, long)) or max_connections < 0:
+        if not isinstance(max_connections, int) or max_connections < 0:
             raise ValueError('"max_connections" must be a positive integer')
 
         self.connection_class = connection_class
@@ -1173,14 +1145,7 @@ def _checkpid(self):
         # that time it is assumed that the child is deadlocked and a
         # redis.ChildDeadlockedError error is raised.
         if self.pid != os.getpid():
-            # python 2.7 doesn't support a timeout option to lock.acquire()
-            # we have to mimic lock timeouts ourselves.
-            timeout_at = time() + 5
-            acquired = False
-            while time() < timeout_at:
-                acquired = self._fork_lock.acquire(False)
-                if acquired:
-                    break
+            acquired = self._fork_lock.acquire(timeout=5)
             if not acquired:
                 raise ChildDeadlockedError
             # reset() the instance for the new process if another thread
@@ -1323,7 +1288,7 @@ def __init__(self, max_connections=50, timeout=20,
 
         self.queue_class = queue_class
         self.timeout = timeout
-        super(BlockingConnectionPool, self).__init__(
+        super().__init__(
             connection_class=connection_class,
             max_connections=max_connections,
             **connection_kwargs)
diff --git a/redis/lock.py b/redis/lock.py
index 5c4774833f..e51f169695 100644
--- a/redis/lock.py
+++ b/redis/lock.py
@@ -1,11 +1,11 @@
 import threading
 import time as mod_time
 import uuid
+from types import SimpleNamespace
 from redis.exceptions import LockError, LockNotOwnedError
-from redis.utils import dummy
 
 
-class Lock(object):
+class Lock:
     """
     A shared, distributed Lock. Using Redis for locking allows the Lock
     to be shared across processes and/or machines.
@@ -129,7 +129,11 @@ def __init__(self, redis, name, timeout=None, sleep=0.1,
         self.blocking = blocking
         self.blocking_timeout = blocking_timeout
         self.thread_local = bool(thread_local)
-        self.local = threading.local() if self.thread_local else dummy()
+        self.local = (
+            threading.local()
+            if self.thread_local
+            else SimpleNamespace()
+        )
         self.local.token = None
         self.register_scripts()
 
diff --git a/redis/sentinel.py b/redis/sentinel.py
index 203c859bcc..b9d77f1c6e 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -5,7 +5,7 @@
 from redis.connection import ConnectionPool, Connection
 from redis.exceptions import (ConnectionError, ResponseError, ReadOnlyError,
                               TimeoutError)
-from redis._compat import iteritems, nativestr, xrange
+from redis.utils import str_if_bytes
 
 
 class MasterNotFoundError(ConnectionError):
@@ -19,7 +19,7 @@ class SlaveNotFoundError(ConnectionError):
 class SentinelManagedConnection(Connection):
     def __init__(self, **kwargs):
         self.connection_pool = kwargs.pop('connection_pool')
-        super(SentinelManagedConnection, self).__init__(**kwargs)
+        super().__init__(**kwargs)
 
     def __repr__(self):
         pool = self.connection_pool
@@ -31,10 +31,10 @@ def __repr__(self):
 
     def connect_to(self, address):
         self.host, self.port = address
-        super(SentinelManagedConnection, self).connect()
+        super().connect()
         if self.connection_pool.check_connection:
             self.send_command('PING')
-            if nativestr(self.read_response()) != 'PONG':
+            if str_if_bytes(self.read_response()) != 'PONG':
                 raise ConnectionError('PING failed')
 
     def connect(self):
@@ -52,7 +52,7 @@ def connect(self):
 
     def read_response(self):
         try:
-            return super(SentinelManagedConnection, self).read_response()
+            return super().read_response()
         except ReadOnlyError:
             if self.connection_pool.is_master:
                 # When talking to a master, a ReadOnlyError when likely
@@ -78,7 +78,7 @@ def __init__(self, service_name, sentinel_manager, **kwargs):
             'connection_class', SentinelManagedConnection)
         self.is_master = kwargs.pop('is_master', True)
         self.check_connection = kwargs.pop('check_connection', False)
-        super(SentinelConnectionPool, self).__init__(**kwargs)
+        super().__init__(**kwargs)
         self.connection_kwargs['connection_pool'] = weakref.proxy(self)
         self.service_name = service_name
         self.sentinel_manager = sentinel_manager
@@ -91,7 +91,7 @@ def __repr__(self):
         )
 
     def reset(self):
-        super(SentinelConnectionPool, self).reset()
+        super().reset()
         self.master_address = None
         self.slave_rr_counter = None
 
@@ -119,7 +119,7 @@ def rotate_slaves(self):
         if slaves:
             if self.slave_rr_counter is None:
                 self.slave_rr_counter = random.randint(0, len(slaves) - 1)
-            for _ in xrange(len(slaves)):
+            for _ in range(len(slaves)):
                 self.slave_rr_counter = (
                     self.slave_rr_counter + 1) % len(slaves)
                 slave = slaves[self.slave_rr_counter]
@@ -132,7 +132,7 @@ def rotate_slaves(self):
         raise SlaveNotFoundError('No slave found for %r' % (self.service_name))
 
 
-class Sentinel(object):
+class Sentinel:
     """
     Redis Sentinel cluster client
 
@@ -168,7 +168,7 @@ def __init__(self, sentinels, min_other_sentinels=0, sentinel_kwargs=None,
         if sentinel_kwargs is None:
             sentinel_kwargs = {
                 k: v
-                for k, v in iteritems(connection_kwargs)
+                for k, v in connection_kwargs.items()
                 if k.startswith('socket_')
             }
         self.sentinel_kwargs = sentinel_kwargs
diff --git a/redis/utils.py b/redis/utils.py
index 6ef6fd4ad2..3664708f8d 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -26,8 +26,13 @@ def pipeline(redis_obj):
     p.execute()
 
 
-class dummy(object):
-    """
-    Instances of this class can be used as an attribute container.
-    """
-    pass
+def str_if_bytes(value):
+    return (
+        value.decode('utf-8', errors='replace')
+        if isinstance(value, bytes)
+        else value
+    )
+
+
+def safe_str(value):
+    return str(str_if_bytes(value))
diff --git a/setup.cfg b/setup.cfg
index 430cba081e..3fdea4e52d 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -17,9 +17,8 @@ classifiers =
     License :: OSI Approved :: MIT License
     Operating System :: OS Independent
     Programming Language :: Python
-    Programming Language :: Python :: 2
-    Programming Language :: Python :: 2.7
     Programming Language :: Python :: 3
+    Programming Language :: Python :: 3 :: Only
     Programming Language :: Python :: 3.5
     Programming Language :: Python :: 3.6
     Programming Language :: Python :: 3.7
@@ -30,13 +29,10 @@ classifiers =
 
 [options]
 packages = redis
-python_requires = >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
+python_requires = >=3.5
 
 [options.extras_require]
 hiredis = hiredis>=0.1.3
 
 [flake8]
 exclude = .venv,.tox,dist,docs,build,*.egg,redis_install,env,venv,.undodir
-
-[bdist_wheel]
-universal = 1
diff --git a/tests/conftest.py b/tests/conftest.py
index caca8cc51d..26893dbd6c 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -1,11 +1,9 @@
-import random
-
 import pytest
+import random
 import redis
-from mock import Mock
-
-from redis._compat import urlparse
 from distutils.version import StrictVersion
+from unittest.mock import Mock
+from urllib.parse import urlparse
 
 
 # redis 6 release candidates report a version number of 5.9.x. Use this
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 91bcbb3098..38e2d1a361 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1,13 +1,11 @@
-from __future__ import unicode_literals
 import binascii
 import datetime
 import pytest
 import re
 import redis
 import time
+from string import ascii_letters
 
-from redis._compat import (unichr, ascii_letters, iteritems, iterkeys,
-                           itervalues, long, basestring)
 from redis.client import parse_info
 from redis import exceptions
 
@@ -44,7 +42,7 @@ def get_stream_message(client, stream, message_id):
 
 
 # RESPONSE CALLBACKS
-class TestResponseCallbacks(object):
+class TestResponseCallbacks:
     "Tests for the response callback system"
 
     def test_response_callbacks(self, r):
@@ -58,7 +56,7 @@ def test_case_insensitive_command_names(self, r):
         assert r.response_callbacks['del'] == r.response_callbacks['DEL']
 
 
-class TestRedisCommands(object):
+class TestRedisCommands:
     def test_command_on_invalid_key_type(self, r):
         r.lpush('a', '1')
         with pytest.raises(redis.ResponseError):
@@ -93,7 +91,7 @@ def teardown():
     @skip_if_server_version_lt(REDIS_6_VERSION)
     def test_acl_genpass(self, r):
         password = r.acl_genpass()
-        assert isinstance(password, basestring)
+        assert isinstance(password, str)
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
     def test_acl_getuser_setuser(self, r, request):
@@ -237,7 +235,7 @@ def test_acl_users(self, r):
     @skip_if_server_version_lt(REDIS_6_VERSION)
     def test_acl_whoami(self, r):
         username = r.acl_whoami()
-        assert isinstance(username, basestring)
+        assert isinstance(username, str)
 
     def test_client_list(self, r):
         clients = r.client_list()
@@ -411,7 +409,7 @@ def test_ping(self, r):
 
     def test_slowlog_get(self, r, slowlog):
         assert r.slowlog_reset()
-        unicode_string = unichr(3456) + 'abcd' + unichr(3421)
+        unicode_string = chr(3456) + 'abcd' + chr(3421)
         r.get(unicode_string)
         slowlog = r.slowlog_get()
         assert isinstance(slowlog, list)
@@ -646,7 +644,7 @@ def test_get_and_set(self, r):
         assert r.get('a') is None
         byte_string = b'value'
         integer = 5
-        unicode_string = unichr(3456) + 'abcd' + unichr(3421)
+        unicode_string = chr(3456) + 'abcd' + chr(3421)
         assert r.set('byte_string', byte_string)
         assert r.set('integer', 5)
         assert r.set('unicode_string', unicode_string)
@@ -733,7 +731,7 @@ def test_mget(self, r):
     def test_mset(self, r):
         d = {'a': b'1', 'b': b'2', 'c': b'3'}
         assert r.mset(d)
-        for k, v in iteritems(d):
+        for k, v in d.items():
             assert r[k] == v
 
     def test_msetnx(self, r):
@@ -741,7 +739,7 @@ def test_msetnx(self, r):
         assert r.msetnx(d)
         d2 = {'a': b'x', 'd': b'4'}
         assert not r.msetnx(d2)
-        for k, v in iteritems(d):
+        for k, v in d.items():
             assert r[k] == v
         assert r.get('d') is None
 
@@ -1692,7 +1690,7 @@ def test_hincrbyfloat(self, r):
     def test_hkeys(self, r):
         h = {b'a1': b'1', b'a2': b'2', b'a3': b'3'}
         r.hset('a', mapping=h)
-        local_keys = list(iterkeys(h))
+        local_keys = list(h.keys())
         remote_keys = r.hkeys('a')
         assert (sorted(local_keys) == sorted(remote_keys))
 
@@ -1722,7 +1720,7 @@ def test_hsetnx(self, r):
     def test_hvals(self, r):
         h = {b'a1': b'1', b'a2': b'2', b'a3': b'3'}
         r.hset('a', mapping=h)
-        local_vals = list(itervalues(h))
+        local_vals = list(h.values())
         remote_vals = r.hvals('a')
         assert sorted(local_vals) == sorted(remote_vals)
 
@@ -2320,8 +2318,8 @@ def test_xinfo_consumers(self, r):
         ]
 
         # we can't determine the idle time, so just make sure it's an int
-        assert isinstance(info[0].pop('idle'), (int, long))
-        assert isinstance(info[1].pop('idle'), (int, long))
+        assert isinstance(info[0].pop('idle'), int)
+        assert isinstance(info[1].pop('idle'), int)
         assert info == expected
 
     @skip_if_server_version_lt('5.0.0')
@@ -2650,7 +2648,7 @@ def test_memory_stats(self, r):
         r.set('foo', 'bar')
         stats = r.memory_stats()
         assert isinstance(stats, dict)
-        for key, value in iteritems(stats):
+        for key, value in stats.items():
             if key.startswith('db.'):
                 assert isinstance(value, dict)
 
@@ -2665,7 +2663,7 @@ def test_module_list(self, r):
         assert not r.module_list()
 
 
-class TestBinarySave(object):
+class TestBinarySave:
 
     def test_binary_get_set(self, r):
         assert r.set(' foo bar ', '123')
@@ -2691,14 +2689,14 @@ def test_binary_lists(self, r):
             b'foo\tbar\x07': [b'7', b'8', b'9'],
         }
         # fill in lists
-        for key, value in iteritems(mapping):
+        for key, value in mapping.items():
             r.rpush(key, *value)
 
         # check that KEYS returns all the keys as they are
-        assert sorted(r.keys('*')) == sorted(iterkeys(mapping))
+        assert sorted(r.keys('*')) == sorted(mapping.keys())
 
         # check that it is possible to get list content by key name
-        for key, value in iteritems(mapping):
+        for key, value in mapping.items():
             assert r.lrange(key, 0, -1) == value
 
     def test_22_info(self, r):
diff --git a/tests/test_connection.py b/tests/test_connection.py
index 5ca92542cf..128bac7d96 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -1,4 +1,4 @@
-import mock
+from unittest import mock
 import pytest
 
 from redis.exceptions import InvalidResponse
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index c49ecda8b6..c26090b02b 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -1,9 +1,9 @@
 import os
-import mock
 import pytest
 import re
 import redis
 import time
+from unittest import mock
 
 from threading import Thread
 from redis.connection import ssl_available, to_bool
@@ -11,7 +11,7 @@
 from .test_pubsub import wait_for_message
 
 
-class DummyConnection(object):
+class DummyConnection:
     description_format = "DummyConnection<>"
 
     def __init__(self, **kwargs):
@@ -25,7 +25,7 @@ def can_read(self):
         return False
 
 
-class TestConnectionPool(object):
+class TestConnectionPool:
     def get_pool(self, connection_kwargs=None, max_connections=None,
                  connection_class=redis.Connection):
         connection_kwargs = connection_kwargs or {}
@@ -93,7 +93,7 @@ def test_repr_contains_db_info_unix(self):
         assert repr(pool) == expected
 
 
-class TestBlockingConnectionPool(object):
+class TestBlockingConnectionPool:
     def get_pool(self, connection_kwargs=None, max_connections=10, timeout=20):
         connection_kwargs = connection_kwargs or {}
         pool = redis.BlockingConnectionPool(connection_class=DummyConnection,
@@ -179,7 +179,7 @@ def test_repr_contains_db_info_unix(self):
         assert repr(pool) == expected
 
 
-class TestConnectionPoolURLParsing(object):
+class TestConnectionPoolURLParsing:
     def test_defaults(self):
         pool = redis.ConnectionPool.from_url('redis://localhost')
         assert pool.connection_class == redis.Connection
@@ -411,7 +411,7 @@ def test_invalid_scheme_raises_error(self):
         )
 
 
-class TestConnectionPoolUnixSocketURLParsing(object):
+class TestConnectionPoolUnixSocketURLParsing:
     def test_defaults(self):
         pool = redis.ConnectionPool.from_url('unix:///socket')
         assert pool.connection_class == redis.UnixDomainSocketConnection
@@ -519,7 +519,7 @@ def test_extra_querystring_options(self):
         }
 
 
-class TestSSLConnectionURLParsing(object):
+class TestSSLConnectionURLParsing:
     @pytest.mark.skipif(not ssl_available, reason="SSL not installed")
     def test_defaults(self):
         pool = redis.ConnectionPool.from_url('rediss://localhost')
@@ -561,7 +561,7 @@ def get_connection(self, *args, **kwargs):
         assert pool.get_connection('_').check_hostname is True
 
 
-class TestConnection(object):
+class TestConnection:
     def test_on_connect_error(self):
         """
         An error in Connection.on_connect should disconnect from the server
@@ -658,7 +658,7 @@ def test_connect_invalid_password_supplied(self, r):
             r.execute_command('DEBUG', 'ERROR', 'ERR invalid password')
 
 
-class TestMultiConnectionClient(object):
+class TestMultiConnectionClient:
     @pytest.fixture()
     def r(self, request):
         return _get_client(redis.Redis,
@@ -671,7 +671,7 @@ def test_multi_connection_command(self, r):
         assert r.get('a') == b'123'
 
 
-class TestHealthCheck(object):
+class TestHealthCheck:
     interval = 60
 
     @pytest.fixture()
diff --git a/tests/test_encoding.py b/tests/test_encoding.py
index ea7db7fc6e..706654f89f 100644
--- a/tests/test_encoding.py
+++ b/tests/test_encoding.py
@@ -1,13 +1,11 @@
-from __future__ import unicode_literals
 import pytest
 import redis
 
-from redis._compat import unichr, unicode
 from redis.connection import Connection
 from .conftest import _get_client
 
 
-class TestEncoding(object):
+class TestEncoding:
     @pytest.fixture()
     def r(self, request):
         return _get_client(redis.Redis, request=request, decode_responses=True)
@@ -21,21 +19,21 @@ def r_no_decode(self, request):
         )
 
     def test_simple_encoding(self, r_no_decode):
-        unicode_string = unichr(3456) + 'abcd' + unichr(3421)
+        unicode_string = chr(3456) + 'abcd' + chr(3421)
         r_no_decode['unicode-string'] = unicode_string.encode('utf-8')
         cached_val = r_no_decode['unicode-string']
         assert isinstance(cached_val, bytes)
         assert unicode_string == cached_val.decode('utf-8')
 
     def test_simple_encoding_and_decoding(self, r):
-        unicode_string = unichr(3456) + 'abcd' + unichr(3421)
+        unicode_string = chr(3456) + 'abcd' + chr(3421)
         r['unicode-string'] = unicode_string
         cached_val = r['unicode-string']
-        assert isinstance(cached_val, unicode)
+        assert isinstance(cached_val, str)
         assert unicode_string == cached_val
 
     def test_memoryview_encoding(self, r_no_decode):
-        unicode_string = unichr(3456) + 'abcd' + unichr(3421)
+        unicode_string = chr(3456) + 'abcd' + chr(3421)
         unicode_string_view = memoryview(unicode_string.encode('utf-8'))
         r_no_decode['unicode-string-memoryview'] = unicode_string_view
         cached_val = r_no_decode['unicode-string-memoryview']
@@ -44,21 +42,21 @@ def test_memoryview_encoding(self, r_no_decode):
         assert unicode_string == cached_val.decode('utf-8')
 
     def test_memoryview_encoding_and_decoding(self, r):
-        unicode_string = unichr(3456) + 'abcd' + unichr(3421)
+        unicode_string = chr(3456) + 'abcd' + chr(3421)
         unicode_string_view = memoryview(unicode_string.encode('utf-8'))
         r['unicode-string-memoryview'] = unicode_string_view
         cached_val = r['unicode-string-memoryview']
-        assert isinstance(cached_val, unicode)
+        assert isinstance(cached_val, str)
         assert unicode_string == cached_val
 
     def test_list_encoding(self, r):
-        unicode_string = unichr(3456) + 'abcd' + unichr(3421)
+        unicode_string = chr(3456) + 'abcd' + chr(3421)
         result = [unicode_string, unicode_string, unicode_string]
         r.rpush('a', *result)
         assert r.lrange('a', 0, -1) == result
 
 
-class TestEncodingErrors(object):
+class TestEncodingErrors:
     def test_ignore(self, request):
         r = _get_client(redis.Redis, request=request, decode_responses=True,
                         encoding_errors='ignore')
@@ -72,7 +70,7 @@ def test_replace(self, request):
         assert r.get('a') == 'foo\ufffd'
 
 
-class TestMemoryviewsAreNotPacked(object):
+class TestMemoryviewsAreNotPacked:
     def test_memoryviews_are_not_packed(self):
         c = Connection()
         arg = memoryview(b'some_arg')
@@ -84,7 +82,7 @@ def test_memoryviews_are_not_packed(self):
         assert cmds[3] is arg
 
 
-class TestCommandsAreNotEncoded(object):
+class TestCommandsAreNotEncoded:
     @pytest.fixture()
     def r(self, request):
         return _get_client(redis.Redis, request=request, encoding='utf-16')
@@ -93,7 +91,7 @@ def test_basic_command(self, r):
         r.set('hello', 'world')
 
 
-class TestInvalidUserInput(object):
+class TestInvalidUserInput:
     def test_boolean_fails(self, r):
         with pytest.raises(redis.DataError):
             r.set('a', True)
@@ -103,12 +101,9 @@ def test_none_fails(self, r):
             r.set('a', None)
 
     def test_user_type_fails(self, r):
-        class Foo(object):
+        class Foo:
             def __str__(self):
                 return 'Foo'
 
-            def __unicode__(self):
-                return 'Foo'
-
         with pytest.raises(redis.DataError):
             r.set('a', Foo())
diff --git a/tests/test_lock.py b/tests/test_lock.py
index e8bd874253..8bb3c7e80a 100644
--- a/tests/test_lock.py
+++ b/tests/test_lock.py
@@ -7,7 +7,7 @@
 from .conftest import _get_client
 
 
-class TestLock(object):
+class TestLock:
     @pytest.fixture()
     def r_decoded(self, request):
         return _get_client(Redis, request=request, decode_responses=True)
@@ -220,9 +220,9 @@ def test_reacquiring_lock_no_longer_owned_raises_error(self, r):
             lock.reacquire()
 
 
-class TestLockClassSelection(object):
+class TestLockClassSelection:
     def test_lock_class_argument(self, r):
-        class MyLock(object):
+        class MyLock:
             def __init__(self, *args, **kwargs):
 
                 pass
diff --git a/tests/test_monitor.py b/tests/test_monitor.py
index ee5dc6e39c..1013202f22 100644
--- a/tests/test_monitor.py
+++ b/tests/test_monitor.py
@@ -1,9 +1,7 @@
-from __future__ import unicode_literals
-from redis._compat import unicode
 from .conftest import wait_for_command
 
 
-class TestMonitor(object):
+class TestMonitor:
     def test_wait_command_not_found(self, r):
         "Make sure the wait_for_command func works when command is not found"
         with r.monitor() as m:
@@ -17,8 +15,8 @@ def test_response_values(self, r):
             assert isinstance(response['time'], float)
             assert response['db'] == 9
             assert response['client_type'] in ('tcp', 'unix')
-            assert isinstance(response['client_address'], unicode)
-            assert isinstance(response['client_port'], unicode)
+            assert isinstance(response['client_address'], str)
+            assert isinstance(response['client_port'], str)
             assert response['command'] == 'PING'
 
     def test_command_with_quoted_key(self, r):
diff --git a/tests/test_multiprocessing.py b/tests/test_multiprocessing.py
index 235e3cee0f..2d27c4e8bb 100644
--- a/tests/test_multiprocessing.py
+++ b/tests/test_multiprocessing.py
@@ -17,7 +17,7 @@ def exit_callback(callback, *args):
         callback(*args)
 
 
-class TestMultiprocessing(object):
+class TestMultiprocessing:
     # Test connection sharing between forks.
     # See issue #1085 for details.
 
diff --git a/tests/test_pipeline.py b/tests/test_pipeline.py
index 4f221530ec..9bc4a9f4d9 100644
--- a/tests/test_pipeline.py
+++ b/tests/test_pipeline.py
@@ -1,12 +1,10 @@
-from __future__ import unicode_literals
 import pytest
 
 import redis
-from redis._compat import unichr, unicode
 from .conftest import wait_for_command
 
 
-class TestPipeline(object):
+class TestPipeline:
     def test_pipeline_is_true(self, r):
         "Ensure pipeline instances are not false-y"
         with r.pipeline() as pipe:
@@ -124,8 +122,8 @@ def test_exec_error_raised(self, r):
             pipe.set('a', 1).set('b', 2).lpush('c', 3).set('d', 4)
             with pytest.raises(redis.ResponseError) as ex:
                 pipe.execute()
-            assert unicode(ex.value).startswith('Command # 3 (LPUSH c 3) of '
-                                                'pipeline caused error: ')
+            assert str(ex.value).startswith('Command # 3 (LPUSH c 3) of '
+                                            'pipeline caused error: ')
 
             # make sure the pipe was restored to a working state
             assert pipe.set('z', 'zzz').execute() == [True]
@@ -166,8 +164,8 @@ def test_parse_error_raised(self, r):
             with pytest.raises(redis.ResponseError) as ex:
                 pipe.execute()
 
-            assert unicode(ex.value).startswith('Command # 2 (ZREM b) of '
-                                                'pipeline caused error: ')
+            assert str(ex.value).startswith('Command # 2 (ZREM b) of '
+                                            'pipeline caused error: ')
 
             # make sure the pipe was restored to a working state
             assert pipe.set('z', 'zzz').execute() == [True]
@@ -181,8 +179,8 @@ def test_parse_error_raised_transaction(self, r):
             with pytest.raises(redis.ResponseError) as ex:
                 pipe.execute()
 
-            assert unicode(ex.value).startswith('Command # 2 (ZREM b) of '
-                                                'pipeline caused error: ')
+            assert str(ex.value).startswith('Command # 2 (ZREM b) of '
+                                            'pipeline caused error: ')
 
             # make sure the pipe was restored to a working state
             assert pipe.set('z', 'zzz').execute() == [True]
@@ -319,13 +317,13 @@ def test_exec_error_in_no_transaction_pipeline(self, r):
             with pytest.raises(redis.ResponseError) as ex:
                 pipe.execute()
 
-            assert unicode(ex.value).startswith('Command # 1 (LLEN a) of '
-                                                'pipeline caused error: ')
+            assert str(ex.value).startswith('Command # 1 (LLEN a) of '
+                                            'pipeline caused error: ')
 
         assert r['a'] == b'1'
 
     def test_exec_error_in_no_transaction_pipeline_unicode_command(self, r):
-        key = unichr(3456) + 'abcd' + unichr(3421)
+        key = chr(3456) + 'abcd' + chr(3421)
         r[key] = 1
         with r.pipeline(transaction=False) as pipe:
             pipe.llen(key)
@@ -334,9 +332,8 @@ def test_exec_error_in_no_transaction_pipeline_unicode_command(self, r):
             with pytest.raises(redis.ResponseError) as ex:
                 pipe.execute()
 
-            expected = unicode('Command # 1 (LLEN %s) of pipeline caused '
-                               'error: ') % key
-            assert unicode(ex.value).startswith(expected)
+            expected = 'Command # 1 (LLEN %s) of pipeline caused error: ' % key
+            assert str(ex.value).startswith(expected)
 
         assert r[key] == b'1'
 
diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index bf134831c4..ab9f09c84e 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -1,10 +1,8 @@
-from __future__ import unicode_literals
 import pytest
 import time
 
 import redis
 from redis.exceptions import ConnectionError
-from redis._compat import basestring, unichr
 
 from .conftest import _get_client
 from .conftest import skip_if_server_version_lt
@@ -28,7 +26,7 @@ def make_message(type, channel, data, pattern=None):
         'type': type,
         'pattern': pattern and pattern.encode('utf-8') or None,
         'channel': channel and channel.encode('utf-8') or None,
-        'data': data.encode('utf-8') if isinstance(data, basestring) else data
+        'data': data.encode('utf-8') if isinstance(data, str) else data
     }
 
 
@@ -40,7 +38,7 @@ def make_subscribe_test_data(pubsub, type):
             'unsub_type': 'unsubscribe',
             'sub_func': pubsub.subscribe,
             'unsub_func': pubsub.unsubscribe,
-            'keys': ['foo', 'bar', 'uni' + unichr(4456) + 'code']
+            'keys': ['foo', 'bar', 'uni' + chr(4456) + 'code']
         }
     elif type == 'pattern':
         return {
@@ -49,12 +47,12 @@ def make_subscribe_test_data(pubsub, type):
             'unsub_type': 'punsubscribe',
             'sub_func': pubsub.psubscribe,
             'unsub_func': pubsub.punsubscribe,
-            'keys': ['f*', 'b*', 'uni' + unichr(4456) + '*']
+            'keys': ['f*', 'b*', 'uni' + chr(4456) + '*']
         }
     assert False, 'invalid subscribe type: %s' % type
 
 
-class TestPubSubSubscribeUnsubscribe(object):
+class TestPubSubSubscribeUnsubscribe:
 
     def _test_subscribe_unsubscribe(self, p, sub_type, unsub_type, sub_func,
                                     unsub_func, keys):
@@ -255,7 +253,7 @@ def _test_sub_unsub_all_resub(self, p, sub_type, unsub_type, sub_func,
         assert p.subscribed is True
 
 
-class TestPubSubMessages(object):
+class TestPubSubMessages:
     def setup_method(self, method):
         self.message = None
 
@@ -314,7 +312,7 @@ def test_pattern_message_handler(self, r):
 
     def test_unicode_channel_message_handler(self, r):
         p = r.pubsub(ignore_subscribe_messages=True)
-        channel = 'uni' + unichr(4456) + 'code'
+        channel = 'uni' + chr(4456) + 'code'
         channels = {channel: self.message_handler}
         p.subscribe(**channels)
         assert wait_for_message(p) is None
@@ -324,8 +322,8 @@ def test_unicode_channel_message_handler(self, r):
 
     def test_unicode_pattern_message_handler(self, r):
         p = r.pubsub(ignore_subscribe_messages=True)
-        pattern = 'uni' + unichr(4456) + '*'
-        channel = 'uni' + unichr(4456) + 'code'
+        pattern = 'uni' + chr(4456) + '*'
+        channel = 'uni' + chr(4456) + 'code'
         p.psubscribe(**{pattern: self.message_handler})
         assert wait_for_message(p) is None
         assert r.publish(channel, 'test message') == 1
@@ -342,12 +340,12 @@ def test_get_message_without_subscribe(self, r):
         assert expect in info.exconly()
 
 
-class TestPubSubAutoDecoding(object):
+class TestPubSubAutoDecoding:
     "These tests only validate that we get unicode values back"
 
-    channel = 'uni' + unichr(4456) + 'code'
-    pattern = 'uni' + unichr(4456) + '*'
-    data = 'abc' + unichr(4458) + '123'
+    channel = 'uni' + chr(4456) + 'code'
+    pattern = 'uni' + chr(4456) + '*'
+    data = 'abc' + chr(4458) + '123'
 
     def make_message(self, type, channel, data, pattern=None):
         return {
@@ -458,7 +456,7 @@ def test_context_manager(self, r):
         assert pubsub.patterns == {}
 
 
-class TestPubSubRedisDown(object):
+class TestPubSubRedisDown:
 
     def test_channel_subscribe(self, r):
         r = redis.Redis(host='localhost', port=6390)
@@ -467,7 +465,7 @@ def test_channel_subscribe(self, r):
             p.subscribe('foo')
 
 
-class TestPubSubSubcommands(object):
+class TestPubSubSubcommands:
 
     @skip_if_server_version_lt('2.8.0')
     def test_pubsub_channels(self, r):
@@ -504,7 +502,7 @@ def test_pubsub_numpat(self, r):
         assert r.pubsub_numpat() == 3
 
 
-class TestPubSubPings(object):
+class TestPubSubPings:
 
     @skip_if_server_version_lt('3.0.0')
     def test_send_pubsub_ping(self, r):
@@ -525,7 +523,7 @@ def test_send_pubsub_ping_message(self, r):
                                                    pattern=None)
 
 
-class TestPubSubConnectionKilled(object):
+class TestPubSubConnectionKilled:
 
     @skip_if_server_version_lt('3.0.0')
     def test_connection_error_raised_when_connection_dies(self, r):
@@ -539,7 +537,7 @@ def test_connection_error_raised_when_connection_dies(self, r):
             wait_for_message(p)
 
 
-class TestPubSubTimeouts(object):
+class TestPubSubTimeouts:
     def test_get_message_with_timeout_returns_none(self, r):
         p = r.pubsub()
         p.subscribe('foo')
diff --git a/tests/test_scripting.py b/tests/test_scripting.py
index b3d52a58fe..02c0f171d1 100644
--- a/tests/test_scripting.py
+++ b/tests/test_scripting.py
@@ -1,4 +1,3 @@
-from __future__ import unicode_literals
 import pytest
 
 from redis import exceptions
@@ -21,7 +20,7 @@
 """
 
 
-class TestScripting(object):
+class TestScripting:
     @pytest.fixture(autouse=True)
     def reset_scripts(self, r):
         r.script_flush()
diff --git a/tests/test_sentinel.py b/tests/test_sentinel.py
index c247c723bf..64a7c47d3a 100644
--- a/tests/test_sentinel.py
+++ b/tests/test_sentinel.py
@@ -5,7 +5,6 @@
 from redis import exceptions
 from redis.sentinel import (Sentinel, SentinelConnectionPool,
                             MasterNotFoundError, SlaveNotFoundError)
-from redis._compat import next
 import redis.sentinel
 
 
@@ -14,7 +13,7 @@ def master_ip(master_host):
     yield socket.gethostbyname(master_host)
 
 
-class SentinelTestClient(object):
+class SentinelTestClient:
     def __init__(self, cluster, id):
         self.cluster = cluster
         self.id = id
@@ -32,7 +31,7 @@ def sentinel_slaves(self, master_name):
         return self.cluster.slaves
 
 
-class SentinelTestCluster(object):
+class SentinelTestCluster:
     def __init__(self, service_name='mymaster', ip='127.0.0.1', port=6379):
         self.clients = {}
         self.master = {
diff --git a/tox.ini b/tox.ini
index d1d97f4906..c783bf06b8 100644
--- a/tox.ini
+++ b/tox.ini
@@ -3,12 +3,11 @@ addopts = -s
 
 [tox]
 minversion = 2.4
-envlist = {py27,py35,py36,py37,py38,pypy,pypy3}-{plain,hiredis}, flake8, covreport, codecov
+envlist = {py35,py36,py37,py38,pypy3}-{plain,hiredis}, flake8, covreport, codecov
 
 [testenv]
 deps =
     coverage
-    mock
     pytest >= 2.7.0
 extras =
     hiredis: hiredis

From abe0e969e21a0e1fc18a0e74387ecac5dddeb2cc Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Thu, 6 Aug 2020 15:23:30 -0700
Subject: [PATCH 0082/1164] added codecov.yml

---
 codecov.yml | 4 ++++
 1 file changed, 4 insertions(+)
 create mode 100644 codecov.yml

diff --git a/codecov.yml b/codecov.yml
new file mode 100644
index 0000000000..97da41bebb
--- /dev/null
+++ b/codecov.yml
@@ -0,0 +1,4 @@
+coverage:
+  precision: 2
+  round: down
+  range: "80...100"

From bafd98f16d30657e240cd9c58129565dfa13eeb9 Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Thu, 6 Aug 2020 15:28:32 -0700
Subject: [PATCH 0083/1164] codecov config

---
 codecov.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/codecov.yml b/codecov.yml
index 97da41bebb..05761cebb8 100644
--- a/codecov.yml
+++ b/codecov.yml
@@ -1,3 +1,6 @@
+codecov:
+  require_ci_to_pass: yes
+
 coverage:
   precision: 2
   round: down

From c73e07c883452d32ec273d04942e017814b04e54 Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Sat, 8 Aug 2020 17:00:18 -0700
Subject: [PATCH 0084/1164] turn off the codecov/patch status

---
 codecov.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/codecov.yml b/codecov.yml
index 05761cebb8..48cdae1902 100644
--- a/codecov.yml
+++ b/codecov.yml
@@ -5,3 +5,5 @@ coverage:
   precision: 2
   round: down
   range: "80...100"
+  status:
+    patch: off  # off for now as it yells about everything

From 6b37f4bedc349eb2c91e680d2ef811a3c2f7e879 Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Sat, 15 Aug 2020 16:16:28 -0700
Subject: [PATCH 0085/1164] All values within Redis URLs are url-unquoted via
 default.

Prior versions of redis-py supported this by specifying the
``decode_components`` flag to the ``from_url`` functions. This is now done by
default and cannot be disabled.

Fixes #589
---
 CHANGES                       |   6 +-
 redis/client.py               |  43 ++++----
 redis/connection.py           | 185 +++++++++++++++-------------------
 tests/test_connection_pool.py | 130 +++---------------------
 4 files changed, 126 insertions(+), 238 deletions(-)

diff --git a/CHANGES b/CHANGES
index b164991b8f..2b7dbb8d1f 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,5 +1,9 @@
 * (in development)
-    * Removed support for end of life Python 2.7.
+    * BACKWARDS INCOMPATIBLE: Removed support for end of life Python 2.7. #1318
+    * BACKWARDS INCOMPATIBLE: All values within Redis URLs are unquoted via
+      urllib.parse.unquote. Prior versions of redis-py supported this by
+      specifying the ``decode_components`` flag to the ``from_url`` functions.
+      This is now done by default and cannot be disabled. #589
     * Provide a development and testing environment via docker. Thanks
       @abrookins. #1365
     * Added support for the LPOS command available in Redis 6.0.6. Thanks
diff --git a/redis/client.py b/redis/client.py
index 881fd65bd1..02db578878 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -647,7 +647,7 @@ class Redis:
     }
 
     @classmethod
-    def from_url(cls, url, db=None, **kwargs):
+    def from_url(cls, url, **kwargs):
         """
         Return a Redis client object configured from the given URL
 
@@ -659,28 +659,35 @@ def from_url(cls, url, db=None, **kwargs):
 
         Three URL schemes are supported:
 
-        - ```redis://``
-          <http://www.iana.org/assignments/uri-schemes/prov/redis>`_ creates a
-          normal TCP socket connection
-        - ```rediss://``
-          <http://www.iana.org/assignments/uri-schemes/prov/rediss>`_ creates a
-          SSL wrapped TCP socket connection
-        - ``unix://`` creates a Unix Domain Socket connection
+        - `redis://` creates a TCP socket connection. See more at:
+          <https://www.iana.org/assignments/uri-schemes/prov/redis>
+        - `rediss://` creates a SSL wrapped TCP socket connection. See more at:
+          <https://www.iana.org/assignments/uri-schemes/prov/rediss>
+        - ``unix://``: creates a Unix Domain Socket connection.
 
-        There are several ways to specify a database number. The parse function
-        will return the first specified option:
+        The username, password, hostname, path and all querystring values
+        are passed through urllib.parse.unquote in order to replace any
+        percent-encoded values with their corresponding characters.
+
+        There are several ways to specify a database number. The first value
+        found will be used:
             1. A ``db`` querystring option, e.g. redis://localhost?db=0
-            2. If using the redis:// scheme, the path argument of the url, e.g.
-               redis://localhost/0
-            3. The ``db`` argument to this function.
+            2. If using the redis:// or rediss:// schemes, the path argument
+               of the url, e.g. redis://localhost/0
+            3. A ``db`` keyword argument to this function.
+
+        If none of these options are specified, the default db=0 is used.
 
-        If none of these options are specified, db=0 is used.
+        All querystring options are cast to their appropriate Python types.
+        Boolean arguments can be specified with string values "True"/"False"
+        or "Yes"/"No". Values that cannot be properly cast cause a
+        ``ValueError`` to be raised. Once parsed, the querystring arguments
+        and keyword arguments are passed to the ``ConnectionPool``'s
+        class initializer. In the case of conflicting arguments, querystring
+        arguments always win.
 
-        Any additional querystring arguments and keyword arguments will be
-        passed along to the ConnectionPool class's initializer. In the case
-        of conflicting arguments, querystring arguments always win.
         """
-        connection_pool = ConnectionPool.from_url(url, db=db, **kwargs)
+        connection_pool = ConnectionPool.from_url(url, **kwargs)
         return cls(connection_pool=connection_pool)
 
     def __init__(self, host='localhost', port=6379,
diff --git a/redis/connection.py b/redis/connection.py
index a29f9b2fa6..4a855b3568 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -919,6 +919,7 @@ def to_bool(value):
 
 
 URL_QUERY_ARGUMENT_PARSERS = {
+    'db': int,
     'socket_timeout': float,
     'socket_connect_timeout': float,
     'socket_keepalive': to_bool,
@@ -929,6 +930,59 @@ def to_bool(value):
 }
 
 
+def parse_url(url):
+    url = urlparse(url)
+    kwargs = {}
+
+    for name, value in parse_qs(url.query).items():
+        if value and len(value) > 0:
+            value = unquote(value[0])
+            parser = URL_QUERY_ARGUMENT_PARSERS.get(name)
+            if parser:
+                try:
+                    kwargs[name] = parser(value)
+                except (TypeError, ValueError):
+                    raise ValueError(
+                        "Invalid value for `%s` in connection URL." % name
+                    )
+            else:
+                kwargs[name] = value
+
+    if url.username:
+        kwargs['username'] = unquote(url.username)
+    if url.password:
+        kwargs['password'] = unquote(url.password)
+
+    # We only support redis://, rediss:// and unix:// schemes.
+    if url.scheme == 'unix':
+        if url.path:
+            kwargs['path'] = unquote(url.path)
+        kwargs['connection_class'] = UnixDomainSocketConnection
+
+    elif url.scheme in ('redis', 'rediss'):
+        if url.hostname:
+            kwargs['host'] = unquote(url.hostname)
+        if url.port:
+            kwargs['port'] = int(url.port)
+
+        # If there's a path argument, use it as the db argument if a
+        # querystring value wasn't specified
+        if url.path and 'db' not in kwargs:
+            try:
+                kwargs['db'] = int(unquote(url.path).replace('/', ''))
+            except (AttributeError, ValueError):
+                pass
+
+        if url.scheme == 'rediss':
+            kwargs['connection_class'] = SSLConnection
+    else:
+        valid_schemes = 'redis://, rediss://, unix://'
+        raise ValueError('Redis URL must specify one of the following '
+                         'schemes (%s)' % valid_schemes)
+
+    return kwargs
+
+
 class ConnectionPool:
     """
     Create a connection pool. ``If max_connections`` is set, then this
@@ -943,7 +997,7 @@ class ConnectionPool:
     ``connection_class``.
     """
     @classmethod
-    def from_url(cls, url, db=None, decode_components=False, **kwargs):
+    def from_url(cls, url, **kwargs):
         """
         Return a connection pool configured from the given URL.
 
@@ -955,114 +1009,35 @@ def from_url(cls, url, db=None, decode_components=False, **kwargs):
 
         Three URL schemes are supported:
 
-        - `redis://
-          <https://www.iana.org/assignments/uri-schemes/prov/redis>`_ creates a
-          normal TCP socket connection
-        - `rediss://
-          <https://www.iana.org/assignments/uri-schemes/prov/rediss>`_ creates
-          a SSL wrapped TCP socket connection
-        - ``unix://`` creates a Unix Domain Socket connection
+        - `redis://` creates a TCP socket connection. See more at:
+          <https://www.iana.org/assignments/uri-schemes/prov/redis>
+        - `rediss://` creates a SSL wrapped TCP socket connection. See more at:
+          <https://www.iana.org/assignments/uri-schemes/prov/rediss>
+        - ``unix://``: creates a Unix Domain Socket connection.
 
-        There are several ways to specify a database number. The parse function
-        will return the first specified option:
-            1. A ``db`` querystring option, e.g. redis://localhost?db=0
-            2. If using the redis:// scheme, the path argument of the url, e.g.
-               redis://localhost/0
-            3. The ``db`` argument to this function.
-
-        If none of these options are specified, db=0 is used.
-
-        The ``decode_components`` argument allows this function to work with
-        percent-encoded URLs. If this argument is set to ``True`` all ``%xx``
-        escapes will be replaced by their single-character equivalents after
-        the URL has been parsed. This only applies to the ``hostname``,
-        ``path``, ``username`` and ``password`` components.
-
-        Any additional querystring arguments and keyword arguments will be
-        passed along to the ConnectionPool class's initializer. The querystring
-        arguments ``socket_connect_timeout`` and ``socket_timeout`` if supplied
-        are parsed as float values. The arguments ``socket_keepalive`` and
-        ``retry_on_timeout`` are parsed to boolean values that accept
-        True/False, Yes/No values to indicate state. Invalid types cause a
-        ``UserWarning`` to be raised. In the case of conflicting arguments,
-        querystring arguments always win.
+        The username, password, hostname, path and all querystring values
+        are passed through urllib.parse.unquote in order to replace any
+        percent-encoded values with their corresponding characters.
 
+        There are several ways to specify a database number. The first value
+        found will be used:
+            1. A ``db`` querystring option, e.g. redis://localhost?db=0
+            2. If using the redis:// or rediss:// schemes, the path argument
+               of the url, e.g. redis://localhost/0
+            3. A ``db`` keyword argument to this function.
+
+        If none of these options are specified, the default db=0 is used.
+
+        All querystring options are cast to their appropriate Python types.
+        Boolean arguments can be specified with string values "True"/"False"
+        or "Yes"/"No". Values that cannot be properly cast cause a
+        ``ValueError`` to be raised. Once parsed, the querystring arguments
+        and keyword arguments are passed to the ``ConnectionPool``'s
+        class initializer. In the case of conflicting arguments, querystring
+        arguments always win.
         """
-        url = urlparse(url)
-        url_options = {}
-
-        for name, value in parse_qs(url.query).items():
-            if value and len(value) > 0:
-                parser = URL_QUERY_ARGUMENT_PARSERS.get(name)
-                if parser:
-                    try:
-                        url_options[name] = parser(value[0])
-                    except (TypeError, ValueError):
-                        warnings.warn(UserWarning(
-                            "Invalid value for `%s` in connection URL." % name
-                        ))
-                else:
-                    url_options[name] = value[0]
-
-        if decode_components:
-            username = unquote(url.username) if url.username else None
-            password = unquote(url.password) if url.password else None
-            path = unquote(url.path) if url.path else None
-            hostname = unquote(url.hostname) if url.hostname else None
-        else:
-            username = url.username or None
-            password = url.password or None
-            path = url.path
-            hostname = url.hostname
-
-        # We only support redis://, rediss:// and unix:// schemes.
-        if url.scheme == 'unix':
-            url_options.update({
-                'username': username,
-                'password': password,
-                'path': path,
-                'connection_class': UnixDomainSocketConnection,
-            })
-
-        elif url.scheme in ('redis', 'rediss'):
-            url_options.update({
-                'host': hostname,
-                'port': int(url.port or 6379),
-                'username': username,
-                'password': password,
-            })
-
-            # If there's a path argument, use it as the db argument if a
-            # querystring value wasn't specified
-            if 'db' not in url_options and path:
-                try:
-                    url_options['db'] = int(path.replace('/', ''))
-                except (AttributeError, ValueError):
-                    pass
-
-            if url.scheme == 'rediss':
-                url_options['connection_class'] = SSLConnection
-        else:
-            valid_schemes = ', '.join(('redis://', 'rediss://', 'unix://'))
-            raise ValueError('Redis URL must specify one of the following '
-                             'schemes (%s)' % valid_schemes)
-
-        # last shot at the db value
-        url_options['db'] = int(url_options.get('db', db or 0))
-
-        # update the arguments from the URL values
+        url_options = parse_url(url)
         kwargs.update(url_options)
-
-        # backwards compatability
-        if 'charset' in kwargs:
-            warnings.warn(DeprecationWarning(
-                '"charset" is deprecated. Use "encoding" instead'))
-            kwargs['encoding'] = kwargs.pop('charset')
-        if 'errors' in kwargs:
-            warnings.warn(DeprecationWarning(
-                '"errors" is deprecated. Use "encoding_errors" instead'))
-            kwargs['encoding_errors'] = kwargs.pop('errors')
-
         return cls(**kwargs)
 
     def __init__(self, connection_class=Connection, max_connections=None,
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index c26090b02b..7f9d05453d 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -160,7 +160,6 @@ def test_repr_contains_db_info_tcp(self):
         pool = redis.ConnectionPool(
             host='localhost',
             port=6379,
-            db=0,
             client_name='test-client'
         )
         expected = ('ConnectionPool<Connection<'
@@ -171,7 +170,6 @@ def test_repr_contains_db_info_unix(self):
         pool = redis.ConnectionPool(
             connection_class=redis.UnixDomainSocketConnection,
             path='abc',
-            db=0,
             client_name='test-client'
         )
         expected = ('ConnectionPool<UnixDomainSocketConnection<'
@@ -180,38 +178,18 @@ def test_repr_contains_db_info_unix(self):
 
 
 class TestConnectionPoolURLParsing:
-    def test_defaults(self):
-        pool = redis.ConnectionPool.from_url('redis://localhost')
-        assert pool.connection_class == redis.Connection
-        assert pool.connection_kwargs == {
-            'host': 'localhost',
-            'port': 6379,
-            'db': 0,
-            'username': None,
-            'password': None,
-        }
-
     def test_hostname(self):
-        pool = redis.ConnectionPool.from_url('redis://myhost')
+        pool = redis.ConnectionPool.from_url('redis://my.host')
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
-            'host': 'myhost',
-            'port': 6379,
-            'db': 0,
-            'username': None,
-            'password': None,
+            'host': 'my.host',
         }
 
     def test_quoted_hostname(self):
-        pool = redis.ConnectionPool.from_url('redis://my %2F host %2B%3D+',
-                                             decode_components=True)
+        pool = redis.ConnectionPool.from_url('redis://my %2F host %2B%3D+')
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
             'host': 'my / host +=+',
-            'port': 6379,
-            'db': 0,
-            'username': None,
-            'password': None,
         }
 
     def test_port(self):
@@ -220,9 +198,6 @@ def test_port(self):
         assert pool.connection_kwargs == {
             'host': 'localhost',
             'port': 6380,
-            'db': 0,
-            'username': None,
-            'password': None,
         }
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
@@ -231,24 +206,17 @@ def test_username(self):
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
             'host': 'localhost',
-            'port': 6379,
-            'db': 0,
             'username': 'myuser',
-            'password': None,
         }
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
     def test_quoted_username(self):
         pool = redis.ConnectionPool.from_url(
-            'redis://%2Fmyuser%2F%2B name%3D%24+:@localhost',
-            decode_components=True)
+            'redis://%2Fmyuser%2F%2B name%3D%24+:@localhost')
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
             'host': 'localhost',
-            'port': 6379,
-            'db': 0,
             'username': '/myuser/+ name=$+',
-            'password': None,
         }
 
     def test_password(self):
@@ -256,22 +224,15 @@ def test_password(self):
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
             'host': 'localhost',
-            'port': 6379,
-            'db': 0,
-            'username': None,
             'password': 'mypassword',
         }
 
     def test_quoted_password(self):
         pool = redis.ConnectionPool.from_url(
-            'redis://:%2Fmypass%2F%2B word%3D%24+@localhost',
-            decode_components=True)
+            'redis://:%2Fmypass%2F%2B word%3D%24+@localhost')
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
             'host': 'localhost',
-            'port': 6379,
-            'db': 0,
-            'username': None,
             'password': '/mypass/+ word=$+',
         }
 
@@ -281,44 +242,33 @@ def test_username_and_password(self):
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
             'host': 'localhost',
-            'port': 6379,
-            'db': 0,
             'username': 'myuser',
             'password': 'mypass',
         }
 
     def test_db_as_argument(self):
-        pool = redis.ConnectionPool.from_url('redis://localhost', db='1')
+        pool = redis.ConnectionPool.from_url('redis://localhost', db=1)
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
             'host': 'localhost',
-            'port': 6379,
             'db': 1,
-            'username': None,
-            'password': None,
         }
 
     def test_db_in_path(self):
-        pool = redis.ConnectionPool.from_url('redis://localhost/2', db='1')
+        pool = redis.ConnectionPool.from_url('redis://localhost/2', db=1)
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
             'host': 'localhost',
-            'port': 6379,
             'db': 2,
-            'username': None,
-            'password': None,
         }
 
     def test_db_in_querystring(self):
         pool = redis.ConnectionPool.from_url('redis://localhost/2?db=3',
-                                             db='1')
+                                             db=1)
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
             'host': 'localhost',
-            'port': 6379,
             'db': 3,
-            'username': None,
-            'password': None,
         }
 
     def test_extra_typed_querystring_options(self):
@@ -330,13 +280,10 @@ def test_extra_typed_querystring_options(self):
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
             'host': 'localhost',
-            'port': 6379,
             'db': 2,
             'socket_timeout': 20.0,
             'socket_connect_timeout': 10.0,
             'retry_on_timeout': True,
-            'username': None,
-            'password': None,
         }
         assert pool.max_connections == 10
 
@@ -359,30 +306,17 @@ def test_client_name_in_querystring(self):
         assert pool.connection_kwargs['client_name'] == 'test-client'
 
     def test_invalid_extra_typed_querystring_options(self):
-        import warnings
-        with warnings.catch_warnings(record=True) as warning_log:
+        with pytest.raises(ValueError):
             redis.ConnectionPool.from_url(
                 'redis://localhost/2?socket_timeout=_&'
                 'socket_connect_timeout=abc'
             )
-        # Compare the message values
-        assert [
-            str(m.message) for m in
-            sorted(warning_log, key=lambda l: str(l.message))
-        ] == [
-            'Invalid value for `socket_connect_timeout` in connection URL.',
-            'Invalid value for `socket_timeout` in connection URL.',
-        ]
 
     def test_extra_querystring_options(self):
         pool = redis.ConnectionPool.from_url('redis://localhost?a=1&b=2')
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
             'host': 'localhost',
-            'port': 6379,
-            'db': 0,
-            'username': None,
-            'password': None,
             'a': '1',
             'b': '2'
         }
@@ -396,10 +330,6 @@ def test_client_creates_connection_pool(self):
         assert r.connection_pool.connection_class == redis.Connection
         assert r.connection_pool.connection_kwargs == {
             'host': 'myhost',
-            'port': 6379,
-            'db': 0,
-            'username': None,
-            'password': None,
         }
 
     def test_invalid_scheme_raises_error(self):
@@ -417,9 +347,6 @@ def test_defaults(self):
         assert pool.connection_class == redis.UnixDomainSocketConnection
         assert pool.connection_kwargs == {
             'path': '/socket',
-            'db': 0,
-            'username': None,
-            'password': None,
         }
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
@@ -428,22 +355,17 @@ def test_username(self):
         assert pool.connection_class == redis.UnixDomainSocketConnection
         assert pool.connection_kwargs == {
             'path': '/socket',
-            'db': 0,
             'username': 'myuser',
-            'password': None,
         }
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
     def test_quoted_username(self):
         pool = redis.ConnectionPool.from_url(
-            'unix://%2Fmyuser%2F%2B name%3D%24+:@/socket',
-            decode_components=True)
+            'unix://%2Fmyuser%2F%2B name%3D%24+:@/socket')
         assert pool.connection_class == redis.UnixDomainSocketConnection
         assert pool.connection_kwargs == {
             'path': '/socket',
-            'db': 0,
             'username': '/myuser/+ name=$+',
-            'password': None,
         }
 
     def test_password(self):
@@ -451,32 +373,24 @@ def test_password(self):
         assert pool.connection_class == redis.UnixDomainSocketConnection
         assert pool.connection_kwargs == {
             'path': '/socket',
-            'db': 0,
-            'username': None,
             'password': 'mypassword',
         }
 
     def test_quoted_password(self):
         pool = redis.ConnectionPool.from_url(
-            'unix://:%2Fmypass%2F%2B word%3D%24+@/socket',
-            decode_components=True)
+            'unix://:%2Fmypass%2F%2B word%3D%24+@/socket')
         assert pool.connection_class == redis.UnixDomainSocketConnection
         assert pool.connection_kwargs == {
             'path': '/socket',
-            'db': 0,
-            'username': None,
             'password': '/mypass/+ word=$+',
         }
 
     def test_quoted_path(self):
         pool = redis.ConnectionPool.from_url(
-            'unix://:mypassword@/my%2Fpath%2Fto%2F..%2F+_%2B%3D%24ocket',
-            decode_components=True)
+            'unix://:mypassword@/my%2Fpath%2Fto%2F..%2F+_%2B%3D%24ocket')
         assert pool.connection_class == redis.UnixDomainSocketConnection
         assert pool.connection_kwargs == {
             'path': '/my/path/to/../+_+=$ocket',
-            'db': 0,
-            'username': None,
             'password': 'mypassword',
         }
 
@@ -486,8 +400,6 @@ def test_db_as_argument(self):
         assert pool.connection_kwargs == {
             'path': '/socket',
             'db': 1,
-            'username': None,
-            'password': None,
         }
 
     def test_db_in_querystring(self):
@@ -496,8 +408,6 @@ def test_db_in_querystring(self):
         assert pool.connection_kwargs == {
             'path': '/socket',
             'db': 2,
-            'username': None,
-            'password': None,
         }
 
     def test_client_name_in_querystring(self):
@@ -511,28 +421,20 @@ def test_extra_querystring_options(self):
         assert pool.connection_class == redis.UnixDomainSocketConnection
         assert pool.connection_kwargs == {
             'path': '/socket',
-            'db': 0,
-            'username': None,
-            'password': None,
             'a': '1',
             'b': '2'
         }
 
 
+@pytest.mark.skipif(not ssl_available, reason="SSL not installed")
 class TestSSLConnectionURLParsing:
-    @pytest.mark.skipif(not ssl_available, reason="SSL not installed")
-    def test_defaults(self):
-        pool = redis.ConnectionPool.from_url('rediss://localhost')
+    def test_host(self):
+        pool = redis.ConnectionPool.from_url('rediss://my.host')
         assert pool.connection_class == redis.SSLConnection
         assert pool.connection_kwargs == {
-            'host': 'localhost',
-            'port': 6379,
-            'db': 0,
-            'username': None,
-            'password': None,
+            'host': 'my.host',
         }
 
-    @pytest.mark.skipif(not ssl_available, reason="SSL not installed")
     def test_cert_reqs_options(self):
         import ssl
 

From f9ab1d35f8ec633a25c223ed979cef34a68072fe Mon Sep 17 00:00:00 2001
From: Tom King <tom.king2@baesystems.com>
Date: Mon, 17 Aug 2020 10:40:30 +0100
Subject: [PATCH 0086/1164] fix: Align from_url in utils.py to remove DB as a
 2nd param

---
 redis/utils.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/redis/utils.py b/redis/utils.py
index 3664708f8d..26fb002b89 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -8,7 +8,7 @@
     HIREDIS_AVAILABLE = False
 
 
-def from_url(url, db=None, **kwargs):
+def from_url(url, **kwargs):
     """
     Returns an active Redis client generated from the given database URL.
 
@@ -16,7 +16,7 @@ def from_url(url, db=None, **kwargs):
     none is provided.
     """
     from redis.client import Redis
-    return Redis.from_url(url, db, **kwargs)
+    return Redis.from_url(url, **kwargs)
 
 
 @contextmanager

From b80d423cc531c5db972d35ba72424cf9cf8772ff Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Wed, 19 Aug 2020 10:46:02 -0700
Subject: [PATCH 0087/1164] Added the ACL LOG command available in Redis 6

`acl_log()` returns a list of dictionaries, each describing a log entry.

`acl_log_reset()` instructs the server to truncate the log.

Thanks @2014BDuck
Fixes #1307
---
 CHANGES                |  2 ++
 redis/client.py        | 61 ++++++++++++++++++++++++++++++++++++++++++
 tests/conftest.py      | 29 ++++++++++++++------
 tests/test_commands.py | 44 ++++++++++++++++++++++++++++--
 4 files changed, 126 insertions(+), 10 deletions(-)

diff --git a/CHANGES b/CHANGES
index 2b7dbb8d1f..dfae2a10bc 100644
--- a/CHANGES
+++ b/CHANGES
@@ -8,6 +8,8 @@
       @abrookins. #1365
     * Added support for the LPOS command available in Redis 6.0.6. Thanks
       @aparcar #1353/#1354
+    * Added support for the ACL LOG command available in Redis 6. Thanks
+      @2014BDuck. #1307
 * 3.5.3 (June 1, 2020)
     * Restore try/except clauses to __del__ methods. These will be removed
       in 4.0 when more explicit resource management if enforced. #1339
diff --git a/redis/client.py b/redis/client.py
index 02db578878..1560c96afd 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -495,6 +495,43 @@ def parse_acl_getuser(response, **options):
     return data
 
 
+def parse_acl_log(response, **options):
+    if response is None:
+        return None
+    if isinstance(response, list):
+        data = []
+        for log in response:
+            log_data = pairs_to_dict(log, True, True)
+            client_info = log_data.get('client-info', '')
+            log_data["client-info"] = parse_client_info(client_info)
+
+            # float() is lossy comparing to the "double" in C
+            log_data["age-seconds"] = float(log_data["age-seconds"])
+            data.append(log_data)
+    else:
+        data = bool_ok(response)
+    return data
+
+
+def parse_client_info(value):
+    """
+    Parsing client-info in ACL Log in following format.
+    "key1=value1 key2=value2 key3=value3"
+    """
+    client_info = {}
+    infos = value.split(" ")
+    for info in infos:
+        key, value = info.split("=")
+        client_info[key] = value
+
+    # Those fields are definded as int in networking.c
+    for int_key in {"id", "age", "idle", "db", "sub", "psub",
+                    "multi", "qbuf", "qbuf-free", "obl",
+                    "oll", "omem"}:
+        client_info[int_key] = int(client_info[int_key])
+    return client_info
+
+
 def parse_module_result(response):
     if isinstance(response, ModuleError):
         raise response
@@ -563,6 +600,7 @@ class Redis:
         'ACL GETUSER': parse_acl_getuser,
         'ACL LIST': lambda r: list(map(str_if_bytes, r)),
         'ACL LOAD': bool_ok,
+        'ACL LOG': parse_acl_log,
         'ACL SAVE': bool_ok,
         'ACL SETUSER': bool_ok,
         'ACL USERS': lambda r: list(map(str_if_bytes, r)),
@@ -949,6 +987,29 @@ def acl_list(self):
         "Return a list of all ACLs on the server"
         return self.execute_command('ACL LIST')
 
+    def acl_log(self, count=None):
+        """
+        Get ACL logs as a list.
+        :param int count: Get logs[0:count].
+        :rtype: List.
+        """
+        args = []
+        if count is not None:
+            if not isinstance(count, int):
+                raise DataError('ACL LOG count must be an '
+                                'integer')
+            args.append(count)
+
+        return self.execute_command('ACL LOG', *args)
+
+    def acl_log_reset(self):
+        """
+        Reset ACL logs.
+        :rtype: Boolean.
+        """
+        args = [b'RESET']
+        return self.execute_command('ACL LOG', *args)
+
     def acl_load(self):
         """
         Load ACL rules from the configured ``aclfile``.
diff --git a/tests/conftest.py b/tests/conftest.py
index 26893dbd6c..cd4d4894a3 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -2,6 +2,7 @@
 import random
 import redis
 from distutils.version import StrictVersion
+from redis.connection import parse_url
 from unittest.mock import Mock
 from urllib.parse import urlparse
 
@@ -60,19 +61,31 @@ def skip_unless_arch_bits(arch_bits):
                               reason="server is not {}-bit".format(arch_bits))
 
 
-def _get_client(cls, request, single_connection_client=True, **kwargs):
+def _get_client(cls, request, single_connection_client=True, flushdb=True,
+                **kwargs):
+    """
+    Helper for fixtures or tests that need a Redis client
+
+    Uses the "--redis-url" command line argument for connection info. Unlike
+    ConnectionPool.from_url, keyword arguments to this function override
+    values specified in the URL.
+    """
     redis_url = request.config.getoption("--redis-url")
-    client = cls.from_url(redis_url, **kwargs)
+    url_options = parse_url(redis_url)
+    url_options.update(kwargs)
+    pool = redis.ConnectionPool(**url_options)
+    client = cls(connection_pool=pool)
     if single_connection_client:
         client = client.client()
     if request:
         def teardown():
-            try:
-                client.flushdb()
-            except redis.ConnectionError:
-                # handle cases where a test disconnected a client
-                # just manually retry the flushdb
-                client.flushdb()
+            if flushdb:
+                try:
+                    client.flushdb()
+                except redis.ConnectionError:
+                    # handle cases where a test disconnected a client
+                    # just manually retry the flushdb
+                    client.flushdb()
             client.close()
             client.connection_pool.disconnect()
         request.addfinalizer(teardown)
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 38e2d1a361..211307859a 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -9,8 +9,13 @@
 from redis.client import parse_info
 from redis import exceptions
 
-from .conftest import (skip_if_server_version_lt, skip_if_server_version_gte,
-                       skip_unless_arch_bits, REDIS_6_VERSION)
+from .conftest import (
+    _get_client,
+    REDIS_6_VERSION,
+    skip_if_server_version_gte,
+    skip_if_server_version_lt,
+    skip_unless_arch_bits,
+)
 
 
 @pytest.fixture()
@@ -193,6 +198,41 @@ def teardown():
         users = r.acl_list()
         assert 'user %s off -@all' % username in users
 
+    @skip_if_server_version_lt(REDIS_6_VERSION)
+    def test_acl_log(self, r, request):
+        username = 'redis-py-user'
+
+        def teardown():
+            r.acl_deluser(username)
+
+        request.addfinalizer(teardown)
+        r.acl_setuser(username, enabled=True, reset=True,
+                      commands=['+get', '+set', '+select'],
+                      keys=['cache:*'], nopass=True)
+        r.acl_log_reset()
+
+        user_client = _get_client(redis.Redis, request, flushdb=False,
+                                  username=username)
+
+        # Valid operation and key
+        assert user_client.set('cache:0', 1)
+        assert user_client.get('cache:0') == b'1'
+
+        # Invalid key
+        with pytest.raises(exceptions.NoPermissionError):
+            user_client.get('violated_cache:0')
+
+        # Invalid operation
+        with pytest.raises(exceptions.NoPermissionError):
+            user_client.hset('cache:0', 'hkey', 'hval')
+
+        assert isinstance(r.acl_log(), list)
+        assert len(r.acl_log()) == 2
+        assert len(r.acl_log(count=1)) == 1
+        assert isinstance(r.acl_log()[0], dict)
+        assert 'client-info' in r.acl_log(count=1)[0]
+        assert r.acl_log_reset()
+
     @skip_if_server_version_lt(REDIS_6_VERSION)
     def test_acl_setuser_categories_without_prefix_fails(self, r, request):
         username = 'redis-py-user'

From 5a6a50b50db26e4b1c4b7a6cb9b2a2caa8ba5e8b Mon Sep 17 00:00:00 2001
From: ryuichi1208 <ryucrosskey@gmail.com>
Date: Mon, 24 Aug 2020 23:18:46 +0900
Subject: [PATCH 0088/1164] Fix Dockerfile (cache clear of apt)

---
 Dockerfile | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/Dockerfile b/Dockerfile
index eba66f09ed..2ceb725d47 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -1,6 +1,8 @@
 FROM fkrull/multi-python:latest
 
-RUN apt update && apt install -y pypy pypy-dev pypy3-dev
+RUN apt update \
+    && apt install -y pypy pypy-dev pypy3-dev \
+    && rm -rf /var/lib/apt/lists/*
 
 WORKDIR /redis-py
 

From 356da7f042d70b4b7d3808b0900c8bd1cdbac225 Mon Sep 17 00:00:00 2001
From: 2014bduck <2014bduck@gmail.com>
Date: Fri, 4 Sep 2020 06:19:43 +0800
Subject: [PATCH 0089/1164] Fixing #1390 modules key in info command (#1393)

When modules are present, INFO's response will contain a `modules` key which will be a list of dicts describing each module.

Co-authored-by: jiekun.zhu <jiekun.zhu@shopee.com>
---
 redis/client.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/redis/client.py b/redis/client.py
index 1560c96afd..42d1bfaa53 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -141,7 +141,13 @@ def get_value(value):
                 key, value = line.split(':', 1)
                 if key == 'cmdstat_host':
                     key, value = line.rsplit(':', 1)
-                info[key] = get_value(value)
+
+                if key == 'module':
+                    # Hardcode a list for key 'modules' since there could be
+                    # multiple lines that started with 'module'
+                    info.setdefault('modules', []).append(get_value(value))
+                else:
+                    info[key] = get_value(value)
             else:
                 # if the line isn't splittable, append it to the "__raw__" key
                 info.setdefault('__raw__', []).append(line)

From 686116d5c740b0ba89e031ca09c5704af5076fd8 Mon Sep 17 00:00:00 2001
From: Roey Prat <roey.prat@redislabs.com>
Date: Thu, 3 Sep 2020 16:16:20 +0300
Subject: [PATCH 0090/1164] develop and test against redis version 6.0.7

---
 docker/base/Dockerfile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docker/base/Dockerfile b/docker/base/Dockerfile
index 8e952b8e4d..a902e2d709 100644
--- a/docker/base/Dockerfile
+++ b/docker/base/Dockerfile
@@ -1 +1 @@
-FROM redis:6.0.6-buster
+FROM redis:6.0.7-buster

From ce88fcae9a4371b4595e45c7a037069245d3313a Mon Sep 17 00:00:00 2001
From: Roey Prat <roey.prat@redislabs.com>
Date: Tue, 15 Sep 2020 11:55:20 +0300
Subject: [PATCH 0091/1164] develop and test against redis version 6.0.8

---
 docker/base/Dockerfile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docker/base/Dockerfile b/docker/base/Dockerfile
index a902e2d709..d8811ba92f 100644
--- a/docker/base/Dockerfile
+++ b/docker/base/Dockerfile
@@ -1 +1 @@
-FROM redis:6.0.7-buster
+FROM redis:6.0.8-buster

From e4067e8b4441b512cab35039e41160b8a6e3c462 Mon Sep 17 00:00:00 2001
From: Yann <54660067+y4nr1@users.noreply.github.com>
Date: Wed, 16 Sep 2020 16:32:30 -0700
Subject: [PATCH 0092/1164] Update docs with info about SSL hostname validation

---
 README.rst | 41 ++++++++++++++++++++++++++++++++++++++---
 1 file changed, 38 insertions(+), 3 deletions(-)

diff --git a/README.rst b/README.rst
index 438e33e513..778129328a 100644
--- a/README.rst
+++ b/README.rst
@@ -129,8 +129,43 @@ this will cause redis-py 3.0 to raise a ConnectionError.
 This check can be disabled by setting `ssl_cert_reqs` to `None`. Note that
 doing so removes the security check. Do so at your own risk.
 
-It has been reported that SSL certs received from AWS ElastiCache do not have
-proper hostnames and turning off hostname verification is currently required.
+Example with hostname verification using a local certificate bundle (linux):
+
+.. code-block:: pycon
+
+    >>> import redis
+    >>> r = redis.Redis(host='xxxxxx.cache.amazonaws.com', port=6379, db=0,
+                        ssl=True,
+                        ssl_ca_certs='/etc/ssl/certs/ca-certificates.crt')
+    >>> r.set('foo', 'bar')
+    True
+    >>> r.get('foo')
+    b'bar'
+
+Example with hostname verification using
+`certifi <https://pypi.org/project/certifi/>`_:
+
+.. code-block:: pycon
+
+    >>> import redis, certifi
+    >>> r = redis.Redis(host='xxxxxx.cache.amazonaws.com', port=6379, db=0,
+                        ssl=True, ssl_ca_certs=certifi.where())
+    >>> r.set('foo', 'bar')
+    True
+    >>> r.get('foo')
+    b'bar'
+
+Example turning off hostname verification (not recommended):
+
+.. code-block:: pycon
+
+    >>> import redis
+    >>> r = redis.Redis(host='xxxxxx.cache.amazonaws.com', port=6379, db=0,
+                        ssl=True, ssl_cert_reqs=None)
+    >>> r.set('foo', 'bar')
+    True
+    >>> r.get('foo')
+    b'bar'
 
 
 MSET, MSETNX and ZADD
@@ -150,7 +185,7 @@ dict is a mapping of element-names -> score.
 
 MSET, MSETNX and ZADD now look like:
 
-.. code-block:: python
+.. code-block:: pycon
 
     def mset(self, mapping):
     def msetnx(self, mapping):

From e635130043d7657d9bee6911995f649e2de9eb04 Mon Sep 17 00:00:00 2001
From: Jack Edge <yellowbounder@gmail.com>
Date: Thu, 24 Sep 2020 15:34:19 +0100
Subject: [PATCH 0093/1164] =?UTF-8?q?=F0=9F=95=B0=EF=B8=8F=20Use=20monoton?=
 =?UTF-8?q?ic=20clock=20in=20Lock=20(and=20tests)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

During a call to `acquire()`, if the call is `blocking` and has a
`blocking_timeout` set, it uses `time.time()` calls to determine when to
give up attempting to acquire the lock.

However, since `time.time()` is marked as "adjustable", it is possible
for it to go backwards or forwards at a rate other than 1 second per
second, meaning the spinloop may exit earlier or later than expected.

By changing the implementation to use `time.monotonic()`, which is
guaranteed to never go backwards, and not be affected by system clock
updates, this potential problem is fixed.

For the same reason, some time dependent lock tests have also been
changed to use `time.monotonic()`.
---
 redis/lock.py      | 4 ++--
 tests/test_lock.py | 8 ++++----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/redis/lock.py b/redis/lock.py
index e51f169695..e36b2da956 100644
--- a/redis/lock.py
+++ b/redis/lock.py
@@ -186,14 +186,14 @@ def acquire(self, blocking=None, blocking_timeout=None, token=None):
             blocking_timeout = self.blocking_timeout
         stop_trying_at = None
         if blocking_timeout is not None:
-            stop_trying_at = mod_time.time() + blocking_timeout
+            stop_trying_at = mod_time.monotonic() + blocking_timeout
         while True:
             if self.do_acquire(token):
                 self.local.token = token
                 return True
             if not blocking:
                 return False
-            next_try_at = mod_time.time() + sleep
+            next_try_at = mod_time.monotonic() + sleep
             if stop_trying_at is not None and next_try_at > stop_trying_at:
                 return False
             mod_time.sleep(sleep)
diff --git a/tests/test_lock.py b/tests/test_lock.py
index 8bb3c7e80a..fa76385221 100644
--- a/tests/test_lock.py
+++ b/tests/test_lock.py
@@ -101,10 +101,10 @@ def test_blocking_timeout(self, r):
         bt = 0.2
         sleep = 0.05
         lock2 = self.get_lock(r, 'foo', sleep=sleep, blocking_timeout=bt)
-        start = time.time()
+        start = time.monotonic()
         assert not lock2.acquire()
         # The elapsed duration should be less than the total blocking_timeout
-        assert bt > (time.time() - start) > bt - sleep
+        assert bt > (time.monotonic() - start) > bt - sleep
         lock1.release()
 
     def test_context_manager(self, r):
@@ -126,11 +126,11 @@ def test_high_sleep_small_blocking_timeout(self, r):
         sleep = 60
         bt = 1
         lock2 = self.get_lock(r, 'foo', sleep=sleep, blocking_timeout=bt)
-        start = time.time()
+        start = time.monotonic()
         assert not lock2.acquire()
         # the elapsed timed is less than the blocking_timeout as the lock is
         # unattainable given the sleep/blocking_timeout configuration
-        assert bt > (time.time() - start)
+        assert bt > (time.monotonic() - start)
         lock1.release()
 
     def test_releasing_unlocked_lock_raises_error(self, r):

From 15dafb1414f05ce24ef336fc539e06ad6a2b3d19 Mon Sep 17 00:00:00 2001
From: Brad Solomon <brad.solomon.1124@gmail.com>
Date: Fri, 10 May 2019 10:12:51 -0400
Subject: [PATCH 0094/1164] Note that redis-py does not support Cluster Mode

---
 README.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.rst b/README.rst
index 778129328a..fccea62440 100644
--- a/README.rst
+++ b/README.rst
@@ -921,6 +921,12 @@ that return Python iterators for convenience: `scan_iter`, `hscan_iter`,
     B 2
     C 3
 
+Cluster Mode
+^^^^^^^^^^^^
+
+redis-py does not currently support `Cluster Mode
+<https://redis.io/topics/cluster-tutorial>`_.
+
 Author
 ^^^^^^
 

From a404ad3dee93b3b0deb90b4075fd28734d78a282 Mon Sep 17 00:00:00 2001
From: Abhimanyu Deora <abhikdeora@gmail.com>
Date: Mon, 26 Oct 2020 11:16:23 -0500
Subject: [PATCH 0095/1164] Add optional exception handler to
 PubSubWorkerThread (#1395)

Add optional exception handler to PubSubWorkerThread

Co-authored-by: Abhimanyu Deora <adeora@drwholdings.com>
---
 README.rst           | 14 ++++++++++++++
 redis/client.py      | 23 ++++++++++++++++++-----
 tests/test_pubsub.py | 24 ++++++++++++++++++++++++
 3 files changed, 56 insertions(+), 5 deletions(-)

diff --git a/README.rst b/README.rst
index fccea62440..389d5b478c 100644
--- a/README.rst
+++ b/README.rst
@@ -732,6 +732,20 @@ subscribed to patterns or channels that don't have message handlers attached.
     # when it's time to shut it down...
     >>> thread.stop()
 
+`run_in_thread` also supports an optional exception handler, which lets you
+catch exceptions that occur within the worker thread and handle them
+appropriately. The exception handler will take as arguments the exception
+itself, the pubsub object, and the worker thread returned by `run_in_thread`.
+
+.. code-block:: pycon
+    >>> p.subscribe(**{'my-channel': my_handler})
+    >>> def exception_handler(ex, pubsub, thread):
+    >>>     print(ex)
+    >>>     thread.stop()
+    >>>     thread.join(timeout=1.0)
+    >>>     pubsub.close()
+    >>> thread = p.run_in_thread(exception_handler=exception_handler)
+
 A PubSub object adheres to the same encoding semantics as the client instance
 it was created from. Any channel or pattern that's unicode will be encoded
 using the `charset` specified on the client before being sent to Redis. If the
diff --git a/redis/client.py b/redis/client.py
index 42d1bfaa53..08b03145c5 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -3803,7 +3803,8 @@ def handle_message(self, response, ignore_subscribe_messages=False):
 
         return message
 
-    def run_in_thread(self, sleep_time=0, daemon=False):
+    def run_in_thread(self, sleep_time=0, daemon=False,
+                      exception_handler=None):
         for channel, handler in self.channels.items():
             if handler is None:
                 raise PubSubError("Channel: '%s' has no handler registered" %
@@ -3813,17 +3814,24 @@ def run_in_thread(self, sleep_time=0, daemon=False):
                 raise PubSubError("Pattern: '%s' has no handler registered" %
                                   pattern)
 
-        thread = PubSubWorkerThread(self, sleep_time, daemon=daemon)
+        thread = PubSubWorkerThread(
+            self,
+            sleep_time,
+            daemon=daemon,
+            exception_handler=exception_handler
+        )
         thread.start()
         return thread
 
 
 class PubSubWorkerThread(threading.Thread):
-    def __init__(self, pubsub, sleep_time, daemon=False):
+    def __init__(self, pubsub, sleep_time, daemon=False,
+                 exception_handler=None):
         super().__init__()
         self.daemon = daemon
         self.pubsub = pubsub
         self.sleep_time = sleep_time
+        self.exception_handler = exception_handler
         self._running = threading.Event()
 
     def run(self):
@@ -3833,8 +3841,13 @@ def run(self):
         pubsub = self.pubsub
         sleep_time = self.sleep_time
         while self._running.is_set():
-            pubsub.get_message(ignore_subscribe_messages=True,
-                               timeout=sleep_time)
+            try:
+                pubsub.get_message(ignore_subscribe_messages=True,
+                                   timeout=sleep_time)
+            except BaseException as e:
+                if self.exception_handler is None:
+                    raise
+                self.exception_handler(e, pubsub, self)
         pubsub.close()
 
     def stop(self):
diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index ab9f09c84e..abeaecba38 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -1,6 +1,9 @@
 import pytest
+import threading
 import time
 
+from unittest import mock
+
 import redis
 from redis.exceptions import ConnectionError
 
@@ -543,3 +546,24 @@ def test_get_message_with_timeout_returns_none(self, r):
         p.subscribe('foo')
         assert wait_for_message(p) == make_message('subscribe', 'foo', 1)
         assert p.get_message(timeout=0.01) is None
+
+
+class TestPubSubWorkerThread:
+    def test_pubsub_worker_thread_exception_handler(self, r):
+        event = threading.Event()
+
+        def exception_handler(ex, pubsub, thread):
+            thread.stop()
+            event.set()
+
+        p = r.pubsub()
+        p.subscribe(**{'foo': lambda m: m})
+        with mock.patch.object(p, 'get_message',
+                               side_effect=Exception('error')):
+            pubsub_thread = p.run_in_thread(
+                exception_handler=exception_handler
+            )
+
+        assert event.wait(timeout=1.0)
+        pubsub_thread.join(timeout=1.0)
+        assert not pubsub_thread.is_alive()

From 66973e4e6cdeb9bc7d71966ca14717a1bdbddec2 Mon Sep 17 00:00:00 2001
From: Roey Prat <roey.prat@redislabs.com>
Date: Wed, 28 Oct 2020 09:54:13 +0200
Subject: [PATCH 0096/1164] develop and test against redis version 6.0.9

---
 docker/base/Dockerfile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docker/base/Dockerfile b/docker/base/Dockerfile
index d8811ba92f..003eac1f89 100644
--- a/docker/base/Dockerfile
+++ b/docker/base/Dockerfile
@@ -1 +1 @@
-FROM redis:6.0.8-buster
+FROM redis:6.0.9-buster

From 1345dc48874e10d895e87ddbaba3f8b6e679d833 Mon Sep 17 00:00:00 2001
From: Felipe Machado <462154+felipou@users.noreply.github.com>
Date: Mon, 9 Nov 2020 05:07:45 -0300
Subject: [PATCH 0097/1164] Add more documentation about encoding of strings
 (#1417)

Additional docs about string encoding/decoding
---
 README.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.rst b/README.rst
index 389d5b478c..a4b6e167b3 100644
--- a/README.rst
+++ b/README.rst
@@ -75,6 +75,12 @@ specify `decode_responses=True` to `Redis.__init__`. In this case, any
 Redis command that returns a string type will be decoded with the `encoding`
 specified.
 
+The default encoding is "utf-8", but this can be customized with the `encoding`
+argument to the `redis.Redis` class. The `encoding` will be used to
+automatically encode any strings passed to commands, such as key names and
+values. When `decode_responses=True`, string data returned from commands
+will be decoded with the same `encoding`.
+
 
 Upgrading from redis-py 2.X to 3.0
 ----------------------------------

From 8c176cdc7f36e2cbcd3254768766035a7b7cd8b3 Mon Sep 17 00:00:00 2001
From: Guy Korland <gkorland@gmail.com>
Date: Mon, 9 Nov 2020 10:08:31 +0200
Subject: [PATCH 0098/1164] Sponsored (#1418)

Add note that redis-py is sponsored by Redis Labs
---
 README.rst              |   8 ++++++++
 docs/logo-redislabs.png | Bin 0 -> 18950 bytes
 2 files changed, 8 insertions(+)
 create mode 100644 docs/logo-redislabs.png

diff --git a/README.rst b/README.rst
index a4b6e167b3..b71c760300 100644
--- a/README.rst
+++ b/README.rst
@@ -959,3 +959,11 @@ Special thanks to:
   which some of the socket code is still used.
 * Alexander Solovyov for ideas on the generic response callback system.
 * Paul Hubbard for initial packaging support.
+
+
+Sponsored by
+^^^^^^^^^^^^
+
+.. image:: ./docs/logo-redislabs.png
+   :alt: RedisLabs
+   :target: https://www.redislabs.com
diff --git a/docs/logo-redislabs.png b/docs/logo-redislabs.png
new file mode 100644
index 0000000000000000000000000000000000000000..cde2d399e2851864d23803279a0939a499a10cea
GIT binary patch
literal 18950
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
Hu0mjfT62NL

literal 0
HcmV?d00001


From 1a41cfd95a53a95b078084d8627be6b6fba3bb71 Mon Sep 17 00:00:00 2001
From: Simon Charette <charettes@users.noreply.github.com>
Date: Sun, 22 Nov 2020 15:52:44 -0500
Subject: [PATCH 0099/1164] Add support for the ABSTTL option of the RESTORE
 command. (#1423)

Add support for the ABSTTL option of the RESTORE command.
---
 CHANGES                |  2 ++
 redis/client.py        | 11 ++++++++++-
 tests/test_commands.py | 13 +++++++++++++
 3 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/CHANGES b/CHANGES
index dfae2a10bc..f4974b8299 100644
--- a/CHANGES
+++ b/CHANGES
@@ -10,6 +10,8 @@
       @aparcar #1353/#1354
     * Added support for the ACL LOG command available in Redis 6. Thanks
       @2014BDuck. #1307
+    * Added support for ABSTTL option of the RESTORE command available in
+      Redis 5.0. Thanks @charettes. #1423
 * 3.5.3 (June 1, 2020)
     * Restore try/except clauses to __del__ methods. These will be removed
       in 4.0 when more explicit resource management if enforced. #1339
diff --git a/redis/client.py b/redis/client.py
index 08b03145c5..18553b96ec 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1811,14 +1811,23 @@ def renamenx(self, src, dst):
         "Rename key ``src`` to ``dst`` if ``dst`` doesn't already exist"
         return self.execute_command('RENAMENX', src, dst)
 
-    def restore(self, name, ttl, value, replace=False):
+    def restore(self, name, ttl, value, replace=False, absttl=False):
         """
         Create a key using the provided serialized value, previously obtained
         using DUMP.
+
+        ``replace`` allows an existing key on ``name`` to be overridden. If
+        it's not specified an error is raised on collision.
+
+        ``absttl`` if True, specified ``ttl`` should represent an absolute Unix
+        timestamp in milliseconds in which the key will expire. (Redis 5.0 or
+        greater).
         """
         params = [name, ttl, value]
         if replace:
             params.append('REPLACE')
+        if absttl:
+            params.append('ABSTTL')
         return self.execute_command('RESTORE', *params)
 
     def set(self, name, value,
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 211307859a..d1f85b7306 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -642,6 +642,19 @@ def test_dump_and_restore_and_replace(self, r):
         r.restore('a', 0, dumped, replace=True)
         assert r['a'] == b'bar'
 
+    @skip_if_server_version_lt('5.0.0')
+    def test_dump_and_restore_absttl(self, r):
+        r['a'] = 'foo'
+        dumped = r.dump('a')
+        del r['a']
+        ttl = int(
+            (redis_server_time(r) + datetime.timedelta(minutes=1)).timestamp()
+            * 1000
+        )
+        r.restore('a', ttl, dumped, absttl=True)
+        assert r['a'] == b'foo'
+        assert 0 < r.ttl('a') <= 61
+
     def test_exists(self, r):
         assert r.exists('a') == 0
         r['a'] = 'foo'

From c7e26ae6749f63b9ebf65c023f270b2ea2b9536a Mon Sep 17 00:00:00 2001
From: alxasfuck <a.fittkau@posteo.de>
Date: Wed, 12 May 2021 23:52:01 +0200
Subject: [PATCH 0100/1164] Remove blocking behaviour from context manager
 __enter__

---
 redis/lock.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/redis/lock.py b/redis/lock.py
index e36b2da956..326dbaf98e 100644
--- a/redis/lock.py
+++ b/redis/lock.py
@@ -149,9 +149,7 @@ def register_scripts(self):
                 client.register_script(cls.LUA_REACQUIRE_SCRIPT)
 
     def __enter__(self):
-        # force blocking, as otherwise the user would have to check whether
-        # the lock was actually acquired or not.
-        if self.acquire(blocking=True):
+        if self.acquire():
             return self
         raise LockError("Unable to acquire lock within the time specified")
 

From bc5854217b4e94eb7a33e3da5738858a17135ca5 Mon Sep 17 00:00:00 2001
From: Ian Bucad <ian.bucad@datadoghq.com>
Date: Thu, 15 Apr 2021 15:30:29 +1000
Subject: [PATCH 0101/1164] Return index 4 as the command if not a list command
 is always a list. If index 3 is not a list, assume Redis Enterprise and
 return index 4 instead

---
 redis/client.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/redis/client.py b/redis/client.py
index 18553b96ec..59575cd835 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -404,7 +404,12 @@ def parse_slowlog_get(response, **options):
         'id': item[0],
         'start_time': int(item[1]),
         'duration': int(item[2]),
-        'command': space.join(item[3])
+        'command':
+            # Redis Enterprise injects another entry at index [3], which has
+            # the complexity info (i.e. the value N in case the command has
+            # an O(N) complexity) instead of the command.
+            space.join(item[3]) if isinstance(item[3], list) else
+            space.join(item[4])
     } for item in response]
 
 

From ed8c2df14abf166cdb7e1a8bc80c675cf684eeb0 Mon Sep 17 00:00:00 2001
From: Roey Prat <roey.prat@redislabs.com>
Date: Mon, 9 Nov 2020 18:20:40 +0200
Subject: [PATCH 0102/1164] use github actions instead of travis-CI

---
 .github/PULL_REQUEST_TEMPLATE.md   |  2 +-
 .github/workflows/integration.yaml | 15 +++++++++++++++
 .travis.yml                        | 14 --------------
 README.rst                         |  4 ++--
 docker-compose.yml                 | 10 +---------
 docker-entry.sh                    |  2 +-
 tox.ini                            |  3 +--
 7 files changed, 21 insertions(+), 29 deletions(-)
 create mode 100644 .github/workflows/integration.yaml
 delete mode 100644 .travis.yml

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index 3b8e7ba628..2bbc804d08 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -3,7 +3,7 @@
 _Please make sure to review and check all of these items:_
 
 - [ ] Does `$ tox` pass with this change (including linting)?
-- [ ] Does travis tests pass with this change (enable it first in your forked repo and wait for the travis build to finish)?
+- [ ] Do the CI tests pass with this change (enable it first in your forked repo and wait for the github action build to finish)?
 - [ ] Is the new or changed code fully tested?
 - [ ] Is a documentation update included (if this change modifies existing APIs, or introduces new ones)?
 
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
new file mode 100644
index 0000000000..8cb4af92c0
--- /dev/null
+++ b/.github/workflows/integration.yaml
@@ -0,0 +1,15 @@
+name: CI
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  integration:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: test
+        run: make test
diff --git a/.travis.yml b/.travis.yml
deleted file mode 100644
index 4b09cfcced..0000000000
--- a/.travis.yml
+++ /dev/null
@@ -1,14 +0,0 @@
-env:
-  - DOCKER_COMPOSE_VERSION=1.26.2
-
-before_install:
-  - sudo rm /usr/local/bin/docker-compose
-  - curl -L https://github.com/docker/compose/releases/download/${DOCKER_COMPOSE_VERSION}/docker-compose-`uname -s`-`uname -m` > docker-compose
-  - chmod +x docker-compose
-  - sudo mv docker-compose /usr/local/bin
-
-services:
-  - docker
-
-script:
-  - make test
diff --git a/README.rst b/README.rst
index b71c760300..43a7de034a 100644
--- a/README.rst
+++ b/README.rst
@@ -3,8 +3,8 @@ redis-py
 
 The Python interface to the Redis key-value store.
 
-.. image:: https://secure.travis-ci.org/andymccurdy/redis-py.svg?branch=master
-        :target: https://travis-ci.org/andymccurdy/redis-py
+.. image:: https://github.com/andymccurdy/redis-py/workflows/CI/badge.svg?branch=master
+        :target: https://github.com/andymccurdy/redis-py/actions?query=workflow%3ACI+branch%3Amaster
 .. image:: https://readthedocs.org/projects/redis-py/badge/?version=stable&style=flat
         :target: https://redis-py.readthedocs.io/en/stable/
 .. image:: https://badge.fury.io/py/redis.svg
diff --git a/docker-compose.yml b/docker-compose.yml
index 247688ad8c..103a51b19c 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -50,15 +50,7 @@ services:
       CODECOV_TOKEN:
       CODECOV_URL:
       SHIPPABLE:
-      TRAVIS:
-      TRAVIS_BRANCH:
-      TRAVIS_COMMIT:
-      TRAVIS_JOB_ID:
-      TRAVIS_JOB_NUMBER:
-      TRAVIS_OS_NAME:
-      TRAVIS_PULL_REQUEST:
-      TRAVIS_REPO_SLUG:
-      TRAVIS_TAG:
+      GITHUB_ACTIONS:
       VCS_BRANCH_NAME:
       VCS_COMMIT_ID:
       VCS_PULL_REQUEST:
diff --git a/docker-entry.sh b/docker-entry.sh
index f63a8c5f14..dc119dcdd8 100755
--- a/docker-entry.sh
+++ b/docker-entry.sh
@@ -9,7 +9,7 @@ REDIS_MASTER="${REDIS_MASTER_HOST}":"${REDIS_MASTER_PORT}"
 echo "Testing against Redis Server: ${REDIS_MASTER}"
 
 # skip the "codecov" env if not running on Travis
-if [ -z ${TRAVIS-} ]; then
+if [ "${GITHUB_ACTIONS}" = true ] ; then
     echo "Skipping codecov"
     export TOX_SKIP_ENV="codecov"
 fi
diff --git a/tox.ini b/tox.ini
index c783bf06b8..19f9aadd87 100644
--- a/tox.ini
+++ b/tox.ini
@@ -43,8 +43,7 @@ passenv =
   CI_*
   CODECOV_*
   SHIPPABLE
-  TRAVIS
-  TRAVIS_*
+  GITHUB_*
   VCS_*
 
 [testenv:covreport]

From b25cc4ea905c0f01621826b3a7821970fdb313b8 Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Wed, 30 Jun 2021 16:12:44 -0700
Subject: [PATCH 0103/1164] daemonize the thread to see if the tests will
 continue

---
 tests/test_pubsub.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index abeaecba38..17a1621ca3 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -1,14 +1,12 @@
-import pytest
 import threading
 import time
-
 from unittest import mock
 
+import pytest
 import redis
 from redis.exceptions import ConnectionError
 
-from .conftest import _get_client
-from .conftest import skip_if_server_version_lt
+from .conftest import _get_client, skip_if_server_version_lt
 
 
 def wait_for_message(pubsub, timeout=0.1, ignore_subscribe_messages=False):
@@ -561,6 +559,7 @@ def exception_handler(ex, pubsub, thread):
         with mock.patch.object(p, 'get_message',
                                side_effect=Exception('error')):
             pubsub_thread = p.run_in_thread(
+                daemon=True,
                 exception_handler=exception_handler
             )
 

From fc621bd1b4de35fa088f87895e5fa1ade6a9150c Mon Sep 17 00:00:00 2001
From: Andy McCurdy <andy@andymccurdy.com>
Date: Wed, 30 Jun 2021 16:14:26 -0700
Subject: [PATCH 0104/1164] run CI on all branches

---
 .github/workflows/integration.yaml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 8cb4af92c0..f08a2c238f 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -2,9 +2,7 @@ name: CI
 
 on:
   push:
-    branches: [ master ]
   pull_request:
-    branches: [ master ]
 
 jobs:
   integration:

From cb97b9bdd47bf5a92f4efa88e52591344a08b98e Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 15 Jul 2021 08:57:41 +0300
Subject: [PATCH 0105/1164] changing unit tests to account for defaults in
 redis flags (#1499)

Co-authored-by: Andy McCurdy <andy@andymccurdy.com>
---
 tests/test_commands.py | 37 ++++++++++++++++++-------------------
 tests/test_pubsub.py   |  4 ++++
 tox.ini                |  2 +-
 3 files changed, 23 insertions(+), 20 deletions(-)

diff --git a/tests/test_commands.py b/tests/test_commands.py
index d1f85b7306..2da4a89e63 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -108,25 +108,24 @@ def teardown():
 
         # test enabled=False
         assert r.acl_setuser(username, enabled=False, reset=True)
-        assert r.acl_getuser(username) == {
-            'categories': ['-@all'],
-            'commands': [],
-            'enabled': False,
-            'flags': ['off'],
-            'keys': [],
-            'passwords': [],
-        }
+        acl = r.acl_getuser(username)
+        assert acl['categories'] == ['-@all']
+        assert acl['commands'] == []
+        assert acl['keys'] == []
+        assert acl['passwords'] == []
+        assert 'off' in acl['flags']
+        assert acl['enabled'] is False
 
         # test nopass=True
         assert r.acl_setuser(username, enabled=True, reset=True, nopass=True)
-        assert r.acl_getuser(username) == {
-            'categories': ['-@all'],
-            'commands': [],
-            'enabled': True,
-            'flags': ['on', 'nopass'],
-            'keys': [],
-            'passwords': [],
-        }
+        acl = r.acl_getuser(username)
+        assert acl['categories'] == ['-@all']
+        assert acl['commands'] == []
+        assert acl['keys'] == []
+        assert acl['passwords'] == []
+        assert 'on' in acl['flags']
+        assert 'nopass' in acl['flags']
+        assert acl['enabled'] is True
 
         # test all args
         assert r.acl_setuser(username, enabled=True, reset=True,
@@ -138,7 +137,7 @@ def teardown():
         assert set(acl['categories']) == set(['-@all', '+@set', '+@hash'])
         assert set(acl['commands']) == set(['+get', '+mget', '-hset'])
         assert acl['enabled'] is True
-        assert acl['flags'] == ['on']
+        assert 'on' in acl['flags']
         assert set(acl['keys']) == set([b'cache:*', b'objects:*'])
         assert len(acl['passwords']) == 2
 
@@ -157,7 +156,7 @@ def teardown():
         assert set(acl['categories']) == set(['-@all', '+@set', '+@hash'])
         assert set(acl['commands']) == set(['+get', '+mget'])
         assert acl['enabled'] is True
-        assert acl['flags'] == ['on']
+        assert 'on' in acl['flags']
         assert set(acl['keys']) == set([b'cache:*', b'objects:*'])
         assert len(acl['passwords']) == 2
 
@@ -196,7 +195,7 @@ def teardown():
 
         assert r.acl_setuser(username, enabled=False, reset=True)
         users = r.acl_list()
-        assert 'user %s off -@all' % username in users
+        assert len(users) == 2
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
     def test_acl_log(self, r, request):
diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index 17a1621ca3..6a4f0aafa4 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -1,6 +1,7 @@
 import threading
 import time
 from unittest import mock
+import platform
 
 import pytest
 import redis
@@ -547,6 +548,9 @@ def test_get_message_with_timeout_returns_none(self, r):
 
 
 class TestPubSubWorkerThread:
+
+    @pytest.mark.skipif(platform.python_implementation() == 'PyPy',
+                        reason="Pypy threading issue")
     def test_pubsub_worker_thread_exception_handler(self, r):
         event = threading.Event()
 
diff --git a/tox.ini b/tox.ini
index 19f9aadd87..db7492d18e 100644
--- a/tox.ini
+++ b/tox.ini
@@ -3,7 +3,7 @@ addopts = -s
 
 [tox]
 minversion = 2.4
-envlist = {py35,py36,py37,py38,pypy3}-{plain,hiredis}, flake8, covreport, codecov
+envlist = {py35,py36,py37,py38,py39,pypy3}-{plain,hiredis}, flake8, covreport, codecov
 
 [testenv]
 deps =

From 9ce7bb2858065c0dc5ac91287b8716def9919291 Mon Sep 17 00:00:00 2001
From: malinaa96 <52569986+malinaa96@users.noreply.github.com>
Date: Tue, 20 Jul 2021 07:44:56 +0200
Subject: [PATCH 0106/1164] Add support for COPY command new in Redis 6.2
 (#1492)

---
 redis/client.py        | 20 +++++++++++++++++++-
 tests/test_commands.py | 23 +++++++++++++++++++++++
 2 files changed, 42 insertions(+), 1 deletion(-)

diff --git a/redis/client.py b/redis/client.py
index 59575cd835..72178f3068 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -561,7 +561,7 @@ class Redis:
     """
     RESPONSE_CALLBACKS = {
         **string_keys_to_dict(
-            'AUTH EXPIRE EXPIREAT HEXISTS HMSET MOVE MSETNX PERSIST '
+            'AUTH COPY EXPIRE EXPIREAT HEXISTS HMSET MOVE MSETNX PERSIST '
             'PSETEX RENAMENX SISMEMBER SMOVE SETEX SETNX',
             bool
         ),
@@ -1612,6 +1612,24 @@ def bitpos(self, key, bit, start=None, end=None):
                             "when end is specified")
         return self.execute_command('BITPOS', *params)
 
+    def copy(self, source, destination, destination_db=None, replace=False):
+        """
+        Copy the value stored in the ``source`` key to the ``destination`` key.
+
+        ``destination_db`` an alternative destination database. By default,
+        the ``destination`` key is created in the source Redis database.
+
+        ``replace`` whether the ``destination`` key should be removed before
+        copying the value to it. By default, the value is not copied if
+        the ``destination`` key already exists.
+        """
+        params = [source, destination]
+        if destination_db is not None:
+            params.extend(["DB", destination_db])
+        if replace:
+            params.append("REPLACE")
+        return self.execute_command('COPY', *params)
+
     def decr(self, name, amount=1):
         """
         Decrements the value of ``key`` by ``amount``.  If no key exists,
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 2da4a89e63..a5a7e45e2f 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -578,6 +578,29 @@ def test_bitpos_wrong_arguments(self, r):
         with pytest.raises(exceptions.RedisError):
             r.bitpos(key, 7) == 12
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_copy(self, r):
+        assert r.copy("a", "b") == 0
+        r.set("a", "foo")
+        assert r.copy("a", "b") == 1
+        assert r.get("a") == b"foo"
+        assert r.get("b") == b"foo"
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_copy_and_replace(self, r):
+        r.set("a", "foo1")
+        r.set("b", "foo2")
+        assert r.copy("a", "b") == 0
+        assert r.copy("a", "b", replace=True) == 1
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_copy_to_another_database(self, request):
+        r0 = _get_client(redis.Redis, request, db=0)
+        r1 = _get_client(redis.Redis, request, db=1)
+        r0.set("a", "foo")
+        assert r0.copy("a", "b", destination_db=1) == 1
+        assert r1.get("b") == b"foo"
+
     def test_decr(self, r):
         assert r.decr('a') == -1
         assert r['a'] == b'-1'

From 3c244af9e7c820d38135562d9385753f5bbb60e6 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Thu, 22 Jul 2021 18:50:24 +0300
Subject: [PATCH 0107/1164] getex (#1515)

* getex

* flake8 fix

* comments
---
 redis/client.py        | 51 ++++++++++++++++++++++++++++++++++++++++++
 tests/test_commands.py | 15 +++++++++++++
 2 files changed, 66 insertions(+)

diff --git a/redis/client.py b/redis/client.py
index 72178f3068..8b1b35392c 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1689,6 +1689,57 @@ def get(self, name):
         """
         return self.execute_command('GET', name)
 
+    def getex(self, name,
+              ex=None, px=None, exat=None, pxat=None, persist=False):
+        """
+        Get the value of key and optionally set its expiration.
+        GETEX is similar to GET, but is a write command with
+        additional options. All time parameters can be given as
+        datetime.timedelta or integers.
+
+        ``ex`` sets an expire flag on key ``name`` for ``ex`` seconds.
+
+        ``px`` sets an expire flag on key ``name`` for ``px`` milliseconds.
+
+        ``exat`` sets an expire flag on key ``name`` for ``ex`` seconds,
+        specified in unix time.
+
+        ``pxat`` sets an expire flag on key ``name`` for ``ex`` milliseconds,
+        specified in unix time.
+
+        ``persist`` remove the time to live associated with ``name``.
+        """
+
+        pieces = []
+        # similar to set command
+        if ex is not None:
+            pieces.append('EX')
+            if isinstance(ex, datetime.timedelta):
+                ex = int(ex.total_seconds())
+            pieces.append(ex)
+        if px is not None:
+            pieces.append('PX')
+            if isinstance(px, datetime.timedelta):
+                px = int(px.total_seconds() * 1000)
+            pieces.append(px)
+        # similar to pexpireat command
+        if exat is not None:
+            pieces.append('EXAT')
+            if isinstance(exat, datetime.datetime):
+                s = int(exat.microsecond / 1000000)
+                exat = int(mod_time.mktime(exat.timetuple())) + s
+            pieces.append(exat)
+        if pxat is not None:
+            pieces.append('PXAT')
+            if isinstance(pxat, datetime.datetime):
+                ms = int(pxat.microsecond / 1000)
+                pxat = int(mod_time.mktime(pxat.timetuple())) * 1000 + ms
+            pieces.append(pxat)
+        if persist:
+            pieces.append('PERSIST')
+
+        return self.execute_command('GETEX', name, *pieces)
+
     def __getitem__(self, name):
         """
         Return the value at key ``name``, raises a KeyError if the key
diff --git a/tests/test_commands.py b/tests/test_commands.py
index a5a7e45e2f..088404a23c 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -727,6 +727,21 @@ def test_get_and_set(self, r):
         assert r.get('integer') == str(integer).encode()
         assert r.get('unicode_string').decode('utf-8') == unicode_string
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_getex(self, r):
+        r.set('a', 1)
+        assert r.getex('a') == b'1'
+        assert r.ttl('a') == -1
+        assert r.getex('a', ex=60) == b'1'
+        assert r.ttl('a') == 60
+        assert r.getex('a', px=6000) == b'1'
+        assert r.ttl('a') == 6
+        expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
+        assert r.getex('a', pxat=expire_at) == b'1'
+        assert r.ttl('a') <= 60
+        assert r.getex('a', persist=True) == b'1'
+        assert r.ttl('a') == -1
+
     def test_getitem_and_setitem(self, r):
         r['a'] = 'bar'
         assert r['a'] == b'bar'

From ad4779eb8200e47a7786f78ca915a246038602c3 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Thu, 22 Jul 2021 18:51:13 +0300
Subject: [PATCH 0108/1164] client_list (#1517)

---
 redis/client.py        | 12 ++++++++++--
 tests/test_commands.py |  6 ++++++
 2 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 8b1b35392c..a838d8775f 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -530,7 +530,7 @@ def parse_client_info(value):
     "key1=value1 key2=value2 key3=value3"
     """
     client_info = {}
-    infos = value.split(" ")
+    infos = str_if_bytes(value).split(" ")
     for info in infos:
         key, value = info.split("=")
         client_info[key] = value
@@ -538,7 +538,7 @@ def parse_client_info(value):
     # Those fields are definded as int in networking.c
     for int_key in {"id", "age", "idle", "db", "sub", "psub",
                     "multi", "qbuf", "qbuf-free", "obl",
-                    "oll", "omem"}:
+                    "argv-mem", "oll", "omem", "tot-mem"}:
         client_info[int_key] = int(client_info[int_key])
     return client_info
 
@@ -620,6 +620,7 @@ class Redis:
         'CLIENT ID': int,
         'CLIENT KILL': parse_client_kill,
         'CLIENT LIST': parse_client_list,
+        'CLIENT INFO': parse_client_info,
         'CLIENT SETNAME': bool_ok,
         'CLIENT UNBLOCK': lambda r: r and int(r) == 1 or False,
         'CLIENT PAUSE': bool_ok,
@@ -1243,6 +1244,13 @@ def client_kill_filter(self, _id=None, _type=None, addr=None, skipme=None):
                             "<value> must specify at least one filter")
         return self.execute_command('CLIENT KILL', *args)
 
+    def client_info(self):
+        """
+        Returns information and statistics about the current
+        client connection.
+        """
+        return self.execute_command('CLIENT INFO')
+
     def client_list(self, _type=None):
         """
         Returns a list of currently connected clients.
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 088404a23c..9884035e7d 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -281,6 +281,12 @@ def test_client_list(self, r):
         assert isinstance(clients[0], dict)
         assert 'addr' in clients[0]
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_client_info(self, r):
+        info = r.client_info()
+        assert isinstance(info, dict)
+        assert 'addr' in info
+
     @skip_if_server_version_lt('5.0.0')
     def test_client_list_type(self, r):
         with pytest.raises(exceptions.RedisError):

From 627db540acd1f1f36db88290d74cbcd75f6bda0c Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Thu, 22 Jul 2021 18:51:24 +0300
Subject: [PATCH 0109/1164] hrandfield (#1513)

* hrandfield

* use mapping in hset

* skip if version not fit

* remove empty line

* flake8 comments

* new line for each comment
---
 redis/client.py        | 20 ++++++++++++++++++++
 tests/test_commands.py | 13 +++++++++++++
 2 files changed, 33 insertions(+)

diff --git a/redis/client.py b/redis/client.py
index a838d8775f..57932b9f73 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1879,6 +1879,26 @@ def pttl(self, name):
         "Returns the number of milliseconds until the key ``name`` will expire"
         return self.execute_command('PTTL', name)
 
+    def hrandfield(self, key, count=None, withvalues=False):
+        """
+        Return a random field from the hash value stored at key.
+
+        count: if the argument is positive, return an array of distinct fields.
+        If called with a negative count, the behavior changes and the command
+        is allowed to return the same field multiple times. In this case,
+        the number of returned fields is the absolute value of the
+        specified count.
+        withvalues: The optional WITHVALUES modifier changes the reply so it
+        includes the respective values of the randomly selected hash fields.
+        """
+        params = []
+        if count is not None:
+            params.append(count)
+        if withvalues:
+            params.append("WITHVALUES")
+
+        return self.execute_command("HRANDFIELD", key, *params)
+
     def randomkey(self):
         "Returns the name of a random key"
         return self.execute_command('RANDOMKEY')
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 9884035e7d..27117e3188 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -895,6 +895,19 @@ def test_pttl_no_key(self, r):
         "PTTL on servers 2.8 and after return -2 when the key doesn't exist"
         assert r.pttl('a') == -2
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_hrandfield(self, r):
+        assert r.hrandfield('key') is None
+        r.hset('key', mapping={'a': 1, 'b': 2, 'c': 3, 'd': 4, 'e': 5})
+        assert r.hrandfield('key') is not None
+        assert len(r.hrandfield('key', 2)) == 2
+        # with values
+        assert len(r.hrandfield('key', 2, True)) == 4
+        # without duplications
+        assert len(r.hrandfield('key', 10)) == 5
+        # with duplications
+        assert len(r.hrandfield('key', -10)) == 10
+
     def test_randomkey(self, r):
         assert r.randomkey() is None
         for key in ('a', 'b', 'c'):

From 57cf7ffc1fbaca2f17d03de38ee19e8af48ac153 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 25 Jul 2021 09:03:55 +0300
Subject: [PATCH 0110/1164] NOMKSTREAM support for XADD (#1507)

---
 redis/client.py        |  7 +++++--
 tests/test_commands.py | 10 ++++++++++
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 57932b9f73..f82292600c 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -2531,7 +2531,8 @@ def xack(self, name, groupname, *ids):
         """
         return self.execute_command('XACK', name, groupname, *ids)
 
-    def xadd(self, name, fields, id='*', maxlen=None, approximate=True):
+    def xadd(self, name, fields, id='*', maxlen=None, approximate=True,
+             nomkstream=False):
         """
         Add to a stream.
         name: name of the stream
@@ -2539,7 +2540,7 @@ def xadd(self, name, fields, id='*', maxlen=None, approximate=True):
         id: Location to insert this record. By default it is appended.
         maxlen: truncate old stream members beyond this size
         approximate: actual stream length may be slightly more than maxlen
-
+        nomkstream: When set to true, do not make a stream
         """
         pieces = []
         if maxlen is not None:
@@ -2549,6 +2550,8 @@ def xadd(self, name, fields, id='*', maxlen=None, approximate=True):
             if approximate:
                 pieces.append(b'~')
             pieces.append(str(maxlen))
+        if nomkstream:
+            pieces.append(b'NOMKSTREAM')
         pieces.append(id)
         if not isinstance(fields, dict) or len(fields) == 0:
             raise DataError('XADD fields must be a non-empty dict')
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 27117e3188..c9fdeeffc4 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2247,6 +2247,16 @@ def test_xadd(self, r):
         r.xadd(stream, {'foo': 'bar'}, maxlen=2, approximate=False)
         assert r.xlen(stream) == 2
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_xadd_nomkstream(self, r):
+        # nomkstream option
+        stream = 'stream'
+        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'some': 'other'}, nomkstream=False)
+        assert r.xlen(stream) == 2
+        r.xadd(stream, {'some': 'other'}, nomkstream=True)
+        assert r.xlen(stream) == 3
+
     @skip_if_server_version_lt('5.0.0')
     def test_xclaim(self, r):
         stream = 'stream'

From 88e5bd8938006a6e7bcc626048a9cd4572bbac68 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 25 Jul 2021 09:04:15 +0300
Subject: [PATCH 0111/1164] support for client unpause (#1512)

---
 redis/client.py        | 6 ++++++
 tests/test_commands.py | 4 ++++
 2 files changed, 10 insertions(+)

diff --git a/redis/client.py b/redis/client.py
index f82292600c..db4778c41c 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1300,6 +1300,12 @@ def client_pause(self, timeout):
             raise DataError("CLIENT PAUSE timeout must be an integer")
         return self.execute_command('CLIENT PAUSE', str(timeout))
 
+    def client_unpause(self):
+        """
+        Unpause all redis clients
+        """
+        return self.execute_command('CLIENT UNPAUSE')
+
     def readwrite(self):
         "Disables read queries for a connection to a Redis Cluster slave node"
         return self.execute_command('READWRITE')
diff --git a/tests/test_commands.py b/tests/test_commands.py
index c9fdeeffc4..362e7ab743 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -402,6 +402,10 @@ def test_client_pause(self, r):
         with pytest.raises(exceptions.RedisError):
             r.client_pause(timeout='not an integer')
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_client_unpause(self, r):
+        assert r.client_unpause() == b'OK'
+
     def test_config_get(self, r):
         data = r.config_get()
         assert 'maxmemory' in data

From b021f5a15e61ac4217b533443eba0a1c56c03ef3 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 25 Jul 2021 09:07:30 +0300
Subject: [PATCH 0112/1164] Implements CLIENT KILL laddr filter (#1506)

---
 redis/client.py        |  6 +++++-
 tests/test_commands.py | 20 ++++++++++++++++++++
 2 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/redis/client.py b/redis/client.py
index db4778c41c..ef3c82ca9f 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1210,7 +1210,8 @@ def client_kill(self, address):
         "Disconnects the client at ``address`` (ip:port)"
         return self.execute_command('CLIENT KILL', address)
 
-    def client_kill_filter(self, _id=None, _type=None, addr=None, skipme=None):
+    def client_kill_filter(self, _id=None, _type=None, addr=None,
+                           skipme=None, laddr=None):
         """
         Disconnects client(s) using a variety of filter options
         :param id: Kills a client by its unique ID field
@@ -1218,6 +1219,7 @@ def client_kill_filter(self, _id=None, _type=None, addr=None, skipme=None):
         'master', 'slave' or 'pubsub'
         :param addr: Kills a client by its 'address:port'
         :param skipme: If True, then the client calling the command
+        :param laddr: Kills a cient by its 'local (bind)  address:port'
         will not get killed even if it is identified by one of the filter
         options. If skipme is not provided, the server defaults to skipme=True
         """
@@ -1239,6 +1241,8 @@ def client_kill_filter(self, _id=None, _type=None, addr=None, skipme=None):
             args.extend((b'ID', _id))
         if addr is not None:
             args.extend((b'ADDR', addr))
+        if laddr is not None:
+            args.extend((b'LADDR', laddr))
         if not args:
             raise DataError("CLIENT KILL <filter> <value> ... ... <filter> "
                             "<value> must specify at least one filter")
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 362e7ab743..18f37d18ec 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -395,6 +395,26 @@ def test_client_list_after_client_setname(self, r):
         # we don't know which client ours will be
         assert 'redis_py_test' in [c['name'] for c in clients]
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_client_kill_filter_by_laddr(self, r, r2):
+        r.client_setname('redis-py-c1')
+        r2.client_setname('redis-py-c2')
+        clients = [client for client in r.client_list()
+                   if client.get('name') in ['redis-py-c1', 'redis-py-c2']]
+        assert len(clients) == 2
+
+        clients_by_name = dict([(client.get('name'), client)
+                                for client in clients])
+
+        client_2_addr = clients_by_name['redis-py-c2'].get('laddr')
+        resp = r.client_kill_filter(laddr=client_2_addr)
+        assert resp == 1
+
+        clients = [client for client in r.client_list()
+                   if client.get('name') in ['redis-py-c1', 'redis-py-c2']]
+        assert len(clients) == 1
+        assert clients[0].get('name') == 'redis-py-c1'
+
     @skip_if_server_version_lt('2.9.50')
     def test_client_pause(self, r):
         assert r.client_pause(1)

From 01b96db203a651ff82598ad66685e487b74b8aac Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Sun, 25 Jul 2021 10:19:44 +0300
Subject: [PATCH 0113/1164] getdel (#1514)

---
 redis/client.py        | 9 +++++++++
 tests/test_commands.py | 7 +++++++
 2 files changed, 16 insertions(+)

diff --git a/redis/client.py b/redis/client.py
index ef3c82ca9f..fe6299f8cf 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1707,6 +1707,15 @@ def get(self, name):
         """
         return self.execute_command('GET', name)
 
+    def getdel(self, name):
+        """
+        Get the value at key ``name`` and delete the key. This command
+        is similar to GET, except for the fact that it also deletes
+        the key on success (if and only if the key's value type
+        is a string).
+        """
+        return self.execute_command('GETDEL', name)
+
     def getex(self, name,
               ex=None, px=None, exat=None, pxat=None, persist=False):
         """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 18f37d18ec..b83fe8ff46 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -757,6 +757,13 @@ def test_get_and_set(self, r):
         assert r.get('integer') == str(integer).encode()
         assert r.get('unicode_string').decode('utf-8') == unicode_string
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_getdel(self, r):
+        assert r.getdel('a') is None
+        r.set('a', 1)
+        assert r.getdel('a') == b'1'
+        assert r.getdel('a') is None
+
     @skip_if_server_version_lt('6.2.0')
     def test_getex(self, r):
         r.set('a', 1)

From e7064450791b1cb20e1ff94f03385b2d02bb9ec7 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Sun, 25 Jul 2021 10:19:53 +0300
Subject: [PATCH 0114/1164] zrandmember (#1519)

---
 redis/client.py        | 22 ++++++++++++++++++++++
 tests/test_commands.py | 12 ++++++++++++
 2 files changed, 34 insertions(+)

diff --git a/redis/client.py b/redis/client.py
index fe6299f8cf..160f495c1f 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -2965,6 +2965,28 @@ def zpopmin(self, name, count=None):
         }
         return self.execute_command('ZPOPMIN', name, *args, **options)
 
+    def zrandmember(self, key, count=None, withscores=False):
+        """
+        Return a random element from the sorted set value stored at key.
+
+        ``count`` if the argument is positive, return an array of distinct
+        fields. If called with a negative count, the behavior changes and
+        the command is allowed to return the same field multiple times.
+        In this case, the number of returned fields is the absolute value
+        of the specified count.
+
+        ``withscores`` The optional WITHSCORES modifier changes the reply so it
+        includes the respective scores of the randomly selected elements from
+        the sorted set.
+        """
+        params = []
+        if count is not None:
+            params.append(count)
+        if withscores:
+            params.append("WITHSCORES")
+
+        return self.execute_command("ZRANDMEMBER", key, *params)
+
     def bzpopmax(self, keys, timeout=0):
         """
         ZPOPMAX a value off of the first non-empty sorted set
diff --git a/tests/test_commands.py b/tests/test_commands.py
index b83fe8ff46..3f0a82f721 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1537,6 +1537,18 @@ def test_zpopmin(self, r):
         assert r.zpopmin('a', count=2) == \
             [(b'a2', 2), (b'a3', 3)]
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_zrandemember(self, r):
+        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3, 'a4': 4, 'a5': 5})
+        assert r.zrandmember('a') is not None
+        assert len(r.zrandmember('a', 2)) == 2
+        # with scores
+        assert len(r.zrandmember('a', 2, True)) == 4
+        # without duplications
+        assert len(r.zrandmember('a', 10)) == 5
+        # with duplications
+        assert len(r.zrandmember('a', -10)) == 10
+
     @skip_if_server_version_lt('4.9.0')
     def test_bzpopmax(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2})

From c7ecb1d4aa68820e000f88c23f6ff3afd4166b8a Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 29 Jul 2021 14:46:50 +0300
Subject: [PATCH 0115/1164] LT and GT support for ZADD (#1509)

Co-authored-by: malinaa96 <52569986+malinaa96@users.noreply.github.com>
Co-authored-by: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
---
 redis/client.py        | 10 +++++++++-
 tests/test_commands.py | 17 +++++++++++++++++
 2 files changed, 26 insertions(+), 1 deletion(-)

diff --git a/redis/client.py b/redis/client.py
index 160f495c1f..ea36ef0ddc 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -2866,7 +2866,8 @@ def xtrim(self, name, maxlen, approximate=True):
         return self.execute_command('XTRIM', name, *pieces)
 
     # SORTED SET COMMANDS
-    def zadd(self, name, mapping, nx=False, xx=False, ch=False, incr=False):
+    def zadd(self, name, mapping, nx=False, xx=False, ch=False, incr=False,
+             gt=None, lt=None):
         """
         Set any number of element-name, score pairs to the key ``name``. Pairs
         are specified as a dict of element-names keys to score values.
@@ -2897,6 +2898,9 @@ def zadd(self, name, mapping, nx=False, xx=False, ch=False, incr=False):
         if incr and len(mapping) != 1:
             raise DataError("ZADD option 'incr' only works when passing a "
                             "single element/score pair")
+        if nx is True and (gt is not None or lt is not None):
+            raise DataError("Only one of 'nx', 'lt', or 'gr' may be defined.")
+
         pieces = []
         options = {}
         if nx:
@@ -2908,6 +2912,10 @@ def zadd(self, name, mapping, nx=False, xx=False, ch=False, incr=False):
         if incr:
             pieces.append(b'INCR')
             options['as_score'] = True
+        if gt:
+            pieces.append(b'GT')
+        if lt:
+            pieces.append(b'LT')
         for pair in mapping.items():
             pieces.append(pair[1])
             pieces.append(pair[0])
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 3f0a82f721..62394a4412 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1462,6 +1462,23 @@ def test_zadd_incr_with_xx(self, r):
         # redis-py
         assert r.zadd('a', {'a1': 1}, xx=True, incr=True) is None
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_zadd_gt_lt(self, r):
+
+        for i in range(1, 20):
+            r.zadd('a', {'a%s' % i: i})
+        assert r.zadd('a', {'a20': 5}, gt=3) == 1
+
+        for i in range(1, 20):
+            r.zadd('a', {'a%s' % i: i})
+        assert r.zadd('a', {'a2': 5}, lt=1) == 0
+
+        # cannot use both nx and xx options
+        with pytest.raises(exceptions.DataError):
+            r.zadd('a', {'a15': 155}, nx=True, lt=True)
+            r.zadd('a', {'a15': 155}, nx=True, gt=True)
+            r.zadd('a', {'a15': 155}, lx=True, gt=True)
+
     def test_zcard(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
         assert r.zcard('a') == 3

From 53fe4d3eae75cabfb635eae5ae9197efa0bf86c3 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Thu, 29 Jul 2021 16:41:46 +0300
Subject: [PATCH 0116/1164] Zrangestore (#1521)

---
 redis/client.py        |  9 +++++++++
 tests/test_commands.py | 10 ++++++++++
 2 files changed, 19 insertions(+)

diff --git a/redis/client.py b/redis/client.py
index ea36ef0ddc..33b03746bc 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -3056,6 +3056,15 @@ def zrange(self, name, start, end, desc=False, withscores=False,
         }
         return self.execute_command(*pieces, **options)
 
+    def zrangestore(self, dest, name, start, end):
+        """
+        Stores in ``dest`` the result of a range of values from sorted set
+        ``name`` between ``start`` and ``end`` sorted in ascending order.
+
+        ``start`` and ``end`` can be negative, indicating the end of the range.
+        """
+        return self.execute_command('ZRANGESTORE', dest, name, start, end)
+
     def zrangebylex(self, name, min, max, start=None, num=None):
         """
         Return the lexicographical range of values from sorted set ``name``
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 62394a4412..8411e5e7ef 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1605,6 +1605,16 @@ def test_zrange(self, r):
         assert r.zrange('a', 0, 1, withscores=True, score_cast_func=int) == \
             [(b'a1', 1), (b'a2', 2)]
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_zrangestore(self, r):
+        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
+        assert r.zrangestore('b', 'a', 0, 1)
+        assert r.zrange('b', 0, -1) == [b'a1', b'a2']
+        assert r.zrangestore('b', 'a', 1, 2)
+        assert r.zrange('b', 0, -1) == [b'a2', b'a3']
+        assert r.zrange('b', 0, -1, withscores=True) == \
+               [(b'a2', 2), (b'a3', 3)]
+
     @skip_if_server_version_lt('2.8.9')
     def test_zrangebylex(self, r):
         r.zadd('a', {'a': 0, 'b': 0, 'c': 0, 'd': 0, 'e': 0, 'f': 0, 'g': 0})

From fc69bd65494d7ac8d08e16ff38e06936ab6dcc02 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Thu, 29 Jul 2021 16:41:55 +0300
Subject: [PATCH 0117/1164] zdiff and zdiffstore (#1518)

---
 redis/client.py        | 22 ++++++++++++++++++++--
 tests/test_commands.py | 15 +++++++++++++++
 2 files changed, 35 insertions(+), 2 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 33b03746bc..4e4ccc69c2 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -595,8 +595,8 @@ class Redis:
             lambda r: r and set(r) or set()
         ),
         **string_keys_to_dict(
-            'ZPOPMAX ZPOPMIN ZRANGE ZRANGEBYSCORE ZREVRANGE ZREVRANGEBYSCORE',
-            zset_score_pairs
+            'ZPOPMAX ZPOPMIN ZDIFF ZRANGE ZRANGEBYSCORE ZREVRANGE '
+            'ZREVRANGEBYSCORE', zset_score_pairs
         ),
         **string_keys_to_dict('BZPOPMIN BZPOPMAX', \
                               lambda r:
@@ -2932,6 +2932,24 @@ def zcount(self, name, min, max):
         """
         return self.execute_command('ZCOUNT', name, min, max)
 
+    def zdiff(self, keys, withscores=False):
+        """
+        Returns the difference between the first and all successive input
+        sorted sets provided in ``keys``.
+        """
+        pieces = [len(keys), *keys]
+        if withscores:
+            pieces.append("WITHSCORES")
+        return self.execute_command("ZDIFF", *pieces)
+
+    def zdiffstore(self, dest, keys):
+        """
+        Computes the difference between the first and all successive input
+        sorted sets provided in ``keys`` and stores the result in ``dest``.
+        """
+        pieces = [len(keys), *keys]
+        return self.execute_command("ZDIFFSTORE", dest, *pieces)
+
     def zincrby(self, name, amount, value):
         "Increment the score of ``value`` in sorted set ``name`` by ``amount``"
         return self.execute_command('ZINCRBY', name, amount, value)
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 8411e5e7ef..9682603a9d 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1491,6 +1491,21 @@ def test_zcount(self, r):
         assert r.zcount('a', 1, '(' + str(2)) == 1
         assert r.zcount('a', 10, 20) == 0
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_zdiff(self, r):
+        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
+        r.zadd('b', {'a1': 1, 'a2': 2})
+        assert r.zdiff(['a', 'b']) == [b'a3']
+        assert r.zdiff(['a', 'b'], withscores=True) == [b'a3', b'3']
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_zdiffstore(self, r):
+        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
+        r.zadd('b', {'a1': 1, 'a2': 2})
+        assert r.zdiffstore("out", ['a', 'b'])
+        assert r.zrange("out", 0, -1) == [b'a3']
+        assert r.zrange("out", 0, -1, withscores=True) == [(b'a3', 3.0)]
+
     def test_zincrby(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
         assert r.zincrby('a', 1, 'a2') == 3.0

From be26730e8136e6a27f397491d44fa723449023db Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 29 Jul 2021 20:32:29 +0300
Subject: [PATCH 0118/1164] ensuring we adhere to exlusive options for getex
 (#1531)

---
 redis/client.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/redis/client.py b/redis/client.py
index 4e4ccc69c2..a3da1c48ae 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1737,6 +1737,11 @@ def getex(self, name,
         ``persist`` remove the time to live associated with ``name``.
         """
 
+        opset = set([ex, px, exat, pxat])
+        if len(opset) > 2 or len(opset) > 1 and persist:
+            raise DataError("``ex``, ``px``, ``exat``, ``pxat``",
+                            "and ``persist`` are mutually exclusive.")
+
         pieces = []
         # similar to set command
         if ex is not None:

From e9c2e4574a06f240dc528d5ac20cdbeb5eb6564d Mon Sep 17 00:00:00 2001
From: Jonathan Herlin <Jonte@jherlin.se>
Date: Fri, 30 Jul 2021 07:27:03 +0200
Subject: [PATCH 0119/1164] Word was repeated in documentation (#1532)

Small typo in documentation
---
 redis/client.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/client.py b/redis/client.py
index a3da1c48ae..4ab1b1ee37 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -3322,7 +3322,7 @@ def hlen(self, name):
     def hset(self, name, key=None, value=None, mapping=None):
         """
         Set ``key`` to ``value`` within hash ``name``,
-        ``mapping`` accepts a dict of key/value pairs that that will be
+        ``mapping`` accepts a dict of key/value pairs that will be
         added to hash ``name``.
         Returns the number of fields that were added.
         """

From 6f4ee2dee63171afa4c59742a3726594894916ae Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Sun, 1 Aug 2021 13:35:55 +0300
Subject: [PATCH 0120/1164] zinter (#1520)

* zinter

* change options in _zaggregate

* skip for previous versions

* flake8

* validate the aggregate value

* invalid aggregation

* invalid aggregation

* change options to get

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/client.py        | 46 +++++++++++++++++++++++++++++++++---------
 tests/test_commands.py | 22 ++++++++++++++++++++
 2 files changed, 58 insertions(+), 10 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 4ab1b1ee37..0d8a5c2637 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -595,8 +595,8 @@ class Redis:
             lambda r: r and set(r) or set()
         ),
         **string_keys_to_dict(
-            'ZPOPMAX ZPOPMIN ZDIFF ZRANGE ZRANGEBYSCORE ZREVRANGE '
-            'ZREVRANGEBYSCORE', zset_score_pairs
+            'ZPOPMAX ZPOPMIN ZINTER ZDIFF ZRANGE ZRANGEBYSCORE '
+            'ZREVRANGE ZREVRANGEBYSCORE', zset_score_pairs
         ),
         **string_keys_to_dict('BZPOPMIN BZPOPMAX', \
                               lambda r:
@@ -2959,11 +2959,28 @@ def zincrby(self, name, amount, value):
         "Increment the score of ``value`` in sorted set ``name`` by ``amount``"
         return self.execute_command('ZINCRBY', name, amount, value)
 
+    def zinter(self, keys, aggregate=None, withscores=False):
+        """
+        Return the intersect of multiple sorted sets specified by ``keys``.
+        With the ``aggregate`` option, it is possible to specify how the
+        results of the union are aggregated. This option defaults to SUM,
+        where the score of an element is summed across the inputs where it
+        exists. When this option is set to either MIN or MAX, the resulting
+        set will contain the minimum or maximum score of an element across
+        the inputs where it exists.
+        """
+        return self._zaggregate('ZINTER', None, keys, aggregate,
+                                withscores=withscores)
+
     def zinterstore(self, dest, keys, aggregate=None):
         """
-        Intersect multiple sorted sets specified by ``keys`` into
-        a new sorted set, ``dest``. Scores in the destination will be
-        aggregated based on the ``aggregate``, or SUM if none is provided.
+        Intersect multiple sorted sets specified by ``keys`` into a new
+        sorted set, ``dest``. Scores in the destination will be aggregated
+        based on the ``aggregate``. This option defaults to SUM, where the
+        score of an element is summed across the inputs where it exists.
+        When this option is set to either MIN or MAX, the resulting set will
+        contain the minimum or maximum score of an element across the inputs
+        where it exists.
         """
         return self._zaggregate('ZINTERSTORE', dest, keys, aggregate)
 
@@ -3253,8 +3270,12 @@ def zunionstore(self, dest, keys, aggregate=None):
         """
         return self._zaggregate('ZUNIONSTORE', dest, keys, aggregate)
 
-    def _zaggregate(self, command, dest, keys, aggregate=None):
-        pieces = [command, dest, len(keys)]
+    def _zaggregate(self, command, dest, keys, aggregate=None,
+                    **options):
+        pieces = [command]
+        if dest is not None:
+            pieces.append(dest)
+        pieces.append(len(keys))
         if isinstance(keys, dict):
             keys, weights = keys.keys(), keys.values()
         else:
@@ -3264,9 +3285,14 @@ def _zaggregate(self, command, dest, keys, aggregate=None):
             pieces.append(b'WEIGHTS')
             pieces.extend(weights)
         if aggregate:
-            pieces.append(b'AGGREGATE')
-            pieces.append(aggregate)
-        return self.execute_command(*pieces)
+            if aggregate.upper() in ['SUM', 'MIN', 'MAX']:
+                pieces.append(b'AGGREGATE')
+                pieces.append(aggregate)
+            else:
+                raise DataError("aggregate can be sum, min or max.")
+        if options.get('withscores', False):
+            pieces.append(b'WITHSCORES')
+        return self.execute_command(*pieces, **options)
 
     # HYPERLOGLOG COMMANDS
     def pfadd(self, name, *values):
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 9682603a9d..40c813d7a1 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1519,6 +1519,28 @@ def test_zlexcount(self, r):
         assert r.zlexcount('a', '-', '+') == 7
         assert r.zlexcount('a', '[b', '[f') == 5
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_zinter(self, r):
+        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 1})
+        r.zadd('b', {'a1': 2, 'a2': 2, 'a3': 2})
+        r.zadd('c', {'a1': 6, 'a3': 5, 'a4': 4})
+        assert r.zinter(['a', 'b', 'c']) == [b'a3', b'a1']
+        # invalid aggregation
+        with pytest.raises(exceptions.DataError):
+            r.zinter(['a', 'b', 'c'], aggregate='foo', withscores=True)
+        # aggregate with SUM
+        assert r.zinter(['a', 'b', 'c'], withscores=True) \
+               == [(b'a3', 8), (b'a1', 9)]
+        # aggregate with MAX
+        assert r.zinter(['a', 'b', 'c'], aggregate='MAX', withscores=True) \
+               == [(b'a3', 5), (b'a1', 6)]
+        # aggregate with MIN
+        assert r.zinter(['a', 'b', 'c'], aggregate='MIN', withscores=True) \
+               == [(b'a1', 1), (b'a3', 1)]
+        # with weights
+        assert r.zinter({'a': 1, 'b': 2, 'c': 3}, withscores=True) \
+               == [(b'a3', 20), (b'a1', 23)]
+
     def test_zinterstore_sum(self, r):
         r.zadd('a', {'a1': 1, 'a2': 1, 'a3': 1})
         r.zadd('b', {'a1': 2, 'a2': 2, 'a3': 2})

From 3c0e1163c7afcc42fdcbbf22dd61ac869a6857ee Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 3 Aug 2021 18:06:01 +0300
Subject: [PATCH 0121/1164] exclusive gt and lt in zadd (#1533)

* exclusive gt and lt in zadd

* docs update
---
 redis/client.py | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/redis/client.py b/redis/client.py
index 0d8a5c2637..514db536ed 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -2892,9 +2892,18 @@ def zadd(self, name, mapping, nx=False, xx=False, ch=False, incr=False,
         the existing score will be incremented by. When using this mode the
         return value of ZADD will be the new score of the element.
 
+        ``LT`` Only update existing elements if the new score is less than
+        the current score. This flag doesn't prevent adding new elements.
+
+        ``GT`` Only update existing elements if the new score is greater than
+        the current score. This flag doesn't prevent adding new elements.
+
         The return value of ZADD varies based on the mode specified. With no
         options, ZADD returns the number of new elements added to the sorted
         set.
+
+        ``NX``, ``LT``, and ``GT`` are mutually exclusive options.
+        See: https://redis.io/commands/ZADD
         """
         if not mapping:
             raise DataError("ZADD requires at least one element/score pair")
@@ -2904,7 +2913,9 @@ def zadd(self, name, mapping, nx=False, xx=False, ch=False, incr=False,
             raise DataError("ZADD option 'incr' only works when passing a "
                             "single element/score pair")
         if nx is True and (gt is not None or lt is not None):
-            raise DataError("Only one of 'nx', 'lt', or 'gr' may be defined.")
+            raise DataError("Only one of 'nx', 'lt', or 'gt' may be defined.")
+        if gt is not None and lt is not None:
+            raise DataError("Only one of 'gt' or 'lt' can be set.")
 
         pieces = []
         options = {}

From 2cfaac9949993386d9b2ac51cd676c709eb3d886 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Bielawski?= <michal@bielaw.ski>
Date: Thu, 5 Aug 2021 06:57:06 +0100
Subject: [PATCH 0122/1164] Add trove classifier for Python 3.9 (#1535)

---
 setup.cfg | 1 +
 1 file changed, 1 insertion(+)

diff --git a/setup.cfg b/setup.cfg
index 3fdea4e52d..a9c98491f8 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -23,6 +23,7 @@ classifiers =
     Programming Language :: Python :: 3.6
     Programming Language :: Python :: 3.7
     Programming Language :: Python :: 3.8
+    Programming Language :: Python :: 3.9
     Programming Language :: Python :: Implementation :: CPython
     Programming Language :: Python :: Implementation :: PyPy
 

From ec89d30815f0ac69ef8c59630fe3cf8314a3782d Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Thu, 5 Aug 2021 11:51:20 +0300
Subject: [PATCH 0123/1164] fix getex flaky tests

---
 tests/test_commands.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/test_commands.py b/tests/test_commands.py
index 40c813d7a1..c44d2cbdd1 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -775,7 +775,7 @@ def test_getex(self, r):
         assert r.ttl('a') == 6
         expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
         assert r.getex('a', pxat=expire_at) == b'1'
-        assert r.ttl('a') <= 60
+        assert r.ttl('a') <= 61
         assert r.getex('a', persist=True) == b'1'
         assert r.ttl('a') == -1
 

From 5240d60ff0636e7baaec2499c1c9018507578bf5 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 5 Aug 2021 11:59:22 +0300
Subject: [PATCH 0124/1164] Updating base testing docker to redis 6.2.5 (#1536)

---
 docker/base/Dockerfile | 2 +-
 tests/test_commands.py | 8 +-------
 2 files changed, 2 insertions(+), 8 deletions(-)

diff --git a/docker/base/Dockerfile b/docker/base/Dockerfile
index 003eac1f89..b6df3263c5 100644
--- a/docker/base/Dockerfile
+++ b/docker/base/Dockerfile
@@ -1 +1 @@
-FROM redis:6.0.9-buster
+FROM redis:6.2.5-buster
diff --git a/tests/test_commands.py b/tests/test_commands.py
index c44d2cbdd1..6f3f4d0880 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -407,13 +407,7 @@ def test_client_kill_filter_by_laddr(self, r, r2):
                                 for client in clients])
 
         client_2_addr = clients_by_name['redis-py-c2'].get('laddr')
-        resp = r.client_kill_filter(laddr=client_2_addr)
-        assert resp == 1
-
-        clients = [client for client in r.client_list()
-                   if client.get('name') in ['redis-py-c1', 'redis-py-c2']]
-        assert len(clients) == 1
-        assert clients[0].get('name') == 'redis-py-c1'
+        assert r.client_kill_filter(laddr=client_2_addr)
 
     @skip_if_server_version_lt('2.9.50')
     def test_client_pause(self, r):

From 238f69e36e0ff5ac9b892706e3a5478b138069cd Mon Sep 17 00:00:00 2001
From: Gal Ben David <wavenator@gmail.com>
Date: Thu, 5 Aug 2021 12:12:45 +0300
Subject: [PATCH 0125/1164] Add a count parameter to lpop/rpop for redis >=
 6.2.0 (#1487)

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 docker/base/Dockerfile |  2 +-
 redis/client.py        | 30 ++++++++++++++++++++++++------
 tests/test_commands.py | 16 ++++++++++++++++
 3 files changed, 41 insertions(+), 7 deletions(-)

diff --git a/docker/base/Dockerfile b/docker/base/Dockerfile
index b6df3263c5..60e4141e57 100644
--- a/docker/base/Dockerfile
+++ b/docker/base/Dockerfile
@@ -1 +1 @@
-FROM redis:6.2.5-buster
+FROM redis:6.2.5-buster
\ No newline at end of file
diff --git a/redis/client.py b/redis/client.py
index 514db536ed..e5cd647fb8 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -2148,9 +2148,18 @@ def llen(self, name):
         "Return the length of the list ``name``"
         return self.execute_command('LLEN', name)
 
-    def lpop(self, name):
-        "Remove and return the first item of the list ``name``"
-        return self.execute_command('LPOP', name)
+    def lpop(self, name, count=None):
+        """
+        Removes and returns the first elements of the list ``name``.
+
+        By default, the command pops a single element from the beginning of
+        the list. When provided with the optional ``count`` argument, the reply
+        will consist of up to count elements, depending on the list's length.
+        """
+        if count is not None:
+            return self.execute_command('LPOP', name, count)
+        else:
+            return self.execute_command('LPOP', name)
 
     def lpush(self, name, *values):
         "Push ``values`` onto the head of the list ``name``"
@@ -2196,9 +2205,18 @@ def ltrim(self, name, start, end):
         """
         return self.execute_command('LTRIM', name, start, end)
 
-    def rpop(self, name):
-        "Remove and return the last item of the list ``name``"
-        return self.execute_command('RPOP', name)
+    def rpop(self, name, count=None):
+        """
+        Removes and returns the last elements of the list ``name``.
+
+        By default, the command pops a single element from the end of the list.
+        When provided with the optional ``count`` argument, the reply will
+        consist of up to count elements, depending on the list's length.
+        """
+        if count is not None:
+            return self.execute_command('RPOP', name, count)
+        else:
+            return self.execute_command('RPOP', name)
 
     def rpoplpush(self, src, dst):
         """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 6f3f4d0880..dbe00933e7 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1122,6 +1122,14 @@ def test_lpop(self, r):
         assert r.lpop('a') == b'3'
         assert r.lpop('a') is None
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_lpop_count(self, r):
+        r.rpush('a', '1', '2', '3')
+        assert r.lpop('a', 2) == [b'1', b'2']
+        assert r.lpop('a', 1) == [b'3']
+        assert r.lpop('a') is None
+        assert r.lpop('a', 3) is None
+
     def test_lpush(self, r):
         assert r.lpush('a', '1') == 1
         assert r.lpush('a', '2') == 2
@@ -1171,6 +1179,14 @@ def test_rpop(self, r):
         assert r.rpop('a') == b'1'
         assert r.rpop('a') is None
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_rpop_count(self, r):
+        r.rpush('a', '1', '2', '3')
+        assert r.rpop('a', 2) == [b'3', b'2']
+        assert r.rpop('a', 1) == [b'1']
+        assert r.rpop('a') is None
+        assert r.rpop('a', 3) is None
+
     def test_rpoplpush(self, r):
         r.rpush('a', 'a1', 'a2', 'a3')
         r.rpush('b', 'b1', 'b2', 'b3')

From 9c60670deea5c593e20204bbd5f172ccfcd1d9db Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Thu, 5 Aug 2021 12:24:40 +0300
Subject: [PATCH 0126/1164] add idle to xpending (#1523)

---
 redis/client.py        | 42 +++++++++++++++++++++++++-------------
 tests/test_commands.py | 46 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 74 insertions(+), 14 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index e5cd647fb8..995239eb12 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -2747,7 +2747,7 @@ def xpending(self, name, groupname):
         return self.execute_command('XPENDING', name, groupname)
 
     def xpending_range(self, name, groupname, min, max, count,
-                       consumername=None):
+                       consumername=None, idle=None):
         """
         Returns information about pending messages, in a range.
         name: name of the stream.
@@ -2756,21 +2756,35 @@ def xpending_range(self, name, groupname, min, max, count,
         max: maximum stream ID.
         count: number of messages to return
         consumername: name of a consumer to filter by (optional).
+        idle: available from  version 6.2. filter entries by their
+        idle-time, given in milliseconds (optional).
         """
+        if {min, max, count} == {None}:
+            if idle is not None or consumername is not None:
+                raise DataError("if XPENDING is provided with idle time"
+                                " or consumername, it must be provided"
+                                " with min, max and count parameters")
+            return self.xpending(name, groupname)
+
         pieces = [name, groupname]
-        if min is not None or max is not None or count is not None:
-            if min is None or max is None or count is None:
-                raise DataError("XPENDING must be provided with min, max "
-                                "and count parameters, or none of them. ")
-            if not isinstance(count, int) or count < -1:
-                raise DataError("XPENDING count must be a integer >= -1")
-            pieces.extend((min, max, str(count)))
-        if consumername is not None:
-            if min is None or max is None or count is None:
-                raise DataError("if XPENDING is provided with consumername,"
-                                " it must be provided with min, max and"
-                                " count parameters")
-            pieces.append(consumername)
+        if min is None or max is None or count is None:
+            raise DataError("XPENDING must be provided with min, max "
+                            "and count parameters, or none of them.")
+        # idle
+        try:
+            if int(idle) < 0:
+                raise DataError("XPENDING idle must be a integer >= 0")
+            pieces.extend(['IDLE', idle])
+        except TypeError:
+            pass
+        # count
+        try:
+            if int(count) < 0:
+                raise DataError("XPENDING count must be a integer >= 0")
+            pieces.extend([min, max, count])
+        except TypeError:
+            pass
+
         return self.execute_command('XPENDING', *pieces, parse_detail=True)
 
     def xrange(self, name, min='-', max='+', count=None):
diff --git a/tests/test_commands.py b/tests/test_commands.py
index dbe00933e7..e92be622d0 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2636,6 +2636,52 @@ def test_xpending_range(self, r):
         assert response[1]['message_id'] == m2
         assert response[1]['consumer'] == consumer2.encode()
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_xpending_range_idle(self, r):
+        stream = 'stream'
+        group = 'group'
+        consumer1 = 'consumer1'
+        consumer2 = 'consumer2'
+        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+        r.xgroup_create(stream, group, 0)
+
+        # read 1 message from the group with each consumer
+        r.xreadgroup(group, consumer1, streams={stream: '>'}, count=1)
+        r.xreadgroup(group, consumer2, streams={stream: '>'}, count=1)
+
+        response = r.xpending_range(stream, group,
+                                    min='-', max='+', count=5)
+        assert len(response) == 2
+        response = r.xpending_range(stream, group,
+                                    min='-', max='+', count=5, idle=1000)
+        assert len(response) == 0
+
+    def test_xpending_range_negative(self, r):
+        stream = 'stream'
+        group = 'group'
+        with pytest.raises(redis.DataError):
+            r.xpending_range(stream, group, min='-', max='+', count=None)
+        with pytest.raises(ValueError):
+            r.xpending_range(stream, group, min='-', max='+', count="one")
+        with pytest.raises(redis.DataError):
+            r.xpending_range(stream, group, min='-', max='+', count=-1)
+        with pytest.raises(ValueError):
+            r.xpending_range(stream, group, min='-', max='+', count=5,
+                             idle="one")
+        with pytest.raises(redis.exceptions.ResponseError):
+            r.xpending_range(stream, group, min='-', max='+', count=5,
+                             idle=1.5)
+        with pytest.raises(redis.DataError):
+            r.xpending_range(stream, group, min='-', max='+', count=5,
+                             idle=-1)
+        with pytest.raises(redis.DataError):
+            r.xpending_range(stream, group, min=None, max=None, count=None,
+                             idle=0)
+        with pytest.raises(redis.DataError):
+            r.xpending_range(stream, group, min=None, max=None, count=None,
+                             consumername=0)
+
     @skip_if_server_version_lt('5.0.0')
     def test_xrange(self, r):
         stream = 'stream'

From ba30d027a9a55a2ffd44dc8ca01d526b8705ab03 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Thu, 5 Aug 2021 12:25:25 +0300
Subject: [PATCH 0127/1164] xautoclaim (#1529)

---
 redis/client.py        | 47 +++++++++++++++++++++++++++++++++++++++++
 tests/test_commands.py | 48 +++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 94 insertions(+), 1 deletion(-)

diff --git a/redis/client.py b/redis/client.py
index 995239eb12..019ff4f2a7 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -316,6 +316,12 @@ def parse_xclaim(response, **options):
     return parse_stream_list(response)
 
 
+def parse_xautoclaim(response, **options):
+    if options.get('parse_justid', False):
+        return response[1]
+    return parse_stream_list(response[1])
+
+
 def parse_xinfo_stream(response):
     data = pairs_to_dict(response, decode_keys=True)
     first = data['first-entry']
@@ -684,6 +690,7 @@ class Redis:
         'SSCAN': parse_scan,
         'TIME': lambda x: (int(x[0]), int(x[1])),
         'XCLAIM': parse_xclaim,
+        'XAUTOCLAIM': parse_xautoclaim,
         'XGROUP CREATE': bool_ok,
         'XGROUP DELCONSUMER': int,
         'XGROUP DESTROY': bool,
@@ -2601,6 +2608,46 @@ def xadd(self, name, fields, id='*', maxlen=None, approximate=True,
             pieces.extend(pair)
         return self.execute_command('XADD', name, *pieces)
 
+    def xautoclaim(self, name, groupname, consumername, min_idle_time,
+                   start_id=0, count=None, justid=False):
+        """
+        Transfers ownership of pending stream entries that match the specified
+        criteria. Conceptually, equivalent to calling XPENDING and then XCLAIM,
+        but provides a more straightforward way to deal with message delivery
+        failures via SCAN-like semantics.
+        name: name of the stream.
+        groupname: name of the consumer group.
+        consumername: name of a consumer that claims the message.
+        min_idle_time: filter messages that were idle less than this amount of
+        milliseconds.
+        start_id: filter messages with equal or greater ID.
+        count: optional integer, upper limit of the number of entries that the
+        command attempts to claim. Set to 100 by default.
+        justid: optional boolean, false by default. Return just an array of IDs
+        of messages successfully claimed, without returning the actual message
+        """
+        try:
+            if int(min_idle_time) < 0:
+                raise DataError("XAUTOCLAIM min_idle_time must be a non"
+                                "negative integer")
+        except TypeError:
+            pass
+
+        kwargs = {}
+        pieces = [name, groupname, consumername, min_idle_time, start_id]
+
+        try:
+            if int(count) < 0:
+                raise DataError("XPENDING count must be a integer >= 0")
+            pieces.extend([b'COUNT', count])
+        except TypeError:
+            pass
+        if justid:
+            pieces.append(b'JUSTID')
+            kwargs['parse_justid'] = True
+
+        return self.execute_command('XAUTOCLAIM', *pieces, **kwargs)
+
     def xclaim(self, name, groupname, consumername, min_idle_time, message_ids,
                idle=None, time=None, retrycount=None, force=False,
                justid=False):
diff --git a/tests/test_commands.py b/tests/test_commands.py
index e92be622d0..60e667d7ad 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2374,13 +2374,59 @@ def test_xadd_nomkstream(self, r):
         r.xadd(stream, {'some': 'other'}, nomkstream=True)
         assert r.xlen(stream) == 3
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_xautoclaim(self, r):
+        stream = 'stream'
+        group = 'group'
+        consumer1 = 'consumer1'
+        consumer2 = 'consumer2'
+
+        message_id1 = r.xadd(stream, {'john': 'wick'})
+        message_id2 = r.xadd(stream, {'johny': 'deff'})
+        message = get_stream_message(r, stream, message_id1)
+        r.xgroup_create(stream, group, 0)
+
+        # trying to claim a message that isn't already pending doesn't
+        # do anything
+        response = r.xautoclaim(stream, group, consumer2, min_idle_time=0)
+        assert response == []
+
+        # read the group as consumer1 to initially claim the messages
+        r.xreadgroup(group, consumer1, streams={stream: '>'})
+
+        # claim one message as consumer2
+        response = r.xautoclaim(stream, group, consumer2,
+                                min_idle_time=0, count=1)
+        assert response == [message]
+
+        # reclaim the messages as consumer1, but use the justid argument
+        # which only returns message ids
+        assert r.xautoclaim(stream, group, consumer1, min_idle_time=0,
+                            start_id=0, justid=True) == \
+               [message_id1, message_id2]
+        assert r.xautoclaim(stream, group, consumer1, min_idle_time=0,
+                            start_id=message_id2, justid=True) == \
+               [message_id2]
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_xautoclaim_negative(self, r):
+        stream = 'stream'
+        group = 'group'
+        consumer = 'consumer'
+        with pytest.raises(redis.DataError):
+            r.xautoclaim(stream, group, consumer, min_idle_time=-1)
+        with pytest.raises(ValueError):
+            r.xautoclaim(stream, group, consumer, min_idle_time="wrong")
+        with pytest.raises(redis.DataError):
+            r.xautoclaim(stream, group, consumer, min_idle_time=0,
+                         count=-1)
+
     @skip_if_server_version_lt('5.0.0')
     def test_xclaim(self, r):
         stream = 'stream'
         group = 'group'
         consumer1 = 'consumer1'
         consumer2 = 'consumer2'
-
         message_id = r.xadd(stream, {'john': 'wick'})
         message = get_stream_message(r, stream, message_id)
         r.xgroup_create(stream, group, 0)

From 8c4fc802ed03cbebeb15686755e792bc179750e7 Mon Sep 17 00:00:00 2001
From: Binbin <binloveplay1314@qq.com>
Date: Sun, 8 Aug 2021 17:26:30 +0800
Subject: [PATCH 0128/1164] Fix some typos. (#1496)

---
 CHANGES           |  6 +++---
 redis/client.py   | 12 ++++++------
 redis/sentinel.py |  4 ++--
 3 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/CHANGES b/CHANGES
index f4974b8299..4c2ba40f7a 100644
--- a/CHANGES
+++ b/CHANGES
@@ -400,7 +400,7 @@
 * 2.10.2
     * Added support for Hiredis's new bytearray support. Thanks
       https://github.com/tzickel
-    * POSSIBLE BACKWARDS INCOMPATBLE CHANGE: Fixed a possible race condition
+    * POSSIBLE BACKWARDS INCOMPATIBLE CHANGE: Fixed a possible race condition
       when multiple threads share the same Lock instance with a timeout. Lock
       tokens are now stored in thread local storage by default. If you have
       code that acquires a lock in one thread and passes that lock instance to
@@ -455,12 +455,12 @@
     * Fixed Sentinel state parsing on Python 3.
     * Added support for SENTINEL MONITOR, SENTINEL REMOVE, and SENTINEL SET
       commands. Thanks Greg Murphy.
-    * INFO ouput that doesn't follow the "key:value" format will now be
+    * INFO output that doesn't follow the "key:value" format will now be
       appended to a key named "__raw__" in the INFO dictionary. Thanks Pedro
       Larroy.
     * The "vagrant" directory contains a complete vagrant environment for
       redis-py developers. The environment runs a Redis master, a Redis slave,
-      and 3 Sentinels. Future iterations of the test sutie will incorporate
+      and 3 Sentinels. Future iterations of the test suite will incorporate
       more integration style tests, ensuring things like failover happen
       correctly.
     * It's now possible to create connection pool instances from a URL.
diff --git a/redis/client.py b/redis/client.py
index 019ff4f2a7..5d1cd2c306 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -469,7 +469,7 @@ def parse_georadius_generic(response, **options):
         'withhash': int
     }
 
-    # zip all output results with each casting functino to get
+    # zip all output results with each casting function to get
     # the properly native Python value.
     f = [lambda x: x]
     f += [cast[o] for o in ['withdist', 'withhash', 'withcoord'] if options[o]]
@@ -541,7 +541,7 @@ def parse_client_info(value):
         key, value = info.split("=")
         client_info[key] = value
 
-    # Those fields are definded as int in networking.c
+    # Those fields are defined as int in networking.c
     for int_key in {"id", "age", "idle", "db", "sub", "psub",
                     "multi", "qbuf", "qbuf-free", "obl",
                     "argv-mem", "oll", "omem", "tot-mem"}:
@@ -1592,7 +1592,7 @@ def append(self, key, value):
     def bitcount(self, key, start=None, end=None):
         """
         Returns the count of set bits in the value of ``key``.  Optional
-        ``start`` and ``end`` paramaters indicate which bytes to consider
+        ``start`` and ``end`` parameters indicate which bytes to consider
         """
         params = [key]
         if start is not None and end is not None:
@@ -1620,7 +1620,7 @@ def bitop(self, operation, dest, *keys):
     def bitpos(self, key, bit, start=None, end=None):
         """
         Return the position of the first bit set to 1 or 0 in a string.
-        ``start`` and ``end`` difines search range. The range is interpreted
+        ``start`` and ``end`` defines search range. The range is interpreted
         as a range of bytes and not a range of bits, so start=0 and end=2
         means to look at the first three bytes.
         """
@@ -2576,7 +2576,7 @@ def xack(self, name, groupname, *ids):
         Acknowledges the successful processing of one or more messages.
         name: name of the stream.
         groupname: name of the consumer group.
-        *ids: message ids to acknowlege.
+        *ids: message ids to acknowledge.
         """
         return self.execute_command('XACK', name, groupname, *ids)
 
@@ -4510,7 +4510,7 @@ def __call__(self, keys=[], args=[], client=None):
         try:
             return client.evalsha(self.sha, len(keys), *args)
         except NoScriptError:
-            # Maybe the client is pointed to a differnet server than the client
+            # Maybe the client is pointed to a different server than the client
             # that created this instance?
             # Overwrite the sha just in case there was a discrepancy.
             self.sha = client.script_load(self.script)
diff --git a/redis/sentinel.py b/redis/sentinel.py
index b9d77f1c6e..f39e2e7d1a 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -245,7 +245,7 @@ def master_for(self, service_name, redis_class=Redis,
         Returns a redis client instance for the ``service_name`` master.
 
         A :py:class:`~redis.sentinel.SentinelConnectionPool` class is
-        used to retrive the master's address before establishing a new
+        used to retrieve the master's address before establishing a new
         connection.
 
         NOTE: If the master's address has changed, any cached connections to
@@ -274,7 +274,7 @@ def slave_for(self, service_name, redis_class=Redis,
         """
         Returns redis client instance for the ``service_name`` slave(s).
 
-        A SentinelConnectionPool class is used to retrive the slave's
+        A SentinelConnectionPool class is used to retrieve the slave's
         address before establishing a new connection.
 
         By default clients will be a :py:class:`~redis.Redis` instance.

From 2789f08dfb7192f112aa0fc8cec6738dfb1b3a08 Mon Sep 17 00:00:00 2001
From: Jiekun <2014bduck@gmail.com>
Date: Sun, 8 Aug 2021 17:36:17 +0800
Subject: [PATCH 0129/1164] Added GET argument to SET command (#1412)

---
 redis/client.py        | 32 +++++++++++++++++++++++++++++---
 tests/test_commands.py |  8 ++++++++
 2 files changed, 37 insertions(+), 3 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 5d1cd2c306..3c3ab7fd19 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -555,6 +555,20 @@ def parse_module_result(response):
     return True
 
 
+def parse_set_result(response, **options):
+    """
+    Handle SET result since GET argument is available since Redis 6.2.
+    Parsing SET result into:
+    - BOOL
+    - String when GET argument is used
+    """
+    if options.get('get'):
+        # Redis will return a getCommand result.
+        # See `setGenericCommand` in t_string.c
+        return response
+    return response and str_if_bytes(response) == 'OK'
+
+
 class Redis:
     """
     Implementation of the Redis protocol.
@@ -683,7 +697,7 @@ class Redis:
         'SENTINEL SENTINELS': parse_sentinel_slaves_and_sentinels,
         'SENTINEL SET': bool_ok,
         'SENTINEL SLAVES': parse_sentinel_slaves_and_sentinels,
-        'SET': lambda r: r and str_if_bytes(r) == 'OK',
+        'SET': parse_set_result,
         'SLOWLOG GET': parse_slowlog_get,
         'SLOWLOG LEN': int,
         'SLOWLOG RESET': bool_ok,
@@ -1804,6 +1818,9 @@ def getset(self, name, value):
         """
         Sets the value at key ``name`` to ``value``
         and returns the old value at key ``name`` atomically.
+
+        As per Redis 6.2, GETSET is considered deprecated.
+        Please use SET with GET parameter in new code.
         """
         return self.execute_command('GETSET', name, value)
 
@@ -1964,7 +1981,7 @@ def restore(self, name, ttl, value, replace=False, absttl=False):
         return self.execute_command('RESTORE', *params)
 
     def set(self, name, value,
-            ex=None, px=None, nx=False, xx=False, keepttl=False):
+            ex=None, px=None, nx=False, xx=False, keepttl=False, get=False):
         """
         Set the value at key ``name`` to ``value``
 
@@ -1980,8 +1997,13 @@ def set(self, name, value,
 
         ``keepttl`` if True, retain the time to live associated with the key.
             (Available since Redis 6.0)
+
+        ``get`` if True, set the value at key ``name`` to ``value`` and return
+            the old value stored at key, or None when key did not exist.
+            (Available since Redis 6.2)
         """
         pieces = [name, value]
+        options = {}
         if ex is not None:
             pieces.append('EX')
             if isinstance(ex, datetime.timedelta):
@@ -2001,7 +2023,11 @@ def set(self, name, value,
         if keepttl:
             pieces.append('KEEPTTL')
 
-        return self.execute_command('SET', *pieces)
+        if get:
+            pieces.append('GET')
+            options["get"] = True
+
+        return self.execute_command('SET', *pieces, **options)
 
     def __setitem__(self, name, value):
         self.set(name, value)
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 60e667d7ad..76322d70f1 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1006,6 +1006,14 @@ def test_set_keepttl(self, r):
         assert r.get('a') == b'2'
         assert 0 < r.ttl('a') <= 10
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_set_get(self, r):
+        assert r.set('a', 'True', get=True) is None
+        assert r.set('a', 'True', get=True) == b'True'
+        assert r.set('a', 'foo') is True
+        assert r.set('a', 'bar', get=True) == b'foo'
+        assert r.get('a') == b'bar'
+
     def test_setex(self, r):
         assert r.setex('a', 60, '1')
         assert r['a'] == b'1'

From 37e7c093cbeaf7133d5dd7189563d5c15da8d12b Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 15 Aug 2021 13:44:41 +0300
Subject: [PATCH 0130/1164] implementing the LMOVE and BLMOVE commands (#1504)

---
 redis/client.py        | 21 +++++++++++++++++++--
 tests/test_commands.py | 12 ++++++++++++
 2 files changed, 31 insertions(+), 2 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 3c3ab7fd19..a80012a989 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -581,8 +581,8 @@ class Redis:
     """
     RESPONSE_CALLBACKS = {
         **string_keys_to_dict(
-            'AUTH COPY EXPIRE EXPIREAT HEXISTS HMSET MOVE MSETNX PERSIST '
-            'PSETEX RENAMENX SISMEMBER SMOVE SETEX SETNX',
+            'AUTH COPY EXPIRE EXPIREAT HEXISTS HMSET LMOVE BLMOVE MOVE '
+            'MSETNX PERSIST PSETEX RENAMENX SISMEMBER SMOVE SETEX SETNX',
             bool
         ),
         **string_keys_to_dict(
@@ -1851,6 +1851,23 @@ def keys(self, pattern='*'):
         "Returns a list of keys matching ``pattern``"
         return self.execute_command('KEYS', pattern)
 
+    def lmove(self, first_list, second_list, src="LEFT", dest="RIGHT"):
+        """
+        Atomically returns and removes the first/last element of a list,
+        pushing it as the first/last element on the destination list.
+        Returns the element being popped and pushed.
+        """
+        params = [first_list, second_list, src, dest]
+        return self.execute_command("LMOVE", *params)
+
+    def blmove(self, first_list, second_list, timeout,
+               src="LEFT", dest="RIGHT"):
+        """
+        Blocking version of lmove.
+        """
+        params = [first_list, second_list, src, dest, timeout]
+        return self.execute_command("BLMOVE", *params)
+
     def mget(self, keys, *args):
         """
         Returns a list of values ordered identically to ``keys``
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 76322d70f1..736aec95bd 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -849,6 +849,18 @@ def test_mget(self, r):
         r['c'] = '3'
         assert r.mget('a', 'other', 'b', 'c') == [b'1', None, b'2', b'3']
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_lmove(self, r):
+        r.rpush('a', 'one', 'two', 'three', 'four')
+        assert r.lmove('a', 'b')
+        assert r.lmove('a', 'b', 'right', 'left')
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_blmove(self, r):
+        r.rpush('a', 'one', 'two', 'three', 'four')
+        assert r.blmove('a', 'b', 5)
+        assert r.blmove('a', 'b', 1, 'RIGHT', 'LEFT')
+
     def test_mset(self, r):
         d = {'a': b'1', 'b': b'2', 'c': b'3'}
         assert r.mset(d)

From e498182b8e208911ea2454838109fb1249b83c5c Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 15 Aug 2021 13:46:01 +0300
Subject: [PATCH 0131/1164] MINID and LIMIT support for xtrim (#1508)

---
 redis/client.py        | 24 +++++++++++++++++++++---
 tests/test_commands.py | 41 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 62 insertions(+), 3 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index a80012a989..2d47574908 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -2979,17 +2979,35 @@ def xrevrange(self, name, max='+', min='-', count=None):
 
         return self.execute_command('XREVRANGE', name, *pieces)
 
-    def xtrim(self, name, maxlen, approximate=True):
+    def xtrim(self, name, maxlen=None, approximate=True, minid=None,
+              limit=None):
         """
         Trims old messages from a stream.
         name: name of the stream.
         maxlen: truncate old stream messages beyond this size
         approximate: actual stream length may be slightly more than maxlen
+        minin: the minimum id in the stream to query
+        limit: specifies the maximum number of entries to retrieve
         """
-        pieces = [b'MAXLEN']
+        pieces = []
+        if maxlen is not None and minid is not None:
+            raise DataError("Only one of ```maxlen``` or ```minid```",
+                            "may be specified")
+
+        if maxlen is not None:
+            pieces.append(b'MAXLEN')
+        if minid is not None:
+            pieces.append(b'MINID')
         if approximate:
             pieces.append(b'~')
-        pieces.append(maxlen)
+        if maxlen is not None:
+            pieces.append(maxlen)
+        if minid is not None:
+            pieces.append(minid)
+        if limit is not None:
+            pieces.append(b"LIMIT")
+            pieces.append(limit)
+
         return self.execute_command('XTRIM', name, *pieces)
 
     # SORTED SET COMMANDS
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 736aec95bd..dff48b7eb8 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2927,6 +2927,47 @@ def test_xtrim(self, r):
         # 1 message is trimmed
         assert r.xtrim(stream, 3, approximate=False) == 1
 
+    @skip_if_server_version_lt('6.2.4')
+    def test_xtrim_minlen_and_length_args(self, r):
+        stream = 'stream'
+
+        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+
+        # Future self: No limits without approximate, according to the api
+        with pytest.raises(redis.ResponseError):
+            assert r.xtrim(stream, 3, approximate=False, limit=2)
+
+        # maxlen with a limit
+        assert r.xtrim(stream, 3, approximate=True, limit=2) == 0
+        r.delete(stream)
+
+        with pytest.raises(redis.DataError):
+            assert r.xtrim(stream, maxlen=3, minid="sometestvalue")
+
+        # minid with a limit
+        m1 = r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+        assert r.xtrim(stream, None, approximate=True, minid=m1, limit=3) == 0
+
+        # pure minid
+        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+        m4 = r.xadd(stream, {'foo': 'bar'})
+        assert r.xtrim(stream, None, approximate=False, minid=m4) == 7
+
+        # minid approximate
+        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+        m3 = r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+        assert r.xtrim(stream, None, approximate=True, minid=m3) == 0
+
     def test_bitfield_operations(self, r):
         # comments show affected bits
         bf = r.bitfield('a')

From 161774be431f2de3c44037698ac311735d559636 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 15 Aug 2021 14:07:44 +0300
Subject: [PATCH 0132/1164] Adding support for CLIENT LIST with ID (#1505)

---
 redis/client.py        | 15 +++++++++------
 tests/test_commands.py |  8 ++++++++
 2 files changed, 17 insertions(+), 6 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 2d47574908..28e3ac11b4 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1276,7 +1276,7 @@ def client_info(self):
         """
         return self.execute_command('CLIENT INFO')
 
-    def client_list(self, _type=None):
+    def client_list(self, _type=None, client_id=None):
         """
         Returns a list of currently connected clients.
         If type of client specified, only that type will be returned.
@@ -1284,13 +1284,18 @@ def client_list(self, _type=None):
          replica, pubsub)
         """
         "Returns a list of currently connected clients"
+        args = []
         if _type is not None:
             client_types = ('normal', 'master', 'replica', 'pubsub')
             if str(_type).lower() not in client_types:
                 raise DataError("CLIENT LIST _type must be one of %r" % (
                                 client_types,))
-            return self.execute_command('CLIENT LIST', b'TYPE', _type)
-        return self.execute_command('CLIENT LIST')
+            args.append(b'TYPE')
+            args.append(_type)
+        if client_id is not None:
+            args.append(b"ID")
+            args.append(client_id)
+        return self.execute_command('CLIENT LIST', *args)
 
     def client_getname(self):
         "Returns the current connection name"
@@ -3053,9 +3058,7 @@ def zadd(self, name, mapping, nx=False, xx=False, ch=False, incr=False,
             raise DataError("ZADD option 'incr' only works when passing a "
                             "single element/score pair")
         if nx is True and (gt is not None or lt is not None):
-            raise DataError("Only one of 'nx', 'lt', or 'gt' may be defined.")
-        if gt is not None and lt is not None:
-            raise DataError("Only one of 'gt' or 'lt' can be set.")
+            raise DataError("Only one of 'nx', 'lt', or 'gr' may be defined.")
 
         pieces = []
         options = {}
diff --git a/tests/test_commands.py b/tests/test_commands.py
index dff48b7eb8..9a618aab1c 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -295,6 +295,14 @@ def test_client_list_type(self, r):
             clients = r.client_list(_type=client_type)
             assert isinstance(clients, list)
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_client_list_client_id(self, r):
+        clients = r.client_list()
+        client_id = clients[0]['id']
+        clients = r.client_list(client_id=client_id)
+        assert len(clients) == 1
+        assert 'addr' in clients[0]
+
     @skip_if_server_version_lt('5.0.0')
     def test_client_id(self, r):
         assert r.client_id() > 0

From 8c82e429224e0fb7f1739f741e63f23126e3c088 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Sun, 15 Aug 2021 14:13:28 +0300
Subject: [PATCH 0133/1164] Zunion (#1522)

* zinter

* change options in _zaggregate

* skip for previous versions

* add client function

* validate the aggregate value

* change options to get

* add more aggregate tests

* add weights guidance
---
 redis/client.py        | 12 +++++++++++-
 tests/test_commands.py | 20 ++++++++++++++++++++
 2 files changed, 31 insertions(+), 1 deletion(-)

diff --git a/redis/client.py b/redis/client.py
index 28e3ac11b4..f50c27ef4b 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -615,7 +615,7 @@ class Redis:
             lambda r: r and set(r) or set()
         ),
         **string_keys_to_dict(
-            'ZPOPMAX ZPOPMIN ZINTER ZDIFF ZRANGE ZRANGEBYSCORE '
+            'ZPOPMAX ZPOPMIN ZINTER ZDIFF ZUNION ZRANGE ZRANGEBYSCORE '
             'ZREVRANGE ZREVRANGEBYSCORE', zset_score_pairs
         ),
         **string_keys_to_dict('BZPOPMIN BZPOPMAX', \
@@ -3416,6 +3416,16 @@ def zscore(self, name, value):
         "Return the score of element ``value`` in sorted set ``name``"
         return self.execute_command('ZSCORE', name, value)
 
+    def zunion(self, keys, aggregate=None, withscores=False):
+        """
+        Return the union of multiple sorted sets specified by ``keys``.
+        ``keys`` can be provided as dictionary of keys and their weights.
+        Scores will be aggregated based on the ``aggregate``, or SUM if
+        none is provided.
+        """
+        return self._zaggregate('ZUNION', None, keys, aggregate,
+                                withscores=withscores)
+
     def zunionstore(self, dest, keys, aggregate=None):
         """
         Union multiple sorted sets specified by ``keys`` into
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 9a618aab1c..3c87dd9dd6 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1813,6 +1813,26 @@ def test_zscore(self, r):
         assert r.zscore('a', 'a2') == 2.0
         assert r.zscore('a', 'a4') is None
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_zunion(self, r):
+        r.zadd('a', {'a1': 1, 'a2': 1, 'a3': 1})
+        r.zadd('b', {'a1': 2, 'a2': 2, 'a3': 2})
+        r.zadd('c', {'a1': 6, 'a3': 5, 'a4': 4})
+        # sum
+        assert r.zunion(['a', 'b', 'c']) == \
+            [b'a2', b'a4', b'a3', b'a1']
+        assert r.zunion(['a', 'b', 'c'], withscores=True) == \
+            [(b'a2', 3), (b'a4', 4), (b'a3', 8), (b'a1', 9)]
+        # max
+        assert r.zunion(['a', 'b', 'c'], aggregate='MAX', withscores=True)\
+               == [(b'a2', 2), (b'a4', 4), (b'a3', 5), (b'a1', 6)]
+        # min
+        assert r.zunion(['a', 'b', 'c'], aggregate='MIN', withscores=True)\
+               == [(b'a1', 1), (b'a2', 1), (b'a3', 1), (b'a4', 4)]
+        # with weight
+        assert r.zunion({'a': 1, 'b': 2, 'c': 3}, withscores=True)\
+               == [(b'a2', 5), (b'a4', 12), (b'a3', 20), (b'a1', 23)]
+
     def test_zunionstore_sum(self, r):
         r.zadd('a', {'a1': 1, 'a2': 1, 'a3': 1})
         r.zadd('b', {'a1': 2, 'a2': 2, 'a3': 2})

From 8ea26c4f5c82a3fde5dd2fb209d0c8644714626d Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 18 Aug 2021 09:51:57 +0300
Subject: [PATCH 0134/1164] Migrating commands to a mixin (#1534)

* Moving redis commands to a mixin

This patterns allows for the reuse of these commands across connection types, including modules that are based on this client

* splitting sentinel specific commands into the respective mixin
---
 redis/client.py   | 2855 +-----------------------------------------
 redis/commands.py | 2995 +++++++++++++++++++++++++++++++++++++++++++++
 redis/sentinel.py |    3 +-
 3 files changed, 3007 insertions(+), 2846 deletions(-)
 create mode 100644 redis/commands.py

diff --git a/redis/client.py b/redis/client.py
index f50c27ef4b..741c2d0226 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1,25 +1,27 @@
 from itertools import chain
 import datetime
-import warnings
-import time
-import threading
-import time as mod_time
-import re
 import hashlib
+import re
+import threading
+import time
+import warnings
+from redis.commands import (
+    list_or_args,
+    Commands
+)
 from redis.connection import (ConnectionPool, UnixDomainSocketConnection,
                               SSLConnection)
 from redis.lock import Lock
 from redis.exceptions import (
     ConnectionError,
-    DataError,
     ExecAbortError,
+    ModuleError,
     NoScriptError,
     PubSubError,
     RedisError,
     ResponseError,
     TimeoutError,
     WatchError,
-    ModuleError,
 )
 from redis.utils import safe_str, str_if_bytes
 
@@ -27,23 +29,6 @@
 EMPTY_RESPONSE = 'EMPTY_RESPONSE'
 
 
-def list_or_args(keys, args):
-    # returns a single new list combining keys and args
-    try:
-        iter(keys)
-        # a string or bytes instance can be iterated, but indicates
-        # keys wasn't passed as a list
-        if isinstance(keys, (bytes, str)):
-            keys = [keys]
-        else:
-            keys = list(keys)
-    except TypeError:
-        keys = [keys]
-    if args:
-        keys.extend(args)
-    return keys
-
-
 def timestamp_to_datetime(response):
     "Converts a unix timestamp to a Python datetime object"
     if not response:
@@ -569,7 +554,7 @@ def parse_set_result(response, **options):
     return response and str_if_bytes(response) == 'OK'
 
 
-class Redis:
+class Redis(Commands, object):
     """
     Implementation of the Redis protocol.
 
@@ -986,2826 +971,6 @@ def parse_response(self, connection, command_name, **options):
             return self.response_callbacks[command_name](response, **options)
         return response
 
-    # SERVER INFORMATION
-
-    # ACL methods
-    def acl_cat(self, category=None):
-        """
-        Returns a list of categories or commands within a category.
-
-        If ``category`` is not supplied, returns a list of all categories.
-        If ``category`` is supplied, returns a list of all commands within
-        that category.
-        """
-        pieces = [category] if category else []
-        return self.execute_command('ACL CAT', *pieces)
-
-    def acl_deluser(self, username):
-        "Delete the ACL for the specified ``username``"
-        return self.execute_command('ACL DELUSER', username)
-
-    def acl_genpass(self):
-        "Generate a random password value"
-        return self.execute_command('ACL GENPASS')
-
-    def acl_getuser(self, username):
-        """
-        Get the ACL details for the specified ``username``.
-
-        If ``username`` does not exist, return None
-        """
-        return self.execute_command('ACL GETUSER', username)
-
-    def acl_list(self):
-        "Return a list of all ACLs on the server"
-        return self.execute_command('ACL LIST')
-
-    def acl_log(self, count=None):
-        """
-        Get ACL logs as a list.
-        :param int count: Get logs[0:count].
-        :rtype: List.
-        """
-        args = []
-        if count is not None:
-            if not isinstance(count, int):
-                raise DataError('ACL LOG count must be an '
-                                'integer')
-            args.append(count)
-
-        return self.execute_command('ACL LOG', *args)
-
-    def acl_log_reset(self):
-        """
-        Reset ACL logs.
-        :rtype: Boolean.
-        """
-        args = [b'RESET']
-        return self.execute_command('ACL LOG', *args)
-
-    def acl_load(self):
-        """
-        Load ACL rules from the configured ``aclfile``.
-
-        Note that the server must be configured with the ``aclfile``
-        directive to be able to load ACL rules from an aclfile.
-        """
-        return self.execute_command('ACL LOAD')
-
-    def acl_save(self):
-        """
-        Save ACL rules to the configured ``aclfile``.
-
-        Note that the server must be configured with the ``aclfile``
-        directive to be able to save ACL rules to an aclfile.
-        """
-        return self.execute_command('ACL SAVE')
-
-    def acl_setuser(self, username, enabled=False, nopass=False,
-                    passwords=None, hashed_passwords=None, categories=None,
-                    commands=None, keys=None, reset=False, reset_keys=False,
-                    reset_passwords=False):
-        """
-        Create or update an ACL user.
-
-        Create or update the ACL for ``username``. If the user already exists,
-        the existing ACL is completely overwritten and replaced with the
-        specified values.
-
-        ``enabled`` is a boolean indicating whether the user should be allowed
-        to authenticate or not. Defaults to ``False``.
-
-        ``nopass`` is a boolean indicating whether the can authenticate without
-        a password. This cannot be True if ``passwords`` are also specified.
-
-        ``passwords`` if specified is a list of plain text passwords
-        to add to or remove from the user. Each password must be prefixed with
-        a '+' to add or a '-' to remove. For convenience, the value of
-        ``passwords`` can be a simple prefixed string when adding or
-        removing a single password.
-
-        ``hashed_passwords`` if specified is a list of SHA-256 hashed passwords
-        to add to or remove from the user. Each hashed password must be
-        prefixed with a '+' to add or a '-' to remove. For convenience,
-        the value of ``hashed_passwords`` can be a simple prefixed string when
-        adding or removing a single password.
-
-        ``categories`` if specified is a list of strings representing category
-        permissions. Each string must be prefixed with either a '+' to add the
-        category permission or a '-' to remove the category permission.
-
-        ``commands`` if specified is a list of strings representing command
-        permissions. Each string must be prefixed with either a '+' to add the
-        command permission or a '-' to remove the command permission.
-
-        ``keys`` if specified is a list of key patterns to grant the user
-        access to. Keys patterns allow '*' to support wildcard matching. For
-        example, '*' grants access to all keys while 'cache:*' grants access
-        to all keys that are prefixed with 'cache:'. ``keys`` should not be
-        prefixed with a '~'.
-
-        ``reset`` is a boolean indicating whether the user should be fully
-        reset prior to applying the new ACL. Setting this to True will
-        remove all existing passwords, flags and privileges from the user and
-        then apply the specified rules. If this is False, the user's existing
-        passwords, flags and privileges will be kept and any new specified
-        rules will be applied on top.
-
-        ``reset_keys`` is a boolean indicating whether the user's key
-        permissions should be reset prior to applying any new key permissions
-        specified in ``keys``. If this is False, the user's existing
-        key permissions will be kept and any new specified key permissions
-        will be applied on top.
-
-        ``reset_passwords`` is a boolean indicating whether to remove all
-        existing passwords and the 'nopass' flag from the user prior to
-        applying any new passwords specified in 'passwords' or
-        'hashed_passwords'. If this is False, the user's existing passwords
-        and 'nopass' status will be kept and any new specified passwords
-        or hashed_passwords will be applied on top.
-        """
-        encoder = self.connection_pool.get_encoder()
-        pieces = [username]
-
-        if reset:
-            pieces.append(b'reset')
-
-        if reset_keys:
-            pieces.append(b'resetkeys')
-
-        if reset_passwords:
-            pieces.append(b'resetpass')
-
-        if enabled:
-            pieces.append(b'on')
-        else:
-            pieces.append(b'off')
-
-        if (passwords or hashed_passwords) and nopass:
-            raise DataError('Cannot set \'nopass\' and supply '
-                            '\'passwords\' or \'hashed_passwords\'')
-
-        if passwords:
-            # as most users will have only one password, allow remove_passwords
-            # to be specified as a simple string or a list
-            passwords = list_or_args(passwords, [])
-            for i, password in enumerate(passwords):
-                password = encoder.encode(password)
-                if password.startswith(b'+'):
-                    pieces.append(b'>%s' % password[1:])
-                elif password.startswith(b'-'):
-                    pieces.append(b'<%s' % password[1:])
-                else:
-                    raise DataError('Password %d must be prefixeed with a '
-                                    '"+" to add or a "-" to remove' % i)
-
-        if hashed_passwords:
-            # as most users will have only one password, allow remove_passwords
-            # to be specified as a simple string or a list
-            hashed_passwords = list_or_args(hashed_passwords, [])
-            for i, hashed_password in enumerate(hashed_passwords):
-                hashed_password = encoder.encode(hashed_password)
-                if hashed_password.startswith(b'+'):
-                    pieces.append(b'#%s' % hashed_password[1:])
-                elif hashed_password.startswith(b'-'):
-                    pieces.append(b'!%s' % hashed_password[1:])
-                else:
-                    raise DataError('Hashed %d password must be prefixeed '
-                                    'with a "+" to add or a "-" to remove' % i)
-
-        if nopass:
-            pieces.append(b'nopass')
-
-        if categories:
-            for category in categories:
-                category = encoder.encode(category)
-                # categories can be prefixed with one of (+@, +, -@, -)
-                if category.startswith(b'+@'):
-                    pieces.append(category)
-                elif category.startswith(b'+'):
-                    pieces.append(b'+@%s' % category[1:])
-                elif category.startswith(b'-@'):
-                    pieces.append(category)
-                elif category.startswith(b'-'):
-                    pieces.append(b'-@%s' % category[1:])
-                else:
-                    raise DataError('Category "%s" must be prefixed with '
-                                    '"+" or "-"'
-                                    % encoder.decode(category, force=True))
-        if commands:
-            for cmd in commands:
-                cmd = encoder.encode(cmd)
-                if not cmd.startswith(b'+') and not cmd.startswith(b'-'):
-                    raise DataError('Command "%s" must be prefixed with '
-                                    '"+" or "-"'
-                                    % encoder.decode(cmd, force=True))
-                pieces.append(cmd)
-
-        if keys:
-            for key in keys:
-                key = encoder.encode(key)
-                pieces.append(b'~%s' % key)
-
-        return self.execute_command('ACL SETUSER', *pieces)
-
-    def acl_users(self):
-        "Returns a list of all registered users on the server."
-        return self.execute_command('ACL USERS')
-
-    def acl_whoami(self):
-        "Get the username for the current connection"
-        return self.execute_command('ACL WHOAMI')
-
-    def bgrewriteaof(self):
-        "Tell the Redis server to rewrite the AOF file from data in memory."
-        return self.execute_command('BGREWRITEAOF')
-
-    def bgsave(self):
-        """
-        Tell the Redis server to save its data to disk.  Unlike save(),
-        this method is asynchronous and returns immediately.
-        """
-        return self.execute_command('BGSAVE')
-
-    def client_kill(self, address):
-        "Disconnects the client at ``address`` (ip:port)"
-        return self.execute_command('CLIENT KILL', address)
-
-    def client_kill_filter(self, _id=None, _type=None, addr=None,
-                           skipme=None, laddr=None):
-        """
-        Disconnects client(s) using a variety of filter options
-        :param id: Kills a client by its unique ID field
-        :param type: Kills a client by type where type is one of 'normal',
-        'master', 'slave' or 'pubsub'
-        :param addr: Kills a client by its 'address:port'
-        :param skipme: If True, then the client calling the command
-        :param laddr: Kills a cient by its 'local (bind)  address:port'
-        will not get killed even if it is identified by one of the filter
-        options. If skipme is not provided, the server defaults to skipme=True
-        """
-        args = []
-        if _type is not None:
-            client_types = ('normal', 'master', 'slave', 'pubsub')
-            if str(_type).lower() not in client_types:
-                raise DataError("CLIENT KILL type must be one of %r" % (
-                                client_types,))
-            args.extend((b'TYPE', _type))
-        if skipme is not None:
-            if not isinstance(skipme, bool):
-                raise DataError("CLIENT KILL skipme must be a bool")
-            if skipme:
-                args.extend((b'SKIPME', b'YES'))
-            else:
-                args.extend((b'SKIPME', b'NO'))
-        if _id is not None:
-            args.extend((b'ID', _id))
-        if addr is not None:
-            args.extend((b'ADDR', addr))
-        if laddr is not None:
-            args.extend((b'LADDR', laddr))
-        if not args:
-            raise DataError("CLIENT KILL <filter> <value> ... ... <filter> "
-                            "<value> must specify at least one filter")
-        return self.execute_command('CLIENT KILL', *args)
-
-    def client_info(self):
-        """
-        Returns information and statistics about the current
-        client connection.
-        """
-        return self.execute_command('CLIENT INFO')
-
-    def client_list(self, _type=None, client_id=None):
-        """
-        Returns a list of currently connected clients.
-        If type of client specified, only that type will be returned.
-        :param _type: optional. one of the client types (normal, master,
-         replica, pubsub)
-        """
-        "Returns a list of currently connected clients"
-        args = []
-        if _type is not None:
-            client_types = ('normal', 'master', 'replica', 'pubsub')
-            if str(_type).lower() not in client_types:
-                raise DataError("CLIENT LIST _type must be one of %r" % (
-                                client_types,))
-            args.append(b'TYPE')
-            args.append(_type)
-        if client_id is not None:
-            args.append(b"ID")
-            args.append(client_id)
-        return self.execute_command('CLIENT LIST', *args)
-
-    def client_getname(self):
-        "Returns the current connection name"
-        return self.execute_command('CLIENT GETNAME')
-
-    def client_id(self):
-        "Returns the current connection id"
-        return self.execute_command('CLIENT ID')
-
-    def client_setname(self, name):
-        "Sets the current connection name"
-        return self.execute_command('CLIENT SETNAME', name)
-
-    def client_unblock(self, client_id, error=False):
-        """
-        Unblocks a connection by its client id.
-        If ``error`` is True, unblocks the client with a special error message.
-        If ``error`` is False (default), the client is unblocked using the
-        regular timeout mechanism.
-        """
-        args = ['CLIENT UNBLOCK', int(client_id)]
-        if error:
-            args.append(b'ERROR')
-        return self.execute_command(*args)
-
-    def client_pause(self, timeout):
-        """
-        Suspend all the Redis clients for the specified amount of time
-        :param timeout: milliseconds to pause clients
-        """
-        if not isinstance(timeout, int):
-            raise DataError("CLIENT PAUSE timeout must be an integer")
-        return self.execute_command('CLIENT PAUSE', str(timeout))
-
-    def client_unpause(self):
-        """
-        Unpause all redis clients
-        """
-        return self.execute_command('CLIENT UNPAUSE')
-
-    def readwrite(self):
-        "Disables read queries for a connection to a Redis Cluster slave node"
-        return self.execute_command('READWRITE')
-
-    def readonly(self):
-        "Enables read queries for a connection to a Redis Cluster replica node"
-        return self.execute_command('READONLY')
-
-    def config_get(self, pattern="*"):
-        "Return a dictionary of configuration based on the ``pattern``"
-        return self.execute_command('CONFIG GET', pattern)
-
-    def config_set(self, name, value):
-        "Set config item ``name`` with ``value``"
-        return self.execute_command('CONFIG SET', name, value)
-
-    def config_resetstat(self):
-        "Reset runtime statistics"
-        return self.execute_command('CONFIG RESETSTAT')
-
-    def config_rewrite(self):
-        "Rewrite config file with the minimal change to reflect running config"
-        return self.execute_command('CONFIG REWRITE')
-
-    def dbsize(self):
-        "Returns the number of keys in the current database"
-        return self.execute_command('DBSIZE')
-
-    def debug_object(self, key):
-        "Returns version specific meta information about a given key"
-        return self.execute_command('DEBUG OBJECT', key)
-
-    def echo(self, value):
-        "Echo the string back from the server"
-        return self.execute_command('ECHO', value)
-
-    def flushall(self, asynchronous=False):
-        """
-        Delete all keys in all databases on the current host.
-
-        ``asynchronous`` indicates whether the operation is
-        executed asynchronously by the server.
-        """
-        args = []
-        if asynchronous:
-            args.append(b'ASYNC')
-        return self.execute_command('FLUSHALL', *args)
-
-    def flushdb(self, asynchronous=False):
-        """
-        Delete all keys in the current database.
-
-        ``asynchronous`` indicates whether the operation is
-        executed asynchronously by the server.
-        """
-        args = []
-        if asynchronous:
-            args.append(b'ASYNC')
-        return self.execute_command('FLUSHDB', *args)
-
-    def swapdb(self, first, second):
-        "Swap two databases"
-        return self.execute_command('SWAPDB', first, second)
-
-    def info(self, section=None):
-        """
-        Returns a dictionary containing information about the Redis server
-
-        The ``section`` option can be used to select a specific section
-        of information
-
-        The section option is not supported by older versions of Redis Server,
-        and will generate ResponseError
-        """
-        if section is None:
-            return self.execute_command('INFO')
-        else:
-            return self.execute_command('INFO', section)
-
-    def lastsave(self):
-        """
-        Return a Python datetime object representing the last time the
-        Redis database was saved to disk
-        """
-        return self.execute_command('LASTSAVE')
-
-    def migrate(self, host, port, keys, destination_db, timeout,
-                copy=False, replace=False, auth=None):
-        """
-        Migrate 1 or more keys from the current Redis server to a different
-        server specified by the ``host``, ``port`` and ``destination_db``.
-
-        The ``timeout``, specified in milliseconds, indicates the maximum
-        time the connection between the two servers can be idle before the
-        command is interrupted.
-
-        If ``copy`` is True, the specified ``keys`` are NOT deleted from
-        the source server.
-
-        If ``replace`` is True, this operation will overwrite the keys
-        on the destination server if they exist.
-
-        If ``auth`` is specified, authenticate to the destination server with
-        the password provided.
-        """
-        keys = list_or_args(keys, [])
-        if not keys:
-            raise DataError('MIGRATE requires at least one key')
-        pieces = []
-        if copy:
-            pieces.append(b'COPY')
-        if replace:
-            pieces.append(b'REPLACE')
-        if auth:
-            pieces.append(b'AUTH')
-            pieces.append(auth)
-        pieces.append(b'KEYS')
-        pieces.extend(keys)
-        return self.execute_command('MIGRATE', host, port, '', destination_db,
-                                    timeout, *pieces)
-
-    def object(self, infotype, key):
-        "Return the encoding, idletime, or refcount about the key"
-        return self.execute_command('OBJECT', infotype, key, infotype=infotype)
-
-    def memory_stats(self):
-        "Return a dictionary of memory stats"
-        return self.execute_command('MEMORY STATS')
-
-    def memory_usage(self, key, samples=None):
-        """
-        Return the total memory usage for key, its value and associated
-        administrative overheads.
-
-        For nested data structures, ``samples`` is the number of elements to
-        sample. If left unspecified, the server's default is 5. Use 0 to sample
-        all elements.
-        """
-        args = []
-        if isinstance(samples, int):
-            args.extend([b'SAMPLES', samples])
-        return self.execute_command('MEMORY USAGE', key, *args)
-
-    def memory_purge(self):
-        "Attempts to purge dirty pages for reclamation by allocator"
-        return self.execute_command('MEMORY PURGE')
-
-    def ping(self):
-        "Ping the Redis server"
-        return self.execute_command('PING')
-
-    def save(self):
-        """
-        Tell the Redis server to save its data to disk,
-        blocking until the save is complete
-        """
-        return self.execute_command('SAVE')
-
-    def sentinel(self, *args):
-        "Redis Sentinel's SENTINEL command."
-        warnings.warn(
-            DeprecationWarning('Use the individual sentinel_* methods'))
-
-    def sentinel_get_master_addr_by_name(self, service_name):
-        "Returns a (host, port) pair for the given ``service_name``"
-        return self.execute_command('SENTINEL GET-MASTER-ADDR-BY-NAME',
-                                    service_name)
-
-    def sentinel_master(self, service_name):
-        "Returns a dictionary containing the specified masters state."
-        return self.execute_command('SENTINEL MASTER', service_name)
-
-    def sentinel_masters(self):
-        "Returns a list of dictionaries containing each master's state."
-        return self.execute_command('SENTINEL MASTERS')
-
-    def sentinel_monitor(self, name, ip, port, quorum):
-        "Add a new master to Sentinel to be monitored"
-        return self.execute_command('SENTINEL MONITOR', name, ip, port, quorum)
-
-    def sentinel_remove(self, name):
-        "Remove a master from Sentinel's monitoring"
-        return self.execute_command('SENTINEL REMOVE', name)
-
-    def sentinel_sentinels(self, service_name):
-        "Returns a list of sentinels for ``service_name``"
-        return self.execute_command('SENTINEL SENTINELS', service_name)
-
-    def sentinel_set(self, name, option, value):
-        "Set Sentinel monitoring parameters for a given master"
-        return self.execute_command('SENTINEL SET', name, option, value)
-
-    def sentinel_slaves(self, service_name):
-        "Returns a list of slaves for ``service_name``"
-        return self.execute_command('SENTINEL SLAVES', service_name)
-
-    def shutdown(self, save=False, nosave=False):
-        """Shutdown the Redis server.  If Redis has persistence configured,
-        data will be flushed before shutdown.  If the "save" option is set,
-        a data flush will be attempted even if there is no persistence
-        configured.  If the "nosave" option is set, no data flush will be
-        attempted.  The "save" and "nosave" options cannot both be set.
-        """
-        if save and nosave:
-            raise DataError('SHUTDOWN save and nosave cannot both be set')
-        args = ['SHUTDOWN']
-        if save:
-            args.append('SAVE')
-        if nosave:
-            args.append('NOSAVE')
-        try:
-            self.execute_command(*args)
-        except ConnectionError:
-            # a ConnectionError here is expected
-            return
-        raise RedisError("SHUTDOWN seems to have failed.")
-
-    def slaveof(self, host=None, port=None):
-        """
-        Set the server to be a replicated slave of the instance identified
-        by the ``host`` and ``port``. If called without arguments, the
-        instance is promoted to a master instead.
-        """
-        if host is None and port is None:
-            return self.execute_command('SLAVEOF', b'NO', b'ONE')
-        return self.execute_command('SLAVEOF', host, port)
-
-    def slowlog_get(self, num=None):
-        """
-        Get the entries from the slowlog. If ``num`` is specified, get the
-        most recent ``num`` items.
-        """
-        args = ['SLOWLOG GET']
-        if num is not None:
-            args.append(num)
-        decode_responses = self.connection_pool.connection_kwargs.get(
-            'decode_responses', False)
-        return self.execute_command(*args, decode_responses=decode_responses)
-
-    def slowlog_len(self):
-        "Get the number of items in the slowlog"
-        return self.execute_command('SLOWLOG LEN')
-
-    def slowlog_reset(self):
-        "Remove all items in the slowlog"
-        return self.execute_command('SLOWLOG RESET')
-
-    def time(self):
-        """
-        Returns the server time as a 2-item tuple of ints:
-        (seconds since epoch, microseconds into this second).
-        """
-        return self.execute_command('TIME')
-
-    def wait(self, num_replicas, timeout):
-        """
-        Redis synchronous replication
-        That returns the number of replicas that processed the query when
-        we finally have at least ``num_replicas``, or when the ``timeout`` was
-        reached.
-        """
-        return self.execute_command('WAIT', num_replicas, timeout)
-
-    # BASIC KEY COMMANDS
-    def append(self, key, value):
-        """
-        Appends the string ``value`` to the value at ``key``. If ``key``
-        doesn't already exist, create it with a value of ``value``.
-        Returns the new length of the value at ``key``.
-        """
-        return self.execute_command('APPEND', key, value)
-
-    def bitcount(self, key, start=None, end=None):
-        """
-        Returns the count of set bits in the value of ``key``.  Optional
-        ``start`` and ``end`` parameters indicate which bytes to consider
-        """
-        params = [key]
-        if start is not None and end is not None:
-            params.append(start)
-            params.append(end)
-        elif (start is not None and end is None) or \
-                (end is not None and start is None):
-            raise DataError("Both start and end must be specified")
-        return self.execute_command('BITCOUNT', *params)
-
-    def bitfield(self, key, default_overflow=None):
-        """
-        Return a BitFieldOperation instance to conveniently construct one or
-        more bitfield operations on ``key``.
-        """
-        return BitFieldOperation(self, key, default_overflow=default_overflow)
-
-    def bitop(self, operation, dest, *keys):
-        """
-        Perform a bitwise operation using ``operation`` between ``keys`` and
-        store the result in ``dest``.
-        """
-        return self.execute_command('BITOP', operation, dest, *keys)
-
-    def bitpos(self, key, bit, start=None, end=None):
-        """
-        Return the position of the first bit set to 1 or 0 in a string.
-        ``start`` and ``end`` defines search range. The range is interpreted
-        as a range of bytes and not a range of bits, so start=0 and end=2
-        means to look at the first three bytes.
-        """
-        if bit not in (0, 1):
-            raise DataError('bit must be 0 or 1')
-        params = [key, bit]
-
-        start is not None and params.append(start)
-
-        if start is not None and end is not None:
-            params.append(end)
-        elif start is None and end is not None:
-            raise DataError("start argument is not set, "
-                            "when end is specified")
-        return self.execute_command('BITPOS', *params)
-
-    def copy(self, source, destination, destination_db=None, replace=False):
-        """
-        Copy the value stored in the ``source`` key to the ``destination`` key.
-
-        ``destination_db`` an alternative destination database. By default,
-        the ``destination`` key is created in the source Redis database.
-
-        ``replace`` whether the ``destination`` key should be removed before
-        copying the value to it. By default, the value is not copied if
-        the ``destination`` key already exists.
-        """
-        params = [source, destination]
-        if destination_db is not None:
-            params.extend(["DB", destination_db])
-        if replace:
-            params.append("REPLACE")
-        return self.execute_command('COPY', *params)
-
-    def decr(self, name, amount=1):
-        """
-        Decrements the value of ``key`` by ``amount``.  If no key exists,
-        the value will be initialized as 0 - ``amount``
-        """
-        # An alias for ``decr()``, because it is already implemented
-        # as DECRBY redis command.
-        return self.decrby(name, amount)
-
-    def decrby(self, name, amount=1):
-        """
-        Decrements the value of ``key`` by ``amount``.  If no key exists,
-        the value will be initialized as 0 - ``amount``
-        """
-        return self.execute_command('DECRBY', name, amount)
-
-    def delete(self, *names):
-        "Delete one or more keys specified by ``names``"
-        return self.execute_command('DEL', *names)
-
-    def __delitem__(self, name):
-        self.delete(name)
-
-    def dump(self, name):
-        """
-        Return a serialized version of the value stored at the specified key.
-        If key does not exist a nil bulk reply is returned.
-        """
-        return self.execute_command('DUMP', name)
-
-    def exists(self, *names):
-        "Returns the number of ``names`` that exist"
-        return self.execute_command('EXISTS', *names)
-    __contains__ = exists
-
-    def expire(self, name, time):
-        """
-        Set an expire flag on key ``name`` for ``time`` seconds. ``time``
-        can be represented by an integer or a Python timedelta object.
-        """
-        if isinstance(time, datetime.timedelta):
-            time = int(time.total_seconds())
-        return self.execute_command('EXPIRE', name, time)
-
-    def expireat(self, name, when):
-        """
-        Set an expire flag on key ``name``. ``when`` can be represented
-        as an integer indicating unix time or a Python datetime object.
-        """
-        if isinstance(when, datetime.datetime):
-            when = int(mod_time.mktime(when.timetuple()))
-        return self.execute_command('EXPIREAT', name, when)
-
-    def get(self, name):
-        """
-        Return the value at key ``name``, or None if the key doesn't exist
-        """
-        return self.execute_command('GET', name)
-
-    def getdel(self, name):
-        """
-        Get the value at key ``name`` and delete the key. This command
-        is similar to GET, except for the fact that it also deletes
-        the key on success (if and only if the key's value type
-        is a string).
-        """
-        return self.execute_command('GETDEL', name)
-
-    def getex(self, name,
-              ex=None, px=None, exat=None, pxat=None, persist=False):
-        """
-        Get the value of key and optionally set its expiration.
-        GETEX is similar to GET, but is a write command with
-        additional options. All time parameters can be given as
-        datetime.timedelta or integers.
-
-        ``ex`` sets an expire flag on key ``name`` for ``ex`` seconds.
-
-        ``px`` sets an expire flag on key ``name`` for ``px`` milliseconds.
-
-        ``exat`` sets an expire flag on key ``name`` for ``ex`` seconds,
-        specified in unix time.
-
-        ``pxat`` sets an expire flag on key ``name`` for ``ex`` milliseconds,
-        specified in unix time.
-
-        ``persist`` remove the time to live associated with ``name``.
-        """
-
-        opset = set([ex, px, exat, pxat])
-        if len(opset) > 2 or len(opset) > 1 and persist:
-            raise DataError("``ex``, ``px``, ``exat``, ``pxat``",
-                            "and ``persist`` are mutually exclusive.")
-
-        pieces = []
-        # similar to set command
-        if ex is not None:
-            pieces.append('EX')
-            if isinstance(ex, datetime.timedelta):
-                ex = int(ex.total_seconds())
-            pieces.append(ex)
-        if px is not None:
-            pieces.append('PX')
-            if isinstance(px, datetime.timedelta):
-                px = int(px.total_seconds() * 1000)
-            pieces.append(px)
-        # similar to pexpireat command
-        if exat is not None:
-            pieces.append('EXAT')
-            if isinstance(exat, datetime.datetime):
-                s = int(exat.microsecond / 1000000)
-                exat = int(mod_time.mktime(exat.timetuple())) + s
-            pieces.append(exat)
-        if pxat is not None:
-            pieces.append('PXAT')
-            if isinstance(pxat, datetime.datetime):
-                ms = int(pxat.microsecond / 1000)
-                pxat = int(mod_time.mktime(pxat.timetuple())) * 1000 + ms
-            pieces.append(pxat)
-        if persist:
-            pieces.append('PERSIST')
-
-        return self.execute_command('GETEX', name, *pieces)
-
-    def __getitem__(self, name):
-        """
-        Return the value at key ``name``, raises a KeyError if the key
-        doesn't exist.
-        """
-        value = self.get(name)
-        if value is not None:
-            return value
-        raise KeyError(name)
-
-    def getbit(self, name, offset):
-        "Returns a boolean indicating the value of ``offset`` in ``name``"
-        return self.execute_command('GETBIT', name, offset)
-
-    def getrange(self, key, start, end):
-        """
-        Returns the substring of the string value stored at ``key``,
-        determined by the offsets ``start`` and ``end`` (both are inclusive)
-        """
-        return self.execute_command('GETRANGE', key, start, end)
-
-    def getset(self, name, value):
-        """
-        Sets the value at key ``name`` to ``value``
-        and returns the old value at key ``name`` atomically.
-
-        As per Redis 6.2, GETSET is considered deprecated.
-        Please use SET with GET parameter in new code.
-        """
-        return self.execute_command('GETSET', name, value)
-
-    def incr(self, name, amount=1):
-        """
-        Increments the value of ``key`` by ``amount``.  If no key exists,
-        the value will be initialized as ``amount``
-        """
-        return self.incrby(name, amount)
-
-    def incrby(self, name, amount=1):
-        """
-        Increments the value of ``key`` by ``amount``.  If no key exists,
-        the value will be initialized as ``amount``
-        """
-        # An alias for ``incr()``, because it is already implemented
-        # as INCRBY redis command.
-        return self.execute_command('INCRBY', name, amount)
-
-    def incrbyfloat(self, name, amount=1.0):
-        """
-        Increments the value at key ``name`` by floating ``amount``.
-        If no key exists, the value will be initialized as ``amount``
-        """
-        return self.execute_command('INCRBYFLOAT', name, amount)
-
-    def keys(self, pattern='*'):
-        "Returns a list of keys matching ``pattern``"
-        return self.execute_command('KEYS', pattern)
-
-    def lmove(self, first_list, second_list, src="LEFT", dest="RIGHT"):
-        """
-        Atomically returns and removes the first/last element of a list,
-        pushing it as the first/last element on the destination list.
-        Returns the element being popped and pushed.
-        """
-        params = [first_list, second_list, src, dest]
-        return self.execute_command("LMOVE", *params)
-
-    def blmove(self, first_list, second_list, timeout,
-               src="LEFT", dest="RIGHT"):
-        """
-        Blocking version of lmove.
-        """
-        params = [first_list, second_list, src, dest, timeout]
-        return self.execute_command("BLMOVE", *params)
-
-    def mget(self, keys, *args):
-        """
-        Returns a list of values ordered identically to ``keys``
-        """
-        args = list_or_args(keys, args)
-        options = {}
-        if not args:
-            options[EMPTY_RESPONSE] = []
-        return self.execute_command('MGET', *args, **options)
-
-    def mset(self, mapping):
-        """
-        Sets key/values based on a mapping. Mapping is a dictionary of
-        key/value pairs. Both keys and values should be strings or types that
-        can be cast to a string via str().
-        """
-        items = []
-        for pair in mapping.items():
-            items.extend(pair)
-        return self.execute_command('MSET', *items)
-
-    def msetnx(self, mapping):
-        """
-        Sets key/values based on a mapping if none of the keys are already set.
-        Mapping is a dictionary of key/value pairs. Both keys and values
-        should be strings or types that can be cast to a string via str().
-        Returns a boolean indicating if the operation was successful.
-        """
-        items = []
-        for pair in mapping.items():
-            items.extend(pair)
-        return self.execute_command('MSETNX', *items)
-
-    def move(self, name, db):
-        "Moves the key ``name`` to a different Redis database ``db``"
-        return self.execute_command('MOVE', name, db)
-
-    def persist(self, name):
-        "Removes an expiration on ``name``"
-        return self.execute_command('PERSIST', name)
-
-    def pexpire(self, name, time):
-        """
-        Set an expire flag on key ``name`` for ``time`` milliseconds.
-        ``time`` can be represented by an integer or a Python timedelta
-        object.
-        """
-        if isinstance(time, datetime.timedelta):
-            time = int(time.total_seconds() * 1000)
-        return self.execute_command('PEXPIRE', name, time)
-
-    def pexpireat(self, name, when):
-        """
-        Set an expire flag on key ``name``. ``when`` can be represented
-        as an integer representing unix time in milliseconds (unix time * 1000)
-        or a Python datetime object.
-        """
-        if isinstance(when, datetime.datetime):
-            ms = int(when.microsecond / 1000)
-            when = int(mod_time.mktime(when.timetuple())) * 1000 + ms
-        return self.execute_command('PEXPIREAT', name, when)
-
-    def psetex(self, name, time_ms, value):
-        """
-        Set the value of key ``name`` to ``value`` that expires in ``time_ms``
-        milliseconds. ``time_ms`` can be represented by an integer or a Python
-        timedelta object
-        """
-        if isinstance(time_ms, datetime.timedelta):
-            time_ms = int(time_ms.total_seconds() * 1000)
-        return self.execute_command('PSETEX', name, time_ms, value)
-
-    def pttl(self, name):
-        "Returns the number of milliseconds until the key ``name`` will expire"
-        return self.execute_command('PTTL', name)
-
-    def hrandfield(self, key, count=None, withvalues=False):
-        """
-        Return a random field from the hash value stored at key.
-
-        count: if the argument is positive, return an array of distinct fields.
-        If called with a negative count, the behavior changes and the command
-        is allowed to return the same field multiple times. In this case,
-        the number of returned fields is the absolute value of the
-        specified count.
-        withvalues: The optional WITHVALUES modifier changes the reply so it
-        includes the respective values of the randomly selected hash fields.
-        """
-        params = []
-        if count is not None:
-            params.append(count)
-        if withvalues:
-            params.append("WITHVALUES")
-
-        return self.execute_command("HRANDFIELD", key, *params)
-
-    def randomkey(self):
-        "Returns the name of a random key"
-        return self.execute_command('RANDOMKEY')
-
-    def rename(self, src, dst):
-        """
-        Rename key ``src`` to ``dst``
-        """
-        return self.execute_command('RENAME', src, dst)
-
-    def renamenx(self, src, dst):
-        "Rename key ``src`` to ``dst`` if ``dst`` doesn't already exist"
-        return self.execute_command('RENAMENX', src, dst)
-
-    def restore(self, name, ttl, value, replace=False, absttl=False):
-        """
-        Create a key using the provided serialized value, previously obtained
-        using DUMP.
-
-        ``replace`` allows an existing key on ``name`` to be overridden. If
-        it's not specified an error is raised on collision.
-
-        ``absttl`` if True, specified ``ttl`` should represent an absolute Unix
-        timestamp in milliseconds in which the key will expire. (Redis 5.0 or
-        greater).
-        """
-        params = [name, ttl, value]
-        if replace:
-            params.append('REPLACE')
-        if absttl:
-            params.append('ABSTTL')
-        return self.execute_command('RESTORE', *params)
-
-    def set(self, name, value,
-            ex=None, px=None, nx=False, xx=False, keepttl=False, get=False):
-        """
-        Set the value at key ``name`` to ``value``
-
-        ``ex`` sets an expire flag on key ``name`` for ``ex`` seconds.
-
-        ``px`` sets an expire flag on key ``name`` for ``px`` milliseconds.
-
-        ``nx`` if set to True, set the value at key ``name`` to ``value`` only
-            if it does not exist.
-
-        ``xx`` if set to True, set the value at key ``name`` to ``value`` only
-            if it already exists.
-
-        ``keepttl`` if True, retain the time to live associated with the key.
-            (Available since Redis 6.0)
-
-        ``get`` if True, set the value at key ``name`` to ``value`` and return
-            the old value stored at key, or None when key did not exist.
-            (Available since Redis 6.2)
-        """
-        pieces = [name, value]
-        options = {}
-        if ex is not None:
-            pieces.append('EX')
-            if isinstance(ex, datetime.timedelta):
-                ex = int(ex.total_seconds())
-            pieces.append(ex)
-        if px is not None:
-            pieces.append('PX')
-            if isinstance(px, datetime.timedelta):
-                px = int(px.total_seconds() * 1000)
-            pieces.append(px)
-
-        if nx:
-            pieces.append('NX')
-        if xx:
-            pieces.append('XX')
-
-        if keepttl:
-            pieces.append('KEEPTTL')
-
-        if get:
-            pieces.append('GET')
-            options["get"] = True
-
-        return self.execute_command('SET', *pieces, **options)
-
-    def __setitem__(self, name, value):
-        self.set(name, value)
-
-    def setbit(self, name, offset, value):
-        """
-        Flag the ``offset`` in ``name`` as ``value``. Returns a boolean
-        indicating the previous value of ``offset``.
-        """
-        value = value and 1 or 0
-        return self.execute_command('SETBIT', name, offset, value)
-
-    def setex(self, name, time, value):
-        """
-        Set the value of key ``name`` to ``value`` that expires in ``time``
-        seconds. ``time`` can be represented by an integer or a Python
-        timedelta object.
-        """
-        if isinstance(time, datetime.timedelta):
-            time = int(time.total_seconds())
-        return self.execute_command('SETEX', name, time, value)
-
-    def setnx(self, name, value):
-        "Set the value of key ``name`` to ``value`` if key doesn't exist"
-        return self.execute_command('SETNX', name, value)
-
-    def setrange(self, name, offset, value):
-        """
-        Overwrite bytes in the value of ``name`` starting at ``offset`` with
-        ``value``. If ``offset`` plus the length of ``value`` exceeds the
-        length of the original value, the new value will be larger than before.
-        If ``offset`` exceeds the length of the original value, null bytes
-        will be used to pad between the end of the previous value and the start
-        of what's being injected.
-
-        Returns the length of the new string.
-        """
-        return self.execute_command('SETRANGE', name, offset, value)
-
-    def strlen(self, name):
-        "Return the number of bytes stored in the value of ``name``"
-        return self.execute_command('STRLEN', name)
-
-    def substr(self, name, start, end=-1):
-        """
-        Return a substring of the string at key ``name``. ``start`` and ``end``
-        are 0-based integers specifying the portion of the string to return.
-        """
-        return self.execute_command('SUBSTR', name, start, end)
-
-    def touch(self, *args):
-        """
-        Alters the last access time of a key(s) ``*args``. A key is ignored
-        if it does not exist.
-        """
-        return self.execute_command('TOUCH', *args)
-
-    def ttl(self, name):
-        "Returns the number of seconds until the key ``name`` will expire"
-        return self.execute_command('TTL', name)
-
-    def type(self, name):
-        "Returns the type of key ``name``"
-        return self.execute_command('TYPE', name)
-
-    def watch(self, *names):
-        """
-        Watches the values at keys ``names``, or None if the key doesn't exist
-        """
-        warnings.warn(DeprecationWarning('Call WATCH from a Pipeline object'))
-
-    def unwatch(self):
-        """
-        Unwatches the value at key ``name``, or None of the key doesn't exist
-        """
-        warnings.warn(
-            DeprecationWarning('Call UNWATCH from a Pipeline object'))
-
-    def unlink(self, *names):
-        "Unlink one or more keys specified by ``names``"
-        return self.execute_command('UNLINK', *names)
-
-    # LIST COMMANDS
-    def blpop(self, keys, timeout=0):
-        """
-        LPOP a value off of the first non-empty list
-        named in the ``keys`` list.
-
-        If none of the lists in ``keys`` has a value to LPOP, then block
-        for ``timeout`` seconds, or until a value gets pushed on to one
-        of the lists.
-
-        If timeout is 0, then block indefinitely.
-        """
-        if timeout is None:
-            timeout = 0
-        keys = list_or_args(keys, None)
-        keys.append(timeout)
-        return self.execute_command('BLPOP', *keys)
-
-    def brpop(self, keys, timeout=0):
-        """
-        RPOP a value off of the first non-empty list
-        named in the ``keys`` list.
-
-        If none of the lists in ``keys`` has a value to RPOP, then block
-        for ``timeout`` seconds, or until a value gets pushed on to one
-        of the lists.
-
-        If timeout is 0, then block indefinitely.
-        """
-        if timeout is None:
-            timeout = 0
-        keys = list_or_args(keys, None)
-        keys.append(timeout)
-        return self.execute_command('BRPOP', *keys)
-
-    def brpoplpush(self, src, dst, timeout=0):
-        """
-        Pop a value off the tail of ``src``, push it on the head of ``dst``
-        and then return it.
-
-        This command blocks until a value is in ``src`` or until ``timeout``
-        seconds elapse, whichever is first. A ``timeout`` value of 0 blocks
-        forever.
-        """
-        if timeout is None:
-            timeout = 0
-        return self.execute_command('BRPOPLPUSH', src, dst, timeout)
-
-    def lindex(self, name, index):
-        """
-        Return the item from list ``name`` at position ``index``
-
-        Negative indexes are supported and will return an item at the
-        end of the list
-        """
-        return self.execute_command('LINDEX', name, index)
-
-    def linsert(self, name, where, refvalue, value):
-        """
-        Insert ``value`` in list ``name`` either immediately before or after
-        [``where``] ``refvalue``
-
-        Returns the new length of the list on success or -1 if ``refvalue``
-        is not in the list.
-        """
-        return self.execute_command('LINSERT', name, where, refvalue, value)
-
-    def llen(self, name):
-        "Return the length of the list ``name``"
-        return self.execute_command('LLEN', name)
-
-    def lpop(self, name, count=None):
-        """
-        Removes and returns the first elements of the list ``name``.
-
-        By default, the command pops a single element from the beginning of
-        the list. When provided with the optional ``count`` argument, the reply
-        will consist of up to count elements, depending on the list's length.
-        """
-        if count is not None:
-            return self.execute_command('LPOP', name, count)
-        else:
-            return self.execute_command('LPOP', name)
-
-    def lpush(self, name, *values):
-        "Push ``values`` onto the head of the list ``name``"
-        return self.execute_command('LPUSH', name, *values)
-
-    def lpushx(self, name, value):
-        "Push ``value`` onto the head of the list ``name`` if ``name`` exists"
-        return self.execute_command('LPUSHX', name, value)
-
-    def lrange(self, name, start, end):
-        """
-        Return a slice of the list ``name`` between
-        position ``start`` and ``end``
-
-        ``start`` and ``end`` can be negative numbers just like
-        Python slicing notation
-        """
-        return self.execute_command('LRANGE', name, start, end)
-
-    def lrem(self, name, count, value):
-        """
-        Remove the first ``count`` occurrences of elements equal to ``value``
-        from the list stored at ``name``.
-
-        The count argument influences the operation in the following ways:
-            count > 0: Remove elements equal to value moving from head to tail.
-            count < 0: Remove elements equal to value moving from tail to head.
-            count = 0: Remove all elements equal to value.
-        """
-        return self.execute_command('LREM', name, count, value)
-
-    def lset(self, name, index, value):
-        "Set ``position`` of list ``name`` to ``value``"
-        return self.execute_command('LSET', name, index, value)
-
-    def ltrim(self, name, start, end):
-        """
-        Trim the list ``name``, removing all values not within the slice
-        between ``start`` and ``end``
-
-        ``start`` and ``end`` can be negative numbers just like
-        Python slicing notation
-        """
-        return self.execute_command('LTRIM', name, start, end)
-
-    def rpop(self, name, count=None):
-        """
-        Removes and returns the last elements of the list ``name``.
-
-        By default, the command pops a single element from the end of the list.
-        When provided with the optional ``count`` argument, the reply will
-        consist of up to count elements, depending on the list's length.
-        """
-        if count is not None:
-            return self.execute_command('RPOP', name, count)
-        else:
-            return self.execute_command('RPOP', name)
-
-    def rpoplpush(self, src, dst):
-        """
-        RPOP a value off of the ``src`` list and atomically LPUSH it
-        on to the ``dst`` list.  Returns the value.
-        """
-        return self.execute_command('RPOPLPUSH', src, dst)
-
-    def rpush(self, name, *values):
-        "Push ``values`` onto the tail of the list ``name``"
-        return self.execute_command('RPUSH', name, *values)
-
-    def rpushx(self, name, value):
-        "Push ``value`` onto the tail of the list ``name`` if ``name`` exists"
-        return self.execute_command('RPUSHX', name, value)
-
-    def lpos(self, name, value, rank=None, count=None, maxlen=None):
-        """
-        Get position of ``value`` within the list ``name``
-
-         If specified, ``rank`` indicates the "rank" of the first element to
-         return in case there are multiple copies of ``value`` in the list.
-         By default, LPOS returns the position of the first occurrence of
-         ``value`` in the list. When ``rank`` 2, LPOS returns the position of
-         the second ``value`` in the list. If ``rank`` is negative, LPOS
-         searches the list in reverse. For example, -1 would return the
-         position of the last occurrence of ``value`` and -2 would return the
-         position of the next to last occurrence of ``value``.
-
-         If specified, ``count`` indicates that LPOS should return a list of
-         up to ``count`` positions. A ``count`` of 2 would return a list of
-         up to 2 positions. A ``count`` of 0 returns a list of all positions
-         matching ``value``. When ``count`` is specified and but ``value``
-         does not exist in the list, an empty list is returned.
-
-         If specified, ``maxlen`` indicates the maximum number of list
-         elements to scan. A ``maxlen`` of 1000 will only return the
-         position(s) of items within the first 1000 entries in the list.
-         A ``maxlen`` of 0 (the default) will scan the entire list.
-        """
-        pieces = [name, value]
-        if rank is not None:
-            pieces.extend(['RANK', rank])
-
-        if count is not None:
-            pieces.extend(['COUNT', count])
-
-        if maxlen is not None:
-            pieces.extend(['MAXLEN', maxlen])
-
-        return self.execute_command('LPOS', *pieces)
-
-    def sort(self, name, start=None, num=None, by=None, get=None,
-             desc=False, alpha=False, store=None, groups=False):
-        """
-        Sort and return the list, set or sorted set at ``name``.
-
-        ``start`` and ``num`` allow for paging through the sorted data
-
-        ``by`` allows using an external key to weight and sort the items.
-            Use an "*" to indicate where in the key the item value is located
-
-        ``get`` allows for returning items from external keys rather than the
-            sorted data itself.  Use an "*" to indicate where in the key
-            the item value is located
-
-        ``desc`` allows for reversing the sort
-
-        ``alpha`` allows for sorting lexicographically rather than numerically
-
-        ``store`` allows for storing the result of the sort into
-            the key ``store``
-
-        ``groups`` if set to True and if ``get`` contains at least two
-            elements, sort will return a list of tuples, each containing the
-            values fetched from the arguments to ``get``.
-
-        """
-        if (start is not None and num is None) or \
-                (num is not None and start is None):
-            raise DataError("``start`` and ``num`` must both be specified")
-
-        pieces = [name]
-        if by is not None:
-            pieces.append(b'BY')
-            pieces.append(by)
-        if start is not None and num is not None:
-            pieces.append(b'LIMIT')
-            pieces.append(start)
-            pieces.append(num)
-        if get is not None:
-            # If get is a string assume we want to get a single value.
-            # Otherwise assume it's an interable and we want to get multiple
-            # values. We can't just iterate blindly because strings are
-            # iterable.
-            if isinstance(get, (bytes, str)):
-                pieces.append(b'GET')
-                pieces.append(get)
-            else:
-                for g in get:
-                    pieces.append(b'GET')
-                    pieces.append(g)
-        if desc:
-            pieces.append(b'DESC')
-        if alpha:
-            pieces.append(b'ALPHA')
-        if store is not None:
-            pieces.append(b'STORE')
-            pieces.append(store)
-
-        if groups:
-            if not get or isinstance(get, (bytes, str)) or len(get) < 2:
-                raise DataError('when using "groups" the "get" argument '
-                                'must be specified and contain at least '
-                                'two keys')
-
-        options = {'groups': len(get) if groups else None}
-        return self.execute_command('SORT', *pieces, **options)
-
-    # SCAN COMMANDS
-    def scan(self, cursor=0, match=None, count=None, _type=None):
-        """
-        Incrementally return lists of key names. Also return a cursor
-        indicating the scan position.
-
-        ``match`` allows for filtering the keys by pattern
-
-        ``count`` provides a hint to Redis about the number of keys to
-            return per batch.
-
-        ``_type`` filters the returned values by a particular Redis type.
-            Stock Redis instances allow for the following types:
-            HASH, LIST, SET, STREAM, STRING, ZSET
-            Additionally, Redis modules can expose other types as well.
-        """
-        pieces = [cursor]
-        if match is not None:
-            pieces.extend([b'MATCH', match])
-        if count is not None:
-            pieces.extend([b'COUNT', count])
-        if _type is not None:
-            pieces.extend([b'TYPE', _type])
-        return self.execute_command('SCAN', *pieces)
-
-    def scan_iter(self, match=None, count=None, _type=None):
-        """
-        Make an iterator using the SCAN command so that the client doesn't
-        need to remember the cursor position.
-
-        ``match`` allows for filtering the keys by pattern
-
-        ``count`` provides a hint to Redis about the number of keys to
-            return per batch.
-
-        ``_type`` filters the returned values by a particular Redis type.
-            Stock Redis instances allow for the following types:
-            HASH, LIST, SET, STREAM, STRING, ZSET
-            Additionally, Redis modules can expose other types as well.
-        """
-        cursor = '0'
-        while cursor != 0:
-            cursor, data = self.scan(cursor=cursor, match=match,
-                                     count=count, _type=_type)
-            yield from data
-
-    def sscan(self, name, cursor=0, match=None, count=None):
-        """
-        Incrementally return lists of elements in a set. Also return a cursor
-        indicating the scan position.
-
-        ``match`` allows for filtering the keys by pattern
-
-        ``count`` allows for hint the minimum number of returns
-        """
-        pieces = [name, cursor]
-        if match is not None:
-            pieces.extend([b'MATCH', match])
-        if count is not None:
-            pieces.extend([b'COUNT', count])
-        return self.execute_command('SSCAN', *pieces)
-
-    def sscan_iter(self, name, match=None, count=None):
-        """
-        Make an iterator using the SSCAN command so that the client doesn't
-        need to remember the cursor position.
-
-        ``match`` allows for filtering the keys by pattern
-
-        ``count`` allows for hint the minimum number of returns
-        """
-        cursor = '0'
-        while cursor != 0:
-            cursor, data = self.sscan(name, cursor=cursor,
-                                      match=match, count=count)
-            yield from data
-
-    def hscan(self, name, cursor=0, match=None, count=None):
-        """
-        Incrementally return key/value slices in a hash. Also return a cursor
-        indicating the scan position.
-
-        ``match`` allows for filtering the keys by pattern
-
-        ``count`` allows for hint the minimum number of returns
-        """
-        pieces = [name, cursor]
-        if match is not None:
-            pieces.extend([b'MATCH', match])
-        if count is not None:
-            pieces.extend([b'COUNT', count])
-        return self.execute_command('HSCAN', *pieces)
-
-    def hscan_iter(self, name, match=None, count=None):
-        """
-        Make an iterator using the HSCAN command so that the client doesn't
-        need to remember the cursor position.
-
-        ``match`` allows for filtering the keys by pattern
-
-        ``count`` allows for hint the minimum number of returns
-        """
-        cursor = '0'
-        while cursor != 0:
-            cursor, data = self.hscan(name, cursor=cursor,
-                                      match=match, count=count)
-            yield from data.items()
-
-    def zscan(self, name, cursor=0, match=None, count=None,
-              score_cast_func=float):
-        """
-        Incrementally return lists of elements in a sorted set. Also return a
-        cursor indicating the scan position.
-
-        ``match`` allows for filtering the keys by pattern
-
-        ``count`` allows for hint the minimum number of returns
-
-        ``score_cast_func`` a callable used to cast the score return value
-        """
-        pieces = [name, cursor]
-        if match is not None:
-            pieces.extend([b'MATCH', match])
-        if count is not None:
-            pieces.extend([b'COUNT', count])
-        options = {'score_cast_func': score_cast_func}
-        return self.execute_command('ZSCAN', *pieces, **options)
-
-    def zscan_iter(self, name, match=None, count=None,
-                   score_cast_func=float):
-        """
-        Make an iterator using the ZSCAN command so that the client doesn't
-        need to remember the cursor position.
-
-        ``match`` allows for filtering the keys by pattern
-
-        ``count`` allows for hint the minimum number of returns
-
-        ``score_cast_func`` a callable used to cast the score return value
-        """
-        cursor = '0'
-        while cursor != 0:
-            cursor, data = self.zscan(name, cursor=cursor, match=match,
-                                      count=count,
-                                      score_cast_func=score_cast_func)
-            yield from data
-
-    # SET COMMANDS
-    def sadd(self, name, *values):
-        "Add ``value(s)`` to set ``name``"
-        return self.execute_command('SADD', name, *values)
-
-    def scard(self, name):
-        "Return the number of elements in set ``name``"
-        return self.execute_command('SCARD', name)
-
-    def sdiff(self, keys, *args):
-        "Return the difference of sets specified by ``keys``"
-        args = list_or_args(keys, args)
-        return self.execute_command('SDIFF', *args)
-
-    def sdiffstore(self, dest, keys, *args):
-        """
-        Store the difference of sets specified by ``keys`` into a new
-        set named ``dest``.  Returns the number of keys in the new set.
-        """
-        args = list_or_args(keys, args)
-        return self.execute_command('SDIFFSTORE', dest, *args)
-
-    def sinter(self, keys, *args):
-        "Return the intersection of sets specified by ``keys``"
-        args = list_or_args(keys, args)
-        return self.execute_command('SINTER', *args)
-
-    def sinterstore(self, dest, keys, *args):
-        """
-        Store the intersection of sets specified by ``keys`` into a new
-        set named ``dest``.  Returns the number of keys in the new set.
-        """
-        args = list_or_args(keys, args)
-        return self.execute_command('SINTERSTORE', dest, *args)
-
-    def sismember(self, name, value):
-        "Return a boolean indicating if ``value`` is a member of set ``name``"
-        return self.execute_command('SISMEMBER', name, value)
-
-    def smembers(self, name):
-        "Return all members of the set ``name``"
-        return self.execute_command('SMEMBERS', name)
-
-    def smove(self, src, dst, value):
-        "Move ``value`` from set ``src`` to set ``dst`` atomically"
-        return self.execute_command('SMOVE', src, dst, value)
-
-    def spop(self, name, count=None):
-        "Remove and return a random member of set ``name``"
-        args = (count is not None) and [count] or []
-        return self.execute_command('SPOP', name, *args)
-
-    def srandmember(self, name, number=None):
-        """
-        If ``number`` is None, returns a random member of set ``name``.
-
-        If ``number`` is supplied, returns a list of ``number`` random
-        members of set ``name``. Note this is only available when running
-        Redis 2.6+.
-        """
-        args = (number is not None) and [number] or []
-        return self.execute_command('SRANDMEMBER', name, *args)
-
-    def srem(self, name, *values):
-        "Remove ``values`` from set ``name``"
-        return self.execute_command('SREM', name, *values)
-
-    def sunion(self, keys, *args):
-        "Return the union of sets specified by ``keys``"
-        args = list_or_args(keys, args)
-        return self.execute_command('SUNION', *args)
-
-    def sunionstore(self, dest, keys, *args):
-        """
-        Store the union of sets specified by ``keys`` into a new
-        set named ``dest``.  Returns the number of keys in the new set.
-        """
-        args = list_or_args(keys, args)
-        return self.execute_command('SUNIONSTORE', dest, *args)
-
-    # STREAMS COMMANDS
-    def xack(self, name, groupname, *ids):
-        """
-        Acknowledges the successful processing of one or more messages.
-        name: name of the stream.
-        groupname: name of the consumer group.
-        *ids: message ids to acknowledge.
-        """
-        return self.execute_command('XACK', name, groupname, *ids)
-
-    def xadd(self, name, fields, id='*', maxlen=None, approximate=True,
-             nomkstream=False):
-        """
-        Add to a stream.
-        name: name of the stream
-        fields: dict of field/value pairs to insert into the stream
-        id: Location to insert this record. By default it is appended.
-        maxlen: truncate old stream members beyond this size
-        approximate: actual stream length may be slightly more than maxlen
-        nomkstream: When set to true, do not make a stream
-        """
-        pieces = []
-        if maxlen is not None:
-            if not isinstance(maxlen, int) or maxlen < 1:
-                raise DataError('XADD maxlen must be a positive integer')
-            pieces.append(b'MAXLEN')
-            if approximate:
-                pieces.append(b'~')
-            pieces.append(str(maxlen))
-        if nomkstream:
-            pieces.append(b'NOMKSTREAM')
-        pieces.append(id)
-        if not isinstance(fields, dict) or len(fields) == 0:
-            raise DataError('XADD fields must be a non-empty dict')
-        for pair in fields.items():
-            pieces.extend(pair)
-        return self.execute_command('XADD', name, *pieces)
-
-    def xautoclaim(self, name, groupname, consumername, min_idle_time,
-                   start_id=0, count=None, justid=False):
-        """
-        Transfers ownership of pending stream entries that match the specified
-        criteria. Conceptually, equivalent to calling XPENDING and then XCLAIM,
-        but provides a more straightforward way to deal with message delivery
-        failures via SCAN-like semantics.
-        name: name of the stream.
-        groupname: name of the consumer group.
-        consumername: name of a consumer that claims the message.
-        min_idle_time: filter messages that were idle less than this amount of
-        milliseconds.
-        start_id: filter messages with equal or greater ID.
-        count: optional integer, upper limit of the number of entries that the
-        command attempts to claim. Set to 100 by default.
-        justid: optional boolean, false by default. Return just an array of IDs
-        of messages successfully claimed, without returning the actual message
-        """
-        try:
-            if int(min_idle_time) < 0:
-                raise DataError("XAUTOCLAIM min_idle_time must be a non"
-                                "negative integer")
-        except TypeError:
-            pass
-
-        kwargs = {}
-        pieces = [name, groupname, consumername, min_idle_time, start_id]
-
-        try:
-            if int(count) < 0:
-                raise DataError("XPENDING count must be a integer >= 0")
-            pieces.extend([b'COUNT', count])
-        except TypeError:
-            pass
-        if justid:
-            pieces.append(b'JUSTID')
-            kwargs['parse_justid'] = True
-
-        return self.execute_command('XAUTOCLAIM', *pieces, **kwargs)
-
-    def xclaim(self, name, groupname, consumername, min_idle_time, message_ids,
-               idle=None, time=None, retrycount=None, force=False,
-               justid=False):
-        """
-        Changes the ownership of a pending message.
-        name: name of the stream.
-        groupname: name of the consumer group.
-        consumername: name of a consumer that claims the message.
-        min_idle_time: filter messages that were idle less than this amount of
-        milliseconds
-        message_ids: non-empty list or tuple of message IDs to claim
-        idle: optional. Set the idle time (last time it was delivered) of the
-         message in ms
-        time: optional integer. This is the same as idle but instead of a
-         relative amount of milliseconds, it sets the idle time to a specific
-         Unix time (in milliseconds).
-        retrycount: optional integer. set the retry counter to the specified
-         value. This counter is incremented every time a message is delivered
-         again.
-        force: optional boolean, false by default. Creates the pending message
-         entry in the PEL even if certain specified IDs are not already in the
-         PEL assigned to a different client.
-        justid: optional boolean, false by default. Return just an array of IDs
-         of messages successfully claimed, without returning the actual message
-        """
-        if not isinstance(min_idle_time, int) or min_idle_time < 0:
-            raise DataError("XCLAIM min_idle_time must be a non negative "
-                            "integer")
-        if not isinstance(message_ids, (list, tuple)) or not message_ids:
-            raise DataError("XCLAIM message_ids must be a non empty list or "
-                            "tuple of message IDs to claim")
-
-        kwargs = {}
-        pieces = [name, groupname, consumername, str(min_idle_time)]
-        pieces.extend(list(message_ids))
-
-        if idle is not None:
-            if not isinstance(idle, int):
-                raise DataError("XCLAIM idle must be an integer")
-            pieces.extend((b'IDLE', str(idle)))
-        if time is not None:
-            if not isinstance(time, int):
-                raise DataError("XCLAIM time must be an integer")
-            pieces.extend((b'TIME', str(time)))
-        if retrycount is not None:
-            if not isinstance(retrycount, int):
-                raise DataError("XCLAIM retrycount must be an integer")
-            pieces.extend((b'RETRYCOUNT', str(retrycount)))
-
-        if force:
-            if not isinstance(force, bool):
-                raise DataError("XCLAIM force must be a boolean")
-            pieces.append(b'FORCE')
-        if justid:
-            if not isinstance(justid, bool):
-                raise DataError("XCLAIM justid must be a boolean")
-            pieces.append(b'JUSTID')
-            kwargs['parse_justid'] = True
-        return self.execute_command('XCLAIM', *pieces, **kwargs)
-
-    def xdel(self, name, *ids):
-        """
-        Deletes one or more messages from a stream.
-        name: name of the stream.
-        *ids: message ids to delete.
-        """
-        return self.execute_command('XDEL', name, *ids)
-
-    def xgroup_create(self, name, groupname, id='$', mkstream=False):
-        """
-        Create a new consumer group associated with a stream.
-        name: name of the stream.
-        groupname: name of the consumer group.
-        id: ID of the last item in the stream to consider already delivered.
-        """
-        pieces = ['XGROUP CREATE', name, groupname, id]
-        if mkstream:
-            pieces.append(b'MKSTREAM')
-        return self.execute_command(*pieces)
-
-    def xgroup_delconsumer(self, name, groupname, consumername):
-        """
-        Remove a specific consumer from a consumer group.
-        Returns the number of pending messages that the consumer had before it
-        was deleted.
-        name: name of the stream.
-        groupname: name of the consumer group.
-        consumername: name of consumer to delete
-        """
-        return self.execute_command('XGROUP DELCONSUMER', name, groupname,
-                                    consumername)
-
-    def xgroup_destroy(self, name, groupname):
-        """
-        Destroy a consumer group.
-        name: name of the stream.
-        groupname: name of the consumer group.
-        """
-        return self.execute_command('XGROUP DESTROY', name, groupname)
-
-    def xgroup_setid(self, name, groupname, id):
-        """
-        Set the consumer group last delivered ID to something else.
-        name: name of the stream.
-        groupname: name of the consumer group.
-        id: ID of the last item in the stream to consider already delivered.
-        """
-        return self.execute_command('XGROUP SETID', name, groupname, id)
-
-    def xinfo_consumers(self, name, groupname):
-        """
-        Returns general information about the consumers in the group.
-        name: name of the stream.
-        groupname: name of the consumer group.
-        """
-        return self.execute_command('XINFO CONSUMERS', name, groupname)
-
-    def xinfo_groups(self, name):
-        """
-        Returns general information about the consumer groups of the stream.
-        name: name of the stream.
-        """
-        return self.execute_command('XINFO GROUPS', name)
-
-    def xinfo_stream(self, name):
-        """
-        Returns general information about the stream.
-        name: name of the stream.
-        """
-        return self.execute_command('XINFO STREAM', name)
-
-    def xlen(self, name):
-        """
-        Returns the number of elements in a given stream.
-        """
-        return self.execute_command('XLEN', name)
-
-    def xpending(self, name, groupname):
-        """
-        Returns information about pending messages of a group.
-        name: name of the stream.
-        groupname: name of the consumer group.
-        """
-        return self.execute_command('XPENDING', name, groupname)
-
-    def xpending_range(self, name, groupname, min, max, count,
-                       consumername=None, idle=None):
-        """
-        Returns information about pending messages, in a range.
-        name: name of the stream.
-        groupname: name of the consumer group.
-        min: minimum stream ID.
-        max: maximum stream ID.
-        count: number of messages to return
-        consumername: name of a consumer to filter by (optional).
-        idle: available from  version 6.2. filter entries by their
-        idle-time, given in milliseconds (optional).
-        """
-        if {min, max, count} == {None}:
-            if idle is not None or consumername is not None:
-                raise DataError("if XPENDING is provided with idle time"
-                                " or consumername, it must be provided"
-                                " with min, max and count parameters")
-            return self.xpending(name, groupname)
-
-        pieces = [name, groupname]
-        if min is None or max is None or count is None:
-            raise DataError("XPENDING must be provided with min, max "
-                            "and count parameters, or none of them.")
-        # idle
-        try:
-            if int(idle) < 0:
-                raise DataError("XPENDING idle must be a integer >= 0")
-            pieces.extend(['IDLE', idle])
-        except TypeError:
-            pass
-        # count
-        try:
-            if int(count) < 0:
-                raise DataError("XPENDING count must be a integer >= 0")
-            pieces.extend([min, max, count])
-        except TypeError:
-            pass
-
-        return self.execute_command('XPENDING', *pieces, parse_detail=True)
-
-    def xrange(self, name, min='-', max='+', count=None):
-        """
-        Read stream values within an interval.
-        name: name of the stream.
-        start: first stream ID. defaults to '-',
-               meaning the earliest available.
-        finish: last stream ID. defaults to '+',
-                meaning the latest available.
-        count: if set, only return this many items, beginning with the
-               earliest available.
-        """
-        pieces = [min, max]
-        if count is not None:
-            if not isinstance(count, int) or count < 1:
-                raise DataError('XRANGE count must be a positive integer')
-            pieces.append(b'COUNT')
-            pieces.append(str(count))
-
-        return self.execute_command('XRANGE', name, *pieces)
-
-    def xread(self, streams, count=None, block=None):
-        """
-        Block and monitor multiple streams for new data.
-        streams: a dict of stream names to stream IDs, where
-                   IDs indicate the last ID already seen.
-        count: if set, only return this many items, beginning with the
-               earliest available.
-        block: number of milliseconds to wait, if nothing already present.
-        """
-        pieces = []
-        if block is not None:
-            if not isinstance(block, int) or block < 0:
-                raise DataError('XREAD block must be a non-negative integer')
-            pieces.append(b'BLOCK')
-            pieces.append(str(block))
-        if count is not None:
-            if not isinstance(count, int) or count < 1:
-                raise DataError('XREAD count must be a positive integer')
-            pieces.append(b'COUNT')
-            pieces.append(str(count))
-        if not isinstance(streams, dict) or len(streams) == 0:
-            raise DataError('XREAD streams must be a non empty dict')
-        pieces.append(b'STREAMS')
-        keys, values = zip(*streams.items())
-        pieces.extend(keys)
-        pieces.extend(values)
-        return self.execute_command('XREAD', *pieces)
-
-    def xreadgroup(self, groupname, consumername, streams, count=None,
-                   block=None, noack=False):
-        """
-        Read from a stream via a consumer group.
-        groupname: name of the consumer group.
-        consumername: name of the requesting consumer.
-        streams: a dict of stream names to stream IDs, where
-               IDs indicate the last ID already seen.
-        count: if set, only return this many items, beginning with the
-               earliest available.
-        block: number of milliseconds to wait, if nothing already present.
-        noack: do not add messages to the PEL
-        """
-        pieces = [b'GROUP', groupname, consumername]
-        if count is not None:
-            if not isinstance(count, int) or count < 1:
-                raise DataError("XREADGROUP count must be a positive integer")
-            pieces.append(b'COUNT')
-            pieces.append(str(count))
-        if block is not None:
-            if not isinstance(block, int) or block < 0:
-                raise DataError("XREADGROUP block must be a non-negative "
-                                "integer")
-            pieces.append(b'BLOCK')
-            pieces.append(str(block))
-        if noack:
-            pieces.append(b'NOACK')
-        if not isinstance(streams, dict) or len(streams) == 0:
-            raise DataError('XREADGROUP streams must be a non empty dict')
-        pieces.append(b'STREAMS')
-        pieces.extend(streams.keys())
-        pieces.extend(streams.values())
-        return self.execute_command('XREADGROUP', *pieces)
-
-    def xrevrange(self, name, max='+', min='-', count=None):
-        """
-        Read stream values within an interval, in reverse order.
-        name: name of the stream
-        start: first stream ID. defaults to '+',
-               meaning the latest available.
-        finish: last stream ID. defaults to '-',
-                meaning the earliest available.
-        count: if set, only return this many items, beginning with the
-               latest available.
-        """
-        pieces = [max, min]
-        if count is not None:
-            if not isinstance(count, int) or count < 1:
-                raise DataError('XREVRANGE count must be a positive integer')
-            pieces.append(b'COUNT')
-            pieces.append(str(count))
-
-        return self.execute_command('XREVRANGE', name, *pieces)
-
-    def xtrim(self, name, maxlen=None, approximate=True, minid=None,
-              limit=None):
-        """
-        Trims old messages from a stream.
-        name: name of the stream.
-        maxlen: truncate old stream messages beyond this size
-        approximate: actual stream length may be slightly more than maxlen
-        minin: the minimum id in the stream to query
-        limit: specifies the maximum number of entries to retrieve
-        """
-        pieces = []
-        if maxlen is not None and minid is not None:
-            raise DataError("Only one of ```maxlen``` or ```minid```",
-                            "may be specified")
-
-        if maxlen is not None:
-            pieces.append(b'MAXLEN')
-        if minid is not None:
-            pieces.append(b'MINID')
-        if approximate:
-            pieces.append(b'~')
-        if maxlen is not None:
-            pieces.append(maxlen)
-        if minid is not None:
-            pieces.append(minid)
-        if limit is not None:
-            pieces.append(b"LIMIT")
-            pieces.append(limit)
-
-        return self.execute_command('XTRIM', name, *pieces)
-
-    # SORTED SET COMMANDS
-    def zadd(self, name, mapping, nx=False, xx=False, ch=False, incr=False,
-             gt=None, lt=None):
-        """
-        Set any number of element-name, score pairs to the key ``name``. Pairs
-        are specified as a dict of element-names keys to score values.
-
-        ``nx`` forces ZADD to only create new elements and not to update
-        scores for elements that already exist.
-
-        ``xx`` forces ZADD to only update scores of elements that already
-        exist. New elements will not be added.
-
-        ``ch`` modifies the return value to be the numbers of elements changed.
-        Changed elements include new elements that were added and elements
-        whose scores changed.
-
-        ``incr`` modifies ZADD to behave like ZINCRBY. In this mode only a
-        single element/score pair can be specified and the score is the amount
-        the existing score will be incremented by. When using this mode the
-        return value of ZADD will be the new score of the element.
-
-        ``LT`` Only update existing elements if the new score is less than
-        the current score. This flag doesn't prevent adding new elements.
-
-        ``GT`` Only update existing elements if the new score is greater than
-        the current score. This flag doesn't prevent adding new elements.
-
-        The return value of ZADD varies based on the mode specified. With no
-        options, ZADD returns the number of new elements added to the sorted
-        set.
-
-        ``NX``, ``LT``, and ``GT`` are mutually exclusive options.
-        See: https://redis.io/commands/ZADD
-        """
-        if not mapping:
-            raise DataError("ZADD requires at least one element/score pair")
-        if nx and xx:
-            raise DataError("ZADD allows either 'nx' or 'xx', not both")
-        if incr and len(mapping) != 1:
-            raise DataError("ZADD option 'incr' only works when passing a "
-                            "single element/score pair")
-        if nx is True and (gt is not None or lt is not None):
-            raise DataError("Only one of 'nx', 'lt', or 'gr' may be defined.")
-
-        pieces = []
-        options = {}
-        if nx:
-            pieces.append(b'NX')
-        if xx:
-            pieces.append(b'XX')
-        if ch:
-            pieces.append(b'CH')
-        if incr:
-            pieces.append(b'INCR')
-            options['as_score'] = True
-        if gt:
-            pieces.append(b'GT')
-        if lt:
-            pieces.append(b'LT')
-        for pair in mapping.items():
-            pieces.append(pair[1])
-            pieces.append(pair[0])
-        return self.execute_command('ZADD', name, *pieces, **options)
-
-    def zcard(self, name):
-        "Return the number of elements in the sorted set ``name``"
-        return self.execute_command('ZCARD', name)
-
-    def zcount(self, name, min, max):
-        """
-        Returns the number of elements in the sorted set at key ``name`` with
-        a score between ``min`` and ``max``.
-        """
-        return self.execute_command('ZCOUNT', name, min, max)
-
-    def zdiff(self, keys, withscores=False):
-        """
-        Returns the difference between the first and all successive input
-        sorted sets provided in ``keys``.
-        """
-        pieces = [len(keys), *keys]
-        if withscores:
-            pieces.append("WITHSCORES")
-        return self.execute_command("ZDIFF", *pieces)
-
-    def zdiffstore(self, dest, keys):
-        """
-        Computes the difference between the first and all successive input
-        sorted sets provided in ``keys`` and stores the result in ``dest``.
-        """
-        pieces = [len(keys), *keys]
-        return self.execute_command("ZDIFFSTORE", dest, *pieces)
-
-    def zincrby(self, name, amount, value):
-        "Increment the score of ``value`` in sorted set ``name`` by ``amount``"
-        return self.execute_command('ZINCRBY', name, amount, value)
-
-    def zinter(self, keys, aggregate=None, withscores=False):
-        """
-        Return the intersect of multiple sorted sets specified by ``keys``.
-        With the ``aggregate`` option, it is possible to specify how the
-        results of the union are aggregated. This option defaults to SUM,
-        where the score of an element is summed across the inputs where it
-        exists. When this option is set to either MIN or MAX, the resulting
-        set will contain the minimum or maximum score of an element across
-        the inputs where it exists.
-        """
-        return self._zaggregate('ZINTER', None, keys, aggregate,
-                                withscores=withscores)
-
-    def zinterstore(self, dest, keys, aggregate=None):
-        """
-        Intersect multiple sorted sets specified by ``keys`` into a new
-        sorted set, ``dest``. Scores in the destination will be aggregated
-        based on the ``aggregate``. This option defaults to SUM, where the
-        score of an element is summed across the inputs where it exists.
-        When this option is set to either MIN or MAX, the resulting set will
-        contain the minimum or maximum score of an element across the inputs
-        where it exists.
-        """
-        return self._zaggregate('ZINTERSTORE', dest, keys, aggregate)
-
-    def zlexcount(self, name, min, max):
-        """
-        Return the number of items in the sorted set ``name`` between the
-        lexicographical range ``min`` and ``max``.
-        """
-        return self.execute_command('ZLEXCOUNT', name, min, max)
-
-    def zpopmax(self, name, count=None):
-        """
-        Remove and return up to ``count`` members with the highest scores
-        from the sorted set ``name``.
-        """
-        args = (count is not None) and [count] or []
-        options = {
-            'withscores': True
-        }
-        return self.execute_command('ZPOPMAX', name, *args, **options)
-
-    def zpopmin(self, name, count=None):
-        """
-        Remove and return up to ``count`` members with the lowest scores
-        from the sorted set ``name``.
-        """
-        args = (count is not None) and [count] or []
-        options = {
-            'withscores': True
-        }
-        return self.execute_command('ZPOPMIN', name, *args, **options)
-
-    def zrandmember(self, key, count=None, withscores=False):
-        """
-        Return a random element from the sorted set value stored at key.
-
-        ``count`` if the argument is positive, return an array of distinct
-        fields. If called with a negative count, the behavior changes and
-        the command is allowed to return the same field multiple times.
-        In this case, the number of returned fields is the absolute value
-        of the specified count.
-
-        ``withscores`` The optional WITHSCORES modifier changes the reply so it
-        includes the respective scores of the randomly selected elements from
-        the sorted set.
-        """
-        params = []
-        if count is not None:
-            params.append(count)
-        if withscores:
-            params.append("WITHSCORES")
-
-        return self.execute_command("ZRANDMEMBER", key, *params)
-
-    def bzpopmax(self, keys, timeout=0):
-        """
-        ZPOPMAX a value off of the first non-empty sorted set
-        named in the ``keys`` list.
-
-        If none of the sorted sets in ``keys`` has a value to ZPOPMAX,
-        then block for ``timeout`` seconds, or until a member gets added
-        to one of the sorted sets.
-
-        If timeout is 0, then block indefinitely.
-        """
-        if timeout is None:
-            timeout = 0
-        keys = list_or_args(keys, None)
-        keys.append(timeout)
-        return self.execute_command('BZPOPMAX', *keys)
-
-    def bzpopmin(self, keys, timeout=0):
-        """
-        ZPOPMIN a value off of the first non-empty sorted set
-        named in the ``keys`` list.
-
-        If none of the sorted sets in ``keys`` has a value to ZPOPMIN,
-        then block for ``timeout`` seconds, or until a member gets added
-        to one of the sorted sets.
-
-        If timeout is 0, then block indefinitely.
-        """
-        if timeout is None:
-            timeout = 0
-        keys = list_or_args(keys, None)
-        keys.append(timeout)
-        return self.execute_command('BZPOPMIN', *keys)
-
-    def zrange(self, name, start, end, desc=False, withscores=False,
-               score_cast_func=float):
-        """
-        Return a range of values from sorted set ``name`` between
-        ``start`` and ``end`` sorted in ascending order.
-
-        ``start`` and ``end`` can be negative, indicating the end of the range.
-
-        ``desc`` a boolean indicating whether to sort the results descendingly
-
-        ``withscores`` indicates to return the scores along with the values.
-        The return type is a list of (value, score) pairs
-
-        ``score_cast_func`` a callable used to cast the score return value
-        """
-        if desc:
-            return self.zrevrange(name, start, end, withscores,
-                                  score_cast_func)
-        pieces = ['ZRANGE', name, start, end]
-        if withscores:
-            pieces.append(b'WITHSCORES')
-        options = {
-            'withscores': withscores,
-            'score_cast_func': score_cast_func
-        }
-        return self.execute_command(*pieces, **options)
-
-    def zrangestore(self, dest, name, start, end):
-        """
-        Stores in ``dest`` the result of a range of values from sorted set
-        ``name`` between ``start`` and ``end`` sorted in ascending order.
-
-        ``start`` and ``end`` can be negative, indicating the end of the range.
-        """
-        return self.execute_command('ZRANGESTORE', dest, name, start, end)
-
-    def zrangebylex(self, name, min, max, start=None, num=None):
-        """
-        Return the lexicographical range of values from sorted set ``name``
-        between ``min`` and ``max``.
-
-        If ``start`` and ``num`` are specified, then return a slice of the
-        range.
-        """
-        if (start is not None and num is None) or \
-                (num is not None and start is None):
-            raise DataError("``start`` and ``num`` must both be specified")
-        pieces = ['ZRANGEBYLEX', name, min, max]
-        if start is not None and num is not None:
-            pieces.extend([b'LIMIT', start, num])
-        return self.execute_command(*pieces)
-
-    def zrevrangebylex(self, name, max, min, start=None, num=None):
-        """
-        Return the reversed lexicographical range of values from sorted set
-        ``name`` between ``max`` and ``min``.
-
-        If ``start`` and ``num`` are specified, then return a slice of the
-        range.
-        """
-        if (start is not None and num is None) or \
-                (num is not None and start is None):
-            raise DataError("``start`` and ``num`` must both be specified")
-        pieces = ['ZREVRANGEBYLEX', name, max, min]
-        if start is not None and num is not None:
-            pieces.extend([b'LIMIT', start, num])
-        return self.execute_command(*pieces)
-
-    def zrangebyscore(self, name, min, max, start=None, num=None,
-                      withscores=False, score_cast_func=float):
-        """
-        Return a range of values from the sorted set ``name`` with scores
-        between ``min`` and ``max``.
-
-        If ``start`` and ``num`` are specified, then return a slice
-        of the range.
-
-        ``withscores`` indicates to return the scores along with the values.
-        The return type is a list of (value, score) pairs
-
-        `score_cast_func`` a callable used to cast the score return value
-        """
-        if (start is not None and num is None) or \
-                (num is not None and start is None):
-            raise DataError("``start`` and ``num`` must both be specified")
-        pieces = ['ZRANGEBYSCORE', name, min, max]
-        if start is not None and num is not None:
-            pieces.extend([b'LIMIT', start, num])
-        if withscores:
-            pieces.append(b'WITHSCORES')
-        options = {
-            'withscores': withscores,
-            'score_cast_func': score_cast_func
-        }
-        return self.execute_command(*pieces, **options)
-
-    def zrank(self, name, value):
-        """
-        Returns a 0-based value indicating the rank of ``value`` in sorted set
-        ``name``
-        """
-        return self.execute_command('ZRANK', name, value)
-
-    def zrem(self, name, *values):
-        "Remove member ``values`` from sorted set ``name``"
-        return self.execute_command('ZREM', name, *values)
-
-    def zremrangebylex(self, name, min, max):
-        """
-        Remove all elements in the sorted set ``name`` between the
-        lexicographical range specified by ``min`` and ``max``.
-
-        Returns the number of elements removed.
-        """
-        return self.execute_command('ZREMRANGEBYLEX', name, min, max)
-
-    def zremrangebyrank(self, name, min, max):
-        """
-        Remove all elements in the sorted set ``name`` with ranks between
-        ``min`` and ``max``. Values are 0-based, ordered from smallest score
-        to largest. Values can be negative indicating the highest scores.
-        Returns the number of elements removed
-        """
-        return self.execute_command('ZREMRANGEBYRANK', name, min, max)
-
-    def zremrangebyscore(self, name, min, max):
-        """
-        Remove all elements in the sorted set ``name`` with scores
-        between ``min`` and ``max``. Returns the number of elements removed.
-        """
-        return self.execute_command('ZREMRANGEBYSCORE', name, min, max)
-
-    def zrevrange(self, name, start, end, withscores=False,
-                  score_cast_func=float):
-        """
-        Return a range of values from sorted set ``name`` between
-        ``start`` and ``end`` sorted in descending order.
-
-        ``start`` and ``end`` can be negative, indicating the end of the range.
-
-        ``withscores`` indicates to return the scores along with the values
-        The return type is a list of (value, score) pairs
-
-        ``score_cast_func`` a callable used to cast the score return value
-        """
-        pieces = ['ZREVRANGE', name, start, end]
-        if withscores:
-            pieces.append(b'WITHSCORES')
-        options = {
-            'withscores': withscores,
-            'score_cast_func': score_cast_func
-        }
-        return self.execute_command(*pieces, **options)
-
-    def zrevrangebyscore(self, name, max, min, start=None, num=None,
-                         withscores=False, score_cast_func=float):
-        """
-        Return a range of values from the sorted set ``name`` with scores
-        between ``min`` and ``max`` in descending order.
-
-        If ``start`` and ``num`` are specified, then return a slice
-        of the range.
-
-        ``withscores`` indicates to return the scores along with the values.
-        The return type is a list of (value, score) pairs
-
-        ``score_cast_func`` a callable used to cast the score return value
-        """
-        if (start is not None and num is None) or \
-                (num is not None and start is None):
-            raise DataError("``start`` and ``num`` must both be specified")
-        pieces = ['ZREVRANGEBYSCORE', name, max, min]
-        if start is not None and num is not None:
-            pieces.extend([b'LIMIT', start, num])
-        if withscores:
-            pieces.append(b'WITHSCORES')
-        options = {
-            'withscores': withscores,
-            'score_cast_func': score_cast_func
-        }
-        return self.execute_command(*pieces, **options)
-
-    def zrevrank(self, name, value):
-        """
-        Returns a 0-based value indicating the descending rank of
-        ``value`` in sorted set ``name``
-        """
-        return self.execute_command('ZREVRANK', name, value)
-
-    def zscore(self, name, value):
-        "Return the score of element ``value`` in sorted set ``name``"
-        return self.execute_command('ZSCORE', name, value)
-
-    def zunion(self, keys, aggregate=None, withscores=False):
-        """
-        Return the union of multiple sorted sets specified by ``keys``.
-        ``keys`` can be provided as dictionary of keys and their weights.
-        Scores will be aggregated based on the ``aggregate``, or SUM if
-        none is provided.
-        """
-        return self._zaggregate('ZUNION', None, keys, aggregate,
-                                withscores=withscores)
-
-    def zunionstore(self, dest, keys, aggregate=None):
-        """
-        Union multiple sorted sets specified by ``keys`` into
-        a new sorted set, ``dest``. Scores in the destination will be
-        aggregated based on the ``aggregate``, or SUM if none is provided.
-        """
-        return self._zaggregate('ZUNIONSTORE', dest, keys, aggregate)
-
-    def _zaggregate(self, command, dest, keys, aggregate=None,
-                    **options):
-        pieces = [command]
-        if dest is not None:
-            pieces.append(dest)
-        pieces.append(len(keys))
-        if isinstance(keys, dict):
-            keys, weights = keys.keys(), keys.values()
-        else:
-            weights = None
-        pieces.extend(keys)
-        if weights:
-            pieces.append(b'WEIGHTS')
-            pieces.extend(weights)
-        if aggregate:
-            if aggregate.upper() in ['SUM', 'MIN', 'MAX']:
-                pieces.append(b'AGGREGATE')
-                pieces.append(aggregate)
-            else:
-                raise DataError("aggregate can be sum, min or max.")
-        if options.get('withscores', False):
-            pieces.append(b'WITHSCORES')
-        return self.execute_command(*pieces, **options)
-
-    # HYPERLOGLOG COMMANDS
-    def pfadd(self, name, *values):
-        "Adds the specified elements to the specified HyperLogLog."
-        return self.execute_command('PFADD', name, *values)
-
-    def pfcount(self, *sources):
-        """
-        Return the approximated cardinality of
-        the set observed by the HyperLogLog at key(s).
-        """
-        return self.execute_command('PFCOUNT', *sources)
-
-    def pfmerge(self, dest, *sources):
-        "Merge N different HyperLogLogs into a single one."
-        return self.execute_command('PFMERGE', dest, *sources)
-
-    # HASH COMMANDS
-    def hdel(self, name, *keys):
-        "Delete ``keys`` from hash ``name``"
-        return self.execute_command('HDEL', name, *keys)
-
-    def hexists(self, name, key):
-        "Returns a boolean indicating if ``key`` exists within hash ``name``"
-        return self.execute_command('HEXISTS', name, key)
-
-    def hget(self, name, key):
-        "Return the value of ``key`` within the hash ``name``"
-        return self.execute_command('HGET', name, key)
-
-    def hgetall(self, name):
-        "Return a Python dict of the hash's name/value pairs"
-        return self.execute_command('HGETALL', name)
-
-    def hincrby(self, name, key, amount=1):
-        "Increment the value of ``key`` in hash ``name`` by ``amount``"
-        return self.execute_command('HINCRBY', name, key, amount)
-
-    def hincrbyfloat(self, name, key, amount=1.0):
-        """
-        Increment the value of ``key`` in hash ``name`` by floating ``amount``
-        """
-        return self.execute_command('HINCRBYFLOAT', name, key, amount)
-
-    def hkeys(self, name):
-        "Return the list of keys within hash ``name``"
-        return self.execute_command('HKEYS', name)
-
-    def hlen(self, name):
-        "Return the number of elements in hash ``name``"
-        return self.execute_command('HLEN', name)
-
-    def hset(self, name, key=None, value=None, mapping=None):
-        """
-        Set ``key`` to ``value`` within hash ``name``,
-        ``mapping`` accepts a dict of key/value pairs that will be
-        added to hash ``name``.
-        Returns the number of fields that were added.
-        """
-        if key is None and not mapping:
-            raise DataError("'hset' with no key value pairs")
-        items = []
-        if key is not None:
-            items.extend((key, value))
-        if mapping:
-            for pair in mapping.items():
-                items.extend(pair)
-
-        return self.execute_command('HSET', name, *items)
-
-    def hsetnx(self, name, key, value):
-        """
-        Set ``key`` to ``value`` within hash ``name`` if ``key`` does not
-        exist.  Returns 1 if HSETNX created a field, otherwise 0.
-        """
-        return self.execute_command('HSETNX', name, key, value)
-
-    def hmset(self, name, mapping):
-        """
-        Set key to value within hash ``name`` for each corresponding
-        key and value from the ``mapping`` dict.
-        """
-        warnings.warn(
-            '%s.hmset() is deprecated. Use %s.hset() instead.'
-            % (self.__class__.__name__, self.__class__.__name__),
-            DeprecationWarning,
-            stacklevel=2,
-        )
-        if not mapping:
-            raise DataError("'hmset' with 'mapping' of length 0")
-        items = []
-        for pair in mapping.items():
-            items.extend(pair)
-        return self.execute_command('HMSET', name, *items)
-
-    def hmget(self, name, keys, *args):
-        "Returns a list of values ordered identically to ``keys``"
-        args = list_or_args(keys, args)
-        return self.execute_command('HMGET', name, *args)
-
-    def hvals(self, name):
-        "Return the list of values within hash ``name``"
-        return self.execute_command('HVALS', name)
-
-    def hstrlen(self, name, key):
-        """
-        Return the number of bytes stored in the value of ``key``
-        within hash ``name``
-        """
-        return self.execute_command('HSTRLEN', name, key)
-
-    def publish(self, channel, message):
-        """
-        Publish ``message`` on ``channel``.
-        Returns the number of subscribers the message was delivered to.
-        """
-        return self.execute_command('PUBLISH', channel, message)
-
-    def pubsub_channels(self, pattern='*'):
-        """
-        Return a list of channels that have at least one subscriber
-        """
-        return self.execute_command('PUBSUB CHANNELS', pattern)
-
-    def pubsub_numpat(self):
-        """
-        Returns the number of subscriptions to patterns
-        """
-        return self.execute_command('PUBSUB NUMPAT')
-
-    def pubsub_numsub(self, *args):
-        """
-        Return a list of (channel, number of subscribers) tuples
-        for each channel given in ``*args``
-        """
-        return self.execute_command('PUBSUB NUMSUB', *args)
-
-    def cluster(self, cluster_arg, *args):
-        return self.execute_command('CLUSTER %s' % cluster_arg.upper(), *args)
-
-    def eval(self, script, numkeys, *keys_and_args):
-        """
-        Execute the Lua ``script``, specifying the ``numkeys`` the script
-        will touch and the key names and argument values in ``keys_and_args``.
-        Returns the result of the script.
-
-        In practice, use the object returned by ``register_script``. This
-        function exists purely for Redis API completion.
-        """
-        return self.execute_command('EVAL', script, numkeys, *keys_and_args)
-
-    def evalsha(self, sha, numkeys, *keys_and_args):
-        """
-        Use the ``sha`` to execute a Lua script already registered via EVAL
-        or SCRIPT LOAD. Specify the ``numkeys`` the script will touch and the
-        key names and argument values in ``keys_and_args``. Returns the result
-        of the script.
-
-        In practice, use the object returned by ``register_script``. This
-        function exists purely for Redis API completion.
-        """
-        return self.execute_command('EVALSHA', sha, numkeys, *keys_and_args)
-
-    def script_exists(self, *args):
-        """
-        Check if a script exists in the script cache by specifying the SHAs of
-        each script as ``args``. Returns a list of boolean values indicating if
-        if each already script exists in the cache.
-        """
-        return self.execute_command('SCRIPT EXISTS', *args)
-
-    def script_flush(self):
-        "Flush all scripts from the script cache"
-        return self.execute_command('SCRIPT FLUSH')
-
-    def script_kill(self):
-        "Kill the currently executing Lua script"
-        return self.execute_command('SCRIPT KILL')
-
-    def script_load(self, script):
-        "Load a Lua ``script`` into the script cache. Returns the SHA."
-        return self.execute_command('SCRIPT LOAD', script)
-
-    def register_script(self, script):
-        """
-        Register a Lua ``script`` specifying the ``keys`` it will touch.
-        Returns a Script object that is callable and hides the complexity of
-        deal with scripts, keys, and shas. This is the preferred way to work
-        with Lua scripts.
-        """
-        return Script(self, script)
-
-    # GEO COMMANDS
-    def geoadd(self, name, *values):
-        """
-        Add the specified geospatial items to the specified key identified
-        by the ``name`` argument. The Geospatial items are given as ordered
-        members of the ``values`` argument, each item or place is formed by
-        the triad longitude, latitude and name.
-        """
-        if len(values) % 3 != 0:
-            raise DataError("GEOADD requires places with lon, lat and name"
-                            " values")
-        return self.execute_command('GEOADD', name, *values)
-
-    def geodist(self, name, place1, place2, unit=None):
-        """
-        Return the distance between ``place1`` and ``place2`` members of the
-        ``name`` key.
-        The units must be one of the following : m, km mi, ft. By default
-        meters are used.
-        """
-        pieces = [name, place1, place2]
-        if unit and unit not in ('m', 'km', 'mi', 'ft'):
-            raise DataError("GEODIST invalid unit")
-        elif unit:
-            pieces.append(unit)
-        return self.execute_command('GEODIST', *pieces)
-
-    def geohash(self, name, *values):
-        """
-        Return the geo hash string for each item of ``values`` members of
-        the specified key identified by the ``name`` argument.
-        """
-        return self.execute_command('GEOHASH', name, *values)
-
-    def geopos(self, name, *values):
-        """
-        Return the positions of each item of ``values`` as members of
-        the specified key identified by the ``name`` argument. Each position
-        is represented by the pairs lon and lat.
-        """
-        return self.execute_command('GEOPOS', name, *values)
-
-    def georadius(self, name, longitude, latitude, radius, unit=None,
-                  withdist=False, withcoord=False, withhash=False, count=None,
-                  sort=None, store=None, store_dist=None):
-        """
-        Return the members of the specified key identified by the
-        ``name`` argument which are within the borders of the area specified
-        with the ``latitude`` and ``longitude`` location and the maximum
-        distance from the center specified by the ``radius`` value.
-
-        The units must be one of the following : m, km mi, ft. By default
-
-        ``withdist`` indicates to return the distances of each place.
-
-        ``withcoord`` indicates to return the latitude and longitude of
-        each place.
-
-        ``withhash`` indicates to return the geohash string of each place.
-
-        ``count`` indicates to return the number of elements up to N.
-
-        ``sort`` indicates to return the places in a sorted way, ASC for
-        nearest to fairest and DESC for fairest to nearest.
-
-        ``store`` indicates to save the places names in a sorted set named
-        with a specific key, each element of the destination sorted set is
-        populated with the score got from the original geo sorted set.
-
-        ``store_dist`` indicates to save the places names in a sorted set
-        named with a specific key, instead of ``store`` the sorted set
-        destination score is set with the distance.
-        """
-        return self._georadiusgeneric('GEORADIUS',
-                                      name, longitude, latitude, radius,
-                                      unit=unit, withdist=withdist,
-                                      withcoord=withcoord, withhash=withhash,
-                                      count=count, sort=sort, store=store,
-                                      store_dist=store_dist)
-
-    def georadiusbymember(self, name, member, radius, unit=None,
-                          withdist=False, withcoord=False, withhash=False,
-                          count=None, sort=None, store=None, store_dist=None):
-        """
-        This command is exactly like ``georadius`` with the sole difference
-        that instead of taking, as the center of the area to query, a longitude
-        and latitude value, it takes the name of a member already existing
-        inside the geospatial index represented by the sorted set.
-        """
-        return self._georadiusgeneric('GEORADIUSBYMEMBER',
-                                      name, member, radius, unit=unit,
-                                      withdist=withdist, withcoord=withcoord,
-                                      withhash=withhash, count=count,
-                                      sort=sort, store=store,
-                                      store_dist=store_dist)
-
-    def _georadiusgeneric(self, command, *args, **kwargs):
-        pieces = list(args)
-        if kwargs['unit'] and kwargs['unit'] not in ('m', 'km', 'mi', 'ft'):
-            raise DataError("GEORADIUS invalid unit")
-        elif kwargs['unit']:
-            pieces.append(kwargs['unit'])
-        else:
-            pieces.append('m',)
-
-        for arg_name, byte_repr in (
-                ('withdist', b'WITHDIST'),
-                ('withcoord', b'WITHCOORD'),
-                ('withhash', b'WITHHASH')):
-            if kwargs[arg_name]:
-                pieces.append(byte_repr)
-
-        if kwargs['count']:
-            pieces.extend([b'COUNT', kwargs['count']])
-
-        if kwargs['sort']:
-            if kwargs['sort'] == 'ASC':
-                pieces.append(b'ASC')
-            elif kwargs['sort'] == 'DESC':
-                pieces.append(b'DESC')
-            else:
-                raise DataError("GEORADIUS invalid sort")
-
-        if kwargs['store'] and kwargs['store_dist']:
-            raise DataError("GEORADIUS store and store_dist cant be set"
-                            " together")
-
-        if kwargs['store']:
-            pieces.extend([b'STORE', kwargs['store']])
-
-        if kwargs['store_dist']:
-            pieces.extend([b'STOREDIST', kwargs['store_dist']])
-
-        return self.execute_command(command, *pieces, **kwargs)
-
-    # MODULE COMMANDS
-    def module_load(self, path):
-        """
-        Loads the module from ``path``.
-        Raises ``ModuleError`` if a module is not found at ``path``.
-        """
-        return self.execute_command('MODULE LOAD', path)
-
-    def module_unload(self, name):
-        """
-        Unloads the module ``name``.
-        Raises ``ModuleError`` if ``name`` is not in loaded modules.
-        """
-        return self.execute_command('MODULE UNLOAD', name)
-
-    def module_list(self):
-        """
-        Returns a list of dictionaries containing the name and version of
-        all loaded modules.
-        """
-        return self.execute_command('MODULE LIST')
-
 
 StrictRedis = Redis
 
diff --git a/redis/commands.py b/redis/commands.py
new file mode 100644
index 0000000000..003b0f1bcc
--- /dev/null
+++ b/redis/commands.py
@@ -0,0 +1,2995 @@
+import datetime
+import time
+import warnings
+import hashlib
+
+from redis.exceptions import (
+    ConnectionError,
+    DataError,
+    NoScriptError,
+    RedisError,
+)
+
+
+def list_or_args(keys, args):
+    # returns a single new list combining keys and args
+    try:
+        iter(keys)
+        # a string or bytes instance can be iterated, but indicates
+        # keys wasn't passed as a list
+        if isinstance(keys, (bytes, str)):
+            keys = [keys]
+        else:
+            keys = list(keys)
+    except TypeError:
+        keys = [keys]
+    if args:
+        keys.extend(args)
+    return keys
+
+
+class Commands:
+    """
+    A class containing all of the implemented redis commands. This class is
+    to be used as a mixin.
+    """
+
+    # SERVER INFORMATION
+
+    # ACL methods
+    def acl_cat(self, category=None):
+        """
+        Returns a list of categories or commands within a category.
+
+        If ``category`` is not supplied, returns a list of all categories.
+        If ``category`` is supplied, returns a list of all commands within
+        that category.
+        """
+        pieces = [category] if category else []
+        return self.execute_command('ACL CAT', *pieces)
+
+    def acl_deluser(self, username):
+        "Delete the ACL for the specified ``username``"
+        return self.execute_command('ACL DELUSER', username)
+
+    def acl_genpass(self):
+        "Generate a random password value"
+        return self.execute_command('ACL GENPASS')
+
+    def acl_getuser(self, username):
+        """
+        Get the ACL details for the specified ``username``.
+
+        If ``username`` does not exist, return None
+        """
+        return self.execute_command('ACL GETUSER', username)
+
+    def acl_list(self):
+        "Return a list of all ACLs on the server"
+        return self.execute_command('ACL LIST')
+
+    def acl_log(self, count=None):
+        """
+        Get ACL logs as a list.
+        :param int count: Get logs[0:count].
+        :rtype: List.
+        """
+        args = []
+        if count is not None:
+            if not isinstance(count, int):
+                raise DataError('ACL LOG count must be an '
+                                'integer')
+            args.append(count)
+
+        return self.execute_command('ACL LOG', *args)
+
+    def acl_log_reset(self):
+        """
+        Reset ACL logs.
+        :rtype: Boolean.
+        """
+        args = [b'RESET']
+        return self.execute_command('ACL LOG', *args)
+
+    def acl_load(self):
+        """
+        Load ACL rules from the configured ``aclfile``.
+
+        Note that the server must be configured with the ``aclfile``
+        directive to be able to load ACL rules from an aclfile.
+        """
+        return self.execute_command('ACL LOAD')
+
+    def acl_save(self):
+        """
+        Save ACL rules to the configured ``aclfile``.
+
+        Note that the server must be configured with the ``aclfile``
+        directive to be able to save ACL rules to an aclfile.
+        """
+        return self.execute_command('ACL SAVE')
+
+    def acl_setuser(self, username, enabled=False, nopass=False,
+                    passwords=None, hashed_passwords=None, categories=None,
+                    commands=None, keys=None, reset=False, reset_keys=False,
+                    reset_passwords=False):
+        """
+        Create or update an ACL user.
+
+        Create or update the ACL for ``username``. If the user already exists,
+        the existing ACL is completely overwritten and replaced with the
+        specified values.
+
+        ``enabled`` is a boolean indicating whether the user should be allowed
+        to authenticate or not. Defaults to ``False``.
+
+        ``nopass`` is a boolean indicating whether the can authenticate without
+        a password. This cannot be True if ``passwords`` are also specified.
+
+        ``passwords`` if specified is a list of plain text passwords
+        to add to or remove from the user. Each password must be prefixed with
+        a '+' to add or a '-' to remove. For convenience, the value of
+        ``passwords`` can be a simple prefixed string when adding or
+        removing a single password.
+
+        ``hashed_passwords`` if specified is a list of SHA-256 hashed passwords
+        to add to or remove from the user. Each hashed password must be
+        prefixed with a '+' to add or a '-' to remove. For convenience,
+        the value of ``hashed_passwords`` can be a simple prefixed string when
+        adding or removing a single password.
+
+        ``categories`` if specified is a list of strings representing category
+        permissions. Each string must be prefixed with either a '+' to add the
+        category permission or a '-' to remove the category permission.
+
+        ``commands`` if specified is a list of strings representing command
+        permissions. Each string must be prefixed with either a '+' to add the
+        command permission or a '-' to remove the command permission.
+
+        ``keys`` if specified is a list of key patterns to grant the user
+        access to. Keys patterns allow '*' to support wildcard matching. For
+        example, '*' grants access to all keys while 'cache:*' grants access
+        to all keys that are prefixed with 'cache:'. ``keys`` should not be
+        prefixed with a '~'.
+
+        ``reset`` is a boolean indicating whether the user should be fully
+        reset prior to applying the new ACL. Setting this to True will
+        remove all existing passwords, flags and privileges from the user and
+        then apply the specified rules. If this is False, the user's existing
+        passwords, flags and privileges will be kept and any new specified
+        rules will be applied on top.
+
+        ``reset_keys`` is a boolean indicating whether the user's key
+        permissions should be reset prior to applying any new key permissions
+        specified in ``keys``. If this is False, the user's existing
+        key permissions will be kept and any new specified key permissions
+        will be applied on top.
+
+        ``reset_passwords`` is a boolean indicating whether to remove all
+        existing passwords and the 'nopass' flag from the user prior to
+        applying any new passwords specified in 'passwords' or
+        'hashed_passwords'. If this is False, the user's existing passwords
+        and 'nopass' status will be kept and any new specified passwords
+        or hashed_passwords will be applied on top.
+        """
+        encoder = self.connection_pool.get_encoder()
+        pieces = [username]
+
+        if reset:
+            pieces.append(b'reset')
+
+        if reset_keys:
+            pieces.append(b'resetkeys')
+
+        if reset_passwords:
+            pieces.append(b'resetpass')
+
+        if enabled:
+            pieces.append(b'on')
+        else:
+            pieces.append(b'off')
+
+        if (passwords or hashed_passwords) and nopass:
+            raise DataError('Cannot set \'nopass\' and supply '
+                            '\'passwords\' or \'hashed_passwords\'')
+
+        if passwords:
+            # as most users will have only one password, allow remove_passwords
+            # to be specified as a simple string or a list
+            passwords = list_or_args(passwords, [])
+            for i, password in enumerate(passwords):
+                password = encoder.encode(password)
+                if password.startswith(b'+'):
+                    pieces.append(b'>%s' % password[1:])
+                elif password.startswith(b'-'):
+                    pieces.append(b'<%s' % password[1:])
+                else:
+                    raise DataError('Password %d must be prefixeed with a '
+                                    '"+" to add or a "-" to remove' % i)
+
+        if hashed_passwords:
+            # as most users will have only one password, allow remove_passwords
+            # to be specified as a simple string or a list
+            hashed_passwords = list_or_args(hashed_passwords, [])
+            for i, hashed_password in enumerate(hashed_passwords):
+                hashed_password = encoder.encode(hashed_password)
+                if hashed_password.startswith(b'+'):
+                    pieces.append(b'#%s' % hashed_password[1:])
+                elif hashed_password.startswith(b'-'):
+                    pieces.append(b'!%s' % hashed_password[1:])
+                else:
+                    raise DataError('Hashed %d password must be prefixeed '
+                                    'with a "+" to add or a "-" to remove' % i)
+
+        if nopass:
+            pieces.append(b'nopass')
+
+        if categories:
+            for category in categories:
+                category = encoder.encode(category)
+                # categories can be prefixed with one of (+@, +, -@, -)
+                if category.startswith(b'+@'):
+                    pieces.append(category)
+                elif category.startswith(b'+'):
+                    pieces.append(b'+@%s' % category[1:])
+                elif category.startswith(b'-@'):
+                    pieces.append(category)
+                elif category.startswith(b'-'):
+                    pieces.append(b'-@%s' % category[1:])
+                else:
+                    raise DataError('Category "%s" must be prefixed with '
+                                    '"+" or "-"'
+                                    % encoder.decode(category, force=True))
+        if commands:
+            for cmd in commands:
+                cmd = encoder.encode(cmd)
+                if not cmd.startswith(b'+') and not cmd.startswith(b'-'):
+                    raise DataError('Command "%s" must be prefixed with '
+                                    '"+" or "-"'
+                                    % encoder.decode(cmd, force=True))
+                pieces.append(cmd)
+
+        if keys:
+            for key in keys:
+                key = encoder.encode(key)
+                pieces.append(b'~%s' % key)
+
+        return self.execute_command('ACL SETUSER', *pieces)
+
+    def acl_users(self):
+        "Returns a list of all registered users on the server."
+        return self.execute_command('ACL USERS')
+
+    def acl_whoami(self):
+        "Get the username for the current connection"
+        return self.execute_command('ACL WHOAMI')
+
+    def bgrewriteaof(self):
+        "Tell the Redis server to rewrite the AOF file from data in memory."
+        return self.execute_command('BGREWRITEAOF')
+
+    def bgsave(self):
+        """
+        Tell the Redis server to save its data to disk.  Unlike save(),
+        this method is asynchronous and returns immediately.
+        """
+        return self.execute_command('BGSAVE')
+
+    def client_kill(self, address):
+        "Disconnects the client at ``address`` (ip:port)"
+        return self.execute_command('CLIENT KILL', address)
+
+    def client_kill_filter(self, _id=None, _type=None, addr=None,
+                           skipme=None, laddr=None):
+        """
+        Disconnects client(s) using a variety of filter options
+        :param id: Kills a client by its unique ID field
+        :param type: Kills a client by type where type is one of 'normal',
+        'master', 'slave' or 'pubsub'
+        :param addr: Kills a client by its 'address:port'
+        :param skipme: If True, then the client calling the command
+        :param laddr: Kills a cient by its 'local (bind)  address:port'
+        will not get killed even if it is identified by one of the filter
+        options. If skipme is not provided, the server defaults to skipme=True
+        """
+        args = []
+        if _type is not None:
+            client_types = ('normal', 'master', 'slave', 'pubsub')
+            if str(_type).lower() not in client_types:
+                raise DataError("CLIENT KILL type must be one of %r" % (
+                                client_types,))
+            args.extend((b'TYPE', _type))
+        if skipme is not None:
+            if not isinstance(skipme, bool):
+                raise DataError("CLIENT KILL skipme must be a bool")
+            if skipme:
+                args.extend((b'SKIPME', b'YES'))
+            else:
+                args.extend((b'SKIPME', b'NO'))
+        if _id is not None:
+            args.extend((b'ID', _id))
+        if addr is not None:
+            args.extend((b'ADDR', addr))
+        if laddr is not None:
+            args.extend((b'LADDR', laddr))
+        if not args:
+            raise DataError("CLIENT KILL <filter> <value> ... ... <filter> "
+                            "<value> must specify at least one filter")
+        return self.execute_command('CLIENT KILL', *args)
+
+    def client_info(self):
+        """
+        Returns information and statistics about the current
+        client connection.
+        """
+        return self.execute_command('CLIENT INFO')
+
+    def client_list(self, _type=None, client_id=None):
+        """
+        Returns a list of currently connected clients.
+        If type of client specified, only that type will be returned.
+        :param _type: optional. one of the client types (normal, master,
+         replica, pubsub)
+        """
+        "Returns a list of currently connected clients"
+        args = []
+        if _type is not None:
+            client_types = ('normal', 'master', 'replica', 'pubsub')
+            if str(_type).lower() not in client_types:
+                raise DataError("CLIENT LIST _type must be one of %r" % (
+                                client_types,))
+            args.append(b'TYPE')
+            args.append(_type)
+        if client_id is not None:
+            args.append(b"ID")
+            args.append(client_id)
+        return self.execute_command('CLIENT LIST', *args)
+
+    def client_getname(self):
+        "Returns the current connection name"
+        return self.execute_command('CLIENT GETNAME')
+
+    def client_id(self):
+        "Returns the current connection id"
+        return self.execute_command('CLIENT ID')
+
+    def client_setname(self, name):
+        "Sets the current connection name"
+        return self.execute_command('CLIENT SETNAME', name)
+
+    def client_unblock(self, client_id, error=False):
+        """
+        Unblocks a connection by its client id.
+        If ``error`` is True, unblocks the client with a special error message.
+        If ``error`` is False (default), the client is unblocked using the
+        regular timeout mechanism.
+        """
+        args = ['CLIENT UNBLOCK', int(client_id)]
+        if error:
+            args.append(b'ERROR')
+        return self.execute_command(*args)
+
+    def client_pause(self, timeout):
+        """
+        Suspend all the Redis clients for the specified amount of time
+        :param timeout: milliseconds to pause clients
+        """
+        if not isinstance(timeout, int):
+            raise DataError("CLIENT PAUSE timeout must be an integer")
+        return self.execute_command('CLIENT PAUSE', str(timeout))
+
+    def client_unpause(self):
+        """
+        Unpause all redis clients
+        """
+        return self.execute_command('CLIENT UNPAUSE')
+
+    def readwrite(self):
+        "Disables read queries for a connection to a Redis Cluster slave node"
+        return self.execute_command('READWRITE')
+
+    def readonly(self):
+        "Enables read queries for a connection to a Redis Cluster replica node"
+        return self.execute_command('READONLY')
+
+    def config_get(self, pattern="*"):
+        "Return a dictionary of configuration based on the ``pattern``"
+        return self.execute_command('CONFIG GET', pattern)
+
+    def config_set(self, name, value):
+        "Set config item ``name`` with ``value``"
+        return self.execute_command('CONFIG SET', name, value)
+
+    def config_resetstat(self):
+        "Reset runtime statistics"
+        return self.execute_command('CONFIG RESETSTAT')
+
+    def config_rewrite(self):
+        "Rewrite config file with the minimal change to reflect running config"
+        return self.execute_command('CONFIG REWRITE')
+
+    def dbsize(self):
+        "Returns the number of keys in the current database"
+        return self.execute_command('DBSIZE')
+
+    def debug_object(self, key):
+        "Returns version specific meta information about a given key"
+        return self.execute_command('DEBUG OBJECT', key)
+
+    def echo(self, value):
+        "Echo the string back from the server"
+        return self.execute_command('ECHO', value)
+
+    def flushall(self, asynchronous=False):
+        """
+        Delete all keys in all databases on the current host.
+
+        ``asynchronous`` indicates whether the operation is
+        executed asynchronously by the server.
+        """
+        args = []
+        if asynchronous:
+            args.append(b'ASYNC')
+        return self.execute_command('FLUSHALL', *args)
+
+    def flushdb(self, asynchronous=False):
+        """
+        Delete all keys in the current database.
+
+        ``asynchronous`` indicates whether the operation is
+        executed asynchronously by the server.
+        """
+        args = []
+        if asynchronous:
+            args.append(b'ASYNC')
+        return self.execute_command('FLUSHDB', *args)
+
+    def swapdb(self, first, second):
+        "Swap two databases"
+        return self.execute_command('SWAPDB', first, second)
+
+    def info(self, section=None):
+        """
+        Returns a dictionary containing information about the Redis server
+
+        The ``section`` option can be used to select a specific section
+        of information
+
+        The section option is not supported by older versions of Redis Server,
+        and will generate ResponseError
+        """
+        if section is None:
+            return self.execute_command('INFO')
+        else:
+            return self.execute_command('INFO', section)
+
+    def lastsave(self):
+        """
+        Return a Python datetime object representing the last time the
+        Redis database was saved to disk
+        """
+        return self.execute_command('LASTSAVE')
+
+    def migrate(self, host, port, keys, destination_db, timeout,
+                copy=False, replace=False, auth=None):
+        """
+        Migrate 1 or more keys from the current Redis server to a different
+        server specified by the ``host``, ``port`` and ``destination_db``.
+
+        The ``timeout``, specified in milliseconds, indicates the maximum
+        time the connection between the two servers can be idle before the
+        command is interrupted.
+
+        If ``copy`` is True, the specified ``keys`` are NOT deleted from
+        the source server.
+
+        If ``replace`` is True, this operation will overwrite the keys
+        on the destination server if they exist.
+
+        If ``auth`` is specified, authenticate to the destination server with
+        the password provided.
+        """
+        keys = list_or_args(keys, [])
+        if not keys:
+            raise DataError('MIGRATE requires at least one key')
+        pieces = []
+        if copy:
+            pieces.append(b'COPY')
+        if replace:
+            pieces.append(b'REPLACE')
+        if auth:
+            pieces.append(b'AUTH')
+            pieces.append(auth)
+        pieces.append(b'KEYS')
+        pieces.extend(keys)
+        return self.execute_command('MIGRATE', host, port, '', destination_db,
+                                    timeout, *pieces)
+
+    def object(self, infotype, key):
+        "Return the encoding, idletime, or refcount about the key"
+        return self.execute_command('OBJECT', infotype, key, infotype=infotype)
+
+    def memory_stats(self):
+        "Return a dictionary of memory stats"
+        return self.execute_command('MEMORY STATS')
+
+    def memory_usage(self, key, samples=None):
+        """
+        Return the total memory usage for key, its value and associated
+        administrative overheads.
+
+        For nested data structures, ``samples`` is the number of elements to
+        sample. If left unspecified, the server's default is 5. Use 0 to sample
+        all elements.
+        """
+        args = []
+        if isinstance(samples, int):
+            args.extend([b'SAMPLES', samples])
+        return self.execute_command('MEMORY USAGE', key, *args)
+
+    def memory_purge(self):
+        "Attempts to purge dirty pages for reclamation by allocator"
+        return self.execute_command('MEMORY PURGE')
+
+    def ping(self):
+        "Ping the Redis server"
+        return self.execute_command('PING')
+
+    def save(self):
+        """
+        Tell the Redis server to save its data to disk,
+        blocking until the save is complete
+        """
+        return self.execute_command('SAVE')
+
+    def shutdown(self, save=False, nosave=False):
+        """Shutdown the Redis server.  If Redis has persistence configured,
+        data will be flushed before shutdown.  If the "save" option is set,
+        a data flush will be attempted even if there is no persistence
+        configured.  If the "nosave" option is set, no data flush will be
+        attempted.  The "save" and "nosave" options cannot both be set.
+        """
+        if save and nosave:
+            raise DataError('SHUTDOWN save and nosave cannot both be set')
+        args = ['SHUTDOWN']
+        if save:
+            args.append('SAVE')
+        if nosave:
+            args.append('NOSAVE')
+        try:
+            self.execute_command(*args)
+        except ConnectionError:
+            # a ConnectionError here is expected
+            return
+        raise RedisError("SHUTDOWN seems to have failed.")
+
+    def slaveof(self, host=None, port=None):
+        """
+        Set the server to be a replicated slave of the instance identified
+        by the ``host`` and ``port``. If called without arguments, the
+        instance is promoted to a master instead.
+        """
+        if host is None and port is None:
+            return self.execute_command('SLAVEOF', b'NO', b'ONE')
+        return self.execute_command('SLAVEOF', host, port)
+
+    def slowlog_get(self, num=None):
+        """
+        Get the entries from the slowlog. If ``num`` is specified, get the
+        most recent ``num`` items.
+        """
+        args = ['SLOWLOG GET']
+        if num is not None:
+            args.append(num)
+        decode_responses = self.connection_pool.connection_kwargs.get(
+            'decode_responses', False)
+        return self.execute_command(*args, decode_responses=decode_responses)
+
+    def slowlog_len(self):
+        "Get the number of items in the slowlog"
+        return self.execute_command('SLOWLOG LEN')
+
+    def slowlog_reset(self):
+        "Remove all items in the slowlog"
+        return self.execute_command('SLOWLOG RESET')
+
+    def time(self):
+        """
+        Returns the server time as a 2-item tuple of ints:
+        (seconds since epoch, microseconds into this second).
+        """
+        return self.execute_command('TIME')
+
+    def wait(self, num_replicas, timeout):
+        """
+        Redis synchronous replication
+        That returns the number of replicas that processed the query when
+        we finally have at least ``num_replicas``, or when the ``timeout`` was
+        reached.
+        """
+        return self.execute_command('WAIT', num_replicas, timeout)
+
+    # BASIC KEY COMMANDS
+    def append(self, key, value):
+        """
+        Appends the string ``value`` to the value at ``key``. If ``key``
+        doesn't already exist, create it with a value of ``value``.
+        Returns the new length of the value at ``key``.
+        """
+        return self.execute_command('APPEND', key, value)
+
+    def bitcount(self, key, start=None, end=None):
+        """
+        Returns the count of set bits in the value of ``key``.  Optional
+        ``start`` and ``end`` parameters indicate which bytes to consider
+        """
+        params = [key]
+        if start is not None and end is not None:
+            params.append(start)
+            params.append(end)
+        elif (start is not None and end is None) or \
+                (end is not None and start is None):
+            raise DataError("Both start and end must be specified")
+        return self.execute_command('BITCOUNT', *params)
+
+    def bitfield(self, key, default_overflow=None):
+        """
+        Return a BitFieldOperation instance to conveniently construct one or
+        more bitfield operations on ``key``.
+        """
+        return BitFieldOperation(self, key, default_overflow=default_overflow)
+
+    def bitop(self, operation, dest, *keys):
+        """
+        Perform a bitwise operation using ``operation`` between ``keys`` and
+        store the result in ``dest``.
+        """
+        return self.execute_command('BITOP', operation, dest, *keys)
+
+    def bitpos(self, key, bit, start=None, end=None):
+        """
+        Return the position of the first bit set to 1 or 0 in a string.
+        ``start`` and ``end`` defines search range. The range is interpreted
+        as a range of bytes and not a range of bits, so start=0 and end=2
+        means to look at the first three bytes.
+        """
+        if bit not in (0, 1):
+            raise DataError('bit must be 0 or 1')
+        params = [key, bit]
+
+        start is not None and params.append(start)
+
+        if start is not None and end is not None:
+            params.append(end)
+        elif start is None and end is not None:
+            raise DataError("start argument is not set, "
+                            "when end is specified")
+        return self.execute_command('BITPOS', *params)
+
+    def copy(self, source, destination, destination_db=None, replace=False):
+        """
+        Copy the value stored in the ``source`` key to the ``destination`` key.
+
+        ``destination_db`` an alternative destination database. By default,
+        the ``destination`` key is created in the source Redis database.
+
+        ``replace`` whether the ``destination`` key should be removed before
+        copying the value to it. By default, the value is not copied if
+        the ``destination`` key already exists.
+        """
+        params = [source, destination]
+        if destination_db is not None:
+            params.extend(["DB", destination_db])
+        if replace:
+            params.append("REPLACE")
+        return self.execute_command('COPY', *params)
+
+    def decr(self, name, amount=1):
+        """
+        Decrements the value of ``key`` by ``amount``.  If no key exists,
+        the value will be initialized as 0 - ``amount``
+        """
+        # An alias for ``decr()``, because it is already implemented
+        # as DECRBY redis command.
+        return self.decrby(name, amount)
+
+    def decrby(self, name, amount=1):
+        """
+        Decrements the value of ``key`` by ``amount``.  If no key exists,
+        the value will be initialized as 0 - ``amount``
+        """
+        return self.execute_command('DECRBY', name, amount)
+
+    def delete(self, *names):
+        "Delete one or more keys specified by ``names``"
+        return self.execute_command('DEL', *names)
+
+    def __delitem__(self, name):
+        self.delete(name)
+
+    def dump(self, name):
+        """
+        Return a serialized version of the value stored at the specified key.
+        If key does not exist a nil bulk reply is returned.
+        """
+        return self.execute_command('DUMP', name)
+
+    def exists(self, *names):
+        "Returns the number of ``names`` that exist"
+        return self.execute_command('EXISTS', *names)
+    __contains__ = exists
+
+    def expire(self, name, time):
+        """
+        Set an expire flag on key ``name`` for ``time`` seconds. ``time``
+        can be represented by an integer or a Python timedelta object.
+        """
+        if isinstance(time, datetime.timedelta):
+            time = int(time.total_seconds())
+        return self.execute_command('EXPIRE', name, time)
+
+    def expireat(self, name, when):
+        """
+        Set an expire flag on key ``name``. ``when`` can be represented
+        as an integer indicating unix time or a Python datetime object.
+        """
+        if isinstance(when, datetime.datetime):
+            when = int(time.mktime(when.timetuple()))
+        return self.execute_command('EXPIREAT', name, when)
+
+    def get(self, name):
+        """
+        Return the value at key ``name``, or None if the key doesn't exist
+        """
+        return self.execute_command('GET', name)
+
+    def getdel(self, name):
+        """
+        Get the value at key ``name`` and delete the key. This command
+        is similar to GET, except for the fact that it also deletes
+        the key on success (if and only if the key's value type
+        is a string).
+        """
+        return self.execute_command('GETDEL', name)
+
+    def getex(self, name,
+              ex=None, px=None, exat=None, pxat=None, persist=False):
+        """
+        Get the value of key and optionally set its expiration.
+        GETEX is similar to GET, but is a write command with
+        additional options. All time parameters can be given as
+        datetime.timedelta or integers.
+
+        ``ex`` sets an expire flag on key ``name`` for ``ex`` seconds.
+
+        ``px`` sets an expire flag on key ``name`` for ``px`` milliseconds.
+
+        ``exat`` sets an expire flag on key ``name`` for ``ex`` seconds,
+        specified in unix time.
+
+        ``pxat`` sets an expire flag on key ``name`` for ``ex`` milliseconds,
+        specified in unix time.
+
+        ``persist`` remove the time to live associated with ``name``.
+        """
+
+        opset = set([ex, px, exat, pxat])
+        if len(opset) > 2 or len(opset) > 1 and persist:
+            raise DataError("``ex``, ``px``, ``exat``, ``pxat``",
+                            "and ``persist`` are mutually exclusive.")
+
+        pieces = []
+        # similar to set command
+        if ex is not None:
+            pieces.append('EX')
+            if isinstance(ex, datetime.timedelta):
+                ex = int(ex.total_seconds())
+            pieces.append(ex)
+        if px is not None:
+            pieces.append('PX')
+            if isinstance(px, datetime.timedelta):
+                px = int(px.total_seconds() * 1000)
+            pieces.append(px)
+        # similar to pexpireat command
+        if exat is not None:
+            pieces.append('EXAT')
+            if isinstance(exat, datetime.datetime):
+                s = int(exat.microsecond / 1000000)
+                exat = int(time.mktime(exat.timetuple())) + s
+            pieces.append(exat)
+        if pxat is not None:
+            pieces.append('PXAT')
+            if isinstance(pxat, datetime.datetime):
+                ms = int(pxat.microsecond / 1000)
+                pxat = int(time.mktime(pxat.timetuple())) * 1000 + ms
+            pieces.append(pxat)
+        if persist:
+            pieces.append('PERSIST')
+
+        return self.execute_command('GETEX', name, *pieces)
+
+    def __getitem__(self, name):
+        """
+        Return the value at key ``name``, raises a KeyError if the key
+        doesn't exist.
+        """
+        value = self.get(name)
+        if value is not None:
+            return value
+        raise KeyError(name)
+
+    def getbit(self, name, offset):
+        "Returns a boolean indicating the value of ``offset`` in ``name``"
+        return self.execute_command('GETBIT', name, offset)
+
+    def getrange(self, key, start, end):
+        """
+        Returns the substring of the string value stored at ``key``,
+        determined by the offsets ``start`` and ``end`` (both are inclusive)
+        """
+        return self.execute_command('GETRANGE', key, start, end)
+
+    def getset(self, name, value):
+        """
+        Sets the value at key ``name`` to ``value``
+        and returns the old value at key ``name`` atomically.
+
+        As per Redis 6.2, GETSET is considered deprecated.
+        Please use SET with GET parameter in new code.
+        """
+        return self.execute_command('GETSET', name, value)
+
+    def incr(self, name, amount=1):
+        """
+        Increments the value of ``key`` by ``amount``.  If no key exists,
+        the value will be initialized as ``amount``
+        """
+        return self.incrby(name, amount)
+
+    def incrby(self, name, amount=1):
+        """
+        Increments the value of ``key`` by ``amount``.  If no key exists,
+        the value will be initialized as ``amount``
+        """
+        # An alias for ``incr()``, because it is already implemented
+        # as INCRBY redis command.
+        return self.execute_command('INCRBY', name, amount)
+
+    def incrbyfloat(self, name, amount=1.0):
+        """
+        Increments the value at key ``name`` by floating ``amount``.
+        If no key exists, the value will be initialized as ``amount``
+        """
+        return self.execute_command('INCRBYFLOAT', name, amount)
+
+    def keys(self, pattern='*'):
+        "Returns a list of keys matching ``pattern``"
+        return self.execute_command('KEYS', pattern)
+
+    def lmove(self, first_list, second_list, src="LEFT", dest="RIGHT"):
+        """
+        Atomically returns and removes the first/last element of a list,
+        pushing it as the first/last element on the destination list.
+        Returns the element being popped and pushed.
+        """
+        params = [first_list, second_list, src, dest]
+        return self.execute_command("LMOVE", *params)
+
+    def blmove(self, first_list, second_list, timeout,
+               src="LEFT", dest="RIGHT"):
+        """
+        Blocking version of lmove.
+        """
+        params = [first_list, second_list, src, dest, timeout]
+        return self.execute_command("BLMOVE", *params)
+
+    def mget(self, keys, *args):
+        """
+        Returns a list of values ordered identically to ``keys``
+        """
+        from redis.client import EMPTY_RESPONSE
+        args = list_or_args(keys, args)
+        options = {}
+        if not args:
+            options[EMPTY_RESPONSE] = []
+        return self.execute_command('MGET', *args, **options)
+
+    def mset(self, mapping):
+        """
+        Sets key/values based on a mapping. Mapping is a dictionary of
+        key/value pairs. Both keys and values should be strings or types that
+        can be cast to a string via str().
+        """
+        items = []
+        for pair in mapping.items():
+            items.extend(pair)
+        return self.execute_command('MSET', *items)
+
+    def msetnx(self, mapping):
+        """
+        Sets key/values based on a mapping if none of the keys are already set.
+        Mapping is a dictionary of key/value pairs. Both keys and values
+        should be strings or types that can be cast to a string via str().
+        Returns a boolean indicating if the operation was successful.
+        """
+        items = []
+        for pair in mapping.items():
+            items.extend(pair)
+        return self.execute_command('MSETNX', *items)
+
+    def move(self, name, db):
+        "Moves the key ``name`` to a different Redis database ``db``"
+        return self.execute_command('MOVE', name, db)
+
+    def persist(self, name):
+        "Removes an expiration on ``name``"
+        return self.execute_command('PERSIST', name)
+
+    def pexpire(self, name, time):
+        """
+        Set an expire flag on key ``name`` for ``time`` milliseconds.
+        ``time`` can be represented by an integer or a Python timedelta
+        object.
+        """
+        if isinstance(time, datetime.timedelta):
+            time = int(time.total_seconds() * 1000)
+        return self.execute_command('PEXPIRE', name, time)
+
+    def pexpireat(self, name, when):
+        """
+        Set an expire flag on key ``name``. ``when`` can be represented
+        as an integer representing unix time in milliseconds (unix time * 1000)
+        or a Python datetime object.
+        """
+        if isinstance(when, datetime.datetime):
+            ms = int(when.microsecond / 1000)
+            when = int(time.mktime(when.timetuple())) * 1000 + ms
+        return self.execute_command('PEXPIREAT', name, when)
+
+    def psetex(self, name, time_ms, value):
+        """
+        Set the value of key ``name`` to ``value`` that expires in ``time_ms``
+        milliseconds. ``time_ms`` can be represented by an integer or a Python
+        timedelta object
+        """
+        if isinstance(time_ms, datetime.timedelta):
+            time_ms = int(time_ms.total_seconds() * 1000)
+        return self.execute_command('PSETEX', name, time_ms, value)
+
+    def pttl(self, name):
+        "Returns the number of milliseconds until the key ``name`` will expire"
+        return self.execute_command('PTTL', name)
+
+    def hrandfield(self, key, count=None, withvalues=False):
+        """
+        Return a random field from the hash value stored at key.
+
+        count: if the argument is positive, return an array of distinct fields.
+        If called with a negative count, the behavior changes and the command
+        is allowed to return the same field multiple times. In this case,
+        the number of returned fields is the absolute value of the
+        specified count.
+        withvalues: The optional WITHVALUES modifier changes the reply so it
+        includes the respective values of the randomly selected hash fields.
+        """
+        params = []
+        if count is not None:
+            params.append(count)
+        if withvalues:
+            params.append("WITHVALUES")
+
+        return self.execute_command("HRANDFIELD", key, *params)
+
+    def randomkey(self):
+        "Returns the name of a random key"
+        return self.execute_command('RANDOMKEY')
+
+    def rename(self, src, dst):
+        """
+        Rename key ``src`` to ``dst``
+        """
+        return self.execute_command('RENAME', src, dst)
+
+    def renamenx(self, src, dst):
+        "Rename key ``src`` to ``dst`` if ``dst`` doesn't already exist"
+        return self.execute_command('RENAMENX', src, dst)
+
+    def restore(self, name, ttl, value, replace=False, absttl=False):
+        """
+        Create a key using the provided serialized value, previously obtained
+        using DUMP.
+
+        ``replace`` allows an existing key on ``name`` to be overridden. If
+        it's not specified an error is raised on collision.
+
+        ``absttl`` if True, specified ``ttl`` should represent an absolute Unix
+        timestamp in milliseconds in which the key will expire. (Redis 5.0 or
+        greater).
+        """
+        params = [name, ttl, value]
+        if replace:
+            params.append('REPLACE')
+        if absttl:
+            params.append('ABSTTL')
+        return self.execute_command('RESTORE', *params)
+
+    def set(self, name, value,
+            ex=None, px=None, nx=False, xx=False, keepttl=False, get=False):
+        """
+        Set the value at key ``name`` to ``value``
+
+        ``ex`` sets an expire flag on key ``name`` for ``ex`` seconds.
+
+        ``px`` sets an expire flag on key ``name`` for ``px`` milliseconds.
+
+        ``nx`` if set to True, set the value at key ``name`` to ``value`` only
+            if it does not exist.
+
+        ``xx`` if set to True, set the value at key ``name`` to ``value`` only
+            if it already exists.
+
+        ``keepttl`` if True, retain the time to live associated with the key.
+            (Available since Redis 6.0)
+
+        ``get`` if True, set the value at key ``name`` to ``value`` and return
+            the old value stored at key, or None when key did not exist.
+            (Available since Redis 6.2)
+        """
+        pieces = [name, value]
+        options = {}
+        if ex is not None:
+            pieces.append('EX')
+            if isinstance(ex, datetime.timedelta):
+                ex = int(ex.total_seconds())
+            pieces.append(ex)
+        if px is not None:
+            pieces.append('PX')
+            if isinstance(px, datetime.timedelta):
+                px = int(px.total_seconds() * 1000)
+            pieces.append(px)
+
+        if nx:
+            pieces.append('NX')
+        if xx:
+            pieces.append('XX')
+
+        if keepttl:
+            pieces.append('KEEPTTL')
+
+        if get:
+            pieces.append('GET')
+            options["get"] = True
+
+        return self.execute_command('SET', *pieces, **options)
+
+    def __setitem__(self, name, value):
+        self.set(name, value)
+
+    def setbit(self, name, offset, value):
+        """
+        Flag the ``offset`` in ``name`` as ``value``. Returns a boolean
+        indicating the previous value of ``offset``.
+        """
+        value = value and 1 or 0
+        return self.execute_command('SETBIT', name, offset, value)
+
+    def setex(self, name, time, value):
+        """
+        Set the value of key ``name`` to ``value`` that expires in ``time``
+        seconds. ``time`` can be represented by an integer or a Python
+        timedelta object.
+        """
+        if isinstance(time, datetime.timedelta):
+            time = int(time.total_seconds())
+        return self.execute_command('SETEX', name, time, value)
+
+    def setnx(self, name, value):
+        "Set the value of key ``name`` to ``value`` if key doesn't exist"
+        return self.execute_command('SETNX', name, value)
+
+    def setrange(self, name, offset, value):
+        """
+        Overwrite bytes in the value of ``name`` starting at ``offset`` with
+        ``value``. If ``offset`` plus the length of ``value`` exceeds the
+        length of the original value, the new value will be larger than before.
+        If ``offset`` exceeds the length of the original value, null bytes
+        will be used to pad between the end of the previous value and the start
+        of what's being injected.
+
+        Returns the length of the new string.
+        """
+        return self.execute_command('SETRANGE', name, offset, value)
+
+    def strlen(self, name):
+        "Return the number of bytes stored in the value of ``name``"
+        return self.execute_command('STRLEN', name)
+
+    def substr(self, name, start, end=-1):
+        """
+        Return a substring of the string at key ``name``. ``start`` and ``end``
+        are 0-based integers specifying the portion of the string to return.
+        """
+        return self.execute_command('SUBSTR', name, start, end)
+
+    def touch(self, *args):
+        """
+        Alters the last access time of a key(s) ``*args``. A key is ignored
+        if it does not exist.
+        """
+        return self.execute_command('TOUCH', *args)
+
+    def ttl(self, name):
+        "Returns the number of seconds until the key ``name`` will expire"
+        return self.execute_command('TTL', name)
+
+    def type(self, name):
+        "Returns the type of key ``name``"
+        return self.execute_command('TYPE', name)
+
+    def watch(self, *names):
+        """
+        Watches the values at keys ``names``, or None if the key doesn't exist
+        """
+        warnings.warn(DeprecationWarning('Call WATCH from a Pipeline object'))
+
+    def unwatch(self):
+        """
+        Unwatches the value at key ``name``, or None of the key doesn't exist
+        """
+        warnings.warn(
+            DeprecationWarning('Call UNWATCH from a Pipeline object'))
+
+    def unlink(self, *names):
+        "Unlink one or more keys specified by ``names``"
+        return self.execute_command('UNLINK', *names)
+
+    # LIST COMMANDS
+    def blpop(self, keys, timeout=0):
+        """
+        LPOP a value off of the first non-empty list
+        named in the ``keys`` list.
+
+        If none of the lists in ``keys`` has a value to LPOP, then block
+        for ``timeout`` seconds, or until a value gets pushed on to one
+        of the lists.
+
+        If timeout is 0, then block indefinitely.
+        """
+        if timeout is None:
+            timeout = 0
+        keys = list_or_args(keys, None)
+        keys.append(timeout)
+        return self.execute_command('BLPOP', *keys)
+
+    def brpop(self, keys, timeout=0):
+        """
+        RPOP a value off of the first non-empty list
+        named in the ``keys`` list.
+
+        If none of the lists in ``keys`` has a value to RPOP, then block
+        for ``timeout`` seconds, or until a value gets pushed on to one
+        of the lists.
+
+        If timeout is 0, then block indefinitely.
+        """
+        if timeout is None:
+            timeout = 0
+        keys = list_or_args(keys, None)
+        keys.append(timeout)
+        return self.execute_command('BRPOP', *keys)
+
+    def brpoplpush(self, src, dst, timeout=0):
+        """
+        Pop a value off the tail of ``src``, push it on the head of ``dst``
+        and then return it.
+
+        This command blocks until a value is in ``src`` or until ``timeout``
+        seconds elapse, whichever is first. A ``timeout`` value of 0 blocks
+        forever.
+        """
+        if timeout is None:
+            timeout = 0
+        return self.execute_command('BRPOPLPUSH', src, dst, timeout)
+
+    def lindex(self, name, index):
+        """
+        Return the item from list ``name`` at position ``index``
+
+        Negative indexes are supported and will return an item at the
+        end of the list
+        """
+        return self.execute_command('LINDEX', name, index)
+
+    def linsert(self, name, where, refvalue, value):
+        """
+        Insert ``value`` in list ``name`` either immediately before or after
+        [``where``] ``refvalue``
+
+        Returns the new length of the list on success or -1 if ``refvalue``
+        is not in the list.
+        """
+        return self.execute_command('LINSERT', name, where, refvalue, value)
+
+    def llen(self, name):
+        "Return the length of the list ``name``"
+        return self.execute_command('LLEN', name)
+
+    def lpop(self, name, count=None):
+        """
+        Removes and returns the first elements of the list ``name``.
+
+        By default, the command pops a single element from the beginning of
+        the list. When provided with the optional ``count`` argument, the reply
+        will consist of up to count elements, depending on the list's length.
+        """
+        if count is not None:
+            return self.execute_command('LPOP', name, count)
+        else:
+            return self.execute_command('LPOP', name)
+
+    def lpush(self, name, *values):
+        "Push ``values`` onto the head of the list ``name``"
+        return self.execute_command('LPUSH', name, *values)
+
+    def lpushx(self, name, value):
+        "Push ``value`` onto the head of the list ``name`` if ``name`` exists"
+        return self.execute_command('LPUSHX', name, value)
+
+    def lrange(self, name, start, end):
+        """
+        Return a slice of the list ``name`` between
+        position ``start`` and ``end``
+
+        ``start`` and ``end`` can be negative numbers just like
+        Python slicing notation
+        """
+        return self.execute_command('LRANGE', name, start, end)
+
+    def lrem(self, name, count, value):
+        """
+        Remove the first ``count`` occurrences of elements equal to ``value``
+        from the list stored at ``name``.
+
+        The count argument influences the operation in the following ways:
+            count > 0: Remove elements equal to value moving from head to tail.
+            count < 0: Remove elements equal to value moving from tail to head.
+            count = 0: Remove all elements equal to value.
+        """
+        return self.execute_command('LREM', name, count, value)
+
+    def lset(self, name, index, value):
+        "Set ``position`` of list ``name`` to ``value``"
+        return self.execute_command('LSET', name, index, value)
+
+    def ltrim(self, name, start, end):
+        """
+        Trim the list ``name``, removing all values not within the slice
+        between ``start`` and ``end``
+
+        ``start`` and ``end`` can be negative numbers just like
+        Python slicing notation
+        """
+        return self.execute_command('LTRIM', name, start, end)
+
+    def rpop(self, name, count=None):
+        """
+        Removes and returns the last elements of the list ``name``.
+
+        By default, the command pops a single element from the end of the list.
+        When provided with the optional ``count`` argument, the reply will
+        consist of up to count elements, depending on the list's length.
+        """
+        if count is not None:
+            return self.execute_command('RPOP', name, count)
+        else:
+            return self.execute_command('RPOP', name)
+
+    def rpoplpush(self, src, dst):
+        """
+        RPOP a value off of the ``src`` list and atomically LPUSH it
+        on to the ``dst`` list.  Returns the value.
+        """
+        return self.execute_command('RPOPLPUSH', src, dst)
+
+    def rpush(self, name, *values):
+        "Push ``values`` onto the tail of the list ``name``"
+        return self.execute_command('RPUSH', name, *values)
+
+    def rpushx(self, name, value):
+        "Push ``value`` onto the tail of the list ``name`` if ``name`` exists"
+        return self.execute_command('RPUSHX', name, value)
+
+    def lpos(self, name, value, rank=None, count=None, maxlen=None):
+        """
+        Get position of ``value`` within the list ``name``
+
+         If specified, ``rank`` indicates the "rank" of the first element to
+         return in case there are multiple copies of ``value`` in the list.
+         By default, LPOS returns the position of the first occurrence of
+         ``value`` in the list. When ``rank`` 2, LPOS returns the position of
+         the second ``value`` in the list. If ``rank`` is negative, LPOS
+         searches the list in reverse. For example, -1 would return the
+         position of the last occurrence of ``value`` and -2 would return the
+         position of the next to last occurrence of ``value``.
+
+         If specified, ``count`` indicates that LPOS should return a list of
+         up to ``count`` positions. A ``count`` of 2 would return a list of
+         up to 2 positions. A ``count`` of 0 returns a list of all positions
+         matching ``value``. When ``count`` is specified and but ``value``
+         does not exist in the list, an empty list is returned.
+
+         If specified, ``maxlen`` indicates the maximum number of list
+         elements to scan. A ``maxlen`` of 1000 will only return the
+         position(s) of items within the first 1000 entries in the list.
+         A ``maxlen`` of 0 (the default) will scan the entire list.
+        """
+        pieces = [name, value]
+        if rank is not None:
+            pieces.extend(['RANK', rank])
+
+        if count is not None:
+            pieces.extend(['COUNT', count])
+
+        if maxlen is not None:
+            pieces.extend(['MAXLEN', maxlen])
+
+        return self.execute_command('LPOS', *pieces)
+
+    def sort(self, name, start=None, num=None, by=None, get=None,
+             desc=False, alpha=False, store=None, groups=False):
+        """
+        Sort and return the list, set or sorted set at ``name``.
+
+        ``start`` and ``num`` allow for paging through the sorted data
+
+        ``by`` allows using an external key to weight and sort the items.
+            Use an "*" to indicate where in the key the item value is located
+
+        ``get`` allows for returning items from external keys rather than the
+            sorted data itself.  Use an "*" to indicate where in the key
+            the item value is located
+
+        ``desc`` allows for reversing the sort
+
+        ``alpha`` allows for sorting lexicographically rather than numerically
+
+        ``store`` allows for storing the result of the sort into
+            the key ``store``
+
+        ``groups`` if set to True and if ``get`` contains at least two
+            elements, sort will return a list of tuples, each containing the
+            values fetched from the arguments to ``get``.
+
+        """
+        if (start is not None and num is None) or \
+                (num is not None and start is None):
+            raise DataError("``start`` and ``num`` must both be specified")
+
+        pieces = [name]
+        if by is not None:
+            pieces.append(b'BY')
+            pieces.append(by)
+        if start is not None and num is not None:
+            pieces.append(b'LIMIT')
+            pieces.append(start)
+            pieces.append(num)
+        if get is not None:
+            # If get is a string assume we want to get a single value.
+            # Otherwise assume it's an interable and we want to get multiple
+            # values. We can't just iterate blindly because strings are
+            # iterable.
+            if isinstance(get, (bytes, str)):
+                pieces.append(b'GET')
+                pieces.append(get)
+            else:
+                for g in get:
+                    pieces.append(b'GET')
+                    pieces.append(g)
+        if desc:
+            pieces.append(b'DESC')
+        if alpha:
+            pieces.append(b'ALPHA')
+        if store is not None:
+            pieces.append(b'STORE')
+            pieces.append(store)
+
+        if groups:
+            if not get or isinstance(get, (bytes, str)) or len(get) < 2:
+                raise DataError('when using "groups" the "get" argument '
+                                'must be specified and contain at least '
+                                'two keys')
+
+        options = {'groups': len(get) if groups else None}
+        return self.execute_command('SORT', *pieces, **options)
+
+    # SCAN COMMANDS
+    def scan(self, cursor=0, match=None, count=None, _type=None):
+        """
+        Incrementally return lists of key names. Also return a cursor
+        indicating the scan position.
+
+        ``match`` allows for filtering the keys by pattern
+
+        ``count`` provides a hint to Redis about the number of keys to
+            return per batch.
+
+        ``_type`` filters the returned values by a particular Redis type.
+            Stock Redis instances allow for the following types:
+            HASH, LIST, SET, STREAM, STRING, ZSET
+            Additionally, Redis modules can expose other types as well.
+        """
+        pieces = [cursor]
+        if match is not None:
+            pieces.extend([b'MATCH', match])
+        if count is not None:
+            pieces.extend([b'COUNT', count])
+        if _type is not None:
+            pieces.extend([b'TYPE', _type])
+        return self.execute_command('SCAN', *pieces)
+
+    def scan_iter(self, match=None, count=None, _type=None):
+        """
+        Make an iterator using the SCAN command so that the client doesn't
+        need to remember the cursor position.
+
+        ``match`` allows for filtering the keys by pattern
+
+        ``count`` provides a hint to Redis about the number of keys to
+            return per batch.
+
+        ``_type`` filters the returned values by a particular Redis type.
+            Stock Redis instances allow for the following types:
+            HASH, LIST, SET, STREAM, STRING, ZSET
+            Additionally, Redis modules can expose other types as well.
+        """
+        cursor = '0'
+        while cursor != 0:
+            cursor, data = self.scan(cursor=cursor, match=match,
+                                     count=count, _type=_type)
+            yield from data
+
+    def sscan(self, name, cursor=0, match=None, count=None):
+        """
+        Incrementally return lists of elements in a set. Also return a cursor
+        indicating the scan position.
+
+        ``match`` allows for filtering the keys by pattern
+
+        ``count`` allows for hint the minimum number of returns
+        """
+        pieces = [name, cursor]
+        if match is not None:
+            pieces.extend([b'MATCH', match])
+        if count is not None:
+            pieces.extend([b'COUNT', count])
+        return self.execute_command('SSCAN', *pieces)
+
+    def sscan_iter(self, name, match=None, count=None):
+        """
+        Make an iterator using the SSCAN command so that the client doesn't
+        need to remember the cursor position.
+
+        ``match`` allows for filtering the keys by pattern
+
+        ``count`` allows for hint the minimum number of returns
+        """
+        cursor = '0'
+        while cursor != 0:
+            cursor, data = self.sscan(name, cursor=cursor,
+                                      match=match, count=count)
+            yield from data
+
+    def hscan(self, name, cursor=0, match=None, count=None):
+        """
+        Incrementally return key/value slices in a hash. Also return a cursor
+        indicating the scan position.
+
+        ``match`` allows for filtering the keys by pattern
+
+        ``count`` allows for hint the minimum number of returns
+        """
+        pieces = [name, cursor]
+        if match is not None:
+            pieces.extend([b'MATCH', match])
+        if count is not None:
+            pieces.extend([b'COUNT', count])
+        return self.execute_command('HSCAN', *pieces)
+
+    def hscan_iter(self, name, match=None, count=None):
+        """
+        Make an iterator using the HSCAN command so that the client doesn't
+        need to remember the cursor position.
+
+        ``match`` allows for filtering the keys by pattern
+
+        ``count`` allows for hint the minimum number of returns
+        """
+        cursor = '0'
+        while cursor != 0:
+            cursor, data = self.hscan(name, cursor=cursor,
+                                      match=match, count=count)
+            yield from data.items()
+
+    def zscan(self, name, cursor=0, match=None, count=None,
+              score_cast_func=float):
+        """
+        Incrementally return lists of elements in a sorted set. Also return a
+        cursor indicating the scan position.
+
+        ``match`` allows for filtering the keys by pattern
+
+        ``count`` allows for hint the minimum number of returns
+
+        ``score_cast_func`` a callable used to cast the score return value
+        """
+        pieces = [name, cursor]
+        if match is not None:
+            pieces.extend([b'MATCH', match])
+        if count is not None:
+            pieces.extend([b'COUNT', count])
+        options = {'score_cast_func': score_cast_func}
+        return self.execute_command('ZSCAN', *pieces, **options)
+
+    def zscan_iter(self, name, match=None, count=None,
+                   score_cast_func=float):
+        """
+        Make an iterator using the ZSCAN command so that the client doesn't
+        need to remember the cursor position.
+
+        ``match`` allows for filtering the keys by pattern
+
+        ``count`` allows for hint the minimum number of returns
+
+        ``score_cast_func`` a callable used to cast the score return value
+        """
+        cursor = '0'
+        while cursor != 0:
+            cursor, data = self.zscan(name, cursor=cursor, match=match,
+                                      count=count,
+                                      score_cast_func=score_cast_func)
+            yield from data
+
+    # SET COMMANDS
+    def sadd(self, name, *values):
+        "Add ``value(s)`` to set ``name``"
+        return self.execute_command('SADD', name, *values)
+
+    def scard(self, name):
+        "Return the number of elements in set ``name``"
+        return self.execute_command('SCARD', name)
+
+    def sdiff(self, keys, *args):
+        "Return the difference of sets specified by ``keys``"
+        args = list_or_args(keys, args)
+        return self.execute_command('SDIFF', *args)
+
+    def sdiffstore(self, dest, keys, *args):
+        """
+        Store the difference of sets specified by ``keys`` into a new
+        set named ``dest``.  Returns the number of keys in the new set.
+        """
+        args = list_or_args(keys, args)
+        return self.execute_command('SDIFFSTORE', dest, *args)
+
+    def sinter(self, keys, *args):
+        "Return the intersection of sets specified by ``keys``"
+        args = list_or_args(keys, args)
+        return self.execute_command('SINTER', *args)
+
+    def sinterstore(self, dest, keys, *args):
+        """
+        Store the intersection of sets specified by ``keys`` into a new
+        set named ``dest``.  Returns the number of keys in the new set.
+        """
+        args = list_or_args(keys, args)
+        return self.execute_command('SINTERSTORE', dest, *args)
+
+    def sismember(self, name, value):
+        "Return a boolean indicating if ``value`` is a member of set ``name``"
+        return self.execute_command('SISMEMBER', name, value)
+
+    def smembers(self, name):
+        "Return all members of the set ``name``"
+        return self.execute_command('SMEMBERS', name)
+
+    def smove(self, src, dst, value):
+        "Move ``value`` from set ``src`` to set ``dst`` atomically"
+        return self.execute_command('SMOVE', src, dst, value)
+
+    def spop(self, name, count=None):
+        "Remove and return a random member of set ``name``"
+        args = (count is not None) and [count] or []
+        return self.execute_command('SPOP', name, *args)
+
+    def srandmember(self, name, number=None):
+        """
+        If ``number`` is None, returns a random member of set ``name``.
+
+        If ``number`` is supplied, returns a list of ``number`` random
+        members of set ``name``. Note this is only available when running
+        Redis 2.6+.
+        """
+        args = (number is not None) and [number] or []
+        return self.execute_command('SRANDMEMBER', name, *args)
+
+    def srem(self, name, *values):
+        "Remove ``values`` from set ``name``"
+        return self.execute_command('SREM', name, *values)
+
+    def sunion(self, keys, *args):
+        "Return the union of sets specified by ``keys``"
+        args = list_or_args(keys, args)
+        return self.execute_command('SUNION', *args)
+
+    def sunionstore(self, dest, keys, *args):
+        """
+        Store the union of sets specified by ``keys`` into a new
+        set named ``dest``.  Returns the number of keys in the new set.
+        """
+        args = list_or_args(keys, args)
+        return self.execute_command('SUNIONSTORE', dest, *args)
+
+    # STREAMS COMMANDS
+    def xack(self, name, groupname, *ids):
+        """
+        Acknowledges the successful processing of one or more messages.
+        name: name of the stream.
+        groupname: name of the consumer group.
+        *ids: message ids to acknowledge.
+        """
+        return self.execute_command('XACK', name, groupname, *ids)
+
+    def xadd(self, name, fields, id='*', maxlen=None, approximate=True,
+             nomkstream=False):
+        """
+        Add to a stream.
+        name: name of the stream
+        fields: dict of field/value pairs to insert into the stream
+        id: Location to insert this record. By default it is appended.
+        maxlen: truncate old stream members beyond this size
+        approximate: actual stream length may be slightly more than maxlen
+        nomkstream: When set to true, do not make a stream
+        """
+        pieces = []
+        if maxlen is not None:
+            if not isinstance(maxlen, int) or maxlen < 1:
+                raise DataError('XADD maxlen must be a positive integer')
+            pieces.append(b'MAXLEN')
+            if approximate:
+                pieces.append(b'~')
+            pieces.append(str(maxlen))
+        if nomkstream:
+            pieces.append(b'NOMKSTREAM')
+        pieces.append(id)
+        if not isinstance(fields, dict) or len(fields) == 0:
+            raise DataError('XADD fields must be a non-empty dict')
+        for pair in fields.items():
+            pieces.extend(pair)
+        return self.execute_command('XADD', name, *pieces)
+
+    def xautoclaim(self, name, groupname, consumername, min_idle_time,
+                   start_id=0, count=None, justid=False):
+        """
+        Transfers ownership of pending stream entries that match the specified
+        criteria. Conceptually, equivalent to calling XPENDING and then XCLAIM,
+        but provides a more straightforward way to deal with message delivery
+        failures via SCAN-like semantics.
+        name: name of the stream.
+        groupname: name of the consumer group.
+        consumername: name of a consumer that claims the message.
+        min_idle_time: filter messages that were idle less than this amount of
+        milliseconds.
+        start_id: filter messages with equal or greater ID.
+        count: optional integer, upper limit of the number of entries that the
+        command attempts to claim. Set to 100 by default.
+        justid: optional boolean, false by default. Return just an array of IDs
+        of messages successfully claimed, without returning the actual message
+        """
+        try:
+            if int(min_idle_time) < 0:
+                raise DataError("XAUTOCLAIM min_idle_time must be a non"
+                                "negative integer")
+        except TypeError:
+            pass
+
+        kwargs = {}
+        pieces = [name, groupname, consumername, min_idle_time, start_id]
+
+        try:
+            if int(count) < 0:
+                raise DataError("XPENDING count must be a integer >= 0")
+            pieces.extend([b'COUNT', count])
+        except TypeError:
+            pass
+        if justid:
+            pieces.append(b'JUSTID')
+            kwargs['parse_justid'] = True
+
+        return self.execute_command('XAUTOCLAIM', *pieces, **kwargs)
+
+    def xclaim(self, name, groupname, consumername, min_idle_time, message_ids,
+               idle=None, time=None, retrycount=None, force=False,
+               justid=False):
+        """
+        Changes the ownership of a pending message.
+        name: name of the stream.
+        groupname: name of the consumer group.
+        consumername: name of a consumer that claims the message.
+        min_idle_time: filter messages that were idle less than this amount of
+        milliseconds
+        message_ids: non-empty list or tuple of message IDs to claim
+        idle: optional. Set the idle time (last time it was delivered) of the
+         message in ms
+        time: optional integer. This is the same as idle but instead of a
+         relative amount of milliseconds, it sets the idle time to a specific
+         Unix time (in milliseconds).
+        retrycount: optional integer. set the retry counter to the specified
+         value. This counter is incremented every time a message is delivered
+         again.
+        force: optional boolean, false by default. Creates the pending message
+         entry in the PEL even if certain specified IDs are not already in the
+         PEL assigned to a different client.
+        justid: optional boolean, false by default. Return just an array of IDs
+         of messages successfully claimed, without returning the actual message
+        """
+        if not isinstance(min_idle_time, int) or min_idle_time < 0:
+            raise DataError("XCLAIM min_idle_time must be a non negative "
+                            "integer")
+        if not isinstance(message_ids, (list, tuple)) or not message_ids:
+            raise DataError("XCLAIM message_ids must be a non empty list or "
+                            "tuple of message IDs to claim")
+
+        kwargs = {}
+        pieces = [name, groupname, consumername, str(min_idle_time)]
+        pieces.extend(list(message_ids))
+
+        if idle is not None:
+            if not isinstance(idle, int):
+                raise DataError("XCLAIM idle must be an integer")
+            pieces.extend((b'IDLE', str(idle)))
+        if time is not None:
+            if not isinstance(time, int):
+                raise DataError("XCLAIM time must be an integer")
+            pieces.extend((b'TIME', str(time)))
+        if retrycount is not None:
+            if not isinstance(retrycount, int):
+                raise DataError("XCLAIM retrycount must be an integer")
+            pieces.extend((b'RETRYCOUNT', str(retrycount)))
+
+        if force:
+            if not isinstance(force, bool):
+                raise DataError("XCLAIM force must be a boolean")
+            pieces.append(b'FORCE')
+        if justid:
+            if not isinstance(justid, bool):
+                raise DataError("XCLAIM justid must be a boolean")
+            pieces.append(b'JUSTID')
+            kwargs['parse_justid'] = True
+        return self.execute_command('XCLAIM', *pieces, **kwargs)
+
+    def xdel(self, name, *ids):
+        """
+        Deletes one or more messages from a stream.
+        name: name of the stream.
+        *ids: message ids to delete.
+        """
+        return self.execute_command('XDEL', name, *ids)
+
+    def xgroup_create(self, name, groupname, id='$', mkstream=False):
+        """
+        Create a new consumer group associated with a stream.
+        name: name of the stream.
+        groupname: name of the consumer group.
+        id: ID of the last item in the stream to consider already delivered.
+        """
+        pieces = ['XGROUP CREATE', name, groupname, id]
+        if mkstream:
+            pieces.append(b'MKSTREAM')
+        return self.execute_command(*pieces)
+
+    def xgroup_delconsumer(self, name, groupname, consumername):
+        """
+        Remove a specific consumer from a consumer group.
+        Returns the number of pending messages that the consumer had before it
+        was deleted.
+        name: name of the stream.
+        groupname: name of the consumer group.
+        consumername: name of consumer to delete
+        """
+        return self.execute_command('XGROUP DELCONSUMER', name, groupname,
+                                    consumername)
+
+    def xgroup_destroy(self, name, groupname):
+        """
+        Destroy a consumer group.
+        name: name of the stream.
+        groupname: name of the consumer group.
+        """
+        return self.execute_command('XGROUP DESTROY', name, groupname)
+
+    def xgroup_setid(self, name, groupname, id):
+        """
+        Set the consumer group last delivered ID to something else.
+        name: name of the stream.
+        groupname: name of the consumer group.
+        id: ID of the last item in the stream to consider already delivered.
+        """
+        return self.execute_command('XGROUP SETID', name, groupname, id)
+
+    def xinfo_consumers(self, name, groupname):
+        """
+        Returns general information about the consumers in the group.
+        name: name of the stream.
+        groupname: name of the consumer group.
+        """
+        return self.execute_command('XINFO CONSUMERS', name, groupname)
+
+    def xinfo_groups(self, name):
+        """
+        Returns general information about the consumer groups of the stream.
+        name: name of the stream.
+        """
+        return self.execute_command('XINFO GROUPS', name)
+
+    def xinfo_stream(self, name):
+        """
+        Returns general information about the stream.
+        name: name of the stream.
+        """
+        return self.execute_command('XINFO STREAM', name)
+
+    def xlen(self, name):
+        """
+        Returns the number of elements in a given stream.
+        """
+        return self.execute_command('XLEN', name)
+
+    def xpending(self, name, groupname):
+        """
+        Returns information about pending messages of a group.
+        name: name of the stream.
+        groupname: name of the consumer group.
+        """
+        return self.execute_command('XPENDING', name, groupname)
+
+    def xpending_range(self, name, groupname, min, max, count,
+                       consumername=None, idle=None):
+        """
+        Returns information about pending messages, in a range.
+        name: name of the stream.
+        groupname: name of the consumer group.
+        min: minimum stream ID.
+        max: maximum stream ID.
+        count: number of messages to return
+        consumername: name of a consumer to filter by (optional).
+        idle: available from  version 6.2. filter entries by their
+        idle-time, given in milliseconds (optional).
+        """
+        if {min, max, count} == {None}:
+            if idle is not None or consumername is not None:
+                raise DataError("if XPENDING is provided with idle time"
+                                " or consumername, it must be provided"
+                                " with min, max and count parameters")
+            return self.xpending(name, groupname)
+
+        pieces = [name, groupname]
+        if min is None or max is None or count is None:
+            raise DataError("XPENDING must be provided with min, max "
+                            "and count parameters, or none of them.")
+        # idle
+        try:
+            if int(idle) < 0:
+                raise DataError("XPENDING idle must be a integer >= 0")
+            pieces.extend(['IDLE', idle])
+        except TypeError:
+            pass
+        # count
+        try:
+            if int(count) < 0:
+                raise DataError("XPENDING count must be a integer >= 0")
+            pieces.extend([min, max, count])
+        except TypeError:
+            pass
+
+        return self.execute_command('XPENDING', *pieces, parse_detail=True)
+
+    def xrange(self, name, min='-', max='+', count=None):
+        """
+        Read stream values within an interval.
+        name: name of the stream.
+        start: first stream ID. defaults to '-',
+               meaning the earliest available.
+        finish: last stream ID. defaults to '+',
+                meaning the latest available.
+        count: if set, only return this many items, beginning with the
+               earliest available.
+        """
+        pieces = [min, max]
+        if count is not None:
+            if not isinstance(count, int) or count < 1:
+                raise DataError('XRANGE count must be a positive integer')
+            pieces.append(b'COUNT')
+            pieces.append(str(count))
+
+        return self.execute_command('XRANGE', name, *pieces)
+
+    def xread(self, streams, count=None, block=None):
+        """
+        Block and monitor multiple streams for new data.
+        streams: a dict of stream names to stream IDs, where
+                   IDs indicate the last ID already seen.
+        count: if set, only return this many items, beginning with the
+               earliest available.
+        block: number of milliseconds to wait, if nothing already present.
+        """
+        pieces = []
+        if block is not None:
+            if not isinstance(block, int) or block < 0:
+                raise DataError('XREAD block must be a non-negative integer')
+            pieces.append(b'BLOCK')
+            pieces.append(str(block))
+        if count is not None:
+            if not isinstance(count, int) or count < 1:
+                raise DataError('XREAD count must be a positive integer')
+            pieces.append(b'COUNT')
+            pieces.append(str(count))
+        if not isinstance(streams, dict) or len(streams) == 0:
+            raise DataError('XREAD streams must be a non empty dict')
+        pieces.append(b'STREAMS')
+        keys, values = zip(*streams.items())
+        pieces.extend(keys)
+        pieces.extend(values)
+        return self.execute_command('XREAD', *pieces)
+
+    def xreadgroup(self, groupname, consumername, streams, count=None,
+                   block=None, noack=False):
+        """
+        Read from a stream via a consumer group.
+        groupname: name of the consumer group.
+        consumername: name of the requesting consumer.
+        streams: a dict of stream names to stream IDs, where
+               IDs indicate the last ID already seen.
+        count: if set, only return this many items, beginning with the
+               earliest available.
+        block: number of milliseconds to wait, if nothing already present.
+        noack: do not add messages to the PEL
+        """
+        pieces = [b'GROUP', groupname, consumername]
+        if count is not None:
+            if not isinstance(count, int) or count < 1:
+                raise DataError("XREADGROUP count must be a positive integer")
+            pieces.append(b'COUNT')
+            pieces.append(str(count))
+        if block is not None:
+            if not isinstance(block, int) or block < 0:
+                raise DataError("XREADGROUP block must be a non-negative "
+                                "integer")
+            pieces.append(b'BLOCK')
+            pieces.append(str(block))
+        if noack:
+            pieces.append(b'NOACK')
+        if not isinstance(streams, dict) or len(streams) == 0:
+            raise DataError('XREADGROUP streams must be a non empty dict')
+        pieces.append(b'STREAMS')
+        pieces.extend(streams.keys())
+        pieces.extend(streams.values())
+        return self.execute_command('XREADGROUP', *pieces)
+
+    def xrevrange(self, name, max='+', min='-', count=None):
+        """
+        Read stream values within an interval, in reverse order.
+        name: name of the stream
+        start: first stream ID. defaults to '+',
+               meaning the latest available.
+        finish: last stream ID. defaults to '-',
+                meaning the earliest available.
+        count: if set, only return this many items, beginning with the
+               latest available.
+        """
+        pieces = [max, min]
+        if count is not None:
+            if not isinstance(count, int) or count < 1:
+                raise DataError('XREVRANGE count must be a positive integer')
+            pieces.append(b'COUNT')
+            pieces.append(str(count))
+
+        return self.execute_command('XREVRANGE', name, *pieces)
+
+    def xtrim(self, name, maxlen=None, approximate=True, minid=None,
+              limit=None):
+        """
+        Trims old messages from a stream.
+        name: name of the stream.
+        maxlen: truncate old stream messages beyond this size
+        approximate: actual stream length may be slightly more than maxlen
+        minin: the minimum id in the stream to query
+        limit: specifies the maximum number of entries to retrieve
+        """
+        pieces = []
+        if maxlen is not None and minid is not None:
+            raise DataError("Only one of ```maxlen``` or ```minid```",
+                            "may be specified")
+
+        if maxlen is not None:
+            pieces.append(b'MAXLEN')
+        if minid is not None:
+            pieces.append(b'MINID')
+        if approximate:
+            pieces.append(b'~')
+        if maxlen is not None:
+            pieces.append(maxlen)
+        if minid is not None:
+            pieces.append(minid)
+        if limit is not None:
+            pieces.append(b"LIMIT")
+            pieces.append(limit)
+
+        return self.execute_command('XTRIM', name, *pieces)
+
+    # SORTED SET COMMANDS
+    def zadd(self, name, mapping, nx=False, xx=False, ch=False, incr=False,
+             gt=None, lt=None):
+        """
+        Set any number of element-name, score pairs to the key ``name``. Pairs
+        are specified as a dict of element-names keys to score values.
+
+        ``nx`` forces ZADD to only create new elements and not to update
+        scores for elements that already exist.
+
+        ``xx`` forces ZADD to only update scores of elements that already
+        exist. New elements will not be added.
+
+        ``ch`` modifies the return value to be the numbers of elements changed.
+        Changed elements include new elements that were added and elements
+        whose scores changed.
+
+        ``incr`` modifies ZADD to behave like ZINCRBY. In this mode only a
+        single element/score pair can be specified and the score is the amount
+        the existing score will be incremented by. When using this mode the
+        return value of ZADD will be the new score of the element.
+
+        ``LT`` Only update existing elements if the new score is less than
+        the current score. This flag doesn't prevent adding new elements.
+
+        ``GT`` Only update existing elements if the new score is greater than
+        the current score. This flag doesn't prevent adding new elements.
+
+        The return value of ZADD varies based on the mode specified. With no
+        options, ZADD returns the number of new elements added to the sorted
+        set.
+
+        ``NX``, ``LT``, and ``GT`` are mutually exclusive options.
+        See: https://redis.io/commands/ZADD
+        """
+        if not mapping:
+            raise DataError("ZADD requires at least one element/score pair")
+        if nx and xx:
+            raise DataError("ZADD allows either 'nx' or 'xx', not both")
+        if incr and len(mapping) != 1:
+            raise DataError("ZADD option 'incr' only works when passing a "
+                            "single element/score pair")
+        if nx is True and (gt is not None or lt is not None):
+            raise DataError("Only one of 'nx', 'lt', or 'gr' may be defined.")
+
+        pieces = []
+        options = {}
+        if nx:
+            pieces.append(b'NX')
+        if xx:
+            pieces.append(b'XX')
+        if ch:
+            pieces.append(b'CH')
+        if incr:
+            pieces.append(b'INCR')
+            options['as_score'] = True
+        if gt:
+            pieces.append(b'GT')
+        if lt:
+            pieces.append(b'LT')
+        for pair in mapping.items():
+            pieces.append(pair[1])
+            pieces.append(pair[0])
+        return self.execute_command('ZADD', name, *pieces, **options)
+
+    def zcard(self, name):
+        "Return the number of elements in the sorted set ``name``"
+        return self.execute_command('ZCARD', name)
+
+    def zcount(self, name, min, max):
+        """
+        Returns the number of elements in the sorted set at key ``name`` with
+        a score between ``min`` and ``max``.
+        """
+        return self.execute_command('ZCOUNT', name, min, max)
+
+    def zdiff(self, keys, withscores=False):
+        """
+        Returns the difference between the first and all successive input
+        sorted sets provided in ``keys``.
+        """
+        pieces = [len(keys), *keys]
+        if withscores:
+            pieces.append("WITHSCORES")
+        return self.execute_command("ZDIFF", *pieces)
+
+    def zdiffstore(self, dest, keys):
+        """
+        Computes the difference between the first and all successive input
+        sorted sets provided in ``keys`` and stores the result in ``dest``.
+        """
+        pieces = [len(keys), *keys]
+        return self.execute_command("ZDIFFSTORE", dest, *pieces)
+
+    def zincrby(self, name, amount, value):
+        "Increment the score of ``value`` in sorted set ``name`` by ``amount``"
+        return self.execute_command('ZINCRBY', name, amount, value)
+
+    def zinter(self, keys, aggregate=None, withscores=False):
+        """
+        Return the intersect of multiple sorted sets specified by ``keys``.
+        With the ``aggregate`` option, it is possible to specify how the
+        results of the union are aggregated. This option defaults to SUM,
+        where the score of an element is summed across the inputs where it
+        exists. When this option is set to either MIN or MAX, the resulting
+        set will contain the minimum or maximum score of an element across
+        the inputs where it exists.
+        """
+        return self._zaggregate('ZINTER', None, keys, aggregate,
+                                withscores=withscores)
+
+    def zinterstore(self, dest, keys, aggregate=None):
+        """
+        Intersect multiple sorted sets specified by ``keys`` into a new
+        sorted set, ``dest``. Scores in the destination will be aggregated
+        based on the ``aggregate``. This option defaults to SUM, where the
+        score of an element is summed across the inputs where it exists.
+        When this option is set to either MIN or MAX, the resulting set will
+        contain the minimum or maximum score of an element across the inputs
+        where it exists.
+        """
+        return self._zaggregate('ZINTERSTORE', dest, keys, aggregate)
+
+    def zlexcount(self, name, min, max):
+        """
+        Return the number of items in the sorted set ``name`` between the
+        lexicographical range ``min`` and ``max``.
+        """
+        return self.execute_command('ZLEXCOUNT', name, min, max)
+
+    def zpopmax(self, name, count=None):
+        """
+        Remove and return up to ``count`` members with the highest scores
+        from the sorted set ``name``.
+        """
+        args = (count is not None) and [count] or []
+        options = {
+            'withscores': True
+        }
+        return self.execute_command('ZPOPMAX', name, *args, **options)
+
+    def zpopmin(self, name, count=None):
+        """
+        Remove and return up to ``count`` members with the lowest scores
+        from the sorted set ``name``.
+        """
+        args = (count is not None) and [count] or []
+        options = {
+            'withscores': True
+        }
+        return self.execute_command('ZPOPMIN', name, *args, **options)
+
+    def zrandmember(self, key, count=None, withscores=False):
+        """
+        Return a random element from the sorted set value stored at key.
+
+        ``count`` if the argument is positive, return an array of distinct
+        fields. If called with a negative count, the behavior changes and
+        the command is allowed to return the same field multiple times.
+        In this case, the number of returned fields is the absolute value
+        of the specified count.
+
+        ``withscores`` The optional WITHSCORES modifier changes the reply so it
+        includes the respective scores of the randomly selected elements from
+        the sorted set.
+        """
+        params = []
+        if count is not None:
+            params.append(count)
+        if withscores:
+            params.append("WITHSCORES")
+
+        return self.execute_command("ZRANDMEMBER", key, *params)
+
+    def bzpopmax(self, keys, timeout=0):
+        """
+        ZPOPMAX a value off of the first non-empty sorted set
+        named in the ``keys`` list.
+
+        If none of the sorted sets in ``keys`` has a value to ZPOPMAX,
+        then block for ``timeout`` seconds, or until a member gets added
+        to one of the sorted sets.
+
+        If timeout is 0, then block indefinitely.
+        """
+        if timeout is None:
+            timeout = 0
+        keys = list_or_args(keys, None)
+        keys.append(timeout)
+        return self.execute_command('BZPOPMAX', *keys)
+
+    def bzpopmin(self, keys, timeout=0):
+        """
+        ZPOPMIN a value off of the first non-empty sorted set
+        named in the ``keys`` list.
+
+        If none of the sorted sets in ``keys`` has a value to ZPOPMIN,
+        then block for ``timeout`` seconds, or until a member gets added
+        to one of the sorted sets.
+
+        If timeout is 0, then block indefinitely.
+        """
+        if timeout is None:
+            timeout = 0
+        keys = list_or_args(keys, None)
+        keys.append(timeout)
+        return self.execute_command('BZPOPMIN', *keys)
+
+    def zrange(self, name, start, end, desc=False, withscores=False,
+               score_cast_func=float):
+        """
+        Return a range of values from sorted set ``name`` between
+        ``start`` and ``end`` sorted in ascending order.
+
+        ``start`` and ``end`` can be negative, indicating the end of the range.
+
+        ``desc`` a boolean indicating whether to sort the results descendingly
+
+        ``withscores`` indicates to return the scores along with the values.
+        The return type is a list of (value, score) pairs
+
+        ``score_cast_func`` a callable used to cast the score return value
+        """
+        if desc:
+            return self.zrevrange(name, start, end, withscores,
+                                  score_cast_func)
+        pieces = ['ZRANGE', name, start, end]
+        if withscores:
+            pieces.append(b'WITHSCORES')
+        options = {
+            'withscores': withscores,
+            'score_cast_func': score_cast_func
+        }
+        return self.execute_command(*pieces, **options)
+
+    def zrangestore(self, dest, name, start, end):
+        """
+        Stores in ``dest`` the result of a range of values from sorted set
+        ``name`` between ``start`` and ``end`` sorted in ascending order.
+
+        ``start`` and ``end`` can be negative, indicating the end of the range.
+        """
+        return self.execute_command('ZRANGESTORE', dest, name, start, end)
+
+    def zrangebylex(self, name, min, max, start=None, num=None):
+        """
+        Return the lexicographical range of values from sorted set ``name``
+        between ``min`` and ``max``.
+
+        If ``start`` and ``num`` are specified, then return a slice of the
+        range.
+        """
+        if (start is not None and num is None) or \
+                (num is not None and start is None):
+            raise DataError("``start`` and ``num`` must both be specified")
+        pieces = ['ZRANGEBYLEX', name, min, max]
+        if start is not None and num is not None:
+            pieces.extend([b'LIMIT', start, num])
+        return self.execute_command(*pieces)
+
+    def zrevrangebylex(self, name, max, min, start=None, num=None):
+        """
+        Return the reversed lexicographical range of values from sorted set
+        ``name`` between ``max`` and ``min``.
+
+        If ``start`` and ``num`` are specified, then return a slice of the
+        range.
+        """
+        if (start is not None and num is None) or \
+                (num is not None and start is None):
+            raise DataError("``start`` and ``num`` must both be specified")
+        pieces = ['ZREVRANGEBYLEX', name, max, min]
+        if start is not None and num is not None:
+            pieces.extend([b'LIMIT', start, num])
+        return self.execute_command(*pieces)
+
+    def zrangebyscore(self, name, min, max, start=None, num=None,
+                      withscores=False, score_cast_func=float):
+        """
+        Return a range of values from the sorted set ``name`` with scores
+        between ``min`` and ``max``.
+
+        If ``start`` and ``num`` are specified, then return a slice
+        of the range.
+
+        ``withscores`` indicates to return the scores along with the values.
+        The return type is a list of (value, score) pairs
+
+        `score_cast_func`` a callable used to cast the score return value
+        """
+        if (start is not None and num is None) or \
+                (num is not None and start is None):
+            raise DataError("``start`` and ``num`` must both be specified")
+        pieces = ['ZRANGEBYSCORE', name, min, max]
+        if start is not None and num is not None:
+            pieces.extend([b'LIMIT', start, num])
+        if withscores:
+            pieces.append(b'WITHSCORES')
+        options = {
+            'withscores': withscores,
+            'score_cast_func': score_cast_func
+        }
+        return self.execute_command(*pieces, **options)
+
+    def zrank(self, name, value):
+        """
+        Returns a 0-based value indicating the rank of ``value`` in sorted set
+        ``name``
+        """
+        return self.execute_command('ZRANK', name, value)
+
+    def zrem(self, name, *values):
+        "Remove member ``values`` from sorted set ``name``"
+        return self.execute_command('ZREM', name, *values)
+
+    def zremrangebylex(self, name, min, max):
+        """
+        Remove all elements in the sorted set ``name`` between the
+        lexicographical range specified by ``min`` and ``max``.
+
+        Returns the number of elements removed.
+        """
+        return self.execute_command('ZREMRANGEBYLEX', name, min, max)
+
+    def zremrangebyrank(self, name, min, max):
+        """
+        Remove all elements in the sorted set ``name`` with ranks between
+        ``min`` and ``max``. Values are 0-based, ordered from smallest score
+        to largest. Values can be negative indicating the highest scores.
+        Returns the number of elements removed
+        """
+        return self.execute_command('ZREMRANGEBYRANK', name, min, max)
+
+    def zremrangebyscore(self, name, min, max):
+        """
+        Remove all elements in the sorted set ``name`` with scores
+        between ``min`` and ``max``. Returns the number of elements removed.
+        """
+        return self.execute_command('ZREMRANGEBYSCORE', name, min, max)
+
+    def zrevrange(self, name, start, end, withscores=False,
+                  score_cast_func=float):
+        """
+        Return a range of values from sorted set ``name`` between
+        ``start`` and ``end`` sorted in descending order.
+
+        ``start`` and ``end`` can be negative, indicating the end of the range.
+
+        ``withscores`` indicates to return the scores along with the values
+        The return type is a list of (value, score) pairs
+
+        ``score_cast_func`` a callable used to cast the score return value
+        """
+        pieces = ['ZREVRANGE', name, start, end]
+        if withscores:
+            pieces.append(b'WITHSCORES')
+        options = {
+            'withscores': withscores,
+            'score_cast_func': score_cast_func
+        }
+        return self.execute_command(*pieces, **options)
+
+    def zrevrangebyscore(self, name, max, min, start=None, num=None,
+                         withscores=False, score_cast_func=float):
+        """
+        Return a range of values from the sorted set ``name`` with scores
+        between ``min`` and ``max`` in descending order.
+
+        If ``start`` and ``num`` are specified, then return a slice
+        of the range.
+
+        ``withscores`` indicates to return the scores along with the values.
+        The return type is a list of (value, score) pairs
+
+        ``score_cast_func`` a callable used to cast the score return value
+        """
+        if (start is not None and num is None) or \
+                (num is not None and start is None):
+            raise DataError("``start`` and ``num`` must both be specified")
+        pieces = ['ZREVRANGEBYSCORE', name, max, min]
+        if start is not None and num is not None:
+            pieces.extend([b'LIMIT', start, num])
+        if withscores:
+            pieces.append(b'WITHSCORES')
+        options = {
+            'withscores': withscores,
+            'score_cast_func': score_cast_func
+        }
+        return self.execute_command(*pieces, **options)
+
+    def zrevrank(self, name, value):
+        """
+        Returns a 0-based value indicating the descending rank of
+        ``value`` in sorted set ``name``
+        """
+        return self.execute_command('ZREVRANK', name, value)
+
+    def zscore(self, name, value):
+        "Return the score of element ``value`` in sorted set ``name``"
+        return self.execute_command('ZSCORE', name, value)
+
+    def zunion(self, keys, aggregate=None, withscores=False):
+        """
+        Return the union of multiple sorted sets specified by ``keys``.
+        ``keys`` can be provided as dictionary of keys and their weights.
+        Scores will be aggregated based on the ``aggregate``, or SUM if
+        none is provided.
+        """
+        return self._zaggregate('ZUNION', None, keys, aggregate,
+                                withscores=withscores)
+
+    def zunionstore(self, dest, keys, aggregate=None):
+        """
+        Union multiple sorted sets specified by ``keys`` into
+        a new sorted set, ``dest``. Scores in the destination will be
+        aggregated based on the ``aggregate``, or SUM if none is provided.
+        """
+        return self._zaggregate('ZUNIONSTORE', dest, keys, aggregate)
+
+    def _zaggregate(self, command, dest, keys, aggregate=None,
+                    **options):
+        pieces = [command]
+        if dest is not None:
+            pieces.append(dest)
+        pieces.append(len(keys))
+        if isinstance(keys, dict):
+            keys, weights = keys.keys(), keys.values()
+        else:
+            weights = None
+        pieces.extend(keys)
+        if weights:
+            pieces.append(b'WEIGHTS')
+            pieces.extend(weights)
+        if aggregate:
+            if aggregate.upper() in ['SUM', 'MIN', 'MAX']:
+                pieces.append(b'AGGREGATE')
+                pieces.append(aggregate)
+            else:
+                raise DataError("aggregate can be sum, min or max.")
+        if options.get('withscores', False):
+            pieces.append(b'WITHSCORES')
+        return self.execute_command(*pieces, **options)
+
+    # HYPERLOGLOG COMMANDS
+    def pfadd(self, name, *values):
+        "Adds the specified elements to the specified HyperLogLog."
+        return self.execute_command('PFADD', name, *values)
+
+    def pfcount(self, *sources):
+        """
+        Return the approximated cardinality of
+        the set observed by the HyperLogLog at key(s).
+        """
+        return self.execute_command('PFCOUNT', *sources)
+
+    def pfmerge(self, dest, *sources):
+        "Merge N different HyperLogLogs into a single one."
+        return self.execute_command('PFMERGE', dest, *sources)
+
+    # HASH COMMANDS
+    def hdel(self, name, *keys):
+        "Delete ``keys`` from hash ``name``"
+        return self.execute_command('HDEL', name, *keys)
+
+    def hexists(self, name, key):
+        "Returns a boolean indicating if ``key`` exists within hash ``name``"
+        return self.execute_command('HEXISTS', name, key)
+
+    def hget(self, name, key):
+        "Return the value of ``key`` within the hash ``name``"
+        return self.execute_command('HGET', name, key)
+
+    def hgetall(self, name):
+        "Return a Python dict of the hash's name/value pairs"
+        return self.execute_command('HGETALL', name)
+
+    def hincrby(self, name, key, amount=1):
+        "Increment the value of ``key`` in hash ``name`` by ``amount``"
+        return self.execute_command('HINCRBY', name, key, amount)
+
+    def hincrbyfloat(self, name, key, amount=1.0):
+        """
+        Increment the value of ``key`` in hash ``name`` by floating ``amount``
+        """
+        return self.execute_command('HINCRBYFLOAT', name, key, amount)
+
+    def hkeys(self, name):
+        "Return the list of keys within hash ``name``"
+        return self.execute_command('HKEYS', name)
+
+    def hlen(self, name):
+        "Return the number of elements in hash ``name``"
+        return self.execute_command('HLEN', name)
+
+    def hset(self, name, key=None, value=None, mapping=None):
+        """
+        Set ``key`` to ``value`` within hash ``name``,
+        ``mapping`` accepts a dict of key/value pairs that will be
+        added to hash ``name``.
+        Returns the number of fields that were added.
+        """
+        if key is None and not mapping:
+            raise DataError("'hset' with no key value pairs")
+        items = []
+        if key is not None:
+            items.extend((key, value))
+        if mapping:
+            for pair in mapping.items():
+                items.extend(pair)
+
+        return self.execute_command('HSET', name, *items)
+
+    def hsetnx(self, name, key, value):
+        """
+        Set ``key`` to ``value`` within hash ``name`` if ``key`` does not
+        exist.  Returns 1 if HSETNX created a field, otherwise 0.
+        """
+        return self.execute_command('HSETNX', name, key, value)
+
+    def hmset(self, name, mapping):
+        """
+        Set key to value within hash ``name`` for each corresponding
+        key and value from the ``mapping`` dict.
+        """
+        warnings.warn(
+            '%s.hmset() is deprecated. Use %s.hset() instead.'
+            % (self.__class__.__name__, self.__class__.__name__),
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        if not mapping:
+            raise DataError("'hmset' with 'mapping' of length 0")
+        items = []
+        for pair in mapping.items():
+            items.extend(pair)
+        return self.execute_command('HMSET', name, *items)
+
+    def hmget(self, name, keys, *args):
+        "Returns a list of values ordered identically to ``keys``"
+        args = list_or_args(keys, args)
+        return self.execute_command('HMGET', name, *args)
+
+    def hvals(self, name):
+        "Return the list of values within hash ``name``"
+        return self.execute_command('HVALS', name)
+
+    def hstrlen(self, name, key):
+        """
+        Return the number of bytes stored in the value of ``key``
+        within hash ``name``
+        """
+        return self.execute_command('HSTRLEN', name, key)
+
+    def publish(self, channel, message):
+        """
+        Publish ``message`` on ``channel``.
+        Returns the number of subscribers the message was delivered to.
+        """
+        return self.execute_command('PUBLISH', channel, message)
+
+    def pubsub_channels(self, pattern='*'):
+        """
+        Return a list of channels that have at least one subscriber
+        """
+        return self.execute_command('PUBSUB CHANNELS', pattern)
+
+    def pubsub_numpat(self):
+        """
+        Returns the number of subscriptions to patterns
+        """
+        return self.execute_command('PUBSUB NUMPAT')
+
+    def pubsub_numsub(self, *args):
+        """
+        Return a list of (channel, number of subscribers) tuples
+        for each channel given in ``*args``
+        """
+        return self.execute_command('PUBSUB NUMSUB', *args)
+
+    def cluster(self, cluster_arg, *args):
+        return self.execute_command('CLUSTER %s' % cluster_arg.upper(), *args)
+
+    def eval(self, script, numkeys, *keys_and_args):
+        """
+        Execute the Lua ``script``, specifying the ``numkeys`` the script
+        will touch and the key names and argument values in ``keys_and_args``.
+        Returns the result of the script.
+
+        In practice, use the object returned by ``register_script``. This
+        function exists purely for Redis API completion.
+        """
+        return self.execute_command('EVAL', script, numkeys, *keys_and_args)
+
+    def evalsha(self, sha, numkeys, *keys_and_args):
+        """
+        Use the ``sha`` to execute a Lua script already registered via EVAL
+        or SCRIPT LOAD. Specify the ``numkeys`` the script will touch and the
+        key names and argument values in ``keys_and_args``. Returns the result
+        of the script.
+
+        In practice, use the object returned by ``register_script``. This
+        function exists purely for Redis API completion.
+        """
+        return self.execute_command('EVALSHA', sha, numkeys, *keys_and_args)
+
+    def script_exists(self, *args):
+        """
+        Check if a script exists in the script cache by specifying the SHAs of
+        each script as ``args``. Returns a list of boolean values indicating if
+        if each already script exists in the cache.
+        """
+        return self.execute_command('SCRIPT EXISTS', *args)
+
+    def script_flush(self):
+        "Flush all scripts from the script cache"
+        return self.execute_command('SCRIPT FLUSH')
+
+    def script_kill(self):
+        "Kill the currently executing Lua script"
+        return self.execute_command('SCRIPT KILL')
+
+    def script_load(self, script):
+        "Load a Lua ``script`` into the script cache. Returns the SHA."
+        return self.execute_command('SCRIPT LOAD', script)
+
+    def register_script(self, script):
+        """
+        Register a Lua ``script`` specifying the ``keys`` it will touch.
+        Returns a Script object that is callable and hides the complexity of
+        deal with scripts, keys, and shas. This is the preferred way to work
+        with Lua scripts.
+        """
+        return Script(self, script)
+
+    # GEO COMMANDS
+    def geoadd(self, name, *values):
+        """
+        Add the specified geospatial items to the specified key identified
+        by the ``name`` argument. The Geospatial items are given as ordered
+        members of the ``values`` argument, each item or place is formed by
+        the triad longitude, latitude and name.
+        """
+        if len(values) % 3 != 0:
+            raise DataError("GEOADD requires places with lon, lat and name"
+                            " values")
+        return self.execute_command('GEOADD', name, *values)
+
+    def geodist(self, name, place1, place2, unit=None):
+        """
+        Return the distance between ``place1`` and ``place2`` members of the
+        ``name`` key.
+        The units must be one of the following : m, km mi, ft. By default
+        meters are used.
+        """
+        pieces = [name, place1, place2]
+        if unit and unit not in ('m', 'km', 'mi', 'ft'):
+            raise DataError("GEODIST invalid unit")
+        elif unit:
+            pieces.append(unit)
+        return self.execute_command('GEODIST', *pieces)
+
+    def geohash(self, name, *values):
+        """
+        Return the geo hash string for each item of ``values`` members of
+        the specified key identified by the ``name`` argument.
+        """
+        return self.execute_command('GEOHASH', name, *values)
+
+    def geopos(self, name, *values):
+        """
+        Return the positions of each item of ``values`` as members of
+        the specified key identified by the ``name`` argument. Each position
+        is represented by the pairs lon and lat.
+        """
+        return self.execute_command('GEOPOS', name, *values)
+
+    def georadius(self, name, longitude, latitude, radius, unit=None,
+                  withdist=False, withcoord=False, withhash=False, count=None,
+                  sort=None, store=None, store_dist=None):
+        """
+        Return the members of the specified key identified by the
+        ``name`` argument which are within the borders of the area specified
+        with the ``latitude`` and ``longitude`` location and the maximum
+        distance from the center specified by the ``radius`` value.
+
+        The units must be one of the following : m, km mi, ft. By default
+
+        ``withdist`` indicates to return the distances of each place.
+
+        ``withcoord`` indicates to return the latitude and longitude of
+        each place.
+
+        ``withhash`` indicates to return the geohash string of each place.
+
+        ``count`` indicates to return the number of elements up to N.
+
+        ``sort`` indicates to return the places in a sorted way, ASC for
+        nearest to fairest and DESC for fairest to nearest.
+
+        ``store`` indicates to save the places names in a sorted set named
+        with a specific key, each element of the destination sorted set is
+        populated with the score got from the original geo sorted set.
+
+        ``store_dist`` indicates to save the places names in a sorted set
+        named with a specific key, instead of ``store`` the sorted set
+        destination score is set with the distance.
+        """
+        return self._georadiusgeneric('GEORADIUS',
+                                      name, longitude, latitude, radius,
+                                      unit=unit, withdist=withdist,
+                                      withcoord=withcoord, withhash=withhash,
+                                      count=count, sort=sort, store=store,
+                                      store_dist=store_dist)
+
+    def georadiusbymember(self, name, member, radius, unit=None,
+                          withdist=False, withcoord=False, withhash=False,
+                          count=None, sort=None, store=None, store_dist=None):
+        """
+        This command is exactly like ``georadius`` with the sole difference
+        that instead of taking, as the center of the area to query, a longitude
+        and latitude value, it takes the name of a member already existing
+        inside the geospatial index represented by the sorted set.
+        """
+        return self._georadiusgeneric('GEORADIUSBYMEMBER',
+                                      name, member, radius, unit=unit,
+                                      withdist=withdist, withcoord=withcoord,
+                                      withhash=withhash, count=count,
+                                      sort=sort, store=store,
+                                      store_dist=store_dist)
+
+    def _georadiusgeneric(self, command, *args, **kwargs):
+        pieces = list(args)
+        if kwargs['unit'] and kwargs['unit'] not in ('m', 'km', 'mi', 'ft'):
+            raise DataError("GEORADIUS invalid unit")
+        elif kwargs['unit']:
+            pieces.append(kwargs['unit'])
+        else:
+            pieces.append('m',)
+
+        for arg_name, byte_repr in (
+                ('withdist', b'WITHDIST'),
+                ('withcoord', b'WITHCOORD'),
+                ('withhash', b'WITHHASH')):
+            if kwargs[arg_name]:
+                pieces.append(byte_repr)
+
+        if kwargs['count']:
+            pieces.extend([b'COUNT', kwargs['count']])
+
+        if kwargs['sort']:
+            if kwargs['sort'] == 'ASC':
+                pieces.append(b'ASC')
+            elif kwargs['sort'] == 'DESC':
+                pieces.append(b'DESC')
+            else:
+                raise DataError("GEORADIUS invalid sort")
+
+        if kwargs['store'] and kwargs['store_dist']:
+            raise DataError("GEORADIUS store and store_dist cant be set"
+                            " together")
+
+        if kwargs['store']:
+            pieces.extend([b'STORE', kwargs['store']])
+
+        if kwargs['store_dist']:
+            pieces.extend([b'STOREDIST', kwargs['store_dist']])
+
+        return self.execute_command(command, *pieces, **kwargs)
+
+    # MODULE COMMANDS
+    def module_load(self, path):
+        """
+        Loads the module from ``path``.
+        Raises ``ModuleError`` if a module is not found at ``path``.
+        """
+        return self.execute_command('MODULE LOAD', path)
+
+    def module_unload(self, name):
+        """
+        Unloads the module ``name``.
+        Raises ``ModuleError`` if ``name`` is not in loaded modules.
+        """
+        return self.execute_command('MODULE UNLOAD', name)
+
+    def module_list(self):
+        """
+        Returns a list of dictionaries containing the name and version of
+        all loaded modules.
+        """
+        return self.execute_command('MODULE LIST')
+
+
+class Script:
+    "An executable Lua script object returned by ``register_script``"
+
+    def __init__(self, registered_client, script):
+        self.registered_client = registered_client
+        self.script = script
+        # Precalculate and store the SHA1 hex digest of the script.
+
+        if isinstance(script, str):
+            # We need the encoding from the client in order to generate an
+            # accurate byte representation of the script
+            encoder = registered_client.connection_pool.get_encoder()
+            script = encoder.encode(script)
+        self.sha = hashlib.sha1(script).hexdigest()
+
+    def __call__(self, keys=[], args=[], client=None):
+        "Execute the script, passing any required ``args``"
+        if client is None:
+            client = self.registered_client
+        args = tuple(keys) + tuple(args)
+        # make sure the Redis server knows about the script
+        from redis.client import Pipeline
+        if isinstance(client, Pipeline):
+            # Make sure the pipeline can register the script before executing.
+            client.scripts.add(self)
+        try:
+            return client.evalsha(self.sha, len(keys), *args)
+        except NoScriptError:
+            # Maybe the client is pointed to a different server than the client
+            # that created this instance?
+            # Overwrite the sha just in case there was a discrepancy.
+            self.sha = client.script_load(self.script)
+            return client.evalsha(self.sha, len(keys), *args)
+
+
+class BitFieldOperation:
+    """
+    Command builder for BITFIELD commands.
+    """
+    def __init__(self, client, key, default_overflow=None):
+        self.client = client
+        self.key = key
+        self._default_overflow = default_overflow
+        self.reset()
+
+    def reset(self):
+        """
+        Reset the state of the instance to when it was constructed
+        """
+        self.operations = []
+        self._last_overflow = 'WRAP'
+        self.overflow(self._default_overflow or self._last_overflow)
+
+    def overflow(self, overflow):
+        """
+        Update the overflow algorithm of successive INCRBY operations
+        :param overflow: Overflow algorithm, one of WRAP, SAT, FAIL. See the
+            Redis docs for descriptions of these algorithmsself.
+        :returns: a :py:class:`BitFieldOperation` instance.
+        """
+        overflow = overflow.upper()
+        if overflow != self._last_overflow:
+            self._last_overflow = overflow
+            self.operations.append(('OVERFLOW', overflow))
+        return self
+
+    def incrby(self, fmt, offset, increment, overflow=None):
+        """
+        Increment a bitfield by a given amount.
+        :param fmt: format-string for the bitfield being updated, e.g. 'u8'
+            for an unsigned 8-bit integer.
+        :param offset: offset (in number of bits). If prefixed with a
+            '#', this is an offset multiplier, e.g. given the arguments
+            fmt='u8', offset='#2', the offset will be 16.
+        :param int increment: value to increment the bitfield by.
+        :param str overflow: overflow algorithm. Defaults to WRAP, but other
+            acceptable values are SAT and FAIL. See the Redis docs for
+            descriptions of these algorithms.
+        :returns: a :py:class:`BitFieldOperation` instance.
+        """
+        if overflow is not None:
+            self.overflow(overflow)
+
+        self.operations.append(('INCRBY', fmt, offset, increment))
+        return self
+
+    def get(self, fmt, offset):
+        """
+        Get the value of a given bitfield.
+        :param fmt: format-string for the bitfield being read, e.g. 'u8' for
+            an unsigned 8-bit integer.
+        :param offset: offset (in number of bits). If prefixed with a
+            '#', this is an offset multiplier, e.g. given the arguments
+            fmt='u8', offset='#2', the offset will be 16.
+        :returns: a :py:class:`BitFieldOperation` instance.
+        """
+        self.operations.append(('GET', fmt, offset))
+        return self
+
+    def set(self, fmt, offset, value):
+        """
+        Set the value of a given bitfield.
+        :param fmt: format-string for the bitfield being read, e.g. 'u8' for
+            an unsigned 8-bit integer.
+        :param offset: offset (in number of bits). If prefixed with a
+            '#', this is an offset multiplier, e.g. given the arguments
+            fmt='u8', offset='#2', the offset will be 16.
+        :param int value: value to set at the given position.
+        :returns: a :py:class:`BitFieldOperation` instance.
+        """
+        self.operations.append(('SET', fmt, offset, value))
+        return self
+
+    @property
+    def command(self):
+        cmd = ['BITFIELD', self.key]
+        for ops in self.operations:
+            cmd.extend(ops)
+        return cmd
+
+    def execute(self):
+        """
+        Execute the operation(s) in a single BITFIELD command. The return value
+        is a list of values corresponding to each operation. If the client
+        used to create this instance was a pipeline, the list of values
+        will be present within the pipeline's execute.
+        """
+        command = self.command
+        self.reset()
+        return self.client.execute_command(*command)
+
+
+class SentinalCommands:
+    """
+    A class containing the commands specific to redis sentinal. This class is
+    to be used as a mixin.
+    """
+
+    def sentinel(self, *args):
+        "Redis Sentinel's SENTINEL command."
+        warnings.warn(
+            DeprecationWarning('Use the individual sentinel_* methods'))
+
+    def sentinel_get_master_addr_by_name(self, service_name):
+        "Returns a (host, port) pair for the given ``service_name``"
+        return self.execute_command('SENTINEL GET-MASTER-ADDR-BY-NAME',
+                                    service_name)
+
+    def sentinel_master(self, service_name):
+        "Returns a dictionary containing the specified masters state."
+        return self.execute_command('SENTINEL MASTER', service_name)
+
+    def sentinel_masters(self):
+        "Returns a list of dictionaries containing each master's state."
+        return self.execute_command('SENTINEL MASTERS')
+
+    def sentinel_monitor(self, name, ip, port, quorum):
+        "Add a new master to Sentinel to be monitored"
+        return self.execute_command('SENTINEL MONITOR', name, ip, port, quorum)
+
+    def sentinel_remove(self, name):
+        "Remove a master from Sentinel's monitoring"
+        return self.execute_command('SENTINEL REMOVE', name)
+
+    def sentinel_sentinels(self, service_name):
+        "Returns a list of sentinels for ``service_name``"
+        return self.execute_command('SENTINEL SENTINELS', service_name)
+
+    def sentinel_set(self, name, option, value):
+        "Set Sentinel monitoring parameters for a given master"
+        return self.execute_command('SENTINEL SET', name, option, value)
+
+    def sentinel_slaves(self, service_name):
+        "Returns a list of slaves for ``service_name``"
+        return self.execute_command('SENTINEL SLAVES', service_name)
diff --git a/redis/sentinel.py b/redis/sentinel.py
index f39e2e7d1a..d3213488c1 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -2,6 +2,7 @@
 import weakref
 
 from redis.client import Redis
+from redis.commands import SentinalCommands
 from redis.connection import ConnectionPool, Connection
 from redis.exceptions import (ConnectionError, ResponseError, ReadOnlyError,
                               TimeoutError)
@@ -132,7 +133,7 @@ def rotate_slaves(self):
         raise SlaveNotFoundError('No slave found for %r' % (self.service_name))
 
 
-class Sentinel:
+class Sentinel(SentinalCommands, object):
     """
     Redis Sentinel cluster client
 

From b96af52e012bc002df97c4a82a5e4ad389cea3f3 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 18 Aug 2021 11:30:28 +0300
Subject: [PATCH 0135/1164] Updating CHANGES to list most recent changes
 (#1544)

---
 CHANGES | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)

diff --git a/CHANGES b/CHANGES
index 4c2ba40f7a..9a1df64432 100644
--- a/CHANGES
+++ b/CHANGES
@@ -12,6 +12,56 @@
       @2014BDuck. #1307
     * Added support for ABSTTL option of the RESTORE command available in
       Redis 5.0. Thanks @charettes. #1423
+    * Migrated commands to a mixin. Thanks @chayim. #1534
+    * Added support for ZUNION, available in Redis 6.2.0. Thanks
+      @AvitalFineRedis. #1522
+    * Added support for CLIENT LIST with ID, available in Redis 6.2.0.
+      Thanks @chayim. #1505
+    * Added support for MINID and LIMIT with xtrim, available in Reds 6.2.0.
+      Thanks @chayim. #1508
+    * Implemented LMOVE and BLMOVE commands, available in Redis 6.2.0.
+      Thanks @chayim. #1504
+    * Added GET argument to SET command, available in Redis 6.2.0.
+      Thanks @2014BDuck. #1412
+    * Documentation fixes. Thanks @enjoy-binbin @jonher937. #1496 #1532
+    * Added support for XAUTOCLAIM, available in Redis 6.2.0.
+      Thanks @AvitalFineRedis. #1529
+    * Added IDLE support for XPENDING, available in Redis 6.2.0.
+      Thanks @AvitalFineRedis. #1523
+    * Add a count parameter to lpop/rpop, available in Redis 6.2.0.
+      Thanks @wavenator. #1487
+    * Added a (pypy) trove classifier for Python 3.9.
+      Thanks @D3X. #1535
+    * Added ZINTER support, available in Redis 6.2.0.
+      Thanks @AvitalFineRedis. #1520
+    * Added ZINTER support, available in Redis 6.2.0.
+      Thanks @AvitalFineRedis. #1520
+    * Added ZDIFF and ZDIFFSTORE support, available in Redis 6.2.0.
+      Thanks @AvitalFineRedis. #1518
+    * Added ZRANGESTORE support, available in Redis 6.2.0.
+      Thanks @AvitalFineRedis. #1521
+    * Added LT and GT support for ZADD, available in Redis 6.2.0.
+      Thanks @chayim. #1509
+    * Added ZRANDMEMBER support, available in Redis 6.2.0.
+      Thanks @AvitalFineRedis. #1519
+    * Added GETDEL support, available in Redis 6.2.0.
+      Thanks @AvitalFineRedis. #1514
+    * Added CLIENT KILL laddr filter, available in Redis 6.2.0.
+      Thanks @chayim. #1506
+    * Added CLIENT UNPAUSE, available in Redis 6.2.0.
+      Thanks @chayim. #1512
+    * Added NOMKSTREAM support for XADD, available in Redis 6.2.0.
+      Thanks @chayim. #1507
+    * Added HRANDFIELD support, available in Redis 6.2.0.
+      Thanks @AvitalFineRedis. #1513
+    * Added CLIENT INFO support, available in Redis 6.2.0.
+      Thanks @AvitalFineRedis. #1517
+    * Added GETEX support, available in Redis 6.2.0.
+      Thanks @AvitalFineRedis. #1515
+    * Added support for COPY command, available in Redis 6.2.0.
+      Thanks @malinaa96. #1492
+    * Added support for COPY command, available in Redis 6.2.0.
+      Thanks @malinaa96. #1492
 * 3.5.3 (June 1, 2020)
     * Restore try/except clauses to __del__ methods. These will be removed
       in 4.0 when more explicit resource management if enforced. #1339

From e19a76c58f2a998d86e51c5a2a0f1db37563efce Mon Sep 17 00:00:00 2001
From: nbraun-amazon <85549956+nbraun-amazon@users.noreply.github.com>
Date: Wed, 18 Aug 2021 12:06:09 +0300
Subject: [PATCH 0136/1164] Add retry mechanism with backoff (#1494)

---
 redis/backoff.py    | 105 ++++++++++++++++++++++++++
 redis/client.py     | 177 +++++++++++++++++++++++++++-----------------
 redis/connection.py |  55 +++++++++-----
 redis/retry.py      |  40 ++++++++++
 tests/conftest.py   |   3 +
 tests/test_retry.py |  66 +++++++++++++++++
 6 files changed, 360 insertions(+), 86 deletions(-)
 create mode 100644 redis/backoff.py
 create mode 100644 redis/retry.py
 create mode 100644 tests/test_retry.py

diff --git a/redis/backoff.py b/redis/backoff.py
new file mode 100644
index 0000000000..9162778cc0
--- /dev/null
+++ b/redis/backoff.py
@@ -0,0 +1,105 @@
+from abc import ABC, abstractmethod
+import random
+
+
+class AbstractBackoff(ABC):
+    """Backoff interface"""
+
+    def reset(self):
+        """
+        Reset internal state before an operation.
+        `reset` is called once at the beginning of
+        every call to `Retry.call_with_retry`
+        """
+        pass
+
+    @abstractmethod
+    def compute(self, failures):
+        """Compute backoff in seconds upon failure"""
+        pass
+
+
+class ConstantBackoff(AbstractBackoff):
+    """Constant backoff upon failure"""
+
+    def __init__(self, backoff):
+        """`backoff`: backoff time in seconds"""
+        self._backoff = backoff
+
+    def compute(self, failures):
+        return self._backoff
+
+
+class NoBackoff(ConstantBackoff):
+    """No backoff upon failure"""
+
+    def __init__(self):
+        super().__init__(0)
+
+
+class ExponentialBackoff(AbstractBackoff):
+    """Exponential backoff upon failure"""
+
+    def __init__(self, cap, base):
+        """
+        `cap`: maximum backoff time in seconds
+        `base`: base backoff time in seconds
+        """
+        self._cap = cap
+        self._base = base
+
+    def compute(self, failures):
+        return min(self._cap, self._base * 2 ** failures)
+
+
+class FullJitterBackoff(AbstractBackoff):
+    """Full jitter backoff upon failure"""
+
+    def __init__(self, cap, base):
+        """
+        `cap`: maximum backoff time in seconds
+        `base`: base backoff time in seconds
+        """
+        self._cap = cap
+        self._base = base
+
+    def compute(self, failures):
+        return random.uniform(0, min(self._cap, self._base * 2 ** failures))
+
+
+class EqualJitterBackoff(AbstractBackoff):
+    """Equal jitter backoff upon failure"""
+
+    def __init__(self, cap, base):
+        """
+        `cap`: maximum backoff time in seconds
+        `base`: base backoff time in seconds
+        """
+        self._cap = cap
+        self._base = base
+
+    def compute(self, failures):
+        temp = min(self._cap, self._base * 2 ** failures) / 2
+        return temp + random.uniform(0, temp)
+
+
+class DecorrelatedJitterBackoff(AbstractBackoff):
+    """Decorrelated jitter backoff upon failure"""
+
+    def __init__(self, cap, base):
+        """
+        `cap`: maximum backoff time in seconds
+        `base`: base backoff time in seconds
+        """
+        self._cap = cap
+        self._base = base
+        self._previous_backoff = 0
+
+    def reset(self):
+        self._previous_backoff = 0
+
+    def compute(self, failures):
+        max_backoff = max(self._base, self._previous_backoff * 3)
+        temp = random.uniform(self._base, max_backoff)
+        self._previous_backoff = min(self._cap, temp)
+        return self._previous_backoff
diff --git a/redis/client.py b/redis/client.py
index 741c2d0226..ab9246d160 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1,4 +1,5 @@
 from itertools import chain
+import copy
 import datetime
 import hashlib
 import re
@@ -758,7 +759,13 @@ def __init__(self, host='localhost', port=6379,
                  ssl_cert_reqs='required', ssl_ca_certs=None,
                  ssl_check_hostname=False,
                  max_connections=None, single_connection_client=False,
-                 health_check_interval=0, client_name=None, username=None):
+                 health_check_interval=0, client_name=None, username=None,
+                 retry=None):
+        """
+        Initialize a new Redis client.
+        To specify a retry policy, first set `retry_on_timeout` to `True`
+        then set `retry` to a valid `Retry` object
+        """
         if not connection_pool:
             if charset is not None:
                 warnings.warn(DeprecationWarning(
@@ -778,6 +785,7 @@ def __init__(self, host='localhost', port=6379,
                 'encoding_errors': encoding_errors,
                 'decode_responses': decode_responses,
                 'retry_on_timeout': retry_on_timeout,
+                'retry': copy.deepcopy(retry),
                 'max_connections': max_connections,
                 'health_check_interval': health_check_interval,
                 'client_name': client_name
@@ -940,21 +948,41 @@ def close(self):
             self.connection = None
             self.connection_pool.release(conn)
 
+    def _send_command_parse_response(self,
+                                     conn,
+                                     command_name,
+                                     *args,
+                                     **options):
+        """
+        Send a command and parse the response
+        """
+        conn.send_command(*args)
+        return self.parse_response(conn, command_name, **options)
+
+    def _disconnect_raise(self, conn, error):
+        """
+        Close the connection and raise an exception
+        if retry_on_timeout is not set or the error
+        is not a TimeoutError
+        """
+        conn.disconnect()
+        if not (conn.retry_on_timeout and isinstance(error, TimeoutError)):
+            raise error
+
     # COMMAND EXECUTION AND PROTOCOL PARSING
     def execute_command(self, *args, **options):
         "Execute a command and return a parsed response"
         pool = self.connection_pool
         command_name = args[0]
         conn = self.connection or pool.get_connection(command_name, **options)
+
         try:
-            conn.send_command(*args)
-            return self.parse_response(conn, command_name, **options)
-        except (ConnectionError, TimeoutError) as e:
-            conn.disconnect()
-            if not (conn.retry_on_timeout and isinstance(e, TimeoutError)):
-                raise
-            conn.send_command(*args)
-            return self.parse_response(conn, command_name, **options)
+            return conn.retry.call_with_retry(
+                lambda: self._send_command_parse_response(conn,
+                                                          command_name,
+                                                          *args,
+                                                          **options),
+                lambda error: self._disconnect_raise(conn, error))
         finally:
             if not self.connection:
                 pool.release(conn)
@@ -1142,24 +1170,31 @@ def execute_command(self, *args):
         kwargs = {'check_health': not self.subscribed}
         self._execute(connection, connection.send_command, *args, **kwargs)
 
-    def _execute(self, connection, command, *args, **kwargs):
-        try:
-            return command(*args, **kwargs)
-        except (ConnectionError, TimeoutError) as e:
-            connection.disconnect()
-            if not (connection.retry_on_timeout and
-                    isinstance(e, TimeoutError)):
-                raise
-            # Connect manually here. If the Redis server is down, this will
-            # fail and raise a ConnectionError as desired.
-            connection.connect()
-            # the ``on_connect`` callback should haven been called by the
-            # connection to resubscribe us to any channels and patterns we were
-            # previously listening to
-            return command(*args, **kwargs)
+    def _disconnect_raise_connect(self, conn, error):
+        """
+        Close the connection and raise an exception
+        if retry_on_timeout is not set or the error
+        is not a TimeoutError. Otherwise, try to reconnect
+        """
+        conn.disconnect()
+        if not (conn.retry_on_timeout and isinstance(error, TimeoutError)):
+            raise error
+        conn.connect()
+
+    def _execute(self, conn, command, *args, **kwargs):
+        """
+        Connect manually upon disconnection. If the Redis server is down,
+        this will fail and raise a ConnectionError as desired.
+        After reconnection, the ``on_connect`` callback should have been
+        called by the # connection to resubscribe us to any channels and
+        patterns we were previously listening to
+        """
+        return conn.retry.call_with_retry(
+            lambda: command(*args, **kwargs),
+            lambda error: self._disconnect_raise_connect(conn, error))
 
     def parse_response(self, block=True, timeout=0):
-        "Parse the response from a publish/subscribe command"
+        """Parse the response from a publish/subscribe command"""
         conn = self.connection
         if conn is None:
             raise RuntimeError(
@@ -1499,6 +1534,27 @@ def execute_command(self, *args, **kwargs):
             return self.immediate_execute_command(*args, **kwargs)
         return self.pipeline_execute_command(*args, **kwargs)
 
+    def _disconnect_reset_raise(self, conn, error):
+        """
+        Close the connection, reset watching state and
+        raise an exception if we were watching,
+        retry_on_timeout is not set,
+        or the error is not a TimeoutError
+        """
+        conn.disconnect()
+        # if we were already watching a variable, the watch is no longer
+        # valid since this connection has died. raise a WatchError, which
+        # indicates the user should retry this transaction.
+        if self.watching:
+            self.reset()
+            raise WatchError("A ConnectionError occurred on while "
+                             "watching one or more keys")
+        # if retry_on_timeout is not set, or the error is not
+        # a TimeoutError, raise it
+        if not (conn.retry_on_timeout and isinstance(error, TimeoutError)):
+            self.reset()
+            raise
+
     def immediate_execute_command(self, *args, **options):
         """
         Execute a command immediately, but don't auto-retry on a
@@ -1513,33 +1569,13 @@ def immediate_execute_command(self, *args, **options):
             conn = self.connection_pool.get_connection(command_name,
                                                        self.shard_hint)
             self.connection = conn
-        try:
-            conn.send_command(*args)
-            return self.parse_response(conn, command_name, **options)
-        except (ConnectionError, TimeoutError) as e:
-            conn.disconnect()
-            # if we were already watching a variable, the watch is no longer
-            # valid since this connection has died. raise a WatchError, which
-            # indicates the user should retry this transaction.
-            if self.watching:
-                self.reset()
-                raise WatchError("A ConnectionError occurred on while "
-                                 "watching one or more keys")
-            # if retry_on_timeout is not set, or the error is not
-            # a TimeoutError, raise it
-            if not (conn.retry_on_timeout and isinstance(e, TimeoutError)):
-                self.reset()
-                raise
-
-            # retry_on_timeout is set, this is a TimeoutError and we are not
-            # already WATCHing any variables. retry the command.
-            try:
-                conn.send_command(*args)
-                return self.parse_response(conn, command_name, **options)
-            except (ConnectionError, TimeoutError):
-                # a subsequent failure should simply be raised
-                self.reset()
-                raise
+
+        return conn.retry.call_with_retry(
+            lambda: self._send_command_parse_response(conn,
+                                                      command_name,
+                                                      *args,
+                                                      **options),
+            lambda error: self._disconnect_reset_raise(conn, error))
 
     def pipeline_execute_command(self, *args, **options):
         """
@@ -1672,6 +1708,25 @@ def load_scripts(self):
                 if not exist:
                     s.sha = immediate('SCRIPT LOAD', s.script)
 
+    def _disconnect_raise_reset(self, conn, error):
+        """
+        Close the connection, raise an exception if we were watching,
+        and raise an exception if retry_on_timeout is not set,
+        or the error is not a TimeoutError
+        """
+        conn.disconnect()
+        # if we were watching a variable, the watch is no longer valid
+        # since this connection has died. raise a WatchError, which
+        # indicates the user should retry this transaction.
+        if self.watching:
+            raise WatchError("A ConnectionError occurred on while "
+                             "watching one or more keys")
+        # if retry_on_timeout is not set, or the error is not
+        # a TimeoutError, raise it
+        if not (conn.retry_on_timeout and isinstance(error, TimeoutError)):
+            self.reset()
+            raise
+
     def execute(self, raise_on_error=True):
         "Execute all the commands in the current pipeline"
         stack = self.command_stack
@@ -1693,21 +1748,9 @@ def execute(self, raise_on_error=True):
             self.connection = conn
 
         try:
-            return execute(conn, stack, raise_on_error)
-        except (ConnectionError, TimeoutError) as e:
-            conn.disconnect()
-            # if we were watching a variable, the watch is no longer valid
-            # since this connection has died. raise a WatchError, which
-            # indicates the user should retry this transaction.
-            if self.watching:
-                raise WatchError("A ConnectionError occurred on while "
-                                 "watching one or more keys")
-            # if retry_on_timeout is not set, or the error is not
-            # a TimeoutError, raise it
-            if not (conn.retry_on_timeout and isinstance(e, TimeoutError)):
-                raise
-            # retry a TimeoutError when retry_on_timeout is set
-            return execute(conn, stack, raise_on_error)
+            return conn.retry.call_with_retry(
+                lambda: execute(conn, stack, raise_on_error),
+                lambda error: self._disconnect_raise_reset(conn, error))
         finally:
             self.reset()
 
diff --git a/redis/connection.py b/redis/connection.py
index 4a855b3568..e47e3c76a0 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -3,6 +3,7 @@
 from time import time
 from queue import LifoQueue, Empty, Full
 from urllib.parse import parse_qs, unquote, urlparse
+import copy
 import errno
 import io
 import os
@@ -28,6 +29,8 @@
     ModuleError,
 )
 from redis.utils import HIREDIS_AVAILABLE, str_if_bytes
+from redis.backoff import NoBackoff
+from redis.retry import Retry
 
 try:
     import ssl
@@ -499,7 +502,13 @@ def __init__(self, host='localhost', port=6379, db=0, password=None,
                  socket_type=0, retry_on_timeout=False, encoding='utf-8',
                  encoding_errors='strict', decode_responses=False,
                  parser_class=DefaultParser, socket_read_size=65536,
-                 health_check_interval=0, client_name=None, username=None):
+                 health_check_interval=0, client_name=None, username=None,
+                 retry=None):
+        """
+        Initialize a new Connection.
+        To specify a retry policy, first set `retry_on_timeout` to `True`
+        then set `retry` to a valid `Retry` object
+        """
         self.pid = os.getpid()
         self.host = host
         self.port = int(port)
@@ -513,6 +522,14 @@ def __init__(self, host='localhost', port=6379, db=0, password=None,
         self.socket_keepalive_options = socket_keepalive_options or {}
         self.socket_type = socket_type
         self.retry_on_timeout = retry_on_timeout
+        if retry_on_timeout:
+            if retry is None:
+                self.retry = Retry(NoBackoff(), 1)
+            else:
+                # deep-copy the Retry object as it is mutable
+                self.retry = copy.deepcopy(retry)
+        else:
+            self.retry = Retry(NoBackoff(), 0)
         self.health_check_interval = health_check_interval
         self.next_health_check = 0
         self.encoder = Encoder(encoding, encoding_errors, decode_responses)
@@ -673,23 +690,23 @@ def disconnect(self):
             pass
         self._sock = None
 
+    def _send_ping(self):
+        """Send PING, expect PONG in return"""
+        self.send_command('PING', check_health=False)
+        if str_if_bytes(self.read_response()) != 'PONG':
+            raise ConnectionError('Bad response from PING health check')
+
+    def _ping_failed(self, error):
+        """Function to call when PING fails"""
+        self.disconnect()
+
     def check_health(self):
-        "Check the health of the connection with a PING/PONG"
+        """Check the health of the connection with a PING/PONG"""
         if self.health_check_interval and time() > self.next_health_check:
-            try:
-                self.send_command('PING', check_health=False)
-                if str_if_bytes(self.read_response()) != 'PONG':
-                    raise ConnectionError(
-                        'Bad response from PING health check')
-            except (ConnectionError, TimeoutError):
-                self.disconnect()
-                self.send_command('PING', check_health=False)
-                if str_if_bytes(self.read_response()) != 'PONG':
-                    raise ConnectionError(
-                        'Bad response from PING health check')
+            self.retry.call_with_retry(self._send_ping, self._ping_failed)
 
     def send_packed_command(self, command, check_health=True):
-        "Send an already packed command to the Redis server"
+        """Send an already packed command to the Redis server"""
         if not self._sock:
             self.connect()
         # guard against health check recursion
@@ -717,12 +734,12 @@ def send_packed_command(self, command, check_health=True):
             raise
 
     def send_command(self, *args, **kwargs):
-        "Pack and send a command to the Redis server"
+        """Pack and send a command to the Redis server"""
         self.send_packed_command(self.pack_command(*args),
                                  check_health=kwargs.get('check_health', True))
 
     def can_read(self, timeout=0):
-        "Poll the socket to see if there's data that can be read."
+        """Poll the socket to see if there's data that can be read."""
         sock = self._sock
         if not sock:
             self.connect()
@@ -730,7 +747,7 @@ def can_read(self, timeout=0):
         return self._parser.can_read(timeout)
 
     def read_response(self):
-        "Read the response from a previously sent command"
+        """Read the response from a previously sent command"""
         try:
             response = self._parser.read_response()
         except socket.timeout:
@@ -753,7 +770,7 @@ def read_response(self):
         return response
 
     def pack_command(self, *args):
-        "Pack a series of arguments into the Redis protocol"
+        """Pack a series of arguments into the Redis protocol"""
         output = []
         # the client might have included 1 or more literal arguments in
         # the command name, e.g., 'CONFIG GET'. The Redis server expects these
@@ -787,7 +804,7 @@ def pack_command(self, *args):
         return output
 
     def pack_commands(self, commands):
-        "Pack multiple commands into the Redis protocol"
+        """Pack multiple commands into the Redis protocol"""
         output = []
         pieces = []
         buffer_length = 0
diff --git a/redis/retry.py b/redis/retry.py
new file mode 100644
index 0000000000..cd06a23e3d
--- /dev/null
+++ b/redis/retry.py
@@ -0,0 +1,40 @@
+from time import sleep
+
+from redis.exceptions import ConnectionError, TimeoutError
+
+
+class Retry:
+    """Retry a specific number of times after a failure"""
+
+    def __init__(self, backoff, retries,
+                 supported_errors=(ConnectionError, TimeoutError)):
+        """
+        Initialize a `Retry` object with a `Backoff` object
+        that retries a maximum of `retries` times.
+        You can specify the types of supported errors which trigger
+        a retry with the `supported_errors` parameter.
+        """
+        self._backoff = backoff
+        self._retries = retries
+        self._supported_errors = supported_errors
+
+    def call_with_retry(self, do, fail):
+        """
+        Execute an operation that might fail and returns its result, or
+        raise the exception that was thrown depending on the `Backoff` object.
+        `do`: the operation to call. Expects no argument.
+        `fail`: the failure handler, expects the last error that was thrown
+        """
+        self._backoff.reset()
+        failures = 0
+        while True:
+            try:
+                return do()
+            except self._supported_errors as error:
+                failures += 1
+                fail(error)
+                if failures > self._retries:
+                    raise error
+                backoff = self._backoff.compute(failures)
+                if backoff > 0:
+                    sleep(backoff)
diff --git a/tests/conftest.py b/tests/conftest.py
index cd4d4894a3..711f9e5057 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -1,3 +1,5 @@
+from redis.backoff import NoBackoff
+from redis.retry import Retry
 import pytest
 import random
 import redis
@@ -107,6 +109,7 @@ def r2(request):
 
 def _gen_cluster_mock_resp(r, response):
     connection = Mock()
+    connection.retry = Retry(NoBackoff(), 0)
     connection.read_response.return_value = response
     r.connection = connection
     return r
diff --git a/tests/test_retry.py b/tests/test_retry.py
new file mode 100644
index 0000000000..24d9683f17
--- /dev/null
+++ b/tests/test_retry.py
@@ -0,0 +1,66 @@
+from redis.backoff import NoBackoff
+import pytest
+
+from redis.exceptions import ConnectionError
+from redis.connection import Connection
+from redis.retry import Retry
+
+
+class BackoffMock:
+    def __init__(self):
+        self.reset_calls = 0
+        self.calls = 0
+
+    def reset(self):
+        self.reset_calls += 1
+
+    def compute(self, failures):
+        self.calls += 1
+        return 0
+
+
+class TestConnectionConstructorWithRetry:
+    "Test that the Connection constructor properly handles Retry objects"
+
+    @pytest.mark.parametrize("retry_on_timeout", [False, True])
+    def test_retry_on_timeout_boolean(self, retry_on_timeout):
+        c = Connection(retry_on_timeout=retry_on_timeout)
+        assert c.retry_on_timeout == retry_on_timeout
+        assert isinstance(c.retry, Retry)
+        assert c.retry._retries == (1 if retry_on_timeout else 0)
+
+    @pytest.mark.parametrize("retries", range(10))
+    def test_retry_on_timeout_retry(self, retries):
+        retry_on_timeout = retries > 0
+        c = Connection(retry_on_timeout=retry_on_timeout,
+                       retry=Retry(NoBackoff(), retries))
+        assert c.retry_on_timeout == retry_on_timeout
+        assert isinstance(c.retry, Retry)
+        assert c.retry._retries == retries
+
+
+class TestRetry:
+    "Test that Retry calls backoff and retries the expected number of times"
+
+    def setup_method(self, test_method):
+        self.actual_attempts = 0
+        self.actual_failures = 0
+
+    def _do(self):
+        self.actual_attempts += 1
+        raise ConnectionError()
+
+    def _fail(self, error):
+        self.actual_failures += 1
+
+    @pytest.mark.parametrize("retries", range(10))
+    def test_retry(self, retries):
+        backoff = BackoffMock()
+        retry = Retry(backoff, retries)
+        with pytest.raises(ConnectionError):
+            retry.call_with_retry(self._do, self._fail)
+
+        assert self.actual_attempts == 1 + retries
+        assert self.actual_failures == 1 + retries
+        assert backoff.reset_calls == 1
+        assert backoff.calls == retries

From 8cfea4137851fa49c7d211b782800dd696b67c39 Mon Sep 17 00:00:00 2001
From: Karthikeyan Singaravelan <tir.karthi@gmail.com>
Date: Sun, 29 Aug 2021 13:49:45 +0530
Subject: [PATCH 0137/1164] Use Version instead of StrictVersion since
 distutils is deprecated. (#1552)

---
 redis/connection.py | 10 +++++-----
 tests/conftest.py   |  8 ++++----
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/redis/connection.py b/redis/connection.py
index e47e3c76a0..de30f0c638 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1,4 +1,4 @@
-from distutils.version import StrictVersion
+from packaging.version import Version
 from itertools import chain
 from time import time
 from queue import LifoQueue, Empty, Full
@@ -54,13 +54,13 @@
 if HIREDIS_AVAILABLE:
     import hiredis
 
-    hiredis_version = StrictVersion(hiredis.__version__)
+    hiredis_version = Version(hiredis.__version__)
     HIREDIS_SUPPORTS_CALLABLE_ERRORS = \
-        hiredis_version >= StrictVersion('0.1.3')
+        hiredis_version >= Version('0.1.3')
     HIREDIS_SUPPORTS_BYTE_BUFFER = \
-        hiredis_version >= StrictVersion('0.1.4')
+        hiredis_version >= Version('0.1.4')
     HIREDIS_SUPPORTS_ENCODING_ERRORS = \
-        hiredis_version >= StrictVersion('1.0.0')
+        hiredis_version >= Version('1.0.0')
 
     if not HIREDIS_SUPPORTS_BYTE_BUFFER:
         msg = ("redis-py works best with hiredis >= 0.1.4. You're running "
diff --git a/tests/conftest.py b/tests/conftest.py
index 711f9e5057..fe304c2cc2 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -3,7 +3,7 @@
 import pytest
 import random
 import redis
-from distutils.version import StrictVersion
+from packaging.version import Version
 from redis.connection import parse_url
 from unittest.mock import Mock
 from urllib.parse import urlparse
@@ -44,7 +44,7 @@ def pytest_sessionstart(session):
 
 def skip_if_server_version_lt(min_version):
     redis_version = REDIS_INFO["version"]
-    check = StrictVersion(redis_version) < StrictVersion(min_version)
+    check = Version(redis_version) < Version(min_version)
     return pytest.mark.skipif(
         check,
         reason="Redis version required >= {}".format(min_version))
@@ -52,7 +52,7 @@ def skip_if_server_version_lt(min_version):
 
 def skip_if_server_version_gte(min_version):
     redis_version = REDIS_INFO["version"]
-    check = StrictVersion(redis_version) >= StrictVersion(min_version)
+    check = Version(redis_version) >= Version(min_version)
     return pytest.mark.skipif(
         check,
         reason="Redis version required < {}".format(min_version))
@@ -183,7 +183,7 @@ def wait_for_command(client, monitor, command):
     # if we find a command with our key before the command we're waiting
     # for, something went wrong
     redis_version = REDIS_INFO["version"]
-    if StrictVersion(redis_version) >= StrictVersion('5.0.0'):
+    if Version(redis_version) >= Version('5.0.0'):
         id_str = str(client.client_id())
     else:
         id_str = '%08x' % random.randrange(2**32)

From 7c77883596e9e28c2d04298bf15ad9f947dd907f Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 29 Aug 2021 11:21:01 +0300
Subject: [PATCH 0138/1164] Merged new sentinel commands from #834 (#1550)

* Merged new sentinel commands from #835

Thanks you @otherpirate for the contribution!

* Added an execute wrapper and tests.

The tests ensure that the function is called. Nothing more since we do not currently have enough testing support for sentinel
---
 redis/client.py        |  4 ++++
 redis/commands.py      | 53 +++++++++++++++++++++++++++++++++++++++++-
 redis/sentinel.py      | 21 +++++++++++++++--
 tests/test_sentinel.py | 23 ++++++++++++++++--
 4 files changed, 96 insertions(+), 5 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index ab9246d160..f6ca071ed4 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -675,10 +675,14 @@ class Redis(Commands, object):
         'SCRIPT FLUSH': bool_ok,
         'SCRIPT KILL': bool_ok,
         'SCRIPT LOAD': str_if_bytes,
+        'SENTINEL CKQUORUM': bool_ok,
+        'SENTINEL FAILOVER': bool_ok,
+        'SENTINEL FLUSHCONFIG': bool_ok,
         'SENTINEL GET-MASTER-ADDR-BY-NAME': parse_sentinel_get_master,
         'SENTINEL MASTER': parse_sentinel_master,
         'SENTINEL MASTERS': parse_sentinel_masters,
         'SENTINEL MONITOR': bool_ok,
+        'SENTINEL RESET': bool_ok,
         'SENTINEL REMOVE': bool_ok,
         'SENTINEL SENTINELS': parse_sentinel_slaves_and_sentinels,
         'SENTINEL SET': bool_ok,
diff --git a/redis/commands.py b/redis/commands.py
index 003b0f1bcc..3d5670e1f1 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -2950,7 +2950,7 @@ def execute(self):
         return self.client.execute_command(*command)
 
 
-class SentinalCommands:
+class SentinelCommands:
     """
     A class containing the commands specific to redis sentinal. This class is
     to be used as a mixin.
@@ -2993,3 +2993,54 @@ def sentinel_set(self, name, option, value):
     def sentinel_slaves(self, service_name):
         "Returns a list of slaves for ``service_name``"
         return self.execute_command('SENTINEL SLAVES', service_name)
+
+    def sentinel_reset(self, pattern):
+        """
+        This command will reset all the masters with matching name.
+        The pattern argument is a glob-style pattern.
+
+        The reset process clears any previous state in a master (including a
+        failover in progress), and removes every slave and sentinel already
+        discovered and associated with the master.
+        """
+        return self.execute_command('SENTINEL RESET', pattern, once=True)
+
+    def sentinel_failover(self, new_master_name):
+        """
+        Force a failover as if the master was not reachable, and without
+        asking for agreement to other Sentinels (however a new version of the
+        configuration will be published so that the other Sentinels will
+        update their configurations).
+        """
+        return self.execute_command('SENTINEL FAILOVER', new_master_name)
+
+    def sentinel_ckquorum(self, new_master_name):
+        """
+        Check if the current Sentinel configuration is able to reach the
+        quorum needed to failover a master, and the majority needed to
+        authorize the failover.
+
+        This command should be used in monitoring systems to check if a
+        Sentinel deployment is ok.
+        """
+        return self.execute_command('SENTINEL CKQUORUM',
+                                    new_master_name,
+                                    once=True)
+
+    def sentinel_flushconfig(self):
+        """
+        Force Sentinel to rewrite its configuration on disk, including the
+        current Sentinel state.
+
+        Normally Sentinel rewrites the configuration every time something
+        changes in its state (in the context of the subset of the state which
+        is persisted on disk across restart).
+        However sometimes it is possible that the configuration file is lost
+        because of operation errors, disk failures, package upgrade scripts or
+        configuration managers. In those cases a way to to force Sentinel to
+        rewrite the configuration file is handy.
+
+        This command works even if the previous configuration file is
+        completely missing.
+        """
+        return self.execute_command('SENTINEL FLUSHCONFIG')
diff --git a/redis/sentinel.py b/redis/sentinel.py
index d3213488c1..6456b8e868 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -2,7 +2,7 @@
 import weakref
 
 from redis.client import Redis
-from redis.commands import SentinalCommands
+from redis.commands import SentinelCommands
 from redis.connection import ConnectionPool, Connection
 from redis.exceptions import (ConnectionError, ResponseError, ReadOnlyError,
                               TimeoutError)
@@ -133,7 +133,7 @@ def rotate_slaves(self):
         raise SlaveNotFoundError('No slave found for %r' % (self.service_name))
 
 
-class Sentinel(SentinalCommands, object):
+class Sentinel(SentinelCommands, object):
     """
     Redis Sentinel cluster client
 
@@ -179,6 +179,23 @@ def __init__(self, sentinels, min_other_sentinels=0, sentinel_kwargs=None,
         self.min_other_sentinels = min_other_sentinels
         self.connection_kwargs = connection_kwargs
 
+    def execute_command(self, *args, **kwargs):
+        """
+        Execute Sentinel command in sentinel nodes.
+        once - If set to True, then execute the resulting command on a single
+               node at random, rather than across the entire sentinel cluster.
+        """
+        once = bool(kwargs.get('once', False))
+        if 'once' in kwargs.keys():
+            kwargs.pop('once')
+
+        if once:
+            for sentinel in self.sentinels:
+                sentinel.execute_command(*args, **kwargs)
+        else:
+            random.choice(self.sentinels).execute_command(*args, **kwargs)
+        return True
+
     def __repr__(self):
         sentinel_addresses = []
         for sentinel in self.sentinels:
diff --git a/tests/test_sentinel.py b/tests/test_sentinel.py
index 64a7c47d3a..54cf262c43 100644
--- a/tests/test_sentinel.py
+++ b/tests/test_sentinel.py
@@ -30,9 +30,15 @@ def sentinel_slaves(self, master_name):
             return []
         return self.cluster.slaves
 
+    def execute_command(self, *args, **kwargs):
+        # wrapper  purely to validate the calls don't explode
+        from redis.client import bool_ok
+        return bool_ok
+
 
 class SentinelTestCluster:
-    def __init__(self, service_name='mymaster', ip='127.0.0.1', port=6379):
+    def __init__(self, servisentinel_ce_name='mymaster', ip='127.0.0.1',
+                 port=6379):
         self.clients = {}
         self.master = {
             'ip': ip,
@@ -42,7 +48,7 @@ def __init__(self, service_name='mymaster', ip='127.0.0.1', port=6379):
             'is_odown': False,
             'num-other-sentinels': 0,
         }
-        self.service_name = service_name
+        self.service_name = servisentinel_ce_name
         self.slaves = []
         self.nodes_down = set()
         self.nodes_timeout = set()
@@ -198,3 +204,16 @@ def test_slave_round_robin(cluster, sentinel, master_ip):
     assert next(rotator) == (master_ip, 6379)
     with pytest.raises(SlaveNotFoundError):
         next(rotator)
+
+
+def test_ckquorum(cluster, sentinel):
+    assert sentinel.sentinel_ckquorum("mymaster")
+
+
+def test_flushconfig(cluster, sentinel):
+    assert sentinel.sentinel_flushconfig()
+
+
+def test_reset(cluster, sentinel):
+    cluster.master['is_odown'] = True
+    assert sentinel.sentinel_reset('mymaster')

From 295b547fb0fe67cef7c21f84f98bbfad4ca80d08 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Sun, 29 Aug 2021 11:21:58 +0300
Subject: [PATCH 0139/1164] Support MINID and LIMIT on XADD (#1548)

* MINID and LIMIT
---
 redis/commands.py      | 22 ++++++++++++++++---
 tests/test_commands.py | 50 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 69 insertions(+), 3 deletions(-)

diff --git a/redis/commands.py b/redis/commands.py
index 3d5670e1f1..5aae14a808 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -1640,17 +1640,25 @@ def xack(self, name, groupname, *ids):
         return self.execute_command('XACK', name, groupname, *ids)
 
     def xadd(self, name, fields, id='*', maxlen=None, approximate=True,
-             nomkstream=False):
+             nomkstream=False, minid=None, limit=None):
         """
         Add to a stream.
         name: name of the stream
         fields: dict of field/value pairs to insert into the stream
         id: Location to insert this record. By default it is appended.
-        maxlen: truncate old stream members beyond this size
+        maxlen: truncate old stream members beyond this size.
+        Can't be specify with minid.
+        minid: the minimum id in the stream to query.
+        Can't be specify with maxlen.
         approximate: actual stream length may be slightly more than maxlen
         nomkstream: When set to true, do not make a stream
+        limit: specifies the maximum number of entries to retrieve
         """
         pieces = []
+        if maxlen is not None and minid is not None:
+            raise DataError("Only one of ```maxlen``` or ```minid```",
+                            "may be specified")
+
         if maxlen is not None:
             if not isinstance(maxlen, int) or maxlen < 1:
                 raise DataError('XADD maxlen must be a positive integer')
@@ -1658,6 +1666,14 @@ def xadd(self, name, fields, id='*', maxlen=None, approximate=True,
             if approximate:
                 pieces.append(b'~')
             pieces.append(str(maxlen))
+        if minid is not None:
+            pieces.append(b'MINID')
+            if approximate:
+                pieces.append(b'~')
+            pieces.append(minid)
+        if limit is not None:
+            pieces.append(b"LIMIT")
+            pieces.append(limit)
         if nomkstream:
             pieces.append(b'NOMKSTREAM')
         pieces.append(id)
@@ -2002,7 +2018,7 @@ def xtrim(self, name, maxlen=None, approximate=True, minid=None,
         name: name of the stream.
         maxlen: truncate old stream messages beyond this size
         approximate: actual stream length may be slightly more than maxlen
-        minin: the minimum id in the stream to query
+        minid: the minimum id in the stream to query
         limit: specifies the maximum number of entries to retrieve
         """
         pieces = []
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 3c87dd9dd6..d22d72abcf 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2422,6 +2422,56 @@ def test_xadd_nomkstream(self, r):
         r.xadd(stream, {'some': 'other'}, nomkstream=True)
         assert r.xlen(stream) == 3
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_xadd_minlen_and_limit(self, r):
+        stream = 'stream'
+
+        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+
+        # Future self: No limits without approximate, according to the api
+        with pytest.raises(redis.ResponseError):
+            assert r.xadd(stream, {'foo': 'bar'}, maxlen=3,
+                          approximate=False, limit=2)
+
+        # limit can not be provided without maxlen or minid
+        with pytest.raises(redis.ResponseError):
+            assert r.xadd(stream, {'foo': 'bar'}, limit=2)
+
+        # maxlen with a limit
+        assert r.xadd(stream, {'foo': 'bar'}, maxlen=3,
+                      approximate=True, limit=2)
+        r.delete(stream)
+
+        # maxlen and minid can not be provided together
+        with pytest.raises(redis.DataError):
+            assert r.xadd(stream, {'foo': 'bar'}, maxlen=3,
+                          minid="sometestvalue")
+
+        # minid with a limit
+        m1 = r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+        assert r.xadd(stream, {'foo': 'bar'}, approximate=True,
+                      minid=m1, limit=3)
+
+        # pure minid
+        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+        m4 = r.xadd(stream, {'foo': 'bar'})
+        assert r.xadd(stream, {'foo': 'bar'}, approximate=False, minid=m4)
+
+        # minid approximate
+        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+        m3 = r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+        assert r.xadd(stream, {'foo': 'bar'}, approximate=True, minid=m3)
+
     @skip_if_server_version_lt('6.2.0')
     def test_xautoclaim(self, r):
         stream = 'stream'

From 5964d700beb9a6b195d64430b0a655e6aa6fd721 Mon Sep 17 00:00:00 2001
From: Jiekun <2014bduck@gmail.com>
Date: Sun, 29 Aug 2021 16:32:18 +0800
Subject: [PATCH 0140/1164] #1434 Added support for ZMSCORE new in Redis 6.2 RC
 (#1437)

* #1434 Added zmscore command support

* #1434 Fixed typo and doc

* #1434 Set [] as default value for members arg in zmscore func

* #1434 Set None as default value for members arg in zmscore func

* #1434 Removed default value for members arg in zmscore func

* Fixed flake8 formatting

Co-authored-by: jiekun.zhu <jiekun.zhu@shopee.com>
---
 redis/client.py        |  6 ++++++
 redis/commands.py      | 14 ++++++++++++++
 tests/test_commands.py | 11 +++++++++++
 3 files changed, 31 insertions(+)

diff --git a/redis/client.py b/redis/client.py
index f6ca071ed4..939c32730b 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -390,6 +390,11 @@ def parse_zscan(response, **options):
     return int(cursor), list(zip(it, map(score_cast_func, it)))
 
 
+def parse_zmscore(response, **options):
+    # zmscore: list of scores (double precision floating point number) or nil
+    return [float(score) if score is not None else None for score in response]
+
+
 def parse_slowlog_get(response, **options):
     space = ' ' if options.get('decode_responses', False) else b' '
     return [{
@@ -705,6 +710,7 @@ class Redis(Commands, object):
         'XPENDING': parse_xpending,
         'ZADD': parse_zadd,
         'ZSCAN': parse_zscan,
+        'ZMSCORE': parse_zmscore,
     }
 
     @classmethod
diff --git a/redis/commands.py b/redis/commands.py
index 5aae14a808..f940bcc071 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -2461,6 +2461,20 @@ def zunionstore(self, dest, keys, aggregate=None):
         """
         return self._zaggregate('ZUNIONSTORE', dest, keys, aggregate)
 
+    def zmscore(self, key, members):
+        """
+        Returns the scores associated with the specified members
+        in the sorted set stored at key.
+        ``members`` should be a list of the member name.
+        Return type is a list of score.
+        If the member does not exist, a None will be returned
+        in corresponding position.
+        """
+        if not members:
+            raise DataError('ZMSCORE members must be a non-empty list')
+        pieces = [key] + members
+        return self.execute_command('ZMSCORE', *pieces)
+
     def _zaggregate(self, command, dest, keys, aggregate=None,
                     **options):
         pieces = [command]
diff --git a/tests/test_commands.py b/tests/test_commands.py
index d22d72abcf..1d829d6261 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1865,6 +1865,17 @@ def test_zunionstore_with_weight(self, r):
         assert r.zrange('d', 0, -1, withscores=True) == \
             [(b'a2', 5), (b'a4', 12), (b'a3', 20), (b'a1', 23)]
 
+    @skip_if_server_version_lt('6.1.240')
+    def test_zmscore(self, r):
+        with pytest.raises(exceptions.DataError):
+            r.zmscore('invalid_key', [])
+
+        assert r.zmscore('invalid_key', ['invalid_member']) == [None]
+
+        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3.5})
+        assert r.zmscore('a', ['a1', 'a2', 'a3', 'a4']) == \
+            [1.0, 2.0, 3.5, None]
+
     # HYPERLOGLOG TESTS
     @skip_if_server_version_lt('2.8.9')
     def test_pfadd(self, r):

From 9f82778b78b2e4fd1482255edc91d10c4dda2988 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Sun, 29 Aug 2021 11:36:50 +0300
Subject: [PATCH 0141/1164] Stralgo (#1528)

* add support to STRALDO command

* add tests

* skip if version ..

* new line

* lower case

* fix comments

* callback

* change to get
---
 redis/client.py        | 29 ++++++++++++++++++++++++++
 redis/commands.py      | 47 ++++++++++++++++++++++++++++++++++++++++++
 tests/test_commands.py | 43 ++++++++++++++++++++++++++++++++++++++
 3 files changed, 119 insertions(+)

diff --git a/redis/client.py b/redis/client.py
index 939c32730b..3a9a5b6b1b 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -410,6 +410,34 @@ def parse_slowlog_get(response, **options):
     } for item in response]
 
 
+def parse_stralgo(response, **options):
+    """
+    Parse the response from `STRALGO` command.
+    Without modifiers the returned value is string.
+    When LEN is given the command returns the length of the result
+    (i.e integer).
+    When IDX is given the command returns a dictionary with the LCS
+    length and all the ranges in both the strings, start and end
+    offset for each string, where there are matches.
+    When WITHMATCHLEN is given, each array representing a match will
+    also have the length of the match at the beginning of the array.
+    """
+    if options.get('len', False):
+        return int(response)
+    if options.get('idx', False):
+        if options.get('withmatchlen', False):
+            matches = [[(int(match[-1]))] + list(map(tuple, match[:-1]))
+                       for match in response[1]]
+        else:
+            matches = [list(map(tuple, match))
+                       for match in response[1]]
+        return {
+            str_if_bytes(response[0]): matches,
+            str_if_bytes(response[2]): int(response[3])
+        }
+    return str_if_bytes(response)
+
+
 def parse_cluster_info(response, **options):
     response = str_if_bytes(response)
     return dict(line.split(':') for line in response.splitlines() if line)
@@ -673,6 +701,7 @@ class Redis(Commands, object):
         'MODULE LIST': lambda r: [pairs_to_dict(m) for m in r],
         'OBJECT': parse_object,
         'PING': lambda r: str_if_bytes(r) == 'PONG',
+        'STRALGO': parse_stralgo,
         'PUBSUB NUMSUB': parse_pubsub_numsub,
         'RANDOMKEY': lambda r: r and r or None,
         'SCAN': parse_scan,
diff --git a/redis/commands.py b/redis/commands.py
index f940bcc071..a9b90f0222 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -1100,6 +1100,53 @@ def setrange(self, name, offset, value):
         """
         return self.execute_command('SETRANGE', name, offset, value)
 
+    def stralgo(self, algo, value1, value2, specific_argument='strings',
+                len=False, idx=False, minmatchlen=None, withmatchlen=False):
+        """
+        Implements complex algorithms that operate on strings.
+        Right now the only algorithm implemented is the LCS algorithm
+        (longest common substring). However new algorithms could be
+        implemented in the future.
+
+        ``algo`` Right now must be LCS
+        ``value1`` and ``value2`` Can be two strings or two keys
+        ``specific_argument`` Specifying if the arguments to the algorithm
+        will be keys or strings. strings is the default.
+        ``len`` Returns just the len of the match.
+        ``idx`` Returns the match positions in each string.
+        ``minmatchlen`` Restrict the list of matches to the ones of a given
+        minimal length. Can be provided only when ``idx`` set to True.
+        ``withmatchlen`` Returns the matches with the len of the match.
+        Can be provided only when ``idx`` set to True.
+        """
+        # check validity
+        supported_algo = ['LCS']
+        if algo not in supported_algo:
+            raise DataError("The supported algorithms are: %s"
+                            % (', '.join(supported_algo)))
+        if specific_argument not in ['keys', 'strings']:
+            raise DataError("specific_argument can be only"
+                            " keys or strings")
+        if len and idx:
+            raise DataError("len and idx cannot be provided together.")
+
+        pieces = [algo, specific_argument.upper(), value1, value2]
+        if len:
+            pieces.append(b'LEN')
+        if idx:
+            pieces.append(b'IDX')
+        try:
+            int(minmatchlen)
+            pieces.extend([b'MINMATCHLEN', minmatchlen])
+        except TypeError:
+            pass
+        if withmatchlen:
+            pieces.append(b'WITHMATCHLEN')
+
+        return self.execute_command('STRALGO', *pieces, len=len, idx=idx,
+                                    minmatchlen=minmatchlen,
+                                    withmatchlen=withmatchlen)
+
     def strlen(self, name):
         "Return the number of bytes stored in the value of ``name``"
         return self.execute_command('STRLEN', name)
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 1d829d6261..4b7957c7dd 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1052,6 +1052,49 @@ def test_setrange(self, r):
         assert r.setrange('a', 6, '12345') == 11
         assert r['a'] == b'abcdef12345'
 
+    @skip_if_server_version_lt('6.0.0')
+    def test_stralgo_lcs(self, r):
+        key1 = 'key1'
+        key2 = 'key2'
+        value1 = 'ohmytext'
+        value2 = 'mynewtext'
+        res = 'mytext'
+        # test LCS of strings
+        assert r.stralgo('LCS', value1, value2) == res
+        # test using keys
+        r.mset({key1: value1, key2: value2})
+        assert r.stralgo('LCS', key1, key2, specific_argument="keys") == res
+        # test other labels
+        assert r.stralgo('LCS', value1, value2, len=True) == len(res)
+        assert r.stralgo('LCS', value1, value2, idx=True) == \
+               {
+                   'len': len(res),
+                   'matches': [[(4, 7), (5, 8)], [(2, 3), (0, 1)]]
+               }
+        assert r.stralgo('LCS', value1, value2,
+                         idx=True, withmatchlen=True) == \
+               {
+                   'len': len(res),
+                   'matches': [[4, (4, 7), (5, 8)], [2, (2, 3), (0, 1)]]
+               }
+        assert r.stralgo('LCS', value1, value2,
+                         idx=True, minmatchlen=4, withmatchlen=True) == \
+               {
+                   'len': len(res),
+                   'matches': [[4, (4, 7), (5, 8)]]
+               }
+
+    @skip_if_server_version_lt('6.0.0')
+    def test_stralgo_negative(self, r):
+        with pytest.raises(exceptions.DataError):
+            r.stralgo('ISSUB', 'value1', 'value2')
+        with pytest.raises(exceptions.DataError):
+            r.stralgo('LCS', 'value1', 'value2', len=True, idx=True)
+        with pytest.raises(exceptions.DataError):
+            r.stralgo('LCS', 'value1', 'value2', specific_argument="INT")
+        with pytest.raises(ValueError):
+            r.stralgo('LCS', 'value1', 'value2', idx=True, minmatchlen="one")
+
     def test_strlen(self, r):
         r['a'] = 'foo'
         assert r.strlen('a') == 3

From 41e3f56f65b690ae39ab798a85b42e44ee72a829 Mon Sep 17 00:00:00 2001
From: Ian Bucad <ian.bucad@datadoghq.com>
Date: Sun, 29 Aug 2021 18:40:29 +1000
Subject: [PATCH 0142/1164] Includes slowlog complexity info if available
 (#1489)

* Return slowlog complexity info if available

based on https://github.com/andymccurdy/redis-py/pull/622

* Add tests
Copied from https://github.com/andymccurdy/redis-py/pull/622

* address flake E306

* Trigger Build
---
 redis/client.py        | 28 +++++++++++++++++-----------
 tests/test_commands.py | 29 +++++++++++++++++++++++++++++
 2 files changed, 46 insertions(+), 11 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 3a9a5b6b1b..4a9e33a21e 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -397,17 +397,23 @@ def parse_zmscore(response, **options):
 
 def parse_slowlog_get(response, **options):
     space = ' ' if options.get('decode_responses', False) else b' '
-    return [{
-        'id': item[0],
-        'start_time': int(item[1]),
-        'duration': int(item[2]),
-        'command':
-            # Redis Enterprise injects another entry at index [3], which has
-            # the complexity info (i.e. the value N in case the command has
-            # an O(N) complexity) instead of the command.
-            space.join(item[3]) if isinstance(item[3], list) else
-            space.join(item[4])
-    } for item in response]
+
+    def parse_item(item):
+        result = {
+            'id': item[0],
+            'start_time': int(item[1]),
+            'duration': int(item[2]),
+        }
+        # Redis Enterprise injects another entry at index [3], which has
+        # the complexity info (i.e. the value N in case the command has
+        # an O(N) complexity) instead of the command.
+        if isinstance(item[3], list):
+            result['command'] = space.join(item[3])
+        else:
+            result['complexity'] = item[3]
+            result['command'] = space.join(item[4])
+        return result
+    return [parse_item(item) for item in response]
 
 
 def parse_stralgo(response, **options):
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 4b7957c7dd..0e71fcfc41 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -499,6 +499,35 @@ def test_slowlog_get(self, r, slowlog):
         assert isinstance(slowlog[0]['start_time'], int)
         assert isinstance(slowlog[0]['duration'], int)
 
+        # Mock result if we didn't get slowlog complexity info.
+        if 'complexity' not in slowlog[0]:
+            # monkey patch parse_response()
+            COMPLEXITY_STATEMENT = "Complexity info: N:4712,M:3788"
+            old_parse_response = r.parse_response
+
+            def parse_response(connection, command_name, **options):
+                if command_name != 'SLOWLOG GET':
+                    return old_parse_response(connection,
+                                              command_name,
+                                              **options)
+                responses = connection.read_response()
+                for response in responses:
+                    # Complexity info stored as fourth item in list
+                    response.insert(3, COMPLEXITY_STATEMENT)
+                return r.response_callbacks[command_name](responses, **options)
+            r.parse_response = parse_response
+
+            # test
+            slowlog = r.slowlog_get()
+            assert isinstance(slowlog, list)
+            commands = [log['command'] for log in slowlog]
+            assert get_command in commands
+            idx = commands.index(get_command)
+            assert slowlog[idx]['complexity'] == COMPLEXITY_STATEMENT
+
+            # tear down monkeypatch
+            r.parse_response = old_parse_response
+
     def test_slowlog_get_limit(self, r, slowlog):
         assert r.slowlog_reset()
         r.get('foo')

From efdba1a77a2755c70ba9754aa592dde8c8c50217 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Mon, 30 Aug 2021 09:34:23 +0300
Subject: [PATCH 0143/1164] xgroup_createconsumer (#1553)

---
 redis/commands.py      | 12 ++++++++++++
 tests/test_commands.py | 16 ++++++++++++++++
 2 files changed, 28 insertions(+)

diff --git a/redis/commands.py b/redis/commands.py
index a9b90f0222..29877dbef9 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -1870,6 +1870,18 @@ def xgroup_destroy(self, name, groupname):
         """
         return self.execute_command('XGROUP DESTROY', name, groupname)
 
+    def xgroup_createconsumer(self, name, groupname, consumername):
+        """
+        Consumers in a consumer group are auto-created every time a new
+        consumer name is mentioned by some command.
+        They can be explicitly created by using this command.
+        name: name of the stream.
+        groupname: name of the consumer group.
+        consumername: name of consumer to create.
+        """
+        return self.execute_command('XGROUP CREATECONSUMER', name, groupname,
+                                    consumername)
+
     def xgroup_setid(self, name, groupname, id):
         """
         Set the consumer group last delivered ID to something else.
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 0e71fcfc41..0c9ca1eb57 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2731,6 +2731,22 @@ def test_xgroup_delconsumer(self, r):
         # deleting the consumer should return 2 pending messages
         assert r.xgroup_delconsumer(stream, group, consumer) == 2
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_xgroup_createconsumer(self, r):
+        stream = 'stream'
+        group = 'group'
+        consumer = 'consumer'
+        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {'foo': 'bar'})
+        r.xgroup_create(stream, group, 0)
+        assert r.xgroup_createconsumer(stream, group, consumer) == 1
+
+        # read all messages from the group
+        r.xreadgroup(group, consumer, streams={stream: '>'})
+
+        # deleting the consumer should return 2 pending messages
+        assert r.xgroup_delconsumer(stream, group, consumer) == 2
+
     @skip_if_server_version_lt('5.0.0')
     def test_xgroup_destroy(self, r):
         stream = 'stream'

From de9922ad0fc955668d99748f3ad3be0ccff1f9da Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Wed, 1 Sep 2021 11:44:28 +0300
Subject: [PATCH 0144/1164] Adding EXAT and PXAT (unix time support) support
 for SET (#1547)

* set in unix time

* update skip version
---
 redis/commands.py      | 26 ++++++++++++++++++++++----
 tests/test_commands.py | 12 ++++++++++++
 2 files changed, 34 insertions(+), 4 deletions(-)

diff --git a/redis/commands.py b/redis/commands.py
index 29877dbef9..2d39f5ddf5 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -1014,7 +1014,8 @@ def restore(self, name, ttl, value, replace=False, absttl=False):
         return self.execute_command('RESTORE', *params)
 
     def set(self, name, value,
-            ex=None, px=None, nx=False, xx=False, keepttl=False, get=False):
+            ex=None, px=None, nx=False, xx=False, keepttl=False, get=False,
+            exat=None, pxat=None):
         """
         Set the value at key ``name`` to ``value``
 
@@ -1034,6 +1035,12 @@ def set(self, name, value,
         ``get`` if True, set the value at key ``name`` to ``value`` and return
             the old value stored at key, or None when key did not exist.
             (Available since Redis 6.2)
+
+        ``exat`` sets an expire flag on key ``name`` for ``ex`` seconds,
+            specified in unix time.
+
+        ``pxat`` sets an expire flag on key ``name`` for ``ex`` milliseconds,
+            specified in unix time.
         """
         pieces = [name, value]
         options = {}
@@ -1047,15 +1054,26 @@ def set(self, name, value,
             if isinstance(px, datetime.timedelta):
                 px = int(px.total_seconds() * 1000)
             pieces.append(px)
+        if exat is not None:
+            pieces.append('EXAT')
+            if isinstance(exat, datetime.datetime):
+                s = int(exat.microsecond / 1000000)
+                exat = int(time.mktime(exat.timetuple())) + s
+            pieces.append(exat)
+        if pxat is not None:
+            pieces.append('PXAT')
+            if isinstance(pxat, datetime.datetime):
+                ms = int(pxat.microsecond / 1000)
+                pxat = int(time.mktime(pxat.timetuple())) * 1000 + ms
+            pieces.append(pxat)
+        if keepttl:
+            pieces.append('KEEPTTL')
 
         if nx:
             pieces.append('NX')
         if xx:
             pieces.append('XX')
 
-        if keepttl:
-            pieces.append('KEEPTTL')
-
         if get:
             pieces.append('GET')
             options["get"] = True
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 0c9ca1eb57..2c0137f1e0 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1040,6 +1040,18 @@ def test_set_ex_timedelta(self, r):
         assert r.set('a', '1', ex=expire_at)
         assert 0 < r.ttl('a') <= 60
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_set_exat_timedelta(self, r):
+        expire_at = redis_server_time(r) + datetime.timedelta(seconds=10)
+        assert r.set('a', '1', exat=expire_at)
+        assert 0 < r.ttl('a') <= 10
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_set_pxat_timedelta(self, r):
+        expire_at = redis_server_time(r) + datetime.timedelta(seconds=10)
+        assert r.set('a', '1', pxat=expire_at)
+        assert 0 < r.ttl('a') <= 10
+
     @skip_if_server_version_lt('2.6.0')
     def test_set_multipleoptions(self, r):
         r['a'] = 'val'

From 18c1cc7482d2177809d381e91721f119117849ff Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 1 Sep 2021 11:44:36 +0300
Subject: [PATCH 0145/1164] Support for command count (#1554)

Part of #1546
---
 redis/client.py        | 2 ++
 redis/commands.py      | 3 +++
 tests/test_commands.py | 6 ++++++
 3 files changed, 11 insertions(+)

diff --git a/redis/client.py b/redis/client.py
index 4a9e33a21e..ef375066f1 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -685,6 +685,8 @@ class Redis(Commands, object):
         'CLUSTER SET-CONFIG-EPOCH': bool_ok,
         'CLUSTER SETSLOT': bool_ok,
         'CLUSTER SLAVES': parse_cluster_nodes,
+        'COMMAND': int,
+        'COMMAND COUNT': int,
         'CONFIG GET': parse_config_get,
         'CONFIG RESETSTAT': bool_ok,
         'CONFIG SET': bool_ok,
diff --git a/redis/commands.py b/redis/commands.py
index 2d39f5ddf5..7066bd8209 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -2924,6 +2924,9 @@ def module_list(self):
         """
         return self.execute_command('MODULE LIST')
 
+    def command_count(self):
+        return self.execute_command('COMMAND COUNT')
+
 
 class Script:
     "An executable Lua script object returned by ``register_script``"
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 2c0137f1e0..5a5e8f3b12 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -3240,6 +3240,12 @@ def test_module_list(self, r):
         assert isinstance(r.module_list(), list)
         assert not r.module_list()
 
+    @skip_if_server_version_lt('2.8.13')
+    def test_command_count(self, r):
+        res = r.command_count()
+        assert isinstance(res, int)
+        assert res >= 100
+
 
 class TestBinarySave:
 

From 9f64c56e0f6994df0609a803e613a055ee57a7cd Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 1 Sep 2021 11:44:59 +0300
Subject: [PATCH 0146/1164] bgsave schedule support (#1555)

bgsave tests

Part of #1546
---
 redis/commands.py      | 7 +++++--
 tests/test_commands.py | 5 +++++
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/redis/commands.py b/redis/commands.py
index 7066bd8209..e1f7368809 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -268,12 +268,15 @@ def bgrewriteaof(self):
         "Tell the Redis server to rewrite the AOF file from data in memory."
         return self.execute_command('BGREWRITEAOF')
 
-    def bgsave(self):
+    def bgsave(self, schedule=True):
         """
         Tell the Redis server to save its data to disk.  Unlike save(),
         this method is asynchronous and returns immediately.
         """
-        return self.execute_command('BGSAVE')
+        pieces = []
+        if schedule:
+            pieces.append("SCHEDULE")
+        return self.execute_command('BGSAVE', *pieces)
 
     def client_kill(self, address):
         "Disconnects the client at ``address`` (ip:port)"
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 5a5e8f3b12..1a34712ffc 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -547,6 +547,11 @@ def test_time(self, r):
         assert isinstance(t[0], int)
         assert isinstance(t[1], int)
 
+    def test_bgsave(self, r):
+        assert r.bgsave()
+        time.sleep(0.3)
+        assert r.bgsave(True)
+
     # BASIC KEY COMMANDS
     def test_append(self, r):
         assert r.append('a', 'a1') == 2

From 879584b7a359cfd7eeb008b41ba9ca9be16e6633 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 1 Sep 2021 12:08:38 +0300
Subject: [PATCH 0147/1164] Support for QUIT (#1557)

Part of #1546
---
 redis/client.py        | 1 +
 redis/commands.py      | 6 ++++++
 tests/test_commands.py | 3 +++
 3 files changed, 10 insertions(+)

diff --git a/redis/client.py b/redis/client.py
index ef375066f1..a4d7f6b43a 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -709,6 +709,7 @@ class Redis(Commands, object):
         'MODULE LIST': lambda r: [pairs_to_dict(m) for m in r],
         'OBJECT': parse_object,
         'PING': lambda r: str_if_bytes(r) == 'PONG',
+        'QUIT': bool_ok,
         'STRALGO': parse_stralgo,
         'PUBSUB NUMSUB': parse_pubsub_numsub,
         'RANDOMKEY': lambda r: r and r or None,
diff --git a/redis/commands.py b/redis/commands.py
index e1f7368809..42307799de 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -538,6 +538,12 @@ def ping(self):
         "Ping the Redis server"
         return self.execute_command('PING')
 
+    def quit(self):
+        """Ask the server to close the connection.
+        https://redis.io/commands/quit
+        """
+        return self.execute_command('QUIT')
+
     def save(self):
         """
         Tell the Redis server to save its data to disk,
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 1a34712ffc..d77a01c29a 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -478,6 +478,9 @@ def test_object(self, r):
     def test_ping(self, r):
         assert r.ping()
 
+    def test_quit(self, r):
+        assert r.quit()
+
     def test_slowlog_get(self, r, slowlog):
         assert r.slowlog_reset()
         unicode_string = chr(3456) + 'abcd' + chr(3421)

From 3dc2bf906f634383d33952d36cd78156a6e36e0e Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 1 Sep 2021 13:09:03 +0300
Subject: [PATCH 0148/1164] Adding support for GENPASS bits (#1558)

Part of #1546 commands.
---
 redis/commands.py      | 19 ++++++++++++++++---
 tests/test_commands.py |  8 ++++++++
 2 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/redis/commands.py b/redis/commands.py
index 42307799de..895b00a4b5 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -52,9 +52,22 @@ def acl_deluser(self, username):
         "Delete the ACL for the specified ``username``"
         return self.execute_command('ACL DELUSER', username)
 
-    def acl_genpass(self):
-        "Generate a random password value"
-        return self.execute_command('ACL GENPASS')
+    def acl_genpass(self, bits=None):
+        """Generate a random password value.
+        If ``bits`` is supplied then use this number of bits, rounded to
+        the next multiple of 4.
+        See: https://redis.io/commands/acl-genpass
+        """
+        pieces = []
+        if bits is not None:
+            try:
+                b = int(bits)
+                if b < 0 or b > 4096:
+                    raise ValueError
+            except ValueError:
+                raise DataError('genpass optionally accepts a bits argument, '
+                                'between 0 and 4096.')
+        return self.execute_command('ACL GENPASS', *pieces)
 
     def acl_getuser(self, username):
         """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index d77a01c29a..6877265f66 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -98,6 +98,14 @@ def test_acl_genpass(self, r):
         password = r.acl_genpass()
         assert isinstance(password, str)
 
+        with pytest.raises(exceptions.DataError):
+            r.acl_genpass('value')
+            r.acl_genpass(-5)
+            r.acl_genpass(5555)
+
+        r.acl_genpass(555)
+        assert isinstance(password, str)
+
     @skip_if_server_version_lt(REDIS_6_VERSION)
     def test_acl_getuser_setuser(self, r, request):
         username = 'redis-py-user'

From e53227cf68c065b4d31f39cdde7c85c5e91dd1bf Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 1 Sep 2021 13:10:56 +0300
Subject: [PATCH 0149/1164] LPUSHX support for list, no API changes (#1559)

Part of #1546
---
 redis/commands.py      | 4 ++--
 tests/test_commands.py | 9 +++++++++
 2 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/redis/commands.py b/redis/commands.py
index 895b00a4b5..6e816decff 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -1318,9 +1318,9 @@ def lpush(self, name, *values):
         "Push ``values`` onto the head of the list ``name``"
         return self.execute_command('LPUSH', name, *values)
 
-    def lpushx(self, name, value):
+    def lpushx(self, name, *values):
         "Push ``value`` onto the head of the list ``name`` if ``name`` exists"
-        return self.execute_command('LPUSHX', name, value)
+        return self.execute_command('LPUSHX', name, *values)
 
     def lrange(self, name, start, end):
         """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 6877265f66..169810687f 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1271,6 +1271,15 @@ def test_lpushx(self, r):
         assert r.lpushx('a', '4') == 4
         assert r.lrange('a', 0, -1) == [b'4', b'1', b'2', b'3']
 
+    @skip_if_server_version_lt('4.0.0')
+    def test_lpushx_with_list(self, r):
+        # now with a list
+        r.lpush('somekey', 'a')
+        r.lpush('somekey', 'b')
+        assert r.lpushx('somekey', 'foo', 'asdasd', 55, 'asdasdas') == 6
+        res = r.lrange('somekey', 0, -1)
+        assert res == [b'asdasdas', b'55', b'asdasd', b'foo', b'b', b'a']
+
     def test_lrange(self, r):
         r.rpush('a', '1', '2', '3', '4', '5')
         assert r.lrange('a', 0, 2) == [b'1', b'2', b'3']

From 0f8d0dcbb3a7f759843f3f89e413f9333d027c98 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Wed, 1 Sep 2021 13:13:42 +0300
Subject: [PATCH 0150/1164] GEOSEARCH and GEOSEARCHSTORE (#1526)

* GEOSEARCH and GEOSEARCHSTORE

* negative test

* change georadius_generic to geosearch_generic

* add documentations to the functions

* add docstring to the parser

* farest
---
 redis/client.py        |  16 ++-
 redis/commands.py      | 130 +++++++++++++++++
 tests/test_commands.py | 310 ++++++++++++++++++++++++++++++-----------
 3 files changed, 370 insertions(+), 86 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index a4d7f6b43a..019939a6e8 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -472,10 +472,15 @@ def parse_cluster_nodes(response, **options):
     return dict(_parse_node_line(line) for line in raw_lines)
 
 
-def parse_georadius_generic(response, **options):
+def parse_geosearch_generic(response, **options):
+    """
+    Parse the response of 'GEOSEARCH', GEORADIUS' and 'GEORADIUSBYMEMBER'
+    commands according to 'withdist', 'withhash' and 'withcoord' labels.
+    """
     if options['store'] or options['store_dist']:
-        # `store` and `store_diff` cant be combined
+        # `store` and `store_dist` cant be combined
         # with other command arguments.
+        # relevant to 'GEORADIUS' and 'GEORADIUSBYMEMBER'
         return response
 
     if type(response) != list:
@@ -483,7 +488,7 @@ def parse_georadius_generic(response, **options):
     else:
         response_list = response
 
-    if not options['withdist'] and not options['withcoord']\
+    if not options['withdist'] and not options['withcoord'] \
             and not options['withhash']:
         # just a bunch of places
         return response_list
@@ -695,8 +700,9 @@ class Redis(Commands, object):
         'GEOPOS': lambda r: list(map(lambda ll: (float(ll[0]),
                                      float(ll[1]))
                                      if ll is not None else None, r)),
-        'GEORADIUS': parse_georadius_generic,
-        'GEORADIUSBYMEMBER': parse_georadius_generic,
+        'GEOSEARCH': parse_geosearch_generic,
+        'GEORADIUS': parse_geosearch_generic,
+        'GEORADIUSBYMEMBER': parse_geosearch_generic,
         'HGETALL': lambda r: r and pairs_to_dict(r) or {},
         'HSCAN': parse_hscan,
         'INFO': parse_info,
diff --git a/redis/commands.py b/redis/commands.py
index 6e816decff..4148f987aa 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -2924,6 +2924,136 @@ def _georadiusgeneric(self, command, *args, **kwargs):
 
         return self.execute_command(command, *pieces, **kwargs)
 
+    def geosearch(self, name, member=None, longitude=None, latitude=None,
+                  unit='m', radius=None, width=None, height=None, sort=None,
+                  count=None, any=False, withcoord=False,
+                  withdist=False, withhash=False):
+        """
+        Return the members of specified key identified by the
+        ``name`` argument, which are within the borders of the
+        area specified by a given shape. This command extends the
+        GEORADIUS command, so in addition to searching within circular
+        areas, it supports searching within rectangular areas.
+        This command should be used in place of the deprecated
+        GEORADIUS and GEORADIUSBYMEMBER commands.
+        ``member`` Use the position of the given existing
+         member in the sorted set. Can't be given with ``longitude``
+         and ``latitude``.
+        ``longitude`` and ``latitude`` Use the position given by
+        this coordinates. Can't be given with ``member``
+        ``radius`` Similar to GEORADIUS, search inside circular
+        area according the given radius. Can't be given with
+        ``height`` and ``width``.
+        ``height`` and ``width`` Search inside an axis-aligned
+        rectangle, determined by the given height and width.
+        Can't be given with ``radius``
+        ``unit`` must be one of the following : m, km, mi, ft.
+        `m` for meters (the default value), `km` for kilometers,
+        `mi` for miles and `ft` for feet.
+        ``sort`` indicates to return the places in a sorted way,
+        ASC for nearest to farest and DESC for farest to nearest.
+        ``count`` limit the results to the first count matching items.
+        ``any`` is set to True, the command will return as soon as
+        enough matches are found. Can't be provided without ``count``
+        ``withdist`` indicates to return the distances of each place.
+        ``withcoord`` indicates to return the latitude and longitude of
+        each place.
+        ``withhash`` indicates to return the geohash string of each place.
+        """
+
+        return self._geosearchgeneric('GEOSEARCH',
+                                      name, member=member, longitude=longitude,
+                                      latitude=latitude, unit=unit,
+                                      radius=radius, width=width,
+                                      height=height, sort=sort, count=count,
+                                      any=any, withcoord=withcoord,
+                                      withdist=withdist, withhash=withhash,
+                                      store=None, store_dist=None)
+
+    def geosearchstore(self, dest, name, member=None, longitude=None,
+                       latitude=None, unit='m', radius=None, width=None,
+                       height=None, sort=None, count=None, any=False,
+                       storedist=False):
+        """
+        This command is like GEOSEARCH, but stores the result in
+        ``dest``. By default, it stores the results in the destination
+        sorted set with their geospatial information.
+        if ``store_dist`` set to True, the command will stores the
+        items in a sorted set populated with their distance from the
+        center of the circle or box, as a floating-point number.
+        """
+        return self._geosearchgeneric('GEOSEARCHSTORE',
+                                      dest, name, member=member,
+                                      longitude=longitude, latitude=latitude,
+                                      unit=unit, radius=radius, width=width,
+                                      height=height, sort=sort, count=count,
+                                      any=any, withcoord=None,
+                                      withdist=None, withhash=None,
+                                      store=None, store_dist=storedist)
+
+    def _geosearchgeneric(self, command, *args, **kwargs):
+        pieces = list(args)
+
+        # FROMMEMBER or FROMLONLAT
+        if kwargs['member'] is None:
+            if kwargs['longitude'] is None or kwargs['latitude'] is None:
+                raise DataError("GEOSEARCH must have member or"
+                                " longitude and latitude")
+        if kwargs['member']:
+            if kwargs['longitude'] or kwargs['latitude']:
+                raise DataError("GEOSEARCH member and longitude or latitude"
+                                " cant be set together")
+            pieces.extend([b'FROMMEMBER', kwargs['member']])
+        if kwargs['longitude'] and kwargs['latitude']:
+            pieces.extend([b'FROMLONLAT',
+                           kwargs['longitude'], kwargs['latitude']])
+
+        # BYRADIUS or BYBOX
+        if kwargs['radius'] is None:
+            if kwargs['width'] is None or kwargs['height'] is None:
+                raise DataError("GEOSEARCH must have radius or"
+                                " width and height")
+        if kwargs['unit'] is None:
+            raise DataError("GEOSEARCH must have unit")
+        if kwargs['unit'].lower() not in ('m', 'km', 'mi', 'ft'):
+            raise DataError("GEOSEARCH invalid unit")
+        if kwargs['radius']:
+            if kwargs['width'] or kwargs['height']:
+                raise DataError("GEOSEARCH radius and width or height"
+                                " cant be set together")
+            pieces.extend([b'BYRADIUS', kwargs['radius'], kwargs['unit']])
+        if kwargs['width'] and kwargs['height']:
+            pieces.extend([b'BYBOX',
+                           kwargs['width'], kwargs['height'], kwargs['unit']])
+
+        # sort
+        if kwargs['sort']:
+            if kwargs['sort'].upper() == 'ASC':
+                pieces.append(b'ASC')
+            elif kwargs['sort'].upper() == 'DESC':
+                pieces.append(b'DESC')
+            else:
+                raise DataError("GEOSEARCH invalid sort")
+
+        # count any
+        if kwargs['count']:
+            pieces.extend([b'COUNT', kwargs['count']])
+            if kwargs['any']:
+                pieces.append(b'ANY')
+        elif kwargs['any']:
+            raise DataError("GEOSEARCH any can't be provided without count")
+
+        # other properties
+        for arg_name, byte_repr in (
+                ('withdist', b'WITHDIST'),
+                ('withcoord', b'WITHCOORD'),
+                ('withhash', b'WITHHASH'),
+                ('store_dist', b'STOREDIST')):
+            if kwargs[arg_name]:
+                pieces.append(byte_repr)
+
+        return self.execute_command(command, *pieces, **kwargs)
+
     # MODULE COMMANDS
     def module_load(self, path):
         """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 169810687f..30ad5d59af 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1237,7 +1237,7 @@ def test_linsert(self, r):
         assert r.lrange('a', 0, -1) == [b'1', b'2', b'2.5', b'3']
         assert r.linsert('a', 'before', '2', '1.5') == 5
         assert r.lrange('a', 0, -1) == \
-            [b'1', b'1.5', b'2', b'2.5', b'3']
+               [b'1', b'1.5', b'2', b'2.5', b'3']
 
     def test_llen(self, r):
         r.rpush('a', '1', '2', '3')
@@ -1567,7 +1567,7 @@ def test_zadd(self, r):
         mapping = {'a1': 1.0, 'a2': 2.0, 'a3': 3.0}
         r.zadd('a', mapping)
         assert r.zrange('a', 0, -1, withscores=True) == \
-            [(b'a1', 1.0), (b'a2', 2.0), (b'a3', 3.0)]
+               [(b'a1', 1.0), (b'a2', 2.0), (b'a3', 3.0)]
 
         # error cases
         with pytest.raises(exceptions.DataError):
@@ -1585,19 +1585,19 @@ def test_zadd_nx(self, r):
         assert r.zadd('a', {'a1': 1}) == 1
         assert r.zadd('a', {'a1': 99, 'a2': 2}, nx=True) == 1
         assert r.zrange('a', 0, -1, withscores=True) == \
-            [(b'a1', 1.0), (b'a2', 2.0)]
+               [(b'a1', 1.0), (b'a2', 2.0)]
 
     def test_zadd_xx(self, r):
         assert r.zadd('a', {'a1': 1}) == 1
         assert r.zadd('a', {'a1': 99, 'a2': 2}, xx=True) == 0
         assert r.zrange('a', 0, -1, withscores=True) == \
-            [(b'a1', 99.0)]
+               [(b'a1', 99.0)]
 
     def test_zadd_ch(self, r):
         assert r.zadd('a', {'a1': 1}) == 1
         assert r.zadd('a', {'a1': 99, 'a2': 2}, ch=True) == 2
         assert r.zrange('a', 0, -1, withscores=True) == \
-            [(b'a2', 2.0), (b'a1', 99.0)]
+               [(b'a2', 2.0), (b'a1', 99.0)]
 
     def test_zadd_incr(self, r):
         assert r.zadd('a', {'a1': 1}) == 1
@@ -1694,7 +1694,7 @@ def test_zinterstore_sum(self, r):
         r.zadd('c', {'a1': 6, 'a3': 5, 'a4': 4})
         assert r.zinterstore('d', ['a', 'b', 'c']) == 2
         assert r.zrange('d', 0, -1, withscores=True) == \
-            [(b'a3', 8), (b'a1', 9)]
+               [(b'a3', 8), (b'a1', 9)]
 
     def test_zinterstore_max(self, r):
         r.zadd('a', {'a1': 1, 'a2': 1, 'a3': 1})
@@ -1702,7 +1702,7 @@ def test_zinterstore_max(self, r):
         r.zadd('c', {'a1': 6, 'a3': 5, 'a4': 4})
         assert r.zinterstore('d', ['a', 'b', 'c'], aggregate='MAX') == 2
         assert r.zrange('d', 0, -1, withscores=True) == \
-            [(b'a3', 5), (b'a1', 6)]
+               [(b'a3', 5), (b'a1', 6)]
 
     def test_zinterstore_min(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
@@ -1710,7 +1710,7 @@ def test_zinterstore_min(self, r):
         r.zadd('c', {'a1': 6, 'a3': 5, 'a4': 4})
         assert r.zinterstore('d', ['a', 'b', 'c'], aggregate='MIN') == 2
         assert r.zrange('d', 0, -1, withscores=True) == \
-            [(b'a1', 1), (b'a3', 3)]
+               [(b'a1', 1), (b'a3', 3)]
 
     def test_zinterstore_with_weight(self, r):
         r.zadd('a', {'a1': 1, 'a2': 1, 'a3': 1})
@@ -1718,7 +1718,7 @@ def test_zinterstore_with_weight(self, r):
         r.zadd('c', {'a1': 6, 'a3': 5, 'a4': 4})
         assert r.zinterstore('d', {'a': 1, 'b': 2, 'c': 3}) == 2
         assert r.zrange('d', 0, -1, withscores=True) == \
-            [(b'a3', 20), (b'a1', 23)]
+               [(b'a3', 20), (b'a1', 23)]
 
     @skip_if_server_version_lt('4.9.0')
     def test_zpopmax(self, r):
@@ -1727,7 +1727,7 @@ def test_zpopmax(self, r):
 
         # with count
         assert r.zpopmax('a', count=2) == \
-            [(b'a2', 2), (b'a1', 1)]
+               [(b'a2', 2), (b'a1', 1)]
 
     @skip_if_server_version_lt('4.9.0')
     def test_zpopmin(self, r):
@@ -1736,7 +1736,7 @@ def test_zpopmin(self, r):
 
         # with count
         assert r.zpopmin('a', count=2) == \
-            [(b'a2', 2), (b'a3', 3)]
+               [(b'a2', 2), (b'a3', 3)]
 
     @skip_if_server_version_lt('6.2.0')
     def test_zrandemember(self, r):
@@ -1781,13 +1781,13 @@ def test_zrange(self, r):
 
         # withscores
         assert r.zrange('a', 0, 1, withscores=True) == \
-            [(b'a1', 1.0), (b'a2', 2.0)]
+               [(b'a1', 1.0), (b'a2', 2.0)]
         assert r.zrange('a', 1, 2, withscores=True) == \
-            [(b'a2', 2.0), (b'a3', 3.0)]
+               [(b'a2', 2.0), (b'a3', 3.0)]
 
         # custom score function
         assert r.zrange('a', 0, 1, withscores=True, score_cast_func=int) == \
-            [(b'a1', 1), (b'a2', 2)]
+               [(b'a1', 1), (b'a2', 2)]
 
     @skip_if_server_version_lt('6.2.0')
     def test_zrangestore(self, r):
@@ -1805,7 +1805,7 @@ def test_zrangebylex(self, r):
         assert r.zrangebylex('a', '-', '[c') == [b'a', b'b', b'c']
         assert r.zrangebylex('a', '-', '(c') == [b'a', b'b']
         assert r.zrangebylex('a', '[aaa', '(g') == \
-            [b'b', b'c', b'd', b'e', b'f']
+               [b'b', b'c', b'd', b'e', b'f']
         assert r.zrangebylex('a', '[f', '+') == [b'f', b'g']
         assert r.zrangebylex('a', '-', '+', start=3, num=2) == [b'd', b'e']
 
@@ -1815,10 +1815,10 @@ def test_zrevrangebylex(self, r):
         assert r.zrevrangebylex('a', '[c', '-') == [b'c', b'b', b'a']
         assert r.zrevrangebylex('a', '(c', '-') == [b'b', b'a']
         assert r.zrevrangebylex('a', '(g', '[aaa') == \
-            [b'f', b'e', b'd', b'c', b'b']
+               [b'f', b'e', b'd', b'c', b'b']
         assert r.zrevrangebylex('a', '+', '[f') == [b'g', b'f']
         assert r.zrevrangebylex('a', '+', '-', start=3, num=2) == \
-            [b'd', b'c']
+               [b'd', b'c']
 
     def test_zrangebyscore(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3, 'a4': 4, 'a5': 5})
@@ -1826,16 +1826,16 @@ def test_zrangebyscore(self, r):
 
         # slicing with start/num
         assert r.zrangebyscore('a', 2, 4, start=1, num=2) == \
-            [b'a3', b'a4']
+               [b'a3', b'a4']
 
         # withscores
         assert r.zrangebyscore('a', 2, 4, withscores=True) == \
-            [(b'a2', 2.0), (b'a3', 3.0), (b'a4', 4.0)]
+               [(b'a2', 2.0), (b'a3', 3.0), (b'a4', 4.0)]
 
         # custom score function
         assert r.zrangebyscore('a', 2, 4, withscores=True,
                                score_cast_func=int) == \
-            [(b'a2', 2), (b'a3', 3), (b'a4', 4)]
+               [(b'a2', 2), (b'a3', 3), (b'a4', 4)]
 
     def test_zrank(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3, 'a4': 4, 'a5': 5})
@@ -1884,14 +1884,14 @@ def test_zrevrange(self, r):
 
         # withscores
         assert r.zrevrange('a', 0, 1, withscores=True) == \
-            [(b'a3', 3.0), (b'a2', 2.0)]
+               [(b'a3', 3.0), (b'a2', 2.0)]
         assert r.zrevrange('a', 1, 2, withscores=True) == \
-            [(b'a2', 2.0), (b'a1', 1.0)]
+               [(b'a2', 2.0), (b'a1', 1.0)]
 
         # custom score function
         assert r.zrevrange('a', 0, 1, withscores=True,
                            score_cast_func=int) == \
-            [(b'a3', 3.0), (b'a2', 2.0)]
+               [(b'a3', 3.0), (b'a2', 2.0)]
 
     def test_zrevrangebyscore(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3, 'a4': 4, 'a5': 5})
@@ -1899,16 +1899,16 @@ def test_zrevrangebyscore(self, r):
 
         # slicing with start/num
         assert r.zrevrangebyscore('a', 4, 2, start=1, num=2) == \
-            [b'a3', b'a2']
+               [b'a3', b'a2']
 
         # withscores
         assert r.zrevrangebyscore('a', 4, 2, withscores=True) == \
-            [(b'a4', 4.0), (b'a3', 3.0), (b'a2', 2.0)]
+               [(b'a4', 4.0), (b'a3', 3.0), (b'a2', 2.0)]
 
         # custom score function
         assert r.zrevrangebyscore('a', 4, 2, withscores=True,
                                   score_cast_func=int) == \
-            [(b'a4', 4), (b'a3', 3), (b'a2', 2)]
+               [(b'a4', 4), (b'a3', 3), (b'a2', 2)]
 
     def test_zrevrank(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3, 'a4': 4, 'a5': 5})
@@ -1948,7 +1948,7 @@ def test_zunionstore_sum(self, r):
         r.zadd('c', {'a1': 6, 'a3': 5, 'a4': 4})
         assert r.zunionstore('d', ['a', 'b', 'c']) == 4
         assert r.zrange('d', 0, -1, withscores=True) == \
-            [(b'a2', 3), (b'a4', 4), (b'a3', 8), (b'a1', 9)]
+               [(b'a2', 3), (b'a4', 4), (b'a3', 8), (b'a1', 9)]
 
     def test_zunionstore_max(self, r):
         r.zadd('a', {'a1': 1, 'a2': 1, 'a3': 1})
@@ -1956,7 +1956,7 @@ def test_zunionstore_max(self, r):
         r.zadd('c', {'a1': 6, 'a3': 5, 'a4': 4})
         assert r.zunionstore('d', ['a', 'b', 'c'], aggregate='MAX') == 4
         assert r.zrange('d', 0, -1, withscores=True) == \
-            [(b'a2', 2), (b'a4', 4), (b'a3', 5), (b'a1', 6)]
+               [(b'a2', 2), (b'a4', 4), (b'a3', 5), (b'a1', 6)]
 
     def test_zunionstore_min(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
@@ -1964,7 +1964,7 @@ def test_zunionstore_min(self, r):
         r.zadd('c', {'a1': 6, 'a3': 5, 'a4': 4})
         assert r.zunionstore('d', ['a', 'b', 'c'], aggregate='MIN') == 4
         assert r.zrange('d', 0, -1, withscores=True) == \
-            [(b'a1', 1), (b'a2', 2), (b'a3', 3), (b'a4', 4)]
+               [(b'a1', 1), (b'a2', 2), (b'a3', 3), (b'a4', 4)]
 
     def test_zunionstore_with_weight(self, r):
         r.zadd('a', {'a1': 1, 'a2': 1, 'a3': 1})
@@ -1972,7 +1972,7 @@ def test_zunionstore_with_weight(self, r):
         r.zadd('c', {'a1': 6, 'a3': 5, 'a4': 4})
         assert r.zunionstore('d', {'a': 1, 'b': 2, 'c': 3}) == 4
         assert r.zrange('d', 0, -1, withscores=True) == \
-            [(b'a2', 5), (b'a4', 12), (b'a3', 20), (b'a1', 23)]
+               [(b'a2', 5), (b'a4', 12), (b'a3', 20), (b'a1', 23)]
 
     @skip_if_server_version_lt('6.1.240')
     def test_zmscore(self, r):
@@ -2153,7 +2153,7 @@ def test_sort_get_multi(self, r):
         r['user:3'] = 'u3'
         r.rpush('a', '2', '3', '1')
         assert r.sort('a', get=('user:*', '#')) == \
-            [b'u1', b'1', b'u2', b'2', b'u3', b'3']
+               [b'u1', b'1', b'u2', b'2', b'u3', b'3']
 
     def test_sort_get_groups_two(self, r):
         r['user:1'] = 'u1'
@@ -2161,7 +2161,7 @@ def test_sort_get_groups_two(self, r):
         r['user:3'] = 'u3'
         r.rpush('a', '2', '3', '1')
         assert r.sort('a', get=('user:*', '#'), groups=True) == \
-            [(b'u1', b'1'), (b'u2', b'2'), (b'u3', b'3')]
+               [(b'u1', b'1'), (b'u2', b'2'), (b'u3', b'3')]
 
     def test_sort_groups_string_get(self, r):
         r['user:1'] = 'u1'
@@ -2196,11 +2196,11 @@ def test_sort_groups_three_gets(self, r):
         r['door:3'] = 'd3'
         r.rpush('a', '2', '3', '1')
         assert r.sort('a', get=('user:*', 'door:*', '#'), groups=True) == \
-            [
-                (b'u1', b'd1', b'1'),
-                (b'u2', b'd2', b'2'),
-                (b'u3', b'd3', b'3')
-        ]
+               [
+                   (b'u1', b'd1', b'1'),
+                   (b'u2', b'd2', b'2'),
+                   (b'u3', b'd3', b'3')
+               ]
 
     def test_sort_desc(self, r):
         r.rpush('a', '2', '3', '1')
@@ -2209,7 +2209,7 @@ def test_sort_desc(self, r):
     def test_sort_alpha(self, r):
         r.rpush('a', 'e', 'c', 'b', 'd', 'a')
         assert r.sort('a', alpha=True) == \
-            [b'a', b'b', b'c', b'd', b'e']
+               [b'a', b'b', b'c', b'd', b'e']
 
     def test_sort_store(self, r):
         r.rpush('a', '2', '3', '1')
@@ -2241,7 +2241,7 @@ def test_sort_all_options(self, r):
                      store='sorted')
         assert num == 4
         assert r.lrange('sorted', 0, 10) == \
-            [b'vodka', b'milk', b'gin', b'apple juice']
+               [b'vodka', b'milk', b'gin', b'apple juice']
 
     def test_sort_issue_924(self, r):
         # Tests for issue https://github.com/andymccurdy/redis-py/issues/924
@@ -2314,7 +2314,7 @@ def test_readonly(self, mock_cluster_resp_ok):
     # GEO COMMANDS
     @skip_if_server_version_lt('3.2.0')
     def test_geoadd(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') +\
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
 
         assert r.geoadd('barcelona', *values) == 2
@@ -2327,7 +2327,7 @@ def test_geoadd_invalid_params(self, r):
 
     @skip_if_server_version_lt('3.2.0')
     def test_geodist(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') +\
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
 
         assert r.geoadd('barcelona', *values) == 2
@@ -2335,7 +2335,7 @@ def test_geodist(self, r):
 
     @skip_if_server_version_lt('3.2.0')
     def test_geodist_units(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') +\
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
 
         r.geoadd('barcelona', *values)
@@ -2354,24 +2354,24 @@ def test_geodist_invalid_units(self, r):
 
     @skip_if_server_version_lt('3.2.0')
     def test_geohash(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') +\
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
 
         r.geoadd('barcelona', *values)
-        assert r.geohash('barcelona', 'place1', 'place2', 'place3') ==\
-            ['sp3e9yg3kd0', 'sp3e9cbc3t0', None]
+        assert r.geohash('barcelona', 'place1', 'place2', 'place3') == \
+               ['sp3e9yg3kd0', 'sp3e9cbc3t0', None]
 
     @skip_unless_arch_bits(64)
     @skip_if_server_version_lt('3.2.0')
     def test_geopos(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') +\
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
 
         r.geoadd('barcelona', *values)
         # redis uses 52 bits precision, hereby small errors may be introduced.
-        assert r.geopos('barcelona', 'place1', 'place2') ==\
-            [(2.19093829393386841, 41.43379028184083523),
-             (2.18737632036209106, 41.40634178640635099)]
+        assert r.geopos('barcelona', 'place1', 'place2') == \
+               [(2.19093829393386841, 41.43379028184083523),
+                (2.18737632036209106, 41.40634178640635099)]
 
     @skip_if_server_version_lt('4.0.0')
     def test_geopos_no_value(self, r):
@@ -2382,9 +2382,157 @@ def test_geopos_no_value(self, r):
     def test_old_geopos_no_value(self, r):
         assert r.geopos('barcelona', 'place1', 'place2') == []
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_geosearch(self, r):
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
+                 (2.1873744593677, 41.406342043777, b'\x80place2') + \
+                 (2.583333, 41.316667, 'place3')
+        r.geoadd('barcelona', *values)
+        assert r.geosearch('barcelona', longitude=2.191,
+                           latitude=41.433, radius=1000) == [b'place1']
+        assert r.geosearch('barcelona', longitude=2.187,
+                           latitude=41.406, radius=1000) == [b'\x80place2']
+        assert r.geosearch('barcelona', longitude=2.191, latitude=41.433,
+                           height=1000, width=1000) == [b'place1']
+        assert r.geosearch('barcelona', member='place3', radius=100,
+                           unit='km') == [b'\x80place2', b'place1', b'place3']
+        # test count
+        assert r.geosearch('barcelona', member='place3', radius=100,
+                           unit='km', count=2) == [b'place3', b'\x80place2']
+        assert r.geosearch('barcelona', member='place3', radius=100,
+                           unit='km', count=1, any=1)[0] \
+               in [b'place1', b'place3', b'\x80place2']
+
+    @skip_unless_arch_bits(64)
+    @skip_if_server_version_lt('6.2.0')
+    def test_geosearch_member(self, r):
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
+                 (2.1873744593677, 41.406342043777, b'\x80place2')
+
+        r.geoadd('barcelona', *values)
+        assert r.geosearch('barcelona', member='place1', radius=4000) == \
+               [b'\x80place2', b'place1']
+        assert r.geosearch('barcelona', member='place1', radius=10) == \
+               [b'place1']
+
+        assert r.geosearch('barcelona', member='place1', radius=4000,
+                           withdist=True,
+                           withcoord=True,
+                           withhash=True) == \
+               [[b'\x80place2', 3067.4157, 3471609625421029,
+                 (2.187376320362091, 41.40634178640635)],
+               [b'place1', 0.0, 3471609698139488,
+                (2.1909382939338684, 41.433790281840835)]]
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_geosearch_sort(self, r):
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
+                 (2.1873744593677, 41.406342043777, 'place2')
+        r.geoadd('barcelona', *values)
+        assert r.geosearch('barcelona', longitude=2.191,
+                           latitude=41.433, radius=3000, sort='ASC') == \
+               [b'place1', b'place2']
+        assert r.geosearch('barcelona', longitude=2.191,
+                           latitude=41.433, radius=3000, sort='DESC') == \
+               [b'place2', b'place1']
+
+    @skip_unless_arch_bits(64)
+    @skip_if_server_version_lt('6.2.0')
+    def test_geosearch_with(self, r):
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
+                 (2.1873744593677, 41.406342043777, 'place2')
+        r.geoadd('barcelona', *values)
+
+        # test a bunch of combinations to test the parse response
+        # function.
+        assert r.geosearch('barcelona', longitude=2.191, latitude=41.433,
+                           radius=1, unit='km', withdist=True,
+                           withcoord=True, withhash=True) == \
+               [[b'place1', 0.0881, 3471609698139488,
+                 (2.19093829393386841, 41.43379028184083523)]]
+        assert r.geosearch('barcelona', longitude=2.191, latitude=41.433,
+                           radius=1, unit='km',
+                           withdist=True, withcoord=True) == \
+               [[b'place1', 0.0881,
+                 (2.19093829393386841, 41.43379028184083523)]]
+        assert r.geosearch('barcelona', longitude=2.191, latitude=41.433,
+                           radius=1, unit='km',
+                           withhash=True, withcoord=True) == \
+               [[b'place1', 3471609698139488,
+                 (2.19093829393386841, 41.43379028184083523)]]
+        # test no values.
+        assert r.geosearch('barcelona', longitude=2, latitude=1,
+                           radius=1, unit='km', withdist=True,
+                           withcoord=True, withhash=True) == []
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_geosearch_negative(self, r):
+        # not specifying member nor longitude and latitude
+        with pytest.raises(exceptions.DataError):
+            assert r.geosearch('barcelona')
+        # specifying member and longitude and latitude
+        with pytest.raises(exceptions.DataError):
+            assert r.geosearch('barcelona',
+                               member="Paris", longitude=2, latitude=1)
+        # specifying one of longitude and latitude
+        with pytest.raises(exceptions.DataError):
+            assert r.geosearch('barcelona', longitude=2)
+        with pytest.raises(exceptions.DataError):
+            assert r.geosearch('barcelona', latitude=2)
+
+        # not specifying radius nor width and height
+        with pytest.raises(exceptions.DataError):
+            assert r.geosearch('barcelona', member="Paris")
+        # specifying radius and width and height
+        with pytest.raises(exceptions.DataError):
+            assert r.geosearch('barcelona', member="Paris",
+                               radius=3, width=2, height=1)
+        # specifying one of width and height
+        with pytest.raises(exceptions.DataError):
+            assert r.geosearch('barcelona', member="Paris", width=2)
+        with pytest.raises(exceptions.DataError):
+            assert r.geosearch('barcelona', member="Paris", height=2)
+
+        # invalid sort
+        with pytest.raises(exceptions.DataError):
+            assert r.geosearch('barcelona',
+                               member="Paris", width=2, height=2, sort="wrong")
+
+        # invalid unit
+        with pytest.raises(exceptions.DataError):
+            assert r.geosearch('barcelona',
+                               member="Paris", width=2, height=2, unit="miles")
+
+        # use any without count
+        with pytest.raises(exceptions.DataError):
+            assert r.geosearch('barcelona', member='place3', radius=100, any=1)
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_geosearchstore(self, r):
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
+                 (2.1873744593677, 41.406342043777, 'place2')
+
+        r.geoadd('barcelona', *values)
+        r.geosearchstore('places_barcelona', 'barcelona',
+                         longitude=2.191, latitude=41.433, radius=1000)
+        assert r.zrange('places_barcelona', 0, -1) == [b'place1']
+
+    @skip_unless_arch_bits(64)
+    @skip_if_server_version_lt('6.2.0')
+    def test_geosearchstore_dist(self, r):
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
+                 (2.1873744593677, 41.406342043777, 'place2')
+
+        r.geoadd('barcelona', *values)
+        r.geosearchstore('places_barcelona', 'barcelona',
+                         longitude=2.191, latitude=41.433,
+                         radius=1000, storedist=True)
+        # instead of save the geo score, the distance is saved.
+        assert r.zscore('places_barcelona', 'place1') == 88.05060698409301
+
     @skip_if_server_version_lt('3.2.0')
     def test_georadius(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') +\
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, b'\x80place2')
 
         r.geoadd('barcelona', *values)
@@ -2393,7 +2541,7 @@ def test_georadius(self, r):
 
     @skip_if_server_version_lt('3.2.0')
     def test_georadius_no_values(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') +\
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
 
         r.geoadd('barcelona', *values)
@@ -2401,17 +2549,17 @@ def test_georadius_no_values(self, r):
 
     @skip_if_server_version_lt('3.2.0')
     def test_georadius_units(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') +\
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
 
         r.geoadd('barcelona', *values)
-        assert r.georadius('barcelona', 2.191, 41.433, 1, unit='km') ==\
-            [b'place1']
+        assert r.georadius('barcelona', 2.191, 41.433, 1, unit='km') == \
+               [b'place1']
 
     @skip_unless_arch_bits(64)
     @skip_if_server_version_lt('3.2.0')
     def test_georadius_with(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') +\
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
 
         r.geoadd('barcelona', *values)
@@ -2419,19 +2567,19 @@ def test_georadius_with(self, r):
         # test a bunch of combinations to test the parse response
         # function.
         assert r.georadius('barcelona', 2.191, 41.433, 1, unit='km',
-                           withdist=True, withcoord=True, withhash=True) ==\
-            [[b'place1', 0.0881, 3471609698139488,
-              (2.19093829393386841, 41.43379028184083523)]]
+                           withdist=True, withcoord=True, withhash=True) == \
+               [[b'place1', 0.0881, 3471609698139488,
+                 (2.19093829393386841, 41.43379028184083523)]]
 
         assert r.georadius('barcelona', 2.191, 41.433, 1, unit='km',
-                           withdist=True, withcoord=True) ==\
-            [[b'place1', 0.0881,
-              (2.19093829393386841, 41.43379028184083523)]]
+                           withdist=True, withcoord=True) == \
+               [[b'place1', 0.0881,
+                 (2.19093829393386841, 41.43379028184083523)]]
 
         assert r.georadius('barcelona', 2.191, 41.433, 1, unit='km',
-                           withhash=True, withcoord=True) ==\
-            [[b'place1', 3471609698139488,
-              (2.19093829393386841, 41.43379028184083523)]]
+                           withhash=True, withcoord=True) == \
+               [[b'place1', 3471609698139488,
+                 (2.19093829393386841, 41.43379028184083523)]]
 
         # test no values.
         assert r.georadius('barcelona', 2, 1, 1, unit='km',
@@ -2439,27 +2587,27 @@ def test_georadius_with(self, r):
 
     @skip_if_server_version_lt('3.2.0')
     def test_georadius_count(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') +\
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
 
         r.geoadd('barcelona', *values)
-        assert r.georadius('barcelona', 2.191, 41.433, 3000, count=1) ==\
-            [b'place1']
+        assert r.georadius('barcelona', 2.191, 41.433, 3000, count=1) == \
+               [b'place1']
 
     @skip_if_server_version_lt('3.2.0')
     def test_georadius_sort(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') +\
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
 
         r.geoadd('barcelona', *values)
-        assert r.georadius('barcelona', 2.191, 41.433, 3000, sort='ASC') ==\
-            [b'place1', b'place2']
-        assert r.georadius('barcelona', 2.191, 41.433, 3000, sort='DESC') ==\
-            [b'place2', b'place1']
+        assert r.georadius('barcelona', 2.191, 41.433, 3000, sort='ASC') == \
+               [b'place1', b'place2']
+        assert r.georadius('barcelona', 2.191, 41.433, 3000, sort='DESC') == \
+               [b'place2', b'place1']
 
     @skip_if_server_version_lt('3.2.0')
     def test_georadius_store(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') +\
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
 
         r.geoadd('barcelona', *values)
@@ -2469,7 +2617,7 @@ def test_georadius_store(self, r):
     @skip_unless_arch_bits(64)
     @skip_if_server_version_lt('3.2.0')
     def test_georadius_store_dist(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') +\
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
 
         r.geoadd('barcelona', *values)
@@ -2481,20 +2629,20 @@ def test_georadius_store_dist(self, r):
     @skip_unless_arch_bits(64)
     @skip_if_server_version_lt('3.2.0')
     def test_georadiusmember(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') +\
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, b'\x80place2')
 
         r.geoadd('barcelona', *values)
-        assert r.georadiusbymember('barcelona', 'place1', 4000) ==\
-            [b'\x80place2', b'place1']
+        assert r.georadiusbymember('barcelona', 'place1', 4000) == \
+               [b'\x80place2', b'place1']
         assert r.georadiusbymember('barcelona', 'place1', 10) == [b'place1']
 
         assert r.georadiusbymember('barcelona', 'place1', 4000,
                                    withdist=True, withcoord=True,
-                                   withhash=True) ==\
-            [[b'\x80place2', 3067.4157, 3471609625421029,
-                (2.187376320362091, 41.40634178640635)],
-             [b'place1', 0.0, 3471609698139488,
+                                   withhash=True) == \
+               [[b'\x80place2', 3067.4157, 3471609625421029,
+                 (2.187376320362091, 41.40634178640635)],
+                [b'place1', 0.0, 3471609698139488,
                  (2.1909382939338684, 41.433790281840835)]]
 
     @skip_if_server_version_lt('5.0.0')

From 51516cbd16b538584b7ea8c6a0cdbc76cda3d90a Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 1 Sep 2021 13:42:37 +0300
Subject: [PATCH 0151/1164] Support for CLIENT TRACKINFO (#1560)

Part of #1546
---
 redis/client.py        | 1 +
 redis/commands.py      | 7 +++++++
 tests/test_commands.py | 6 ++++++
 3 files changed, 14 insertions(+)

diff --git a/redis/client.py b/redis/client.py
index 019939a6e8..6eee3911ec 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -674,6 +674,7 @@ class Redis(Commands, object):
         'CLIENT SETNAME': bool_ok,
         'CLIENT UNBLOCK': lambda r: r and int(r) == 1 or False,
         'CLIENT PAUSE': bool_ok,
+        'CLIENT TRACKINGINFO': lambda r: list(map(str_if_bytes, r)),
         'CLUSTER ADDSLOTS': bool_ok,
         'CLUSTER COUNT-FAILURE-REPORTS': lambda x: int(x),
         'CLUSTER COUNTKEYSINSLOT': lambda x: int(x),
diff --git a/redis/commands.py b/redis/commands.py
index 4148f987aa..27276bc220 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -369,6 +369,13 @@ def client_id(self):
         "Returns the current connection id"
         return self.execute_command('CLIENT ID')
 
+    def client_trackinginfo(self):
+        """Returns the information about the current client connection's
+        use of the server assisted client side cache.
+        See https://redis.io/commands/client-trackinginfo
+        """
+        return self.execute_command('CLIENT TRACKINGINFO')
+
     def client_setname(self, name):
         "Sets the current connection name"
         return self.execute_command('CLIENT SETNAME', name)
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 30ad5d59af..fd77cc873a 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -315,6 +315,12 @@ def test_client_list_client_id(self, r):
     def test_client_id(self, r):
         assert r.client_id() > 0
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_client_trackinginfo(self, r):
+        res = r.client_trackinginfo()
+        assert len(res) > 2
+        assert 'prefixes' in res
+
     @skip_if_server_version_lt('5.0.0')
     def test_client_unblock(self, r):
         myid = r.client_id()

From da6e3524622c9e9862ac57de60d9f188e106b29d Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 1 Sep 2021 14:57:07 +0300
Subject: [PATCH 0152/1164] Adding DELUSER list of users support (#1562)

Adding support for ACL help

Part of #1546
---
 redis/client.py        |  1 +
 redis/commands.py      | 10 ++++++++--
 tests/test_commands.py | 17 +++++++++++++++++
 3 files changed, 26 insertions(+), 2 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 6eee3911ec..8979280a56 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -659,6 +659,7 @@ class Redis(Commands, object):
         'ACL DELUSER': int,
         'ACL GENPASS': str_if_bytes,
         'ACL GETUSER': parse_acl_getuser,
+        'ACL HELP': lambda r: list(map(str_if_bytes, r)),
         'ACL LIST': lambda r: list(map(str_if_bytes, r)),
         'ACL LOAD': bool_ok,
         'ACL LOG': parse_acl_log,
diff --git a/redis/commands.py b/redis/commands.py
index 27276bc220..c49f04388a 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -48,9 +48,9 @@ def acl_cat(self, category=None):
         pieces = [category] if category else []
         return self.execute_command('ACL CAT', *pieces)
 
-    def acl_deluser(self, username):
+    def acl_deluser(self, *username):
         "Delete the ACL for the specified ``username``"
-        return self.execute_command('ACL DELUSER', username)
+        return self.execute_command('ACL DELUSER', *username)
 
     def acl_genpass(self, bits=None):
         """Generate a random password value.
@@ -77,6 +77,12 @@ def acl_getuser(self, username):
         """
         return self.execute_command('ACL GETUSER', username)
 
+    def acl_help(self):
+        """The ACL HELP command returns helpful text describing
+        the different subcommands.
+        """
+        return self.execute_command('ACL HELP')
+
     def acl_list(self):
         "Return a list of all ACLs on the server"
         return self.execute_command('ACL LIST')
diff --git a/tests/test_commands.py b/tests/test_commands.py
index fd77cc873a..fde1c0119c 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -93,6 +93,17 @@ def teardown():
         assert r.acl_setuser(username, enabled=False, reset=True)
         assert r.acl_deluser(username) == 1
 
+        # now, a group of users
+        users = ['bogususer_%d' % r for r in range(0, 5)]
+        for u in users:
+            r.acl_setuser(u, enabled=False, reset=True)
+        assert r.acl_deluser(*users) > 1
+        assert r.acl_getuser(users[0]) is None
+        assert r.acl_getuser(users[1]) is None
+        assert r.acl_getuser(users[2]) is None
+        assert r.acl_getuser(users[3]) is None
+        assert r.acl_getuser(users[4]) is None
+
     @skip_if_server_version_lt(REDIS_6_VERSION)
     def test_acl_genpass(self, r):
         password = r.acl_genpass()
@@ -193,6 +204,12 @@ def teardown():
                              hashed_passwords=['-' + hashed_password])
         assert len(r.acl_getuser(username)['passwords']) == 1
 
+    @skip_if_server_version_lt(REDIS_6_VERSION)
+    def test_acl_help(self, r):
+        res = r.acl_help()
+        assert isinstance(res, list)
+        assert len(res) != 0
+
     @skip_if_server_version_lt(REDIS_6_VERSION)
     def test_acl_list(self, r, request):
         username = 'redis-py-user'

From b6ecd0d6b7e6848dd085c3644ed31598fb1c9f83 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 1 Sep 2021 17:08:59 +0300
Subject: [PATCH 0153/1164] fixing timing issues in set pxat test (#1566)

closes #1561
---
 tests/test_commands.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/test_commands.py b/tests/test_commands.py
index fde1c0119c..24c528d2d2 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1087,9 +1087,9 @@ def test_set_exat_timedelta(self, r):
 
     @skip_if_server_version_lt('6.2.0')
     def test_set_pxat_timedelta(self, r):
-        expire_at = redis_server_time(r) + datetime.timedelta(seconds=10)
+        expire_at = redis_server_time(r) + datetime.timedelta(seconds=50)
         assert r.set('a', '1', pxat=expire_at)
-        assert 0 < r.ttl('a') <= 10
+        assert 0 < r.ttl('a') <= 100
 
     @skip_if_server_version_lt('2.6.0')
     def test_set_multipleoptions(self, r):

From febede19423c95515a7548cd73aa1a90c639ba1f Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 1 Sep 2021 17:09:41 +0300
Subject: [PATCH 0154/1164] Pipeline DISCARD support (#1565)

closes #1539

Part of #1546
---
 redis/client.py        |  6 ++++++
 tests/test_pipeline.py | 28 +++++++++++++++++++++++++++-
 2 files changed, 33 insertions(+), 1 deletion(-)

diff --git a/redis/client.py b/redis/client.py
index 8979280a56..7a022a0671 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1810,6 +1810,12 @@ def execute(self, raise_on_error=True):
         finally:
             self.reset()
 
+    def discard(self):
+        """Flushes all previously queued commands
+        See: https://redis.io/commands/DISCARD
+        """
+        self.execute_command("DISCARD")
+
     def watch(self, *names):
         "Watches the values at keys ``names``"
         if self.explicit_transaction:
diff --git a/tests/test_pipeline.py b/tests/test_pipeline.py
index 9bc4a9f4d9..08bd40bacd 100644
--- a/tests/test_pipeline.py
+++ b/tests/test_pipeline.py
@@ -1,7 +1,7 @@
 import pytest
 
 import redis
-from .conftest import wait_for_command
+from .conftest import wait_for_command, skip_if_server_version_lt
 
 
 class TestPipeline:
@@ -353,3 +353,29 @@ def test_pipeline_with_bitfield(self, r):
 
             assert pipe == pipe2
             assert response == [True, [0, 0, 15, 15, 14], b'1']
+
+    @skip_if_server_version_lt('2.0.0')
+    def test_pipeline_discard(self, r):
+
+        # empty pipeline should raise an error
+        with r.pipeline() as pipe:
+            pipe.set('key', 'someval')
+            pipe.discard()
+            with pytest.raises(redis.exceptions.ResponseError):
+                pipe.execute()
+
+        # setting a pipeline and discarding should do the same
+        with r.pipeline() as pipe:
+            pipe.set('key', 'someval')
+            pipe.set('someotherkey', 'val')
+            response = pipe.execute()
+            pipe.set('key', 'another value!')
+            pipe.discard()
+            pipe.set('key', 'another vae!')
+            with pytest.raises(redis.exceptions.ResponseError):
+                pipe.execute()
+
+            pipe.set('foo', 'bar')
+            response = pipe.execute()
+        assert response[0]
+        assert r.get('foo') == b'bar'

From 42a050c6c0d120104c7433e825e7a798ba411e55 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 1 Sep 2021 17:14:55 +0300
Subject: [PATCH 0155/1164] CLIENT LIST fix to allow multiple client_ids
 (#1563)

* CLIENT LIST fix to allow multiple client_ids

Support for CLIENT KILL with the USER filter

Part of #1546

* test fix
---
 redis/commands.py      | 15 ++++++++++-----
 tests/test_commands.py | 25 ++++++++++++++++++++++---
 2 files changed, 32 insertions(+), 8 deletions(-)

diff --git a/redis/commands.py b/redis/commands.py
index c49f04388a..7f7e00f2c8 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -302,7 +302,7 @@ def client_kill(self, address):
         return self.execute_command('CLIENT KILL', address)
 
     def client_kill_filter(self, _id=None, _type=None, addr=None,
-                           skipme=None, laddr=None):
+                           skipme=None, laddr=None, user=None):
         """
         Disconnects client(s) using a variety of filter options
         :param id: Kills a client by its unique ID field
@@ -310,7 +310,8 @@ def client_kill_filter(self, _id=None, _type=None, addr=None,
         'master', 'slave' or 'pubsub'
         :param addr: Kills a client by its 'address:port'
         :param skipme: If True, then the client calling the command
-        :param laddr: Kills a cient by its 'local (bind)  address:port'
+        :param laddr: Kills a client by its 'local (bind)  address:port'
+        :param user: Kills a client for a specific user name
         will not get killed even if it is identified by one of the filter
         options. If skipme is not provided, the server defaults to skipme=True
         """
@@ -334,6 +335,8 @@ def client_kill_filter(self, _id=None, _type=None, addr=None,
             args.extend((b'ADDR', addr))
         if laddr is not None:
             args.extend((b'LADDR', laddr))
+        if user is not None:
+            args.extend((b'USER', user))
         if not args:
             raise DataError("CLIENT KILL <filter> <value> ... ... <filter> "
                             "<value> must specify at least one filter")
@@ -346,7 +349,7 @@ def client_info(self):
         """
         return self.execute_command('CLIENT INFO')
 
-    def client_list(self, _type=None, client_id=None):
+    def client_list(self, _type=None, client_id=[]):
         """
         Returns a list of currently connected clients.
         If type of client specified, only that type will be returned.
@@ -362,9 +365,11 @@ def client_list(self, _type=None, client_id=None):
                                 client_types,))
             args.append(b'TYPE')
             args.append(_type)
-        if client_id is not None:
+        if not isinstance(client_id, list):
+            raise DataError("client_id must be a list")
+        if client_id != []:
             args.append(b"ID")
-            args.append(client_id)
+            args.append(' '.join(client_id))
         return self.execute_command('CLIENT LIST', *args)
 
     def client_getname(self):
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 24c528d2d2..254aba5f59 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -321,13 +321,19 @@ def test_client_list_type(self, r):
             assert isinstance(clients, list)
 
     @skip_if_server_version_lt('6.2.0')
-    def test_client_list_client_id(self, r):
+    def test_client_list_client_id(self, r, request):
         clients = r.client_list()
-        client_id = clients[0]['id']
-        clients = r.client_list(client_id=client_id)
+        clients = r.client_list(client_id=[clients[0]['id']])
         assert len(clients) == 1
         assert 'addr' in clients[0]
 
+        # testing multiple client ids
+        _get_client(redis.Redis, request, flushdb=False)
+        _get_client(redis.Redis, request, flushdb=False)
+        _get_client(redis.Redis, request, flushdb=False)
+        clients_listed = r.client_list(client_id=clients[:-1])
+        assert len(clients_listed) > 1
+
     @skip_if_server_version_lt('5.0.0')
     def test_client_id(self, r):
         assert r.client_id() > 0
@@ -448,6 +454,19 @@ def test_client_kill_filter_by_laddr(self, r, r2):
         client_2_addr = clients_by_name['redis-py-c2'].get('laddr')
         assert r.client_kill_filter(laddr=client_2_addr)
 
+    @skip_if_server_version_lt('2.8.12')
+    def test_client_kill_filter_by_user(self, r, request):
+        killuser = 'user_to_kill'
+        r.acl_setuser(killuser, enabled=True, reset=True,
+                      commands=['+get', '+set', '+select'],
+                      keys=['cache:*'], nopass=True)
+        _get_client(redis.Redis, request, flushdb=False, username=killuser)
+        r.client_kill_filter(user=killuser)
+        clients = r.client_list()
+        for c in clients:
+            assert c['user'] != killuser
+        r.acl_deluser(killuser)
+
     @skip_if_server_version_lt('2.9.50')
     def test_client_pause(self, r):
         assert r.client_pause(1)

From e9837c1d6360d27fac0d8fed6384fd9b2b568b5c Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 1 Sep 2021 17:31:55 +0300
Subject: [PATCH 0156/1164] Support for SCRIPT FLUSH with SYNC/ASYNC (#1567)

Part of #1546
---
 redis/commands.py       | 14 +++++++++++---
 tests/test_scripting.py | 18 ++++++++++++++++++
 2 files changed, 29 insertions(+), 3 deletions(-)

diff --git a/redis/commands.py b/redis/commands.py
index 7f7e00f2c8..5f1f57b305 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -2786,9 +2786,17 @@ def script_exists(self, *args):
         """
         return self.execute_command('SCRIPT EXISTS', *args)
 
-    def script_flush(self):
-        "Flush all scripts from the script cache"
-        return self.execute_command('SCRIPT FLUSH')
+    def script_flush(self, sync_type="SYNC"):
+        """Flush all scripts from the script cache.
+        ``sync_type`` is by default SYNC (synchronous) but it can also be
+                      ASYNC.
+        See: https://redis.io/commands/script-flush
+        """
+        if sync_type not in ["SYNC", "ASYNC"]:
+            raise DataError("SCRIPT FLUSH defaults to SYNC or"
+                            "accepts SYNC/ASYNC")
+        pieces = [sync_type]
+        return self.execute_command('SCRIPT FLUSH', *pieces)
 
     def script_kill(self):
         "Kill the currently executing Lua script"
diff --git a/tests/test_scripting.py b/tests/test_scripting.py
index 02c0f171d1..cc67e26678 100644
--- a/tests/test_scripting.py
+++ b/tests/test_scripting.py
@@ -30,6 +30,24 @@ def test_eval(self, r):
         # 2 * 3 == 6
         assert r.eval(multiply_script, 1, 'a', 3) == 6
 
+    def test_script_flush(self, r):
+        r.set('a', 2)
+        r.script_load(multiply_script)
+        r.script_flush('ASYNC')
+
+        r.set('a', 2)
+        r.script_load(multiply_script)
+        r.script_flush('SYNC')
+
+        r.set('a', 2)
+        r.script_load(multiply_script)
+        r.script_flush()
+
+        with pytest.raises(exceptions.DataError):
+            r.set('a', 2)
+            r.script_load(multiply_script)
+            r.script_flush("NOTREAL")
+
     def test_evalsha(self, r):
         r.set('a', 2)
         sha = r.script_load(multiply_script)

From 9ed5cd7808789f791fdc7ee368bd268307ac9847 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 5 Sep 2021 11:00:02 +0300
Subject: [PATCH 0157/1164] Updating CHANGES with the latest improvements.
 (#1569)

Thanks everyone for all your contributions!
---
 CHANGES | 55 +++++++++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 45 insertions(+), 10 deletions(-)

diff --git a/CHANGES b/CHANGES
index 9a1df64432..057423dac1 100644
--- a/CHANGES
+++ b/CHANGES
@@ -4,14 +4,43 @@
       urllib.parse.unquote. Prior versions of redis-py supported this by
       specifying the ``decode_components`` flag to the ``from_url`` functions.
       This is now done by default and cannot be disabled. #589
-    * Provide a development and testing environment via docker. Thanks
-      @abrookins. #1365
-    * Added support for the LPOS command available in Redis 6.0.6. Thanks
-      @aparcar #1353/#1354
-    * Added support for the ACL LOG command available in Redis 6. Thanks
-      @2014BDuck. #1307
-    * Added support for ABSTTL option of the RESTORE command available in
-      Redis 5.0. Thanks @charettes. #1423
+    * POTENTIALLY INCOMPATIBLE: Redis commands were moved into a mixin 
+      (see commands.py). Anyone importing ``redis.client`` to access commands 
+      directly should import ``redis.commands``.
+    * Added support for ASYNC to SCRIPT FLUSH available in Redis 6.2.0.
+      Thanks @chayim. #1567
+    * Added CLIENT LIST fix to support multiple client ids available in 
+      Redis 2.8.12. Thanks @chayim #1563.
+    * Added DISCARD support for pipelines available in Redis 2.0.0.
+      Thanks @chayim #1565.
+    * Added ACL DELUSER support for deleting lists of users available in 
+      Redis 6.2.0. Thanks @chayim. #1562
+    * Added CLIENT TRACKINFO support available in Redis 6.2.0.
+      Thanks @chayim. #1560
+    * Added GEOSEARCH and GEOSEARCHSTORE support available in Redis 6.2.0.
+      Thanks @AvitalFine Redis. #1526
+    * Added LPUSHX support for lists available in Redis 4.0.0.
+      Thanks @chayim. #1559
+    * Added support for QUIT available in Redis 1.0.0.
+      Thanks @chayim. #1558
+    * Added support for COMMAND COUNT available in Redis 2.8.13.
+      Thanks @chayim. #1554.
+    * Added CREATECONSUMER support for XGROUP available in Redis 6.2.0.
+      Thanks @AvitalFineRedis. #1553
+    * Including slowly complexity in INFO if available.
+      Thanks @ian28223 #1489.
+    * Added support for STRALGO available in Redis 6.0.0.
+      Thanks @AvitalFineRedis. #1528
+    * Addes support for ZMSCORE available in Redis 6.2.0. 
+      Thanks @2014BDuck and @jiekun.zhu. #1437
+    * Support MINID and LIMIT on XADD available in Redis 6.2.0. 
+      Thanks @AvitalFineRedis. #1548  
+    * Added sentinel commands FLUSHCONFIG, CKQUORUM, FAILOVER, and RESET
+      available in Redis 2.8.12.
+      Thanks @otherpirate. #834
+    * Migrated Version instead of StrictVersion for Python 3.10.
+      Thanks @tirkarthi. #1552
+    * Added retry mechanism with backoff. Thanks @nbraun-amazon. #1494
     * Migrated commands to a mixin. Thanks @chayim. #1534
     * Added support for ZUNION, available in Redis 6.2.0. Thanks
       @AvitalFineRedis. #1522
@@ -60,8 +89,14 @@
       Thanks @AvitalFineRedis. #1515
     * Added support for COPY command, available in Redis 6.2.0.
       Thanks @malinaa96. #1492
-    * Added support for COPY command, available in Redis 6.2.0.
-      Thanks @malinaa96. #1492
+    * Provide a development and testing environment via docker. Thanks
+      @abrookins. #1365
+    * Added support for the LPOS command available in Redis 6.0.6. Thanks
+      @aparcar #1353/#1354
+    * Added support for the ACL LOG command available in Redis 6. Thanks
+      @2014BDuck. #1307
+    * Added support for ABSTTL option of the RESTORE command available in
+      Redis 5.0. Thanks @charettes. #1423
 * 3.5.3 (June 1, 2020)
     * Restore try/except clauses to __del__ methods. These will be removed
       in 4.0 when more explicit resource management if enforced. #1339

From 491c938f9c6ea56fb0b3403be63168e6930709ae Mon Sep 17 00:00:00 2001
From: Guy Korland <gkorland@gmail.com>
Date: Mon, 20 Sep 2021 20:37:16 +0300
Subject: [PATCH 0158/1164] repalce redislabs with redis (#1575)

Rename "Redis Labs" to "Redis" in the README docs
---
 README.rst              |   6 +++---
 docs/logo-redis.png     | Bin 0 -> 8388 bytes
 docs/logo-redislabs.png | Bin 18950 -> 0 bytes
 3 files changed, 3 insertions(+), 3 deletions(-)
 create mode 100644 docs/logo-redis.png
 delete mode 100644 docs/logo-redislabs.png

diff --git a/README.rst b/README.rst
index 43a7de034a..ec87e24fe3 100644
--- a/README.rst
+++ b/README.rst
@@ -964,6 +964,6 @@ Special thanks to:
 Sponsored by
 ^^^^^^^^^^^^
 
-.. image:: ./docs/logo-redislabs.png
-   :alt: RedisLabs
-   :target: https://www.redislabs.com
+.. image:: ./docs/logo-redis.png
+   :alt: Redis
+   :target: https://www.redis.com
diff --git a/docs/logo-redis.png b/docs/logo-redis.png
new file mode 100644
index 0000000000000000000000000000000000000000..45b4a3f284f3d10b558c2f77b75cd11739a117f7
GIT binary patch
literal 8388
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
a2=V_BGxZdvyr}2^0000<MNUMnLSTZ7g9pt3

literal 0
HcmV?d00001

diff --git a/docs/logo-redislabs.png b/docs/logo-redislabs.png
deleted file mode 100644
index cde2d399e2851864d23803279a0939a499a10cea..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 18950
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
Hu0mjfT62NL


From cf3973237205d4bcd74d7cf22889ff10aac35539 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 30 Sep 2021 10:54:07 +0300
Subject: [PATCH 0159/1164] Supporting args with MODULE LOAD (#1579)

Part of #1546
---
 redis/commands.py      |  6 ++++--
 tests/test_commands.py | 10 ++++++++++
 2 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/redis/commands.py b/redis/commands.py
index 5f1f57b305..92a9959ca3 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -3081,12 +3081,14 @@ def _geosearchgeneric(self, command, *args, **kwargs):
         return self.execute_command(command, *pieces, **kwargs)
 
     # MODULE COMMANDS
-    def module_load(self, path):
+    def module_load(self, path, *args):
         """
         Loads the module from ``path``.
         Raises ``ModuleError`` if a module is not found at ``path``.
         """
-        return self.execute_command('MODULE LOAD', path)
+        pieces = list(args)
+        pieces.insert(0, path)
+        return self.execute_command('MODULE LOAD', *pieces)
 
     def module_unload(self, name):
         """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 254aba5f59..9f0a148c31 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -3461,6 +3461,16 @@ def test_command_count(self, r):
         assert isinstance(res, int)
         assert res >= 100
 
+    @skip_if_server_version_lt('4.0.0')
+    def test_module(self, r):
+        with pytest.raises(redis.exceptions.ModuleError) as excinfo:
+            r.module_load('/some/fake/path')
+            assert "Error loading the extension." in str(excinfo.value)
+
+        with pytest.raises(redis.exceptions.ModuleError) as excinfo:
+            r.module_load('/some/fake/path', 'arg1', 'arg2', 'arg3', 'arg4')
+            assert "Error loading the extension." in str(excinfo.value)
+
 
 class TestBinarySave:
 

From 53658c4f865c4f2e1f6810c6ce4e9b31a9dd7eaa Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 30 Sep 2021 11:48:37 +0300
Subject: [PATCH 0160/1164] IDLETIME and FREQ support for RESTORE (#1580)

---
 redis/commands.py      | 24 +++++++++++++++++++++++-
 tests/test_commands.py | 42 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 65 insertions(+), 1 deletion(-)

diff --git a/redis/commands.py b/redis/commands.py
index 92a9959ca3..427f303c36 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -1034,7 +1034,8 @@ def renamenx(self, src, dst):
         "Rename key ``src`` to ``dst`` if ``dst`` doesn't already exist"
         return self.execute_command('RENAMENX', src, dst)
 
-    def restore(self, name, ttl, value, replace=False, absttl=False):
+    def restore(self, name, ttl, value, replace=False, absttl=False,
+                idletime=None, frequency=None):
         """
         Create a key using the provided serialized value, previously obtained
         using DUMP.
@@ -1045,12 +1046,32 @@ def restore(self, name, ttl, value, replace=False, absttl=False):
         ``absttl`` if True, specified ``ttl`` should represent an absolute Unix
         timestamp in milliseconds in which the key will expire. (Redis 5.0 or
         greater).
+
+        ``idletime`` Used for eviction, this is the number of seconds the
+        key must be idle, prior to execution.
+
+        ``frequency`` Used for eviction, this is the frequency counter of
+        the object stored at the key, prior to execution.
         """
         params = [name, ttl, value]
         if replace:
             params.append('REPLACE')
         if absttl:
             params.append('ABSTTL')
+        if idletime is not None:
+            params.append('IDLETIME')
+            try:
+                params.append(int(idletime))
+            except ValueError:
+                raise DataError("idletimemust be an integer")
+
+        if frequency is not None:
+            params.append('FREQ')
+            try:
+                params.append(int(frequency))
+            except ValueError:
+                raise DataError("frequency must be an integer")
+
         return self.execute_command('RESTORE', *params)
 
     def set(self, name, value,
@@ -3084,6 +3105,7 @@ def _geosearchgeneric(self, command, *args, **kwargs):
     def module_load(self, path, *args):
         """
         Loads the module from ``path``.
+        Passes all ``*args`` to the module, during loading.
         Raises ``ModuleError`` if a module is not found at ``path``.
         """
         pieces = list(args)
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 9f0a148c31..7b6f55eb20 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -3471,6 +3471,48 @@ def test_module(self, r):
             r.module_load('/some/fake/path', 'arg1', 'arg2', 'arg3', 'arg4')
             assert "Error loading the extension." in str(excinfo.value)
 
+    @skip_if_server_version_lt('2.6.0')
+    def test_restore(self, r):
+
+        # standard restore
+        key = 'foo'
+        r.set(key, 'bar')
+        dumpdata = r.dump(key)
+        r.delete(key)
+        assert r.restore(key, 0, dumpdata)
+        assert r.get(key) == b'bar'
+
+        # overwrite restore
+        with pytest.raises(redis.exceptions.ResponseError):
+            assert r.restore(key, 0, dumpdata)
+        r.set(key, 'a new value!')
+        assert r.restore(key, 0, dumpdata, replace=True)
+        assert r.get(key) == b'bar'
+
+        # ttl check
+        key2 = 'another'
+        r.set(key2, 'blee!')
+        dumpdata = r.dump(key2)
+        r.delete(key2)
+        assert r.restore(key2, 0, dumpdata)
+        assert r.ttl(key2) == -1
+
+        # idletime
+        key = 'yayakey'
+        r.set(key, 'blee!')
+        dumpdata = r.dump(key)
+        r.delete(key)
+        assert r.restore(key, 0, dumpdata, idletime=5)
+        assert r.get(key) == b'blee!'
+
+        # frequency
+        key = 'yayakey'
+        r.set(key, 'blee!')
+        dumpdata = r.dump(key)
+        r.delete(key)
+        assert r.restore(key, 0, dumpdata, frequency=5)
+        assert r.get(key) == b'blee!'
+
 
 class TestBinarySave:
 

From 799c13965f99e0863dae5aa712d70733d9cff210 Mon Sep 17 00:00:00 2001
From: "Jan C. Brammer" <jan.c.brammer@gmail.com>
Date: Thu, 30 Sep 2021 12:30:30 +0200
Subject: [PATCH 0161/1164] Fix RST syntax error in README. (#1451)

---
 README.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.rst b/README.rst
index ec87e24fe3..710b8a68c0 100644
--- a/README.rst
+++ b/README.rst
@@ -744,6 +744,7 @@ appropriately. The exception handler will take as arguments the exception
 itself, the pubsub object, and the worker thread returned by `run_in_thread`.
 
 .. code-block:: pycon
+
     >>> p.subscribe(**{'my-channel': my_handler})
     >>> def exception_handler(ex, pubsub, thread):
     >>>     print(ex)

From bfc4cd92c8070de9bfa7736ef21b44eb6fe35ed9 Mon Sep 17 00:00:00 2001
From: Theron Luhn <theron@luhn.com>
Date: Thu, 30 Sep 2021 03:34:39 -0700
Subject: [PATCH 0162/1164] Auto-reconnect PubSub on `get_message` (#1574)

---
 redis/client.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/redis/client.py b/redis/client.py
index 7a022a0671..cbdb13d4fd 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1259,7 +1259,10 @@ def parse_response(self, block=True, timeout=0):
 
         self.check_health()
 
-        if not block and not conn.can_read(timeout=timeout):
+        if(
+                not block
+                and not self._execute(conn, conn.can_read, timeout=timeout)
+        ):
             return None
         response = self._execute(conn, conn.read_response)
 

From 6c70fcdd10cca7de15175a77824009babfac4417 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 30 Sep 2021 13:35:10 +0300
Subject: [PATCH 0163/1164] CLIENT REPLY support, available since redis 3.2.0
 (#1581)

---
 redis/commands.py      | 19 +++++++++++++++++++
 tests/conftest.py      |  6 ++++++
 tests/test_commands.py | 13 +++++++++++++
 3 files changed, 38 insertions(+)

diff --git a/redis/commands.py b/redis/commands.py
index 427f303c36..4266f9c55f 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -376,6 +376,25 @@ def client_getname(self):
         "Returns the current connection name"
         return self.execute_command('CLIENT GETNAME')
 
+    def client_reply(self, reply):
+        """Enable and disable redis server replies.
+        ``reply`` Must be ON OFF or SKIP,
+            ON - The default most with server replies to commands
+            OFF - Disable server responses to commands
+            SKIP - Skip the response of the immediately following command.
+
+        Note: When setting OFF or SKIP replies, you will need a client object
+        with a timeout specified in seconds, and will need to catch the
+        TimeoutError.
+              The test_client_reply unit test illustrates this, and
+              conftest.py has a client with a timeout.
+        See https://redis.io/commands/client-reply
+        """
+        replies = ['ON', 'OFF', 'SKIP']
+        if reply not in replies:
+            raise DataError('CLIENT REPLY must be one of %r' % replies)
+        return self.execute_command("CLIENT REPLY", reply)
+
     def client_id(self):
         "Returns the current connection id"
         return self.execute_command('CLIENT ID')
diff --git a/tests/conftest.py b/tests/conftest.py
index fe304c2cc2..b9091a96e6 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -100,6 +100,12 @@ def r(request):
         yield client
 
 
+@pytest.fixture()
+def r_timeout(request):
+    with _get_client(redis.Redis, request, socket_timeout=1) as client:
+        yield client
+
+
 @pytest.fixture()
 def r2(request):
     "A second client for tests that need multiple"
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 7b6f55eb20..a283afcbaa 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -478,6 +478,19 @@ def test_client_pause(self, r):
     def test_client_unpause(self, r):
         assert r.client_unpause() == b'OK'
 
+    @skip_if_server_version_lt('3.2.0')
+    def test_client_reply(self, r, r_timeout):
+        assert r_timeout.client_reply('ON') == b'OK'
+        with pytest.raises(exceptions.TimeoutError):
+            r_timeout.client_reply('OFF')
+
+            r_timeout.client_reply('SKIP')
+
+        assert r_timeout.set('foo', 'bar')
+
+        # validate it was set
+        assert r.get('foo') == b'bar'
+
     def test_config_get(self, r):
         data = r.config_get()
         assert 'maxmemory' in data

From 9527ae88538735c10def3716cdae9388cdee2388 Mon Sep 17 00:00:00 2001
From: Rajiv Bakulesh Shah <brainix@gmail.com>
Date: Thu, 30 Sep 2021 21:14:31 -0700
Subject: [PATCH 0164/1164] Implement/test LOLWUT command (#1568)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Implement/test LOLWUT command

https://redis.io/commands/lolwut

This is a lot of fun to play with:

```python
>>> from redis import Redis
>>> redis = Redis()
>>> print(redis.lolwut(5, 6, 7, 8).decode('utf-8'))
⣴⣶⣶⣶⣶⡆
⣿⣿⣿⣿⣿⡇
⠹⡿⠟⣿⡿⠃
⠀⠀⠀⠀⠀⠀
Georg Nees - schotter, plotter on paper, 1968. Redis ver. 6.0.10

>>> print(redis.lolwut(5, 6, 7, 8).decode('utf-8'))
⢰⣶⣶⣶⣶⡆
⢿⣿⣿⣿⣿⠁
⠸⡿⢿⠿⡿⠃
⠀⠀⠀⠀⠀⠀
Georg Nees - schotter, plotter on paper, 1968. Redis ver. 6.0.10

>>> print(redis.lolwut(5, 6, 7, 8).decode('utf-8'))
⢰⣶⣶⣶⣶⡆
⣸⣿⣿⣻⣿⡅
⠿⡿⠻⠿⠿⠁
⠀⠀⠀⠀⠀⠀
Georg Nees - schotter, plotter on paper, 1968. Redis ver. 6.0.10

>>>
```

* Add link to LOLWUT command documentation

Co-authored-by: Chayim <chayim@users.noreply.github.com>

* Skip LOLWUT unit test for Redis < 5.0.0

The `LOLWUT` command was introduced in Redis 5.0.0:
https://redis.io/commands/lolwut

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/commands.py      | 9 +++++++++
 tests/test_commands.py | 8 ++++++++
 2 files changed, 17 insertions(+)

diff --git a/redis/commands.py b/redis/commands.py
index 4266f9c55f..48d234ea35 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -523,6 +523,15 @@ def lastsave(self):
         """
         return self.execute_command('LASTSAVE')
 
+    def lolwut(self, *version_numbers):
+        """Get the Redis version and a piece of generative computer art
+        See: https://redis.io/commands/lolwut
+        """
+        if version_numbers:
+            return self.execute_command('LOLWUT VERSION', *version_numbers)
+        else:
+            return self.execute_command('LOLWUT')
+
     def migrate(self, host, port, keys, destination_db, timeout,
                 copy=False, replace=False, auth=None):
         """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index a283afcbaa..736ae45174 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -531,6 +531,14 @@ def test_info(self, r):
     def test_lastsave(self, r):
         assert isinstance(r.lastsave(), datetime.datetime)
 
+    @skip_if_server_version_lt('5.0.0')
+    def test_lolwut(self, r):
+        lolwut = r.lolwut().decode('utf-8')
+        assert 'Redis ver.' in lolwut
+
+        lolwut = r.lolwut(5, 6, 7, 8).decode('utf-8')
+        assert 'Redis ver.' in lolwut
+
     def test_object(self, r):
         r['a'] = 'foo'
         assert isinstance(r.object('refcount', 'a'), int)

From 677476d734d178e4ad89538042567367f703512b Mon Sep 17 00:00:00 2001
From: Andrew Chen Wang <60190294+Andrew-Chen-Wang@users.noreply.github.com>
Date: Tue, 5 Oct 2021 06:12:01 -0400
Subject: [PATCH 0165/1164] Fix potential test case typo in test_zadd_gt_lt
 (#1585)

---
 tests/test_commands.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/test_commands.py b/tests/test_commands.py
index 736ae45174..60b9ff15bf 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1687,7 +1687,7 @@ def test_zadd_gt_lt(self, r):
         with pytest.raises(exceptions.DataError):
             r.zadd('a', {'a15': 155}, nx=True, lt=True)
             r.zadd('a', {'a15': 155}, nx=True, gt=True)
-            r.zadd('a', {'a15': 155}, lx=True, gt=True)
+            r.zadd('a', {'a15': 155}, lt=True, gt=True)
 
     def test_zcard(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})

From 9419f1d56beff5b350c87785cc57f2431fe85cbb Mon Sep 17 00:00:00 2001
From: Andrew Chen Wang <60190294+Andrew-Chen-Wang@users.noreply.github.com>
Date: Tue, 5 Oct 2021 10:38:32 -0400
Subject: [PATCH 0166/1164] Use Oxford comma properly in getex (#1586)

---
 redis/commands.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/commands.py b/redis/commands.py
index 48d234ea35..eb7cea54f6 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -843,7 +843,7 @@ def getex(self, name,
 
         opset = set([ex, px, exat, pxat])
         if len(opset) > 2 or len(opset) > 1 and persist:
-            raise DataError("``ex``, ``px``, ``exat``, ``pxat``",
+            raise DataError("``ex``, ``px``, ``exat``, ``pxat``, "
                             "and ``persist`` are mutually exclusive.")
 
         pieces = []

From 22f677f991f811e5a540294f1535c3539719087f Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Mon, 11 Oct 2021 11:00:45 +0300
Subject: [PATCH 0167/1164] Removing the REDIS_6_VERSION placeholder (#1582)

---
 tests/conftest.py             |  6 ------
 tests/test_commands.py        | 31 +++++++++++++++----------------
 tests/test_connection_pool.py | 12 ++++++------
 3 files changed, 21 insertions(+), 28 deletions(-)

diff --git a/tests/conftest.py b/tests/conftest.py
index b9091a96e6..3dc3ea149e 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -9,12 +9,6 @@
 from urllib.parse import urlparse
 
 
-# redis 6 release candidates report a version number of 5.9.x. Use this
-# constant for skip_if decorators as a placeholder until 6.0.0 is officially
-# released
-REDIS_6_VERSION = '5.9.0'
-
-
 REDIS_INFO = {}
 default_redis_url = "redis://localhost:6379/9"
 
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 60b9ff15bf..2be8923e0e 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -11,7 +11,6 @@
 
 from .conftest import (
     _get_client,
-    REDIS_6_VERSION,
     skip_if_server_version_gte,
     skip_if_server_version_lt,
     skip_unless_arch_bits,
@@ -68,19 +67,19 @@ def test_command_on_invalid_key_type(self, r):
             r['a']
 
     # SERVER INFORMATION
-    @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_lt("6.0.0")
     def test_acl_cat_no_category(self, r):
         categories = r.acl_cat()
         assert isinstance(categories, list)
         assert 'read' in categories
 
-    @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_lt("6.0.0")
     def test_acl_cat_with_category(self, r):
         commands = r.acl_cat('read')
         assert isinstance(commands, list)
         assert 'get' in commands
 
-    @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_lt("6.0.0")
     def test_acl_deluser(self, r, request):
         username = 'redis-py-user'
 
@@ -104,7 +103,7 @@ def teardown():
         assert r.acl_getuser(users[3]) is None
         assert r.acl_getuser(users[4]) is None
 
-    @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_lt("6.0.0")
     def test_acl_genpass(self, r):
         password = r.acl_genpass()
         assert isinstance(password, str)
@@ -117,7 +116,7 @@ def test_acl_genpass(self, r):
         r.acl_genpass(555)
         assert isinstance(password, str)
 
-    @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_lt("6.0.0")
     def test_acl_getuser_setuser(self, r, request):
         username = 'redis-py-user'
 
@@ -204,13 +203,13 @@ def teardown():
                              hashed_passwords=['-' + hashed_password])
         assert len(r.acl_getuser(username)['passwords']) == 1
 
-    @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_lt("6.0.0")
     def test_acl_help(self, r):
         res = r.acl_help()
         assert isinstance(res, list)
         assert len(res) != 0
 
-    @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_lt("6.0.0")
     def test_acl_list(self, r, request):
         username = 'redis-py-user'
 
@@ -222,7 +221,7 @@ def teardown():
         users = r.acl_list()
         assert len(users) == 2
 
-    @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_lt("6.0.0")
     def test_acl_log(self, r, request):
         username = 'redis-py-user'
 
@@ -257,7 +256,7 @@ def teardown():
         assert 'client-info' in r.acl_log(count=1)[0]
         assert r.acl_log_reset()
 
-    @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_lt("6.0.0")
     def test_acl_setuser_categories_without_prefix_fails(self, r, request):
         username = 'redis-py-user'
 
@@ -268,7 +267,7 @@ def teardown():
         with pytest.raises(exceptions.DataError):
             r.acl_setuser(username, categories=['list'])
 
-    @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_lt("6.0.0")
     def test_acl_setuser_commands_without_prefix_fails(self, r, request):
         username = 'redis-py-user'
 
@@ -279,7 +278,7 @@ def teardown():
         with pytest.raises(exceptions.DataError):
             r.acl_setuser(username, commands=['get'])
 
-    @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_lt("6.0.0")
     def test_acl_setuser_add_passwords_and_nopass_fails(self, r, request):
         username = 'redis-py-user'
 
@@ -290,13 +289,13 @@ def teardown():
         with pytest.raises(exceptions.DataError):
             r.acl_setuser(username, passwords='+mypass', nopass=True)
 
-    @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_lt("6.0.0")
     def test_acl_users(self, r):
         users = r.acl_users()
         assert isinstance(users, list)
         assert len(users) > 0
 
-    @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_lt("6.0.0")
     def test_acl_whoami(self, r):
         username = r.acl_whoami()
         assert isinstance(username, str)
@@ -1137,7 +1136,7 @@ def test_set_multipleoptions(self, r):
         assert r.set('a', '1', xx=True, px=10000)
         assert 0 < r.ttl('a') <= 10
 
-    @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_lt("6.0.0")
     def test_set_keepttl(self, r):
         r['a'] = 'val'
         assert r.set('a', '1', xx=True, px=10000)
@@ -1451,7 +1450,7 @@ def test_scan(self, r):
         _, keys = r.scan(match='a')
         assert set(keys) == {b'a'}
 
-    @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_lt("6.0.0")
     def test_scan_type(self, r):
         r.sadd('a-set', 1)
         r.hset('a-hash', 'foo', 2)
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 7f9d05453d..8d2ad041a0 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -7,7 +7,7 @@
 
 from threading import Thread
 from redis.connection import ssl_available, to_bool
-from .conftest import skip_if_server_version_lt, _get_client, REDIS_6_VERSION
+from .conftest import skip_if_server_version_lt, _get_client
 from .test_pubsub import wait_for_message
 
 
@@ -200,7 +200,7 @@ def test_port(self):
             'port': 6380,
         }
 
-    @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_lt("6.0.0")
     def test_username(self):
         pool = redis.ConnectionPool.from_url('redis://myuser:@localhost')
         assert pool.connection_class == redis.Connection
@@ -209,7 +209,7 @@ def test_username(self):
             'username': 'myuser',
         }
 
-    @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_lt("6.0.0")
     def test_quoted_username(self):
         pool = redis.ConnectionPool.from_url(
             'redis://%2Fmyuser%2F%2B name%3D%24+:@localhost')
@@ -236,7 +236,7 @@ def test_quoted_password(self):
             'password': '/mypass/+ word=$+',
         }
 
-    @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_lt("6.0.0")
     def test_username_and_password(self):
         pool = redis.ConnectionPool.from_url('redis://myuser:mypass@localhost')
         assert pool.connection_class == redis.Connection
@@ -349,7 +349,7 @@ def test_defaults(self):
             'path': '/socket',
         }
 
-    @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_lt("6.0.0")
     def test_username(self):
         pool = redis.ConnectionPool.from_url('unix://myuser:@/socket')
         assert pool.connection_class == redis.UnixDomainSocketConnection
@@ -358,7 +358,7 @@ def test_username(self):
             'username': 'myuser',
         }
 
-    @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_lt("6.0.0")
     def test_quoted_username(self):
         pool = redis.ConnectionPool.from_url(
             'unix://%2Fmyuser%2F%2B name%3D%24+:@/socket')

From 5cd878de3eca3322d6719822d4999595f943b218 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Mon, 11 Oct 2021 11:05:50 +0300
Subject: [PATCH 0168/1164] Making 3.9.9 a placeholder version - prior to 4.0.0
 (#1599)

---
 redis/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/__init__.py b/redis/__init__.py
index 9f67f51d08..f0193d8582 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -31,7 +31,7 @@ def int_or_str(value):
         return value
 
 
-__version__ = '3.5.3'
+__version__ = '3.9.9'
 VERSION = tuple(map(int_or_str, __version__.split('.')))
 
 __all__ = [

From 90468846acb7812df6419d54a9c191156e170516 Mon Sep 17 00:00:00 2001
From: AvitalFineRedis <avital.fine@redislabs.com>
Date: Wed, 13 Oct 2021 15:33:49 +0200
Subject: [PATCH 0169/1164] Add support to ANY to GEOSEARCHSTORE and to
 GEOSEARCH

---
 redis/commands.py      | 31 +++++++++++++++++++------------
 tests/test_commands.py |  6 ++++++
 2 files changed, 25 insertions(+), 12 deletions(-)

diff --git a/redis/commands.py b/redis/commands.py
index eb7cea54f6..ecf5b5137a 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -2908,7 +2908,7 @@ def geopos(self, name, *values):
 
     def georadius(self, name, longitude, latitude, radius, unit=None,
                   withdist=False, withcoord=False, withhash=False, count=None,
-                  sort=None, store=None, store_dist=None):
+                  sort=None, store=None, store_dist=None, any=False):
         """
         Return the members of the specified key identified by the
         ``name`` argument which are within the borders of the area specified
@@ -2942,11 +2942,12 @@ def georadius(self, name, longitude, latitude, radius, unit=None,
                                       unit=unit, withdist=withdist,
                                       withcoord=withcoord, withhash=withhash,
                                       count=count, sort=sort, store=store,
-                                      store_dist=store_dist)
+                                      store_dist=store_dist, any=any)
 
     def georadiusbymember(self, name, member, radius, unit=None,
                           withdist=False, withcoord=False, withhash=False,
-                          count=None, sort=None, store=None, store_dist=None):
+                          count=None, sort=None, store=None, store_dist=None,
+                          any=False):
         """
         This command is exactly like ``georadius`` with the sole difference
         that instead of taking, as the center of the area to query, a longitude
@@ -2958,7 +2959,7 @@ def georadiusbymember(self, name, member, radius, unit=None,
                                       withdist=withdist, withcoord=withcoord,
                                       withhash=withhash, count=count,
                                       sort=sort, store=store,
-                                      store_dist=store_dist)
+                                      store_dist=store_dist, any=any)
 
     def _georadiusgeneric(self, command, *args, **kwargs):
         pieces = list(args)
@@ -2969,21 +2970,26 @@ def _georadiusgeneric(self, command, *args, **kwargs):
         else:
             pieces.append('m',)
 
+        if kwargs['any'] and kwargs['count'] is None:
+            raise DataError("``any`` can't be provided without ``count``")
+
         for arg_name, byte_repr in (
-                ('withdist', b'WITHDIST'),
-                ('withcoord', b'WITHCOORD'),
-                ('withhash', b'WITHHASH')):
+                ('withdist', 'WITHDIST'),
+                ('withcoord', 'WITHCOORD'),
+                ('withhash', 'WITHHASH')):
             if kwargs[arg_name]:
                 pieces.append(byte_repr)
 
-        if kwargs['count']:
-            pieces.extend([b'COUNT', kwargs['count']])
+        if kwargs['count'] is not None:
+            pieces.extend(['COUNT', kwargs['count']])
+            if kwargs['any']:
+                pieces.append('ANY')
 
         if kwargs['sort']:
             if kwargs['sort'] == 'ASC':
-                pieces.append(b'ASC')
+                pieces.append('ASC')
             elif kwargs['sort'] == 'DESC':
-                pieces.append(b'DESC')
+                pieces.append('DESC')
             else:
                 raise DataError("GEORADIUS invalid sort")
 
@@ -3116,7 +3122,8 @@ def _geosearchgeneric(self, command, *args, **kwargs):
             if kwargs['any']:
                 pieces.append(b'ANY')
         elif kwargs['any']:
-            raise DataError("GEOSEARCH any can't be provided without count")
+            raise DataError("GEOSEARCH ``any`` can't be provided "
+                            "without count")
 
         # other properties
         for arg_name, byte_repr in (
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 2be8923e0e..df79940913 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2655,6 +2655,9 @@ def test_georadius_count(self, r):
         r.geoadd('barcelona', *values)
         assert r.georadius('barcelona', 2.191, 41.433, 3000, count=1) == \
                [b'place1']
+        assert r.georadius('barcelona', 2.191, 41.433, 3000,
+                           count=1, any=True) == \
+               [b'place2']
 
     @skip_if_server_version_lt('3.2.0')
     def test_georadius_sort(self, r):
@@ -2706,6 +2709,9 @@ def test_georadiusmember(self, r):
                  (2.187376320362091, 41.40634178640635)],
                 [b'place1', 0.0, 3471609698139488,
                  (2.1909382939338684, 41.433790281840835)]]
+        assert r.georadiusbymember('barcelona', 'place1', 4000,
+                                   count=1, any=True) == \
+               [b'\x80place2']
 
     @skip_if_server_version_lt('5.0.0')
     def test_xack(self, r):

From c02ecb5c4f3d57da490a24e150cd386ad69580bd Mon Sep 17 00:00:00 2001
From: AvitalFineRedis <avital.fine@redislabs.com>
Date: Wed, 13 Oct 2021 15:57:21 +0200
Subject: [PATCH 0170/1164] raise NotImplementedError

---
 redis/commands.py | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/redis/commands.py b/redis/commands.py
index eb7cea54f6..b1e43a922d 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -568,11 +568,16 @@ def migrate(self, host, port, keys, destination_db, timeout,
                                     timeout, *pieces)
 
     def object(self, infotype, key):
-        "Return the encoding, idletime, or refcount about the key"
+        """Return the encoding, idletime, or refcount about the key"""
         return self.execute_command('OBJECT', infotype, key, infotype=infotype)
 
+    def memory_doctor(self):
+        raise NotImplementedError(
+            "MEMORY DOCTOR is not supported in the client."
+        )
+
     def memory_stats(self):
-        "Return a dictionary of memory stats"
+        """Return a dictionary of memory stats"""
         return self.execute_command('MEMORY STATS')
 
     def memory_usage(self, key, samples=None):
@@ -590,15 +595,16 @@ def memory_usage(self, key, samples=None):
         return self.execute_command('MEMORY USAGE', key, *args)
 
     def memory_purge(self):
-        "Attempts to purge dirty pages for reclamation by allocator"
+        """Attempts to purge dirty pages for reclamation by allocator"""
         return self.execute_command('MEMORY PURGE')
 
     def ping(self):
-        "Ping the Redis server"
+        """Ping the Redis server"""
         return self.execute_command('PING')
 
     def quit(self):
-        """Ask the server to close the connection.
+        """
+        Ask the server to close the connection.
         https://redis.io/commands/quit
         """
         return self.execute_command('QUIT')

From 9d92ca78fe694d57bfaf6929dcd40dc707302d2e Mon Sep 17 00:00:00 2001
From: AvitalFineRedis <avital.fine@redislabs.com>
Date: Wed, 13 Oct 2021 16:00:09 +0200
Subject: [PATCH 0171/1164] stam

---
 redis/commands.py | 26 ++++++++++++++------------
 1 file changed, 14 insertions(+), 12 deletions(-)

diff --git a/redis/commands.py b/redis/commands.py
index b1e43a922d..1524bfd323 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -373,7 +373,7 @@ def client_list(self, _type=None, client_id=[]):
         return self.execute_command('CLIENT LIST', *args)
 
     def client_getname(self):
-        "Returns the current connection name"
+        """Returns the current connection name"""
         return self.execute_command('CLIENT GETNAME')
 
     def client_reply(self, reply):
@@ -396,11 +396,12 @@ def client_reply(self, reply):
         return self.execute_command("CLIENT REPLY", reply)
 
     def client_id(self):
-        "Returns the current connection id"
+        """Returns the current connection id"""
         return self.execute_command('CLIENT ID')
 
     def client_trackinginfo(self):
-        """Returns the information about the current client connection's
+        """
+        Returns the information about the current client connection's
         use of the server assisted client side cache.
         See https://redis.io/commands/client-trackinginfo
         """
@@ -438,15 +439,15 @@ def client_unpause(self):
         return self.execute_command('CLIENT UNPAUSE')
 
     def readwrite(self):
-        "Disables read queries for a connection to a Redis Cluster slave node"
+        """Disables read queries for a connection to a Redis Cluster slave node"""
         return self.execute_command('READWRITE')
 
     def readonly(self):
-        "Enables read queries for a connection to a Redis Cluster replica node"
+        """Enables read queries for a connection to a Redis Cluster replica node"""
         return self.execute_command('READONLY')
 
     def config_get(self, pattern="*"):
-        "Return a dictionary of configuration based on the ``pattern``"
+        """Return a dictionary of configuration based on the ``pattern``"""
         return self.execute_command('CONFIG GET', pattern)
 
     def config_set(self, name, value):
@@ -454,23 +455,23 @@ def config_set(self, name, value):
         return self.execute_command('CONFIG SET', name, value)
 
     def config_resetstat(self):
-        "Reset runtime statistics"
+        """Reset runtime statistics"""
         return self.execute_command('CONFIG RESETSTAT')
 
     def config_rewrite(self):
-        "Rewrite config file with the minimal change to reflect running config"
+        """Rewrite config file with the minimal change to reflect running config"""
         return self.execute_command('CONFIG REWRITE')
 
     def dbsize(self):
-        "Returns the number of keys in the current database"
+        """Returns the number of keys in the current database"""
         return self.execute_command('DBSIZE')
 
     def debug_object(self, key):
-        "Returns version specific meta information about a given key"
+        """Returns version specific meta information about a given key"""
         return self.execute_command('DEBUG OBJECT', key)
 
     def echo(self, value):
-        "Echo the string back from the server"
+        """Echo the string back from the server"""
         return self.execute_command('ECHO', value)
 
     def flushall(self, asynchronous=False):
@@ -524,7 +525,8 @@ def lastsave(self):
         return self.execute_command('LASTSAVE')
 
     def lolwut(self, *version_numbers):
-        """Get the Redis version and a piece of generative computer art
+        """
+        Get the Redis version and a piece of generative computer art
         See: https://redis.io/commands/lolwut
         """
         if version_numbers:

From b559b6d82df3214931d2b4cadc9d380127953b4f Mon Sep 17 00:00:00 2001
From: AvitalFineRedis <avital.fine@redislabs.com>
Date: Wed, 13 Oct 2021 16:58:11 +0200
Subject: [PATCH 0172/1164] flake8

---
 redis/commands.py | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/redis/commands.py b/redis/commands.py
index 1524bfd323..11205cf3ce 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -439,11 +439,15 @@ def client_unpause(self):
         return self.execute_command('CLIENT UNPAUSE')
 
     def readwrite(self):
-        """Disables read queries for a connection to a Redis Cluster slave node"""
+        """
+        Disables read queries for a connection to a Redis Cluster slave node.
+        """
         return self.execute_command('READWRITE')
 
     def readonly(self):
-        """Enables read queries for a connection to a Redis Cluster replica node"""
+        """
+        Enables read queries for a connection to a Redis Cluster replica node.
+        """
         return self.execute_command('READONLY')
 
     def config_get(self, pattern="*"):
@@ -459,7 +463,9 @@ def config_resetstat(self):
         return self.execute_command('CONFIG RESETSTAT')
 
     def config_rewrite(self):
-        """Rewrite config file with the minimal change to reflect running config"""
+        """
+        Rewrite config file with the minimal change to reflect running config.
+        """
         return self.execute_command('CONFIG REWRITE')
 
     def dbsize(self):

From 106567de0573d2c6d8651191c7d108802d10a06d Mon Sep 17 00:00:00 2001
From: AvitalFineRedis <avital.fine@redislabs.com>
Date: Thu, 14 Oct 2021 08:32:10 +0200
Subject: [PATCH 0173/1164] Throw NotImplementedError

---
 redis/commands.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/redis/commands.py b/redis/commands.py
index eb7cea54f6..766d391f17 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -3154,6 +3154,11 @@ def module_list(self):
         """
         return self.execute_command('MODULE LIST')
 
+    def command(self):
+        raise NotImplementedError(
+            "COMMAND is not supported in the client."
+        )
+
     def command_count(self):
         return self.execute_command('COMMAND COUNT')
 

From 1b985b16ac73f9b2eaa6bf70338a6a9049e817aa Mon Sep 17 00:00:00 2001
From: AvitalFineRedis <avital.fine@redislabs.com>
Date: Thu, 14 Oct 2021 08:40:17 +0200
Subject: [PATCH 0174/1164] Throw NotImplementedError

---
 redis/commands.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/commands.py b/redis/commands.py
index 766d391f17..d8d6e088cf 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -3156,7 +3156,7 @@ def module_list(self):
 
     def command(self):
         raise NotImplementedError(
-            "COMMAND is not supported in the client."
+            "COMMAND is intentionally not implemented in the client."
         )
 
     def command_count(self):

From 4eeceb0b7ebdf8fb164d1c68cd9c64d320bf9241 Mon Sep 17 00:00:00 2001
From: AvitalFineRedis <avital.fine@redislabs.com>
Date: Thu, 14 Oct 2021 08:40:57 +0200
Subject: [PATCH 0175/1164] Throw NotImplementedError

---
 redis/commands.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/commands.py b/redis/commands.py
index 11205cf3ce..4a8d430da2 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -581,7 +581,7 @@ def object(self, infotype, key):
 
     def memory_doctor(self):
         raise NotImplementedError(
-            "MEMORY DOCTOR is not supported in the client."
+            "MEMORY DOCTOR is intentionally not implemented in the client."
         )
 
     def memory_stats(self):

From b66187ba13cfe4fa8a31dc3107f9d3783154d1b7 Mon Sep 17 00:00:00 2001
From: AvitalFineRedis <avital.fine@redislabs.com>
Date: Thu, 14 Oct 2021 09:02:16 +0200
Subject: [PATCH 0176/1164] Throw NotImplementedError

---
 redis/commands.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/redis/commands.py b/redis/commands.py
index d8d6e088cf..bc805076a3 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -3154,9 +3154,9 @@ def module_list(self):
         """
         return self.execute_command('MODULE LIST')
 
-    def command(self):
+    def command_info(self):
         raise NotImplementedError(
-            "COMMAND is intentionally not implemented in the client."
+            "COMMAND INFO is intentionally not implemented in the client."
         )
 
     def command_count(self):

From 9c34614c1a998267b2ea454544a0fff243c0b943 Mon Sep 17 00:00:00 2001
From: AvitalFineRedis <avital.fine@redislabs.com>
Date: Thu, 14 Oct 2021 09:03:02 +0200
Subject: [PATCH 0177/1164] Throw NotImplementedError

---
 redis/commands.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/redis/commands.py b/redis/commands.py
index 4a8d430da2..bcb1c8457b 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -584,6 +584,11 @@ def memory_doctor(self):
             "MEMORY DOCTOR is intentionally not implemented in the client."
         )
 
+    def memory_HELP(self):
+        raise NotImplementedError(
+            "MEMORY HELP is intentionally not implemented in the client."
+        )
+
     def memory_stats(self):
         """Return a dictionary of memory stats"""
         return self.execute_command('MEMORY STATS')

From 5fb24c43af334d16878c0db5104270a76e73f188 Mon Sep 17 00:00:00 2001
From: AvitalFineRedis <avital.fine@redislabs.com>
Date: Thu, 14 Oct 2021 11:48:56 +0200
Subject: [PATCH 0178/1164] Throw NotImplementedError

---
 redis/commands.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/commands.py b/redis/commands.py
index bcb1c8457b..23b5aac9ec 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -584,7 +584,7 @@ def memory_doctor(self):
             "MEMORY DOCTOR is intentionally not implemented in the client."
         )
 
-    def memory_HELP(self):
+    def memory_help(self):
         raise NotImplementedError(
             "MEMORY HELP is intentionally not implemented in the client."
         )

From b63e55e927f3ca205a178c14330e6091120cf366 Mon Sep 17 00:00:00 2001
From: Guy Korland <gkorland@gmail.com>
Date: Thu, 14 Oct 2021 14:55:07 +0300
Subject: [PATCH 0179/1164] Updating links to point to the new repository
 location (#1611)

---
 README.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/README.rst b/README.rst
index 710b8a68c0..821a25386d 100644
--- a/README.rst
+++ b/README.rst
@@ -3,14 +3,14 @@ redis-py
 
 The Python interface to the Redis key-value store.
 
-.. image:: https://github.com/andymccurdy/redis-py/workflows/CI/badge.svg?branch=master
-        :target: https://github.com/andymccurdy/redis-py/actions?query=workflow%3ACI+branch%3Amaster
+.. image:: https://github.com/redis/redis-py/workflows/CI/badge.svg?branch=master
+        :target: https://github.com/redis/redis-py/actions?query=workflow%3ACI+branch%3Amaster
 .. image:: https://readthedocs.org/projects/redis-py/badge/?version=stable&style=flat
         :target: https://redis-py.readthedocs.io/en/stable/
 .. image:: https://badge.fury.io/py/redis.svg
         :target: https://pypi.org/project/redis/
-.. image:: https://codecov.io/gh/andymccurdy/redis-py/branch/master/graph/badge.svg
-  :target: https://codecov.io/gh/andymccurdy/redis-py
+.. image:: https://codecov.io/gh/redis/redis-py/branch/master/graph/badge.svg
+  :target: https://codecov.io/gh/redis/redis-py
 
 
 Python 2 Compatibility Note
@@ -51,7 +51,7 @@ Contributing
 ------------
 
 Want to contribute a feature, bug report, or report an issue? Check out our `guide to
-contributing <https://github.com/andymccurdy/redis-py/blob/master/CONTRIBUTING.rst>`_.
+contributing <https://github.com/redis/redis-py/blob/master/CONTRIBUTING.rst>`_.
 
 
 Getting Started
@@ -127,7 +127,7 @@ SSL Connections
 
 redis-py 3.0 changes the default value of the `ssl_cert_reqs` option from
 `None` to `'required'`. See
-`Issue 1016 <https://github.com/andymccurdy/redis-py/issues/1016>`_. This
+`Issue 1016 <https://github.com/redis/redis-py/issues/1016>`_. This
 change enforces hostname validation when accepting a cert from a remote SSL
 terminator. If the terminator doesn't properly set the hostname on the cert
 this will cause redis-py 3.0 to raise a ConnectionError.
@@ -284,7 +284,7 @@ to the official command syntax. There are a few exceptions:
   will return a PubSub instance where you can subscribe to channels and listen
   for messages. You can only call PUBLISH from the Redis client (see
   `this comment on issue #151
-  <https://github.com/andymccurdy/redis-py/issues/151#issuecomment-1545015>`_
+  <https://github.com/redis/redis-py/issues/151#issuecomment-1545015>`_
   for details).
 * **SCAN/SSCAN/HSCAN/ZSCAN**: The \*SCAN commands are implemented as they
   exist in the Redis documentation. In addition, each command has an equivalent
@@ -952,7 +952,7 @@ Author
 ^^^^^^
 
 redis-py is developed and maintained by Andy McCurdy (sedrik@gmail.com).
-It can be found here: https://github.com/andymccurdy/redis-py
+It can be found here: https://github.com/redis/redis-py
 
 Special thanks to:
 

From 3758579b42c4cc7546343dcf348891e933cb922f Mon Sep 17 00:00:00 2001
From: AvitalFineRedis <avital.fine@redislabs.com>
Date: Thu, 14 Oct 2021 15:21:19 +0200
Subject: [PATCH 0180/1164] implement memory_malloc_stats

---
 redis/commands.py      | 4 ++++
 tests/test_commands.py | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/redis/commands.py b/redis/commands.py
index eb7cea54f6..bbd422f5b3 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -575,6 +575,10 @@ def memory_stats(self):
         "Return a dictionary of memory stats"
         return self.execute_command('MEMORY STATS')
 
+    def memory_malloc_stats(self):
+        """Return an internal statistics report from the memory allocator."""
+        return self.execute_command('MEMORY MALLOC-STATS')
+
     def memory_usage(self, key, samples=None):
         """
         Return the total memory usage for key, its value and associated
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 2be8923e0e..21f259717b 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -3454,6 +3454,10 @@ def test_bitfield_operations(self, r):
                 .execute())
         assert resp == [0, None, 255]
 
+    @skip_if_server_version_lt('4.0.0')
+    def test_memory_malloc_stats(self, r):
+        assert r.memory_malloc_stats()
+
     @skip_if_server_version_lt('4.0.0')
     def test_memory_stats(self, r):
         # put a key into the current db to make sure that "db.<current-db>"

From 65c433407dc02aff90fc41f63ea46b372b374b9b Mon Sep 17 00:00:00 2001
From: Andrew Chen Wang <60190294+Andrew-Chen-Wang@users.noreply.github.com>
Date: Thu, 14 Oct 2021 09:36:09 -0400
Subject: [PATCH 0181/1164] Simplify MODULE LOAD and fix SCRIPT FLUSH doc
 (#1597)

---
 redis/commands.py | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/redis/commands.py b/redis/commands.py
index 7bb6b501a2..e10238a5ec 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -2861,7 +2861,7 @@ def script_flush(self, sync_type="SYNC"):
         See: https://redis.io/commands/script-flush
         """
         if sync_type not in ["SYNC", "ASYNC"]:
-            raise DataError("SCRIPT FLUSH defaults to SYNC or"
+            raise DataError("SCRIPT FLUSH defaults to SYNC or "
                             "accepts SYNC/ASYNC")
         pieces = [sync_type]
         return self.execute_command('SCRIPT FLUSH', *pieces)
@@ -3155,9 +3155,7 @@ def module_load(self, path, *args):
         Passes all ``*args`` to the module, during loading.
         Raises ``ModuleError`` if a module is not found at ``path``.
         """
-        pieces = list(args)
-        pieces.insert(0, path)
-        return self.execute_command('MODULE LOAD', *pieces)
+        return self.execute_command('MODULE LOAD', path, *args)
 
     def module_unload(self, name):
         """

From 3dc28e9bdeb745107d20a0be8a7ffc565a71da10 Mon Sep 17 00:00:00 2001
From: Andrew Chen Wang <60190294+Andrew-Chen-Wang@users.noreply.github.com>
Date: Thu, 14 Oct 2021 09:36:22 -0400
Subject: [PATCH 0182/1164] Add client_id param to docs for client_list (#1589)

---
 redis/commands.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/redis/commands.py b/redis/commands.py
index e10238a5ec..94489d1d75 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -355,6 +355,7 @@ def client_list(self, _type=None, client_id=[]):
         If type of client specified, only that type will be returned.
         :param _type: optional. one of the client types (normal, master,
          replica, pubsub)
+        :param client_id: optional. a list of client ids
         """
         "Returns a list of currently connected clients"
         args = []
@@ -2208,7 +2209,7 @@ def xtrim(self, name, maxlen=None, approximate=True, minid=None,
         """
         pieces = []
         if maxlen is not None and minid is not None:
-            raise DataError("Only one of ```maxlen``` or ```minid```",
+            raise DataError("Only one of ``maxlen`` or ``minid`` "
                             "may be specified")
 
         if maxlen is not None:

From 358c293e7772a44f114c78b5c5129ba1e972240f Mon Sep 17 00:00:00 2001
From: Andrew Chen Wang <60190294+Andrew-Chen-Wang@users.noreply.github.com>
Date: Thu, 14 Oct 2021 09:36:33 -0400
Subject: [PATCH 0183/1164] Remove unused BitFieldOperation in client.py
 (#1590)

---
 redis/client.py | 97 -------------------------------------------------
 1 file changed, 97 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index cbdb13d4fd..2e2a26a2ad 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1862,100 +1862,3 @@ def __call__(self, keys=[], args=[], client=None):
             # Overwrite the sha just in case there was a discrepancy.
             self.sha = client.script_load(self.script)
             return client.evalsha(self.sha, len(keys), *args)
-
-
-class BitFieldOperation:
-    """
-    Command builder for BITFIELD commands.
-    """
-    def __init__(self, client, key, default_overflow=None):
-        self.client = client
-        self.key = key
-        self._default_overflow = default_overflow
-        self.reset()
-
-    def reset(self):
-        """
-        Reset the state of the instance to when it was constructed
-        """
-        self.operations = []
-        self._last_overflow = 'WRAP'
-        self.overflow(self._default_overflow or self._last_overflow)
-
-    def overflow(self, overflow):
-        """
-        Update the overflow algorithm of successive INCRBY operations
-        :param overflow: Overflow algorithm, one of WRAP, SAT, FAIL. See the
-            Redis docs for descriptions of these algorithmsself.
-        :returns: a :py:class:`BitFieldOperation` instance.
-        """
-        overflow = overflow.upper()
-        if overflow != self._last_overflow:
-            self._last_overflow = overflow
-            self.operations.append(('OVERFLOW', overflow))
-        return self
-
-    def incrby(self, fmt, offset, increment, overflow=None):
-        """
-        Increment a bitfield by a given amount.
-        :param fmt: format-string for the bitfield being updated, e.g. 'u8'
-            for an unsigned 8-bit integer.
-        :param offset: offset (in number of bits). If prefixed with a
-            '#', this is an offset multiplier, e.g. given the arguments
-            fmt='u8', offset='#2', the offset will be 16.
-        :param int increment: value to increment the bitfield by.
-        :param str overflow: overflow algorithm. Defaults to WRAP, but other
-            acceptable values are SAT and FAIL. See the Redis docs for
-            descriptions of these algorithms.
-        :returns: a :py:class:`BitFieldOperation` instance.
-        """
-        if overflow is not None:
-            self.overflow(overflow)
-
-        self.operations.append(('INCRBY', fmt, offset, increment))
-        return self
-
-    def get(self, fmt, offset):
-        """
-        Get the value of a given bitfield.
-        :param fmt: format-string for the bitfield being read, e.g. 'u8' for
-            an unsigned 8-bit integer.
-        :param offset: offset (in number of bits). If prefixed with a
-            '#', this is an offset multiplier, e.g. given the arguments
-            fmt='u8', offset='#2', the offset will be 16.
-        :returns: a :py:class:`BitFieldOperation` instance.
-        """
-        self.operations.append(('GET', fmt, offset))
-        return self
-
-    def set(self, fmt, offset, value):
-        """
-        Set the value of a given bitfield.
-        :param fmt: format-string for the bitfield being read, e.g. 'u8' for
-            an unsigned 8-bit integer.
-        :param offset: offset (in number of bits). If prefixed with a
-            '#', this is an offset multiplier, e.g. given the arguments
-            fmt='u8', offset='#2', the offset will be 16.
-        :param int value: value to set at the given position.
-        :returns: a :py:class:`BitFieldOperation` instance.
-        """
-        self.operations.append(('SET', fmt, offset, value))
-        return self
-
-    @property
-    def command(self):
-        cmd = ['BITFIELD', self.key]
-        for ops in self.operations:
-            cmd.extend(ops)
-        return cmd
-
-    def execute(self):
-        """
-        Execute the operation(s) in a single BITFIELD command. The return value
-        is a list of values corresponding to each operation. If the client
-        used to create this instance was a pipeline, the list of values
-        will be present within the pipeline's execute.
-        """
-        command = self.command
-        self.reset()
-        return self.client.execute_command(*command)

From 9e8cfaac8bbab84c2340b55e5ac55289834b558b Mon Sep 17 00:00:00 2001
From: nbraun-amazon <85549956+nbraun-amazon@users.noreply.github.com>
Date: Thu, 14 Oct 2021 16:41:15 +0300
Subject: [PATCH 0184/1164] Fix `retry` attribute in UnixDomainSocketConnection
 (#1604)

---
 redis/connection.py | 16 +++++++++++++++-
 tests/test_retry.py | 16 +++++++++-------
 2 files changed, 24 insertions(+), 8 deletions(-)

diff --git a/redis/connection.py b/redis/connection.py
index de30f0c638..5528589026 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -880,7 +880,13 @@ def __init__(self, path='', db=0, username=None, password=None,
                  encoding_errors='strict', decode_responses=False,
                  retry_on_timeout=False,
                  parser_class=DefaultParser, socket_read_size=65536,
-                 health_check_interval=0, client_name=None):
+                 health_check_interval=0, client_name=None,
+                 retry=None):
+        """
+        Initialize a new UnixDomainSocketConnection.
+        To specify a retry policy, first set `retry_on_timeout` to `True`
+        then set `retry` to a valid `Retry` object
+        """
         self.pid = os.getpid()
         self.path = path
         self.db = db
@@ -889,6 +895,14 @@ def __init__(self, path='', db=0, username=None, password=None,
         self.password = password
         self.socket_timeout = socket_timeout
         self.retry_on_timeout = retry_on_timeout
+        if retry_on_timeout:
+            if retry is None:
+                self.retry = Retry(NoBackoff(), 1)
+            else:
+                # deep-copy the Retry object as it is mutable
+                self.retry = copy.deepcopy(retry)
+        else:
+            self.retry = Retry(NoBackoff(), 0)
         self.health_check_interval = health_check_interval
         self.next_health_check = 0
         self.encoder = Encoder(encoding, encoding_errors, decode_responses)
diff --git a/tests/test_retry.py b/tests/test_retry.py
index 24d9683f17..535485acae 100644
--- a/tests/test_retry.py
+++ b/tests/test_retry.py
@@ -2,7 +2,7 @@
 import pytest
 
 from redis.exceptions import ConnectionError
-from redis.connection import Connection
+from redis.connection import Connection, UnixDomainSocketConnection
 from redis.retry import Retry
 
 
@@ -20,20 +20,22 @@ def compute(self, failures):
 
 
 class TestConnectionConstructorWithRetry:
-    "Test that the Connection constructor properly handles Retry objects"
+    "Test that the Connection constructors properly handles Retry objects"
 
     @pytest.mark.parametrize("retry_on_timeout", [False, True])
-    def test_retry_on_timeout_boolean(self, retry_on_timeout):
-        c = Connection(retry_on_timeout=retry_on_timeout)
+    @pytest.mark.parametrize("Class", [Connection, UnixDomainSocketConnection])
+    def test_retry_on_timeout_boolean(self, Class, retry_on_timeout):
+        c = Class(retry_on_timeout=retry_on_timeout)
         assert c.retry_on_timeout == retry_on_timeout
         assert isinstance(c.retry, Retry)
         assert c.retry._retries == (1 if retry_on_timeout else 0)
 
     @pytest.mark.parametrize("retries", range(10))
-    def test_retry_on_timeout_retry(self, retries):
+    @pytest.mark.parametrize("Class", [Connection, UnixDomainSocketConnection])
+    def test_retry_on_timeout_retry(self, Class, retries):
         retry_on_timeout = retries > 0
-        c = Connection(retry_on_timeout=retry_on_timeout,
-                       retry=Retry(NoBackoff(), retries))
+        c = Class(retry_on_timeout=retry_on_timeout,
+                  retry=Retry(NoBackoff(), retries))
         assert c.retry_on_timeout == retry_on_timeout
         assert isinstance(c.retry, Retry)
         assert c.retry._retries == retries

From 0a55859a5ec3d5ab70ff1b0ea27bc13d91621ab9 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 14 Oct 2021 16:42:07 +0300
Subject: [PATCH 0185/1164] bringing CHANGES up-to-date (#1600)

---
 CHANGES | 27 +++++++++++++++++++--------
 1 file changed, 19 insertions(+), 8 deletions(-)

diff --git a/CHANGES b/CHANGES
index 057423dac1..801e2f1253 100644
--- a/CHANGES
+++ b/CHANGES
@@ -4,16 +4,27 @@
       urllib.parse.unquote. Prior versions of redis-py supported this by
       specifying the ``decode_components`` flag to the ``from_url`` functions.
       This is now done by default and cannot be disabled. #589
-    * POTENTIALLY INCOMPATIBLE: Redis commands were moved into a mixin 
-      (see commands.py). Anyone importing ``redis.client`` to access commands 
-      directly should import ``redis.commands``.
+    * POTENTIALLY INCOMPATIBLE: Redis commands were moved into a mixin
+      (see commands.py). Anyone importing ``redis.client`` to access commands
+      directly should import ``redis.commands``. #1534, #1550
+    * Removed technical debt on REDIS_6_VERSION placeholder. Thanks @chayim #1582.
+    * Various docus fixes. Thanks @Andrew-Chen-Wang #1585, #1586.
+    * Support for LOLWUT command, available since Redis 5.0.0.
+      Thanks @brainix #1568.
+    * Added support for CLIENT REPLY, available in Redis 3.2.0.
+      Thanks @chayim #1581.
+    * Support for Auto-reconnect PubSub on get_message. Thanks @luhn #1574.
+    * Fix RST syntax error in README/ Thanks @JanCBrammer #1451.
+    * IDLETIME and FREQ support for RESTORE. Thanks @chayim #1580.
+    * Supporting args with MODULE LOAD. Thanks @chayim #1579.
+    * Updating RedisLabs with Redis. Thanks @gkorland #1575.
     * Added support for ASYNC to SCRIPT FLUSH available in Redis 6.2.0.
       Thanks @chayim. #1567
-    * Added CLIENT LIST fix to support multiple client ids available in 
+    * Added CLIENT LIST fix to support multiple client ids available in
       Redis 2.8.12. Thanks @chayim #1563.
     * Added DISCARD support for pipelines available in Redis 2.0.0.
       Thanks @chayim #1565.
-    * Added ACL DELUSER support for deleting lists of users available in 
+    * Added ACL DELUSER support for deleting lists of users available in
       Redis 6.2.0. Thanks @chayim. #1562
     * Added CLIENT TRACKINFO support available in Redis 6.2.0.
       Thanks @chayim. #1560
@@ -31,10 +42,10 @@
       Thanks @ian28223 #1489.
     * Added support for STRALGO available in Redis 6.0.0.
       Thanks @AvitalFineRedis. #1528
-    * Addes support for ZMSCORE available in Redis 6.2.0. 
+    * Addes support for ZMSCORE available in Redis 6.2.0.
       Thanks @2014BDuck and @jiekun.zhu. #1437
-    * Support MINID and LIMIT on XADD available in Redis 6.2.0. 
-      Thanks @AvitalFineRedis. #1548  
+    * Support MINID and LIMIT on XADD available in Redis 6.2.0.
+      Thanks @AvitalFineRedis. #1548
     * Added sentinel commands FLUSHCONFIG, CKQUORUM, FAILOVER, and RESET
       available in Redis 2.8.12.
       Thanks @otherpirate. #834

From 2bb225a3238b2d221fff9d1200a05f1b5a9b4dd0 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 17 Oct 2021 11:12:24 +0300
Subject: [PATCH 0186/1164] 4.0.0 beta 1 versioning - prior to pypi release
 (#1615)

---
 redis/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/__init__.py b/redis/__init__.py
index f0193d8582..a3b5eb67e3 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -31,7 +31,7 @@ def int_or_str(value):
         return value
 
 
-__version__ = '3.9.9'
+__version__ = '4.0.0b1'
 VERSION = tuple(map(int_or_str, __version__.split('.')))
 
 __all__ = [

From cdd0beae029f03f5246d170c0ba0458cddcdb36b Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 17 Oct 2021 13:10:36 +0300
Subject: [PATCH 0187/1164] Adding the release drafter to help simplify release
 notes (#1618)

---
 .github/release-drafter-config.yml    | 40 +++++++++++++++++++++++++++
 .github/workflows/release-drafter.yml | 19 +++++++++++++
 2 files changed, 59 insertions(+)
 create mode 100644 .github/release-drafter-config.yml
 create mode 100644 .github/workflows/release-drafter.yml

diff --git a/.github/release-drafter-config.yml b/.github/release-drafter-config.yml
new file mode 100644
index 0000000000..5e429972b6
--- /dev/null
+++ b/.github/release-drafter-config.yml
@@ -0,0 +1,40 @@
+name-template: 'Version $NEXT_PATCH_VERSION'
+tag-template: 'v$NEXT_PATCH_VERSION'
+autolabeler:
+  - label: 'chore'
+    files:
+      - '*.md'
+      - '.github/*'
+  - label: 'bug'
+    branch:
+      - '/bug-.+'
+  - label: 'chore'
+    branch:
+      - '/chore-.+'
+  - label: 'feature'
+    branch:
+      - '/feature-.+'
+categories:
+  - title: 'Breaking Changes'
+    labels:
+      - 'breakingchange'
+  - title: '🚀 New Features'
+    labels:
+      - 'feature'
+      - 'enhancement'
+  - title: '🐛 Bug Fixes'
+    labels:
+      - 'fix'
+      - 'bugfix'
+      - 'bug'
+  - title: '🧰 Maintenance'
+    label: 'chore'
+change-template: '- $TITLE (#$NUMBER)'
+exclude-labels:
+  - 'skip-changelog'
+template: |
+  ## Changes
+
+  $CHANGES
+
+We'd like to thank all of the contributors who have worked on this release!
\ No newline at end of file
diff --git a/.github/workflows/release-drafter.yml b/.github/workflows/release-drafter.yml
new file mode 100644
index 0000000000..ec2d88bf6e
--- /dev/null
+++ b/.github/workflows/release-drafter.yml
@@ -0,0 +1,19 @@
+name: Release Drafter
+
+on:
+  push:
+    # branches to consider in the event; optional, defaults to all
+    branches:
+      - master
+
+jobs:
+  update_release_draft:
+    runs-on: ubuntu-latest
+    steps:
+      # Drafts your next Release notes as Pull Requests are merged into "master"
+      - uses: release-drafter/release-drafter@v5
+        with:
+          # (Optional) specify config name to use, relative to .github/. Default: release-drafter.yml
+           config-name: release-drafter-config.yml
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

From 42227d232a35fd7b7b37f7e9341d4a65c0a6d0ff Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 17 Oct 2021 13:53:30 +0300
Subject: [PATCH 0188/1164] adding contributors to the changes (#1619)

---
 .github/release-drafter-config.yml | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/.github/release-drafter-config.yml b/.github/release-drafter-config.yml
index 5e429972b6..f17a2992fa 100644
--- a/.github/release-drafter-config.yml
+++ b/.github/release-drafter-config.yml
@@ -37,4 +37,8 @@ template: |
 
   $CHANGES
 
-We'd like to thank all of the contributors who have worked on this release!
\ No newline at end of file
+  ## Contributors
+  We'd like to thank all the contributors who worked on this release!
+
+  $CONTRIBUTORS
+

From 4f4adadc08f6e2726fe2d342e7d7751c036fb78f Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Mon, 18 Oct 2021 10:02:35 +0200
Subject: [PATCH 0189/1164] add support to `ZRANGE` and `ZRANGESTORE`
 parameters (#1603)

---
 redis/commands.py      | 245 ++++++++++++++++++++++-------------------
 tests/test_commands.py |  58 ++++++++--
 2 files changed, 181 insertions(+), 122 deletions(-)

diff --git a/redis/commands.py b/redis/commands.py
index baf5239ae4..ee883bcc74 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -1073,7 +1073,7 @@ def hrandfield(self, key, count=None, withvalues=False):
         return self.execute_command("HRANDFIELD", key, *params)
 
     def randomkey(self):
-        "Returns the name of a random key"
+        """Returns the name of a random key"""
         return self.execute_command('RANDOMKEY')
 
     def rename(self, src, dst):
@@ -1083,7 +1083,7 @@ def rename(self, src, dst):
         return self.execute_command('RENAME', src, dst)
 
     def renamenx(self, src, dst):
-        "Rename key ``src`` to ``dst`` if ``dst`` doesn't already exist"
+        """Rename key ``src`` to ``dst`` if ``dst`` doesn't already exist"""
         return self.execute_command('RENAMENX', src, dst)
 
     def restore(self, name, ttl, value, replace=False, absttl=False,
@@ -1545,32 +1545,25 @@ def sort(self, name, start=None, num=None, by=None, get=None,
 
         pieces = [name]
         if by is not None:
-            pieces.append(b'BY')
-            pieces.append(by)
+            pieces.extend([b'BY', by])
         if start is not None and num is not None:
-            pieces.append(b'LIMIT')
-            pieces.append(start)
-            pieces.append(num)
+            pieces.extend([b'LIMIT', start, num])
         if get is not None:
             # If get is a string assume we want to get a single value.
             # Otherwise assume it's an interable and we want to get multiple
             # values. We can't just iterate blindly because strings are
             # iterable.
             if isinstance(get, (bytes, str)):
-                pieces.append(b'GET')
-                pieces.append(get)
+                pieces.extend([b'GET', get])
             else:
                 for g in get:
-                    pieces.append(b'GET')
-                    pieces.append(g)
+                    pieces.extend([b'GET', g])
         if desc:
             pieces.append(b'DESC')
         if alpha:
             pieces.append(b'ALPHA')
         if store is not None:
-            pieces.append(b'STORE')
-            pieces.append(store)
-
+            pieces.extend([b'STORE', store])
         if groups:
             if not get or isinstance(get, (bytes, str)) or len(get) < 2:
                 raise DataError('when using "groups" the "get" argument '
@@ -1729,15 +1722,15 @@ def zscan_iter(self, name, match=None, count=None,
 
     # SET COMMANDS
     def sadd(self, name, *values):
-        "Add ``value(s)`` to set ``name``"
+        """Add ``value(s)`` to set ``name``"""
         return self.execute_command('SADD', name, *values)
 
     def scard(self, name):
-        "Return the number of elements in set ``name``"
+        """Return the number of elements in set ``name``"""
         return self.execute_command('SCARD', name)
 
     def sdiff(self, keys, *args):
-        "Return the difference of sets specified by ``keys``"
+        """Return the difference of sets specified by ``keys``"""
         args = list_or_args(keys, args)
         return self.execute_command('SDIFF', *args)
 
@@ -1750,7 +1743,7 @@ def sdiffstore(self, dest, keys, *args):
         return self.execute_command('SDIFFSTORE', dest, *args)
 
     def sinter(self, keys, *args):
-        "Return the intersection of sets specified by ``keys``"
+        """Return the intersection of sets specified by ``keys``"""
         args = list_or_args(keys, args)
         return self.execute_command('SINTER', *args)
 
@@ -1763,15 +1756,17 @@ def sinterstore(self, dest, keys, *args):
         return self.execute_command('SINTERSTORE', dest, *args)
 
     def sismember(self, name, value):
-        "Return a boolean indicating if ``value`` is a member of set ``name``"
+        """
+        Return a boolean indicating if ``value`` is a member of set ``name``
+        """
         return self.execute_command('SISMEMBER', name, value)
 
     def smembers(self, name):
-        "Return all members of the set ``name``"
+        """Return all members of the set ``name``"""
         return self.execute_command('SMEMBERS', name)
 
     def smove(self, src, dst, value):
-        "Move ``value`` from set ``src`` to set ``dst`` atomically"
+        """Move ``value`` from set ``src`` to set ``dst`` atomically"""
         return self.execute_command('SMOVE', src, dst, value)
 
     def spop(self, name, count=None):
@@ -1850,8 +1845,7 @@ def xadd(self, name, fields, id='*', maxlen=None, approximate=True,
                 pieces.append(b'~')
             pieces.append(minid)
         if limit is not None:
-            pieces.append(b"LIMIT")
-            pieces.append(limit)
+            pieces.extend([b'LIMIT', limit])
         if nomkstream:
             pieces.append(b'NOMKSTREAM')
         pieces.append(id)
@@ -2440,41 +2434,113 @@ def bzpopmin(self, keys, timeout=0):
         keys.append(timeout)
         return self.execute_command('BZPOPMIN', *keys)
 
+    def _zrange(self, command, dest, name, start, end, desc=False,
+                byscore=False, bylex=False, withscores=False,
+                score_cast_func=float, offset=None, num=None):
+        if byscore and bylex:
+            raise DataError("``byscore`` and ``bylex`` can not be "
+                            "specified together.")
+        if (offset is not None and num is None) or \
+                (num is not None and offset is None):
+            raise DataError("``offset`` and ``num`` must both be specified.")
+        if bylex and withscores:
+            raise DataError("``withscores`` not supported in combination "
+                            "with ``bylex``.")
+        pieces = [command]
+        if dest:
+            pieces.append(dest)
+        pieces.extend([name, start, end])
+        if byscore:
+            pieces.append('BYSCORE')
+        if bylex:
+            pieces.append('BYLEX')
+        if desc:
+            pieces.append('REV')
+        if offset is not None and num is not None:
+            pieces.extend(['LIMIT', offset, num])
+        if withscores:
+            pieces.append('WITHSCORES')
+        options = {
+            'withscores': withscores,
+            'score_cast_func': score_cast_func
+        }
+        return self.execute_command(*pieces, **options)
+
     def zrange(self, name, start, end, desc=False, withscores=False,
-               score_cast_func=float):
+               score_cast_func=float, byscore=False, bylex=False,
+               offset=None, num=None):
         """
         Return a range of values from sorted set ``name`` between
         ``start`` and ``end`` sorted in ascending order.
 
         ``start`` and ``end`` can be negative, indicating the end of the range.
 
-        ``desc`` a boolean indicating whether to sort the results descendingly
+        ``desc`` a boolean indicating whether to sort the results in reversed
+        order.
 
         ``withscores`` indicates to return the scores along with the values.
+        The return type is a list of (value, score) pairs.
+
+        ``score_cast_func`` a callable used to cast the score return value.
+
+        ``byscore`` when set to True, returns the range of elements from the
+        sorted set having scores equal or between ``start`` and ``end``.
+
+        ``bylex`` when set to True, returns the range of elements from the
+        sorted set between the ``start`` and ``end`` lexicographical closed
+        range intervals.
+        Valid ``start`` and ``end`` must start with ( or [, in order to specify
+        whether the range interval is exclusive or inclusive, respectively.
+
+        ``offset`` and ``num`` are specified, then return a slice of the range.
+        Can't be provided when using ``bylex``.
+        """
+        return self._zrange('ZRANGE', None, name, start, end, desc, byscore,
+                            bylex, withscores, score_cast_func, offset, num)
+
+    def zrevrange(self, name, start, end, withscores=False,
+                  score_cast_func=float):
+        """
+        Return a range of values from sorted set ``name`` between
+        ``start`` and ``end`` sorted in descending order.
+
+        ``start`` and ``end`` can be negative, indicating the end of the range.
+
+        ``withscores`` indicates to return the scores along with the values
         The return type is a list of (value, score) pairs
 
         ``score_cast_func`` a callable used to cast the score return value
         """
-        if desc:
-            return self.zrevrange(name, start, end, withscores,
-                                  score_cast_func)
-        pieces = ['ZRANGE', name, start, end]
-        if withscores:
-            pieces.append(b'WITHSCORES')
-        options = {
-            'withscores': withscores,
-            'score_cast_func': score_cast_func
-        }
-        return self.execute_command(*pieces, **options)
+        return self.zrange(name, start, end, desc=True,
+                           withscores=withscores,
+                           score_cast_func=score_cast_func)
 
-    def zrangestore(self, dest, name, start, end):
+    def zrangestore(self, dest, name, start, end,
+                    byscore=False, bylex=False, desc=False,
+                    offset=None, num=None):
         """
         Stores in ``dest`` the result of a range of values from sorted set
         ``name`` between ``start`` and ``end`` sorted in ascending order.
 
         ``start`` and ``end`` can be negative, indicating the end of the range.
+
+        ``byscore`` when set to True, returns the range of elements from the
+        sorted set having scores equal or between ``start`` and ``end``.
+
+        ``bylex`` when set to True, returns the range of elements from the
+        sorted set between the ``start`` and ``end`` lexicographical closed
+        range intervals.
+        Valid ``start`` and ``end`` must start with ( or [, in order to specify
+        whether the range interval is exclusive or inclusive, respectively.
+
+        ``desc`` a boolean indicating whether to sort the results in reversed
+        order.
+
+        ``offset`` and ``num`` are specified, then return a slice of the range.
+        Can't be provided when using ``bylex``.
         """
-        return self.execute_command('ZRANGESTORE', dest, name, start, end)
+        return self._zrange('ZRANGESTORE', dest, name, start, end, desc,
+                            byscore, bylex, False, None, offset, num)
 
     def zrangebylex(self, name, min, max, start=None, num=None):
         """
@@ -2484,13 +2550,7 @@ def zrangebylex(self, name, min, max, start=None, num=None):
         If ``start`` and ``num`` are specified, then return a slice of the
         range.
         """
-        if (start is not None and num is None) or \
-                (num is not None and start is None):
-            raise DataError("``start`` and ``num`` must both be specified")
-        pieces = ['ZRANGEBYLEX', name, min, max]
-        if start is not None and num is not None:
-            pieces.extend([b'LIMIT', start, num])
-        return self.execute_command(*pieces)
+        return self.zrange(name, min, max, bylex=True, offset=start, num=num)
 
     def zrevrangebylex(self, name, max, min, start=None, num=None):
         """
@@ -2500,13 +2560,8 @@ def zrevrangebylex(self, name, max, min, start=None, num=None):
         If ``start`` and ``num`` are specified, then return a slice of the
         range.
         """
-        if (start is not None and num is None) or \
-                (num is not None and start is None):
-            raise DataError("``start`` and ``num`` must both be specified")
-        pieces = ['ZREVRANGEBYLEX', name, max, min]
-        if start is not None and num is not None:
-            pieces.extend([b'LIMIT', start, num])
-        return self.execute_command(*pieces)
+        return self.zrange(name, max, min, desc=True,
+                           bylex=True, offset=start, num=num)
 
     def zrangebyscore(self, name, min, max, start=None, num=None,
                       withscores=False, score_cast_func=float):
@@ -2522,19 +2577,29 @@ def zrangebyscore(self, name, min, max, start=None, num=None,
 
         `score_cast_func`` a callable used to cast the score return value
         """
-        if (start is not None and num is None) or \
-                (num is not None and start is None):
-            raise DataError("``start`` and ``num`` must both be specified")
-        pieces = ['ZRANGEBYSCORE', name, min, max]
-        if start is not None and num is not None:
-            pieces.extend([b'LIMIT', start, num])
-        if withscores:
-            pieces.append(b'WITHSCORES')
-        options = {
-            'withscores': withscores,
-            'score_cast_func': score_cast_func
-        }
-        return self.execute_command(*pieces, **options)
+        return self.zrange(name, min, max, byscore=True,
+                           offset=start, num=num,
+                           withscores=withscores,
+                           score_cast_func=score_cast_func)
+
+    def zrevrangebyscore(self, name, max, min, start=None, num=None,
+                         withscores=False, score_cast_func=float):
+        """
+        Return a range of values from the sorted set ``name`` with scores
+        between ``min`` and ``max`` in descending order.
+
+        If ``start`` and ``num`` are specified, then return a slice
+        of the range.
+
+        ``withscores`` indicates to return the scores along with the values.
+        The return type is a list of (value, score) pairs
+
+        ``score_cast_func`` a callable used to cast the score return value
+        """
+        return self.zrange(name, max, min, desc=True,
+                           byscore=True, offset=start,
+                           num=num, withscores=withscores,
+                           score_cast_func=score_cast_func)
 
     def zrank(self, name, value):
         """
@@ -2572,56 +2637,6 @@ def zremrangebyscore(self, name, min, max):
         """
         return self.execute_command('ZREMRANGEBYSCORE', name, min, max)
 
-    def zrevrange(self, name, start, end, withscores=False,
-                  score_cast_func=float):
-        """
-        Return a range of values from sorted set ``name`` between
-        ``start`` and ``end`` sorted in descending order.
-
-        ``start`` and ``end`` can be negative, indicating the end of the range.
-
-        ``withscores`` indicates to return the scores along with the values
-        The return type is a list of (value, score) pairs
-
-        ``score_cast_func`` a callable used to cast the score return value
-        """
-        pieces = ['ZREVRANGE', name, start, end]
-        if withscores:
-            pieces.append(b'WITHSCORES')
-        options = {
-            'withscores': withscores,
-            'score_cast_func': score_cast_func
-        }
-        return self.execute_command(*pieces, **options)
-
-    def zrevrangebyscore(self, name, max, min, start=None, num=None,
-                         withscores=False, score_cast_func=float):
-        """
-        Return a range of values from the sorted set ``name`` with scores
-        between ``min`` and ``max`` in descending order.
-
-        If ``start`` and ``num`` are specified, then return a slice
-        of the range.
-
-        ``withscores`` indicates to return the scores along with the values.
-        The return type is a list of (value, score) pairs
-
-        ``score_cast_func`` a callable used to cast the score return value
-        """
-        if (start is not None and num is None) or \
-                (num is not None and start is None):
-            raise DataError("``start`` and ``num`` must both be specified")
-        pieces = ['ZREVRANGEBYSCORE', name, max, min]
-        if start is not None and num is not None:
-            pieces.extend([b'LIMIT', start, num])
-        if withscores:
-            pieces.append(b'WITHSCORES')
-        options = {
-            'withscores': withscores,
-            'score_cast_func': score_cast_func
-        }
-        return self.execute_command(*pieces, **options)
-
     def zrevrank(self, name, value):
         """
         Returns a 0-based value indicating the descending rank of
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 904e27fd56..8929198783 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1840,6 +1840,7 @@ def test_zrange(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
         assert r.zrange('a', 0, 1) == [b'a1', b'a2']
         assert r.zrange('a', 1, 2) == [b'a2', b'a3']
+        assert r.zrange('a', 0, 2, desc=True) == [b'a3', b'a2', b'a1']
 
         # withscores
         assert r.zrange('a', 0, 1, withscores=True) == \
@@ -1851,6 +1852,46 @@ def test_zrange(self, r):
         assert r.zrange('a', 0, 1, withscores=True, score_cast_func=int) == \
                [(b'a1', 1), (b'a2', 2)]
 
+    def test_zrange_errors(self, r):
+        with pytest.raises(exceptions.DataError):
+            r.zrange('a', 0, 1, byscore=True, bylex=True)
+        with pytest.raises(exceptions.DataError):
+            r.zrange('a', 0, 1, bylex=True, withscores=True)
+        with pytest.raises(exceptions.DataError):
+            r.zrange('a', 0, 1, byscore=True, withscores=True, offset=4)
+        with pytest.raises(exceptions.DataError):
+            r.zrange('a', 0, 1, byscore=True, withscores=True, num=2)
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_zrange_params(self, r):
+        # bylex
+        r.zadd('a', {'a': 0, 'b': 0, 'c': 0, 'd': 0, 'e': 0, 'f': 0, 'g': 0})
+        assert r.zrange('a', '[aaa', '(g', bylex=True) == \
+               [b'b', b'c', b'd', b'e', b'f']
+        assert r.zrange('a', '[f', '+', bylex=True) == [b'f', b'g']
+        assert r.zrange('a', '+', '[f', desc=True, bylex=True) == [b'g', b'f']
+        assert r.zrange('a', '-', '+', bylex=True, offset=3, num=2) == \
+               [b'd', b'e']
+        assert r.zrange('a', '+', '-', desc=True, bylex=True,
+                        offset=3, num=2) == \
+               [b'd', b'c']
+
+        # byscore
+        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3, 'a4': 4, 'a5': 5})
+        assert r.zrange('a', 2, 4, byscore=True, offset=1, num=2) == \
+               [b'a3', b'a4']
+        assert r.zrange('a', 4, 2, desc=True, byscore=True,
+                        offset=1, num=2) == \
+               [b'a3', b'a2']
+        assert r.zrange('a', 2, 4, byscore=True, withscores=True) == \
+               [(b'a2', 2.0), (b'a3', 3.0), (b'a4', 4.0)]
+        assert r.zrange('a', 4, 2, desc=True, byscore=True,
+                        withscores=True, score_cast_func=int) == \
+               [(b'a4', 4), (b'a3', 3), (b'a2', 2)]
+
+        # rev
+        assert r.zrange('a', 0, 1, desc=True) == [b'a5', b'a4']
+
     @skip_if_server_version_lt('6.2.0')
     def test_zrangestore(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
@@ -1860,6 +1901,16 @@ def test_zrangestore(self, r):
         assert r.zrange('b', 0, -1) == [b'a2', b'a3']
         assert r.zrange('b', 0, -1, withscores=True) == \
                [(b'a2', 2), (b'a3', 3)]
+        # reversed order
+        assert r.zrangestore('b', 'a', 1, 2, desc=True)
+        assert r.zrange('b', 0, -1) == [b'a1', b'a2']
+        # by score
+        assert r.zrangestore('b', 'a', 1, 2, byscore=True,
+                             offset=0, num=1)
+        assert r.zrange('b', 0, -1) == [b'a1']
+        # by lex
+        assert r.zrange('a', '[a2', '(a3', bylex=True) == \
+               [b'a2']
 
     @skip_if_server_version_lt('2.8.9')
     def test_zrangebylex(self, r):
@@ -1885,16 +1936,12 @@ def test_zrevrangebylex(self, r):
     def test_zrangebyscore(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3, 'a4': 4, 'a5': 5})
         assert r.zrangebyscore('a', 2, 4) == [b'a2', b'a3', b'a4']
-
         # slicing with start/num
         assert r.zrangebyscore('a', 2, 4, start=1, num=2) == \
                [b'a3', b'a4']
-
         # withscores
         assert r.zrangebyscore('a', 2, 4, withscores=True) == \
                [(b'a2', 2.0), (b'a3', 3.0), (b'a4', 4.0)]
-
-        # custom score function
         assert r.zrangebyscore('a', 2, 4, withscores=True,
                                score_cast_func=int) == \
                [(b'a2', 2), (b'a3', 3), (b'a4', 4)]
@@ -1958,15 +2005,12 @@ def test_zrevrange(self, r):
     def test_zrevrangebyscore(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3, 'a4': 4, 'a5': 5})
         assert r.zrevrangebyscore('a', 4, 2) == [b'a4', b'a3', b'a2']
-
         # slicing with start/num
         assert r.zrevrangebyscore('a', 4, 2, start=1, num=2) == \
                [b'a3', b'a2']
-
         # withscores
         assert r.zrevrangebyscore('a', 4, 2, withscores=True) == \
                [(b'a4', 4.0), (b'a3', 3.0), (b'a2', 2.0)]
-
         # custom score function
         assert r.zrevrangebyscore('a', 4, 2, withscores=True,
                                   score_cast_func=int) == \

From 55ea5fb2051d7c80ae86766758058502f50ba23c Mon Sep 17 00:00:00 2001
From: Andrew Chen Wang <60190294+Andrew-Chen-Wang@users.noreply.github.com>
Date: Mon, 18 Oct 2021 04:03:21 -0400
Subject: [PATCH 0190/1164] Fix docs for client_kill_filter (#1584)

---
 redis/commands.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/redis/commands.py b/redis/commands.py
index ee883bcc74..2eb3d1052d 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -310,10 +310,10 @@ def client_kill_filter(self, _id=None, _type=None, addr=None,
         'master', 'slave' or 'pubsub'
         :param addr: Kills a client by its 'address:port'
         :param skipme: If True, then the client calling the command
-        :param laddr: Kills a client by its 'local (bind)  address:port'
-        :param user: Kills a client for a specific user name
         will not get killed even if it is identified by one of the filter
         options. If skipme is not provided, the server defaults to skipme=True
+        :param laddr: Kills a client by its 'local (bind) address:port'
+        :param user: Kills a client for a specific user name
         """
         args = []
         if _type is not None:

From 46430c2b756df8e6ffe7b33ac52c987a6a9c8cce Mon Sep 17 00:00:00 2001
From: Andrew Chen Wang <60190294+Andrew-Chen-Wang@users.noreply.github.com>
Date: Mon, 18 Oct 2021 04:05:19 -0400
Subject: [PATCH 0191/1164] Fix grammar of get param in set command (#1588)

---
 redis/commands.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/commands.py b/redis/commands.py
index 2eb3d1052d..9bd57e8184 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -1146,7 +1146,7 @@ def set(self, name, value,
             (Available since Redis 6.0)
 
         ``get`` if True, set the value at key ``name`` to ``value`` and return
-            the old value stored at key, or None when key did not exist.
+            the old value stored at key, or None if the key did not exist.
             (Available since Redis 6.2)
 
         ``exat`` sets an expire flag on key ``name`` for ``ex`` seconds,

From 03a0c312699b3e130e8032a41a9999d709a035b9 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Mon, 18 Oct 2021 10:07:02 +0200
Subject: [PATCH 0192/1164] Add support to NX XX and CH to `GEOADD` (#1605)

---
 redis/commands.py      | 26 ++++++++++++--
 tests/test_commands.py | 80 ++++++++++++++++++++++++++++--------------
 2 files changed, 77 insertions(+), 29 deletions(-)

diff --git a/redis/commands.py b/redis/commands.py
index 9bd57e8184..9dad8a59b8 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -2904,17 +2904,39 @@ def register_script(self, script):
         return Script(self, script)
 
     # GEO COMMANDS
-    def geoadd(self, name, *values):
+    def geoadd(self, name, values, nx=False, xx=False, ch=False):
         """
         Add the specified geospatial items to the specified key identified
         by the ``name`` argument. The Geospatial items are given as ordered
         members of the ``values`` argument, each item or place is formed by
         the triad longitude, latitude and name.
+
+        Note: You can use ZREM to remove elements.
+
+        ``nx`` forces ZADD to only create new elements and not to update
+        scores for elements that already exist.
+
+        ``xx`` forces ZADD to only update scores of elements that already
+        exist. New elements will not be added.
+
+        ``ch`` modifies the return value to be the numbers of elements changed.
+        Changed elements include new elements that were added and elements
+        whose scores changed.
         """
+        if nx and xx:
+            raise DataError("GEOADD allows either 'nx' or 'xx', not both")
         if len(values) % 3 != 0:
             raise DataError("GEOADD requires places with lon, lat and name"
                             " values")
-        return self.execute_command('GEOADD', name, *values)
+        pieces = [name]
+        if nx:
+            pieces.append('NX')
+        if xx:
+            pieces.append('XX')
+        if ch:
+            pieces.append('CH')
+        pieces.extend(values)
+        return self.execute_command('GEOADD', *pieces)
 
     def geodist(self, name, place1, place2, unit=None):
         """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 8929198783..802d8e448c 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2422,35 +2422,63 @@ def test_readonly(self, mock_cluster_resp_ok):
     def test_geoadd(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
-
-        assert r.geoadd('barcelona', *values) == 2
+        assert r.geoadd('barcelona', values) == 2
         assert r.zcard('barcelona') == 2
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_geoadd_nx(self, r):
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
+                 (2.1873744593677, 41.406342043777, 'place2')
+        assert r.geoadd('a', values) == 2
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
+                 (2.1873744593677, 41.406342043777, 'place2') + \
+                 (2.1804738294738, 41.405647879212, 'place3')
+        assert r.geoadd('a', values, nx=True) == 1
+        assert r.zrange('a', 0, -1) == [b'place3', b'place2', b'place1']
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_geoadd_xx(self, r):
+        values = (2.1909389952632, 41.433791470673, 'place1')
+        assert r.geoadd('a', values) == 1
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
+                 (2.1873744593677, 41.406342043777, 'place2')
+        assert r.geoadd('a', values, xx=True) == 0
+        assert r.zrange('a', 0, -1) == \
+               [b'place1']
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_geoadd_ch(self, r):
+        values = (2.1909389952632, 41.433791470673, 'place1')
+        assert r.geoadd('a', values) == 1
+        values = (2.1909389952632, 31.433791470673, 'place1') + \
+                 (2.1873744593677, 41.406342043777, 'place2')
+        assert r.geoadd('a', values, ch=True) == 2
+        assert r.zrange('a', 0, -1) == \
+               [b'place1', b'place2']
+
     @skip_if_server_version_lt('3.2.0')
     def test_geoadd_invalid_params(self, r):
         with pytest.raises(exceptions.RedisError):
-            r.geoadd('barcelona', *(1, 2))
+            r.geoadd('barcelona', (1, 2))
 
     @skip_if_server_version_lt('3.2.0')
     def test_geodist(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
-
-        assert r.geoadd('barcelona', *values) == 2
+        assert r.geoadd('barcelona', values) == 2
         assert r.geodist('barcelona', 'place1', 'place2') == 3067.4157
 
     @skip_if_server_version_lt('3.2.0')
     def test_geodist_units(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
-
-        r.geoadd('barcelona', *values)
+        r.geoadd('barcelona', values)
         assert r.geodist('barcelona', 'place1', 'place2', 'km') == 3.0674
 
     @skip_if_server_version_lt('3.2.0')
     def test_geodist_missing_one_member(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1')
-        r.geoadd('barcelona', *values)
+        r.geoadd('barcelona', values)
         assert r.geodist('barcelona', 'place1', 'missing_member', 'km') is None
 
     @skip_if_server_version_lt('3.2.0')
@@ -2462,8 +2490,7 @@ def test_geodist_invalid_units(self, r):
     def test_geohash(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
-
-        r.geoadd('barcelona', *values)
+        r.geoadd('barcelona', values)
         assert r.geohash('barcelona', 'place1', 'place2', 'place3') == \
                ['sp3e9yg3kd0', 'sp3e9cbc3t0', None]
 
@@ -2472,8 +2499,7 @@ def test_geohash(self, r):
     def test_geopos(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
-
-        r.geoadd('barcelona', *values)
+        r.geoadd('barcelona', values)
         # redis uses 52 bits precision, hereby small errors may be introduced.
         assert r.geopos('barcelona', 'place1', 'place2') == \
                [(2.19093829393386841, 41.43379028184083523),
@@ -2493,7 +2519,7 @@ def test_geosearch(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, b'\x80place2') + \
                  (2.583333, 41.316667, 'place3')
-        r.geoadd('barcelona', *values)
+        r.geoadd('barcelona', values)
         assert r.geosearch('barcelona', longitude=2.191,
                            latitude=41.433, radius=1000) == [b'place1']
         assert r.geosearch('barcelona', longitude=2.187,
@@ -2515,7 +2541,7 @@ def test_geosearch_member(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, b'\x80place2')
 
-        r.geoadd('barcelona', *values)
+        r.geoadd('barcelona', values)
         assert r.geosearch('barcelona', member='place1', radius=4000) == \
                [b'\x80place2', b'place1']
         assert r.geosearch('barcelona', member='place1', radius=10) == \
@@ -2534,7 +2560,7 @@ def test_geosearch_member(self, r):
     def test_geosearch_sort(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
-        r.geoadd('barcelona', *values)
+        r.geoadd('barcelona', values)
         assert r.geosearch('barcelona', longitude=2.191,
                            latitude=41.433, radius=3000, sort='ASC') == \
                [b'place1', b'place2']
@@ -2547,7 +2573,7 @@ def test_geosearch_sort(self, r):
     def test_geosearch_with(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
-        r.geoadd('barcelona', *values)
+        r.geoadd('barcelona', values)
 
         # test a bunch of combinations to test the parse response
         # function.
@@ -2618,7 +2644,7 @@ def test_geosearchstore(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
 
-        r.geoadd('barcelona', *values)
+        r.geoadd('barcelona', values)
         r.geosearchstore('places_barcelona', 'barcelona',
                          longitude=2.191, latitude=41.433, radius=1000)
         assert r.zrange('places_barcelona', 0, -1) == [b'place1']
@@ -2629,7 +2655,7 @@ def test_geosearchstore_dist(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
 
-        r.geoadd('barcelona', *values)
+        r.geoadd('barcelona', values)
         r.geosearchstore('places_barcelona', 'barcelona',
                          longitude=2.191, latitude=41.433,
                          radius=1000, storedist=True)
@@ -2641,7 +2667,7 @@ def test_georadius(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, b'\x80place2')
 
-        r.geoadd('barcelona', *values)
+        r.geoadd('barcelona', values)
         assert r.georadius('barcelona', 2.191, 41.433, 1000) == [b'place1']
         assert r.georadius('barcelona', 2.187, 41.406, 1000) == [b'\x80place2']
 
@@ -2650,7 +2676,7 @@ def test_georadius_no_values(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
 
-        r.geoadd('barcelona', *values)
+        r.geoadd('barcelona', values)
         assert r.georadius('barcelona', 1, 2, 1000) == []
 
     @skip_if_server_version_lt('3.2.0')
@@ -2658,7 +2684,7 @@ def test_georadius_units(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
 
-        r.geoadd('barcelona', *values)
+        r.geoadd('barcelona', values)
         assert r.georadius('barcelona', 2.191, 41.433, 1, unit='km') == \
                [b'place1']
 
@@ -2668,7 +2694,7 @@ def test_georadius_with(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
 
-        r.geoadd('barcelona', *values)
+        r.geoadd('barcelona', values)
 
         # test a bunch of combinations to test the parse response
         # function.
@@ -2696,7 +2722,7 @@ def test_georadius_count(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
 
-        r.geoadd('barcelona', *values)
+        r.geoadd('barcelona', values)
         assert r.georadius('barcelona', 2.191, 41.433, 3000, count=1) == \
                [b'place1']
         assert r.georadius('barcelona', 2.191, 41.433, 3000,
@@ -2708,7 +2734,7 @@ def test_georadius_sort(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
 
-        r.geoadd('barcelona', *values)
+        r.geoadd('barcelona', values)
         assert r.georadius('barcelona', 2.191, 41.433, 3000, sort='ASC') == \
                [b'place1', b'place2']
         assert r.georadius('barcelona', 2.191, 41.433, 3000, sort='DESC') == \
@@ -2719,7 +2745,7 @@ def test_georadius_store(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
 
-        r.geoadd('barcelona', *values)
+        r.geoadd('barcelona', values)
         r.georadius('barcelona', 2.191, 41.433, 1000, store='places_barcelona')
         assert r.zrange('places_barcelona', 0, -1) == [b'place1']
 
@@ -2729,7 +2755,7 @@ def test_georadius_store_dist(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
 
-        r.geoadd('barcelona', *values)
+        r.geoadd('barcelona', values)
         r.georadius('barcelona', 2.191, 41.433, 1000,
                     store_dist='places_barcelona')
         # instead of save the geo score, the distance is saved.
@@ -2741,7 +2767,7 @@ def test_georadiusmember(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, b'\x80place2')
 
-        r.geoadd('barcelona', *values)
+        r.geoadd('barcelona', values)
         assert r.georadiusbymember('barcelona', 'place1', 4000) == \
                [b'\x80place2', b'place1']
         assert r.georadiusbymember('barcelona', 'place1', 10) == [b'place1']

From cbbade97be48422cce0b203270a8e39a9bc5f519 Mon Sep 17 00:00:00 2001
From: Andrew Chen Wang <60190294+Andrew-Chen-Wang@users.noreply.github.com>
Date: Mon, 18 Oct 2021 04:09:34 -0400
Subject: [PATCH 0193/1164] Update docs for multiple usernames for ACL DELUSER
 (#1595)

---
 redis/commands.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/commands.py b/redis/commands.py
index 9dad8a59b8..f20acfe2a0 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -49,7 +49,7 @@ def acl_cat(self, category=None):
         return self.execute_command('ACL CAT', *pieces)
 
     def acl_deluser(self, *username):
-        "Delete the ACL for the specified ``username``"
+        "Delete the ACL for the specified ``username``s"
         return self.execute_command('ACL DELUSER', *username)
 
     def acl_genpass(self, bits=None):

From 87705815d31e5cf07b5d4b777eec0d2cf51aca1c Mon Sep 17 00:00:00 2001
From: Andrew Chen Wang <60190294+Andrew-Chen-Wang@users.noreply.github.com>
Date: Mon, 18 Oct 2021 04:16:29 -0400
Subject: [PATCH 0194/1164] Normalize minid and maxlen docs (#1593)

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/commands.py | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/redis/commands.py b/redis/commands.py
index f20acfe2a0..69aae207f0 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -1820,16 +1820,16 @@ def xadd(self, name, fields, id='*', maxlen=None, approximate=True,
         fields: dict of field/value pairs to insert into the stream
         id: Location to insert this record. By default it is appended.
         maxlen: truncate old stream members beyond this size.
-        Can't be specify with minid.
-        minid: the minimum id in the stream to query.
-        Can't be specify with maxlen.
+        Can't be specified with minid.
         approximate: actual stream length may be slightly more than maxlen
         nomkstream: When set to true, do not make a stream
+        minid: the minimum id in the stream to query.
+        Can't be specified with maxlen.
         limit: specifies the maximum number of entries to retrieve
         """
         pieces = []
         if maxlen is not None and minid is not None:
-            raise DataError("Only one of ```maxlen``` or ```minid```",
+            raise DataError("Only one of ```maxlen``` or ```minid``` "
                             "may be specified")
 
         if maxlen is not None:
@@ -2201,8 +2201,10 @@ def xtrim(self, name, maxlen=None, approximate=True, minid=None,
         Trims old messages from a stream.
         name: name of the stream.
         maxlen: truncate old stream messages beyond this size
+        Can't be specified with minid.
         approximate: actual stream length may be slightly more than maxlen
         minid: the minimum id in the stream to query
+        Can't be specified with maxlen.
         limit: specifies the maximum number of entries to retrieve
         """
         pieces = []

From 726eedeae75e51c18bdb2ba697ff390a1efb2b78 Mon Sep 17 00:00:00 2001
From: Andrew Chen Wang <60190294+Andrew-Chen-Wang@users.noreply.github.com>
Date: Mon, 18 Oct 2021 04:18:30 -0400
Subject: [PATCH 0195/1164] Fix client_kill_filter docs for skimpy (#1596)

Co-authored-by: Chayim <chayim@users.noreply.github.com>

From 576d33c148de867fd48077a55d51135d14e45ec0 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Mon, 18 Oct 2021 12:08:54 +0300
Subject: [PATCH 0196/1164] REPLICAOF command implementation (#1622)

---
 redis/commands.py      | 10 ++++++++++
 redis/features.py      |  5 +++++
 tests/test_commands.py |  8 ++++++++
 3 files changed, 23 insertions(+)
 create mode 100644 redis/features.py

diff --git a/redis/commands.py b/redis/commands.py
index 69aae207f0..c2d9ff7bb1 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -2845,6 +2845,16 @@ def pubsub_numsub(self, *args):
     def cluster(self, cluster_arg, *args):
         return self.execute_command('CLUSTER %s' % cluster_arg.upper(), *args)
 
+    def replicaof(self, *args):
+        """
+        Update the replication settings of a redis replica, on the fly.
+        Examples of valid arguments include:
+            NO ONE (set no replication)
+            host port (set to the host and port of a redis server)
+        see: https://redis.io/commands/replicaof
+        """
+        return self.execute_command('REPLICAOF', *args)
+
     def eval(self, script, numkeys, *keys_and_args):
         """
         Execute the Lua ``script``, specifying the ``numkeys`` the script
diff --git a/redis/features.py b/redis/features.py
new file mode 100644
index 0000000000..a96bac7c77
--- /dev/null
+++ b/redis/features.py
@@ -0,0 +1,5 @@
+try:
+    import hiredis  # noqa
+    HIREDIS_AVAILABLE = True
+except ImportError:
+    HIREDIS_AVAILABLE = False
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 802d8e448c..2136d37caf 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -3613,6 +3613,14 @@ def test_restore(self, r):
         assert r.restore(key, 0, dumpdata, frequency=5)
         assert r.get(key) == b'blee!'
 
+    @skip_if_server_version_lt('5.0.0')
+    def test_replicaof(self, r):
+
+        with pytest.raises(redis.ResponseError):
+            assert r.replicaof("NO ONE")
+
+        assert r.replicaof("NO", "ONE")
+
 
 class TestBinarySave:
 

From 7f96435480e74460989ad4dd4a686aff47e6b703 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Mon, 18 Oct 2021 12:19:37 +0300
Subject: [PATCH 0197/1164] CLIENT REDIR command support (#1623)

---
 redis/client.py        | 1 +
 redis/commands.py      | 8 ++++++++
 tests/test_commands.py | 5 +++++
 3 files changed, 14 insertions(+)

diff --git a/redis/client.py b/redis/client.py
index 2e2a26a2ad..fde153d26c 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -675,6 +675,7 @@ class Redis(Commands, object):
         'CLIENT SETNAME': bool_ok,
         'CLIENT UNBLOCK': lambda r: r and int(r) == 1 or False,
         'CLIENT PAUSE': bool_ok,
+        'CLIENT GETREDIR': int,
         'CLIENT TRACKINGINFO': lambda r: list(map(str_if_bytes, r)),
         'CLUSTER ADDSLOTS': bool_ok,
         'CLUSTER COUNT-FAILURE-REPORTS': lambda x: int(x),
diff --git a/redis/commands.py b/redis/commands.py
index c2d9ff7bb1..cd3b802dca 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -377,6 +377,14 @@ def client_getname(self):
         """Returns the current connection name"""
         return self.execute_command('CLIENT GETNAME')
 
+    def client_getredir(self):
+        """Returns the ID (an integer) of the client to whom we are
+        redirecting tracking notifications.
+
+        see: https://redis.io/commands/client-getredir
+        """
+        return self.execute_command('CLIENT GETREDIR')
+
     def client_reply(self, reply):
         """Enable and disable redis server replies.
         ``reply`` Must be ON OFF or SKIP,
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 2136d37caf..62d42dbcc1 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -490,6 +490,11 @@ def test_client_reply(self, r, r_timeout):
         # validate it was set
         assert r.get('foo') == b'bar'
 
+    @skip_if_server_version_lt('6.0.0')
+    def test_client_getredir(self, r):
+        assert isinstance(r.client_getredir(), int)
+        assert r.client_getredir() == -1
+
     def test_config_get(self, r):
         data = r.config_get()
         assert 'maxmemory' in data

From 039488d97ec545b37e903d1b791a88bac8f77973 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Mon, 18 Oct 2021 12:30:13 +0300
Subject: [PATCH 0198/1164] Raising NotImplementedError for SCRIPT DEBUG and
 DEBUG SEGFAULT (#1624)

---
 redis/commands.py      | 10 ++++++++++
 tests/test_commands.py | 20 ++++++++++++++++++++
 2 files changed, 30 insertions(+)

diff --git a/redis/commands.py b/redis/commands.py
index cd3b802dca..62c082d353 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -485,6 +485,11 @@ def debug_object(self, key):
         """Returns version specific meta information about a given key"""
         return self.execute_command('DEBUG OBJECT', key)
 
+    def debug_segfault(self):
+        raise NotImplementedError(
+            "DEBUG SEGFAULT is intentionally not implemented in the client."
+        )
+
     def echo(self, value):
         """Echo the string back from the server"""
         return self.execute_command('ECHO', value)
@@ -2894,6 +2899,11 @@ def script_exists(self, *args):
         """
         return self.execute_command('SCRIPT EXISTS', *args)
 
+    def script_debug(self, *args):
+        raise NotImplementedError(
+            "SCRIPT DEBUG is intentionally not implemented in the client."
+        )
+
     def script_flush(self, sync_type="SYNC"):
         """Flush all scripts from the script cache.
         ``sync_type`` is by default SYNC (synchronous) but it can also be
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 62d42dbcc1..a7a3ce4279 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1629,6 +1629,16 @@ def test_sunionstore(self, r):
         assert r.sunionstore('c', 'a', 'b') == 3
         assert r.smembers('c') == {b'1', b'2', b'3'}
 
+    @skip_if_server_version_lt('1.0.0')
+    def test_debug_segfault(self, r):
+        with pytest.raises(NotImplementedError):
+            r.debug_segfault()
+
+    @skip_if_server_version_lt('3.2.0')
+    def test_script_debug(self, r):
+        with pytest.raises(NotImplementedError):
+            r.script_debug()
+
     # SORTED SET COMMANDS
     def test_zadd(self, r):
         mapping = {'a1': 1.0, 'a2': 2.0, 'a3': 3.0}
@@ -3535,6 +3545,16 @@ def test_bitfield_operations(self, r):
                 .execute())
         assert resp == [0, None, 255]
 
+    @skip_if_server_version_lt('4.0.0')
+    def test_memory_help(self, r):
+        with pytest.raises(NotImplementedError):
+            r.memory_help()
+
+    @skip_if_server_version_lt('4.0.0')
+    def test_memory_doctor(self, r):
+        with pytest.raises(NotImplementedError):
+            r.memory_doctor()
+
     @skip_if_server_version_lt('4.0.0')
     def test_memory_malloc_stats(self, r):
         assert r.memory_malloc_stats()

From 39814846b765b1bba33cd7520b6462a9816c9d4a Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Tue, 19 Oct 2021 12:04:46 +0200
Subject: [PATCH 0199/1164] Add support to consumername in `xpending_range`
 (#1602)

---
 redis/commands.py      | 14 ++++++++++----
 tests/test_commands.py |  8 ++++++++
 2 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/redis/commands.py b/redis/commands.py
index 62c082d353..44a77354aa 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -2065,18 +2065,21 @@ def xpending(self, name, groupname):
         """
         return self.execute_command('XPENDING', name, groupname)
 
-    def xpending_range(self, name, groupname, min, max, count,
-                       consumername=None, idle=None):
+    def xpending_range(self, name, groupname, idle=None,
+                       min=None, max=None, count=None,
+                       consumername=None):
         """
         Returns information about pending messages, in a range.
+
         name: name of the stream.
         groupname: name of the consumer group.
+        idle: available from  version 6.2. filter entries by their
+        idle-time, given in milliseconds (optional).
         min: minimum stream ID.
         max: maximum stream ID.
         count: number of messages to return
         consumername: name of a consumer to filter by (optional).
-        idle: available from  version 6.2. filter entries by their
-        idle-time, given in milliseconds (optional).
+
         """
         if {min, max, count} == {None}:
             if idle is not None or consumername is not None:
@@ -2103,6 +2106,9 @@ def xpending_range(self, name, groupname, min, max, count,
             pieces.extend([min, max, count])
         except TypeError:
             pass
+        # consumername
+        if consumername:
+            pieces.append(consumername)
 
         return self.execute_command('XPENDING', *pieces, parse_detail=True)
 
diff --git a/tests/test_commands.py b/tests/test_commands.py
index a7a3ce4279..b7fa6bf059 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -3217,6 +3217,14 @@ def test_xpending_range(self, r):
         assert response[1]['message_id'] == m2
         assert response[1]['consumer'] == consumer2.encode()
 
+        # test with consumer name
+        response = r.xpending_range(stream, group,
+                                    min='-', max='+', count=5,
+                                    consumername=consumer1)
+        assert len(response) == 1
+        assert response[0]['message_id'] == m1
+        assert response[0]['consumer'] == consumer1.encode()
+
     @skip_if_server_version_lt('6.2.0')
     def test_xpending_range_idle(self, r):
         stream = 'stream'

From 2d18a05708523b1961daac4dd9647e2fc65367f1 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 19 Oct 2021 13:05:10 +0300
Subject: [PATCH 0200/1164] Removing packaging dependency (#1626)

---
 redis/connection.py | 10 +++++-----
 tests/conftest.py   |  8 ++++----
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/redis/connection.py b/redis/connection.py
index 5528589026..c2fb84f205 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1,4 +1,4 @@
-from packaging.version import Version
+from distutils.version import LooseVersion
 from itertools import chain
 from time import time
 from queue import LifoQueue, Empty, Full
@@ -54,13 +54,13 @@
 if HIREDIS_AVAILABLE:
     import hiredis
 
-    hiredis_version = Version(hiredis.__version__)
+    hiredis_version = LooseVersion(hiredis.__version__)
     HIREDIS_SUPPORTS_CALLABLE_ERRORS = \
-        hiredis_version >= Version('0.1.3')
+        hiredis_version >= LooseVersion('0.1.3')
     HIREDIS_SUPPORTS_BYTE_BUFFER = \
-        hiredis_version >= Version('0.1.4')
+        hiredis_version >= LooseVersion('0.1.4')
     HIREDIS_SUPPORTS_ENCODING_ERRORS = \
-        hiredis_version >= Version('1.0.0')
+        hiredis_version >= LooseVersion('1.0.0')
 
     if not HIREDIS_SUPPORTS_BYTE_BUFFER:
         msg = ("redis-py works best with hiredis >= 0.1.4. You're running "
diff --git a/tests/conftest.py b/tests/conftest.py
index 3dc3ea149e..c099463807 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -3,7 +3,7 @@
 import pytest
 import random
 import redis
-from packaging.version import Version
+from distutils.version import LooseVersion
 from redis.connection import parse_url
 from unittest.mock import Mock
 from urllib.parse import urlparse
@@ -38,7 +38,7 @@ def pytest_sessionstart(session):
 
 def skip_if_server_version_lt(min_version):
     redis_version = REDIS_INFO["version"]
-    check = Version(redis_version) < Version(min_version)
+    check = LooseVersion(redis_version) < LooseVersion(min_version)
     return pytest.mark.skipif(
         check,
         reason="Redis version required >= {}".format(min_version))
@@ -46,7 +46,7 @@ def skip_if_server_version_lt(min_version):
 
 def skip_if_server_version_gte(min_version):
     redis_version = REDIS_INFO["version"]
-    check = Version(redis_version) >= Version(min_version)
+    check = LooseVersion(redis_version) >= LooseVersion(min_version)
     return pytest.mark.skipif(
         check,
         reason="Redis version required < {}".format(min_version))
@@ -183,7 +183,7 @@ def wait_for_command(client, monitor, command):
     # if we find a command with our key before the command we're waiting
     # for, something went wrong
     redis_version = REDIS_INFO["version"]
-    if Version(redis_version) >= Version('5.0.0'):
+    if LooseVersion(redis_version) >= LooseVersion('5.0.0'):
         id_str = str(client.client_id())
     else:
         id_str = '%08x' % random.randrange(2**32)

From 16cfcc7fced84d2b53edf95af1c40b230b30fc3d Mon Sep 17 00:00:00 2001
From: adiamzn <92513900+adiamzn@users.noreply.github.com>
Date: Tue, 19 Oct 2021 13:14:49 +0300
Subject: [PATCH 0201/1164] Add warning when hiredis not installed. Recommend
 installation. (#1621)

---
 redis/connection.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/redis/connection.py b/redis/connection.py
index c2fb84f205..c99c550ecd 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -71,6 +71,9 @@
     # only use byte buffer if hiredis supports it
     if not HIREDIS_SUPPORTS_BYTE_BUFFER:
         HIREDIS_USE_BYTE_BUFFER = False
+else:
+    msg = "redis-py works best with hiredis. Please consider installing"
+    warnings.warn(msg)
 
 SYM_STAR = b'*'
 SYM_DOLLAR = b'$'

From e60d97e6f428f4c536324922ebbe7efcd2440b83 Mon Sep 17 00:00:00 2001
From: Andrew Chen Wang <60190294+Andrew-Chen-Wang@users.noreply.github.com>
Date: Wed, 20 Oct 2021 09:10:08 -0400
Subject: [PATCH 0202/1164] geosearch test should use any=True (#1594)

Co-authored-by: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
---
 tests/test_commands.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/tests/test_commands.py b/tests/test_commands.py
index b7fa6bf059..ceb12361b7 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2547,7 +2547,7 @@ def test_geosearch(self, r):
         assert r.geosearch('barcelona', member='place3', radius=100,
                            unit='km', count=2) == [b'place3', b'\x80place2']
         assert r.geosearch('barcelona', member='place3', radius=100,
-                           unit='km', count=1, any=1)[0] \
+                           unit='km', count=1, any=True)[0] \
                in [b'place1', b'place3', b'\x80place2']
 
     @skip_unless_arch_bits(64)
@@ -2652,7 +2652,8 @@ def test_geosearch_negative(self, r):
 
         # use any without count
         with pytest.raises(exceptions.DataError):
-            assert r.geosearch('barcelona', member='place3', radius=100, any=1)
+            assert r.geosearch('barcelona', member='place3',
+                               radius=100, any=True)
 
     @skip_if_server_version_lt('6.2.0')
     def test_geosearchstore(self, r):

From 63ebe693174a4e6ec314e48d12fcdf3f8401eec6 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 21 Oct 2021 08:55:32 +0300
Subject: [PATCH 0203/1164] tox integrations with invoke and docker (#1632)

---
 .github/workflows/integration.yaml   |  56 ++++++++++-
 .gitignore                           |   1 +
 CONTRIBUTING.rst                     |  41 ++++----
 Dockerfile                           |   9 --
 Makefile                             |  14 ---
 dev_requirements.txt                 |   5 +
 docker-entry.sh                      |  19 ----
 docker/{slave => replica}/Dockerfile |   0
 docker/replica/redis.conf            |   4 +
 docker/slave/redis.conf              |   4 -
 tasks.py                             |  60 ++++++++++++
 tox.ini                              | 138 +++++++++++++++++++++------
 12 files changed, 256 insertions(+), 95 deletions(-)
 delete mode 100644 Dockerfile
 delete mode 100644 Makefile
 create mode 100644 dev_requirements.txt
 delete mode 100755 docker-entry.sh
 rename docker/{slave => replica}/Dockerfile (100%)
 create mode 100644 docker/replica/redis.conf
 delete mode 100644 docker/slave/redis.conf
 create mode 100644 tasks.py

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index f08a2c238f..2618c336da 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -2,12 +2,62 @@ name: CI
 
 on:
   push:
+    paths-ignore:
+      - 'docs/**'
+      - '**/*.rst'
+      - '**/*.md'
   pull_request:
+    paths-ignore:
+      - 'docs/**'
+      - '**/*.rst'
+      - '**/*.md'
 
 jobs:
-  integration:
+
+  lint:
+    name: Code linters
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: install python
+        uses: actions/setup-python@v2
+        with:
+          python-version: 3.9
+      - name: run code linters
+        run: |
+          pip install -r dev_requirements.txt
+          invoke linters
+
+  run-tests:
+    runs-on: ubuntu-latest
+    strategy:
+      max-parallel: 6
+      matrix:
+        python-version: ['3.6', '3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
+    env:
+      ACTIONS_ALLOW_UNSECURE_COMMANDS: true
+    name: Python ${{ matrix.python-version }} tests
+    steps:
+      - uses: actions/checkout@v2
+      - name: install python
+        uses: actions/setup-python@v2
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: run tests
+        run: |
+          pip install -r dev_requirements.txt
+          invoke tests
+
+  build_package:
+    name: Validate building and installing the package
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v2
-      - name: test
-        run: make test
+      - name: install python
+        uses: actions/setup-python@v2
+        with:
+          python-version: 3.9
+      - name: build and install
+        run: |
+          pip install invoke
+          invoke package
diff --git a/.gitignore b/.gitignore
index b59bcdf097..05c384652c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -14,3 +14,4 @@ vagrant/.vagrant
 env
 venv
 coverage.xml
+.venv
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index edaa7b6773..ba1ddfc5cc 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -29,25 +29,36 @@ Here's how to get started with your code contribution:
 
 1. Create your own fork of redis-py
 2. Do the changes in your fork
-3. If you need a development environment, run ``make dev``
-4. While developing, make sure the tests pass by running ``make test``
+3. Create a virtualenv and install the development dependencies from the dev_requirements.txt file:
+    a. python -m venv .venv
+    b. source .venv/bin/activate
+    c. pip install -r dev_requirements.txt
+3. If you need a development environment, run ``invoke devenv``
+4. While developing, make sure the tests pass by running ``invoke tests``
 5. If you like the change and think the project could use it, send a pull request
 
+To see what else is part of the automation, run ``invoke -l``
+
 The Development Environment
 ---------------------------
 
-Running ``make dev`` will create a Docker-based development environment that starts the following containers:
+Running ``invoke devenv`` installs the development dependencies specified in the dev_requirements.txt. It starts all of the dockers used by this project, and leaves them running. These can be easily cleaned up with ``invoke clean``. NOTE: it is assumed that the user running these tests, can execute docker and its various commands.
 
 * A master Redis node
-* A slave Redis node
+* A Redis replica node
 * Three sentinel Redis nodes
-* A test container
+* A multi-python docker, with your source code mounted in /data
 
-The slave is a replica of the master node, using the `leader-follower replication <https://redis.io/topics/replication>`_ feature.
+The replica node, is a replica of the master node, using the `leader-follower replication <https://redis.io/topics/replication>`_ feature.
 
 The sentinels monitor the master node in a `sentinel high-availability configuration <https://redis.io/topics/sentinel>`_.
 
-Meanwhile, the `test` container hosts the code from your checkout of ``redis-py`` and allows running tests against many Python versions.
+Testing
+-------
+
+Each run of tox starts and stops the various dockers required.  Sometimes things get stuck, an ``invoke clean`` can help.
+
+Continuous Integration uses these same wrappers to run all of these tests against multiple versions of python. Feel free to test your changes against all the python versions supported, as declared by the tox.ini file (eg: tox -e py39). If you have the various python versions on your desktop, you can run *tox* by itself, to test all supported versions. Alternatively, as your source code is mounted in the **lots-of-pythons** docker, you can start exploring from there, with all supported python versions!
 
 Docker Tips
 ^^^^^^^^^^^
@@ -56,17 +67,17 @@ Following are a few tips that can help you work with the Docker-based developmen
 
 To get a bash shell inside of a container:
 
-``$ docker-compose run <service> /bin/bash``
- 
-**Note**: The term "service" refers to the "services" defined in the ``docker-compose.yml`` file: "master", "slave", "sentinel_1", "sentinel_2", "sentinel_3", "test".
+``$ docker run -it <service> /bin/bash``
+
+**Note**: The term "service" refers to the "services" defined in the ``tox.ini`` file at the top of the repo: "master", "replicaof", "sentinel_1", "sentinel_2", "sentinel_3".
 
 Containers run a minimal Debian image that probably lacks tools you want to use. To install packages, first get a bash session (see previous tip) and then run:
 
 ``$ apt update && apt install <package>``
 
-You can see the combined logging output of all containers like this:
+You can see the logging output of a containers like this:
 
-``$ docker-compose logs``
+``$ docker logs -f <service>``
 
 The command `make test` runs all tests in all tested Python environments. To run the tests in a single environment, like Python 3.6, use a command like this:
 
@@ -81,13 +92,11 @@ Our test suite uses ``pytest``. You can run a specific test suite against a spec
 Troubleshooting
 ^^^^^^^^^^^^^^^
 If you get any errors when running ``make dev`` or ``make test``, make sure that you
-are using supported versions of Docker and docker-compose.
+are using supported versions of Docker.
 
-The included Dockerfiles and docker-compose.yml file work with the following
-versions of Docker and docker-compose:
+Please try at least versions of Docker.
 
 * Docker 19.03.12
-* docker-compose 1.26.2
 
 How to Report a Bug
 -------------------
diff --git a/Dockerfile b/Dockerfile
deleted file mode 100644
index 2ceb725d47..0000000000
--- a/Dockerfile
+++ /dev/null
@@ -1,9 +0,0 @@
-FROM fkrull/multi-python:latest
-
-RUN apt update \
-    && apt install -y pypy pypy-dev pypy3-dev \
-    && rm -rf /var/lib/apt/lists/*
-
-WORKDIR /redis-py
-
-COPY . /redis-py
diff --git a/Makefile b/Makefile
deleted file mode 100644
index 0d0964345a..0000000000
--- a/Makefile
+++ /dev/null
@@ -1,14 +0,0 @@
-.PHONY: base clean dev test
-
-base:
-		docker build -t redis-py-base docker/base
-
-dev:	base
-		docker-compose up -d --build
-
-test:	dev
-		docker-compose run --rm test /redis-py/docker-entry.sh
-
-clean:
-		docker-compose stop
-		docker-compose rm -f
diff --git a/dev_requirements.txt b/dev_requirements.txt
new file mode 100644
index 0000000000..2648127712
--- /dev/null
+++ b/dev_requirements.txt
@@ -0,0 +1,5 @@
+flake8>=3.9.2
+pytest==6.2.5
+tox==3.24.4
+tox-docker==3.1.0
+invoke==1.6.0
diff --git a/docker-entry.sh b/docker-entry.sh
deleted file mode 100755
index dc119dcdd8..0000000000
--- a/docker-entry.sh
+++ /dev/null
@@ -1,19 +0,0 @@
-#!/bin/bash
-
-# This is the entrypoint for "make test". It invokes Tox. If running
-# outside the CI environment, it disables uploading the coverage report to codecov
-
-set -eu
-
-REDIS_MASTER="${REDIS_MASTER_HOST}":"${REDIS_MASTER_PORT}"
-echo "Testing against Redis Server: ${REDIS_MASTER}"
-
-# skip the "codecov" env if not running on Travis
-if [ "${GITHUB_ACTIONS}" = true ] ; then
-    echo "Skipping codecov"
-    export TOX_SKIP_ENV="codecov"
-fi
-
-# use the wait-for-it util to ensure the server is running before invoking Tox
-util/wait-for-it.sh ${REDIS_MASTER} -- tox -- --redis-url=redis://"${REDIS_MASTER}"/9
-
diff --git a/docker/slave/Dockerfile b/docker/replica/Dockerfile
similarity index 100%
rename from docker/slave/Dockerfile
rename to docker/replica/Dockerfile
diff --git a/docker/replica/redis.conf b/docker/replica/redis.conf
new file mode 100644
index 0000000000..4a1dcd7e9d
--- /dev/null
+++ b/docker/replica/redis.conf
@@ -0,0 +1,4 @@
+bind replica 127.0.0.1
+port 6380
+save ""
+replicaof master 6379
diff --git a/docker/slave/redis.conf b/docker/slave/redis.conf
deleted file mode 100644
index 629ac70c62..0000000000
--- a/docker/slave/redis.conf
+++ /dev/null
@@ -1,4 +0,0 @@
-bind slave 127.0.0.1
-port 6380
-save ""
-slaveof master 6379
diff --git a/tasks.py b/tasks.py
new file mode 100644
index 0000000000..15e983bbfd
--- /dev/null
+++ b/tasks.py
@@ -0,0 +1,60 @@
+import os
+import shutil
+from invoke import task, run
+
+with open('tox.ini') as fp:
+    lines = fp.read().split("\n")
+    dockers = [line.split("=")[1].strip() for line in lines
+               if line.find("name") != -1]
+
+
+@task
+def devenv(c):
+    """Builds a development environment: downloads, and starts all dockers
+    specified in the tox.ini file.
+    """
+    clean(c)
+    cmd = 'tox -e devenv'
+    for d in dockers:
+        cmd += " --docker-dont-stop={}".format(d)
+    print("Running: {}".format(cmd))
+    run(cmd)
+
+
+@task
+def linters(c):
+    """Run code linters"""
+    run("flake8")
+
+
+@task
+def all_tests(c):
+    """Run all linters, and tests in redis-py. This assumes you have all
+    the python versions specified in the tox.ini file.
+    """
+    linters(c)
+    tests(c)
+
+
+@task
+def tests(c):
+    """Run the redis-py test suite against the current python,
+    with and without hiredis.
+    """
+    run("tox -e plain -e hiredis")
+
+
+@task
+def clean(c):
+    """Stop all dockers, and clean up the built binaries, if generated."""
+    if os.path.isdir("build"):
+        shutil.rmtree("build")
+    if os.path.isdir("dist"):
+        shutil.rmtree("dist")
+    run("docker rm -f {}".format(' '.join(dockers)))
+
+
+@task
+def package(c):
+    """Create the python packages"""
+    run("python setup.py build install")
diff --git a/tox.ini b/tox.ini
index db7492d18e..bfe937fe9e 100644
--- a/tox.ini
+++ b/tox.ini
@@ -2,50 +2,128 @@
 addopts = -s
 
 [tox]
-minversion = 2.4
-envlist = {py35,py36,py37,py38,py39,pypy3}-{plain,hiredis}, flake8, covreport, codecov
+minversion = 3.2.0
+requires = tox-docker
+envlist = {py35,py36,py37,py38,py39,pypy3}-{plain,hiredis}, flake8
+
+[docker:master]
+name = master
+image = redis:6.2-bullseye
+ports =
+    6379:6379/tcp
+healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',6379)) else False"
+volumes =
+    bind:rw:{toxinidir}/docker/master/redis.conf:/usr/local/etc/redis/redis.conf
+
+[docker:replica]
+name = replica
+image = redis:6.2-bullseye
+links =
+    master:master
+ports =
+    6380:6380/tcp
+healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',6380)) else False"
+volumes =
+    bind:rw:{toxinidir}/docker/replica/redis.conf:/usr/local/etc/redis/redis.conf
+
+[docker:sentinel_1]
+name = sentinel_1
+image = redis:6.2-bullseye
+links =
+    master:master
+ports =
+    26379:26379/tcp
+healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26379)) else False"
+volumes =
+    bind:rw:{toxinidir}/docker/sentinel_1/sentinel.conf:/usr/local/etc/redis/sentinel.conf
+
+[docker:sentinel_2]
+name = sentinel_2
+image = redis:6.2-bullseye
+links =
+    master:master
+ports =
+    26380:26380/tcp
+healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26380)) else False"
+volumes =
+    bind:rw:{toxinidir}/docker/sentinel_2/sentinel.conf:/usr/local/etc/redis/sentinel.conf
+
+[docker:sentinel_3]
+name = sentinel_3
+image = redis:6.2-bullseye
+links =
+    master:master
+ports =
+    26381:26381/tcp
+healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26381)) else False"
+volumes =
+    bind:rw:{toxinidir}/docker/sentinel_3/sentinel.conf:/usr/local/etc/redis/sentinel.conf
+
+[docker:redismod]
+name = redismod
+image = redislabs/redismod:edge
+ports =
+    16379:16379/tcp
+healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',16379)) else False"
+
+[docker:lots-of-pythons]
+name = lots-of-pythons
+image = redisfab/lots-of-pythons
+volumes =
+    bind:rw:{toxinidir}:/data
 
 [testenv]
-deps =
-    coverage
-    pytest >= 2.7.0
+deps = -r {toxinidir}/dev_requirements.txt
+docker =
+    master
+    replica
+    sentinel_1
+    sentinel_2
+    sentinel_3
+    redismod
 extras =
     hiredis: hiredis
 commands =
-    {envpython} -b -m coverage run -p -m pytest -W always {posargs}
-    {envpython} -b -m coverage combine --append
+    pytest -W always {posargs}
+
+[testenv:devenv]
+skipsdist = true
+skip_install = true
+deps = -r {toxinidir}/dev_requirements.txt
+docker =
+    master
+    replica
+    sentinel_1
+    sentinel_2
+    sentinel_3
+    redismod
+    lots-of-pythons
+commands = echo
 
 [testenv:flake8]
-basepython = python3.6
-deps = flake8
+deps_files = dev_requirements.txt
 commands = flake8
 skipsdist = true
 skip_install = true
 
-[testenv:pypy-plain]
-basepython = pypy
-
-[testenv:pypy-hiredis]
-basepython = pypy
-
 [testenv:pypy3-plain]
 basepython = pypy3
 
 [testenv:pypy3-hiredis]
 basepython = pypy3
 
-[testenv:codecov]
-deps = codecov
-commands = codecov
-passenv =
-  REDIS_*
-  CI
-  CI_*
-  CODECOV_*
-  SHIPPABLE
-  GITHUB_*
-  VCS_*
-
-[testenv:covreport]
-deps = coverage
-commands = coverage report
+#[testenv:codecov]
+#deps = codecov
+#commands = codecov
+#passenv =
+#  REDIS_*
+#  CI
+#  CI_*
+#  CODECOV_*
+#  SHIPPABLE
+#  GITHUB_*
+#  VCS_*
+#
+#[testenv:covreport]
+#deps = coverage
+#commands = coverage report

From 638164b15840eddc0c58ae62d3e384b218d31c58 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Thu, 21 Oct 2021 12:08:24 +0200
Subject: [PATCH 0204/1164] Test BYLEX param in zrangestore (#1634)

---
 tests/test_commands.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/tests/test_commands.py b/tests/test_commands.py
index ceb12361b7..faa1e92b5b 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1920,12 +1920,13 @@ def test_zrangestore(self, r):
         assert r.zrangestore('b', 'a', 1, 2, desc=True)
         assert r.zrange('b', 0, -1) == [b'a1', b'a2']
         # by score
-        assert r.zrangestore('b', 'a', 1, 2, byscore=True,
-                             offset=0, num=1)
-        assert r.zrange('b', 0, -1) == [b'a1']
+        assert r.zrangestore('b', 'a', 2, 1, byscore=True,
+                             offset=0, num=1, desc=True)
+        assert r.zrange('b', 0, -1) == [b'a2']
         # by lex
-        assert r.zrange('a', '[a2', '(a3', bylex=True) == \
-               [b'a2']
+        assert r.zrangestore('b', 'a', '[a2', '(a3', bylex=True,
+                             offset=0, num=1)
+        assert r.zrange('b', 0, -1) == [b'a2']
 
     @skip_if_server_version_lt('2.8.9')
     def test_zrangebylex(self, r):

From cf5c5865bb9947498f3810b028628f3d2ab14030 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Thu, 21 Oct 2021 16:23:33 +0200
Subject: [PATCH 0205/1164] Enable floating parameters in SET (ex and px)
 (#1635)

---
 redis/commands.py      | 10 ++++++++--
 tests/test_commands.py |  4 ++++
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/redis/commands.py b/redis/commands.py
index 44a77354aa..f2c15384af 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -1174,12 +1174,18 @@ def set(self, name, value,
             pieces.append('EX')
             if isinstance(ex, datetime.timedelta):
                 ex = int(ex.total_seconds())
-            pieces.append(ex)
+            if isinstance(ex, int):
+                pieces.append(ex)
+            else:
+                raise DataError("ex must be datetime.timedelta or int")
         if px is not None:
             pieces.append('PX')
             if isinstance(px, datetime.timedelta):
                 px = int(px.total_seconds() * 1000)
-            pieces.append(px)
+            if isinstance(px, int):
+                pieces.append(px)
+            else:
+                raise DataError("px must be datetime.timedelta or int")
         if exat is not None:
             pieces.append('EXAT')
             if isinstance(exat, datetime.datetime):
diff --git a/tests/test_commands.py b/tests/test_commands.py
index faa1e92b5b..fec453f4dc 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1104,6 +1104,8 @@ def test_set_px(self, r):
         assert r['a'] == b'1'
         assert 0 < r.pttl('a') <= 10000
         assert 0 < r.ttl('a') <= 10
+        with pytest.raises(exceptions.DataError):
+            assert r.set('a', '1', px=10.0)
 
     @skip_if_server_version_lt('2.6.0')
     def test_set_px_timedelta(self, r):
@@ -1116,6 +1118,8 @@ def test_set_px_timedelta(self, r):
     def test_set_ex(self, r):
         assert r.set('a', '1', ex=10)
         assert 0 < r.ttl('a') <= 10
+        with pytest.raises(exceptions.DataError):
+            assert r.set('a', '1', ex=10.0)
 
     @skip_if_server_version_lt('2.6.0')
     def test_set_ex_timedelta(self, r):

From 36e00ec4e22a9f947e099affdfdc79862ac7ca08 Mon Sep 17 00:00:00 2001
From: Agustin Marquez <agusdmb@gmail.com>
Date: Mon, 25 Oct 2021 08:28:50 +0200
Subject: [PATCH 0206/1164] Add FULL option to XINFO SUMMARY (#1638)

---
 redis/client.py        | 24 +++++++++++++++++-------
 redis/commands.py      | 10 ++++++++--
 tests/test_commands.py | 12 ++++++++++++
 3 files changed, 37 insertions(+), 9 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index fde153d26c..a6bd183bc6 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -308,14 +308,24 @@ def parse_xautoclaim(response, **options):
     return parse_stream_list(response[1])
 
 
-def parse_xinfo_stream(response):
+def parse_xinfo_stream(response, **options):
     data = pairs_to_dict(response, decode_keys=True)
-    first = data['first-entry']
-    if first is not None:
-        data['first-entry'] = (first[0], pairs_to_dict(first[1]))
-    last = data['last-entry']
-    if last is not None:
-        data['last-entry'] = (last[0], pairs_to_dict(last[1]))
+    if not options.get('full', False):
+        first = data['first-entry']
+        if first is not None:
+            data['first-entry'] = (first[0], pairs_to_dict(first[1]))
+        last = data['last-entry']
+        if last is not None:
+            data['last-entry'] = (last[0], pairs_to_dict(last[1]))
+    else:
+        data['entries'] = {
+            _id: pairs_to_dict(entry)
+            for _id, entry in data['entries']
+        }
+        data['groups'] = [
+            pairs_to_dict(group, decode_keys=True)
+            for group in data['groups']
+        ]
     return data
 
 
diff --git a/redis/commands.py b/redis/commands.py
index f2c15384af..f5243e45a9 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -2050,12 +2050,18 @@ def xinfo_groups(self, name):
         """
         return self.execute_command('XINFO GROUPS', name)
 
-    def xinfo_stream(self, name):
+    def xinfo_stream(self, name, full=False):
         """
         Returns general information about the stream.
         name: name of the stream.
+        full: optional boolean, false by default. Return full summary
         """
-        return self.execute_command('XINFO STREAM', name)
+        pieces = [name]
+        options = {}
+        if full:
+            pieces.append(b'FULL')
+            options = {'full': full}
+        return self.execute_command('XINFO STREAM', *pieces, **options)
 
     def xlen(self, name):
         """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index fec453f4dc..694090ea7f 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -3156,6 +3156,18 @@ def test_xinfo_stream(self, r):
         assert info['first-entry'] == get_stream_message(r, stream, m1)
         assert info['last-entry'] == get_stream_message(r, stream, m2)
 
+    @skip_if_server_version_lt('6.0.0')
+    def test_xinfo_stream_full(self, r):
+        stream = 'stream'
+        group = 'group'
+        m1 = r.xadd(stream, {'foo': 'bar'})
+        r.xgroup_create(stream, group, 0)
+        info = r.xinfo_stream(stream, full=True)
+
+        assert info['length'] == 1
+        assert m1 in info['entries']
+        assert len(info['groups']) == 1
+
     @skip_if_server_version_lt('5.0.0')
     def test_xlen(self, r):
         stream = 'stream'

From 0ef4c0711693b4b313ce97261214bd151d8261d5 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Mon, 25 Oct 2021 13:41:06 +0300
Subject: [PATCH 0207/1164] Pre 6.2 redis should default to None for script
 flush (#1641)

---
 redis/commands.py       | 16 +++++++++++-----
 tests/test_scripting.py |  4 ++++
 2 files changed, 15 insertions(+), 5 deletions(-)

diff --git a/redis/commands.py b/redis/commands.py
index f5243e45a9..2697e780a4 100644
--- a/redis/commands.py
+++ b/redis/commands.py
@@ -2922,16 +2922,22 @@ def script_debug(self, *args):
             "SCRIPT DEBUG is intentionally not implemented in the client."
         )
 
-    def script_flush(self, sync_type="SYNC"):
+    def script_flush(self, sync_type=None):
         """Flush all scripts from the script cache.
         ``sync_type`` is by default SYNC (synchronous) but it can also be
                       ASYNC.
         See: https://redis.io/commands/script-flush
         """
-        if sync_type not in ["SYNC", "ASYNC"]:
-            raise DataError("SCRIPT FLUSH defaults to SYNC or "
-                            "accepts SYNC/ASYNC")
-        pieces = [sync_type]
+
+        # Redis pre 6 had no sync_type.
+        if sync_type not in ["SYNC", "ASYNC", None]:
+            raise DataError("SCRIPT FLUSH defaults to SYNC in redis > 6.2, or "
+                            "accepts SYNC/ASYNC. For older versions, "
+                            "of redis leave as None.")
+        if sync_type is None:
+            pieces = []
+        else:
+            pieces = [sync_type]
         return self.execute_command('SCRIPT FLUSH', *pieces)
 
     def script_kill(self):
diff --git a/tests/test_scripting.py b/tests/test_scripting.py
index cc67e26678..c3c2094d4a 100644
--- a/tests/test_scripting.py
+++ b/tests/test_scripting.py
@@ -43,6 +43,10 @@ def test_script_flush(self, r):
         r.script_load(multiply_script)
         r.script_flush()
 
+        r.set('a', 2)
+        r.script_load(multiply_script)
+        r.script_flush(None)
+
         with pytest.raises(exceptions.DataError):
             r.set('a', 2)
             r.script_load(multiply_script)

From 3946da29d7e451a20289fb6e282516fa24e402af Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Mon, 25 Oct 2021 17:06:04 +0300
Subject: [PATCH 0208/1164] redisjson support (#1636)

---
 docker-compose.yml                      |  58 ------
 docker/base/Dockerfile                  |   4 +-
 docker/base/Dockerfile.sentinel         |   3 +
 docker/base/README.md                   |   1 +
 docker/master/Dockerfile                |   7 -
 docker/master/redis.conf                |   1 -
 docker/replica/Dockerfile               |   7 -
 docker/replica/redis.conf               |   1 -
 docker/sentinel_1/Dockerfile            |   7 -
 docker/sentinel_1/sentinel.conf         |   3 +-
 docker/sentinel_2/Dockerfile            |   7 -
 docker/sentinel_2/sentinel.conf         |   3 +-
 docker/sentinel_3/Dockerfile            |   7 -
 docker/sentinel_3/sentinel.conf         |   3 +-
 redis/client.py                         |  48 ++++-
 redis/commands/__init__.py              |  11 ++
 redis/{commands.py => commands/core.py} | 124 +------------
 redis/commands/helpers.py               |  25 +++
 redis/commands/json/__init__.py         |  84 +++++++++
 redis/commands/json/commands.py         | 197 ++++++++++++++++++++
 redis/commands/json/helpers.py          |  25 +++
 redis/commands/json/path.py             |  21 +++
 redis/commands/redismodules.py          |  17 ++
 redis/commands/sentinel.py              |  97 ++++++++++
 tests/conftest.py                       |  33 ++++
 tests/test_commands.py                  |   9 +-
 tests/test_connection.py                |  33 +++-
 tests/test_json.py                      | 235 ++++++++++++++++++++++++
 tox.ini                                 |  28 +--
 29 files changed, 855 insertions(+), 244 deletions(-)
 delete mode 100644 docker-compose.yml
 create mode 100644 docker/base/Dockerfile.sentinel
 create mode 100644 docker/base/README.md
 delete mode 100644 docker/master/Dockerfile
 delete mode 100644 docker/replica/Dockerfile
 delete mode 100644 docker/sentinel_1/Dockerfile
 delete mode 100644 docker/sentinel_2/Dockerfile
 delete mode 100644 docker/sentinel_3/Dockerfile
 create mode 100644 redis/commands/__init__.py
 rename redis/{commands.py => commands/core.py} (96%)
 create mode 100644 redis/commands/helpers.py
 create mode 100644 redis/commands/json/__init__.py
 create mode 100644 redis/commands/json/commands.py
 create mode 100644 redis/commands/json/helpers.py
 create mode 100644 redis/commands/json/path.py
 create mode 100644 redis/commands/redismodules.py
 create mode 100644 redis/commands/sentinel.py
 create mode 100644 tests/test_json.py

diff --git a/docker-compose.yml b/docker-compose.yml
deleted file mode 100644
index 103a51b19c..0000000000
--- a/docker-compose.yml
+++ /dev/null
@@ -1,58 +0,0 @@
-version: "3.8"
-
-services:
-  master:
-    build: docker/master
-    ports:
-      - "6379:6379"
-
-  slave:
-    build: docker/slave
-    depends_on:
-      - "master"
-    ports:
-      - "6380:6380"
-
-  sentinel_1:
-    build: docker/sentinel_1
-    depends_on:
-      - "slave"
-    ports:
-      - "26379:26379"
-
-  sentinel_2:
-    build: docker/sentinel_2
-    depends_on:
-      - "slave"
-    ports:
-      - "26380:26380"
-
-  sentinel_3:
-    build: docker/sentinel_3
-    depends_on:
-      - "slave"
-    ports:
-      - "26381:26381"
-
-  test:
-    build: .
-    depends_on:
-      - "sentinel_3"
-    environment:
-      REDIS_MASTER_HOST: master
-      REDIS_MASTER_PORT: 6379
-      CI:
-      CI_BUILD_ID:
-      CI_BUILD_URL:
-      CI_JOB_ID:
-      CODECOV_ENV:
-      CODECOV_SLUG:
-      CODECOV_TOKEN:
-      CODECOV_URL:
-      SHIPPABLE:
-      GITHUB_ACTIONS:
-      VCS_BRANCH_NAME:
-      VCS_COMMIT_ID:
-      VCS_PULL_REQUEST:
-      VCS_SLUG:
-      VCS_TAG:
diff --git a/docker/base/Dockerfile b/docker/base/Dockerfile
index 60e4141e57..60be37483b 100644
--- a/docker/base/Dockerfile
+++ b/docker/base/Dockerfile
@@ -1 +1,3 @@
-FROM redis:6.2.5-buster
\ No newline at end of file
+FROM redis:6.2.6-buster
+
+CMD ["redis-server", "/redis.conf"]
diff --git a/docker/base/Dockerfile.sentinel b/docker/base/Dockerfile.sentinel
new file mode 100644
index 0000000000..93c16a71ab
--- /dev/null
+++ b/docker/base/Dockerfile.sentinel
@@ -0,0 +1,3 @@
+FROM redis:6.2.6-buster
+
+CMD ["redis-sentinel", "/sentinel.conf"]
diff --git a/docker/base/README.md b/docker/base/README.md
new file mode 100644
index 0000000000..a2f26a8106
--- /dev/null
+++ b/docker/base/README.md
@@ -0,0 +1 @@
+Dockers in this folder are built, and uploaded to the redisfab dockerhub store.
diff --git a/docker/master/Dockerfile b/docker/master/Dockerfile
deleted file mode 100644
index 1f4bd7391a..0000000000
--- a/docker/master/Dockerfile
+++ /dev/null
@@ -1,7 +0,0 @@
-FROM redis-py-base:latest
-
-COPY redis.conf /usr/local/etc/redis/redis.conf
-
-EXPOSE 6379
-
-CMD [ "redis-server", "/usr/local/etc/redis/redis.conf" ]
diff --git a/docker/master/redis.conf b/docker/master/redis.conf
index ed007666b6..15a31b5a38 100644
--- a/docker/master/redis.conf
+++ b/docker/master/redis.conf
@@ -1,3 +1,2 @@
-bind master 127.0.0.1
 port 6379
 save ""
diff --git a/docker/replica/Dockerfile b/docker/replica/Dockerfile
deleted file mode 100644
index 7b6bdbe1b9..0000000000
--- a/docker/replica/Dockerfile
+++ /dev/null
@@ -1,7 +0,0 @@
-FROM redis-py-base:latest
-
-COPY redis.conf /usr/local/etc/redis/redis.conf
-
-EXPOSE 6380
-
-CMD [ "redis-server", "/usr/local/etc/redis/redis.conf" ]
diff --git a/docker/replica/redis.conf b/docker/replica/redis.conf
index 4a1dcd7e9d..a76d402c5e 100644
--- a/docker/replica/redis.conf
+++ b/docker/replica/redis.conf
@@ -1,4 +1,3 @@
-bind replica 127.0.0.1
 port 6380
 save ""
 replicaof master 6379
diff --git a/docker/sentinel_1/Dockerfile b/docker/sentinel_1/Dockerfile
deleted file mode 100644
index 66f6a75e5b..0000000000
--- a/docker/sentinel_1/Dockerfile
+++ /dev/null
@@ -1,7 +0,0 @@
-FROM redis-py-base:latest
-
-COPY sentinel.conf /usr/local/etc/redis/sentinel.conf
-
-EXPOSE 26379
-
-CMD [ "redis-sentinel", "/usr/local/etc/redis/sentinel.conf" ]
diff --git a/docker/sentinel_1/sentinel.conf b/docker/sentinel_1/sentinel.conf
index fc9aa68c29..bd2d830af3 100644
--- a/docker/sentinel_1/sentinel.conf
+++ b/docker/sentinel_1/sentinel.conf
@@ -1,7 +1,6 @@
-bind sentinel_1 127.0.0.1
 port 26379
 
-sentinel monitor redis-py-test master 6379 2
+sentinel monitor redis-py-test 127.0.0.1 6379 2
 sentinel down-after-milliseconds redis-py-test 5000
 sentinel failover-timeout redis-py-test 60000
 sentinel parallel-syncs redis-py-test 1
diff --git a/docker/sentinel_2/Dockerfile b/docker/sentinel_2/Dockerfile
deleted file mode 100644
index 1c0bb92e23..0000000000
--- a/docker/sentinel_2/Dockerfile
+++ /dev/null
@@ -1,7 +0,0 @@
-FROM redis-py-base:latest
-
-COPY sentinel.conf /usr/local/etc/redis/sentinel.conf
-
-EXPOSE 26380
-
-CMD [ "redis-sentinel", "/usr/local/etc/redis/sentinel.conf" ]
diff --git a/docker/sentinel_2/sentinel.conf b/docker/sentinel_2/sentinel.conf
index 264443cbd4..955621b872 100644
--- a/docker/sentinel_2/sentinel.conf
+++ b/docker/sentinel_2/sentinel.conf
@@ -1,7 +1,6 @@
-bind sentinel_2 127.0.0.1
 port 26380
 
-sentinel monitor redis-py-test master 6379 2
+sentinel monitor redis-py-test 127.0.0.1 6379 2
 sentinel down-after-milliseconds redis-py-test 5000
 sentinel failover-timeout redis-py-test 60000
 sentinel parallel-syncs redis-py-test 1
diff --git a/docker/sentinel_3/Dockerfile b/docker/sentinel_3/Dockerfile
deleted file mode 100644
index cf1ec21b70..0000000000
--- a/docker/sentinel_3/Dockerfile
+++ /dev/null
@@ -1,7 +0,0 @@
-FROM redis-py-base:latest
-
-COPY sentinel.conf /usr/local/etc/redis/sentinel.conf
-
-EXPOSE 26381
-
-CMD [ "redis-sentinel", "/usr/local/etc/redis/sentinel.conf" ]
diff --git a/docker/sentinel_3/sentinel.conf b/docker/sentinel_3/sentinel.conf
index b0827f1f45..62c40512f1 100644
--- a/docker/sentinel_3/sentinel.conf
+++ b/docker/sentinel_3/sentinel.conf
@@ -1,7 +1,6 @@
-bind sentinel_3 127.0.0.1
 port 26381
 
-sentinel monitor redis-py-test master 6379 2
+sentinel monitor redis-py-test 127.0.0.1 6379 2
 sentinel down-after-milliseconds redis-py-test 5000
 sentinel failover-timeout redis-py-test 60000
 sentinel parallel-syncs redis-py-test 1
diff --git a/redis/client.py b/redis/client.py
index a6bd183bc6..4db9887f4d 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -6,10 +6,7 @@
 import threading
 import time
 import warnings
-from redis.commands import (
-    list_or_args,
-    Commands
-)
+from redis.commands import CoreCommands, RedisModuleCommands, list_or_args
 from redis.connection import (ConnectionPool, UnixDomainSocketConnection,
                               SSLConnection)
 from redis.lock import Lock
@@ -609,7 +606,7 @@ def parse_set_result(response, **options):
     return response and str_if_bytes(response) == 'OK'
 
 
-class Redis(Commands, object):
+class Redis(RedisModuleCommands, CoreCommands, object):
     """
     Implementation of the Redis protocol.
 
@@ -898,6 +895,47 @@ def set_response_callback(self, command, callback):
         "Set a custom Response Callback"
         self.response_callbacks[command] = callback
 
+    def load_external_module(self, modname, funcname, func):
+        """
+        This function can be used to add externally defined redis modules,
+        and their namespaces to the redis client.
+        modname - A string containing the name of the redis module to look for
+                  in the redis info block.
+        funcname - A string containing the name of the function to create
+        func - The function, being added to this class.
+
+        ex: Assume that one has a custom redis module named foomod that
+        creates command named 'foo.dothing' and 'foo.anotherthing' in redis.
+        To load function functions into this namespace:
+
+        from redis import Redis
+        from foomodule import F
+        r = Redis()
+        r.load_external_module("foomod", "foo", F)
+        r.foo().dothing('your', 'arguments')
+
+        For a concrete example see the reimport of the redisjson module in
+        tests/test_connection.py::test_loading_external_modules
+        """
+        mods = self.loaded_modules
+        if modname.lower() not in mods:
+            raise ModuleError("{} is not loaded in redis.".format(modname))
+        setattr(self, funcname, func)
+
+    @property
+    def loaded_modules(self):
+        key = '__redis_modules__'
+        mods = getattr(self, key, None)
+        if mods is not None:
+            return mods
+
+        try:
+            mods = [f.get('name').lower() for f in self.info().get('modules')]
+        except TypeError:
+            mods = []
+        setattr(self, key, mods)
+        return mods
+
     def pipeline(self, transaction=True, shard_hint=None):
         """
         Return a new pipeline object that can queue multiple commands for
diff --git a/redis/commands/__init__.py b/redis/commands/__init__.py
new file mode 100644
index 0000000000..f1ddaaabc1
--- /dev/null
+++ b/redis/commands/__init__.py
@@ -0,0 +1,11 @@
+from .core import CoreCommands
+from .redismodules import RedisModuleCommands
+from .helpers import list_or_args
+from .sentinel import SentinelCommands
+
+__all__ = [
+    'CoreCommands',
+    'RedisModuleCommands',
+    'SentinelCommands',
+    'list_or_args'
+]
diff --git a/redis/commands.py b/redis/commands/core.py
similarity index 96%
rename from redis/commands.py
rename to redis/commands/core.py
index 2697e780a4..6512b45a42 100644
--- a/redis/commands.py
+++ b/redis/commands/core.py
@@ -3,6 +3,7 @@
 import warnings
 import hashlib
 
+from .helpers import list_or_args
 from redis.exceptions import (
     ConnectionError,
     DataError,
@@ -11,24 +12,7 @@
 )
 
 
-def list_or_args(keys, args):
-    # returns a single new list combining keys and args
-    try:
-        iter(keys)
-        # a string or bytes instance can be iterated, but indicates
-        # keys wasn't passed as a list
-        if isinstance(keys, (bytes, str)):
-            keys = [keys]
-        else:
-            keys = list(keys)
-    except TypeError:
-        keys = [keys]
-    if args:
-        keys.extend(args)
-    return keys
-
-
-class Commands:
+class CoreCommands:
     """
     A class containing all of the implemented redis commands. This class is
     to be used as a mixin.
@@ -1173,16 +1157,16 @@ def set(self, name, value,
         if ex is not None:
             pieces.append('EX')
             if isinstance(ex, datetime.timedelta):
-                ex = int(ex.total_seconds())
-            if isinstance(ex, int):
+                pieces.append(int(ex.total_seconds()))
+            elif isinstance(ex, int):
                 pieces.append(ex)
             else:
                 raise DataError("ex must be datetime.timedelta or int")
         if px is not None:
             pieces.append('PX')
             if isinstance(px, datetime.timedelta):
-                px = int(px.total_seconds() * 1000)
-            if isinstance(px, int):
+                pieces.append(int(px.total_seconds() * 1000))
+            elif isinstance(px, int):
                 pieces.append(px)
             else:
                 raise DataError("px must be datetime.timedelta or int")
@@ -3413,99 +3397,3 @@ def execute(self):
         command = self.command
         self.reset()
         return self.client.execute_command(*command)
-
-
-class SentinelCommands:
-    """
-    A class containing the commands specific to redis sentinal. This class is
-    to be used as a mixin.
-    """
-
-    def sentinel(self, *args):
-        "Redis Sentinel's SENTINEL command."
-        warnings.warn(
-            DeprecationWarning('Use the individual sentinel_* methods'))
-
-    def sentinel_get_master_addr_by_name(self, service_name):
-        "Returns a (host, port) pair for the given ``service_name``"
-        return self.execute_command('SENTINEL GET-MASTER-ADDR-BY-NAME',
-                                    service_name)
-
-    def sentinel_master(self, service_name):
-        "Returns a dictionary containing the specified masters state."
-        return self.execute_command('SENTINEL MASTER', service_name)
-
-    def sentinel_masters(self):
-        "Returns a list of dictionaries containing each master's state."
-        return self.execute_command('SENTINEL MASTERS')
-
-    def sentinel_monitor(self, name, ip, port, quorum):
-        "Add a new master to Sentinel to be monitored"
-        return self.execute_command('SENTINEL MONITOR', name, ip, port, quorum)
-
-    def sentinel_remove(self, name):
-        "Remove a master from Sentinel's monitoring"
-        return self.execute_command('SENTINEL REMOVE', name)
-
-    def sentinel_sentinels(self, service_name):
-        "Returns a list of sentinels for ``service_name``"
-        return self.execute_command('SENTINEL SENTINELS', service_name)
-
-    def sentinel_set(self, name, option, value):
-        "Set Sentinel monitoring parameters for a given master"
-        return self.execute_command('SENTINEL SET', name, option, value)
-
-    def sentinel_slaves(self, service_name):
-        "Returns a list of slaves for ``service_name``"
-        return self.execute_command('SENTINEL SLAVES', service_name)
-
-    def sentinel_reset(self, pattern):
-        """
-        This command will reset all the masters with matching name.
-        The pattern argument is a glob-style pattern.
-
-        The reset process clears any previous state in a master (including a
-        failover in progress), and removes every slave and sentinel already
-        discovered and associated with the master.
-        """
-        return self.execute_command('SENTINEL RESET', pattern, once=True)
-
-    def sentinel_failover(self, new_master_name):
-        """
-        Force a failover as if the master was not reachable, and without
-        asking for agreement to other Sentinels (however a new version of the
-        configuration will be published so that the other Sentinels will
-        update their configurations).
-        """
-        return self.execute_command('SENTINEL FAILOVER', new_master_name)
-
-    def sentinel_ckquorum(self, new_master_name):
-        """
-        Check if the current Sentinel configuration is able to reach the
-        quorum needed to failover a master, and the majority needed to
-        authorize the failover.
-
-        This command should be used in monitoring systems to check if a
-        Sentinel deployment is ok.
-        """
-        return self.execute_command('SENTINEL CKQUORUM',
-                                    new_master_name,
-                                    once=True)
-
-    def sentinel_flushconfig(self):
-        """
-        Force Sentinel to rewrite its configuration on disk, including the
-        current Sentinel state.
-
-        Normally Sentinel rewrites the configuration every time something
-        changes in its state (in the context of the subset of the state which
-        is persisted on disk across restart).
-        However sometimes it is possible that the configuration file is lost
-        because of operation errors, disk failures, package upgrade scripts or
-        configuration managers. In those cases a way to to force Sentinel to
-        rewrite the configuration file is handy.
-
-        This command works even if the previous configuration file is
-        completely missing.
-        """
-        return self.execute_command('SENTINEL FLUSHCONFIG')
diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
new file mode 100644
index 0000000000..b012621b3b
--- /dev/null
+++ b/redis/commands/helpers.py
@@ -0,0 +1,25 @@
+def list_or_args(keys, args):
+    # returns a single new list combining keys and args
+    try:
+        iter(keys)
+        # a string or bytes instance can be iterated, but indicates
+        # keys wasn't passed as a list
+        if isinstance(keys, (bytes, str)):
+            keys = [keys]
+        else:
+            keys = list(keys)
+    except TypeError:
+        keys = [keys]
+    if args:
+        keys.extend(args)
+    return keys
+
+
+def nativestr(x):
+    """Return the decoded binary string, or a string, depending on type."""
+    return x.decode("utf-8", "replace") if isinstance(x, bytes) else x
+
+
+def delist(x):
+    """Given a list of binaries, return the stringified version."""
+    return [nativestr(obj) for obj in x]
diff --git a/redis/commands/json/__init__.py b/redis/commands/json/__init__.py
new file mode 100644
index 0000000000..92f119992f
--- /dev/null
+++ b/redis/commands/json/__init__.py
@@ -0,0 +1,84 @@
+# from typing import Optional
+from json import JSONDecoder, JSONEncoder
+
+# # from redis.client import Redis
+
+from .helpers import bulk_of_jsons
+from ..helpers import nativestr, delist
+from .commands import JSONCommands
+# from ..feature import AbstractFeature
+
+
+class JSON(JSONCommands):
+    """
+    Create a client for talking to json.
+
+    :param decoder:
+    :type json.JSONDecoder: An instance of json.JSONDecoder
+
+    :param encoder:
+    :type json.JSONEncoder: An instance of json.JSONEncoder
+    """
+
+    def __init__(
+        self,
+        client,
+        decoder=JSONDecoder(),
+        encoder=JSONEncoder(),
+    ):
+        """
+        Create a client for talking to json.
+
+        :param decoder:
+        :type json.JSONDecoder: An instance of json.JSONDecoder
+
+        :param encoder:
+        :type json.JSONEncoder: An instance of json.JSONEncoder
+        """
+        # Set the module commands' callbacks
+        self.MODULE_CALLBACKS = {
+            "JSON.CLEAR": int,
+            "JSON.DEL": int,
+            "JSON.FORGET": int,
+            "JSON.GET": self._decode,
+            "JSON.MGET": bulk_of_jsons(self._decode),
+            "JSON.SET": lambda r: r and nativestr(r) == "OK",
+            "JSON.NUMINCRBY": self._decode,
+            "JSON.NUMMULTBY": self._decode,
+            "JSON.TOGGLE": lambda b: b == b"true",
+            "JSON.STRAPPEND": int,
+            "JSON.STRLEN": int,
+            "JSON.ARRAPPEND": int,
+            "JSON.ARRINDEX": int,
+            "JSON.ARRINSERT": int,
+            "JSON.ARRLEN": int,
+            "JSON.ARRPOP": self._decode,
+            "JSON.ARRTRIM": int,
+            "JSON.OBJLEN": int,
+            "JSON.OBJKEYS": delist,
+            # "JSON.RESP": delist,
+            "JSON.DEBUG": int,
+        }
+
+        self.client = client
+        self.execute_command = client.execute_command
+
+        for key, value in self.MODULE_CALLBACKS.items():
+            self.client.set_response_callback(key, value)
+
+        self.__encoder__ = encoder
+        self.__decoder__ = decoder
+
+    def _decode(self, obj):
+        """Get the decoder."""
+        if obj is None:
+            return obj
+
+        try:
+            return self.__decoder__.decode(obj)
+        except TypeError:
+            return self.__decoder__.decode(obj.decode())
+
+    def _encode(self, obj):
+        """Get the encoder."""
+        return self.__encoder__.encode(obj)
diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
new file mode 100644
index 0000000000..2f8039f8bf
--- /dev/null
+++ b/redis/commands/json/commands.py
@@ -0,0 +1,197 @@
+from .path import Path, str_path
+from .helpers import decode_dict_keys
+
+
+class JSONCommands:
+    """json commands."""
+
+    def arrappend(self, name, path=Path.rootPath(), *args):
+        """Append the objects ``args`` to the array under the
+        ``path` in key ``name``.
+        """
+        pieces = [name, str_path(path)]
+        for o in args:
+            pieces.append(self._encode(o))
+        return self.execute_command("JSON.ARRAPPEND", *pieces)
+
+    def arrindex(self, name, path, scalar, start=0, stop=-1):
+        """
+        Return the index of ``scalar`` in the JSON array under ``path`` at key
+        ``name``.
+
+        The search can be limited using the optional inclusive ``start``
+        and exclusive ``stop`` indices.
+        """
+        return self.execute_command(
+            "JSON.ARRINDEX", name, str_path(path), self._encode(scalar),
+            start, stop
+        )
+
+    def arrinsert(self, name, path, index, *args):
+        """Insert the objects ``args`` to the array at index ``index``
+        under the ``path` in key ``name``.
+        """
+        pieces = [name, str_path(path), index]
+        for o in args:
+            pieces.append(self._encode(o))
+        return self.execute_command("JSON.ARRINSERT", *pieces)
+
+    def forget(self, name, path=Path.rootPath()):
+        """Alias for jsondel (delete the JSON value)."""
+        return self.execute_command("JSON.FORGET", name, str_path(path))
+
+    def arrlen(self, name, path=Path.rootPath()):
+        """Return the length of the array JSON value under ``path``
+        at key``name``.
+        """
+        return self.execute_command("JSON.ARRLEN", name, str_path(path))
+
+    def arrpop(self, name, path=Path.rootPath(), index=-1):
+        """Pop the element at ``index`` in the array JSON value under
+        ``path`` at key ``name``.
+        """
+        return self.execute_command("JSON.ARRPOP", name, str_path(path), index)
+
+    def arrtrim(self, name, path, start, stop):
+        """Trim the array JSON value under ``path`` at key ``name`` to the
+        inclusive range given by ``start`` and ``stop``.
+        """
+        return self.execute_command("JSON.ARRTRIM", name, str_path(path),
+                                    start, stop)
+
+    def type(self, name, path=Path.rootPath()):
+        """Get the type of the JSON value under ``path`` from key ``name``."""
+        return self.execute_command("JSON.TYPE", name, str_path(path))
+
+    def resp(self, name, path=Path.rootPath()):
+        """Return the JSON value under ``path`` at key ``name``."""
+        return self.execute_command("JSON.RESP", name, str_path(path))
+
+    def objkeys(self, name, path=Path.rootPath()):
+        """Return the key names in the dictionary JSON value under ``path`` at
+        key ``name``."""
+        return self.execute_command("JSON.OBJKEYS", name, str_path(path))
+
+    def objlen(self, name, path=Path.rootPath()):
+        """Return the length of the dictionary JSON value under ``path`` at key
+        ``name``.
+        """
+        return self.execute_command("JSON.OBJLEN", name, str_path(path))
+
+    def numincrby(self, name, path, number):
+        """Increment the numeric (integer or floating point) JSON value under
+        ``path`` at key ``name`` by the provided ``number``.
+        """
+        return self.execute_command(
+            "JSON.NUMINCRBY", name, str_path(path), self._encode(number)
+        )
+
+    def nummultby(self, name, path, number):
+        """Multiply the numeric (integer or floating point) JSON value under
+        ``path`` at key ``name`` with the provided ``number``.
+        """
+        return self.execute_command(
+            "JSON.NUMMULTBY", name, str_path(path), self._encode(number)
+        )
+
+    def clear(self, name, path=Path.rootPath()):
+        """
+        Empty arrays and objects (to have zero slots/keys without deleting the
+        array/object).
+
+        Return the count of cleared paths (ignoring non-array and non-objects
+        paths).
+        """
+        return self.execute_command("JSON.CLEAR", name, str_path(path))
+
+    def delete(self, name, path=Path.rootPath()):
+        """Delete the JSON value stored at key ``name`` under ``path``."""
+        return self.execute_command("JSON.DEL", name, str_path(path))
+
+    def get(self, name, *args, no_escape=False):
+        """
+        Get the object stored as a JSON value at key ``name``.
+
+        ``args`` is zero or more paths, and defaults to root path
+        ```no_escape`` is a boolean flag to add no_escape option to get
+        non-ascii characters
+        """
+        pieces = [name]
+        if no_escape:
+            pieces.append("noescape")
+
+        if len(args) == 0:
+            pieces.append(Path.rootPath())
+
+        else:
+            for p in args:
+                pieces.append(str_path(p))
+
+        # Handle case where key doesn't exist. The JSONDecoder would raise a
+        # TypeError exception since it can't decode None
+        try:
+            return self.execute_command("JSON.GET", *pieces)
+        except TypeError:
+            return None
+
+    def mget(self, path, *args):
+        """Get the objects stored as a JSON values under ``path`` from keys
+        ``args``.
+        """
+        pieces = []
+        pieces.extend(args)
+        pieces.append(str_path(path))
+        return self.execute_command("JSON.MGET", *pieces)
+
+    def set(self, name, path, obj, nx=False, xx=False, decode_keys=False):
+        """
+        Set the JSON value at key ``name`` under the ``path`` to ``obj``.
+
+        ``nx`` if set to True, set ``value`` only if it does not exist.
+        ``xx`` if set to True, set ``value`` only if it exists.
+        ``decode_keys`` If set to True, the keys of ``obj`` will be decoded
+        with utf-8.
+        """
+        if decode_keys:
+            obj = decode_dict_keys(obj)
+
+        pieces = [name, str_path(path), self._encode(obj)]
+
+        # Handle existential modifiers
+        if nx and xx:
+            raise Exception(
+                "nx and xx are mutually exclusive: use one, the "
+                "other or neither - but not both"
+            )
+        elif nx:
+            pieces.append("NX")
+        elif xx:
+            pieces.append("XX")
+        return self.execute_command("JSON.SET", *pieces)
+
+    def strlen(self, name, path=Path.rootPath()):
+        """Return the length of the string JSON value under ``path`` at key
+        ``name``.
+        """
+        return self.execute_command("JSON.STRLEN", name, str_path(path))
+
+    def toggle(self, name, path=Path.rootPath()):
+        """Toggle boolean value under ``path`` at key ``name``.
+        returning the new value.
+        """
+        return self.execute_command("JSON.TOGGLE", name, str_path(path))
+
+    def strappend(self, name, string, path=Path.rootPath()):
+        """Append to the string JSON value under ``path`` at key ``name``
+        the provided ``string``.
+        """
+        return self.execute_command(
+            "JSON.STRAPPEND", name, str_path(path), self._encode(string)
+        )
+
+    def debug(self, name, path=Path.rootPath()):
+        """Return the memory usage in bytes of a value under ``path`` from
+        key ``name``.
+        """
+        return self.execute_command("JSON.DEBUG", "MEMORY",
+                                    name, str_path(path))
diff --git a/redis/commands/json/helpers.py b/redis/commands/json/helpers.py
new file mode 100644
index 0000000000..8fb20d9ac5
--- /dev/null
+++ b/redis/commands/json/helpers.py
@@ -0,0 +1,25 @@
+import copy
+
+
+def bulk_of_jsons(d):
+    """Replace serialized JSON values with objects in a
+    bulk array response (list).
+    """
+
+    def _f(b):
+        for index, item in enumerate(b):
+            if item is not None:
+                b[index] = d(item)
+        return b
+
+    return _f
+
+
+def decode_dict_keys(obj):
+    """Decode the keys of the given dictionary with utf-8."""
+    newobj = copy.copy(obj)
+    for k in obj.keys():
+        if isinstance(k, bytes):
+            newobj[k.decode("utf-8")] = newobj[k]
+            newobj.pop(k)
+    return newobj
diff --git a/redis/commands/json/path.py b/redis/commands/json/path.py
new file mode 100644
index 0000000000..dff86482df
--- /dev/null
+++ b/redis/commands/json/path.py
@@ -0,0 +1,21 @@
+def str_path(p):
+    """Return the string representation of a path if it is of class Path."""
+    if isinstance(p, Path):
+        return p.strPath
+    else:
+        return p
+
+
+class Path(object):
+    """This class represents a path in a JSON value."""
+
+    strPath = ""
+
+    @staticmethod
+    def rootPath():
+        """Return the root path's string representation."""
+        return "."
+
+    def __init__(self, path):
+        """Make a new path based on the string representation in `path`."""
+        self.strPath = path
diff --git a/redis/commands/redismodules.py b/redis/commands/redismodules.py
new file mode 100644
index 0000000000..fb53107130
--- /dev/null
+++ b/redis/commands/redismodules.py
@@ -0,0 +1,17 @@
+from json import JSONEncoder, JSONDecoder
+from redis.exceptions import ModuleError
+
+
+class RedisModuleCommands:
+    """This class contains the wrapper functions to bring supported redis
+    modules into the command namepsace.
+    """
+
+    def json(self, encoder=JSONEncoder(), decoder=JSONDecoder()):
+        """Access the json namespace, providing support for redis json."""
+        if 'rejson' not in self.loaded_modules:
+            raise ModuleError("rejson is not a loaded in the redis instance.")
+
+        from .json import JSON
+        jj = JSON(client=self, encoder=encoder, decoder=decoder)
+        return jj
diff --git a/redis/commands/sentinel.py b/redis/commands/sentinel.py
new file mode 100644
index 0000000000..1f02984bed
--- /dev/null
+++ b/redis/commands/sentinel.py
@@ -0,0 +1,97 @@
+import warnings
+
+
+class SentinelCommands:
+    """
+    A class containing the commands specific to redis sentinal. This class is
+    to be used as a mixin.
+    """
+
+    def sentinel(self, *args):
+        "Redis Sentinel's SENTINEL command."
+        warnings.warn(
+            DeprecationWarning('Use the individual sentinel_* methods'))
+
+    def sentinel_get_master_addr_by_name(self, service_name):
+        "Returns a (host, port) pair for the given ``service_name``"
+        return self.execute_command('SENTINEL GET-MASTER-ADDR-BY-NAME',
+                                    service_name)
+
+    def sentinel_master(self, service_name):
+        "Returns a dictionary containing the specified masters state."
+        return self.execute_command('SENTINEL MASTER', service_name)
+
+    def sentinel_masters(self):
+        "Returns a list of dictionaries containing each master's state."
+        return self.execute_command('SENTINEL MASTERS')
+
+    def sentinel_monitor(self, name, ip, port, quorum):
+        "Add a new master to Sentinel to be monitored"
+        return self.execute_command('SENTINEL MONITOR', name, ip, port, quorum)
+
+    def sentinel_remove(self, name):
+        "Remove a master from Sentinel's monitoring"
+        return self.execute_command('SENTINEL REMOVE', name)
+
+    def sentinel_sentinels(self, service_name):
+        "Returns a list of sentinels for ``service_name``"
+        return self.execute_command('SENTINEL SENTINELS', service_name)
+
+    def sentinel_set(self, name, option, value):
+        "Set Sentinel monitoring parameters for a given master"
+        return self.execute_command('SENTINEL SET', name, option, value)
+
+    def sentinel_slaves(self, service_name):
+        "Returns a list of slaves for ``service_name``"
+        return self.execute_command('SENTINEL SLAVES', service_name)
+
+    def sentinel_reset(self, pattern):
+        """
+        This command will reset all the masters with matching name.
+        The pattern argument is a glob-style pattern.
+
+        The reset process clears any previous state in a master (including a
+        failover in progress), and removes every slave and sentinel already
+        discovered and associated with the master.
+        """
+        return self.execute_command('SENTINEL RESET', pattern, once=True)
+
+    def sentinel_failover(self, new_master_name):
+        """
+        Force a failover as if the master was not reachable, and without
+        asking for agreement to other Sentinels (however a new version of the
+        configuration will be published so that the other Sentinels will
+        update their configurations).
+        """
+        return self.execute_command('SENTINEL FAILOVER', new_master_name)
+
+    def sentinel_ckquorum(self, new_master_name):
+        """
+        Check if the current Sentinel configuration is able to reach the
+        quorum needed to failover a master, and the majority needed to
+        authorize the failover.
+
+        This command should be used in monitoring systems to check if a
+        Sentinel deployment is ok.
+        """
+        return self.execute_command('SENTINEL CKQUORUM',
+                                    new_master_name,
+                                    once=True)
+
+    def sentinel_flushconfig(self):
+        """
+        Force Sentinel to rewrite its configuration on disk, including the
+        current Sentinel state.
+
+        Normally Sentinel rewrites the configuration every time something
+        changes in its state (in the context of the subset of the state which
+        is persisted on disk across restart).
+        However sometimes it is possible that the configuration file is lost
+        because of operation errors, disk failures, package upgrade scripts or
+        configuration managers. In those cases a way to to force Sentinel to
+        rewrite the configuration file is handy.
+
+        This command works even if the previous configuration file is
+        completely missing.
+        """
+        return self.execute_command('SENTINEL FLUSHCONFIG')
diff --git a/tests/conftest.py b/tests/conftest.py
index c099463807..9ca429dafa 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -11,6 +11,7 @@
 
 REDIS_INFO = {}
 default_redis_url = "redis://localhost:6379/9"
+default_redismod_url = "redis://localhost:36379/9"
 
 
 def pytest_addoption(parser):
@@ -19,6 +20,12 @@ def pytest_addoption(parser):
                      help="Redis connection string,"
                           " defaults to `%(default)s`")
 
+    parser.addoption('--redismod-url', default=default_redismod_url,
+                     action="store",
+                     help="Connection string to redis server"
+                          " with loaded modules,"
+                          " defaults to `%(default)s`")
+
 
 def _get_info(redis_url):
     client = redis.Redis.from_url(redis_url)
@@ -35,6 +42,11 @@ def pytest_sessionstart(session):
     REDIS_INFO["version"] = version
     REDIS_INFO["arch_bits"] = arch_bits
 
+    # module info
+    redismod_url = session.config.getoption("--redismod-url")
+    info = _get_info(redismod_url)
+    REDIS_INFO["modules"] = info["modules"]
+
 
 def skip_if_server_version_lt(min_version):
     redis_version = REDIS_INFO["version"]
@@ -57,6 +69,21 @@ def skip_unless_arch_bits(arch_bits):
                               reason="server is not {}-bit".format(arch_bits))
 
 
+def skip_ifmodversion_lt(min_version: str, module_name: str):
+    modules = REDIS_INFO["modules"]
+    if modules == []:
+        return pytest.mark.skipif(True, reason="No redis modules found")
+
+    for j in modules:
+        if module_name == j.get('name'):
+            version = j.get('ver')
+            mv = int(min_version.replace(".", ""))
+            check = version < mv
+            return pytest.mark.skipif(check, reason="Redis module version")
+
+    raise AttributeError("No redis module named {}".format(module_name))
+
+
 def _get_client(cls, request, single_connection_client=True, flushdb=True,
                 **kwargs):
     """
@@ -88,6 +115,12 @@ def teardown():
     return client
 
 
+@pytest.fixture()
+def modclient(request, port=36379, **kwargs):
+    with _get_client(redis.Redis, request, port=port, **kwargs) as client:
+        yield client
+
+
 @pytest.fixture()
 def r(request):
     with _get_client(redis.Redis, request) as client:
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 694090ea7f..6d65931539 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2552,7 +2552,7 @@ def test_geosearch(self, r):
         assert r.geosearch('barcelona', member='place3', radius=100,
                            unit='km', count=2) == [b'place3', b'\x80place2']
         assert r.geosearch('barcelona', member='place3', radius=100,
-                           unit='km', count=1, any=True)[0] \
+                           unit='km', count=1, any=1)[0] \
                in [b'place1', b'place3', b'\x80place2']
 
     @skip_unless_arch_bits(64)
@@ -2657,8 +2657,7 @@ def test_geosearch_negative(self, r):
 
         # use any without count
         with pytest.raises(exceptions.DataError):
-            assert r.geosearch('barcelona', member='place3',
-                               radius=100, any=True)
+            assert r.geosearch('barcelona', member='place3', radius=100, any=1)
 
     @skip_if_server_version_lt('6.2.0')
     def test_geosearchstore(self, r):
@@ -3239,7 +3238,6 @@ def test_xpending_range(self, r):
         response = r.xpending_range(stream, group,
                                     min='-', max='+', count=5,
                                     consumername=consumer1)
-        assert len(response) == 1
         assert response[0]['message_id'] == m1
         assert response[0]['consumer'] == consumer1.encode()
 
@@ -3604,7 +3602,8 @@ def test_memory_usage(self, r):
     @skip_if_server_version_lt('4.0.0')
     def test_module_list(self, r):
         assert isinstance(r.module_list(), list)
-        assert not r.module_list()
+        for x in r.module_list():
+            assert isinstance(x, dict)
 
     @skip_if_server_version_lt('2.8.13')
     def test_command_count(self, r):
diff --git a/tests/test_connection.py b/tests/test_connection.py
index 128bac7d96..6728e0a05f 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -1,8 +1,10 @@
 from unittest import mock
+import types
 import pytest
 
-from redis.exceptions import InvalidResponse
+from redis.exceptions import InvalidResponse, ModuleError
 from redis.utils import HIREDIS_AVAILABLE
+from .conftest import skip_if_server_version_lt
 
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason='PythonParser only')
@@ -13,3 +15,32 @@ def test_invalid_response(r):
         with pytest.raises(InvalidResponse) as cm:
             parser.read_response()
     assert str(cm.value) == 'Protocol Error: %r' % raw
+
+
+@skip_if_server_version_lt('4.0.0')
+def test_loaded_modules(r, modclient):
+    assert r.loaded_modules == []
+    assert 'rejson' in modclient.loaded_modules
+
+
+@skip_if_server_version_lt('4.0.0')
+def test_loading_external_modules(r, modclient):
+    def inner():
+        pass
+
+    with pytest.raises(ModuleError):
+        r.load_external_module('rejson', 'myfuncname', inner)
+
+    modclient.load_external_module('rejson', 'myfuncname', inner)
+    assert getattr(modclient, 'myfuncname') == inner
+    assert isinstance(getattr(modclient, 'myfuncname'), types.FunctionType)
+
+    # and call it
+    from redis.commands import RedisModuleCommands
+    j = RedisModuleCommands.json
+    modclient.load_external_module('rejson', 'sometestfuncname', j)
+
+    d = {'hello': 'world!'}
+    mod = j(modclient)
+    mod.set("fookey", ".", d)
+    assert mod.get('fookey') == d
diff --git a/tests/test_json.py b/tests/test_json.py
new file mode 100644
index 0000000000..96675f1e45
--- /dev/null
+++ b/tests/test_json.py
@@ -0,0 +1,235 @@
+import pytest
+import redis
+from redis.commands.json.path import Path
+from .conftest import skip_ifmodversion_lt
+
+
+@pytest.fixture
+def client(modclient):
+    modclient.flushdb()
+    return modclient
+
+
+@pytest.mark.json
+def test_json_setbinarykey(client):
+    d = {"hello": "world", b"some": "value"}
+    with pytest.raises(TypeError):
+        client.json().set("somekey", Path.rootPath(), d)
+    assert client.json().set("somekey", Path.rootPath(), d, decode_keys=True)
+
+
+@pytest.mark.json
+def test_json_setgetdeleteforget(client):
+    assert client.json().set("foo", Path.rootPath(), "bar")
+    assert client.json().get("foo") == "bar"
+    assert client.json().get("baz") is None
+    assert client.json().delete("foo") == 1
+    assert client.json().forget("foo") == 0  # second delete
+    assert client.exists("foo") == 0
+
+
+@pytest.mark.json
+def test_justaget(client):
+    client.json().set("foo", Path.rootPath(), "bar")
+    assert client.json().get("foo") == "bar"
+
+
+@pytest.mark.json
+def test_json_get_jset(client):
+    assert client.json().set("foo", Path.rootPath(), "bar")
+    assert "bar" == client.json().get("foo")
+    assert client.json().get("baz") is None
+    assert 1 == client.json().delete("foo")
+    assert client.exists("foo") == 0
+
+
+@pytest.mark.json
+def test_nonascii_setgetdelete(client):
+    assert client.json().set("notascii", Path.rootPath(),
+                             "hyvää-élève") is True
+    assert "hyvää-élève" == client.json().get("notascii", no_escape=True)
+    assert 1 == client.json().delete("notascii")
+    assert client.exists("notascii") == 0
+
+
+@pytest.mark.json
+def test_jsonsetexistentialmodifiersshouldsucceed(client):
+    obj = {"foo": "bar"}
+    assert client.json().set("obj", Path.rootPath(), obj)
+
+    # Test that flags prevent updates when conditions are unmet
+    assert client.json().set("obj", Path("foo"), "baz", nx=True) is None
+    assert client.json().set("obj", Path("qaz"), "baz", xx=True) is None
+
+    # Test that flags allow updates when conditions are met
+    assert client.json().set("obj", Path("foo"), "baz", xx=True)
+    assert client.json().set("obj", Path("qaz"), "baz", nx=True)
+
+    # Test that flags are mutually exlusive
+    with pytest.raises(Exception):
+        client.json().set("obj", Path("foo"), "baz", nx=True, xx=True)
+
+
+@pytest.mark.json
+def test_mgetshouldsucceed(client):
+    client.json().set("1", Path.rootPath(), 1)
+    client.json().set("2", Path.rootPath(), 2)
+    r = client.json().mget(Path.rootPath(), "1", "2")
+    e = [1, 2]
+    assert e == r
+
+
+@pytest.mark.json
+@skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
+def test_clearShouldSucceed(client):
+    client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
+    assert 1 == client.json().clear("arr", Path.rootPath())
+    assert [] == client.json().get("arr")
+
+
+@pytest.mark.json
+def test_typeshouldsucceed(client):
+    client.json().set("1", Path.rootPath(), 1)
+    assert b"integer" == client.json().type("1")
+
+
+@pytest.mark.json
+def test_numincrbyshouldsucceed(client):
+    client.json().set("num", Path.rootPath(), 1)
+    assert 2 == client.json().numincrby("num", Path.rootPath(), 1)
+    assert 2.5 == client.json().numincrby("num", Path.rootPath(), 0.5)
+    assert 1.25 == client.json().numincrby("num", Path.rootPath(), -1.25)
+
+
+@pytest.mark.json
+def test_nummultbyshouldsucceed(client):
+    client.json().set("num", Path.rootPath(), 1)
+    assert 2 == client.json().nummultby("num", Path.rootPath(), 2)
+    assert 5 == client.json().nummultby("num", Path.rootPath(), 2.5)
+    assert 2.5 == client.json().nummultby("num", Path.rootPath(), 0.5)
+
+
+@pytest.mark.json
+@skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
+def test_toggleShouldSucceed(client):
+    client.json().set("bool", Path.rootPath(), False)
+    assert client.json().toggle("bool", Path.rootPath())
+    assert not client.json().toggle("bool", Path.rootPath())
+    # check non-boolean value
+    client.json().set("num", Path.rootPath(), 1)
+    with pytest.raises(redis.exceptions.ResponseError):
+        client.json().toggle("num", Path.rootPath())
+
+
+@pytest.mark.json
+def test_strappendshouldsucceed(client):
+    client.json().set("str", Path.rootPath(), "foo")
+    assert 6 == client.json().strappend("str", "bar", Path.rootPath())
+    assert "foobar" == client.json().get("str", Path.rootPath())
+
+
+@pytest.mark.json
+def test_debug(client):
+    client.json().set("str", Path.rootPath(), "foo")
+    assert 24 == client.json().debug("str", Path.rootPath())
+
+
+@pytest.mark.json
+def test_strlenshouldsucceed(client):
+    client.json().set("str", Path.rootPath(), "foo")
+    assert 3 == client.json().strlen("str", Path.rootPath())
+    client.json().strappend("str", "bar", Path.rootPath())
+    assert 6 == client.json().strlen("str", Path.rootPath())
+
+
+@pytest.mark.json
+def test_arrappendshouldsucceed(client):
+    client.json().set("arr", Path.rootPath(), [1])
+    assert 2 == client.json().arrappend("arr", Path.rootPath(), 2)
+    assert 4 == client.json().arrappend("arr", Path.rootPath(), 3, 4)
+    assert 7 == client.json().arrappend("arr", Path.rootPath(), *[5, 6, 7])
+
+
+@pytest.mark.json
+def testArrIndexShouldSucceed(client):
+    client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
+    assert 1 == client.json().arrindex("arr", Path.rootPath(), 1)
+    assert -1 == client.json().arrindex("arr", Path.rootPath(), 1, 2)
+
+
+@pytest.mark.json
+def test_arrinsertshouldsucceed(client):
+    client.json().set("arr", Path.rootPath(), [0, 4])
+    assert 5 - -client.json().arrinsert(
+        "arr",
+        Path.rootPath(),
+        1,
+        *[
+            1,
+            2,
+            3,
+        ]
+    )
+    assert [0, 1, 2, 3, 4] == client.json().get("arr")
+
+
+@pytest.mark.json
+def test_arrlenshouldsucceed(client):
+    client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
+    assert 5 == client.json().arrlen("arr", Path.rootPath())
+
+
+@pytest.mark.json
+def test_arrpopshouldsucceed(client):
+    client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
+    assert 4 == client.json().arrpop("arr", Path.rootPath(), 4)
+    assert 3 == client.json().arrpop("arr", Path.rootPath(), -1)
+    assert 2 == client.json().arrpop("arr", Path.rootPath())
+    assert 0 == client.json().arrpop("arr", Path.rootPath(), 0)
+    assert [1] == client.json().get("arr")
+
+
+@pytest.mark.json
+def test_arrtrimshouldsucceed(client):
+    client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
+    assert 3 == client.json().arrtrim("arr", Path.rootPath(), 1, 3)
+    assert [1, 2, 3] == client.json().get("arr")
+
+
+@pytest.mark.json
+def test_respshouldsucceed(client):
+    obj = {"foo": "bar", "baz": 1, "qaz": True}
+    client.json().set("obj", Path.rootPath(), obj)
+    assert b"bar" == client.json().resp("obj", Path("foo"))
+    assert 1 == client.json().resp("obj", Path("baz"))
+    assert client.json().resp("obj", Path("qaz"))
+
+
+@pytest.mark.json
+def test_objkeysshouldsucceed(client):
+    obj = {"foo": "bar", "baz": "qaz"}
+    client.json().set("obj", Path.rootPath(), obj)
+    keys = client.json().objkeys("obj", Path.rootPath())
+    keys.sort()
+    exp = list(obj.keys())
+    exp.sort()
+    assert exp == keys
+
+
+@pytest.mark.json
+def test_objlenshouldsucceed(client):
+    obj = {"foo": "bar", "baz": "qaz"}
+    client.json().set("obj", Path.rootPath(), obj)
+    assert len(obj) == client.json().objlen("obj", Path.rootPath())
+
+
+# @pytest.mark.pipeline
+# @pytest.mark.json
+# def test_pipelineshouldsucceed(client):
+#     p = client.json().pipeline()
+#     p.set("foo", Path.rootPath(), "bar")
+#     p.get("foo")
+#     p.delete("foo")
+#     assert [True, "bar", 1] == p.execute()
+#     assert client.keys() == []
+#     assert client.get("foo") is None
diff --git a/tox.ini b/tox.ini
index bfe937fe9e..78052963c6 100644
--- a/tox.ini
+++ b/tox.ini
@@ -1,5 +1,7 @@
 [pytest]
 addopts = -s
+markers =
+    json: run only the redisjson module tests
 
 [tox]
 minversion = 3.2.0
@@ -8,63 +10,63 @@ envlist = {py35,py36,py37,py38,py39,pypy3}-{plain,hiredis}, flake8
 
 [docker:master]
 name = master
-image = redis:6.2-bullseye
+image = redisfab/redis-py:6.2.6-buster
 ports =
     6379:6379/tcp
 healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',6379)) else False"
 volumes =
-    bind:rw:{toxinidir}/docker/master/redis.conf:/usr/local/etc/redis/redis.conf
+    bind:rw:{toxinidir}/docker/master/redis.conf:/redis.conf
 
 [docker:replica]
 name = replica
-image = redis:6.2-bullseye
+image = redisfab/redis-py:6.2.6-buster
 links =
     master:master
 ports =
     6380:6380/tcp
 healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',6380)) else False"
 volumes =
-    bind:rw:{toxinidir}/docker/replica/redis.conf:/usr/local/etc/redis/redis.conf
+    bind:rw:{toxinidir}/docker/replica/redis.conf:/redis.conf
 
 [docker:sentinel_1]
 name = sentinel_1
-image = redis:6.2-bullseye
+image = redisfab/redis-py-sentinel:6.2.6-buster
 links =
     master:master
 ports =
     26379:26379/tcp
 healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26379)) else False"
 volumes =
-    bind:rw:{toxinidir}/docker/sentinel_1/sentinel.conf:/usr/local/etc/redis/sentinel.conf
+    bind:rw:{toxinidir}/docker/sentinel_1/sentinel.conf:/sentinel.conf
 
 [docker:sentinel_2]
 name = sentinel_2
-image = redis:6.2-bullseye
+image = redisfab/redis-py-sentinel:6.2.6-buster
 links =
     master:master
 ports =
     26380:26380/tcp
 healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26380)) else False"
 volumes =
-    bind:rw:{toxinidir}/docker/sentinel_2/sentinel.conf:/usr/local/etc/redis/sentinel.conf
+    bind:rw:{toxinidir}/docker/sentinel_2/sentinel.conf:/sentinel.conf
 
 [docker:sentinel_3]
 name = sentinel_3
-image = redis:6.2-bullseye
+image = redisfab/redis-py-sentinel:6.2.6-buster
 links =
     master:master
 ports =
     26381:26381/tcp
 healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26381)) else False"
 volumes =
-    bind:rw:{toxinidir}/docker/sentinel_3/sentinel.conf:/usr/local/etc/redis/sentinel.conf
+    bind:rw:{toxinidir}/docker/sentinel_3/sentinel.conf:/sentinel.conf
 
 [docker:redismod]
 name = redismod
 image = redislabs/redismod:edge
 ports =
-    16379:16379/tcp
-healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',16379)) else False"
+    36379:6379/tcp
+healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',36379)) else False"
 
 [docker:lots-of-pythons]
 name = lots-of-pythons
@@ -98,7 +100,7 @@ docker =
     sentinel_3
     redismod
     lots-of-pythons
-commands = echo
+commands = /usr/bin/echo
 
 [testenv:flake8]
 deps_files = dev_requirements.txt

From ddd1496782cc8eb15fca6c9059b2b08a03efe366 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Mon, 25 Oct 2021 17:18:27 +0300
Subject: [PATCH 0209/1164] Adding support for redisearch (#1640)

---
 redis/commands/redismodules.py           |    9 +
 redis/commands/search/__init__.py        |   96 +
 redis/commands/search/_util.py           |   10 +
 redis/commands/search/aggregation.py     |  408 ++
 redis/commands/search/commands.py        |  704 ++++
 redis/commands/search/document.py        |   16 +
 redis/commands/search/field.py           |   94 +
 redis/commands/search/indexDefinition.py |   80 +
 redis/commands/search/query.py           |  328 ++
 redis/commands/search/querystring.py     |  324 ++
 redis/commands/search/reducers.py        |  178 +
 redis/commands/search/result.py          |   75 +
 redis/commands/search/suggestion.py      |   54 +
 tasks.py                                 |    1 -
 tests/conftest.py                        |   15 +-
 tests/test_json.py                       |   50 +-
 tests/test_search.py                     | 1219 ++++++
 tests/testdata/titles.csv                | 4861 ++++++++++++++++++++++
 tests/testdata/will_play_text.csv.bz2    |  Bin 0 -> 2069623 bytes
 tox.ini                                  |    2 +-
 20 files changed, 8494 insertions(+), 30 deletions(-)
 create mode 100644 redis/commands/search/__init__.py
 create mode 100644 redis/commands/search/_util.py
 create mode 100644 redis/commands/search/aggregation.py
 create mode 100644 redis/commands/search/commands.py
 create mode 100644 redis/commands/search/document.py
 create mode 100644 redis/commands/search/field.py
 create mode 100644 redis/commands/search/indexDefinition.py
 create mode 100644 redis/commands/search/query.py
 create mode 100644 redis/commands/search/querystring.py
 create mode 100644 redis/commands/search/reducers.py
 create mode 100644 redis/commands/search/result.py
 create mode 100644 redis/commands/search/suggestion.py
 create mode 100644 tests/test_search.py
 create mode 100644 tests/testdata/titles.csv
 create mode 100755 tests/testdata/will_play_text.csv.bz2

diff --git a/redis/commands/redismodules.py b/redis/commands/redismodules.py
index fb53107130..2c9066a2e7 100644
--- a/redis/commands/redismodules.py
+++ b/redis/commands/redismodules.py
@@ -15,3 +15,12 @@ def json(self, encoder=JSONEncoder(), decoder=JSONDecoder()):
         from .json import JSON
         jj = JSON(client=self, encoder=encoder, decoder=decoder)
         return jj
+
+    def ft(self, index_name="idx"):
+        """Access the search namespace, providing support for redis search."""
+        if 'search' not in self.loaded_modules:
+            raise ModuleError("search is not a loaded in the redis instance.")
+
+        from .search import Search
+        s = Search(client=self, index_name=index_name)
+        return s
diff --git a/redis/commands/search/__init__.py b/redis/commands/search/__init__.py
new file mode 100644
index 0000000000..8320ad4392
--- /dev/null
+++ b/redis/commands/search/__init__.py
@@ -0,0 +1,96 @@
+from .commands import SearchCommands
+
+
+class Search(SearchCommands):
+    """
+    Create a client for talking to search.
+    It abstracts the API of the module and lets you just use the engine.
+    """
+
+    class BatchIndexer(object):
+        """
+        A batch indexer allows you to automatically batch
+        document indexing in pipelines, flushing it every N documents.
+        """
+
+        def __init__(self, client, chunk_size=1000):
+
+            self.client = client
+            self.execute_command = client.execute_command
+            self.pipeline = client.pipeline(transaction=False, shard_hint=None)
+            self.total = 0
+            self.chunk_size = chunk_size
+            self.current_chunk = 0
+
+        def __del__(self):
+            if self.current_chunk:
+                self.commit()
+
+        def add_document(
+            self,
+            doc_id,
+            nosave=False,
+            score=1.0,
+            payload=None,
+            replace=False,
+            partial=False,
+            no_create=False,
+            **fields
+        ):
+            """
+            Add a document to the batch query
+            """
+            self.client._add_document(
+                doc_id,
+                conn=self.pipeline,
+                nosave=nosave,
+                score=score,
+                payload=payload,
+                replace=replace,
+                partial=partial,
+                no_create=no_create,
+                **fields
+            )
+            self.current_chunk += 1
+            self.total += 1
+            if self.current_chunk >= self.chunk_size:
+                self.commit()
+
+        def add_document_hash(
+            self,
+            doc_id,
+            score=1.0,
+            replace=False,
+        ):
+            """
+            Add a hash to the batch query
+            """
+            self.client._add_document_hash(
+                doc_id,
+                conn=self.pipeline,
+                score=score,
+                replace=replace,
+            )
+            self.current_chunk += 1
+            self.total += 1
+            if self.current_chunk >= self.chunk_size:
+                self.commit()
+
+        def commit(self):
+            """
+            Manually commit and flush the batch indexing query
+            """
+            self.pipeline.execute()
+            self.current_chunk = 0
+
+    def __init__(self, client, index_name="idx"):
+        """
+        Create a new Client for the given index_name.
+        The default name is `idx`
+
+        If conn is not None, we employ an already existing redis connection
+        """
+        self.client = client
+        self.index_name = index_name
+        self.execute_command = client.execute_command
+        self.pipeline = client.pipeline
diff --git a/redis/commands/search/_util.py b/redis/commands/search/_util.py
new file mode 100644
index 0000000000..b4ac19f336
--- /dev/null
+++ b/redis/commands/search/_util.py
@@ -0,0 +1,10 @@
+import six
+
+
+def to_string(s):
+    if isinstance(s, six.string_types):
+        return s
+    elif isinstance(s, six.binary_type):
+        return s.decode("utf-8", "ignore")
+    else:
+        return s  # Not a string we care about
diff --git a/redis/commands/search/aggregation.py b/redis/commands/search/aggregation.py
new file mode 100644
index 0000000000..df912f896b
--- /dev/null
+++ b/redis/commands/search/aggregation.py
@@ -0,0 +1,408 @@
+from six import string_types
+
+FIELDNAME = object()
+
+
+class Limit(object):
+    def __init__(self, offset=0, count=0):
+        self.offset = offset
+        self.count = count
+
+    def build_args(self):
+        if self.count:
+            return ["LIMIT", str(self.offset), str(self.count)]
+        else:
+            return []
+
+
+class Reducer(object):
+    """
+    Base reducer object for all reducers.
+
+    See the `redisearch.reducers` module for the actual reducers.
+    """
+
+    NAME = None
+
+    def __init__(self, *args):
+        self._args = args
+        self._field = None
+        self._alias = None
+
+    def alias(self, alias):
+        """
+        Set the alias for this reducer.
+
+        ### Parameters
+
+        - **alias**: The value of the alias for this reducer. If this is the
+            special value `aggregation.FIELDNAME` then this reducer will be
+            aliased using the same name as the field upon which it operates.
+            Note that using `FIELDNAME` is only possible on reducers which
+            operate on a single field value.
+
+        This method returns the `Reducer` object making it suitable for
+        chaining.
+        """
+        if alias is FIELDNAME:
+            if not self._field:
+                raise ValueError("Cannot use FIELDNAME alias with no field")
+            # Chop off initial '@'
+            alias = self._field[1:]
+        self._alias = alias
+        return self
+
+    @property
+    def args(self):
+        return self._args
+
+
+class SortDirection(object):
+    """
+    This special class is used to indicate sort direction.
+    """
+
+    DIRSTRING = None
+
+    def __init__(self, field):
+        self.field = field
+
+
+class Asc(SortDirection):
+    """
+    Indicate that the given field should be sorted in ascending order
+    """
+
+    DIRSTRING = "ASC"
+
+
+class Desc(SortDirection):
+    """
+    Indicate that the given field should be sorted in descending order
+    """
+
+    DIRSTRING = "DESC"
+
+
+class Group(object):
+    """
+    This object automatically created in the `AggregateRequest.group_by()`
+    """
+
+    def __init__(self, fields, reducers):
+        if not reducers:
+            raise ValueError("Need at least one reducer")
+
+        fields = [fields] if isinstance(fields, string_types) else fields
+        reducers = [reducers] if isinstance(reducers, Reducer) else reducers
+
+        self.fields = fields
+        self.reducers = reducers
+        self.limit = Limit()
+
+    def build_args(self):
+        ret = ["GROUPBY", str(len(self.fields))]
+        ret.extend(self.fields)
+        for reducer in self.reducers:
+            ret += ["REDUCE", reducer.NAME, str(len(reducer.args))]
+            ret.extend(reducer.args)
+            if reducer._alias is not None:
+                ret += ["AS", reducer._alias]
+        return ret
+
+
+class Projection(object):
+    """
+    This object automatically created in the `AggregateRequest.apply()`
+    """
+
+    def __init__(self, projector, alias=None):
+        self.alias = alias
+        self.projector = projector
+
+    def build_args(self):
+        ret = ["APPLY", self.projector]
+        if self.alias is not None:
+            ret += ["AS", self.alias]
+
+        return ret
+
+
+class SortBy(object):
+    """
+    This object automatically created in the `AggregateRequest.sort_by()`
+    """
+
+    def __init__(self, fields, max=0):
+        self.fields = fields
+        self.max = max
+
+    def build_args(self):
+        fields_args = []
+        for f in self.fields:
+            if isinstance(f, SortDirection):
+                fields_args += [f.field, f.DIRSTRING]
+            else:
+                fields_args += [f]
+
+        ret = ["SORTBY", str(len(fields_args))]
+        ret.extend(fields_args)
+        if self.max > 0:
+            ret += ["MAX", str(self.max)]
+
+        return ret
+
+
+class AggregateRequest(object):
+    """
+    Aggregation request which can be passed to `Client.aggregate`.
+    """
+
+    def __init__(self, query="*"):
+        """
+        Create an aggregation request. This request may then be passed to
+        `client.aggregate()`.
+
+        In order for the request to be usable, it must contain at least one
+        group.
+
+        - **query** Query string for filtering records.
+
+        All member methods (except `build_args()`)
+        return the object itself, making them useful for chaining.
+        """
+        self._query = query
+        self._aggregateplan = []
+        self._loadfields = []
+        self._limit = Limit()
+        self._max = 0
+        self._with_schema = False
+        self._verbatim = False
+        self._cursor = []
+
+    def load(self, *fields):
+        """
+        Indicate the fields to be returned in the response. These fields are
+        returned in addition to any others implicitly specified.
+
+        ### Parameters
+
+        - **fields**: One or more fields in the format of `@field`
+        """
+        self._loadfields.extend(fields)
+        return self
+
+    def group_by(self, fields, *reducers):
+        """
+        Specify by which fields to group the aggregation.
+
+        ### Parameters
+
+        - **fields**: Fields to group by. This can either be a single string,
+            or a list of strings. both cases, the field should be specified as
+            `@field`.
+        - **reducers**: One or more reducers. Reducers may be found in the
+            `aggregation` module.
+        """
+        group = Group(fields, reducers)
+        self._aggregateplan.extend(group.build_args())
+
+        return self
+
+    def apply(self, **kwexpr):
+        """
+        Specify one or more projection expressions to add to each result
+
+        ### Parameters
+
+        - **kwexpr**: One or more key-value pairs for a projection. The key is
+            the alias for the projection, and the value is the projection
+            expression itself, for example `apply(square_root="sqrt(@foo)")`
+        """
+        for alias, expr in kwexpr.items():
+            projection = Projection(expr, alias)
+            self._aggregateplan.extend(projection.build_args())
+
+        return self
+
+    def limit(self, offset, num):
+        """
+        Sets the limit for the most recent group or query.
+
+        If no group has been defined yet (via `group_by()`) then this sets
+        the limit for the initial pool of results from the query. Otherwise,
+        this limits the number of items operated on from the previous group.
+
+        Setting a limit on the initial search results may be useful when
+        attempting to execute an aggregation on a sample of a large data set.
+
+        ### Parameters
+
+        - **offset**: Result offset from which to begin paging
+        - **num**: Number of results to return
+
+
+        Example of sorting the initial results:
+
+        ```
+        AggregateRequest("@sale_amount:[10000, inf]")\
+            .limit(0, 10)\
+            .group_by("@state", r.count())
+        ```
+
+        Will only group by the states found in the first 10 results of the
+        query `@sale_amount:[10000, inf]`. On the other hand,
+
+        ```
+        AggregateRequest("@sale_amount:[10000, inf]")\
+            .limit(0, 1000)\
+            .group_by("@state", r.count()\
+            .limit(0, 10)
+        ```
+
+        Will group all the results matching the query, but only return the
+        first 10 groups.
+
+        If you only wish to return a *top-N* style query, consider using
+        `sort_by()` instead.
+
+        """
+        limit = Limit(offset, num)
+        self._limit = limit
+        return self
+
+    def sort_by(self, *fields, **kwargs):
+        """
+        Indicate how the results should be sorted. This can also be used for
+        *top-N* style queries
+
+        ### Parameters
+
+        - **fields**: The fields by which to sort. This can be either a single
+            field or a list of fields. If you wish to specify order, you can
+            use the `Asc` or `Desc` wrapper classes.
+        - **max**: Maximum number of results to return. This can be
+            used instead of `LIMIT` and is also faster.
+
+
+        Example of sorting by `foo` ascending and `bar` descending:
+
+        ```
+        sort_by(Asc("@foo"), Desc("@bar"))
+        ```
+
+        Return the top 10 customers:
+
+        ```
+        AggregateRequest()\
+            .group_by("@customer", r.sum("@paid").alias(FIELDNAME))\
+            .sort_by(Desc("@paid"), max=10)
+        ```
+        """
+        if isinstance(fields, (string_types, SortDirection)):
+            fields = [fields]
+
+        max = kwargs.get("max", 0)
+        sortby = SortBy(fields, max)
+
+        self._aggregateplan.extend(sortby.build_args())
+        return self
+
+    def filter(self, expressions):
+        """
+        Specify filter for post-query results using predicates relating to
+        values in the result set.
+
+        ### Parameters
+
+        - **fields**: Fields to group by. This can either be a single string,
+            or a list of strings.
+        """
+        if isinstance(expressions, string_types):
+            expressions = [expressions]
+
+        for expression in expressions:
+            self._aggregateplan.extend(["FILTER", expression])
+
+        return self
+
+    def with_schema(self):
+        """
+        If set, the `schema` property will contain a list of `[field, type]`
+        entries in the result object.
+        """
+        self._with_schema = True
+        return self
+
+    def verbatim(self):
+        self._verbatim = True
+        return self
+
+    def cursor(self, count=0, max_idle=0.0):
+        args = ["WITHCURSOR"]
+        if count:
+            args += ["COUNT", str(count)]
+        if max_idle:
+            args += ["MAXIDLE", str(max_idle * 1000)]
+        self._cursor = args
+        return self
+
+    def _limit_2_args(self, limit):
+        if limit[1]:
+            return ["LIMIT"] + [str(x) for x in limit]
+        else:
+            return []
+
+    def build_args(self):
+        # @foo:bar ...
+        ret = [self._query]
+
+        if self._with_schema:
+            ret.append("WITHSCHEMA")
+
+        if self._verbatim:
+            ret.append("VERBATIM")
+
+        if self._cursor:
+            ret += self._cursor
+
+        if self._loadfields:
+            ret.append("LOAD")
+            ret.append(str(len(self._loadfields)))
+            ret.extend(self._loadfields)
+
+        ret.extend(self._aggregateplan)
+
+        ret += self._limit.build_args()
+
+        return ret
+
+
+class Cursor(object):
+    def __init__(self, cid):
+        self.cid = cid
+        self.max_idle = 0
+        self.count = 0
+
+    def build_args(self):
+        args = [str(self.cid)]
+        if self.max_idle:
+            args += ["MAXIDLE", str(self.max_idle)]
+        if self.count:
+            args += ["COUNT", str(self.count)]
+        return args
+
+
+class AggregateResult(object):
+    def __init__(self, rows, cursor, schema):
+        self.rows = rows
+        self.cursor = cursor
+        self.schema = schema
+
+    def __repr__(self):
+        return "<{} at 0x{:x} Rows={}, Cursor={}>".format(
+            self.__class__.__name__,
+            id(self),
+            len(self.rows),
+            self.cursor.cid if self.cursor else -1,
+        )
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
new file mode 100644
index 0000000000..6074d2959b
--- /dev/null
+++ b/redis/commands/search/commands.py
@@ -0,0 +1,704 @@
+import itertools
+import time
+import six
+
+from .document import Document
+from .result import Result
+from .query import Query
+from ._util import to_string
+from .aggregation import AggregateRequest, AggregateResult, Cursor
+from .suggestion import SuggestionParser
+
+NUMERIC = "NUMERIC"
+
+CREATE_CMD = "FT.CREATE"
+ALTER_CMD = "FT.ALTER"
+SEARCH_CMD = "FT.SEARCH"
+ADD_CMD = "FT.ADD"
+ADDHASH_CMD = "FT.ADDHASH"
+DROP_CMD = "FT.DROP"
+EXPLAIN_CMD = "FT.EXPLAIN"
+DEL_CMD = "FT.DEL"
+AGGREGATE_CMD = "FT.AGGREGATE"
+CURSOR_CMD = "FT.CURSOR"
+SPELLCHECK_CMD = "FT.SPELLCHECK"
+DICT_ADD_CMD = "FT.DICTADD"
+DICT_DEL_CMD = "FT.DICTDEL"
+DICT_DUMP_CMD = "FT.DICTDUMP"
+GET_CMD = "FT.GET"
+MGET_CMD = "FT.MGET"
+CONFIG_CMD = "FT.CONFIG"
+TAGVALS_CMD = "FT.TAGVALS"
+ALIAS_ADD_CMD = "FT.ALIASADD"
+ALIAS_UPDATE_CMD = "FT.ALIASUPDATE"
+ALIAS_DEL_CMD = "FT.ALIASDEL"
+INFO_CMD = "FT.INFO"
+SUGADD_COMMAND = "FT.SUGADD"
+SUGDEL_COMMAND = "FT.SUGDEL"
+SUGLEN_COMMAND = "FT.SUGLEN"
+SUGGET_COMMAND = "FT.SUGGET"
+SYNUPDATE_CMD = "FT.SYNUPDATE"
+SYNDUMP_CMD = "FT.SYNDUMP"
+
+NOOFFSETS = "NOOFFSETS"
+NOFIELDS = "NOFIELDS"
+STOPWORDS = "STOPWORDS"
+WITHSCORES = "WITHSCORES"
+FUZZY = "FUZZY"
+WITHPAYLOADS = "WITHPAYLOADS"
+
+
+class SearchCommands:
+    """Search commands."""
+
+    def batch_indexer(self, chunk_size=100):
+        """
+        Create a new batch indexer from the client with a given chunk size
+        """
+        return self.BatchIndexer(self, chunk_size=chunk_size)
+
+    def create_index(
+        self,
+        fields,
+        no_term_offsets=False,
+        no_field_flags=False,
+        stopwords=None,
+        definition=None,
+    ):
+        """
+        Create the search index. The index must not already exist.
+
+        ### Parameters:
+
+        - **fields**: a list of TextField or NumericField objects
+        - **no_term_offsets**: If true, we will not save term offsets in
+        the index
+        - **no_field_flags**: If true, we will not save field flags that
+        allow searching in specific fields
+        - **stopwords**: If not None, we create the index with this custom
+        stopword list. The list can be empty
+        """
+
+        args = [CREATE_CMD, self.index_name]
+        if definition is not None:
+            args += definition.args
+        if no_term_offsets:
+            args.append(NOOFFSETS)
+        if no_field_flags:
+            args.append(NOFIELDS)
+        if stopwords is not None and isinstance(stopwords, (list, tuple, set)):
+            args += [STOPWORDS, len(stopwords)]
+            if len(stopwords) > 0:
+                args += list(stopwords)
+
+        args.append("SCHEMA")
+        try:
+            args += list(itertools.chain(*(f.redis_args() for f in fields)))
+        except TypeError:
+            args += fields.redis_args()
+
+        return self.execute_command(*args)
+
+    def alter_schema_add(self, fields):
+        """
+        Alter the existing search index by adding new fields. The index
+        must already exist.
+
+        ### Parameters:
+
+        - **fields**: a list of Field objects to add for the index
+        """
+
+        args = [ALTER_CMD, self.index_name, "SCHEMA", "ADD"]
+        try:
+            args += list(itertools.chain(*(f.redis_args() for f in fields)))
+        except TypeError:
+            args += fields.redis_args()
+
+        return self.execute_command(*args)
+
+    def drop_index(self, delete_documents=True):
+        """
+        Drop the index if it exists. Deprecated from RediSearch 2.0.
+
+        ### Parameters:
+
+        - **delete_documents**: If `True`, all documents will be deleted.
+        """
+        keep_str = "" if delete_documents else "KEEPDOCS"
+        return self.execute_command(DROP_CMD, self.index_name, keep_str)
+
+    def dropindex(self, delete_documents=False):
+        """
+        Drop the index if it exists.
+        Replaced `drop_index` in RediSearch 2.0.
+        Default behavior was changed to not delete the indexed documents.
+
+        ### Parameters:
+
+        - **delete_documents**: If `True`, all documents will be deleted.
+        """
+        keep_str = "" if delete_documents else "KEEPDOCS"
+        return self.execute_command(DROP_CMD, self.index_name, keep_str)
+
+    def _add_document(
+        self,
+        doc_id,
+        conn=None,
+        nosave=False,
+        score=1.0,
+        payload=None,
+        replace=False,
+        partial=False,
+        language=None,
+        no_create=False,
+        **fields
+    ):
+        """
+        Internal add_document used for both batch and single doc indexing
+        """
+        if conn is None:
+            conn = self.client
+
+        if partial or no_create:
+            replace = True
+
+        args = [ADD_CMD, self.index_name, doc_id, score]
+        if nosave:
+            args.append("NOSAVE")
+        if payload is not None:
+            args.append("PAYLOAD")
+            args.append(payload)
+        if replace:
+            args.append("REPLACE")
+            if partial:
+                args.append("PARTIAL")
+            if no_create:
+                args.append("NOCREATE")
+        if language:
+            args += ["LANGUAGE", language]
+        args.append("FIELDS")
+        args += list(itertools.chain(*fields.items()))
+        return conn.execute_command(*args)
+
+    def _add_document_hash(
+        self,
+        doc_id,
+        conn=None,
+        score=1.0,
+        language=None,
+        replace=False,
+    ):
+        """
+        Internal add_document_hash used for both batch and single doc indexing
+        """
+        if conn is None:
+            conn = self.client
+
+        args = [ADDHASH_CMD, self.index_name, doc_id, score]
+
+        if replace:
+            args.append("REPLACE")
+
+        if language:
+            args += ["LANGUAGE", language]
+
+        return conn.execute_command(*args)
+
+    def add_document(
+        self,
+        doc_id,
+        nosave=False,
+        score=1.0,
+        payload=None,
+        replace=False,
+        partial=False,
+        language=None,
+        no_create=False,
+        **fields
+    ):
+        """
+        Add a single document to the index.
+
+        ### Parameters
+
+        - **doc_id**: the id of the saved document.
+        - **nosave**: if set to true, we just index the document, and don't
+                      save a copy of it. This means that searches will just
+                      return ids.
+        - **score**: the document ranking, between 0.0 and 1.0
+        - **payload**: optional inner-index payload we can save for fast
+        i              access in scoring functions
+        - **replace**: if True, and the document already is in the index,
+        we perform an update and reindex the document
+        - **partial**: if True, the fields specified will be added to the
+                       existing document.
+                       This has the added benefit that any fields specified
+                       with `no_index`
+                       will not be reindexed again. Implies `replace`
+        - **language**: Specify the language used for document tokenization.
+        - **no_create**: if True, the document is only updated and reindexed
+                         if it already exists.
+                         If the document does not exist, an error will be
+                         returned. Implies `replace`
+        - **fields** kwargs dictionary of the document fields to be saved
+                         and/or indexed.
+                     NOTE: Geo points shoule be encoded as strings of "lon,lat"
+        """
+        return self._add_document(
+            doc_id,
+            conn=None,
+            nosave=nosave,
+            score=score,
+            payload=payload,
+            replace=replace,
+            partial=partial,
+            language=language,
+            no_create=no_create,
+            **fields
+        )
+
+    def add_document_hash(
+        self,
+        doc_id,
+        score=1.0,
+        language=None,
+        replace=False,
+    ):
+        """
+        Add a hash document to the index.
+
+        ### Parameters
+
+        - **doc_id**: the document's id. This has to be an existing HASH key
+                      in Redis that will hold the fields the index needs.
+        - **score**:  the document ranking, between 0.0 and 1.0
+        - **replace**: if True, and the document already is in the index, we
+                      perform an update and reindex the document
+        - **language**: Specify the language used for document tokenization.
+        """
+        return self._add_document_hash(
+            doc_id,
+            conn=None,
+            score=score,
+            language=language,
+            replace=replace,
+        )
+
+    def delete_document(self, doc_id, conn=None, delete_actual_document=False):
+        """
+        Delete a document from index
+        Returns 1 if the document was deleted, 0 if not
+
+        ### Parameters
+
+        - **delete_actual_document**: if set to True, RediSearch also delete
+                                      the actual document if it is in the index
+        """
+        args = [DEL_CMD, self.index_name, doc_id]
+        if conn is None:
+            conn = self.client
+        if delete_actual_document:
+            args.append("DD")
+
+        return conn.execute_command(*args)
+
+    def load_document(self, id):
+        """
+        Load a single document by id
+        """
+        fields = self.client.hgetall(id)
+        if six.PY3:
+            f2 = {to_string(k): to_string(v) for k, v in fields.items()}
+            fields = f2
+
+        try:
+            del fields["id"]
+        except KeyError:
+            pass
+
+        return Document(id=id, **fields)
+
+    def get(self, *ids):
+        """
+        Returns the full contents of multiple documents.
+
+        ### Parameters
+
+        - **ids**: the ids of the saved documents.
+        """
+
+        return self.client.execute_command(MGET_CMD, self.index_name, *ids)
+
+    def info(self):
+        """
+        Get info an stats about the the current index, including the number of
+        documents, memory consumption, etc
+        """
+
+        res = self.client.execute_command(INFO_CMD, self.index_name)
+        it = six.moves.map(to_string, res)
+        return dict(six.moves.zip(it, it))
+
+    def _mk_query_args(self, query):
+        args = [self.index_name]
+
+        if isinstance(query, six.string_types):
+            # convert the query from a text to a query object
+            query = Query(query)
+        if not isinstance(query, Query):
+            raise ValueError("Bad query type %s" % type(query))
+
+        args += query.get_args()
+        return args, query
+
+    def search(self, query):
+        """
+        Search the index for a given query, and return a result of documents
+
+        ### Parameters
+
+        - **query**: the search query. Either a text for simple queries with
+                     default parameters, or a Query object for complex queries.
+                     See RediSearch's documentation on query format
+        """
+        args, query = self._mk_query_args(query)
+        st = time.time()
+        res = self.execute_command(SEARCH_CMD, *args)
+
+        return Result(
+            res,
+            not query._no_content,
+            duration=(time.time() - st) * 1000.0,
+            has_payload=query._with_payloads,
+            with_scores=query._with_scores,
+        )
+
+    def explain(self, query):
+        args, query_text = self._mk_query_args(query)
+        return self.execute_command(EXPLAIN_CMD, *args)
+
+    def aggregate(self, query):
+        """
+        Issue an aggregation query
+
+        ### Parameters
+
+        **query**: This can be either an `AggeregateRequest`, or a `Cursor`
+
+        An `AggregateResult` object is returned. You can access the rows from
+        its `rows` property, which will always yield the rows of the result.
+        """
+        if isinstance(query, AggregateRequest):
+            has_cursor = bool(query._cursor)
+            cmd = [AGGREGATE_CMD, self.index_name] + query.build_args()
+        elif isinstance(query, Cursor):
+            has_cursor = True
+            cmd = [CURSOR_CMD, "READ", self.index_name] + query.build_args()
+        else:
+            raise ValueError("Bad query", query)
+
+        raw = self.execute_command(*cmd)
+        if has_cursor:
+            if isinstance(query, Cursor):
+                query.cid = raw[1]
+                cursor = query
+            else:
+                cursor = Cursor(raw[1])
+            raw = raw[0]
+        else:
+            cursor = None
+
+        if isinstance(query, AggregateRequest) and query._with_schema:
+            schema = raw[0]
+            rows = raw[2:]
+        else:
+            schema = None
+            rows = raw[1:]
+
+        res = AggregateResult(rows, cursor, schema)
+        return res
+
+    def spellcheck(self, query, distance=None, include=None, exclude=None):
+        """
+        Issue a spellcheck query
+
+        ### Parameters
+
+        **query**: search query.
+        **distance***: the maximal Levenshtein distance for spelling
+                       suggestions (default: 1, max: 4).
+        **include**: specifies an inclusion custom dictionary.
+        **exclude**: specifies an exclusion custom dictionary.
+        """
+        cmd = [SPELLCHECK_CMD, self.index_name, query]
+        if distance:
+            cmd.extend(["DISTANCE", distance])
+
+        if include:
+            cmd.extend(["TERMS", "INCLUDE", include])
+
+        if exclude:
+            cmd.extend(["TERMS", "EXCLUDE", exclude])
+
+        raw = self.execute_command(*cmd)
+
+        corrections = {}
+        if raw == 0:
+            return corrections
+
+        for _correction in raw:
+            if isinstance(_correction, six.integer_types) and _correction == 0:
+                continue
+
+            if len(_correction) != 3:
+                continue
+            if not _correction[2]:
+                continue
+            if not _correction[2][0]:
+                continue
+
+            # For spellcheck output
+            # 1)  1) "TERM"
+            #     2) "{term1}"
+            #     3)  1)  1)  "{score1}"
+            #             2)  "{suggestion1}"
+            #         2)  1)  "{score2}"
+            #             2)  "{suggestion2}"
+            #
+            # Following dictionary will be made
+            # corrections = {
+            #     '{term1}': [
+            #         {'score': '{score1}', 'suggestion': '{suggestion1}'},
+            #         {'score': '{score2}', 'suggestion': '{suggestion2}'}
+            #     ]
+            # }
+            corrections[_correction[1]] = [
+                {"score": _item[0], "suggestion": _item[1]}
+                for _item in _correction[2]
+            ]
+
+        return corrections
+
+    def dict_add(self, name, *terms):
+        """Adds terms to a dictionary.
+
+        ### Parameters
+
+        - **name**: Dictionary name.
+        - **terms**: List of items for adding to the dictionary.
+        """
+        cmd = [DICT_ADD_CMD, name]
+        cmd.extend(terms)
+        return self.execute_command(*cmd)
+
+    def dict_del(self, name, *terms):
+        """Deletes terms from a dictionary.
+
+        ### Parameters
+
+        - **name**: Dictionary name.
+        - **terms**: List of items for removing from the dictionary.
+        """
+        cmd = [DICT_DEL_CMD, name]
+        cmd.extend(terms)
+        return self.execute_command(*cmd)
+
+    def dict_dump(self, name):
+        """Dumps all terms in the given dictionary.
+
+        ### Parameters
+
+        - **name**: Dictionary name.
+        """
+        cmd = [DICT_DUMP_CMD, name]
+        return self.execute_command(*cmd)
+
+    def config_set(self, option, value):
+        """Set runtime configuration option.
+
+        ### Parameters
+
+        - **option**: the name of the configuration option.
+        - **value**: a value for the configuration option.
+        """
+        cmd = [CONFIG_CMD, "SET", option, value]
+        raw = self.execute_command(*cmd)
+        return raw == "OK"
+
+    def config_get(self, option):
+        """Get runtime configuration option value.
+
+        ### Parameters
+
+        - **option**: the name of the configuration option.
+        """
+        cmd = [CONFIG_CMD, "GET", option]
+        res = {}
+        raw = self.execute_command(*cmd)
+        if raw:
+            for kvs in raw:
+                res[kvs[0]] = kvs[1]
+        return res
+
+    def tagvals(self, tagfield):
+        """
+        Return a list of all possible tag values
+
+        ### Parameters
+
+        - **tagfield**: Tag field name
+        """
+
+        return self.execute_command(TAGVALS_CMD, self.index_name, tagfield)
+
+    def aliasadd(self, alias):
+        """
+        Alias a search index - will fail if alias already exists
+
+        ### Parameters
+
+        - **alias**: Name of the alias to create
+        """
+
+        return self.execute_command(ALIAS_ADD_CMD, alias, self.index_name)
+
+    def aliasupdate(self, alias):
+        """
+        Updates an alias - will fail if alias does not already exist
+
+        ### Parameters
+
+        - **alias**: Name of the alias to create
+        """
+
+        return self.execute_command(ALIAS_UPDATE_CMD, alias, self.index_name)
+
+    def aliasdel(self, alias):
+        """
+        Removes an alias to a search index
+
+        ### Parameters
+
+        - **alias**: Name of the alias to delete
+        """
+        return self.execute_command(ALIAS_DEL_CMD, alias)
+
+    def sugadd(self, key, *suggestions, **kwargs):
+        """
+        Add suggestion terms to the AutoCompleter engine. Each suggestion has
+        a score and string.
+        If kwargs["increment"] is true and the terms are already in the
+        server's dictionary, we increment their scores.
+        More information `here <https://oss.redis.com/redisearch/master/Commands/#ftsugadd>`_.  # noqa
+        """
+        # If Transaction is not False it will MULTI/EXEC which will error
+        pipe = self.pipeline(transaction=False)
+        for sug in suggestions:
+            args = [SUGADD_COMMAND, key, sug.string, sug.score]
+            if kwargs.get("increment"):
+                args.append("INCR")
+            if sug.payload:
+                args.append("PAYLOAD")
+                args.append(sug.payload)
+
+            pipe.execute_command(*args)
+
+        return pipe.execute()[-1]
+
+    def suglen(self, key):
+        """
+        Return the number of entries in the AutoCompleter index.
+        More information `here <https://oss.redis.com/redisearch/master/Commands/#ftsuglen>`_.  # noqa
+        """
+        return self.execute_command(SUGLEN_COMMAND, key)
+
+    def sugdel(self, key, string):
+        """
+        Delete a string from the AutoCompleter index.
+        Returns 1 if the string was found and deleted, 0 otherwise.
+        More information `here <https://oss.redis.com/redisearch/master/Commands/#ftsugdel>`_.  # noqa
+        """
+        return self.execute_command(SUGDEL_COMMAND, key, string)
+
+    def sugget(
+        self, key, prefix, fuzzy=False, num=10, with_scores=False,
+        with_payloads=False
+    ):
+        """
+        Get a list of suggestions from the AutoCompleter, for a given prefix.
+        More information `here <https://oss.redis.com/redisearch/master/Commands/#ftsugget>`_.  # noqa
+
+        Parameters:
+
+        prefix : str
+            The prefix we are searching. **Must be valid ascii or utf-8**
+        fuzzy : bool
+            If set to true, the prefix search is done in fuzzy mode.
+            **NOTE**: Running fuzzy searches on short (<3 letters) prefixes
+            can be very
+            slow, and even scan the entire index.
+        with_scores : bool
+            If set to true, we also return the (refactored) score of
+            each suggestion.
+            This is normally not needed, and is NOT the original score
+            inserted into the index.
+        with_payloads : bool
+            Return suggestion payloads
+        num : int
+            The maximum number of results we return. Note that we might
+            return less. The algorithm trims irrelevant suggestions.
+
+        Returns:
+
+        list:
+             A list of Suggestion objects. If with_scores was False, the
+             score of all suggestions is 1.
+        """
+        args = [SUGGET_COMMAND, key, prefix, "MAX", num]
+        if fuzzy:
+            args.append(FUZZY)
+        if with_scores:
+            args.append(WITHSCORES)
+        if with_payloads:
+            args.append(WITHPAYLOADS)
+
+        ret = self.execute_command(*args)
+        results = []
+        if not ret:
+            return results
+
+        parser = SuggestionParser(with_scores, with_payloads, ret)
+        return [s for s in parser]
+
+    def synupdate(self, groupid, skipinitial=False, *terms):
+        """
+        Updates a synonym group.
+        The command is used to create or update a synonym group with
+        additional terms.
+        Only documents which were indexed after the update will be affected.
+
+        Parameters:
+
+        groupid :
+            Synonym group id.
+        skipinitial : bool
+            If set to true, we do not scan and index.
+        terms :
+            The terms.
+        """
+        cmd = [SYNUPDATE_CMD, self.index_name, groupid]
+        if skipinitial:
+            cmd.extend(["SKIPINITIALSCAN"])
+        cmd.extend(terms)
+        return self.execute_command(*cmd)
+
+    def syndump(self):
+        """
+        Dumps the contents of a synonym group.
+
+        The command is used to dump the synonyms data structure.
+        Returns a list of synonym terms and their synonym group ids.
+        """
+        raw = self.execute_command(SYNDUMP_CMD, self.index_name)
+        return {raw[i]: raw[i + 1] for i in range(0, len(raw), 2)}
diff --git a/redis/commands/search/document.py b/redis/commands/search/document.py
new file mode 100644
index 0000000000..26ede34ef1
--- /dev/null
+++ b/redis/commands/search/document.py
@@ -0,0 +1,16 @@
+import six
+
+
+class Document(object):
+    """
+    Represents a single document in a result set
+    """
+
+    def __init__(self, id, payload=None, **fields):
+        self.id = id
+        self.payload = payload
+        for k, v in six.iteritems(fields):
+            setattr(self, k, v)
+
+    def __repr__(self):
+        return "Document %s" % self.__dict__
diff --git a/redis/commands/search/field.py b/redis/commands/search/field.py
new file mode 100644
index 0000000000..45114a42b7
--- /dev/null
+++ b/redis/commands/search/field.py
@@ -0,0 +1,94 @@
+class Field(object):
+
+    NUMERIC = "NUMERIC"
+    TEXT = "TEXT"
+    WEIGHT = "WEIGHT"
+    GEO = "GEO"
+    TAG = "TAG"
+    SORTABLE = "SORTABLE"
+    NOINDEX = "NOINDEX"
+    AS = "AS"
+
+    def __init__(self, name, args=[], sortable=False,
+                 no_index=False, as_name=None):
+        self.name = name
+        self.args = args
+        self.args_suffix = list()
+        self.as_name = as_name
+
+        if sortable:
+            self.args_suffix.append(Field.SORTABLE)
+        if no_index:
+            self.args_suffix.append(Field.NOINDEX)
+
+        if no_index and not sortable:
+            raise ValueError("Non-Sortable non-Indexable fields are ignored")
+
+    def append_arg(self, value):
+        self.args.append(value)
+
+    def redis_args(self):
+        args = [self.name]
+        if self.as_name:
+            args += [self.AS, self.as_name]
+        args += self.args
+        args += self.args_suffix
+        return args
+
+
+class TextField(Field):
+    """
+    TextField is used to define a text field in a schema definition
+    """
+
+    NOSTEM = "NOSTEM"
+    PHONETIC = "PHONETIC"
+
+    def __init__(
+        self, name, weight=1.0, no_stem=False, phonetic_matcher=None, **kwargs
+    ):
+        Field.__init__(self, name,
+                       args=[Field.TEXT, Field.WEIGHT, weight], **kwargs)
+
+        if no_stem:
+            Field.append_arg(self, self.NOSTEM)
+        if phonetic_matcher and phonetic_matcher in [
+            "dm:en",
+            "dm:fr",
+            "dm:pt",
+            "dm:es",
+        ]:
+            Field.append_arg(self, self.PHONETIC)
+            Field.append_arg(self, phonetic_matcher)
+
+
+class NumericField(Field):
+    """
+    NumericField is used to define a numeric field in a schema definition
+    """
+
+    def __init__(self, name, **kwargs):
+        Field.__init__(self, name, args=[Field.NUMERIC], **kwargs)
+
+
+class GeoField(Field):
+    """
+    GeoField is used to define a geo-indexing field in a schema definition
+    """
+
+    def __init__(self, name, **kwargs):
+        Field.__init__(self, name, args=[Field.GEO], **kwargs)
+
+
+class TagField(Field):
+    """
+    TagField is a tag-indexing field with simpler compression and tokenization.
+    See http://redisearch.io/Tags/
+    """
+
+    SEPARATOR = "SEPARATOR"
+
+    def __init__(self, name, separator=",", **kwargs):
+        Field.__init__(
+            self, name, args=[Field.TAG, self.SEPARATOR, separator], **kwargs
+        )
diff --git a/redis/commands/search/indexDefinition.py b/redis/commands/search/indexDefinition.py
new file mode 100644
index 0000000000..4fbc6095c5
--- /dev/null
+++ b/redis/commands/search/indexDefinition.py
@@ -0,0 +1,80 @@
+from enum import Enum
+
+
+class IndexType(Enum):
+    """Enum of the currently supported index types."""
+
+    HASH = 1
+    JSON = 2
+
+
+class IndexDefinition(object):
+    """IndexDefinition is used to define a index definition for automatic
+    indexing on Hash or Json update."""
+
+    def __init__(
+        self,
+        prefix=[],
+        filter=None,
+        language_field=None,
+        language=None,
+        score_field=None,
+        score=1.0,
+        payload_field=None,
+        index_type=None,
+    ):
+        self.args = []
+        self._appendIndexType(index_type)
+        self._appendPrefix(prefix)
+        self._appendFilter(filter)
+        self._appendLanguage(language_field, language)
+        self._appendScore(score_field, score)
+        self._appendPayload(payload_field)
+
+    def _appendIndexType(self, index_type):
+        """Append `ON HASH` or `ON JSON` according to the enum."""
+        if index_type is IndexType.HASH:
+            self.args.extend(["ON", "HASH"])
+        elif index_type is IndexType.JSON:
+            self.args.extend(["ON", "JSON"])
+        elif index_type is not None:
+            raise RuntimeError("index_type must be one of {}".
+                               format(list(IndexType)))
+
+    def _appendPrefix(self, prefix):
+        """Append PREFIX."""
+        if len(prefix) > 0:
+            self.args.append("PREFIX")
+            self.args.append(len(prefix))
+            for p in prefix:
+                self.args.append(p)
+
+    def _appendFilter(self, filter):
+        """Append FILTER."""
+        if filter is not None:
+            self.args.append("FILTER")
+            self.args.append(filter)
+
+    def _appendLanguage(self, language_field, language):
+        """Append LANGUAGE_FIELD and LANGUAGE."""
+        if language_field is not None:
+            self.args.append("LANGUAGE_FIELD")
+            self.args.append(language_field)
+        if language is not None:
+            self.args.append("LANGUAGE")
+            self.args.append(language)
+
+    def _appendScore(self, score_field, score):
+        """Append SCORE_FIELD and SCORE."""
+        if score_field is not None:
+            self.args.append("SCORE_FIELD")
+            self.args.append(score_field)
+        if score is not None:
+            self.args.append("SCORE")
+            self.args.append(score)
+
+    def _appendPayload(self, payload_field):
+        """Append PAYLOAD_FIELD."""
+        if payload_field is not None:
+            self.args.append("PAYLOAD_FIELD")
+            self.args.append(payload_field)
diff --git a/redis/commands/search/query.py b/redis/commands/search/query.py
new file mode 100644
index 0000000000..e2db7a422b
--- /dev/null
+++ b/redis/commands/search/query.py
@@ -0,0 +1,328 @@
+import six
+
+
+class Query(object):
+    """
+    Query is used to build complex queries that have more parameters than just
+    the query string. The query string is set in the constructor, and other
+    options have setter functions.
+
+    The setter functions return the query object, so they can be chained,
+    i.e. `Query("foo").verbatim().filter(...)` etc.
+    """
+
+    def __init__(self, query_string):
+        """
+        Create a new query object.
+        The query string is set in the constructor, and other options have
+        setter functions.
+        """
+
+        self._query_string = query_string
+        self._offset = 0
+        self._num = 10
+        self._no_content = False
+        self._no_stopwords = False
+        self._fields = None
+        self._verbatim = False
+        self._with_payloads = False
+        self._with_scores = False
+        self._scorer = False
+        self._filters = list()
+        self._ids = None
+        self._slop = -1
+        self._in_order = False
+        self._sortby = None
+        self._return_fields = []
+        self._summarize_fields = []
+        self._highlight_fields = []
+        self._language = None
+        self._expander = None
+
+    def query_string(self):
+        """Return the query string of this query only."""
+        return self._query_string
+
+    def limit_ids(self, *ids):
+        """Limit the results to a specific set of pre-known document
+        ids of any length."""
+        self._ids = ids
+        return self
+
+    def return_fields(self, *fields):
+        """Add fields to return fields."""
+        self._return_fields += fields
+        return self
+
+    def return_field(self, field, as_field=None):
+        """Add field to return fields (Optional: add 'AS' name
+        to the field)."""
+        self._return_fields.append(field)
+        if as_field is not None:
+            self._return_fields += ("AS", as_field)
+        return self
+
+    def _mk_field_list(self, fields):
+        if not fields:
+            return []
+        return  \
+            [fields] if isinstance(fields, six.string_types) else list(fields)
+
+    def summarize(self, fields=None, context_len=None,
+                  num_frags=None, sep=None):
+        """
+        Return an abridged format of the field, containing only the segments of
+        the field which contain the matching term(s).
+
+        If `fields` is specified, then only the mentioned fields are
+        summarized; otherwise all results are summarized.
+
+        Server side defaults are used for each option (except `fields`)
+        if not specified
+
+        - **fields** List of fields to summarize. All fields are summarized
+        if not specified
+        - **context_len** Amount of context to include with each fragment
+        - **num_frags** Number of fragments per document
+        - **sep** Separator string to separate fragments
+        """
+        args = ["SUMMARIZE"]
+        fields = self._mk_field_list(fields)
+        if fields:
+            args += ["FIELDS", str(len(fields))] + fields
+
+        if context_len is not None:
+            args += ["LEN", str(context_len)]
+        if num_frags is not None:
+            args += ["FRAGS", str(num_frags)]
+        if sep is not None:
+            args += ["SEPARATOR", sep]
+
+        self._summarize_fields = args
+        return self
+
+    def highlight(self, fields=None, tags=None):
+        """
+        Apply specified markup to matched term(s) within the returned field(s).
+
+        - **fields** If specified then only those mentioned fields are
+        highlighted, otherwise all fields are highlighted
+        - **tags** A list of two strings to surround the match.
+        """
+        args = ["HIGHLIGHT"]
+        fields = self._mk_field_list(fields)
+        if fields:
+            args += ["FIELDS", str(len(fields))] + fields
+        if tags:
+            args += ["TAGS"] + list(tags)
+
+        self._highlight_fields = args
+        return self
+
+    def language(self, language):
+        """
+        Analyze the query as being in the specified language.
+
+        :param language: The language (e.g. `chinese` or `english`)
+        """
+        self._language = language
+        return self
+
+    def slop(self, slop):
+        """Allow a maximum of N intervening non matched terms between
+        phrase terms (0 means exact phrase).
+        """
+        self._slop = slop
+        return self
+
+    def in_order(self):
+        """
+        Match only documents where the query terms appear in
+        the same order in the document.
+        i.e. for the query "hello world", we do not match "world hello"
+        """
+        self._in_order = True
+        return self
+
+    def scorer(self, scorer):
+        """
+        Use a different scoring function to evaluate document relevance.
+        Default is `TFIDF`.
+
+        :param scorer: The scoring function to use
+                       (e.g. `TFIDF.DOCNORM` or `BM25`)
+        """
+        self._scorer = scorer
+        return self
+
+    def get_args(self):
+        """Format the redis arguments for this query and return them."""
+        args = [self._query_string]
+        args += self._get_args_tags()
+        args += self._summarize_fields + self._highlight_fields
+        args += ["LIMIT", self._offset, self._num]
+        return args
+
+    def _get_args_tags(self):
+        args = []
+        if self._no_content:
+            args.append("NOCONTENT")
+        if self._fields:
+            args.append("INFIELDS")
+            args.append(len(self._fields))
+            args += self._fields
+        if self._verbatim:
+            args.append("VERBATIM")
+        if self._no_stopwords:
+            args.append("NOSTOPWORDS")
+        if self._filters:
+            for flt in self._filters:
+                if not isinstance(flt, Filter):
+                    raise AttributeError("Did not receive a Filter object.")
+                args += flt.args
+        if self._with_payloads:
+            args.append("WITHPAYLOADS")
+        if self._scorer:
+            args += ["SCORER", self._scorer]
+        if self._with_scores:
+            args.append("WITHSCORES")
+        if self._ids:
+            args.append("INKEYS")
+            args.append(len(self._ids))
+            args += self._ids
+        if self._slop >= 0:
+            args += ["SLOP", self._slop]
+        if self._in_order:
+            args.append("INORDER")
+        if self._return_fields:
+            args.append("RETURN")
+            args.append(len(self._return_fields))
+            args += self._return_fields
+        if self._sortby:
+            if not isinstance(self._sortby, SortbyField):
+                raise AttributeError("Did not receive a SortByField.")
+            args.append("SORTBY")
+            args += self._sortby.args
+        if self._language:
+            args += ["LANGUAGE", self._language]
+        if self._expander:
+            args += ["EXPANDER", self._expander]
+
+        return args
+
+    def paging(self, offset, num):
+        """
+        Set the paging for the query (defaults to 0..10).
+
+        - **offset**: Paging offset for the results. Defaults to 0
+        - **num**: How many results do we want
+        """
+        self._offset = offset
+        self._num = num
+        return self
+
+    def verbatim(self):
+        """Set the query to be verbatim, i.e. use no query expansion
+        or stemming.
+        """
+        self._verbatim = True
+        return self
+
+    def no_content(self):
+        """Set the query to only return ids and not the document content."""
+        self._no_content = True
+        return self
+
+    def no_stopwords(self):
+        """
+        Prevent the query from being filtered for stopwords.
+        Only useful in very big queries that you are certain contain
+        no stopwords.
+        """
+        self._no_stopwords = True
+        return self
+
+    def with_payloads(self):
+        """Ask the engine to return document payloads."""
+        self._with_payloads = True
+        return self
+
+    def with_scores(self):
+        """Ask the engine to return document search scores."""
+        self._with_scores = True
+        return self
+
+    def limit_fields(self, *fields):
+        """
+        Limit the search to specific TEXT fields only.
+
+        - **fields**: A list of strings, case sensitive field names
+        from the defined schema.
+        """
+        self._fields = fields
+        return self
+
+    def add_filter(self, flt):
+        """
+        Add a numeric or geo filter to the query.
+        **Currently only one of each filter is supported by the engine**
+
+        - **flt**: A NumericFilter or GeoFilter object, used on a
+        corresponding field
+        """
+
+        self._filters.append(flt)
+        return self
+
+    def sort_by(self, field, asc=True):
+        """
+        Add a sortby field to the query.
+
+        - **field** - the name of the field to sort by
+        - **asc** - when `True`, sorting will be done in asceding order
+        """
+        self._sortby = SortbyField(field, asc)
+        return self
+
+    def expander(self, expander):
+        """
+        Add a expander field to the query.
+
+        - **expander** - the name of the expander
+        """
+        self._expander = expander
+        return self
+
+
+class Filter(object):
+    def __init__(self, keyword, field, *args):
+        self.args = [keyword, field] + list(args)
+
+
+class NumericFilter(Filter):
+    INF = "+inf"
+    NEG_INF = "-inf"
+
+    def __init__(self, field, minval, maxval, minExclusive=False,
+                 maxExclusive=False):
+        args = [
+            minval if not minExclusive else "({}".format(minval),
+            maxval if not maxExclusive else "({}".format(maxval),
+        ]
+
+        Filter.__init__(self, "FILTER", field, *args)
+
+
+class GeoFilter(Filter):
+    METERS = "m"
+    KILOMETERS = "km"
+    FEET = "ft"
+    MILES = "mi"
+
+    def __init__(self, field, lon, lat, radius, unit=KILOMETERS):
+        Filter.__init__(self, "GEOFILTER", field, lon, lat, radius, unit)
+
+
+class SortbyField(object):
+    def __init__(self, field, asc=True):
+        self.args = [field, "ASC" if asc else "DESC"]
diff --git a/redis/commands/search/querystring.py b/redis/commands/search/querystring.py
new file mode 100644
index 0000000000..f5f59b7e53
--- /dev/null
+++ b/redis/commands/search/querystring.py
@@ -0,0 +1,324 @@
+from six import string_types, integer_types
+
+
+def tags(*t):
+    """
+    Indicate that the values should be matched to a tag field
+
+    ### Parameters
+
+    - **t**: Tags to search for
+    """
+    if not t:
+        raise ValueError("At least one tag must be specified")
+    return TagValue(*t)
+
+
+def between(a, b, inclusive_min=True, inclusive_max=True):
+    """
+    Indicate that value is a numeric range
+    """
+    return RangeValue(a, b, inclusive_min=inclusive_min,
+                      inclusive_max=inclusive_max)
+
+
+def equal(n):
+    """
+    Match a numeric value
+    """
+    return between(n, n)
+
+
+def lt(n):
+    """
+    Match any value less than n
+    """
+    return between(None, n, inclusive_max=False)
+
+
+def le(n):
+    """
+    Match any value less or equal to n
+    """
+    return between(None, n, inclusive_max=True)
+
+
+def gt(n):
+    """
+    Match any value greater than n
+    """
+    return between(n, None, inclusive_min=False)
+
+
+def ge(n):
+    """
+    Match any value greater or equal to n
+    """
+    return between(n, None, inclusive_min=True)
+
+
+def geo(lat, lon, radius, unit="km"):
+    """
+    Indicate that value is a geo region
+    """
+    return GeoValue(lat, lon, radius, unit)
+
+
+class Value(object):
+    @property
+    def combinable(self):
+        """
+        Whether this type of value may be combined with other values
+        for the same field. This makes the filter potentially more efficient
+        """
+        return False
+
+    @staticmethod
+    def make_value(v):
+        """
+        Convert an object to a value, if it is not a value already
+        """
+        if isinstance(v, Value):
+            return v
+        return ScalarValue(v)
+
+    def to_string(self):
+        raise NotImplementedError()
+
+    def __str__(self):
+        return self.to_string()
+
+
+class RangeValue(Value):
+    combinable = False
+
+    def __init__(self, a, b, inclusive_min=False, inclusive_max=False):
+        if a is None:
+            a = "-inf"
+        if b is None:
+            b = "inf"
+        self.range = [str(a), str(b)]
+        self.inclusive_min = inclusive_min
+        self.inclusive_max = inclusive_max
+
+    def to_string(self):
+        return "[{1}{0[0]} {2}{0[1]}]".format(
+            self.range,
+            "(" if not self.inclusive_min else "",
+            "(" if not self.inclusive_max else "",
+        )
+
+
+class ScalarValue(Value):
+    combinable = True
+
+    def __init__(self, v):
+        self.v = str(v)
+
+    def to_string(self):
+        return self.v
+
+
+class TagValue(Value):
+    combinable = False
+
+    def __init__(self, *tags):
+        self.tags = tags
+
+    def to_string(self):
+        return "{" + " | ".join(str(t) for t in self.tags) + "}"
+
+
+class GeoValue(Value):
+    def __init__(self, lon, lat, radius, unit="km"):
+        self.lon = lon
+        self.lat = lat
+        self.radius = radius
+        self.unit = unit
+
+
+class Node(object):
+    def __init__(self, *children, **kwparams):
+        """
+        Create a node
+
+        ### Parameters
+
+        - **children**: One or more sub-conditions. These can be additional
+            `intersect`, `disjunct`, `union`, `optional`, or any other `Node`
+            type.
+
+            The semantics of multiple conditions are dependent on the type of
+            query. For an `intersection` node, this amounts to a logical AND,
+            for a `union` node, this amounts to a logical `OR`.
+
+        - **kwparams**: key-value parameters. Each key is the name of a field,
+            and the value should be a field value. This can be one of the
+            following:
+
+            - Simple string (for text field matches)
+            - value returned by one of the helper functions
+            - list of either a string or a value
+
+
+        ### Examples
+
+        Field `num` should be between 1 and 10
+        ```
+        intersect(num=between(1, 10)
+        ```
+
+        Name can either be `bob` or `john`
+
+        ```
+        union(name=("bob", "john"))
+        ```
+
+        Don't select countries in Israel, Japan, or US
+
+        ```
+        disjunct_union(country=("il", "jp", "us"))
+        ```
+        """
+
+        self.params = []
+
+        kvparams = {}
+        for k, v in kwparams.items():
+            curvals = kvparams.setdefault(k, [])
+            if isinstance(v, (string_types, integer_types, float)):
+                curvals.append(Value.make_value(v))
+            elif isinstance(v, Value):
+                curvals.append(v)
+            else:
+                curvals.extend(Value.make_value(subv) for subv in v)
+
+        self.params += [Node.to_node(p) for p in children]
+
+        for k, v in kvparams.items():
+            self.params.extend(self.join_fields(k, v))
+
+    def join_fields(self, key, vals):
+        if len(vals) == 1:
+            return [BaseNode("@{}:{}".format(key, vals[0].to_string()))]
+        if not vals[0].combinable:
+            return [BaseNode("@{}:{}".format(key,
+                                             v.to_string())) for v in vals]
+        s = BaseNode(
+            "@{}:({})".format(key,
+                              self.JOINSTR.join(v.to_string() for v in vals))
+        )
+        return [s]
+
+    @classmethod
+    def to_node(cls, obj):  # noqa
+        if isinstance(obj, Node):
+            return obj
+        return BaseNode(obj)
+
+    @property
+    def JOINSTR(self):
+        raise NotImplementedError()
+
+    def to_string(self, with_parens=None):
+        with_parens = self._should_use_paren(with_parens)
+        pre, post = ("(", ")") if with_parens else ("", "")
+        return "{}{}{}".format(
+            pre, self.JOINSTR.join(n.to_string() for n in self.params), post
+        )
+
+    def _should_use_paren(self, optval):
+        if optval is not None:
+            return optval
+        return len(self.params) > 1
+
+    def __str__(self):
+        return self.to_string()
+
+
+class BaseNode(Node):
+    def __init__(self, s):
+        super(BaseNode, self).__init__()
+        self.s = str(s)
+
+    def to_string(self, with_parens=None):
+        return self.s
+
+
+class IntersectNode(Node):
+    """
+    Create an intersection node. All children need to be satisfied in order for
+    this node to evaluate as true
+    """
+
+    JOINSTR = " "
+
+
+class UnionNode(Node):
+    """
+    Create a union node. Any of the children need to be satisfied in order for
+    this node to evaluate as true
+    """
+
+    JOINSTR = "|"
+
+
+class DisjunctNode(IntersectNode):
+    """
+    Create a disjunct node. In order for this node to be true, all of its
+    children must evaluate to false
+    """
+
+    def to_string(self, with_parens=None):
+        with_parens = self._should_use_paren(with_parens)
+        ret = super(DisjunctNode, self).to_string(with_parens=False)
+        if with_parens:
+            return "(-" + ret + ")"
+        else:
+            return "-" + ret
+
+
+class DistjunctUnion(DisjunctNode):
+    """
+    This node is true if *all* of its children are false. This is equivalent to
+    ```
+    disjunct(union(...))
+    ```
+    """
+
+    JOINSTR = "|"
+
+
+class OptionalNode(IntersectNode):
+    """
+    Create an optional node. If this nodes evaluates to true, then the document
+    will be rated higher in score/rank.
+    """
+
+    def to_string(self, with_parens=None):
+        with_parens = self._should_use_paren(with_parens)
+        ret = super(OptionalNode, self).to_string(with_parens=False)
+        if with_parens:
+            return "(~" + ret + ")"
+        else:
+            return "~" + ret
+
+
+def intersect(*args, **kwargs):
+    return IntersectNode(*args, **kwargs)
+
+
+def union(*args, **kwargs):
+    return UnionNode(*args, **kwargs)
+
+
+def disjunct(*args, **kwargs):
+    return DisjunctNode(*args, **kwargs)
+
+
+def disjunct_union(*args, **kwargs):
+    return DistjunctUnion(*args, **kwargs)
+
+
+def querystring(*args, **kwargs):
+    return intersect(*args, **kwargs).to_string()
diff --git a/redis/commands/search/reducers.py b/redis/commands/search/reducers.py
new file mode 100644
index 0000000000..6cbbf2f355
--- /dev/null
+++ b/redis/commands/search/reducers.py
@@ -0,0 +1,178 @@
+from .aggregation import Reducer, SortDirection
+
+
+class FieldOnlyReducer(Reducer):
+    def __init__(self, field):
+        super(FieldOnlyReducer, self).__init__(field)
+        self._field = field
+
+
+class count(Reducer):
+    """
+    Counts the number of results in the group
+    """
+
+    NAME = "COUNT"
+
+    def __init__(self):
+        super(count, self).__init__()
+
+
+class sum(FieldOnlyReducer):
+    """
+    Calculates the sum of all the values in the given fields within the group
+    """
+
+    NAME = "SUM"
+
+    def __init__(self, field):
+        super(sum, self).__init__(field)
+
+
+class min(FieldOnlyReducer):
+    """
+    Calculates the smallest value in the given field within the group
+    """
+
+    NAME = "MIN"
+
+    def __init__(self, field):
+        super(min, self).__init__(field)
+
+
+class max(FieldOnlyReducer):
+    """
+    Calculates the largest value in the given field within the group
+    """
+
+    NAME = "MAX"
+
+    def __init__(self, field):
+        super(max, self).__init__(field)
+
+
+class avg(FieldOnlyReducer):
+    """
+    Calculates the mean value in the given field within the group
+    """
+
+    NAME = "AVG"
+
+    def __init__(self, field):
+        super(avg, self).__init__(field)
+
+
+class tolist(FieldOnlyReducer):
+    """
+    Returns all the matched properties in a list
+    """
+
+    NAME = "TOLIST"
+
+    def __init__(self, field):
+        super(tolist, self).__init__(field)
+
+
+class count_distinct(FieldOnlyReducer):
+    """
+    Calculate the number of distinct values contained in all the results in
+    the group for the given field
+    """
+
+    NAME = "COUNT_DISTINCT"
+
+    def __init__(self, field):
+        super(count_distinct, self).__init__(field)
+
+
+class count_distinctish(FieldOnlyReducer):
+    """
+    Calculate the number of distinct values contained in all the results in the
+    group for the given field. This uses a faster algorithm than
+    `count_distinct` but is less accurate
+    """
+
+    NAME = "COUNT_DISTINCTISH"
+
+
+class quantile(Reducer):
+    """
+    Return the value for the nth percentile within the range of values for the
+    field within the group.
+    """
+
+    NAME = "QUANTILE"
+
+    def __init__(self, field, pct):
+        super(quantile, self).__init__(field, str(pct))
+        self._field = field
+
+
+class stddev(FieldOnlyReducer):
+    """
+    Return the standard deviation for the values within the group
+    """
+
+    NAME = "STDDEV"
+
+    def __init__(self, field):
+        super(stddev, self).__init__(field)
+
+
+class first_value(Reducer):
+    """
+    Selects the first value within the group according to sorting parameters
+    """
+
+    NAME = "FIRST_VALUE"
+
+    def __init__(self, field, *byfields):
+        """
+        Selects the first value of the given field within the group.
+
+        ### Parameter
+
+        - **field**: Source field used for the value
+        - **byfields**: How to sort the results. This can be either the
+            *class* of `aggregation.Asc` or `aggregation.Desc` in which
+            case the field `field` is also used as the sort input.
+
+            `byfields` can also be one or more *instances* of `Asc` or `Desc`
+            indicating the sort order for these fields
+        """
+
+        fieldstrs = []
+        if (
+            len(byfields) == 1
+            and isinstance(byfields[0], type)
+            and issubclass(byfields[0], SortDirection)
+        ):
+            byfields = [byfields[0](field)]
+
+        for f in byfields:
+            fieldstrs += [f.field, f.DIRSTRING]
+
+        args = [field]
+        if fieldstrs:
+            args += ["BY"] + fieldstrs
+        super(first_value, self).__init__(*args)
+        self._field = field
+
+
+class random_sample(Reducer):
+    """
+    Returns a random sample of items from the dataset, from the given property
+    """
+
+    NAME = "RANDOM_SAMPLE"
+
+    def __init__(self, field, size):
+        """
+        ### Parameter
+
+        **field**: Field to sample from
+        **size**: Return this many items (can be less)
+        """
+        args = [field, str(size)]
+        super(random_sample, self).__init__(*args)
+        self._field = field
diff --git a/redis/commands/search/result.py b/redis/commands/search/result.py
new file mode 100644
index 0000000000..afc83f87cd
--- /dev/null
+++ b/redis/commands/search/result.py
@@ -0,0 +1,75 @@
+from six.moves import xrange, zip as izip
+
+from .document import Document
+from ._util import to_string
+
+
+class Result(object):
+    """
+    Represents the result of a search query, and has an array of Document
+    objects
+    """
+
+    def __init__(
+        self, res, hascontent, duration=0, has_payload=False, with_scores=False
+    ):
+        """
+        - **snippets**: An optional dictionary of the form
+        {field: snippet_size} for snippet formatting
+        """
+
+        self.total = res[0]
+        self.duration = duration
+        self.docs = []
+
+        step = 1
+        if hascontent:
+            step = step + 1
+        if has_payload:
+            step = step + 1
+        if with_scores:
+            step = step + 1
+
+        offset = 2 if with_scores else 1
+
+        for i in xrange(1, len(res), step):
+            id = to_string(res[i])
+            payload = to_string(res[i + offset]) if has_payload else None
+            # fields_offset = 2 if has_payload else 1
+            fields_offset = offset + 1 if has_payload else offset
+            score = float(res[i + 1]) if with_scores else None
+
+            fields = {}
+            if hascontent:
+                fields = (
+                    dict(
+                        dict(
+                            izip(
+                                map(to_string, res[i + fields_offset][::2]),
+                                map(to_string, res[i + fields_offset][1::2]),
+                            )
+                        )
+                    )
+                    if hascontent
+                    else {}
+                )
+            try:
+                del fields["id"]
+            except KeyError:
+                pass
+
+            try:
+                fields["json"] = fields["$"]
+                del fields["$"]
+            except KeyError:
+                pass
+
+            doc = (
+                Document(id, score=score, payload=payload, **fields)
+                if with_scores
+                else Document(id, payload=payload, **fields)
+            )
+            self.docs.append(doc)
+
+    def __repr__(self):
+        return "Result{%d total, docs: %s}" % (self.total, self.docs)
diff --git a/redis/commands/search/suggestion.py b/redis/commands/search/suggestion.py
new file mode 100644
index 0000000000..550c514823
--- /dev/null
+++ b/redis/commands/search/suggestion.py
@@ -0,0 +1,54 @@
+from six.moves import xrange
+from ._util import to_string
+
+
+class Suggestion(object):
+    """
+    Represents a single suggestion being sent or returned from the
+    autocomplete server
+    """
+
+    def __init__(self, string, score=1.0, payload=None):
+        self.string = to_string(string)
+        self.payload = to_string(payload)
+        self.score = score
+
+    def __repr__(self):
+        return self.string
+
+
+class SuggestionParser(object):
+    """
+    Internal class used to parse results from the `SUGGET` command.
+    This needs to consume either 1, 2, or 3 values at a time from
+    the return value depending on what objects were requested
+    """
+
+    def __init__(self, with_scores, with_payloads, ret):
+        self.with_scores = with_scores
+        self.with_payloads = with_payloads
+
+        if with_scores and with_payloads:
+            self.sugsize = 3
+            self._scoreidx = 1
+            self._payloadidx = 2
+        elif with_scores:
+            self.sugsize = 2
+            self._scoreidx = 1
+        elif with_payloads:
+            self.sugsize = 2
+            self._payloadidx = 1
+        else:
+            self.sugsize = 1
+            self._scoreidx = -1
+
+        self._sugs = ret
+
+    def __iter__(self):
+        for i in xrange(0, len(self._sugs), self.sugsize):
+            ss = self._sugs[i]
+            score = float(self._sugs[i + self._scoreidx]) \
+                if self.with_scores else 1.0
+            payload = self._sugs[i + self._payloadidx] \
+                if self.with_payloads else None
+            yield Suggestion(ss, score, payload)
diff --git a/tasks.py b/tasks.py
index 15e983bbfd..aa965c6902 100644
--- a/tasks.py
+++ b/tasks.py
@@ -17,7 +17,6 @@ def devenv(c):
     cmd = 'tox -e devenv'
     for d in dockers:
         cmd += " --docker-dont-stop={}".format(d)
-    print("Running: {}".format(cmd))
     run(cmd)
 
 
diff --git a/tests/conftest.py b/tests/conftest.py
index 9ca429dafa..47188df07f 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -13,6 +13,8 @@
 default_redis_url = "redis://localhost:6379/9"
 default_redismod_url = "redis://localhost:36379/9"
 
+default_redismod_url = "redis://localhost:36379"
+
 
 def pytest_addoption(parser):
     parser.addoption('--redis-url', default=default_redis_url,
@@ -85,6 +87,7 @@ def skip_ifmodversion_lt(min_version: str, module_name: str):
 
 
 def _get_client(cls, request, single_connection_client=True, flushdb=True,
+                from_url=None,
                 **kwargs):
     """
     Helper for fixtures or tests that need a Redis client
@@ -93,7 +96,10 @@ def _get_client(cls, request, single_connection_client=True, flushdb=True,
     ConnectionPool.from_url, keyword arguments to this function override
     values specified in the URL.
     """
-    redis_url = request.config.getoption("--redis-url")
+    if from_url is None:
+        redis_url = request.config.getoption("--redis-url")
+    else:
+        redis_url = from_url
     url_options = parse_url(redis_url)
     url_options.update(kwargs)
     pool = redis.ConnectionPool(**url_options)
@@ -115,9 +121,12 @@ def teardown():
     return client
 
 
+# specifically set to the zero database, because creating
+# an index on db != 0 raises a ResponseError in redis
 @pytest.fixture()
-def modclient(request, port=36379, **kwargs):
-    with _get_client(redis.Redis, request, port=port, **kwargs) as client:
+def modclient(request, **kwargs):
+    rmurl = request.config.getoption('--redismod-url')
+    with _get_client(redis.Redis, request, from_url=rmurl, **kwargs) as client:
         yield client
 
 
diff --git a/tests/test_json.py b/tests/test_json.py
index 96675f1e45..83fbf28669 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -10,7 +10,7 @@ def client(modclient):
     return modclient
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def test_json_setbinarykey(client):
     d = {"hello": "world", b"some": "value"}
     with pytest.raises(TypeError):
@@ -18,7 +18,7 @@ def test_json_setbinarykey(client):
     assert client.json().set("somekey", Path.rootPath(), d, decode_keys=True)
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def test_json_setgetdeleteforget(client):
     assert client.json().set("foo", Path.rootPath(), "bar")
     assert client.json().get("foo") == "bar"
@@ -28,13 +28,13 @@ def test_json_setgetdeleteforget(client):
     assert client.exists("foo") == 0
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def test_justaget(client):
     client.json().set("foo", Path.rootPath(), "bar")
     assert client.json().get("foo") == "bar"
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def test_json_get_jset(client):
     assert client.json().set("foo", Path.rootPath(), "bar")
     assert "bar" == client.json().get("foo")
@@ -43,7 +43,7 @@ def test_json_get_jset(client):
     assert client.exists("foo") == 0
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def test_nonascii_setgetdelete(client):
     assert client.json().set("notascii", Path.rootPath(),
                              "hyvää-élève") is True
@@ -52,7 +52,7 @@ def test_nonascii_setgetdelete(client):
     assert client.exists("notascii") == 0
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def test_jsonsetexistentialmodifiersshouldsucceed(client):
     obj = {"foo": "bar"}
     assert client.json().set("obj", Path.rootPath(), obj)
@@ -70,7 +70,7 @@ def test_jsonsetexistentialmodifiersshouldsucceed(client):
         client.json().set("obj", Path("foo"), "baz", nx=True, xx=True)
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def test_mgetshouldsucceed(client):
     client.json().set("1", Path.rootPath(), 1)
     client.json().set("2", Path.rootPath(), 2)
@@ -79,7 +79,7 @@ def test_mgetshouldsucceed(client):
     assert e == r
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
 def test_clearShouldSucceed(client):
     client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
@@ -87,13 +87,13 @@ def test_clearShouldSucceed(client):
     assert [] == client.json().get("arr")
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def test_typeshouldsucceed(client):
     client.json().set("1", Path.rootPath(), 1)
     assert b"integer" == client.json().type("1")
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def test_numincrbyshouldsucceed(client):
     client.json().set("num", Path.rootPath(), 1)
     assert 2 == client.json().numincrby("num", Path.rootPath(), 1)
@@ -101,7 +101,7 @@ def test_numincrbyshouldsucceed(client):
     assert 1.25 == client.json().numincrby("num", Path.rootPath(), -1.25)
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def test_nummultbyshouldsucceed(client):
     client.json().set("num", Path.rootPath(), 1)
     assert 2 == client.json().nummultby("num", Path.rootPath(), 2)
@@ -109,7 +109,7 @@ def test_nummultbyshouldsucceed(client):
     assert 2.5 == client.json().nummultby("num", Path.rootPath(), 0.5)
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
 def test_toggleShouldSucceed(client):
     client.json().set("bool", Path.rootPath(), False)
@@ -121,20 +121,20 @@ def test_toggleShouldSucceed(client):
         client.json().toggle("num", Path.rootPath())
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def test_strappendshouldsucceed(client):
     client.json().set("str", Path.rootPath(), "foo")
     assert 6 == client.json().strappend("str", "bar", Path.rootPath())
     assert "foobar" == client.json().get("str", Path.rootPath())
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def test_debug(client):
     client.json().set("str", Path.rootPath(), "foo")
     assert 24 == client.json().debug("str", Path.rootPath())
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def test_strlenshouldsucceed(client):
     client.json().set("str", Path.rootPath(), "foo")
     assert 3 == client.json().strlen("str", Path.rootPath())
@@ -142,7 +142,7 @@ def test_strlenshouldsucceed(client):
     assert 6 == client.json().strlen("str", Path.rootPath())
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def test_arrappendshouldsucceed(client):
     client.json().set("arr", Path.rootPath(), [1])
     assert 2 == client.json().arrappend("arr", Path.rootPath(), 2)
@@ -150,14 +150,14 @@ def test_arrappendshouldsucceed(client):
     assert 7 == client.json().arrappend("arr", Path.rootPath(), *[5, 6, 7])
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def testArrIndexShouldSucceed(client):
     client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
     assert 1 == client.json().arrindex("arr", Path.rootPath(), 1)
     assert -1 == client.json().arrindex("arr", Path.rootPath(), 1, 2)
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def test_arrinsertshouldsucceed(client):
     client.json().set("arr", Path.rootPath(), [0, 4])
     assert 5 - -client.json().arrinsert(
@@ -173,13 +173,13 @@ def test_arrinsertshouldsucceed(client):
     assert [0, 1, 2, 3, 4] == client.json().get("arr")
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def test_arrlenshouldsucceed(client):
     client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
     assert 5 == client.json().arrlen("arr", Path.rootPath())
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def test_arrpopshouldsucceed(client):
     client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
     assert 4 == client.json().arrpop("arr", Path.rootPath(), 4)
@@ -189,14 +189,14 @@ def test_arrpopshouldsucceed(client):
     assert [1] == client.json().get("arr")
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def test_arrtrimshouldsucceed(client):
     client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
     assert 3 == client.json().arrtrim("arr", Path.rootPath(), 1, 3)
     assert [1, 2, 3] == client.json().get("arr")
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def test_respshouldsucceed(client):
     obj = {"foo": "bar", "baz": 1, "qaz": True}
     client.json().set("obj", Path.rootPath(), obj)
@@ -205,7 +205,7 @@ def test_respshouldsucceed(client):
     assert client.json().resp("obj", Path("qaz"))
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def test_objkeysshouldsucceed(client):
     obj = {"foo": "bar", "baz": "qaz"}
     client.json().set("obj", Path.rootPath(), obj)
@@ -216,7 +216,7 @@ def test_objkeysshouldsucceed(client):
     assert exp == keys
 
 
-@pytest.mark.json
+@pytest.mark.redismod
 def test_objlenshouldsucceed(client):
     obj = {"foo": "bar", "baz": "qaz"}
     client.json().set("obj", Path.rootPath(), obj)
@@ -224,7 +224,7 @@ def test_objlenshouldsucceed(client):
 
 
 # @pytest.mark.pipeline
-# @pytest.mark.json
+# @pytest.mark.redismod
 # def test_pipelineshouldsucceed(client):
 #     p = client.json().pipeline()
 #     p.set("foo", Path.rootPath(), "bar")
diff --git a/tests/test_search.py b/tests/test_search.py
new file mode 100644
index 0000000000..926b5ff3af
--- /dev/null
+++ b/tests/test_search.py
@@ -0,0 +1,1219 @@
+import pytest
+import redis
+import bz2
+import csv
+import time
+import os
+
+from io import TextIOWrapper
+from .conftest import skip_ifmodversion_lt, default_redismod_url
+from redis import Redis
+
+import redis.commands.search
+from redis.commands.json.path import Path
+from redis.commands.search import Search
+from redis.commands.search.field import (
+    GeoField,
+    NumericField,
+    TagField,
+    TextField
+)
+from redis.commands.search.query import (
+    GeoFilter,
+    NumericFilter,
+    Query
+)
+from redis.commands.search.result import Result
+from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.suggestion import Suggestion
+import redis.commands.search.aggregation as aggregations
+import redis.commands.search.reducers as reducers
+
+WILL_PLAY_TEXT = (
+    os.path.abspath(
+        os.path.join(
+            os.path.dirname(__file__),
+            "testdata",
+            "will_play_text.csv.bz2"
+        )
+    )
+)
+
+TITLES_CSV = (
+    os.path.abspath(
+        os.path.join(
+            os.path.dirname(__file__),
+            "testdata",
+            "titles.csv"
+        )
+    )
+)
+
+
+def waitForIndex(env, idx, timeout=None):
+    delay = 0.1
+    while True:
+        res = env.execute_command("ft.info", idx)
+        try:
+            res.index("indexing")
+        except ValueError:
+            break
+
+        if int(res[res.index("indexing") + 1]) == 0:
+            break
+
+        time.sleep(delay)
+        if timeout is not None:
+            timeout -= delay
+            if timeout <= 0:
+                break
+
+
+def getClient():
+    """
+    Gets a client client attached to an index name which is ready to be
+    created
+    """
+    rc = Redis.from_url(default_redismod_url, decode_responses=True)
+    return rc
+
+
+def createIndex(client, num_docs=100, definition=None):
+    try:
+        client.create_index(
+            (TextField("play", weight=5.0),
+                TextField("txt"),
+                NumericField("chapter")),
+            definition=definition,
+        )
+    except redis.ResponseError:
+        client.dropindex(delete_documents=True)
+        return createIndex(client, num_docs=num_docs, definition=definition)
+
+    chapters = {}
+    bzfp = TextIOWrapper(bz2.BZ2File(WILL_PLAY_TEXT), encoding="utf8")
+
+    r = csv.reader(bzfp, delimiter=";")
+    for n, line in enumerate(r):
+
+        play, chapter, _, text = \
+            line[1], line[2], line[4], line[5]
+
+        key = "{}:{}".format(play, chapter).lower()
+        d = chapters.setdefault(key, {})
+        d["play"] = play
+        d["txt"] = d.get("txt", "") + " " + text
+        d["chapter"] = int(chapter or 0)
+        if len(chapters) == num_docs:
+            break
+
+    indexer = client.batch_indexer(chunk_size=50)
+    assert isinstance(indexer, Search.BatchIndexer)
+    assert 50 == indexer.chunk_size
+
+    for key, doc in chapters.items():
+        indexer.add_document(key, **doc)
+    indexer.commit()
+
+
+# override the default module client, search requires both db=0, and text
+@pytest.fixture
+def modclient():
+    return Redis.from_url(default_redismod_url, db=0, decode_responses=True)
+
+
+@pytest.fixture
+def client(modclient):
+    modclient.flushdb()
+    return modclient
+
+
+@pytest.mark.redismod
+def test_client(client):
+    num_docs = 500
+    createIndex(client.ft(), num_docs=num_docs)
+    waitForIndex(client, "idx")
+    # verify info
+    info = client.ft().info()
+    for k in [
+        "index_name",
+        "index_options",
+        "attributes",
+        "num_docs",
+        "max_doc_id",
+        "num_terms",
+        "num_records",
+        "inverted_sz_mb",
+        "offset_vectors_sz_mb",
+        "doc_table_size_mb",
+        "key_table_size_mb",
+        "records_per_doc_avg",
+        "bytes_per_record_avg",
+        "offsets_per_term_avg",
+        "offset_bits_per_record_avg",
+    ]:
+        assert k in info
+
+    assert client.ft().index_name == info["index_name"]
+    assert num_docs == int(info["num_docs"])
+
+    res = client.ft().search("henry iv")
+    assert isinstance(res, Result)
+    assert 225 == res.total
+    assert 10 == len(res.docs)
+    assert res.duration > 0
+
+    for doc in res.docs:
+        assert doc.id
+        assert doc.play == "Henry IV"
+        assert len(doc.txt) > 0
+
+    # test no content
+    res = client.ft().search(Query("king").no_content())
+    assert 194 == res.total
+    assert 10 == len(res.docs)
+    for doc in res.docs:
+        assert "txt" not in doc.__dict__
+        assert "play" not in doc.__dict__
+
+    # test verbatim vs no verbatim
+    total = client.ft().search(Query("kings").no_content()).total
+    vtotal = client.ft().search(Query("kings").no_content().verbatim()).total
+    assert total > vtotal
+
+    # test in fields
+    txt_total = (
+        client.ft().search(
+            Query("henry").no_content().limit_fields("txt")).total
+    )
+    play_total = (
+        client.ft().search(
+            Query("henry").no_content().limit_fields("play")).total
+    )
+    both_total = (
+        client.ft()
+        .search(Query("henry").no_content().limit_fields("play", "txt"))
+        .total
+    )
+    assert 129 == txt_total
+    assert 494 == play_total
+    assert 494 == both_total
+
+    # test load_document
+    doc = client.ft().load_document("henry vi part 3:62")
+    assert doc is not None
+    assert "henry vi part 3:62" == doc.id
+    assert doc.play == "Henry VI Part 3"
+    assert len(doc.txt) > 0
+
+    # test in-keys
+    ids = [x.id for x in client.ft().search(Query("henry")).docs]
+    assert 10 == len(ids)
+    subset = ids[:5]
+    docs = client.ft().search(Query("henry").limit_ids(*subset))
+    assert len(subset) == docs.total
+    ids = [x.id for x in docs.docs]
+    assert set(ids) == set(subset)
+
+    # test slop and in order
+    assert 193 == client.ft().search(Query("henry king")).total
+    assert 3 == client.ft().search(
+        Query("henry king").slop(0).in_order()).total
+    assert 52 == client.ft().search(
+        Query("king henry").slop(0).in_order()).total
+    assert 53 == client.ft().search(Query("henry king").slop(0)).total
+    assert 167 == client.ft().search(Query("henry king").slop(100)).total
+
+    # test delete document
+    client.ft().add_document("doc-5ghs2", play="Death of a Salesman")
+    res = client.ft().search(Query("death of a salesman"))
+    assert 1 == res.total
+
+    assert 1 == client.ft().delete_document("doc-5ghs2")
+    res = client.ft().search(Query("death of a salesman"))
+    assert 0 == res.total
+    assert 0 == client.ft().delete_document("doc-5ghs2")
+
+    client.ft().add_document("doc-5ghs2", play="Death of a Salesman")
+    res = client.ft().search(Query("death of a salesman"))
+    assert 1 == res.total
+    client.ft().delete_document("doc-5ghs2")
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.2.0", "search")
+def test_payloads(client):
+    client.ft().create_index((TextField("txt"),))
+
+    client.ft().add_document("doc1", payload="foo baz", txt="foo bar")
+    client.ft().add_document("doc2", txt="foo bar")
+
+    q = Query("foo bar").with_payloads()
+    res = client.ft().search(q)
+    assert 2 == res.total
+    assert "doc1" == res.docs[0].id
+    assert "doc2" == res.docs[1].id
+    assert "foo baz" == res.docs[0].payload
+    assert res.docs[1].payload is None
+
+
+@pytest.mark.redismod
+def test_scores(client):
+    client.ft().create_index((TextField("txt"),))
+
+    client.ft().add_document("doc1", txt="foo baz")
+    client.ft().add_document("doc2", txt="foo bar")
+
+    q = Query("foo ~bar").with_scores()
+    res = client.ft().search(q)
+    assert 2 == res.total
+    assert "doc2" == res.docs[0].id
+    assert 3.0 == res.docs[0].score
+    assert "doc1" == res.docs[1].id
+    # todo: enable once new RS version is tagged
+    # self.assertEqual(0.2, res.docs[1].score)
+
+
+@pytest.mark.redismod
+def test_replace(client):
+    client.ft().create_index((TextField("txt"),))
+
+    client.ft().add_document("doc1", txt="foo bar")
+    client.ft().add_document("doc2", txt="foo bar")
+    waitForIndex(client, "idx")
+
+    res = client.ft().search("foo bar")
+    assert 2 == res.total
+    client.ft().add_document(
+        "doc1",
+        replace=True,
+        txt="this is a replaced doc"
+    )
+
+    res = client.ft().search("foo bar")
+    assert 1 == res.total
+    assert "doc2" == res.docs[0].id
+
+    res = client.ft().search("replaced doc")
+    assert 1 == res.total
+    assert "doc1" == res.docs[0].id
+
+
+@pytest.mark.redismod
+def test_stopwords(client):
+    client.ft().create_index(
+        (TextField("txt"),),
+        stopwords=["foo", "bar", "baz"]
+    )
+    client.ft().add_document("doc1", txt="foo bar")
+    client.ft().add_document("doc2", txt="hello world")
+    waitForIndex(client, "idx")
+
+    q1 = Query("foo bar").no_content()
+    q2 = Query("foo bar hello world").no_content()
+    res1, res2 = client.ft().search(q1), client.ft().search(q2)
+    assert 0 == res1.total
+    assert 1 == res2.total
+
+
+@pytest.mark.redismod
+def test_filters(client):
+    client.ft().create_index(
+        (TextField("txt"),
+            NumericField("num"),
+            GeoField("loc"))
+    )
+    client.ft().add_document(
+        "doc1",
+        txt="foo bar",
+        num=3.141,
+        loc="-0.441,51.458"
+    )
+    client.ft().add_document("doc2", txt="foo baz", num=2, loc="-0.1,51.2")
+
+    waitForIndex(client, "idx")
+    # Test numerical filter
+    q1 = Query("foo").add_filter(NumericFilter("num", 0, 2)).no_content()
+    q2 = (
+        Query("foo")
+        .add_filter(
+            NumericFilter("num", 2, NumericFilter.INF, minExclusive=True))
+        .no_content()
+    )
+    res1, res2 = client.ft().search(q1), client.ft().search(q2)
+
+    assert 1 == res1.total
+    assert 1 == res2.total
+    assert "doc2" == res1.docs[0].id
+    assert "doc1" == res2.docs[0].id
+
+    # Test geo filter
+    q1 = Query("foo").add_filter(
+        GeoFilter("loc", -0.44, 51.45, 10)).no_content()
+    q2 = Query("foo").add_filter(
+        GeoFilter("loc", -0.44, 51.45, 100)).no_content()
+    res1, res2 = client.ft().search(q1), client.ft().search(q2)
+
+    assert 1 == res1.total
+    assert 2 == res2.total
+    assert "doc1" == res1.docs[0].id
+
+    # Sort results, after RDB reload order may change
+    res = [res2.docs[0].id, res2.docs[1].id]
+    res.sort()
+    assert ["doc1", "doc2"] == res
+
+
+@pytest.mark.redismod
+def test_payloads_with_no_content(client):
+    client.ft().create_index((TextField("txt"),))
+    client.ft().add_document("doc1", payload="foo baz", txt="foo bar")
+    client.ft().add_document("doc2", payload="foo baz2", txt="foo bar")
+
+    q = Query("foo bar").with_payloads().no_content()
+    res = client.ft().search(q)
+    assert 2 == len(res.docs)
+
+
+@pytest.mark.redismod
+def test_sort_by(client):
+    client.ft().create_index(
+        (TextField("txt"),
+            NumericField("num", sortable=True))
+    )
+    client.ft().add_document("doc1", txt="foo bar", num=1)
+    client.ft().add_document("doc2", txt="foo baz", num=2)
+    client.ft().add_document("doc3", txt="foo qux", num=3)
+
+    # Test sort
+    q1 = Query("foo").sort_by("num", asc=True).no_content()
+    q2 = Query("foo").sort_by("num", asc=False).no_content()
+    res1, res2 = client.ft().search(q1), client.ft().search(q2)
+
+    assert 3 == res1.total
+    assert "doc1" == res1.docs[0].id
+    assert "doc2" == res1.docs[1].id
+    assert "doc3" == res1.docs[2].id
+    assert 3 == res2.total
+    assert "doc1" == res2.docs[2].id
+    assert "doc2" == res2.docs[1].id
+    assert "doc3" == res2.docs[0].id
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.0.0", "search")
+def test_drop_index():
+    """
+    Ensure the index gets dropped by data remains by default
+    """
+    for x in range(20):
+        for keep_docs in [[True, {}], [False, {"name": "haveit"}]]:
+            idx = "HaveIt"
+            index = getClient()
+            index.hset("index:haveit", mapping={"name": "haveit"})
+            idef = IndexDefinition(prefix=["index:"])
+            index.ft(idx).create_index((TextField("name"),), definition=idef)
+            waitForIndex(index, idx)
+            index.ft(idx).dropindex(delete_documents=keep_docs[0])
+            i = index.hgetall("index:haveit")
+            assert i == keep_docs[1]
+
+
+@pytest.mark.redismod
+def test_example(client):
+    # Creating the index definition and schema
+    client.ft().create_index(
+        (TextField("title", weight=5.0),
+            TextField("body"))
+    )
+
+    # Indexing a document
+    client.ft().add_document(
+        "doc1",
+        title="RediSearch",
+        body="Redisearch impements a search engine on top of redis",
+    )
+
+    # Searching with complex parameters:
+    q = Query("search engine").verbatim().no_content().paging(0, 5)
+
+    res = client.ft().search(q)
+    assert res is not None
+
+
+@pytest.mark.redismod
+def test_auto_complete(client):
+    n = 0
+    with open(TITLES_CSV) as f:
+        cr = csv.reader(f)
+
+        for row in cr:
+            n += 1
+            term, score = row[0], float(row[1])
+            assert n == client.ft().sugadd("ac", Suggestion(term, score=score))
+
+    assert n == client.ft().suglen("ac")
+    ret = client.ft().sugget("ac", "bad", with_scores=True)
+    assert 2 == len(ret)
+    assert "badger" == ret[0].string
+    assert isinstance(ret[0].score, float)
+    assert 1.0 != ret[0].score
+    assert "badalte rishtey" == ret[1].string
+    assert isinstance(ret[1].score, float)
+    assert 1.0 != ret[1].score
+
+    ret = client.ft().sugget("ac", "bad", fuzzy=True, num=10)
+    assert 10 == len(ret)
+    assert 1.0 == ret[0].score
+    strs = {x.string for x in ret}
+
+    for sug in strs:
+        assert 1 == client.ft().sugdel("ac", sug)
+    # make sure a second delete returns 0
+    for sug in strs:
+        assert 0 == client.ft().sugdel("ac", sug)
+
+    # make sure they were actually deleted
+    ret2 = client.ft().sugget("ac", "bad", fuzzy=True, num=10)
+    for sug in ret2:
+        assert sug.string not in strs
+
+    # Test with payload
+    client.ft().sugadd("ac", Suggestion("pay1", payload="pl1"))
+    client.ft().sugadd("ac", Suggestion("pay2", payload="pl2"))
+    client.ft().sugadd("ac", Suggestion("pay3", payload="pl3"))
+
+    sugs = client.ft().sugget(
+        "ac",
+        "pay",
+        with_payloads=True,
+        with_scores=True
+    )
+    assert 3 == len(sugs)
+    for sug in sugs:
+        assert sug.payload
+        assert sug.payload.startswith("pl")
+
+
+@pytest.mark.redismod
+def test_no_index(client):
+    client.ft().create_index(
+        (
+            TextField("field"),
+            TextField("text", no_index=True, sortable=True),
+            NumericField("numeric", no_index=True, sortable=True),
+            GeoField("geo", no_index=True, sortable=True),
+            TagField("tag", no_index=True, sortable=True),
+        )
+    )
+
+    client.ft().add_document(
+        "doc1", field="aaa", text="1", numeric="1", geo="1,1", tag="1"
+    )
+    client.ft().add_document(
+        "doc2", field="aab", text="2", numeric="2", geo="2,2", tag="2"
+    )
+    waitForIndex(client, "idx")
+
+    res = client.ft().search(Query("@text:aa*"))
+    assert 0 == res.total
+
+    res = client.ft().search(Query("@field:aa*"))
+    assert 2 == res.total
+
+    res = client.ft().search(Query("*").sort_by("text", asc=False))
+    assert 2 == res.total
+    assert "doc2" == res.docs[0].id
+
+    res = client.ft().search(Query("*").sort_by("text", asc=True))
+    assert "doc1" == res.docs[0].id
+
+    res = client.ft().search(Query("*").sort_by("numeric", asc=True))
+    assert "doc1" == res.docs[0].id
+
+    res = client.ft().search(Query("*").sort_by("geo", asc=True))
+    assert "doc1" == res.docs[0].id
+
+    res = client.ft().search(Query("*").sort_by("tag", asc=True))
+    assert "doc1" == res.docs[0].id
+
+    # Ensure exception is raised for non-indexable, non-sortable fields
+    with pytest.raises(Exception):
+        TextField("name", no_index=True, sortable=False)
+    with pytest.raises(Exception):
+        NumericField("name", no_index=True, sortable=False)
+    with pytest.raises(Exception):
+        GeoField("name", no_index=True, sortable=False)
+    with pytest.raises(Exception):
+        TagField("name", no_index=True, sortable=False)
+
+
+@pytest.mark.redismod
+def test_partial(client):
+    client.ft().create_index(
+        (TextField("f1"),
+            TextField("f2"),
+            TextField("f3"))
+    )
+    client.ft().add_document("doc1", f1="f1_val", f2="f2_val")
+    client.ft().add_document("doc2", f1="f1_val", f2="f2_val")
+    client.ft().add_document("doc1", f3="f3_val", partial=True)
+    client.ft().add_document("doc2", f3="f3_val", replace=True)
+    waitForIndex(client, "idx")
+
+    # Search for f3 value. All documents should have it
+    res = client.ft().search("@f3:f3_val")
+    assert 2 == res.total
+
+    # Only the document updated with PARTIAL should still have f1 and f2 values
+    res = client.ft().search("@f3:f3_val @f2:f2_val @f1:f1_val")
+    assert 1 == res.total
+
+
+@pytest.mark.redismod
+def test_no_create(client):
+    client.ft().create_index(
+        (TextField("f1"),
+            TextField("f2"),
+            TextField("f3"))
+    )
+    client.ft().add_document("doc1", f1="f1_val", f2="f2_val")
+    client.ft().add_document("doc2", f1="f1_val", f2="f2_val")
+    client.ft().add_document("doc1", f3="f3_val", no_create=True)
+    client.ft().add_document("doc2", f3="f3_val", no_create=True, partial=True)
+    waitForIndex(client, "idx")
+
+    # Search for f3 value. All documents should have it
+    res = client.ft().search("@f3:f3_val")
+    assert 2 == res.total
+
+    # Only the document updated with PARTIAL should still have f1 and f2 values
+    res = client.ft().search("@f3:f3_val @f2:f2_val @f1:f1_val")
+    assert 1 == res.total
+
+    with pytest.raises(redis.ResponseError):
+        client.ft().add_document(
+            "doc3",
+            f2="f2_val",
+            f3="f3_val",
+            no_create=True
+        )
+
+
+@pytest.mark.redismod
+def test_explain(client):
+    client.ft().create_index(
+        (TextField("f1"),
+            TextField("f2"),
+            TextField("f3"))
+    )
+    res = client.ft().explain("@f3:f3_val @f2:f2_val @f1:f1_val")
+    assert res
+
+
+@pytest.mark.redismod
+def test_summarize(client):
+    createIndex(client.ft())
+    waitForIndex(client, "idx")
+
+    q = Query("king henry").paging(0, 1)
+    q.highlight(fields=("play", "txt"), tags=("<b>", "</b>"))
+    q.summarize("txt")
+
+    doc = sorted(client.ft().search(q).docs)[0]
+    assert "<b>Henry</b> IV" == doc.play
+    assert (
+        "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+        == doc.txt
+    )
+
+    q = Query("king henry").paging(0, 1).summarize().highlight()
+
+    doc = sorted(client.ft().search(q).docs)[0]
+    assert "<b>Henry</b> ... " == doc.play
+    assert (
+        "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+        == doc.txt
+    )
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.0.0", "search")
+def test_alias():
+    index1 = getClient()
+    index2 = getClient()
+
+    index1.hset("index1:lonestar", mapping={"name": "lonestar"})
+    index2.hset("index2:yogurt", mapping={"name": "yogurt"})
+
+    if os.environ.get("GITHUB_WORKFLOW", None) is not None:
+        time.sleep(2)
+    else:
+        time.sleep(5)
+
+    def1 = IndexDefinition(prefix=["index1:"], score_field="name")
+    def2 = IndexDefinition(prefix=["index2:"], score_field="name")
+
+    ftindex1 = index1.ft("testAlias")
+    ftindex2 = index1.ft("testAlias2")
+    ftindex1.create_index((TextField("name"),), definition=def1)
+    ftindex2.create_index((TextField("name"),), definition=def2)
+
+    # CI is slower
+    try:
+        res = ftindex1.search("*").docs[0]
+    except IndexError:
+        time.sleep(5)
+        res = ftindex1.search("*").docs[0]
+    assert "index1:lonestar" == res.id
+
+    # create alias and check for results
+    ftindex1.aliasadd("spaceballs")
+    alias_client = getClient().ft("spaceballs")
+    res = alias_client.search("*").docs[0]
+    assert "index1:lonestar" == res.id
+
+    # Throw an exception when trying to add an alias that already exists
+    with pytest.raises(Exception):
+        ftindex2.aliasadd("spaceballs")
+
+    # update alias and ensure new results
+    ftindex2.aliasupdate("spaceballs")
+    alias_client2 = getClient().ft("spaceballs")
+    res = alias_client2.search("*").docs[0]
+    assert "index2:yogurt" == res.id
+
+    ftindex2.aliasdel("spaceballs")
+    with pytest.raises(Exception):
+        alias_client2.search("*").docs[0]
+
+
+@pytest.mark.redismod
+def test_alias_basic():
+    # Creating a client with one index
+    getClient().flushdb()
+    index1 = getClient().ft("testAlias")
+
+    index1.create_index((TextField("txt"),))
+    index1.add_document("doc1", txt="text goes here")
+
+    index2 = getClient().ft("testAlias2")
+    index2.create_index((TextField("txt"),))
+    index2.add_document("doc2", txt="text goes here")
+
+    # add the actual alias and check
+    index1.aliasadd("myalias")
+    alias_client = getClient().ft("myalias")
+    res = sorted(alias_client.search("*").docs, key=lambda x: x.id)
+    assert "doc1" == res[0].id
+
+    # Throw an exception when trying to add an alias that already exists
+    with pytest.raises(Exception):
+        index2.aliasadd("myalias")
+
+    # update the alias and ensure we get doc2
+    index2.aliasupdate("myalias")
+    alias_client2 = getClient().ft("myalias")
+    res = sorted(alias_client2.search("*").docs, key=lambda x: x.id)
+    assert "doc1" == res[0].id
+
+    # delete the alias and expect an error if we try to query again
+    index2.aliasdel("myalias")
+    with pytest.raises(Exception):
+        _ = alias_client2.search("*").docs[0]
+
+
+@pytest.mark.redismod
+def test_tags(client):
+    client.ft().create_index((TextField("txt"), TagField("tags")))
+    tags = "foo,foo bar,hello;world"
+    tags2 = "soba,ramen"
+
+    client.ft().add_document("doc1", txt="fooz barz", tags=tags)
+    client.ft().add_document("doc2", txt="noodles", tags=tags2)
+    waitForIndex(client, "idx")
+
+    q = Query("@tags:{foo}")
+    res = client.ft().search(q)
+    assert 1 == res.total
+
+    q = Query("@tags:{foo bar}")
+    res = client.ft().search(q)
+    assert 1 == res.total
+
+    q = Query("@tags:{foo\\ bar}")
+    res = client.ft().search(q)
+    assert 1 == res.total
+
+    q = Query("@tags:{hello\\;world}")
+    res = client.ft().search(q)
+    assert 1 == res.total
+
+    q2 = client.ft().tagvals("tags")
+    assert (tags.split(",") + tags2.split(",")).sort() == q2.sort()
+
+
+@pytest.mark.redismod
+def test_textfield_sortable_nostem(client):
+    # Creating the index definition with sortable and no_stem
+    client.ft().create_index((TextField("txt", sortable=True, no_stem=True),))
+
+    # Now get the index info to confirm its contents
+    response = client.ft().info()
+    assert "SORTABLE" in response["attributes"][0]
+    assert "NOSTEM" in response["attributes"][0]
+
+
+@pytest.mark.redismod
+def test_alter_schema_add(client):
+    # Creating the index definition and schema
+    client.ft().create_index(TextField("title"))
+
+    # Using alter to add a field
+    client.ft().alter_schema_add(TextField("body"))
+
+    # Indexing a document
+    client.ft().add_document(
+        "doc1", title="MyTitle", body="Some content only in the body"
+    )
+
+    # Searching with parameter only in the body (the added field)
+    q = Query("only in the body")
+
+    # Ensure we find the result searching on the added body field
+    res = client.ft().search(q)
+    assert 1 == res.total
+
+
+@pytest.mark.redismod
+def test_spell_check(client):
+    client.ft().create_index((TextField("f1"), TextField("f2")))
+
+    client.ft().add_document(
+        "doc1",
+        f1="some valid content",
+        f2="this is sample text"
+    )
+    client.ft().add_document("doc2", f1="very important", f2="lorem ipsum")
+    waitForIndex(client, "idx")
+
+    # test spellcheck
+    res = client.ft().spellcheck("impornant")
+    assert "important" == res["impornant"][0]["suggestion"]
+
+    res = client.ft().spellcheck("contnt")
+    assert "content" == res["contnt"][0]["suggestion"]
+
+    # test spellcheck with Levenshtein distance
+    res = client.ft().spellcheck("vlis")
+    assert res == {}
+    res = client.ft().spellcheck("vlis", distance=2)
+    assert "valid" == res["vlis"][0]["suggestion"]
+
+    # test spellcheck include
+    client.ft().dict_add("dict", "lore", "lorem", "lorm")
+    res = client.ft().spellcheck("lorm", include="dict")
+    assert len(res["lorm"]) == 3
+    assert (
+        res["lorm"][0]["suggestion"],
+        res["lorm"][1]["suggestion"],
+        res["lorm"][2]["suggestion"],
+    ) == ("lorem", "lore", "lorm")
+    assert (res["lorm"][0]["score"], res["lorm"][1]["score"]) == ("0.5", "0")
+
+    # test spellcheck exclude
+    res = client.ft().spellcheck("lorm", exclude="dict")
+    assert res == {}
+
+
+@pytest.mark.redismod
+def test_dict_operations(client):
+    client.ft().create_index((TextField("f1"), TextField("f2")))
+    # Add three items
+    res = client.ft().dict_add("custom_dict", "item1", "item2", "item3")
+    assert 3 == res
+
+    # Remove one item
+    res = client.ft().dict_del("custom_dict", "item2")
+    assert 1 == res
+
+    # Dump dict and inspect content
+    res = client.ft().dict_dump("custom_dict")
+    assert ["item1", "item3"] == res
+
+    # Remove rest of the items before reload
+    client.ft().dict_del("custom_dict", *res)
+
+
+@pytest.mark.redismod
+def test_phonetic_matcher(client):
+    client.ft().create_index((TextField("name"),))
+    client.ft().add_document("doc1", name="Jon")
+    client.ft().add_document("doc2", name="John")
+
+    res = client.ft().search(Query("Jon"))
+    assert 1 == len(res.docs)
+    assert "Jon" == res.docs[0].name
+
+    # Drop and create index with phonetic matcher
+    client.flushdb()
+
+    client.ft().create_index((TextField("name", phonetic_matcher="dm:en"),))
+    client.ft().add_document("doc1", name="Jon")
+    client.ft().add_document("doc2", name="John")
+
+    res = client.ft().search(Query("Jon"))
+    assert 2 == len(res.docs)
+    assert ["John", "Jon"] == sorted([d.name for d in res.docs])
+
+
+@pytest.mark.redismod
+def test_scorer(client):
+    client.ft().create_index((TextField("description"),))
+
+    client.ft().add_document(
+        "doc1", description="The quick brown fox jumps over the lazy dog"
+    )
+    client.ft().add_document(
+        "doc2",
+        description="Quick alice was beginning to get very tired of sitting by her quick sister on the bank, and of having nothing to do.",  # noqa
+    )
+
+    # default scorer is TFIDF
+    res = client.ft().search(Query("quick").with_scores())
+    assert 1.0 == res.docs[0].score
+    res = client.ft().search(Query("quick").scorer("TFIDF").with_scores())
+    assert 1.0 == res.docs[0].score
+    res = client.ft().search(
+        Query("quick").scorer("TFIDF.DOCNORM").with_scores())
+    assert 0.1111111111111111 == res.docs[0].score
+    res = client.ft().search(Query("quick").scorer("BM25").with_scores())
+    assert 0.17699114465425977 == res.docs[0].score
+    res = client.ft().search(Query("quick").scorer("DISMAX").with_scores())
+    assert 2.0 == res.docs[0].score
+    res = client.ft().search(Query("quick").scorer("DOCSCORE").with_scores())
+    assert 1.0 == res.docs[0].score
+    res = client.ft().search(Query("quick").scorer("HAMMING").with_scores())
+    assert 0.0 == res.docs[0].score
+
+
+@pytest.mark.redismod
+def test_get(client):
+    client.ft().create_index((TextField("f1"), TextField("f2")))
+
+    assert [None] == client.ft().get("doc1")
+    assert [None, None] == client.ft().get("doc2", "doc1")
+
+    client.ft().add_document(
+        "doc1", f1="some valid content dd1", f2="this is sample text ff1"
+    )
+    client.ft().add_document(
+        "doc2", f1="some valid content dd2", f2="this is sample text ff2"
+    )
+
+    assert [
+        ["f1", "some valid content dd2", "f2", "this is sample text ff2"]
+    ] == client.ft().get("doc2")
+    assert [
+        ["f1", "some valid content dd1", "f2", "this is sample text ff1"],
+        ["f1", "some valid content dd2", "f2", "this is sample text ff2"],
+    ] == client.ft().get("doc1", "doc2")
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.2.0", "search")
+def test_config(client):
+    assert client.ft().config_set("TIMEOUT", "100")
+    with pytest.raises(redis.ResponseError):
+        client.ft().config_set("TIMEOUT", "null")
+    res = client.ft().config_get("*")
+    assert "100" == res["TIMEOUT"]
+    res = client.ft().config_get("TIMEOUT")
+    assert "100" == res["TIMEOUT"]
+
+
+@pytest.mark.redismod
+def test_aggregations(client):
+    # Creating the index definition and schema
+    client.ft().create_index(
+        (
+            NumericField("random_num"),
+            TextField("title"),
+            TextField("body"),
+            TextField("parent"),
+        )
+    )
+
+    # Indexing a document
+    client.ft().add_document(
+        "search",
+        title="RediSearch",
+        body="Redisearch impements a search engine on top of redis",
+        parent="redis",
+        random_num=10,
+    )
+    client.ft().add_document(
+        "ai",
+        title="RedisAI",
+        body="RedisAI executes Deep Learning/Machine Learning models and managing their data.",  # noqa
+        parent="redis",
+        random_num=3,
+    )
+    client.ft().add_document(
+        "json",
+        title="RedisJson",
+        body="RedisJSON implements ECMA-404 The JSON Data Interchange Standard as a native data type.",  # noqa
+        parent="redis",
+        random_num=8,
+    )
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
+        reducers.count(),
+        reducers.count_distinct("@title"),
+        reducers.count_distinctish("@title"),
+        reducers.sum("@random_num"),
+        reducers.min("@random_num"),
+        reducers.max("@random_num"),
+        reducers.avg("@random_num"),
+        reducers.stddev("random_num"),
+        reducers.quantile("@random_num", 0.5),
+        reducers.tolist("@title"),
+        reducers.first_value("@title"),
+        reducers.random_sample("@title", 2),
+    )
+
+    res = client.ft().aggregate(req)
+
+    res = res.rows[0]
+    assert len(res) == 26
+    assert "redis" == res[1]
+    assert "3" == res[3]
+    assert "3" == res[5]
+    assert "3" == res[7]
+    assert "21" == res[9]
+    assert "3" == res[11]
+    assert "10" == res[13]
+    assert "7" == res[15]
+    assert "3.60555127546" == res[17]
+    assert "10" == res[19]
+    assert ["RediSearch", "RedisAI", "RedisJson"] == res[21]
+    assert "RediSearch" == res[23]
+    assert 2 == len(res[25])
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.0.0", "search")
+def test_index_definition(client):
+    """
+    Create definition and test its args
+    """
+    with pytest.raises(RuntimeError):
+        IndexDefinition(prefix=["hset:", "henry"], index_type="json")
+
+    definition = IndexDefinition(
+        prefix=["hset:", "henry"],
+        filter="@f1==32",
+        language="English",
+        language_field="play",
+        score_field="chapter",
+        score=0.5,
+        payload_field="txt",
+        index_type=IndexType.JSON,
+    )
+
+    assert [
+        "ON",
+        "JSON",
+        "PREFIX",
+        2,
+        "hset:",
+        "henry",
+        "FILTER",
+        "@f1==32",
+        "LANGUAGE_FIELD",
+        "play",
+        "LANGUAGE",
+        "English",
+        "SCORE_FIELD",
+        "chapter",
+        "SCORE",
+        0.5,
+        "PAYLOAD_FIELD",
+        "txt",
+    ] == definition.args
+
+    createIndex(client.ft(), num_docs=500, definition=definition)
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.0.0", "search")
+def test_create_client_definition(client):
+    """
+    Create definition with no index type provided,
+    and use hset to test the client definition (the default is HASH).
+    """
+    definition = IndexDefinition(prefix=["hset:", "henry"])
+    createIndex(client.ft(), num_docs=500, definition=definition)
+
+    info = client.ft().info()
+    assert 494 == int(info["num_docs"])
+
+    client.ft().client.hset("hset:1", "f1", "v1")
+    info = client.ft().info()
+    assert 495 == int(info["num_docs"])
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.0.0", "search")
+def test_create_client_definition_hash(client):
+    """
+    Create definition with IndexType.HASH as index type (ON HASH),
+    and use hset to test the client definition.
+    """
+    definition = IndexDefinition(
+        prefix=["hset:", "henry"],
+        index_type=IndexType.HASH
+    )
+    createIndex(client.ft(), num_docs=500, definition=definition)
+
+    info = client.ft().info()
+    assert 494 == int(info["num_docs"])
+
+    client.ft().client.hset("hset:1", "f1", "v1")
+    info = client.ft().info()
+    assert 495 == int(info["num_docs"])
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.2.0", "search")
+def test_create_client_definition_json(client):
+    """
+    Create definition with IndexType.JSON as index type (ON JSON),
+    and use json client to test it.
+    """
+    definition = IndexDefinition(prefix=["king:"], index_type=IndexType.JSON)
+    client.ft().create_index((TextField("$.name"),), definition=definition)
+
+    client.json().set("king:1", Path.rootPath(), {"name": "henry"})
+    client.json().set("king:2", Path.rootPath(), {"name": "james"})
+
+    res = client.ft().search("henry")
+    assert res.docs[0].id == "king:1"
+    assert res.docs[0].payload is None
+    assert res.docs[0].json == '{"name":"henry"}'
+    assert res.total == 1
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.2.0", "search")
+def test_fields_as_name(client):
+    # create index
+    SCHEMA = (
+        TextField("$.name", sortable=True, as_name="name"),
+        NumericField("$.age", as_name="just_a_number"),
+    )
+    definition = IndexDefinition(index_type=IndexType.JSON)
+    client.ft().create_index(SCHEMA, definition=definition)
+
+    # insert json data
+    res = client.json().set(
+        "doc:1",
+        Path.rootPath(),
+        {"name": "Jon", "age": 25}
+    )
+    assert res
+
+    total = client.ft().search(
+        Query("Jon").return_fields("name", "just_a_number")).docs
+    assert 1 == len(total)
+    assert "doc:1" == total[0].id
+    assert "Jon" == total[0].name
+    assert "25" == total[0].just_a_number
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.2.0", "search")
+def test_search_return_fields(client):
+    res = client.json().set(
+        "doc:1",
+        Path.rootPath(),
+        {"t": "riceratops", "t2": "telmatosaurus", "n": 9072, "flt": 97.2},
+    )
+    assert res
+
+    # create index on
+    definition = IndexDefinition(index_type=IndexType.JSON)
+    SCHEMA = (
+        TextField("$.t"),
+        NumericField("$.flt"),
+    )
+    client.ft().create_index(SCHEMA, definition=definition)
+    waitForIndex(client, "idx")
+
+    total = client.ft().search(
+        Query("*").return_field("$.t", as_field="txt")).docs
+    assert 1 == len(total)
+    assert "doc:1" == total[0].id
+    assert "riceratops" == total[0].txt
+
+    total = client.ft().search(
+        Query("*").return_field("$.t2", as_field="txt")).docs
+    assert 1 == len(total)
+    assert "doc:1" == total[0].id
+    assert "telmatosaurus" == total[0].txt
+
+
+@pytest.mark.redismod
+def test_synupdate(client):
+    definition = IndexDefinition(index_type=IndexType.HASH)
+    client.ft().create_index(
+        (
+            TextField("title"),
+            TextField("body"),
+        ),
+        definition=definition,
+    )
+
+    client.ft().synupdate("id1", True, "boy", "child", "offspring")
+    client.ft().add_document(
+        "doc1",
+        title="he is a baby",
+        body="this is a test")
+
+    client.ft().synupdate("id1", True, "baby")
+    client.ft().add_document(
+        "doc2",
+        title="he is another baby",
+        body="another test"
+    )
+
+    res = client.ft().search(Query("child").expander("SYNONYM"))
+    assert res.docs[0].id == "doc2"
+    assert res.docs[0].title == "he is another baby"
+    assert res.docs[0].body == "another test"
+
+
+@pytest.mark.redismod
+def test_syndump(client):
+    definition = IndexDefinition(index_type=IndexType.HASH)
+    client.ft().create_index(
+        (
+            TextField("title"),
+            TextField("body"),
+        ),
+        definition=definition,
+    )
+
+    client.ft().synupdate("id1", False, "boy", "child", "offspring")
+    client.ft().synupdate("id2", False, "baby", "child")
+    client.ft().synupdate("id3", False, "tree", "wood")
+    res = client.ft().syndump()
+    assert res == {
+        "boy": ["id1"],
+        "tree": ["id3"],
+        "wood": ["id3"],
+        "child": ["id1", "id2"],
+        "baby": ["id2"],
+        "offspring": ["id1"],
+    }
diff --git a/tests/testdata/titles.csv b/tests/testdata/titles.csv
new file mode 100644
index 0000000000..6428dd2aa3
--- /dev/null
+++ b/tests/testdata/titles.csv
@@ -0,0 +1,4861 @@
+bhoj shala,1
+radhika balakrishnan,1
+ltm,1
+sterlite energy,1
+troll doll,11
+sonnontio,1
+nickelodeon netherlands kids choice awards,1
+jamaica national basketball team,5
+clan mackenzie,1
+secure attention key,3
+template talk indo pakistani war of 1971,1
+hassan firouzabadi,2
+carter alan,1
+alan levy,1
+tim severin,2
+faux pas derived from chinese pronunciation,1
+jruby,3
+tobias nielsén,1
+avro 571 buffalo,1
+treasury stock,17
+שלום,10
+oxygen 19,1
+ntru,4
+tennis racquet,1
+place of birth,4
+council of canadians,1
+urshu,1
+american hotel,1
+dow corning corporation,3
+language based learning disability,3
+meri aashiqui tum se hi,30
+specificity,9
+edward l hedden,1
+pelli chesukundam,2
+of love and shadows,4
+fort san felipe,2
+american express gold card dress of lizzy gardiner,4
+jovian,5
+kitashinagawa station,1
+radhi jaidi,1
+cordelia scaife may,2
+minor earth major sky,1
+bunty lawless stakes,1
+high capacity color barcode,3
+lyla lerrol,1
+crawford roberts,1
+collin balester,1
+ugo crousillat,1
+om prakash chautala,3
+izzy hoyland,1
+the poet,2
+daryl sabara,6
+aromatic acid,2
+reina sofia,1
+swierczek masovian voivodeship,1
+housing segregation in the united states,2
+karen maser,1
+scaptia beyonceae,2
+kitakyushu city,1
+htc desire 610,4
+dostoevsky,3
+portal victorian era,1
+bose–einstein correlations,3
+ralph hodgson,1
+racquet club,2
+walter camp man of the year,1
+australian movies,1
+k04he,1
+australia–india relations,2
+john william howard thompson,1
+pro cathedral,1
+paddyfield pipit,2
+book finance,1
+ford maverick,10
+slurve,4
+mnozil brass,2
+fiesta 9 1/8 inch square luncheon plate sunflower,1
+korsi,1
+draft 140th operations group,2
+camp,29
+series acceleration,1
+aljouf,1
+democratic party of new mexico,2
+united kingdom general election debates 2010,2
+madura strait,2
+back examination,1
+borgata,2
+il ritorno di tobia,3
+ovaphagous,1
+motörhead,9
+hellmaster,1
+richard keynes,1
+cryogenic treatment,3
+monte porzio,1
+transliteration of arabic,1
+anti catholic,2
+a very merry pooh year,2
+suffixes in hebrew,3
+barr body,16
+alaska constitution,1
+juan garrido,1
+yi lijun,1
+wawa inc,2
+endre kelemen,1
+l brands,18
+lr44,1
+coat of arms of the nagorno karabakh republic,1
+antonino fernandez,1
+salisbury roller girls,1
+zayat,2
+ian meadows,2
+semigalia,1
+khloe and lamar,2
+holding,1
+larchmont edgewater,1
+dynamic parcel distribution,6
+seaworld,30
+assistant secretary of war,1
+digital currency,14
+mazomanie wisconsin,1
+sujatha rangarajan,8
+street child,1
+anna sheehan,1
+violence jack,2
+santi solari,1
+template talk texas in the civil war,1
+colorss foundation,1
+faucaria,1
+alfred gardyne de chastelain,2
+tramp,1
+cannington ontario,2
+penguinone,1
+cardiac arrest,2
+summan grouper,1
+cyndis list,1
+cbs,2
+salminus brasiliensis,2
+kodiak bear,26
+cinemascore,9
+phragmidium,1
+city of vultures,1
+lawrence g romo,1
+chandni chowk to china,1
+scarp retreat,1
+rosses point,1
+carretera de cádiz,1
+chamunda,8
+battle of stalingrad,1
+who came first,2
+salome,5
+portuguese historical museum,3
+westfield sarasota square,1
+muehrckes nails,3
+kennebec north carolina,1
+american classical league,1
+how do you like them apples,1
+mark halperin,20
+circo,1
+turner classic movies,2
+australian rules football in sweden,1
+household silver,3
+frank baird,1
+escape from east berlin,2
+a village romeo and juliet,1
+wally nesbitt,6
+joseph renzulli,2
+spalding gray,1
+dangaria kandha,1
+pms asterisk,2
+openal,1
+romy haag,1
+mh message handling system,4
+pioneer 4,4
+hmcs stettler,1
+gangsta,10
+major third,4
+joan osbourn,1
+mount columbia,2
+active galactic nucleus,14
+robert clary,8
+eva pracht,1
+ion implantation,5
+rydell poepon,4
+baller blockin,2
+enfield chase railway station,1
+serge aurier,13
+florin vlaicu,1
+van diemens land,9
+krishnapur bagalkot,1
+oleksandr zinchenko,96
+collaborations,2
+hecla,2
+amber marshall,7
+inácio henrique de gouveia,1
+bronze age korea,1
+slc punk,5
+ryan jack,2
+clathrus ruber,6
+angel of death,4
+valentines park,1
+extra pyramidal,1
+kiami davael,1
+oleg i shuplyak,1
+nidum,2
+friendship of salem,2
+bèze,3
+arnold weinstock,1
+able,1
+s d ugamchand,1
+the omega glory,2
+ami james,3
+denmark at the 1968 summer olympics,1
+kill me again,1
+richmond town square,1
+guy domville,1
+jessica simpson,1
+kinship care,1
+brugge railway station,2
+unobtainium,16
+carl johan bernadotte,3
+acacia concinna,5
+epinomis,1
+interlachen country club,1
+compromise tariff,1
+fairchild jk,1
+dog trainer,1
+brian dabul,1
+cai yong,1
+jezebel,7
+augarten porcelain,1
+summerslam 1992,1
+ion andoni goikoetxea,2
+dominican church vienna,1
+iffhs worlds best club coach,2
+uruguayan presidential election 2009,2
+saving the queen,1
+un cadavre,1
+history of the jews in france,4
+wbyg,1
+charles de brosses,2
+human weapon,2
+haunted castle,3
+austin maestro,1
+search for extra terrestrial intelligence,1
+suwon,9
+cost per impression,1
+osney lock,1
+markus eriksson,1
+cultural depictions of tony blair,2
+erich kempka,3
+pornogrind,5
+chekhov,1
+marilinda garcia,2
+hard drive,1
+small arms,9
+exploration of north america,8
+international korfball federation,1
+photographic lens design,4
+k hari prasad,1
+lebanese forces,3
+greece at the 2004 summer olympics,1
+lets trim our hair in accordance with the socialist lifestyle,2
+battle of cassinga,5
+donald and the wheel,1
+vti transmission,1
+gille chlerig earl of mar,1
+heart of atlanta motel inc v united states,6
+oh yeah,3
+carol decker,5
+prajakta shukre,4
+profiling,17
+thukima,1
+the great waldo search,1
+nick vincent,2
+the decision of the appeals jury is final and can only be overruled by a decision of the executive committee 2e,1
+civilization board game,1
+erasmus+,1
+eden phillpotts,1
+unleash the beast,1
+varoujan hakhbandian,1
+fermats last theorem,1
+conan the indomitable,1
+vagrant records,1
+house of villehardouin,1
+zoneyesha ulatha,1
+ashur bel nisheshu,1
+ten wijngaerde,2
+lgi homes,1
+american nietzsche a history of an icon and his ideas,1
+european magpie,3
+pablo soto,1
+terminiello v chicago,1
+vladimir cosma,2
+battle of yunnan burma road,1
+ophirodexia,1
+thudar,1
+northern irish,2
+bohemond of tarente,1
+anita moorjani,5
+serra do gerês,1
+fort horsted,1
+metre gauge,2
+stage show,3
+common flexor sheath of hand,2
+conall corc,1
+array slicing,6
+schüfftan process,1
+anmol malik,3
+out cold,2
+antiknock,2
+moss force,1
+paul medhurst,1
+somonauk illinois,1
+george crum,11
+baby talk,6
+daniel mann,4
+vacuum flask,10
+prostitution in the republic of ireland,5
+butch jones,7
+feminism in ukraine,1
+st marys church kilmore county wexford,1
+sonny emory,1
+satsuma han,1
+elben,1
+the best of the rippingtons,3
+m3p,1
+boat sharing,1
+iisco,1
+hoftoren,1
+cannabis in the united kingdom,6
+template talk germany districts saxony anhalt,1
+jean baptiste dutrou bornier,1
+teylers museum,1
+simons problem,2
+gerardus huysmans,1
+pupillary distance,5
+jane lowe,1
+palais de justice brussels,1
+hillsdale free will baptist college,1
+raf wattisham,2
+parnataara,1
+jensen beach campus of the florida institute of technology,1
+scottish gypsy and traveller groups,3
+cliffs shaft mine museum,3
+roaring forties,4
+where in time is carmen sandiego?,2
+perfect field,1
+rob schamberger,1
+lcd soundsystem,10
+alan rathbone,26
+setup,1
+gliding over all,4
+dastur,1
+flensburger brauerei,3
+berkeley global campus at richmond bay,1
+kanakapura,1
+mineworkers union of namibia,1
+tokneneng,3
+mapuche textiles,3
+peranakan beaded slippers,1
+goodra,2
+kanab ut,1
+the gold act 1968,4
+grey langur,1
+procol harum,5
+chris alexander,1
+ft walton beach metropolitan area,3
+dimensionless quantity,16
+the science of mind,1
+alfons schone,1
+euparthenos nubilis,1
+batrachotoxin,5
+fabric live 22,1
+mchenry boatwright,1
+langney sports club,1
+akela jones,1
+lookout,2
+matsuo tsurayaba,2
+general jackson,3
+hair removal,14
+african party for the independence of cape verde,4
+replica trick,1
+bromfenac,2
+make someone happy,1
+sam pancake,1
+denys finch hatton,10
+latin rhythm albums,1
+main bronchus,1
+campidoglio,4
+cathaoirleach,1
+emress justina,1
+sulzbach hesse,1
+noncicatricial alopecia,1
+sylvan place,4
+stalag i c,1
+league of extraordinary gentlemen,1
+sergey korolyov,2
+serbian presidential election 1997,1
+barnes lake millers lake michigan,1
+christmas island health centre,1
+dayton ballet,2
+gilles fauconnier,1
+harald svergja,1
+joanna newsom discography,2
+astro xi yue hd,1
+code sharing,3
+dreamcast vmu,1
+armand emmanuel du plessis duc de richelieu,1
+ecole supérieure des arts du cirque,2
+gerry mulligan,12
+kaaka kaaka,1
+mexico at the 2012 summer olympics,4
+bar wizards,2
+christmas is almost here again,2
+sterling heights michigan,4
+gaultheria procumbens,3
+eben etzebeth,8
+viktorija Čmilytė,1
+los angeles county california,39
+family entertainment,2
+quantum well,9
+elton,1
+allan frewin jones,1
+daniela ruah,32
+gkd legend,1
+coffman–graham algorithm,1
+santa clara durango,1
+brian protheroe,3
+crawler transporter,10
+lakshman,3
+fes el bali,2
+mary a krupsak,1
+irish rugby football union,5
+neuropsychiatry,2
+josé pirela,1
+bonaire status referendum 2015,1
+it,2
+playhouse in the park,1
+alexander yakovlev,7
+old bear,1
+graph tool,2
+merseyside west,1
+romanian armies in the battle of stalingrad,1
+dark they were and golden eyed,1
+aidan obrien,8
+town and davis,1
+suum cuique,3
+german american day,2
+northampton county pennsylvania,3
+candidates of the south australian state election 2010,1
+venator marginatus,2
+k60an,1
+template talk campaignbox seven years war european,1
+maravi,1
+flaithbertach ua néill,1
+junction ohio,1
+dave walter,1
+london transport board,1
+tuyuka,1
+the moodys,3
+noel,3
+eugen richter,1
+cowanshannock township armstrong county pennsylvania,1
+pre columbian gold museum,1
+lac demosson,1
+lincosamides,9
+the vegas connection,1
+stephen e harris,1
+alkali feldspar,2
+brant hansen,1
+draft carnatic music stub,4
+the chemicals between us,1
+blood and bravery,1
+san diego flash,3
+covert channel,5
+ernest w adams,1
+hills brothers coffee,1
+cosmic background explorer,4
+international union of pure and applied physics,2
+vladimir kramnik,21
+hinterland,2
+tinker bell and the legend of the neverbeast,5
+ophisops jerdonii,1
+fine gold,1
+net explosive quantity,3
+miss colorado teen usa,3
+royal philharmonic orchestra discography,1
+elyazid maddour,1
+matthew kelly,2
+templating language,1
+japan campaign,2
+barack obama on mass surveillance,2
+thomas r donahue,1
+old right,4
+spencer kimball,1
+golden kela awards,1
+blinn college,3
+w k simms,1
+quinto romano,1
+richard mulrooney,1
+mr backup z64,1
+monetization of us in kind food aid,1
+alex chilton,2
+propaganda in the peoples republic of china,4
+jiří skalák,8
+m5 stuart tank,1
+template talk ap defensive players of the year,1
+crisis,2
+azuchi momoyama period,1
+care and maintenance,2
+a$ap mob,3
+near field communication,111
+hips hips hooray,1
+promotional cd,1
+andean hairy armadillo,1
+trigueros del valle,1
+elmwood illinois,1
+cantonment florida,2
+margo t oge,1
+national park service,36
+monongalia county ballpark,3
+bakemonogatari,6
+felicia michaels,1
+institute of oriental studies of the russian academy of sciences,2
+economy of eritrea,2
+vincenzo chiarenza,1
+microelectronics,4
+fresno state bulldogs mens basketball,1
+maotou,1
+blokely,1
+duplicati,3
+goud,2
+niki reiser,1
+edward leonard ellington,1
+jaswant singh of marwar,1
+biharsharif,1
+dynasty /trackback/,1
+machrihanish,4
+jay steinberg,1
+peter luger steak house,3
+palookaville,1
+ferrari grand prix results,2
+bankruptcy discharge,2
+mike mccue,2
+nuestra belleza méxico 2013,2
+alex neal bullen,1
+gus macdonald baron macdonald of tradeston,2
+florida circuit court,1
+haarp,2
+v pudur block,1
+grocer,1
+shmuel hanavi,1
+isaqueena falls,2
+jean moulin university,1
+final fantasy collection,1
+template talk american frontier,1
+chex quest,4
+muslim students association,2
+marco pique,1
+jinja safari,1
+the collection,9
+urban districts of germany,5
+rajiv chilaka,1
+zion,2
+vf 32,1
+united states commission on civil rights,2
+zazam,1
+barnettas,4
+rebecca blasband,1
+lincoln village,1
+film soundtracks,1
+angus t jones,77
+snuppy,3
+w/indexphp,30
+file talk american world war ii senior military officials 1945jpeg,1
+worship leader,1
+ein qiniya,1
+buxton maine,1
+matt dewitt,1
+béla bollobás,3
+earlysville union church,1
+bae/mcdonnell douglas harrier ii gr9,1
+californian condor,2
+progressive enhancement,15
+its not my time,4
+ecw on tnn,2
+ihop,36
+aeronautical chart,1
+clique width,1
+fuengirola,8
+archicebus achilles,2
+comparison of alcopops,1
+carla anderson hills,1
+roanoke county virginia,2
+jaílson alves dos santos,1
+rameses revenge,1
+kaycee stroh,5
+les experts,1
+niels skousen,1
+apollo hoax theories,1
+mercedes w204,2
+enhanced mitigation experience toolkit,15
+bert barnes,1
+serializability,6
+ten plagues of egypt,1
+joe l brown,1
+category talk high importance chicago bears articles,1
+stephen caffrey,3
+european border surveillance system,2
+achytonix,1
+m2 machine gun,1
+gurieli,1
+kunefe,1
+m33 helmet,3
+little carmine,1
+smush,3
+josé horacio gómez,1
+product recall,1
+egger,1
+wisconsin highway 55,1
+harbledown,1
+low copy repeats,1
+curt gentry,1
+united colors of benetton,1
+adiabatic shear band,2
+pea galaxy,1
+where are you now,1
+dils,1
+surprise s1,1
+senate oceans caucus,2
+windsor new hampshire,1
+a hawk and a hacksaw,1
+i love it loud,2
+milbcom,1
+old world vulture,7
+camara v municipal court of city and county of san francisco,1
+ski dubai,1
+st cyprians school,2
+aibo,1
+ticker symbol,2
+hendrik houthakker,1
+shivering,5
+jacob arminius,1
+mowming,1
+panjiva,2
+namco libble rabble,5
+rudolph bing,1
+sindhi cap,2
+logician,1
+ford xa falcon,2
+the sunny side up show,1
+helen adams,2
+kharchin,1
+brittany maynard,13
+kim kyu jong,1
+messier 103,3
+leon boiler,1
+the rapeman,1
+twa flight 3,4
+leading ladies,1
+delta octantis,2
+qatari nationality law,1
+lionel cripps,1
+josé daniel carreño,1
+crypsotidia longicosta,1
+polish falcons,1
+highlands north gauteng,1
+the florida channel,1
+oreste barale,1
+ghazi of iraq,2
+charles grandison finney,4
+ahmet ali,1
+abbeytown,1
+caribou,3
+big two,2
+alien,14
+aslantaş dam,3
+theme of the traitor and the hero,1
+vladimir solovyov,1
+laguna ojo de liebre,1
+clive barton,1
+ebrahim daoud nonoo,1
+richard goodwin keats,2
+back to the who tour 51,1
+entertainmentwise,1
+ja preston,1
+john astin,19
+strict function,1
+cam ranh international airport,2
+gary pearson,1
+sven väth,8
+toad,6
+johnny pace,1
+hunt stockwell,1
+rolando schiavi,1
+claudia grassl,1
+oxford nova scotia,1
+maryland sheep and wool festival,1
+conquest of bread,1
+erevan,1
+comparison of islamic and jewish dietary laws,11
+sheila burnford,1
+estevan payan,1
+ocean butterflies international,7
+the royal winnipeg rifles,1
+green goblin in other media,2
+video gaming in japan,8
+church of the guanche people,4
+gustav hartlaub,2
+ian mcgeechan,4
+hammer and sickle,17
+konkiep river,1
+ceri richards,1
+decentralized,2
+depth psychology,3
+centennial parkway,1
+yugoslav monitor vardar,1
+battle of bobbili,2
+magnus iii of sweden,1
+england c national football team,2
+thuraakunu,1
+bab el ehr,1
+koi,1
+cully wilson,1
+money laundering,1
+stirling western australia,1
+jennifer dinoia,1
+eureka street,1
+message / call my name,1
+make in maharashtra,4
+huckleberry creek patrol cabin,1
+almost famous,5
+truck nuts,4
+vocus communications,1
+gikwik,1
+battle of bataan,4
+confluence pennsylvania,2
+islander 23,1
+mv skorpios ii,1
+single wire earth return,1
+politics of odisha,1
+crédit du nord,3
+piper methysticum,2
+coble,2
+kathleen a mattea,1
+coachella valley music and arts festival,50
+tooniverse,1
+spofforth castle,1
+arabian knight,2
+two airlines policy,1
+hinduja group,17
+swagg alabama,1
+portuguese profanity,1
+loomis gang,2
+nina veselova,2
+aegyrcitherium,1
+bees in paradise,1
+béládys anomaly,3
+badalte rishtey,1
+first bank fc,1
+cystoseira,1
+red book of endangered languages,1
+rose,6
+terry mcgurrin,3
+jason hawke,1
+peter chernin,1
+tu 204,1
+the man who walked alone,1
+tool grade steel,1
+wrist spin,1
+one step forward two steps back,1
+theodor boveri,1
+heunginjimun,1
+fama–french three factor model,34
+billy whitehurst,1
+rip it up,4
+red lorry yellow lorry,4
+nao tōyama,8
+general macarthur,1
+rabi oscillation,2
+devín,1
+olympus e 420,1
+hydra entertainment,1
+chris cheney,3
+rio all suite hotel and casino,3
+the death gate cycle,2
+fatima,1
+kamomioya shrine,1
+five nights at freddys 3,14
+the broom of the system,3
+robert blincoe,1
+history of wells fargo,9
+pinocytosis,4
+leaf phoenix,1
+wxmw,2
+tommy henriksen,13
+geri halliwell discography,2
+blade runneri have seen things you would not believe,1
+madhwa brahmins,1
+i/o ventures,1
+edorisi master ekhosuehi,2
+junior orange bowl,1
+khit,2
+sue jones,1
+immortalized,35
+city building series,4
+quran translation,1
+united states consulate,1
+dose response relationship,1
+caitriona,1
+colocolo,21
+medea class destroyer,1
+vaastav,1
+etc1,1
+john altoon,2
+thylacine,113
+cycling at the 1924 summer olympics,1
+margaret nagle,1
+superpower,57
+gülşen,1
+anthems to the welkin at dusk,4
+yerevan united fc,1
+the family fang,14
+domain,4
+high speed rail in india,14
+trifolium pratense,7
+florida mountains,2
+national city corp,5
+length of us participation in major wars,2
+acacia acanthoclada,1
+offas dyke path,2
+enduro,7
+howard center,1
+littlebits,4
+plácido domingo jr,1
+hookdale illinois,1
+the love language,1
+cupids arrows,1
+dc talk,7
+maesopsis eminii,1
+here comes goodbye,1
+freddie foreman,5
+marvel comics publishers,1
+consolidated city–county,5
+countess marianne bernadotte of wisborg,1
+los angeles baptist high school,1
+maglalatik,1
+deo,2
+meilichiu,1
+wade coleman,1
+monster soul,2
+julion alvarez,2
+platinum 166,1
+shark week,12
+hossbach memorandum,4
+jack c massey,3
+ardore,1
+philosopher king,5
+dynamic random access memory,5
+bronze age in southeastern europe,1
+tamil films of 2012,1
+nathalie cely,1
+italian capital,1
+optic tract,3
+shakti kumar,1
+who killed bruce lee,1
+parlement of brittany,3
+san juan national historic site,2
+livewell,2
+template talk om,1
+al bell,2
+pzl w 3 sokół,8
+durrës rail station,3
+david stubbs,1
+pharmacon,3
+railfan,7
+comics by country,2
+cullen baker,1
+maximum subarray problem,19
+outlaws and angels,1
+paradise falls,2
+mathias pogba,28
+donella meadows,4
+john leconte,2
+swaziland national football team,7
+gabriele detti,2
+if ever youre in my arms again,1
+christian basso,1
+helen shapiro,7
+taisha abelar,1
+fluid dynamics,1
+ernest wilberforce,1
+kocaeli university,2
+british m class submarine,1
+modern woodmen of america,1
+las posadas,3
+federal budget of germany,2
+liberation front of chad,1
+sandomierz,5
+ap italian language and culture,1
+manuel gonzález,1
+georgian military road,2
+clear creek county colorado,1
+matt clark,2
+test tube,18
+ak 47,1
+diège,1
+london school of economics+,1
+michael york,14
+half eagle,6
+strike force,1
+type 054 frigate,2
+sino indian relations,7
+fern,3
+louvencourt,1
+ghb receptor,2
+chondrolaryngoplasty,2
+andrew lewer,1
+ross king,1
+colpix records,1
+october 28,1
+tatsunori hara,1
+rossana lópez león,1
+haskell texas,3
+tower subway,2
+waspstrumental,1
+template talk nba anniversary teams,1
+george leo leech,1
+still nothing moves you,1
+blood cancer,3
+buffy lynne williams,1
+dpgc u know what im throwin up,1
+daniel nadler,1
+khalifa sankaré,2
+homo genus,1
+garðar thór cortes,3
+veyyil,1
+matt dodge,1
+hipponix subrufus,1
+anostraca,1
+hartshill park,1
+purple acid phosphatases,1
+austromyrtus dulcis,1
+shamirpet lake,1
+favila of asturias,2
+acute gastroenteritis,1
+dalton cache pleasant camp border crossing,1
+urobilinogen,13
+ss kawartha park,1
+professional chess association,1
+species extinction,1
+gapa hele bi sata,1
+phyllis lyon and del martin,1
+uk–us extradition treaty of 2003,1
+a woman killed with kindness,1
+how bizarre,1
+norm augustine,1
+geil,1
+volleyball at the 2015 southeast asian games,2
+jim ottaviani,1
+chekmagushevskiy district,1
+information search process,2
+queer,63
+william pidgeon,1
+amelia adamo,1
+nato ouvrage "g",1
+tamsin beaumont,1
+economy of syria,13
+douglas dc 8 20,1
+tama and friends,4
+pringles,22
+kannada grammar,7
+lotoja,1
+peony,1
+bmmi,1
+eurovision song contest 1992,11
+cerro blanco metro station,1
+sherlock the riddle of the crown jewels,4
+dorsa cato,1
+nkg2d,8
+specific heat,6
+nokia 6310i,2
+tergum,2
+bahai temple,1
+dal segno,5
+leigh chapman,2
+tupolev tu 144,60
+flight of ideas,1
+rita montaner,1
+vivien a schmidt,1
+battle of the treasury islands,2
+three kinds of evil destination,1
+richlite,1
+medinilla,2
+timeline of aids,1
+colin renfrew baron renfrew of kaimsthorn,2
+hélène rollès,1
+pedro winter,1
+sabine free state,1
+brzeg,1
+palisades park,1
+gas gangrene,11
+dotyk,2
+daniela kix,1
+canna,16
+property list,9
+john hamburg,1
+dunk island,5
+albreda,1
+scammed yankees,1
+wireball,3
+junior 4,1
+absolutely anything,15
+linux operating system,1
+solsbury hill,15
+notopholia,1
+scottish heraldry,2
+template talk paper data storage media,1
+category talk religion in ancient sparta,1
+category talk cancer deaths in puerto rico,1
+mid michigan community college,2
+tvb anniversary awards,1
+frederick taylor gates,1
+omoiyari yosan,3
+journal of the physical society of japan,1
+kings in the corner,2
+nungua,1
+amerika,4
+pacific marine environmental laboratory,1
+the thought exchange,1
+italian bee,5
+roma in spain,1
+sirinart,1
+crandon wisconsin,1
+shubnikov–de haas effect,6
+portrait of maria portinari,4
+colin mcmanus,1
+universal personal telecommunications,1
+royal docks,4
+brecon and radnorshire,3
+eilema caledonica,1
+chalon sur saône,8
+toyota grand hiace,1
+sophorose,1
+semirefined 2bwax,1
+mechanics institute chess club,1
+the culture high,2
+dont wake me up,1
+transcaucasian mole vole,1
+harry zvi tabor,1
+vhs assault rifle,1
+playing possum,2
+omar minaya,2
+private university,1
+yuki togashi,3
+ski free,2
+say no more,1
+diving at the 1999 summer universiade,1
+armando sosa peña,1
+timur tekkal,1
+jura elektroapparate,1
+pornographic magazine,1
+tukur yusuf buratai,1
+keep on moving,1
+laboulbeniomycetes,1
+chiropractor solve problems,1
+mark s allen,3
+committees of the european parliament,4
+blondie,7
+veblungsnes,1
+bank vault,10
+smiling irish eyes,1
+robert kalina,2
+polarization ellipse,2
+huntingdon priory,1
+energy in the united kingdom,34
+hamble,1
+raja sikander zaman,1
+perigea hippia,1
+college of liberal arts and sciences,1
+bootblock,1
+nato reporting names,2
+the serpentwar saga,1
+reformed churches in the netherlands,1
+collaborative document review,4
+combat mission beyond overlord,3
+vlra,2
+pat st john,1
+oceanid,5
+itapetinga,1
+insane championship wrestling,9
+nathaniel gorham,1
+estadio metropolitano de fútbol de lara,2
+william of saint amour,2
+new york drama critics circle award,1
+alliant rq 6 outrider,2
+ilsan,1
+top model po russki,1
+woolens,1
+rutledge minnesota,1
+joigny coach crash,2
+zhou enlai the last perfect revolutionary,1
+the theoretical minimum,1
+arrow security,1
+john shelton wilder,2
+jasdf,2
+katie may,2
+american jewish military history project,1
+business professionals of america,1
+questioned document examination,5
+motorola a760,1
+american steel & wire,1
+louis armstrong at the crescendo vol 1,1
+edward vernon,3
+maria taipaleenmäki,1
+margical history tour,2
+jar jar,1
+australian oxford dictionary,2
+revenue service,2
+odoardo farnese hereditary prince of parma,1
+weekend in new england,1
+laurence harbor new jersey,2
+aramark tower,1
+stealers wheel,1
+cephalon,1
+dawnguard,1
+saintsbury,2
+saint fuscien,1
+ryoko kuninaka,1
+farm to market road 1535,1
+alan kennedy,2
+esteban casagolda,1
+shin angyo onshi,1
+william gowland,1
+eastern religions,6
+kenny lala,1
+alphonso davies,1
+tadamasa hayashi,1
+meet the parents,2
+calvinist church,1
+ristorante paradiso,1
+jose joaquim champalimaud,1
+olis,1
+mill hill school,2
+lockroy,1
+battle of princeton,10
+cent,8
+brough superior ss80,1
+ras al khaima club,3
+washington international university,3
+bradley kasal,2
+miguel Ángel varvello,1
+oxygen permeability,1
+femoral circumflex artery,1
+golden sun dark dawn,4
+pusarla sindhu,1
+toyota winglet,1
+wind profiler,1
+montefiore medical center,2
+template talk guitar hero series,3
+little leaf linden,1
+ramana,4
+islam in the czech republic,2
+manuel vitorino,1
+joseph radetzky von radetz,3
+francois damiens,1
+parasite fighter,1
+friday night at st andrews,3
+hurbazum,1
+haidhausen,1
+petabox,2
+salmonella enteritidis,2
+matthew r denver,1
+de la salle,1
+anti terrorism act 2015,6
+brugsen,1
+mountain times,1
+columbia basin project,1
+common wallaroo,2
+clepsis brunneograpta,1
+red hot + dance,1
+mao fumei,1
+dark shrew,1
+coach,8
+come saturday morning,1
+aanmai thavarael,1
+hellenia,1
+donate life america,2
+plot of beauty and the beast toronto musical,1
+births in 1243,3
+main page/wiki/portal technology,8
+cambridgeshire archives and local studies,1
+big pines california,1
+pegasus in popular culture,4
+baron glendonbrook,1
+your face sounds familiar,5
+boom tube,2
+richard gough,8
+the new beginning in niigata,3
+american academy of health physics,1
+plain,9
+tushino airfield,1
+king george v coronation medal,1
+geologic overpressure,1
+seille,1
+calorimeter,25
+french civil service,1
+david l paterson,1
+chinese gunboat chung shan,2
+rhizobium inoculants,1
+wizard,4
+baghestan,1
+paustian house,2
+ellen pompeo,55
+damien williams,1
+tomoe tamiyasu,1
+acute epithelial keratitis,1
+casey abrams,8
+mendozite,1
+kantian ethics,2
+mcclure syndicate,1
+tokyo metro,6
+cuisine of guinea bissau,1
+mossberg 500,18
+mollie gillen,1
+above and beyond party,1
+joey carbone,1
+faulkner state community college,1
+tetsuya ishikawa,1
+electric flag,3
+meet the feebles,2
+kplm,1
+when we were twenty one,1
+horus bird,2
+youth in revolt,8
+spongebob squarepants revenge of the flying dutchman,3
+ehow,5
+nikos xydakis,2
+ziprasidone,19
+ulsan airport,1
+flechtingen,1
+dave christian,3
+delaware national guard,1
+skaria thomas,1
+iraca,1
+kkhi,2
+swimming at the 2015 world aquatics championships – mens 1500 metre freestyle,2
+crossing lines,37
+john du cane,1
+i8,1
+bauer pottery,1
+affinity sutton,4
+lotus 119,1
+uss arleigh burke,1
+palmar interossei,2
+nofx discography,4
+bwia west indies airways,3
+gopala ii,1
+north fork correctional facility,1
+szeged 2011,1
+milligram per cent,2
+halas and batchelor,1
+what the day owes the night,1
+sighișoara medieval festival,5
+scarning railway station,1
+cambridge hospital,1
+amnesia labyrinth,2
+cokie roberts,7
+savings identity,3
+pravia,1
+mcgrath,4
+pakistan boy scouts association,1
+dan carpenter,2
+marikina–infanta highway,2
+genetic analysis,2
+template talk ohio state university,1
+thomas chamberlain,4
+moe book,1
+coyote waits,1
+black protestant,1
+neetu singh,19
+mahmoud sarsak,1
+casa loma,28
+bedivere,8
+boundary park,2
+danger danger,14
+jennifer coolidge,49
+pop ya collar,1
+collaboration with the axis powers during world war ii,10
+greenskeepers,1
+the dukes children,1
+alaska off road warriors,1
+twenty five satang coin,1
+template talk private equity investors,2
+american red cross,24
+jason shepherd,1
+georgetown college,2
+ocean countess,1
+ammonium magnesium phosphate,1
+community supported agriculture,5
+philosophy of suicide,4
+yard ramp,2
+captain germany,1
+bob klapisch,1
+i will never let you down,2
+february 11,6
+ron dennis,13
+rancid,16
+the mall blackburn,1
+south high school,6
+charles allen culberson,1
+organizational behavior,66
+automatic route selection,1
+uss the sullivans,9
+yo no creo en los hombres,1
+janet,1
+serena armstrong jones viscountess linley,3
+louisiana–lafayette ragin cajuns mens basketball,1
+flower films,1
+michelle ellsworth,1
+norbertine rite,2
+spanish mump,1
+shah jahan,67
+fraser coast region,1
+matt cornwell,1
+nra,1
+crested butte mountain resort,1
+college football playoff national championship,2
+craig heaney,4
+devil weed,1
+satsuki sho,1
+jordaan brown,1
+little annie,4
+thiha htet aung,1
+the disreputable history of frankie landau banks,1
+mickey lewis,1
+eldar nizamutdinov,1
+m1825 forage cap,1
+antonina makarova,1
+mopani district municipality,2
+al jahra sc,1
+chaim topol,4
+tum saath ho jab apne,1
+piff the magic dragon,7
+imagining argentina,1
+ni 62,1
+phys rev lett,1
+the peoples political party,1
+casoto,1
+popular movement of the revolution,4
+huntingtown maryland,1
+la bohème,33
+khirbat al jawfa,1
+lycksele zoo,1
+deveti krug,2
+cuba at the 2000 summer olympics,2
+rose wilson,7
+sammy lee,2
+dave sheridan,10
+universal records,2
+antiquities trade,3
+shoveller,1
+tapered integration,1
+parker pen company,4
+mushahid hussain syed,1
+nynehead,1
+counter reformation,2
+nhl on nbc,11
+ronny rosenthal,2
+arsenie todiraş,3
+lobster random,1
+halliburton,37
+gordon county georgia,1
+belle isle florida,3
+molly stanton,3
+green crombec,1
+geodesist,2
+abd al rahman al sufi,4
+demography of japan,26
+live xxx tv,5
+naihanchi,1
+cofinite,1
+msnbot,5
+clausard,1
+mimidae,1
+wind direction,15
+irrational winding of a torus,1
+tursiops truncatus,1
+trustee,1
+lumacaftor/ivacaftor,2
+balancing lake,2
+shoe trees,1
+cycling at the 1928 summer olympics – mens team pursuit,1
+calponia harrisonfordi,1
+hindu rate of growth,1
+dee gordon,7
+passion white flag,2
+frog skin,1
+rudolf eucken,2
+bayantal govisümber,1
+christopher a iannella,1
+robert myers,1
+james simons,1
+meng xuenong,1
+abayomi olonisakin,1
+milton wynants,1
+cincinnatus powell,1
+atomic bomb band,1
+hopfield network,12
+jet pocket top must,1
+the state of the world,1
+welf i duke of bavaria,2
+american civil liberties union v national security agency,3
+elizabeth fedde,1
+librarything,2
+kim fletcher,1
+tracy island,2
+praise song for the day,1
+superstar,7
+ewen spencer,1
+back striped weasel,1
+cs concordia chiajna,1
+bruce curry,1
+malificent,1
+dr b r ambedkar university,2
+river plate,1
+desha county arkansas,1
+harare declaration,2
+patrick dehornoy,1
+paul alan cox,2
+auckland mounted rifles regiment,1
+mikoyan gurevich dis,3
+corn exchange manchester,2
+sharpshooter,1
+the new york times manga best sellers of 2013,1
+max perutz,2
+andrei makolov,1
+inazuma eleven saikyō gundan Ōga shūrai,2
+tatra 816,1
+ashwin sanghi,8
+pipestone township michigan,1
+craig shoemaker,1
+david bateson,1
+lew lehr,1
+crewe to manchester line,2
+samurai champloo,36
+tali ploskov,2
+janet sobel,3
+kabe station,1
+rippon,1
+alexander iii equestrian,1
+louban,2
+the twelfth night,1
+delaware state forest,1
+the amazing race china 3,1
+brillouins theorem,1
+extreme north,3
+super frelon,1
+george watsons,1
+mungo park,1
+workin together,3
+boy,12
+brownsville toros,1
+kim lim,1
+futsal,63
+motoring taxation in the united kingdom,1
+accelerator physics codes,1
+arytenoid cartilage,3
+the price of beauty,3
+life on the murder scene,2
+hydrophysa psyllalis,1
+jürgen brandt,2
+economic history association,2
+the sandwich girl,1
+heber macmahon,1
+volume 1 sound magic,2
+san francisco–oakland–hayward ca metropolitan statistical area,9
+harriet green,7
+tarnawa kolonia,1
+eur1 movement certificate,20
+anna nolan,2
+gulf of gökova,1
+havertown,2
+orlando scandrick,4
+doug owston correctional centre,1
+asterionella,4
+espostoa,1
+ranked voting system,10
+commercial law,39
+kirk,1
+mongolian cuisine,8
+turfanosuchus,1
+arthur anderson,4
+sven olof lindholm,1
+batherton,1
+dimetrodon,1
+pianos become the teeth,1
+united kingdom in the eurovision song contest 1976,1
+medieval,11
+it bites,1
+ion television,8
+seaboard system railroad,3
+sayan mountains,3
+musaffah,1
+charles de foucauld,3
+urgh a music war,1
+translit,1
+american revolutionary war/article from the 1911 encyclopedia part 1,1
+uss mauna kea,1
+powder burn,1
+bald faced hornet,9
+producer of the year,1
+the most wanted man,1
+clear history,8
+mikael lilius,1
+class invariant,4
+forever michael,3
+goofing off,3
+tower viewer,3
+claudiu marin,1
+nicolas cage,1
+waol,2
+s10 nbc respirator,2
+education outreach,1
+gyeongsan,2
+template talk saints2008draftpicks,1
+botaurus,1
+francis harper,1
+mauritanian general election 1971,1
+kirsty roper,2
+non steroidal anti inflammatory drug,17
+nearchus of elea,2
+resistance to antiviral drugs,1
+raghavendra rajkumar,5
+template talk cc sa/sandbox,1
+washington gubernatorial election 2012,2
+paul lovens,1
+express freighters australia,2
+bunny bleu,2
+osaka prefecture,2
+federal reserve bank of boston,4
+hacı ahmet,1
+underground chapter 1,10
+filippo simeoni,2
+the wonderful wizard of oz,3
+sailing away,1
+avelino gomez memorial award,1
+badger,65
+hongkou football stadium,3
+benjamin f cheatham,2
+fair isaac,2
+kwab,1
+al hank aaron award,3
+gender in dutch grammar,1
+idiom neutral,2
+da lata,1
+tuu languages,1
+derivations are used,1
+clete patterson,1
+danish folklore,4
+android app //orgwikipedia/http/enmwikipediaorg/wiki/westfield academy,1
+toto,8
+ea,1
+victory bond tour,1
+credai,2
+hérin,1
+st james louisiana,1
+necrolestes,2
+cable knit,1
+saunderstown,1
+us route 52 in ohio,1
+sailors rest tennessee,1
+adlai stevenson i,6
+miscibility,13
+help footnotes,13
+murrell belanger,1
+new holland pennsylvania,5
+haldanodon,1
+feminine psychology,2
+riot city wrestling,1
+mobile content management system,2
+zinio,1
+central differencing scheme,2
+enoch,2
+usp florence admax,1
+maester aemon,7
+norman "lechero" st john,1
+ice racing,1
+tiger cub economies,6
+klaipėda region,12
+wu qian,8
+malayalam films of 1987,1
+estadio nuevo la victoria,1
+nanotoxicology,2
+hot revolver,1
+nives ivankovic,1
+glen edward rogers,5
+epicene,3
+eochaid ailtlethan,1
+judiciary of finland,1
+en jersey,1
+statc,1
+atta kim,1
+mizi research,2
+acs applied materials & interfaces,1
+thank god youre here,9
+loneliness,8
+h e b plus,2
+corella bohol,1
+money in the bank,59
+golden circle air t bird,1
+flash forward,1
+category talk philippine television series by network,1
+dfmda,1
+the road to wellville,8
+ernst tüscher,1
+commission,14
+abdul rahman bin faisal,6
+oversea chinese banking corporation,7
+ray malavasi,1
+al qadisiyah fc,4
+anisfield wolf book award,1
+jacques van rees,1
+jakki tha motamouth,1
+scoop,1
+piti,2
+carlos reyes,1
+v o chidambaram pillai,6
+diamonds sparkle,1
+the great transformation,5
+cardston alberta temple,1
+la vendetta,1
+miyota nagano,1
+national shrine of st elizabeth ann seton,2
+chaotic,1
+breastfeeding and hiv,1
+friedemann schulz von thun,1
+mukhammas,2
+fishbowl worldwide media,1
+mohamed amin,3
+john densmore,10
+suryadevara nayaks,1
+metal gear solid peace walker,12
+ché café,2
+old growth,1
+lake view cemetery,1
+konigsberg class cruiser,1
+courts of law,1
+nova scotia peninsula,3
+jairam ramesh,4
+portal kerala/introduction,1
+edinburgh 50 000 – the final push,1
+ludachristmas,3
+motion blur,1
+deliberative process privilege,2
+bubblegram,1
+simon breach grenade,2
+tess henley,1
+gojinjo daiko,1
+common support aircraft,2
+zelda rubinstein,9
+yolanda kakabadse,1
+american studio woodturning movement,1
+richard carpenter,67
+vehicle door,3
+transmission system operator,9
+christa campbell,9
+marolles en brie,1
+korsholma castle,1
+murder of annie le,3
+kims,1
+zionist union,8
+portal current events/june 2004,2
+marination,8
+cap haïtien international airport,2
+fujima kansai,1
+vampire weekend discography,3
+moncton coliseum,2
+wing chair,1
+el laco,2
+castle fraser,1
+template talk greek political parties,1
+society finch,1
+chief executive officer,4
+battle of bloody run,3
+coat of arms of tunisia,2
+nishi kawaguchi station,1
+colonoscopy,30
+vic tayback,5
+lonnie mack discography,3
+yusuf salman yusuf,2
+marco simone,4
+saint just,1
+elizabeth taylor filmography,6
+haglöfs,2
+yunis al astal,1
+daymond john,36
+bedd y cawr hillfort,1
+durjoy datta,1
+wealtheow,1
+aaron mceneff,1
+culture in berlin,1
+temple of saturn,6
+nermin zolotić,1
+the darwin awards,1
+patricio pérez,1
+chris levine,1
+misanthropic,1
+dragster,2
+eldar,19
+chrzanowo gmina szelków,1
+zimmerberg base tunnel,6
+jakob schaffner,1
+california gubernatorial recall election 2003,1
+tommy moe,1
+bikrami calendar,1
+mama said,11
+hellenic armed forces,8
+candy box,3
+monstervision,3
+kachin independent army,1
+pro choice,1
+tshiluba language,1
+trucial states,9
+collana,1
+best music video short form,1
+pokémon +giratina+and+the+sky+warrior,1
+etteldorf,1
+academic grading in chile,2
+land and liberty,3
+australian bureau of meteorology,1
+cheoin gu,1
+william henry green,1
+ewsd,2
+gate of hell,1
+sioux falls regional airport,3
+nevelj zsenit,1
+bevo lebourveau,1
+ranjana ami ar asbona,1
+shaun fleming,1
+jean antoine siméon fort,1
+sports book,1
+vedran smailović,3
+simple harmonic motion,29
+wikipedia talk wikiproject film/archive 16,1
+princess jasmine,13
+great bustard,5
+allred unit,1
+cheng san,1
+mini paceman,1
+flavoprotein,2
+storage wars canada,3
+university rowing,2
+category talk wikiproject saskatchewan communities,1
+the washington sun,1
+rotary dial,6
+hailar district,1
+assistant secretary of the air force,2
+the décoration for the yellow house,5
+chris mclennan,1
+the cincinnati kid,4
+education in the republic of ireland,15
+steve brodie,2
+country club of detroit,1
+wazner,1
+portal spain,4
+senna,3
+william j bernd house,1
+balaji baji rao,8
+worth dying for,1
+cool ruler,1
+turn your lights down low,2
+mavroudis bougaidis,1
+national registry emergency medical technician,1
+james young,8
+eyewire,1
+dark matters twisted but true/,1
+josé pascual monzo,1
+german election 1928,2
+linton vassell,1
+convention on the participation of foreigners in public life at local level,1
+thorium fuel cycle,5
+honeybaby honeybaby,1
+golestan palace,3
+lombok international airport,11
+mainichi daily news,1
+k&p,1
+liberal network for latin america,1
+cádiz memorial,1
+grupo corripio,1
+elie and earlsferry,1
+isidore geoffroy saint hilaire,1
+al salmiya sc,2
+piano sonata hob xvi/33,1
+e f bleiler,1
+national register of historic places listings in york county virginia,3
+gupta empire,2
+german immigration to the united states,1
+through gates of splendor,2
+iap,1
+love takes wing,1
+tours de merle,1
+aleksey zelensky,1
+paul almond,2
+boston cambridge quincy ma nh metropolitan statistical area,1
+komiks presents dragonna,1
+princess victoire of france,1
+alan pownall,3
+tilak nagar,2
+lg life sciences co ltd,8
+before their eyes,1
+labor right,5
+michiko to hatchin,1
+susan p graber,1
+xii,1
+hanswulf,1
+symbol rate,17
+myo18b,2
+rowing at the 2010 asian games – mens coxed eight,1
+caspar weinberger jr,2
+bettle juice,1
+battle of the morannon,7
+darlington county south carolina,1
+mayfield pennsylvania,1
+ruwerrupt de mad,1
+luthfi assyaukanie,1
+fiat panda,30
+wickiup reservoir,1
+tanabe–sugano diagram,6
+alexander sacher masoch prize,1
+intracellular transport,1
+church of the val de grâce,1
+jebel ad dair,1
+rosalind e krauss,6
+cross origin resource sharing,97
+readiness to sacrifice,1
+creel terrazas family,1
+phase portrait,9
+subepithelial connective tissue graft,1
+lake malawi,18
+phillips & drew,1
+ernst vom rath,2
+infinitus,1
+geneva convention for the amelioration of the condition of the wounded and sick in armies in the field,2
+world heritage,1
+dole whip,8
+leveling effect,1
+bioship,3
+vanilloids,2
+superionic conductor,1
+basil bernstein,7
+armin b cremers,2
+szlichtyngowa,1
+beixinqiao station,1
+united states presidential election in utah 1980,1
+watson v united states,3
+willie mcgill,1
+melle belgium,1
+al majmaah,1
+mesolimbic dopamine pathway,1
+six flags new england,5
+acp,2
+geostrategy,2
+original folk blues,1
+wentworth military academy,1
+bromodichloromethane,3
+doublet,4
+tawfiq al rabiah,1
+sergej jakirović,1
+mako surgical corp,3
+empire of lies,1
+old southwest,1
+bay of arguin,1
+bringing up buddy,1
+mustapha hadji,7
+raymond kopa,7
+evil horde,1
+kettering england,1
+extravaganza,1
+christian labour party,2
+joice mujuru,6
+v,15
+le père,4
+my fathers dragon,2
+cumulus cloud,32
+fantasy on themes from mozarts figaro and don giovanni,1
+postpone indefinitely,1
+extreme point,1
+iraq–israel relations,1
+henry le scrope 3rd baron scrope of masham,1
+rating beer,1
+claude alvin villee jr,2
+clackamas town center,2
+roope latvala,4
+richard bethell 1st baron westbury,1
+ryan gosling,1
+yelina salas,1
+amicus,1
+cecilia bowes lyon countess of strathmore and kinghorne,6
+programming style,9
+now and then,9
+somethingawful,1
+nuka hiva campaign,1
+bostongurka,2
+jorge luis ochoa vázquez,1
+philip burton,1
+rainbow fish,7
+road kill,5
+christiane frenette,2
+as if,1
+paul ricard,1
+roberto dañino,1
+shoyu,1
+jakarta,96
+dean keith simonton,1
+mastocytosis,19
+hiroko yakushimaru,3
+problem of other minds,2
+jaunutis,1
+tfp deficiency,1
+access atlantech edutainment,1
+kristian thulesen dahl,1
+william wei,1
+andy san dimas,10
+kempten/allgäu,1
+augustus caesar,9
+conrad janis,1
+tugaya lanao del sur,1
+second generation antipsychotics,1
+anema e core,2
+sucking the 70s,1
+the czars,2
+vakulabharanam,1
+f double sharp,3
+prymnesin,1
+dick bavetta,2
+billy jones,3
+columbine,4
+file talk joseph bidenjpg,1
+mandelbrot set,79
+constant elasticity of variance model,2
+morris method,1
+al shamal stadium,5
+hes alright,1
+madurai massacre,1
+philip kwon,2
+christadelphians,7
+this man is dangerous,2
+kiowa creek community church,1
+pier paolo vergerio,1
+order of the most holy annunciation,2
+john plender,1
+vallée de joux,2
+graysby,1
+ludwig minkus,3
+potato aphid,1
+bánh bột chiên,1
+wilhelmstraße,1
+fee waybill,1
+designed to sell,1
+ironfall invasion,2
+lieutenant governor of the isle of man,1
+third reading,2
+eleanor roosevelt high school,1
+su zhe,1
+heat conductivity,1
+si satchanalai national park,1
+etale space,1
+faq,24
+low carbohydrate diet,1
+differentiation of integrals,1
+karl fogel,2
+tom chapman,3
+james gamble rogers,2
+jeff rector,1
+burkut,9
+joe robinson,1
+turtle flambeau flowage,1
+moves like jagger,3
+turbaco,1
+oghuz turk,2
+latent human error,5
+square number,17
+rugby football league championship third division,2
+altoona pennsylvania,23
+circus tent,1
+satirical novel,1
+claoxylon,1
+barbaros class frigate,4
+oyer and terminer,2
+telephone numbers in the bahamas,1
+thomas c krajeski,2
+mv glenachulish,1
+sports broadcasting contracts in australia,3
+car audio,1
+ted lewis,2
+eric bogosian/robotstxt,2
+furman university japanese garden,1
+jed clampett,2
+flintstone,2
+c of tranquility,2
+rutali,2
+berkhamsted place,1
+wissam ben yedder,13
+nt5e,1
+erol onaran,1
+allium amplectens,1
+the three musketeers,2
+north eastern alberta junior b hockey league,1
+doggie daddy,1
+lauma,1
+the love racket,1
+eta hoffman,1
+ryans four,3
+omerta – city of gangsters,1
+humberview secondary school,2
+parels,1
+the descent,1
+evgenia linetskaya,1
+manhunt international 1994,1
+american society of animal science,1
+american samoa national rugby union team,1
+faster faster,1
+all creatures great and small,1
+mama said knock you out,9
+rozhdestveno memorial estate,2
+wizard of odd,1
+lugalbanda,4
+beardsley minnesota,1
+the rogue prince,10
+uss escambia,1
+stormy weather,3
+couleurs sur paris,1
+madrigal,4
+colin tibbett,1
+lemelson–mit prize,2
+phonetical singing,1
+glucophage,3
+suetonius,10
+ungra,1
+black and white minstrel,1
+woolwich west by election 1975,1
+trolleybuses in wellington,2
+jason macdonald,3
+ussr state prize,2
+robert m anderson,1
+kichijōji,1
+apache kid wilderness,1
+sneaky pete,8
+edward knight,1
+fabiano santacroce,1
+hemendra kumar ray,1
+sweat therapy,1
+stewart onan,2
+israel–turkey relations,1
+natalie krill,5
+clinoporus biporosus,1
+kosmos 2470,2
+vladislav sendecki,1
+healthcare in madagascar,1
+template talk 2010 european ryder cup team,1
+richard lyons,1
+transfer of undertakings regs 2006,3
+image processor,3
+alvin wyckoff,1
+kōbō abe,1
+kettle valley rail trail,1
+my baby just cares for me,3
+u28,1
+western australia police,10
+scincidae,1
+partitionism,1
+glenmorangie distillery tour,1
+river cave,1
+szilárd tóth,1
+i dont want nobody to give me nothing,1
+city,67
+annabel dover,2
+placebo discography,8
+showbiz,8
+solio ranch,1
+loan,191
+morgan james,10
+international federation of film critics,3
+the frankenstones,2
+pastor bonus,1
+billy purvis,1
+the gunfighters,1
+sandefjord,2
+ohio wine,2
+for the love of a man,1
+drifters,10
+ilhéus,1
+bikini frankenstein,1
+subterranean homesick alien,1
+chemical nomenclature,17
+great wicomico river,1
+ingrid caven,1
+japanese destroyer takanami,1
+nosler partition,1
+wagaman northern territory,1
+slovak presidential election 2019,1
+fuggerei,12
+al hibah,1
+irish war of independence,2
+joan smallwood,1
+anthony j celebrezze jr,1
+mercedes benz m130 engine,2
+phineas and ferb,2
+belgium womens national football team,3
+reynevan,1
+joe,1
+alan wilson,1
+epha3,1
+belarus national handball team,1
+phaedra,14
+move,2
+amateur rocketry,3
+epizootic hemorrhagic disease,5
+prague derby,4
+basilica of st thérèse lisieux,1
+pompeianus,1
+solved game,3
+tramacet,19
+essar energy,3
+lumbar stenosis,1
+part,24
+hải vân tunnel,1
+vsm group,3
+walter hooper,2
+consumer needs,1
+bell helicopter,18
+launde abbey,2
+ramune,10
+declarations of war during world war ii,1
+saint laurent de la salanque,1
+balkenbrij,1
+balgheim,1
+out of the box,13
+cappella,1
+national pharmaceutical pricing authority,4
+friend and foe,1
+new democracy,1
+eastern phoebe,2
+isipum of geumgwan gaya,1
+tel quel,1
+traveler,12
+superbeast,1
+oddsac,1
+zamora spain,1
+declaration of state sovereignty of the russian soviet federative socialist republic,1
+chumash painted cave state historic park california,3
+zentiva,1
+british rail class 88,5
+west indies cricket board,3
+pauli jørgensen,1
+punisher kills the marvel universe,7
+william de percy,1
+vehicle production group,4
+uc irvine anteaters mens volleyball,2
+dong sik yoon,1
+hyæna,2
+canadian industries limited,1
+mr ii,1
+jim muhwezi,1
+citizen jane,2
+night and day concert,1
+double precision floating point format,2
+herbal liqueurs,1
+the fixed period,5
+pip/taz,1
+lesser caucasus,2
+uragasmanhandiya,2
+alternative words for british,2
+khuzaima qutbuddin,1
+helmut balderis,2
+wesley r edens,1
+scott sassa,4
+mutant mudds,3
+east krotz springs louisiana,1
+leonard frey,3
+counting sort,15
+leandro gonzález pírez,2
+shula marks,1
+sierville,1
+california commission on teacher credentialing,1
+raymond loewy,10
+beevor foundry,1
+dog snapper,2
+hitman contracts,5
+eduard herzog,1
+wittard nemesis of ragnarok,1
+cape may light,1
+al saunders,3
+distant earth,2
+beam of light,2
+arent we all?,1
+veridicality,1
+private enterprise,3
+rambhadracharya,3
+dps,5
+beckdorf,1
+rúaidhrí de valera,1
+vivian bang,3
+sugar pine,1
+vn parameswaran pillai,1
+henry ross perot sr,1
+the arcadian,1
+the record,6
+g turner howard iii,1
+oleksandr usyk,12
+mumbai suburban district,5
+vicente dutra,1
+paean,1
+scottish piping society of london,1
+ingot,11
+alex obrien,6
+autonomous counties of china,1
+kaleorid,1
+remix & repent,3
+gender performativity,7
+godheadsilo,1
+tonsilloliths,1
+la dawri,1
+kiran more,3
+billboard music award for woman of the year,1
+tahitian ukulele,1
+buick lacrosse,14
+draft helen milner jury sent home for the night,2
+history of japanese cuisine,6
+time tunnel,1
+albert odyssey 2,1
+oysters rockefeller,4
+jim mahon,1
+evolutionary invasion analysis,1
+sunk cost fallacy,3
+universidad de manila,1
+morgan crucible,1
+southern miss golden eagles football,2
+horatio alger,13
+biological psychopathology,1
+hollywood,115
+product manager,21
+thomas burgh 3rd baron burgh,1
+stan hack,1
+peloponesian war,1
+republic of china presidential election 2004,2
+sanitarium,4
+growthgate,1
+samuel e anderson,1
+bobo faulkner,1
+kaffebrenneriet,1
+monponsett pond seaplane base,1
+powers of horror,3
+viburnum burkwoodii,1
+new suez canal,5
+gerardo ortíz,2
+japhia life,1
+paul pastur,1
+fuller craft museum,1
+nomal valley,1
+inaugural address,1
+saint Étienne du vigan,1
+lip ribbon microphone,2
+mary cheney,2
+piebald,6
+kadambas,1
+transportation in omaha,7
+before the league,1
+feltham and heston by election 2011,1
+aboriginal music of canada,3
+dnssec,6
+sshtunnels,1
+robin benway,1
+swimming at the 1968 summer olympics – mens 4 x 200 metre freestyle relay,1
+commission internationale permanente pour lepreuve des armes à feu portatives,3
+death rock,1
+hugo junkers,6
+gmt,3
+keanu reeves,2
+beverly kansas,1
+charlotte blair parker,1
+kids,5
+weight bench,1
+kiasmos,8
+basque country autonomous basketball team,1
+gideon toury,2
+gugak/,1
+texass 32nd congressional district,2
+have you ever been lonely,1
+take the weather with you,1
+chukchi,1
+the magicians wife,1
+juan manuel bordeu,1
+port gaverne,1
+music for films iii,1
+northern edo masquerades,1
+hang gliding,15
+marine corps logistics base barstow,2
+century iii mall,1
+peter tarlow,1
+thermal hall effect,1
+david ogden stiers,18
+webmonkey,1
+five cereals,2
+osceola washington,1
+clover virginia,2
+sphinginae,2
+stuart brace,1
+al di meola discography,7
+sunflowers,1
+hasty generalization,4
+polish athletic association,1
+the purge 3,2
+bitetti combat mma 4,1
+hiroko nagata,2
+mona seilitz,1
+mixed member proportional representation,7
+rancho temecula,2
+sinai,1
+norrmalmstorg robbery,5
+silesian walls,1
+floyd stahl,1
+gary becker,1
+knowledge engineering,5
+port of mobile,1
+luckiest girl alive,2
+ilya rabinovich,1
+bridge,3
+el general,3
+cornerstone schools,1
+gozmo,1
+charles courtney curran,1
+broker,32
+us senate committee on banking housing and urban affairs,2
+retroversion of the sovereignty to the people,1
+giorgi baramidze,1
+lars grael,1
+abdul qadir,3
+pgrep,2
+category talk seasons in danish womens football,1
+malus sieversii,1
+god squad,4
+category of acts,1
+melkote,1
+linda langston,1
+sherry romanado,1
+montana sky,8
+history of burkina faso,1
+iso 639 kxu,1
+los angeles fire department museum and memorial,1
+recognize,1
+der bewegte mann,6
+davy pröpper,1
+outline of vehicles,2
+gesta francorum,1
+sidney w pink,1
+ronald pierce,1
+martin munkácsi,1
+nord noreg,1
+accounting rate of return,7
+urwerk,1
+albert gallo,1
+antennaria dioica,3
+transport in sudan,2
+fladry,1
+cumayeri,1
+bennington college,11
+pêro de alenquer,2
+sixth man,1
+william i of aquitaine,1
+radisson diamond,1
+belgian united nations command,1
+venus genetrix,1
+sayesha saigal,14
+inverse dynamics,2
+national constitutional assembly,1
+honey bear,4
+certosa di pavia,2
+selective breeding,31
+let your conscience be your guide,1
+han hyun jun,1
+closed loop,8
+template talk golf major championships master,1
+twin oaks community virginia,1
+red flag,3
+housing authority of new orleans,2
+joice heth,4
+toñito,1
+ivan pavlov,2
+madanapalle,4
+ptat,1
+renger van der zande,1
+anaerobic metabolism,2
+patrick osullivan,1
+shirakoya okuma,1
+permian high school,9
+thomas h ford,1
+southfield high school,1
+religion in kuwait,2
+nathrop colorado,1
+hefner hugh m,1
+whitney bashor,1
+pope shenouda iii of alexandria,7
+thomas henderson,1
+tokka and rahzar,13
+windows thumbnail cache,3
+consumer council for water,1
+sake bombs and happy endings,1
+lothlórien,1
+the space bar,4
+sakuma rail park,1
+oas albay,3
+dan frankel,1
+cliff hillegass,1
+iron sky,12
+pentile matrix family,1
+oregon system,1
+california sea lion,7
+jeanneau,2
+meadowhall interchange,1
+lille catholic university,1
+nuñomoral,1
+vending machine,30
+xarelto,1
+jonbenét ramsey,3
+progresso castelmaggiore,1
+tacticity,6
+wing arms,1
+gag,2
+hank greenberg,8
+garda síochána,14
+puggy,1
+p sainath,1
+the year of living dangerously,9
+army reserve components overseas training ribbon,1
+hmas nestor,1
+john beckwith,1
+florida constitution,2
+yonne,3
+benoît richaud,1
+mamilla pool,2
+gerald bull,14
+david halberstam,12
+my fair son,2
+ncaa division iii womens golf championships,1
+anniela,1
+king county,1
+kamil jankovský,1
+synaptic,3
+rab,6
+switched mode regulator,1
+history of biochemistry,1
+halaf,2
+henry colley,1
+co postcode area,3
+social finance uk,1
+cercospora,2
+the dao,1
+unité radicale,2
+shinji hashimoto,3
+tommy remengesau,3
+isobel gowdie,2
+mys prasad,9
+national palace museum of korea,1
+basílica del salvador,2
+no stone unturned,2
+walton group,1
+foramen ovale,1
+slavic neopaganism,1
+iowa county wisconsin,3
+melodi grand prix junior,1
+jarndyce and jarndyce,3
+talagunda,1
+nicholas of autrecourt,1
+substitution box,3
+the power of the daleks,1
+real gas,6
+edward w hincks,1
+kangxi dictionary,5
+natural world,1
+h h asquith,21
+francis steegmuller,1
+sasha roiz,3
+media manipulation,1
+looking for comedy in the muslim world,2
+bytown,4
+previsualization,1
+rita ora discography,11
+kiersey oklahoma,1
+henry greville 3rd earl of warwick,1
+draft,4
+phenolate,1
+i believe,1
+virologist,1
+relief in abstract,1
+eastern medical college,1
+purveyance,2
+ascending to infinity,2
+sportstime ohio,2
+church of wells,1
+ivory joe hunter,1
+wayne mcgregor,2
+luna 17,4
+viscount portman,2
+wikipedia talk wikipedia signpost/2009 07 27/technology report,1
+negramaro,1
+barking owl,2
+i need you,2
+brockway mountain drive,1
+template talk albatros aircraft,1
+future shock,11
+china national highway 317,1
+laurent gbagbo,7
+plum pudding model,18
+league of the rural people of finland,1
+dundees rising,1
+nikon f55,1
+olympic deaths,5
+gemma jones,19
+hafsa bint al hajj al rukuniyya,1
+personal child health record,1
+logic in computer science,11
+bhyve,3
+hothouse,1
+log house,6
+library of celsus,2
+the lizzie bennet diaries,1
+leave this town the b sides ep,1
+estimated time of arrival,8
+chariotry in ancient egypt,2
+american precision museum,1
+dimos moutsis,1
+scriptlet,1
+something in the wind,1
+sharka blue,1
+time on the cross the economics of american negro slavery,1
+tomislav kiš,1
+khalid islambouli,7
+bankruptcy abuse prevention and consumer protection act,7
+gračanica bosnia and herzegovina,2
+jungs theory of neurosis,5
+mgm animation,1
+soviet support for iran during the iran–iraq war,3
+native american,1
+template talk nigeria squad 1994 fifa world cup,1
+norwegian lutheran church,4
+adia barnes,1
+coatings,1
+mehdi hajizadeh,1
+the dead matter cemetery gates,1
+fuzzy little creatures,1
+waje,7
+anji,1
+heinz haber,1
+turkish albums chart,1
+sebastian steinberg,1
+price fixing cases,2
+bellator 48,1
+edgar r champlin,1
+otto hermann leopold heckmann,1
+bishops stortford fc,4
+stern–volmer relationship,6
+morgan quitno,2
+five star general,1
+iso 13406 2,1
+black prince,11
+leopard kung fu,1
+felix wong,5
+mary claire king,6
+alvar lidell,1
+playonline,1
+infantry branch,1
+andrew pattison,1
+john turmel,1
+kent,74
+edwin palmer hoyt,1
+captivity narratives,1
+jaguar xj220,1
+hms tanatside,2
+new faces,2
+edward levy lawson 1st baron burnham,1
+samuel woodfill,3
+jewish partisans,9
+abandonware,16
+early islamic philosophy,2
+sleeper cell,5
+media of africa,2
+san andreas,3
+luxuria,2
+egon hostovský,3
+pelagibacteraceae,1
+martin william currie,1
+borescope,21
+narratives of islamic origins the beginnings of islamic historical writing,1
+lecompton constitution,2
+axé bahia,2
+paul goodman,1
+template talk washington nationals roster navbox,1
+a saucerful of secrets,2
+david carol macdonnell mather,1
+portal buddhism,3
+florestópolis,1
+alecs+golf+ab,1
+bank alfalah,1
+frank pellegrino,3
+loutre,1
+erp4it,2
+monument to joe louis,2
+witch trial of nogaredo,1
+sabrina santiago,2
+no night so long,3
+helena carter,1
+renya mutaguchi,3
+yo yogi,4
+bolivarian alliance for the americas,3
+cooper boone,1
+uss iowa,24
+mitsuo iso,2
+cranberry,1
+batrachotomus,1
+richard lester,5
+bermudo pérez de traba,1
+rosser reeves ruby,1
+telecommunications in morocco,4
+i a richards,1
+nidhal guessoum,1
+lilliefors test,6
+the silenced,5
+mambilla plateau,1
+sociology of health and illness,3
+tereza chlebovská,2
+bismoll,3
+kim suna,1
+scream of the demon lover,1
+joan van ark,7
+intended nationally determined contributions,6
+dietary supplement,16
+last chance mining museum,1
+savoia marchetti s65,1
+if i can dream,1
+maharet and mekare,4
+nea anchialos national airport,2
+american journal of digestive diseases,1
+chance,2
+lockheed f 94c starfire,1
+the game game,1
+kuzey güney,3
+semmering base tunnel,1
+three mile island,1
+evaluation function,1
+robert mckee,4
+carmelo soria,1
+moneta nova,1
+pīnyīn,1
+international submarine band,3
+elections in the bahamas,5
+powell alabama,1
+kmgv,1
+charles stuart duke of kendal,2
+echo and narcissus,7
+trencrom hill,1
+ashwini dutt,1
+the herzegovina museum,1
+liverpool fc–manchester united fc rivalry,12
+kerber,1
+flakpanzer 38,8
+demographics of bihar,2
+rico reeds,1
+vandenberg afb space launch complex 3,1
+wiesendangen,1
+lamm,1
+allen doyle,2
+anusree,5
+broad spectrum,1
+bay middleton,2
+connect savannah,1
+history of immigration to canada,22
+waco fm,3
+nakano takeko,1
+murnau am staffelsee,2
+minarchy,1
+haymans dwarf epauletted fruit bat,1
+brachyglottis repanda,1
+associative,1
+mississippi aerial river transit,1
+stefano siragusa,2
+gregor the overlander,3
+marine raider,1
+pogorzans,1
+sportcity,2
+garancahua creek,1
+vincent dimartino,3
+ninja,2
+natural history museum of bern,1
+revolutionary catalonia,4
+chiayi,1
+alix strachey,3
+looe island,1
+college football usa 96,1
+off peak return,1
+minsk 1 airport,1
+evangelical lutheran church in burma,2
+riemann–roch theorem,1
+the comic strip,2
+vladimir istomin,1
+america again,2
+brown treecreeper,1
+american high school,1
+powerglide,2
+oolitic limestone,1
+daz1,1
+jarrow vikings,1
+pierre philippe thomire,1
+dorothy cadman,1
+gaston palewski,3
+twin river bridges,1
+im yours,1
+ambrose dudley 3rd earl of warwick,3
+ssim,2
+original hits,1
+cosmonaut,9
+special educational needs and disability act 2001,4
+will you speak this word,1
+history of wolverhampton wanderers fc,1
+don lawrence,1
+tokyo metropolitan museum of photography,1
+orduspor,1
+john lukacs,3
+patrice collazo,1
+lords resistance army insurgency,5
+ronald "slim" williams,5
+drivin for linemen 200,1
+nicolò da ponte,1
+bucky pope,1
+ewing miles brown,2
+ugly kid joe,28
+american flight 11,1
+louzouer,1
+district hospital agra,1
+jessica jane applegate,1
+sexuality educators,1
+serie a scandal of 2006,1
+at war with reality,1
+stephen wiltshire,13
+vechigen switzerland,1
+rikki clarke,3
+rayakottai,1
+permanent magnet electric motor,1
+qazi imdadul haq,1
+plywood,49
+ntr telugu desam party,1
+skin lightening,1
+royal natal national park,1
+uss mcdougal,2
+queen of the sun,1
+karanjachromene,1
+on 90,1
+enrique márquez,1
+siegfried and roy,1
+city manager,6
+wrdg,1
+why i am not a christian,3
+protein coding region,1
+royal bank of queensland gympie,1
+british invasions of the river plate,2
+yasufumi nakanoue,1
+magnetic man,1
+kickback,3
+tillandsia subg allardtia,1
+north american nr 349,1
+edict of amboise,1
+st andrew square edinburgh,2
+flag of washington,2
+timeless,2
+new york state route 125,3
+fudge,3
+single entry bookkeeping system,5
+refractive surgery,8
+bi monthly,1
+park high school stanmore,1
+norton anthology of english literature,1
+michael wines,1
+gaff rig,1
+kosmos 1793,1
+major facilitator superfamily,2
+talpur dynasty,1
+byron bradfute,1
+quercitello,1
+rcmp national protective security program,1
+ann kobayashi,1
+recurring saturday night live characters and sketches,3
+abraham hill,1
+nagapattinam district,4
+pidgeon,3
+mycalessos,1
+technical university of hamburg,1
+electric shock&ei=ahp0tbk0emvo gbe v2bbw&sa=x&oi=translate&ct=result&resnum=2&ved=0ceaq7gewaq&prev=/search?q=electric+shock&hl=da&biw=1024&bih=618&prmd=ivns,2
+aim 54 phoenix,18
+undercut,5
+gokhale memorial girls college,1
+digital penetration,19
+centre for peace studies tromsø,1
+richie williams,1
+walloon region,1
+albany city hall,2
+maxine carr,4
+anglosphere,18
+effect of world war i on children in the united states,1
+josh bell,1
+german thaya,1
+brian murphy,3
+marguerite countess of blessington,1
+leak,1
+bubble point,5
+international federation of human rights,1
+clubcorp,2
+greater philadelphia,1
+daniel albright,1
+macas,1
+roses,4
+woleu ntem,1
+shades of blue,1
+say aah,2
+curtiss sbc,1
+ion andone,1
+firstborn,1
+marringarr language,2
+ann e todd,1
+native american day,4
+stand my ground,1
+bavington,1
+classification of indigenous peoples of the americas,2
+always,6
+leola south dakota,1
+psycilicibin,2
+roy rogers,1
+marmalade,1
+national prize of the gdr,1
+shilp guru,1
+m2 e 50,1
+jorge majfud,2
+cutter and bone,1
+william steeves,1
+lisa swerling,2
+grace quigley,5
+telecommunications in yemen,1
+rarotonga international airport,7
+cycling at the 2010 central american and caribbean games,2
+mazda b3000,1
+hanwencun,1
+adurfrazgird,1
+ivan ivanov vano,1
+yhwh,1
+qarshi,4
+oshibori,2
+uppada,1
+iain clough,1
+painted desert,7
+tugzip,1
+my little pony fighting is magic,143
+pantheon,2
+chinese people in zambia,1
+yves saint laurent,3
+texas helicopter m79t jet wasp ii,1
+forever reign,1
+charlotte crosby,32
+ealdormen,9
+copper phosphate,2
+mean absolute difference,5
+hôtel de soubise,5
+josh rees,2
+non commissioned officer,70
+gb jones,1
+im feeling you,2
+book of shadows,9
+brain trauma,1
+sulpitius verulanus,1
+vikranth,5
+space adaptation syndrome,6
+united states presidential election in hawaii 1988,1
+joe garner,4
+river suir bridge,2
+the beach boys medley,1
+joyce castle,1
+christophe wargnier,1
+ik people,2
+sketch show,1
+buena vista police department,1
+file talk layzie bone clevelandjpg,1
+gillian osullivan,3
+prince albert of saxe coburg and gotha,2
+berean academy,1
+motorcraft quality parts 500,1
+frederick law olmsted,21
+born this way,9
+sterling virginia,4
+if wishes were horses beggars would ride,1
+section mark,1
+tapi,1
+navy cross,1
+housekeeper,1
+gian battista marino,1
+planá,1
+chiromantes haematocheir,1
+colonial life & accident insurance company,4
+aduana building,2
+kim johnston ulrich,1
+berkelium 254,1
+m&t bank corp,2
+sit up,1
+sheknows,1
+phantom lady,1
+bruce kamsinky,1
+commercial drive,1
+chinese people in the netherlands,1
+sylvia young theatre school,4
+influenza a virus subtype h2n3,1
+dracut,2
+nate webster,1
+vila velebita,1
+uaz patriot,4
+democratic unification party,1
+alexander slidell mackenzie,1
+portland mulino airport,1
+first person shooter,2
+the temporary widow,1
+terry austin,1
+the foremans treachery,1
+hms blenheim,1
+sodium dichloro s triazinetrione,1
+kurt becher,1
+cumberland gap tn,1
+newton cotes,1
+daphne guinness,6
+internal tide,1
+god and gender in hinduism,2
+howlin for you,1
+stellarator,14
+cavea,3
+faye ginsburg,1
+lady cop,3
+template talk yugoslavia squad 1986 fiba world championship,1
+solidarity economy,1
+second presidency of carlos andrés pérez,1
+bora bora,71
+xfs,1
+christina bonde,1
+agriculture in australia,20
+scenic drive,1
+richard mantell,1
+motordrome,1
+broadview hawks,1
+misty,2
+international bank of commerce,2
+istanbul sapphire,5
+changkat keruing,1
+the hotel inspector unseen,1
+tharwa australian capital territory,2
+strauss,2
+shock film,1
+ulick burke 1st marquess of clanricarde,2
+valencia cathedral,5
+kay bojesen,1
+palogneux,1
+texas beltway 8,1
+jackie walorski,7
+capital punishment in montana,1
+byte pair encoding,2
+upper deerfield township new jersey,2
+lucca comics & games,1
+lee chae young,1
+czar alexander ii,1
+kool ad,6
+leopold van limburg stirum,1
+john dunn,1
+policeman,2
+what dreams may come,3
+grant ginder,1
+chieverfueil,2
+long island express,1
+malmö sweden,2
+song for my father,1
+see saw,2
+jean jacques françois le barbier,5
+do rag,11
+dsb bank,2
+davical,6
+cervical cap,1
+gershon yankelewitz,1
+the last hurrah,4
+category talk educational institutions established in 1906,1
+tour pleyel,1
+león klimovsky,1
+phyoe phyoe aung,1
+phil sawyer,2
+android app //orgwikipedia/http/enmwikipediaorg/wiki/swiftkey,1
+deontological,3
+juan dixon,12
+robert pine,4
+alexander tilloch galt,2
+common tailorbird,12
+derailed,7
+mike campbell,3
+terminator 2 3 d battle across time,3
+technische universität münchen,4
+baloana,1
+echis leucogaster,1
+lahore pigeon,1
+william de beauchamp 9th earl of warwick,2
+erin go bragh,14
+economics u$a,1
+villafranca montes de oca,1
+pope eusebius,2
+martin kruskal,1
+félix de blochausen,1
+jeff jacoby,1
+mark krein,2
+travis wester,2
+fort louis de la louisiane,1
+weddingwire,2
+ping,54
+don swayze,8
+steve hamilton,3
+rhenish,1
+winrar,3
+births in 1561,4
+copyright law of the netherlands,2
+floodland,9
+tamil nadu tourism development corporation,1
+dolls house,1
+chkrootkit,1
+search for the hero,1
+avenal,1
+tini,2
+patamona,1
+aspendos international opera and ballet festival,2
+felix cora jr,5
+yellow cardinal,2
+antony jay,1
+conda,1
+a tramp shining,1
+william miller,1
+holomictic lake,2
+growler,2
+the violence of summer,1
+meerschaum,3
+cd138,1
+karl friedrich may,1
+history of iraq,2
+henry ford,139
+rumwold,1
+beatrice di tenda,1
+blaze,1
+nick corfield,1
+walt longmire,5
+eleazar maccabeus,1
+business edition,1
+karl oyston,4
+gypsy beats and balkan bangers,1
+fa premier league 2004 05,1
+agawan radar bomb scoring site,1
+the hall of the dead,1
+combat training centre,1
+moroccan portuguese conflicts,2
+pokipsy,1
+minor characters in csi crime scene investigation,1
+miguel molina,1
+buckypaper,2
+magazine,4
+forget about it,2
+marco schällibaum,1
+r d smith,1
+nfl playoff results,2
+four score,1
+centenary bank,2
+london borough of camden,12
+bhumij,1
+counter reformation/trackback/,1
+billy volek,1
+cover song,1
+awang bay,1
+douglas fitzgerald dowd,3
+architecture of ancient greece,5
+ny1,2
+academy award for best visual effects,3
+history of the mbta,2
+triangle group,1
+charles r fenwick,1
+berenice i of egypt,1
+window detector,1
+corruption perception index,1
+leffrinckoucke,1
+lee anna clark,1
+burndy,2
+inset day,2
+american association of motor vehicle administrators,1
+ckm matrix,1
+angiopoietin 1,1
+steven marsh,1
+open reading frame,27
+telesystems,1
+pastoral poetry,1
+west wycombe park,2
+lithium,7
+nogales international airport,1
+wajków,1
+sls 1,1
+trillo,2
+max s,1
+verndale,1
+yes sir i can boogie,1
+blog spam,10
+daniel veyt,1
+william brown,3
+takami yoshimoto,1
+josh greenberg,4
+geoffrey heyworth 1st baron heyworth,1
+medeina,3
+anja steinlechner,1
+riviera beach florida,2
+gerris wilkinson,1
+north american lutheran church,1
+paul dillett,11
+proto euphratean language,1
+best selling books,2
+pumpellyite,1
+business objects,1
+fodor,2
+xanadu,3
+london river,1
+draft juan de orduña,2
+barriemore barlow,3
+jew harp,1
+birmingham,1
+titus davis,1
+march 2012 gaza–israel clashes,1
+energy demand management,2
+aquarium of the americas,3
+tto,1
+l h c tippett,1
+optical fiber,88
+onești,2
+stanley ntagali,1
+prussian blue,1
+bill kovach,2
+hip pointer,3
+alessandra amoroso,4
+fleet racing,1
+navy maryland rivalry,1
+cornering force,1
+the mighty quest for epic loot,5
+katalyst,2
+the beef seeds,1
+shack out on 101,1
+aircraft carrier operations,1
+overseas province,2
+institute of state and law,1
+light truck,5
+plastics in the construction industry,2
+little zizou,2
+congenic,2
+adriaen van utrecht,1
+brian mcgrath,3
+parvati,1
+jason gwynne,1
+kphp,1
+miryusif mirbabayev,1
+kōriyama castle,3
+the making of a legend gone with the wind,2
+shot traps,1
+awa tag team championship,1
+littlebourne,2
+franchot tone,4
+john dudley 2nd earl of warwick,2
+mass spec,1
+final fantasy vi,44
+gerry ellis,1
+adon olam,3
+man 24310,1
+p n okeke ojiudu,1
+unqi,1
+snom,1
+bruce bagemihl,1
+category talk animals described in 1932,1
+metalist oblast sports complex,1
+colley harman scotland,1
+suka,1
+anita sarkeesian,81
+kazakhstan national under 17 football team,1
+ym,2
+matt barnes,1
+tour phare,1
+bellus–claisen rearrangement,2
+turkey at the 2012 summer olympics,1
+irréversible,32
+umbilical nonseverance,1
+wood stave,1
+indian pentecostal church of god,1
+camponotus nearcticus,3
+john tesh,13
+syncline,4
+skins,50
+kelsey manitoba,1
+alkayida,2
+polyglotism,17
+forensic statistics,2
+ram vilas sharma,8
+pearl jam,71
+dj max fever,1
+islamic view of miracles,5
+kds,1
+alabama cavefish,1
+johanna drucker,1
+tom wolk,4
+rottenburg,2
+goshen connecticut,2
+maker media,1
+morphett street adelaide,1
+keystone hotel,1
+baseball hall of fame balloting 2005,1
+gongzhuling south railway station,1
+ss charles bulfinch,1
+sig mkmo,1
+cartman finds love,2
+embassy of syria in washington dc,1
+charles prince of wales,175
+teachings of the prophet joseph smith,1
+charles iv,1
+alethea steven,1
+type i rifle,2
+a peter bailey,1
+brain cancer,1
+eric l clay,2
+jett bandy,1
+moro rebellion,9
+eustachów,1
+avianca el salvador,2
+dont stop the party,4
+reciprocal function,1
+dagmar damková,1
+hautmont,1
+penguin english dictionary,2
+waddie mitchell,1
+technician fourth grade,3
+hot girls in love,1
+critérium du dauphiné,59
+love song,2
+roger ii,2
+whitbread book award,1
+thomas colepeper 2nd baron colepeper,2
+a king and no king,1
+big fish & begonia,5
+mayville new york,2
+molecularity,1
+ed romero,1
+one watt initiative,3
+jeremy hellickson,2
+william morgan,1
+giammario piscitella,1
+eastern lesser bamboo lemur,1
+padre abad district,1
+don brodie,1
+facts on the ground,1
+undeniable evolution and the science of creation,1
+john of giscala,1
+bryce harper,45
+gabriela irimia,1
+empire earth mobile,1
+the queen vic,1
+helen rowland,1
+mixed nuts,5
+malacosteus niger,2
+george r r martin/a song of ice and fire,1
+brock osweiler,11
+tough,1
+outline of agriculture,4
+sea wolf,1
+mo vaughn,4
+the brood of erys,1
+composite unit training exercise,1
+isabella acres,4
+the jersey,5
+coal creek bridge,1
+habana libre,1
+nicole pulliam,1
+john shortland,1
+daniel pollen,1
+magic kit,1
+baruch adonai l&,1
+a daughters a daughter,2
+laughlin nevada,11
+tubercule,1
+louis laurie,1
+internet boom,3
+conversion of paul,1
+comparison of software calculators,1
+choctaw freedmen,2
+josh eady,1
+hôpital charles lemoyne,2
+u mobile,2
+john tomlinson,1
+baré esporte clube,2
+tuğçe güder,2
+highams park railway station,4
+newport east,1
+clothing industry,6
+scott rosenberg,6
+my 5 wives,2
+matt godfrey,1
+port ellen,2
+winecoff hotel fire,1
+fide world chess championship 2005,2
+lara piper,1
+the little mermaid,1
+foxmail,6
+penn lyon homes,1
+stockholm opera,1
+american journal of theology,1
+bernard gorcey,3
+rodger collins,1
+clarkeulia sepiaria,1
+korean era name,3
+melide ticino,1
+unknown to no one,1
+asilinae,1
+scânteia train accident,1
+parti de la liberté et de la justice sociale,1
+falkland islands sovereignty dispute,13
+castile,10
+french battleship flandre,1
+nils taube,1
+anisa haghdadi,1
+william tell told again,2
+magister,3
+zgc 7,1
+national agricultural cooperative marketing federation of india,3
+les bingaman,1
+chebfun,1
+portal current events/august 2014,2
+eparchy of oradea mare,1
+tempo and mode in evolution,2
+seili,1
+boniface,3
+supportersvereniging ajax,1
+support team,1
+lactometer,1
+twice as sweet,1
+spruce pine mining district,2
+banknotes of the east african shilling,1
+cerebral cortex,3
+tagalogs,1
+german diaspora,8
+grammelot,1
+max a,1
+category talk vienna culture,1
+cheung kong graduate school of business,1
+three certainties,1
+multani,3
+barry callebaut,15
+joanne mcneil,1
+z grill,4
+commonwealth of australia constitution act 1900,1
+ganzorigiin mandakhnaran,1
+peter h schultz,1
+ea pga tour,3
+scars & memories,1
+exodus from lydda,1
+states reorganisation act 1956,4
+guy brown,1
+horsebridge,1
+arthur mafokate,1
+aldus manutius,5
+american daylight,3
+jean chaufourier,2
+edmond de caillou,1
+hms iron duke,9
+displeased records,1
+quantum turing machine,3
+ncert textbook controversies,2
+dracs,1
+beyrouth governorate,1
+staphylococcus caprae,1
+tankard,2
+surfaid international,1
+hohenthurn,2
+mission x 41,1
+professional wrestling hall of fame,2
+george mountbatten 4th marquess of milford haven,2
+athletics at the 2012 summer paralympics womens club throw f31 32/51,1
+knots and crosses,1
+edge vector,1
+philippe arthuys,1
+baron raglan,1
+odell beckham jr,3
+elfriede geiringer,1
+hyflux,1
+author level metrics,2
+ieee fellow,1
+pori brigade,3
+polyphenol antioxidant,1
+the brothers,8
+kakaji Ōita,1
+shyam srinivasan,2
+shahid kapoor,88
+chuckie williams,1
+colonial,4
+roman spain,1
+convolvulus pluricaulis,1
+william j burns international detective agency,1
+accessibility for ontarians with disabilities act 2005,1
+linguist,1
+agonist,2
+xiaozi,1
+holker hall,1
+novatium,1
+alois jirásek,1
+lesser crested tern,1
+names of european cities in different languages z,1
+hydrogen cooled turbogenerator,2
+indian airlines flight 257,1
+united states attorney for the northern district of indiana,1
+this is us,11
+transaction capabilities application part,1
+culiacán,6
+hash based message authentication code,65
+heinz murach,1
+dual citizen,2
+zhizn’ za tsarya,1
+gabriel taborin technical school foundation inc,1
+deaths in july 1999,1
+aponi vi arizona,1
+amish in the city,2
+goodbye cruel world,1
+st augustine grass,10
+moesi,1
+violette leduc,3
+methyl formate,9
+you walk away,1
+the traveler,1
+bond,89
+moa cuba,3
+hebrew medicine,1
+women in the russian and soviet military,2
+help log,2
+cuillin,5
+back fire,14
+salesrepresentativesbiz,1
+hogsnort rupert,1
+dwarf minke whale,1
+embassy of albania ottawa,1
+cotai water jet,1
+st lucie county florida,8
+wesselman,1
+american indian art,1
+richard arkless,1
+trolleybuses in bergen,1
+vama buzăului,1
+far east movement,9
+threes a crowd,1
+insane,3
+linux technology center,4
+patty duke,24
+smuckers,1
+kapalua,1
+amf futsal world cup,5
+umes chandra college,1
+jnanappana,2
+bar bar bar,1
+beretta m951,2
+libertarian anarchism,1
+fart proudly,4
+peyton place,5
+phase detection autofocus,1
+cavalry in the american civil war,9
+class stratification,1
+battle of cockpit point,1
+regiment van heutsz,2
+ana rivas logan,1
+nenya,1
+westland wah 64 apache,1
+roslyn harbor new york,3
+august wilhelm von hofmann,1
+professional baseball,2
+douglas feith,1
+pogrom,21
+aušra kėdainiai,1
+pseudopeptidoglycan,4
+arquà petrarca,1
+wayampi,1
+conservative government 1866 1868,1
+world naked bike ride,28
+fruitvale oil field,2
+shuttle buran,1
+robert c pruyn,1
+totem,1
+megalotheca,1
+nkechi egbe,1
+james p comeford,1
+heavens memo pad,7
+cauca valley,1
+jungfraujoch railway station,2
+seo in guk,24
+bold for delphi,1
+multiple frames interface,1
+zhenli ye gon,6
+kyabram victoria,1
+two stars for peace solution,1
+couette flow,9
+new formalism,2
+template talk 1930s comedy film stub,1
+template talk scream,1
+joona toivio,4
+iaaf silver label road race,1
+super bowl xxviii,5
+i aint never,1
+paul little racing,1
+jacobite rising of 1715,3
+katherine archuleta,1
+programmable logic device,12
+footsteps of our fathers,2
+once upon a tour,1
+tauck,1
+budapest memorandum on security assurances,5
+prostitution in chad,2
+bebedouro,2
+vice,2
+madredeus,1
+p diddy,1
+princess alice of the united kingdom,20
+jerry hairston jr,1
+neo noir,3
+self evaluation motives,1
+relativity the special and the general theory,2
+the sign of four,3
+kevin deyoung,1
+robin long,1
+mokshaa helsa,1
+nagaon,1
+aniceto esquivel sáenz,1
+sda,2
+german battlecruiser gneisenau,1
+assisted reproductive technology,12
+cmmg,1
+vision of you,1
+keshia chanté discography,1
+biofuel in the united kingdom,1
+katinka ingabogovinanana,1
+hutt valley,1
+garwol dong,1
+tunceli province,3
+edwin bickerstaff,1
+halloween 3 awesomeland,1
+canadian records in track and field,1
+ubisoft são paulo,1
+midstream,16
+jethro tull,4
+childhoods end,55
+ss rohilla,1
+lagranges four square theorem,6
+bucky pizzarelli,3
+jannik bandowski,80
+guðni Ágústsson,1
+multidimensional probability distribution,1
+brno–tuřany airport,2
+broughtonia,5
+cold hands warm heart,1
+simone biles,32
+bf homes parañaque,2
+akaflieg köln ls11,3
+street fighter legacy,2
+beautiful kisses,1
+first modern olympics,1
+macbook air,1
+dublab,1
+silent night deadly night,6
+earth defense force 2025,2
+grant township carroll county iowa,1
+gary williams,1
+malmö aviation,1
+geographical pricing,2
+anaheim memorial medical center,1
+mary+mallon,1
+henry a byroade,1
+wawasan 2020,4
+eurovision dance contest,6
+lydia polgreen,1
+pilsen kansas,1
+colin sampson,1
+neelamegha perumal temple,1
+james bye,2
+canadian federation of agriculture,1
+f w de klerk,34
+bob casey jr,3
+northport east,1
+elian gonzalez affair,1
+aleksei bibik,1
+anthony dias blue,1
+pyaar ke side effects,4
+fusako kitashirakawa,1
+cal robertson,4
+shandong national cultural heritage list,1
+police story 3 super cop,5
+the third ingredient,3
+dean horrix,1
+pico el león,1
+cesar chavez street,1
+prospered,1
+children in cocoa production,5
+gervase helwys,1
+binary digit,1
+kovai sarala,4
+mathematics and music,1
+macroglossum,1
+f gary gray,21
+broadsoft,2
+cachan,4
+bukkake,21
+church of st margaret of scotland,1
+christopher cockerell,3
+amsterdam oud zuid,1
+county of bogong,1
+intel mobile communications,1
+the legend of white fang,1
+millwright,19
+will buckley,1
+bill jelen,2
+template talk san francisco 49ers coach navbox,1
+amalia garcía,1
+because he lives,1
+air charts,1
+stade edmond machtens,1
+henry stommel,1
+dxgi,1
+misr el makasa sc,1
+chad price,2
+carl henning wijkmark,1
+acanthogorgiidae,1
+diqduq,1
+prelog strain,2
+crispin the cross of lead,4
+avraham adan,2
+barbershop arranging,1
+free x tv,1
+eric guillot,1
+kht,1
+never a dull moment,1
+lwów school of mathematics,1
+sears centre,3
+chin state,6
+van halen 2007 2008 tour,1
+robert weinberg,3
+fierté montréal,2
+vince jack,1
+heikki kuula,1
+architecture of the republic of macedonia,1
+glossary of education terms,1
+aleksandra szwed,1
+military history of europe,3
+exeter central railway station,1
+staroselye,1
+lee thomas,7
+saint peters square,2
+romanization of hispania,2
+file talk dodecahedrongif,1
+signed and sealed in blood,8
+colleges of worcester consortium,1
+district electoral divisions,1
+galkot,1
+king África,3
+monetary policy,57
+brp ang pangulo,2
+battle of mạo khê,1
+air tube,1
+ruth ashton taylor,2
+keith jensen,1
+headland alabama,1
+willie loomis,1
+interactive data extraction and analysis,2
+georgetown city hall,2
+chuck es in love,2
+weeksville brooklyn,1
+anatoly sagalevich,2
+browett lindley & co,1
+barnawartha victoria,1
+pop,2
+black balance,2
+aceratorchis,1
+emmeline pethick lawrence baroness pethick lawrence,1
+osso buco,1
+herminie cadolle,2
+telegram & gazette,2
+le van hieu,1
+pine honey,2
+nexvax2,1
+leicester north railway station,1
+jacqueline foster,1
+bill handel,3
+nizami street,1
+radke,1
+bob mulder,1
+ambroise thomas,4
+carles puigdemont i casamajó,1
+callable bond,6
+tesco metro,2
+mohan dharia,1
+great hammerhead,12
+vinko coce,3
+john mayne,1
+cobb cloverleaf,1
+uhlan,10
+giulio migliaccio,1
+belmont university,6
+rinucumab,1
+kearny high school,1
+chūgen,1
+stages,2
+boar%27s head carol,1
+knight of the bath,1
+ayres thrush,7
+sing hallelujah,1
+the tender land,2
+wholesale banking,1
+jean jacques perrey,5
+maxime bossis,2
+sherman records,1
+alan osório da costa silva,1
+fannie willis johnson house,1
+blacks equation,2
+levinthals paradox,2
+thomas scully,2
+necron,3
+university of alberta school of business,5
+lake shetek,1
+toby maduot,1
+gavriil golovkin,1
+sweetwater,3
+atlantic revolutions,2
+jaime reyes (comics,1
+kajang by election 2014,1
+mycotoxigenic,1
+san marco altarpiece,2
+line impedance stabilization network,2
+santiago hernández,1
+jazzland,3
+host–guest chemistry,4
+giovanni florio,2
+st marylebone school,1
+acqua fragile,1
+the horse whisperer,10
+don francis,1
+mike molesevich,1
+brad wright,1
+north melbourne football club,3
+brady dragmire,1
+margaret snowling,2
+wing chun terms,4
+mckey sullivan,1
+derek ford,1
+cache bus,1
+bernie grant arts centre,2
+amata francisca,1
+sinha,2
+larissa loukianenko,1
+oceans apart&sa=u&ved=0ahukewjw4n6eqdblahun7gmkhxxebd8qfgg4mag&usg=afqjcnhhjagrbamjgaxc7rpsso4i9z jgw,1
+anemone heart,2
+alison mcinnes,1
+juan lindo,1
+mahesh bhupati,1
+baháí faith in taiwan,5
+cinema impero,1
+template talk rob thomas,1
+likin,1
+science & faith,1
+fort saint elmo,3
+delhi kumar,6
+juha lallukka,1
+situational sexual behavior,2
+milligan indiana,1
+william em lands,1
+karl anselm duke of urach,2
+hérold goulon,1
+vedic mathematics,20
+move to this,1
+koussan,1
+floored,1
+raghu nandan mandal,1
+angels gods secret agents,1
+orthogonal,2
+the little house on the prairie,1
+chilean pintail,1
+guardian angel,2
+st leonard maryland,1
+green parties in the united kingdom,1
+time to say goodbye,1
+alba michigan,2
+harbourfront centre,1
+corner tube boiler,1
+consensus government,1
+ppru 1,1
+corporate anniversary,4
+sazerac company,5
+kyle friend,1
+bmw k1100lt,1
+pergola marche,1
+commonwealth of kentucky,2
+taiwan passport,2
+clare quilty,1
+domenico caprioli,1
+frank m hull,1
+cheng sui,2
+nazi board games,3
+spark bridge,1
+derrick thomas,6
+wunnumin 1,1
+emotion remixed +,4
+brian howard dix,2
+brigalow queensland,2
+burgi dynasty,1
+apolonia supermercados,1
+brandon lafell,2
+one day,24
+nara period,9
+template talk the land before time,1
+assyrians in iraq,1
+trade union reform and employment rights act 1993,2
+template talk evansville crimson giants seasons,1
+boys be smile / 目覚めた朝にはきみが隣に,2
+kapuloan sundha kecil,1
+human impact of internet use,1
+kolkata metro line 2,3
+saint pardoux morterolles,1
+carfin grotto,2
+samuel johnson prize,3
+french royal family,1
+android app //orgwikipedia/http/enmwikipediaorg/wiki/victoria park,1
+mazda xedos 9,1
+măiestrit,1
+petroleum economist,2
+penetration,2
+adrian rawlins,8
+plutonium 239,11
+culture of montreal,1
+british germans,2
+warszawa wesoła railway station,1
+lorenzo di bonaventura,6
+military ranks of estonia,1
+uss flint,8
+arthur f defranzo,1
+sadeh,1
+jammu and kashmir,3
+igor budan,2
+charmila,2
+choi,1
+mohammed ali khan walajah,1
+sourabh varma,1
+after here through midland,1
+martyn day,1
+justin larouche,1
+illinoiss 6th congressional district,4
+jackson wy,1
+tyson apostol,4
+mitch morse,1
+robert davila,1
+canons regular of saint john cantius,1
+giant girdled lizard,2
+cascade volcanoes,5
+fools day,1
+cordyline indivisa,1
+pueraria,2
+swiss folklore,4
+meretz,3
+united states senate elections 1836 and 1837,1
+baby i need your love/ easy come easy go,1
+butrus al bustani,2
+the lion the lamb the man,1
+rushikulya,1
+brickworks,3
+alliance party of kenya,1
+ludlow college,1
+internationalism,11
+ernest halliwell,1
+constantine phipps 1st marquess of normanby,1
+kari ye bozorg,1
+signal flow,4
+i beam,1
+devils lake,1
+union of artists of the ussr,2
+index of saint kitts and nevis related articles,1
+ethernet physical layer,18
+dimensional analysis,16
+anatomical directions,2
+supreme court of guam,1
+sentul kuala lumpur,2
+ducefixion,1
+red breasted merganser,4
+reservation,3
+in the land of blood and honey,9
+kate spade,2
+albina airstrip,1
+kankakee,1
+servicelink,2
+castilleja levisecta,1
+tonmeister,2
+chanda sahib,1
+lists of patriarchs archbishops and bishops,1
+mach zehnder modulator,1
+giants causeway,79
+literal,7
+uss gerald r ford,1
+monster hunter portable 3rd,3
+bayern munich v norwich city,1
+banking industry,1
+prankton united,1
+st elmo w acosta,1
+speech disorder,9
+welcome to my dna,1
+nouriel roubini,6
+arthur kill,2
+bill grundy,7
+jake gyllenhaal,1
+world bowl 2000,1
+wnt7a,1
+pink flamingo,2
+tridentine calendar,1
+ray ratto,1
+f 88 voodoo,1
+super star,4
+ondřej havelka,1
+sophia dorothea of celle,12
+clavulina tepurumenga,1
+vampire bats,4
+ihsan,1
+ocotea foetens,1
+gannett inc,1
+kemira,4
+gre–nal,2
+farm bureau mutual,1
+pete fox,1
+let him have it,3
+backwoods home magazine,6
+te reo maori remixes,1
+hussain andaryas,1
+bagun sumbrai,1
+the westin paris – vendôme,4
+xochiquetzal,4
+players tour championship 2013/2014,1
+picnic,7
+josh elliott,5
+ernak,3
+gracias,1
+k280ff,1
+bandaranaike–chelvanayakam pact,1
+patrick baert,1
+nausicaä of the valley of the wind,33
+al jurisich,1
+twitter,230
+window,38
+the power hour,1
+duplex worm,1
+sonam bajwa,16
+baljit singh deo,1
+indian jews,1
+outline of madagascar,1
+outback 8,1
+dye fig,1
+british columbia recall and initiative referendum 1991,1
+felipe suau,1
+north perry ohio,1
+gilbeys gin,1
+philippe cavoret,1
+luděk pachman,1
+the it girl,1
+dragonnades,1
+rick debruhl,2
+xpath 20,2
+sean mcnulty,1
+william moser,1
+international centre for the settlement of investment disputes,1
+mendes napoli,2
+canadian rugby championship,1
+battle of maidstone,2
+boulevard theatre,2
+snow sheep,3
+penalty corner,1
+michael ricketts,5
+crocodile,2
+job safety analysis,5
+duffy antigen,1
+counties of virginia,1
+a place to bury strangers,5
+socialist workers’ party of iran,1
+wlw t,1
+core autosport,1
+west francia,10
+karen kilgariff,2
+pacific tsunami museum,1
+first avenue,1
+troubadour,1
+great podil fire,1
+chilean presidential referendum 1988,1
+pavol schmidt,1
+handguard,1
+crime without passion,1
+dio at donington uk live 1983 & 1987,1
+optic nerves,1
+wake forest school of medicine,1
+new jersey jewish news,2
+luke boden,2
+chris hicky,1
+beforu,2
+verch,1
+st roch,3
+civitas,1
+tmrevolution,3
+jamie spencer,1
+bond beam,1
+megan fox,4
+battle of bayan,1
+japan airlines flight 472,1
+yuen kay san,1
+the friendly ghost,1
+rice,14
+jack dellal,16
+lee ranaldo,9
+the overlanders,1
+earl castle stewart,5
+first down,1
+rheum maximowiczii,1
+washington state republican party,2
+ostwald bas rhin,1
+tennessee open,1
+kenneth kister,1
+ted kennedy,72
+preben elkjaer,1
+india reynolds,2
+santagata de goti,1
+henrietta churchill 2nd duchess of marlborough,1
+creteil,1
+ntt data,3
+zoot allures,4
+theatre of ancient greece,29
+bujinkan,6
+clube ferroviário da huíla,2
+nhn,4
+hp series 80,2
+interstate 15,4
+moszczanka,1
+lawnside school district,1
+virunga mountains,5
+hallway,1
+serb peoples radical party,1
+free dance,1
+mishawaka amphitheatre,1
+deerhead kansas,1
+utopiayile rajavu,1
+john w olver transit center,1
+futa tooro,1
+digoxigenin,5
+thomas schirrmacher,1
+twipra kingdom,1
+pulpwood,6
+think blue linux,1
+raho city taxi,1
+frederic remington art museum,1
+wajdi mouawad,1
+semi automatic firearm,12
+phyllis chase,1
+malden new york,1
+the aetiology of hysteria,2
+my maserati does 185,1
+friedrich wilhelm von jagow,1
+apne rang hazaar,1
+bór greater poland voivodeship,1
+india rubber,2
+bring your daughter to the slaughter,4
+yasser radwan,1
+kuala ketil,1
+notre dame de paris,1
+yuanjiang,1
+fengjuan,1
+tockenham,1
+transnistrian presidential election 1991,1
+gautami,28
+providenciales airport,1
+donald chumley,1
+middle finger,8
+calke abbey,4
+thou shalt not kill,1
+trail,7
+battle of dunkirk,43
+eyre yorke block,3
+mactan,3
+american ninja warrior,2
+nevel papperman,1
+ninja storm power rangers,1
+uss castle rock,1
+turcos,1
+philippine sea frontier,1
+irom chanu sharmila,7
+for the first time,2
+stian ringstad,1
+tréon,1
+hiro fujikake,1
+renewable energy in norway,4
+dedh ishqiya,18
+leucothoe,2
+ecmo,2
+knfm,1
+gangnam gu,1
+oadby town fc,1
+clamperl,2
+mummy cave,2
+kenneth d bailey,2
+peter freuchen,2
+dayanand bandodkar,2
+shawn crahan,16
+barbara trentham,2
+university of virginia school of nursing,1
+vöckla,1
+intuitive surgical inc,1
+cyncoed,4
+john l stevens,1
+daniel farabello,1
+trent harmon,5
+feroze gandhi unchahar thermal power station,1
+samuel powell,1
+pan slavic,1
+swimming at the 1992 summer olympics – womens 4 × 100 metre freestyle relay,1
+human behaviour,2
+siege of port royal,3
+eridug,1
+lafee,1
+north bethesda trail,1
+scheveningen system,1
+special penn thing,1
+pserimos,1
+pravda vítězí,1
+wiki dankowska,1
+transcript,13
+second inauguration of grover cleveland,1
+spent fuel,1
+ertms regional,2
+frederick scherger,1
+nivis,1
+herbert hugo menges,1
+kapitan sino,1
+samson,34
+minae mizumura,2
+gro kvinlog,1
+chasing shadows,2
+d j fontana,1
+massively multiplayer online game,27
+capture of new orleans,8
+meat puppet,1
+american pet products manufacturers association,3
+villardonnel,1
+sessile serrated adenoma,3
+patch products,1
+lodovico altieri,1
+portal,2
+jake maskall,4
+the shops at la cantera,8
+stage struck,5
+elizabeth m tamposi,2
+taylor swift,22
+forum spam,9
+barry cowdrill,3
+patagopteryx,2
+korg ms 2000,1
+hmas dubbo,2
+ss khaplang,2
+kevin kelly,1
+punk goes pop volume 5,3
+spurt,2
+bristol pound,5
+military history of finland during world war ii,10
+laguardia,1
+josé marcó del pont,1
+conditional expectation,18
+the beat goes on,1
+patricia buckley ebrey,1
+ali ibn yusuf,2
+caristii,1
+william l brandon,1
+fomite,5
+barcelona el prat airport,7
+mattequartier,4
+invading the sacred,1
+jefferson station,3
+chibalo,1
+phil voyles,1
+ramen,41
+archbishopric of athens,1
+robert arnot,1
+diethylhydroxylamine,2
+christian vazquez,1
+servage hosting,1
+ufo alien invasion,1
+blackburn railway station,3
+performance metric,19
+pencilings,1
+phosphoenolpyruvate,1
+under lights,2
+diego de la hoya,1
+felipe caicedo,5
+jimmy arguello,1
+cielo dalcamo,1
+jan navrátil,1
+linear pottery culture,9
+wbga,1
+k36dd,1
+die hard 2,22
+companding,8
+this is the modern world,10
+cosmology,26
+craig borten,1
+red pelicans,1
+ac gilbert,2
+fougasse,1
+leonardos robot,4
+john of whithorn,2
+david prescott barrows,2
+http cookie,168
+emilia telese,6
+herăstrău park,2
+lauro villar,1
+earl of lincoln,1
+born again,2
+milan rufus,1
+weper,2
+levitt bernstein,1
+jean de thevenot,1
+jill paton walsh,2
+leudal,1
+kyle mccafferty,1
+pluralistic walkthrough,2
+greetings to the new brunette,3
+angus maccoll,1
+loco live,2
+palm i705,1
+saila laakkonen,1
+ssta,1
+buch,1
+eduardo cunha,7
+marie bouliard,1
+mystic society,2
+chu jus house,1
+boob tube,8
+il mestiere della vita,1
+hadley fraser,7
+marek larwood,2
+imperial knight,2
+adbc,1
+houdini,8
+patrice talon,3
+iodamoeba,1
+long march,26
+nyinba,1
+maurice dunkley,1
+new south wales state election 1874–75,1
+john lee carroll,1
+poya bridge,1
+category talk military units and formations established in 2004,1
+the family values tour 1999,2
+brødrene hartmann,1
+miomelon,1
+john moran bailey,1
+san juan archipelago,1
+come as you are,7
+hypo niederösterreich,1
+saturn vi,2
+cherokee county kansas,1
+maher abu remeleh,1
+file talk jb grace singlejpg,1
+count paris,8
+template talk anime and manga,1
+kntv,4
+ganges river dolphin,4
+jerry pacht,1
+rapid response,1
+crunch bandicoot,1
+big gay love,2
+john mckay,1
+bareq,1
+nikon d2x,1
+intercontinental paris le grand hotel,1
+oakland alternative high school,1
+ekow eshun,1
+jimmy fortune,1
+american gladiator,2
+ella sophia armitage,1
+united we stand what more can i give,5
+maruti suzuki celerio,1
+geraldo rivera/trackback/,1
+dogs tobramycin contain a primary amine,1
+hot coffee mod,11
+shriners,25
+mora missouri,1
+seattle wa,1
+all star baseball 2003,1
+comparison of android e book reader software,7
+calling out loud,2
+initiative 912,1
+charles batchelor,2
+terry spraggan,2
+wallace thurman,2
+stefan smith,2
+george holding,22
+institute of business administration sukkar,1
+staten island new york,4
+valency,1
+chintamani taluk,1
+mahatma gandhi,1
+co orbital,1
+epex spot,1
+theodoric the great,3
+fk novi pazar,1
+zappas olympics,2
+gustav krupp von bohlen und halbach,1
+yasmany tomás,4
+notre temps,1
+cats %,1
+intramolecular vibrational energy redistribution,1
+graduate management admission test,49
+robin fleming,1
+daniel gadzhev,1
+achaean league,7
+the four books,1
+tunica people,1
+murray hurst,1
+hajipur,7
+wolfgang fischer,1
+bethel minnesota,2
+wincdemu,1
+aleksandar luković,5
+zilog,6
+will to live,1
+pgc,1
+captain sky,1
+eprobemide,1
+gunther plüschow,1
+jackson laboratory,3
+ss orontes,2
+bishop morlino,1
+eldorado air force station,2
+tin oxide,1
+john bell,2
+ajay banga,2
+nail polish remover induced contact dermatitis,1
+quinctia,1
+a/n urm 25d signal generator,1
+the art company,3
+seawind 300c,1
+half and half,7
+constantia czirenberg,1
+halifax county north carolina,4
+tunica vaginalis,9
+life & times of michael k,2
+methyl propionate,1
+carla bley band,1
+us secret service,2
+maría elena moyano,2
+lory meagher cup,9
+malay sultanate,1
+third lanark,1
+olivier dacourt,10
+angri,2
+ukrainian catholic eparchy of saints peter and paul,1
+phosphinooxazolines,1
+allied health professions,24
+hydroxybenzoic acid,1
+srinatha,3
+zone melting,5
+miko,1
+robert b downs,1
+resource management,3
+new year tree,1
+agraw imazighen,1
+catmando,8
+python ide,5
+rocky mount wilson roanoke rapids nc combined statistical area,1
+spanish crown,3
+ianis zicu,1
+william c hubbard,2
+islamic marital jurisprudence,5
+the school of night,1
+krdc,4
+el centro imperials,1
+atiq uz zaman,1
+sliba zkha,1
+file no mosquesvg,8
+herzegovinians,1
+paradise lost,1
+the fairly oddparents,6
+civic alliance,1
+anbu,3
+broadcaster,2
+le bon,1
+columbus nebraska,4
+inuit people,1
+the menace,6
+ilya ilyich mechnikov,1
+algonquin college,4
+seat córdoba wrc,1
+european route e30,6
+three lakes florida,1
+k10de,1
+glyphonyx rhopalacanthus,1
+ask rhod gilbert,1
+bolas criollas,1
+county borough of southport,1
+roll on mississippi,1
+pulitzer prize for photography,7
+mark fisher,1
+oakley g kelly,1
+tajikistani presidential election 1999,1
+the relapse,4
+nabil bentaleb,8
+apprentice,1
+dale brown,3
+studebaker packard hawk series,1
+yu gi oh trading card game,14
+paralimni,2
+institut national polytechnique de toulouse,1
+to catch a spy,1
+hammer,4
+mount judi,2
+thomas posey,1
+maxime baca,1
+arthur susskind,1
+elkins constructors,2
+siege of gaeta,1
+pemex,1
+henry o flipper award,1
+mccordsville indiana,1
+carife,1
+prima donna,1
+proton,1
+henry farrell,1
+randall davidson,1
+history of georgia,11
+beef tongue,4
+ted spread,4
+douglas xt 30,3
+heavenly mother,1
+monte santangelo,1
+lothar matthaus,1
+american party,2
+tire kingdom,1
+bastrop state park,3
+james maurice gavin,1
+blue bird all american,4
+time and a word,10
+runny babbit,1
+nordic regional airlines,6
+advanced scientifics,2
+the space traders,2
+mongol invasion of anatolia,1
+abu hayyan al gharnati,1
+lisa geoghan,3
+valentia harbour railway station,1
+silo,10
+jimmy zhingchak,1
+glamma kid,1
+bonneville high school,1
+secant line,5
+the longshots,2
+costa rican general election 1917,1
+an emotion away,1
+rawlins high school,1
+cold inflation pressure,4
+receptionthe,2
+tom payne,8
+tb treatment,1
+hatikvah,8
+ol yellow eyes is back,1
+vincent mroz,1
+travis bickle,1
+qatar stars league 1985–86,1
+electronic document management,1
+orliska,1
+gáspár orbán,1
+sunabeda,1
+donatus magnus,1
+lawrence e spivak,2
+cavalieri,1
+aw kuchler,1
+coat of arms of kuwait,1
+wallis–zieff–goldblatt syndrome,1
+doug heffernan,3
+g3 battlecruiser,3
+imran abbas,1
+plymouth,1
+gould colorado,1
+in japan,1
+delmar watson,1
+skygusty west virginia,1
+vesque sisters,1
+rushton triangular lodge,1
+italic font,3
+warner w hodgdon carolina 500,1
+blackamoors,5
+magna cum laude,14
+follow that horse,1
+jean snella,1
+chris frith,1
+soul power,2
+spare me the details,1
+ymer xhaferi,1
+murano glass,5
+michel magras,1
+rashard and wallace go to white castle,1
+venus figurines of malta,1
+didnt we almost have it all,1
+ew,1
+david h koch institute for integrative cancer research,2
+black coyote,1
+priob,2
+piera coppola,1
+budhism,4
+south african class h1 4 8 2t,1
+dimitris papamichael+dimitris+papamixail,3
+system sensor,1
+farragut class destroyer,1
+no down payment,1
+william rogers,1
+desperate choices to save my child,1
+joe launchbury,7
+queen seondeok of silla,11
+adams county wisconsin,1
+bandhan bank,1
+x ray tubes,1
+sporadic group,1
+lozovaya,1
+mairead maguire,3
+royal challengers bangalore in 2016,1
+janko of czarnków,1
+marosormenyes,1
+the deadly reclaim,1
+rick doblin,1
+gwen jorgensen,6
+shire of halls creek,1
+carlton house,6
+urad bean,1
+baton rouge louisiana,39
+kiel institute for the world economy,3
+the satuc cup,1
+harlem division,1
+argonaut,2
+choi jeongrye,2
+optical disc image,2
+groesbeek canadian war cemetery,2
+rangpur india,1
+android n,72
+tjeld class patrol boat,1
+together for yes,2
+tender dracula,1
+shane nelson,1
+palazzo ducale urbino,1
+angels,4
+double centralizer theorem,1
+homme,4
+world heart federation,1
+patricia ja lee,4
+a date with elvis,1
+saints row,1
+lanzhou lamian,1
+subcompact car,1
+jojo discography,5
+gary,18
+global returnable asset identifier,1
+aloysia weber,2
+emperor nero,2
+heavyweights,6
+hush records,1
+mewa textil service,2
+michigan gubernatorial election 1986,1
+solanine,9
+andré moritz,3
+foreign relations of china,12
+william t anderson,3
+lindquist field,1
+biggersdale hole,1
+manayunk/norristown line,1
+aliti,1
+budhivanta,3
+tm forum,4
+off plan property,1
+wu xin the monster killer,4
+aharon leib shteinman,1
+mark catano,1
+llanfihangel,1
+atp–adp translocase,4
+tótkomlós,1
+nikita magaloff,1
+xo telescope,1
+pseudomonas rhizosphaerae,1
+pccooler,1
+arcion therapeutics inc,8
+oklahoma gubernatorial election 2010,1
+seed treatment,3
+connecticut education network,1
+company85,1
+bryan molloy,1
+roupeiro,1
+wendt beach park,2
+entick v carrington,3
+firemens auxiliary,1
+shotcrete,14
+sepharial,1
+poet laureate of virginia,1
+musth,6
+dragon run state forest,3
+focal point,10
+pacific drilling,1
+intro,2
+priscus,1
+rokurō mochizuki,1
+bofur,2
+tiffany mount,1
+thanasis papazoglou,12
+life is grand,1
+ergersheim bas rhin,1
+medical reserve corps,3
+anthony ashley cooper 2nd earl of shaftesbury,1
+uefa euro 2012 group a,32
+america movil sab de cv,1
+christopher cook,1
+vladimir makanin,1
+file talk first battle of saratogausmaeduhistorygif,1
+dean foods,4
+logical thinking,1
+tychonic system,1
+hand washing,17
+bioresonance therapy,4
+günther burstyn,4
+religion in the united kingdom,35
+bancroft ontario,2
+alberta enterprise group,1
+belizean spanish,1
+minuscule 22,1
+hmga2,3
+sidama people,1
+shigeaki mori,2
+moonstars,1
+hazard,24
+chilis,6
+rango,3
+kenichi itō,1
+isle of rum,1
+shortwood united fc,1
+bronx gangs,1
+heterometaboly,2
+beagling,4
+jurgen pommerenke,1
+rockin,1
+st maria maggiore,1
+philipp reis,1
+timeboxing,12
+template talk tallahassee radio,1
+aarti puri,2
+john paul verree,2
+adam tomkins,1
+knoppers,1
+sven olov eriksson,1
+ruth bowyer,1
+höfðatorg tower 1,1
+citywire,3
+helen bosanquet,1
+ulex europaeus,4
+richard martyn,1
+hana sugisaki,2
+its all over now baby blue,6
+the myths and legends of king arthur and the knights of the round table,2
+dooce,1
+german submarine u 9,1
+george shearing,4
+bishop of winchester,3
+maximilian karl lamoral odonnell,2
+hec edmundson,1
+morgawr,3
+sovereign state,67
+avignon—la mitis—matane—matapédia,1
+duramax v8 engine,12
+villa rustica,2
+carl dorsey,1
+clairol,6
+abruzzo,22
+momsen lung,10
+m23 rebellion,2
+kira oreilly,1
+constitutive relation,2
+bifrontal craniotomy,1
+basilica of st nicholas amsterdam,2
+marinus kraus,1
+moog prodigy,2
+lucy hale,49
+lingiya,1
+idiopathic orbital inflammatory disease,3
+shaanxi youser group,1
+apeirohedron,1
+program of all inclusive care for the elderly,2
+tv3 ghana,3
+arnold schwarzenegger,338
+raquel carriedo tomás,1
+cincinnati playhouse in the park,2
+colobomata,2
+star craft 2,1
+yaaf,1
+fc santa clarita,1
+release me,3
+notts county supporters trust,1
+westchester airport,1
+slowhand at 70 – live at the royal albert hall,1
+bruce gray,2
+only the good die young,1
+sewell thomas stadium,1
+kyle cook,1
+northwest passage,1
+eurex airlines,1
+uss pierre,1
+feitsui dam,1
+sales force,1
+obrien class destroyer,5
+sant longowal institute of engineering and technology,3
+united states presidential election in oklahoma 1952,1
+edyta bartosiewicz,1
+marquess of dorset,1
+whiting wyoming,1
+akanda,1
+jim brewster,1
+mozdok republic of north ossetia alania,1
+maritime gendarmerie,2
+paresh patel,1
+communication art,1
+santa anita handicap,2
+dahlia,44
+qikpad,1
+pudhaiyal,3
+oroshi,1
+ioda,3
+willis j gertsch,1
+scurvy grass,1
+bombing of rotterdam,2
+gagarin russia,1
+dynamic apnea without fins,1
+loess,14
+hans adolf krebs,4
+poręby stare,1
+kismat ki baazi,1
+malcolm slesser,1
+blue crane route local municipality,1
+jean michel basquiat,104
+customs trade partnership against terrorism,3
+lower cove newfoundland and labrador,1
+aashiqui 2,6
+elliott lee,1
+edison electric light company,2
+i rigoberta menchú,1
+battle of tennōji,2
+transport workers union of america,1
+physical review b,1
+way too far,1
+breguet 941,1
+manuel hegen,1
+the blacklist,12
+john dorahy,4
+cinderella sanyu,1
+luis castañeda lossio,1
+headquarters of a military area,1
+jbala people,2
+petrofac emirates,1
+ins garuda,3
+australia national rugby league team,2
+state of emergency 2,3
+mexican sex comedy,2
+baby anikha,1
+notions,1
+android app //orgwikipedia/http/enmwikipediaorg/wiki/elasticity,1
+kissing you,2
+montearagón,1
+grzegorz proksa,3
+shook,1
+may hegglin anomaly,1
+chrysler rb engine,2
+gmcsf,2
+blacksburg,1
+chris hollod,1
+the new guy,1
+thulimbah queensland,1
+sust,1
+knight kadosh,2
+details,4
+nickel mining in new caledonia,3
+easter hotspot,1
+surinamese interior war,1
+field corn,2
+bolesław iii wrymouth,6
+lutwyche queensland,1
+michael campbell,1
+military ranks of turkey,3
+mícheal martin,1
+the architects dream,2
+joel robert,1
+thomas smith,1
+inclusion probability,1
+fucked company,1
+genderfluid,5
+lewisham by election 1891,1
+net promoter,98
+donald stewart,1
+xml base,2
+bhikhu parekh,4
+anthocharis cardamines,1
+vuosaari,1
+demographics of burundi,1
+dst,1
+david ensor,2
+mount pavlof,1
+vince young,5
+st beunos ignatian spirituality centre,4
+ezekiel 48,1
+lewis elliott chaze,1
+template talk croatia squad 2012 mens european water polo championship,1
+the voice of the philippines,4
+whites ferry,1
+cananga odorata,9
+man of steel,2
+john michael talbot,2
+superior oblique myokymia,2
+anisochilus,2
+e421,1
+midnight rider,14
+matrícula consular,1
+first nehru ministry,2
+christopher mcculloch,2
+ems chemie,12
+dominique martin,1
+university club of washington dc,1
+nurse education,5
+theyre coming to take me away ha haaa,1
+bill dauterive,4
+belhar,1
+heel and toe,4
+university of the arctic members,2
+mitava,1
+wjmx fm,1
+father callahan,4
+divine word academy of dagupan,1
+bogs,1
+denny heck,2
+church of st james valletta,1
+field cathedral of the polish army,1
+indian skimmer,1
+history of british airways,3
+international mobile subscriber identity,38
+suzel roche,1
+steven watt,1
+duke ellineton,1
+kirbys avalanche,4
diff --git a/tests/testdata/will_play_text.csv.bz2 b/tests/testdata/will_play_text.csv.bz2
new file mode 100755
index 0000000000000000000000000000000000000000..e3bec9de829086914c2f4e35f6ab38b750648b44
GIT binary patch
literal 2069623
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%0DX~4BL-)
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%0AjfCy*2N1KHx?BY
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%0AXkA5RQTc?Kg{x>~m+uP$W&f?^m%iBoI=h8se
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
Ak^lez

literal 0
HcmV?d00001

diff --git a/tox.ini b/tox.ini
index 78052963c6..7d79d38f13 100644
--- a/tox.ini
+++ b/tox.ini
@@ -1,7 +1,7 @@
 [pytest]
 addopts = -s
 markers =
-    json: run only the redisjson module tests
+    redismod: run only the redis module tests
 
 [tox]
 minversion = 3.2.0

From 8924504f9875d3c80733504d6f6923f5611ebf17 Mon Sep 17 00:00:00 2001
From: AbdealiJK <abdealikothari@gmail.com>
Date: Tue, 26 Oct 2021 00:45:25 +0530
Subject: [PATCH 0210/1164] sentinel: Add SentinelManagedSSLConnection (#1419)

Create a simple class which takes in both:
 - SentinelManaged
 - SSLConnection
in cases where the sentinel is being used with a TLS enabled redis
setup.
---
 redis/sentinel.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/redis/sentinel.py b/redis/sentinel.py
index 6456b8e868..740d92f983 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -3,7 +3,7 @@
 
 from redis.client import Redis
 from redis.commands import SentinelCommands
-from redis.connection import ConnectionPool, Connection
+from redis.connection import ConnectionPool, Connection, SSLConnection
 from redis.exceptions import (ConnectionError, ResponseError, ReadOnlyError,
                               TimeoutError)
 from redis.utils import str_if_bytes
@@ -66,6 +66,10 @@ def read_response(self):
             raise
 
 
+class SentinelManagedSSLConnection(SentinelManagedConnection, SSLConnection):
+    pass
+
+
 class SentinelConnectionPool(ConnectionPool):
     """
     Sentinel backed connection pool.

From 70ef9ec68f9163c86d4cace2941e2f0ae4ce8525 Mon Sep 17 00:00:00 2001
From: David <elaman10@gmail.com>
Date: Tue, 26 Oct 2021 00:14:29 -0700
Subject: [PATCH 0211/1164] Convert README & CONTRIBUTING from rst to md
 (#1633)

---
 CONTRIBUTING.md  | 176 +++++++++
 CONTRIBUTING.rst | 137 -------
 README.md        | 962 ++++++++++++++++++++++++++++++++++++++++++++++
 README.rst       | 970 -----------------------------------------------
 4 files changed, 1138 insertions(+), 1107 deletions(-)
 create mode 100644 CONTRIBUTING.md
 delete mode 100644 CONTRIBUTING.rst
 create mode 100644 README.md
 delete mode 100644 README.rst

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000000..31170f3718
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,176 @@
+# Contributing
+
+## Introduction
+
+First off, thank you for considering contributing to redis-py. We value
+community contributions!
+
+## Contributions We Need
+
+You may already know what you want to contribute \-- a fix for a bug you
+encountered, or a new feature your team wants to use.
+
+If you don\'t know what to contribute, keep an open mind! Improving
+documentation, bug triaging, and writing tutorials are all examples of
+helpful contributions that mean less work for you.
+
+## Your First Contribution
+
+Unsure where to begin contributing? You can start by looking through
+[help-wanted
+issues](https://github.com/andymccurdy/redis-py/issues?q=is%3Aopen+is%3Aissue+label%3ahelp-wanted).
+
+Never contributed to open source before? Here are a couple of friendly
+tutorials:
+
+-   <http://makeapullrequest.com/>
+-   <http://www.firsttimersonly.com/>
+
+## Getting Started
+
+Here\'s how to get started with your code contribution:
+
+1.  Create your own fork of redis-py
+2.  Do the changes in your fork
+3.  
+    *Create a virtualenv and install the development dependencies from the dev_requirements.txt file:*
+
+        a.  python -m venv .venv
+        b.  source .venv/bin/activate
+        c.  pip install -r dev_requirements.txt
+
+4.  If you need a development environment, run `invoke devenv`
+5.  While developing, make sure the tests pass by running `invoke tests`
+6.  If you like the change and think the project could use it, send a
+    pull request
+
+To see what else is part of the automation, run `invoke -l`
+
+## The Development Environment
+
+Running `invoke devenv` installs the development dependencies specified
+in the dev_requirements.txt. It starts all of the dockers used by this
+project, and leaves them running. These can be easily cleaned up with
+`invoke clean`. NOTE: it is assumed that the user running these tests,
+can execute docker and its various commands.
+
+-   A master Redis node
+-   A Redis replica node
+-   Three sentinel Redis nodes
+-   A multi-python docker, with your source code mounted in /data
+
+The replica node, is a replica of the master node, using the
+[leader-follower replication](https://redis.io/topics/replication)
+feature.
+
+The sentinels monitor the master node in a [sentinel high-availability
+configuration](https://redis.io/topics/sentinel).
+
+## Testing
+
+Each run of tox starts and stops the various dockers required. Sometimes
+things get stuck, an `invoke clean` can help.
+
+Continuous Integration uses these same wrappers to run all of these
+tests against multiple versions of python. Feel free to test your
+changes against all the python versions supported, as declared by the
+tox.ini file (eg: tox -e py39). If you have the various python versions
+on your desktop, you can run *tox* by itself, to test all supported
+versions. Alternatively, as your source code is mounted in the
+**lots-of-pythons** docker, you can start exploring from there, with all
+supported python versions!
+
+### Docker Tips
+
+Following are a few tips that can help you work with the Docker-based
+development environment.
+
+To get a bash shell inside of a container:
+
+`$ docker run -it <service> /bin/bash`
+
+**Note**: The term \"service\" refers to the \"services\" defined in the
+`tox.ini` file at the top of the repo: \"master\", \"replicaof\",
+\"sentinel_1\", \"sentinel_2\", \"sentinel_3\".
+
+Containers run a minimal Debian image that probably lacks tools you want
+to use. To install packages, first get a bash session (see previous tip)
+and then run:
+
+`$ apt update && apt install <package>`
+
+You can see the logging output of a containers like this:
+
+`$ docker logs -f <service>`
+
+The command make test runs all tests in all tested Python
+environments. To run the tests in a single environment, like Python 3.6,
+use a command like this:
+
+`$ docker-compose run test tox -e py36 -- --redis-url=redis://master:6379/9`
+
+Here, the flag `-e py36` runs tests against the Python 3.6 tox
+environment. And note from the example that whenever you run tests like
+this, instead of using make test, you need to pass
+`-- --redis-url=redis://master:6379/9`. This points the tests at the
+\"master\" container.
+
+Our test suite uses `pytest`. You can run a specific test suite against
+a specific Python version like this:
+
+`$ docker-compose run test tox -e py36 -- --redis-url=redis://master:6379/9 tests/test_commands.py`
+
+### Troubleshooting
+
+If you get any errors when running `make dev` or `make test`, make sure
+that you are using supported versions of Docker.
+
+Please try at least versions of Docker.
+
+-   Docker 19.03.12
+
+## How to Report a Bug
+
+### Security Vulnerabilities
+
+**NOTE**: If you find a security vulnerability, do NOT open an issue.
+Email Andy McCurdy (<sedrik@gmail.com>) instead.
+
+In order to determine whether you are dealing with a security issue, ask
+yourself these two questions:
+
+-   Can I access something that\'s not mine, or something I shouldn\'t
+    have access to?
+-   Can I disable something for other people?
+
+If the answer to either of those two questions are \"yes\", then you\'re
+probably dealing with a security issue. Note that even if you answer
+\"no\" to both questions, you may still be dealing with a security
+issue, so if you\'re unsure, just email Andy at <sedrik@gmail.com>.
+
+### Everything Else
+
+When filing an issue, make sure to answer these five questions:
+
+1.  What version of redis-py are you using?
+2.  What version of redis are you using?
+3.  What did you do?
+4.  What did you expect to see?
+5.  What did you see instead?
+
+## How to Suggest a Feature or Enhancement
+
+If you\'d like to contribute a new feature, make sure you check our
+issue list to see if someone has already proposed it. Work may already
+be under way on the feature you want \-- or we may have rejected a
+feature like it already.
+
+If you don\'t see anything, open a new issue that describes the feature
+you would like and how it should work.
+
+## Code Review Process
+
+The core team looks at Pull Requests on a regular basis. We will give
+feedback as as soon as possible. After feedback, we expect a response
+within two weeks. After that time, we may close your PR if it isn\'t
+showing any activity.
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
deleted file mode 100644
index ba1ddfc5cc..0000000000
--- a/CONTRIBUTING.rst
+++ /dev/null
@@ -1,137 +0,0 @@
-Contributing
-============
-
-Introduction
-------------
-
-First off, thank you for considering contributing to redis-py. We value community contributions!
-
-Contributions We Need
-----------------------
-
-You may already know what you want to contribute -- a fix for a bug you encountered, or a new feature your team wants to use.
-
-If you don't know what to contribute, keep an open mind! Improving documentation, bug triaging, and writing tutorials are all examples of helpful contributions that mean less work for you.
-
-Your First Contribution
------------------------
-Unsure where to begin contributing? You can start by looking through `help-wanted issues <https://github.com/andymccurdy/redis-py/issues?q=is%3Aopen+is%3Aissue+label%3ahelp-wanted>`_.
-
-Never contributed to open source before? Here are a couple of friendly tutorials:
-
-- http://makeapullrequest.com/
-- http://www.firsttimersonly.com/
-
-Getting Started
----------------
-
-Here's how to get started with your code contribution:
-
-1. Create your own fork of redis-py
-2. Do the changes in your fork
-3. Create a virtualenv and install the development dependencies from the dev_requirements.txt file:
-    a. python -m venv .venv
-    b. source .venv/bin/activate
-    c. pip install -r dev_requirements.txt
-3. If you need a development environment, run ``invoke devenv``
-4. While developing, make sure the tests pass by running ``invoke tests``
-5. If you like the change and think the project could use it, send a pull request
-
-To see what else is part of the automation, run ``invoke -l``
-
-The Development Environment
----------------------------
-
-Running ``invoke devenv`` installs the development dependencies specified in the dev_requirements.txt. It starts all of the dockers used by this project, and leaves them running. These can be easily cleaned up with ``invoke clean``. NOTE: it is assumed that the user running these tests, can execute docker and its various commands.
-
-* A master Redis node
-* A Redis replica node
-* Three sentinel Redis nodes
-* A multi-python docker, with your source code mounted in /data
-
-The replica node, is a replica of the master node, using the `leader-follower replication <https://redis.io/topics/replication>`_ feature.
-
-The sentinels monitor the master node in a `sentinel high-availability configuration <https://redis.io/topics/sentinel>`_.
-
-Testing
--------
-
-Each run of tox starts and stops the various dockers required.  Sometimes things get stuck, an ``invoke clean`` can help.
-
-Continuous Integration uses these same wrappers to run all of these tests against multiple versions of python. Feel free to test your changes against all the python versions supported, as declared by the tox.ini file (eg: tox -e py39). If you have the various python versions on your desktop, you can run *tox* by itself, to test all supported versions. Alternatively, as your source code is mounted in the **lots-of-pythons** docker, you can start exploring from there, with all supported python versions!
-
-Docker Tips
-^^^^^^^^^^^
-
-Following are a few tips that can help you work with the Docker-based development environment.
-
-To get a bash shell inside of a container:
-
-``$ docker run -it <service> /bin/bash``
-
-**Note**: The term "service" refers to the "services" defined in the ``tox.ini`` file at the top of the repo: "master", "replicaof", "sentinel_1", "sentinel_2", "sentinel_3".
-
-Containers run a minimal Debian image that probably lacks tools you want to use. To install packages, first get a bash session (see previous tip) and then run:
-
-``$ apt update && apt install <package>``
-
-You can see the logging output of a containers like this:
-
-``$ docker logs -f <service>``
-
-The command `make test` runs all tests in all tested Python environments. To run the tests in a single environment, like Python 3.6, use a command like this:
-
-``$ docker-compose run test tox -e py36 -- --redis-url=redis://master:6379/9``
-
-Here, the flag ``-e py36`` runs tests against the Python 3.6 tox environment. And note from the example that whenever you run tests like this, instead of using `make test`, you need to pass ``-- --redis-url=redis://master:6379/9``. This points the tests at the "master" container.
-
-Our test suite uses ``pytest``. You can run a specific test suite against a specific Python version like this:
-
-``$ docker-compose run test tox -e py36 -- --redis-url=redis://master:6379/9 tests/test_commands.py``
-
-Troubleshooting
-^^^^^^^^^^^^^^^
-If you get any errors when running ``make dev`` or ``make test``, make sure that you
-are using supported versions of Docker.
-
-Please try at least versions of Docker.
-
-* Docker 19.03.12
-
-How to Report a Bug
--------------------
-
-Security Vulnerabilities
-^^^^^^^^^^^^^^^^^^^^^^^^
-
-**NOTE**: If you find a security vulnerability, do NOT open an issue. Email Andy McCurdy (sedrik@gmail.com) instead.
-
-In order to determine whether you are dealing with a security issue, ask yourself these two questions:
-
-* Can I access something that's not mine, or something I shouldn't have access to?
-* Can I disable something for other people?
-
-If the answer to either of those two questions are "yes", then you're probably dealing with a security issue. Note that even if you answer "no" to both questions, you may still be dealing with a security issue, so if you're unsure, just email Andy at sedrik@gmail.com.
-
-Everything Else
-^^^^^^^^^^^^^^^
-
-When filing an issue, make sure to answer these five questions:
-
-1. What version of redis-py are you using?
-2. What version of redis are you using?
-3. What did you do?
-4. What did you expect to see?
-5. What did you see instead?
-
-How to Suggest a Feature or Enhancement
----------------------------------------
-
-If you'd like to contribute a new feature, make sure you check our issue list to see if someone has already proposed it. Work may already be under way on the feature you want -- or we may have rejected a feature like it already.
-
-If you don't see anything, open a new issue that describes the feature you would like and how it should work.
-
-Code Review Process
--------------------
-
-The core team looks at Pull Requests on a regular basis. We will give feedback as as soon as possible. After feedback, we expect a response within two weeks. After that time, we may close your PR if it isn't showing any activity.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000000..1b535ae36f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,962 @@
+# redis-py
+
+The Python interface to the Redis key-value store.
+
+[![image](https://github.com/redis/redis-py/workflows/CI/badge.svg?branch=master)](https://github.com/redis/redis-py/actions?query=workflow%3ACI+branch%3Amaster) 
+[![image](https://readthedocs.org/projects/redis-py/badge/?version=stable&style=flat)](https://redis-py.readthedocs.io/en/stable/) 
+[![image](https://badge.fury.io/py/redis.svg)](https://pypi.org/project/redis/) 
+[![image](https://codecov.io/gh/redis/redis-py/branch/master/graph/badge.svg)](https://codecov.io/gh/redis/redis-py)
+
+## Python 2 Compatibility Note
+
+redis-py 3.5.x will be the last version of redis-py that supports Python
+2. The 3.5.x line will continue to get bug fixes and security patches
+that support Python 2 until August 1, 2020. redis-py 4.0 will be the
+next major version and will require Python 3.5+.
+
+## Installation
+
+redis-py requires a running Redis server. See [Redis\'s
+quickstart](https://redis.io/topics/quickstart) for installation
+instructions.
+
+redis-py can be installed using pip similar to other
+Python packages. Do not use sudo with pip.
+It is usually good to work in a
+[virtualenv](https://virtualenv.pypa.io/en/latest/) or
+[venv](https://docs.python.org/3/library/venv.html) to avoid conflicts
+with other package managers and Python projects. For a quick
+introduction see [Python Virtual Environments in Five
+Minutes](https://bit.ly/py-env).
+
+To install redis-py, simply:
+
+``` bash
+$ pip install redis
+```
+
+or from source:
+
+``` bash
+$ python setup.py install
+```
+
+## Contributing
+
+Want to contribute a feature, bug report, or report an issue? Check out
+our [guide to
+contributing](https://github.com/redis/redis-py/blob/master/CONTRIBUTING.rst).
+
+## Getting Started
+
+``` pycon
+>>> import redis
+>>> r = redis.Redis(host='localhost', port=6379, db=0)
+>>> r.set('foo', 'bar')
+True
+>>> r.get('foo')
+b'bar'
+```
+
+By default, all responses are returned as bytes in Python
+3 and str in Python 2. The user is responsible for
+decoding to Python 3 strings or Python 2 unicode objects.
+
+If **all** string responses from a client should be decoded, the user
+can specify decode_responses=True to
+Redis.\_\_init\_\_. In this case, any Redis command that
+returns a string type will be decoded with the encoding
+specified.
+
+The default encoding is \"utf-8\", but this can be customized with the
+encoding argument to the redis.Redis class.
+The encoding will be used to automatically encode any
+strings passed to commands, such as key names and values. When
+decode_responses=True, string data returned from commands
+will be decoded with the same encoding.
+
+## Upgrading from redis-py 2.X to 3.0
+
+redis-py 3.0 introduces many new features but required a number of
+backwards incompatible changes to be made in the process. This section
+attempts to provide an upgrade path for users migrating from 2.X to 3.0.
+
+### Python Version Support
+
+redis-py supports Python 3.5+.
+
+### Client Classes: Redis and StrictRedis
+
+redis-py 3.0 drops support for the legacy \"Redis\" client class.
+\"StrictRedis\" has been renamed to \"Redis\" and an alias named
+\"StrictRedis\" is provided so that users previously using
+\"StrictRedis\" can continue to run unchanged.
+
+The 2.X \"Redis\" class provided alternative implementations of a few
+commands. This confused users (rightfully so) and caused a number of
+support issues. To make things easier going forward, it was decided to
+drop support for these alternate implementations and instead focus on a
+single client class.
+
+2.X users that are already using StrictRedis don\'t have to change the
+class name. StrictRedis will continue to work for the foreseeable
+future.
+
+2.X users that are using the Redis class will have to make changes if
+they use any of the following commands:
+
+-   SETEX: The argument order has changed. The new order is (name, time,
+    value).
+-   LREM: The argument order has changed. The new order is (name, num,
+    value).
+-   TTL and PTTL: The return value is now always an int and matches the
+    official Redis command (>0 indicates the timeout, -1 indicates that
+    the key exists but that it has no expire time set, -2 indicates that
+    the key does not exist)
+
+### SSL Connections
+
+redis-py 3.0 changes the default value of the
+ssl_cert_reqs option from None to
+\'required\'. See [Issue
+1016](https://github.com/redis/redis-py/issues/1016). This change
+enforces hostname validation when accepting a cert from a remote SSL
+terminator. If the terminator doesn\'t properly set the hostname on the
+cert this will cause redis-py 3.0 to raise a ConnectionError.
+
+This check can be disabled by setting ssl_cert_reqs to
+None. Note that doing so removes the security check. Do so
+at your own risk.
+
+Example with hostname verification using a local certificate bundle
+(linux):
+
+``` pycon
+>>> import redis
+>>> r = redis.Redis(host='xxxxxx.cache.amazonaws.com', port=6379, db=0,
+                    ssl=True,
+                    ssl_ca_certs='/etc/ssl/certs/ca-certificates.crt')
+>>> r.set('foo', 'bar')
+True
+>>> r.get('foo')
+b'bar'
+```
+
+Example with hostname verification using
+[certifi](https://pypi.org/project/certifi/):
+
+``` pycon
+>>> import redis, certifi
+>>> r = redis.Redis(host='xxxxxx.cache.amazonaws.com', port=6379, db=0,
+                    ssl=True, ssl_ca_certs=certifi.where())
+>>> r.set('foo', 'bar')
+True
+>>> r.get('foo')
+b'bar'
+```
+
+Example turning off hostname verification (not recommended):
+
+``` pycon
+>>> import redis
+>>> r = redis.Redis(host='xxxxxx.cache.amazonaws.com', port=6379, db=0,
+                    ssl=True, ssl_cert_reqs=None)
+>>> r.set('foo', 'bar')
+True
+>>> r.get('foo')
+b'bar'
+```
+
+### MSET, MSETNX and ZADD
+
+These commands all accept a mapping of key/value pairs. In redis-py 2.X
+this mapping could be specified as `*args` or as `**kwargs`. Both of
+these styles caused issues when Redis introduced optional flags to ZADD.
+Relying on `*args` caused issues with the optional argument order,
+especially in Python 2.7. Relying on `**kwargs` caused potential
+collision issues of user keys with the argument names in the method
+signature.
+
+To resolve this, redis-py 3.0 has changed these three commands to all
+accept a single positional argument named mapping that is expected to be
+a dict. For MSET and MSETNX, the dict is a mapping of key-names -\>
+values. For ZADD, the dict is a mapping of element-names -\> score.
+
+MSET, MSETNX and ZADD now look like:
+
+``` pycon
+def mset(self, mapping):
+def msetnx(self, mapping):
+def zadd(self, name, mapping, nx=False, xx=False, ch=False, incr=False):
+```
+
+All 2.X users that use these commands must modify their code to supply
+keys and values as a dict to these commands.
+
+### ZINCRBY
+
+redis-py 2.X accidentally modified the argument order of ZINCRBY,
+swapping the order of value and amount. ZINCRBY now looks like:
+
+``` python
+def zincrby(self, name, amount, value):
+```
+
+All 2.X users that rely on ZINCRBY must swap the order of amount and
+value for the command to continue to work as intended.
+
+### Encoding of User Input
+
+redis-py 3.0 only accepts user data as bytes, strings or numbers (ints,
+longs and floats). Attempting to specify a key or a value as any other
+type will raise a DataError exception.
+
+redis-py 2.X attempted to coerce any type of input into a string. While
+occasionally convenient, this caused all sorts of hidden errors when
+users passed boolean values (which were coerced to \'True\' or
+\'False\'), a None value (which was coerced to \'None\') or other
+values, such as user defined types.
+
+All 2.X users should make sure that the keys and values they pass into
+redis-py are either bytes, strings or numbers.
+
+### Locks
+
+redis-py 3.0 drops support for the pipeline-based Lock and now only
+supports the Lua-based lock. In doing so, LuaLock has been renamed to
+Lock. This also means that redis-py Lock objects require Redis server
+2.6 or greater.
+
+2.X users that were explicitly referring to \"LuaLock\" will have to now
+refer to \"Lock\" instead.
+
+### Locks as Context Managers
+
+redis-py 3.0 now raises a LockError when using a lock as a context
+manager and the lock cannot be acquired within the specified timeout.
+This is more of a bug fix than a backwards incompatible change. However,
+given an error is now raised where none was before, this might alarm
+some users.
+
+2.X users should make sure they\'re wrapping their lock code in a
+try/catch like this:
+
+``` python
+try:
+    with r.lock('my-lock-key', blocking_timeout=5) as lock:
+        # code you want executed only after the lock has been acquired
+except LockError:
+    # the lock wasn't acquired
+```
+
+## API Reference
+
+The [official Redis command documentation](https://redis.io/commands)
+does a great job of explaining each command in detail. redis-py attempts
+to adhere to the official command syntax. There are a few exceptions:
+
+-   **SELECT**: Not implemented. See the explanation in the Thread
+    Safety section below.
+-   **DEL**: \'del\' is a reserved keyword in the Python syntax.
+    Therefore redis-py uses \'delete\' instead.
+-   **MULTI/EXEC**: These are implemented as part of the Pipeline class.
+    The pipeline is wrapped with the MULTI and EXEC statements by
+    default when it is executed, which can be disabled by specifying
+    transaction=False. See more about Pipelines below.
+-   **SUBSCRIBE/LISTEN**: Similar to pipelines, PubSub is implemented as
+    a separate class as it places the underlying connection in a state
+    where it can\'t execute non-pubsub commands. Calling the pubsub
+    method from the Redis client will return a PubSub instance where you
+    can subscribe to channels and listen for messages. You can only call
+    PUBLISH from the Redis client (see [this comment on issue
+    #151](https://github.com/redis/redis-py/issues/151#issuecomment-1545015)
+    for details).
+-   **SCAN/SSCAN/HSCAN/ZSCAN**: The \*SCAN commands are implemented as
+    they exist in the Redis documentation. In addition, each command has
+    an equivalent iterator method. These are purely for convenience so
+    the user doesn\'t have to keep track of the cursor while iterating.
+    Use the scan_iter/sscan_iter/hscan_iter/zscan_iter methods for this
+    behavior.
+
+## More Detail
+
+### Connection Pools
+
+Behind the scenes, redis-py uses a connection pool to manage connections
+to a Redis server. By default, each Redis instance you create will in
+turn create its own connection pool. You can override this behavior and
+use an existing connection pool by passing an already created connection
+pool instance to the connection_pool argument of the Redis class. You
+may choose to do this in order to implement client side sharding or have
+fine-grain control of how connections are managed.
+
+``` pycon
+>>> pool = redis.ConnectionPool(host='localhost', port=6379, db=0)
+>>> r = redis.Redis(connection_pool=pool)
+```
+
+### Connections
+
+ConnectionPools manage a set of Connection instances. redis-py ships
+with two types of Connections. The default, Connection, is a normal TCP
+socket based connection. The UnixDomainSocketConnection allows for
+clients running on the same device as the server to connect via a unix
+domain socket. To use a UnixDomainSocketConnection connection, simply
+pass the unix_socket_path argument, which is a string to the unix domain
+socket file. Additionally, make sure the unixsocket parameter is defined
+in your redis.conf file. It\'s commented out by default.
+
+``` pycon
+>>> r = redis.Redis(unix_socket_path='/tmp/redis.sock')
+```
+
+You can create your own Connection subclasses as well. This may be
+useful if you want to control the socket behavior within an async
+framework. To instantiate a client class using your own connection, you
+need to create a connection pool, passing your class to the
+connection_class argument. Other keyword parameters you pass to the pool
+will be passed to the class specified during initialization.
+
+``` pycon
+>>> pool = redis.ConnectionPool(connection_class=YourConnectionClass,
+                                your_arg='...', ...)
+```
+
+Connections maintain an open socket to the Redis server. Sometimes these
+sockets are interrupted or disconnected for a variety of reasons. For
+example, network appliances, load balancers and other services that sit
+between clients and servers are often configured to kill connections
+that remain idle for a given threshold.
+
+When a connection becomes disconnected, the next command issued on that
+connection will fail and redis-py will raise a ConnectionError to the
+caller. This allows each application that uses redis-py to handle errors
+in a way that\'s fitting for that specific application. However,
+constant error handling can be verbose and cumbersome, especially when
+socket disconnections happen frequently in many production environments.
+
+To combat this, redis-py can issue regular health checks to assess the
+liveliness of a connection just before issuing a command. Users can pass
+`health_check_interval=N` to the Redis or ConnectionPool classes or as a
+query argument within a Redis URL. The value of `health_check_interval`
+must be an integer. A value of `0`, the default, disables health checks.
+Any positive integer will enable health checks. Health checks are
+performed just before a command is executed if the underlying connection
+has been idle for more than `health_check_interval` seconds. For
+example, `health_check_interval=30` will ensure that a health check is
+run on any connection that has been idle for 30 or more seconds just
+before a command is executed on that connection.
+
+If your application is running in an environment that disconnects idle
+connections after 30 seconds you should set the `health_check_interval`
+option to a value less than 30.
+
+This option also works on any PubSub connection that is created from a
+client with `health_check_interval` enabled. PubSub users need to ensure
+that `get_message()` or `listen()` are called more frequently than
+`health_check_interval` seconds. It is assumed that most workloads
+already do this.
+
+If your PubSub use case doesn\'t call `get_message()` or `listen()`
+frequently, you should call `pubsub.check_health()` explicitly on a
+regularly basis.
+
+### Parsers
+
+Parser classes provide a way to control how responses from the Redis
+server are parsed. redis-py ships with two parser classes, the
+PythonParser and the HiredisParser. By default, redis-py will attempt to
+use the HiredisParser if you have the hiredis module installed and will
+fallback to the PythonParser otherwise.
+
+Hiredis is a C library maintained by the core Redis team. Pieter
+Noordhuis was kind enough to create Python bindings. Using Hiredis can
+provide up to a 10x speed improvement in parsing responses from the
+Redis server. The performance increase is most noticeable when
+retrieving many pieces of data, such as from LRANGE or SMEMBERS
+operations.
+
+Hiredis is available on PyPI, and can be installed via pip just like
+redis-py.
+
+``` bash
+$ pip install hiredis
+```
+
+### Response Callbacks
+
+The client class uses a set of callbacks to cast Redis responses to the
+appropriate Python type. There are a number of these callbacks defined
+on the Redis client class in a dictionary called RESPONSE_CALLBACKS.
+
+Custom callbacks can be added on a per-instance basis using the
+set_response_callback method. This method accepts two arguments: a
+command name and the callback. Callbacks added in this manner are only
+valid on the instance the callback is added to. If you want to define or
+override a callback globally, you should make a subclass of the Redis
+client and add your callback to its RESPONSE_CALLBACKS class dictionary.
+
+Response callbacks take at least one parameter: the response from the
+Redis server. Keyword arguments may also be accepted in order to further
+control how to interpret the response. These keyword arguments are
+specified during the command\'s call to execute_command. The ZRANGE
+implementation demonstrates the use of response callback keyword
+arguments with its \"withscores\" argument.
+
+### Thread Safety
+
+Redis client instances can safely be shared between threads. Internally,
+connection instances are only retrieved from the connection pool during
+command execution, and returned to the pool directly after. Command
+execution never modifies state on the client instance.
+
+However, there is one caveat: the Redis SELECT command. The SELECT
+command allows you to switch the database currently in use by the
+connection. That database remains selected until another is selected or
+until the connection is closed. This creates an issue in that
+connections could be returned to the pool that are connected to a
+different database.
+
+As a result, redis-py does not implement the SELECT command on client
+instances. If you use multiple Redis databases within the same
+application, you should create a separate client instance (and possibly
+a separate connection pool) for each database.
+
+It is not safe to pass PubSub or Pipeline objects between threads.
+
+### Pipelines
+
+Pipelines are a subclass of the base Redis class that provide support
+for buffering multiple commands to the server in a single request. They
+can be used to dramatically increase the performance of groups of
+commands by reducing the number of back-and-forth TCP packets between
+the client and server.
+
+Pipelines are quite simple to use:
+
+``` pycon
+>>> r = redis.Redis(...)
+>>> r.set('bing', 'baz')
+>>> # Use the pipeline() method to create a pipeline instance
+>>> pipe = r.pipeline()
+>>> # The following SET commands are buffered
+>>> pipe.set('foo', 'bar')
+>>> pipe.get('bing')
+>>> # the EXECUTE call sends all buffered commands to the server, returning
+>>> # a list of responses, one for each command.
+>>> pipe.execute()
+[True, b'baz']
+```
+
+For ease of use, all commands being buffered into the pipeline return
+the pipeline object itself. Therefore calls can be chained like:
+
+``` pycon
+>>> pipe.set('foo', 'bar').sadd('faz', 'baz').incr('auto_number').execute()
+[True, True, 6]
+```
+
+In addition, pipelines can also ensure the buffered commands are
+executed atomically as a group. This happens by default. If you want to
+disable the atomic nature of a pipeline but still want to buffer
+commands, you can turn off transactions.
+
+``` pycon
+>>> pipe = r.pipeline(transaction=False)
+```
+
+A common issue occurs when requiring atomic transactions but needing to
+retrieve values in Redis prior for use within the transaction. For
+instance, let\'s assume that the INCR command didn\'t exist and we need
+to build an atomic version of INCR in Python.
+
+The completely naive implementation could GET the value, increment it in
+Python, and SET the new value back. However, this is not atomic because
+multiple clients could be doing this at the same time, each getting the
+same value from GET.
+
+Enter the WATCH command. WATCH provides the ability to monitor one or
+more keys prior to starting a transaction. If any of those keys change
+prior the execution of that transaction, the entire transaction will be
+canceled and a WatchError will be raised. To implement our own
+client-side INCR command, we could do something like this:
+
+``` pycon
+>>> with r.pipeline() as pipe:
+...     while True:
+...         try:
+...             # put a WATCH on the key that holds our sequence value
+...             pipe.watch('OUR-SEQUENCE-KEY')
+...             # after WATCHing, the pipeline is put into immediate execution
+...             # mode until we tell it to start buffering commands again.
+...             # this allows us to get the current value of our sequence
+...             current_value = pipe.get('OUR-SEQUENCE-KEY')
+...             next_value = int(current_value) + 1
+...             # now we can put the pipeline back into buffered mode with MULTI
+...             pipe.multi()
+...             pipe.set('OUR-SEQUENCE-KEY', next_value)
+...             # and finally, execute the pipeline (the set command)
+...             pipe.execute()
+...             # if a WatchError wasn't raised during execution, everything
+...             # we just did happened atomically.
+...             break
+...        except WatchError:
+...             # another client must have changed 'OUR-SEQUENCE-KEY' between
+...             # the time we started WATCHing it and the pipeline's execution.
+...             # our best bet is to just retry.
+...             continue
+```
+
+Note that, because the Pipeline must bind to a single connection for the
+duration of a WATCH, care must be taken to ensure that the connection is
+returned to the connection pool by calling the reset() method. If the
+Pipeline is used as a context manager (as in the example above) reset()
+will be called automatically. Of course you can do this the manual way
+by explicitly calling reset():
+
+``` pycon
+>>> pipe = r.pipeline()
+>>> while True:
+...     try:
+...         pipe.watch('OUR-SEQUENCE-KEY')
+...         ...
+...         pipe.execute()
+...         break
+...     except WatchError:
+...         continue
+...     finally:
+...         pipe.reset()
+```
+
+A convenience method named \"transaction\" exists for handling all the
+boilerplate of handling and retrying watch errors. It takes a callable
+that should expect a single parameter, a pipeline object, and any number
+of keys to be WATCHed. Our client-side INCR command above can be written
+like this, which is much easier to read:
+
+``` pycon
+>>> def client_side_incr(pipe):
+...     current_value = pipe.get('OUR-SEQUENCE-KEY')
+...     next_value = int(current_value) + 1
+...     pipe.multi()
+...     pipe.set('OUR-SEQUENCE-KEY', next_value)
+>>>
+>>> r.transaction(client_side_incr, 'OUR-SEQUENCE-KEY')
+[True]
+```
+
+Be sure to call pipe.multi() in the callable passed to
+Redis.transaction prior to any write commands.
+
+### Publish / Subscribe
+
+redis-py includes a PubSub object that subscribes to
+channels and listens for new messages. Creating a PubSub
+object is easy.
+
+``` pycon
+>>> r = redis.Redis(...)
+>>> p = r.pubsub()
+```
+
+Once a PubSub instance is created, channels and patterns
+can be subscribed to.
+
+``` pycon
+>>> p.subscribe('my-first-channel', 'my-second-channel', ...)
+>>> p.psubscribe('my-*', ...)
+```
+
+The PubSub instance is now subscribed to those
+channels/patterns. The subscription confirmations can be seen by reading
+messages from the PubSub instance.
+
+``` pycon
+>>> p.get_message()
+{'pattern': None, 'type': 'subscribe', 'channel': b'my-second-channel', 'data': 1}
+>>> p.get_message()
+{'pattern': None, 'type': 'subscribe', 'channel': b'my-first-channel', 'data': 2}
+>>> p.get_message()
+{'pattern': None, 'type': 'psubscribe', 'channel': b'my-*', 'data': 3}
+```
+
+Every message read from a PubSub instance will be a
+dictionary with the following keys.
+
+-   **type**: One of the following: \'subscribe\', \'unsubscribe\',
+    \'psubscribe\', \'punsubscribe\', \'message\', \'pmessage\'
+-   **channel**: The channel \[un\]subscribed to or the channel a
+    message was published to
+-   **pattern**: The pattern that matched a published message\'s
+    channel. Will be None in all cases except for
+    \'pmessage\' types.
+-   **data**: The message data. With \[un\]subscribe messages, this
+    value will be the number of channels and patterns the connection is
+    currently subscribed to. With \[p\]message messages, this value will
+    be the actual published message.
+
+Let\'s send a message now.
+
+``` pycon
+# the publish method returns the number matching channel and pattern
+# subscriptions. 'my-first-channel' matches both the 'my-first-channel'
+# subscription and the 'my-*' pattern subscription, so this message will
+# be delivered to 2 channels/patterns
+>>> r.publish('my-first-channel', 'some data')
+2
+>>> p.get_message()
+{'channel': b'my-first-channel', 'data': b'some data', 'pattern': None, 'type': 'message'}
+>>> p.get_message()
+{'channel': b'my-first-channel', 'data': b'some data', 'pattern': b'my-*', 'type': 'pmessage'}
+```
+
+Unsubscribing works just like subscribing. If no arguments are passed to
+\[p\]unsubscribe, all channels or patterns will be unsubscribed from.
+
+``` pycon
+>>> p.unsubscribe()
+>>> p.punsubscribe('my-*')
+>>> p.get_message()
+{'channel': b'my-second-channel', 'data': 2, 'pattern': None, 'type': 'unsubscribe'}
+>>> p.get_message()
+{'channel': b'my-first-channel', 'data': 1, 'pattern': None, 'type': 'unsubscribe'}
+>>> p.get_message()
+{'channel': b'my-*', 'data': 0, 'pattern': None, 'type': 'punsubscribe'}
+```
+
+redis-py also allows you to register callback functions to handle
+published messages. Message handlers take a single argument, the
+message, which is a dictionary just like the examples above. To
+subscribe to a channel or pattern with a message handler, pass the
+channel or pattern name as a keyword argument with its value being the
+callback function.
+
+When a message is read on a channel or pattern with a message handler,
+the message dictionary is created and passed to the message handler. In
+this case, a None value is returned from get_message()
+since the message was already handled.
+
+``` pycon
+>>> def my_handler(message):
+...     print('MY HANDLER: ', message['data'])
+>>> p.subscribe(**{'my-channel': my_handler})
+# read the subscribe confirmation message
+>>> p.get_message()
+{'pattern': None, 'type': 'subscribe', 'channel': b'my-channel', 'data': 1}
+>>> r.publish('my-channel', 'awesome data')
+1
+# for the message handler to work, we need tell the instance to read data.
+# this can be done in several ways (read more below). we'll just use
+# the familiar get_message() function for now
+>>> message = p.get_message()
+MY HANDLER:  awesome data
+# note here that the my_handler callback printed the string above.
+# `message` is None because the message was handled by our handler.
+>>> print(message)
+None
+```
+
+If your application is not interested in the (sometimes noisy)
+subscribe/unsubscribe confirmation messages, you can ignore them by
+passing ignore_subscribe_messages=True to
+r.pubsub(). This will cause all subscribe/unsubscribe
+messages to be read, but they won\'t bubble up to your application.
+
+``` pycon
+>>> p = r.pubsub(ignore_subscribe_messages=True)
+>>> p.subscribe('my-channel')
+>>> p.get_message()  # hides the subscribe message and returns None
+>>> r.publish('my-channel', 'my data')
+1
+>>> p.get_message()
+{'channel': b'my-channel', 'data': b'my data', 'pattern': None, 'type': 'message'}
+```
+
+There are three different strategies for reading messages.
+
+The examples above have been using pubsub.get_message().
+Behind the scenes, get_message() uses the system\'s
+\'select\' module to quickly poll the connection\'s socket. If there\'s
+data available to be read, get_message() will read it,
+format the message and return it or pass it to a message handler. If
+there\'s no data to be read, get_message() will
+immediately return None. This makes it trivial to integrate into an
+existing event loop inside your application.
+
+``` pycon
+>>> while True:
+>>>     message = p.get_message()
+>>>     if message:
+>>>         # do something with the message
+>>>     time.sleep(0.001)  # be nice to the system :)
+```
+
+Older versions of redis-py only read messages with
+pubsub.listen(). listen() is a generator that blocks until
+a message is available. If your application doesn\'t need to do anything
+else but receive and act on messages received from redis, listen() is an
+easy way to get up an running.
+
+``` pycon
+>>> for message in p.listen():
+...     # do something with the message
+```
+
+The third option runs an event loop in a separate thread.
+pubsub.run_in_thread() creates a new thread and starts the
+event loop. The thread object is returned to the caller of
+[un_in_thread(). The caller can use the
+thread.stop() method to shut down the event loop and
+thread. Behind the scenes, this is simply a wrapper around
+get_message() that runs in a separate thread, essentially
+creating a tiny non-blocking event loop for you.
+run_in_thread() takes an optional sleep_time
+argument. If specified, the event loop will call
+time.sleep() with the value in each iteration of the loop.
+
+Note: Since we\'re running in a separate thread, there\'s no way to
+handle messages that aren\'t automatically handled with registered
+message handlers. Therefore, redis-py prevents you from calling
+run_in_thread() if you\'re subscribed to patterns or
+channels that don\'t have message handlers attached.
+
+``` pycon
+>>> p.subscribe(**{'my-channel': my_handler})
+>>> thread = p.run_in_thread(sleep_time=0.001)
+# the event loop is now running in the background processing messages
+# when it's time to shut it down...
+>>> thread.stop()
+```
+
+run_in_thread also supports an optional exception handler,
+which lets you catch exceptions that occur within the worker thread and
+handle them appropriately. The exception handler will take as arguments
+the exception itself, the pubsub object, and the worker thread returned
+by run_in_thread.
+
+``` pycon
+>>> p.subscribe(**{'my-channel': my_handler})
+>>> def exception_handler(ex, pubsub, thread):
+>>>     print(ex)
+>>>     thread.stop()
+>>>     thread.join(timeout=1.0)
+>>>     pubsub.close()
+>>> thread = p.run_in_thread(exception_handler=exception_handler)
+```
+
+A PubSub object adheres to the same encoding semantics as the client
+instance it was created from. Any channel or pattern that\'s unicode
+will be encoded using the charset specified on the client
+before being sent to Redis. If the client\'s
+decode_responses flag is set the False (the default), the
+\'channel\', \'pattern\' and \'data\' values in message dictionaries
+will be byte strings (str on Python 2, bytes on Python 3). If the
+client\'s decode_responses is True, then the \'channel\',
+\'pattern\' and \'data\' values will be automatically decoded to unicode
+strings using the client\'s charset.
+
+PubSub objects remember what channels and patterns they are subscribed
+to. In the event of a disconnection such as a network error or timeout,
+the PubSub object will re-subscribe to all prior channels and patterns
+when reconnecting. Messages that were published while the client was
+disconnected cannot be delivered. When you\'re finished with a PubSub
+object, call its .close() method to shutdown the
+connection.
+
+``` pycon
+>>> p = r.pubsub()
+>>> ...
+>>> p.close()
+```
+
+The PUBSUB set of subcommands CHANNELS, NUMSUB and NUMPAT are also
+supported:
+
+``` pycon
+>>> r.pubsub_channels()
+[b'foo', b'bar']
+>>> r.pubsub_numsub('foo', 'bar')
+[(b'foo', 9001), (b'bar', 42)]
+>>> r.pubsub_numsub('baz')
+[(b'baz', 0)]
+>>> r.pubsub_numpat()
+1204
+```
+
+### Monitor
+
+redis-py includes a Monitor object that streams every
+command processed by the Redis server. Use listen() on the
+Monitor object to block until a command is received.
+
+``` pycon
+>>> r = redis.Redis(...)
+>>> with r.monitor() as m:
+>>>     for command in m.listen():
+>>>         print(command)
+```
+
+### Lua Scripting
+
+redis-py supports the EVAL, EVALSHA, and SCRIPT commands. However, there
+are a number of edge cases that make these commands tedious to use in
+real world scenarios. Therefore, redis-py exposes a Script object that
+makes scripting much easier to use.
+
+To create a Script instance, use the register_script
+function on a client instance passing the Lua code as the first
+argument. register_script returns a Script instance that
+you can use throughout your code.
+
+The following trivial Lua script accepts two parameters: the name of a
+key and a multiplier value. The script fetches the value stored in the
+key, multiplies it with the multiplier value and returns the result.
+
+``` pycon
+>>> r = redis.Redis()
+>>> lua = """
+... local value = redis.call('GET', KEYS[1])
+... value = tonumber(value)
+... return value * ARGV[1]"""
+>>> multiply = r.register_script(lua)
+```
+
+multiply is now a Script instance that is invoked by
+calling it like a function. Script instances accept the following
+optional arguments:
+
+-   **keys**: A list of key names that the script will access. This
+    becomes the KEYS list in Lua.
+-   **args**: A list of argument values. This becomes the ARGV list in
+    Lua.
+-   **client**: A redis-py Client or Pipeline instance that will invoke
+    the script. If client isn\'t specified, the client that initially
+    created the Script instance (the one that
+    register_script was invoked from) will be used.
+
+Continuing the example from above:
+
+``` pycon
+>>> r.set('foo', 2)
+>>> multiply(keys=['foo'], args=[5])
+10
+```
+
+The value of key \'foo\' is set to 2. When multiply is invoked, the
+\'foo\' key is passed to the script along with the multiplier value of
+5. Lua executes the script and returns the result, 10.
+
+Script instances can be executed using a different client instance, even
+one that points to a completely different Redis server.
+
+``` pycon
+>>> r2 = redis.Redis('redis2.example.com')
+>>> r2.set('foo', 3)
+>>> multiply(keys=['foo'], args=[5], client=r2)
+15
+```
+
+The Script object ensures that the Lua script is loaded into Redis\'s
+script cache. In the event of a NOSCRIPT error, it will load the script
+and retry executing it.
+
+Script objects can also be used in pipelines. The pipeline instance
+should be passed as the client argument when calling the script. Care is
+taken to ensure that the script is registered in Redis\'s script cache
+just prior to pipeline execution.
+
+``` pycon
+>>> pipe = r.pipeline()
+>>> pipe.set('foo', 5)
+>>> multiply(keys=['foo'], args=[5], client=pipe)
+>>> pipe.execute()
+[True, 25]
+```
+
+### Sentinel support
+
+redis-py can be used together with [Redis
+Sentinel](https://redis.io/topics/sentinel) to discover Redis nodes. You
+need to have at least one Sentinel daemon running in order to use
+redis-py\'s Sentinel support.
+
+Connecting redis-py to the Sentinel instance(s) is easy. You can use a
+Sentinel connection to discover the master and slaves network addresses:
+
+``` pycon
+>>> from redis.sentinel import Sentinel
+>>> sentinel = Sentinel([('localhost', 26379)], socket_timeout=0.1)
+>>> sentinel.discover_master('mymaster')
+('127.0.0.1', 6379)
+>>> sentinel.discover_slaves('mymaster')
+[('127.0.0.1', 6380)]
+```
+
+You can also create Redis client connections from a Sentinel instance.
+You can connect to either the master (for write operations) or a slave
+(for read-only operations).
+
+``` pycon
+>>> master = sentinel.master_for('mymaster', socket_timeout=0.1)
+>>> slave = sentinel.slave_for('mymaster', socket_timeout=0.1)
+>>> master.set('foo', 'bar')
+>>> slave.get('foo')
+b'bar'
+```
+
+The master and slave objects are normal Redis instances with their
+connection pool bound to the Sentinel instance. When a Sentinel backed
+client attempts to establish a connection, it first queries the Sentinel
+servers to determine an appropriate host to connect to. If no server is
+found, a MasterNotFoundError or SlaveNotFoundError is raised. Both
+exceptions are subclasses of ConnectionError.
+
+When trying to connect to a slave client, the Sentinel connection pool
+will iterate over the list of slaves until it finds one that can be
+connected to. If no slaves can be connected to, a connection will be
+established with the master.
+
+See [Guidelines for Redis clients with support for Redis
+Sentinel](https://redis.io/topics/sentinel-clients) to learn more about
+Redis Sentinel.
+
+### Scan Iterators
+
+The \*SCAN commands introduced in Redis 2.8 can be cumbersome to use.
+While these commands are fully supported, redis-py also exposes the
+following methods that return Python iterators for convenience:
+scan_iter, hscan_iter,
+sscan_iter and zscan_iter.
+
+``` pycon
+>>> for key, value in (('A', '1'), ('B', '2'), ('C', '3')):
+...     r.set(key, value)
+>>> for key in r.scan_iter():
+...     print(key, r.get(key))
+A 1
+B 2
+C 3
+```
+
+### Cluster Mode
+
+redis-py does not currently support [Cluster
+Mode](https://redis.io/topics/cluster-tutorial).
+
+### Author
+
+redis-py is developed and maintained by Andy McCurdy
+(<sedrik@gmail.com>). It can be found here:
+<https://github.com/redis/redis-py>
+
+Special thanks to:
+
+-   Ludovico Magnocavallo, author of the original Python Redis client,
+    from which some of the socket code is still used.
+-   Alexander Solovyov for ideas on the generic response callback
+    system.
+-   Paul Hubbard for initial packaging support.
+
+### Sponsored by
+
+[![Redis](./docs/logo-redis.png)](https://www.redis.com)
diff --git a/README.rst b/README.rst
deleted file mode 100644
index 821a25386d..0000000000
--- a/README.rst
+++ /dev/null
@@ -1,970 +0,0 @@
-redis-py
-========
-
-The Python interface to the Redis key-value store.
-
-.. image:: https://github.com/redis/redis-py/workflows/CI/badge.svg?branch=master
-        :target: https://github.com/redis/redis-py/actions?query=workflow%3ACI+branch%3Amaster
-.. image:: https://readthedocs.org/projects/redis-py/badge/?version=stable&style=flat
-        :target: https://redis-py.readthedocs.io/en/stable/
-.. image:: https://badge.fury.io/py/redis.svg
-        :target: https://pypi.org/project/redis/
-.. image:: https://codecov.io/gh/redis/redis-py/branch/master/graph/badge.svg
-  :target: https://codecov.io/gh/redis/redis-py
-
-
-Python 2 Compatibility Note
----------------------------
-
-redis-py 3.5.x will be the last version of redis-py that supports Python 2.
-The 3.5.x line will continue to get bug fixes and security patches that
-support Python 2 until August 1, 2020. redis-py 4.0 will be the next major
-version and will require Python 3.5+.
-
-
-Installation
-------------
-
-redis-py requires a running Redis server. See `Redis's quickstart
-<https://redis.io/topics/quickstart>`_ for installation instructions.
-
-redis-py can be installed using `pip` similar to other Python packages. Do not use `sudo`
-with `pip`. It is usually good to work in a
-`virtualenv <https://virtualenv.pypa.io/en/latest/>`_ or
-`venv <https://docs.python.org/3/library/venv.html>`_ to avoid conflicts with other package
-managers and Python projects. For a quick introduction see
-`Python Virtual Environments in Five Minutes <https://bit.ly/py-env>`_.
-
-To install redis-py, simply:
-
-.. code-block:: bash
-
-    $ pip install redis
-
-or from source:
-
-.. code-block:: bash
-
-    $ python setup.py install
-
-Contributing
-------------
-
-Want to contribute a feature, bug report, or report an issue? Check out our `guide to
-contributing <https://github.com/redis/redis-py/blob/master/CONTRIBUTING.rst>`_.
-
-
-Getting Started
----------------
-
-.. code-block:: pycon
-
-    >>> import redis
-    >>> r = redis.Redis(host='localhost', port=6379, db=0)
-    >>> r.set('foo', 'bar')
-    True
-    >>> r.get('foo')
-    b'bar'
-
-By default, all responses are returned as `bytes` in Python 3 and `str` in
-Python 2. The user is responsible for decoding to Python 3 strings or Python 2
-unicode objects.
-
-If **all** string responses from a client should be decoded, the user can
-specify `decode_responses=True` to `Redis.__init__`. In this case, any
-Redis command that returns a string type will be decoded with the `encoding`
-specified.
-
-The default encoding is "utf-8", but this can be customized with the `encoding`
-argument to the `redis.Redis` class. The `encoding` will be used to
-automatically encode any strings passed to commands, such as key names and
-values. When `decode_responses=True`, string data returned from commands
-will be decoded with the same `encoding`.
-
-
-Upgrading from redis-py 2.X to 3.0
-----------------------------------
-
-redis-py 3.0 introduces many new features but required a number of backwards
-incompatible changes to be made in the process. This section attempts to
-provide an upgrade path for users migrating from 2.X to 3.0.
-
-
-Python Version Support
-^^^^^^^^^^^^^^^^^^^^^^
-
-redis-py supports Python 3.5+.
-
-
-Client Classes: Redis and StrictRedis
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-redis-py 3.0 drops support for the legacy "Redis" client class. "StrictRedis"
-has been renamed to "Redis" and an alias named "StrictRedis" is provided so
-that users previously using "StrictRedis" can continue to run unchanged.
-
-The 2.X "Redis" class provided alternative implementations of a few commands.
-This confused users (rightfully so) and caused a number of support issues. To
-make things easier going forward, it was decided to drop support for these
-alternate implementations and instead focus on a single client class.
-
-2.X users that are already using StrictRedis don't have to change the class
-name. StrictRedis will continue to work for the foreseeable future.
-
-2.X users that are using the Redis class will have to make changes if they
-use any of the following commands:
-
-* SETEX: The argument order has changed. The new order is (name, time, value).
-* LREM: The argument order has changed. The new order is (name, num, value).
-* TTL and PTTL: The return value is now always an int and matches the
-  official Redis command (>0 indicates the timeout, -1 indicates that the key
-  exists but that it has no expire time set, -2 indicates that the key does
-  not exist)
-
-
-SSL Connections
-^^^^^^^^^^^^^^^
-
-redis-py 3.0 changes the default value of the `ssl_cert_reqs` option from
-`None` to `'required'`. See
-`Issue 1016 <https://github.com/redis/redis-py/issues/1016>`_. This
-change enforces hostname validation when accepting a cert from a remote SSL
-terminator. If the terminator doesn't properly set the hostname on the cert
-this will cause redis-py 3.0 to raise a ConnectionError.
-
-This check can be disabled by setting `ssl_cert_reqs` to `None`. Note that
-doing so removes the security check. Do so at your own risk.
-
-Example with hostname verification using a local certificate bundle (linux):
-
-.. code-block:: pycon
-
-    >>> import redis
-    >>> r = redis.Redis(host='xxxxxx.cache.amazonaws.com', port=6379, db=0,
-                        ssl=True,
-                        ssl_ca_certs='/etc/ssl/certs/ca-certificates.crt')
-    >>> r.set('foo', 'bar')
-    True
-    >>> r.get('foo')
-    b'bar'
-
-Example with hostname verification using
-`certifi <https://pypi.org/project/certifi/>`_:
-
-.. code-block:: pycon
-
-    >>> import redis, certifi
-    >>> r = redis.Redis(host='xxxxxx.cache.amazonaws.com', port=6379, db=0,
-                        ssl=True, ssl_ca_certs=certifi.where())
-    >>> r.set('foo', 'bar')
-    True
-    >>> r.get('foo')
-    b'bar'
-
-Example turning off hostname verification (not recommended):
-
-.. code-block:: pycon
-
-    >>> import redis
-    >>> r = redis.Redis(host='xxxxxx.cache.amazonaws.com', port=6379, db=0,
-                        ssl=True, ssl_cert_reqs=None)
-    >>> r.set('foo', 'bar')
-    True
-    >>> r.get('foo')
-    b'bar'
-
-
-MSET, MSETNX and ZADD
-^^^^^^^^^^^^^^^^^^^^^
-
-These commands all accept a mapping of key/value pairs. In redis-py 2.X
-this mapping could be specified as ``*args`` or as ``**kwargs``. Both of these
-styles caused issues when Redis introduced optional flags to ZADD. Relying on
-``*args`` caused issues with the optional argument order, especially in Python
-2.7. Relying on ``**kwargs`` caused potential collision issues of user keys with
-the argument names in the method signature.
-
-To resolve this, redis-py 3.0 has changed these three commands to all accept
-a single positional argument named mapping that is expected to be a dict. For
-MSET and MSETNX, the dict is a mapping of key-names -> values. For ZADD, the
-dict is a mapping of element-names -> score.
-
-MSET, MSETNX and ZADD now look like:
-
-.. code-block:: pycon
-
-    def mset(self, mapping):
-    def msetnx(self, mapping):
-    def zadd(self, name, mapping, nx=False, xx=False, ch=False, incr=False):
-
-All 2.X users that use these commands must modify their code to supply
-keys and values as a dict to these commands.
-
-
-ZINCRBY
-^^^^^^^
-
-redis-py 2.X accidentally modified the argument order of ZINCRBY, swapping the
-order of value and amount. ZINCRBY now looks like:
-
-.. code-block:: python
-
-    def zincrby(self, name, amount, value):
-
-All 2.X users that rely on ZINCRBY must swap the order of amount and value
-for the command to continue to work as intended.
-
-
-Encoding of User Input
-^^^^^^^^^^^^^^^^^^^^^^
-
-redis-py 3.0 only accepts user data as bytes, strings or numbers (ints, longs
-and floats). Attempting to specify a key or a value as any other type will
-raise a DataError exception.
-
-redis-py 2.X attempted to coerce any type of input into a string. While
-occasionally convenient, this caused all sorts of hidden errors when users
-passed boolean values (which were coerced to 'True' or 'False'), a None
-value (which was coerced to 'None') or other values, such as user defined
-types.
-
-All 2.X users should make sure that the keys and values they pass into
-redis-py are either bytes, strings or numbers.
-
-
-Locks
-^^^^^
-
-redis-py 3.0 drops support for the pipeline-based Lock and now only supports
-the Lua-based lock. In doing so, LuaLock has been renamed to Lock. This also
-means that redis-py Lock objects require Redis server 2.6 or greater.
-
-2.X users that were explicitly referring to "LuaLock" will have to now refer
-to "Lock" instead.
-
-
-Locks as Context Managers
-^^^^^^^^^^^^^^^^^^^^^^^^^
-
-redis-py 3.0 now raises a LockError when using a lock as a context manager and
-the lock cannot be acquired within the specified timeout. This is more of a
-bug fix than a backwards incompatible change. However, given an error is now
-raised where none was before, this might alarm some users.
-
-2.X users should make sure they're wrapping their lock code in a try/catch
-like this:
-
-.. code-block:: python
-
-    try:
-        with r.lock('my-lock-key', blocking_timeout=5) as lock:
-            # code you want executed only after the lock has been acquired
-    except LockError:
-        # the lock wasn't acquired
-
-
-API Reference
--------------
-
-The `official Redis command documentation <https://redis.io/commands>`_ does a
-great job of explaining each command in detail. redis-py attempts to adhere
-to the official command syntax. There are a few exceptions:
-
-* **SELECT**: Not implemented. See the explanation in the Thread Safety section
-  below.
-* **DEL**: 'del' is a reserved keyword in the Python syntax. Therefore redis-py
-  uses 'delete' instead.
-* **MULTI/EXEC**: These are implemented as part of the Pipeline class. The
-  pipeline is wrapped with the MULTI and EXEC statements by default when it
-  is executed, which can be disabled by specifying transaction=False.
-  See more about Pipelines below.
-* **SUBSCRIBE/LISTEN**: Similar to pipelines, PubSub is implemented as a separate
-  class as it places the underlying connection in a state where it can't
-  execute non-pubsub commands. Calling the pubsub method from the Redis client
-  will return a PubSub instance where you can subscribe to channels and listen
-  for messages. You can only call PUBLISH from the Redis client (see
-  `this comment on issue #151
-  <https://github.com/redis/redis-py/issues/151#issuecomment-1545015>`_
-  for details).
-* **SCAN/SSCAN/HSCAN/ZSCAN**: The \*SCAN commands are implemented as they
-  exist in the Redis documentation. In addition, each command has an equivalent
-  iterator method. These are purely for convenience so the user doesn't have
-  to keep track of the cursor while iterating. Use the
-  scan_iter/sscan_iter/hscan_iter/zscan_iter methods for this behavior.
-
-
-More Detail
------------
-
-Connection Pools
-^^^^^^^^^^^^^^^^
-
-Behind the scenes, redis-py uses a connection pool to manage connections to
-a Redis server. By default, each Redis instance you create will in turn create
-its own connection pool. You can override this behavior and use an existing
-connection pool by passing an already created connection pool instance to the
-connection_pool argument of the Redis class. You may choose to do this in order
-to implement client side sharding or have fine-grain control of how
-connections are managed.
-
-.. code-block:: pycon
-
-    >>> pool = redis.ConnectionPool(host='localhost', port=6379, db=0)
-    >>> r = redis.Redis(connection_pool=pool)
-
-Connections
-^^^^^^^^^^^
-
-ConnectionPools manage a set of Connection instances. redis-py ships with two
-types of Connections. The default, Connection, is a normal TCP socket based
-connection. The UnixDomainSocketConnection allows for clients running on the
-same device as the server to connect via a unix domain socket. To use a
-UnixDomainSocketConnection connection, simply pass the unix_socket_path
-argument, which is a string to the unix domain socket file. Additionally, make
-sure the unixsocket parameter is defined in your redis.conf file. It's
-commented out by default.
-
-.. code-block:: pycon
-
-    >>> r = redis.Redis(unix_socket_path='/tmp/redis.sock')
-
-You can create your own Connection subclasses as well. This may be useful if
-you want to control the socket behavior within an async framework. To
-instantiate a client class using your own connection, you need to create
-a connection pool, passing your class to the connection_class argument.
-Other keyword parameters you pass to the pool will be passed to the class
-specified during initialization.
-
-.. code-block:: pycon
-
-    >>> pool = redis.ConnectionPool(connection_class=YourConnectionClass,
-                                    your_arg='...', ...)
-
-Connections maintain an open socket to the Redis server. Sometimes these
-sockets are interrupted or disconnected for a variety of reasons. For example,
-network appliances, load balancers and other services that sit between clients
-and servers are often configured to kill connections that remain idle for a
-given threshold.
-
-When a connection becomes disconnected, the next command issued on that
-connection will fail and redis-py will raise a ConnectionError to the caller.
-This allows each application that uses redis-py to handle errors in a way
-that's fitting for that specific application. However, constant error
-handling can be verbose and cumbersome, especially when socket disconnections
-happen frequently in many production environments.
-
-To combat this, redis-py can issue regular health checks to assess the
-liveliness of a connection just before issuing a command. Users can pass
-``health_check_interval=N`` to the Redis or ConnectionPool classes or
-as a query argument within a Redis URL. The value of ``health_check_interval``
-must be an integer. A value of ``0``, the default, disables health checks.
-Any positive integer will enable health checks. Health checks are performed
-just before a command is executed if the underlying connection has been idle
-for more than ``health_check_interval`` seconds. For example,
-``health_check_interval=30`` will ensure that a health check is run on any
-connection that has been idle for 30 or more seconds just before a command
-is executed on that connection.
-
-If your application is running in an environment that disconnects idle
-connections after 30 seconds you should set the ``health_check_interval``
-option to a value less than 30.
-
-This option also works on any PubSub connection that is created from a
-client with ``health_check_interval`` enabled. PubSub users need to ensure
-that ``get_message()`` or ``listen()`` are called more frequently than
-``health_check_interval`` seconds. It is assumed that most workloads already
-do this.
-
-If your PubSub use case doesn't call ``get_message()`` or ``listen()``
-frequently, you should call ``pubsub.check_health()`` explicitly on a
-regularly basis.
-
-Parsers
-^^^^^^^
-
-Parser classes provide a way to control how responses from the Redis server
-are parsed. redis-py ships with two parser classes, the PythonParser and the
-HiredisParser. By default, redis-py will attempt to use the HiredisParser if
-you have the hiredis module installed and will fallback to the PythonParser
-otherwise.
-
-Hiredis is a C library maintained by the core Redis team. Pieter Noordhuis was
-kind enough to create Python bindings. Using Hiredis can provide up to a
-10x speed improvement in parsing responses from the Redis server. The
-performance increase is most noticeable when retrieving many pieces of data,
-such as from LRANGE or SMEMBERS operations.
-
-Hiredis is available on PyPI, and can be installed via pip just like redis-py.
-
-.. code-block:: bash
-
-    $ pip install hiredis
-
-Response Callbacks
-^^^^^^^^^^^^^^^^^^
-
-The client class uses a set of callbacks to cast Redis responses to the
-appropriate Python type. There are a number of these callbacks defined on
-the Redis client class in a dictionary called RESPONSE_CALLBACKS.
-
-Custom callbacks can be added on a per-instance basis using the
-set_response_callback method. This method accepts two arguments: a command
-name and the callback. Callbacks added in this manner are only valid on the
-instance the callback is added to. If you want to define or override a callback
-globally, you should make a subclass of the Redis client and add your callback
-to its RESPONSE_CALLBACKS class dictionary.
-
-Response callbacks take at least one parameter: the response from the Redis
-server. Keyword arguments may also be accepted in order to further control
-how to interpret the response. These keyword arguments are specified during the
-command's call to execute_command. The ZRANGE implementation demonstrates the
-use of response callback keyword arguments with its "withscores" argument.
-
-Thread Safety
-^^^^^^^^^^^^^
-
-Redis client instances can safely be shared between threads. Internally,
-connection instances are only retrieved from the connection pool during
-command execution, and returned to the pool directly after. Command execution
-never modifies state on the client instance.
-
-However, there is one caveat: the Redis SELECT command. The SELECT command
-allows you to switch the database currently in use by the connection. That
-database remains selected until another is selected or until the connection is
-closed. This creates an issue in that connections could be returned to the pool
-that are connected to a different database.
-
-As a result, redis-py does not implement the SELECT command on client
-instances. If you use multiple Redis databases within the same application, you
-should create a separate client instance (and possibly a separate connection
-pool) for each database.
-
-It is not safe to pass PubSub or Pipeline objects between threads.
-
-Pipelines
-^^^^^^^^^
-
-Pipelines are a subclass of the base Redis class that provide support for
-buffering multiple commands to the server in a single request. They can be used
-to dramatically increase the performance of groups of commands by reducing the
-number of back-and-forth TCP packets between the client and server.
-
-Pipelines are quite simple to use:
-
-.. code-block:: pycon
-
-    >>> r = redis.Redis(...)
-    >>> r.set('bing', 'baz')
-    >>> # Use the pipeline() method to create a pipeline instance
-    >>> pipe = r.pipeline()
-    >>> # The following SET commands are buffered
-    >>> pipe.set('foo', 'bar')
-    >>> pipe.get('bing')
-    >>> # the EXECUTE call sends all buffered commands to the server, returning
-    >>> # a list of responses, one for each command.
-    >>> pipe.execute()
-    [True, b'baz']
-
-For ease of use, all commands being buffered into the pipeline return the
-pipeline object itself. Therefore calls can be chained like:
-
-.. code-block:: pycon
-
-    >>> pipe.set('foo', 'bar').sadd('faz', 'baz').incr('auto_number').execute()
-    [True, True, 6]
-
-In addition, pipelines can also ensure the buffered commands are executed
-atomically as a group. This happens by default. If you want to disable the
-atomic nature of a pipeline but still want to buffer commands, you can turn
-off transactions.
-
-.. code-block:: pycon
-
-    >>> pipe = r.pipeline(transaction=False)
-
-A common issue occurs when requiring atomic transactions but needing to
-retrieve values in Redis prior for use within the transaction. For instance,
-let's assume that the INCR command didn't exist and we need to build an atomic
-version of INCR in Python.
-
-The completely naive implementation could GET the value, increment it in
-Python, and SET the new value back. However, this is not atomic because
-multiple clients could be doing this at the same time, each getting the same
-value from GET.
-
-Enter the WATCH command. WATCH provides the ability to monitor one or more keys
-prior to starting a transaction. If any of those keys change prior the
-execution of that transaction, the entire transaction will be canceled and a
-WatchError will be raised. To implement our own client-side INCR command, we
-could do something like this:
-
-.. code-block:: pycon
-
-    >>> with r.pipeline() as pipe:
-    ...     while True:
-    ...         try:
-    ...             # put a WATCH on the key that holds our sequence value
-    ...             pipe.watch('OUR-SEQUENCE-KEY')
-    ...             # after WATCHing, the pipeline is put into immediate execution
-    ...             # mode until we tell it to start buffering commands again.
-    ...             # this allows us to get the current value of our sequence
-    ...             current_value = pipe.get('OUR-SEQUENCE-KEY')
-    ...             next_value = int(current_value) + 1
-    ...             # now we can put the pipeline back into buffered mode with MULTI
-    ...             pipe.multi()
-    ...             pipe.set('OUR-SEQUENCE-KEY', next_value)
-    ...             # and finally, execute the pipeline (the set command)
-    ...             pipe.execute()
-    ...             # if a WatchError wasn't raised during execution, everything
-    ...             # we just did happened atomically.
-    ...             break
-    ...        except WatchError:
-    ...             # another client must have changed 'OUR-SEQUENCE-KEY' between
-    ...             # the time we started WATCHing it and the pipeline's execution.
-    ...             # our best bet is to just retry.
-    ...             continue
-
-Note that, because the Pipeline must bind to a single connection for the
-duration of a WATCH, care must be taken to ensure that the connection is
-returned to the connection pool by calling the reset() method. If the
-Pipeline is used as a context manager (as in the example above) reset()
-will be called automatically. Of course you can do this the manual way by
-explicitly calling reset():
-
-.. code-block:: pycon
-
-    >>> pipe = r.pipeline()
-    >>> while True:
-    ...     try:
-    ...         pipe.watch('OUR-SEQUENCE-KEY')
-    ...         ...
-    ...         pipe.execute()
-    ...         break
-    ...     except WatchError:
-    ...         continue
-    ...     finally:
-    ...         pipe.reset()
-
-A convenience method named "transaction" exists for handling all the
-boilerplate of handling and retrying watch errors. It takes a callable that
-should expect a single parameter, a pipeline object, and any number of keys to
-be WATCHed. Our client-side INCR command above can be written like this,
-which is much easier to read:
-
-.. code-block:: pycon
-
-    >>> def client_side_incr(pipe):
-    ...     current_value = pipe.get('OUR-SEQUENCE-KEY')
-    ...     next_value = int(current_value) + 1
-    ...     pipe.multi()
-    ...     pipe.set('OUR-SEQUENCE-KEY', next_value)
-    >>>
-    >>> r.transaction(client_side_incr, 'OUR-SEQUENCE-KEY')
-    [True]
-
-Be sure to call `pipe.multi()` in the callable passed to `Redis.transaction`
-prior to any write commands.
-
-Publish / Subscribe
-^^^^^^^^^^^^^^^^^^^
-
-redis-py includes a `PubSub` object that subscribes to channels and listens
-for new messages. Creating a `PubSub` object is easy.
-
-.. code-block:: pycon
-
-    >>> r = redis.Redis(...)
-    >>> p = r.pubsub()
-
-Once a `PubSub` instance is created, channels and patterns can be subscribed
-to.
-
-.. code-block:: pycon
-
-    >>> p.subscribe('my-first-channel', 'my-second-channel', ...)
-    >>> p.psubscribe('my-*', ...)
-
-The `PubSub` instance is now subscribed to those channels/patterns. The
-subscription confirmations can be seen by reading messages from the `PubSub`
-instance.
-
-.. code-block:: pycon
-
-    >>> p.get_message()
-    {'pattern': None, 'type': 'subscribe', 'channel': b'my-second-channel', 'data': 1}
-    >>> p.get_message()
-    {'pattern': None, 'type': 'subscribe', 'channel': b'my-first-channel', 'data': 2}
-    >>> p.get_message()
-    {'pattern': None, 'type': 'psubscribe', 'channel': b'my-*', 'data': 3}
-
-Every message read from a `PubSub` instance will be a dictionary with the
-following keys.
-
-* **type**: One of the following: 'subscribe', 'unsubscribe', 'psubscribe',
-  'punsubscribe', 'message', 'pmessage'
-* **channel**: The channel [un]subscribed to or the channel a message was
-  published to
-* **pattern**: The pattern that matched a published message's channel. Will be
-  `None` in all cases except for 'pmessage' types.
-* **data**: The message data. With [un]subscribe messages, this value will be
-  the number of channels and patterns the connection is currently subscribed
-  to. With [p]message messages, this value will be the actual published
-  message.
-
-Let's send a message now.
-
-.. code-block:: pycon
-
-    # the publish method returns the number matching channel and pattern
-    # subscriptions. 'my-first-channel' matches both the 'my-first-channel'
-    # subscription and the 'my-*' pattern subscription, so this message will
-    # be delivered to 2 channels/patterns
-    >>> r.publish('my-first-channel', 'some data')
-    2
-    >>> p.get_message()
-    {'channel': b'my-first-channel', 'data': b'some data', 'pattern': None, 'type': 'message'}
-    >>> p.get_message()
-    {'channel': b'my-first-channel', 'data': b'some data', 'pattern': b'my-*', 'type': 'pmessage'}
-
-Unsubscribing works just like subscribing. If no arguments are passed to
-[p]unsubscribe, all channels or patterns will be unsubscribed from.
-
-.. code-block:: pycon
-
-    >>> p.unsubscribe()
-    >>> p.punsubscribe('my-*')
-    >>> p.get_message()
-    {'channel': b'my-second-channel', 'data': 2, 'pattern': None, 'type': 'unsubscribe'}
-    >>> p.get_message()
-    {'channel': b'my-first-channel', 'data': 1, 'pattern': None, 'type': 'unsubscribe'}
-    >>> p.get_message()
-    {'channel': b'my-*', 'data': 0, 'pattern': None, 'type': 'punsubscribe'}
-
-redis-py also allows you to register callback functions to handle published
-messages. Message handlers take a single argument, the message, which is a
-dictionary just like the examples above. To subscribe to a channel or pattern
-with a message handler, pass the channel or pattern name as a keyword argument
-with its value being the callback function.
-
-When a message is read on a channel or pattern with a message handler, the
-message dictionary is created and passed to the message handler. In this case,
-a `None` value is returned from get_message() since the message was already
-handled.
-
-.. code-block:: pycon
-
-    >>> def my_handler(message):
-    ...     print('MY HANDLER: ', message['data'])
-    >>> p.subscribe(**{'my-channel': my_handler})
-    # read the subscribe confirmation message
-    >>> p.get_message()
-    {'pattern': None, 'type': 'subscribe', 'channel': b'my-channel', 'data': 1}
-    >>> r.publish('my-channel', 'awesome data')
-    1
-    # for the message handler to work, we need tell the instance to read data.
-    # this can be done in several ways (read more below). we'll just use
-    # the familiar get_message() function for now
-    >>> message = p.get_message()
-    MY HANDLER:  awesome data
-    # note here that the my_handler callback printed the string above.
-    # `message` is None because the message was handled by our handler.
-    >>> print(message)
-    None
-
-If your application is not interested in the (sometimes noisy)
-subscribe/unsubscribe confirmation messages, you can ignore them by passing
-`ignore_subscribe_messages=True` to `r.pubsub()`. This will cause all
-subscribe/unsubscribe messages to be read, but they won't bubble up to your
-application.
-
-.. code-block:: pycon
-
-    >>> p = r.pubsub(ignore_subscribe_messages=True)
-    >>> p.subscribe('my-channel')
-    >>> p.get_message()  # hides the subscribe message and returns None
-    >>> r.publish('my-channel', 'my data')
-    1
-    >>> p.get_message()
-    {'channel': b'my-channel', 'data': b'my data', 'pattern': None, 'type': 'message'}
-
-There are three different strategies for reading messages.
-
-The examples above have been using `pubsub.get_message()`. Behind the scenes,
-`get_message()` uses the system's 'select' module to quickly poll the
-connection's socket. If there's data available to be read, `get_message()` will
-read it, format the message and return it or pass it to a message handler. If
-there's no data to be read, `get_message()` will immediately return None. This
-makes it trivial to integrate into an existing event loop inside your
-application.
-
-.. code-block:: pycon
-
-    >>> while True:
-    >>>     message = p.get_message()
-    >>>     if message:
-    >>>         # do something with the message
-    >>>     time.sleep(0.001)  # be nice to the system :)
-
-Older versions of redis-py only read messages with `pubsub.listen()`. listen()
-is a generator that blocks until a message is available. If your application
-doesn't need to do anything else but receive and act on messages received from
-redis, listen() is an easy way to get up an running.
-
-.. code-block:: pycon
-
-    >>> for message in p.listen():
-    ...     # do something with the message
-
-The third option runs an event loop in a separate thread.
-`pubsub.run_in_thread()` creates a new thread and starts the event loop. The
-thread object is returned to the caller of `run_in_thread()`. The caller can
-use the `thread.stop()` method to shut down the event loop and thread. Behind
-the scenes, this is simply a wrapper around `get_message()` that runs in a
-separate thread, essentially creating a tiny non-blocking event loop for you.
-`run_in_thread()` takes an optional `sleep_time` argument. If specified, the
-event loop will call `time.sleep()` with the value in each iteration of the
-loop.
-
-Note: Since we're running in a separate thread, there's no way to handle
-messages that aren't automatically handled with registered message handlers.
-Therefore, redis-py prevents you from calling `run_in_thread()` if you're
-subscribed to patterns or channels that don't have message handlers attached.
-
-.. code-block:: pycon
-
-    >>> p.subscribe(**{'my-channel': my_handler})
-    >>> thread = p.run_in_thread(sleep_time=0.001)
-    # the event loop is now running in the background processing messages
-    # when it's time to shut it down...
-    >>> thread.stop()
-
-`run_in_thread` also supports an optional exception handler, which lets you
-catch exceptions that occur within the worker thread and handle them
-appropriately. The exception handler will take as arguments the exception
-itself, the pubsub object, and the worker thread returned by `run_in_thread`.
-
-.. code-block:: pycon
-
-    >>> p.subscribe(**{'my-channel': my_handler})
-    >>> def exception_handler(ex, pubsub, thread):
-    >>>     print(ex)
-    >>>     thread.stop()
-    >>>     thread.join(timeout=1.0)
-    >>>     pubsub.close()
-    >>> thread = p.run_in_thread(exception_handler=exception_handler)
-
-A PubSub object adheres to the same encoding semantics as the client instance
-it was created from. Any channel or pattern that's unicode will be encoded
-using the `charset` specified on the client before being sent to Redis. If the
-client's `decode_responses` flag is set the False (the default), the
-'channel', 'pattern' and 'data' values in message dictionaries will be byte
-strings (str on Python 2, bytes on Python 3). If the client's
-`decode_responses` is True, then the 'channel', 'pattern' and 'data' values
-will be automatically decoded to unicode strings using the client's `charset`.
-
-PubSub objects remember what channels and patterns they are subscribed to. In
-the event of a disconnection such as a network error or timeout, the
-PubSub object will re-subscribe to all prior channels and patterns when
-reconnecting. Messages that were published while the client was disconnected
-cannot be delivered. When you're finished with a PubSub object, call its
-`.close()` method to shutdown the connection.
-
-.. code-block:: pycon
-
-    >>> p = r.pubsub()
-    >>> ...
-    >>> p.close()
-
-
-The PUBSUB set of subcommands CHANNELS, NUMSUB and NUMPAT are also
-supported:
-
-.. code-block:: pycon
-
-    >>> r.pubsub_channels()
-    [b'foo', b'bar']
-    >>> r.pubsub_numsub('foo', 'bar')
-    [(b'foo', 9001), (b'bar', 42)]
-    >>> r.pubsub_numsub('baz')
-    [(b'baz', 0)]
-    >>> r.pubsub_numpat()
-    1204
-
-Monitor
-^^^^^^^
-redis-py includes a `Monitor` object that streams every command processed
-by the Redis server. Use `listen()` on the `Monitor` object to block
-until a command is received.
-
-.. code-block:: pycon
-
-    >>> r = redis.Redis(...)
-    >>> with r.monitor() as m:
-    >>>     for command in m.listen():
-    >>>         print(command)
-
-Lua Scripting
-^^^^^^^^^^^^^
-
-redis-py supports the EVAL, EVALSHA, and SCRIPT commands. However, there are
-a number of edge cases that make these commands tedious to use in real world
-scenarios. Therefore, redis-py exposes a Script object that makes scripting
-much easier to use.
-
-To create a Script instance, use the `register_script` function on a client
-instance passing the Lua code as the first argument. `register_script` returns
-a Script instance that you can use throughout your code.
-
-The following trivial Lua script accepts two parameters: the name of a key and
-a multiplier value. The script fetches the value stored in the key, multiplies
-it with the multiplier value and returns the result.
-
-.. code-block:: pycon
-
-    >>> r = redis.Redis()
-    >>> lua = """
-    ... local value = redis.call('GET', KEYS[1])
-    ... value = tonumber(value)
-    ... return value * ARGV[1]"""
-    >>> multiply = r.register_script(lua)
-
-`multiply` is now a Script instance that is invoked by calling it like a
-function. Script instances accept the following optional arguments:
-
-* **keys**: A list of key names that the script will access. This becomes the
-  KEYS list in Lua.
-* **args**: A list of argument values. This becomes the ARGV list in Lua.
-* **client**: A redis-py Client or Pipeline instance that will invoke the
-  script. If client isn't specified, the client that initially
-  created the Script instance (the one that `register_script` was
-  invoked from) will be used.
-
-Continuing the example from above:
-
-.. code-block:: pycon
-
-    >>> r.set('foo', 2)
-    >>> multiply(keys=['foo'], args=[5])
-    10
-
-The value of key 'foo' is set to 2. When multiply is invoked, the 'foo' key is
-passed to the script along with the multiplier value of 5. Lua executes the
-script and returns the result, 10.
-
-Script instances can be executed using a different client instance, even one
-that points to a completely different Redis server.
-
-.. code-block:: pycon
-
-    >>> r2 = redis.Redis('redis2.example.com')
-    >>> r2.set('foo', 3)
-    >>> multiply(keys=['foo'], args=[5], client=r2)
-    15
-
-The Script object ensures that the Lua script is loaded into Redis's script
-cache. In the event of a NOSCRIPT error, it will load the script and retry
-executing it.
-
-Script objects can also be used in pipelines. The pipeline instance should be
-passed as the client argument when calling the script. Care is taken to ensure
-that the script is registered in Redis's script cache just prior to pipeline
-execution.
-
-.. code-block:: pycon
-
-    >>> pipe = r.pipeline()
-    >>> pipe.set('foo', 5)
-    >>> multiply(keys=['foo'], args=[5], client=pipe)
-    >>> pipe.execute()
-    [True, 25]
-
-Sentinel support
-^^^^^^^^^^^^^^^^
-
-redis-py can be used together with `Redis Sentinel <https://redis.io/topics/sentinel>`_
-to discover Redis nodes. You need to have at least one Sentinel daemon running
-in order to use redis-py's Sentinel support.
-
-Connecting redis-py to the Sentinel instance(s) is easy. You can use a
-Sentinel connection to discover the master and slaves network addresses:
-
-.. code-block:: pycon
-
-    >>> from redis.sentinel import Sentinel
-    >>> sentinel = Sentinel([('localhost', 26379)], socket_timeout=0.1)
-    >>> sentinel.discover_master('mymaster')
-    ('127.0.0.1', 6379)
-    >>> sentinel.discover_slaves('mymaster')
-    [('127.0.0.1', 6380)]
-
-You can also create Redis client connections from a Sentinel instance. You can
-connect to either the master (for write operations) or a slave (for read-only
-operations).
-
-.. code-block:: pycon
-
-    >>> master = sentinel.master_for('mymaster', socket_timeout=0.1)
-    >>> slave = sentinel.slave_for('mymaster', socket_timeout=0.1)
-    >>> master.set('foo', 'bar')
-    >>> slave.get('foo')
-    b'bar'
-
-The master and slave objects are normal Redis instances with their
-connection pool bound to the Sentinel instance. When a Sentinel backed client
-attempts to establish a connection, it first queries the Sentinel servers to
-determine an appropriate host to connect to. If no server is found,
-a MasterNotFoundError or SlaveNotFoundError is raised. Both exceptions are
-subclasses of ConnectionError.
-
-When trying to connect to a slave client, the Sentinel connection pool will
-iterate over the list of slaves until it finds one that can be connected to.
-If no slaves can be connected to, a connection will be established with the
-master.
-
-See `Guidelines for Redis clients with support for Redis Sentinel
-<https://redis.io/topics/sentinel-clients>`_ to learn more about Redis Sentinel.
-
-Scan Iterators
-^^^^^^^^^^^^^^
-
-The \*SCAN commands introduced in Redis 2.8 can be cumbersome to use. While
-these commands are fully supported, redis-py also exposes the following methods
-that return Python iterators for convenience: `scan_iter`, `hscan_iter`,
-`sscan_iter` and `zscan_iter`.
-
-.. code-block:: pycon
-
-    >>> for key, value in (('A', '1'), ('B', '2'), ('C', '3')):
-    ...     r.set(key, value)
-    >>> for key in r.scan_iter():
-    ...     print(key, r.get(key))
-    A 1
-    B 2
-    C 3
-
-Cluster Mode
-^^^^^^^^^^^^
-
-redis-py does not currently support `Cluster Mode
-<https://redis.io/topics/cluster-tutorial>`_.
-
-Author
-^^^^^^
-
-redis-py is developed and maintained by Andy McCurdy (sedrik@gmail.com).
-It can be found here: https://github.com/redis/redis-py
-
-Special thanks to:
-
-* Ludovico Magnocavallo, author of the original Python Redis client, from
-  which some of the socket code is still used.
-* Alexander Solovyov for ideas on the generic response callback system.
-* Paul Hubbard for initial packaging support.
-
-
-Sponsored by
-^^^^^^^^^^^^
-
-.. image:: ./docs/logo-redis.png
-   :alt: Redis
-   :target: https://www.redis.com

From 20f71abcbf9af4d628c2e1ae1ad07457f8f31bef Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 26 Oct 2021 10:19:00 +0300
Subject: [PATCH 0212/1164] beta2 version and CHANGES update (#1643)

---
 CHANGES           | 7 +++++++
 redis/__init__.py | 2 +-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/CHANGES b/CHANGES
index 801e2f1253..b4372be34e 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,10 @@
+# DEPRECATED
+
+This file is historic. Starting with redis-py 4.0.0b1, please see the GitHub releases page at
+https://github.com/redis/redis-py/releases.
+
+------------------------------------------------------------------------------------------------
+
 * (in development)
     * BACKWARDS INCOMPATIBLE: Removed support for end of life Python 2.7. #1318
     * BACKWARDS INCOMPATIBLE: All values within Redis URLs are unquoted via
diff --git a/redis/__init__.py b/redis/__init__.py
index a3b5eb67e3..3e7831e87b 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -31,7 +31,7 @@ def int_or_str(value):
         return value
 
 
-__version__ = '4.0.0b1'
+__version__ = '4.0.0b2'
 VERSION = tuple(map(int_or_str, __version__.split('.')))
 
 __all__ = [

From 2b0a1e72b82b1706ae8f9939dab0ddd62efe413f Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 26 Oct 2021 12:25:59 +0300
Subject: [PATCH 0213/1164] re-enabling codecov as part of CI process (#1646)

---
 .github/workflows/integration.yaml | 10 +++++-----
 README.md                          |  3 ++-
 dev_requirements.txt               |  1 +
 tox.ini                            |  2 +-
 4 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 2618c336da..45254d0ad0 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -6,11 +6,6 @@ on:
       - 'docs/**'
       - '**/*.rst'
       - '**/*.md'
-  pull_request:
-    paths-ignore:
-      - 'docs/**'
-      - '**/*.rst'
-      - '**/*.md'
 
 jobs:
 
@@ -47,6 +42,11 @@ jobs:
         run: |
           pip install -r dev_requirements.txt
           invoke tests
+      - name: Upload codecov coverage
+        uses: codecov/codecov-action@v2
+        with:
+          fail_ci_if_error: false
+          token: ${{ secrets.CODECOV_TOKEN }}
 
   build_package:
     name: Validate building and installing the package
diff --git a/README.md b/README.md
index 1b535ae36f..b6d3115a0b 100644
--- a/README.md
+++ b/README.md
@@ -5,7 +5,8 @@ The Python interface to the Redis key-value store.
 [![image](https://github.com/redis/redis-py/workflows/CI/badge.svg?branch=master)](https://github.com/redis/redis-py/actions?query=workflow%3ACI+branch%3Amaster) 
 [![image](https://readthedocs.org/projects/redis-py/badge/?version=stable&style=flat)](https://redis-py.readthedocs.io/en/stable/) 
 [![image](https://badge.fury.io/py/redis.svg)](https://pypi.org/project/redis/) 
-[![image](https://codecov.io/gh/redis/redis-py/branch/master/graph/badge.svg)](https://codecov.io/gh/redis/redis-py)
+[![codecov](https://codecov.io/gh/redis/redis-py/branch/master/graph/badge.svg?token=yenl5fzxxr)](https://codecov.io/gh/redis/redis-py)
+
 
 ## Python 2 Compatibility Note
 
diff --git a/dev_requirements.txt b/dev_requirements.txt
index 2648127712..d3f91fef3d 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -3,3 +3,4 @@ pytest==6.2.5
 tox==3.24.4
 tox-docker==3.1.0
 invoke==1.6.0
+pytest-cov>=3.0.0
\ No newline at end of file
diff --git a/tox.ini b/tox.ini
index 7d79d38f13..67b7e7575d 100644
--- a/tox.ini
+++ b/tox.ini
@@ -86,7 +86,7 @@ docker =
 extras =
     hiredis: hiredis
 commands =
-    pytest -W always {posargs}
+    pytest --cov=./ --cov-report=xml -W always {posargs}
 
 [testenv:devenv]
 skipsdist = true

From 866ac00b45a144753c40bb466e784a8917212172 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 26 Oct 2021 14:13:20 +0300
Subject: [PATCH 0214/1164] Fixing the package to include commands (#1649)

* Fixing the package to include commands.

Fixes #1645
---
 docs/conf.py      | 152 +++++++++++++++++++++++++---------------------
 redis/__init__.py |   2 +-
 setup.cfg         |  39 ------------
 setup.py          |  43 ++++++++++++-
 4 files changed, 124 insertions(+), 112 deletions(-)
 delete mode 100644 setup.cfg

diff --git a/docs/conf.py b/docs/conf.py
index 3eb3f33ef2..dfdaf9ea57 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -16,212 +16,218 @@
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
-#sys.path.insert(0, os.path.abspath('.'))
+# sys.path.insert(0, os.path.abspath('.'))
 sys.path.append(os.path.abspath(os.path.pardir))
 
 # -- General configuration ----------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
-#needs_sphinx = '1.0'
+# needs_sphinx = '1.0'
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['sphinx.ext.autodoc', 'sphinx.ext.doctest', 'sphinx.ext.viewcode']
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.doctest",
+    "sphinx.ext.viewcode"
+]
 
 # Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
+templates_path = ["_templates"]
 
 # The suffix of source filenames.
-source_suffix = '.rst'
+source_suffix = ".rst"
 
 # The encoding of source files.
-#source_encoding = 'utf-8-sig'
+# source_encoding = 'utf-8-sig'
 
 # The master toctree document.
-master_doc = 'index'
+master_doc = "index"
 
 # General information about the project.
-project = 'redis-py'
-copyright = '2016, Andy McCurdy'
+project = "redis-py"
+copyright = "2016, Andy McCurdy"
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.
-version = '2.10.5'
+version = "2.10.5"
 # The full version, including alpha/beta/rc tags.
-release = '2.10.5'
+release = "2.10.5"
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
-#language = None
+# language = None
 
 # There are two options for replacing |today|: either, you set today to some
 # non-false value, then it is used:
-#today = ''
+# today = ''
 # Else, today_fmt is used as the format for a strftime call.
-#today_fmt = '%B %d, %Y'
+# today_fmt = '%B %d, %Y'
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
-exclude_patterns = ['_build']
+exclude_patterns = ["_build"]
 
 # The reST default role (used for this markup: `text`) to use for all
 # documents.
-#default_role = None
+# default_role = None
 
 # If true, '()' will be appended to :func: etc. cross-reference text.
-#add_function_parentheses = True
+# add_function_parentheses = True
 
 # If true, the current module name will be prepended to all description
 # unit titles (such as .. function::).
-#add_module_names = True
+# add_module_names = True
 
 # If true, sectionauthor and moduleauthor directives will be shown in the
 # output. They are ignored by default.
-#show_authors = False
+# show_authors = False
 
 # The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'sphinx'
+pygments_style = "sphinx"
 
 # A list of ignored prefixes for module index sorting.
-#modindex_common_prefix = []
+# modindex_common_prefix = []
 
 
 # -- Options for HTML output --------------------------------------------------
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'default'
+html_theme = "default"
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
-#html_theme_options = {}
+# html_theme_options = {}
 
 # Add any paths that contain custom themes here, relative to this directory.
-#html_theme_path = []
+# html_theme_path = []
 
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".
-#html_title = None
+# html_title = None
 
 # A shorter title for the navigation bar.  Default is the same as html_title.
-#html_short_title = None
+# html_short_title = None
 
 # The name of an image file (relative to this directory) to place at the top
 # of the sidebar.
-#html_logo = None
+# html_logo = None
 
 # The name of an image file (within the static path) to use as favicon of the
 # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
 # pixels large.
-#html_favicon = None
+# html_favicon = None
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+html_static_path = ["_static"]
 
 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
 # using the given strftime format.
-#html_last_updated_fmt = '%b %d, %Y'
+# html_last_updated_fmt = '%b %d, %Y'
 
 # If true, SmartyPants will be used to convert quotes and dashes to
 # typographically correct entities.
-#html_use_smartypants = True
+# html_use_smartypants = True
 
 # Custom sidebar templates, maps document names to template names.
-#html_sidebars = {}
+# html_sidebars = {}
 
 # Additional templates that should be rendered to pages, maps page names to
 # template names.
-#html_additional_pages = {}
+# html_additional_pages = {}
 
 # If false, no module index is generated.
-#html_domain_indices = True
+# html_domain_indices = True
 
 # If false, no index is generated.
-#html_use_index = True
+# html_use_index = True
 
 # If true, the index is split into individual pages for each letter.
-#html_split_index = False
+# html_split_index = False
 
 # If true, links to the reST sources are added to the pages.
-#html_show_sourcelink = True
+# html_show_sourcelink = True
 
 # If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
-#html_show_sphinx = True
+# html_show_sphinx = True
 
 # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
-#html_show_copyright = True
+# html_show_copyright = True
 
 # If true, an OpenSearch description file will be output, and all pages will
 # contain a <link> tag referring to it.  The value of this option must be the
 # base URL from which the finished HTML is served.
-#html_use_opensearch = ''
+# html_use_opensearch = ''
 
 # This is the file name suffix for HTML files (e.g. ".xhtml").
-#html_file_suffix = None
+# html_file_suffix = None
 
 # Output file base name for HTML help builder.
-htmlhelp_basename = 'redis-pydoc'
+htmlhelp_basename = "redis-pydoc"
 
 
 # -- Options for LaTeX output -------------------------------------------------
 
 latex_elements = {
     # The paper size ('letterpaper' or 'a4paper').
-    #'papersize': 'letterpaper',
-
+    # 'papersize': 'letterpaper',
     # The font size ('10pt', '11pt' or '12pt').
-    #'pointsize': '10pt',
-
+    # 'pointsize': '10pt',
     # Additional stuff for the LaTeX preamble.
-    #'preamble': '',
+    # 'preamble': '',
 }
 
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title, author, documentclass
 # [howto/manual]).
 latex_documents = [
-    ('index', 'redis-py.tex', 'redis-py Documentation',
-     'Andy McCurdy', 'manual'),
+    ("index",
+        "redis-py.tex",
+        "redis-py Documentation",
+        "Andy McCurdy",
+        "manual"),
 ]
 
 # The name of an image file (relative to this directory) to place at the top of
 # the title page.
-#latex_logo = None
+# latex_logo = None
 
 # For "manual" documents, if this is true, then toplevel headings are parts,
 # not chapters.
-#latex_use_parts = False
+# latex_use_parts = False
 
 # If true, show page references after internal links.
-#latex_show_pagerefs = False
+# latex_show_pagerefs = False
 
 # If true, show URL addresses after external links.
-#latex_show_urls = False
+# latex_show_urls = False
 
 # Documents to append as an appendix to all manuals.
-#latex_appendices = []
+# latex_appendices = []
 
 # If false, no module index is generated.
-#latex_domain_indices = True
+# latex_domain_indices = True
 
 
 # -- Options for manual page output -------------------------------------------
 
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
-man_pages = [
-    ('index', 'redis-py', 'redis-py Documentation',
-     ['Andy McCurdy'], 1)
-]
+man_pages = [(
+    "index",
+    "redis-py",
+    "redis-py Documentation",
+    ["Andy McCurdy"], 1)]
 
 # If true, show URL addresses after external links.
-#man_show_urls = False
+# man_show_urls = False
 
 
 # -- Options for Texinfo output -----------------------------------------------
@@ -230,21 +236,27 @@
 # (source start file, target name, title, author,
 #  dir menu entry, description, category)
 texinfo_documents = [
-    ('index', 'redis-py', 'redis-py Documentation',
-     'Andy McCurdy', 'redis-py',
-     'One line description of project.', 'Miscellaneous'),
+    (
+        "index",
+        "redis-py",
+        "redis-py Documentation",
+        "Andy McCurdy",
+        "redis-py",
+        "One line description of project.",
+        "Miscellaneous",
+    ),
 ]
 
 # Documents to append as an appendix to all manuals.
-#texinfo_appendices = []
+# texinfo_appendices = []
 
 # If false, no module index is generated.
-#texinfo_domain_indices = True
+# texinfo_domain_indices = True
 
 # How to display URL addresses: 'footnote', 'no', or 'inline'.
-#texinfo_show_urls = 'footnote'
+# texinfo_show_urls = 'footnote'
 
-epub_title = 'redis-py'
-epub_author = 'Andy McCurdy'
-epub_publisher = 'Andy McCurdy'
-epub_copyright = '2011, Andy McCurdy'
+epub_title = "redis-py"
+epub_author = "Andy McCurdy"
+epub_publisher = "Andy McCurdy"
+epub_copyright = "2011, Andy McCurdy"
diff --git a/redis/__init__.py b/redis/__init__.py
index 3e7831e87b..2458b5bc49 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -31,7 +31,7 @@ def int_or_str(value):
         return value
 
 
-__version__ = '4.0.0b2'
+__version__ = '4.0.0b3'
 VERSION = tuple(map(int_or_str, __version__.split('.')))
 
 __all__ = [
diff --git a/setup.cfg b/setup.cfg
deleted file mode 100644
index a9c98491f8..0000000000
--- a/setup.cfg
+++ /dev/null
@@ -1,39 +0,0 @@
-[metadata]
-name = redis
-version = attr: redis.__version__
-description = Python client for Redis key-value store
-long_description = file: README.rst
-url = https://github.com/andymccurdy/redis-py
-author = Andy McCurdy
-author_email = sedrik@gmail.com
-maintainer = Andy McCurdy
-maintainer_email = sedrik@gmail.com
-keywords = Redis, key-value store
-license = MIT
-classifiers =
-    Development Status :: 5 - Production/Stable
-    Environment :: Console
-    Intended Audience :: Developers
-    License :: OSI Approved :: MIT License
-    Operating System :: OS Independent
-    Programming Language :: Python
-    Programming Language :: Python :: 3
-    Programming Language :: Python :: 3 :: Only
-    Programming Language :: Python :: 3.5
-    Programming Language :: Python :: 3.6
-    Programming Language :: Python :: 3.7
-    Programming Language :: Python :: 3.8
-    Programming Language :: Python :: 3.9
-    Programming Language :: Python :: Implementation :: CPython
-    Programming Language :: Python :: Implementation :: PyPy
-
-
-[options]
-packages = redis
-python_requires = >=3.5
-
-[options.extras_require]
-hiredis = hiredis>=0.1.3
-
-[flake8]
-exclude = .venv,.tox,dist,docs,build,*.egg,redis_install,env,venv,.undodir
diff --git a/setup.py b/setup.py
index c823345536..50c3d912ee 100644
--- a/setup.py
+++ b/setup.py
@@ -1,4 +1,43 @@
 #!/usr/bin/env python
-from setuptools import setup
+from setuptools import setup, find_packages
+import redis
 
-setup()
+setup(
+    name="redis",
+    description="Python client for Redis database and key-value store",
+    long_description=open("README.md").read().strip(),
+    keywords=["Redis", "key-value store", "database"],
+    license="MIT",
+    version=redis.__version__,
+    packages=find_packages(
+        include=[
+            "redis",
+            "redis.commands",
+            "redis.commands.json",
+            "redis.commands.search",
+        ]
+    ),
+    url="https://github.com/redis/redis-py",
+    author="Redis Inc.",
+    author_email="oss@redis.com",
+    classifiers=[
+        "Development Status :: 5 - Production/Stable",
+        "Environment :: Console",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3 :: Only",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: Implementation :: CPython",
+        "Programming Language :: Python :: Implementation :: PyPy",
+    ],
+    extras_require={
+        "hiredis": ["hiredis>=1.0.0"],
+    },
+)

From 396e7323959b7a79d72602afee3ef648dc23adf9 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 26 Oct 2021 14:24:54 +0300
Subject: [PATCH 0215/1164] Exposing the module version in loaded_modules
 (#1648)

This is useful for the case where one wants to instantiate a module, knowing the back end version. The reason: behaviour may differ based on redis module versions.
---
 redis/client.py                   |  3 ++-
 redis/commands/json/__init__.py   |  2 ++
 redis/commands/redismodules.py    | 18 +++++++++++++-----
 redis/commands/search/__init__.py |  3 ++-
 tests/test_connection.py          |  2 +-
 5 files changed, 20 insertions(+), 8 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 4db9887f4d..986af7cfba 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -930,7 +930,8 @@ def loaded_modules(self):
             return mods
 
         try:
-            mods = [f.get('name').lower() for f in self.info().get('modules')]
+            mods = {f.get('name').lower(): f.get('ver')
+                    for f in self.info().get('modules')}
         except TypeError:
             mods = []
         setattr(self, key, mods)
diff --git a/redis/commands/json/__init__.py b/redis/commands/json/__init__.py
index 92f119992f..2e26de3efe 100644
--- a/redis/commands/json/__init__.py
+++ b/redis/commands/json/__init__.py
@@ -23,6 +23,7 @@ class JSON(JSONCommands):
     def __init__(
         self,
         client,
+        version=None,
         decoder=JSONDecoder(),
         encoder=JSONEncoder(),
     ):
@@ -62,6 +63,7 @@ def __init__(
 
         self.client = client
         self.execute_command = client.execute_command
+        self.MODULE_VERSION = version
 
         for key, value in self.MODULE_CALLBACKS.items():
             self.client.set_response_callback(key, value)
diff --git a/redis/commands/redismodules.py b/redis/commands/redismodules.py
index 2c9066a2e7..3ecce295c2 100644
--- a/redis/commands/redismodules.py
+++ b/redis/commands/redismodules.py
@@ -9,18 +9,26 @@ class RedisModuleCommands:
 
     def json(self, encoder=JSONEncoder(), decoder=JSONDecoder()):
         """Access the json namespace, providing support for redis json."""
-        if 'rejson' not in self.loaded_modules:
+        try:
+            modversion = self.loaded_modules['rejson']
+        except IndexError:
             raise ModuleError("rejson is not a loaded in the redis instance.")
 
         from .json import JSON
-        jj = JSON(client=self, encoder=encoder, decoder=decoder)
+        jj = JSON(
+                client=self,
+                version=modversion,
+                encoder=encoder,
+                decoder=decoder)
         return jj
 
     def ft(self, index_name="idx"):
         """Access the search namespace, providing support for redis search."""
-        if 'search' not in self.loaded_modules:
-            raise ModuleError("search is not a loaded in the redis instance.")
+        try:
+            modversion = self.loaded_modules['search']
+        except IndexError:
+            raise ModuleError("rejson is not a loaded in the redis instance.")
 
         from .search import Search
-        s = Search(client=self, index_name=index_name)
+        s = Search(client=self, version=modversion, index_name=index_name)
         return s
diff --git a/redis/commands/search/__init__.py b/redis/commands/search/__init__.py
index 8320ad4392..425578eabd 100644
--- a/redis/commands/search/__init__.py
+++ b/redis/commands/search/__init__.py
@@ -83,7 +83,7 @@ def commit(self):
             self.pipeline.execute()
             self.current_chunk = 0
 
-    def __init__(self, client, index_name="idx"):
+    def __init__(self, client, version=None, index_name="idx"):
         """
         Create a new Client for the given index_name.
         The default name is `idx`
@@ -91,6 +91,7 @@ def __init__(self, client, index_name="idx"):
         If conn is not None, we employ an already existing redis connection
         """
         self.client = client
+        self.MODULE_VERSION = version
         self.index_name = index_name
         self.execute_command = client.execute_command
         self.pipeline = client.pipeline
diff --git a/tests/test_connection.py b/tests/test_connection.py
index 6728e0a05f..fa9a2b0c90 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -20,7 +20,7 @@ def test_invalid_response(r):
 @skip_if_server_version_lt('4.0.0')
 def test_loaded_modules(r, modclient):
     assert r.loaded_modules == []
-    assert 'rejson' in modclient.loaded_modules
+    assert 'rejson' in modclient.loaded_modules.keys()
 
 
 @skip_if_server_version_lt('4.0.0')

From 1f3d9700a9fbe9143ca7c344b5425e08f9220105 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 26 Oct 2021 14:33:41 +0300
Subject: [PATCH 0216/1164] Adding description format for package (#1651)

---
 setup.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/setup.py b/setup.py
index 50c3d912ee..9555f7bda6 100644
--- a/setup.py
+++ b/setup.py
@@ -6,6 +6,7 @@
     name="redis",
     description="Python client for Redis database and key-value store",
     long_description=open("README.md").read().strip(),
+    long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
     version=redis.__version__,

From 20177868a94e5ff190551d4cdf2e7acc7126733f Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 26 Oct 2021 17:22:45 +0300
Subject: [PATCH 0217/1164] restore actions to prs (#1653)

* restore actions to prs

* limiting pr runs for actions against master
---
 .github/workflows/integration.yaml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 45254d0ad0..4a073948cb 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -6,6 +6,9 @@ on:
       - 'docs/**'
       - '**/*.rst'
       - '**/*.md'
+  pull_request:
+    branches:
+      - master
 
 jobs:
 

From 992b149732a96ccfe049f84c1b556b8d14f12161 Mon Sep 17 00:00:00 2001
From: Nicusor Picatureanu <33037485+Nicusor97@users.noreply.github.com>
Date: Wed, 27 Oct 2021 15:10:31 +0300
Subject: [PATCH 0218/1164] Add python_requires setuptools check for python >
 3.6 (#1656)

---
 setup.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/setup.py b/setup.py
index 9555f7bda6..9788d2ed96 100644
--- a/setup.py
+++ b/setup.py
@@ -21,6 +21,7 @@
     url="https://github.com/redis/redis-py",
     author="Redis Inc.",
     author_email="oss@redis.com",
+    python_requires=">=3.6",
     classifiers=[
         "Development Status :: 5 - Production/Stable",
         "Environment :: Console",

From 1f11f8c4ecbc2227c28077b9e9764e543c38d0a5 Mon Sep 17 00:00:00 2001
From: Guy Korland <gkorland@gmail.com>
Date: Thu, 28 Oct 2021 09:36:52 +0300
Subject: [PATCH 0219/1164] Update badges in README.md (#1654)

---
 README.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index b6d3115a0b..4bcea7be33 100644
--- a/README.md
+++ b/README.md
@@ -2,10 +2,11 @@
 
 The Python interface to the Redis key-value store.
 
-[![image](https://github.com/redis/redis-py/workflows/CI/badge.svg?branch=master)](https://github.com/redis/redis-py/actions?query=workflow%3ACI+branch%3Amaster) 
-[![image](https://readthedocs.org/projects/redis-py/badge/?version=stable&style=flat)](https://redis-py.readthedocs.io/en/stable/) 
-[![image](https://badge.fury.io/py/redis.svg)](https://pypi.org/project/redis/) 
+[![CI](https://github.com/redis/redis-py/workflows/CI/badge.svg?branch=master)](https://github.com/redis/redis-py/actions?query=workflow%3ACI+branch%3Amaster) 
+[![docs](https://readthedocs.org/projects/redis-py/badge/?version=stable&style=flat)](https://redis-py.readthedocs.io/en/stable/) 
+[![pypi](https://badge.fury.io/py/redis.svg)](https://pypi.org/project/redis/) 
 [![codecov](https://codecov.io/gh/redis/redis-py/branch/master/graph/badge.svg?token=yenl5fzxxr)](https://codecov.io/gh/redis/redis-py)
+[![Total alerts](https://img.shields.io/lgtm/alerts/g/redis/redis-py.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/redis/redis-py/alerts/)
 
 
 ## Python 2 Compatibility Note

From eaa56b7d721182541bab087a6d61304c778f7ea9 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 28 Oct 2021 09:57:03 +0300
Subject: [PATCH 0220/1164] redis timeseries support (#1652)

---
 redis/commands/helpers.py             |  14 +
 redis/commands/json/__init__.py       |   4 -
 redis/commands/redismodules.py        |  16 +-
 redis/commands/timeseries/__init__.py |  61 ++
 redis/commands/timeseries/commands.py | 775 ++++++++++++++++++++++++++
 redis/commands/timeseries/info.py     |  82 +++
 redis/commands/timeseries/utils.py    |  49 ++
 setup.py                              |   1 +
 tests/test_timeseries.py              | 593 ++++++++++++++++++++
 9 files changed, 1590 insertions(+), 5 deletions(-)
 create mode 100644 redis/commands/timeseries/__init__.py
 create mode 100644 redis/commands/timeseries/commands.py
 create mode 100644 redis/commands/timeseries/info.py
 create mode 100644 redis/commands/timeseries/utils.py
 create mode 100644 tests/test_timeseries.py

diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
index b012621b3b..a92c02503e 100644
--- a/redis/commands/helpers.py
+++ b/redis/commands/helpers.py
@@ -23,3 +23,17 @@ def nativestr(x):
 def delist(x):
     """Given a list of binaries, return the stringified version."""
     return [nativestr(obj) for obj in x]
+
+
+def parse_to_list(response):
+    """Optimistally parse the response to a list.
+    """
+    res = []
+    for item in response:
+        try:
+            res.append(int(item))
+        except ValueError:
+            res.append(nativestr(item))
+        except TypeError:
+            res.append(None)
+    return res
diff --git a/redis/commands/json/__init__.py b/redis/commands/json/__init__.py
index 2e26de3efe..978370553a 100644
--- a/redis/commands/json/__init__.py
+++ b/redis/commands/json/__init__.py
@@ -1,12 +1,8 @@
-# from typing import Optional
 from json import JSONDecoder, JSONEncoder
 
-# # from redis.client import Redis
-
 from .helpers import bulk_of_jsons
 from ..helpers import nativestr, delist
 from .commands import JSONCommands
-# from ..feature import AbstractFeature
 
 
 class JSON(JSONCommands):
diff --git a/redis/commands/redismodules.py b/redis/commands/redismodules.py
index 3ecce295c2..457a69e2a2 100644
--- a/redis/commands/redismodules.py
+++ b/redis/commands/redismodules.py
@@ -27,8 +27,22 @@ def ft(self, index_name="idx"):
         try:
             modversion = self.loaded_modules['search']
         except IndexError:
-            raise ModuleError("rejson is not a loaded in the redis instance.")
+            raise ModuleError("search is not a loaded in the redis instance.")
 
         from .search import Search
         s = Search(client=self, version=modversion, index_name=index_name)
         return s
+
+    def ts(self, index_name="idx"):
+        """Access the timeseries namespace, providing support for
+        redis timeseries data.
+        """
+        try:
+            modversion = self.loaded_modules['timeseries']
+        except IndexError:
+            raise ModuleError("timeseries is not a loaded in "
+                              "the redis instance.")
+
+        from .timeseries import TimeSeries
+        s = TimeSeries(client=self, version=modversion, index_name=index_name)
+        return s
diff --git a/redis/commands/timeseries/__init__.py b/redis/commands/timeseries/__init__.py
new file mode 100644
index 0000000000..db9c3a55d4
--- /dev/null
+++ b/redis/commands/timeseries/__init__.py
@@ -0,0 +1,61 @@
+from redis.client import bool_ok
+
+from .utils import (
+    parse_range,
+    parse_get,
+    parse_m_range,
+    parse_m_get,
+)
+from .info import TSInfo
+from ..helpers import parse_to_list
+from .commands import (
+    ALTER_CMD,
+    CREATE_CMD,
+    CREATERULE_CMD,
+    DELETERULE_CMD,
+    DEL_CMD,
+    GET_CMD,
+    INFO_CMD,
+    MGET_CMD,
+    MRANGE_CMD,
+    MREVRANGE_CMD,
+    QUERYINDEX_CMD,
+    RANGE_CMD,
+    REVRANGE_CMD,
+    TimeSeriesCommands,
+)
+
+
+class TimeSeries(TimeSeriesCommands):
+    """
+    This class subclasses redis-py's `Redis` and implements RedisTimeSeries's
+    commands (prefixed with "ts").
+    The client allows to interact with RedisTimeSeries and use all of it's
+    functionality.
+    """
+
+    def __init__(self, client=None, version=None, **kwargs):
+        """Create a new RedisTimeSeries client."""
+        # Set the module commands' callbacks
+        MODULE_CALLBACKS = {
+            CREATE_CMD: bool_ok,
+            ALTER_CMD: bool_ok,
+            CREATERULE_CMD: bool_ok,
+            DEL_CMD: int,
+            DELETERULE_CMD: bool_ok,
+            RANGE_CMD: parse_range,
+            REVRANGE_CMD: parse_range,
+            MRANGE_CMD: parse_m_range,
+            MREVRANGE_CMD: parse_m_range,
+            GET_CMD: parse_get,
+            MGET_CMD: parse_m_get,
+            INFO_CMD: TSInfo,
+            QUERYINDEX_CMD: parse_to_list,
+        }
+
+        self.client = client
+        self.execute_command = client.execute_command
+        self.MODULE_VERSION = version
+
+        for k in MODULE_CALLBACKS:
+            self.client.set_response_callback(k, MODULE_CALLBACKS[k])
diff --git a/redis/commands/timeseries/commands.py b/redis/commands/timeseries/commands.py
new file mode 100644
index 0000000000..3b9ee0f8b3
--- /dev/null
+++ b/redis/commands/timeseries/commands.py
@@ -0,0 +1,775 @@
+from redis.exceptions import DataError
+
+
+ADD_CMD = "TS.ADD"
+ALTER_CMD = "TS.ALTER"
+CREATERULE_CMD = "TS.CREATERULE"
+CREATE_CMD = "TS.CREATE"
+DECRBY_CMD = "TS.DECRBY"
+DELETERULE_CMD = "TS.DELETERULE"
+DEL_CMD = "TS.DEL"
+GET_CMD = "TS.GET"
+INCRBY_CMD = "TS.INCRBY"
+INFO_CMD = "TS.INFO"
+MADD_CMD = "TS.MADD"
+MGET_CMD = "TS.MGET"
+MRANGE_CMD = "TS.MRANGE"
+MREVRANGE_CMD = "TS.MREVRANGE"
+QUERYINDEX_CMD = "TS.QUERYINDEX"
+RANGE_CMD = "TS.RANGE"
+REVRANGE_CMD = "TS.REVRANGE"
+
+
+class TimeSeriesCommands:
+    """RedisTimeSeries Commands."""
+
+    def create(self, key, **kwargs):
+        """
+        Create a new time-series.
+        For more information see
+        `TS.CREATE <https://oss.redis.com/redistimeseries/master/commands/#tscreate>`_.  # noqa
+
+        Args:
+
+        key:
+            time-series key
+        retention_msecs:
+            Maximum age for samples compared to last event time (in milliseconds).
+            If None or 0 is passed then  the series is not trimmed at all.
+        uncompressed:
+            Since RedisTimeSeries v1.2, both timestamps and values are
+            compressed by default.
+            Adding this flag will keep data in an uncompressed form.
+            Compression not only saves
+            memory but usually improve performance due to lower number
+            of memory accesses.
+        labels:
+            Set of label-value pairs that represent metadata labels of the key.
+        chunk_size:
+            Each time-serie uses chunks of memory of fixed size for
+            time series samples.
+            You can alter the default TSDB chunk size by passing the
+            chunk_size argument (in Bytes).
+        duplicate_policy:
+            Since RedisTimeSeries v1.4 you can specify the duplicate sample policy
+            ( Configure what to do on duplicate sample. )
+            Can be one of:
+            - 'block': an error will occur for any out of order sample.
+            - 'first': ignore the new value.
+            - 'last': override with latest value.
+            - 'min': only override if the value is lower than the existing value.
+            - 'max': only override if the value is higher than the existing value.
+            When this is not set, the server-wide default will be used.
+        """
+        retention_msecs = kwargs.get("retention_msecs", None)
+        uncompressed = kwargs.get("uncompressed", False)
+        labels = kwargs.get("labels", {})
+        chunk_size = kwargs.get("chunk_size", None)
+        duplicate_policy = kwargs.get("duplicate_policy", None)
+        params = [key]
+        self._appendRetention(params, retention_msecs)
+        self._appendUncompressed(params, uncompressed)
+        self._appendChunkSize(params, chunk_size)
+        self._appendDuplicatePolicy(params, CREATE_CMD, duplicate_policy)
+        self._appendLabels(params, labels)
+
+        return self.execute_command(CREATE_CMD, *params)
+
+    def alter(self, key, **kwargs):
+        """
+        Update the retention, labels of an existing key.
+        For more information see
+        `TS.ALTER <https://oss.redis.com/redistimeseries/master/commands/#tsalter>`_.  # noqa
+
+        The parameters are the same as TS.CREATE.
+        """
+        retention_msecs = kwargs.get("retention_msecs", None)
+        labels = kwargs.get("labels", {})
+        duplicate_policy = kwargs.get("duplicate_policy", None)
+        params = [key]
+        self._appendRetention(params, retention_msecs)
+        self._appendDuplicatePolicy(params, ALTER_CMD, duplicate_policy)
+        self._appendLabels(params, labels)
+
+        return self.execute_command(ALTER_CMD, *params)
+
+    def add(self, key, timestamp, value, **kwargs):
+        """
+        Append (or create and append) a new sample to the series.
+        For more information see
+        `TS.ADD <https://oss.redis.com/redistimeseries/master/commands/#tsadd>`_. # noqa
+
+        Args:
+
+        key:
+            time-series key
+        timestamp:
+            Timestamp of the sample. * can be used for automatic timestamp (using the system clock).
+        value:
+            Numeric data value of the sample
+        retention_msecs:
+            Maximum age for samples compared to last event time (in milliseconds).
+            If None or 0 is passed then  the series is not trimmed at all.
+        uncompressed:
+            Since RedisTimeSeries v1.2, both timestamps and values are compressed by default.
+            Adding this flag will keep data in an uncompressed form. Compression not only saves
+            memory but usually improve performance due to lower number of memory accesses.
+        labels:
+            Set of label-value pairs that represent metadata labels of the key.
+        chunk_size:
+            Each time-serie uses chunks of memory of fixed size for time series samples.
+            You can alter the default TSDB chunk size by passing the chunk_size argument (in Bytes).
+        duplicate_policy:
+            Since RedisTimeSeries v1.4 you can specify the duplicate sample policy
+            (Configure what to do on duplicate sample).
+            Can be one of:
+            - 'block': an error will occur for any out of order sample.
+            - 'first': ignore the new value.
+            - 'last': override with latest value.
+            - 'min': only override if the value is lower than the existing value.
+            - 'max': only override if the value is higher than the existing value.
+            When this is not set, the server-wide default will be used.
+        """
+        retention_msecs = kwargs.get("retention_msecs", None)
+        uncompressed = kwargs.get("uncompressed", False)
+        labels = kwargs.get("labels", {})
+        chunk_size = kwargs.get("chunk_size", None)
+        duplicate_policy = kwargs.get("duplicate_policy", None)
+        params = [key, timestamp, value]
+        self._appendRetention(params, retention_msecs)
+        self._appendUncompressed(params, uncompressed)
+        self._appendChunkSize(params, chunk_size)
+        self._appendDuplicatePolicy(params, ADD_CMD, duplicate_policy)
+        self._appendLabels(params, labels)
+
+        return self.execute_command(ADD_CMD, *params)
+
+    def madd(self, ktv_tuples):
+        """
+        Append (or create and append) a new `value` to series
+        `key` with `timestamp`.
+        Expects a list of `tuples` as (`key`,`timestamp`, `value`).
+        Return value is an array with timestamps of insertions.
+        For more information see
+        `TS.MADD <https://oss.redis.com/redistimeseries/master/commands/#tsmadd>`_. # noqa
+        """
+        params = []
+        for ktv in ktv_tuples:
+            for item in ktv:
+                params.append(item)
+
+        return self.execute_command(MADD_CMD, *params)
+
+    def incrby(self, key, value, **kwargs):
+        """
+        Increment (or create an time-series and increment) the latest
+        sample's of a series.
+        This command can be used as a counter or gauge that automatically gets
+        history as a time series.
+        For more information see
+        `TS.INCRBY <https://oss.redis.com/redistimeseries/master/commands/#tsincrbytsdecrby>`_. # noqa
+
+        Args:
+
+        key:
+            time-series key
+        value:
+            Numeric data value of the sample
+        timestamp:
+            Timestamp of the sample. None can be used for automatic timestamp (using the system clock).
+        retention_msecs:
+            Maximum age for samples compared to last event time (in milliseconds).
+            If None or 0 is passed then  the series is not trimmed at all.
+        uncompressed:
+            Since RedisTimeSeries v1.2, both timestamps and values are compressed by default.
+            Adding this flag will keep data in an uncompressed form. Compression not only saves
+            memory but usually improve performance due to lower number of memory accesses.
+        labels:
+            Set of label-value pairs that represent metadata labels of the key.
+        chunk_size:
+            Each time-series uses chunks of memory of fixed size for time series samples.
+            You can alter the default TSDB chunk size by passing the chunk_size argument (in Bytes).
+        """
+        timestamp = kwargs.get("timestamp", None)
+        retention_msecs = kwargs.get("retention_msecs", None)
+        uncompressed = kwargs.get("uncompressed", False)
+        labels = kwargs.get("labels", {})
+        chunk_size = kwargs.get("chunk_size", None)
+        params = [key, value]
+        self._appendTimestamp(params, timestamp)
+        self._appendRetention(params, retention_msecs)
+        self._appendUncompressed(params, uncompressed)
+        self._appendChunkSize(params, chunk_size)
+        self._appendLabels(params, labels)
+
+        return self.execute_command(INCRBY_CMD, *params)
+
+    def decrby(self, key, value, **kwargs):
+        """
+        Decrement (or create an time-series and decrement) the
+        latest sample's of a series.
+        This command can be used as a counter or gauge that
+        automatically gets history as a time series.
+        For more information see
+        `TS.DECRBY <https://oss.redis.com/redistimeseries/master/commands/#tsincrbytsdecrby>`_. # noqa
+
+        Args:
+
+        key:
+            time-series key
+        value:
+            Numeric data value of the sample
+        timestamp:
+            Timestamp of the sample. None can be used for automatic
+            timestamp (using the system clock).
+        retention_msecs:
+            Maximum age for samples compared to last event time (in milliseconds).
+            If None or 0 is passed then  the series is not trimmed at all.
+        uncompressed:
+            Since RedisTimeSeries v1.2, both timestamps and values are
+            compressed by default.
+            Adding this flag will keep data in an uncompressed form.
+            Compression not only saves
+            memory but usually improve performance due to lower number
+            of memory accesses.
+        labels:
+            Set of label-value pairs that represent metadata labels of the key.
+        chunk_size:
+            Each time-series uses chunks of memory of fixed size for time series samples.
+            You can alter the default TSDB chunk size by passing the chunk_size argument (in Bytes).
+        """
+        timestamp = kwargs.get("timestamp", None)
+        retention_msecs = kwargs.get("retention_msecs", None)
+        uncompressed = kwargs.get("uncompressed", False)
+        labels = kwargs.get("labels", {})
+        chunk_size = kwargs.get("chunk_size", None)
+        params = [key, value]
+        self._appendTimestamp(params, timestamp)
+        self._appendRetention(params, retention_msecs)
+        self._appendUncompressed(params, uncompressed)
+        self._appendChunkSize(params, chunk_size)
+        self._appendLabels(params, labels)
+
+        return self.execute_command(DECRBY_CMD, *params)
+
+    def delete(self, key, from_time, to_time):
+        """
+        Delete data points for a given timeseries and interval range
+        in the form of start and end delete timestamps.
+        The given timestamp interval is closed (inclusive), meaning start
+        and end data points will also be deleted.
+        Return the count for deleted items.
+        For more information see
+        `TS.DEL <https://oss.redis.com/redistimeseries/master/commands/#tsdel>`_. # noqa
+
+        Args:
+
+        key:
+            time-series key.
+        from_time:
+            Start timestamp for the range deletion.
+        to_time:
+            End timestamp for the range deletion.
+        """
+        return self.execute_command(DEL_CMD, key, from_time, to_time)
+
+    def createrule(
+        self,
+        source_key,
+        dest_key,
+        aggregation_type,
+        bucket_size_msec
+    ):
+        """
+        Create a compaction rule from values added to `source_key` into `dest_key`.
+        Aggregating for `bucket_size_msec` where an `aggregation_type` can be
+        [`avg`, `sum`, `min`, `max`, `range`, `count`, `first`, `last`,
+        `std.p`, `std.s`, `var.p`, `var.s`]
+        For more information see
+        `TS.CREATERULE <https://oss.redis.com/redistimeseries/master/commands/#tscreaterule>`_. # noqa
+        """
+        params = [source_key, dest_key]
+        self._appendAggregation(params, aggregation_type, bucket_size_msec)
+
+        return self.execute_command(CREATERULE_CMD, *params)
+
+    def deleterule(self, source_key, dest_key):
+        """
+        Delete a compaction rule.
+        For more information see
+        `TS.DELETERULE <https://oss.redis.com/redistimeseries/master/commands/#tsdeleterule>`_. # noqa
+        """
+        return self.execute_command(DELETERULE_CMD, source_key, dest_key)
+
+    def __range_params(
+        self,
+        key,
+        from_time,
+        to_time,
+        count,
+        aggregation_type,
+        bucket_size_msec,
+        filter_by_ts,
+        filter_by_min_value,
+        filter_by_max_value,
+        align,
+    ):
+        """Create TS.RANGE and TS.REVRANGE arguments."""
+        params = [key, from_time, to_time]
+        self._appendFilerByTs(params, filter_by_ts)
+        self._appendFilerByValue(
+            params,
+            filter_by_min_value,
+            filter_by_max_value
+        )
+        self._appendCount(params, count)
+        self._appendAlign(params, align)
+        self._appendAggregation(params, aggregation_type, bucket_size_msec)
+
+        return params
+
+    def range(
+        self,
+        key,
+        from_time,
+        to_time,
+        count=None,
+        aggregation_type=None,
+        bucket_size_msec=0,
+        filter_by_ts=None,
+        filter_by_min_value=None,
+        filter_by_max_value=None,
+        align=None,
+    ):
+        """
+        Query a range in forward direction for a specific time-serie.
+        For more information see
+        `TS.RANGE <https://oss.redis.com/redistimeseries/master/commands/#tsrangetsrevrange>`_. # noqa
+
+        Args:
+
+        key:
+            Key name for timeseries.
+        from_time:
+            Start timestamp for the range query. - can be used to express
+            the minimum possible timestamp (0).
+        to_time:
+            End timestamp for range query, + can be used to express the
+            maximum possible timestamp.
+        count:
+            Optional maximum number of returned results.
+        aggregation_type:
+            Optional aggregation type. Can be one of
+            [`avg`, `sum`, `min`, `max`, `range`, `count`,
+            `first`, `last`, `std.p`, `std.s`, `var.p`, `var.s`]
+        bucket_size_msec:
+            Time bucket for aggregation in milliseconds.
+        filter_by_ts:
+            List of timestamps to filter the result by specific timestamps.
+        filter_by_min_value:
+            Filter result by minimum value (must mention also filter
+            by_max_value).
+        filter_by_max_value:
+            Filter result by maximum value (must mention also filter
+            by_min_value).
+        align:
+            Timestamp for alignment control for aggregation.
+        """
+        params = self.__range_params(
+            key,
+            from_time,
+            to_time,
+            count,
+            aggregation_type,
+            bucket_size_msec,
+            filter_by_ts,
+            filter_by_min_value,
+            filter_by_max_value,
+            align,
+        )
+        return self.execute_command(RANGE_CMD, *params)
+
+    def revrange(
+        self,
+        key,
+        from_time,
+        to_time,
+        count=None,
+        aggregation_type=None,
+        bucket_size_msec=0,
+        filter_by_ts=None,
+        filter_by_min_value=None,
+        filter_by_max_value=None,
+        align=None,
+    ):
+        """
+        Query a range in reverse direction for a specific time-series.
+        For more information see
+        `TS.REVRANGE <https://oss.redis.com/redistimeseries/master/commands/#tsrangetsrevrange>`_.  # noqa
+
+        **Note**: This command is only available since RedisTimeSeries >= v1.4
+
+        Args:
+
+        key:
+            Key name for timeseries.
+        from_time:
+            Start timestamp for the range query. - can be used to express the minimum possible timestamp (0).
+        to_time:
+            End timestamp for range query, + can be used to express the maximum possible timestamp.
+        count:
+            Optional maximum number of returned results.
+        aggregation_type:
+            Optional aggregation type. Can be one of [`avg`, `sum`, `min`, `max`, `range`, `count`,
+            `first`, `last`, `std.p`, `std.s`, `var.p`, `var.s`]
+        bucket_size_msec:
+            Time bucket for aggregation in milliseconds.
+        filter_by_ts:
+            List of timestamps to filter the result by specific timestamps.
+        filter_by_min_value:
+            Filter result by minimum value (must mention also filter_by_max_value).
+        filter_by_max_value:
+            Filter result by maximum value (must mention also filter_by_min_value).
+        align:
+            Timestamp for alignment control for aggregation.
+        """
+        params = self.__range_params(
+            key,
+            from_time,
+            to_time,
+            count,
+            aggregation_type,
+            bucket_size_msec,
+            filter_by_ts,
+            filter_by_min_value,
+            filter_by_max_value,
+            align,
+        )
+        return self.execute_command(REVRANGE_CMD, *params)
+
+    def __mrange_params(
+        self,
+        aggregation_type,
+        bucket_size_msec,
+        count,
+        filters,
+        from_time,
+        to_time,
+        with_labels,
+        filter_by_ts,
+        filter_by_min_value,
+        filter_by_max_value,
+        groupby,
+        reduce,
+        select_labels,
+        align,
+    ):
+        """Create TS.MRANGE and TS.MREVRANGE arguments."""
+        params = [from_time, to_time]
+        self._appendFilerByTs(params, filter_by_ts)
+        self._appendFilerByValue(
+            params,
+            filter_by_min_value,
+            filter_by_max_value
+        )
+        self._appendCount(params, count)
+        self._appendAlign(params, align)
+        self._appendAggregation(params, aggregation_type, bucket_size_msec)
+        self._appendWithLabels(params, with_labels, select_labels)
+        params.extend(["FILTER"])
+        params += filters
+        self._appendGroupbyReduce(params, groupby, reduce)
+        return params
+
+    def mrange(
+        self,
+        from_time,
+        to_time,
+        filters,
+        count=None,
+        aggregation_type=None,
+        bucket_size_msec=0,
+        with_labels=False,
+        filter_by_ts=None,
+        filter_by_min_value=None,
+        filter_by_max_value=None,
+        groupby=None,
+        reduce=None,
+        select_labels=None,
+        align=None,
+    ):
+        """
+        Query a range across multiple time-series by filters in forward direction.
+        For more information see
+        `TS.MRANGE <https://oss.redis.com/redistimeseries/master/commands/#tsmrangetsmrevrange>`_.  # noqa
+
+        Args:
+
+        from_time:
+            Start timestamp for the range query. `-` can be used to
+            express the minimum possible timestamp (0).
+        to_time:
+            End timestamp for range query, `+` can be used to express
+            the maximum possible timestamp.
+        filters:
+            filter to match the time-series labels.
+        count:
+            Optional maximum number of returned results.
+        aggregation_type:
+            Optional aggregation type. Can be one of
+            [`avg`, `sum`, `min`, `max`, `range`, `count`,
+            `first`, `last`, `std.p`, `std.s`, `var.p`, `var.s`]
+        bucket_size_msec:
+            Time bucket for aggregation in milliseconds.
+        with_labels:
+            Include in the reply the label-value pairs that represent metadata
+            labels of the time-series.
+            If this argument is not set, by default, an empty Array will be
+            replied on the labels array position.
+        filter_by_ts:
+            List of timestamps to filter the result by specific timestamps.
+        filter_by_min_value:
+            Filter result by minimum value (must mention also
+            filter_by_max_value).
+        filter_by_max_value:
+            Filter result by maximum value (must mention also
+            filter_by_min_value).
+        groupby:
+            Grouping by fields the results (must mention also reduce).
+        reduce:
+            Applying reducer functions on each group. Can be one
+            of [`sum`, `min`, `max`].
+        select_labels:
+            Include in the reply only a subset of the key-value
+            pair labels of a series.
+        align:
+            Timestamp for alignment control for aggregation.
+        """
+        params = self.__mrange_params(
+            aggregation_type,
+            bucket_size_msec,
+            count,
+            filters,
+            from_time,
+            to_time,
+            with_labels,
+            filter_by_ts,
+            filter_by_min_value,
+            filter_by_max_value,
+            groupby,
+            reduce,
+            select_labels,
+            align,
+        )
+
+        return self.execute_command(MRANGE_CMD, *params)
+
+    def mrevrange(
+        self,
+        from_time,
+        to_time,
+        filters,
+        count=None,
+        aggregation_type=None,
+        bucket_size_msec=0,
+        with_labels=False,
+        filter_by_ts=None,
+        filter_by_min_value=None,
+        filter_by_max_value=None,
+        groupby=None,
+        reduce=None,
+        select_labels=None,
+        align=None,
+    ):
+        """
+        Query a range across multiple time-series by filters in reverse direction.
+        For more information see
+        `TS.MREVRANGE <https://oss.redis.com/redistimeseries/master/commands/#tsmrangetsmrevrange>`_. # noqa
+
+        Args:
+
+        from_time:
+            Start timestamp for the range query. - can be used to express
+            the minimum possible timestamp (0).
+        to_time:
+            End timestamp for range query, + can be used to express
+            the maximum possible timestamp.
+        filters:
+            Filter to match the time-series labels.
+        count:
+            Optional maximum number of returned results.
+        aggregation_type:
+            Optional aggregation type. Can be one of
+            [`avg`, `sum`, `min`, `max`, `range`, `count`,
+            `first`, `last`, `std.p`, `std.s`, `var.p`, `var.s`]
+        bucket_size_msec:
+            Time bucket for aggregation in milliseconds.
+        with_labels:
+            Include in the reply the label-value pairs that represent
+            metadata labels
+            of the time-series.
+            If this argument is not set, by default, an empty Array
+            will be replied
+            on the labels array position.
+        filter_by_ts:
+            List of timestamps to filter the result by specific timestamps.
+        filter_by_min_value:
+            Filter result by minimum value (must mention also filter
+            by_max_value).
+        filter_by_max_value:
+            Filter result by maximum value (must mention also filter
+            by_min_value).
+        groupby:
+            Grouping by fields the results (must mention also reduce).
+        reduce:
+            Applying reducer functions on each group. Can be one
+            of [`sum`, `min`, `max`].
+        select_labels:
+            Include in the reply only a subset of the key-value pair
+            labels of a series.
+        align:
+            Timestamp for alignment control for aggregation.
+        """
+        params = self.__mrange_params(
+            aggregation_type,
+            bucket_size_msec,
+            count,
+            filters,
+            from_time,
+            to_time,
+            with_labels,
+            filter_by_ts,
+            filter_by_min_value,
+            filter_by_max_value,
+            groupby,
+            reduce,
+            select_labels,
+            align,
+        )
+
+        return self.execute_command(MREVRANGE_CMD, *params)
+
+    def get(self, key):
+        """ # noqa
+        Get the last sample of `key`.
+        For more information see `TS.GET <https://oss.redis.com/redistimeseries/master/commands/#tsget>`_.
+        """
+        return self.execute_command(GET_CMD, key)
+
+    def mget(self, filters, with_labels=False):
+        """ # noqa
+        Get the last samples matching the specific `filter`.
+        For more information see `TS.MGET <https://oss.redis.com/redistimeseries/master/commands/#tsmget>`_.
+        """
+        params = []
+        self._appendWithLabels(params, with_labels)
+        params.extend(["FILTER"])
+        params += filters
+        return self.execute_command(MGET_CMD, *params)
+
+    def info(self, key):
+        """  # noqa
+        Get information of `key`.
+        For more information see `TS.INFO <https://oss.redis.com/redistimeseries/master/commands/#tsinfo>`_.
+        """
+        return self.execute_command(INFO_CMD, key)
+
+    def queryindex(self, filters):
+        """  # noqa
+        Get all the keys matching the `filter` list.
+        For more information see `TS.QUERYINDEX <https://oss.redis.com/redistimeseries/master/commands/#tsqueryindex>`_.
+        """
+        return self.execute_command(QUERYINDEX_CMD, *filters)
+
+    @staticmethod
+    def _appendUncompressed(params, uncompressed):
+        """Append UNCOMPRESSED tag to params."""
+        if uncompressed:
+            params.extend(["UNCOMPRESSED"])
+
+    @staticmethod
+    def _appendWithLabels(params, with_labels, select_labels=None):
+        """Append labels behavior to params."""
+        if with_labels and select_labels:
+            raise DataError(
+                "with_labels and select_labels cannot be provided together."
+            )
+
+        if with_labels:
+            params.extend(["WITHLABELS"])
+        if select_labels:
+            params.extend(["SELECTED_LABELS", *select_labels])
+
+    @staticmethod
+    def _appendGroupbyReduce(params, groupby, reduce):
+        """Append GROUPBY REDUCE property to params."""
+        if groupby is not None and reduce is not None:
+            params.extend(["GROUPBY", groupby, "REDUCE", reduce.upper()])
+
+    @staticmethod
+    def _appendRetention(params, retention):
+        """Append RETENTION property to params."""
+        if retention is not None:
+            params.extend(["RETENTION", retention])
+
+    @staticmethod
+    def _appendLabels(params, labels):
+        """Append LABELS property to params."""
+        if labels:
+            params.append("LABELS")
+            for k, v in labels.items():
+                params.extend([k, v])
+
+    @staticmethod
+    def _appendCount(params, count):
+        """Append COUNT property to params."""
+        if count is not None:
+            params.extend(["COUNT", count])
+
+    @staticmethod
+    def _appendTimestamp(params, timestamp):
+        """Append TIMESTAMP property to params."""
+        if timestamp is not None:
+            params.extend(["TIMESTAMP", timestamp])
+
+    @staticmethod
+    def _appendAlign(params, align):
+        """Append ALIGN property to params."""
+        if align is not None:
+            params.extend(["ALIGN", align])
+
+    @staticmethod
+    def _appendAggregation(params, aggregation_type, bucket_size_msec):
+        """Append AGGREGATION property to params."""
+        if aggregation_type is not None:
+            params.append("AGGREGATION")
+            params.extend([aggregation_type, bucket_size_msec])
+
+    @staticmethod
+    def _appendChunkSize(params, chunk_size):
+        """Append CHUNK_SIZE property to params."""
+        if chunk_size is not None:
+            params.extend(["CHUNK_SIZE", chunk_size])
+
+    @staticmethod
+    def _appendDuplicatePolicy(params, command, duplicate_policy):
+        """Append DUPLICATE_POLICY property to params on CREATE
+        and ON_DUPLICATE on ADD.
+        """
+        if duplicate_policy is not None:
+            if command == "TS.ADD":
+                params.extend(["ON_DUPLICATE", duplicate_policy])
+            else:
+                params.extend(["DUPLICATE_POLICY", duplicate_policy])
+
+    @staticmethod
+    def _appendFilerByTs(params, ts_list):
+        """Append FILTER_BY_TS property to params."""
+        if ts_list is not None:
+            params.extend(["FILTER_BY_TS", *ts_list])
+
+    @staticmethod
+    def _appendFilerByValue(params, min_value, max_value):
+        """Append FILTER_BY_VALUE property to params."""
+        if min_value is not None and max_value is not None:
+            params.extend(["FILTER_BY_VALUE", min_value, max_value])
diff --git a/redis/commands/timeseries/info.py b/redis/commands/timeseries/info.py
new file mode 100644
index 0000000000..3b89503f18
--- /dev/null
+++ b/redis/commands/timeseries/info.py
@@ -0,0 +1,82 @@
+from .utils import list_to_dict
+from ..helpers import nativestr
+
+
+class TSInfo(object):
+    """
+    Hold information and statistics on the time-series.
+    Can be created using ``tsinfo`` command
+    https://oss.redis.com/redistimeseries/commands/#tsinfo.
+    """
+
+    rules = []
+    labels = []
+    sourceKey = None
+    chunk_count = None
+    memory_usage = None
+    total_samples = None
+    retention_msecs = None
+    last_time_stamp = None
+    first_time_stamp = None
+
+    max_samples_per_chunk = None
+    chunk_size = None
+    duplicate_policy = None
+
+    def __init__(self, args):
+        """
+        Hold information and statistics on the time-series.
+
+        The supported params that can be passed as args:
+
+        rules:
+            A list of compaction rules of the time series.
+        sourceKey:
+            Key name for source time series in case the current series
+            is a target of a rule.
+        chunkCount:
+            Number of Memory Chunks used for the time series.
+        memoryUsage:
+            Total number of bytes allocated for the time series.
+        totalSamples:
+            Total number of samples in the time series.
+        labels:
+            A list of label-value pairs that represent the metadata
+            labels of the time series.
+        retentionTime:
+            Retention time, in milliseconds, for the time series.
+        lastTimestamp:
+            Last timestamp present in the time series.
+        firstTimestamp:
+            First timestamp present in the time series.
+        maxSamplesPerChunk:
+            Deprecated.
+        chunkSize:
+            Amount of memory, in bytes, allocated for data.
+        duplicatePolicy:
+            Policy that will define handling of duplicate samples.
+
+        Can read more about on
+        https://oss.redis.com/redistimeseries/configuration/#duplicate_policy
+        """
+        response = dict(zip(map(nativestr, args[::2]), args[1::2]))
+        self.rules = response["rules"]
+        self.source_key = response["sourceKey"]
+        self.chunk_count = response["chunkCount"]
+        self.memory_usage = response["memoryUsage"]
+        self.total_samples = response["totalSamples"]
+        self.labels = list_to_dict(response["labels"])
+        self.retention_msecs = response["retentionTime"]
+        self.lastTimeStamp = response["lastTimestamp"]
+        self.first_time_stamp = response["firstTimestamp"]
+        if "maxSamplesPerChunk" in response:
+            self.max_samples_per_chunk = response["maxSamplesPerChunk"]
+            self.chunk_size = (
+                self.max_samples_per_chunk * 16
+            )  # backward compatible changes
+        if "chunkSize" in response:
+            self.chunk_size = response["chunkSize"]
+        if "duplicatePolicy" in response:
+            self.duplicate_policy = response["duplicatePolicy"]
+            if type(self.duplicate_policy) == bytes:
+                self.duplicate_policy = self.duplicate_policy.decode()
diff --git a/redis/commands/timeseries/utils.py b/redis/commands/timeseries/utils.py
new file mode 100644
index 0000000000..c33b7c591e
--- /dev/null
+++ b/redis/commands/timeseries/utils.py
@@ -0,0 +1,49 @@
+from ..helpers import nativestr
+
+
+def list_to_dict(aList):
+    return {
+        nativestr(aList[i][0]): nativestr(aList[i][1])
+        for i in range(len(aList))}
+
+
+def parse_range(response):
+    """Parse range response. Used by TS.RANGE and TS.REVRANGE."""
+    return [tuple((r[0], float(r[1]))) for r in response]
+
+
+def parse_m_range(response):
+    """Parse multi range response. Used by TS.MRANGE and TS.MREVRANGE."""
+    res = []
+    for item in response:
+        res.append(
+            {nativestr(item[0]):
+                [list_to_dict(item[1]), parse_range(item[2])]})
+    return sorted(res, key=lambda d: list(d.keys()))
+
+
+def parse_get(response):
+    """Parse get response. Used by TS.GET."""
+    if not response:
+        return None
+    return int(response[0]), float(response[1])
+
+
+def parse_m_get(response):
+    """Parse multi get response. Used by TS.MGET."""
+    res = []
+    for item in response:
+        if not item[2]:
+            res.append(
+                {nativestr(item[0]): [list_to_dict(item[1]), None, None]})
+        else:
+            res.append(
+                {
+                    nativestr(item[0]): [
+                        list_to_dict(item[1]),
+                        int(item[2][0]),
+                        float(item[2][1]),
+                    ]
+                }
+            )
+    return sorted(res, key=lambda d: list(d.keys()))
diff --git a/setup.py b/setup.py
index 9788d2ed96..d0c81b40dd 100644
--- a/setup.py
+++ b/setup.py
@@ -16,6 +16,7 @@
             "redis.commands",
             "redis.commands.json",
             "redis.commands.search",
+            "redis.commands.timeseries",
         ]
     ),
     url="https://github.com/redis/redis-py",
diff --git a/tests/test_timeseries.py b/tests/test_timeseries.py
new file mode 100644
index 0000000000..b2df3feda5
--- /dev/null
+++ b/tests/test_timeseries.py
@@ -0,0 +1,593 @@
+import pytest
+import time
+from time import sleep
+from .conftest import skip_ifmodversion_lt
+
+
+@pytest.fixture
+def client(modclient):
+    modclient.flushdb()
+    return modclient
+
+
+@pytest.mark.redismod
+def testCreate(client):
+    assert client.ts().create(1)
+    assert client.ts().create(2, retention_msecs=5)
+    assert client.ts().create(3, labels={"Redis": "Labs"})
+    assert client.ts().create(4, retention_msecs=20, labels={"Time": "Series"})
+    info = client.ts().info(4)
+    assert 20 == info.retention_msecs
+    assert "Series" == info.labels["Time"]
+
+    # Test for a chunk size of 128 Bytes
+    assert client.ts().create("time-serie-1", chunk_size=128)
+    info = client.ts().info("time-serie-1")
+    assert 128, info.chunk_size
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("1.4.0", "timeseries")
+def testCreateDuplicatePolicy(client):
+    # Test for duplicate policy
+    for duplicate_policy in ["block", "last", "first", "min", "max"]:
+        ts_name = "time-serie-ooo-{0}".format(duplicate_policy)
+        assert client.ts().create(ts_name, duplicate_policy=duplicate_policy)
+        info = client.ts().info(ts_name)
+        assert duplicate_policy == info.duplicate_policy
+
+
+@pytest.mark.redismod
+def testAlter(client):
+    assert client.ts().create(1)
+    assert 0 == client.ts().info(1).retention_msecs
+    assert client.ts().alter(1, retention_msecs=10)
+    assert {} == client.ts().info(1).labels
+    assert 10, client.ts().info(1).retention_msecs
+    assert client.ts().alter(1, labels={"Time": "Series"})
+    assert "Series" == client.ts().info(1).labels["Time"]
+    assert 10 == client.ts().info(1).retention_msecs
+
+
+#     pipe = client.ts().pipeline()
+# assert pipe.create(2)
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("1.4.0", "timeseries")
+def testAlterDiplicatePolicy(client):
+    assert client.ts().create(1)
+    info = client.ts().info(1)
+    assert info.duplicate_policy is None
+    assert client.ts().alter(1, duplicate_policy="min")
+    info = client.ts().info(1)
+    assert "min" == info.duplicate_policy
+
+
+@pytest.mark.redismod
+def testAdd(client):
+    assert 1 == client.ts().add(1, 1, 1)
+    assert 2 == client.ts().add(2, 2, 3, retention_msecs=10)
+    assert 3 == client.ts().add(3, 3, 2, labels={"Redis": "Labs"})
+    assert 4 == client.ts().add(
+        4, 4, 2, retention_msecs=10, labels={"Redis": "Labs", "Time": "Series"}
+    )
+    assert round(time.time()) == \
+        round(float(client.ts().add(5, "*", 1)) / 1000)
+
+    info = client.ts().info(4)
+    assert 10 == info.retention_msecs
+    assert "Labs" == info.labels["Redis"]
+
+    # Test for a chunk size of 128 Bytes on TS.ADD
+    assert client.ts().add("time-serie-1", 1, 10.0, chunk_size=128)
+    info = client.ts().info("time-serie-1")
+    assert 128 == info.chunk_size
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("1.4.0", "timeseries")
+def testAddDuplicatePolicy(client):
+
+    # Test for duplicate policy BLOCK
+    assert 1 == client.ts().add("time-serie-add-ooo-block", 1, 5.0)
+    with pytest.raises(Exception):
+        client.ts().add(
+            "time-serie-add-ooo-block",
+            1,
+            5.0,
+            duplicate_policy="block"
+        )
+
+    # Test for duplicate policy LAST
+    assert 1 == client.ts().add("time-serie-add-ooo-last", 1, 5.0)
+    assert 1 == client.ts().add(
+        "time-serie-add-ooo-last", 1, 10.0, duplicate_policy="last"
+    )
+    assert 10.0 == client.ts().get("time-serie-add-ooo-last")[1]
+
+    # Test for duplicate policy FIRST
+    assert 1 == client.ts().add("time-serie-add-ooo-first", 1, 5.0)
+    assert 1 == client.ts().add(
+        "time-serie-add-ooo-first", 1, 10.0, duplicate_policy="first"
+    )
+    assert 5.0 == client.ts().get("time-serie-add-ooo-first")[1]
+
+    # Test for duplicate policy MAX
+    assert 1 == client.ts().add("time-serie-add-ooo-max", 1, 5.0)
+    assert 1 == client.ts().add(
+        "time-serie-add-ooo-max", 1, 10.0, duplicate_policy="max"
+    )
+    assert 10.0 == client.ts().get("time-serie-add-ooo-max")[1]
+
+    # Test for duplicate policy MIN
+    assert 1 == client.ts().add("time-serie-add-ooo-min", 1, 5.0)
+    assert 1 == client.ts().add(
+        "time-serie-add-ooo-min", 1, 10.0, duplicate_policy="min"
+    )
+    assert 5.0 == client.ts().get("time-serie-add-ooo-min")[1]
+
+
+@pytest.mark.redismod
+def testMAdd(client):
+    client.ts().create("a")
+    assert [1, 2, 3] == \
+        client.ts().madd([("a", 1, 5), ("a", 2, 10), ("a", 3, 15)])
+
+
+@pytest.mark.redismod
+def testIncrbyDecrby(client):
+    for _ in range(100):
+        assert client.ts().incrby(1, 1)
+        sleep(0.001)
+    assert 100 == client.ts().get(1)[1]
+    for _ in range(100):
+        assert client.ts().decrby(1, 1)
+        sleep(0.001)
+    assert 0 == client.ts().get(1)[1]
+
+    assert client.ts().incrby(2, 1.5, timestamp=5)
+    assert (5, 1.5) == client.ts().get(2)
+    assert client.ts().incrby(2, 2.25, timestamp=7)
+    assert (7, 3.75) == client.ts().get(2)
+    assert client.ts().decrby(2, 1.5, timestamp=15)
+    assert (15, 2.25) == client.ts().get(2)
+
+    # Test for a chunk size of 128 Bytes on TS.INCRBY
+    assert client.ts().incrby("time-serie-1", 10, chunk_size=128)
+    info = client.ts().info("time-serie-1")
+    assert 128 == info.chunk_size
+
+    # Test for a chunk size of 128 Bytes on TS.DECRBY
+    assert client.ts().decrby("time-serie-2", 10, chunk_size=128)
+    info = client.ts().info("time-serie-2")
+    assert 128 == info.chunk_size
+
+
+@pytest.mark.redismod
+def testCreateAndDeleteRule(client):
+    # test rule creation
+    time = 100
+    client.ts().create(1)
+    client.ts().create(2)
+    client.ts().createrule(1, 2, "avg", 100)
+    for i in range(50):
+        client.ts().add(1, time + i * 2, 1)
+        client.ts().add(1, time + i * 2 + 1, 2)
+    client.ts().add(1, time * 2, 1.5)
+    assert round(client.ts().get(2)[1], 5) == 1.5
+    info = client.ts().info(1)
+    assert info.rules[0][1] == 100
+
+    # test rule deletion
+    client.ts().deleterule(1, 2)
+    info = client.ts().info(1)
+    assert not info.rules
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("99.99.99", "timeseries")
+def testDelRange(client):
+    try:
+        client.ts().delete("test", 0, 100)
+    except Exception as e:
+        assert e.__str__() != ""
+
+    for i in range(100):
+        client.ts().add(1, i, i % 7)
+    assert 22 == client.ts().delete(1, 0, 21)
+    assert [] == client.ts().range(1, 0, 21)
+    assert [(22, 1.0)] == client.ts().range(1, 22, 22)
+
+
+@pytest.mark.redismod
+def testRange(client):
+    for i in range(100):
+        client.ts().add(1, i, i % 7)
+    assert 100 == len(client.ts().range(1, 0, 200))
+    for i in range(100):
+        client.ts().add(1, i + 200, i % 7)
+    assert 200 == len(client.ts().range(1, 0, 500))
+    # last sample isn't returned
+    assert 20 == len(
+        client.ts().range(
+            1,
+            0,
+            500,
+            aggregation_type="avg",
+            bucket_size_msec=10
+        )
+    )
+    assert 10 == len(client.ts().range(1, 0, 500, count=10))
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("99.99.99", "timeseries")
+def testRangeAdvanced(client):
+    for i in range(100):
+        client.ts().add(1, i, i % 7)
+        client.ts().add(1, i + 200, i % 7)
+
+    assert 2 == len(
+        client.ts().range(
+            1,
+            0,
+            500,
+            filter_by_ts=[i for i in range(10, 20)],
+            filter_by_min_value=1,
+            filter_by_max_value=2,
+        )
+    )
+    assert [(0, 10.0), (10, 1.0)] == client.ts().range(
+        1, 0, 10, aggregation_type="count", bucket_size_msec=10, align="+"
+    )
+    assert [(-5, 5.0), (5, 6.0)] == client.ts().range(
+        1, 0, 10, aggregation_type="count", bucket_size_msec=10, align=5
+    )
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("99.99.99", "timeseries")
+def testRevRange(client):
+    for i in range(100):
+        client.ts().add(1, i, i % 7)
+    assert 100 == len(client.ts().range(1, 0, 200))
+    for i in range(100):
+        client.ts().add(1, i + 200, i % 7)
+    assert 200 == len(client.ts().range(1, 0, 500))
+    # first sample isn't returned
+    assert 20 == len(
+        client.ts().revrange(
+            1,
+            0,
+            500,
+            aggregation_type="avg",
+            bucket_size_msec=10
+        )
+    )
+    assert 10 == len(client.ts().revrange(1, 0, 500, count=10))
+    assert 2 == len(
+        client.ts().revrange(
+            1,
+            0,
+            500,
+            filter_by_ts=[i for i in range(10, 20)],
+            filter_by_min_value=1,
+            filter_by_max_value=2,
+        )
+    )
+    assert [(10, 1.0), (0, 10.0)] == client.ts().revrange(
+        1, 0, 10, aggregation_type="count", bucket_size_msec=10, align="+"
+    )
+    assert [(1, 10.0), (-9, 1.0)] == client.ts().revrange(
+        1, 0, 10, aggregation_type="count", bucket_size_msec=10, align=1
+    )
+
+
+@pytest.mark.redismod
+def testMultiRange(client):
+    client.ts().create(1, labels={"Test": "This", "team": "ny"})
+    client.ts().create(
+        2,
+        labels={"Test": "This", "Taste": "That", "team": "sf"}
+    )
+    for i in range(100):
+        client.ts().add(1, i, i % 7)
+        client.ts().add(2, i, i % 11)
+
+    res = client.ts().mrange(0, 200, filters=["Test=This"])
+    assert 2 == len(res)
+    assert 100 == len(res[0]["1"][1])
+
+    res = client.ts().mrange(0, 200, filters=["Test=This"], count=10)
+    assert 10 == len(res[0]["1"][1])
+
+    for i in range(100):
+        client.ts().add(1, i + 200, i % 7)
+    res = client.ts().mrange(
+        0,
+        500,
+        filters=["Test=This"],
+        aggregation_type="avg",
+        bucket_size_msec=10
+    )
+    assert 2 == len(res)
+    assert 20 == len(res[0]["1"][1])
+
+    # test withlabels
+    assert {} == res[0]["1"][0]
+    res = client.ts().mrange(0, 200, filters=["Test=This"], with_labels=True)
+    assert {"Test": "This", "team": "ny"} == res[0]["1"][0]
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("99.99.99", "timeseries")
+def testMultiRangeAdvanced(client):
+    client.ts().create(1, labels={"Test": "This", "team": "ny"})
+    client.ts().create(
+        2,
+        labels={"Test": "This", "Taste": "That", "team": "sf"}
+    )
+    for i in range(100):
+        client.ts().add(1, i, i % 7)
+        client.ts().add(2, i, i % 11)
+
+    # test with selected labels
+    res = client.ts().mrange(
+        0,
+        200,
+        filters=["Test=This"],
+        select_labels=["team"]
+    )
+    assert {"team": "ny"} == res[0]["1"][0]
+    assert {"team": "sf"} == res[1]["2"][0]
+
+    # test with filterby
+    res = client.ts().mrange(
+        0,
+        200,
+        filters=["Test=This"],
+        filter_by_ts=[i for i in range(10, 20)],
+        filter_by_min_value=1,
+        filter_by_max_value=2,
+    )
+    assert [(15, 1.0), (16, 2.0)] == res[0]["1"][1]
+
+    # test groupby
+    res = client.ts().mrange(
+        0,
+        3,
+        filters=["Test=This"],
+        groupby="Test",
+        reduce="sum"
+    )
+    assert [(0, 0.0), (1, 2.0), (2, 4.0), (3, 6.0)] == res[0]["Test=This"][1]
+    res = client.ts().mrange(
+        0,
+        3,
+        filters=["Test=This"],
+        groupby="Test",
+        reduce="max"
+    )
+    assert [(0, 0.0), (1, 1.0), (2, 2.0), (3, 3.0)] == res[0]["Test=This"][1]
+    res = client.ts().mrange(
+        0,
+        3,
+        filters=["Test=This"],
+        groupby="team",
+        reduce="min")
+    assert 2 == len(res)
+    assert [(0, 0.0), (1, 1.0), (2, 2.0), (3, 3.0)] == res[0]["team=ny"][1]
+    assert [(0, 0.0), (1, 1.0), (2, 2.0), (3, 3.0)] == res[1]["team=sf"][1]
+
+    # test align
+    res = client.ts().mrange(
+        0,
+        10,
+        filters=["team=ny"],
+        aggregation_type="count",
+        bucket_size_msec=10,
+        align="-",
+    )
+    assert [(0, 10.0), (10, 1.0)] == res[0]["1"][1]
+    res = client.ts().mrange(
+        0,
+        10,
+        filters=["team=ny"],
+        aggregation_type="count",
+        bucket_size_msec=10,
+        align=5,
+    )
+    assert [(-5, 5.0), (5, 6.0)] == res[0]["1"][1]
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("99.99.99", "timeseries")
+def testMultiReverseRange(client):
+    client.ts().create(1, labels={"Test": "This", "team": "ny"})
+    client.ts().create(
+        2,
+        labels={"Test": "This", "Taste": "That", "team": "sf"}
+    )
+    for i in range(100):
+        client.ts().add(1, i, i % 7)
+        client.ts().add(2, i, i % 11)
+
+    res = client.ts().mrange(0, 200, filters=["Test=This"])
+    assert 2 == len(res)
+    assert 100 == len(res[0]["1"][1])
+
+    res = client.ts().mrange(0, 200, filters=["Test=This"], count=10)
+    assert 10 == len(res[0]["1"][1])
+
+    for i in range(100):
+        client.ts().add(1, i + 200, i % 7)
+    res = client.ts().mrevrange(
+        0,
+        500,
+        filters=["Test=This"],
+        aggregation_type="avg",
+        bucket_size_msec=10
+    )
+    assert 2 == len(res)
+    assert 20 == len(res[0]["1"][1])
+    assert {} == res[0]["1"][0]
+
+    # test withlabels
+    res = client.ts().mrevrange(
+        0,
+        200,
+        filters=["Test=This"],
+        with_labels=True
+    )
+    assert {"Test": "This", "team": "ny"} == res[0]["1"][0]
+
+    # test with selected labels
+    res = client.ts().mrevrange(
+        0,
+        200,
+        filters=["Test=This"], select_labels=["team"]
+    )
+    assert {"team": "ny"} == res[0]["1"][0]
+    assert {"team": "sf"} == res[1]["2"][0]
+
+    # test filterby
+    res = client.ts().mrevrange(
+        0,
+        200,
+        filters=["Test=This"],
+        filter_by_ts=[i for i in range(10, 20)],
+        filter_by_min_value=1,
+        filter_by_max_value=2,
+    )
+    assert [(16, 2.0), (15, 1.0)] == res[0]["1"][1]
+
+    # test groupby
+    res = client.ts().mrevrange(
+        0, 3, filters=["Test=This"], groupby="Test", reduce="sum"
+    )
+    assert [(3, 6.0), (2, 4.0), (1, 2.0), (0, 0.0)] == res[0]["Test=This"][1]
+    res = client.ts().mrevrange(
+        0, 3, filters=["Test=This"], groupby="Test", reduce="max"
+    )
+    assert [(3, 3.0), (2, 2.0), (1, 1.0), (0, 0.0)] == res[0]["Test=This"][1]
+    res = client.ts().mrevrange(
+        0, 3, filters=["Test=This"], groupby="team", reduce="min"
+    )
+    assert 2 == len(res)
+    assert [(3, 3.0), (2, 2.0), (1, 1.0), (0, 0.0)] == res[0]["team=ny"][1]
+    assert [(3, 3.0), (2, 2.0), (1, 1.0), (0, 0.0)] == res[1]["team=sf"][1]
+
+    # test align
+    res = client.ts().mrevrange(
+        0,
+        10,
+        filters=["team=ny"],
+        aggregation_type="count",
+        bucket_size_msec=10,
+        align="-",
+    )
+    assert [(10, 1.0), (0, 10.0)] == res[0]["1"][1]
+    res = client.ts().mrevrange(
+        0,
+        10,
+        filters=["team=ny"],
+        aggregation_type="count",
+        bucket_size_msec=10,
+        align=1,
+    )
+    assert [(1, 10.0), (-9, 1.0)] == res[0]["1"][1]
+
+
+@pytest.mark.redismod
+def testGet(client):
+    name = "test"
+    client.ts().create(name)
+    assert client.ts().get(name) is None
+    client.ts().add(name, 2, 3)
+    assert 2 == client.ts().get(name)[0]
+    client.ts().add(name, 3, 4)
+    assert 4 == client.ts().get(name)[1]
+
+
+@pytest.mark.redismod
+def testMGet(client):
+    client.ts().create(1, labels={"Test": "This"})
+    client.ts().create(2, labels={"Test": "This", "Taste": "That"})
+    act_res = client.ts().mget(["Test=This"])
+    exp_res = [{"1": [{}, None, None]}, {"2": [{}, None, None]}]
+    assert act_res == exp_res
+    client.ts().add(1, "*", 15)
+    client.ts().add(2, "*", 25)
+    res = client.ts().mget(["Test=This"])
+    assert 15 == res[0]["1"][2]
+    assert 25 == res[1]["2"][2]
+    res = client.ts().mget(["Taste=That"])
+    assert 25 == res[0]["2"][2]
+
+    # test with_labels
+    assert {} == res[0]["2"][0]
+    res = client.ts().mget(["Taste=That"], with_labels=True)
+    assert {"Taste": "That", "Test": "This"} == res[0]["2"][0]
+
+
+@pytest.mark.redismod
+def testInfo(client):
+    client.ts().create(
+        1,
+        retention_msecs=5,
+        labels={"currentLabel": "currentData"}
+    )
+    info = client.ts().info(1)
+    assert 5 == info.retention_msecs
+    assert info.labels["currentLabel"] == "currentData"
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("1.4.0", "timeseries")
+def testInfoDuplicatePolicy(client):
+    client.ts().create(
+        1,
+        retention_msecs=5,
+        labels={"currentLabel": "currentData"}
+    )
+    info = client.ts().info(1)
+    assert info.duplicate_policy is None
+
+    client.ts().create("time-serie-2", duplicate_policy="min")
+    info = client.ts().info("time-serie-2")
+    assert "min" == info.duplicate_policy
+
+
+@pytest.mark.redismod
+def testQueryIndex(client):
+    client.ts().create(1, labels={"Test": "This"})
+    client.ts().create(2, labels={"Test": "This", "Taste": "That"})
+    assert 2 == len(client.ts().queryindex(["Test=This"]))
+    assert 1 == len(client.ts().queryindex(["Taste=That"]))
+    assert [2] == client.ts().queryindex(["Taste=That"])
+
+
+#
+# @pytest.mark.redismod
+# @pytest.mark.pipeline
+# def testPipeline(client):
+#     pipeline = client.ts().pipeline()
+#     pipeline.create("with_pipeline")
+#     for i in range(100):
+#         pipeline.add("with_pipeline", i, 1.1 * i)
+#     pipeline.execute()
+
+#     info = client.ts().info("with_pipeline")
+#     assert info.lastTimeStamp == 99
+#     assert info.total_samples == 100
+#     assert client.ts().get("with_pipeline")[1] == 99 * 1.1
+
+
+@pytest.mark.redismod
+def testUncompressed(client):
+    client.ts().create("compressed")
+    client.ts().create("uncompressed", uncompressed=True)
+    compressed_info = client.ts().info("compressed")
+    uncompressed_info = client.ts().info("uncompressed")
+    assert compressed_info.memory_usage != uncompressed_info.memory_usage

From d8adb8af45248ad4597f47ac871ce69990022046 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 28 Oct 2021 12:45:35 +0300
Subject: [PATCH 0221/1164] starting to clean the docs (#1657)

---
 CONTRIBUTING.md |  22 ++--
 README.md       | 328 +++++++++++++++++++++++-------------------------
 2 files changed, 171 insertions(+), 179 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 31170f3718..af067e7fdf 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -10,7 +10,7 @@ community contributions!
 You may already know what you want to contribute \-- a fix for a bug you
 encountered, or a new feature your team wants to use.
 
-If you don\'t know what to contribute, keep an open mind! Improving
+If you don't know what to contribute, keep an open mind! Improving
 documentation, bug triaging, and writing tutorials are all examples of
 helpful contributions that mean less work for you.
 
@@ -28,7 +28,7 @@ tutorials:
 
 ## Getting Started
 
-Here\'s how to get started with your code contribution:
+Here's how to get started with your code contribution:
 
 1.  Create your own fork of redis-py
 2.  Do the changes in your fork
@@ -134,19 +134,19 @@ Please try at least versions of Docker.
 ### Security Vulnerabilities
 
 **NOTE**: If you find a security vulnerability, do NOT open an issue.
-Email Andy McCurdy (<sedrik@gmail.com>) instead.
+Email [Redis Open Source (<oss@redis.com>)](mailto:oss@redis.com) instead.
 
 In order to determine whether you are dealing with a security issue, ask
 yourself these two questions:
 
--   Can I access something that\'s not mine, or something I shouldn\'t
+-   Can I access something that's not mine, or something I shouldn't
     have access to?
 -   Can I disable something for other people?
 
-If the answer to either of those two questions are \"yes\", then you\'re
+If the answer to either of those two questions are *yes*, then you're
 probably dealing with a security issue. Note that even if you answer
-\"no\" to both questions, you may still be dealing with a security
-issue, so if you\'re unsure, just email Andy at <sedrik@gmail.com>.
+*no*  to both questions, you may still be dealing with a security
+issue, so if you're unsure, just email [us](mailto:oss@redis.com).
 
 ### Everything Else
 
@@ -160,17 +160,17 @@ When filing an issue, make sure to answer these five questions:
 
 ## How to Suggest a Feature or Enhancement
 
-If you\'d like to contribute a new feature, make sure you check our
+If you'd like to contribute a new feature, make sure you check our
 issue list to see if someone has already proposed it. Work may already
-be under way on the feature you want \-- or we may have rejected a
+be under way on the feature you want -- or we may have rejected a
 feature like it already.
 
-If you don\'t see anything, open a new issue that describes the feature
+If you don't see anything, open a new issue that describes the feature
 you would like and how it should work.
 
 ## Code Review Process
 
 The core team looks at Pull Requests on a regular basis. We will give
 feedback as as soon as possible. After feedback, we expect a response
-within two weeks. After that time, we may close your PR if it isn\'t
+within two weeks. After that time, we may close your PR if it isn't
 showing any activity.
diff --git a/README.md b/README.md
index 4bcea7be33..a01f820326 100644
--- a/README.md
+++ b/README.md
@@ -4,21 +4,19 @@ The Python interface to the Redis key-value store.
 
 [![CI](https://github.com/redis/redis-py/workflows/CI/badge.svg?branch=master)](https://github.com/redis/redis-py/actions?query=workflow%3ACI+branch%3Amaster) 
 [![docs](https://readthedocs.org/projects/redis-py/badge/?version=stable&style=flat)](https://redis-py.readthedocs.io/en/stable/) 
+[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE.txt)
 [![pypi](https://badge.fury.io/py/redis.svg)](https://pypi.org/project/redis/) 
 [![codecov](https://codecov.io/gh/redis/redis-py/branch/master/graph/badge.svg?token=yenl5fzxxr)](https://codecov.io/gh/redis/redis-py)
 [![Total alerts](https://img.shields.io/lgtm/alerts/g/redis/redis-py.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/redis/redis-py/alerts/)
 
+[Installation](##installation) | [Contributing](##contributing) |  [Getting Started](##getting-started) | [Connecting To Redis](##connecting-to-redis)
 
-## Python 2 Compatibility Note
+---------------------------------------------
 
-redis-py 3.5.x will be the last version of redis-py that supports Python
-2. The 3.5.x line will continue to get bug fixes and security patches
-that support Python 2 until August 1, 2020. redis-py 4.0 will be the
-next major version and will require Python 3.5+.
 
 ## Installation
 
-redis-py requires a running Redis server. See [Redis\'s
+redis-py requires a running Redis server. See [Redis's
 quickstart](https://redis.io/topics/quickstart) for installation
 instructions.
 
@@ -45,12 +43,14 @@ $ python setup.py install
 
 ## Contributing
 
-Want to contribute a feature, bug report, or report an issue? Check out
+Want to contribute a feature, bug fix, or report an issue? Check out
 our [guide to
-contributing](https://github.com/redis/redis-py/blob/master/CONTRIBUTING.rst).
+contributing](https://github.com/redis/redis-py/blob/master/CONTRIBUTING.md).
 
 ## Getting Started
 
+redis-py supports Python 3.6+.
+
 ``` pycon
 >>> import redis
 >>> r = redis.Redis(host='localhost', port=6379, db=0)
@@ -61,118 +61,26 @@ b'bar'
 ```
 
 By default, all responses are returned as bytes in Python
-3 and str in Python 2. The user is responsible for
-decoding to Python 3 strings or Python 2 unicode objects.
+3.
 
 If **all** string responses from a client should be decoded, the user
-can specify decode_responses=True to
-Redis.\_\_init\_\_. In this case, any Redis command that
+can specify *decode_responses=True* in
+```Redis.__init__```. In this case, any Redis command that
 returns a string type will be decoded with the encoding
 specified.
 
-The default encoding is \"utf-8\", but this can be customized with the
-encoding argument to the redis.Redis class.
+The default encoding is utf-8, but this can be customized by specifiying the
+encoding argument for the redis.Redis class.
 The encoding will be used to automatically encode any
-strings passed to commands, such as key names and values. When
-decode_responses=True, string data returned from commands
-will be decoded with the same encoding.
-
-## Upgrading from redis-py 2.X to 3.0
-
-redis-py 3.0 introduces many new features but required a number of
-backwards incompatible changes to be made in the process. This section
-attempts to provide an upgrade path for users migrating from 2.X to 3.0.
-
-### Python Version Support
-
-redis-py supports Python 3.5+.
-
-### Client Classes: Redis and StrictRedis
-
-redis-py 3.0 drops support for the legacy \"Redis\" client class.
-\"StrictRedis\" has been renamed to \"Redis\" and an alias named
-\"StrictRedis\" is provided so that users previously using
-\"StrictRedis\" can continue to run unchanged.
-
-The 2.X \"Redis\" class provided alternative implementations of a few
-commands. This confused users (rightfully so) and caused a number of
-support issues. To make things easier going forward, it was decided to
-drop support for these alternate implementations and instead focus on a
-single client class.
-
-2.X users that are already using StrictRedis don\'t have to change the
-class name. StrictRedis will continue to work for the foreseeable
-future.
-
-2.X users that are using the Redis class will have to make changes if
-they use any of the following commands:
-
--   SETEX: The argument order has changed. The new order is (name, time,
-    value).
--   LREM: The argument order has changed. The new order is (name, num,
-    value).
--   TTL and PTTL: The return value is now always an int and matches the
-    official Redis command (>0 indicates the timeout, -1 indicates that
-    the key exists but that it has no expire time set, -2 indicates that
-    the key does not exist)
-
-### SSL Connections
-
-redis-py 3.0 changes the default value of the
-ssl_cert_reqs option from None to
-\'required\'. See [Issue
-1016](https://github.com/redis/redis-py/issues/1016). This change
-enforces hostname validation when accepting a cert from a remote SSL
-terminator. If the terminator doesn\'t properly set the hostname on the
-cert this will cause redis-py 3.0 to raise a ConnectionError.
-
-This check can be disabled by setting ssl_cert_reqs to
-None. Note that doing so removes the security check. Do so
-at your own risk.
-
-Example with hostname verification using a local certificate bundle
-(linux):
-
-``` pycon
->>> import redis
->>> r = redis.Redis(host='xxxxxx.cache.amazonaws.com', port=6379, db=0,
-                    ssl=True,
-                    ssl_ca_certs='/etc/ssl/certs/ca-certificates.crt')
->>> r.set('foo', 'bar')
-True
->>> r.get('foo')
-b'bar'
-```
-
-Example with hostname verification using
-[certifi](https://pypi.org/project/certifi/):
-
-``` pycon
->>> import redis, certifi
->>> r = redis.Redis(host='xxxxxx.cache.amazonaws.com', port=6379, db=0,
-                    ssl=True, ssl_ca_certs=certifi.where())
->>> r.set('foo', 'bar')
-True
->>> r.get('foo')
-b'bar'
-```
+strings passed to commands, such as key names and values. 
 
-Example turning off hostname verification (not recommended):
 
-``` pycon
->>> import redis
->>> r = redis.Redis(host='xxxxxx.cache.amazonaws.com', port=6379, db=0,
-                    ssl=True, ssl_cert_reqs=None)
->>> r.set('foo', 'bar')
-True
->>> r.get('foo')
-b'bar'
-```
+--------------------
 
 ### MSET, MSETNX and ZADD
 
 These commands all accept a mapping of key/value pairs. In redis-py 2.X
-this mapping could be specified as `*args` or as `**kwargs`. Both of
+this mapping could be specified as **args* or as `**kwargs`. Both of
 these styles caused issues when Redis introduced optional flags to ZADD.
 Relying on `*args` caused issues with the optional argument order,
 especially in Python 2.7. Relying on `**kwargs` caused potential
@@ -229,8 +137,8 @@ supports the Lua-based lock. In doing so, LuaLock has been renamed to
 Lock. This also means that redis-py Lock objects require Redis server
 2.6 or greater.
 
-2.X users that were explicitly referring to \"LuaLock\" will have to now
-refer to \"Lock\" instead.
+2.X users that were explicitly referring to *LuaLock* will have to now
+refer to *Lock* instead.
 
 ### Locks as Context Managers
 
@@ -240,7 +148,7 @@ This is more of a bug fix than a backwards incompatible change. However,
 given an error is now raised where none was before, this might alarm
 some users.
 
-2.X users should make sure they\'re wrapping their lock code in a
+2.X users should make sure they're wrapping their lock code in a
 try/catch like this:
 
 ``` python
@@ -259,8 +167,8 @@ to adhere to the official command syntax. There are a few exceptions:
 
 -   **SELECT**: Not implemented. See the explanation in the Thread
     Safety section below.
--   **DEL**: \'del\' is a reserved keyword in the Python syntax.
-    Therefore redis-py uses \'delete\' instead.
+-   **DEL**: *del* is a reserved keyword in the Python syntax.
+    Therefore redis-py uses *delete* instead.
 -   **MULTI/EXEC**: These are implemented as part of the Pipeline class.
     The pipeline is wrapped with the MULTI and EXEC statements by
     default when it is executed, which can be disabled by specifying
@@ -273,14 +181,44 @@ to adhere to the official command syntax. There are a few exceptions:
     PUBLISH from the Redis client (see [this comment on issue
     #151](https://github.com/redis/redis-py/issues/151#issuecomment-1545015)
     for details).
--   **SCAN/SSCAN/HSCAN/ZSCAN**: The \*SCAN commands are implemented as
+-   **SCAN/SSCAN/HSCAN/ZSCAN**: The *SCAN commands are implemented as
     they exist in the Redis documentation. In addition, each command has
     an equivalent iterator method. These are purely for convenience so
-    the user doesn\'t have to keep track of the cursor while iterating.
+    the user doesn't have to keep track of the cursor while iterating.
     Use the scan_iter/sscan_iter/hscan_iter/zscan_iter methods for this
     behavior.
 
-## More Detail
+## Connecting to Redis
+
+### Client Classes: Redis and StrictRedis
+
+redis-py 3.0 drops support for the legacy *Redis* client class.
+*StrictRedis* has been renamed to *Redis* and an alias named
+*StrictRedis* is provided so that users previously using
+*StrictRedis* can continue to run unchanged.
+
+The 2.X *Redis* class provided alternative implementations of a few
+commands. This confused users (rightfully so) and caused a number of
+support issues. To make things easier going forward, it was decided to
+drop support for these alternate implementations and instead focus on a
+single client class.
+
+2.X users that are already using StrictRedis don\'t have to change the
+class name. StrictRedis will continue to work for the foreseeable
+future.
+
+2.X users that are using the Redis class will have to make changes if
+they use any of the following commands:
+
+-   SETEX: The argument order has changed. The new order is (name, time,
+    value).
+-   LREM: The argument order has changed. The new order is (name, num,
+    value).
+-   TTL and PTTL: The return value is now always an int and matches the
+    official Redis command (>0 indicates the timeout, -1 indicates that
+    the key exists but that it has no expire time set, -2 indicates that
+    the key does not exist)
+
 
 ### Connection Pools
 
@@ -355,7 +293,7 @@ option to a value less than 30.
 
 This option also works on any PubSub connection that is created from a
 client with `health_check_interval` enabled. PubSub users need to ensure
-that `get_message()` or `listen()` are called more frequently than
+that *get_message()* or `listen()` are called more frequently than
 `health_check_interval` seconds. It is assumed that most workloads
 already do this.
 
@@ -363,6 +301,108 @@ If your PubSub use case doesn\'t call `get_message()` or `listen()`
 frequently, you should call `pubsub.check_health()` explicitly on a
 regularly basis.
 
+### SSL Connections
+
+redis-py 3.0 changes the default value of the
+ssl_cert_reqs option from None to
+\'required\'. See [Issue
+1016](https://github.com/redis/redis-py/issues/1016). This change
+enforces hostname validation when accepting a cert from a remote SSL
+terminator. If the terminator doesn\'t properly set the hostname on the
+cert this will cause redis-py 3.0 to raise a ConnectionError.
+
+This check can be disabled by setting ssl_cert_reqs to
+None. Note that doing so removes the security check. Do so
+at your own risk.
+
+Example with hostname verification using a local certificate bundle
+(linux):
+
+``` pycon
+>>> import redis
+>>> r = redis.Redis(host='xxxxxx.cache.amazonaws.com', port=6379, db=0,
+                    ssl=True,
+                    ssl_ca_certs='/etc/ssl/certs/ca-certificates.crt')
+>>> r.set('foo', 'bar')
+True
+>>> r.get('foo')
+b'bar'
+```
+
+Example with hostname verification using
+[certifi](https://pypi.org/project/certifi/):
+
+``` pycon
+>>> import redis, certifi
+>>> r = redis.Redis(host='xxxxxx.cache.amazonaws.com', port=6379, db=0,
+                    ssl=True, ssl_ca_certs=certifi.where())
+>>> r.set('foo', 'bar')
+True
+>>> r.get('foo')
+b'bar'
+```
+
+Example turning off hostname verification (not recommended):
+
+``` pycon
+>>> import redis
+>>> r = redis.Redis(host='xxxxxx.cache.amazonaws.com', port=6379, db=0,
+                    ssl=True, ssl_cert_reqs=None)
+>>> r.set('foo', 'bar')
+True
+>>> r.get('foo')
+b'bar'
+```
+
+### Sentinel support
+
+redis-py can be used together with [Redis
+Sentinel](https://redis.io/topics/sentinel) to discover Redis nodes. You
+need to have at least one Sentinel daemon running in order to use
+redis-py's Sentinel support.
+
+Connecting redis-py to the Sentinel instance(s) is easy. You can use a
+Sentinel connection to discover the master and slaves network addresses:
+
+``` pycon
+>>> from redis.sentinel import Sentinel
+>>> sentinel = Sentinel([('localhost', 26379)], socket_timeout=0.1)
+>>> sentinel.discover_master('mymaster')
+('127.0.0.1', 6379)
+>>> sentinel.discover_slaves('mymaster')
+[('127.0.0.1', 6380)]
+```
+
+You can also create Redis client connections from a Sentinel instance.
+You can connect to either the master (for write operations) or a slave
+(for read-only operations).
+
+``` pycon
+>>> master = sentinel.master_for('mymaster', socket_timeout=0.1)
+>>> slave = sentinel.slave_for('mymaster', socket_timeout=0.1)
+>>> master.set('foo', 'bar')
+>>> slave.get('foo')
+b'bar'
+```
+
+The master and slave objects are normal Redis instances with their
+connection pool bound to the Sentinel instance. When a Sentinel backed
+client attempts to establish a connection, it first queries the Sentinel
+servers to determine an appropriate host to connect to. If no server is
+found, a MasterNotFoundError or SlaveNotFoundError is raised. Both
+exceptions are subclasses of ConnectionError.
+
+When trying to connect to a slave client, the Sentinel connection pool
+will iterate over the list of slaves until it finds one that can be
+connected to. If no slaves can be connected to, a connection will be
+established with the master.
+
+See [Guidelines for Redis clients with support for Redis
+Sentinel](https://redis.io/topics/sentinel-clients) to learn more about
+Redis Sentinel.
+
+--------------------------
+
 ### Parsers
 
 Parser classes provide a way to control how responses from the Redis
@@ -875,52 +915,6 @@ just prior to pipeline execution.
 [True, 25]
 ```
 
-### Sentinel support
-
-redis-py can be used together with [Redis
-Sentinel](https://redis.io/topics/sentinel) to discover Redis nodes. You
-need to have at least one Sentinel daemon running in order to use
-redis-py\'s Sentinel support.
-
-Connecting redis-py to the Sentinel instance(s) is easy. You can use a
-Sentinel connection to discover the master and slaves network addresses:
-
-``` pycon
->>> from redis.sentinel import Sentinel
->>> sentinel = Sentinel([('localhost', 26379)], socket_timeout=0.1)
->>> sentinel.discover_master('mymaster')
-('127.0.0.1', 6379)
->>> sentinel.discover_slaves('mymaster')
-[('127.0.0.1', 6380)]
-```
-
-You can also create Redis client connections from a Sentinel instance.
-You can connect to either the master (for write operations) or a slave
-(for read-only operations).
-
-``` pycon
->>> master = sentinel.master_for('mymaster', socket_timeout=0.1)
->>> slave = sentinel.slave_for('mymaster', socket_timeout=0.1)
->>> master.set('foo', 'bar')
->>> slave.get('foo')
-b'bar'
-```
-
-The master and slave objects are normal Redis instances with their
-connection pool bound to the Sentinel instance. When a Sentinel backed
-client attempts to establish a connection, it first queries the Sentinel
-servers to determine an appropriate host to connect to. If no server is
-found, a MasterNotFoundError or SlaveNotFoundError is raised. Both
-exceptions are subclasses of ConnectionError.
-
-When trying to connect to a slave client, the Sentinel connection pool
-will iterate over the list of slaves until it finds one that can be
-connected to. If no slaves can be connected to, a connection will be
-established with the master.
-
-See [Guidelines for Redis clients with support for Redis
-Sentinel](https://redis.io/topics/sentinel-clients) to learn more about
-Redis Sentinel.
 
 ### Scan Iterators
 
@@ -947,18 +941,16 @@ Mode](https://redis.io/topics/cluster-tutorial).
 
 ### Author
 
-redis-py is developed and maintained by Andy McCurdy
-(<sedrik@gmail.com>). It can be found here:
-<https://github.com/redis/redis-py>
+redis-py is developed and maintained by [Redis Inc](https://redis.com). It can be found [here](
+https://github.com/redis/redis-py), or downloaded from [pypi](https://pypi.org/project/redis/).
 
 Special thanks to:
 
+-   Andy McCurdy (<sedrik@gmail.com>) the original author of redis-py.
 -   Ludovico Magnocavallo, author of the original Python Redis client,
     from which some of the socket code is still used.
 -   Alexander Solovyov for ideas on the generic response callback
     system.
 -   Paul Hubbard for initial packaging support.
 
-### Sponsored by
-
 [![Redis](./docs/logo-redis.png)](https://www.redis.com)

From 8178997e2838d01dafe14dcf0a1d2d6c6a20f051 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 28 Oct 2021 12:46:04 +0300
Subject: [PATCH 0222/1164] Adding vulture for static analysis (#1655)

* Adding vulture for static analysis

Removing dead code found previously by vulture in local runs.
---
 dev_requirements.txt |  3 ++-
 redis/connection.py  |  1 -
 redis/features.py    |  5 -----
 tasks.py             |  2 +-
 tox.ini              | 29 +++++++++++------------------
 whitelist.py         | 12 ++++++++++++
 6 files changed, 26 insertions(+), 26 deletions(-)
 delete mode 100644 redis/features.py
 create mode 100644 whitelist.py

diff --git a/dev_requirements.txt b/dev_requirements.txt
index d3f91fef3d..aa9d8f9eee 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -3,4 +3,5 @@ pytest==6.2.5
 tox==3.24.4
 tox-docker==3.1.0
 invoke==1.6.0
-pytest-cov>=3.0.0
\ No newline at end of file
+pytest-cov>=3.0.0
+vulture>=2.3.0
diff --git a/redis/connection.py b/redis/connection.py
index c99c550ecd..f5d6a38221 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -746,7 +746,6 @@ def can_read(self, timeout=0):
         sock = self._sock
         if not sock:
             self.connect()
-            sock = self._sock
         return self._parser.can_read(timeout)
 
     def read_response(self):
diff --git a/redis/features.py b/redis/features.py
deleted file mode 100644
index a96bac7c77..0000000000
--- a/redis/features.py
+++ /dev/null
@@ -1,5 +0,0 @@
-try:
-    import hiredis  # noqa
-    HIREDIS_AVAILABLE = True
-except ImportError:
-    HIREDIS_AVAILABLE = False
diff --git a/tasks.py b/tasks.py
index aa965c6902..4ca2242fa9 100644
--- a/tasks.py
+++ b/tasks.py
@@ -23,7 +23,7 @@ def devenv(c):
 @task
 def linters(c):
     """Run code linters"""
-    run("flake8")
+    run("tox -e linters")
 
 
 @task
diff --git a/tox.ini b/tox.ini
index 67b7e7575d..211f69e1fe 100644
--- a/tox.ini
+++ b/tox.ini
@@ -6,7 +6,7 @@ markers =
 [tox]
 minversion = 3.2.0
 requires = tox-docker
-envlist = {py35,py36,py37,py38,py39,pypy3}-{plain,hiredis}, flake8
+envlist = {py35,py36,py37,py38,py39,pypy3}-{plain,hiredis},linters
 
 [docker:master]
 name = master
@@ -102,9 +102,12 @@ docker =
     lots-of-pythons
 commands = /usr/bin/echo
 
-[testenv:flake8]
+[testenv:linters]
 deps_files = dev_requirements.txt
-commands = flake8
+docker=
+commands =
+    flake8
+    vulture redis whitelist.py --min-confidence 80
 skipsdist = true
 skip_install = true
 
@@ -114,18 +117,8 @@ basepython = pypy3
 [testenv:pypy3-hiredis]
 basepython = pypy3
 
-#[testenv:codecov]
-#deps = codecov
-#commands = codecov
-#passenv =
-#  REDIS_*
-#  CI
-#  CI_*
-#  CODECOV_*
-#  SHIPPABLE
-#  GITHUB_*
-#  VCS_*
-#
-#[testenv:covreport]
-#deps = coverage
-#commands = coverage report
+[flake8]
+exclude =
+    .venv,
+    .tox,
+    whitelist.py
diff --git a/whitelist.py b/whitelist.py
new file mode 100644
index 0000000000..891ccd6022
--- /dev/null
+++ b/whitelist.py
@@ -0,0 +1,12 @@
+exc_type  # unused variable (/data/repos/redis/redis-py/redis/client.py:1045)
+exc_value  # unused variable (/data/repos/redis/redis-py/redis/client.py:1045)
+traceback  # unused variable (/data/repos/redis/redis-py/redis/client.py:1045)
+exc_type  # unused variable (/data/repos/redis/redis-py/redis/client.py:1211)
+exc_value  # unused variable (/data/repos/redis/redis-py/redis/client.py:1211)
+traceback  # unused variable (/data/repos/redis/redis-py/redis/client.py:1211)
+exc_type  # unused variable (/data/repos/redis/redis-py/redis/client.py:1589)
+exc_value  # unused variable (/data/repos/redis/redis-py/redis/client.py:1589)
+traceback  # unused variable (/data/repos/redis/redis-py/redis/client.py:1589)
+exc_type  # unused variable (/data/repos/redis/redis-py/redis/lock.py:156)
+exc_value  # unused variable (/data/repos/redis/redis-py/redis/lock.py:156)
+traceback  # unused variable (/data/repos/redis/redis-py/redis/lock.py:156)

From e46dd85aa9e30a27106baf04ce22cb3e986857bb Mon Sep 17 00:00:00 2001
From: Anas <anas.el.amraoui@live.com>
Date: Tue, 2 Nov 2021 10:13:04 +0200
Subject: [PATCH 0223/1164] Added boolean parsing to PEXPIRE and PEXPIREAT
 (#1665)

---
 redis/client.py        |  3 ++-
 tests/test_commands.py | 24 ++++++++++++------------
 2 files changed, 14 insertions(+), 13 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 986af7cfba..935d9dd891 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -618,7 +618,8 @@ class Redis(RedisModuleCommands, CoreCommands, object):
     """
     RESPONSE_CALLBACKS = {
         **string_keys_to_dict(
-            'AUTH COPY EXPIRE EXPIREAT HEXISTS HMSET LMOVE BLMOVE MOVE '
+            'AUTH COPY EXPIRE EXPIREAT PEXPIRE PEXPIREAT '
+            'HEXISTS HMSET LMOVE BLMOVE MOVE '
             'MSETNX PERSIST PSETEX RENAMENX SISMEMBER SMOVE SETEX SETNX',
             bool
         ),
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 6d65931539..8aa584b224 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -834,9 +834,9 @@ def test_exists_contains(self, r):
         assert 'a' in r
 
     def test_expire(self, r):
-        assert not r.expire('a', 10)
+        assert r.expire('a', 10) is False
         r['a'] = 'foo'
-        assert r.expire('a', 10)
+        assert r.expire('a', 10) is True
         assert 0 < r.ttl('a') <= 10
         assert r.persist('a')
         assert r.ttl('a') == -1
@@ -844,18 +844,18 @@ def test_expire(self, r):
     def test_expireat_datetime(self, r):
         expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
         r['a'] = 'foo'
-        assert r.expireat('a', expire_at)
+        assert r.expireat('a', expire_at) is True
         assert 0 < r.ttl('a') <= 61
 
     def test_expireat_no_key(self, r):
         expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
-        assert not r.expireat('a', expire_at)
+        assert r.expireat('a', expire_at) is False
 
     def test_expireat_unixtime(self, r):
         expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
         r['a'] = 'foo'
         expire_at_seconds = int(time.mktime(expire_at.timetuple()))
-        assert r.expireat('a', expire_at_seconds)
+        assert r.expireat('a', expire_at_seconds) is True
         assert 0 < r.ttl('a') <= 61
 
     def test_get_and_set(self, r):
@@ -998,9 +998,9 @@ def test_msetnx(self, r):
 
     @skip_if_server_version_lt('2.6.0')
     def test_pexpire(self, r):
-        assert not r.pexpire('a', 60000)
+        assert r.pexpire('a', 60000) is False
         r['a'] = 'foo'
-        assert r.pexpire('a', 60000)
+        assert r.pexpire('a', 60000) is True
         assert 0 < r.pttl('a') <= 60000
         assert r.persist('a')
         assert r.pttl('a') == -1
@@ -1009,20 +1009,20 @@ def test_pexpire(self, r):
     def test_pexpireat_datetime(self, r):
         expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
         r['a'] = 'foo'
-        assert r.pexpireat('a', expire_at)
+        assert r.pexpireat('a', expire_at) is True
         assert 0 < r.pttl('a') <= 61000
 
     @skip_if_server_version_lt('2.6.0')
     def test_pexpireat_no_key(self, r):
         expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
-        assert not r.pexpireat('a', expire_at)
+        assert r.pexpireat('a', expire_at) is False
 
     @skip_if_server_version_lt('2.6.0')
     def test_pexpireat_unixtime(self, r):
         expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
         r['a'] = 'foo'
         expire_at_seconds = int(time.mktime(expire_at.timetuple())) * 1000
-        assert r.pexpireat('a', expire_at_seconds)
+        assert r.pexpireat('a', expire_at_seconds) is True
         assert 0 < r.pttl('a') <= 61000
 
     @skip_if_server_version_lt('2.6.0')
@@ -1040,9 +1040,9 @@ def test_psetex_timedelta(self, r):
 
     @skip_if_server_version_lt('2.6.0')
     def test_pttl(self, r):
-        assert not r.pexpire('a', 10000)
+        assert r.pexpire('a', 10000) is False
         r['a'] = '1'
-        assert r.pexpire('a', 10000)
+        assert r.pexpire('a', 10000) is True
         assert 0 < r.pttl('a') <= 10000
         assert r.persist('a')
         assert r.pttl('a') == -1

From 75c5d5974ed3f6a5069f601f4c0d42ad3ae48c76 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 2 Nov 2021 11:55:07 +0200
Subject: [PATCH 0224/1164] Improved JSON accuracy (#1666)

---
 redis/commands/helpers.py       |   2 +
 redis/commands/json/__init__.py |   8 ++-
 redis/commands/json/commands.py |  93 +++++++++++++++------------
 redis/commands/json/decoders.py |  12 ++++
 redis/commands/json/path.py     |  11 +---
 requirements.txt                |   1 +
 setup.py                        |   3 +
 tests/test_json.py              | 107 ++++++++++++++++++++++++--------
 tox.ini                         |   4 +-
 9 files changed, 165 insertions(+), 76 deletions(-)
 create mode 100644 redis/commands/json/decoders.py
 create mode 100644 requirements.txt

diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
index a92c02503e..48ee5568e6 100644
--- a/redis/commands/helpers.py
+++ b/redis/commands/helpers.py
@@ -22,6 +22,8 @@ def nativestr(x):
 
 def delist(x):
     """Given a list of binaries, return the stringified version."""
+    if x is None:
+        return x
     return [nativestr(obj) for obj in x]
 
 
diff --git a/redis/commands/json/__init__.py b/redis/commands/json/__init__.py
index 978370553a..3149bb8f50 100644
--- a/redis/commands/json/__init__.py
+++ b/redis/commands/json/__init__.py
@@ -1,5 +1,9 @@
 from json import JSONDecoder, JSONEncoder
 
+from .decoders import (
+    int_or_list,
+    int_or_none
+)
 from .helpers import bulk_of_jsons
 from ..helpers import nativestr, delist
 from .commands import JSONCommands
@@ -48,13 +52,13 @@ def __init__(
             "JSON.ARRAPPEND": int,
             "JSON.ARRINDEX": int,
             "JSON.ARRINSERT": int,
-            "JSON.ARRLEN": int,
+            "JSON.ARRLEN": int_or_none,
             "JSON.ARRPOP": self._decode,
             "JSON.ARRTRIM": int,
             "JSON.OBJLEN": int,
             "JSON.OBJKEYS": delist,
             # "JSON.RESP": delist,
-            "JSON.DEBUG": int,
+            "JSON.DEBUG": int_or_list,
         }
 
         self.client = client
diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index 2f8039f8bf..fb00e220aa 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -1,5 +1,7 @@
-from .path import Path, str_path
+from .path import Path
 from .helpers import decode_dict_keys
+from deprecated import deprecated
+from redis.exceptions import DataError
 
 
 class JSONCommands:
@@ -9,7 +11,7 @@ def arrappend(self, name, path=Path.rootPath(), *args):
         """Append the objects ``args`` to the array under the
         ``path` in key ``name``.
         """
-        pieces = [name, str_path(path)]
+        pieces = [name, str(path)]
         for o in args:
             pieces.append(self._encode(o))
         return self.execute_command("JSON.ARRAPPEND", *pieces)
@@ -23,7 +25,7 @@ def arrindex(self, name, path, scalar, start=0, stop=-1):
         and exclusive ``stop`` indices.
         """
         return self.execute_command(
-            "JSON.ARRINDEX", name, str_path(path), self._encode(scalar),
+            "JSON.ARRINDEX", name, str(path), self._encode(scalar),
             start, stop
         )
 
@@ -31,67 +33,64 @@ def arrinsert(self, name, path, index, *args):
         """Insert the objects ``args`` to the array at index ``index``
         under the ``path` in key ``name``.
         """
-        pieces = [name, str_path(path), index]
+        pieces = [name, str(path), index]
         for o in args:
             pieces.append(self._encode(o))
         return self.execute_command("JSON.ARRINSERT", *pieces)
 
-    def forget(self, name, path=Path.rootPath()):
-        """Alias for jsondel (delete the JSON value)."""
-        return self.execute_command("JSON.FORGET", name, str_path(path))
-
     def arrlen(self, name, path=Path.rootPath()):
         """Return the length of the array JSON value under ``path``
         at key``name``.
         """
-        return self.execute_command("JSON.ARRLEN", name, str_path(path))
+        return self.execute_command("JSON.ARRLEN", name, str(path))
 
     def arrpop(self, name, path=Path.rootPath(), index=-1):
         """Pop the element at ``index`` in the array JSON value under
         ``path`` at key ``name``.
         """
-        return self.execute_command("JSON.ARRPOP", name, str_path(path), index)
+        return self.execute_command("JSON.ARRPOP", name, str(path), index)
 
     def arrtrim(self, name, path, start, stop):
         """Trim the array JSON value under ``path`` at key ``name`` to the
         inclusive range given by ``start`` and ``stop``.
         """
-        return self.execute_command("JSON.ARRTRIM", name, str_path(path),
+        return self.execute_command("JSON.ARRTRIM", name, str(path),
                                     start, stop)
 
     def type(self, name, path=Path.rootPath()):
         """Get the type of the JSON value under ``path`` from key ``name``."""
-        return self.execute_command("JSON.TYPE", name, str_path(path))
+        return self.execute_command("JSON.TYPE", name, str(path))
 
     def resp(self, name, path=Path.rootPath()):
         """Return the JSON value under ``path`` at key ``name``."""
-        return self.execute_command("JSON.RESP", name, str_path(path))
+        return self.execute_command("JSON.RESP", name, str(path))
 
     def objkeys(self, name, path=Path.rootPath()):
         """Return the key names in the dictionary JSON value under ``path`` at
         key ``name``."""
-        return self.execute_command("JSON.OBJKEYS", name, str_path(path))
+        return self.execute_command("JSON.OBJKEYS", name, str(path))
 
     def objlen(self, name, path=Path.rootPath()):
         """Return the length of the dictionary JSON value under ``path`` at key
         ``name``.
         """
-        return self.execute_command("JSON.OBJLEN", name, str_path(path))
+        return self.execute_command("JSON.OBJLEN", name, str(path))
 
     def numincrby(self, name, path, number):
         """Increment the numeric (integer or floating point) JSON value under
         ``path`` at key ``name`` by the provided ``number``.
         """
         return self.execute_command(
-            "JSON.NUMINCRBY", name, str_path(path), self._encode(number)
+            "JSON.NUMINCRBY", name, str(path), self._encode(number)
         )
 
+    @deprecated(version='4.0.0', reason='deprecated since redisjson 1.0.0')
     def nummultby(self, name, path, number):
         """Multiply the numeric (integer or floating point) JSON value under
         ``path`` at key ``name`` with the provided ``number``.
         """
         return self.execute_command(
-            "JSON.NUMMULTBY", name, str_path(path), self._encode(number)
+            "JSON.NUMMULTBY", name, str(path), self._encode(number)
         )
 
     def clear(self, name, path=Path.rootPath()):
@@ -102,11 +101,14 @@ def clear(self, name, path=Path.rootPath()):
         Return the count of cleared paths (ignoring non-array and non-objects
         paths).
         """
-        return self.execute_command("JSON.CLEAR", name, str_path(path))
+        return self.execute_command("JSON.CLEAR", name, str(path))
+
+    def delete(self, key, path=Path.rootPath()):
+        """Delete the JSON value stored at key ``key`` under ``path``."""
+        return self.execute_command("JSON.DEL", key, str(path))
 
-    def delete(self, name, path=Path.rootPath()):
-        """Delete the JSON value stored at key ``name`` under ``path``."""
-        return self.execute_command("JSON.DEL", name, str_path(path))
+    # forget is an alias for delete
+    forget = delete
 
     def get(self, name, *args, no_escape=False):
         """
@@ -125,7 +127,7 @@ def get(self, name, *args, no_escape=False):
 
         else:
             for p in args:
-                pieces.append(str_path(p))
+                pieces.append(str(p))
 
         # Handle case where key doesn't exist. The JSONDecoder would raise a
         # TypeError exception since it can't decode None
@@ -134,13 +136,14 @@ def get(self, name, *args, no_escape=False):
         except TypeError:
             return None
 
-    def mget(self, path, *args):
-        """Get the objects stored as a JSON values under ``path`` from keys
-        ``args``.
+    def mget(self, keys, path):
+        """
+        Get the objects stored as a JSON values under ``path``. ``keys``
+        is a list of one or more keys.
         """
         pieces = []
-        pieces.extend(args)
-        pieces.append(str_path(path))
+        pieces += keys
+        pieces.append(str(path))
         return self.execute_command("JSON.MGET", *pieces)
 
     def set(self, name, path, obj, nx=False, xx=False, decode_keys=False):
@@ -155,7 +158,7 @@ def set(self, name, path, obj, nx=False, xx=False, decode_keys=False):
         if decode_keys:
             obj = decode_dict_keys(obj)
 
-        pieces = [name, str_path(path), self._encode(obj)]
+        pieces = [name, str(path), self._encode(obj)]
 
         # Handle existential modifiers
         if nx and xx:
@@ -169,29 +172,43 @@ def set(self, name, path, obj, nx=False, xx=False, decode_keys=False):
             pieces.append("XX")
         return self.execute_command("JSON.SET", *pieces)
 
-    def strlen(self, name, path=Path.rootPath()):
+    def strlen(self, name, path=None):
         """Return the length of the string JSON value under ``path`` at key
         ``name``.
         """
-        return self.execute_command("JSON.STRLEN", name, str_path(path))
+        pieces = [name]
+        if path is not None:
+            pieces.append(str(path))
+        return self.execute_command("JSON.STRLEN", *pieces)
 
     def toggle(self, name, path=Path.rootPath()):
         """Toggle boolean value under ``path`` at key ``name``.
         returning the new value.
         """
-        return self.execute_command("JSON.TOGGLE", name, str_path(path))
+        return self.execute_command("JSON.TOGGLE", name, str(path))
 
-    def strappend(self, name, string, path=Path.rootPath()):
-        """Append to the string JSON value under ``path`` at key ``name``
-        the provided ``string``.
+    def strappend(self, name, value, path=Path.rootPath()):
+        """Append to the string JSON value. If two options are specified after
+        the key name, the path is determined to be the first. If a single
+        option is passed, then the rootpath (i.e Path.rootPath()) is used.
         """
+        pieces = [name, str(path), value]
         return self.execute_command(
-            "JSON.STRAPPEND", name, str_path(path), self._encode(string)
+            "JSON.STRAPPEND", *pieces
         )
 
-    def debug(self, name, path=Path.rootPath()):
+    def debug(self, subcommand, key=None, path=Path.rootPath()):
         """Return the memory usage in bytes of a value under ``path`` from
         key ``name``.
         """
-        return self.execute_command("JSON.DEBUG", "MEMORY",
-                                    name, str_path(path))
+        valid_subcommands = ["MEMORY", "HELP"]
+        if subcommand not in valid_subcommands:
+            raise DataError("The only valid subcommands are ",
+                            str(valid_subcommands))
+        pieces = [subcommand]
+        if subcommand == "MEMORY":
+            if key is None:
+                raise DataError("No key specified")
+            pieces.append(key)
+            pieces.append(str(path))
+        return self.execute_command("JSON.DEBUG", *pieces)
diff --git a/redis/commands/json/decoders.py b/redis/commands/json/decoders.py
new file mode 100644
index 0000000000..0ee102a433
--- /dev/null
+++ b/redis/commands/json/decoders.py
@@ -0,0 +1,12 @@
+def int_or_list(b):
+    if isinstance(b, int):
+        return b
+    else:
+        return b
+
+
+def int_or_none(b):
+    if b is None:
+        return None
+    if isinstance(b, int):
+        return b
diff --git a/redis/commands/json/path.py b/redis/commands/json/path.py
index dff86482df..6d87045155 100644
--- a/redis/commands/json/path.py
+++ b/redis/commands/json/path.py
@@ -1,11 +1,3 @@
-def str_path(p):
-    """Return the string representation of a path if it is of class Path."""
-    if isinstance(p, Path):
-        return p.strPath
-    else:
-        return p
-
-
 class Path(object):
     """This class represents a path in a JSON value."""
 
@@ -19,3 +11,6 @@ def rootPath():
     def __init__(self, path):
         """Make a new path based on the string representation in `path`."""
         self.strPath = path
+
+    def __repr__(self):
+        return self.strPath
diff --git a/requirements.txt b/requirements.txt
new file mode 100644
index 0000000000..9f8d5502da
--- /dev/null
+++ b/requirements.txt
@@ -0,0 +1 @@
+deprecated
diff --git a/setup.py b/setup.py
index d0c81b40dd..6c712bd1d4 100644
--- a/setup.py
+++ b/setup.py
@@ -23,6 +23,9 @@
     author="Redis Inc.",
     author_email="oss@redis.com",
     python_requires=">=3.6",
+    install_requires=[
+        'deprecated'
+    ],
     classifiers=[
         "Development Status :: 5 - Production/Stable",
         "Environment :: Console",
diff --git a/tests/test_json.py b/tests/test_json.py
index 83fbf28669..f62346f762 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -74,27 +74,28 @@ def test_jsonsetexistentialmodifiersshouldsucceed(client):
 def test_mgetshouldsucceed(client):
     client.json().set("1", Path.rootPath(), 1)
     client.json().set("2", Path.rootPath(), 2)
-    r = client.json().mget(Path.rootPath(), "1", "2")
-    e = [1, 2]
-    assert e == r
+    assert client.json().mget(["1"], Path.rootPath()) == [1]
+
+    assert client.json().mget([1, 2], Path.rootPath()) == [1, 2]
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
-def test_clearShouldSucceed(client):
+def test_clear(client):
     client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
     assert 1 == client.json().clear("arr", Path.rootPath())
     assert [] == client.json().get("arr")
 
 
 @pytest.mark.redismod
-def test_typeshouldsucceed(client):
+def test_type(client):
     client.json().set("1", Path.rootPath(), 1)
+    assert b"integer" == client.json().type("1", Path.rootPath())
     assert b"integer" == client.json().type("1")
 
 
 @pytest.mark.redismod
-def test_numincrbyshouldsucceed(client):
+def test_numincrby(client):
     client.json().set("num", Path.rootPath(), 1)
     assert 2 == client.json().numincrby("num", Path.rootPath(), 1)
     assert 2.5 == client.json().numincrby("num", Path.rootPath(), 0.5)
@@ -102,16 +103,18 @@ def test_numincrbyshouldsucceed(client):
 
 
 @pytest.mark.redismod
-def test_nummultbyshouldsucceed(client):
+def test_nummultby(client):
     client.json().set("num", Path.rootPath(), 1)
-    assert 2 == client.json().nummultby("num", Path.rootPath(), 2)
-    assert 5 == client.json().nummultby("num", Path.rootPath(), 2.5)
-    assert 2.5 == client.json().nummultby("num", Path.rootPath(), 0.5)
+
+    with pytest.deprecated_call():
+        assert 2 == client.json().nummultby("num", Path.rootPath(), 2)
+        assert 5 == client.json().nummultby("num", Path.rootPath(), 2.5)
+        assert 2.5 == client.json().nummultby("num", Path.rootPath(), 0.5)
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
-def test_toggleShouldSucceed(client):
+def test_toggle(client):
     client.json().set("bool", Path.rootPath(), False)
     assert client.json().toggle("bool", Path.rootPath())
     assert not client.json().toggle("bool", Path.rootPath())
@@ -122,28 +125,37 @@ def test_toggleShouldSucceed(client):
 
 
 @pytest.mark.redismod
-def test_strappendshouldsucceed(client):
-    client.json().set("str", Path.rootPath(), "foo")
-    assert 6 == client.json().strappend("str", "bar", Path.rootPath())
-    assert "foobar" == client.json().get("str", Path.rootPath())
+def test_strappend(client):
+    client.json().set("jsonkey", Path.rootPath(), 'foo')
+    import json
+    assert 6 == client.json().strappend("jsonkey", json.dumps('bar'))
+    with pytest.raises(redis.exceptions.ResponseError):
+        assert 6 == client.json().strappend("jsonkey", 'bar')
+    assert "foobar" == client.json().get("jsonkey", Path.rootPath())
 
 
 @pytest.mark.redismod
 def test_debug(client):
     client.json().set("str", Path.rootPath(), "foo")
-    assert 24 == client.json().debug("str", Path.rootPath())
+    assert 24 == client.json().debug("MEMORY", "str", Path.rootPath())
+    assert 24 == client.json().debug("MEMORY", "str")
+
+    # technically help is valid
+    assert isinstance(client.json().debug("HELP"), list)
 
 
 @pytest.mark.redismod
-def test_strlenshouldsucceed(client):
+def test_strlen(client):
     client.json().set("str", Path.rootPath(), "foo")
     assert 3 == client.json().strlen("str", Path.rootPath())
-    client.json().strappend("str", "bar", Path.rootPath())
+    import json
+    client.json().strappend("str", json.dumps("bar"), Path.rootPath())
     assert 6 == client.json().strlen("str", Path.rootPath())
+    assert 6 == client.json().strlen("str")
 
 
 @pytest.mark.redismod
-def test_arrappendshouldsucceed(client):
+def test_arrappend(client):
     client.json().set("arr", Path.rootPath(), [1])
     assert 2 == client.json().arrappend("arr", Path.rootPath(), 2)
     assert 4 == client.json().arrappend("arr", Path.rootPath(), 3, 4)
@@ -151,14 +163,14 @@ def test_arrappendshouldsucceed(client):
 
 
 @pytest.mark.redismod
-def testArrIndexShouldSucceed(client):
+def test_arrindex(client):
     client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
     assert 1 == client.json().arrindex("arr", Path.rootPath(), 1)
     assert -1 == client.json().arrindex("arr", Path.rootPath(), 1, 2)
 
 
 @pytest.mark.redismod
-def test_arrinsertshouldsucceed(client):
+def test_arrinsert(client):
     client.json().set("arr", Path.rootPath(), [0, 4])
     assert 5 - -client.json().arrinsert(
         "arr",
@@ -172,15 +184,22 @@ def test_arrinsertshouldsucceed(client):
     )
     assert [0, 1, 2, 3, 4] == client.json().get("arr")
 
+    # test prepends
+    client.json().set("val2", Path.rootPath(), [5, 6, 7, 8, 9])
+    client.json().arrinsert("val2", Path.rootPath(), 0, ['some', 'thing'])
+    assert client.json().get("val2") == [["some", "thing"], 5, 6, 7, 8, 9]
+
 
 @pytest.mark.redismod
-def test_arrlenshouldsucceed(client):
+def test_arrlen(client):
     client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
     assert 5 == client.json().arrlen("arr", Path.rootPath())
+    assert 5 == client.json().arrlen("arr")
+    assert client.json().arrlen('fakekey') is None
 
 
 @pytest.mark.redismod
-def test_arrpopshouldsucceed(client):
+def test_arrpop(client):
     client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
     assert 4 == client.json().arrpop("arr", Path.rootPath(), 4)
     assert 3 == client.json().arrpop("arr", Path.rootPath(), -1)
@@ -188,25 +207,50 @@ def test_arrpopshouldsucceed(client):
     assert 0 == client.json().arrpop("arr", Path.rootPath(), 0)
     assert [1] == client.json().get("arr")
 
+    # test out of bounds
+    client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
+    assert 4 == client.json().arrpop("arr", Path.rootPath(), 99)
+
+    # none test
+    client.json().set("arr", Path.rootPath(), [])
+    assert client.json().arrpop("arr") is None
+
 
 @pytest.mark.redismod
-def test_arrtrimshouldsucceed(client):
+def test_arrtrim(client):
     client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
     assert 3 == client.json().arrtrim("arr", Path.rootPath(), 1, 3)
     assert [1, 2, 3] == client.json().get("arr")
 
+    # <0 test, should be 0 equivalent
+    client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
+    assert 0 == client.json().arrtrim("arr", Path.rootPath(), -1, 3)
+
+    # testing stop > end
+    client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
+    assert 2 == client.json().arrtrim("arr", Path.rootPath(), 3, 99)
+
+    # start > array size and stop
+    client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
+    assert 0 == client.json().arrtrim("arr", Path.rootPath(), 9, 1)
+
+    # all larger
+    client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
+    assert 0 == client.json().arrtrim("arr", Path.rootPath(), 9, 11)
+
 
 @pytest.mark.redismod
-def test_respshouldsucceed(client):
+def test_resp(client):
     obj = {"foo": "bar", "baz": 1, "qaz": True}
     client.json().set("obj", Path.rootPath(), obj)
     assert b"bar" == client.json().resp("obj", Path("foo"))
     assert 1 == client.json().resp("obj", Path("baz"))
     assert client.json().resp("obj", Path("qaz"))
+    assert isinstance(client.json().resp("obj"), list)
 
 
 @pytest.mark.redismod
-def test_objkeysshouldsucceed(client):
+def test_objkeys(client):
     obj = {"foo": "bar", "baz": "qaz"}
     client.json().set("obj", Path.rootPath(), obj)
     keys = client.json().objkeys("obj", Path.rootPath())
@@ -215,13 +259,22 @@ def test_objkeysshouldsucceed(client):
     exp.sort()
     assert exp == keys
 
+    client.json().set("obj", Path.rootPath(), obj)
+    keys = client.json().objkeys("obj")
+    assert keys == list(obj.keys())
+
+    assert client.json().objkeys("fakekey") is None
+
 
 @pytest.mark.redismod
-def test_objlenshouldsucceed(client):
+def test_objlen(client):
     obj = {"foo": "bar", "baz": "qaz"}
     client.json().set("obj", Path.rootPath(), obj)
     assert len(obj) == client.json().objlen("obj", Path.rootPath())
 
+    client.json().set("obj", Path.rootPath(), obj)
+    assert len(obj) == client.json().objlen("obj")
+
 
 # @pytest.mark.pipeline
 # @pytest.mark.redismod
diff --git a/tox.ini b/tox.ini
index 211f69e1fe..f09b3a831c 100644
--- a/tox.ini
+++ b/tox.ini
@@ -75,7 +75,9 @@ volumes =
     bind:rw:{toxinidir}:/data
 
 [testenv]
-deps = -r {toxinidir}/dev_requirements.txt
+deps =
+    -r {toxinidir}/requirements.txt
+    -r {toxinidir}/dev_requirements.txt
 docker =
     master
     replica

From 72b49263f86f32c9df945433f21d3f3a7444d1a0 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 3 Nov 2021 18:23:50 +0200
Subject: [PATCH 0225/1164] SMISMEMBER support (#1667)

---
 redis/commands/core.py | 8 ++++++++
 tests/test_commands.py | 7 +++++++
 2 files changed, 15 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 6512b45a42..8dba5a2abf 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1768,6 +1768,14 @@ def smembers(self, name):
         """Return all members of the set ``name``"""
         return self.execute_command('SMEMBERS', name)
 
+    def smismember(self, name, values, *args):
+        """
+        Return whether each value in ``values`` is a member of the set ``name``
+        as a list of ``bool`` in the order of ``values``
+        """
+        args = list_or_args(values, args)
+        return self.execute_command('SMISMEMBER', name, *args)
+
     def smove(self, src, dst, value):
         """Move ``value`` from set ``src`` to set ``dst`` atomically"""
         return self.execute_command('SMOVE', src, dst, value)
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 8aa584b224..723612af6b 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1577,6 +1577,13 @@ def test_smembers(self, r):
         r.sadd('a', '1', '2', '3')
         assert r.smembers('a') == {b'1', b'2', b'3'}
 
+    @skip_if_server_version_lt('6.2.0')
+    def test_smismember(self, r):
+        r.sadd('a', '1', '2', '3')
+        result_list = [True, False, True, True]
+        assert r.smismember('a', '1', '4', '2', '3') == result_list
+        assert r.smismember('a', ['1', '4', '2', '3']) == result_list
+
     def test_smove(self, r):
         r.sadd('a', 'a1', 'a2')
         r.sadd('b', 'b1', 'b2')

From 8d3c61598706eb049caa66a23501018f2f416673 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 4 Nov 2021 13:20:31 +0200
Subject: [PATCH 0226/1164] Support for json multipath ($) (#1663)

---
 redis/commands/helpers.py       |    5 +-
 redis/commands/json/__init__.py |   45 +-
 redis/commands/json/commands.py |    4 +-
 redis/commands/json/decoders.py |   65 +-
 redis/commands/json/helpers.py  |   25 -
 tests/conftest.py               |    3 +-
 tests/test_json.py              | 1133 ++++++++++++++++++++++++++++++-
 tests/testdata/jsontestdata.py  |  617 +++++++++++++++++
 8 files changed, 1823 insertions(+), 74 deletions(-)
 delete mode 100644 redis/commands/json/helpers.py
 create mode 100644 tests/testdata/jsontestdata.py

diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
index 48ee5568e6..2a4298cb2f 100644
--- a/redis/commands/helpers.py
+++ b/redis/commands/helpers.py
@@ -17,7 +17,10 @@ def list_or_args(keys, args):
 
 def nativestr(x):
     """Return the decoded binary string, or a string, depending on type."""
-    return x.decode("utf-8", "replace") if isinstance(x, bytes) else x
+    r = x.decode("utf-8", "replace") if isinstance(x, bytes) else x
+    if r == 'null':
+        return
+    return r
 
 
 def delist(x):
diff --git a/redis/commands/json/__init__.py b/redis/commands/json/__init__.py
index 3149bb8f50..d00627efce 100644
--- a/redis/commands/json/__init__.py
+++ b/redis/commands/json/__init__.py
@@ -1,11 +1,10 @@
-from json import JSONDecoder, JSONEncoder
+from json import JSONDecoder, JSONEncoder, JSONDecodeError
 
 from .decoders import (
-    int_or_list,
-    int_or_none
+    decode_list,
+    bulk_of_jsons,
 )
-from .helpers import bulk_of_jsons
-from ..helpers import nativestr, delist
+from ..helpers import nativestr
 from .commands import JSONCommands
 
 
@@ -46,19 +45,19 @@ def __init__(
             "JSON.SET": lambda r: r and nativestr(r) == "OK",
             "JSON.NUMINCRBY": self._decode,
             "JSON.NUMMULTBY": self._decode,
-            "JSON.TOGGLE": lambda b: b == b"true",
-            "JSON.STRAPPEND": int,
-            "JSON.STRLEN": int,
-            "JSON.ARRAPPEND": int,
-            "JSON.ARRINDEX": int,
-            "JSON.ARRINSERT": int,
-            "JSON.ARRLEN": int_or_none,
+            "JSON.TOGGLE": self._decode,
+            "JSON.STRAPPEND": self._decode,
+            "JSON.STRLEN": self._decode,
+            "JSON.ARRAPPEND": self._decode,
+            "JSON.ARRINDEX": self._decode,
+            "JSON.ARRINSERT": self._decode,
+            "JSON.ARRLEN": self._decode,
             "JSON.ARRPOP": self._decode,
-            "JSON.ARRTRIM": int,
-            "JSON.OBJLEN": int,
-            "JSON.OBJKEYS": delist,
-            # "JSON.RESP": delist,
-            "JSON.DEBUG": int_or_list,
+            "JSON.ARRTRIM": self._decode,
+            "JSON.OBJLEN": self._decode,
+            "JSON.OBJKEYS": self._decode,
+            "JSON.RESP": self._decode,
+            "JSON.DEBUG": self._decode,
         }
 
         self.client = client
@@ -77,9 +76,17 @@ def _decode(self, obj):
             return obj
 
         try:
-            return self.__decoder__.decode(obj)
+            x = self.__decoder__.decode(obj)
+            if x is None:
+                raise TypeError
+            return x
         except TypeError:
-            return self.__decoder__.decode(obj.decode())
+            try:
+                return self.__decoder__.decode(obj.decode())
+            except AttributeError:
+                return decode_list(obj)
+        except (AttributeError, JSONDecodeError):
+            return decode_list(obj)
 
     def _encode(self, obj):
         """Get the encoder."""
diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index fb00e220aa..716741c19b 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -1,5 +1,5 @@
 from .path import Path
-from .helpers import decode_dict_keys
+from .decoders import decode_dict_keys
 from deprecated import deprecated
 from redis.exceptions import DataError
 
@@ -192,7 +192,7 @@ def strappend(self, name, value, path=Path.rootPath()):
         the key name, the path is determined to be the first. If a single
         option is passed, then the rootpath (i.e Path.rootPath()) is used.
         """
-        pieces = [name, str(path), value]
+        pieces = [name, str(path), self._encode(value)]
         return self.execute_command(
             "JSON.STRAPPEND", *pieces
         )
diff --git a/redis/commands/json/decoders.py b/redis/commands/json/decoders.py
index 0ee102a433..b19395c73b 100644
--- a/redis/commands/json/decoders.py
+++ b/redis/commands/json/decoders.py
@@ -1,12 +1,59 @@
-def int_or_list(b):
-    if isinstance(b, int):
-        return b
-    else:
-        return b
+from ..helpers import nativestr
+import re
+import copy
+
 
+def bulk_of_jsons(d):
+    """Replace serialized JSON values with objects in a
+    bulk array response (list).
+    """
 
-def int_or_none(b):
-    if b is None:
-        return None
-    if isinstance(b, int):
+    def _f(b):
+        for index, item in enumerate(b):
+            if item is not None:
+                b[index] = d(item)
         return b
+
+    return _f
+
+
+def decode_dict_keys(obj):
+    """Decode the keys of the given dictionary with utf-8."""
+    newobj = copy.copy(obj)
+    for k in obj.keys():
+        if isinstance(k, bytes):
+            newobj[k.decode("utf-8")] = newobj[k]
+            newobj.pop(k)
+    return newobj
+
+
+def unstring(obj):
+    """
+    Attempt to parse string to native integer formats.
+    One can't simply call int/float in a try/catch because there is a
+    semantic difference between (for example) 15.0 and 15.
+    """
+    floatreg = '^\\d+.\\d+$'
+    match = re.findall(floatreg, obj)
+    if match != []:
+        return float(match[0])
+
+    intreg = "^\\d+$"
+    match = re.findall(intreg, obj)
+    if match != []:
+        return int(match[0])
+    return obj
+
+
+def decode_list(b):
+    """
+    Given a non-deserializable object, make a best effort to
+    return a useful set of results.
+    """
+    if isinstance(b, list):
+        return [nativestr(obj) for obj in b]
+    elif isinstance(b, bytes):
+        return unstring(nativestr(b))
+    elif isinstance(b, str):
+        return unstring(b)
+    return b
diff --git a/redis/commands/json/helpers.py b/redis/commands/json/helpers.py
deleted file mode 100644
index 8fb20d9ac5..0000000000
--- a/redis/commands/json/helpers.py
+++ /dev/null
@@ -1,25 +0,0 @@
-import copy
-
-
-def bulk_of_jsons(d):
-    """Replace serialized JSON values with objects in a
-    bulk array response (list).
-    """
-
-    def _f(b):
-        for index, item in enumerate(b):
-            if item is not None:
-                b[index] = d(item)
-        return b
-
-    return _f
-
-
-def decode_dict_keys(obj):
-    """Decode the keys of the given dictionary with utf-8."""
-    newobj = copy.copy(obj)
-    for k in obj.keys():
-        if isinstance(k, bytes):
-            newobj[k.decode("utf-8")] = newobj[k]
-            newobj.pop(k)
-    return newobj
diff --git a/tests/conftest.py b/tests/conftest.py
index 47188df07f..b1a0f8cab8 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -126,7 +126,8 @@ def teardown():
 @pytest.fixture()
 def modclient(request, **kwargs):
     rmurl = request.config.getoption('--redismod-url')
-    with _get_client(redis.Redis, request, from_url=rmurl, **kwargs) as client:
+    with _get_client(redis.Redis, request, from_url=rmurl,
+                     decode_responses=True, **kwargs) as client:
         yield client
 
 
diff --git a/tests/test_json.py b/tests/test_json.py
index f62346f762..19b0c3262e 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -1,6 +1,8 @@
 import pytest
 import redis
 from redis.commands.json.path import Path
+from redis import exceptions
+from redis.commands.json.decoders import unstring, decode_list
 from .conftest import skip_ifmodversion_lt
 
 
@@ -29,7 +31,7 @@ def test_json_setgetdeleteforget(client):
 
 
 @pytest.mark.redismod
-def test_justaget(client):
+def test_jsonget(client):
     client.json().set("foo", Path.rootPath(), "bar")
     assert client.json().get("foo") == "bar"
 
@@ -45,9 +47,10 @@ def test_json_get_jset(client):
 
 @pytest.mark.redismod
 def test_nonascii_setgetdelete(client):
-    assert client.json().set("notascii", Path.rootPath(),
-                             "hyvää-élève") is True
-    assert "hyvää-élève" == client.json().get("notascii", no_escape=True)
+    assert client.json().set("notascii", Path.rootPath(), "hyvää-élève")
+    assert "hyvää-élève" == client.json().get(
+        "notascii",
+        no_escape=True)
     assert 1 == client.json().delete("notascii")
     assert client.exists("notascii") == 0
 
@@ -90,8 +93,8 @@ def test_clear(client):
 @pytest.mark.redismod
 def test_type(client):
     client.json().set("1", Path.rootPath(), 1)
-    assert b"integer" == client.json().type("1", Path.rootPath())
-    assert b"integer" == client.json().type("1")
+    assert "integer" == client.json().type("1", Path.rootPath())
+    assert "integer" == client.json().type("1")
 
 
 @pytest.mark.redismod
@@ -117,7 +120,7 @@ def test_nummultby(client):
 def test_toggle(client):
     client.json().set("bool", Path.rootPath(), False)
     assert client.json().toggle("bool", Path.rootPath())
-    assert not client.json().toggle("bool", Path.rootPath())
+    assert client.json().toggle("bool", Path.rootPath()) is False
     # check non-boolean value
     client.json().set("num", Path.rootPath(), 1)
     with pytest.raises(redis.exceptions.ResponseError):
@@ -126,11 +129,8 @@ def test_toggle(client):
 
 @pytest.mark.redismod
 def test_strappend(client):
-    client.json().set("jsonkey", Path.rootPath(), 'foo')
-    import json
-    assert 6 == client.json().strappend("jsonkey", json.dumps('bar'))
-    with pytest.raises(redis.exceptions.ResponseError):
-        assert 6 == client.json().strappend("jsonkey", 'bar')
+    client.json().set("jsonkey", Path.rootPath(), "foo")
+    assert 6 == client.json().strappend("jsonkey", "bar")
     assert "foobar" == client.json().get("jsonkey", Path.rootPath())
 
 
@@ -148,8 +148,7 @@ def test_debug(client):
 def test_strlen(client):
     client.json().set("str", Path.rootPath(), "foo")
     assert 3 == client.json().strlen("str", Path.rootPath())
-    import json
-    client.json().strappend("str", json.dumps("bar"), Path.rootPath())
+    client.json().strappend("str", "bar", Path.rootPath())
     assert 6 == client.json().strlen("str", Path.rootPath())
     assert 6 == client.json().strlen("str")
 
@@ -186,7 +185,7 @@ def test_arrinsert(client):
 
     # test prepends
     client.json().set("val2", Path.rootPath(), [5, 6, 7, 8, 9])
-    client.json().arrinsert("val2", Path.rootPath(), 0, ['some', 'thing'])
+    client.json().arrinsert("val2", Path.rootPath(), 0, ["some", "thing"])
     assert client.json().get("val2") == [["some", "thing"], 5, 6, 7, 8, 9]
 
 
@@ -195,7 +194,7 @@ def test_arrlen(client):
     client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
     assert 5 == client.json().arrlen("arr", Path.rootPath())
     assert 5 == client.json().arrlen("arr")
-    assert client.json().arrlen('fakekey') is None
+    assert client.json().arrlen("fakekey") is None
 
 
 @pytest.mark.redismod
@@ -243,7 +242,7 @@ def test_arrtrim(client):
 def test_resp(client):
     obj = {"foo": "bar", "baz": 1, "qaz": True}
     client.json().set("obj", Path.rootPath(), obj)
-    assert b"bar" == client.json().resp("obj", Path("foo"))
+    assert "bar" == client.json().resp("obj", Path("foo"))
     assert 1 == client.json().resp("obj", Path("baz"))
     assert client.json().resp("obj", Path("qaz"))
     assert isinstance(client.json().resp("obj"), list)
@@ -286,3 +285,1103 @@ def test_objlen(client):
 #     assert [True, "bar", 1] == p.execute()
 #     assert client.keys() == []
 #     assert client.get("foo") is None
+
+
+@pytest.mark.redismod
+def test_json_delete_with_dollar(client):
+    doc1 = {"a": 1, "nested": {"a": 2, "b": 3}}
+    assert client.json().set("doc1", "$", doc1)
+    assert client.json().delete("doc1", "$..a") == 2
+    r = client.json().get("doc1", "$")
+    assert r == [{"nested": {"b": 3}}]
+
+    doc2 = {"a": {"a": 2, "b": 3}, "b": [
+        "a", "b"], "nested": {"b": [True, "a", "b"]}}
+    assert client.json().set("doc2", "$", doc2)
+    assert client.json().delete("doc2", "$..a") == 1
+    res = client.json().get("doc2", "$")
+    assert res == [{"nested": {"b": [True, "a", "b"]}, "b": ["a", "b"]}]
+
+    doc3 = [
+        {
+            "ciao": ["non ancora"],
+            "nested": [
+                {"ciao": [1, "a"]},
+                {"ciao": [2, "a"]},
+                {"ciaoc": [3, "non", "ciao"]},
+                {"ciao": [4, "a"]},
+                {"e": [5, "non", "ciao"]},
+            ],
+        }
+    ]
+    assert client.json().set("doc3", "$", doc3)
+    assert client.json().delete("doc3", '$.[0]["nested"]..ciao') == 3
+
+    doc3val = [
+        [
+            {
+                "ciao": ["non ancora"],
+                "nested": [
+                    {},
+                    {},
+                    {"ciaoc": [3, "non", "ciao"]},
+                    {},
+                    {"e": [5, "non", "ciao"]},
+                ],
+            }
+        ]
+    ]
+    res = client.json().get("doc3", "$")
+    assert res == doc3val
+
+    # Test default path
+    assert client.json().delete("doc3") == 1
+    assert client.json().get("doc3", "$") is None
+
+    client.json().delete("not_a_document", "..a")
+
+
+@pytest.mark.redismod
+def test_json_forget_with_dollar(client):
+    doc1 = {"a": 1, "nested": {"a": 2, "b": 3}}
+    assert client.json().set("doc1", "$", doc1)
+    assert client.json().forget("doc1", "$..a") == 2
+    r = client.json().get("doc1", "$")
+    assert r == [{"nested": {"b": 3}}]
+
+    doc2 = {"a": {"a": 2, "b": 3}, "b": [
+        "a", "b"], "nested": {"b": [True, "a", "b"]}}
+    assert client.json().set("doc2", "$", doc2)
+    assert client.json().forget("doc2", "$..a") == 1
+    res = client.json().get("doc2", "$")
+    assert res == [{"nested": {"b": [True, "a", "b"]}, "b": ["a", "b"]}]
+
+    doc3 = [
+        {
+            "ciao": ["non ancora"],
+            "nested": [
+                {"ciao": [1, "a"]},
+                {"ciao": [2, "a"]},
+                {"ciaoc": [3, "non", "ciao"]},
+                {"ciao": [4, "a"]},
+                {"e": [5, "non", "ciao"]},
+            ],
+        }
+    ]
+    assert client.json().set("doc3", "$", doc3)
+    assert client.json().forget("doc3", '$.[0]["nested"]..ciao') == 3
+
+    doc3val = [
+        [
+            {
+                "ciao": ["non ancora"],
+                "nested": [
+                    {},
+                    {},
+                    {"ciaoc": [3, "non", "ciao"]},
+                    {},
+                    {"e": [5, "non", "ciao"]},
+                ],
+            }
+        ]
+    ]
+    res = client.json().get("doc3", "$")
+    assert res == doc3val
+
+    # Test default path
+    assert client.json().forget("doc3") == 1
+    assert client.json().get("doc3", "$") is None
+
+    client.json().forget("not_a_document", "..a")
+
+
+@pytest.mark.redismod
+def test_json_mget_dollar(client):
+    # Test mget with multi paths
+    client.json().set(
+        "doc1",
+        "$",
+        {"a": 1,
+            "b": 2,
+            "nested": {"a": 3},
+            "c": None, "nested2": {"a": None}},
+    )
+    client.json().set(
+        "doc2",
+        "$",
+        {"a": 4, "b": 5, "nested": {"a": 6},
+            "c": None, "nested2": {"a": [None]}},
+    )
+    # Compare also to single JSON.GET
+    assert client.json().get("doc1", "$..a") == [1, 3, None]
+    assert client.json().get("doc2", "$..a") == [4, 6, [None]]
+
+    # Test mget with single path
+    client.json().mget("doc1", "$..a") == [1, 3, None]
+    # Test mget with multi path
+    client.json().mget(["doc1", "doc2"], "$..a") == [
+        [1, 3, None], [4, 6, [None]]]
+
+    # Test missing key
+    client.json().mget(["doc1", "missing_doc"], "$..a") == [[1, 3, None], None]
+    res = client.json().mget(["missing_doc1", "missing_doc2"], "$..a")
+    assert res == [None, None]
+
+
+@pytest.mark.redismod
+def test_numby_commands_dollar(client):
+
+    # Test NUMINCRBY
+    client.json().set(
+        "doc1",
+        "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]})
+    # Test multi
+    assert client.json().numincrby("doc1", "$..a", 2) == \
+        [None, 4, 7.0, None]
+
+    assert client.json().numincrby("doc1", "$..a", 2.5) == \
+        [None, 6.5, 9.5, None]
+    # Test single
+    assert client.json().numincrby("doc1", "$.b[1].a", 2) == [11.5]
+
+    assert client.json().numincrby("doc1", "$.b[2].a", 2) == [None]
+    assert client.json().numincrby("doc1", "$.b[1].a", 3.5) == [15.0]
+
+    # Test NUMMULTBY
+    client.json().set("doc1", "$", {"a": "b", "b": [
+        {"a": 2}, {"a": 5.0}, {"a": "c"}]})
+
+    assert client.json().nummultby("doc1", "$..a", 2) == \
+        [None, 4, 10, None]
+    assert client.json().nummultby("doc1", "$..a", 2.5) == \
+        [None, 10.0, 25.0, None]
+    # Test single
+    assert client.json().nummultby("doc1", "$.b[1].a", 2) == [50.0]
+    assert client.json().nummultby("doc1", "$.b[2].a", 2) == [None]
+    assert client.json().nummultby("doc1", "$.b[1].a", 3) == [150.0]
+
+    # test missing keys
+    with pytest.raises(exceptions.ResponseError):
+        client.json().numincrby("non_existing_doc", "$..a", 2)
+        client.json().nummultby("non_existing_doc", "$..a", 2)
+
+    # Test legacy NUMINCRBY
+    client.json().set("doc1", "$", {"a": "b", "b": [
+        {"a": 2}, {"a": 5.0}, {"a": "c"}]})
+    client.json().numincrby("doc1", ".b[0].a", 3) == 5
+
+    # Test legacy NUMMULTBY
+    client.json().set("doc1", "$", {"a": "b", "b": [
+        {"a": 2}, {"a": 5.0}, {"a": "c"}]})
+    client.json().nummultby("doc1", ".b[0].a", 3) == 6
+
+
+@pytest.mark.redismod
+def test_strappend_dollar(client):
+
+    client.json().set(
+        "doc1", "$", {"a": "foo", "nested1": {
+            "a": "hello"}, "nested2": {"a": 31}}
+    )
+    # Test multi
+    client.json().strappend("doc1", "bar", "$..a") == [6, 8, None]
+
+    client.json().get("doc1", "$") == [
+        {"a": "foobar", "nested1": {"a": "hellobar"}, "nested2": {"a": 31}}
+    ]
+    # Test single
+    client.json().strappend("doc1", "baz", "$.nested1.a") == [11]
+
+    client.json().get("doc1", "$") == [
+        {"a": "foobar", "nested1": {"a": "hellobarbaz"}, "nested2": {"a": 31}}
+    ]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        client.json().strappend("non_existing_doc", "$..a", "err")
+
+    # Test multi
+    client.json().strappend("doc1", "bar", ".*.a") == 8
+    client.json().get("doc1", "$") == [
+        {"a": "foo", "nested1": {"a": "hellobar"}, "nested2": {"a": 31}}
+    ]
+
+    # Test missing path
+    with pytest.raises(exceptions.ResponseError):
+        client.json().strappend("doc1", "piu")
+
+
+@pytest.mark.redismod
+def test_strlen_dollar(client):
+
+    # Test multi
+    client.json().set(
+        "doc1", "$", {"a": "foo", "nested1": {
+            "a": "hello"}, "nested2": {"a": 31}}
+    )
+    assert client.json().strlen("doc1", "$..a") == [3, 5, None]
+
+    res2 = client.json().strappend("doc1", "bar", "$..a")
+    res1 = client.json().strlen("doc1", "$..a")
+    assert res1 == res2
+
+    # Test single
+    client.json().strlen("doc1", "$.nested1.a") == [8]
+    client.json().strlen("doc1", "$.nested2.a") == [None]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        client.json().strlen("non_existing_doc", "$..a")
+
+
+@pytest.mark.redismod
+def test_arrappend_dollar(client):
+    client.json().set(
+        "doc1",
+        "$",
+        {
+            "a": ["foo"],
+            "nested1": {"a": ["hello", None, "world"]},
+            "nested2": {"a": 31},
+        },
+    )
+    # Test multi
+    client.json().arrappend("doc1", "$..a", "bar", "racuda") == [3, 5, None]
+    assert client.json().get("doc1", "$") == [
+        {
+            "a": ["foo", "bar", "racuda"],
+            "nested1": {"a": ["hello", None, "world", "bar", "racuda"]},
+            "nested2": {"a": 31},
+        }
+    ]
+
+    # Test single
+    assert client.json().arrappend("doc1", "$.nested1.a", "baz") == [6]
+    assert client.json().get("doc1", "$") == [
+        {
+            "a": ["foo", "bar", "racuda"],
+            "nested1": {"a": ["hello", None, "world", "bar", "racuda", "baz"]},
+            "nested2": {"a": 31},
+        }
+    ]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        client.json().arrappend("non_existing_doc", "$..a")
+
+    # Test legacy
+    client.json().set(
+        "doc1",
+        "$",
+        {
+            "a": ["foo"],
+            "nested1": {"a": ["hello", None, "world"]},
+            "nested2": {"a": 31},
+        },
+    )
+    # Test multi (all paths are updated, but return result of last path)
+    assert client.json().arrappend("doc1", "..a", "bar", "racuda") == 5
+
+    assert client.json().get("doc1", "$") == [
+        {
+            "a": ["foo", "bar", "racuda"],
+            "nested1": {"a": ["hello", None, "world", "bar", "racuda"]},
+            "nested2": {"a": 31},
+        }
+    ]
+    # Test single
+    assert client.json().arrappend("doc1", ".nested1.a", "baz") == 6
+    assert client.json().get("doc1", "$") == [
+        {
+            "a": ["foo", "bar", "racuda"],
+            "nested1": {"a": ["hello", None, "world", "bar", "racuda", "baz"]},
+            "nested2": {"a": 31},
+        }
+    ]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        client.json().arrappend("non_existing_doc", "$..a")
+
+
+@pytest.mark.redismod
+def test_arrinsert_dollar(client):
+    client.json().set(
+        "doc1",
+        "$",
+        {
+            "a": ["foo"],
+            "nested1": {"a": ["hello", None, "world"]},
+            "nested2": {"a": 31},
+        },
+    )
+    # Test multi
+    assert client.json().arrinsert("doc1", "$..a", "1",
+                                   "bar", "racuda") == [3, 5, None]
+
+    assert client.json().get("doc1", "$") == [
+        {
+            "a": ["foo", "bar", "racuda"],
+            "nested1": {"a": ["hello", "bar", "racuda", None, "world"]},
+            "nested2": {"a": 31},
+        }
+    ]
+    # Test single
+    assert client.json().arrinsert("doc1", "$.nested1.a", -2, "baz") == [6]
+    assert client.json().get("doc1", "$") == [
+        {
+            "a": ["foo", "bar", "racuda"],
+            "nested1": {"a": ["hello", "bar", "racuda", "baz", None, "world"]},
+            "nested2": {"a": 31},
+        }
+    ]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        client.json().arrappend("non_existing_doc", "$..a")
+
+
+@pytest.mark.redismod
+def test_arrlen_dollar(client):
+
+    client.json().set(
+        "doc1",
+        "$",
+        {
+            "a": ["foo"],
+            "nested1": {"a": ["hello", None, "world"]},
+            "nested2": {"a": 31},
+        },
+    )
+
+    # Test multi
+    assert client.json().arrlen("doc1", "$..a") == [1, 3, None]
+    assert client.json().arrappend("doc1", "$..a", "non", "abba", "stanza") \
+        == [4, 6, None]
+
+    client.json().clear("doc1", "$.a")
+    assert client.json().arrlen("doc1", "$..a") == [0, 6, None]
+    # Test single
+    assert client.json().arrlen("doc1", "$.nested1.a") == [6]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        client.json().arrappend("non_existing_doc", "$..a")
+
+    client.json().set(
+        "doc1",
+        "$",
+        {
+            "a": ["foo"],
+            "nested1": {"a": ["hello", None, "world"]},
+            "nested2": {"a": 31},
+        },
+    )
+    # Test multi (return result of last path)
+    assert client.json().arrlen("doc1", "$..a") == [1, 3, None]
+    assert client.json().arrappend("doc1", "..a", "non", "abba", "stanza") == 6
+
+    # Test single
+    assert client.json().arrlen("doc1", ".nested1.a") == 6
+
+    # Test missing key
+    assert client.json().arrlen("non_existing_doc", "..a") is None
+
+
+@pytest.mark.redismod
+def test_arrpop_dollar(client):
+    client.json().set(
+        "doc1",
+        "$",
+        {
+            "a": ["foo"],
+            "nested1": {"a": ["hello", None, "world"]},
+            "nested2": {"a": 31},
+        },
+    )
+
+    # # # Test multi
+    assert client.json().arrpop("doc1", "$..a", 1) == ['"foo"', None, None]
+
+    assert client.json().get("doc1", "$") == [
+        {"a": [], "nested1": {"a": ["hello", "world"]}, "nested2": {"a": 31}}
+    ]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        client.json().arrpop("non_existing_doc", "..a")
+
+    # # Test legacy
+    client.json().set(
+        "doc1",
+        "$",
+        {
+            "a": ["foo"],
+            "nested1": {"a": ["hello", None, "world"]},
+            "nested2": {"a": 31},
+        },
+    )
+    # Test multi (all paths are updated, but return result of last path)
+    client.json().arrpop("doc1", "..a", "1") is None
+    assert client.json().get("doc1", "$") == [
+        {"a": [], "nested1": {"a": ["hello", "world"]}, "nested2": {"a": 31}}
+    ]
+
+    # # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        client.json().arrpop("non_existing_doc", "..a")
+
+
+@pytest.mark.redismod
+def test_arrtrim_dollar(client):
+
+    client.json().set(
+        "doc1",
+        "$",
+        {
+            "a": ["foo"],
+            "nested1": {"a": ["hello", None, "world"]},
+            "nested2": {"a": 31},
+        },
+    )
+    # Test multi
+    assert client.json().arrtrim("doc1", "$..a", "1", -1) == [0, 2, None]
+    assert client.json().get("doc1", "$") == [
+        {"a": [], "nested1": {"a": [None, "world"]}, "nested2": {"a": 31}}
+    ]
+
+    assert client.json().arrtrim("doc1", "$..a", "1", "1") == [0, 1, None]
+    assert client.json().get("doc1", "$") == [
+        {"a": [], "nested1": {"a": ["world"]}, "nested2": {"a": 31}}
+    ]
+    # Test single
+    assert client.json().arrtrim("doc1", "$.nested1.a", 1, 0) == [0]
+    assert client.json().get("doc1", "$") == [
+        {"a": [], "nested1": {"a": []}, "nested2": {"a": 31}}
+    ]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        client.json().arrtrim("non_existing_doc", "..a", "0", 1)
+
+    # Test legacy
+    client.json().set(
+        "doc1",
+        "$",
+        {
+            "a": ["foo"],
+            "nested1": {"a": ["hello", None, "world"]},
+            "nested2": {"a": 31},
+        },
+    )
+
+    # Test multi (all paths are updated, but return result of last path)
+    assert client.json().arrtrim("doc1", "..a", "1", "-1") == 2
+
+    # Test single
+    assert client.json().arrtrim("doc1", ".nested1.a", "1", "1") == 1
+    assert client.json().get("doc1", "$") == [
+        {"a": [], "nested1": {"a": ["world"]}, "nested2": {"a": 31}}
+    ]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        client.json().arrtrim("non_existing_doc", "..a", 1, 1)
+
+
+@pytest.mark.redismod
+def test_objkeys_dollar(client):
+    client.json().set(
+        "doc1",
+        "$",
+        {
+            "nested1": {"a": {"foo": 10, "bar": 20}},
+            "a": ["foo"],
+            "nested2": {"a": {"baz": 50}},
+        },
+    )
+
+    # Test single
+    assert client.json().objkeys("doc1", "$.nested1.a") == [["foo", "bar"]]
+
+    # Test legacy
+    assert client.json().objkeys("doc1", ".*.a") == ["foo", "bar"]
+    # Test single
+    assert client.json().objkeys("doc1", ".nested2.a") == ["baz"]
+
+    # Test missing key
+    assert client.json().objkeys("non_existing_doc", "..a") is None
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        client.json().objkeys("doc1", "$.nowhere")
+
+
+@pytest.mark.redismod
+def test_objlen_dollar(client):
+    client.json().set(
+        "doc1",
+        "$",
+        {
+            "nested1": {"a": {"foo": 10, "bar": 20}},
+            "a": ["foo"],
+            "nested2": {"a": {"baz": 50}},
+        },
+    )
+    # Test multi
+    assert client.json().objlen("doc1", "$..a") == [2, None, 1]
+    # Test single
+    assert client.json().objlen("doc1", "$.nested1.a") == [2]
+
+    # Test missing key
+    assert client.json().objlen("non_existing_doc", "$..a") is None
+
+    # Test missing path
+    with pytest.raises(exceptions.ResponseError):
+        client.json().objlen("doc1", "$.nowhere")
+
+    # Test legacy
+    assert client.json().objlen("doc1", ".*.a") == 2
+
+    # Test single
+    assert client.json().objlen("doc1", ".nested2.a") == 1
+
+    # Test missing key
+    assert client.json().objlen("non_existing_doc", "..a") is None
+
+    # Test missing path
+    with pytest.raises(exceptions.ResponseError):
+        client.json().objlen("doc1", ".nowhere")
+
+
+@pytest.mark.redismod
+def load_types_data(nested_key_name):
+    td = {
+        "object": {},
+        "array": [],
+        "string": "str",
+        "integer": 42,
+        "number": 1.2,
+        "boolean": False,
+        "null": None,
+    }
+    jdata = {}
+    types = []
+    for i, (k, v) in zip(range(1, len(td) + 1), iter(td.items())):
+        jdata["nested" + str(i)] = {nested_key_name: v}
+        types.append(k)
+
+    return jdata, types
+
+
+@pytest.mark.redismod
+def test_type_dollar(client):
+    jdata, jtypes = load_types_data("a")
+    client.json().set("doc1", "$", jdata)
+    # Test multi
+    assert client.json().type("doc1", "$..a") == jtypes
+
+    # Test single
+    assert client.json().type("doc1", "$.nested2.a") == [jtypes[1]]
+
+    # Test missing key
+    assert client.json().type("non_existing_doc", "..a") is None
+
+
+@pytest.mark.redismod
+def test_clear_dollar(client):
+
+    client.json().set(
+        "doc1",
+        "$",
+        {
+            "nested1": {"a": {"foo": 10, "bar": 20}},
+            "a": ["foo"],
+            "nested2": {"a": "claro"},
+            "nested3": {"a": {"baz": 50}},
+        },
+    )
+    # Test multi
+    assert client.json().clear("doc1", "$..a") == 3
+
+    assert client.json().get("doc1", "$") == [
+        {"nested1": {"a": {}}, "a": [], "nested2": {
+            "a": "claro"}, "nested3": {"a": {}}}
+    ]
+
+    # Test single
+    client.json().set(
+        "doc1",
+        "$",
+        {
+            "nested1": {"a": {"foo": 10, "bar": 20}},
+            "a": ["foo"],
+            "nested2": {"a": "claro"},
+            "nested3": {"a": {"baz": 50}},
+        },
+    )
+    assert client.json().clear("doc1", "$.nested1.a") == 1
+    assert client.json().get("doc1", "$") == [
+        {
+            "nested1": {"a": {}},
+            "a": ["foo"],
+            "nested2": {"a": "claro"},
+            "nested3": {"a": {"baz": 50}},
+        }
+    ]
+
+    # Test missing path (defaults to root)
+    assert client.json().clear("doc1") == 1
+    assert client.json().get("doc1", "$") == [{}]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        client.json().clear("non_existing_doc", "$..a")
+
+
+@pytest.mark.redismod
+def test_toggle_dollar(client):
+    client.json().set(
+        "doc1",
+        "$",
+        {
+            "a": ["foo"],
+            "nested1": {"a": False},
+            "nested2": {"a": 31},
+            "nested3": {"a": True},
+        },
+    )
+    # Test multi
+    assert client.json().toggle("doc1", "$..a") == [None, 1, None, 0]
+    assert client.json().get("doc1", "$") == [
+        {
+            "a": ["foo"],
+            "nested1": {"a": True},
+            "nested2": {"a": 31},
+            "nested3": {"a": False},
+        }
+    ]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        client.json().toggle("non_existing_doc", "$..a")
+
+
+@pytest.mark.redismod
+def test_debug_dollar(client):
+
+    jdata, jtypes = load_types_data("a")
+
+    client.json().set("doc1", "$", jdata)
+
+    # Test multi
+    assert client.json().debug("MEMORY", "doc1", "$..a") == [
+        72, 24, 24, 16, 16, 1, 0]
+
+    # Test single
+    assert client.json().debug("MEMORY", "doc1", "$.nested2.a") == [24]
+
+    # Test legacy
+    assert client.json().debug("MEMORY", "doc1", "..a") == 72
+
+    # Test missing path (defaults to root)
+    assert client.json().debug("MEMORY", "doc1") == 72
+
+    # Test missing key
+    assert client.json().debug("MEMORY", "non_existing_doc", "$..a") == []
+
+
+def test_resp_dollar(client):
+
+    data = {
+        "L1": {
+            "a": {
+                "A1_B1": 10,
+                "A1_B2": False,
+                "A1_B3": {
+                    "A1_B3_C1": None,
+                    "A1_B3_C2": [
+                        "A1_B3_C2_D1_1",
+                        "A1_B3_C2_D1_2",
+                        -19.5,
+                        "A1_B3_C2_D1_4",
+                        "A1_B3_C2_D1_5",
+                        {"A1_B3_C2_D1_6_E1": True},
+                    ],
+                    "A1_B3_C3": [1],
+                },
+                "A1_B4": {
+                    "A1_B4_C1": "foo",
+                },
+            },
+        },
+        "L2": {
+            "a": {
+                "A2_B1": 20,
+                "A2_B2": False,
+                "A2_B3": {
+                    "A2_B3_C1": None,
+                    "A2_B3_C2": [
+                        "A2_B3_C2_D1_1",
+                        "A2_B3_C2_D1_2",
+                        -37.5,
+                        "A2_B3_C2_D1_4",
+                        "A2_B3_C2_D1_5",
+                        {"A2_B3_C2_D1_6_E1": False},
+                    ],
+                    "A2_B3_C3": [2],
+                },
+                "A2_B4": {
+                    "A2_B4_C1": "bar",
+                },
+            },
+        },
+    }
+    client.json().set("doc1", "$", data)
+    # Test multi
+    res = client.json().resp("doc1", "$..a")
+    assert res == [
+        [
+            "{",
+            "A1_B1",
+            10,
+            "A1_B2",
+            "false",
+            "A1_B3",
+            [
+                "{",
+                "A1_B3_C1",
+                None,
+                "A1_B3_C2",
+                [
+                    "[",
+                    "A1_B3_C2_D1_1",
+                    "A1_B3_C2_D1_2",
+                    "-19.5",
+                    "A1_B3_C2_D1_4",
+                    "A1_B3_C2_D1_5",
+                    ["{", "A1_B3_C2_D1_6_E1", "true"],
+                ],
+                "A1_B3_C3",
+                ["[", 1],
+            ],
+            "A1_B4",
+            ["{", "A1_B4_C1", "foo"],
+        ],
+        [
+            "{",
+            "A2_B1",
+            20,
+            "A2_B2",
+            "false",
+            "A2_B3",
+            [
+                "{",
+                "A2_B3_C1",
+                None,
+                "A2_B3_C2",
+                [
+                    "[",
+                    "A2_B3_C2_D1_1",
+                    "A2_B3_C2_D1_2",
+                    "-37.5",
+                    "A2_B3_C2_D1_4",
+                    "A2_B3_C2_D1_5",
+                    ["{", "A2_B3_C2_D1_6_E1", "false"],
+                ],
+                "A2_B3_C3",
+                ["[", 2],
+            ],
+            "A2_B4",
+            ["{", "A2_B4_C1", "bar"],
+        ],
+    ]
+
+    # Test single
+    resSingle = client.json().resp("doc1", "$.L1.a")
+    assert resSingle == [
+        [
+            "{",
+            "A1_B1",
+            10,
+            "A1_B2",
+            "false",
+            "A1_B3",
+            [
+                "{",
+                "A1_B3_C1",
+                None,
+                "A1_B3_C2",
+                [
+                    "[",
+                    "A1_B3_C2_D1_1",
+                    "A1_B3_C2_D1_2",
+                    "-19.5",
+                    "A1_B3_C2_D1_4",
+                    "A1_B3_C2_D1_5",
+                    ["{", "A1_B3_C2_D1_6_E1", "true"],
+                ],
+                "A1_B3_C3",
+                ["[", 1],
+            ],
+            "A1_B4",
+            ["{", "A1_B4_C1", "foo"],
+        ]
+    ]
+
+    # Test missing path
+    with pytest.raises(exceptions.ResponseError):
+        client.json().resp("doc1", "$.nowhere")
+
+    # Test missing key
+    assert client.json().resp("non_existing_doc", "$..a") is None
+
+
+def test_arrindex_dollar(client):
+
+    client.json().set(
+        "store",
+        "$",
+        {
+            "store": {
+                "book": [
+                    {
+                        "category": "reference",
+                        "author": "Nigel Rees",
+                        "title": "Sayings of the Century",
+                        "price": 8.95,
+                        "size": [10, 20, 30, 40],
+                    },
+                    {
+                        "category": "fiction",
+                        "author": "Evelyn Waugh",
+                        "title": "Sword of Honour",
+                        "price": 12.99,
+                        "size": [50, 60, 70, 80],
+                    },
+                    {
+                        "category": "fiction",
+                        "author": "Herman Melville",
+                        "title": "Moby Dick",
+                        "isbn": "0-553-21311-3",
+                        "price": 8.99,
+                        "size": [5, 10, 20, 30],
+                    },
+                    {
+                        "category": "fiction",
+                        "author": "J. R. R. Tolkien",
+                        "title": "The Lord of the Rings",
+                        "isbn": "0-395-19395-8",
+                        "price": 22.99,
+                        "size": [5, 6, 7, 8],
+                    },
+                ],
+                "bicycle": {"color": "red", "price": 19.95},
+            }
+        },
+    )
+
+    assert client.json().get("store", "$.store.book[?(@.price<10)].size") == [
+        [10, 20, 30, 40],
+        [5, 10, 20, 30],
+    ]
+    assert client.json().arrindex(
+        "store", "$.store.book[?(@.price<10)].size", "20"
+    ) == [-1, -1]
+
+    # Test index of int scalar in multi values
+    client.json().set(
+        "test_num",
+        ".",
+        [
+            {"arr": [0, 1, 3.0, 3, 2, 1, 0, 3]},
+            {"nested1_found": {"arr": [5, 4, 3, 2, 1, 0, 1, 2, 3.0, 2, 4, 5]}},
+            {"nested2_not_found": {"arr": [2, 4, 6]}},
+            {"nested3_scalar": {"arr": "3"}},
+            [
+                {"nested41_not_arr": {"arr_renamed": [1, 2, 3]}},
+                {"nested42_empty_arr": {"arr": []}},
+            ],
+        ],
+    )
+
+    assert client.json().get("test_num", "$..arr") == [
+        [0, 1, 3.0, 3, 2, 1, 0, 3],
+        [5, 4, 3, 2, 1, 0, 1, 2, 3.0, 2, 4, 5],
+        [2, 4, 6],
+        "3",
+        [],
+    ]
+
+    assert client.json().arrindex("test_num", "$..arr", 3) == [
+        3, 2, -1, None, -1]
+
+    # Test index of double scalar in multi values
+    assert client.json().arrindex("test_num", "$..arr", 3.0) == [
+        2, 8, -1, None, -1]
+
+    # Test index of string scalar in multi values
+    client.json().set(
+        "test_string",
+        ".",
+        [
+            {"arr": ["bazzz", "bar", 2, "baz", 2, "ba", "baz", 3]},
+            {
+                "nested1_found": {
+                    "arr": [
+                        None,
+                        "baz2",
+                        "buzz", 2, 1, 0, 1, "2", "baz", 2, 4, 5]
+                }
+            },
+            {"nested2_not_found": {"arr": ["baz2", 4, 6]}},
+            {"nested3_scalar": {"arr": "3"}},
+            [
+                {"nested41_arr": {"arr_renamed": [1, "baz", 3]}},
+                {"nested42_empty_arr": {"arr": []}},
+            ],
+        ],
+    )
+    assert client.json().get("test_string", "$..arr") == [
+        ["bazzz", "bar", 2, "baz", 2, "ba", "baz", 3],
+        [None, "baz2", "buzz", 2, 1, 0, 1, "2", "baz", 2, 4, 5],
+        ["baz2", 4, 6],
+        "3",
+        [],
+    ]
+
+    assert client.json().arrindex("test_string", "$..arr", "baz") == [
+        3,
+        8,
+        -1,
+        None,
+        -1,
+    ]
+
+    assert client.json().arrindex("test_string", "$..arr", "baz", 2) == [
+        3,
+        8,
+        -1,
+        None,
+        -1,
+    ]
+    assert client.json().arrindex("test_string", "$..arr", "baz", 4) == [
+        6,
+        8,
+        -1,
+        None,
+        -1,
+    ]
+    assert client.json().arrindex("test_string", "$..arr", "baz", -5) == [
+        3,
+        8,
+        -1,
+        None,
+        -1,
+    ]
+    assert client.json().arrindex("test_string", "$..arr", "baz", 4, 7) == [
+        6,
+        -1,
+        -1,
+        None,
+        -1,
+    ]
+    assert client.json().arrindex("test_string", "$..arr", "baz", 4, -1) == [
+        6,
+        8,
+        -1,
+        None,
+        -1,
+    ]
+    assert client.json().arrindex("test_string", "$..arr", "baz", 4, 0) == [
+        6,
+        8,
+        -1,
+        None,
+        -1,
+    ]
+    assert client.json().arrindex("test_string", "$..arr", "5", 7, -1) == [
+        -1,
+        -1,
+        -1,
+        None,
+        -1,
+    ]
+    assert client.json().arrindex("test_string", "$..arr", "5", 7, 0) == [
+        -1,
+        -1,
+        -1,
+        None,
+        -1,
+    ]
+
+    # Test index of None scalar in multi values
+    client.json().set(
+        "test_None",
+        ".",
+        [
+            {"arr": ["bazzz", "None", 2, None, 2, "ba", "baz", 3]},
+            {
+                "nested1_found": {
+                    "arr": [
+                        "zaz",
+                        "baz2",
+                        "buzz",
+                        2, 1, 0, 1, "2", None, 2, 4, 5]
+                }
+            },
+            {"nested2_not_found": {"arr": ["None", 4, 6]}},
+            {"nested3_scalar": {"arr": None}},
+            [
+                {"nested41_arr": {"arr_renamed": [1, None, 3]}},
+                {"nested42_empty_arr": {"arr": []}},
+            ],
+        ],
+    )
+    assert client.json().get("test_None", "$..arr") == [
+        ["bazzz", "None", 2, None, 2, "ba", "baz", 3],
+        ["zaz", "baz2", "buzz", 2, 1, 0, 1, "2", None, 2, 4, 5],
+        ["None", 4, 6],
+        None,
+        [],
+    ]
+
+    # Fail with none-scalar value
+    with pytest.raises(exceptions.ResponseError):
+        client.json().arrindex(
+            "test_None", "$..nested42_empty_arr.arr", {"arr": []})
+
+    # Do not fail with none-scalar value in legacy mode
+    assert (
+        client.json().arrindex(
+            "test_None", ".[4][1].nested42_empty_arr.arr", '{"arr":[]}'
+        )
+        == -1
+    )
+
+    # Test legacy (path begins with dot)
+    # Test index of int scalar in single value
+    assert client.json().arrindex("test_num", ".[0].arr", 3) == 3
+    assert client.json().arrindex("test_num", ".[0].arr", 9) == -1
+
+    with pytest.raises(exceptions.ResponseError):
+        client.json().arrindex("test_num", ".[0].arr_not", 3)
+    # Test index of string scalar in single value
+    assert client.json().arrindex("test_string", ".[0].arr", "baz") == 3
+    assert client.json().arrindex("test_string", ".[0].arr", "faz") == -1
+    # Test index of None scalar in single value
+    assert client.json().arrindex("test_None", ".[0].arr", "None") == 1
+    assert client.json().arrindex(
+        "test_None",
+        "..nested2_not_found.arr",
+        "None") == 0
+
+
+def test_decoders_and_unstring():
+    assert unstring("4") == 4
+    assert unstring("45.55") == 45.55
+    assert unstring("hello world") == "hello world"
+
+    assert decode_list(b"45.55") == 45.55
+    assert decode_list("45.55") == 45.55
+    assert decode_list(['hello', b'world']) == ['hello', 'world']
diff --git a/tests/testdata/jsontestdata.py b/tests/testdata/jsontestdata.py
new file mode 100644
index 0000000000..0a920cc55b
--- /dev/null
+++ b/tests/testdata/jsontestdata.py
@@ -0,0 +1,617 @@
+nested_large_key = r"""
+{
+  "jkra": [
+    154,
+    4472,
+    [
+      8567,
+      false,
+      363.84,
+      5276,
+      "ha",
+      "rizkzs",
+      93
+    ],
+    false
+  ],
+  "hh": 20.77,
+  "mr": 973.217,
+  "ihbe": [
+    68,
+    [
+      true,
+      {
+        "lqe": [
+          486.363,
+          [
+            true,
+            {
+              "mp": {
+                "ory": "rj",
+                "qnl": "tyfrju",
+                "hf": None
+              },
+              "uooc": 7418,
+              "xela": 20,
+              "bt": 7014,
+              "ia": 547,
+              "szec": 68.73
+            },
+            None
+          ],
+          3622,
+          "iwk",
+          None
+        ],
+        "fepi": 19.954,
+        "ivu": {
+          "rmnd": 65.539,
+          "bk": 98,
+          "nc": "bdg",
+          "dlb": {
+            "hw": {
+              "upzz": [
+                true,
+                {
+                  "nwb": [
+                    4259.47
+                  ],
+                  "nbt": "yl"
+                },
+                false,
+                false,
+                65,
+                [
+                  [
+                    [],
+                    629.149,
+                    "lvynqh",
+                    "hsk",
+                    [],
+                    2011.932,
+                    true,
+                    []
+                  ],
+                  None,
+                  "ymbc",
+                  None
+                ],
+                "aj",
+                97.425,
+                "hc",
+                58
+              ]
+            },
+            "jq": true,
+            "bi": 3333,
+            "hmf": "pl",
+            "mrbj": [
+              true,
+              false
+            ]
+          }
+        },
+        "hfj": "lwk",
+        "utdl": "aku",
+        "alqb": [
+          74,
+          534.389,
+          7235,
+          [
+            None,
+            false,
+            None
+          ]
+        ]
+      },
+      None,
+      {
+        "lbrx": {
+          "vm": "ubdrbb"
+        },
+        "tie": "iok",
+        "br": "ojro"
+      },
+      70.558,
+      [
+        {
+          "mmo": None,
+          "dryu": None
+        }
+      ]
+    ],
+    true,
+    None,
+    false,
+    {
+      "jqun": 98,
+      "ivhq": [
+        [
+          [
+            675.936,
+            [
+              520.15,
+              1587.4,
+              false
+            ],
+            "jt",
+            true,
+            {
+              "bn": None,
+              "ygn": "cve",
+              "zhh": true,
+              "aak": 9165,
+              "skx": true,
+              "qqsk": 662.28
+            },
+            {
+              "eio": 9933.6,
+              "agl": None,
+              "pf": false,
+              "kv": 5099.631,
+              "no": None,
+              "shly": 58
+            },
+            [
+              None,
+              [
+                "uiundu",
+                726.652,
+                false,
+                94.92,
+                259.62,
+                {
+                  "ntqu": None,
+                  "frv": None,
+                  "rvop": "upefj",
+                  "jvdp": {
+                    "nhx": [],
+                    "bxnu": {},
+                    "gs": None,
+                    "mqho": None,
+                    "xp": 65,
+                    "ujj": {}
+                  },
+                  "ts": false,
+                  "kyuk": [
+                    false,
+                    58,
+                    {},
+                    "khqqif"
+                  ]
+                },
+                167,
+                true,
+                "bhlej",
+                53
+              ],
+              64,
+              {
+                "eans": "wgzfo",
+                "zfgb": 431.67,
+                "udy": [
+                  {
+                    "gnt": [],
+                    "zeve": {}
+                  },
+                  {
+                    "pg": {},
+                    "vsuc": {},
+                    "dw": 19,
+                    "ffo": "uwsh",
+                    "spk": "pjdyam",
+                    "mc": [],
+                    "wunb": {},
+                    "qcze": 2271.15,
+                    "mcqx": None
+                  },
+                  "qob"
+                ],
+                "wo": "zy"
+              },
+              {
+                "dok": None,
+                "ygk": None,
+                "afdw": [
+                  7848,
+                  "ah",
+                  None
+                ],
+                "foobar": 3.141592,
+                "wnuo": {
+                  "zpvi": {
+                    "stw": true,
+                    "bq": {},
+                    "zord": true,
+                    "omne": 3061.73,
+                    "bnwm": "wuuyy",
+                    "tuv": 7053,
+                    "lepv": None,
+                    "xap": 94.26
+                  },
+                  "nuv": false,
+                  "hhza": 539.615,
+                  "rqw": {
+                    "dk": 2305,
+                    "wibo": 7512.9,
+                    "ytbc": 153,
+                    "pokp": None,
+                    "whzd": None,
+                    "judg": [],
+                    "zh": None
+                  },
+                  "bcnu": "ji",
+                  "yhqu": None,
+                  "gwc": true,
+                  "smp": {
+                    "fxpl": 75,
+                    "gc": [],
+                    "vx": 9352.895,
+                    "fbzf": 4138.27,
+                    "tiaq": 354.306,
+                    "kmfb": {},
+                    "fxhy": [],
+                    "af": 94.46,
+                    "wg": {},
+                    "fb": None
+                  }
+                },
+                "zvym": 2921,
+                "hhlh": [
+                  45,
+                  214.345
+                ],
+                "vv": "gqjoz"
+              },
+              [
+                "uxlu",
+                None,
+                "utl",
+                64,
+                [
+                  2695
+                ],
+                [
+                  false,
+                  None,
+                  [
+                    "cfcrl",
+                    [],
+                    [],
+                    562,
+                    1654.9,
+                    {},
+                    None,
+                    "sqzud",
+                    934.6
+                  ],
+                  {
+                    "hk": true,
+                    "ed": "lodube",
+                    "ye": "ziwddj",
+                    "ps": None,
+                    "ir": {},
+                    "heh": false
+                  },
+                  true,
+                  719,
+                  50.56,
+                  [
+                    99,
+                    6409,
+                    None,
+                    4886,
+                    "esdtkt",
+                    {},
+                    None
+                  ],
+                  [
+                    false,
+                    "bkzqw"
+                  ]
+                ],
+                None,
+                6357
+              ],
+              {
+                "asvv": 22.873,
+                "vqm": {
+                  "drmv": 68.12,
+                  "tmf": 140.495,
+                  "le": None,
+                  "sanf": [
+                    true,
+                    [],
+                    "vyawd",
+                    false,
+                    76.496,
+                    [],
+                    "sdfpr",
+                    33.16,
+                    "nrxy",
+                    "antje"
+                  ],
+                  "yrkh": 662.426,
+                  "vxj": true,
+                  "sn": 314.382,
+                  "eorg": None
+                },
+                "bavq": [
+                  21.18,
+                  8742.66,
+                  {
+                    "eq": "urnd"
+                  },
+                  56.63,
+                  "fw",
+                  [
+                    {},
+                    "pjtr",
+                    None,
+                    "apyemk",
+                    [],
+                    [],
+                    false,
+                    {}
+                  ],
+                  {
+                    "ho": None,
+                    "ir": 124,
+                    "oevp": 159,
+                    "xdrv": 6705,
+                    "ff": [],
+                    "sx": false
+                  },
+                  true,
+                  None,
+                  true
+                ],
+                "zw": "qjqaap",
+                "hr": {
+                  "xz": 32,
+                  "mj": 8235.32,
+                  "yrtv": None,
+                  "jcz": "vnemxe",
+                  "ywai": [
+                    None,
+                    564,
+                    false,
+                    "vbr",
+                    54.741
+                  ],
+                  "vw": 82,
+                  "wn": true,
+                  "pav": true
+                },
+                "vxa": 881
+              },
+              "bgt",
+              "vuzk",
+              857
+            ]
+          ]
+        ],
+        None,
+        None,
+        {
+          "xyzl": "nvfff"
+        },
+        true,
+        13
+      ],
+      "npd": None,
+      "ha": [
+        [
+          "du",
+          [
+            980,
+            {
+              "zdhd": [
+                129.986,
+                [
+                  "liehns",
+                  453,
+                  {
+                    "fuq": false,
+                    "dxpn": {},
+                    "hmpx": 49,
+                    "zb": "gbpt",
+                    "vdqc": None,
+                    "ysjg": false,
+                    "gug": 7990.66
+                  },
+                  "evek",
+                  [
+                    {}
+                  ],
+                  "dfywcu",
+                  9686,
+                  None
+                ]
+              ],
+              "gpi": {
+                "gt": {
+                  "qe": 7460,
+                  "nh": "nrn",
+                  "czj": 66.609,
+                  "jwd": true,
+                  "rb": "azwwe",
+                  "fj": {
+                    "csn": true,
+                    "foobar": 1.61803398875,
+                    "hm": "efsgw",
+                    "zn": "vbpizt",
+                    "tjo": 138.15,
+                    "teo": {},
+                    "hecf": [],
+                    "ls": false
+                  }
+                },
+                "xlc": 7916,
+                "jqst": 48.166,
+                "zj": "ivctu"
+              },
+              "jl": 369.27,
+              "mxkx": None,
+              "sh": [
+                true,
+                373,
+                false,
+                "sdis",
+                6217,
+                {
+                  "ernm": None,
+                  "srbo": 90.798,
+                  "py": 677,
+                  "jgrq": None,
+                  "zujl": None,
+                  "odsm": {
+                    "pfrd": None,
+                    "kwz": "kfvjzb",
+                    "ptkp": false,
+                    "pu": None,
+                    "xty": None,
+                    "ntx": [],
+                    "nq": 48.19,
+                    "lpyx": []
+                  },
+                  "ff": None,
+                  "rvi": [
+                    "ych",
+                    {},
+                    72,
+                    9379,
+                    7897.383,
+                    true,
+                    {},
+                    999.751,
+                    false
+                  ]
+                },
+                true
+              ],
+              "ghe": [
+                24,
+                {
+                  "lpr": true,
+                  "qrs": true
+                },
+                true,
+                false,
+                7951.94,
+                true,
+                2690.54,
+                [
+                  93,
+                  None,
+                  None,
+                  "rlz",
+                  true,
+                  "ky",
+                  true
+                ]
+              ],
+              "vet": false,
+              "olle": None
+            },
+            "jzm",
+            true
+          ],
+          None,
+          None,
+          19.17,
+          7145,
+          "ipsmk"
+        ],
+        false,
+        {
+          "du": 6550.959,
+          "sps": 8783.62,
+          "nblr": {
+            "dko": 9856.616,
+            "lz": {
+              "phng": "dj"
+            },
+            "zeu": 766,
+            "tn": "dkr"
+          },
+          "xa": "trdw",
+          "gn": 9875.687,
+          "dl": None,
+          "vuql": None
+        },
+        {
+          "qpjo": None,
+          "das": {
+            "or": {
+              "xfy": None,
+              "xwvs": 4181.86,
+              "yj": 206.325,
+              "bsr": [
+                "qrtsh"
+              ],
+              "wndm": {
+                "ve": 56,
+                "jyqa": true,
+                "ca": None
+              },
+              "rpd": 9906,
+              "ea": "dvzcyt"
+            },
+            "xwnn": 9272,
+            "rpx": "zpr",
+            "srzg": {
+              "beo": 325.6,
+              "sq": None,
+              "yf": None,
+              "nu": [
+                377,
+                "qda",
+                true
+              ],
+              "sfz": "zjk"
+            },
+            "kh": "xnpj",
+            "rk": None,
+            "hzhn": [
+              None
+            ],
+            "uio": 6249.12,
+            "nxrv": 1931.635,
+            "pd": None
+          },
+          "pxlc": true,
+          "mjer": false,
+          "hdev": "msr",
+          "er": None
+        },
+        "ug",
+        None,
+        "yrfoix",
+        503.89,
+        563
+      ],
+      "tcy": 300,
+      "me": 459.17,
+      "tm": [
+        134.761,
+        "jcoels",
+        None
+      ],
+      "iig": 945.57,
+      "ad": "be"
+    },
+    "ltpdm",
+    None,
+    14.53
+  ],
+  "xi": "gxzzs",
+  "zfpw": 1564.87,
+  "ow": None,
+  "tm": [
+    46,
+    876.85
+  ],
+  "xejv": None
+}
+"""  # noqa

From 9804bdc52bdf4e85e66ae11246453be5dc40a9c0 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 4 Nov 2021 13:55:33 +0200
Subject: [PATCH 0227/1164] publish to pypi as releases are generated with the
 release drafter (#1647)

---
 .github/workflows/pypi-publish.yaml | 31 +++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 .github/workflows/pypi-publish.yaml

diff --git a/.github/workflows/pypi-publish.yaml b/.github/workflows/pypi-publish.yaml
new file mode 100644
index 0000000000..b842c36670
--- /dev/null
+++ b/.github/workflows/pypi-publish.yaml
@@ -0,0 +1,31 @@
+name: Publish tag to Pypi
+
+on:
+  release:
+    types: [published]
+
+jobs:
+
+  build_and_package:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: install python
+        uses: actions/setup-python@v2
+        with:
+          python-version: 3.0
+      - name: Install dev tools
+        run: |
+          pip install -r dev_requirements.txt
+          pip install twine wheel
+
+      - name: Build package
+        run: |
+          python setup.py build
+          python setup.py dist bdist_wheel
+
+      - name: Publish to Pypi
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          user: __token__
+          password: ${{ secrets.PYPI_API_TOKEN }}

From 4257ceb1e5b438d9e7ea4d2ac0c74609c2771749 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 4 Nov 2021 14:16:06 +0200
Subject: [PATCH 0228/1164] rc1 (#1668)

---
 redis/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/__init__.py b/redis/__init__.py
index 2458b5bc49..003f8a2ecf 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -31,7 +31,7 @@ def int_or_str(value):
         return value
 
 
-__version__ = '4.0.0b3'
+__version__ = '4.0.0rc1'
 VERSION = tuple(map(int_or_str, __version__.split('.')))
 
 __all__ = [

From bba75187931af84dd21c91bcf1b3bd422c9aed72 Mon Sep 17 00:00:00 2001
From: Eugene Morozov <jmv@emorozov.net>
Date: Mon, 8 Nov 2021 09:59:14 +0300
Subject: [PATCH 0229/1164] Fix garbage collection deadlock (#1578)

---
 dev_requirements.txt |  1 +
 redis/connection.py  |  9 ++++++---
 tests/test_pubsub.py | 12 ++++++++++++
 3 files changed, 19 insertions(+), 3 deletions(-)

diff --git a/dev_requirements.txt b/dev_requirements.txt
index aa9d8f9eee..0ca7727049 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -1,5 +1,6 @@
 flake8>=3.9.2
 pytest==6.2.5
+pytest-timeout==2.0.1
 tox==3.24.4
 tox-docker==3.1.0
 invoke==1.6.0
diff --git a/redis/connection.py b/redis/connection.py
index f5d6a38221..cb9acb4595 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -10,6 +10,7 @@
 import socket
 import threading
 import warnings
+import weakref
 
 from redis.exceptions import (
     AuthenticationError,
@@ -562,7 +563,7 @@ def __del__(self):
             pass
 
     def register_connect_callback(self, callback):
-        self._connect_callbacks.append(callback)
+        self._connect_callbacks.append(weakref.WeakMethod(callback))
 
     def clear_connect_callbacks(self):
         self._connect_callbacks = []
@@ -588,8 +589,10 @@ def connect(self):
 
         # run any user callbacks. right now the only internal callback
         # is for pubsub channel/pattern resubscription
-        for callback in self._connect_callbacks:
-            callback(self)
+        for ref in self._connect_callbacks:
+            callback = ref()
+            if callback:
+                callback(self)
 
     def _connect(self):
         "Create a TCP socket connection"
diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index 6a4f0aafa4..4be6c7a305 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -570,3 +570,15 @@ def exception_handler(ex, pubsub, thread):
         assert event.wait(timeout=1.0)
         pubsub_thread.join(timeout=1.0)
         assert not pubsub_thread.is_alive()
+
+
+class TestPubSubDeadlock:
+    @pytest.mark.timeout(30, method='thread')
+    def test_pubsub_deadlock(self, master_host):
+        pool = redis.ConnectionPool(host=master_host)
+        r = redis.Redis(connection_pool=pool)
+
+        for i in range(60):
+            p = r.pubsub()
+            p.subscribe("my-channel-1", "my-channel-2")
+            pool.reset()

From ea04bae5e082ff71aaa1f9a9d07d9bda10b7696e Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Mon, 8 Nov 2021 16:51:54 +0100
Subject: [PATCH 0230/1164] Restore zrange functionality for older versions of
 Redis (#1670)

---
 redis/commands/core.py | 62 ++++++++++++++++++++++++++++++++----------
 tests/test_commands.py |  2 +-
 2 files changed, 49 insertions(+), 15 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 8dba5a2abf..90997ff931 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -2536,9 +2536,14 @@ def zrevrange(self, name, start, end, withscores=False,
 
         ``score_cast_func`` a callable used to cast the score return value
         """
-        return self.zrange(name, start, end, desc=True,
-                           withscores=withscores,
-                           score_cast_func=score_cast_func)
+        pieces = ['ZREVRANGE', name, start, end]
+        if withscores:
+            pieces.append(b'WITHSCORES')
+        options = {
+            'withscores': withscores,
+            'score_cast_func': score_cast_func
+        }
+        return self.execute_command(*pieces, **options)
 
     def zrangestore(self, dest, name, start, end,
                     byscore=False, bylex=False, desc=False,
@@ -2575,7 +2580,13 @@ def zrangebylex(self, name, min, max, start=None, num=None):
         If ``start`` and ``num`` are specified, then return a slice of the
         range.
         """
-        return self.zrange(name, min, max, bylex=True, offset=start, num=num)
+        if (start is not None and num is None) or \
+                (num is not None and start is None):
+            raise DataError("``start`` and ``num`` must both be specified")
+        pieces = ['ZRANGEBYLEX', name, min, max]
+        if start is not None and num is not None:
+            pieces.extend([b'LIMIT', start, num])
+        return self.execute_command(*pieces)
 
     def zrevrangebylex(self, name, max, min, start=None, num=None):
         """
@@ -2585,8 +2596,13 @@ def zrevrangebylex(self, name, max, min, start=None, num=None):
         If ``start`` and ``num`` are specified, then return a slice of the
         range.
         """
-        return self.zrange(name, max, min, desc=True,
-                           bylex=True, offset=start, num=num)
+        if (start is not None and num is None) or \
+                (num is not None and start is None):
+            raise DataError("``start`` and ``num`` must both be specified")
+        pieces = ['ZREVRANGEBYLEX', name, max, min]
+        if start is not None and num is not None:
+            pieces.extend(['LIMIT', start, num])
+        return self.execute_command(*pieces)
 
     def zrangebyscore(self, name, min, max, start=None, num=None,
                       withscores=False, score_cast_func=float):
@@ -2602,10 +2618,19 @@ def zrangebyscore(self, name, min, max, start=None, num=None,
 
         `score_cast_func`` a callable used to cast the score return value
         """
-        return self.zrange(name, min, max, byscore=True,
-                           offset=start, num=num,
-                           withscores=withscores,
-                           score_cast_func=score_cast_func)
+        if (start is not None and num is None) or \
+                (num is not None and start is None):
+            raise DataError("``start`` and ``num`` must both be specified")
+        pieces = ['ZRANGEBYSCORE', name, min, max]
+        if start is not None and num is not None:
+            pieces.extend(['LIMIT', start, num])
+        if withscores:
+            pieces.append('WITHSCORES')
+        options = {
+            'withscores': withscores,
+            'score_cast_func': score_cast_func
+        }
+        return self.execute_command(*pieces, **options)
 
     def zrevrangebyscore(self, name, max, min, start=None, num=None,
                          withscores=False, score_cast_func=float):
@@ -2621,10 +2646,19 @@ def zrevrangebyscore(self, name, max, min, start=None, num=None,
 
         ``score_cast_func`` a callable used to cast the score return value
         """
-        return self.zrange(name, max, min, desc=True,
-                           byscore=True, offset=start,
-                           num=num, withscores=withscores,
-                           score_cast_func=score_cast_func)
+        if (start is not None and num is None) or \
+                (num is not None and start is None):
+            raise DataError("``start`` and ``num`` must both be specified")
+        pieces = ['ZREVRANGEBYSCORE', name, max, min]
+        if start is not None and num is not None:
+            pieces.extend(['LIMIT', start, num])
+        if withscores:
+            pieces.append('WITHSCORES')
+        options = {
+            'withscores': withscores,
+            'score_cast_func': score_cast_func
+        }
+        return self.execute_command(*pieces, **options)
 
     def zrank(self, name, value):
         """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 723612af6b..37a369851b 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1866,7 +1866,7 @@ def test_zrange(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
         assert r.zrange('a', 0, 1) == [b'a1', b'a2']
         assert r.zrange('a', 1, 2) == [b'a2', b'a3']
-        assert r.zrange('a', 0, 2, desc=True) == [b'a3', b'a2', b'a1']
+        assert r.zrange('a', 0, 2) == [b'a1', b'a2', b'a3']
 
         # withscores
         assert r.zrange('a', 0, 1, withscores=True) == \

From 325fcd9e15bf0125f9a60012d7eb7824e7b4ab33 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Mon, 8 Nov 2021 16:52:32 +0100
Subject: [PATCH 0231/1164] Fix georadius tests (#1672)

---
 tests/test_commands.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/tests/test_commands.py b/tests/test_commands.py
index 37a369851b..6d4ab008ab 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2744,7 +2744,7 @@ def test_georadius_with(self, r):
         assert r.georadius('barcelona', 2, 1, 1, unit='km',
                            withdist=True, withcoord=True, withhash=True) == []
 
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt('6.2.0')
     def test_georadius_count(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
                  (2.1873744593677, 41.406342043777, 'place2')
@@ -2806,6 +2806,12 @@ def test_georadiusmember(self, r):
                  (2.187376320362091, 41.40634178640635)],
                 [b'place1', 0.0, 3471609698139488,
                  (2.1909382939338684, 41.433790281840835)]]
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_georadiusmember_count(self, r):
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
+                 (2.1873744593677, 41.406342043777, b'\x80place2')
+        r.geoadd('barcelona', values)
         assert r.georadiusbymember('barcelona', 'place1', 4000,
                                    count=1, any=True) == \
                [b'\x80place2']

From fea7b85dde375a228f485d27737de66592b28848 Mon Sep 17 00:00:00 2001
From: Terence Honles <terence@honles.com>
Date: Mon, 8 Nov 2021 16:54:24 +0100
Subject: [PATCH 0232/1164] Export Sentinel, and SSL like other classes (#1671)

---
 README.md         | 14 +++++++++++++-
 redis/__init__.py | 10 ++++++++++
 redis/sentinel.py |  4 +++-
 3 files changed, 26 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index a01f820326..f03053e691 100644
--- a/README.md
+++ b/README.md
@@ -365,7 +365,7 @@ Connecting redis-py to the Sentinel instance(s) is easy. You can use a
 Sentinel connection to discover the master and slaves network addresses:
 
 ``` pycon
->>> from redis.sentinel import Sentinel
+>>> from redis import Sentinel
 >>> sentinel = Sentinel([('localhost', 26379)], socket_timeout=0.1)
 >>> sentinel.discover_master('mymaster')
 ('127.0.0.1', 6379)
@@ -373,6 +373,18 @@ Sentinel connection to discover the master and slaves network addresses:
 [('127.0.0.1', 6380)]
 ```
 
+To connect to a sentinel which uses SSL ([see SSL
+connections](#ssl-connections) for more examples of SSL configurations):
+
+``` pycon
+>>> from redis import Sentinel
+>>> sentinel = Sentinel([('localhost', 26379)],
+                        ssl=True,
+                        ssl_ca_certs='/etc/ssl/certs/ca-certificates.crt')
+>>> sentinel.discover_master('mymaster')
+('127.0.0.1', 6379)
+```
+
 You can also create Redis client connections from a Sentinel instance.
 You can connect to either the master (for write operations) or a slave
 (for read-only operations).
diff --git a/redis/__init__.py b/redis/__init__.py
index 003f8a2ecf..603f8464a2 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -6,6 +6,12 @@
     SSLConnection,
     UnixDomainSocketConnection
 )
+from redis.sentinel import (
+    Sentinel,
+    SentinelConnectionPool,
+    SentinelManagedConnection,
+    SentinelManagedSSLConnection,
+)
 from redis.utils import from_url
 from redis.exceptions import (
     AuthenticationError,
@@ -51,6 +57,10 @@ def int_or_str(value):
     'Redis',
     'RedisError',
     'ResponseError',
+    'Sentinel',
+    'SentinelConnectionPool',
+    'SentinelManagedConnection',
+    'SentinelManagedSSLConnection',
     'SSLConnection',
     'StrictRedis',
     'TimeoutError',
diff --git a/redis/sentinel.py b/redis/sentinel.py
index 740d92f983..17dd75bf46 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -80,7 +80,9 @@ class SentinelConnectionPool(ConnectionPool):
 
     def __init__(self, service_name, sentinel_manager, **kwargs):
         kwargs['connection_class'] = kwargs.get(
-            'connection_class', SentinelManagedConnection)
+            'connection_class',
+            SentinelManagedSSLConnection if kwargs.pop('ssl', False)
+            else SentinelManagedConnection)
         self.is_master = kwargs.pop('is_master', True)
         self.check_connection = kwargs.pop('check_connection', False)
         super().__init__(**kwargs)

From 599f5a991eda770799a1aea23848b1442019deeb Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 9 Nov 2021 11:24:48 +0200
Subject: [PATCH 0233/1164] Re-enable pipeline support for JSON and TimeSeries
 (#1674)

---
 redis/commands/helpers.py             | 32 +++++++++++++++++++++
 redis/commands/json/__init__.py       | 27 ++++++++++++++++++
 redis/commands/json/commands.py       | 18 ++++++++++++
 redis/commands/timeseries/__init__.py | 41 +++++++++++++++++++++------
 tests/test_json.py                    | 32 ++++++++++++++-------
 tests/test_timeseries.py              | 31 +++++++++-----------
 tox.ini                               | 11 +++++--
 7 files changed, 154 insertions(+), 38 deletions(-)

diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
index 2a4298cb2f..22cb6223b9 100644
--- a/redis/commands/helpers.py
+++ b/redis/commands/helpers.py
@@ -1,3 +1,7 @@
+import random
+import string
+
+
 def list_or_args(keys, args):
     # returns a single new list combining keys and args
     try:
@@ -42,3 +46,31 @@ def parse_to_list(response):
         except TypeError:
             res.append(None)
     return res
+
+
+def random_string(length=10):
+    """
+    Returns a random N character long string.
+    """
+    return "".join(  # nosec
+        random.choice(string.ascii_lowercase) for x in range(length)
+    )
+
+
+def quote_string(v):
+    """
+    RedisGraph strings must be quoted,
+    quote_string wraps given v with quotes incase
+    v is a string.
+    """
+
+    if isinstance(v, bytes):
+        v = v.decode()
+    elif not isinstance(v, str):
+        return v
+    if len(v) == 0:
+        return '""'
+
+    v = v.replace('"', '\\"')
+
+    return '"{}"'.format(v)
diff --git a/redis/commands/json/__init__.py b/redis/commands/json/__init__.py
index d00627efce..d634dbd3f4 100644
--- a/redis/commands/json/__init__.py
+++ b/redis/commands/json/__init__.py
@@ -6,6 +6,7 @@
 )
 from ..helpers import nativestr
 from .commands import JSONCommands
+import redis
 
 
 class JSON(JSONCommands):
@@ -91,3 +92,29 @@ def _decode(self, obj):
     def _encode(self, obj):
         """Get the encoder."""
         return self.__encoder__.encode(obj)
+
+    def pipeline(self, transaction=True, shard_hint=None):
+        """Creates a pipeline for the JSON module, that can be used for executing
+        JSON commands, as well as classic core commands.
+
+        Usage example:
+
+        r = redis.Redis()
+        pipe = r.json().pipeline()
+        pipe.jsonset('foo', '.', {'hello!': 'world'})
+        pipe.jsonget('foo')
+        pipe.jsonget('notakey')
+        """
+        p = Pipeline(
+            connection_pool=self.client.connection_pool,
+            response_callbacks=self.MODULE_CALLBACKS,
+            transaction=transaction,
+            shard_hint=shard_hint,
+        )
+        p._encode = self._encode
+        p._decode = self._decode
+        return p
+
+
+class Pipeline(JSONCommands, redis.client.Pipeline):
+    """Pipeline for the module."""
diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index 716741c19b..4436f6aa34 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -154,6 +154,9 @@ def set(self, name, path, obj, nx=False, xx=False, decode_keys=False):
         ``xx`` if set to True, set ``value`` only if it exists.
         ``decode_keys`` If set to True, the keys of ``obj`` will be decoded
         with utf-8.
+
+        For the purpose of using this within a pipeline, this command is also
+        aliased to jsonset.
         """
         if decode_keys:
             obj = decode_dict_keys(obj)
@@ -212,3 +215,18 @@ def debug(self, subcommand, key=None, path=Path.rootPath()):
             pieces.append(key)
             pieces.append(str(path))
         return self.execute_command("JSON.DEBUG", *pieces)
+
+    @deprecated(version='4.0.0',
+                reason='redisjson-py supported this, call get directly.')
+    def jsonget(self, *args, **kwargs):
+        return self.get(*args, **kwargs)
+
+    @deprecated(version='4.0.0',
+                reason='redisjson-py supported this, call get directly.')
+    def jsonmget(self, *args, **kwargs):
+        return self.mget(*args, **kwargs)
+
+    @deprecated(version='4.0.0',
+                reason='redisjson-py supported this, call get directly.')
+    def jsonset(self, *args, **kwargs):
+        return self.set(*args, **kwargs)
diff --git a/redis/commands/timeseries/__init__.py b/redis/commands/timeseries/__init__.py
index db9c3a55d4..83fa17082e 100644
--- a/redis/commands/timeseries/__init__.py
+++ b/redis/commands/timeseries/__init__.py
@@ -1,4 +1,4 @@
-from redis.client import bool_ok
+import redis.client
 
 from .utils import (
     parse_range,
@@ -37,12 +37,12 @@ class TimeSeries(TimeSeriesCommands):
     def __init__(self, client=None, version=None, **kwargs):
         """Create a new RedisTimeSeries client."""
         # Set the module commands' callbacks
-        MODULE_CALLBACKS = {
-            CREATE_CMD: bool_ok,
-            ALTER_CMD: bool_ok,
-            CREATERULE_CMD: bool_ok,
+        self.MODULE_CALLBACKS = {
+            CREATE_CMD: redis.client.bool_ok,
+            ALTER_CMD: redis.client.bool_ok,
+            CREATERULE_CMD: redis.client.bool_ok,
             DEL_CMD: int,
-            DELETERULE_CMD: bool_ok,
+            DELETERULE_CMD: redis.client.bool_ok,
             RANGE_CMD: parse_range,
             REVRANGE_CMD: parse_range,
             MRANGE_CMD: parse_m_range,
@@ -57,5 +57,30 @@ def __init__(self, client=None, version=None, **kwargs):
         self.execute_command = client.execute_command
         self.MODULE_VERSION = version
 
-        for k in MODULE_CALLBACKS:
-            self.client.set_response_callback(k, MODULE_CALLBACKS[k])
+        for key, value in self.MODULE_CALLBACKS.items():
+            self.client.set_response_callback(key, value)
+
+    def pipeline(self, transaction=True, shard_hint=None):
+        """Creates a pipeline for the TimeSeries module, that can be used
+        for executing only TimeSeries commands and core commands.
+
+        Usage example:
+
+        r = redis.Redis()
+        pipe = r.ts().pipeline()
+        for i in range(100):
+            pipeline.add("with_pipeline", i, 1.1 * i)
+        pipeline.execute()
+
+        """
+        p = Pipeline(
+            connection_pool=self.client.connection_pool,
+            response_callbacks=self.MODULE_CALLBACKS,
+            transaction=transaction,
+            shard_hint=shard_hint,
+        )
+        return p
+
+
+class Pipeline(TimeSeriesCommands, redis.client.Pipeline):
+    """Pipeline for the module."""
diff --git a/tests/test_json.py b/tests/test_json.py
index 19b0c3262e..b3f38f7ff2 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -275,16 +275,28 @@ def test_objlen(client):
     assert len(obj) == client.json().objlen("obj")
 
 
-# @pytest.mark.pipeline
-# @pytest.mark.redismod
-# def test_pipelineshouldsucceed(client):
-#     p = client.json().pipeline()
-#     p.set("foo", Path.rootPath(), "bar")
-#     p.get("foo")
-#     p.delete("foo")
-#     assert [True, "bar", 1] == p.execute()
-#     assert client.keys() == []
-#     assert client.get("foo") is None
+@pytest.mark.pipeline
+@pytest.mark.redismod
+def test_json_commands_in_pipeline(client):
+    p = client.json().pipeline()
+    p.set("foo", Path.rootPath(), "bar")
+    p.get("foo")
+    p.delete("foo")
+    assert [True, "bar", 1] == p.execute()
+    assert client.keys() == []
+    assert client.get("foo") is None
+
+    # now with a true, json object
+    client.flushdb()
+    p = client.json().pipeline()
+    d = {"hello": "world", "oh": "snap"}
+    p.jsonset("foo", Path.rootPath(), d)
+    p.jsonget("foo")
+    p.exists("notarealkey")
+    p.delete("foo")
+    assert [True, d, 0, 1] == p.execute()
+    assert client.keys() == []
+    assert client.get("foo") is None
 
 
 @pytest.mark.redismod
diff --git a/tests/test_timeseries.py b/tests/test_timeseries.py
index b2df3feda5..d3d474ff6f 100644
--- a/tests/test_timeseries.py
+++ b/tests/test_timeseries.py
@@ -49,10 +49,6 @@ def testAlter(client):
     assert 10 == client.ts().info(1).retention_msecs
 
 
-#     pipe = client.ts().pipeline()
-# assert pipe.create(2)
-
-
 @pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
 def testAlterDiplicatePolicy(client):
@@ -568,20 +564,19 @@ def testQueryIndex(client):
     assert [2] == client.ts().queryindex(["Taste=That"])
 
 
-#
-# @pytest.mark.redismod
-# @pytest.mark.pipeline
-# def testPipeline(client):
-#     pipeline = client.ts().pipeline()
-#     pipeline.create("with_pipeline")
-#     for i in range(100):
-#         pipeline.add("with_pipeline", i, 1.1 * i)
-#     pipeline.execute()
-
-#     info = client.ts().info("with_pipeline")
-#     assert info.lastTimeStamp == 99
-#     assert info.total_samples == 100
-#     assert client.ts().get("with_pipeline")[1] == 99 * 1.1
+@pytest.mark.redismod
+@pytest.mark.pipeline
+def test_pipeline(client):
+    pipeline = client.ts().pipeline()
+    pipeline.create("with_pipeline")
+    for i in range(100):
+        pipeline.add("with_pipeline", i, 1.1 * i)
+    pipeline.execute()
+
+    info = client.ts().info("with_pipeline")
+    assert info.lastTimeStamp == 99
+    assert info.total_samples == 100
+    assert client.ts().get("with_pipeline")[1] == 99 * 1.1
 
 
 @pytest.mark.redismod
diff --git a/tox.ini b/tox.ini
index f09b3a831c..1d4da0829b 100644
--- a/tox.ini
+++ b/tox.ini
@@ -121,6 +121,13 @@ basepython = pypy3
 
 [flake8]
 exclude =
-    .venv,
+    *.egg-info,
+    *.pyc,
+    .git,
     .tox,
-    whitelist.py
+    .venv*,
+    build,
+    dist,
+    docker,
+    venv*,
+    whitelist.py
\ No newline at end of file

From 2a52f3f84554f645c5d532e6043c46418fada5e4 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 9 Nov 2021 12:17:09 +0200
Subject: [PATCH 0234/1164] Removing dependency on six (#1676)

---
 redis/commands/search/_util.py       |  7 ++-----
 redis/commands/search/aggregation.py |  8 +++-----
 redis/commands/search/commands.py    | 14 ++++++--------
 redis/commands/search/document.py    |  5 +----
 redis/commands/search/query.py       |  5 +----
 redis/commands/search/querystring.py |  5 +----
 redis/commands/search/result.py      |  6 ++----
 redis/commands/search/suggestion.py  |  3 +--
 8 files changed, 17 insertions(+), 36 deletions(-)

diff --git a/redis/commands/search/_util.py b/redis/commands/search/_util.py
index b4ac19f336..dd1dff33dd 100644
--- a/redis/commands/search/_util.py
+++ b/redis/commands/search/_util.py
@@ -1,10 +1,7 @@
-import six
-
-
 def to_string(s):
-    if isinstance(s, six.string_types):
+    if isinstance(s, str):
         return s
-    elif isinstance(s, six.binary_type):
+    elif isinstance(s, bytes):
         return s.decode("utf-8", "ignore")
     else:
         return s  # Not a string we care about
diff --git a/redis/commands/search/aggregation.py b/redis/commands/search/aggregation.py
index df912f896b..b391d1f55b 100644
--- a/redis/commands/search/aggregation.py
+++ b/redis/commands/search/aggregation.py
@@ -1,5 +1,3 @@
-from six import string_types
-
 FIELDNAME = object()
 
 
@@ -93,7 +91,7 @@ def __init__(self, fields, reducers):
         if not reducers:
             raise ValueError("Need at least one reducer")
 
-        fields = [fields] if isinstance(fields, string_types) else fields
+        fields = [fields] if isinstance(fields, str) else fields
         reducers = [reducers] if isinstance(reducers, Reducer) else reducers
 
         self.fields = fields
@@ -299,7 +297,7 @@ def sort_by(self, *fields, **kwargs):
             .sort_by(Desc("@paid"), max=10)
         ```
         """
-        if isinstance(fields, (string_types, SortDirection)):
+        if isinstance(fields, (str, SortDirection)):
             fields = [fields]
 
         max = kwargs.get("max", 0)
@@ -318,7 +316,7 @@ def filter(self, expressions):
         - **fields**: Fields to group by. This can either be a single string,
             or a list of strings.
         """
-        if isinstance(expressions, string_types):
+        if isinstance(expressions, str):
             expressions = [expressions]
 
         for expression in expressions:
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 6074d2959b..296fb258ac 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -1,6 +1,5 @@
 import itertools
 import time
-import six
 
 from .document import Document
 from .result import Result
@@ -308,9 +307,8 @@ def load_document(self, id):
         Load a single document by id
         """
         fields = self.client.hgetall(id)
-        if six.PY3:
-            f2 = {to_string(k): to_string(v) for k, v in fields.items()}
-            fields = f2
+        f2 = {to_string(k): to_string(v) for k, v in fields.items()}
+        fields = f2
 
         try:
             del fields["id"]
@@ -337,13 +335,13 @@ def info(self):
         """
 
         res = self.client.execute_command(INFO_CMD, self.index_name)
-        it = six.moves.map(to_string, res)
-        return dict(six.moves.zip(it, it))
+        it = map(to_string, res)
+        return dict(zip(it, it))
 
     def _mk_query_args(self, query):
         args = [self.index_name]
 
-        if isinstance(query, six.string_types):
+        if isinstance(query, str):
             # convert the query from a text to a query object
             query = Query(query)
         if not isinstance(query, Query):
@@ -448,7 +446,7 @@ def spellcheck(self, query, distance=None, include=None, exclude=None):
             return corrections
 
         for _correction in raw:
-            if isinstance(_correction, six.integer_types) and _correction == 0:
+            if isinstance(_correction, int) and _correction == 0:
                 continue
 
             if len(_correction) != 3:
diff --git a/redis/commands/search/document.py b/redis/commands/search/document.py
index 26ede34ef1..0d4255db17 100644
--- a/redis/commands/search/document.py
+++ b/redis/commands/search/document.py
@@ -1,6 +1,3 @@
-import six
-
-
 class Document(object):
     """
     Represents a single document in a result set
@@ -9,7 +6,7 @@ class Document(object):
     def __init__(self, id, payload=None, **fields):
         self.id = id
         self.payload = payload
-        for k, v in six.iteritems(fields):
+        for k, v in fields.items():
             setattr(self, k, v)
 
     def __repr__(self):
diff --git a/redis/commands/search/query.py b/redis/commands/search/query.py
index e2db7a422b..85a8255334 100644
--- a/redis/commands/search/query.py
+++ b/redis/commands/search/query.py
@@ -1,6 +1,3 @@
-import six
-
-
 class Query(object):
     """
     Query is used to build complex queries that have more parameters than just
@@ -66,7 +63,7 @@ def _mk_field_list(self, fields):
         if not fields:
             return []
         return  \
-            [fields] if isinstance(fields, six.string_types) else list(fields)
+            [fields] if isinstance(fields, str) else list(fields)
 
     def summarize(self, fields=None, context_len=None,
                   num_frags=None, sep=None):
diff --git a/redis/commands/search/querystring.py b/redis/commands/search/querystring.py
index f5f59b7e53..aecd3b82f5 100644
--- a/redis/commands/search/querystring.py
+++ b/redis/commands/search/querystring.py
@@ -1,6 +1,3 @@
-from six import string_types, integer_types
-
-
 def tags(*t):
     """
     Indicate that the values should be matched to a tag field
@@ -186,7 +183,7 @@ def __init__(self, *children, **kwparams):
         kvparams = {}
         for k, v in kwparams.items():
             curvals = kvparams.setdefault(k, [])
-            if isinstance(v, (string_types, integer_types, float)):
+            if isinstance(v, (str, int, float)):
                 curvals.append(Value.make_value(v))
             elif isinstance(v, Value):
                 curvals.append(v)
diff --git a/redis/commands/search/result.py b/redis/commands/search/result.py
index afc83f87cd..9cd922ac1d 100644
--- a/redis/commands/search/result.py
+++ b/redis/commands/search/result.py
@@ -1,5 +1,3 @@
-from six.moves import xrange, zip as izip
-
 from .document import Document
 from ._util import to_string
 
@@ -32,7 +30,7 @@ def __init__(
 
         offset = 2 if with_scores else 1
 
-        for i in xrange(1, len(res), step):
+        for i in range(1, len(res), step):
             id = to_string(res[i])
             payload = to_string(res[i + offset]) if has_payload else None
             # fields_offset = 2 if has_payload else 1
@@ -44,7 +42,7 @@ def __init__(
                 fields = (
                     dict(
                         dict(
-                            izip(
+                            zip(
                                 map(to_string, res[i + fields_offset][::2]),
                                 map(to_string, res[i + fields_offset][1::2]),
                             )
diff --git a/redis/commands/search/suggestion.py b/redis/commands/search/suggestion.py
index 550c514823..3401af94eb 100644
--- a/redis/commands/search/suggestion.py
+++ b/redis/commands/search/suggestion.py
@@ -1,4 +1,3 @@
-from six.moves import xrange
 from ._util import to_string
 
 
@@ -45,7 +44,7 @@ def __init__(self, with_scores, with_payloads, ret):
         self._sugs = ret
 
     def __iter__(self):
-        for i in xrange(0, len(self._sugs), self.sugsize):
+        for i in range(0, len(self._sugs), self.sugsize):
             ss = self._sugs[i]
             score = float(self._sugs[i + self._scoreidx]) \
                 if self.with_scores else 1.0

From d93b5f32173c4ea43677ec594506298de95802ee Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 9 Nov 2021 12:17:18 +0200
Subject: [PATCH 0235/1164] 4.0.0 rc2 versioning (#1677)

---
 redis/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/__init__.py b/redis/__init__.py
index 603f8464a2..c0dd690bc9 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -37,7 +37,7 @@ def int_or_str(value):
         return value
 
 
-__version__ = '4.0.0rc1'
+__version__ = '4.0.0rc2'
 VERSION = tuple(map(int_or_str, __version__.split('.')))
 
 __all__ = [

From 3837e0d7bbe93622ce9ee40d754c630070e4f8e0 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 9 Nov 2021 13:14:19 +0200
Subject: [PATCH 0236/1164] Docstring improvements for Redis class (#1675)

---
 redis/client.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 935d9dd891..f2f1eed08c 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -613,8 +613,10 @@ class Redis(RedisModuleCommands, CoreCommands, object):
     This abstract class provides a Python interface to all Redis commands
     and an implementation of the Redis protocol.
 
-    Connection and Pipeline derive from this, implementing how
-    the commands are sent and received to the Redis server
+    Pipelines derive from this, implementing how
+    the commands are sent and received to the Redis server. Based on
+    configuration, an instance will either use a ConnectionPool, or
+    Connection object to talk to redis.
     """
     RESPONSE_CALLBACKS = {
         **string_keys_to_dict(

From b6c10985083d5d4ee7c66324096c68cc69598854 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 9 Nov 2021 13:23:45 +0200
Subject: [PATCH 0237/1164] Test function renames, to match standards (#1679)

---
 tests/test_timeseries.py | 40 ++++++++++++++++++++--------------------
 1 file changed, 20 insertions(+), 20 deletions(-)

diff --git a/tests/test_timeseries.py b/tests/test_timeseries.py
index d3d474ff6f..99c60838f2 100644
--- a/tests/test_timeseries.py
+++ b/tests/test_timeseries.py
@@ -11,7 +11,7 @@ def client(modclient):
 
 
 @pytest.mark.redismod
-def testCreate(client):
+def test_create(client):
     assert client.ts().create(1)
     assert client.ts().create(2, retention_msecs=5)
     assert client.ts().create(3, labels={"Redis": "Labs"})
@@ -28,7 +28,7 @@ def testCreate(client):
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
-def testCreateDuplicatePolicy(client):
+def test_create_duplicate_policy(client):
     # Test for duplicate policy
     for duplicate_policy in ["block", "last", "first", "min", "max"]:
         ts_name = "time-serie-ooo-{0}".format(duplicate_policy)
@@ -38,7 +38,7 @@ def testCreateDuplicatePolicy(client):
 
 
 @pytest.mark.redismod
-def testAlter(client):
+def test_alter(client):
     assert client.ts().create(1)
     assert 0 == client.ts().info(1).retention_msecs
     assert client.ts().alter(1, retention_msecs=10)
@@ -51,7 +51,7 @@ def testAlter(client):
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
-def testAlterDiplicatePolicy(client):
+def test_alter_diplicate_policy(client):
     assert client.ts().create(1)
     info = client.ts().info(1)
     assert info.duplicate_policy is None
@@ -61,7 +61,7 @@ def testAlterDiplicatePolicy(client):
 
 
 @pytest.mark.redismod
-def testAdd(client):
+def test_add(client):
     assert 1 == client.ts().add(1, 1, 1)
     assert 2 == client.ts().add(2, 2, 3, retention_msecs=10)
     assert 3 == client.ts().add(3, 3, 2, labels={"Redis": "Labs"})
@@ -83,7 +83,7 @@ def testAdd(client):
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
-def testAddDuplicatePolicy(client):
+def test_add_duplicate_policy(client):
 
     # Test for duplicate policy BLOCK
     assert 1 == client.ts().add("time-serie-add-ooo-block", 1, 5.0)
@@ -125,14 +125,14 @@ def testAddDuplicatePolicy(client):
 
 
 @pytest.mark.redismod
-def testMAdd(client):
+def test_madd(client):
     client.ts().create("a")
     assert [1, 2, 3] == \
         client.ts().madd([("a", 1, 5), ("a", 2, 10), ("a", 3, 15)])
 
 
 @pytest.mark.redismod
-def testIncrbyDecrby(client):
+def test_incrby_decrby(client):
     for _ in range(100):
         assert client.ts().incrby(1, 1)
         sleep(0.001)
@@ -161,7 +161,7 @@ def testIncrbyDecrby(client):
 
 
 @pytest.mark.redismod
-def testCreateAndDeleteRule(client):
+def test_create_and_delete_rule(client):
     # test rule creation
     time = 100
     client.ts().create(1)
@@ -183,7 +183,7 @@ def testCreateAndDeleteRule(client):
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
-def testDelRange(client):
+def test_del_range(client):
     try:
         client.ts().delete("test", 0, 100)
     except Exception as e:
@@ -197,7 +197,7 @@ def testDelRange(client):
 
 
 @pytest.mark.redismod
-def testRange(client):
+def test_range(client):
     for i in range(100):
         client.ts().add(1, i, i % 7)
     assert 100 == len(client.ts().range(1, 0, 200))
@@ -219,7 +219,7 @@ def testRange(client):
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
-def testRangeAdvanced(client):
+def test_range_advanced(client):
     for i in range(100):
         client.ts().add(1, i, i % 7)
         client.ts().add(1, i + 200, i % 7)
@@ -244,7 +244,7 @@ def testRangeAdvanced(client):
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
-def testRevRange(client):
+def test_rev_range(client):
     for i in range(100):
         client.ts().add(1, i, i % 7)
     assert 100 == len(client.ts().range(1, 0, 200))
@@ -318,7 +318,7 @@ def testMultiRange(client):
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
-def testMultiRangeAdvanced(client):
+def test_multi_range_advanced(client):
     client.ts().create(1, labels={"Test": "This", "team": "ny"})
     client.ts().create(
         2,
@@ -399,7 +399,7 @@ def testMultiRangeAdvanced(client):
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
-def testMultiReverseRange(client):
+def test_multi_reverse_range(client):
     client.ts().create(1, labels={"Test": "This", "team": "ny"})
     client.ts().create(
         2,
@@ -496,7 +496,7 @@ def testMultiReverseRange(client):
 
 
 @pytest.mark.redismod
-def testGet(client):
+def test_get(client):
     name = "test"
     client.ts().create(name)
     assert client.ts().get(name) is None
@@ -507,7 +507,7 @@ def testGet(client):
 
 
 @pytest.mark.redismod
-def testMGet(client):
+def test_mget(client):
     client.ts().create(1, labels={"Test": "This"})
     client.ts().create(2, labels={"Test": "This", "Taste": "That"})
     act_res = client.ts().mget(["Test=This"])
@@ -528,7 +528,7 @@ def testMGet(client):
 
 
 @pytest.mark.redismod
-def testInfo(client):
+def test_info(client):
     client.ts().create(
         1,
         retention_msecs=5,
@@ -556,7 +556,7 @@ def testInfoDuplicatePolicy(client):
 
 
 @pytest.mark.redismod
-def testQueryIndex(client):
+def test_query_index(client):
     client.ts().create(1, labels={"Test": "This"})
     client.ts().create(2, labels={"Test": "This", "Taste": "That"})
     assert 2 == len(client.ts().queryindex(["Test=This"]))
@@ -580,7 +580,7 @@ def test_pipeline(client):
 
 
 @pytest.mark.redismod
-def testUncompressed(client):
+def test_uncompressed(client):
     client.ts().create("compressed")
     client.ts().create("uncompressed", uncompressed=True)
     compressed_info = client.ts().info("compressed")

From c19f120e069ab805d2a337beaed3de064e5875f7 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 9 Nov 2021 13:25:31 +0200
Subject: [PATCH 0238/1164] Sleep for flaky search test (#1680)

---
 tests/test_search.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/tests/test_search.py b/tests/test_search.py
index 926b5ff3af..7c9fdb288e 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -680,6 +680,10 @@ def test_alias():
     # update alias and ensure new results
     ftindex2.aliasupdate("spaceballs")
     alias_client2 = getClient().ft("spaceballs")
+
+    if os.environ.get("GITHUB_WORKFLOW", None) is not None:
+        time.sleep(5)
+
     res = alias_client2.search("*").docs[0]
     assert "index2:yogurt" == res.id
 

From f5160f57fcfe48838cc2082cd3c1c2b86d3bd36c Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 9 Nov 2021 16:18:29 +0200
Subject: [PATCH 0239/1164] Tests to validate built python packages (#1678)

---
 .github/workflows/install_and_test.sh | 41 +++++++++++++
 .github/workflows/integration.yaml    | 86 ++++++++++++++-------------
 dev_requirements.txt                  |  1 +
 tasks.py                              |  2 +-
 4 files changed, 88 insertions(+), 42 deletions(-)
 create mode 100755 .github/workflows/install_and_test.sh

diff --git a/.github/workflows/install_and_test.sh b/.github/workflows/install_and_test.sh
new file mode 100755
index 0000000000..330102eb41
--- /dev/null
+++ b/.github/workflows/install_and_test.sh
@@ -0,0 +1,41 @@
+#!/bin/bash
+
+set -e
+
+SUFFIX=$1
+if [ -z ${SUFFIX} ]; then
+    echo "Supply valid python package extension such as whl or tar.gz. Exiting."
+    exit 3
+fi
+
+script=`pwd`/${BASH_SOURCE[0]}
+HERE=`dirname ${script}`
+ROOT=`realpath ${HERE}/../..`
+
+cd ${ROOT}
+DESTENV=${ROOT}/.venvforinstall
+if [ -d ${DESTENV} ]; then
+    rm -rf ${DESTENV}
+fi
+python -m venv ${DESTENV}
+source ${DESTENV}/bin/activate
+pip install --upgrade --quiet pip
+pip install --quiet -r dev_requirements.txt
+invoke devenv
+invoke package
+
+# find packages
+PKG=`ls ${ROOT}/dist/*.${SUFFIX}`
+ls -l ${PKG}
+
+TESTDIR=${ROOT}/STAGETESTS
+if [ -d ${TESTDIR} ]; then
+    rm -rf ${TESTDIR}
+fi
+mkdir ${TESTDIR}
+cp -R ${ROOT}/tests ${TESTDIR}/tests
+cd ${TESTDIR}
+
+# install, run tests
+pip install ${PKG}
+pytest
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 4a073948cb..5384996c70 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -6,61 +6,65 @@ on:
       - 'docs/**'
       - '**/*.rst'
       - '**/*.md'
+    branches:
+      - master
   pull_request:
     branches:
       - master
 
 jobs:
 
-  lint:
-    name: Code linters
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
-      - name: install python
-        uses: actions/setup-python@v2
-        with:
-          python-version: 3.9
-      - name: run code linters
-        run: |
-          pip install -r dev_requirements.txt
-          invoke linters
+   lint:
+     name: Code linters
+     runs-on: ubuntu-latest
+     steps:
+       - uses: actions/checkout@v2
+       - name: install python
+         uses: actions/setup-python@v2
+         with:
+           python-version: 3.9
+       - name: run code linters
+         run: |
+           pip install -r dev_requirements.txt
+           invoke linters
 
-  run-tests:
-    runs-on: ubuntu-latest
-    strategy:
-      max-parallel: 6
-      matrix:
-        python-version: ['3.6', '3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
-    env:
-      ACTIONS_ALLOW_UNSECURE_COMMANDS: true
-    name: Python ${{ matrix.python-version }} tests
-    steps:
-      - uses: actions/checkout@v2
-      - name: install python
-        uses: actions/setup-python@v2
-        with:
-          python-version: ${{ matrix.python-version }}
-      - name: run tests
-        run: |
-          pip install -r dev_requirements.txt
-          invoke tests
-      - name: Upload codecov coverage
-        uses: codecov/codecov-action@v2
-        with:
-          fail_ci_if_error: false
-          token: ${{ secrets.CODECOV_TOKEN }}
+   run-tests:
+     runs-on: ubuntu-latest
+     strategy:
+       max-parallel: 6
+       matrix:
+         python-version: ['3.6', '3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
+     env:
+       ACTIONS_ALLOW_UNSECURE_COMMANDS: true
+     name: Python ${{ matrix.python-version }} tests
+     steps:
+       - uses: actions/checkout@v2
+       - name: install python
+         uses: actions/setup-python@v2
+         with:
+           python-version: ${{ matrix.python-version }}
+       - name: run tests
+         run: |
+           pip install -r dev_requirements.txt
+           invoke tests
+       - name: Upload codecov coverage
+         uses: codecov/codecov-action@v2
+         with:
+           fail_ci_if_error: false
+           token: ${{ secrets.CODECOV_TOKEN }}
 
-  build_package:
+   build_and_test_package:
     name: Validate building and installing the package
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        extension: ['tar.gz', 'whl']
     steps:
       - uses: actions/checkout@v2
       - name: install python
         uses: actions/setup-python@v2
         with:
           python-version: 3.9
-      - name: build and install
+      - name: Run installed unit tests
         run: |
-          pip install invoke
-          invoke package
+          bash .github/workflows/install_and_test.sh ${{ matrix.extension }}
diff --git a/dev_requirements.txt b/dev_requirements.txt
index 0ca7727049..6ea50550e8 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -6,3 +6,4 @@ tox-docker==3.1.0
 invoke==1.6.0
 pytest-cov>=3.0.0
 vulture>=2.3.0
+wheel>=0.30.0
diff --git a/tasks.py b/tasks.py
index 4ca2242fa9..306291c97f 100644
--- a/tasks.py
+++ b/tasks.py
@@ -56,4 +56,4 @@ def clean(c):
 @task
 def package(c):
     """Create the python packages"""
-    run("python setup.py build install")
+    run("python setup.py sdist bdist_wheel")

From 2d7ceb0b110212fe50b8fa296f99f32f9a622ea7 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 10 Nov 2021 10:35:45 +0200
Subject: [PATCH 0240/1164] Test to validate custom JSON decoders (#1681)

---
 dev_requirements.txt |  1 +
 tests/test_json.py   | 17 +++++++++++++++++
 2 files changed, 18 insertions(+)

diff --git a/dev_requirements.txt b/dev_requirements.txt
index 6ea50550e8..7f099cb541 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -6,4 +6,5 @@ tox-docker==3.1.0
 invoke==1.6.0
 pytest-cov>=3.0.0
 vulture>=2.3.0
+ujson>=4.2.0
 wheel>=0.30.0
diff --git a/tests/test_json.py b/tests/test_json.py
index b3f38f7ff2..abc5776316 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -1003,6 +1003,7 @@ def test_debug_dollar(client):
     assert client.json().debug("MEMORY", "non_existing_doc", "$..a") == []
 
 
+@pytest.mark.redismod
 def test_resp_dollar(client):
 
     data = {
@@ -1149,6 +1150,7 @@ def test_resp_dollar(client):
     assert client.json().resp("non_existing_doc", "$..a") is None
 
 
+@pytest.mark.redismod
 def test_arrindex_dollar(client):
 
     client.json().set(
@@ -1397,3 +1399,18 @@ def test_decoders_and_unstring():
     assert decode_list(b"45.55") == 45.55
     assert decode_list("45.55") == 45.55
     assert decode_list(['hello', b'world']) == ['hello', 'world']
+
+
+@pytest.mark.redismod
+def test_custom_decoder(client):
+    import ujson
+    import json
+
+    cj = client.json(encoder=ujson, decoder=ujson)
+    assert cj.set("foo", Path.rootPath(), "bar")
+    assert "bar" == cj.get("foo")
+    assert cj.get("baz") is None
+    assert 1 == cj.delete("foo")
+    assert client.exists("foo") == 0
+    assert not isinstance(cj.__encoder__, json.JSONEncoder)
+    assert not isinstance(cj.__decoder__, json.JSONDecoder)

From a1d4e3e1373aa41ed607fb0358b1a2e09bf18f57 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 10 Nov 2021 10:39:12 +0200
Subject: [PATCH 0241/1164] Updating codecov rules (#1689)

---
 codecov.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/codecov.yml b/codecov.yml
index 48cdae1902..449ec0c50f 100644
--- a/codecov.yml
+++ b/codecov.yml
@@ -1,3 +1,7 @@
+ignore:
+  - "benchmarks/**"
+  - "tasks.py"
+
 codecov:
   require_ci_to_pass: yes
 

From 939fead8d375cdc90c205ebd81b26d986d6d0dc3 Mon Sep 17 00:00:00 2001
From: Ariel Shtul <ariel.shtul@redislabs.com>
Date: Wed, 10 Nov 2021 11:42:05 +0200
Subject: [PATCH 0242/1164] Adding RediSearch/RedisJSON tests (#1691)

---
 tests/test_search.py | 99 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 99 insertions(+)

diff --git a/tests/test_search.py b/tests/test_search.py
index 7c9fdb288e..4175c53271 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1221,3 +1221,102 @@ def test_syndump(client):
         "baby": ["id2"],
         "offspring": ["id1"],
     }
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.2.0", "search")
+def test_create_json_with_alias(client):
+    """
+    Create definition with IndexType.JSON as index type (ON JSON) with two
+    fields with aliases, and use json client to test it.
+    """
+    definition = IndexDefinition(prefix=["king:"], index_type=IndexType.JSON)
+    client.ft().create_index(
+        (TextField("$.name", as_name="name"),
+         NumericField("$.num", as_name="num")),
+        definition=definition
+    )
+
+    client.json().set("king:1", Path.rootPath(), {"name": "henry",
+                                                  "num": 42})
+    client.json().set("king:2", Path.rootPath(), {"name": "james",
+                                                  "num": 3.14})
+
+    res = client.ft().search("@name:henry")
+    assert res.docs[0].id == "king:1"
+    assert res.docs[0].json == '{"name":"henry","num":42}'
+    assert res.total == 1
+
+    res = client.ft().search("@num:[0 10]")
+    assert res.docs[0].id == "king:2"
+    assert res.docs[0].json == '{"name":"james","num":3.14}'
+    assert res.total == 1
+
+    # Tests returns an error if path contain special characters (user should
+    # use an alias)
+    with pytest.raises(Exception):
+        client.ft().search("@$.name:henry")
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.2.0", "search")
+def test_json_with_multipath(client):
+    """
+    Create definition with IndexType.JSON as index type (ON JSON),
+    and use json client to test it.
+    """
+    definition = IndexDefinition(prefix=["king:"], index_type=IndexType.JSON)
+    client.ft().create_index(
+        (TagField("$..name", as_name="name")),
+        definition=definition
+    )
+
+    client.json().set("king:1", Path.rootPath(),
+                      {"name": "henry", "country": {"name": "england"}})
+
+    res = client.ft().search("@name:{henry}")
+    assert res.docs[0].id == "king:1"
+    assert res.docs[0].json == '{"name":"henry","country":{"name":"england"}}'
+    assert res.total == 1
+
+    res = client.ft().search("@name:{england}")
+    assert res.docs[0].id == "king:1"
+    assert res.docs[0].json == '{"name":"henry","country":{"name":"england"}}'
+    assert res.total == 1
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.2.0", "search")
+def test_json_with_jsonpath(client):
+    definition = IndexDefinition(index_type=IndexType.JSON)
+    client.ft().create_index(
+        (TextField('$["prod:name"]', as_name="name"),
+         TextField('$.prod:name', as_name="name_unsupported")),
+        definition=definition
+    )
+
+    client.json().set("doc:1", Path.rootPath(), {"prod:name": "RediSearch"})
+
+    # query for a supported field succeeds
+    res = client.ft().search(Query("@name:RediSearch"))
+    assert res.total == 1
+    assert res.docs[0].id == "doc:1"
+    assert res.docs[0].json == '{"prod:name":"RediSearch"}'
+
+    # query for an unsupported field fails
+    res = client.ft().search("@name_unsupported:RediSearch")
+    assert res.total == 0
+
+    # return of a supported field succeeds
+    res = client.ft().search(Query("@name:RediSearch").return_field("name"))
+    assert res.total == 1
+    assert res.docs[0].id == "doc:1"
+    assert res.docs[0].name == 'RediSearch'
+
+    # return of an unsupported field fails
+    res = client.ft().search(Query("@name:RediSearch")
+                             .return_field("name_unsupported"))
+    assert res.total == 1
+    assert res.docs[0].id == "doc:1"
+    with pytest.raises(Exception):
+        res.docs[0].name_unsupported

From e07bd9464d6ce226e3db9a5eaf95bc2ecfe8e034 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 10 Nov 2021 15:09:09 +0200
Subject: [PATCH 0243/1164] Response parsing occasionally fails to parse floats
 (#1692)

---
 redis/commands/helpers.py |  5 +++-
 tests/test_helpers.py     | 49 +++++++++++++++++++++++++++++++++++++++
 2 files changed, 53 insertions(+), 1 deletion(-)
 create mode 100644 tests/test_helpers.py

diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
index 22cb6223b9..46eb83d603 100644
--- a/redis/commands/helpers.py
+++ b/redis/commands/helpers.py
@@ -42,7 +42,10 @@ def parse_to_list(response):
         try:
             res.append(int(item))
         except ValueError:
-            res.append(nativestr(item))
+            try:
+                res.append(float(item))
+            except ValueError:
+                res.append(nativestr(item))
         except TypeError:
             res.append(None)
     return res
diff --git a/tests/test_helpers.py b/tests/test_helpers.py
new file mode 100644
index 0000000000..467e00c1fd
--- /dev/null
+++ b/tests/test_helpers.py
@@ -0,0 +1,49 @@
+import string
+from redis.commands.helpers import (
+    delist,
+    list_or_args,
+    nativestr,
+    parse_to_list,
+    quote_string,
+    random_string
+)
+
+
+def test_list_or_args():
+    k = ["hello, world"]
+    a = ["some", "argument", "list"]
+    assert list_or_args(k, a) == k+a
+
+    for i in ["banana", b"banana"]:
+        assert list_or_args(i, a) == [i] + a
+
+
+def test_parse_to_list():
+    r = ["hello", b"my name", "45", "555.55", "is simon!", None]
+    assert parse_to_list(r) == \
+        ["hello", "my name", 45, 555.55, "is simon!", None]
+
+
+def test_nativestr():
+    assert nativestr('teststr') == 'teststr'
+    assert nativestr(b'teststr') == 'teststr'
+    assert nativestr('null') is None
+
+
+def test_delist():
+    assert delist(None) is None
+    assert delist([b'hello', 'world', b'banana']) == \
+        ['hello', 'world', 'banana']
+
+
+def test_random_string():
+    assert len(random_string()) == 10
+    assert len(random_string(15)) == 15
+    for a in random_string():
+        assert a in string.ascii_lowercase
+
+
+def test_quote_string():
+    assert quote_string("hello world!") == '"hello world!"'
+    assert quote_string('') == '""'
+    assert quote_string('hello world!') == '"hello world!"'

From 776dd5938a511052d5ce586dce66ac3508fc2e0e Mon Sep 17 00:00:00 2001
From: Ariel Shtul <ariel.shtul@redislabs.com>
Date: Wed, 10 Nov 2021 15:10:19 +0200
Subject: [PATCH 0244/1164] [TEST] search alias test (#1695)

---
 tests/test_search.py | 21 ++++-----------------
 1 file changed, 4 insertions(+), 17 deletions(-)

diff --git a/tests/test_search.py b/tests/test_search.py
index 4175c53271..e07a61c977 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -646,25 +646,15 @@ def test_alias():
     index1.hset("index1:lonestar", mapping={"name": "lonestar"})
     index2.hset("index2:yogurt", mapping={"name": "yogurt"})
 
-    if os.environ.get("GITHUB_WORKFLOW", None) is not None:
-        time.sleep(2)
-    else:
-        time.sleep(5)
-
-    def1 = IndexDefinition(prefix=["index1:"], score_field="name")
-    def2 = IndexDefinition(prefix=["index2:"], score_field="name")
+    def1 = IndexDefinition(prefix=["index1:"])
+    def2 = IndexDefinition(prefix=["index2:"])
 
     ftindex1 = index1.ft("testAlias")
-    ftindex2 = index1.ft("testAlias2")
+    ftindex2 = index2.ft("testAlias2")
     ftindex1.create_index((TextField("name"),), definition=def1)
     ftindex2.create_index((TextField("name"),), definition=def2)
 
-    # CI is slower
-    try:
-        res = ftindex1.search("*").docs[0]
-    except IndexError:
-        time.sleep(5)
-        res = ftindex1.search("*").docs[0]
+    res = ftindex1.search("*").docs[0]
     assert "index1:lonestar" == res.id
 
     # create alias and check for results
@@ -681,9 +671,6 @@ def test_alias():
     ftindex2.aliasupdate("spaceballs")
     alias_client2 = getClient().ft("spaceballs")
 
-    if os.environ.get("GITHUB_WORKFLOW", None) is not None:
-        time.sleep(5)
-
     res = alias_client2.search("*").docs[0]
     assert "index2:yogurt" == res.id
 

From 5be96b96d6059a61d0fd50f96a32db99975408ed Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 10 Nov 2021 15:54:46 +0200
Subject: [PATCH 0245/1164] Unit test fixes to carry pytest options through all
 tests (#1696)

---
 tests/conftest.py             | 20 +++++++++++++-------
 tests/test_connection.py      |  2 ++
 tests/test_connection_pool.py | 17 +++++++++--------
 tests/test_monitor.py         |  3 ++-
 tests/test_multiprocessing.py | 11 +++++++----
 tests/test_pubsub.py          |  3 ++-
 tests/test_sentinel.py        |  2 +-
 7 files changed, 36 insertions(+), 22 deletions(-)

diff --git a/tests/conftest.py b/tests/conftest.py
index b1a0f8cab8..0adec91aaa 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -11,7 +11,6 @@
 
 REDIS_INFO = {}
 default_redis_url = "redis://localhost:6379/9"
-default_redismod_url = "redis://localhost:36379/9"
 
 default_redismod_url = "redis://localhost:36379"
 
@@ -44,10 +43,13 @@ def pytest_sessionstart(session):
     REDIS_INFO["version"] = version
     REDIS_INFO["arch_bits"] = arch_bits
 
-    # module info
-    redismod_url = session.config.getoption("--redismod-url")
-    info = _get_info(redismod_url)
-    REDIS_INFO["modules"] = info["modules"]
+    # module info, if the second redis is running
+    try:
+        redismod_url = session.config.getoption("--redismod-url")
+        info = _get_info(redismod_url)
+        REDIS_INFO["modules"] = info["modules"]
+    except redis.exceptions.ConnectionError:
+        pass
 
 
 def skip_if_server_version_lt(min_version):
@@ -72,7 +74,11 @@ def skip_unless_arch_bits(arch_bits):
 
 
 def skip_ifmodversion_lt(min_version: str, module_name: str):
-    modules = REDIS_INFO["modules"]
+    try:
+        modules = REDIS_INFO["modules"]
+    except KeyError:
+        return pytest.mark.skipif(True,
+                                  reason="Redis server does not have modules")
     if modules == []:
         return pytest.mark.skipif(True, reason="No redis modules found")
 
@@ -218,7 +224,7 @@ def mock_cluster_resp_slaves(request, **kwargs):
 def master_host(request):
     url = request.config.getoption("--redis-url")
     parts = urlparse(url)
-    yield parts.hostname
+    yield parts.hostname, parts.port
 
 
 def wait_for_command(client, monitor, command):
diff --git a/tests/test_connection.py b/tests/test_connection.py
index fa9a2b0c90..f2fc834158 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -18,12 +18,14 @@ def test_invalid_response(r):
 
 
 @skip_if_server_version_lt('4.0.0')
+@pytest.mark.redismod
 def test_loaded_modules(r, modclient):
     assert r.loaded_modules == []
     assert 'rejson' in modclient.loaded_modules.keys()
 
 
 @skip_if_server_version_lt('4.0.0')
+@pytest.mark.redismod
 def test_loading_external_modules(r, modclient):
     def inner():
         pass
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 8d2ad041a0..6fedec66fb 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -44,14 +44,14 @@ def test_connection_creation(self):
         assert connection.kwargs == connection_kwargs
 
     def test_multiple_connections(self, master_host):
-        connection_kwargs = {'host': master_host}
+        connection_kwargs = {'host': master_host[0], 'port': master_host[1]}
         pool = self.get_pool(connection_kwargs=connection_kwargs)
         c1 = pool.get_connection('_')
         c2 = pool.get_connection('_')
         assert c1 != c2
 
     def test_max_connections(self, master_host):
-        connection_kwargs = {'host': master_host}
+        connection_kwargs = {'host': master_host[0], 'port': master_host[1]}
         pool = self.get_pool(max_connections=2,
                              connection_kwargs=connection_kwargs)
         pool.get_connection('_')
@@ -60,7 +60,7 @@ def test_max_connections(self, master_host):
             pool.get_connection('_')
 
     def test_reuse_previously_released_connection(self, master_host):
-        connection_kwargs = {'host': master_host}
+        connection_kwargs = {'host': master_host[0], 'port': master_host[1]}
         pool = self.get_pool(connection_kwargs=connection_kwargs)
         c1 = pool.get_connection('_')
         pool.release(c1)
@@ -103,14 +103,15 @@ def get_pool(self, connection_kwargs=None, max_connections=10, timeout=20):
         return pool
 
     def test_connection_creation(self, master_host):
-        connection_kwargs = {'foo': 'bar', 'biz': 'baz', 'host': master_host}
+        connection_kwargs = {'foo': 'bar', 'biz': 'baz',
+                             'host': master_host[0], 'port': master_host[1]}
         pool = self.get_pool(connection_kwargs=connection_kwargs)
         connection = pool.get_connection('_')
         assert isinstance(connection, DummyConnection)
         assert connection.kwargs == connection_kwargs
 
     def test_multiple_connections(self, master_host):
-        connection_kwargs = {'host': master_host}
+        connection_kwargs = {'host': master_host[0], 'port': master_host[1]}
         pool = self.get_pool(connection_kwargs=connection_kwargs)
         c1 = pool.get_connection('_')
         c2 = pool.get_connection('_')
@@ -118,7 +119,7 @@ def test_multiple_connections(self, master_host):
 
     def test_connection_pool_blocks_until_timeout(self, master_host):
         "When out of connections, block for timeout seconds, then raise"
-        connection_kwargs = {'host': master_host}
+        connection_kwargs = {'host': master_host[0], 'port': master_host[1]}
         pool = self.get_pool(max_connections=1, timeout=0.1,
                              connection_kwargs=connection_kwargs)
         pool.get_connection('_')
@@ -134,7 +135,7 @@ def test_connection_pool_blocks_until_conn_available(self, master_host):
         When out of connections, block until another connection is released
         to the pool
         """
-        connection_kwargs = {'host': master_host}
+        connection_kwargs = {'host': master_host[0], 'port': master_host[1]}
         pool = self.get_pool(max_connections=1, timeout=2,
                              connection_kwargs=connection_kwargs)
         c1 = pool.get_connection('_')
@@ -149,7 +150,7 @@ def target():
         assert time.time() - start >= 0.1
 
     def test_reuse_previously_released_connection(self, master_host):
-        connection_kwargs = {'host': master_host}
+        connection_kwargs = {'host': master_host[0], 'port': master_host[1]}
         pool = self.get_pool(connection_kwargs=connection_kwargs)
         c1 = pool.get_connection('_')
         pool.release(c1)
diff --git a/tests/test_monitor.py b/tests/test_monitor.py
index 1013202f22..bbb7fb75a4 100644
--- a/tests/test_monitor.py
+++ b/tests/test_monitor.py
@@ -9,11 +9,12 @@ def test_wait_command_not_found(self, r):
             assert response is None
 
     def test_response_values(self, r):
+        db = r.connection_pool.connection_kwargs.get('db', 0)
         with r.monitor() as m:
             r.ping()
             response = wait_for_command(r, m, 'PING')
             assert isinstance(response['time'], float)
-            assert response['db'] == 9
+            assert response['db'] == db
             assert response['client_type'] in ('tcp', 'unix')
             assert isinstance(response['client_address'], str)
             assert isinstance(response['client_port'], str)
diff --git a/tests/test_multiprocessing.py b/tests/test_multiprocessing.py
index 2d27c4e8bb..d0feef155f 100644
--- a/tests/test_multiprocessing.py
+++ b/tests/test_multiprocessing.py
@@ -35,7 +35,7 @@ def test_close_connection_in_child(self, master_host):
         A connection owned by a parent and closed by a child doesn't
         destroy the file descriptors so a parent can still use it.
         """
-        conn = Connection(host=master_host)
+        conn = Connection(host=master_host[0], port=master_host[1])
         conn.send_command('ping')
         assert conn.read_response() == b'PONG'
 
@@ -61,7 +61,7 @@ def test_close_connection_in_parent(self, master_host):
         A connection owned by a parent is unusable by a child if the parent
         (the owning process) closes the connection.
         """
-        conn = Connection(host=master_host)
+        conn = Connection(host=master_host[0], port=master_host[1])
         conn.send_command('ping')
         assert conn.read_response() == b'PONG'
 
@@ -89,7 +89,9 @@ def test_pool(self, max_connections, master_host):
         A child will create its own connections when using a pool created
         by a parent.
         """
-        pool = ConnectionPool.from_url('redis://{}'.format(master_host),
+        pool = ConnectionPool.from_url('redis://{}:{}'.format(master_host[0],
+                                                              master_host[1],
+                                                              ),
                                        max_connections=max_connections)
 
         conn = pool.get_connection('ping')
@@ -124,7 +126,8 @@ def test_close_pool_in_main(self, max_connections, master_host):
         A child process that uses the same pool as its parent isn't affected
         when the parent disconnects all connections within the pool.
         """
-        pool = ConnectionPool.from_url('redis://{}'.format(master_host),
+        pool = ConnectionPool.from_url('redis://{}:{}'.format(master_host[0],
+                                                              master_host[1]),
                                        max_connections=max_connections)
 
         conn = pool.get_connection('ping')
diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index 4be6c7a305..cfc6e5e864 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -575,7 +575,8 @@ def exception_handler(ex, pubsub, thread):
 class TestPubSubDeadlock:
     @pytest.mark.timeout(30, method='thread')
     def test_pubsub_deadlock(self, master_host):
-        pool = redis.ConnectionPool(host=master_host)
+        pool = redis.ConnectionPool(host=master_host[0],
+                                    port=master_host[1])
         r = redis.Redis(connection_pool=pool)
 
         for i in range(60):
diff --git a/tests/test_sentinel.py b/tests/test_sentinel.py
index 54cf262c43..7f3ff0ae2a 100644
--- a/tests/test_sentinel.py
+++ b/tests/test_sentinel.py
@@ -10,7 +10,7 @@
 
 @pytest.fixture(scope="module")
 def master_ip(master_host):
-    yield socket.gethostbyname(master_host)
+    yield socket.gethostbyname(master_host[0])
 
 
 class SentinelTestClient:

From 560457337c37ceaa16baaf65b1674e83463ecc20 Mon Sep 17 00:00:00 2001
From: AvitalFineRedis <avital.fine@redislabs.com>
Date: Thu, 11 Nov 2021 09:50:51 +0100
Subject: [PATCH 0246/1164] Support desc for 3.5.3

---
 redis/commands/core.py | 4 ++++
 tests/test_commands.py | 1 +
 2 files changed, 5 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 90997ff931..0344e3a433 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -2520,6 +2520,10 @@ def zrange(self, name, start, end, desc=False, withscores=False,
         ``offset`` and ``num`` are specified, then return a slice of the range.
         Can't be provided when using ``bylex``.
         """
+        # Supports old implementation: need to support ``desc`` also for version < 6.2.0
+        if not byscore and not bylex and (offset is None and num is None) and desc:
+            return self.zrevrange(name, start, end, withscores,
+                                  score_cast_func)
         return self._zrange('ZRANGE', None, name, start, end, desc, byscore,
                             bylex, withscores, score_cast_func, offset, num)
 
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 6d4ab008ab..c361a4ba70 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1867,6 +1867,7 @@ def test_zrange(self, r):
         assert r.zrange('a', 0, 1) == [b'a1', b'a2']
         assert r.zrange('a', 1, 2) == [b'a2', b'a3']
         assert r.zrange('a', 0, 2) == [b'a1', b'a2', b'a3']
+        assert r.zrange('a', 0, 2, desc=True) == [b'a3', b'a2', b'a1']
 
         # withscores
         assert r.zrange('a', 0, 1, withscores=True) == \

From cb58e968c2313e447b5b96fbbe8be1af306e1849 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Thu, 11 Nov 2021 11:30:28 +0100
Subject: [PATCH 0247/1164] Fix unit tests running against Redis 4.0.0 (#1699)

---
 tests/test_commands.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/tests/test_commands.py b/tests/test_commands.py
index 6d4ab008ab..4991f89745 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -453,7 +453,7 @@ def test_client_kill_filter_by_laddr(self, r, r2):
         client_2_addr = clients_by_name['redis-py-c2'].get('laddr')
         assert r.client_kill_filter(laddr=client_2_addr)
 
-    @skip_if_server_version_lt('2.8.12')
+    @skip_if_server_version_lt('6.0.0')
     def test_client_kill_filter_by_user(self, r, request):
         killuser = 'user_to_kill'
         r.acl_setuser(killuser, enabled=True, reset=True,
@@ -3660,7 +3660,8 @@ def test_restore(self, r):
         assert r.restore(key2, 0, dumpdata)
         assert r.ttl(key2) == -1
 
-        # idletime
+    @skip_if_server_version_lt('5.0.0')
+    def test_restore_idletime(self, r):
         key = 'yayakey'
         r.set(key, 'blee!')
         dumpdata = r.dump(key)
@@ -3668,7 +3669,8 @@ def test_restore(self, r):
         assert r.restore(key, 0, dumpdata, idletime=5)
         assert r.get(key) == b'blee!'
 
-        # frequency
+    @skip_if_server_version_lt('5.0.0')
+    def test_restore_frequency(self, r):
         key = 'yayakey'
         r.set(key, 'blee!')
         dumpdata = r.dump(key)
@@ -3678,10 +3680,8 @@ def test_restore(self, r):
 
     @skip_if_server_version_lt('5.0.0')
     def test_replicaof(self, r):
-
         with pytest.raises(redis.ResponseError):
             assert r.replicaof("NO ONE")
-
         assert r.replicaof("NO", "ONE")
 
 

From ec172e74bbccd32627835d67eddac704fe9ba31b Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Thu, 11 Nov 2021 11:31:19 +0100
Subject: [PATCH 0248/1164] Restoring ZRANGE desc for Redis < 6.2.0 (#1697)

---
 redis/commands/core.py | 7 +++++++
 tests/test_commands.py | 1 +
 2 files changed, 8 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 90997ff931..67f1bfa1be 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -2520,6 +2520,13 @@ def zrange(self, name, start, end, desc=False, withscores=False,
         ``offset`` and ``num`` are specified, then return a slice of the range.
         Can't be provided when using ``bylex``.
         """
+        # Need to support ``desc`` also when using old redis version
+        # because it was supported in 3.5.3 (of redis-py)
+        if not byscore and not bylex and (offset is None and num is None) \
+                and desc:
+            return self.zrevrange(name, start, end, withscores,
+                                  score_cast_func)
+
         return self._zrange('ZRANGE', None, name, start, end, desc, byscore,
                             bylex, withscores, score_cast_func, offset, num)
 
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 4991f89745..330ba280f9 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1867,6 +1867,7 @@ def test_zrange(self, r):
         assert r.zrange('a', 0, 1) == [b'a1', b'a2']
         assert r.zrange('a', 1, 2) == [b'a2', b'a3']
         assert r.zrange('a', 0, 2) == [b'a1', b'a2', b'a3']
+        assert r.zrange('a', 0, 2, desc=True) == [b'a3', b'a2', b'a1']
 
         # withscores
         assert r.zrange('a', 0, 1, withscores=True) == \

From 6a293e685d27894bc99ea4c0c7312c81f099ca45 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 11 Nov 2021 12:38:27 +0200
Subject: [PATCH 0249/1164] Fixes to allow --redis-url to pass through all
 tests (#1700)

---
 tests/conftest.py             | 18 +++++++++++++
 tests/test_commands.py        | 50 ++++++++++++++++++++++++++---------
 tests/test_connection_pool.py | 12 ++++++++-
 tests/test_monitor.py         | 15 ++++++++++-
 tests/test_pubsub.py          |  7 ++++-
 tests/test_scripting.py       | 11 +++++++-
 6 files changed, 97 insertions(+), 16 deletions(-)

diff --git a/tests/conftest.py b/tests/conftest.py
index 0adec91aaa..bb682f78ca 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -31,6 +31,12 @@ def pytest_addoption(parser):
 def _get_info(redis_url):
     client = redis.Redis.from_url(redis_url)
     info = client.info()
+    try:
+        client.execute_command("CONFIG SET maxmemory 5555555")
+        client.execute_command("CONFIG SET maxmemory 0")
+        info["enterprise"] = False
+    except redis.exceptions.ResponseError:
+        info["enterprise"] = True
     client.connection_pool.disconnect()
     return info
 
@@ -42,6 +48,7 @@ def pytest_sessionstart(session):
     arch_bits = info["arch_bits"]
     REDIS_INFO["version"] = version
     REDIS_INFO["arch_bits"] = arch_bits
+    REDIS_INFO["enterprise"] = info["enterprise"]
 
     # module info, if the second redis is running
     try:
@@ -92,6 +99,17 @@ def skip_ifmodversion_lt(min_version: str, module_name: str):
     raise AttributeError("No redis module named {}".format(module_name))
 
 
+def skip_if_redis_enterprise(func):
+    check = REDIS_INFO["enterprise"] is True
+    return pytest.mark.skipif(check, reason="Redis enterprise"
+                              )
+
+
+def skip_ifnot_redis_enterprise(func):
+    check = REDIS_INFO["enterprise"] is False
+    return pytest.mark.skipif(check, reason="Redis enterprise")
+
+
 def _get_client(cls, request, single_connection_client=True, flushdb=True,
                 from_url=None,
                 **kwargs):
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 330ba280f9..df561d4d5d 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -13,6 +13,7 @@
     _get_client,
     skip_if_server_version_gte,
     skip_if_server_version_lt,
+    skip_if_redis_enterprise,
     skip_unless_arch_bits,
 )
 
@@ -80,6 +81,7 @@ def test_acl_cat_with_category(self, r):
         assert 'get' in commands
 
     @skip_if_server_version_lt("6.0.0")
+    @skip_if_redis_enterprise
     def test_acl_deluser(self, r, request):
         username = 'redis-py-user'
 
@@ -104,6 +106,7 @@ def teardown():
         assert r.acl_getuser(users[4]) is None
 
     @skip_if_server_version_lt("6.0.0")
+    @skip_if_redis_enterprise
     def test_acl_genpass(self, r):
         password = r.acl_genpass()
         assert isinstance(password, str)
@@ -117,6 +120,7 @@ def test_acl_genpass(self, r):
         assert isinstance(password, str)
 
     @skip_if_server_version_lt("6.0.0")
+    @skip_if_redis_enterprise
     def test_acl_getuser_setuser(self, r, request):
         username = 'redis-py-user'
 
@@ -210,6 +214,7 @@ def test_acl_help(self, r):
         assert len(res) != 0
 
     @skip_if_server_version_lt("6.0.0")
+    @skip_if_redis_enterprise
     def test_acl_list(self, r, request):
         username = 'redis-py-user'
 
@@ -222,6 +227,7 @@ def teardown():
         assert len(users) == 2
 
     @skip_if_server_version_lt("6.0.0")
+    @skip_if_redis_enterprise
     def test_acl_log(self, r, request):
         username = 'redis-py-user'
 
@@ -257,6 +263,7 @@ def teardown():
         assert r.acl_log_reset()
 
     @skip_if_server_version_lt("6.0.0")
+    @skip_if_redis_enterprise
     def test_acl_setuser_categories_without_prefix_fails(self, r, request):
         username = 'redis-py-user'
 
@@ -268,6 +275,7 @@ def teardown():
             r.acl_setuser(username, categories=['list'])
 
     @skip_if_server_version_lt("6.0.0")
+    @skip_if_redis_enterprise
     def test_acl_setuser_commands_without_prefix_fails(self, r, request):
         username = 'redis-py-user'
 
@@ -279,6 +287,7 @@ def teardown():
             r.acl_setuser(username, commands=['get'])
 
     @skip_if_server_version_lt("6.0.0")
+    @skip_if_redis_enterprise
     def test_acl_setuser_add_passwords_and_nopass_fails(self, r, request):
         username = 'redis-py-user'
 
@@ -312,13 +321,18 @@ def test_client_info(self, r):
         assert 'addr' in info
 
     @skip_if_server_version_lt('5.0.0')
-    def test_client_list_type(self, r):
+    def test_client_list_types_not_replica(self, r):
         with pytest.raises(exceptions.RedisError):
             r.client_list(_type='not a client type')
-        for client_type in ['normal', 'master', 'replica', 'pubsub']:
+        for client_type in ['normal', 'master', 'pubsub']:
             clients = r.client_list(_type=client_type)
             assert isinstance(clients, list)
 
+    @skip_if_redis_enterprise
+    def test_client_list_replica(self, r):
+        clients = r.client_list(_type='replica')
+        assert isinstance(clients, list)
+
     @skip_if_server_version_lt('6.2.0')
     def test_client_list_client_id(self, r, request):
         clients = r.client_list()
@@ -454,6 +468,7 @@ def test_client_kill_filter_by_laddr(self, r, r2):
         assert r.client_kill_filter(laddr=client_2_addr)
 
     @skip_if_server_version_lt('6.0.0')
+    @skip_if_redis_enterprise
     def test_client_kill_filter_by_user(self, r, request):
         killuser = 'user_to_kill'
         r.acl_setuser(killuser, enabled=True, reset=True,
@@ -467,6 +482,7 @@ def test_client_kill_filter_by_user(self, r, request):
         r.acl_deluser(killuser)
 
     @skip_if_server_version_lt('2.9.50')
+    @skip_if_redis_enterprise
     def test_client_pause(self, r):
         assert r.client_pause(1)
         assert r.client_pause(timeout=1)
@@ -474,6 +490,7 @@ def test_client_pause(self, r):
             r.client_pause(timeout='not an integer')
 
     @skip_if_server_version_lt('6.2.0')
+    @skip_if_redis_enterprise
     def test_client_unpause(self, r):
         assert r.client_unpause() == b'OK'
 
@@ -491,15 +508,18 @@ def test_client_reply(self, r, r_timeout):
         assert r.get('foo') == b'bar'
 
     @skip_if_server_version_lt('6.0.0')
+    @skip_if_redis_enterprise
     def test_client_getredir(self, r):
         assert isinstance(r.client_getredir(), int)
         assert r.client_getredir() == -1
 
     def test_config_get(self, r):
         data = r.config_get()
-        assert 'maxmemory' in data
-        assert data['maxmemory'].isdigit()
+        assert len(data.keys()) > 10
+        # # assert 'maxmemory' in data
+        # assert data['maxmemory'].isdigit()
 
+    @skip_if_redis_enterprise
     def test_config_resetstat(self, r):
         r.ping()
         prior_commands_processed = int(r.info()['total_commands_processed'])
@@ -508,14 +528,12 @@ def test_config_resetstat(self, r):
         reset_commands_processed = int(r.info()['total_commands_processed'])
         assert reset_commands_processed < prior_commands_processed
 
+    @skip_if_redis_enterprise
     def test_config_set(self, r):
-        data = r.config_get()
-        rdbname = data['dbfilename']
-        try:
-            assert r.config_set('dbfilename', 'redis_py_test.rdb')
-            assert r.config_get()['dbfilename'] == 'redis_py_test.rdb'
-        finally:
-            assert r.config_set('dbfilename', rdbname)
+        r.config_set('timeout', 70)
+        assert r.config_get()['timeout'] == '70'
+        assert r.config_set('timeout', 0)
+        assert r.config_get()['timeout'] == '0'
 
     def test_dbsize(self, r):
         r['a'] = 'foo'
@@ -530,8 +548,10 @@ def test_info(self, r):
         r['b'] = 'bar'
         info = r.info()
         assert isinstance(info, dict)
-        assert info['db9']['keys'] == 2
+        assert 'arch_bits' in info.keys()
+        assert 'redis_version' in info.keys()
 
+    @skip_if_redis_enterprise
     def test_lastsave(self, r):
         assert isinstance(r.lastsave(), datetime.datetime)
 
@@ -625,6 +645,7 @@ def test_time(self, r):
         assert isinstance(t[0], int)
         assert isinstance(t[1], int)
 
+    @skip_if_redis_enterprise
     def test_bgsave(self, r):
         assert r.bgsave()
         time.sleep(0.3)
@@ -2433,6 +2454,7 @@ def test_cluster_slaves(self, mock_cluster_resp_slaves):
             'slaves', 'nodeid'), dict)
 
     @skip_if_server_version_lt('3.0.0')
+    @skip_if_redis_enterprise
     def test_readwrite(self, r):
         assert r.readwrite()
 
@@ -3614,6 +3636,7 @@ def test_memory_usage(self, r):
         assert isinstance(r.memory_usage('foo'), int)
 
     @skip_if_server_version_lt('4.0.0')
+    @skip_if_redis_enterprise
     def test_module_list(self, r):
         assert isinstance(r.module_list(), list)
         for x in r.module_list():
@@ -3626,6 +3649,7 @@ def test_command_count(self, r):
         assert res >= 100
 
     @skip_if_server_version_lt('4.0.0')
+    @skip_if_redis_enterprise
     def test_module(self, r):
         with pytest.raises(redis.exceptions.ModuleError) as excinfo:
             r.module_load('/some/fake/path')
@@ -3680,6 +3704,7 @@ def test_restore_frequency(self, r):
         assert r.get(key) == b'blee!'
 
     @skip_if_server_version_lt('5.0.0')
+    @skip_if_redis_enterprise
     def test_replicaof(self, r):
         with pytest.raises(redis.ResponseError):
             assert r.replicaof("NO ONE")
@@ -3756,6 +3781,7 @@ def test_22_info(self, r):
         assert '6' in parsed['allocation_stats']
         assert '>=256' in parsed['allocation_stats']
 
+    @skip_if_redis_enterprise
     def test_large_responses(self, r):
         "The PythonParser has some special cases for return values > 1MB"
         # load up 5MB of data into a key
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 6fedec66fb..521f520777 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -7,7 +7,11 @@
 
 from threading import Thread
 from redis.connection import ssl_available, to_bool
-from .conftest import skip_if_server_version_lt, _get_client
+from .conftest import (
+    skip_if_server_version_lt,
+    skip_if_redis_enterprise,
+    _get_client
+)
 from .test_pubsub import wait_for_message
 
 
@@ -481,6 +485,7 @@ def test_on_connect_error(self):
         assert not pool._available_connections[0]._sock
 
     @skip_if_server_version_lt('2.8.8')
+    @skip_if_redis_enterprise
     def test_busy_loading_disconnects_socket(self, r):
         """
         If Redis raises a LOADING error, the connection should be
@@ -491,6 +496,7 @@ def test_busy_loading_disconnects_socket(self, r):
         assert not r.connection._sock
 
     @skip_if_server_version_lt('2.8.8')
+    @skip_if_redis_enterprise
     def test_busy_loading_from_pipeline_immediate_command(self, r):
         """
         BusyLoadingErrors should raise from Pipelines that execute a
@@ -506,6 +512,7 @@ def test_busy_loading_from_pipeline_immediate_command(self, r):
         assert not pool._available_connections[0]._sock
 
     @skip_if_server_version_lt('2.8.8')
+    @skip_if_redis_enterprise
     def test_busy_loading_from_pipeline(self, r):
         """
         BusyLoadingErrors should be raised from a pipeline execution
@@ -521,6 +528,7 @@ def test_busy_loading_from_pipeline(self, r):
         assert not pool._available_connections[0]._sock
 
     @skip_if_server_version_lt('2.8.8')
+    @skip_if_redis_enterprise
     def test_read_only_error(self, r):
         "READONLY errors get turned in ReadOnlyError exceptions"
         with pytest.raises(redis.ReadOnlyError):
@@ -546,6 +554,7 @@ def test_connect_from_url_unix(self):
             'path=/path/to/socket,db=0',
         )
 
+    @skip_if_redis_enterprise
     def test_connect_no_auth_supplied_when_required(self, r):
         """
         AuthenticationError should be raised when the server requires a
@@ -555,6 +564,7 @@ def test_connect_no_auth_supplied_when_required(self, r):
             r.execute_command('DEBUG', 'ERROR',
                               'ERR Client sent AUTH, but no password is set')
 
+    @skip_if_redis_enterprise
     def test_connect_invalid_password_supplied(self, r):
         "AuthenticationError should be raised when sending the wrong password"
         with pytest.raises(redis.AuthenticationError):
diff --git a/tests/test_monitor.py b/tests/test_monitor.py
index bbb7fb75a4..a8a535b59a 100644
--- a/tests/test_monitor.py
+++ b/tests/test_monitor.py
@@ -1,4 +1,8 @@
-from .conftest import wait_for_command
+from .conftest import (
+    skip_if_redis_enterprise,
+    skip_ifnot_redis_enterprise,
+    wait_for_command
+)
 
 
 class TestMonitor:
@@ -40,6 +44,7 @@ def test_command_with_escaped_data(self, r):
             response = wait_for_command(r, m, 'GET foo\\\\x92')
             assert response['command'] == 'GET foo\\\\x92'
 
+    @skip_if_redis_enterprise
     def test_lua_script(self, r):
         with r.monitor() as m:
             script = 'return redis.call("GET", "foo")'
@@ -49,3 +54,11 @@ def test_lua_script(self, r):
             assert response['client_type'] == 'lua'
             assert response['client_address'] == 'lua'
             assert response['client_port'] == ''
+
+    @skip_ifnot_redis_enterprise
+    def test_lua_script_in_enterprise(self, r):
+        with r.monitor() as m:
+            script = 'return redis.call("GET", "foo")'
+            assert r.eval(script, 0) is None
+            response = wait_for_command(r, m, 'GET foo')
+            assert response is None
diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index cfc6e5e864..e2424592cd 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -7,7 +7,11 @@
 import redis
 from redis.exceptions import ConnectionError
 
-from .conftest import _get_client, skip_if_server_version_lt
+from .conftest import (
+    _get_client,
+    skip_if_redis_enterprise,
+    skip_if_server_version_lt
+)
 
 
 def wait_for_message(pubsub, timeout=0.1, ignore_subscribe_messages=False):
@@ -528,6 +532,7 @@ def test_send_pubsub_ping_message(self, r):
 class TestPubSubConnectionKilled:
 
     @skip_if_server_version_lt('3.0.0')
+    @skip_if_redis_enterprise
     def test_connection_error_raised_when_connection_dies(self, r):
         p = r.pubsub()
         p.subscribe('foo')
diff --git a/tests/test_scripting.py b/tests/test_scripting.py
index c3c2094d4a..352f3bae2e 100644
--- a/tests/test_scripting.py
+++ b/tests/test_scripting.py
@@ -2,6 +2,8 @@
 
 from redis import exceptions
 
+from tests.conftest import skip_if_server_version_lt
+
 
 multiply_script = """
 local value = redis.call('GET', KEYS[1])
@@ -30,7 +32,8 @@ def test_eval(self, r):
         # 2 * 3 == 6
         assert r.eval(multiply_script, 1, 'a', 3) == 6
 
-    def test_script_flush(self, r):
+    @skip_if_server_version_lt('6.2.0')
+    def test_script_flush_620(self, r):
         r.set('a', 2)
         r.script_load(multiply_script)
         r.script_flush('ASYNC')
@@ -43,6 +46,12 @@ def test_script_flush(self, r):
         r.script_load(multiply_script)
         r.script_flush()
 
+        with pytest.raises(exceptions.DataError):
+            r.set('a', 2)
+            r.script_load(multiply_script)
+            r.script_flush("NOTREAL")
+
+    def test_script_flush(self, r):
         r.set('a', 2)
         r.script_load(multiply_script)
         r.script_flush(None)

From e881976023cfc381aeaaec580c4b10b9ba62c0b6 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 14 Nov 2021 12:50:06 +0200
Subject: [PATCH 0250/1164] Added breaking icon to release drafter (#1702)

---
 .github/release-drafter-config.yml |  2 +-
 tests/test_commands.py             | 23 +++++++++++++++++++++++
 2 files changed, 24 insertions(+), 1 deletion(-)

diff --git a/.github/release-drafter-config.yml b/.github/release-drafter-config.yml
index f17a2992fa..a3a5d8392a 100644
--- a/.github/release-drafter-config.yml
+++ b/.github/release-drafter-config.yml
@@ -15,7 +15,7 @@ autolabeler:
     branch:
       - '/feature-.+'
 categories:
-  - title: 'Breaking Changes'
+  - title: '🔥 Breaking Changes'
     labels:
       - 'breakingchange'
   - title: '🚀 New Features'
diff --git a/tests/test_commands.py b/tests/test_commands.py
index df561d4d5d..6cb1a78279 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1208,6 +1208,12 @@ def test_stralgo_lcs(self, r):
         value1 = 'ohmytext'
         value2 = 'mynewtext'
         res = 'mytext'
+
+        if skip_if_redis_enterprise(None).args[0] is True:
+            with pytest.raises(redis.exceptions.ResponseError):
+                assert r.stralgo('LCS', value1, value2) == res
+            return
+
         # test LCS of strings
         assert r.stralgo('LCS', value1, value2) == res
         # test using keys
@@ -1250,6 +1256,12 @@ def test_strlen(self, r):
 
     def test_substr(self, r):
         r['a'] = '0123456789'
+
+        if skip_if_redis_enterprise(None).args[0] is True:
+            with pytest.raises(redis.exceptions.ResponseError):
+                assert r.substr('a', 0) == b'0123456789'
+            return
+
         assert r.substr('a', 0) == b'0123456789'
         assert r.substr('a', 2) == b'23456789'
         assert r.substr('a', 3, 5) == b'345'
@@ -3617,6 +3629,11 @@ def test_memory_doctor(self, r):
 
     @skip_if_server_version_lt('4.0.0')
     def test_memory_malloc_stats(self, r):
+        if skip_if_redis_enterprise(None).args[0] is True:
+            with pytest.raises(redis.exceptions.ResponseError):
+                assert r.memory_malloc_stats()
+            return
+
         assert r.memory_malloc_stats()
 
     @skip_if_server_version_lt('4.0.0')
@@ -3624,6 +3641,12 @@ def test_memory_stats(self, r):
         # put a key into the current db to make sure that "db.<current-db>"
         # has data
         r.set('foo', 'bar')
+
+        if skip_if_redis_enterprise(None).args[0] is True:
+            with pytest.raises(redis.exceptions.ResponseError):
+                stats = r.memory_stats()
+            return
+
         stats = r.memory_stats()
         assert isinstance(stats, dict)
         for key, value in stats.items():

From 5b72987e80a7765ce6e464232a7f1519243d0a73 Mon Sep 17 00:00:00 2001
From: Jeremy Mayeres <1524722+jerr0328@users.noreply.github.com>
Date: Sun, 14 Nov 2021 11:52:57 +0100
Subject: [PATCH 0251/1164] Improve documentation about Lock (#1701)

---
 redis/lock.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/redis/lock.py b/redis/lock.py
index 326dbaf98e..d2297526a0 100644
--- a/redis/lock.py
+++ b/redis/lock.py
@@ -76,14 +76,14 @@ def __init__(self, redis, name, timeout=None, sleep=0.1,
         Create a new Lock instance named ``name`` using the Redis client
         supplied by ``redis``.
 
-        ``timeout`` indicates a maximum life for the lock.
+        ``timeout`` indicates a maximum life for the lock in seconds.
         By default, it will remain locked until release() is called.
         ``timeout`` can be specified as a float or integer, both representing
         the number of seconds to wait.
 
-        ``sleep`` indicates the amount of time to sleep per loop iteration
-        when the lock is in blocking mode and another client is currently
-        holding the lock.
+        ``sleep`` indicates the amount of time to sleep in seconds per loop
+        iteration when the lock is in blocking mode and another client is
+        currently holding the lock.
 
         ``blocking`` indicates whether calling ``acquire`` should block until
         the lock has been acquired or to fail immediately, causing ``acquire``

From 19819e08211cc12f85c45294ad6209b2d5626337 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 14 Nov 2021 13:09:43 +0200
Subject: [PATCH 0252/1164] Unit tests fixes for compatibility (#1703)

---
 redis/client.py                       | 41 +++++++++++++--------------
 redis/commands/core.py                |  3 ++
 redis/commands/redismodules.py        | 38 ++++++++++++-------------
 redis/commands/search/__init__.py     |  3 +-
 redis/commands/timeseries/__init__.py |  3 +-
 tests/conftest.py                     | 10 +++----
 tests/test_commands.py                |  8 ++++++
 tests/test_connection.py              | 26 ++++++-----------
 8 files changed, 65 insertions(+), 67 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index f2f1eed08c..753770e3e2 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -703,7 +703,6 @@ class Redis(RedisModuleCommands, CoreCommands, object):
         'CLUSTER SET-CONFIG-EPOCH': bool_ok,
         'CLUSTER SETSLOT': bool_ok,
         'CLUSTER SLAVES': parse_cluster_nodes,
-        'COMMAND': int,
         'COMMAND COUNT': int,
         'CONFIG GET': parse_config_get,
         'CONFIG RESETSTAT': bool_ok,
@@ -891,6 +890,12 @@ def __init__(self, host='localhost', port=6379,
         self.response_callbacks = CaseInsensitiveDict(
             self.__class__.RESPONSE_CALLBACKS)
 
+        # preload our class with the available redis commands
+        try:
+            self.__redis_commands__()
+        except RedisError:
+            pass
+
     def __repr__(self):
         return "%s<%s>" % (type(self).__name__, repr(self.connection_pool))
 
@@ -898,12 +903,12 @@ def set_response_callback(self, command, callback):
         "Set a custom Response Callback"
         self.response_callbacks[command] = callback
 
-    def load_external_module(self, modname, funcname, func):
+    def load_external_module(self, funcname, func,
+                             ):
         """
         This function can be used to add externally defined redis modules,
         and their namespaces to the redis client.
-        modname - A string containing the name of the redis module to look for
-                  in the redis info block.
+
         funcname - A string containing the name of the function to create
         func - The function, being added to this class.
 
@@ -914,31 +919,25 @@ def load_external_module(self, modname, funcname, func):
         from redis import Redis
         from foomodule import F
         r = Redis()
-        r.load_external_module("foomod", "foo", F)
+        r.load_external_module("foo", F)
         r.foo().dothing('your', 'arguments')
 
         For a concrete example see the reimport of the redisjson module in
         tests/test_connection.py::test_loading_external_modules
         """
-        mods = self.loaded_modules
-        if modname.lower() not in mods:
-            raise ModuleError("{} is not loaded in redis.".format(modname))
         setattr(self, funcname, func)
 
-    @property
-    def loaded_modules(self):
-        key = '__redis_modules__'
-        mods = getattr(self, key, None)
-        if mods is not None:
-            return mods
-
+    def __redis_commands__(self):
+        """Store the list of available commands, for our redis instance."""
+        cmds = getattr(self, '__commands__', None)
+        if cmds is not None:
+            return cmds
         try:
-            mods = {f.get('name').lower(): f.get('ver')
-                    for f in self.info().get('modules')}
-        except TypeError:
-            mods = []
-        setattr(self, key, mods)
-        return mods
+            cmds = [c[0].upper().decode() for c in self.command()]
+        except AttributeError:  # if encoded
+            cmds = [c[0].upper() for c in self.command()]
+        self.__commands__ = cmds
+        return cmds
 
     def pipeline(self, transaction=True, shard_hint=None):
         """
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 67f1bfa1be..516e7d9c83 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3315,6 +3315,9 @@ def command_info(self):
     def command_count(self):
         return self.execute_command('COMMAND COUNT')
 
+    def command(self):
+        return self.execute_command('COMMAND')
+
 
 class Script:
     "An executable Lua script object returned by ``register_script``"
diff --git a/redis/commands/redismodules.py b/redis/commands/redismodules.py
index 457a69e2a2..b3cbee1d87 100644
--- a/redis/commands/redismodules.py
+++ b/redis/commands/redismodules.py
@@ -8,41 +8,41 @@ class RedisModuleCommands:
     """
 
     def json(self, encoder=JSONEncoder(), decoder=JSONDecoder()):
-        """Access the json namespace, providing support for redis json."""
-        try:
-            modversion = self.loaded_modules['rejson']
-        except IndexError:
-            raise ModuleError("rejson is not a loaded in the redis instance.")
+        """Access the json namespace, providing support for redis json.
+        """
+        if 'JSON.SET' not in self.__commands__:
+            raise ModuleError("redisjson is not loaded in redis. "
+                              "For more information visit "
+                              "https://redisjson.io/")
 
         from .json import JSON
         jj = JSON(
                 client=self,
-                version=modversion,
                 encoder=encoder,
                 decoder=decoder)
         return jj
 
     def ft(self, index_name="idx"):
-        """Access the search namespace, providing support for redis search."""
-        try:
-            modversion = self.loaded_modules['search']
-        except IndexError:
-            raise ModuleError("search is not a loaded in the redis instance.")
+        """Access the search namespace, providing support for redis search.
+        """
+        if 'FT.INFO' not in self.__commands__:
+            raise ModuleError("redisearch is not loaded in redis. "
+                              "For more information visit "
+                              "https://redisearch.io/")
 
         from .search import Search
-        s = Search(client=self, version=modversion, index_name=index_name)
+        s = Search(client=self, index_name=index_name)
         return s
 
-    def ts(self, index_name="idx"):
+    def ts(self):
         """Access the timeseries namespace, providing support for
         redis timeseries data.
         """
-        try:
-            modversion = self.loaded_modules['timeseries']
-        except IndexError:
-            raise ModuleError("timeseries is not a loaded in "
-                              "the redis instance.")
+        if 'TS.INFO' not in self.__commands__:
+            raise ModuleError("reditimeseries is not loaded in redis. "
+                              "For more information visit "
+                              "https://redistimeseries.io/")
 
         from .timeseries import TimeSeries
-        s = TimeSeries(client=self, version=modversion, index_name=index_name)
+        s = TimeSeries(client=self)
         return s
diff --git a/redis/commands/search/__init__.py b/redis/commands/search/__init__.py
index 425578eabd..8320ad4392 100644
--- a/redis/commands/search/__init__.py
+++ b/redis/commands/search/__init__.py
@@ -83,7 +83,7 @@ def commit(self):
             self.pipeline.execute()
             self.current_chunk = 0
 
-    def __init__(self, client, version=None, index_name="idx"):
+    def __init__(self, client, index_name="idx"):
         """
         Create a new Client for the given index_name.
         The default name is `idx`
@@ -91,7 +91,6 @@ def __init__(self, client, version=None, index_name="idx"):
         If conn is not None, we employ an already existing redis connection
         """
         self.client = client
-        self.MODULE_VERSION = version
         self.index_name = index_name
         self.execute_command = client.execute_command
         self.pipeline = client.pipeline
diff --git a/redis/commands/timeseries/__init__.py b/redis/commands/timeseries/__init__.py
index 83fa17082e..5ce538f675 100644
--- a/redis/commands/timeseries/__init__.py
+++ b/redis/commands/timeseries/__init__.py
@@ -34,7 +34,7 @@ class TimeSeries(TimeSeriesCommands):
     functionality.
     """
 
-    def __init__(self, client=None, version=None, **kwargs):
+    def __init__(self, client=None, **kwargs):
         """Create a new RedisTimeSeries client."""
         # Set the module commands' callbacks
         self.MODULE_CALLBACKS = {
@@ -55,7 +55,6 @@ def __init__(self, client=None, version=None, **kwargs):
 
         self.client = client
         self.execute_command = client.execute_command
-        self.MODULE_VERSION = version
 
         for key, value in self.MODULE_CALLBACKS.items():
             self.client.set_response_callback(key, value)
diff --git a/tests/conftest.py b/tests/conftest.py
index bb682f78ca..31d3fbd1a8 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -31,12 +31,10 @@ def pytest_addoption(parser):
 def _get_info(redis_url):
     client = redis.Redis.from_url(redis_url)
     info = client.info()
-    try:
-        client.execute_command("CONFIG SET maxmemory 5555555")
-        client.execute_command("CONFIG SET maxmemory 0")
-        info["enterprise"] = False
-    except redis.exceptions.ResponseError:
+    if 'dping' in client.__commands__:
         info["enterprise"] = True
+    else:
+        info["enterprise"] = False
     client.connection_pool.disconnect()
     return info
 
@@ -57,6 +55,8 @@ def pytest_sessionstart(session):
         REDIS_INFO["modules"] = info["modules"]
     except redis.exceptions.ConnectionError:
         pass
+    except KeyError:
+        pass
 
 
 def skip_if_server_version_lt(min_version):
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 6cb1a78279..dbd04429b4 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -3671,6 +3671,14 @@ def test_command_count(self, r):
         assert isinstance(res, int)
         assert res >= 100
 
+    @skip_if_server_version_lt('2.8.13')
+    def test_command(self, r):
+        res = r.command()
+        assert len(res) >= 100
+        cmds = [c[0].decode() for c in res]
+        assert 'set' in cmds
+        assert 'get' in cmds
+
     @skip_if_server_version_lt('4.0.0')
     @skip_if_redis_enterprise
     def test_module(self, r):
diff --git a/tests/test_connection.py b/tests/test_connection.py
index f2fc834158..7c44768150 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -2,7 +2,7 @@
 import types
 import pytest
 
-from redis.exceptions import InvalidResponse, ModuleError
+from redis.exceptions import InvalidResponse
 from redis.utils import HIREDIS_AVAILABLE
 from .conftest import skip_if_server_version_lt
 
@@ -19,30 +19,20 @@ def test_invalid_response(r):
 
 @skip_if_server_version_lt('4.0.0')
 @pytest.mark.redismod
-def test_loaded_modules(r, modclient):
-    assert r.loaded_modules == []
-    assert 'rejson' in modclient.loaded_modules.keys()
-
-
-@skip_if_server_version_lt('4.0.0')
-@pytest.mark.redismod
-def test_loading_external_modules(r, modclient):
+def test_loading_external_modules(modclient):
     def inner():
         pass
 
-    with pytest.raises(ModuleError):
-        r.load_external_module('rejson', 'myfuncname', inner)
-
-    modclient.load_external_module('rejson', 'myfuncname', inner)
+    modclient.load_external_module('myfuncname', inner)
     assert getattr(modclient, 'myfuncname') == inner
     assert isinstance(getattr(modclient, 'myfuncname'), types.FunctionType)
 
     # and call it
     from redis.commands import RedisModuleCommands
     j = RedisModuleCommands.json
-    modclient.load_external_module('rejson', 'sometestfuncname', j)
+    modclient.load_external_module('sometestfuncname', j)
 
-    d = {'hello': 'world!'}
-    mod = j(modclient)
-    mod.set("fookey", ".", d)
-    assert mod.get('fookey') == d
+    # d = {'hello': 'world!'}
+    # mod = j(modclient)
+    # mod.set("fookey", ".", d)
+    # assert mod.get('fookey') == d

From c8cb7150abe99b77f9f6bde1fba8ecb527295110 Mon Sep 17 00:00:00 2001
From: Ariel Shtul <ariel.shtul@redislabs.com>
Date: Sun, 14 Nov 2021 14:06:58 +0200
Subject: [PATCH 0253/1164] Call HSET after FT.CREATE to avoid keyspace scan
 (#1706)

---
 tests/test_search.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/tests/test_search.py b/tests/test_search.py
index e07a61c977..75559d37f2 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -643,9 +643,6 @@ def test_alias():
     index1 = getClient()
     index2 = getClient()
 
-    index1.hset("index1:lonestar", mapping={"name": "lonestar"})
-    index2.hset("index2:yogurt", mapping={"name": "yogurt"})
-
     def1 = IndexDefinition(prefix=["index1:"])
     def2 = IndexDefinition(prefix=["index2:"])
 
@@ -654,6 +651,9 @@ def test_alias():
     ftindex1.create_index((TextField("name"),), definition=def1)
     ftindex2.create_index((TextField("name"),), definition=def2)
 
+    index1.hset("index1:lonestar", mapping={"name": "lonestar"})
+    index2.hset("index2:yogurt", mapping={"name": "yogurt"})
+
     res = ftindex1.search("*").docs[0]
     assert "index1:lonestar" == res.id
 

From 46f935186bc068df676dfd03faf91f35aa8fae4a Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 14 Nov 2021 14:14:00 +0200
Subject: [PATCH 0254/1164] FT.EXPLAINCLI intentionally raising
 NotImplementedError (#1705)

---
 redis/commands/search/commands.py | 4 ++++
 tests/test_search.py              | 6 ++++++
 2 files changed, 10 insertions(+)

diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 296fb258ac..0cee2ade4e 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -17,6 +17,7 @@
 ADDHASH_CMD = "FT.ADDHASH"
 DROP_CMD = "FT.DROP"
 EXPLAIN_CMD = "FT.EXPLAIN"
+EXPLAINCLI_CMD = "FT.EXPLAINCLI"
 DEL_CMD = "FT.DEL"
 AGGREGATE_CMD = "FT.AGGREGATE"
 CURSOR_CMD = "FT.CURSOR"
@@ -376,6 +377,9 @@ def explain(self, query):
         args, query_text = self._mk_query_args(query)
         return self.execute_command(EXPLAIN_CMD, *args)
 
+    def explain_cli(self, query):  # noqa
+        raise NotImplementedError("EXPLAINCLI will not be implemented.")
+
     def aggregate(self, query):
         """
         Issue an aggregation query
diff --git a/tests/test_search.py b/tests/test_search.py
index 75559d37f2..d1fc75fb9d 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -611,6 +611,12 @@ def test_explain(client):
     assert res
 
 
+@pytest.mark.redismod
+def test_explaincli(client):
+    with pytest.raises(NotImplementedError):
+        client.ft().explain_cli("foo")
+
+
 @pytest.mark.redismod
 def test_summarize(client):
     createIndex(client.ft())

From 38384931d26d8a1f32e67461d13feb38bd3e8f55 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 14 Nov 2021 14:49:55 +0200
Subject: [PATCH 0255/1164] Re-enabling read-the-docs (#1707)

---
 .readthedocs.yml      |  13 +++
 docs/conf.py          |  16 ++--
 docs/index.rst        |  16 ++++
 docs/make.bat         | 190 ------------------------------------------
 docs/requirements.txt |   2 +
 tox.ini               |   3 +-
 6 files changed, 41 insertions(+), 199 deletions(-)
 create mode 100644 .readthedocs.yml
 delete mode 100644 docs/make.bat
 create mode 100644 docs/requirements.txt

diff --git a/.readthedocs.yml b/.readthedocs.yml
new file mode 100644
index 0000000000..80b9738d82
--- /dev/null
+++ b/.readthedocs.yml
@@ -0,0 +1,13 @@
+version: 2
+
+python:
+  install:
+    - requirements: ./docs/requirements.txt
+
+build:
+  os: ubuntu-20.04
+  tools:
+    python: "3.9"
+
+sphinx:
+  configuration: docs/conf.py
diff --git a/docs/conf.py b/docs/conf.py
index dfdaf9ea57..ff37119467 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -46,16 +46,16 @@
 
 # General information about the project.
 project = "redis-py"
-copyright = "2016, Andy McCurdy"
+copyright = "2021, Redis Inc."
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.
-version = "2.10.5"
+version = "4.0.9"
 # The full version, including alpha/beta/rc tags.
-release = "2.10.5"
+release = "4.0.0"
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -191,7 +191,7 @@
     ("index",
         "redis-py.tex",
         "redis-py Documentation",
-        "Andy McCurdy",
+        "Redis Inc",
         "manual"),
 ]
 
@@ -240,7 +240,7 @@
         "index",
         "redis-py",
         "redis-py Documentation",
-        "Andy McCurdy",
+        "Redis Inc",
         "redis-py",
         "One line description of project.",
         "Miscellaneous",
@@ -257,6 +257,6 @@
 # texinfo_show_urls = 'footnote'
 
 epub_title = "redis-py"
-epub_author = "Andy McCurdy"
-epub_publisher = "Andy McCurdy"
-epub_copyright = "2011, Andy McCurdy"
+epub_author = "Redis Inc"
+epub_publisher = "Redis Inc"
+epub_copyright = "2021, Redis Inc"
diff --git a/docs/index.rst b/docs/index.rst
index bc1a4fac41..8af5385da3 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -22,5 +22,21 @@ Contents:
 .. automodule:: redis
    :members:
 
+.. automodule:: redis.backoff
+   :members:
+
+.. automodule:: redis.connection
+   :members:
+
+.. automodule:: redis.commands
+   :members:
+
+.. automodule:: redis.exceptions
+   :members:
+
+.. automodule:: redis.lock
+   :members:
+
 .. automodule:: redis.sentinel
    :members:
+
diff --git a/docs/make.bat b/docs/make.bat
deleted file mode 100644
index bb2ae4d3da..0000000000
--- a/docs/make.bat
+++ /dev/null
@@ -1,190 +0,0 @@
-@ECHO OFF
-
-REM Command file for Sphinx documentation
-
-if "%SPHINXBUILD%" == "" (
-	set SPHINXBUILD=sphinx-build
-)
-set BUILDDIR=_build
-set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% .
-set I18NSPHINXOPTS=%SPHINXOPTS% .
-if NOT "%PAPER%" == "" (
-	set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%
-	set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS%
-)
-
-if "%1" == "" goto help
-
-if "%1" == "help" (
-	:help
-	echo.Please use `make ^<target^>` where ^<target^> is one of
-	echo.  html       to make standalone HTML files
-	echo.  dirhtml    to make HTML files named index.html in directories
-	echo.  singlehtml to make a single large HTML file
-	echo.  pickle     to make pickle files
-	echo.  json       to make JSON files
-	echo.  htmlhelp   to make HTML files and a HTML help project
-	echo.  qthelp     to make HTML files and a qthelp project
-	echo.  devhelp    to make HTML files and a Devhelp project
-	echo.  epub       to make an epub
-	echo.  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter
-	echo.  text       to make text files
-	echo.  man        to make manual pages
-	echo.  texinfo    to make Texinfo files
-	echo.  gettext    to make PO message catalogs
-	echo.  changes    to make an overview over all changed/added/deprecated items
-	echo.  linkcheck  to check all external links for integrity
-	echo.  doctest    to run all doctests embedded in the documentation if enabled
-	goto end
-)
-
-if "%1" == "clean" (
-	for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i
-	del /q /s %BUILDDIR%\*
-	goto end
-)
-
-if "%1" == "html" (
-	%SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The HTML pages are in %BUILDDIR%/html.
-	goto end
-)
-
-if "%1" == "dirhtml" (
-	%SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml.
-	goto end
-)
-
-if "%1" == "singlehtml" (
-	%SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml.
-	goto end
-)
-
-if "%1" == "pickle" (
-	%SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can process the pickle files.
-	goto end
-)
-
-if "%1" == "json" (
-	%SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can process the JSON files.
-	goto end
-)
-
-if "%1" == "htmlhelp" (
-	%SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can run HTML Help Workshop with the ^
-.hhp project file in %BUILDDIR%/htmlhelp.
-	goto end
-)
-
-if "%1" == "qthelp" (
-	%SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can run "qcollectiongenerator" with the ^
-.qhcp project file in %BUILDDIR%/qthelp, like this:
-	echo.^> qcollectiongenerator %BUILDDIR%\qthelp\redis-py.qhcp
-	echo.To view the help file:
-	echo.^> assistant -collectionFile %BUILDDIR%\qthelp\redis-py.ghc
-	goto end
-)
-
-if "%1" == "devhelp" (
-	%SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished.
-	goto end
-)
-
-if "%1" == "epub" (
-	%SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The epub file is in %BUILDDIR%/epub.
-	goto end
-)
-
-if "%1" == "latex" (
-	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; the LaTeX files are in %BUILDDIR%/latex.
-	goto end
-)
-
-if "%1" == "text" (
-	%SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The text files are in %BUILDDIR%/text.
-	goto end
-)
-
-if "%1" == "man" (
-	%SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The manual pages are in %BUILDDIR%/man.
-	goto end
-)
-
-if "%1" == "texinfo" (
-	%SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo.
-	goto end
-)
-
-if "%1" == "gettext" (
-	%SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The message catalogs are in %BUILDDIR%/locale.
-	goto end
-)
-
-if "%1" == "changes" (
-	%SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.The overview file is in %BUILDDIR%/changes.
-	goto end
-)
-
-if "%1" == "linkcheck" (
-	%SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Link check complete; look for any errors in the above output ^
-or in %BUILDDIR%/linkcheck/output.txt.
-	goto end
-)
-
-if "%1" == "doctest" (
-	%SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Testing of doctests in the sources finished, look at the ^
-results in %BUILDDIR%/doctest/output.txt.
-	goto end
-)
-
-:end
diff --git a/docs/requirements.txt b/docs/requirements.txt
new file mode 100644
index 0000000000..2e1c4fbdce
--- /dev/null
+++ b/docs/requirements.txt
@@ -0,0 +1,2 @@
+sphinx<2
+docutils<0.18
diff --git a/tox.ini b/tox.ini
index 1d4da0829b..6d4c65849b 100644
--- a/tox.ini
+++ b/tox.ini
@@ -127,7 +127,8 @@ exclude =
     .tox,
     .venv*,
     build,
+    docs/*,
     dist,
     docker,
     venv*,
-    whitelist.py
\ No newline at end of file
+    whitelist.py

From c02d7209be5aeefe27c7ac2e740dafc4d969ec47 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Mon, 15 Nov 2021 13:42:48 +0200
Subject: [PATCH 0256/1164] 4.0.0 (#1708)

* 4.0.0
---
 MANIFEST.in       | 3 +--
 RELEASE           | 9 ---------
 docs/conf.py      | 5 +++--
 redis/__init__.py | 4 +++-
 4 files changed, 7 insertions(+), 14 deletions(-)
 delete mode 100644 RELEASE

diff --git a/MANIFEST.in b/MANIFEST.in
index 7aaee12a1d..97fa305889 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -1,7 +1,6 @@
-include CHANGES
 include INSTALL
 include LICENSE
-include README.rst
+include README.md
 exclude __pycache__
 recursive-include tests *
 recursive-exclude tests *.pyc
diff --git a/RELEASE b/RELEASE
deleted file mode 100644
index f45b0bf9f6..0000000000
--- a/RELEASE
+++ /dev/null
@@ -1,9 +0,0 @@
-Release Process
-===============
-
-1. Make sure all tests pass.
-2. Make sure CHANGES is up to date.
-3. Update redis.__init__.__version__ and commit
-4. git tag <version-number>
-5. git push --tag
-6. rm dist/* && python setup.py sdist bdist_wheel && twine upload dist/*
diff --git a/docs/conf.py b/docs/conf.py
index ff37119467..f497e3da15 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -46,14 +46,15 @@
 
 # General information about the project.
 project = "redis-py"
-copyright = "2021, Redis Inc."
+copyright = "2021, Redis Inc"
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.
-version = "4.0.9"
+version = "4.0"
+
 # The full version, including alpha/beta/rc tags.
 release = "4.0.0"
 
diff --git a/redis/__init__.py b/redis/__init__.py
index c0dd690bc9..5d635431ea 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -37,7 +37,9 @@ def int_or_str(value):
         return value
 
 
-__version__ = '4.0.0rc2'
+__version__ = "4.0.0"
+
+
 VERSION = tuple(map(int_or_str, __version__.split('.')))
 
 __all__ = [

From e74ed1942a746683ece792cb1670c544f599246f Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 17 Nov 2021 11:54:45 +0200
Subject: [PATCH 0257/1164] removing hiredis warning (#1721)

---
 redis/__init__.py   | 2 +-
 redis/connection.py | 5 -----
 2 files changed, 1 insertion(+), 6 deletions(-)

diff --git a/redis/__init__.py b/redis/__init__.py
index 5d635431ea..480ffd8992 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -37,7 +37,7 @@ def int_or_str(value):
         return value
 
 
-__version__ = "4.0.0"
+__version__ = "4.0.1"
 
 
 VERSION = tuple(map(int_or_str, __version__.split('.')))
diff --git a/redis/connection.py b/redis/connection.py
index cb9acb4595..35e9491ba5 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -63,11 +63,6 @@
     HIREDIS_SUPPORTS_ENCODING_ERRORS = \
         hiredis_version >= LooseVersion('1.0.0')
 
-    if not HIREDIS_SUPPORTS_BYTE_BUFFER:
-        msg = ("redis-py works best with hiredis >= 0.1.4. You're running "
-               "hiredis %s. Please consider upgrading." % hiredis.__version__)
-        warnings.warn(msg)
-
     HIREDIS_USE_BYTE_BUFFER = True
     # only use byte buffer if hiredis supports it
     if not HIREDIS_SUPPORTS_BYTE_BUFFER:

From 4e9cc015e32ef305429ff9dfa200e28dd63e6663 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 17 Nov 2021 11:55:03 +0200
Subject: [PATCH 0258/1164] Removing command on initial connections (#1722)

---
 redis/client.py                | 18 ------------------
 redis/commands/redismodules.py | 13 -------------
 tests/conftest.py              |  3 ++-
 3 files changed, 2 insertions(+), 32 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 753770e3e2..3230043a62 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -890,12 +890,6 @@ def __init__(self, host='localhost', port=6379,
         self.response_callbacks = CaseInsensitiveDict(
             self.__class__.RESPONSE_CALLBACKS)
 
-        # preload our class with the available redis commands
-        try:
-            self.__redis_commands__()
-        except RedisError:
-            pass
-
     def __repr__(self):
         return "%s<%s>" % (type(self).__name__, repr(self.connection_pool))
 
@@ -927,18 +921,6 @@ def load_external_module(self, funcname, func,
         """
         setattr(self, funcname, func)
 
-    def __redis_commands__(self):
-        """Store the list of available commands, for our redis instance."""
-        cmds = getattr(self, '__commands__', None)
-        if cmds is not None:
-            return cmds
-        try:
-            cmds = [c[0].upper().decode() for c in self.command()]
-        except AttributeError:  # if encoded
-            cmds = [c[0].upper() for c in self.command()]
-        self.__commands__ = cmds
-        return cmds
-
     def pipeline(self, transaction=True, shard_hint=None):
         """
         Return a new pipeline object that can queue multiple commands for
diff --git a/redis/commands/redismodules.py b/redis/commands/redismodules.py
index b3cbee1d87..5f629fb5ea 100644
--- a/redis/commands/redismodules.py
+++ b/redis/commands/redismodules.py
@@ -1,5 +1,4 @@
 from json import JSONEncoder, JSONDecoder
-from redis.exceptions import ModuleError
 
 
 class RedisModuleCommands:
@@ -10,10 +9,6 @@ class RedisModuleCommands:
     def json(self, encoder=JSONEncoder(), decoder=JSONDecoder()):
         """Access the json namespace, providing support for redis json.
         """
-        if 'JSON.SET' not in self.__commands__:
-            raise ModuleError("redisjson is not loaded in redis. "
-                              "For more information visit "
-                              "https://redisjson.io/")
 
         from .json import JSON
         jj = JSON(
@@ -25,10 +20,6 @@ def json(self, encoder=JSONEncoder(), decoder=JSONDecoder()):
     def ft(self, index_name="idx"):
         """Access the search namespace, providing support for redis search.
         """
-        if 'FT.INFO' not in self.__commands__:
-            raise ModuleError("redisearch is not loaded in redis. "
-                              "For more information visit "
-                              "https://redisearch.io/")
 
         from .search import Search
         s = Search(client=self, index_name=index_name)
@@ -38,10 +29,6 @@ def ts(self):
         """Access the timeseries namespace, providing support for
         redis timeseries data.
         """
-        if 'TS.INFO' not in self.__commands__:
-            raise ModuleError("reditimeseries is not loaded in redis. "
-                              "For more information visit "
-                              "https://redistimeseries.io/")
 
         from .timeseries import TimeSeries
         s = TimeSeries(client=self)
diff --git a/tests/conftest.py b/tests/conftest.py
index 31d3fbd1a8..9504333354 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -31,7 +31,8 @@ def pytest_addoption(parser):
 def _get_info(redis_url):
     client = redis.Redis.from_url(redis_url)
     info = client.info()
-    if 'dping' in client.__commands__:
+    cmds = [c[0].upper().decode() for c in client.command()]
+    if 'dping' in cmds:
         info["enterprise"] = True
     else:
         info["enterprise"] = False

From 791f482dcb320f48cf950c4b2c6047d1981a8f67 Mon Sep 17 00:00:00 2001
From: Alex Wu <itswu.alex@gmail.com>
Date: Sat, 20 Nov 2021 23:47:44 -0800
Subject: [PATCH 0259/1164] Better removal of hiredis warning (#1726)

Co-authored-by: Alex Wu <alex@anyscale.com>
---
 redis/__init__.py   | 2 +-
 redis/connection.py | 4 ----
 2 files changed, 1 insertion(+), 5 deletions(-)

diff --git a/redis/__init__.py b/redis/__init__.py
index 480ffd8992..dc9b11a7b8 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -37,7 +37,7 @@ def int_or_str(value):
         return value
 
 
-__version__ = "4.0.1"
+__version__ = "4.0.2"
 
 
 VERSION = tuple(map(int_or_str, __version__.split('.')))
diff --git a/redis/connection.py b/redis/connection.py
index 35e9491ba5..e01742d70e 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -9,7 +9,6 @@
 import os
 import socket
 import threading
-import warnings
 import weakref
 
 from redis.exceptions import (
@@ -67,9 +66,6 @@
     # only use byte buffer if hiredis supports it
     if not HIREDIS_SUPPORTS_BYTE_BUFFER:
         HIREDIS_USE_BYTE_BUFFER = False
-else:
-    msg = "redis-py works best with hiredis. Please consider installing"
-    warnings.warn(msg)
 
 SYM_STAR = b'*'
 SYM_DOLLAR = b'$'

From d2b233384458869270352b8c99ca682ae480da5f Mon Sep 17 00:00:00 2001
From: Sam Culley <sam@samculley.co.uk>
Date: Sun, 21 Nov 2021 07:47:59 +0000
Subject: [PATCH 0260/1164] fix: adding sentinelcommands to redis client
 (#1723)

Co-authored-by: Sam Culley <sam.culley@novatiq.com>
---
 redis/client.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 3230043a62..dc6693d111 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -6,7 +6,8 @@
 import threading
 import time
 import warnings
-from redis.commands import CoreCommands, RedisModuleCommands, list_or_args
+from redis.commands import (CoreCommands, RedisModuleCommands,
+                            SentinelCommands, list_or_args)
 from redis.connection import (ConnectionPool, UnixDomainSocketConnection,
                               SSLConnection)
 from redis.lock import Lock
@@ -606,7 +607,7 @@ def parse_set_result(response, **options):
     return response and str_if_bytes(response) == 'OK'
 
 
-class Redis(RedisModuleCommands, CoreCommands, object):
+class Redis(RedisModuleCommands, CoreCommands, SentinelCommands, object):
     """
     Implementation of the Redis protocol.
 

From 64791a54f4b2c28b6a61920a23df9e1f614e6983 Mon Sep 17 00:00:00 2001
From: Carlosbogo <84228424+Carlosbogo@users.noreply.github.com>
Date: Sun, 21 Nov 2021 14:44:18 +0100
Subject: [PATCH 0261/1164] Adding links to redis documents in function calls
 (#1719)

---
 redis/commands/core.py | 762 ++++++++++++++++++++++++++++++++++++-----
 1 file changed, 683 insertions(+), 79 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 516e7d9c83..5fad0b65f1 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -28,12 +28,18 @@ def acl_cat(self, category=None):
         If ``category`` is not supplied, returns a list of all categories.
         If ``category`` is supplied, returns a list of all commands within
         that category.
+
+        For more information check https://redis.io/commands/acl-cat
         """
         pieces = [category] if category else []
         return self.execute_command('ACL CAT', *pieces)
 
     def acl_deluser(self, *username):
-        "Delete the ACL for the specified ``username``s"
+        """
+        Delete the ACL for the specified ``username``s
+
+        For more information check https://redis.io/commands/acl-deluser
+        """
         return self.execute_command('ACL DELUSER', *username)
 
     def acl_genpass(self, bits=None):
@@ -58,17 +64,25 @@ def acl_getuser(self, username):
         Get the ACL details for the specified ``username``.
 
         If ``username`` does not exist, return None
+
+        For more information check https://redis.io/commands/acl-getuser
         """
         return self.execute_command('ACL GETUSER', username)
 
     def acl_help(self):
         """The ACL HELP command returns helpful text describing
         the different subcommands.
+
+        For more information check https://redis.io/commands/acl-help
         """
         return self.execute_command('ACL HELP')
 
     def acl_list(self):
-        "Return a list of all ACLs on the server"
+        """
+        Return a list of all ACLs on the server
+
+        For more information check https://redis.io/commands/acl-list
+        """
         return self.execute_command('ACL LIST')
 
     def acl_log(self, count=None):
@@ -76,6 +90,8 @@ def acl_log(self, count=None):
         Get ACL logs as a list.
         :param int count: Get logs[0:count].
         :rtype: List.
+
+        For more information check https://redis.io/commands/acl-log
         """
         args = []
         if count is not None:
@@ -90,6 +106,8 @@ def acl_log_reset(self):
         """
         Reset ACL logs.
         :rtype: Boolean.
+
+        For more information check https://redis.io/commands/acl-log
         """
         args = [b'RESET']
         return self.execute_command('ACL LOG', *args)
@@ -100,6 +118,8 @@ def acl_load(self):
 
         Note that the server must be configured with the ``aclfile``
         directive to be able to load ACL rules from an aclfile.
+
+        For more information check https://redis.io/commands/acl-load
         """
         return self.execute_command('ACL LOAD')
 
@@ -109,6 +129,8 @@ def acl_save(self):
 
         Note that the server must be configured with the ``aclfile``
         directive to be able to save ACL rules to an aclfile.
+
+        For more information check https://redis.io/commands/acl-save
         """
         return self.execute_command('ACL SAVE')
 
@@ -174,6 +196,8 @@ def acl_setuser(self, username, enabled=False, nopass=False,
         'hashed_passwords'. If this is False, the user's existing passwords
         and 'nopass' status will be kept and any new specified passwords
         or hashed_passwords will be applied on top.
+
+        For more information check https://redis.io/commands/acl-setuser
         """
         encoder = self.connection_pool.get_encoder()
         pieces = [username]
@@ -260,21 +284,32 @@ def acl_setuser(self, username, enabled=False, nopass=False,
         return self.execute_command('ACL SETUSER', *pieces)
 
     def acl_users(self):
-        "Returns a list of all registered users on the server."
+        """Returns a list of all registered users on the server.
+
+        For more information check https://redis.io/commands/acl-users
+        """
         return self.execute_command('ACL USERS')
 
     def acl_whoami(self):
-        "Get the username for the current connection"
+        """Get the username for the current connection
+
+        For more information check https://redis.io/commands/acl-whoami
+        """
         return self.execute_command('ACL WHOAMI')
 
     def bgrewriteaof(self):
-        "Tell the Redis server to rewrite the AOF file from data in memory."
+        """Tell the Redis server to rewrite the AOF file from data in memory.
+
+        For more information check https://redis.io/commands/bgrewriteaof
+        """
         return self.execute_command('BGREWRITEAOF')
 
     def bgsave(self, schedule=True):
         """
         Tell the Redis server to save its data to disk.  Unlike save(),
         this method is asynchronous and returns immediately.
+
+        For more information check https://redis.io/commands/bgsave
         """
         pieces = []
         if schedule:
@@ -282,7 +317,10 @@ def bgsave(self, schedule=True):
         return self.execute_command('BGSAVE', *pieces)
 
     def client_kill(self, address):
-        "Disconnects the client at ``address`` (ip:port)"
+        """Disconnects the client at ``address`` (ip:port)
+
+        For more information check https://redis.io/commands/client-kill
+        """
         return self.execute_command('CLIENT KILL', address)
 
     def client_kill_filter(self, _id=None, _type=None, addr=None,
@@ -330,6 +368,8 @@ def client_info(self):
         """
         Returns information and statistics about the current
         client connection.
+
+        For more information check https://redis.io/commands/client-info
         """
         return self.execute_command('CLIENT INFO')
 
@@ -340,8 +380,9 @@ def client_list(self, _type=None, client_id=[]):
         :param _type: optional. one of the client types (normal, master,
          replica, pubsub)
         :param client_id: optional. a list of client ids
+
+        For more information check https://redis.io/commands/client-list
         """
-        "Returns a list of currently connected clients"
         args = []
         if _type is not None:
             client_types = ('normal', 'master', 'replica', 'pubsub')
@@ -358,11 +399,16 @@ def client_list(self, _type=None, client_id=[]):
         return self.execute_command('CLIENT LIST', *args)
 
     def client_getname(self):
-        """Returns the current connection name"""
+        """
+        Returns the current connection name
+
+        For more information check https://redis.io/commands/client-getname
+        """
         return self.execute_command('CLIENT GETNAME')
 
     def client_getredir(self):
-        """Returns the ID (an integer) of the client to whom we are
+        """
+        Returns the ID (an integer) of the client to whom we are
         redirecting tracking notifications.
 
         see: https://redis.io/commands/client-getredir
@@ -370,7 +416,8 @@ def client_getredir(self):
         return self.execute_command('CLIENT GETREDIR')
 
     def client_reply(self, reply):
-        """Enable and disable redis server replies.
+        """
+        Enable and disable redis server replies.
         ``reply`` Must be ON OFF or SKIP,
             ON - The default most with server replies to commands
             OFF - Disable server responses to commands
@@ -381,6 +428,7 @@ def client_reply(self, reply):
         TimeoutError.
               The test_client_reply unit test illustrates this, and
               conftest.py has a client with a timeout.
+
         See https://redis.io/commands/client-reply
         """
         replies = ['ON', 'OFF', 'SKIP']
@@ -389,19 +437,28 @@ def client_reply(self, reply):
         return self.execute_command("CLIENT REPLY", reply)
 
     def client_id(self):
-        """Returns the current connection id"""
+        """
+        Returns the current connection id
+
+        For more information check https://redis.io/commands/client-id
+        """
         return self.execute_command('CLIENT ID')
 
     def client_trackinginfo(self):
         """
         Returns the information about the current client connection's
         use of the server assisted client side cache.
+
         See https://redis.io/commands/client-trackinginfo
         """
         return self.execute_command('CLIENT TRACKINGINFO')
 
     def client_setname(self, name):
-        "Sets the current connection name"
+        """
+        Sets the current connection name
+
+        For more information check https://redis.io/commands/client-setname
+        """
         return self.execute_command('CLIENT SETNAME', name)
 
     def client_unblock(self, client_id, error=False):
@@ -410,6 +467,8 @@ def client_unblock(self, client_id, error=False):
         If ``error`` is True, unblocks the client with a special error message.
         If ``error`` is False (default), the client is unblocked using the
         regular timeout mechanism.
+
+        For more information check https://redis.io/commands/client-unblock
         """
         args = ['CLIENT UNBLOCK', int(client_id)]
         if error:
@@ -420,6 +479,8 @@ def client_pause(self, timeout):
         """
         Suspend all the Redis clients for the specified amount of time
         :param timeout: milliseconds to pause clients
+
+        For more information check https://redis.io/commands/client-pause
         """
         if not isinstance(timeout, int):
             raise DataError("CLIENT PAUSE timeout must be an integer")
@@ -428,54 +489,89 @@ def client_pause(self, timeout):
     def client_unpause(self):
         """
         Unpause all redis clients
+
+        For more information check https://redis.io/commands/client-unpause
         """
         return self.execute_command('CLIENT UNPAUSE')
 
     def readwrite(self):
         """
         Disables read queries for a connection to a Redis Cluster slave node.
+
+        For more information check https://redis.io/commands/readwrite
         """
         return self.execute_command('READWRITE')
 
     def readonly(self):
         """
         Enables read queries for a connection to a Redis Cluster replica node.
+
+        For more information check https://redis.io/commands/readonly
         """
         return self.execute_command('READONLY')
 
     def config_get(self, pattern="*"):
-        """Return a dictionary of configuration based on the ``pattern``"""
+        """
+        Return a dictionary of configuration based on the ``pattern``
+
+        For more information check https://redis.io/commands/config-get
+        """
         return self.execute_command('CONFIG GET', pattern)
 
     def config_set(self, name, value):
-        "Set config item ``name`` with ``value``"
+        """Set config item ``name`` with ``value``
+
+        For more information check https://redis.io/commands/config-set
+        """
         return self.execute_command('CONFIG SET', name, value)
 
     def config_resetstat(self):
-        """Reset runtime statistics"""
+        """
+        Reset runtime statistics
+
+        For more information check https://redis.io/commands/config-resetstat
+        """
         return self.execute_command('CONFIG RESETSTAT')
 
     def config_rewrite(self):
         """
         Rewrite config file with the minimal change to reflect running config.
+
+        For more information check https://redis.io/commands/config-rewrite
         """
         return self.execute_command('CONFIG REWRITE')
 
     def dbsize(self):
-        """Returns the number of keys in the current database"""
+        """
+        Returns the number of keys in the current database
+
+        For more information check https://redis.io/commands/dbsize
+        """
         return self.execute_command('DBSIZE')
 
     def debug_object(self, key):
-        """Returns version specific meta information about a given key"""
+        """
+        Returns version specific meta information about a given key
+
+        For more information check https://redis.io/commands/debug-object
+        """
         return self.execute_command('DEBUG OBJECT', key)
 
     def debug_segfault(self):
         raise NotImplementedError(
-            "DEBUG SEGFAULT is intentionally not implemented in the client."
+            """
+            DEBUG SEGFAULT is intentionally not implemented in the client.
+
+            For more information check https://redis.io/commands/debug-segfault
+            """
         )
 
     def echo(self, value):
-        """Echo the string back from the server"""
+        """
+        Echo the string back from the server
+
+        For more information check https://redis.io/commands/echo
+        """
         return self.execute_command('ECHO', value)
 
     def flushall(self, asynchronous=False):
@@ -484,6 +580,8 @@ def flushall(self, asynchronous=False):
 
         ``asynchronous`` indicates whether the operation is
         executed asynchronously by the server.
+
+        For more information check https://redis.io/commands/flushall
         """
         args = []
         if asynchronous:
@@ -496,6 +594,8 @@ def flushdb(self, asynchronous=False):
 
         ``asynchronous`` indicates whether the operation is
         executed asynchronously by the server.
+
+        For more information check https://redis.io/commands/flushdb
         """
         args = []
         if asynchronous:
@@ -503,7 +603,11 @@ def flushdb(self, asynchronous=False):
         return self.execute_command('FLUSHDB', *args)
 
     def swapdb(self, first, second):
-        "Swap two databases"
+        """
+        Swap two databases
+
+        For more information check https://redis.io/commands/swapdb
+        """
         return self.execute_command('SWAPDB', first, second)
 
     def info(self, section=None):
@@ -515,6 +619,8 @@ def info(self, section=None):
 
         The section option is not supported by older versions of Redis Server,
         and will generate ResponseError
+
+        For more information check https://redis.io/commands/info
         """
         if section is None:
             return self.execute_command('INFO')
@@ -525,12 +631,15 @@ def lastsave(self):
         """
         Return a Python datetime object representing the last time the
         Redis database was saved to disk
+
+        For more information check https://redis.io/commands/lastsave
         """
         return self.execute_command('LASTSAVE')
 
     def lolwut(self, *version_numbers):
         """
         Get the Redis version and a piece of generative computer art
+
         See: https://redis.io/commands/lolwut
         """
         if version_numbers:
@@ -556,6 +665,8 @@ def migrate(self, host, port, keys, destination_db, timeout,
 
         If ``auth`` is specified, authenticate to the destination server with
         the password provided.
+
+        For more information check https://redis.io/commands/migrate
         """
         keys = list_or_args(keys, [])
         if not keys:
@@ -574,25 +685,43 @@ def migrate(self, host, port, keys, destination_db, timeout,
                                     timeout, *pieces)
 
     def object(self, infotype, key):
-        """Return the encoding, idletime, or refcount about the key"""
+        """
+        Return the encoding, idletime, or refcount about the key
+        """
         return self.execute_command('OBJECT', infotype, key, infotype=infotype)
 
     def memory_doctor(self):
         raise NotImplementedError(
-            "MEMORY DOCTOR is intentionally not implemented in the client."
+            """
+            MEMORY DOCTOR is intentionally not implemented in the client.
+
+            For more information check https://redis.io/commands/memory-doctor
+            """
         )
 
     def memory_help(self):
         raise NotImplementedError(
-            "MEMORY HELP is intentionally not implemented in the client."
+            """
+            MEMORY HELP is intentionally not implemented in the client.
+
+            For more information check https://redis.io/commands/memory-help
+            """
         )
 
     def memory_stats(self):
-        """Return a dictionary of memory stats"""
+        """
+        Return a dictionary of memory stats
+
+        For more information check https://redis.io/commands/memory-stats
+        """
         return self.execute_command('MEMORY STATS')
 
     def memory_malloc_stats(self):
-        """Return an internal statistics report from the memory allocator."""
+        """
+        Return an internal statistics report from the memory allocator.
+
+        See: https://redis.io/commands/memory-malloc-stats
+        """
         return self.execute_command('MEMORY MALLOC-STATS')
 
     def memory_usage(self, key, samples=None):
@@ -603,6 +732,8 @@ def memory_usage(self, key, samples=None):
         For nested data structures, ``samples`` is the number of elements to
         sample. If left unspecified, the server's default is 5. Use 0 to sample
         all elements.
+
+        For more information check https://redis.io/commands/memory-usage
         """
         args = []
         if isinstance(samples, int):
@@ -610,17 +741,26 @@ def memory_usage(self, key, samples=None):
         return self.execute_command('MEMORY USAGE', key, *args)
 
     def memory_purge(self):
-        """Attempts to purge dirty pages for reclamation by allocator"""
+        """
+        Attempts to purge dirty pages for reclamation by allocator
+
+        For more information check https://redis.io/commands/memory-purge
+        """
         return self.execute_command('MEMORY PURGE')
 
     def ping(self):
-        """Ping the Redis server"""
+        """
+        Ping the Redis server
+
+        For more information check https://redis.io/commands/ping
+        """
         return self.execute_command('PING')
 
     def quit(self):
         """
         Ask the server to close the connection.
-        https://redis.io/commands/quit
+
+        For more information check https://redis.io/commands/quit
         """
         return self.execute_command('QUIT')
 
@@ -628,6 +768,8 @@ def save(self):
         """
         Tell the Redis server to save its data to disk,
         blocking until the save is complete
+
+        For more information check https://redis.io/commands/save
         """
         return self.execute_command('SAVE')
 
@@ -637,6 +779,8 @@ def shutdown(self, save=False, nosave=False):
         a data flush will be attempted even if there is no persistence
         configured.  If the "nosave" option is set, no data flush will be
         attempted.  The "save" and "nosave" options cannot both be set.
+
+        For more information check https://redis.io/commands/shutdown
         """
         if save and nosave:
             raise DataError('SHUTDOWN save and nosave cannot both be set')
@@ -657,6 +801,8 @@ def slaveof(self, host=None, port=None):
         Set the server to be a replicated slave of the instance identified
         by the ``host`` and ``port``. If called without arguments, the
         instance is promoted to a master instead.
+
+        For more information check https://redis.io/commands/slaveof
         """
         if host is None and port is None:
             return self.execute_command('SLAVEOF', b'NO', b'ONE')
@@ -666,6 +812,8 @@ def slowlog_get(self, num=None):
         """
         Get the entries from the slowlog. If ``num`` is specified, get the
         most recent ``num`` items.
+
+        For more information check https://redis.io/commands/slowlog-get
         """
         args = ['SLOWLOG GET']
         if num is not None:
@@ -675,17 +823,27 @@ def slowlog_get(self, num=None):
         return self.execute_command(*args, decode_responses=decode_responses)
 
     def slowlog_len(self):
-        "Get the number of items in the slowlog"
+        """
+        Get the number of items in the slowlog
+
+        For more information check https://redis.io/commands/slowlog-len
+        """
         return self.execute_command('SLOWLOG LEN')
 
     def slowlog_reset(self):
-        "Remove all items in the slowlog"
+        """
+        Remove all items in the slowlog
+
+        For more information check https://redis.io/commands/slowlog-reset
+        """
         return self.execute_command('SLOWLOG RESET')
 
     def time(self):
         """
         Returns the server time as a 2-item tuple of ints:
         (seconds since epoch, microseconds into this second).
+
+        For more information check https://redis.io/commands/time
         """
         return self.execute_command('TIME')
 
@@ -695,6 +853,8 @@ def wait(self, num_replicas, timeout):
         That returns the number of replicas that processed the query when
         we finally have at least ``num_replicas``, or when the ``timeout`` was
         reached.
+
+        For more information check https://redis.io/commands/wait
         """
         return self.execute_command('WAIT', num_replicas, timeout)
 
@@ -704,6 +864,8 @@ def append(self, key, value):
         Appends the string ``value`` to the value at ``key``. If ``key``
         doesn't already exist, create it with a value of ``value``.
         Returns the new length of the value at ``key``.
+
+        For more information check https://redis.io/commands/append
         """
         return self.execute_command('APPEND', key, value)
 
@@ -711,6 +873,8 @@ def bitcount(self, key, start=None, end=None):
         """
         Returns the count of set bits in the value of ``key``.  Optional
         ``start`` and ``end`` parameters indicate which bytes to consider
+
+        For more information check https://redis.io/commands/bitcount
         """
         params = [key]
         if start is not None and end is not None:
@@ -725,6 +889,8 @@ def bitfield(self, key, default_overflow=None):
         """
         Return a BitFieldOperation instance to conveniently construct one or
         more bitfield operations on ``key``.
+
+        For more information check https://redis.io/commands/bitfield
         """
         return BitFieldOperation(self, key, default_overflow=default_overflow)
 
@@ -732,6 +898,8 @@ def bitop(self, operation, dest, *keys):
         """
         Perform a bitwise operation using ``operation`` between ``keys`` and
         store the result in ``dest``.
+
+        For more information check https://redis.io/commands/bitop
         """
         return self.execute_command('BITOP', operation, dest, *keys)
 
@@ -741,6 +909,8 @@ def bitpos(self, key, bit, start=None, end=None):
         ``start`` and ``end`` defines search range. The range is interpreted
         as a range of bytes and not a range of bits, so start=0 and end=2
         means to look at the first three bytes.
+
+        For more information check https://redis.io/commands/bitpos
         """
         if bit not in (0, 1):
             raise DataError('bit must be 0 or 1')
@@ -765,6 +935,8 @@ def copy(self, source, destination, destination_db=None, replace=False):
         ``replace`` whether the ``destination`` key should be removed before
         copying the value to it. By default, the value is not copied if
         the ``destination`` key already exists.
+
+        For more information check https://redis.io/commands/copy
         """
         params = [source, destination]
         if destination_db is not None:
@@ -777,6 +949,8 @@ def decr(self, name, amount=1):
         """
         Decrements the value of ``key`` by ``amount``.  If no key exists,
         the value will be initialized as 0 - ``amount``
+
+        For more information check https://redis.io/commands/decr
         """
         # An alias for ``decr()``, because it is already implemented
         # as DECRBY redis command.
@@ -786,11 +960,15 @@ def decrby(self, name, amount=1):
         """
         Decrements the value of ``key`` by ``amount``.  If no key exists,
         the value will be initialized as 0 - ``amount``
+
+        For more information check https://redis.io/commands/decrby
         """
         return self.execute_command('DECRBY', name, amount)
 
     def delete(self, *names):
-        "Delete one or more keys specified by ``names``"
+        """
+        Delete one or more keys specified by ``names``
+        """
         return self.execute_command('DEL', *names)
 
     def __delitem__(self, name):
@@ -800,11 +978,17 @@ def dump(self, name):
         """
         Return a serialized version of the value stored at the specified key.
         If key does not exist a nil bulk reply is returned.
+
+        For more information check https://redis.io/commands/dump
         """
         return self.execute_command('DUMP', name)
 
     def exists(self, *names):
-        "Returns the number of ``names`` that exist"
+        """
+        Returns the number of ``names`` that exist
+
+        For more information check https://redis.io/commands/exists
+        """
         return self.execute_command('EXISTS', *names)
     __contains__ = exists
 
@@ -812,6 +996,8 @@ def expire(self, name, time):
         """
         Set an expire flag on key ``name`` for ``time`` seconds. ``time``
         can be represented by an integer or a Python timedelta object.
+
+        For more information check https://redis.io/commands/expire
         """
         if isinstance(time, datetime.timedelta):
             time = int(time.total_seconds())
@@ -821,6 +1007,8 @@ def expireat(self, name, when):
         """
         Set an expire flag on key ``name``. ``when`` can be represented
         as an integer indicating unix time or a Python datetime object.
+
+        For more information check https://redis.io/commands/expireat
         """
         if isinstance(when, datetime.datetime):
             when = int(time.mktime(when.timetuple()))
@@ -829,6 +1017,8 @@ def expireat(self, name, when):
     def get(self, name):
         """
         Return the value at key ``name``, or None if the key doesn't exist
+
+        For more information check https://redis.io/commands/get
         """
         return self.execute_command('GET', name)
 
@@ -838,6 +1028,8 @@ def getdel(self, name):
         is similar to GET, except for the fact that it also deletes
         the key on success (if and only if the key's value type
         is a string).
+
+        For more information check https://redis.io/commands/getdel
         """
         return self.execute_command('GETDEL', name)
 
@@ -860,6 +1052,8 @@ def getex(self, name,
         specified in unix time.
 
         ``persist`` remove the time to live associated with ``name``.
+
+        For more information check https://redis.io/commands/getex
         """
 
         opset = set([ex, px, exat, pxat])
@@ -908,13 +1102,19 @@ def __getitem__(self, name):
         raise KeyError(name)
 
     def getbit(self, name, offset):
-        "Returns a boolean indicating the value of ``offset`` in ``name``"
+        """
+        Returns a boolean indicating the value of ``offset`` in ``name``
+
+        For more information check https://redis.io/commands/getbit
+        """
         return self.execute_command('GETBIT', name, offset)
 
     def getrange(self, key, start, end):
         """
         Returns the substring of the string value stored at ``key``,
         determined by the offsets ``start`` and ``end`` (both are inclusive)
+
+        For more information check https://redis.io/commands/getrange
         """
         return self.execute_command('GETRANGE', key, start, end)
 
@@ -925,6 +1125,8 @@ def getset(self, name, value):
 
         As per Redis 6.2, GETSET is considered deprecated.
         Please use SET with GET parameter in new code.
+
+        For more information check https://redis.io/commands/getset
         """
         return self.execute_command('GETSET', name, value)
 
@@ -932,6 +1134,8 @@ def incr(self, name, amount=1):
         """
         Increments the value of ``key`` by ``amount``.  If no key exists,
         the value will be initialized as ``amount``
+
+        For more information check https://redis.io/commands/incr
         """
         return self.incrby(name, amount)
 
@@ -939,6 +1143,8 @@ def incrby(self, name, amount=1):
         """
         Increments the value of ``key`` by ``amount``.  If no key exists,
         the value will be initialized as ``amount``
+
+        For more information check https://redis.io/commands/incrby
         """
         # An alias for ``incr()``, because it is already implemented
         # as INCRBY redis command.
@@ -948,11 +1154,17 @@ def incrbyfloat(self, name, amount=1.0):
         """
         Increments the value at key ``name`` by floating ``amount``.
         If no key exists, the value will be initialized as ``amount``
+
+        For more information check https://redis.io/commands/incrbyfloat
         """
         return self.execute_command('INCRBYFLOAT', name, amount)
 
     def keys(self, pattern='*'):
-        "Returns a list of keys matching ``pattern``"
+        """
+        Returns a list of keys matching ``pattern``
+
+        For more information check https://redis.io/commands/keys
+        """
         return self.execute_command('KEYS', pattern)
 
     def lmove(self, first_list, second_list, src="LEFT", dest="RIGHT"):
@@ -960,6 +1172,8 @@ def lmove(self, first_list, second_list, src="LEFT", dest="RIGHT"):
         Atomically returns and removes the first/last element of a list,
         pushing it as the first/last element on the destination list.
         Returns the element being popped and pushed.
+
+        For more information check https://redis.io/commands/lmov
         """
         params = [first_list, second_list, src, dest]
         return self.execute_command("LMOVE", *params)
@@ -968,6 +1182,8 @@ def blmove(self, first_list, second_list, timeout,
                src="LEFT", dest="RIGHT"):
         """
         Blocking version of lmove.
+
+        For more information check https://redis.io/commands/blmove
         """
         params = [first_list, second_list, src, dest, timeout]
         return self.execute_command("BLMOVE", *params)
@@ -975,6 +1191,8 @@ def blmove(self, first_list, second_list, timeout,
     def mget(self, keys, *args):
         """
         Returns a list of values ordered identically to ``keys``
+
+        For more information check https://redis.io/commands/mget
         """
         from redis.client import EMPTY_RESPONSE
         args = list_or_args(keys, args)
@@ -988,6 +1206,8 @@ def mset(self, mapping):
         Sets key/values based on a mapping. Mapping is a dictionary of
         key/value pairs. Both keys and values should be strings or types that
         can be cast to a string via str().
+
+        For more information check https://redis.io/commands/mset
         """
         items = []
         for pair in mapping.items():
@@ -1000,6 +1220,8 @@ def msetnx(self, mapping):
         Mapping is a dictionary of key/value pairs. Both keys and values
         should be strings or types that can be cast to a string via str().
         Returns a boolean indicating if the operation was successful.
+
+        For more information check https://redis.io/commands/msetnx
         """
         items = []
         for pair in mapping.items():
@@ -1007,11 +1229,19 @@ def msetnx(self, mapping):
         return self.execute_command('MSETNX', *items)
 
     def move(self, name, db):
-        "Moves the key ``name`` to a different Redis database ``db``"
+        """
+        Moves the key ``name`` to a different Redis database ``db``
+
+        For more information check https://redis.io/commands/move
+        """
         return self.execute_command('MOVE', name, db)
 
     def persist(self, name):
-        "Removes an expiration on ``name``"
+        """
+        Removes an expiration on ``name``
+
+        For more information check https://redis.io/commands/persist
+        """
         return self.execute_command('PERSIST', name)
 
     def pexpire(self, name, time):
@@ -1019,6 +1249,8 @@ def pexpire(self, name, time):
         Set an expire flag on key ``name`` for ``time`` milliseconds.
         ``time`` can be represented by an integer or a Python timedelta
         object.
+
+        For more information check https://redis.io/commands/pexpire
         """
         if isinstance(time, datetime.timedelta):
             time = int(time.total_seconds() * 1000)
@@ -1029,6 +1261,8 @@ def pexpireat(self, name, when):
         Set an expire flag on key ``name``. ``when`` can be represented
         as an integer representing unix time in milliseconds (unix time * 1000)
         or a Python datetime object.
+
+        For more information check https://redis.io/commands/pexpireat
         """
         if isinstance(when, datetime.datetime):
             ms = int(when.microsecond / 1000)
@@ -1040,13 +1274,19 @@ def psetex(self, name, time_ms, value):
         Set the value of key ``name`` to ``value`` that expires in ``time_ms``
         milliseconds. ``time_ms`` can be represented by an integer or a Python
         timedelta object
+
+        For more information check https://redis.io/commands/psetex
         """
         if isinstance(time_ms, datetime.timedelta):
             time_ms = int(time_ms.total_seconds() * 1000)
         return self.execute_command('PSETEX', name, time_ms, value)
 
     def pttl(self, name):
-        "Returns the number of milliseconds until the key ``name`` will expire"
+        """
+        Returns the number of milliseconds until the key ``name`` will expire
+
+        For more information check https://redis.io/commands/pttl
+        """
         return self.execute_command('PTTL', name)
 
     def hrandfield(self, key, count=None, withvalues=False):
@@ -1060,6 +1300,8 @@ def hrandfield(self, key, count=None, withvalues=False):
         specified count.
         withvalues: The optional WITHVALUES modifier changes the reply so it
         includes the respective values of the randomly selected hash fields.
+
+        For more information check https://redis.io/commands/hrandfield
         """
         params = []
         if count is not None:
@@ -1070,17 +1312,27 @@ def hrandfield(self, key, count=None, withvalues=False):
         return self.execute_command("HRANDFIELD", key, *params)
 
     def randomkey(self):
-        """Returns the name of a random key"""
+        """
+        Returns the name of a random key
+
+        For more information check https://redis.io/commands/randomkey
+        """
         return self.execute_command('RANDOMKEY')
 
     def rename(self, src, dst):
         """
         Rename key ``src`` to ``dst``
+
+        For more information check https://redis.io/commands/rename
         """
         return self.execute_command('RENAME', src, dst)
 
     def renamenx(self, src, dst):
-        """Rename key ``src`` to ``dst`` if ``dst`` doesn't already exist"""
+        """
+        Rename key ``src`` to ``dst`` if ``dst`` doesn't already exist
+
+        For more information check https://redis.io/commands/renamenx
+        """
         return self.execute_command('RENAMENX', src, dst)
 
     def restore(self, name, ttl, value, replace=False, absttl=False,
@@ -1101,6 +1353,8 @@ def restore(self, name, ttl, value, replace=False, absttl=False,
 
         ``frequency`` Used for eviction, this is the frequency counter of
         the object stored at the key, prior to execution.
+
+        For more information check https://redis.io/commands/restore
         """
         params = [name, ttl, value]
         if replace:
@@ -1151,6 +1405,8 @@ def set(self, name, value,
 
         ``pxat`` sets an expire flag on key ``name`` for ``ex`` milliseconds,
             specified in unix time.
+
+        For more information check https://redis.io/commands/set
         """
         pieces = [name, value]
         options = {}
@@ -1203,6 +1459,8 @@ def setbit(self, name, offset, value):
         """
         Flag the ``offset`` in ``name`` as ``value``. Returns a boolean
         indicating the previous value of ``offset``.
+
+        For more information check https://redis.io/commands/setbit
         """
         value = value and 1 or 0
         return self.execute_command('SETBIT', name, offset, value)
@@ -1212,13 +1470,19 @@ def setex(self, name, time, value):
         Set the value of key ``name`` to ``value`` that expires in ``time``
         seconds. ``time`` can be represented by an integer or a Python
         timedelta object.
+
+        For more information check https://redis.io/commands/setex
         """
         if isinstance(time, datetime.timedelta):
             time = int(time.total_seconds())
         return self.execute_command('SETEX', name, time, value)
 
     def setnx(self, name, value):
-        "Set the value of key ``name`` to ``value`` if key doesn't exist"
+        """
+        Set the value of key ``name`` to ``value`` if key doesn't exist
+
+        For more information check https://redis.io/commands/setnx
+        """
         return self.execute_command('SETNX', name, value)
 
     def setrange(self, name, offset, value):
@@ -1231,6 +1495,8 @@ def setrange(self, name, offset, value):
         of what's being injected.
 
         Returns the length of the new string.
+
+        For more information check https://redis.io/commands/setrange
         """
         return self.execute_command('SETRANGE', name, offset, value)
 
@@ -1252,6 +1518,8 @@ def stralgo(self, algo, value1, value2, specific_argument='strings',
         minimal length. Can be provided only when ``idx`` set to True.
         ``withmatchlen`` Returns the matches with the len of the match.
         Can be provided only when ``idx`` set to True.
+
+        For more information check https://redis.io/commands/stralgo
         """
         # check validity
         supported_algo = ['LCS']
@@ -1282,7 +1550,11 @@ def stralgo(self, algo, value1, value2, specific_argument='strings',
                                     withmatchlen=withmatchlen)
 
     def strlen(self, name):
-        "Return the number of bytes stored in the value of ``name``"
+        """
+        Return the number of bytes stored in the value of ``name``
+
+        For more information check https://redis.io/commands/strlen
+        """
         return self.execute_command('STRLEN', name)
 
     def substr(self, name, start, end=-1):
@@ -1296,32 +1568,50 @@ def touch(self, *args):
         """
         Alters the last access time of a key(s) ``*args``. A key is ignored
         if it does not exist.
+
+        For more information check https://redis.io/commands/touch
         """
         return self.execute_command('TOUCH', *args)
 
     def ttl(self, name):
-        "Returns the number of seconds until the key ``name`` will expire"
+        """
+        Returns the number of seconds until the key ``name`` will expire
+
+        For more information check https://redis.io/commands/ttl
+        """
         return self.execute_command('TTL', name)
 
     def type(self, name):
-        "Returns the type of key ``name``"
+        """
+        Returns the type of key ``name``
+
+        For more information check https://redis.io/commands/type
+        """
         return self.execute_command('TYPE', name)
 
     def watch(self, *names):
         """
         Watches the values at keys ``names``, or None if the key doesn't exist
+
+        For more information check https://redis.io/commands/type
         """
         warnings.warn(DeprecationWarning('Call WATCH from a Pipeline object'))
 
     def unwatch(self):
         """
         Unwatches the value at key ``name``, or None of the key doesn't exist
+
+        For more information check https://redis.io/commands/unwatch
         """
         warnings.warn(
             DeprecationWarning('Call UNWATCH from a Pipeline object'))
 
     def unlink(self, *names):
-        "Unlink one or more keys specified by ``names``"
+        """
+        Unlink one or more keys specified by ``names``
+
+        For more information check https://redis.io/commands/unlink
+        """
         return self.execute_command('UNLINK', *names)
 
     # LIST COMMANDS
@@ -1335,6 +1625,8 @@ def blpop(self, keys, timeout=0):
         of the lists.
 
         If timeout is 0, then block indefinitely.
+
+        For more information check https://redis.io/commands/blpop
         """
         if timeout is None:
             timeout = 0
@@ -1352,6 +1644,8 @@ def brpop(self, keys, timeout=0):
         of the lists.
 
         If timeout is 0, then block indefinitely.
+
+        For more information check https://redis.io/commands/brpop
         """
         if timeout is None:
             timeout = 0
@@ -1367,6 +1661,8 @@ def brpoplpush(self, src, dst, timeout=0):
         This command blocks until a value is in ``src`` or until ``timeout``
         seconds elapse, whichever is first. A ``timeout`` value of 0 blocks
         forever.
+
+        For more information check https://redis.io/commands/brpoplpush
         """
         if timeout is None:
             timeout = 0
@@ -1378,6 +1674,8 @@ def lindex(self, name, index):
 
         Negative indexes are supported and will return an item at the
         end of the list
+
+        For more information check https://redis.io/commands/lindex
         """
         return self.execute_command('LINDEX', name, index)
 
@@ -1388,11 +1686,17 @@ def linsert(self, name, where, refvalue, value):
 
         Returns the new length of the list on success or -1 if ``refvalue``
         is not in the list.
+
+        For more information check https://redis.io/commands/linsert
         """
         return self.execute_command('LINSERT', name, where, refvalue, value)
 
     def llen(self, name):
-        "Return the length of the list ``name``"
+        """
+        Return the length of the list ``name``
+
+        For more information check https://redis.io/commands/llen
+        """
         return self.execute_command('LLEN', name)
 
     def lpop(self, name, count=None):
@@ -1402,6 +1706,8 @@ def lpop(self, name, count=None):
         By default, the command pops a single element from the beginning of
         the list. When provided with the optional ``count`` argument, the reply
         will consist of up to count elements, depending on the list's length.
+
+        For more information check https://redis.io/commands/lpop
         """
         if count is not None:
             return self.execute_command('LPOP', name, count)
@@ -1409,11 +1715,19 @@ def lpop(self, name, count=None):
             return self.execute_command('LPOP', name)
 
     def lpush(self, name, *values):
-        "Push ``values`` onto the head of the list ``name``"
+        """
+        Push ``values`` onto the head of the list ``name``
+
+        For more information check https://redis.io/commands/lpush
+        """
         return self.execute_command('LPUSH', name, *values)
 
     def lpushx(self, name, *values):
-        "Push ``value`` onto the head of the list ``name`` if ``name`` exists"
+        """
+        Push ``value`` onto the head of the list ``name`` if ``name`` exists
+
+        For more information check https://redis.io/commands/lpushx
+        """
         return self.execute_command('LPUSHX', name, *values)
 
     def lrange(self, name, start, end):
@@ -1423,6 +1737,8 @@ def lrange(self, name, start, end):
 
         ``start`` and ``end`` can be negative numbers just like
         Python slicing notation
+
+        For more information check https://redis.io/commands/lrange
         """
         return self.execute_command('LRANGE', name, start, end)
 
@@ -1435,11 +1751,17 @@ def lrem(self, name, count, value):
             count > 0: Remove elements equal to value moving from head to tail.
             count < 0: Remove elements equal to value moving from tail to head.
             count = 0: Remove all elements equal to value.
+
+            For more information check https://redis.io/commands/lrem
         """
         return self.execute_command('LREM', name, count, value)
 
     def lset(self, name, index, value):
-        "Set ``position`` of list ``name`` to ``value``"
+        """
+        Set ``position`` of list ``name`` to ``value``
+
+        For more information check https://redis.io/commands/lset
+        """
         return self.execute_command('LSET', name, index, value)
 
     def ltrim(self, name, start, end):
@@ -1449,6 +1771,8 @@ def ltrim(self, name, start, end):
 
         ``start`` and ``end`` can be negative numbers just like
         Python slicing notation
+
+        For more information check https://redis.io/commands/ltrim
         """
         return self.execute_command('LTRIM', name, start, end)
 
@@ -1459,6 +1783,8 @@ def rpop(self, name, count=None):
         By default, the command pops a single element from the end of the list.
         When provided with the optional ``count`` argument, the reply will
         consist of up to count elements, depending on the list's length.
+
+        For more information check https://redis.io/commands/rpop
         """
         if count is not None:
             return self.execute_command('RPOP', name, count)
@@ -1469,15 +1795,25 @@ def rpoplpush(self, src, dst):
         """
         RPOP a value off of the ``src`` list and atomically LPUSH it
         on to the ``dst`` list.  Returns the value.
+
+        For more information check https://redis.io/commands/rpoplpush
         """
         return self.execute_command('RPOPLPUSH', src, dst)
 
     def rpush(self, name, *values):
-        "Push ``values`` onto the tail of the list ``name``"
+        """
+        Push ``values`` onto the tail of the list ``name``
+
+        For more information check https://redis.io/commands/rpush
+        """
         return self.execute_command('RPUSH', name, *values)
 
     def rpushx(self, name, value):
-        "Push ``value`` onto the tail of the list ``name`` if ``name`` exists"
+        """
+        Push ``value`` onto the tail of the list ``name`` if ``name`` exists
+
+        For more information check https://redis.io/commands/rpushx
+        """
         return self.execute_command('RPUSHX', name, value)
 
     def lpos(self, name, value, rank=None, count=None, maxlen=None):
@@ -1503,6 +1839,8 @@ def lpos(self, name, value, rank=None, count=None, maxlen=None):
          elements to scan. A ``maxlen`` of 1000 will only return the
          position(s) of items within the first 1000 entries in the list.
          A ``maxlen`` of 0 (the default) will scan the entire list.
+
+         For more information check https://redis.io/commands/lpos
         """
         pieces = [name, value]
         if rank is not None:
@@ -1541,6 +1879,7 @@ def sort(self, name, start=None, num=None, by=None, get=None,
             elements, sort will return a list of tuples, each containing the
             values fetched from the arguments to ``get``.
 
+        For more information check https://redis.io/commands/sort
         """
         if (start is not None and num is None) or \
                 (num is not None and start is None):
@@ -1591,6 +1930,8 @@ def scan(self, cursor=0, match=None, count=None, _type=None):
             Stock Redis instances allow for the following types:
             HASH, LIST, SET, STREAM, STRING, ZSET
             Additionally, Redis modules can expose other types as well.
+
+        For more information check https://redis.io/commands/scan
         """
         pieces = [cursor]
         if match is not None:
@@ -1630,6 +1971,8 @@ def sscan(self, name, cursor=0, match=None, count=None):
         ``match`` allows for filtering the keys by pattern
 
         ``count`` allows for hint the minimum number of returns
+
+        For more information check https://redis.io/commands/sscan
         """
         pieces = [name, cursor]
         if match is not None:
@@ -1661,6 +2004,8 @@ def hscan(self, name, cursor=0, match=None, count=None):
         ``match`` allows for filtering the keys by pattern
 
         ``count`` allows for hint the minimum number of returns
+
+        For more information check https://redis.io/commands/hscan
         """
         pieces = [name, cursor]
         if match is not None:
@@ -1695,6 +2040,8 @@ def zscan(self, name, cursor=0, match=None, count=None,
         ``count`` allows for hint the minimum number of returns
 
         ``score_cast_func`` a callable used to cast the score return value
+
+        For more information check https://redis.io/commands/zscan
         """
         pieces = [name, cursor]
         if match is not None:
@@ -1725,15 +2072,27 @@ def zscan_iter(self, name, match=None, count=None,
 
     # SET COMMANDS
     def sadd(self, name, *values):
-        """Add ``value(s)`` to set ``name``"""
+        """
+        Add ``value(s)`` to set ``name``
+
+        For more information check https://redis.io/commands/sadd
+        """
         return self.execute_command('SADD', name, *values)
 
     def scard(self, name):
-        """Return the number of elements in set ``name``"""
+        """
+        Return the number of elements in set ``name``
+
+        For more information check https://redis.io/commands/scard
+        """
         return self.execute_command('SCARD', name)
 
     def sdiff(self, keys, *args):
-        """Return the difference of sets specified by ``keys``"""
+        """
+        Return the difference of sets specified by ``keys``
+
+        For more information check https://redis.io/commands/sdiff
+        """
         args = list_or_args(keys, args)
         return self.execute_command('SDIFF', *args)
 
@@ -1741,12 +2100,18 @@ def sdiffstore(self, dest, keys, *args):
         """
         Store the difference of sets specified by ``keys`` into a new
         set named ``dest``.  Returns the number of keys in the new set.
+
+        For more information check https://redis.io/commands/sdiffstore
         """
         args = list_or_args(keys, args)
         return self.execute_command('SDIFFSTORE', dest, *args)
 
     def sinter(self, keys, *args):
-        """Return the intersection of sets specified by ``keys``"""
+        """
+        Return the intersection of sets specified by ``keys``
+
+        For more information check https://redis.io/commands/sinter
+        """
         args = list_or_args(keys, args)
         return self.execute_command('SINTER', *args)
 
@@ -1754,6 +2119,8 @@ def sinterstore(self, dest, keys, *args):
         """
         Store the intersection of sets specified by ``keys`` into a new
         set named ``dest``.  Returns the number of keys in the new set.
+
+        For more information check https://redis.io/commands/sinterstore
         """
         args = list_or_args(keys, args)
         return self.execute_command('SINTERSTORE', dest, *args)
@@ -1761,27 +2128,43 @@ def sinterstore(self, dest, keys, *args):
     def sismember(self, name, value):
         """
         Return a boolean indicating if ``value`` is a member of set ``name``
+
+        For more information check https://redis.io/commands/sismember
         """
         return self.execute_command('SISMEMBER', name, value)
 
     def smembers(self, name):
-        """Return all members of the set ``name``"""
+        """
+        Return all members of the set ``name``
+
+        For more information check https://redis.io/commands/smembers
+        """
         return self.execute_command('SMEMBERS', name)
 
     def smismember(self, name, values, *args):
         """
         Return whether each value in ``values`` is a member of the set ``name``
         as a list of ``bool`` in the order of ``values``
+
+        For more information check https://redis.io/commands/smismember
         """
         args = list_or_args(values, args)
         return self.execute_command('SMISMEMBER', name, *args)
 
     def smove(self, src, dst, value):
-        """Move ``value`` from set ``src`` to set ``dst`` atomically"""
+        """
+        Move ``value`` from set ``src`` to set ``dst`` atomically
+
+        For more information check https://redis.io/commands/smove
+        """
         return self.execute_command('SMOVE', src, dst, value)
 
     def spop(self, name, count=None):
-        "Remove and return a random member of set ``name``"
+        """
+        Remove and return a random member of set ``name``
+
+        For more information check https://redis.io/commands/spop
+        """
         args = (count is not None) and [count] or []
         return self.execute_command('SPOP', name, *args)
 
@@ -1792,16 +2175,26 @@ def srandmember(self, name, number=None):
         If ``number`` is supplied, returns a list of ``number`` random
         members of set ``name``. Note this is only available when running
         Redis 2.6+.
+
+        For more information check https://redis.io/commands/srandmember
         """
         args = (number is not None) and [number] or []
         return self.execute_command('SRANDMEMBER', name, *args)
 
     def srem(self, name, *values):
-        "Remove ``values`` from set ``name``"
+        """
+        Remove ``values`` from set ``name``
+
+        For more information check https://redis.io/commands/srem
+        """
         return self.execute_command('SREM', name, *values)
 
     def sunion(self, keys, *args):
-        "Return the union of sets specified by ``keys``"
+        """
+        Return the union of sets specified by ``keys``
+
+        For more information check https://redis.io/commands/sunion
+        """
         args = list_or_args(keys, args)
         return self.execute_command('SUNION', *args)
 
@@ -1809,6 +2202,8 @@ def sunionstore(self, dest, keys, *args):
         """
         Store the union of sets specified by ``keys`` into a new
         set named ``dest``.  Returns the number of keys in the new set.
+
+        For more information check https://redis.io/commands/sunionstore
         """
         args = list_or_args(keys, args)
         return self.execute_command('SUNIONSTORE', dest, *args)
@@ -1820,6 +2215,8 @@ def xack(self, name, groupname, *ids):
         name: name of the stream.
         groupname: name of the consumer group.
         *ids: message ids to acknowledge.
+
+        For more information check https://redis.io/commands/xack
         """
         return self.execute_command('XACK', name, groupname, *ids)
 
@@ -1837,6 +2234,8 @@ def xadd(self, name, fields, id='*', maxlen=None, approximate=True,
         minid: the minimum id in the stream to query.
         Can't be specified with maxlen.
         limit: specifies the maximum number of entries to retrieve
+
+        For more information check https://redis.io/commands/xadd
         """
         pieces = []
         if maxlen is not None and minid is not None:
@@ -1883,6 +2282,8 @@ def xautoclaim(self, name, groupname, consumername, min_idle_time,
         command attempts to claim. Set to 100 by default.
         justid: optional boolean, false by default. Return just an array of IDs
         of messages successfully claimed, without returning the actual message
+
+        For more information check https://redis.io/commands/xautoclaim
         """
         try:
             if int(min_idle_time) < 0:
@@ -1930,6 +2331,8 @@ def xclaim(self, name, groupname, consumername, min_idle_time, message_ids,
          PEL assigned to a different client.
         justid: optional boolean, false by default. Return just an array of IDs
          of messages successfully claimed, without returning the actual message
+
+         For more information check https://redis.io/commands/xclaim
         """
         if not isinstance(min_idle_time, int) or min_idle_time < 0:
             raise DataError("XCLAIM min_idle_time must be a non negative "
@@ -1971,6 +2374,8 @@ def xdel(self, name, *ids):
         Deletes one or more messages from a stream.
         name: name of the stream.
         *ids: message ids to delete.
+
+        For more information check https://redis.io/commands/xdel
         """
         return self.execute_command('XDEL', name, *ids)
 
@@ -1980,6 +2385,8 @@ def xgroup_create(self, name, groupname, id='$', mkstream=False):
         name: name of the stream.
         groupname: name of the consumer group.
         id: ID of the last item in the stream to consider already delivered.
+
+        For more information check https://redis.io/commands/xgroup-create
         """
         pieces = ['XGROUP CREATE', name, groupname, id]
         if mkstream:
@@ -1994,6 +2401,8 @@ def xgroup_delconsumer(self, name, groupname, consumername):
         name: name of the stream.
         groupname: name of the consumer group.
         consumername: name of consumer to delete
+
+        For more information check https://redis.io/commands/xgroup-delconsumer
         """
         return self.execute_command('XGROUP DELCONSUMER', name, groupname,
                                     consumername)
@@ -2003,6 +2412,8 @@ def xgroup_destroy(self, name, groupname):
         Destroy a consumer group.
         name: name of the stream.
         groupname: name of the consumer group.
+
+        For more information check https://redis.io/commands/xgroup-destroy
         """
         return self.execute_command('XGROUP DESTROY', name, groupname)
 
@@ -2014,6 +2425,8 @@ def xgroup_createconsumer(self, name, groupname, consumername):
         name: name of the stream.
         groupname: name of the consumer group.
         consumername: name of consumer to create.
+
+        See: https://redis.io/commands/xgroup-createconsumer
         """
         return self.execute_command('XGROUP CREATECONSUMER', name, groupname,
                                     consumername)
@@ -2024,6 +2437,8 @@ def xgroup_setid(self, name, groupname, id):
         name: name of the stream.
         groupname: name of the consumer group.
         id: ID of the last item in the stream to consider already delivered.
+
+        For more information check https://redis.io/commands/xgroup-setid
         """
         return self.execute_command('XGROUP SETID', name, groupname, id)
 
@@ -2032,6 +2447,8 @@ def xinfo_consumers(self, name, groupname):
         Returns general information about the consumers in the group.
         name: name of the stream.
         groupname: name of the consumer group.
+
+        For more information check https://redis.io/commands/xinfo-consumers
         """
         return self.execute_command('XINFO CONSUMERS', name, groupname)
 
@@ -2039,6 +2456,8 @@ def xinfo_groups(self, name):
         """
         Returns general information about the consumer groups of the stream.
         name: name of the stream.
+
+        For more information check https://redis.io/commands/xinfo-groups
         """
         return self.execute_command('XINFO GROUPS', name)
 
@@ -2047,6 +2466,8 @@ def xinfo_stream(self, name, full=False):
         Returns general information about the stream.
         name: name of the stream.
         full: optional boolean, false by default. Return full summary
+
+        For more information check https://redis.io/commands/xinfo-stream
         """
         pieces = [name]
         options = {}
@@ -2058,6 +2479,8 @@ def xinfo_stream(self, name, full=False):
     def xlen(self, name):
         """
         Returns the number of elements in a given stream.
+
+        For more information check https://redis.io/commands/xlen
         """
         return self.execute_command('XLEN', name)
 
@@ -2066,6 +2489,8 @@ def xpending(self, name, groupname):
         Returns information about pending messages of a group.
         name: name of the stream.
         groupname: name of the consumer group.
+
+        For more information check https://redis.io/commands/xpending
         """
         return self.execute_command('XPENDING', name, groupname)
 
@@ -2083,7 +2508,6 @@ def xpending_range(self, name, groupname, idle=None,
         max: maximum stream ID.
         count: number of messages to return
         consumername: name of a consumer to filter by (optional).
-
         """
         if {min, max, count} == {None}:
             if idle is not None or consumername is not None:
@@ -2126,6 +2550,8 @@ def xrange(self, name, min='-', max='+', count=None):
                 meaning the latest available.
         count: if set, only return this many items, beginning with the
                earliest available.
+
+        For more information check https://redis.io/commands/xrange
         """
         pieces = [min, max]
         if count is not None:
@@ -2144,6 +2570,8 @@ def xread(self, streams, count=None, block=None):
         count: if set, only return this many items, beginning with the
                earliest available.
         block: number of milliseconds to wait, if nothing already present.
+
+        For more information check https://redis.io/commands/xread
         """
         pieces = []
         if block is not None:
@@ -2176,6 +2604,8 @@ def xreadgroup(self, groupname, consumername, streams, count=None,
                earliest available.
         block: number of milliseconds to wait, if nothing already present.
         noack: do not add messages to the PEL
+
+        For more information check https://redis.io/commands/xreadgroup
         """
         pieces = [b'GROUP', groupname, consumername]
         if count is not None:
@@ -2208,6 +2638,8 @@ def xrevrange(self, name, max='+', min='-', count=None):
                 meaning the earliest available.
         count: if set, only return this many items, beginning with the
                latest available.
+
+        For more information check https://redis.io/commands/xrevrange
         """
         pieces = [max, min]
         if count is not None:
@@ -2229,6 +2661,8 @@ def xtrim(self, name, maxlen=None, approximate=True, minid=None,
         minid: the minimum id in the stream to query
         Can't be specified with maxlen.
         limit: specifies the maximum number of entries to retrieve
+
+        For more information check https://redis.io/commands/xtrim
         """
         pieces = []
         if maxlen is not None and minid is not None:
@@ -2284,6 +2718,7 @@ def zadd(self, name, mapping, nx=False, xx=False, ch=False, incr=False,
         set.
 
         ``NX``, ``LT``, and ``GT`` are mutually exclusive options.
+
         See: https://redis.io/commands/ZADD
         """
         if not mapping:
@@ -2317,13 +2752,19 @@ def zadd(self, name, mapping, nx=False, xx=False, ch=False, incr=False,
         return self.execute_command('ZADD', name, *pieces, **options)
 
     def zcard(self, name):
-        "Return the number of elements in the sorted set ``name``"
+        """
+        Return the number of elements in the sorted set ``name``
+
+        For more information check https://redis.io/commands/zcard
+        """
         return self.execute_command('ZCARD', name)
 
     def zcount(self, name, min, max):
         """
         Returns the number of elements in the sorted set at key ``name`` with
         a score between ``min`` and ``max``.
+
+        For more information check https://redis.io/commands/zcount
         """
         return self.execute_command('ZCOUNT', name, min, max)
 
@@ -2331,6 +2772,8 @@ def zdiff(self, keys, withscores=False):
         """
         Returns the difference between the first and all successive input
         sorted sets provided in ``keys``.
+
+        For more information check https://redis.io/commands/zdiff
         """
         pieces = [len(keys), *keys]
         if withscores:
@@ -2341,12 +2784,18 @@ def zdiffstore(self, dest, keys):
         """
         Computes the difference between the first and all successive input
         sorted sets provided in ``keys`` and stores the result in ``dest``.
+
+        For more information check https://redis.io/commands/zdiffstore
         """
         pieces = [len(keys), *keys]
         return self.execute_command("ZDIFFSTORE", dest, *pieces)
 
     def zincrby(self, name, amount, value):
-        "Increment the score of ``value`` in sorted set ``name`` by ``amount``"
+        """
+        Increment the score of ``value`` in sorted set ``name`` by ``amount``
+
+        For more information check https://redis.io/commands/zincrby
+        """
         return self.execute_command('ZINCRBY', name, amount, value)
 
     def zinter(self, keys, aggregate=None, withscores=False):
@@ -2358,6 +2807,8 @@ def zinter(self, keys, aggregate=None, withscores=False):
         exists. When this option is set to either MIN or MAX, the resulting
         set will contain the minimum or maximum score of an element across
         the inputs where it exists.
+
+        For more information check https://redis.io/commands/zinter
         """
         return self._zaggregate('ZINTER', None, keys, aggregate,
                                 withscores=withscores)
@@ -2371,6 +2822,8 @@ def zinterstore(self, dest, keys, aggregate=None):
         When this option is set to either MIN or MAX, the resulting set will
         contain the minimum or maximum score of an element across the inputs
         where it exists.
+
+        For more information check https://redis.io/commands/zinterstore
         """
         return self._zaggregate('ZINTERSTORE', dest, keys, aggregate)
 
@@ -2378,6 +2831,8 @@ def zlexcount(self, name, min, max):
         """
         Return the number of items in the sorted set ``name`` between the
         lexicographical range ``min`` and ``max``.
+
+        For more information check https://redis.io/commands/zlexcount
         """
         return self.execute_command('ZLEXCOUNT', name, min, max)
 
@@ -2385,6 +2840,8 @@ def zpopmax(self, name, count=None):
         """
         Remove and return up to ``count`` members with the highest scores
         from the sorted set ``name``.
+
+        For more information check https://redis.io/commands/zpopmax
         """
         args = (count is not None) and [count] or []
         options = {
@@ -2396,6 +2853,8 @@ def zpopmin(self, name, count=None):
         """
         Remove and return up to ``count`` members with the lowest scores
         from the sorted set ``name``.
+
+        For more information check https://redis.io/commands/zpopmin
         """
         args = (count is not None) and [count] or []
         options = {
@@ -2416,6 +2875,8 @@ def zrandmember(self, key, count=None, withscores=False):
         ``withscores`` The optional WITHSCORES modifier changes the reply so it
         includes the respective scores of the randomly selected elements from
         the sorted set.
+
+        For more information check https://redis.io/commands/zrandmember
         """
         params = []
         if count is not None:
@@ -2435,6 +2896,8 @@ def bzpopmax(self, keys, timeout=0):
         to one of the sorted sets.
 
         If timeout is 0, then block indefinitely.
+
+        For more information check https://redis.io/commands/bzpopmax
         """
         if timeout is None:
             timeout = 0
@@ -2452,6 +2915,8 @@ def bzpopmin(self, keys, timeout=0):
         to one of the sorted sets.
 
         If timeout is 0, then block indefinitely.
+
+        For more information check https://redis.io/commands/bzpopmin
         """
         if timeout is None:
             timeout = 0
@@ -2519,6 +2984,8 @@ def zrange(self, name, start, end, desc=False, withscores=False,
 
         ``offset`` and ``num`` are specified, then return a slice of the range.
         Can't be provided when using ``bylex``.
+
+        For more information check https://redis.io/commands/zrange
         """
         # Need to support ``desc`` also when using old redis version
         # because it was supported in 3.5.3 (of redis-py)
@@ -2542,6 +3009,8 @@ def zrevrange(self, name, start, end, withscores=False,
         The return type is a list of (value, score) pairs
 
         ``score_cast_func`` a callable used to cast the score return value
+
+        For more information check https://redis.io/commands/zrevrange
         """
         pieces = ['ZREVRANGE', name, start, end]
         if withscores:
@@ -2575,6 +3044,8 @@ def zrangestore(self, dest, name, start, end,
 
         ``offset`` and ``num`` are specified, then return a slice of the range.
         Can't be provided when using ``bylex``.
+
+        For more information check https://redis.io/commands/zrangestore
         """
         return self._zrange('ZRANGESTORE', dest, name, start, end, desc,
                             byscore, bylex, False, None, offset, num)
@@ -2586,6 +3057,8 @@ def zrangebylex(self, name, min, max, start=None, num=None):
 
         If ``start`` and ``num`` are specified, then return a slice of the
         range.
+
+        For more information check https://redis.io/commands/zrangebylex
         """
         if (start is not None and num is None) or \
                 (num is not None and start is None):
@@ -2602,6 +3075,8 @@ def zrevrangebylex(self, name, max, min, start=None, num=None):
 
         If ``start`` and ``num`` are specified, then return a slice of the
         range.
+
+        For more information check https://redis.io/commands/zrevrangebylex
         """
         if (start is not None and num is None) or \
                 (num is not None and start is None):
@@ -2624,6 +3099,8 @@ def zrangebyscore(self, name, min, max, start=None, num=None,
         The return type is a list of (value, score) pairs
 
         `score_cast_func`` a callable used to cast the score return value
+
+        For more information check https://redis.io/commands/zrangebyscore
         """
         if (start is not None and num is None) or \
                 (num is not None and start is None):
@@ -2652,6 +3129,8 @@ def zrevrangebyscore(self, name, max, min, start=None, num=None,
         The return type is a list of (value, score) pairs
 
         ``score_cast_func`` a callable used to cast the score return value
+
+        For more information check https://redis.io/commands/zrevrangebyscore
         """
         if (start is not None and num is None) or \
                 (num is not None and start is None):
@@ -2671,11 +3150,17 @@ def zrank(self, name, value):
         """
         Returns a 0-based value indicating the rank of ``value`` in sorted set
         ``name``
+
+        For more information check https://redis.io/commands/zrank
         """
         return self.execute_command('ZRANK', name, value)
 
     def zrem(self, name, *values):
-        "Remove member ``values`` from sorted set ``name``"
+        """
+        Remove member ``values`` from sorted set ``name``
+
+        For more information check https://redis.io/commands/zrem
+        """
         return self.execute_command('ZREM', name, *values)
 
     def zremrangebylex(self, name, min, max):
@@ -2684,6 +3169,8 @@ def zremrangebylex(self, name, min, max):
         lexicographical range specified by ``min`` and ``max``.
 
         Returns the number of elements removed.
+
+        For more information check https://redis.io/commands/zremrangebylex
         """
         return self.execute_command('ZREMRANGEBYLEX', name, min, max)
 
@@ -2693,6 +3180,8 @@ def zremrangebyrank(self, name, min, max):
         ``min`` and ``max``. Values are 0-based, ordered from smallest score
         to largest. Values can be negative indicating the highest scores.
         Returns the number of elements removed
+
+        For more information check https://redis.io/commands/zremrangebyrank
         """
         return self.execute_command('ZREMRANGEBYRANK', name, min, max)
 
@@ -2700,6 +3189,8 @@ def zremrangebyscore(self, name, min, max):
         """
         Remove all elements in the sorted set ``name`` with scores
         between ``min`` and ``max``. Returns the number of elements removed.
+
+        For more information check https://redis.io/commands/zremrangebyscore
         """
         return self.execute_command('ZREMRANGEBYSCORE', name, min, max)
 
@@ -2707,11 +3198,17 @@ def zrevrank(self, name, value):
         """
         Returns a 0-based value indicating the descending rank of
         ``value`` in sorted set ``name``
+
+        For more information check https://redis.io/commands/zrevrank
         """
         return self.execute_command('ZREVRANK', name, value)
 
     def zscore(self, name, value):
-        "Return the score of element ``value`` in sorted set ``name``"
+        """
+        Return the score of element ``value`` in sorted set ``name``
+
+        For more information check https://redis.io/commands/zscore
+        """
         return self.execute_command('ZSCORE', name, value)
 
     def zunion(self, keys, aggregate=None, withscores=False):
@@ -2720,6 +3217,8 @@ def zunion(self, keys, aggregate=None, withscores=False):
         ``keys`` can be provided as dictionary of keys and their weights.
         Scores will be aggregated based on the ``aggregate``, or SUM if
         none is provided.
+
+        For more information check https://redis.io/commands/zunion
         """
         return self._zaggregate('ZUNION', None, keys, aggregate,
                                 withscores=withscores)
@@ -2729,6 +3228,8 @@ def zunionstore(self, dest, keys, aggregate=None):
         Union multiple sorted sets specified by ``keys`` into
         a new sorted set, ``dest``. Scores in the destination will be
         aggregated based on the ``aggregate``, or SUM if none is provided.
+
+        For more information check https://redis.io/commands/zunionstore
         """
         return self._zaggregate('ZUNIONSTORE', dest, keys, aggregate)
 
@@ -2740,6 +3241,8 @@ def zmscore(self, key, members):
         Return type is a list of score.
         If the member does not exist, a None will be returned
         in corresponding position.
+
+        For more information check https://redis.io/commands/zmscore
         """
         if not members:
             raise DataError('ZMSCORE members must be a non-empty list')
@@ -2772,53 +3275,93 @@ def _zaggregate(self, command, dest, keys, aggregate=None,
 
     # HYPERLOGLOG COMMANDS
     def pfadd(self, name, *values):
-        "Adds the specified elements to the specified HyperLogLog."
+        """
+        Adds the specified elements to the specified HyperLogLog.
+
+        For more information check https://redis.io/commands/pfadd
+        """
         return self.execute_command('PFADD', name, *values)
 
     def pfcount(self, *sources):
         """
         Return the approximated cardinality of
         the set observed by the HyperLogLog at key(s).
+
+        For more information check https://redis.io/commands/pfcount
         """
         return self.execute_command('PFCOUNT', *sources)
 
     def pfmerge(self, dest, *sources):
-        "Merge N different HyperLogLogs into a single one."
+        """
+        Merge N different HyperLogLogs into a single one.
+
+        For more information check https://redis.io/commands/pfmerge
+        """
         return self.execute_command('PFMERGE', dest, *sources)
 
     # HASH COMMANDS
     def hdel(self, name, *keys):
-        "Delete ``keys`` from hash ``name``"
+        """
+        Delete ``keys`` from hash ``name``
+
+        For more information check https://redis.io/commands/hdel
+        """
         return self.execute_command('HDEL', name, *keys)
 
     def hexists(self, name, key):
-        "Returns a boolean indicating if ``key`` exists within hash ``name``"
+        """
+        Returns a boolean indicating if ``key`` exists within hash ``name``
+
+        For more information check https://redis.io/commands/hexists
+        """
         return self.execute_command('HEXISTS', name, key)
 
     def hget(self, name, key):
-        "Return the value of ``key`` within the hash ``name``"
+        """
+        Return the value of ``key`` within the hash ``name``
+
+        For more information check https://redis.io/commands/hget
+        """
         return self.execute_command('HGET', name, key)
 
     def hgetall(self, name):
-        "Return a Python dict of the hash's name/value pairs"
+        """
+        Return a Python dict of the hash's name/value pairs
+
+        For more information check https://redis.io/commands/hgetall
+        """
         return self.execute_command('HGETALL', name)
 
     def hincrby(self, name, key, amount=1):
-        "Increment the value of ``key`` in hash ``name`` by ``amount``"
+        """
+        Increment the value of ``key`` in hash ``name`` by ``amount``
+
+        For more information check https://redis.io/commands/hincrby
+        """
         return self.execute_command('HINCRBY', name, key, amount)
 
     def hincrbyfloat(self, name, key, amount=1.0):
         """
         Increment the value of ``key`` in hash ``name`` by floating ``amount``
+
+        For more information check https://redis.io/commands/hincrbyfloat
         """
         return self.execute_command('HINCRBYFLOAT', name, key, amount)
 
     def hkeys(self, name):
-        "Return the list of keys within hash ``name``"
+        """
+        Return the list of keys within hash ``name``
+
+        For more information check https://redis.io/commands/hkeys
+        """
         return self.execute_command('HKEYS', name)
 
     def hlen(self, name):
-        "Return the number of elements in hash ``name``"
+        """
+        Return the number of elements in hash ``name``
+
+        For more information check https://redis.io/commands/hlen
+        """
         return self.execute_command('HLEN', name)
 
     def hset(self, name, key=None, value=None, mapping=None):
@@ -2827,6 +3370,8 @@ def hset(self, name, key=None, value=None, mapping=None):
         ``mapping`` accepts a dict of key/value pairs that will be
         added to hash ``name``.
         Returns the number of fields that were added.
+
+        For more information check https://redis.io/commands/hset
         """
         if key is None and not mapping:
             raise DataError("'hset' with no key value pairs")
@@ -2843,6 +3388,8 @@ def hsetnx(self, name, key, value):
         """
         Set ``key`` to ``value`` within hash ``name`` if ``key`` does not
         exist.  Returns 1 if HSETNX created a field, otherwise 0.
+
+        For more information check https://redis.io/commands/hsetnx
         """
         return self.execute_command('HSETNX', name, key, value)
 
@@ -2850,6 +3397,8 @@ def hmset(self, name, mapping):
         """
         Set key to value within hash ``name`` for each corresponding
         key and value from the ``mapping`` dict.
+
+        For more information check https://redis.io/commands/hmset
         """
         warnings.warn(
             '%s.hmset() is deprecated. Use %s.hset() instead.'
@@ -2865,18 +3414,28 @@ def hmset(self, name, mapping):
         return self.execute_command('HMSET', name, *items)
 
     def hmget(self, name, keys, *args):
-        "Returns a list of values ordered identically to ``keys``"
+        """
+        Returns a list of values ordered identically to ``keys``
+
+        For more information check https://redis.io/commands/hmget
+        """
         args = list_or_args(keys, args)
         return self.execute_command('HMGET', name, *args)
 
     def hvals(self, name):
-        "Return the list of values within hash ``name``"
+        """
+        Return the list of values within hash ``name``
+
+        For more information check https://redis.io/commands/hvals
+        """
         return self.execute_command('HVALS', name)
 
     def hstrlen(self, name, key):
         """
         Return the number of bytes stored in the value of ``key``
         within hash ``name``
+
+        For more information check https://redis.io/commands/hstrlen
         """
         return self.execute_command('HSTRLEN', name, key)
 
@@ -2884,18 +3443,24 @@ def publish(self, channel, message):
         """
         Publish ``message`` on ``channel``.
         Returns the number of subscribers the message was delivered to.
+
+        For more information check https://redis.io/commands/publish
         """
         return self.execute_command('PUBLISH', channel, message)
 
     def pubsub_channels(self, pattern='*'):
         """
         Return a list of channels that have at least one subscriber
+
+        For more information check https://redis.io/commands/pubsub-channels
         """
         return self.execute_command('PUBSUB CHANNELS', pattern)
 
     def pubsub_numpat(self):
         """
         Returns the number of subscriptions to patterns
+
+        For more information check https://redis.io/commands/pubsub-numpat
         """
         return self.execute_command('PUBSUB NUMPAT')
 
@@ -2903,6 +3468,8 @@ def pubsub_numsub(self, *args):
         """
         Return a list of (channel, number of subscribers) tuples
         for each channel given in ``*args``
+
+        For more information check https://redis.io/commands/pubsub-numsub
         """
         return self.execute_command('PUBSUB NUMSUB', *args)
 
@@ -2915,7 +3482,8 @@ def replicaof(self, *args):
         Examples of valid arguments include:
             NO ONE (set no replication)
             host port (set to the host and port of a redis server)
-        see: https://redis.io/commands/replicaof
+
+        For more information check  https://redis.io/commands/replicaof
         """
         return self.execute_command('REPLICAOF', *args)
 
@@ -2927,6 +3495,8 @@ def eval(self, script, numkeys, *keys_and_args):
 
         In practice, use the object returned by ``register_script``. This
         function exists purely for Redis API completion.
+
+        For more information check  https://redis.io/commands/eval
         """
         return self.execute_command('EVAL', script, numkeys, *keys_and_args)
 
@@ -2939,6 +3509,8 @@ def evalsha(self, sha, numkeys, *keys_and_args):
 
         In practice, use the object returned by ``register_script``. This
         function exists purely for Redis API completion.
+
+        For more information check  https://redis.io/commands/evalsha
         """
         return self.execute_command('EVALSHA', sha, numkeys, *keys_and_args)
 
@@ -2947,6 +3519,8 @@ def script_exists(self, *args):
         Check if a script exists in the script cache by specifying the SHAs of
         each script as ``args``. Returns a list of boolean values indicating if
         if each already script exists in the cache.
+
+        For more information check  https://redis.io/commands/script-exists
         """
         return self.execute_command('SCRIPT EXISTS', *args)
 
@@ -2959,7 +3533,7 @@ def script_flush(self, sync_type=None):
         """Flush all scripts from the script cache.
         ``sync_type`` is by default SYNC (synchronous) but it can also be
                       ASYNC.
-        See: https://redis.io/commands/script-flush
+        For more information check  https://redis.io/commands/script-flush
         """
 
         # Redis pre 6 had no sync_type.
@@ -2974,11 +3548,19 @@ def script_flush(self, sync_type=None):
         return self.execute_command('SCRIPT FLUSH', *pieces)
 
     def script_kill(self):
-        "Kill the currently executing Lua script"
+        """
+        Kill the currently executing Lua script
+
+        For more information check https://redis.io/commands/script-kill
+        """
         return self.execute_command('SCRIPT KILL')
 
     def script_load(self, script):
-        "Load a Lua ``script`` into the script cache. Returns the SHA."
+        """
+        Load a Lua ``script`` into the script cache. Returns the SHA.
+
+        For more information check https://redis.io/commands/script-load
+        """
         return self.execute_command('SCRIPT LOAD', script)
 
     def register_script(self, script):
@@ -3009,6 +3591,8 @@ def geoadd(self, name, values, nx=False, xx=False, ch=False):
         ``ch`` modifies the return value to be the numbers of elements changed.
         Changed elements include new elements that were added and elements
         whose scores changed.
+
+        For more information check https://redis.io/commands/geoadd
         """
         if nx and xx:
             raise DataError("GEOADD allows either 'nx' or 'xx', not both")
@@ -3031,6 +3615,8 @@ def geodist(self, name, place1, place2, unit=None):
         ``name`` key.
         The units must be one of the following : m, km mi, ft. By default
         meters are used.
+
+        For more information check https://redis.io/commands/geodist
         """
         pieces = [name, place1, place2]
         if unit and unit not in ('m', 'km', 'mi', 'ft'):
@@ -3043,6 +3629,8 @@ def geohash(self, name, *values):
         """
         Return the geo hash string for each item of ``values`` members of
         the specified key identified by the ``name`` argument.
+
+        For more information check https://redis.io/commands/geohash
         """
         return self.execute_command('GEOHASH', name, *values)
 
@@ -3051,6 +3639,8 @@ def geopos(self, name, *values):
         Return the positions of each item of ``values`` as members of
         the specified key identified by the ``name`` argument. Each position
         is represented by the pairs lon and lat.
+
+        For more information check https://redis.io/commands/geopos
         """
         return self.execute_command('GEOPOS', name, *values)
 
@@ -3084,6 +3674,8 @@ def georadius(self, name, longitude, latitude, radius, unit=None,
         ``store_dist`` indicates to save the places names in a sorted set
         named with a specific key, instead of ``store`` the sorted set
         destination score is set with the distance.
+
+        For more information check https://redis.io/commands/georadius
         """
         return self._georadiusgeneric('GEORADIUS',
                                       name, longitude, latitude, radius,
@@ -3101,6 +3693,8 @@ def georadiusbymember(self, name, member, radius, unit=None,
         that instead of taking, as the center of the area to query, a longitude
         and latitude value, it takes the name of a member already existing
         inside the geospatial index represented by the sorted set.
+
+        For more information check https://redis.io/commands/georadiusbymember
         """
         return self._georadiusgeneric('GEORADIUSBYMEMBER',
                                       name, member, radius, unit=unit,
@@ -3188,6 +3782,8 @@ def geosearch(self, name, member=None, longitude=None, latitude=None,
         ``withcoord`` indicates to return the latitude and longitude of
         each place.
         ``withhash`` indicates to return the geohash string of each place.
+
+        For more information check https://redis.io/commands/geosearch
         """
 
         return self._geosearchgeneric('GEOSEARCH',
@@ -3210,6 +3806,8 @@ def geosearchstore(self, dest, name, member=None, longitude=None,
         if ``store_dist`` set to True, the command will stores the
         items in a sorted set populated with their distance from the
         center of the circle or box, as a floating-point number.
+
+        For more information check https://redis.io/commands/geosearchstore
         """
         return self._geosearchgeneric('GEOSEARCHSTORE',
                                       dest, name, member=member,
@@ -3290,6 +3888,8 @@ def module_load(self, path, *args):
         Loads the module from ``path``.
         Passes all ``*args`` to the module, during loading.
         Raises ``ModuleError`` if a module is not found at ``path``.
+
+        For more information check https://redis.io/commands/module-load
         """
         return self.execute_command('MODULE LOAD', path, *args)
 
@@ -3297,6 +3897,8 @@ def module_unload(self, name):
         """
         Unloads the module ``name``.
         Raises ``ModuleError`` if ``name`` is not in loaded modules.
+
+        For more information check https://redis.io/commands/module-unload
         """
         return self.execute_command('MODULE UNLOAD', name)
 
@@ -3304,6 +3906,8 @@ def module_list(self):
         """
         Returns a list of dictionaries containing the name and version of
         all loaded modules.
+
+        For more information check https://redis.io/commands/module-list
         """
         return self.execute_command('MODULE LIST')
 

From 021d4ac0edaecedb9b83235700cc4699cb119ef1 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 25 Nov 2021 14:14:56 +0200
Subject: [PATCH 0262/1164] 4.1.0rc1 (#1742)

---
 redis/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/__init__.py b/redis/__init__.py
index dc9b11a7b8..e7c6d05c5a 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -37,7 +37,7 @@ def int_or_str(value):
         return value
 
 
-__version__ = "4.0.2"
+__version__ = "4.1.0rc1"
 
 
 VERSION = tuple(map(int_or_str, __version__.split('.')))

From 9db1eec71b443b8e7e74ff503bae651dc6edf411 Mon Sep 17 00:00:00 2001
From: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Date: Thu, 25 Nov 2021 14:15:24 +0200
Subject: [PATCH 0263/1164] Adding RedisCluster client to support Redis Cluster
 Mode (#1660)

Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: Anas <anas.el.amraoui@live.com>
---
 .github/workflows/install_and_test.sh |    6 +-
 CONTRIBUTING.md                       |    8 +
 README.md                             |  268 ++-
 docker/base/Dockerfile.cluster        |    8 +
 docker/base/create_cluster.sh         |   26 +
 docker/cluster/redis.conf             |    3 +
 redis/__init__.py                     |    2 +
 redis/client.py                       |   39 +-
 redis/cluster.py                      | 2066 ++++++++++++++++++++
 redis/commands/__init__.py            |   10 +-
 redis/commands/cluster.py             |  926 +++++++++
 redis/commands/core.py                |  153 +-
 redis/commands/parser.py              |  118 ++
 redis/connection.py                   |   29 +-
 redis/crc.py                          |   24 +
 redis/exceptions.py                   |  102 +
 redis/utils.py                        |   36 +
 tasks.py                              |   19 +-
 tests/conftest.py                     |   95 +-
 tests/test_cluster.py                 | 2482 +++++++++++++++++++++++++
 tests/test_command_parser.py          |   62 +
 tests/test_commands.py                |  138 +-
 tests/test_connection.py              |    1 +
 tests/test_connection_pool.py         |    5 +
 tests/test_json.py                    |    1 +
 tests/test_lock.py                    |    2 +
 tests/test_monitor.py                 |    2 +
 tests/test_pipeline.py                |   14 +
 tests/test_pubsub.py                  |   13 +-
 tests/test_scripting.py               |    1 +
 tests/test_sentinel.py                |   15 +
 tox.ini                               |   26 +-
 32 files changed, 6628 insertions(+), 72 deletions(-)
 create mode 100644 docker/base/Dockerfile.cluster
 create mode 100644 docker/base/create_cluster.sh
 create mode 100644 docker/cluster/redis.conf
 create mode 100644 redis/cluster.py
 create mode 100644 redis/commands/cluster.py
 create mode 100644 redis/commands/parser.py
 create mode 100644 redis/crc.py
 create mode 100644 tests/test_cluster.py
 create mode 100644 tests/test_command_parser.py

diff --git a/.github/workflows/install_and_test.sh b/.github/workflows/install_and_test.sh
index 330102eb41..7a8cd672fd 100755
--- a/.github/workflows/install_and_test.sh
+++ b/.github/workflows/install_and_test.sh
@@ -38,4 +38,8 @@ cd ${TESTDIR}
 
 # install, run tests
 pip install ${PKG}
-pytest
+# Redis tests
+pytest -m 'not onlycluster'
+# RedisCluster tests
+CLUSTER_URL="redis://localhost:16379/0"
+pytest -m 'not onlynoncluster and not redismod' --redis-url=${CLUSTER_URL}
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index af067e7fdf..fe37ff9abe 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -68,6 +68,14 @@ configuration](https://redis.io/topics/sentinel).
 
 ## Testing
 
+Call `invoke tests` to run all tests, or `invoke all-tests` to run linters 
+tests as well. With the 'tests' and 'all-tests' targets, all Redis and 
+RedisCluster tests will be run. 
+
+It is possible to run only Redis client tests (with cluster mode disabled) by 
+using `invoke redis-tests`; similarly, RedisCluster tests can be run by using 
+`invoke cluster-tests`.
+
 Each run of tox starts and stops the various dockers required. Sometimes
 things get stuck, an `invoke clean` can help.
 
diff --git a/README.md b/README.md
index f03053e691..6e7d964b2b 100644
--- a/README.md
+++ b/README.md
@@ -948,8 +948,272 @@ C 3
 
 ### Cluster Mode
 
-redis-py does not currently support [Cluster
-Mode](https://redis.io/topics/cluster-tutorial).
+redis-py is now supports cluster mode and provides a client for
+[Redis Cluster](<https://redis.io/topics/cluster-tutorial>).
+
+The cluster client is based on Grokzen's 
+[redis-py-cluster](https://github.com/Grokzen/redis-py-cluster), has added bug 
+fixes, and now supersedes that library. Support for these changes is thanks to 
+his contributions.
+
+
+**Create RedisCluster:**
+
+Connecting redis-py to a Redis Cluster instance(s) requires at a minimum a 
+single node for cluster discovery. There are multiple ways in which a cluster 
+instance can be created:
+
+- Using 'host' and 'port' arguments:
+
+``` pycon
+    >>> from redis.cluster import RedisCluster as Redis
+    >>> rc = Redis(host='localhost', port=6379)
+    >>> print(rc.get_nodes())
+    [[host=127.0.0.1,port=6379,name=127.0.0.1:6379,server_type=primary,redis_connection=Redis<ConnectionPool<Connection<host=127.0.0.1,port=6379,db=0>>>], [host=127.0.0.1,port=6378,name=127.0.0.1:6378,server_type=primary,redis_connection=Redis<ConnectionPool<Connection<host=127.0.0.1,port=6378,db=0>>>], [host=127.0.0.1,port=6377,name=127.0.0.1:6377,server_type=replica,redis_connection=Redis<ConnectionPool<Connection<host=127.0.0.1,port=6377,db=0>>>]]
+```
+- Using the Redis URL specification:
+
+``` pycon
+    >>> from redis.cluster import RedisCluster as Redis
+    >>> rc = Redis.from_url("redis://localhost:6379/0")
+```
+
+- Directly, via the ClusterNode class:
+
+``` pycon
+    >>> from redis.cluster import RedisCluster as Redis
+    >>> from redis.cluster import ClusterNode
+    >>> nodes = [ClusterNode('localhost', 6379), ClusterNode('localhost', 6378)]
+    >>> rc = Redis(startup_nodes=nodes)
+```
+
+When a RedisCluster instance is being created it first attempts to establish a
+connection to one of the provided startup nodes. If none of the startup nodes
+are reachable, a 'RedisClusterException' will be thrown.
+After a connection to the one of the cluster's nodes is established, the
+RedisCluster instance will be initialized with 3 caches:
+a slots cache which maps each of the 16384 slots to the node/s handling them,
+a nodes cache that contains ClusterNode objects (name, host, port, redis connection)
+for all of the cluster's nodes, and a commands cache contains all the server
+supported commands that were retrieved using the Redis 'COMMAND' output.
+
+RedisCluster instance can be directly used to execute Redis commands. When a
+command is being executed through the cluster instance, the target node(s) will
+be internally determined. When using a key-based command, the target node will
+be the node that holds the key's slot.
+Cluster management commands and other commands that are not key-based have a 
+parameter called 'target_nodes' where you can specify which nodes to execute 
+the command on. In the absence of target_nodes, the command will be executed 
+on the default cluster node. As part of cluster instance initialization, the 
+cluster's default node is randomly selected from the cluster's primaries, and 
+will be updated upon reinitialization. Using r.get_default_node(), you can 
+get the cluster's default node, or you can change it using the 
+'set_default_node' method.
+
+The 'target_nodes' parameter is explained in the following section, 
+'Specifying Target Nodes'.
+
+``` pycon
+    >>> # target-nodes: the node that holds 'foo1's key slot
+    >>> rc.set('foo1', 'bar1')
+    >>> # target-nodes: the node that holds 'foo2's key slot
+    >>> rc.set('foo2', 'bar2')
+    >>> # target-nodes: the node that holds 'foo1's key slot
+    >>> print(rc.get('foo1'))
+    b'bar'
+    >>> # target-node: default-node
+    >>> print(rc.keys())
+    [b'foo1']
+    >>> # target-node: default-node
+    >>> rc.ping()
+```
+
+**Specifying Target Nodes:**
+
+As mentioned above, all non key-based RedisCluster commands accept the kwarg 
+parameter 'target_nodes' that specifies the node/nodes that the command should 
+be executed on.
+The best practice is to specify target nodes using RedisCluster class's node
+flags: PRIMARIES, REPLICAS, ALL_NODES, RANDOM. When a nodes flag is passed
+along with a command, it will be internally resolved to the relevant node/s.
+If the nodes topology of the cluster changes during the execution of a command,
+the client will be able to resolve the nodes flag again with the new topology
+and attempt to retry executing the command.
+
+``` pycon
+    >>> from redis.cluster import RedisCluster as Redis
+    >>> # run cluster-meet command on all of the cluster's nodes
+    >>> rc.cluster_meet('127.0.0.1', 6379, target_nodes=Redis.ALL_NODES)
+    >>> # ping all replicas
+    >>> rc.ping(target_nodes=Redis.REPLICAS)
+    >>> # ping a specific node
+    >>> rc.ping(target_nodes=Redis.RANDOM)
+    >>> # get the keys from all cluster nodes
+    >>> rc.keys(target_nodes=Redis.ALL_NODES)
+    [b'foo1', b'foo2']
+    >>> # execute bgsave in all primaries
+    >>> rc.bgsave(Redis.PRIMARIES)
+```
+
+You could also pass ClusterNodes directly if you want to execute a command on a
+specific node / node group that isn't addressed by the nodes flag. However, if
+the command execution fails due to cluster topology changes, a retry attempt
+will not be made, since the passed target node/s may no longer be valid, and
+the relevant cluster or connection error will be returned.
+
+``` pycon
+    >>> node = rc.get_node('localhost', 6379)
+    >>> # Get the keys only for that specific node
+    >>> rc.keys(target_nodes=node)
+    >>> # get Redis info from a subset of primaries
+    >>> subset_primaries = [node for node in rc.get_primaries() if node.port > 6378]
+    >>> rc.info(target_nodes=subset_primaries)
+```
+
+In addition, the RedisCluster instance can query the Redis instance of a 
+specific node and execute commands on that node directly. The Redis client,
+however, does not handle cluster failures and retries.
+
+``` pycon
+    >>> cluster_node = rc.get_node(host='localhost', port=6379)
+    >>> print(cluster_node)
+    [host=127.0.0.1,port=6379,name=127.0.0.1:6379,server_type=primary,redis_connection=Redis<ConnectionPool<Connection<host=127.0.0.1,port=6379,db=0>>>]
+    >>> r = cluster_node.redis_connection
+    >>> r.client_list()
+    [{'id': '276', 'addr': '127.0.0.1:64108', 'fd': '16', 'name': '', 'age': '0', 'idle': '0', 'flags': 'N', 'db': '0', 'sub': '0', 'psub': '0', 'multi': '-1', 'qbuf': '26', 'qbuf-free': '32742', 'argv-mem': '10', 'obl': '0', 'oll': '0', 'omem': '0', 'tot-mem': '54298', 'events': 'r', 'cmd': 'client', 'user': 'default'}]
+    >>> # Get the keys only for that specific node
+    >>> r.keys()
+    [b'foo1']
+```
+
+**Multi-key commands:**
+
+Redis supports multi-key commands in Cluster Mode, such as Set type unions or
+intersections, mset and mget, as long as the keys all hash to the same slot.
+By using RedisCluster client, you can use the known functions (e.g. mget, mset)
+to perform an atomic multi-key operation. However, you must ensure all keys are
+mapped to the same slot, otherwise a RedisClusterException will be thrown.
+Redis Cluster implements a concept called hash tags that can be used in order
+to force certain keys to be stored in the same hash slot, see 
+[Keys hash tag](https://redis.io/topics/cluster-spec#keys-hash-tags).
+You can also use nonatomic for some of the multikey operations, and pass keys
+that aren't mapped to the same slot. The client will then map the keys to the
+relevant slots, sending the commands to the slots' node owners. Non-atomic
+operations batch the keys according to their hash value, and then each batch is
+sent separately to the slot's owner.
+
+``` pycon
+    #  Atomic operations can be used when all keys are mapped to the same slot
+    >>> rc.mset({'{foo}1': 'bar1', '{foo}2': 'bar2'})
+    >>> rc.mget('{foo}1', '{foo}2')
+    [b'bar1', b'bar2']
+    # Non-atomic multi-key operations splits the keys into different slots
+    >>> rc.mset_nonatomic({'foo': 'value1', 'bar': 'value2', 'zzz': 'value3')
+    >>> rc.mget_nonatomic('foo', 'bar', 'zzz')
+    [b'value1', b'value2', b'value3']
+```
+
+**Cluster PubSub:**
+
+When a ClusterPubSub instance is created without specifying a node, a single
+node will be transparently chosen for the pubsub connection on the
+first command execution. The node will be determined by:
+ 1. Hashing the channel name in the request to find its keyslot
+ 2. Selecting a node that handles the keyslot: If read_from_replicas is
+    set to true, a replica can be selected.
+    
+*Known limitations with pubsub:*
+
+Pattern subscribe and publish do not currently work properly due to key slots. 
+If we hash a pattern like fo* we will receive a keyslot for that string but 
+there are endless possibilities for channel names based on this pattern - 
+unknowable in advance. This feature is not disabled but the commands are not 
+currently recommended for use.
+See [redis-py-cluster documentation](https://redis-py-cluster.readthedocs.io/en/stable/pubsub.html) 
+ for more.
+
+``` pycon
+    >>> p1 = rc.pubsub()
+    # p1 connection will be set to the node that holds 'foo' keyslot
+    >>> p1.subscribe('foo')
+    # p2 connection will be set to node 'localhost:6379'
+    >>> p2 = rc.pubsub(rc.get_node('localhost', 6379))
+```
+
+**Read Only Mode**
+
+By default, Redis Cluster always returns MOVE redirection response on accessing 
+a replica node. You can overcome this limitation and scale read commands by 
+triggering READONLY mode.
+
+To enable READONLY mode pass read_from_replicas=True to RedisCluster 
+constructor. When set to true, read commands will be assigned between the
+primary and its replications in a Round-Robin manner. 
+
+READONLY mode can be set at runtime by calling the readonly() method with 
+target_nodes='replicas', and read-write access can be restored by calling the 
+readwrite() method.
+
+``` pycon
+    >>> from cluster import RedisCluster as Redis
+    # Use 'debug' log level to print the node that the command is executed on
+    >>> rc_readonly = Redis(startup_nodes=startup_nodes, 
+                    read_from_replicas=True, debug=True)
+    >>> rc_readonly.set('{foo}1', 'bar1')
+    >>> for i in range(0, 4):
+            # Assigns read command to the slot's hosts in a Round-Robin manner
+    >>>     rc_readonly.get('{foo}1')
+    # set command would be directed only to the slot's primary node
+    >>> rc_readonly.set('{foo}2', 'bar2')
+    # reset READONLY flag
+    >>> rc_readonly.readwrite(target_nodes='replicas')
+    # now the get command would be directed only to the slot's primary node
+    >>> rc_readonly.get('{foo}1')
+```
+
+**Cluster Pipeline**
+
+ClusterPipeline is a subclass of RedisCluster that provides support for Redis 
+pipelines in cluster mode. 
+When calling the execute() command, all the commands are grouped by the node 
+on which they will be executed, and are then executed by the respective nodes 
+in parallel. The pipeline instance will wait for all the nodes to respond 
+before returning the result to the caller. Command responses are returned as a 
+list sorted in the same order in which they were sent.
+Pipelines can be used to dramatically increase the throughput of Redis Cluster 
+by significantly reducing the the number of network round trips between the 
+client and the server.
+
+``` pycon
+    >>> with rc.pipeline() as pipe:
+    >>>     pipe.set('foo', 'value1')
+    >>>     pipe.set('bar', 'value2')
+    >>>     pipe.get('foo')
+    >>>     pipe.get('bar')
+    >>>     print(pipe.execute())
+    [True, True, b'value1', b'value2']
+    >>>     pipe.set('foo1', 'bar1').get('foo1').execute()
+    [True, b'bar1']
+```
+Please note:
+- RedisCluster pipelines currently only support key-based commands.
+- The pipeline gets its 'read_from_replicas' value from the cluster's parameter.
+Thus, if read from replications is enabled in the cluster instance, the pipeline 
+will also direct read commands to replicas.
+- The 'transcation' option is NOT supported in cluster-mode. In non-cluster mode, 
+the 'transaction' option is available when executing pipelines. This wraps the 
+pipeline commands with MULTI/EXEC commands, and effectively turns the pipeline 
+commands into a single transaction block. This means that all commands are 
+executed sequentially without any interruptions from other clients. However, 
+in cluster-mode this is not possible, because commands are partitioned 
+according to their respective destination nodes. This means that we can not 
+turn the pipeline commands into one transaction block, because in most cases 
+they are split up into several smaller pipelines.
+
+
+See [Redis Cluster tutorial](https://redis.io/topics/cluster-tutorial) and
+[Redis Cluster specifications](https://redis.io/topics/cluster-spec)
+to learn more about Redis Cluster.
 
 ### Author
 
diff --git a/docker/base/Dockerfile.cluster b/docker/base/Dockerfile.cluster
new file mode 100644
index 0000000000..70e8013631
--- /dev/null
+++ b/docker/base/Dockerfile.cluster
@@ -0,0 +1,8 @@
+FROM redis:6.2.6-buster
+
+COPY create_cluster.sh /create_cluster.sh
+RUN chmod +x /create_cluster.sh
+
+EXPOSE 16379 16380 16381 16382 16383 16384
+
+CMD [ "/create_cluster.sh"]
\ No newline at end of file
diff --git a/docker/base/create_cluster.sh b/docker/base/create_cluster.sh
new file mode 100644
index 0000000000..82a79c80da
--- /dev/null
+++ b/docker/base/create_cluster.sh
@@ -0,0 +1,26 @@
+#! /bin/bash
+mkdir -p /nodes
+touch /nodes/nodemap
+for PORT in $(seq 16379 16384); do
+  mkdir -p /nodes/$PORT
+  if [[ -e /redis.conf ]]; then
+    cp /redis.conf /nodes/$PORT/redis.conf
+  else
+    touch /nodes/$PORT/redis.conf
+  fi
+  cat << EOF >> /nodes/$PORT/redis.conf
+port ${PORT}
+cluster-enabled yes
+daemonize yes
+logfile /redis.log
+dir /nodes/$PORT
+EOF
+  redis-server /nodes/$PORT/redis.conf
+  if [ $? -ne 0 ]; then
+    echo "Redis failed to start, exiting."
+    exit 3
+  fi
+  echo 127.0.0.1:$PORT >> /nodes/nodemap
+done
+echo yes | redis-cli --cluster create $(seq -f 127.0.0.1:%g 16379 16384) --cluster-replicas 1
+tail -f /redis.log
diff --git a/docker/cluster/redis.conf b/docker/cluster/redis.conf
new file mode 100644
index 0000000000..dff658c79b
--- /dev/null
+++ b/docker/cluster/redis.conf
@@ -0,0 +1,3 @@
+# Redis Cluster config file will be shared across all nodes.
+# Do not change the following configurations that are already set:
+# port, cluster-enabled, daemonize, logfile, dir
diff --git a/redis/__init__.py b/redis/__init__.py
index e7c6d05c5a..bc7f3c9d9c 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -1,4 +1,5 @@
 from redis.client import Redis, StrictRedis
+from redis.cluster import RedisCluster
 from redis.connection import (
     BlockingConnectionPool,
     ConnectionPool,
@@ -57,6 +58,7 @@ def int_or_str(value):
     'PubSubError',
     'ReadOnlyError',
     'Redis',
+    'RedisCluster',
     'RedisError',
     'ResponseError',
     'Sentinel',
diff --git a/redis/client.py b/redis/client.py
index dc6693d111..143ed88731 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -461,6 +461,7 @@ def _parse_node_line(line):
     line_items = line.split(' ')
     node_id, addr, flags, master_id, ping, pong, epoch, \
         connected = line.split(' ')[:8]
+    addr = addr.split('@')[0]
     slots = [sl.split('-') for sl in line_items[8:]]
     node_dict = {
         'node_id': node_id,
@@ -476,8 +477,13 @@ def _parse_node_line(line):
 
 
 def parse_cluster_nodes(response, **options):
-    raw_lines = str_if_bytes(response).splitlines()
-    return dict(_parse_node_line(line) for line in raw_lines)
+    """
+    @see: https://redis.io/commands/cluster-nodes  # string
+    @see: https://redis.io/commands/cluster-replicas # list of string
+    """
+    if isinstance(response, str):
+        response = response.splitlines()
+    return dict(_parse_node_line(str_if_bytes(node)) for node in response)
 
 
 def parse_geosearch_generic(response, **options):
@@ -516,6 +522,21 @@ def parse_geosearch_generic(response, **options):
     ]
 
 
+def parse_command(response, **options):
+    commands = {}
+    for command in response:
+        cmd_dict = {}
+        cmd_name = str_if_bytes(command[0])
+        cmd_dict['name'] = cmd_name
+        cmd_dict['arity'] = int(command[1])
+        cmd_dict['flags'] = [str_if_bytes(flag) for flag in command[2]]
+        cmd_dict['first_key_pos'] = command[3]
+        cmd_dict['last_key_pos'] = command[4]
+        cmd_dict['step_count'] = command[5]
+        commands[cmd_name] = cmd_dict
+    return commands
+
+
 def parse_pubsub_numsub(response, **options):
     return list(zip(response[0::2], response[1::2]))
 
@@ -704,7 +725,10 @@ class Redis(RedisModuleCommands, CoreCommands, SentinelCommands, object):
         'CLUSTER SET-CONFIG-EPOCH': bool_ok,
         'CLUSTER SETSLOT': bool_ok,
         'CLUSTER SLAVES': parse_cluster_nodes,
+        'CLUSTER REPLICAS': parse_cluster_nodes,
+        'COMMAND': parse_command,
         'COMMAND COUNT': int,
+        'COMMAND GETKEYS': lambda r: list(map(str_if_bytes, r)),
         'CONFIG GET': parse_config_get,
         'CONFIG RESETSTAT': bool_ok,
         'CONFIG SET': bool_ok,
@@ -827,7 +851,7 @@ def __init__(self, host='localhost', port=6379,
                  ssl_check_hostname=False,
                  max_connections=None, single_connection_client=False,
                  health_check_interval=0, client_name=None, username=None,
-                 retry=None):
+                 retry=None, redis_connect_func=None):
         """
         Initialize a new Redis client.
         To specify a retry policy, first set `retry_on_timeout` to `True`
@@ -855,7 +879,8 @@ def __init__(self, host='localhost', port=6379,
                 'retry': copy.deepcopy(retry),
                 'max_connections': max_connections,
                 'health_check_interval': health_check_interval,
-                'client_name': client_name
+                'client_name': client_name,
+                'redis_connect_func': redis_connect_func
             }
             # based on input, setup appropriate connection args
             if unix_socket_path is not None:
@@ -1173,14 +1198,16 @@ class PubSub:
     HEALTH_CHECK_MESSAGE = 'redis-py-health-check'
 
     def __init__(self, connection_pool, shard_hint=None,
-                 ignore_subscribe_messages=False):
+                 ignore_subscribe_messages=False, encoder=None):
         self.connection_pool = connection_pool
         self.shard_hint = shard_hint
         self.ignore_subscribe_messages = ignore_subscribe_messages
         self.connection = None
         # we need to know the encoding options for this connection in order
         # to lookup channel and pattern names for callback handlers.
-        self.encoder = self.connection_pool.get_encoder()
+        self.encoder = encoder
+        if self.encoder is None:
+            self.encoder = self.connection_pool.get_encoder()
         if self.encoder.decode_responses:
             self.health_check_response = ['pong', self.HEALTH_CHECK_MESSAGE]
         else:
diff --git a/redis/cluster.py b/redis/cluster.py
new file mode 100644
index 0000000000..91a4d558a2
--- /dev/null
+++ b/redis/cluster.py
@@ -0,0 +1,2066 @@
+import copy
+import logging
+import random
+import socket
+import time
+import threading
+import sys
+
+from collections import OrderedDict
+from redis.client import CaseInsensitiveDict, Redis, PubSub
+from redis.commands import (
+    ClusterCommands,
+    CommandsParser
+)
+from redis.connection import DefaultParser, ConnectionPool, Encoder, parse_url
+from redis.crc import key_slot, REDIS_CLUSTER_HASH_SLOTS
+from redis.exceptions import (
+    AskError,
+    BusyLoadingError,
+    ClusterCrossSlotError,
+    ClusterDownError,
+    ClusterError,
+    DataError,
+    MasterDownError,
+    MovedError,
+    RedisClusterException,
+    RedisError,
+    ResponseError,
+    SlotNotCoveredError,
+    TimeoutError,
+    TryAgainError,
+)
+from redis.utils import (
+    dict_merge,
+    list_keys_to_dict,
+    merge_result,
+    str_if_bytes,
+    safe_str
+)
+
+log = logging.getLogger(__name__)
+
+
+def get_node_name(host, port):
+    return '{0}:{1}'.format(host, port)
+
+
+def get_connection(redis_node, *args, **options):
+    return redis_node.connection or redis_node.connection_pool.get_connection(
+        args[0], **options
+    )
+
+
+def parse_scan_result(command, res, **options):
+    keys_list = []
+    for primary_res in res.values():
+        keys_list += primary_res[1]
+    return 0, keys_list
+
+
+def parse_pubsub_numsub(command, res, **options):
+    numsub_d = OrderedDict()
+    for numsub_tups in res.values():
+        for channel, numsubbed in numsub_tups:
+            try:
+                numsub_d[channel] += numsubbed
+            except KeyError:
+                numsub_d[channel] = numsubbed
+
+    ret_numsub = [
+        (channel, numsub)
+        for channel, numsub in numsub_d.items()
+    ]
+    return ret_numsub
+
+
+def parse_cluster_slots(resp, **options):
+    current_host = options.get('current_host', '')
+
+    def fix_server(*args):
+        return str_if_bytes(args[0]) or current_host, args[1]
+
+    slots = {}
+    for slot in resp:
+        start, end, primary = slot[:3]
+        replicas = slot[3:]
+        slots[start, end] = {
+            'primary': fix_server(*primary),
+            'replicas': [fix_server(*replica) for replica in replicas],
+        }
+
+    return slots
+
+
+PRIMARY = "primary"
+REPLICA = "replica"
+SLOT_ID = "slot-id"
+
+REDIS_ALLOWED_KEYS = (
+    "charset",
+    "connection_class",
+    "connection_pool",
+    "db",
+    "decode_responses",
+    "encoding",
+    "encoding_errors",
+    "errors",
+    "host",
+    "max_connections",
+    "nodes_flag",
+    "redis_connect_func",
+    "password",
+    "port",
+    "retry",
+    "retry_on_timeout",
+    "socket_connect_timeout",
+    "socket_keepalive",
+    "socket_keepalive_options",
+    "socket_timeout",
+    "ssl",
+    "ssl_ca_certs",
+    "ssl_certfile",
+    "ssl_cert_reqs",
+    "ssl_keyfile",
+    "unix_socket_path",
+    "username",
+)
+KWARGS_DISABLED_KEYS = (
+    "host",
+    "port",
+)
+
+# Not complete, but covers the major ones
+# https://redis.io/commands
+READ_COMMANDS = frozenset([
+    "BITCOUNT",
+    "BITPOS",
+    "EXISTS",
+    "GEODIST",
+    "GEOHASH",
+    "GEOPOS",
+    "GEORADIUS",
+    "GEORADIUSBYMEMBER",
+    "GET",
+    "GETBIT",
+    "GETRANGE",
+    "HEXISTS",
+    "HGET",
+    "HGETALL",
+    "HKEYS",
+    "HLEN",
+    "HMGET",
+    "HSTRLEN",
+    "HVALS",
+    "KEYS",
+    "LINDEX",
+    "LLEN",
+    "LRANGE",
+    "MGET",
+    "PTTL",
+    "RANDOMKEY",
+    "SCARD",
+    "SDIFF",
+    "SINTER",
+    "SISMEMBER",
+    "SMEMBERS",
+    "SRANDMEMBER",
+    "STRLEN",
+    "SUNION",
+    "TTL",
+    "ZCARD",
+    "ZCOUNT",
+    "ZRANGE",
+    "ZSCORE",
+])
+
+
+def cleanup_kwargs(**kwargs):
+    """
+    Remove unsupported or disabled keys from kwargs
+    """
+    connection_kwargs = {
+        k: v
+        for k, v in kwargs.items()
+        if k in REDIS_ALLOWED_KEYS and k not in KWARGS_DISABLED_KEYS
+    }
+
+    return connection_kwargs
+
+
+class ClusterParser(DefaultParser):
+    EXCEPTION_CLASSES = dict_merge(
+        DefaultParser.EXCEPTION_CLASSES, {
+            'ASK': AskError,
+            'TRYAGAIN': TryAgainError,
+            'MOVED': MovedError,
+            'CLUSTERDOWN': ClusterDownError,
+            'CROSSSLOT': ClusterCrossSlotError,
+            'MASTERDOWN': MasterDownError,
+        })
+
+
+class RedisCluster(ClusterCommands, object):
+    RedisClusterRequestTTL = 16
+
+    PRIMARIES = "primaries"
+    REPLICAS = "replicas"
+    ALL_NODES = "all"
+    RANDOM = "random"
+    DEFAULT_NODE = "default-node"
+
+    NODE_FLAGS = {
+        PRIMARIES,
+        REPLICAS,
+        ALL_NODES,
+        RANDOM,
+        DEFAULT_NODE
+    }
+
+    COMMAND_FLAGS = dict_merge(
+        list_keys_to_dict(
+            [
+                "CLIENT LIST",
+                "CLIENT SETNAME",
+                "CLIENT GETNAME",
+                "CONFIG SET",
+                "CONFIG REWRITE",
+                "CONFIG RESETSTAT",
+                "TIME",
+                "PUBSUB CHANNELS",
+                "PUBSUB NUMPAT",
+                "PUBSUB NUMSUB",
+                "PING",
+                "INFO",
+                "SHUTDOWN",
+                "KEYS",
+                "SCAN",
+                "FLUSHALL",
+                "FLUSHDB",
+                "DBSIZE",
+                "BGSAVE",
+                "SLOWLOG GET",
+                "SLOWLOG LEN",
+                "SLOWLOG RESET",
+                "WAIT",
+                "SAVE",
+                "MEMORY PURGE",
+                "MEMORY MALLOC-STATS",
+                "MEMORY STATS",
+                "LASTSAVE",
+                "CLIENT TRACKINGINFO",
+                "CLIENT PAUSE",
+                "CLIENT UNPAUSE",
+                "CLIENT UNBLOCK",
+                "CLIENT ID",
+                "CLIENT REPLY",
+                "CLIENT GETREDIR",
+                "CLIENT INFO",
+                "CLIENT KILL",
+                "READONLY",
+                "READWRITE",
+                "CLUSTER INFO",
+                "CLUSTER MEET",
+                "CLUSTER NODES",
+                "CLUSTER REPLICAS",
+                "CLUSTER RESET",
+                "CLUSTER SET-CONFIG-EPOCH",
+                "CLUSTER SLOTS",
+                "CLUSTER COUNT-FAILURE-REPORTS",
+                "CLUSTER KEYSLOT",
+                "COMMAND",
+                "COMMAND COUNT",
+                "COMMAND GETKEYS",
+                "CONFIG GET",
+                "DEBUG",
+                "RANDOMKEY",
+                "READONLY",
+                "READWRITE",
+                "TIME",
+            ],
+            DEFAULT_NODE,
+        ),
+        list_keys_to_dict(
+            [
+                "CLUSTER COUNTKEYSINSLOT",
+                "CLUSTER DELSLOTS",
+                "CLUSTER GETKEYSINSLOT",
+                "CLUSTER SETSLOT",
+            ],
+            SLOT_ID,
+        ),
+    )
+
+    CLUSTER_COMMANDS_RESPONSE_CALLBACKS = {
+        'CLUSTER ADDSLOTS': bool,
+        'CLUSTER COUNT-FAILURE-REPORTS': int,
+        'CLUSTER COUNTKEYSINSLOT': int,
+        'CLUSTER DELSLOTS': bool,
+        'CLUSTER FAILOVER': bool,
+        'CLUSTER FORGET': bool,
+        'CLUSTER GETKEYSINSLOT': list,
+        'CLUSTER KEYSLOT': int,
+        'CLUSTER MEET': bool,
+        'CLUSTER REPLICATE': bool,
+        'CLUSTER RESET': bool,
+        'CLUSTER SAVECONFIG': bool,
+        'CLUSTER SET-CONFIG-EPOCH': bool,
+        'CLUSTER SETSLOT': bool,
+        'CLUSTER SLOTS': parse_cluster_slots,
+        'ASKING': bool,
+        'READONLY': bool,
+        'READWRITE': bool,
+    }
+
+    RESULT_CALLBACKS = dict_merge(
+        list_keys_to_dict([
+            "PUBSUB NUMSUB",
+        ], parse_pubsub_numsub),
+        list_keys_to_dict([
+            "PUBSUB NUMPAT",
+        ], lambda command, res: sum(list(res.values()))),
+        list_keys_to_dict([
+            "KEYS",
+            "PUBSUB CHANNELS",
+        ], merge_result),
+        list_keys_to_dict([
+            "PING",
+            "CONFIG SET",
+            "CONFIG REWRITE",
+            "CONFIG RESETSTAT",
+            "CLIENT SETNAME",
+            "BGSAVE",
+            "SLOWLOG RESET",
+            "SAVE",
+            "MEMORY PURGE",
+            "CLIENT PAUSE",
+            "CLIENT UNPAUSE",
+        ], lambda command, res: all(res.values()) if isinstance(res, dict)
+            else res),
+        list_keys_to_dict([
+            "DBSIZE",
+            "WAIT",
+        ], lambda command, res: sum(res.values()) if isinstance(res, dict)
+            else res),
+        list_keys_to_dict([
+            "CLIENT UNBLOCK",
+        ], lambda command, res: 1 if sum(res.values()) > 0 else 0),
+        list_keys_to_dict([
+            "SCAN",
+        ], parse_scan_result)
+    )
+
+    def __init__(
+            self,
+            host=None,
+            port=6379,
+            startup_nodes=None,
+            cluster_error_retry_attempts=3,
+            require_full_coverage=True,
+            skip_full_coverage_check=False,
+            reinitialize_steps=10,
+            read_from_replicas=False,
+            url=None,
+            retry_on_timeout=False,
+            retry=None,
+            **kwargs
+    ):
+        """
+        Initialize a new RedisCluster client.
+
+        :startup_nodes: 'list[ClusterNode]'
+            List of nodes from which initial bootstrapping can be done
+        :host: 'str'
+            Can be used to point to a startup node
+        :port: 'int'
+            Can be used to point to a startup node
+        :require_full_coverage: 'bool'
+            If set to True, as it is by default, all slots must be covered.
+            If set to False and not all slots are covered, the instance
+            creation will succeed only if 'cluster-require-full-coverage'
+            configuration is set to 'no' in all of the cluster's nodes.
+            Otherwise, RedisClusterException will be thrown.
+        :skip_full_coverage_check: 'bool'
+            If require_full_coverage is set to False, a check of
+            cluster-require-full-coverage config will be executed against all
+            nodes. Set skip_full_coverage_check to True to skip this check.
+            Useful for clusters without the CONFIG command (like ElastiCache)
+       :read_from_replicas: 'bool'
+            Enable read from replicas in READONLY mode. You can read possibly
+            stale data.
+            When set to true, read commands will be assigned between the
+            primary and its replications in a Round-Robin manner.
+        :cluster_error_retry_attempts: 'int'
+            Retry command execution attempts when encountering ClusterDownError
+            or ConnectionError
+        :retry_on_timeout: 'bool'
+            To specify a retry policy, first set `retry_on_timeout` to `True`
+            then set `retry` to a valid `Retry` object
+        :retry: 'Retry'
+             a `Retry` object
+        :**kwargs:
+            Extra arguments that will be sent into Redis instance when created
+            (See Official redis-py doc for supported kwargs
+        [https://github.com/andymccurdy/redis-py/blob/master/redis/client.py])
+            Some kwargs are not supported and will raise a
+            RedisClusterException:
+                - db (Redis do not support database SELECT in cluster mode)
+        """
+        log.info("Creating a new instance of RedisCluster client")
+
+        if startup_nodes is None:
+            startup_nodes = []
+
+        if "db" in kwargs:
+            # Argument 'db' is not possible to use in cluster mode
+            raise RedisClusterException(
+                "Argument 'db' is not possible to use in cluster mode"
+            )
+
+        if retry_on_timeout:
+            kwargs.update({'retry_on_timeout': retry_on_timeout,
+                           'retry': retry})
+
+        # Get the startup node/s
+        from_url = False
+        if url is not None:
+            from_url = True
+            url_options = parse_url(url)
+            if "path" in url_options:
+                raise RedisClusterException(
+                    "RedisCluster does not currently support Unix Domain "
+                    "Socket connections")
+            if "db" in url_options and url_options["db"] != 0:
+                # Argument 'db' is not possible to use in cluster mode
+                raise RedisClusterException(
+                    "A ``db`` querystring option can only be 0 in cluster mode"
+                )
+            kwargs.update(url_options)
+            host = kwargs.get('host')
+            port = kwargs.get('port', port)
+            startup_nodes.append(ClusterNode(host, port))
+        elif host is not None and port is not None:
+            startup_nodes.append(ClusterNode(host, port))
+        elif len(startup_nodes) == 0:
+            # No startup node was provided
+            raise RedisClusterException(
+                "RedisCluster requires at least one node to discover the "
+                "cluster. Please provide one of the followings:\n"
+                "1. host and port, for example:\n"
+                " RedisCluster(host='localhost', port=6379)\n"
+                "2. list of startup nodes, for example:\n"
+                " RedisCluster(startup_nodes=[ClusterNode('localhost', 6379),"
+                " ClusterNode('localhost', 6378)])")
+        log.debug("startup_nodes : {0}".format(startup_nodes))
+        # Update the connection arguments
+        # Whenever a new connection is established, RedisCluster's on_connect
+        # method should be run
+        # If the user passed on_connect function we'll save it and run it
+        # inside the RedisCluster.on_connect() function
+        self.user_on_connect_func = kwargs.pop("redis_connect_func", None)
+        kwargs.update({"redis_connect_func": self.on_connect})
+        kwargs = cleanup_kwargs(**kwargs)
+
+        self.encoder = Encoder(
+            kwargs.get("encoding", "utf-8"),
+            kwargs.get("encoding_errors", "strict"),
+            kwargs.get("decode_responses", False),
+        )
+        self.cluster_error_retry_attempts = cluster_error_retry_attempts
+        self.command_flags = self.__class__.COMMAND_FLAGS.copy()
+        self.node_flags = self.__class__.NODE_FLAGS.copy()
+        self.read_from_replicas = read_from_replicas
+        self.reinitialize_counter = 0
+        self.reinitialize_steps = reinitialize_steps
+        self.nodes_manager = None
+        self.nodes_manager = NodesManager(
+            startup_nodes=startup_nodes,
+            from_url=from_url,
+            require_full_coverage=require_full_coverage,
+            skip_full_coverage_check=skip_full_coverage_check,
+            **kwargs,
+        )
+
+        self.cluster_response_callbacks = CaseInsensitiveDict(
+            self.__class__.CLUSTER_COMMANDS_RESPONSE_CALLBACKS)
+        self.result_callbacks = CaseInsensitiveDict(
+            self.__class__.RESULT_CALLBACKS)
+        self.commands_parser = CommandsParser(self)
+        self._lock = threading.Lock()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_value, traceback):
+        self.close()
+
+    def __del__(self):
+        self.close()
+
+    def disconnect_connection_pools(self):
+        for node in self.get_nodes():
+            if node.redis_connection:
+                try:
+                    node.redis_connection.connection_pool.disconnect()
+                except OSError:
+                    # Client was already disconnected. do nothing
+                    pass
+
+    @classmethod
+    def from_url(cls, url, **kwargs):
+        """
+        Return a Redis client object configured from the given URL
+
+        For example::
+
+            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 TCP socket connection. See more at:
+          <https://www.iana.org/assignments/uri-schemes/prov/redis>
+        - `rediss://` creates a SSL wrapped TCP socket connection. See more at:
+          <https://www.iana.org/assignments/uri-schemes/prov/rediss>
+        - ``unix://``: creates a Unix Domain Socket connection.
+
+        The username, password, hostname, path and all querystring values
+        are passed through urllib.parse.unquote in order to replace any
+        percent-encoded values with their corresponding characters.
+
+        There are several ways to specify a database number. The first value
+        found will be used:
+            1. A ``db`` querystring option, e.g. redis://localhost?db=0
+            2. If using the redis:// or rediss:// schemes, the path argument
+               of the url, e.g. redis://localhost/0
+            3. A ``db`` keyword argument to this function.
+
+        If none of these options are specified, the default db=0 is used.
+
+        All querystring options are cast to their appropriate Python types.
+        Boolean arguments can be specified with string values "True"/"False"
+        or "Yes"/"No". Values that cannot be properly cast cause a
+        ``ValueError`` to be raised. Once parsed, the querystring arguments
+        and keyword arguments are passed to the ``ConnectionPool``'s
+        class initializer. In the case of conflicting arguments, querystring
+        arguments always win.
+
+        """
+        return cls(url=url, **kwargs)
+
+    def on_connect(self, connection):
+        """
+        Initialize the connection, authenticate and select a database and send
+         READONLY if it is set during object initialization.
+        """
+        connection.set_parser(ClusterParser)
+        connection.on_connect()
+
+        if self.read_from_replicas:
+            # Sending READONLY command to server to configure connection as
+            # readonly. Since each cluster node may change its server type due
+            # to a failover, we should establish a READONLY connection
+            # regardless of the server type. If this is a primary connection,
+            # READONLY would not affect executing write commands.
+            connection.send_command('READONLY')
+            if str_if_bytes(connection.read_response()) != 'OK':
+                raise ConnectionError('READONLY command failed')
+
+        if self.user_on_connect_func is not None:
+            self.user_on_connect_func(connection)
+
+    def get_redis_connection(self, node):
+        if not node.redis_connection:
+            with self._lock:
+                if not node.redis_connection:
+                    self.nodes_manager.create_redis_connections([node])
+        return node.redis_connection
+
+    def get_node(self, host=None, port=None, node_name=None):
+        return self.nodes_manager.get_node(host, port, node_name)
+
+    def get_primaries(self):
+        return self.nodes_manager.get_nodes_by_server_type(PRIMARY)
+
+    def get_replicas(self):
+        return self.nodes_manager.get_nodes_by_server_type(REPLICA)
+
+    def get_random_node(self):
+        return random.choice(list(self.nodes_manager.nodes_cache.values()))
+
+    def get_nodes(self):
+        return list(self.nodes_manager.nodes_cache.values())
+
+    def get_node_from_key(self, key, replica=False):
+        """
+        Get the node that holds the key's slot.
+        If replica set to True but the slot doesn't have any replicas, None is
+        returned.
+        """
+        slot = self.keyslot(key)
+        slot_cache = self.nodes_manager.slots_cache.get(slot)
+        if slot_cache is None or len(slot_cache) == 0:
+            raise SlotNotCoveredError(
+                'Slot "{0}" is not covered by the cluster.'.format(slot)
+            )
+        if replica and len(self.nodes_manager.slots_cache[slot]) < 2:
+            return None
+        elif replica:
+            node_idx = 1
+        else:
+            # primary
+            node_idx = 0
+
+        return slot_cache[node_idx]
+
+    def get_default_node(self):
+        """
+        Get the cluster's default node
+        """
+        return self.nodes_manager.default_node
+
+    def set_default_node(self, node):
+        """
+        Set the default node of the cluster.
+        :param node: 'ClusterNode'
+        :return True if the default node was set, else False
+        """
+        if node is None or self.get_node(node_name=node.name) is None:
+            log.info("The requested node does not exist in the cluster, so "
+                     "the default node was not changed.")
+            return False
+        self.nodes_manager.default_node = node
+        log.info("Changed the default cluster node to {0}".format(node))
+        return True
+
+    def pubsub(self, node=None, host=None, port=None, **kwargs):
+        """
+        Allows passing a ClusterNode, or host&port, to get a pubsub instance
+        connected to the specified node
+        """
+        return ClusterPubSub(self, node=node, host=host, port=port, **kwargs)
+
+    def pipeline(self, transaction=None, shard_hint=None):
+        """
+        Cluster impl:
+            Pipelines do not work in cluster mode the same way they
+            do in normal mode. Create a clone of this object so
+            that simulating pipelines will work correctly. Each
+            command will be called directly when used and
+            when calling execute() will only return the result stack.
+        """
+        if shard_hint:
+            raise RedisClusterException(
+                "shard_hint is deprecated in cluster mode")
+
+        if transaction:
+            raise RedisClusterException(
+                "transaction is deprecated in cluster mode")
+
+        return ClusterPipeline(
+            nodes_manager=self.nodes_manager,
+            startup_nodes=self.nodes_manager.startup_nodes,
+            result_callbacks=self.result_callbacks,
+            cluster_response_callbacks=self.cluster_response_callbacks,
+            cluster_error_retry_attempts=self.cluster_error_retry_attempts,
+            read_from_replicas=self.read_from_replicas,
+            reinitialize_steps=self.reinitialize_steps
+        )
+
+    def _determine_nodes(self, *args, **kwargs):
+        command = args[0]
+        nodes_flag = kwargs.pop("nodes_flag", None)
+        if nodes_flag is not None:
+            # nodes flag passed by the user
+            command_flag = nodes_flag
+        else:
+            # get the nodes group for this command if it was predefined
+            command_flag = self.command_flags.get(command)
+        if command_flag:
+            log.debug("Target node/s for {0}: {1}".
+                      format(command, command_flag))
+        if command_flag == self.__class__.RANDOM:
+            # return a random node
+            return [self.get_random_node()]
+        elif command_flag == self.__class__.PRIMARIES:
+            # return all primaries
+            return self.get_primaries()
+        elif command_flag == self.__class__.REPLICAS:
+            # return all replicas
+            return self.get_replicas()
+        elif command_flag == self.__class__.ALL_NODES:
+            # return all nodes
+            return self.get_nodes()
+        elif command_flag == self.__class__.DEFAULT_NODE:
+            # return the cluster's default node
+            return [self.nodes_manager.default_node]
+        else:
+            # get the node that holds the key's slot
+            slot = self.determine_slot(*args)
+            node = self.nodes_manager.get_node_from_slot(
+                slot, self.read_from_replicas and command in READ_COMMANDS)
+            log.debug("Target for {0}: slot {1}".format(args, slot))
+            return [node]
+
+    def _should_reinitialized(self):
+        # In order not to reinitialize the cluster, the user can set
+        # reinitialize_steps to 0.
+        if self.reinitialize_steps == 0:
+            return False
+        else:
+            return self.reinitialize_counter % self.reinitialize_steps == 0
+
+    def keyslot(self, key):
+        """
+        Calculate keyslot for a given key.
+        See Keys distribution model in https://redis.io/topics/cluster-spec
+        """
+        k = self.encoder.encode(key)
+        return key_slot(k)
+
+    def _get_command_keys(self, *args):
+        """
+        Get the keys in the command. If the command has no keys in in, None is
+        returned.
+        """
+        redis_conn = self.get_default_node().redis_connection
+        return self.commands_parser.get_keys(redis_conn, *args)
+
+    def determine_slot(self, *args):
+        """
+        Figure out what slot based on command and args
+        """
+        if self.command_flags.get(args[0]) == SLOT_ID:
+            # The command contains the slot ID
+            return args[1]
+
+        # Get the keys in the command
+        keys = self._get_command_keys(*args)
+        if keys is None or len(keys) == 0:
+            raise RedisClusterException(
+                "No way to dispatch this command to Redis Cluster. "
+                "Missing key.\nYou can execute the command by specifying "
+                "target nodes.\nCommand: {0}".format(args)
+            )
+
+        if len(keys) > 1:
+            # multi-key command, we need to make sure all keys are mapped to
+            # the same slot
+            slots = {self.keyslot(key) for key in keys}
+            if len(slots) != 1:
+                raise RedisClusterException("{0} - all keys must map to the "
+                                            "same key slot".format(args[0]))
+            return slots.pop()
+        else:
+            # single key command
+            return self.keyslot(keys[0])
+
+    def reinitialize_caches(self):
+        self.nodes_manager.initialize()
+
+    def _is_nodes_flag(self, target_nodes):
+        return isinstance(target_nodes, str) \
+            and target_nodes in self.node_flags
+
+    def _parse_target_nodes(self, target_nodes):
+        if isinstance(target_nodes, list):
+            nodes = target_nodes
+        elif isinstance(target_nodes, ClusterNode):
+            # Supports passing a single ClusterNode as a variable
+            nodes = [target_nodes]
+        elif isinstance(target_nodes, dict):
+            # Supports dictionaries of the format {node_name: node}.
+            # It enables to execute commands with multi nodes as follows:
+            # rc.cluster_save_config(rc.get_primaries())
+            nodes = target_nodes.values()
+        else:
+            raise TypeError("target_nodes type can be one of the "
+                            "followings: node_flag (PRIMARIES, "
+                            "REPLICAS, RANDOM, ALL_NODES),"
+                            "ClusterNode, list<ClusterNode>, or "
+                            "dict<any, ClusterNode>. The passed type is {0}".
+                            format(type(target_nodes)))
+        return nodes
+
+    def execute_command(self, *args, **kwargs):
+        """
+        Wrapper for ClusterDownError and ConnectionError error handling.
+
+        It will try the number of times specified by the config option
+        "self.cluster_error_retry_attempts" which defaults to 3 unless manually
+        configured.
+
+        If it reaches the number of times, the command will raise the exception
+
+        Key argument :target_nodes: can be passed with the following types:
+            nodes_flag: PRIMARIES, REPLICAS, ALL_NODES, RANDOM
+            ClusterNode
+            list<ClusterNode>
+            dict<Any, ClusterNode>
+        """
+        target_nodes_specified = False
+        target_nodes = kwargs.pop("target_nodes", None)
+        if target_nodes is not None and not self._is_nodes_flag(target_nodes):
+            target_nodes = self._parse_target_nodes(target_nodes)
+            target_nodes_specified = True
+        # If ClusterDownError/ConnectionError were thrown, the nodes
+        # and slots cache were reinitialized. We will retry executing the
+        # command with the updated cluster setup only when the target nodes
+        # can be determined again with the new cache tables. Therefore,
+        # when target nodes were passed to this function, we cannot retry
+        # the command execution since the nodes may not be valid anymore
+        # after the tables were reinitialized. So in case of passed target
+        # nodes, retry_attempts will be set to 1.
+        retry_attempts = 1 if target_nodes_specified else \
+            self.cluster_error_retry_attempts
+        exception = None
+        for _ in range(0, retry_attempts):
+            try:
+                res = {}
+                if not target_nodes_specified:
+                    # Determine the nodes to execute the command on
+                    target_nodes = self._determine_nodes(
+                        *args, **kwargs, nodes_flag=target_nodes)
+                    if not target_nodes:
+                        raise RedisClusterException(
+                            "No targets were found to execute"
+                            " {} command on".format(args))
+                for node in target_nodes:
+                    res[node.name] = self._execute_command(
+                        node, *args, **kwargs)
+                # Return the processed result
+                return self._process_result(args[0], res, **kwargs)
+            except (ClusterDownError, ConnectionError) as e:
+                # The nodes and slots cache were reinitialized.
+                # Try again with the new cluster setup. All other errors
+                # should be raised.
+                exception = e
+
+        # If it fails the configured number of times then raise exception back
+        # to caller of this method
+        raise exception
+
+    def _execute_command(self, target_node, *args, **kwargs):
+        """
+        Send a command to a node in the cluster
+        """
+        command = args[0]
+        redis_node = None
+        connection = None
+        redirect_addr = None
+        asking = False
+        moved = False
+        ttl = int(self.RedisClusterRequestTTL)
+        connection_error_retry_counter = 0
+
+        while ttl > 0:
+            ttl -= 1
+            try:
+                if asking:
+                    target_node = self.get_node(node_name=redirect_addr)
+                elif moved:
+                    # MOVED occurred and the slots cache was updated,
+                    # refresh the target node
+                    slot = self.determine_slot(*args)
+                    target_node = self.nodes_manager. \
+                        get_node_from_slot(slot, self.read_from_replicas and
+                                           command in READ_COMMANDS)
+                    moved = False
+
+                log.debug("Executing command {0} on target node: {1} {2}".
+                          format(command, target_node.server_type,
+                                 target_node.name))
+                redis_node = self.get_redis_connection(target_node)
+                connection = get_connection(redis_node, *args, **kwargs)
+                if asking:
+                    connection.send_command("ASKING")
+                    redis_node.parse_response(connection, "ASKING", **kwargs)
+                    asking = False
+
+                connection.send_command(*args)
+                response = redis_node.parse_response(connection, command,
+                                                     **kwargs)
+                if command in self.cluster_response_callbacks:
+                    response = self.cluster_response_callbacks[command](
+                        response, **kwargs)
+                return response
+
+            except (RedisClusterException, BusyLoadingError):
+                log.exception("RedisClusterException || BusyLoadingError")
+                raise
+            except ConnectionError:
+                log.exception("ConnectionError")
+                # ConnectionError can also be raised if we couldn't get a
+                # connection from the pool before timing out, so check that
+                # this is an actual connection before attempting to disconnect.
+                if connection is not None:
+                    connection.disconnect()
+                connection_error_retry_counter += 1
+
+                # Give the node 0.25 seconds to get back up and retry again
+                # with same node and configuration. After 5 attempts then try
+                # to reinitialize the cluster and see if the nodes
+                # configuration has changed or not
+                if connection_error_retry_counter < 5:
+                    time.sleep(0.25)
+                else:
+                    # Hard force of reinitialize of the node/slots setup
+                    # and try again with the new setup
+                    self.nodes_manager.initialize()
+                    raise
+            except TimeoutError:
+                log.exception("TimeoutError")
+                if connection is not None:
+                    connection.disconnect()
+
+                if ttl < self.RedisClusterRequestTTL / 2:
+                    time.sleep(0.05)
+            except MovedError as e:
+                # First, we will try to patch the slots/nodes cache with the
+                # redirected node output and try again. If MovedError exceeds
+                # 'reinitialize_steps' number of times, we will force
+                # reinitializing the tables, and then try again.
+                # 'reinitialize_steps' counter will increase faster when the
+                # same client object is shared between multiple threads. To
+                # reduce the frequency you can set this variable in the
+                # RedisCluster constructor.
+                log.exception("MovedError")
+                self.reinitialize_counter += 1
+                if self._should_reinitialized():
+                    self.nodes_manager.initialize()
+                else:
+                    self.nodes_manager.update_moved_exception(e)
+                    moved = True
+            except TryAgainError:
+                log.exception("TryAgainError")
+
+                if ttl < self.RedisClusterRequestTTL / 2:
+                    time.sleep(0.05)
+            except AskError as e:
+                log.exception("AskError")
+
+                redirect_addr = get_node_name(host=e.host, port=e.port)
+                asking = True
+            except ClusterDownError as e:
+                log.exception("ClusterDownError")
+                # ClusterDownError can occur during a failover and to get
+                # self-healed, we will try to reinitialize the cluster layout
+                # and retry executing the command
+                time.sleep(0.05)
+                self.nodes_manager.initialize()
+                raise e
+            except ResponseError as e:
+                message = e.__str__()
+                log.exception("ResponseError: {0}".format(message))
+                raise e
+            except BaseException as e:
+                log.exception("BaseException")
+                if connection:
+                    connection.disconnect()
+                raise e
+            finally:
+                if connection is not None:
+                    redis_node.connection_pool.release(connection)
+
+        raise ClusterError("TTL exhausted.")
+
+    def close(self):
+        try:
+            with self._lock:
+                if self.nodes_manager:
+                    self.nodes_manager.close()
+        except AttributeError:
+            # RedisCluster's __init__ can fail before nodes_manager is set
+            pass
+
+    def _process_result(self, command, res, **kwargs):
+        """
+        Process the result of the executed command.
+        The function would return a dict or a single value.
+
+        :type command: str
+        :type res: dict
+
+        `res` should be in the following format:
+            Dict<node_name, command_result>
+        """
+        if command in self.result_callbacks:
+            return self.result_callbacks[command](command, res, **kwargs)
+        elif len(res) == 1:
+            # When we execute the command on a single node, we can
+            # remove the dictionary and return a single response
+            return list(res.values())[0]
+        else:
+            return res
+
+
+class ClusterNode(object):
+    def __init__(self, host, port, server_type=None, redis_connection=None):
+        if host == 'localhost':
+            host = socket.gethostbyname(host)
+
+        self.host = host
+        self.port = port
+        self.name = get_node_name(host, port)
+        self.server_type = server_type
+        self.redis_connection = redis_connection
+
+    def __repr__(self):
+        return '[host={0},port={1},' \
+               'name={2},server_type={3},redis_connection={4}]' \
+            .format(self.host,
+                    self.port,
+                    self.name,
+                    self.server_type,
+                    self.redis_connection)
+
+    def __eq__(self, obj):
+        return isinstance(obj, ClusterNode) and obj.name == self.name
+
+
+class LoadBalancer:
+    """
+    Round-Robin Load Balancing
+    """
+
+    def __init__(self, start_index=0):
+        self.primary_to_idx = {}
+        self.start_index = start_index
+
+    def get_server_index(self, primary, list_size):
+        server_index = self.primary_to_idx.setdefault(primary,
+                                                      self.start_index)
+        # Update the index
+        self.primary_to_idx[primary] = (server_index + 1) % list_size
+        return server_index
+
+    def reset(self):
+        self.primary_to_idx.clear()
+
+
+class NodesManager:
+    def __init__(self, startup_nodes, from_url=False,
+                 require_full_coverage=True, skip_full_coverage_check=False,
+                 lock=None, **kwargs):
+        self.nodes_cache = {}
+        self.slots_cache = {}
+        self.startup_nodes = {}
+        self.default_node = None
+        self.populate_startup_nodes(startup_nodes)
+        self.from_url = from_url
+        self._require_full_coverage = require_full_coverage
+        self._skip_full_coverage_check = skip_full_coverage_check
+        self._moved_exception = None
+        self.connection_kwargs = kwargs
+        self.read_load_balancer = LoadBalancer()
+        if lock is None:
+            lock = threading.Lock()
+        self._lock = lock
+        self.initialize()
+
+    def get_node(self, host=None, port=None, node_name=None):
+        """
+        Get the requested node from the cluster's nodes.
+        nodes.
+        :return: ClusterNode if the node exists, else None
+        """
+        if host and port:
+            # the user passed host and port
+            if host == "localhost":
+                host = socket.gethostbyname(host)
+            return self.nodes_cache.get(get_node_name(host=host, port=port))
+        elif node_name:
+            return self.nodes_cache.get(node_name)
+        else:
+            log.error(
+                "get_node requires one of the following: "
+                "1. node name "
+                "2. host and port"
+            )
+            return None
+
+    def update_moved_exception(self, exception):
+        self._moved_exception = exception
+
+    def _update_moved_slots(self):
+        """
+        Update the slot's node with the redirected one
+        """
+        e = self._moved_exception
+        redirected_node = self.get_node(host=e.host, port=e.port)
+        if redirected_node is not None:
+            # The node already exists
+            if redirected_node.server_type is not PRIMARY:
+                # Update the node's server type
+                redirected_node.server_type = PRIMARY
+        else:
+            # This is a new node, we will add it to the nodes cache
+            redirected_node = ClusterNode(e.host, e.port, PRIMARY)
+            self.nodes_cache[redirected_node.name] = redirected_node
+        if redirected_node in self.slots_cache[e.slot_id]:
+            # The MOVED error resulted from a failover, and the new slot owner
+            # had previously been a replica.
+            old_primary = self.slots_cache[e.slot_id][0]
+            # Update the old primary to be a replica and add it to the end of
+            # the slot's node list
+            old_primary.server_type = REPLICA
+            self.slots_cache[e.slot_id].append(old_primary)
+            # Remove the old replica, which is now a primary, from the slot's
+            # node list
+            self.slots_cache[e.slot_id].remove(redirected_node)
+            # Override the old primary with the new one
+            self.slots_cache[e.slot_id][0] = redirected_node
+            if self.default_node == old_primary:
+                # Update the default node with the new primary
+                self.default_node = redirected_node
+        else:
+            # The new slot owner is a new server, or a server from a different
+            # shard. We need to remove all current nodes from the slot's list
+            # (including replications) and add just the new node.
+            self.slots_cache[e.slot_id] = [redirected_node]
+        # Reset moved_exception
+        self._moved_exception = None
+
+    def get_node_from_slot(self, slot, read_from_replicas=False,
+                           server_type=None):
+        """
+        Gets a node that servers this hash slot
+        """
+        if self._moved_exception:
+            with self._lock:
+                if self._moved_exception:
+                    self._update_moved_slots()
+
+        if self.slots_cache.get(slot) is None or \
+                len(self.slots_cache[slot]) == 0:
+            raise SlotNotCoveredError(
+                'Slot "{0}" not covered by the cluster. '
+                '"require_full_coverage={1}"'.format(
+                    slot, self._require_full_coverage)
+            )
+
+        if read_from_replicas is True:
+            # get the server index in a Round-Robin manner
+            primary_name = self.slots_cache[slot][0].name
+            node_idx = self.read_load_balancer.get_server_index(
+                primary_name, len(self.slots_cache[slot]))
+        elif (
+                server_type is None
+                or server_type == PRIMARY
+                or len(self.slots_cache[slot]) == 1
+        ):
+            # return a primary
+            node_idx = 0
+        else:
+            # return a replica
+            # randomly choose one of the replicas
+            node_idx = random.randint(
+                1, len(self.slots_cache[slot]) - 1)
+
+        return self.slots_cache[slot][node_idx]
+
+    def get_nodes_by_server_type(self, server_type):
+        """
+        Get all nodes with the specified server type
+        :param server_type: 'primary' or 'replica'
+        :return: list of ClusterNode
+        """
+        return [
+            node
+            for node in self.nodes_cache.values()
+            if node.server_type == server_type
+        ]
+
+    def populate_startup_nodes(self, nodes):
+        """
+        Populate all startup nodes and filters out any duplicates
+        """
+        for n in nodes:
+            self.startup_nodes[n.name] = n
+
+    def cluster_require_full_coverage(self, cluster_nodes):
+        """
+        if exists 'cluster-require-full-coverage no' config on redis servers,
+        then even all slots are not covered, cluster still will be able to
+        respond
+        """
+
+        def node_require_full_coverage(node):
+            try:
+                return ("yes" in node.redis_connection.config_get(
+                    "cluster-require-full-coverage").values()
+                )
+            except ConnectionError:
+                return False
+            except Exception as e:
+                raise RedisClusterException(
+                    'ERROR sending "config get cluster-require-full-coverage"'
+                    ' command to redis server: {0}, {1}'.format(node.name, e)
+                )
+
+        # at least one node should have cluster-require-full-coverage yes
+        return any(node_require_full_coverage(node)
+                   for node in cluster_nodes.values())
+
+    def check_slots_coverage(self, slots_cache):
+        # Validate if all slots are covered or if we should try next
+        # startup node
+        for i in range(0, REDIS_CLUSTER_HASH_SLOTS):
+            if i not in slots_cache:
+                return False
+        return True
+
+    def create_redis_connections(self, nodes):
+        """
+        This function will create a redis connection to all nodes in :nodes:
+        """
+        for node in nodes:
+            if node.redis_connection is None:
+                node.redis_connection = self.create_redis_node(
+                    host=node.host,
+                    port=node.port,
+                    **self.connection_kwargs,
+                )
+
+    def create_redis_node(self, host, port, **kwargs):
+        if self.from_url:
+            # Create a redis node with a costumed connection pool
+            kwargs.update({"host": host})
+            kwargs.update({"port": port})
+            r = Redis(connection_pool=ConnectionPool(**kwargs))
+        else:
+            r = Redis(
+                host=host,
+                port=port,
+                **kwargs
+            )
+        return r
+
+    def initialize(self):
+        """
+        Initializes the nodes cache, slots cache and redis connections.
+        :startup_nodes:
+            Responsible for discovering other nodes in the cluster
+        """
+        log.debug("Initializing the nodes' topology of the cluster")
+        self.reset()
+        tmp_nodes_cache = {}
+        tmp_slots = {}
+        disagreements = []
+        startup_nodes_reachable = False
+        kwargs = self.connection_kwargs
+        for startup_node in self.startup_nodes.values():
+            try:
+                if startup_node.redis_connection:
+                    r = startup_node.redis_connection
+                else:
+                    # Create a new Redis connection and let Redis decode the
+                    # responses so we won't need to handle that
+                    copy_kwargs = copy.deepcopy(kwargs)
+                    copy_kwargs.update({"decode_responses": True,
+                                        "encoding": "utf-8"})
+                    r = self.create_redis_node(
+                        startup_node.host, startup_node.port, **copy_kwargs)
+                    self.startup_nodes[startup_node.name].redis_connection = r
+                cluster_slots = r.execute_command("CLUSTER SLOTS")
+                startup_nodes_reachable = True
+            except (ConnectionError, TimeoutError) as e:
+                msg = e.__str__
+                log.exception('An exception occurred while trying to'
+                              ' initialize the cluster using the seed node'
+                              ' {0}:\n{1}'.format(startup_node.name, msg))
+                continue
+            except ResponseError as e:
+                log.exception(
+                    'ReseponseError sending "cluster slots" to redis server')
+
+                # Isn't a cluster connection, so it won't parse these
+                # exceptions automatically
+                message = e.__str__()
+                if "CLUSTERDOWN" in message or "MASTERDOWN" in message:
+                    continue
+                else:
+                    raise RedisClusterException(
+                        'ERROR sending "cluster slots" command to redis '
+                        'server: {0}. error: {1}'.format(
+                            startup_node, message)
+                    )
+            except Exception as e:
+                message = e.__str__()
+                raise RedisClusterException(
+                    'ERROR sending "cluster slots" command to redis '
+                    'server: {0}. error: {1}'.format(
+                        startup_node, message)
+                )
+
+            # CLUSTER SLOTS command results in the following output:
+            # [[slot_section[from_slot,to_slot,master,replica1,...,replicaN]]]
+            # where each node contains the following list: [IP, port, node_id]
+            # Therefore, cluster_slots[0][2][0] will be the IP address of the
+            # primary node of the first slot section.
+            # If there's only one server in the cluster, its ``host`` is ''
+            # Fix it to the host in startup_nodes
+            if (len(cluster_slots) == 1
+                    and len(cluster_slots[0][2][0]) == 0
+                    and len(self.startup_nodes) == 1):
+                cluster_slots[0][2][0] = startup_node.host
+
+            for slot in cluster_slots:
+                primary_node = slot[2]
+                host = primary_node[0]
+                if host == "":
+                    host = startup_node.host
+                port = int(primary_node[1])
+
+                target_node = tmp_nodes_cache.get(get_node_name(host, port))
+                if target_node is None:
+                    target_node = ClusterNode(host, port, PRIMARY)
+                # add this node to the nodes cache
+                tmp_nodes_cache[target_node.name] = target_node
+
+                for i in range(int(slot[0]), int(slot[1]) + 1):
+                    if i not in tmp_slots:
+                        tmp_slots[i] = []
+                        tmp_slots[i].append(target_node)
+                        replica_nodes = [slot[j] for j in range(3, len(slot))]
+
+                        for replica_node in replica_nodes:
+                            host = replica_node[0]
+                            port = replica_node[1]
+
+                            target_replica_node = tmp_nodes_cache.get(
+                                get_node_name(host, port))
+                            if target_replica_node is None:
+                                target_replica_node = ClusterNode(
+                                    host, port, REPLICA)
+                            tmp_slots[i].append(target_replica_node)
+                            # add this node to the nodes cache
+                            tmp_nodes_cache[
+                                target_replica_node.name
+                            ] = target_replica_node
+                    else:
+                        # Validate that 2 nodes want to use the same slot cache
+                        # setup
+                        if tmp_slots[i][0].name != target_node.name:
+                            disagreements.append(
+                                '{0} vs {1} on slot: {2}'.format(
+                                    tmp_slots[i][0].name, target_node.name, i)
+                            )
+
+                            if len(disagreements) > 5:
+                                raise RedisClusterException(
+                                    'startup_nodes could not agree on a valid'
+                                    ' slots cache: {0}'.format(
+                                        ", ".join(disagreements))
+                                )
+
+        if not startup_nodes_reachable:
+            raise RedisClusterException(
+                "Redis Cluster cannot be connected. Please provide at least "
+                "one reachable node. "
+            )
+
+        # Create Redis connections to all nodes
+        self.create_redis_connections(list(tmp_nodes_cache.values()))
+
+        fully_covered = self.check_slots_coverage(tmp_slots)
+        # Check if the slots are not fully covered
+        if not fully_covered and self._require_full_coverage:
+            # Despite the requirement that the slots be covered, there
+            # isn't a full coverage
+            raise RedisClusterException(
+                'All slots are not covered after query all startup_nodes.'
+                ' {0} of {1} covered...'.format(
+                    len(self.slots_cache), REDIS_CLUSTER_HASH_SLOTS)
+            )
+        elif not fully_covered and not self._require_full_coverage:
+            # The user set require_full_coverage to False.
+            # In case of full coverage requirement in the cluster's Redis
+            # configurations, we will raise an exception. Otherwise, we may
+            # continue with partial coverage.
+            # see Redis Cluster configuration parameters in
+            # https://redis.io/topics/cluster-tutorial
+            if not self._skip_full_coverage_check and \
+                    self.cluster_require_full_coverage(tmp_nodes_cache):
+                raise RedisClusterException(
+                    'Not all slots are covered but the cluster\'s '
+                    'configuration requires full coverage. Set '
+                    'cluster-require-full-coverage configuration to no on '
+                    'all of the cluster nodes if you wish the cluster to '
+                    'be able to serve without being fully covered.'
+                    ' {0} of {1} covered...'.format(
+                        len(self.slots_cache), REDIS_CLUSTER_HASH_SLOTS)
+                )
+
+        # Set the tmp variables to the real variables
+        self.nodes_cache = tmp_nodes_cache
+        self.slots_cache = tmp_slots
+        # Set the default node
+        self.default_node = self.get_nodes_by_server_type(PRIMARY)[0]
+        # Populate the startup nodes with all discovered nodes
+        self.populate_startup_nodes(self.nodes_cache.values())
+
+    def close(self):
+        self.default_node = None
+        for node in self.nodes_cache.values():
+            if node.redis_connection:
+                node.redis_connection.close()
+
+    def reset(self):
+        try:
+            self.read_load_balancer.reset()
+        except TypeError:
+            # The read_load_balancer is None, do nothing
+            pass
+
+
+class ClusterPubSub(PubSub):
+    """
+    Wrapper for PubSub class.
+
+    IMPORTANT: before using ClusterPubSub, read about the known limitations
+    with pubsub in Cluster mode and learn how to workaround them:
+    https://redis-py-cluster.readthedocs.io/en/stable/pubsub.html
+    """
+
+    def __init__(self, redis_cluster, node=None, host=None, port=None,
+                 **kwargs):
+        """
+        When a pubsub instance is created without specifying a node, a single
+        node will be transparently chosen for the pubsub connection on the
+        first command execution. The node will be determined by:
+         1. Hashing the channel name in the request to find its keyslot
+         2. Selecting a node that handles the keyslot: If read_from_replicas is
+            set to true, a replica can be selected.
+
+        :type redis_cluster: RedisCluster
+        :type node: ClusterNode
+        :type host: str
+        :type port: int
+        """
+        log.info("Creating new instance of ClusterPubSub")
+        self.node = None
+        self.set_pubsub_node(redis_cluster, node, host, port)
+        connection_pool = None if self.node is None else \
+            redis_cluster.get_redis_connection(self.node).connection_pool
+        self.cluster = redis_cluster
+        super().__init__(**kwargs, connection_pool=connection_pool,
+                         encoder=redis_cluster.encoder)
+
+    def set_pubsub_node(self, cluster, node=None, host=None, port=None):
+        """
+        The pubsub node will be set according to the passed node, host and port
+        When none of the node, host, or port are specified - the node is set
+        to None and will be determined by the keyslot of the channel in the
+        first command to be executed.
+        RedisClusterException will be thrown if the passed node does not exist
+        in the cluster.
+        If host is passed without port, or vice versa, a DataError will be
+        thrown.
+        :type cluster: RedisCluster
+        :type node: ClusterNode
+        :type host: str
+        :type port: int
+        """
+        if node is not None:
+            # node is passed by the user
+            self._raise_on_invalid_node(cluster, node, node.host, node.port)
+            pubsub_node = node
+        elif host is not None and port is not None:
+            # host and port passed by the user
+            node = cluster.get_node(host=host, port=port)
+            self._raise_on_invalid_node(cluster, node, host, port)
+            pubsub_node = node
+        elif any([host, port]) is True:
+            # only 'host' or 'port' passed
+            raise DataError('Passing a host requires passing a port, '
+                            'and vice versa')
+        else:
+            # nothing passed by the user. set node to None
+            pubsub_node = None
+
+        self.node = pubsub_node
+
+    def get_pubsub_node(self):
+        """
+        Get the node that is being used as the pubsub connection
+        """
+        return self.node
+
+    def _raise_on_invalid_node(self, redis_cluster, node, host, port):
+        """
+        Raise a RedisClusterException if the node is None or doesn't exist in
+        the cluster.
+        """
+        if node is None or redis_cluster.get_node(node_name=node.name) is None:
+            raise RedisClusterException(
+                "Node {0}:{1} doesn't exist in the cluster"
+                .format(host, port))
+
+    def execute_command(self, *args, **kwargs):
+        """
+        Execute a publish/subscribe command.
+
+        Taken code from redis-py and tweak to make it work within a cluster.
+        """
+        # NOTE: don't parse the response in this function -- it could pull a
+        # legitimate message off the stack if the connection is already
+        # subscribed to one or more channels
+
+        if self.connection is None:
+            if self.connection_pool is None:
+                if len(args) > 1:
+                    # Hash the first channel and get one of the nodes holding
+                    # this slot
+                    channel = args[1]
+                    slot = self.cluster.keyslot(channel)
+                    node = self.cluster.nodes_manager. \
+                        get_node_from_slot(slot, self.cluster.
+                                           read_from_replicas)
+                else:
+                    # Get a random node
+                    node = self.cluster.get_random_node()
+                self.node = node
+                redis_connection = self.cluster.get_redis_connection(node)
+                self.connection_pool = redis_connection.connection_pool
+            self.connection = self.connection_pool.get_connection(
+                'pubsub',
+                self.shard_hint
+            )
+            # register a callback that re-subscribes to any channels we
+            # were listening to when we were disconnected
+            self.connection.register_connect_callback(self.on_connect)
+        connection = self.connection
+        self._execute(connection, connection.send_command, *args)
+
+    def get_redis_connection(self):
+        """
+        Get the Redis connection of the pubsub connected node.
+        """
+        if self.node is not None:
+            return self.node.redis_connection
+
+
+ERRORS_ALLOW_RETRY = (ConnectionError, TimeoutError,
+                      MovedError, AskError, TryAgainError)
+
+
+class ClusterPipeline(RedisCluster):
+    """
+    Support for Redis pipeline
+    in cluster mode
+    """
+
+    def __init__(self, nodes_manager, result_callbacks=None,
+                 cluster_response_callbacks=None, startup_nodes=None,
+                 read_from_replicas=False, cluster_error_retry_attempts=3,
+                 reinitialize_steps=10, **kwargs):
+        """
+        """
+        log.info("Creating new instance of ClusterPipeline")
+        self.command_stack = []
+        self.nodes_manager = nodes_manager
+        self.refresh_table_asap = False
+        self.result_callbacks = (result_callbacks or
+                                 self.__class__.RESULT_CALLBACKS.copy())
+        self.startup_nodes = startup_nodes if startup_nodes else []
+        self.read_from_replicas = read_from_replicas
+        self.command_flags = self.__class__.COMMAND_FLAGS.copy()
+        self.cluster_response_callbacks = cluster_response_callbacks
+        self.cluster_error_retry_attempts = cluster_error_retry_attempts
+        self.reinitialize_counter = 0
+        self.reinitialize_steps = reinitialize_steps
+        self.encoder = Encoder(
+            kwargs.get("encoding", "utf-8"),
+            kwargs.get("encoding_errors", "strict"),
+            kwargs.get("decode_responses", False),
+        )
+
+        # The commands parser refers to the parent
+        # so that we don't push the COMMAND command
+        # onto the stack
+        self.commands_parser = CommandsParser(super())
+
+    def __repr__(self):
+        """
+        """
+        return "{0}".format(type(self).__name__)
+
+    def __enter__(self):
+        """
+        """
+        return self
+
+    def __exit__(self, exc_type, exc_value, traceback):
+        """
+        """
+        self.reset()
+
+    def __del__(self):
+        try:
+            self.reset()
+        except Exception:
+            pass
+
+    def __len__(self):
+        """
+        """
+        return len(self.command_stack)
+
+    def __nonzero__(self):
+        "Pipeline instances should  always evaluate to True on Python 2.7"
+        return True
+
+    def __bool__(self):
+        "Pipeline instances should  always evaluate to True on Python 3+"
+        return True
+
+    def execute_command(self, *args, **kwargs):
+        """
+        Wrapper function for pipeline_execute_command
+        """
+        return self.pipeline_execute_command(*args, **kwargs)
+
+    def pipeline_execute_command(self, *args, **options):
+        """
+        Appends the executed command to the pipeline's command stack
+        """
+        self.command_stack.append(
+            PipelineCommand(args, options, len(self.command_stack)))
+        return self
+
+    def raise_first_error(self, stack):
+        """
+        Raise the first exception on the stack
+        """
+        for c in stack:
+            r = c.result
+            if isinstance(r, Exception):
+                self.annotate_exception(r, c.position + 1, c.args)
+                raise r
+
+    def annotate_exception(self, exception, number, command):
+        """
+        Provides extra context to the exception prior to it being handled
+        """
+        cmd = ' '.join(map(safe_str, command))
+        msg = 'Command # %d (%s) of pipeline caused error: %s' % (
+            number, cmd, exception.args[0])
+        exception.args = (msg,) + exception.args[1:]
+
+    def execute(self, raise_on_error=True):
+        """
+        Execute all the commands in the current pipeline
+        """
+        stack = self.command_stack
+        try:
+            return self.send_cluster_commands(stack, raise_on_error)
+        finally:
+            self.reset()
+
+    def reset(self):
+        """
+        Reset back to empty pipeline.
+        """
+        self.command_stack = []
+
+        self.scripts = set()
+
+        # TODO: Implement
+        # make sure to reset the connection state in the event that we were
+        # watching something
+        # if self.watching and self.connection:
+        #     try:
+        #         # call this manually since our unwatch or
+        #         # immediate_execute_command methods can call reset()
+        #         self.connection.send_command('UNWATCH')
+        #         self.connection.read_response()
+        #     except ConnectionError:
+        #         # disconnect will also remove any previous WATCHes
+        #         self.connection.disconnect()
+
+        # clean up the other instance attributes
+        self.watching = False
+        self.explicit_transaction = False
+
+        # TODO: Implement
+        # we can safely return the connection to the pool here since we're
+        # sure we're no longer WATCHing anything
+        # if self.connection:
+        #     self.connection_pool.release(self.connection)
+        #     self.connection = None
+
+    def send_cluster_commands(self, stack,
+                              raise_on_error=True, allow_redirections=True):
+        """
+        Wrapper for CLUSTERDOWN error handling.
+
+        If the cluster reports it is down it is assumed that:
+         - connection_pool was disconnected
+         - connection_pool was reseted
+         - refereh_table_asap set to True
+
+        It will try the number of times specified by
+        the config option "self.cluster_error_retry_attempts"
+        which defaults to 3 unless manually configured.
+
+        If it reaches the number of times, the command will
+        raises ClusterDownException.
+        """
+        if not stack:
+            return []
+
+        for _ in range(0, self.cluster_error_retry_attempts):
+            try:
+                return self._send_cluster_commands(
+                    stack,
+                    raise_on_error=raise_on_error,
+                    allow_redirections=allow_redirections,
+                )
+            except ClusterDownError:
+                # Try again with the new cluster setup. All other errors
+                # should be raised.
+                pass
+
+        # If it fails the configured number of times then raise
+        # exception back to caller of this method
+        raise ClusterDownError(
+            "CLUSTERDOWN error. Unable to rebuild the cluster")
+
+    def _send_cluster_commands(self, stack,
+                               raise_on_error=True,
+                               allow_redirections=True):
+        """
+        Send a bunch of cluster commands to the redis cluster.
+
+        `allow_redirections` If the pipeline should follow
+        `ASK` & `MOVED` responses automatically. If set
+        to false it will raise RedisClusterException.
+        """
+        # the first time sending the commands we send all of
+        # the commands that were queued up.
+        # if we have to run through it again, we only retry
+        # the commands that failed.
+        attempt = sorted(stack, key=lambda x: x.position)
+
+        # build a list of node objects based on node names we need to
+        nodes = {}
+
+        # as we move through each command that still needs to be processed,
+        # we figure out the slot number that command maps to, then from
+        # the slot determine the node.
+        for c in attempt:
+            # refer to our internal node -> slot table that
+            # tells us where a given
+            # command should route to.
+            slot = self.determine_slot(*c.args)
+            node = self.nodes_manager.get_node_from_slot(
+                slot, self.read_from_replicas and c.args[0] in READ_COMMANDS)
+
+            # now that we know the name of the node
+            # ( it's just a string in the form of host:port )
+            # we can build a list of commands for each node.
+            node_name = node.name
+            if node_name not in nodes:
+                redis_node = self.get_redis_connection(node)
+                connection = get_connection(redis_node, c.args)
+                nodes[node_name] = NodeCommands(redis_node.parse_response,
+                                                redis_node.connection_pool,
+                                                connection)
+
+            nodes[node_name].append(c)
+
+        # send the commands in sequence.
+        # we  write to all the open sockets for each node first,
+        # before reading anything
+        # this allows us to flush all the requests out across the
+        # network essentially in parallel
+        # so that we can read them all in parallel as they come back.
+        # we dont' multiplex on the sockets as they come available,
+        # but that shouldn't make too much difference.
+        node_commands = nodes.values()
+        for n in node_commands:
+            n.write()
+
+        for n in node_commands:
+            n.read()
+
+        # release all of the redis connections we allocated earlier
+        # back into the connection pool.
+        # we used to do this step as part of a try/finally block,
+        # but it is really dangerous to
+        # release connections back into the pool if for some
+        # reason the socket has data still left in it
+        # from a previous operation. The write and
+        # read operations already have try/catch around them for
+        # all known types of errors including connection
+        # and socket level errors.
+        # So if we hit an exception, something really bad
+        # happened and putting any oF
+        # these connections back into the pool is a very bad idea.
+        # the socket might have unread buffer still sitting in it,
+        # and then the next time we read from it we pass the
+        # buffered result back from a previous command and
+        # every single request after to that connection will always get
+        # a mismatched result.
+        for n in nodes.values():
+            n.connection_pool.release(n.connection)
+
+        # if the response isn't an exception it is a
+        # valid response from the node
+        # we're all done with that command, YAY!
+        # if we have more commands to attempt, we've run into problems.
+        # collect all the commands we are allowed to retry.
+        # (MOVED, ASK, or connection errors or timeout errors)
+        attempt = sorted([c for c in attempt
+                          if isinstance(c.result, ERRORS_ALLOW_RETRY)],
+                         key=lambda x: x.position)
+        if attempt and allow_redirections:
+            # RETRY MAGIC HAPPENS HERE!
+            # send these remaing comamnds one at a time using `execute_command`
+            # in the main client. This keeps our retry logic
+            # in one place mostly,
+            # and allows us to be more confident in correctness of behavior.
+            # at this point any speed gains from pipelining have been lost
+            # anyway, so we might as well make the best
+            # attempt to get the correct behavior.
+            #
+            # The client command will handle retries for each
+            # individual command sequentially as we pass each
+            # one into `execute_command`. Any exceptions
+            # that bubble out should only appear once all
+            # retries have been exhausted.
+            #
+            # If a lot of commands have failed, we'll be setting the
+            # flag to rebuild the slots table from scratch.
+            # So MOVED errors should correct themselves fairly quickly.
+            msg = 'An exception occurred during pipeline execution. ' \
+                  'args: {0}, error: {1} {2}'.\
+                format(attempt[-1].args,
+                       type(attempt[-1].result).__name__,
+                       str(attempt[-1].result))
+            log.exception(msg)
+            self.reinitialize_counter += 1
+            if self._should_reinitialized():
+                self.nodes_manager.initialize()
+            for c in attempt:
+                try:
+                    # send each command individually like we
+                    # do in the main client.
+                    c.result = super(ClusterPipeline, self). \
+                        execute_command(*c.args, **c.options)
+                except RedisError as e:
+                    c.result = e
+
+        # turn the response back into a simple flat array that corresponds
+        # to the sequence of commands issued in the stack in pipeline.execute()
+        response = [c.result for c in sorted(stack, key=lambda x: x.position)]
+
+        if raise_on_error:
+            self.raise_first_error(stack)
+
+        return response
+
+    def _fail_on_redirect(self, allow_redirections):
+        """
+        """
+        if not allow_redirections:
+            raise RedisClusterException(
+                "ASK & MOVED redirection not allowed in this pipeline")
+
+    def eval(self):
+        """
+        """
+        raise RedisClusterException("method eval() is not implemented")
+
+    def multi(self):
+        """
+        """
+        raise RedisClusterException("method multi() is not implemented")
+
+    def immediate_execute_command(self, *args, **options):
+        """
+        """
+        raise RedisClusterException(
+            "method immediate_execute_command() is not implemented")
+
+    def _execute_transaction(self, *args, **kwargs):
+        """
+        """
+        raise RedisClusterException(
+            "method _execute_transaction() is not implemented")
+
+    def load_scripts(self):
+        """
+        """
+        raise RedisClusterException(
+            "method load_scripts() is not implemented")
+
+    def watch(self, *names):
+        """
+        """
+        raise RedisClusterException("method watch() is not implemented")
+
+    def unwatch(self):
+        """
+        """
+        raise RedisClusterException("method unwatch() is not implemented")
+
+    def script_load_for_pipeline(self, *args, **kwargs):
+        """
+        """
+        raise RedisClusterException(
+            "method script_load_for_pipeline() is not implemented")
+
+    def delete(self, *names):
+        """
+        "Delete a key specified by ``names``"
+        """
+        if len(names) != 1:
+            raise RedisClusterException(
+                "deleting multiple keys is not "
+                "implemented in pipeline command")
+
+        return self.execute_command('DEL', names[0])
+
+
+def block_pipeline_command(func):
+    """
+    Prints error because some pipelined commands should
+    be blocked when running in cluster-mode
+    """
+
+    def inner(*args, **kwargs):
+        raise RedisClusterException(
+            "ERROR: Calling pipelined function {0} is blocked when "
+            "running redis in cluster mode...".format(func.__name__))
+
+    return inner
+
+
+# Blocked pipeline commands
+ClusterPipeline.bitop = block_pipeline_command(RedisCluster.bitop)
+ClusterPipeline.brpoplpush = block_pipeline_command(RedisCluster.brpoplpush)
+ClusterPipeline.client_getname = \
+    block_pipeline_command(RedisCluster.client_getname)
+ClusterPipeline.client_list = block_pipeline_command(RedisCluster.client_list)
+ClusterPipeline.client_setname = \
+    block_pipeline_command(RedisCluster.client_setname)
+ClusterPipeline.config_set = block_pipeline_command(RedisCluster.config_set)
+ClusterPipeline.dbsize = block_pipeline_command(RedisCluster.dbsize)
+ClusterPipeline.flushall = block_pipeline_command(RedisCluster.flushall)
+ClusterPipeline.flushdb = block_pipeline_command(RedisCluster.flushdb)
+ClusterPipeline.keys = block_pipeline_command(RedisCluster.keys)
+ClusterPipeline.mget = block_pipeline_command(RedisCluster.mget)
+ClusterPipeline.move = block_pipeline_command(RedisCluster.move)
+ClusterPipeline.mset = block_pipeline_command(RedisCluster.mset)
+ClusterPipeline.msetnx = block_pipeline_command(RedisCluster.msetnx)
+ClusterPipeline.pfmerge = block_pipeline_command(RedisCluster.pfmerge)
+ClusterPipeline.pfcount = block_pipeline_command(RedisCluster.pfcount)
+ClusterPipeline.ping = block_pipeline_command(RedisCluster.ping)
+ClusterPipeline.publish = block_pipeline_command(RedisCluster.publish)
+ClusterPipeline.randomkey = block_pipeline_command(RedisCluster.randomkey)
+ClusterPipeline.rename = block_pipeline_command(RedisCluster.rename)
+ClusterPipeline.renamenx = block_pipeline_command(RedisCluster.renamenx)
+ClusterPipeline.rpoplpush = block_pipeline_command(RedisCluster.rpoplpush)
+ClusterPipeline.scan = block_pipeline_command(RedisCluster.scan)
+ClusterPipeline.sdiff = block_pipeline_command(RedisCluster.sdiff)
+ClusterPipeline.sdiffstore = block_pipeline_command(RedisCluster.sdiffstore)
+ClusterPipeline.sinter = block_pipeline_command(RedisCluster.sinter)
+ClusterPipeline.sinterstore = block_pipeline_command(RedisCluster.sinterstore)
+ClusterPipeline.smove = block_pipeline_command(RedisCluster.smove)
+ClusterPipeline.sort = block_pipeline_command(RedisCluster.sort)
+ClusterPipeline.sunion = block_pipeline_command(RedisCluster.sunion)
+ClusterPipeline.sunionstore = block_pipeline_command(RedisCluster.sunionstore)
+ClusterPipeline.readwrite = block_pipeline_command(RedisCluster.readwrite)
+ClusterPipeline.readonly = block_pipeline_command(RedisCluster.readonly)
+
+
+class PipelineCommand(object):
+    """
+    """
+
+    def __init__(self, args, options=None, position=None):
+        self.args = args
+        if options is None:
+            options = {}
+        self.options = options
+        self.position = position
+        self.result = None
+        self.node = None
+        self.asking = False
+
+
+class NodeCommands(object):
+    """
+    """
+
+    def __init__(self, parse_response, connection_pool, connection):
+        """
+        """
+        self.parse_response = parse_response
+        self.connection_pool = connection_pool
+        self.connection = connection
+        self.commands = []
+
+    def append(self, c):
+        """
+        """
+        self.commands.append(c)
+
+    def write(self):
+        """
+        Code borrowed from Redis so it can be fixed
+        """
+        connection = self.connection
+        commands = self.commands
+
+        # We are going to clobber the commands with the write, so go ahead
+        # and ensure that nothing is sitting there from a previous run.
+        for c in commands:
+            c.result = None
+
+        # build up all commands into a single request to increase network perf
+        # send all the commands and catch connection and timeout errors.
+        try:
+            connection.send_packed_command(
+                connection.pack_commands([c.args for c in commands]))
+        except (ConnectionError, TimeoutError) as e:
+            for c in commands:
+                c.result = e
+
+    def read(self):
+        """
+        """
+        connection = self.connection
+        for c in self.commands:
+
+            # if there is a result on this command,
+            # it means we ran into an exception
+            # like a connection error. Trying to parse
+            # a response on a connection that
+            # is no longer open will result in a
+            # connection error raised by redis-py.
+            # but redis-py doesn't check in parse_response
+            # that the sock object is
+            # still set and if you try to
+            # read from a closed connection, it will
+            # result in an AttributeError because
+            # it will do a readline() call on None.
+            # This can have all kinds of nasty side-effects.
+            # Treating this case as a connection error
+            # is fine because it will dump
+            # the connection object back into the
+            # pool and on the next write, it will
+            # explicitly open the connection and all will be well.
+            if c.result is None:
+                try:
+                    c.result = self.parse_response(
+                        connection, c.args[0], **c.options)
+                except (ConnectionError, TimeoutError) as e:
+                    for c in self.commands:
+                        c.result = e
+                    return
+                except RedisError:
+                    c.result = sys.exc_info()[1]
diff --git a/redis/commands/__init__.py b/redis/commands/__init__.py
index f1ddaaabc1..a4728d0ac4 100644
--- a/redis/commands/__init__.py
+++ b/redis/commands/__init__.py
@@ -1,11 +1,15 @@
+from .cluster import ClusterCommands
 from .core import CoreCommands
-from .redismodules import RedisModuleCommands
 from .helpers import list_or_args
+from .parser import CommandsParser
+from .redismodules import RedisModuleCommands
 from .sentinel import SentinelCommands
 
 __all__ = [
+    'ClusterCommands',
+    'CommandsParser',
     'CoreCommands',
+    'list_or_args',
     'RedisModuleCommands',
-    'SentinelCommands',
-    'list_or_args'
+    'SentinelCommands'
 ]
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
new file mode 100644
index 0000000000..6c7740d5e9
--- /dev/null
+++ b/redis/commands/cluster.py
@@ -0,0 +1,926 @@
+from redis.exceptions import (
+    ConnectionError,
+    DataError,
+    RedisError,
+)
+from redis.crc import key_slot
+from .core import DataAccessCommands
+from .helpers import list_or_args
+
+
+class ClusterMultiKeyCommands:
+    """
+    A class containing commands that handle more than one key
+    """
+
+    def _partition_keys_by_slot(self, keys):
+        """
+        Split keys into a dictionary that maps a slot to
+        a list of keys.
+        """
+        slots_to_keys = {}
+        for key in keys:
+            k = self.encoder.encode(key)
+            slot = key_slot(k)
+            slots_to_keys.setdefault(slot, []).append(key)
+
+        return slots_to_keys
+
+    def mget_nonatomic(self, keys, *args):
+        """
+        Splits the keys into different slots and then calls MGET
+        for the keys of every slot. This operation will not be atomic
+        if keys belong to more than one slot.
+
+        Returns a list of values ordered identically to ``keys``
+        """
+
+        from redis.client import EMPTY_RESPONSE
+        options = {}
+        if not args:
+            options[EMPTY_RESPONSE] = []
+
+        # Concatenate all keys into a list
+        keys = list_or_args(keys, args)
+        # Split keys into slots
+        slots_to_keys = self._partition_keys_by_slot(keys)
+
+        # Call MGET for every slot and concatenate
+        # the results
+        # We must make sure that the keys are returned in order
+        all_results = {}
+        for slot_keys in slots_to_keys.values():
+            slot_values = self.execute_command(
+                'MGET', *slot_keys, **options)
+
+            slot_results = dict(zip(slot_keys, slot_values))
+            all_results.update(slot_results)
+
+        # Sort the results
+        vals_in_order = [all_results[key] for key in keys]
+        return vals_in_order
+
+    def mset_nonatomic(self, mapping):
+        """
+        Sets key/values based on a mapping. Mapping is a dictionary of
+        key/value pairs. Both keys and values should be strings or types that
+        can be cast to a string via str().
+
+        Splits the keys into different slots and then calls MSET
+        for the keys of every slot. This operation will not be atomic
+        if keys belong to more than one slot.
+        """
+
+        # Partition the keys by slot
+        slots_to_pairs = {}
+        for pair in mapping.items():
+            # encode the key
+            k = self.encoder.encode(pair[0])
+            slot = key_slot(k)
+            slots_to_pairs.setdefault(slot, []).extend(pair)
+
+        # Call MSET for every slot and concatenate
+        # the results (one result per slot)
+        res = []
+        for pairs in slots_to_pairs.values():
+            res.append(self.execute_command('MSET', *pairs))
+
+        return res
+
+    def _split_command_across_slots(self, command, *keys):
+        """
+        Runs the given command once for the keys
+        of each slot. Returns the sum of the return values.
+        """
+        # Partition the keys by slot
+        slots_to_keys = self._partition_keys_by_slot(keys)
+
+        # Sum up the reply from each command
+        total = 0
+        for slot_keys in slots_to_keys.values():
+            total += self.execute_command(command, *slot_keys)
+
+        return total
+
+    def exists(self, *keys):
+        """
+        Returns the number of ``names`` that exist in the
+        whole cluster. The keys are first split up into slots
+        and then an EXISTS command is sent for every slot
+        """
+        return self._split_command_across_slots('EXISTS', *keys)
+
+    def delete(self, *keys):
+        """
+        Deletes the given keys in the cluster.
+        The keys are first split up into slots
+        and then an DEL command is sent for every slot
+
+        Non-existant keys are ignored.
+        Returns the number of keys that were deleted.
+        """
+        return self._split_command_across_slots('DEL', *keys)
+
+    def touch(self, *keys):
+        """
+        Updates the last access time of given keys across the
+        cluster.
+
+        The keys are first split up into slots
+        and then an TOUCH command is sent for every slot
+
+        Non-existant keys are ignored.
+        Returns the number of keys that were touched.
+        """
+        return self._split_command_across_slots('TOUCH', *keys)
+
+    def unlink(self, *keys):
+        """
+        Remove the specified keys in a different thread.
+
+        The keys are first split up into slots
+        and then an TOUCH command is sent for every slot
+
+        Non-existant keys are ignored.
+        Returns the number of keys that were unlinked.
+        """
+        return self._split_command_across_slots('UNLINK', *keys)
+
+
+class ClusterManagementCommands:
+    """
+    Redis Cluster management commands
+
+    Commands with the 'target_nodes' argument can be executed on specified
+    nodes. By default, if target_nodes is not specified, the command will be
+    executed on the default cluster node.
+
+    :param :target_nodes: type can be one of the followings:
+        - nodes flag: 'all', 'primaries', 'replicas', 'random'
+        - 'ClusterNode'
+        - 'list(ClusterNodes)'
+        - 'dict(any:clusterNodes)'
+
+    for example:
+        primary = r.get_primaries()[0]
+        r.bgsave(target_nodes=primary)
+        r.bgsave(target_nodes='primaries')
+    """
+    def bgsave(self, schedule=True, target_nodes=None):
+        """
+        Tell the Redis server to save its data to disk.  Unlike save(),
+        this method is asynchronous and returns immediately.
+        """
+        pieces = []
+        if schedule:
+            pieces.append("SCHEDULE")
+        return self.execute_command('BGSAVE',
+                                    *pieces,
+                                    target_nodes=target_nodes)
+
+    def client_getname(self, target_nodes=None):
+        """
+        Returns the current connection name from all nodes.
+        The result will be a dictionary with the IP and
+        connection name.
+        """
+        return self.execute_command('CLIENT GETNAME',
+                                    target_nodes=target_nodes)
+
+    def client_getredir(self, target_nodes=None):
+        """Returns the ID (an integer) of the client to whom we are
+        redirecting tracking notifications.
+
+        see: https://redis.io/commands/client-getredir
+        """
+        return self.execute_command('CLIENT GETREDIR',
+                                    target_nodes=target_nodes)
+
+    def client_id(self, target_nodes=None):
+        """Returns the current connection id"""
+        return self.execute_command('CLIENT ID',
+                                    target_nodes=target_nodes)
+
+    def client_info(self, target_nodes=None):
+        """
+        Returns information and statistics about the current
+        client connection.
+        """
+        return self.execute_command('CLIENT INFO',
+                                    target_nodes=target_nodes)
+
+    def client_kill_filter(self, _id=None, _type=None, addr=None,
+                           skipme=None, laddr=None, user=None,
+                           target_nodes=None):
+        """
+        Disconnects client(s) using a variety of filter options
+        :param id: Kills a client by its unique ID field
+        :param type: Kills a client by type where type is one of 'normal',
+        'master', 'slave' or 'pubsub'
+        :param addr: Kills a client by its 'address:port'
+        :param skipme: If True, then the client calling the command
+        will not get killed even if it is identified by one of the filter
+        options. If skipme is not provided, the server defaults to skipme=True
+        :param laddr: Kills a client by its 'local (bind) address:port'
+        :param user: Kills a client for a specific user name
+        """
+        args = []
+        if _type is not None:
+            client_types = ('normal', 'master', 'slave', 'pubsub')
+            if str(_type).lower() not in client_types:
+                raise DataError("CLIENT KILL type must be one of %r" % (
+                    client_types,))
+            args.extend((b'TYPE', _type))
+        if skipme is not None:
+            if not isinstance(skipme, bool):
+                raise DataError("CLIENT KILL skipme must be a bool")
+            if skipme:
+                args.extend((b'SKIPME', b'YES'))
+            else:
+                args.extend((b'SKIPME', b'NO'))
+        if _id is not None:
+            args.extend((b'ID', _id))
+        if addr is not None:
+            args.extend((b'ADDR', addr))
+        if laddr is not None:
+            args.extend((b'LADDR', laddr))
+        if user is not None:
+            args.extend((b'USER', user))
+        if not args:
+            raise DataError("CLIENT KILL <filter> <value> ... ... <filter> "
+                            "<value> must specify at least one filter")
+        return self.execute_command('CLIENT KILL', *args,
+                                    target_nodes=target_nodes)
+
+    def client_kill(self, address, target_nodes=None):
+        "Disconnects the client at ``address`` (ip:port)"
+        return self.execute_command('CLIENT KILL', address,
+                                    target_nodes=target_nodes)
+
+    def client_list(self, _type=None, target_nodes=None):
+        """
+        Returns a list of currently connected clients to the entire cluster.
+        If type of client specified, only that type will be returned.
+        :param _type: optional. one of the client types (normal, master,
+         replica, pubsub)
+        """
+        if _type is not None:
+            client_types = ('normal', 'master', 'replica', 'pubsub')
+            if str(_type).lower() not in client_types:
+                raise DataError("CLIENT LIST _type must be one of %r" % (
+                    client_types,))
+            return self.execute_command('CLIENT LIST',
+                                        b'TYPE',
+                                        _type,
+                                        target_noes=target_nodes)
+        return self.execute_command('CLIENT LIST',
+                                    target_nodes=target_nodes)
+
+    def client_pause(self, timeout, target_nodes=None):
+        """
+        Suspend all the Redis clients for the specified amount of time
+        :param timeout: milliseconds to pause clients
+        """
+        if not isinstance(timeout, int):
+            raise DataError("CLIENT PAUSE timeout must be an integer")
+        return self.execute_command('CLIENT PAUSE', str(timeout),
+                                    target_nodes=target_nodes)
+
+    def client_reply(self, reply, target_nodes=None):
+        """Enable and disable redis server replies.
+        ``reply`` Must be ON OFF or SKIP,
+            ON - The default most with server replies to commands
+            OFF - Disable server responses to commands
+            SKIP - Skip the response of the immediately following command.
+
+        Note: When setting OFF or SKIP replies, you will need a client object
+        with a timeout specified in seconds, and will need to catch the
+        TimeoutError.
+              The test_client_reply unit test illustrates this, and
+              conftest.py has a client with a timeout.
+        See https://redis.io/commands/client-reply
+        """
+        replies = ['ON', 'OFF', 'SKIP']
+        if reply not in replies:
+            raise DataError('CLIENT REPLY must be one of %r' % replies)
+        return self.execute_command("CLIENT REPLY", reply,
+                                    target_nodes=target_nodes)
+
+    def client_setname(self, name, target_nodes=None):
+        "Sets the current connection name"
+        return self.execute_command('CLIENT SETNAME', name,
+                                    target_nodes=target_nodes)
+
+    def client_trackinginfo(self, target_nodes=None):
+        """
+        Returns the information about the current client connection's
+        use of the server assisted client side cache.
+        See https://redis.io/commands/client-trackinginfo
+        """
+        return self.execute_command('CLIENT TRACKINGINFO',
+                                    target_nodes=target_nodes)
+
+    def client_unblock(self, client_id, error=False, target_nodes=None):
+        """
+        Unblocks a connection by its client id.
+        If ``error`` is True, unblocks the client with a special error message.
+        If ``error`` is False (default), the client is unblocked using the
+        regular timeout mechanism.
+        """
+        args = ['CLIENT UNBLOCK', int(client_id)]
+        if error:
+            args.append(b'ERROR')
+        return self.execute_command(*args, target_nodes=target_nodes)
+
+    def client_unpause(self, target_nodes=None):
+        """
+        Unpause all redis clients
+        """
+        return self.execute_command('CLIENT UNPAUSE',
+                                    target_nodes=target_nodes)
+
+    def command(self, target_nodes=None):
+        """
+        Returns dict reply of details about all Redis commands.
+        """
+        return self.execute_command('COMMAND', target_nodes=target_nodes)
+
+    def command_count(self, target_nodes=None):
+        """
+        Returns Integer reply of number of total commands in this Redis server.
+        """
+        return self.execute_command('COMMAND COUNT', target_nodes=target_nodes)
+
+    def config_get(self, pattern="*", target_nodes=None):
+        """
+        Return a dictionary of configuration based on the ``pattern``
+        """
+        return self.execute_command('CONFIG GET',
+                                    pattern,
+                                    target_nodes=target_nodes)
+
+    def config_resetstat(self, target_nodes=None):
+        """Reset runtime statistics"""
+        return self.execute_command('CONFIG RESETSTAT',
+                                    target_nodes=target_nodes)
+
+    def config_rewrite(self, target_nodes=None):
+        """
+        Rewrite config file with the minimal change to reflect running config.
+        """
+        return self.execute_command('CONFIG REWRITE',
+                                    target_nodes=target_nodes)
+
+    def config_set(self, name, value, target_nodes=None):
+        "Set config item ``name`` with ``value``"
+        return self.execute_command('CONFIG SET',
+                                    name,
+                                    value,
+                                    target_nodes=target_nodes)
+
+    def dbsize(self, target_nodes=None):
+        """
+        Sums the number of keys in the target nodes' DB.
+
+        :target_nodes: 'ClusterNode' or 'list(ClusterNodes)'
+            The node/s to execute the command on
+        """
+        return self.execute_command('DBSIZE',
+                                    target_nodes=target_nodes)
+
+    def debug_object(self, key):
+        raise NotImplementedError(
+            "DEBUG OBJECT is intentionally not implemented in the client."
+        )
+
+    def debug_segfault(self):
+        raise NotImplementedError(
+            "DEBUG SEGFAULT is intentionally not implemented in the client."
+        )
+
+    def echo(self, value, target_nodes):
+        """Echo the string back from the server"""
+        return self.execute_command('ECHO', value,
+                                    target_nodes=target_nodes)
+
+    def flushall(self, asynchronous=False, target_nodes=None):
+        """
+        Delete all keys in the database.
+        In cluster mode this method is the same as flushdb
+
+        ``asynchronous`` indicates whether the operation is
+        executed asynchronously by the server.
+        """
+        args = []
+        if asynchronous:
+            args.append(b'ASYNC')
+        return self.execute_command('FLUSHALL',
+                                    *args,
+                                    target_nodes=target_nodes)
+
+    def flushdb(self, asynchronous=False, target_nodes=None):
+        """
+        Delete all keys in the database.
+
+        ``asynchronous`` indicates whether the operation is
+        executed asynchronously by the server.
+        """
+        args = []
+        if asynchronous:
+            args.append(b'ASYNC')
+        return self.execute_command('FLUSHDB',
+                                    *args,
+                                    target_nodes=target_nodes)
+
+    def info(self, section=None, target_nodes=None):
+        """
+        Returns a dictionary containing information about the Redis server
+
+        The ``section`` option can be used to select a specific section
+        of information
+
+        The section option is not supported by older versions of Redis Server,
+        and will generate ResponseError
+        """
+        if section is None:
+            return self.execute_command('INFO',
+                                        target_nodes=target_nodes)
+        else:
+            return self.execute_command('INFO',
+                                        section,
+                                        target_nodes=target_nodes)
+
+    def keys(self, pattern='*', target_nodes=None):
+        "Returns a list of keys matching ``pattern``"
+        return self.execute_command('KEYS', pattern, target_nodes=target_nodes)
+
+    def lastsave(self, target_nodes=None):
+        """
+        Return a Python datetime object representing the last time the
+        Redis database was saved to disk
+        """
+        return self.execute_command('LASTSAVE',
+                                    target_nodes=target_nodes)
+
+    def memory_doctor(self):
+        raise NotImplementedError(
+            "MEMORY DOCTOR is intentionally not implemented in the client."
+        )
+
+    def memory_help(self):
+        raise NotImplementedError(
+            "MEMORY HELP is intentionally not implemented in the client."
+        )
+
+    def memory_malloc_stats(self, target_nodes=None):
+        """Return an internal statistics report from the memory allocator."""
+        return self.execute_command('MEMORY MALLOC-STATS',
+                                    target_nodes=target_nodes)
+
+    def memory_purge(self, target_nodes=None):
+        """Attempts to purge dirty pages for reclamation by allocator"""
+        return self.execute_command('MEMORY PURGE',
+                                    target_nodes=target_nodes)
+
+    def memory_stats(self, target_nodes=None):
+        """Return a dictionary of memory stats"""
+        return self.execute_command('MEMORY STATS',
+                                    target_nodes=target_nodes)
+
+    def memory_usage(self, key, samples=None):
+        """
+        Return the total memory usage for key, its value and associated
+        administrative overheads.
+
+        For nested data structures, ``samples`` is the number of elements to
+        sample. If left unspecified, the server's default is 5. Use 0 to sample
+        all elements.
+        """
+        args = []
+        if isinstance(samples, int):
+            args.extend([b'SAMPLES', samples])
+        return self.execute_command('MEMORY USAGE', key, *args)
+
+    def object(self, infotype, key):
+        """Return the encoding, idletime, or refcount about the key"""
+        return self.execute_command('OBJECT', infotype, key, infotype=infotype)
+
+    def ping(self, target_nodes=None):
+        """
+        Ping the cluster's servers.
+        If no target nodes are specified, sent to all nodes and returns True if
+         the ping was successful across all nodes.
+        """
+        return self.execute_command('PING',
+                                    target_nodes=target_nodes)
+
+    def randomkey(self, target_nodes=None):
+        """
+        Returns the name of a random key"
+        """
+        return self.execute_command('RANDOMKEY', target_nodes=target_nodes)
+
+    def save(self, target_nodes=None):
+        """
+        Tell the Redis server to save its data to disk,
+        blocking until the save is complete
+        """
+        return self.execute_command('SAVE', target_nodes=target_nodes)
+
+    def scan(self, cursor=0, match=None, count=None, _type=None,
+             target_nodes=None):
+        """
+        Incrementally return lists of key names. Also return a cursor
+        indicating the scan position.
+
+        ``match`` allows for filtering the keys by pattern
+
+        ``count`` provides a hint to Redis about the number of keys to
+            return per batch.
+
+        ``_type`` filters the returned values by a particular Redis type.
+            Stock Redis instances allow for the following types:
+            HASH, LIST, SET, STREAM, STRING, ZSET
+            Additionally, Redis modules can expose other types as well.
+        """
+        pieces = [cursor]
+        if match is not None:
+            pieces.extend([b'MATCH', match])
+        if count is not None:
+            pieces.extend([b'COUNT', count])
+        if _type is not None:
+            pieces.extend([b'TYPE', _type])
+        return self.execute_command('SCAN', *pieces, target_nodes=target_nodes)
+
+    def scan_iter(self, match=None, count=None, _type=None, target_nodes=None):
+        """
+        Make an iterator using the SCAN command so that the client doesn't
+        need to remember the cursor position.
+
+        ``match`` allows for filtering the keys by pattern
+
+        ``count`` provides a hint to Redis about the number of keys to
+            return per batch.
+
+        ``_type`` filters the returned values by a particular Redis type.
+            Stock Redis instances allow for the following types:
+            HASH, LIST, SET, STREAM, STRING, ZSET
+            Additionally, Redis modules can expose other types as well.
+        """
+        cursor = '0'
+        while cursor != 0:
+            cursor, data = self.scan(cursor=cursor, match=match,
+                                     count=count, _type=_type,
+                                     target_nodes=target_nodes)
+            yield from data
+
+    def shutdown(self, save=False, nosave=False, target_nodes=None):
+        """Shutdown the Redis server.  If Redis has persistence configured,
+        data will be flushed before shutdown.  If the "save" option is set,
+        a data flush will be attempted even if there is no persistence
+        configured.  If the "nosave" option is set, no data flush will be
+        attempted.  The "save" and "nosave" options cannot both be set.
+        """
+        if save and nosave:
+            raise DataError('SHUTDOWN save and nosave cannot both be set')
+        args = ['SHUTDOWN']
+        if save:
+            args.append('SAVE')
+        if nosave:
+            args.append('NOSAVE')
+        try:
+            self.execute_command(*args, target_nodes=target_nodes)
+        except ConnectionError:
+            # a ConnectionError here is expected
+            return
+        raise RedisError("SHUTDOWN seems to have failed.")
+
+    def slowlog_get(self, num=None, target_nodes=None):
+        """
+        Get the entries from the slowlog. If ``num`` is specified, get the
+        most recent ``num`` items.
+        """
+        args = ['SLOWLOG GET']
+        if num is not None:
+            args.append(num)
+
+        return self.execute_command(*args,
+                                    target_nodes=target_nodes)
+
+    def slowlog_len(self, target_nodes=None):
+        "Get the number of items in the slowlog"
+        return self.execute_command('SLOWLOG LEN',
+                                    target_nodes=target_nodes)
+
+    def slowlog_reset(self, target_nodes=None):
+        "Remove all items in the slowlog"
+        return self.execute_command('SLOWLOG RESET',
+                                    target_nodes=target_nodes)
+
+    def stralgo(self, algo, value1, value2, specific_argument='strings',
+                len=False, idx=False, minmatchlen=None, withmatchlen=False,
+                target_nodes=None):
+        """
+        Implements complex algorithms that operate on strings.
+        Right now the only algorithm implemented is the LCS algorithm
+        (longest common substring). However new algorithms could be
+        implemented in the future.
+
+        ``algo`` Right now must be LCS
+        ``value1`` and ``value2`` Can be two strings or two keys
+        ``specific_argument`` Specifying if the arguments to the algorithm
+        will be keys or strings. strings is the default.
+        ``len`` Returns just the len of the match.
+        ``idx`` Returns the match positions in each string.
+        ``minmatchlen`` Restrict the list of matches to the ones of a given
+        minimal length. Can be provided only when ``idx`` set to True.
+        ``withmatchlen`` Returns the matches with the len of the match.
+        Can be provided only when ``idx`` set to True.
+        """
+        # check validity
+        supported_algo = ['LCS']
+        if algo not in supported_algo:
+            raise DataError("The supported algorithms are: %s"
+                            % (', '.join(supported_algo)))
+        if specific_argument not in ['keys', 'strings']:
+            raise DataError("specific_argument can be only"
+                            " keys or strings")
+        if len and idx:
+            raise DataError("len and idx cannot be provided together.")
+
+        pieces = [algo, specific_argument.upper(), value1, value2]
+        if len:
+            pieces.append(b'LEN')
+        if idx:
+            pieces.append(b'IDX')
+        try:
+            int(minmatchlen)
+            pieces.extend([b'MINMATCHLEN', minmatchlen])
+        except TypeError:
+            pass
+        if withmatchlen:
+            pieces.append(b'WITHMATCHLEN')
+        if specific_argument == 'strings' and target_nodes is None:
+            target_nodes = 'default-node'
+        return self.execute_command('STRALGO', *pieces, len=len, idx=idx,
+                                    minmatchlen=minmatchlen,
+                                    withmatchlen=withmatchlen,
+                                    target_nodes=target_nodes)
+
+    def time(self, target_nodes=None):
+        """
+        Returns the server time as a 2-item tuple of ints:
+        (seconds since epoch, microseconds into this second).
+        """
+        return self.execute_command('TIME', target_nodes=target_nodes)
+
+    def wait(self, num_replicas, timeout, target_nodes=None):
+        """
+        Redis synchronous replication
+        That returns the number of replicas that processed the query when
+        we finally have at least ``num_replicas``, or when the ``timeout`` was
+        reached.
+
+        If more than one target node are passed the result will be summed up
+        """
+        return self.execute_command('WAIT', num_replicas,
+                                    timeout,
+                                    target_nodes=target_nodes)
+
+
+class ClusterPubSubCommands:
+    """
+    Redis PubSub commands for RedisCluster use.
+    see https://redis.io/topics/pubsub
+    """
+    def publish(self, channel, message, target_nodes=None):
+        """
+        Publish ``message`` on ``channel``.
+        Returns the number of subscribers the message was delivered to.
+        """
+        return self.execute_command('PUBLISH', channel, message,
+                                    target_nodes=target_nodes)
+
+    def pubsub_channels(self, pattern='*', target_nodes=None):
+        """
+        Return a list of channels that have at least one subscriber
+        """
+        return self.execute_command('PUBSUB CHANNELS', pattern,
+                                    target_nodes=target_nodes)
+
+    def pubsub_numpat(self, target_nodes=None):
+        """
+        Returns the number of subscriptions to patterns
+        """
+        return self.execute_command('PUBSUB NUMPAT', target_nodes=target_nodes)
+
+    def pubsub_numsub(self, *args, target_nodes=None):
+        """
+        Return a list of (channel, number of subscribers) tuples
+        for each channel given in ``*args``
+        """
+        return self.execute_command('PUBSUB NUMSUB', *args,
+                                    target_nodes=target_nodes)
+
+
+class ClusterCommands(ClusterManagementCommands, ClusterMultiKeyCommands,
+                      ClusterPubSubCommands, DataAccessCommands):
+    """
+    Redis Cluster commands
+
+    Commands with the 'target_nodes' argument can be executed on specified
+    nodes. By default, if target_nodes is not specified, the command will be
+    executed on the default cluster node.
+
+    :param :target_nodes: type can be one of the followings:
+        - nodes flag: 'all', 'primaries', 'replicas', 'random'
+        - 'ClusterNode'
+        - 'list(ClusterNodes)'
+        - 'dict(any:clusterNodes)'
+
+    for example:
+        r.cluster_info(target_nodes='all')
+    """
+    def cluster_addslots(self, target_node, *slots):
+        """
+        Assign new hash slots to receiving node. Sends to specified node.
+
+        :target_node: 'ClusterNode'
+            The node to execute the command on
+        """
+        return self.execute_command('CLUSTER ADDSLOTS', *slots,
+                                    target_nodes=target_node)
+
+    def cluster_countkeysinslot(self, slot_id):
+        """
+        Return the number of local keys in the specified hash slot
+        Send to node based on specified slot_id
+        """
+        return self.execute_command('CLUSTER COUNTKEYSINSLOT', slot_id)
+
+    def cluster_count_failure_report(self, node_id):
+        """
+        Return the number of failure reports active for a given node
+        Sends to a random node
+        """
+        return self.execute_command('CLUSTER COUNT-FAILURE-REPORTS', node_id)
+
+    def cluster_delslots(self, *slots):
+        """
+        Set hash slots as unbound in the cluster.
+        It determines by it self what node the slot is in and sends it there
+
+        Returns a list of the results for each processed slot.
+        """
+        return [
+            self.execute_command('CLUSTER DELSLOTS', slot)
+            for slot in slots
+        ]
+
+    def cluster_failover(self, target_node, option=None):
+        """
+        Forces a slave to perform a manual failover of its master
+        Sends to specified node
+
+        :target_node: 'ClusterNode'
+            The node to execute the command on
+        """
+        if option:
+            if option.upper() not in ['FORCE', 'TAKEOVER']:
+                raise RedisError(
+                    'Invalid option for CLUSTER FAILOVER command: {0}'.format(
+                        option))
+            else:
+                return self.execute_command('CLUSTER FAILOVER', option,
+                                            target_nodes=target_node)
+        else:
+            return self.execute_command('CLUSTER FAILOVER',
+                                        target_nodes=target_node)
+
+    def cluster_info(self, target_nodes=None):
+        """
+        Provides info about Redis Cluster node state.
+        The command will be sent to a random node in the cluster if no target
+        node is specified.
+        """
+        return self.execute_command('CLUSTER INFO', target_nodes=target_nodes)
+
+    def cluster_keyslot(self, key):
+        """
+        Returns the hash slot of the specified key
+        Sends to random node in the cluster
+        """
+        return self.execute_command('CLUSTER KEYSLOT', key)
+
+    def cluster_meet(self, host, port, target_nodes=None):
+        """
+        Force a node cluster to handshake with another node.
+        Sends to specified node.
+        """
+        return self.execute_command('CLUSTER MEET', host, port,
+                                    target_nodes=target_nodes)
+
+    def cluster_nodes(self):
+        """
+        Force a node cluster to handshake with another node
+
+        Sends to random node in the cluster
+        """
+        return self.execute_command('CLUSTER NODES')
+
+    def cluster_replicate(self, target_nodes, node_id):
+        """
+        Reconfigure a node as a slave of the specified master node
+        """
+        return self.execute_command('CLUSTER REPLICATE', node_id,
+                                    target_nodes=target_nodes)
+
+    def cluster_reset(self, soft=True, target_nodes=None):
+        """
+        Reset a Redis Cluster node
+
+        If 'soft' is True then it will send 'SOFT' argument
+        If 'soft' is False then it will send 'HARD' argument
+        """
+        return self.execute_command('CLUSTER RESET',
+                                    b'SOFT' if soft else b'HARD',
+                                    target_nodes=target_nodes)
+
+    def cluster_save_config(self, target_nodes=None):
+        """
+        Forces the node to save cluster state on disk
+        """
+        return self.execute_command('CLUSTER SAVECONFIG',
+                                    target_nodes=target_nodes)
+
+    def cluster_get_keys_in_slot(self, slot, num_keys):
+        """
+        Returns the number of keys in the specified cluster slot
+        """
+        return self.execute_command('CLUSTER GETKEYSINSLOT', slot, num_keys)
+
+    def cluster_set_config_epoch(self, epoch, target_nodes=None):
+        """
+        Set the configuration epoch in a new node
+        """
+        return self.execute_command('CLUSTER SET-CONFIG-EPOCH', epoch,
+                                    target_nodes=target_nodes)
+
+    def cluster_setslot(self, target_node, node_id, slot_id, state):
+        """
+        Bind an hash slot to a specific node
+
+        :target_node: 'ClusterNode'
+            The node to execute the command on
+        """
+        if state.upper() in ('IMPORTING', 'NODE', 'MIGRATING'):
+            return self.execute_command('CLUSTER SETSLOT', slot_id, state,
+                                        node_id, target_nodes=target_node)
+        elif state.upper() == 'STABLE':
+            raise RedisError('For "stable" state please use '
+                             'cluster_setslot_stable')
+        else:
+            raise RedisError('Invalid slot state: {0}'.format(state))
+
+    def cluster_setslot_stable(self, slot_id):
+        """
+        Clears migrating / importing state from the slot.
+        It determines by it self what node the slot is in and sends it there.
+        """
+        return self.execute_command('CLUSTER SETSLOT', slot_id, 'STABLE')
+
+    def cluster_replicas(self, node_id, target_nodes=None):
+        """
+        Provides a list of replica nodes replicating from the specified primary
+        target node.
+        """
+        return self.execute_command('CLUSTER REPLICAS', node_id,
+                                    target_nodes=target_nodes)
+
+    def cluster_slots(self, target_nodes=None):
+        """
+        Get array of Cluster slot to node mappings
+        """
+        return self.execute_command('CLUSTER SLOTS', target_nodes=target_nodes)
+
+    def readonly(self, target_nodes=None):
+        """
+        Enables read queries.
+        The command will be sent to the default cluster node if target_nodes is
+        not specified.
+         """
+        if target_nodes == 'replicas' or target_nodes == 'all':
+            # read_from_replicas will only be enabled if the READONLY command
+            # is sent to all replicas
+            self.read_from_replicas = True
+        return self.execute_command('READONLY', target_nodes=target_nodes)
+
+    def readwrite(self, target_nodes=None):
+        """
+        Disables read queries.
+        The command will be sent to the default cluster node if target_nodes is
+        not specified.
+        """
+        # Reset read from replicas flag
+        self.read_from_replicas = False
+        return self.execute_command('READWRITE', target_nodes=target_nodes)
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 5fad0b65f1..ad45adcfad 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -12,15 +12,11 @@
 )
 
 
-class CoreCommands:
+class ACLCommands:
     """
-    A class containing all of the implemented redis commands. This class is
-    to be used as a mixin.
+    Redis Access Control List (ACL) commands.
+    see: https://redis.io/topics/acl
     """
-
-    # SERVER INFORMATION
-
-    # ACL methods
     def acl_cat(self, category=None):
         """
         Returns a list of categories or commands within a category.
@@ -297,6 +293,11 @@ def acl_whoami(self):
         """
         return self.execute_command('ACL WHOAMI')
 
+
+class ManagementCommands:
+    """
+    Redis management commands
+    """
     def bgrewriteaof(self):
         """Tell the Redis server to rewrite the AOF file from data in memory.
 
@@ -494,6 +495,14 @@ def client_unpause(self):
         """
         return self.execute_command('CLIENT UNPAUSE')
 
+    def command_info(self):
+        raise NotImplementedError(
+            "COMMAND INFO is intentionally not implemented in the client."
+        )
+
+    def command_count(self):
+        return self.execute_command('COMMAND COUNT')
+
     def readwrite(self):
         """
         Disables read queries for a connection to a Redis Cluster slave node.
@@ -541,6 +550,9 @@ def config_rewrite(self):
         """
         return self.execute_command('CONFIG REWRITE')
 
+    def cluster(self, cluster_arg, *args):
+        return self.execute_command('CLUSTER %s' % cluster_arg.upper(), *args)
+
     def dbsize(self):
         """
         Returns the number of keys in the current database
@@ -764,6 +776,17 @@ def quit(self):
         """
         return self.execute_command('QUIT')
 
+    def replicaof(self, *args):
+        """
+        Update the replication settings of a redis replica, on the fly.
+        Examples of valid arguments include:
+            NO ONE (set no replication)
+            host port (set to the host and port of a redis server)
+
+        For more information check  https://redis.io/commands/replicaof
+        """
+        return self.execute_command('REPLICAOF', *args)
+
     def save(self):
         """
         Tell the Redis server to save its data to disk,
@@ -858,7 +881,11 @@ def wait(self, num_replicas, timeout):
         """
         return self.execute_command('WAIT', num_replicas, timeout)
 
-    # BASIC KEY COMMANDS
+
+class BasicKeyCommands:
+    """
+    Redis basic key-based commands
+    """
     def append(self, key, value):
         """
         Appends the string ``value`` to the value at ``key``. If ``key``
@@ -1614,7 +1641,12 @@ def unlink(self, *names):
         """
         return self.execute_command('UNLINK', *names)
 
-    # LIST COMMANDS
+
+class ListCommands:
+    """
+    Redis commands for List data type.
+    see: https://redis.io/topics/data-types#lists
+    """
     def blpop(self, keys, timeout=0):
         """
         LPOP a value off of the first non-empty list
@@ -1915,7 +1947,12 @@ def sort(self, name, start=None, num=None, by=None, get=None,
         options = {'groups': len(get) if groups else None}
         return self.execute_command('SORT', *pieces, **options)
 
-    # SCAN COMMANDS
+
+class ScanCommands:
+    """
+    Redis SCAN commands.
+    see: https://redis.io/commands/scan
+    """
     def scan(self, cursor=0, match=None, count=None, _type=None):
         """
         Incrementally return lists of key names. Also return a cursor
@@ -2070,7 +2107,12 @@ def zscan_iter(self, name, match=None, count=None,
                                       score_cast_func=score_cast_func)
             yield from data
 
-    # SET COMMANDS
+
+class SetCommands:
+    """
+    Redis commands for Set data type.
+    see: https://redis.io/topics/data-types#sets
+    """
     def sadd(self, name, *values):
         """
         Add ``value(s)`` to set ``name``
@@ -2208,7 +2250,12 @@ def sunionstore(self, dest, keys, *args):
         args = list_or_args(keys, args)
         return self.execute_command('SUNIONSTORE', dest, *args)
 
-    # STREAMS COMMANDS
+
+class StreamCommands:
+    """
+    Redis commands for Stream data type.
+    see: https://redis.io/topics/streams-intro
+    """
     def xack(self, name, groupname, *ids):
         """
         Acknowledges the successful processing of one or more messages.
@@ -2685,7 +2732,12 @@ def xtrim(self, name, maxlen=None, approximate=True, minid=None,
 
         return self.execute_command('XTRIM', name, *pieces)
 
-    # SORTED SET COMMANDS
+
+class SortedSetCommands:
+    """
+    Redis commands for Sorted Sets data type.
+    see: https://redis.io/topics/data-types-intro#redis-sorted-sets
+    """
     def zadd(self, name, mapping, nx=False, xx=False, ch=False, incr=False,
              gt=None, lt=None):
         """
@@ -3273,7 +3325,12 @@ def _zaggregate(self, command, dest, keys, aggregate=None,
             pieces.append(b'WITHSCORES')
         return self.execute_command(*pieces, **options)
 
-    # HYPERLOGLOG COMMANDS
+
+class HyperlogCommands:
+    """
+    Redis commands of HyperLogLogs data type.
+    see: https://redis.io/topics/data-types-intro#hyperloglogs
+    """
     def pfadd(self, name, *values):
         """
         Adds the specified elements to the specified HyperLogLog.
@@ -3299,7 +3356,12 @@ def pfmerge(self, dest, *sources):
         """
         return self.execute_command('PFMERGE', dest, *sources)
 
-    # HASH COMMANDS
+
+class HashCommands:
+    """
+    Redis commands for Hash data type.
+    see: https://redis.io/topics/data-types-intro#redis-hashes
+    """
     def hdel(self, name, *keys):
         """
         Delete ``keys`` from hash ``name``
@@ -3439,6 +3501,12 @@ def hstrlen(self, name, key):
         """
         return self.execute_command('HSTRLEN', name, key)
 
+
+class PubSubCommands:
+    """
+    Redis PubSub commands.
+    see https://redis.io/topics/pubsub
+    """
     def publish(self, channel, message):
         """
         Publish ``message`` on ``channel``.
@@ -3473,20 +3541,12 @@ def pubsub_numsub(self, *args):
         """
         return self.execute_command('PUBSUB NUMSUB', *args)
 
-    def cluster(self, cluster_arg, *args):
-        return self.execute_command('CLUSTER %s' % cluster_arg.upper(), *args)
-
-    def replicaof(self, *args):
-        """
-        Update the replication settings of a redis replica, on the fly.
-        Examples of valid arguments include:
-            NO ONE (set no replication)
-            host port (set to the host and port of a redis server)
-
-        For more information check  https://redis.io/commands/replicaof
-        """
-        return self.execute_command('REPLICAOF', *args)
 
+class ScriptCommands:
+    """
+    Redis Lua script commands. see:
+    https://redis.com/ebook/part-3-next-steps/chapter-11-scripting-redis-with-lua/
+    """
     def eval(self, script, numkeys, *keys_and_args):
         """
         Execute the Lua ``script``, specifying the ``numkeys`` the script
@@ -3572,7 +3632,12 @@ def register_script(self, script):
         """
         return Script(self, script)
 
-    # GEO COMMANDS
+
+class GeoCommands:
+    """
+    Redis Geospatial commands.
+    see: https://redis.com/redis-best-practices/indexing-patterns/geospatial/
+    """
     def geoadd(self, name, values, nx=False, xx=False, ch=False):
         """
         Add the specified geospatial items to the specified key identified
@@ -3882,7 +3947,12 @@ def _geosearchgeneric(self, command, *args, **kwargs):
 
         return self.execute_command(command, *pieces, **kwargs)
 
-    # MODULE COMMANDS
+
+class ModuleCommands:
+    """
+    Redis Module commands.
+    see: https://redis.io/topics/modules-intro
+    """
     def module_load(self, path, *args):
         """
         Loads the module from ``path``.
@@ -3924,7 +3994,9 @@ def command(self):
 
 
 class Script:
-    "An executable Lua script object returned by ``register_script``"
+    """
+    An executable Lua script object returned by ``register_script``
+    """
 
     def __init__(self, registered_client, script):
         self.registered_client = registered_client
@@ -4053,3 +4125,22 @@ def execute(self):
         command = self.command
         self.reset()
         return self.client.execute_command(*command)
+
+
+class DataAccessCommands(BasicKeyCommands, ListCommands,
+                         ScanCommands, SetCommands, StreamCommands,
+                         SortedSetCommands,
+                         HyperlogCommands, HashCommands, GeoCommands,
+                         ):
+    """
+    A class containing all of the implemented data access redis commands.
+    This class is to be used as a mixin.
+    """
+
+
+class CoreCommands(ACLCommands, DataAccessCommands, ManagementCommands,
+                   ModuleCommands, PubSubCommands, ScriptCommands):
+    """
+    A class containing all of the implemented redis commands. This class is
+    to be used as a mixin.
+    """
diff --git a/redis/commands/parser.py b/redis/commands/parser.py
new file mode 100644
index 0000000000..d8b03271db
--- /dev/null
+++ b/redis/commands/parser.py
@@ -0,0 +1,118 @@
+from redis.exceptions import (
+    RedisError,
+    ResponseError
+)
+from redis.utils import str_if_bytes
+
+
+class CommandsParser:
+    """
+    Parses Redis commands to get command keys.
+    COMMAND output is used to determine key locations.
+    Commands that do not have a predefined key location are flagged with
+    'movablekeys', and these commands' keys are determined by the command
+    'COMMAND GETKEYS'.
+    """
+    def __init__(self, redis_connection):
+        self.initialized = False
+        self.commands = {}
+        self.initialize(redis_connection)
+
+    def initialize(self, r):
+        self.commands = r.execute_command("COMMAND")
+
+    # As soon as this PR is merged into Redis, we should reimplement
+    # our logic to use COMMAND INFO changes to determine the key positions
+    # https://github.com/redis/redis/pull/8324
+    def get_keys(self, redis_conn, *args):
+        """
+        Get the keys from the passed command
+        """
+        if len(args) < 2:
+            # The command has no keys in it
+            return None
+
+        cmd_name = args[0].lower()
+        if cmd_name not in self.commands:
+            # try to split the command name and to take only the main command,
+            # e.g. 'memory' for 'memory usage'
+            cmd_name_split = cmd_name.split()
+            cmd_name = cmd_name_split[0]
+            if cmd_name in self.commands:
+                # save the splitted command to args
+                args = cmd_name_split + list(args[1:])
+            else:
+                # We'll try to reinitialize the commands cache, if the engine
+                # version has changed, the commands may not be current
+                self.initialize(redis_conn)
+                if cmd_name not in self.commands:
+                    raise RedisError("{0} command doesn't exist in Redis "
+                                     "commands".format(cmd_name.upper()))
+
+        command = self.commands.get(cmd_name)
+        if 'movablekeys' in command['flags']:
+            keys = self._get_moveable_keys(redis_conn, *args)
+        elif 'pubsub' in command['flags']:
+            keys = self._get_pubsub_keys(*args)
+        else:
+            if command['step_count'] == 0 and command['first_key_pos'] == 0 \
+                    and command['last_key_pos'] == 0:
+                # The command doesn't have keys in it
+                return None
+            last_key_pos = command['last_key_pos']
+            if last_key_pos < 0:
+                last_key_pos = len(args) - abs(last_key_pos)
+            keys_pos = list(range(command['first_key_pos'], last_key_pos + 1,
+                                  command['step_count']))
+            keys = [args[pos] for pos in keys_pos]
+
+        return keys
+
+    def _get_moveable_keys(self, redis_conn, *args):
+        pieces = []
+        cmd_name = args[0]
+        # The command name should be splitted into separate arguments,
+        # e.g. 'MEMORY USAGE' will be splitted into ['MEMORY', 'USAGE']
+        pieces = pieces + cmd_name.split()
+        pieces = pieces + list(args[1:])
+        try:
+            keys = redis_conn.execute_command('COMMAND GETKEYS', *pieces)
+        except ResponseError as e:
+            message = e.__str__()
+            if 'Invalid arguments' in message or \
+                    'The command has no key arguments' in message:
+                return None
+            else:
+                raise e
+        return keys
+
+    def _get_pubsub_keys(self, *args):
+        """
+        Get the keys from pubsub command.
+        Although PubSub commands have predetermined key locations, they are not
+        supported in the 'COMMAND's output, so the key positions are hardcoded
+        in this method
+        """
+        if len(args) < 2:
+            # The command has no keys in it
+            return None
+        args = [str_if_bytes(arg) for arg in args]
+        command = args[0].upper()
+        if command == 'PUBSUB':
+            # the second argument is a part of the command name, e.g.
+            # ['PUBSUB', 'NUMSUB', 'foo'].
+            pubsub_type = args[1].upper()
+            if pubsub_type in ['CHANNELS', 'NUMSUB']:
+                keys = args[2:]
+        elif command in ['SUBSCRIBE', 'PSUBSCRIBE', 'UNSUBSCRIBE',
+                         'PUNSUBSCRIBE']:
+            # format example:
+            # SUBSCRIBE channel [channel ...]
+            keys = list(args[1:])
+        elif command == 'PUBLISH':
+            # format example:
+            # PUBLISH channel message
+            keys = [args[1]]
+        else:
+            keys = None
+        return keys
diff --git a/redis/connection.py b/redis/connection.py
index e01742d70e..eac9db358f 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -11,6 +11,7 @@
 import threading
 import weakref
 
+from redis.backoff import NoBackoff
 from redis.exceptions import (
     AuthenticationError,
     AuthenticationWrongNumberOfArgsError,
@@ -28,9 +29,9 @@
     TimeoutError,
     ModuleError,
 )
-from redis.utils import HIREDIS_AVAILABLE, str_if_bytes
-from redis.backoff import NoBackoff
+
 from redis.retry import Retry
+from redis.utils import HIREDIS_AVAILABLE, str_if_bytes
 
 try:
     import ssl
@@ -498,7 +499,7 @@ def __init__(self, host='localhost', port=6379, db=0, password=None,
                  encoding_errors='strict', decode_responses=False,
                  parser_class=DefaultParser, socket_read_size=65536,
                  health_check_interval=0, client_name=None, username=None,
-                 retry=None):
+                 retry=None, redis_connect_func=None):
         """
         Initialize a new Connection.
         To specify a retry policy, first set `retry_on_timeout` to `True`
@@ -528,8 +529,10 @@ def __init__(self, host='localhost', port=6379, db=0, password=None,
         self.health_check_interval = health_check_interval
         self.next_health_check = 0
         self.encoder = Encoder(encoding, encoding_errors, decode_responses)
+        self.redis_connect_func = redis_connect_func
         self._sock = None
-        self._parser = parser_class(socket_read_size=socket_read_size)
+        self._socket_read_size = socket_read_size
+        self.set_parser(parser_class)
         self._connect_callbacks = []
         self._buffer_cutoff = 6000
 
@@ -559,6 +562,14 @@ def register_connect_callback(self, callback):
     def clear_connect_callbacks(self):
         self._connect_callbacks = []
 
+    def set_parser(self, parser_class):
+        """
+        Creates a new instance of parser_class with socket size:
+        _socket_read_size and assigns it to the parser for the connection
+        :param parser_class: The required parser class
+        """
+        self._parser = parser_class(socket_read_size=self._socket_read_size)
+
     def connect(self):
         "Connects to the Redis server if not already connected"
         if self._sock:
@@ -572,7 +583,12 @@ def connect(self):
 
         self._sock = sock
         try:
-            self.on_connect()
+            if self.redis_connect_func is None:
+                # Use the default on_connect function
+                self.on_connect()
+            else:
+                # Use the passed function redis_connect_func
+                self.redis_connect_func(self)
         except RedisError:
             # clean up after any error in on_connect
             self.disconnect()
@@ -903,7 +919,8 @@ def __init__(self, path='', db=0, username=None, password=None,
         self.next_health_check = 0
         self.encoder = Encoder(encoding, encoding_errors, decode_responses)
         self._sock = None
-        self._parser = parser_class(socket_read_size=socket_read_size)
+        self._socket_read_size = socket_read_size
+        self.set_parser(parser_class)
         self._connect_callbacks = []
         self._buffer_cutoff = 6000
 
diff --git a/redis/crc.py b/redis/crc.py
new file mode 100644
index 0000000000..7d2ee507be
--- /dev/null
+++ b/redis/crc.py
@@ -0,0 +1,24 @@
+from binascii import crc_hqx
+
+# Redis Cluster's key space is divided into 16384 slots.
+# For more information see: https://github.com/redis/redis/issues/2576
+REDIS_CLUSTER_HASH_SLOTS = 16384
+
+__all__ = [
+    "key_slot",
+    "REDIS_CLUSTER_HASH_SLOTS"
+]
+
+
+def key_slot(key, bucket=REDIS_CLUSTER_HASH_SLOTS):
+    """Calculate key slot for a given key.
+    See Keys distribution model in https://redis.io/topics/cluster-spec
+    :param key - bytes
+    :param bucket - int
+    """
+    start = key.find(b"{")
+    if start > -1:
+        end = key.find(b"}", start + 1)
+        if end > -1 and end != start + 1:
+            key = key[start + 1: end]
+    return crc_hqx(key, 0) % bucket
diff --git a/redis/exceptions.py b/redis/exceptions.py
index 91eb3c7257..eb6ecc2dc5 100644
--- a/redis/exceptions.py
+++ b/redis/exceptions.py
@@ -84,3 +84,105 @@ class AuthenticationWrongNumberOfArgsError(ResponseError):
     were sent to the AUTH command
     """
     pass
+
+
+class RedisClusterException(Exception):
+    """
+    Base exception for the RedisCluster client
+    """
+    pass
+
+
+class ClusterError(RedisError):
+    """
+    Cluster errors occurred multiple times, resulting in an exhaustion of the
+    command execution TTL
+    """
+    pass
+
+
+class ClusterDownError(ClusterError, ResponseError):
+    """
+    Error indicated CLUSTERDOWN error received from cluster.
+    By default Redis Cluster nodes stop accepting queries if they detect there
+    is at least a hash slot uncovered (no available node is serving it).
+    This way if the cluster is partially down (for example a range of hash
+    slots are no longer covered) the entire cluster eventually becomes
+    unavailable. It automatically returns available as soon as all the slots
+    are covered again.
+    """
+    def __init__(self, resp):
+        self.args = (resp,)
+        self.message = resp
+
+
+class AskError(ResponseError):
+    """
+    Error indicated ASK error received from cluster.
+    When a slot is set as MIGRATING, the node will accept all queries that
+    pertain to this hash slot, but only if the key in question exists,
+    otherwise the query is forwarded using a -ASK redirection to the node that
+    is target of the migration.
+    src node: MIGRATING to dst node
+        get > ASK error
+        ask dst node > ASKING command
+    dst node: IMPORTING from src node
+        asking command only affects next command
+        any op will be allowed after asking command
+    """
+
+    def __init__(self, resp):
+        """should only redirect to master node"""
+        self.args = (resp,)
+        self.message = resp
+        slot_id, new_node = resp.split(' ')
+        host, port = new_node.rsplit(':', 1)
+        self.slot_id = int(slot_id)
+        self.node_addr = self.host, self.port = host, int(port)
+
+
+class TryAgainError(ResponseError):
+    """
+    Error indicated TRYAGAIN error received from cluster.
+    Operations on keys that don't exist or are - during resharding - split
+    between the source and destination nodes, will generate a -TRYAGAIN error.
+    """
+    def __init__(self, *args, **kwargs):
+        pass
+
+
+class ClusterCrossSlotError(ResponseError):
+    """
+    Error indicated CROSSSLOT error received from cluster.
+    A CROSSSLOT error is generated when keys in a request don't hash to the
+    same slot.
+    """
+    message = "Keys in request don't hash to the same slot"
+
+
+class MovedError(AskError):
+    """
+    Error indicated MOVED error received from cluster.
+    A request sent to a node that doesn't serve this key will be replayed with
+    a MOVED error that points to the correct node.
+    """
+    pass
+
+
+class MasterDownError(ClusterDownError):
+    """
+    Error indicated MASTERDOWN error received from cluster.
+    Link with MASTER is down and replica-serve-stale-data is set to 'no'.
+    """
+    pass
+
+
+class SlotNotCoveredError(RedisClusterException):
+    """
+    This error only happens in the case where the connection pool will try to
+    fetch what node that is covered by a given slot.
+
+    If this error is raised the client should drop the current node layout and
+    attempt to reconnect and refresh the node layout again
+    """
+    pass
diff --git a/redis/utils.py b/redis/utils.py
index 26fb002b89..0e78cc5f3b 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -36,3 +36,39 @@ def str_if_bytes(value):
 
 def safe_str(value):
     return str(str_if_bytes(value))
+
+
+def dict_merge(*dicts):
+    """
+    Merge all provided dicts into 1 dict.
+    *dicts : `dict`
+        dictionaries to merge
+    """
+    merged = {}
+
+    for d in dicts:
+        merged.update(d)
+
+    return merged
+
+
+def list_keys_to_dict(key_list, callback):
+    return dict.fromkeys(key_list, callback)
+
+
+def merge_result(command, res):
+    """
+    Merge all items in `res` into a list.
+
+    This command is used when sending a command to multiple nodes
+    and they result from each node should be merged into a single list.
+
+    res : 'dict'
+    """
+    result = set()
+
+    for v in res.values():
+        for value in v:
+            result.add(value)
+
+    return list(result)
diff --git a/tasks.py b/tasks.py
index 306291c97f..138ca69409 100644
--- a/tasks.py
+++ b/tasks.py
@@ -40,7 +40,24 @@ def tests(c):
     """Run the redis-py test suite against the current python,
     with and without hiredis.
     """
-    run("tox -e plain -e hiredis")
+    print("Starting Redis tests")
+    run("tox -e '{redis,cluster}'-'{plain,hiredis}'")
+
+
+@task
+def redis_tests(c):
+    """Run all Redis tests against the current python,
+    with and without hiredis."""
+    print("Starting Redis tests")
+    run("tox -e redis-'{hiredis}'")
+
+
+@task
+def cluster_tests(c):
+    """Run all Redis Cluster tests against the current python,
+    with and without hiredis."""
+    print("Starting RedisCluster tests")
+    run("tox -e cluster-'{plain,hiredis}'")
 
 
 @task
diff --git a/tests/conftest.py b/tests/conftest.py
index 9504333354..f29ebdebb1 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -3,8 +3,10 @@
 import pytest
 import random
 import redis
+import time
 from distutils.version import LooseVersion
 from redis.connection import parse_url
+from redis.exceptions import RedisClusterException
 from unittest.mock import Mock
 from urllib.parse import urlparse
 
@@ -13,6 +15,7 @@
 default_redis_url = "redis://localhost:6379/9"
 
 default_redismod_url = "redis://localhost:36379"
+default_cluster_nodes = 6
 
 
 def pytest_addoption(parser):
@@ -27,11 +30,17 @@ def pytest_addoption(parser):
                           " with loaded modules,"
                           " defaults to `%(default)s`")
 
+    parser.addoption('--redis-cluster-nodes', default=default_cluster_nodes,
+                     action="store",
+                     help="The number of cluster nodes that need to be "
+                          "available before the test can start,"
+                          " defaults to `%(default)s`")
+
 
 def _get_info(redis_url):
     client = redis.Redis.from_url(redis_url)
     info = client.info()
-    cmds = [c[0].upper().decode() for c in client.command()]
+    cmds = [command.upper() for command in client.command().keys()]
     if 'dping' in cmds:
         info["enterprise"] = True
     else:
@@ -45,8 +54,10 @@ def pytest_sessionstart(session):
     info = _get_info(redis_url)
     version = info["redis_version"]
     arch_bits = info["arch_bits"]
+    cluster_enabled = info["cluster_enabled"]
     REDIS_INFO["version"] = version
     REDIS_INFO["arch_bits"] = arch_bits
+    REDIS_INFO["cluster_enabled"] = cluster_enabled
     REDIS_INFO["enterprise"] = info["enterprise"]
 
     # module info, if the second redis is running
@@ -59,6 +70,42 @@ def pytest_sessionstart(session):
     except KeyError:
         pass
 
+    if cluster_enabled:
+        cluster_nodes = session.config.getoption("--redis-cluster-nodes")
+        wait_for_cluster_creation(redis_url, cluster_nodes)
+
+
+def wait_for_cluster_creation(redis_url, cluster_nodes, timeout=20):
+    """
+    Waits for the cluster creation to complete.
+    As soon as all :cluster_nodes: nodes become available, the cluster will be
+    considered ready.
+    :param redis_url: the cluster's url, e.g. redis://localhost:16379/0
+    :param cluster_nodes: The number of nodes in the cluster
+    :param timeout: the amount of time to wait (in seconds)
+    """
+    now = time.time()
+    end_time = now + timeout
+    client = None
+    print("Waiting for {0} cluster nodes to become available".
+          format(cluster_nodes))
+    while now < end_time:
+        try:
+            client = redis.RedisCluster.from_url(redis_url)
+            if len(client.get_nodes()) == cluster_nodes:
+                print("All nodes are available!")
+                break
+        except RedisClusterException:
+            pass
+        time.sleep(1)
+        now = time.time()
+    if now >= end_time:
+        available_nodes = 0 if client is None else len(client.get_nodes())
+        raise RedisClusterException(
+            "The cluster did not become available after {0} seconds. "
+            "Only {1} nodes out of {2} are available".format(
+                timeout, available_nodes, cluster_nodes))
+
 
 def skip_if_server_version_lt(min_version):
     redis_version = REDIS_INFO["version"]
@@ -125,27 +172,47 @@ def _get_client(cls, request, single_connection_client=True, flushdb=True,
         redis_url = request.config.getoption("--redis-url")
     else:
         redis_url = from_url
-    url_options = parse_url(redis_url)
-    url_options.update(kwargs)
-    pool = redis.ConnectionPool(**url_options)
-    client = cls(connection_pool=pool)
+    cluster_mode = REDIS_INFO["cluster_enabled"]
+    if not cluster_mode:
+        url_options = parse_url(redis_url)
+        url_options.update(kwargs)
+        pool = redis.ConnectionPool(**url_options)
+        client = cls(connection_pool=pool)
+    else:
+        client = redis.RedisCluster.from_url(redis_url, **kwargs)
+        single_connection_client = False
     if single_connection_client:
         client = client.client()
     if request:
         def teardown():
-            if flushdb:
-                try:
-                    client.flushdb()
-                except redis.ConnectionError:
-                    # handle cases where a test disconnected a client
-                    # just manually retry the flushdb
-                    client.flushdb()
-            client.close()
-            client.connection_pool.disconnect()
+            if not cluster_mode:
+                if flushdb:
+                    try:
+                        client.flushdb()
+                    except redis.ConnectionError:
+                        # handle cases where a test disconnected a client
+                        # just manually retry the flushdb
+                        client.flushdb()
+                client.close()
+                client.connection_pool.disconnect()
+            else:
+                cluster_teardown(client, flushdb)
         request.addfinalizer(teardown)
     return client
 
 
+def cluster_teardown(client, flushdb):
+    if flushdb:
+        try:
+            client.flushdb(target_nodes='primaries')
+        except redis.ConnectionError:
+            # handle cases where a test disconnected a client
+            # just manually retry the flushdb
+            client.flushdb(target_nodes='primaries')
+    client.close()
+    client.disconnect_connection_pools()
+
+
 # specifically set to the zero database, because creating
 # an index on db != 0 raises a ResponseError in redis
 @pytest.fixture()
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
new file mode 100644
index 0000000000..071cb7d2f1
--- /dev/null
+++ b/tests/test_cluster.py
@@ -0,0 +1,2482 @@
+import binascii
+import datetime
+import pytest
+import warnings
+
+from time import sleep
+from tests.test_pubsub import wait_for_message
+from unittest.mock import call, patch, DEFAULT, Mock
+from redis import Redis
+from redis.cluster import get_node_name, ClusterNode, \
+    RedisCluster, NodesManager, PRIMARY, REDIS_CLUSTER_HASH_SLOTS, REPLICA
+from redis.commands import CommandsParser
+from redis.connection import Connection
+from redis.utils import str_if_bytes
+from redis.exceptions import (
+    AskError,
+    ClusterDownError,
+    DataError,
+    MovedError,
+    RedisClusterException,
+    RedisError
+)
+
+from redis.crc import key_slot
+from .conftest import (
+    _get_client,
+    skip_if_server_version_lt,
+    skip_unless_arch_bits
+)
+
+default_host = "127.0.0.1"
+default_port = 7000
+default_cluster_slots = [
+    [
+        0, 8191,
+        ['127.0.0.1', 7000, 'node_0'],
+        ['127.0.0.1', 7003, 'node_3'],
+    ],
+    [
+        8192, 16383,
+        ['127.0.0.1', 7001, 'node_1'],
+        ['127.0.0.1', 7002, 'node_2']
+    ]
+]
+
+
+@pytest.fixture()
+def slowlog(request, r):
+    """
+    Set the slowlog threshold to 0, and the
+    max length to 128. This will force every
+    command into the slowlog and allow us
+    to test it
+    """
+    # Save old values
+    current_config = r.config_get(
+        target_nodes=r.get_primaries()[0])
+    old_slower_than_value = current_config['slowlog-log-slower-than']
+    old_max_legnth_value = current_config['slowlog-max-len']
+
+    # Function to restore the old values
+    def cleanup():
+        r.config_set('slowlog-log-slower-than', old_slower_than_value)
+        r.config_set('slowlog-max-len', old_max_legnth_value)
+
+    request.addfinalizer(cleanup)
+
+    # Set the new values
+    r.config_set('slowlog-log-slower-than', 0)
+    r.config_set('slowlog-max-len', 128)
+
+
+def get_mocked_redis_client(func=None, *args, **kwargs):
+    """
+    Return a stable RedisCluster object that have deterministic
+    nodes and slots setup to remove the problem of different IP addresses
+    on different installations and machines.
+    """
+    cluster_slots = kwargs.pop('cluster_slots', default_cluster_slots)
+    coverage_res = kwargs.pop('coverage_result', 'yes')
+    with patch.object(Redis, 'execute_command') as execute_command_mock:
+        def execute_command(*_args, **_kwargs):
+            if _args[0] == 'CLUSTER SLOTS':
+                mock_cluster_slots = cluster_slots
+                return mock_cluster_slots
+            elif _args[0] == 'COMMAND':
+                return {'get': [], 'set': []}
+            elif _args[1] == 'cluster-require-full-coverage':
+                return {'cluster-require-full-coverage': coverage_res}
+            elif func is not None:
+                return func(*args, **kwargs)
+            else:
+                return execute_command_mock(*_args, **_kwargs)
+
+        execute_command_mock.side_effect = execute_command
+
+        with patch.object(CommandsParser, 'initialize',
+                          autospec=True) as cmd_parser_initialize:
+
+            def cmd_init_mock(self, r):
+                self.commands = {'get': {'name': 'get', 'arity': 2,
+                                         'flags': ['readonly',
+                                                   'fast'],
+                                         'first_key_pos': 1,
+                                         'last_key_pos': 1,
+                                         'step_count': 1}}
+
+            cmd_parser_initialize.side_effect = cmd_init_mock
+
+            return RedisCluster(*args, **kwargs)
+
+
+def mock_node_resp(node, response):
+    connection = Mock()
+    connection.read_response.return_value = response
+    node.redis_connection.connection = connection
+    return node
+
+
+def mock_node_resp_func(node, func):
+    connection = Mock()
+    connection.read_response.side_effect = func
+    node.redis_connection.connection = connection
+    return node
+
+
+def mock_all_nodes_resp(rc, response):
+    for node in rc.get_nodes():
+        mock_node_resp(node, response)
+    return rc
+
+
+def find_node_ip_based_on_port(cluster_client, port):
+    for node in cluster_client.get_nodes():
+        if node.port == port:
+            return node.host
+
+
+def moved_redirection_helper(request, failover=False):
+    """
+        Test that the client handles MOVED response after a failover.
+        Redirection after a failover means that the redirection address is of a
+        replica that was promoted to a primary.
+
+        At first call it should return a MOVED ResponseError that will point
+        the client to the next server it should talk to.
+
+        Verify that:
+        1. it tries to talk to the redirected node
+        2. it updates the slot's primary to the redirected node
+
+        For a failover, also verify:
+        3. the redirected node's server type updated to 'primary'
+        4. the server type of the previous slot owner updated to 'replica'
+        """
+    rc = _get_client(RedisCluster, request, flushdb=False)
+    slot = 12182
+    redirect_node = None
+    # Get the current primary that holds this slot
+    prev_primary = rc.nodes_manager.get_node_from_slot(slot)
+    if failover:
+        if len(rc.nodes_manager.slots_cache[slot]) < 2:
+            warnings.warn("Skipping this test since it requires to have a "
+                          "replica")
+            return
+        redirect_node = rc.nodes_manager.slots_cache[slot][1]
+    else:
+        # Use one of the primaries to be the redirected node
+        redirect_node = rc.get_primaries()[0]
+    r_host = redirect_node.host
+    r_port = redirect_node.port
+    with patch.object(Redis, 'parse_response') as parse_response:
+        def moved_redirect_effect(connection, *args, **options):
+            def ok_response(connection, *args, **options):
+                assert connection.host == r_host
+                assert connection.port == r_port
+
+                return "MOCK_OK"
+
+            parse_response.side_effect = ok_response
+            raise MovedError("{0} {1}:{2}".format(slot, r_host, r_port))
+
+        parse_response.side_effect = moved_redirect_effect
+        assert rc.execute_command("SET", "foo", "bar") == "MOCK_OK"
+        slot_primary = rc.nodes_manager.slots_cache[slot][0]
+        assert slot_primary == redirect_node
+        if failover:
+            assert rc.get_node(host=r_host, port=r_port).server_type == PRIMARY
+            assert prev_primary.server_type == REPLICA
+
+
+@pytest.mark.onlycluster
+class TestRedisClusterObj:
+    """
+    Tests for the RedisCluster class
+    """
+
+    def test_host_port_startup_node(self):
+        """
+        Test that it is possible to use host & port arguments as startup node
+        args
+        """
+        cluster = get_mocked_redis_client(host=default_host, port=default_port)
+        assert cluster.get_node(host=default_host,
+                                port=default_port) is not None
+
+    def test_startup_nodes(self):
+        """
+        Test that it is possible to use startup_nodes
+        argument to init the cluster
+        """
+        port_1 = 7000
+        port_2 = 7001
+        startup_nodes = [ClusterNode(default_host, port_1),
+                         ClusterNode(default_host, port_2)]
+        cluster = get_mocked_redis_client(startup_nodes=startup_nodes)
+        assert cluster.get_node(host=default_host, port=port_1) is not None \
+               and cluster.get_node(host=default_host, port=port_2) is not None
+
+    def test_empty_startup_nodes(self):
+        """
+        Test that exception is raised when empty providing empty startup_nodes
+        """
+        with pytest.raises(RedisClusterException) as ex:
+            RedisCluster(startup_nodes=[])
+
+        assert str(ex.value).startswith(
+            "RedisCluster requires at least one node to discover the "
+            "cluster"), str_if_bytes(ex.value)
+
+    def test_from_url(self, r):
+        redis_url = "redis://{0}:{1}/0".format(default_host, default_port)
+        with patch.object(RedisCluster, 'from_url') as from_url:
+            def from_url_mocked(_url, **_kwargs):
+                return get_mocked_redis_client(url=_url, **_kwargs)
+
+            from_url.side_effect = from_url_mocked
+            cluster = RedisCluster.from_url(redis_url)
+        assert cluster.get_node(host=default_host,
+                                port=default_port) is not None
+
+    def test_execute_command_errors(self, r):
+        """
+        Test that if no key is provided then exception should be raised.
+        """
+        with pytest.raises(RedisClusterException) as ex:
+            r.execute_command("GET")
+        assert str(ex.value).startswith("No way to dispatch this command to "
+                                        "Redis Cluster. Missing key.")
+
+    def test_execute_command_node_flag_primaries(self, r):
+        """
+        Test command execution with nodes flag PRIMARIES
+        """
+        primaries = r.get_primaries()
+        replicas = r.get_replicas()
+        mock_all_nodes_resp(r, 'PONG')
+        assert r.ping(RedisCluster.PRIMARIES) is True
+        for primary in primaries:
+            conn = primary.redis_connection.connection
+            assert conn.read_response.called is True
+        for replica in replicas:
+            conn = replica.redis_connection.connection
+            assert conn.read_response.called is not True
+
+    def test_execute_command_node_flag_replicas(self, r):
+        """
+        Test command execution with nodes flag REPLICAS
+        """
+        replicas = r.get_replicas()
+        if not replicas:
+            r = get_mocked_redis_client(default_host, default_port)
+        primaries = r.get_primaries()
+        mock_all_nodes_resp(r, 'PONG')
+        assert r.ping(RedisCluster.REPLICAS) is True
+        for replica in replicas:
+            conn = replica.redis_connection.connection
+            assert conn.read_response.called is True
+        for primary in primaries:
+            conn = primary.redis_connection.connection
+            assert conn.read_response.called is not True
+
+    def test_execute_command_node_flag_all_nodes(self, r):
+        """
+        Test command execution with nodes flag ALL_NODES
+        """
+        mock_all_nodes_resp(r, 'PONG')
+        assert r.ping(RedisCluster.ALL_NODES) is True
+        for node in r.get_nodes():
+            conn = node.redis_connection.connection
+            assert conn.read_response.called is True
+
+    def test_execute_command_node_flag_random(self, r):
+        """
+        Test command execution with nodes flag RANDOM
+        """
+        mock_all_nodes_resp(r, 'PONG')
+        assert r.ping(RedisCluster.RANDOM) is True
+        called_count = 0
+        for node in r.get_nodes():
+            conn = node.redis_connection.connection
+            if conn.read_response.called is True:
+                called_count += 1
+        assert called_count == 1
+
+    def test_execute_command_default_node(self, r):
+        """
+        Test command execution without node flag is being executed on the
+        default node
+        """
+        def_node = r.get_default_node()
+        mock_node_resp(def_node, 'PONG')
+        assert r.ping() is True
+        conn = def_node.redis_connection.connection
+        assert conn.read_response.called
+
+    def test_ask_redirection(self, r):
+        """
+        Test that the server handles ASK response.
+
+        At first call it should return a ASK ResponseError that will point
+        the client to the next server it should talk to.
+
+        Important thing to verify is that it tries to talk to the second node.
+        """
+        redirect_node = r.get_nodes()[0]
+        with patch.object(Redis, 'parse_response') as parse_response:
+            def ask_redirect_effect(connection, *args, **options):
+                def ok_response(connection, *args, **options):
+                    assert connection.host == redirect_node.host
+                    assert connection.port == redirect_node.port
+
+                    return "MOCK_OK"
+
+                parse_response.side_effect = ok_response
+                raise AskError("12182 {0}:{1}".format(redirect_node.host,
+                                                      redirect_node.port))
+
+            parse_response.side_effect = ask_redirect_effect
+
+            assert r.execute_command("SET", "foo", "bar") == "MOCK_OK"
+
+    def test_moved_redirection(self, request):
+        """
+        Test that the client handles MOVED response.
+        """
+        moved_redirection_helper(request, failover=False)
+
+    def test_moved_redirection_after_failover(self, request):
+        """
+        Test that the client handles MOVED response after a failover.
+        """
+        moved_redirection_helper(request, failover=True)
+
+    def test_refresh_using_specific_nodes(self, request):
+        """
+        Test making calls on specific nodes when the cluster has failed over to
+        another node
+        """
+        node_7006 = ClusterNode(host=default_host, port=7006,
+                                server_type=PRIMARY)
+        node_7007 = ClusterNode(host=default_host, port=7007,
+                                server_type=PRIMARY)
+        with patch.object(Redis, 'parse_response') as parse_response:
+            with patch.object(NodesManager, 'initialize', autospec=True) as \
+                    initialize:
+                with patch.multiple(Connection,
+                                    send_command=DEFAULT,
+                                    connect=DEFAULT,
+                                    can_read=DEFAULT) as mocks:
+                    # simulate 7006 as a failed node
+                    def parse_response_mock(connection, command_name,
+                                            **options):
+                        if connection.port == 7006:
+                            parse_response.failed_calls += 1
+                            raise ClusterDownError(
+                                'CLUSTERDOWN The cluster is '
+                                'down. Use CLUSTER INFO for '
+                                'more information')
+                        elif connection.port == 7007:
+                            parse_response.successful_calls += 1
+
+                    def initialize_mock(self):
+                        # start with all slots mapped to 7006
+                        self.nodes_cache = {node_7006.name: node_7006}
+                        self.default_node = node_7006
+                        self.slots_cache = {}
+
+                        for i in range(0, 16383):
+                            self.slots_cache[i] = [node_7006]
+
+                        # After the first connection fails, a reinitialize
+                        # should follow the cluster to 7007
+                        def map_7007(self):
+                            self.nodes_cache = {
+                                node_7007.name: node_7007}
+                            self.default_node = node_7007
+                            self.slots_cache = {}
+
+                            for i in range(0, 16383):
+                                self.slots_cache[i] = [node_7007]
+
+                        # Change initialize side effect for the second call
+                        initialize.side_effect = map_7007
+
+                    parse_response.side_effect = parse_response_mock
+                    parse_response.successful_calls = 0
+                    parse_response.failed_calls = 0
+                    initialize.side_effect = initialize_mock
+                    mocks['can_read'].return_value = False
+                    mocks['send_command'].return_value = "MOCK_OK"
+                    mocks['connect'].return_value = None
+                    with patch.object(CommandsParser, 'initialize',
+                                      autospec=True) as cmd_parser_initialize:
+
+                        def cmd_init_mock(self, r):
+                            self.commands = {'get': {'name': 'get', 'arity': 2,
+                                                     'flags': ['readonly',
+                                                               'fast'],
+                                                     'first_key_pos': 1,
+                                                     'last_key_pos': 1,
+                                                     'step_count': 1}}
+
+                        cmd_parser_initialize.side_effect = cmd_init_mock
+
+                        rc = _get_client(
+                            RedisCluster, request, flushdb=False)
+                        assert len(rc.get_nodes()) == 1
+                        assert rc.get_node(node_name=node_7006.name) is not \
+                               None
+
+                        rc.get('foo')
+
+                        # Cluster should now point to 7007, and there should be
+                        # one failed and one successful call
+                        assert len(rc.get_nodes()) == 1
+                        assert rc.get_node(node_name=node_7007.name) is not \
+                               None
+                        assert rc.get_node(node_name=node_7006.name) is None
+                        assert parse_response.failed_calls == 1
+                        assert parse_response.successful_calls == 1
+
+    def test_reading_from_replicas_in_round_robin(self):
+        with patch.multiple(Connection, send_command=DEFAULT,
+                            read_response=DEFAULT, _connect=DEFAULT,
+                            can_read=DEFAULT, on_connect=DEFAULT) as mocks:
+            with patch.object(Redis, 'parse_response') as parse_response:
+                def parse_response_mock_first(connection, *args, **options):
+                    # Primary
+                    assert connection.port == 7001
+                    parse_response.side_effect = parse_response_mock_second
+                    return "MOCK_OK"
+
+                def parse_response_mock_second(connection, *args, **options):
+                    # Replica
+                    assert connection.port == 7002
+                    parse_response.side_effect = parse_response_mock_third
+                    return "MOCK_OK"
+
+                def parse_response_mock_third(connection, *args, **options):
+                    # Primary
+                    assert connection.port == 7001
+                    return "MOCK_OK"
+
+                # We don't need to create a real cluster connection but we
+                # do want RedisCluster.on_connect function to get called,
+                # so we'll mock some of the Connection's functions to allow it
+                parse_response.side_effect = parse_response_mock_first
+                mocks['send_command'].return_value = True
+                mocks['read_response'].return_value = "OK"
+                mocks['_connect'].return_value = True
+                mocks['can_read'].return_value = False
+                mocks['on_connect'].return_value = True
+
+                # Create a cluster with reading from replications
+                read_cluster = get_mocked_redis_client(host=default_host,
+                                                       port=default_port,
+                                                       read_from_replicas=True)
+                assert read_cluster.read_from_replicas is True
+                # Check that we read from the slot's nodes in a round robin
+                # matter.
+                # 'foo' belongs to slot 12182 and the slot's nodes are:
+                # [(127.0.0.1,7001,primary), (127.0.0.1,7002,replica)]
+                read_cluster.get("foo")
+                read_cluster.get("foo")
+                read_cluster.get("foo")
+                mocks['send_command'].assert_has_calls([call('READONLY')])
+
+    def test_keyslot(self, r):
+        """
+        Test that method will compute correct key in all supported cases
+        """
+        assert r.keyslot("foo") == 12182
+        assert r.keyslot("{foo}bar") == 12182
+        assert r.keyslot("{foo}") == 12182
+        assert r.keyslot(1337) == 4314
+
+        assert r.keyslot(125) == r.keyslot(b"125")
+        assert r.keyslot(125) == r.keyslot("\x31\x32\x35")
+        assert r.keyslot("大奖") == r.keyslot(b"\xe5\xa4\xa7\xe5\xa5\x96")
+        assert r.keyslot(u"大奖") == r.keyslot(b"\xe5\xa4\xa7\xe5\xa5\x96")
+        assert r.keyslot(1337.1234) == r.keyslot("1337.1234")
+        assert r.keyslot(1337) == r.keyslot("1337")
+        assert r.keyslot(b"abc") == r.keyslot("abc")
+
+    def test_get_node_name(self):
+        assert get_node_name(default_host, default_port) == \
+               "{0}:{1}".format(default_host, default_port)
+
+    def test_all_nodes(self, r):
+        """
+        Set a list of nodes and it should be possible to iterate over all
+        """
+        nodes = [node for node in r.nodes_manager.nodes_cache.values()]
+
+        for i, node in enumerate(r.get_nodes()):
+            assert node in nodes
+
+    def test_all_nodes_masters(self, r):
+        """
+        Set a list of nodes with random primaries/replicas config and it shold
+        be possible to iterate over all of them.
+        """
+        nodes = [node for node in r.nodes_manager.nodes_cache.values()
+                 if node.server_type == PRIMARY]
+
+        for node in r.get_primaries():
+            assert node in nodes
+
+    def test_cluster_down_overreaches_retry_attempts(self):
+        """
+        When ClusterDownError is thrown, test that we retry executing the
+        command as many times as configured in cluster_error_retry_attempts
+        and then raise the exception
+        """
+        with patch.object(RedisCluster, '_execute_command') as execute_command:
+            def raise_cluster_down_error(target_node, *args, **kwargs):
+                execute_command.failed_calls += 1
+                raise ClusterDownError(
+                    'CLUSTERDOWN The cluster is down. Use CLUSTER INFO for '
+                    'more information')
+
+            execute_command.side_effect = raise_cluster_down_error
+
+            rc = get_mocked_redis_client(host=default_host, port=default_port)
+
+            with pytest.raises(ClusterDownError):
+                rc.get("bar")
+                assert execute_command.failed_calls == \
+                       rc.cluster_error_retry_attempts
+
+    def test_connection_error_overreaches_retry_attempts(self):
+        """
+        When ConnectionError is thrown, test that we retry executing the
+        command as many times as configured in cluster_error_retry_attempts
+        and then raise the exception
+        """
+        with patch.object(RedisCluster, '_execute_command') as execute_command:
+            def raise_conn_error(target_node, *args, **kwargs):
+                execute_command.failed_calls += 1
+                raise ConnectionError()
+
+            execute_command.side_effect = raise_conn_error
+
+            rc = get_mocked_redis_client(host=default_host, port=default_port)
+
+            with pytest.raises(ConnectionError):
+                rc.get("bar")
+                assert execute_command.failed_calls == \
+                       rc.cluster_error_retry_attempts
+
+    def test_user_on_connect_function(self, request):
+        """
+        Test support in passing on_connect function by the user
+        """
+
+        def on_connect(connection):
+            assert connection is not None
+
+        mock = Mock(side_effect=on_connect)
+
+        _get_client(RedisCluster, request, redis_connect_func=mock)
+        assert mock.called is True
+
+    def test_set_default_node_success(self, r):
+        """
+        test successful replacement of the default cluster node
+        """
+        default_node = r.get_default_node()
+        # get a different node
+        new_def_node = None
+        for node in r.get_nodes():
+            if node != default_node:
+                new_def_node = node
+                break
+        assert r.set_default_node(new_def_node) is True
+        assert r.get_default_node() == new_def_node
+
+    def test_set_default_node_failure(self, r):
+        """
+        test failed replacement of the default cluster node
+        """
+        default_node = r.get_default_node()
+        new_def_node = ClusterNode('1.1.1.1', 1111)
+        assert r.set_default_node(None) is False
+        assert r.set_default_node(new_def_node) is False
+        assert r.get_default_node() == default_node
+
+    def test_get_node_from_key(self, r):
+        """
+        Test that get_node_from_key function returns the correct node
+        """
+        key = 'bar'
+        slot = r.keyslot(key)
+        slot_nodes = r.nodes_manager.slots_cache.get(slot)
+        primary = slot_nodes[0]
+        assert r.get_node_from_key(key, replica=False) == primary
+        replica = r.get_node_from_key(key, replica=True)
+        if replica is not None:
+            assert replica.server_type == REPLICA
+            assert replica in slot_nodes
+
+
+@pytest.mark.onlycluster
+class TestClusterRedisCommands:
+    """
+    Tests for RedisCluster unique commands
+    """
+
+    def test_case_insensitive_command_names(self, r):
+        assert r.cluster_response_callbacks['cluster addslots'] == \
+               r.cluster_response_callbacks['CLUSTER ADDSLOTS']
+
+    def test_get_and_set(self, r):
+        # get and set can't be tested independently of each other
+        assert r.get('a') is None
+        byte_string = b'value'
+        integer = 5
+        unicode_string = chr(3456) + 'abcd' + chr(3421)
+        assert r.set('byte_string', byte_string)
+        assert r.set('integer', 5)
+        assert r.set('unicode_string', unicode_string)
+        assert r.get('byte_string') == byte_string
+        assert r.get('integer') == str(integer).encode()
+        assert r.get('unicode_string').decode('utf-8') == unicode_string
+
+    def test_mget_nonatomic(self, r):
+        assert r.mget_nonatomic([]) == []
+        assert r.mget_nonatomic(['a', 'b']) == [None, None]
+        r['a'] = '1'
+        r['b'] = '2'
+        r['c'] = '3'
+
+        assert (r.mget_nonatomic('a', 'other', 'b', 'c') ==
+                [b'1', None, b'2', b'3'])
+
+    def test_mset_nonatomic(self, r):
+        d = {'a': b'1', 'b': b'2', 'c': b'3', 'd': b'4'}
+        assert r.mset_nonatomic(d)
+        for k, v in d.items():
+            assert r[k] == v
+
+    def test_config_set(self, r):
+        assert r.config_set('slowlog-log-slower-than', 0)
+
+    def test_cluster_config_resetstat(self, r):
+        r.ping(target_nodes='all')
+        all_info = r.info(target_nodes='all')
+        prior_commands_processed = -1
+        for node_info in all_info.values():
+            prior_commands_processed = node_info['total_commands_processed']
+            assert prior_commands_processed >= 1
+        r.config_resetstat(target_nodes='all')
+        all_info = r.info(target_nodes='all')
+        for node_info in all_info.values():
+            reset_commands_processed = node_info['total_commands_processed']
+            assert reset_commands_processed < prior_commands_processed
+
+    def test_client_setname(self, r):
+        node = r.get_random_node()
+        r.client_setname('redis_py_test', target_nodes=node)
+        client_name = r.client_getname(target_nodes=node)
+        assert client_name == 'redis_py_test'
+
+    def test_exists(self, r):
+        d = {'a': b'1', 'b': b'2', 'c': b'3', 'd': b'4'}
+        r.mset_nonatomic(d)
+        assert r.exists(*d.keys()) == len(d)
+
+    def test_delete(self, r):
+        d = {'a': b'1', 'b': b'2', 'c': b'3', 'd': b'4'}
+        r.mset_nonatomic(d)
+        assert r.delete(*d.keys()) == len(d)
+        assert r.delete(*d.keys()) == 0
+
+    def test_touch(self, r):
+        d = {'a': b'1', 'b': b'2', 'c': b'3', 'd': b'4'}
+        r.mset_nonatomic(d)
+        assert r.touch(*d.keys()) == len(d)
+
+    def test_unlink(self, r):
+        d = {'a': b'1', 'b': b'2', 'c': b'3', 'd': b'4'}
+        r.mset_nonatomic(d)
+        assert r.unlink(*d.keys()) == len(d)
+        # Unlink is non-blocking so we sleep before
+        # verifying the deletion
+        sleep(0.1)
+        assert r.unlink(*d.keys()) == 0
+
+    def test_pubsub_channels_merge_results(self, r):
+        nodes = r.get_nodes()
+        channels = []
+        pubsub_nodes = []
+        i = 0
+        for node in nodes:
+            channel = "foo{0}".format(i)
+            # We will create different pubsub clients where each one is
+            # connected to a different node
+            p = r.pubsub(node)
+            pubsub_nodes.append(p)
+            p.subscribe(channel)
+            b_channel = channel.encode('utf-8')
+            channels.append(b_channel)
+            # Assert that each node returns only the channel it subscribed to
+            sub_channels = node.redis_connection.pubsub_channels()
+            if not sub_channels:
+                # Try again after a short sleep
+                sleep(0.3)
+                sub_channels = node.redis_connection.pubsub_channels()
+            assert sub_channels == [b_channel]
+            i += 1
+        # Assert that the cluster's pubsub_channels function returns ALL of
+        # the cluster's channels
+        result = r.pubsub_channels(target_nodes='all')
+        result.sort()
+        assert result == channels
+
+    def test_pubsub_numsub_merge_results(self, r):
+        nodes = r.get_nodes()
+        pubsub_nodes = []
+        channel = "foo"
+        b_channel = channel.encode('utf-8')
+        for node in nodes:
+            # We will create different pubsub clients where each one is
+            # connected to a different node
+            p = r.pubsub(node)
+            pubsub_nodes.append(p)
+            p.subscribe(channel)
+            # Assert that each node returns that only one client is subscribed
+            sub_chann_num = node.redis_connection.pubsub_numsub(channel)
+            if sub_chann_num == [(b_channel, 0)]:
+                sleep(0.3)
+                sub_chann_num = node.redis_connection.pubsub_numsub(channel)
+            assert sub_chann_num == [(b_channel, 1)]
+        # Assert that the cluster's pubsub_numsub function returns ALL clients
+        # subscribed to this channel in the entire cluster
+        assert r.pubsub_numsub(channel, target_nodes='all') == \
+               [(b_channel, len(nodes))]
+
+    def test_pubsub_numpat_merge_results(self, r):
+        nodes = r.get_nodes()
+        pubsub_nodes = []
+        pattern = "foo*"
+        for node in nodes:
+            # We will create different pubsub clients where each one is
+            # connected to a different node
+            p = r.pubsub(node)
+            pubsub_nodes.append(p)
+            p.psubscribe(pattern)
+            # Assert that each node returns that only one client is subscribed
+            sub_num_pat = node.redis_connection.pubsub_numpat()
+            if sub_num_pat == 0:
+                sleep(0.3)
+                sub_num_pat = node.redis_connection.pubsub_numpat()
+            assert sub_num_pat == 1
+        # Assert that the cluster's pubsub_numsub function returns ALL clients
+        # subscribed to this channel in the entire cluster
+        assert r.pubsub_numpat(target_nodes='all') == len(nodes)
+
+    @skip_if_server_version_lt('2.8.0')
+    def test_cluster_pubsub_channels(self, r):
+        p = r.pubsub()
+        p.subscribe('foo', 'bar', 'baz', 'quux')
+        for i in range(4):
+            assert wait_for_message(p, timeout=0.5)['type'] == 'subscribe'
+        expected = [b'bar', b'baz', b'foo', b'quux']
+        assert all([channel in r.pubsub_channels(target_nodes='all')
+                    for channel in expected])
+
+    @skip_if_server_version_lt('2.8.0')
+    def test_cluster_pubsub_numsub(self, r):
+        p1 = r.pubsub()
+        p1.subscribe('foo', 'bar', 'baz')
+        for i in range(3):
+            assert wait_for_message(p1, timeout=0.5)['type'] == 'subscribe'
+        p2 = r.pubsub()
+        p2.subscribe('bar', 'baz')
+        for i in range(2):
+            assert wait_for_message(p2, timeout=0.5)['type'] == 'subscribe'
+        p3 = r.pubsub()
+        p3.subscribe('baz')
+        assert wait_for_message(p3, timeout=0.5)['type'] == 'subscribe'
+
+        channels = [(b'foo', 1), (b'bar', 2), (b'baz', 3)]
+        assert r.pubsub_numsub('foo', 'bar', 'baz', target_nodes='all') \
+               == channels
+
+    def test_cluster_slots(self, r):
+        mock_all_nodes_resp(r, default_cluster_slots)
+        cluster_slots = r.cluster_slots()
+        assert isinstance(cluster_slots, dict)
+        assert len(default_cluster_slots) == len(cluster_slots)
+        assert cluster_slots.get((0, 8191)) is not None
+        assert cluster_slots.get((0, 8191)).get('primary') == \
+               ('127.0.0.1', 7000)
+
+    def test_cluster_addslots(self, r):
+        node = r.get_random_node()
+        mock_node_resp(node, 'OK')
+        assert r.cluster_addslots(node, 1, 2, 3) is True
+
+    def test_cluster_countkeysinslot(self, r):
+        node = r.nodes_manager.get_node_from_slot(1)
+        mock_node_resp(node, 2)
+        assert r.cluster_countkeysinslot(1) == 2
+
+    def test_cluster_count_failure_report(self, r):
+        mock_all_nodes_resp(r, 0)
+        assert r.cluster_count_failure_report('node_0') == 0
+
+    def test_cluster_delslots(self):
+        cluster_slots = [
+            [
+                0, 8191,
+                ['127.0.0.1', 7000, 'node_0'],
+            ],
+            [
+                8192, 16383,
+                ['127.0.0.1', 7001, 'node_1'],
+            ]
+        ]
+        r = get_mocked_redis_client(host=default_host, port=default_port,
+                                    cluster_slots=cluster_slots)
+        mock_all_nodes_resp(r, 'OK')
+        node0 = r.get_node(default_host, 7000)
+        node1 = r.get_node(default_host, 7001)
+        assert r.cluster_delslots(0, 8192) == [True, True]
+        assert node0.redis_connection.connection.read_response.called
+        assert node1.redis_connection.connection.read_response.called
+
+    def test_cluster_failover(self, r):
+        node = r.get_random_node()
+        mock_node_resp(node, 'OK')
+        assert r.cluster_failover(node) is True
+        assert r.cluster_failover(node, 'FORCE') is True
+        assert r.cluster_failover(node, 'TAKEOVER') is True
+        with pytest.raises(RedisError):
+            r.cluster_failover(node, 'FORCT')
+
+    def test_cluster_info(self, r):
+        info = r.cluster_info()
+        assert isinstance(info, dict)
+        assert info['cluster_state'] == 'ok'
+
+    def test_cluster_keyslot(self, r):
+        mock_all_nodes_resp(r, 12182)
+        assert r.cluster_keyslot('foo') == 12182
+
+    def test_cluster_meet(self, r):
+        node = r.get_default_node()
+        mock_node_resp(node, 'OK')
+        assert r.cluster_meet('127.0.0.1', 6379) is True
+
+    def test_cluster_nodes(self, r):
+        response = (
+            'c8253bae761cb1ecb2b61857d85dfe455a0fec8b 172.17.0.7:7006 '
+            'slave aa90da731f673a99617dfe930306549a09f83a6b 0 '
+            '1447836263059 5 connected\n'
+            '9bd595fe4821a0e8d6b99d70faa660638a7612b3 172.17.0.7:7008 '
+            'master - 0 1447836264065 0 connected\n'
+            'aa90da731f673a99617dfe930306549a09f83a6b 172.17.0.7:7003 '
+            'myself,master - 0 0 2 connected 5461-10922\n'
+            '1df047e5a594f945d82fc140be97a1452bcbf93e 172.17.0.7:7007 '
+            'slave 19efe5a631f3296fdf21a5441680f893e8cc96ec 0 '
+            '1447836262556 3 connected\n'
+            '4ad9a12e63e8f0207025eeba2354bcf4c85e5b22 172.17.0.7:7005 '
+            'master - 0 1447836262555 7 connected 0-5460\n'
+            '19efe5a631f3296fdf21a5441680f893e8cc96ec 172.17.0.7:7004 '
+            'master - 0 1447836263562 3 connected 10923-16383\n'
+            'fbb23ed8cfa23f17eaf27ff7d0c410492a1093d6 172.17.0.7:7002 '
+            'master,fail - 1447829446956 1447829444948 1 disconnected\n'
+        )
+        mock_all_nodes_resp(r, response)
+        nodes = r.cluster_nodes()
+        assert len(nodes) == 7
+        assert nodes.get('172.17.0.7:7006') is not None
+        assert nodes.get('172.17.0.7:7006').get('node_id') == \
+               "c8253bae761cb1ecb2b61857d85dfe455a0fec8b"
+
+    def test_cluster_replicate(self, r):
+        node = r.get_random_node()
+        all_replicas = r.get_replicas()
+        mock_all_nodes_resp(r, 'OK')
+        assert r.cluster_replicate(node, 'c8253bae761cb61857d') is True
+        results = r.cluster_replicate(all_replicas, 'c8253bae761cb61857d')
+        if isinstance(results, dict):
+            for res in results.values():
+                assert res is True
+        else:
+            assert results is True
+
+    def test_cluster_reset(self, r):
+        mock_all_nodes_resp(r, 'OK')
+        assert r.cluster_reset() is True
+        assert r.cluster_reset(False) is True
+        all_results = r.cluster_reset(False, target_nodes='all')
+        for res in all_results.values():
+            assert res is True
+
+    def test_cluster_save_config(self, r):
+        node = r.get_random_node()
+        all_nodes = r.get_nodes()
+        mock_all_nodes_resp(r, 'OK')
+        assert r.cluster_save_config(node) is True
+        all_results = r.cluster_save_config(all_nodes)
+        for res in all_results.values():
+            assert res is True
+
+    def test_cluster_get_keys_in_slot(self, r):
+        response = [b'{foo}1', b'{foo}2']
+        node = r.nodes_manager.get_node_from_slot(12182)
+        mock_node_resp(node, response)
+        keys = r.cluster_get_keys_in_slot(12182, 4)
+        assert keys == response
+
+    def test_cluster_set_config_epoch(self, r):
+        mock_all_nodes_resp(r, 'OK')
+        assert r.cluster_set_config_epoch(3) is True
+        all_results = r.cluster_set_config_epoch(3, target_nodes='all')
+        for res in all_results.values():
+            assert res is True
+
+    def test_cluster_setslot(self, r):
+        node = r.get_random_node()
+        mock_node_resp(node, 'OK')
+        assert r.cluster_setslot(node, 'node_0', 1218, 'IMPORTING') is True
+        assert r.cluster_setslot(node, 'node_0', 1218, 'NODE') is True
+        assert r.cluster_setslot(node, 'node_0', 1218, 'MIGRATING') is True
+        with pytest.raises(RedisError):
+            r.cluster_failover(node, 'STABLE')
+        with pytest.raises(RedisError):
+            r.cluster_failover(node, 'STATE')
+
+    def test_cluster_setslot_stable(self, r):
+        node = r.nodes_manager.get_node_from_slot(12182)
+        mock_node_resp(node, 'OK')
+        assert r.cluster_setslot_stable(12182) is True
+        assert node.redis_connection.connection.read_response.called
+
+    def test_cluster_replicas(self, r):
+        response = [b'01eca22229cf3c652b6fca0d09ff6941e0d2e3 '
+                    b'127.0.0.1:6377@16377 slave '
+                    b'52611e796814b78e90ad94be9d769a4f668f9a 0 '
+                    b'1634550063436 4 connected',
+                    b'r4xfga22229cf3c652b6fca0d09ff69f3e0d4d '
+                    b'127.0.0.1:6378@16378 slave '
+                    b'52611e796814b78e90ad94be9d769a4f668f9a 0 '
+                    b'1634550063436 4 connected']
+        mock_all_nodes_resp(r, response)
+        replicas = r.cluster_replicas('52611e796814b78e90ad94be9d769a4f668f9a')
+        assert replicas.get('127.0.0.1:6377') is not None
+        assert replicas.get('127.0.0.1:6378') is not None
+        assert replicas.get('127.0.0.1:6378').get('node_id') == \
+               'r4xfga22229cf3c652b6fca0d09ff69f3e0d4d'
+
+    def test_readonly(self):
+        r = get_mocked_redis_client(host=default_host, port=default_port)
+        mock_all_nodes_resp(r, 'OK')
+        assert r.readonly() is True
+        all_replicas_results = r.readonly(target_nodes='replicas')
+        for res in all_replicas_results.values():
+            assert res is True
+        for replica in r.get_replicas():
+            assert replica.redis_connection.connection.read_response.called
+
+    def test_readwrite(self):
+        r = get_mocked_redis_client(host=default_host, port=default_port)
+        mock_all_nodes_resp(r, 'OK')
+        assert r.readwrite() is True
+        all_replicas_results = r.readwrite(target_nodes='replicas')
+        for res in all_replicas_results.values():
+            assert res is True
+        for replica in r.get_replicas():
+            assert replica.redis_connection.connection.read_response.called
+
+    def test_bgsave(self, r):
+        assert r.bgsave()
+        sleep(0.3)
+        assert r.bgsave(True)
+
+    def test_info(self, r):
+        # Map keys to same slot
+        r.set('x{1}', 1)
+        r.set('y{1}', 2)
+        r.set('z{1}', 3)
+        # Get node that handles the slot
+        slot = r.keyslot('x{1}')
+        node = r.nodes_manager.get_node_from_slot(slot)
+        # Run info on that node
+        info = r.info(target_nodes=node)
+        assert isinstance(info, dict)
+        assert info['db0']['keys'] == 3
+
+    def _init_slowlog_test(self, r, node):
+        slowlog_lim = r.config_get('slowlog-log-slower-than',
+                                   target_nodes=node)
+        assert r.config_set('slowlog-log-slower-than', 0, target_nodes=node) \
+               is True
+        return slowlog_lim['slowlog-log-slower-than']
+
+    def _teardown_slowlog_test(self, r, node, prev_limit):
+        assert r.config_set('slowlog-log-slower-than', prev_limit,
+                            target_nodes=node) is True
+
+    def test_slowlog_get(self, r, slowlog):
+        unicode_string = chr(3456) + 'abcd' + chr(3421)
+        node = r.get_node_from_key(unicode_string)
+        slowlog_limit = self._init_slowlog_test(r, node)
+        assert r.slowlog_reset(target_nodes=node)
+        r.get(unicode_string)
+        slowlog = r.slowlog_get(target_nodes=node)
+        assert isinstance(slowlog, list)
+        commands = [log['command'] for log in slowlog]
+
+        get_command = b' '.join((b'GET', unicode_string.encode('utf-8')))
+        assert get_command in commands
+        assert b'SLOWLOG RESET' in commands
+
+        # the order should be ['GET <uni string>', 'SLOWLOG RESET'],
+        # but if other clients are executing commands at the same time, there
+        # could be commands, before, between, or after, so just check that
+        # the two we care about are in the appropriate order.
+        assert commands.index(get_command) < commands.index(b'SLOWLOG RESET')
+
+        # make sure other attributes are typed correctly
+        assert isinstance(slowlog[0]['start_time'], int)
+        assert isinstance(slowlog[0]['duration'], int)
+        # rollback the slowlog limit to its original value
+        self._teardown_slowlog_test(r, node, slowlog_limit)
+
+    def test_slowlog_get_limit(self, r, slowlog):
+        assert r.slowlog_reset()
+        node = r.get_node_from_key('foo')
+        slowlog_limit = self._init_slowlog_test(r, node)
+        r.get('foo')
+        slowlog = r.slowlog_get(1, target_nodes=node)
+        assert isinstance(slowlog, list)
+        # only one command, based on the number we passed to slowlog_get()
+        assert len(slowlog) == 1
+        self._teardown_slowlog_test(r, node, slowlog_limit)
+
+    def test_slowlog_length(self, r, slowlog):
+        r.get('foo')
+        node = r.nodes_manager.get_node_from_slot(key_slot(b'foo'))
+        slowlog_len = r.slowlog_len(target_nodes=node)
+        assert isinstance(slowlog_len, int)
+
+    def test_time(self, r):
+        t = r.time(target_nodes=r.get_primaries()[0])
+        assert len(t) == 2
+        assert isinstance(t[0], int)
+        assert isinstance(t[1], int)
+
+    @skip_if_server_version_lt('4.0.0')
+    def test_memory_usage(self, r):
+        r.set('foo', 'bar')
+        assert isinstance(r.memory_usage('foo'), int)
+
+    @skip_if_server_version_lt('4.0.0')
+    def test_memory_malloc_stats(self, r):
+        assert r.memory_malloc_stats()
+
+    @skip_if_server_version_lt('4.0.0')
+    def test_memory_stats(self, r):
+        # put a key into the current db to make sure that "db.<current-db>"
+        # has data
+        r.set('foo', 'bar')
+        node = r.nodes_manager.get_node_from_slot(key_slot(b'foo'))
+        stats = r.memory_stats(target_nodes=node)
+        assert isinstance(stats, dict)
+        for key, value in stats.items():
+            if key.startswith('db.'):
+                assert isinstance(value, dict)
+
+    @skip_if_server_version_lt('4.0.0')
+    def test_memory_help(self, r):
+        with pytest.raises(NotImplementedError):
+            r.memory_help()
+
+    @skip_if_server_version_lt('4.0.0')
+    def test_memory_doctor(self, r):
+        with pytest.raises(NotImplementedError):
+            r.memory_doctor()
+
+    def test_lastsave(self, r):
+        node = r.get_primaries()[0]
+        assert isinstance(r.lastsave(target_nodes=node),
+                          datetime.datetime)
+
+    def test_cluster_echo(self, r):
+        node = r.get_primaries()[0]
+        assert r.echo('foo bar', node) == b'foo bar'
+
+    @skip_if_server_version_lt('1.0.0')
+    def test_debug_segfault(self, r):
+        with pytest.raises(NotImplementedError):
+            r.debug_segfault()
+
+    def test_config_resetstat(self, r):
+        node = r.get_primaries()[0]
+        r.ping(target_nodes=node)
+        prior_commands_processed = \
+            int(r.info(target_nodes=node)['total_commands_processed'])
+        assert prior_commands_processed >= 1
+        r.config_resetstat(target_nodes=node)
+        reset_commands_processed = \
+            int(r.info(target_nodes=node)['total_commands_processed'])
+        assert reset_commands_processed < prior_commands_processed
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_client_trackinginfo(self, r):
+        node = r.get_primaries()[0]
+        res = r.client_trackinginfo(target_nodes=node)
+        assert len(res) > 2
+        assert 'prefixes' in res
+
+    @skip_if_server_version_lt('2.9.50')
+    def test_client_pause(self, r):
+        node = r.get_primaries()[0]
+        assert r.client_pause(1, target_nodes=node)
+        assert r.client_pause(timeout=1, target_nodes=node)
+        with pytest.raises(RedisError):
+            r.client_pause(timeout='not an integer', target_nodes=node)
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_client_unpause(self, r):
+        assert r.client_unpause()
+
+    @skip_if_server_version_lt('5.0.0')
+    def test_client_id(self, r):
+        node = r.get_primaries()[0]
+        assert r.client_id(target_nodes=node) > 0
+
+    @skip_if_server_version_lt('5.0.0')
+    def test_client_unblock(self, r):
+        node = r.get_primaries()[0]
+        myid = r.client_id(target_nodes=node)
+        assert not r.client_unblock(myid, target_nodes=node)
+        assert not r.client_unblock(myid, error=True, target_nodes=node)
+        assert not r.client_unblock(myid, error=False, target_nodes=node)
+
+    @skip_if_server_version_lt('6.0.0')
+    def test_client_getredir(self, r):
+        node = r.get_primaries()[0]
+        assert isinstance(r.client_getredir(target_nodes=node), int)
+        assert r.client_getredir(target_nodes=node) == -1
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_client_info(self, r):
+        node = r.get_primaries()[0]
+        info = r.client_info(target_nodes=node)
+        assert isinstance(info, dict)
+        assert 'addr' in info
+
+    @skip_if_server_version_lt('2.6.9')
+    def test_client_kill(self, r, r2):
+        node = r.get_primaries()[0]
+        r.client_setname('redis-py-c1', target_nodes='all')
+        r2.client_setname('redis-py-c2', target_nodes='all')
+        clients = [client for client in r.client_list(target_nodes=node)
+                   if client.get('name') in ['redis-py-c1', 'redis-py-c2']]
+        assert len(clients) == 2
+        clients_by_name = dict([(client.get('name'), client)
+                                for client in clients])
+
+        client_addr = clients_by_name['redis-py-c2'].get('addr')
+        assert r.client_kill(client_addr, target_nodes=node) is True
+
+        clients = [client for client in r.client_list(target_nodes=node)
+                   if client.get('name') in ['redis-py-c1', 'redis-py-c2']]
+        assert len(clients) == 1
+        assert clients[0].get('name') == 'redis-py-c1'
+
+    @skip_if_server_version_lt('2.6.0')
+    def test_cluster_bitop_not_empty_string(self, r):
+        r['{foo}a'] = ''
+        r.bitop('not', '{foo}r', '{foo}a')
+        assert r.get('{foo}r') is None
+
+    @skip_if_server_version_lt('2.6.0')
+    def test_cluster_bitop_not(self, r):
+        test_str = b'\xAA\x00\xFF\x55'
+        correct = ~0xAA00FF55 & 0xFFFFFFFF
+        r['{foo}a'] = test_str
+        r.bitop('not', '{foo}r', '{foo}a')
+        assert int(binascii.hexlify(r['{foo}r']), 16) == correct
+
+    @skip_if_server_version_lt('2.6.0')
+    def test_cluster_bitop_not_in_place(self, r):
+        test_str = b'\xAA\x00\xFF\x55'
+        correct = ~0xAA00FF55 & 0xFFFFFFFF
+        r['{foo}a'] = test_str
+        r.bitop('not', '{foo}a', '{foo}a')
+        assert int(binascii.hexlify(r['{foo}a']), 16) == correct
+
+    @skip_if_server_version_lt('2.6.0')
+    def test_cluster_bitop_single_string(self, r):
+        test_str = b'\x01\x02\xFF'
+        r['{foo}a'] = test_str
+        r.bitop('and', '{foo}res1', '{foo}a')
+        r.bitop('or', '{foo}res2', '{foo}a')
+        r.bitop('xor', '{foo}res3', '{foo}a')
+        assert r['{foo}res1'] == test_str
+        assert r['{foo}res2'] == test_str
+        assert r['{foo}res3'] == test_str
+
+    @skip_if_server_version_lt('2.6.0')
+    def test_cluster_bitop_string_operands(self, r):
+        r['{foo}a'] = b'\x01\x02\xFF\xFF'
+        r['{foo}b'] = b'\x01\x02\xFF'
+        r.bitop('and', '{foo}res1', '{foo}a', '{foo}b')
+        r.bitop('or', '{foo}res2', '{foo}a', '{foo}b')
+        r.bitop('xor', '{foo}res3', '{foo}a', '{foo}b')
+        assert int(binascii.hexlify(r['{foo}res1']), 16) == 0x0102FF00
+        assert int(binascii.hexlify(r['{foo}res2']), 16) == 0x0102FFFF
+        assert int(binascii.hexlify(r['{foo}res3']), 16) == 0x000000FF
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_cluster_copy(self, r):
+        assert r.copy("{foo}a", "{foo}b") == 0
+        r.set("{foo}a", "bar")
+        assert r.copy("{foo}a", "{foo}b") == 1
+        assert r.get("{foo}a") == b"bar"
+        assert r.get("{foo}b") == b"bar"
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_cluster_copy_and_replace(self, r):
+        r.set("{foo}a", "foo1")
+        r.set("{foo}b", "foo2")
+        assert r.copy("{foo}a", "{foo}b") == 0
+        assert r.copy("{foo}a", "{foo}b", replace=True) == 1
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_cluster_lmove(self, r):
+        r.rpush('{foo}a', 'one', 'two', 'three', 'four')
+        assert r.lmove('{foo}a', '{foo}b')
+        assert r.lmove('{foo}a', '{foo}b', 'right', 'left')
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_cluster_blmove(self, r):
+        r.rpush('{foo}a', 'one', 'two', 'three', 'four')
+        assert r.blmove('{foo}a', '{foo}b', 5)
+        assert r.blmove('{foo}a', '{foo}b', 1, 'RIGHT', 'LEFT')
+
+    def test_cluster_msetnx(self, r):
+        d = {'{foo}a': b'1', '{foo}b': b'2', '{foo}c': b'3'}
+        assert r.msetnx(d)
+        d2 = {'{foo}a': b'x', '{foo}d': b'4'}
+        assert not r.msetnx(d2)
+        for k, v in d.items():
+            assert r[k] == v
+        assert r.get('{foo}d') is None
+
+    def test_cluster_rename(self, r):
+        r['{foo}a'] = '1'
+        assert r.rename('{foo}a', '{foo}b')
+        assert r.get('{foo}a') is None
+        assert r['{foo}b'] == b'1'
+
+    def test_cluster_renamenx(self, r):
+        r['{foo}a'] = '1'
+        r['{foo}b'] = '2'
+        assert not r.renamenx('{foo}a', '{foo}b')
+        assert r['{foo}a'] == b'1'
+        assert r['{foo}b'] == b'2'
+
+    # LIST COMMANDS
+    def test_cluster_blpop(self, r):
+        r.rpush('{foo}a', '1', '2')
+        r.rpush('{foo}b', '3', '4')
+        assert r.blpop(['{foo}b', '{foo}a'], timeout=1) == (b'{foo}b', b'3')
+        assert r.blpop(['{foo}b', '{foo}a'], timeout=1) == (b'{foo}b', b'4')
+        assert r.blpop(['{foo}b', '{foo}a'], timeout=1) == (b'{foo}a', b'1')
+        assert r.blpop(['{foo}b', '{foo}a'], timeout=1) == (b'{foo}a', b'2')
+        assert r.blpop(['{foo}b', '{foo}a'], timeout=1) is None
+        r.rpush('{foo}c', '1')
+        assert r.blpop('{foo}c', timeout=1) == (b'{foo}c', b'1')
+
+    def test_cluster_brpop(self, r):
+        r.rpush('{foo}a', '1', '2')
+        r.rpush('{foo}b', '3', '4')
+        assert r.brpop(['{foo}b', '{foo}a'], timeout=1) == (b'{foo}b', b'4')
+        assert r.brpop(['{foo}b', '{foo}a'], timeout=1) == (b'{foo}b', b'3')
+        assert r.brpop(['{foo}b', '{foo}a'], timeout=1) == (b'{foo}a', b'2')
+        assert r.brpop(['{foo}b', '{foo}a'], timeout=1) == (b'{foo}a', b'1')
+        assert r.brpop(['{foo}b', '{foo}a'], timeout=1) is None
+        r.rpush('{foo}c', '1')
+        assert r.brpop('{foo}c', timeout=1) == (b'{foo}c', b'1')
+
+    def test_cluster_brpoplpush(self, r):
+        r.rpush('{foo}a', '1', '2')
+        r.rpush('{foo}b', '3', '4')
+        assert r.brpoplpush('{foo}a', '{foo}b') == b'2'
+        assert r.brpoplpush('{foo}a', '{foo}b') == b'1'
+        assert r.brpoplpush('{foo}a', '{foo}b', timeout=1) is None
+        assert r.lrange('{foo}a', 0, -1) == []
+        assert r.lrange('{foo}b', 0, -1) == [b'1', b'2', b'3', b'4']
+
+    def test_cluster_brpoplpush_empty_string(self, r):
+        r.rpush('{foo}a', '')
+        assert r.brpoplpush('{foo}a', '{foo}b') == b''
+
+    def test_cluster_rpoplpush(self, r):
+        r.rpush('{foo}a', 'a1', 'a2', 'a3')
+        r.rpush('{foo}b', 'b1', 'b2', 'b3')
+        assert r.rpoplpush('{foo}a', '{foo}b') == b'a3'
+        assert r.lrange('{foo}a', 0, -1) == [b'a1', b'a2']
+        assert r.lrange('{foo}b', 0, -1) == [b'a3', b'b1', b'b2', b'b3']
+
+    def test_cluster_sdiff(self, r):
+        r.sadd('{foo}a', '1', '2', '3')
+        assert r.sdiff('{foo}a', '{foo}b') == {b'1', b'2', b'3'}
+        r.sadd('{foo}b', '2', '3')
+        assert r.sdiff('{foo}a', '{foo}b') == {b'1'}
+
+    def test_cluster_sdiffstore(self, r):
+        r.sadd('{foo}a', '1', '2', '3')
+        assert r.sdiffstore('{foo}c', '{foo}a', '{foo}b') == 3
+        assert r.smembers('{foo}c') == {b'1', b'2', b'3'}
+        r.sadd('{foo}b', '2', '3')
+        assert r.sdiffstore('{foo}c', '{foo}a', '{foo}b') == 1
+        assert r.smembers('{foo}c') == {b'1'}
+
+    def test_cluster_sinter(self, r):
+        r.sadd('{foo}a', '1', '2', '3')
+        assert r.sinter('{foo}a', '{foo}b') == set()
+        r.sadd('{foo}b', '2', '3')
+        assert r.sinter('{foo}a', '{foo}b') == {b'2', b'3'}
+
+    def test_cluster_sinterstore(self, r):
+        r.sadd('{foo}a', '1', '2', '3')
+        assert r.sinterstore('{foo}c', '{foo}a', '{foo}b') == 0
+        assert r.smembers('{foo}c') == set()
+        r.sadd('{foo}b', '2', '3')
+        assert r.sinterstore('{foo}c', '{foo}a', '{foo}b') == 2
+        assert r.smembers('{foo}c') == {b'2', b'3'}
+
+    def test_cluster_smove(self, r):
+        r.sadd('{foo}a', 'a1', 'a2')
+        r.sadd('{foo}b', 'b1', 'b2')
+        assert r.smove('{foo}a', '{foo}b', 'a1')
+        assert r.smembers('{foo}a') == {b'a2'}
+        assert r.smembers('{foo}b') == {b'b1', b'b2', b'a1'}
+
+    def test_cluster_sunion(self, r):
+        r.sadd('{foo}a', '1', '2')
+        r.sadd('{foo}b', '2', '3')
+        assert r.sunion('{foo}a', '{foo}b') == {b'1', b'2', b'3'}
+
+    def test_cluster_sunionstore(self, r):
+        r.sadd('{foo}a', '1', '2')
+        r.sadd('{foo}b', '2', '3')
+        assert r.sunionstore('{foo}c', '{foo}a', '{foo}b') == 3
+        assert r.smembers('{foo}c') == {b'1', b'2', b'3'}
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_cluster_zdiff(self, r):
+        r.zadd('{foo}a', {'a1': 1, 'a2': 2, 'a3': 3})
+        r.zadd('{foo}b', {'a1': 1, 'a2': 2})
+        assert r.zdiff(['{foo}a', '{foo}b']) == [b'a3']
+        assert r.zdiff(['{foo}a', '{foo}b'], withscores=True) == [b'a3', b'3']
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_cluster_zdiffstore(self, r):
+        r.zadd('{foo}a', {'a1': 1, 'a2': 2, 'a3': 3})
+        r.zadd('{foo}b', {'a1': 1, 'a2': 2})
+        assert r.zdiffstore("{foo}out", ['{foo}a', '{foo}b'])
+        assert r.zrange("{foo}out", 0, -1) == [b'a3']
+        assert r.zrange("{foo}out", 0, -1, withscores=True) == [(b'a3', 3.0)]
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_cluster_zinter(self, r):
+        r.zadd('{foo}a', {'a1': 1, 'a2': 2, 'a3': 1})
+        r.zadd('{foo}b', {'a1': 2, 'a2': 2, 'a3': 2})
+        r.zadd('{foo}c', {'a1': 6, 'a3': 5, 'a4': 4})
+        assert r.zinter(['{foo}a', '{foo}b', '{foo}c']) == [b'a3', b'a1']
+        # invalid aggregation
+        with pytest.raises(DataError):
+            r.zinter(['{foo}a', '{foo}b', '{foo}c'],
+                     aggregate='foo', withscores=True)
+        # aggregate with SUM
+        assert r.zinter(['{foo}a', '{foo}b', '{foo}c'], withscores=True) \
+               == [(b'a3', 8), (b'a1', 9)]
+        # aggregate with MAX
+        assert r.zinter(['{foo}a', '{foo}b', '{foo}c'], aggregate='MAX',
+                        withscores=True) \
+               == [(b'a3', 5), (b'a1', 6)]
+        # aggregate with MIN
+        assert r.zinter(['{foo}a', '{foo}b', '{foo}c'], aggregate='MIN',
+                        withscores=True) \
+               == [(b'a1', 1), (b'a3', 1)]
+        # with weights
+        assert r.zinter({'{foo}a': 1, '{foo}b': 2, '{foo}c': 3},
+                        withscores=True) \
+               == [(b'a3', 20), (b'a1', 23)]
+
+    def test_cluster_zinterstore_sum(self, r):
+        r.zadd('{foo}a', {'a1': 1, 'a2': 1, 'a3': 1})
+        r.zadd('{foo}b', {'a1': 2, 'a2': 2, 'a3': 2})
+        r.zadd('{foo}c', {'a1': 6, 'a3': 5, 'a4': 4})
+        assert r.zinterstore('{foo}d', ['{foo}a', '{foo}b', '{foo}c']) == 2
+        assert r.zrange('{foo}d', 0, -1, withscores=True) == \
+               [(b'a3', 8), (b'a1', 9)]
+
+    def test_cluster_zinterstore_max(self, r):
+        r.zadd('{foo}a', {'a1': 1, 'a2': 1, 'a3': 1})
+        r.zadd('{foo}b', {'a1': 2, 'a2': 2, 'a3': 2})
+        r.zadd('{foo}c', {'a1': 6, 'a3': 5, 'a4': 4})
+        assert r.zinterstore(
+            '{foo}d', ['{foo}a', '{foo}b', '{foo}c'], aggregate='MAX') == 2
+        assert r.zrange('{foo}d', 0, -1, withscores=True) == \
+               [(b'a3', 5), (b'a1', 6)]
+
+    def test_cluster_zinterstore_min(self, r):
+        r.zadd('{foo}a', {'a1': 1, 'a2': 2, 'a3': 3})
+        r.zadd('{foo}b', {'a1': 2, 'a2': 3, 'a3': 5})
+        r.zadd('{foo}c', {'a1': 6, 'a3': 5, 'a4': 4})
+        assert r.zinterstore(
+            '{foo}d', ['{foo}a', '{foo}b', '{foo}c'], aggregate='MIN') == 2
+        assert r.zrange('{foo}d', 0, -1, withscores=True) == \
+               [(b'a1', 1), (b'a3', 3)]
+
+    def test_cluster_zinterstore_with_weight(self, r):
+        r.zadd('{foo}a', {'a1': 1, 'a2': 1, 'a3': 1})
+        r.zadd('{foo}b', {'a1': 2, 'a2': 2, 'a3': 2})
+        r.zadd('{foo}c', {'a1': 6, 'a3': 5, 'a4': 4})
+        assert r.zinterstore(
+            '{foo}d', {'{foo}a': 1, '{foo}b': 2, '{foo}c': 3}) == 2
+        assert r.zrange('{foo}d', 0, -1, withscores=True) == \
+               [(b'a3', 20), (b'a1', 23)]
+
+    @skip_if_server_version_lt('4.9.0')
+    def test_cluster_bzpopmax(self, r):
+        r.zadd('{foo}a', {'a1': 1, 'a2': 2})
+        r.zadd('{foo}b', {'b1': 10, 'b2': 20})
+        assert r.bzpopmax(['{foo}b', '{foo}a'], timeout=1) == (
+            b'{foo}b', b'b2', 20)
+        assert r.bzpopmax(['{foo}b', '{foo}a'], timeout=1) == (
+            b'{foo}b', b'b1', 10)
+        assert r.bzpopmax(['{foo}b', '{foo}a'], timeout=1) == (
+            b'{foo}a', b'a2', 2)
+        assert r.bzpopmax(['{foo}b', '{foo}a'], timeout=1) == (
+            b'{foo}a', b'a1', 1)
+        assert r.bzpopmax(['{foo}b', '{foo}a'], timeout=1) is None
+        r.zadd('{foo}c', {'c1': 100})
+        assert r.bzpopmax('{foo}c', timeout=1) == (b'{foo}c', b'c1', 100)
+
+    @skip_if_server_version_lt('4.9.0')
+    def test_cluster_bzpopmin(self, r):
+        r.zadd('{foo}a', {'a1': 1, 'a2': 2})
+        r.zadd('{foo}b', {'b1': 10, 'b2': 20})
+        assert r.bzpopmin(['{foo}b', '{foo}a'], timeout=1) == (
+            b'{foo}b', b'b1', 10)
+        assert r.bzpopmin(['{foo}b', '{foo}a'], timeout=1) == (
+            b'{foo}b', b'b2', 20)
+        assert r.bzpopmin(['{foo}b', '{foo}a'], timeout=1) == (
+            b'{foo}a', b'a1', 1)
+        assert r.bzpopmin(['{foo}b', '{foo}a'], timeout=1) == (
+            b'{foo}a', b'a2', 2)
+        assert r.bzpopmin(['{foo}b', '{foo}a'], timeout=1) is None
+        r.zadd('{foo}c', {'c1': 100})
+        assert r.bzpopmin('{foo}c', timeout=1) == (b'{foo}c', b'c1', 100)
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_cluster_zrangestore(self, r):
+        r.zadd('{foo}a', {'a1': 1, 'a2': 2, 'a3': 3})
+        assert r.zrangestore('{foo}b', '{foo}a', 0, 1)
+        assert r.zrange('{foo}b', 0, -1) == [b'a1', b'a2']
+        assert r.zrangestore('{foo}b', '{foo}a', 1, 2)
+        assert r.zrange('{foo}b', 0, -1) == [b'a2', b'a3']
+        assert r.zrange('{foo}b', 0, -1, withscores=True) == \
+               [(b'a2', 2), (b'a3', 3)]
+        # reversed order
+        assert r.zrangestore('{foo}b', '{foo}a', 1, 2, desc=True)
+        assert r.zrange('{foo}b', 0, -1) == [b'a1', b'a2']
+        # by score
+        assert r.zrangestore('{foo}b', '{foo}a', 2, 1, byscore=True,
+                             offset=0, num=1, desc=True)
+        assert r.zrange('{foo}b', 0, -1) == [b'a2']
+        # by lex
+        assert r.zrangestore('{foo}b', '{foo}a', '[a2', '(a3', bylex=True,
+                             offset=0, num=1)
+        assert r.zrange('{foo}b', 0, -1) == [b'a2']
+
+    @skip_if_server_version_lt('6.2.0')
+    def test_cluster_zunion(self, r):
+        r.zadd('{foo}a', {'a1': 1, 'a2': 1, 'a3': 1})
+        r.zadd('{foo}b', {'a1': 2, 'a2': 2, 'a3': 2})
+        r.zadd('{foo}c', {'a1': 6, 'a3': 5, 'a4': 4})
+        # sum
+        assert r.zunion(['{foo}a', '{foo}b', '{foo}c']) == \
+               [b'a2', b'a4', b'a3', b'a1']
+        assert r.zunion(['{foo}a', '{foo}b', '{foo}c'], withscores=True) == \
+               [(b'a2', 3), (b'a4', 4), (b'a3', 8), (b'a1', 9)]
+        # max
+        assert r.zunion(['{foo}a', '{foo}b', '{foo}c'], aggregate='MAX',
+                        withscores=True) \
+               == [(b'a2', 2), (b'a4', 4), (b'a3', 5), (b'a1', 6)]
+        # min
+        assert r.zunion(['{foo}a', '{foo}b', '{foo}c'], aggregate='MIN',
+                        withscores=True) \
+               == [(b'a1', 1), (b'a2', 1), (b'a3', 1), (b'a4', 4)]
+        # with weight
+        assert r.zunion({'{foo}a': 1, '{foo}b': 2, '{foo}c': 3},
+                        withscores=True) \
+               == [(b'a2', 5), (b'a4', 12), (b'a3', 20), (b'a1', 23)]
+
+    def test_cluster_zunionstore_sum(self, r):
+        r.zadd('{foo}a', {'a1': 1, 'a2': 1, 'a3': 1})
+        r.zadd('{foo}b', {'a1': 2, 'a2': 2, 'a3': 2})
+        r.zadd('{foo}c', {'a1': 6, 'a3': 5, 'a4': 4})
+        assert r.zunionstore('{foo}d', ['{foo}a', '{foo}b', '{foo}c']) == 4
+        assert r.zrange('{foo}d', 0, -1, withscores=True) == \
+               [(b'a2', 3), (b'a4', 4), (b'a3', 8), (b'a1', 9)]
+
+    def test_cluster_zunionstore_max(self, r):
+        r.zadd('{foo}a', {'a1': 1, 'a2': 1, 'a3': 1})
+        r.zadd('{foo}b', {'a1': 2, 'a2': 2, 'a3': 2})
+        r.zadd('{foo}c', {'a1': 6, 'a3': 5, 'a4': 4})
+        assert r.zunionstore(
+            '{foo}d', ['{foo}a', '{foo}b', '{foo}c'], aggregate='MAX') == 4
+        assert r.zrange('{foo}d', 0, -1, withscores=True) == \
+               [(b'a2', 2), (b'a4', 4), (b'a3', 5), (b'a1', 6)]
+
+    def test_cluster_zunionstore_min(self, r):
+        r.zadd('{foo}a', {'a1': 1, 'a2': 2, 'a3': 3})
+        r.zadd('{foo}b', {'a1': 2, 'a2': 2, 'a3': 4})
+        r.zadd('{foo}c', {'a1': 6, 'a3': 5, 'a4': 4})
+        assert r.zunionstore(
+            '{foo}d', ['{foo}a', '{foo}b', '{foo}c'], aggregate='MIN') == 4
+        assert r.zrange('{foo}d', 0, -1, withscores=True) == \
+               [(b'a1', 1), (b'a2', 2), (b'a3', 3), (b'a4', 4)]
+
+    def test_cluster_zunionstore_with_weight(self, r):
+        r.zadd('{foo}a', {'a1': 1, 'a2': 1, 'a3': 1})
+        r.zadd('{foo}b', {'a1': 2, 'a2': 2, 'a3': 2})
+        r.zadd('{foo}c', {'a1': 6, 'a3': 5, 'a4': 4})
+        assert r.zunionstore(
+            '{foo}d', {'{foo}a': 1, '{foo}b': 2, '{foo}c': 3}) == 4
+        assert r.zrange('{foo}d', 0, -1, withscores=True) == \
+               [(b'a2', 5), (b'a4', 12), (b'a3', 20), (b'a1', 23)]
+
+    @skip_if_server_version_lt('2.8.9')
+    def test_cluster_pfcount(self, r):
+        members = {b'1', b'2', b'3'}
+        r.pfadd('{foo}a', *members)
+        assert r.pfcount('{foo}a') == len(members)
+        members_b = {b'2', b'3', b'4'}
+        r.pfadd('{foo}b', *members_b)
+        assert r.pfcount('{foo}b') == len(members_b)
+        assert r.pfcount('{foo}a', '{foo}b') == len(members_b.union(members))
+
+    @skip_if_server_version_lt('2.8.9')
+    def test_cluster_pfmerge(self, r):
+        mema = {b'1', b'2', b'3'}
+        memb = {b'2', b'3', b'4'}
+        memc = {b'5', b'6', b'7'}
+        r.pfadd('{foo}a', *mema)
+        r.pfadd('{foo}b', *memb)
+        r.pfadd('{foo}c', *memc)
+        r.pfmerge('{foo}d', '{foo}c', '{foo}a')
+        assert r.pfcount('{foo}d') == 6
+        r.pfmerge('{foo}d', '{foo}b')
+        assert r.pfcount('{foo}d') == 7
+
+    def test_cluster_sort_store(self, r):
+        r.rpush('{foo}a', '2', '3', '1')
+        assert r.sort('{foo}a', store='{foo}sorted_values') == 3
+        assert r.lrange('{foo}sorted_values', 0, -1) == [b'1', b'2', b'3']
+
+    # GEO COMMANDS
+    @skip_if_server_version_lt('6.2.0')
+    def test_cluster_geosearchstore(self, r):
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
+                 (2.1873744593677, 41.406342043777, 'place2')
+
+        r.geoadd('{foo}barcelona', values)
+        r.geosearchstore('{foo}places_barcelona', '{foo}barcelona',
+                         longitude=2.191, latitude=41.433, radius=1000)
+        assert r.zrange('{foo}places_barcelona', 0, -1) == [b'place1']
+
+    @skip_unless_arch_bits(64)
+    @skip_if_server_version_lt('6.2.0')
+    def test_geosearchstore_dist(self, r):
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
+                 (2.1873744593677, 41.406342043777, 'place2')
+
+        r.geoadd('{foo}barcelona', values)
+        r.geosearchstore('{foo}places_barcelona', '{foo}barcelona',
+                         longitude=2.191, latitude=41.433,
+                         radius=1000, storedist=True)
+        # instead of save the geo score, the distance is saved.
+        assert r.zscore('{foo}places_barcelona', 'place1') == 88.05060698409301
+
+    @skip_if_server_version_lt('3.2.0')
+    def test_cluster_georadius_store(self, r):
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
+                 (2.1873744593677, 41.406342043777, 'place2')
+
+        r.geoadd('{foo}barcelona', values)
+        r.georadius('{foo}barcelona', 2.191, 41.433,
+                    1000, store='{foo}places_barcelona')
+        assert r.zrange('{foo}places_barcelona', 0, -1) == [b'place1']
+
+    @skip_unless_arch_bits(64)
+    @skip_if_server_version_lt('3.2.0')
+    def test_cluster_georadius_store_dist(self, r):
+        values = (2.1909389952632, 41.433791470673, 'place1') + \
+                 (2.1873744593677, 41.406342043777, 'place2')
+
+        r.geoadd('{foo}barcelona', values)
+        r.georadius('{foo}barcelona', 2.191, 41.433, 1000,
+                    store_dist='{foo}places_barcelona')
+        # instead of save the geo score, the distance is saved.
+        assert r.zscore('{foo}places_barcelona', 'place1') == 88.05060698409301
+
+    def test_cluster_dbsize(self, r):
+        d = {'a': b'1', 'b': b'2', 'c': b'3', 'd': b'4'}
+        assert r.mset_nonatomic(d)
+        assert r.dbsize(target_nodes='primaries') == len(d)
+
+    def test_cluster_keys(self, r):
+        assert r.keys() == []
+        keys_with_underscores = {b'test_a', b'test_b'}
+        keys = keys_with_underscores.union({b'testc'})
+        for key in keys:
+            r[key] = 1
+        assert set(r.keys(pattern='test_*', target_nodes='primaries')) == \
+               keys_with_underscores
+        assert set(r.keys(pattern='test*', target_nodes='primaries')) == keys
+
+    # SCAN COMMANDS
+    @skip_if_server_version_lt('2.8.0')
+    def test_cluster_scan(self, r):
+        r.set('a', 1)
+        r.set('b', 2)
+        r.set('c', 3)
+        cursor, keys = r.scan(target_nodes='primaries')
+        assert cursor == 0
+        assert set(keys) == {b'a', b'b', b'c'}
+        _, keys = r.scan(match='a', target_nodes='primaries')
+        assert set(keys) == {b'a'}
+
+    @skip_if_server_version_lt("6.0.0")
+    def test_cluster_scan_type(self, r):
+        r.sadd('a-set', 1)
+        r.hset('a-hash', 'foo', 2)
+        r.lpush('a-list', 'aux', 3)
+        _, keys = r.scan(match='a*', _type='SET', target_nodes='primaries')
+        assert set(keys) == {b'a-set'}
+
+    @skip_if_server_version_lt('2.8.0')
+    def test_cluster_scan_iter(self, r):
+        r.set('a', 1)
+        r.set('b', 2)
+        r.set('c', 3)
+        keys = list(r.scan_iter(target_nodes='primaries'))
+        assert set(keys) == {b'a', b'b', b'c'}
+        keys = list(r.scan_iter(match='a', target_nodes='primaries'))
+        assert set(keys) == {b'a'}
+
+    def test_cluster_randomkey(self, r):
+        node = r.get_node_from_key('{foo}')
+        assert r.randomkey(target_nodes=node) is None
+        for key in ('{foo}a', '{foo}b', '{foo}c'):
+            r[key] = 1
+        assert r.randomkey(target_nodes=node) in \
+               (b'{foo}a', b'{foo}b', b'{foo}c')
+
+
+@pytest.mark.onlycluster
+class TestNodesManager:
+    """
+    Tests for the NodesManager class
+    """
+
+    def test_load_balancer(self, r):
+        n_manager = r.nodes_manager
+        lb = n_manager.read_load_balancer
+        slot_1 = 1257
+        slot_2 = 8975
+        node_1 = ClusterNode(default_host, 6379, PRIMARY)
+        node_2 = ClusterNode(default_host, 6378, REPLICA)
+        node_3 = ClusterNode(default_host, 6377, REPLICA)
+        node_4 = ClusterNode(default_host, 6376, PRIMARY)
+        node_5 = ClusterNode(default_host, 6375, REPLICA)
+        n_manager.slots_cache = {
+            slot_1: [node_1, node_2, node_3],
+            slot_2: [node_4, node_5]
+        }
+        primary1_name = n_manager.slots_cache[slot_1][0].name
+        primary2_name = n_manager.slots_cache[slot_2][0].name
+        list1_size = len(n_manager.slots_cache[slot_1])
+        list2_size = len(n_manager.slots_cache[slot_2])
+        # slot 1
+        assert lb.get_server_index(primary1_name, list1_size) == 0
+        assert lb.get_server_index(primary1_name, list1_size) == 1
+        assert lb.get_server_index(primary1_name, list1_size) == 2
+        assert lb.get_server_index(primary1_name, list1_size) == 0
+        # slot 2
+        assert lb.get_server_index(primary2_name, list2_size) == 0
+        assert lb.get_server_index(primary2_name, list2_size) == 1
+        assert lb.get_server_index(primary2_name, list2_size) == 0
+
+        lb.reset()
+        assert lb.get_server_index(primary1_name, list1_size) == 0
+        assert lb.get_server_index(primary2_name, list2_size) == 0
+
+    def test_init_slots_cache_not_all_slots_covered(self):
+        """
+        Test that if not all slots are covered it should raise an exception
+        """
+        # Missing slot 5460
+        cluster_slots = [
+            [0, 5459, ['127.0.0.1', 7000], ['127.0.0.1', 7003]],
+            [5461, 10922, ['127.0.0.1', 7001],
+             ['127.0.0.1', 7004]],
+            [10923, 16383, ['127.0.0.1', 7002],
+             ['127.0.0.1', 7005]],
+        ]
+        with pytest.raises(RedisClusterException) as ex:
+            get_mocked_redis_client(host=default_host, port=default_port,
+                                    cluster_slots=cluster_slots)
+        assert str(ex.value).startswith(
+            "All slots are not covered after query all startup_nodes.")
+
+    def test_init_slots_cache_not_require_full_coverage_error(self):
+        """
+        When require_full_coverage is set to False and not all slots are
+        covered, if one of the nodes has 'cluster-require_full_coverage'
+        config set to 'yes' the cluster initialization should fail
+        """
+        # Missing slot 5460
+        cluster_slots = [
+            [0, 5459, ['127.0.0.1', 7000], ['127.0.0.1', 7003]],
+            [5461, 10922, ['127.0.0.1', 7001],
+             ['127.0.0.1', 7004]],
+            [10923, 16383, ['127.0.0.1', 7002],
+             ['127.0.0.1', 7005]],
+        ]
+
+        with pytest.raises(RedisClusterException):
+            get_mocked_redis_client(host=default_host, port=default_port,
+                                    cluster_slots=cluster_slots,
+                                    require_full_coverage=False,
+                                    coverage_result='yes')
+
+    def test_init_slots_cache_not_require_full_coverage_success(self):
+        """
+        When require_full_coverage is set to False and not all slots are
+        covered, if all of the nodes has 'cluster-require_full_coverage'
+        config set to 'no' the cluster initialization should succeed
+        """
+        # Missing slot 5460
+        cluster_slots = [
+            [0, 5459, ['127.0.0.1', 7000], ['127.0.0.1', 7003]],
+            [5461, 10922, ['127.0.0.1', 7001],
+             ['127.0.0.1', 7004]],
+            [10923, 16383, ['127.0.0.1', 7002],
+             ['127.0.0.1', 7005]],
+        ]
+
+        rc = get_mocked_redis_client(host=default_host, port=default_port,
+                                     cluster_slots=cluster_slots,
+                                     require_full_coverage=False,
+                                     coverage_result='no')
+
+        assert 5460 not in rc.nodes_manager.slots_cache
+
+    def test_init_slots_cache_not_require_full_coverage_skips_check(self):
+        """
+        Test that when require_full_coverage is set to False and
+        skip_full_coverage_check is set to true, the cluster initialization
+        succeed without checking the nodes' Redis configurations
+        """
+        # Missing slot 5460
+        cluster_slots = [
+            [0, 5459, ['127.0.0.1', 7000], ['127.0.0.1', 7003]],
+            [5461, 10922, ['127.0.0.1', 7001],
+             ['127.0.0.1', 7004]],
+            [10923, 16383, ['127.0.0.1', 7002],
+             ['127.0.0.1', 7005]],
+        ]
+
+        with patch.object(NodesManager,
+                          'cluster_require_full_coverage') as conf_check_mock:
+            rc = get_mocked_redis_client(host=default_host, port=default_port,
+                                         cluster_slots=cluster_slots,
+                                         require_full_coverage=False,
+                                         skip_full_coverage_check=True,
+                                         coverage_result='no')
+
+            assert conf_check_mock.called is False
+            assert 5460 not in rc.nodes_manager.slots_cache
+
+    def test_init_slots_cache(self):
+        """
+        Test that slots cache can in initialized and all slots are covered
+        """
+        good_slots_resp = [
+            [0, 5460, ['127.0.0.1', 7000], ['127.0.0.2', 7003]],
+            [5461, 10922, ['127.0.0.1', 7001], ['127.0.0.2', 7004]],
+            [10923, 16383, ['127.0.0.1', 7002], ['127.0.0.2', 7005]],
+        ]
+
+        rc = get_mocked_redis_client(host=default_host, port=default_port,
+                                     cluster_slots=good_slots_resp)
+        n_manager = rc.nodes_manager
+        assert len(n_manager.slots_cache) == REDIS_CLUSTER_HASH_SLOTS
+        for slot_info in good_slots_resp:
+            all_hosts = ['127.0.0.1', '127.0.0.2']
+            all_ports = [7000, 7001, 7002, 7003, 7004, 7005]
+            slot_start = slot_info[0]
+            slot_end = slot_info[1]
+            for i in range(slot_start, slot_end + 1):
+                assert len(n_manager.slots_cache[i]) == len(slot_info[2:])
+                assert n_manager.slots_cache[i][0].host in all_hosts
+                assert n_manager.slots_cache[i][1].host in all_hosts
+                assert n_manager.slots_cache[i][0].port in all_ports
+                assert n_manager.slots_cache[i][1].port in all_ports
+
+        assert len(n_manager.nodes_cache) == 6
+
+    def test_empty_startup_nodes(self):
+        """
+        It should not be possible to create a node manager with no nodes
+        specified
+        """
+        with pytest.raises(RedisClusterException):
+            NodesManager([])
+
+    def test_wrong_startup_nodes_type(self):
+        """
+        If something other then a list type itteratable is provided it should
+        fail
+        """
+        with pytest.raises(RedisClusterException):
+            NodesManager({})
+
+    def test_init_slots_cache_slots_collision(self, request):
+        """
+        Test that if 2 nodes do not agree on the same slots setup it should
+        raise an error. In this test both nodes will say that the first
+        slots block should be bound to different servers.
+        """
+        with patch.object(NodesManager,
+                          'create_redis_node') as create_redis_node:
+            def create_mocked_redis_node(host, port, **kwargs):
+                """
+                Helper function to return custom slots cache data from
+                different redis nodes
+                """
+                if port == 7000:
+                    result = [
+                        [
+                            0,
+                            5460,
+                            ['127.0.0.1', 7000],
+                            ['127.0.0.1', 7003],
+                        ],
+                        [
+                            5461,
+                            10922,
+                            ['127.0.0.1', 7001],
+                            ['127.0.0.1', 7004],
+                        ],
+                    ]
+
+                elif port == 7001:
+                    result = [
+                        [
+                            0,
+                            5460,
+                            ['127.0.0.1', 7001],
+                            ['127.0.0.1', 7003],
+                        ],
+                        [
+                            5461,
+                            10922,
+                            ['127.0.0.1', 7000],
+                            ['127.0.0.1', 7004],
+                        ],
+                    ]
+                else:
+                    result = []
+
+                r_node = Redis(
+                    host=host,
+                    port=port
+                )
+
+                orig_execute_command = r_node.execute_command
+
+                def execute_command(*args, **kwargs):
+                    if args[0] == 'CLUSTER SLOTS':
+                        return result
+                    elif args[1] == 'cluster-require-full-coverage':
+                        return {'cluster-require-full-coverage': 'yes'}
+                    else:
+                        return orig_execute_command(*args, **kwargs)
+
+                r_node.execute_command = execute_command
+                return r_node
+
+            create_redis_node.side_effect = create_mocked_redis_node
+
+            with pytest.raises(RedisClusterException) as ex:
+                node_1 = ClusterNode('127.0.0.1', 7000)
+                node_2 = ClusterNode('127.0.0.1', 7001)
+                RedisCluster(startup_nodes=[node_1, node_2])
+            assert str(ex.value).startswith(
+                "startup_nodes could not agree on a valid slots cache"), str(
+                ex.value)
+
+    def test_cluster_one_instance(self):
+        """
+        If the cluster exists of only 1 node then there is some hacks that must
+        be validated they work.
+        """
+        node = ClusterNode(default_host, default_port)
+        cluster_slots = [[0, 16383, ['', default_port]]]
+        rc = get_mocked_redis_client(startup_nodes=[node],
+                                     cluster_slots=cluster_slots)
+
+        n = rc.nodes_manager
+        assert len(n.nodes_cache) == 1
+        n_node = rc.get_node(node_name=node.name)
+        assert n_node is not None
+        assert n_node == node
+        assert n_node.server_type == PRIMARY
+        assert len(n.slots_cache) == REDIS_CLUSTER_HASH_SLOTS
+        for i in range(0, REDIS_CLUSTER_HASH_SLOTS):
+            assert n.slots_cache[i] == [n_node]
+
+    def test_init_with_down_node(self):
+        """
+        If I can't connect to one of the nodes, everything should still work.
+        But if I can't connect to any of the nodes, exception should be thrown.
+        """
+        with patch.object(NodesManager,
+                          'create_redis_node') as create_redis_node:
+            def create_mocked_redis_node(host, port, **kwargs):
+                if port == 7000:
+                    raise ConnectionError('mock connection error for 7000')
+
+                r_node = Redis(host=host, port=port, decode_responses=True)
+
+                def execute_command(*args, **kwargs):
+                    if args[0] == 'CLUSTER SLOTS':
+                        return [
+                            [
+                                0, 8191,
+                                ['127.0.0.1', 7001, 'node_1'],
+                            ],
+                            [
+                                8192, 16383,
+                                ['127.0.0.1', 7002, 'node_2'],
+                            ]
+                        ]
+                    elif args[1] == 'cluster-require-full-coverage':
+                        return {'cluster-require-full-coverage': 'yes'}
+
+                r_node.execute_command = execute_command
+
+                return r_node
+
+            create_redis_node.side_effect = create_mocked_redis_node
+
+            node_1 = ClusterNode('127.0.0.1', 7000)
+            node_2 = ClusterNode('127.0.0.1', 7001)
+
+            # If all startup nodes fail to connect, connection error should be
+            # thrown
+            with pytest.raises(RedisClusterException) as e:
+                RedisCluster(startup_nodes=[node_1])
+            assert 'Redis Cluster cannot be connected' in str(e.value)
+
+            with patch.object(CommandsParser, 'initialize',
+                              autospec=True) as cmd_parser_initialize:
+
+                def cmd_init_mock(self, r):
+                    self.commands = {'get': {'name': 'get', 'arity': 2,
+                                             'flags': ['readonly',
+                                                       'fast'],
+                                             'first_key_pos': 1,
+                                             'last_key_pos': 1,
+                                             'step_count': 1}}
+
+                cmd_parser_initialize.side_effect = cmd_init_mock
+                # When at least one startup node is reachable, the cluster
+                # initialization should succeeds
+                rc = RedisCluster(startup_nodes=[node_1, node_2])
+                assert rc.get_node(host=default_host, port=7001) is not None
+                assert rc.get_node(host=default_host, port=7002) is not None
+
+
+@pytest.mark.onlycluster
+class TestClusterPubSubObject:
+    """
+    Tests for the ClusterPubSub class
+    """
+
+    def test_init_pubsub_with_host_and_port(self, r):
+        """
+        Test creation of pubsub instance with passed host and port
+        """
+        node = r.get_default_node()
+        p = r.pubsub(host=node.host, port=node.port)
+        assert p.get_pubsub_node() == node
+
+    def test_init_pubsub_with_node(self, r):
+        """
+        Test creation of pubsub instance with passed node
+        """
+        node = r.get_default_node()
+        p = r.pubsub(node=node)
+        assert p.get_pubsub_node() == node
+
+    def test_init_pubusub_without_specifying_node(self, r):
+        """
+        Test creation of pubsub instance without specifying a node. The node
+        should be determined based on the keyslot of the first command
+        execution.
+        """
+        channel_name = 'foo'
+        node = r.get_node_from_key(channel_name)
+        p = r.pubsub()
+        assert p.get_pubsub_node() is None
+        p.subscribe(channel_name)
+        assert p.get_pubsub_node() == node
+
+    def test_init_pubsub_with_a_non_existent_node(self, r):
+        """
+        Test creation of pubsub instance with node that doesn't exists in the
+        cluster. RedisClusterException should be raised.
+        """
+        node = ClusterNode('1.1.1.1', 1111)
+        with pytest.raises(RedisClusterException):
+            r.pubsub(node)
+
+    def test_init_pubsub_with_a_non_existent_host_port(self, r):
+        """
+        Test creation of pubsub instance with host and port that don't belong
+        to a node in the cluster.
+        RedisClusterException should be raised.
+        """
+        with pytest.raises(RedisClusterException):
+            r.pubsub(host='1.1.1.1', port=1111)
+
+    def test_init_pubsub_host_or_port(self, r):
+        """
+        Test creation of pubsub instance with host but without port, and vice
+        versa. DataError should be raised.
+        """
+        with pytest.raises(DataError):
+            r.pubsub(host='localhost')
+
+        with pytest.raises(DataError):
+            r.pubsub(port=16379)
+
+    def test_get_redis_connection(self, r):
+        """
+        Test that get_redis_connection() returns the redis connection of the
+        set pubsub node
+        """
+        node = r.get_default_node()
+        p = r.pubsub(node=node)
+        assert p.get_redis_connection() == node.redis_connection
+
+
+@pytest.mark.onlycluster
+class TestClusterPipeline:
+    """
+    Tests for the ClusterPipeline class
+    """
+
+    def test_blocked_methods(self, r):
+        """
+        Currently some method calls on a Cluster pipeline
+        is blocked when using in cluster mode.
+        They maybe implemented in the future.
+        """
+        pipe = r.pipeline()
+        with pytest.raises(RedisClusterException):
+            pipe.multi()
+
+        with pytest.raises(RedisClusterException):
+            pipe.immediate_execute_command()
+
+        with pytest.raises(RedisClusterException):
+            pipe._execute_transaction(None, None, None)
+
+        with pytest.raises(RedisClusterException):
+            pipe.load_scripts()
+
+        with pytest.raises(RedisClusterException):
+            pipe.watch()
+
+        with pytest.raises(RedisClusterException):
+            pipe.unwatch()
+
+        with pytest.raises(RedisClusterException):
+            pipe.script_load_for_pipeline(None)
+
+        with pytest.raises(RedisClusterException):
+            pipe.eval()
+
+    def test_blocked_arguments(self, r):
+        """
+        Currently some arguments is blocked when using in cluster mode.
+        They maybe implemented in the future.
+        """
+        with pytest.raises(RedisClusterException) as ex:
+            r.pipeline(transaction=True)
+
+        assert str(ex.value).startswith(
+            "transaction is deprecated in cluster mode") is True
+
+        with pytest.raises(RedisClusterException) as ex:
+            r.pipeline(shard_hint=True)
+
+        assert str(ex.value).startswith(
+            "shard_hint is deprecated in cluster mode") is True
+
+    def test_redis_cluster_pipeline(self, r):
+        """
+        Test that we can use a pipeline with the RedisCluster class
+        """
+        with r.pipeline() as pipe:
+            pipe.set("foo", "bar")
+            pipe.get("foo")
+            assert pipe.execute() == [True, b'bar']
+
+    def test_mget_disabled(self, r):
+        """
+        Test that mget is disabled for ClusterPipeline
+        """
+        with r.pipeline() as pipe:
+            with pytest.raises(RedisClusterException):
+                pipe.mget(['a'])
+
+    def test_mset_disabled(self, r):
+        """
+        Test that mset is disabled for ClusterPipeline
+        """
+        with r.pipeline() as pipe:
+            with pytest.raises(RedisClusterException):
+                pipe.mset({'a': 1, 'b': 2})
+
+    def test_rename_disabled(self, r):
+        """
+        Test that rename is disabled for ClusterPipeline
+        """
+        with r.pipeline(transaction=False) as pipe:
+            with pytest.raises(RedisClusterException):
+                pipe.rename('a', 'b')
+
+    def test_renamenx_disabled(self, r):
+        """
+        Test that renamenx is disabled for ClusterPipeline
+        """
+        with r.pipeline(transaction=False) as pipe:
+            with pytest.raises(RedisClusterException):
+                pipe.renamenx('a', 'b')
+
+    def test_delete_single(self, r):
+        """
+        Test a single delete operation
+        """
+        r['a'] = 1
+        with r.pipeline(transaction=False) as pipe:
+            pipe.delete('a')
+            assert pipe.execute() == [1]
+
+    def test_multi_delete_unsupported(self, r):
+        """
+        Test that multi delete operation is unsupported
+        """
+        with r.pipeline(transaction=False) as pipe:
+            r['a'] = 1
+            r['b'] = 2
+            with pytest.raises(RedisClusterException):
+                pipe.delete('a', 'b')
+
+    def test_brpoplpush_disabled(self, r):
+        """
+        Test that brpoplpush is disabled for ClusterPipeline
+        """
+        with r.pipeline(transaction=False) as pipe:
+            with pytest.raises(RedisClusterException):
+                pipe.brpoplpush()
+
+    def test_rpoplpush_disabled(self, r):
+        """
+        Test that rpoplpush is disabled for ClusterPipeline
+        """
+        with r.pipeline(transaction=False) as pipe:
+            with pytest.raises(RedisClusterException):
+                pipe.rpoplpush()
+
+    def test_sort_disabled(self, r):
+        """
+        Test that sort is disabled for ClusterPipeline
+        """
+        with r.pipeline(transaction=False) as pipe:
+            with pytest.raises(RedisClusterException):
+                pipe.sort()
+
+    def test_sdiff_disabled(self, r):
+        """
+        Test that sdiff is disabled for ClusterPipeline
+        """
+        with r.pipeline(transaction=False) as pipe:
+            with pytest.raises(RedisClusterException):
+                pipe.sdiff()
+
+    def test_sdiffstore_disabled(self, r):
+        """
+        Test that sdiffstore is disabled for ClusterPipeline
+        """
+        with r.pipeline(transaction=False) as pipe:
+            with pytest.raises(RedisClusterException):
+                pipe.sdiffstore()
+
+    def test_sinter_disabled(self, r):
+        """
+        Test that sinter is disabled for ClusterPipeline
+        """
+        with r.pipeline(transaction=False) as pipe:
+            with pytest.raises(RedisClusterException):
+                pipe.sinter()
+
+    def test_sinterstore_disabled(self, r):
+        """
+        Test that sinterstore is disabled for ClusterPipeline
+        """
+        with r.pipeline(transaction=False) as pipe:
+            with pytest.raises(RedisClusterException):
+                pipe.sinterstore()
+
+    def test_smove_disabled(self, r):
+        """
+        Test that move is disabled for ClusterPipeline
+        """
+        with r.pipeline(transaction=False) as pipe:
+            with pytest.raises(RedisClusterException):
+                pipe.smove()
+
+    def test_sunion_disabled(self, r):
+        """
+        Test that sunion is disabled for ClusterPipeline
+        """
+        with r.pipeline(transaction=False) as pipe:
+            with pytest.raises(RedisClusterException):
+                pipe.sunion()
+
+    def test_sunionstore_disabled(self, r):
+        """
+        Test that sunionstore is disabled for ClusterPipeline
+        """
+        with r.pipeline(transaction=False) as pipe:
+            with pytest.raises(RedisClusterException):
+                pipe.sunionstore()
+
+    def test_spfmerge_disabled(self, r):
+        """
+        Test that spfmerge is disabled for ClusterPipeline
+        """
+        with r.pipeline(transaction=False) as pipe:
+            with pytest.raises(RedisClusterException):
+                pipe.pfmerge()
+
+    def test_multi_key_operation_with_a_single_slot(self, r):
+        """
+        Test multi key operation with a single slot
+        """
+        pipe = r.pipeline(transaction=False)
+        pipe.set('a{foo}', 1)
+        pipe.set('b{foo}', 2)
+        pipe.set('c{foo}', 3)
+        pipe.get('a{foo}')
+        pipe.get('b{foo}')
+        pipe.get('c{foo}')
+
+        res = pipe.execute()
+        assert res == [True, True, True, b'1', b'2', b'3']
+
+    def test_multi_key_operation_with_multi_slots(self, r):
+        """
+        Test multi key operation with more than one slot
+        """
+        pipe = r.pipeline(transaction=False)
+        pipe.set('a{foo}', 1)
+        pipe.set('b{foo}', 2)
+        pipe.set('c{foo}', 3)
+        pipe.set('bar', 4)
+        pipe.set('bazz', 5)
+        pipe.get('a{foo}')
+        pipe.get('b{foo}')
+        pipe.get('c{foo}')
+        pipe.get('bar')
+        pipe.get('bazz')
+        res = pipe.execute()
+        assert res == [True, True, True, True, True, b'1', b'2', b'3', b'4',
+                       b'5']
+
+    def test_connection_error_not_raised(self, r):
+        """
+        Test that the pipeline doesn't raise an error on connection error when
+        raise_on_error=False
+        """
+        key = 'foo'
+        node = r.get_node_from_key(key, False)
+
+        def raise_connection_error():
+            e = ConnectionError("error")
+            return e
+
+        with r.pipeline() as pipe:
+            mock_node_resp_func(node, raise_connection_error)
+            res = pipe.get(key).get(key).execute(raise_on_error=False)
+            assert node.redis_connection.connection.read_response.called
+            assert isinstance(res[0], ConnectionError)
+
+    def test_connection_error_raised(self, r):
+        """
+        Test that the pipeline raises an error on connection error when
+        raise_on_error=True
+        """
+        key = 'foo'
+        node = r.get_node_from_key(key, False)
+
+        def raise_connection_error():
+            e = ConnectionError("error")
+            return e
+
+        with r.pipeline() as pipe:
+            mock_node_resp_func(node, raise_connection_error)
+            with pytest.raises(ConnectionError):
+                pipe.get(key).get(key).execute(raise_on_error=True)
+
+    def test_asking_error(self, r):
+        """
+        Test redirection on ASK error
+        """
+        key = 'foo'
+        first_node = r.get_node_from_key(key, False)
+        ask_node = None
+        for node in r.get_nodes():
+            if node != first_node:
+                ask_node = node
+                break
+        if ask_node is None:
+            warnings.warn("skipping this test since the cluster has only one "
+                          "node")
+            return
+        ask_msg = "{0} {1}:{2}".format(r.keyslot(key), ask_node.host,
+                                       ask_node.port)
+
+        def raise_ask_error():
+            raise AskError(ask_msg)
+
+        with r.pipeline() as pipe:
+            mock_node_resp_func(first_node, raise_ask_error)
+            mock_node_resp(ask_node, 'MOCK_OK')
+            res = pipe.get(key).execute()
+            assert first_node.redis_connection.connection.read_response.called
+            assert ask_node.redis_connection.connection.read_response.called
+            assert res == ['MOCK_OK']
+
+    def test_empty_stack(self, r):
+        """
+        If pipeline is executed with no commands it should
+        return a empty list.
+        """
+        p = r.pipeline()
+        result = p.execute()
+        assert result == []
+
+
+@pytest.mark.onlycluster
+class TestReadOnlyPipeline:
+    """
+    Tests for ClusterPipeline class in readonly mode
+    """
+
+    def test_pipeline_readonly(self, r):
+        """
+        On readonly mode, we supports get related stuff only.
+        """
+        r.readonly(target_nodes='all')
+        r.set('foo71', 'a1')  # we assume this key is set on 127.0.0.1:7001
+        r.zadd('foo88',
+               {'z1': 1})  # we assume this key is set on 127.0.0.1:7002
+        r.zadd('foo88', {'z2': 4})
+
+        with r.pipeline() as readonly_pipe:
+            readonly_pipe.get('foo71').zrange('foo88', 0, 5, withscores=True)
+            assert readonly_pipe.execute() == [
+                b'a1',
+                [(b'z1', 1.0), (b'z2', 4)],
+            ]
+
+    def test_moved_redirection_on_slave_with_default(self, r):
+        """
+        On Pipeline, we redirected once and finally get from master with
+        readonly client when data is completely moved.
+        """
+        key = 'bar'
+        r.set(key, 'foo')
+        # set read_from_replicas to True
+        r.read_from_replicas = True
+        primary = r.get_node_from_key(key, False)
+        replica = r.get_node_from_key(key, True)
+        with r.pipeline() as readwrite_pipe:
+            mock_node_resp(primary, "MOCK_FOO")
+            if replica is not None:
+                moved_error = "{0} {1}:{2}".format(r.keyslot(key),
+                                                   primary.host,
+                                                   primary.port)
+
+                def raise_moved_error():
+                    raise MovedError(moved_error)
+
+                mock_node_resp_func(replica, raise_moved_error)
+            assert readwrite_pipe.reinitialize_counter == 0
+            readwrite_pipe.get(key).get(key)
+            assert readwrite_pipe.execute() == ["MOCK_FOO", "MOCK_FOO"]
+            if replica is not None:
+                # the slot has a replica as well, so MovedError should have
+                # occurred. If MovedError occurs, we should see the
+                # reinitialize_counter increase.
+                assert readwrite_pipe.reinitialize_counter == 1
+                conn = replica.redis_connection.connection
+                assert conn.read_response.called is True
+
+    def test_readonly_pipeline_from_readonly_client(self, request):
+        """
+        Test that the pipeline is initialized with readonly mode if the client
+        has it enabled
+        """
+        # Create a cluster with reading from replications
+        ro = _get_client(RedisCluster, request, read_from_replicas=True)
+        key = 'bar'
+        ro.set(key, 'foo')
+        import time
+        time.sleep(0.2)
+        with ro.pipeline() as readonly_pipe:
+            mock_all_nodes_resp(ro, 'MOCK_OK')
+            assert readonly_pipe.read_from_replicas is True
+            assert readonly_pipe.get(key).get(
+                key).execute() == ['MOCK_OK', 'MOCK_OK']
+            slot_nodes = ro.nodes_manager.slots_cache[ro.keyslot(key)]
+            if len(slot_nodes) > 1:
+                executed_on_replica = False
+                for node in slot_nodes:
+                    if node.server_type == REPLICA:
+                        conn = node.redis_connection.connection
+                        executed_on_replica = conn.read_response.called
+                        if executed_on_replica:
+                            break
+                assert executed_on_replica is True
diff --git a/tests/test_command_parser.py b/tests/test_command_parser.py
new file mode 100644
index 0000000000..ba129ba673
--- /dev/null
+++ b/tests/test_command_parser.py
@@ -0,0 +1,62 @@
+import pytest
+
+from redis.commands import CommandsParser
+
+
+class TestCommandsParser:
+    def test_init_commands(self, r):
+        commands_parser = CommandsParser(r)
+        assert commands_parser.commands is not None
+        assert 'get' in commands_parser.commands
+
+    def test_get_keys_predetermined_key_location(self, r):
+        commands_parser = CommandsParser(r)
+        args1 = ['GET', 'foo']
+        args2 = ['OBJECT', 'encoding', 'foo']
+        args3 = ['MGET', 'foo', 'bar', 'foobar']
+        assert commands_parser.get_keys(r, *args1) == ['foo']
+        assert commands_parser.get_keys(r, *args2) == ['foo']
+        assert commands_parser.get_keys(r, *args3) == ['foo', 'bar', 'foobar']
+
+    @pytest.mark.filterwarnings("ignore:ResponseError")
+    def test_get_moveable_keys(self, r):
+        commands_parser = CommandsParser(r)
+        args1 = ['EVAL', 'return {KEYS[1],KEYS[2],ARGV[1],ARGV[2]}', 2, 'key1',
+                 'key2', 'first', 'second']
+        args2 = ['XREAD', 'COUNT', 2, b'STREAMS', 'mystream', 'writers', 0, 0]
+        args3 = ['ZUNIONSTORE', 'out', 2, 'zset1', 'zset2', 'WEIGHTS', 2, 3]
+        args4 = ['GEORADIUS', 'Sicily', 15, 37, 200, 'km', 'WITHCOORD',
+                 b'STORE', 'out']
+        args5 = ['MEMORY USAGE', 'foo']
+        args6 = ['MIGRATE', '192.168.1.34', 6379, "", 0, 5000, b'KEYS',
+                 'key1', 'key2', 'key3']
+        args7 = ['MIGRATE', '192.168.1.34', 6379, "key1", 0, 5000]
+        args8 = ['STRALGO', 'LCS', 'STRINGS', 'string_a', 'string_b']
+        args9 = ['STRALGO', 'LCS', 'KEYS', 'key1', 'key2']
+
+        assert commands_parser.get_keys(
+            r, *args1).sort() == ['key1', 'key2'].sort()
+        assert commands_parser.get_keys(
+            r, *args2).sort() == ['mystream', 'writers'].sort()
+        assert commands_parser.get_keys(
+            r, *args3).sort() == ['out', 'zset1', 'zset2'].sort()
+        assert commands_parser.get_keys(
+            r, *args4).sort() == ['Sicily', 'out'].sort()
+        assert commands_parser.get_keys(r, *args5).sort() == ['foo'].sort()
+        assert commands_parser.get_keys(
+            r, *args6).sort() == ['key1', 'key2', 'key3'].sort()
+        assert commands_parser.get_keys(r, *args7).sort() == ['key1'].sort()
+        assert commands_parser.get_keys(r, *args8) is None
+        assert commands_parser.get_keys(
+            r, *args9).sort() == ['key1', 'key2'].sort()
+
+    def test_get_pubsub_keys(self, r):
+        commands_parser = CommandsParser(r)
+        args1 = ['PUBLISH', 'foo', 'bar']
+        args2 = ['PUBSUB NUMSUB', 'foo1', 'foo2', 'foo3']
+        args3 = ['PUBSUB channels', '*']
+        args4 = ['SUBSCRIBE', 'foo1', 'foo2', 'foo3']
+        assert commands_parser.get_keys(r, *args1) == ['foo']
+        assert commands_parser.get_keys(r, *args2) == ['foo1', 'foo2', 'foo3']
+        assert commands_parser.get_keys(r, *args3) == ['*']
+        assert commands_parser.get_keys(r, *args4) == ['foo1', 'foo2', 'foo3']
diff --git a/tests/test_commands.py b/tests/test_commands.py
index dbd04429b4..780a1bf443 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -47,6 +47,7 @@ def get_stream_message(client, stream, message_id):
 
 
 # RESPONSE CALLBACKS
+@pytest.mark.onlynoncluster
 class TestResponseCallbacks:
     "Tests for the response callback system"
 
@@ -68,18 +69,21 @@ def test_command_on_invalid_key_type(self, r):
             r['a']
 
     # SERVER INFORMATION
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     def test_acl_cat_no_category(self, r):
         categories = r.acl_cat()
         assert isinstance(categories, list)
         assert 'read' in categories
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     def test_acl_cat_with_category(self, r):
         commands = r.acl_cat('read')
         assert isinstance(commands, list)
         assert 'get' in commands
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_deluser(self, r, request):
@@ -105,6 +109,7 @@ def teardown():
         assert r.acl_getuser(users[3]) is None
         assert r.acl_getuser(users[4]) is None
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_genpass(self, r):
@@ -119,6 +124,7 @@ def test_acl_genpass(self, r):
         r.acl_genpass(555)
         assert isinstance(password, str)
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_getuser_setuser(self, r, request):
@@ -207,12 +213,14 @@ def teardown():
                              hashed_passwords=['-' + hashed_password])
         assert len(r.acl_getuser(username)['passwords']) == 1
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     def test_acl_help(self, r):
         res = r.acl_help()
         assert isinstance(res, list)
         assert len(res) != 0
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_list(self, r, request):
@@ -226,6 +234,7 @@ def teardown():
         users = r.acl_list()
         assert len(users) == 2
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_log(self, r, request):
@@ -262,6 +271,7 @@ def teardown():
         assert 'client-info' in r.acl_log(count=1)[0]
         assert r.acl_log_reset()
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_setuser_categories_without_prefix_fails(self, r, request):
@@ -274,6 +284,7 @@ def teardown():
         with pytest.raises(exceptions.DataError):
             r.acl_setuser(username, categories=['list'])
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_setuser_commands_without_prefix_fails(self, r, request):
@@ -286,6 +297,7 @@ def teardown():
         with pytest.raises(exceptions.DataError):
             r.acl_setuser(username, commands=['get'])
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_setuser_add_passwords_and_nopass_fails(self, r, request):
@@ -298,28 +310,33 @@ def teardown():
         with pytest.raises(exceptions.DataError):
             r.acl_setuser(username, passwords='+mypass', nopass=True)
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     def test_acl_users(self, r):
         users = r.acl_users()
         assert isinstance(users, list)
         assert len(users) > 0
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     def test_acl_whoami(self, r):
         username = r.acl_whoami()
         assert isinstance(username, str)
 
+    @pytest.mark.onlynoncluster
     def test_client_list(self, r):
         clients = r.client_list()
         assert isinstance(clients[0], dict)
         assert 'addr' in clients[0]
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('6.2.0')
     def test_client_info(self, r):
         info = r.client_info()
         assert isinstance(info, dict)
         assert 'addr' in info
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('5.0.0')
     def test_client_list_types_not_replica(self, r):
         with pytest.raises(exceptions.RedisError):
@@ -333,6 +350,7 @@ def test_client_list_replica(self, r):
         clients = r.client_list(_type='replica')
         assert isinstance(clients, list)
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('6.2.0')
     def test_client_list_client_id(self, r, request):
         clients = r.client_list()
@@ -347,16 +365,19 @@ def test_client_list_client_id(self, r, request):
         clients_listed = r.client_list(client_id=clients[:-1])
         assert len(clients_listed) > 1
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('5.0.0')
     def test_client_id(self, r):
         assert r.client_id() > 0
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('6.2.0')
     def test_client_trackinginfo(self, r):
         res = r.client_trackinginfo()
         assert len(res) > 2
         assert 'prefixes' in res
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('5.0.0')
     def test_client_unblock(self, r):
         myid = r.client_id()
@@ -364,15 +385,18 @@ def test_client_unblock(self, r):
         assert not r.client_unblock(myid, error=True)
         assert not r.client_unblock(myid, error=False)
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.6.9')
     def test_client_getname(self, r):
         assert r.client_getname() is None
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.6.9')
     def test_client_setname(self, r):
         assert r.client_setname('redis_py_test')
         assert r.client_getname() == 'redis_py_test'
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.6.9')
     def test_client_kill(self, r, r2):
         r.client_setname('redis-py-c1')
@@ -406,6 +430,7 @@ def test_client_kill_filter_invalid_params(self, r):
         with pytest.raises(exceptions.DataError):
             r.client_kill_filter(_type="caster")
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.8.12')
     def test_client_kill_filter_by_id(self, r, r2):
         r.client_setname('redis-py-c1')
@@ -426,6 +451,7 @@ def test_client_kill_filter_by_id(self, r, r2):
         assert len(clients) == 1
         assert clients[0].get('name') == 'redis-py-c1'
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.8.12')
     def test_client_kill_filter_by_addr(self, r, r2):
         r.client_setname('redis-py-c1')
@@ -481,6 +507,7 @@ def test_client_kill_filter_by_user(self, r, request):
             assert c['user'] != killuser
         r.acl_deluser(killuser)
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.9.50')
     @skip_if_redis_enterprise
     def test_client_pause(self, r):
@@ -489,11 +516,13 @@ def test_client_pause(self, r):
         with pytest.raises(exceptions.RedisError):
             r.client_pause(timeout='not an integer')
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('6.2.0')
     @skip_if_redis_enterprise
     def test_client_unpause(self, r):
         assert r.client_unpause() == b'OK'
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('3.2.0')
     def test_client_reply(self, r, r_timeout):
         assert r_timeout.client_reply('ON') == b'OK'
@@ -507,6 +536,7 @@ def test_client_reply(self, r, r_timeout):
         # validate it was set
         assert r.get('foo') == b'bar'
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('6.0.0')
     @skip_if_redis_enterprise
     def test_client_getredir(self, r):
@@ -519,6 +549,7 @@ def test_config_get(self, r):
         # # assert 'maxmemory' in data
         # assert data['maxmemory'].isdigit()
 
+    @pytest.mark.onlynoncluster
     @skip_if_redis_enterprise
     def test_config_resetstat(self, r):
         r.ping()
@@ -535,14 +566,17 @@ def test_config_set(self, r):
         assert r.config_set('timeout', 0)
         assert r.config_get()['timeout'] == '0'
 
+    @pytest.mark.onlynoncluster
     def test_dbsize(self, r):
         r['a'] = 'foo'
         r['b'] = 'bar'
         assert r.dbsize() == 2
 
+    @pytest.mark.onlynoncluster
     def test_echo(self, r):
         assert r.echo('foo bar') == b'foo bar'
 
+    @pytest.mark.onlynoncluster
     def test_info(self, r):
         r['a'] = 'foo'
         r['b'] = 'bar'
@@ -551,10 +585,12 @@ def test_info(self, r):
         assert 'arch_bits' in info.keys()
         assert 'redis_version' in info.keys()
 
+    @pytest.mark.onlynoncluster
     @skip_if_redis_enterprise
     def test_lastsave(self, r):
         assert isinstance(r.lastsave(), datetime.datetime)
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('5.0.0')
     def test_lolwut(self, r):
         lolwut = r.lolwut().decode('utf-8')
@@ -573,9 +609,11 @@ def test_object(self, r):
     def test_ping(self, r):
         assert r.ping()
 
+    @pytest.mark.onlynoncluster
     def test_quit(self, r):
         assert r.quit()
 
+    @pytest.mark.onlynoncluster
     def test_slowlog_get(self, r, slowlog):
         assert r.slowlog_reset()
         unicode_string = chr(3456) + 'abcd' + chr(3421)
@@ -613,6 +651,7 @@ def parse_response(connection, command_name, **options):
                     # Complexity info stored as fourth item in list
                     response.insert(3, COMPLEXITY_STATEMENT)
                 return r.response_callbacks[command_name](responses, **options)
+
             r.parse_response = parse_response
 
             # test
@@ -626,6 +665,7 @@ def parse_response(connection, command_name, **options):
             # tear down monkeypatch
             r.parse_response = old_parse_response
 
+    @pytest.mark.onlynoncluster
     def test_slowlog_get_limit(self, r, slowlog):
         assert r.slowlog_reset()
         r.get('foo')
@@ -634,6 +674,7 @@ def test_slowlog_get_limit(self, r, slowlog):
         # only one command, based on the number we passed to slowlog_get()
         assert len(slowlog) == 1
 
+    @pytest.mark.onlynoncluster
     def test_slowlog_length(self, r, slowlog):
         r.get('foo')
         assert isinstance(r.slowlog_len(), int)
@@ -677,12 +718,14 @@ def test_bitcount(self, r):
         assert r.bitcount('a', -2, -1) == 2
         assert r.bitcount('a', 1, 1) == 1
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.6.0')
     def test_bitop_not_empty_string(self, r):
         r['a'] = ''
         r.bitop('not', 'r', 'a')
         assert r.get('r') is None
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.6.0')
     def test_bitop_not(self, r):
         test_str = b'\xAA\x00\xFF\x55'
@@ -691,6 +734,7 @@ def test_bitop_not(self, r):
         r.bitop('not', 'r', 'a')
         assert int(binascii.hexlify(r['r']), 16) == correct
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.6.0')
     def test_bitop_not_in_place(self, r):
         test_str = b'\xAA\x00\xFF\x55'
@@ -699,6 +743,7 @@ def test_bitop_not_in_place(self, r):
         r.bitop('not', 'a', 'a')
         assert int(binascii.hexlify(r['a']), 16) == correct
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.6.0')
     def test_bitop_single_string(self, r):
         test_str = b'\x01\x02\xFF'
@@ -710,6 +755,7 @@ def test_bitop_single_string(self, r):
         assert r['res2'] == test_str
         assert r['res3'] == test_str
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.6.0')
     def test_bitop_string_operands(self, r):
         r['a'] = b'\x01\x02\xFF\xFF'
@@ -721,6 +767,7 @@ def test_bitop_string_operands(self, r):
         assert int(binascii.hexlify(r['res2']), 16) == 0x0102FFFF
         assert int(binascii.hexlify(r['res3']), 16) == 0x000000FF
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.8.7')
     def test_bitpos(self, r):
         key = 'key:bitpos'
@@ -743,6 +790,7 @@ def test_bitpos_wrong_arguments(self, r):
         with pytest.raises(exceptions.RedisError):
             r.bitpos(key, 7) == 12
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('6.2.0')
     def test_copy(self, r):
         assert r.copy("a", "b") == 0
@@ -751,6 +799,7 @@ def test_copy(self, r):
         assert r.get("a") == b"foo"
         assert r.get("b") == b"foo"
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('6.2.0')
     def test_copy_and_replace(self, r):
         r.set("a", "foo1")
@@ -758,6 +807,7 @@ def test_copy_and_replace(self, r):
         assert r.copy("a", "b") == 0
         assert r.copy("a", "b", replace=True) == 1
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('6.2.0')
     def test_copy_to_another_database(self, request):
         r0 = _get_client(redis.Redis, request, db=0)
@@ -973,6 +1023,7 @@ def test_incrbyfloat(self, r):
         assert r.incrbyfloat('a', 1.1) == 2.1
         assert float(r['a']) == float(2.1)
 
+    @pytest.mark.onlynoncluster
     def test_keys(self, r):
         assert r.keys() == []
         keys_with_underscores = {b'test_a', b'test_b'}
@@ -982,6 +1033,7 @@ def test_keys(self, r):
         assert set(r.keys(pattern='test_*')) == keys_with_underscores
         assert set(r.keys(pattern='test*')) == keys
 
+    @pytest.mark.onlynoncluster
     def test_mget(self, r):
         assert r.mget([]) == []
         assert r.mget(['a', 'b']) == [None, None]
@@ -990,24 +1042,28 @@ def test_mget(self, r):
         r['c'] = '3'
         assert r.mget('a', 'other', 'b', 'c') == [b'1', None, b'2', b'3']
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('6.2.0')
     def test_lmove(self, r):
         r.rpush('a', 'one', 'two', 'three', 'four')
         assert r.lmove('a', 'b')
         assert r.lmove('a', 'b', 'right', 'left')
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('6.2.0')
     def test_blmove(self, r):
         r.rpush('a', 'one', 'two', 'three', 'four')
         assert r.blmove('a', 'b', 5)
         assert r.blmove('a', 'b', 1, 'RIGHT', 'LEFT')
 
+    @pytest.mark.onlynoncluster
     def test_mset(self, r):
         d = {'a': b'1', 'b': b'2', 'c': b'3'}
         assert r.mset(d)
         for k, v in d.items():
             assert r[k] == v
 
+    @pytest.mark.onlynoncluster
     def test_msetnx(self, r):
         d = {'a': b'1', 'b': b'2', 'c': b'3'}
         assert r.msetnx(d)
@@ -1086,18 +1142,21 @@ def test_hrandfield(self, r):
         # with duplications
         assert len(r.hrandfield('key', -10)) == 10
 
+    @pytest.mark.onlynoncluster
     def test_randomkey(self, r):
         assert r.randomkey() is None
         for key in ('a', 'b', 'c'):
             r[key] = 1
         assert r.randomkey() in (b'a', b'b', b'c')
 
+    @pytest.mark.onlynoncluster
     def test_rename(self, r):
         r['a'] = '1'
         assert r.rename('a', 'b')
         assert r.get('a') is None
         assert r['b'] == b'1'
 
+    @pytest.mark.onlynoncluster
     def test_renamenx(self, r):
         r['a'] = '1'
         r['b'] = '2'
@@ -1203,8 +1262,8 @@ def test_setrange(self, r):
 
     @skip_if_server_version_lt('6.0.0')
     def test_stralgo_lcs(self, r):
-        key1 = 'key1'
-        key2 = 'key2'
+        key1 = '{foo}key1'
+        key2 = '{foo}key2'
         value1 = 'ohmytext'
         value2 = 'mynewtext'
         res = 'mytext'
@@ -1294,6 +1353,7 @@ def test_type(self, r):
         assert r.type('a') == b'zset'
 
     # LIST COMMANDS
+    @pytest.mark.onlynoncluster
     def test_blpop(self, r):
         r.rpush('a', '1', '2')
         r.rpush('b', '3', '4')
@@ -1305,6 +1365,7 @@ def test_blpop(self, r):
         r.rpush('c', '1')
         assert r.blpop('c', timeout=1) == (b'c', b'1')
 
+    @pytest.mark.onlynoncluster
     def test_brpop(self, r):
         r.rpush('a', '1', '2')
         r.rpush('b', '3', '4')
@@ -1316,6 +1377,7 @@ def test_brpop(self, r):
         r.rpush('c', '1')
         assert r.brpop('c', timeout=1) == (b'c', b'1')
 
+    @pytest.mark.onlynoncluster
     def test_brpoplpush(self, r):
         r.rpush('a', '1', '2')
         r.rpush('b', '3', '4')
@@ -1325,6 +1387,7 @@ def test_brpoplpush(self, r):
         assert r.lrange('a', 0, -1) == []
         assert r.lrange('b', 0, -1) == [b'1', b'2', b'3', b'4']
 
+    @pytest.mark.onlynoncluster
     def test_brpoplpush_empty_string(self, r):
         r.rpush('a', '')
         assert r.brpoplpush('a', 'b') == b''
@@ -1428,6 +1491,7 @@ def test_rpop_count(self, r):
         assert r.rpop('a') is None
         assert r.rpop('a', 3) is None
 
+    @pytest.mark.onlynoncluster
     def test_rpoplpush(self, r):
         r.rpush('a', 'a1', 'a2', 'a3')
         r.rpush('b', 'b1', 'b2', 'b3')
@@ -1481,6 +1545,7 @@ def test_rpushx(self, r):
         assert r.lrange('a', 0, -1) == [b'1', b'2', b'3', b'4']
 
     # SCAN COMMANDS
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.8.0')
     def test_scan(self, r):
         r.set('a', 1)
@@ -1492,6 +1557,7 @@ def test_scan(self, r):
         _, keys = r.scan(match='a')
         assert set(keys) == {b'a'}
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     def test_scan_type(self, r):
         r.sadd('a-set', 1)
@@ -1500,6 +1566,7 @@ def test_scan_type(self, r):
         _, keys = r.scan(match='a*', _type='SET')
         assert set(keys) == {b'a-set'}
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.8.0')
     def test_scan_iter(self, r):
         r.set('a', 1)
@@ -1571,12 +1638,14 @@ def test_scard(self, r):
         r.sadd('a', '1', '2', '3')
         assert r.scard('a') == 3
 
+    @pytest.mark.onlynoncluster
     def test_sdiff(self, r):
         r.sadd('a', '1', '2', '3')
         assert r.sdiff('a', 'b') == {b'1', b'2', b'3'}
         r.sadd('b', '2', '3')
         assert r.sdiff('a', 'b') == {b'1'}
 
+    @pytest.mark.onlynoncluster
     def test_sdiffstore(self, r):
         r.sadd('a', '1', '2', '3')
         assert r.sdiffstore('c', 'a', 'b') == 3
@@ -1585,12 +1654,14 @@ def test_sdiffstore(self, r):
         assert r.sdiffstore('c', 'a', 'b') == 1
         assert r.smembers('c') == {b'1'}
 
+    @pytest.mark.onlynoncluster
     def test_sinter(self, r):
         r.sadd('a', '1', '2', '3')
         assert r.sinter('a', 'b') == set()
         r.sadd('b', '2', '3')
         assert r.sinter('a', 'b') == {b'2', b'3'}
 
+    @pytest.mark.onlynoncluster
     def test_sinterstore(self, r):
         r.sadd('a', '1', '2', '3')
         assert r.sinterstore('c', 'a', 'b') == 0
@@ -1617,6 +1688,7 @@ def test_smismember(self, r):
         assert r.smismember('a', '1', '4', '2', '3') == result_list
         assert r.smismember('a', ['1', '4', '2', '3']) == result_list
 
+    @pytest.mark.onlynoncluster
     def test_smove(self, r):
         r.sadd('a', 'a1', 'a2')
         r.sadd('b', 'b1', 'b2')
@@ -1662,11 +1734,13 @@ def test_srem(self, r):
         assert r.srem('a', '2', '4') == 2
         assert r.smembers('a') == {b'1', b'3'}
 
+    @pytest.mark.onlynoncluster
     def test_sunion(self, r):
         r.sadd('a', '1', '2')
         r.sadd('b', '2', '3')
         assert r.sunion('a', 'b') == {b'1', b'2', b'3'}
 
+    @pytest.mark.onlynoncluster
     def test_sunionstore(self, r):
         r.sadd('a', '1', '2')
         r.sadd('b', '2', '3')
@@ -1678,6 +1752,7 @@ def test_debug_segfault(self, r):
         with pytest.raises(NotImplementedError):
             r.debug_segfault()
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('3.2.0')
     def test_script_debug(self, r):
         with pytest.raises(NotImplementedError):
@@ -1759,6 +1834,7 @@ def test_zcount(self, r):
         assert r.zcount('a', 1, '(' + str(2)) == 1
         assert r.zcount('a', 10, 20) == 0
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('6.2.0')
     def test_zdiff(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
@@ -1766,6 +1842,7 @@ def test_zdiff(self, r):
         assert r.zdiff(['a', 'b']) == [b'a3']
         assert r.zdiff(['a', 'b'], withscores=True) == [b'a3', b'3']
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('6.2.0')
     def test_zdiffstore(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
@@ -1787,6 +1864,7 @@ def test_zlexcount(self, r):
         assert r.zlexcount('a', '-', '+') == 7
         assert r.zlexcount('a', '[b', '[f') == 5
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('6.2.0')
     def test_zinter(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 1})
@@ -1809,6 +1887,7 @@ def test_zinter(self, r):
         assert r.zinter({'a': 1, 'b': 2, 'c': 3}, withscores=True) \
                == [(b'a3', 20), (b'a1', 23)]
 
+    @pytest.mark.onlynoncluster
     def test_zinterstore_sum(self, r):
         r.zadd('a', {'a1': 1, 'a2': 1, 'a3': 1})
         r.zadd('b', {'a1': 2, 'a2': 2, 'a3': 2})
@@ -1817,6 +1896,7 @@ def test_zinterstore_sum(self, r):
         assert r.zrange('d', 0, -1, withscores=True) == \
                [(b'a3', 8), (b'a1', 9)]
 
+    @pytest.mark.onlynoncluster
     def test_zinterstore_max(self, r):
         r.zadd('a', {'a1': 1, 'a2': 1, 'a3': 1})
         r.zadd('b', {'a1': 2, 'a2': 2, 'a3': 2})
@@ -1825,6 +1905,7 @@ def test_zinterstore_max(self, r):
         assert r.zrange('d', 0, -1, withscores=True) == \
                [(b'a3', 5), (b'a1', 6)]
 
+    @pytest.mark.onlynoncluster
     def test_zinterstore_min(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
         r.zadd('b', {'a1': 2, 'a2': 3, 'a3': 5})
@@ -1833,6 +1914,7 @@ def test_zinterstore_min(self, r):
         assert r.zrange('d', 0, -1, withscores=True) == \
                [(b'a1', 1), (b'a3', 3)]
 
+    @pytest.mark.onlynoncluster
     def test_zinterstore_with_weight(self, r):
         r.zadd('a', {'a1': 1, 'a2': 1, 'a3': 1})
         r.zadd('b', {'a1': 2, 'a2': 2, 'a3': 2})
@@ -1871,6 +1953,7 @@ def test_zrandemember(self, r):
         # with duplications
         assert len(r.zrandmember('a', -10)) == 10
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('4.9.0')
     def test_bzpopmax(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2})
@@ -1883,6 +1966,7 @@ def test_bzpopmax(self, r):
         r.zadd('c', {'c1': 100})
         assert r.bzpopmax('c', timeout=1) == (b'c', b'c1', 100)
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('4.9.0')
     def test_bzpopmin(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2})
@@ -1952,6 +2036,7 @@ def test_zrange_params(self, r):
         # rev
         assert r.zrange('a', 0, 1, desc=True) == [b'a5', b'a4']
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('6.2.0')
     def test_zrangestore(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
@@ -2089,6 +2174,7 @@ def test_zscore(self, r):
         assert r.zscore('a', 'a2') == 2.0
         assert r.zscore('a', 'a4') is None
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('6.2.0')
     def test_zunion(self, r):
         r.zadd('a', {'a1': 1, 'a2': 1, 'a3': 1})
@@ -2109,6 +2195,7 @@ def test_zunion(self, r):
         assert r.zunion({'a': 1, 'b': 2, 'c': 3}, withscores=True)\
                == [(b'a2', 5), (b'a4', 12), (b'a3', 20), (b'a1', 23)]
 
+    @pytest.mark.onlynoncluster
     def test_zunionstore_sum(self, r):
         r.zadd('a', {'a1': 1, 'a2': 1, 'a3': 1})
         r.zadd('b', {'a1': 2, 'a2': 2, 'a3': 2})
@@ -2117,6 +2204,7 @@ def test_zunionstore_sum(self, r):
         assert r.zrange('d', 0, -1, withscores=True) == \
                [(b'a2', 3), (b'a4', 4), (b'a3', 8), (b'a1', 9)]
 
+    @pytest.mark.onlynoncluster
     def test_zunionstore_max(self, r):
         r.zadd('a', {'a1': 1, 'a2': 1, 'a3': 1})
         r.zadd('b', {'a1': 2, 'a2': 2, 'a3': 2})
@@ -2125,6 +2213,7 @@ def test_zunionstore_max(self, r):
         assert r.zrange('d', 0, -1, withscores=True) == \
                [(b'a2', 2), (b'a4', 4), (b'a3', 5), (b'a1', 6)]
 
+    @pytest.mark.onlynoncluster
     def test_zunionstore_min(self, r):
         r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
         r.zadd('b', {'a1': 2, 'a2': 2, 'a3': 4})
@@ -2133,6 +2222,7 @@ def test_zunionstore_min(self, r):
         assert r.zrange('d', 0, -1, withscores=True) == \
                [(b'a1', 1), (b'a2', 2), (b'a3', 3), (b'a4', 4)]
 
+    @pytest.mark.onlynoncluster
     def test_zunionstore_with_weight(self, r):
         r.zadd('a', {'a1': 1, 'a2': 1, 'a3': 1})
         r.zadd('b', {'a1': 2, 'a2': 2, 'a3': 2})
@@ -2160,6 +2250,7 @@ def test_pfadd(self, r):
         assert r.pfadd('a', *members) == 0
         assert r.pfcount('a') == len(members)
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.8.9')
     def test_pfcount(self, r):
         members = {b'1', b'2', b'3'}
@@ -2170,6 +2261,7 @@ def test_pfcount(self, r):
         assert r.pfcount('b') == len(members_b)
         assert r.pfcount('a', 'b') == len(members_b.union(members))
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.8.9')
     def test_pfmerge(self, r):
         mema = {b'1', b'2', b'3'}
@@ -2264,8 +2356,9 @@ def test_hmget(self, r):
         assert r.hmget('a', 'a', 'b', 'c') == [b'1', b'2', b'3']
 
     def test_hmset(self, r):
-        warning_message = (r'^Redis\.hmset\(\) is deprecated\. '
-                           r'Use Redis\.hset\(\) instead\.$')
+        redis_class = type(r).__name__
+        warning_message = (r'^{0}\.hmset\(\) is deprecated\. '
+                           r'Use {0}\.hset\(\) instead\.$'.format(redis_class))
         h = {b'a': b'1', b'b': b'2', b'c': b'3'}
         with pytest.warns(DeprecationWarning, match=warning_message):
             assert r.hmset('a', h)
@@ -2300,6 +2393,7 @@ def test_sort_limited(self, r):
         r.rpush('a', '3', '2', '1', '4')
         assert r.sort('a', start=1, num=2) == [b'2', b'3']
 
+    @pytest.mark.onlynoncluster
     def test_sort_by(self, r):
         r['score:1'] = 8
         r['score:2'] = 3
@@ -2307,6 +2401,7 @@ def test_sort_by(self, r):
         r.rpush('a', '3', '2', '1')
         assert r.sort('a', by='score:*') == [b'2', b'3', b'1']
 
+    @pytest.mark.onlynoncluster
     def test_sort_get(self, r):
         r['user:1'] = 'u1'
         r['user:2'] = 'u2'
@@ -2314,6 +2409,7 @@ def test_sort_get(self, r):
         r.rpush('a', '2', '3', '1')
         assert r.sort('a', get='user:*') == [b'u1', b'u2', b'u3']
 
+    @pytest.mark.onlynoncluster
     def test_sort_get_multi(self, r):
         r['user:1'] = 'u1'
         r['user:2'] = 'u2'
@@ -2322,6 +2418,7 @@ def test_sort_get_multi(self, r):
         assert r.sort('a', get=('user:*', '#')) == \
                [b'u1', b'1', b'u2', b'2', b'u3', b'3']
 
+    @pytest.mark.onlynoncluster
     def test_sort_get_groups_two(self, r):
         r['user:1'] = 'u1'
         r['user:2'] = 'u2'
@@ -2330,6 +2427,7 @@ def test_sort_get_groups_two(self, r):
         assert r.sort('a', get=('user:*', '#'), groups=True) == \
                [(b'u1', b'1'), (b'u2', b'2'), (b'u3', b'3')]
 
+    @pytest.mark.onlynoncluster
     def test_sort_groups_string_get(self, r):
         r['user:1'] = 'u1'
         r['user:2'] = 'u2'
@@ -2338,6 +2436,7 @@ def test_sort_groups_string_get(self, r):
         with pytest.raises(exceptions.DataError):
             r.sort('a', get='user:*', groups=True)
 
+    @pytest.mark.onlynoncluster
     def test_sort_groups_just_one_get(self, r):
         r['user:1'] = 'u1'
         r['user:2'] = 'u2'
@@ -2354,6 +2453,7 @@ def test_sort_groups_no_get(self, r):
         with pytest.raises(exceptions.DataError):
             r.sort('a', groups=True)
 
+    @pytest.mark.onlynoncluster
     def test_sort_groups_three_gets(self, r):
         r['user:1'] = 'u1'
         r['user:2'] = 'u2'
@@ -2378,11 +2478,13 @@ def test_sort_alpha(self, r):
         assert r.sort('a', alpha=True) == \
                [b'a', b'b', b'c', b'd', b'e']
 
+    @pytest.mark.onlynoncluster
     def test_sort_store(self, r):
         r.rpush('a', '2', '3', '1')
         assert r.sort('a', store='sorted_values') == 3
         assert r.lrange('sorted_values', 0, -1) == [b'1', b'2', b'3']
 
+    @pytest.mark.onlynoncluster
     def test_sort_all_options(self, r):
         r['user:1:username'] = 'zeus'
         r['user:2:username'] = 'titan'
@@ -2415,66 +2517,84 @@ def test_sort_issue_924(self, r):
         r.execute_command('SADD', 'issue#924', 1)
         r.execute_command('SORT', 'issue#924')
 
+    @pytest.mark.onlynoncluster
     def test_cluster_addslots(self, mock_cluster_resp_ok):
         assert mock_cluster_resp_ok.cluster('ADDSLOTS', 1) is True
 
+    @pytest.mark.onlynoncluster
     def test_cluster_count_failure_reports(self, mock_cluster_resp_int):
         assert isinstance(mock_cluster_resp_int.cluster(
             'COUNT-FAILURE-REPORTS', 'node'), int)
 
+    @pytest.mark.onlynoncluster
     def test_cluster_countkeysinslot(self, mock_cluster_resp_int):
         assert isinstance(mock_cluster_resp_int.cluster(
             'COUNTKEYSINSLOT', 2), int)
 
+    @pytest.mark.onlynoncluster
     def test_cluster_delslots(self, mock_cluster_resp_ok):
         assert mock_cluster_resp_ok.cluster('DELSLOTS', 1) is True
 
+    @pytest.mark.onlynoncluster
     def test_cluster_failover(self, mock_cluster_resp_ok):
         assert mock_cluster_resp_ok.cluster('FAILOVER', 1) is True
 
+    @pytest.mark.onlynoncluster
     def test_cluster_forget(self, mock_cluster_resp_ok):
         assert mock_cluster_resp_ok.cluster('FORGET', 1) is True
 
+    @pytest.mark.onlynoncluster
     def test_cluster_info(self, mock_cluster_resp_info):
         assert isinstance(mock_cluster_resp_info.cluster('info'), dict)
 
+    @pytest.mark.onlynoncluster
     def test_cluster_keyslot(self, mock_cluster_resp_int):
         assert isinstance(mock_cluster_resp_int.cluster(
             'keyslot', 'asdf'), int)
 
+    @pytest.mark.onlynoncluster
     def test_cluster_meet(self, mock_cluster_resp_ok):
         assert mock_cluster_resp_ok.cluster('meet', 'ip', 'port', 1) is True
 
+    @pytest.mark.onlynoncluster
     def test_cluster_nodes(self, mock_cluster_resp_nodes):
         assert isinstance(mock_cluster_resp_nodes.cluster('nodes'), dict)
 
+    @pytest.mark.onlynoncluster
     def test_cluster_replicate(self, mock_cluster_resp_ok):
         assert mock_cluster_resp_ok.cluster('replicate', 'nodeid') is True
 
+    @pytest.mark.onlynoncluster
     def test_cluster_reset(self, mock_cluster_resp_ok):
         assert mock_cluster_resp_ok.cluster('reset', 'hard') is True
 
+    @pytest.mark.onlynoncluster
     def test_cluster_saveconfig(self, mock_cluster_resp_ok):
         assert mock_cluster_resp_ok.cluster('saveconfig') is True
 
+    @pytest.mark.onlynoncluster
     def test_cluster_setslot(self, mock_cluster_resp_ok):
         assert mock_cluster_resp_ok.cluster('setslot', 1,
                                             'IMPORTING', 'nodeid') is True
 
+    @pytest.mark.onlynoncluster
     def test_cluster_slaves(self, mock_cluster_resp_slaves):
         assert isinstance(mock_cluster_resp_slaves.cluster(
             'slaves', 'nodeid'), dict)
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('3.0.0')
     @skip_if_redis_enterprise
     def test_readwrite(self, r):
         assert r.readwrite()
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('3.0.0')
     def test_readonly_invalid_cluster_state(self, r):
         with pytest.raises(exceptions.RedisError):
             r.readonly()
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('3.0.0')
     def test_readonly(self, mock_cluster_resp_ok):
         assert mock_cluster_resp_ok.readonly() is True
@@ -2701,6 +2821,7 @@ def test_geosearch_negative(self, r):
         with pytest.raises(exceptions.DataError):
             assert r.geosearch('barcelona', member='place3', radius=100, any=1)
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('6.2.0')
     def test_geosearchstore(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
@@ -2711,6 +2832,7 @@ def test_geosearchstore(self, r):
                          longitude=2.191, latitude=41.433, radius=1000)
         assert r.zrange('places_barcelona', 0, -1) == [b'place1']
 
+    @pytest.mark.onlynoncluster
     @skip_unless_arch_bits(64)
     @skip_if_server_version_lt('6.2.0')
     def test_geosearchstore_dist(self, r):
@@ -2802,6 +2924,7 @@ def test_georadius_sort(self, r):
         assert r.georadius('barcelona', 2.191, 41.433, 3000, sort='DESC') == \
                [b'place2', b'place1']
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('3.2.0')
     def test_georadius_store(self, r):
         values = (2.1909389952632, 41.433791470673, 'place1') + \
@@ -2811,6 +2934,7 @@ def test_georadius_store(self, r):
         r.georadius('barcelona', 2.191, 41.433, 1000, store='places_barcelona')
         assert r.zrange('places_barcelona', 0, -1) == [b'place1']
 
+    @pytest.mark.onlynoncluster
     @skip_unless_arch_bits(64)
     @skip_if_server_version_lt('3.2.0')
     def test_georadius_store_dist(self, r):
@@ -3658,6 +3782,7 @@ def test_memory_usage(self, r):
         r.set('foo', 'bar')
         assert isinstance(r.memory_usage('foo'), int)
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('4.0.0')
     @skip_if_redis_enterprise
     def test_module_list(self, r):
@@ -3675,10 +3800,11 @@ def test_command_count(self, r):
     def test_command(self, r):
         res = r.command()
         assert len(res) >= 100
-        cmds = [c[0].decode() for c in res]
+        cmds = list(res.keys())
         assert 'set' in cmds
         assert 'get' in cmds
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('4.0.0')
     @skip_if_redis_enterprise
     def test_module(self, r):
@@ -3734,6 +3860,7 @@ def test_restore_frequency(self, r):
         assert r.restore(key, 0, dumpdata, frequency=5)
         assert r.get(key) == b'blee!'
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('5.0.0')
     @skip_if_redis_enterprise
     def test_replicaof(self, r):
@@ -3742,6 +3869,7 @@ def test_replicaof(self, r):
         assert r.replicaof("NO", "ONE")
 
 
+@pytest.mark.onlynoncluster
 class TestBinarySave:
 
     def test_binary_get_set(self, r):
diff --git a/tests/test_connection.py b/tests/test_connection.py
index 7c44768150..cd8907d85c 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -8,6 +8,7 @@
 
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason='PythonParser only')
+@pytest.mark.onlynoncluster
 def test_invalid_response(r):
     raw = b'x'
     parser = r.connection._parser
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 521f520777..288d43dfd7 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -484,6 +484,7 @@ def test_on_connect_error(self):
         assert len(pool._available_connections) == 1
         assert not pool._available_connections[0]._sock
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.8.8')
     @skip_if_redis_enterprise
     def test_busy_loading_disconnects_socket(self, r):
@@ -495,6 +496,7 @@ def test_busy_loading_disconnects_socket(self, r):
             r.execute_command('DEBUG', 'ERROR', 'LOADING fake message')
         assert not r.connection._sock
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.8.8')
     @skip_if_redis_enterprise
     def test_busy_loading_from_pipeline_immediate_command(self, r):
@@ -511,6 +513,7 @@ def test_busy_loading_from_pipeline_immediate_command(self, r):
         assert len(pool._available_connections) == 1
         assert not pool._available_connections[0]._sock
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.8.8')
     @skip_if_redis_enterprise
     def test_busy_loading_from_pipeline(self, r):
@@ -571,6 +574,7 @@ def test_connect_invalid_password_supplied(self, r):
             r.execute_command('DEBUG', 'ERROR', 'ERR invalid password')
 
 
+@pytest.mark.onlynoncluster
 class TestMultiConnectionClient:
     @pytest.fixture()
     def r(self, request):
@@ -584,6 +588,7 @@ def test_multi_connection_command(self, r):
         assert r.get('a') == b'123'
 
 
+@pytest.mark.onlynoncluster
 class TestHealthCheck:
     interval = 60
 
diff --git a/tests/test_json.py b/tests/test_json.py
index abc5776316..092d301b2d 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -1391,6 +1391,7 @@ def test_arrindex_dollar(client):
         "None") == 0
 
 
+@pytest.mark.redismod
 def test_decoders_and_unstring():
     assert unstring("4") == 4
     assert unstring("45.55") == 45.55
diff --git a/tests/test_lock.py b/tests/test_lock.py
index fa76385221..66148edcfc 100644
--- a/tests/test_lock.py
+++ b/tests/test_lock.py
@@ -7,6 +7,7 @@
 from .conftest import _get_client
 
 
+@pytest.mark.onlynoncluster
 class TestLock:
     @pytest.fixture()
     def r_decoded(self, request):
@@ -220,6 +221,7 @@ def test_reacquiring_lock_no_longer_owned_raises_error(self, r):
             lock.reacquire()
 
 
+@pytest.mark.onlynoncluster
 class TestLockClassSelection:
     def test_lock_class_argument(self, r):
         class MyLock:
diff --git a/tests/test_monitor.py b/tests/test_monitor.py
index a8a535b59a..6c3ea33bce 100644
--- a/tests/test_monitor.py
+++ b/tests/test_monitor.py
@@ -1,3 +1,4 @@
+import pytest
 from .conftest import (
     skip_if_redis_enterprise,
     skip_ifnot_redis_enterprise,
@@ -5,6 +6,7 @@
 )
 
 
+@pytest.mark.onlynoncluster
 class TestMonitor:
     def test_wait_command_not_found(self, r):
         "Make sure the wait_for_command func works when command is not found"
diff --git a/tests/test_pipeline.py b/tests/test_pipeline.py
index 08bd40bacd..a759bc944e 100644
--- a/tests/test_pipeline.py
+++ b/tests/test_pipeline.py
@@ -59,6 +59,7 @@ def test_pipeline_no_transaction(self, r):
             assert r['b'] == b'b1'
             assert r['c'] == b'c1'
 
+    @pytest.mark.onlynoncluster
     def test_pipeline_no_transaction_watch(self, r):
         r['a'] = 0
 
@@ -70,6 +71,7 @@ def test_pipeline_no_transaction_watch(self, r):
             pipe.set('a', int(a) + 1)
             assert pipe.execute() == [True]
 
+    @pytest.mark.onlynoncluster
     def test_pipeline_no_transaction_watch_failure(self, r):
         r['a'] = 0
 
@@ -129,6 +131,7 @@ def test_exec_error_raised(self, r):
             assert pipe.set('z', 'zzz').execute() == [True]
             assert r['z'] == b'zzz'
 
+    @pytest.mark.onlynoncluster
     def test_transaction_with_empty_error_command(self, r):
         """
         Commands with custom EMPTY_ERROR functionality return their default
@@ -143,6 +146,7 @@ def test_transaction_with_empty_error_command(self, r):
                 assert result[1] == []
                 assert result[2]
 
+    @pytest.mark.onlynoncluster
     def test_pipeline_with_empty_error_command(self, r):
         """
         Commands with custom EMPTY_ERROR functionality return their default
@@ -171,6 +175,7 @@ def test_parse_error_raised(self, r):
             assert pipe.set('z', 'zzz').execute() == [True]
             assert r['z'] == b'zzz'
 
+    @pytest.mark.onlynoncluster
     def test_parse_error_raised_transaction(self, r):
         with r.pipeline() as pipe:
             pipe.multi()
@@ -186,6 +191,7 @@ def test_parse_error_raised_transaction(self, r):
             assert pipe.set('z', 'zzz').execute() == [True]
             assert r['z'] == b'zzz'
 
+    @pytest.mark.onlynoncluster
     def test_watch_succeed(self, r):
         r['a'] = 1
         r['b'] = 2
@@ -203,6 +209,7 @@ def test_watch_succeed(self, r):
             assert pipe.execute() == [True]
             assert not pipe.watching
 
+    @pytest.mark.onlynoncluster
     def test_watch_failure(self, r):
         r['a'] = 1
         r['b'] = 2
@@ -217,6 +224,7 @@ def test_watch_failure(self, r):
 
             assert not pipe.watching
 
+    @pytest.mark.onlynoncluster
     def test_watch_failure_in_empty_transaction(self, r):
         r['a'] = 1
         r['b'] = 2
@@ -230,6 +238,7 @@ def test_watch_failure_in_empty_transaction(self, r):
 
             assert not pipe.watching
 
+    @pytest.mark.onlynoncluster
     def test_unwatch(self, r):
         r['a'] = 1
         r['b'] = 2
@@ -242,6 +251,7 @@ def test_unwatch(self, r):
             pipe.get('a')
             assert pipe.execute() == [b'1']
 
+    @pytest.mark.onlynoncluster
     def test_watch_exec_no_unwatch(self, r):
         r['a'] = 1
         r['b'] = 2
@@ -262,6 +272,7 @@ def test_watch_exec_no_unwatch(self, r):
             unwatch_command = wait_for_command(r, m, 'UNWATCH')
             assert unwatch_command is None, "should not send UNWATCH"
 
+    @pytest.mark.onlynoncluster
     def test_watch_reset_unwatch(self, r):
         r['a'] = 1
 
@@ -276,6 +287,7 @@ def test_watch_reset_unwatch(self, r):
             assert unwatch_command is not None
             assert unwatch_command['command'] == 'UNWATCH'
 
+    @pytest.mark.onlynoncluster
     def test_transaction_callable(self, r):
         r['a'] = 1
         r['b'] = 2
@@ -300,6 +312,7 @@ def my_transaction(pipe):
         assert result == [True]
         assert r['c'] == b'4'
 
+    @pytest.mark.onlynoncluster
     def test_transaction_callable_returns_value_from_callable(self, r):
         def callback(pipe):
             # No need to do anything here since we only want the return value
@@ -354,6 +367,7 @@ def test_pipeline_with_bitfield(self, r):
             assert pipe == pipe2
             assert response == [True, [0, 0, 15, 15, 14], b'1']
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.0.0')
     def test_pipeline_discard(self, r):
 
diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index e2424592cd..95513a09a8 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -123,6 +123,7 @@ def test_resubscribe_to_channels_on_reconnection(self, r):
         kwargs = make_subscribe_test_data(r.pubsub(), 'channel')
         self._test_resubscribe_on_reconnection(**kwargs)
 
+    @pytest.mark.onlynoncluster
     def test_resubscribe_to_patterns_on_reconnection(self, r):
         kwargs = make_subscribe_test_data(r.pubsub(), 'pattern')
         self._test_resubscribe_on_reconnection(**kwargs)
@@ -177,6 +178,7 @@ def test_subscribe_property_with_channels(self, r):
         kwargs = make_subscribe_test_data(r.pubsub(), 'channel')
         self._test_subscribed_property(**kwargs)
 
+    @pytest.mark.onlynoncluster
     def test_subscribe_property_with_patterns(self, r):
         kwargs = make_subscribe_test_data(r.pubsub(), 'pattern')
         self._test_subscribed_property(**kwargs)
@@ -220,6 +222,7 @@ def test_sub_unsub_resub_channels(self, r):
         kwargs = make_subscribe_test_data(r.pubsub(), 'channel')
         self._test_sub_unsub_resub(**kwargs)
 
+    @pytest.mark.onlynoncluster
     def test_sub_unsub_resub_patterns(self, r):
         kwargs = make_subscribe_test_data(r.pubsub(), 'pattern')
         self._test_sub_unsub_resub(**kwargs)
@@ -307,6 +310,7 @@ def test_channel_message_handler(self, r):
         assert wait_for_message(p) is None
         assert self.message == make_message('message', 'foo', 'test message')
 
+    @pytest.mark.onlynoncluster
     def test_pattern_message_handler(self, r):
         p = r.pubsub(ignore_subscribe_messages=True)
         p.psubscribe(**{'f*': self.message_handler})
@@ -326,6 +330,9 @@ def test_unicode_channel_message_handler(self, r):
         assert wait_for_message(p) is None
         assert self.message == make_message('message', channel, 'test message')
 
+    @pytest.mark.onlynoncluster
+    # see: https://redis-py-cluster.readthedocs.io/en/stable/pubsub.html
+    # #known-limitations-with-pubsub
     def test_unicode_pattern_message_handler(self, r):
         p = r.pubsub(ignore_subscribe_messages=True)
         pattern = 'uni' + chr(4456) + '*'
@@ -401,6 +408,7 @@ def test_channel_publish(self, r):
                                                         self.channel,
                                                         self.data)
 
+    @pytest.mark.onlynoncluster
     def test_pattern_publish(self, r):
         p = r.pubsub()
         p.psubscribe(self.pattern)
@@ -473,6 +481,7 @@ def test_channel_subscribe(self, r):
 
 class TestPubSubSubcommands:
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.8.0')
     def test_pubsub_channels(self, r):
         p = r.pubsub()
@@ -482,6 +491,7 @@ def test_pubsub_channels(self, r):
         expected = [b'bar', b'baz', b'foo', b'quux']
         assert all([channel in r.pubsub_channels() for channel in expected])
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.8.0')
     def test_pubsub_numsub(self, r):
         p1 = r.pubsub()
@@ -497,7 +507,7 @@ def test_pubsub_numsub(self, r):
         assert wait_for_message(p3)['type'] == 'subscribe'
 
         channels = [(b'foo', 1), (b'bar', 2), (b'baz', 3)]
-        assert channels == r.pubsub_numsub('foo', 'bar', 'baz')
+        assert r.pubsub_numsub('foo', 'bar', 'baz') == channels
 
     @skip_if_server_version_lt('2.8.0')
     def test_pubsub_numpat(self, r):
@@ -529,6 +539,7 @@ def test_send_pubsub_ping_message(self, r):
                                                    pattern=None)
 
 
+@pytest.mark.onlynoncluster
 class TestPubSubConnectionKilled:
 
     @skip_if_server_version_lt('3.0.0')
diff --git a/tests/test_scripting.py b/tests/test_scripting.py
index 352f3bae2e..7614b1233f 100644
--- a/tests/test_scripting.py
+++ b/tests/test_scripting.py
@@ -22,6 +22,7 @@
 """
 
 
+@pytest.mark.onlynoncluster
 class TestScripting:
     @pytest.fixture(autouse=True)
     def reset_scripts(self, r):
diff --git a/tests/test_sentinel.py b/tests/test_sentinel.py
index 7f3ff0ae2a..9377d5ba65 100644
--- a/tests/test_sentinel.py
+++ b/tests/test_sentinel.py
@@ -81,16 +81,19 @@ def sentinel(request, cluster):
     return Sentinel([('foo', 26379), ('bar', 26379)])
 
 
+@pytest.mark.onlynoncluster
 def test_discover_master(sentinel, master_ip):
     address = sentinel.discover_master('mymaster')
     assert address == (master_ip, 6379)
 
 
+@pytest.mark.onlynoncluster
 def test_discover_master_error(sentinel):
     with pytest.raises(MasterNotFoundError):
         sentinel.discover_master('xxx')
 
 
+@pytest.mark.onlynoncluster
 def test_discover_master_sentinel_down(cluster, sentinel, master_ip):
     # Put first sentinel 'foo' down
     cluster.nodes_down.add(('foo', 26379))
@@ -100,6 +103,7 @@ def test_discover_master_sentinel_down(cluster, sentinel, master_ip):
     assert sentinel.sentinels[0].id == ('bar', 26379)
 
 
+@pytest.mark.onlynoncluster
 def test_discover_master_sentinel_timeout(cluster, sentinel, master_ip):
     # Put first sentinel 'foo' down
     cluster.nodes_timeout.add(('foo', 26379))
@@ -109,6 +113,7 @@ def test_discover_master_sentinel_timeout(cluster, sentinel, master_ip):
     assert sentinel.sentinels[0].id == ('bar', 26379)
 
 
+@pytest.mark.onlynoncluster
 def test_master_min_other_sentinels(cluster, master_ip):
     sentinel = Sentinel([('foo', 26379)], min_other_sentinels=1)
     # min_other_sentinels
@@ -119,18 +124,21 @@ def test_master_min_other_sentinels(cluster, master_ip):
     assert address == (master_ip, 6379)
 
 
+@pytest.mark.onlynoncluster
 def test_master_odown(cluster, sentinel):
     cluster.master['is_odown'] = True
     with pytest.raises(MasterNotFoundError):
         sentinel.discover_master('mymaster')
 
 
+@pytest.mark.onlynoncluster
 def test_master_sdown(cluster, sentinel):
     cluster.master['is_sdown'] = True
     with pytest.raises(MasterNotFoundError):
         sentinel.discover_master('mymaster')
 
 
+@pytest.mark.onlynoncluster
 def test_discover_slaves(cluster, sentinel):
     assert sentinel.discover_slaves('mymaster') == []
 
@@ -165,6 +173,7 @@ def test_discover_slaves(cluster, sentinel):
         ('slave0', 1234), ('slave1', 1234)]
 
 
+@pytest.mark.onlynoncluster
 def test_master_for(cluster, sentinel, master_ip):
     master = sentinel.master_for('mymaster', db=9)
     assert master.ping()
@@ -175,6 +184,7 @@ def test_master_for(cluster, sentinel, master_ip):
     assert master.ping()
 
 
+@pytest.mark.onlynoncluster
 def test_slave_for(cluster, sentinel):
     cluster.slaves = [
         {'ip': '127.0.0.1', 'port': 6379,
@@ -184,6 +194,7 @@ def test_slave_for(cluster, sentinel):
     assert slave.ping()
 
 
+@pytest.mark.onlynoncluster
 def test_slave_for_slave_not_found_error(cluster, sentinel):
     cluster.master['is_odown'] = True
     slave = sentinel.slave_for('mymaster', db=9)
@@ -191,6 +202,7 @@ def test_slave_for_slave_not_found_error(cluster, sentinel):
         slave.ping()
 
 
+@pytest.mark.onlynoncluster
 def test_slave_round_robin(cluster, sentinel, master_ip):
     cluster.slaves = [
         {'ip': 'slave0', 'port': 6379, 'is_odown': False, 'is_sdown': False},
@@ -206,14 +218,17 @@ def test_slave_round_robin(cluster, sentinel, master_ip):
         next(rotator)
 
 
+@pytest.mark.onlynoncluster
 def test_ckquorum(cluster, sentinel):
     assert sentinel.sentinel_ckquorum("mymaster")
 
 
+@pytest.mark.onlynoncluster
 def test_flushconfig(cluster, sentinel):
     assert sentinel.sentinel_flushconfig()
 
 
+@pytest.mark.onlynoncluster
 def test_reset(cluster, sentinel):
     cluster.master['is_odown'] = True
     assert sentinel.sentinel_reset('mymaster')
diff --git a/tox.ini b/tox.ini
index 6d4c65849b..c68dab18ea 100644
--- a/tox.ini
+++ b/tox.ini
@@ -2,11 +2,13 @@
 addopts = -s
 markers =
     redismod: run only the redis module tests
+    onlycluster: marks tests to be run only with cluster mode redis
+    onlynoncluster: marks tests to be run only with non-cluster redis
 
 [tox]
 minversion = 3.2.0
 requires = tox-docker
-envlist = {py35,py36,py37,py38,py39,pypy3}-{plain,hiredis},linters
+envlist = {redis,cluster}-{plain,hiredis}-{py35,py36,py37,py38,py39,pypy3},linters
 
 [docker:master]
 name = master
@@ -74,6 +76,21 @@ image = redisfab/lots-of-pythons
 volumes =
     bind:rw:{toxinidir}:/data
 
+[docker:redis_cluster]
+name = redis_cluster
+image = barshaul/redis-py:6.2.6-cluster
+ports =
+    16379:16379/tcp
+    16380:16380/tcp
+    16381:16381/tcp
+    16382:16382/tcp
+    16383:16383/tcp
+    16384:16384/tcp
+healtcheck_cmd = python -c "import socket;print(True) if all([0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',port)) for port in range(16379,16384)]) else False"
+volumes =
+    bind:rw:{toxinidir}/docker/cluster/redis.conf:/redis.conf
+
+
 [testenv]
 deps =
     -r {toxinidir}/requirements.txt
@@ -84,11 +101,15 @@ docker =
     sentinel_1
     sentinel_2
     sentinel_3
+    redis_cluster
     redismod
 extras =
     hiredis: hiredis
+setenv =
+    CLUSTER_URL = "redis://localhost:16379/0"
 commands =
-    pytest --cov=./ --cov-report=xml -W always {posargs}
+    redis: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' {posargs}
+    cluster: pytest --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={env:CLUSTER_URL:} {posargs}
 
 [testenv:devenv]
 skipsdist = true
@@ -100,6 +121,7 @@ docker =
     sentinel_1
     sentinel_2
     sentinel_3
+    redis_cluster
     redismod
     lots-of-pythons
 commands = /usr/bin/echo

From b600e303cd540480fd934d1b9ce8d4d248e2395b Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 25 Nov 2021 14:16:14 +0200
Subject: [PATCH 0264/1164] GitHub release improvements (#1684)

---
 .github/workflows/pypi-publish.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/pypi-publish.yaml b/.github/workflows/pypi-publish.yaml
index b842c36670..3cccb067ac 100644
--- a/.github/workflows/pypi-publish.yaml
+++ b/.github/workflows/pypi-publish.yaml
@@ -13,7 +13,7 @@ jobs:
       - name: install python
         uses: actions/setup-python@v2
         with:
-          python-version: 3.0
+          python-version: 3.9
       - name: Install dev tools
         run: |
           pip install -r dev_requirements.txt
@@ -22,7 +22,7 @@ jobs:
       - name: Build package
         run: |
           python setup.py build
-          python setup.py dist bdist_wheel
+          python setup.py sdist bdist_wheel
 
       - name: Publish to Pypi
         uses: pypa/gh-action-pypi-publish@release/v1

From e5786c218d0b2ac11f2f13be55f5c70c09d247fb Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 25 Nov 2021 14:16:35 +0200
Subject: [PATCH 0265/1164] RedisJSON 2.0.4 behaviour support (#1747)

---
 tests/conftest.py        |  5 ++--
 tests/test_json.py       | 53 +++++++++++++++++++++++-----------------
 tests/test_timeseries.py |  1 -
 3 files changed, 32 insertions(+), 27 deletions(-)

diff --git a/tests/conftest.py b/tests/conftest.py
index f29ebdebb1..ddc0834037 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -149,13 +149,12 @@ def skip_ifmodversion_lt(min_version: str, module_name: str):
 
 def skip_if_redis_enterprise(func):
     check = REDIS_INFO["enterprise"] is True
-    return pytest.mark.skipif(check, reason="Redis enterprise"
-                              )
+    return pytest.mark.skipif(check, reason="Redis enterprise")
 
 
 def skip_ifnot_redis_enterprise(func):
     check = REDIS_INFO["enterprise"] is False
-    return pytest.mark.skipif(check, reason="Redis enterprise")
+    return pytest.mark.skipif(check, reason="Not running in redis enterprise")
 
 
 def _get_client(cls, request, single_connection_client=True, flushdb=True,
diff --git a/tests/test_json.py b/tests/test_json.py
index 092d301b2d..187bfe2289 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -275,7 +275,6 @@ def test_objlen(client):
     assert len(obj) == client.json().objlen("obj")
 
 
-@pytest.mark.pipeline
 @pytest.mark.redismod
 def test_json_commands_in_pipeline(client):
     p = client.json().pipeline()
@@ -290,8 +289,9 @@ def test_json_commands_in_pipeline(client):
     client.flushdb()
     p = client.json().pipeline()
     d = {"hello": "world", "oh": "snap"}
-    p.jsonset("foo", Path.rootPath(), d)
-    p.jsonget("foo")
+    with pytest.deprecated_call():
+        p.jsonset("foo", Path.rootPath(), d)
+        p.jsonget("foo")
     p.exists("notarealkey")
     p.delete("foo")
     assert [True, d, 0, 1] == p.execute()
@@ -463,14 +463,18 @@ def test_numby_commands_dollar(client):
     client.json().set("doc1", "$", {"a": "b", "b": [
         {"a": 2}, {"a": 5.0}, {"a": "c"}]})
 
-    assert client.json().nummultby("doc1", "$..a", 2) == \
-        [None, 4, 10, None]
-    assert client.json().nummultby("doc1", "$..a", 2.5) == \
-        [None, 10.0, 25.0, None]
+    # test list
+    with pytest.deprecated_call():
+        assert client.json().nummultby("doc1", "$..a", 2) == \
+            [None, 4, 10, None]
+        assert client.json().nummultby("doc1", "$..a", 2.5) == \
+            [None, 10.0, 25.0, None]
+
     # Test single
-    assert client.json().nummultby("doc1", "$.b[1].a", 2) == [50.0]
-    assert client.json().nummultby("doc1", "$.b[2].a", 2) == [None]
-    assert client.json().nummultby("doc1", "$.b[1].a", 3) == [150.0]
+    with pytest.deprecated_call():
+        assert client.json().nummultby("doc1", "$.b[1].a", 2) == [50.0]
+        assert client.json().nummultby("doc1", "$.b[2].a", 2) == [None]
+        assert client.json().nummultby("doc1", "$.b[1].a", 3) == [150.0]
 
     # test missing keys
     with pytest.raises(exceptions.ResponseError):
@@ -485,7 +489,9 @@ def test_numby_commands_dollar(client):
     # Test legacy NUMMULTBY
     client.json().set("doc1", "$", {"a": "b", "b": [
         {"a": 2}, {"a": 5.0}, {"a": "c"}]})
-    client.json().nummultby("doc1", ".b[0].a", 3) == 6
+
+    with pytest.deprecated_call():
+        client.json().nummultby("doc1", ".b[0].a", 3) == 6
 
 
 @pytest.mark.redismod
@@ -824,9 +830,11 @@ def test_objkeys_dollar(client):
     # Test missing key
     assert client.json().objkeys("non_existing_doc", "..a") is None
 
-    # Test missing key
+    # Test non existing doc
     with pytest.raises(exceptions.ResponseError):
-        client.json().objkeys("doc1", "$.nowhere")
+        assert client.json().objkeys("non_existing_doc", "$..a") == []
+
+    assert client.json().objkeys("doc1", "$..nowhere") == []
 
 
 @pytest.mark.redismod
@@ -845,12 +853,11 @@ def test_objlen_dollar(client):
     # Test single
     assert client.json().objlen("doc1", "$.nested1.a") == [2]
 
-    # Test missing key
-    assert client.json().objlen("non_existing_doc", "$..a") is None
-
-    # Test missing path
+    # Test missing key, and path
     with pytest.raises(exceptions.ResponseError):
-        client.json().objlen("doc1", "$.nowhere")
+        client.json().objlen("non_existing_doc", "$..a")
+
+    assert client.json().objlen("doc1", "$.nowhere") == []
 
     # Test legacy
     assert client.json().objlen("doc1", ".*.a") == 2
@@ -862,8 +869,8 @@ def test_objlen_dollar(client):
     assert client.json().objlen("non_existing_doc", "..a") is None
 
     # Test missing path
-    with pytest.raises(exceptions.ResponseError):
-        client.json().objlen("doc1", ".nowhere")
+    # with pytest.raises(exceptions.ResponseError):
+    client.json().objlen("doc1", ".nowhere")
 
 
 @pytest.mark.redismod
@@ -1143,11 +1150,11 @@ def test_resp_dollar(client):
     ]
 
     # Test missing path
-    with pytest.raises(exceptions.ResponseError):
-        client.json().resp("doc1", "$.nowhere")
+    client.json().resp("doc1", "$.nowhere")
 
     # Test missing key
-    assert client.json().resp("non_existing_doc", "$..a") is None
+    # with pytest.raises(exceptions.ResponseError):
+    client.json().resp("non_existing_doc", "$..a")
 
 
 @pytest.mark.redismod
diff --git a/tests/test_timeseries.py b/tests/test_timeseries.py
index 99c60838f2..c0fb09e226 100644
--- a/tests/test_timeseries.py
+++ b/tests/test_timeseries.py
@@ -565,7 +565,6 @@ def test_query_index(client):
 
 
 @pytest.mark.redismod
-@pytest.mark.pipeline
 def test_pipeline(client):
     pipeline = client.ts().pipeline()
     pipeline.create("with_pipeline")

From 8991370332e818cf9886cec6adc1858189b04bd6 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Thu, 25 Nov 2021 13:18:25 +0100
Subject: [PATCH 0266/1164] COMMAND GETKEYS support (#1738)

---
 redis/commands/core.py | 3 +++
 tests/test_commands.py | 9 +++++++++
 2 files changed, 12 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index ad45adcfad..948655bbea 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3989,6 +3989,9 @@ def command_info(self):
     def command_count(self):
         return self.execute_command('COMMAND COUNT')
 
+    def command_getkeys(self, *args):
+        return self.execute_command('COMMAND GETKEYS', *args)
+
     def command(self):
         return self.execute_command('COMMAND')
 
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 780a1bf443..b4d371a671 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -3796,6 +3796,15 @@ def test_command_count(self, r):
         assert isinstance(res, int)
         assert res >= 100
 
+    @skip_if_server_version_lt('2.8.13')
+    def test_command_getkeys(self, r):
+        res = r.command_getkeys('MSET', 'a', 'b', 'c', 'd', 'e', 'f')
+        assert res == [b'a', b'c', b'e']
+        res = r.command_getkeys('EVAL', '"not consulted"',
+                                '3', 'key1', 'key2', 'key3',
+                                'arg1', 'arg2', 'arg3', 'argN')
+        assert res == [b'key1', b'key2', b'key3']
+
     @skip_if_server_version_lt('2.8.13')
     def test_command(self, r):
         res = r.command()

From d7b56103ed4d0ba9c05c74ca5580c72fcb70c09c Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 25 Nov 2021 14:18:33 +0200
Subject: [PATCH 0267/1164] Adding support for non-decodable commands (#1731)

---
 redis/client.py        |  8 +++++++-
 redis/commands/core.py |  5 ++++-
 redis/connection.py    | 15 +++++++++------
 redis/sentinel.py      |  4 ++--
 4 files changed, 22 insertions(+), 10 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 143ed88731..30a5c3c661 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -27,6 +27,9 @@
 SYM_EMPTY = b''
 EMPTY_RESPONSE = 'EMPTY_RESPONSE'
 
+# some responses (ie. dump) are binary, and just meant to never be decoded
+NEVER_DECODE = 'NEVER_DECODE'
+
 
 def timestamp_to_datetime(response):
     "Converts a unix timestamp to a Python datetime object"
@@ -1106,7 +1109,10 @@ def execute_command(self, *args, **options):
     def parse_response(self, connection, command_name, **options):
         "Parses a response from the Redis server"
         try:
-            response = connection.read_response()
+            if NEVER_DECODE in options:
+                response = connection.read_response(disable_decoding=True)
+            else:
+                response = connection.read_response()
         except ResponseError:
             if EMPTY_RESPONSE in options:
                 return options[EMPTY_RESPONSE]
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 948655bbea..64e3b6d37e 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1008,7 +1008,10 @@ def dump(self, name):
 
         For more information check https://redis.io/commands/dump
         """
-        return self.execute_command('DUMP', name)
+        from redis.client import NEVER_DECODE
+        options = {}
+        options[NEVER_DECODE] = []
+        return self.execute_command('DUMP', name, **options)
 
     def exists(self, *names):
         """
diff --git a/redis/connection.py b/redis/connection.py
index eac9db358f..2f91fae890 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -315,7 +315,7 @@ def on_disconnect(self):
     def can_read(self, timeout):
         return self._buffer and self._buffer.can_read(timeout)
 
-    def read_response(self):
+    def read_response(self, disable_decoding=False):
         raw = self._buffer.readline()
         if not raw:
             raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
@@ -355,8 +355,9 @@ def read_response(self):
             length = int(response)
             if length == -1:
                 return None
-            response = [self.read_response() for i in range(length)]
-        if isinstance(response, bytes):
+            response = [self.read_response(disable_decoding=disable_decoding)
+                        for i in range(length)]
+        if isinstance(response, bytes) and disable_decoding is False:
             response = self.encoder.decode(response)
         return response
 
@@ -450,7 +451,7 @@ def read_from_socket(self, timeout=SENTINEL, raise_on_timeout=True):
             if custom_timeout:
                 sock.settimeout(self._socket_timeout)
 
-    def read_response(self):
+    def read_response(self, disable_decoding=False):
         if not self._reader:
             raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
 
@@ -758,10 +759,12 @@ def can_read(self, timeout=0):
             self.connect()
         return self._parser.can_read(timeout)
 
-    def read_response(self):
+    def read_response(self, disable_decoding=False):
         """Read the response from a previously sent command"""
         try:
-            response = self._parser.read_response()
+            response = self._parser.read_response(
+                disable_decoding=disable_decoding
+            )
         except socket.timeout:
             self.disconnect()
             raise TimeoutError("Timeout reading from %s:%s" %
diff --git a/redis/sentinel.py b/redis/sentinel.py
index 17dd75bf46..3efd58fa39 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -51,9 +51,9 @@ def connect(self):
                     continue
             raise SlaveNotFoundError  # Never be here
 
-    def read_response(self):
+    def read_response(self, disable_decoding=False):
         try:
-            return super().read_response()
+            return super().read_response(disable_decoding=disable_decoding)
         except ReadOnlyError:
             if self.connection_pool.is_master:
                 # When talking to a master, a ReadOnlyError when likely

From 20c5f0fa4676c4f0fde778dae81c3f96078348b5 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 25 Nov 2021 15:37:58 +0200
Subject: [PATCH 0268/1164] Fixing COMMAND GETKEYS tests (#1750)

---
 .gitignore             | 2 ++
 tasks.py               | 6 +++---
 tests/test_commands.py | 5 +++--
 tox.ini                | 4 ++--
 4 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/.gitignore b/.gitignore
index 05c384652c..08138d7c8c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -15,3 +15,5 @@ env
 venv
 coverage.xml
 .venv
+*.xml
+.coverage*
diff --git a/tasks.py b/tasks.py
index 138ca69409..137d1771bd 100644
--- a/tasks.py
+++ b/tasks.py
@@ -41,15 +41,15 @@ def tests(c):
     with and without hiredis.
     """
     print("Starting Redis tests")
-    run("tox -e '{redis,cluster}'-'{plain,hiredis}'")
+    run("tox -e '{standalone,cluster}'-'{plain,hiredis}'")
 
 
 @task
-def redis_tests(c):
+def standalone_tests(c):
     """Run all Redis tests against the current python,
     with and without hiredis."""
     print("Starting Redis tests")
-    run("tox -e redis-'{hiredis}'")
+    run("tox -e standalone-'{hiredis}'")
 
 
 @task
diff --git a/tests/test_commands.py b/tests/test_commands.py
index b4d371a671..f526ae5dd6 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -3796,14 +3796,15 @@ def test_command_count(self, r):
         assert isinstance(res, int)
         assert res >= 100
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt('2.8.13')
     def test_command_getkeys(self, r):
         res = r.command_getkeys('MSET', 'a', 'b', 'c', 'd', 'e', 'f')
-        assert res == [b'a', b'c', b'e']
+        assert res == ['a', 'c', 'e']
         res = r.command_getkeys('EVAL', '"not consulted"',
                                 '3', 'key1', 'key2', 'key3',
                                 'arg1', 'arg2', 'arg3', 'argN')
-        assert res == [b'key1', b'key2', b'key3']
+        assert res == ['key1', 'key2', 'key3']
 
     @skip_if_server_version_lt('2.8.13')
     def test_command(self, r):
diff --git a/tox.ini b/tox.ini
index c68dab18ea..0a94db823b 100644
--- a/tox.ini
+++ b/tox.ini
@@ -3,12 +3,12 @@ addopts = -s
 markers =
     redismod: run only the redis module tests
     onlycluster: marks tests to be run only with cluster mode redis
-    onlynoncluster: marks tests to be run only with non-cluster redis
+    onlynoncluster: marks tests to be run only with standalone redis
 
 [tox]
 minversion = 3.2.0
 requires = tox-docker
-envlist = {redis,cluster}-{plain,hiredis}-{py35,py36,py37,py38,py39,pypy3},linters
+envlist = {standalone,cluster}-{plain,hiredis}-{py35,py36,py37,py38,py39,pypy3},linters
 
 [docker:master]
 name = master

From 3de2e6b6b1bc061d875d36a6f40598453ce85c58 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Thu, 25 Nov 2021 14:38:21 +0100
Subject: [PATCH 0269/1164] Improve code coverage for aggregation tests (#1713)

---
 redis/commands/search/aggregation.py |   6 -
 tests/test_search.py                 | 322 ++++++++++++++++++++++-----
 2 files changed, 264 insertions(+), 64 deletions(-)

diff --git a/redis/commands/search/aggregation.py b/redis/commands/search/aggregation.py
index b391d1f55b..3d71329c44 100644
--- a/redis/commands/search/aggregation.py
+++ b/redis/commands/search/aggregation.py
@@ -345,12 +345,6 @@ def cursor(self, count=0, max_idle=0.0):
         self._cursor = args
         return self
 
-    def _limit_2_args(self, limit):
-        if limit[1]:
-            return ["LIMIT"] + [str(x) for x in limit]
-        else:
-            return []
-
     def build_args(self):
         # @foo:bar ...
         ret = [self._query]
diff --git a/tests/test_search.py b/tests/test_search.py
index d1fc75fb9d..0cba3b74f6 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -82,8 +82,8 @@ def createIndex(client, num_docs=100, definition=None):
     try:
         client.create_index(
             (TextField("play", weight=5.0),
-                TextField("txt"),
-                NumericField("chapter")),
+             TextField("txt"),
+             NumericField("chapter")),
             definition=definition,
         )
     except redis.ResponseError:
@@ -320,8 +320,8 @@ def test_stopwords(client):
 def test_filters(client):
     client.ft().create_index(
         (TextField("txt"),
-            NumericField("num"),
-            GeoField("loc"))
+         NumericField("num"),
+         GeoField("loc"))
     )
     client.ft().add_document(
         "doc1",
@@ -379,7 +379,7 @@ def test_payloads_with_no_content(client):
 def test_sort_by(client):
     client.ft().create_index(
         (TextField("txt"),
-            NumericField("num", sortable=True))
+         NumericField("num", sortable=True))
     )
     client.ft().add_document("doc1", txt="foo bar", num=1)
     client.ft().add_document("doc2", txt="foo baz", num=2)
@@ -424,7 +424,7 @@ def test_example(client):
     # Creating the index definition and schema
     client.ft().create_index(
         (TextField("title", weight=5.0),
-            TextField("body"))
+         TextField("body"))
     )
 
     # Indexing a document
@@ -552,8 +552,8 @@ def test_no_index(client):
 def test_partial(client):
     client.ft().create_index(
         (TextField("f1"),
-            TextField("f2"),
-            TextField("f3"))
+         TextField("f2"),
+         TextField("f3"))
     )
     client.ft().add_document("doc1", f1="f1_val", f2="f2_val")
     client.ft().add_document("doc2", f1="f1_val", f2="f2_val")
@@ -574,8 +574,8 @@ def test_partial(client):
 def test_no_create(client):
     client.ft().create_index(
         (TextField("f1"),
-            TextField("f2"),
-            TextField("f3"))
+         TextField("f2"),
+         TextField("f3"))
     )
     client.ft().add_document("doc1", f1="f1_val", f2="f2_val")
     client.ft().add_document("doc2", f1="f1_val", f2="f2_val")
@@ -604,8 +604,8 @@ def test_no_create(client):
 def test_explain(client):
     client.ft().create_index(
         (TextField("f1"),
-            TextField("f2"),
-            TextField("f3"))
+         TextField("f2"),
+         TextField("f3"))
     )
     res = client.ft().explain("@f3:f3_val @f2:f2_val @f1:f1_val")
     assert res
@@ -629,8 +629,8 @@ def test_summarize(client):
     doc = sorted(client.ft().search(q).docs)[0]
     assert "<b>Henry</b> IV" == doc.play
     assert (
-        "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
-        == doc.txt
+            "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+            == doc.txt
     )
 
     q = Query("king henry").paging(0, 1).summarize().highlight()
@@ -638,8 +638,8 @@ def test_summarize(client):
     doc = sorted(client.ft().search(q).docs)[0]
     assert "<b>Henry</b> ... " == doc.play
     assert (
-        "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
-        == doc.txt
+            "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+            == doc.txt
     )
 
 
@@ -812,10 +812,10 @@ def test_spell_check(client):
     res = client.ft().spellcheck("lorm", include="dict")
     assert len(res["lorm"]) == 3
     assert (
-        res["lorm"][0]["suggestion"],
-        res["lorm"][1]["suggestion"],
-        res["lorm"][2]["suggestion"],
-    ) == ("lorem", "lore", "lorm")
+               res["lorm"][0]["suggestion"],
+               res["lorm"][1]["suggestion"],
+               res["lorm"][2]["suggestion"],
+           ) == ("lorem", "lore", "lorm")
     assert (res["lorm"][0]["score"], res["lorm"][1]["score"]) == ("0.5", "0")
 
     # test spellcheck exclude
@@ -873,7 +873,7 @@ def test_scorer(client):
     )
     client.ft().add_document(
         "doc2",
-        description="Quick alice was beginning to get very tired of sitting by her quick sister on the bank, and of having nothing to do.",  # noqa
+        description="Quick alice was beginning to get very tired of sitting by her quick sister on the bank, and of having nothing to do.", # noqa
     )
 
     # default scorer is TFIDF
@@ -930,7 +930,7 @@ def test_config(client):
 
 
 @pytest.mark.redismod
-def test_aggregations(client):
+def test_aggregations_groupby(client):
     # Creating the index definition and schema
     client.ft().create_index(
         (
@@ -967,36 +967,242 @@ def test_aggregations(client):
     req = aggregations.AggregateRequest("redis").group_by(
         "@parent",
         reducers.count(),
+    )
+
+    res = client.ft().aggregate(req).rows[0]
+    assert res[1] == "redis"
+    assert res[3] == "3"
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
         reducers.count_distinct("@title"),
+    )
+
+    res = client.ft().aggregate(req).rows[0]
+    assert res[1] == "redis"
+    assert res[3] == "3"
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
         reducers.count_distinctish("@title"),
+    )
+
+    res = client.ft().aggregate(req).rows[0]
+    assert res[1] == "redis"
+    assert res[3] == "3"
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
         reducers.sum("@random_num"),
+    )
+
+    res = client.ft().aggregate(req).rows[0]
+    assert res[1] == "redis"
+    assert res[3] == "21"  # 10+8+3
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
         reducers.min("@random_num"),
+    )
+
+    res = client.ft().aggregate(req).rows[0]
+    assert res[1] == "redis"
+    assert res[3] == "3"  # min(10,8,3)
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
         reducers.max("@random_num"),
+    )
+
+    res = client.ft().aggregate(req).rows[0]
+    assert res[1] == "redis"
+    assert res[3] == "10"  # max(10,8,3)
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
         reducers.avg("@random_num"),
+    )
+
+    res = client.ft().aggregate(req).rows[0]
+    assert res[1] == "redis"
+    assert res[3] == "7"  # (10+3+8)/3
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
         reducers.stddev("random_num"),
+    )
+
+    res = client.ft().aggregate(req).rows[0]
+    assert res[1] == "redis"
+    assert res[3] == "3.60555127546"
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
         reducers.quantile("@random_num", 0.5),
+    )
+
+    res = client.ft().aggregate(req).rows[0]
+    assert res[1] == "redis"
+    assert res[3] == "10"
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
         reducers.tolist("@title"),
-        reducers.first_value("@title"),
-        reducers.random_sample("@title", 2),
     )
 
+    res = client.ft().aggregate(req).rows[0]
+    assert res[1] == "redis"
+    assert res[3] == ["RediSearch", "RedisAI", "RedisJson"]
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
+        reducers.first_value("@title").alias("first"),
+    )
+
+    res = client.ft().aggregate(req).rows[0]
+    assert res == ['parent', 'redis', 'first', 'RediSearch']
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
+        reducers.random_sample("@title", 2).alias("random"),
+    )
+
+    res = client.ft().aggregate(req).rows[0]
+    assert res[1] == "redis"
+    assert res[2] == "random"
+    assert len(res[3]) == 2
+    assert res[3][0] in ["RediSearch", "RedisAI", "RedisJson"]
+
+
+@pytest.mark.redismod
+def test_aggregations_sort_by_and_limit(client):
+    client.ft().create_index(
+        (
+            TextField("t1"),
+            TextField("t2"),
+        )
+    )
+
+    client.ft().client.hset("doc1", mapping={'t1': 'a', 't2': 'b'})
+    client.ft().client.hset("doc2", mapping={'t1': 'b', 't2': 'a'})
+
+    # test sort_by using SortDirection
+    req = aggregations.AggregateRequest("*") \
+        .sort_by(aggregations.Asc("@t2"), aggregations.Desc("@t1"))
+    res = client.ft().aggregate(req)
+    assert res.rows[0] == ['t2', 'a', 't1', 'b']
+    assert res.rows[1] == ['t2', 'b', 't1', 'a']
+
+    # test sort_by without SortDirection
+    req = aggregations.AggregateRequest("*") \
+        .sort_by("@t1")
+    res = client.ft().aggregate(req)
+    assert res.rows[0] == ['t1', 'a']
+    assert res.rows[1] == ['t1', 'b']
+
+    # test sort_by with max
+    req = aggregations.AggregateRequest("*") \
+        .sort_by("@t1", max=1)
+    res = client.ft().aggregate(req)
+    assert len(res.rows) == 1
+
+    # test limit
+    req = aggregations.AggregateRequest("*") \
+        .sort_by("@t1").limit(1, 1)
     res = client.ft().aggregate(req)
+    assert len(res.rows) == 1
+    assert res.rows[0] == ['t1', 'b']
 
-    res = res.rows[0]
-    assert len(res) == 26
-    assert "redis" == res[1]
-    assert "3" == res[3]
-    assert "3" == res[5]
-    assert "3" == res[7]
-    assert "21" == res[9]
-    assert "3" == res[11]
-    assert "10" == res[13]
-    assert "7" == res[15]
-    assert "3.60555127546" == res[17]
-    assert "10" == res[19]
-    assert ["RediSearch", "RedisAI", "RedisJson"] == res[21]
-    assert "RediSearch" == res[23]
-    assert 2 == len(res[25])
+
+@pytest.mark.redismod
+def test_aggregations_load(client):
+    client.ft().create_index(
+        (
+            TextField("t1"),
+            TextField("t2"),
+        )
+    )
+
+    client.ft().client.hset("doc1", mapping={'t1': 'hello', 't2': 'world'})
+
+    # load t1
+    req = aggregations.AggregateRequest("*").load("t1")
+    res = client.ft().aggregate(req)
+    assert res.rows[0] == ['t1', 'hello']
+
+    # load t2
+    req = aggregations.AggregateRequest("*").load("t2")
+    res = client.ft().aggregate(req)
+    assert res.rows[0] == ['t2', 'world']
+
+
+@pytest.mark.redismod
+def test_aggregations_apply(client):
+    client.ft().create_index(
+        (
+            TextField("PrimaryKey", sortable=True),
+            NumericField("CreatedDateTimeUTC", sortable=True),
+        )
+    )
+
+    client.ft().client.hset(
+        "doc1",
+        mapping={
+            'PrimaryKey': '9::362330',
+            'CreatedDateTimeUTC': '637387878524969984'
+        }
+    )
+    client.ft().client.hset(
+        "doc2",
+        mapping={
+            'PrimaryKey': '9::362329',
+            'CreatedDateTimeUTC': '637387875859270016'
+        }
+    )
+
+    req = aggregations.AggregateRequest("*") \
+        .apply(CreatedDateTimeUTC='@CreatedDateTimeUTC * 10')
+    res = client.ft().aggregate(req)
+    assert res.rows[0] == ['CreatedDateTimeUTC', '6373878785249699840']
+    assert res.rows[1] == ['CreatedDateTimeUTC', '6373878758592700416']
+
+
+@pytest.mark.redismod
+def test_aggregations_filter(client):
+    client.ft().create_index(
+        (
+            TextField("name", sortable=True),
+            NumericField("age", sortable=True),
+        )
+    )
+
+    client.ft().client.hset(
+        "doc1",
+        mapping={
+            'name': 'bar',
+            'age': '25'
+        }
+    )
+    client.ft().client.hset(
+        "doc2",
+        mapping={
+            'name': 'foo',
+            'age': '19'
+        }
+    )
+
+    req = aggregations.AggregateRequest("*") \
+        .filter("@name=='foo' && @age < 20")
+    res = client.ft().aggregate(req)
+    assert len(res.rows) == 1
+    assert res.rows[0] == ['name', 'foo', 'age', '19']
+
+    req = aggregations.AggregateRequest("*") \
+        .filter("@age > 15").sort_by("@age")
+    res = client.ft().aggregate(req)
+    assert len(res.rows) == 2
+    assert res.rows[0] == ['age', '19']
+    assert res.rows[1] == ['age', '25']
 
 
 @pytest.mark.redismod
@@ -1020,25 +1226,25 @@ def test_index_definition(client):
     )
 
     assert [
-        "ON",
-        "JSON",
-        "PREFIX",
-        2,
-        "hset:",
-        "henry",
-        "FILTER",
-        "@f1==32",
-        "LANGUAGE_FIELD",
-        "play",
-        "LANGUAGE",
-        "English",
-        "SCORE_FIELD",
-        "chapter",
-        "SCORE",
-        0.5,
-        "PAYLOAD_FIELD",
-        "txt",
-    ] == definition.args
+               "ON",
+               "JSON",
+               "PREFIX",
+               2,
+               "hset:",
+               "henry",
+               "FILTER",
+               "@f1==32",
+               "LANGUAGE_FIELD",
+               "play",
+               "LANGUAGE",
+               "English",
+               "SCORE_FIELD",
+               "chapter",
+               "SCORE",
+               0.5,
+               "PAYLOAD_FIELD",
+               "txt",
+           ] == definition.args
 
     createIndex(client.ft(), num_docs=500, definition=definition)
 

From 393cd6280c6fb5394cc512ae15617236ecddac2e Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Thu, 25 Nov 2021 14:45:19 +0100
Subject: [PATCH 0270/1164] Support RediSearch FT.PROFILE command (#1727)

---
 redis/commands/helpers.py         | 41 ++++++++++++++++++++++--
 redis/commands/search/commands.py | 53 ++++++++++++++++++++++++++++---
 tests/test_helpers.py             | 26 ++++++++++++++-
 tests/test_search.py              | 43 +++++++++++++++++++++++++
 4 files changed, 156 insertions(+), 7 deletions(-)

diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
index 46eb83d603..5e8ff49d9b 100644
--- a/redis/commands/helpers.py
+++ b/redis/commands/helpers.py
@@ -35,9 +35,12 @@ def delist(x):
 
 
 def parse_to_list(response):
-    """Optimistally parse the response to a list.
-    """
+    """Optimistically parse the response to a list."""
     res = []
+
+    if response is None:
+        return res
+
     for item in response:
         try:
             res.append(int(item))
@@ -51,6 +54,40 @@ def parse_to_list(response):
     return res
 
 
+def parse_list_to_dict(response):
+    res = {}
+    for i in range(0, len(response), 2):
+        if isinstance(response[i], list):
+            res['Child iterators'].append(parse_list_to_dict(response[i]))
+        elif isinstance(response[i+1], list):
+            res['Child iterators'] = [parse_list_to_dict(response[i+1])]
+        else:
+            try:
+                res[response[i]] = float(response[i+1])
+            except (TypeError, ValueError):
+                res[response[i]] = response[i+1]
+    return res
+
+
+def parse_to_dict(response):
+    if response is None:
+        return {}
+
+    res = {}
+    for det in response:
+        if isinstance(det[1], list):
+            res[det[0]] = parse_list_to_dict(det[1])
+        else:
+            try:  # try to set the attribute. may be provided without value
+                try:  # try to convert the value to float
+                    res[det[0]] = float(det[1])
+                except (TypeError, ValueError):
+                    res[det[0]] = det[1]
+            except IndexError:
+                pass
+    return res
+
+
 def random_string(length=10):
     """
     Returns a random N character long string.
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 0cee2ade4e..ed58255fec 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -7,6 +7,7 @@
 from ._util import to_string
 from .aggregation import AggregateRequest, AggregateResult, Cursor
 from .suggestion import SuggestionParser
+from ..helpers import parse_to_dict
 
 NUMERIC = "NUMERIC"
 
@@ -20,6 +21,7 @@
 EXPLAINCLI_CMD = "FT.EXPLAINCLI"
 DEL_CMD = "FT.DEL"
 AGGREGATE_CMD = "FT.AGGREGATE"
+PROFILE_CMD = "FT.PROFILE"
 CURSOR_CMD = "FT.CURSOR"
 SPELLCHECK_CMD = "FT.SPELLCHECK"
 DICT_ADD_CMD = "FT.DICTADD"
@@ -382,11 +384,11 @@ def explain_cli(self, query):  # noqa
 
     def aggregate(self, query):
         """
-        Issue an aggregation query
+        Issue an aggregation query.
 
         ### Parameters
 
-        **query**: This can be either an `AggeregateRequest`, or a `Cursor`
+        **query**: This can be either an `AggregateRequest`, or a `Cursor`
 
         An `AggregateResult` object is returned. You can access the rows from
         its `rows` property, which will always yield the rows of the result.
@@ -401,6 +403,9 @@ def aggregate(self, query):
             raise ValueError("Bad query", query)
 
         raw = self.execute_command(*cmd)
+        return self._get_AggregateResult(raw, query, has_cursor)
+
+    def _get_AggregateResult(self, raw, query, has_cursor):
         if has_cursor:
             if isinstance(query, Cursor):
                 query.cid = raw[1]
@@ -418,8 +423,48 @@ def aggregate(self, query):
             schema = None
             rows = raw[1:]
 
-        res = AggregateResult(rows, cursor, schema)
-        return res
+        return AggregateResult(rows, cursor, schema)
+
+    def profile(self, query, limited=False):
+        """
+        Performs a search or aggregate command and collects performance
+        information.
+
+        ### Parameters
+
+        **query**: This can be either an `AggregateRequest`, `Query` or
+        string.
+        **limited**: If set to True, removes details of reader iterator.
+
+        """
+        st = time.time()
+        cmd = [PROFILE_CMD, self.index_name, ""]
+        if limited:
+            cmd.append("LIMITED")
+        cmd.append('QUERY')
+
+        if isinstance(query, AggregateRequest):
+            cmd[2] = "AGGREGATE"
+            cmd += query.build_args()
+        elif isinstance(query, Query):
+            cmd[2] = "SEARCH"
+            cmd += query.get_args()
+        else:
+            raise ValueError("Must provide AggregateRequest object or "
+                             "Query object.")
+
+        res = self.execute_command(*cmd)
+
+        if isinstance(query, AggregateRequest):
+            result = self._get_AggregateResult(res[0], query, query._cursor)
+        else:
+            result = Result(res[0],
+                            not query._no_content,
+                            duration=(time.time() - st) * 1000.0,
+                            has_payload=query._with_payloads,
+                            with_scores=query._with_scores,)
+
+        return result, parse_to_dict(res[1])
 
     def spellcheck(self, query, distance=None, include=None, exclude=None):
         """
diff --git a/tests/test_helpers.py b/tests/test_helpers.py
index 467e00c1fd..402eccf0a2 100644
--- a/tests/test_helpers.py
+++ b/tests/test_helpers.py
@@ -5,7 +5,8 @@
     nativestr,
     parse_to_list,
     quote_string,
-    random_string
+    random_string,
+    parse_to_dict
 )
 
 
@@ -19,11 +20,34 @@ def test_list_or_args():
 
 
 def test_parse_to_list():
+    assert parse_to_list(None) == []
     r = ["hello", b"my name", "45", "555.55", "is simon!", None]
     assert parse_to_list(r) == \
         ["hello", "my name", 45, 555.55, "is simon!", None]
 
 
+def test_parse_to_dict():
+    assert parse_to_dict(None) == {}
+    r = [['Some number', '1.0345'],
+         ['Some string', 'hello'],
+         ['Child iterators',
+          ['Time', '0.2089', 'Counter', 3, 'Child iterators',
+           ['Type', 'bar', 'Time', '0.0729', 'Counter', 3],
+           ['Type', 'barbar', 'Time', '0.058', 'Counter', 3]]]]
+    assert parse_to_dict(r) == {
+        'Child iterators': {
+            'Child iterators': [
+                {'Counter': 3.0, 'Time': 0.0729, 'Type': 'bar'},
+                {'Counter': 3.0, 'Time': 0.058, 'Type': 'barbar'}
+            ],
+            'Counter': 3.0,
+            'Time': 0.2089
+        },
+        'Some number': 1.0345,
+        'Some string': 'hello'
+    }
+
+
 def test_nativestr():
     assert nativestr('teststr') == 'teststr'
     assert nativestr(b'teststr') == 'teststr'
diff --git a/tests/test_search.py b/tests/test_search.py
index 0cba3b74f6..b65ac8dcbf 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1519,3 +1519,46 @@ def test_json_with_jsonpath(client):
     assert res.docs[0].id == "doc:1"
     with pytest.raises(Exception):
         res.docs[0].name_unsupported
+
+
+@pytest.mark.redismod
+def test_profile(client):
+    client.ft().create_index((TextField('t'),))
+    client.ft().client.hset('1', 't', 'hello')
+    client.ft().client.hset('2', 't', 'world')
+
+    # check using Query
+    q = Query('hello|world').no_content()
+    res, det = client.ft().profile(q)
+    assert det['Iterators profile']['Counter'] == 2.0
+    assert len(det['Iterators profile']['Child iterators']) == 2
+    assert det['Iterators profile']['Type'] == 'UNION'
+    assert det['Parsing time'] < 0.3
+    assert len(res.docs) == 2  # check also the search result
+
+    # check using AggregateRequest
+    req = aggregations.AggregateRequest("*").load("t")\
+        .apply(prefix="startswith(@t, 'hel')")
+    res, det = client.ft().profile(req)
+    assert det['Iterators profile']['Counter'] == 2.0
+    assert det['Iterators profile']['Type'] == 'WILDCARD'
+    assert det['Parsing time'] < 0.3
+    assert len(res.rows) == 2  # check also the search result
+
+
+@pytest.mark.redismod
+def test_profile_limited(client):
+    client.ft().create_index((TextField('t'),))
+    client.ft().client.hset('1', 't', 'hello')
+    client.ft().client.hset('2', 't', 'hell')
+    client.ft().client.hset('3', 't', 'help')
+    client.ft().client.hset('4', 't', 'helowa')
+
+    q = Query('%hell% hel*')
+    res, det = client.ft().profile(q, limited=True)
+    assert det['Iterators profile']['Child iterators'][0]['Child iterators'] \
+           == 'The number of iterators in the union is 3'
+    assert det['Iterators profile']['Child iterators'][1]['Child iterators'] \
+           == 'The number of iterators in the union is 4'
+    assert det['Iterators profile']['Type'] == 'INTERSECT'
+    assert len(res.docs) == 3  # check also the search result

From f4519f3b7f1f7314b5d342be989df1c4365954b9 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 25 Nov 2021 16:03:30 +0200
Subject: [PATCH 0271/1164] Splitting documentation for read the docs (#1743)

---
 README.md                             |  2 +-
 docs/backoff.rst                      |  5 ++
 docs/conf.py                          | 22 ++++++--
 docs/connections.rst                  | 12 +++++
 docs/exceptions.rst                   |  7 +++
 docs/genindex.rst                     |  2 +
 docs/index.rst                        | 78 +++++++++++++++++++--------
 docs/lock.rst                         |  5 ++
 docs/redis_core_commands.rst          | 14 +++++
 docs/redismodules.rst                 | 19 +++++++
 docs/requirements.txt                 |  1 +
 docs/retry.rst                        |  5 ++
 docs/sentinel_commands.rst            | 20 +++++++
 redis/commands/timeseries/commands.py | 60 ++++++++++-----------
 tasks.py                              |  6 +++
 tox.ini                               | 11 +++-
 16 files changed, 209 insertions(+), 60 deletions(-)
 create mode 100644 docs/backoff.rst
 create mode 100644 docs/connections.rst
 create mode 100644 docs/exceptions.rst
 create mode 100644 docs/genindex.rst
 create mode 100644 docs/lock.rst
 create mode 100644 docs/redis_core_commands.rst
 create mode 100644 docs/redismodules.rst
 create mode 100644 docs/retry.rst
 create mode 100644 docs/sentinel_commands.rst

diff --git a/README.md b/README.md
index 6e7d964b2b..d068c68f14 100644
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@ The Python interface to the Redis key-value store.
 [![codecov](https://codecov.io/gh/redis/redis-py/branch/master/graph/badge.svg?token=yenl5fzxxr)](https://codecov.io/gh/redis/redis-py)
 [![Total alerts](https://img.shields.io/lgtm/alerts/g/redis/redis-py.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/redis/redis-py/alerts/)
 
-[Installation](##installation) | [Contributing](##contributing) |  [Getting Started](##getting-started) | [Connecting To Redis](##connecting-to-redis)
+[Installation](#installation) | [Contributing](#contributing) |  [Getting Started](#getting-started) | [Connecting To Redis](#connecting-to-redis)
 
 ---------------------------------------------
 
diff --git a/docs/backoff.rst b/docs/backoff.rst
new file mode 100644
index 0000000000..e640b5682e
--- /dev/null
+++ b/docs/backoff.rst
@@ -0,0 +1,5 @@
+Backoff
+#############
+
+.. automodule:: redis.backoff
+    :members: 
\ No newline at end of file
diff --git a/docs/conf.py b/docs/conf.py
index f497e3da15..8520969d24 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -29,7 +29,8 @@
 extensions = [
     "sphinx.ext.autodoc",
     "sphinx.ext.doctest",
-    "sphinx.ext.viewcode"
+    "sphinx.ext.viewcode",
+    "sphinx.ext.autosectionlabel",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -53,10 +54,11 @@
 # built documents.
 #
 # The short X.Y version.
-version = "4.0"
+import redis
+version = '.'.join(redis.__version__.split(".")[0:2])
 
 # The full version, including alpha/beta/rc tags.
-release = "4.0.0"
+release = redis.__version__
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -93,17 +95,27 @@
 # A list of ignored prefixes for module index sorting.
 # modindex_common_prefix = []
 
+nitpicky = True
+
 
 # -- Options for HTML output --------------------------------------------------
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = "default"
+html_theme = "sphinx_rtd_theme"
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
-# html_theme_options = {}
+html_theme_options = {
+    'display_version': True,
+    'prev_next_buttons_location': 'bottom',
+    'style_external_links': False,
+    # Toc options
+    'collapse_navigation': True,
+    'sticky_navigation': True,
+    'navigation_depth': 4,
+}
 
 # Add any paths that contain custom themes here, relative to this directory.
 # html_theme_path = []
diff --git a/docs/connections.rst b/docs/connections.rst
new file mode 100644
index 0000000000..973821bb07
--- /dev/null
+++ b/docs/connections.rst
@@ -0,0 +1,12 @@
+Connecting to Redis
+#####################
+
+Generic Client
+**************
+.. autoclass:: redis.client.Redis
+    :members:
+
+Connection Pools
+*****************
+.. autoclass:: redis.connection.ConnectionPool
+    :members:
\ No newline at end of file
diff --git a/docs/exceptions.rst b/docs/exceptions.rst
new file mode 100644
index 0000000000..b8aeb33e49
--- /dev/null
+++ b/docs/exceptions.rst
@@ -0,0 +1,7 @@
+
+
+Exceptions
+##########
+
+.. automodule:: redis.exceptions
+    :members:
\ No newline at end of file
diff --git a/docs/genindex.rst b/docs/genindex.rst
new file mode 100644
index 0000000000..c1f8355121
--- /dev/null
+++ b/docs/genindex.rst
@@ -0,0 +1,2 @@
+Module Index
+============
\ No newline at end of file
diff --git a/docs/index.rst b/docs/index.rst
index 8af5385da3..392acadf5b 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -6,37 +6,71 @@
 Welcome to redis-py's documentation!
 ====================================
 
-Indices and tables
-------------------
+Getting Started
+****************
 
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
+`redis-py <https://pypi.org/project/redis>`_ requires a running Redis server, and Python 3.6+. See the `Redis
+quickstart <https://redis.io/topics/quickstart>`_ for Redis installation instructions.
 
-Contents:
----------
+redis-py can be installed using pip via ``pip install redis``.
+
+
+Quickly connecting to redis
+************
+
+There are two quick ways to connect to Redis.
+
+Assuming you run Redis on localhost:6379 (the default)::
+   import redis
+   r = redis.Redis()
+   r.ping()
+
+Running redis on foo.bar.com, port 12345::
+   import redis
+   r = redis.Redis(host='foo.bar.com', port=12345)
+   r.ping()
+
+Another example with foo.bar.com, port 12345::
+   import redis
+   r = redis.from_url('redis://foo.bar.com:12345')
+   r.ping()
+
+After that, you probably want to `run redis commands <redis_core_commands.html>`_.
 
 .. toctree::
-   :maxdepth: 2
+   :hidden:
+
+   genindex
 
-.. automodule:: redis
-   :members:
+Redis Command Functions
+***********************
+.. toctree::
+   :maxdepth: 2
 
-.. automodule:: redis.backoff
-   :members:
+   redis_core_commands
+   sentinel_commands
+   redismodules
 
-.. automodule:: redis.connection
-   :members:
+Module Documentation
+********************
+.. toctree::
+   :maxdepth: 1
 
-.. automodule:: redis.commands
-   :members:
+   backoff
+   connections
+   exceptions
+   lock
+   retry
 
-.. automodule:: redis.exceptions
-   :members:
+Contributing
+*************
 
-.. automodule:: redis.lock
-   :members:
+- `How to contribute <https://github.com/redis/redis-py/blob/master/CONTRIBUTING.md>`_
+- `Issue Tracker <https://github.com/redis/redis-py/issues>`_
+- `Source Code <https://github.com/redis/redis-py/>`_
+- `Release History <https://github.com/redis/redis-py/releases/>`_
 
-.. automodule:: redis.sentinel
-   :members:
+License
+*******
 
+This projectis licensed under the `MIT license <https://github.com/redis/redis-py/blob/master/LICENSE>`_.
\ No newline at end of file
diff --git a/docs/lock.rst b/docs/lock.rst
new file mode 100644
index 0000000000..cce0867a91
--- /dev/null
+++ b/docs/lock.rst
@@ -0,0 +1,5 @@
+Lock
+#########
+
+.. automodule:: redis.lock
+    :members: 
\ No newline at end of file
diff --git a/docs/redis_core_commands.rst b/docs/redis_core_commands.rst
new file mode 100644
index 0000000000..edfd7fe939
--- /dev/null
+++ b/docs/redis_core_commands.rst
@@ -0,0 +1,14 @@
+Redis Core Commands
+####################
+
+The following functions can be used to replicate their equivalent `Redis command <https://redis.io/commands>`_.  Generally they can be used as functions on your redis connection.  For the simplest example, see below:
+
+Getting and settings data in redis::
+
+   import redis
+   r = redis.Redis(decode_responses=True)
+   r.set('mykey', 'thevalueofmykey')
+   r.get('mykey')
+
+.. autoclass:: redis.commands.core.CoreCommands
+   :members:
\ No newline at end of file
diff --git a/docs/redismodules.rst b/docs/redismodules.rst
new file mode 100644
index 0000000000..da8c36b7b4
--- /dev/null
+++ b/docs/redismodules.rst
@@ -0,0 +1,19 @@
+Redis Modules Commands
+######################
+
+Accessing redis module commands requires the installation of the supported `Redis module <https://docs.redis.com/latest/modules/>`_. For a quick start with redis modules, try the `Redismod docker <https://hub.docker.com/r/redislabs/redismod>`_.
+
+RedisTimeSeries Commands
+************************
+.. automodule:: redis.commands.timeseries.commands
+   :members: TimeSeriesCommands
+
+RedisJSON Commands
+******************
+.. automodule:: redis.commands.json.commands
+   :members: JSONCommands
+
+RediSearch Commands
+*******************
+.. automodule:: redis.commands.search.commands
+   :members: SearchCommands
\ No newline at end of file
diff --git a/docs/requirements.txt b/docs/requirements.txt
index 2e1c4fbdce..6dc905f6b3 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,2 +1,3 @@
 sphinx<2
 docutils<0.18
+sphinx-rtd-theme
diff --git a/docs/retry.rst b/docs/retry.rst
new file mode 100644
index 0000000000..2b4f22c2f6
--- /dev/null
+++ b/docs/retry.rst
@@ -0,0 +1,5 @@
+Retry Helpers
+#############
+
+.. automodule:: redis.retry
+    :members: 
\ No newline at end of file
diff --git a/docs/sentinel_commands.rst b/docs/sentinel_commands.rst
new file mode 100644
index 0000000000..e5be11e85a
--- /dev/null
+++ b/docs/sentinel_commands.rst
@@ -0,0 +1,20 @@
+Redis Sentinel Commands
+=======================
+
+redis-py can be used together with `Redis
+Sentinel <https://redis.io/topics/sentinel>`_ to discover Redis nodes. You
+need to have at least one Sentinel daemon running in order to use
+redis-py's Sentinel support.
+
+Connection example (assumes redis redis on the ports listed below):
+
+   >>> from redis import Sentinel
+   >>> sentinel = Sentinel([('localhost', 26379)], socket_timeout=0.1)
+   >>> sentinel.discover_master('mymaster')
+   ('127.0.0.1', 6379)
+   >>> sentinel.discover_slaves('mymaster')
+   [('127.0.0.1', 6380)]
+
+
+.. autoclass:: redis.commands.sentinel.SentinelCommands
+   :members:
\ No newline at end of file
diff --git a/redis/commands/timeseries/commands.py b/redis/commands/timeseries/commands.py
index 3b9ee0f8b3..fcb535b50c 100644
--- a/redis/commands/timeseries/commands.py
+++ b/redis/commands/timeseries/commands.py
@@ -27,7 +27,7 @@ def create(self, key, **kwargs):
         """
         Create a new time-series.
         For more information see
-        `TS.CREATE <https://oss.redis.com/redistimeseries/master/commands/#tscreate>`_.  # noqa
+        `TS.CREATE <https://oss.redis.com/redistimeseries/master/commands/#tscreate>`_.
 
         Args:
 
@@ -60,7 +60,7 @@ def create(self, key, **kwargs):
             - 'min': only override if the value is lower than the existing value.
             - 'max': only override if the value is higher than the existing value.
             When this is not set, the server-wide default will be used.
-        """
+        """  # noqa
         retention_msecs = kwargs.get("retention_msecs", None)
         uncompressed = kwargs.get("uncompressed", False)
         labels = kwargs.get("labels", {})
@@ -79,10 +79,10 @@ def alter(self, key, **kwargs):
         """
         Update the retention, labels of an existing key.
         For more information see
-        `TS.ALTER <https://oss.redis.com/redistimeseries/master/commands/#tsalter>`_.  # noqa
+        `TS.ALTER <https://oss.redis.com/redistimeseries/master/commands/#tsalter>`_.
 
         The parameters are the same as TS.CREATE.
-        """
+        """  # noqa
         retention_msecs = kwargs.get("retention_msecs", None)
         labels = kwargs.get("labels", {})
         duplicate_policy = kwargs.get("duplicate_policy", None)
@@ -97,7 +97,7 @@ def add(self, key, timestamp, value, **kwargs):
         """
         Append (or create and append) a new sample to the series.
         For more information see
-        `TS.ADD <https://oss.redis.com/redistimeseries/master/commands/#tsadd>`_. # noqa
+        `TS.ADD <https://oss.redis.com/redistimeseries/master/commands/#tsadd>`_.
 
         Args:
 
@@ -129,7 +129,7 @@ def add(self, key, timestamp, value, **kwargs):
             - 'min': only override if the value is lower than the existing value.
             - 'max': only override if the value is higher than the existing value.
             When this is not set, the server-wide default will be used.
-        """
+        """  # noqa
         retention_msecs = kwargs.get("retention_msecs", None)
         uncompressed = kwargs.get("uncompressed", False)
         labels = kwargs.get("labels", {})
@@ -151,8 +151,8 @@ def madd(self, ktv_tuples):
         Expects a list of `tuples` as (`key`,`timestamp`, `value`).
         Return value is an array with timestamps of insertions.
         For more information see
-        `TS.MADD <https://oss.redis.com/redistimeseries/master/commands/#tsmadd>`_. # noqa
-        """
+        `TS.MADD <https://oss.redis.com/redistimeseries/master/commands/#tsmadd>`_.
+        """  # noqa
         params = []
         for ktv in ktv_tuples:
             for item in ktv:
@@ -167,7 +167,7 @@ def incrby(self, key, value, **kwargs):
         This command can be used as a counter or gauge that automatically gets
         history as a time series.
         For more information see
-        `TS.INCRBY <https://oss.redis.com/redistimeseries/master/commands/#tsincrbytsdecrby>`_. # noqa
+        `TS.INCRBY <https://oss.redis.com/redistimeseries/master/commands/#tsincrbytsdecrby>`_.
 
         Args:
 
@@ -189,7 +189,7 @@ def incrby(self, key, value, **kwargs):
         chunk_size:
             Each time-series uses chunks of memory of fixed size for time series samples.
             You can alter the default TSDB chunk size by passing the chunk_size argument (in Bytes).
-        """
+        """  # noqa
         timestamp = kwargs.get("timestamp", None)
         retention_msecs = kwargs.get("retention_msecs", None)
         uncompressed = kwargs.get("uncompressed", False)
@@ -211,7 +211,7 @@ def decrby(self, key, value, **kwargs):
         This command can be used as a counter or gauge that
         automatically gets history as a time series.
         For more information see
-        `TS.DECRBY <https://oss.redis.com/redistimeseries/master/commands/#tsincrbytsdecrby>`_. # noqa
+        `TS.DECRBY <https://oss.redis.com/redistimeseries/master/commands/#tsincrbytsdecrby>`_.
 
         Args:
 
@@ -237,7 +237,7 @@ def decrby(self, key, value, **kwargs):
         chunk_size:
             Each time-series uses chunks of memory of fixed size for time series samples.
             You can alter the default TSDB chunk size by passing the chunk_size argument (in Bytes).
-        """
+        """  # noqa
         timestamp = kwargs.get("timestamp", None)
         retention_msecs = kwargs.get("retention_msecs", None)
         uncompressed = kwargs.get("uncompressed", False)
@@ -260,7 +260,7 @@ def delete(self, key, from_time, to_time):
         and end data points will also be deleted.
         Return the count for deleted items.
         For more information see
-        `TS.DEL <https://oss.redis.com/redistimeseries/master/commands/#tsdel>`_. # noqa
+        `TS.DEL <https://oss.redis.com/redistimeseries/master/commands/#tsdel>`_.
 
         Args:
 
@@ -270,7 +270,7 @@ def delete(self, key, from_time, to_time):
             Start timestamp for the range deletion.
         to_time:
             End timestamp for the range deletion.
-        """
+        """  # noqa
         return self.execute_command(DEL_CMD, key, from_time, to_time)
 
     def createrule(
@@ -286,8 +286,8 @@ def createrule(
         [`avg`, `sum`, `min`, `max`, `range`, `count`, `first`, `last`,
         `std.p`, `std.s`, `var.p`, `var.s`]
         For more information see
-        `TS.CREATERULE <https://oss.redis.com/redistimeseries/master/commands/#tscreaterule>`_. # noqa
-        """
+        `TS.CREATERULE <https://oss.redis.com/redistimeseries/master/commands/#tscreaterule>`_.
+        """  # noqa
         params = [source_key, dest_key]
         self._appendAggregation(params, aggregation_type, bucket_size_msec)
 
@@ -297,8 +297,8 @@ def deleterule(self, source_key, dest_key):
         """
         Delete a compaction rule.
         For more information see
-        `TS.DELETERULE <https://oss.redis.com/redistimeseries/master/commands/#tsdeleterule>`_. # noqa
-        """
+        `TS.DELETERULE <https://oss.redis.com/redistimeseries/master/commands/#tsdeleterule>`_.
+        """  # noqa
         return self.execute_command(DELETERULE_CMD, source_key, dest_key)
 
     def __range_params(
@@ -344,7 +344,7 @@ def range(
         """
         Query a range in forward direction for a specific time-serie.
         For more information see
-        `TS.RANGE <https://oss.redis.com/redistimeseries/master/commands/#tsrangetsrevrange>`_. # noqa
+        `TS.RANGE <https://oss.redis.com/redistimeseries/master/commands/#tsrangetsrevrange>`_.
 
         Args:
 
@@ -374,7 +374,7 @@ def range(
             by_min_value).
         align:
             Timestamp for alignment control for aggregation.
-        """
+        """  # noqa
         params = self.__range_params(
             key,
             from_time,
@@ -405,7 +405,7 @@ def revrange(
         """
         Query a range in reverse direction for a specific time-series.
         For more information see
-        `TS.REVRANGE <https://oss.redis.com/redistimeseries/master/commands/#tsrangetsrevrange>`_.  # noqa
+        `TS.REVRANGE <https://oss.redis.com/redistimeseries/master/commands/#tsrangetsrevrange>`_.
 
         **Note**: This command is only available since RedisTimeSeries >= v1.4
 
@@ -432,7 +432,7 @@ def revrange(
             Filter result by maximum value (must mention also filter_by_min_value).
         align:
             Timestamp for alignment control for aggregation.
-        """
+        """  # noqa
         params = self.__range_params(
             key,
             from_time,
@@ -501,7 +501,7 @@ def mrange(
         """
         Query a range across multiple time-series by filters in forward direction.
         For more information see
-        `TS.MRANGE <https://oss.redis.com/redistimeseries/master/commands/#tsmrangetsmrevrange>`_.  # noqa
+        `TS.MRANGE <https://oss.redis.com/redistimeseries/master/commands/#tsmrangetsmrevrange>`_.
 
         Args:
 
@@ -544,7 +544,7 @@ def mrange(
             pair labels of a series.
         align:
             Timestamp for alignment control for aggregation.
-        """
+        """  # noqa
         params = self.__mrange_params(
             aggregation_type,
             bucket_size_msec,
@@ -584,7 +584,7 @@ def mrevrange(
         """
         Query a range across multiple time-series by filters in reverse direction.
         For more information see
-        `TS.MREVRANGE <https://oss.redis.com/redistimeseries/master/commands/#tsmrangetsmrevrange>`_. # noqa
+        `TS.MREVRANGE <https://oss.redis.com/redistimeseries/master/commands/#tsmrangetsmrevrange>`_.
 
         Args:
 
@@ -629,7 +629,7 @@ def mrevrange(
             labels of a series.
         align:
             Timestamp for alignment control for aggregation.
-        """
+        """  # noqa
         params = self.__mrange_params(
             aggregation_type,
             bucket_size_msec,
@@ -653,14 +653,14 @@ def get(self, key):
         """ # noqa
         Get the last sample of `key`.
         For more information see `TS.GET <https://oss.redis.com/redistimeseries/master/commands/#tsget>`_.
-        """
+        """  # noqa
         return self.execute_command(GET_CMD, key)
 
     def mget(self, filters, with_labels=False):
         """ # noqa
         Get the last samples matching the specific `filter`.
         For more information see `TS.MGET <https://oss.redis.com/redistimeseries/master/commands/#tsmget>`_.
-        """
+        """  # noqa
         params = []
         self._appendWithLabels(params, with_labels)
         params.extend(["FILTER"])
@@ -671,14 +671,14 @@ def info(self, key):
         """  # noqa
         Get information of `key`.
         For more information see `TS.INFO <https://oss.redis.com/redistimeseries/master/commands/#tsinfo>`_.
-        """
+        """  # noqa
         return self.execute_command(INFO_CMD, key)
 
     def queryindex(self, filters):
         """  # noqa
         Get all the keys matching the `filter` list.
         For more information see `TS.QUERYINDEX <https://oss.redis.com/redistimeseries/master/commands/#tsqueryindex>`_.
-        """
+        """  # noqa
         return self.execute_command(QUERYINDEX_CMD, *filters)
 
     @staticmethod
diff --git a/tasks.py b/tasks.py
index 137d1771bd..e4821949d8 100644
--- a/tasks.py
+++ b/tasks.py
@@ -20,6 +20,12 @@ def devenv(c):
     run(cmd)
 
 
+@task
+def build_docs(c):
+    """Generates the sphinx documentation."""
+    run("tox -e docs")
+
+
 @task
 def linters(c):
     """Run code linters"""
diff --git a/tox.ini b/tox.ini
index 0a94db823b..33c397194d 100644
--- a/tox.ini
+++ b/tox.ini
@@ -8,7 +8,7 @@ markers =
 [tox]
 minversion = 3.2.0
 requires = tox-docker
-envlist = {standalone,cluster}-{plain,hiredis}-{py35,py36,py37,py38,py39,pypy3},linters
+envlist = {standalone,cluster}-{plain,hiredis}-{py35,py36,py37,py38,py39,pypy3},linters,docs
 
 [docker:master]
 name = master
@@ -128,7 +128,7 @@ commands = /usr/bin/echo
 
 [testenv:linters]
 deps_files = dev_requirements.txt
-docker=
+docker =
 commands =
     flake8
     vulture redis whitelist.py --min-confidence 80
@@ -141,6 +141,13 @@ basepython = pypy3
 [testenv:pypy3-hiredis]
 basepython = pypy3
 
+[testenv:docs]
+deps_files = docs/requirements.txt
+docker =
+changedir = {toxinidir}/docs
+allowlist_externals = make
+commands = make html
+
 [flake8]
 exclude =
     *.egg-info,

From 884f7adc871fbae352dfea099a57a1534a8588c6 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 25 Nov 2021 16:32:28 +0200
Subject: [PATCH 0272/1164] Fixing deprecating distutils (PEP 632) (#1730)

---
 redis/connection.py | 10 +++++-----
 requirements.txt    |  1 +
 setup.py            |  3 ++-
 tox.ini             |  2 +-
 4 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/redis/connection.py b/redis/connection.py
index 2f91fae890..6ff3650805 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1,4 +1,4 @@
-from distutils.version import LooseVersion
+from packaging.version import Version
 from itertools import chain
 from time import time
 from queue import LifoQueue, Empty, Full
@@ -55,13 +55,13 @@
 if HIREDIS_AVAILABLE:
     import hiredis
 
-    hiredis_version = LooseVersion(hiredis.__version__)
+    hiredis_version = Version(hiredis.__version__)
     HIREDIS_SUPPORTS_CALLABLE_ERRORS = \
-        hiredis_version >= LooseVersion('0.1.3')
+        hiredis_version >= Version('0.1.3')
     HIREDIS_SUPPORTS_BYTE_BUFFER = \
-        hiredis_version >= LooseVersion('0.1.4')
+        hiredis_version >= Version('0.1.4')
     HIREDIS_SUPPORTS_ENCODING_ERRORS = \
-        hiredis_version >= LooseVersion('1.0.0')
+        hiredis_version >= Version('1.0.0')
 
     HIREDIS_USE_BYTE_BUFFER = True
     # only use byte buffer if hiredis supports it
diff --git a/requirements.txt b/requirements.txt
index 9f8d5502da..f1e7e7ecdc 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1 +1,2 @@
 deprecated
+packaging
diff --git a/setup.py b/setup.py
index 6c712bd1d4..9acb501633 100644
--- a/setup.py
+++ b/setup.py
@@ -24,7 +24,8 @@
     author_email="oss@redis.com",
     python_requires=">=3.6",
     install_requires=[
-        'deprecated'
+        'deprecated==1.2.3',
+        'packaging==21.3',
     ],
     classifiers=[
         "Development Status :: 5 - Production/Stable",
diff --git a/tox.ini b/tox.ini
index 33c397194d..dd68274f2d 100644
--- a/tox.ini
+++ b/tox.ini
@@ -108,7 +108,7 @@ extras =
 setenv =
     CLUSTER_URL = "redis://localhost:16379/0"
 commands =
-    redis: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' {posargs}
+    standalone: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' {posargs}
     cluster: pytest --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={env:CLUSTER_URL:} {posargs}
 
 [testenv:devenv]

From 12f45ee2d8cc2c15b89ae579bf27b448ef0d1c2e Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 25 Nov 2021 16:36:50 +0200
Subject: [PATCH 0273/1164] Removing duplication of Script class (#1751)

---
 redis/client.py | 36 ------------------------------------
 1 file changed, 36 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 30a5c3c661..0ae64be9c9 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1,7 +1,6 @@
 from itertools import chain
 import copy
 import datetime
-import hashlib
 import re
 import threading
 import time
@@ -15,7 +14,6 @@
     ConnectionError,
     ExecAbortError,
     ModuleError,
-    NoScriptError,
     PubSubError,
     RedisError,
     ResponseError,
@@ -1896,37 +1894,3 @@ def watch(self, *names):
     def unwatch(self):
         "Unwatches all previously specified keys"
         return self.watching and self.execute_command('UNWATCH') or True
-
-
-class Script:
-    "An executable Lua script object returned by ``register_script``"
-
-    def __init__(self, registered_client, script):
-        self.registered_client = registered_client
-        self.script = script
-        # Precalculate and store the SHA1 hex digest of the script.
-
-        if isinstance(script, str):
-            # We need the encoding from the client in order to generate an
-            # accurate byte representation of the script
-            encoder = registered_client.connection_pool.get_encoder()
-            script = encoder.encode(script)
-        self.sha = hashlib.sha1(script).hexdigest()
-
-    def __call__(self, keys=[], args=[], client=None):
-        "Execute the script, passing any required ``args``"
-        if client is None:
-            client = self.registered_client
-        args = tuple(keys) + tuple(args)
-        # make sure the Redis server knows about the script
-        if isinstance(client, Pipeline):
-            # Make sure the pipeline can register the script before executing.
-            client.scripts.add(self)
-        try:
-            return client.evalsha(self.sha, len(keys), *args)
-        except NoScriptError:
-            # Maybe the client is pointed to a different server than the client
-            # that created this instance?
-            # Overwrite the sha just in case there was a discrepancy.
-            self.sha = client.script_load(self.script)
-            return client.evalsha(self.sha, len(keys), *args)

From 4db85ef574a64a2b230a3ae1ff19c9d04065a114 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 25 Nov 2021 16:46:14 +0200
Subject: [PATCH 0274/1164] Updating PR template (#1745)

---
 .github/PULL_REQUEST_TEMPLATE.md | 1 +
 examples/README.md               | 3 +++
 2 files changed, 4 insertions(+)
 create mode 100644 examples/README.md

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index 2bbc804d08..58062a1e2d 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -6,6 +6,7 @@ _Please make sure to review and check all of these items:_
 - [ ] Do the CI tests pass with this change (enable it first in your forked repo and wait for the github action build to finish)?
 - [ ] Is the new or changed code fully tested?
 - [ ] Is a documentation update included (if this change modifies existing APIs, or introduces new ones)?
+- [ ] Is there an example added to the examples folder (if applicable)?
 
 _NOTE: these things are not required to open a PR and can be done
 afterwards / while the PR is open._
diff --git a/examples/README.md b/examples/README.md
new file mode 100644
index 0000000000..ca6d5dcfa3
--- /dev/null
+++ b/examples/README.md
@@ -0,0 +1,3 @@
+# Examples
+
+Examples of redis-py usage go here. They're being linked to the [generated documentation](https://redis-py.readthedocs.org).

From fbe87acf96aab583975ed3371423eb20602eccaf Mon Sep 17 00:00:00 2001
From: Aarni Koskela <akx@iki.fi>
Date: Tue, 30 Nov 2021 17:20:43 +0200
Subject: [PATCH 0275/1164] Pyupgrade + flynt + f-strings (#1759)

@akx Thank you so much for this! Thanks again for introducing me to a new tool that I'm sliding into my workflow as well.
---
 benchmarks/base.py                       |   6 +-
 benchmarks/basic_operations.py           |  23 ++--
 benchmarks/command_packer_benchmark.py   |  11 +-
 dev_requirements.txt                     |   1 +
 redis/client.py                          |  18 +--
 redis/cluster.py                         | 134 +++++++++++------------
 redis/commands/cluster.py                |  20 ++--
 redis/commands/core.py                   |  45 ++++----
 redis/commands/helpers.py                |   2 +-
 redis/commands/json/path.py              |   2 +-
 redis/commands/parser.py                 |   5 +-
 redis/commands/search/__init__.py        |   2 +-
 redis/commands/search/aggregation.py     |  27 +++--
 redis/commands/search/commands.py        |   2 +-
 redis/commands/search/document.py        |   4 +-
 redis/commands/search/field.py           |   2 +-
 redis/commands/search/indexDefinition.py |   5 +-
 redis/commands/search/query.py           |  10 +-
 redis/commands/search/querystring.py     |  22 ++--
 redis/commands/search/reducers.py        |  24 ++--
 redis/commands/search/result.py          |   4 +-
 redis/commands/search/suggestion.py      |   4 +-
 redis/commands/timeseries/info.py        |   2 +-
 redis/connection.py                      |  65 ++++++-----
 redis/sentinel.py                        |  28 ++---
 tasks.py                                 |   4 +-
 tests/conftest.py                        |  20 ++--
 tests/test_cluster.py                    |  23 ++--
 tests/test_commands.py                   |  32 +++---
 tests/test_connection.py                 |   2 +-
 tests/test_multiprocessing.py            |   7 +-
 tests/test_pipeline.py                   |   2 +-
 tests/test_pubsub.py                     |   2 +-
 tests/test_search.py                     |   4 +-
 tests/test_timeseries.py                 |   2 +-
 tox.ini                                  |   3 +-
 36 files changed, 263 insertions(+), 306 deletions(-)

diff --git a/benchmarks/base.py b/benchmarks/base.py
index 8c13afe34d..519c9ccab5 100644
--- a/benchmarks/base.py
+++ b/benchmarks/base.py
@@ -34,12 +34,12 @@ def run_benchmark(self):
         group_values = [group['values'] for group in self.ARGUMENTS]
         for value_set in itertools.product(*group_values):
             pairs = list(zip(group_names, value_set))
-            arg_string = ', '.join(['%s=%s' % (p[0], p[1]) for p in pairs])
-            sys.stdout.write('Benchmark: %s... ' % arg_string)
+            arg_string = ', '.join(f'{p[0]}={p[1]}' for p in pairs)
+            sys.stdout.write(f'Benchmark: {arg_string}... ')
             sys.stdout.flush()
             kwargs = dict(pairs)
             setup = functools.partial(self.setup, **kwargs)
             run = functools.partial(self.run, **kwargs)
             t = timeit.timeit(stmt=run, setup=setup, number=1000)
-            sys.stdout.write('%f\n' % t)
+            sys.stdout.write(f'{t:f}\n')
             sys.stdout.flush()
diff --git a/benchmarks/basic_operations.py b/benchmarks/basic_operations.py
index 9446343251..cb009debbd 100644
--- a/benchmarks/basic_operations.py
+++ b/benchmarks/basic_operations.py
@@ -49,9 +49,9 @@ def wrapper(*args, **kwargs):
             count = kwargs['num']
         else:
             count = args[1]
-        print('{} - {} Requests'.format(func.__name__, count))
-        print('Duration  = {}'.format(duration))
-        print('Rate = {}'.format(count/duration))
+        print(f'{func.__name__} - {count} Requests')
+        print(f'Duration  = {duration}')
+        print(f'Rate = {count/duration}')
         print()
         return ret
     return wrapper
@@ -62,10 +62,9 @@ def set_str(conn, num, pipeline_size, data_size):
     if pipeline_size > 1:
         conn = conn.pipeline()
 
-    format_str = '{:0<%d}' % data_size
-    set_data = format_str.format('a')
+    set_data = 'a'.ljust(data_size, '0')
     for i in range(num):
-        conn.set('set_str:%d' % i, set_data)
+        conn.set(f'set_str:{i}', set_data)
         if pipeline_size > 1 and i % pipeline_size == 0:
             conn.execute()
 
@@ -78,10 +77,9 @@ def set_int(conn, num, pipeline_size, data_size):
     if pipeline_size > 1:
         conn = conn.pipeline()
 
-    format_str = '{:0<%d}' % data_size
-    set_data = int(format_str.format('1'))
+    set_data = 10 ** (data_size - 1)
     for i in range(num):
-        conn.set('set_int:%d' % i, set_data)
+        conn.set(f'set_int:{i}', set_data)
         if pipeline_size > 1 and i % pipeline_size == 0:
             conn.execute()
 
@@ -95,7 +93,7 @@ def get_str(conn, num, pipeline_size, data_size):
         conn = conn.pipeline()
 
     for i in range(num):
-        conn.get('set_str:%d' % i)
+        conn.get(f'set_str:{i}')
         if pipeline_size > 1 and i % pipeline_size == 0:
             conn.execute()
 
@@ -109,7 +107,7 @@ def get_int(conn, num, pipeline_size, data_size):
         conn = conn.pipeline()
 
     for i in range(num):
-        conn.get('set_int:%d' % i)
+        conn.get(f'set_int:{i}')
         if pipeline_size > 1 and i % pipeline_size == 0:
             conn.execute()
 
@@ -136,8 +134,7 @@ def lpush(conn, num, pipeline_size, data_size):
     if pipeline_size > 1:
         conn = conn.pipeline()
 
-    format_str = '{:0<%d}' % data_size
-    set_data = int(format_str.format('1'))
+    set_data = 10 ** (data_size - 1)
     for i in range(num):
         conn.lpush('lpush_key', set_data)
         if pipeline_size > 1 and i % pipeline_size == 0:
diff --git a/benchmarks/command_packer_benchmark.py b/benchmarks/command_packer_benchmark.py
index 823a8c8469..3176c06800 100644
--- a/benchmarks/command_packer_benchmark.py
+++ b/benchmarks/command_packer_benchmark.py
@@ -1,4 +1,3 @@
-import socket
 from redis.connection import (Connection, SYM_STAR, SYM_DOLLAR, SYM_EMPTY,
                               SYM_CRLF)
 from base import Benchmark
@@ -11,14 +10,13 @@ def send_packed_command(self, command, check_health=True):
             self.connect()
         try:
             self._sock.sendall(command)
-        except socket.error as e:
+        except OSError as e:
             self.disconnect()
             if len(e.args) == 1:
                 _errno, errmsg = 'UNKNOWN', e.args[0]
             else:
                 _errno, errmsg = e.args
-            raise ConnectionError("Error %s while writing to socket. %s." %
-                                  (_errno, errmsg))
+            raise ConnectionError(f"Error {_errno} while writing to socket. {errmsg}.")
         except Exception:
             self.disconnect()
             raise
@@ -43,14 +41,13 @@ def send_packed_command(self, command, check_health=True):
                 command = [command]
             for item in command:
                 self._sock.sendall(item)
-        except socket.error as e:
+        except OSError as e:
             self.disconnect()
             if len(e.args) == 1:
                 _errno, errmsg = 'UNKNOWN', e.args[0]
             else:
                 _errno, errmsg = e.args
-            raise ConnectionError("Error %s while writing to socket. %s." %
-                                  (_errno, errmsg))
+            raise ConnectionError(f"Error {_errno} while writing to socket. {errmsg}.")
         except Exception:
             self.disconnect()
             raise
diff --git a/dev_requirements.txt b/dev_requirements.txt
index 7f099cb541..56ac08efe2 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -1,4 +1,5 @@
 flake8>=3.9.2
+flynt~=0.69.0
 pytest==6.2.5
 pytest-timeout==2.0.1
 tox==3.24.4
diff --git a/redis/client.py b/redis/client.py
index 0ae64be9c9..9f2907ee52 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -629,7 +629,7 @@ def parse_set_result(response, **options):
     return response and str_if_bytes(response) == 'OK'
 
 
-class Redis(RedisModuleCommands, CoreCommands, SentinelCommands, object):
+class Redis(RedisModuleCommands, CoreCommands, SentinelCommands):
     """
     Implementation of the Redis protocol.
 
@@ -918,7 +918,7 @@ def __init__(self, host='localhost', port=6379,
             self.__class__.RESPONSE_CALLBACKS)
 
     def __repr__(self):
-        return "%s<%s>" % (type(self).__name__, repr(self.connection_pool))
+        return f"{type(self).__name__}<{repr(self.connection_pool)}>"
 
     def set_response_callback(self, command, callback):
         "Set a custom Response Callback"
@@ -1141,7 +1141,7 @@ def __enter__(self):
         # check that monitor returns 'OK', but don't return it to user
         response = self.connection.read_response()
         if not bool_ok(response):
-            raise RedisError('MONITOR failed: %s' % response)
+            raise RedisError(f'MONITOR failed: {response}')
         return self
 
     def __exit__(self, *args):
@@ -1517,12 +1517,10 @@ def run_in_thread(self, sleep_time=0, daemon=False,
                       exception_handler=None):
         for channel, handler in self.channels.items():
             if handler is None:
-                raise PubSubError("Channel: '%s' has no handler registered" %
-                                  channel)
+                raise PubSubError(f"Channel: '{channel}' has no handler registered")
         for pattern, handler in self.patterns.items():
             if handler is None:
-                raise PubSubError("Pattern: '%s' has no handler registered" %
-                                  pattern)
+                raise PubSubError(f"Pattern: '{pattern}' has no handler registered")
 
         thread = PubSubWorkerThread(
             self,
@@ -1807,8 +1805,10 @@ def raise_first_error(self, commands, response):
 
     def annotate_exception(self, exception, number, command):
         cmd = ' '.join(map(safe_str, command))
-        msg = 'Command # %d (%s) of pipeline caused error: %s' % (
-            number, cmd, exception.args[0])
+        msg = (
+            f'Command # {number} ({cmd}) of pipeline '
+            f'caused error: {exception.args[0]}'
+        )
         exception.args = (msg,) + exception.args[1:]
 
     def parse_response(self, connection, command_name, **options):
diff --git a/redis/cluster.py b/redis/cluster.py
index 91a4d558a2..c1853aa876 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -42,7 +42,7 @@
 
 
 def get_node_name(host, port):
-    return '{0}:{1}'.format(host, port)
+    return f'{host}:{port}'
 
 
 def get_connection(redis_node, *args, **options):
@@ -200,7 +200,7 @@ class ClusterParser(DefaultParser):
         })
 
 
-class RedisCluster(ClusterCommands, object):
+class RedisCluster(ClusterCommands):
     RedisClusterRequestTTL = 16
 
     PRIMARIES = "primaries"
@@ -451,7 +451,7 @@ def __init__(
                 "2. list of startup nodes, for example:\n"
                 " RedisCluster(startup_nodes=[ClusterNode('localhost', 6379),"
                 " ClusterNode('localhost', 6378)])")
-        log.debug("startup_nodes : {0}".format(startup_nodes))
+        log.debug(f"startup_nodes : {startup_nodes}")
         # Update the connection arguments
         # Whenever a new connection is established, RedisCluster's on_connect
         # method should be run
@@ -602,7 +602,7 @@ def get_node_from_key(self, key, replica=False):
         slot_cache = self.nodes_manager.slots_cache.get(slot)
         if slot_cache is None or len(slot_cache) == 0:
             raise SlotNotCoveredError(
-                'Slot "{0}" is not covered by the cluster.'.format(slot)
+                f'Slot "{slot}" is not covered by the cluster.'
             )
         if replica and len(self.nodes_manager.slots_cache[slot]) < 2:
             return None
@@ -631,7 +631,7 @@ def set_default_node(self, node):
                      "the default node was not changed.")
             return False
         self.nodes_manager.default_node = node
-        log.info("Changed the default cluster node to {0}".format(node))
+        log.info(f"Changed the default cluster node to {node}")
         return True
 
     def pubsub(self, node=None, host=None, port=None, **kwargs):
@@ -678,8 +678,7 @@ def _determine_nodes(self, *args, **kwargs):
             # get the nodes group for this command if it was predefined
             command_flag = self.command_flags.get(command)
         if command_flag:
-            log.debug("Target node/s for {0}: {1}".
-                      format(command, command_flag))
+            log.debug(f"Target node/s for {command}: {command_flag}")
         if command_flag == self.__class__.RANDOM:
             # return a random node
             return [self.get_random_node()]
@@ -700,7 +699,7 @@ def _determine_nodes(self, *args, **kwargs):
             slot = self.determine_slot(*args)
             node = self.nodes_manager.get_node_from_slot(
                 slot, self.read_from_replicas and command in READ_COMMANDS)
-            log.debug("Target for {0}: slot {1}".format(args, slot))
+            log.debug(f"Target for {args}: slot {slot}")
             return [node]
 
     def _should_reinitialized(self):
@@ -741,7 +740,7 @@ def determine_slot(self, *args):
             raise RedisClusterException(
                 "No way to dispatch this command to Redis Cluster. "
                 "Missing key.\nYou can execute the command by specifying "
-                "target nodes.\nCommand: {0}".format(args)
+                f"target nodes.\nCommand: {args}"
             )
 
         if len(keys) > 1:
@@ -749,8 +748,9 @@ def determine_slot(self, *args):
             # the same slot
             slots = {self.keyslot(key) for key in keys}
             if len(slots) != 1:
-                raise RedisClusterException("{0} - all keys must map to the "
-                                            "same key slot".format(args[0]))
+                raise RedisClusterException(
+                    f"{args[0]} - all keys must map to the same key slot"
+                )
             return slots.pop()
         else:
             # single key command
@@ -775,12 +775,12 @@ def _parse_target_nodes(self, target_nodes):
             # rc.cluster_save_config(rc.get_primaries())
             nodes = target_nodes.values()
         else:
-            raise TypeError("target_nodes type can be one of the "
-                            "followings: node_flag (PRIMARIES, "
-                            "REPLICAS, RANDOM, ALL_NODES),"
-                            "ClusterNode, list<ClusterNode>, or "
-                            "dict<any, ClusterNode>. The passed type is {0}".
-                            format(type(target_nodes)))
+            raise TypeError(
+                "target_nodes type can be one of the following: "
+                "node_flag (PRIMARIES, REPLICAS, RANDOM, ALL_NODES),"
+                "ClusterNode, list<ClusterNode>, or dict<any, ClusterNode>. "
+                f"The passed type is {type(target_nodes)}"
+            )
         return nodes
 
     def execute_command(self, *args, **kwargs):
@@ -824,8 +824,7 @@ def execute_command(self, *args, **kwargs):
                         *args, **kwargs, nodes_flag=target_nodes)
                     if not target_nodes:
                         raise RedisClusterException(
-                            "No targets were found to execute"
-                            " {} command on".format(args))
+                            f"No targets were found to execute {args} command on")
                 for node in target_nodes:
                     res[node.name] = self._execute_command(
                         node, *args, **kwargs)
@@ -868,9 +867,10 @@ def _execute_command(self, target_node, *args, **kwargs):
                                            command in READ_COMMANDS)
                     moved = False
 
-                log.debug("Executing command {0} on target node: {1} {2}".
-                          format(command, target_node.server_type,
-                                 target_node.name))
+                log.debug(
+                    f"Executing command {command} on target node: "
+                    f"{target_node.server_type} {target_node.name}"
+                )
                 redis_node = self.get_redis_connection(target_node)
                 connection = get_connection(redis_node, *args, **kwargs)
                 if asking:
@@ -952,7 +952,7 @@ def _execute_command(self, target_node, *args, **kwargs):
                 raise e
             except ResponseError as e:
                 message = e.__str__()
-                log.exception("ResponseError: {0}".format(message))
+                log.exception(f"ResponseError: {message}")
                 raise e
             except BaseException as e:
                 log.exception("BaseException")
@@ -995,7 +995,7 @@ def _process_result(self, command, res, **kwargs):
             return res
 
 
-class ClusterNode(object):
+class ClusterNode:
     def __init__(self, host, port, server_type=None, redis_connection=None):
         if host == 'localhost':
             host = socket.gethostbyname(host)
@@ -1007,13 +1007,13 @@ def __init__(self, host, port, server_type=None, redis_connection=None):
         self.redis_connection = redis_connection
 
     def __repr__(self):
-        return '[host={0},port={1},' \
-               'name={2},server_type={3},redis_connection={4}]' \
-            .format(self.host,
-                    self.port,
-                    self.name,
-                    self.server_type,
-                    self.redis_connection)
+        return (
+            f'[host={self.host},'
+            f'port={self.port},'
+            f'name={self.name},'
+            f'server_type={self.server_type},'
+            f'redis_connection={self.redis_connection}]'
+        )
 
     def __eq__(self, obj):
         return isinstance(obj, ClusterNode) and obj.name == self.name
@@ -1135,9 +1135,8 @@ def get_node_from_slot(self, slot, read_from_replicas=False,
         if self.slots_cache.get(slot) is None or \
                 len(self.slots_cache[slot]) == 0:
             raise SlotNotCoveredError(
-                'Slot "{0}" not covered by the cluster. '
-                '"require_full_coverage={1}"'.format(
-                    slot, self._require_full_coverage)
+                f'Slot "{slot}" not covered by the cluster. '
+                f'"require_full_coverage={self._require_full_coverage}"'
             )
 
         if read_from_replicas is True:
@@ -1196,7 +1195,7 @@ def node_require_full_coverage(node):
             except Exception as e:
                 raise RedisClusterException(
                     'ERROR sending "config get cluster-require-full-coverage"'
-                    ' command to redis server: {0}, {1}'.format(node.name, e)
+                    f' command to redis server: {node.name}, {e}'
                 )
 
         # at least one node should have cluster-require-full-coverage yes
@@ -1269,7 +1268,7 @@ def initialize(self):
                 msg = e.__str__
                 log.exception('An exception occurred while trying to'
                               ' initialize the cluster using the seed node'
-                              ' {0}:\n{1}'.format(startup_node.name, msg))
+                              f' {startup_node.name}:\n{msg}')
                 continue
             except ResponseError as e:
                 log.exception(
@@ -1283,15 +1282,13 @@ def initialize(self):
                 else:
                     raise RedisClusterException(
                         'ERROR sending "cluster slots" command to redis '
-                        'server: {0}. error: {1}'.format(
-                            startup_node, message)
+                        f'server: {startup_node}. error: {message}'
                     )
             except Exception as e:
                 message = e.__str__()
                 raise RedisClusterException(
                     'ERROR sending "cluster slots" command to redis '
-                    'server: {0}. error: {1}'.format(
-                        startup_node, message)
+                    f'server: {startup_node}. error: {message}'
                 )
 
             # CLUSTER SLOTS command results in the following output:
@@ -1342,17 +1339,16 @@ def initialize(self):
                     else:
                         # Validate that 2 nodes want to use the same slot cache
                         # setup
-                        if tmp_slots[i][0].name != target_node.name:
+                        tmp_slot = tmp_slots[i][0]
+                        if tmp_slot.name != target_node.name:
                             disagreements.append(
-                                '{0} vs {1} on slot: {2}'.format(
-                                    tmp_slots[i][0].name, target_node.name, i)
+                                f'{tmp_slot.name} vs {target_node.name} on slot: {i}'
                             )
 
                             if len(disagreements) > 5:
                                 raise RedisClusterException(
-                                    'startup_nodes could not agree on a valid'
-                                    ' slots cache: {0}'.format(
-                                        ", ".join(disagreements))
+                                    f'startup_nodes could not agree on a valid '
+                                    f'slots cache: {", ".join(disagreements)}'
                                 )
 
         if not startup_nodes_reachable:
@@ -1370,9 +1366,8 @@ def initialize(self):
             # Despite the requirement that the slots be covered, there
             # isn't a full coverage
             raise RedisClusterException(
-                'All slots are not covered after query all startup_nodes.'
-                ' {0} of {1} covered...'.format(
-                    len(self.slots_cache), REDIS_CLUSTER_HASH_SLOTS)
+                f'All slots are not covered after query all startup_nodes. '
+                f'{len(self.slots_cache)} of {REDIS_CLUSTER_HASH_SLOTS} covered...'
             )
         elif not fully_covered and not self._require_full_coverage:
             # The user set require_full_coverage to False.
@@ -1389,8 +1384,7 @@ def initialize(self):
                     'cluster-require-full-coverage configuration to no on '
                     'all of the cluster nodes if you wish the cluster to '
                     'be able to serve without being fully covered.'
-                    ' {0} of {1} covered...'.format(
-                        len(self.slots_cache), REDIS_CLUSTER_HASH_SLOTS)
+                    f'{len(self.slots_cache)} of {REDIS_CLUSTER_HASH_SLOTS} covered...'
                 )
 
         # Set the tmp variables to the real variables
@@ -1495,8 +1489,7 @@ def _raise_on_invalid_node(self, redis_cluster, node, host, port):
         """
         if node is None or redis_cluster.get_node(node_name=node.name) is None:
             raise RedisClusterException(
-                "Node {0}:{1} doesn't exist in the cluster"
-                .format(host, port))
+                f"Node {host}:{port} doesn't exist in the cluster")
 
     def execute_command(self, *args, **kwargs):
         """
@@ -1585,7 +1578,7 @@ def __init__(self, nodes_manager, result_callbacks=None,
     def __repr__(self):
         """
         """
-        return "{0}".format(type(self).__name__)
+        return f"{type(self).__name__}"
 
     def __enter__(self):
         """
@@ -1645,8 +1638,10 @@ def annotate_exception(self, exception, number, command):
         Provides extra context to the exception prior to it being handled
         """
         cmd = ' '.join(map(safe_str, command))
-        msg = 'Command # %d (%s) of pipeline caused error: %s' % (
-            number, cmd, exception.args[0])
+        msg = (
+            f'Command # {number} ({cmd}) of pipeline '
+            f'caused error: {exception.args[0]}'
+        )
         exception.args = (msg,) + exception.args[1:]
 
     def execute(self, raise_on_error=True):
@@ -1813,8 +1808,8 @@ def _send_cluster_commands(self, stack,
         # if we have more commands to attempt, we've run into problems.
         # collect all the commands we are allowed to retry.
         # (MOVED, ASK, or connection errors or timeout errors)
-        attempt = sorted([c for c in attempt
-                          if isinstance(c.result, ERRORS_ALLOW_RETRY)],
+        attempt = sorted((c for c in attempt
+                          if isinstance(c.result, ERRORS_ALLOW_RETRY)),
                          key=lambda x: x.position)
         if attempt and allow_redirections:
             # RETRY MAGIC HAPPENS HERE!
@@ -1835,12 +1830,12 @@ def _send_cluster_commands(self, stack,
             # If a lot of commands have failed, we'll be setting the
             # flag to rebuild the slots table from scratch.
             # So MOVED errors should correct themselves fairly quickly.
-            msg = 'An exception occurred during pipeline execution. ' \
-                  'args: {0}, error: {1} {2}'.\
-                format(attempt[-1].args,
-                       type(attempt[-1].result).__name__,
-                       str(attempt[-1].result))
-            log.exception(msg)
+            log.exception(
+                f'An exception occurred during pipeline execution. '
+                f'args: {attempt[-1].args}, '
+                f'error: {type(attempt[-1].result).__name__} '
+                f'{str(attempt[-1].result)}'
+            )
             self.reinitialize_counter += 1
             if self._should_reinitialized():
                 self.nodes_manager.initialize()
@@ -1848,8 +1843,7 @@ def _send_cluster_commands(self, stack,
                 try:
                     # send each command individually like we
                     # do in the main client.
-                    c.result = super(ClusterPipeline, self). \
-                        execute_command(*c.args, **c.options)
+                    c.result = super().execute_command(*c.args, **c.options)
                 except RedisError as e:
                     c.result = e
 
@@ -1933,8 +1927,8 @@ def block_pipeline_command(func):
 
     def inner(*args, **kwargs):
         raise RedisClusterException(
-            "ERROR: Calling pipelined function {0} is blocked when "
-            "running redis in cluster mode...".format(func.__name__))
+            f"ERROR: Calling pipelined function {func.__name__} is blocked when "
+            f"running redis in cluster mode...")
 
     return inner
 
@@ -1977,7 +1971,7 @@ def inner(*args, **kwargs):
 ClusterPipeline.readonly = block_pipeline_command(RedisCluster.readonly)
 
 
-class PipelineCommand(object):
+class PipelineCommand:
     """
     """
 
@@ -1992,7 +1986,7 @@ def __init__(self, args, options=None, position=None):
         self.asking = False
 
 
-class NodeCommands(object):
+class NodeCommands:
     """
     """
 
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index 6c7740d5e9..e6b0a08924 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -228,8 +228,7 @@ def client_kill_filter(self, _id=None, _type=None, addr=None,
         if _type is not None:
             client_types = ('normal', 'master', 'slave', 'pubsub')
             if str(_type).lower() not in client_types:
-                raise DataError("CLIENT KILL type must be one of %r" % (
-                    client_types,))
+                raise DataError(f"CLIENT KILL type must be one of {client_types!r}")
             args.extend((b'TYPE', _type))
         if skipme is not None:
             if not isinstance(skipme, bool):
@@ -267,8 +266,7 @@ def client_list(self, _type=None, target_nodes=None):
         if _type is not None:
             client_types = ('normal', 'master', 'replica', 'pubsub')
             if str(_type).lower() not in client_types:
-                raise DataError("CLIENT LIST _type must be one of %r" % (
-                    client_types,))
+                raise DataError(f"CLIENT LIST _type must be one of {client_types!r}")
             return self.execute_command('CLIENT LIST',
                                         b'TYPE',
                                         _type,
@@ -302,7 +300,7 @@ def client_reply(self, reply, target_nodes=None):
         """
         replies = ['ON', 'OFF', 'SKIP']
         if reply not in replies:
-            raise DataError('CLIENT REPLY must be one of %r' % replies)
+            raise DataError(f'CLIENT REPLY must be one of {replies!r}')
         return self.execute_command("CLIENT REPLY", reply,
                                     target_nodes=target_nodes)
 
@@ -640,11 +638,10 @@ def stralgo(self, algo, value1, value2, specific_argument='strings',
         # check validity
         supported_algo = ['LCS']
         if algo not in supported_algo:
-            raise DataError("The supported algorithms are: %s"
-                            % (', '.join(supported_algo)))
+            supported_algos_str = ', '.join(supported_algo)
+            raise DataError(f"The supported algorithms are: {supported_algos_str}")
         if specific_argument not in ['keys', 'strings']:
-            raise DataError("specific_argument can be only"
-                            " keys or strings")
+            raise DataError("specific_argument can be only keys or strings")
         if len and idx:
             raise DataError("len and idx cannot be provided together.")
 
@@ -788,8 +785,7 @@ def cluster_failover(self, target_node, option=None):
         if option:
             if option.upper() not in ['FORCE', 'TAKEOVER']:
                 raise RedisError(
-                    'Invalid option for CLUSTER FAILOVER command: {0}'.format(
-                        option))
+                    f'Invalid option for CLUSTER FAILOVER command: {option}')
             else:
                 return self.execute_command('CLUSTER FAILOVER', option,
                                             target_nodes=target_node)
@@ -880,7 +876,7 @@ def cluster_setslot(self, target_node, node_id, slot_id, state):
             raise RedisError('For "stable" state please use '
                              'cluster_setslot_stable')
         else:
-            raise RedisError('Invalid slot state: {0}'.format(state))
+            raise RedisError(f'Invalid slot state: {state}')
 
     def cluster_setslot_stable(self, slot_id):
         """
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 64e3b6d37e..0285f80e0f 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -227,8 +227,8 @@ def acl_setuser(self, username, enabled=False, nopass=False,
                 elif password.startswith(b'-'):
                     pieces.append(b'<%s' % password[1:])
                 else:
-                    raise DataError('Password %d must be prefixeed with a '
-                                    '"+" to add or a "-" to remove' % i)
+                    raise DataError(f'Password {i} must be prefixed with a '
+                                    f'"+" to add or a "-" to remove')
 
         if hashed_passwords:
             # as most users will have only one password, allow remove_passwords
@@ -241,8 +241,8 @@ def acl_setuser(self, username, enabled=False, nopass=False,
                 elif hashed_password.startswith(b'-'):
                     pieces.append(b'!%s' % hashed_password[1:])
                 else:
-                    raise DataError('Hashed %d password must be prefixeed '
-                                    'with a "+" to add or a "-" to remove' % i)
+                    raise DataError(f'Hashed password {i} must be prefixed with a '
+                                    f'"+" to add or a "-" to remove')
 
         if nopass:
             pieces.append(b'nopass')
@@ -260,16 +260,18 @@ def acl_setuser(self, username, enabled=False, nopass=False,
                 elif category.startswith(b'-'):
                     pieces.append(b'-@%s' % category[1:])
                 else:
-                    raise DataError('Category "%s" must be prefixed with '
-                                    '"+" or "-"'
-                                    % encoder.decode(category, force=True))
+                    raise DataError(
+                        f'Category "{encoder.decode(category, force=True)}" '
+                        'must be prefixed with "+" or "-"'
+                    )
         if commands:
             for cmd in commands:
                 cmd = encoder.encode(cmd)
                 if not cmd.startswith(b'+') and not cmd.startswith(b'-'):
-                    raise DataError('Command "%s" must be prefixed with '
-                                    '"+" or "-"'
-                                    % encoder.decode(cmd, force=True))
+                    raise DataError(
+                        f'Command "{encoder.decode(cmd, force=True)}" '
+                        'must be prefixed with "+" or "-"'
+                    )
                 pieces.append(cmd)
 
         if keys:
@@ -342,8 +344,7 @@ def client_kill_filter(self, _id=None, _type=None, addr=None,
         if _type is not None:
             client_types = ('normal', 'master', 'slave', 'pubsub')
             if str(_type).lower() not in client_types:
-                raise DataError("CLIENT KILL type must be one of %r" % (
-                                client_types,))
+                raise DataError(f"CLIENT KILL type must be one of {client_types!r}")
             args.extend((b'TYPE', _type))
         if skipme is not None:
             if not isinstance(skipme, bool):
@@ -388,8 +389,7 @@ def client_list(self, _type=None, client_id=[]):
         if _type is not None:
             client_types = ('normal', 'master', 'replica', 'pubsub')
             if str(_type).lower() not in client_types:
-                raise DataError("CLIENT LIST _type must be one of %r" % (
-                                client_types,))
+                raise DataError(f"CLIENT LIST _type must be one of {client_types!r}")
             args.append(b'TYPE')
             args.append(_type)
         if not isinstance(client_id, list):
@@ -434,7 +434,7 @@ def client_reply(self, reply):
         """
         replies = ['ON', 'OFF', 'SKIP']
         if reply not in replies:
-            raise DataError('CLIENT REPLY must be one of %r' % replies)
+            raise DataError(f'CLIENT REPLY must be one of {replies!r}')
         return self.execute_command("CLIENT REPLY", reply)
 
     def client_id(self):
@@ -551,7 +551,7 @@ def config_rewrite(self):
         return self.execute_command('CONFIG REWRITE')
 
     def cluster(self, cluster_arg, *args):
-        return self.execute_command('CLUSTER %s' % cluster_arg.upper(), *args)
+        return self.execute_command(f'CLUSTER {cluster_arg.upper()}', *args)
 
     def dbsize(self):
         """
@@ -1086,7 +1086,7 @@ def getex(self, name,
         For more information check https://redis.io/commands/getex
         """
 
-        opset = set([ex, px, exat, pxat])
+        opset = {ex, px, exat, pxat}
         if len(opset) > 2 or len(opset) > 1 and persist:
             raise DataError("``ex``, ``px``, ``exat``, ``pxat``, "
                             "and ``persist`` are mutually exclusive.")
@@ -1554,11 +1554,10 @@ def stralgo(self, algo, value1, value2, specific_argument='strings',
         # check validity
         supported_algo = ['LCS']
         if algo not in supported_algo:
-            raise DataError("The supported algorithms are: %s"
-                            % (', '.join(supported_algo)))
+            supported_algos_str = ', '.join(supported_algo)
+            raise DataError(f"The supported algorithms are: {supported_algos_str}")
         if specific_argument not in ['keys', 'strings']:
-            raise DataError("specific_argument can be only"
-                            " keys or strings")
+            raise DataError("specific_argument can be only keys or strings")
         if len and idx:
             raise DataError("len and idx cannot be provided together.")
 
@@ -3466,8 +3465,8 @@ def hmset(self, name, mapping):
         For more information check https://redis.io/commands/hmset
         """
         warnings.warn(
-            '%s.hmset() is deprecated. Use %s.hset() instead.'
-            % (self.__class__.__name__, self.__class__.__name__),
+            f'{self.__class__.__name__}.hmset() is deprecated. '
+            f'Use {self.__class__.__name__}.hset() instead.',
             DeprecationWarning,
             stacklevel=2,
         )
diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
index 5e8ff49d9b..dc5705b80b 100644
--- a/redis/commands/helpers.py
+++ b/redis/commands/helpers.py
@@ -113,4 +113,4 @@ def quote_string(v):
 
     v = v.replace('"', '\\"')
 
-    return '"{}"'.format(v)
+    return f'"{v}"'
diff --git a/redis/commands/json/path.py b/redis/commands/json/path.py
index 6d87045155..f0a413a00d 100644
--- a/redis/commands/json/path.py
+++ b/redis/commands/json/path.py
@@ -1,4 +1,4 @@
-class Path(object):
+class Path:
     """This class represents a path in a JSON value."""
 
     strPath = ""
diff --git a/redis/commands/parser.py b/redis/commands/parser.py
index d8b03271db..26b190c674 100644
--- a/redis/commands/parser.py
+++ b/redis/commands/parser.py
@@ -46,8 +46,9 @@ def get_keys(self, redis_conn, *args):
                 # version has changed, the commands may not be current
                 self.initialize(redis_conn)
                 if cmd_name not in self.commands:
-                    raise RedisError("{0} command doesn't exist in Redis "
-                                     "commands".format(cmd_name.upper()))
+                    raise RedisError(
+                        f"{cmd_name.upper()} command doesn't exist in Redis commands"
+                    )
 
         command = self.commands.get(cmd_name)
         if 'movablekeys' in command['flags']:
diff --git a/redis/commands/search/__init__.py b/redis/commands/search/__init__.py
index 8320ad4392..a30cebe1b7 100644
--- a/redis/commands/search/__init__.py
+++ b/redis/commands/search/__init__.py
@@ -7,7 +7,7 @@ class Search(SearchCommands):
     It abstracts the API of the module and lets you just use the engine.
     """
 
-    class BatchIndexer(object):
+    class BatchIndexer:
         """
         A batch indexer allows you to automatically batch
         document indexing in pipelines, flushing it every N documents.
diff --git a/redis/commands/search/aggregation.py b/redis/commands/search/aggregation.py
index 3d71329c44..b1ac6b04dc 100644
--- a/redis/commands/search/aggregation.py
+++ b/redis/commands/search/aggregation.py
@@ -1,7 +1,7 @@
 FIELDNAME = object()
 
 
-class Limit(object):
+class Limit:
     def __init__(self, offset=0, count=0):
         self.offset = offset
         self.count = count
@@ -13,7 +13,7 @@ def build_args(self):
             return []
 
 
-class Reducer(object):
+class Reducer:
     """
     Base reducer object for all reducers.
 
@@ -55,7 +55,7 @@ def args(self):
         return self._args
 
 
-class SortDirection(object):
+class SortDirection:
     """
     This special class is used to indicate sort direction.
     """
@@ -82,7 +82,7 @@ class Desc(SortDirection):
     DIRSTRING = "DESC"
 
 
-class Group(object):
+class Group:
     """
     This object automatically created in the `AggregateRequest.group_by()`
     """
@@ -109,7 +109,7 @@ def build_args(self):
         return ret
 
 
-class Projection(object):
+class Projection:
     """
     This object automatically created in the `AggregateRequest.apply()`
     """
@@ -126,7 +126,7 @@ def build_args(self):
         return ret
 
 
-class SortBy(object):
+class SortBy:
     """
     This object automatically created in the `AggregateRequest.sort_by()`
     """
@@ -151,7 +151,7 @@ def build_args(self):
         return ret
 
 
-class AggregateRequest(object):
+class AggregateRequest:
     """
     Aggregation request which can be passed to `Client.aggregate`.
     """
@@ -370,7 +370,7 @@ def build_args(self):
         return ret
 
 
-class Cursor(object):
+class Cursor:
     def __init__(self, cid):
         self.cid = cid
         self.max_idle = 0
@@ -385,16 +385,15 @@ def build_args(self):
         return args
 
 
-class AggregateResult(object):
+class AggregateResult:
     def __init__(self, rows, cursor, schema):
         self.rows = rows
         self.cursor = cursor
         self.schema = schema
 
     def __repr__(self):
-        return "<{} at 0x{:x} Rows={}, Cursor={}>".format(
-            self.__class__.__name__,
-            id(self),
-            len(self.rows),
-            self.cursor.cid if self.cursor else -1,
+        cid = self.cursor.cid if self.cursor else -1
+        return (
+            f"<{self.__class__.__name__} at 0x{id(self):x} "
+            f"Rows={len(self.rows)}, Cursor={cid}>"
         )
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index ed58255fec..c19cb93e53 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -348,7 +348,7 @@ def _mk_query_args(self, query):
             # convert the query from a text to a query object
             query = Query(query)
         if not isinstance(query, Query):
-            raise ValueError("Bad query type %s" % type(query))
+            raise ValueError(f"Bad query type {type(query)}")
 
         args += query.get_args()
         return args, query
diff --git a/redis/commands/search/document.py b/redis/commands/search/document.py
index 0d4255db17..5b3050545a 100644
--- a/redis/commands/search/document.py
+++ b/redis/commands/search/document.py
@@ -1,4 +1,4 @@
-class Document(object):
+class Document:
     """
     Represents a single document in a result set
     """
@@ -10,4 +10,4 @@ def __init__(self, id, payload=None, **fields):
             setattr(self, k, v)
 
     def __repr__(self):
-        return "Document %s" % self.__dict__
+        return f"Document {self.__dict__}"
diff --git a/redis/commands/search/field.py b/redis/commands/search/field.py
index 45114a42b7..076c872b62 100644
--- a/redis/commands/search/field.py
+++ b/redis/commands/search/field.py
@@ -1,4 +1,4 @@
-class Field(object):
+class Field:
 
     NUMERIC = "NUMERIC"
     TEXT = "TEXT"
diff --git a/redis/commands/search/indexDefinition.py b/redis/commands/search/indexDefinition.py
index 4fbc6095c5..0c7a3b0635 100644
--- a/redis/commands/search/indexDefinition.py
+++ b/redis/commands/search/indexDefinition.py
@@ -8,7 +8,7 @@ class IndexType(Enum):
     JSON = 2
 
 
-class IndexDefinition(object):
+class IndexDefinition:
     """IndexDefinition is used to define a index definition for automatic
     indexing on Hash or Json update."""
 
@@ -38,8 +38,7 @@ def _appendIndexType(self, index_type):
         elif index_type is IndexType.JSON:
             self.args.extend(["ON", "JSON"])
         elif index_type is not None:
-            raise RuntimeError("index_type must be one of {}".
-                               format(list(IndexType)))
+            raise RuntimeError(f"index_type must be one of {list(IndexType)}")
 
     def _appendPrefix(self, prefix):
         """Append PREFIX."""
diff --git a/redis/commands/search/query.py b/redis/commands/search/query.py
index 85a8255334..5534f7b88e 100644
--- a/redis/commands/search/query.py
+++ b/redis/commands/search/query.py
@@ -1,4 +1,4 @@
-class Query(object):
+class Query:
     """
     Query is used to build complex queries that have more parameters than just
     the query string. The query string is set in the constructor, and other
@@ -291,7 +291,7 @@ def expander(self, expander):
         return self
 
 
-class Filter(object):
+class Filter:
     def __init__(self, keyword, field, *args):
         self.args = [keyword, field] + list(args)
 
@@ -303,8 +303,8 @@ class NumericFilter(Filter):
     def __init__(self, field, minval, maxval, minExclusive=False,
                  maxExclusive=False):
         args = [
-            minval if not minExclusive else "({}".format(minval),
-            maxval if not maxExclusive else "({}".format(maxval),
+            minval if not minExclusive else f"({minval}",
+            maxval if not maxExclusive else f"({maxval}",
         ]
 
         Filter.__init__(self, "FILTER", field, *args)
@@ -320,6 +320,6 @@ def __init__(self, field, lon, lat, radius, unit=KILOMETERS):
         Filter.__init__(self, "GEOFILTER", field, lon, lat, radius, unit)
 
 
-class SortbyField(object):
+class SortbyField:
     def __init__(self, field, asc=True):
         self.args = [field, "ASC" if asc else "DESC"]
diff --git a/redis/commands/search/querystring.py b/redis/commands/search/querystring.py
index aecd3b82f5..ffba542e31 100644
--- a/redis/commands/search/querystring.py
+++ b/redis/commands/search/querystring.py
@@ -61,7 +61,7 @@ def geo(lat, lon, radius, unit="km"):
     return GeoValue(lat, lon, radius, unit)
 
 
-class Value(object):
+class Value:
     @property
     def combinable(self):
         """
@@ -134,7 +134,7 @@ def __init__(self, lon, lat, radius, unit="km"):
         self.unit = unit
 
 
-class Node(object):
+class Node:
     def __init__(self, *children, **kwparams):
         """
         Create a node
@@ -197,13 +197,11 @@ def __init__(self, *children, **kwparams):
 
     def join_fields(self, key, vals):
         if len(vals) == 1:
-            return [BaseNode("@{}:{}".format(key, vals[0].to_string()))]
+            return [BaseNode(f"@{key}:{vals[0].to_string()}")]
         if not vals[0].combinable:
-            return [BaseNode("@{}:{}".format(key,
-                                             v.to_string())) for v in vals]
+            return [BaseNode(f"@{key}:{v.to_string()}") for v in vals]
         s = BaseNode(
-            "@{}:({})".format(key,
-                              self.JOINSTR.join(v.to_string() for v in vals))
+            f"@{key}:({self.JOINSTR.join(v.to_string() for v in vals)})"
         )
         return [s]
 
@@ -220,9 +218,7 @@ def JOINSTR(self):
     def to_string(self, with_parens=None):
         with_parens = self._should_use_paren(with_parens)
         pre, post = ("(", ")") if with_parens else ("", "")
-        return "{}{}{}".format(
-            pre, self.JOINSTR.join(n.to_string() for n in self.params), post
-        )
+        return f"{pre}{self.JOINSTR.join(n.to_string() for n in self.params)}{post}"
 
     def _should_use_paren(self, optval):
         if optval is not None:
@@ -235,7 +231,7 @@ def __str__(self):
 
 class BaseNode(Node):
     def __init__(self, s):
-        super(BaseNode, self).__init__()
+        super().__init__()
         self.s = str(s)
 
     def to_string(self, with_parens=None):
@@ -268,7 +264,7 @@ class DisjunctNode(IntersectNode):
 
     def to_string(self, with_parens=None):
         with_parens = self._should_use_paren(with_parens)
-        ret = super(DisjunctNode, self).to_string(with_parens=False)
+        ret = super().to_string(with_parens=False)
         if with_parens:
             return "(-" + ret + ")"
         else:
@@ -294,7 +290,7 @@ class OptionalNode(IntersectNode):
 
     def to_string(self, with_parens=None):
         with_parens = self._should_use_paren(with_parens)
-        ret = super(OptionalNode, self).to_string(with_parens=False)
+        ret = super().to_string(with_parens=False)
         if with_parens:
             return "(~" + ret + ")"
         else:
diff --git a/redis/commands/search/reducers.py b/redis/commands/search/reducers.py
index 6cbbf2f355..41ed11a238 100644
--- a/redis/commands/search/reducers.py
+++ b/redis/commands/search/reducers.py
@@ -3,7 +3,7 @@
 
 class FieldOnlyReducer(Reducer):
     def __init__(self, field):
-        super(FieldOnlyReducer, self).__init__(field)
+        super().__init__(field)
         self._field = field
 
 
@@ -15,7 +15,7 @@ class count(Reducer):
     NAME = "COUNT"
 
     def __init__(self):
-        super(count, self).__init__()
+        super().__init__()
 
 
 class sum(FieldOnlyReducer):
@@ -26,7 +26,7 @@ class sum(FieldOnlyReducer):
     NAME = "SUM"
 
     def __init__(self, field):
-        super(sum, self).__init__(field)
+        super().__init__(field)
 
 
 class min(FieldOnlyReducer):
@@ -37,7 +37,7 @@ class min(FieldOnlyReducer):
     NAME = "MIN"
 
     def __init__(self, field):
-        super(min, self).__init__(field)
+        super().__init__(field)
 
 
 class max(FieldOnlyReducer):
@@ -48,7 +48,7 @@ class max(FieldOnlyReducer):
     NAME = "MAX"
 
     def __init__(self, field):
-        super(max, self).__init__(field)
+        super().__init__(field)
 
 
 class avg(FieldOnlyReducer):
@@ -59,7 +59,7 @@ class avg(FieldOnlyReducer):
     NAME = "AVG"
 
     def __init__(self, field):
-        super(avg, self).__init__(field)
+        super().__init__(field)
 
 
 class tolist(FieldOnlyReducer):
@@ -70,7 +70,7 @@ class tolist(FieldOnlyReducer):
     NAME = "TOLIST"
 
     def __init__(self, field):
-        super(tolist, self).__init__(field)
+        super().__init__(field)
 
 
 class count_distinct(FieldOnlyReducer):
@@ -82,7 +82,7 @@ class count_distinct(FieldOnlyReducer):
     NAME = "COUNT_DISTINCT"
 
     def __init__(self, field):
-        super(count_distinct, self).__init__(field)
+        super().__init__(field)
 
 
 class count_distinctish(FieldOnlyReducer):
@@ -104,7 +104,7 @@ class quantile(Reducer):
     NAME = "QUANTILE"
 
     def __init__(self, field, pct):
-        super(quantile, self).__init__(field, str(pct))
+        super().__init__(field, str(pct))
         self._field = field
 
 
@@ -116,7 +116,7 @@ class stddev(FieldOnlyReducer):
     NAME = "STDDEV"
 
     def __init__(self, field):
-        super(stddev, self).__init__(field)
+        super().__init__(field)
 
 
 class first_value(Reducer):
@@ -155,7 +155,7 @@ def __init__(self, field, *byfields):
         args = [field]
         if fieldstrs:
             args += ["BY"] + fieldstrs
-        super(first_value, self).__init__(*args)
+        super().__init__(*args)
         self._field = field
 
 
@@ -174,5 +174,5 @@ def __init__(self, field, size):
         **size**: Return this many items (can be less)
         """
         args = [field, str(size)]
-        super(random_sample, self).__init__(*args)
+        super().__init__(*args)
         self._field = field
diff --git a/redis/commands/search/result.py b/redis/commands/search/result.py
index 9cd922ac1d..57ba53d5ca 100644
--- a/redis/commands/search/result.py
+++ b/redis/commands/search/result.py
@@ -2,7 +2,7 @@
 from ._util import to_string
 
 
-class Result(object):
+class Result:
     """
     Represents the result of a search query, and has an array of Document
     objects
@@ -70,4 +70,4 @@ def __init__(
             self.docs.append(doc)
 
     def __repr__(self):
-        return "Result{%d total, docs: %s}" % (self.total, self.docs)
+        return f"Result{{{self.total} total, docs: {self.docs}}}"
diff --git a/redis/commands/search/suggestion.py b/redis/commands/search/suggestion.py
index 3401af94eb..6d295a652f 100644
--- a/redis/commands/search/suggestion.py
+++ b/redis/commands/search/suggestion.py
@@ -1,7 +1,7 @@
 from ._util import to_string
 
 
-class Suggestion(object):
+class Suggestion:
     """
     Represents a single suggestion being sent or returned from the
     autocomplete server
@@ -16,7 +16,7 @@ def __repr__(self):
         return self.string
 
 
-class SuggestionParser(object):
+class SuggestionParser:
     """
     Internal class used to parse results from the `SUGGET` command.
     This needs to consume either 1, 2, or 3 values at a time from
diff --git a/redis/commands/timeseries/info.py b/redis/commands/timeseries/info.py
index 3b89503f18..2b8acd1b66 100644
--- a/redis/commands/timeseries/info.py
+++ b/redis/commands/timeseries/info.py
@@ -2,7 +2,7 @@
 from ..helpers import nativestr
 
 
-class TSInfo(object):
+class TSInfo:
     """
     Hold information and statistics on the time-series.
     Can be created using ``tsinfo`` command
diff --git a/redis/connection.py b/redis/connection.py
index 6ff3650805..ef3a667c16 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -107,8 +107,8 @@ def encode(self, value):
         elif not isinstance(value, str):
             # a value we don't know how to deal with. throw an error
             typename = type(value).__name__
-            raise DataError("Invalid input of type: '%s'. Convert to a "
-                            "bytes, string, int or float first." % typename)
+            raise DataError(f"Invalid input of type: '{typename}'. "
+                            f"Convert to a bytes, string, int or float first.")
         if isinstance(value, str):
             value = value.encode(self.encoding, self.encoding_errors)
         return value
@@ -214,8 +214,7 @@ def _read_from_socket(self, length=None, timeout=SENTINEL,
             allowed = NONBLOCKING_EXCEPTION_ERROR_NUMBERS.get(ex.__class__, -1)
             if not raise_on_timeout and ex.errno == allowed:
                 return False
-            raise ConnectionError("Error while reading from socket: %s" %
-                                  (ex.args,))
+            raise ConnectionError(f"Error while reading from socket: {ex.args}")
         finally:
             if custom_timeout:
                 sock.settimeout(self.socket_timeout)
@@ -323,7 +322,7 @@ def read_response(self, disable_decoding=False):
         byte, response = raw[:1], raw[1:]
 
         if byte not in (b'-', b'+', b':', b'$', b'*'):
-            raise InvalidResponse("Protocol Error: %r" % raw)
+            raise InvalidResponse(f"Protocol Error: {raw!r}")
 
         # server returned an error
         if byte == b'-':
@@ -445,8 +444,7 @@ def read_from_socket(self, timeout=SENTINEL, raise_on_timeout=True):
             allowed = NONBLOCKING_EXCEPTION_ERROR_NUMBERS.get(ex.__class__, -1)
             if not raise_on_timeout and ex.errno == allowed:
                 return False
-            raise ConnectionError("Error while reading from socket: %s" %
-                                  (ex.args,))
+            raise ConnectionError(f"Error while reading from socket: {ex.args}")
         finally:
             if custom_timeout:
                 sock.settimeout(self._socket_timeout)
@@ -538,8 +536,8 @@ def __init__(self, host='localhost', port=6379, db=0, password=None,
         self._buffer_cutoff = 6000
 
     def __repr__(self):
-        repr_args = ','.join(['%s=%s' % (k, v) for k, v in self.repr_pieces()])
-        return '%s<%s>' % (self.__class__.__name__, repr_args)
+        repr_args = ','.join([f'{k}={v}' for k, v in self.repr_pieces()])
+        return f'{self.__class__.__name__}<{repr_args}>'
 
     def repr_pieces(self):
         pieces = [
@@ -579,7 +577,7 @@ def connect(self):
             sock = self._connect()
         except socket.timeout:
             raise TimeoutError("Timeout connecting to server")
-        except socket.error as e:
+        except OSError as e:
             raise ConnectionError(self._error_message(e))
 
         self._sock = sock
@@ -646,11 +644,12 @@ def _error_message(self, exception):
         # args for socket.error can either be (errno, "message")
         # or just "message"
         if len(exception.args) == 1:
-            return "Error connecting to %s:%s. %s." % \
-                (self.host, self.port, exception.args[0])
+            return f"Error connecting to {self.host}:{self.port}. {exception.args[0]}."
         else:
-            return "Error %s connecting to %s:%s. %s." % \
-                (exception.args[0], self.host, self.port, exception.args[1])
+            return (
+                f"Error {exception.args[0]} connecting to "
+                f"{self.host}:{self.port}. {exception.args[1]}."
+            )
 
     def on_connect(self):
         "Initialize the connection, authenticate and select a database"
@@ -734,15 +733,14 @@ def send_packed_command(self, command, check_health=True):
         except socket.timeout:
             self.disconnect()
             raise TimeoutError("Timeout writing to socket")
-        except socket.error as e:
+        except OSError as e:
             self.disconnect()
             if len(e.args) == 1:
                 errno, errmsg = 'UNKNOWN', e.args[0]
             else:
                 errno = e.args[0]
                 errmsg = e.args[1]
-            raise ConnectionError("Error %s while writing to socket. %s." %
-                                  (errno, errmsg))
+            raise ConnectionError(f"Error {errno} while writing to socket. {errmsg}.")
         except BaseException:
             self.disconnect()
             raise
@@ -767,12 +765,12 @@ def read_response(self, disable_decoding=False):
             )
         except socket.timeout:
             self.disconnect()
-            raise TimeoutError("Timeout reading from %s:%s" %
-                               (self.host, self.port))
-        except socket.error as e:
+            raise TimeoutError(f"Timeout reading from {self.host}:{self.port}")
+        except OSError as e:
             self.disconnect()
-            raise ConnectionError("Error while reading from %s:%s : %s" %
-                                  (self.host, self.port, e.args))
+            raise ConnectionError(
+                f"Error while reading from {self.host}:{self.port}"
+                f" : {e.args}")
         except BaseException:
             self.disconnect()
             raise
@@ -867,8 +865,7 @@ def __init__(self, ssl_keyfile=None, ssl_certfile=None,
             }
             if ssl_cert_reqs not in CERT_REQS:
                 raise RedisError(
-                    "Invalid SSL Certificate Requirements Flag: %s" %
-                    ssl_cert_reqs)
+                    f"Invalid SSL Certificate Requirements Flag: {ssl_cert_reqs}")
             ssl_cert_reqs = CERT_REQS[ssl_cert_reqs]
         self.cert_reqs = ssl_cert_reqs
         self.ca_certs = ssl_ca_certs
@@ -947,11 +944,12 @@ def _error_message(self, exception):
         # args for socket.error can either be (errno, "message")
         # or just "message"
         if len(exception.args) == 1:
-            return "Error connecting to unix socket: %s. %s." % \
-                (self.path, exception.args[0])
+            return f"Error connecting to unix socket: {self.path}. {exception.args[0]}."
         else:
-            return "Error %s connecting to unix socket: %s. %s." % \
-                (exception.args[0], self.path, exception.args[1])
+            return (
+                f"Error {exception.args[0]} connecting to unix socket: "
+                f"{self.path}. {exception.args[1]}."
+            )
 
 
 FALSE_STRINGS = ('0', 'F', 'FALSE', 'N', 'NO')
@@ -990,7 +988,7 @@ def parse_url(url):
                     kwargs[name] = parser(value)
                 except (TypeError, ValueError):
                     raise ValueError(
-                        "Invalid value for `%s` in connection URL." % name
+                        f"Invalid value for `{name}` in connection URL."
                     )
             else:
                 kwargs[name] = value
@@ -1023,9 +1021,8 @@ def parse_url(url):
         if url.scheme == 'rediss':
             kwargs['connection_class'] = SSLConnection
     else:
-        valid_schemes = 'redis://, rediss://, unix://'
         raise ValueError('Redis URL must specify one of the following '
-                         'schemes (%s)' % valid_schemes)
+                         'schemes (redis://, rediss://, unix://)')
 
     return kwargs
 
@@ -1109,9 +1106,9 @@ def __init__(self, connection_class=Connection, max_connections=None,
         self.reset()
 
     def __repr__(self):
-        return "%s<%s>" % (
-            type(self).__name__,
-            repr(self.connection_class(**self.connection_kwargs)),
+        return (
+            f"{type(self).__name__}"
+            f"<{repr(self.connection_class(**self.connection_kwargs))}>"
         )
 
     def reset(self):
diff --git a/redis/sentinel.py b/redis/sentinel.py
index 3efd58fa39..06877bd167 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -24,9 +24,9 @@ def __init__(self, **kwargs):
 
     def __repr__(self):
         pool = self.connection_pool
-        s = '%s<service=%s%%s>' % (type(self).__name__, pool.service_name)
+        s = f'{type(self).__name__}<service={pool.service_name}%s>'
         if self.host:
-            host_info = ',host=%s,port=%s' % (self.host, self.port)
+            host_info = f',host={self.host},port={self.port}'
             s = s % host_info
         return s
 
@@ -91,11 +91,8 @@ def __init__(self, service_name, sentinel_manager, **kwargs):
         self.sentinel_manager = sentinel_manager
 
     def __repr__(self):
-        return "%s<service=%s(%s)" % (
-            type(self).__name__,
-            self.service_name,
-            self.is_master and 'master' or 'slave',
-        )
+        role = 'master' if self.is_master else 'slave'
+        return f"{type(self).__name__}<service={self.service_name}({role})"
 
     def reset(self):
         super().reset()
@@ -106,7 +103,7 @@ def owns_connection(self, connection):
         check = not self.is_master or \
                 (self.is_master and
                  self.master_address == (connection.host, connection.port))
-        parent = super(SentinelConnectionPool, self)
+        parent = super()
         return check and parent.owns_connection(connection)
 
     def get_master_address(self):
@@ -136,10 +133,10 @@ def rotate_slaves(self):
             yield self.get_master_address()
         except MasterNotFoundError:
             pass
-        raise SlaveNotFoundError('No slave found for %r' % (self.service_name))
+        raise SlaveNotFoundError(f'No slave found for {self.service_name!r}')
 
 
-class Sentinel(SentinelCommands, object):
+class Sentinel(SentinelCommands):
     """
     Redis Sentinel cluster client
 
@@ -205,13 +202,10 @@ def execute_command(self, *args, **kwargs):
     def __repr__(self):
         sentinel_addresses = []
         for sentinel in self.sentinels:
-            sentinel_addresses.append('%s:%s' % (
-                sentinel.connection_pool.connection_kwargs['host'],
-                sentinel.connection_pool.connection_kwargs['port'],
+            sentinel_addresses.append('{host}:{port}'.format_map(
+                sentinel.connection_pool.connection_kwargs,
             ))
-        return '%s<sentinels=[%s]>' % (
-            type(self).__name__,
-            ','.join(sentinel_addresses))
+        return f'{type(self).__name__}<sentinels=[{",".join(sentinel_addresses)}]>'
 
     def check_master_state(self, state, service_name):
         if not state['is_master'] or state['is_sdown'] or state['is_odown']:
@@ -240,7 +234,7 @@ def discover_master(self, service_name):
                 self.sentinels[0], self.sentinels[sentinel_no] = (
                     sentinel, self.sentinels[0])
                 return state['ip'], state['port']
-        raise MasterNotFoundError("No master found for %r" % (service_name,))
+        raise MasterNotFoundError(f"No master found for {service_name!r}")
 
     def filter_slaves(self, slaves):
         "Remove slaves that are in an ODOWN or SDOWN state"
diff --git a/tasks.py b/tasks.py
index e4821949d8..8d9c4c64be 100644
--- a/tasks.py
+++ b/tasks.py
@@ -16,7 +16,7 @@ def devenv(c):
     clean(c)
     cmd = 'tox -e devenv'
     for d in dockers:
-        cmd += " --docker-dont-stop={}".format(d)
+        cmd += f" --docker-dont-stop={d}"
     run(cmd)
 
 
@@ -73,7 +73,7 @@ def clean(c):
         shutil.rmtree("build")
     if os.path.isdir("dist"):
         shutil.rmtree("dist")
-    run("docker rm -f {}".format(' '.join(dockers)))
+    run(f"docker rm -f {' '.join(dockers)}")
 
 
 @task
diff --git a/tests/conftest.py b/tests/conftest.py
index ddc0834037..8ed39abddc 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -87,8 +87,7 @@ def wait_for_cluster_creation(redis_url, cluster_nodes, timeout=20):
     now = time.time()
     end_time = now + timeout
     client = None
-    print("Waiting for {0} cluster nodes to become available".
-          format(cluster_nodes))
+    print(f"Waiting for {cluster_nodes} cluster nodes to become available")
     while now < end_time:
         try:
             client = redis.RedisCluster.from_url(redis_url)
@@ -102,9 +101,8 @@ def wait_for_cluster_creation(redis_url, cluster_nodes, timeout=20):
     if now >= end_time:
         available_nodes = 0 if client is None else len(client.get_nodes())
         raise RedisClusterException(
-            "The cluster did not become available after {0} seconds. "
-            "Only {1} nodes out of {2} are available".format(
-                timeout, available_nodes, cluster_nodes))
+            f"The cluster did not become available after {timeout} seconds. "
+            f"Only {available_nodes} nodes out of {cluster_nodes} are available")
 
 
 def skip_if_server_version_lt(min_version):
@@ -112,7 +110,7 @@ def skip_if_server_version_lt(min_version):
     check = LooseVersion(redis_version) < LooseVersion(min_version)
     return pytest.mark.skipif(
         check,
-        reason="Redis version required >= {}".format(min_version))
+        reason=f"Redis version required >= {min_version}")
 
 
 def skip_if_server_version_gte(min_version):
@@ -120,12 +118,12 @@ def skip_if_server_version_gte(min_version):
     check = LooseVersion(redis_version) >= LooseVersion(min_version)
     return pytest.mark.skipif(
         check,
-        reason="Redis version required < {}".format(min_version))
+        reason=f"Redis version required < {min_version}")
 
 
 def skip_unless_arch_bits(arch_bits):
     return pytest.mark.skipif(REDIS_INFO["arch_bits"] != arch_bits,
-                              reason="server is not {}-bit".format(arch_bits))
+                              reason=f"server is not {arch_bits}-bit")
 
 
 def skip_ifmodversion_lt(min_version: str, module_name: str):
@@ -144,7 +142,7 @@ def skip_ifmodversion_lt(min_version: str, module_name: str):
             check = version < mv
             return pytest.mark.skipif(check, reason="Redis module version")
 
-    raise AttributeError("No redis module named {}".format(module_name))
+    raise AttributeError(f"No redis module named {module_name}")
 
 
 def skip_if_redis_enterprise(func):
@@ -320,8 +318,8 @@ def wait_for_command(client, monitor, command):
     if LooseVersion(redis_version) >= LooseVersion('5.0.0'):
         id_str = str(client.client_id())
     else:
-        id_str = '%08x' % random.randrange(2**32)
-    key = '__REDIS-PY-%s__' % id_str
+        id_str = f'{random.randrange(2 ** 32):08x}'
+    key = f'__REDIS-PY-{id_str}__'
     client.get(key)
     while True:
         monitor_response = monitor.next_command()
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 071cb7d2f1..d12e47ed02 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -178,7 +178,7 @@ def ok_response(connection, *args, **options):
                 return "MOCK_OK"
 
             parse_response.side_effect = ok_response
-            raise MovedError("{0} {1}:{2}".format(slot, r_host, r_port))
+            raise MovedError(f"{slot} {r_host}:{r_port}")
 
         parse_response.side_effect = moved_redirect_effect
         assert rc.execute_command("SET", "foo", "bar") == "MOCK_OK"
@@ -229,7 +229,7 @@ def test_empty_startup_nodes(self):
             "cluster"), str_if_bytes(ex.value)
 
     def test_from_url(self, r):
-        redis_url = "redis://{0}:{1}/0".format(default_host, default_port)
+        redis_url = f"redis://{default_host}:{default_port}/0"
         with patch.object(RedisCluster, 'from_url') as from_url:
             def from_url_mocked(_url, **_kwargs):
                 return get_mocked_redis_client(url=_url, **_kwargs)
@@ -333,8 +333,7 @@ def ok_response(connection, *args, **options):
                     return "MOCK_OK"
 
                 parse_response.side_effect = ok_response
-                raise AskError("12182 {0}:{1}".format(redirect_node.host,
-                                                      redirect_node.port))
+                raise AskError(f"12182 {redirect_node.host}:{redirect_node.port}")
 
             parse_response.side_effect = ask_redirect_effect
 
@@ -498,14 +497,14 @@ def test_keyslot(self, r):
         assert r.keyslot(125) == r.keyslot(b"125")
         assert r.keyslot(125) == r.keyslot("\x31\x32\x35")
         assert r.keyslot("大奖") == r.keyslot(b"\xe5\xa4\xa7\xe5\xa5\x96")
-        assert r.keyslot(u"大奖") == r.keyslot(b"\xe5\xa4\xa7\xe5\xa5\x96")
+        assert r.keyslot("大奖") == r.keyslot(b"\xe5\xa4\xa7\xe5\xa5\x96")
         assert r.keyslot(1337.1234) == r.keyslot("1337.1234")
         assert r.keyslot(1337) == r.keyslot("1337")
         assert r.keyslot(b"abc") == r.keyslot("abc")
 
     def test_get_node_name(self):
         assert get_node_name(default_host, default_port) == \
-               "{0}:{1}".format(default_host, default_port)
+               f"{default_host}:{default_port}"
 
     def test_all_nodes(self, r):
         """
@@ -713,7 +712,7 @@ def test_pubsub_channels_merge_results(self, r):
         pubsub_nodes = []
         i = 0
         for node in nodes:
-            channel = "foo{0}".format(i)
+            channel = f"foo{i}"
             # We will create different pubsub clients where each one is
             # connected to a different node
             p = r.pubsub(node)
@@ -1180,8 +1179,7 @@ def test_client_kill(self, r, r2):
         clients = [client for client in r.client_list(target_nodes=node)
                    if client.get('name') in ['redis-py-c1', 'redis-py-c2']]
         assert len(clients) == 2
-        clients_by_name = dict([(client.get('name'), client)
-                                for client in clients])
+        clients_by_name = {client.get('name'): client for client in clients}
 
         client_addr = clients_by_name['redis-py-c2'].get('addr')
         assert r.client_kill(client_addr, target_nodes=node) is True
@@ -2374,8 +2372,7 @@ def test_asking_error(self, r):
             warnings.warn("skipping this test since the cluster has only one "
                           "node")
             return
-        ask_msg = "{0} {1}:{2}".format(r.keyslot(key), ask_node.host,
-                                       ask_node.port)
+        ask_msg = f"{r.keyslot(key)} {ask_node.host}:{ask_node.port}"
 
         def raise_ask_error():
             raise AskError(ask_msg)
@@ -2435,9 +2432,7 @@ def test_moved_redirection_on_slave_with_default(self, r):
         with r.pipeline() as readwrite_pipe:
             mock_node_resp(primary, "MOCK_FOO")
             if replica is not None:
-                moved_error = "{0} {1}:{2}".format(r.keyslot(key),
-                                                   primary.host,
-                                                   primary.port)
+                moved_error = f"{r.keyslot(key)} {primary.host}:{primary.port}"
 
                 def raise_moved_error():
                     raise MovedError(moved_error)
diff --git a/tests/test_commands.py b/tests/test_commands.py
index f526ae5dd6..444a163489 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -35,7 +35,7 @@ def cleanup():
 
 def redis_server_time(client):
     seconds, milliseconds = client.time()
-    timestamp = float('%s.%s' % (seconds, milliseconds))
+    timestamp = float(f'{seconds}.{milliseconds}')
     return datetime.datetime.fromtimestamp(timestamp)
 
 
@@ -99,7 +99,7 @@ def teardown():
         assert r.acl_deluser(username) == 1
 
         # now, a group of users
-        users = ['bogususer_%d' % r for r in range(0, 5)]
+        users = [f'bogususer_{r}' for r in range(0, 5)]
         for u in users:
             r.acl_setuser(u, enabled=False, reset=True)
         assert r.acl_deluser(*users) > 1
@@ -162,11 +162,11 @@ def teardown():
                              commands=['+get', '+mget', '-hset'],
                              keys=['cache:*', 'objects:*'])
         acl = r.acl_getuser(username)
-        assert set(acl['categories']) == set(['-@all', '+@set', '+@hash'])
-        assert set(acl['commands']) == set(['+get', '+mget', '-hset'])
+        assert set(acl['categories']) == {'-@all', '+@set', '+@hash'}
+        assert set(acl['commands']) == {'+get', '+mget', '-hset'}
         assert acl['enabled'] is True
         assert 'on' in acl['flags']
-        assert set(acl['keys']) == set([b'cache:*', b'objects:*'])
+        assert set(acl['keys']) == {b'cache:*', b'objects:*'}
         assert len(acl['passwords']) == 2
 
         # test reset=False keeps existing ACL and applies new ACL on top
@@ -181,11 +181,11 @@ def teardown():
                              commands=['+mget'],
                              keys=['objects:*'])
         acl = r.acl_getuser(username)
-        assert set(acl['categories']) == set(['-@all', '+@set', '+@hash'])
-        assert set(acl['commands']) == set(['+get', '+mget'])
+        assert set(acl['categories']) == {'-@all', '+@set', '+@hash'}
+        assert set(acl['commands']) == {'+get', '+mget'}
         assert acl['enabled'] is True
         assert 'on' in acl['flags']
-        assert set(acl['keys']) == set([b'cache:*', b'objects:*'])
+        assert set(acl['keys']) == {b'cache:*', b'objects:*'}
         assert len(acl['passwords']) == 2
 
         # test removal of passwords
@@ -405,8 +405,7 @@ def test_client_kill(self, r, r2):
                    if client.get('name') in ['redis-py-c1', 'redis-py-c2']]
         assert len(clients) == 2
 
-        clients_by_name = dict([(client.get('name'), client)
-                                for client in clients])
+        clients_by_name = {client.get('name'): client for client in clients}
 
         client_addr = clients_by_name['redis-py-c2'].get('addr')
         assert r.client_kill(client_addr) is True
@@ -439,8 +438,7 @@ def test_client_kill_filter_by_id(self, r, r2):
                    if client.get('name') in ['redis-py-c1', 'redis-py-c2']]
         assert len(clients) == 2
 
-        clients_by_name = dict([(client.get('name'), client)
-                                for client in clients])
+        clients_by_name = {client.get('name'): client for client in clients}
 
         client_2_id = clients_by_name['redis-py-c2'].get('id')
         resp = r.client_kill_filter(_id=client_2_id)
@@ -460,8 +458,7 @@ def test_client_kill_filter_by_addr(self, r, r2):
                    if client.get('name') in ['redis-py-c1', 'redis-py-c2']]
         assert len(clients) == 2
 
-        clients_by_name = dict([(client.get('name'), client)
-                                for client in clients])
+        clients_by_name = {client.get('name'): client for client in clients}
 
         client_2_addr = clients_by_name['redis-py-c2'].get('addr')
         resp = r.client_kill_filter(addr=client_2_addr)
@@ -487,8 +484,7 @@ def test_client_kill_filter_by_laddr(self, r, r2):
                    if client.get('name') in ['redis-py-c1', 'redis-py-c2']]
         assert len(clients) == 2
 
-        clients_by_name = dict([(client.get('name'), client)
-                                for client in clients])
+        clients_by_name = {client.get('name'): client for client in clients}
 
         client_2_addr = clients_by_name['redis-py-c2'].get('laddr')
         assert r.client_kill_filter(laddr=client_2_addr)
@@ -1809,11 +1805,11 @@ def test_zadd_incr_with_xx(self, r):
     def test_zadd_gt_lt(self, r):
 
         for i in range(1, 20):
-            r.zadd('a', {'a%s' % i: i})
+            r.zadd('a', {f'a{i}': i})
         assert r.zadd('a', {'a20': 5}, gt=3) == 1
 
         for i in range(1, 20):
-            r.zadd('a', {'a%s' % i: i})
+            r.zadd('a', {f'a{i}': i})
         assert r.zadd('a', {'a2': 5}, lt=1) == 0
 
         # cannot use both nx and xx options
diff --git a/tests/test_connection.py b/tests/test_connection.py
index cd8907d85c..0071acab5c 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -15,7 +15,7 @@ def test_invalid_response(r):
     with mock.patch.object(parser._buffer, 'readline', return_value=raw):
         with pytest.raises(InvalidResponse) as cm:
             parser.read_response()
-    assert str(cm.value) == 'Protocol Error: %r' % raw
+    assert str(cm.value) == f'Protocol Error: {raw!r}'
 
 
 @skip_if_server_version_lt('4.0.0')
diff --git a/tests/test_multiprocessing.py b/tests/test_multiprocessing.py
index d0feef155f..5968b2b4fe 100644
--- a/tests/test_multiprocessing.py
+++ b/tests/test_multiprocessing.py
@@ -89,9 +89,7 @@ def test_pool(self, max_connections, master_host):
         A child will create its own connections when using a pool created
         by a parent.
         """
-        pool = ConnectionPool.from_url('redis://{}:{}'.format(master_host[0],
-                                                              master_host[1],
-                                                              ),
+        pool = ConnectionPool.from_url(f'redis://{master_host[0]}:{master_host[1]}',
                                        max_connections=max_connections)
 
         conn = pool.get_connection('ping')
@@ -126,8 +124,7 @@ def test_close_pool_in_main(self, max_connections, master_host):
         A child process that uses the same pool as its parent isn't affected
         when the parent disconnects all connections within the pool.
         """
-        pool = ConnectionPool.from_url('redis://{}:{}'.format(master_host[0],
-                                                              master_host[1]),
+        pool = ConnectionPool.from_url(f'redis://{master_host[0]}:{master_host[1]}',
                                        max_connections=max_connections)
 
         conn = pool.get_connection('ping')
diff --git a/tests/test_pipeline.py b/tests/test_pipeline.py
index a759bc944e..a87ed7182d 100644
--- a/tests/test_pipeline.py
+++ b/tests/test_pipeline.py
@@ -345,7 +345,7 @@ def test_exec_error_in_no_transaction_pipeline_unicode_command(self, r):
             with pytest.raises(redis.ResponseError) as ex:
                 pipe.execute()
 
-            expected = 'Command # 1 (LLEN %s) of pipeline caused error: ' % key
+            expected = f'Command # 1 (LLEN {key}) of pipeline caused error: '
             assert str(ex.value).startswith(expected)
 
         assert r[key] == b'1'
diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index 95513a09a8..b019bae6e2 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -55,7 +55,7 @@ def make_subscribe_test_data(pubsub, type):
             'unsub_func': pubsub.punsubscribe,
             'keys': ['f*', 'b*', 'uni' + chr(4456) + '*']
         }
-    assert False, 'invalid subscribe type: %s' % type
+    assert False, f'invalid subscribe type: {type}'
 
 
 class TestPubSubSubscribeUnsubscribe:
diff --git a/tests/test_search.py b/tests/test_search.py
index b65ac8dcbf..c7b570cdd1 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -99,7 +99,7 @@ def createIndex(client, num_docs=100, definition=None):
         play, chapter, _, text = \
             line[1], line[2], line[4], line[5]
 
-        key = "{}:{}".format(play, chapter).lower()
+        key = f"{play}:{chapter}".lower()
         d = chapters.setdefault(key, {})
         d["play"] = play
         d["txt"] = d.get("txt", "") + " " + text
@@ -861,7 +861,7 @@ def test_phonetic_matcher(client):
 
     res = client.ft().search(Query("Jon"))
     assert 2 == len(res.docs)
-    assert ["John", "Jon"] == sorted([d.name for d in res.docs])
+    assert ["John", "Jon"] == sorted(d.name for d in res.docs)
 
 
 @pytest.mark.redismod
diff --git a/tests/test_timeseries.py b/tests/test_timeseries.py
index c0fb09e226..07433574f1 100644
--- a/tests/test_timeseries.py
+++ b/tests/test_timeseries.py
@@ -31,7 +31,7 @@ def test_create(client):
 def test_create_duplicate_policy(client):
     # Test for duplicate policy
     for duplicate_policy in ["block", "last", "first", "min", "max"]:
-        ts_name = "time-serie-ooo-{0}".format(duplicate_policy)
+        ts_name = f"time-serie-ooo-{duplicate_policy}"
         assert client.ts().create(ts_name, duplicate_policy=duplicate_policy)
         info = client.ts().info(ts_name)
         assert duplicate_policy == info.duplicate_policy
diff --git a/tox.ini b/tox.ini
index dd68274f2d..d06f7e3d1e 100644
--- a/tox.ini
+++ b/tox.ini
@@ -130,8 +130,9 @@ commands = /usr/bin/echo
 deps_files = dev_requirements.txt
 docker =
 commands =
-    flake8
+    flake8 --max-line-length=88
     vulture redis whitelist.py --min-confidence 80
+    flynt --fail-on-change --dry-run .
 skipsdist = true
 skip_install = true
 

From 3da0b131ac52b82a1e4a90871a81a41a0ff63a9f Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 30 Nov 2021 17:21:22 +0200
Subject: [PATCH 0276/1164] Updating cluster docker location (#1760)

---
 tox.ini | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tox.ini b/tox.ini
index d06f7e3d1e..f710bbaca8 100644
--- a/tox.ini
+++ b/tox.ini
@@ -78,7 +78,7 @@ volumes =
 
 [docker:redis_cluster]
 name = redis_cluster
-image = barshaul/redis-py:6.2.6-cluster
+image = redisfab/redis-py-cluster:6.2.6-buster
 ports =
     16379:16379/tcp
     16380:16380/tcp

From d5247091464f91f06d8ca71bb785b448a0d4cc3e Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 30 Nov 2021 17:22:19 +0200
Subject: [PATCH 0277/1164] Link Documents for all module commands (#1711)

---
 docs/index.rst                        |   2 +-
 redis/commands/json/commands.py       |  86 ++++++++++++++-----
 redis/commands/search/commands.py     | 118 +++++++++++++++++---------
 redis/commands/timeseries/commands.py |  62 ++++++++------
 4 files changed, 181 insertions(+), 87 deletions(-)

diff --git a/docs/index.rst b/docs/index.rst
index 392acadf5b..8e243f3e28 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -73,4 +73,4 @@ Contributing
 License
 *******
 
-This projectis licensed under the `MIT license <https://github.com/redis/redis-py/blob/master/LICENSE>`_.
\ No newline at end of file
+This projectis licensed under the `MIT license <https://github.com/redis/redis-py/blob/master/LICENSE>`_.
diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index 4436f6aa34..1affaafaf6 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -10,7 +10,9 @@ class JSONCommands:
     def arrappend(self, name, path=Path.rootPath(), *args):
         """Append the objects ``args`` to the array under the
         ``path` in key ``name``.
-        """
+
+        For more information: https://oss.redis.com/redisjson/commands/#jsonarrappend
+        """  # noqa
         pieces = [name, str(path)]
         for o in args:
             pieces.append(self._encode(o))
@@ -23,7 +25,9 @@ def arrindex(self, name, path, scalar, start=0, stop=-1):
 
         The search can be limited using the optional inclusive ``start``
         and exclusive ``stop`` indices.
-        """
+
+        For more information: https://oss.redis.com/redisjson/commands/#jsonarrindex
+        """  # noqa
         return self.execute_command(
             "JSON.ARRINDEX", name, str(path), self._encode(scalar),
             start, stop
@@ -32,7 +36,9 @@ def arrindex(self, name, path, scalar, start=0, stop=-1):
     def arrinsert(self, name, path, index, *args):
         """Insert the objects ``args`` to the array at index ``index``
         under the ``path` in key ``name``.
-        """
+
+        For more information: https://oss.redis.com/redisjson/commands/#jsonarrinsert
+        """  # noqa
         pieces = [name, str(path), index]
         for o in args:
             pieces.append(self._encode(o))
@@ -41,45 +47,64 @@ def arrinsert(self, name, path, index, *args):
     def arrlen(self, name, path=Path.rootPath()):
         """Return the length of the array JSON value under ``path``
         at key``name``.
-        """
+
+        For more information: https://oss.redis.com/redisjson/commands/#jsonarrlen
+        """  # noqa
         return self.execute_command("JSON.ARRLEN", name, str(path))
 
     def arrpop(self, name, path=Path.rootPath(), index=-1):
         """Pop the element at ``index`` in the array JSON value under
         ``path`` at key ``name``.
-        """
+
+        For more information: https://oss.redis.com/redisjson/commands/#jsonarrpop
+        """  # noqa
         return self.execute_command("JSON.ARRPOP", name, str(path), index)
 
     def arrtrim(self, name, path, start, stop):
         """Trim the array JSON value under ``path`` at key ``name`` to the
         inclusive range given by ``start`` and ``stop``.
-        """
+
+        For more information: https://oss.redis.com/redisjson/commands/#jsonarrtrim
+        """  # noqa
         return self.execute_command("JSON.ARRTRIM", name, str(path),
                                     start, stop)
 
     def type(self, name, path=Path.rootPath()):
-        """Get the type of the JSON value under ``path`` from key ``name``."""
+        """Get the type of the JSON value under ``path`` from key ``name``.
+
+        For more information: https://oss.redis.com/redisjson/commands/#jsontype
+        """  # noqa
         return self.execute_command("JSON.TYPE", name, str(path))
 
     def resp(self, name, path=Path.rootPath()):
-        """Return the JSON value under ``path`` at key ``name``."""
+        """Return the JSON value under ``path`` at key ``name``.
+
+        For more information: https://oss.redis.com/redisjson/commands/#jsonresp
+        """  # noqa
         return self.execute_command("JSON.RESP", name, str(path))
 
     def objkeys(self, name, path=Path.rootPath()):
         """Return the key names in the dictionary JSON value under ``path`` at
-        key ``name``."""
+        key ``name``.
+
+        For more information: https://oss.redis.com/redisjson/commands/#jsonobjkeys
+        """  # noqa
         return self.execute_command("JSON.OBJKEYS", name, str(path))
 
     def objlen(self, name, path=Path.rootPath()):
         """Return the length of the dictionary JSON value under ``path`` at key
         ``name``.
-        """
+
+        For more information: https://oss.redis.com/redisjson/commands/#jsonobjlen
+        """  # noqa
         return self.execute_command("JSON.OBJLEN", name, str(path))
 
     def numincrby(self, name, path, number):
         """Increment the numeric (integer or floating point) JSON value under
         ``path`` at key ``name`` by the provided ``number``.
-        """
+
+        For more information: https://oss.redis.com/redisjson/commands/#jsonnumincrby
+        """  # noqa
         return self.execute_command(
             "JSON.NUMINCRBY", name, str(path), self._encode(number)
         )
@@ -88,7 +113,9 @@ def numincrby(self, name, path, number):
     def nummultby(self, name, path, number):
         """Multiply the numeric (integer or floating point) JSON value under
         ``path`` at key ``name`` with the provided ``number``.
-        """
+
+        For more information: https://oss.redis.com/redisjson/commands/#jsonnummultby
+        """  # noqa
         return self.execute_command(
             "JSON.NUMMULTBY", name, str(path), self._encode(number)
         )
@@ -100,11 +127,16 @@ def clear(self, name, path=Path.rootPath()):
 
         Return the count of cleared paths (ignoring non-array and non-objects
         paths).
-        """
+
+        For more information: https://oss.redis.com/redisjson/commands/#jsonclear
+        """  # noqa
         return self.execute_command("JSON.CLEAR", name, str(path))
 
     def delete(self, key, path=Path.rootPath()):
-        """Delete the JSON value stored at key ``key`` under ``path``."""
+        """Delete the JSON value stored at key ``key`` under ``path``.
+
+        For more information: https://oss.redis.com/redisjson/commands/#jsondel
+        """
         return self.execute_command("JSON.DEL", key, str(path))
 
     # forget is an alias for delete
@@ -117,7 +149,9 @@ def get(self, name, *args, no_escape=False):
         ``args`` is zero or more paths, and defaults to root path
         ```no_escape`` is a boolean flag to add no_escape option to get
         non-ascii characters
-        """
+
+        For more information: https://oss.redis.com/redisjson/commands/#jsonget
+        """  # noqa
         pieces = [name]
         if no_escape:
             pieces.append("noescape")
@@ -140,7 +174,9 @@ def mget(self, keys, path):
         """
         Get the objects stored as a JSON values under ``path``. ``keys``
         is a list of one or more keys.
-        """
+
+        For more information: https://oss.redis.com/redisjson/commands/#jsonmget
+        """  # noqa
         pieces = []
         pieces += keys
         pieces.append(str(path))
@@ -157,6 +193,8 @@ def set(self, name, path, obj, nx=False, xx=False, decode_keys=False):
 
         For the purpose of using this within a pipeline, this command is also
         aliased to jsonset.
+
+        For more information: https://oss.redis.com/redisjson/commands/#jsonset
         """
         if decode_keys:
             obj = decode_dict_keys(obj)
@@ -178,7 +216,9 @@ def set(self, name, path, obj, nx=False, xx=False, decode_keys=False):
     def strlen(self, name, path=None):
         """Return the length of the string JSON value under ``path`` at key
         ``name``.
-        """
+
+        For more information: https://oss.redis.com/redisjson/commands/#jsonstrlen
+        """   # noqa
         pieces = [name]
         if path is not None:
             pieces.append(str(path))
@@ -187,14 +227,18 @@ def strlen(self, name, path=None):
     def toggle(self, name, path=Path.rootPath()):
         """Toggle boolean value under ``path`` at key ``name``.
         returning the new value.
-        """
+
+        For more information: https://oss.redis.com/redisjson/commands/#jsontoggle
+        """  # noqa
         return self.execute_command("JSON.TOGGLE", name, str(path))
 
     def strappend(self, name, value, path=Path.rootPath()):
         """Append to the string JSON value. If two options are specified after
         the key name, the path is determined to be the first. If a single
         option is passed, then the rootpath (i.e Path.rootPath()) is used.
-        """
+
+        For more information: https://oss.redis.com/redisjson/commands/#jsonstrappend
+        """  # noqa
         pieces = [name, str(path), self._encode(value)]
         return self.execute_command(
             "JSON.STRAPPEND", *pieces
@@ -203,7 +247,9 @@ def strappend(self, name, value, path=Path.rootPath()):
     def debug(self, subcommand, key=None, path=Path.rootPath()):
         """Return the memory usage in bytes of a value under ``path`` from
         key ``name``.
-        """
+
+        For more information: https://oss.redis.com/redisjson/commands/#jsondebg
+        """  # noqa
         valid_subcommands = ["MEMORY", "HELP"]
         if subcommand not in valid_subcommands:
             raise DataError("The only valid subcommands are ",
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index c19cb93e53..553bc39839 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -79,7 +79,9 @@ def create_index(
         allow searching in specific fields
         - **stopwords**: If not None, we create the index with this custom
         stopword list. The list can be empty
-        """
+
+        For more information: https://oss.redis.com/redisearch/Commands/#ftcreate
+        """  # noqa
 
         args = [CREATE_CMD, self.index_name]
         if definition is not None:
@@ -109,7 +111,9 @@ def alter_schema_add(self, fields):
         ### Parameters:
 
         - **fields**: a list of Field objects to add for the index
-        """
+
+        For more information: https://oss.redis.com/redisearch/Commands/#ftalter_schema_add
+        """  # noqa
 
         args = [ALTER_CMD, self.index_name, "SCHEMA", "ADD"]
         try:
@@ -119,17 +123,6 @@ def alter_schema_add(self, fields):
 
         return self.execute_command(*args)
 
-    def drop_index(self, delete_documents=True):
-        """
-        Drop the index if it exists. Deprecated from RediSearch 2.0.
-
-        ### Parameters:
-
-        - **delete_documents**: If `True`, all documents will be deleted.
-        """
-        keep_str = "" if delete_documents else "KEEPDOCS"
-        return self.execute_command(DROP_CMD, self.index_name, keep_str)
-
     def dropindex(self, delete_documents=False):
         """
         Drop the index if it exists.
@@ -139,7 +132,8 @@ def dropindex(self, delete_documents=False):
         ### Parameters:
 
         - **delete_documents**: If `True`, all documents will be deleted.
-        """
+        For more information: https://oss.redis.com/redisearch/Commands/#ftdropindex
+        """  # noqa
         keep_str = "" if delete_documents else "KEEPDOCS"
         return self.execute_command(DROP_CMD, self.index_name, keep_str)
 
@@ -246,7 +240,9 @@ def add_document(
         - **fields** kwargs dictionary of the document fields to be saved
                          and/or indexed.
                      NOTE: Geo points shoule be encoded as strings of "lon,lat"
-        """
+
+        For more information: https://oss.redis.com/redisearch/Commands/#ftadd
+        """  # noqa
         return self._add_document(
             doc_id,
             conn=None,
@@ -278,7 +274,9 @@ def add_document_hash(
         - **replace**: if True, and the document already is in the index, we
                       perform an update and reindex the document
         - **language**: Specify the language used for document tokenization.
-        """
+        
+        For more information: https://oss.redis.com/redisearch/Commands/#ftaddhash
+        """  # noqa
         return self._add_document_hash(
             doc_id,
             conn=None,
@@ -296,7 +294,9 @@ def delete_document(self, doc_id, conn=None, delete_actual_document=False):
 
         - **delete_actual_document**: if set to True, RediSearch also delete
                                       the actual document if it is in the index
-        """
+                                      
+        For more information: https://oss.redis.com/redisearch/Commands/#ftdel
+        """  # noqa
         args = [DEL_CMD, self.index_name, doc_id]
         if conn is None:
             conn = self.client
@@ -327,6 +327,8 @@ def get(self, *ids):
         ### Parameters
 
         - **ids**: the ids of the saved documents.
+
+        For more information https://oss.redis.com/redisearch/Commands/#ftget
         """
 
         return self.client.execute_command(MGET_CMD, self.index_name, *ids)
@@ -335,6 +337,8 @@ def info(self):
         """
         Get info an stats about the the current index, including the number of
         documents, memory consumption, etc
+
+        For more information https://oss.redis.com/redisearch/Commands/#ftinfo
         """
 
         res = self.client.execute_command(INFO_CMD, self.index_name)
@@ -362,7 +366,9 @@ def search(self, query):
         - **query**: the search query. Either a text for simple queries with
                      default parameters, or a Query object for complex queries.
                      See RediSearch's documentation on query format
-        """
+
+        For more information: https://oss.redis.com/redisearch/Commands/#ftsearch
+        """  # noqa
         args, query = self._mk_query_args(query)
         st = time.time()
         res = self.execute_command(SEARCH_CMD, *args)
@@ -376,6 +382,10 @@ def search(self, query):
         )
 
     def explain(self, query):
+        """Returns the execution plan for a complex query.
+
+        For more information: https://oss.redis.com/redisearch/Commands/#ftexplain
+        """  # noqa
         args, query_text = self._mk_query_args(query)
         return self.execute_command(EXPLAIN_CMD, *args)
 
@@ -392,7 +402,9 @@ def aggregate(self, query):
 
         An `AggregateResult` object is returned. You can access the rows from
         its `rows` property, which will always yield the rows of the result.
-        """
+
+        Fpr more information: https://oss.redis.com/redisearch/Commands/#ftaggregate
+        """  # noqa
         if isinstance(query, AggregateRequest):
             has_cursor = bool(query._cursor)
             cmd = [AGGREGATE_CMD, self.index_name] + query.build_args()
@@ -477,7 +489,9 @@ def spellcheck(self, query, distance=None, include=None, exclude=None):
                        suggestions (default: 1, max: 4).
         **include**: specifies an inclusion custom dictionary.
         **exclude**: specifies an exclusion custom dictionary.
-        """
+
+        For more information: https://oss.redis.com/redisearch/Commands/#ftspellcheck
+        """  # noqa
         cmd = [SPELLCHECK_CMD, self.index_name, query]
         if distance:
             cmd.extend(["DISTANCE", distance])
@@ -534,7 +548,9 @@ def dict_add(self, name, *terms):
 
         - **name**: Dictionary name.
         - **terms**: List of items for adding to the dictionary.
-        """
+
+        For more information: https://oss.redis.com/redisearch/Commands/#ftdictadd
+        """  # noqa
         cmd = [DICT_ADD_CMD, name]
         cmd.extend(terms)
         return self.execute_command(*cmd)
@@ -546,7 +562,9 @@ def dict_del(self, name, *terms):
 
         - **name**: Dictionary name.
         - **terms**: List of items for removing from the dictionary.
-        """
+
+        For more information: https://oss.redis.com/redisearch/Commands/#ftdictdel
+        """  # noqa
         cmd = [DICT_DEL_CMD, name]
         cmd.extend(terms)
         return self.execute_command(*cmd)
@@ -557,7 +575,9 @@ def dict_dump(self, name):
         ### Parameters
 
         - **name**: Dictionary name.
-        """
+
+        For more information: https://oss.redis.com/redisearch/Commands/#ftdictdump
+        """  # noqa
         cmd = [DICT_DUMP_CMD, name]
         return self.execute_command(*cmd)
 
@@ -568,7 +588,9 @@ def config_set(self, option, value):
 
         - **option**: the name of the configuration option.
         - **value**: a value for the configuration option.
-        """
+
+        For more information: https://oss.redis.com/redisearch/Commands/#ftconfig
+        """  # noqa
         cmd = [CONFIG_CMD, "SET", option, value]
         raw = self.execute_command(*cmd)
         return raw == "OK"
@@ -579,7 +601,9 @@ def config_get(self, option):
         ### Parameters
 
         - **option**: the name of the configuration option.
-        """
+
+        For more information: https://oss.redis.com/redisearch/Commands/#ftconfig
+        """  # noqa
         cmd = [CONFIG_CMD, "GET", option]
         res = {}
         raw = self.execute_command(*cmd)
@@ -595,7 +619,9 @@ def tagvals(self, tagfield):
         ### Parameters
 
         - **tagfield**: Tag field name
-        """
+
+        For more information: https://oss.redis.com/redisearch/Commands/#fttagvals
+        """  # noqa
 
         return self.execute_command(TAGVALS_CMD, self.index_name, tagfield)
 
@@ -606,7 +632,9 @@ def aliasadd(self, alias):
         ### Parameters
 
         - **alias**: Name of the alias to create
-        """
+
+        For more information: https://oss.redis.com/redisearch/Commands/#ftaliasadd
+        """  # noqa
 
         return self.execute_command(ALIAS_ADD_CMD, alias, self.index_name)
 
@@ -617,7 +645,9 @@ def aliasupdate(self, alias):
         ### Parameters
 
         - **alias**: Name of the alias to create
-        """
+
+        For more information: https://oss.redis.com/redisearch/Commands/#ftaliasupdate
+        """  # noqa
 
         return self.execute_command(ALIAS_UPDATE_CMD, alias, self.index_name)
 
@@ -628,7 +658,9 @@ def aliasdel(self, alias):
         ### Parameters
 
         - **alias**: Name of the alias to delete
-        """
+
+        For more information: https://oss.redis.com/redisearch/Commands/#ftaliasdel
+        """  # noqa
         return self.execute_command(ALIAS_DEL_CMD, alias)
 
     def sugadd(self, key, *suggestions, **kwargs):
@@ -637,8 +669,9 @@ def sugadd(self, key, *suggestions, **kwargs):
         a score and string.
         If kwargs["increment"] is true and the terms are already in the
         server's dictionary, we increment their scores.
-        More information `here <https://oss.redis.com/redisearch/master/Commands/#ftsugadd>`_.  # noqa
-        """
+
+        For more information: https://oss.redis.com/redisearch/master/Commands/#ftsugadd
+        """  # noqa
         # If Transaction is not False it will MULTI/EXEC which will error
         pipe = self.pipeline(transaction=False)
         for sug in suggestions:
@@ -656,16 +689,18 @@ def sugadd(self, key, *suggestions, **kwargs):
     def suglen(self, key):
         """
         Return the number of entries in the AutoCompleter index.
-        More information `here <https://oss.redis.com/redisearch/master/Commands/#ftsuglen>`_.  # noqa
-        """
+
+        For more information https://oss.redis.com/redisearch/master/Commands/#ftsuglen
+        """  # noqa
         return self.execute_command(SUGLEN_COMMAND, key)
 
     def sugdel(self, key, string):
         """
         Delete a string from the AutoCompleter index.
         Returns 1 if the string was found and deleted, 0 otherwise.
-        More information `here <https://oss.redis.com/redisearch/master/Commands/#ftsugdel>`_.  # noqa
-        """
+
+        For more information: https://oss.redis.com/redisearch/master/Commands/#ftsugdel
+        """  # noqa
         return self.execute_command(SUGDEL_COMMAND, key, string)
 
     def sugget(
@@ -674,7 +709,6 @@ def sugget(
     ):
         """
         Get a list of suggestions from the AutoCompleter, for a given prefix.
-        More information `here <https://oss.redis.com/redisearch/master/Commands/#ftsugget>`_.  # noqa
 
         Parameters:
 
@@ -701,7 +735,9 @@ def sugget(
         list:
              A list of Suggestion objects. If with_scores was False, the
              score of all suggestions is 1.
-        """
+
+        For more information: https://oss.redis.com/redisearch/master/Commands/#ftsugget
+        """  # noqa
         args = [SUGGET_COMMAND, key, prefix, "MAX", num]
         if fuzzy:
             args.append(FUZZY)
@@ -733,7 +769,9 @@ def synupdate(self, groupid, skipinitial=False, *terms):
             If set to true, we do not scan and index.
         terms :
             The terms.
-        """
+            
+        For more information: https://oss.redis.com/redisearch/Commands/#ftsynupdate
+        """  # noqa
         cmd = [SYNUPDATE_CMD, self.index_name, groupid]
         if skipinitial:
             cmd.extend(["SKIPINITIALSCAN"])
@@ -746,6 +784,8 @@ def syndump(self):
 
         The command is used to dump the synonyms data structure.
         Returns a list of synonym terms and their synonym group ids.
-        """
+
+        For more information: https://oss.redis.com/redisearch/Commands/#ftsyndump
+        """  # noqa
         raw = self.execute_command(SYNDUMP_CMD, self.index_name)
         return {raw[i]: raw[i + 1] for i in range(0, len(raw), 2)}
diff --git a/redis/commands/timeseries/commands.py b/redis/commands/timeseries/commands.py
index fcb535b50c..460ba766a9 100644
--- a/redis/commands/timeseries/commands.py
+++ b/redis/commands/timeseries/commands.py
@@ -26,8 +26,6 @@ class TimeSeriesCommands:
     def create(self, key, **kwargs):
         """
         Create a new time-series.
-        For more information see
-        `TS.CREATE <https://oss.redis.com/redistimeseries/master/commands/#tscreate>`_.
 
         Args:
 
@@ -60,6 +58,8 @@ def create(self, key, **kwargs):
             - 'min': only override if the value is lower than the existing value.
             - 'max': only override if the value is higher than the existing value.
             When this is not set, the server-wide default will be used.
+            
+        For more information: https://oss.redis.com/redistimeseries/commands/#tscreate
         """  # noqa
         retention_msecs = kwargs.get("retention_msecs", None)
         uncompressed = kwargs.get("uncompressed", False)
@@ -79,9 +79,10 @@ def alter(self, key, **kwargs):
         """
         Update the retention, labels of an existing key.
         For more information see
-        `TS.ALTER <https://oss.redis.com/redistimeseries/master/commands/#tsalter>`_.
 
         The parameters are the same as TS.CREATE.
+        
+        For more information: https://oss.redis.com/redistimeseries/commands/#tsalter
         """  # noqa
         retention_msecs = kwargs.get("retention_msecs", None)
         labels = kwargs.get("labels", {})
@@ -97,7 +98,6 @@ def add(self, key, timestamp, value, **kwargs):
         """
         Append (or create and append) a new sample to the series.
         For more information see
-        `TS.ADD <https://oss.redis.com/redistimeseries/master/commands/#tsadd>`_.
 
         Args:
 
@@ -129,6 +129,8 @@ def add(self, key, timestamp, value, **kwargs):
             - 'min': only override if the value is lower than the existing value.
             - 'max': only override if the value is higher than the existing value.
             When this is not set, the server-wide default will be used.
+            
+        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsadd
         """  # noqa
         retention_msecs = kwargs.get("retention_msecs", None)
         uncompressed = kwargs.get("uncompressed", False)
@@ -150,8 +152,8 @@ def madd(self, ktv_tuples):
         `key` with `timestamp`.
         Expects a list of `tuples` as (`key`,`timestamp`, `value`).
         Return value is an array with timestamps of insertions.
-        For more information see
-        `TS.MADD <https://oss.redis.com/redistimeseries/master/commands/#tsmadd>`_.
+
+        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsmadd
         """  # noqa
         params = []
         for ktv in ktv_tuples:
@@ -166,8 +168,6 @@ def incrby(self, key, value, **kwargs):
         sample's of a series.
         This command can be used as a counter or gauge that automatically gets
         history as a time series.
-        For more information see
-        `TS.INCRBY <https://oss.redis.com/redistimeseries/master/commands/#tsincrbytsdecrby>`_.
 
         Args:
 
@@ -189,6 +189,8 @@ def incrby(self, key, value, **kwargs):
         chunk_size:
             Each time-series uses chunks of memory of fixed size for time series samples.
             You can alter the default TSDB chunk size by passing the chunk_size argument (in Bytes).
+
+        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsincrbytsdecrby
         """  # noqa
         timestamp = kwargs.get("timestamp", None)
         retention_msecs = kwargs.get("retention_msecs", None)
@@ -210,8 +212,6 @@ def decrby(self, key, value, **kwargs):
         latest sample's of a series.
         This command can be used as a counter or gauge that
         automatically gets history as a time series.
-        For more information see
-        `TS.DECRBY <https://oss.redis.com/redistimeseries/master/commands/#tsincrbytsdecrby>`_.
 
         Args:
 
@@ -237,6 +237,8 @@ def decrby(self, key, value, **kwargs):
         chunk_size:
             Each time-series uses chunks of memory of fixed size for time series samples.
             You can alter the default TSDB chunk size by passing the chunk_size argument (in Bytes).
+
+        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsincrbytsdecrby
         """  # noqa
         timestamp = kwargs.get("timestamp", None)
         retention_msecs = kwargs.get("retention_msecs", None)
@@ -260,7 +262,6 @@ def delete(self, key, from_time, to_time):
         and end data points will also be deleted.
         Return the count for deleted items.
         For more information see
-        `TS.DEL <https://oss.redis.com/redistimeseries/master/commands/#tsdel>`_.
 
         Args:
 
@@ -270,6 +271,8 @@ def delete(self, key, from_time, to_time):
             Start timestamp for the range deletion.
         to_time:
             End timestamp for the range deletion.
+
+        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsdel
         """  # noqa
         return self.execute_command(DEL_CMD, key, from_time, to_time)
 
@@ -285,8 +288,8 @@ def createrule(
         Aggregating for `bucket_size_msec` where an `aggregation_type` can be
         [`avg`, `sum`, `min`, `max`, `range`, `count`, `first`, `last`,
         `std.p`, `std.s`, `var.p`, `var.s`]
-        For more information see
-        `TS.CREATERULE <https://oss.redis.com/redistimeseries/master/commands/#tscreaterule>`_.
+
+        For more information: https://oss.redis.com/redistimeseries/master/commands/#tscreaterule
         """  # noqa
         params = [source_key, dest_key]
         self._appendAggregation(params, aggregation_type, bucket_size_msec)
@@ -297,7 +300,8 @@ def deleterule(self, source_key, dest_key):
         """
         Delete a compaction rule.
         For more information see
-        `TS.DELETERULE <https://oss.redis.com/redistimeseries/master/commands/#tsdeleterule>`_.
+
+        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsdeleterule
         """  # noqa
         return self.execute_command(DELETERULE_CMD, source_key, dest_key)
 
@@ -343,8 +347,6 @@ def range(
     ):
         """
         Query a range in forward direction for a specific time-serie.
-        For more information see
-        `TS.RANGE <https://oss.redis.com/redistimeseries/master/commands/#tsrangetsrevrange>`_.
 
         Args:
 
@@ -374,6 +376,8 @@ def range(
             by_min_value).
         align:
             Timestamp for alignment control for aggregation.
+
+        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsrangetsrevrange
         """  # noqa
         params = self.__range_params(
             key,
@@ -404,8 +408,6 @@ def revrange(
     ):
         """
         Query a range in reverse direction for a specific time-series.
-        For more information see
-        `TS.REVRANGE <https://oss.redis.com/redistimeseries/master/commands/#tsrangetsrevrange>`_.
 
         **Note**: This command is only available since RedisTimeSeries >= v1.4
 
@@ -432,6 +434,8 @@ def revrange(
             Filter result by maximum value (must mention also filter_by_min_value).
         align:
             Timestamp for alignment control for aggregation.
+
+        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsrangetsrevrange
         """  # noqa
         params = self.__range_params(
             key,
@@ -500,8 +504,6 @@ def mrange(
     ):
         """
         Query a range across multiple time-series by filters in forward direction.
-        For more information see
-        `TS.MRANGE <https://oss.redis.com/redistimeseries/master/commands/#tsmrangetsmrevrange>`_.
 
         Args:
 
@@ -544,6 +546,8 @@ def mrange(
             pair labels of a series.
         align:
             Timestamp for alignment control for aggregation.
+
+        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsmrangetsmrevrange
         """  # noqa
         params = self.__mrange_params(
             aggregation_type,
@@ -583,8 +587,6 @@ def mrevrange(
     ):
         """
         Query a range across multiple time-series by filters in reverse direction.
-        For more information see
-        `TS.MREVRANGE <https://oss.redis.com/redistimeseries/master/commands/#tsmrangetsmrevrange>`_.
 
         Args:
 
@@ -629,6 +631,8 @@ def mrevrange(
             labels of a series.
         align:
             Timestamp for alignment control for aggregation.
+
+        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsmrangetsmrevrange
         """  # noqa
         params = self.__mrange_params(
             aggregation_type,
@@ -652,14 +656,16 @@ def mrevrange(
     def get(self, key):
         """ # noqa
         Get the last sample of `key`.
-        For more information see `TS.GET <https://oss.redis.com/redistimeseries/master/commands/#tsget>`_.
+
+        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsget
         """  # noqa
         return self.execute_command(GET_CMD, key)
 
     def mget(self, filters, with_labels=False):
         """ # noqa
         Get the last samples matching the specific `filter`.
-        For more information see `TS.MGET <https://oss.redis.com/redistimeseries/master/commands/#tsmget>`_.
+
+        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsmget
         """  # noqa
         params = []
         self._appendWithLabels(params, with_labels)
@@ -670,15 +676,17 @@ def mget(self, filters, with_labels=False):
     def info(self, key):
         """  # noqa
         Get information of `key`.
-        For more information see `TS.INFO <https://oss.redis.com/redistimeseries/master/commands/#tsinfo>`_.
+
+        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsinfo
         """  # noqa
         return self.execute_command(INFO_CMD, key)
 
     def queryindex(self, filters):
         """  # noqa
         Get all the keys matching the `filter` list.
-        For more information see `TS.QUERYINDEX <https://oss.redis.com/redistimeseries/master/commands/#tsqueryindex>`_.
-        """  # noqa
+
+        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsqueryindex
+        """  # noq
         return self.execute_command(QUERYINDEX_CMD, *filters)
 
     @staticmethod

From 368a25f9d163d784a8896f1c087582405e98e006 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 30 Nov 2021 17:30:48 +0200
Subject: [PATCH 0278/1164] Pre-4.1.0rc2 version bump (#1761)

---
 redis/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/__init__.py b/redis/__init__.py
index bc7f3c9d9c..daf741b1c9 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -38,7 +38,7 @@ def int_or_str(value):
         return value
 
 
-__version__ = "4.1.0rc1"
+__version__ = "4.1.0rc2"
 
 
 VERSION = tuple(map(int_or_str, __version__.split('.')))

From b94e230b17d08e6c89d134e933c706256b79bc4a Mon Sep 17 00:00:00 2001
From: Anas <anas.el.amraoui@live.com>
Date: Tue, 30 Nov 2021 18:05:51 +0200
Subject: [PATCH 0279/1164] Added black and isort (#1734)

---
 benchmarks/base.py                     |   17 +-
 benchmarks/basic_operations.py         |   70 +-
 benchmarks/command_packer_benchmark.py |   49 +-
 benchmarks/socket_read_size.py         |   27 +-
 dev_requirements.txt                   |    4 +-
 docs/conf.py                           |   27 +-
 redis/__init__.py                      |   74 +-
 redis/backoff.py                       |    2 +-
 redis/client.py                        | 1032 +++---
 redis/cluster.py                       |  769 ++--
 redis/commands/__init__.py             |   12 +-
 redis/commands/cluster.py              |  406 ++-
 redis/commands/core.py                 | 1713 +++++----
 redis/commands/helpers.py              |   12 +-
 redis/commands/json/__init__.py        |   10 +-
 redis/commands/json/commands.py        |   38 +-
 redis/commands/json/decoders.py        |    7 +-
 redis/commands/parser.py               |   41 +-
 redis/commands/redismodules.py         |   16 +-
 redis/commands/search/__init__.py      |    4 +-
 redis/commands/search/commands.py      |   43 +-
 redis/commands/search/field.py         |    6 +-
 redis/commands/search/query.py         |    9 +-
 redis/commands/search/querystring.py   |    7 +-
 redis/commands/search/result.py        |    2 +-
 redis/commands/search/suggestion.py    |    6 +-
 redis/commands/sentinel.py             |   30 +-
 redis/commands/timeseries/__init__.py  |   11 +-
 redis/commands/timeseries/commands.py  |   35 +-
 redis/commands/timeseries/info.py      |    2 +-
 redis/commands/timeseries/utils.py     |   11 +-
 redis/connection.py                    |  429 ++-
 redis/crc.py                           |    7 +-
 redis/exceptions.py                    |   13 +-
 redis/lock.py                          |   55 +-
 redis/retry.py                         |    5 +-
 redis/sentinel.py                      |  136 +-
 redis/utils.py                         |    7 +-
 setup.py                               |    7 +-
 tasks.py                               |   10 +-
 tests/conftest.py                      |  168 +-
 tests/test_cluster.py                  | 1749 +++++-----
 tests/test_command_parser.py           |  100 +-
 tests/test_commands.py                 | 4464 +++++++++++++-----------
 tests/test_connection.py               |   23 +-
 tests/test_connection_pool.py          |  569 +--
 tests/test_encoding.py                 |   81 +-
 tests/test_helpers.py                  |   59 +-
 tests/test_json.py                     |  106 +-
 tests/test_lock.py                     |  117 +-
 tests/test_monitor.py                  |   47 +-
 tests/test_multiprocessing.py          |   78 +-
 tests/test_pipeline.py                 |  289 +-
 tests/test_pubsub.py                   |  340 +-
 tests/test_retry.py                    |    7 +-
 tests/test_scripting.py                |   58 +-
 tests/test_search.py                   |  410 +--
 tests/test_sentinel.py                 |  120 +-
 tests/test_timeseries.py               |  115 +-
 tox.ini                                |   12 +-
 60 files changed, 7341 insertions(+), 6732 deletions(-)

diff --git a/benchmarks/base.py b/benchmarks/base.py
index 519c9ccab5..f52657f072 100644
--- a/benchmarks/base.py
+++ b/benchmarks/base.py
@@ -1,9 +1,10 @@
 import functools
 import itertools
-import redis
 import sys
 import timeit
 
+import redis
+
 
 class Benchmark:
     ARGUMENTS = ()
@@ -15,9 +16,7 @@ def get_client(self, **kwargs):
         # eventually make this more robust and take optional args from
         # argparse
         if self._client is None or kwargs:
-            defaults = {
-                'db': 9
-            }
+            defaults = {"db": 9}
             defaults.update(kwargs)
             pool = redis.ConnectionPool(**kwargs)
             self._client = redis.Redis(connection_pool=pool)
@@ -30,16 +29,16 @@ def run(self, **kwargs):
         pass
 
     def run_benchmark(self):
-        group_names = [group['name'] for group in self.ARGUMENTS]
-        group_values = [group['values'] for group in self.ARGUMENTS]
+        group_names = [group["name"] for group in self.ARGUMENTS]
+        group_values = [group["values"] for group in self.ARGUMENTS]
         for value_set in itertools.product(*group_values):
             pairs = list(zip(group_names, value_set))
-            arg_string = ', '.join(f'{p[0]}={p[1]}' for p in pairs)
-            sys.stdout.write(f'Benchmark: {arg_string}... ')
+            arg_string = ", ".join(f"{p[0]}={p[1]}" for p in pairs)
+            sys.stdout.write(f"Benchmark: {arg_string}... ")
             sys.stdout.flush()
             kwargs = dict(pairs)
             setup = functools.partial(self.setup, **kwargs)
             run = functools.partial(self.run, **kwargs)
             t = timeit.timeit(stmt=run, setup=setup, number=1000)
-            sys.stdout.write(f'{t:f}\n')
+            sys.stdout.write(f"{t:f}\n")
             sys.stdout.flush()
diff --git a/benchmarks/basic_operations.py b/benchmarks/basic_operations.py
index cb009debbd..1dc4a87cc8 100644
--- a/benchmarks/basic_operations.py
+++ b/benchmarks/basic_operations.py
@@ -1,24 +1,27 @@
-import redis
 import time
-from functools import wraps
 from argparse import ArgumentParser
+from functools import wraps
+
+import redis
 
 
 def parse_args():
     parser = ArgumentParser()
-    parser.add_argument('-n',
-                        type=int,
-                        help='Total number of requests (default 100000)',
-                        default=100000)
-    parser.add_argument('-P',
-                        type=int,
-                        help=('Pipeline <numreq> requests.'
-                              ' Default 1 (no pipeline).'),
-                        default=1)
-    parser.add_argument('-s',
-                        type=int,
-                        help='Data size of SET/GET value in bytes (default 2)',
-                        default=2)
+    parser.add_argument(
+        "-n", type=int, help="Total number of requests (default 100000)", default=100000
+    )
+    parser.add_argument(
+        "-P",
+        type=int,
+        help=("Pipeline <numreq> requests." " Default 1 (no pipeline)."),
+        default=1,
+    )
+    parser.add_argument(
+        "-s",
+        type=int,
+        help="Data size of SET/GET value in bytes (default 2)",
+        default=2,
+    )
 
     args = parser.parse_args()
     return args
@@ -45,15 +48,16 @@ def wrapper(*args, **kwargs):
         start = time.monotonic()
         ret = func(*args, **kwargs)
         duration = time.monotonic() - start
-        if 'num' in kwargs:
-            count = kwargs['num']
+        if "num" in kwargs:
+            count = kwargs["num"]
         else:
             count = args[1]
-        print(f'{func.__name__} - {count} Requests')
-        print(f'Duration  = {duration}')
-        print(f'Rate = {count/duration}')
+        print(f"{func.__name__} - {count} Requests")
+        print(f"Duration  = {duration}")
+        print(f"Rate = {count/duration}")
         print()
         return ret
+
     return wrapper
 
 
@@ -62,9 +66,9 @@ def set_str(conn, num, pipeline_size, data_size):
     if pipeline_size > 1:
         conn = conn.pipeline()
 
-    set_data = 'a'.ljust(data_size, '0')
+    set_data = "a".ljust(data_size, "0")
     for i in range(num):
-        conn.set(f'set_str:{i}', set_data)
+        conn.set(f"set_str:{i}", set_data)
         if pipeline_size > 1 and i % pipeline_size == 0:
             conn.execute()
 
@@ -79,7 +83,7 @@ def set_int(conn, num, pipeline_size, data_size):
 
     set_data = 10 ** (data_size - 1)
     for i in range(num):
-        conn.set(f'set_int:{i}', set_data)
+        conn.set(f"set_int:{i}", set_data)
         if pipeline_size > 1 and i % pipeline_size == 0:
             conn.execute()
 
@@ -93,7 +97,7 @@ def get_str(conn, num, pipeline_size, data_size):
         conn = conn.pipeline()
 
     for i in range(num):
-        conn.get(f'set_str:{i}')
+        conn.get(f"set_str:{i}")
         if pipeline_size > 1 and i % pipeline_size == 0:
             conn.execute()
 
@@ -107,7 +111,7 @@ def get_int(conn, num, pipeline_size, data_size):
         conn = conn.pipeline()
 
     for i in range(num):
-        conn.get(f'set_int:{i}')
+        conn.get(f"set_int:{i}")
         if pipeline_size > 1 and i % pipeline_size == 0:
             conn.execute()
 
@@ -121,7 +125,7 @@ def incr(conn, num, pipeline_size, *args, **kwargs):
         conn = conn.pipeline()
 
     for i in range(num):
-        conn.incr('incr_key')
+        conn.incr("incr_key")
         if pipeline_size > 1 and i % pipeline_size == 0:
             conn.execute()
 
@@ -136,7 +140,7 @@ def lpush(conn, num, pipeline_size, data_size):
 
     set_data = 10 ** (data_size - 1)
     for i in range(num):
-        conn.lpush('lpush_key', set_data)
+        conn.lpush("lpush_key", set_data)
         if pipeline_size > 1 and i % pipeline_size == 0:
             conn.execute()
 
@@ -150,7 +154,7 @@ def lrange_300(conn, num, pipeline_size, data_size):
         conn = conn.pipeline()
 
     for i in range(num):
-        conn.lrange('lpush_key', i, i+300)
+        conn.lrange("lpush_key", i, i + 300)
         if pipeline_size > 1 and i % pipeline_size == 0:
             conn.execute()
 
@@ -163,7 +167,7 @@ def lpop(conn, num, pipeline_size, data_size):
     if pipeline_size > 1:
         conn = conn.pipeline()
     for i in range(num):
-        conn.lpop('lpush_key')
+        conn.lpop("lpush_key")
         if pipeline_size > 1 and i % pipeline_size == 0:
             conn.execute()
     if pipeline_size > 1:
@@ -175,11 +179,9 @@ def hmset(conn, num, pipeline_size, data_size):
     if pipeline_size > 1:
         conn = conn.pipeline()
 
-    set_data = {'str_value': 'string',
-                'int_value': 123456,
-                'float_value': 123456.0}
+    set_data = {"str_value": "string", "int_value": 123456, "float_value": 123456.0}
     for i in range(num):
-        conn.hmset('hmset_key', set_data)
+        conn.hmset("hmset_key", set_data)
         if pipeline_size > 1 and i % pipeline_size == 0:
             conn.execute()
 
@@ -187,5 +189,5 @@ def hmset(conn, num, pipeline_size, data_size):
         conn.execute()
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     run()
diff --git a/benchmarks/command_packer_benchmark.py b/benchmarks/command_packer_benchmark.py
index 3176c06800..e66dbbcbf9 100644
--- a/benchmarks/command_packer_benchmark.py
+++ b/benchmarks/command_packer_benchmark.py
@@ -1,7 +1,7 @@
-from redis.connection import (Connection, SYM_STAR, SYM_DOLLAR, SYM_EMPTY,
-                              SYM_CRLF)
 from base import Benchmark
 
+from redis.connection import SYM_CRLF, SYM_DOLLAR, SYM_EMPTY, SYM_STAR, Connection
+
 
 class StringJoiningConnection(Connection):
     def send_packed_command(self, command, check_health=True):
@@ -13,7 +13,7 @@ def send_packed_command(self, command, check_health=True):
         except OSError as e:
             self.disconnect()
             if len(e.args) == 1:
-                _errno, errmsg = 'UNKNOWN', e.args[0]
+                _errno, errmsg = "UNKNOWN", e.args[0]
             else:
                 _errno, errmsg = e.args
             raise ConnectionError(f"Error {_errno} while writing to socket. {errmsg}.")
@@ -23,12 +23,17 @@ def send_packed_command(self, command, check_health=True):
 
     def pack_command(self, *args):
         "Pack a series of arguments into a value Redis command"
-        args_output = SYM_EMPTY.join([
-            SYM_EMPTY.join(
-                (SYM_DOLLAR, str(len(k)).encode(), SYM_CRLF, k, SYM_CRLF))
-            for k in map(self.encoder.encode, args)])
+        args_output = SYM_EMPTY.join(
+            [
+                SYM_EMPTY.join(
+                    (SYM_DOLLAR, str(len(k)).encode(), SYM_CRLF, k, SYM_CRLF)
+                )
+                for k in map(self.encoder.encode, args)
+            ]
+        )
         output = SYM_EMPTY.join(
-            (SYM_STAR, str(len(args)).encode(), SYM_CRLF, args_output))
+            (SYM_STAR, str(len(args)).encode(), SYM_CRLF, args_output)
+        )
         return output
 
 
@@ -44,7 +49,7 @@ def send_packed_command(self, command, check_health=True):
         except OSError as e:
             self.disconnect()
             if len(e.args) == 1:
-                _errno, errmsg = 'UNKNOWN', e.args[0]
+                _errno, errmsg = "UNKNOWN", e.args[0]
             else:
                 _errno, errmsg = e.args
             raise ConnectionError(f"Error {_errno} while writing to socket. {errmsg}.")
@@ -54,19 +59,20 @@ def send_packed_command(self, command, check_health=True):
 
     def pack_command(self, *args):
         output = []
-        buff = SYM_EMPTY.join(
-            (SYM_STAR, str(len(args)).encode(), SYM_CRLF))
+        buff = SYM_EMPTY.join((SYM_STAR, str(len(args)).encode(), SYM_CRLF))
 
         for k in map(self.encoder.encode, args):
             if len(buff) > 6000 or len(k) > 6000:
                 buff = SYM_EMPTY.join(
-                    (buff, SYM_DOLLAR, str(len(k)).encode(), SYM_CRLF))
+                    (buff, SYM_DOLLAR, str(len(k)).encode(), SYM_CRLF)
+                )
                 output.append(buff)
                 output.append(k)
                 buff = SYM_CRLF
             else:
-                buff = SYM_EMPTY.join((buff, SYM_DOLLAR, str(len(k)).encode(),
-                                       SYM_CRLF, k, SYM_CRLF))
+                buff = SYM_EMPTY.join(
+                    (buff, SYM_DOLLAR, str(len(k)).encode(), SYM_CRLF, k, SYM_CRLF)
+                )
         output.append(buff)
         return output
 
@@ -75,13 +81,12 @@ class CommandPackerBenchmark(Benchmark):
 
     ARGUMENTS = (
         {
-            'name': 'connection_class',
-            'values': [StringJoiningConnection, ListJoiningConnection]
+            "name": "connection_class",
+            "values": [StringJoiningConnection, ListJoiningConnection],
         },
         {
-            'name': 'value_size',
-            'values': [10, 100, 1000, 10000, 100000, 1000000, 10000000,
-                       100000000]
+            "name": "value_size",
+            "values": [10, 100, 1000, 10000, 100000, 1000000, 10000000, 100000000],
         },
     )
 
@@ -90,9 +95,9 @@ def setup(self, connection_class, value_size):
 
     def run(self, connection_class, value_size):
         r = self.get_client()
-        x = 'a' * value_size
-        r.set('benchmark', x)
+        x = "a" * value_size
+        r.set("benchmark", x)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     CommandPackerBenchmark().run_benchmark()
diff --git a/benchmarks/socket_read_size.py b/benchmarks/socket_read_size.py
index 72a1b0a7e3..3427956ced 100644
--- a/benchmarks/socket_read_size.py
+++ b/benchmarks/socket_read_size.py
@@ -1,34 +1,27 @@
-from redis.connection import PythonParser, HiredisParser
 from base import Benchmark
 
+from redis.connection import HiredisParser, PythonParser
+
 
 class SocketReadBenchmark(Benchmark):
 
     ARGUMENTS = (
+        {"name": "parser", "values": [PythonParser, HiredisParser]},
         {
-            'name': 'parser',
-            'values': [PythonParser, HiredisParser]
-        },
-        {
-            'name': 'value_size',
-            'values': [10, 100, 1000, 10000, 100000, 1000000, 10000000,
-                       100000000]
+            "name": "value_size",
+            "values": [10, 100, 1000, 10000, 100000, 1000000, 10000000, 100000000],
         },
-        {
-            'name': 'read_size',
-            'values': [4096, 8192, 16384, 32768, 65536, 131072]
-        }
+        {"name": "read_size", "values": [4096, 8192, 16384, 32768, 65536, 131072]},
     )
 
     def setup(self, value_size, read_size, parser):
-        r = self.get_client(parser_class=parser,
-                            socket_read_size=read_size)
-        r.set('benchmark', 'a' * value_size)
+        r = self.get_client(parser_class=parser, socket_read_size=read_size)
+        r.set("benchmark", "a" * value_size)
 
     def run(self, value_size, read_size, parser):
         r = self.get_client()
-        r.get('benchmark')
+        r.get("benchmark")
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     SocketReadBenchmark().run_benchmark()
diff --git a/dev_requirements.txt b/dev_requirements.txt
index 56ac08efe2..2a4f37762f 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -1,5 +1,7 @@
-flake8>=3.9.2
+black==21.11b1
+flake8==4.0.1
 flynt~=0.69.0
+isort==5.10.1
 pytest==6.2.5
 pytest-timeout==2.0.1
 tox==3.24.4
diff --git a/docs/conf.py b/docs/conf.py
index 8520969d24..7e83e42156 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -55,7 +55,8 @@
 #
 # The short X.Y version.
 import redis
-version = '.'.join(redis.__version__.split(".")[0:2])
+
+version = ".".join(redis.__version__.split(".")[0:2])
 
 # The full version, including alpha/beta/rc tags.
 release = redis.__version__
@@ -108,13 +109,13 @@
 # further.  For a list of options available for each theme, see the
 # documentation.
 html_theme_options = {
-    'display_version': True,
-    'prev_next_buttons_location': 'bottom',
-    'style_external_links': False,
+    "display_version": True,
+    "prev_next_buttons_location": "bottom",
+    "style_external_links": False,
     # Toc options
-    'collapse_navigation': True,
-    'sticky_navigation': True,
-    'navigation_depth': 4,
+    "collapse_navigation": True,
+    "sticky_navigation": True,
+    "navigation_depth": 4,
 }
 
 # Add any paths that contain custom themes here, relative to this directory.
@@ -201,11 +202,7 @@
 # (source start file, target name, title, author, documentclass
 # [howto/manual]).
 latex_documents = [
-    ("index",
-        "redis-py.tex",
-        "redis-py Documentation",
-        "Redis Inc",
-        "manual"),
+    ("index", "redis-py.tex", "redis-py Documentation", "Redis Inc", "manual"),
 ]
 
 # The name of an image file (relative to this directory) to place at the top of
@@ -233,11 +230,7 @@
 
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
-man_pages = [(
-    "index",
-    "redis-py",
-    "redis-py Documentation",
-    ["Andy McCurdy"], 1)]
+man_pages = [("index", "redis-py", "redis-py Documentation", ["Andy McCurdy"], 1)]
 
 # If true, show URL addresses after external links.
 # man_show_urls = False
diff --git a/redis/__init__.py b/redis/__init__.py
index daf741b1c9..051b039d06 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -2,18 +2,11 @@
 from redis.cluster import RedisCluster
 from redis.connection import (
     BlockingConnectionPool,
-    ConnectionPool,
     Connection,
+    ConnectionPool,
     SSLConnection,
-    UnixDomainSocketConnection
-)
-from redis.sentinel import (
-    Sentinel,
-    SentinelConnectionPool,
-    SentinelManagedConnection,
-    SentinelManagedSSLConnection,
+    UnixDomainSocketConnection,
 )
-from redis.utils import from_url
 from redis.exceptions import (
     AuthenticationError,
     AuthenticationWrongNumberOfArgsError,
@@ -27,8 +20,15 @@
     RedisError,
     ResponseError,
     TimeoutError,
-    WatchError
+    WatchError,
+)
+from redis.sentinel import (
+    Sentinel,
+    SentinelConnectionPool,
+    SentinelManagedConnection,
+    SentinelManagedSSLConnection,
 )
+from redis.utils import from_url
 
 
 def int_or_str(value):
@@ -41,33 +41,33 @@ def int_or_str(value):
 __version__ = "4.1.0rc2"
 
 
-VERSION = tuple(map(int_or_str, __version__.split('.')))
+VERSION = tuple(map(int_or_str, __version__.split(".")))
 
 __all__ = [
-    'AuthenticationError',
-    'AuthenticationWrongNumberOfArgsError',
-    'BlockingConnectionPool',
-    'BusyLoadingError',
-    'ChildDeadlockedError',
-    'Connection',
-    'ConnectionError',
-    'ConnectionPool',
-    'DataError',
-    'from_url',
-    'InvalidResponse',
-    'PubSubError',
-    'ReadOnlyError',
-    'Redis',
-    'RedisCluster',
-    'RedisError',
-    'ResponseError',
-    'Sentinel',
-    'SentinelConnectionPool',
-    'SentinelManagedConnection',
-    'SentinelManagedSSLConnection',
-    'SSLConnection',
-    'StrictRedis',
-    'TimeoutError',
-    'UnixDomainSocketConnection',
-    'WatchError',
+    "AuthenticationError",
+    "AuthenticationWrongNumberOfArgsError",
+    "BlockingConnectionPool",
+    "BusyLoadingError",
+    "ChildDeadlockedError",
+    "Connection",
+    "ConnectionError",
+    "ConnectionPool",
+    "DataError",
+    "from_url",
+    "InvalidResponse",
+    "PubSubError",
+    "ReadOnlyError",
+    "Redis",
+    "RedisCluster",
+    "RedisError",
+    "ResponseError",
+    "Sentinel",
+    "SentinelConnectionPool",
+    "SentinelManagedConnection",
+    "SentinelManagedSSLConnection",
+    "SSLConnection",
+    "StrictRedis",
+    "TimeoutError",
+    "UnixDomainSocketConnection",
+    "WatchError",
 ]
diff --git a/redis/backoff.py b/redis/backoff.py
index 9162778cc0..cbb4e73779 100644
--- a/redis/backoff.py
+++ b/redis/backoff.py
@@ -1,5 +1,5 @@
-from abc import ABC, abstractmethod
 import random
+from abc import ABC, abstractmethod
 
 
 class AbstractBackoff(ABC):
diff --git a/redis/client.py b/redis/client.py
index 9f2907ee52..14e588a1d7 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1,15 +1,18 @@
-from itertools import chain
 import copy
 import datetime
 import re
 import threading
 import time
 import warnings
-from redis.commands import (CoreCommands, RedisModuleCommands,
-                            SentinelCommands, list_or_args)
-from redis.connection import (ConnectionPool, UnixDomainSocketConnection,
-                              SSLConnection)
-from redis.lock import Lock
+from itertools import chain
+
+from redis.commands import (
+    CoreCommands,
+    RedisModuleCommands,
+    SentinelCommands,
+    list_or_args,
+)
+from redis.connection import ConnectionPool, SSLConnection, UnixDomainSocketConnection
 from redis.exceptions import (
     ConnectionError,
     ExecAbortError,
@@ -20,13 +23,14 @@
     TimeoutError,
     WatchError,
 )
+from redis.lock import Lock
 from redis.utils import safe_str, str_if_bytes
 
-SYM_EMPTY = b''
-EMPTY_RESPONSE = 'EMPTY_RESPONSE'
+SYM_EMPTY = b""
+EMPTY_RESPONSE = "EMPTY_RESPONSE"
 
 # some responses (ie. dump) are binary, and just meant to never be decoded
-NEVER_DECODE = 'NEVER_DECODE'
+NEVER_DECODE = "NEVER_DECODE"
 
 
 def timestamp_to_datetime(response):
@@ -76,12 +80,12 @@ def parse_debug_object(response):
     # The 'type' of the object is the first item in the response, but isn't
     # prefixed with a name
     response = str_if_bytes(response)
-    response = 'type:' + response
-    response = dict(kv.split(':') for kv in response.split())
+    response = "type:" + response
+    response = dict(kv.split(":") for kv in response.split())
 
     # parse some expected int values from the string response
     # note: this cmd isn't spec'd so these may not appear in all redis versions
-    int_fields = ('refcount', 'serializedlength', 'lru', 'lru_seconds_idle')
+    int_fields = ("refcount", "serializedlength", "lru", "lru_seconds_idle")
     for field in int_fields:
         if field in response:
             response[field] = int(response[field])
@@ -91,7 +95,7 @@ def parse_debug_object(response):
 
 def parse_object(response, infotype):
     "Parse the results of an OBJECT command"
-    if infotype in ('idletime', 'refcount'):
+    if infotype in ("idletime", "refcount"):
         return int_or_none(response)
     return response
 
@@ -102,9 +106,9 @@ def parse_info(response):
     response = str_if_bytes(response)
 
     def get_value(value):
-        if ',' not in value or '=' not in value:
+        if "," not in value or "=" not in value:
             try:
-                if '.' in value:
+                if "." in value:
                     return float(value)
                 else:
                     return int(value)
@@ -112,82 +116,84 @@ def get_value(value):
                 return value
         else:
             sub_dict = {}
-            for item in value.split(','):
-                k, v = item.rsplit('=', 1)
+            for item in value.split(","):
+                k, v = item.rsplit("=", 1)
                 sub_dict[k] = get_value(v)
             return sub_dict
 
     for line in response.splitlines():
-        if line and not line.startswith('#'):
-            if line.find(':') != -1:
+        if line and not line.startswith("#"):
+            if line.find(":") != -1:
                 # Split, the info fields keys and values.
                 # Note that the value may contain ':'. but the 'host:'
                 # pseudo-command is the only case where the key contains ':'
-                key, value = line.split(':', 1)
-                if key == 'cmdstat_host':
-                    key, value = line.rsplit(':', 1)
+                key, value = line.split(":", 1)
+                if key == "cmdstat_host":
+                    key, value = line.rsplit(":", 1)
 
-                if key == 'module':
+                if key == "module":
                     # Hardcode a list for key 'modules' since there could be
                     # multiple lines that started with 'module'
-                    info.setdefault('modules', []).append(get_value(value))
+                    info.setdefault("modules", []).append(get_value(value))
                 else:
                     info[key] = get_value(value)
             else:
                 # if the line isn't splittable, append it to the "__raw__" key
-                info.setdefault('__raw__', []).append(line)
+                info.setdefault("__raw__", []).append(line)
 
     return info
 
 
 def parse_memory_stats(response, **kwargs):
     "Parse the results of MEMORY STATS"
-    stats = pairs_to_dict(response,
-                          decode_keys=True,
-                          decode_string_values=True)
+    stats = pairs_to_dict(response, decode_keys=True, decode_string_values=True)
     for key, value in stats.items():
-        if key.startswith('db.'):
-            stats[key] = pairs_to_dict(value,
-                                       decode_keys=True,
-                                       decode_string_values=True)
+        if key.startswith("db."):
+            stats[key] = pairs_to_dict(
+                value, decode_keys=True, decode_string_values=True
+            )
     return stats
 
 
 SENTINEL_STATE_TYPES = {
-    'can-failover-its-master': int,
-    'config-epoch': int,
-    'down-after-milliseconds': int,
-    'failover-timeout': int,
-    'info-refresh': int,
-    'last-hello-message': int,
-    'last-ok-ping-reply': int,
-    'last-ping-reply': int,
-    'last-ping-sent': int,
-    'master-link-down-time': int,
-    'master-port': int,
-    'num-other-sentinels': int,
-    'num-slaves': int,
-    'o-down-time': int,
-    'pending-commands': int,
-    'parallel-syncs': int,
-    'port': int,
-    'quorum': int,
-    'role-reported-time': int,
-    's-down-time': int,
-    'slave-priority': int,
-    'slave-repl-offset': int,
-    'voted-leader-epoch': int
+    "can-failover-its-master": int,
+    "config-epoch": int,
+    "down-after-milliseconds": int,
+    "failover-timeout": int,
+    "info-refresh": int,
+    "last-hello-message": int,
+    "last-ok-ping-reply": int,
+    "last-ping-reply": int,
+    "last-ping-sent": int,
+    "master-link-down-time": int,
+    "master-port": int,
+    "num-other-sentinels": int,
+    "num-slaves": int,
+    "o-down-time": int,
+    "pending-commands": int,
+    "parallel-syncs": int,
+    "port": int,
+    "quorum": int,
+    "role-reported-time": int,
+    "s-down-time": int,
+    "slave-priority": int,
+    "slave-repl-offset": int,
+    "voted-leader-epoch": int,
 }
 
 
 def parse_sentinel_state(item):
     result = pairs_to_dict_typed(item, SENTINEL_STATE_TYPES)
-    flags = set(result['flags'].split(','))
-    for name, flag in (('is_master', 'master'), ('is_slave', 'slave'),
-                       ('is_sdown', 's_down'), ('is_odown', 'o_down'),
-                       ('is_sentinel', 'sentinel'),
-                       ('is_disconnected', 'disconnected'),
-                       ('is_master_down', 'master_down')):
+    flags = set(result["flags"].split(","))
+    for name, flag in (
+        ("is_master", "master"),
+        ("is_slave", "slave"),
+        ("is_sdown", "s_down"),
+        ("is_odown", "o_down"),
+        ("is_sentinel", "sentinel"),
+        ("is_disconnected", "disconnected"),
+        ("is_master_down", "master_down"),
+    ):
         result[name] = flag in flags
     return result
 
@@ -200,7 +206,7 @@ def parse_sentinel_masters(response):
     result = {}
     for item in response:
         state = parse_sentinel_state(map(str_if_bytes, item))
-        result[state['name']] = state
+        result[state["name"]] = state
     return result
 
 
@@ -251,9 +257,9 @@ def zset_score_pairs(response, **options):
     If ``withscores`` is specified in the options, return the response as
     a list of (value, score) pairs
     """
-    if not response or not options.get('withscores'):
+    if not response or not options.get("withscores"):
         return response
-    score_cast_func = options.get('score_cast_func', float)
+    score_cast_func = options.get("score_cast_func", float)
     it = iter(response)
     return list(zip(it, map(score_cast_func, it)))
 
@@ -263,9 +269,9 @@ def sort_return_tuples(response, **options):
     If ``groups`` is specified, return the response as a list of
     n-element tuples with n being the value found in options['groups']
     """
-    if not response or not options.get('groups'):
+    if not response or not options.get("groups"):
         return response
-    n = options['groups']
+    n = options["groups"]
     return list(zip(*[response[i::n] for i in range(n)]))
 
 
@@ -296,34 +302,30 @@ def parse_list_of_dicts(response):
 
 
 def parse_xclaim(response, **options):
-    if options.get('parse_justid', False):
+    if options.get("parse_justid", False):
         return response
     return parse_stream_list(response)
 
 
 def parse_xautoclaim(response, **options):
-    if options.get('parse_justid', False):
+    if options.get("parse_justid", False):
         return response[1]
     return parse_stream_list(response[1])
 
 
 def parse_xinfo_stream(response, **options):
     data = pairs_to_dict(response, decode_keys=True)
-    if not options.get('full', False):
-        first = data['first-entry']
+    if not options.get("full", False):
+        first = data["first-entry"]
         if first is not None:
-            data['first-entry'] = (first[0], pairs_to_dict(first[1]))
-        last = data['last-entry']
+            data["first-entry"] = (first[0], pairs_to_dict(first[1]))
+        last = data["last-entry"]
         if last is not None:
-            data['last-entry'] = (last[0], pairs_to_dict(last[1]))
+            data["last-entry"] = (last[0], pairs_to_dict(last[1]))
     else:
-        data['entries'] = {
-            _id: pairs_to_dict(entry)
-            for _id, entry in data['entries']
-        }
-        data['groups'] = [
-            pairs_to_dict(group, decode_keys=True)
-            for group in data['groups']
+        data["entries"] = {_id: pairs_to_dict(entry) for _id, entry in data["entries"]}
+        data["groups"] = [
+            pairs_to_dict(group, decode_keys=True) for group in data["groups"]
         ]
     return data
 
@@ -335,19 +337,19 @@ def parse_xread(response):
 
 
 def parse_xpending(response, **options):
-    if options.get('parse_detail', False):
+    if options.get("parse_detail", False):
         return parse_xpending_range(response)
-    consumers = [{'name': n, 'pending': int(p)} for n, p in response[3] or []]
+    consumers = [{"name": n, "pending": int(p)} for n, p in response[3] or []]
     return {
-        'pending': response[0],
-        'min': response[1],
-        'max': response[2],
-        'consumers': consumers
+        "pending": response[0],
+        "min": response[1],
+        "max": response[2],
+        "consumers": consumers,
     }
 
 
 def parse_xpending_range(response):
-    k = ('message_id', 'consumer', 'time_since_delivered', 'times_delivered')
+    k = ("message_id", "consumer", "time_since_delivered", "times_delivered")
     return [dict(zip(k, r)) for r in response]
 
 
@@ -358,13 +360,13 @@ def float_or_none(response):
 
 
 def bool_ok(response):
-    return str_if_bytes(response) == 'OK'
+    return str_if_bytes(response) == "OK"
 
 
 def parse_zadd(response, **options):
     if response is None:
         return None
-    if options.get('as_score'):
+    if options.get("as_score"):
         return float(response)
     return int(response)
 
@@ -373,7 +375,7 @@ def parse_client_list(response, **options):
     clients = []
     for c in str_if_bytes(response).splitlines():
         # Values might contain '='
-        clients.append(dict(pair.split('=', 1) for pair in c.split(' ')))
+        clients.append(dict(pair.split("=", 1) for pair in c.split(" ")))
     return clients
 
 
@@ -393,7 +395,7 @@ def parse_hscan(response, **options):
 
 
 def parse_zscan(response, **options):
-    score_cast_func = options.get('score_cast_func', float)
+    score_cast_func = options.get("score_cast_func", float)
     cursor, r = response
     it = iter(r)
     return int(cursor), list(zip(it, map(score_cast_func, it)))
@@ -405,23 +407,24 @@ def parse_zmscore(response, **options):
 
 
 def parse_slowlog_get(response, **options):
-    space = ' ' if options.get('decode_responses', False) else b' '
+    space = " " if options.get("decode_responses", False) else b" "
 
     def parse_item(item):
         result = {
-            'id': item[0],
-            'start_time': int(item[1]),
-            'duration': int(item[2]),
+            "id": item[0],
+            "start_time": int(item[1]),
+            "duration": int(item[2]),
         }
         # Redis Enterprise injects another entry at index [3], which has
         # the complexity info (i.e. the value N in case the command has
         # an O(N) complexity) instead of the command.
         if isinstance(item[3], list):
-            result['command'] = space.join(item[3])
+            result["command"] = space.join(item[3])
         else:
-            result['complexity'] = item[3]
-            result['command'] = space.join(item[4])
+            result["complexity"] = item[3]
+            result["command"] = space.join(item[4])
         return result
+
     return [parse_item(item) for item in response]
 
 
@@ -437,42 +440,42 @@ def parse_stralgo(response, **options):
     When WITHMATCHLEN is given, each array representing a match will
     also have the length of the match at the beginning of the array.
     """
-    if options.get('len', False):
+    if options.get("len", False):
         return int(response)
-    if options.get('idx', False):
-        if options.get('withmatchlen', False):
-            matches = [[(int(match[-1]))] + list(map(tuple, match[:-1]))
-                       for match in response[1]]
+    if options.get("idx", False):
+        if options.get("withmatchlen", False):
+            matches = [
+                [(int(match[-1]))] + list(map(tuple, match[:-1]))
+                for match in response[1]
+            ]
         else:
-            matches = [list(map(tuple, match))
-                       for match in response[1]]
+            matches = [list(map(tuple, match)) for match in response[1]]
         return {
             str_if_bytes(response[0]): matches,
-            str_if_bytes(response[2]): int(response[3])
+            str_if_bytes(response[2]): int(response[3]),
         }
     return str_if_bytes(response)
 
 
 def parse_cluster_info(response, **options):
     response = str_if_bytes(response)
-    return dict(line.split(':') for line in response.splitlines() if line)
+    return dict(line.split(":") for line in response.splitlines() if line)
 
 
 def _parse_node_line(line):
-    line_items = line.split(' ')
-    node_id, addr, flags, master_id, ping, pong, epoch, \
-        connected = line.split(' ')[:8]
-    addr = addr.split('@')[0]
-    slots = [sl.split('-') for sl in line_items[8:]]
+    line_items = line.split(" ")
+    node_id, addr, flags, master_id, ping, pong, epoch, connected = line.split(" ")[:8]
+    addr = addr.split("@")[0]
+    slots = [sl.split("-") for sl in line_items[8:]]
     node_dict = {
-        'node_id': node_id,
-        'flags': flags,
-        'master_id': master_id,
-        'last_ping_sent': ping,
-        'last_pong_rcvd': pong,
-        'epoch': epoch,
-        'slots': slots,
-        'connected': True if connected == 'connected' else False
+        "node_id": node_id,
+        "flags": flags,
+        "master_id": master_id,
+        "last_ping_sent": ping,
+        "last_pong_rcvd": pong,
+        "epoch": epoch,
+        "slots": slots,
+        "connected": True if connected == "connected" else False,
     }
     return addr, node_dict
 
@@ -492,7 +495,7 @@ def parse_geosearch_generic(response, **options):
     Parse the response of 'GEOSEARCH', GEORADIUS' and 'GEORADIUSBYMEMBER'
     commands according to 'withdist', 'withhash' and 'withcoord' labels.
     """
-    if options['store'] or options['store_dist']:
+    if options["store"] or options["store_dist"]:
         # `store` and `store_dist` cant be combined
         # with other command arguments.
         # relevant to 'GEORADIUS' and 'GEORADIUSBYMEMBER'
@@ -503,24 +506,21 @@ def parse_geosearch_generic(response, **options):
     else:
         response_list = response
 
-    if not options['withdist'] and not options['withcoord'] \
-            and not options['withhash']:
+    if not options["withdist"] and not options["withcoord"] and not options["withhash"]:
         # just a bunch of places
         return response_list
 
     cast = {
-        'withdist': float,
-        'withcoord': lambda ll: (float(ll[0]), float(ll[1])),
-        'withhash': int
+        "withdist": float,
+        "withcoord": lambda ll: (float(ll[0]), float(ll[1])),
+        "withhash": int,
     }
 
     # zip all output results with each casting function to get
     # the properly native Python value.
     f = [lambda x: x]
-    f += [cast[o] for o in ['withdist', 'withhash', 'withcoord'] if options[o]]
-    return [
-        list(map(lambda fv: fv[0](fv[1]), zip(f, r))) for r in response_list
-    ]
+    f += [cast[o] for o in ["withdist", "withhash", "withcoord"] if options[o]]
+    return [list(map(lambda fv: fv[0](fv[1]), zip(f, r))) for r in response_list]
 
 
 def parse_command(response, **options):
@@ -528,12 +528,12 @@ def parse_command(response, **options):
     for command in response:
         cmd_dict = {}
         cmd_name = str_if_bytes(command[0])
-        cmd_dict['name'] = cmd_name
-        cmd_dict['arity'] = int(command[1])
-        cmd_dict['flags'] = [str_if_bytes(flag) for flag in command[2]]
-        cmd_dict['first_key_pos'] = command[3]
-        cmd_dict['last_key_pos'] = command[4]
-        cmd_dict['step_count'] = command[5]
+        cmd_dict["name"] = cmd_name
+        cmd_dict["arity"] = int(command[1])
+        cmd_dict["flags"] = [str_if_bytes(flag) for flag in command[2]]
+        cmd_dict["first_key_pos"] = command[3]
+        cmd_dict["last_key_pos"] = command[4]
+        cmd_dict["step_count"] = command[5]
         commands[cmd_name] = cmd_dict
     return commands
 
@@ -545,7 +545,7 @@ def parse_pubsub_numsub(response, **options):
 def parse_client_kill(response, **options):
     if isinstance(response, int):
         return response
-    return str_if_bytes(response) == 'OK'
+    return str_if_bytes(response) == "OK"
 
 
 def parse_acl_getuser(response, **options):
@@ -554,21 +554,21 @@ def parse_acl_getuser(response, **options):
     data = pairs_to_dict(response, decode_keys=True)
 
     # convert everything but user-defined data in 'keys' to native strings
-    data['flags'] = list(map(str_if_bytes, data['flags']))
-    data['passwords'] = list(map(str_if_bytes, data['passwords']))
-    data['commands'] = str_if_bytes(data['commands'])
+    data["flags"] = list(map(str_if_bytes, data["flags"]))
+    data["passwords"] = list(map(str_if_bytes, data["passwords"]))
+    data["commands"] = str_if_bytes(data["commands"])
 
     # split 'commands' into separate 'categories' and 'commands' lists
     commands, categories = [], []
-    for command in data['commands'].split(' '):
-        if '@' in command:
+    for command in data["commands"].split(" "):
+        if "@" in command:
             categories.append(command)
         else:
             commands.append(command)
 
-    data['commands'] = commands
-    data['categories'] = categories
-    data['enabled'] = 'on' in data['flags']
+    data["commands"] = commands
+    data["categories"] = categories
+    data["enabled"] = "on" in data["flags"]
     return data
 
 
@@ -579,7 +579,7 @@ def parse_acl_log(response, **options):
         data = []
         for log in response:
             log_data = pairs_to_dict(log, True, True)
-            client_info = log_data.get('client-info', '')
+            client_info = log_data.get("client-info", "")
             log_data["client-info"] = parse_client_info(client_info)
 
             # float() is lossy comparing to the "double" in C
@@ -602,9 +602,22 @@ def parse_client_info(value):
         client_info[key] = value
 
     # Those fields are defined as int in networking.c
-    for int_key in {"id", "age", "idle", "db", "sub", "psub",
-                    "multi", "qbuf", "qbuf-free", "obl",
-                    "argv-mem", "oll", "omem", "tot-mem"}:
+    for int_key in {
+        "id",
+        "age",
+        "idle",
+        "db",
+        "sub",
+        "psub",
+        "multi",
+        "qbuf",
+        "qbuf-free",
+        "obl",
+        "argv-mem",
+        "oll",
+        "omem",
+        "tot-mem",
+    }:
         client_info[int_key] = int(client_info[int_key])
     return client_info
 
@@ -622,11 +635,11 @@ def parse_set_result(response, **options):
     - BOOL
     - String when GET argument is used
     """
-    if options.get('get'):
+    if options.get("get"):
         # Redis will return a getCommand result.
         # See `setGenericCommand` in t_string.c
         return response
-    return response and str_if_bytes(response) == 'OK'
+    return response and str_if_bytes(response) == "OK"
 
 
 class Redis(RedisModuleCommands, CoreCommands, SentinelCommands):
@@ -641,158 +654,156 @@ class Redis(RedisModuleCommands, CoreCommands, SentinelCommands):
     configuration, an instance will either use a ConnectionPool, or
     Connection object to talk to redis.
     """
+
     RESPONSE_CALLBACKS = {
         **string_keys_to_dict(
-            'AUTH COPY EXPIRE EXPIREAT PEXPIRE PEXPIREAT '
-            'HEXISTS HMSET LMOVE BLMOVE MOVE '
-            'MSETNX PERSIST PSETEX RENAMENX SISMEMBER SMOVE SETEX SETNX',
-            bool
+            "AUTH COPY EXPIRE EXPIREAT PEXPIRE PEXPIREAT "
+            "HEXISTS HMSET LMOVE BLMOVE MOVE "
+            "MSETNX PERSIST PSETEX RENAMENX SISMEMBER SMOVE SETEX SETNX",
+            bool,
         ),
         **string_keys_to_dict(
-            'BITCOUNT BITPOS DECRBY DEL EXISTS GEOADD GETBIT HDEL HLEN '
-            'HSTRLEN INCRBY LINSERT LLEN LPUSHX PFADD PFCOUNT RPUSHX SADD '
-            'SCARD SDIFFSTORE SETBIT SETRANGE SINTERSTORE SREM STRLEN '
-            'SUNIONSTORE UNLINK XACK XDEL XLEN XTRIM ZCARD ZLEXCOUNT ZREM '
-            'ZREMRANGEBYLEX ZREMRANGEBYRANK ZREMRANGEBYSCORE',
-            int
+            "BITCOUNT BITPOS DECRBY DEL EXISTS GEOADD GETBIT HDEL HLEN "
+            "HSTRLEN INCRBY LINSERT LLEN LPUSHX PFADD PFCOUNT RPUSHX SADD "
+            "SCARD SDIFFSTORE SETBIT SETRANGE SINTERSTORE SREM STRLEN "
+            "SUNIONSTORE UNLINK XACK XDEL XLEN XTRIM ZCARD ZLEXCOUNT ZREM "
+            "ZREMRANGEBYLEX ZREMRANGEBYRANK ZREMRANGEBYSCORE",
+            int,
         ),
+        **string_keys_to_dict("INCRBYFLOAT HINCRBYFLOAT", float),
         **string_keys_to_dict(
-            'INCRBYFLOAT HINCRBYFLOAT',
-            float
+            # these return OK, or int if redis-server is >=1.3.4
+            "LPUSH RPUSH",
+            lambda r: isinstance(r, int) and r or str_if_bytes(r) == "OK",
         ),
+        **string_keys_to_dict("SORT", sort_return_tuples),
+        **string_keys_to_dict("ZSCORE ZINCRBY GEODIST", float_or_none),
         **string_keys_to_dict(
-            # these return OK, or int if redis-server is >=1.3.4
-            'LPUSH RPUSH',
-            lambda r: isinstance(r, int) and r or str_if_bytes(r) == 'OK'
+            "FLUSHALL FLUSHDB LSET LTRIM MSET PFMERGE READONLY READWRITE "
+            "RENAME SAVE SELECT SHUTDOWN SLAVEOF SWAPDB WATCH UNWATCH ",
+            bool_ok,
         ),
-        **string_keys_to_dict('SORT', sort_return_tuples),
-        **string_keys_to_dict('ZSCORE ZINCRBY GEODIST', float_or_none),
+        **string_keys_to_dict("BLPOP BRPOP", lambda r: r and tuple(r) or None),
         **string_keys_to_dict(
-            'FLUSHALL FLUSHDB LSET LTRIM MSET PFMERGE READONLY READWRITE '
-            'RENAME SAVE SELECT SHUTDOWN SLAVEOF SWAPDB WATCH UNWATCH ',
-            bool_ok
+            "SDIFF SINTER SMEMBERS SUNION", lambda r: r and set(r) or set()
         ),
-        **string_keys_to_dict('BLPOP BRPOP', lambda r: r and tuple(r) or None),
         **string_keys_to_dict(
-            'SDIFF SINTER SMEMBERS SUNION',
-            lambda r: r and set(r) or set()
+            "ZPOPMAX ZPOPMIN ZINTER ZDIFF ZUNION ZRANGE ZRANGEBYSCORE "
+            "ZREVRANGE ZREVRANGEBYSCORE",
+            zset_score_pairs,
         ),
         **string_keys_to_dict(
-            'ZPOPMAX ZPOPMIN ZINTER ZDIFF ZUNION ZRANGE ZRANGEBYSCORE '
-            'ZREVRANGE ZREVRANGEBYSCORE', zset_score_pairs
+            "BZPOPMIN BZPOPMAX", lambda r: r and (r[0], r[1], float(r[2])) or None
+        ),
+        **string_keys_to_dict("ZRANK ZREVRANK", int_or_none),
+        **string_keys_to_dict("XREVRANGE XRANGE", parse_stream_list),
+        **string_keys_to_dict("XREAD XREADGROUP", parse_xread),
+        **string_keys_to_dict("BGREWRITEAOF BGSAVE", lambda r: True),
+        "ACL CAT": lambda r: list(map(str_if_bytes, r)),
+        "ACL DELUSER": int,
+        "ACL GENPASS": str_if_bytes,
+        "ACL GETUSER": parse_acl_getuser,
+        "ACL HELP": lambda r: list(map(str_if_bytes, r)),
+        "ACL LIST": lambda r: list(map(str_if_bytes, r)),
+        "ACL LOAD": bool_ok,
+        "ACL LOG": parse_acl_log,
+        "ACL SAVE": bool_ok,
+        "ACL SETUSER": bool_ok,
+        "ACL USERS": lambda r: list(map(str_if_bytes, r)),
+        "ACL WHOAMI": str_if_bytes,
+        "CLIENT GETNAME": str_if_bytes,
+        "CLIENT ID": int,
+        "CLIENT KILL": parse_client_kill,
+        "CLIENT LIST": parse_client_list,
+        "CLIENT INFO": parse_client_info,
+        "CLIENT SETNAME": bool_ok,
+        "CLIENT UNBLOCK": lambda r: r and int(r) == 1 or False,
+        "CLIENT PAUSE": bool_ok,
+        "CLIENT GETREDIR": int,
+        "CLIENT TRACKINGINFO": lambda r: list(map(str_if_bytes, r)),
+        "CLUSTER ADDSLOTS": bool_ok,
+        "CLUSTER COUNT-FAILURE-REPORTS": lambda x: int(x),
+        "CLUSTER COUNTKEYSINSLOT": lambda x: int(x),
+        "CLUSTER DELSLOTS": bool_ok,
+        "CLUSTER FAILOVER": bool_ok,
+        "CLUSTER FORGET": bool_ok,
+        "CLUSTER INFO": parse_cluster_info,
+        "CLUSTER KEYSLOT": lambda x: int(x),
+        "CLUSTER MEET": bool_ok,
+        "CLUSTER NODES": parse_cluster_nodes,
+        "CLUSTER REPLICATE": bool_ok,
+        "CLUSTER RESET": bool_ok,
+        "CLUSTER SAVECONFIG": bool_ok,
+        "CLUSTER SET-CONFIG-EPOCH": bool_ok,
+        "CLUSTER SETSLOT": bool_ok,
+        "CLUSTER SLAVES": parse_cluster_nodes,
+        "CLUSTER REPLICAS": parse_cluster_nodes,
+        "COMMAND": parse_command,
+        "COMMAND COUNT": int,
+        "COMMAND GETKEYS": lambda r: list(map(str_if_bytes, r)),
+        "CONFIG GET": parse_config_get,
+        "CONFIG RESETSTAT": bool_ok,
+        "CONFIG SET": bool_ok,
+        "DEBUG OBJECT": parse_debug_object,
+        "GEOHASH": lambda r: list(map(str_if_bytes, r)),
+        "GEOPOS": lambda r: list(
+            map(lambda ll: (float(ll[0]), float(ll[1])) if ll is not None else None, r)
         ),
-        **string_keys_to_dict('BZPOPMIN BZPOPMAX', \
-                              lambda r:
-                              r and (r[0], r[1], float(r[2])) or None),
-        **string_keys_to_dict('ZRANK ZREVRANK', int_or_none),
-        **string_keys_to_dict('XREVRANGE XRANGE', parse_stream_list),
-        **string_keys_to_dict('XREAD XREADGROUP', parse_xread),
-        **string_keys_to_dict('BGREWRITEAOF BGSAVE', lambda r: True),
-        'ACL CAT': lambda r: list(map(str_if_bytes, r)),
-        'ACL DELUSER': int,
-        'ACL GENPASS': str_if_bytes,
-        'ACL GETUSER': parse_acl_getuser,
-        'ACL HELP': lambda r: list(map(str_if_bytes, r)),
-        'ACL LIST': lambda r: list(map(str_if_bytes, r)),
-        'ACL LOAD': bool_ok,
-        'ACL LOG': parse_acl_log,
-        'ACL SAVE': bool_ok,
-        'ACL SETUSER': bool_ok,
-        'ACL USERS': lambda r: list(map(str_if_bytes, r)),
-        'ACL WHOAMI': str_if_bytes,
-        'CLIENT GETNAME': str_if_bytes,
-        'CLIENT ID': int,
-        'CLIENT KILL': parse_client_kill,
-        'CLIENT LIST': parse_client_list,
-        'CLIENT INFO': parse_client_info,
-        'CLIENT SETNAME': bool_ok,
-        'CLIENT UNBLOCK': lambda r: r and int(r) == 1 or False,
-        'CLIENT PAUSE': bool_ok,
-        'CLIENT GETREDIR': int,
-        'CLIENT TRACKINGINFO': lambda r: list(map(str_if_bytes, r)),
-        'CLUSTER ADDSLOTS': bool_ok,
-        'CLUSTER COUNT-FAILURE-REPORTS': lambda x: int(x),
-        'CLUSTER COUNTKEYSINSLOT': lambda x: int(x),
-        'CLUSTER DELSLOTS': bool_ok,
-        'CLUSTER FAILOVER': bool_ok,
-        'CLUSTER FORGET': bool_ok,
-        'CLUSTER INFO': parse_cluster_info,
-        'CLUSTER KEYSLOT': lambda x: int(x),
-        'CLUSTER MEET': bool_ok,
-        'CLUSTER NODES': parse_cluster_nodes,
-        'CLUSTER REPLICATE': bool_ok,
-        'CLUSTER RESET': bool_ok,
-        'CLUSTER SAVECONFIG': bool_ok,
-        'CLUSTER SET-CONFIG-EPOCH': bool_ok,
-        'CLUSTER SETSLOT': bool_ok,
-        'CLUSTER SLAVES': parse_cluster_nodes,
-        'CLUSTER REPLICAS': parse_cluster_nodes,
-        'COMMAND': parse_command,
-        'COMMAND COUNT': int,
-        'COMMAND GETKEYS': lambda r: list(map(str_if_bytes, r)),
-        'CONFIG GET': parse_config_get,
-        'CONFIG RESETSTAT': bool_ok,
-        'CONFIG SET': bool_ok,
-        'DEBUG OBJECT': parse_debug_object,
-        'GEOHASH': lambda r: list(map(str_if_bytes, r)),
-        'GEOPOS': lambda r: list(map(lambda ll: (float(ll[0]),
-                                     float(ll[1]))
-                                     if ll is not None else None, r)),
-        'GEOSEARCH': parse_geosearch_generic,
-        'GEORADIUS': parse_geosearch_generic,
-        'GEORADIUSBYMEMBER': parse_geosearch_generic,
-        'HGETALL': lambda r: r and pairs_to_dict(r) or {},
-        'HSCAN': parse_hscan,
-        'INFO': parse_info,
-        'LASTSAVE': timestamp_to_datetime,
-        'MEMORY PURGE': bool_ok,
-        'MEMORY STATS': parse_memory_stats,
-        'MEMORY USAGE': int_or_none,
-        'MODULE LOAD': parse_module_result,
-        'MODULE UNLOAD': parse_module_result,
-        'MODULE LIST': lambda r: [pairs_to_dict(m) for m in r],
-        'OBJECT': parse_object,
-        'PING': lambda r: str_if_bytes(r) == 'PONG',
-        'QUIT': bool_ok,
-        'STRALGO': parse_stralgo,
-        'PUBSUB NUMSUB': parse_pubsub_numsub,
-        'RANDOMKEY': lambda r: r and r or None,
-        'SCAN': parse_scan,
-        'SCRIPT EXISTS': lambda r: list(map(bool, r)),
-        'SCRIPT FLUSH': bool_ok,
-        'SCRIPT KILL': bool_ok,
-        'SCRIPT LOAD': str_if_bytes,
-        'SENTINEL CKQUORUM': bool_ok,
-        'SENTINEL FAILOVER': bool_ok,
-        'SENTINEL FLUSHCONFIG': bool_ok,
-        'SENTINEL GET-MASTER-ADDR-BY-NAME': parse_sentinel_get_master,
-        'SENTINEL MASTER': parse_sentinel_master,
-        'SENTINEL MASTERS': parse_sentinel_masters,
-        'SENTINEL MONITOR': bool_ok,
-        'SENTINEL RESET': bool_ok,
-        'SENTINEL REMOVE': bool_ok,
-        'SENTINEL SENTINELS': parse_sentinel_slaves_and_sentinels,
-        'SENTINEL SET': bool_ok,
-        'SENTINEL SLAVES': parse_sentinel_slaves_and_sentinels,
-        'SET': parse_set_result,
-        'SLOWLOG GET': parse_slowlog_get,
-        'SLOWLOG LEN': int,
-        'SLOWLOG RESET': bool_ok,
-        'SSCAN': parse_scan,
-        'TIME': lambda x: (int(x[0]), int(x[1])),
-        'XCLAIM': parse_xclaim,
-        'XAUTOCLAIM': parse_xautoclaim,
-        'XGROUP CREATE': bool_ok,
-        'XGROUP DELCONSUMER': int,
-        'XGROUP DESTROY': bool,
-        'XGROUP SETID': bool_ok,
-        'XINFO CONSUMERS': parse_list_of_dicts,
-        'XINFO GROUPS': parse_list_of_dicts,
-        'XINFO STREAM': parse_xinfo_stream,
-        'XPENDING': parse_xpending,
-        'ZADD': parse_zadd,
-        'ZSCAN': parse_zscan,
-        'ZMSCORE': parse_zmscore,
+        "GEOSEARCH": parse_geosearch_generic,
+        "GEORADIUS": parse_geosearch_generic,
+        "GEORADIUSBYMEMBER": parse_geosearch_generic,
+        "HGETALL": lambda r: r and pairs_to_dict(r) or {},
+        "HSCAN": parse_hscan,
+        "INFO": parse_info,
+        "LASTSAVE": timestamp_to_datetime,
+        "MEMORY PURGE": bool_ok,
+        "MEMORY STATS": parse_memory_stats,
+        "MEMORY USAGE": int_or_none,
+        "MODULE LOAD": parse_module_result,
+        "MODULE UNLOAD": parse_module_result,
+        "MODULE LIST": lambda r: [pairs_to_dict(m) for m in r],
+        "OBJECT": parse_object,
+        "PING": lambda r: str_if_bytes(r) == "PONG",
+        "QUIT": bool_ok,
+        "STRALGO": parse_stralgo,
+        "PUBSUB NUMSUB": parse_pubsub_numsub,
+        "RANDOMKEY": lambda r: r and r or None,
+        "SCAN": parse_scan,
+        "SCRIPT EXISTS": lambda r: list(map(bool, r)),
+        "SCRIPT FLUSH": bool_ok,
+        "SCRIPT KILL": bool_ok,
+        "SCRIPT LOAD": str_if_bytes,
+        "SENTINEL CKQUORUM": bool_ok,
+        "SENTINEL FAILOVER": bool_ok,
+        "SENTINEL FLUSHCONFIG": bool_ok,
+        "SENTINEL GET-MASTER-ADDR-BY-NAME": parse_sentinel_get_master,
+        "SENTINEL MASTER": parse_sentinel_master,
+        "SENTINEL MASTERS": parse_sentinel_masters,
+        "SENTINEL MONITOR": bool_ok,
+        "SENTINEL RESET": bool_ok,
+        "SENTINEL REMOVE": bool_ok,
+        "SENTINEL SENTINELS": parse_sentinel_slaves_and_sentinels,
+        "SENTINEL SET": bool_ok,
+        "SENTINEL SLAVES": parse_sentinel_slaves_and_sentinels,
+        "SET": parse_set_result,
+        "SLOWLOG GET": parse_slowlog_get,
+        "SLOWLOG LEN": int,
+        "SLOWLOG RESET": bool_ok,
+        "SSCAN": parse_scan,
+        "TIME": lambda x: (int(x[0]), int(x[1])),
+        "XCLAIM": parse_xclaim,
+        "XAUTOCLAIM": parse_xautoclaim,
+        "XGROUP CREATE": bool_ok,
+        "XGROUP DELCONSUMER": int,
+        "XGROUP DESTROY": bool,
+        "XGROUP SETID": bool_ok,
+        "XINFO CONSUMERS": parse_list_of_dicts,
+        "XINFO GROUPS": parse_list_of_dicts,
+        "XINFO STREAM": parse_xinfo_stream,
+        "XPENDING": parse_xpending,
+        "ZADD": parse_zadd,
+        "ZSCAN": parse_zscan,
+        "ZMSCORE": parse_zmscore,
     }
 
     @classmethod
@@ -839,20 +850,38 @@ class initializer. In the case of conflicting arguments, querystring
         connection_pool = ConnectionPool.from_url(url, **kwargs)
         return cls(connection_pool=connection_pool)
 
-    def __init__(self, host='localhost', port=6379,
-                 db=0, password=None, socket_timeout=None,
-                 socket_connect_timeout=None,
-                 socket_keepalive=None, socket_keepalive_options=None,
-                 connection_pool=None, unix_socket_path=None,
-                 encoding='utf-8', encoding_errors='strict',
-                 charset=None, errors=None,
-                 decode_responses=False, retry_on_timeout=False,
-                 ssl=False, ssl_keyfile=None, ssl_certfile=None,
-                 ssl_cert_reqs='required', ssl_ca_certs=None,
-                 ssl_check_hostname=False,
-                 max_connections=None, single_connection_client=False,
-                 health_check_interval=0, client_name=None, username=None,
-                 retry=None, redis_connect_func=None):
+    def __init__(
+        self,
+        host="localhost",
+        port=6379,
+        db=0,
+        password=None,
+        socket_timeout=None,
+        socket_connect_timeout=None,
+        socket_keepalive=None,
+        socket_keepalive_options=None,
+        connection_pool=None,
+        unix_socket_path=None,
+        encoding="utf-8",
+        encoding_errors="strict",
+        charset=None,
+        errors=None,
+        decode_responses=False,
+        retry_on_timeout=False,
+        ssl=False,
+        ssl_keyfile=None,
+        ssl_certfile=None,
+        ssl_cert_reqs="required",
+        ssl_ca_certs=None,
+        ssl_check_hostname=False,
+        max_connections=None,
+        single_connection_client=False,
+        health_check_interval=0,
+        client_name=None,
+        username=None,
+        retry=None,
+        redis_connect_func=None,
+    ):
         """
         Initialize a new Redis client.
         To specify a retry policy, first set `retry_on_timeout` to `True`
@@ -860,62 +889,73 @@ def __init__(self, host='localhost', port=6379,
         """
         if not connection_pool:
             if charset is not None:
-                warnings.warn(DeprecationWarning(
-                    '"charset" is deprecated. Use "encoding" instead'))
+                warnings.warn(
+                    DeprecationWarning(
+                        '"charset" is deprecated. Use "encoding" instead'
+                    )
+                )
                 encoding = charset
             if errors is not None:
-                warnings.warn(DeprecationWarning(
-                    '"errors" is deprecated. Use "encoding_errors" instead'))
+                warnings.warn(
+                    DeprecationWarning(
+                        '"errors" is deprecated. Use "encoding_errors" instead'
+                    )
+                )
                 encoding_errors = errors
 
             kwargs = {
-                'db': db,
-                'username': username,
-                'password': password,
-                'socket_timeout': socket_timeout,
-                'encoding': encoding,
-                'encoding_errors': encoding_errors,
-                'decode_responses': decode_responses,
-                'retry_on_timeout': retry_on_timeout,
-                'retry': copy.deepcopy(retry),
-                'max_connections': max_connections,
-                'health_check_interval': health_check_interval,
-                'client_name': client_name,
-                'redis_connect_func': redis_connect_func
+                "db": db,
+                "username": username,
+                "password": password,
+                "socket_timeout": socket_timeout,
+                "encoding": encoding,
+                "encoding_errors": encoding_errors,
+                "decode_responses": decode_responses,
+                "retry_on_timeout": retry_on_timeout,
+                "retry": copy.deepcopy(retry),
+                "max_connections": max_connections,
+                "health_check_interval": health_check_interval,
+                "client_name": client_name,
+                "redis_connect_func": redis_connect_func,
             }
             # based on input, setup appropriate connection args
             if unix_socket_path is not None:
-                kwargs.update({
-                    'path': unix_socket_path,
-                    'connection_class': UnixDomainSocketConnection
-                })
+                kwargs.update(
+                    {
+                        "path": unix_socket_path,
+                        "connection_class": UnixDomainSocketConnection,
+                    }
+                )
             else:
                 # TCP specific options
-                kwargs.update({
-                    'host': host,
-                    'port': port,
-                    'socket_connect_timeout': socket_connect_timeout,
-                    'socket_keepalive': socket_keepalive,
-                    'socket_keepalive_options': socket_keepalive_options,
-                })
+                kwargs.update(
+                    {
+                        "host": host,
+                        "port": port,
+                        "socket_connect_timeout": socket_connect_timeout,
+                        "socket_keepalive": socket_keepalive,
+                        "socket_keepalive_options": socket_keepalive_options,
+                    }
+                )
 
                 if ssl:
-                    kwargs.update({
-                        'connection_class': SSLConnection,
-                        'ssl_keyfile': ssl_keyfile,
-                        'ssl_certfile': ssl_certfile,
-                        'ssl_cert_reqs': ssl_cert_reqs,
-                        'ssl_ca_certs': ssl_ca_certs,
-                        'ssl_check_hostname': ssl_check_hostname,
-                    })
+                    kwargs.update(
+                        {
+                            "connection_class": SSLConnection,
+                            "ssl_keyfile": ssl_keyfile,
+                            "ssl_certfile": ssl_certfile,
+                            "ssl_cert_reqs": ssl_cert_reqs,
+                            "ssl_ca_certs": ssl_ca_certs,
+                            "ssl_check_hostname": ssl_check_hostname,
+                        }
+                    )
             connection_pool = ConnectionPool(**kwargs)
         self.connection_pool = connection_pool
         self.connection = None
         if single_connection_client:
-            self.connection = self.connection_pool.get_connection('_')
+            self.connection = self.connection_pool.get_connection("_")
 
-        self.response_callbacks = CaseInsensitiveDict(
-            self.__class__.RESPONSE_CALLBACKS)
+        self.response_callbacks = CaseInsensitiveDict(self.__class__.RESPONSE_CALLBACKS)
 
     def __repr__(self):
         return f"{type(self).__name__}<{repr(self.connection_pool)}>"
@@ -924,8 +964,11 @@ def set_response_callback(self, command, callback):
         "Set a custom Response Callback"
         self.response_callbacks[command] = callback
 
-    def load_external_module(self, funcname, func,
-                             ):
+    def load_external_module(
+        self,
+        funcname,
+        func,
+    ):
         """
         This function can be used to add externally defined redis modules,
         and their namespaces to the redis client.
@@ -957,10 +1000,8 @@ def pipeline(self, transaction=True, shard_hint=None):
         between the client and server.
         """
         return Pipeline(
-            self.connection_pool,
-            self.response_callbacks,
-            transaction,
-            shard_hint)
+            self.connection_pool, self.response_callbacks, transaction, shard_hint
+        )
 
     def transaction(self, func, *watches, **kwargs):
         """
@@ -968,9 +1009,9 @@ def transaction(self, func, *watches, **kwargs):
         while watching all keys specified in `watches`. The 'func' callable
         should expect a single argument which is a Pipeline object.
         """
-        shard_hint = kwargs.pop('shard_hint', None)
-        value_from_callable = kwargs.pop('value_from_callable', False)
-        watch_delay = kwargs.pop('watch_delay', None)
+        shard_hint = kwargs.pop("shard_hint", None)
+        value_from_callable = kwargs.pop("value_from_callable", False)
+        watch_delay = kwargs.pop("watch_delay", None)
         with self.pipeline(True, shard_hint) as pipe:
             while True:
                 try:
@@ -984,8 +1025,15 @@ def transaction(self, func, *watches, **kwargs):
                         time.sleep(watch_delay)
                     continue
 
-    def lock(self, name, timeout=None, sleep=0.1, blocking_timeout=None,
-             lock_class=None, thread_local=True):
+    def lock(
+        self,
+        name,
+        timeout=None,
+        sleep=0.1,
+        blocking_timeout=None,
+        lock_class=None,
+        thread_local=True,
+    ):
         """
         Return a new Lock object using key ``name`` that mimics
         the behavior of threading.Lock.
@@ -1028,12 +1076,17 @@ def lock(self, name, timeout=None, sleep=0.1, blocking_timeout=None,
         local storage isn't disabled in this case, the worker thread won't see
         the token set by the thread that acquired the lock. Our assumption
         is that these cases aren't common and as such default to using
-        thread local storage.        """
+        thread local storage."""
         if lock_class is None:
             lock_class = Lock
-        return lock_class(self, name, timeout=timeout, sleep=sleep,
-                          blocking_timeout=blocking_timeout,
-                          thread_local=thread_local)
+        return lock_class(
+            self,
+            name,
+            timeout=timeout,
+            sleep=sleep,
+            blocking_timeout=blocking_timeout,
+            thread_local=thread_local,
+        )
 
     def pubsub(self, **kwargs):
         """
@@ -1047,8 +1100,9 @@ def monitor(self):
         return Monitor(self.connection_pool)
 
     def client(self):
-        return self.__class__(connection_pool=self.connection_pool,
-                              single_connection_client=True)
+        return self.__class__(
+            connection_pool=self.connection_pool, single_connection_client=True
+        )
 
     def __enter__(self):
         return self
@@ -1065,11 +1119,7 @@ def close(self):
             self.connection = None
             self.connection_pool.release(conn)
 
-    def _send_command_parse_response(self,
-                                     conn,
-                                     command_name,
-                                     *args,
-                                     **options):
+    def _send_command_parse_response(self, conn, command_name, *args, **options):
         """
         Send a command and parse the response
         """
@@ -1095,11 +1145,11 @@ def execute_command(self, *args, **options):
 
         try:
             return conn.retry.call_with_retry(
-                lambda: self._send_command_parse_response(conn,
-                                                          command_name,
-                                                          *args,
-                                                          **options),
-                lambda error: self._disconnect_raise(conn, error))
+                lambda: self._send_command_parse_response(
+                    conn, command_name, *args, **options
+                ),
+                lambda error: self._disconnect_raise(conn, error),
+            )
         finally:
             if not self.connection:
                 pool.release(conn)
@@ -1129,19 +1179,20 @@ class Monitor:
     next_command() method returns one command from monitor
     listen() method yields commands from monitor.
     """
-    monitor_re = re.compile(r'\[(\d+) (.*)\] (.*)')
+
+    monitor_re = re.compile(r"\[(\d+) (.*)\] (.*)")
     command_re = re.compile(r'"(.*?)(?<!\\)"')
 
     def __init__(self, connection_pool):
         self.connection_pool = connection_pool
-        self.connection = self.connection_pool.get_connection('MONITOR')
+        self.connection = self.connection_pool.get_connection("MONITOR")
 
     def __enter__(self):
-        self.connection.send_command('MONITOR')
+        self.connection.send_command("MONITOR")
         # check that monitor returns 'OK', but don't return it to user
         response = self.connection.read_response()
         if not bool_ok(response):
-            raise RedisError(f'MONITOR failed: {response}')
+            raise RedisError(f"MONITOR failed: {response}")
         return self
 
     def __exit__(self, *args):
@@ -1153,34 +1204,34 @@ def next_command(self):
         response = self.connection.read_response()
         if isinstance(response, bytes):
             response = self.connection.encoder.decode(response, force=True)
-        command_time, command_data = response.split(' ', 1)
+        command_time, command_data = response.split(" ", 1)
         m = self.monitor_re.match(command_data)
         db_id, client_info, command = m.groups()
-        command = ' '.join(self.command_re.findall(command))
+        command = " ".join(self.command_re.findall(command))
         # Redis escapes double quotes because each piece of the command
         # string is surrounded by double quotes. We don't have that
         # requirement so remove the escaping and leave the quote.
         command = command.replace('\\"', '"')
 
-        if client_info == 'lua':
-            client_address = 'lua'
-            client_port = ''
-            client_type = 'lua'
-        elif client_info.startswith('unix'):
-            client_address = 'unix'
+        if client_info == "lua":
+            client_address = "lua"
+            client_port = ""
+            client_type = "lua"
+        elif client_info.startswith("unix"):
+            client_address = "unix"
             client_port = client_info[5:]
-            client_type = 'unix'
+            client_type = "unix"
         else:
             # use rsplit as ipv6 addresses contain colons
-            client_address, client_port = client_info.rsplit(':', 1)
-            client_type = 'tcp'
+            client_address, client_port = client_info.rsplit(":", 1)
+            client_type = "tcp"
         return {
-            'time': float(command_time),
-            'db': int(db_id),
-            'client_address': client_address,
-            'client_port': client_port,
-            'client_type': client_type,
-            'command': command
+            "time": float(command_time),
+            "db": int(db_id),
+            "client_address": client_address,
+            "client_port": client_port,
+            "client_type": client_type,
+            "command": command,
         }
 
     def listen(self):
@@ -1197,12 +1248,18 @@ class PubSub:
     until a message arrives on one of the subscribed channels. That message
     will be returned and it's safe to start listening again.
     """
-    PUBLISH_MESSAGE_TYPES = ('message', 'pmessage')
-    UNSUBSCRIBE_MESSAGE_TYPES = ('unsubscribe', 'punsubscribe')
-    HEALTH_CHECK_MESSAGE = 'redis-py-health-check'
 
-    def __init__(self, connection_pool, shard_hint=None,
-                 ignore_subscribe_messages=False, encoder=None):
+    PUBLISH_MESSAGE_TYPES = ("message", "pmessage")
+    UNSUBSCRIBE_MESSAGE_TYPES = ("unsubscribe", "punsubscribe")
+    HEALTH_CHECK_MESSAGE = "redis-py-health-check"
+
+    def __init__(
+        self,
+        connection_pool,
+        shard_hint=None,
+        ignore_subscribe_messages=False,
+        encoder=None,
+    ):
         self.connection_pool = connection_pool
         self.shard_hint = shard_hint
         self.ignore_subscribe_messages = ignore_subscribe_messages
@@ -1213,11 +1270,11 @@ def __init__(self, connection_pool, shard_hint=None,
         if self.encoder is None:
             self.encoder = self.connection_pool.get_encoder()
         if self.encoder.decode_responses:
-            self.health_check_response = ['pong', self.HEALTH_CHECK_MESSAGE]
+            self.health_check_response = ["pong", self.HEALTH_CHECK_MESSAGE]
         else:
             self.health_check_response = [
-                b'pong',
-                self.encoder.encode(self.HEALTH_CHECK_MESSAGE)
+                b"pong",
+                self.encoder.encode(self.HEALTH_CHECK_MESSAGE),
             ]
         self.reset()
 
@@ -1282,14 +1339,13 @@ def execute_command(self, *args):
 
         if self.connection is None:
             self.connection = self.connection_pool.get_connection(
-                'pubsub',
-                self.shard_hint
+                "pubsub", self.shard_hint
             )
             # register a callback that re-subscribes to any channels we
             # were listening to when we were disconnected
             self.connection.register_connect_callback(self.on_connect)
         connection = self.connection
-        kwargs = {'check_health': not self.subscribed}
+        kwargs = {"check_health": not self.subscribed}
         self._execute(connection, connection.send_command, *args, **kwargs)
 
     def _disconnect_raise_connect(self, conn, error):
@@ -1313,27 +1369,25 @@ def _execute(self, conn, command, *args, **kwargs):
         """
         return conn.retry.call_with_retry(
             lambda: command(*args, **kwargs),
-            lambda error: self._disconnect_raise_connect(conn, error))
+            lambda error: self._disconnect_raise_connect(conn, error),
+        )
 
     def parse_response(self, block=True, timeout=0):
         """Parse the response from a publish/subscribe command"""
         conn = self.connection
         if conn is None:
             raise RuntimeError(
-                'pubsub connection not set: '
-                'did you forget to call subscribe() or psubscribe()?')
+                "pubsub connection not set: "
+                "did you forget to call subscribe() or psubscribe()?"
+            )
 
         self.check_health()
 
-        if(
-                not block
-                and not self._execute(conn, conn.can_read, timeout=timeout)
-        ):
+        if not block and not self._execute(conn, conn.can_read, timeout=timeout):
             return None
         response = self._execute(conn, conn.read_response)
 
-        if conn.health_check_interval and \
-                response == self.health_check_response:
+        if conn.health_check_interval and response == self.health_check_response:
             # ignore the health check message as user might not expect it
             return None
         return response
@@ -1342,12 +1396,12 @@ def check_health(self):
         conn = self.connection
         if conn is None:
             raise RuntimeError(
-                'pubsub connection not set: '
-                'did you forget to call subscribe() or psubscribe()?')
+                "pubsub connection not set: "
+                "did you forget to call subscribe() or psubscribe()?"
+            )
 
         if conn.health_check_interval and time.time() > conn.next_health_check:
-            conn.send_command('PING', self.HEALTH_CHECK_MESSAGE,
-                              check_health=False)
+            conn.send_command("PING", self.HEALTH_CHECK_MESSAGE, check_health=False)
 
     def _normalize_keys(self, data):
         """
@@ -1371,7 +1425,7 @@ def psubscribe(self, *args, **kwargs):
             args = list_or_args(args[0], args[1:])
         new_patterns = dict.fromkeys(args)
         new_patterns.update(kwargs)
-        ret_val = self.execute_command('PSUBSCRIBE', *new_patterns.keys())
+        ret_val = self.execute_command("PSUBSCRIBE", *new_patterns.keys())
         # update the patterns dict AFTER we send the command. we don't want to
         # subscribe twice to these patterns, once for the command and again
         # for the reconnection.
@@ -1391,7 +1445,7 @@ def punsubscribe(self, *args):
         else:
             patterns = self.patterns
         self.pending_unsubscribe_patterns.update(patterns)
-        return self.execute_command('PUNSUBSCRIBE', *args)
+        return self.execute_command("PUNSUBSCRIBE", *args)
 
     def subscribe(self, *args, **kwargs):
         """
@@ -1405,7 +1459,7 @@ def subscribe(self, *args, **kwargs):
             args = list_or_args(args[0], args[1:])
         new_channels = dict.fromkeys(args)
         new_channels.update(kwargs)
-        ret_val = self.execute_command('SUBSCRIBE', *new_channels.keys())
+        ret_val = self.execute_command("SUBSCRIBE", *new_channels.keys())
         # update the channels dict AFTER we send the command. we don't want to
         # subscribe twice to these channels, once for the command and again
         # for the reconnection.
@@ -1425,7 +1479,7 @@ def unsubscribe(self, *args):
         else:
             channels = self.channels
         self.pending_unsubscribe_channels.update(channels)
-        return self.execute_command('UNSUBSCRIBE', *args)
+        return self.execute_command("UNSUBSCRIBE", *args)
 
     def listen(self):
         "Listen for messages on channels this client has been subscribed to"
@@ -1451,8 +1505,8 @@ def ping(self, message=None):
         """
         Ping the Redis server
         """
-        message = '' if message is None else message
-        return self.execute_command('PING', message)
+        message = "" if message is None else message
+        return self.execute_command("PING", message)
 
     def handle_message(self, response, ignore_subscribe_messages=False):
         """
@@ -1461,31 +1515,31 @@ def handle_message(self, response, ignore_subscribe_messages=False):
         message being returned.
         """
         message_type = str_if_bytes(response[0])
-        if message_type == 'pmessage':
+        if message_type == "pmessage":
             message = {
-                'type': message_type,
-                'pattern': response[1],
-                'channel': response[2],
-                'data': response[3]
+                "type": message_type,
+                "pattern": response[1],
+                "channel": response[2],
+                "data": response[3],
             }
-        elif message_type == 'pong':
+        elif message_type == "pong":
             message = {
-                'type': message_type,
-                'pattern': None,
-                'channel': None,
-                'data': response[1]
+                "type": message_type,
+                "pattern": None,
+                "channel": None,
+                "data": response[1],
             }
         else:
             message = {
-                'type': message_type,
-                'pattern': None,
-                'channel': response[1],
-                'data': response[2]
+                "type": message_type,
+                "pattern": None,
+                "channel": response[1],
+                "data": response[2],
             }
 
         # if this is an unsubscribe message, remove it from memory
         if message_type in self.UNSUBSCRIBE_MESSAGE_TYPES:
-            if message_type == 'punsubscribe':
+            if message_type == "punsubscribe":
                 pattern = response[1]
                 if pattern in self.pending_unsubscribe_patterns:
                     self.pending_unsubscribe_patterns.remove(pattern)
@@ -1498,14 +1552,14 @@ def handle_message(self, response, ignore_subscribe_messages=False):
 
         if message_type in self.PUBLISH_MESSAGE_TYPES:
             # if there's a message handler, invoke it
-            if message_type == 'pmessage':
-                handler = self.patterns.get(message['pattern'], None)
+            if message_type == "pmessage":
+                handler = self.patterns.get(message["pattern"], None)
             else:
-                handler = self.channels.get(message['channel'], None)
+                handler = self.channels.get(message["channel"], None)
             if handler:
                 handler(message)
                 return None
-        elif message_type != 'pong':
+        elif message_type != "pong":
             # this is a subscribe/unsubscribe message. ignore if we don't
             # want them
             if ignore_subscribe_messages or self.ignore_subscribe_messages:
@@ -1513,8 +1567,7 @@ def handle_message(self, response, ignore_subscribe_messages=False):
 
         return message
 
-    def run_in_thread(self, sleep_time=0, daemon=False,
-                      exception_handler=None):
+    def run_in_thread(self, sleep_time=0, daemon=False, exception_handler=None):
         for channel, handler in self.channels.items():
             if handler is None:
                 raise PubSubError(f"Channel: '{channel}' has no handler registered")
@@ -1523,18 +1576,14 @@ def run_in_thread(self, sleep_time=0, daemon=False,
                 raise PubSubError(f"Pattern: '{pattern}' has no handler registered")
 
         thread = PubSubWorkerThread(
-            self,
-            sleep_time,
-            daemon=daemon,
-            exception_handler=exception_handler
+            self, sleep_time, daemon=daemon, exception_handler=exception_handler
         )
         thread.start()
         return thread
 
 
 class PubSubWorkerThread(threading.Thread):
-    def __init__(self, pubsub, sleep_time, daemon=False,
-                 exception_handler=None):
+    def __init__(self, pubsub, sleep_time, daemon=False, exception_handler=None):
         super().__init__()
         self.daemon = daemon
         self.pubsub = pubsub
@@ -1550,8 +1599,7 @@ def run(self):
         sleep_time = self.sleep_time
         while self._running.is_set():
             try:
-                pubsub.get_message(ignore_subscribe_messages=True,
-                                   timeout=sleep_time)
+                pubsub.get_message(ignore_subscribe_messages=True, timeout=sleep_time)
             except BaseException as e:
                 if self.exception_handler is None:
                     raise
@@ -1584,10 +1632,9 @@ class Pipeline(Redis):
     on a key of a different datatype.
     """
 
-    UNWATCH_COMMANDS = {'DISCARD', 'EXEC', 'UNWATCH'}
+    UNWATCH_COMMANDS = {"DISCARD", "EXEC", "UNWATCH"}
 
-    def __init__(self, connection_pool, response_callbacks, transaction,
-                 shard_hint):
+    def __init__(self, connection_pool, response_callbacks, transaction, shard_hint):
         self.connection_pool = connection_pool
         self.connection = None
         self.response_callbacks = response_callbacks
@@ -1625,7 +1672,7 @@ def reset(self):
             try:
                 # call this manually since our unwatch or
                 # immediate_execute_command methods can call reset()
-                self.connection.send_command('UNWATCH')
+                self.connection.send_command("UNWATCH")
                 self.connection.read_response()
             except ConnectionError:
                 # disconnect will also remove any previous WATCHes
@@ -1645,15 +1692,15 @@ def multi(self):
         are issued. End the transactional block with `execute`.
         """
         if self.explicit_transaction:
-            raise RedisError('Cannot issue nested calls to MULTI')
+            raise RedisError("Cannot issue nested calls to MULTI")
         if self.command_stack:
-            raise RedisError('Commands without an initial WATCH have already '
-                             'been issued')
+            raise RedisError(
+                "Commands without an initial WATCH have already " "been issued"
+            )
         self.explicit_transaction = True
 
     def execute_command(self, *args, **kwargs):
-        if (self.watching or args[0] == 'WATCH') and \
-                not self.explicit_transaction:
+        if (self.watching or args[0] == "WATCH") and not self.explicit_transaction:
             return self.immediate_execute_command(*args, **kwargs)
         return self.pipeline_execute_command(*args, **kwargs)
 
@@ -1670,8 +1717,9 @@ def _disconnect_reset_raise(self, conn, error):
         # indicates the user should retry this transaction.
         if self.watching:
             self.reset()
-            raise WatchError("A ConnectionError occurred on while "
-                             "watching one or more keys")
+            raise WatchError(
+                "A ConnectionError occurred on while " "watching one or more keys"
+            )
         # if retry_on_timeout is not set, or the error is not
         # a TimeoutError, raise it
         if not (conn.retry_on_timeout and isinstance(error, TimeoutError)):
@@ -1689,16 +1737,15 @@ def immediate_execute_command(self, *args, **options):
         conn = self.connection
         # if this is the first call, we need a connection
         if not conn:
-            conn = self.connection_pool.get_connection(command_name,
-                                                       self.shard_hint)
+            conn = self.connection_pool.get_connection(command_name, self.shard_hint)
             self.connection = conn
 
         return conn.retry.call_with_retry(
-            lambda: self._send_command_parse_response(conn,
-                                                      command_name,
-                                                      *args,
-                                                      **options),
-            lambda error: self._disconnect_reset_raise(conn, error))
+            lambda: self._send_command_parse_response(
+                conn, command_name, *args, **options
+            ),
+            lambda error: self._disconnect_reset_raise(conn, error),
+        )
 
     def pipeline_execute_command(self, *args, **options):
         """
@@ -1716,9 +1763,10 @@ def pipeline_execute_command(self, *args, **options):
         return self
 
     def _execute_transaction(self, connection, commands, raise_on_error):
-        cmds = chain([(('MULTI', ), {})], commands, [(('EXEC', ), {})])
-        all_cmds = connection.pack_commands([args for args, options in cmds
-                                             if EMPTY_RESPONSE not in options])
+        cmds = chain([(("MULTI",), {})], commands, [(("EXEC",), {})])
+        all_cmds = connection.pack_commands(
+            [args for args, options in cmds if EMPTY_RESPONSE not in options]
+        )
         connection.send_packed_command(all_cmds)
         errors = []
 
@@ -1727,7 +1775,7 @@ def _execute_transaction(self, connection, commands, raise_on_error):
         # so that we read all the additional command messages from
         # the socket
         try:
-            self.parse_response(connection, '_')
+            self.parse_response(connection, "_")
         except ResponseError as e:
             errors.append((0, e))
 
@@ -1737,14 +1785,14 @@ def _execute_transaction(self, connection, commands, raise_on_error):
                 errors.append((i, command[1][EMPTY_RESPONSE]))
             else:
                 try:
-                    self.parse_response(connection, '_')
+                    self.parse_response(connection, "_")
                 except ResponseError as e:
                     self.annotate_exception(e, i + 1, command[0])
                     errors.append((i, e))
 
         # parse the EXEC.
         try:
-            response = self.parse_response(connection, '_')
+            response = self.parse_response(connection, "_")
         except ExecAbortError:
             if errors:
                 raise errors[0][1]
@@ -1762,8 +1810,9 @@ def _execute_transaction(self, connection, commands, raise_on_error):
 
         if len(response) != len(commands):
             self.connection.disconnect()
-            raise ResponseError("Wrong number of response items from "
-                                "pipeline execution")
+            raise ResponseError(
+                "Wrong number of response items from " "pipeline execution"
+            )
 
         # find any errors in the response and raise if necessary
         if raise_on_error:
@@ -1788,8 +1837,7 @@ def _execute_pipeline(self, connection, commands, raise_on_error):
         response = []
         for args, options in commands:
             try:
-                response.append(
-                    self.parse_response(connection, args[0], **options))
+                response.append(self.parse_response(connection, args[0], **options))
             except ResponseError as e:
                 response.append(e)
 
@@ -1804,19 +1852,18 @@ def raise_first_error(self, commands, response):
                 raise r
 
     def annotate_exception(self, exception, number, command):
-        cmd = ' '.join(map(safe_str, command))
+        cmd = " ".join(map(safe_str, command))
         msg = (
-            f'Command # {number} ({cmd}) of pipeline '
-            f'caused error: {exception.args[0]}'
+            f"Command # {number} ({cmd}) of pipeline "
+            f"caused error: {exception.args[0]}"
         )
         exception.args = (msg,) + exception.args[1:]
 
     def parse_response(self, connection, command_name, **options):
-        result = Redis.parse_response(
-            self, connection, command_name, **options)
+        result = Redis.parse_response(self, connection, command_name, **options)
         if command_name in self.UNWATCH_COMMANDS:
             self.watching = False
-        elif command_name == 'WATCH':
+        elif command_name == "WATCH":
             self.watching = True
         return result
 
@@ -1827,11 +1874,11 @@ def load_scripts(self):
         shas = [s.sha for s in scripts]
         # we can't use the normal script_* methods because they would just
         # get buffered in the pipeline.
-        exists = immediate('SCRIPT EXISTS', *shas)
+        exists = immediate("SCRIPT EXISTS", *shas)
         if not all(exists):
             for s, exist in zip(scripts, exists):
                 if not exist:
-                    s.sha = immediate('SCRIPT LOAD', s.script)
+                    s.sha = immediate("SCRIPT LOAD", s.script)
 
     def _disconnect_raise_reset(self, conn, error):
         """
@@ -1844,8 +1891,9 @@ def _disconnect_raise_reset(self, conn, error):
         # since this connection has died. raise a WatchError, which
         # indicates the user should retry this transaction.
         if self.watching:
-            raise WatchError("A ConnectionError occurred on while "
-                             "watching one or more keys")
+            raise WatchError(
+                "A ConnectionError occurred on while " "watching one or more keys"
+            )
         # if retry_on_timeout is not set, or the error is not
         # a TimeoutError, raise it
         if not (conn.retry_on_timeout and isinstance(error, TimeoutError)):
@@ -1866,8 +1914,7 @@ def execute(self, raise_on_error=True):
 
         conn = self.connection
         if not conn:
-            conn = self.connection_pool.get_connection('MULTI',
-                                                       self.shard_hint)
+            conn = self.connection_pool.get_connection("MULTI", self.shard_hint)
             # assign to self.connection so reset() releases the connection
             # back to the pool after we're done
             self.connection = conn
@@ -1875,7 +1922,8 @@ def execute(self, raise_on_error=True):
         try:
             return conn.retry.call_with_retry(
                 lambda: execute(conn, stack, raise_on_error),
-                lambda error: self._disconnect_raise_reset(conn, error))
+                lambda error: self._disconnect_raise_reset(conn, error),
+            )
         finally:
             self.reset()
 
@@ -1888,9 +1936,9 @@ def discard(self):
     def watch(self, *names):
         "Watches the values at keys ``names``"
         if self.explicit_transaction:
-            raise RedisError('Cannot issue a WATCH after a MULTI')
-        return self.execute_command('WATCH', *names)
+            raise RedisError("Cannot issue a WATCH after a MULTI")
+        return self.execute_command("WATCH", *names)
 
     def unwatch(self):
         "Unwatches all previously specified keys"
-        return self.watching and self.execute_command('UNWATCH') or True
+        return self.watching and self.execute_command("UNWATCH") or True
diff --git a/redis/cluster.py b/redis/cluster.py
index c1853aa876..57e8316ba2 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -2,18 +2,15 @@
 import logging
 import random
 import socket
-import time
-import threading
 import sys
-
+import threading
+import time
 from collections import OrderedDict
-from redis.client import CaseInsensitiveDict, Redis, PubSub
-from redis.commands import (
-    ClusterCommands,
-    CommandsParser
-)
-from redis.connection import DefaultParser, ConnectionPool, Encoder, parse_url
-from redis.crc import key_slot, REDIS_CLUSTER_HASH_SLOTS
+
+from redis.client import CaseInsensitiveDict, PubSub, Redis
+from redis.commands import ClusterCommands, CommandsParser
+from redis.connection import ConnectionPool, DefaultParser, Encoder, parse_url
+from redis.crc import REDIS_CLUSTER_HASH_SLOTS, key_slot
 from redis.exceptions import (
     AskError,
     BusyLoadingError,
@@ -34,15 +31,15 @@
     dict_merge,
     list_keys_to_dict,
     merge_result,
+    safe_str,
     str_if_bytes,
-    safe_str
 )
 
 log = logging.getLogger(__name__)
 
 
 def get_node_name(host, port):
-    return f'{host}:{port}'
+    return f"{host}:{port}"
 
 
 def get_connection(redis_node, *args, **options):
@@ -67,15 +64,12 @@ def parse_pubsub_numsub(command, res, **options):
             except KeyError:
                 numsub_d[channel] = numsubbed
 
-    ret_numsub = [
-        (channel, numsub)
-        for channel, numsub in numsub_d.items()
-    ]
+    ret_numsub = [(channel, numsub) for channel, numsub in numsub_d.items()]
     return ret_numsub
 
 
 def parse_cluster_slots(resp, **options):
-    current_host = options.get('current_host', '')
+    current_host = options.get("current_host", "")
 
     def fix_server(*args):
         return str_if_bytes(args[0]) or current_host, args[1]
@@ -85,8 +79,8 @@ def fix_server(*args):
         start, end, primary = slot[:3]
         replicas = slot[3:]
         slots[start, end] = {
-            'primary': fix_server(*primary),
-            'replicas': [fix_server(*replica) for replica in replicas],
+            "primary": fix_server(*primary),
+            "replicas": [fix_server(*replica) for replica in replicas],
         }
 
     return slots
@@ -132,47 +126,49 @@ def fix_server(*args):
 
 # Not complete, but covers the major ones
 # https://redis.io/commands
-READ_COMMANDS = frozenset([
-    "BITCOUNT",
-    "BITPOS",
-    "EXISTS",
-    "GEODIST",
-    "GEOHASH",
-    "GEOPOS",
-    "GEORADIUS",
-    "GEORADIUSBYMEMBER",
-    "GET",
-    "GETBIT",
-    "GETRANGE",
-    "HEXISTS",
-    "HGET",
-    "HGETALL",
-    "HKEYS",
-    "HLEN",
-    "HMGET",
-    "HSTRLEN",
-    "HVALS",
-    "KEYS",
-    "LINDEX",
-    "LLEN",
-    "LRANGE",
-    "MGET",
-    "PTTL",
-    "RANDOMKEY",
-    "SCARD",
-    "SDIFF",
-    "SINTER",
-    "SISMEMBER",
-    "SMEMBERS",
-    "SRANDMEMBER",
-    "STRLEN",
-    "SUNION",
-    "TTL",
-    "ZCARD",
-    "ZCOUNT",
-    "ZRANGE",
-    "ZSCORE",
-])
+READ_COMMANDS = frozenset(
+    [
+        "BITCOUNT",
+        "BITPOS",
+        "EXISTS",
+        "GEODIST",
+        "GEOHASH",
+        "GEOPOS",
+        "GEORADIUS",
+        "GEORADIUSBYMEMBER",
+        "GET",
+        "GETBIT",
+        "GETRANGE",
+        "HEXISTS",
+        "HGET",
+        "HGETALL",
+        "HKEYS",
+        "HLEN",
+        "HMGET",
+        "HSTRLEN",
+        "HVALS",
+        "KEYS",
+        "LINDEX",
+        "LLEN",
+        "LRANGE",
+        "MGET",
+        "PTTL",
+        "RANDOMKEY",
+        "SCARD",
+        "SDIFF",
+        "SINTER",
+        "SISMEMBER",
+        "SMEMBERS",
+        "SRANDMEMBER",
+        "STRLEN",
+        "SUNION",
+        "TTL",
+        "ZCARD",
+        "ZCOUNT",
+        "ZRANGE",
+        "ZSCORE",
+    ]
+)
 
 
 def cleanup_kwargs(**kwargs):
@@ -190,14 +186,16 @@ def cleanup_kwargs(**kwargs):
 
 class ClusterParser(DefaultParser):
     EXCEPTION_CLASSES = dict_merge(
-        DefaultParser.EXCEPTION_CLASSES, {
-            'ASK': AskError,
-            'TRYAGAIN': TryAgainError,
-            'MOVED': MovedError,
-            'CLUSTERDOWN': ClusterDownError,
-            'CROSSSLOT': ClusterCrossSlotError,
-            'MASTERDOWN': MasterDownError,
-        })
+        DefaultParser.EXCEPTION_CLASSES,
+        {
+            "ASK": AskError,
+            "TRYAGAIN": TryAgainError,
+            "MOVED": MovedError,
+            "CLUSTERDOWN": ClusterDownError,
+            "CROSSSLOT": ClusterCrossSlotError,
+            "MASTERDOWN": MasterDownError,
+        },
+    )
 
 
 class RedisCluster(ClusterCommands):
@@ -209,13 +207,7 @@ class RedisCluster(ClusterCommands):
     RANDOM = "random"
     DEFAULT_NODE = "default-node"
 
-    NODE_FLAGS = {
-        PRIMARIES,
-        REPLICAS,
-        ALL_NODES,
-        RANDOM,
-        DEFAULT_NODE
-    }
+    NODE_FLAGS = {PRIMARIES, REPLICAS, ALL_NODES, RANDOM, DEFAULT_NODE}
 
     COMMAND_FLAGS = dict_merge(
         list_keys_to_dict(
@@ -292,119 +284,138 @@ class RedisCluster(ClusterCommands):
     )
 
     CLUSTER_COMMANDS_RESPONSE_CALLBACKS = {
-        'CLUSTER ADDSLOTS': bool,
-        'CLUSTER COUNT-FAILURE-REPORTS': int,
-        'CLUSTER COUNTKEYSINSLOT': int,
-        'CLUSTER DELSLOTS': bool,
-        'CLUSTER FAILOVER': bool,
-        'CLUSTER FORGET': bool,
-        'CLUSTER GETKEYSINSLOT': list,
-        'CLUSTER KEYSLOT': int,
-        'CLUSTER MEET': bool,
-        'CLUSTER REPLICATE': bool,
-        'CLUSTER RESET': bool,
-        'CLUSTER SAVECONFIG': bool,
-        'CLUSTER SET-CONFIG-EPOCH': bool,
-        'CLUSTER SETSLOT': bool,
-        'CLUSTER SLOTS': parse_cluster_slots,
-        'ASKING': bool,
-        'READONLY': bool,
-        'READWRITE': bool,
+        "CLUSTER ADDSLOTS": bool,
+        "CLUSTER COUNT-FAILURE-REPORTS": int,
+        "CLUSTER COUNTKEYSINSLOT": int,
+        "CLUSTER DELSLOTS": bool,
+        "CLUSTER FAILOVER": bool,
+        "CLUSTER FORGET": bool,
+        "CLUSTER GETKEYSINSLOT": list,
+        "CLUSTER KEYSLOT": int,
+        "CLUSTER MEET": bool,
+        "CLUSTER REPLICATE": bool,
+        "CLUSTER RESET": bool,
+        "CLUSTER SAVECONFIG": bool,
+        "CLUSTER SET-CONFIG-EPOCH": bool,
+        "CLUSTER SETSLOT": bool,
+        "CLUSTER SLOTS": parse_cluster_slots,
+        "ASKING": bool,
+        "READONLY": bool,
+        "READWRITE": bool,
     }
 
     RESULT_CALLBACKS = dict_merge(
-        list_keys_to_dict([
-            "PUBSUB NUMSUB",
-        ], parse_pubsub_numsub),
-        list_keys_to_dict([
-            "PUBSUB NUMPAT",
-        ], lambda command, res: sum(list(res.values()))),
-        list_keys_to_dict([
-            "KEYS",
-            "PUBSUB CHANNELS",
-        ], merge_result),
-        list_keys_to_dict([
-            "PING",
-            "CONFIG SET",
-            "CONFIG REWRITE",
-            "CONFIG RESETSTAT",
-            "CLIENT SETNAME",
-            "BGSAVE",
-            "SLOWLOG RESET",
-            "SAVE",
-            "MEMORY PURGE",
-            "CLIENT PAUSE",
-            "CLIENT UNPAUSE",
-        ], lambda command, res: all(res.values()) if isinstance(res, dict)
-            else res),
-        list_keys_to_dict([
-            "DBSIZE",
-            "WAIT",
-        ], lambda command, res: sum(res.values()) if isinstance(res, dict)
-            else res),
-        list_keys_to_dict([
-            "CLIENT UNBLOCK",
-        ], lambda command, res: 1 if sum(res.values()) > 0 else 0),
-        list_keys_to_dict([
-            "SCAN",
-        ], parse_scan_result)
+        list_keys_to_dict(
+            [
+                "PUBSUB NUMSUB",
+            ],
+            parse_pubsub_numsub,
+        ),
+        list_keys_to_dict(
+            [
+                "PUBSUB NUMPAT",
+            ],
+            lambda command, res: sum(list(res.values())),
+        ),
+        list_keys_to_dict(
+            [
+                "KEYS",
+                "PUBSUB CHANNELS",
+            ],
+            merge_result,
+        ),
+        list_keys_to_dict(
+            [
+                "PING",
+                "CONFIG SET",
+                "CONFIG REWRITE",
+                "CONFIG RESETSTAT",
+                "CLIENT SETNAME",
+                "BGSAVE",
+                "SLOWLOG RESET",
+                "SAVE",
+                "MEMORY PURGE",
+                "CLIENT PAUSE",
+                "CLIENT UNPAUSE",
+            ],
+            lambda command, res: all(res.values()) if isinstance(res, dict) else res,
+        ),
+        list_keys_to_dict(
+            [
+                "DBSIZE",
+                "WAIT",
+            ],
+            lambda command, res: sum(res.values()) if isinstance(res, dict) else res,
+        ),
+        list_keys_to_dict(
+            [
+                "CLIENT UNBLOCK",
+            ],
+            lambda command, res: 1 if sum(res.values()) > 0 else 0,
+        ),
+        list_keys_to_dict(
+            [
+                "SCAN",
+            ],
+            parse_scan_result,
+        ),
     )
 
     def __init__(
-            self,
-            host=None,
-            port=6379,
-            startup_nodes=None,
-            cluster_error_retry_attempts=3,
-            require_full_coverage=True,
-            skip_full_coverage_check=False,
-            reinitialize_steps=10,
-            read_from_replicas=False,
-            url=None,
-            retry_on_timeout=False,
-            retry=None,
-            **kwargs
+        self,
+        host=None,
+        port=6379,
+        startup_nodes=None,
+        cluster_error_retry_attempts=3,
+        require_full_coverage=True,
+        skip_full_coverage_check=False,
+        reinitialize_steps=10,
+        read_from_replicas=False,
+        url=None,
+        retry_on_timeout=False,
+        retry=None,
+        **kwargs,
     ):
         """
-        Initialize a new RedisCluster client.
-
-        :startup_nodes: 'list[ClusterNode]'
-            List of nodes from which initial bootstrapping can be done
-        :host: 'str'
-            Can be used to point to a startup node
-        :port: 'int'
-            Can be used to point to a startup node
-        :require_full_coverage: 'bool'
-            If set to True, as it is by default, all slots must be covered.
-            If set to False and not all slots are covered, the instance
-            creation will succeed only if 'cluster-require-full-coverage'
-            configuration is set to 'no' in all of the cluster's nodes.
-            Otherwise, RedisClusterException will be thrown.
-        :skip_full_coverage_check: 'bool'
-            If require_full_coverage is set to False, a check of
-            cluster-require-full-coverage config will be executed against all
-            nodes. Set skip_full_coverage_check to True to skip this check.
-            Useful for clusters without the CONFIG command (like ElastiCache)
-       :read_from_replicas: 'bool'
-            Enable read from replicas in READONLY mode. You can read possibly
-            stale data.
-            When set to true, read commands will be assigned between the
-            primary and its replications in a Round-Robin manner.
-        :cluster_error_retry_attempts: 'int'
-            Retry command execution attempts when encountering ClusterDownError
-            or ConnectionError
-        :retry_on_timeout: 'bool'
-            To specify a retry policy, first set `retry_on_timeout` to `True`
-            then set `retry` to a valid `Retry` object
-        :retry: 'Retry'
-             a `Retry` object
-        :**kwargs:
-            Extra arguments that will be sent into Redis instance when created
-            (See Official redis-py doc for supported kwargs
-        [https://github.com/andymccurdy/redis-py/blob/master/redis/client.py])
-            Some kwargs are not supported and will raise a
-            RedisClusterException:
-                - db (Redis do not support database SELECT in cluster mode)
+         Initialize a new RedisCluster client.
+
+         :startup_nodes: 'list[ClusterNode]'
+             List of nodes from which initial bootstrapping can be done
+         :host: 'str'
+             Can be used to point to a startup node
+         :port: 'int'
+             Can be used to point to a startup node
+         :require_full_coverage: 'bool'
+             If set to True, as it is by default, all slots must be covered.
+             If set to False and not all slots are covered, the instance
+             creation will succeed only if 'cluster-require-full-coverage'
+             configuration is set to 'no' in all of the cluster's nodes.
+             Otherwise, RedisClusterException will be thrown.
+         :skip_full_coverage_check: 'bool'
+             If require_full_coverage is set to False, a check of
+             cluster-require-full-coverage config will be executed against all
+             nodes. Set skip_full_coverage_check to True to skip this check.
+             Useful for clusters without the CONFIG command (like ElastiCache)
+        :read_from_replicas: 'bool'
+             Enable read from replicas in READONLY mode. You can read possibly
+             stale data.
+             When set to true, read commands will be assigned between the
+             primary and its replications in a Round-Robin manner.
+         :cluster_error_retry_attempts: 'int'
+             Retry command execution attempts when encountering ClusterDownError
+             or ConnectionError
+         :retry_on_timeout: 'bool'
+             To specify a retry policy, first set `retry_on_timeout` to `True`
+             then set `retry` to a valid `Retry` object
+         :retry: 'Retry'
+              a `Retry` object
+         :**kwargs:
+             Extra arguments that will be sent into Redis instance when created
+             (See Official redis-py doc for supported kwargs
+         [https://github.com/andymccurdy/redis-py/blob/master/redis/client.py])
+             Some kwargs are not supported and will raise a
+             RedisClusterException:
+                 - db (Redis do not support database SELECT in cluster mode)
         """
         log.info("Creating a new instance of RedisCluster client")
 
@@ -418,8 +429,7 @@ def __init__(
             )
 
         if retry_on_timeout:
-            kwargs.update({'retry_on_timeout': retry_on_timeout,
-                           'retry': retry})
+            kwargs.update({"retry_on_timeout": retry_on_timeout, "retry": retry})
 
         # Get the startup node/s
         from_url = False
@@ -429,15 +439,16 @@ def __init__(
             if "path" in url_options:
                 raise RedisClusterException(
                     "RedisCluster does not currently support Unix Domain "
-                    "Socket connections")
+                    "Socket connections"
+                )
             if "db" in url_options and url_options["db"] != 0:
                 # Argument 'db' is not possible to use in cluster mode
                 raise RedisClusterException(
                     "A ``db`` querystring option can only be 0 in cluster mode"
                 )
             kwargs.update(url_options)
-            host = kwargs.get('host')
-            port = kwargs.get('port', port)
+            host = kwargs.get("host")
+            port = kwargs.get("port", port)
             startup_nodes.append(ClusterNode(host, port))
         elif host is not None and port is not None:
             startup_nodes.append(ClusterNode(host, port))
@@ -450,7 +461,8 @@ def __init__(
                 " RedisCluster(host='localhost', port=6379)\n"
                 "2. list of startup nodes, for example:\n"
                 " RedisCluster(startup_nodes=[ClusterNode('localhost', 6379),"
-                " ClusterNode('localhost', 6378)])")
+                " ClusterNode('localhost', 6378)])"
+            )
         log.debug(f"startup_nodes : {startup_nodes}")
         # Update the connection arguments
         # Whenever a new connection is established, RedisCluster's on_connect
@@ -482,9 +494,9 @@ def __init__(
         )
 
         self.cluster_response_callbacks = CaseInsensitiveDict(
-            self.__class__.CLUSTER_COMMANDS_RESPONSE_CALLBACKS)
-        self.result_callbacks = CaseInsensitiveDict(
-            self.__class__.RESULT_CALLBACKS)
+            self.__class__.CLUSTER_COMMANDS_RESPONSE_CALLBACKS
+        )
+        self.result_callbacks = CaseInsensitiveDict(self.__class__.RESULT_CALLBACKS)
         self.commands_parser = CommandsParser(self)
         self._lock = threading.Lock()
 
@@ -563,9 +575,9 @@ def on_connect(self, connection):
             # to a failover, we should establish a READONLY connection
             # regardless of the server type. If this is a primary connection,
             # READONLY would not affect executing write commands.
-            connection.send_command('READONLY')
-            if str_if_bytes(connection.read_response()) != 'OK':
-                raise ConnectionError('READONLY command failed')
+            connection.send_command("READONLY")
+            if str_if_bytes(connection.read_response()) != "OK":
+                raise ConnectionError("READONLY command failed")
 
         if self.user_on_connect_func is not None:
             self.user_on_connect_func(connection)
@@ -601,9 +613,7 @@ def get_node_from_key(self, key, replica=False):
         slot = self.keyslot(key)
         slot_cache = self.nodes_manager.slots_cache.get(slot)
         if slot_cache is None or len(slot_cache) == 0:
-            raise SlotNotCoveredError(
-                f'Slot "{slot}" is not covered by the cluster.'
-            )
+            raise SlotNotCoveredError(f'Slot "{slot}" is not covered by the cluster.')
         if replica and len(self.nodes_manager.slots_cache[slot]) < 2:
             return None
         elif replica:
@@ -627,8 +637,10 @@ def set_default_node(self, node):
         :return True if the default node was set, else False
         """
         if node is None or self.get_node(node_name=node.name) is None:
-            log.info("The requested node does not exist in the cluster, so "
-                     "the default node was not changed.")
+            log.info(
+                "The requested node does not exist in the cluster, so "
+                "the default node was not changed."
+            )
             return False
         self.nodes_manager.default_node = node
         log.info(f"Changed the default cluster node to {node}")
@@ -651,12 +663,10 @@ def pipeline(self, transaction=None, shard_hint=None):
             when calling execute() will only return the result stack.
         """
         if shard_hint:
-            raise RedisClusterException(
-                "shard_hint is deprecated in cluster mode")
+            raise RedisClusterException("shard_hint is deprecated in cluster mode")
 
         if transaction:
-            raise RedisClusterException(
-                "transaction is deprecated in cluster mode")
+            raise RedisClusterException("transaction is deprecated in cluster mode")
 
         return ClusterPipeline(
             nodes_manager=self.nodes_manager,
@@ -665,7 +675,7 @@ def pipeline(self, transaction=None, shard_hint=None):
             cluster_response_callbacks=self.cluster_response_callbacks,
             cluster_error_retry_attempts=self.cluster_error_retry_attempts,
             read_from_replicas=self.read_from_replicas,
-            reinitialize_steps=self.reinitialize_steps
+            reinitialize_steps=self.reinitialize_steps,
         )
 
     def _determine_nodes(self, *args, **kwargs):
@@ -698,7 +708,8 @@ def _determine_nodes(self, *args, **kwargs):
             # get the node that holds the key's slot
             slot = self.determine_slot(*args)
             node = self.nodes_manager.get_node_from_slot(
-                slot, self.read_from_replicas and command in READ_COMMANDS)
+                slot, self.read_from_replicas and command in READ_COMMANDS
+            )
             log.debug(f"Target for {args}: slot {slot}")
             return [node]
 
@@ -760,8 +771,7 @@ def reinitialize_caches(self):
         self.nodes_manager.initialize()
 
     def _is_nodes_flag(self, target_nodes):
-        return isinstance(target_nodes, str) \
-            and target_nodes in self.node_flags
+        return isinstance(target_nodes, str) and target_nodes in self.node_flags
 
     def _parse_target_nodes(self, target_nodes):
         if isinstance(target_nodes, list):
@@ -812,8 +822,9 @@ def execute_command(self, *args, **kwargs):
         # the command execution since the nodes may not be valid anymore
         # after the tables were reinitialized. So in case of passed target
         # nodes, retry_attempts will be set to 1.
-        retry_attempts = 1 if target_nodes_specified else \
-            self.cluster_error_retry_attempts
+        retry_attempts = (
+            1 if target_nodes_specified else self.cluster_error_retry_attempts
+        )
         exception = None
         for _ in range(0, retry_attempts):
             try:
@@ -821,13 +832,14 @@ def execute_command(self, *args, **kwargs):
                 if not target_nodes_specified:
                     # Determine the nodes to execute the command on
                     target_nodes = self._determine_nodes(
-                        *args, **kwargs, nodes_flag=target_nodes)
+                        *args, **kwargs, nodes_flag=target_nodes
+                    )
                     if not target_nodes:
                         raise RedisClusterException(
-                            f"No targets were found to execute {args} command on")
+                            f"No targets were found to execute {args} command on"
+                        )
                 for node in target_nodes:
-                    res[node.name] = self._execute_command(
-                        node, *args, **kwargs)
+                    res[node.name] = self._execute_command(node, *args, **kwargs)
                 # Return the processed result
                 return self._process_result(args[0], res, **kwargs)
             except (ClusterDownError, ConnectionError) as e:
@@ -862,9 +874,9 @@ def _execute_command(self, target_node, *args, **kwargs):
                     # MOVED occurred and the slots cache was updated,
                     # refresh the target node
                     slot = self.determine_slot(*args)
-                    target_node = self.nodes_manager. \
-                        get_node_from_slot(slot, self.read_from_replicas and
-                                           command in READ_COMMANDS)
+                    target_node = self.nodes_manager.get_node_from_slot(
+                        slot, self.read_from_replicas and command in READ_COMMANDS
+                    )
                     moved = False
 
                 log.debug(
@@ -879,11 +891,11 @@ def _execute_command(self, target_node, *args, **kwargs):
                     asking = False
 
                 connection.send_command(*args)
-                response = redis_node.parse_response(connection, command,
-                                                     **kwargs)
+                response = redis_node.parse_response(connection, command, **kwargs)
                 if command in self.cluster_response_callbacks:
                     response = self.cluster_response_callbacks[command](
-                        response, **kwargs)
+                        response, **kwargs
+                    )
                 return response
 
             except (RedisClusterException, BusyLoadingError):
@@ -997,7 +1009,7 @@ def _process_result(self, command, res, **kwargs):
 
 class ClusterNode:
     def __init__(self, host, port, server_type=None, redis_connection=None):
-        if host == 'localhost':
+        if host == "localhost":
             host = socket.gethostbyname(host)
 
         self.host = host
@@ -1008,11 +1020,11 @@ def __init__(self, host, port, server_type=None, redis_connection=None):
 
     def __repr__(self):
         return (
-            f'[host={self.host},'
-            f'port={self.port},'
-            f'name={self.name},'
-            f'server_type={self.server_type},'
-            f'redis_connection={self.redis_connection}]'
+            f"[host={self.host},"
+            f"port={self.port},"
+            f"name={self.name},"
+            f"server_type={self.server_type},"
+            f"redis_connection={self.redis_connection}]"
         )
 
     def __eq__(self, obj):
@@ -1029,8 +1041,7 @@ def __init__(self, start_index=0):
         self.start_index = start_index
 
     def get_server_index(self, primary, list_size):
-        server_index = self.primary_to_idx.setdefault(primary,
-                                                      self.start_index)
+        server_index = self.primary_to_idx.setdefault(primary, self.start_index)
         # Update the index
         self.primary_to_idx[primary] = (server_index + 1) % list_size
         return server_index
@@ -1040,9 +1051,15 @@ def reset(self):
 
 
 class NodesManager:
-    def __init__(self, startup_nodes, from_url=False,
-                 require_full_coverage=True, skip_full_coverage_check=False,
-                 lock=None, **kwargs):
+    def __init__(
+        self,
+        startup_nodes,
+        from_url=False,
+        require_full_coverage=True,
+        skip_full_coverage_check=False,
+        lock=None,
+        **kwargs,
+    ):
         self.nodes_cache = {}
         self.slots_cache = {}
         self.startup_nodes = {}
@@ -1122,8 +1139,7 @@ def _update_moved_slots(self):
         # Reset moved_exception
         self._moved_exception = None
 
-    def get_node_from_slot(self, slot, read_from_replicas=False,
-                           server_type=None):
+    def get_node_from_slot(self, slot, read_from_replicas=False, server_type=None):
         """
         Gets a node that servers this hash slot
         """
@@ -1132,8 +1148,7 @@ def get_node_from_slot(self, slot, read_from_replicas=False,
                 if self._moved_exception:
                     self._update_moved_slots()
 
-        if self.slots_cache.get(slot) is None or \
-                len(self.slots_cache[slot]) == 0:
+        if self.slots_cache.get(slot) is None or len(self.slots_cache[slot]) == 0:
             raise SlotNotCoveredError(
                 f'Slot "{slot}" not covered by the cluster. '
                 f'"require_full_coverage={self._require_full_coverage}"'
@@ -1143,19 +1158,19 @@ def get_node_from_slot(self, slot, read_from_replicas=False,
             # get the server index in a Round-Robin manner
             primary_name = self.slots_cache[slot][0].name
             node_idx = self.read_load_balancer.get_server_index(
-                primary_name, len(self.slots_cache[slot]))
+                primary_name, len(self.slots_cache[slot])
+            )
         elif (
-                server_type is None
-                or server_type == PRIMARY
-                or len(self.slots_cache[slot]) == 1
+            server_type is None
+            or server_type == PRIMARY
+            or len(self.slots_cache[slot]) == 1
         ):
             # return a primary
             node_idx = 0
         else:
             # return a replica
             # randomly choose one of the replicas
-            node_idx = random.randint(
-                1, len(self.slots_cache[slot]) - 1)
+            node_idx = random.randint(1, len(self.slots_cache[slot]) - 1)
 
         return self.slots_cache[slot][node_idx]
 
@@ -1187,20 +1202,22 @@ def cluster_require_full_coverage(self, cluster_nodes):
 
         def node_require_full_coverage(node):
             try:
-                return ("yes" in node.redis_connection.config_get(
-                    "cluster-require-full-coverage").values()
+                return (
+                    "yes"
+                    in node.redis_connection.config_get(
+                        "cluster-require-full-coverage"
+                    ).values()
                 )
             except ConnectionError:
                 return False
             except Exception as e:
                 raise RedisClusterException(
                     'ERROR sending "config get cluster-require-full-coverage"'
-                    f' command to redis server: {node.name}, {e}'
+                    f" command to redis server: {node.name}, {e}"
                 )
 
         # at least one node should have cluster-require-full-coverage yes
-        return any(node_require_full_coverage(node)
-                   for node in cluster_nodes.values())
+        return any(node_require_full_coverage(node) for node in cluster_nodes.values())
 
     def check_slots_coverage(self, slots_cache):
         # Validate if all slots are covered or if we should try next
@@ -1229,11 +1246,7 @@ def create_redis_node(self, host, port, **kwargs):
             kwargs.update({"port": port})
             r = Redis(connection_pool=ConnectionPool(**kwargs))
         else:
-            r = Redis(
-                host=host,
-                port=port,
-                **kwargs
-            )
+            r = Redis(host=host, port=port, **kwargs)
         return r
 
     def initialize(self):
@@ -1257,22 +1270,23 @@ def initialize(self):
                     # Create a new Redis connection and let Redis decode the
                     # responses so we won't need to handle that
                     copy_kwargs = copy.deepcopy(kwargs)
-                    copy_kwargs.update({"decode_responses": True,
-                                        "encoding": "utf-8"})
+                    copy_kwargs.update({"decode_responses": True, "encoding": "utf-8"})
                     r = self.create_redis_node(
-                        startup_node.host, startup_node.port, **copy_kwargs)
+                        startup_node.host, startup_node.port, **copy_kwargs
+                    )
                     self.startup_nodes[startup_node.name].redis_connection = r
                 cluster_slots = r.execute_command("CLUSTER SLOTS")
                 startup_nodes_reachable = True
             except (ConnectionError, TimeoutError) as e:
                 msg = e.__str__
-                log.exception('An exception occurred while trying to'
-                              ' initialize the cluster using the seed node'
-                              f' {startup_node.name}:\n{msg}')
+                log.exception(
+                    "An exception occurred while trying to"
+                    " initialize the cluster using the seed node"
+                    f" {startup_node.name}:\n{msg}"
+                )
                 continue
             except ResponseError as e:
-                log.exception(
-                    'ReseponseError sending "cluster slots" to redis server')
+                log.exception('ReseponseError sending "cluster slots" to redis server')
 
                 # Isn't a cluster connection, so it won't parse these
                 # exceptions automatically
@@ -1282,13 +1296,13 @@ def initialize(self):
                 else:
                     raise RedisClusterException(
                         'ERROR sending "cluster slots" command to redis '
-                        f'server: {startup_node}. error: {message}'
+                        f"server: {startup_node}. error: {message}"
                     )
             except Exception as e:
                 message = e.__str__()
                 raise RedisClusterException(
                     'ERROR sending "cluster slots" command to redis '
-                    f'server: {startup_node}. error: {message}'
+                    f"server: {startup_node}. error: {message}"
                 )
 
             # CLUSTER SLOTS command results in the following output:
@@ -1298,9 +1312,11 @@ def initialize(self):
             # primary node of the first slot section.
             # If there's only one server in the cluster, its ``host`` is ''
             # Fix it to the host in startup_nodes
-            if (len(cluster_slots) == 1
-                    and len(cluster_slots[0][2][0]) == 0
-                    and len(self.startup_nodes) == 1):
+            if (
+                len(cluster_slots) == 1
+                and len(cluster_slots[0][2][0]) == 0
+                and len(self.startup_nodes) == 1
+            ):
                 cluster_slots[0][2][0] = startup_node.host
 
             for slot in cluster_slots:
@@ -1327,10 +1343,10 @@ def initialize(self):
                             port = replica_node[1]
 
                             target_replica_node = tmp_nodes_cache.get(
-                                get_node_name(host, port))
+                                get_node_name(host, port)
+                            )
                             if target_replica_node is None:
-                                target_replica_node = ClusterNode(
-                                    host, port, REPLICA)
+                                target_replica_node = ClusterNode(host, port, REPLICA)
                             tmp_slots[i].append(target_replica_node)
                             # add this node to the nodes cache
                             tmp_nodes_cache[
@@ -1342,12 +1358,12 @@ def initialize(self):
                         tmp_slot = tmp_slots[i][0]
                         if tmp_slot.name != target_node.name:
                             disagreements.append(
-                                f'{tmp_slot.name} vs {target_node.name} on slot: {i}'
+                                f"{tmp_slot.name} vs {target_node.name} on slot: {i}"
                             )
 
                             if len(disagreements) > 5:
                                 raise RedisClusterException(
-                                    f'startup_nodes could not agree on a valid '
+                                    f"startup_nodes could not agree on a valid "
                                     f'slots cache: {", ".join(disagreements)}'
                                 )
 
@@ -1366,8 +1382,8 @@ def initialize(self):
             # Despite the requirement that the slots be covered, there
             # isn't a full coverage
             raise RedisClusterException(
-                f'All slots are not covered after query all startup_nodes. '
-                f'{len(self.slots_cache)} of {REDIS_CLUSTER_HASH_SLOTS} covered...'
+                f"All slots are not covered after query all startup_nodes. "
+                f"{len(self.slots_cache)} of {REDIS_CLUSTER_HASH_SLOTS} covered..."
             )
         elif not fully_covered and not self._require_full_coverage:
             # The user set require_full_coverage to False.
@@ -1376,15 +1392,17 @@ def initialize(self):
             # continue with partial coverage.
             # see Redis Cluster configuration parameters in
             # https://redis.io/topics/cluster-tutorial
-            if not self._skip_full_coverage_check and \
-                    self.cluster_require_full_coverage(tmp_nodes_cache):
+            if (
+                not self._skip_full_coverage_check
+                and self.cluster_require_full_coverage(tmp_nodes_cache)
+            ):
                 raise RedisClusterException(
-                    'Not all slots are covered but the cluster\'s '
-                    'configuration requires full coverage. Set '
-                    'cluster-require-full-coverage configuration to no on '
-                    'all of the cluster nodes if you wish the cluster to '
-                    'be able to serve without being fully covered.'
-                    f'{len(self.slots_cache)} of {REDIS_CLUSTER_HASH_SLOTS} covered...'
+                    "Not all slots are covered but the cluster's "
+                    "configuration requires full coverage. Set "
+                    "cluster-require-full-coverage configuration to no on "
+                    "all of the cluster nodes if you wish the cluster to "
+                    "be able to serve without being fully covered."
+                    f"{len(self.slots_cache)} of {REDIS_CLUSTER_HASH_SLOTS} covered..."
                 )
 
         # Set the tmp variables to the real variables
@@ -1418,8 +1436,7 @@ class ClusterPubSub(PubSub):
     https://redis-py-cluster.readthedocs.io/en/stable/pubsub.html
     """
 
-    def __init__(self, redis_cluster, node=None, host=None, port=None,
-                 **kwargs):
+    def __init__(self, redis_cluster, node=None, host=None, port=None, **kwargs):
         """
         When a pubsub instance is created without specifying a node, a single
         node will be transparently chosen for the pubsub connection on the
@@ -1436,11 +1453,15 @@ def __init__(self, redis_cluster, node=None, host=None, port=None,
         log.info("Creating new instance of ClusterPubSub")
         self.node = None
         self.set_pubsub_node(redis_cluster, node, host, port)
-        connection_pool = None if self.node is None else \
-            redis_cluster.get_redis_connection(self.node).connection_pool
+        connection_pool = (
+            None
+            if self.node is None
+            else redis_cluster.get_redis_connection(self.node).connection_pool
+        )
         self.cluster = redis_cluster
-        super().__init__(**kwargs, connection_pool=connection_pool,
-                         encoder=redis_cluster.encoder)
+        super().__init__(
+            **kwargs, connection_pool=connection_pool, encoder=redis_cluster.encoder
+        )
 
     def set_pubsub_node(self, cluster, node=None, host=None, port=None):
         """
@@ -1468,8 +1489,7 @@ def set_pubsub_node(self, cluster, node=None, host=None, port=None):
             pubsub_node = node
         elif any([host, port]) is True:
             # only 'host' or 'port' passed
-            raise DataError('Passing a host requires passing a port, '
-                            'and vice versa')
+            raise DataError("Passing a host requires passing a port, " "and vice versa")
         else:
             # nothing passed by the user. set node to None
             pubsub_node = None
@@ -1489,7 +1509,8 @@ def _raise_on_invalid_node(self, redis_cluster, node, host, port):
         """
         if node is None or redis_cluster.get_node(node_name=node.name) is None:
             raise RedisClusterException(
-                f"Node {host}:{port} doesn't exist in the cluster")
+                f"Node {host}:{port} doesn't exist in the cluster"
+            )
 
     def execute_command(self, *args, **kwargs):
         """
@@ -1508,9 +1529,9 @@ def execute_command(self, *args, **kwargs):
                     # this slot
                     channel = args[1]
                     slot = self.cluster.keyslot(channel)
-                    node = self.cluster.nodes_manager. \
-                        get_node_from_slot(slot, self.cluster.
-                                           read_from_replicas)
+                    node = self.cluster.nodes_manager.get_node_from_slot(
+                        slot, self.cluster.read_from_replicas
+                    )
                 else:
                     # Get a random node
                     node = self.cluster.get_random_node()
@@ -1518,8 +1539,7 @@ def execute_command(self, *args, **kwargs):
                 redis_connection = self.cluster.get_redis_connection(node)
                 self.connection_pool = redis_connection.connection_pool
             self.connection = self.connection_pool.get_connection(
-                'pubsub',
-                self.shard_hint
+                "pubsub", self.shard_hint
             )
             # register a callback that re-subscribes to any channels we
             # were listening to when we were disconnected
@@ -1535,8 +1555,13 @@ def get_redis_connection(self):
             return self.node.redis_connection
 
 
-ERRORS_ALLOW_RETRY = (ConnectionError, TimeoutError,
-                      MovedError, AskError, TryAgainError)
+ERRORS_ALLOW_RETRY = (
+    ConnectionError,
+    TimeoutError,
+    MovedError,
+    AskError,
+    TryAgainError,
+)
 
 
 class ClusterPipeline(RedisCluster):
@@ -1545,18 +1570,25 @@ class ClusterPipeline(RedisCluster):
     in cluster mode
     """
 
-    def __init__(self, nodes_manager, result_callbacks=None,
-                 cluster_response_callbacks=None, startup_nodes=None,
-                 read_from_replicas=False, cluster_error_retry_attempts=3,
-                 reinitialize_steps=10, **kwargs):
-        """
-        """
+    def __init__(
+        self,
+        nodes_manager,
+        result_callbacks=None,
+        cluster_response_callbacks=None,
+        startup_nodes=None,
+        read_from_replicas=False,
+        cluster_error_retry_attempts=3,
+        reinitialize_steps=10,
+        **kwargs,
+    ):
+        """ """
         log.info("Creating new instance of ClusterPipeline")
         self.command_stack = []
         self.nodes_manager = nodes_manager
         self.refresh_table_asap = False
-        self.result_callbacks = (result_callbacks or
-                                 self.__class__.RESULT_CALLBACKS.copy())
+        self.result_callbacks = (
+            result_callbacks or self.__class__.RESULT_CALLBACKS.copy()
+        )
         self.startup_nodes = startup_nodes if startup_nodes else []
         self.read_from_replicas = read_from_replicas
         self.command_flags = self.__class__.COMMAND_FLAGS.copy()
@@ -1576,18 +1608,15 @@ def __init__(self, nodes_manager, result_callbacks=None,
         self.commands_parser = CommandsParser(super())
 
     def __repr__(self):
-        """
-        """
+        """ """
         return f"{type(self).__name__}"
 
     def __enter__(self):
-        """
-        """
+        """ """
         return self
 
     def __exit__(self, exc_type, exc_value, traceback):
-        """
-        """
+        """ """
         self.reset()
 
     def __del__(self):
@@ -1597,8 +1626,7 @@ def __del__(self):
             pass
 
     def __len__(self):
-        """
-        """
+        """ """
         return len(self.command_stack)
 
     def __nonzero__(self):
@@ -1620,7 +1648,8 @@ def pipeline_execute_command(self, *args, **options):
         Appends the executed command to the pipeline's command stack
         """
         self.command_stack.append(
-            PipelineCommand(args, options, len(self.command_stack)))
+            PipelineCommand(args, options, len(self.command_stack))
+        )
         return self
 
     def raise_first_error(self, stack):
@@ -1637,10 +1666,10 @@ def annotate_exception(self, exception, number, command):
         """
         Provides extra context to the exception prior to it being handled
         """
-        cmd = ' '.join(map(safe_str, command))
+        cmd = " ".join(map(safe_str, command))
         msg = (
-            f'Command # {number} ({cmd}) of pipeline '
-            f'caused error: {exception.args[0]}'
+            f"Command # {number} ({cmd}) of pipeline "
+            f"caused error: {exception.args[0]}"
         )
         exception.args = (msg,) + exception.args[1:]
 
@@ -1686,8 +1715,9 @@ def reset(self):
         #     self.connection_pool.release(self.connection)
         #     self.connection = None
 
-    def send_cluster_commands(self, stack,
-                              raise_on_error=True, allow_redirections=True):
+    def send_cluster_commands(
+        self, stack, raise_on_error=True, allow_redirections=True
+    ):
         """
         Wrapper for CLUSTERDOWN error handling.
 
@@ -1720,12 +1750,11 @@ def send_cluster_commands(self, stack,
 
         # If it fails the configured number of times then raise
         # exception back to caller of this method
-        raise ClusterDownError(
-            "CLUSTERDOWN error. Unable to rebuild the cluster")
+        raise ClusterDownError("CLUSTERDOWN error. Unable to rebuild the cluster")
 
-    def _send_cluster_commands(self, stack,
-                               raise_on_error=True,
-                               allow_redirections=True):
+    def _send_cluster_commands(
+        self, stack, raise_on_error=True, allow_redirections=True
+    ):
         """
         Send a bunch of cluster commands to the redis cluster.
 
@@ -1751,7 +1780,8 @@ def _send_cluster_commands(self, stack,
             # command should route to.
             slot = self.determine_slot(*c.args)
             node = self.nodes_manager.get_node_from_slot(
-                slot, self.read_from_replicas and c.args[0] in READ_COMMANDS)
+                slot, self.read_from_replicas and c.args[0] in READ_COMMANDS
+            )
 
             # now that we know the name of the node
             # ( it's just a string in the form of host:port )
@@ -1760,9 +1790,9 @@ def _send_cluster_commands(self, stack,
             if node_name not in nodes:
                 redis_node = self.get_redis_connection(node)
                 connection = get_connection(redis_node, c.args)
-                nodes[node_name] = NodeCommands(redis_node.parse_response,
-                                                redis_node.connection_pool,
-                                                connection)
+                nodes[node_name] = NodeCommands(
+                    redis_node.parse_response, redis_node.connection_pool, connection
+                )
 
             nodes[node_name].append(c)
 
@@ -1808,9 +1838,10 @@ def _send_cluster_commands(self, stack,
         # if we have more commands to attempt, we've run into problems.
         # collect all the commands we are allowed to retry.
         # (MOVED, ASK, or connection errors or timeout errors)
-        attempt = sorted((c for c in attempt
-                          if isinstance(c.result, ERRORS_ALLOW_RETRY)),
-                         key=lambda x: x.position)
+        attempt = sorted(
+            (c for c in attempt if isinstance(c.result, ERRORS_ALLOW_RETRY)),
+            key=lambda x: x.position,
+        )
         if attempt and allow_redirections:
             # RETRY MAGIC HAPPENS HERE!
             # send these remaing comamnds one at a time using `execute_command`
@@ -1831,10 +1862,10 @@ def _send_cluster_commands(self, stack,
             # flag to rebuild the slots table from scratch.
             # So MOVED errors should correct themselves fairly quickly.
             log.exception(
-                f'An exception occurred during pipeline execution. '
-                f'args: {attempt[-1].args}, '
-                f'error: {type(attempt[-1].result).__name__} '
-                f'{str(attempt[-1].result)}'
+                f"An exception occurred during pipeline execution. "
+                f"args: {attempt[-1].args}, "
+                f"error: {type(attempt[-1].result).__name__} "
+                f"{str(attempt[-1].result)}"
             )
             self.reinitialize_counter += 1
             if self._should_reinitialized():
@@ -1857,55 +1888,47 @@ def _send_cluster_commands(self, stack,
         return response
 
     def _fail_on_redirect(self, allow_redirections):
-        """
-        """
+        """ """
         if not allow_redirections:
             raise RedisClusterException(
-                "ASK & MOVED redirection not allowed in this pipeline")
+                "ASK & MOVED redirection not allowed in this pipeline"
+            )
 
     def eval(self):
-        """
-        """
+        """ """
         raise RedisClusterException("method eval() is not implemented")
 
     def multi(self):
-        """
-        """
+        """ """
         raise RedisClusterException("method multi() is not implemented")
 
     def immediate_execute_command(self, *args, **options):
-        """
-        """
+        """ """
         raise RedisClusterException(
-            "method immediate_execute_command() is not implemented")
+            "method immediate_execute_command() is not implemented"
+        )
 
     def _execute_transaction(self, *args, **kwargs):
-        """
-        """
-        raise RedisClusterException(
-            "method _execute_transaction() is not implemented")
+        """ """
+        raise RedisClusterException("method _execute_transaction() is not implemented")
 
     def load_scripts(self):
-        """
-        """
-        raise RedisClusterException(
-            "method load_scripts() is not implemented")
+        """ """
+        raise RedisClusterException("method load_scripts() is not implemented")
 
     def watch(self, *names):
-        """
-        """
+        """ """
         raise RedisClusterException("method watch() is not implemented")
 
     def unwatch(self):
-        """
-        """
+        """ """
         raise RedisClusterException("method unwatch() is not implemented")
 
     def script_load_for_pipeline(self, *args, **kwargs):
-        """
-        """
+        """ """
         raise RedisClusterException(
-            "method script_load_for_pipeline() is not implemented")
+            "method script_load_for_pipeline() is not implemented"
+        )
 
     def delete(self, *names):
         """
@@ -1913,10 +1936,10 @@ def delete(self, *names):
         """
         if len(names) != 1:
             raise RedisClusterException(
-                "deleting multiple keys is not "
-                "implemented in pipeline command")
+                "deleting multiple keys is not " "implemented in pipeline command"
+            )
 
-        return self.execute_command('DEL', names[0])
+        return self.execute_command("DEL", names[0])
 
 
 def block_pipeline_command(func):
@@ -1928,7 +1951,8 @@ def block_pipeline_command(func):
     def inner(*args, **kwargs):
         raise RedisClusterException(
             f"ERROR: Calling pipelined function {func.__name__} is blocked when "
-            f"running redis in cluster mode...")
+            f"running redis in cluster mode..."
+        )
 
     return inner
 
@@ -1936,11 +1960,9 @@ def inner(*args, **kwargs):
 # Blocked pipeline commands
 ClusterPipeline.bitop = block_pipeline_command(RedisCluster.bitop)
 ClusterPipeline.brpoplpush = block_pipeline_command(RedisCluster.brpoplpush)
-ClusterPipeline.client_getname = \
-    block_pipeline_command(RedisCluster.client_getname)
+ClusterPipeline.client_getname = block_pipeline_command(RedisCluster.client_getname)
 ClusterPipeline.client_list = block_pipeline_command(RedisCluster.client_list)
-ClusterPipeline.client_setname = \
-    block_pipeline_command(RedisCluster.client_setname)
+ClusterPipeline.client_setname = block_pipeline_command(RedisCluster.client_setname)
 ClusterPipeline.config_set = block_pipeline_command(RedisCluster.config_set)
 ClusterPipeline.dbsize = block_pipeline_command(RedisCluster.dbsize)
 ClusterPipeline.flushall = block_pipeline_command(RedisCluster.flushall)
@@ -1972,8 +1994,7 @@ def inner(*args, **kwargs):
 
 
 class PipelineCommand:
-    """
-    """
+    """ """
 
     def __init__(self, args, options=None, position=None):
         self.args = args
@@ -1987,20 +2008,17 @@ def __init__(self, args, options=None, position=None):
 
 
 class NodeCommands:
-    """
-    """
+    """ """
 
     def __init__(self, parse_response, connection_pool, connection):
-        """
-        """
+        """ """
         self.parse_response = parse_response
         self.connection_pool = connection_pool
         self.connection = connection
         self.commands = []
 
     def append(self, c):
-        """
-        """
+        """ """
         self.commands.append(c)
 
     def write(self):
@@ -2019,14 +2037,14 @@ def write(self):
         # send all the commands and catch connection and timeout errors.
         try:
             connection.send_packed_command(
-                connection.pack_commands([c.args for c in commands]))
+                connection.pack_commands([c.args for c in commands])
+            )
         except (ConnectionError, TimeoutError) as e:
             for c in commands:
                 c.result = e
 
     def read(self):
-        """
-        """
+        """ """
         connection = self.connection
         for c in self.commands:
 
@@ -2050,8 +2068,7 @@ def read(self):
             # explicitly open the connection and all will be well.
             if c.result is None:
                 try:
-                    c.result = self.parse_response(
-                        connection, c.args[0], **c.options)
+                    c.result = self.parse_response(connection, c.args[0], **c.options)
                 except (ConnectionError, TimeoutError) as e:
                     for c in self.commands:
                         c.result = e
diff --git a/redis/commands/__init__.py b/redis/commands/__init__.py
index a4728d0ac4..bc1e78c60c 100644
--- a/redis/commands/__init__.py
+++ b/redis/commands/__init__.py
@@ -6,10 +6,10 @@
 from .sentinel import SentinelCommands
 
 __all__ = [
-    'ClusterCommands',
-    'CommandsParser',
-    'CoreCommands',
-    'list_or_args',
-    'RedisModuleCommands',
-    'SentinelCommands'
+    "ClusterCommands",
+    "CommandsParser",
+    "CoreCommands",
+    "list_or_args",
+    "RedisModuleCommands",
+    "SentinelCommands",
 ]
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index e6b0a08924..0df073ab16 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -1,9 +1,6 @@
-from redis.exceptions import (
-    ConnectionError,
-    DataError,
-    RedisError,
-)
 from redis.crc import key_slot
+from redis.exceptions import ConnectionError, DataError, RedisError
+
 from .core import DataAccessCommands
 from .helpers import list_or_args
 
@@ -36,6 +33,7 @@ def mget_nonatomic(self, keys, *args):
         """
 
         from redis.client import EMPTY_RESPONSE
+
         options = {}
         if not args:
             options[EMPTY_RESPONSE] = []
@@ -50,8 +48,7 @@ def mget_nonatomic(self, keys, *args):
         # We must make sure that the keys are returned in order
         all_results = {}
         for slot_keys in slots_to_keys.values():
-            slot_values = self.execute_command(
-                'MGET', *slot_keys, **options)
+            slot_values = self.execute_command("MGET", *slot_keys, **options)
 
             slot_results = dict(zip(slot_keys, slot_values))
             all_results.update(slot_results)
@@ -83,7 +80,7 @@ def mset_nonatomic(self, mapping):
         # the results (one result per slot)
         res = []
         for pairs in slots_to_pairs.values():
-            res.append(self.execute_command('MSET', *pairs))
+            res.append(self.execute_command("MSET", *pairs))
 
         return res
 
@@ -108,7 +105,7 @@ def exists(self, *keys):
         whole cluster. The keys are first split up into slots
         and then an EXISTS command is sent for every slot
         """
-        return self._split_command_across_slots('EXISTS', *keys)
+        return self._split_command_across_slots("EXISTS", *keys)
 
     def delete(self, *keys):
         """
@@ -119,7 +116,7 @@ def delete(self, *keys):
         Non-existant keys are ignored.
         Returns the number of keys that were deleted.
         """
-        return self._split_command_across_slots('DEL', *keys)
+        return self._split_command_across_slots("DEL", *keys)
 
     def touch(self, *keys):
         """
@@ -132,7 +129,7 @@ def touch(self, *keys):
         Non-existant keys are ignored.
         Returns the number of keys that were touched.
         """
-        return self._split_command_across_slots('TOUCH', *keys)
+        return self._split_command_across_slots("TOUCH", *keys)
 
     def unlink(self, *keys):
         """
@@ -144,7 +141,7 @@ def unlink(self, *keys):
         Non-existant keys are ignored.
         Returns the number of keys that were unlinked.
         """
-        return self._split_command_across_slots('UNLINK', *keys)
+        return self._split_command_across_slots("UNLINK", *keys)
 
 
 class ClusterManagementCommands:
@@ -166,6 +163,7 @@ class ClusterManagementCommands:
         r.bgsave(target_nodes=primary)
         r.bgsave(target_nodes='primaries')
     """
+
     def bgsave(self, schedule=True, target_nodes=None):
         """
         Tell the Redis server to save its data to disk.  Unlike save(),
@@ -174,9 +172,7 @@ def bgsave(self, schedule=True, target_nodes=None):
         pieces = []
         if schedule:
             pieces.append("SCHEDULE")
-        return self.execute_command('BGSAVE',
-                                    *pieces,
-                                    target_nodes=target_nodes)
+        return self.execute_command("BGSAVE", *pieces, target_nodes=target_nodes)
 
     def client_getname(self, target_nodes=None):
         """
@@ -184,8 +180,7 @@ def client_getname(self, target_nodes=None):
         The result will be a dictionary with the IP and
         connection name.
         """
-        return self.execute_command('CLIENT GETNAME',
-                                    target_nodes=target_nodes)
+        return self.execute_command("CLIENT GETNAME", target_nodes=target_nodes)
 
     def client_getredir(self, target_nodes=None):
         """Returns the ID (an integer) of the client to whom we are
@@ -193,25 +188,29 @@ def client_getredir(self, target_nodes=None):
 
         see: https://redis.io/commands/client-getredir
         """
-        return self.execute_command('CLIENT GETREDIR',
-                                    target_nodes=target_nodes)
+        return self.execute_command("CLIENT GETREDIR", target_nodes=target_nodes)
 
     def client_id(self, target_nodes=None):
         """Returns the current connection id"""
-        return self.execute_command('CLIENT ID',
-                                    target_nodes=target_nodes)
+        return self.execute_command("CLIENT ID", target_nodes=target_nodes)
 
     def client_info(self, target_nodes=None):
         """
         Returns information and statistics about the current
         client connection.
         """
-        return self.execute_command('CLIENT INFO',
-                                    target_nodes=target_nodes)
+        return self.execute_command("CLIENT INFO", target_nodes=target_nodes)
 
-    def client_kill_filter(self, _id=None, _type=None, addr=None,
-                           skipme=None, laddr=None, user=None,
-                           target_nodes=None):
+    def client_kill_filter(
+        self,
+        _id=None,
+        _type=None,
+        addr=None,
+        skipme=None,
+        laddr=None,
+        user=None,
+        target_nodes=None,
+    ):
         """
         Disconnects client(s) using a variety of filter options
         :param id: Kills a client by its unique ID field
@@ -226,35 +225,35 @@ def client_kill_filter(self, _id=None, _type=None, addr=None,
         """
         args = []
         if _type is not None:
-            client_types = ('normal', 'master', 'slave', 'pubsub')
+            client_types = ("normal", "master", "slave", "pubsub")
             if str(_type).lower() not in client_types:
                 raise DataError(f"CLIENT KILL type must be one of {client_types!r}")
-            args.extend((b'TYPE', _type))
+            args.extend((b"TYPE", _type))
         if skipme is not None:
             if not isinstance(skipme, bool):
                 raise DataError("CLIENT KILL skipme must be a bool")
             if skipme:
-                args.extend((b'SKIPME', b'YES'))
+                args.extend((b"SKIPME", b"YES"))
             else:
-                args.extend((b'SKIPME', b'NO'))
+                args.extend((b"SKIPME", b"NO"))
         if _id is not None:
-            args.extend((b'ID', _id))
+            args.extend((b"ID", _id))
         if addr is not None:
-            args.extend((b'ADDR', addr))
+            args.extend((b"ADDR", addr))
         if laddr is not None:
-            args.extend((b'LADDR', laddr))
+            args.extend((b"LADDR", laddr))
         if user is not None:
-            args.extend((b'USER', user))
+            args.extend((b"USER", user))
         if not args:
-            raise DataError("CLIENT KILL <filter> <value> ... ... <filter> "
-                            "<value> must specify at least one filter")
-        return self.execute_command('CLIENT KILL', *args,
-                                    target_nodes=target_nodes)
+            raise DataError(
+                "CLIENT KILL <filter> <value> ... ... <filter> "
+                "<value> must specify at least one filter"
+            )
+        return self.execute_command("CLIENT KILL", *args, target_nodes=target_nodes)
 
     def client_kill(self, address, target_nodes=None):
         "Disconnects the client at ``address`` (ip:port)"
-        return self.execute_command('CLIENT KILL', address,
-                                    target_nodes=target_nodes)
+        return self.execute_command("CLIENT KILL", address, target_nodes=target_nodes)
 
     def client_list(self, _type=None, target_nodes=None):
         """
@@ -264,15 +263,13 @@ def client_list(self, _type=None, target_nodes=None):
          replica, pubsub)
         """
         if _type is not None:
-            client_types = ('normal', 'master', 'replica', 'pubsub')
+            client_types = ("normal", "master", "replica", "pubsub")
             if str(_type).lower() not in client_types:
                 raise DataError(f"CLIENT LIST _type must be one of {client_types!r}")
-            return self.execute_command('CLIENT LIST',
-                                        b'TYPE',
-                                        _type,
-                                        target_noes=target_nodes)
-        return self.execute_command('CLIENT LIST',
-                                    target_nodes=target_nodes)
+            return self.execute_command(
+                "CLIENT LIST", b"TYPE", _type, target_noes=target_nodes
+            )
+        return self.execute_command("CLIENT LIST", target_nodes=target_nodes)
 
     def client_pause(self, timeout, target_nodes=None):
         """
@@ -281,8 +278,9 @@ def client_pause(self, timeout, target_nodes=None):
         """
         if not isinstance(timeout, int):
             raise DataError("CLIENT PAUSE timeout must be an integer")
-        return self.execute_command('CLIENT PAUSE', str(timeout),
-                                    target_nodes=target_nodes)
+        return self.execute_command(
+            "CLIENT PAUSE", str(timeout), target_nodes=target_nodes
+        )
 
     def client_reply(self, reply, target_nodes=None):
         """Enable and disable redis server replies.
@@ -298,16 +296,14 @@ def client_reply(self, reply, target_nodes=None):
               conftest.py has a client with a timeout.
         See https://redis.io/commands/client-reply
         """
-        replies = ['ON', 'OFF', 'SKIP']
+        replies = ["ON", "OFF", "SKIP"]
         if reply not in replies:
-            raise DataError(f'CLIENT REPLY must be one of {replies!r}')
-        return self.execute_command("CLIENT REPLY", reply,
-                                    target_nodes=target_nodes)
+            raise DataError(f"CLIENT REPLY must be one of {replies!r}")
+        return self.execute_command("CLIENT REPLY", reply, target_nodes=target_nodes)
 
     def client_setname(self, name, target_nodes=None):
         "Sets the current connection name"
-        return self.execute_command('CLIENT SETNAME', name,
-                                    target_nodes=target_nodes)
+        return self.execute_command("CLIENT SETNAME", name, target_nodes=target_nodes)
 
     def client_trackinginfo(self, target_nodes=None):
         """
@@ -315,8 +311,7 @@ def client_trackinginfo(self, target_nodes=None):
         use of the server assisted client side cache.
         See https://redis.io/commands/client-trackinginfo
         """
-        return self.execute_command('CLIENT TRACKINGINFO',
-                                    target_nodes=target_nodes)
+        return self.execute_command("CLIENT TRACKINGINFO", target_nodes=target_nodes)
 
     def client_unblock(self, client_id, error=False, target_nodes=None):
         """
@@ -325,56 +320,50 @@ def client_unblock(self, client_id, error=False, target_nodes=None):
         If ``error`` is False (default), the client is unblocked using the
         regular timeout mechanism.
         """
-        args = ['CLIENT UNBLOCK', int(client_id)]
+        args = ["CLIENT UNBLOCK", int(client_id)]
         if error:
-            args.append(b'ERROR')
+            args.append(b"ERROR")
         return self.execute_command(*args, target_nodes=target_nodes)
 
     def client_unpause(self, target_nodes=None):
         """
         Unpause all redis clients
         """
-        return self.execute_command('CLIENT UNPAUSE',
-                                    target_nodes=target_nodes)
+        return self.execute_command("CLIENT UNPAUSE", target_nodes=target_nodes)
 
     def command(self, target_nodes=None):
         """
         Returns dict reply of details about all Redis commands.
         """
-        return self.execute_command('COMMAND', target_nodes=target_nodes)
+        return self.execute_command("COMMAND", target_nodes=target_nodes)
 
     def command_count(self, target_nodes=None):
         """
         Returns Integer reply of number of total commands in this Redis server.
         """
-        return self.execute_command('COMMAND COUNT', target_nodes=target_nodes)
+        return self.execute_command("COMMAND COUNT", target_nodes=target_nodes)
 
     def config_get(self, pattern="*", target_nodes=None):
         """
         Return a dictionary of configuration based on the ``pattern``
         """
-        return self.execute_command('CONFIG GET',
-                                    pattern,
-                                    target_nodes=target_nodes)
+        return self.execute_command("CONFIG GET", pattern, target_nodes=target_nodes)
 
     def config_resetstat(self, target_nodes=None):
         """Reset runtime statistics"""
-        return self.execute_command('CONFIG RESETSTAT',
-                                    target_nodes=target_nodes)
+        return self.execute_command("CONFIG RESETSTAT", target_nodes=target_nodes)
 
     def config_rewrite(self, target_nodes=None):
         """
         Rewrite config file with the minimal change to reflect running config.
         """
-        return self.execute_command('CONFIG REWRITE',
-                                    target_nodes=target_nodes)
+        return self.execute_command("CONFIG REWRITE", target_nodes=target_nodes)
 
     def config_set(self, name, value, target_nodes=None):
         "Set config item ``name`` with ``value``"
-        return self.execute_command('CONFIG SET',
-                                    name,
-                                    value,
-                                    target_nodes=target_nodes)
+        return self.execute_command(
+            "CONFIG SET", name, value, target_nodes=target_nodes
+        )
 
     def dbsize(self, target_nodes=None):
         """
@@ -383,8 +372,7 @@ def dbsize(self, target_nodes=None):
         :target_nodes: 'ClusterNode' or 'list(ClusterNodes)'
             The node/s to execute the command on
         """
-        return self.execute_command('DBSIZE',
-                                    target_nodes=target_nodes)
+        return self.execute_command("DBSIZE", target_nodes=target_nodes)
 
     def debug_object(self, key):
         raise NotImplementedError(
@@ -398,8 +386,7 @@ def debug_segfault(self):
 
     def echo(self, value, target_nodes):
         """Echo the string back from the server"""
-        return self.execute_command('ECHO', value,
-                                    target_nodes=target_nodes)
+        return self.execute_command("ECHO", value, target_nodes=target_nodes)
 
     def flushall(self, asynchronous=False, target_nodes=None):
         """
@@ -411,10 +398,8 @@ def flushall(self, asynchronous=False, target_nodes=None):
         """
         args = []
         if asynchronous:
-            args.append(b'ASYNC')
-        return self.execute_command('FLUSHALL',
-                                    *args,
-                                    target_nodes=target_nodes)
+            args.append(b"ASYNC")
+        return self.execute_command("FLUSHALL", *args, target_nodes=target_nodes)
 
     def flushdb(self, asynchronous=False, target_nodes=None):
         """
@@ -425,10 +410,8 @@ def flushdb(self, asynchronous=False, target_nodes=None):
         """
         args = []
         if asynchronous:
-            args.append(b'ASYNC')
-        return self.execute_command('FLUSHDB',
-                                    *args,
-                                    target_nodes=target_nodes)
+            args.append(b"ASYNC")
+        return self.execute_command("FLUSHDB", *args, target_nodes=target_nodes)
 
     def info(self, section=None, target_nodes=None):
         """
@@ -441,24 +424,20 @@ def info(self, section=None, target_nodes=None):
         and will generate ResponseError
         """
         if section is None:
-            return self.execute_command('INFO',
-                                        target_nodes=target_nodes)
+            return self.execute_command("INFO", target_nodes=target_nodes)
         else:
-            return self.execute_command('INFO',
-                                        section,
-                                        target_nodes=target_nodes)
+            return self.execute_command("INFO", section, target_nodes=target_nodes)
 
-    def keys(self, pattern='*', target_nodes=None):
+    def keys(self, pattern="*", target_nodes=None):
         "Returns a list of keys matching ``pattern``"
-        return self.execute_command('KEYS', pattern, target_nodes=target_nodes)
+        return self.execute_command("KEYS", pattern, target_nodes=target_nodes)
 
     def lastsave(self, target_nodes=None):
         """
         Return a Python datetime object representing the last time the
         Redis database was saved to disk
         """
-        return self.execute_command('LASTSAVE',
-                                    target_nodes=target_nodes)
+        return self.execute_command("LASTSAVE", target_nodes=target_nodes)
 
     def memory_doctor(self):
         raise NotImplementedError(
@@ -472,18 +451,15 @@ def memory_help(self):
 
     def memory_malloc_stats(self, target_nodes=None):
         """Return an internal statistics report from the memory allocator."""
-        return self.execute_command('MEMORY MALLOC-STATS',
-                                    target_nodes=target_nodes)
+        return self.execute_command("MEMORY MALLOC-STATS", target_nodes=target_nodes)
 
     def memory_purge(self, target_nodes=None):
         """Attempts to purge dirty pages for reclamation by allocator"""
-        return self.execute_command('MEMORY PURGE',
-                                    target_nodes=target_nodes)
+        return self.execute_command("MEMORY PURGE", target_nodes=target_nodes)
 
     def memory_stats(self, target_nodes=None):
         """Return a dictionary of memory stats"""
-        return self.execute_command('MEMORY STATS',
-                                    target_nodes=target_nodes)
+        return self.execute_command("MEMORY STATS", target_nodes=target_nodes)
 
     def memory_usage(self, key, samples=None):
         """
@@ -496,12 +472,12 @@ def memory_usage(self, key, samples=None):
         """
         args = []
         if isinstance(samples, int):
-            args.extend([b'SAMPLES', samples])
-        return self.execute_command('MEMORY USAGE', key, *args)
+            args.extend([b"SAMPLES", samples])
+        return self.execute_command("MEMORY USAGE", key, *args)
 
     def object(self, infotype, key):
         """Return the encoding, idletime, or refcount about the key"""
-        return self.execute_command('OBJECT', infotype, key, infotype=infotype)
+        return self.execute_command("OBJECT", infotype, key, infotype=infotype)
 
     def ping(self, target_nodes=None):
         """
@@ -509,24 +485,22 @@ def ping(self, target_nodes=None):
         If no target nodes are specified, sent to all nodes and returns True if
          the ping was successful across all nodes.
         """
-        return self.execute_command('PING',
-                                    target_nodes=target_nodes)
+        return self.execute_command("PING", target_nodes=target_nodes)
 
     def randomkey(self, target_nodes=None):
         """
         Returns the name of a random key"
         """
-        return self.execute_command('RANDOMKEY', target_nodes=target_nodes)
+        return self.execute_command("RANDOMKEY", target_nodes=target_nodes)
 
     def save(self, target_nodes=None):
         """
         Tell the Redis server to save its data to disk,
         blocking until the save is complete
         """
-        return self.execute_command('SAVE', target_nodes=target_nodes)
+        return self.execute_command("SAVE", target_nodes=target_nodes)
 
-    def scan(self, cursor=0, match=None, count=None, _type=None,
-             target_nodes=None):
+    def scan(self, cursor=0, match=None, count=None, _type=None, target_nodes=None):
         """
         Incrementally return lists of key names. Also return a cursor
         indicating the scan position.
@@ -543,12 +517,12 @@ def scan(self, cursor=0, match=None, count=None, _type=None,
         """
         pieces = [cursor]
         if match is not None:
-            pieces.extend([b'MATCH', match])
+            pieces.extend([b"MATCH", match])
         if count is not None:
-            pieces.extend([b'COUNT', count])
+            pieces.extend([b"COUNT", count])
         if _type is not None:
-            pieces.extend([b'TYPE', _type])
-        return self.execute_command('SCAN', *pieces, target_nodes=target_nodes)
+            pieces.extend([b"TYPE", _type])
+        return self.execute_command("SCAN", *pieces, target_nodes=target_nodes)
 
     def scan_iter(self, match=None, count=None, _type=None, target_nodes=None):
         """
@@ -565,11 +539,15 @@ def scan_iter(self, match=None, count=None, _type=None, target_nodes=None):
             HASH, LIST, SET, STREAM, STRING, ZSET
             Additionally, Redis modules can expose other types as well.
         """
-        cursor = '0'
+        cursor = "0"
         while cursor != 0:
-            cursor, data = self.scan(cursor=cursor, match=match,
-                                     count=count, _type=_type,
-                                     target_nodes=target_nodes)
+            cursor, data = self.scan(
+                cursor=cursor,
+                match=match,
+                count=count,
+                _type=_type,
+                target_nodes=target_nodes,
+            )
             yield from data
 
     def shutdown(self, save=False, nosave=False, target_nodes=None):
@@ -580,12 +558,12 @@ def shutdown(self, save=False, nosave=False, target_nodes=None):
         attempted.  The "save" and "nosave" options cannot both be set.
         """
         if save and nosave:
-            raise DataError('SHUTDOWN save and nosave cannot both be set')
-        args = ['SHUTDOWN']
+            raise DataError("SHUTDOWN save and nosave cannot both be set")
+        args = ["SHUTDOWN"]
         if save:
-            args.append('SAVE')
+            args.append("SAVE")
         if nosave:
-            args.append('NOSAVE')
+            args.append("NOSAVE")
         try:
             self.execute_command(*args, target_nodes=target_nodes)
         except ConnectionError:
@@ -598,26 +576,32 @@ def slowlog_get(self, num=None, target_nodes=None):
         Get the entries from the slowlog. If ``num`` is specified, get the
         most recent ``num`` items.
         """
-        args = ['SLOWLOG GET']
+        args = ["SLOWLOG GET"]
         if num is not None:
             args.append(num)
 
-        return self.execute_command(*args,
-                                    target_nodes=target_nodes)
+        return self.execute_command(*args, target_nodes=target_nodes)
 
     def slowlog_len(self, target_nodes=None):
         "Get the number of items in the slowlog"
-        return self.execute_command('SLOWLOG LEN',
-                                    target_nodes=target_nodes)
+        return self.execute_command("SLOWLOG LEN", target_nodes=target_nodes)
 
     def slowlog_reset(self, target_nodes=None):
         "Remove all items in the slowlog"
-        return self.execute_command('SLOWLOG RESET',
-                                    target_nodes=target_nodes)
-
-    def stralgo(self, algo, value1, value2, specific_argument='strings',
-                len=False, idx=False, minmatchlen=None, withmatchlen=False,
-                target_nodes=None):
+        return self.execute_command("SLOWLOG RESET", target_nodes=target_nodes)
+
+    def stralgo(
+        self,
+        algo,
+        value1,
+        value2,
+        specific_argument="strings",
+        len=False,
+        idx=False,
+        minmatchlen=None,
+        withmatchlen=False,
+        target_nodes=None,
+    ):
         """
         Implements complex algorithms that operate on strings.
         Right now the only algorithm implemented is the LCS algorithm
@@ -636,40 +620,45 @@ def stralgo(self, algo, value1, value2, specific_argument='strings',
         Can be provided only when ``idx`` set to True.
         """
         # check validity
-        supported_algo = ['LCS']
+        supported_algo = ["LCS"]
         if algo not in supported_algo:
-            supported_algos_str = ', '.join(supported_algo)
+            supported_algos_str = ", ".join(supported_algo)
             raise DataError(f"The supported algorithms are: {supported_algos_str}")
-        if specific_argument not in ['keys', 'strings']:
+        if specific_argument not in ["keys", "strings"]:
             raise DataError("specific_argument can be only keys or strings")
         if len and idx:
             raise DataError("len and idx cannot be provided together.")
 
         pieces = [algo, specific_argument.upper(), value1, value2]
         if len:
-            pieces.append(b'LEN')
+            pieces.append(b"LEN")
         if idx:
-            pieces.append(b'IDX')
+            pieces.append(b"IDX")
         try:
             int(minmatchlen)
-            pieces.extend([b'MINMATCHLEN', minmatchlen])
+            pieces.extend([b"MINMATCHLEN", minmatchlen])
         except TypeError:
             pass
         if withmatchlen:
-            pieces.append(b'WITHMATCHLEN')
-        if specific_argument == 'strings' and target_nodes is None:
-            target_nodes = 'default-node'
-        return self.execute_command('STRALGO', *pieces, len=len, idx=idx,
-                                    minmatchlen=minmatchlen,
-                                    withmatchlen=withmatchlen,
-                                    target_nodes=target_nodes)
+            pieces.append(b"WITHMATCHLEN")
+        if specific_argument == "strings" and target_nodes is None:
+            target_nodes = "default-node"
+        return self.execute_command(
+            "STRALGO",
+            *pieces,
+            len=len,
+            idx=idx,
+            minmatchlen=minmatchlen,
+            withmatchlen=withmatchlen,
+            target_nodes=target_nodes,
+        )
 
     def time(self, target_nodes=None):
         """
         Returns the server time as a 2-item tuple of ints:
         (seconds since epoch, microseconds into this second).
         """
-        return self.execute_command('TIME', target_nodes=target_nodes)
+        return self.execute_command("TIME", target_nodes=target_nodes)
 
     def wait(self, num_replicas, timeout, target_nodes=None):
         """
@@ -680,9 +669,9 @@ def wait(self, num_replicas, timeout, target_nodes=None):
 
         If more than one target node are passed the result will be summed up
         """
-        return self.execute_command('WAIT', num_replicas,
-                                    timeout,
-                                    target_nodes=target_nodes)
+        return self.execute_command(
+            "WAIT", num_replicas, timeout, target_nodes=target_nodes
+        )
 
 
 class ClusterPubSubCommands:
@@ -690,38 +679,44 @@ class ClusterPubSubCommands:
     Redis PubSub commands for RedisCluster use.
     see https://redis.io/topics/pubsub
     """
+
     def publish(self, channel, message, target_nodes=None):
         """
         Publish ``message`` on ``channel``.
         Returns the number of subscribers the message was delivered to.
         """
-        return self.execute_command('PUBLISH', channel, message,
-                                    target_nodes=target_nodes)
+        return self.execute_command(
+            "PUBLISH", channel, message, target_nodes=target_nodes
+        )
 
-    def pubsub_channels(self, pattern='*', target_nodes=None):
+    def pubsub_channels(self, pattern="*", target_nodes=None):
         """
         Return a list of channels that have at least one subscriber
         """
-        return self.execute_command('PUBSUB CHANNELS', pattern,
-                                    target_nodes=target_nodes)
+        return self.execute_command(
+            "PUBSUB CHANNELS", pattern, target_nodes=target_nodes
+        )
 
     def pubsub_numpat(self, target_nodes=None):
         """
         Returns the number of subscriptions to patterns
         """
-        return self.execute_command('PUBSUB NUMPAT', target_nodes=target_nodes)
+        return self.execute_command("PUBSUB NUMPAT", target_nodes=target_nodes)
 
     def pubsub_numsub(self, *args, target_nodes=None):
         """
         Return a list of (channel, number of subscribers) tuples
         for each channel given in ``*args``
         """
-        return self.execute_command('PUBSUB NUMSUB', *args,
-                                    target_nodes=target_nodes)
+        return self.execute_command("PUBSUB NUMSUB", *args, target_nodes=target_nodes)
 
 
-class ClusterCommands(ClusterManagementCommands, ClusterMultiKeyCommands,
-                      ClusterPubSubCommands, DataAccessCommands):
+class ClusterCommands(
+    ClusterManagementCommands,
+    ClusterMultiKeyCommands,
+    ClusterPubSubCommands,
+    DataAccessCommands,
+):
     """
     Redis Cluster commands
 
@@ -738,6 +733,7 @@ class ClusterCommands(ClusterManagementCommands, ClusterMultiKeyCommands,
     for example:
         r.cluster_info(target_nodes='all')
     """
+
     def cluster_addslots(self, target_node, *slots):
         """
         Assign new hash slots to receiving node. Sends to specified node.
@@ -745,22 +741,23 @@ def cluster_addslots(self, target_node, *slots):
         :target_node: 'ClusterNode'
             The node to execute the command on
         """
-        return self.execute_command('CLUSTER ADDSLOTS', *slots,
-                                    target_nodes=target_node)
+        return self.execute_command(
+            "CLUSTER ADDSLOTS", *slots, target_nodes=target_node
+        )
 
     def cluster_countkeysinslot(self, slot_id):
         """
         Return the number of local keys in the specified hash slot
         Send to node based on specified slot_id
         """
-        return self.execute_command('CLUSTER COUNTKEYSINSLOT', slot_id)
+        return self.execute_command("CLUSTER COUNTKEYSINSLOT", slot_id)
 
     def cluster_count_failure_report(self, node_id):
         """
         Return the number of failure reports active for a given node
         Sends to a random node
         """
-        return self.execute_command('CLUSTER COUNT-FAILURE-REPORTS', node_id)
+        return self.execute_command("CLUSTER COUNT-FAILURE-REPORTS", node_id)
 
     def cluster_delslots(self, *slots):
         """
@@ -769,10 +766,7 @@ def cluster_delslots(self, *slots):
 
         Returns a list of the results for each processed slot.
         """
-        return [
-            self.execute_command('CLUSTER DELSLOTS', slot)
-            for slot in slots
-        ]
+        return [self.execute_command("CLUSTER DELSLOTS", slot) for slot in slots]
 
     def cluster_failover(self, target_node, option=None):
         """
@@ -783,15 +777,16 @@ def cluster_failover(self, target_node, option=None):
             The node to execute the command on
         """
         if option:
-            if option.upper() not in ['FORCE', 'TAKEOVER']:
+            if option.upper() not in ["FORCE", "TAKEOVER"]:
                 raise RedisError(
-                    f'Invalid option for CLUSTER FAILOVER command: {option}')
+                    f"Invalid option for CLUSTER FAILOVER command: {option}"
+                )
             else:
-                return self.execute_command('CLUSTER FAILOVER', option,
-                                            target_nodes=target_node)
+                return self.execute_command(
+                    "CLUSTER FAILOVER", option, target_nodes=target_node
+                )
         else:
-            return self.execute_command('CLUSTER FAILOVER',
-                                        target_nodes=target_node)
+            return self.execute_command("CLUSTER FAILOVER", target_nodes=target_node)
 
     def cluster_info(self, target_nodes=None):
         """
@@ -799,22 +794,23 @@ def cluster_info(self, target_nodes=None):
         The command will be sent to a random node in the cluster if no target
         node is specified.
         """
-        return self.execute_command('CLUSTER INFO', target_nodes=target_nodes)
+        return self.execute_command("CLUSTER INFO", target_nodes=target_nodes)
 
     def cluster_keyslot(self, key):
         """
         Returns the hash slot of the specified key
         Sends to random node in the cluster
         """
-        return self.execute_command('CLUSTER KEYSLOT', key)
+        return self.execute_command("CLUSTER KEYSLOT", key)
 
     def cluster_meet(self, host, port, target_nodes=None):
         """
         Force a node cluster to handshake with another node.
         Sends to specified node.
         """
-        return self.execute_command('CLUSTER MEET', host, port,
-                                    target_nodes=target_nodes)
+        return self.execute_command(
+            "CLUSTER MEET", host, port, target_nodes=target_nodes
+        )
 
     def cluster_nodes(self):
         """
@@ -822,14 +818,15 @@ def cluster_nodes(self):
 
         Sends to random node in the cluster
         """
-        return self.execute_command('CLUSTER NODES')
+        return self.execute_command("CLUSTER NODES")
 
     def cluster_replicate(self, target_nodes, node_id):
         """
         Reconfigure a node as a slave of the specified master node
         """
-        return self.execute_command('CLUSTER REPLICATE', node_id,
-                                    target_nodes=target_nodes)
+        return self.execute_command(
+            "CLUSTER REPLICATE", node_id, target_nodes=target_nodes
+        )
 
     def cluster_reset(self, soft=True, target_nodes=None):
         """
@@ -838,29 +835,29 @@ def cluster_reset(self, soft=True, target_nodes=None):
         If 'soft' is True then it will send 'SOFT' argument
         If 'soft' is False then it will send 'HARD' argument
         """
-        return self.execute_command('CLUSTER RESET',
-                                    b'SOFT' if soft else b'HARD',
-                                    target_nodes=target_nodes)
+        return self.execute_command(
+            "CLUSTER RESET", b"SOFT" if soft else b"HARD", target_nodes=target_nodes
+        )
 
     def cluster_save_config(self, target_nodes=None):
         """
         Forces the node to save cluster state on disk
         """
-        return self.execute_command('CLUSTER SAVECONFIG',
-                                    target_nodes=target_nodes)
+        return self.execute_command("CLUSTER SAVECONFIG", target_nodes=target_nodes)
 
     def cluster_get_keys_in_slot(self, slot, num_keys):
         """
         Returns the number of keys in the specified cluster slot
         """
-        return self.execute_command('CLUSTER GETKEYSINSLOT', slot, num_keys)
+        return self.execute_command("CLUSTER GETKEYSINSLOT", slot, num_keys)
 
     def cluster_set_config_epoch(self, epoch, target_nodes=None):
         """
         Set the configuration epoch in a new node
         """
-        return self.execute_command('CLUSTER SET-CONFIG-EPOCH', epoch,
-                                    target_nodes=target_nodes)
+        return self.execute_command(
+            "CLUSTER SET-CONFIG-EPOCH", epoch, target_nodes=target_nodes
+        )
 
     def cluster_setslot(self, target_node, node_id, slot_id, state):
         """
@@ -869,47 +866,48 @@ def cluster_setslot(self, target_node, node_id, slot_id, state):
         :target_node: 'ClusterNode'
             The node to execute the command on
         """
-        if state.upper() in ('IMPORTING', 'NODE', 'MIGRATING'):
-            return self.execute_command('CLUSTER SETSLOT', slot_id, state,
-                                        node_id, target_nodes=target_node)
-        elif state.upper() == 'STABLE':
-            raise RedisError('For "stable" state please use '
-                             'cluster_setslot_stable')
+        if state.upper() in ("IMPORTING", "NODE", "MIGRATING"):
+            return self.execute_command(
+                "CLUSTER SETSLOT", slot_id, state, node_id, target_nodes=target_node
+            )
+        elif state.upper() == "STABLE":
+            raise RedisError('For "stable" state please use ' "cluster_setslot_stable")
         else:
-            raise RedisError(f'Invalid slot state: {state}')
+            raise RedisError(f"Invalid slot state: {state}")
 
     def cluster_setslot_stable(self, slot_id):
         """
         Clears migrating / importing state from the slot.
         It determines by it self what node the slot is in and sends it there.
         """
-        return self.execute_command('CLUSTER SETSLOT', slot_id, 'STABLE')
+        return self.execute_command("CLUSTER SETSLOT", slot_id, "STABLE")
 
     def cluster_replicas(self, node_id, target_nodes=None):
         """
         Provides a list of replica nodes replicating from the specified primary
         target node.
         """
-        return self.execute_command('CLUSTER REPLICAS', node_id,
-                                    target_nodes=target_nodes)
+        return self.execute_command(
+            "CLUSTER REPLICAS", node_id, target_nodes=target_nodes
+        )
 
     def cluster_slots(self, target_nodes=None):
         """
         Get array of Cluster slot to node mappings
         """
-        return self.execute_command('CLUSTER SLOTS', target_nodes=target_nodes)
+        return self.execute_command("CLUSTER SLOTS", target_nodes=target_nodes)
 
     def readonly(self, target_nodes=None):
         """
         Enables read queries.
         The command will be sent to the default cluster node if target_nodes is
         not specified.
-         """
-        if target_nodes == 'replicas' or target_nodes == 'all':
+        """
+        if target_nodes == "replicas" or target_nodes == "all":
             # read_from_replicas will only be enabled if the READONLY command
             # is sent to all replicas
             self.read_from_replicas = True
-        return self.execute_command('READONLY', target_nodes=target_nodes)
+        return self.execute_command("READONLY", target_nodes=target_nodes)
 
     def readwrite(self, target_nodes=None):
         """
@@ -919,4 +917,4 @@ def readwrite(self, target_nodes=None):
         """
         # Reset read from replicas flag
         self.read_from_replicas = False
-        return self.execute_command('READWRITE', target_nodes=target_nodes)
+        return self.execute_command("READWRITE", target_nodes=target_nodes)
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 0285f80e0f..688e1dda1b 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1,15 +1,11 @@
 import datetime
+import hashlib
 import time
 import warnings
-import hashlib
+
+from redis.exceptions import ConnectionError, DataError, NoScriptError, RedisError
 
 from .helpers import list_or_args
-from redis.exceptions import (
-    ConnectionError,
-    DataError,
-    NoScriptError,
-    RedisError,
-)
 
 
 class ACLCommands:
@@ -17,6 +13,7 @@ class ACLCommands:
     Redis Access Control List (ACL) commands.
     see: https://redis.io/topics/acl
     """
+
     def acl_cat(self, category=None):
         """
         Returns a list of categories or commands within a category.
@@ -28,7 +25,7 @@ def acl_cat(self, category=None):
         For more information check https://redis.io/commands/acl-cat
         """
         pieces = [category] if category else []
-        return self.execute_command('ACL CAT', *pieces)
+        return self.execute_command("ACL CAT", *pieces)
 
     def acl_deluser(self, *username):
         """
@@ -36,7 +33,7 @@ def acl_deluser(self, *username):
 
         For more information check https://redis.io/commands/acl-deluser
         """
-        return self.execute_command('ACL DELUSER', *username)
+        return self.execute_command("ACL DELUSER", *username)
 
     def acl_genpass(self, bits=None):
         """Generate a random password value.
@@ -51,9 +48,10 @@ def acl_genpass(self, bits=None):
                 if b < 0 or b > 4096:
                     raise ValueError
             except ValueError:
-                raise DataError('genpass optionally accepts a bits argument, '
-                                'between 0 and 4096.')
-        return self.execute_command('ACL GENPASS', *pieces)
+                raise DataError(
+                    "genpass optionally accepts a bits argument, " "between 0 and 4096."
+                )
+        return self.execute_command("ACL GENPASS", *pieces)
 
     def acl_getuser(self, username):
         """
@@ -63,7 +61,7 @@ def acl_getuser(self, username):
 
         For more information check https://redis.io/commands/acl-getuser
         """
-        return self.execute_command('ACL GETUSER', username)
+        return self.execute_command("ACL GETUSER", username)
 
     def acl_help(self):
         """The ACL HELP command returns helpful text describing
@@ -71,7 +69,7 @@ def acl_help(self):
 
         For more information check https://redis.io/commands/acl-help
         """
-        return self.execute_command('ACL HELP')
+        return self.execute_command("ACL HELP")
 
     def acl_list(self):
         """
@@ -79,7 +77,7 @@ def acl_list(self):
 
         For more information check https://redis.io/commands/acl-list
         """
-        return self.execute_command('ACL LIST')
+        return self.execute_command("ACL LIST")
 
     def acl_log(self, count=None):
         """
@@ -92,11 +90,10 @@ def acl_log(self, count=None):
         args = []
         if count is not None:
             if not isinstance(count, int):
-                raise DataError('ACL LOG count must be an '
-                                'integer')
+                raise DataError("ACL LOG count must be an " "integer")
             args.append(count)
 
-        return self.execute_command('ACL LOG', *args)
+        return self.execute_command("ACL LOG", *args)
 
     def acl_log_reset(self):
         """
@@ -105,8 +102,8 @@ def acl_log_reset(self):
 
         For more information check https://redis.io/commands/acl-log
         """
-        args = [b'RESET']
-        return self.execute_command('ACL LOG', *args)
+        args = [b"RESET"]
+        return self.execute_command("ACL LOG", *args)
 
     def acl_load(self):
         """
@@ -117,7 +114,7 @@ def acl_load(self):
 
         For more information check https://redis.io/commands/acl-load
         """
-        return self.execute_command('ACL LOAD')
+        return self.execute_command("ACL LOAD")
 
     def acl_save(self):
         """
@@ -128,12 +125,22 @@ def acl_save(self):
 
         For more information check https://redis.io/commands/acl-save
         """
-        return self.execute_command('ACL SAVE')
-
-    def acl_setuser(self, username, enabled=False, nopass=False,
-                    passwords=None, hashed_passwords=None, categories=None,
-                    commands=None, keys=None, reset=False, reset_keys=False,
-                    reset_passwords=False):
+        return self.execute_command("ACL SAVE")
+
+    def acl_setuser(
+        self,
+        username,
+        enabled=False,
+        nopass=False,
+        passwords=None,
+        hashed_passwords=None,
+        categories=None,
+        commands=None,
+        keys=None,
+        reset=False,
+        reset_keys=False,
+        reset_passwords=False,
+    ):
         """
         Create or update an ACL user.
 
@@ -199,22 +206,23 @@ def acl_setuser(self, username, enabled=False, nopass=False,
         pieces = [username]
 
         if reset:
-            pieces.append(b'reset')
+            pieces.append(b"reset")
 
         if reset_keys:
-            pieces.append(b'resetkeys')
+            pieces.append(b"resetkeys")
 
         if reset_passwords:
-            pieces.append(b'resetpass')
+            pieces.append(b"resetpass")
 
         if enabled:
-            pieces.append(b'on')
+            pieces.append(b"on")
         else:
-            pieces.append(b'off')
+            pieces.append(b"off")
 
         if (passwords or hashed_passwords) and nopass:
-            raise DataError('Cannot set \'nopass\' and supply '
-                            '\'passwords\' or \'hashed_passwords\'')
+            raise DataError(
+                "Cannot set 'nopass' and supply " "'passwords' or 'hashed_passwords'"
+            )
 
         if passwords:
             # as most users will have only one password, allow remove_passwords
@@ -222,13 +230,15 @@ def acl_setuser(self, username, enabled=False, nopass=False,
             passwords = list_or_args(passwords, [])
             for i, password in enumerate(passwords):
                 password = encoder.encode(password)
-                if password.startswith(b'+'):
-                    pieces.append(b'>%s' % password[1:])
-                elif password.startswith(b'-'):
-                    pieces.append(b'<%s' % password[1:])
+                if password.startswith(b"+"):
+                    pieces.append(b">%s" % password[1:])
+                elif password.startswith(b"-"):
+                    pieces.append(b"<%s" % password[1:])
                 else:
-                    raise DataError(f'Password {i} must be prefixed with a '
-                                    f'"+" to add or a "-" to remove')
+                    raise DataError(
+                        f"Password {i} must be prefixed with a "
+                        f'"+" to add or a "-" to remove'
+                    )
 
         if hashed_passwords:
             # as most users will have only one password, allow remove_passwords
@@ -236,29 +246,31 @@ def acl_setuser(self, username, enabled=False, nopass=False,
             hashed_passwords = list_or_args(hashed_passwords, [])
             for i, hashed_password in enumerate(hashed_passwords):
                 hashed_password = encoder.encode(hashed_password)
-                if hashed_password.startswith(b'+'):
-                    pieces.append(b'#%s' % hashed_password[1:])
-                elif hashed_password.startswith(b'-'):
-                    pieces.append(b'!%s' % hashed_password[1:])
+                if hashed_password.startswith(b"+"):
+                    pieces.append(b"#%s" % hashed_password[1:])
+                elif hashed_password.startswith(b"-"):
+                    pieces.append(b"!%s" % hashed_password[1:])
                 else:
-                    raise DataError(f'Hashed password {i} must be prefixed with a '
-                                    f'"+" to add or a "-" to remove')
+                    raise DataError(
+                        f"Hashed password {i} must be prefixed with a "
+                        f'"+" to add or a "-" to remove'
+                    )
 
         if nopass:
-            pieces.append(b'nopass')
+            pieces.append(b"nopass")
 
         if categories:
             for category in categories:
                 category = encoder.encode(category)
                 # categories can be prefixed with one of (+@, +, -@, -)
-                if category.startswith(b'+@'):
+                if category.startswith(b"+@"):
                     pieces.append(category)
-                elif category.startswith(b'+'):
-                    pieces.append(b'+@%s' % category[1:])
-                elif category.startswith(b'-@'):
+                elif category.startswith(b"+"):
+                    pieces.append(b"+@%s" % category[1:])
+                elif category.startswith(b"-@"):
                     pieces.append(category)
-                elif category.startswith(b'-'):
-                    pieces.append(b'-@%s' % category[1:])
+                elif category.startswith(b"-"):
+                    pieces.append(b"-@%s" % category[1:])
                 else:
                     raise DataError(
                         f'Category "{encoder.decode(category, force=True)}" '
@@ -267,7 +279,7 @@ def acl_setuser(self, username, enabled=False, nopass=False,
         if commands:
             for cmd in commands:
                 cmd = encoder.encode(cmd)
-                if not cmd.startswith(b'+') and not cmd.startswith(b'-'):
+                if not cmd.startswith(b"+") and not cmd.startswith(b"-"):
                     raise DataError(
                         f'Command "{encoder.decode(cmd, force=True)}" '
                         'must be prefixed with "+" or "-"'
@@ -277,35 +289,36 @@ def acl_setuser(self, username, enabled=False, nopass=False,
         if keys:
             for key in keys:
                 key = encoder.encode(key)
-                pieces.append(b'~%s' % key)
+                pieces.append(b"~%s" % key)
 
-        return self.execute_command('ACL SETUSER', *pieces)
+        return self.execute_command("ACL SETUSER", *pieces)
 
     def acl_users(self):
         """Returns a list of all registered users on the server.
 
         For more information check https://redis.io/commands/acl-users
         """
-        return self.execute_command('ACL USERS')
+        return self.execute_command("ACL USERS")
 
     def acl_whoami(self):
         """Get the username for the current connection
 
         For more information check https://redis.io/commands/acl-whoami
         """
-        return self.execute_command('ACL WHOAMI')
+        return self.execute_command("ACL WHOAMI")
 
 
 class ManagementCommands:
     """
     Redis management commands
     """
+
     def bgrewriteaof(self):
         """Tell the Redis server to rewrite the AOF file from data in memory.
 
         For more information check https://redis.io/commands/bgrewriteaof
         """
-        return self.execute_command('BGREWRITEAOF')
+        return self.execute_command("BGREWRITEAOF")
 
     def bgsave(self, schedule=True):
         """
@@ -317,17 +330,18 @@ def bgsave(self, schedule=True):
         pieces = []
         if schedule:
             pieces.append("SCHEDULE")
-        return self.execute_command('BGSAVE', *pieces)
+        return self.execute_command("BGSAVE", *pieces)
 
     def client_kill(self, address):
         """Disconnects the client at ``address`` (ip:port)
 
         For more information check https://redis.io/commands/client-kill
         """
-        return self.execute_command('CLIENT KILL', address)
+        return self.execute_command("CLIENT KILL", address)
 
-    def client_kill_filter(self, _id=None, _type=None, addr=None,
-                           skipme=None, laddr=None, user=None):
+    def client_kill_filter(
+        self, _id=None, _type=None, addr=None, skipme=None, laddr=None, user=None
+    ):
         """
         Disconnects client(s) using a variety of filter options
         :param id: Kills a client by its unique ID field
@@ -342,29 +356,31 @@ def client_kill_filter(self, _id=None, _type=None, addr=None,
         """
         args = []
         if _type is not None:
-            client_types = ('normal', 'master', 'slave', 'pubsub')
+            client_types = ("normal", "master", "slave", "pubsub")
             if str(_type).lower() not in client_types:
                 raise DataError(f"CLIENT KILL type must be one of {client_types!r}")
-            args.extend((b'TYPE', _type))
+            args.extend((b"TYPE", _type))
         if skipme is not None:
             if not isinstance(skipme, bool):
                 raise DataError("CLIENT KILL skipme must be a bool")
             if skipme:
-                args.extend((b'SKIPME', b'YES'))
+                args.extend((b"SKIPME", b"YES"))
             else:
-                args.extend((b'SKIPME', b'NO'))
+                args.extend((b"SKIPME", b"NO"))
         if _id is not None:
-            args.extend((b'ID', _id))
+            args.extend((b"ID", _id))
         if addr is not None:
-            args.extend((b'ADDR', addr))
+            args.extend((b"ADDR", addr))
         if laddr is not None:
-            args.extend((b'LADDR', laddr))
+            args.extend((b"LADDR", laddr))
         if user is not None:
-            args.extend((b'USER', user))
+            args.extend((b"USER", user))
         if not args:
-            raise DataError("CLIENT KILL <filter> <value> ... ... <filter> "
-                            "<value> must specify at least one filter")
-        return self.execute_command('CLIENT KILL', *args)
+            raise DataError(
+                "CLIENT KILL <filter> <value> ... ... <filter> "
+                "<value> must specify at least one filter"
+            )
+        return self.execute_command("CLIENT KILL", *args)
 
     def client_info(self):
         """
@@ -373,7 +389,7 @@ def client_info(self):
 
         For more information check https://redis.io/commands/client-info
         """
-        return self.execute_command('CLIENT INFO')
+        return self.execute_command("CLIENT INFO")
 
     def client_list(self, _type=None, client_id=[]):
         """
@@ -387,17 +403,17 @@ def client_list(self, _type=None, client_id=[]):
         """
         args = []
         if _type is not None:
-            client_types = ('normal', 'master', 'replica', 'pubsub')
+            client_types = ("normal", "master", "replica", "pubsub")
             if str(_type).lower() not in client_types:
                 raise DataError(f"CLIENT LIST _type must be one of {client_types!r}")
-            args.append(b'TYPE')
+            args.append(b"TYPE")
             args.append(_type)
         if not isinstance(client_id, list):
             raise DataError("client_id must be a list")
         if client_id != []:
             args.append(b"ID")
-            args.append(' '.join(client_id))
-        return self.execute_command('CLIENT LIST', *args)
+            args.append(" ".join(client_id))
+        return self.execute_command("CLIENT LIST", *args)
 
     def client_getname(self):
         """
@@ -405,7 +421,7 @@ def client_getname(self):
 
         For more information check https://redis.io/commands/client-getname
         """
-        return self.execute_command('CLIENT GETNAME')
+        return self.execute_command("CLIENT GETNAME")
 
     def client_getredir(self):
         """
@@ -414,7 +430,7 @@ def client_getredir(self):
 
         see: https://redis.io/commands/client-getredir
         """
-        return self.execute_command('CLIENT GETREDIR')
+        return self.execute_command("CLIENT GETREDIR")
 
     def client_reply(self, reply):
         """
@@ -432,9 +448,9 @@ def client_reply(self, reply):
 
         See https://redis.io/commands/client-reply
         """
-        replies = ['ON', 'OFF', 'SKIP']
+        replies = ["ON", "OFF", "SKIP"]
         if reply not in replies:
-            raise DataError(f'CLIENT REPLY must be one of {replies!r}')
+            raise DataError(f"CLIENT REPLY must be one of {replies!r}")
         return self.execute_command("CLIENT REPLY", reply)
 
     def client_id(self):
@@ -443,7 +459,7 @@ def client_id(self):
 
         For more information check https://redis.io/commands/client-id
         """
-        return self.execute_command('CLIENT ID')
+        return self.execute_command("CLIENT ID")
 
     def client_trackinginfo(self):
         """
@@ -452,7 +468,7 @@ def client_trackinginfo(self):
 
         See https://redis.io/commands/client-trackinginfo
         """
-        return self.execute_command('CLIENT TRACKINGINFO')
+        return self.execute_command("CLIENT TRACKINGINFO")
 
     def client_setname(self, name):
         """
@@ -460,7 +476,7 @@ def client_setname(self, name):
 
         For more information check https://redis.io/commands/client-setname
         """
-        return self.execute_command('CLIENT SETNAME', name)
+        return self.execute_command("CLIENT SETNAME", name)
 
     def client_unblock(self, client_id, error=False):
         """
@@ -471,9 +487,9 @@ def client_unblock(self, client_id, error=False):
 
         For more information check https://redis.io/commands/client-unblock
         """
-        args = ['CLIENT UNBLOCK', int(client_id)]
+        args = ["CLIENT UNBLOCK", int(client_id)]
         if error:
-            args.append(b'ERROR')
+            args.append(b"ERROR")
         return self.execute_command(*args)
 
     def client_pause(self, timeout):
@@ -485,7 +501,7 @@ def client_pause(self, timeout):
         """
         if not isinstance(timeout, int):
             raise DataError("CLIENT PAUSE timeout must be an integer")
-        return self.execute_command('CLIENT PAUSE', str(timeout))
+        return self.execute_command("CLIENT PAUSE", str(timeout))
 
     def client_unpause(self):
         """
@@ -493,7 +509,7 @@ def client_unpause(self):
 
         For more information check https://redis.io/commands/client-unpause
         """
-        return self.execute_command('CLIENT UNPAUSE')
+        return self.execute_command("CLIENT UNPAUSE")
 
     def command_info(self):
         raise NotImplementedError(
@@ -501,7 +517,7 @@ def command_info(self):
         )
 
     def command_count(self):
-        return self.execute_command('COMMAND COUNT')
+        return self.execute_command("COMMAND COUNT")
 
     def readwrite(self):
         """
@@ -509,7 +525,7 @@ def readwrite(self):
 
         For more information check https://redis.io/commands/readwrite
         """
-        return self.execute_command('READWRITE')
+        return self.execute_command("READWRITE")
 
     def readonly(self):
         """
@@ -517,7 +533,7 @@ def readonly(self):
 
         For more information check https://redis.io/commands/readonly
         """
-        return self.execute_command('READONLY')
+        return self.execute_command("READONLY")
 
     def config_get(self, pattern="*"):
         """
@@ -525,14 +541,14 @@ def config_get(self, pattern="*"):
 
         For more information check https://redis.io/commands/config-get
         """
-        return self.execute_command('CONFIG GET', pattern)
+        return self.execute_command("CONFIG GET", pattern)
 
     def config_set(self, name, value):
         """Set config item ``name`` with ``value``
 
         For more information check https://redis.io/commands/config-set
         """
-        return self.execute_command('CONFIG SET', name, value)
+        return self.execute_command("CONFIG SET", name, value)
 
     def config_resetstat(self):
         """
@@ -540,7 +556,7 @@ def config_resetstat(self):
 
         For more information check https://redis.io/commands/config-resetstat
         """
-        return self.execute_command('CONFIG RESETSTAT')
+        return self.execute_command("CONFIG RESETSTAT")
 
     def config_rewrite(self):
         """
@@ -548,10 +564,10 @@ def config_rewrite(self):
 
         For more information check https://redis.io/commands/config-rewrite
         """
-        return self.execute_command('CONFIG REWRITE')
+        return self.execute_command("CONFIG REWRITE")
 
     def cluster(self, cluster_arg, *args):
-        return self.execute_command(f'CLUSTER {cluster_arg.upper()}', *args)
+        return self.execute_command(f"CLUSTER {cluster_arg.upper()}", *args)
 
     def dbsize(self):
         """
@@ -559,7 +575,7 @@ def dbsize(self):
 
         For more information check https://redis.io/commands/dbsize
         """
-        return self.execute_command('DBSIZE')
+        return self.execute_command("DBSIZE")
 
     def debug_object(self, key):
         """
@@ -567,7 +583,7 @@ def debug_object(self, key):
 
         For more information check https://redis.io/commands/debug-object
         """
-        return self.execute_command('DEBUG OBJECT', key)
+        return self.execute_command("DEBUG OBJECT", key)
 
     def debug_segfault(self):
         raise NotImplementedError(
@@ -584,7 +600,7 @@ def echo(self, value):
 
         For more information check https://redis.io/commands/echo
         """
-        return self.execute_command('ECHO', value)
+        return self.execute_command("ECHO", value)
 
     def flushall(self, asynchronous=False):
         """
@@ -597,8 +613,8 @@ def flushall(self, asynchronous=False):
         """
         args = []
         if asynchronous:
-            args.append(b'ASYNC')
-        return self.execute_command('FLUSHALL', *args)
+            args.append(b"ASYNC")
+        return self.execute_command("FLUSHALL", *args)
 
     def flushdb(self, asynchronous=False):
         """
@@ -611,8 +627,8 @@ def flushdb(self, asynchronous=False):
         """
         args = []
         if asynchronous:
-            args.append(b'ASYNC')
-        return self.execute_command('FLUSHDB', *args)
+            args.append(b"ASYNC")
+        return self.execute_command("FLUSHDB", *args)
 
     def swapdb(self, first, second):
         """
@@ -620,7 +636,7 @@ def swapdb(self, first, second):
 
         For more information check https://redis.io/commands/swapdb
         """
-        return self.execute_command('SWAPDB', first, second)
+        return self.execute_command("SWAPDB", first, second)
 
     def info(self, section=None):
         """
@@ -635,9 +651,9 @@ def info(self, section=None):
         For more information check https://redis.io/commands/info
         """
         if section is None:
-            return self.execute_command('INFO')
+            return self.execute_command("INFO")
         else:
-            return self.execute_command('INFO', section)
+            return self.execute_command("INFO", section)
 
     def lastsave(self):
         """
@@ -646,7 +662,7 @@ def lastsave(self):
 
         For more information check https://redis.io/commands/lastsave
         """
-        return self.execute_command('LASTSAVE')
+        return self.execute_command("LASTSAVE")
 
     def lolwut(self, *version_numbers):
         """
@@ -655,12 +671,21 @@ def lolwut(self, *version_numbers):
         See: https://redis.io/commands/lolwut
         """
         if version_numbers:
-            return self.execute_command('LOLWUT VERSION', *version_numbers)
+            return self.execute_command("LOLWUT VERSION", *version_numbers)
         else:
-            return self.execute_command('LOLWUT')
-
-    def migrate(self, host, port, keys, destination_db, timeout,
-                copy=False, replace=False, auth=None):
+            return self.execute_command("LOLWUT")
+
+    def migrate(
+        self,
+        host,
+        port,
+        keys,
+        destination_db,
+        timeout,
+        copy=False,
+        replace=False,
+        auth=None,
+    ):
         """
         Migrate 1 or more keys from the current Redis server to a different
         server specified by the ``host``, ``port`` and ``destination_db``.
@@ -682,25 +707,26 @@ def migrate(self, host, port, keys, destination_db, timeout,
         """
         keys = list_or_args(keys, [])
         if not keys:
-            raise DataError('MIGRATE requires at least one key')
+            raise DataError("MIGRATE requires at least one key")
         pieces = []
         if copy:
-            pieces.append(b'COPY')
+            pieces.append(b"COPY")
         if replace:
-            pieces.append(b'REPLACE')
+            pieces.append(b"REPLACE")
         if auth:
-            pieces.append(b'AUTH')
+            pieces.append(b"AUTH")
             pieces.append(auth)
-        pieces.append(b'KEYS')
+        pieces.append(b"KEYS")
         pieces.extend(keys)
-        return self.execute_command('MIGRATE', host, port, '', destination_db,
-                                    timeout, *pieces)
+        return self.execute_command(
+            "MIGRATE", host, port, "", destination_db, timeout, *pieces
+        )
 
     def object(self, infotype, key):
         """
         Return the encoding, idletime, or refcount about the key
         """
-        return self.execute_command('OBJECT', infotype, key, infotype=infotype)
+        return self.execute_command("OBJECT", infotype, key, infotype=infotype)
 
     def memory_doctor(self):
         raise NotImplementedError(
@@ -726,7 +752,7 @@ def memory_stats(self):
 
         For more information check https://redis.io/commands/memory-stats
         """
-        return self.execute_command('MEMORY STATS')
+        return self.execute_command("MEMORY STATS")
 
     def memory_malloc_stats(self):
         """
@@ -734,7 +760,7 @@ def memory_malloc_stats(self):
 
         See: https://redis.io/commands/memory-malloc-stats
         """
-        return self.execute_command('MEMORY MALLOC-STATS')
+        return self.execute_command("MEMORY MALLOC-STATS")
 
     def memory_usage(self, key, samples=None):
         """
@@ -749,8 +775,8 @@ def memory_usage(self, key, samples=None):
         """
         args = []
         if isinstance(samples, int):
-            args.extend([b'SAMPLES', samples])
-        return self.execute_command('MEMORY USAGE', key, *args)
+            args.extend([b"SAMPLES", samples])
+        return self.execute_command("MEMORY USAGE", key, *args)
 
     def memory_purge(self):
         """
@@ -758,7 +784,7 @@ def memory_purge(self):
 
         For more information check https://redis.io/commands/memory-purge
         """
-        return self.execute_command('MEMORY PURGE')
+        return self.execute_command("MEMORY PURGE")
 
     def ping(self):
         """
@@ -766,7 +792,7 @@ def ping(self):
 
         For more information check https://redis.io/commands/ping
         """
-        return self.execute_command('PING')
+        return self.execute_command("PING")
 
     def quit(self):
         """
@@ -774,7 +800,7 @@ def quit(self):
 
         For more information check https://redis.io/commands/quit
         """
-        return self.execute_command('QUIT')
+        return self.execute_command("QUIT")
 
     def replicaof(self, *args):
         """
@@ -785,7 +811,7 @@ def replicaof(self, *args):
 
         For more information check  https://redis.io/commands/replicaof
         """
-        return self.execute_command('REPLICAOF', *args)
+        return self.execute_command("REPLICAOF", *args)
 
     def save(self):
         """
@@ -794,7 +820,7 @@ def save(self):
 
         For more information check https://redis.io/commands/save
         """
-        return self.execute_command('SAVE')
+        return self.execute_command("SAVE")
 
     def shutdown(self, save=False, nosave=False):
         """Shutdown the Redis server.  If Redis has persistence configured,
@@ -806,12 +832,12 @@ def shutdown(self, save=False, nosave=False):
         For more information check https://redis.io/commands/shutdown
         """
         if save and nosave:
-            raise DataError('SHUTDOWN save and nosave cannot both be set')
-        args = ['SHUTDOWN']
+            raise DataError("SHUTDOWN save and nosave cannot both be set")
+        args = ["SHUTDOWN"]
         if save:
-            args.append('SAVE')
+            args.append("SAVE")
         if nosave:
-            args.append('NOSAVE')
+            args.append("NOSAVE")
         try:
             self.execute_command(*args)
         except ConnectionError:
@@ -828,8 +854,8 @@ def slaveof(self, host=None, port=None):
         For more information check https://redis.io/commands/slaveof
         """
         if host is None and port is None:
-            return self.execute_command('SLAVEOF', b'NO', b'ONE')
-        return self.execute_command('SLAVEOF', host, port)
+            return self.execute_command("SLAVEOF", b"NO", b"ONE")
+        return self.execute_command("SLAVEOF", host, port)
 
     def slowlog_get(self, num=None):
         """
@@ -838,11 +864,12 @@ def slowlog_get(self, num=None):
 
         For more information check https://redis.io/commands/slowlog-get
         """
-        args = ['SLOWLOG GET']
+        args = ["SLOWLOG GET"]
         if num is not None:
             args.append(num)
         decode_responses = self.connection_pool.connection_kwargs.get(
-            'decode_responses', False)
+            "decode_responses", False
+        )
         return self.execute_command(*args, decode_responses=decode_responses)
 
     def slowlog_len(self):
@@ -851,7 +878,7 @@ def slowlog_len(self):
 
         For more information check https://redis.io/commands/slowlog-len
         """
-        return self.execute_command('SLOWLOG LEN')
+        return self.execute_command("SLOWLOG LEN")
 
     def slowlog_reset(self):
         """
@@ -859,7 +886,7 @@ def slowlog_reset(self):
 
         For more information check https://redis.io/commands/slowlog-reset
         """
-        return self.execute_command('SLOWLOG RESET')
+        return self.execute_command("SLOWLOG RESET")
 
     def time(self):
         """
@@ -868,7 +895,7 @@ def time(self):
 
         For more information check https://redis.io/commands/time
         """
-        return self.execute_command('TIME')
+        return self.execute_command("TIME")
 
     def wait(self, num_replicas, timeout):
         """
@@ -879,13 +906,14 @@ def wait(self, num_replicas, timeout):
 
         For more information check https://redis.io/commands/wait
         """
-        return self.execute_command('WAIT', num_replicas, timeout)
+        return self.execute_command("WAIT", num_replicas, timeout)
 
 
 class BasicKeyCommands:
     """
     Redis basic key-based commands
     """
+
     def append(self, key, value):
         """
         Appends the string ``value`` to the value at ``key``. If ``key``
@@ -894,7 +922,7 @@ def append(self, key, value):
 
         For more information check https://redis.io/commands/append
         """
-        return self.execute_command('APPEND', key, value)
+        return self.execute_command("APPEND", key, value)
 
     def bitcount(self, key, start=None, end=None):
         """
@@ -907,10 +935,9 @@ def bitcount(self, key, start=None, end=None):
         if start is not None and end is not None:
             params.append(start)
             params.append(end)
-        elif (start is not None and end is None) or \
-                (end is not None and start is None):
+        elif (start is not None and end is None) or (end is not None and start is None):
             raise DataError("Both start and end must be specified")
-        return self.execute_command('BITCOUNT', *params)
+        return self.execute_command("BITCOUNT", *params)
 
     def bitfield(self, key, default_overflow=None):
         """
@@ -928,7 +955,7 @@ def bitop(self, operation, dest, *keys):
 
         For more information check https://redis.io/commands/bitop
         """
-        return self.execute_command('BITOP', operation, dest, *keys)
+        return self.execute_command("BITOP", operation, dest, *keys)
 
     def bitpos(self, key, bit, start=None, end=None):
         """
@@ -940,7 +967,7 @@ def bitpos(self, key, bit, start=None, end=None):
         For more information check https://redis.io/commands/bitpos
         """
         if bit not in (0, 1):
-            raise DataError('bit must be 0 or 1')
+            raise DataError("bit must be 0 or 1")
         params = [key, bit]
 
         start is not None and params.append(start)
@@ -948,9 +975,8 @@ def bitpos(self, key, bit, start=None, end=None):
         if start is not None and end is not None:
             params.append(end)
         elif start is None and end is not None:
-            raise DataError("start argument is not set, "
-                            "when end is specified")
-        return self.execute_command('BITPOS', *params)
+            raise DataError("start argument is not set, " "when end is specified")
+        return self.execute_command("BITPOS", *params)
 
     def copy(self, source, destination, destination_db=None, replace=False):
         """
@@ -970,7 +996,7 @@ def copy(self, source, destination, destination_db=None, replace=False):
             params.extend(["DB", destination_db])
         if replace:
             params.append("REPLACE")
-        return self.execute_command('COPY', *params)
+        return self.execute_command("COPY", *params)
 
     def decr(self, name, amount=1):
         """
@@ -990,13 +1016,13 @@ def decrby(self, name, amount=1):
 
         For more information check https://redis.io/commands/decrby
         """
-        return self.execute_command('DECRBY', name, amount)
+        return self.execute_command("DECRBY", name, amount)
 
     def delete(self, *names):
         """
         Delete one or more keys specified by ``names``
         """
-        return self.execute_command('DEL', *names)
+        return self.execute_command("DEL", *names)
 
     def __delitem__(self, name):
         self.delete(name)
@@ -1009,9 +1035,10 @@ def dump(self, name):
         For more information check https://redis.io/commands/dump
         """
         from redis.client import NEVER_DECODE
+
         options = {}
         options[NEVER_DECODE] = []
-        return self.execute_command('DUMP', name, **options)
+        return self.execute_command("DUMP", name, **options)
 
     def exists(self, *names):
         """
@@ -1019,7 +1046,8 @@ def exists(self, *names):
 
         For more information check https://redis.io/commands/exists
         """
-        return self.execute_command('EXISTS', *names)
+        return self.execute_command("EXISTS", *names)
+
     __contains__ = exists
 
     def expire(self, name, time):
@@ -1031,7 +1059,7 @@ def expire(self, name, time):
         """
         if isinstance(time, datetime.timedelta):
             time = int(time.total_seconds())
-        return self.execute_command('EXPIRE', name, time)
+        return self.execute_command("EXPIRE", name, time)
 
     def expireat(self, name, when):
         """
@@ -1042,7 +1070,7 @@ def expireat(self, name, when):
         """
         if isinstance(when, datetime.datetime):
             when = int(time.mktime(when.timetuple()))
-        return self.execute_command('EXPIREAT', name, when)
+        return self.execute_command("EXPIREAT", name, when)
 
     def get(self, name):
         """
@@ -1050,7 +1078,7 @@ def get(self, name):
 
         For more information check https://redis.io/commands/get
         """
-        return self.execute_command('GET', name)
+        return self.execute_command("GET", name)
 
     def getdel(self, name):
         """
@@ -1061,10 +1089,9 @@ def getdel(self, name):
 
         For more information check https://redis.io/commands/getdel
         """
-        return self.execute_command('GETDEL', name)
+        return self.execute_command("GETDEL", name)
 
-    def getex(self, name,
-              ex=None, px=None, exat=None, pxat=None, persist=False):
+    def getex(self, name, ex=None, px=None, exat=None, pxat=None, persist=False):
         """
         Get the value of key and optionally set its expiration.
         GETEX is similar to GET, but is a write command with
@@ -1088,38 +1115,40 @@ def getex(self, name,
 
         opset = {ex, px, exat, pxat}
         if len(opset) > 2 or len(opset) > 1 and persist:
-            raise DataError("``ex``, ``px``, ``exat``, ``pxat``, "
-                            "and ``persist`` are mutually exclusive.")
+            raise DataError(
+                "``ex``, ``px``, ``exat``, ``pxat``, "
+                "and ``persist`` are mutually exclusive."
+            )
 
         pieces = []
         # similar to set command
         if ex is not None:
-            pieces.append('EX')
+            pieces.append("EX")
             if isinstance(ex, datetime.timedelta):
                 ex = int(ex.total_seconds())
             pieces.append(ex)
         if px is not None:
-            pieces.append('PX')
+            pieces.append("PX")
             if isinstance(px, datetime.timedelta):
                 px = int(px.total_seconds() * 1000)
             pieces.append(px)
         # similar to pexpireat command
         if exat is not None:
-            pieces.append('EXAT')
+            pieces.append("EXAT")
             if isinstance(exat, datetime.datetime):
                 s = int(exat.microsecond / 1000000)
                 exat = int(time.mktime(exat.timetuple())) + s
             pieces.append(exat)
         if pxat is not None:
-            pieces.append('PXAT')
+            pieces.append("PXAT")
             if isinstance(pxat, datetime.datetime):
                 ms = int(pxat.microsecond / 1000)
                 pxat = int(time.mktime(pxat.timetuple())) * 1000 + ms
             pieces.append(pxat)
         if persist:
-            pieces.append('PERSIST')
+            pieces.append("PERSIST")
 
-        return self.execute_command('GETEX', name, *pieces)
+        return self.execute_command("GETEX", name, *pieces)
 
     def __getitem__(self, name):
         """
@@ -1137,7 +1166,7 @@ def getbit(self, name, offset):
 
         For more information check https://redis.io/commands/getbit
         """
-        return self.execute_command('GETBIT', name, offset)
+        return self.execute_command("GETBIT", name, offset)
 
     def getrange(self, key, start, end):
         """
@@ -1146,7 +1175,7 @@ def getrange(self, key, start, end):
 
         For more information check https://redis.io/commands/getrange
         """
-        return self.execute_command('GETRANGE', key, start, end)
+        return self.execute_command("GETRANGE", key, start, end)
 
     def getset(self, name, value):
         """
@@ -1158,7 +1187,7 @@ def getset(self, name, value):
 
         For more information check https://redis.io/commands/getset
         """
-        return self.execute_command('GETSET', name, value)
+        return self.execute_command("GETSET", name, value)
 
     def incr(self, name, amount=1):
         """
@@ -1178,7 +1207,7 @@ def incrby(self, name, amount=1):
         """
         # An alias for ``incr()``, because it is already implemented
         # as INCRBY redis command.
-        return self.execute_command('INCRBY', name, amount)
+        return self.execute_command("INCRBY", name, amount)
 
     def incrbyfloat(self, name, amount=1.0):
         """
@@ -1187,15 +1216,15 @@ def incrbyfloat(self, name, amount=1.0):
 
         For more information check https://redis.io/commands/incrbyfloat
         """
-        return self.execute_command('INCRBYFLOAT', name, amount)
+        return self.execute_command("INCRBYFLOAT", name, amount)
 
-    def keys(self, pattern='*'):
+    def keys(self, pattern="*"):
         """
         Returns a list of keys matching ``pattern``
 
         For more information check https://redis.io/commands/keys
         """
-        return self.execute_command('KEYS', pattern)
+        return self.execute_command("KEYS", pattern)
 
     def lmove(self, first_list, second_list, src="LEFT", dest="RIGHT"):
         """
@@ -1208,8 +1237,7 @@ def lmove(self, first_list, second_list, src="LEFT", dest="RIGHT"):
         params = [first_list, second_list, src, dest]
         return self.execute_command("LMOVE", *params)
 
-    def blmove(self, first_list, second_list, timeout,
-               src="LEFT", dest="RIGHT"):
+    def blmove(self, first_list, second_list, timeout, src="LEFT", dest="RIGHT"):
         """
         Blocking version of lmove.
 
@@ -1225,11 +1253,12 @@ def mget(self, keys, *args):
         For more information check https://redis.io/commands/mget
         """
         from redis.client import EMPTY_RESPONSE
+
         args = list_or_args(keys, args)
         options = {}
         if not args:
             options[EMPTY_RESPONSE] = []
-        return self.execute_command('MGET', *args, **options)
+        return self.execute_command("MGET", *args, **options)
 
     def mset(self, mapping):
         """
@@ -1242,7 +1271,7 @@ def mset(self, mapping):
         items = []
         for pair in mapping.items():
             items.extend(pair)
-        return self.execute_command('MSET', *items)
+        return self.execute_command("MSET", *items)
 
     def msetnx(self, mapping):
         """
@@ -1256,7 +1285,7 @@ def msetnx(self, mapping):
         items = []
         for pair in mapping.items():
             items.extend(pair)
-        return self.execute_command('MSETNX', *items)
+        return self.execute_command("MSETNX", *items)
 
     def move(self, name, db):
         """
@@ -1264,7 +1293,7 @@ def move(self, name, db):
 
         For more information check https://redis.io/commands/move
         """
-        return self.execute_command('MOVE', name, db)
+        return self.execute_command("MOVE", name, db)
 
     def persist(self, name):
         """
@@ -1272,7 +1301,7 @@ def persist(self, name):
 
         For more information check https://redis.io/commands/persist
         """
-        return self.execute_command('PERSIST', name)
+        return self.execute_command("PERSIST", name)
 
     def pexpire(self, name, time):
         """
@@ -1284,7 +1313,7 @@ def pexpire(self, name, time):
         """
         if isinstance(time, datetime.timedelta):
             time = int(time.total_seconds() * 1000)
-        return self.execute_command('PEXPIRE', name, time)
+        return self.execute_command("PEXPIRE", name, time)
 
     def pexpireat(self, name, when):
         """
@@ -1297,7 +1326,7 @@ def pexpireat(self, name, when):
         if isinstance(when, datetime.datetime):
             ms = int(when.microsecond / 1000)
             when = int(time.mktime(when.timetuple())) * 1000 + ms
-        return self.execute_command('PEXPIREAT', name, when)
+        return self.execute_command("PEXPIREAT", name, when)
 
     def psetex(self, name, time_ms, value):
         """
@@ -1309,7 +1338,7 @@ def psetex(self, name, time_ms, value):
         """
         if isinstance(time_ms, datetime.timedelta):
             time_ms = int(time_ms.total_seconds() * 1000)
-        return self.execute_command('PSETEX', name, time_ms, value)
+        return self.execute_command("PSETEX", name, time_ms, value)
 
     def pttl(self, name):
         """
@@ -1317,7 +1346,7 @@ def pttl(self, name):
 
         For more information check https://redis.io/commands/pttl
         """
-        return self.execute_command('PTTL', name)
+        return self.execute_command("PTTL", name)
 
     def hrandfield(self, key, count=None, withvalues=False):
         """
@@ -1347,7 +1376,7 @@ def randomkey(self):
 
         For more information check https://redis.io/commands/randomkey
         """
-        return self.execute_command('RANDOMKEY')
+        return self.execute_command("RANDOMKEY")
 
     def rename(self, src, dst):
         """
@@ -1355,7 +1384,7 @@ def rename(self, src, dst):
 
         For more information check https://redis.io/commands/rename
         """
-        return self.execute_command('RENAME', src, dst)
+        return self.execute_command("RENAME", src, dst)
 
     def renamenx(self, src, dst):
         """
@@ -1363,10 +1392,18 @@ def renamenx(self, src, dst):
 
         For more information check https://redis.io/commands/renamenx
         """
-        return self.execute_command('RENAMENX', src, dst)
+        return self.execute_command("RENAMENX", src, dst)
 
-    def restore(self, name, ttl, value, replace=False, absttl=False,
-                idletime=None, frequency=None):
+    def restore(
+        self,
+        name,
+        ttl,
+        value,
+        replace=False,
+        absttl=False,
+        idletime=None,
+        frequency=None,
+    ):
         """
         Create a key using the provided serialized value, previously obtained
         using DUMP.
@@ -1388,28 +1425,38 @@ def restore(self, name, ttl, value, replace=False, absttl=False,
         """
         params = [name, ttl, value]
         if replace:
-            params.append('REPLACE')
+            params.append("REPLACE")
         if absttl:
-            params.append('ABSTTL')
+            params.append("ABSTTL")
         if idletime is not None:
-            params.append('IDLETIME')
+            params.append("IDLETIME")
             try:
                 params.append(int(idletime))
             except ValueError:
                 raise DataError("idletimemust be an integer")
 
         if frequency is not None:
-            params.append('FREQ')
+            params.append("FREQ")
             try:
                 params.append(int(frequency))
             except ValueError:
                 raise DataError("frequency must be an integer")
 
-        return self.execute_command('RESTORE', *params)
-
-    def set(self, name, value,
-            ex=None, px=None, nx=False, xx=False, keepttl=False, get=False,
-            exat=None, pxat=None):
+        return self.execute_command("RESTORE", *params)
+
+    def set(
+        self,
+        name,
+        value,
+        ex=None,
+        px=None,
+        nx=False,
+        xx=False,
+        keepttl=False,
+        get=False,
+        exat=None,
+        pxat=None,
+    ):
         """
         Set the value at key ``name`` to ``value``
 
@@ -1441,7 +1488,7 @@ def set(self, name, value,
         pieces = [name, value]
         options = {}
         if ex is not None:
-            pieces.append('EX')
+            pieces.append("EX")
             if isinstance(ex, datetime.timedelta):
                 pieces.append(int(ex.total_seconds()))
             elif isinstance(ex, int):
@@ -1449,7 +1496,7 @@ def set(self, name, value,
             else:
                 raise DataError("ex must be datetime.timedelta or int")
         if px is not None:
-            pieces.append('PX')
+            pieces.append("PX")
             if isinstance(px, datetime.timedelta):
                 pieces.append(int(px.total_seconds() * 1000))
             elif isinstance(px, int):
@@ -1457,30 +1504,30 @@ def set(self, name, value,
             else:
                 raise DataError("px must be datetime.timedelta or int")
         if exat is not None:
-            pieces.append('EXAT')
+            pieces.append("EXAT")
             if isinstance(exat, datetime.datetime):
                 s = int(exat.microsecond / 1000000)
                 exat = int(time.mktime(exat.timetuple())) + s
             pieces.append(exat)
         if pxat is not None:
-            pieces.append('PXAT')
+            pieces.append("PXAT")
             if isinstance(pxat, datetime.datetime):
                 ms = int(pxat.microsecond / 1000)
                 pxat = int(time.mktime(pxat.timetuple())) * 1000 + ms
             pieces.append(pxat)
         if keepttl:
-            pieces.append('KEEPTTL')
+            pieces.append("KEEPTTL")
 
         if nx:
-            pieces.append('NX')
+            pieces.append("NX")
         if xx:
-            pieces.append('XX')
+            pieces.append("XX")
 
         if get:
-            pieces.append('GET')
+            pieces.append("GET")
             options["get"] = True
 
-        return self.execute_command('SET', *pieces, **options)
+        return self.execute_command("SET", *pieces, **options)
 
     def __setitem__(self, name, value):
         self.set(name, value)
@@ -1493,7 +1540,7 @@ def setbit(self, name, offset, value):
         For more information check https://redis.io/commands/setbit
         """
         value = value and 1 or 0
-        return self.execute_command('SETBIT', name, offset, value)
+        return self.execute_command("SETBIT", name, offset, value)
 
     def setex(self, name, time, value):
         """
@@ -1505,7 +1552,7 @@ def setex(self, name, time, value):
         """
         if isinstance(time, datetime.timedelta):
             time = int(time.total_seconds())
-        return self.execute_command('SETEX', name, time, value)
+        return self.execute_command("SETEX", name, time, value)
 
     def setnx(self, name, value):
         """
@@ -1513,7 +1560,7 @@ def setnx(self, name, value):
 
         For more information check https://redis.io/commands/setnx
         """
-        return self.execute_command('SETNX', name, value)
+        return self.execute_command("SETNX", name, value)
 
     def setrange(self, name, offset, value):
         """
@@ -1528,10 +1575,19 @@ def setrange(self, name, offset, value):
 
         For more information check https://redis.io/commands/setrange
         """
-        return self.execute_command('SETRANGE', name, offset, value)
+        return self.execute_command("SETRANGE", name, offset, value)
 
-    def stralgo(self, algo, value1, value2, specific_argument='strings',
-                len=False, idx=False, minmatchlen=None, withmatchlen=False):
+    def stralgo(
+        self,
+        algo,
+        value1,
+        value2,
+        specific_argument="strings",
+        len=False,
+        idx=False,
+        minmatchlen=None,
+        withmatchlen=False,
+    ):
         """
         Implements complex algorithms that operate on strings.
         Right now the only algorithm implemented is the LCS algorithm
@@ -1552,31 +1608,36 @@ def stralgo(self, algo, value1, value2, specific_argument='strings',
         For more information check https://redis.io/commands/stralgo
         """
         # check validity
-        supported_algo = ['LCS']
+        supported_algo = ["LCS"]
         if algo not in supported_algo:
-            supported_algos_str = ', '.join(supported_algo)
+            supported_algos_str = ", ".join(supported_algo)
             raise DataError(f"The supported algorithms are: {supported_algos_str}")
-        if specific_argument not in ['keys', 'strings']:
+        if specific_argument not in ["keys", "strings"]:
             raise DataError("specific_argument can be only keys or strings")
         if len and idx:
             raise DataError("len and idx cannot be provided together.")
 
         pieces = [algo, specific_argument.upper(), value1, value2]
         if len:
-            pieces.append(b'LEN')
+            pieces.append(b"LEN")
         if idx:
-            pieces.append(b'IDX')
+            pieces.append(b"IDX")
         try:
             int(minmatchlen)
-            pieces.extend([b'MINMATCHLEN', minmatchlen])
+            pieces.extend([b"MINMATCHLEN", minmatchlen])
         except TypeError:
             pass
         if withmatchlen:
-            pieces.append(b'WITHMATCHLEN')
-
-        return self.execute_command('STRALGO', *pieces, len=len, idx=idx,
-                                    minmatchlen=minmatchlen,
-                                    withmatchlen=withmatchlen)
+            pieces.append(b"WITHMATCHLEN")
+
+        return self.execute_command(
+            "STRALGO",
+            *pieces,
+            len=len,
+            idx=idx,
+            minmatchlen=minmatchlen,
+            withmatchlen=withmatchlen,
+        )
 
     def strlen(self, name):
         """
@@ -1584,14 +1645,14 @@ def strlen(self, name):
 
         For more information check https://redis.io/commands/strlen
         """
-        return self.execute_command('STRLEN', name)
+        return self.execute_command("STRLEN", name)
 
     def substr(self, name, start, end=-1):
         """
         Return a substring of the string at key ``name``. ``start`` and ``end``
         are 0-based integers specifying the portion of the string to return.
         """
-        return self.execute_command('SUBSTR', name, start, end)
+        return self.execute_command("SUBSTR", name, start, end)
 
     def touch(self, *args):
         """
@@ -1600,7 +1661,7 @@ def touch(self, *args):
 
         For more information check https://redis.io/commands/touch
         """
-        return self.execute_command('TOUCH', *args)
+        return self.execute_command("TOUCH", *args)
 
     def ttl(self, name):
         """
@@ -1608,7 +1669,7 @@ def ttl(self, name):
 
         For more information check https://redis.io/commands/ttl
         """
-        return self.execute_command('TTL', name)
+        return self.execute_command("TTL", name)
 
     def type(self, name):
         """
@@ -1616,7 +1677,7 @@ def type(self, name):
 
         For more information check https://redis.io/commands/type
         """
-        return self.execute_command('TYPE', name)
+        return self.execute_command("TYPE", name)
 
     def watch(self, *names):
         """
@@ -1624,7 +1685,7 @@ def watch(self, *names):
 
         For more information check https://redis.io/commands/type
         """
-        warnings.warn(DeprecationWarning('Call WATCH from a Pipeline object'))
+        warnings.warn(DeprecationWarning("Call WATCH from a Pipeline object"))
 
     def unwatch(self):
         """
@@ -1632,8 +1693,7 @@ def unwatch(self):
 
         For more information check https://redis.io/commands/unwatch
         """
-        warnings.warn(
-            DeprecationWarning('Call UNWATCH from a Pipeline object'))
+        warnings.warn(DeprecationWarning("Call UNWATCH from a Pipeline object"))
 
     def unlink(self, *names):
         """
@@ -1641,7 +1701,7 @@ def unlink(self, *names):
 
         For more information check https://redis.io/commands/unlink
         """
-        return self.execute_command('UNLINK', *names)
+        return self.execute_command("UNLINK", *names)
 
 
 class ListCommands:
@@ -1649,6 +1709,7 @@ class ListCommands:
     Redis commands for List data type.
     see: https://redis.io/topics/data-types#lists
     """
+
     def blpop(self, keys, timeout=0):
         """
         LPOP a value off of the first non-empty list
@@ -1666,7 +1727,7 @@ def blpop(self, keys, timeout=0):
             timeout = 0
         keys = list_or_args(keys, None)
         keys.append(timeout)
-        return self.execute_command('BLPOP', *keys)
+        return self.execute_command("BLPOP", *keys)
 
     def brpop(self, keys, timeout=0):
         """
@@ -1685,7 +1746,7 @@ def brpop(self, keys, timeout=0):
             timeout = 0
         keys = list_or_args(keys, None)
         keys.append(timeout)
-        return self.execute_command('BRPOP', *keys)
+        return self.execute_command("BRPOP", *keys)
 
     def brpoplpush(self, src, dst, timeout=0):
         """
@@ -1700,7 +1761,7 @@ def brpoplpush(self, src, dst, timeout=0):
         """
         if timeout is None:
             timeout = 0
-        return self.execute_command('BRPOPLPUSH', src, dst, timeout)
+        return self.execute_command("BRPOPLPUSH", src, dst, timeout)
 
     def lindex(self, name, index):
         """
@@ -1711,7 +1772,7 @@ def lindex(self, name, index):
 
         For more information check https://redis.io/commands/lindex
         """
-        return self.execute_command('LINDEX', name, index)
+        return self.execute_command("LINDEX", name, index)
 
     def linsert(self, name, where, refvalue, value):
         """
@@ -1723,7 +1784,7 @@ def linsert(self, name, where, refvalue, value):
 
         For more information check https://redis.io/commands/linsert
         """
-        return self.execute_command('LINSERT', name, where, refvalue, value)
+        return self.execute_command("LINSERT", name, where, refvalue, value)
 
     def llen(self, name):
         """
@@ -1731,7 +1792,7 @@ def llen(self, name):
 
         For more information check https://redis.io/commands/llen
         """
-        return self.execute_command('LLEN', name)
+        return self.execute_command("LLEN", name)
 
     def lpop(self, name, count=None):
         """
@@ -1744,9 +1805,9 @@ def lpop(self, name, count=None):
         For more information check https://redis.io/commands/lpop
         """
         if count is not None:
-            return self.execute_command('LPOP', name, count)
+            return self.execute_command("LPOP", name, count)
         else:
-            return self.execute_command('LPOP', name)
+            return self.execute_command("LPOP", name)
 
     def lpush(self, name, *values):
         """
@@ -1754,7 +1815,7 @@ def lpush(self, name, *values):
 
         For more information check https://redis.io/commands/lpush
         """
-        return self.execute_command('LPUSH', name, *values)
+        return self.execute_command("LPUSH", name, *values)
 
     def lpushx(self, name, *values):
         """
@@ -1762,7 +1823,7 @@ def lpushx(self, name, *values):
 
         For more information check https://redis.io/commands/lpushx
         """
-        return self.execute_command('LPUSHX', name, *values)
+        return self.execute_command("LPUSHX", name, *values)
 
     def lrange(self, name, start, end):
         """
@@ -1774,7 +1835,7 @@ def lrange(self, name, start, end):
 
         For more information check https://redis.io/commands/lrange
         """
-        return self.execute_command('LRANGE', name, start, end)
+        return self.execute_command("LRANGE", name, start, end)
 
     def lrem(self, name, count, value):
         """
@@ -1788,7 +1849,7 @@ def lrem(self, name, count, value):
 
             For more information check https://redis.io/commands/lrem
         """
-        return self.execute_command('LREM', name, count, value)
+        return self.execute_command("LREM", name, count, value)
 
     def lset(self, name, index, value):
         """
@@ -1796,7 +1857,7 @@ def lset(self, name, index, value):
 
         For more information check https://redis.io/commands/lset
         """
-        return self.execute_command('LSET', name, index, value)
+        return self.execute_command("LSET", name, index, value)
 
     def ltrim(self, name, start, end):
         """
@@ -1808,7 +1869,7 @@ def ltrim(self, name, start, end):
 
         For more information check https://redis.io/commands/ltrim
         """
-        return self.execute_command('LTRIM', name, start, end)
+        return self.execute_command("LTRIM", name, start, end)
 
     def rpop(self, name, count=None):
         """
@@ -1821,9 +1882,9 @@ def rpop(self, name, count=None):
         For more information check https://redis.io/commands/rpop
         """
         if count is not None:
-            return self.execute_command('RPOP', name, count)
+            return self.execute_command("RPOP", name, count)
         else:
-            return self.execute_command('RPOP', name)
+            return self.execute_command("RPOP", name)
 
     def rpoplpush(self, src, dst):
         """
@@ -1832,7 +1893,7 @@ def rpoplpush(self, src, dst):
 
         For more information check https://redis.io/commands/rpoplpush
         """
-        return self.execute_command('RPOPLPUSH', src, dst)
+        return self.execute_command("RPOPLPUSH", src, dst)
 
     def rpush(self, name, *values):
         """
@@ -1840,7 +1901,7 @@ def rpush(self, name, *values):
 
         For more information check https://redis.io/commands/rpush
         """
-        return self.execute_command('RPUSH', name, *values)
+        return self.execute_command("RPUSH", name, *values)
 
     def rpushx(self, name, value):
         """
@@ -1848,7 +1909,7 @@ def rpushx(self, name, value):
 
         For more information check https://redis.io/commands/rpushx
         """
-        return self.execute_command('RPUSHX', name, value)
+        return self.execute_command("RPUSHX", name, value)
 
     def lpos(self, name, value, rank=None, count=None, maxlen=None):
         """
@@ -1878,18 +1939,28 @@ def lpos(self, name, value, rank=None, count=None, maxlen=None):
         """
         pieces = [name, value]
         if rank is not None:
-            pieces.extend(['RANK', rank])
+            pieces.extend(["RANK", rank])
 
         if count is not None:
-            pieces.extend(['COUNT', count])
+            pieces.extend(["COUNT", count])
 
         if maxlen is not None:
-            pieces.extend(['MAXLEN', maxlen])
-
-        return self.execute_command('LPOS', *pieces)
-
-    def sort(self, name, start=None, num=None, by=None, get=None,
-             desc=False, alpha=False, store=None, groups=False):
+            pieces.extend(["MAXLEN", maxlen])
+
+        return self.execute_command("LPOS", *pieces)
+
+    def sort(
+        self,
+        name,
+        start=None,
+        num=None,
+        by=None,
+        get=None,
+        desc=False,
+        alpha=False,
+        store=None,
+        groups=False,
+    ):
         """
         Sort and return the list, set or sorted set at ``name``.
 
@@ -1915,39 +1986,40 @@ def sort(self, name, start=None, num=None, by=None, get=None,
 
         For more information check https://redis.io/commands/sort
         """
-        if (start is not None and num is None) or \
-                (num is not None and start is None):
+        if (start is not None and num is None) or (num is not None and start is None):
             raise DataError("``start`` and ``num`` must both be specified")
 
         pieces = [name]
         if by is not None:
-            pieces.extend([b'BY', by])
+            pieces.extend([b"BY", by])
         if start is not None and num is not None:
-            pieces.extend([b'LIMIT', start, num])
+            pieces.extend([b"LIMIT", start, num])
         if get is not None:
             # If get is a string assume we want to get a single value.
             # Otherwise assume it's an interable and we want to get multiple
             # values. We can't just iterate blindly because strings are
             # iterable.
             if isinstance(get, (bytes, str)):
-                pieces.extend([b'GET', get])
+                pieces.extend([b"GET", get])
             else:
                 for g in get:
-                    pieces.extend([b'GET', g])
+                    pieces.extend([b"GET", g])
         if desc:
-            pieces.append(b'DESC')
+            pieces.append(b"DESC")
         if alpha:
-            pieces.append(b'ALPHA')
+            pieces.append(b"ALPHA")
         if store is not None:
-            pieces.extend([b'STORE', store])
+            pieces.extend([b"STORE", store])
         if groups:
             if not get or isinstance(get, (bytes, str)) or len(get) < 2:
-                raise DataError('when using "groups" the "get" argument '
-                                'must be specified and contain at least '
-                                'two keys')
+                raise DataError(
+                    'when using "groups" the "get" argument '
+                    "must be specified and contain at least "
+                    "two keys"
+                )
 
-        options = {'groups': len(get) if groups else None}
-        return self.execute_command('SORT', *pieces, **options)
+        options = {"groups": len(get) if groups else None}
+        return self.execute_command("SORT", *pieces, **options)
 
 
 class ScanCommands:
@@ -1955,6 +2027,7 @@ class ScanCommands:
     Redis SCAN commands.
     see: https://redis.io/commands/scan
     """
+
     def scan(self, cursor=0, match=None, count=None, _type=None):
         """
         Incrementally return lists of key names. Also return a cursor
@@ -1974,12 +2047,12 @@ def scan(self, cursor=0, match=None, count=None, _type=None):
         """
         pieces = [cursor]
         if match is not None:
-            pieces.extend([b'MATCH', match])
+            pieces.extend([b"MATCH", match])
         if count is not None:
-            pieces.extend([b'COUNT', count])
+            pieces.extend([b"COUNT", count])
         if _type is not None:
-            pieces.extend([b'TYPE', _type])
-        return self.execute_command('SCAN', *pieces)
+            pieces.extend([b"TYPE", _type])
+        return self.execute_command("SCAN", *pieces)
 
     def scan_iter(self, match=None, count=None, _type=None):
         """
@@ -1996,10 +2069,11 @@ def scan_iter(self, match=None, count=None, _type=None):
             HASH, LIST, SET, STREAM, STRING, ZSET
             Additionally, Redis modules can expose other types as well.
         """
-        cursor = '0'
+        cursor = "0"
         while cursor != 0:
-            cursor, data = self.scan(cursor=cursor, match=match,
-                                     count=count, _type=_type)
+            cursor, data = self.scan(
+                cursor=cursor, match=match, count=count, _type=_type
+            )
             yield from data
 
     def sscan(self, name, cursor=0, match=None, count=None):
@@ -2015,10 +2089,10 @@ def sscan(self, name, cursor=0, match=None, count=None):
         """
         pieces = [name, cursor]
         if match is not None:
-            pieces.extend([b'MATCH', match])
+            pieces.extend([b"MATCH", match])
         if count is not None:
-            pieces.extend([b'COUNT', count])
-        return self.execute_command('SSCAN', *pieces)
+            pieces.extend([b"COUNT", count])
+        return self.execute_command("SSCAN", *pieces)
 
     def sscan_iter(self, name, match=None, count=None):
         """
@@ -2029,10 +2103,9 @@ def sscan_iter(self, name, match=None, count=None):
 
         ``count`` allows for hint the minimum number of returns
         """
-        cursor = '0'
+        cursor = "0"
         while cursor != 0:
-            cursor, data = self.sscan(name, cursor=cursor,
-                                      match=match, count=count)
+            cursor, data = self.sscan(name, cursor=cursor, match=match, count=count)
             yield from data
 
     def hscan(self, name, cursor=0, match=None, count=None):
@@ -2048,10 +2121,10 @@ def hscan(self, name, cursor=0, match=None, count=None):
         """
         pieces = [name, cursor]
         if match is not None:
-            pieces.extend([b'MATCH', match])
+            pieces.extend([b"MATCH", match])
         if count is not None:
-            pieces.extend([b'COUNT', count])
-        return self.execute_command('HSCAN', *pieces)
+            pieces.extend([b"COUNT", count])
+        return self.execute_command("HSCAN", *pieces)
 
     def hscan_iter(self, name, match=None, count=None):
         """
@@ -2062,14 +2135,12 @@ def hscan_iter(self, name, match=None, count=None):
 
         ``count`` allows for hint the minimum number of returns
         """
-        cursor = '0'
+        cursor = "0"
         while cursor != 0:
-            cursor, data = self.hscan(name, cursor=cursor,
-                                      match=match, count=count)
+            cursor, data = self.hscan(name, cursor=cursor, match=match, count=count)
             yield from data.items()
 
-    def zscan(self, name, cursor=0, match=None, count=None,
-              score_cast_func=float):
+    def zscan(self, name, cursor=0, match=None, count=None, score_cast_func=float):
         """
         Incrementally return lists of elements in a sorted set. Also return a
         cursor indicating the scan position.
@@ -2084,14 +2155,13 @@ def zscan(self, name, cursor=0, match=None, count=None,
         """
         pieces = [name, cursor]
         if match is not None:
-            pieces.extend([b'MATCH', match])
+            pieces.extend([b"MATCH", match])
         if count is not None:
-            pieces.extend([b'COUNT', count])
-        options = {'score_cast_func': score_cast_func}
-        return self.execute_command('ZSCAN', *pieces, **options)
+            pieces.extend([b"COUNT", count])
+        options = {"score_cast_func": score_cast_func}
+        return self.execute_command("ZSCAN", *pieces, **options)
 
-    def zscan_iter(self, name, match=None, count=None,
-                   score_cast_func=float):
+    def zscan_iter(self, name, match=None, count=None, score_cast_func=float):
         """
         Make an iterator using the ZSCAN command so that the client doesn't
         need to remember the cursor position.
@@ -2102,11 +2172,15 @@ def zscan_iter(self, name, match=None, count=None,
 
         ``score_cast_func`` a callable used to cast the score return value
         """
-        cursor = '0'
+        cursor = "0"
         while cursor != 0:
-            cursor, data = self.zscan(name, cursor=cursor, match=match,
-                                      count=count,
-                                      score_cast_func=score_cast_func)
+            cursor, data = self.zscan(
+                name,
+                cursor=cursor,
+                match=match,
+                count=count,
+                score_cast_func=score_cast_func,
+            )
             yield from data
 
 
@@ -2115,13 +2189,14 @@ class SetCommands:
     Redis commands for Set data type.
     see: https://redis.io/topics/data-types#sets
     """
+
     def sadd(self, name, *values):
         """
         Add ``value(s)`` to set ``name``
 
         For more information check https://redis.io/commands/sadd
         """
-        return self.execute_command('SADD', name, *values)
+        return self.execute_command("SADD", name, *values)
 
     def scard(self, name):
         """
@@ -2129,7 +2204,7 @@ def scard(self, name):
 
         For more information check https://redis.io/commands/scard
         """
-        return self.execute_command('SCARD', name)
+        return self.execute_command("SCARD", name)
 
     def sdiff(self, keys, *args):
         """
@@ -2138,7 +2213,7 @@ def sdiff(self, keys, *args):
         For more information check https://redis.io/commands/sdiff
         """
         args = list_or_args(keys, args)
-        return self.execute_command('SDIFF', *args)
+        return self.execute_command("SDIFF", *args)
 
     def sdiffstore(self, dest, keys, *args):
         """
@@ -2148,7 +2223,7 @@ def sdiffstore(self, dest, keys, *args):
         For more information check https://redis.io/commands/sdiffstore
         """
         args = list_or_args(keys, args)
-        return self.execute_command('SDIFFSTORE', dest, *args)
+        return self.execute_command("SDIFFSTORE", dest, *args)
 
     def sinter(self, keys, *args):
         """
@@ -2157,7 +2232,7 @@ def sinter(self, keys, *args):
         For more information check https://redis.io/commands/sinter
         """
         args = list_or_args(keys, args)
-        return self.execute_command('SINTER', *args)
+        return self.execute_command("SINTER", *args)
 
     def sinterstore(self, dest, keys, *args):
         """
@@ -2167,7 +2242,7 @@ def sinterstore(self, dest, keys, *args):
         For more information check https://redis.io/commands/sinterstore
         """
         args = list_or_args(keys, args)
-        return self.execute_command('SINTERSTORE', dest, *args)
+        return self.execute_command("SINTERSTORE", dest, *args)
 
     def sismember(self, name, value):
         """
@@ -2175,7 +2250,7 @@ def sismember(self, name, value):
 
         For more information check https://redis.io/commands/sismember
         """
-        return self.execute_command('SISMEMBER', name, value)
+        return self.execute_command("SISMEMBER", name, value)
 
     def smembers(self, name):
         """
@@ -2183,7 +2258,7 @@ def smembers(self, name):
 
         For more information check https://redis.io/commands/smembers
         """
-        return self.execute_command('SMEMBERS', name)
+        return self.execute_command("SMEMBERS", name)
 
     def smismember(self, name, values, *args):
         """
@@ -2193,7 +2268,7 @@ def smismember(self, name, values, *args):
         For more information check https://redis.io/commands/smismember
         """
         args = list_or_args(values, args)
-        return self.execute_command('SMISMEMBER', name, *args)
+        return self.execute_command("SMISMEMBER", name, *args)
 
     def smove(self, src, dst, value):
         """
@@ -2201,7 +2276,7 @@ def smove(self, src, dst, value):
 
         For more information check https://redis.io/commands/smove
         """
-        return self.execute_command('SMOVE', src, dst, value)
+        return self.execute_command("SMOVE", src, dst, value)
 
     def spop(self, name, count=None):
         """
@@ -2210,7 +2285,7 @@ def spop(self, name, count=None):
         For more information check https://redis.io/commands/spop
         """
         args = (count is not None) and [count] or []
-        return self.execute_command('SPOP', name, *args)
+        return self.execute_command("SPOP", name, *args)
 
     def srandmember(self, name, number=None):
         """
@@ -2223,7 +2298,7 @@ def srandmember(self, name, number=None):
         For more information check https://redis.io/commands/srandmember
         """
         args = (number is not None) and [number] or []
-        return self.execute_command('SRANDMEMBER', name, *args)
+        return self.execute_command("SRANDMEMBER", name, *args)
 
     def srem(self, name, *values):
         """
@@ -2231,7 +2306,7 @@ def srem(self, name, *values):
 
         For more information check https://redis.io/commands/srem
         """
-        return self.execute_command('SREM', name, *values)
+        return self.execute_command("SREM", name, *values)
 
     def sunion(self, keys, *args):
         """
@@ -2240,7 +2315,7 @@ def sunion(self, keys, *args):
         For more information check https://redis.io/commands/sunion
         """
         args = list_or_args(keys, args)
-        return self.execute_command('SUNION', *args)
+        return self.execute_command("SUNION", *args)
 
     def sunionstore(self, dest, keys, *args):
         """
@@ -2250,7 +2325,7 @@ def sunionstore(self, dest, keys, *args):
         For more information check https://redis.io/commands/sunionstore
         """
         args = list_or_args(keys, args)
-        return self.execute_command('SUNIONSTORE', dest, *args)
+        return self.execute_command("SUNIONSTORE", dest, *args)
 
 
 class StreamCommands:
@@ -2258,6 +2333,7 @@ class StreamCommands:
     Redis commands for Stream data type.
     see: https://redis.io/topics/streams-intro
     """
+
     def xack(self, name, groupname, *ids):
         """
         Acknowledges the successful processing of one or more messages.
@@ -2267,10 +2343,19 @@ def xack(self, name, groupname, *ids):
 
         For more information check https://redis.io/commands/xack
         """
-        return self.execute_command('XACK', name, groupname, *ids)
+        return self.execute_command("XACK", name, groupname, *ids)
 
-    def xadd(self, name, fields, id='*', maxlen=None, approximate=True,
-             nomkstream=False, minid=None, limit=None):
+    def xadd(
+        self,
+        name,
+        fields,
+        id="*",
+        maxlen=None,
+        approximate=True,
+        nomkstream=False,
+        minid=None,
+        limit=None,
+    ):
         """
         Add to a stream.
         name: name of the stream
@@ -2288,34 +2373,43 @@ def xadd(self, name, fields, id='*', maxlen=None, approximate=True,
         """
         pieces = []
         if maxlen is not None and minid is not None:
-            raise DataError("Only one of ```maxlen``` or ```minid``` "
-                            "may be specified")
+            raise DataError(
+                "Only one of ```maxlen``` or ```minid``` " "may be specified"
+            )
 
         if maxlen is not None:
             if not isinstance(maxlen, int) or maxlen < 1:
-                raise DataError('XADD maxlen must be a positive integer')
-            pieces.append(b'MAXLEN')
+                raise DataError("XADD maxlen must be a positive integer")
+            pieces.append(b"MAXLEN")
             if approximate:
-                pieces.append(b'~')
+                pieces.append(b"~")
             pieces.append(str(maxlen))
         if minid is not None:
-            pieces.append(b'MINID')
+            pieces.append(b"MINID")
             if approximate:
-                pieces.append(b'~')
+                pieces.append(b"~")
             pieces.append(minid)
         if limit is not None:
-            pieces.extend([b'LIMIT', limit])
+            pieces.extend([b"LIMIT", limit])
         if nomkstream:
-            pieces.append(b'NOMKSTREAM')
+            pieces.append(b"NOMKSTREAM")
         pieces.append(id)
         if not isinstance(fields, dict) or len(fields) == 0:
-            raise DataError('XADD fields must be a non-empty dict')
+            raise DataError("XADD fields must be a non-empty dict")
         for pair in fields.items():
             pieces.extend(pair)
-        return self.execute_command('XADD', name, *pieces)
-
-    def xautoclaim(self, name, groupname, consumername, min_idle_time,
-                   start_id=0, count=None, justid=False):
+        return self.execute_command("XADD", name, *pieces)
+
+    def xautoclaim(
+        self,
+        name,
+        groupname,
+        consumername,
+        min_idle_time,
+        start_id=0,
+        count=None,
+        justid=False,
+    ):
         """
         Transfers ownership of pending stream entries that match the specified
         criteria. Conceptually, equivalent to calling XPENDING and then XCLAIM,
@@ -2336,8 +2430,9 @@ def xautoclaim(self, name, groupname, consumername, min_idle_time,
         """
         try:
             if int(min_idle_time) < 0:
-                raise DataError("XAUTOCLAIM min_idle_time must be a non"
-                                "negative integer")
+                raise DataError(
+                    "XAUTOCLAIM min_idle_time must be a non" "negative integer"
+                )
         except TypeError:
             pass
 
@@ -2347,18 +2442,28 @@ def xautoclaim(self, name, groupname, consumername, min_idle_time,
         try:
             if int(count) < 0:
                 raise DataError("XPENDING count must be a integer >= 0")
-            pieces.extend([b'COUNT', count])
+            pieces.extend([b"COUNT", count])
         except TypeError:
             pass
         if justid:
-            pieces.append(b'JUSTID')
-            kwargs['parse_justid'] = True
-
-        return self.execute_command('XAUTOCLAIM', *pieces, **kwargs)
-
-    def xclaim(self, name, groupname, consumername, min_idle_time, message_ids,
-               idle=None, time=None, retrycount=None, force=False,
-               justid=False):
+            pieces.append(b"JUSTID")
+            kwargs["parse_justid"] = True
+
+        return self.execute_command("XAUTOCLAIM", *pieces, **kwargs)
+
+    def xclaim(
+        self,
+        name,
+        groupname,
+        consumername,
+        min_idle_time,
+        message_ids,
+        idle=None,
+        time=None,
+        retrycount=None,
+        force=False,
+        justid=False,
+    ):
         """
         Changes the ownership of a pending message.
         name: name of the stream.
@@ -2384,11 +2489,12 @@ def xclaim(self, name, groupname, consumername, min_idle_time, message_ids,
          For more information check https://redis.io/commands/xclaim
         """
         if not isinstance(min_idle_time, int) or min_idle_time < 0:
-            raise DataError("XCLAIM min_idle_time must be a non negative "
-                            "integer")
+            raise DataError("XCLAIM min_idle_time must be a non negative " "integer")
         if not isinstance(message_ids, (list, tuple)) or not message_ids:
-            raise DataError("XCLAIM message_ids must be a non empty list or "
-                            "tuple of message IDs to claim")
+            raise DataError(
+                "XCLAIM message_ids must be a non empty list or "
+                "tuple of message IDs to claim"
+            )
 
         kwargs = {}
         pieces = [name, groupname, consumername, str(min_idle_time)]
@@ -2397,26 +2503,26 @@ def xclaim(self, name, groupname, consumername, min_idle_time, message_ids,
         if idle is not None:
             if not isinstance(idle, int):
                 raise DataError("XCLAIM idle must be an integer")
-            pieces.extend((b'IDLE', str(idle)))
+            pieces.extend((b"IDLE", str(idle)))
         if time is not None:
             if not isinstance(time, int):
                 raise DataError("XCLAIM time must be an integer")
-            pieces.extend((b'TIME', str(time)))
+            pieces.extend((b"TIME", str(time)))
         if retrycount is not None:
             if not isinstance(retrycount, int):
                 raise DataError("XCLAIM retrycount must be an integer")
-            pieces.extend((b'RETRYCOUNT', str(retrycount)))
+            pieces.extend((b"RETRYCOUNT", str(retrycount)))
 
         if force:
             if not isinstance(force, bool):
                 raise DataError("XCLAIM force must be a boolean")
-            pieces.append(b'FORCE')
+            pieces.append(b"FORCE")
         if justid:
             if not isinstance(justid, bool):
                 raise DataError("XCLAIM justid must be a boolean")
-            pieces.append(b'JUSTID')
-            kwargs['parse_justid'] = True
-        return self.execute_command('XCLAIM', *pieces, **kwargs)
+            pieces.append(b"JUSTID")
+            kwargs["parse_justid"] = True
+        return self.execute_command("XCLAIM", *pieces, **kwargs)
 
     def xdel(self, name, *ids):
         """
@@ -2426,9 +2532,9 @@ def xdel(self, name, *ids):
 
         For more information check https://redis.io/commands/xdel
         """
-        return self.execute_command('XDEL', name, *ids)
+        return self.execute_command("XDEL", name, *ids)
 
-    def xgroup_create(self, name, groupname, id='$', mkstream=False):
+    def xgroup_create(self, name, groupname, id="$", mkstream=False):
         """
         Create a new consumer group associated with a stream.
         name: name of the stream.
@@ -2437,9 +2543,9 @@ def xgroup_create(self, name, groupname, id='$', mkstream=False):
 
         For more information check https://redis.io/commands/xgroup-create
         """
-        pieces = ['XGROUP CREATE', name, groupname, id]
+        pieces = ["XGROUP CREATE", name, groupname, id]
         if mkstream:
-            pieces.append(b'MKSTREAM')
+            pieces.append(b"MKSTREAM")
         return self.execute_command(*pieces)
 
     def xgroup_delconsumer(self, name, groupname, consumername):
@@ -2453,8 +2559,7 @@ def xgroup_delconsumer(self, name, groupname, consumername):
 
         For more information check https://redis.io/commands/xgroup-delconsumer
         """
-        return self.execute_command('XGROUP DELCONSUMER', name, groupname,
-                                    consumername)
+        return self.execute_command("XGROUP DELCONSUMER", name, groupname, consumername)
 
     def xgroup_destroy(self, name, groupname):
         """
@@ -2464,7 +2569,7 @@ def xgroup_destroy(self, name, groupname):
 
         For more information check https://redis.io/commands/xgroup-destroy
         """
-        return self.execute_command('XGROUP DESTROY', name, groupname)
+        return self.execute_command("XGROUP DESTROY", name, groupname)
 
     def xgroup_createconsumer(self, name, groupname, consumername):
         """
@@ -2477,8 +2582,9 @@ def xgroup_createconsumer(self, name, groupname, consumername):
 
         See: https://redis.io/commands/xgroup-createconsumer
         """
-        return self.execute_command('XGROUP CREATECONSUMER', name, groupname,
-                                    consumername)
+        return self.execute_command(
+            "XGROUP CREATECONSUMER", name, groupname, consumername
+        )
 
     def xgroup_setid(self, name, groupname, id):
         """
@@ -2489,7 +2595,7 @@ def xgroup_setid(self, name, groupname, id):
 
         For more information check https://redis.io/commands/xgroup-setid
         """
-        return self.execute_command('XGROUP SETID', name, groupname, id)
+        return self.execute_command("XGROUP SETID", name, groupname, id)
 
     def xinfo_consumers(self, name, groupname):
         """
@@ -2499,7 +2605,7 @@ def xinfo_consumers(self, name, groupname):
 
         For more information check https://redis.io/commands/xinfo-consumers
         """
-        return self.execute_command('XINFO CONSUMERS', name, groupname)
+        return self.execute_command("XINFO CONSUMERS", name, groupname)
 
     def xinfo_groups(self, name):
         """
@@ -2508,7 +2614,7 @@ def xinfo_groups(self, name):
 
         For more information check https://redis.io/commands/xinfo-groups
         """
-        return self.execute_command('XINFO GROUPS', name)
+        return self.execute_command("XINFO GROUPS", name)
 
     def xinfo_stream(self, name, full=False):
         """
@@ -2521,9 +2627,9 @@ def xinfo_stream(self, name, full=False):
         pieces = [name]
         options = {}
         if full:
-            pieces.append(b'FULL')
-            options = {'full': full}
-        return self.execute_command('XINFO STREAM', *pieces, **options)
+            pieces.append(b"FULL")
+            options = {"full": full}
+        return self.execute_command("XINFO STREAM", *pieces, **options)
 
     def xlen(self, name):
         """
@@ -2531,7 +2637,7 @@ def xlen(self, name):
 
         For more information check https://redis.io/commands/xlen
         """
-        return self.execute_command('XLEN', name)
+        return self.execute_command("XLEN", name)
 
     def xpending(self, name, groupname):
         """
@@ -2541,11 +2647,18 @@ def xpending(self, name, groupname):
 
         For more information check https://redis.io/commands/xpending
         """
-        return self.execute_command('XPENDING', name, groupname)
+        return self.execute_command("XPENDING", name, groupname)
 
-    def xpending_range(self, name, groupname, idle=None,
-                       min=None, max=None, count=None,
-                       consumername=None):
+    def xpending_range(
+        self,
+        name,
+        groupname,
+        idle=None,
+        min=None,
+        max=None,
+        count=None,
+        consumername=None,
+    ):
         """
         Returns information about pending messages, in a range.
 
@@ -2560,20 +2673,24 @@ def xpending_range(self, name, groupname, idle=None,
         """
         if {min, max, count} == {None}:
             if idle is not None or consumername is not None:
-                raise DataError("if XPENDING is provided with idle time"
-                                " or consumername, it must be provided"
-                                " with min, max and count parameters")
+                raise DataError(
+                    "if XPENDING is provided with idle time"
+                    " or consumername, it must be provided"
+                    " with min, max and count parameters"
+                )
             return self.xpending(name, groupname)
 
         pieces = [name, groupname]
         if min is None or max is None or count is None:
-            raise DataError("XPENDING must be provided with min, max "
-                            "and count parameters, or none of them.")
+            raise DataError(
+                "XPENDING must be provided with min, max "
+                "and count parameters, or none of them."
+            )
         # idle
         try:
             if int(idle) < 0:
                 raise DataError("XPENDING idle must be a integer >= 0")
-            pieces.extend(['IDLE', idle])
+            pieces.extend(["IDLE", idle])
         except TypeError:
             pass
         # count
@@ -2587,9 +2704,9 @@ def xpending_range(self, name, groupname, idle=None,
         if consumername:
             pieces.append(consumername)
 
-        return self.execute_command('XPENDING', *pieces, parse_detail=True)
+        return self.execute_command("XPENDING", *pieces, parse_detail=True)
 
-    def xrange(self, name, min='-', max='+', count=None):
+    def xrange(self, name, min="-", max="+", count=None):
         """
         Read stream values within an interval.
         name: name of the stream.
@@ -2605,11 +2722,11 @@ def xrange(self, name, min='-', max='+', count=None):
         pieces = [min, max]
         if count is not None:
             if not isinstance(count, int) or count < 1:
-                raise DataError('XRANGE count must be a positive integer')
-            pieces.append(b'COUNT')
+                raise DataError("XRANGE count must be a positive integer")
+            pieces.append(b"COUNT")
             pieces.append(str(count))
 
-        return self.execute_command('XRANGE', name, *pieces)
+        return self.execute_command("XRANGE", name, *pieces)
 
     def xread(self, streams, count=None, block=None):
         """
@@ -2625,24 +2742,25 @@ def xread(self, streams, count=None, block=None):
         pieces = []
         if block is not None:
             if not isinstance(block, int) or block < 0:
-                raise DataError('XREAD block must be a non-negative integer')
-            pieces.append(b'BLOCK')
+                raise DataError("XREAD block must be a non-negative integer")
+            pieces.append(b"BLOCK")
             pieces.append(str(block))
         if count is not None:
             if not isinstance(count, int) or count < 1:
-                raise DataError('XREAD count must be a positive integer')
-            pieces.append(b'COUNT')
+                raise DataError("XREAD count must be a positive integer")
+            pieces.append(b"COUNT")
             pieces.append(str(count))
         if not isinstance(streams, dict) or len(streams) == 0:
-            raise DataError('XREAD streams must be a non empty dict')
-        pieces.append(b'STREAMS')
+            raise DataError("XREAD streams must be a non empty dict")
+        pieces.append(b"STREAMS")
         keys, values = zip(*streams.items())
         pieces.extend(keys)
         pieces.extend(values)
-        return self.execute_command('XREAD', *pieces)
+        return self.execute_command("XREAD", *pieces)
 
-    def xreadgroup(self, groupname, consumername, streams, count=None,
-                   block=None, noack=False):
+    def xreadgroup(
+        self, groupname, consumername, streams, count=None, block=None, noack=False
+    ):
         """
         Read from a stream via a consumer group.
         groupname: name of the consumer group.
@@ -2656,28 +2774,27 @@ def xreadgroup(self, groupname, consumername, streams, count=None,
 
         For more information check https://redis.io/commands/xreadgroup
         """
-        pieces = [b'GROUP', groupname, consumername]
+        pieces = [b"GROUP", groupname, consumername]
         if count is not None:
             if not isinstance(count, int) or count < 1:
                 raise DataError("XREADGROUP count must be a positive integer")
-            pieces.append(b'COUNT')
+            pieces.append(b"COUNT")
             pieces.append(str(count))
         if block is not None:
             if not isinstance(block, int) or block < 0:
-                raise DataError("XREADGROUP block must be a non-negative "
-                                "integer")
-            pieces.append(b'BLOCK')
+                raise DataError("XREADGROUP block must be a non-negative " "integer")
+            pieces.append(b"BLOCK")
             pieces.append(str(block))
         if noack:
-            pieces.append(b'NOACK')
+            pieces.append(b"NOACK")
         if not isinstance(streams, dict) or len(streams) == 0:
-            raise DataError('XREADGROUP streams must be a non empty dict')
-        pieces.append(b'STREAMS')
+            raise DataError("XREADGROUP streams must be a non empty dict")
+        pieces.append(b"STREAMS")
         pieces.extend(streams.keys())
         pieces.extend(streams.values())
-        return self.execute_command('XREADGROUP', *pieces)
+        return self.execute_command("XREADGROUP", *pieces)
 
-    def xrevrange(self, name, max='+', min='-', count=None):
+    def xrevrange(self, name, max="+", min="-", count=None):
         """
         Read stream values within an interval, in reverse order.
         name: name of the stream
@@ -2693,14 +2810,13 @@ def xrevrange(self, name, max='+', min='-', count=None):
         pieces = [max, min]
         if count is not None:
             if not isinstance(count, int) or count < 1:
-                raise DataError('XREVRANGE count must be a positive integer')
-            pieces.append(b'COUNT')
+                raise DataError("XREVRANGE count must be a positive integer")
+            pieces.append(b"COUNT")
             pieces.append(str(count))
 
-        return self.execute_command('XREVRANGE', name, *pieces)
+        return self.execute_command("XREVRANGE", name, *pieces)
 
-    def xtrim(self, name, maxlen=None, approximate=True, minid=None,
-              limit=None):
+    def xtrim(self, name, maxlen=None, approximate=True, minid=None, limit=None):
         """
         Trims old messages from a stream.
         name: name of the stream.
@@ -2715,15 +2831,14 @@ def xtrim(self, name, maxlen=None, approximate=True, minid=None,
         """
         pieces = []
         if maxlen is not None and minid is not None:
-            raise DataError("Only one of ``maxlen`` or ``minid`` "
-                            "may be specified")
+            raise DataError("Only one of ``maxlen`` or ``minid`` " "may be specified")
 
         if maxlen is not None:
-            pieces.append(b'MAXLEN')
+            pieces.append(b"MAXLEN")
         if minid is not None:
-            pieces.append(b'MINID')
+            pieces.append(b"MINID")
         if approximate:
-            pieces.append(b'~')
+            pieces.append(b"~")
         if maxlen is not None:
             pieces.append(maxlen)
         if minid is not None:
@@ -2732,7 +2847,7 @@ def xtrim(self, name, maxlen=None, approximate=True, minid=None,
             pieces.append(b"LIMIT")
             pieces.append(limit)
 
-        return self.execute_command('XTRIM', name, *pieces)
+        return self.execute_command("XTRIM", name, *pieces)
 
 
 class SortedSetCommands:
@@ -2740,8 +2855,10 @@ class SortedSetCommands:
     Redis commands for Sorted Sets data type.
     see: https://redis.io/topics/data-types-intro#redis-sorted-sets
     """
-    def zadd(self, name, mapping, nx=False, xx=False, ch=False, incr=False,
-             gt=None, lt=None):
+
+    def zadd(
+        self, name, mapping, nx=False, xx=False, ch=False, incr=False, gt=None, lt=None
+    ):
         """
         Set any number of element-name, score pairs to the key ``name``. Pairs
         are specified as a dict of element-names keys to score values.
@@ -2780,30 +2897,32 @@ def zadd(self, name, mapping, nx=False, xx=False, ch=False, incr=False,
         if nx and xx:
             raise DataError("ZADD allows either 'nx' or 'xx', not both")
         if incr and len(mapping) != 1:
-            raise DataError("ZADD option 'incr' only works when passing a "
-                            "single element/score pair")
+            raise DataError(
+                "ZADD option 'incr' only works when passing a "
+                "single element/score pair"
+            )
         if nx is True and (gt is not None or lt is not None):
             raise DataError("Only one of 'nx', 'lt', or 'gr' may be defined.")
 
         pieces = []
         options = {}
         if nx:
-            pieces.append(b'NX')
+            pieces.append(b"NX")
         if xx:
-            pieces.append(b'XX')
+            pieces.append(b"XX")
         if ch:
-            pieces.append(b'CH')
+            pieces.append(b"CH")
         if incr:
-            pieces.append(b'INCR')
-            options['as_score'] = True
+            pieces.append(b"INCR")
+            options["as_score"] = True
         if gt:
-            pieces.append(b'GT')
+            pieces.append(b"GT")
         if lt:
-            pieces.append(b'LT')
+            pieces.append(b"LT")
         for pair in mapping.items():
             pieces.append(pair[1])
             pieces.append(pair[0])
-        return self.execute_command('ZADD', name, *pieces, **options)
+        return self.execute_command("ZADD", name, *pieces, **options)
 
     def zcard(self, name):
         """
@@ -2811,7 +2930,7 @@ def zcard(self, name):
 
         For more information check https://redis.io/commands/zcard
         """
-        return self.execute_command('ZCARD', name)
+        return self.execute_command("ZCARD", name)
 
     def zcount(self, name, min, max):
         """
@@ -2820,7 +2939,7 @@ def zcount(self, name, min, max):
 
         For more information check https://redis.io/commands/zcount
         """
-        return self.execute_command('ZCOUNT', name, min, max)
+        return self.execute_command("ZCOUNT", name, min, max)
 
     def zdiff(self, keys, withscores=False):
         """
@@ -2850,7 +2969,7 @@ def zincrby(self, name, amount, value):
 
         For more information check https://redis.io/commands/zincrby
         """
-        return self.execute_command('ZINCRBY', name, amount, value)
+        return self.execute_command("ZINCRBY", name, amount, value)
 
     def zinter(self, keys, aggregate=None, withscores=False):
         """
@@ -2864,8 +2983,7 @@ def zinter(self, keys, aggregate=None, withscores=False):
 
         For more information check https://redis.io/commands/zinter
         """
-        return self._zaggregate('ZINTER', None, keys, aggregate,
-                                withscores=withscores)
+        return self._zaggregate("ZINTER", None, keys, aggregate, withscores=withscores)
 
     def zinterstore(self, dest, keys, aggregate=None):
         """
@@ -2879,7 +2997,7 @@ def zinterstore(self, dest, keys, aggregate=None):
 
         For more information check https://redis.io/commands/zinterstore
         """
-        return self._zaggregate('ZINTERSTORE', dest, keys, aggregate)
+        return self._zaggregate("ZINTERSTORE", dest, keys, aggregate)
 
     def zlexcount(self, name, min, max):
         """
@@ -2888,7 +3006,7 @@ def zlexcount(self, name, min, max):
 
         For more information check https://redis.io/commands/zlexcount
         """
-        return self.execute_command('ZLEXCOUNT', name, min, max)
+        return self.execute_command("ZLEXCOUNT", name, min, max)
 
     def zpopmax(self, name, count=None):
         """
@@ -2898,10 +3016,8 @@ def zpopmax(self, name, count=None):
         For more information check https://redis.io/commands/zpopmax
         """
         args = (count is not None) and [count] or []
-        options = {
-            'withscores': True
-        }
-        return self.execute_command('ZPOPMAX', name, *args, **options)
+        options = {"withscores": True}
+        return self.execute_command("ZPOPMAX", name, *args, **options)
 
     def zpopmin(self, name, count=None):
         """
@@ -2911,10 +3027,8 @@ def zpopmin(self, name, count=None):
         For more information check https://redis.io/commands/zpopmin
         """
         args = (count is not None) and [count] or []
-        options = {
-            'withscores': True
-        }
-        return self.execute_command('ZPOPMIN', name, *args, **options)
+        options = {"withscores": True}
+        return self.execute_command("ZPOPMIN", name, *args, **options)
 
     def zrandmember(self, key, count=None, withscores=False):
         """
@@ -2957,7 +3071,7 @@ def bzpopmax(self, keys, timeout=0):
             timeout = 0
         keys = list_or_args(keys, None)
         keys.append(timeout)
-        return self.execute_command('BZPOPMAX', *keys)
+        return self.execute_command("BZPOPMAX", *keys)
 
     def bzpopmin(self, keys, timeout=0):
         """
@@ -2976,43 +3090,63 @@ def bzpopmin(self, keys, timeout=0):
             timeout = 0
         keys = list_or_args(keys, None)
         keys.append(timeout)
-        return self.execute_command('BZPOPMIN', *keys)
-
-    def _zrange(self, command, dest, name, start, end, desc=False,
-                byscore=False, bylex=False, withscores=False,
-                score_cast_func=float, offset=None, num=None):
+        return self.execute_command("BZPOPMIN", *keys)
+
+    def _zrange(
+        self,
+        command,
+        dest,
+        name,
+        start,
+        end,
+        desc=False,
+        byscore=False,
+        bylex=False,
+        withscores=False,
+        score_cast_func=float,
+        offset=None,
+        num=None,
+    ):
         if byscore and bylex:
-            raise DataError("``byscore`` and ``bylex`` can not be "
-                            "specified together.")
-        if (offset is not None and num is None) or \
-                (num is not None and offset is None):
+            raise DataError(
+                "``byscore`` and ``bylex`` can not be " "specified together."
+            )
+        if (offset is not None and num is None) or (num is not None and offset is None):
             raise DataError("``offset`` and ``num`` must both be specified.")
         if bylex and withscores:
-            raise DataError("``withscores`` not supported in combination "
-                            "with ``bylex``.")
+            raise DataError(
+                "``withscores`` not supported in combination " "with ``bylex``."
+            )
         pieces = [command]
         if dest:
             pieces.append(dest)
         pieces.extend([name, start, end])
         if byscore:
-            pieces.append('BYSCORE')
+            pieces.append("BYSCORE")
         if bylex:
-            pieces.append('BYLEX')
+            pieces.append("BYLEX")
         if desc:
-            pieces.append('REV')
+            pieces.append("REV")
         if offset is not None and num is not None:
-            pieces.extend(['LIMIT', offset, num])
+            pieces.extend(["LIMIT", offset, num])
         if withscores:
-            pieces.append('WITHSCORES')
-        options = {
-            'withscores': withscores,
-            'score_cast_func': score_cast_func
-        }
+            pieces.append("WITHSCORES")
+        options = {"withscores": withscores, "score_cast_func": score_cast_func}
         return self.execute_command(*pieces, **options)
 
-    def zrange(self, name, start, end, desc=False, withscores=False,
-               score_cast_func=float, byscore=False, bylex=False,
-               offset=None, num=None):
+    def zrange(
+        self,
+        name,
+        start,
+        end,
+        desc=False,
+        withscores=False,
+        score_cast_func=float,
+        byscore=False,
+        bylex=False,
+        offset=None,
+        num=None,
+    ):
         """
         Return a range of values from sorted set ``name`` between
         ``start`` and ``end`` sorted in ascending order.
@@ -3043,16 +3177,25 @@ def zrange(self, name, start, end, desc=False, withscores=False,
         """
         # Need to support ``desc`` also when using old redis version
         # because it was supported in 3.5.3 (of redis-py)
-        if not byscore and not bylex and (offset is None and num is None) \
-                and desc:
-            return self.zrevrange(name, start, end, withscores,
-                                  score_cast_func)
-
-        return self._zrange('ZRANGE', None, name, start, end, desc, byscore,
-                            bylex, withscores, score_cast_func, offset, num)
+        if not byscore and not bylex and (offset is None and num is None) and desc:
+            return self.zrevrange(name, start, end, withscores, score_cast_func)
+
+        return self._zrange(
+            "ZRANGE",
+            None,
+            name,
+            start,
+            end,
+            desc,
+            byscore,
+            bylex,
+            withscores,
+            score_cast_func,
+            offset,
+            num,
+        )
 
-    def zrevrange(self, name, start, end, withscores=False,
-                  score_cast_func=float):
+    def zrevrange(self, name, start, end, withscores=False, score_cast_func=float):
         """
         Return a range of values from sorted set ``name`` between
         ``start`` and ``end`` sorted in descending order.
@@ -3066,18 +3209,24 @@ def zrevrange(self, name, start, end, withscores=False,
 
         For more information check https://redis.io/commands/zrevrange
         """
-        pieces = ['ZREVRANGE', name, start, end]
+        pieces = ["ZREVRANGE", name, start, end]
         if withscores:
-            pieces.append(b'WITHSCORES')
-        options = {
-            'withscores': withscores,
-            'score_cast_func': score_cast_func
-        }
+            pieces.append(b"WITHSCORES")
+        options = {"withscores": withscores, "score_cast_func": score_cast_func}
         return self.execute_command(*pieces, **options)
 
-    def zrangestore(self, dest, name, start, end,
-                    byscore=False, bylex=False, desc=False,
-                    offset=None, num=None):
+    def zrangestore(
+        self,
+        dest,
+        name,
+        start,
+        end,
+        byscore=False,
+        bylex=False,
+        desc=False,
+        offset=None,
+        num=None,
+    ):
         """
         Stores in ``dest`` the result of a range of values from sorted set
         ``name`` between ``start`` and ``end`` sorted in ascending order.
@@ -3101,8 +3250,20 @@ def zrangestore(self, dest, name, start, end,
 
         For more information check https://redis.io/commands/zrangestore
         """
-        return self._zrange('ZRANGESTORE', dest, name, start, end, desc,
-                            byscore, bylex, False, None, offset, num)
+        return self._zrange(
+            "ZRANGESTORE",
+            dest,
+            name,
+            start,
+            end,
+            desc,
+            byscore,
+            bylex,
+            False,
+            None,
+            offset,
+            num,
+        )
 
     def zrangebylex(self, name, min, max, start=None, num=None):
         """
@@ -3114,12 +3275,11 @@ def zrangebylex(self, name, min, max, start=None, num=None):
 
         For more information check https://redis.io/commands/zrangebylex
         """
-        if (start is not None and num is None) or \
-                (num is not None and start is None):
+        if (start is not None and num is None) or (num is not None and start is None):
             raise DataError("``start`` and ``num`` must both be specified")
-        pieces = ['ZRANGEBYLEX', name, min, max]
+        pieces = ["ZRANGEBYLEX", name, min, max]
         if start is not None and num is not None:
-            pieces.extend([b'LIMIT', start, num])
+            pieces.extend([b"LIMIT", start, num])
         return self.execute_command(*pieces)
 
     def zrevrangebylex(self, name, max, min, start=None, num=None):
@@ -3132,16 +3292,23 @@ def zrevrangebylex(self, name, max, min, start=None, num=None):
 
         For more information check https://redis.io/commands/zrevrangebylex
         """
-        if (start is not None and num is None) or \
-                (num is not None and start is None):
+        if (start is not None and num is None) or (num is not None and start is None):
             raise DataError("``start`` and ``num`` must both be specified")
-        pieces = ['ZREVRANGEBYLEX', name, max, min]
+        pieces = ["ZREVRANGEBYLEX", name, max, min]
         if start is not None and num is not None:
-            pieces.extend(['LIMIT', start, num])
+            pieces.extend(["LIMIT", start, num])
         return self.execute_command(*pieces)
 
-    def zrangebyscore(self, name, min, max, start=None, num=None,
-                      withscores=False, score_cast_func=float):
+    def zrangebyscore(
+        self,
+        name,
+        min,
+        max,
+        start=None,
+        num=None,
+        withscores=False,
+        score_cast_func=float,
+    ):
         """
         Return a range of values from the sorted set ``name`` with scores
         between ``min`` and ``max``.
@@ -3156,22 +3323,26 @@ def zrangebyscore(self, name, min, max, start=None, num=None,
 
         For more information check https://redis.io/commands/zrangebyscore
         """
-        if (start is not None and num is None) or \
-                (num is not None and start is None):
+        if (start is not None and num is None) or (num is not None and start is None):
             raise DataError("``start`` and ``num`` must both be specified")
-        pieces = ['ZRANGEBYSCORE', name, min, max]
+        pieces = ["ZRANGEBYSCORE", name, min, max]
         if start is not None and num is not None:
-            pieces.extend(['LIMIT', start, num])
+            pieces.extend(["LIMIT", start, num])
         if withscores:
-            pieces.append('WITHSCORES')
-        options = {
-            'withscores': withscores,
-            'score_cast_func': score_cast_func
-        }
+            pieces.append("WITHSCORES")
+        options = {"withscores": withscores, "score_cast_func": score_cast_func}
         return self.execute_command(*pieces, **options)
 
-    def zrevrangebyscore(self, name, max, min, start=None, num=None,
-                         withscores=False, score_cast_func=float):
+    def zrevrangebyscore(
+        self,
+        name,
+        max,
+        min,
+        start=None,
+        num=None,
+        withscores=False,
+        score_cast_func=float,
+    ):
         """
         Return a range of values from the sorted set ``name`` with scores
         between ``min`` and ``max`` in descending order.
@@ -3186,18 +3357,14 @@ def zrevrangebyscore(self, name, max, min, start=None, num=None,
 
         For more information check https://redis.io/commands/zrevrangebyscore
         """
-        if (start is not None and num is None) or \
-                (num is not None and start is None):
+        if (start is not None and num is None) or (num is not None and start is None):
             raise DataError("``start`` and ``num`` must both be specified")
-        pieces = ['ZREVRANGEBYSCORE', name, max, min]
+        pieces = ["ZREVRANGEBYSCORE", name, max, min]
         if start is not None and num is not None:
-            pieces.extend(['LIMIT', start, num])
+            pieces.extend(["LIMIT", start, num])
         if withscores:
-            pieces.append('WITHSCORES')
-        options = {
-            'withscores': withscores,
-            'score_cast_func': score_cast_func
-        }
+            pieces.append("WITHSCORES")
+        options = {"withscores": withscores, "score_cast_func": score_cast_func}
         return self.execute_command(*pieces, **options)
 
     def zrank(self, name, value):
@@ -3207,7 +3374,7 @@ def zrank(self, name, value):
 
         For more information check https://redis.io/commands/zrank
         """
-        return self.execute_command('ZRANK', name, value)
+        return self.execute_command("ZRANK", name, value)
 
     def zrem(self, name, *values):
         """
@@ -3215,7 +3382,7 @@ def zrem(self, name, *values):
 
         For more information check https://redis.io/commands/zrem
         """
-        return self.execute_command('ZREM', name, *values)
+        return self.execute_command("ZREM", name, *values)
 
     def zremrangebylex(self, name, min, max):
         """
@@ -3226,7 +3393,7 @@ def zremrangebylex(self, name, min, max):
 
         For more information check https://redis.io/commands/zremrangebylex
         """
-        return self.execute_command('ZREMRANGEBYLEX', name, min, max)
+        return self.execute_command("ZREMRANGEBYLEX", name, min, max)
 
     def zremrangebyrank(self, name, min, max):
         """
@@ -3237,7 +3404,7 @@ def zremrangebyrank(self, name, min, max):
 
         For more information check https://redis.io/commands/zremrangebyrank
         """
-        return self.execute_command('ZREMRANGEBYRANK', name, min, max)
+        return self.execute_command("ZREMRANGEBYRANK", name, min, max)
 
     def zremrangebyscore(self, name, min, max):
         """
@@ -3246,7 +3413,7 @@ def zremrangebyscore(self, name, min, max):
 
         For more information check https://redis.io/commands/zremrangebyscore
         """
-        return self.execute_command('ZREMRANGEBYSCORE', name, min, max)
+        return self.execute_command("ZREMRANGEBYSCORE", name, min, max)
 
     def zrevrank(self, name, value):
         """
@@ -3255,7 +3422,7 @@ def zrevrank(self, name, value):
 
         For more information check https://redis.io/commands/zrevrank
         """
-        return self.execute_command('ZREVRANK', name, value)
+        return self.execute_command("ZREVRANK", name, value)
 
     def zscore(self, name, value):
         """
@@ -3263,7 +3430,7 @@ def zscore(self, name, value):
 
         For more information check https://redis.io/commands/zscore
         """
-        return self.execute_command('ZSCORE', name, value)
+        return self.execute_command("ZSCORE", name, value)
 
     def zunion(self, keys, aggregate=None, withscores=False):
         """
@@ -3274,8 +3441,7 @@ def zunion(self, keys, aggregate=None, withscores=False):
 
         For more information check https://redis.io/commands/zunion
         """
-        return self._zaggregate('ZUNION', None, keys, aggregate,
-                                withscores=withscores)
+        return self._zaggregate("ZUNION", None, keys, aggregate, withscores=withscores)
 
     def zunionstore(self, dest, keys, aggregate=None):
         """
@@ -3285,7 +3451,7 @@ def zunionstore(self, dest, keys, aggregate=None):
 
         For more information check https://redis.io/commands/zunionstore
         """
-        return self._zaggregate('ZUNIONSTORE', dest, keys, aggregate)
+        return self._zaggregate("ZUNIONSTORE", dest, keys, aggregate)
 
     def zmscore(self, key, members):
         """
@@ -3299,12 +3465,11 @@ def zmscore(self, key, members):
         For more information check https://redis.io/commands/zmscore
         """
         if not members:
-            raise DataError('ZMSCORE members must be a non-empty list')
+            raise DataError("ZMSCORE members must be a non-empty list")
         pieces = [key] + members
-        return self.execute_command('ZMSCORE', *pieces)
+        return self.execute_command("ZMSCORE", *pieces)
 
-    def _zaggregate(self, command, dest, keys, aggregate=None,
-                    **options):
+    def _zaggregate(self, command, dest, keys, aggregate=None, **options):
         pieces = [command]
         if dest is not None:
             pieces.append(dest)
@@ -3315,16 +3480,16 @@ def _zaggregate(self, command, dest, keys, aggregate=None,
             weights = None
         pieces.extend(keys)
         if weights:
-            pieces.append(b'WEIGHTS')
+            pieces.append(b"WEIGHTS")
             pieces.extend(weights)
         if aggregate:
-            if aggregate.upper() in ['SUM', 'MIN', 'MAX']:
-                pieces.append(b'AGGREGATE')
+            if aggregate.upper() in ["SUM", "MIN", "MAX"]:
+                pieces.append(b"AGGREGATE")
                 pieces.append(aggregate)
             else:
                 raise DataError("aggregate can be sum, min or max.")
-        if options.get('withscores', False):
-            pieces.append(b'WITHSCORES')
+        if options.get("withscores", False):
+            pieces.append(b"WITHSCORES")
         return self.execute_command(*pieces, **options)
 
 
@@ -3333,13 +3498,14 @@ class HyperlogCommands:
     Redis commands of HyperLogLogs data type.
     see: https://redis.io/topics/data-types-intro#hyperloglogs
     """
+
     def pfadd(self, name, *values):
         """
         Adds the specified elements to the specified HyperLogLog.
 
         For more information check https://redis.io/commands/pfadd
         """
-        return self.execute_command('PFADD', name, *values)
+        return self.execute_command("PFADD", name, *values)
 
     def pfcount(self, *sources):
         """
@@ -3348,7 +3514,7 @@ def pfcount(self, *sources):
 
         For more information check https://redis.io/commands/pfcount
         """
-        return self.execute_command('PFCOUNT', *sources)
+        return self.execute_command("PFCOUNT", *sources)
 
     def pfmerge(self, dest, *sources):
         """
@@ -3356,7 +3522,7 @@ def pfmerge(self, dest, *sources):
 
         For more information check https://redis.io/commands/pfmerge
         """
-        return self.execute_command('PFMERGE', dest, *sources)
+        return self.execute_command("PFMERGE", dest, *sources)
 
 
 class HashCommands:
@@ -3364,13 +3530,14 @@ class HashCommands:
     Redis commands for Hash data type.
     see: https://redis.io/topics/data-types-intro#redis-hashes
     """
+
     def hdel(self, name, *keys):
         """
         Delete ``keys`` from hash ``name``
 
         For more information check https://redis.io/commands/hdel
         """
-        return self.execute_command('HDEL', name, *keys)
+        return self.execute_command("HDEL", name, *keys)
 
     def hexists(self, name, key):
         """
@@ -3378,7 +3545,7 @@ def hexists(self, name, key):
 
         For more information check https://redis.io/commands/hexists
         """
-        return self.execute_command('HEXISTS', name, key)
+        return self.execute_command("HEXISTS", name, key)
 
     def hget(self, name, key):
         """
@@ -3386,7 +3553,7 @@ def hget(self, name, key):
 
         For more information check https://redis.io/commands/hget
         """
-        return self.execute_command('HGET', name, key)
+        return self.execute_command("HGET", name, key)
 
     def hgetall(self, name):
         """
@@ -3394,7 +3561,7 @@ def hgetall(self, name):
 
         For more information check https://redis.io/commands/hgetall
         """
-        return self.execute_command('HGETALL', name)
+        return self.execute_command("HGETALL", name)
 
     def hincrby(self, name, key, amount=1):
         """
@@ -3402,7 +3569,7 @@ def hincrby(self, name, key, amount=1):
 
         For more information check https://redis.io/commands/hincrby
         """
-        return self.execute_command('HINCRBY', name, key, amount)
+        return self.execute_command("HINCRBY", name, key, amount)
 
     def hincrbyfloat(self, name, key, amount=1.0):
         """
@@ -3410,7 +3577,7 @@ def hincrbyfloat(self, name, key, amount=1.0):
 
         For more information check https://redis.io/commands/hincrbyfloat
         """
-        return self.execute_command('HINCRBYFLOAT', name, key, amount)
+        return self.execute_command("HINCRBYFLOAT", name, key, amount)
 
     def hkeys(self, name):
         """
@@ -3418,7 +3585,7 @@ def hkeys(self, name):
 
         For more information check https://redis.io/commands/hkeys
         """
-        return self.execute_command('HKEYS', name)
+        return self.execute_command("HKEYS", name)
 
     def hlen(self, name):
         """
@@ -3426,7 +3593,7 @@ def hlen(self, name):
 
         For more information check https://redis.io/commands/hlen
         """
-        return self.execute_command('HLEN', name)
+        return self.execute_command("HLEN", name)
 
     def hset(self, name, key=None, value=None, mapping=None):
         """
@@ -3446,7 +3613,7 @@ def hset(self, name, key=None, value=None, mapping=None):
             for pair in mapping.items():
                 items.extend(pair)
 
-        return self.execute_command('HSET', name, *items)
+        return self.execute_command("HSET", name, *items)
 
     def hsetnx(self, name, key, value):
         """
@@ -3455,7 +3622,7 @@ def hsetnx(self, name, key, value):
 
         For more information check https://redis.io/commands/hsetnx
         """
-        return self.execute_command('HSETNX', name, key, value)
+        return self.execute_command("HSETNX", name, key, value)
 
     def hmset(self, name, mapping):
         """
@@ -3465,8 +3632,8 @@ def hmset(self, name, mapping):
         For more information check https://redis.io/commands/hmset
         """
         warnings.warn(
-            f'{self.__class__.__name__}.hmset() is deprecated. '
-            f'Use {self.__class__.__name__}.hset() instead.',
+            f"{self.__class__.__name__}.hmset() is deprecated. "
+            f"Use {self.__class__.__name__}.hset() instead.",
             DeprecationWarning,
             stacklevel=2,
         )
@@ -3475,7 +3642,7 @@ def hmset(self, name, mapping):
         items = []
         for pair in mapping.items():
             items.extend(pair)
-        return self.execute_command('HMSET', name, *items)
+        return self.execute_command("HMSET", name, *items)
 
     def hmget(self, name, keys, *args):
         """
@@ -3484,7 +3651,7 @@ def hmget(self, name, keys, *args):
         For more information check https://redis.io/commands/hmget
         """
         args = list_or_args(keys, args)
-        return self.execute_command('HMGET', name, *args)
+        return self.execute_command("HMGET", name, *args)
 
     def hvals(self, name):
         """
@@ -3492,7 +3659,7 @@ def hvals(self, name):
 
         For more information check https://redis.io/commands/hvals
         """
-        return self.execute_command('HVALS', name)
+        return self.execute_command("HVALS", name)
 
     def hstrlen(self, name, key):
         """
@@ -3501,7 +3668,7 @@ def hstrlen(self, name, key):
 
         For more information check https://redis.io/commands/hstrlen
         """
-        return self.execute_command('HSTRLEN', name, key)
+        return self.execute_command("HSTRLEN", name, key)
 
 
 class PubSubCommands:
@@ -3509,6 +3676,7 @@ class PubSubCommands:
     Redis PubSub commands.
     see https://redis.io/topics/pubsub
     """
+
     def publish(self, channel, message):
         """
         Publish ``message`` on ``channel``.
@@ -3516,15 +3684,15 @@ def publish(self, channel, message):
 
         For more information check https://redis.io/commands/publish
         """
-        return self.execute_command('PUBLISH', channel, message)
+        return self.execute_command("PUBLISH", channel, message)
 
-    def pubsub_channels(self, pattern='*'):
+    def pubsub_channels(self, pattern="*"):
         """
         Return a list of channels that have at least one subscriber
 
         For more information check https://redis.io/commands/pubsub-channels
         """
-        return self.execute_command('PUBSUB CHANNELS', pattern)
+        return self.execute_command("PUBSUB CHANNELS", pattern)
 
     def pubsub_numpat(self):
         """
@@ -3532,7 +3700,7 @@ def pubsub_numpat(self):
 
         For more information check https://redis.io/commands/pubsub-numpat
         """
-        return self.execute_command('PUBSUB NUMPAT')
+        return self.execute_command("PUBSUB NUMPAT")
 
     def pubsub_numsub(self, *args):
         """
@@ -3541,7 +3709,7 @@ def pubsub_numsub(self, *args):
 
         For more information check https://redis.io/commands/pubsub-numsub
         """
-        return self.execute_command('PUBSUB NUMSUB', *args)
+        return self.execute_command("PUBSUB NUMSUB", *args)
 
 
 class ScriptCommands:
@@ -3549,6 +3717,7 @@ class ScriptCommands:
     Redis Lua script commands. see:
     https://redis.com/ebook/part-3-next-steps/chapter-11-scripting-redis-with-lua/
     """
+
     def eval(self, script, numkeys, *keys_and_args):
         """
         Execute the Lua ``script``, specifying the ``numkeys`` the script
@@ -3560,7 +3729,7 @@ def eval(self, script, numkeys, *keys_and_args):
 
         For more information check  https://redis.io/commands/eval
         """
-        return self.execute_command('EVAL', script, numkeys, *keys_and_args)
+        return self.execute_command("EVAL", script, numkeys, *keys_and_args)
 
     def evalsha(self, sha, numkeys, *keys_and_args):
         """
@@ -3574,7 +3743,7 @@ def evalsha(self, sha, numkeys, *keys_and_args):
 
         For more information check  https://redis.io/commands/evalsha
         """
-        return self.execute_command('EVALSHA', sha, numkeys, *keys_and_args)
+        return self.execute_command("EVALSHA", sha, numkeys, *keys_and_args)
 
     def script_exists(self, *args):
         """
@@ -3584,7 +3753,7 @@ def script_exists(self, *args):
 
         For more information check  https://redis.io/commands/script-exists
         """
-        return self.execute_command('SCRIPT EXISTS', *args)
+        return self.execute_command("SCRIPT EXISTS", *args)
 
     def script_debug(self, *args):
         raise NotImplementedError(
@@ -3600,14 +3769,16 @@ def script_flush(self, sync_type=None):
 
         # Redis pre 6 had no sync_type.
         if sync_type not in ["SYNC", "ASYNC", None]:
-            raise DataError("SCRIPT FLUSH defaults to SYNC in redis > 6.2, or "
-                            "accepts SYNC/ASYNC. For older versions, "
-                            "of redis leave as None.")
+            raise DataError(
+                "SCRIPT FLUSH defaults to SYNC in redis > 6.2, or "
+                "accepts SYNC/ASYNC. For older versions, "
+                "of redis leave as None."
+            )
         if sync_type is None:
             pieces = []
         else:
             pieces = [sync_type]
-        return self.execute_command('SCRIPT FLUSH', *pieces)
+        return self.execute_command("SCRIPT FLUSH", *pieces)
 
     def script_kill(self):
         """
@@ -3615,7 +3786,7 @@ def script_kill(self):
 
         For more information check https://redis.io/commands/script-kill
         """
-        return self.execute_command('SCRIPT KILL')
+        return self.execute_command("SCRIPT KILL")
 
     def script_load(self, script):
         """
@@ -3623,7 +3794,7 @@ def script_load(self, script):
 
         For more information check https://redis.io/commands/script-load
         """
-        return self.execute_command('SCRIPT LOAD', script)
+        return self.execute_command("SCRIPT LOAD", script)
 
     def register_script(self, script):
         """
@@ -3640,6 +3811,7 @@ class GeoCommands:
     Redis Geospatial commands.
     see: https://redis.com/redis-best-practices/indexing-patterns/geospatial/
     """
+
     def geoadd(self, name, values, nx=False, xx=False, ch=False):
         """
         Add the specified geospatial items to the specified key identified
@@ -3664,17 +3836,16 @@ def geoadd(self, name, values, nx=False, xx=False, ch=False):
         if nx and xx:
             raise DataError("GEOADD allows either 'nx' or 'xx', not both")
         if len(values) % 3 != 0:
-            raise DataError("GEOADD requires places with lon, lat and name"
-                            " values")
+            raise DataError("GEOADD requires places with lon, lat and name" " values")
         pieces = [name]
         if nx:
-            pieces.append('NX')
+            pieces.append("NX")
         if xx:
-            pieces.append('XX')
+            pieces.append("XX")
         if ch:
-            pieces.append('CH')
+            pieces.append("CH")
         pieces.extend(values)
-        return self.execute_command('GEOADD', *pieces)
+        return self.execute_command("GEOADD", *pieces)
 
     def geodist(self, name, place1, place2, unit=None):
         """
@@ -3686,11 +3857,11 @@ def geodist(self, name, place1, place2, unit=None):
         For more information check https://redis.io/commands/geodist
         """
         pieces = [name, place1, place2]
-        if unit and unit not in ('m', 'km', 'mi', 'ft'):
+        if unit and unit not in ("m", "km", "mi", "ft"):
             raise DataError("GEODIST invalid unit")
         elif unit:
             pieces.append(unit)
-        return self.execute_command('GEODIST', *pieces)
+        return self.execute_command("GEODIST", *pieces)
 
     def geohash(self, name, *values):
         """
@@ -3699,7 +3870,7 @@ def geohash(self, name, *values):
 
         For more information check https://redis.io/commands/geohash
         """
-        return self.execute_command('GEOHASH', name, *values)
+        return self.execute_command("GEOHASH", name, *values)
 
     def geopos(self, name, *values):
         """
@@ -3709,11 +3880,24 @@ def geopos(self, name, *values):
 
         For more information check https://redis.io/commands/geopos
         """
-        return self.execute_command('GEOPOS', name, *values)
-
-    def georadius(self, name, longitude, latitude, radius, unit=None,
-                  withdist=False, withcoord=False, withhash=False, count=None,
-                  sort=None, store=None, store_dist=None, any=False):
+        return self.execute_command("GEOPOS", name, *values)
+
+    def georadius(
+        self,
+        name,
+        longitude,
+        latitude,
+        radius,
+        unit=None,
+        withdist=False,
+        withcoord=False,
+        withhash=False,
+        count=None,
+        sort=None,
+        store=None,
+        store_dist=None,
+        any=False,
+    ):
         """
         Return the members of the specified key identified by the
         ``name`` argument which are within the borders of the area specified
@@ -3744,17 +3928,38 @@ def georadius(self, name, longitude, latitude, radius, unit=None,
 
         For more information check https://redis.io/commands/georadius
         """
-        return self._georadiusgeneric('GEORADIUS',
-                                      name, longitude, latitude, radius,
-                                      unit=unit, withdist=withdist,
-                                      withcoord=withcoord, withhash=withhash,
-                                      count=count, sort=sort, store=store,
-                                      store_dist=store_dist, any=any)
+        return self._georadiusgeneric(
+            "GEORADIUS",
+            name,
+            longitude,
+            latitude,
+            radius,
+            unit=unit,
+            withdist=withdist,
+            withcoord=withcoord,
+            withhash=withhash,
+            count=count,
+            sort=sort,
+            store=store,
+            store_dist=store_dist,
+            any=any,
+        )
 
-    def georadiusbymember(self, name, member, radius, unit=None,
-                          withdist=False, withcoord=False, withhash=False,
-                          count=None, sort=None, store=None, store_dist=None,
-                          any=False):
+    def georadiusbymember(
+        self,
+        name,
+        member,
+        radius,
+        unit=None,
+        withdist=False,
+        withcoord=False,
+        withhash=False,
+        count=None,
+        sort=None,
+        store=None,
+        store_dist=None,
+        any=False,
+    ):
         """
         This command is exactly like ``georadius`` with the sole difference
         that instead of taking, as the center of the area to query, a longitude
@@ -3763,61 +3968,85 @@ def georadiusbymember(self, name, member, radius, unit=None,
 
         For more information check https://redis.io/commands/georadiusbymember
         """
-        return self._georadiusgeneric('GEORADIUSBYMEMBER',
-                                      name, member, radius, unit=unit,
-                                      withdist=withdist, withcoord=withcoord,
-                                      withhash=withhash, count=count,
-                                      sort=sort, store=store,
-                                      store_dist=store_dist, any=any)
+        return self._georadiusgeneric(
+            "GEORADIUSBYMEMBER",
+            name,
+            member,
+            radius,
+            unit=unit,
+            withdist=withdist,
+            withcoord=withcoord,
+            withhash=withhash,
+            count=count,
+            sort=sort,
+            store=store,
+            store_dist=store_dist,
+            any=any,
+        )
 
     def _georadiusgeneric(self, command, *args, **kwargs):
         pieces = list(args)
-        if kwargs['unit'] and kwargs['unit'] not in ('m', 'km', 'mi', 'ft'):
+        if kwargs["unit"] and kwargs["unit"] not in ("m", "km", "mi", "ft"):
             raise DataError("GEORADIUS invalid unit")
-        elif kwargs['unit']:
-            pieces.append(kwargs['unit'])
+        elif kwargs["unit"]:
+            pieces.append(kwargs["unit"])
         else:
-            pieces.append('m',)
+            pieces.append(
+                "m",
+            )
 
-        if kwargs['any'] and kwargs['count'] is None:
+        if kwargs["any"] and kwargs["count"] is None:
             raise DataError("``any`` can't be provided without ``count``")
 
         for arg_name, byte_repr in (
-                ('withdist', 'WITHDIST'),
-                ('withcoord', 'WITHCOORD'),
-                ('withhash', 'WITHHASH')):
+            ("withdist", "WITHDIST"),
+            ("withcoord", "WITHCOORD"),
+            ("withhash", "WITHHASH"),
+        ):
             if kwargs[arg_name]:
                 pieces.append(byte_repr)
 
-        if kwargs['count'] is not None:
-            pieces.extend(['COUNT', kwargs['count']])
-            if kwargs['any']:
-                pieces.append('ANY')
+        if kwargs["count"] is not None:
+            pieces.extend(["COUNT", kwargs["count"]])
+            if kwargs["any"]:
+                pieces.append("ANY")
 
-        if kwargs['sort']:
-            if kwargs['sort'] == 'ASC':
-                pieces.append('ASC')
-            elif kwargs['sort'] == 'DESC':
-                pieces.append('DESC')
+        if kwargs["sort"]:
+            if kwargs["sort"] == "ASC":
+                pieces.append("ASC")
+            elif kwargs["sort"] == "DESC":
+                pieces.append("DESC")
             else:
                 raise DataError("GEORADIUS invalid sort")
 
-        if kwargs['store'] and kwargs['store_dist']:
-            raise DataError("GEORADIUS store and store_dist cant be set"
-                            " together")
+        if kwargs["store"] and kwargs["store_dist"]:
+            raise DataError("GEORADIUS store and store_dist cant be set" " together")
 
-        if kwargs['store']:
-            pieces.extend([b'STORE', kwargs['store']])
+        if kwargs["store"]:
+            pieces.extend([b"STORE", kwargs["store"]])
 
-        if kwargs['store_dist']:
-            pieces.extend([b'STOREDIST', kwargs['store_dist']])
+        if kwargs["store_dist"]:
+            pieces.extend([b"STOREDIST", kwargs["store_dist"]])
 
         return self.execute_command(command, *pieces, **kwargs)
 
-    def geosearch(self, name, member=None, longitude=None, latitude=None,
-                  unit='m', radius=None, width=None, height=None, sort=None,
-                  count=None, any=False, withcoord=False,
-                  withdist=False, withhash=False):
+    def geosearch(
+        self,
+        name,
+        member=None,
+        longitude=None,
+        latitude=None,
+        unit="m",
+        radius=None,
+        width=None,
+        height=None,
+        sort=None,
+        count=None,
+        any=False,
+        withcoord=False,
+        withdist=False,
+        withhash=False,
+    ):
         """
         Return the members of specified key identified by the
         ``name`` argument, which are within the borders of the
@@ -3853,19 +4082,42 @@ def geosearch(self, name, member=None, longitude=None, latitude=None,
         For more information check https://redis.io/commands/geosearch
         """
 
-        return self._geosearchgeneric('GEOSEARCH',
-                                      name, member=member, longitude=longitude,
-                                      latitude=latitude, unit=unit,
-                                      radius=radius, width=width,
-                                      height=height, sort=sort, count=count,
-                                      any=any, withcoord=withcoord,
-                                      withdist=withdist, withhash=withhash,
-                                      store=None, store_dist=None)
+        return self._geosearchgeneric(
+            "GEOSEARCH",
+            name,
+            member=member,
+            longitude=longitude,
+            latitude=latitude,
+            unit=unit,
+            radius=radius,
+            width=width,
+            height=height,
+            sort=sort,
+            count=count,
+            any=any,
+            withcoord=withcoord,
+            withdist=withdist,
+            withhash=withhash,
+            store=None,
+            store_dist=None,
+        )
 
-    def geosearchstore(self, dest, name, member=None, longitude=None,
-                       latitude=None, unit='m', radius=None, width=None,
-                       height=None, sort=None, count=None, any=False,
-                       storedist=False):
+    def geosearchstore(
+        self,
+        dest,
+        name,
+        member=None,
+        longitude=None,
+        latitude=None,
+        unit="m",
+        radius=None,
+        width=None,
+        height=None,
+        sort=None,
+        count=None,
+        any=False,
+        storedist=False,
+    ):
         """
         This command is like GEOSEARCH, but stores the result in
         ``dest``. By default, it stores the results in the destination
@@ -3876,74 +4128,86 @@ def geosearchstore(self, dest, name, member=None, longitude=None,
 
         For more information check https://redis.io/commands/geosearchstore
         """
-        return self._geosearchgeneric('GEOSEARCHSTORE',
-                                      dest, name, member=member,
-                                      longitude=longitude, latitude=latitude,
-                                      unit=unit, radius=radius, width=width,
-                                      height=height, sort=sort, count=count,
-                                      any=any, withcoord=None,
-                                      withdist=None, withhash=None,
-                                      store=None, store_dist=storedist)
+        return self._geosearchgeneric(
+            "GEOSEARCHSTORE",
+            dest,
+            name,
+            member=member,
+            longitude=longitude,
+            latitude=latitude,
+            unit=unit,
+            radius=radius,
+            width=width,
+            height=height,
+            sort=sort,
+            count=count,
+            any=any,
+            withcoord=None,
+            withdist=None,
+            withhash=None,
+            store=None,
+            store_dist=storedist,
+        )
 
     def _geosearchgeneric(self, command, *args, **kwargs):
         pieces = list(args)
 
         # FROMMEMBER or FROMLONLAT
-        if kwargs['member'] is None:
-            if kwargs['longitude'] is None or kwargs['latitude'] is None:
-                raise DataError("GEOSEARCH must have member or"
-                                " longitude and latitude")
-        if kwargs['member']:
-            if kwargs['longitude'] or kwargs['latitude']:
-                raise DataError("GEOSEARCH member and longitude or latitude"
-                                " cant be set together")
-            pieces.extend([b'FROMMEMBER', kwargs['member']])
-        if kwargs['longitude'] and kwargs['latitude']:
-            pieces.extend([b'FROMLONLAT',
-                           kwargs['longitude'], kwargs['latitude']])
+        if kwargs["member"] is None:
+            if kwargs["longitude"] is None or kwargs["latitude"] is None:
+                raise DataError(
+                    "GEOSEARCH must have member or" " longitude and latitude"
+                )
+        if kwargs["member"]:
+            if kwargs["longitude"] or kwargs["latitude"]:
+                raise DataError(
+                    "GEOSEARCH member and longitude or latitude" " cant be set together"
+                )
+            pieces.extend([b"FROMMEMBER", kwargs["member"]])
+        if kwargs["longitude"] and kwargs["latitude"]:
+            pieces.extend([b"FROMLONLAT", kwargs["longitude"], kwargs["latitude"]])
 
         # BYRADIUS or BYBOX
-        if kwargs['radius'] is None:
-            if kwargs['width'] is None or kwargs['height'] is None:
-                raise DataError("GEOSEARCH must have radius or"
-                                " width and height")
-        if kwargs['unit'] is None:
+        if kwargs["radius"] is None:
+            if kwargs["width"] is None or kwargs["height"] is None:
+                raise DataError("GEOSEARCH must have radius or" " width and height")
+        if kwargs["unit"] is None:
             raise DataError("GEOSEARCH must have unit")
-        if kwargs['unit'].lower() not in ('m', 'km', 'mi', 'ft'):
+        if kwargs["unit"].lower() not in ("m", "km", "mi", "ft"):
             raise DataError("GEOSEARCH invalid unit")
-        if kwargs['radius']:
-            if kwargs['width'] or kwargs['height']:
-                raise DataError("GEOSEARCH radius and width or height"
-                                " cant be set together")
-            pieces.extend([b'BYRADIUS', kwargs['radius'], kwargs['unit']])
-        if kwargs['width'] and kwargs['height']:
-            pieces.extend([b'BYBOX',
-                           kwargs['width'], kwargs['height'], kwargs['unit']])
+        if kwargs["radius"]:
+            if kwargs["width"] or kwargs["height"]:
+                raise DataError(
+                    "GEOSEARCH radius and width or height" " cant be set together"
+                )
+            pieces.extend([b"BYRADIUS", kwargs["radius"], kwargs["unit"]])
+        if kwargs["width"] and kwargs["height"]:
+            pieces.extend([b"BYBOX", kwargs["width"], kwargs["height"], kwargs["unit"]])
 
         # sort
-        if kwargs['sort']:
-            if kwargs['sort'].upper() == 'ASC':
-                pieces.append(b'ASC')
-            elif kwargs['sort'].upper() == 'DESC':
-                pieces.append(b'DESC')
+        if kwargs["sort"]:
+            if kwargs["sort"].upper() == "ASC":
+                pieces.append(b"ASC")
+            elif kwargs["sort"].upper() == "DESC":
+                pieces.append(b"DESC")
             else:
                 raise DataError("GEOSEARCH invalid sort")
 
         # count any
-        if kwargs['count']:
-            pieces.extend([b'COUNT', kwargs['count']])
-            if kwargs['any']:
-                pieces.append(b'ANY')
-        elif kwargs['any']:
-            raise DataError("GEOSEARCH ``any`` can't be provided "
-                            "without count")
+        if kwargs["count"]:
+            pieces.extend([b"COUNT", kwargs["count"]])
+            if kwargs["any"]:
+                pieces.append(b"ANY")
+        elif kwargs["any"]:
+            raise DataError("GEOSEARCH ``any`` can't be provided " "without count")
 
         # other properties
         for arg_name, byte_repr in (
-                ('withdist', b'WITHDIST'),
-                ('withcoord', b'WITHCOORD'),
-                ('withhash', b'WITHHASH'),
-                ('store_dist', b'STOREDIST')):
+            ("withdist", b"WITHDIST"),
+            ("withcoord", b"WITHCOORD"),
+            ("withhash", b"WITHHASH"),
+            ("store_dist", b"STOREDIST"),
+        ):
             if kwargs[arg_name]:
                 pieces.append(byte_repr)
 
@@ -3955,6 +4219,7 @@ class ModuleCommands:
     Redis Module commands.
     see: https://redis.io/topics/modules-intro
     """
+
     def module_load(self, path, *args):
         """
         Loads the module from ``path``.
@@ -3963,7 +4228,7 @@ def module_load(self, path, *args):
 
         For more information check https://redis.io/commands/module-load
         """
-        return self.execute_command('MODULE LOAD', path, *args)
+        return self.execute_command("MODULE LOAD", path, *args)
 
     def module_unload(self, name):
         """
@@ -3972,7 +4237,7 @@ def module_unload(self, name):
 
         For more information check https://redis.io/commands/module-unload
         """
-        return self.execute_command('MODULE UNLOAD', name)
+        return self.execute_command("MODULE UNLOAD", name)
 
     def module_list(self):
         """
@@ -3981,7 +4246,7 @@ def module_list(self):
 
         For more information check https://redis.io/commands/module-list
         """
-        return self.execute_command('MODULE LIST')
+        return self.execute_command("MODULE LIST")
 
     def command_info(self):
         raise NotImplementedError(
@@ -3989,13 +4254,13 @@ def command_info(self):
         )
 
     def command_count(self):
-        return self.execute_command('COMMAND COUNT')
+        return self.execute_command("COMMAND COUNT")
 
     def command_getkeys(self, *args):
-        return self.execute_command('COMMAND GETKEYS', *args)
+        return self.execute_command("COMMAND GETKEYS", *args)
 
     def command(self):
-        return self.execute_command('COMMAND')
+        return self.execute_command("COMMAND")
 
 
 class Script:
@@ -4022,6 +4287,7 @@ def __call__(self, keys=[], args=[], client=None):
         args = tuple(keys) + tuple(args)
         # make sure the Redis server knows about the script
         from redis.client import Pipeline
+
         if isinstance(client, Pipeline):
             # Make sure the pipeline can register the script before executing.
             client.scripts.add(self)
@@ -4039,6 +4305,7 @@ class BitFieldOperation:
     """
     Command builder for BITFIELD commands.
     """
+
     def __init__(self, client, key, default_overflow=None):
         self.client = client
         self.key = key
@@ -4050,7 +4317,7 @@ def reset(self):
         Reset the state of the instance to when it was constructed
         """
         self.operations = []
-        self._last_overflow = 'WRAP'
+        self._last_overflow = "WRAP"
         self.overflow(self._default_overflow or self._last_overflow)
 
     def overflow(self, overflow):
@@ -4063,7 +4330,7 @@ def overflow(self, overflow):
         overflow = overflow.upper()
         if overflow != self._last_overflow:
             self._last_overflow = overflow
-            self.operations.append(('OVERFLOW', overflow))
+            self.operations.append(("OVERFLOW", overflow))
         return self
 
     def incrby(self, fmt, offset, increment, overflow=None):
@@ -4083,7 +4350,7 @@ def incrby(self, fmt, offset, increment, overflow=None):
         if overflow is not None:
             self.overflow(overflow)
 
-        self.operations.append(('INCRBY', fmt, offset, increment))
+        self.operations.append(("INCRBY", fmt, offset, increment))
         return self
 
     def get(self, fmt, offset):
@@ -4096,7 +4363,7 @@ def get(self, fmt, offset):
             fmt='u8', offset='#2', the offset will be 16.
         :returns: a :py:class:`BitFieldOperation` instance.
         """
-        self.operations.append(('GET', fmt, offset))
+        self.operations.append(("GET", fmt, offset))
         return self
 
     def set(self, fmt, offset, value):
@@ -4110,12 +4377,12 @@ def set(self, fmt, offset, value):
         :param int value: value to set at the given position.
         :returns: a :py:class:`BitFieldOperation` instance.
         """
-        self.operations.append(('SET', fmt, offset, value))
+        self.operations.append(("SET", fmt, offset, value))
         return self
 
     @property
     def command(self):
-        cmd = ['BITFIELD', self.key]
+        cmd = ["BITFIELD", self.key]
         for ops in self.operations:
             cmd.extend(ops)
         return cmd
@@ -4132,19 +4399,31 @@ def execute(self):
         return self.client.execute_command(*command)
 
 
-class DataAccessCommands(BasicKeyCommands, ListCommands,
-                         ScanCommands, SetCommands, StreamCommands,
-                         SortedSetCommands,
-                         HyperlogCommands, HashCommands, GeoCommands,
-                         ):
+class DataAccessCommands(
+    BasicKeyCommands,
+    ListCommands,
+    ScanCommands,
+    SetCommands,
+    StreamCommands,
+    SortedSetCommands,
+    HyperlogCommands,
+    HashCommands,
+    GeoCommands,
+):
     """
     A class containing all of the implemented data access redis commands.
     This class is to be used as a mixin.
     """
 
 
-class CoreCommands(ACLCommands, DataAccessCommands, ManagementCommands,
-                   ModuleCommands, PubSubCommands, ScriptCommands):
+class CoreCommands(
+    ACLCommands,
+    DataAccessCommands,
+    ManagementCommands,
+    ModuleCommands,
+    PubSubCommands,
+    ScriptCommands,
+):
     """
     A class containing all of the implemented redis commands. This class is
     to be used as a mixin.
diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
index dc5705b80b..80dfd76a15 100644
--- a/redis/commands/helpers.py
+++ b/redis/commands/helpers.py
@@ -22,7 +22,7 @@ def list_or_args(keys, args):
 def nativestr(x):
     """Return the decoded binary string, or a string, depending on type."""
     r = x.decode("utf-8", "replace") if isinstance(x, bytes) else x
-    if r == 'null':
+    if r == "null":
         return
     return r
 
@@ -58,14 +58,14 @@ def parse_list_to_dict(response):
     res = {}
     for i in range(0, len(response), 2):
         if isinstance(response[i], list):
-            res['Child iterators'].append(parse_list_to_dict(response[i]))
-        elif isinstance(response[i+1], list):
-            res['Child iterators'] = [parse_list_to_dict(response[i+1])]
+            res["Child iterators"].append(parse_list_to_dict(response[i]))
+        elif isinstance(response[i + 1], list):
+            res["Child iterators"] = [parse_list_to_dict(response[i + 1])]
         else:
             try:
-                res[response[i]] = float(response[i+1])
+                res[response[i]] = float(response[i + 1])
             except (TypeError, ValueError):
-                res[response[i]] = response[i+1]
+                res[response[i]] = response[i + 1]
     return res
 
 
diff --git a/redis/commands/json/__init__.py b/redis/commands/json/__init__.py
index d634dbd3f4..12c0648722 100644
--- a/redis/commands/json/__init__.py
+++ b/redis/commands/json/__init__.py
@@ -1,12 +1,10 @@
-from json import JSONDecoder, JSONEncoder, JSONDecodeError
+from json import JSONDecodeError, JSONDecoder, JSONEncoder
+
+import redis
 
-from .decoders import (
-    decode_list,
-    bulk_of_jsons,
-)
 from ..helpers import nativestr
 from .commands import JSONCommands
-import redis
+from .decoders import bulk_of_jsons, decode_list
 
 
 class JSON(JSONCommands):
diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index 1affaafaf6..e7f07b612f 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -1,8 +1,10 @@
-from .path import Path
-from .decoders import decode_dict_keys
 from deprecated import deprecated
+
 from redis.exceptions import DataError
 
+from .decoders import decode_dict_keys
+from .path import Path
+
 
 class JSONCommands:
     """json commands."""
@@ -29,8 +31,7 @@ def arrindex(self, name, path, scalar, start=0, stop=-1):
         For more information: https://oss.redis.com/redisjson/commands/#jsonarrindex
         """  # noqa
         return self.execute_command(
-            "JSON.ARRINDEX", name, str(path), self._encode(scalar),
-            start, stop
+            "JSON.ARRINDEX", name, str(path), self._encode(scalar), start, stop
         )
 
     def arrinsert(self, name, path, index, *args):
@@ -66,8 +67,7 @@ def arrtrim(self, name, path, start, stop):
 
         For more information: https://oss.redis.com/redisjson/commands/#jsonarrtrim
         """  # noqa
-        return self.execute_command("JSON.ARRTRIM", name, str(path),
-                                    start, stop)
+        return self.execute_command("JSON.ARRTRIM", name, str(path), start, stop)
 
     def type(self, name, path=Path.rootPath()):
         """Get the type of the JSON value under ``path`` from key ``name``.
@@ -109,7 +109,7 @@ def numincrby(self, name, path, number):
             "JSON.NUMINCRBY", name, str(path), self._encode(number)
         )
 
-    @deprecated(version='4.0.0', reason='deprecated since redisjson 1.0.0')
+    @deprecated(version="4.0.0", reason="deprecated since redisjson 1.0.0")
     def nummultby(self, name, path, number):
         """Multiply the numeric (integer or floating point) JSON value under
         ``path`` at key ``name`` with the provided ``number``.
@@ -218,7 +218,7 @@ def strlen(self, name, path=None):
         ``name``.
 
         For more information: https://oss.redis.com/redisjson/commands/#jsonstrlen
-        """   # noqa
+        """  # noqa
         pieces = [name]
         if path is not None:
             pieces.append(str(path))
@@ -240,9 +240,7 @@ def strappend(self, name, value, path=Path.rootPath()):
         For more information: https://oss.redis.com/redisjson/commands/#jsonstrappend
         """  # noqa
         pieces = [name, str(path), self._encode(value)]
-        return self.execute_command(
-            "JSON.STRAPPEND", *pieces
-        )
+        return self.execute_command("JSON.STRAPPEND", *pieces)
 
     def debug(self, subcommand, key=None, path=Path.rootPath()):
         """Return the memory usage in bytes of a value under ``path`` from
@@ -252,8 +250,7 @@ def debug(self, subcommand, key=None, path=Path.rootPath()):
         """  # noqa
         valid_subcommands = ["MEMORY", "HELP"]
         if subcommand not in valid_subcommands:
-            raise DataError("The only valid subcommands are ",
-                            str(valid_subcommands))
+            raise DataError("The only valid subcommands are ", str(valid_subcommands))
         pieces = [subcommand]
         if subcommand == "MEMORY":
             if key is None:
@@ -262,17 +259,20 @@ def debug(self, subcommand, key=None, path=Path.rootPath()):
             pieces.append(str(path))
         return self.execute_command("JSON.DEBUG", *pieces)
 
-    @deprecated(version='4.0.0',
-                reason='redisjson-py supported this, call get directly.')
+    @deprecated(
+        version="4.0.0", reason="redisjson-py supported this, call get directly."
+    )
     def jsonget(self, *args, **kwargs):
         return self.get(*args, **kwargs)
 
-    @deprecated(version='4.0.0',
-                reason='redisjson-py supported this, call get directly.')
+    @deprecated(
+        version="4.0.0", reason="redisjson-py supported this, call get directly."
+    )
     def jsonmget(self, *args, **kwargs):
         return self.mget(*args, **kwargs)
 
-    @deprecated(version='4.0.0',
-                reason='redisjson-py supported this, call get directly.')
+    @deprecated(
+        version="4.0.0", reason="redisjson-py supported this, call get directly."
+    )
     def jsonset(self, *args, **kwargs):
         return self.set(*args, **kwargs)
diff --git a/redis/commands/json/decoders.py b/redis/commands/json/decoders.py
index b19395c73b..b93847112b 100644
--- a/redis/commands/json/decoders.py
+++ b/redis/commands/json/decoders.py
@@ -1,6 +1,7 @@
-from ..helpers import nativestr
-import re
 import copy
+import re
+
+from ..helpers import nativestr
 
 
 def bulk_of_jsons(d):
@@ -33,7 +34,7 @@ def unstring(obj):
     One can't simply call int/float in a try/catch because there is a
     semantic difference between (for example) 15.0 and 15.
     """
-    floatreg = '^\\d+.\\d+$'
+    floatreg = "^\\d+.\\d+$"
     match = re.findall(floatreg, obj)
     if match != []:
         return float(match[0])
diff --git a/redis/commands/parser.py b/redis/commands/parser.py
index 26b190c674..dadf3c6bf8 100644
--- a/redis/commands/parser.py
+++ b/redis/commands/parser.py
@@ -1,7 +1,4 @@
-from redis.exceptions import (
-    RedisError,
-    ResponseError
-)
+from redis.exceptions import RedisError, ResponseError
 from redis.utils import str_if_bytes
 
 
@@ -13,6 +10,7 @@ class CommandsParser:
     'movablekeys', and these commands' keys are determined by the command
     'COMMAND GETKEYS'.
     """
+
     def __init__(self, redis_connection):
         self.initialized = False
         self.commands = {}
@@ -51,20 +49,24 @@ def get_keys(self, redis_conn, *args):
                     )
 
         command = self.commands.get(cmd_name)
-        if 'movablekeys' in command['flags']:
+        if "movablekeys" in command["flags"]:
             keys = self._get_moveable_keys(redis_conn, *args)
-        elif 'pubsub' in command['flags']:
+        elif "pubsub" in command["flags"]:
             keys = self._get_pubsub_keys(*args)
         else:
-            if command['step_count'] == 0 and command['first_key_pos'] == 0 \
-                    and command['last_key_pos'] == 0:
+            if (
+                command["step_count"] == 0
+                and command["first_key_pos"] == 0
+                and command["last_key_pos"] == 0
+            ):
                 # The command doesn't have keys in it
                 return None
-            last_key_pos = command['last_key_pos']
+            last_key_pos = command["last_key_pos"]
             if last_key_pos < 0:
                 last_key_pos = len(args) - abs(last_key_pos)
-            keys_pos = list(range(command['first_key_pos'], last_key_pos + 1,
-                                  command['step_count']))
+            keys_pos = list(
+                range(command["first_key_pos"], last_key_pos + 1, command["step_count"])
+            )
             keys = [args[pos] for pos in keys_pos]
 
         return keys
@@ -77,11 +79,13 @@ def _get_moveable_keys(self, redis_conn, *args):
         pieces = pieces + cmd_name.split()
         pieces = pieces + list(args[1:])
         try:
-            keys = redis_conn.execute_command('COMMAND GETKEYS', *pieces)
+            keys = redis_conn.execute_command("COMMAND GETKEYS", *pieces)
         except ResponseError as e:
             message = e.__str__()
-            if 'Invalid arguments' in message or \
-                    'The command has no key arguments' in message:
+            if (
+                "Invalid arguments" in message
+                or "The command has no key arguments" in message
+            ):
                 return None
             else:
                 raise e
@@ -99,18 +103,17 @@ def _get_pubsub_keys(self, *args):
             return None
         args = [str_if_bytes(arg) for arg in args]
         command = args[0].upper()
-        if command == 'PUBSUB':
+        if command == "PUBSUB":
             # the second argument is a part of the command name, e.g.
             # ['PUBSUB', 'NUMSUB', 'foo'].
             pubsub_type = args[1].upper()
-            if pubsub_type in ['CHANNELS', 'NUMSUB']:
+            if pubsub_type in ["CHANNELS", "NUMSUB"]:
                 keys = args[2:]
-        elif command in ['SUBSCRIBE', 'PSUBSCRIBE', 'UNSUBSCRIBE',
-                         'PUNSUBSCRIBE']:
+        elif command in ["SUBSCRIBE", "PSUBSCRIBE", "UNSUBSCRIBE", "PUNSUBSCRIBE"]:
             # format example:
             # SUBSCRIBE channel [channel ...]
             keys = list(args[1:])
-        elif command == 'PUBLISH':
+        elif command == "PUBLISH":
             # format example:
             # PUBLISH channel message
             keys = [args[1]]
diff --git a/redis/commands/redismodules.py b/redis/commands/redismodules.py
index 5f629fb5ea..2420d7b6fb 100644
--- a/redis/commands/redismodules.py
+++ b/redis/commands/redismodules.py
@@ -1,4 +1,4 @@
-from json import JSONEncoder, JSONDecoder
+from json import JSONDecoder, JSONEncoder
 
 
 class RedisModuleCommands:
@@ -7,21 +7,18 @@ class RedisModuleCommands:
     """
 
     def json(self, encoder=JSONEncoder(), decoder=JSONDecoder()):
-        """Access the json namespace, providing support for redis json.
-        """
+        """Access the json namespace, providing support for redis json."""
 
         from .json import JSON
-        jj = JSON(
-                client=self,
-                encoder=encoder,
-                decoder=decoder)
+
+        jj = JSON(client=self, encoder=encoder, decoder=decoder)
         return jj
 
     def ft(self, index_name="idx"):
-        """Access the search namespace, providing support for redis search.
-        """
+        """Access the search namespace, providing support for redis search."""
 
         from .search import Search
+
         s = Search(client=self, index_name=index_name)
         return s
 
@@ -31,5 +28,6 @@ def ts(self):
         """
 
         from .timeseries import TimeSeries
+
         s = TimeSeries(client=self)
         return s
diff --git a/redis/commands/search/__init__.py b/redis/commands/search/__init__.py
index a30cebe1b7..94bc037c3d 100644
--- a/redis/commands/search/__init__.py
+++ b/redis/commands/search/__init__.py
@@ -35,7 +35,7 @@ def add_document(
             replace=False,
             partial=False,
             no_create=False,
-            **fields
+            **fields,
         ):
             """
             Add a document to the batch query
@@ -49,7 +49,7 @@ def add_document(
                 replace=replace,
                 partial=partial,
                 no_create=no_create,
-                **fields
+                **fields,
             )
             self.current_chunk += 1
             self.total += 1
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 553bc39839..4ec6fc9dfa 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -1,13 +1,13 @@
 import itertools
 import time
 
-from .document import Document
-from .result import Result
-from .query import Query
+from ..helpers import parse_to_dict
 from ._util import to_string
 from .aggregation import AggregateRequest, AggregateResult, Cursor
+from .document import Document
+from .query import Query
+from .result import Result
 from .suggestion import SuggestionParser
-from ..helpers import parse_to_dict
 
 NUMERIC = "NUMERIC"
 
@@ -148,7 +148,7 @@ def _add_document(
         partial=False,
         language=None,
         no_create=False,
-        **fields
+        **fields,
     ):
         """
         Internal add_document used for both batch and single doc indexing
@@ -211,7 +211,7 @@ def add_document(
         partial=False,
         language=None,
         no_create=False,
-        **fields
+        **fields,
     ):
         """
         Add a single document to the index.
@@ -253,7 +253,7 @@ def add_document(
             partial=partial,
             language=language,
             no_create=no_create,
-            **fields
+            **fields,
         )
 
     def add_document_hash(
@@ -274,7 +274,7 @@ def add_document_hash(
         - **replace**: if True, and the document already is in the index, we
                       perform an update and reindex the document
         - **language**: Specify the language used for document tokenization.
-        
+
         For more information: https://oss.redis.com/redisearch/Commands/#ftaddhash
         """  # noqa
         return self._add_document_hash(
@@ -294,7 +294,7 @@ def delete_document(self, doc_id, conn=None, delete_actual_document=False):
 
         - **delete_actual_document**: if set to True, RediSearch also delete
                                       the actual document if it is in the index
-                                      
+
         For more information: https://oss.redis.com/redisearch/Commands/#ftdel
         """  # noqa
         args = [DEL_CMD, self.index_name, doc_id]
@@ -453,7 +453,7 @@ def profile(self, query, limited=False):
         cmd = [PROFILE_CMD, self.index_name, ""]
         if limited:
             cmd.append("LIMITED")
-        cmd.append('QUERY')
+        cmd.append("QUERY")
 
         if isinstance(query, AggregateRequest):
             cmd[2] = "AGGREGATE"
@@ -462,19 +462,20 @@ def profile(self, query, limited=False):
             cmd[2] = "SEARCH"
             cmd += query.get_args()
         else:
-            raise ValueError("Must provide AggregateRequest object or "
-                             "Query object.")
+            raise ValueError("Must provide AggregateRequest object or " "Query object.")
 
         res = self.execute_command(*cmd)
 
         if isinstance(query, AggregateRequest):
             result = self._get_AggregateResult(res[0], query, query._cursor)
         else:
-            result = Result(res[0],
-                            not query._no_content,
-                            duration=(time.time() - st) * 1000.0,
-                            has_payload=query._with_payloads,
-                            with_scores=query._with_scores,)
+            result = Result(
+                res[0],
+                not query._no_content,
+                duration=(time.time() - st) * 1000.0,
+                has_payload=query._with_payloads,
+                with_scores=query._with_scores,
+            )
 
         return result, parse_to_dict(res[1])
 
@@ -535,8 +536,7 @@ def spellcheck(self, query, distance=None, include=None, exclude=None):
             #     ]
             # }
             corrections[_correction[1]] = [
-                {"score": _item[0], "suggestion": _item[1]}
-                for _item in _correction[2]
+                {"score": _item[0], "suggestion": _item[1]} for _item in _correction[2]
             ]
 
         return corrections
@@ -704,8 +704,7 @@ def sugdel(self, key, string):
         return self.execute_command(SUGDEL_COMMAND, key, string)
 
     def sugget(
-        self, key, prefix, fuzzy=False, num=10, with_scores=False,
-        with_payloads=False
+        self, key, prefix, fuzzy=False, num=10, with_scores=False, with_payloads=False
     ):
         """
         Get a list of suggestions from the AutoCompleter, for a given prefix.
@@ -769,7 +768,7 @@ def synupdate(self, groupid, skipinitial=False, *terms):
             If set to true, we do not scan and index.
         terms :
             The terms.
-            
+
         For more information: https://oss.redis.com/redisearch/Commands/#ftsynupdate
         """  # noqa
         cmd = [SYNUPDATE_CMD, self.index_name, groupid]
diff --git a/redis/commands/search/field.py b/redis/commands/search/field.py
index 076c872b62..69e39083b0 100644
--- a/redis/commands/search/field.py
+++ b/redis/commands/search/field.py
@@ -9,8 +9,7 @@ class Field:
     NOINDEX = "NOINDEX"
     AS = "AS"
 
-    def __init__(self, name, args=[], sortable=False,
-                 no_index=False, as_name=None):
+    def __init__(self, name, args=[], sortable=False, no_index=False, as_name=None):
         self.name = name
         self.args = args
         self.args_suffix = list()
@@ -47,8 +46,7 @@ class TextField(Field):
     def __init__(
         self, name, weight=1.0, no_stem=False, phonetic_matcher=None, **kwargs
     ):
-        Field.__init__(self, name,
-                       args=[Field.TEXT, Field.WEIGHT, weight], **kwargs)
+        Field.__init__(self, name, args=[Field.TEXT, Field.WEIGHT, weight], **kwargs)
 
         if no_stem:
             Field.append_arg(self, self.NOSTEM)
diff --git a/redis/commands/search/query.py b/redis/commands/search/query.py
index 5534f7b88e..2bb8347dbc 100644
--- a/redis/commands/search/query.py
+++ b/redis/commands/search/query.py
@@ -62,11 +62,9 @@ def return_field(self, field, as_field=None):
     def _mk_field_list(self, fields):
         if not fields:
             return []
-        return  \
-            [fields] if isinstance(fields, str) else list(fields)
+        return [fields] if isinstance(fields, str) else list(fields)
 
-    def summarize(self, fields=None, context_len=None,
-                  num_frags=None, sep=None):
+    def summarize(self, fields=None, context_len=None, num_frags=None, sep=None):
         """
         Return an abridged format of the field, containing only the segments of
         the field which contain the matching term(s).
@@ -300,8 +298,7 @@ class NumericFilter(Filter):
     INF = "+inf"
     NEG_INF = "-inf"
 
-    def __init__(self, field, minval, maxval, minExclusive=False,
-                 maxExclusive=False):
+    def __init__(self, field, minval, maxval, minExclusive=False, maxExclusive=False):
         args = [
             minval if not minExclusive else f"({minval}",
             maxval if not maxExclusive else f"({maxval}",
diff --git a/redis/commands/search/querystring.py b/redis/commands/search/querystring.py
index ffba542e31..1da0387eb8 100644
--- a/redis/commands/search/querystring.py
+++ b/redis/commands/search/querystring.py
@@ -15,8 +15,7 @@ def between(a, b, inclusive_min=True, inclusive_max=True):
     """
     Indicate that value is a numeric range
     """
-    return RangeValue(a, b, inclusive_min=inclusive_min,
-                      inclusive_max=inclusive_max)
+    return RangeValue(a, b, inclusive_min=inclusive_min, inclusive_max=inclusive_max)
 
 
 def equal(n):
@@ -200,9 +199,7 @@ def join_fields(self, key, vals):
             return [BaseNode(f"@{key}:{vals[0].to_string()}")]
         if not vals[0].combinable:
             return [BaseNode(f"@{key}:{v.to_string()}") for v in vals]
-        s = BaseNode(
-            f"@{key}:({self.JOINSTR.join(v.to_string() for v in vals)})"
-        )
+        s = BaseNode(f"@{key}:({self.JOINSTR.join(v.to_string() for v in vals)})")
         return [s]
 
     @classmethod
diff --git a/redis/commands/search/result.py b/redis/commands/search/result.py
index 57ba53d5ca..5f4aca6411 100644
--- a/redis/commands/search/result.py
+++ b/redis/commands/search/result.py
@@ -1,5 +1,5 @@
-from .document import Document
 from ._util import to_string
+from .document import Document
 
 
 class Result:
diff --git a/redis/commands/search/suggestion.py b/redis/commands/search/suggestion.py
index 6d295a652f..5d1eba64b8 100644
--- a/redis/commands/search/suggestion.py
+++ b/redis/commands/search/suggestion.py
@@ -46,8 +46,6 @@ def __init__(self, with_scores, with_payloads, ret):
     def __iter__(self):
         for i in range(0, len(self._sugs), self.sugsize):
             ss = self._sugs[i]
-            score = float(self._sugs[i + self._scoreidx]) \
-                if self.with_scores else 1.0
-            payload = self._sugs[i + self._payloadidx] \
-                if self.with_payloads else None
+            score = float(self._sugs[i + self._scoreidx]) if self.with_scores else 1.0
+            payload = self._sugs[i + self._payloadidx] if self.with_payloads else None
             yield Suggestion(ss, score, payload)
diff --git a/redis/commands/sentinel.py b/redis/commands/sentinel.py
index 1f02984bed..a9b06c2f6e 100644
--- a/redis/commands/sentinel.py
+++ b/redis/commands/sentinel.py
@@ -9,41 +9,39 @@ class SentinelCommands:
 
     def sentinel(self, *args):
         "Redis Sentinel's SENTINEL command."
-        warnings.warn(
-            DeprecationWarning('Use the individual sentinel_* methods'))
+        warnings.warn(DeprecationWarning("Use the individual sentinel_* methods"))
 
     def sentinel_get_master_addr_by_name(self, service_name):
         "Returns a (host, port) pair for the given ``service_name``"
-        return self.execute_command('SENTINEL GET-MASTER-ADDR-BY-NAME',
-                                    service_name)
+        return self.execute_command("SENTINEL GET-MASTER-ADDR-BY-NAME", service_name)
 
     def sentinel_master(self, service_name):
         "Returns a dictionary containing the specified masters state."
-        return self.execute_command('SENTINEL MASTER', service_name)
+        return self.execute_command("SENTINEL MASTER", service_name)
 
     def sentinel_masters(self):
         "Returns a list of dictionaries containing each master's state."
-        return self.execute_command('SENTINEL MASTERS')
+        return self.execute_command("SENTINEL MASTERS")
 
     def sentinel_monitor(self, name, ip, port, quorum):
         "Add a new master to Sentinel to be monitored"
-        return self.execute_command('SENTINEL MONITOR', name, ip, port, quorum)
+        return self.execute_command("SENTINEL MONITOR", name, ip, port, quorum)
 
     def sentinel_remove(self, name):
         "Remove a master from Sentinel's monitoring"
-        return self.execute_command('SENTINEL REMOVE', name)
+        return self.execute_command("SENTINEL REMOVE", name)
 
     def sentinel_sentinels(self, service_name):
         "Returns a list of sentinels for ``service_name``"
-        return self.execute_command('SENTINEL SENTINELS', service_name)
+        return self.execute_command("SENTINEL SENTINELS", service_name)
 
     def sentinel_set(self, name, option, value):
         "Set Sentinel monitoring parameters for a given master"
-        return self.execute_command('SENTINEL SET', name, option, value)
+        return self.execute_command("SENTINEL SET", name, option, value)
 
     def sentinel_slaves(self, service_name):
         "Returns a list of slaves for ``service_name``"
-        return self.execute_command('SENTINEL SLAVES', service_name)
+        return self.execute_command("SENTINEL SLAVES", service_name)
 
     def sentinel_reset(self, pattern):
         """
@@ -54,7 +52,7 @@ def sentinel_reset(self, pattern):
         failover in progress), and removes every slave and sentinel already
         discovered and associated with the master.
         """
-        return self.execute_command('SENTINEL RESET', pattern, once=True)
+        return self.execute_command("SENTINEL RESET", pattern, once=True)
 
     def sentinel_failover(self, new_master_name):
         """
@@ -63,7 +61,7 @@ def sentinel_failover(self, new_master_name):
         configuration will be published so that the other Sentinels will
         update their configurations).
         """
-        return self.execute_command('SENTINEL FAILOVER', new_master_name)
+        return self.execute_command("SENTINEL FAILOVER", new_master_name)
 
     def sentinel_ckquorum(self, new_master_name):
         """
@@ -74,9 +72,7 @@ def sentinel_ckquorum(self, new_master_name):
         This command should be used in monitoring systems to check if a
         Sentinel deployment is ok.
         """
-        return self.execute_command('SENTINEL CKQUORUM',
-                                    new_master_name,
-                                    once=True)
+        return self.execute_command("SENTINEL CKQUORUM", new_master_name, once=True)
 
     def sentinel_flushconfig(self):
         """
@@ -94,4 +90,4 @@ def sentinel_flushconfig(self):
         This command works even if the previous configuration file is
         completely missing.
         """
-        return self.execute_command('SENTINEL FLUSHCONFIG')
+        return self.execute_command("SENTINEL FLUSHCONFIG")
diff --git a/redis/commands/timeseries/__init__.py b/redis/commands/timeseries/__init__.py
index 5ce538f675..5b1f15114d 100644
--- a/redis/commands/timeseries/__init__.py
+++ b/redis/commands/timeseries/__init__.py
@@ -1,19 +1,12 @@
 import redis.client
 
-from .utils import (
-    parse_range,
-    parse_get,
-    parse_m_range,
-    parse_m_get,
-)
-from .info import TSInfo
 from ..helpers import parse_to_list
 from .commands import (
     ALTER_CMD,
     CREATE_CMD,
     CREATERULE_CMD,
-    DELETERULE_CMD,
     DEL_CMD,
+    DELETERULE_CMD,
     GET_CMD,
     INFO_CMD,
     MGET_CMD,
@@ -24,6 +17,8 @@
     REVRANGE_CMD,
     TimeSeriesCommands,
 )
+from .info import TSInfo
+from .utils import parse_get, parse_m_get, parse_m_range, parse_range
 
 
 class TimeSeries(TimeSeriesCommands):
diff --git a/redis/commands/timeseries/commands.py b/redis/commands/timeseries/commands.py
index 460ba766a9..c86e0b98b7 100644
--- a/redis/commands/timeseries/commands.py
+++ b/redis/commands/timeseries/commands.py
@@ -1,6 +1,5 @@
 from redis.exceptions import DataError
 
-
 ADD_CMD = "TS.ADD"
 ALTER_CMD = "TS.ALTER"
 CREATERULE_CMD = "TS.CREATERULE"
@@ -58,7 +57,7 @@ def create(self, key, **kwargs):
             - 'min': only override if the value is lower than the existing value.
             - 'max': only override if the value is higher than the existing value.
             When this is not set, the server-wide default will be used.
-            
+
         For more information: https://oss.redis.com/redistimeseries/commands/#tscreate
         """  # noqa
         retention_msecs = kwargs.get("retention_msecs", None)
@@ -81,7 +80,7 @@ def alter(self, key, **kwargs):
         For more information see
 
         The parameters are the same as TS.CREATE.
-        
+
         For more information: https://oss.redis.com/redistimeseries/commands/#tsalter
         """  # noqa
         retention_msecs = kwargs.get("retention_msecs", None)
@@ -129,7 +128,7 @@ def add(self, key, timestamp, value, **kwargs):
             - 'min': only override if the value is lower than the existing value.
             - 'max': only override if the value is higher than the existing value.
             When this is not set, the server-wide default will be used.
-            
+
         For more information: https://oss.redis.com/redistimeseries/master/commands/#tsadd
         """  # noqa
         retention_msecs = kwargs.get("retention_msecs", None)
@@ -276,13 +275,7 @@ def delete(self, key, from_time, to_time):
         """  # noqa
         return self.execute_command(DEL_CMD, key, from_time, to_time)
 
-    def createrule(
-        self,
-        source_key,
-        dest_key,
-        aggregation_type,
-        bucket_size_msec
-    ):
+    def createrule(self, source_key, dest_key, aggregation_type, bucket_size_msec):
         """
         Create a compaction rule from values added to `source_key` into `dest_key`.
         Aggregating for `bucket_size_msec` where an `aggregation_type` can be
@@ -321,11 +314,7 @@ def __range_params(
         """Create TS.RANGE and TS.REVRANGE arguments."""
         params = [key, from_time, to_time]
         self._appendFilerByTs(params, filter_by_ts)
-        self._appendFilerByValue(
-            params,
-            filter_by_min_value,
-            filter_by_max_value
-        )
+        self._appendFilerByValue(params, filter_by_min_value, filter_by_max_value)
         self._appendCount(params, count)
         self._appendAlign(params, align)
         self._appendAggregation(params, aggregation_type, bucket_size_msec)
@@ -471,11 +460,7 @@ def __mrange_params(
         """Create TS.MRANGE and TS.MREVRANGE arguments."""
         params = [from_time, to_time]
         self._appendFilerByTs(params, filter_by_ts)
-        self._appendFilerByValue(
-            params,
-            filter_by_min_value,
-            filter_by_max_value
-        )
+        self._appendFilerByValue(params, filter_by_min_value, filter_by_max_value)
         self._appendCount(params, count)
         self._appendAlign(params, align)
         self._appendAggregation(params, aggregation_type, bucket_size_msec)
@@ -654,7 +639,7 @@ def mrevrange(
         return self.execute_command(MREVRANGE_CMD, *params)
 
     def get(self, key):
-        """ # noqa
+        """# noqa
         Get the last sample of `key`.
 
         For more information: https://oss.redis.com/redistimeseries/master/commands/#tsget
@@ -662,7 +647,7 @@ def get(self, key):
         return self.execute_command(GET_CMD, key)
 
     def mget(self, filters, with_labels=False):
-        """ # noqa
+        """# noqa
         Get the last samples matching the specific `filter`.
 
         For more information: https://oss.redis.com/redistimeseries/master/commands/#tsmget
@@ -674,7 +659,7 @@ def mget(self, filters, with_labels=False):
         return self.execute_command(MGET_CMD, *params)
 
     def info(self, key):
-        """  # noqa
+        """# noqa
         Get information of `key`.
 
         For more information: https://oss.redis.com/redistimeseries/master/commands/#tsinfo
@@ -682,7 +667,7 @@ def info(self, key):
         return self.execute_command(INFO_CMD, key)
 
     def queryindex(self, filters):
-        """  # noqa
+        """# noqa
         Get all the keys matching the `filter` list.
 
         For more information: https://oss.redis.com/redistimeseries/master/commands/#tsqueryindex
diff --git a/redis/commands/timeseries/info.py b/redis/commands/timeseries/info.py
index 2b8acd1b66..fba7f093b1 100644
--- a/redis/commands/timeseries/info.py
+++ b/redis/commands/timeseries/info.py
@@ -1,5 +1,5 @@
-from .utils import list_to_dict
 from ..helpers import nativestr
+from .utils import list_to_dict
 
 
 class TSInfo:
diff --git a/redis/commands/timeseries/utils.py b/redis/commands/timeseries/utils.py
index c33b7c591e..c49b040271 100644
--- a/redis/commands/timeseries/utils.py
+++ b/redis/commands/timeseries/utils.py
@@ -2,9 +2,7 @@
 
 
 def list_to_dict(aList):
-    return {
-        nativestr(aList[i][0]): nativestr(aList[i][1])
-        for i in range(len(aList))}
+    return {nativestr(aList[i][0]): nativestr(aList[i][1]) for i in range(len(aList))}
 
 
 def parse_range(response):
@@ -16,9 +14,7 @@ def parse_m_range(response):
     """Parse multi range response. Used by TS.MRANGE and TS.MREVRANGE."""
     res = []
     for item in response:
-        res.append(
-            {nativestr(item[0]):
-                [list_to_dict(item[1]), parse_range(item[2])]})
+        res.append({nativestr(item[0]): [list_to_dict(item[1]), parse_range(item[2])]})
     return sorted(res, key=lambda d: list(d.keys()))
 
 
@@ -34,8 +30,7 @@ def parse_m_get(response):
     res = []
     for item in response:
         if not item[2]:
-            res.append(
-                {nativestr(item[0]): [list_to_dict(item[1]), None, None]})
+            res.append({nativestr(item[0]): [list_to_dict(item[1]), None, None]})
         else:
             res.append(
                 {
diff --git a/redis/connection.py b/redis/connection.py
index ef3a667c16..d13fe65ef8 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1,8 +1,3 @@
-from packaging.version import Version
-from itertools import chain
-from time import time
-from queue import LifoQueue, Empty, Full
-from urllib.parse import parse_qs, unquote, urlparse
 import copy
 import errno
 import io
@@ -10,6 +5,12 @@
 import socket
 import threading
 import weakref
+from itertools import chain
+from queue import Empty, Full, LifoQueue
+from time import time
+from urllib.parse import parse_qs, unquote, urlparse
+
+from packaging.version import Version
 
 from redis.backoff import NoBackoff
 from redis.exceptions import (
@@ -21,20 +22,20 @@
     DataError,
     ExecAbortError,
     InvalidResponse,
+    ModuleError,
     NoPermissionError,
     NoScriptError,
     ReadOnlyError,
     RedisError,
     ResponseError,
     TimeoutError,
-    ModuleError,
 )
-
 from redis.retry import Retry
 from redis.utils import HIREDIS_AVAILABLE, str_if_bytes
 
 try:
     import ssl
+
     ssl_available = True
 except ImportError:
     ssl_available = False
@@ -44,7 +45,7 @@
 }
 
 if ssl_available:
-    if hasattr(ssl, 'SSLWantReadError'):
+    if hasattr(ssl, "SSLWantReadError"):
         NONBLOCKING_EXCEPTION_ERROR_NUMBERS[ssl.SSLWantReadError] = 2
         NONBLOCKING_EXCEPTION_ERROR_NUMBERS[ssl.SSLWantWriteError] = 2
     else:
@@ -56,34 +57,31 @@
     import hiredis
 
     hiredis_version = Version(hiredis.__version__)
-    HIREDIS_SUPPORTS_CALLABLE_ERRORS = \
-        hiredis_version >= Version('0.1.3')
-    HIREDIS_SUPPORTS_BYTE_BUFFER = \
-        hiredis_version >= Version('0.1.4')
-    HIREDIS_SUPPORTS_ENCODING_ERRORS = \
-        hiredis_version >= Version('1.0.0')
+    HIREDIS_SUPPORTS_CALLABLE_ERRORS = hiredis_version >= Version("0.1.3")
+    HIREDIS_SUPPORTS_BYTE_BUFFER = hiredis_version >= Version("0.1.4")
+    HIREDIS_SUPPORTS_ENCODING_ERRORS = hiredis_version >= Version("1.0.0")
 
     HIREDIS_USE_BYTE_BUFFER = True
     # only use byte buffer if hiredis supports it
     if not HIREDIS_SUPPORTS_BYTE_BUFFER:
         HIREDIS_USE_BYTE_BUFFER = False
 
-SYM_STAR = b'*'
-SYM_DOLLAR = b'$'
-SYM_CRLF = b'\r\n'
-SYM_EMPTY = b''
+SYM_STAR = b"*"
+SYM_DOLLAR = b"$"
+SYM_CRLF = b"\r\n"
+SYM_EMPTY = b""
 
 SERVER_CLOSED_CONNECTION_ERROR = "Connection closed by server."
 
 SENTINEL = object()
-MODULE_LOAD_ERROR = 'Error loading the extension. ' \
-                    'Please check the server logs.'
-NO_SUCH_MODULE_ERROR = 'Error unloading module: no such module with that name'
-MODULE_UNLOAD_NOT_POSSIBLE_ERROR = 'Error unloading module: operation not ' \
-                                   'possible.'
-MODULE_EXPORTS_DATA_TYPES_ERROR = "Error unloading module: the module " \
-                                  "exports one or more module-side data " \
-                                  "types, can't unload"
+MODULE_LOAD_ERROR = "Error loading the extension. " "Please check the server logs."
+NO_SUCH_MODULE_ERROR = "Error unloading module: no such module with that name"
+MODULE_UNLOAD_NOT_POSSIBLE_ERROR = "Error unloading module: operation not " "possible."
+MODULE_EXPORTS_DATA_TYPES_ERROR = (
+    "Error unloading module: the module "
+    "exports one or more module-side data "
+    "types, can't unload"
+)
 
 
 class Encoder:
@@ -100,15 +98,19 @@ def encode(self, value):
             return value
         elif isinstance(value, bool):
             # special case bool since it is a subclass of int
-            raise DataError("Invalid input of type: 'bool'. Convert to a "
-                            "bytes, string, int or float first.")
+            raise DataError(
+                "Invalid input of type: 'bool'. Convert to a "
+                "bytes, string, int or float first."
+            )
         elif isinstance(value, (int, float)):
             value = repr(value).encode()
         elif not isinstance(value, str):
             # a value we don't know how to deal with. throw an error
             typename = type(value).__name__
-            raise DataError(f"Invalid input of type: '{typename}'. "
-                            f"Convert to a bytes, string, int or float first.")
+            raise DataError(
+                f"Invalid input of type: '{typename}'. "
+                f"Convert to a bytes, string, int or float first."
+            )
         if isinstance(value, str):
             value = value.encode(self.encoding, self.encoding_errors)
         return value
@@ -125,36 +127,36 @@ def decode(self, value, force=False):
 
 class BaseParser:
     EXCEPTION_CLASSES = {
-        'ERR': {
-            'max number of clients reached': ConnectionError,
-            'Client sent AUTH, but no password is set': AuthenticationError,
-            'invalid password': AuthenticationError,
+        "ERR": {
+            "max number of clients reached": ConnectionError,
+            "Client sent AUTH, but no password is set": AuthenticationError,
+            "invalid password": AuthenticationError,
             # some Redis server versions report invalid command syntax
             # in lowercase
-            'wrong number of arguments for \'auth\' command':
-                AuthenticationWrongNumberOfArgsError,
+            "wrong number of arguments "
+            "for 'auth' command": AuthenticationWrongNumberOfArgsError,
             # some Redis server versions report invalid command syntax
             # in uppercase
-            'wrong number of arguments for \'AUTH\' command':
-                AuthenticationWrongNumberOfArgsError,
+            "wrong number of arguments "
+            "for 'AUTH' command": AuthenticationWrongNumberOfArgsError,
             MODULE_LOAD_ERROR: ModuleError,
             MODULE_EXPORTS_DATA_TYPES_ERROR: ModuleError,
             NO_SUCH_MODULE_ERROR: ModuleError,
             MODULE_UNLOAD_NOT_POSSIBLE_ERROR: ModuleError,
         },
-        'EXECABORT': ExecAbortError,
-        'LOADING': BusyLoadingError,
-        'NOSCRIPT': NoScriptError,
-        'READONLY': ReadOnlyError,
-        'NOAUTH': AuthenticationError,
-        'NOPERM': NoPermissionError,
+        "EXECABORT": ExecAbortError,
+        "LOADING": BusyLoadingError,
+        "NOSCRIPT": NoScriptError,
+        "READONLY": ReadOnlyError,
+        "NOAUTH": AuthenticationError,
+        "NOPERM": NoPermissionError,
     }
 
     def parse_error(self, response):
         "Parse an error response"
-        error_code = response.split(' ')[0]
+        error_code = response.split(" ")[0]
         if error_code in self.EXCEPTION_CLASSES:
-            response = response[len(error_code) + 1:]
+            response = response[len(error_code) + 1 :]
             exception_class = self.EXCEPTION_CLASSES[error_code]
             if isinstance(exception_class, dict):
                 exception_class = exception_class.get(response, ResponseError)
@@ -177,8 +179,7 @@ def __init__(self, socket, socket_read_size, socket_timeout):
     def length(self):
         return self.bytes_written - self.bytes_read
 
-    def _read_from_socket(self, length=None, timeout=SENTINEL,
-                          raise_on_timeout=True):
+    def _read_from_socket(self, length=None, timeout=SENTINEL, raise_on_timeout=True):
         sock = self._sock
         socket_read_size = self.socket_read_size
         buf = self._buffer
@@ -220,9 +221,9 @@ def _read_from_socket(self, length=None, timeout=SENTINEL,
                 sock.settimeout(self.socket_timeout)
 
     def can_read(self, timeout):
-        return bool(self.length) or \
-            self._read_from_socket(timeout=timeout,
-                                   raise_on_timeout=False)
+        return bool(self.length) or self._read_from_socket(
+            timeout=timeout, raise_on_timeout=False
+        )
 
     def read(self, length):
         length = length + 2  # make sure to read the \r\n terminator
@@ -283,6 +284,7 @@ def close(self):
 
 class PythonParser(BaseParser):
     "Plain Python parsing class"
+
     def __init__(self, socket_read_size):
         self.socket_read_size = socket_read_size
         self.encoder = None
@@ -298,9 +300,9 @@ def __del__(self):
     def on_connect(self, connection):
         "Called when the socket connects"
         self._sock = connection._sock
-        self._buffer = SocketBuffer(self._sock,
-                                    self.socket_read_size,
-                                    connection.socket_timeout)
+        self._buffer = SocketBuffer(
+            self._sock, self.socket_read_size, connection.socket_timeout
+        )
         self.encoder = connection.encoder
 
     def on_disconnect(self):
@@ -321,12 +323,12 @@ def read_response(self, disable_decoding=False):
 
         byte, response = raw[:1], raw[1:]
 
-        if byte not in (b'-', b'+', b':', b'$', b'*'):
+        if byte not in (b"-", b"+", b":", b"$", b"*"):
             raise InvalidResponse(f"Protocol Error: {raw!r}")
 
         # server returned an error
-        if byte == b'-':
-            response = response.decode('utf-8', errors='replace')
+        if byte == b"-":
+            response = response.decode("utf-8", errors="replace")
             error = self.parse_error(response)
             # if the error is a ConnectionError, raise immediately so the user
             # is notified
@@ -338,24 +340,26 @@ def read_response(self, disable_decoding=False):
             # necessary, so just return the exception instance here.
             return error
         # single value
-        elif byte == b'+':
+        elif byte == b"+":
             pass
         # int value
-        elif byte == b':':
+        elif byte == b":":
             response = int(response)
         # bulk response
-        elif byte == b'$':
+        elif byte == b"$":
             length = int(response)
             if length == -1:
                 return None
             response = self._buffer.read(length)
         # multi-bulk response
-        elif byte == b'*':
+        elif byte == b"*":
             length = int(response)
             if length == -1:
                 return None
-            response = [self.read_response(disable_decoding=disable_decoding)
-                        for i in range(length)]
+            response = [
+                self.read_response(disable_decoding=disable_decoding)
+                for i in range(length)
+            ]
         if isinstance(response, bytes) and disable_decoding is False:
             response = self.encoder.decode(response)
         return response
@@ -363,6 +367,7 @@ def read_response(self, disable_decoding=False):
 
 class HiredisParser(BaseParser):
     "Parser class for connections using Hiredis"
+
     def __init__(self, socket_read_size):
         if not HIREDIS_AVAILABLE:
             raise RedisError("Hiredis is not installed")
@@ -381,18 +386,18 @@ def on_connect(self, connection):
         self._sock = connection._sock
         self._socket_timeout = connection.socket_timeout
         kwargs = {
-            'protocolError': InvalidResponse,
-            'replyError': self.parse_error,
+            "protocolError": InvalidResponse,
+            "replyError": self.parse_error,
         }
 
         # hiredis < 0.1.3 doesn't support functions that create exceptions
         if not HIREDIS_SUPPORTS_CALLABLE_ERRORS:
-            kwargs['replyError'] = ResponseError
+            kwargs["replyError"] = ResponseError
 
         if connection.encoder.decode_responses:
-            kwargs['encoding'] = connection.encoder.encoding
+            kwargs["encoding"] = connection.encoder.encoding
         if HIREDIS_SUPPORTS_ENCODING_ERRORS:
-            kwargs['errors'] = connection.encoder.encoding_errors
+            kwargs["errors"] = connection.encoder.encoding_errors
         self._reader = hiredis.Reader(**kwargs)
         self._next_response = False
 
@@ -408,8 +413,7 @@ def can_read(self, timeout):
         if self._next_response is False:
             self._next_response = self._reader.gets()
             if self._next_response is False:
-                return self.read_from_socket(timeout=timeout,
-                                             raise_on_timeout=False)
+                return self.read_from_socket(timeout=timeout, raise_on_timeout=False)
         return True
 
     def read_from_socket(self, timeout=SENTINEL, raise_on_timeout=True):
@@ -468,16 +472,22 @@ def read_response(self, disable_decoding=False):
         if not HIREDIS_SUPPORTS_CALLABLE_ERRORS:
             if isinstance(response, ResponseError):
                 response = self.parse_error(response.args[0])
-            elif isinstance(response, list) and response and \
-                    isinstance(response[0], ResponseError):
+            elif (
+                isinstance(response, list)
+                and response
+                and isinstance(response[0], ResponseError)
+            ):
                 response[0] = self.parse_error(response[0].args[0])
         # if the response is a ConnectionError or the response is a list and
         # the first item is a ConnectionError, raise it as something bad
         # happened
         if isinstance(response, ConnectionError):
             raise response
-        elif isinstance(response, list) and response and \
-                isinstance(response[0], ConnectionError):
+        elif (
+            isinstance(response, list)
+            and response
+            and isinstance(response[0], ConnectionError)
+        ):
             raise response[0]
         return response
 
@@ -491,14 +501,29 @@ def read_response(self, disable_decoding=False):
 class Connection:
     "Manages TCP communication to and from a Redis server"
 
-    def __init__(self, host='localhost', port=6379, db=0, password=None,
-                 socket_timeout=None, socket_connect_timeout=None,
-                 socket_keepalive=False, socket_keepalive_options=None,
-                 socket_type=0, retry_on_timeout=False, encoding='utf-8',
-                 encoding_errors='strict', decode_responses=False,
-                 parser_class=DefaultParser, socket_read_size=65536,
-                 health_check_interval=0, client_name=None, username=None,
-                 retry=None, redis_connect_func=None):
+    def __init__(
+        self,
+        host="localhost",
+        port=6379,
+        db=0,
+        password=None,
+        socket_timeout=None,
+        socket_connect_timeout=None,
+        socket_keepalive=False,
+        socket_keepalive_options=None,
+        socket_type=0,
+        retry_on_timeout=False,
+        encoding="utf-8",
+        encoding_errors="strict",
+        decode_responses=False,
+        parser_class=DefaultParser,
+        socket_read_size=65536,
+        health_check_interval=0,
+        client_name=None,
+        username=None,
+        retry=None,
+        redis_connect_func=None,
+    ):
         """
         Initialize a new Connection.
         To specify a retry policy, first set `retry_on_timeout` to `True`
@@ -536,17 +561,13 @@ def __init__(self, host='localhost', port=6379, db=0, password=None,
         self._buffer_cutoff = 6000
 
     def __repr__(self):
-        repr_args = ','.join([f'{k}={v}' for k, v in self.repr_pieces()])
-        return f'{self.__class__.__name__}<{repr_args}>'
+        repr_args = ",".join([f"{k}={v}" for k, v in self.repr_pieces()])
+        return f"{self.__class__.__name__}<{repr_args}>"
 
     def repr_pieces(self):
-        pieces = [
-            ('host', self.host),
-            ('port', self.port),
-            ('db', self.db)
-        ]
+        pieces = [("host", self.host), ("port", self.port), ("db", self.db)]
         if self.client_name:
-            pieces.append(('client_name', self.client_name))
+            pieces.append(("client_name", self.client_name))
         return pieces
 
     def __del__(self):
@@ -606,8 +627,9 @@ def _connect(self):
         # ipv4/ipv6, but we want to set options prior to calling
         # socket.connect()
         err = None
-        for res in socket.getaddrinfo(self.host, self.port, self.socket_type,
-                                      socket.SOCK_STREAM):
+        for res in socket.getaddrinfo(
+            self.host, self.port, self.socket_type, socket.SOCK_STREAM
+        ):
             family, socktype, proto, canonname, socket_address = res
             sock = None
             try:
@@ -658,12 +680,12 @@ def on_connect(self):
         # if username and/or password are set, authenticate
         if self.username or self.password:
             if self.username:
-                auth_args = (self.username, self.password or '')
+                auth_args = (self.username, self.password or "")
             else:
                 auth_args = (self.password,)
             # avoid checking health here -- PING will fail if we try
             # to check the health prior to the AUTH
-            self.send_command('AUTH', *auth_args, check_health=False)
+            self.send_command("AUTH", *auth_args, check_health=False)
 
             try:
                 auth_response = self.read_response()
@@ -672,23 +694,23 @@ def on_connect(self):
                 # server seems to be < 6.0.0 which expects a single password
                 # arg. retry auth with just the password.
                 # https://github.com/andymccurdy/redis-py/issues/1274
-                self.send_command('AUTH', self.password, check_health=False)
+                self.send_command("AUTH", self.password, check_health=False)
                 auth_response = self.read_response()
 
-            if str_if_bytes(auth_response) != 'OK':
-                raise AuthenticationError('Invalid Username or Password')
+            if str_if_bytes(auth_response) != "OK":
+                raise AuthenticationError("Invalid Username or Password")
 
         # if a client_name is given, set it
         if self.client_name:
-            self.send_command('CLIENT', 'SETNAME', self.client_name)
-            if str_if_bytes(self.read_response()) != 'OK':
-                raise ConnectionError('Error setting client name')
+            self.send_command("CLIENT", "SETNAME", self.client_name)
+            if str_if_bytes(self.read_response()) != "OK":
+                raise ConnectionError("Error setting client name")
 
         # if a database is specified, switch to it
         if self.db:
-            self.send_command('SELECT', self.db)
-            if str_if_bytes(self.read_response()) != 'OK':
-                raise ConnectionError('Invalid Database')
+            self.send_command("SELECT", self.db)
+            if str_if_bytes(self.read_response()) != "OK":
+                raise ConnectionError("Invalid Database")
 
     def disconnect(self):
         "Disconnects from the Redis server"
@@ -705,9 +727,9 @@ def disconnect(self):
 
     def _send_ping(self):
         """Send PING, expect PONG in return"""
-        self.send_command('PING', check_health=False)
-        if str_if_bytes(self.read_response()) != 'PONG':
-            raise ConnectionError('Bad response from PING health check')
+        self.send_command("PING", check_health=False)
+        if str_if_bytes(self.read_response()) != "PONG":
+            raise ConnectionError("Bad response from PING health check")
 
     def _ping_failed(self, error):
         """Function to call when PING fails"""
@@ -736,7 +758,7 @@ def send_packed_command(self, command, check_health=True):
         except OSError as e:
             self.disconnect()
             if len(e.args) == 1:
-                errno, errmsg = 'UNKNOWN', e.args[0]
+                errno, errmsg = "UNKNOWN", e.args[0]
             else:
                 errno = e.args[0]
                 errmsg = e.args[1]
@@ -747,8 +769,9 @@ def send_packed_command(self, command, check_health=True):
 
     def send_command(self, *args, **kwargs):
         """Pack and send a command to the Redis server"""
-        self.send_packed_command(self.pack_command(*args),
-                                 check_health=kwargs.get('check_health', True))
+        self.send_packed_command(
+            self.pack_command(*args), check_health=kwargs.get("check_health", True)
+        )
 
     def can_read(self, timeout=0):
         """Poll the socket to see if there's data that can be read."""
@@ -760,17 +783,15 @@ def can_read(self, timeout=0):
     def read_response(self, disable_decoding=False):
         """Read the response from a previously sent command"""
         try:
-            response = self._parser.read_response(
-                disable_decoding=disable_decoding
-            )
+            response = self._parser.read_response(disable_decoding=disable_decoding)
         except socket.timeout:
             self.disconnect()
             raise TimeoutError(f"Timeout reading from {self.host}:{self.port}")
         except OSError as e:
             self.disconnect()
             raise ConnectionError(
-                f"Error while reading from {self.host}:{self.port}"
-                f" : {e.args}")
+                f"Error while reading from {self.host}:{self.port}" f" : {e.args}"
+            )
         except BaseException:
             self.disconnect()
             raise
@@ -792,7 +813,7 @@ def pack_command(self, *args):
         # not encoded.
         if isinstance(args[0], str):
             args = tuple(args[0].encode().split()) + args[1:]
-        elif b' ' in args[0]:
+        elif b" " in args[0]:
             args = tuple(args[0].split()) + args[1:]
 
         buff = SYM_EMPTY.join((SYM_STAR, str(len(args)).encode(), SYM_CRLF))
@@ -802,17 +823,28 @@ def pack_command(self, *args):
             # to avoid large string mallocs, chunk the command into the
             # output list if we're sending large values or memoryviews
             arg_length = len(arg)
-            if (len(buff) > buffer_cutoff or arg_length > buffer_cutoff
-                    or isinstance(arg, memoryview)):
+            if (
+                len(buff) > buffer_cutoff
+                or arg_length > buffer_cutoff
+                or isinstance(arg, memoryview)
+            ):
                 buff = SYM_EMPTY.join(
-                    (buff, SYM_DOLLAR, str(arg_length).encode(), SYM_CRLF))
+                    (buff, SYM_DOLLAR, str(arg_length).encode(), SYM_CRLF)
+                )
                 output.append(buff)
                 output.append(arg)
                 buff = SYM_CRLF
             else:
                 buff = SYM_EMPTY.join(
-                    (buff, SYM_DOLLAR, str(arg_length).encode(),
-                     SYM_CRLF, arg, SYM_CRLF))
+                    (
+                        buff,
+                        SYM_DOLLAR,
+                        str(arg_length).encode(),
+                        SYM_CRLF,
+                        arg,
+                        SYM_CRLF,
+                    )
+                )
         output.append(buff)
         return output
 
@@ -826,8 +858,11 @@ def pack_commands(self, commands):
         for cmd in commands:
             for chunk in self.pack_command(*cmd):
                 chunklen = len(chunk)
-                if (buffer_length > buffer_cutoff or chunklen > buffer_cutoff
-                        or isinstance(chunk, memoryview)):
+                if (
+                    buffer_length > buffer_cutoff
+                    or chunklen > buffer_cutoff
+                    or isinstance(chunk, memoryview)
+                ):
                     output.append(SYM_EMPTY.join(pieces))
                     buffer_length = 0
                     pieces = []
@@ -844,10 +879,15 @@ def pack_commands(self, commands):
 
 
 class SSLConnection(Connection):
-
-    def __init__(self, ssl_keyfile=None, ssl_certfile=None,
-                 ssl_cert_reqs='required', ssl_ca_certs=None,
-                 ssl_check_hostname=False, **kwargs):
+    def __init__(
+        self,
+        ssl_keyfile=None,
+        ssl_certfile=None,
+        ssl_cert_reqs="required",
+        ssl_ca_certs=None,
+        ssl_check_hostname=False,
+        **kwargs,
+    ):
         if not ssl_available:
             raise RedisError("Python wasn't built with SSL support")
 
@@ -859,13 +899,14 @@ def __init__(self, ssl_keyfile=None, ssl_certfile=None,
             ssl_cert_reqs = ssl.CERT_NONE
         elif isinstance(ssl_cert_reqs, str):
             CERT_REQS = {
-                'none': ssl.CERT_NONE,
-                'optional': ssl.CERT_OPTIONAL,
-                'required': ssl.CERT_REQUIRED
+                "none": ssl.CERT_NONE,
+                "optional": ssl.CERT_OPTIONAL,
+                "required": ssl.CERT_REQUIRED,
             }
             if ssl_cert_reqs not in CERT_REQS:
                 raise RedisError(
-                    f"Invalid SSL Certificate Requirements Flag: {ssl_cert_reqs}")
+                    f"Invalid SSL Certificate Requirements Flag: {ssl_cert_reqs}"
+                )
             ssl_cert_reqs = CERT_REQS[ssl_cert_reqs]
         self.cert_reqs = ssl_cert_reqs
         self.ca_certs = ssl_ca_certs
@@ -878,22 +919,30 @@ def _connect(self):
         context.check_hostname = self.check_hostname
         context.verify_mode = self.cert_reqs
         if self.certfile and self.keyfile:
-            context.load_cert_chain(certfile=self.certfile,
-                                    keyfile=self.keyfile)
+            context.load_cert_chain(certfile=self.certfile, keyfile=self.keyfile)
         if self.ca_certs:
             context.load_verify_locations(self.ca_certs)
         return context.wrap_socket(sock, server_hostname=self.host)
 
 
 class UnixDomainSocketConnection(Connection):
-
-    def __init__(self, path='', db=0, username=None, password=None,
-                 socket_timeout=None, encoding='utf-8',
-                 encoding_errors='strict', decode_responses=False,
-                 retry_on_timeout=False,
-                 parser_class=DefaultParser, socket_read_size=65536,
-                 health_check_interval=0, client_name=None,
-                 retry=None):
+    def __init__(
+        self,
+        path="",
+        db=0,
+        username=None,
+        password=None,
+        socket_timeout=None,
+        encoding="utf-8",
+        encoding_errors="strict",
+        decode_responses=False,
+        retry_on_timeout=False,
+        parser_class=DefaultParser,
+        socket_read_size=65536,
+        health_check_interval=0,
+        client_name=None,
+        retry=None,
+    ):
         """
         Initialize a new UnixDomainSocketConnection.
         To specify a retry policy, first set `retry_on_timeout` to `True`
@@ -926,11 +975,11 @@ def __init__(self, path='', db=0, username=None, password=None,
 
     def repr_pieces(self):
         pieces = [
-            ('path', self.path),
-            ('db', self.db),
+            ("path", self.path),
+            ("db", self.db),
         ]
         if self.client_name:
-            pieces.append(('client_name', self.client_name))
+            pieces.append(("client_name", self.client_name))
         return pieces
 
     def _connect(self):
@@ -952,11 +1001,11 @@ def _error_message(self, exception):
             )
 
 
-FALSE_STRINGS = ('0', 'F', 'FALSE', 'N', 'NO')
+FALSE_STRINGS = ("0", "F", "FALSE", "N", "NO")
 
 
 def to_bool(value):
-    if value is None or value == '':
+    if value is None or value == "":
         return None
     if isinstance(value, str) and value.upper() in FALSE_STRINGS:
         return False
@@ -964,14 +1013,14 @@ def to_bool(value):
 
 
 URL_QUERY_ARGUMENT_PARSERS = {
-    'db': int,
-    'socket_timeout': float,
-    'socket_connect_timeout': float,
-    'socket_keepalive': to_bool,
-    'retry_on_timeout': to_bool,
-    'max_connections': int,
-    'health_check_interval': int,
-    'ssl_check_hostname': to_bool,
+    "db": int,
+    "socket_timeout": float,
+    "socket_connect_timeout": float,
+    "socket_keepalive": to_bool,
+    "retry_on_timeout": to_bool,
+    "max_connections": int,
+    "health_check_interval": int,
+    "ssl_check_hostname": to_bool,
 }
 
 
@@ -987,42 +1036,42 @@ def parse_url(url):
                 try:
                     kwargs[name] = parser(value)
                 except (TypeError, ValueError):
-                    raise ValueError(
-                        f"Invalid value for `{name}` in connection URL."
-                    )
+                    raise ValueError(f"Invalid value for `{name}` in connection URL.")
             else:
                 kwargs[name] = value
 
     if url.username:
-        kwargs['username'] = unquote(url.username)
+        kwargs["username"] = unquote(url.username)
     if url.password:
-        kwargs['password'] = unquote(url.password)
+        kwargs["password"] = unquote(url.password)
 
     # We only support redis://, rediss:// and unix:// schemes.
-    if url.scheme == 'unix':
+    if url.scheme == "unix":
         if url.path:
-            kwargs['path'] = unquote(url.path)
-        kwargs['connection_class'] = UnixDomainSocketConnection
+            kwargs["path"] = unquote(url.path)
+        kwargs["connection_class"] = UnixDomainSocketConnection
 
-    elif url.scheme in ('redis', 'rediss'):
+    elif url.scheme in ("redis", "rediss"):
         if url.hostname:
-            kwargs['host'] = unquote(url.hostname)
+            kwargs["host"] = unquote(url.hostname)
         if url.port:
-            kwargs['port'] = int(url.port)
+            kwargs["port"] = int(url.port)
 
         # If there's a path argument, use it as the db argument if a
         # querystring value wasn't specified
-        if url.path and 'db' not in kwargs:
+        if url.path and "db" not in kwargs:
             try:
-                kwargs['db'] = int(unquote(url.path).replace('/', ''))
+                kwargs["db"] = int(unquote(url.path).replace("/", ""))
             except (AttributeError, ValueError):
                 pass
 
-        if url.scheme == 'rediss':
-            kwargs['connection_class'] = SSLConnection
+        if url.scheme == "rediss":
+            kwargs["connection_class"] = SSLConnection
     else:
-        raise ValueError('Redis URL must specify one of the following '
-                         'schemes (redis://, rediss://, unix://)')
+        raise ValueError(
+            "Redis URL must specify one of the following "
+            "schemes (redis://, rediss://, unix://)"
+        )
 
     return kwargs
 
@@ -1040,6 +1089,7 @@ class ConnectionPool:
     Any additional keyword arguments are passed to the constructor of
     ``connection_class``.
     """
+
     @classmethod
     def from_url(cls, url, **kwargs):
         """
@@ -1084,8 +1134,9 @@ class initializer. In the case of conflicting arguments, querystring
         kwargs.update(url_options)
         return cls(**kwargs)
 
-    def __init__(self, connection_class=Connection, max_connections=None,
-                 **connection_kwargs):
+    def __init__(
+        self, connection_class=Connection, max_connections=None, **connection_kwargs
+    ):
         max_connections = max_connections or 2 ** 31
         if not isinstance(max_connections, int) or max_connections < 0:
             raise ValueError('"max_connections" must be a positive integer')
@@ -1194,12 +1245,12 @@ def get_connection(self, command_name, *keys, **options):
             # closed. either way, reconnect and verify everything is good.
             try:
                 if connection.can_read():
-                    raise ConnectionError('Connection has data')
+                    raise ConnectionError("Connection has data")
             except ConnectionError:
                 connection.disconnect()
                 connection.connect()
                 if connection.can_read():
-                    raise ConnectionError('Connection not ready')
+                    raise ConnectionError("Connection not ready")
         except BaseException:
             # release the connection back to the pool so that we don't
             # leak it
@@ -1212,9 +1263,9 @@ def get_encoder(self):
         "Return an encoder based on encoding settings"
         kwargs = self.connection_kwargs
         return Encoder(
-            encoding=kwargs.get('encoding', 'utf-8'),
-            encoding_errors=kwargs.get('encoding_errors', 'strict'),
-            decode_responses=kwargs.get('decode_responses', False)
+            encoding=kwargs.get("encoding", "utf-8"),
+            encoding_errors=kwargs.get("encoding_errors", "strict"),
+            decode_responses=kwargs.get("decode_responses", False),
         )
 
     def make_connection(self):
@@ -1259,8 +1310,9 @@ def disconnect(self, inuse_connections=True):
         self._checkpid()
         with self._lock:
             if inuse_connections:
-                connections = chain(self._available_connections,
-                                    self._in_use_connections)
+                connections = chain(
+                    self._available_connections, self._in_use_connections
+                )
             else:
                 connections = self._available_connections
 
@@ -1301,16 +1353,23 @@ class BlockingConnectionPool(ConnectionPool):
         >>> # not available.
         >>> pool = BlockingConnectionPool(timeout=5)
     """
-    def __init__(self, max_connections=50, timeout=20,
-                 connection_class=Connection, queue_class=LifoQueue,
-                 **connection_kwargs):
+
+    def __init__(
+        self,
+        max_connections=50,
+        timeout=20,
+        connection_class=Connection,
+        queue_class=LifoQueue,
+        **connection_kwargs,
+    ):
 
         self.queue_class = queue_class
         self.timeout = timeout
         super().__init__(
             connection_class=connection_class,
             max_connections=max_connections,
-            **connection_kwargs)
+            **connection_kwargs,
+        )
 
     def reset(self):
         # Create and fill up a thread safe queue with ``None`` values.
@@ -1381,12 +1440,12 @@ def get_connection(self, command_name, *keys, **options):
             # closed. either way, reconnect and verify everything is good.
             try:
                 if connection.can_read():
-                    raise ConnectionError('Connection has data')
+                    raise ConnectionError("Connection has data")
             except ConnectionError:
                 connection.disconnect()
                 connection.connect()
                 if connection.can_read():
-                    raise ConnectionError('Connection not ready')
+                    raise ConnectionError("Connection not ready")
         except BaseException:
             # release the connection back to the pool so that we don't leak it
             self.release(connection)
diff --git a/redis/crc.py b/redis/crc.py
index 7d2ee507be..c47e2acede 100644
--- a/redis/crc.py
+++ b/redis/crc.py
@@ -4,10 +4,7 @@
 # For more information see: https://github.com/redis/redis/issues/2576
 REDIS_CLUSTER_HASH_SLOTS = 16384
 
-__all__ = [
-    "key_slot",
-    "REDIS_CLUSTER_HASH_SLOTS"
-]
+__all__ = ["key_slot", "REDIS_CLUSTER_HASH_SLOTS"]
 
 
 def key_slot(key, bucket=REDIS_CLUSTER_HASH_SLOTS):
@@ -20,5 +17,5 @@ def key_slot(key, bucket=REDIS_CLUSTER_HASH_SLOTS):
     if start > -1:
         end = key.find(b"}", start + 1)
         if end > -1 and end != start + 1:
-            key = key[start + 1: end]
+            key = key[start + 1 : end]
     return crc_hqx(key, 0) % bucket
diff --git a/redis/exceptions.py b/redis/exceptions.py
index eb6ecc2dc5..e37cad358e 100644
--- a/redis/exceptions.py
+++ b/redis/exceptions.py
@@ -83,6 +83,7 @@ class AuthenticationWrongNumberOfArgsError(ResponseError):
     An error to indicate that the wrong number of args
     were sent to the AUTH command
     """
+
     pass
 
 
@@ -90,6 +91,7 @@ class RedisClusterException(Exception):
     """
     Base exception for the RedisCluster client
     """
+
     pass
 
 
@@ -98,6 +100,7 @@ class ClusterError(RedisError):
     Cluster errors occurred multiple times, resulting in an exhaustion of the
     command execution TTL
     """
+
     pass
 
 
@@ -111,6 +114,7 @@ class ClusterDownError(ClusterError, ResponseError):
     unavailable. It automatically returns available as soon as all the slots
     are covered again.
     """
+
     def __init__(self, resp):
         self.args = (resp,)
         self.message = resp
@@ -135,8 +139,8 @@ def __init__(self, resp):
         """should only redirect to master node"""
         self.args = (resp,)
         self.message = resp
-        slot_id, new_node = resp.split(' ')
-        host, port = new_node.rsplit(':', 1)
+        slot_id, new_node = resp.split(" ")
+        host, port = new_node.rsplit(":", 1)
         self.slot_id = int(slot_id)
         self.node_addr = self.host, self.port = host, int(port)
 
@@ -147,6 +151,7 @@ class TryAgainError(ResponseError):
     Operations on keys that don't exist or are - during resharding - split
     between the source and destination nodes, will generate a -TRYAGAIN error.
     """
+
     def __init__(self, *args, **kwargs):
         pass
 
@@ -157,6 +162,7 @@ class ClusterCrossSlotError(ResponseError):
     A CROSSSLOT error is generated when keys in a request don't hash to the
     same slot.
     """
+
     message = "Keys in request don't hash to the same slot"
 
 
@@ -166,6 +172,7 @@ class MovedError(AskError):
     A request sent to a node that doesn't serve this key will be replayed with
     a MOVED error that points to the correct node.
     """
+
     pass
 
 
@@ -174,6 +181,7 @@ class MasterDownError(ClusterDownError):
     Error indicated MASTERDOWN error received from cluster.
     Link with MASTER is down and replica-serve-stale-data is set to 'no'.
     """
+
     pass
 
 
@@ -185,4 +193,5 @@ class SlotNotCoveredError(RedisClusterException):
     If this error is raised the client should drop the current node layout and
     attempt to reconnect and refresh the node layout again
     """
+
     pass
diff --git a/redis/lock.py b/redis/lock.py
index d2297526a0..95bb413d7e 100644
--- a/redis/lock.py
+++ b/redis/lock.py
@@ -2,6 +2,7 @@
 import time as mod_time
 import uuid
 from types import SimpleNamespace
+
 from redis.exceptions import LockError, LockNotOwnedError
 
 
@@ -70,8 +71,16 @@ class Lock:
         return 1
     """
 
-    def __init__(self, redis, name, timeout=None, sleep=0.1,
-                 blocking=True, blocking_timeout=None, thread_local=True):
+    def __init__(
+        self,
+        redis,
+        name,
+        timeout=None,
+        sleep=0.1,
+        blocking=True,
+        blocking_timeout=None,
+        thread_local=True,
+    ):
         """
         Create a new Lock instance named ``name`` using the Redis client
         supplied by ``redis``.
@@ -129,11 +138,7 @@ def __init__(self, redis, name, timeout=None, sleep=0.1,
         self.blocking = blocking
         self.blocking_timeout = blocking_timeout
         self.thread_local = bool(thread_local)
-        self.local = (
-            threading.local()
-            if self.thread_local
-            else SimpleNamespace()
-        )
+        self.local = threading.local() if self.thread_local else SimpleNamespace()
         self.local.token = None
         self.register_scripts()
 
@@ -145,8 +150,7 @@ def register_scripts(self):
         if cls.lua_extend is None:
             cls.lua_extend = client.register_script(cls.LUA_EXTEND_SCRIPT)
         if cls.lua_reacquire is None:
-            cls.lua_reacquire = \
-                client.register_script(cls.LUA_REACQUIRE_SCRIPT)
+            cls.lua_reacquire = client.register_script(cls.LUA_REACQUIRE_SCRIPT)
 
     def __enter__(self):
         if self.acquire():
@@ -222,8 +226,7 @@ def owned(self):
         if stored_token and not isinstance(stored_token, bytes):
             encoder = self.redis.connection_pool.get_encoder()
             stored_token = encoder.encode(stored_token)
-        return self.local.token is not None and \
-            stored_token == self.local.token
+        return self.local.token is not None and stored_token == self.local.token
 
     def release(self):
         "Releases the already acquired lock"
@@ -234,11 +237,10 @@ def release(self):
         self.do_release(expected_token)
 
     def do_release(self, expected_token):
-        if not bool(self.lua_release(keys=[self.name],
-                                     args=[expected_token],
-                                     client=self.redis)):
-            raise LockNotOwnedError("Cannot release a lock"
-                                    " that's no longer owned")
+        if not bool(
+            self.lua_release(keys=[self.name], args=[expected_token], client=self.redis)
+        ):
+            raise LockNotOwnedError("Cannot release a lock" " that's no longer owned")
 
     def extend(self, additional_time, replace_ttl=False):
         """
@@ -262,17 +264,11 @@ def do_extend(self, additional_time, replace_ttl):
         if not bool(
             self.lua_extend(
                 keys=[self.name],
-                args=[
-                    self.local.token,
-                    additional_time,
-                    replace_ttl and "1" or "0"
-                ],
+                args=[self.local.token, additional_time, replace_ttl and "1" or "0"],
                 client=self.redis,
             )
         ):
-            raise LockNotOwnedError(
-                "Cannot extend a lock that's" " no longer owned"
-            )
+            raise LockNotOwnedError("Cannot extend a lock that's" " no longer owned")
         return True
 
     def reacquire(self):
@@ -287,9 +283,10 @@ def reacquire(self):
 
     def do_reacquire(self):
         timeout = int(self.timeout * 1000)
-        if not bool(self.lua_reacquire(keys=[self.name],
-                                       args=[self.local.token, timeout],
-                                       client=self.redis)):
-            raise LockNotOwnedError("Cannot reacquire a lock that's"
-                                    " no longer owned")
+        if not bool(
+            self.lua_reacquire(
+                keys=[self.name], args=[self.local.token, timeout], client=self.redis
+            )
+        ):
+            raise LockNotOwnedError("Cannot reacquire a lock that's" " no longer owned")
         return True
diff --git a/redis/retry.py b/redis/retry.py
index cd06a23e3d..75504c77e7 100644
--- a/redis/retry.py
+++ b/redis/retry.py
@@ -6,8 +6,9 @@
 class Retry:
     """Retry a specific number of times after a failure"""
 
-    def __init__(self, backoff, retries,
-                 supported_errors=(ConnectionError, TimeoutError)):
+    def __init__(
+        self, backoff, retries, supported_errors=(ConnectionError, TimeoutError)
+    ):
         """
         Initialize a `Retry` object with a `Backoff` object
         that retries a maximum of `retries` times.
diff --git a/redis/sentinel.py b/redis/sentinel.py
index 06877bd167..c9383d30a9 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -3,9 +3,8 @@
 
 from redis.client import Redis
 from redis.commands import SentinelCommands
-from redis.connection import ConnectionPool, Connection, SSLConnection
-from redis.exceptions import (ConnectionError, ResponseError, ReadOnlyError,
-                              TimeoutError)
+from redis.connection import Connection, ConnectionPool, SSLConnection
+from redis.exceptions import ConnectionError, ReadOnlyError, ResponseError, TimeoutError
 from redis.utils import str_if_bytes
 
 
@@ -19,14 +18,14 @@ class SlaveNotFoundError(ConnectionError):
 
 class SentinelManagedConnection(Connection):
     def __init__(self, **kwargs):
-        self.connection_pool = kwargs.pop('connection_pool')
+        self.connection_pool = kwargs.pop("connection_pool")
         super().__init__(**kwargs)
 
     def __repr__(self):
         pool = self.connection_pool
-        s = f'{type(self).__name__}<service={pool.service_name}%s>'
+        s = f"{type(self).__name__}<service={pool.service_name}%s>"
         if self.host:
-            host_info = f',host={self.host},port={self.port}'
+            host_info = f",host={self.host},port={self.port}"
             s = s % host_info
         return s
 
@@ -34,9 +33,9 @@ def connect_to(self, address):
         self.host, self.port = address
         super().connect()
         if self.connection_pool.check_connection:
-            self.send_command('PING')
-            if str_if_bytes(self.read_response()) != 'PONG':
-                raise ConnectionError('PING failed')
+            self.send_command("PING")
+            if str_if_bytes(self.read_response()) != "PONG":
+                raise ConnectionError("PING failed")
 
     def connect(self):
         if self._sock:
@@ -62,7 +61,7 @@ def read_response(self, disable_decoding=False):
                 # calling disconnect will force the connection to re-query
                 # sentinel during the next connect() attempt.
                 self.disconnect()
-                raise ConnectionError('The previous master is now a slave')
+                raise ConnectionError("The previous master is now a slave")
             raise
 
 
@@ -79,19 +78,21 @@ class SentinelConnectionPool(ConnectionPool):
     """
 
     def __init__(self, service_name, sentinel_manager, **kwargs):
-        kwargs['connection_class'] = kwargs.get(
-            'connection_class',
-            SentinelManagedSSLConnection if kwargs.pop('ssl', False)
-            else SentinelManagedConnection)
-        self.is_master = kwargs.pop('is_master', True)
-        self.check_connection = kwargs.pop('check_connection', False)
+        kwargs["connection_class"] = kwargs.get(
+            "connection_class",
+            SentinelManagedSSLConnection
+            if kwargs.pop("ssl", False)
+            else SentinelManagedConnection,
+        )
+        self.is_master = kwargs.pop("is_master", True)
+        self.check_connection = kwargs.pop("check_connection", False)
         super().__init__(**kwargs)
-        self.connection_kwargs['connection_pool'] = weakref.proxy(self)
+        self.connection_kwargs["connection_pool"] = weakref.proxy(self)
         self.service_name = service_name
         self.sentinel_manager = sentinel_manager
 
     def __repr__(self):
-        role = 'master' if self.is_master else 'slave'
+        role = "master" if self.is_master else "slave"
         return f"{type(self).__name__}<service={self.service_name}({role})"
 
     def reset(self):
@@ -100,15 +101,14 @@ def reset(self):
         self.slave_rr_counter = None
 
     def owns_connection(self, connection):
-        check = not self.is_master or \
-                (self.is_master and
-                 self.master_address == (connection.host, connection.port))
+        check = not self.is_master or (
+            self.is_master and self.master_address == (connection.host, connection.port)
+        )
         parent = super()
         return check and parent.owns_connection(connection)
 
     def get_master_address(self):
-        master_address = self.sentinel_manager.discover_master(
-            self.service_name)
+        master_address = self.sentinel_manager.discover_master(self.service_name)
         if self.is_master:
             if self.master_address != master_address:
                 self.master_address = master_address
@@ -124,8 +124,7 @@ def rotate_slaves(self):
             if self.slave_rr_counter is None:
                 self.slave_rr_counter = random.randint(0, len(slaves) - 1)
             for _ in range(len(slaves)):
-                self.slave_rr_counter = (
-                    self.slave_rr_counter + 1) % len(slaves)
+                self.slave_rr_counter = (self.slave_rr_counter + 1) % len(slaves)
                 slave = slaves[self.slave_rr_counter]
                 yield slave
         # Fallback to the master connection
@@ -133,7 +132,7 @@ def rotate_slaves(self):
             yield self.get_master_address()
         except MasterNotFoundError:
             pass
-        raise SlaveNotFoundError(f'No slave found for {self.service_name!r}')
+        raise SlaveNotFoundError(f"No slave found for {self.service_name!r}")
 
 
 class Sentinel(SentinelCommands):
@@ -165,20 +164,25 @@ class Sentinel(SentinelCommands):
     establishing a connection to a Redis server.
     """
 
-    def __init__(self, sentinels, min_other_sentinels=0, sentinel_kwargs=None,
-                 **connection_kwargs):
+    def __init__(
+        self,
+        sentinels,
+        min_other_sentinels=0,
+        sentinel_kwargs=None,
+        **connection_kwargs,
+    ):
         # if sentinel_kwargs isn't defined, use the socket_* options from
         # connection_kwargs
         if sentinel_kwargs is None:
             sentinel_kwargs = {
-                k: v
-                for k, v in connection_kwargs.items()
-                if k.startswith('socket_')
+                k: v for k, v in connection_kwargs.items() if k.startswith("socket_")
             }
         self.sentinel_kwargs = sentinel_kwargs
 
-        self.sentinels = [Redis(hostname, port, **self.sentinel_kwargs)
-                          for hostname, port in sentinels]
+        self.sentinels = [
+            Redis(hostname, port, **self.sentinel_kwargs)
+            for hostname, port in sentinels
+        ]
         self.min_other_sentinels = min_other_sentinels
         self.connection_kwargs = connection_kwargs
 
@@ -188,9 +192,9 @@ def execute_command(self, *args, **kwargs):
         once - If set to True, then execute the resulting command on a single
                node at random, rather than across the entire sentinel cluster.
         """
-        once = bool(kwargs.get('once', False))
-        if 'once' in kwargs.keys():
-            kwargs.pop('once')
+        once = bool(kwargs.get("once", False))
+        if "once" in kwargs.keys():
+            kwargs.pop("once")
 
         if once:
             for sentinel in self.sentinels:
@@ -202,16 +206,18 @@ def execute_command(self, *args, **kwargs):
     def __repr__(self):
         sentinel_addresses = []
         for sentinel in self.sentinels:
-            sentinel_addresses.append('{host}:{port}'.format_map(
-                sentinel.connection_pool.connection_kwargs,
-            ))
+            sentinel_addresses.append(
+                "{host}:{port}".format_map(
+                    sentinel.connection_pool.connection_kwargs,
+                )
+            )
         return f'{type(self).__name__}<sentinels=[{",".join(sentinel_addresses)}]>'
 
     def check_master_state(self, state, service_name):
-        if not state['is_master'] or state['is_sdown'] or state['is_odown']:
+        if not state["is_master"] or state["is_sdown"] or state["is_odown"]:
             return False
         # Check if our sentinel doesn't see other nodes
-        if state['num-other-sentinels'] < self.min_other_sentinels:
+        if state["num-other-sentinels"] < self.min_other_sentinels:
             return False
         return True
 
@@ -232,17 +238,19 @@ def discover_master(self, service_name):
             if state and self.check_master_state(state, service_name):
                 # Put this sentinel at the top of the list
                 self.sentinels[0], self.sentinels[sentinel_no] = (
-                    sentinel, self.sentinels[0])
-                return state['ip'], state['port']
+                    sentinel,
+                    self.sentinels[0],
+                )
+                return state["ip"], state["port"]
         raise MasterNotFoundError(f"No master found for {service_name!r}")
 
     def filter_slaves(self, slaves):
         "Remove slaves that are in an ODOWN or SDOWN state"
         slaves_alive = []
         for slave in slaves:
-            if slave['is_odown'] or slave['is_sdown']:
+            if slave["is_odown"] or slave["is_sdown"]:
                 continue
-            slaves_alive.append((slave['ip'], slave['port']))
+            slaves_alive.append((slave["ip"], slave["port"]))
         return slaves_alive
 
     def discover_slaves(self, service_name):
@@ -257,8 +265,13 @@ def discover_slaves(self, service_name):
                 return slaves
         return []
 
-    def master_for(self, service_name, redis_class=Redis,
-                   connection_pool_class=SentinelConnectionPool, **kwargs):
+    def master_for(
+        self,
+        service_name,
+        redis_class=Redis,
+        connection_pool_class=SentinelConnectionPool,
+        **kwargs,
+    ):
         """
         Returns a redis client instance for the ``service_name`` master.
 
@@ -281,14 +294,22 @@ def master_for(self, service_name, redis_class=Redis,
         passed to this class and passed to the connection pool as keyword
         arguments to be used to initialize Redis connections.
         """
-        kwargs['is_master'] = True
+        kwargs["is_master"] = True
         connection_kwargs = dict(self.connection_kwargs)
         connection_kwargs.update(kwargs)
-        return redis_class(connection_pool=connection_pool_class(
-            service_name, self, **connection_kwargs))
-
-    def slave_for(self, service_name, redis_class=Redis,
-                  connection_pool_class=SentinelConnectionPool, **kwargs):
+        return redis_class(
+            connection_pool=connection_pool_class(
+                service_name, self, **connection_kwargs
+            )
+        )
+
+    def slave_for(
+        self,
+        service_name,
+        redis_class=Redis,
+        connection_pool_class=SentinelConnectionPool,
+        **kwargs,
+    ):
         """
         Returns redis client instance for the ``service_name`` slave(s).
 
@@ -306,8 +327,11 @@ def slave_for(self, service_name, redis_class=Redis,
         passed to this class and passed to the connection pool as keyword
         arguments to be used to initialize Redis connections.
         """
-        kwargs['is_master'] = False
+        kwargs["is_master"] = False
         connection_kwargs = dict(self.connection_kwargs)
         connection_kwargs.update(kwargs)
-        return redis_class(connection_pool=connection_pool_class(
-            service_name, self, **connection_kwargs))
+        return redis_class(
+            connection_pool=connection_pool_class(
+                service_name, self, **connection_kwargs
+            )
+        )
diff --git a/redis/utils.py b/redis/utils.py
index 0e78cc5f3b..50961cb767 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -1,8 +1,8 @@
 from contextlib import contextmanager
 
-
 try:
     import hiredis  # noqa
+
     HIREDIS_AVAILABLE = True
 except ImportError:
     HIREDIS_AVAILABLE = False
@@ -16,6 +16,7 @@ def from_url(url, **kwargs):
     none is provided.
     """
     from redis.client import Redis
+
     return Redis.from_url(url, **kwargs)
 
 
@@ -28,9 +29,7 @@ def pipeline(redis_obj):
 
 def str_if_bytes(value):
     return (
-        value.decode('utf-8', errors='replace')
-        if isinstance(value, bytes)
-        else value
+        value.decode("utf-8", errors="replace") if isinstance(value, bytes) else value
     )
 
 
diff --git a/setup.py b/setup.py
index 9acb501633..ee91298289 100644
--- a/setup.py
+++ b/setup.py
@@ -1,5 +1,6 @@
 #!/usr/bin/env python
-from setuptools import setup, find_packages
+from setuptools import find_packages, setup
+
 import redis
 
 setup(
@@ -24,8 +25,8 @@
     author_email="oss@redis.com",
     python_requires=">=3.6",
     install_requires=[
-        'deprecated==1.2.3',
-        'packaging==21.3',
+        "deprecated==1.2.3",
+        "packaging==21.3",
     ],
     classifiers=[
         "Development Status :: 5 - Production/Stable",
diff --git a/tasks.py b/tasks.py
index 8d9c4c64be..9291e7effb 100644
--- a/tasks.py
+++ b/tasks.py
@@ -1,11 +1,11 @@
 import os
 import shutil
-from invoke import task, run
 
-with open('tox.ini') as fp:
+from invoke import run, task
+
+with open("tox.ini") as fp:
     lines = fp.read().split("\n")
-    dockers = [line.split("=")[1].strip() for line in lines
-               if line.find("name") != -1]
+    dockers = [line.split("=")[1].strip() for line in lines if line.find("name") != -1]
 
 
 @task
@@ -14,7 +14,7 @@ def devenv(c):
     specified in the tox.ini file.
     """
     clean(c)
-    cmd = 'tox -e devenv'
+    cmd = "tox -e devenv"
     for d in dockers:
         cmd += f" --docker-dont-stop={d}"
     run(cmd)
diff --git a/tests/conftest.py b/tests/conftest.py
index 8ed39abddc..24783c0466 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -1,15 +1,16 @@
-from redis.backoff import NoBackoff
-from redis.retry import Retry
-import pytest
 import random
-import redis
 import time
 from distutils.version import LooseVersion
-from redis.connection import parse_url
-from redis.exceptions import RedisClusterException
 from unittest.mock import Mock
 from urllib.parse import urlparse
 
+import pytest
+
+import redis
+from redis.backoff import NoBackoff
+from redis.connection import parse_url
+from redis.exceptions import RedisClusterException
+from redis.retry import Retry
 
 REDIS_INFO = {}
 default_redis_url = "redis://localhost:6379/9"
@@ -19,29 +20,37 @@
 
 
 def pytest_addoption(parser):
-    parser.addoption('--redis-url', default=default_redis_url,
-                     action="store",
-                     help="Redis connection string,"
-                          " defaults to `%(default)s`")
-
-    parser.addoption('--redismod-url', default=default_redismod_url,
-                     action="store",
-                     help="Connection string to redis server"
-                          " with loaded modules,"
-                          " defaults to `%(default)s`")
-
-    parser.addoption('--redis-cluster-nodes', default=default_cluster_nodes,
-                     action="store",
-                     help="The number of cluster nodes that need to be "
-                          "available before the test can start,"
-                          " defaults to `%(default)s`")
+    parser.addoption(
+        "--redis-url",
+        default=default_redis_url,
+        action="store",
+        help="Redis connection string," " defaults to `%(default)s`",
+    )
+
+    parser.addoption(
+        "--redismod-url",
+        default=default_redismod_url,
+        action="store",
+        help="Connection string to redis server"
+        " with loaded modules,"
+        " defaults to `%(default)s`",
+    )
+
+    parser.addoption(
+        "--redis-cluster-nodes",
+        default=default_cluster_nodes,
+        action="store",
+        help="The number of cluster nodes that need to be "
+        "available before the test can start,"
+        " defaults to `%(default)s`",
+    )
 
 
 def _get_info(redis_url):
     client = redis.Redis.from_url(redis_url)
     info = client.info()
     cmds = [command.upper() for command in client.command().keys()]
-    if 'dping' in cmds:
+    if "dping" in cmds:
         info["enterprise"] = True
     else:
         info["enterprise"] = False
@@ -102,42 +111,39 @@ def wait_for_cluster_creation(redis_url, cluster_nodes, timeout=20):
         available_nodes = 0 if client is None else len(client.get_nodes())
         raise RedisClusterException(
             f"The cluster did not become available after {timeout} seconds. "
-            f"Only {available_nodes} nodes out of {cluster_nodes} are available")
+            f"Only {available_nodes} nodes out of {cluster_nodes} are available"
+        )
 
 
 def skip_if_server_version_lt(min_version):
     redis_version = REDIS_INFO["version"]
     check = LooseVersion(redis_version) < LooseVersion(min_version)
-    return pytest.mark.skipif(
-        check,
-        reason=f"Redis version required >= {min_version}")
+    return pytest.mark.skipif(check, reason=f"Redis version required >= {min_version}")
 
 
 def skip_if_server_version_gte(min_version):
     redis_version = REDIS_INFO["version"]
     check = LooseVersion(redis_version) >= LooseVersion(min_version)
-    return pytest.mark.skipif(
-        check,
-        reason=f"Redis version required < {min_version}")
+    return pytest.mark.skipif(check, reason=f"Redis version required < {min_version}")
 
 
 def skip_unless_arch_bits(arch_bits):
-    return pytest.mark.skipif(REDIS_INFO["arch_bits"] != arch_bits,
-                              reason=f"server is not {arch_bits}-bit")
+    return pytest.mark.skipif(
+        REDIS_INFO["arch_bits"] != arch_bits, reason=f"server is not {arch_bits}-bit"
+    )
 
 
 def skip_ifmodversion_lt(min_version: str, module_name: str):
     try:
         modules = REDIS_INFO["modules"]
     except KeyError:
-        return pytest.mark.skipif(True,
-                                  reason="Redis server does not have modules")
+        return pytest.mark.skipif(True, reason="Redis server does not have modules")
     if modules == []:
         return pytest.mark.skipif(True, reason="No redis modules found")
 
     for j in modules:
-        if module_name == j.get('name'):
-            version = j.get('ver')
+        if module_name == j.get("name"):
+            version = j.get("ver")
             mv = int(min_version.replace(".", ""))
             check = version < mv
             return pytest.mark.skipif(check, reason="Redis module version")
@@ -155,9 +161,9 @@ def skip_ifnot_redis_enterprise(func):
     return pytest.mark.skipif(check, reason="Not running in redis enterprise")
 
 
-def _get_client(cls, request, single_connection_client=True, flushdb=True,
-                from_url=None,
-                **kwargs):
+def _get_client(
+    cls, request, single_connection_client=True, flushdb=True, from_url=None, **kwargs
+):
     """
     Helper for fixtures or tests that need a Redis client
 
@@ -181,6 +187,7 @@ def _get_client(cls, request, single_connection_client=True, flushdb=True,
     if single_connection_client:
         client = client.client()
     if request:
+
         def teardown():
             if not cluster_mode:
                 if flushdb:
@@ -194,6 +201,7 @@ def teardown():
                 client.connection_pool.disconnect()
             else:
                 cluster_teardown(client, flushdb)
+
         request.addfinalizer(teardown)
     return client
 
@@ -201,11 +209,11 @@ def teardown():
 def cluster_teardown(client, flushdb):
     if flushdb:
         try:
-            client.flushdb(target_nodes='primaries')
+            client.flushdb(target_nodes="primaries")
         except redis.ConnectionError:
             # handle cases where a test disconnected a client
             # just manually retry the flushdb
-            client.flushdb(target_nodes='primaries')
+            client.flushdb(target_nodes="primaries")
     client.close()
     client.disconnect_connection_pools()
 
@@ -214,9 +222,10 @@ def cluster_teardown(client, flushdb):
 # an index on db != 0 raises a ResponseError in redis
 @pytest.fixture()
 def modclient(request, **kwargs):
-    rmurl = request.config.getoption('--redismod-url')
-    with _get_client(redis.Redis, request, from_url=rmurl,
-                     decode_responses=True, **kwargs) as client:
+    rmurl = request.config.getoption("--redismod-url")
+    with _get_client(
+        redis.Redis, request, from_url=rmurl, decode_responses=True, **kwargs
+    ) as client:
         yield client
 
 
@@ -250,56 +259,61 @@ def _gen_cluster_mock_resp(r, response):
 @pytest.fixture()
 def mock_cluster_resp_ok(request, **kwargs):
     r = _get_client(redis.Redis, request, **kwargs)
-    return _gen_cluster_mock_resp(r, 'OK')
+    return _gen_cluster_mock_resp(r, "OK")
 
 
 @pytest.fixture()
 def mock_cluster_resp_int(request, **kwargs):
     r = _get_client(redis.Redis, request, **kwargs)
-    return _gen_cluster_mock_resp(r, '2')
+    return _gen_cluster_mock_resp(r, "2")
 
 
 @pytest.fixture()
 def mock_cluster_resp_info(request, **kwargs):
     r = _get_client(redis.Redis, request, **kwargs)
-    response = ('cluster_state:ok\r\ncluster_slots_assigned:16384\r\n'
-                'cluster_slots_ok:16384\r\ncluster_slots_pfail:0\r\n'
-                'cluster_slots_fail:0\r\ncluster_known_nodes:7\r\n'
-                'cluster_size:3\r\ncluster_current_epoch:7\r\n'
-                'cluster_my_epoch:2\r\ncluster_stats_messages_sent:170262\r\n'
-                'cluster_stats_messages_received:105653\r\n')
+    response = (
+        "cluster_state:ok\r\ncluster_slots_assigned:16384\r\n"
+        "cluster_slots_ok:16384\r\ncluster_slots_pfail:0\r\n"
+        "cluster_slots_fail:0\r\ncluster_known_nodes:7\r\n"
+        "cluster_size:3\r\ncluster_current_epoch:7\r\n"
+        "cluster_my_epoch:2\r\ncluster_stats_messages_sent:170262\r\n"
+        "cluster_stats_messages_received:105653\r\n"
+    )
     return _gen_cluster_mock_resp(r, response)
 
 
 @pytest.fixture()
 def mock_cluster_resp_nodes(request, **kwargs):
     r = _get_client(redis.Redis, request, **kwargs)
-    response = ('c8253bae761cb1ecb2b61857d85dfe455a0fec8b 172.17.0.7:7006 '
-                'slave aa90da731f673a99617dfe930306549a09f83a6b 0 '
-                '1447836263059 5 connected\n'
-                '9bd595fe4821a0e8d6b99d70faa660638a7612b3 172.17.0.7:7008 '
-                'master - 0 1447836264065 0 connected\n'
-                'aa90da731f673a99617dfe930306549a09f83a6b 172.17.0.7:7003 '
-                'myself,master - 0 0 2 connected 5461-10922\n'
-                '1df047e5a594f945d82fc140be97a1452bcbf93e 172.17.0.7:7007 '
-                'slave 19efe5a631f3296fdf21a5441680f893e8cc96ec 0 '
-                '1447836262556 3 connected\n'
-                '4ad9a12e63e8f0207025eeba2354bcf4c85e5b22 172.17.0.7:7005 '
-                'master - 0 1447836262555 7 connected 0-5460\n'
-                '19efe5a631f3296fdf21a5441680f893e8cc96ec 172.17.0.7:7004 '
-                'master - 0 1447836263562 3 connected 10923-16383\n'
-                'fbb23ed8cfa23f17eaf27ff7d0c410492a1093d6 172.17.0.7:7002 '
-                'master,fail - 1447829446956 1447829444948 1 disconnected\n'
-                )
+    response = (
+        "c8253bae761cb1ecb2b61857d85dfe455a0fec8b 172.17.0.7:7006 "
+        "slave aa90da731f673a99617dfe930306549a09f83a6b 0 "
+        "1447836263059 5 connected\n"
+        "9bd595fe4821a0e8d6b99d70faa660638a7612b3 172.17.0.7:7008 "
+        "master - 0 1447836264065 0 connected\n"
+        "aa90da731f673a99617dfe930306549a09f83a6b 172.17.0.7:7003 "
+        "myself,master - 0 0 2 connected 5461-10922\n"
+        "1df047e5a594f945d82fc140be97a1452bcbf93e 172.17.0.7:7007 "
+        "slave 19efe5a631f3296fdf21a5441680f893e8cc96ec 0 "
+        "1447836262556 3 connected\n"
+        "4ad9a12e63e8f0207025eeba2354bcf4c85e5b22 172.17.0.7:7005 "
+        "master - 0 1447836262555 7 connected 0-5460\n"
+        "19efe5a631f3296fdf21a5441680f893e8cc96ec 172.17.0.7:7004 "
+        "master - 0 1447836263562 3 connected 10923-16383\n"
+        "fbb23ed8cfa23f17eaf27ff7d0c410492a1093d6 172.17.0.7:7002 "
+        "master,fail - 1447829446956 1447829444948 1 disconnected\n"
+    )
     return _gen_cluster_mock_resp(r, response)
 
 
 @pytest.fixture()
 def mock_cluster_resp_slaves(request, **kwargs):
     r = _get_client(redis.Redis, request, **kwargs)
-    response = ("['1df047e5a594f945d82fc140be97a1452bcbf93e 172.17.0.7:7007 "
-                "slave 19efe5a631f3296fdf21a5441680f893e8cc96ec 0 "
-                "1447836789290 3 connected']")
+    response = (
+        "['1df047e5a594f945d82fc140be97a1452bcbf93e 172.17.0.7:7007 "
+        "slave 19efe5a631f3296fdf21a5441680f893e8cc96ec 0 "
+        "1447836789290 3 connected']"
+    )
     return _gen_cluster_mock_resp(r, response)
 
 
@@ -315,15 +329,15 @@ def wait_for_command(client, monitor, command):
     # if we find a command with our key before the command we're waiting
     # for, something went wrong
     redis_version = REDIS_INFO["version"]
-    if LooseVersion(redis_version) >= LooseVersion('5.0.0'):
+    if LooseVersion(redis_version) >= LooseVersion("5.0.0"):
         id_str = str(client.client_id())
     else:
-        id_str = f'{random.randrange(2 ** 32):08x}'
-    key = f'__REDIS-PY-{id_str}__'
+        id_str = f"{random.randrange(2 ** 32):08x}"
+    key = f"__REDIS-PY-{id_str}__"
     client.get(key)
     while True:
         monitor_response = monitor.next_command()
-        if command in monitor_response['command']:
+        if command in monitor_response["command"]:
             return monitor_response
-        if key in monitor_response['command']:
+        if key in monitor_response["command"]:
             return None
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index d12e47ed02..84d74bd43b 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -1,46 +1,47 @@
 import binascii
 import datetime
-import pytest
 import warnings
-
 from time import sleep
-from tests.test_pubsub import wait_for_message
-from unittest.mock import call, patch, DEFAULT, Mock
+from unittest.mock import DEFAULT, Mock, call, patch
+
+import pytest
+
 from redis import Redis
-from redis.cluster import get_node_name, ClusterNode, \
-    RedisCluster, NodesManager, PRIMARY, REDIS_CLUSTER_HASH_SLOTS, REPLICA
+from redis.cluster import (
+    PRIMARY,
+    REDIS_CLUSTER_HASH_SLOTS,
+    REPLICA,
+    ClusterNode,
+    NodesManager,
+    RedisCluster,
+    get_node_name,
+)
 from redis.commands import CommandsParser
 from redis.connection import Connection
-from redis.utils import str_if_bytes
+from redis.crc import key_slot
 from redis.exceptions import (
     AskError,
     ClusterDownError,
     DataError,
     MovedError,
     RedisClusterException,
-    RedisError
+    RedisError,
 )
+from redis.utils import str_if_bytes
+from tests.test_pubsub import wait_for_message
 
-from redis.crc import key_slot
-from .conftest import (
-    _get_client,
-    skip_if_server_version_lt,
-    skip_unless_arch_bits
-)
+from .conftest import _get_client, skip_if_server_version_lt, skip_unless_arch_bits
 
 default_host = "127.0.0.1"
 default_port = 7000
 default_cluster_slots = [
     [
-        0, 8191,
-        ['127.0.0.1', 7000, 'node_0'],
-        ['127.0.0.1', 7003, 'node_3'],
+        0,
+        8191,
+        ["127.0.0.1", 7000, "node_0"],
+        ["127.0.0.1", 7003, "node_3"],
     ],
-    [
-        8192, 16383,
-        ['127.0.0.1', 7001, 'node_1'],
-        ['127.0.0.1', 7002, 'node_2']
-    ]
+    [8192, 16383, ["127.0.0.1", 7001, "node_1"], ["127.0.0.1", 7002, "node_2"]],
 ]
 
 
@@ -53,21 +54,20 @@ def slowlog(request, r):
     to test it
     """
     # Save old values
-    current_config = r.config_get(
-        target_nodes=r.get_primaries()[0])
-    old_slower_than_value = current_config['slowlog-log-slower-than']
-    old_max_legnth_value = current_config['slowlog-max-len']
+    current_config = r.config_get(target_nodes=r.get_primaries()[0])
+    old_slower_than_value = current_config["slowlog-log-slower-than"]
+    old_max_legnth_value = current_config["slowlog-max-len"]
 
     # Function to restore the old values
     def cleanup():
-        r.config_set('slowlog-log-slower-than', old_slower_than_value)
-        r.config_set('slowlog-max-len', old_max_legnth_value)
+        r.config_set("slowlog-log-slower-than", old_slower_than_value)
+        r.config_set("slowlog-max-len", old_max_legnth_value)
 
     request.addfinalizer(cleanup)
 
     # Set the new values
-    r.config_set('slowlog-log-slower-than', 0)
-    r.config_set('slowlog-max-len', 128)
+    r.config_set("slowlog-log-slower-than", 0)
+    r.config_set("slowlog-max-len", 128)
 
 
 def get_mocked_redis_client(func=None, *args, **kwargs):
@@ -76,17 +76,18 @@ def get_mocked_redis_client(func=None, *args, **kwargs):
     nodes and slots setup to remove the problem of different IP addresses
     on different installations and machines.
     """
-    cluster_slots = kwargs.pop('cluster_slots', default_cluster_slots)
-    coverage_res = kwargs.pop('coverage_result', 'yes')
-    with patch.object(Redis, 'execute_command') as execute_command_mock:
+    cluster_slots = kwargs.pop("cluster_slots", default_cluster_slots)
+    coverage_res = kwargs.pop("coverage_result", "yes")
+    with patch.object(Redis, "execute_command") as execute_command_mock:
+
         def execute_command(*_args, **_kwargs):
-            if _args[0] == 'CLUSTER SLOTS':
+            if _args[0] == "CLUSTER SLOTS":
                 mock_cluster_slots = cluster_slots
                 return mock_cluster_slots
-            elif _args[0] == 'COMMAND':
-                return {'get': [], 'set': []}
-            elif _args[1] == 'cluster-require-full-coverage':
-                return {'cluster-require-full-coverage': coverage_res}
+            elif _args[0] == "COMMAND":
+                return {"get": [], "set": []}
+            elif _args[1] == "cluster-require-full-coverage":
+                return {"cluster-require-full-coverage": coverage_res}
             elif func is not None:
                 return func(*args, **kwargs)
             else:
@@ -94,16 +95,21 @@ def execute_command(*_args, **_kwargs):
 
         execute_command_mock.side_effect = execute_command
 
-        with patch.object(CommandsParser, 'initialize',
-                          autospec=True) as cmd_parser_initialize:
+        with patch.object(
+            CommandsParser, "initialize", autospec=True
+        ) as cmd_parser_initialize:
 
             def cmd_init_mock(self, r):
-                self.commands = {'get': {'name': 'get', 'arity': 2,
-                                         'flags': ['readonly',
-                                                   'fast'],
-                                         'first_key_pos': 1,
-                                         'last_key_pos': 1,
-                                         'step_count': 1}}
+                self.commands = {
+                    "get": {
+                        "name": "get",
+                        "arity": 2,
+                        "flags": ["readonly", "fast"],
+                        "first_key_pos": 1,
+                        "last_key_pos": 1,
+                        "step_count": 1,
+                    }
+                }
 
             cmd_parser_initialize.side_effect = cmd_init_mock
 
@@ -138,21 +144,21 @@ def find_node_ip_based_on_port(cluster_client, port):
 
 def moved_redirection_helper(request, failover=False):
     """
-        Test that the client handles MOVED response after a failover.
-        Redirection after a failover means that the redirection address is of a
-        replica that was promoted to a primary.
+    Test that the client handles MOVED response after a failover.
+    Redirection after a failover means that the redirection address is of a
+    replica that was promoted to a primary.
 
-        At first call it should return a MOVED ResponseError that will point
-        the client to the next server it should talk to.
+    At first call it should return a MOVED ResponseError that will point
+    the client to the next server it should talk to.
 
-        Verify that:
-        1. it tries to talk to the redirected node
-        2. it updates the slot's primary to the redirected node
+    Verify that:
+    1. it tries to talk to the redirected node
+    2. it updates the slot's primary to the redirected node
 
-        For a failover, also verify:
-        3. the redirected node's server type updated to 'primary'
-        4. the server type of the previous slot owner updated to 'replica'
-        """
+    For a failover, also verify:
+    3. the redirected node's server type updated to 'primary'
+    4. the server type of the previous slot owner updated to 'replica'
+    """
     rc = _get_client(RedisCluster, request, flushdb=False)
     slot = 12182
     redirect_node = None
@@ -160,8 +166,7 @@ def moved_redirection_helper(request, failover=False):
     prev_primary = rc.nodes_manager.get_node_from_slot(slot)
     if failover:
         if len(rc.nodes_manager.slots_cache[slot]) < 2:
-            warnings.warn("Skipping this test since it requires to have a "
-                          "replica")
+            warnings.warn("Skipping this test since it requires to have a " "replica")
             return
         redirect_node = rc.nodes_manager.slots_cache[slot][1]
     else:
@@ -169,7 +174,8 @@ def moved_redirection_helper(request, failover=False):
         redirect_node = rc.get_primaries()[0]
     r_host = redirect_node.host
     r_port = redirect_node.port
-    with patch.object(Redis, 'parse_response') as parse_response:
+    with patch.object(Redis, "parse_response") as parse_response:
+
         def moved_redirect_effect(connection, *args, **options):
             def ok_response(connection, *args, **options):
                 assert connection.host == r_host
@@ -201,8 +207,7 @@ def test_host_port_startup_node(self):
         args
         """
         cluster = get_mocked_redis_client(host=default_host, port=default_port)
-        assert cluster.get_node(host=default_host,
-                                port=default_port) is not None
+        assert cluster.get_node(host=default_host, port=default_port) is not None
 
     def test_startup_nodes(self):
         """
@@ -211,11 +216,15 @@ def test_startup_nodes(self):
         """
         port_1 = 7000
         port_2 = 7001
-        startup_nodes = [ClusterNode(default_host, port_1),
-                         ClusterNode(default_host, port_2)]
+        startup_nodes = [
+            ClusterNode(default_host, port_1),
+            ClusterNode(default_host, port_2),
+        ]
         cluster = get_mocked_redis_client(startup_nodes=startup_nodes)
-        assert cluster.get_node(host=default_host, port=port_1) is not None \
-               and cluster.get_node(host=default_host, port=port_2) is not None
+        assert (
+            cluster.get_node(host=default_host, port=port_1) is not None
+            and cluster.get_node(host=default_host, port=port_2) is not None
+        )
 
     def test_empty_startup_nodes(self):
         """
@@ -225,19 +234,19 @@ def test_empty_startup_nodes(self):
             RedisCluster(startup_nodes=[])
 
         assert str(ex.value).startswith(
-            "RedisCluster requires at least one node to discover the "
-            "cluster"), str_if_bytes(ex.value)
+            "RedisCluster requires at least one node to discover the " "cluster"
+        ), str_if_bytes(ex.value)
 
     def test_from_url(self, r):
         redis_url = f"redis://{default_host}:{default_port}/0"
-        with patch.object(RedisCluster, 'from_url') as from_url:
+        with patch.object(RedisCluster, "from_url") as from_url:
+
             def from_url_mocked(_url, **_kwargs):
                 return get_mocked_redis_client(url=_url, **_kwargs)
 
             from_url.side_effect = from_url_mocked
             cluster = RedisCluster.from_url(redis_url)
-        assert cluster.get_node(host=default_host,
-                                port=default_port) is not None
+        assert cluster.get_node(host=default_host, port=default_port) is not None
 
     def test_execute_command_errors(self, r):
         """
@@ -245,8 +254,9 @@ def test_execute_command_errors(self, r):
         """
         with pytest.raises(RedisClusterException) as ex:
             r.execute_command("GET")
-        assert str(ex.value).startswith("No way to dispatch this command to "
-                                        "Redis Cluster. Missing key.")
+        assert str(ex.value).startswith(
+            "No way to dispatch this command to " "Redis Cluster. Missing key."
+        )
 
     def test_execute_command_node_flag_primaries(self, r):
         """
@@ -254,7 +264,7 @@ def test_execute_command_node_flag_primaries(self, r):
         """
         primaries = r.get_primaries()
         replicas = r.get_replicas()
-        mock_all_nodes_resp(r, 'PONG')
+        mock_all_nodes_resp(r, "PONG")
         assert r.ping(RedisCluster.PRIMARIES) is True
         for primary in primaries:
             conn = primary.redis_connection.connection
@@ -271,7 +281,7 @@ def test_execute_command_node_flag_replicas(self, r):
         if not replicas:
             r = get_mocked_redis_client(default_host, default_port)
         primaries = r.get_primaries()
-        mock_all_nodes_resp(r, 'PONG')
+        mock_all_nodes_resp(r, "PONG")
         assert r.ping(RedisCluster.REPLICAS) is True
         for replica in replicas:
             conn = replica.redis_connection.connection
@@ -284,7 +294,7 @@ def test_execute_command_node_flag_all_nodes(self, r):
         """
         Test command execution with nodes flag ALL_NODES
         """
-        mock_all_nodes_resp(r, 'PONG')
+        mock_all_nodes_resp(r, "PONG")
         assert r.ping(RedisCluster.ALL_NODES) is True
         for node in r.get_nodes():
             conn = node.redis_connection.connection
@@ -294,7 +304,7 @@ def test_execute_command_node_flag_random(self, r):
         """
         Test command execution with nodes flag RANDOM
         """
-        mock_all_nodes_resp(r, 'PONG')
+        mock_all_nodes_resp(r, "PONG")
         assert r.ping(RedisCluster.RANDOM) is True
         called_count = 0
         for node in r.get_nodes():
@@ -309,7 +319,7 @@ def test_execute_command_default_node(self, r):
         default node
         """
         def_node = r.get_default_node()
-        mock_node_resp(def_node, 'PONG')
+        mock_node_resp(def_node, "PONG")
         assert r.ping() is True
         conn = def_node.redis_connection.connection
         assert conn.read_response.called
@@ -324,7 +334,8 @@ def test_ask_redirection(self, r):
         Important thing to verify is that it tries to talk to the second node.
         """
         redirect_node = r.get_nodes()[0]
-        with patch.object(Redis, 'parse_response') as parse_response:
+        with patch.object(Redis, "parse_response") as parse_response:
+
             def ask_redirect_effect(connection, *args, **options):
                 def ok_response(connection, *args, **options):
                     assert connection.host == redirect_node.host
@@ -356,26 +367,22 @@ def test_refresh_using_specific_nodes(self, request):
         Test making calls on specific nodes when the cluster has failed over to
         another node
         """
-        node_7006 = ClusterNode(host=default_host, port=7006,
-                                server_type=PRIMARY)
-        node_7007 = ClusterNode(host=default_host, port=7007,
-                                server_type=PRIMARY)
-        with patch.object(Redis, 'parse_response') as parse_response:
-            with patch.object(NodesManager, 'initialize', autospec=True) as \
-                    initialize:
-                with patch.multiple(Connection,
-                                    send_command=DEFAULT,
-                                    connect=DEFAULT,
-                                    can_read=DEFAULT) as mocks:
+        node_7006 = ClusterNode(host=default_host, port=7006, server_type=PRIMARY)
+        node_7007 = ClusterNode(host=default_host, port=7007, server_type=PRIMARY)
+        with patch.object(Redis, "parse_response") as parse_response:
+            with patch.object(NodesManager, "initialize", autospec=True) as initialize:
+                with patch.multiple(
+                    Connection, send_command=DEFAULT, connect=DEFAULT, can_read=DEFAULT
+                ) as mocks:
                     # simulate 7006 as a failed node
-                    def parse_response_mock(connection, command_name,
-                                            **options):
+                    def parse_response_mock(connection, command_name, **options):
                         if connection.port == 7006:
                             parse_response.failed_calls += 1
                             raise ClusterDownError(
-                                'CLUSTERDOWN The cluster is '
-                                'down. Use CLUSTER INFO for '
-                                'more information')
+                                "CLUSTERDOWN The cluster is "
+                                "down. Use CLUSTER INFO for "
+                                "more information"
+                            )
                         elif connection.port == 7007:
                             parse_response.successful_calls += 1
 
@@ -391,8 +398,7 @@ def initialize_mock(self):
                         # After the first connection fails, a reinitialize
                         # should follow the cluster to 7007
                         def map_7007(self):
-                            self.nodes_cache = {
-                                node_7007.name: node_7007}
+                            self.nodes_cache = {node_7007.name: node_7007}
                             self.default_node = node_7007
                             self.slots_cache = {}
 
@@ -406,44 +412,52 @@ def map_7007(self):
                     parse_response.successful_calls = 0
                     parse_response.failed_calls = 0
                     initialize.side_effect = initialize_mock
-                    mocks['can_read'].return_value = False
-                    mocks['send_command'].return_value = "MOCK_OK"
-                    mocks['connect'].return_value = None
-                    with patch.object(CommandsParser, 'initialize',
-                                      autospec=True) as cmd_parser_initialize:
+                    mocks["can_read"].return_value = False
+                    mocks["send_command"].return_value = "MOCK_OK"
+                    mocks["connect"].return_value = None
+                    with patch.object(
+                        CommandsParser, "initialize", autospec=True
+                    ) as cmd_parser_initialize:
 
                         def cmd_init_mock(self, r):
-                            self.commands = {'get': {'name': 'get', 'arity': 2,
-                                                     'flags': ['readonly',
-                                                               'fast'],
-                                                     'first_key_pos': 1,
-                                                     'last_key_pos': 1,
-                                                     'step_count': 1}}
+                            self.commands = {
+                                "get": {
+                                    "name": "get",
+                                    "arity": 2,
+                                    "flags": ["readonly", "fast"],
+                                    "first_key_pos": 1,
+                                    "last_key_pos": 1,
+                                    "step_count": 1,
+                                }
+                            }
 
                         cmd_parser_initialize.side_effect = cmd_init_mock
 
-                        rc = _get_client(
-                            RedisCluster, request, flushdb=False)
+                        rc = _get_client(RedisCluster, request, flushdb=False)
                         assert len(rc.get_nodes()) == 1
-                        assert rc.get_node(node_name=node_7006.name) is not \
-                               None
+                        assert rc.get_node(node_name=node_7006.name) is not None
 
-                        rc.get('foo')
+                        rc.get("foo")
 
                         # Cluster should now point to 7007, and there should be
                         # one failed and one successful call
                         assert len(rc.get_nodes()) == 1
-                        assert rc.get_node(node_name=node_7007.name) is not \
-                               None
+                        assert rc.get_node(node_name=node_7007.name) is not None
                         assert rc.get_node(node_name=node_7006.name) is None
                         assert parse_response.failed_calls == 1
                         assert parse_response.successful_calls == 1
 
     def test_reading_from_replicas_in_round_robin(self):
-        with patch.multiple(Connection, send_command=DEFAULT,
-                            read_response=DEFAULT, _connect=DEFAULT,
-                            can_read=DEFAULT, on_connect=DEFAULT) as mocks:
-            with patch.object(Redis, 'parse_response') as parse_response:
+        with patch.multiple(
+            Connection,
+            send_command=DEFAULT,
+            read_response=DEFAULT,
+            _connect=DEFAULT,
+            can_read=DEFAULT,
+            on_connect=DEFAULT,
+        ) as mocks:
+            with patch.object(Redis, "parse_response") as parse_response:
+
                 def parse_response_mock_first(connection, *args, **options):
                     # Primary
                     assert connection.port == 7001
@@ -465,16 +479,16 @@ def parse_response_mock_third(connection, *args, **options):
                 # do want RedisCluster.on_connect function to get called,
                 # so we'll mock some of the Connection's functions to allow it
                 parse_response.side_effect = parse_response_mock_first
-                mocks['send_command'].return_value = True
-                mocks['read_response'].return_value = "OK"
-                mocks['_connect'].return_value = True
-                mocks['can_read'].return_value = False
-                mocks['on_connect'].return_value = True
+                mocks["send_command"].return_value = True
+                mocks["read_response"].return_value = "OK"
+                mocks["_connect"].return_value = True
+                mocks["can_read"].return_value = False
+                mocks["on_connect"].return_value = True
 
                 # Create a cluster with reading from replications
-                read_cluster = get_mocked_redis_client(host=default_host,
-                                                       port=default_port,
-                                                       read_from_replicas=True)
+                read_cluster = get_mocked_redis_client(
+                    host=default_host, port=default_port, read_from_replicas=True
+                )
                 assert read_cluster.read_from_replicas is True
                 # Check that we read from the slot's nodes in a round robin
                 # matter.
@@ -483,7 +497,7 @@ def parse_response_mock_third(connection, *args, **options):
                 read_cluster.get("foo")
                 read_cluster.get("foo")
                 read_cluster.get("foo")
-                mocks['send_command'].assert_has_calls([call('READONLY')])
+                mocks["send_command"].assert_has_calls([call("READONLY")])
 
     def test_keyslot(self, r):
         """
@@ -503,8 +517,10 @@ def test_keyslot(self, r):
         assert r.keyslot(b"abc") == r.keyslot("abc")
 
     def test_get_node_name(self):
-        assert get_node_name(default_host, default_port) == \
-               f"{default_host}:{default_port}"
+        assert (
+            get_node_name(default_host, default_port)
+            == f"{default_host}:{default_port}"
+        )
 
     def test_all_nodes(self, r):
         """
@@ -520,8 +536,11 @@ def test_all_nodes_masters(self, r):
         Set a list of nodes with random primaries/replicas config and it shold
         be possible to iterate over all of them.
         """
-        nodes = [node for node in r.nodes_manager.nodes_cache.values()
-                 if node.server_type == PRIMARY]
+        nodes = [
+            node
+            for node in r.nodes_manager.nodes_cache.values()
+            if node.server_type == PRIMARY
+        ]
 
         for node in r.get_primaries():
             assert node in nodes
@@ -532,12 +551,14 @@ def test_cluster_down_overreaches_retry_attempts(self):
         command as many times as configured in cluster_error_retry_attempts
         and then raise the exception
         """
-        with patch.object(RedisCluster, '_execute_command') as execute_command:
+        with patch.object(RedisCluster, "_execute_command") as execute_command:
+
             def raise_cluster_down_error(target_node, *args, **kwargs):
                 execute_command.failed_calls += 1
                 raise ClusterDownError(
-                    'CLUSTERDOWN The cluster is down. Use CLUSTER INFO for '
-                    'more information')
+                    "CLUSTERDOWN The cluster is down. Use CLUSTER INFO for "
+                    "more information"
+                )
 
             execute_command.side_effect = raise_cluster_down_error
 
@@ -545,8 +566,7 @@ def raise_cluster_down_error(target_node, *args, **kwargs):
 
             with pytest.raises(ClusterDownError):
                 rc.get("bar")
-                assert execute_command.failed_calls == \
-                       rc.cluster_error_retry_attempts
+                assert execute_command.failed_calls == rc.cluster_error_retry_attempts
 
     def test_connection_error_overreaches_retry_attempts(self):
         """
@@ -554,7 +574,8 @@ def test_connection_error_overreaches_retry_attempts(self):
         command as many times as configured in cluster_error_retry_attempts
         and then raise the exception
         """
-        with patch.object(RedisCluster, '_execute_command') as execute_command:
+        with patch.object(RedisCluster, "_execute_command") as execute_command:
+
             def raise_conn_error(target_node, *args, **kwargs):
                 execute_command.failed_calls += 1
                 raise ConnectionError()
@@ -565,8 +586,7 @@ def raise_conn_error(target_node, *args, **kwargs):
 
             with pytest.raises(ConnectionError):
                 rc.get("bar")
-                assert execute_command.failed_calls == \
-                       rc.cluster_error_retry_attempts
+                assert execute_command.failed_calls == rc.cluster_error_retry_attempts
 
     def test_user_on_connect_function(self, request):
         """
@@ -600,7 +620,7 @@ def test_set_default_node_failure(self, r):
         test failed replacement of the default cluster node
         """
         default_node = r.get_default_node()
-        new_def_node = ClusterNode('1.1.1.1', 1111)
+        new_def_node = ClusterNode("1.1.1.1", 1111)
         assert r.set_default_node(None) is False
         assert r.set_default_node(new_def_node) is False
         assert r.get_default_node() == default_node
@@ -609,7 +629,7 @@ def test_get_node_from_key(self, r):
         """
         Test that get_node_from_key function returns the correct node
         """
-        key = 'bar'
+        key = "bar"
         slot = r.keyslot(key)
         slot_nodes = r.nodes_manager.slots_cache.get(slot)
         primary = slot_nodes[0]
@@ -627,78 +647,79 @@ class TestClusterRedisCommands:
     """
 
     def test_case_insensitive_command_names(self, r):
-        assert r.cluster_response_callbacks['cluster addslots'] == \
-               r.cluster_response_callbacks['CLUSTER ADDSLOTS']
+        assert (
+            r.cluster_response_callbacks["cluster addslots"]
+            == r.cluster_response_callbacks["CLUSTER ADDSLOTS"]
+        )
 
     def test_get_and_set(self, r):
         # get and set can't be tested independently of each other
-        assert r.get('a') is None
-        byte_string = b'value'
+        assert r.get("a") is None
+        byte_string = b"value"
         integer = 5
-        unicode_string = chr(3456) + 'abcd' + chr(3421)
-        assert r.set('byte_string', byte_string)
-        assert r.set('integer', 5)
-        assert r.set('unicode_string', unicode_string)
-        assert r.get('byte_string') == byte_string
-        assert r.get('integer') == str(integer).encode()
-        assert r.get('unicode_string').decode('utf-8') == unicode_string
+        unicode_string = chr(3456) + "abcd" + chr(3421)
+        assert r.set("byte_string", byte_string)
+        assert r.set("integer", 5)
+        assert r.set("unicode_string", unicode_string)
+        assert r.get("byte_string") == byte_string
+        assert r.get("integer") == str(integer).encode()
+        assert r.get("unicode_string").decode("utf-8") == unicode_string
 
     def test_mget_nonatomic(self, r):
         assert r.mget_nonatomic([]) == []
-        assert r.mget_nonatomic(['a', 'b']) == [None, None]
-        r['a'] = '1'
-        r['b'] = '2'
-        r['c'] = '3'
+        assert r.mget_nonatomic(["a", "b"]) == [None, None]
+        r["a"] = "1"
+        r["b"] = "2"
+        r["c"] = "3"
 
-        assert (r.mget_nonatomic('a', 'other', 'b', 'c') ==
-                [b'1', None, b'2', b'3'])
+        assert r.mget_nonatomic("a", "other", "b", "c") == [b"1", None, b"2", b"3"]
 
     def test_mset_nonatomic(self, r):
-        d = {'a': b'1', 'b': b'2', 'c': b'3', 'd': b'4'}
+        d = {"a": b"1", "b": b"2", "c": b"3", "d": b"4"}
         assert r.mset_nonatomic(d)
         for k, v in d.items():
             assert r[k] == v
 
     def test_config_set(self, r):
-        assert r.config_set('slowlog-log-slower-than', 0)
+        assert r.config_set("slowlog-log-slower-than", 0)
 
     def test_cluster_config_resetstat(self, r):
-        r.ping(target_nodes='all')
-        all_info = r.info(target_nodes='all')
+        r.ping(target_nodes="all")
+        all_info = r.info(target_nodes="all")
         prior_commands_processed = -1
         for node_info in all_info.values():
-            prior_commands_processed = node_info['total_commands_processed']
+            prior_commands_processed = node_info["total_commands_processed"]
             assert prior_commands_processed >= 1
-        r.config_resetstat(target_nodes='all')
-        all_info = r.info(target_nodes='all')
+        r.config_resetstat(target_nodes="all")
+        all_info = r.info(target_nodes="all")
         for node_info in all_info.values():
-            reset_commands_processed = node_info['total_commands_processed']
+            reset_commands_processed = node_info["total_commands_processed"]
             assert reset_commands_processed < prior_commands_processed
 
     def test_client_setname(self, r):
         node = r.get_random_node()
-        r.client_setname('redis_py_test', target_nodes=node)
+        r.client_setname("redis_py_test", target_nodes=node)
         client_name = r.client_getname(target_nodes=node)
-        assert client_name == 'redis_py_test'
+        assert client_name == "redis_py_test"
 
     def test_exists(self, r):
-        d = {'a': b'1', 'b': b'2', 'c': b'3', 'd': b'4'}
+        d = {"a": b"1", "b": b"2", "c": b"3", "d": b"4"}
         r.mset_nonatomic(d)
         assert r.exists(*d.keys()) == len(d)
 
     def test_delete(self, r):
-        d = {'a': b'1', 'b': b'2', 'c': b'3', 'd': b'4'}
+        d = {"a": b"1", "b": b"2", "c": b"3", "d": b"4"}
         r.mset_nonatomic(d)
         assert r.delete(*d.keys()) == len(d)
         assert r.delete(*d.keys()) == 0
 
     def test_touch(self, r):
-        d = {'a': b'1', 'b': b'2', 'c': b'3', 'd': b'4'}
+        d = {"a": b"1", "b": b"2", "c": b"3", "d": b"4"}
         r.mset_nonatomic(d)
         assert r.touch(*d.keys()) == len(d)
 
     def test_unlink(self, r):
-        d = {'a': b'1', 'b': b'2', 'c': b'3', 'd': b'4'}
+        d = {"a": b"1", "b": b"2", "c": b"3", "d": b"4"}
         r.mset_nonatomic(d)
         assert r.unlink(*d.keys()) == len(d)
         # Unlink is non-blocking so we sleep before
@@ -718,7 +739,7 @@ def test_pubsub_channels_merge_results(self, r):
             p = r.pubsub(node)
             pubsub_nodes.append(p)
             p.subscribe(channel)
-            b_channel = channel.encode('utf-8')
+            b_channel = channel.encode("utf-8")
             channels.append(b_channel)
             # Assert that each node returns only the channel it subscribed to
             sub_channels = node.redis_connection.pubsub_channels()
@@ -730,7 +751,7 @@ def test_pubsub_channels_merge_results(self, r):
             i += 1
         # Assert that the cluster's pubsub_channels function returns ALL of
         # the cluster's channels
-        result = r.pubsub_channels(target_nodes='all')
+        result = r.pubsub_channels(target_nodes="all")
         result.sort()
         assert result == channels
 
@@ -738,7 +759,7 @@ def test_pubsub_numsub_merge_results(self, r):
         nodes = r.get_nodes()
         pubsub_nodes = []
         channel = "foo"
-        b_channel = channel.encode('utf-8')
+        b_channel = channel.encode("utf-8")
         for node in nodes:
             # We will create different pubsub clients where each one is
             # connected to a different node
@@ -753,8 +774,7 @@ def test_pubsub_numsub_merge_results(self, r):
             assert sub_chann_num == [(b_channel, 1)]
         # Assert that the cluster's pubsub_numsub function returns ALL clients
         # subscribed to this channel in the entire cluster
-        assert r.pubsub_numsub(channel, target_nodes='all') == \
-               [(b_channel, len(nodes))]
+        assert r.pubsub_numsub(channel, target_nodes="all") == [(b_channel, len(nodes))]
 
     def test_pubsub_numpat_merge_results(self, r):
         nodes = r.get_nodes()
@@ -774,35 +794,35 @@ def test_pubsub_numpat_merge_results(self, r):
             assert sub_num_pat == 1
         # Assert that the cluster's pubsub_numsub function returns ALL clients
         # subscribed to this channel in the entire cluster
-        assert r.pubsub_numpat(target_nodes='all') == len(nodes)
+        assert r.pubsub_numpat(target_nodes="all") == len(nodes)
 
-    @skip_if_server_version_lt('2.8.0')
+    @skip_if_server_version_lt("2.8.0")
     def test_cluster_pubsub_channels(self, r):
         p = r.pubsub()
-        p.subscribe('foo', 'bar', 'baz', 'quux')
+        p.subscribe("foo", "bar", "baz", "quux")
         for i in range(4):
-            assert wait_for_message(p, timeout=0.5)['type'] == 'subscribe'
-        expected = [b'bar', b'baz', b'foo', b'quux']
-        assert all([channel in r.pubsub_channels(target_nodes='all')
-                    for channel in expected])
+            assert wait_for_message(p, timeout=0.5)["type"] == "subscribe"
+        expected = [b"bar", b"baz", b"foo", b"quux"]
+        assert all(
+            [channel in r.pubsub_channels(target_nodes="all") for channel in expected]
+        )
 
-    @skip_if_server_version_lt('2.8.0')
+    @skip_if_server_version_lt("2.8.0")
     def test_cluster_pubsub_numsub(self, r):
         p1 = r.pubsub()
-        p1.subscribe('foo', 'bar', 'baz')
+        p1.subscribe("foo", "bar", "baz")
         for i in range(3):
-            assert wait_for_message(p1, timeout=0.5)['type'] == 'subscribe'
+            assert wait_for_message(p1, timeout=0.5)["type"] == "subscribe"
         p2 = r.pubsub()
-        p2.subscribe('bar', 'baz')
+        p2.subscribe("bar", "baz")
         for i in range(2):
-            assert wait_for_message(p2, timeout=0.5)['type'] == 'subscribe'
+            assert wait_for_message(p2, timeout=0.5)["type"] == "subscribe"
         p3 = r.pubsub()
-        p3.subscribe('baz')
-        assert wait_for_message(p3, timeout=0.5)['type'] == 'subscribe'
+        p3.subscribe("baz")
+        assert wait_for_message(p3, timeout=0.5)["type"] == "subscribe"
 
-        channels = [(b'foo', 1), (b'bar', 2), (b'baz', 3)]
-        assert r.pubsub_numsub('foo', 'bar', 'baz', target_nodes='all') \
-               == channels
+        channels = [(b"foo", 1), (b"bar", 2), (b"baz", 3)]
+        assert r.pubsub_numsub("foo", "bar", "baz", target_nodes="all") == channels
 
     def test_cluster_slots(self, r):
         mock_all_nodes_resp(r, default_cluster_slots)
@@ -810,12 +830,11 @@ def test_cluster_slots(self, r):
         assert isinstance(cluster_slots, dict)
         assert len(default_cluster_slots) == len(cluster_slots)
         assert cluster_slots.get((0, 8191)) is not None
-        assert cluster_slots.get((0, 8191)).get('primary') == \
-               ('127.0.0.1', 7000)
+        assert cluster_slots.get((0, 8191)).get("primary") == ("127.0.0.1", 7000)
 
     def test_cluster_addslots(self, r):
         node = r.get_random_node()
-        mock_node_resp(node, 'OK')
+        mock_node_resp(node, "OK")
         assert r.cluster_addslots(node, 1, 2, 3) is True
 
     def test_cluster_countkeysinslot(self, r):
@@ -825,22 +844,25 @@ def test_cluster_countkeysinslot(self, r):
 
     def test_cluster_count_failure_report(self, r):
         mock_all_nodes_resp(r, 0)
-        assert r.cluster_count_failure_report('node_0') == 0
+        assert r.cluster_count_failure_report("node_0") == 0
 
     def test_cluster_delslots(self):
         cluster_slots = [
             [
-                0, 8191,
-                ['127.0.0.1', 7000, 'node_0'],
+                0,
+                8191,
+                ["127.0.0.1", 7000, "node_0"],
             ],
             [
-                8192, 16383,
-                ['127.0.0.1', 7001, 'node_1'],
-            ]
+                8192,
+                16383,
+                ["127.0.0.1", 7001, "node_1"],
+            ],
         ]
-        r = get_mocked_redis_client(host=default_host, port=default_port,
-                                    cluster_slots=cluster_slots)
-        mock_all_nodes_resp(r, 'OK')
+        r = get_mocked_redis_client(
+            host=default_host, port=default_port, cluster_slots=cluster_slots
+        )
+        mock_all_nodes_resp(r, "OK")
         node0 = r.get_node(default_host, 7000)
         node1 = r.get_node(default_host, 7001)
         assert r.cluster_delslots(0, 8192) == [True, True]
@@ -849,59 +871,61 @@ def test_cluster_delslots(self):
 
     def test_cluster_failover(self, r):
         node = r.get_random_node()
-        mock_node_resp(node, 'OK')
+        mock_node_resp(node, "OK")
         assert r.cluster_failover(node) is True
-        assert r.cluster_failover(node, 'FORCE') is True
-        assert r.cluster_failover(node, 'TAKEOVER') is True
+        assert r.cluster_failover(node, "FORCE") is True
+        assert r.cluster_failover(node, "TAKEOVER") is True
         with pytest.raises(RedisError):
-            r.cluster_failover(node, 'FORCT')
+            r.cluster_failover(node, "FORCT")
 
     def test_cluster_info(self, r):
         info = r.cluster_info()
         assert isinstance(info, dict)
-        assert info['cluster_state'] == 'ok'
+        assert info["cluster_state"] == "ok"
 
     def test_cluster_keyslot(self, r):
         mock_all_nodes_resp(r, 12182)
-        assert r.cluster_keyslot('foo') == 12182
+        assert r.cluster_keyslot("foo") == 12182
 
     def test_cluster_meet(self, r):
         node = r.get_default_node()
-        mock_node_resp(node, 'OK')
-        assert r.cluster_meet('127.0.0.1', 6379) is True
+        mock_node_resp(node, "OK")
+        assert r.cluster_meet("127.0.0.1", 6379) is True
 
     def test_cluster_nodes(self, r):
         response = (
-            'c8253bae761cb1ecb2b61857d85dfe455a0fec8b 172.17.0.7:7006 '
-            'slave aa90da731f673a99617dfe930306549a09f83a6b 0 '
-            '1447836263059 5 connected\n'
-            '9bd595fe4821a0e8d6b99d70faa660638a7612b3 172.17.0.7:7008 '
-            'master - 0 1447836264065 0 connected\n'
-            'aa90da731f673a99617dfe930306549a09f83a6b 172.17.0.7:7003 '
-            'myself,master - 0 0 2 connected 5461-10922\n'
-            '1df047e5a594f945d82fc140be97a1452bcbf93e 172.17.0.7:7007 '
-            'slave 19efe5a631f3296fdf21a5441680f893e8cc96ec 0 '
-            '1447836262556 3 connected\n'
-            '4ad9a12e63e8f0207025eeba2354bcf4c85e5b22 172.17.0.7:7005 '
-            'master - 0 1447836262555 7 connected 0-5460\n'
-            '19efe5a631f3296fdf21a5441680f893e8cc96ec 172.17.0.7:7004 '
-            'master - 0 1447836263562 3 connected 10923-16383\n'
-            'fbb23ed8cfa23f17eaf27ff7d0c410492a1093d6 172.17.0.7:7002 '
-            'master,fail - 1447829446956 1447829444948 1 disconnected\n'
+            "c8253bae761cb1ecb2b61857d85dfe455a0fec8b 172.17.0.7:7006 "
+            "slave aa90da731f673a99617dfe930306549a09f83a6b 0 "
+            "1447836263059 5 connected\n"
+            "9bd595fe4821a0e8d6b99d70faa660638a7612b3 172.17.0.7:7008 "
+            "master - 0 1447836264065 0 connected\n"
+            "aa90da731f673a99617dfe930306549a09f83a6b 172.17.0.7:7003 "
+            "myself,master - 0 0 2 connected 5461-10922\n"
+            "1df047e5a594f945d82fc140be97a1452bcbf93e 172.17.0.7:7007 "
+            "slave 19efe5a631f3296fdf21a5441680f893e8cc96ec 0 "
+            "1447836262556 3 connected\n"
+            "4ad9a12e63e8f0207025eeba2354bcf4c85e5b22 172.17.0.7:7005 "
+            "master - 0 1447836262555 7 connected 0-5460\n"
+            "19efe5a631f3296fdf21a5441680f893e8cc96ec 172.17.0.7:7004 "
+            "master - 0 1447836263562 3 connected 10923-16383\n"
+            "fbb23ed8cfa23f17eaf27ff7d0c410492a1093d6 172.17.0.7:7002 "
+            "master,fail - 1447829446956 1447829444948 1 disconnected\n"
         )
         mock_all_nodes_resp(r, response)
         nodes = r.cluster_nodes()
         assert len(nodes) == 7
-        assert nodes.get('172.17.0.7:7006') is not None
-        assert nodes.get('172.17.0.7:7006').get('node_id') == \
-               "c8253bae761cb1ecb2b61857d85dfe455a0fec8b"
+        assert nodes.get("172.17.0.7:7006") is not None
+        assert (
+            nodes.get("172.17.0.7:7006").get("node_id")
+            == "c8253bae761cb1ecb2b61857d85dfe455a0fec8b"
+        )
 
     def test_cluster_replicate(self, r):
         node = r.get_random_node()
         all_replicas = r.get_replicas()
-        mock_all_nodes_resp(r, 'OK')
-        assert r.cluster_replicate(node, 'c8253bae761cb61857d') is True
-        results = r.cluster_replicate(all_replicas, 'c8253bae761cb61857d')
+        mock_all_nodes_resp(r, "OK")
+        assert r.cluster_replicate(node, "c8253bae761cb61857d") is True
+        results = r.cluster_replicate(all_replicas, "c8253bae761cb61857d")
         if isinstance(results, dict):
             for res in results.values():
                 assert res is True
@@ -909,74 +933,78 @@ def test_cluster_replicate(self, r):
             assert results is True
 
     def test_cluster_reset(self, r):
-        mock_all_nodes_resp(r, 'OK')
+        mock_all_nodes_resp(r, "OK")
         assert r.cluster_reset() is True
         assert r.cluster_reset(False) is True
-        all_results = r.cluster_reset(False, target_nodes='all')
+        all_results = r.cluster_reset(False, target_nodes="all")
         for res in all_results.values():
             assert res is True
 
     def test_cluster_save_config(self, r):
         node = r.get_random_node()
         all_nodes = r.get_nodes()
-        mock_all_nodes_resp(r, 'OK')
+        mock_all_nodes_resp(r, "OK")
         assert r.cluster_save_config(node) is True
         all_results = r.cluster_save_config(all_nodes)
         for res in all_results.values():
             assert res is True
 
     def test_cluster_get_keys_in_slot(self, r):
-        response = [b'{foo}1', b'{foo}2']
+        response = [b"{foo}1", b"{foo}2"]
         node = r.nodes_manager.get_node_from_slot(12182)
         mock_node_resp(node, response)
         keys = r.cluster_get_keys_in_slot(12182, 4)
         assert keys == response
 
     def test_cluster_set_config_epoch(self, r):
-        mock_all_nodes_resp(r, 'OK')
+        mock_all_nodes_resp(r, "OK")
         assert r.cluster_set_config_epoch(3) is True
-        all_results = r.cluster_set_config_epoch(3, target_nodes='all')
+        all_results = r.cluster_set_config_epoch(3, target_nodes="all")
         for res in all_results.values():
             assert res is True
 
     def test_cluster_setslot(self, r):
         node = r.get_random_node()
-        mock_node_resp(node, 'OK')
-        assert r.cluster_setslot(node, 'node_0', 1218, 'IMPORTING') is True
-        assert r.cluster_setslot(node, 'node_0', 1218, 'NODE') is True
-        assert r.cluster_setslot(node, 'node_0', 1218, 'MIGRATING') is True
+        mock_node_resp(node, "OK")
+        assert r.cluster_setslot(node, "node_0", 1218, "IMPORTING") is True
+        assert r.cluster_setslot(node, "node_0", 1218, "NODE") is True
+        assert r.cluster_setslot(node, "node_0", 1218, "MIGRATING") is True
         with pytest.raises(RedisError):
-            r.cluster_failover(node, 'STABLE')
+            r.cluster_failover(node, "STABLE")
         with pytest.raises(RedisError):
-            r.cluster_failover(node, 'STATE')
+            r.cluster_failover(node, "STATE")
 
     def test_cluster_setslot_stable(self, r):
         node = r.nodes_manager.get_node_from_slot(12182)
-        mock_node_resp(node, 'OK')
+        mock_node_resp(node, "OK")
         assert r.cluster_setslot_stable(12182) is True
         assert node.redis_connection.connection.read_response.called
 
     def test_cluster_replicas(self, r):
-        response = [b'01eca22229cf3c652b6fca0d09ff6941e0d2e3 '
-                    b'127.0.0.1:6377@16377 slave '
-                    b'52611e796814b78e90ad94be9d769a4f668f9a 0 '
-                    b'1634550063436 4 connected',
-                    b'r4xfga22229cf3c652b6fca0d09ff69f3e0d4d '
-                    b'127.0.0.1:6378@16378 slave '
-                    b'52611e796814b78e90ad94be9d769a4f668f9a 0 '
-                    b'1634550063436 4 connected']
+        response = [
+            b"01eca22229cf3c652b6fca0d09ff6941e0d2e3 "
+            b"127.0.0.1:6377@16377 slave "
+            b"52611e796814b78e90ad94be9d769a4f668f9a 0 "
+            b"1634550063436 4 connected",
+            b"r4xfga22229cf3c652b6fca0d09ff69f3e0d4d "
+            b"127.0.0.1:6378@16378 slave "
+            b"52611e796814b78e90ad94be9d769a4f668f9a 0 "
+            b"1634550063436 4 connected",
+        ]
         mock_all_nodes_resp(r, response)
-        replicas = r.cluster_replicas('52611e796814b78e90ad94be9d769a4f668f9a')
-        assert replicas.get('127.0.0.1:6377') is not None
-        assert replicas.get('127.0.0.1:6378') is not None
-        assert replicas.get('127.0.0.1:6378').get('node_id') == \
-               'r4xfga22229cf3c652b6fca0d09ff69f3e0d4d'
+        replicas = r.cluster_replicas("52611e796814b78e90ad94be9d769a4f668f9a")
+        assert replicas.get("127.0.0.1:6377") is not None
+        assert replicas.get("127.0.0.1:6378") is not None
+        assert (
+            replicas.get("127.0.0.1:6378").get("node_id")
+            == "r4xfga22229cf3c652b6fca0d09ff69f3e0d4d"
+        )
 
     def test_readonly(self):
         r = get_mocked_redis_client(host=default_host, port=default_port)
-        mock_all_nodes_resp(r, 'OK')
+        mock_all_nodes_resp(r, "OK")
         assert r.readonly() is True
-        all_replicas_results = r.readonly(target_nodes='replicas')
+        all_replicas_results = r.readonly(target_nodes="replicas")
         for res in all_replicas_results.values():
             assert res is True
         for replica in r.get_replicas():
@@ -984,9 +1012,9 @@ def test_readonly(self):
 
     def test_readwrite(self):
         r = get_mocked_redis_client(host=default_host, port=default_port)
-        mock_all_nodes_resp(r, 'OK')
+        mock_all_nodes_resp(r, "OK")
         assert r.readwrite() is True
-        all_replicas_results = r.readwrite(target_nodes='replicas')
+        all_replicas_results = r.readwrite(target_nodes="replicas")
         for res in all_replicas_results.values():
             assert res is True
         for replica in r.get_replicas():
@@ -999,59 +1027,59 @@ def test_bgsave(self, r):
 
     def test_info(self, r):
         # Map keys to same slot
-        r.set('x{1}', 1)
-        r.set('y{1}', 2)
-        r.set('z{1}', 3)
+        r.set("x{1}", 1)
+        r.set("y{1}", 2)
+        r.set("z{1}", 3)
         # Get node that handles the slot
-        slot = r.keyslot('x{1}')
+        slot = r.keyslot("x{1}")
         node = r.nodes_manager.get_node_from_slot(slot)
         # Run info on that node
         info = r.info(target_nodes=node)
         assert isinstance(info, dict)
-        assert info['db0']['keys'] == 3
+        assert info["db0"]["keys"] == 3
 
     def _init_slowlog_test(self, r, node):
-        slowlog_lim = r.config_get('slowlog-log-slower-than',
-                                   target_nodes=node)
-        assert r.config_set('slowlog-log-slower-than', 0, target_nodes=node) \
-               is True
-        return slowlog_lim['slowlog-log-slower-than']
+        slowlog_lim = r.config_get("slowlog-log-slower-than", target_nodes=node)
+        assert r.config_set("slowlog-log-slower-than", 0, target_nodes=node) is True
+        return slowlog_lim["slowlog-log-slower-than"]
 
     def _teardown_slowlog_test(self, r, node, prev_limit):
-        assert r.config_set('slowlog-log-slower-than', prev_limit,
-                            target_nodes=node) is True
+        assert (
+            r.config_set("slowlog-log-slower-than", prev_limit, target_nodes=node)
+            is True
+        )
 
     def test_slowlog_get(self, r, slowlog):
-        unicode_string = chr(3456) + 'abcd' + chr(3421)
+        unicode_string = chr(3456) + "abcd" + chr(3421)
         node = r.get_node_from_key(unicode_string)
         slowlog_limit = self._init_slowlog_test(r, node)
         assert r.slowlog_reset(target_nodes=node)
         r.get(unicode_string)
         slowlog = r.slowlog_get(target_nodes=node)
         assert isinstance(slowlog, list)
-        commands = [log['command'] for log in slowlog]
+        commands = [log["command"] for log in slowlog]
 
-        get_command = b' '.join((b'GET', unicode_string.encode('utf-8')))
+        get_command = b" ".join((b"GET", unicode_string.encode("utf-8")))
         assert get_command in commands
-        assert b'SLOWLOG RESET' in commands
+        assert b"SLOWLOG RESET" in commands
 
         # the order should be ['GET <uni string>', 'SLOWLOG RESET'],
         # but if other clients are executing commands at the same time, there
         # could be commands, before, between, or after, so just check that
         # the two we care about are in the appropriate order.
-        assert commands.index(get_command) < commands.index(b'SLOWLOG RESET')
+        assert commands.index(get_command) < commands.index(b"SLOWLOG RESET")
 
         # make sure other attributes are typed correctly
-        assert isinstance(slowlog[0]['start_time'], int)
-        assert isinstance(slowlog[0]['duration'], int)
+        assert isinstance(slowlog[0]["start_time"], int)
+        assert isinstance(slowlog[0]["duration"], int)
         # rollback the slowlog limit to its original value
         self._teardown_slowlog_test(r, node, slowlog_limit)
 
     def test_slowlog_get_limit(self, r, slowlog):
         assert r.slowlog_reset()
-        node = r.get_node_from_key('foo')
+        node = r.get_node_from_key("foo")
         slowlog_limit = self._init_slowlog_test(r, node)
-        r.get('foo')
+        r.get("foo")
         slowlog = r.slowlog_get(1, target_nodes=node)
         assert isinstance(slowlog, list)
         # only one command, based on the number we passed to slowlog_get()
@@ -1059,8 +1087,8 @@ def test_slowlog_get_limit(self, r, slowlog):
         self._teardown_slowlog_test(r, node, slowlog_limit)
 
     def test_slowlog_length(self, r, slowlog):
-        r.get('foo')
-        node = r.nodes_manager.get_node_from_slot(key_slot(b'foo'))
+        r.get("foo")
+        node = r.nodes_manager.get_node_from_slot(key_slot(b"foo"))
         slowlog_len = r.slowlog_len(target_nodes=node)
         assert isinstance(slowlog_len, int)
 
@@ -1070,47 +1098,46 @@ def test_time(self, r):
         assert isinstance(t[0], int)
         assert isinstance(t[1], int)
 
-    @skip_if_server_version_lt('4.0.0')
+    @skip_if_server_version_lt("4.0.0")
     def test_memory_usage(self, r):
-        r.set('foo', 'bar')
-        assert isinstance(r.memory_usage('foo'), int)
+        r.set("foo", "bar")
+        assert isinstance(r.memory_usage("foo"), int)
 
-    @skip_if_server_version_lt('4.0.0')
+    @skip_if_server_version_lt("4.0.0")
     def test_memory_malloc_stats(self, r):
         assert r.memory_malloc_stats()
 
-    @skip_if_server_version_lt('4.0.0')
+    @skip_if_server_version_lt("4.0.0")
     def test_memory_stats(self, r):
         # put a key into the current db to make sure that "db.<current-db>"
         # has data
-        r.set('foo', 'bar')
-        node = r.nodes_manager.get_node_from_slot(key_slot(b'foo'))
+        r.set("foo", "bar")
+        node = r.nodes_manager.get_node_from_slot(key_slot(b"foo"))
         stats = r.memory_stats(target_nodes=node)
         assert isinstance(stats, dict)
         for key, value in stats.items():
-            if key.startswith('db.'):
+            if key.startswith("db."):
                 assert isinstance(value, dict)
 
-    @skip_if_server_version_lt('4.0.0')
+    @skip_if_server_version_lt("4.0.0")
     def test_memory_help(self, r):
         with pytest.raises(NotImplementedError):
             r.memory_help()
 
-    @skip_if_server_version_lt('4.0.0')
+    @skip_if_server_version_lt("4.0.0")
     def test_memory_doctor(self, r):
         with pytest.raises(NotImplementedError):
             r.memory_doctor()
 
     def test_lastsave(self, r):
         node = r.get_primaries()[0]
-        assert isinstance(r.lastsave(target_nodes=node),
-                          datetime.datetime)
+        assert isinstance(r.lastsave(target_nodes=node), datetime.datetime)
 
     def test_cluster_echo(self, r):
         node = r.get_primaries()[0]
-        assert r.echo('foo bar', node) == b'foo bar'
+        assert r.echo("foo bar", node) == b"foo bar"
 
-    @skip_if_server_version_lt('1.0.0')
+    @skip_if_server_version_lt("1.0.0")
     def test_debug_segfault(self, r):
         with pytest.raises(NotImplementedError):
             r.debug_segfault()
@@ -1118,39 +1145,41 @@ def test_debug_segfault(self, r):
     def test_config_resetstat(self, r):
         node = r.get_primaries()[0]
         r.ping(target_nodes=node)
-        prior_commands_processed = \
-            int(r.info(target_nodes=node)['total_commands_processed'])
+        prior_commands_processed = int(
+            r.info(target_nodes=node)["total_commands_processed"]
+        )
         assert prior_commands_processed >= 1
         r.config_resetstat(target_nodes=node)
-        reset_commands_processed = \
-            int(r.info(target_nodes=node)['total_commands_processed'])
+        reset_commands_processed = int(
+            r.info(target_nodes=node)["total_commands_processed"]
+        )
         assert reset_commands_processed < prior_commands_processed
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_client_trackinginfo(self, r):
         node = r.get_primaries()[0]
         res = r.client_trackinginfo(target_nodes=node)
         assert len(res) > 2
-        assert 'prefixes' in res
+        assert "prefixes" in res
 
-    @skip_if_server_version_lt('2.9.50')
+    @skip_if_server_version_lt("2.9.50")
     def test_client_pause(self, r):
         node = r.get_primaries()[0]
         assert r.client_pause(1, target_nodes=node)
         assert r.client_pause(timeout=1, target_nodes=node)
         with pytest.raises(RedisError):
-            r.client_pause(timeout='not an integer', target_nodes=node)
+            r.client_pause(timeout="not an integer", target_nodes=node)
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_client_unpause(self, r):
         assert r.client_unpause()
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_client_id(self, r):
         node = r.get_primaries()[0]
         assert r.client_id(target_nodes=node) > 0
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_client_unblock(self, r):
         node = r.get_primaries()[0]
         myid = r.client_id(target_nodes=node)
@@ -1158,82 +1187,88 @@ def test_client_unblock(self, r):
         assert not r.client_unblock(myid, error=True, target_nodes=node)
         assert not r.client_unblock(myid, error=False, target_nodes=node)
 
-    @skip_if_server_version_lt('6.0.0')
+    @skip_if_server_version_lt("6.0.0")
     def test_client_getredir(self, r):
         node = r.get_primaries()[0]
         assert isinstance(r.client_getredir(target_nodes=node), int)
         assert r.client_getredir(target_nodes=node) == -1
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_client_info(self, r):
         node = r.get_primaries()[0]
         info = r.client_info(target_nodes=node)
         assert isinstance(info, dict)
-        assert 'addr' in info
+        assert "addr" in info
 
-    @skip_if_server_version_lt('2.6.9')
+    @skip_if_server_version_lt("2.6.9")
     def test_client_kill(self, r, r2):
         node = r.get_primaries()[0]
-        r.client_setname('redis-py-c1', target_nodes='all')
-        r2.client_setname('redis-py-c2', target_nodes='all')
-        clients = [client for client in r.client_list(target_nodes=node)
-                   if client.get('name') in ['redis-py-c1', 'redis-py-c2']]
+        r.client_setname("redis-py-c1", target_nodes="all")
+        r2.client_setname("redis-py-c2", target_nodes="all")
+        clients = [
+            client
+            for client in r.client_list(target_nodes=node)
+            if client.get("name") in ["redis-py-c1", "redis-py-c2"]
+        ]
         assert len(clients) == 2
-        clients_by_name = {client.get('name'): client for client in clients}
+        clients_by_name = {client.get("name"): client for client in clients}
 
-        client_addr = clients_by_name['redis-py-c2'].get('addr')
+        client_addr = clients_by_name["redis-py-c2"].get("addr")
         assert r.client_kill(client_addr, target_nodes=node) is True
 
-        clients = [client for client in r.client_list(target_nodes=node)
-                   if client.get('name') in ['redis-py-c1', 'redis-py-c2']]
+        clients = [
+            client
+            for client in r.client_list(target_nodes=node)
+            if client.get("name") in ["redis-py-c1", "redis-py-c2"]
+        ]
         assert len(clients) == 1
-        assert clients[0].get('name') == 'redis-py-c1'
+        assert clients[0].get("name") == "redis-py-c1"
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_cluster_bitop_not_empty_string(self, r):
-        r['{foo}a'] = ''
-        r.bitop('not', '{foo}r', '{foo}a')
-        assert r.get('{foo}r') is None
+        r["{foo}a"] = ""
+        r.bitop("not", "{foo}r", "{foo}a")
+        assert r.get("{foo}r") is None
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_cluster_bitop_not(self, r):
-        test_str = b'\xAA\x00\xFF\x55'
+        test_str = b"\xAA\x00\xFF\x55"
         correct = ~0xAA00FF55 & 0xFFFFFFFF
-        r['{foo}a'] = test_str
-        r.bitop('not', '{foo}r', '{foo}a')
-        assert int(binascii.hexlify(r['{foo}r']), 16) == correct
+        r["{foo}a"] = test_str
+        r.bitop("not", "{foo}r", "{foo}a")
+        assert int(binascii.hexlify(r["{foo}r"]), 16) == correct
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_cluster_bitop_not_in_place(self, r):
-        test_str = b'\xAA\x00\xFF\x55'
+        test_str = b"\xAA\x00\xFF\x55"
         correct = ~0xAA00FF55 & 0xFFFFFFFF
-        r['{foo}a'] = test_str
-        r.bitop('not', '{foo}a', '{foo}a')
-        assert int(binascii.hexlify(r['{foo}a']), 16) == correct
+        r["{foo}a"] = test_str
+        r.bitop("not", "{foo}a", "{foo}a")
+        assert int(binascii.hexlify(r["{foo}a"]), 16) == correct
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_cluster_bitop_single_string(self, r):
-        test_str = b'\x01\x02\xFF'
-        r['{foo}a'] = test_str
-        r.bitop('and', '{foo}res1', '{foo}a')
-        r.bitop('or', '{foo}res2', '{foo}a')
-        r.bitop('xor', '{foo}res3', '{foo}a')
-        assert r['{foo}res1'] == test_str
-        assert r['{foo}res2'] == test_str
-        assert r['{foo}res3'] == test_str
-
-    @skip_if_server_version_lt('2.6.0')
+        test_str = b"\x01\x02\xFF"
+        r["{foo}a"] = test_str
+        r.bitop("and", "{foo}res1", "{foo}a")
+        r.bitop("or", "{foo}res2", "{foo}a")
+        r.bitop("xor", "{foo}res3", "{foo}a")
+        assert r["{foo}res1"] == test_str
+        assert r["{foo}res2"] == test_str
+        assert r["{foo}res3"] == test_str
+
+    @skip_if_server_version_lt("2.6.0")
     def test_cluster_bitop_string_operands(self, r):
-        r['{foo}a'] = b'\x01\x02\xFF\xFF'
-        r['{foo}b'] = b'\x01\x02\xFF'
-        r.bitop('and', '{foo}res1', '{foo}a', '{foo}b')
-        r.bitop('or', '{foo}res2', '{foo}a', '{foo}b')
-        r.bitop('xor', '{foo}res3', '{foo}a', '{foo}b')
-        assert int(binascii.hexlify(r['{foo}res1']), 16) == 0x0102FF00
-        assert int(binascii.hexlify(r['{foo}res2']), 16) == 0x0102FFFF
-        assert int(binascii.hexlify(r['{foo}res3']), 16) == 0x000000FF
-
-    @skip_if_server_version_lt('6.2.0')
+        r["{foo}a"] = b"\x01\x02\xFF\xFF"
+        r["{foo}b"] = b"\x01\x02\xFF"
+        r.bitop("and", "{foo}res1", "{foo}a", "{foo}b")
+        r.bitop("or", "{foo}res2", "{foo}a", "{foo}b")
+        r.bitop("xor", "{foo}res3", "{foo}a", "{foo}b")
+        assert int(binascii.hexlify(r["{foo}res1"]), 16) == 0x0102FF00
+        assert int(binascii.hexlify(r["{foo}res2"]), 16) == 0x0102FFFF
+        assert int(binascii.hexlify(r["{foo}res3"]), 16) == 0x000000FF
+
+    @skip_if_server_version_lt("6.2.0")
     def test_cluster_copy(self, r):
         assert r.copy("{foo}a", "{foo}b") == 0
         r.set("{foo}a", "bar")
@@ -1241,449 +1276,493 @@ def test_cluster_copy(self, r):
         assert r.get("{foo}a") == b"bar"
         assert r.get("{foo}b") == b"bar"
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_cluster_copy_and_replace(self, r):
         r.set("{foo}a", "foo1")
         r.set("{foo}b", "foo2")
         assert r.copy("{foo}a", "{foo}b") == 0
         assert r.copy("{foo}a", "{foo}b", replace=True) == 1
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_cluster_lmove(self, r):
-        r.rpush('{foo}a', 'one', 'two', 'three', 'four')
-        assert r.lmove('{foo}a', '{foo}b')
-        assert r.lmove('{foo}a', '{foo}b', 'right', 'left')
+        r.rpush("{foo}a", "one", "two", "three", "four")
+        assert r.lmove("{foo}a", "{foo}b")
+        assert r.lmove("{foo}a", "{foo}b", "right", "left")
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_cluster_blmove(self, r):
-        r.rpush('{foo}a', 'one', 'two', 'three', 'four')
-        assert r.blmove('{foo}a', '{foo}b', 5)
-        assert r.blmove('{foo}a', '{foo}b', 1, 'RIGHT', 'LEFT')
+        r.rpush("{foo}a", "one", "two", "three", "four")
+        assert r.blmove("{foo}a", "{foo}b", 5)
+        assert r.blmove("{foo}a", "{foo}b", 1, "RIGHT", "LEFT")
 
     def test_cluster_msetnx(self, r):
-        d = {'{foo}a': b'1', '{foo}b': b'2', '{foo}c': b'3'}
+        d = {"{foo}a": b"1", "{foo}b": b"2", "{foo}c": b"3"}
         assert r.msetnx(d)
-        d2 = {'{foo}a': b'x', '{foo}d': b'4'}
+        d2 = {"{foo}a": b"x", "{foo}d": b"4"}
         assert not r.msetnx(d2)
         for k, v in d.items():
             assert r[k] == v
-        assert r.get('{foo}d') is None
+        assert r.get("{foo}d") is None
 
     def test_cluster_rename(self, r):
-        r['{foo}a'] = '1'
-        assert r.rename('{foo}a', '{foo}b')
-        assert r.get('{foo}a') is None
-        assert r['{foo}b'] == b'1'
+        r["{foo}a"] = "1"
+        assert r.rename("{foo}a", "{foo}b")
+        assert r.get("{foo}a") is None
+        assert r["{foo}b"] == b"1"
 
     def test_cluster_renamenx(self, r):
-        r['{foo}a'] = '1'
-        r['{foo}b'] = '2'
-        assert not r.renamenx('{foo}a', '{foo}b')
-        assert r['{foo}a'] == b'1'
-        assert r['{foo}b'] == b'2'
+        r["{foo}a"] = "1"
+        r["{foo}b"] = "2"
+        assert not r.renamenx("{foo}a", "{foo}b")
+        assert r["{foo}a"] == b"1"
+        assert r["{foo}b"] == b"2"
 
     # LIST COMMANDS
     def test_cluster_blpop(self, r):
-        r.rpush('{foo}a', '1', '2')
-        r.rpush('{foo}b', '3', '4')
-        assert r.blpop(['{foo}b', '{foo}a'], timeout=1) == (b'{foo}b', b'3')
-        assert r.blpop(['{foo}b', '{foo}a'], timeout=1) == (b'{foo}b', b'4')
-        assert r.blpop(['{foo}b', '{foo}a'], timeout=1) == (b'{foo}a', b'1')
-        assert r.blpop(['{foo}b', '{foo}a'], timeout=1) == (b'{foo}a', b'2')
-        assert r.blpop(['{foo}b', '{foo}a'], timeout=1) is None
-        r.rpush('{foo}c', '1')
-        assert r.blpop('{foo}c', timeout=1) == (b'{foo}c', b'1')
+        r.rpush("{foo}a", "1", "2")
+        r.rpush("{foo}b", "3", "4")
+        assert r.blpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"3")
+        assert r.blpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"4")
+        assert r.blpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"1")
+        assert r.blpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"2")
+        assert r.blpop(["{foo}b", "{foo}a"], timeout=1) is None
+        r.rpush("{foo}c", "1")
+        assert r.blpop("{foo}c", timeout=1) == (b"{foo}c", b"1")
 
     def test_cluster_brpop(self, r):
-        r.rpush('{foo}a', '1', '2')
-        r.rpush('{foo}b', '3', '4')
-        assert r.brpop(['{foo}b', '{foo}a'], timeout=1) == (b'{foo}b', b'4')
-        assert r.brpop(['{foo}b', '{foo}a'], timeout=1) == (b'{foo}b', b'3')
-        assert r.brpop(['{foo}b', '{foo}a'], timeout=1) == (b'{foo}a', b'2')
-        assert r.brpop(['{foo}b', '{foo}a'], timeout=1) == (b'{foo}a', b'1')
-        assert r.brpop(['{foo}b', '{foo}a'], timeout=1) is None
-        r.rpush('{foo}c', '1')
-        assert r.brpop('{foo}c', timeout=1) == (b'{foo}c', b'1')
+        r.rpush("{foo}a", "1", "2")
+        r.rpush("{foo}b", "3", "4")
+        assert r.brpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"4")
+        assert r.brpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"3")
+        assert r.brpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"2")
+        assert r.brpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"1")
+        assert r.brpop(["{foo}b", "{foo}a"], timeout=1) is None
+        r.rpush("{foo}c", "1")
+        assert r.brpop("{foo}c", timeout=1) == (b"{foo}c", b"1")
 
     def test_cluster_brpoplpush(self, r):
-        r.rpush('{foo}a', '1', '2')
-        r.rpush('{foo}b', '3', '4')
-        assert r.brpoplpush('{foo}a', '{foo}b') == b'2'
-        assert r.brpoplpush('{foo}a', '{foo}b') == b'1'
-        assert r.brpoplpush('{foo}a', '{foo}b', timeout=1) is None
-        assert r.lrange('{foo}a', 0, -1) == []
-        assert r.lrange('{foo}b', 0, -1) == [b'1', b'2', b'3', b'4']
+        r.rpush("{foo}a", "1", "2")
+        r.rpush("{foo}b", "3", "4")
+        assert r.brpoplpush("{foo}a", "{foo}b") == b"2"
+        assert r.brpoplpush("{foo}a", "{foo}b") == b"1"
+        assert r.brpoplpush("{foo}a", "{foo}b", timeout=1) is None
+        assert r.lrange("{foo}a", 0, -1) == []
+        assert r.lrange("{foo}b", 0, -1) == [b"1", b"2", b"3", b"4"]
 
     def test_cluster_brpoplpush_empty_string(self, r):
-        r.rpush('{foo}a', '')
-        assert r.brpoplpush('{foo}a', '{foo}b') == b''
+        r.rpush("{foo}a", "")
+        assert r.brpoplpush("{foo}a", "{foo}b") == b""
 
     def test_cluster_rpoplpush(self, r):
-        r.rpush('{foo}a', 'a1', 'a2', 'a3')
-        r.rpush('{foo}b', 'b1', 'b2', 'b3')
-        assert r.rpoplpush('{foo}a', '{foo}b') == b'a3'
-        assert r.lrange('{foo}a', 0, -1) == [b'a1', b'a2']
-        assert r.lrange('{foo}b', 0, -1) == [b'a3', b'b1', b'b2', b'b3']
+        r.rpush("{foo}a", "a1", "a2", "a3")
+        r.rpush("{foo}b", "b1", "b2", "b3")
+        assert r.rpoplpush("{foo}a", "{foo}b") == b"a3"
+        assert r.lrange("{foo}a", 0, -1) == [b"a1", b"a2"]
+        assert r.lrange("{foo}b", 0, -1) == [b"a3", b"b1", b"b2", b"b3"]
 
     def test_cluster_sdiff(self, r):
-        r.sadd('{foo}a', '1', '2', '3')
-        assert r.sdiff('{foo}a', '{foo}b') == {b'1', b'2', b'3'}
-        r.sadd('{foo}b', '2', '3')
-        assert r.sdiff('{foo}a', '{foo}b') == {b'1'}
+        r.sadd("{foo}a", "1", "2", "3")
+        assert r.sdiff("{foo}a", "{foo}b") == {b"1", b"2", b"3"}
+        r.sadd("{foo}b", "2", "3")
+        assert r.sdiff("{foo}a", "{foo}b") == {b"1"}
 
     def test_cluster_sdiffstore(self, r):
-        r.sadd('{foo}a', '1', '2', '3')
-        assert r.sdiffstore('{foo}c', '{foo}a', '{foo}b') == 3
-        assert r.smembers('{foo}c') == {b'1', b'2', b'3'}
-        r.sadd('{foo}b', '2', '3')
-        assert r.sdiffstore('{foo}c', '{foo}a', '{foo}b') == 1
-        assert r.smembers('{foo}c') == {b'1'}
+        r.sadd("{foo}a", "1", "2", "3")
+        assert r.sdiffstore("{foo}c", "{foo}a", "{foo}b") == 3
+        assert r.smembers("{foo}c") == {b"1", b"2", b"3"}
+        r.sadd("{foo}b", "2", "3")
+        assert r.sdiffstore("{foo}c", "{foo}a", "{foo}b") == 1
+        assert r.smembers("{foo}c") == {b"1"}
 
     def test_cluster_sinter(self, r):
-        r.sadd('{foo}a', '1', '2', '3')
-        assert r.sinter('{foo}a', '{foo}b') == set()
-        r.sadd('{foo}b', '2', '3')
-        assert r.sinter('{foo}a', '{foo}b') == {b'2', b'3'}
+        r.sadd("{foo}a", "1", "2", "3")
+        assert r.sinter("{foo}a", "{foo}b") == set()
+        r.sadd("{foo}b", "2", "3")
+        assert r.sinter("{foo}a", "{foo}b") == {b"2", b"3"}
 
     def test_cluster_sinterstore(self, r):
-        r.sadd('{foo}a', '1', '2', '3')
-        assert r.sinterstore('{foo}c', '{foo}a', '{foo}b') == 0
-        assert r.smembers('{foo}c') == set()
-        r.sadd('{foo}b', '2', '3')
-        assert r.sinterstore('{foo}c', '{foo}a', '{foo}b') == 2
-        assert r.smembers('{foo}c') == {b'2', b'3'}
+        r.sadd("{foo}a", "1", "2", "3")
+        assert r.sinterstore("{foo}c", "{foo}a", "{foo}b") == 0
+        assert r.smembers("{foo}c") == set()
+        r.sadd("{foo}b", "2", "3")
+        assert r.sinterstore("{foo}c", "{foo}a", "{foo}b") == 2
+        assert r.smembers("{foo}c") == {b"2", b"3"}
 
     def test_cluster_smove(self, r):
-        r.sadd('{foo}a', 'a1', 'a2')
-        r.sadd('{foo}b', 'b1', 'b2')
-        assert r.smove('{foo}a', '{foo}b', 'a1')
-        assert r.smembers('{foo}a') == {b'a2'}
-        assert r.smembers('{foo}b') == {b'b1', b'b2', b'a1'}
+        r.sadd("{foo}a", "a1", "a2")
+        r.sadd("{foo}b", "b1", "b2")
+        assert r.smove("{foo}a", "{foo}b", "a1")
+        assert r.smembers("{foo}a") == {b"a2"}
+        assert r.smembers("{foo}b") == {b"b1", b"b2", b"a1"}
 
     def test_cluster_sunion(self, r):
-        r.sadd('{foo}a', '1', '2')
-        r.sadd('{foo}b', '2', '3')
-        assert r.sunion('{foo}a', '{foo}b') == {b'1', b'2', b'3'}
+        r.sadd("{foo}a", "1", "2")
+        r.sadd("{foo}b", "2", "3")
+        assert r.sunion("{foo}a", "{foo}b") == {b"1", b"2", b"3"}
 
     def test_cluster_sunionstore(self, r):
-        r.sadd('{foo}a', '1', '2')
-        r.sadd('{foo}b', '2', '3')
-        assert r.sunionstore('{foo}c', '{foo}a', '{foo}b') == 3
-        assert r.smembers('{foo}c') == {b'1', b'2', b'3'}
+        r.sadd("{foo}a", "1", "2")
+        r.sadd("{foo}b", "2", "3")
+        assert r.sunionstore("{foo}c", "{foo}a", "{foo}b") == 3
+        assert r.smembers("{foo}c") == {b"1", b"2", b"3"}
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_cluster_zdiff(self, r):
-        r.zadd('{foo}a', {'a1': 1, 'a2': 2, 'a3': 3})
-        r.zadd('{foo}b', {'a1': 1, 'a2': 2})
-        assert r.zdiff(['{foo}a', '{foo}b']) == [b'a3']
-        assert r.zdiff(['{foo}a', '{foo}b'], withscores=True) == [b'a3', b'3']
+        r.zadd("{foo}a", {"a1": 1, "a2": 2, "a3": 3})
+        r.zadd("{foo}b", {"a1": 1, "a2": 2})
+        assert r.zdiff(["{foo}a", "{foo}b"]) == [b"a3"]
+        assert r.zdiff(["{foo}a", "{foo}b"], withscores=True) == [b"a3", b"3"]
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_cluster_zdiffstore(self, r):
-        r.zadd('{foo}a', {'a1': 1, 'a2': 2, 'a3': 3})
-        r.zadd('{foo}b', {'a1': 1, 'a2': 2})
-        assert r.zdiffstore("{foo}out", ['{foo}a', '{foo}b'])
-        assert r.zrange("{foo}out", 0, -1) == [b'a3']
-        assert r.zrange("{foo}out", 0, -1, withscores=True) == [(b'a3', 3.0)]
+        r.zadd("{foo}a", {"a1": 1, "a2": 2, "a3": 3})
+        r.zadd("{foo}b", {"a1": 1, "a2": 2})
+        assert r.zdiffstore("{foo}out", ["{foo}a", "{foo}b"])
+        assert r.zrange("{foo}out", 0, -1) == [b"a3"]
+        assert r.zrange("{foo}out", 0, -1, withscores=True) == [(b"a3", 3.0)]
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_cluster_zinter(self, r):
-        r.zadd('{foo}a', {'a1': 1, 'a2': 2, 'a3': 1})
-        r.zadd('{foo}b', {'a1': 2, 'a2': 2, 'a3': 2})
-        r.zadd('{foo}c', {'a1': 6, 'a3': 5, 'a4': 4})
-        assert r.zinter(['{foo}a', '{foo}b', '{foo}c']) == [b'a3', b'a1']
+        r.zadd("{foo}a", {"a1": 1, "a2": 2, "a3": 1})
+        r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
+        r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
+        assert r.zinter(["{foo}a", "{foo}b", "{foo}c"]) == [b"a3", b"a1"]
         # invalid aggregation
         with pytest.raises(DataError):
-            r.zinter(['{foo}a', '{foo}b', '{foo}c'],
-                     aggregate='foo', withscores=True)
+            r.zinter(["{foo}a", "{foo}b", "{foo}c"], aggregate="foo", withscores=True)
         # aggregate with SUM
-        assert r.zinter(['{foo}a', '{foo}b', '{foo}c'], withscores=True) \
-               == [(b'a3', 8), (b'a1', 9)]
+        assert r.zinter(["{foo}a", "{foo}b", "{foo}c"], withscores=True) == [
+            (b"a3", 8),
+            (b"a1", 9),
+        ]
         # aggregate with MAX
-        assert r.zinter(['{foo}a', '{foo}b', '{foo}c'], aggregate='MAX',
-                        withscores=True) \
-               == [(b'a3', 5), (b'a1', 6)]
+        assert r.zinter(
+            ["{foo}a", "{foo}b", "{foo}c"], aggregate="MAX", withscores=True
+        ) == [(b"a3", 5), (b"a1", 6)]
         # aggregate with MIN
-        assert r.zinter(['{foo}a', '{foo}b', '{foo}c'], aggregate='MIN',
-                        withscores=True) \
-               == [(b'a1', 1), (b'a3', 1)]
+        assert r.zinter(
+            ["{foo}a", "{foo}b", "{foo}c"], aggregate="MIN", withscores=True
+        ) == [(b"a1", 1), (b"a3", 1)]
         # with weights
-        assert r.zinter({'{foo}a': 1, '{foo}b': 2, '{foo}c': 3},
-                        withscores=True) \
-               == [(b'a3', 20), (b'a1', 23)]
+        assert r.zinter({"{foo}a": 1, "{foo}b": 2, "{foo}c": 3}, withscores=True) == [
+            (b"a3", 20),
+            (b"a1", 23),
+        ]
 
     def test_cluster_zinterstore_sum(self, r):
-        r.zadd('{foo}a', {'a1': 1, 'a2': 1, 'a3': 1})
-        r.zadd('{foo}b', {'a1': 2, 'a2': 2, 'a3': 2})
-        r.zadd('{foo}c', {'a1': 6, 'a3': 5, 'a4': 4})
-        assert r.zinterstore('{foo}d', ['{foo}a', '{foo}b', '{foo}c']) == 2
-        assert r.zrange('{foo}d', 0, -1, withscores=True) == \
-               [(b'a3', 8), (b'a1', 9)]
+        r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
+        r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
+        r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
+        assert r.zinterstore("{foo}d", ["{foo}a", "{foo}b", "{foo}c"]) == 2
+        assert r.zrange("{foo}d", 0, -1, withscores=True) == [(b"a3", 8), (b"a1", 9)]
 
     def test_cluster_zinterstore_max(self, r):
-        r.zadd('{foo}a', {'a1': 1, 'a2': 1, 'a3': 1})
-        r.zadd('{foo}b', {'a1': 2, 'a2': 2, 'a3': 2})
-        r.zadd('{foo}c', {'a1': 6, 'a3': 5, 'a4': 4})
-        assert r.zinterstore(
-            '{foo}d', ['{foo}a', '{foo}b', '{foo}c'], aggregate='MAX') == 2
-        assert r.zrange('{foo}d', 0, -1, withscores=True) == \
-               [(b'a3', 5), (b'a1', 6)]
+        r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
+        r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
+        r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
+        assert (
+            r.zinterstore("{foo}d", ["{foo}a", "{foo}b", "{foo}c"], aggregate="MAX")
+            == 2
+        )
+        assert r.zrange("{foo}d", 0, -1, withscores=True) == [(b"a3", 5), (b"a1", 6)]
 
     def test_cluster_zinterstore_min(self, r):
-        r.zadd('{foo}a', {'a1': 1, 'a2': 2, 'a3': 3})
-        r.zadd('{foo}b', {'a1': 2, 'a2': 3, 'a3': 5})
-        r.zadd('{foo}c', {'a1': 6, 'a3': 5, 'a4': 4})
-        assert r.zinterstore(
-            '{foo}d', ['{foo}a', '{foo}b', '{foo}c'], aggregate='MIN') == 2
-        assert r.zrange('{foo}d', 0, -1, withscores=True) == \
-               [(b'a1', 1), (b'a3', 3)]
+        r.zadd("{foo}a", {"a1": 1, "a2": 2, "a3": 3})
+        r.zadd("{foo}b", {"a1": 2, "a2": 3, "a3": 5})
+        r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
+        assert (
+            r.zinterstore("{foo}d", ["{foo}a", "{foo}b", "{foo}c"], aggregate="MIN")
+            == 2
+        )
+        assert r.zrange("{foo}d", 0, -1, withscores=True) == [(b"a1", 1), (b"a3", 3)]
 
     def test_cluster_zinterstore_with_weight(self, r):
-        r.zadd('{foo}a', {'a1': 1, 'a2': 1, 'a3': 1})
-        r.zadd('{foo}b', {'a1': 2, 'a2': 2, 'a3': 2})
-        r.zadd('{foo}c', {'a1': 6, 'a3': 5, 'a4': 4})
-        assert r.zinterstore(
-            '{foo}d', {'{foo}a': 1, '{foo}b': 2, '{foo}c': 3}) == 2
-        assert r.zrange('{foo}d', 0, -1, withscores=True) == \
-               [(b'a3', 20), (b'a1', 23)]
-
-    @skip_if_server_version_lt('4.9.0')
+        r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
+        r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
+        r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
+        assert r.zinterstore("{foo}d", {"{foo}a": 1, "{foo}b": 2, "{foo}c": 3}) == 2
+        assert r.zrange("{foo}d", 0, -1, withscores=True) == [(b"a3", 20), (b"a1", 23)]
+
+    @skip_if_server_version_lt("4.9.0")
     def test_cluster_bzpopmax(self, r):
-        r.zadd('{foo}a', {'a1': 1, 'a2': 2})
-        r.zadd('{foo}b', {'b1': 10, 'b2': 20})
-        assert r.bzpopmax(['{foo}b', '{foo}a'], timeout=1) == (
-            b'{foo}b', b'b2', 20)
-        assert r.bzpopmax(['{foo}b', '{foo}a'], timeout=1) == (
-            b'{foo}b', b'b1', 10)
-        assert r.bzpopmax(['{foo}b', '{foo}a'], timeout=1) == (
-            b'{foo}a', b'a2', 2)
-        assert r.bzpopmax(['{foo}b', '{foo}a'], timeout=1) == (
-            b'{foo}a', b'a1', 1)
-        assert r.bzpopmax(['{foo}b', '{foo}a'], timeout=1) is None
-        r.zadd('{foo}c', {'c1': 100})
-        assert r.bzpopmax('{foo}c', timeout=1) == (b'{foo}c', b'c1', 100)
-
-    @skip_if_server_version_lt('4.9.0')
+        r.zadd("{foo}a", {"a1": 1, "a2": 2})
+        r.zadd("{foo}b", {"b1": 10, "b2": 20})
+        assert r.bzpopmax(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"b2", 20)
+        assert r.bzpopmax(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"b1", 10)
+        assert r.bzpopmax(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"a2", 2)
+        assert r.bzpopmax(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"a1", 1)
+        assert r.bzpopmax(["{foo}b", "{foo}a"], timeout=1) is None
+        r.zadd("{foo}c", {"c1": 100})
+        assert r.bzpopmax("{foo}c", timeout=1) == (b"{foo}c", b"c1", 100)
+
+    @skip_if_server_version_lt("4.9.0")
     def test_cluster_bzpopmin(self, r):
-        r.zadd('{foo}a', {'a1': 1, 'a2': 2})
-        r.zadd('{foo}b', {'b1': 10, 'b2': 20})
-        assert r.bzpopmin(['{foo}b', '{foo}a'], timeout=1) == (
-            b'{foo}b', b'b1', 10)
-        assert r.bzpopmin(['{foo}b', '{foo}a'], timeout=1) == (
-            b'{foo}b', b'b2', 20)
-        assert r.bzpopmin(['{foo}b', '{foo}a'], timeout=1) == (
-            b'{foo}a', b'a1', 1)
-        assert r.bzpopmin(['{foo}b', '{foo}a'], timeout=1) == (
-            b'{foo}a', b'a2', 2)
-        assert r.bzpopmin(['{foo}b', '{foo}a'], timeout=1) is None
-        r.zadd('{foo}c', {'c1': 100})
-        assert r.bzpopmin('{foo}c', timeout=1) == (b'{foo}c', b'c1', 100)
-
-    @skip_if_server_version_lt('6.2.0')
+        r.zadd("{foo}a", {"a1": 1, "a2": 2})
+        r.zadd("{foo}b", {"b1": 10, "b2": 20})
+        assert r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"b1", 10)
+        assert r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"b2", 20)
+        assert r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"a1", 1)
+        assert r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"a2", 2)
+        assert r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) is None
+        r.zadd("{foo}c", {"c1": 100})
+        assert r.bzpopmin("{foo}c", timeout=1) == (b"{foo}c", b"c1", 100)
+
+    @skip_if_server_version_lt("6.2.0")
     def test_cluster_zrangestore(self, r):
-        r.zadd('{foo}a', {'a1': 1, 'a2': 2, 'a3': 3})
-        assert r.zrangestore('{foo}b', '{foo}a', 0, 1)
-        assert r.zrange('{foo}b', 0, -1) == [b'a1', b'a2']
-        assert r.zrangestore('{foo}b', '{foo}a', 1, 2)
-        assert r.zrange('{foo}b', 0, -1) == [b'a2', b'a3']
-        assert r.zrange('{foo}b', 0, -1, withscores=True) == \
-               [(b'a2', 2), (b'a3', 3)]
+        r.zadd("{foo}a", {"a1": 1, "a2": 2, "a3": 3})
+        assert r.zrangestore("{foo}b", "{foo}a", 0, 1)
+        assert r.zrange("{foo}b", 0, -1) == [b"a1", b"a2"]
+        assert r.zrangestore("{foo}b", "{foo}a", 1, 2)
+        assert r.zrange("{foo}b", 0, -1) == [b"a2", b"a3"]
+        assert r.zrange("{foo}b", 0, -1, withscores=True) == [(b"a2", 2), (b"a3", 3)]
         # reversed order
-        assert r.zrangestore('{foo}b', '{foo}a', 1, 2, desc=True)
-        assert r.zrange('{foo}b', 0, -1) == [b'a1', b'a2']
+        assert r.zrangestore("{foo}b", "{foo}a", 1, 2, desc=True)
+        assert r.zrange("{foo}b", 0, -1) == [b"a1", b"a2"]
         # by score
-        assert r.zrangestore('{foo}b', '{foo}a', 2, 1, byscore=True,
-                             offset=0, num=1, desc=True)
-        assert r.zrange('{foo}b', 0, -1) == [b'a2']
+        assert r.zrangestore(
+            "{foo}b", "{foo}a", 2, 1, byscore=True, offset=0, num=1, desc=True
+        )
+        assert r.zrange("{foo}b", 0, -1) == [b"a2"]
         # by lex
-        assert r.zrangestore('{foo}b', '{foo}a', '[a2', '(a3', bylex=True,
-                             offset=0, num=1)
-        assert r.zrange('{foo}b', 0, -1) == [b'a2']
+        assert r.zrangestore(
+            "{foo}b", "{foo}a", "[a2", "(a3", bylex=True, offset=0, num=1
+        )
+        assert r.zrange("{foo}b", 0, -1) == [b"a2"]
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_cluster_zunion(self, r):
-        r.zadd('{foo}a', {'a1': 1, 'a2': 1, 'a3': 1})
-        r.zadd('{foo}b', {'a1': 2, 'a2': 2, 'a3': 2})
-        r.zadd('{foo}c', {'a1': 6, 'a3': 5, 'a4': 4})
+        r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
+        r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
+        r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
         # sum
-        assert r.zunion(['{foo}a', '{foo}b', '{foo}c']) == \
-               [b'a2', b'a4', b'a3', b'a1']
-        assert r.zunion(['{foo}a', '{foo}b', '{foo}c'], withscores=True) == \
-               [(b'a2', 3), (b'a4', 4), (b'a3', 8), (b'a1', 9)]
+        assert r.zunion(["{foo}a", "{foo}b", "{foo}c"]) == [b"a2", b"a4", b"a3", b"a1"]
+        assert r.zunion(["{foo}a", "{foo}b", "{foo}c"], withscores=True) == [
+            (b"a2", 3),
+            (b"a4", 4),
+            (b"a3", 8),
+            (b"a1", 9),
+        ]
         # max
-        assert r.zunion(['{foo}a', '{foo}b', '{foo}c'], aggregate='MAX',
-                        withscores=True) \
-               == [(b'a2', 2), (b'a4', 4), (b'a3', 5), (b'a1', 6)]
+        assert r.zunion(
+            ["{foo}a", "{foo}b", "{foo}c"], aggregate="MAX", withscores=True
+        ) == [(b"a2", 2), (b"a4", 4), (b"a3", 5), (b"a1", 6)]
         # min
-        assert r.zunion(['{foo}a', '{foo}b', '{foo}c'], aggregate='MIN',
-                        withscores=True) \
-               == [(b'a1', 1), (b'a2', 1), (b'a3', 1), (b'a4', 4)]
+        assert r.zunion(
+            ["{foo}a", "{foo}b", "{foo}c"], aggregate="MIN", withscores=True
+        ) == [(b"a1", 1), (b"a2", 1), (b"a3", 1), (b"a4", 4)]
         # with weight
-        assert r.zunion({'{foo}a': 1, '{foo}b': 2, '{foo}c': 3},
-                        withscores=True) \
-               == [(b'a2', 5), (b'a4', 12), (b'a3', 20), (b'a1', 23)]
+        assert r.zunion({"{foo}a": 1, "{foo}b": 2, "{foo}c": 3}, withscores=True) == [
+            (b"a2", 5),
+            (b"a4", 12),
+            (b"a3", 20),
+            (b"a1", 23),
+        ]
 
     def test_cluster_zunionstore_sum(self, r):
-        r.zadd('{foo}a', {'a1': 1, 'a2': 1, 'a3': 1})
-        r.zadd('{foo}b', {'a1': 2, 'a2': 2, 'a3': 2})
-        r.zadd('{foo}c', {'a1': 6, 'a3': 5, 'a4': 4})
-        assert r.zunionstore('{foo}d', ['{foo}a', '{foo}b', '{foo}c']) == 4
-        assert r.zrange('{foo}d', 0, -1, withscores=True) == \
-               [(b'a2', 3), (b'a4', 4), (b'a3', 8), (b'a1', 9)]
+        r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
+        r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
+        r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
+        assert r.zunionstore("{foo}d", ["{foo}a", "{foo}b", "{foo}c"]) == 4
+        assert r.zrange("{foo}d", 0, -1, withscores=True) == [
+            (b"a2", 3),
+            (b"a4", 4),
+            (b"a3", 8),
+            (b"a1", 9),
+        ]
 
     def test_cluster_zunionstore_max(self, r):
-        r.zadd('{foo}a', {'a1': 1, 'a2': 1, 'a3': 1})
-        r.zadd('{foo}b', {'a1': 2, 'a2': 2, 'a3': 2})
-        r.zadd('{foo}c', {'a1': 6, 'a3': 5, 'a4': 4})
-        assert r.zunionstore(
-            '{foo}d', ['{foo}a', '{foo}b', '{foo}c'], aggregate='MAX') == 4
-        assert r.zrange('{foo}d', 0, -1, withscores=True) == \
-               [(b'a2', 2), (b'a4', 4), (b'a3', 5), (b'a1', 6)]
+        r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
+        r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
+        r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
+        assert (
+            r.zunionstore("{foo}d", ["{foo}a", "{foo}b", "{foo}c"], aggregate="MAX")
+            == 4
+        )
+        assert r.zrange("{foo}d", 0, -1, withscores=True) == [
+            (b"a2", 2),
+            (b"a4", 4),
+            (b"a3", 5),
+            (b"a1", 6),
+        ]
 
     def test_cluster_zunionstore_min(self, r):
-        r.zadd('{foo}a', {'a1': 1, 'a2': 2, 'a3': 3})
-        r.zadd('{foo}b', {'a1': 2, 'a2': 2, 'a3': 4})
-        r.zadd('{foo}c', {'a1': 6, 'a3': 5, 'a4': 4})
-        assert r.zunionstore(
-            '{foo}d', ['{foo}a', '{foo}b', '{foo}c'], aggregate='MIN') == 4
-        assert r.zrange('{foo}d', 0, -1, withscores=True) == \
-               [(b'a1', 1), (b'a2', 2), (b'a3', 3), (b'a4', 4)]
+        r.zadd("{foo}a", {"a1": 1, "a2": 2, "a3": 3})
+        r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 4})
+        r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
+        assert (
+            r.zunionstore("{foo}d", ["{foo}a", "{foo}b", "{foo}c"], aggregate="MIN")
+            == 4
+        )
+        assert r.zrange("{foo}d", 0, -1, withscores=True) == [
+            (b"a1", 1),
+            (b"a2", 2),
+            (b"a3", 3),
+            (b"a4", 4),
+        ]
 
     def test_cluster_zunionstore_with_weight(self, r):
-        r.zadd('{foo}a', {'a1': 1, 'a2': 1, 'a3': 1})
-        r.zadd('{foo}b', {'a1': 2, 'a2': 2, 'a3': 2})
-        r.zadd('{foo}c', {'a1': 6, 'a3': 5, 'a4': 4})
-        assert r.zunionstore(
-            '{foo}d', {'{foo}a': 1, '{foo}b': 2, '{foo}c': 3}) == 4
-        assert r.zrange('{foo}d', 0, -1, withscores=True) == \
-               [(b'a2', 5), (b'a4', 12), (b'a3', 20), (b'a1', 23)]
-
-    @skip_if_server_version_lt('2.8.9')
+        r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
+        r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
+        r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
+        assert r.zunionstore("{foo}d", {"{foo}a": 1, "{foo}b": 2, "{foo}c": 3}) == 4
+        assert r.zrange("{foo}d", 0, -1, withscores=True) == [
+            (b"a2", 5),
+            (b"a4", 12),
+            (b"a3", 20),
+            (b"a1", 23),
+        ]
+
+    @skip_if_server_version_lt("2.8.9")
     def test_cluster_pfcount(self, r):
-        members = {b'1', b'2', b'3'}
-        r.pfadd('{foo}a', *members)
-        assert r.pfcount('{foo}a') == len(members)
-        members_b = {b'2', b'3', b'4'}
-        r.pfadd('{foo}b', *members_b)
-        assert r.pfcount('{foo}b') == len(members_b)
-        assert r.pfcount('{foo}a', '{foo}b') == len(members_b.union(members))
-
-    @skip_if_server_version_lt('2.8.9')
+        members = {b"1", b"2", b"3"}
+        r.pfadd("{foo}a", *members)
+        assert r.pfcount("{foo}a") == len(members)
+        members_b = {b"2", b"3", b"4"}
+        r.pfadd("{foo}b", *members_b)
+        assert r.pfcount("{foo}b") == len(members_b)
+        assert r.pfcount("{foo}a", "{foo}b") == len(members_b.union(members))
+
+    @skip_if_server_version_lt("2.8.9")
     def test_cluster_pfmerge(self, r):
-        mema = {b'1', b'2', b'3'}
-        memb = {b'2', b'3', b'4'}
-        memc = {b'5', b'6', b'7'}
-        r.pfadd('{foo}a', *mema)
-        r.pfadd('{foo}b', *memb)
-        r.pfadd('{foo}c', *memc)
-        r.pfmerge('{foo}d', '{foo}c', '{foo}a')
-        assert r.pfcount('{foo}d') == 6
-        r.pfmerge('{foo}d', '{foo}b')
-        assert r.pfcount('{foo}d') == 7
+        mema = {b"1", b"2", b"3"}
+        memb = {b"2", b"3", b"4"}
+        memc = {b"5", b"6", b"7"}
+        r.pfadd("{foo}a", *mema)
+        r.pfadd("{foo}b", *memb)
+        r.pfadd("{foo}c", *memc)
+        r.pfmerge("{foo}d", "{foo}c", "{foo}a")
+        assert r.pfcount("{foo}d") == 6
+        r.pfmerge("{foo}d", "{foo}b")
+        assert r.pfcount("{foo}d") == 7
 
     def test_cluster_sort_store(self, r):
-        r.rpush('{foo}a', '2', '3', '1')
-        assert r.sort('{foo}a', store='{foo}sorted_values') == 3
-        assert r.lrange('{foo}sorted_values', 0, -1) == [b'1', b'2', b'3']
+        r.rpush("{foo}a", "2", "3", "1")
+        assert r.sort("{foo}a", store="{foo}sorted_values") == 3
+        assert r.lrange("{foo}sorted_values", 0, -1) == [b"1", b"2", b"3"]
 
     # GEO COMMANDS
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_cluster_geosearchstore(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
 
-        r.geoadd('{foo}barcelona', values)
-        r.geosearchstore('{foo}places_barcelona', '{foo}barcelona',
-                         longitude=2.191, latitude=41.433, radius=1000)
-        assert r.zrange('{foo}places_barcelona', 0, -1) == [b'place1']
+        r.geoadd("{foo}barcelona", values)
+        r.geosearchstore(
+            "{foo}places_barcelona",
+            "{foo}barcelona",
+            longitude=2.191,
+            latitude=41.433,
+            radius=1000,
+        )
+        assert r.zrange("{foo}places_barcelona", 0, -1) == [b"place1"]
 
     @skip_unless_arch_bits(64)
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_geosearchstore_dist(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
 
-        r.geoadd('{foo}barcelona', values)
-        r.geosearchstore('{foo}places_barcelona', '{foo}barcelona',
-                         longitude=2.191, latitude=41.433,
-                         radius=1000, storedist=True)
+        r.geoadd("{foo}barcelona", values)
+        r.geosearchstore(
+            "{foo}places_barcelona",
+            "{foo}barcelona",
+            longitude=2.191,
+            latitude=41.433,
+            radius=1000,
+            storedist=True,
+        )
         # instead of save the geo score, the distance is saved.
-        assert r.zscore('{foo}places_barcelona', 'place1') == 88.05060698409301
+        assert r.zscore("{foo}places_barcelona", "place1") == 88.05060698409301
 
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt("3.2.0")
     def test_cluster_georadius_store(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
 
-        r.geoadd('{foo}barcelona', values)
-        r.georadius('{foo}barcelona', 2.191, 41.433,
-                    1000, store='{foo}places_barcelona')
-        assert r.zrange('{foo}places_barcelona', 0, -1) == [b'place1']
+        r.geoadd("{foo}barcelona", values)
+        r.georadius(
+            "{foo}barcelona", 2.191, 41.433, 1000, store="{foo}places_barcelona"
+        )
+        assert r.zrange("{foo}places_barcelona", 0, -1) == [b"place1"]
 
     @skip_unless_arch_bits(64)
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt("3.2.0")
     def test_cluster_georadius_store_dist(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
 
-        r.geoadd('{foo}barcelona', values)
-        r.georadius('{foo}barcelona', 2.191, 41.433, 1000,
-                    store_dist='{foo}places_barcelona')
+        r.geoadd("{foo}barcelona", values)
+        r.georadius(
+            "{foo}barcelona", 2.191, 41.433, 1000, store_dist="{foo}places_barcelona"
+        )
         # instead of save the geo score, the distance is saved.
-        assert r.zscore('{foo}places_barcelona', 'place1') == 88.05060698409301
+        assert r.zscore("{foo}places_barcelona", "place1") == 88.05060698409301
 
     def test_cluster_dbsize(self, r):
-        d = {'a': b'1', 'b': b'2', 'c': b'3', 'd': b'4'}
+        d = {"a": b"1", "b": b"2", "c": b"3", "d": b"4"}
         assert r.mset_nonatomic(d)
-        assert r.dbsize(target_nodes='primaries') == len(d)
+        assert r.dbsize(target_nodes="primaries") == len(d)
 
     def test_cluster_keys(self, r):
         assert r.keys() == []
-        keys_with_underscores = {b'test_a', b'test_b'}
-        keys = keys_with_underscores.union({b'testc'})
+        keys_with_underscores = {b"test_a", b"test_b"}
+        keys = keys_with_underscores.union({b"testc"})
         for key in keys:
             r[key] = 1
-        assert set(r.keys(pattern='test_*', target_nodes='primaries')) == \
-               keys_with_underscores
-        assert set(r.keys(pattern='test*', target_nodes='primaries')) == keys
+        assert (
+            set(r.keys(pattern="test_*", target_nodes="primaries"))
+            == keys_with_underscores
+        )
+        assert set(r.keys(pattern="test*", target_nodes="primaries")) == keys
 
     # SCAN COMMANDS
-    @skip_if_server_version_lt('2.8.0')
+    @skip_if_server_version_lt("2.8.0")
     def test_cluster_scan(self, r):
-        r.set('a', 1)
-        r.set('b', 2)
-        r.set('c', 3)
-        cursor, keys = r.scan(target_nodes='primaries')
+        r.set("a", 1)
+        r.set("b", 2)
+        r.set("c", 3)
+        cursor, keys = r.scan(target_nodes="primaries")
         assert cursor == 0
-        assert set(keys) == {b'a', b'b', b'c'}
-        _, keys = r.scan(match='a', target_nodes='primaries')
-        assert set(keys) == {b'a'}
+        assert set(keys) == {b"a", b"b", b"c"}
+        _, keys = r.scan(match="a", target_nodes="primaries")
+        assert set(keys) == {b"a"}
 
     @skip_if_server_version_lt("6.0.0")
     def test_cluster_scan_type(self, r):
-        r.sadd('a-set', 1)
-        r.hset('a-hash', 'foo', 2)
-        r.lpush('a-list', 'aux', 3)
-        _, keys = r.scan(match='a*', _type='SET', target_nodes='primaries')
-        assert set(keys) == {b'a-set'}
+        r.sadd("a-set", 1)
+        r.hset("a-hash", "foo", 2)
+        r.lpush("a-list", "aux", 3)
+        _, keys = r.scan(match="a*", _type="SET", target_nodes="primaries")
+        assert set(keys) == {b"a-set"}
 
-    @skip_if_server_version_lt('2.8.0')
+    @skip_if_server_version_lt("2.8.0")
     def test_cluster_scan_iter(self, r):
-        r.set('a', 1)
-        r.set('b', 2)
-        r.set('c', 3)
-        keys = list(r.scan_iter(target_nodes='primaries'))
-        assert set(keys) == {b'a', b'b', b'c'}
-        keys = list(r.scan_iter(match='a', target_nodes='primaries'))
-        assert set(keys) == {b'a'}
+        r.set("a", 1)
+        r.set("b", 2)
+        r.set("c", 3)
+        keys = list(r.scan_iter(target_nodes="primaries"))
+        assert set(keys) == {b"a", b"b", b"c"}
+        keys = list(r.scan_iter(match="a", target_nodes="primaries"))
+        assert set(keys) == {b"a"}
 
     def test_cluster_randomkey(self, r):
-        node = r.get_node_from_key('{foo}')
+        node = r.get_node_from_key("{foo}")
         assert r.randomkey(target_nodes=node) is None
-        for key in ('{foo}a', '{foo}b', '{foo}c'):
+        for key in ("{foo}a", "{foo}b", "{foo}c"):
             r[key] = 1
-        assert r.randomkey(target_nodes=node) in \
-               (b'{foo}a', b'{foo}b', b'{foo}c')
+        assert r.randomkey(target_nodes=node) in (b"{foo}a", b"{foo}b", b"{foo}c")
 
 
 @pytest.mark.onlycluster
@@ -1704,7 +1783,7 @@ def test_load_balancer(self, r):
         node_5 = ClusterNode(default_host, 6375, REPLICA)
         n_manager.slots_cache = {
             slot_1: [node_1, node_2, node_3],
-            slot_2: [node_4, node_5]
+            slot_2: [node_4, node_5],
         }
         primary1_name = n_manager.slots_cache[slot_1][0].name
         primary2_name = n_manager.slots_cache[slot_2][0].name
@@ -1730,17 +1809,17 @@ def test_init_slots_cache_not_all_slots_covered(self):
         """
         # Missing slot 5460
         cluster_slots = [
-            [0, 5459, ['127.0.0.1', 7000], ['127.0.0.1', 7003]],
-            [5461, 10922, ['127.0.0.1', 7001],
-             ['127.0.0.1', 7004]],
-            [10923, 16383, ['127.0.0.1', 7002],
-             ['127.0.0.1', 7005]],
+            [0, 5459, ["127.0.0.1", 7000], ["127.0.0.1", 7003]],
+            [5461, 10922, ["127.0.0.1", 7001], ["127.0.0.1", 7004]],
+            [10923, 16383, ["127.0.0.1", 7002], ["127.0.0.1", 7005]],
         ]
         with pytest.raises(RedisClusterException) as ex:
-            get_mocked_redis_client(host=default_host, port=default_port,
-                                    cluster_slots=cluster_slots)
+            get_mocked_redis_client(
+                host=default_host, port=default_port, cluster_slots=cluster_slots
+            )
         assert str(ex.value).startswith(
-            "All slots are not covered after query all startup_nodes.")
+            "All slots are not covered after query all startup_nodes."
+        )
 
     def test_init_slots_cache_not_require_full_coverage_error(self):
         """
@@ -1750,18 +1829,19 @@ def test_init_slots_cache_not_require_full_coverage_error(self):
         """
         # Missing slot 5460
         cluster_slots = [
-            [0, 5459, ['127.0.0.1', 7000], ['127.0.0.1', 7003]],
-            [5461, 10922, ['127.0.0.1', 7001],
-             ['127.0.0.1', 7004]],
-            [10923, 16383, ['127.0.0.1', 7002],
-             ['127.0.0.1', 7005]],
+            [0, 5459, ["127.0.0.1", 7000], ["127.0.0.1", 7003]],
+            [5461, 10922, ["127.0.0.1", 7001], ["127.0.0.1", 7004]],
+            [10923, 16383, ["127.0.0.1", 7002], ["127.0.0.1", 7005]],
         ]
 
         with pytest.raises(RedisClusterException):
-            get_mocked_redis_client(host=default_host, port=default_port,
-                                    cluster_slots=cluster_slots,
-                                    require_full_coverage=False,
-                                    coverage_result='yes')
+            get_mocked_redis_client(
+                host=default_host,
+                port=default_port,
+                cluster_slots=cluster_slots,
+                require_full_coverage=False,
+                coverage_result="yes",
+            )
 
     def test_init_slots_cache_not_require_full_coverage_success(self):
         """
@@ -1771,17 +1851,18 @@ def test_init_slots_cache_not_require_full_coverage_success(self):
         """
         # Missing slot 5460
         cluster_slots = [
-            [0, 5459, ['127.0.0.1', 7000], ['127.0.0.1', 7003]],
-            [5461, 10922, ['127.0.0.1', 7001],
-             ['127.0.0.1', 7004]],
-            [10923, 16383, ['127.0.0.1', 7002],
-             ['127.0.0.1', 7005]],
+            [0, 5459, ["127.0.0.1", 7000], ["127.0.0.1", 7003]],
+            [5461, 10922, ["127.0.0.1", 7001], ["127.0.0.1", 7004]],
+            [10923, 16383, ["127.0.0.1", 7002], ["127.0.0.1", 7005]],
         ]
 
-        rc = get_mocked_redis_client(host=default_host, port=default_port,
-                                     cluster_slots=cluster_slots,
-                                     require_full_coverage=False,
-                                     coverage_result='no')
+        rc = get_mocked_redis_client(
+            host=default_host,
+            port=default_port,
+            cluster_slots=cluster_slots,
+            require_full_coverage=False,
+            coverage_result="no",
+        )
 
         assert 5460 not in rc.nodes_manager.slots_cache
 
@@ -1793,20 +1874,22 @@ def test_init_slots_cache_not_require_full_coverage_skips_check(self):
         """
         # Missing slot 5460
         cluster_slots = [
-            [0, 5459, ['127.0.0.1', 7000], ['127.0.0.1', 7003]],
-            [5461, 10922, ['127.0.0.1', 7001],
-             ['127.0.0.1', 7004]],
-            [10923, 16383, ['127.0.0.1', 7002],
-             ['127.0.0.1', 7005]],
+            [0, 5459, ["127.0.0.1", 7000], ["127.0.0.1", 7003]],
+            [5461, 10922, ["127.0.0.1", 7001], ["127.0.0.1", 7004]],
+            [10923, 16383, ["127.0.0.1", 7002], ["127.0.0.1", 7005]],
         ]
 
-        with patch.object(NodesManager,
-                          'cluster_require_full_coverage') as conf_check_mock:
-            rc = get_mocked_redis_client(host=default_host, port=default_port,
-                                         cluster_slots=cluster_slots,
-                                         require_full_coverage=False,
-                                         skip_full_coverage_check=True,
-                                         coverage_result='no')
+        with patch.object(
+            NodesManager, "cluster_require_full_coverage"
+        ) as conf_check_mock:
+            rc = get_mocked_redis_client(
+                host=default_host,
+                port=default_port,
+                cluster_slots=cluster_slots,
+                require_full_coverage=False,
+                skip_full_coverage_check=True,
+                coverage_result="no",
+            )
 
             assert conf_check_mock.called is False
             assert 5460 not in rc.nodes_manager.slots_cache
@@ -1816,17 +1899,18 @@ def test_init_slots_cache(self):
         Test that slots cache can in initialized and all slots are covered
         """
         good_slots_resp = [
-            [0, 5460, ['127.0.0.1', 7000], ['127.0.0.2', 7003]],
-            [5461, 10922, ['127.0.0.1', 7001], ['127.0.0.2', 7004]],
-            [10923, 16383, ['127.0.0.1', 7002], ['127.0.0.2', 7005]],
+            [0, 5460, ["127.0.0.1", 7000], ["127.0.0.2", 7003]],
+            [5461, 10922, ["127.0.0.1", 7001], ["127.0.0.2", 7004]],
+            [10923, 16383, ["127.0.0.1", 7002], ["127.0.0.2", 7005]],
         ]
 
-        rc = get_mocked_redis_client(host=default_host, port=default_port,
-                                     cluster_slots=good_slots_resp)
+        rc = get_mocked_redis_client(
+            host=default_host, port=default_port, cluster_slots=good_slots_resp
+        )
         n_manager = rc.nodes_manager
         assert len(n_manager.slots_cache) == REDIS_CLUSTER_HASH_SLOTS
         for slot_info in good_slots_resp:
-            all_hosts = ['127.0.0.1', '127.0.0.2']
+            all_hosts = ["127.0.0.1", "127.0.0.2"]
             all_ports = [7000, 7001, 7002, 7003, 7004, 7005]
             slot_start = slot_info[0]
             slot_end = slot_info[1]
@@ -1861,8 +1945,8 @@ def test_init_slots_cache_slots_collision(self, request):
         raise an error. In this test both nodes will say that the first
         slots block should be bound to different servers.
         """
-        with patch.object(NodesManager,
-                          'create_redis_node') as create_redis_node:
+        with patch.object(NodesManager, "create_redis_node") as create_redis_node:
+
             def create_mocked_redis_node(host, port, **kwargs):
                 """
                 Helper function to return custom slots cache data from
@@ -1873,14 +1957,14 @@ def create_mocked_redis_node(host, port, **kwargs):
                         [
                             0,
                             5460,
-                            ['127.0.0.1', 7000],
-                            ['127.0.0.1', 7003],
+                            ["127.0.0.1", 7000],
+                            ["127.0.0.1", 7003],
                         ],
                         [
                             5461,
                             10922,
-                            ['127.0.0.1', 7001],
-                            ['127.0.0.1', 7004],
+                            ["127.0.0.1", 7001],
+                            ["127.0.0.1", 7004],
                         ],
                     ]
 
@@ -1889,31 +1973,28 @@ def create_mocked_redis_node(host, port, **kwargs):
                         [
                             0,
                             5460,
-                            ['127.0.0.1', 7001],
-                            ['127.0.0.1', 7003],
+                            ["127.0.0.1", 7001],
+                            ["127.0.0.1", 7003],
                         ],
                         [
                             5461,
                             10922,
-                            ['127.0.0.1', 7000],
-                            ['127.0.0.1', 7004],
+                            ["127.0.0.1", 7000],
+                            ["127.0.0.1", 7004],
                         ],
                     ]
                 else:
                     result = []
 
-                r_node = Redis(
-                    host=host,
-                    port=port
-                )
+                r_node = Redis(host=host, port=port)
 
                 orig_execute_command = r_node.execute_command
 
                 def execute_command(*args, **kwargs):
-                    if args[0] == 'CLUSTER SLOTS':
+                    if args[0] == "CLUSTER SLOTS":
                         return result
-                    elif args[1] == 'cluster-require-full-coverage':
-                        return {'cluster-require-full-coverage': 'yes'}
+                    elif args[1] == "cluster-require-full-coverage":
+                        return {"cluster-require-full-coverage": "yes"}
                     else:
                         return orig_execute_command(*args, **kwargs)
 
@@ -1923,12 +2004,12 @@ def execute_command(*args, **kwargs):
             create_redis_node.side_effect = create_mocked_redis_node
 
             with pytest.raises(RedisClusterException) as ex:
-                node_1 = ClusterNode('127.0.0.1', 7000)
-                node_2 = ClusterNode('127.0.0.1', 7001)
+                node_1 = ClusterNode("127.0.0.1", 7000)
+                node_2 = ClusterNode("127.0.0.1", 7001)
                 RedisCluster(startup_nodes=[node_1, node_2])
             assert str(ex.value).startswith(
-                "startup_nodes could not agree on a valid slots cache"), str(
-                ex.value)
+                "startup_nodes could not agree on a valid slots cache"
+            ), str(ex.value)
 
     def test_cluster_one_instance(self):
         """
@@ -1936,9 +2017,8 @@ def test_cluster_one_instance(self):
         be validated they work.
         """
         node = ClusterNode(default_host, default_port)
-        cluster_slots = [[0, 16383, ['', default_port]]]
-        rc = get_mocked_redis_client(startup_nodes=[node],
-                                     cluster_slots=cluster_slots)
+        cluster_slots = [[0, 16383, ["", default_port]]]
+        rc = get_mocked_redis_client(startup_nodes=[node], cluster_slots=cluster_slots)
 
         n = rc.nodes_manager
         assert len(n.nodes_cache) == 1
@@ -1955,28 +2035,30 @@ def test_init_with_down_node(self):
         If I can't connect to one of the nodes, everything should still work.
         But if I can't connect to any of the nodes, exception should be thrown.
         """
-        with patch.object(NodesManager,
-                          'create_redis_node') as create_redis_node:
+        with patch.object(NodesManager, "create_redis_node") as create_redis_node:
+
             def create_mocked_redis_node(host, port, **kwargs):
                 if port == 7000:
-                    raise ConnectionError('mock connection error for 7000')
+                    raise ConnectionError("mock connection error for 7000")
 
                 r_node = Redis(host=host, port=port, decode_responses=True)
 
                 def execute_command(*args, **kwargs):
-                    if args[0] == 'CLUSTER SLOTS':
+                    if args[0] == "CLUSTER SLOTS":
                         return [
                             [
-                                0, 8191,
-                                ['127.0.0.1', 7001, 'node_1'],
+                                0,
+                                8191,
+                                ["127.0.0.1", 7001, "node_1"],
                             ],
                             [
-                                8192, 16383,
-                                ['127.0.0.1', 7002, 'node_2'],
-                            ]
+                                8192,
+                                16383,
+                                ["127.0.0.1", 7002, "node_2"],
+                            ],
                         ]
-                    elif args[1] == 'cluster-require-full-coverage':
-                        return {'cluster-require-full-coverage': 'yes'}
+                    elif args[1] == "cluster-require-full-coverage":
+                        return {"cluster-require-full-coverage": "yes"}
 
                 r_node.execute_command = execute_command
 
@@ -1984,25 +2066,30 @@ def execute_command(*args, **kwargs):
 
             create_redis_node.side_effect = create_mocked_redis_node
 
-            node_1 = ClusterNode('127.0.0.1', 7000)
-            node_2 = ClusterNode('127.0.0.1', 7001)
+            node_1 = ClusterNode("127.0.0.1", 7000)
+            node_2 = ClusterNode("127.0.0.1", 7001)
 
             # If all startup nodes fail to connect, connection error should be
             # thrown
             with pytest.raises(RedisClusterException) as e:
                 RedisCluster(startup_nodes=[node_1])
-            assert 'Redis Cluster cannot be connected' in str(e.value)
+            assert "Redis Cluster cannot be connected" in str(e.value)
 
-            with patch.object(CommandsParser, 'initialize',
-                              autospec=True) as cmd_parser_initialize:
+            with patch.object(
+                CommandsParser, "initialize", autospec=True
+            ) as cmd_parser_initialize:
 
                 def cmd_init_mock(self, r):
-                    self.commands = {'get': {'name': 'get', 'arity': 2,
-                                             'flags': ['readonly',
-                                                       'fast'],
-                                             'first_key_pos': 1,
-                                             'last_key_pos': 1,
-                                             'step_count': 1}}
+                    self.commands = {
+                        "get": {
+                            "name": "get",
+                            "arity": 2,
+                            "flags": ["readonly", "fast"],
+                            "first_key_pos": 1,
+                            "last_key_pos": 1,
+                            "step_count": 1,
+                        }
+                    }
 
                 cmd_parser_initialize.side_effect = cmd_init_mock
                 # When at least one startup node is reachable, the cluster
@@ -2040,7 +2127,7 @@ def test_init_pubusub_without_specifying_node(self, r):
         should be determined based on the keyslot of the first command
         execution.
         """
-        channel_name = 'foo'
+        channel_name = "foo"
         node = r.get_node_from_key(channel_name)
         p = r.pubsub()
         assert p.get_pubsub_node() is None
@@ -2052,7 +2139,7 @@ def test_init_pubsub_with_a_non_existent_node(self, r):
         Test creation of pubsub instance with node that doesn't exists in the
         cluster. RedisClusterException should be raised.
         """
-        node = ClusterNode('1.1.1.1', 1111)
+        node = ClusterNode("1.1.1.1", 1111)
         with pytest.raises(RedisClusterException):
             r.pubsub(node)
 
@@ -2063,7 +2150,7 @@ def test_init_pubsub_with_a_non_existent_host_port(self, r):
         RedisClusterException should be raised.
         """
         with pytest.raises(RedisClusterException):
-            r.pubsub(host='1.1.1.1', port=1111)
+            r.pubsub(host="1.1.1.1", port=1111)
 
     def test_init_pubsub_host_or_port(self, r):
         """
@@ -2071,7 +2158,7 @@ def test_init_pubsub_host_or_port(self, r):
         versa. DataError should be raised.
         """
         with pytest.raises(DataError):
-            r.pubsub(host='localhost')
+            r.pubsub(host="localhost")
 
         with pytest.raises(DataError):
             r.pubsub(port=16379)
@@ -2131,14 +2218,17 @@ def test_blocked_arguments(self, r):
         with pytest.raises(RedisClusterException) as ex:
             r.pipeline(transaction=True)
 
-        assert str(ex.value).startswith(
-            "transaction is deprecated in cluster mode") is True
+        assert (
+            str(ex.value).startswith("transaction is deprecated in cluster mode")
+            is True
+        )
 
         with pytest.raises(RedisClusterException) as ex:
             r.pipeline(shard_hint=True)
 
-        assert str(ex.value).startswith(
-            "shard_hint is deprecated in cluster mode") is True
+        assert (
+            str(ex.value).startswith("shard_hint is deprecated in cluster mode") is True
+        )
 
     def test_redis_cluster_pipeline(self, r):
         """
@@ -2147,7 +2237,7 @@ def test_redis_cluster_pipeline(self, r):
         with r.pipeline() as pipe:
             pipe.set("foo", "bar")
             pipe.get("foo")
-            assert pipe.execute() == [True, b'bar']
+            assert pipe.execute() == [True, b"bar"]
 
     def test_mget_disabled(self, r):
         """
@@ -2155,7 +2245,7 @@ def test_mget_disabled(self, r):
         """
         with r.pipeline() as pipe:
             with pytest.raises(RedisClusterException):
-                pipe.mget(['a'])
+                pipe.mget(["a"])
 
     def test_mset_disabled(self, r):
         """
@@ -2163,7 +2253,7 @@ def test_mset_disabled(self, r):
         """
         with r.pipeline() as pipe:
             with pytest.raises(RedisClusterException):
-                pipe.mset({'a': 1, 'b': 2})
+                pipe.mset({"a": 1, "b": 2})
 
     def test_rename_disabled(self, r):
         """
@@ -2171,7 +2261,7 @@ def test_rename_disabled(self, r):
         """
         with r.pipeline(transaction=False) as pipe:
             with pytest.raises(RedisClusterException):
-                pipe.rename('a', 'b')
+                pipe.rename("a", "b")
 
     def test_renamenx_disabled(self, r):
         """
@@ -2179,15 +2269,15 @@ def test_renamenx_disabled(self, r):
         """
         with r.pipeline(transaction=False) as pipe:
             with pytest.raises(RedisClusterException):
-                pipe.renamenx('a', 'b')
+                pipe.renamenx("a", "b")
 
     def test_delete_single(self, r):
         """
         Test a single delete operation
         """
-        r['a'] = 1
+        r["a"] = 1
         with r.pipeline(transaction=False) as pipe:
-            pipe.delete('a')
+            pipe.delete("a")
             assert pipe.execute() == [1]
 
     def test_multi_delete_unsupported(self, r):
@@ -2195,10 +2285,10 @@ def test_multi_delete_unsupported(self, r):
         Test that multi delete operation is unsupported
         """
         with r.pipeline(transaction=False) as pipe:
-            r['a'] = 1
-            r['b'] = 2
+            r["a"] = 1
+            r["b"] = 2
             with pytest.raises(RedisClusterException):
-                pipe.delete('a', 'b')
+                pipe.delete("a", "b")
 
     def test_brpoplpush_disabled(self, r):
         """
@@ -2293,41 +2383,40 @@ def test_multi_key_operation_with_a_single_slot(self, r):
         Test multi key operation with a single slot
         """
         pipe = r.pipeline(transaction=False)
-        pipe.set('a{foo}', 1)
-        pipe.set('b{foo}', 2)
-        pipe.set('c{foo}', 3)
-        pipe.get('a{foo}')
-        pipe.get('b{foo}')
-        pipe.get('c{foo}')
+        pipe.set("a{foo}", 1)
+        pipe.set("b{foo}", 2)
+        pipe.set("c{foo}", 3)
+        pipe.get("a{foo}")
+        pipe.get("b{foo}")
+        pipe.get("c{foo}")
 
         res = pipe.execute()
-        assert res == [True, True, True, b'1', b'2', b'3']
+        assert res == [True, True, True, b"1", b"2", b"3"]
 
     def test_multi_key_operation_with_multi_slots(self, r):
         """
         Test multi key operation with more than one slot
         """
         pipe = r.pipeline(transaction=False)
-        pipe.set('a{foo}', 1)
-        pipe.set('b{foo}', 2)
-        pipe.set('c{foo}', 3)
-        pipe.set('bar', 4)
-        pipe.set('bazz', 5)
-        pipe.get('a{foo}')
-        pipe.get('b{foo}')
-        pipe.get('c{foo}')
-        pipe.get('bar')
-        pipe.get('bazz')
+        pipe.set("a{foo}", 1)
+        pipe.set("b{foo}", 2)
+        pipe.set("c{foo}", 3)
+        pipe.set("bar", 4)
+        pipe.set("bazz", 5)
+        pipe.get("a{foo}")
+        pipe.get("b{foo}")
+        pipe.get("c{foo}")
+        pipe.get("bar")
+        pipe.get("bazz")
         res = pipe.execute()
-        assert res == [True, True, True, True, True, b'1', b'2', b'3', b'4',
-                       b'5']
+        assert res == [True, True, True, True, True, b"1", b"2", b"3", b"4", b"5"]
 
     def test_connection_error_not_raised(self, r):
         """
         Test that the pipeline doesn't raise an error on connection error when
         raise_on_error=False
         """
-        key = 'foo'
+        key = "foo"
         node = r.get_node_from_key(key, False)
 
         def raise_connection_error():
@@ -2345,7 +2434,7 @@ def test_connection_error_raised(self, r):
         Test that the pipeline raises an error on connection error when
         raise_on_error=True
         """
-        key = 'foo'
+        key = "foo"
         node = r.get_node_from_key(key, False)
 
         def raise_connection_error():
@@ -2361,7 +2450,7 @@ def test_asking_error(self, r):
         """
         Test redirection on ASK error
         """
-        key = 'foo'
+        key = "foo"
         first_node = r.get_node_from_key(key, False)
         ask_node = None
         for node in r.get_nodes():
@@ -2369,8 +2458,7 @@ def test_asking_error(self, r):
                 ask_node = node
                 break
         if ask_node is None:
-            warnings.warn("skipping this test since the cluster has only one "
-                          "node")
+            warnings.warn("skipping this test since the cluster has only one " "node")
             return
         ask_msg = f"{r.keyslot(key)} {ask_node.host}:{ask_node.port}"
 
@@ -2379,11 +2467,11 @@ def raise_ask_error():
 
         with r.pipeline() as pipe:
             mock_node_resp_func(first_node, raise_ask_error)
-            mock_node_resp(ask_node, 'MOCK_OK')
+            mock_node_resp(ask_node, "MOCK_OK")
             res = pipe.get(key).execute()
             assert first_node.redis_connection.connection.read_response.called
             assert ask_node.redis_connection.connection.read_response.called
-            assert res == ['MOCK_OK']
+            assert res == ["MOCK_OK"]
 
     def test_empty_stack(self, r):
         """
@@ -2405,17 +2493,16 @@ def test_pipeline_readonly(self, r):
         """
         On readonly mode, we supports get related stuff only.
         """
-        r.readonly(target_nodes='all')
-        r.set('foo71', 'a1')  # we assume this key is set on 127.0.0.1:7001
-        r.zadd('foo88',
-               {'z1': 1})  # we assume this key is set on 127.0.0.1:7002
-        r.zadd('foo88', {'z2': 4})
+        r.readonly(target_nodes="all")
+        r.set("foo71", "a1")  # we assume this key is set on 127.0.0.1:7001
+        r.zadd("foo88", {"z1": 1})  # we assume this key is set on 127.0.0.1:7002
+        r.zadd("foo88", {"z2": 4})
 
         with r.pipeline() as readonly_pipe:
-            readonly_pipe.get('foo71').zrange('foo88', 0, 5, withscores=True)
+            readonly_pipe.get("foo71").zrange("foo88", 0, 5, withscores=True)
             assert readonly_pipe.execute() == [
-                b'a1',
-                [(b'z1', 1.0), (b'z2', 4)],
+                b"a1",
+                [(b"z1", 1.0), (b"z2", 4)],
             ]
 
     def test_moved_redirection_on_slave_with_default(self, r):
@@ -2423,8 +2510,8 @@ def test_moved_redirection_on_slave_with_default(self, r):
         On Pipeline, we redirected once and finally get from master with
         readonly client when data is completely moved.
         """
-        key = 'bar'
-        r.set(key, 'foo')
+        key = "bar"
+        r.set(key, "foo")
         # set read_from_replicas to True
         r.read_from_replicas = True
         primary = r.get_node_from_key(key, False)
@@ -2456,15 +2543,15 @@ def test_readonly_pipeline_from_readonly_client(self, request):
         """
         # Create a cluster with reading from replications
         ro = _get_client(RedisCluster, request, read_from_replicas=True)
-        key = 'bar'
-        ro.set(key, 'foo')
+        key = "bar"
+        ro.set(key, "foo")
         import time
+
         time.sleep(0.2)
         with ro.pipeline() as readonly_pipe:
-            mock_all_nodes_resp(ro, 'MOCK_OK')
+            mock_all_nodes_resp(ro, "MOCK_OK")
             assert readonly_pipe.read_from_replicas is True
-            assert readonly_pipe.get(key).get(
-                key).execute() == ['MOCK_OK', 'MOCK_OK']
+            assert readonly_pipe.get(key).get(key).execute() == ["MOCK_OK", "MOCK_OK"]
             slot_nodes = ro.nodes_manager.slots_cache[ro.keyslot(key)]
             if len(slot_nodes) > 1:
                 executed_on_replica = False
diff --git a/tests/test_command_parser.py b/tests/test_command_parser.py
index ba129ba673..ad29e69f37 100644
--- a/tests/test_command_parser.py
+++ b/tests/test_command_parser.py
@@ -7,56 +7,74 @@ class TestCommandsParser:
     def test_init_commands(self, r):
         commands_parser = CommandsParser(r)
         assert commands_parser.commands is not None
-        assert 'get' in commands_parser.commands
+        assert "get" in commands_parser.commands
 
     def test_get_keys_predetermined_key_location(self, r):
         commands_parser = CommandsParser(r)
-        args1 = ['GET', 'foo']
-        args2 = ['OBJECT', 'encoding', 'foo']
-        args3 = ['MGET', 'foo', 'bar', 'foobar']
-        assert commands_parser.get_keys(r, *args1) == ['foo']
-        assert commands_parser.get_keys(r, *args2) == ['foo']
-        assert commands_parser.get_keys(r, *args3) == ['foo', 'bar', 'foobar']
+        args1 = ["GET", "foo"]
+        args2 = ["OBJECT", "encoding", "foo"]
+        args3 = ["MGET", "foo", "bar", "foobar"]
+        assert commands_parser.get_keys(r, *args1) == ["foo"]
+        assert commands_parser.get_keys(r, *args2) == ["foo"]
+        assert commands_parser.get_keys(r, *args3) == ["foo", "bar", "foobar"]
 
     @pytest.mark.filterwarnings("ignore:ResponseError")
     def test_get_moveable_keys(self, r):
         commands_parser = CommandsParser(r)
-        args1 = ['EVAL', 'return {KEYS[1],KEYS[2],ARGV[1],ARGV[2]}', 2, 'key1',
-                 'key2', 'first', 'second']
-        args2 = ['XREAD', 'COUNT', 2, b'STREAMS', 'mystream', 'writers', 0, 0]
-        args3 = ['ZUNIONSTORE', 'out', 2, 'zset1', 'zset2', 'WEIGHTS', 2, 3]
-        args4 = ['GEORADIUS', 'Sicily', 15, 37, 200, 'km', 'WITHCOORD',
-                 b'STORE', 'out']
-        args5 = ['MEMORY USAGE', 'foo']
-        args6 = ['MIGRATE', '192.168.1.34', 6379, "", 0, 5000, b'KEYS',
-                 'key1', 'key2', 'key3']
-        args7 = ['MIGRATE', '192.168.1.34', 6379, "key1", 0, 5000]
-        args8 = ['STRALGO', 'LCS', 'STRINGS', 'string_a', 'string_b']
-        args9 = ['STRALGO', 'LCS', 'KEYS', 'key1', 'key2']
+        args1 = [
+            "EVAL",
+            "return {KEYS[1],KEYS[2],ARGV[1],ARGV[2]}",
+            2,
+            "key1",
+            "key2",
+            "first",
+            "second",
+        ]
+        args2 = ["XREAD", "COUNT", 2, b"STREAMS", "mystream", "writers", 0, 0]
+        args3 = ["ZUNIONSTORE", "out", 2, "zset1", "zset2", "WEIGHTS", 2, 3]
+        args4 = ["GEORADIUS", "Sicily", 15, 37, 200, "km", "WITHCOORD", b"STORE", "out"]
+        args5 = ["MEMORY USAGE", "foo"]
+        args6 = [
+            "MIGRATE",
+            "192.168.1.34",
+            6379,
+            "",
+            0,
+            5000,
+            b"KEYS",
+            "key1",
+            "key2",
+            "key3",
+        ]
+        args7 = ["MIGRATE", "192.168.1.34", 6379, "key1", 0, 5000]
+        args8 = ["STRALGO", "LCS", "STRINGS", "string_a", "string_b"]
+        args9 = ["STRALGO", "LCS", "KEYS", "key1", "key2"]
 
-        assert commands_parser.get_keys(
-            r, *args1).sort() == ['key1', 'key2'].sort()
-        assert commands_parser.get_keys(
-            r, *args2).sort() == ['mystream', 'writers'].sort()
-        assert commands_parser.get_keys(
-            r, *args3).sort() == ['out', 'zset1', 'zset2'].sort()
-        assert commands_parser.get_keys(
-            r, *args4).sort() == ['Sicily', 'out'].sort()
-        assert commands_parser.get_keys(r, *args5).sort() == ['foo'].sort()
-        assert commands_parser.get_keys(
-            r, *args6).sort() == ['key1', 'key2', 'key3'].sort()
-        assert commands_parser.get_keys(r, *args7).sort() == ['key1'].sort()
+        assert commands_parser.get_keys(r, *args1).sort() == ["key1", "key2"].sort()
+        assert (
+            commands_parser.get_keys(r, *args2).sort() == ["mystream", "writers"].sort()
+        )
+        assert (
+            commands_parser.get_keys(r, *args3).sort()
+            == ["out", "zset1", "zset2"].sort()
+        )
+        assert commands_parser.get_keys(r, *args4).sort() == ["Sicily", "out"].sort()
+        assert commands_parser.get_keys(r, *args5).sort() == ["foo"].sort()
+        assert (
+            commands_parser.get_keys(r, *args6).sort()
+            == ["key1", "key2", "key3"].sort()
+        )
+        assert commands_parser.get_keys(r, *args7).sort() == ["key1"].sort()
         assert commands_parser.get_keys(r, *args8) is None
-        assert commands_parser.get_keys(
-            r, *args9).sort() == ['key1', 'key2'].sort()
+        assert commands_parser.get_keys(r, *args9).sort() == ["key1", "key2"].sort()
 
     def test_get_pubsub_keys(self, r):
         commands_parser = CommandsParser(r)
-        args1 = ['PUBLISH', 'foo', 'bar']
-        args2 = ['PUBSUB NUMSUB', 'foo1', 'foo2', 'foo3']
-        args3 = ['PUBSUB channels', '*']
-        args4 = ['SUBSCRIBE', 'foo1', 'foo2', 'foo3']
-        assert commands_parser.get_keys(r, *args1) == ['foo']
-        assert commands_parser.get_keys(r, *args2) == ['foo1', 'foo2', 'foo3']
-        assert commands_parser.get_keys(r, *args3) == ['*']
-        assert commands_parser.get_keys(r, *args4) == ['foo1', 'foo2', 'foo3']
+        args1 = ["PUBLISH", "foo", "bar"]
+        args2 = ["PUBSUB NUMSUB", "foo1", "foo2", "foo3"]
+        args3 = ["PUBSUB channels", "*"]
+        args4 = ["SUBSCRIBE", "foo1", "foo2", "foo3"]
+        assert commands_parser.get_keys(r, *args1) == ["foo"]
+        assert commands_parser.get_keys(r, *args2) == ["foo1", "foo2", "foo3"]
+        assert commands_parser.get_keys(r, *args3) == ["*"]
+        assert commands_parser.get_keys(r, *args4) == ["foo1", "foo2", "foo3"]
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 444a163489..1eb35f8673 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1,19 +1,20 @@
 import binascii
 import datetime
-import pytest
 import re
-import redis
 import time
 from string import ascii_letters
 
-from redis.client import parse_info
+import pytest
+
+import redis
 from redis import exceptions
+from redis.client import parse_info
 
 from .conftest import (
     _get_client,
+    skip_if_redis_enterprise,
     skip_if_server_version_gte,
     skip_if_server_version_lt,
-    skip_if_redis_enterprise,
     skip_unless_arch_bits,
 )
 
@@ -21,21 +22,22 @@
 @pytest.fixture()
 def slowlog(request, r):
     current_config = r.config_get()
-    old_slower_than_value = current_config['slowlog-log-slower-than']
-    old_max_legnth_value = current_config['slowlog-max-len']
+    old_slower_than_value = current_config["slowlog-log-slower-than"]
+    old_max_legnth_value = current_config["slowlog-max-len"]
 
     def cleanup():
-        r.config_set('slowlog-log-slower-than', old_slower_than_value)
-        r.config_set('slowlog-max-len', old_max_legnth_value)
+        r.config_set("slowlog-log-slower-than", old_slower_than_value)
+        r.config_set("slowlog-max-len", old_max_legnth_value)
+
     request.addfinalizer(cleanup)
 
-    r.config_set('slowlog-log-slower-than', 0)
-    r.config_set('slowlog-max-len', 128)
+    r.config_set("slowlog-log-slower-than", 0)
+    r.config_set("slowlog-max-len", 128)
 
 
 def redis_server_time(client):
     seconds, milliseconds = client.time()
-    timestamp = float(f'{seconds}.{milliseconds}')
+    timestamp = float(f"{seconds}.{milliseconds}")
     return datetime.datetime.fromtimestamp(timestamp)
 
 
@@ -54,19 +56,19 @@ class TestResponseCallbacks:
     def test_response_callbacks(self, r):
         assert r.response_callbacks == redis.Redis.RESPONSE_CALLBACKS
         assert id(r.response_callbacks) != id(redis.Redis.RESPONSE_CALLBACKS)
-        r.set_response_callback('GET', lambda x: 'static')
-        r['a'] = 'foo'
-        assert r['a'] == 'static'
+        r.set_response_callback("GET", lambda x: "static")
+        r["a"] = "foo"
+        assert r["a"] == "static"
 
     def test_case_insensitive_command_names(self, r):
-        assert r.response_callbacks['del'] == r.response_callbacks['DEL']
+        assert r.response_callbacks["del"] == r.response_callbacks["DEL"]
 
 
 class TestRedisCommands:
     def test_command_on_invalid_key_type(self, r):
-        r.lpush('a', '1')
+        r.lpush("a", "1")
         with pytest.raises(redis.ResponseError):
-            r['a']
+            r["a"]
 
     # SERVER INFORMATION
     @pytest.mark.onlynoncluster
@@ -74,20 +76,20 @@ def test_command_on_invalid_key_type(self, r):
     def test_acl_cat_no_category(self, r):
         categories = r.acl_cat()
         assert isinstance(categories, list)
-        assert 'read' in categories
+        assert "read" in categories
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     def test_acl_cat_with_category(self, r):
-        commands = r.acl_cat('read')
+        commands = r.acl_cat("read")
         assert isinstance(commands, list)
-        assert 'get' in commands
+        assert "get" in commands
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_deluser(self, r, request):
-        username = 'redis-py-user'
+        username = "redis-py-user"
 
         def teardown():
             r.acl_deluser(username)
@@ -99,7 +101,7 @@ def teardown():
         assert r.acl_deluser(username) == 1
 
         # now, a group of users
-        users = [f'bogususer_{r}' for r in range(0, 5)]
+        users = [f"bogususer_{r}" for r in range(0, 5)]
         for u in users:
             r.acl_setuser(u, enabled=False, reset=True)
         assert r.acl_deluser(*users) > 1
@@ -117,7 +119,7 @@ def test_acl_genpass(self, r):
         assert isinstance(password, str)
 
         with pytest.raises(exceptions.DataError):
-            r.acl_genpass('value')
+            r.acl_genpass("value")
             r.acl_genpass(-5)
             r.acl_genpass(5555)
 
@@ -128,90 +130,109 @@ def test_acl_genpass(self, r):
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_getuser_setuser(self, r, request):
-        username = 'redis-py-user'
+        username = "redis-py-user"
 
         def teardown():
             r.acl_deluser(username)
+
         request.addfinalizer(teardown)
 
         # test enabled=False
         assert r.acl_setuser(username, enabled=False, reset=True)
         acl = r.acl_getuser(username)
-        assert acl['categories'] == ['-@all']
-        assert acl['commands'] == []
-        assert acl['keys'] == []
-        assert acl['passwords'] == []
-        assert 'off' in acl['flags']
-        assert acl['enabled'] is False
+        assert acl["categories"] == ["-@all"]
+        assert acl["commands"] == []
+        assert acl["keys"] == []
+        assert acl["passwords"] == []
+        assert "off" in acl["flags"]
+        assert acl["enabled"] is False
 
         # test nopass=True
         assert r.acl_setuser(username, enabled=True, reset=True, nopass=True)
         acl = r.acl_getuser(username)
-        assert acl['categories'] == ['-@all']
-        assert acl['commands'] == []
-        assert acl['keys'] == []
-        assert acl['passwords'] == []
-        assert 'on' in acl['flags']
-        assert 'nopass' in acl['flags']
-        assert acl['enabled'] is True
+        assert acl["categories"] == ["-@all"]
+        assert acl["commands"] == []
+        assert acl["keys"] == []
+        assert acl["passwords"] == []
+        assert "on" in acl["flags"]
+        assert "nopass" in acl["flags"]
+        assert acl["enabled"] is True
 
         # test all args
-        assert r.acl_setuser(username, enabled=True, reset=True,
-                             passwords=['+pass1', '+pass2'],
-                             categories=['+set', '+@hash', '-geo'],
-                             commands=['+get', '+mget', '-hset'],
-                             keys=['cache:*', 'objects:*'])
+        assert r.acl_setuser(
+            username,
+            enabled=True,
+            reset=True,
+            passwords=["+pass1", "+pass2"],
+            categories=["+set", "+@hash", "-geo"],
+            commands=["+get", "+mget", "-hset"],
+            keys=["cache:*", "objects:*"],
+        )
         acl = r.acl_getuser(username)
-        assert set(acl['categories']) == {'-@all', '+@set', '+@hash'}
-        assert set(acl['commands']) == {'+get', '+mget', '-hset'}
-        assert acl['enabled'] is True
-        assert 'on' in acl['flags']
-        assert set(acl['keys']) == {b'cache:*', b'objects:*'}
-        assert len(acl['passwords']) == 2
+        assert set(acl["categories"]) == {"-@all", "+@set", "+@hash"}
+        assert set(acl["commands"]) == {"+get", "+mget", "-hset"}
+        assert acl["enabled"] is True
+        assert "on" in acl["flags"]
+        assert set(acl["keys"]) == {b"cache:*", b"objects:*"}
+        assert len(acl["passwords"]) == 2
 
         # test reset=False keeps existing ACL and applies new ACL on top
-        assert r.acl_setuser(username, enabled=True, reset=True,
-                             passwords=['+pass1'],
-                             categories=['+@set'],
-                             commands=['+get'],
-                             keys=['cache:*'])
-        assert r.acl_setuser(username, enabled=True,
-                             passwords=['+pass2'],
-                             categories=['+@hash'],
-                             commands=['+mget'],
-                             keys=['objects:*'])
+        assert r.acl_setuser(
+            username,
+            enabled=True,
+            reset=True,
+            passwords=["+pass1"],
+            categories=["+@set"],
+            commands=["+get"],
+            keys=["cache:*"],
+        )
+        assert r.acl_setuser(
+            username,
+            enabled=True,
+            passwords=["+pass2"],
+            categories=["+@hash"],
+            commands=["+mget"],
+            keys=["objects:*"],
+        )
         acl = r.acl_getuser(username)
-        assert set(acl['categories']) == {'-@all', '+@set', '+@hash'}
-        assert set(acl['commands']) == {'+get', '+mget'}
-        assert acl['enabled'] is True
-        assert 'on' in acl['flags']
-        assert set(acl['keys']) == {b'cache:*', b'objects:*'}
-        assert len(acl['passwords']) == 2
+        assert set(acl["categories"]) == {"-@all", "+@set", "+@hash"}
+        assert set(acl["commands"]) == {"+get", "+mget"}
+        assert acl["enabled"] is True
+        assert "on" in acl["flags"]
+        assert set(acl["keys"]) == {b"cache:*", b"objects:*"}
+        assert len(acl["passwords"]) == 2
 
         # test removal of passwords
-        assert r.acl_setuser(username, enabled=True, reset=True,
-                             passwords=['+pass1', '+pass2'])
-        assert len(r.acl_getuser(username)['passwords']) == 2
-        assert r.acl_setuser(username, enabled=True,
-                             passwords=['-pass2'])
-        assert len(r.acl_getuser(username)['passwords']) == 1
+        assert r.acl_setuser(
+            username, enabled=True, reset=True, passwords=["+pass1", "+pass2"]
+        )
+        assert len(r.acl_getuser(username)["passwords"]) == 2
+        assert r.acl_setuser(username, enabled=True, passwords=["-pass2"])
+        assert len(r.acl_getuser(username)["passwords"]) == 1
 
         # Resets and tests that hashed passwords are set properly.
-        hashed_password = ('5e884898da28047151d0e56f8dc629'
-                           '2773603d0d6aabbdd62a11ef721d1542d8')
-        assert r.acl_setuser(username, enabled=True, reset=True,
-                             hashed_passwords=['+' + hashed_password])
+        hashed_password = (
+            "5e884898da28047151d0e56f8dc629" "2773603d0d6aabbdd62a11ef721d1542d8"
+        )
+        assert r.acl_setuser(
+            username, enabled=True, reset=True, hashed_passwords=["+" + hashed_password]
+        )
         acl = r.acl_getuser(username)
-        assert acl['passwords'] == [hashed_password]
+        assert acl["passwords"] == [hashed_password]
 
         # test removal of hashed passwords
-        assert r.acl_setuser(username, enabled=True, reset=True,
-                             hashed_passwords=['+' + hashed_password],
-                             passwords=['+pass1'])
-        assert len(r.acl_getuser(username)['passwords']) == 2
-        assert r.acl_setuser(username, enabled=True,
-                             hashed_passwords=['-' + hashed_password])
-        assert len(r.acl_getuser(username)['passwords']) == 1
+        assert r.acl_setuser(
+            username,
+            enabled=True,
+            reset=True,
+            hashed_passwords=["+" + hashed_password],
+            passwords=["+pass1"],
+        )
+        assert len(r.acl_getuser(username)["passwords"]) == 2
+        assert r.acl_setuser(
+            username, enabled=True, hashed_passwords=["-" + hashed_password]
+        )
+        assert len(r.acl_getuser(username)["passwords"]) == 1
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
@@ -224,10 +245,11 @@ def test_acl_help(self, r):
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_list(self, r, request):
-        username = 'redis-py-user'
+        username = "redis-py-user"
 
         def teardown():
             r.acl_deluser(username)
+
         request.addfinalizer(teardown)
 
         assert r.acl_setuser(username, enabled=False, reset=True)
@@ -238,77 +260,86 @@ def teardown():
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_log(self, r, request):
-        username = 'redis-py-user'
+        username = "redis-py-user"
 
         def teardown():
             r.acl_deluser(username)
 
         request.addfinalizer(teardown)
-        r.acl_setuser(username, enabled=True, reset=True,
-                      commands=['+get', '+set', '+select'],
-                      keys=['cache:*'], nopass=True)
+        r.acl_setuser(
+            username,
+            enabled=True,
+            reset=True,
+            commands=["+get", "+set", "+select"],
+            keys=["cache:*"],
+            nopass=True,
+        )
         r.acl_log_reset()
 
-        user_client = _get_client(redis.Redis, request, flushdb=False,
-                                  username=username)
+        user_client = _get_client(
+            redis.Redis, request, flushdb=False, username=username
+        )
 
         # Valid operation and key
-        assert user_client.set('cache:0', 1)
-        assert user_client.get('cache:0') == b'1'
+        assert user_client.set("cache:0", 1)
+        assert user_client.get("cache:0") == b"1"
 
         # Invalid key
         with pytest.raises(exceptions.NoPermissionError):
-            user_client.get('violated_cache:0')
+            user_client.get("violated_cache:0")
 
         # Invalid operation
         with pytest.raises(exceptions.NoPermissionError):
-            user_client.hset('cache:0', 'hkey', 'hval')
+            user_client.hset("cache:0", "hkey", "hval")
 
         assert isinstance(r.acl_log(), list)
         assert len(r.acl_log()) == 2
         assert len(r.acl_log(count=1)) == 1
         assert isinstance(r.acl_log()[0], dict)
-        assert 'client-info' in r.acl_log(count=1)[0]
+        assert "client-info" in r.acl_log(count=1)[0]
         assert r.acl_log_reset()
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_setuser_categories_without_prefix_fails(self, r, request):
-        username = 'redis-py-user'
+        username = "redis-py-user"
 
         def teardown():
             r.acl_deluser(username)
+
         request.addfinalizer(teardown)
 
         with pytest.raises(exceptions.DataError):
-            r.acl_setuser(username, categories=['list'])
+            r.acl_setuser(username, categories=["list"])
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_setuser_commands_without_prefix_fails(self, r, request):
-        username = 'redis-py-user'
+        username = "redis-py-user"
 
         def teardown():
             r.acl_deluser(username)
+
         request.addfinalizer(teardown)
 
         with pytest.raises(exceptions.DataError):
-            r.acl_setuser(username, commands=['get'])
+            r.acl_setuser(username, commands=["get"])
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_setuser_add_passwords_and_nopass_fails(self, r, request):
-        username = 'redis-py-user'
+        username = "redis-py-user"
 
         def teardown():
             r.acl_deluser(username)
+
         request.addfinalizer(teardown)
 
         with pytest.raises(exceptions.DataError):
-            r.acl_setuser(username, passwords='+mypass', nopass=True)
+            r.acl_setuser(username, passwords="+mypass", nopass=True)
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
@@ -327,36 +358,36 @@ def test_acl_whoami(self, r):
     def test_client_list(self, r):
         clients = r.client_list()
         assert isinstance(clients[0], dict)
-        assert 'addr' in clients[0]
+        assert "addr" in clients[0]
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_client_info(self, r):
         info = r.client_info()
         assert isinstance(info, dict)
-        assert 'addr' in info
+        assert "addr" in info
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_client_list_types_not_replica(self, r):
         with pytest.raises(exceptions.RedisError):
-            r.client_list(_type='not a client type')
-        for client_type in ['normal', 'master', 'pubsub']:
+            r.client_list(_type="not a client type")
+        for client_type in ["normal", "master", "pubsub"]:
             clients = r.client_list(_type=client_type)
             assert isinstance(clients, list)
 
     @skip_if_redis_enterprise
     def test_client_list_replica(self, r):
-        clients = r.client_list(_type='replica')
+        clients = r.client_list(_type="replica")
         assert isinstance(clients, list)
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_client_list_client_id(self, r, request):
         clients = r.client_list()
-        clients = r.client_list(client_id=[clients[0]['id']])
+        clients = r.client_list(client_id=[clients[0]["id"]])
         assert len(clients) == 1
-        assert 'addr' in clients[0]
+        assert "addr" in clients[0]
 
         # testing multiple client ids
         _get_client(redis.Redis, request, flushdb=False)
@@ -366,19 +397,19 @@ def test_client_list_client_id(self, r, request):
         assert len(clients_listed) > 1
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_client_id(self, r):
         assert r.client_id() > 0
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_client_trackinginfo(self, r):
         res = r.client_trackinginfo()
         assert len(res) > 2
-        assert 'prefixes' in res
+        assert "prefixes" in res
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_client_unblock(self, r):
         myid = r.client_id()
         assert not r.client_unblock(myid)
@@ -386,36 +417,42 @@ def test_client_unblock(self, r):
         assert not r.client_unblock(myid, error=False)
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.6.9')
+    @skip_if_server_version_lt("2.6.9")
     def test_client_getname(self, r):
         assert r.client_getname() is None
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.6.9')
+    @skip_if_server_version_lt("2.6.9")
     def test_client_setname(self, r):
-        assert r.client_setname('redis_py_test')
-        assert r.client_getname() == 'redis_py_test'
+        assert r.client_setname("redis_py_test")
+        assert r.client_getname() == "redis_py_test"
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.6.9')
+    @skip_if_server_version_lt("2.6.9")
     def test_client_kill(self, r, r2):
-        r.client_setname('redis-py-c1')
-        r2.client_setname('redis-py-c2')
-        clients = [client for client in r.client_list()
-                   if client.get('name') in ['redis-py-c1', 'redis-py-c2']]
+        r.client_setname("redis-py-c1")
+        r2.client_setname("redis-py-c2")
+        clients = [
+            client
+            for client in r.client_list()
+            if client.get("name") in ["redis-py-c1", "redis-py-c2"]
+        ]
         assert len(clients) == 2
 
-        clients_by_name = {client.get('name'): client for client in clients}
+        clients_by_name = {client.get("name"): client for client in clients}
 
-        client_addr = clients_by_name['redis-py-c2'].get('addr')
+        client_addr = clients_by_name["redis-py-c2"].get("addr")
         assert r.client_kill(client_addr) is True
 
-        clients = [client for client in r.client_list()
-                   if client.get('name') in ['redis-py-c1', 'redis-py-c2']]
+        clients = [
+            client
+            for client in r.client_list()
+            if client.get("name") in ["redis-py-c1", "redis-py-c2"]
+        ]
         assert len(clients) == 1
-        assert clients[0].get('name') == 'redis-py-c1'
+        assert clients[0].get("name") == "redis-py-c1"
 
-    @skip_if_server_version_lt('2.8.12')
+    @skip_if_server_version_lt("2.8.12")
     def test_client_kill_filter_invalid_params(self, r):
         # empty
         with pytest.raises(exceptions.DataError):
@@ -430,110 +467,130 @@ def test_client_kill_filter_invalid_params(self, r):
             r.client_kill_filter(_type="caster")
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.8.12')
+    @skip_if_server_version_lt("2.8.12")
     def test_client_kill_filter_by_id(self, r, r2):
-        r.client_setname('redis-py-c1')
-        r2.client_setname('redis-py-c2')
-        clients = [client for client in r.client_list()
-                   if client.get('name') in ['redis-py-c1', 'redis-py-c2']]
+        r.client_setname("redis-py-c1")
+        r2.client_setname("redis-py-c2")
+        clients = [
+            client
+            for client in r.client_list()
+            if client.get("name") in ["redis-py-c1", "redis-py-c2"]
+        ]
         assert len(clients) == 2
 
-        clients_by_name = {client.get('name'): client for client in clients}
+        clients_by_name = {client.get("name"): client for client in clients}
 
-        client_2_id = clients_by_name['redis-py-c2'].get('id')
+        client_2_id = clients_by_name["redis-py-c2"].get("id")
         resp = r.client_kill_filter(_id=client_2_id)
         assert resp == 1
 
-        clients = [client for client in r.client_list()
-                   if client.get('name') in ['redis-py-c1', 'redis-py-c2']]
+        clients = [
+            client
+            for client in r.client_list()
+            if client.get("name") in ["redis-py-c1", "redis-py-c2"]
+        ]
         assert len(clients) == 1
-        assert clients[0].get('name') == 'redis-py-c1'
+        assert clients[0].get("name") == "redis-py-c1"
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.8.12')
+    @skip_if_server_version_lt("2.8.12")
     def test_client_kill_filter_by_addr(self, r, r2):
-        r.client_setname('redis-py-c1')
-        r2.client_setname('redis-py-c2')
-        clients = [client for client in r.client_list()
-                   if client.get('name') in ['redis-py-c1', 'redis-py-c2']]
+        r.client_setname("redis-py-c1")
+        r2.client_setname("redis-py-c2")
+        clients = [
+            client
+            for client in r.client_list()
+            if client.get("name") in ["redis-py-c1", "redis-py-c2"]
+        ]
         assert len(clients) == 2
 
-        clients_by_name = {client.get('name'): client for client in clients}
+        clients_by_name = {client.get("name"): client for client in clients}
 
-        client_2_addr = clients_by_name['redis-py-c2'].get('addr')
+        client_2_addr = clients_by_name["redis-py-c2"].get("addr")
         resp = r.client_kill_filter(addr=client_2_addr)
         assert resp == 1
 
-        clients = [client for client in r.client_list()
-                   if client.get('name') in ['redis-py-c1', 'redis-py-c2']]
+        clients = [
+            client
+            for client in r.client_list()
+            if client.get("name") in ["redis-py-c1", "redis-py-c2"]
+        ]
         assert len(clients) == 1
-        assert clients[0].get('name') == 'redis-py-c1'
+        assert clients[0].get("name") == "redis-py-c1"
 
-    @skip_if_server_version_lt('2.6.9')
+    @skip_if_server_version_lt("2.6.9")
     def test_client_list_after_client_setname(self, r):
-        r.client_setname('redis_py_test')
+        r.client_setname("redis_py_test")
         clients = r.client_list()
         # we don't know which client ours will be
-        assert 'redis_py_test' in [c['name'] for c in clients]
+        assert "redis_py_test" in [c["name"] for c in clients]
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_client_kill_filter_by_laddr(self, r, r2):
-        r.client_setname('redis-py-c1')
-        r2.client_setname('redis-py-c2')
-        clients = [client for client in r.client_list()
-                   if client.get('name') in ['redis-py-c1', 'redis-py-c2']]
+        r.client_setname("redis-py-c1")
+        r2.client_setname("redis-py-c2")
+        clients = [
+            client
+            for client in r.client_list()
+            if client.get("name") in ["redis-py-c1", "redis-py-c2"]
+        ]
         assert len(clients) == 2
 
-        clients_by_name = {client.get('name'): client for client in clients}
+        clients_by_name = {client.get("name"): client for client in clients}
 
-        client_2_addr = clients_by_name['redis-py-c2'].get('laddr')
+        client_2_addr = clients_by_name["redis-py-c2"].get("laddr")
         assert r.client_kill_filter(laddr=client_2_addr)
 
-    @skip_if_server_version_lt('6.0.0')
+    @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_client_kill_filter_by_user(self, r, request):
-        killuser = 'user_to_kill'
-        r.acl_setuser(killuser, enabled=True, reset=True,
-                      commands=['+get', '+set', '+select'],
-                      keys=['cache:*'], nopass=True)
+        killuser = "user_to_kill"
+        r.acl_setuser(
+            killuser,
+            enabled=True,
+            reset=True,
+            commands=["+get", "+set", "+select"],
+            keys=["cache:*"],
+            nopass=True,
+        )
         _get_client(redis.Redis, request, flushdb=False, username=killuser)
         r.client_kill_filter(user=killuser)
         clients = r.client_list()
         for c in clients:
-            assert c['user'] != killuser
+            assert c["user"] != killuser
         r.acl_deluser(killuser)
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.9.50')
+    @skip_if_server_version_lt("2.9.50")
     @skip_if_redis_enterprise
     def test_client_pause(self, r):
         assert r.client_pause(1)
         assert r.client_pause(timeout=1)
         with pytest.raises(exceptions.RedisError):
-            r.client_pause(timeout='not an integer')
+            r.client_pause(timeout="not an integer")
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     @skip_if_redis_enterprise
     def test_client_unpause(self, r):
-        assert r.client_unpause() == b'OK'
+        assert r.client_unpause() == b"OK"
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt("3.2.0")
     def test_client_reply(self, r, r_timeout):
-        assert r_timeout.client_reply('ON') == b'OK'
+        assert r_timeout.client_reply("ON") == b"OK"
         with pytest.raises(exceptions.TimeoutError):
-            r_timeout.client_reply('OFF')
+            r_timeout.client_reply("OFF")
 
-            r_timeout.client_reply('SKIP')
+            r_timeout.client_reply("SKIP")
 
-        assert r_timeout.set('foo', 'bar')
+        assert r_timeout.set("foo", "bar")
 
         # validate it was set
-        assert r.get('foo') == b'bar'
+        assert r.get("foo") == b"bar"
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('6.0.0')
+    @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_client_getredir(self, r):
         assert isinstance(r.client_getredir(), int)
@@ -549,37 +606,37 @@ def test_config_get(self, r):
     @skip_if_redis_enterprise
     def test_config_resetstat(self, r):
         r.ping()
-        prior_commands_processed = int(r.info()['total_commands_processed'])
+        prior_commands_processed = int(r.info()["total_commands_processed"])
         assert prior_commands_processed >= 1
         r.config_resetstat()
-        reset_commands_processed = int(r.info()['total_commands_processed'])
+        reset_commands_processed = int(r.info()["total_commands_processed"])
         assert reset_commands_processed < prior_commands_processed
 
     @skip_if_redis_enterprise
     def test_config_set(self, r):
-        r.config_set('timeout', 70)
-        assert r.config_get()['timeout'] == '70'
-        assert r.config_set('timeout', 0)
-        assert r.config_get()['timeout'] == '0'
+        r.config_set("timeout", 70)
+        assert r.config_get()["timeout"] == "70"
+        assert r.config_set("timeout", 0)
+        assert r.config_get()["timeout"] == "0"
 
     @pytest.mark.onlynoncluster
     def test_dbsize(self, r):
-        r['a'] = 'foo'
-        r['b'] = 'bar'
+        r["a"] = "foo"
+        r["b"] = "bar"
         assert r.dbsize() == 2
 
     @pytest.mark.onlynoncluster
     def test_echo(self, r):
-        assert r.echo('foo bar') == b'foo bar'
+        assert r.echo("foo bar") == b"foo bar"
 
     @pytest.mark.onlynoncluster
     def test_info(self, r):
-        r['a'] = 'foo'
-        r['b'] = 'bar'
+        r["a"] = "foo"
+        r["b"] = "bar"
         info = r.info()
         assert isinstance(info, dict)
-        assert 'arch_bits' in info.keys()
-        assert 'redis_version' in info.keys()
+        assert "arch_bits" in info.keys()
+        assert "redis_version" in info.keys()
 
     @pytest.mark.onlynoncluster
     @skip_if_redis_enterprise
@@ -587,20 +644,20 @@ def test_lastsave(self, r):
         assert isinstance(r.lastsave(), datetime.datetime)
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_lolwut(self, r):
-        lolwut = r.lolwut().decode('utf-8')
-        assert 'Redis ver.' in lolwut
+        lolwut = r.lolwut().decode("utf-8")
+        assert "Redis ver." in lolwut
 
-        lolwut = r.lolwut(5, 6, 7, 8).decode('utf-8')
-        assert 'Redis ver.' in lolwut
+        lolwut = r.lolwut(5, 6, 7, 8).decode("utf-8")
+        assert "Redis ver." in lolwut
 
     def test_object(self, r):
-        r['a'] = 'foo'
-        assert isinstance(r.object('refcount', 'a'), int)
-        assert isinstance(r.object('idletime', 'a'), int)
-        assert r.object('encoding', 'a') in (b'raw', b'embstr')
-        assert r.object('idletime', 'invalid-key') is None
+        r["a"] = "foo"
+        assert isinstance(r.object("refcount", "a"), int)
+        assert isinstance(r.object("idletime", "a"), int)
+        assert r.object("encoding", "a") in (b"raw", b"embstr")
+        assert r.object("idletime", "invalid-key") is None
 
     def test_ping(self, r):
         assert r.ping()
@@ -612,36 +669,34 @@ def test_quit(self, r):
     @pytest.mark.onlynoncluster
     def test_slowlog_get(self, r, slowlog):
         assert r.slowlog_reset()
-        unicode_string = chr(3456) + 'abcd' + chr(3421)
+        unicode_string = chr(3456) + "abcd" + chr(3421)
         r.get(unicode_string)
         slowlog = r.slowlog_get()
         assert isinstance(slowlog, list)
-        commands = [log['command'] for log in slowlog]
+        commands = [log["command"] for log in slowlog]
 
-        get_command = b' '.join((b'GET', unicode_string.encode('utf-8')))
+        get_command = b" ".join((b"GET", unicode_string.encode("utf-8")))
         assert get_command in commands
-        assert b'SLOWLOG RESET' in commands
+        assert b"SLOWLOG RESET" in commands
         # the order should be ['GET <uni string>', 'SLOWLOG RESET'],
         # but if other clients are executing commands at the same time, there
         # could be commands, before, between, or after, so just check that
         # the two we care about are in the appropriate order.
-        assert commands.index(get_command) < commands.index(b'SLOWLOG RESET')
+        assert commands.index(get_command) < commands.index(b"SLOWLOG RESET")
 
         # make sure other attributes are typed correctly
-        assert isinstance(slowlog[0]['start_time'], int)
-        assert isinstance(slowlog[0]['duration'], int)
+        assert isinstance(slowlog[0]["start_time"], int)
+        assert isinstance(slowlog[0]["duration"], int)
 
         # Mock result if we didn't get slowlog complexity info.
-        if 'complexity' not in slowlog[0]:
+        if "complexity" not in slowlog[0]:
             # monkey patch parse_response()
             COMPLEXITY_STATEMENT = "Complexity info: N:4712,M:3788"
             old_parse_response = r.parse_response
 
             def parse_response(connection, command_name, **options):
-                if command_name != 'SLOWLOG GET':
-                    return old_parse_response(connection,
-                                              command_name,
-                                              **options)
+                if command_name != "SLOWLOG GET":
+                    return old_parse_response(connection, command_name, **options)
                 responses = connection.read_response()
                 for response in responses:
                     # Complexity info stored as fourth item in list
@@ -653,10 +708,10 @@ def parse_response(connection, command_name, **options):
             # test
             slowlog = r.slowlog_get()
             assert isinstance(slowlog, list)
-            commands = [log['command'] for log in slowlog]
+            commands = [log["command"] for log in slowlog]
             assert get_command in commands
             idx = commands.index(get_command)
-            assert slowlog[idx]['complexity'] == COMPLEXITY_STATEMENT
+            assert slowlog[idx]["complexity"] == COMPLEXITY_STATEMENT
 
             # tear down monkeypatch
             r.parse_response = old_parse_response
@@ -664,7 +719,7 @@ def parse_response(connection, command_name, **options):
     @pytest.mark.onlynoncluster
     def test_slowlog_get_limit(self, r, slowlog):
         assert r.slowlog_reset()
-        r.get('foo')
+        r.get("foo")
         slowlog = r.slowlog_get(1)
         assert isinstance(slowlog, list)
         # only one command, based on the number we passed to slowlog_get()
@@ -672,10 +727,10 @@ def test_slowlog_get_limit(self, r, slowlog):
 
     @pytest.mark.onlynoncluster
     def test_slowlog_length(self, r, slowlog):
-        r.get('foo')
+        r.get("foo")
         assert isinstance(r.slowlog_len(), int)
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_time(self, r):
         t = r.time()
         assert len(t) == 2
@@ -690,104 +745,104 @@ def test_bgsave(self, r):
 
     # BASIC KEY COMMANDS
     def test_append(self, r):
-        assert r.append('a', 'a1') == 2
-        assert r['a'] == b'a1'
-        assert r.append('a', 'a2') == 4
-        assert r['a'] == b'a1a2'
+        assert r.append("a", "a1") == 2
+        assert r["a"] == b"a1"
+        assert r.append("a", "a2") == 4
+        assert r["a"] == b"a1a2"
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_bitcount(self, r):
-        r.setbit('a', 5, True)
-        assert r.bitcount('a') == 1
-        r.setbit('a', 6, True)
-        assert r.bitcount('a') == 2
-        r.setbit('a', 5, False)
-        assert r.bitcount('a') == 1
-        r.setbit('a', 9, True)
-        r.setbit('a', 17, True)
-        r.setbit('a', 25, True)
-        r.setbit('a', 33, True)
-        assert r.bitcount('a') == 5
-        assert r.bitcount('a', 0, -1) == 5
-        assert r.bitcount('a', 2, 3) == 2
-        assert r.bitcount('a', 2, -1) == 3
-        assert r.bitcount('a', -2, -1) == 2
-        assert r.bitcount('a', 1, 1) == 1
-
-    @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.6.0')
+        r.setbit("a", 5, True)
+        assert r.bitcount("a") == 1
+        r.setbit("a", 6, True)
+        assert r.bitcount("a") == 2
+        r.setbit("a", 5, False)
+        assert r.bitcount("a") == 1
+        r.setbit("a", 9, True)
+        r.setbit("a", 17, True)
+        r.setbit("a", 25, True)
+        r.setbit("a", 33, True)
+        assert r.bitcount("a") == 5
+        assert r.bitcount("a", 0, -1) == 5
+        assert r.bitcount("a", 2, 3) == 2
+        assert r.bitcount("a", 2, -1) == 3
+        assert r.bitcount("a", -2, -1) == 2
+        assert r.bitcount("a", 1, 1) == 1
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("2.6.0")
     def test_bitop_not_empty_string(self, r):
-        r['a'] = ''
-        r.bitop('not', 'r', 'a')
-        assert r.get('r') is None
+        r["a"] = ""
+        r.bitop("not", "r", "a")
+        assert r.get("r") is None
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_bitop_not(self, r):
-        test_str = b'\xAA\x00\xFF\x55'
+        test_str = b"\xAA\x00\xFF\x55"
         correct = ~0xAA00FF55 & 0xFFFFFFFF
-        r['a'] = test_str
-        r.bitop('not', 'r', 'a')
-        assert int(binascii.hexlify(r['r']), 16) == correct
+        r["a"] = test_str
+        r.bitop("not", "r", "a")
+        assert int(binascii.hexlify(r["r"]), 16) == correct
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_bitop_not_in_place(self, r):
-        test_str = b'\xAA\x00\xFF\x55'
+        test_str = b"\xAA\x00\xFF\x55"
         correct = ~0xAA00FF55 & 0xFFFFFFFF
-        r['a'] = test_str
-        r.bitop('not', 'a', 'a')
-        assert int(binascii.hexlify(r['a']), 16) == correct
+        r["a"] = test_str
+        r.bitop("not", "a", "a")
+        assert int(binascii.hexlify(r["a"]), 16) == correct
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_bitop_single_string(self, r):
-        test_str = b'\x01\x02\xFF'
-        r['a'] = test_str
-        r.bitop('and', 'res1', 'a')
-        r.bitop('or', 'res2', 'a')
-        r.bitop('xor', 'res3', 'a')
-        assert r['res1'] == test_str
-        assert r['res2'] == test_str
-        assert r['res3'] == test_str
+        test_str = b"\x01\x02\xFF"
+        r["a"] = test_str
+        r.bitop("and", "res1", "a")
+        r.bitop("or", "res2", "a")
+        r.bitop("xor", "res3", "a")
+        assert r["res1"] == test_str
+        assert r["res2"] == test_str
+        assert r["res3"] == test_str
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_bitop_string_operands(self, r):
-        r['a'] = b'\x01\x02\xFF\xFF'
-        r['b'] = b'\x01\x02\xFF'
-        r.bitop('and', 'res1', 'a', 'b')
-        r.bitop('or', 'res2', 'a', 'b')
-        r.bitop('xor', 'res3', 'a', 'b')
-        assert int(binascii.hexlify(r['res1']), 16) == 0x0102FF00
-        assert int(binascii.hexlify(r['res2']), 16) == 0x0102FFFF
-        assert int(binascii.hexlify(r['res3']), 16) == 0x000000FF
+        r["a"] = b"\x01\x02\xFF\xFF"
+        r["b"] = b"\x01\x02\xFF"
+        r.bitop("and", "res1", "a", "b")
+        r.bitop("or", "res2", "a", "b")
+        r.bitop("xor", "res3", "a", "b")
+        assert int(binascii.hexlify(r["res1"]), 16) == 0x0102FF00
+        assert int(binascii.hexlify(r["res2"]), 16) == 0x0102FFFF
+        assert int(binascii.hexlify(r["res3"]), 16) == 0x000000FF
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.8.7')
+    @skip_if_server_version_lt("2.8.7")
     def test_bitpos(self, r):
-        key = 'key:bitpos'
-        r.set(key, b'\xff\xf0\x00')
+        key = "key:bitpos"
+        r.set(key, b"\xff\xf0\x00")
         assert r.bitpos(key, 0) == 12
         assert r.bitpos(key, 0, 2, -1) == 16
         assert r.bitpos(key, 0, -2, -1) == 12
-        r.set(key, b'\x00\xff\xf0')
+        r.set(key, b"\x00\xff\xf0")
         assert r.bitpos(key, 1, 0) == 8
         assert r.bitpos(key, 1, 1) == 8
-        r.set(key, b'\x00\x00\x00')
+        r.set(key, b"\x00\x00\x00")
         assert r.bitpos(key, 1) == -1
 
-    @skip_if_server_version_lt('2.8.7')
+    @skip_if_server_version_lt("2.8.7")
     def test_bitpos_wrong_arguments(self, r):
-        key = 'key:bitpos:wrong:args'
-        r.set(key, b'\xff\xf0\x00')
+        key = "key:bitpos:wrong:args"
+        r.set(key, b"\xff\xf0\x00")
         with pytest.raises(exceptions.RedisError):
             r.bitpos(key, 0, end=1) == 12
         with pytest.raises(exceptions.RedisError):
             r.bitpos(key, 7) == 12
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_copy(self, r):
         assert r.copy("a", "b") == 0
         r.set("a", "foo")
@@ -796,7 +851,7 @@ def test_copy(self, r):
         assert r.get("b") == b"foo"
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_copy_and_replace(self, r):
         r.set("a", "foo1")
         r.set("b", "foo2")
@@ -804,7 +859,7 @@ def test_copy_and_replace(self, r):
         assert r.copy("a", "b", replace=True) == 1
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_copy_to_another_database(self, request):
         r0 = _get_client(redis.Redis, request, db=0)
         r1 = _get_client(redis.Redis, request, db=1)
@@ -813,2268 +868,2477 @@ def test_copy_to_another_database(self, request):
         assert r1.get("b") == b"foo"
 
     def test_decr(self, r):
-        assert r.decr('a') == -1
-        assert r['a'] == b'-1'
-        assert r.decr('a') == -2
-        assert r['a'] == b'-2'
-        assert r.decr('a', amount=5) == -7
-        assert r['a'] == b'-7'
+        assert r.decr("a") == -1
+        assert r["a"] == b"-1"
+        assert r.decr("a") == -2
+        assert r["a"] == b"-2"
+        assert r.decr("a", amount=5) == -7
+        assert r["a"] == b"-7"
 
     def test_decrby(self, r):
-        assert r.decrby('a', amount=2) == -2
-        assert r.decrby('a', amount=3) == -5
-        assert r['a'] == b'-5'
+        assert r.decrby("a", amount=2) == -2
+        assert r.decrby("a", amount=3) == -5
+        assert r["a"] == b"-5"
 
     def test_delete(self, r):
-        assert r.delete('a') == 0
-        r['a'] = 'foo'
-        assert r.delete('a') == 1
+        assert r.delete("a") == 0
+        r["a"] = "foo"
+        assert r.delete("a") == 1
 
     def test_delete_with_multiple_keys(self, r):
-        r['a'] = 'foo'
-        r['b'] = 'bar'
-        assert r.delete('a', 'b') == 2
-        assert r.get('a') is None
-        assert r.get('b') is None
+        r["a"] = "foo"
+        r["b"] = "bar"
+        assert r.delete("a", "b") == 2
+        assert r.get("a") is None
+        assert r.get("b") is None
 
     def test_delitem(self, r):
-        r['a'] = 'foo'
-        del r['a']
-        assert r.get('a') is None
+        r["a"] = "foo"
+        del r["a"]
+        assert r.get("a") is None
 
-    @skip_if_server_version_lt('4.0.0')
+    @skip_if_server_version_lt("4.0.0")
     def test_unlink(self, r):
-        assert r.unlink('a') == 0
-        r['a'] = 'foo'
-        assert r.unlink('a') == 1
-        assert r.get('a') is None
+        assert r.unlink("a") == 0
+        r["a"] = "foo"
+        assert r.unlink("a") == 1
+        assert r.get("a") is None
 
-    @skip_if_server_version_lt('4.0.0')
+    @skip_if_server_version_lt("4.0.0")
     def test_unlink_with_multiple_keys(self, r):
-        r['a'] = 'foo'
-        r['b'] = 'bar'
-        assert r.unlink('a', 'b') == 2
-        assert r.get('a') is None
-        assert r.get('b') is None
+        r["a"] = "foo"
+        r["b"] = "bar"
+        assert r.unlink("a", "b") == 2
+        assert r.get("a") is None
+        assert r.get("b") is None
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_dump_and_restore(self, r):
-        r['a'] = 'foo'
-        dumped = r.dump('a')
-        del r['a']
-        r.restore('a', 0, dumped)
-        assert r['a'] == b'foo'
+        r["a"] = "foo"
+        dumped = r.dump("a")
+        del r["a"]
+        r.restore("a", 0, dumped)
+        assert r["a"] == b"foo"
 
-    @skip_if_server_version_lt('3.0.0')
+    @skip_if_server_version_lt("3.0.0")
     def test_dump_and_restore_and_replace(self, r):
-        r['a'] = 'bar'
-        dumped = r.dump('a')
+        r["a"] = "bar"
+        dumped = r.dump("a")
         with pytest.raises(redis.ResponseError):
-            r.restore('a', 0, dumped)
+            r.restore("a", 0, dumped)
 
-        r.restore('a', 0, dumped, replace=True)
-        assert r['a'] == b'bar'
+        r.restore("a", 0, dumped, replace=True)
+        assert r["a"] == b"bar"
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_dump_and_restore_absttl(self, r):
-        r['a'] = 'foo'
-        dumped = r.dump('a')
-        del r['a']
+        r["a"] = "foo"
+        dumped = r.dump("a")
+        del r["a"]
         ttl = int(
-            (redis_server_time(r) + datetime.timedelta(minutes=1)).timestamp()
-            * 1000
+            (redis_server_time(r) + datetime.timedelta(minutes=1)).timestamp() * 1000
         )
-        r.restore('a', ttl, dumped, absttl=True)
-        assert r['a'] == b'foo'
-        assert 0 < r.ttl('a') <= 61
+        r.restore("a", ttl, dumped, absttl=True)
+        assert r["a"] == b"foo"
+        assert 0 < r.ttl("a") <= 61
 
     def test_exists(self, r):
-        assert r.exists('a') == 0
-        r['a'] = 'foo'
-        r['b'] = 'bar'
-        assert r.exists('a') == 1
-        assert r.exists('a', 'b') == 2
+        assert r.exists("a") == 0
+        r["a"] = "foo"
+        r["b"] = "bar"
+        assert r.exists("a") == 1
+        assert r.exists("a", "b") == 2
 
     def test_exists_contains(self, r):
-        assert 'a' not in r
-        r['a'] = 'foo'
-        assert 'a' in r
+        assert "a" not in r
+        r["a"] = "foo"
+        assert "a" in r
 
     def test_expire(self, r):
-        assert r.expire('a', 10) is False
-        r['a'] = 'foo'
-        assert r.expire('a', 10) is True
-        assert 0 < r.ttl('a') <= 10
-        assert r.persist('a')
-        assert r.ttl('a') == -1
+        assert r.expire("a", 10) is False
+        r["a"] = "foo"
+        assert r.expire("a", 10) is True
+        assert 0 < r.ttl("a") <= 10
+        assert r.persist("a")
+        assert r.ttl("a") == -1
 
     def test_expireat_datetime(self, r):
         expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
-        r['a'] = 'foo'
-        assert r.expireat('a', expire_at) is True
-        assert 0 < r.ttl('a') <= 61
+        r["a"] = "foo"
+        assert r.expireat("a", expire_at) is True
+        assert 0 < r.ttl("a") <= 61
 
     def test_expireat_no_key(self, r):
         expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
-        assert r.expireat('a', expire_at) is False
+        assert r.expireat("a", expire_at) is False
 
     def test_expireat_unixtime(self, r):
         expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
-        r['a'] = 'foo'
+        r["a"] = "foo"
         expire_at_seconds = int(time.mktime(expire_at.timetuple()))
-        assert r.expireat('a', expire_at_seconds) is True
-        assert 0 < r.ttl('a') <= 61
+        assert r.expireat("a", expire_at_seconds) is True
+        assert 0 < r.ttl("a") <= 61
 
     def test_get_and_set(self, r):
         # get and set can't be tested independently of each other
-        assert r.get('a') is None
-        byte_string = b'value'
+        assert r.get("a") is None
+        byte_string = b"value"
         integer = 5
-        unicode_string = chr(3456) + 'abcd' + chr(3421)
-        assert r.set('byte_string', byte_string)
-        assert r.set('integer', 5)
-        assert r.set('unicode_string', unicode_string)
-        assert r.get('byte_string') == byte_string
-        assert r.get('integer') == str(integer).encode()
-        assert r.get('unicode_string').decode('utf-8') == unicode_string
-
-    @skip_if_server_version_lt('6.2.0')
+        unicode_string = chr(3456) + "abcd" + chr(3421)
+        assert r.set("byte_string", byte_string)
+        assert r.set("integer", 5)
+        assert r.set("unicode_string", unicode_string)
+        assert r.get("byte_string") == byte_string
+        assert r.get("integer") == str(integer).encode()
+        assert r.get("unicode_string").decode("utf-8") == unicode_string
+
+    @skip_if_server_version_lt("6.2.0")
     def test_getdel(self, r):
-        assert r.getdel('a') is None
-        r.set('a', 1)
-        assert r.getdel('a') == b'1'
-        assert r.getdel('a') is None
+        assert r.getdel("a") is None
+        r.set("a", 1)
+        assert r.getdel("a") == b"1"
+        assert r.getdel("a") is None
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_getex(self, r):
-        r.set('a', 1)
-        assert r.getex('a') == b'1'
-        assert r.ttl('a') == -1
-        assert r.getex('a', ex=60) == b'1'
-        assert r.ttl('a') == 60
-        assert r.getex('a', px=6000) == b'1'
-        assert r.ttl('a') == 6
+        r.set("a", 1)
+        assert r.getex("a") == b"1"
+        assert r.ttl("a") == -1
+        assert r.getex("a", ex=60) == b"1"
+        assert r.ttl("a") == 60
+        assert r.getex("a", px=6000) == b"1"
+        assert r.ttl("a") == 6
         expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
-        assert r.getex('a', pxat=expire_at) == b'1'
-        assert r.ttl('a') <= 61
-        assert r.getex('a', persist=True) == b'1'
-        assert r.ttl('a') == -1
+        assert r.getex("a", pxat=expire_at) == b"1"
+        assert r.ttl("a") <= 61
+        assert r.getex("a", persist=True) == b"1"
+        assert r.ttl("a") == -1
 
     def test_getitem_and_setitem(self, r):
-        r['a'] = 'bar'
-        assert r['a'] == b'bar'
+        r["a"] = "bar"
+        assert r["a"] == b"bar"
 
     def test_getitem_raises_keyerror_for_missing_key(self, r):
         with pytest.raises(KeyError):
-            r['a']
+            r["a"]
 
     def test_getitem_does_not_raise_keyerror_for_empty_string(self, r):
-        r['a'] = b""
-        assert r['a'] == b""
+        r["a"] = b""
+        assert r["a"] == b""
 
     def test_get_set_bit(self, r):
         # no value
-        assert not r.getbit('a', 5)
+        assert not r.getbit("a", 5)
         # set bit 5
-        assert not r.setbit('a', 5, True)
-        assert r.getbit('a', 5)
+        assert not r.setbit("a", 5, True)
+        assert r.getbit("a", 5)
         # unset bit 4
-        assert not r.setbit('a', 4, False)
-        assert not r.getbit('a', 4)
+        assert not r.setbit("a", 4, False)
+        assert not r.getbit("a", 4)
         # set bit 4
-        assert not r.setbit('a', 4, True)
-        assert r.getbit('a', 4)
+        assert not r.setbit("a", 4, True)
+        assert r.getbit("a", 4)
         # set bit 5 again
-        assert r.setbit('a', 5, True)
-        assert r.getbit('a', 5)
+        assert r.setbit("a", 5, True)
+        assert r.getbit("a", 5)
 
     def test_getrange(self, r):
-        r['a'] = 'foo'
-        assert r.getrange('a', 0, 0) == b'f'
-        assert r.getrange('a', 0, 2) == b'foo'
-        assert r.getrange('a', 3, 4) == b''
+        r["a"] = "foo"
+        assert r.getrange("a", 0, 0) == b"f"
+        assert r.getrange("a", 0, 2) == b"foo"
+        assert r.getrange("a", 3, 4) == b""
 
     def test_getset(self, r):
-        assert r.getset('a', 'foo') is None
-        assert r.getset('a', 'bar') == b'foo'
-        assert r.get('a') == b'bar'
+        assert r.getset("a", "foo") is None
+        assert r.getset("a", "bar") == b"foo"
+        assert r.get("a") == b"bar"
 
     def test_incr(self, r):
-        assert r.incr('a') == 1
-        assert r['a'] == b'1'
-        assert r.incr('a') == 2
-        assert r['a'] == b'2'
-        assert r.incr('a', amount=5) == 7
-        assert r['a'] == b'7'
+        assert r.incr("a") == 1
+        assert r["a"] == b"1"
+        assert r.incr("a") == 2
+        assert r["a"] == b"2"
+        assert r.incr("a", amount=5) == 7
+        assert r["a"] == b"7"
 
     def test_incrby(self, r):
-        assert r.incrby('a') == 1
-        assert r.incrby('a', 4) == 5
-        assert r['a'] == b'5'
+        assert r.incrby("a") == 1
+        assert r.incrby("a", 4) == 5
+        assert r["a"] == b"5"
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_incrbyfloat(self, r):
-        assert r.incrbyfloat('a') == 1.0
-        assert r['a'] == b'1'
-        assert r.incrbyfloat('a', 1.1) == 2.1
-        assert float(r['a']) == float(2.1)
+        assert r.incrbyfloat("a") == 1.0
+        assert r["a"] == b"1"
+        assert r.incrbyfloat("a", 1.1) == 2.1
+        assert float(r["a"]) == float(2.1)
 
     @pytest.mark.onlynoncluster
     def test_keys(self, r):
         assert r.keys() == []
-        keys_with_underscores = {b'test_a', b'test_b'}
-        keys = keys_with_underscores.union({b'testc'})
+        keys_with_underscores = {b"test_a", b"test_b"}
+        keys = keys_with_underscores.union({b"testc"})
         for key in keys:
             r[key] = 1
-        assert set(r.keys(pattern='test_*')) == keys_with_underscores
-        assert set(r.keys(pattern='test*')) == keys
+        assert set(r.keys(pattern="test_*")) == keys_with_underscores
+        assert set(r.keys(pattern="test*")) == keys
 
     @pytest.mark.onlynoncluster
     def test_mget(self, r):
         assert r.mget([]) == []
-        assert r.mget(['a', 'b']) == [None, None]
-        r['a'] = '1'
-        r['b'] = '2'
-        r['c'] = '3'
-        assert r.mget('a', 'other', 'b', 'c') == [b'1', None, b'2', b'3']
+        assert r.mget(["a", "b"]) == [None, None]
+        r["a"] = "1"
+        r["b"] = "2"
+        r["c"] = "3"
+        assert r.mget("a", "other", "b", "c") == [b"1", None, b"2", b"3"]
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_lmove(self, r):
-        r.rpush('a', 'one', 'two', 'three', 'four')
-        assert r.lmove('a', 'b')
-        assert r.lmove('a', 'b', 'right', 'left')
+        r.rpush("a", "one", "two", "three", "four")
+        assert r.lmove("a", "b")
+        assert r.lmove("a", "b", "right", "left")
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_blmove(self, r):
-        r.rpush('a', 'one', 'two', 'three', 'four')
-        assert r.blmove('a', 'b', 5)
-        assert r.blmove('a', 'b', 1, 'RIGHT', 'LEFT')
+        r.rpush("a", "one", "two", "three", "four")
+        assert r.blmove("a", "b", 5)
+        assert r.blmove("a", "b", 1, "RIGHT", "LEFT")
 
     @pytest.mark.onlynoncluster
     def test_mset(self, r):
-        d = {'a': b'1', 'b': b'2', 'c': b'3'}
+        d = {"a": b"1", "b": b"2", "c": b"3"}
         assert r.mset(d)
         for k, v in d.items():
             assert r[k] == v
 
     @pytest.mark.onlynoncluster
     def test_msetnx(self, r):
-        d = {'a': b'1', 'b': b'2', 'c': b'3'}
+        d = {"a": b"1", "b": b"2", "c": b"3"}
         assert r.msetnx(d)
-        d2 = {'a': b'x', 'd': b'4'}
+        d2 = {"a": b"x", "d": b"4"}
         assert not r.msetnx(d2)
         for k, v in d.items():
             assert r[k] == v
-        assert r.get('d') is None
+        assert r.get("d") is None
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_pexpire(self, r):
-        assert r.pexpire('a', 60000) is False
-        r['a'] = 'foo'
-        assert r.pexpire('a', 60000) is True
-        assert 0 < r.pttl('a') <= 60000
-        assert r.persist('a')
-        assert r.pttl('a') == -1
-
-    @skip_if_server_version_lt('2.6.0')
+        assert r.pexpire("a", 60000) is False
+        r["a"] = "foo"
+        assert r.pexpire("a", 60000) is True
+        assert 0 < r.pttl("a") <= 60000
+        assert r.persist("a")
+        assert r.pttl("a") == -1
+
+    @skip_if_server_version_lt("2.6.0")
     def test_pexpireat_datetime(self, r):
         expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
-        r['a'] = 'foo'
-        assert r.pexpireat('a', expire_at) is True
-        assert 0 < r.pttl('a') <= 61000
+        r["a"] = "foo"
+        assert r.pexpireat("a", expire_at) is True
+        assert 0 < r.pttl("a") <= 61000
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_pexpireat_no_key(self, r):
         expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
-        assert r.pexpireat('a', expire_at) is False
+        assert r.pexpireat("a", expire_at) is False
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_pexpireat_unixtime(self, r):
         expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
-        r['a'] = 'foo'
+        r["a"] = "foo"
         expire_at_seconds = int(time.mktime(expire_at.timetuple())) * 1000
-        assert r.pexpireat('a', expire_at_seconds) is True
-        assert 0 < r.pttl('a') <= 61000
+        assert r.pexpireat("a", expire_at_seconds) is True
+        assert 0 < r.pttl("a") <= 61000
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_psetex(self, r):
-        assert r.psetex('a', 1000, 'value')
-        assert r['a'] == b'value'
-        assert 0 < r.pttl('a') <= 1000
+        assert r.psetex("a", 1000, "value")
+        assert r["a"] == b"value"
+        assert 0 < r.pttl("a") <= 1000
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_psetex_timedelta(self, r):
         expire_at = datetime.timedelta(milliseconds=1000)
-        assert r.psetex('a', expire_at, 'value')
-        assert r['a'] == b'value'
-        assert 0 < r.pttl('a') <= 1000
+        assert r.psetex("a", expire_at, "value")
+        assert r["a"] == b"value"
+        assert 0 < r.pttl("a") <= 1000
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_pttl(self, r):
-        assert r.pexpire('a', 10000) is False
-        r['a'] = '1'
-        assert r.pexpire('a', 10000) is True
-        assert 0 < r.pttl('a') <= 10000
-        assert r.persist('a')
-        assert r.pttl('a') == -1
-
-    @skip_if_server_version_lt('2.8.0')
+        assert r.pexpire("a", 10000) is False
+        r["a"] = "1"
+        assert r.pexpire("a", 10000) is True
+        assert 0 < r.pttl("a") <= 10000
+        assert r.persist("a")
+        assert r.pttl("a") == -1
+
+    @skip_if_server_version_lt("2.8.0")
     def test_pttl_no_key(self, r):
         "PTTL on servers 2.8 and after return -2 when the key doesn't exist"
-        assert r.pttl('a') == -2
+        assert r.pttl("a") == -2
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_hrandfield(self, r):
-        assert r.hrandfield('key') is None
-        r.hset('key', mapping={'a': 1, 'b': 2, 'c': 3, 'd': 4, 'e': 5})
-        assert r.hrandfield('key') is not None
-        assert len(r.hrandfield('key', 2)) == 2
+        assert r.hrandfield("key") is None
+        r.hset("key", mapping={"a": 1, "b": 2, "c": 3, "d": 4, "e": 5})
+        assert r.hrandfield("key") is not None
+        assert len(r.hrandfield("key", 2)) == 2
         # with values
-        assert len(r.hrandfield('key', 2, True)) == 4
+        assert len(r.hrandfield("key", 2, True)) == 4
         # without duplications
-        assert len(r.hrandfield('key', 10)) == 5
+        assert len(r.hrandfield("key", 10)) == 5
         # with duplications
-        assert len(r.hrandfield('key', -10)) == 10
+        assert len(r.hrandfield("key", -10)) == 10
 
     @pytest.mark.onlynoncluster
     def test_randomkey(self, r):
         assert r.randomkey() is None
-        for key in ('a', 'b', 'c'):
+        for key in ("a", "b", "c"):
             r[key] = 1
-        assert r.randomkey() in (b'a', b'b', b'c')
+        assert r.randomkey() in (b"a", b"b", b"c")
 
     @pytest.mark.onlynoncluster
     def test_rename(self, r):
-        r['a'] = '1'
-        assert r.rename('a', 'b')
-        assert r.get('a') is None
-        assert r['b'] == b'1'
+        r["a"] = "1"
+        assert r.rename("a", "b")
+        assert r.get("a") is None
+        assert r["b"] == b"1"
 
     @pytest.mark.onlynoncluster
     def test_renamenx(self, r):
-        r['a'] = '1'
-        r['b'] = '2'
-        assert not r.renamenx('a', 'b')
-        assert r['a'] == b'1'
-        assert r['b'] == b'2'
+        r["a"] = "1"
+        r["b"] = "2"
+        assert not r.renamenx("a", "b")
+        assert r["a"] == b"1"
+        assert r["b"] == b"2"
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_set_nx(self, r):
-        assert r.set('a', '1', nx=True)
-        assert not r.set('a', '2', nx=True)
-        assert r['a'] == b'1'
+        assert r.set("a", "1", nx=True)
+        assert not r.set("a", "2", nx=True)
+        assert r["a"] == b"1"
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_set_xx(self, r):
-        assert not r.set('a', '1', xx=True)
-        assert r.get('a') is None
-        r['a'] = 'bar'
-        assert r.set('a', '2', xx=True)
-        assert r.get('a') == b'2'
+        assert not r.set("a", "1", xx=True)
+        assert r.get("a") is None
+        r["a"] = "bar"
+        assert r.set("a", "2", xx=True)
+        assert r.get("a") == b"2"
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_set_px(self, r):
-        assert r.set('a', '1', px=10000)
-        assert r['a'] == b'1'
-        assert 0 < r.pttl('a') <= 10000
-        assert 0 < r.ttl('a') <= 10
+        assert r.set("a", "1", px=10000)
+        assert r["a"] == b"1"
+        assert 0 < r.pttl("a") <= 10000
+        assert 0 < r.ttl("a") <= 10
         with pytest.raises(exceptions.DataError):
-            assert r.set('a', '1', px=10.0)
+            assert r.set("a", "1", px=10.0)
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_set_px_timedelta(self, r):
         expire_at = datetime.timedelta(milliseconds=1000)
-        assert r.set('a', '1', px=expire_at)
-        assert 0 < r.pttl('a') <= 1000
-        assert 0 < r.ttl('a') <= 1
+        assert r.set("a", "1", px=expire_at)
+        assert 0 < r.pttl("a") <= 1000
+        assert 0 < r.ttl("a") <= 1
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_set_ex(self, r):
-        assert r.set('a', '1', ex=10)
-        assert 0 < r.ttl('a') <= 10
+        assert r.set("a", "1", ex=10)
+        assert 0 < r.ttl("a") <= 10
         with pytest.raises(exceptions.DataError):
-            assert r.set('a', '1', ex=10.0)
+            assert r.set("a", "1", ex=10.0)
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_set_ex_timedelta(self, r):
         expire_at = datetime.timedelta(seconds=60)
-        assert r.set('a', '1', ex=expire_at)
-        assert 0 < r.ttl('a') <= 60
+        assert r.set("a", "1", ex=expire_at)
+        assert 0 < r.ttl("a") <= 60
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_set_exat_timedelta(self, r):
         expire_at = redis_server_time(r) + datetime.timedelta(seconds=10)
-        assert r.set('a', '1', exat=expire_at)
-        assert 0 < r.ttl('a') <= 10
+        assert r.set("a", "1", exat=expire_at)
+        assert 0 < r.ttl("a") <= 10
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_set_pxat_timedelta(self, r):
         expire_at = redis_server_time(r) + datetime.timedelta(seconds=50)
-        assert r.set('a', '1', pxat=expire_at)
-        assert 0 < r.ttl('a') <= 100
+        assert r.set("a", "1", pxat=expire_at)
+        assert 0 < r.ttl("a") <= 100
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_set_multipleoptions(self, r):
-        r['a'] = 'val'
-        assert r.set('a', '1', xx=True, px=10000)
-        assert 0 < r.ttl('a') <= 10
+        r["a"] = "val"
+        assert r.set("a", "1", xx=True, px=10000)
+        assert 0 < r.ttl("a") <= 10
 
     @skip_if_server_version_lt("6.0.0")
     def test_set_keepttl(self, r):
-        r['a'] = 'val'
-        assert r.set('a', '1', xx=True, px=10000)
-        assert 0 < r.ttl('a') <= 10
-        r.set('a', '2', keepttl=True)
-        assert r.get('a') == b'2'
-        assert 0 < r.ttl('a') <= 10
-
-    @skip_if_server_version_lt('6.2.0')
+        r["a"] = "val"
+        assert r.set("a", "1", xx=True, px=10000)
+        assert 0 < r.ttl("a") <= 10
+        r.set("a", "2", keepttl=True)
+        assert r.get("a") == b"2"
+        assert 0 < r.ttl("a") <= 10
+
+    @skip_if_server_version_lt("6.2.0")
     def test_set_get(self, r):
-        assert r.set('a', 'True', get=True) is None
-        assert r.set('a', 'True', get=True) == b'True'
-        assert r.set('a', 'foo') is True
-        assert r.set('a', 'bar', get=True) == b'foo'
-        assert r.get('a') == b'bar'
+        assert r.set("a", "True", get=True) is None
+        assert r.set("a", "True", get=True) == b"True"
+        assert r.set("a", "foo") is True
+        assert r.set("a", "bar", get=True) == b"foo"
+        assert r.get("a") == b"bar"
 
     def test_setex(self, r):
-        assert r.setex('a', 60, '1')
-        assert r['a'] == b'1'
-        assert 0 < r.ttl('a') <= 60
+        assert r.setex("a", 60, "1")
+        assert r["a"] == b"1"
+        assert 0 < r.ttl("a") <= 60
 
     def test_setnx(self, r):
-        assert r.setnx('a', '1')
-        assert r['a'] == b'1'
-        assert not r.setnx('a', '2')
-        assert r['a'] == b'1'
+        assert r.setnx("a", "1")
+        assert r["a"] == b"1"
+        assert not r.setnx("a", "2")
+        assert r["a"] == b"1"
 
     def test_setrange(self, r):
-        assert r.setrange('a', 5, 'foo') == 8
-        assert r['a'] == b'\0\0\0\0\0foo'
-        r['a'] = 'abcdefghijh'
-        assert r.setrange('a', 6, '12345') == 11
-        assert r['a'] == b'abcdef12345'
+        assert r.setrange("a", 5, "foo") == 8
+        assert r["a"] == b"\0\0\0\0\0foo"
+        r["a"] = "abcdefghijh"
+        assert r.setrange("a", 6, "12345") == 11
+        assert r["a"] == b"abcdef12345"
 
-    @skip_if_server_version_lt('6.0.0')
+    @skip_if_server_version_lt("6.0.0")
     def test_stralgo_lcs(self, r):
-        key1 = '{foo}key1'
-        key2 = '{foo}key2'
-        value1 = 'ohmytext'
-        value2 = 'mynewtext'
-        res = 'mytext'
+        key1 = "{foo}key1"
+        key2 = "{foo}key2"
+        value1 = "ohmytext"
+        value2 = "mynewtext"
+        res = "mytext"
 
         if skip_if_redis_enterprise(None).args[0] is True:
             with pytest.raises(redis.exceptions.ResponseError):
-                assert r.stralgo('LCS', value1, value2) == res
+                assert r.stralgo("LCS", value1, value2) == res
             return
 
         # test LCS of strings
-        assert r.stralgo('LCS', value1, value2) == res
+        assert r.stralgo("LCS", value1, value2) == res
         # test using keys
         r.mset({key1: value1, key2: value2})
-        assert r.stralgo('LCS', key1, key2, specific_argument="keys") == res
+        assert r.stralgo("LCS", key1, key2, specific_argument="keys") == res
         # test other labels
-        assert r.stralgo('LCS', value1, value2, len=True) == len(res)
-        assert r.stralgo('LCS', value1, value2, idx=True) == \
-               {
-                   'len': len(res),
-                   'matches': [[(4, 7), (5, 8)], [(2, 3), (0, 1)]]
-               }
-        assert r.stralgo('LCS', value1, value2,
-                         idx=True, withmatchlen=True) == \
-               {
-                   'len': len(res),
-                   'matches': [[4, (4, 7), (5, 8)], [2, (2, 3), (0, 1)]]
-               }
-        assert r.stralgo('LCS', value1, value2,
-                         idx=True, minmatchlen=4, withmatchlen=True) == \
-               {
-                   'len': len(res),
-                   'matches': [[4, (4, 7), (5, 8)]]
-               }
-
-    @skip_if_server_version_lt('6.0.0')
+        assert r.stralgo("LCS", value1, value2, len=True) == len(res)
+        assert r.stralgo("LCS", value1, value2, idx=True) == {
+            "len": len(res),
+            "matches": [[(4, 7), (5, 8)], [(2, 3), (0, 1)]],
+        }
+        assert r.stralgo("LCS", value1, value2, idx=True, withmatchlen=True) == {
+            "len": len(res),
+            "matches": [[4, (4, 7), (5, 8)], [2, (2, 3), (0, 1)]],
+        }
+        assert r.stralgo(
+            "LCS", value1, value2, idx=True, minmatchlen=4, withmatchlen=True
+        ) == {"len": len(res), "matches": [[4, (4, 7), (5, 8)]]}
+
+    @skip_if_server_version_lt("6.0.0")
     def test_stralgo_negative(self, r):
         with pytest.raises(exceptions.DataError):
-            r.stralgo('ISSUB', 'value1', 'value2')
+            r.stralgo("ISSUB", "value1", "value2")
         with pytest.raises(exceptions.DataError):
-            r.stralgo('LCS', 'value1', 'value2', len=True, idx=True)
+            r.stralgo("LCS", "value1", "value2", len=True, idx=True)
         with pytest.raises(exceptions.DataError):
-            r.stralgo('LCS', 'value1', 'value2', specific_argument="INT")
+            r.stralgo("LCS", "value1", "value2", specific_argument="INT")
         with pytest.raises(ValueError):
-            r.stralgo('LCS', 'value1', 'value2', idx=True, minmatchlen="one")
+            r.stralgo("LCS", "value1", "value2", idx=True, minmatchlen="one")
 
     def test_strlen(self, r):
-        r['a'] = 'foo'
-        assert r.strlen('a') == 3
+        r["a"] = "foo"
+        assert r.strlen("a") == 3
 
     def test_substr(self, r):
-        r['a'] = '0123456789'
+        r["a"] = "0123456789"
 
         if skip_if_redis_enterprise(None).args[0] is True:
             with pytest.raises(redis.exceptions.ResponseError):
-                assert r.substr('a', 0) == b'0123456789'
+                assert r.substr("a", 0) == b"0123456789"
             return
 
-        assert r.substr('a', 0) == b'0123456789'
-        assert r.substr('a', 2) == b'23456789'
-        assert r.substr('a', 3, 5) == b'345'
-        assert r.substr('a', 3, -2) == b'345678'
+        assert r.substr("a", 0) == b"0123456789"
+        assert r.substr("a", 2) == b"23456789"
+        assert r.substr("a", 3, 5) == b"345"
+        assert r.substr("a", 3, -2) == b"345678"
 
     def test_ttl(self, r):
-        r['a'] = '1'
-        assert r.expire('a', 10)
-        assert 0 < r.ttl('a') <= 10
-        assert r.persist('a')
-        assert r.ttl('a') == -1
+        r["a"] = "1"
+        assert r.expire("a", 10)
+        assert 0 < r.ttl("a") <= 10
+        assert r.persist("a")
+        assert r.ttl("a") == -1
 
-    @skip_if_server_version_lt('2.8.0')
+    @skip_if_server_version_lt("2.8.0")
     def test_ttl_nokey(self, r):
         "TTL on servers 2.8 and after return -2 when the key doesn't exist"
-        assert r.ttl('a') == -2
+        assert r.ttl("a") == -2
 
     def test_type(self, r):
-        assert r.type('a') == b'none'
-        r['a'] = '1'
-        assert r.type('a') == b'string'
-        del r['a']
-        r.lpush('a', '1')
-        assert r.type('a') == b'list'
-        del r['a']
-        r.sadd('a', '1')
-        assert r.type('a') == b'set'
-        del r['a']
-        r.zadd('a', {'1': 1})
-        assert r.type('a') == b'zset'
+        assert r.type("a") == b"none"
+        r["a"] = "1"
+        assert r.type("a") == b"string"
+        del r["a"]
+        r.lpush("a", "1")
+        assert r.type("a") == b"list"
+        del r["a"]
+        r.sadd("a", "1")
+        assert r.type("a") == b"set"
+        del r["a"]
+        r.zadd("a", {"1": 1})
+        assert r.type("a") == b"zset"
 
     # LIST COMMANDS
     @pytest.mark.onlynoncluster
     def test_blpop(self, r):
-        r.rpush('a', '1', '2')
-        r.rpush('b', '3', '4')
-        assert r.blpop(['b', 'a'], timeout=1) == (b'b', b'3')
-        assert r.blpop(['b', 'a'], timeout=1) == (b'b', b'4')
-        assert r.blpop(['b', 'a'], timeout=1) == (b'a', b'1')
-        assert r.blpop(['b', 'a'], timeout=1) == (b'a', b'2')
-        assert r.blpop(['b', 'a'], timeout=1) is None
-        r.rpush('c', '1')
-        assert r.blpop('c', timeout=1) == (b'c', b'1')
+        r.rpush("a", "1", "2")
+        r.rpush("b", "3", "4")
+        assert r.blpop(["b", "a"], timeout=1) == (b"b", b"3")
+        assert r.blpop(["b", "a"], timeout=1) == (b"b", b"4")
+        assert r.blpop(["b", "a"], timeout=1) == (b"a", b"1")
+        assert r.blpop(["b", "a"], timeout=1) == (b"a", b"2")
+        assert r.blpop(["b", "a"], timeout=1) is None
+        r.rpush("c", "1")
+        assert r.blpop("c", timeout=1) == (b"c", b"1")
 
     @pytest.mark.onlynoncluster
     def test_brpop(self, r):
-        r.rpush('a', '1', '2')
-        r.rpush('b', '3', '4')
-        assert r.brpop(['b', 'a'], timeout=1) == (b'b', b'4')
-        assert r.brpop(['b', 'a'], timeout=1) == (b'b', b'3')
-        assert r.brpop(['b', 'a'], timeout=1) == (b'a', b'2')
-        assert r.brpop(['b', 'a'], timeout=1) == (b'a', b'1')
-        assert r.brpop(['b', 'a'], timeout=1) is None
-        r.rpush('c', '1')
-        assert r.brpop('c', timeout=1) == (b'c', b'1')
+        r.rpush("a", "1", "2")
+        r.rpush("b", "3", "4")
+        assert r.brpop(["b", "a"], timeout=1) == (b"b", b"4")
+        assert r.brpop(["b", "a"], timeout=1) == (b"b", b"3")
+        assert r.brpop(["b", "a"], timeout=1) == (b"a", b"2")
+        assert r.brpop(["b", "a"], timeout=1) == (b"a", b"1")
+        assert r.brpop(["b", "a"], timeout=1) is None
+        r.rpush("c", "1")
+        assert r.brpop("c", timeout=1) == (b"c", b"1")
 
     @pytest.mark.onlynoncluster
     def test_brpoplpush(self, r):
-        r.rpush('a', '1', '2')
-        r.rpush('b', '3', '4')
-        assert r.brpoplpush('a', 'b') == b'2'
-        assert r.brpoplpush('a', 'b') == b'1'
-        assert r.brpoplpush('a', 'b', timeout=1) is None
-        assert r.lrange('a', 0, -1) == []
-        assert r.lrange('b', 0, -1) == [b'1', b'2', b'3', b'4']
+        r.rpush("a", "1", "2")
+        r.rpush("b", "3", "4")
+        assert r.brpoplpush("a", "b") == b"2"
+        assert r.brpoplpush("a", "b") == b"1"
+        assert r.brpoplpush("a", "b", timeout=1) is None
+        assert r.lrange("a", 0, -1) == []
+        assert r.lrange("b", 0, -1) == [b"1", b"2", b"3", b"4"]
 
     @pytest.mark.onlynoncluster
     def test_brpoplpush_empty_string(self, r):
-        r.rpush('a', '')
-        assert r.brpoplpush('a', 'b') == b''
+        r.rpush("a", "")
+        assert r.brpoplpush("a", "b") == b""
 
     def test_lindex(self, r):
-        r.rpush('a', '1', '2', '3')
-        assert r.lindex('a', '0') == b'1'
-        assert r.lindex('a', '1') == b'2'
-        assert r.lindex('a', '2') == b'3'
+        r.rpush("a", "1", "2", "3")
+        assert r.lindex("a", "0") == b"1"
+        assert r.lindex("a", "1") == b"2"
+        assert r.lindex("a", "2") == b"3"
 
     def test_linsert(self, r):
-        r.rpush('a', '1', '2', '3')
-        assert r.linsert('a', 'after', '2', '2.5') == 4
-        assert r.lrange('a', 0, -1) == [b'1', b'2', b'2.5', b'3']
-        assert r.linsert('a', 'before', '2', '1.5') == 5
-        assert r.lrange('a', 0, -1) == \
-               [b'1', b'1.5', b'2', b'2.5', b'3']
+        r.rpush("a", "1", "2", "3")
+        assert r.linsert("a", "after", "2", "2.5") == 4
+        assert r.lrange("a", 0, -1) == [b"1", b"2", b"2.5", b"3"]
+        assert r.linsert("a", "before", "2", "1.5") == 5
+        assert r.lrange("a", 0, -1) == [b"1", b"1.5", b"2", b"2.5", b"3"]
 
     def test_llen(self, r):
-        r.rpush('a', '1', '2', '3')
-        assert r.llen('a') == 3
+        r.rpush("a", "1", "2", "3")
+        assert r.llen("a") == 3
 
     def test_lpop(self, r):
-        r.rpush('a', '1', '2', '3')
-        assert r.lpop('a') == b'1'
-        assert r.lpop('a') == b'2'
-        assert r.lpop('a') == b'3'
-        assert r.lpop('a') is None
+        r.rpush("a", "1", "2", "3")
+        assert r.lpop("a") == b"1"
+        assert r.lpop("a") == b"2"
+        assert r.lpop("a") == b"3"
+        assert r.lpop("a") is None
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_lpop_count(self, r):
-        r.rpush('a', '1', '2', '3')
-        assert r.lpop('a', 2) == [b'1', b'2']
-        assert r.lpop('a', 1) == [b'3']
-        assert r.lpop('a') is None
-        assert r.lpop('a', 3) is None
+        r.rpush("a", "1", "2", "3")
+        assert r.lpop("a", 2) == [b"1", b"2"]
+        assert r.lpop("a", 1) == [b"3"]
+        assert r.lpop("a") is None
+        assert r.lpop("a", 3) is None
 
     def test_lpush(self, r):
-        assert r.lpush('a', '1') == 1
-        assert r.lpush('a', '2') == 2
-        assert r.lpush('a', '3', '4') == 4
-        assert r.lrange('a', 0, -1) == [b'4', b'3', b'2', b'1']
+        assert r.lpush("a", "1") == 1
+        assert r.lpush("a", "2") == 2
+        assert r.lpush("a", "3", "4") == 4
+        assert r.lrange("a", 0, -1) == [b"4", b"3", b"2", b"1"]
 
     def test_lpushx(self, r):
-        assert r.lpushx('a', '1') == 0
-        assert r.lrange('a', 0, -1) == []
-        r.rpush('a', '1', '2', '3')
-        assert r.lpushx('a', '4') == 4
-        assert r.lrange('a', 0, -1) == [b'4', b'1', b'2', b'3']
+        assert r.lpushx("a", "1") == 0
+        assert r.lrange("a", 0, -1) == []
+        r.rpush("a", "1", "2", "3")
+        assert r.lpushx("a", "4") == 4
+        assert r.lrange("a", 0, -1) == [b"4", b"1", b"2", b"3"]
 
-    @skip_if_server_version_lt('4.0.0')
+    @skip_if_server_version_lt("4.0.0")
     def test_lpushx_with_list(self, r):
         # now with a list
-        r.lpush('somekey', 'a')
-        r.lpush('somekey', 'b')
-        assert r.lpushx('somekey', 'foo', 'asdasd', 55, 'asdasdas') == 6
-        res = r.lrange('somekey', 0, -1)
-        assert res == [b'asdasdas', b'55', b'asdasd', b'foo', b'b', b'a']
+        r.lpush("somekey", "a")
+        r.lpush("somekey", "b")
+        assert r.lpushx("somekey", "foo", "asdasd", 55, "asdasdas") == 6
+        res = r.lrange("somekey", 0, -1)
+        assert res == [b"asdasdas", b"55", b"asdasd", b"foo", b"b", b"a"]
 
     def test_lrange(self, r):
-        r.rpush('a', '1', '2', '3', '4', '5')
-        assert r.lrange('a', 0, 2) == [b'1', b'2', b'3']
-        assert r.lrange('a', 2, 10) == [b'3', b'4', b'5']
-        assert r.lrange('a', 0, -1) == [b'1', b'2', b'3', b'4', b'5']
+        r.rpush("a", "1", "2", "3", "4", "5")
+        assert r.lrange("a", 0, 2) == [b"1", b"2", b"3"]
+        assert r.lrange("a", 2, 10) == [b"3", b"4", b"5"]
+        assert r.lrange("a", 0, -1) == [b"1", b"2", b"3", b"4", b"5"]
 
     def test_lrem(self, r):
-        r.rpush('a', 'Z', 'b', 'Z', 'Z', 'c', 'Z', 'Z')
+        r.rpush("a", "Z", "b", "Z", "Z", "c", "Z", "Z")
         # remove the first 'Z'  item
-        assert r.lrem('a', 1, 'Z') == 1
-        assert r.lrange('a', 0, -1) == [b'b', b'Z', b'Z', b'c', b'Z', b'Z']
+        assert r.lrem("a", 1, "Z") == 1
+        assert r.lrange("a", 0, -1) == [b"b", b"Z", b"Z", b"c", b"Z", b"Z"]
         # remove the last 2 'Z' items
-        assert r.lrem('a', -2, 'Z') == 2
-        assert r.lrange('a', 0, -1) == [b'b', b'Z', b'Z', b'c']
+        assert r.lrem("a", -2, "Z") == 2
+        assert r.lrange("a", 0, -1) == [b"b", b"Z", b"Z", b"c"]
         # remove all 'Z' items
-        assert r.lrem('a', 0, 'Z') == 2
-        assert r.lrange('a', 0, -1) == [b'b', b'c']
+        assert r.lrem("a", 0, "Z") == 2
+        assert r.lrange("a", 0, -1) == [b"b", b"c"]
 
     def test_lset(self, r):
-        r.rpush('a', '1', '2', '3')
-        assert r.lrange('a', 0, -1) == [b'1', b'2', b'3']
-        assert r.lset('a', 1, '4')
-        assert r.lrange('a', 0, 2) == [b'1', b'4', b'3']
+        r.rpush("a", "1", "2", "3")
+        assert r.lrange("a", 0, -1) == [b"1", b"2", b"3"]
+        assert r.lset("a", 1, "4")
+        assert r.lrange("a", 0, 2) == [b"1", b"4", b"3"]
 
     def test_ltrim(self, r):
-        r.rpush('a', '1', '2', '3')
-        assert r.ltrim('a', 0, 1)
-        assert r.lrange('a', 0, -1) == [b'1', b'2']
+        r.rpush("a", "1", "2", "3")
+        assert r.ltrim("a", 0, 1)
+        assert r.lrange("a", 0, -1) == [b"1", b"2"]
 
     def test_rpop(self, r):
-        r.rpush('a', '1', '2', '3')
-        assert r.rpop('a') == b'3'
-        assert r.rpop('a') == b'2'
-        assert r.rpop('a') == b'1'
-        assert r.rpop('a') is None
+        r.rpush("a", "1", "2", "3")
+        assert r.rpop("a") == b"3"
+        assert r.rpop("a") == b"2"
+        assert r.rpop("a") == b"1"
+        assert r.rpop("a") is None
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_rpop_count(self, r):
-        r.rpush('a', '1', '2', '3')
-        assert r.rpop('a', 2) == [b'3', b'2']
-        assert r.rpop('a', 1) == [b'1']
-        assert r.rpop('a') is None
-        assert r.rpop('a', 3) is None
+        r.rpush("a", "1", "2", "3")
+        assert r.rpop("a", 2) == [b"3", b"2"]
+        assert r.rpop("a", 1) == [b"1"]
+        assert r.rpop("a") is None
+        assert r.rpop("a", 3) is None
 
     @pytest.mark.onlynoncluster
     def test_rpoplpush(self, r):
-        r.rpush('a', 'a1', 'a2', 'a3')
-        r.rpush('b', 'b1', 'b2', 'b3')
-        assert r.rpoplpush('a', 'b') == b'a3'
-        assert r.lrange('a', 0, -1) == [b'a1', b'a2']
-        assert r.lrange('b', 0, -1) == [b'a3', b'b1', b'b2', b'b3']
+        r.rpush("a", "a1", "a2", "a3")
+        r.rpush("b", "b1", "b2", "b3")
+        assert r.rpoplpush("a", "b") == b"a3"
+        assert r.lrange("a", 0, -1) == [b"a1", b"a2"]
+        assert r.lrange("b", 0, -1) == [b"a3", b"b1", b"b2", b"b3"]
 
     def test_rpush(self, r):
-        assert r.rpush('a', '1') == 1
-        assert r.rpush('a', '2') == 2
-        assert r.rpush('a', '3', '4') == 4
-        assert r.lrange('a', 0, -1) == [b'1', b'2', b'3', b'4']
+        assert r.rpush("a", "1") == 1
+        assert r.rpush("a", "2") == 2
+        assert r.rpush("a", "3", "4") == 4
+        assert r.lrange("a", 0, -1) == [b"1", b"2", b"3", b"4"]
 
-    @skip_if_server_version_lt('6.0.6')
+    @skip_if_server_version_lt("6.0.6")
     def test_lpos(self, r):
-        assert r.rpush('a', 'a', 'b', 'c', '1', '2', '3', 'c', 'c') == 8
-        assert r.lpos('a', 'a') == 0
-        assert r.lpos('a', 'c') == 2
+        assert r.rpush("a", "a", "b", "c", "1", "2", "3", "c", "c") == 8
+        assert r.lpos("a", "a") == 0
+        assert r.lpos("a", "c") == 2
 
-        assert r.lpos('a', 'c', rank=1) == 2
-        assert r.lpos('a', 'c', rank=2) == 6
-        assert r.lpos('a', 'c', rank=4) is None
-        assert r.lpos('a', 'c', rank=-1) == 7
-        assert r.lpos('a', 'c', rank=-2) == 6
+        assert r.lpos("a", "c", rank=1) == 2
+        assert r.lpos("a", "c", rank=2) == 6
+        assert r.lpos("a", "c", rank=4) is None
+        assert r.lpos("a", "c", rank=-1) == 7
+        assert r.lpos("a", "c", rank=-2) == 6
 
-        assert r.lpos('a', 'c', count=0) == [2, 6, 7]
-        assert r.lpos('a', 'c', count=1) == [2]
-        assert r.lpos('a', 'c', count=2) == [2, 6]
-        assert r.lpos('a', 'c', count=100) == [2, 6, 7]
+        assert r.lpos("a", "c", count=0) == [2, 6, 7]
+        assert r.lpos("a", "c", count=1) == [2]
+        assert r.lpos("a", "c", count=2) == [2, 6]
+        assert r.lpos("a", "c", count=100) == [2, 6, 7]
 
-        assert r.lpos('a', 'c', count=0, rank=2) == [6, 7]
-        assert r.lpos('a', 'c', count=2, rank=-1) == [7, 6]
+        assert r.lpos("a", "c", count=0, rank=2) == [6, 7]
+        assert r.lpos("a", "c", count=2, rank=-1) == [7, 6]
 
-        assert r.lpos('axxx', 'c', count=0, rank=2) == []
-        assert r.lpos('axxx', 'c') is None
+        assert r.lpos("axxx", "c", count=0, rank=2) == []
+        assert r.lpos("axxx", "c") is None
 
-        assert r.lpos('a', 'x', count=2) == []
-        assert r.lpos('a', 'x') is None
+        assert r.lpos("a", "x", count=2) == []
+        assert r.lpos("a", "x") is None
 
-        assert r.lpos('a', 'a', count=0, maxlen=1) == [0]
-        assert r.lpos('a', 'c', count=0, maxlen=1) == []
-        assert r.lpos('a', 'c', count=0, maxlen=3) == [2]
-        assert r.lpos('a', 'c', count=0, maxlen=3, rank=-1) == [7, 6]
-        assert r.lpos('a', 'c', count=0, maxlen=7, rank=2) == [6]
+        assert r.lpos("a", "a", count=0, maxlen=1) == [0]
+        assert r.lpos("a", "c", count=0, maxlen=1) == []
+        assert r.lpos("a", "c", count=0, maxlen=3) == [2]
+        assert r.lpos("a", "c", count=0, maxlen=3, rank=-1) == [7, 6]
+        assert r.lpos("a", "c", count=0, maxlen=7, rank=2) == [6]
 
     def test_rpushx(self, r):
-        assert r.rpushx('a', 'b') == 0
-        assert r.lrange('a', 0, -1) == []
-        r.rpush('a', '1', '2', '3')
-        assert r.rpushx('a', '4') == 4
-        assert r.lrange('a', 0, -1) == [b'1', b'2', b'3', b'4']
+        assert r.rpushx("a", "b") == 0
+        assert r.lrange("a", 0, -1) == []
+        r.rpush("a", "1", "2", "3")
+        assert r.rpushx("a", "4") == 4
+        assert r.lrange("a", 0, -1) == [b"1", b"2", b"3", b"4"]
 
     # SCAN COMMANDS
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.8.0')
+    @skip_if_server_version_lt("2.8.0")
     def test_scan(self, r):
-        r.set('a', 1)
-        r.set('b', 2)
-        r.set('c', 3)
+        r.set("a", 1)
+        r.set("b", 2)
+        r.set("c", 3)
         cursor, keys = r.scan()
         assert cursor == 0
-        assert set(keys) == {b'a', b'b', b'c'}
-        _, keys = r.scan(match='a')
-        assert set(keys) == {b'a'}
+        assert set(keys) == {b"a", b"b", b"c"}
+        _, keys = r.scan(match="a")
+        assert set(keys) == {b"a"}
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     def test_scan_type(self, r):
-        r.sadd('a-set', 1)
-        r.hset('a-hash', 'foo', 2)
-        r.lpush('a-list', 'aux', 3)
-        _, keys = r.scan(match='a*', _type='SET')
-        assert set(keys) == {b'a-set'}
+        r.sadd("a-set", 1)
+        r.hset("a-hash", "foo", 2)
+        r.lpush("a-list", "aux", 3)
+        _, keys = r.scan(match="a*", _type="SET")
+        assert set(keys) == {b"a-set"}
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.8.0')
+    @skip_if_server_version_lt("2.8.0")
     def test_scan_iter(self, r):
-        r.set('a', 1)
-        r.set('b', 2)
-        r.set('c', 3)
+        r.set("a", 1)
+        r.set("b", 2)
+        r.set("c", 3)
         keys = list(r.scan_iter())
-        assert set(keys) == {b'a', b'b', b'c'}
-        keys = list(r.scan_iter(match='a'))
-        assert set(keys) == {b'a'}
+        assert set(keys) == {b"a", b"b", b"c"}
+        keys = list(r.scan_iter(match="a"))
+        assert set(keys) == {b"a"}
 
-    @skip_if_server_version_lt('2.8.0')
+    @skip_if_server_version_lt("2.8.0")
     def test_sscan(self, r):
-        r.sadd('a', 1, 2, 3)
-        cursor, members = r.sscan('a')
+        r.sadd("a", 1, 2, 3)
+        cursor, members = r.sscan("a")
         assert cursor == 0
-        assert set(members) == {b'1', b'2', b'3'}
-        _, members = r.sscan('a', match=b'1')
-        assert set(members) == {b'1'}
+        assert set(members) == {b"1", b"2", b"3"}
+        _, members = r.sscan("a", match=b"1")
+        assert set(members) == {b"1"}
 
-    @skip_if_server_version_lt('2.8.0')
+    @skip_if_server_version_lt("2.8.0")
     def test_sscan_iter(self, r):
-        r.sadd('a', 1, 2, 3)
-        members = list(r.sscan_iter('a'))
-        assert set(members) == {b'1', b'2', b'3'}
-        members = list(r.sscan_iter('a', match=b'1'))
-        assert set(members) == {b'1'}
+        r.sadd("a", 1, 2, 3)
+        members = list(r.sscan_iter("a"))
+        assert set(members) == {b"1", b"2", b"3"}
+        members = list(r.sscan_iter("a", match=b"1"))
+        assert set(members) == {b"1"}
 
-    @skip_if_server_version_lt('2.8.0')
+    @skip_if_server_version_lt("2.8.0")
     def test_hscan(self, r):
-        r.hset('a', mapping={'a': 1, 'b': 2, 'c': 3})
-        cursor, dic = r.hscan('a')
+        r.hset("a", mapping={"a": 1, "b": 2, "c": 3})
+        cursor, dic = r.hscan("a")
         assert cursor == 0
-        assert dic == {b'a': b'1', b'b': b'2', b'c': b'3'}
-        _, dic = r.hscan('a', match='a')
-        assert dic == {b'a': b'1'}
+        assert dic == {b"a": b"1", b"b": b"2", b"c": b"3"}
+        _, dic = r.hscan("a", match="a")
+        assert dic == {b"a": b"1"}
 
-    @skip_if_server_version_lt('2.8.0')
+    @skip_if_server_version_lt("2.8.0")
     def test_hscan_iter(self, r):
-        r.hset('a', mapping={'a': 1, 'b': 2, 'c': 3})
-        dic = dict(r.hscan_iter('a'))
-        assert dic == {b'a': b'1', b'b': b'2', b'c': b'3'}
-        dic = dict(r.hscan_iter('a', match='a'))
-        assert dic == {b'a': b'1'}
+        r.hset("a", mapping={"a": 1, "b": 2, "c": 3})
+        dic = dict(r.hscan_iter("a"))
+        assert dic == {b"a": b"1", b"b": b"2", b"c": b"3"}
+        dic = dict(r.hscan_iter("a", match="a"))
+        assert dic == {b"a": b"1"}
 
-    @skip_if_server_version_lt('2.8.0')
+    @skip_if_server_version_lt("2.8.0")
     def test_zscan(self, r):
-        r.zadd('a', {'a': 1, 'b': 2, 'c': 3})
-        cursor, pairs = r.zscan('a')
+        r.zadd("a", {"a": 1, "b": 2, "c": 3})
+        cursor, pairs = r.zscan("a")
         assert cursor == 0
-        assert set(pairs) == {(b'a', 1), (b'b', 2), (b'c', 3)}
-        _, pairs = r.zscan('a', match='a')
-        assert set(pairs) == {(b'a', 1)}
+        assert set(pairs) == {(b"a", 1), (b"b", 2), (b"c", 3)}
+        _, pairs = r.zscan("a", match="a")
+        assert set(pairs) == {(b"a", 1)}
 
-    @skip_if_server_version_lt('2.8.0')
+    @skip_if_server_version_lt("2.8.0")
     def test_zscan_iter(self, r):
-        r.zadd('a', {'a': 1, 'b': 2, 'c': 3})
-        pairs = list(r.zscan_iter('a'))
-        assert set(pairs) == {(b'a', 1), (b'b', 2), (b'c', 3)}
-        pairs = list(r.zscan_iter('a', match='a'))
-        assert set(pairs) == {(b'a', 1)}
+        r.zadd("a", {"a": 1, "b": 2, "c": 3})
+        pairs = list(r.zscan_iter("a"))
+        assert set(pairs) == {(b"a", 1), (b"b", 2), (b"c", 3)}
+        pairs = list(r.zscan_iter("a", match="a"))
+        assert set(pairs) == {(b"a", 1)}
 
     # SET COMMANDS
     def test_sadd(self, r):
-        members = {b'1', b'2', b'3'}
-        r.sadd('a', *members)
-        assert r.smembers('a') == members
+        members = {b"1", b"2", b"3"}
+        r.sadd("a", *members)
+        assert r.smembers("a") == members
 
     def test_scard(self, r):
-        r.sadd('a', '1', '2', '3')
-        assert r.scard('a') == 3
+        r.sadd("a", "1", "2", "3")
+        assert r.scard("a") == 3
 
     @pytest.mark.onlynoncluster
     def test_sdiff(self, r):
-        r.sadd('a', '1', '2', '3')
-        assert r.sdiff('a', 'b') == {b'1', b'2', b'3'}
-        r.sadd('b', '2', '3')
-        assert r.sdiff('a', 'b') == {b'1'}
+        r.sadd("a", "1", "2", "3")
+        assert r.sdiff("a", "b") == {b"1", b"2", b"3"}
+        r.sadd("b", "2", "3")
+        assert r.sdiff("a", "b") == {b"1"}
 
     @pytest.mark.onlynoncluster
     def test_sdiffstore(self, r):
-        r.sadd('a', '1', '2', '3')
-        assert r.sdiffstore('c', 'a', 'b') == 3
-        assert r.smembers('c') == {b'1', b'2', b'3'}
-        r.sadd('b', '2', '3')
-        assert r.sdiffstore('c', 'a', 'b') == 1
-        assert r.smembers('c') == {b'1'}
+        r.sadd("a", "1", "2", "3")
+        assert r.sdiffstore("c", "a", "b") == 3
+        assert r.smembers("c") == {b"1", b"2", b"3"}
+        r.sadd("b", "2", "3")
+        assert r.sdiffstore("c", "a", "b") == 1
+        assert r.smembers("c") == {b"1"}
 
     @pytest.mark.onlynoncluster
     def test_sinter(self, r):
-        r.sadd('a', '1', '2', '3')
-        assert r.sinter('a', 'b') == set()
-        r.sadd('b', '2', '3')
-        assert r.sinter('a', 'b') == {b'2', b'3'}
+        r.sadd("a", "1", "2", "3")
+        assert r.sinter("a", "b") == set()
+        r.sadd("b", "2", "3")
+        assert r.sinter("a", "b") == {b"2", b"3"}
 
     @pytest.mark.onlynoncluster
     def test_sinterstore(self, r):
-        r.sadd('a', '1', '2', '3')
-        assert r.sinterstore('c', 'a', 'b') == 0
-        assert r.smembers('c') == set()
-        r.sadd('b', '2', '3')
-        assert r.sinterstore('c', 'a', 'b') == 2
-        assert r.smembers('c') == {b'2', b'3'}
+        r.sadd("a", "1", "2", "3")
+        assert r.sinterstore("c", "a", "b") == 0
+        assert r.smembers("c") == set()
+        r.sadd("b", "2", "3")
+        assert r.sinterstore("c", "a", "b") == 2
+        assert r.smembers("c") == {b"2", b"3"}
 
     def test_sismember(self, r):
-        r.sadd('a', '1', '2', '3')
-        assert r.sismember('a', '1')
-        assert r.sismember('a', '2')
-        assert r.sismember('a', '3')
-        assert not r.sismember('a', '4')
+        r.sadd("a", "1", "2", "3")
+        assert r.sismember("a", "1")
+        assert r.sismember("a", "2")
+        assert r.sismember("a", "3")
+        assert not r.sismember("a", "4")
 
     def test_smembers(self, r):
-        r.sadd('a', '1', '2', '3')
-        assert r.smembers('a') == {b'1', b'2', b'3'}
+        r.sadd("a", "1", "2", "3")
+        assert r.smembers("a") == {b"1", b"2", b"3"}
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_smismember(self, r):
-        r.sadd('a', '1', '2', '3')
+        r.sadd("a", "1", "2", "3")
         result_list = [True, False, True, True]
-        assert r.smismember('a', '1', '4', '2', '3') == result_list
-        assert r.smismember('a', ['1', '4', '2', '3']) == result_list
+        assert r.smismember("a", "1", "4", "2", "3") == result_list
+        assert r.smismember("a", ["1", "4", "2", "3"]) == result_list
 
     @pytest.mark.onlynoncluster
     def test_smove(self, r):
-        r.sadd('a', 'a1', 'a2')
-        r.sadd('b', 'b1', 'b2')
-        assert r.smove('a', 'b', 'a1')
-        assert r.smembers('a') == {b'a2'}
-        assert r.smembers('b') == {b'b1', b'b2', b'a1'}
+        r.sadd("a", "a1", "a2")
+        r.sadd("b", "b1", "b2")
+        assert r.smove("a", "b", "a1")
+        assert r.smembers("a") == {b"a2"}
+        assert r.smembers("b") == {b"b1", b"b2", b"a1"}
 
     def test_spop(self, r):
-        s = [b'1', b'2', b'3']
-        r.sadd('a', *s)
-        value = r.spop('a')
+        s = [b"1", b"2", b"3"]
+        r.sadd("a", *s)
+        value = r.spop("a")
         assert value in s
-        assert r.smembers('a') == set(s) - {value}
+        assert r.smembers("a") == set(s) - {value}
 
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt("3.2.0")
     def test_spop_multi_value(self, r):
-        s = [b'1', b'2', b'3']
-        r.sadd('a', *s)
-        values = r.spop('a', 2)
+        s = [b"1", b"2", b"3"]
+        r.sadd("a", *s)
+        values = r.spop("a", 2)
         assert len(values) == 2
 
         for value in values:
             assert value in s
 
-        assert r.spop('a', 1) == list(set(s) - set(values))
+        assert r.spop("a", 1) == list(set(s) - set(values))
 
     def test_srandmember(self, r):
-        s = [b'1', b'2', b'3']
-        r.sadd('a', *s)
-        assert r.srandmember('a') in s
+        s = [b"1", b"2", b"3"]
+        r.sadd("a", *s)
+        assert r.srandmember("a") in s
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_srandmember_multi_value(self, r):
-        s = [b'1', b'2', b'3']
-        r.sadd('a', *s)
-        randoms = r.srandmember('a', number=2)
+        s = [b"1", b"2", b"3"]
+        r.sadd("a", *s)
+        randoms = r.srandmember("a", number=2)
         assert len(randoms) == 2
         assert set(randoms).intersection(s) == set(randoms)
 
     def test_srem(self, r):
-        r.sadd('a', '1', '2', '3', '4')
-        assert r.srem('a', '5') == 0
-        assert r.srem('a', '2', '4') == 2
-        assert r.smembers('a') == {b'1', b'3'}
+        r.sadd("a", "1", "2", "3", "4")
+        assert r.srem("a", "5") == 0
+        assert r.srem("a", "2", "4") == 2
+        assert r.smembers("a") == {b"1", b"3"}
 
     @pytest.mark.onlynoncluster
     def test_sunion(self, r):
-        r.sadd('a', '1', '2')
-        r.sadd('b', '2', '3')
-        assert r.sunion('a', 'b') == {b'1', b'2', b'3'}
+        r.sadd("a", "1", "2")
+        r.sadd("b", "2", "3")
+        assert r.sunion("a", "b") == {b"1", b"2", b"3"}
 
     @pytest.mark.onlynoncluster
     def test_sunionstore(self, r):
-        r.sadd('a', '1', '2')
-        r.sadd('b', '2', '3')
-        assert r.sunionstore('c', 'a', 'b') == 3
-        assert r.smembers('c') == {b'1', b'2', b'3'}
+        r.sadd("a", "1", "2")
+        r.sadd("b", "2", "3")
+        assert r.sunionstore("c", "a", "b") == 3
+        assert r.smembers("c") == {b"1", b"2", b"3"}
 
-    @skip_if_server_version_lt('1.0.0')
+    @skip_if_server_version_lt("1.0.0")
     def test_debug_segfault(self, r):
         with pytest.raises(NotImplementedError):
             r.debug_segfault()
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt("3.2.0")
     def test_script_debug(self, r):
         with pytest.raises(NotImplementedError):
             r.script_debug()
 
     # SORTED SET COMMANDS
     def test_zadd(self, r):
-        mapping = {'a1': 1.0, 'a2': 2.0, 'a3': 3.0}
-        r.zadd('a', mapping)
-        assert r.zrange('a', 0, -1, withscores=True) == \
-               [(b'a1', 1.0), (b'a2', 2.0), (b'a3', 3.0)]
+        mapping = {"a1": 1.0, "a2": 2.0, "a3": 3.0}
+        r.zadd("a", mapping)
+        assert r.zrange("a", 0, -1, withscores=True) == [
+            (b"a1", 1.0),
+            (b"a2", 2.0),
+            (b"a3", 3.0),
+        ]
 
         # error cases
         with pytest.raises(exceptions.DataError):
-            r.zadd('a', {})
+            r.zadd("a", {})
 
         # cannot use both nx and xx options
         with pytest.raises(exceptions.DataError):
-            r.zadd('a', mapping, nx=True, xx=True)
+            r.zadd("a", mapping, nx=True, xx=True)
 
         # cannot use the incr options with more than one value
         with pytest.raises(exceptions.DataError):
-            r.zadd('a', mapping, incr=True)
+            r.zadd("a", mapping, incr=True)
 
     def test_zadd_nx(self, r):
-        assert r.zadd('a', {'a1': 1}) == 1
-        assert r.zadd('a', {'a1': 99, 'a2': 2}, nx=True) == 1
-        assert r.zrange('a', 0, -1, withscores=True) == \
-               [(b'a1', 1.0), (b'a2', 2.0)]
+        assert r.zadd("a", {"a1": 1}) == 1
+        assert r.zadd("a", {"a1": 99, "a2": 2}, nx=True) == 1
+        assert r.zrange("a", 0, -1, withscores=True) == [(b"a1", 1.0), (b"a2", 2.0)]
 
     def test_zadd_xx(self, r):
-        assert r.zadd('a', {'a1': 1}) == 1
-        assert r.zadd('a', {'a1': 99, 'a2': 2}, xx=True) == 0
-        assert r.zrange('a', 0, -1, withscores=True) == \
-               [(b'a1', 99.0)]
+        assert r.zadd("a", {"a1": 1}) == 1
+        assert r.zadd("a", {"a1": 99, "a2": 2}, xx=True) == 0
+        assert r.zrange("a", 0, -1, withscores=True) == [(b"a1", 99.0)]
 
     def test_zadd_ch(self, r):
-        assert r.zadd('a', {'a1': 1}) == 1
-        assert r.zadd('a', {'a1': 99, 'a2': 2}, ch=True) == 2
-        assert r.zrange('a', 0, -1, withscores=True) == \
-               [(b'a2', 2.0), (b'a1', 99.0)]
+        assert r.zadd("a", {"a1": 1}) == 1
+        assert r.zadd("a", {"a1": 99, "a2": 2}, ch=True) == 2
+        assert r.zrange("a", 0, -1, withscores=True) == [(b"a2", 2.0), (b"a1", 99.0)]
 
     def test_zadd_incr(self, r):
-        assert r.zadd('a', {'a1': 1}) == 1
-        assert r.zadd('a', {'a1': 4.5}, incr=True) == 5.5
+        assert r.zadd("a", {"a1": 1}) == 1
+        assert r.zadd("a", {"a1": 4.5}, incr=True) == 5.5
 
     def test_zadd_incr_with_xx(self, r):
         # this asks zadd to incr 'a1' only if it exists, but it clearly
         # doesn't. Redis returns a null value in this case and so should
         # redis-py
-        assert r.zadd('a', {'a1': 1}, xx=True, incr=True) is None
+        assert r.zadd("a", {"a1": 1}, xx=True, incr=True) is None
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_zadd_gt_lt(self, r):
 
         for i in range(1, 20):
-            r.zadd('a', {f'a{i}': i})
-        assert r.zadd('a', {'a20': 5}, gt=3) == 1
+            r.zadd("a", {f"a{i}": i})
+        assert r.zadd("a", {"a20": 5}, gt=3) == 1
 
         for i in range(1, 20):
-            r.zadd('a', {f'a{i}': i})
-        assert r.zadd('a', {'a2': 5}, lt=1) == 0
+            r.zadd("a", {f"a{i}": i})
+        assert r.zadd("a", {"a2": 5}, lt=1) == 0
 
         # cannot use both nx and xx options
         with pytest.raises(exceptions.DataError):
-            r.zadd('a', {'a15': 155}, nx=True, lt=True)
-            r.zadd('a', {'a15': 155}, nx=True, gt=True)
-            r.zadd('a', {'a15': 155}, lt=True, gt=True)
+            r.zadd("a", {"a15": 155}, nx=True, lt=True)
+            r.zadd("a", {"a15": 155}, nx=True, gt=True)
+            r.zadd("a", {"a15": 155}, lt=True, gt=True)
 
     def test_zcard(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
-        assert r.zcard('a') == 3
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        assert r.zcard("a") == 3
 
     def test_zcount(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
-        assert r.zcount('a', '-inf', '+inf') == 3
-        assert r.zcount('a', 1, 2) == 2
-        assert r.zcount('a', '(' + str(1), 2) == 1
-        assert r.zcount('a', 1, '(' + str(2)) == 1
-        assert r.zcount('a', 10, 20) == 0
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        assert r.zcount("a", "-inf", "+inf") == 3
+        assert r.zcount("a", 1, 2) == 2
+        assert r.zcount("a", "(" + str(1), 2) == 1
+        assert r.zcount("a", 1, "(" + str(2)) == 1
+        assert r.zcount("a", 10, 20) == 0
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_zdiff(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
-        r.zadd('b', {'a1': 1, 'a2': 2})
-        assert r.zdiff(['a', 'b']) == [b'a3']
-        assert r.zdiff(['a', 'b'], withscores=True) == [b'a3', b'3']
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        r.zadd("b", {"a1": 1, "a2": 2})
+        assert r.zdiff(["a", "b"]) == [b"a3"]
+        assert r.zdiff(["a", "b"], withscores=True) == [b"a3", b"3"]
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_zdiffstore(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
-        r.zadd('b', {'a1': 1, 'a2': 2})
-        assert r.zdiffstore("out", ['a', 'b'])
-        assert r.zrange("out", 0, -1) == [b'a3']
-        assert r.zrange("out", 0, -1, withscores=True) == [(b'a3', 3.0)]
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        r.zadd("b", {"a1": 1, "a2": 2})
+        assert r.zdiffstore("out", ["a", "b"])
+        assert r.zrange("out", 0, -1) == [b"a3"]
+        assert r.zrange("out", 0, -1, withscores=True) == [(b"a3", 3.0)]
 
     def test_zincrby(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
-        assert r.zincrby('a', 1, 'a2') == 3.0
-        assert r.zincrby('a', 5, 'a3') == 8.0
-        assert r.zscore('a', 'a2') == 3.0
-        assert r.zscore('a', 'a3') == 8.0
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        assert r.zincrby("a", 1, "a2") == 3.0
+        assert r.zincrby("a", 5, "a3") == 8.0
+        assert r.zscore("a", "a2") == 3.0
+        assert r.zscore("a", "a3") == 8.0
 
-    @skip_if_server_version_lt('2.8.9')
+    @skip_if_server_version_lt("2.8.9")
     def test_zlexcount(self, r):
-        r.zadd('a', {'a': 0, 'b': 0, 'c': 0, 'd': 0, 'e': 0, 'f': 0, 'g': 0})
-        assert r.zlexcount('a', '-', '+') == 7
-        assert r.zlexcount('a', '[b', '[f') == 5
+        r.zadd("a", {"a": 0, "b": 0, "c": 0, "d": 0, "e": 0, "f": 0, "g": 0})
+        assert r.zlexcount("a", "-", "+") == 7
+        assert r.zlexcount("a", "[b", "[f") == 5
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_zinter(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 1})
-        r.zadd('b', {'a1': 2, 'a2': 2, 'a3': 2})
-        r.zadd('c', {'a1': 6, 'a3': 5, 'a4': 4})
-        assert r.zinter(['a', 'b', 'c']) == [b'a3', b'a1']
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 1})
+        r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
+        r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
+        assert r.zinter(["a", "b", "c"]) == [b"a3", b"a1"]
         # invalid aggregation
         with pytest.raises(exceptions.DataError):
-            r.zinter(['a', 'b', 'c'], aggregate='foo', withscores=True)
+            r.zinter(["a", "b", "c"], aggregate="foo", withscores=True)
         # aggregate with SUM
-        assert r.zinter(['a', 'b', 'c'], withscores=True) \
-               == [(b'a3', 8), (b'a1', 9)]
+        assert r.zinter(["a", "b", "c"], withscores=True) == [(b"a3", 8), (b"a1", 9)]
         # aggregate with MAX
-        assert r.zinter(['a', 'b', 'c'], aggregate='MAX', withscores=True) \
-               == [(b'a3', 5), (b'a1', 6)]
+        assert r.zinter(["a", "b", "c"], aggregate="MAX", withscores=True) == [
+            (b"a3", 5),
+            (b"a1", 6),
+        ]
         # aggregate with MIN
-        assert r.zinter(['a', 'b', 'c'], aggregate='MIN', withscores=True) \
-               == [(b'a1', 1), (b'a3', 1)]
+        assert r.zinter(["a", "b", "c"], aggregate="MIN", withscores=True) == [
+            (b"a1", 1),
+            (b"a3", 1),
+        ]
         # with weights
-        assert r.zinter({'a': 1, 'b': 2, 'c': 3}, withscores=True) \
-               == [(b'a3', 20), (b'a1', 23)]
+        assert r.zinter({"a": 1, "b": 2, "c": 3}, withscores=True) == [
+            (b"a3", 20),
+            (b"a1", 23),
+        ]
 
     @pytest.mark.onlynoncluster
     def test_zinterstore_sum(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 1, 'a3': 1})
-        r.zadd('b', {'a1': 2, 'a2': 2, 'a3': 2})
-        r.zadd('c', {'a1': 6, 'a3': 5, 'a4': 4})
-        assert r.zinterstore('d', ['a', 'b', 'c']) == 2
-        assert r.zrange('d', 0, -1, withscores=True) == \
-               [(b'a3', 8), (b'a1', 9)]
+        r.zadd("a", {"a1": 1, "a2": 1, "a3": 1})
+        r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
+        r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
+        assert r.zinterstore("d", ["a", "b", "c"]) == 2
+        assert r.zrange("d", 0, -1, withscores=True) == [(b"a3", 8), (b"a1", 9)]
 
     @pytest.mark.onlynoncluster
     def test_zinterstore_max(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 1, 'a3': 1})
-        r.zadd('b', {'a1': 2, 'a2': 2, 'a3': 2})
-        r.zadd('c', {'a1': 6, 'a3': 5, 'a4': 4})
-        assert r.zinterstore('d', ['a', 'b', 'c'], aggregate='MAX') == 2
-        assert r.zrange('d', 0, -1, withscores=True) == \
-               [(b'a3', 5), (b'a1', 6)]
+        r.zadd("a", {"a1": 1, "a2": 1, "a3": 1})
+        r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
+        r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
+        assert r.zinterstore("d", ["a", "b", "c"], aggregate="MAX") == 2
+        assert r.zrange("d", 0, -1, withscores=True) == [(b"a3", 5), (b"a1", 6)]
 
     @pytest.mark.onlynoncluster
     def test_zinterstore_min(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
-        r.zadd('b', {'a1': 2, 'a2': 3, 'a3': 5})
-        r.zadd('c', {'a1': 6, 'a3': 5, 'a4': 4})
-        assert r.zinterstore('d', ['a', 'b', 'c'], aggregate='MIN') == 2
-        assert r.zrange('d', 0, -1, withscores=True) == \
-               [(b'a1', 1), (b'a3', 3)]
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        r.zadd("b", {"a1": 2, "a2": 3, "a3": 5})
+        r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
+        assert r.zinterstore("d", ["a", "b", "c"], aggregate="MIN") == 2
+        assert r.zrange("d", 0, -1, withscores=True) == [(b"a1", 1), (b"a3", 3)]
 
     @pytest.mark.onlynoncluster
     def test_zinterstore_with_weight(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 1, 'a3': 1})
-        r.zadd('b', {'a1': 2, 'a2': 2, 'a3': 2})
-        r.zadd('c', {'a1': 6, 'a3': 5, 'a4': 4})
-        assert r.zinterstore('d', {'a': 1, 'b': 2, 'c': 3}) == 2
-        assert r.zrange('d', 0, -1, withscores=True) == \
-               [(b'a3', 20), (b'a1', 23)]
-
-    @skip_if_server_version_lt('4.9.0')
+        r.zadd("a", {"a1": 1, "a2": 1, "a3": 1})
+        r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
+        r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
+        assert r.zinterstore("d", {"a": 1, "b": 2, "c": 3}) == 2
+        assert r.zrange("d", 0, -1, withscores=True) == [(b"a3", 20), (b"a1", 23)]
+
+    @skip_if_server_version_lt("4.9.0")
     def test_zpopmax(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
-        assert r.zpopmax('a') == [(b'a3', 3)]
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        assert r.zpopmax("a") == [(b"a3", 3)]
 
         # with count
-        assert r.zpopmax('a', count=2) == \
-               [(b'a2', 2), (b'a1', 1)]
+        assert r.zpopmax("a", count=2) == [(b"a2", 2), (b"a1", 1)]
 
-    @skip_if_server_version_lt('4.9.0')
+    @skip_if_server_version_lt("4.9.0")
     def test_zpopmin(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
-        assert r.zpopmin('a') == [(b'a1', 1)]
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        assert r.zpopmin("a") == [(b"a1", 1)]
 
         # with count
-        assert r.zpopmin('a', count=2) == \
-               [(b'a2', 2), (b'a3', 3)]
+        assert r.zpopmin("a", count=2) == [(b"a2", 2), (b"a3", 3)]
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_zrandemember(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3, 'a4': 4, 'a5': 5})
-        assert r.zrandmember('a') is not None
-        assert len(r.zrandmember('a', 2)) == 2
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
+        assert r.zrandmember("a") is not None
+        assert len(r.zrandmember("a", 2)) == 2
         # with scores
-        assert len(r.zrandmember('a', 2, True)) == 4
+        assert len(r.zrandmember("a", 2, True)) == 4
         # without duplications
-        assert len(r.zrandmember('a', 10)) == 5
+        assert len(r.zrandmember("a", 10)) == 5
         # with duplications
-        assert len(r.zrandmember('a', -10)) == 10
+        assert len(r.zrandmember("a", -10)) == 10
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('4.9.0')
+    @skip_if_server_version_lt("4.9.0")
     def test_bzpopmax(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2})
-        r.zadd('b', {'b1': 10, 'b2': 20})
-        assert r.bzpopmax(['b', 'a'], timeout=1) == (b'b', b'b2', 20)
-        assert r.bzpopmax(['b', 'a'], timeout=1) == (b'b', b'b1', 10)
-        assert r.bzpopmax(['b', 'a'], timeout=1) == (b'a', b'a2', 2)
-        assert r.bzpopmax(['b', 'a'], timeout=1) == (b'a', b'a1', 1)
-        assert r.bzpopmax(['b', 'a'], timeout=1) is None
-        r.zadd('c', {'c1': 100})
-        assert r.bzpopmax('c', timeout=1) == (b'c', b'c1', 100)
-
-    @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('4.9.0')
+        r.zadd("a", {"a1": 1, "a2": 2})
+        r.zadd("b", {"b1": 10, "b2": 20})
+        assert r.bzpopmax(["b", "a"], timeout=1) == (b"b", b"b2", 20)
+        assert r.bzpopmax(["b", "a"], timeout=1) == (b"b", b"b1", 10)
+        assert r.bzpopmax(["b", "a"], timeout=1) == (b"a", b"a2", 2)
+        assert r.bzpopmax(["b", "a"], timeout=1) == (b"a", b"a1", 1)
+        assert r.bzpopmax(["b", "a"], timeout=1) is None
+        r.zadd("c", {"c1": 100})
+        assert r.bzpopmax("c", timeout=1) == (b"c", b"c1", 100)
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("4.9.0")
     def test_bzpopmin(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2})
-        r.zadd('b', {'b1': 10, 'b2': 20})
-        assert r.bzpopmin(['b', 'a'], timeout=1) == (b'b', b'b1', 10)
-        assert r.bzpopmin(['b', 'a'], timeout=1) == (b'b', b'b2', 20)
-        assert r.bzpopmin(['b', 'a'], timeout=1) == (b'a', b'a1', 1)
-        assert r.bzpopmin(['b', 'a'], timeout=1) == (b'a', b'a2', 2)
-        assert r.bzpopmin(['b', 'a'], timeout=1) is None
-        r.zadd('c', {'c1': 100})
-        assert r.bzpopmin('c', timeout=1) == (b'c', b'c1', 100)
+        r.zadd("a", {"a1": 1, "a2": 2})
+        r.zadd("b", {"b1": 10, "b2": 20})
+        assert r.bzpopmin(["b", "a"], timeout=1) == (b"b", b"b1", 10)
+        assert r.bzpopmin(["b", "a"], timeout=1) == (b"b", b"b2", 20)
+        assert r.bzpopmin(["b", "a"], timeout=1) == (b"a", b"a1", 1)
+        assert r.bzpopmin(["b", "a"], timeout=1) == (b"a", b"a2", 2)
+        assert r.bzpopmin(["b", "a"], timeout=1) is None
+        r.zadd("c", {"c1": 100})
+        assert r.bzpopmin("c", timeout=1) == (b"c", b"c1", 100)
 
     def test_zrange(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
-        assert r.zrange('a', 0, 1) == [b'a1', b'a2']
-        assert r.zrange('a', 1, 2) == [b'a2', b'a3']
-        assert r.zrange('a', 0, 2) == [b'a1', b'a2', b'a3']
-        assert r.zrange('a', 0, 2, desc=True) == [b'a3', b'a2', b'a1']
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        assert r.zrange("a", 0, 1) == [b"a1", b"a2"]
+        assert r.zrange("a", 1, 2) == [b"a2", b"a3"]
+        assert r.zrange("a", 0, 2) == [b"a1", b"a2", b"a3"]
+        assert r.zrange("a", 0, 2, desc=True) == [b"a3", b"a2", b"a1"]
 
         # withscores
-        assert r.zrange('a', 0, 1, withscores=True) == \
-               [(b'a1', 1.0), (b'a2', 2.0)]
-        assert r.zrange('a', 1, 2, withscores=True) == \
-               [(b'a2', 2.0), (b'a3', 3.0)]
+        assert r.zrange("a", 0, 1, withscores=True) == [(b"a1", 1.0), (b"a2", 2.0)]
+        assert r.zrange("a", 1, 2, withscores=True) == [(b"a2", 2.0), (b"a3", 3.0)]
 
         # custom score function
-        assert r.zrange('a', 0, 1, withscores=True, score_cast_func=int) == \
-               [(b'a1', 1), (b'a2', 2)]
+        assert r.zrange("a", 0, 1, withscores=True, score_cast_func=int) == [
+            (b"a1", 1),
+            (b"a2", 2),
+        ]
 
     def test_zrange_errors(self, r):
         with pytest.raises(exceptions.DataError):
-            r.zrange('a', 0, 1, byscore=True, bylex=True)
+            r.zrange("a", 0, 1, byscore=True, bylex=True)
         with pytest.raises(exceptions.DataError):
-            r.zrange('a', 0, 1, bylex=True, withscores=True)
+            r.zrange("a", 0, 1, bylex=True, withscores=True)
         with pytest.raises(exceptions.DataError):
-            r.zrange('a', 0, 1, byscore=True, withscores=True, offset=4)
+            r.zrange("a", 0, 1, byscore=True, withscores=True, offset=4)
         with pytest.raises(exceptions.DataError):
-            r.zrange('a', 0, 1, byscore=True, withscores=True, num=2)
+            r.zrange("a", 0, 1, byscore=True, withscores=True, num=2)
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_zrange_params(self, r):
         # bylex
-        r.zadd('a', {'a': 0, 'b': 0, 'c': 0, 'd': 0, 'e': 0, 'f': 0, 'g': 0})
-        assert r.zrange('a', '[aaa', '(g', bylex=True) == \
-               [b'b', b'c', b'd', b'e', b'f']
-        assert r.zrange('a', '[f', '+', bylex=True) == [b'f', b'g']
-        assert r.zrange('a', '+', '[f', desc=True, bylex=True) == [b'g', b'f']
-        assert r.zrange('a', '-', '+', bylex=True, offset=3, num=2) == \
-               [b'd', b'e']
-        assert r.zrange('a', '+', '-', desc=True, bylex=True,
-                        offset=3, num=2) == \
-               [b'd', b'c']
+        r.zadd("a", {"a": 0, "b": 0, "c": 0, "d": 0, "e": 0, "f": 0, "g": 0})
+        assert r.zrange("a", "[aaa", "(g", bylex=True) == [b"b", b"c", b"d", b"e", b"f"]
+        assert r.zrange("a", "[f", "+", bylex=True) == [b"f", b"g"]
+        assert r.zrange("a", "+", "[f", desc=True, bylex=True) == [b"g", b"f"]
+        assert r.zrange("a", "-", "+", bylex=True, offset=3, num=2) == [b"d", b"e"]
+        assert r.zrange("a", "+", "-", desc=True, bylex=True, offset=3, num=2) == [
+            b"d",
+            b"c",
+        ]
 
         # byscore
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3, 'a4': 4, 'a5': 5})
-        assert r.zrange('a', 2, 4, byscore=True, offset=1, num=2) == \
-               [b'a3', b'a4']
-        assert r.zrange('a', 4, 2, desc=True, byscore=True,
-                        offset=1, num=2) == \
-               [b'a3', b'a2']
-        assert r.zrange('a', 2, 4, byscore=True, withscores=True) == \
-               [(b'a2', 2.0), (b'a3', 3.0), (b'a4', 4.0)]
-        assert r.zrange('a', 4, 2, desc=True, byscore=True,
-                        withscores=True, score_cast_func=int) == \
-               [(b'a4', 4), (b'a3', 3), (b'a2', 2)]
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
+        assert r.zrange("a", 2, 4, byscore=True, offset=1, num=2) == [b"a3", b"a4"]
+        assert r.zrange("a", 4, 2, desc=True, byscore=True, offset=1, num=2) == [
+            b"a3",
+            b"a2",
+        ]
+        assert r.zrange("a", 2, 4, byscore=True, withscores=True) == [
+            (b"a2", 2.0),
+            (b"a3", 3.0),
+            (b"a4", 4.0),
+        ]
+        assert r.zrange(
+            "a", 4, 2, desc=True, byscore=True, withscores=True, score_cast_func=int
+        ) == [(b"a4", 4), (b"a3", 3), (b"a2", 2)]
 
         # rev
-        assert r.zrange('a', 0, 1, desc=True) == [b'a5', b'a4']
+        assert r.zrange("a", 0, 1, desc=True) == [b"a5", b"a4"]
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_zrangestore(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
-        assert r.zrangestore('b', 'a', 0, 1)
-        assert r.zrange('b', 0, -1) == [b'a1', b'a2']
-        assert r.zrangestore('b', 'a', 1, 2)
-        assert r.zrange('b', 0, -1) == [b'a2', b'a3']
-        assert r.zrange('b', 0, -1, withscores=True) == \
-               [(b'a2', 2), (b'a3', 3)]
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        assert r.zrangestore("b", "a", 0, 1)
+        assert r.zrange("b", 0, -1) == [b"a1", b"a2"]
+        assert r.zrangestore("b", "a", 1, 2)
+        assert r.zrange("b", 0, -1) == [b"a2", b"a3"]
+        assert r.zrange("b", 0, -1, withscores=True) == [(b"a2", 2), (b"a3", 3)]
         # reversed order
-        assert r.zrangestore('b', 'a', 1, 2, desc=True)
-        assert r.zrange('b', 0, -1) == [b'a1', b'a2']
+        assert r.zrangestore("b", "a", 1, 2, desc=True)
+        assert r.zrange("b", 0, -1) == [b"a1", b"a2"]
         # by score
-        assert r.zrangestore('b', 'a', 2, 1, byscore=True,
-                             offset=0, num=1, desc=True)
-        assert r.zrange('b', 0, -1) == [b'a2']
+        assert r.zrangestore("b", "a", 2, 1, byscore=True, offset=0, num=1, desc=True)
+        assert r.zrange("b", 0, -1) == [b"a2"]
         # by lex
-        assert r.zrangestore('b', 'a', '[a2', '(a3', bylex=True,
-                             offset=0, num=1)
-        assert r.zrange('b', 0, -1) == [b'a2']
+        assert r.zrangestore("b", "a", "[a2", "(a3", bylex=True, offset=0, num=1)
+        assert r.zrange("b", 0, -1) == [b"a2"]
 
-    @skip_if_server_version_lt('2.8.9')
+    @skip_if_server_version_lt("2.8.9")
     def test_zrangebylex(self, r):
-        r.zadd('a', {'a': 0, 'b': 0, 'c': 0, 'd': 0, 'e': 0, 'f': 0, 'g': 0})
-        assert r.zrangebylex('a', '-', '[c') == [b'a', b'b', b'c']
-        assert r.zrangebylex('a', '-', '(c') == [b'a', b'b']
-        assert r.zrangebylex('a', '[aaa', '(g') == \
-               [b'b', b'c', b'd', b'e', b'f']
-        assert r.zrangebylex('a', '[f', '+') == [b'f', b'g']
-        assert r.zrangebylex('a', '-', '+', start=3, num=2) == [b'd', b'e']
-
-    @skip_if_server_version_lt('2.9.9')
+        r.zadd("a", {"a": 0, "b": 0, "c": 0, "d": 0, "e": 0, "f": 0, "g": 0})
+        assert r.zrangebylex("a", "-", "[c") == [b"a", b"b", b"c"]
+        assert r.zrangebylex("a", "-", "(c") == [b"a", b"b"]
+        assert r.zrangebylex("a", "[aaa", "(g") == [b"b", b"c", b"d", b"e", b"f"]
+        assert r.zrangebylex("a", "[f", "+") == [b"f", b"g"]
+        assert r.zrangebylex("a", "-", "+", start=3, num=2) == [b"d", b"e"]
+
+    @skip_if_server_version_lt("2.9.9")
     def test_zrevrangebylex(self, r):
-        r.zadd('a', {'a': 0, 'b': 0, 'c': 0, 'd': 0, 'e': 0, 'f': 0, 'g': 0})
-        assert r.zrevrangebylex('a', '[c', '-') == [b'c', b'b', b'a']
-        assert r.zrevrangebylex('a', '(c', '-') == [b'b', b'a']
-        assert r.zrevrangebylex('a', '(g', '[aaa') == \
-               [b'f', b'e', b'd', b'c', b'b']
-        assert r.zrevrangebylex('a', '+', '[f') == [b'g', b'f']
-        assert r.zrevrangebylex('a', '+', '-', start=3, num=2) == \
-               [b'd', b'c']
+        r.zadd("a", {"a": 0, "b": 0, "c": 0, "d": 0, "e": 0, "f": 0, "g": 0})
+        assert r.zrevrangebylex("a", "[c", "-") == [b"c", b"b", b"a"]
+        assert r.zrevrangebylex("a", "(c", "-") == [b"b", b"a"]
+        assert r.zrevrangebylex("a", "(g", "[aaa") == [b"f", b"e", b"d", b"c", b"b"]
+        assert r.zrevrangebylex("a", "+", "[f") == [b"g", b"f"]
+        assert r.zrevrangebylex("a", "+", "-", start=3, num=2) == [b"d", b"c"]
 
     def test_zrangebyscore(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3, 'a4': 4, 'a5': 5})
-        assert r.zrangebyscore('a', 2, 4) == [b'a2', b'a3', b'a4']
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
+        assert r.zrangebyscore("a", 2, 4) == [b"a2", b"a3", b"a4"]
         # slicing with start/num
-        assert r.zrangebyscore('a', 2, 4, start=1, num=2) == \
-               [b'a3', b'a4']
+        assert r.zrangebyscore("a", 2, 4, start=1, num=2) == [b"a3", b"a4"]
         # withscores
-        assert r.zrangebyscore('a', 2, 4, withscores=True) == \
-               [(b'a2', 2.0), (b'a3', 3.0), (b'a4', 4.0)]
-        assert r.zrangebyscore('a', 2, 4, withscores=True,
-                               score_cast_func=int) == \
-               [(b'a2', 2), (b'a3', 3), (b'a4', 4)]
+        assert r.zrangebyscore("a", 2, 4, withscores=True) == [
+            (b"a2", 2.0),
+            (b"a3", 3.0),
+            (b"a4", 4.0),
+        ]
+        assert r.zrangebyscore("a", 2, 4, withscores=True, score_cast_func=int) == [
+            (b"a2", 2),
+            (b"a3", 3),
+            (b"a4", 4),
+        ]
 
     def test_zrank(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3, 'a4': 4, 'a5': 5})
-        assert r.zrank('a', 'a1') == 0
-        assert r.zrank('a', 'a2') == 1
-        assert r.zrank('a', 'a6') is None
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
+        assert r.zrank("a", "a1") == 0
+        assert r.zrank("a", "a2") == 1
+        assert r.zrank("a", "a6") is None
 
     def test_zrem(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
-        assert r.zrem('a', 'a2') == 1
-        assert r.zrange('a', 0, -1) == [b'a1', b'a3']
-        assert r.zrem('a', 'b') == 0
-        assert r.zrange('a', 0, -1) == [b'a1', b'a3']
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        assert r.zrem("a", "a2") == 1
+        assert r.zrange("a", 0, -1) == [b"a1", b"a3"]
+        assert r.zrem("a", "b") == 0
+        assert r.zrange("a", 0, -1) == [b"a1", b"a3"]
 
     def test_zrem_multiple_keys(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
-        assert r.zrem('a', 'a1', 'a2') == 2
-        assert r.zrange('a', 0, 5) == [b'a3']
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        assert r.zrem("a", "a1", "a2") == 2
+        assert r.zrange("a", 0, 5) == [b"a3"]
 
-    @skip_if_server_version_lt('2.8.9')
+    @skip_if_server_version_lt("2.8.9")
     def test_zremrangebylex(self, r):
-        r.zadd('a', {'a': 0, 'b': 0, 'c': 0, 'd': 0, 'e': 0, 'f': 0, 'g': 0})
-        assert r.zremrangebylex('a', '-', '[c') == 3
-        assert r.zrange('a', 0, -1) == [b'd', b'e', b'f', b'g']
-        assert r.zremrangebylex('a', '[f', '+') == 2
-        assert r.zrange('a', 0, -1) == [b'd', b'e']
-        assert r.zremrangebylex('a', '[h', '+') == 0
-        assert r.zrange('a', 0, -1) == [b'd', b'e']
+        r.zadd("a", {"a": 0, "b": 0, "c": 0, "d": 0, "e": 0, "f": 0, "g": 0})
+        assert r.zremrangebylex("a", "-", "[c") == 3
+        assert r.zrange("a", 0, -1) == [b"d", b"e", b"f", b"g"]
+        assert r.zremrangebylex("a", "[f", "+") == 2
+        assert r.zrange("a", 0, -1) == [b"d", b"e"]
+        assert r.zremrangebylex("a", "[h", "+") == 0
+        assert r.zrange("a", 0, -1) == [b"d", b"e"]
 
     def test_zremrangebyrank(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3, 'a4': 4, 'a5': 5})
-        assert r.zremrangebyrank('a', 1, 3) == 3
-        assert r.zrange('a', 0, 5) == [b'a1', b'a5']
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
+        assert r.zremrangebyrank("a", 1, 3) == 3
+        assert r.zrange("a", 0, 5) == [b"a1", b"a5"]
 
     def test_zremrangebyscore(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3, 'a4': 4, 'a5': 5})
-        assert r.zremrangebyscore('a', 2, 4) == 3
-        assert r.zrange('a', 0, -1) == [b'a1', b'a5']
-        assert r.zremrangebyscore('a', 2, 4) == 0
-        assert r.zrange('a', 0, -1) == [b'a1', b'a5']
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
+        assert r.zremrangebyscore("a", 2, 4) == 3
+        assert r.zrange("a", 0, -1) == [b"a1", b"a5"]
+        assert r.zremrangebyscore("a", 2, 4) == 0
+        assert r.zrange("a", 0, -1) == [b"a1", b"a5"]
 
     def test_zrevrange(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
-        assert r.zrevrange('a', 0, 1) == [b'a3', b'a2']
-        assert r.zrevrange('a', 1, 2) == [b'a2', b'a1']
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        assert r.zrevrange("a", 0, 1) == [b"a3", b"a2"]
+        assert r.zrevrange("a", 1, 2) == [b"a2", b"a1"]
 
         # withscores
-        assert r.zrevrange('a', 0, 1, withscores=True) == \
-               [(b'a3', 3.0), (b'a2', 2.0)]
-        assert r.zrevrange('a', 1, 2, withscores=True) == \
-               [(b'a2', 2.0), (b'a1', 1.0)]
+        assert r.zrevrange("a", 0, 1, withscores=True) == [(b"a3", 3.0), (b"a2", 2.0)]
+        assert r.zrevrange("a", 1, 2, withscores=True) == [(b"a2", 2.0), (b"a1", 1.0)]
 
         # custom score function
-        assert r.zrevrange('a', 0, 1, withscores=True,
-                           score_cast_func=int) == \
-               [(b'a3', 3.0), (b'a2', 2.0)]
+        assert r.zrevrange("a", 0, 1, withscores=True, score_cast_func=int) == [
+            (b"a3", 3.0),
+            (b"a2", 2.0),
+        ]
 
     def test_zrevrangebyscore(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3, 'a4': 4, 'a5': 5})
-        assert r.zrevrangebyscore('a', 4, 2) == [b'a4', b'a3', b'a2']
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
+        assert r.zrevrangebyscore("a", 4, 2) == [b"a4", b"a3", b"a2"]
         # slicing with start/num
-        assert r.zrevrangebyscore('a', 4, 2, start=1, num=2) == \
-               [b'a3', b'a2']
+        assert r.zrevrangebyscore("a", 4, 2, start=1, num=2) == [b"a3", b"a2"]
         # withscores
-        assert r.zrevrangebyscore('a', 4, 2, withscores=True) == \
-               [(b'a4', 4.0), (b'a3', 3.0), (b'a2', 2.0)]
+        assert r.zrevrangebyscore("a", 4, 2, withscores=True) == [
+            (b"a4", 4.0),
+            (b"a3", 3.0),
+            (b"a2", 2.0),
+        ]
         # custom score function
-        assert r.zrevrangebyscore('a', 4, 2, withscores=True,
-                                  score_cast_func=int) == \
-               [(b'a4', 4), (b'a3', 3), (b'a2', 2)]
+        assert r.zrevrangebyscore("a", 4, 2, withscores=True, score_cast_func=int) == [
+            (b"a4", 4),
+            (b"a3", 3),
+            (b"a2", 2),
+        ]
 
     def test_zrevrank(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3, 'a4': 4, 'a5': 5})
-        assert r.zrevrank('a', 'a1') == 4
-        assert r.zrevrank('a', 'a2') == 3
-        assert r.zrevrank('a', 'a6') is None
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
+        assert r.zrevrank("a", "a1") == 4
+        assert r.zrevrank("a", "a2") == 3
+        assert r.zrevrank("a", "a6") is None
 
     def test_zscore(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
-        assert r.zscore('a', 'a1') == 1.0
-        assert r.zscore('a', 'a2') == 2.0
-        assert r.zscore('a', 'a4') is None
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        assert r.zscore("a", "a1") == 1.0
+        assert r.zscore("a", "a2") == 2.0
+        assert r.zscore("a", "a4") is None
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_zunion(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 1, 'a3': 1})
-        r.zadd('b', {'a1': 2, 'a2': 2, 'a3': 2})
-        r.zadd('c', {'a1': 6, 'a3': 5, 'a4': 4})
+        r.zadd("a", {"a1": 1, "a2": 1, "a3": 1})
+        r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
+        r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
         # sum
-        assert r.zunion(['a', 'b', 'c']) == \
-            [b'a2', b'a4', b'a3', b'a1']
-        assert r.zunion(['a', 'b', 'c'], withscores=True) == \
-            [(b'a2', 3), (b'a4', 4), (b'a3', 8), (b'a1', 9)]
+        assert r.zunion(["a", "b", "c"]) == [b"a2", b"a4", b"a3", b"a1"]
+        assert r.zunion(["a", "b", "c"], withscores=True) == [
+            (b"a2", 3),
+            (b"a4", 4),
+            (b"a3", 8),
+            (b"a1", 9),
+        ]
         # max
-        assert r.zunion(['a', 'b', 'c'], aggregate='MAX', withscores=True)\
-               == [(b'a2', 2), (b'a4', 4), (b'a3', 5), (b'a1', 6)]
+        assert r.zunion(["a", "b", "c"], aggregate="MAX", withscores=True) == [
+            (b"a2", 2),
+            (b"a4", 4),
+            (b"a3", 5),
+            (b"a1", 6),
+        ]
         # min
-        assert r.zunion(['a', 'b', 'c'], aggregate='MIN', withscores=True)\
-               == [(b'a1', 1), (b'a2', 1), (b'a3', 1), (b'a4', 4)]
+        assert r.zunion(["a", "b", "c"], aggregate="MIN", withscores=True) == [
+            (b"a1", 1),
+            (b"a2", 1),
+            (b"a3", 1),
+            (b"a4", 4),
+        ]
         # with weight
-        assert r.zunion({'a': 1, 'b': 2, 'c': 3}, withscores=True)\
-               == [(b'a2', 5), (b'a4', 12), (b'a3', 20), (b'a1', 23)]
+        assert r.zunion({"a": 1, "b": 2, "c": 3}, withscores=True) == [
+            (b"a2", 5),
+            (b"a4", 12),
+            (b"a3", 20),
+            (b"a1", 23),
+        ]
 
     @pytest.mark.onlynoncluster
     def test_zunionstore_sum(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 1, 'a3': 1})
-        r.zadd('b', {'a1': 2, 'a2': 2, 'a3': 2})
-        r.zadd('c', {'a1': 6, 'a3': 5, 'a4': 4})
-        assert r.zunionstore('d', ['a', 'b', 'c']) == 4
-        assert r.zrange('d', 0, -1, withscores=True) == \
-               [(b'a2', 3), (b'a4', 4), (b'a3', 8), (b'a1', 9)]
+        r.zadd("a", {"a1": 1, "a2": 1, "a3": 1})
+        r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
+        r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
+        assert r.zunionstore("d", ["a", "b", "c"]) == 4
+        assert r.zrange("d", 0, -1, withscores=True) == [
+            (b"a2", 3),
+            (b"a4", 4),
+            (b"a3", 8),
+            (b"a1", 9),
+        ]
 
     @pytest.mark.onlynoncluster
     def test_zunionstore_max(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 1, 'a3': 1})
-        r.zadd('b', {'a1': 2, 'a2': 2, 'a3': 2})
-        r.zadd('c', {'a1': 6, 'a3': 5, 'a4': 4})
-        assert r.zunionstore('d', ['a', 'b', 'c'], aggregate='MAX') == 4
-        assert r.zrange('d', 0, -1, withscores=True) == \
-               [(b'a2', 2), (b'a4', 4), (b'a3', 5), (b'a1', 6)]
+        r.zadd("a", {"a1": 1, "a2": 1, "a3": 1})
+        r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
+        r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
+        assert r.zunionstore("d", ["a", "b", "c"], aggregate="MAX") == 4
+        assert r.zrange("d", 0, -1, withscores=True) == [
+            (b"a2", 2),
+            (b"a4", 4),
+            (b"a3", 5),
+            (b"a1", 6),
+        ]
 
     @pytest.mark.onlynoncluster
     def test_zunionstore_min(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3})
-        r.zadd('b', {'a1': 2, 'a2': 2, 'a3': 4})
-        r.zadd('c', {'a1': 6, 'a3': 5, 'a4': 4})
-        assert r.zunionstore('d', ['a', 'b', 'c'], aggregate='MIN') == 4
-        assert r.zrange('d', 0, -1, withscores=True) == \
-               [(b'a1', 1), (b'a2', 2), (b'a3', 3), (b'a4', 4)]
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        r.zadd("b", {"a1": 2, "a2": 2, "a3": 4})
+        r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
+        assert r.zunionstore("d", ["a", "b", "c"], aggregate="MIN") == 4
+        assert r.zrange("d", 0, -1, withscores=True) == [
+            (b"a1", 1),
+            (b"a2", 2),
+            (b"a3", 3),
+            (b"a4", 4),
+        ]
 
     @pytest.mark.onlynoncluster
     def test_zunionstore_with_weight(self, r):
-        r.zadd('a', {'a1': 1, 'a2': 1, 'a3': 1})
-        r.zadd('b', {'a1': 2, 'a2': 2, 'a3': 2})
-        r.zadd('c', {'a1': 6, 'a3': 5, 'a4': 4})
-        assert r.zunionstore('d', {'a': 1, 'b': 2, 'c': 3}) == 4
-        assert r.zrange('d', 0, -1, withscores=True) == \
-               [(b'a2', 5), (b'a4', 12), (b'a3', 20), (b'a1', 23)]
-
-    @skip_if_server_version_lt('6.1.240')
+        r.zadd("a", {"a1": 1, "a2": 1, "a3": 1})
+        r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
+        r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
+        assert r.zunionstore("d", {"a": 1, "b": 2, "c": 3}) == 4
+        assert r.zrange("d", 0, -1, withscores=True) == [
+            (b"a2", 5),
+            (b"a4", 12),
+            (b"a3", 20),
+            (b"a1", 23),
+        ]
+
+    @skip_if_server_version_lt("6.1.240")
     def test_zmscore(self, r):
         with pytest.raises(exceptions.DataError):
-            r.zmscore('invalid_key', [])
+            r.zmscore("invalid_key", [])
 
-        assert r.zmscore('invalid_key', ['invalid_member']) == [None]
+        assert r.zmscore("invalid_key", ["invalid_member"]) == [None]
 
-        r.zadd('a', {'a1': 1, 'a2': 2, 'a3': 3.5})
-        assert r.zmscore('a', ['a1', 'a2', 'a3', 'a4']) == \
-            [1.0, 2.0, 3.5, None]
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3.5})
+        assert r.zmscore("a", ["a1", "a2", "a3", "a4"]) == [1.0, 2.0, 3.5, None]
 
     # HYPERLOGLOG TESTS
-    @skip_if_server_version_lt('2.8.9')
+    @skip_if_server_version_lt("2.8.9")
     def test_pfadd(self, r):
-        members = {b'1', b'2', b'3'}
-        assert r.pfadd('a', *members) == 1
-        assert r.pfadd('a', *members) == 0
-        assert r.pfcount('a') == len(members)
+        members = {b"1", b"2", b"3"}
+        assert r.pfadd("a", *members) == 1
+        assert r.pfadd("a", *members) == 0
+        assert r.pfcount("a") == len(members)
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.8.9')
+    @skip_if_server_version_lt("2.8.9")
     def test_pfcount(self, r):
-        members = {b'1', b'2', b'3'}
-        r.pfadd('a', *members)
-        assert r.pfcount('a') == len(members)
-        members_b = {b'2', b'3', b'4'}
-        r.pfadd('b', *members_b)
-        assert r.pfcount('b') == len(members_b)
-        assert r.pfcount('a', 'b') == len(members_b.union(members))
+        members = {b"1", b"2", b"3"}
+        r.pfadd("a", *members)
+        assert r.pfcount("a") == len(members)
+        members_b = {b"2", b"3", b"4"}
+        r.pfadd("b", *members_b)
+        assert r.pfcount("b") == len(members_b)
+        assert r.pfcount("a", "b") == len(members_b.union(members))
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.8.9')
+    @skip_if_server_version_lt("2.8.9")
     def test_pfmerge(self, r):
-        mema = {b'1', b'2', b'3'}
-        memb = {b'2', b'3', b'4'}
-        memc = {b'5', b'6', b'7'}
-        r.pfadd('a', *mema)
-        r.pfadd('b', *memb)
-        r.pfadd('c', *memc)
-        r.pfmerge('d', 'c', 'a')
-        assert r.pfcount('d') == 6
-        r.pfmerge('d', 'b')
-        assert r.pfcount('d') == 7
+        mema = {b"1", b"2", b"3"}
+        memb = {b"2", b"3", b"4"}
+        memc = {b"5", b"6", b"7"}
+        r.pfadd("a", *mema)
+        r.pfadd("b", *memb)
+        r.pfadd("c", *memc)
+        r.pfmerge("d", "c", "a")
+        assert r.pfcount("d") == 6
+        r.pfmerge("d", "b")
+        assert r.pfcount("d") == 7
 
     # HASH COMMANDS
     def test_hget_and_hset(self, r):
-        r.hset('a', mapping={'1': 1, '2': 2, '3': 3})
-        assert r.hget('a', '1') == b'1'
-        assert r.hget('a', '2') == b'2'
-        assert r.hget('a', '3') == b'3'
+        r.hset("a", mapping={"1": 1, "2": 2, "3": 3})
+        assert r.hget("a", "1") == b"1"
+        assert r.hget("a", "2") == b"2"
+        assert r.hget("a", "3") == b"3"
 
         # field was updated, redis returns 0
-        assert r.hset('a', '2', 5) == 0
-        assert r.hget('a', '2') == b'5'
+        assert r.hset("a", "2", 5) == 0
+        assert r.hget("a", "2") == b"5"
 
         # field is new, redis returns 1
-        assert r.hset('a', '4', 4) == 1
-        assert r.hget('a', '4') == b'4'
+        assert r.hset("a", "4", 4) == 1
+        assert r.hget("a", "4") == b"4"
 
         # key inside of hash that doesn't exist returns null value
-        assert r.hget('a', 'b') is None
+        assert r.hget("a", "b") is None
 
         # keys with bool(key) == False
-        assert r.hset('a', 0, 10) == 1
-        assert r.hset('a', '', 10) == 1
+        assert r.hset("a", 0, 10) == 1
+        assert r.hset("a", "", 10) == 1
 
     def test_hset_with_multi_key_values(self, r):
-        r.hset('a', mapping={'1': 1, '2': 2, '3': 3})
-        assert r.hget('a', '1') == b'1'
-        assert r.hget('a', '2') == b'2'
-        assert r.hget('a', '3') == b'3'
+        r.hset("a", mapping={"1": 1, "2": 2, "3": 3})
+        assert r.hget("a", "1") == b"1"
+        assert r.hget("a", "2") == b"2"
+        assert r.hget("a", "3") == b"3"
 
-        r.hset('b', "foo", "bar", mapping={'1': 1, '2': 2})
-        assert r.hget('b', '1') == b'1'
-        assert r.hget('b', '2') == b'2'
-        assert r.hget('b', 'foo') == b'bar'
+        r.hset("b", "foo", "bar", mapping={"1": 1, "2": 2})
+        assert r.hget("b", "1") == b"1"
+        assert r.hget("b", "2") == b"2"
+        assert r.hget("b", "foo") == b"bar"
 
     def test_hset_without_data(self, r):
         with pytest.raises(exceptions.DataError):
             r.hset("x")
 
     def test_hdel(self, r):
-        r.hset('a', mapping={'1': 1, '2': 2, '3': 3})
-        assert r.hdel('a', '2') == 1
-        assert r.hget('a', '2') is None
-        assert r.hdel('a', '1', '3') == 2
-        assert r.hlen('a') == 0
+        r.hset("a", mapping={"1": 1, "2": 2, "3": 3})
+        assert r.hdel("a", "2") == 1
+        assert r.hget("a", "2") is None
+        assert r.hdel("a", "1", "3") == 2
+        assert r.hlen("a") == 0
 
     def test_hexists(self, r):
-        r.hset('a', mapping={'1': 1, '2': 2, '3': 3})
-        assert r.hexists('a', '1')
-        assert not r.hexists('a', '4')
+        r.hset("a", mapping={"1": 1, "2": 2, "3": 3})
+        assert r.hexists("a", "1")
+        assert not r.hexists("a", "4")
 
     def test_hgetall(self, r):
-        h = {b'a1': b'1', b'a2': b'2', b'a3': b'3'}
-        r.hset('a', mapping=h)
-        assert r.hgetall('a') == h
+        h = {b"a1": b"1", b"a2": b"2", b"a3": b"3"}
+        r.hset("a", mapping=h)
+        assert r.hgetall("a") == h
 
     def test_hincrby(self, r):
-        assert r.hincrby('a', '1') == 1
-        assert r.hincrby('a', '1', amount=2) == 3
-        assert r.hincrby('a', '1', amount=-2) == 1
+        assert r.hincrby("a", "1") == 1
+        assert r.hincrby("a", "1", amount=2) == 3
+        assert r.hincrby("a", "1", amount=-2) == 1
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_hincrbyfloat(self, r):
-        assert r.hincrbyfloat('a', '1') == 1.0
-        assert r.hincrbyfloat('a', '1') == 2.0
-        assert r.hincrbyfloat('a', '1', 1.2) == 3.2
+        assert r.hincrbyfloat("a", "1") == 1.0
+        assert r.hincrbyfloat("a", "1") == 2.0
+        assert r.hincrbyfloat("a", "1", 1.2) == 3.2
 
     def test_hkeys(self, r):
-        h = {b'a1': b'1', b'a2': b'2', b'a3': b'3'}
-        r.hset('a', mapping=h)
+        h = {b"a1": b"1", b"a2": b"2", b"a3": b"3"}
+        r.hset("a", mapping=h)
         local_keys = list(h.keys())
-        remote_keys = r.hkeys('a')
-        assert (sorted(local_keys) == sorted(remote_keys))
+        remote_keys = r.hkeys("a")
+        assert sorted(local_keys) == sorted(remote_keys)
 
     def test_hlen(self, r):
-        r.hset('a', mapping={'1': 1, '2': 2, '3': 3})
-        assert r.hlen('a') == 3
+        r.hset("a", mapping={"1": 1, "2": 2, "3": 3})
+        assert r.hlen("a") == 3
 
     def test_hmget(self, r):
-        assert r.hset('a', mapping={'a': 1, 'b': 2, 'c': 3})
-        assert r.hmget('a', 'a', 'b', 'c') == [b'1', b'2', b'3']
+        assert r.hset("a", mapping={"a": 1, "b": 2, "c": 3})
+        assert r.hmget("a", "a", "b", "c") == [b"1", b"2", b"3"]
 
     def test_hmset(self, r):
         redis_class = type(r).__name__
-        warning_message = (r'^{0}\.hmset\(\) is deprecated\. '
-                           r'Use {0}\.hset\(\) instead\.$'.format(redis_class))
-        h = {b'a': b'1', b'b': b'2', b'c': b'3'}
+        warning_message = (
+            r"^{0}\.hmset\(\) is deprecated\. "
+            r"Use {0}\.hset\(\) instead\.$".format(redis_class)
+        )
+        h = {b"a": b"1", b"b": b"2", b"c": b"3"}
         with pytest.warns(DeprecationWarning, match=warning_message):
-            assert r.hmset('a', h)
-        assert r.hgetall('a') == h
+            assert r.hmset("a", h)
+        assert r.hgetall("a") == h
 
     def test_hsetnx(self, r):
         # Initially set the hash field
-        assert r.hsetnx('a', '1', 1)
-        assert r.hget('a', '1') == b'1'
-        assert not r.hsetnx('a', '1', 2)
-        assert r.hget('a', '1') == b'1'
+        assert r.hsetnx("a", "1", 1)
+        assert r.hget("a", "1") == b"1"
+        assert not r.hsetnx("a", "1", 2)
+        assert r.hget("a", "1") == b"1"
 
     def test_hvals(self, r):
-        h = {b'a1': b'1', b'a2': b'2', b'a3': b'3'}
-        r.hset('a', mapping=h)
+        h = {b"a1": b"1", b"a2": b"2", b"a3": b"3"}
+        r.hset("a", mapping=h)
         local_vals = list(h.values())
-        remote_vals = r.hvals('a')
+        remote_vals = r.hvals("a")
         assert sorted(local_vals) == sorted(remote_vals)
 
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt("3.2.0")
     def test_hstrlen(self, r):
-        r.hset('a', mapping={'1': '22', '2': '333'})
-        assert r.hstrlen('a', '1') == 2
-        assert r.hstrlen('a', '2') == 3
+        r.hset("a", mapping={"1": "22", "2": "333"})
+        assert r.hstrlen("a", "1") == 2
+        assert r.hstrlen("a", "2") == 3
 
     # SORT
     def test_sort_basic(self, r):
-        r.rpush('a', '3', '2', '1', '4')
-        assert r.sort('a') == [b'1', b'2', b'3', b'4']
+        r.rpush("a", "3", "2", "1", "4")
+        assert r.sort("a") == [b"1", b"2", b"3", b"4"]
 
     def test_sort_limited(self, r):
-        r.rpush('a', '3', '2', '1', '4')
-        assert r.sort('a', start=1, num=2) == [b'2', b'3']
+        r.rpush("a", "3", "2", "1", "4")
+        assert r.sort("a", start=1, num=2) == [b"2", b"3"]
 
     @pytest.mark.onlynoncluster
     def test_sort_by(self, r):
-        r['score:1'] = 8
-        r['score:2'] = 3
-        r['score:3'] = 5
-        r.rpush('a', '3', '2', '1')
-        assert r.sort('a', by='score:*') == [b'2', b'3', b'1']
+        r["score:1"] = 8
+        r["score:2"] = 3
+        r["score:3"] = 5
+        r.rpush("a", "3", "2", "1")
+        assert r.sort("a", by="score:*") == [b"2", b"3", b"1"]
 
     @pytest.mark.onlynoncluster
     def test_sort_get(self, r):
-        r['user:1'] = 'u1'
-        r['user:2'] = 'u2'
-        r['user:3'] = 'u3'
-        r.rpush('a', '2', '3', '1')
-        assert r.sort('a', get='user:*') == [b'u1', b'u2', b'u3']
+        r["user:1"] = "u1"
+        r["user:2"] = "u2"
+        r["user:3"] = "u3"
+        r.rpush("a", "2", "3", "1")
+        assert r.sort("a", get="user:*") == [b"u1", b"u2", b"u3"]
 
     @pytest.mark.onlynoncluster
     def test_sort_get_multi(self, r):
-        r['user:1'] = 'u1'
-        r['user:2'] = 'u2'
-        r['user:3'] = 'u3'
-        r.rpush('a', '2', '3', '1')
-        assert r.sort('a', get=('user:*', '#')) == \
-               [b'u1', b'1', b'u2', b'2', b'u3', b'3']
+        r["user:1"] = "u1"
+        r["user:2"] = "u2"
+        r["user:3"] = "u3"
+        r.rpush("a", "2", "3", "1")
+        assert r.sort("a", get=("user:*", "#")) == [
+            b"u1",
+            b"1",
+            b"u2",
+            b"2",
+            b"u3",
+            b"3",
+        ]
 
     @pytest.mark.onlynoncluster
     def test_sort_get_groups_two(self, r):
-        r['user:1'] = 'u1'
-        r['user:2'] = 'u2'
-        r['user:3'] = 'u3'
-        r.rpush('a', '2', '3', '1')
-        assert r.sort('a', get=('user:*', '#'), groups=True) == \
-               [(b'u1', b'1'), (b'u2', b'2'), (b'u3', b'3')]
+        r["user:1"] = "u1"
+        r["user:2"] = "u2"
+        r["user:3"] = "u3"
+        r.rpush("a", "2", "3", "1")
+        assert r.sort("a", get=("user:*", "#"), groups=True) == [
+            (b"u1", b"1"),
+            (b"u2", b"2"),
+            (b"u3", b"3"),
+        ]
 
     @pytest.mark.onlynoncluster
     def test_sort_groups_string_get(self, r):
-        r['user:1'] = 'u1'
-        r['user:2'] = 'u2'
-        r['user:3'] = 'u3'
-        r.rpush('a', '2', '3', '1')
+        r["user:1"] = "u1"
+        r["user:2"] = "u2"
+        r["user:3"] = "u3"
+        r.rpush("a", "2", "3", "1")
         with pytest.raises(exceptions.DataError):
-            r.sort('a', get='user:*', groups=True)
+            r.sort("a", get="user:*", groups=True)
 
     @pytest.mark.onlynoncluster
     def test_sort_groups_just_one_get(self, r):
-        r['user:1'] = 'u1'
-        r['user:2'] = 'u2'
-        r['user:3'] = 'u3'
-        r.rpush('a', '2', '3', '1')
+        r["user:1"] = "u1"
+        r["user:2"] = "u2"
+        r["user:3"] = "u3"
+        r.rpush("a", "2", "3", "1")
         with pytest.raises(exceptions.DataError):
-            r.sort('a', get=['user:*'], groups=True)
+            r.sort("a", get=["user:*"], groups=True)
 
     def test_sort_groups_no_get(self, r):
-        r['user:1'] = 'u1'
-        r['user:2'] = 'u2'
-        r['user:3'] = 'u3'
-        r.rpush('a', '2', '3', '1')
+        r["user:1"] = "u1"
+        r["user:2"] = "u2"
+        r["user:3"] = "u3"
+        r.rpush("a", "2", "3", "1")
         with pytest.raises(exceptions.DataError):
-            r.sort('a', groups=True)
+            r.sort("a", groups=True)
 
     @pytest.mark.onlynoncluster
     def test_sort_groups_three_gets(self, r):
-        r['user:1'] = 'u1'
-        r['user:2'] = 'u2'
-        r['user:3'] = 'u3'
-        r['door:1'] = 'd1'
-        r['door:2'] = 'd2'
-        r['door:3'] = 'd3'
-        r.rpush('a', '2', '3', '1')
-        assert r.sort('a', get=('user:*', 'door:*', '#'), groups=True) == \
-               [
-                   (b'u1', b'd1', b'1'),
-                   (b'u2', b'd2', b'2'),
-                   (b'u3', b'd3', b'3')
-               ]
+        r["user:1"] = "u1"
+        r["user:2"] = "u2"
+        r["user:3"] = "u3"
+        r["door:1"] = "d1"
+        r["door:2"] = "d2"
+        r["door:3"] = "d3"
+        r.rpush("a", "2", "3", "1")
+        assert r.sort("a", get=("user:*", "door:*", "#"), groups=True) == [
+            (b"u1", b"d1", b"1"),
+            (b"u2", b"d2", b"2"),
+            (b"u3", b"d3", b"3"),
+        ]
 
     def test_sort_desc(self, r):
-        r.rpush('a', '2', '3', '1')
-        assert r.sort('a', desc=True) == [b'3', b'2', b'1']
+        r.rpush("a", "2", "3", "1")
+        assert r.sort("a", desc=True) == [b"3", b"2", b"1"]
 
     def test_sort_alpha(self, r):
-        r.rpush('a', 'e', 'c', 'b', 'd', 'a')
-        assert r.sort('a', alpha=True) == \
-               [b'a', b'b', b'c', b'd', b'e']
+        r.rpush("a", "e", "c", "b", "d", "a")
+        assert r.sort("a", alpha=True) == [b"a", b"b", b"c", b"d", b"e"]
 
     @pytest.mark.onlynoncluster
     def test_sort_store(self, r):
-        r.rpush('a', '2', '3', '1')
-        assert r.sort('a', store='sorted_values') == 3
-        assert r.lrange('sorted_values', 0, -1) == [b'1', b'2', b'3']
+        r.rpush("a", "2", "3", "1")
+        assert r.sort("a", store="sorted_values") == 3
+        assert r.lrange("sorted_values", 0, -1) == [b"1", b"2", b"3"]
 
     @pytest.mark.onlynoncluster
     def test_sort_all_options(self, r):
-        r['user:1:username'] = 'zeus'
-        r['user:2:username'] = 'titan'
-        r['user:3:username'] = 'hermes'
-        r['user:4:username'] = 'hercules'
-        r['user:5:username'] = 'apollo'
-        r['user:6:username'] = 'athena'
-        r['user:7:username'] = 'hades'
-        r['user:8:username'] = 'dionysus'
-
-        r['user:1:favorite_drink'] = 'yuengling'
-        r['user:2:favorite_drink'] = 'rum'
-        r['user:3:favorite_drink'] = 'vodka'
-        r['user:4:favorite_drink'] = 'milk'
-        r['user:5:favorite_drink'] = 'pinot noir'
-        r['user:6:favorite_drink'] = 'water'
-        r['user:7:favorite_drink'] = 'gin'
-        r['user:8:favorite_drink'] = 'apple juice'
-
-        r.rpush('gods', '5', '8', '3', '1', '2', '7', '6', '4')
-        num = r.sort('gods', start=2, num=4, by='user:*:username',
-                     get='user:*:favorite_drink', desc=True, alpha=True,
-                     store='sorted')
+        r["user:1:username"] = "zeus"
+        r["user:2:username"] = "titan"
+        r["user:3:username"] = "hermes"
+        r["user:4:username"] = "hercules"
+        r["user:5:username"] = "apollo"
+        r["user:6:username"] = "athena"
+        r["user:7:username"] = "hades"
+        r["user:8:username"] = "dionysus"
+
+        r["user:1:favorite_drink"] = "yuengling"
+        r["user:2:favorite_drink"] = "rum"
+        r["user:3:favorite_drink"] = "vodka"
+        r["user:4:favorite_drink"] = "milk"
+        r["user:5:favorite_drink"] = "pinot noir"
+        r["user:6:favorite_drink"] = "water"
+        r["user:7:favorite_drink"] = "gin"
+        r["user:8:favorite_drink"] = "apple juice"
+
+        r.rpush("gods", "5", "8", "3", "1", "2", "7", "6", "4")
+        num = r.sort(
+            "gods",
+            start=2,
+            num=4,
+            by="user:*:username",
+            get="user:*:favorite_drink",
+            desc=True,
+            alpha=True,
+            store="sorted",
+        )
         assert num == 4
-        assert r.lrange('sorted', 0, 10) == \
-               [b'vodka', b'milk', b'gin', b'apple juice']
+        assert r.lrange("sorted", 0, 10) == [b"vodka", b"milk", b"gin", b"apple juice"]
 
     def test_sort_issue_924(self, r):
         # Tests for issue https://github.com/andymccurdy/redis-py/issues/924
-        r.execute_command('SADD', 'issue#924', 1)
-        r.execute_command('SORT', 'issue#924')
+        r.execute_command("SADD", "issue#924", 1)
+        r.execute_command("SORT", "issue#924")
 
     @pytest.mark.onlynoncluster
     def test_cluster_addslots(self, mock_cluster_resp_ok):
-        assert mock_cluster_resp_ok.cluster('ADDSLOTS', 1) is True
+        assert mock_cluster_resp_ok.cluster("ADDSLOTS", 1) is True
 
     @pytest.mark.onlynoncluster
     def test_cluster_count_failure_reports(self, mock_cluster_resp_int):
-        assert isinstance(mock_cluster_resp_int.cluster(
-            'COUNT-FAILURE-REPORTS', 'node'), int)
+        assert isinstance(
+            mock_cluster_resp_int.cluster("COUNT-FAILURE-REPORTS", "node"), int
+        )
 
     @pytest.mark.onlynoncluster
     def test_cluster_countkeysinslot(self, mock_cluster_resp_int):
-        assert isinstance(mock_cluster_resp_int.cluster(
-            'COUNTKEYSINSLOT', 2), int)
+        assert isinstance(mock_cluster_resp_int.cluster("COUNTKEYSINSLOT", 2), int)
 
     @pytest.mark.onlynoncluster
     def test_cluster_delslots(self, mock_cluster_resp_ok):
-        assert mock_cluster_resp_ok.cluster('DELSLOTS', 1) is True
+        assert mock_cluster_resp_ok.cluster("DELSLOTS", 1) is True
 
     @pytest.mark.onlynoncluster
     def test_cluster_failover(self, mock_cluster_resp_ok):
-        assert mock_cluster_resp_ok.cluster('FAILOVER', 1) is True
+        assert mock_cluster_resp_ok.cluster("FAILOVER", 1) is True
 
     @pytest.mark.onlynoncluster
     def test_cluster_forget(self, mock_cluster_resp_ok):
-        assert mock_cluster_resp_ok.cluster('FORGET', 1) is True
+        assert mock_cluster_resp_ok.cluster("FORGET", 1) is True
 
     @pytest.mark.onlynoncluster
     def test_cluster_info(self, mock_cluster_resp_info):
-        assert isinstance(mock_cluster_resp_info.cluster('info'), dict)
+        assert isinstance(mock_cluster_resp_info.cluster("info"), dict)
 
     @pytest.mark.onlynoncluster
     def test_cluster_keyslot(self, mock_cluster_resp_int):
-        assert isinstance(mock_cluster_resp_int.cluster(
-            'keyslot', 'asdf'), int)
+        assert isinstance(mock_cluster_resp_int.cluster("keyslot", "asdf"), int)
 
     @pytest.mark.onlynoncluster
     def test_cluster_meet(self, mock_cluster_resp_ok):
-        assert mock_cluster_resp_ok.cluster('meet', 'ip', 'port', 1) is True
+        assert mock_cluster_resp_ok.cluster("meet", "ip", "port", 1) is True
 
     @pytest.mark.onlynoncluster
     def test_cluster_nodes(self, mock_cluster_resp_nodes):
-        assert isinstance(mock_cluster_resp_nodes.cluster('nodes'), dict)
+        assert isinstance(mock_cluster_resp_nodes.cluster("nodes"), dict)
 
     @pytest.mark.onlynoncluster
     def test_cluster_replicate(self, mock_cluster_resp_ok):
-        assert mock_cluster_resp_ok.cluster('replicate', 'nodeid') is True
+        assert mock_cluster_resp_ok.cluster("replicate", "nodeid") is True
 
     @pytest.mark.onlynoncluster
     def test_cluster_reset(self, mock_cluster_resp_ok):
-        assert mock_cluster_resp_ok.cluster('reset', 'hard') is True
+        assert mock_cluster_resp_ok.cluster("reset", "hard") is True
 
     @pytest.mark.onlynoncluster
     def test_cluster_saveconfig(self, mock_cluster_resp_ok):
-        assert mock_cluster_resp_ok.cluster('saveconfig') is True
+        assert mock_cluster_resp_ok.cluster("saveconfig") is True
 
     @pytest.mark.onlynoncluster
     def test_cluster_setslot(self, mock_cluster_resp_ok):
-        assert mock_cluster_resp_ok.cluster('setslot', 1,
-                                            'IMPORTING', 'nodeid') is True
+        assert mock_cluster_resp_ok.cluster("setslot", 1, "IMPORTING", "nodeid") is True
 
     @pytest.mark.onlynoncluster
     def test_cluster_slaves(self, mock_cluster_resp_slaves):
-        assert isinstance(mock_cluster_resp_slaves.cluster(
-            'slaves', 'nodeid'), dict)
+        assert isinstance(mock_cluster_resp_slaves.cluster("slaves", "nodeid"), dict)
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('3.0.0')
+    @skip_if_server_version_lt("3.0.0")
     @skip_if_redis_enterprise
     def test_readwrite(self, r):
         assert r.readwrite()
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('3.0.0')
+    @skip_if_server_version_lt("3.0.0")
     def test_readonly_invalid_cluster_state(self, r):
         with pytest.raises(exceptions.RedisError):
             r.readonly()
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('3.0.0')
+    @skip_if_server_version_lt("3.0.0")
     def test_readonly(self, mock_cluster_resp_ok):
         assert mock_cluster_resp_ok.readonly() is True
 
     # GEO COMMANDS
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt("3.2.0")
     def test_geoadd(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
-        assert r.geoadd('barcelona', values) == 2
-        assert r.zcard('barcelona') == 2
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+        assert r.geoadd("barcelona", values) == 2
+        assert r.zcard("barcelona") == 2
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_geoadd_nx(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
-        assert r.geoadd('a', values) == 2
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2') + \
-                 (2.1804738294738, 41.405647879212, 'place3')
-        assert r.geoadd('a', values, nx=True) == 1
-        assert r.zrange('a', 0, -1) == [b'place3', b'place2', b'place1']
-
-    @skip_if_server_version_lt('6.2.0')
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+        assert r.geoadd("a", values) == 2
+        values = (
+            (2.1909389952632, 41.433791470673, "place1")
+            + (2.1873744593677, 41.406342043777, "place2")
+            + (2.1804738294738, 41.405647879212, "place3")
+        )
+        assert r.geoadd("a", values, nx=True) == 1
+        assert r.zrange("a", 0, -1) == [b"place3", b"place2", b"place1"]
+
+    @skip_if_server_version_lt("6.2.0")
     def test_geoadd_xx(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1')
-        assert r.geoadd('a', values) == 1
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
-        assert r.geoadd('a', values, xx=True) == 0
-        assert r.zrange('a', 0, -1) == \
-               [b'place1']
-
-    @skip_if_server_version_lt('6.2.0')
+        values = (2.1909389952632, 41.433791470673, "place1")
+        assert r.geoadd("a", values) == 1
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+        assert r.geoadd("a", values, xx=True) == 0
+        assert r.zrange("a", 0, -1) == [b"place1"]
+
+    @skip_if_server_version_lt("6.2.0")
     def test_geoadd_ch(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1')
-        assert r.geoadd('a', values) == 1
-        values = (2.1909389952632, 31.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
-        assert r.geoadd('a', values, ch=True) == 2
-        assert r.zrange('a', 0, -1) == \
-               [b'place1', b'place2']
-
-    @skip_if_server_version_lt('3.2.0')
+        values = (2.1909389952632, 41.433791470673, "place1")
+        assert r.geoadd("a", values) == 1
+        values = (2.1909389952632, 31.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+        assert r.geoadd("a", values, ch=True) == 2
+        assert r.zrange("a", 0, -1) == [b"place1", b"place2"]
+
+    @skip_if_server_version_lt("3.2.0")
     def test_geoadd_invalid_params(self, r):
         with pytest.raises(exceptions.RedisError):
-            r.geoadd('barcelona', (1, 2))
+            r.geoadd("barcelona", (1, 2))
 
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt("3.2.0")
     def test_geodist(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
-        assert r.geoadd('barcelona', values) == 2
-        assert r.geodist('barcelona', 'place1', 'place2') == 3067.4157
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+        assert r.geoadd("barcelona", values) == 2
+        assert r.geodist("barcelona", "place1", "place2") == 3067.4157
 
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt("3.2.0")
     def test_geodist_units(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
-        r.geoadd('barcelona', values)
-        assert r.geodist('barcelona', 'place1', 'place2', 'km') == 3.0674
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+        r.geoadd("barcelona", values)
+        assert r.geodist("barcelona", "place1", "place2", "km") == 3.0674
 
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt("3.2.0")
     def test_geodist_missing_one_member(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1')
-        r.geoadd('barcelona', values)
-        assert r.geodist('barcelona', 'place1', 'missing_member', 'km') is None
+        values = (2.1909389952632, 41.433791470673, "place1")
+        r.geoadd("barcelona", values)
+        assert r.geodist("barcelona", "place1", "missing_member", "km") is None
 
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt("3.2.0")
     def test_geodist_invalid_units(self, r):
         with pytest.raises(exceptions.RedisError):
-            assert r.geodist('x', 'y', 'z', 'inches')
+            assert r.geodist("x", "y", "z", "inches")
 
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt("3.2.0")
     def test_geohash(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
-        r.geoadd('barcelona', values)
-        assert r.geohash('barcelona', 'place1', 'place2', 'place3') == \
-               ['sp3e9yg3kd0', 'sp3e9cbc3t0', None]
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+        r.geoadd("barcelona", values)
+        assert r.geohash("barcelona", "place1", "place2", "place3") == [
+            "sp3e9yg3kd0",
+            "sp3e9cbc3t0",
+            None,
+        ]
 
     @skip_unless_arch_bits(64)
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt("3.2.0")
     def test_geopos(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
-        r.geoadd('barcelona', values)
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+        r.geoadd("barcelona", values)
         # redis uses 52 bits precision, hereby small errors may be introduced.
-        assert r.geopos('barcelona', 'place1', 'place2') == \
-               [(2.19093829393386841, 41.43379028184083523),
-                (2.18737632036209106, 41.40634178640635099)]
+        assert r.geopos("barcelona", "place1", "place2") == [
+            (2.19093829393386841, 41.43379028184083523),
+            (2.18737632036209106, 41.40634178640635099),
+        ]
 
-    @skip_if_server_version_lt('4.0.0')
+    @skip_if_server_version_lt("4.0.0")
     def test_geopos_no_value(self, r):
-        assert r.geopos('barcelona', 'place1', 'place2') == [None, None]
+        assert r.geopos("barcelona", "place1", "place2") == [None, None]
 
-    @skip_if_server_version_lt('3.2.0')
-    @skip_if_server_version_gte('4.0.0')
+    @skip_if_server_version_lt("3.2.0")
+    @skip_if_server_version_gte("4.0.0")
     def test_old_geopos_no_value(self, r):
-        assert r.geopos('barcelona', 'place1', 'place2') == []
+        assert r.geopos("barcelona", "place1", "place2") == []
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_geosearch(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, b'\x80place2') + \
-                 (2.583333, 41.316667, 'place3')
-        r.geoadd('barcelona', values)
-        assert r.geosearch('barcelona', longitude=2.191,
-                           latitude=41.433, radius=1000) == [b'place1']
-        assert r.geosearch('barcelona', longitude=2.187,
-                           latitude=41.406, radius=1000) == [b'\x80place2']
-        assert r.geosearch('barcelona', longitude=2.191, latitude=41.433,
-                           height=1000, width=1000) == [b'place1']
-        assert r.geosearch('barcelona', member='place3', radius=100,
-                           unit='km') == [b'\x80place2', b'place1', b'place3']
+        values = (
+            (2.1909389952632, 41.433791470673, "place1")
+            + (2.1873744593677, 41.406342043777, b"\x80place2")
+            + (2.583333, 41.316667, "place3")
+        )
+        r.geoadd("barcelona", values)
+        assert r.geosearch(
+            "barcelona", longitude=2.191, latitude=41.433, radius=1000
+        ) == [b"place1"]
+        assert r.geosearch(
+            "barcelona", longitude=2.187, latitude=41.406, radius=1000
+        ) == [b"\x80place2"]
+        assert r.geosearch(
+            "barcelona", longitude=2.191, latitude=41.433, height=1000, width=1000
+        ) == [b"place1"]
+        assert r.geosearch("barcelona", member="place3", radius=100, unit="km") == [
+            b"\x80place2",
+            b"place1",
+            b"place3",
+        ]
         # test count
-        assert r.geosearch('barcelona', member='place3', radius=100,
-                           unit='km', count=2) == [b'place3', b'\x80place2']
-        assert r.geosearch('barcelona', member='place3', radius=100,
-                           unit='km', count=1, any=1)[0] \
-               in [b'place1', b'place3', b'\x80place2']
+        assert r.geosearch(
+            "barcelona", member="place3", radius=100, unit="km", count=2
+        ) == [b"place3", b"\x80place2"]
+        assert r.geosearch(
+            "barcelona", member="place3", radius=100, unit="km", count=1, any=1
+        )[0] in [b"place1", b"place3", b"\x80place2"]
 
     @skip_unless_arch_bits(64)
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_geosearch_member(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, b'\x80place2')
-
-        r.geoadd('barcelona', values)
-        assert r.geosearch('barcelona', member='place1', radius=4000) == \
-               [b'\x80place2', b'place1']
-        assert r.geosearch('barcelona', member='place1', radius=10) == \
-               [b'place1']
-
-        assert r.geosearch('barcelona', member='place1', radius=4000,
-                           withdist=True,
-                           withcoord=True,
-                           withhash=True) == \
-               [[b'\x80place2', 3067.4157, 3471609625421029,
-                 (2.187376320362091, 41.40634178640635)],
-               [b'place1', 0.0, 3471609698139488,
-                (2.1909382939338684, 41.433790281840835)]]
-
-    @skip_if_server_version_lt('6.2.0')
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            b"\x80place2",
+        )
+
+        r.geoadd("barcelona", values)
+        assert r.geosearch("barcelona", member="place1", radius=4000) == [
+            b"\x80place2",
+            b"place1",
+        ]
+        assert r.geosearch("barcelona", member="place1", radius=10) == [b"place1"]
+
+        assert r.geosearch(
+            "barcelona",
+            member="place1",
+            radius=4000,
+            withdist=True,
+            withcoord=True,
+            withhash=True,
+        ) == [
+            [
+                b"\x80place2",
+                3067.4157,
+                3471609625421029,
+                (2.187376320362091, 41.40634178640635),
+            ],
+            [
+                b"place1",
+                0.0,
+                3471609698139488,
+                (2.1909382939338684, 41.433790281840835),
+            ],
+        ]
+
+    @skip_if_server_version_lt("6.2.0")
     def test_geosearch_sort(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
-        r.geoadd('barcelona', values)
-        assert r.geosearch('barcelona', longitude=2.191,
-                           latitude=41.433, radius=3000, sort='ASC') == \
-               [b'place1', b'place2']
-        assert r.geosearch('barcelona', longitude=2.191,
-                           latitude=41.433, radius=3000, sort='DESC') == \
-               [b'place2', b'place1']
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+        r.geoadd("barcelona", values)
+        assert r.geosearch(
+            "barcelona", longitude=2.191, latitude=41.433, radius=3000, sort="ASC"
+        ) == [b"place1", b"place2"]
+        assert r.geosearch(
+            "barcelona", longitude=2.191, latitude=41.433, radius=3000, sort="DESC"
+        ) == [b"place2", b"place1"]
 
     @skip_unless_arch_bits(64)
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_geosearch_with(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
-        r.geoadd('barcelona', values)
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+        r.geoadd("barcelona", values)
 
         # test a bunch of combinations to test the parse response
         # function.
-        assert r.geosearch('barcelona', longitude=2.191, latitude=41.433,
-                           radius=1, unit='km', withdist=True,
-                           withcoord=True, withhash=True) == \
-               [[b'place1', 0.0881, 3471609698139488,
-                 (2.19093829393386841, 41.43379028184083523)]]
-        assert r.geosearch('barcelona', longitude=2.191, latitude=41.433,
-                           radius=1, unit='km',
-                           withdist=True, withcoord=True) == \
-               [[b'place1', 0.0881,
-                 (2.19093829393386841, 41.43379028184083523)]]
-        assert r.geosearch('barcelona', longitude=2.191, latitude=41.433,
-                           radius=1, unit='km',
-                           withhash=True, withcoord=True) == \
-               [[b'place1', 3471609698139488,
-                 (2.19093829393386841, 41.43379028184083523)]]
+        assert r.geosearch(
+            "barcelona",
+            longitude=2.191,
+            latitude=41.433,
+            radius=1,
+            unit="km",
+            withdist=True,
+            withcoord=True,
+            withhash=True,
+        ) == [
+            [
+                b"place1",
+                0.0881,
+                3471609698139488,
+                (2.19093829393386841, 41.43379028184083523),
+            ]
+        ]
+        assert (
+            r.geosearch(
+                "barcelona",
+                longitude=2.191,
+                latitude=41.433,
+                radius=1,
+                unit="km",
+                withdist=True,
+                withcoord=True,
+            )
+            == [[b"place1", 0.0881, (2.19093829393386841, 41.43379028184083523)]]
+        )
+        assert r.geosearch(
+            "barcelona",
+            longitude=2.191,
+            latitude=41.433,
+            radius=1,
+            unit="km",
+            withhash=True,
+            withcoord=True,
+        ) == [
+            [b"place1", 3471609698139488, (2.19093829393386841, 41.43379028184083523)]
+        ]
         # test no values.
-        assert r.geosearch('barcelona', longitude=2, latitude=1,
-                           radius=1, unit='km', withdist=True,
-                           withcoord=True, withhash=True) == []
+        assert (
+            r.geosearch(
+                "barcelona",
+                longitude=2,
+                latitude=1,
+                radius=1,
+                unit="km",
+                withdist=True,
+                withcoord=True,
+                withhash=True,
+            )
+            == []
+        )
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_geosearch_negative(self, r):
         # not specifying member nor longitude and latitude
         with pytest.raises(exceptions.DataError):
-            assert r.geosearch('barcelona')
+            assert r.geosearch("barcelona")
         # specifying member and longitude and latitude
         with pytest.raises(exceptions.DataError):
-            assert r.geosearch('barcelona',
-                               member="Paris", longitude=2, latitude=1)
+            assert r.geosearch("barcelona", member="Paris", longitude=2, latitude=1)
         # specifying one of longitude and latitude
         with pytest.raises(exceptions.DataError):
-            assert r.geosearch('barcelona', longitude=2)
+            assert r.geosearch("barcelona", longitude=2)
         with pytest.raises(exceptions.DataError):
-            assert r.geosearch('barcelona', latitude=2)
+            assert r.geosearch("barcelona", latitude=2)
 
         # not specifying radius nor width and height
         with pytest.raises(exceptions.DataError):
-            assert r.geosearch('barcelona', member="Paris")
+            assert r.geosearch("barcelona", member="Paris")
         # specifying radius and width and height
         with pytest.raises(exceptions.DataError):
-            assert r.geosearch('barcelona', member="Paris",
-                               radius=3, width=2, height=1)
+            assert r.geosearch("barcelona", member="Paris", radius=3, width=2, height=1)
         # specifying one of width and height
         with pytest.raises(exceptions.DataError):
-            assert r.geosearch('barcelona', member="Paris", width=2)
+            assert r.geosearch("barcelona", member="Paris", width=2)
         with pytest.raises(exceptions.DataError):
-            assert r.geosearch('barcelona', member="Paris", height=2)
+            assert r.geosearch("barcelona", member="Paris", height=2)
 
         # invalid sort
         with pytest.raises(exceptions.DataError):
-            assert r.geosearch('barcelona',
-                               member="Paris", width=2, height=2, sort="wrong")
+            assert r.geosearch(
+                "barcelona", member="Paris", width=2, height=2, sort="wrong"
+            )
 
         # invalid unit
         with pytest.raises(exceptions.DataError):
-            assert r.geosearch('barcelona',
-                               member="Paris", width=2, height=2, unit="miles")
+            assert r.geosearch(
+                "barcelona", member="Paris", width=2, height=2, unit="miles"
+            )
 
         # use any without count
         with pytest.raises(exceptions.DataError):
-            assert r.geosearch('barcelona', member='place3', radius=100, any=1)
+            assert r.geosearch("barcelona", member="place3", radius=100, any=1)
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_geosearchstore(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
 
-        r.geoadd('barcelona', values)
-        r.geosearchstore('places_barcelona', 'barcelona',
-                         longitude=2.191, latitude=41.433, radius=1000)
-        assert r.zrange('places_barcelona', 0, -1) == [b'place1']
+        r.geoadd("barcelona", values)
+        r.geosearchstore(
+            "places_barcelona",
+            "barcelona",
+            longitude=2.191,
+            latitude=41.433,
+            radius=1000,
+        )
+        assert r.zrange("places_barcelona", 0, -1) == [b"place1"]
 
     @pytest.mark.onlynoncluster
     @skip_unless_arch_bits(64)
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_geosearchstore_dist(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
 
-        r.geoadd('barcelona', values)
-        r.geosearchstore('places_barcelona', 'barcelona',
-                         longitude=2.191, latitude=41.433,
-                         radius=1000, storedist=True)
+        r.geoadd("barcelona", values)
+        r.geosearchstore(
+            "places_barcelona",
+            "barcelona",
+            longitude=2.191,
+            latitude=41.433,
+            radius=1000,
+            storedist=True,
+        )
         # instead of save the geo score, the distance is saved.
-        assert r.zscore('places_barcelona', 'place1') == 88.05060698409301
+        assert r.zscore("places_barcelona", "place1") == 88.05060698409301
 
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt("3.2.0")
     def test_georadius(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, b'\x80place2')
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            b"\x80place2",
+        )
 
-        r.geoadd('barcelona', values)
-        assert r.georadius('barcelona', 2.191, 41.433, 1000) == [b'place1']
-        assert r.georadius('barcelona', 2.187, 41.406, 1000) == [b'\x80place2']
+        r.geoadd("barcelona", values)
+        assert r.georadius("barcelona", 2.191, 41.433, 1000) == [b"place1"]
+        assert r.georadius("barcelona", 2.187, 41.406, 1000) == [b"\x80place2"]
 
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt("3.2.0")
     def test_georadius_no_values(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
 
-        r.geoadd('barcelona', values)
-        assert r.georadius('barcelona', 1, 2, 1000) == []
+        r.geoadd("barcelona", values)
+        assert r.georadius("barcelona", 1, 2, 1000) == []
 
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt("3.2.0")
     def test_georadius_units(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
 
-        r.geoadd('barcelona', values)
-        assert r.georadius('barcelona', 2.191, 41.433, 1, unit='km') == \
-               [b'place1']
+        r.geoadd("barcelona", values)
+        assert r.georadius("barcelona", 2.191, 41.433, 1, unit="km") == [b"place1"]
 
     @skip_unless_arch_bits(64)
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt("3.2.0")
     def test_georadius_with(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
 
-        r.geoadd('barcelona', values)
+        r.geoadd("barcelona", values)
 
         # test a bunch of combinations to test the parse response
         # function.
-        assert r.georadius('barcelona', 2.191, 41.433, 1, unit='km',
-                           withdist=True, withcoord=True, withhash=True) == \
-               [[b'place1', 0.0881, 3471609698139488,
-                 (2.19093829393386841, 41.43379028184083523)]]
+        assert r.georadius(
+            "barcelona",
+            2.191,
+            41.433,
+            1,
+            unit="km",
+            withdist=True,
+            withcoord=True,
+            withhash=True,
+        ) == [
+            [
+                b"place1",
+                0.0881,
+                3471609698139488,
+                (2.19093829393386841, 41.43379028184083523),
+            ]
+        ]
 
-        assert r.georadius('barcelona', 2.191, 41.433, 1, unit='km',
-                           withdist=True, withcoord=True) == \
-               [[b'place1', 0.0881,
-                 (2.19093829393386841, 41.43379028184083523)]]
+        assert r.georadius(
+            "barcelona", 2.191, 41.433, 1, unit="km", withdist=True, withcoord=True
+        ) == [[b"place1", 0.0881, (2.19093829393386841, 41.43379028184083523)]]
 
-        assert r.georadius('barcelona', 2.191, 41.433, 1, unit='km',
-                           withhash=True, withcoord=True) == \
-               [[b'place1', 3471609698139488,
-                 (2.19093829393386841, 41.43379028184083523)]]
+        assert r.georadius(
+            "barcelona", 2.191, 41.433, 1, unit="km", withhash=True, withcoord=True
+        ) == [
+            [b"place1", 3471609698139488, (2.19093829393386841, 41.43379028184083523)]
+        ]
 
         # test no values.
-        assert r.georadius('barcelona', 2, 1, 1, unit='km',
-                           withdist=True, withcoord=True, withhash=True) == []
+        assert (
+            r.georadius(
+                "barcelona",
+                2,
+                1,
+                1,
+                unit="km",
+                withdist=True,
+                withcoord=True,
+                withhash=True,
+            )
+            == []
+        )
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_georadius_count(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
 
-        r.geoadd('barcelona', values)
-        assert r.georadius('barcelona', 2.191, 41.433, 3000, count=1) == \
-               [b'place1']
-        assert r.georadius('barcelona', 2.191, 41.433, 3000,
-                           count=1, any=True) == \
-               [b'place2']
+        r.geoadd("barcelona", values)
+        assert r.georadius("barcelona", 2.191, 41.433, 3000, count=1) == [b"place1"]
+        assert r.georadius("barcelona", 2.191, 41.433, 3000, count=1, any=True) == [
+            b"place2"
+        ]
 
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt("3.2.0")
     def test_georadius_sort(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
 
-        r.geoadd('barcelona', values)
-        assert r.georadius('barcelona', 2.191, 41.433, 3000, sort='ASC') == \
-               [b'place1', b'place2']
-        assert r.georadius('barcelona', 2.191, 41.433, 3000, sort='DESC') == \
-               [b'place2', b'place1']
+        r.geoadd("barcelona", values)
+        assert r.georadius("barcelona", 2.191, 41.433, 3000, sort="ASC") == [
+            b"place1",
+            b"place2",
+        ]
+        assert r.georadius("barcelona", 2.191, 41.433, 3000, sort="DESC") == [
+            b"place2",
+            b"place1",
+        ]
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt("3.2.0")
     def test_georadius_store(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
 
-        r.geoadd('barcelona', values)
-        r.georadius('barcelona', 2.191, 41.433, 1000, store='places_barcelona')
-        assert r.zrange('places_barcelona', 0, -1) == [b'place1']
+        r.geoadd("barcelona", values)
+        r.georadius("barcelona", 2.191, 41.433, 1000, store="places_barcelona")
+        assert r.zrange("places_barcelona", 0, -1) == [b"place1"]
 
     @pytest.mark.onlynoncluster
     @skip_unless_arch_bits(64)
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt("3.2.0")
     def test_georadius_store_dist(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, 'place2')
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
 
-        r.geoadd('barcelona', values)
-        r.georadius('barcelona', 2.191, 41.433, 1000,
-                    store_dist='places_barcelona')
+        r.geoadd("barcelona", values)
+        r.georadius("barcelona", 2.191, 41.433, 1000, store_dist="places_barcelona")
         # instead of save the geo score, the distance is saved.
-        assert r.zscore('places_barcelona', 'place1') == 88.05060698409301
+        assert r.zscore("places_barcelona", "place1") == 88.05060698409301
 
     @skip_unless_arch_bits(64)
-    @skip_if_server_version_lt('3.2.0')
+    @skip_if_server_version_lt("3.2.0")
     def test_georadiusmember(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, b'\x80place2')
-
-        r.geoadd('barcelona', values)
-        assert r.georadiusbymember('barcelona', 'place1', 4000) == \
-               [b'\x80place2', b'place1']
-        assert r.georadiusbymember('barcelona', 'place1', 10) == [b'place1']
-
-        assert r.georadiusbymember('barcelona', 'place1', 4000,
-                                   withdist=True, withcoord=True,
-                                   withhash=True) == \
-               [[b'\x80place2', 3067.4157, 3471609625421029,
-                 (2.187376320362091, 41.40634178640635)],
-                [b'place1', 0.0, 3471609698139488,
-                 (2.1909382939338684, 41.433790281840835)]]
-
-    @skip_if_server_version_lt('6.2.0')
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            b"\x80place2",
+        )
+
+        r.geoadd("barcelona", values)
+        assert r.georadiusbymember("barcelona", "place1", 4000) == [
+            b"\x80place2",
+            b"place1",
+        ]
+        assert r.georadiusbymember("barcelona", "place1", 10) == [b"place1"]
+
+        assert r.georadiusbymember(
+            "barcelona", "place1", 4000, withdist=True, withcoord=True, withhash=True
+        ) == [
+            [
+                b"\x80place2",
+                3067.4157,
+                3471609625421029,
+                (2.187376320362091, 41.40634178640635),
+            ],
+            [
+                b"place1",
+                0.0,
+                3471609698139488,
+                (2.1909382939338684, 41.433790281840835),
+            ],
+        ]
+
+    @skip_if_server_version_lt("6.2.0")
     def test_georadiusmember_count(self, r):
-        values = (2.1909389952632, 41.433791470673, 'place1') + \
-                 (2.1873744593677, 41.406342043777, b'\x80place2')
-        r.geoadd('barcelona', values)
-        assert r.georadiusbymember('barcelona', 'place1', 4000,
-                                   count=1, any=True) == \
-               [b'\x80place2']
-
-    @skip_if_server_version_lt('5.0.0')
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            b"\x80place2",
+        )
+        r.geoadd("barcelona", values)
+        assert r.georadiusbymember("barcelona", "place1", 4000, count=1, any=True) == [
+            b"\x80place2"
+        ]
+
+    @skip_if_server_version_lt("5.0.0")
     def test_xack(self, r):
-        stream = 'stream'
-        group = 'group'
-        consumer = 'consumer'
+        stream = "stream"
+        group = "group"
+        consumer = "consumer"
         # xack on a stream that doesn't exist
-        assert r.xack(stream, group, '0-0') == 0
+        assert r.xack(stream, group, "0-0") == 0
 
-        m1 = r.xadd(stream, {'one': 'one'})
-        m2 = r.xadd(stream, {'two': 'two'})
-        m3 = r.xadd(stream, {'three': 'three'})
+        m1 = r.xadd(stream, {"one": "one"})
+        m2 = r.xadd(stream, {"two": "two"})
+        m3 = r.xadd(stream, {"three": "three"})
 
         # xack on a group that doesn't exist
         assert r.xack(stream, group, m1) == 0
 
         r.xgroup_create(stream, group, 0)
-        r.xreadgroup(group, consumer, streams={stream: '>'})
+        r.xreadgroup(group, consumer, streams={stream: ">"})
         # xack returns the number of ack'd elements
         assert r.xack(stream, group, m1) == 1
         assert r.xack(stream, group, m2, m3) == 2
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_xadd(self, r):
-        stream = 'stream'
-        message_id = r.xadd(stream, {'foo': 'bar'})
-        assert re.match(br'[0-9]+\-[0-9]+', message_id)
+        stream = "stream"
+        message_id = r.xadd(stream, {"foo": "bar"})
+        assert re.match(br"[0-9]+\-[0-9]+", message_id)
 
         # explicit message id
-        message_id = b'9999999999999999999-0'
-        assert message_id == r.xadd(stream, {'foo': 'bar'}, id=message_id)
+        message_id = b"9999999999999999999-0"
+        assert message_id == r.xadd(stream, {"foo": "bar"}, id=message_id)
 
         # with maxlen, the list evicts the first message
-        r.xadd(stream, {'foo': 'bar'}, maxlen=2, approximate=False)
+        r.xadd(stream, {"foo": "bar"}, maxlen=2, approximate=False)
         assert r.xlen(stream) == 2
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_xadd_nomkstream(self, r):
         # nomkstream option
-        stream = 'stream'
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'some': 'other'}, nomkstream=False)
+        stream = "stream"
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"some": "other"}, nomkstream=False)
         assert r.xlen(stream) == 2
-        r.xadd(stream, {'some': 'other'}, nomkstream=True)
+        r.xadd(stream, {"some": "other"}, nomkstream=True)
         assert r.xlen(stream) == 3
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_xadd_minlen_and_limit(self, r):
-        stream = 'stream'
+        stream = "stream"
 
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
 
         # Future self: No limits without approximate, according to the api
         with pytest.raises(redis.ResponseError):
-            assert r.xadd(stream, {'foo': 'bar'}, maxlen=3,
-                          approximate=False, limit=2)
+            assert r.xadd(stream, {"foo": "bar"}, maxlen=3, approximate=False, limit=2)
 
         # limit can not be provided without maxlen or minid
         with pytest.raises(redis.ResponseError):
-            assert r.xadd(stream, {'foo': 'bar'}, limit=2)
+            assert r.xadd(stream, {"foo": "bar"}, limit=2)
 
         # maxlen with a limit
-        assert r.xadd(stream, {'foo': 'bar'}, maxlen=3,
-                      approximate=True, limit=2)
+        assert r.xadd(stream, {"foo": "bar"}, maxlen=3, approximate=True, limit=2)
         r.delete(stream)
 
         # maxlen and minid can not be provided together
         with pytest.raises(redis.DataError):
-            assert r.xadd(stream, {'foo': 'bar'}, maxlen=3,
-                          minid="sometestvalue")
+            assert r.xadd(stream, {"foo": "bar"}, maxlen=3, minid="sometestvalue")
 
         # minid with a limit
-        m1 = r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
-        assert r.xadd(stream, {'foo': 'bar'}, approximate=True,
-                      minid=m1, limit=3)
+        m1 = r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+        assert r.xadd(stream, {"foo": "bar"}, approximate=True, minid=m1, limit=3)
 
         # pure minid
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
-        m4 = r.xadd(stream, {'foo': 'bar'})
-        assert r.xadd(stream, {'foo': 'bar'}, approximate=False, minid=m4)
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+        m4 = r.xadd(stream, {"foo": "bar"})
+        assert r.xadd(stream, {"foo": "bar"}, approximate=False, minid=m4)
 
         # minid approximate
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
-        m3 = r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
-        assert r.xadd(stream, {'foo': 'bar'}, approximate=True, minid=m3)
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+        m3 = r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+        assert r.xadd(stream, {"foo": "bar"}, approximate=True, minid=m3)
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_xautoclaim(self, r):
-        stream = 'stream'
-        group = 'group'
-        consumer1 = 'consumer1'
-        consumer2 = 'consumer2'
+        stream = "stream"
+        group = "group"
+        consumer1 = "consumer1"
+        consumer2 = "consumer2"
 
-        message_id1 = r.xadd(stream, {'john': 'wick'})
-        message_id2 = r.xadd(stream, {'johny': 'deff'})
+        message_id1 = r.xadd(stream, {"john": "wick"})
+        message_id2 = r.xadd(stream, {"johny": "deff"})
         message = get_stream_message(r, stream, message_id1)
         r.xgroup_create(stream, group, 0)
 
@@ -3084,70 +3348,78 @@ def test_xautoclaim(self, r):
         assert response == []
 
         # read the group as consumer1 to initially claim the messages
-        r.xreadgroup(group, consumer1, streams={stream: '>'})
+        r.xreadgroup(group, consumer1, streams={stream: ">"})
 
         # claim one message as consumer2
-        response = r.xautoclaim(stream, group, consumer2,
-                                min_idle_time=0, count=1)
+        response = r.xautoclaim(stream, group, consumer2, min_idle_time=0, count=1)
         assert response == [message]
 
         # reclaim the messages as consumer1, but use the justid argument
         # which only returns message ids
-        assert r.xautoclaim(stream, group, consumer1, min_idle_time=0,
-                            start_id=0, justid=True) == \
-               [message_id1, message_id2]
-        assert r.xautoclaim(stream, group, consumer1, min_idle_time=0,
-                            start_id=message_id2, justid=True) == \
-               [message_id2]
-
-    @skip_if_server_version_lt('6.2.0')
+        assert r.xautoclaim(
+            stream, group, consumer1, min_idle_time=0, start_id=0, justid=True
+        ) == [message_id1, message_id2]
+        assert r.xautoclaim(
+            stream, group, consumer1, min_idle_time=0, start_id=message_id2, justid=True
+        ) == [message_id2]
+
+    @skip_if_server_version_lt("6.2.0")
     def test_xautoclaim_negative(self, r):
-        stream = 'stream'
-        group = 'group'
-        consumer = 'consumer'
+        stream = "stream"
+        group = "group"
+        consumer = "consumer"
         with pytest.raises(redis.DataError):
             r.xautoclaim(stream, group, consumer, min_idle_time=-1)
         with pytest.raises(ValueError):
             r.xautoclaim(stream, group, consumer, min_idle_time="wrong")
         with pytest.raises(redis.DataError):
-            r.xautoclaim(stream, group, consumer, min_idle_time=0,
-                         count=-1)
+            r.xautoclaim(stream, group, consumer, min_idle_time=0, count=-1)
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_xclaim(self, r):
-        stream = 'stream'
-        group = 'group'
-        consumer1 = 'consumer1'
-        consumer2 = 'consumer2'
-        message_id = r.xadd(stream, {'john': 'wick'})
+        stream = "stream"
+        group = "group"
+        consumer1 = "consumer1"
+        consumer2 = "consumer2"
+        message_id = r.xadd(stream, {"john": "wick"})
         message = get_stream_message(r, stream, message_id)
         r.xgroup_create(stream, group, 0)
 
         # trying to claim a message that isn't already pending doesn't
         # do anything
-        response = r.xclaim(stream, group, consumer2,
-                            min_idle_time=0, message_ids=(message_id,))
+        response = r.xclaim(
+            stream, group, consumer2, min_idle_time=0, message_ids=(message_id,)
+        )
         assert response == []
 
         # read the group as consumer1 to initially claim the messages
-        r.xreadgroup(group, consumer1, streams={stream: '>'})
+        r.xreadgroup(group, consumer1, streams={stream: ">"})
 
         # claim the message as consumer2
-        response = r.xclaim(stream, group, consumer2,
-                            min_idle_time=0, message_ids=(message_id,))
+        response = r.xclaim(
+            stream, group, consumer2, min_idle_time=0, message_ids=(message_id,)
+        )
         assert response[0] == message
 
         # reclaim the message as consumer1, but use the justid argument
         # which only returns message ids
-        assert r.xclaim(stream, group, consumer1,
-                        min_idle_time=0, message_ids=(message_id,),
-                        justid=True) == [message_id]
+        assert (
+            r.xclaim(
+                stream,
+                group,
+                consumer1,
+                min_idle_time=0,
+                message_ids=(message_id,),
+                justid=True,
+            )
+            == [message_id]
+        )
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_xclaim_trimmed(self, r):
         # xclaim should not raise an exception if the item is not there
-        stream = 'stream'
-        group = 'group'
+        stream = "stream"
+        group = "group"
 
         r.xgroup_create(stream, group, id="$", mkstream=True)
 
@@ -3156,57 +3428,59 @@ def test_xclaim_trimmed(self, r):
         sid2 = r.xadd(stream, {"item": 0})
 
         # read them from consumer1
-        r.xreadgroup(group, 'consumer1', {stream: ">"})
+        r.xreadgroup(group, "consumer1", {stream: ">"})
 
         # add a 3rd and trim the stream down to 2 items
         r.xadd(stream, {"item": 3}, maxlen=2, approximate=False)
 
         # xclaim them from consumer2
         # the item that is still in the stream should be returned
-        item = r.xclaim(stream, group, 'consumer2', 0, [sid1, sid2])
+        item = r.xclaim(stream, group, "consumer2", 0, [sid1, sid2])
         assert len(item) == 2
         assert item[0] == (None, None)
         assert item[1][0] == sid2
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_xdel(self, r):
-        stream = 'stream'
+        stream = "stream"
 
         # deleting from an empty stream doesn't do anything
         assert r.xdel(stream, 1) == 0
 
-        m1 = r.xadd(stream, {'foo': 'bar'})
-        m2 = r.xadd(stream, {'foo': 'bar'})
-        m3 = r.xadd(stream, {'foo': 'bar'})
+        m1 = r.xadd(stream, {"foo": "bar"})
+        m2 = r.xadd(stream, {"foo": "bar"})
+        m3 = r.xadd(stream, {"foo": "bar"})
 
         # xdel returns the number of deleted elements
         assert r.xdel(stream, m1) == 1
         assert r.xdel(stream, m2, m3) == 2
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_xgroup_create(self, r):
         # tests xgroup_create and xinfo_groups
-        stream = 'stream'
-        group = 'group'
-        r.xadd(stream, {'foo': 'bar'})
+        stream = "stream"
+        group = "group"
+        r.xadd(stream, {"foo": "bar"})
 
         # no group is setup yet, no info to obtain
         assert r.xinfo_groups(stream) == []
 
         assert r.xgroup_create(stream, group, 0)
-        expected = [{
-            'name': group.encode(),
-            'consumers': 0,
-            'pending': 0,
-            'last-delivered-id': b'0-0'
-        }]
+        expected = [
+            {
+                "name": group.encode(),
+                "consumers": 0,
+                "pending": 0,
+                "last-delivered-id": b"0-0",
+            }
+        ]
         assert r.xinfo_groups(stream) == expected
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_xgroup_create_mkstream(self, r):
         # tests xgroup_create and xinfo_groups
-        stream = 'stream'
-        group = 'group'
+        stream = "stream"
+        group = "group"
 
         # an error is raised if a group is created on a stream that
         # doesn't already exist
@@ -3216,53 +3490,55 @@ def test_xgroup_create_mkstream(self, r):
         # however, with mkstream=True, the underlying stream is created
         # automatically
         assert r.xgroup_create(stream, group, 0, mkstream=True)
-        expected = [{
-            'name': group.encode(),
-            'consumers': 0,
-            'pending': 0,
-            'last-delivered-id': b'0-0'
-        }]
+        expected = [
+            {
+                "name": group.encode(),
+                "consumers": 0,
+                "pending": 0,
+                "last-delivered-id": b"0-0",
+            }
+        ]
         assert r.xinfo_groups(stream) == expected
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_xgroup_delconsumer(self, r):
-        stream = 'stream'
-        group = 'group'
-        consumer = 'consumer'
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
+        stream = "stream"
+        group = "group"
+        consumer = "consumer"
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
         r.xgroup_create(stream, group, 0)
 
         # a consumer that hasn't yet read any messages doesn't do anything
         assert r.xgroup_delconsumer(stream, group, consumer) == 0
 
         # read all messages from the group
-        r.xreadgroup(group, consumer, streams={stream: '>'})
+        r.xreadgroup(group, consumer, streams={stream: ">"})
 
         # deleting the consumer should return 2 pending messages
         assert r.xgroup_delconsumer(stream, group, consumer) == 2
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_xgroup_createconsumer(self, r):
-        stream = 'stream'
-        group = 'group'
-        consumer = 'consumer'
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
+        stream = "stream"
+        group = "group"
+        consumer = "consumer"
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
         r.xgroup_create(stream, group, 0)
         assert r.xgroup_createconsumer(stream, group, consumer) == 1
 
         # read all messages from the group
-        r.xreadgroup(group, consumer, streams={stream: '>'})
+        r.xreadgroup(group, consumer, streams={stream: ">"})
 
         # deleting the consumer should return 2 pending messages
         assert r.xgroup_delconsumer(stream, group, consumer) == 2
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_xgroup_destroy(self, r):
-        stream = 'stream'
-        group = 'group'
-        r.xadd(stream, {'foo': 'bar'})
+        stream = "stream"
+        group = "group"
+        r.xadd(stream, {"foo": "bar"})
 
         # destroying a nonexistent group returns False
         assert not r.xgroup_destroy(stream, group)
@@ -3270,198 +3546,189 @@ def test_xgroup_destroy(self, r):
         r.xgroup_create(stream, group, 0)
         assert r.xgroup_destroy(stream, group)
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_xgroup_setid(self, r):
-        stream = 'stream'
-        group = 'group'
-        message_id = r.xadd(stream, {'foo': 'bar'})
+        stream = "stream"
+        group = "group"
+        message_id = r.xadd(stream, {"foo": "bar"})
 
         r.xgroup_create(stream, group, 0)
         # advance the last_delivered_id to the message_id
         r.xgroup_setid(stream, group, message_id)
-        expected = [{
-            'name': group.encode(),
-            'consumers': 0,
-            'pending': 0,
-            'last-delivered-id': message_id
-        }]
+        expected = [
+            {
+                "name": group.encode(),
+                "consumers": 0,
+                "pending": 0,
+                "last-delivered-id": message_id,
+            }
+        ]
         assert r.xinfo_groups(stream) == expected
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_xinfo_consumers(self, r):
-        stream = 'stream'
-        group = 'group'
-        consumer1 = 'consumer1'
-        consumer2 = 'consumer2'
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
+        stream = "stream"
+        group = "group"
+        consumer1 = "consumer1"
+        consumer2 = "consumer2"
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
 
         r.xgroup_create(stream, group, 0)
-        r.xreadgroup(group, consumer1, streams={stream: '>'}, count=1)
-        r.xreadgroup(group, consumer2, streams={stream: '>'})
+        r.xreadgroup(group, consumer1, streams={stream: ">"}, count=1)
+        r.xreadgroup(group, consumer2, streams={stream: ">"})
         info = r.xinfo_consumers(stream, group)
         assert len(info) == 2
         expected = [
-            {'name': consumer1.encode(), 'pending': 1},
-            {'name': consumer2.encode(), 'pending': 2},
+            {"name": consumer1.encode(), "pending": 1},
+            {"name": consumer2.encode(), "pending": 2},
         ]
 
         # we can't determine the idle time, so just make sure it's an int
-        assert isinstance(info[0].pop('idle'), int)
-        assert isinstance(info[1].pop('idle'), int)
+        assert isinstance(info[0].pop("idle"), int)
+        assert isinstance(info[1].pop("idle"), int)
         assert info == expected
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_xinfo_stream(self, r):
-        stream = 'stream'
-        m1 = r.xadd(stream, {'foo': 'bar'})
-        m2 = r.xadd(stream, {'foo': 'bar'})
+        stream = "stream"
+        m1 = r.xadd(stream, {"foo": "bar"})
+        m2 = r.xadd(stream, {"foo": "bar"})
         info = r.xinfo_stream(stream)
 
-        assert info['length'] == 2
-        assert info['first-entry'] == get_stream_message(r, stream, m1)
-        assert info['last-entry'] == get_stream_message(r, stream, m2)
+        assert info["length"] == 2
+        assert info["first-entry"] == get_stream_message(r, stream, m1)
+        assert info["last-entry"] == get_stream_message(r, stream, m2)
 
-    @skip_if_server_version_lt('6.0.0')
+    @skip_if_server_version_lt("6.0.0")
     def test_xinfo_stream_full(self, r):
-        stream = 'stream'
-        group = 'group'
-        m1 = r.xadd(stream, {'foo': 'bar'})
+        stream = "stream"
+        group = "group"
+        m1 = r.xadd(stream, {"foo": "bar"})
         r.xgroup_create(stream, group, 0)
         info = r.xinfo_stream(stream, full=True)
 
-        assert info['length'] == 1
-        assert m1 in info['entries']
-        assert len(info['groups']) == 1
+        assert info["length"] == 1
+        assert m1 in info["entries"]
+        assert len(info["groups"]) == 1
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_xlen(self, r):
-        stream = 'stream'
+        stream = "stream"
         assert r.xlen(stream) == 0
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
         assert r.xlen(stream) == 2
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_xpending(self, r):
-        stream = 'stream'
-        group = 'group'
-        consumer1 = 'consumer1'
-        consumer2 = 'consumer2'
-        m1 = r.xadd(stream, {'foo': 'bar'})
-        m2 = r.xadd(stream, {'foo': 'bar'})
+        stream = "stream"
+        group = "group"
+        consumer1 = "consumer1"
+        consumer2 = "consumer2"
+        m1 = r.xadd(stream, {"foo": "bar"})
+        m2 = r.xadd(stream, {"foo": "bar"})
         r.xgroup_create(stream, group, 0)
 
         # xpending on a group that has no consumers yet
-        expected = {
-            'pending': 0,
-            'min': None,
-            'max': None,
-            'consumers': []
-        }
+        expected = {"pending": 0, "min": None, "max": None, "consumers": []}
         assert r.xpending(stream, group) == expected
 
         # read 1 message from the group with each consumer
-        r.xreadgroup(group, consumer1, streams={stream: '>'}, count=1)
-        r.xreadgroup(group, consumer2, streams={stream: '>'}, count=1)
+        r.xreadgroup(group, consumer1, streams={stream: ">"}, count=1)
+        r.xreadgroup(group, consumer2, streams={stream: ">"}, count=1)
 
         expected = {
-            'pending': 2,
-            'min': m1,
-            'max': m2,
-            'consumers': [
-                {'name': consumer1.encode(), 'pending': 1},
-                {'name': consumer2.encode(), 'pending': 1},
-            ]
+            "pending": 2,
+            "min": m1,
+            "max": m2,
+            "consumers": [
+                {"name": consumer1.encode(), "pending": 1},
+                {"name": consumer2.encode(), "pending": 1},
+            ],
         }
         assert r.xpending(stream, group) == expected
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_xpending_range(self, r):
-        stream = 'stream'
-        group = 'group'
-        consumer1 = 'consumer1'
-        consumer2 = 'consumer2'
-        m1 = r.xadd(stream, {'foo': 'bar'})
-        m2 = r.xadd(stream, {'foo': 'bar'})
+        stream = "stream"
+        group = "group"
+        consumer1 = "consumer1"
+        consumer2 = "consumer2"
+        m1 = r.xadd(stream, {"foo": "bar"})
+        m2 = r.xadd(stream, {"foo": "bar"})
         r.xgroup_create(stream, group, 0)
 
         # xpending range on a group that has no consumers yet
-        assert r.xpending_range(stream, group, min='-', max='+', count=5) == []
+        assert r.xpending_range(stream, group, min="-", max="+", count=5) == []
 
         # read 1 message from the group with each consumer
-        r.xreadgroup(group, consumer1, streams={stream: '>'}, count=1)
-        r.xreadgroup(group, consumer2, streams={stream: '>'}, count=1)
+        r.xreadgroup(group, consumer1, streams={stream: ">"}, count=1)
+        r.xreadgroup(group, consumer2, streams={stream: ">"}, count=1)
 
-        response = r.xpending_range(stream, group,
-                                    min='-', max='+', count=5)
+        response = r.xpending_range(stream, group, min="-", max="+", count=5)
         assert len(response) == 2
-        assert response[0]['message_id'] == m1
-        assert response[0]['consumer'] == consumer1.encode()
-        assert response[1]['message_id'] == m2
-        assert response[1]['consumer'] == consumer2.encode()
+        assert response[0]["message_id"] == m1
+        assert response[0]["consumer"] == consumer1.encode()
+        assert response[1]["message_id"] == m2
+        assert response[1]["consumer"] == consumer2.encode()
 
         # test with consumer name
-        response = r.xpending_range(stream, group,
-                                    min='-', max='+', count=5,
-                                    consumername=consumer1)
-        assert response[0]['message_id'] == m1
-        assert response[0]['consumer'] == consumer1.encode()
+        response = r.xpending_range(
+            stream, group, min="-", max="+", count=5, consumername=consumer1
+        )
+        assert response[0]["message_id"] == m1
+        assert response[0]["consumer"] == consumer1.encode()
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_xpending_range_idle(self, r):
-        stream = 'stream'
-        group = 'group'
-        consumer1 = 'consumer1'
-        consumer2 = 'consumer2'
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
+        stream = "stream"
+        group = "group"
+        consumer1 = "consumer1"
+        consumer2 = "consumer2"
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
         r.xgroup_create(stream, group, 0)
 
         # read 1 message from the group with each consumer
-        r.xreadgroup(group, consumer1, streams={stream: '>'}, count=1)
-        r.xreadgroup(group, consumer2, streams={stream: '>'}, count=1)
+        r.xreadgroup(group, consumer1, streams={stream: ">"}, count=1)
+        r.xreadgroup(group, consumer2, streams={stream: ">"}, count=1)
 
-        response = r.xpending_range(stream, group,
-                                    min='-', max='+', count=5)
+        response = r.xpending_range(stream, group, min="-", max="+", count=5)
         assert len(response) == 2
-        response = r.xpending_range(stream, group,
-                                    min='-', max='+', count=5, idle=1000)
+        response = r.xpending_range(stream, group, min="-", max="+", count=5, idle=1000)
         assert len(response) == 0
 
     def test_xpending_range_negative(self, r):
-        stream = 'stream'
-        group = 'group'
+        stream = "stream"
+        group = "group"
         with pytest.raises(redis.DataError):
-            r.xpending_range(stream, group, min='-', max='+', count=None)
+            r.xpending_range(stream, group, min="-", max="+", count=None)
         with pytest.raises(ValueError):
-            r.xpending_range(stream, group, min='-', max='+', count="one")
+            r.xpending_range(stream, group, min="-", max="+", count="one")
         with pytest.raises(redis.DataError):
-            r.xpending_range(stream, group, min='-', max='+', count=-1)
+            r.xpending_range(stream, group, min="-", max="+", count=-1)
         with pytest.raises(ValueError):
-            r.xpending_range(stream, group, min='-', max='+', count=5,
-                             idle="one")
+            r.xpending_range(stream, group, min="-", max="+", count=5, idle="one")
         with pytest.raises(redis.exceptions.ResponseError):
-            r.xpending_range(stream, group, min='-', max='+', count=5,
-                             idle=1.5)
+            r.xpending_range(stream, group, min="-", max="+", count=5, idle=1.5)
         with pytest.raises(redis.DataError):
-            r.xpending_range(stream, group, min='-', max='+', count=5,
-                             idle=-1)
+            r.xpending_range(stream, group, min="-", max="+", count=5, idle=-1)
         with pytest.raises(redis.DataError):
-            r.xpending_range(stream, group, min=None, max=None, count=None,
-                             idle=0)
+            r.xpending_range(stream, group, min=None, max=None, count=None, idle=0)
         with pytest.raises(redis.DataError):
-            r.xpending_range(stream, group, min=None, max=None, count=None,
-                             consumername=0)
+            r.xpending_range(
+                stream, group, min=None, max=None, count=None, consumername=0
+            )
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_xrange(self, r):
-        stream = 'stream'
-        m1 = r.xadd(stream, {'foo': 'bar'})
-        m2 = r.xadd(stream, {'foo': 'bar'})
-        m3 = r.xadd(stream, {'foo': 'bar'})
-        m4 = r.xadd(stream, {'foo': 'bar'})
+        stream = "stream"
+        m1 = r.xadd(stream, {"foo": "bar"})
+        m2 = r.xadd(stream, {"foo": "bar"})
+        m3 = r.xadd(stream, {"foo": "bar"})
+        m4 = r.xadd(stream, {"foo": "bar"})
 
         def get_ids(results):
             return [result[0] for result in results]
@@ -3478,11 +3745,11 @@ def get_ids(results):
         results = r.xrange(stream, max=m2, count=1)
         assert get_ids(results) == [m1]
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_xread(self, r):
-        stream = 'stream'
-        m1 = r.xadd(stream, {'foo': 'bar'})
-        m2 = r.xadd(stream, {'bing': 'baz'})
+        stream = "stream"
+        m1 = r.xadd(stream, {"foo": "bar"})
+        m2 = r.xadd(stream, {"bing": "baz"})
 
         expected = [
             [
@@ -3490,7 +3757,7 @@ def test_xread(self, r):
                 [
                     get_stream_message(r, stream, m1),
                     get_stream_message(r, stream, m2),
-                ]
+                ],
             ]
         ]
         # xread starting at 0 returns both messages
@@ -3501,7 +3768,7 @@ def test_xread(self, r):
                 stream.encode(),
                 [
                     get_stream_message(r, stream, m1),
-                ]
+                ],
             ]
         ]
         # xread starting at 0 and count=1 returns only the first message
@@ -3512,7 +3779,7 @@ def test_xread(self, r):
                 stream.encode(),
                 [
                     get_stream_message(r, stream, m2),
-                ]
+                ],
             ]
         ]
         # xread starting at m1 returns only the second message
@@ -3521,13 +3788,13 @@ def test_xread(self, r):
         # xread starting at the last message returns an empty list
         assert r.xread(streams={stream: m2}) == []
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_xreadgroup(self, r):
-        stream = 'stream'
-        group = 'group'
-        consumer = 'consumer'
-        m1 = r.xadd(stream, {'foo': 'bar'})
-        m2 = r.xadd(stream, {'bing': 'baz'})
+        stream = "stream"
+        group = "group"
+        consumer = "consumer"
+        m1 = r.xadd(stream, {"foo": "bar"})
+        m2 = r.xadd(stream, {"bing": "baz"})
         r.xgroup_create(stream, group, 0)
 
         expected = [
@@ -3536,11 +3803,11 @@ def test_xreadgroup(self, r):
                 [
                     get_stream_message(r, stream, m1),
                     get_stream_message(r, stream, m2),
-                ]
+                ],
             ]
         ]
         # xread starting at 0 returns both messages
-        assert r.xreadgroup(group, consumer, streams={stream: '>'}) == expected
+        assert r.xreadgroup(group, consumer, streams={stream: ">"}) == expected
 
         r.xgroup_destroy(stream, group)
         r.xgroup_create(stream, group, 0)
@@ -3550,34 +3817,34 @@ def test_xreadgroup(self, r):
                 stream.encode(),
                 [
                     get_stream_message(r, stream, m1),
-                ]
+                ],
             ]
         ]
         # xread with count=1 returns only the first message
-        assert r.xreadgroup(group, consumer,
-                            streams={stream: '>'}, count=1) == expected
+        assert r.xreadgroup(group, consumer, streams={stream: ">"}, count=1) == expected
 
         r.xgroup_destroy(stream, group)
 
         # create the group using $ as the last id meaning subsequent reads
         # will only find messages added after this
-        r.xgroup_create(stream, group, '$')
+        r.xgroup_create(stream, group, "$")
 
         expected = []
         # xread starting after the last message returns an empty message list
-        assert r.xreadgroup(group, consumer, streams={stream: '>'}) == expected
+        assert r.xreadgroup(group, consumer, streams={stream: ">"}) == expected
 
         # xreadgroup with noack does not have any items in the PEL
         r.xgroup_destroy(stream, group)
-        r.xgroup_create(stream, group, '0')
-        assert len(r.xreadgroup(group, consumer, streams={stream: '>'},
-                                noack=True)[0][1]) == 2
+        r.xgroup_create(stream, group, "0")
+        assert (
+            len(r.xreadgroup(group, consumer, streams={stream: ">"}, noack=True)[0][1])
+            == 2
+        )
         # now there should be nothing pending
-        assert len(r.xreadgroup(group, consumer,
-                                streams={stream: '0'})[0][1]) == 0
+        assert len(r.xreadgroup(group, consumer, streams={stream: "0"})[0][1]) == 0
 
         r.xgroup_destroy(stream, group)
-        r.xgroup_create(stream, group, '0')
+        r.xgroup_create(stream, group, "0")
         # delete all the messages in the stream
         expected = [
             [
@@ -3585,20 +3852,20 @@ def test_xreadgroup(self, r):
                 [
                     (m1, {}),
                     (m2, {}),
-                ]
+                ],
             ]
         ]
-        r.xreadgroup(group, consumer, streams={stream: '>'})
+        r.xreadgroup(group, consumer, streams={stream: ">"})
         r.xtrim(stream, 0)
-        assert r.xreadgroup(group, consumer, streams={stream: '0'}) == expected
+        assert r.xreadgroup(group, consumer, streams={stream: "0"}) == expected
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_xrevrange(self, r):
-        stream = 'stream'
-        m1 = r.xadd(stream, {'foo': 'bar'})
-        m2 = r.xadd(stream, {'foo': 'bar'})
-        m3 = r.xadd(stream, {'foo': 'bar'})
-        m4 = r.xadd(stream, {'foo': 'bar'})
+        stream = "stream"
+        m1 = r.xadd(stream, {"foo": "bar"})
+        m2 = r.xadd(stream, {"foo": "bar"})
+        m3 = r.xadd(stream, {"foo": "bar"})
+        m4 = r.xadd(stream, {"foo": "bar"})
 
         def get_ids(results):
             return [result[0] for result in results]
@@ -3615,17 +3882,17 @@ def get_ids(results):
         results = r.xrevrange(stream, min=m2, count=1)
         assert get_ids(results) == [m4]
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_xtrim(self, r):
-        stream = 'stream'
+        stream = "stream"
 
         # trimming an empty key doesn't do anything
         assert r.xtrim(stream, 1000) == 0
 
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
 
         # trimming an amount large than the number of messages
         # doesn't do anything
@@ -3634,14 +3901,14 @@ def test_xtrim(self, r):
         # 1 message is trimmed
         assert r.xtrim(stream, 3, approximate=False) == 1
 
-    @skip_if_server_version_lt('6.2.4')
+    @skip_if_server_version_lt("6.2.4")
     def test_xtrim_minlen_and_length_args(self, r):
-        stream = 'stream'
+        stream = "stream"
 
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
 
         # Future self: No limits without approximate, according to the api
         with pytest.raises(redis.ResponseError):
@@ -3655,99 +3922,105 @@ def test_xtrim_minlen_and_length_args(self, r):
             assert r.xtrim(stream, maxlen=3, minid="sometestvalue")
 
         # minid with a limit
-        m1 = r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
+        m1 = r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
         assert r.xtrim(stream, None, approximate=True, minid=m1, limit=3) == 0
 
         # pure minid
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
-        m4 = r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+        m4 = r.xadd(stream, {"foo": "bar"})
         assert r.xtrim(stream, None, approximate=False, minid=m4) == 7
 
         # minid approximate
-        r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
-        m3 = r.xadd(stream, {'foo': 'bar'})
-        r.xadd(stream, {'foo': 'bar'})
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+        m3 = r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
         assert r.xtrim(stream, None, approximate=True, minid=m3) == 0
 
     def test_bitfield_operations(self, r):
         # comments show affected bits
-        bf = r.bitfield('a')
-        resp = (bf
-                .set('u8', 8, 255)     # 00000000 11111111
-                .get('u8', 0)          # 00000000
-                .get('u4', 8)                   # 1111
-                .get('u4', 12)                      # 1111
-                .get('u4', 13)                       # 111 0
-                .execute())
+        bf = r.bitfield("a")
+        resp = (
+            bf.set("u8", 8, 255)  # 00000000 11111111
+            .get("u8", 0)  # 00000000
+            .get("u4", 8)  # 1111
+            .get("u4", 12)  # 1111
+            .get("u4", 13)  # 111 0
+            .execute()
+        )
         assert resp == [0, 0, 15, 15, 14]
 
         # .set() returns the previous value...
-        resp = (bf
-                .set('u8', 4, 1)           # 0000 0001
-                .get('u16', 0)         # 00000000 00011111
-                .set('u16', 0, 0)      # 00000000 00000000
-                .execute())
+        resp = (
+            bf.set("u8", 4, 1)  # 0000 0001
+            .get("u16", 0)  # 00000000 00011111
+            .set("u16", 0, 0)  # 00000000 00000000
+            .execute()
+        )
         assert resp == [15, 31, 31]
 
         # incrby adds to the value
-        resp = (bf
-                .incrby('u8', 8, 254)  # 00000000 11111110
-                .incrby('u8', 8, 1)    # 00000000 11111111
-                .get('u16', 0)         # 00000000 11111111
-                .execute())
+        resp = (
+            bf.incrby("u8", 8, 254)  # 00000000 11111110
+            .incrby("u8", 8, 1)  # 00000000 11111111
+            .get("u16", 0)  # 00000000 11111111
+            .execute()
+        )
         assert resp == [254, 255, 255]
 
         # Verify overflow protection works as a method:
-        r.delete('a')
-        resp = (bf
-                .set('u8', 8, 254)     # 00000000 11111110
-                .overflow('fail')
-                .incrby('u8', 8, 2)    # incrby 2 would overflow, None returned
-                .incrby('u8', 8, 1)    # 00000000 11111111
-                .incrby('u8', 8, 1)    # incrby 1 would overflow, None returned
-                .get('u16', 0)         # 00000000 11111111
-                .execute())
+        r.delete("a")
+        resp = (
+            bf.set("u8", 8, 254)  # 00000000 11111110
+            .overflow("fail")
+            .incrby("u8", 8, 2)  # incrby 2 would overflow, None returned
+            .incrby("u8", 8, 1)  # 00000000 11111111
+            .incrby("u8", 8, 1)  # incrby 1 would overflow, None returned
+            .get("u16", 0)  # 00000000 11111111
+            .execute()
+        )
         assert resp == [0, None, 255, None, 255]
 
         # Verify overflow protection works as arg to incrby:
-        r.delete('a')
-        resp = (bf
-                .set('u8', 8, 255)           # 00000000 11111111
-                .incrby('u8', 8, 1)          # 00000000 00000000  wrap default
-                .set('u8', 8, 255)           # 00000000 11111111
-                .incrby('u8', 8, 1, 'FAIL')  # 00000000 11111111  fail
-                .incrby('u8', 8, 1)          # 00000000 11111111  still fail
-                .get('u16', 0)               # 00000000 11111111
-                .execute())
+        r.delete("a")
+        resp = (
+            bf.set("u8", 8, 255)  # 00000000 11111111
+            .incrby("u8", 8, 1)  # 00000000 00000000  wrap default
+            .set("u8", 8, 255)  # 00000000 11111111
+            .incrby("u8", 8, 1, "FAIL")  # 00000000 11111111  fail
+            .incrby("u8", 8, 1)  # 00000000 11111111  still fail
+            .get("u16", 0)  # 00000000 11111111
+            .execute()
+        )
         assert resp == [0, 0, 0, None, None, 255]
 
         # test default default_overflow
-        r.delete('a')
-        bf = r.bitfield('a', default_overflow='FAIL')
-        resp = (bf
-                .set('u8', 8, 255)     # 00000000 11111111
-                .incrby('u8', 8, 1)    # 00000000 11111111  fail default
-                .get('u16', 0)         # 00000000 11111111
-                .execute())
+        r.delete("a")
+        bf = r.bitfield("a", default_overflow="FAIL")
+        resp = (
+            bf.set("u8", 8, 255)  # 00000000 11111111
+            .incrby("u8", 8, 1)  # 00000000 11111111  fail default
+            .get("u16", 0)  # 00000000 11111111
+            .execute()
+        )
         assert resp == [0, None, 255]
 
-    @skip_if_server_version_lt('4.0.0')
+    @skip_if_server_version_lt("4.0.0")
     def test_memory_help(self, r):
         with pytest.raises(NotImplementedError):
             r.memory_help()
 
-    @skip_if_server_version_lt('4.0.0')
+    @skip_if_server_version_lt("4.0.0")
     def test_memory_doctor(self, r):
         with pytest.raises(NotImplementedError):
             r.memory_doctor()
 
-    @skip_if_server_version_lt('4.0.0')
+    @skip_if_server_version_lt("4.0.0")
     def test_memory_malloc_stats(self, r):
         if skip_if_redis_enterprise(None).args[0] is True:
             with pytest.raises(redis.exceptions.ResponseError):
@@ -3756,11 +4029,11 @@ def test_memory_malloc_stats(self, r):
 
         assert r.memory_malloc_stats()
 
-    @skip_if_server_version_lt('4.0.0')
+    @skip_if_server_version_lt("4.0.0")
     def test_memory_stats(self, r):
         # put a key into the current db to make sure that "db.<current-db>"
         # has data
-        r.set('foo', 'bar')
+        r.set("foo", "bar")
 
         if skip_if_redis_enterprise(None).args[0] is True:
             with pytest.raises(redis.exceptions.ResponseError):
@@ -3770,104 +4043,113 @@ def test_memory_stats(self, r):
         stats = r.memory_stats()
         assert isinstance(stats, dict)
         for key, value in stats.items():
-            if key.startswith('db.'):
+            if key.startswith("db."):
                 assert isinstance(value, dict)
 
-    @skip_if_server_version_lt('4.0.0')
+    @skip_if_server_version_lt("4.0.0")
     def test_memory_usage(self, r):
-        r.set('foo', 'bar')
-        assert isinstance(r.memory_usage('foo'), int)
+        r.set("foo", "bar")
+        assert isinstance(r.memory_usage("foo"), int)
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('4.0.0')
+    @skip_if_server_version_lt("4.0.0")
     @skip_if_redis_enterprise
     def test_module_list(self, r):
         assert isinstance(r.module_list(), list)
         for x in r.module_list():
             assert isinstance(x, dict)
 
-    @skip_if_server_version_lt('2.8.13')
+    @skip_if_server_version_lt("2.8.13")
     def test_command_count(self, r):
         res = r.command_count()
         assert isinstance(res, int)
         assert res >= 100
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.8.13')
+    @skip_if_server_version_lt("2.8.13")
     def test_command_getkeys(self, r):
-        res = r.command_getkeys('MSET', 'a', 'b', 'c', 'd', 'e', 'f')
-        assert res == ['a', 'c', 'e']
-        res = r.command_getkeys('EVAL', '"not consulted"',
-                                '3', 'key1', 'key2', 'key3',
-                                'arg1', 'arg2', 'arg3', 'argN')
-        assert res == ['key1', 'key2', 'key3']
-
-    @skip_if_server_version_lt('2.8.13')
+        res = r.command_getkeys("MSET", "a", "b", "c", "d", "e", "f")
+        assert res == ["a", "c", "e"]
+        res = r.command_getkeys(
+            "EVAL",
+            '"not consulted"',
+            "3",
+            "key1",
+            "key2",
+            "key3",
+            "arg1",
+            "arg2",
+            "arg3",
+            "argN",
+        )
+        assert res == ["key1", "key2", "key3"]
+
+    @skip_if_server_version_lt("2.8.13")
     def test_command(self, r):
         res = r.command()
         assert len(res) >= 100
         cmds = list(res.keys())
-        assert 'set' in cmds
-        assert 'get' in cmds
+        assert "set" in cmds
+        assert "get" in cmds
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('4.0.0')
+    @skip_if_server_version_lt("4.0.0")
     @skip_if_redis_enterprise
     def test_module(self, r):
         with pytest.raises(redis.exceptions.ModuleError) as excinfo:
-            r.module_load('/some/fake/path')
+            r.module_load("/some/fake/path")
             assert "Error loading the extension." in str(excinfo.value)
 
         with pytest.raises(redis.exceptions.ModuleError) as excinfo:
-            r.module_load('/some/fake/path', 'arg1', 'arg2', 'arg3', 'arg4')
+            r.module_load("/some/fake/path", "arg1", "arg2", "arg3", "arg4")
             assert "Error loading the extension." in str(excinfo.value)
 
-    @skip_if_server_version_lt('2.6.0')
+    @skip_if_server_version_lt("2.6.0")
     def test_restore(self, r):
 
         # standard restore
-        key = 'foo'
-        r.set(key, 'bar')
+        key = "foo"
+        r.set(key, "bar")
         dumpdata = r.dump(key)
         r.delete(key)
         assert r.restore(key, 0, dumpdata)
-        assert r.get(key) == b'bar'
+        assert r.get(key) == b"bar"
 
         # overwrite restore
         with pytest.raises(redis.exceptions.ResponseError):
             assert r.restore(key, 0, dumpdata)
-        r.set(key, 'a new value!')
+        r.set(key, "a new value!")
         assert r.restore(key, 0, dumpdata, replace=True)
-        assert r.get(key) == b'bar'
+        assert r.get(key) == b"bar"
 
         # ttl check
-        key2 = 'another'
-        r.set(key2, 'blee!')
+        key2 = "another"
+        r.set(key2, "blee!")
         dumpdata = r.dump(key2)
         r.delete(key2)
         assert r.restore(key2, 0, dumpdata)
         assert r.ttl(key2) == -1
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_restore_idletime(self, r):
-        key = 'yayakey'
-        r.set(key, 'blee!')
+        key = "yayakey"
+        r.set(key, "blee!")
         dumpdata = r.dump(key)
         r.delete(key)
         assert r.restore(key, 0, dumpdata, idletime=5)
-        assert r.get(key) == b'blee!'
+        assert r.get(key) == b"blee!"
 
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     def test_restore_frequency(self, r):
-        key = 'yayakey'
-        r.set(key, 'blee!')
+        key = "yayakey"
+        r.set(key, "blee!")
         dumpdata = r.dump(key)
         r.delete(key)
         assert r.restore(key, 0, dumpdata, frequency=5)
-        assert r.get(key) == b'blee!'
+        assert r.get(key) == b"blee!"
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('5.0.0')
+    @skip_if_server_version_lt("5.0.0")
     @skip_if_redis_enterprise
     def test_replicaof(self, r):
         with pytest.raises(redis.ResponseError):
@@ -3877,36 +4159,38 @@ def test_replicaof(self, r):
 
 @pytest.mark.onlynoncluster
 class TestBinarySave:
-
     def test_binary_get_set(self, r):
-        assert r.set(' foo bar ', '123')
-        assert r.get(' foo bar ') == b'123'
+        assert r.set(" foo bar ", "123")
+        assert r.get(" foo bar ") == b"123"
 
-        assert r.set(' foo\r\nbar\r\n ', '456')
-        assert r.get(' foo\r\nbar\r\n ') == b'456'
+        assert r.set(" foo\r\nbar\r\n ", "456")
+        assert r.get(" foo\r\nbar\r\n ") == b"456"
 
-        assert r.set(' \r\n\t\x07\x13 ', '789')
-        assert r.get(' \r\n\t\x07\x13 ') == b'789'
+        assert r.set(" \r\n\t\x07\x13 ", "789")
+        assert r.get(" \r\n\t\x07\x13 ") == b"789"
 
-        assert sorted(r.keys('*')) == \
-            [b' \r\n\t\x07\x13 ', b' foo\r\nbar\r\n ', b' foo bar ']
+        assert sorted(r.keys("*")) == [
+            b" \r\n\t\x07\x13 ",
+            b" foo\r\nbar\r\n ",
+            b" foo bar ",
+        ]
 
-        assert r.delete(' foo bar ')
-        assert r.delete(' foo\r\nbar\r\n ')
-        assert r.delete(' \r\n\t\x07\x13 ')
+        assert r.delete(" foo bar ")
+        assert r.delete(" foo\r\nbar\r\n ")
+        assert r.delete(" \r\n\t\x07\x13 ")
 
     def test_binary_lists(self, r):
         mapping = {
-            b'foo bar': [b'1', b'2', b'3'],
-            b'foo\r\nbar\r\n': [b'4', b'5', b'6'],
-            b'foo\tbar\x07': [b'7', b'8', b'9'],
+            b"foo bar": [b"1", b"2", b"3"],
+            b"foo\r\nbar\r\n": [b"4", b"5", b"6"],
+            b"foo\tbar\x07": [b"7", b"8", b"9"],
         }
         # fill in lists
         for key, value in mapping.items():
             r.rpush(key, *value)
 
         # check that KEYS returns all the keys as they are
-        assert sorted(r.keys('*')) == sorted(mapping.keys())
+        assert sorted(r.keys("*")) == sorted(mapping.keys())
 
         # check that it is possible to get list content by key name
         for key, value in mapping.items():
@@ -3917,42 +4201,44 @@ def test_22_info(self, r):
         Older Redis versions contained 'allocation_stats' in INFO that
         was the cause of a number of bugs when parsing.
         """
-        info = "allocation_stats:6=1,7=1,8=7141,9=180,10=92,11=116,12=5330," \
-               "13=123,14=3091,15=11048,16=225842,17=1784,18=814,19=12020," \
-               "20=2530,21=645,22=15113,23=8695,24=142860,25=318,26=3303," \
-               "27=20561,28=54042,29=37390,30=1884,31=18071,32=31367,33=160," \
-               "34=169,35=201,36=10155,37=1045,38=15078,39=22985,40=12523," \
-               "41=15588,42=265,43=1287,44=142,45=382,46=945,47=426,48=171," \
-               "49=56,50=516,51=43,52=41,53=46,54=54,55=75,56=647,57=332," \
-               "58=32,59=39,60=48,61=35,62=62,63=32,64=221,65=26,66=30," \
-               "67=36,68=41,69=44,70=26,71=144,72=169,73=24,74=37,75=25," \
-               "76=42,77=21,78=126,79=374,80=27,81=40,82=43,83=47,84=46," \
-               "85=114,86=34,87=37,88=7240,89=34,90=38,91=18,92=99,93=20," \
-               "94=18,95=17,96=15,97=22,98=18,99=69,100=17,101=22,102=15," \
-               "103=29,104=39,105=30,106=70,107=22,108=21,109=26,110=52," \
-               "111=45,112=33,113=67,114=41,115=44,116=48,117=53,118=54," \
-               "119=51,120=75,121=44,122=57,123=44,124=66,125=56,126=52," \
-               "127=81,128=108,129=70,130=50,131=51,132=53,133=45,134=62," \
-               "135=12,136=13,137=7,138=15,139=21,140=11,141=20,142=6,143=7," \
-               "144=11,145=6,146=16,147=19,148=1112,149=1,151=83,154=1," \
-               "155=1,156=1,157=1,160=1,161=1,162=2,166=1,169=1,170=1,171=2," \
-               "172=1,174=1,176=2,177=9,178=34,179=73,180=30,181=1,185=3," \
-               "187=1,188=1,189=1,192=1,196=1,198=1,200=1,201=1,204=1,205=1," \
-               "207=1,208=1,209=1,214=2,215=31,216=78,217=28,218=5,219=2," \
-               "220=1,222=1,225=1,227=1,234=1,242=1,250=1,252=1,253=1," \
-               ">=256=203"
+        info = (
+            "allocation_stats:6=1,7=1,8=7141,9=180,10=92,11=116,12=5330,"
+            "13=123,14=3091,15=11048,16=225842,17=1784,18=814,19=12020,"
+            "20=2530,21=645,22=15113,23=8695,24=142860,25=318,26=3303,"
+            "27=20561,28=54042,29=37390,30=1884,31=18071,32=31367,33=160,"
+            "34=169,35=201,36=10155,37=1045,38=15078,39=22985,40=12523,"
+            "41=15588,42=265,43=1287,44=142,45=382,46=945,47=426,48=171,"
+            "49=56,50=516,51=43,52=41,53=46,54=54,55=75,56=647,57=332,"
+            "58=32,59=39,60=48,61=35,62=62,63=32,64=221,65=26,66=30,"
+            "67=36,68=41,69=44,70=26,71=144,72=169,73=24,74=37,75=25,"
+            "76=42,77=21,78=126,79=374,80=27,81=40,82=43,83=47,84=46,"
+            "85=114,86=34,87=37,88=7240,89=34,90=38,91=18,92=99,93=20,"
+            "94=18,95=17,96=15,97=22,98=18,99=69,100=17,101=22,102=15,"
+            "103=29,104=39,105=30,106=70,107=22,108=21,109=26,110=52,"
+            "111=45,112=33,113=67,114=41,115=44,116=48,117=53,118=54,"
+            "119=51,120=75,121=44,122=57,123=44,124=66,125=56,126=52,"
+            "127=81,128=108,129=70,130=50,131=51,132=53,133=45,134=62,"
+            "135=12,136=13,137=7,138=15,139=21,140=11,141=20,142=6,143=7,"
+            "144=11,145=6,146=16,147=19,148=1112,149=1,151=83,154=1,"
+            "155=1,156=1,157=1,160=1,161=1,162=2,166=1,169=1,170=1,171=2,"
+            "172=1,174=1,176=2,177=9,178=34,179=73,180=30,181=1,185=3,"
+            "187=1,188=1,189=1,192=1,196=1,198=1,200=1,201=1,204=1,205=1,"
+            "207=1,208=1,209=1,214=2,215=31,216=78,217=28,218=5,219=2,"
+            "220=1,222=1,225=1,227=1,234=1,242=1,250=1,252=1,253=1,"
+            ">=256=203"
+        )
         parsed = parse_info(info)
-        assert 'allocation_stats' in parsed
-        assert '6' in parsed['allocation_stats']
-        assert '>=256' in parsed['allocation_stats']
+        assert "allocation_stats" in parsed
+        assert "6" in parsed["allocation_stats"]
+        assert ">=256" in parsed["allocation_stats"]
 
     @skip_if_redis_enterprise
     def test_large_responses(self, r):
         "The PythonParser has some special cases for return values > 1MB"
         # load up 5MB of data into a key
-        data = ''.join([ascii_letters] * (5000000 // len(ascii_letters)))
-        r['a'] = data
-        assert r['a'] == data.encode()
+        data = "".join([ascii_letters] * (5000000 // len(ascii_letters)))
+        r["a"] = data
+        assert r["a"] == data.encode()
 
     def test_floating_point_encoding(self, r):
         """
@@ -3960,5 +4246,5 @@ def test_floating_point_encoding(self, r):
         precision.
         """
         timestamp = 1349673917.939762
-        r.zadd('a', {'a1': timestamp})
-        assert r.zscore('a', 'a1') == timestamp
+        r.zadd("a", {"a1": timestamp})
+        assert r.zscore("a", "a1") == timestamp
diff --git a/tests/test_connection.py b/tests/test_connection.py
index 0071acab5c..22f1b718de 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -1,37 +1,40 @@
-from unittest import mock
 import types
+from unittest import mock
+
 import pytest
 
 from redis.exceptions import InvalidResponse
 from redis.utils import HIREDIS_AVAILABLE
+
 from .conftest import skip_if_server_version_lt
 
 
-@pytest.mark.skipif(HIREDIS_AVAILABLE, reason='PythonParser only')
+@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 @pytest.mark.onlynoncluster
 def test_invalid_response(r):
-    raw = b'x'
+    raw = b"x"
     parser = r.connection._parser
-    with mock.patch.object(parser._buffer, 'readline', return_value=raw):
+    with mock.patch.object(parser._buffer, "readline", return_value=raw):
         with pytest.raises(InvalidResponse) as cm:
             parser.read_response()
-    assert str(cm.value) == f'Protocol Error: {raw!r}'
+    assert str(cm.value) == f"Protocol Error: {raw!r}"
 
 
-@skip_if_server_version_lt('4.0.0')
+@skip_if_server_version_lt("4.0.0")
 @pytest.mark.redismod
 def test_loading_external_modules(modclient):
     def inner():
         pass
 
-    modclient.load_external_module('myfuncname', inner)
-    assert getattr(modclient, 'myfuncname') == inner
-    assert isinstance(getattr(modclient, 'myfuncname'), types.FunctionType)
+    modclient.load_external_module("myfuncname", inner)
+    assert getattr(modclient, "myfuncname") == inner
+    assert isinstance(getattr(modclient, "myfuncname"), types.FunctionType)
 
     # and call it
     from redis.commands import RedisModuleCommands
+
     j = RedisModuleCommands.json
-    modclient.load_external_module('sometestfuncname', j)
+    modclient.load_external_module("sometestfuncname", j)
 
     # d = {'hello': 'world!'}
     # mod = j(modclient)
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 288d43dfd7..2602af82e1 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -1,17 +1,15 @@
 import os
-import pytest
 import re
-import redis
 import time
+from threading import Thread
 from unittest import mock
 
-from threading import Thread
+import pytest
+
+import redis
 from redis.connection import ssl_available, to_bool
-from .conftest import (
-    skip_if_server_version_lt,
-    skip_if_redis_enterprise,
-    _get_client
-)
+
+from .conftest import _get_client, skip_if_redis_enterprise, skip_if_server_version_lt
 from .test_pubsub import wait_for_message
 
 
@@ -30,107 +28,122 @@ def can_read(self):
 
 
 class TestConnectionPool:
-    def get_pool(self, connection_kwargs=None, max_connections=None,
-                 connection_class=redis.Connection):
+    def get_pool(
+        self,
+        connection_kwargs=None,
+        max_connections=None,
+        connection_class=redis.Connection,
+    ):
         connection_kwargs = connection_kwargs or {}
         pool = redis.ConnectionPool(
             connection_class=connection_class,
             max_connections=max_connections,
-            **connection_kwargs)
+            **connection_kwargs,
+        )
         return pool
 
     def test_connection_creation(self):
-        connection_kwargs = {'foo': 'bar', 'biz': 'baz'}
-        pool = self.get_pool(connection_kwargs=connection_kwargs,
-                             connection_class=DummyConnection)
-        connection = pool.get_connection('_')
+        connection_kwargs = {"foo": "bar", "biz": "baz"}
+        pool = self.get_pool(
+            connection_kwargs=connection_kwargs, connection_class=DummyConnection
+        )
+        connection = pool.get_connection("_")
         assert isinstance(connection, DummyConnection)
         assert connection.kwargs == connection_kwargs
 
     def test_multiple_connections(self, master_host):
-        connection_kwargs = {'host': master_host[0], 'port': master_host[1]}
+        connection_kwargs = {"host": master_host[0], "port": master_host[1]}
         pool = self.get_pool(connection_kwargs=connection_kwargs)
-        c1 = pool.get_connection('_')
-        c2 = pool.get_connection('_')
+        c1 = pool.get_connection("_")
+        c2 = pool.get_connection("_")
         assert c1 != c2
 
     def test_max_connections(self, master_host):
-        connection_kwargs = {'host': master_host[0], 'port': master_host[1]}
-        pool = self.get_pool(max_connections=2,
-                             connection_kwargs=connection_kwargs)
-        pool.get_connection('_')
-        pool.get_connection('_')
+        connection_kwargs = {"host": master_host[0], "port": master_host[1]}
+        pool = self.get_pool(max_connections=2, connection_kwargs=connection_kwargs)
+        pool.get_connection("_")
+        pool.get_connection("_")
         with pytest.raises(redis.ConnectionError):
-            pool.get_connection('_')
+            pool.get_connection("_")
 
     def test_reuse_previously_released_connection(self, master_host):
-        connection_kwargs = {'host': master_host[0], 'port': master_host[1]}
+        connection_kwargs = {"host": master_host[0], "port": master_host[1]}
         pool = self.get_pool(connection_kwargs=connection_kwargs)
-        c1 = pool.get_connection('_')
+        c1 = pool.get_connection("_")
         pool.release(c1)
-        c2 = pool.get_connection('_')
+        c2 = pool.get_connection("_")
         assert c1 == c2
 
     def test_repr_contains_db_info_tcp(self):
         connection_kwargs = {
-            'host': 'localhost',
-            'port': 6379,
-            'db': 1,
-            'client_name': 'test-client'
+            "host": "localhost",
+            "port": 6379,
+            "db": 1,
+            "client_name": "test-client",
         }
-        pool = self.get_pool(connection_kwargs=connection_kwargs,
-                             connection_class=redis.Connection)
-        expected = ('ConnectionPool<Connection<'
-                    'host=localhost,port=6379,db=1,client_name=test-client>>')
+        pool = self.get_pool(
+            connection_kwargs=connection_kwargs, connection_class=redis.Connection
+        )
+        expected = (
+            "ConnectionPool<Connection<"
+            "host=localhost,port=6379,db=1,client_name=test-client>>"
+        )
         assert repr(pool) == expected
 
     def test_repr_contains_db_info_unix(self):
-        connection_kwargs = {
-            'path': '/abc',
-            'db': 1,
-            'client_name': 'test-client'
-        }
-        pool = self.get_pool(connection_kwargs=connection_kwargs,
-                             connection_class=redis.UnixDomainSocketConnection)
-        expected = ('ConnectionPool<UnixDomainSocketConnection<'
-                    'path=/abc,db=1,client_name=test-client>>')
+        connection_kwargs = {"path": "/abc", "db": 1, "client_name": "test-client"}
+        pool = self.get_pool(
+            connection_kwargs=connection_kwargs,
+            connection_class=redis.UnixDomainSocketConnection,
+        )
+        expected = (
+            "ConnectionPool<UnixDomainSocketConnection<"
+            "path=/abc,db=1,client_name=test-client>>"
+        )
         assert repr(pool) == expected
 
 
 class TestBlockingConnectionPool:
     def get_pool(self, connection_kwargs=None, max_connections=10, timeout=20):
         connection_kwargs = connection_kwargs or {}
-        pool = redis.BlockingConnectionPool(connection_class=DummyConnection,
-                                            max_connections=max_connections,
-                                            timeout=timeout,
-                                            **connection_kwargs)
+        pool = redis.BlockingConnectionPool(
+            connection_class=DummyConnection,
+            max_connections=max_connections,
+            timeout=timeout,
+            **connection_kwargs,
+        )
         return pool
 
     def test_connection_creation(self, master_host):
-        connection_kwargs = {'foo': 'bar', 'biz': 'baz',
-                             'host': master_host[0], 'port': master_host[1]}
+        connection_kwargs = {
+            "foo": "bar",
+            "biz": "baz",
+            "host": master_host[0],
+            "port": master_host[1],
+        }
         pool = self.get_pool(connection_kwargs=connection_kwargs)
-        connection = pool.get_connection('_')
+        connection = pool.get_connection("_")
         assert isinstance(connection, DummyConnection)
         assert connection.kwargs == connection_kwargs
 
     def test_multiple_connections(self, master_host):
-        connection_kwargs = {'host': master_host[0], 'port': master_host[1]}
+        connection_kwargs = {"host": master_host[0], "port": master_host[1]}
         pool = self.get_pool(connection_kwargs=connection_kwargs)
-        c1 = pool.get_connection('_')
-        c2 = pool.get_connection('_')
+        c1 = pool.get_connection("_")
+        c2 = pool.get_connection("_")
         assert c1 != c2
 
     def test_connection_pool_blocks_until_timeout(self, master_host):
         "When out of connections, block for timeout seconds, then raise"
-        connection_kwargs = {'host': master_host[0], 'port': master_host[1]}
-        pool = self.get_pool(max_connections=1, timeout=0.1,
-                             connection_kwargs=connection_kwargs)
-        pool.get_connection('_')
+        connection_kwargs = {"host": master_host[0], "port": master_host[1]}
+        pool = self.get_pool(
+            max_connections=1, timeout=0.1, connection_kwargs=connection_kwargs
+        )
+        pool.get_connection("_")
 
         start = time.time()
         with pytest.raises(redis.ConnectionError):
-            pool.get_connection('_')
+            pool.get_connection("_")
         # we should have waited at least 0.1 seconds
         assert time.time() - start >= 0.1
 
@@ -139,10 +152,11 @@ def test_connection_pool_blocks_until_conn_available(self, master_host):
         When out of connections, block until another connection is released
         to the pool
         """
-        connection_kwargs = {'host': master_host[0], 'port': master_host[1]}
-        pool = self.get_pool(max_connections=1, timeout=2,
-                             connection_kwargs=connection_kwargs)
-        c1 = pool.get_connection('_')
+        connection_kwargs = {"host": master_host[0], "port": master_host[1]}
+        pool = self.get_pool(
+            max_connections=1, timeout=2, connection_kwargs=connection_kwargs
+        )
+        c1 = pool.get_connection("_")
 
         def target():
             time.sleep(0.1)
@@ -150,294 +164,295 @@ def target():
 
         start = time.time()
         Thread(target=target).start()
-        pool.get_connection('_')
+        pool.get_connection("_")
         assert time.time() - start >= 0.1
 
     def test_reuse_previously_released_connection(self, master_host):
-        connection_kwargs = {'host': master_host[0], 'port': master_host[1]}
+        connection_kwargs = {"host": master_host[0], "port": master_host[1]}
         pool = self.get_pool(connection_kwargs=connection_kwargs)
-        c1 = pool.get_connection('_')
+        c1 = pool.get_connection("_")
         pool.release(c1)
-        c2 = pool.get_connection('_')
+        c2 = pool.get_connection("_")
         assert c1 == c2
 
     def test_repr_contains_db_info_tcp(self):
         pool = redis.ConnectionPool(
-            host='localhost',
-            port=6379,
-            client_name='test-client'
+            host="localhost", port=6379, client_name="test-client"
+        )
+        expected = (
+            "ConnectionPool<Connection<"
+            "host=localhost,port=6379,db=0,client_name=test-client>>"
         )
-        expected = ('ConnectionPool<Connection<'
-                    'host=localhost,port=6379,db=0,client_name=test-client>>')
         assert repr(pool) == expected
 
     def test_repr_contains_db_info_unix(self):
         pool = redis.ConnectionPool(
             connection_class=redis.UnixDomainSocketConnection,
-            path='abc',
-            client_name='test-client'
+            path="abc",
+            client_name="test-client",
+        )
+        expected = (
+            "ConnectionPool<UnixDomainSocketConnection<"
+            "path=abc,db=0,client_name=test-client>>"
         )
-        expected = ('ConnectionPool<UnixDomainSocketConnection<'
-                    'path=abc,db=0,client_name=test-client>>')
         assert repr(pool) == expected
 
 
 class TestConnectionPoolURLParsing:
     def test_hostname(self):
-        pool = redis.ConnectionPool.from_url('redis://my.host')
+        pool = redis.ConnectionPool.from_url("redis://my.host")
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
-            'host': 'my.host',
+            "host": "my.host",
         }
 
     def test_quoted_hostname(self):
-        pool = redis.ConnectionPool.from_url('redis://my %2F host %2B%3D+')
+        pool = redis.ConnectionPool.from_url("redis://my %2F host %2B%3D+")
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
-            'host': 'my / host +=+',
+            "host": "my / host +=+",
         }
 
     def test_port(self):
-        pool = redis.ConnectionPool.from_url('redis://localhost:6380')
+        pool = redis.ConnectionPool.from_url("redis://localhost:6380")
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
-            'host': 'localhost',
-            'port': 6380,
+            "host": "localhost",
+            "port": 6380,
         }
 
     @skip_if_server_version_lt("6.0.0")
     def test_username(self):
-        pool = redis.ConnectionPool.from_url('redis://myuser:@localhost')
+        pool = redis.ConnectionPool.from_url("redis://myuser:@localhost")
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
-            'host': 'localhost',
-            'username': 'myuser',
+            "host": "localhost",
+            "username": "myuser",
         }
 
     @skip_if_server_version_lt("6.0.0")
     def test_quoted_username(self):
         pool = redis.ConnectionPool.from_url(
-            'redis://%2Fmyuser%2F%2B name%3D%24+:@localhost')
+            "redis://%2Fmyuser%2F%2B name%3D%24+:@localhost"
+        )
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
-            'host': 'localhost',
-            'username': '/myuser/+ name=$+',
+            "host": "localhost",
+            "username": "/myuser/+ name=$+",
         }
 
     def test_password(self):
-        pool = redis.ConnectionPool.from_url('redis://:mypassword@localhost')
+        pool = redis.ConnectionPool.from_url("redis://:mypassword@localhost")
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
-            'host': 'localhost',
-            'password': 'mypassword',
+            "host": "localhost",
+            "password": "mypassword",
         }
 
     def test_quoted_password(self):
         pool = redis.ConnectionPool.from_url(
-            'redis://:%2Fmypass%2F%2B word%3D%24+@localhost')
+            "redis://:%2Fmypass%2F%2B word%3D%24+@localhost"
+        )
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
-            'host': 'localhost',
-            'password': '/mypass/+ word=$+',
+            "host": "localhost",
+            "password": "/mypass/+ word=$+",
         }
 
     @skip_if_server_version_lt("6.0.0")
     def test_username_and_password(self):
-        pool = redis.ConnectionPool.from_url('redis://myuser:mypass@localhost')
+        pool = redis.ConnectionPool.from_url("redis://myuser:mypass@localhost")
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
-            'host': 'localhost',
-            'username': 'myuser',
-            'password': 'mypass',
+            "host": "localhost",
+            "username": "myuser",
+            "password": "mypass",
         }
 
     def test_db_as_argument(self):
-        pool = redis.ConnectionPool.from_url('redis://localhost', db=1)
+        pool = redis.ConnectionPool.from_url("redis://localhost", db=1)
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
-            'host': 'localhost',
-            'db': 1,
+            "host": "localhost",
+            "db": 1,
         }
 
     def test_db_in_path(self):
-        pool = redis.ConnectionPool.from_url('redis://localhost/2', db=1)
+        pool = redis.ConnectionPool.from_url("redis://localhost/2", db=1)
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
-            'host': 'localhost',
-            'db': 2,
+            "host": "localhost",
+            "db": 2,
         }
 
     def test_db_in_querystring(self):
-        pool = redis.ConnectionPool.from_url('redis://localhost/2?db=3',
-                                             db=1)
+        pool = redis.ConnectionPool.from_url("redis://localhost/2?db=3", db=1)
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
-            'host': 'localhost',
-            'db': 3,
+            "host": "localhost",
+            "db": 3,
         }
 
     def test_extra_typed_querystring_options(self):
         pool = redis.ConnectionPool.from_url(
-            'redis://localhost/2?socket_timeout=20&socket_connect_timeout=10'
-            '&socket_keepalive=&retry_on_timeout=Yes&max_connections=10'
+            "redis://localhost/2?socket_timeout=20&socket_connect_timeout=10"
+            "&socket_keepalive=&retry_on_timeout=Yes&max_connections=10"
         )
 
         assert pool.connection_class == redis.Connection
         assert pool.connection_kwargs == {
-            'host': 'localhost',
-            'db': 2,
-            'socket_timeout': 20.0,
-            'socket_connect_timeout': 10.0,
-            'retry_on_timeout': True,
+            "host": "localhost",
+            "db": 2,
+            "socket_timeout": 20.0,
+            "socket_connect_timeout": 10.0,
+            "retry_on_timeout": True,
         }
         assert pool.max_connections == 10
 
     def test_boolean_parsing(self):
         for expected, value in (
-                (None, None),
-                (None, ''),
-                (False, 0), (False, '0'),
-                (False, 'f'), (False, 'F'), (False, 'False'),
-                (False, 'n'), (False, 'N'), (False, 'No'),
-                (True, 1), (True, '1'),
-                (True, 'y'), (True, 'Y'), (True, 'Yes'),
+            (None, None),
+            (None, ""),
+            (False, 0),
+            (False, "0"),
+            (False, "f"),
+            (False, "F"),
+            (False, "False"),
+            (False, "n"),
+            (False, "N"),
+            (False, "No"),
+            (True, 1),
+            (True, "1"),
+            (True, "y"),
+            (True, "Y"),
+            (True, "Yes"),
         ):
             assert expected is to_bool(value)
 
     def test_client_name_in_querystring(self):
-        pool = redis.ConnectionPool.from_url(
-            'redis://location?client_name=test-client'
-        )
-        assert pool.connection_kwargs['client_name'] == 'test-client'
+        pool = redis.ConnectionPool.from_url("redis://location?client_name=test-client")
+        assert pool.connection_kwargs["client_name"] == "test-client"
 
     def test_invalid_extra_typed_querystring_options(self):
         with pytest.raises(ValueError):
             redis.ConnectionPool.from_url(
-                'redis://localhost/2?socket_timeout=_&'
-                'socket_connect_timeout=abc'
+                "redis://localhost/2?socket_timeout=_&" "socket_connect_timeout=abc"
             )
 
     def test_extra_querystring_options(self):
-        pool = redis.ConnectionPool.from_url('redis://localhost?a=1&b=2')
+        pool = redis.ConnectionPool.from_url("redis://localhost?a=1&b=2")
         assert pool.connection_class == redis.Connection
-        assert pool.connection_kwargs == {
-            'host': 'localhost',
-            'a': '1',
-            'b': '2'
-        }
+        assert pool.connection_kwargs == {"host": "localhost", "a": "1", "b": "2"}
 
     def test_calling_from_subclass_returns_correct_instance(self):
-        pool = redis.BlockingConnectionPool.from_url('redis://localhost')
+        pool = redis.BlockingConnectionPool.from_url("redis://localhost")
         assert isinstance(pool, redis.BlockingConnectionPool)
 
     def test_client_creates_connection_pool(self):
-        r = redis.Redis.from_url('redis://myhost')
+        r = redis.Redis.from_url("redis://myhost")
         assert r.connection_pool.connection_class == redis.Connection
         assert r.connection_pool.connection_kwargs == {
-            'host': 'myhost',
+            "host": "myhost",
         }
 
     def test_invalid_scheme_raises_error(self):
         with pytest.raises(ValueError) as cm:
-            redis.ConnectionPool.from_url('localhost')
+            redis.ConnectionPool.from_url("localhost")
         assert str(cm.value) == (
-            'Redis URL must specify one of the following schemes '
-            '(redis://, rediss://, unix://)'
+            "Redis URL must specify one of the following schemes "
+            "(redis://, rediss://, unix://)"
         )
 
 
 class TestConnectionPoolUnixSocketURLParsing:
     def test_defaults(self):
-        pool = redis.ConnectionPool.from_url('unix:///socket')
+        pool = redis.ConnectionPool.from_url("unix:///socket")
         assert pool.connection_class == redis.UnixDomainSocketConnection
         assert pool.connection_kwargs == {
-            'path': '/socket',
+            "path": "/socket",
         }
 
     @skip_if_server_version_lt("6.0.0")
     def test_username(self):
-        pool = redis.ConnectionPool.from_url('unix://myuser:@/socket')
+        pool = redis.ConnectionPool.from_url("unix://myuser:@/socket")
         assert pool.connection_class == redis.UnixDomainSocketConnection
         assert pool.connection_kwargs == {
-            'path': '/socket',
-            'username': 'myuser',
+            "path": "/socket",
+            "username": "myuser",
         }
 
     @skip_if_server_version_lt("6.0.0")
     def test_quoted_username(self):
         pool = redis.ConnectionPool.from_url(
-            'unix://%2Fmyuser%2F%2B name%3D%24+:@/socket')
+            "unix://%2Fmyuser%2F%2B name%3D%24+:@/socket"
+        )
         assert pool.connection_class == redis.UnixDomainSocketConnection
         assert pool.connection_kwargs == {
-            'path': '/socket',
-            'username': '/myuser/+ name=$+',
+            "path": "/socket",
+            "username": "/myuser/+ name=$+",
         }
 
     def test_password(self):
-        pool = redis.ConnectionPool.from_url('unix://:mypassword@/socket')
+        pool = redis.ConnectionPool.from_url("unix://:mypassword@/socket")
         assert pool.connection_class == redis.UnixDomainSocketConnection
         assert pool.connection_kwargs == {
-            'path': '/socket',
-            'password': 'mypassword',
+            "path": "/socket",
+            "password": "mypassword",
         }
 
     def test_quoted_password(self):
         pool = redis.ConnectionPool.from_url(
-            'unix://:%2Fmypass%2F%2B word%3D%24+@/socket')
+            "unix://:%2Fmypass%2F%2B word%3D%24+@/socket"
+        )
         assert pool.connection_class == redis.UnixDomainSocketConnection
         assert pool.connection_kwargs == {
-            'path': '/socket',
-            'password': '/mypass/+ word=$+',
+            "path": "/socket",
+            "password": "/mypass/+ word=$+",
         }
 
     def test_quoted_path(self):
         pool = redis.ConnectionPool.from_url(
-            'unix://:mypassword@/my%2Fpath%2Fto%2F..%2F+_%2B%3D%24ocket')
+            "unix://:mypassword@/my%2Fpath%2Fto%2F..%2F+_%2B%3D%24ocket"
+        )
         assert pool.connection_class == redis.UnixDomainSocketConnection
         assert pool.connection_kwargs == {
-            'path': '/my/path/to/../+_+=$ocket',
-            'password': 'mypassword',
+            "path": "/my/path/to/../+_+=$ocket",
+            "password": "mypassword",
         }
 
     def test_db_as_argument(self):
-        pool = redis.ConnectionPool.from_url('unix:///socket', db=1)
+        pool = redis.ConnectionPool.from_url("unix:///socket", db=1)
         assert pool.connection_class == redis.UnixDomainSocketConnection
         assert pool.connection_kwargs == {
-            'path': '/socket',
-            'db': 1,
+            "path": "/socket",
+            "db": 1,
         }
 
     def test_db_in_querystring(self):
-        pool = redis.ConnectionPool.from_url('unix:///socket?db=2', db=1)
+        pool = redis.ConnectionPool.from_url("unix:///socket?db=2", db=1)
         assert pool.connection_class == redis.UnixDomainSocketConnection
         assert pool.connection_kwargs == {
-            'path': '/socket',
-            'db': 2,
+            "path": "/socket",
+            "db": 2,
         }
 
     def test_client_name_in_querystring(self):
-        pool = redis.ConnectionPool.from_url(
-            'redis://location?client_name=test-client'
-        )
-        assert pool.connection_kwargs['client_name'] == 'test-client'
+        pool = redis.ConnectionPool.from_url("redis://location?client_name=test-client")
+        assert pool.connection_kwargs["client_name"] == "test-client"
 
     def test_extra_querystring_options(self):
-        pool = redis.ConnectionPool.from_url('unix:///socket?a=1&b=2')
+        pool = redis.ConnectionPool.from_url("unix:///socket?a=1&b=2")
         assert pool.connection_class == redis.UnixDomainSocketConnection
-        assert pool.connection_kwargs == {
-            'path': '/socket',
-            'a': '1',
-            'b': '2'
-        }
+        assert pool.connection_kwargs == {"path": "/socket", "a": "1", "b": "2"}
 
 
 @pytest.mark.skipif(not ssl_available, reason="SSL not installed")
 class TestSSLConnectionURLParsing:
     def test_host(self):
-        pool = redis.ConnectionPool.from_url('rediss://my.host')
+        pool = redis.ConnectionPool.from_url("rediss://my.host")
         assert pool.connection_class == redis.SSLConnection
         assert pool.connection_kwargs == {
-            'host': 'my.host',
+            "host": "my.host",
         }
 
     def test_cert_reqs_options(self):
@@ -447,25 +462,20 @@ class DummyConnectionPool(redis.ConnectionPool):
             def get_connection(self, *args, **kwargs):
                 return self.make_connection()
 
-        pool = DummyConnectionPool.from_url(
-            'rediss://?ssl_cert_reqs=none')
-        assert pool.get_connection('_').cert_reqs == ssl.CERT_NONE
+        pool = DummyConnectionPool.from_url("rediss://?ssl_cert_reqs=none")
+        assert pool.get_connection("_").cert_reqs == ssl.CERT_NONE
 
-        pool = DummyConnectionPool.from_url(
-            'rediss://?ssl_cert_reqs=optional')
-        assert pool.get_connection('_').cert_reqs == ssl.CERT_OPTIONAL
+        pool = DummyConnectionPool.from_url("rediss://?ssl_cert_reqs=optional")
+        assert pool.get_connection("_").cert_reqs == ssl.CERT_OPTIONAL
 
-        pool = DummyConnectionPool.from_url(
-            'rediss://?ssl_cert_reqs=required')
-        assert pool.get_connection('_').cert_reqs == ssl.CERT_REQUIRED
+        pool = DummyConnectionPool.from_url("rediss://?ssl_cert_reqs=required")
+        assert pool.get_connection("_").cert_reqs == ssl.CERT_REQUIRED
 
-        pool = DummyConnectionPool.from_url(
-            'rediss://?ssl_check_hostname=False')
-        assert pool.get_connection('_').check_hostname is False
+        pool = DummyConnectionPool.from_url("rediss://?ssl_check_hostname=False")
+        assert pool.get_connection("_").check_hostname is False
 
-        pool = DummyConnectionPool.from_url(
-            'rediss://?ssl_check_hostname=True')
-        assert pool.get_connection('_').check_hostname is True
+        pool = DummyConnectionPool.from_url("rediss://?ssl_check_hostname=True")
+        assert pool.get_connection("_").check_hostname is True
 
 
 class TestConnection:
@@ -485,7 +495,7 @@ def test_on_connect_error(self):
         assert not pool._available_connections[0]._sock
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.8.8')
+    @skip_if_server_version_lt("2.8.8")
     @skip_if_redis_enterprise
     def test_busy_loading_disconnects_socket(self, r):
         """
@@ -493,11 +503,11 @@ def test_busy_loading_disconnects_socket(self, r):
         disconnected and a BusyLoadingError raised
         """
         with pytest.raises(redis.BusyLoadingError):
-            r.execute_command('DEBUG', 'ERROR', 'LOADING fake message')
+            r.execute_command("DEBUG", "ERROR", "LOADING fake message")
         assert not r.connection._sock
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.8.8')
+    @skip_if_server_version_lt("2.8.8")
     @skip_if_redis_enterprise
     def test_busy_loading_from_pipeline_immediate_command(self, r):
         """
@@ -506,15 +516,14 @@ def test_busy_loading_from_pipeline_immediate_command(self, r):
         """
         pipe = r.pipeline()
         with pytest.raises(redis.BusyLoadingError):
-            pipe.immediate_execute_command('DEBUG', 'ERROR',
-                                           'LOADING fake message')
+            pipe.immediate_execute_command("DEBUG", "ERROR", "LOADING fake message")
         pool = r.connection_pool
         assert not pipe.connection
         assert len(pool._available_connections) == 1
         assert not pool._available_connections[0]._sock
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.8.8')
+    @skip_if_server_version_lt("2.8.8")
     @skip_if_redis_enterprise
     def test_busy_loading_from_pipeline(self, r):
         """
@@ -522,7 +531,7 @@ def test_busy_loading_from_pipeline(self, r):
         regardless of the raise_on_error flag.
         """
         pipe = r.pipeline()
-        pipe.execute_command('DEBUG', 'ERROR', 'LOADING fake message')
+        pipe.execute_command("DEBUG", "ERROR", "LOADING fake message")
         with pytest.raises(redis.BusyLoadingError):
             pipe.execute()
         pool = r.connection_pool
@@ -530,31 +539,31 @@ def test_busy_loading_from_pipeline(self, r):
         assert len(pool._available_connections) == 1
         assert not pool._available_connections[0]._sock
 
-    @skip_if_server_version_lt('2.8.8')
+    @skip_if_server_version_lt("2.8.8")
     @skip_if_redis_enterprise
     def test_read_only_error(self, r):
         "READONLY errors get turned in ReadOnlyError exceptions"
         with pytest.raises(redis.ReadOnlyError):
-            r.execute_command('DEBUG', 'ERROR', 'READONLY blah blah')
+            r.execute_command("DEBUG", "ERROR", "READONLY blah blah")
 
     def test_connect_from_url_tcp(self):
-        connection = redis.Redis.from_url('redis://localhost')
+        connection = redis.Redis.from_url("redis://localhost")
         pool = connection.connection_pool
 
-        assert re.match('(.*)<(.*)<(.*)>>', repr(pool)).groups() == (
-            'ConnectionPool',
-            'Connection',
-            'host=localhost,port=6379,db=0',
+        assert re.match("(.*)<(.*)<(.*)>>", repr(pool)).groups() == (
+            "ConnectionPool",
+            "Connection",
+            "host=localhost,port=6379,db=0",
         )
 
     def test_connect_from_url_unix(self):
-        connection = redis.Redis.from_url('unix:///path/to/socket')
+        connection = redis.Redis.from_url("unix:///path/to/socket")
         pool = connection.connection_pool
 
-        assert re.match('(.*)<(.*)<(.*)>>', repr(pool)).groups() == (
-            'ConnectionPool',
-            'UnixDomainSocketConnection',
-            'path=/path/to/socket,db=0',
+        assert re.match("(.*)<(.*)<(.*)>>", repr(pool)).groups() == (
+            "ConnectionPool",
+            "UnixDomainSocketConnection",
+            "path=/path/to/socket,db=0",
         )
 
     @skip_if_redis_enterprise
@@ -564,28 +573,27 @@ def test_connect_no_auth_supplied_when_required(self, r):
         password but one isn't supplied.
         """
         with pytest.raises(redis.AuthenticationError):
-            r.execute_command('DEBUG', 'ERROR',
-                              'ERR Client sent AUTH, but no password is set')
+            r.execute_command(
+                "DEBUG", "ERROR", "ERR Client sent AUTH, but no password is set"
+            )
 
     @skip_if_redis_enterprise
     def test_connect_invalid_password_supplied(self, r):
         "AuthenticationError should be raised when sending the wrong password"
         with pytest.raises(redis.AuthenticationError):
-            r.execute_command('DEBUG', 'ERROR', 'ERR invalid password')
+            r.execute_command("DEBUG", "ERROR", "ERR invalid password")
 
 
 @pytest.mark.onlynoncluster
 class TestMultiConnectionClient:
     @pytest.fixture()
     def r(self, request):
-        return _get_client(redis.Redis,
-                           request,
-                           single_connection_client=False)
+        return _get_client(redis.Redis, request, single_connection_client=False)
 
     def test_multi_connection_command(self, r):
         assert not r.connection
-        assert r.set('a', '123')
-        assert r.get('a') == b'123'
+        assert r.set("a", "123")
+        assert r.get("a") == b"123"
 
 
 @pytest.mark.onlynoncluster
@@ -594,8 +602,7 @@ class TestHealthCheck:
 
     @pytest.fixture()
     def r(self, request):
-        return _get_client(redis.Redis, request,
-                           health_check_interval=self.interval)
+        return _get_client(redis.Redis, request, health_check_interval=self.interval)
 
     def assert_interval_advanced(self, connection):
         diff = connection.next_health_check - time.time()
@@ -608,61 +615,66 @@ def test_health_check_runs(self, r):
 
     def test_arbitrary_command_invokes_health_check(self, r):
         # invoke a command to make sure the connection is entirely setup
-        r.get('foo')
+        r.get("foo")
         r.connection.next_health_check = time.time()
-        with mock.patch.object(r.connection, 'send_command',
-                               wraps=r.connection.send_command) as m:
-            r.get('foo')
-            m.assert_called_with('PING', check_health=False)
+        with mock.patch.object(
+            r.connection, "send_command", wraps=r.connection.send_command
+        ) as m:
+            r.get("foo")
+            m.assert_called_with("PING", check_health=False)
 
         self.assert_interval_advanced(r.connection)
 
     def test_arbitrary_command_advances_next_health_check(self, r):
-        r.get('foo')
+        r.get("foo")
         next_health_check = r.connection.next_health_check
-        r.get('foo')
+        r.get("foo")
         assert next_health_check < r.connection.next_health_check
 
     def test_health_check_not_invoked_within_interval(self, r):
-        r.get('foo')
-        with mock.patch.object(r.connection, 'send_command',
-                               wraps=r.connection.send_command) as m:
-            r.get('foo')
-            ping_call_spec = (('PING',), {'check_health': False})
+        r.get("foo")
+        with mock.patch.object(
+            r.connection, "send_command", wraps=r.connection.send_command
+        ) as m:
+            r.get("foo")
+            ping_call_spec = (("PING",), {"check_health": False})
             assert ping_call_spec not in m.call_args_list
 
     def test_health_check_in_pipeline(self, r):
         with r.pipeline(transaction=False) as pipe:
-            pipe.connection = pipe.connection_pool.get_connection('_')
+            pipe.connection = pipe.connection_pool.get_connection("_")
             pipe.connection.next_health_check = 0
-            with mock.patch.object(pipe.connection, 'send_command',
-                                   wraps=pipe.connection.send_command) as m:
-                responses = pipe.set('foo', 'bar').get('foo').execute()
-                m.assert_any_call('PING', check_health=False)
-                assert responses == [True, b'bar']
+            with mock.patch.object(
+                pipe.connection, "send_command", wraps=pipe.connection.send_command
+            ) as m:
+                responses = pipe.set("foo", "bar").get("foo").execute()
+                m.assert_any_call("PING", check_health=False)
+                assert responses == [True, b"bar"]
 
     def test_health_check_in_transaction(self, r):
         with r.pipeline(transaction=True) as pipe:
-            pipe.connection = pipe.connection_pool.get_connection('_')
+            pipe.connection = pipe.connection_pool.get_connection("_")
             pipe.connection.next_health_check = 0
-            with mock.patch.object(pipe.connection, 'send_command',
-                                   wraps=pipe.connection.send_command) as m:
-                responses = pipe.set('foo', 'bar').get('foo').execute()
-                m.assert_any_call('PING', check_health=False)
-                assert responses == [True, b'bar']
+            with mock.patch.object(
+                pipe.connection, "send_command", wraps=pipe.connection.send_command
+            ) as m:
+                responses = pipe.set("foo", "bar").get("foo").execute()
+                m.assert_any_call("PING", check_health=False)
+                assert responses == [True, b"bar"]
 
     def test_health_check_in_watched_pipeline(self, r):
-        r.set('foo', 'bar')
+        r.set("foo", "bar")
         with r.pipeline(transaction=False) as pipe:
-            pipe.connection = pipe.connection_pool.get_connection('_')
+            pipe.connection = pipe.connection_pool.get_connection("_")
             pipe.connection.next_health_check = 0
-            with mock.patch.object(pipe.connection, 'send_command',
-                                   wraps=pipe.connection.send_command) as m:
-                pipe.watch('foo')
+            with mock.patch.object(
+                pipe.connection, "send_command", wraps=pipe.connection.send_command
+            ) as m:
+                pipe.watch("foo")
                 # the health check should be called when watching
-                m.assert_called_with('PING', check_health=False)
+                m.assert_called_with("PING", check_health=False)
                 self.assert_interval_advanced(pipe.connection)
-                assert pipe.get('foo') == b'bar'
+                assert pipe.get("foo") == b"bar"
 
                 # reset the mock to clear the call list and schedule another
                 # health check
@@ -670,27 +682,28 @@ def test_health_check_in_watched_pipeline(self, r):
                 pipe.connection.next_health_check = 0
 
                 pipe.multi()
-                responses = pipe.set('foo', 'not-bar').get('foo').execute()
-                assert responses == [True, b'not-bar']
-                m.assert_any_call('PING', check_health=False)
+                responses = pipe.set("foo", "not-bar").get("foo").execute()
+                assert responses == [True, b"not-bar"]
+                m.assert_any_call("PING", check_health=False)
 
     def test_health_check_in_pubsub_before_subscribe(self, r):
         "A health check happens before the first [p]subscribe"
         p = r.pubsub()
-        p.connection = p.connection_pool.get_connection('_')
+        p.connection = p.connection_pool.get_connection("_")
         p.connection.next_health_check = 0
-        with mock.patch.object(p.connection, 'send_command',
-                               wraps=p.connection.send_command) as m:
+        with mock.patch.object(
+            p.connection, "send_command", wraps=p.connection.send_command
+        ) as m:
             assert not p.subscribed
-            p.subscribe('foo')
+            p.subscribe("foo")
             # the connection is not yet in pubsub mode, so the normal
             # ping/pong within connection.send_command should check
             # the health of the connection
-            m.assert_any_call('PING', check_health=False)
+            m.assert_any_call("PING", check_health=False)
             self.assert_interval_advanced(p.connection)
 
             subscribe_message = wait_for_message(p)
-            assert subscribe_message['type'] == 'subscribe'
+            assert subscribe_message["type"] == "subscribe"
 
     def test_health_check_in_pubsub_after_subscribed(self, r):
         """
@@ -698,38 +711,38 @@ def test_health_check_in_pubsub_after_subscribed(self, r):
         connection health
         """
         p = r.pubsub()
-        p.connection = p.connection_pool.get_connection('_')
+        p.connection = p.connection_pool.get_connection("_")
         p.connection.next_health_check = 0
-        with mock.patch.object(p.connection, 'send_command',
-                               wraps=p.connection.send_command) as m:
-            p.subscribe('foo')
+        with mock.patch.object(
+            p.connection, "send_command", wraps=p.connection.send_command
+        ) as m:
+            p.subscribe("foo")
             subscribe_message = wait_for_message(p)
-            assert subscribe_message['type'] == 'subscribe'
+            assert subscribe_message["type"] == "subscribe"
             self.assert_interval_advanced(p.connection)
             # because we weren't subscribed when sending the subscribe
             # message to 'foo', the connection's standard check_health ran
             # prior to subscribing.
-            m.assert_any_call('PING', check_health=False)
+            m.assert_any_call("PING", check_health=False)
 
             p.connection.next_health_check = 0
             m.reset_mock()
 
-            p.subscribe('bar')
+            p.subscribe("bar")
             # the second subscribe issues exactly only command (the subscribe)
             # and the health check is not invoked
-            m.assert_called_once_with('SUBSCRIBE', 'bar', check_health=False)
+            m.assert_called_once_with("SUBSCRIBE", "bar", check_health=False)
 
             # since no message has been read since the health check was
             # reset, it should still be 0
             assert p.connection.next_health_check == 0
 
             subscribe_message = wait_for_message(p)
-            assert subscribe_message['type'] == 'subscribe'
+            assert subscribe_message["type"] == "subscribe"
             assert wait_for_message(p) is None
             # now that the connection is subscribed, the pubsub health
             # check should have taken over and include the HEALTH_CHECK_MESSAGE
-            m.assert_any_call('PING', p.HEALTH_CHECK_MESSAGE,
-                              check_health=False)
+            m.assert_any_call("PING", p.HEALTH_CHECK_MESSAGE, check_health=False)
             self.assert_interval_advanced(p.connection)
 
     def test_health_check_in_pubsub_poll(self, r):
@@ -738,12 +751,13 @@ def test_health_check_in_pubsub_poll(self, r):
         check the connection's health.
         """
         p = r.pubsub()
-        p.connection = p.connection_pool.get_connection('_')
-        with mock.patch.object(p.connection, 'send_command',
-                               wraps=p.connection.send_command) as m:
-            p.subscribe('foo')
+        p.connection = p.connection_pool.get_connection("_")
+        with mock.patch.object(
+            p.connection, "send_command", wraps=p.connection.send_command
+        ) as m:
+            p.subscribe("foo")
             subscribe_message = wait_for_message(p)
-            assert subscribe_message['type'] == 'subscribe'
+            assert subscribe_message["type"] == "subscribe"
             self.assert_interval_advanced(p.connection)
 
             # polling the connection before the health check interval
@@ -759,6 +773,5 @@ def test_health_check_in_pubsub_poll(self, r):
             # should be advanced
             p.connection.next_health_check = 0
             assert wait_for_message(p) is None
-            m.assert_called_with('PING', p.HEALTH_CHECK_MESSAGE,
-                                 check_health=False)
+            m.assert_called_with("PING", p.HEALTH_CHECK_MESSAGE, check_health=False)
             self.assert_interval_advanced(p.connection)
diff --git a/tests/test_encoding.py b/tests/test_encoding.py
index 706654f89f..bd0f09fcc0 100644
--- a/tests/test_encoding.py
+++ b/tests/test_encoding.py
@@ -1,7 +1,8 @@
 import pytest
-import redis
 
+import redis
 from redis.connection import Connection
+
 from .conftest import _get_client
 
 
@@ -19,62 +20,70 @@ def r_no_decode(self, request):
         )
 
     def test_simple_encoding(self, r_no_decode):
-        unicode_string = chr(3456) + 'abcd' + chr(3421)
-        r_no_decode['unicode-string'] = unicode_string.encode('utf-8')
-        cached_val = r_no_decode['unicode-string']
+        unicode_string = chr(3456) + "abcd" + chr(3421)
+        r_no_decode["unicode-string"] = unicode_string.encode("utf-8")
+        cached_val = r_no_decode["unicode-string"]
         assert isinstance(cached_val, bytes)
-        assert unicode_string == cached_val.decode('utf-8')
+        assert unicode_string == cached_val.decode("utf-8")
 
     def test_simple_encoding_and_decoding(self, r):
-        unicode_string = chr(3456) + 'abcd' + chr(3421)
-        r['unicode-string'] = unicode_string
-        cached_val = r['unicode-string']
+        unicode_string = chr(3456) + "abcd" + chr(3421)
+        r["unicode-string"] = unicode_string
+        cached_val = r["unicode-string"]
         assert isinstance(cached_val, str)
         assert unicode_string == cached_val
 
     def test_memoryview_encoding(self, r_no_decode):
-        unicode_string = chr(3456) + 'abcd' + chr(3421)
-        unicode_string_view = memoryview(unicode_string.encode('utf-8'))
-        r_no_decode['unicode-string-memoryview'] = unicode_string_view
-        cached_val = r_no_decode['unicode-string-memoryview']
+        unicode_string = chr(3456) + "abcd" + chr(3421)
+        unicode_string_view = memoryview(unicode_string.encode("utf-8"))
+        r_no_decode["unicode-string-memoryview"] = unicode_string_view
+        cached_val = r_no_decode["unicode-string-memoryview"]
         # The cached value won't be a memoryview because it's a copy from Redis
         assert isinstance(cached_val, bytes)
-        assert unicode_string == cached_val.decode('utf-8')
+        assert unicode_string == cached_val.decode("utf-8")
 
     def test_memoryview_encoding_and_decoding(self, r):
-        unicode_string = chr(3456) + 'abcd' + chr(3421)
-        unicode_string_view = memoryview(unicode_string.encode('utf-8'))
-        r['unicode-string-memoryview'] = unicode_string_view
-        cached_val = r['unicode-string-memoryview']
+        unicode_string = chr(3456) + "abcd" + chr(3421)
+        unicode_string_view = memoryview(unicode_string.encode("utf-8"))
+        r["unicode-string-memoryview"] = unicode_string_view
+        cached_val = r["unicode-string-memoryview"]
         assert isinstance(cached_val, str)
         assert unicode_string == cached_val
 
     def test_list_encoding(self, r):
-        unicode_string = chr(3456) + 'abcd' + chr(3421)
+        unicode_string = chr(3456) + "abcd" + chr(3421)
         result = [unicode_string, unicode_string, unicode_string]
-        r.rpush('a', *result)
-        assert r.lrange('a', 0, -1) == result
+        r.rpush("a", *result)
+        assert r.lrange("a", 0, -1) == result
 
 
 class TestEncodingErrors:
     def test_ignore(self, request):
-        r = _get_client(redis.Redis, request=request, decode_responses=True,
-                        encoding_errors='ignore')
-        r.set('a', b'foo\xff')
-        assert r.get('a') == 'foo'
+        r = _get_client(
+            redis.Redis,
+            request=request,
+            decode_responses=True,
+            encoding_errors="ignore",
+        )
+        r.set("a", b"foo\xff")
+        assert r.get("a") == "foo"
 
     def test_replace(self, request):
-        r = _get_client(redis.Redis, request=request, decode_responses=True,
-                        encoding_errors='replace')
-        r.set('a', b'foo\xff')
-        assert r.get('a') == 'foo\ufffd'
+        r = _get_client(
+            redis.Redis,
+            request=request,
+            decode_responses=True,
+            encoding_errors="replace",
+        )
+        r.set("a", b"foo\xff")
+        assert r.get("a") == "foo\ufffd"
 
 
 class TestMemoryviewsAreNotPacked:
     def test_memoryviews_are_not_packed(self):
         c = Connection()
-        arg = memoryview(b'some_arg')
-        arg_list = ['SOME_COMMAND', arg]
+        arg = memoryview(b"some_arg")
+        arg_list = ["SOME_COMMAND", arg]
         cmd = c.pack_command(*arg_list)
         assert cmd[1] is arg
         cmds = c.pack_commands([arg_list, arg_list])
@@ -85,25 +94,25 @@ def test_memoryviews_are_not_packed(self):
 class TestCommandsAreNotEncoded:
     @pytest.fixture()
     def r(self, request):
-        return _get_client(redis.Redis, request=request, encoding='utf-16')
+        return _get_client(redis.Redis, request=request, encoding="utf-16")
 
     def test_basic_command(self, r):
-        r.set('hello', 'world')
+        r.set("hello", "world")
 
 
 class TestInvalidUserInput:
     def test_boolean_fails(self, r):
         with pytest.raises(redis.DataError):
-            r.set('a', True)
+            r.set("a", True)
 
     def test_none_fails(self, r):
         with pytest.raises(redis.DataError):
-            r.set('a', None)
+            r.set("a", None)
 
     def test_user_type_fails(self, r):
         class Foo:
             def __str__(self):
-                return 'Foo'
+                return "Foo"
 
         with pytest.raises(redis.DataError):
-            r.set('a', Foo())
+            r.set("a", Foo())
diff --git a/tests/test_helpers.py b/tests/test_helpers.py
index 402eccf0a2..359582909f 100644
--- a/tests/test_helpers.py
+++ b/tests/test_helpers.py
@@ -1,19 +1,20 @@
 import string
+
 from redis.commands.helpers import (
     delist,
     list_or_args,
     nativestr,
+    parse_to_dict,
     parse_to_list,
     quote_string,
     random_string,
-    parse_to_dict
 )
 
 
 def test_list_or_args():
     k = ["hello, world"]
     a = ["some", "argument", "list"]
-    assert list_or_args(k, a) == k+a
+    assert list_or_args(k, a) == k + a
 
     for i in ["banana", b"banana"]:
         assert list_or_args(i, a) == [i] + a
@@ -22,42 +23,50 @@ def test_list_or_args():
 def test_parse_to_list():
     assert parse_to_list(None) == []
     r = ["hello", b"my name", "45", "555.55", "is simon!", None]
-    assert parse_to_list(r) == \
-        ["hello", "my name", 45, 555.55, "is simon!", None]
+    assert parse_to_list(r) == ["hello", "my name", 45, 555.55, "is simon!", None]
 
 
 def test_parse_to_dict():
     assert parse_to_dict(None) == {}
-    r = [['Some number', '1.0345'],
-         ['Some string', 'hello'],
-         ['Child iterators',
-          ['Time', '0.2089', 'Counter', 3, 'Child iterators',
-           ['Type', 'bar', 'Time', '0.0729', 'Counter', 3],
-           ['Type', 'barbar', 'Time', '0.058', 'Counter', 3]]]]
+    r = [
+        ["Some number", "1.0345"],
+        ["Some string", "hello"],
+        [
+            "Child iterators",
+            [
+                "Time",
+                "0.2089",
+                "Counter",
+                3,
+                "Child iterators",
+                ["Type", "bar", "Time", "0.0729", "Counter", 3],
+                ["Type", "barbar", "Time", "0.058", "Counter", 3],
+            ],
+        ],
+    ]
     assert parse_to_dict(r) == {
-        'Child iterators': {
-            'Child iterators': [
-                {'Counter': 3.0, 'Time': 0.0729, 'Type': 'bar'},
-                {'Counter': 3.0, 'Time': 0.058, 'Type': 'barbar'}
+        "Child iterators": {
+            "Child iterators": [
+                {"Counter": 3.0, "Time": 0.0729, "Type": "bar"},
+                {"Counter": 3.0, "Time": 0.058, "Type": "barbar"},
             ],
-            'Counter': 3.0,
-            'Time': 0.2089
+            "Counter": 3.0,
+            "Time": 0.2089,
         },
-        'Some number': 1.0345,
-        'Some string': 'hello'
+        "Some number": 1.0345,
+        "Some string": "hello",
     }
 
 
 def test_nativestr():
-    assert nativestr('teststr') == 'teststr'
-    assert nativestr(b'teststr') == 'teststr'
-    assert nativestr('null') is None
+    assert nativestr("teststr") == "teststr"
+    assert nativestr(b"teststr") == "teststr"
+    assert nativestr("null") is None
 
 
 def test_delist():
     assert delist(None) is None
-    assert delist([b'hello', 'world', b'banana']) == \
-        ['hello', 'world', 'banana']
+    assert delist([b"hello", "world", b"banana"]) == ["hello", "world", "banana"]
 
 
 def test_random_string():
@@ -69,5 +78,5 @@ def test_random_string():
 
 def test_quote_string():
     assert quote_string("hello world!") == '"hello world!"'
-    assert quote_string('') == '""'
-    assert quote_string('hello world!') == '"hello world!"'
+    assert quote_string("") == '""'
+    assert quote_string("hello world!") == '"hello world!"'
diff --git a/tests/test_json.py b/tests/test_json.py
index 187bfe2289..1686f9d05e 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -1,8 +1,10 @@
 import pytest
+
 import redis
-from redis.commands.json.path import Path
 from redis import exceptions
-from redis.commands.json.decoders import unstring, decode_list
+from redis.commands.json.decoders import decode_list, unstring
+from redis.commands.json.path import Path
+
 from .conftest import skip_ifmodversion_lt
 
 
@@ -48,9 +50,7 @@ def test_json_get_jset(client):
 @pytest.mark.redismod
 def test_nonascii_setgetdelete(client):
     assert client.json().set("notascii", Path.rootPath(), "hyvää-élève")
-    assert "hyvää-élève" == client.json().get(
-        "notascii",
-        no_escape=True)
+    assert "hyvää-élève" == client.json().get("notascii", no_escape=True)
     assert 1 == client.json().delete("notascii")
     assert client.exists("notascii") == 0
 
@@ -179,7 +179,7 @@ def test_arrinsert(client):
             1,
             2,
             3,
-        ]
+        ],
     )
     assert [0, 1, 2, 3, 4] == client.json().get("arr")
 
@@ -307,8 +307,7 @@ def test_json_delete_with_dollar(client):
     r = client.json().get("doc1", "$")
     assert r == [{"nested": {"b": 3}}]
 
-    doc2 = {"a": {"a": 2, "b": 3}, "b": [
-        "a", "b"], "nested": {"b": [True, "a", "b"]}}
+    doc2 = {"a": {"a": 2, "b": 3}, "b": ["a", "b"], "nested": {"b": [True, "a", "b"]}}
     assert client.json().set("doc2", "$", doc2)
     assert client.json().delete("doc2", "$..a") == 1
     res = client.json().get("doc2", "$")
@@ -361,8 +360,7 @@ def test_json_forget_with_dollar(client):
     r = client.json().get("doc1", "$")
     assert r == [{"nested": {"b": 3}}]
 
-    doc2 = {"a": {"a": 2, "b": 3}, "b": [
-        "a", "b"], "nested": {"b": [True, "a", "b"]}}
+    doc2 = {"a": {"a": 2, "b": 3}, "b": ["a", "b"], "nested": {"b": [True, "a", "b"]}}
     assert client.json().set("doc2", "$", doc2)
     assert client.json().forget("doc2", "$..a") == 1
     res = client.json().get("doc2", "$")
@@ -413,16 +411,12 @@ def test_json_mget_dollar(client):
     client.json().set(
         "doc1",
         "$",
-        {"a": 1,
-            "b": 2,
-            "nested": {"a": 3},
-            "c": None, "nested2": {"a": None}},
+        {"a": 1, "b": 2, "nested": {"a": 3}, "c": None, "nested2": {"a": None}},
     )
     client.json().set(
         "doc2",
         "$",
-        {"a": 4, "b": 5, "nested": {"a": 6},
-            "c": None, "nested2": {"a": [None]}},
+        {"a": 4, "b": 5, "nested": {"a": 6}, "c": None, "nested2": {"a": [None]}},
     )
     # Compare also to single JSON.GET
     assert client.json().get("doc1", "$..a") == [1, 3, None]
@@ -431,8 +425,7 @@ def test_json_mget_dollar(client):
     # Test mget with single path
     client.json().mget("doc1", "$..a") == [1, 3, None]
     # Test mget with multi path
-    client.json().mget(["doc1", "doc2"], "$..a") == [
-        [1, 3, None], [4, 6, [None]]]
+    client.json().mget(["doc1", "doc2"], "$..a") == [[1, 3, None], [4, 6, [None]]]
 
     # Test missing key
     client.json().mget(["doc1", "missing_doc"], "$..a") == [[1, 3, None], None]
@@ -444,15 +437,11 @@ def test_json_mget_dollar(client):
 def test_numby_commands_dollar(client):
 
     # Test NUMINCRBY
-    client.json().set(
-        "doc1",
-        "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]})
+    client.json().set("doc1", "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]})
     # Test multi
-    assert client.json().numincrby("doc1", "$..a", 2) == \
-        [None, 4, 7.0, None]
+    assert client.json().numincrby("doc1", "$..a", 2) == [None, 4, 7.0, None]
 
-    assert client.json().numincrby("doc1", "$..a", 2.5) == \
-        [None, 6.5, 9.5, None]
+    assert client.json().numincrby("doc1", "$..a", 2.5) == [None, 6.5, 9.5, None]
     # Test single
     assert client.json().numincrby("doc1", "$.b[1].a", 2) == [11.5]
 
@@ -460,15 +449,12 @@ def test_numby_commands_dollar(client):
     assert client.json().numincrby("doc1", "$.b[1].a", 3.5) == [15.0]
 
     # Test NUMMULTBY
-    client.json().set("doc1", "$", {"a": "b", "b": [
-        {"a": 2}, {"a": 5.0}, {"a": "c"}]})
+    client.json().set("doc1", "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]})
 
     # test list
     with pytest.deprecated_call():
-        assert client.json().nummultby("doc1", "$..a", 2) == \
-            [None, 4, 10, None]
-        assert client.json().nummultby("doc1", "$..a", 2.5) == \
-            [None, 10.0, 25.0, None]
+        assert client.json().nummultby("doc1", "$..a", 2) == [None, 4, 10, None]
+        assert client.json().nummultby("doc1", "$..a", 2.5) == [None, 10.0, 25.0, None]
 
     # Test single
     with pytest.deprecated_call():
@@ -482,13 +468,11 @@ def test_numby_commands_dollar(client):
         client.json().nummultby("non_existing_doc", "$..a", 2)
 
     # Test legacy NUMINCRBY
-    client.json().set("doc1", "$", {"a": "b", "b": [
-        {"a": 2}, {"a": 5.0}, {"a": "c"}]})
+    client.json().set("doc1", "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]})
     client.json().numincrby("doc1", ".b[0].a", 3) == 5
 
     # Test legacy NUMMULTBY
-    client.json().set("doc1", "$", {"a": "b", "b": [
-        {"a": 2}, {"a": 5.0}, {"a": "c"}]})
+    client.json().set("doc1", "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]})
 
     with pytest.deprecated_call():
         client.json().nummultby("doc1", ".b[0].a", 3) == 6
@@ -498,8 +482,7 @@ def test_numby_commands_dollar(client):
 def test_strappend_dollar(client):
 
     client.json().set(
-        "doc1", "$", {"a": "foo", "nested1": {
-            "a": "hello"}, "nested2": {"a": 31}}
+        "doc1", "$", {"a": "foo", "nested1": {"a": "hello"}, "nested2": {"a": 31}}
     )
     # Test multi
     client.json().strappend("doc1", "bar", "$..a") == [6, 8, None]
@@ -534,8 +517,7 @@ def test_strlen_dollar(client):
 
     # Test multi
     client.json().set(
-        "doc1", "$", {"a": "foo", "nested1": {
-            "a": "hello"}, "nested2": {"a": 31}}
+        "doc1", "$", {"a": "foo", "nested1": {"a": "hello"}, "nested2": {"a": 31}}
     )
     assert client.json().strlen("doc1", "$..a") == [3, 5, None]
 
@@ -634,8 +616,7 @@ def test_arrinsert_dollar(client):
         },
     )
     # Test multi
-    assert client.json().arrinsert("doc1", "$..a", "1",
-                                   "bar", "racuda") == [3, 5, None]
+    assert client.json().arrinsert("doc1", "$..a", "1", "bar", "racuda") == [3, 5, None]
 
     assert client.json().get("doc1", "$") == [
         {
@@ -674,8 +655,11 @@ def test_arrlen_dollar(client):
 
     # Test multi
     assert client.json().arrlen("doc1", "$..a") == [1, 3, None]
-    assert client.json().arrappend("doc1", "$..a", "non", "abba", "stanza") \
-        == [4, 6, None]
+    assert client.json().arrappend("doc1", "$..a", "non", "abba", "stanza") == [
+        4,
+        6,
+        None,
+    ]
 
     client.json().clear("doc1", "$.a")
     assert client.json().arrlen("doc1", "$..a") == [0, 6, None]
@@ -924,8 +908,7 @@ def test_clear_dollar(client):
     assert client.json().clear("doc1", "$..a") == 3
 
     assert client.json().get("doc1", "$") == [
-        {"nested1": {"a": {}}, "a": [], "nested2": {
-            "a": "claro"}, "nested3": {"a": {}}}
+        {"nested1": {"a": {}}, "a": [], "nested2": {"a": "claro"}, "nested3": {"a": {}}}
     ]
 
     # Test single
@@ -994,8 +977,7 @@ def test_debug_dollar(client):
     client.json().set("doc1", "$", jdata)
 
     # Test multi
-    assert client.json().debug("MEMORY", "doc1", "$..a") == [
-        72, 24, 24, 16, 16, 1, 0]
+    assert client.json().debug("MEMORY", "doc1", "$..a") == [72, 24, 24, 16, 16, 1, 0]
 
     # Test single
     assert client.json().debug("MEMORY", "doc1", "$.nested2.a") == [24]
@@ -1234,12 +1216,10 @@ def test_arrindex_dollar(client):
         [],
     ]
 
-    assert client.json().arrindex("test_num", "$..arr", 3) == [
-        3, 2, -1, None, -1]
+    assert client.json().arrindex("test_num", "$..arr", 3) == [3, 2, -1, None, -1]
 
     # Test index of double scalar in multi values
-    assert client.json().arrindex("test_num", "$..arr", 3.0) == [
-        2, 8, -1, None, -1]
+    assert client.json().arrindex("test_num", "$..arr", 3.0) == [2, 8, -1, None, -1]
 
     # Test index of string scalar in multi values
     client.json().set(
@@ -1249,10 +1229,7 @@ def test_arrindex_dollar(client):
             {"arr": ["bazzz", "bar", 2, "baz", 2, "ba", "baz", 3]},
             {
                 "nested1_found": {
-                    "arr": [
-                        None,
-                        "baz2",
-                        "buzz", 2, 1, 0, 1, "2", "baz", 2, 4, 5]
+                    "arr": [None, "baz2", "buzz", 2, 1, 0, 1, "2", "baz", 2, 4, 5]
                 }
             },
             {"nested2_not_found": {"arr": ["baz2", 4, 6]}},
@@ -1344,11 +1321,7 @@ def test_arrindex_dollar(client):
             {"arr": ["bazzz", "None", 2, None, 2, "ba", "baz", 3]},
             {
                 "nested1_found": {
-                    "arr": [
-                        "zaz",
-                        "baz2",
-                        "buzz",
-                        2, 1, 0, 1, "2", None, 2, 4, 5]
+                    "arr": ["zaz", "baz2", "buzz", 2, 1, 0, 1, "2", None, 2, 4, 5]
                 }
             },
             {"nested2_not_found": {"arr": ["None", 4, 6]}},
@@ -1369,8 +1342,7 @@ def test_arrindex_dollar(client):
 
     # Fail with none-scalar value
     with pytest.raises(exceptions.ResponseError):
-        client.json().arrindex(
-            "test_None", "$..nested42_empty_arr.arr", {"arr": []})
+        client.json().arrindex("test_None", "$..nested42_empty_arr.arr", {"arr": []})
 
     # Do not fail with none-scalar value in legacy mode
     assert (
@@ -1392,10 +1364,7 @@ def test_arrindex_dollar(client):
     assert client.json().arrindex("test_string", ".[0].arr", "faz") == -1
     # Test index of None scalar in single value
     assert client.json().arrindex("test_None", ".[0].arr", "None") == 1
-    assert client.json().arrindex(
-        "test_None",
-        "..nested2_not_found.arr",
-        "None") == 0
+    assert client.json().arrindex("test_None", "..nested2_not_found.arr", "None") == 0
 
 
 @pytest.mark.redismod
@@ -1406,14 +1375,15 @@ def test_decoders_and_unstring():
 
     assert decode_list(b"45.55") == 45.55
     assert decode_list("45.55") == 45.55
-    assert decode_list(['hello', b'world']) == ['hello', 'world']
+    assert decode_list(["hello", b"world"]) == ["hello", "world"]
 
 
 @pytest.mark.redismod
 def test_custom_decoder(client):
-    import ujson
     import json
 
+    import ujson
+
     cj = client.json(encoder=ujson, decoder=ujson)
     assert cj.set("foo", Path.rootPath(), "bar")
     assert "bar" == cj.get("foo")
diff --git a/tests/test_lock.py b/tests/test_lock.py
index 66148edcfc..02cca1b522 100644
--- a/tests/test_lock.py
+++ b/tests/test_lock.py
@@ -1,9 +1,11 @@
-import pytest
 import time
 
-from redis.exceptions import LockError, LockNotOwnedError
+import pytest
+
 from redis.client import Redis
+from redis.exceptions import LockError, LockNotOwnedError
 from redis.lock import Lock
+
 from .conftest import _get_client
 
 
@@ -14,36 +16,36 @@ def r_decoded(self, request):
         return _get_client(Redis, request=request, decode_responses=True)
 
     def get_lock(self, redis, *args, **kwargs):
-        kwargs['lock_class'] = Lock
+        kwargs["lock_class"] = Lock
         return redis.lock(*args, **kwargs)
 
     def test_lock(self, r):
-        lock = self.get_lock(r, 'foo')
+        lock = self.get_lock(r, "foo")
         assert lock.acquire(blocking=False)
-        assert r.get('foo') == lock.local.token
-        assert r.ttl('foo') == -1
+        assert r.get("foo") == lock.local.token
+        assert r.ttl("foo") == -1
         lock.release()
-        assert r.get('foo') is None
+        assert r.get("foo") is None
 
     def test_lock_token(self, r):
-        lock = self.get_lock(r, 'foo')
+        lock = self.get_lock(r, "foo")
         self._test_lock_token(r, lock)
 
     def test_lock_token_thread_local_false(self, r):
-        lock = self.get_lock(r, 'foo', thread_local=False)
+        lock = self.get_lock(r, "foo", thread_local=False)
         self._test_lock_token(r, lock)
 
     def _test_lock_token(self, r, lock):
-        assert lock.acquire(blocking=False, token='test')
-        assert r.get('foo') == b'test'
-        assert lock.local.token == b'test'
-        assert r.ttl('foo') == -1
+        assert lock.acquire(blocking=False, token="test")
+        assert r.get("foo") == b"test"
+        assert lock.local.token == b"test"
+        assert r.ttl("foo") == -1
         lock.release()
-        assert r.get('foo') is None
+        assert r.get("foo") is None
         assert lock.local.token is None
 
     def test_locked(self, r):
-        lock = self.get_lock(r, 'foo')
+        lock = self.get_lock(r, "foo")
         assert lock.locked() is False
         lock.acquire(blocking=False)
         assert lock.locked() is True
@@ -51,14 +53,14 @@ def test_locked(self, r):
         assert lock.locked() is False
 
     def _test_owned(self, client):
-        lock = self.get_lock(client, 'foo')
+        lock = self.get_lock(client, "foo")
         assert lock.owned() is False
         lock.acquire(blocking=False)
         assert lock.owned() is True
         lock.release()
         assert lock.owned() is False
 
-        lock2 = self.get_lock(client, 'foo')
+        lock2 = self.get_lock(client, "foo")
         assert lock.owned() is False
         assert lock2.owned() is False
         lock2.acquire(blocking=False)
@@ -75,8 +77,8 @@ def test_owned_with_decoded_responses(self, r_decoded):
         self._test_owned(r_decoded)
 
     def test_competing_locks(self, r):
-        lock1 = self.get_lock(r, 'foo')
-        lock2 = self.get_lock(r, 'foo')
+        lock1 = self.get_lock(r, "foo")
+        lock2 = self.get_lock(r, "foo")
         assert lock1.acquire(blocking=False)
         assert not lock2.acquire(blocking=False)
         lock1.release()
@@ -85,23 +87,23 @@ def test_competing_locks(self, r):
         lock2.release()
 
     def test_timeout(self, r):
-        lock = self.get_lock(r, 'foo', timeout=10)
+        lock = self.get_lock(r, "foo", timeout=10)
         assert lock.acquire(blocking=False)
-        assert 8 < r.ttl('foo') <= 10
+        assert 8 < r.ttl("foo") <= 10
         lock.release()
 
     def test_float_timeout(self, r):
-        lock = self.get_lock(r, 'foo', timeout=9.5)
+        lock = self.get_lock(r, "foo", timeout=9.5)
         assert lock.acquire(blocking=False)
-        assert 8 < r.pttl('foo') <= 9500
+        assert 8 < r.pttl("foo") <= 9500
         lock.release()
 
     def test_blocking_timeout(self, r):
-        lock1 = self.get_lock(r, 'foo')
+        lock1 = self.get_lock(r, "foo")
         assert lock1.acquire(blocking=False)
         bt = 0.2
         sleep = 0.05
-        lock2 = self.get_lock(r, 'foo', sleep=sleep, blocking_timeout=bt)
+        lock2 = self.get_lock(r, "foo", sleep=sleep, blocking_timeout=bt)
         start = time.monotonic()
         assert not lock2.acquire()
         # The elapsed duration should be less than the total blocking_timeout
@@ -111,22 +113,22 @@ def test_blocking_timeout(self, r):
     def test_context_manager(self, r):
         # blocking_timeout prevents a deadlock if the lock can't be acquired
         # for some reason
-        with self.get_lock(r, 'foo', blocking_timeout=0.2) as lock:
-            assert r.get('foo') == lock.local.token
-        assert r.get('foo') is None
+        with self.get_lock(r, "foo", blocking_timeout=0.2) as lock:
+            assert r.get("foo") == lock.local.token
+        assert r.get("foo") is None
 
     def test_context_manager_raises_when_locked_not_acquired(self, r):
-        r.set('foo', 'bar')
+        r.set("foo", "bar")
         with pytest.raises(LockError):
-            with self.get_lock(r, 'foo', blocking_timeout=0.1):
+            with self.get_lock(r, "foo", blocking_timeout=0.1):
                 pass
 
     def test_high_sleep_small_blocking_timeout(self, r):
-        lock1 = self.get_lock(r, 'foo')
+        lock1 = self.get_lock(r, "foo")
         assert lock1.acquire(blocking=False)
         sleep = 60
         bt = 1
-        lock2 = self.get_lock(r, 'foo', sleep=sleep, blocking_timeout=bt)
+        lock2 = self.get_lock(r, "foo", sleep=sleep, blocking_timeout=bt)
         start = time.monotonic()
         assert not lock2.acquire()
         # the elapsed timed is less than the blocking_timeout as the lock is
@@ -135,88 +137,88 @@ def test_high_sleep_small_blocking_timeout(self, r):
         lock1.release()
 
     def test_releasing_unlocked_lock_raises_error(self, r):
-        lock = self.get_lock(r, 'foo')
+        lock = self.get_lock(r, "foo")
         with pytest.raises(LockError):
             lock.release()
 
     def test_releasing_lock_no_longer_owned_raises_error(self, r):
-        lock = self.get_lock(r, 'foo')
+        lock = self.get_lock(r, "foo")
         lock.acquire(blocking=False)
         # manually change the token
-        r.set('foo', 'a')
+        r.set("foo", "a")
         with pytest.raises(LockNotOwnedError):
             lock.release()
         # even though we errored, the token is still cleared
         assert lock.local.token is None
 
     def test_extend_lock(self, r):
-        lock = self.get_lock(r, 'foo', timeout=10)
+        lock = self.get_lock(r, "foo", timeout=10)
         assert lock.acquire(blocking=False)
-        assert 8000 < r.pttl('foo') <= 10000
+        assert 8000 < r.pttl("foo") <= 10000
         assert lock.extend(10)
-        assert 16000 < r.pttl('foo') <= 20000
+        assert 16000 < r.pttl("foo") <= 20000
         lock.release()
 
     def test_extend_lock_replace_ttl(self, r):
-        lock = self.get_lock(r, 'foo', timeout=10)
+        lock = self.get_lock(r, "foo", timeout=10)
         assert lock.acquire(blocking=False)
-        assert 8000 < r.pttl('foo') <= 10000
+        assert 8000 < r.pttl("foo") <= 10000
         assert lock.extend(10, replace_ttl=True)
-        assert 8000 < r.pttl('foo') <= 10000
+        assert 8000 < r.pttl("foo") <= 10000
         lock.release()
 
     def test_extend_lock_float(self, r):
-        lock = self.get_lock(r, 'foo', timeout=10.0)
+        lock = self.get_lock(r, "foo", timeout=10.0)
         assert lock.acquire(blocking=False)
-        assert 8000 < r.pttl('foo') <= 10000
+        assert 8000 < r.pttl("foo") <= 10000
         assert lock.extend(10.0)
-        assert 16000 < r.pttl('foo') <= 20000
+        assert 16000 < r.pttl("foo") <= 20000
         lock.release()
 
     def test_extending_unlocked_lock_raises_error(self, r):
-        lock = self.get_lock(r, 'foo', timeout=10)
+        lock = self.get_lock(r, "foo", timeout=10)
         with pytest.raises(LockError):
             lock.extend(10)
 
     def test_extending_lock_with_no_timeout_raises_error(self, r):
-        lock = self.get_lock(r, 'foo')
+        lock = self.get_lock(r, "foo")
         assert lock.acquire(blocking=False)
         with pytest.raises(LockError):
             lock.extend(10)
         lock.release()
 
     def test_extending_lock_no_longer_owned_raises_error(self, r):
-        lock = self.get_lock(r, 'foo', timeout=10)
+        lock = self.get_lock(r, "foo", timeout=10)
         assert lock.acquire(blocking=False)
-        r.set('foo', 'a')
+        r.set("foo", "a")
         with pytest.raises(LockNotOwnedError):
             lock.extend(10)
 
     def test_reacquire_lock(self, r):
-        lock = self.get_lock(r, 'foo', timeout=10)
+        lock = self.get_lock(r, "foo", timeout=10)
         assert lock.acquire(blocking=False)
-        assert r.pexpire('foo', 5000)
-        assert r.pttl('foo') <= 5000
+        assert r.pexpire("foo", 5000)
+        assert r.pttl("foo") <= 5000
         assert lock.reacquire()
-        assert 8000 < r.pttl('foo') <= 10000
+        assert 8000 < r.pttl("foo") <= 10000
         lock.release()
 
     def test_reacquiring_unlocked_lock_raises_error(self, r):
-        lock = self.get_lock(r, 'foo', timeout=10)
+        lock = self.get_lock(r, "foo", timeout=10)
         with pytest.raises(LockError):
             lock.reacquire()
 
     def test_reacquiring_lock_with_no_timeout_raises_error(self, r):
-        lock = self.get_lock(r, 'foo')
+        lock = self.get_lock(r, "foo")
         assert lock.acquire(blocking=False)
         with pytest.raises(LockError):
             lock.reacquire()
         lock.release()
 
     def test_reacquiring_lock_no_longer_owned_raises_error(self, r):
-        lock = self.get_lock(r, 'foo', timeout=10)
+        lock = self.get_lock(r, "foo", timeout=10)
         assert lock.acquire(blocking=False)
-        r.set('foo', 'a')
+        r.set("foo", "a")
         with pytest.raises(LockNotOwnedError):
             lock.reacquire()
 
@@ -228,5 +230,6 @@ class MyLock:
             def __init__(self, *args, **kwargs):
 
                 pass
-        lock = r.lock('foo', lock_class=MyLock)
+
+        lock = r.lock("foo", lock_class=MyLock)
         assert type(lock) == MyLock
diff --git a/tests/test_monitor.py b/tests/test_monitor.py
index 6c3ea33bce..40d9e43094 100644
--- a/tests/test_monitor.py
+++ b/tests/test_monitor.py
@@ -1,8 +1,9 @@
 import pytest
+
 from .conftest import (
     skip_if_redis_enterprise,
     skip_ifnot_redis_enterprise,
-    wait_for_command
+    wait_for_command,
 )
 
 
@@ -11,56 +12,56 @@ class TestMonitor:
     def test_wait_command_not_found(self, r):
         "Make sure the wait_for_command func works when command is not found"
         with r.monitor() as m:
-            response = wait_for_command(r, m, 'nothing')
+            response = wait_for_command(r, m, "nothing")
             assert response is None
 
     def test_response_values(self, r):
-        db = r.connection_pool.connection_kwargs.get('db', 0)
+        db = r.connection_pool.connection_kwargs.get("db", 0)
         with r.monitor() as m:
             r.ping()
-            response = wait_for_command(r, m, 'PING')
-            assert isinstance(response['time'], float)
-            assert response['db'] == db
-            assert response['client_type'] in ('tcp', 'unix')
-            assert isinstance(response['client_address'], str)
-            assert isinstance(response['client_port'], str)
-            assert response['command'] == 'PING'
+            response = wait_for_command(r, m, "PING")
+            assert isinstance(response["time"], float)
+            assert response["db"] == db
+            assert response["client_type"] in ("tcp", "unix")
+            assert isinstance(response["client_address"], str)
+            assert isinstance(response["client_port"], str)
+            assert response["command"] == "PING"
 
     def test_command_with_quoted_key(self, r):
         with r.monitor() as m:
             r.get('foo"bar')
             response = wait_for_command(r, m, 'GET foo"bar')
-            assert response['command'] == 'GET foo"bar'
+            assert response["command"] == 'GET foo"bar'
 
     def test_command_with_binary_data(self, r):
         with r.monitor() as m:
-            byte_string = b'foo\x92'
+            byte_string = b"foo\x92"
             r.get(byte_string)
-            response = wait_for_command(r, m, 'GET foo\\x92')
-            assert response['command'] == 'GET foo\\x92'
+            response = wait_for_command(r, m, "GET foo\\x92")
+            assert response["command"] == "GET foo\\x92"
 
     def test_command_with_escaped_data(self, r):
         with r.monitor() as m:
-            byte_string = b'foo\\x92'
+            byte_string = b"foo\\x92"
             r.get(byte_string)
-            response = wait_for_command(r, m, 'GET foo\\\\x92')
-            assert response['command'] == 'GET foo\\\\x92'
+            response = wait_for_command(r, m, "GET foo\\\\x92")
+            assert response["command"] == "GET foo\\\\x92"
 
     @skip_if_redis_enterprise
     def test_lua_script(self, r):
         with r.monitor() as m:
             script = 'return redis.call("GET", "foo")'
             assert r.eval(script, 0) is None
-            response = wait_for_command(r, m, 'GET foo')
-            assert response['command'] == 'GET foo'
-            assert response['client_type'] == 'lua'
-            assert response['client_address'] == 'lua'
-            assert response['client_port'] == ''
+            response = wait_for_command(r, m, "GET foo")
+            assert response["command"] == "GET foo"
+            assert response["client_type"] == "lua"
+            assert response["client_address"] == "lua"
+            assert response["client_port"] == ""
 
     @skip_ifnot_redis_enterprise
     def test_lua_script_in_enterprise(self, r):
         with r.monitor() as m:
             script = 'return redis.call("GET", "foo")'
             assert r.eval(script, 0) is None
-            response = wait_for_command(r, m, 'GET foo')
+            response = wait_for_command(r, m, "GET foo")
             assert response is None
diff --git a/tests/test_multiprocessing.py b/tests/test_multiprocessing.py
index 5968b2b4fe..32f5e23d53 100644
--- a/tests/test_multiprocessing.py
+++ b/tests/test_multiprocessing.py
@@ -1,6 +1,7 @@
-import pytest
-import multiprocessing
 import contextlib
+import multiprocessing
+
+import pytest
 
 import redis
 from redis.connection import Connection, ConnectionPool
@@ -25,10 +26,7 @@ class TestMultiprocessing:
     # actually fork/process-safe
     @pytest.fixture()
     def r(self, request):
-        return _get_client(
-            redis.Redis,
-            request=request,
-            single_connection_client=False)
+        return _get_client(redis.Redis, request=request, single_connection_client=False)
 
     def test_close_connection_in_child(self, master_host):
         """
@@ -36,12 +34,12 @@ def test_close_connection_in_child(self, master_host):
         destroy the file descriptors so a parent can still use it.
         """
         conn = Connection(host=master_host[0], port=master_host[1])
-        conn.send_command('ping')
-        assert conn.read_response() == b'PONG'
+        conn.send_command("ping")
+        assert conn.read_response() == b"PONG"
 
         def target(conn):
-            conn.send_command('ping')
-            assert conn.read_response() == b'PONG'
+            conn.send_command("ping")
+            assert conn.read_response() == b"PONG"
             conn.disconnect()
 
         proc = multiprocessing.Process(target=target, args=(conn,))
@@ -53,8 +51,8 @@ def target(conn):
         # child. The child called socket.close() but did not call
         # socket.shutdown() because it wasn't the "owning" process.
         # Therefore the connection still works in the parent.
-        conn.send_command('ping')
-        assert conn.read_response() == b'PONG'
+        conn.send_command("ping")
+        assert conn.read_response() == b"PONG"
 
     def test_close_connection_in_parent(self, master_host):
         """
@@ -62,8 +60,8 @@ def test_close_connection_in_parent(self, master_host):
         (the owning process) closes the connection.
         """
         conn = Connection(host=master_host[0], port=master_host[1])
-        conn.send_command('ping')
-        assert conn.read_response() == b'PONG'
+        conn.send_command("ping")
+        assert conn.read_response() == b"PONG"
 
         def target(conn, ev):
             ev.wait()
@@ -71,7 +69,7 @@ def target(conn, ev):
             # connection, the connection is shutdown and the child
             # cannot use it.
             with pytest.raises(ConnectionError):
-                conn.send_command('ping')
+                conn.send_command("ping")
 
         ev = multiprocessing.Event()
         proc = multiprocessing.Process(target=target, args=(conn, ev))
@@ -83,28 +81,30 @@ def target(conn, ev):
         proc.join(3)
         assert proc.exitcode == 0
 
-    @pytest.mark.parametrize('max_connections', [1, 2, None])
+    @pytest.mark.parametrize("max_connections", [1, 2, None])
     def test_pool(self, max_connections, master_host):
         """
         A child will create its own connections when using a pool created
         by a parent.
         """
-        pool = ConnectionPool.from_url(f'redis://{master_host[0]}:{master_host[1]}',
-                                       max_connections=max_connections)
+        pool = ConnectionPool.from_url(
+            f"redis://{master_host[0]}:{master_host[1]}",
+            max_connections=max_connections,
+        )
 
-        conn = pool.get_connection('ping')
+        conn = pool.get_connection("ping")
         main_conn_pid = conn.pid
         with exit_callback(pool.release, conn):
-            conn.send_command('ping')
-            assert conn.read_response() == b'PONG'
+            conn.send_command("ping")
+            assert conn.read_response() == b"PONG"
 
         def target(pool):
             with exit_callback(pool.disconnect):
-                conn = pool.get_connection('ping')
+                conn = pool.get_connection("ping")
                 assert conn.pid != main_conn_pid
                 with exit_callback(pool.release, conn):
-                    assert conn.send_command('ping') is None
-                    assert conn.read_response() == b'PONG'
+                    assert conn.send_command("ping") is None
+                    assert conn.read_response() == b"PONG"
 
         proc = multiprocessing.Process(target=target, args=(pool,))
         proc.start()
@@ -113,32 +113,34 @@ def target(pool):
 
         # Check that connection is still alive after fork process has exited
         # and disconnected the connections in its pool
-        conn = pool.get_connection('ping')
+        conn = pool.get_connection("ping")
         with exit_callback(pool.release, conn):
-            assert conn.send_command('ping') is None
-            assert conn.read_response() == b'PONG'
+            assert conn.send_command("ping") is None
+            assert conn.read_response() == b"PONG"
 
-    @pytest.mark.parametrize('max_connections', [1, 2, None])
+    @pytest.mark.parametrize("max_connections", [1, 2, None])
     def test_close_pool_in_main(self, max_connections, master_host):
         """
         A child process that uses the same pool as its parent isn't affected
         when the parent disconnects all connections within the pool.
         """
-        pool = ConnectionPool.from_url(f'redis://{master_host[0]}:{master_host[1]}',
-                                       max_connections=max_connections)
+        pool = ConnectionPool.from_url(
+            f"redis://{master_host[0]}:{master_host[1]}",
+            max_connections=max_connections,
+        )
 
-        conn = pool.get_connection('ping')
-        assert conn.send_command('ping') is None
-        assert conn.read_response() == b'PONG'
+        conn = pool.get_connection("ping")
+        assert conn.send_command("ping") is None
+        assert conn.read_response() == b"PONG"
 
         def target(pool, disconnect_event):
-            conn = pool.get_connection('ping')
+            conn = pool.get_connection("ping")
             with exit_callback(pool.release, conn):
-                assert conn.send_command('ping') is None
-                assert conn.read_response() == b'PONG'
+                assert conn.send_command("ping") is None
+                assert conn.read_response() == b"PONG"
                 disconnect_event.wait()
-                assert conn.send_command('ping') is None
-                assert conn.read_response() == b'PONG'
+                assert conn.send_command("ping") is None
+                assert conn.read_response() == b"PONG"
 
         ev = multiprocessing.Event()
 
diff --git a/tests/test_pipeline.py b/tests/test_pipeline.py
index a87ed7182d..0518893f07 100644
--- a/tests/test_pipeline.py
+++ b/tests/test_pipeline.py
@@ -1,7 +1,8 @@
 import pytest
 
 import redis
-from .conftest import wait_for_command, skip_if_server_version_lt
+
+from .conftest import skip_if_server_version_lt, wait_for_command
 
 
 class TestPipeline:
@@ -12,31 +13,30 @@ def test_pipeline_is_true(self, r):
 
     def test_pipeline(self, r):
         with r.pipeline() as pipe:
-            (pipe.set('a', 'a1')
-                 .get('a')
-                 .zadd('z', {'z1': 1})
-                 .zadd('z', {'z2': 4})
-                 .zincrby('z', 1, 'z1')
-                 .zrange('z', 0, 5, withscores=True))
-            assert pipe.execute() == \
-                [
-                    True,
-                    b'a1',
-                    True,
-                    True,
-                    2.0,
-                    [(b'z1', 2.0), (b'z2', 4)],
-                ]
+            (
+                pipe.set("a", "a1")
+                .get("a")
+                .zadd("z", {"z1": 1})
+                .zadd("z", {"z2": 4})
+                .zincrby("z", 1, "z1")
+                .zrange("z", 0, 5, withscores=True)
+            )
+            assert pipe.execute() == [
+                True,
+                b"a1",
+                True,
+                True,
+                2.0,
+                [(b"z1", 2.0), (b"z2", 4)],
+            ]
 
     def test_pipeline_memoryview(self, r):
         with r.pipeline() as pipe:
-            (pipe.set('a', memoryview(b'a1'))
-                 .get('a'))
-            assert pipe.execute() == \
-                [
-                    True,
-                    b'a1',
-                ]
+            (pipe.set("a", memoryview(b"a1")).get("a"))
+            assert pipe.execute() == [
+                True,
+                b"a1",
+            ]
 
     def test_pipeline_length(self, r):
         with r.pipeline() as pipe:
@@ -44,7 +44,7 @@ def test_pipeline_length(self, r):
             assert len(pipe) == 0
 
             # Fill 'er up!
-            pipe.set('a', 'a1').set('b', 'b1').set('c', 'c1')
+            pipe.set("a", "a1").set("b", "b1").set("c", "c1")
             assert len(pipe) == 3
 
             # Execute calls reset(), so empty once again.
@@ -53,83 +53,84 @@ def test_pipeline_length(self, r):
 
     def test_pipeline_no_transaction(self, r):
         with r.pipeline(transaction=False) as pipe:
-            pipe.set('a', 'a1').set('b', 'b1').set('c', 'c1')
+            pipe.set("a", "a1").set("b", "b1").set("c", "c1")
             assert pipe.execute() == [True, True, True]
-            assert r['a'] == b'a1'
-            assert r['b'] == b'b1'
-            assert r['c'] == b'c1'
+            assert r["a"] == b"a1"
+            assert r["b"] == b"b1"
+            assert r["c"] == b"c1"
 
     @pytest.mark.onlynoncluster
     def test_pipeline_no_transaction_watch(self, r):
-        r['a'] = 0
+        r["a"] = 0
 
         with r.pipeline(transaction=False) as pipe:
-            pipe.watch('a')
-            a = pipe.get('a')
+            pipe.watch("a")
+            a = pipe.get("a")
 
             pipe.multi()
-            pipe.set('a', int(a) + 1)
+            pipe.set("a", int(a) + 1)
             assert pipe.execute() == [True]
 
     @pytest.mark.onlynoncluster
     def test_pipeline_no_transaction_watch_failure(self, r):
-        r['a'] = 0
+        r["a"] = 0
 
         with r.pipeline(transaction=False) as pipe:
-            pipe.watch('a')
-            a = pipe.get('a')
+            pipe.watch("a")
+            a = pipe.get("a")
 
-            r['a'] = 'bad'
+            r["a"] = "bad"
 
             pipe.multi()
-            pipe.set('a', int(a) + 1)
+            pipe.set("a", int(a) + 1)
 
             with pytest.raises(redis.WatchError):
                 pipe.execute()
 
-            assert r['a'] == b'bad'
+            assert r["a"] == b"bad"
 
     def test_exec_error_in_response(self, r):
         """
         an invalid pipeline command at exec time adds the exception instance
         to the list of returned values
         """
-        r['c'] = 'a'
+        r["c"] = "a"
         with r.pipeline() as pipe:
-            pipe.set('a', 1).set('b', 2).lpush('c', 3).set('d', 4)
+            pipe.set("a", 1).set("b", 2).lpush("c", 3).set("d", 4)
             result = pipe.execute(raise_on_error=False)
 
             assert result[0]
-            assert r['a'] == b'1'
+            assert r["a"] == b"1"
             assert result[1]
-            assert r['b'] == b'2'
+            assert r["b"] == b"2"
 
             # we can't lpush to a key that's a string value, so this should
             # be a ResponseError exception
             assert isinstance(result[2], redis.ResponseError)
-            assert r['c'] == b'a'
+            assert r["c"] == b"a"
 
             # since this isn't a transaction, the other commands after the
             # error are still executed
             assert result[3]
-            assert r['d'] == b'4'
+            assert r["d"] == b"4"
 
             # make sure the pipe was restored to a working state
-            assert pipe.set('z', 'zzz').execute() == [True]
-            assert r['z'] == b'zzz'
+            assert pipe.set("z", "zzz").execute() == [True]
+            assert r["z"] == b"zzz"
 
     def test_exec_error_raised(self, r):
-        r['c'] = 'a'
+        r["c"] = "a"
         with r.pipeline() as pipe:
-            pipe.set('a', 1).set('b', 2).lpush('c', 3).set('d', 4)
+            pipe.set("a", 1).set("b", 2).lpush("c", 3).set("d", 4)
             with pytest.raises(redis.ResponseError) as ex:
                 pipe.execute()
-            assert str(ex.value).startswith('Command # 3 (LPUSH c 3) of '
-                                            'pipeline caused error: ')
+            assert str(ex.value).startswith(
+                "Command # 3 (LPUSH c 3) of " "pipeline caused error: "
+            )
 
             # make sure the pipe was restored to a working state
-            assert pipe.set('z', 'zzz').execute() == [True]
-            assert r['z'] == b'zzz'
+            assert pipe.set("z", "zzz").execute() == [True]
+            assert r["z"] == b"zzz"
 
     @pytest.mark.onlynoncluster
     def test_transaction_with_empty_error_command(self, r):
@@ -139,7 +140,7 @@ def test_transaction_with_empty_error_command(self, r):
         """
         for error_switch in (True, False):
             with r.pipeline() as pipe:
-                pipe.set('a', 1).mget([]).set('c', 3)
+                pipe.set("a", 1).mget([]).set("c", 3)
                 result = pipe.execute(raise_on_error=error_switch)
 
                 assert result[0]
@@ -154,7 +155,7 @@ def test_pipeline_with_empty_error_command(self, r):
         """
         for error_switch in (True, False):
             with r.pipeline(transaction=False) as pipe:
-                pipe.set('a', 1).mget([]).set('c', 3)
+                pipe.set("a", 1).mget([]).set("c", 3)
                 result = pipe.execute(raise_on_error=error_switch)
 
                 assert result[0]
@@ -164,61 +165,63 @@ def test_pipeline_with_empty_error_command(self, r):
     def test_parse_error_raised(self, r):
         with r.pipeline() as pipe:
             # the zrem is invalid because we don't pass any keys to it
-            pipe.set('a', 1).zrem('b').set('b', 2)
+            pipe.set("a", 1).zrem("b").set("b", 2)
             with pytest.raises(redis.ResponseError) as ex:
                 pipe.execute()
 
-            assert str(ex.value).startswith('Command # 2 (ZREM b) of '
-                                            'pipeline caused error: ')
+            assert str(ex.value).startswith(
+                "Command # 2 (ZREM b) of " "pipeline caused error: "
+            )
 
             # make sure the pipe was restored to a working state
-            assert pipe.set('z', 'zzz').execute() == [True]
-            assert r['z'] == b'zzz'
+            assert pipe.set("z", "zzz").execute() == [True]
+            assert r["z"] == b"zzz"
 
     @pytest.mark.onlynoncluster
     def test_parse_error_raised_transaction(self, r):
         with r.pipeline() as pipe:
             pipe.multi()
             # the zrem is invalid because we don't pass any keys to it
-            pipe.set('a', 1).zrem('b').set('b', 2)
+            pipe.set("a", 1).zrem("b").set("b", 2)
             with pytest.raises(redis.ResponseError) as ex:
                 pipe.execute()
 
-            assert str(ex.value).startswith('Command # 2 (ZREM b) of '
-                                            'pipeline caused error: ')
+            assert str(ex.value).startswith(
+                "Command # 2 (ZREM b) of " "pipeline caused error: "
+            )
 
             # make sure the pipe was restored to a working state
-            assert pipe.set('z', 'zzz').execute() == [True]
-            assert r['z'] == b'zzz'
+            assert pipe.set("z", "zzz").execute() == [True]
+            assert r["z"] == b"zzz"
 
     @pytest.mark.onlynoncluster
     def test_watch_succeed(self, r):
-        r['a'] = 1
-        r['b'] = 2
+        r["a"] = 1
+        r["b"] = 2
 
         with r.pipeline() as pipe:
-            pipe.watch('a', 'b')
+            pipe.watch("a", "b")
             assert pipe.watching
-            a_value = pipe.get('a')
-            b_value = pipe.get('b')
-            assert a_value == b'1'
-            assert b_value == b'2'
+            a_value = pipe.get("a")
+            b_value = pipe.get("b")
+            assert a_value == b"1"
+            assert b_value == b"2"
             pipe.multi()
 
-            pipe.set('c', 3)
+            pipe.set("c", 3)
             assert pipe.execute() == [True]
             assert not pipe.watching
 
     @pytest.mark.onlynoncluster
     def test_watch_failure(self, r):
-        r['a'] = 1
-        r['b'] = 2
+        r["a"] = 1
+        r["b"] = 2
 
         with r.pipeline() as pipe:
-            pipe.watch('a', 'b')
-            r['b'] = 3
+            pipe.watch("a", "b")
+            r["b"] = 3
             pipe.multi()
-            pipe.get('a')
+            pipe.get("a")
             with pytest.raises(redis.WatchError):
                 pipe.execute()
 
@@ -226,12 +229,12 @@ def test_watch_failure(self, r):
 
     @pytest.mark.onlynoncluster
     def test_watch_failure_in_empty_transaction(self, r):
-        r['a'] = 1
-        r['b'] = 2
+        r["a"] = 1
+        r["b"] = 2
 
         with r.pipeline() as pipe:
-            pipe.watch('a', 'b')
-            r['b'] = 3
+            pipe.watch("a", "b")
+            r["b"] = 3
             pipe.multi()
             with pytest.raises(redis.WatchError):
                 pipe.execute()
@@ -240,103 +243,104 @@ def test_watch_failure_in_empty_transaction(self, r):
 
     @pytest.mark.onlynoncluster
     def test_unwatch(self, r):
-        r['a'] = 1
-        r['b'] = 2
+        r["a"] = 1
+        r["b"] = 2
 
         with r.pipeline() as pipe:
-            pipe.watch('a', 'b')
-            r['b'] = 3
+            pipe.watch("a", "b")
+            r["b"] = 3
             pipe.unwatch()
             assert not pipe.watching
-            pipe.get('a')
-            assert pipe.execute() == [b'1']
+            pipe.get("a")
+            assert pipe.execute() == [b"1"]
 
     @pytest.mark.onlynoncluster
     def test_watch_exec_no_unwatch(self, r):
-        r['a'] = 1
-        r['b'] = 2
+        r["a"] = 1
+        r["b"] = 2
 
         with r.monitor() as m:
             with r.pipeline() as pipe:
-                pipe.watch('a', 'b')
+                pipe.watch("a", "b")
                 assert pipe.watching
-                a_value = pipe.get('a')
-                b_value = pipe.get('b')
-                assert a_value == b'1'
-                assert b_value == b'2'
+                a_value = pipe.get("a")
+                b_value = pipe.get("b")
+                assert a_value == b"1"
+                assert b_value == b"2"
                 pipe.multi()
-                pipe.set('c', 3)
+                pipe.set("c", 3)
                 assert pipe.execute() == [True]
                 assert not pipe.watching
 
-            unwatch_command = wait_for_command(r, m, 'UNWATCH')
+            unwatch_command = wait_for_command(r, m, "UNWATCH")
             assert unwatch_command is None, "should not send UNWATCH"
 
     @pytest.mark.onlynoncluster
     def test_watch_reset_unwatch(self, r):
-        r['a'] = 1
+        r["a"] = 1
 
         with r.monitor() as m:
             with r.pipeline() as pipe:
-                pipe.watch('a')
+                pipe.watch("a")
                 assert pipe.watching
                 pipe.reset()
                 assert not pipe.watching
 
-            unwatch_command = wait_for_command(r, m, 'UNWATCH')
+            unwatch_command = wait_for_command(r, m, "UNWATCH")
             assert unwatch_command is not None
-            assert unwatch_command['command'] == 'UNWATCH'
+            assert unwatch_command["command"] == "UNWATCH"
 
     @pytest.mark.onlynoncluster
     def test_transaction_callable(self, r):
-        r['a'] = 1
-        r['b'] = 2
+        r["a"] = 1
+        r["b"] = 2
         has_run = []
 
         def my_transaction(pipe):
-            a_value = pipe.get('a')
-            assert a_value in (b'1', b'2')
-            b_value = pipe.get('b')
-            assert b_value == b'2'
+            a_value = pipe.get("a")
+            assert a_value in (b"1", b"2")
+            b_value = pipe.get("b")
+            assert b_value == b"2"
 
             # silly run-once code... incr's "a" so WatchError should be raised
             # forcing this all to run again. this should incr "a" once to "2"
             if not has_run:
-                r.incr('a')
-                has_run.append('it has')
+                r.incr("a")
+                has_run.append("it has")
 
             pipe.multi()
-            pipe.set('c', int(a_value) + int(b_value))
+            pipe.set("c", int(a_value) + int(b_value))
 
-        result = r.transaction(my_transaction, 'a', 'b')
+        result = r.transaction(my_transaction, "a", "b")
         assert result == [True]
-        assert r['c'] == b'4'
+        assert r["c"] == b"4"
 
     @pytest.mark.onlynoncluster
     def test_transaction_callable_returns_value_from_callable(self, r):
         def callback(pipe):
             # No need to do anything here since we only want the return value
-            return 'a'
+            return "a"
 
-        res = r.transaction(callback, 'my-key', value_from_callable=True)
-        assert res == 'a'
+        res = r.transaction(callback, "my-key", value_from_callable=True)
+        assert res == "a"
 
     def test_exec_error_in_no_transaction_pipeline(self, r):
-        r['a'] = 1
+        r["a"] = 1
         with r.pipeline(transaction=False) as pipe:
-            pipe.llen('a')
-            pipe.expire('a', 100)
+            pipe.llen("a")
+            pipe.expire("a", 100)
 
             with pytest.raises(redis.ResponseError) as ex:
                 pipe.execute()
 
-            assert str(ex.value).startswith('Command # 1 (LLEN a) of '
-                                            'pipeline caused error: ')
+            assert str(ex.value).startswith(
+                "Command # 1 (LLEN a) of " "pipeline caused error: "
+            )
 
-        assert r['a'] == b'1'
+        assert r["a"] == b"1"
 
     def test_exec_error_in_no_transaction_pipeline_unicode_command(self, r):
-        key = chr(3456) + 'abcd' + chr(3421)
+        key = chr(3456) + "abcd" + chr(3421)
         r[key] = 1
         with r.pipeline(transaction=False) as pipe:
             pipe.llen(key)
@@ -345,51 +349,52 @@ def test_exec_error_in_no_transaction_pipeline_unicode_command(self, r):
             with pytest.raises(redis.ResponseError) as ex:
                 pipe.execute()
 
-            expected = f'Command # 1 (LLEN {key}) of pipeline caused error: '
+            expected = f"Command # 1 (LLEN {key}) of pipeline caused error: "
             assert str(ex.value).startswith(expected)
 
-        assert r[key] == b'1'
+        assert r[key] == b"1"
 
     def test_pipeline_with_bitfield(self, r):
         with r.pipeline() as pipe:
-            pipe.set('a', '1')
-            bf = pipe.bitfield('b')
-            pipe2 = (bf
-                     .set('u8', 8, 255)
-                     .get('u8', 0)
-                     .get('u4', 8)  # 1111
-                     .get('u4', 12)  # 1111
-                     .get('u4', 13)  # 1110
-                     .execute())
-            pipe.get('a')
+            pipe.set("a", "1")
+            bf = pipe.bitfield("b")
+            pipe2 = (
+                bf.set("u8", 8, 255)
+                .get("u8", 0)
+                .get("u4", 8)  # 1111
+                .get("u4", 12)  # 1111
+                .get("u4", 13)  # 1110
+                .execute()
+            )
+            pipe.get("a")
             response = pipe.execute()
 
             assert pipe == pipe2
-            assert response == [True, [0, 0, 15, 15, 14], b'1']
+            assert response == [True, [0, 0, 15, 15, 14], b"1"]
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.0.0')
+    @skip_if_server_version_lt("2.0.0")
     def test_pipeline_discard(self, r):
 
         # empty pipeline should raise an error
         with r.pipeline() as pipe:
-            pipe.set('key', 'someval')
+            pipe.set("key", "someval")
             pipe.discard()
             with pytest.raises(redis.exceptions.ResponseError):
                 pipe.execute()
 
         # setting a pipeline and discarding should do the same
         with r.pipeline() as pipe:
-            pipe.set('key', 'someval')
-            pipe.set('someotherkey', 'val')
+            pipe.set("key", "someval")
+            pipe.set("someotherkey", "val")
             response = pipe.execute()
-            pipe.set('key', 'another value!')
+            pipe.set("key", "another value!")
             pipe.discard()
-            pipe.set('key', 'another vae!')
+            pipe.set("key", "another vae!")
             with pytest.raises(redis.exceptions.ResponseError):
                 pipe.execute()
 
-            pipe.set('foo', 'bar')
+            pipe.set("foo", "bar")
             response = pipe.execute()
         assert response[0]
-        assert r.get('foo') == b'bar'
+        assert r.get("foo") == b"bar"
diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index b019bae6e2..6df0fafd4b 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -1,17 +1,14 @@
+import platform
 import threading
 import time
 from unittest import mock
-import platform
 
 import pytest
+
 import redis
 from redis.exceptions import ConnectionError
 
-from .conftest import (
-    _get_client,
-    skip_if_redis_enterprise,
-    skip_if_server_version_lt
-)
+from .conftest import _get_client, skip_if_redis_enterprise, skip_if_server_version_lt
 
 
 def wait_for_message(pubsub, timeout=0.1, ignore_subscribe_messages=False):
@@ -19,7 +16,8 @@ def wait_for_message(pubsub, timeout=0.1, ignore_subscribe_messages=False):
     timeout = now + timeout
     while now < timeout:
         message = pubsub.get_message(
-            ignore_subscribe_messages=ignore_subscribe_messages)
+            ignore_subscribe_messages=ignore_subscribe_messages
+        )
         if message is not None:
             return message
         time.sleep(0.01)
@@ -29,39 +27,39 @@ def wait_for_message(pubsub, timeout=0.1, ignore_subscribe_messages=False):
 
 def make_message(type, channel, data, pattern=None):
     return {
-        'type': type,
-        'pattern': pattern and pattern.encode('utf-8') or None,
-        'channel': channel and channel.encode('utf-8') or None,
-        'data': data.encode('utf-8') if isinstance(data, str) else data
+        "type": type,
+        "pattern": pattern and pattern.encode("utf-8") or None,
+        "channel": channel and channel.encode("utf-8") or None,
+        "data": data.encode("utf-8") if isinstance(data, str) else data,
     }
 
 
 def make_subscribe_test_data(pubsub, type):
-    if type == 'channel':
+    if type == "channel":
         return {
-            'p': pubsub,
-            'sub_type': 'subscribe',
-            'unsub_type': 'unsubscribe',
-            'sub_func': pubsub.subscribe,
-            'unsub_func': pubsub.unsubscribe,
-            'keys': ['foo', 'bar', 'uni' + chr(4456) + 'code']
+            "p": pubsub,
+            "sub_type": "subscribe",
+            "unsub_type": "unsubscribe",
+            "sub_func": pubsub.subscribe,
+            "unsub_func": pubsub.unsubscribe,
+            "keys": ["foo", "bar", "uni" + chr(4456) + "code"],
         }
-    elif type == 'pattern':
+    elif type == "pattern":
         return {
-            'p': pubsub,
-            'sub_type': 'psubscribe',
-            'unsub_type': 'punsubscribe',
-            'sub_func': pubsub.psubscribe,
-            'unsub_func': pubsub.punsubscribe,
-            'keys': ['f*', 'b*', 'uni' + chr(4456) + '*']
+            "p": pubsub,
+            "sub_type": "psubscribe",
+            "unsub_type": "punsubscribe",
+            "sub_func": pubsub.psubscribe,
+            "unsub_func": pubsub.punsubscribe,
+            "keys": ["f*", "b*", "uni" + chr(4456) + "*"],
         }
-    assert False, f'invalid subscribe type: {type}'
+    assert False, f"invalid subscribe type: {type}"
 
 
 class TestPubSubSubscribeUnsubscribe:
-
-    def _test_subscribe_unsubscribe(self, p, sub_type, unsub_type, sub_func,
-                                    unsub_func, keys):
+    def _test_subscribe_unsubscribe(
+        self, p, sub_type, unsub_type, sub_func, unsub_func, keys
+    ):
         for key in keys:
             assert sub_func(key) is None
 
@@ -79,15 +77,16 @@ def _test_subscribe_unsubscribe(self, p, sub_type, unsub_type, sub_func,
             assert wait_for_message(p) == make_message(unsub_type, key, i)
 
     def test_channel_subscribe_unsubscribe(self, r):
-        kwargs = make_subscribe_test_data(r.pubsub(), 'channel')
+        kwargs = make_subscribe_test_data(r.pubsub(), "channel")
         self._test_subscribe_unsubscribe(**kwargs)
 
     def test_pattern_subscribe_unsubscribe(self, r):
-        kwargs = make_subscribe_test_data(r.pubsub(), 'pattern')
+        kwargs = make_subscribe_test_data(r.pubsub(), "pattern")
         self._test_subscribe_unsubscribe(**kwargs)
 
-    def _test_resubscribe_on_reconnection(self, p, sub_type, unsub_type,
-                                          sub_func, unsub_func, keys):
+    def _test_resubscribe_on_reconnection(
+        self, p, sub_type, unsub_type, sub_func, unsub_func, keys
+    ):
 
         for key in keys:
             assert sub_func(key) is None
@@ -109,10 +108,10 @@ def _test_resubscribe_on_reconnection(self, p, sub_type, unsub_type,
         unique_channels = set()
         assert len(messages) == len(keys)
         for i, message in enumerate(messages):
-            assert message['type'] == sub_type
-            assert message['data'] == i + 1
-            assert isinstance(message['channel'], bytes)
-            channel = message['channel'].decode('utf-8')
+            assert message["type"] == sub_type
+            assert message["data"] == i + 1
+            assert isinstance(message["channel"], bytes)
+            channel = message["channel"].decode("utf-8")
             unique_channels.add(channel)
 
         assert len(unique_channels) == len(keys)
@@ -120,16 +119,17 @@ def _test_resubscribe_on_reconnection(self, p, sub_type, unsub_type,
             assert channel in keys
 
     def test_resubscribe_to_channels_on_reconnection(self, r):
-        kwargs = make_subscribe_test_data(r.pubsub(), 'channel')
+        kwargs = make_subscribe_test_data(r.pubsub(), "channel")
         self._test_resubscribe_on_reconnection(**kwargs)
 
     @pytest.mark.onlynoncluster
     def test_resubscribe_to_patterns_on_reconnection(self, r):
-        kwargs = make_subscribe_test_data(r.pubsub(), 'pattern')
+        kwargs = make_subscribe_test_data(r.pubsub(), "pattern")
         self._test_resubscribe_on_reconnection(**kwargs)
 
-    def _test_subscribed_property(self, p, sub_type, unsub_type, sub_func,
-                                  unsub_func, keys):
+    def _test_subscribed_property(
+        self, p, sub_type, unsub_type, sub_func, unsub_func, keys
+    ):
 
         assert p.subscribed is False
         sub_func(keys[0])
@@ -175,22 +175,22 @@ def _test_subscribed_property(self, p, sub_type, unsub_type, sub_func,
         assert p.subscribed is False
 
     def test_subscribe_property_with_channels(self, r):
-        kwargs = make_subscribe_test_data(r.pubsub(), 'channel')
+        kwargs = make_subscribe_test_data(r.pubsub(), "channel")
         self._test_subscribed_property(**kwargs)
 
     @pytest.mark.onlynoncluster
     def test_subscribe_property_with_patterns(self, r):
-        kwargs = make_subscribe_test_data(r.pubsub(), 'pattern')
+        kwargs = make_subscribe_test_data(r.pubsub(), "pattern")
         self._test_subscribed_property(**kwargs)
 
     def test_ignore_all_subscribe_messages(self, r):
         p = r.pubsub(ignore_subscribe_messages=True)
 
         checks = (
-            (p.subscribe, 'foo'),
-            (p.unsubscribe, 'foo'),
-            (p.psubscribe, 'f*'),
-            (p.punsubscribe, 'f*'),
+            (p.subscribe, "foo"),
+            (p.unsubscribe, "foo"),
+            (p.psubscribe, "f*"),
+            (p.punsubscribe, "f*"),
         )
 
         assert p.subscribed is False
@@ -204,10 +204,10 @@ def test_ignore_individual_subscribe_messages(self, r):
         p = r.pubsub()
 
         checks = (
-            (p.subscribe, 'foo'),
-            (p.unsubscribe, 'foo'),
-            (p.psubscribe, 'f*'),
-            (p.punsubscribe, 'f*'),
+            (p.subscribe, "foo"),
+            (p.unsubscribe, "foo"),
+            (p.psubscribe, "f*"),
+            (p.punsubscribe, "f*"),
         )
 
         assert p.subscribed is False
@@ -219,16 +219,17 @@ def test_ignore_individual_subscribe_messages(self, r):
         assert p.subscribed is False
 
     def test_sub_unsub_resub_channels(self, r):
-        kwargs = make_subscribe_test_data(r.pubsub(), 'channel')
+        kwargs = make_subscribe_test_data(r.pubsub(), "channel")
         self._test_sub_unsub_resub(**kwargs)
 
     @pytest.mark.onlynoncluster
     def test_sub_unsub_resub_patterns(self, r):
-        kwargs = make_subscribe_test_data(r.pubsub(), 'pattern')
+        kwargs = make_subscribe_test_data(r.pubsub(), "pattern")
         self._test_sub_unsub_resub(**kwargs)
 
-    def _test_sub_unsub_resub(self, p, sub_type, unsub_type, sub_func,
-                              unsub_func, keys):
+    def _test_sub_unsub_resub(
+        self, p, sub_type, unsub_type, sub_func, unsub_func, keys
+    ):
         # https://github.com/andymccurdy/redis-py/issues/764
         key = keys[0]
         sub_func(key)
@@ -241,15 +242,16 @@ def _test_sub_unsub_resub(self, p, sub_type, unsub_type, sub_func,
         assert p.subscribed is True
 
     def test_sub_unsub_all_resub_channels(self, r):
-        kwargs = make_subscribe_test_data(r.pubsub(), 'channel')
+        kwargs = make_subscribe_test_data(r.pubsub(), "channel")
         self._test_sub_unsub_all_resub(**kwargs)
 
     def test_sub_unsub_all_resub_patterns(self, r):
-        kwargs = make_subscribe_test_data(r.pubsub(), 'pattern')
+        kwargs = make_subscribe_test_data(r.pubsub(), "pattern")
         self._test_sub_unsub_all_resub(**kwargs)
 
-    def _test_sub_unsub_all_resub(self, p, sub_type, unsub_type, sub_func,
-                                  unsub_func, keys):
+    def _test_sub_unsub_all_resub(
+        self, p, sub_type, unsub_type, sub_func, unsub_func, keys
+    ):
         # https://github.com/andymccurdy/redis-py/issues/764
         key = keys[0]
         sub_func(key)
@@ -271,22 +273,22 @@ def message_handler(self, message):
 
     def test_published_message_to_channel(self, r):
         p = r.pubsub()
-        p.subscribe('foo')
-        assert wait_for_message(p) == make_message('subscribe', 'foo', 1)
-        assert r.publish('foo', 'test message') == 1
+        p.subscribe("foo")
+        assert wait_for_message(p) == make_message("subscribe", "foo", 1)
+        assert r.publish("foo", "test message") == 1
 
         message = wait_for_message(p)
         assert isinstance(message, dict)
-        assert message == make_message('message', 'foo', 'test message')
+        assert message == make_message("message", "foo", "test message")
 
     def test_published_message_to_pattern(self, r):
         p = r.pubsub()
-        p.subscribe('foo')
-        p.psubscribe('f*')
-        assert wait_for_message(p) == make_message('subscribe', 'foo', 1)
-        assert wait_for_message(p) == make_message('psubscribe', 'f*', 2)
+        p.subscribe("foo")
+        p.psubscribe("f*")
+        assert wait_for_message(p) == make_message("subscribe", "foo", 1)
+        assert wait_for_message(p) == make_message("psubscribe", "f*", 2)
         # 1 to pattern, 1 to channel
-        assert r.publish('foo', 'test message') == 2
+        assert r.publish("foo", "test message") == 2
 
         message1 = wait_for_message(p)
         message2 = wait_for_message(p)
@@ -294,8 +296,8 @@ def test_published_message_to_pattern(self, r):
         assert isinstance(message2, dict)
 
         expected = [
-            make_message('message', 'foo', 'test message'),
-            make_message('pmessage', 'foo', 'test message', pattern='f*')
+            make_message("message", "foo", "test message"),
+            make_message("pmessage", "foo", "test message", pattern="f*"),
         ]
 
         assert message1 in expected
@@ -306,67 +308,65 @@ def test_channel_message_handler(self, r):
         p = r.pubsub(ignore_subscribe_messages=True)
         p.subscribe(foo=self.message_handler)
         assert wait_for_message(p) is None
-        assert r.publish('foo', 'test message') == 1
+        assert r.publish("foo", "test message") == 1
         assert wait_for_message(p) is None
-        assert self.message == make_message('message', 'foo', 'test message')
+        assert self.message == make_message("message", "foo", "test message")
 
     @pytest.mark.onlynoncluster
     def test_pattern_message_handler(self, r):
         p = r.pubsub(ignore_subscribe_messages=True)
-        p.psubscribe(**{'f*': self.message_handler})
+        p.psubscribe(**{"f*": self.message_handler})
         assert wait_for_message(p) is None
-        assert r.publish('foo', 'test message') == 1
+        assert r.publish("foo", "test message") == 1
         assert wait_for_message(p) is None
-        assert self.message == make_message('pmessage', 'foo', 'test message',
-                                            pattern='f*')
+        assert self.message == make_message(
+            "pmessage", "foo", "test message", pattern="f*"
+        )
 
     def test_unicode_channel_message_handler(self, r):
         p = r.pubsub(ignore_subscribe_messages=True)
-        channel = 'uni' + chr(4456) + 'code'
+        channel = "uni" + chr(4456) + "code"
         channels = {channel: self.message_handler}
         p.subscribe(**channels)
         assert wait_for_message(p) is None
-        assert r.publish(channel, 'test message') == 1
+        assert r.publish(channel, "test message") == 1
         assert wait_for_message(p) is None
-        assert self.message == make_message('message', channel, 'test message')
+        assert self.message == make_message("message", channel, "test message")
 
     @pytest.mark.onlynoncluster
     # see: https://redis-py-cluster.readthedocs.io/en/stable/pubsub.html
     # #known-limitations-with-pubsub
     def test_unicode_pattern_message_handler(self, r):
         p = r.pubsub(ignore_subscribe_messages=True)
-        pattern = 'uni' + chr(4456) + '*'
-        channel = 'uni' + chr(4456) + 'code'
+        pattern = "uni" + chr(4456) + "*"
+        channel = "uni" + chr(4456) + "code"
         p.psubscribe(**{pattern: self.message_handler})
         assert wait_for_message(p) is None
-        assert r.publish(channel, 'test message') == 1
+        assert r.publish(channel, "test message") == 1
         assert wait_for_message(p) is None
-        assert self.message == make_message('pmessage', channel,
-                                            'test message', pattern=pattern)
+        assert self.message == make_message(
+            "pmessage", channel, "test message", pattern=pattern
+        )
 
     def test_get_message_without_subscribe(self, r):
         p = r.pubsub()
         with pytest.raises(RuntimeError) as info:
             p.get_message()
-        expect = ('connection not set: '
-                  'did you forget to call subscribe() or psubscribe()?')
+        expect = (
+            "connection not set: " "did you forget to call subscribe() or psubscribe()?"
+        )
         assert expect in info.exconly()
 
 
 class TestPubSubAutoDecoding:
     "These tests only validate that we get unicode values back"
 
-    channel = 'uni' + chr(4456) + 'code'
-    pattern = 'uni' + chr(4456) + '*'
-    data = 'abc' + chr(4458) + '123'
+    channel = "uni" + chr(4456) + "code"
+    pattern = "uni" + chr(4456) + "*"
+    data = "abc" + chr(4458) + "123"
 
     def make_message(self, type, channel, data, pattern=None):
-        return {
-            'type': type,
-            'channel': channel,
-            'pattern': pattern,
-            'data': data
-        }
+        return {"type": type, "channel": channel, "pattern": pattern, "data": data}
 
     def setup_method(self, method):
         self.message = None
@@ -381,44 +381,37 @@ def r(self, request):
     def test_channel_subscribe_unsubscribe(self, r):
         p = r.pubsub()
         p.subscribe(self.channel)
-        assert wait_for_message(p) == self.make_message('subscribe',
-                                                        self.channel, 1)
+        assert wait_for_message(p) == self.make_message("subscribe", self.channel, 1)
 
         p.unsubscribe(self.channel)
-        assert wait_for_message(p) == self.make_message('unsubscribe',
-                                                        self.channel, 0)
+        assert wait_for_message(p) == self.make_message("unsubscribe", self.channel, 0)
 
     def test_pattern_subscribe_unsubscribe(self, r):
         p = r.pubsub()
         p.psubscribe(self.pattern)
-        assert wait_for_message(p) == self.make_message('psubscribe',
-                                                        self.pattern, 1)
+        assert wait_for_message(p) == self.make_message("psubscribe", self.pattern, 1)
 
         p.punsubscribe(self.pattern)
-        assert wait_for_message(p) == self.make_message('punsubscribe',
-                                                        self.pattern, 0)
+        assert wait_for_message(p) == self.make_message("punsubscribe", self.pattern, 0)
 
     def test_channel_publish(self, r):
         p = r.pubsub()
         p.subscribe(self.channel)
-        assert wait_for_message(p) == self.make_message('subscribe',
-                                                        self.channel, 1)
+        assert wait_for_message(p) == self.make_message("subscribe", self.channel, 1)
         r.publish(self.channel, self.data)
-        assert wait_for_message(p) == self.make_message('message',
-                                                        self.channel,
-                                                        self.data)
+        assert wait_for_message(p) == self.make_message(
+            "message", self.channel, self.data
+        )
 
     @pytest.mark.onlynoncluster
     def test_pattern_publish(self, r):
         p = r.pubsub()
         p.psubscribe(self.pattern)
-        assert wait_for_message(p) == self.make_message('psubscribe',
-                                                        self.pattern, 1)
+        assert wait_for_message(p) == self.make_message("psubscribe", self.pattern, 1)
         r.publish(self.channel, self.data)
-        assert wait_for_message(p) == self.make_message('pmessage',
-                                                        self.channel,
-                                                        self.data,
-                                                        pattern=self.pattern)
+        assert wait_for_message(p) == self.make_message(
+            "pmessage", self.channel, self.data, pattern=self.pattern
+        )
 
     def test_channel_message_handler(self, r):
         p = r.pubsub(ignore_subscribe_messages=True)
@@ -426,18 +419,16 @@ def test_channel_message_handler(self, r):
         assert wait_for_message(p) is None
         r.publish(self.channel, self.data)
         assert wait_for_message(p) is None
-        assert self.message == self.make_message('message', self.channel,
-                                                 self.data)
+        assert self.message == self.make_message("message", self.channel, self.data)
 
         # test that we reconnected to the correct channel
         self.message = None
         p.connection.disconnect()
         assert wait_for_message(p) is None  # should reconnect
-        new_data = self.data + 'new data'
+        new_data = self.data + "new data"
         r.publish(self.channel, new_data)
         assert wait_for_message(p) is None
-        assert self.message == self.make_message('message', self.channel,
-                                                 new_data)
+        assert self.message == self.make_message("message", self.channel, new_data)
 
     def test_pattern_message_handler(self, r):
         p = r.pubsub(ignore_subscribe_messages=True)
@@ -445,24 +436,24 @@ def test_pattern_message_handler(self, r):
         assert wait_for_message(p) is None
         r.publish(self.channel, self.data)
         assert wait_for_message(p) is None
-        assert self.message == self.make_message('pmessage', self.channel,
-                                                 self.data,
-                                                 pattern=self.pattern)
+        assert self.message == self.make_message(
+            "pmessage", self.channel, self.data, pattern=self.pattern
+        )
 
         # test that we reconnected to the correct pattern
         self.message = None
         p.connection.disconnect()
         assert wait_for_message(p) is None  # should reconnect
-        new_data = self.data + 'new data'
+        new_data = self.data + "new data"
         r.publish(self.channel, new_data)
         assert wait_for_message(p) is None
-        assert self.message == self.make_message('pmessage', self.channel,
-                                                 new_data,
-                                                 pattern=self.pattern)
+        assert self.message == self.make_message(
+            "pmessage", self.channel, new_data, pattern=self.pattern
+        )
 
     def test_context_manager(self, r):
         with r.pubsub() as pubsub:
-            pubsub.subscribe('foo')
+            pubsub.subscribe("foo")
             assert pubsub.connection is not None
 
         assert pubsub.connection is None
@@ -471,86 +462,82 @@ def test_context_manager(self, r):
 
 
 class TestPubSubRedisDown:
-
     def test_channel_subscribe(self, r):
-        r = redis.Redis(host='localhost', port=6390)
+        r = redis.Redis(host="localhost", port=6390)
         p = r.pubsub()
         with pytest.raises(ConnectionError):
-            p.subscribe('foo')
+            p.subscribe("foo")
 
 
 class TestPubSubSubcommands:
-
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.8.0')
+    @skip_if_server_version_lt("2.8.0")
     def test_pubsub_channels(self, r):
         p = r.pubsub()
-        p.subscribe('foo', 'bar', 'baz', 'quux')
+        p.subscribe("foo", "bar", "baz", "quux")
         for i in range(4):
-            assert wait_for_message(p)['type'] == 'subscribe'
-        expected = [b'bar', b'baz', b'foo', b'quux']
+            assert wait_for_message(p)["type"] == "subscribe"
+        expected = [b"bar", b"baz", b"foo", b"quux"]
         assert all([channel in r.pubsub_channels() for channel in expected])
 
     @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt('2.8.0')
+    @skip_if_server_version_lt("2.8.0")
     def test_pubsub_numsub(self, r):
         p1 = r.pubsub()
-        p1.subscribe('foo', 'bar', 'baz')
+        p1.subscribe("foo", "bar", "baz")
         for i in range(3):
-            assert wait_for_message(p1)['type'] == 'subscribe'
+            assert wait_for_message(p1)["type"] == "subscribe"
         p2 = r.pubsub()
-        p2.subscribe('bar', 'baz')
+        p2.subscribe("bar", "baz")
         for i in range(2):
-            assert wait_for_message(p2)['type'] == 'subscribe'
+            assert wait_for_message(p2)["type"] == "subscribe"
         p3 = r.pubsub()
-        p3.subscribe('baz')
-        assert wait_for_message(p3)['type'] == 'subscribe'
+        p3.subscribe("baz")
+        assert wait_for_message(p3)["type"] == "subscribe"
 
-        channels = [(b'foo', 1), (b'bar', 2), (b'baz', 3)]
-        assert r.pubsub_numsub('foo', 'bar', 'baz') == channels
+        channels = [(b"foo", 1), (b"bar", 2), (b"baz", 3)]
+        assert r.pubsub_numsub("foo", "bar", "baz") == channels
 
-    @skip_if_server_version_lt('2.8.0')
+    @skip_if_server_version_lt("2.8.0")
     def test_pubsub_numpat(self, r):
         p = r.pubsub()
-        p.psubscribe('*oo', '*ar', 'b*z')
+        p.psubscribe("*oo", "*ar", "b*z")
         for i in range(3):
-            assert wait_for_message(p)['type'] == 'psubscribe'
+            assert wait_for_message(p)["type"] == "psubscribe"
         assert r.pubsub_numpat() == 3
 
 
 class TestPubSubPings:
-
-    @skip_if_server_version_lt('3.0.0')
+    @skip_if_server_version_lt("3.0.0")
     def test_send_pubsub_ping(self, r):
         p = r.pubsub(ignore_subscribe_messages=True)
-        p.subscribe('foo')
+        p.subscribe("foo")
         p.ping()
-        assert wait_for_message(p) == make_message(type='pong', channel=None,
-                                                   data='',
-                                                   pattern=None)
+        assert wait_for_message(p) == make_message(
+            type="pong", channel=None, data="", pattern=None
+        )
 
-    @skip_if_server_version_lt('3.0.0')
+    @skip_if_server_version_lt("3.0.0")
     def test_send_pubsub_ping_message(self, r):
         p = r.pubsub(ignore_subscribe_messages=True)
-        p.subscribe('foo')
-        p.ping(message='hello world')
-        assert wait_for_message(p) == make_message(type='pong', channel=None,
-                                                   data='hello world',
-                                                   pattern=None)
+        p.subscribe("foo")
+        p.ping(message="hello world")
+        assert wait_for_message(p) == make_message(
+            type="pong", channel=None, data="hello world", pattern=None
+        )
 
 
 @pytest.mark.onlynoncluster
 class TestPubSubConnectionKilled:
-
-    @skip_if_server_version_lt('3.0.0')
+    @skip_if_server_version_lt("3.0.0")
     @skip_if_redis_enterprise
     def test_connection_error_raised_when_connection_dies(self, r):
         p = r.pubsub()
-        p.subscribe('foo')
-        assert wait_for_message(p) == make_message('subscribe', 'foo', 1)
+        p.subscribe("foo")
+        assert wait_for_message(p) == make_message("subscribe", "foo", 1)
         for client in r.client_list():
-            if client['cmd'] == 'subscribe':
-                r.client_kill_filter(_id=client['id'])
+            if client["cmd"] == "subscribe":
+                r.client_kill_filter(_id=client["id"])
         with pytest.raises(ConnectionError):
             wait_for_message(p)
 
@@ -558,15 +545,15 @@ def test_connection_error_raised_when_connection_dies(self, r):
 class TestPubSubTimeouts:
     def test_get_message_with_timeout_returns_none(self, r):
         p = r.pubsub()
-        p.subscribe('foo')
-        assert wait_for_message(p) == make_message('subscribe', 'foo', 1)
+        p.subscribe("foo")
+        assert wait_for_message(p) == make_message("subscribe", "foo", 1)
         assert p.get_message(timeout=0.01) is None
 
 
 class TestPubSubWorkerThread:
-
-    @pytest.mark.skipif(platform.python_implementation() == 'PyPy',
-                        reason="Pypy threading issue")
+    @pytest.mark.skipif(
+        platform.python_implementation() == "PyPy", reason="Pypy threading issue"
+    )
     def test_pubsub_worker_thread_exception_handler(self, r):
         event = threading.Event()
 
@@ -575,12 +562,10 @@ def exception_handler(ex, pubsub, thread):
             event.set()
 
         p = r.pubsub()
-        p.subscribe(**{'foo': lambda m: m})
-        with mock.patch.object(p, 'get_message',
-                               side_effect=Exception('error')):
+        p.subscribe(**{"foo": lambda m: m})
+        with mock.patch.object(p, "get_message", side_effect=Exception("error")):
             pubsub_thread = p.run_in_thread(
-                daemon=True,
-                exception_handler=exception_handler
+                daemon=True, exception_handler=exception_handler
             )
 
         assert event.wait(timeout=1.0)
@@ -589,10 +574,9 @@ def exception_handler(ex, pubsub, thread):
 
 
 class TestPubSubDeadlock:
-    @pytest.mark.timeout(30, method='thread')
+    @pytest.mark.timeout(30, method="thread")
     def test_pubsub_deadlock(self, master_host):
-        pool = redis.ConnectionPool(host=master_host[0],
-                                    port=master_host[1])
+        pool = redis.ConnectionPool(host=master_host[0], port=master_host[1])
         r = redis.Redis(connection_pool=pool)
 
         for i in range(60):
diff --git a/tests/test_retry.py b/tests/test_retry.py
index 535485acae..c4650bc650 100644
--- a/tests/test_retry.py
+++ b/tests/test_retry.py
@@ -1,8 +1,8 @@
-from redis.backoff import NoBackoff
 import pytest
 
-from redis.exceptions import ConnectionError
+from redis.backoff import NoBackoff
 from redis.connection import Connection, UnixDomainSocketConnection
+from redis.exceptions import ConnectionError
 from redis.retry import Retry
 
 
@@ -34,8 +34,7 @@ def test_retry_on_timeout_boolean(self, Class, retry_on_timeout):
     @pytest.mark.parametrize("Class", [Connection, UnixDomainSocketConnection])
     def test_retry_on_timeout_retry(self, Class, retries):
         retry_on_timeout = retries > 0
-        c = Class(retry_on_timeout=retry_on_timeout,
-                  retry=Retry(NoBackoff(), retries))
+        c = Class(retry_on_timeout=retry_on_timeout, retry=Retry(NoBackoff(), retries))
         assert c.retry_on_timeout == retry_on_timeout
         assert isinstance(c.retry, Retry)
         assert c.retry._retries == retries
diff --git a/tests/test_scripting.py b/tests/test_scripting.py
index 7614b1233f..9f4f82023f 100644
--- a/tests/test_scripting.py
+++ b/tests/test_scripting.py
@@ -1,10 +1,8 @@
 import pytest
 
 from redis import exceptions
-
 from tests.conftest import skip_if_server_version_lt
 
-
 multiply_script = """
 local value = redis.call('GET', KEYS[1])
 value = tonumber(value)
@@ -29,52 +27,52 @@ def reset_scripts(self, r):
         r.script_flush()
 
     def test_eval(self, r):
-        r.set('a', 2)
+        r.set("a", 2)
         # 2 * 3 == 6
-        assert r.eval(multiply_script, 1, 'a', 3) == 6
+        assert r.eval(multiply_script, 1, "a", 3) == 6
 
-    @skip_if_server_version_lt('6.2.0')
+    @skip_if_server_version_lt("6.2.0")
     def test_script_flush_620(self, r):
-        r.set('a', 2)
+        r.set("a", 2)
         r.script_load(multiply_script)
-        r.script_flush('ASYNC')
+        r.script_flush("ASYNC")
 
-        r.set('a', 2)
+        r.set("a", 2)
         r.script_load(multiply_script)
-        r.script_flush('SYNC')
+        r.script_flush("SYNC")
 
-        r.set('a', 2)
+        r.set("a", 2)
         r.script_load(multiply_script)
         r.script_flush()
 
         with pytest.raises(exceptions.DataError):
-            r.set('a', 2)
+            r.set("a", 2)
             r.script_load(multiply_script)
             r.script_flush("NOTREAL")
 
     def test_script_flush(self, r):
-        r.set('a', 2)
+        r.set("a", 2)
         r.script_load(multiply_script)
         r.script_flush(None)
 
         with pytest.raises(exceptions.DataError):
-            r.set('a', 2)
+            r.set("a", 2)
             r.script_load(multiply_script)
             r.script_flush("NOTREAL")
 
     def test_evalsha(self, r):
-        r.set('a', 2)
+        r.set("a", 2)
         sha = r.script_load(multiply_script)
         # 2 * 3 == 6
-        assert r.evalsha(sha, 1, 'a', 3) == 6
+        assert r.evalsha(sha, 1, "a", 3) == 6
 
     def test_evalsha_script_not_loaded(self, r):
-        r.set('a', 2)
+        r.set("a", 2)
         sha = r.script_load(multiply_script)
         # remove the script from Redis's cache
         r.script_flush()
         with pytest.raises(exceptions.NoScriptError):
-            r.evalsha(sha, 1, 'a', 3)
+            r.evalsha(sha, 1, "a", 3)
 
     def test_script_loading(self, r):
         # get the sha, then clear the cache
@@ -85,31 +83,31 @@ def test_script_loading(self, r):
         assert r.script_exists(sha) == [True]
 
     def test_script_object(self, r):
-        r.set('a', 2)
+        r.set("a", 2)
         multiply = r.register_script(multiply_script)
         precalculated_sha = multiply.sha
         assert precalculated_sha
         assert r.script_exists(multiply.sha) == [False]
         # Test second evalsha block (after NoScriptError)
-        assert multiply(keys=['a'], args=[3]) == 6
+        assert multiply(keys=["a"], args=[3]) == 6
         # At this point, the script should be loaded
         assert r.script_exists(multiply.sha) == [True]
         # Test that the precalculated sha matches the one from redis
         assert multiply.sha == precalculated_sha
         # Test first evalsha block
-        assert multiply(keys=['a'], args=[3]) == 6
+        assert multiply(keys=["a"], args=[3]) == 6
 
     def test_script_object_in_pipeline(self, r):
         multiply = r.register_script(multiply_script)
         precalculated_sha = multiply.sha
         assert precalculated_sha
         pipe = r.pipeline()
-        pipe.set('a', 2)
-        pipe.get('a')
-        multiply(keys=['a'], args=[3], client=pipe)
+        pipe.set("a", 2)
+        pipe.get("a")
+        multiply(keys=["a"], args=[3], client=pipe)
         assert r.script_exists(multiply.sha) == [False]
         # [SET worked, GET 'a', result of multiple script]
-        assert pipe.execute() == [True, b'2', 6]
+        assert pipe.execute() == [True, b"2", 6]
         # The script should have been loaded by pipe.execute()
         assert r.script_exists(multiply.sha) == [True]
         # The precalculated sha should have been the correct one
@@ -119,12 +117,12 @@ def test_script_object_in_pipeline(self, r):
         # the multiply script should be reloaded by pipe.execute()
         r.script_flush()
         pipe = r.pipeline()
-        pipe.set('a', 2)
-        pipe.get('a')
-        multiply(keys=['a'], args=[3], client=pipe)
+        pipe.set("a", 2)
+        pipe.get("a")
+        multiply(keys=["a"], args=[3], client=pipe)
         assert r.script_exists(multiply.sha) == [False]
         # [SET worked, GET 'a', result of multiple script]
-        assert pipe.execute() == [True, b'2', 6]
+        assert pipe.execute() == [True, b"2", 6]
         assert r.script_exists(multiply.sha) == [True]
 
     def test_eval_msgpack_pipeline_error_in_lua(self, r):
@@ -135,12 +133,12 @@ def test_eval_msgpack_pipeline_error_in_lua(self, r):
 
         # avoiding a dependency to msgpack, this is the output of
         # msgpack.dumps({"name": "joe"})
-        msgpack_message_1 = b'\x81\xa4name\xa3Joe'
+        msgpack_message_1 = b"\x81\xa4name\xa3Joe"
 
         msgpack_hello(args=[msgpack_message_1], client=pipe)
 
         assert r.script_exists(msgpack_hello.sha) == [False]
-        assert pipe.execute()[0] == b'hello Joe'
+        assert pipe.execute()[0] == b"hello Joe"
         assert r.script_exists(msgpack_hello.sha) == [True]
 
         msgpack_hello_broken = r.register_script(msgpack_hello_script_broken)
diff --git a/tests/test_search.py b/tests/test_search.py
index c7b570cdd1..5b6a66009a 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1,52 +1,32 @@
-import pytest
-import redis
 import bz2
 import csv
-import time
 import os
-
+import time
 from io import TextIOWrapper
-from .conftest import skip_ifmodversion_lt, default_redismod_url
-from redis import Redis
 
+import pytest
+
+import redis
 import redis.commands.search
+import redis.commands.search.aggregation as aggregations
+import redis.commands.search.reducers as reducers
+from redis import Redis
 from redis.commands.json.path import Path
 from redis.commands.search import Search
-from redis.commands.search.field import (
-    GeoField,
-    NumericField,
-    TagField,
-    TextField
-)
-from redis.commands.search.query import (
-    GeoFilter,
-    NumericFilter,
-    Query
-)
-from redis.commands.search.result import Result
+from redis.commands.search.field import GeoField, NumericField, TagField, TextField
 from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.query import GeoFilter, NumericFilter, Query
+from redis.commands.search.result import Result
 from redis.commands.search.suggestion import Suggestion
-import redis.commands.search.aggregation as aggregations
-import redis.commands.search.reducers as reducers
 
-WILL_PLAY_TEXT = (
-    os.path.abspath(
-        os.path.join(
-            os.path.dirname(__file__),
-            "testdata",
-            "will_play_text.csv.bz2"
-        )
-    )
+from .conftest import default_redismod_url, skip_ifmodversion_lt
+
+WILL_PLAY_TEXT = os.path.abspath(
+    os.path.join(os.path.dirname(__file__), "testdata", "will_play_text.csv.bz2")
 )
 
-TITLES_CSV = (
-    os.path.abspath(
-        os.path.join(
-            os.path.dirname(__file__),
-            "testdata",
-            "titles.csv"
-        )
-    )
+TITLES_CSV = os.path.abspath(
+    os.path.join(os.path.dirname(__file__), "testdata", "titles.csv")
 )
 
 
@@ -81,9 +61,7 @@ def getClient():
 def createIndex(client, num_docs=100, definition=None):
     try:
         client.create_index(
-            (TextField("play", weight=5.0),
-             TextField("txt"),
-             NumericField("chapter")),
+            (TextField("play", weight=5.0), TextField("txt"), NumericField("chapter")),
             definition=definition,
         )
     except redis.ResponseError:
@@ -96,8 +74,7 @@ def createIndex(client, num_docs=100, definition=None):
     r = csv.reader(bzfp, delimiter=";")
     for n, line in enumerate(r):
 
-        play, chapter, _, text = \
-            line[1], line[2], line[4], line[5]
+        play, chapter, _, text = line[1], line[2], line[4], line[5]
 
         key = f"{play}:{chapter}".lower()
         d = chapters.setdefault(key, {})
@@ -183,12 +160,10 @@ def test_client(client):
 
     # test in fields
     txt_total = (
-        client.ft().search(
-            Query("henry").no_content().limit_fields("txt")).total
+        client.ft().search(Query("henry").no_content().limit_fields("txt")).total
     )
     play_total = (
-        client.ft().search(
-            Query("henry").no_content().limit_fields("play")).total
+        client.ft().search(Query("henry").no_content().limit_fields("play")).total
     )
     both_total = (
         client.ft()
@@ -217,10 +192,8 @@ def test_client(client):
 
     # test slop and in order
     assert 193 == client.ft().search(Query("henry king")).total
-    assert 3 == client.ft().search(
-        Query("henry king").slop(0).in_order()).total
-    assert 52 == client.ft().search(
-        Query("king henry").slop(0).in_order()).total
+    assert 3 == client.ft().search(Query("henry king").slop(0).in_order()).total
+    assert 52 == client.ft().search(Query("king henry").slop(0).in_order()).total
     assert 53 == client.ft().search(Query("henry king").slop(0)).total
     assert 167 == client.ft().search(Query("henry king").slop(100)).total
 
@@ -284,11 +257,7 @@ def test_replace(client):
 
     res = client.ft().search("foo bar")
     assert 2 == res.total
-    client.ft().add_document(
-        "doc1",
-        replace=True,
-        txt="this is a replaced doc"
-    )
+    client.ft().add_document("doc1", replace=True, txt="this is a replaced doc")
 
     res = client.ft().search("foo bar")
     assert 1 == res.total
@@ -301,10 +270,7 @@ def test_replace(client):
 
 @pytest.mark.redismod
 def test_stopwords(client):
-    client.ft().create_index(
-        (TextField("txt"),),
-        stopwords=["foo", "bar", "baz"]
-    )
+    client.ft().create_index((TextField("txt"),), stopwords=["foo", "bar", "baz"])
     client.ft().add_document("doc1", txt="foo bar")
     client.ft().add_document("doc2", txt="hello world")
     waitForIndex(client, "idx")
@@ -318,17 +284,8 @@ def test_stopwords(client):
 
 @pytest.mark.redismod
 def test_filters(client):
-    client.ft().create_index(
-        (TextField("txt"),
-         NumericField("num"),
-         GeoField("loc"))
-    )
-    client.ft().add_document(
-        "doc1",
-        txt="foo bar",
-        num=3.141,
-        loc="-0.441,51.458"
-    )
+    client.ft().create_index((TextField("txt"), NumericField("num"), GeoField("loc")))
+    client.ft().add_document("doc1", txt="foo bar", num=3.141, loc="-0.441,51.458")
     client.ft().add_document("doc2", txt="foo baz", num=2, loc="-0.1,51.2")
 
     waitForIndex(client, "idx")
@@ -336,8 +293,7 @@ def test_filters(client):
     q1 = Query("foo").add_filter(NumericFilter("num", 0, 2)).no_content()
     q2 = (
         Query("foo")
-        .add_filter(
-            NumericFilter("num", 2, NumericFilter.INF, minExclusive=True))
+        .add_filter(NumericFilter("num", 2, NumericFilter.INF, minExclusive=True))
         .no_content()
     )
     res1, res2 = client.ft().search(q1), client.ft().search(q2)
@@ -348,10 +304,8 @@ def test_filters(client):
     assert "doc1" == res2.docs[0].id
 
     # Test geo filter
-    q1 = Query("foo").add_filter(
-        GeoFilter("loc", -0.44, 51.45, 10)).no_content()
-    q2 = Query("foo").add_filter(
-        GeoFilter("loc", -0.44, 51.45, 100)).no_content()
+    q1 = Query("foo").add_filter(GeoFilter("loc", -0.44, 51.45, 10)).no_content()
+    q2 = Query("foo").add_filter(GeoFilter("loc", -0.44, 51.45, 100)).no_content()
     res1, res2 = client.ft().search(q1), client.ft().search(q2)
 
     assert 1 == res1.total
@@ -377,10 +331,7 @@ def test_payloads_with_no_content(client):
 
 @pytest.mark.redismod
 def test_sort_by(client):
-    client.ft().create_index(
-        (TextField("txt"),
-         NumericField("num", sortable=True))
-    )
+    client.ft().create_index((TextField("txt"), NumericField("num", sortable=True)))
     client.ft().add_document("doc1", txt="foo bar", num=1)
     client.ft().add_document("doc2", txt="foo baz", num=2)
     client.ft().add_document("doc3", txt="foo qux", num=3)
@@ -422,10 +373,7 @@ def test_drop_index():
 @pytest.mark.redismod
 def test_example(client):
     # Creating the index definition and schema
-    client.ft().create_index(
-        (TextField("title", weight=5.0),
-         TextField("body"))
-    )
+    client.ft().create_index((TextField("title", weight=5.0), TextField("body")))
 
     # Indexing a document
     client.ft().add_document(
@@ -483,12 +431,7 @@ def test_auto_complete(client):
     client.ft().sugadd("ac", Suggestion("pay2", payload="pl2"))
     client.ft().sugadd("ac", Suggestion("pay3", payload="pl3"))
 
-    sugs = client.ft().sugget(
-        "ac",
-        "pay",
-        with_payloads=True,
-        with_scores=True
-    )
+    sugs = client.ft().sugget("ac", "pay", with_payloads=True, with_scores=True)
     assert 3 == len(sugs)
     for sug in sugs:
         assert sug.payload
@@ -550,11 +493,7 @@ def test_no_index(client):
 
 @pytest.mark.redismod
 def test_partial(client):
-    client.ft().create_index(
-        (TextField("f1"),
-         TextField("f2"),
-         TextField("f3"))
-    )
+    client.ft().create_index((TextField("f1"), TextField("f2"), TextField("f3")))
     client.ft().add_document("doc1", f1="f1_val", f2="f2_val")
     client.ft().add_document("doc2", f1="f1_val", f2="f2_val")
     client.ft().add_document("doc1", f3="f3_val", partial=True)
@@ -572,11 +511,7 @@ def test_partial(client):
 
 @pytest.mark.redismod
 def test_no_create(client):
-    client.ft().create_index(
-        (TextField("f1"),
-         TextField("f2"),
-         TextField("f3"))
-    )
+    client.ft().create_index((TextField("f1"), TextField("f2"), TextField("f3")))
     client.ft().add_document("doc1", f1="f1_val", f2="f2_val")
     client.ft().add_document("doc2", f1="f1_val", f2="f2_val")
     client.ft().add_document("doc1", f3="f3_val", no_create=True)
@@ -592,21 +527,12 @@ def test_no_create(client):
     assert 1 == res.total
 
     with pytest.raises(redis.ResponseError):
-        client.ft().add_document(
-            "doc3",
-            f2="f2_val",
-            f3="f3_val",
-            no_create=True
-        )
+        client.ft().add_document("doc3", f2="f2_val", f3="f3_val", no_create=True)
 
 
 @pytest.mark.redismod
 def test_explain(client):
-    client.ft().create_index(
-        (TextField("f1"),
-         TextField("f2"),
-         TextField("f3"))
-    )
+    client.ft().create_index((TextField("f1"), TextField("f2"), TextField("f3")))
     res = client.ft().explain("@f3:f3_val @f2:f2_val @f1:f1_val")
     assert res
 
@@ -629,8 +555,8 @@ def test_summarize(client):
     doc = sorted(client.ft().search(q).docs)[0]
     assert "<b>Henry</b> IV" == doc.play
     assert (
-            "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
-            == doc.txt
+        "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+        == doc.txt
     )
 
     q = Query("king henry").paging(0, 1).summarize().highlight()
@@ -638,8 +564,8 @@ def test_summarize(client):
     doc = sorted(client.ft().search(q).docs)[0]
     assert "<b>Henry</b> ... " == doc.play
     assert (
-            "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
-            == doc.txt
+        "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+        == doc.txt
     )
 
 
@@ -786,11 +712,7 @@ def test_alter_schema_add(client):
 def test_spell_check(client):
     client.ft().create_index((TextField("f1"), TextField("f2")))
 
-    client.ft().add_document(
-        "doc1",
-        f1="some valid content",
-        f2="this is sample text"
-    )
+    client.ft().add_document("doc1", f1="some valid content", f2="this is sample text")
     client.ft().add_document("doc2", f1="very important", f2="lorem ipsum")
     waitForIndex(client, "idx")
 
@@ -812,10 +734,10 @@ def test_spell_check(client):
     res = client.ft().spellcheck("lorm", include="dict")
     assert len(res["lorm"]) == 3
     assert (
-               res["lorm"][0]["suggestion"],
-               res["lorm"][1]["suggestion"],
-               res["lorm"][2]["suggestion"],
-           ) == ("lorem", "lore", "lorm")
+        res["lorm"][0]["suggestion"],
+        res["lorm"][1]["suggestion"],
+        res["lorm"][2]["suggestion"],
+    ) == ("lorem", "lore", "lorm")
     assert (res["lorm"][0]["score"], res["lorm"][1]["score"]) == ("0.5", "0")
 
     # test spellcheck exclude
@@ -873,7 +795,7 @@ def test_scorer(client):
     )
     client.ft().add_document(
         "doc2",
-        description="Quick alice was beginning to get very tired of sitting by her quick sister on the bank, and of having nothing to do.", # noqa
+        description="Quick alice was beginning to get very tired of sitting by her quick sister on the bank, and of having nothing to do.",  # noqa
     )
 
     # default scorer is TFIDF
@@ -881,8 +803,7 @@ def test_scorer(client):
     assert 1.0 == res.docs[0].score
     res = client.ft().search(Query("quick").scorer("TFIDF").with_scores())
     assert 1.0 == res.docs[0].score
-    res = client.ft().search(
-        Query("quick").scorer("TFIDF.DOCNORM").with_scores())
+    res = client.ft().search(Query("quick").scorer("TFIDF.DOCNORM").with_scores())
     assert 0.1111111111111111 == res.docs[0].score
     res = client.ft().search(Query("quick").scorer("BM25").with_scores())
     assert 0.17699114465425977 == res.docs[0].score
@@ -1060,7 +981,7 @@ def test_aggregations_groupby(client):
     )
 
     res = client.ft().aggregate(req).rows[0]
-    assert res == ['parent', 'redis', 'first', 'RediSearch']
+    assert res == ["parent", "redis", "first", "RediSearch"]
 
     req = aggregations.AggregateRequest("redis").group_by(
         "@parent",
@@ -1083,35 +1004,33 @@ def test_aggregations_sort_by_and_limit(client):
         )
     )
 
-    client.ft().client.hset("doc1", mapping={'t1': 'a', 't2': 'b'})
-    client.ft().client.hset("doc2", mapping={'t1': 'b', 't2': 'a'})
+    client.ft().client.hset("doc1", mapping={"t1": "a", "t2": "b"})
+    client.ft().client.hset("doc2", mapping={"t1": "b", "t2": "a"})
 
     # test sort_by using SortDirection
-    req = aggregations.AggregateRequest("*") \
-        .sort_by(aggregations.Asc("@t2"), aggregations.Desc("@t1"))
+    req = aggregations.AggregateRequest("*").sort_by(
+        aggregations.Asc("@t2"), aggregations.Desc("@t1")
+    )
     res = client.ft().aggregate(req)
-    assert res.rows[0] == ['t2', 'a', 't1', 'b']
-    assert res.rows[1] == ['t2', 'b', 't1', 'a']
+    assert res.rows[0] == ["t2", "a", "t1", "b"]
+    assert res.rows[1] == ["t2", "b", "t1", "a"]
 
     # test sort_by without SortDirection
-    req = aggregations.AggregateRequest("*") \
-        .sort_by("@t1")
+    req = aggregations.AggregateRequest("*").sort_by("@t1")
     res = client.ft().aggregate(req)
-    assert res.rows[0] == ['t1', 'a']
-    assert res.rows[1] == ['t1', 'b']
+    assert res.rows[0] == ["t1", "a"]
+    assert res.rows[1] == ["t1", "b"]
 
     # test sort_by with max
-    req = aggregations.AggregateRequest("*") \
-        .sort_by("@t1", max=1)
+    req = aggregations.AggregateRequest("*").sort_by("@t1", max=1)
     res = client.ft().aggregate(req)
     assert len(res.rows) == 1
 
     # test limit
-    req = aggregations.AggregateRequest("*") \
-        .sort_by("@t1").limit(1, 1)
+    req = aggregations.AggregateRequest("*").sort_by("@t1").limit(1, 1)
     res = client.ft().aggregate(req)
     assert len(res.rows) == 1
-    assert res.rows[0] == ['t1', 'b']
+    assert res.rows[0] == ["t1", "b"]
 
 
 @pytest.mark.redismod
@@ -1123,17 +1042,17 @@ def test_aggregations_load(client):
         )
     )
 
-    client.ft().client.hset("doc1", mapping={'t1': 'hello', 't2': 'world'})
+    client.ft().client.hset("doc1", mapping={"t1": "hello", "t2": "world"})
 
     # load t1
     req = aggregations.AggregateRequest("*").load("t1")
     res = client.ft().aggregate(req)
-    assert res.rows[0] == ['t1', 'hello']
+    assert res.rows[0] == ["t1", "hello"]
 
     # load t2
     req = aggregations.AggregateRequest("*").load("t2")
     res = client.ft().aggregate(req)
-    assert res.rows[0] == ['t2', 'world']
+    assert res.rows[0] == ["t2", "world"]
 
 
 @pytest.mark.redismod
@@ -1147,24 +1066,19 @@ def test_aggregations_apply(client):
 
     client.ft().client.hset(
         "doc1",
-        mapping={
-            'PrimaryKey': '9::362330',
-            'CreatedDateTimeUTC': '637387878524969984'
-        }
+        mapping={"PrimaryKey": "9::362330", "CreatedDateTimeUTC": "637387878524969984"},
     )
     client.ft().client.hset(
         "doc2",
-        mapping={
-            'PrimaryKey': '9::362329',
-            'CreatedDateTimeUTC': '637387875859270016'
-        }
+        mapping={"PrimaryKey": "9::362329", "CreatedDateTimeUTC": "637387875859270016"},
     )
 
-    req = aggregations.AggregateRequest("*") \
-        .apply(CreatedDateTimeUTC='@CreatedDateTimeUTC * 10')
+    req = aggregations.AggregateRequest("*").apply(
+        CreatedDateTimeUTC="@CreatedDateTimeUTC * 10"
+    )
     res = client.ft().aggregate(req)
-    assert res.rows[0] == ['CreatedDateTimeUTC', '6373878785249699840']
-    assert res.rows[1] == ['CreatedDateTimeUTC', '6373878758592700416']
+    assert res.rows[0] == ["CreatedDateTimeUTC", "6373878785249699840"]
+    assert res.rows[1] == ["CreatedDateTimeUTC", "6373878758592700416"]
 
 
 @pytest.mark.redismod
@@ -1176,33 +1090,19 @@ def test_aggregations_filter(client):
         )
     )
 
-    client.ft().client.hset(
-        "doc1",
-        mapping={
-            'name': 'bar',
-            'age': '25'
-        }
-    )
-    client.ft().client.hset(
-        "doc2",
-        mapping={
-            'name': 'foo',
-            'age': '19'
-        }
-    )
+    client.ft().client.hset("doc1", mapping={"name": "bar", "age": "25"})
+    client.ft().client.hset("doc2", mapping={"name": "foo", "age": "19"})
 
-    req = aggregations.AggregateRequest("*") \
-        .filter("@name=='foo' && @age < 20")
+    req = aggregations.AggregateRequest("*").filter("@name=='foo' && @age < 20")
     res = client.ft().aggregate(req)
     assert len(res.rows) == 1
-    assert res.rows[0] == ['name', 'foo', 'age', '19']
+    assert res.rows[0] == ["name", "foo", "age", "19"]
 
-    req = aggregations.AggregateRequest("*") \
-        .filter("@age > 15").sort_by("@age")
+    req = aggregations.AggregateRequest("*").filter("@age > 15").sort_by("@age")
     res = client.ft().aggregate(req)
     assert len(res.rows) == 2
-    assert res.rows[0] == ['age', '19']
-    assert res.rows[1] == ['age', '25']
+    assert res.rows[0] == ["age", "19"]
+    assert res.rows[1] == ["age", "25"]
 
 
 @pytest.mark.redismod
@@ -1226,25 +1126,25 @@ def test_index_definition(client):
     )
 
     assert [
-               "ON",
-               "JSON",
-               "PREFIX",
-               2,
-               "hset:",
-               "henry",
-               "FILTER",
-               "@f1==32",
-               "LANGUAGE_FIELD",
-               "play",
-               "LANGUAGE",
-               "English",
-               "SCORE_FIELD",
-               "chapter",
-               "SCORE",
-               0.5,
-               "PAYLOAD_FIELD",
-               "txt",
-           ] == definition.args
+        "ON",
+        "JSON",
+        "PREFIX",
+        2,
+        "hset:",
+        "henry",
+        "FILTER",
+        "@f1==32",
+        "LANGUAGE_FIELD",
+        "play",
+        "LANGUAGE",
+        "English",
+        "SCORE_FIELD",
+        "chapter",
+        "SCORE",
+        0.5,
+        "PAYLOAD_FIELD",
+        "txt",
+    ] == definition.args
 
     createIndex(client.ft(), num_docs=500, definition=definition)
 
@@ -1274,10 +1174,7 @@ def test_create_client_definition_hash(client):
     Create definition with IndexType.HASH as index type (ON HASH),
     and use hset to test the client definition.
     """
-    definition = IndexDefinition(
-        prefix=["hset:", "henry"],
-        index_type=IndexType.HASH
-    )
+    definition = IndexDefinition(prefix=["hset:", "henry"], index_type=IndexType.HASH)
     createIndex(client.ft(), num_docs=500, definition=definition)
 
     info = client.ft().info()
@@ -1320,15 +1217,10 @@ def test_fields_as_name(client):
     client.ft().create_index(SCHEMA, definition=definition)
 
     # insert json data
-    res = client.json().set(
-        "doc:1",
-        Path.rootPath(),
-        {"name": "Jon", "age": 25}
-    )
+    res = client.json().set("doc:1", Path.rootPath(), {"name": "Jon", "age": 25})
     assert res
 
-    total = client.ft().search(
-        Query("Jon").return_fields("name", "just_a_number")).docs
+    total = client.ft().search(Query("Jon").return_fields("name", "just_a_number")).docs
     assert 1 == len(total)
     assert "doc:1" == total[0].id
     assert "Jon" == total[0].name
@@ -1354,14 +1246,12 @@ def test_search_return_fields(client):
     client.ft().create_index(SCHEMA, definition=definition)
     waitForIndex(client, "idx")
 
-    total = client.ft().search(
-        Query("*").return_field("$.t", as_field="txt")).docs
+    total = client.ft().search(Query("*").return_field("$.t", as_field="txt")).docs
     assert 1 == len(total)
     assert "doc:1" == total[0].id
     assert "riceratops" == total[0].txt
 
-    total = client.ft().search(
-        Query("*").return_field("$.t2", as_field="txt")).docs
+    total = client.ft().search(Query("*").return_field("$.t2", as_field="txt")).docs
     assert 1 == len(total)
     assert "doc:1" == total[0].id
     assert "telmatosaurus" == total[0].txt
@@ -1379,17 +1269,10 @@ def test_synupdate(client):
     )
 
     client.ft().synupdate("id1", True, "boy", "child", "offspring")
-    client.ft().add_document(
-        "doc1",
-        title="he is a baby",
-        body="this is a test")
+    client.ft().add_document("doc1", title="he is a baby", body="this is a test")
 
     client.ft().synupdate("id1", True, "baby")
-    client.ft().add_document(
-        "doc2",
-        title="he is another baby",
-        body="another test"
-    )
+    client.ft().add_document("doc2", title="he is another baby", body="another test")
 
     res = client.ft().search(Query("child").expander("SYNONYM"))
     assert res.docs[0].id == "doc2"
@@ -1431,15 +1314,12 @@ def test_create_json_with_alias(client):
     """
     definition = IndexDefinition(prefix=["king:"], index_type=IndexType.JSON)
     client.ft().create_index(
-        (TextField("$.name", as_name="name"),
-         NumericField("$.num", as_name="num")),
-        definition=definition
+        (TextField("$.name", as_name="name"), NumericField("$.num", as_name="num")),
+        definition=definition,
     )
 
-    client.json().set("king:1", Path.rootPath(), {"name": "henry",
-                                                  "num": 42})
-    client.json().set("king:2", Path.rootPath(), {"name": "james",
-                                                  "num": 3.14})
+    client.json().set("king:1", Path.rootPath(), {"name": "henry", "num": 42})
+    client.json().set("king:2", Path.rootPath(), {"name": "james", "num": 3.14})
 
     res = client.ft().search("@name:henry")
     assert res.docs[0].id == "king:1"
@@ -1466,12 +1346,12 @@ def test_json_with_multipath(client):
     """
     definition = IndexDefinition(prefix=["king:"], index_type=IndexType.JSON)
     client.ft().create_index(
-        (TagField("$..name", as_name="name")),
-        definition=definition
+        (TagField("$..name", as_name="name")), definition=definition
     )
 
-    client.json().set("king:1", Path.rootPath(),
-                      {"name": "henry", "country": {"name": "england"}})
+    client.json().set(
+        "king:1", Path.rootPath(), {"name": "henry", "country": {"name": "england"}}
+    )
 
     res = client.ft().search("@name:{henry}")
     assert res.docs[0].id == "king:1"
@@ -1489,9 +1369,11 @@ def test_json_with_multipath(client):
 def test_json_with_jsonpath(client):
     definition = IndexDefinition(index_type=IndexType.JSON)
     client.ft().create_index(
-        (TextField('$["prod:name"]', as_name="name"),
-         TextField('$.prod:name', as_name="name_unsupported")),
-        definition=definition
+        (
+            TextField('$["prod:name"]', as_name="name"),
+            TextField("$.prod:name", as_name="name_unsupported"),
+        ),
+        definition=definition,
     )
 
     client.json().set("doc:1", Path.rootPath(), {"prod:name": "RediSearch"})
@@ -1510,11 +1392,10 @@ def test_json_with_jsonpath(client):
     res = client.ft().search(Query("@name:RediSearch").return_field("name"))
     assert res.total == 1
     assert res.docs[0].id == "doc:1"
-    assert res.docs[0].name == 'RediSearch'
+    assert res.docs[0].name == "RediSearch"
 
     # return of an unsupported field fails
-    res = client.ft().search(Query("@name:RediSearch")
-                             .return_field("name_unsupported"))
+    res = client.ft().search(Query("@name:RediSearch").return_field("name_unsupported"))
     assert res.total == 1
     assert res.docs[0].id == "doc:1"
     with pytest.raises(Exception):
@@ -1523,42 +1404,49 @@ def test_json_with_jsonpath(client):
 
 @pytest.mark.redismod
 def test_profile(client):
-    client.ft().create_index((TextField('t'),))
-    client.ft().client.hset('1', 't', 'hello')
-    client.ft().client.hset('2', 't', 'world')
+    client.ft().create_index((TextField("t"),))
+    client.ft().client.hset("1", "t", "hello")
+    client.ft().client.hset("2", "t", "world")
 
     # check using Query
-    q = Query('hello|world').no_content()
+    q = Query("hello|world").no_content()
     res, det = client.ft().profile(q)
-    assert det['Iterators profile']['Counter'] == 2.0
-    assert len(det['Iterators profile']['Child iterators']) == 2
-    assert det['Iterators profile']['Type'] == 'UNION'
-    assert det['Parsing time'] < 0.3
+    assert det["Iterators profile"]["Counter"] == 2.0
+    assert len(det["Iterators profile"]["Child iterators"]) == 2
+    assert det["Iterators profile"]["Type"] == "UNION"
+    assert det["Parsing time"] < 0.3
     assert len(res.docs) == 2  # check also the search result
 
     # check using AggregateRequest
-    req = aggregations.AggregateRequest("*").load("t")\
+    req = (
+        aggregations.AggregateRequest("*")
+        .load("t")
         .apply(prefix="startswith(@t, 'hel')")
+    )
     res, det = client.ft().profile(req)
-    assert det['Iterators profile']['Counter'] == 2.0
-    assert det['Iterators profile']['Type'] == 'WILDCARD'
-    assert det['Parsing time'] < 0.3
+    assert det["Iterators profile"]["Counter"] == 2.0
+    assert det["Iterators profile"]["Type"] == "WILDCARD"
+    assert det["Parsing time"] < 0.3
     assert len(res.rows) == 2  # check also the search result
 
 
 @pytest.mark.redismod
 def test_profile_limited(client):
-    client.ft().create_index((TextField('t'),))
-    client.ft().client.hset('1', 't', 'hello')
-    client.ft().client.hset('2', 't', 'hell')
-    client.ft().client.hset('3', 't', 'help')
-    client.ft().client.hset('4', 't', 'helowa')
+    client.ft().create_index((TextField("t"),))
+    client.ft().client.hset("1", "t", "hello")
+    client.ft().client.hset("2", "t", "hell")
+    client.ft().client.hset("3", "t", "help")
+    client.ft().client.hset("4", "t", "helowa")
 
-    q = Query('%hell% hel*')
+    q = Query("%hell% hel*")
     res, det = client.ft().profile(q, limited=True)
-    assert det['Iterators profile']['Child iterators'][0]['Child iterators'] \
-           == 'The number of iterators in the union is 3'
-    assert det['Iterators profile']['Child iterators'][1]['Child iterators'] \
-           == 'The number of iterators in the union is 4'
-    assert det['Iterators profile']['Type'] == 'INTERSECT'
+    assert (
+        det["Iterators profile"]["Child iterators"][0]["Child iterators"]
+        == "The number of iterators in the union is 3"
+    )
+    assert (
+        det["Iterators profile"]["Child iterators"][1]["Child iterators"]
+        == "The number of iterators in the union is 4"
+    )
+    assert det["Iterators profile"]["Type"] == "INTERSECT"
     assert len(res.docs) == 3  # check also the search result
diff --git a/tests/test_sentinel.py b/tests/test_sentinel.py
index 9377d5ba65..0357443a14 100644
--- a/tests/test_sentinel.py
+++ b/tests/test_sentinel.py
@@ -2,10 +2,14 @@
 
 import pytest
 
-from redis import exceptions
-from redis.sentinel import (Sentinel, SentinelConnectionPool,
-                            MasterNotFoundError, SlaveNotFoundError)
 import redis.sentinel
+from redis import exceptions
+from redis.sentinel import (
+    MasterNotFoundError,
+    Sentinel,
+    SentinelConnectionPool,
+    SlaveNotFoundError,
+)
 
 
 @pytest.fixture(scope="module")
@@ -33,20 +37,20 @@ def sentinel_slaves(self, master_name):
     def execute_command(self, *args, **kwargs):
         # wrapper  purely to validate the calls don't explode
         from redis.client import bool_ok
+
         return bool_ok
 
 
 class SentinelTestCluster:
-    def __init__(self, servisentinel_ce_name='mymaster', ip='127.0.0.1',
-                 port=6379):
+    def __init__(self, servisentinel_ce_name="mymaster", ip="127.0.0.1", port=6379):
         self.clients = {}
         self.master = {
-            'ip': ip,
-            'port': port,
-            'is_master': True,
-            'is_sdown': False,
-            'is_odown': False,
-            'num-other-sentinels': 0,
+            "ip": ip,
+            "port": port,
+            "is_master": True,
+            "is_sdown": False,
+            "is_odown": False,
+            "num-other-sentinels": 0,
         }
         self.service_name = servisentinel_ce_name
         self.slaves = []
@@ -69,6 +73,7 @@ def client(self, host, port, **kwargs):
 def cluster(request, master_ip):
     def teardown():
         redis.sentinel.Redis = saved_Redis
+
     cluster = SentinelTestCluster(ip=master_ip)
     saved_Redis = redis.sentinel.Redis
     redis.sentinel.Redis = cluster.client
@@ -78,126 +83,121 @@ def teardown():
 
 @pytest.fixture()
 def sentinel(request, cluster):
-    return Sentinel([('foo', 26379), ('bar', 26379)])
+    return Sentinel([("foo", 26379), ("bar", 26379)])
 
 
 @pytest.mark.onlynoncluster
 def test_discover_master(sentinel, master_ip):
-    address = sentinel.discover_master('mymaster')
+    address = sentinel.discover_master("mymaster")
     assert address == (master_ip, 6379)
 
 
 @pytest.mark.onlynoncluster
 def test_discover_master_error(sentinel):
     with pytest.raises(MasterNotFoundError):
-        sentinel.discover_master('xxx')
+        sentinel.discover_master("xxx")
 
 
 @pytest.mark.onlynoncluster
 def test_discover_master_sentinel_down(cluster, sentinel, master_ip):
     # Put first sentinel 'foo' down
-    cluster.nodes_down.add(('foo', 26379))
-    address = sentinel.discover_master('mymaster')
+    cluster.nodes_down.add(("foo", 26379))
+    address = sentinel.discover_master("mymaster")
     assert address == (master_ip, 6379)
     # 'bar' is now first sentinel
-    assert sentinel.sentinels[0].id == ('bar', 26379)
+    assert sentinel.sentinels[0].id == ("bar", 26379)
 
 
 @pytest.mark.onlynoncluster
 def test_discover_master_sentinel_timeout(cluster, sentinel, master_ip):
     # Put first sentinel 'foo' down
-    cluster.nodes_timeout.add(('foo', 26379))
-    address = sentinel.discover_master('mymaster')
+    cluster.nodes_timeout.add(("foo", 26379))
+    address = sentinel.discover_master("mymaster")
     assert address == (master_ip, 6379)
     # 'bar' is now first sentinel
-    assert sentinel.sentinels[0].id == ('bar', 26379)
+    assert sentinel.sentinels[0].id == ("bar", 26379)
 
 
 @pytest.mark.onlynoncluster
 def test_master_min_other_sentinels(cluster, master_ip):
-    sentinel = Sentinel([('foo', 26379)], min_other_sentinels=1)
+    sentinel = Sentinel([("foo", 26379)], min_other_sentinels=1)
     # min_other_sentinels
     with pytest.raises(MasterNotFoundError):
-        sentinel.discover_master('mymaster')
-    cluster.master['num-other-sentinels'] = 2
-    address = sentinel.discover_master('mymaster')
+        sentinel.discover_master("mymaster")
+    cluster.master["num-other-sentinels"] = 2
+    address = sentinel.discover_master("mymaster")
     assert address == (master_ip, 6379)
 
 
 @pytest.mark.onlynoncluster
 def test_master_odown(cluster, sentinel):
-    cluster.master['is_odown'] = True
+    cluster.master["is_odown"] = True
     with pytest.raises(MasterNotFoundError):
-        sentinel.discover_master('mymaster')
+        sentinel.discover_master("mymaster")
 
 
 @pytest.mark.onlynoncluster
 def test_master_sdown(cluster, sentinel):
-    cluster.master['is_sdown'] = True
+    cluster.master["is_sdown"] = True
     with pytest.raises(MasterNotFoundError):
-        sentinel.discover_master('mymaster')
+        sentinel.discover_master("mymaster")
 
 
 @pytest.mark.onlynoncluster
 def test_discover_slaves(cluster, sentinel):
-    assert sentinel.discover_slaves('mymaster') == []
+    assert sentinel.discover_slaves("mymaster") == []
 
     cluster.slaves = [
-        {'ip': 'slave0', 'port': 1234, 'is_odown': False, 'is_sdown': False},
-        {'ip': 'slave1', 'port': 1234, 'is_odown': False, 'is_sdown': False},
+        {"ip": "slave0", "port": 1234, "is_odown": False, "is_sdown": False},
+        {"ip": "slave1", "port": 1234, "is_odown": False, "is_sdown": False},
     ]
-    assert sentinel.discover_slaves('mymaster') == [
-        ('slave0', 1234), ('slave1', 1234)]
+    assert sentinel.discover_slaves("mymaster") == [("slave0", 1234), ("slave1", 1234)]
 
     # slave0 -> ODOWN
-    cluster.slaves[0]['is_odown'] = True
-    assert sentinel.discover_slaves('mymaster') == [
-        ('slave1', 1234)]
+    cluster.slaves[0]["is_odown"] = True
+    assert sentinel.discover_slaves("mymaster") == [("slave1", 1234)]
 
     # slave1 -> SDOWN
-    cluster.slaves[1]['is_sdown'] = True
-    assert sentinel.discover_slaves('mymaster') == []
+    cluster.slaves[1]["is_sdown"] = True
+    assert sentinel.discover_slaves("mymaster") == []
 
-    cluster.slaves[0]['is_odown'] = False
-    cluster.slaves[1]['is_sdown'] = False
+    cluster.slaves[0]["is_odown"] = False
+    cluster.slaves[1]["is_sdown"] = False
 
     # node0 -> DOWN
-    cluster.nodes_down.add(('foo', 26379))
-    assert sentinel.discover_slaves('mymaster') == [
-        ('slave0', 1234), ('slave1', 1234)]
+    cluster.nodes_down.add(("foo", 26379))
+    assert sentinel.discover_slaves("mymaster") == [("slave0", 1234), ("slave1", 1234)]
     cluster.nodes_down.clear()
 
     # node0 -> TIMEOUT
-    cluster.nodes_timeout.add(('foo', 26379))
-    assert sentinel.discover_slaves('mymaster') == [
-        ('slave0', 1234), ('slave1', 1234)]
+    cluster.nodes_timeout.add(("foo", 26379))
+    assert sentinel.discover_slaves("mymaster") == [("slave0", 1234), ("slave1", 1234)]
 
 
 @pytest.mark.onlynoncluster
 def test_master_for(cluster, sentinel, master_ip):
-    master = sentinel.master_for('mymaster', db=9)
+    master = sentinel.master_for("mymaster", db=9)
     assert master.ping()
     assert master.connection_pool.master_address == (master_ip, 6379)
 
     # Use internal connection check
-    master = sentinel.master_for('mymaster', db=9, check_connection=True)
+    master = sentinel.master_for("mymaster", db=9, check_connection=True)
     assert master.ping()
 
 
 @pytest.mark.onlynoncluster
 def test_slave_for(cluster, sentinel):
     cluster.slaves = [
-        {'ip': '127.0.0.1', 'port': 6379,
-         'is_odown': False, 'is_sdown': False},
+        {"ip": "127.0.0.1", "port": 6379, "is_odown": False, "is_sdown": False},
     ]
-    slave = sentinel.slave_for('mymaster', db=9)
+    slave = sentinel.slave_for("mymaster", db=9)
     assert slave.ping()
 
 
 @pytest.mark.onlynoncluster
 def test_slave_for_slave_not_found_error(cluster, sentinel):
-    cluster.master['is_odown'] = True
-    slave = sentinel.slave_for('mymaster', db=9)
+    cluster.master["is_odown"] = True
+    slave = sentinel.slave_for("mymaster", db=9)
     with pytest.raises(SlaveNotFoundError):
         slave.ping()
 
@@ -205,13 +205,13 @@ def test_slave_for_slave_not_found_error(cluster, sentinel):
 @pytest.mark.onlynoncluster
 def test_slave_round_robin(cluster, sentinel, master_ip):
     cluster.slaves = [
-        {'ip': 'slave0', 'port': 6379, 'is_odown': False, 'is_sdown': False},
-        {'ip': 'slave1', 'port': 6379, 'is_odown': False, 'is_sdown': False},
+        {"ip": "slave0", "port": 6379, "is_odown": False, "is_sdown": False},
+        {"ip": "slave1", "port": 6379, "is_odown": False, "is_sdown": False},
     ]
-    pool = SentinelConnectionPool('mymaster', sentinel)
+    pool = SentinelConnectionPool("mymaster", sentinel)
     rotator = pool.rotate_slaves()
-    assert next(rotator) in (('slave0', 6379), ('slave1', 6379))
-    assert next(rotator) in (('slave0', 6379), ('slave1', 6379))
+    assert next(rotator) in (("slave0", 6379), ("slave1", 6379))
+    assert next(rotator) in (("slave0", 6379), ("slave1", 6379))
     # Fallback to master
     assert next(rotator) == (master_ip, 6379)
     with pytest.raises(SlaveNotFoundError):
@@ -230,5 +230,5 @@ def test_flushconfig(cluster, sentinel):
 
 @pytest.mark.onlynoncluster
 def test_reset(cluster, sentinel):
-    cluster.master['is_odown'] = True
-    assert sentinel.sentinel_reset('mymaster')
+    cluster.master["is_odown"] = True
+    assert sentinel.sentinel_reset("mymaster")
diff --git a/tests/test_timeseries.py b/tests/test_timeseries.py
index 07433574f1..8c97ab804d 100644
--- a/tests/test_timeseries.py
+++ b/tests/test_timeseries.py
@@ -1,6 +1,8 @@
-import pytest
 import time
 from time import sleep
+
+import pytest
+
 from .conftest import skip_ifmodversion_lt
 
 
@@ -68,8 +70,7 @@ def test_add(client):
     assert 4 == client.ts().add(
         4, 4, 2, retention_msecs=10, labels={"Redis": "Labs", "Time": "Series"}
     )
-    assert round(time.time()) == \
-        round(float(client.ts().add(5, "*", 1)) / 1000)
+    assert round(time.time()) == round(float(client.ts().add(5, "*", 1)) / 1000)
 
     info = client.ts().info(4)
     assert 10 == info.retention_msecs
@@ -88,12 +89,7 @@ def test_add_duplicate_policy(client):
     # Test for duplicate policy BLOCK
     assert 1 == client.ts().add("time-serie-add-ooo-block", 1, 5.0)
     with pytest.raises(Exception):
-        client.ts().add(
-            "time-serie-add-ooo-block",
-            1,
-            5.0,
-            duplicate_policy="block"
-        )
+        client.ts().add("time-serie-add-ooo-block", 1, 5.0, duplicate_policy="block")
 
     # Test for duplicate policy LAST
     assert 1 == client.ts().add("time-serie-add-ooo-last", 1, 5.0)
@@ -127,8 +123,7 @@ def test_add_duplicate_policy(client):
 @pytest.mark.redismod
 def test_madd(client):
     client.ts().create("a")
-    assert [1, 2, 3] == \
-        client.ts().madd([("a", 1, 5), ("a", 2, 10), ("a", 3, 15)])
+    assert [1, 2, 3] == client.ts().madd([("a", 1, 5), ("a", 2, 10), ("a", 3, 15)])
 
 
 @pytest.mark.redismod
@@ -206,13 +201,7 @@ def test_range(client):
     assert 200 == len(client.ts().range(1, 0, 500))
     # last sample isn't returned
     assert 20 == len(
-        client.ts().range(
-            1,
-            0,
-            500,
-            aggregation_type="avg",
-            bucket_size_msec=10
-        )
+        client.ts().range(1, 0, 500, aggregation_type="avg", bucket_size_msec=10)
     )
     assert 10 == len(client.ts().range(1, 0, 500, count=10))
 
@@ -253,13 +242,7 @@ def test_rev_range(client):
     assert 200 == len(client.ts().range(1, 0, 500))
     # first sample isn't returned
     assert 20 == len(
-        client.ts().revrange(
-            1,
-            0,
-            500,
-            aggregation_type="avg",
-            bucket_size_msec=10
-        )
+        client.ts().revrange(1, 0, 500, aggregation_type="avg", bucket_size_msec=10)
     )
     assert 10 == len(client.ts().revrange(1, 0, 500, count=10))
     assert 2 == len(
@@ -283,10 +266,7 @@ def test_rev_range(client):
 @pytest.mark.redismod
 def testMultiRange(client):
     client.ts().create(1, labels={"Test": "This", "team": "ny"})
-    client.ts().create(
-        2,
-        labels={"Test": "This", "Taste": "That", "team": "sf"}
-    )
+    client.ts().create(2, labels={"Test": "This", "Taste": "That", "team": "sf"})
     for i in range(100):
         client.ts().add(1, i, i % 7)
         client.ts().add(2, i, i % 11)
@@ -301,11 +281,7 @@ def testMultiRange(client):
     for i in range(100):
         client.ts().add(1, i + 200, i % 7)
     res = client.ts().mrange(
-        0,
-        500,
-        filters=["Test=This"],
-        aggregation_type="avg",
-        bucket_size_msec=10
+        0, 500, filters=["Test=This"], aggregation_type="avg", bucket_size_msec=10
     )
     assert 2 == len(res)
     assert 20 == len(res[0]["1"][1])
@@ -320,21 +296,13 @@ def testMultiRange(client):
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 def test_multi_range_advanced(client):
     client.ts().create(1, labels={"Test": "This", "team": "ny"})
-    client.ts().create(
-        2,
-        labels={"Test": "This", "Taste": "That", "team": "sf"}
-    )
+    client.ts().create(2, labels={"Test": "This", "Taste": "That", "team": "sf"})
     for i in range(100):
         client.ts().add(1, i, i % 7)
         client.ts().add(2, i, i % 11)
 
     # test with selected labels
-    res = client.ts().mrange(
-        0,
-        200,
-        filters=["Test=This"],
-        select_labels=["team"]
-    )
+    res = client.ts().mrange(0, 200, filters=["Test=This"], select_labels=["team"])
     assert {"team": "ny"} == res[0]["1"][0]
     assert {"team": "sf"} == res[1]["2"][0]
 
@@ -350,28 +318,11 @@ def test_multi_range_advanced(client):
     assert [(15, 1.0), (16, 2.0)] == res[0]["1"][1]
 
     # test groupby
-    res = client.ts().mrange(
-        0,
-        3,
-        filters=["Test=This"],
-        groupby="Test",
-        reduce="sum"
-    )
+    res = client.ts().mrange(0, 3, filters=["Test=This"], groupby="Test", reduce="sum")
     assert [(0, 0.0), (1, 2.0), (2, 4.0), (3, 6.0)] == res[0]["Test=This"][1]
-    res = client.ts().mrange(
-        0,
-        3,
-        filters=["Test=This"],
-        groupby="Test",
-        reduce="max"
-    )
+    res = client.ts().mrange(0, 3, filters=["Test=This"], groupby="Test", reduce="max")
     assert [(0, 0.0), (1, 1.0), (2, 2.0), (3, 3.0)] == res[0]["Test=This"][1]
-    res = client.ts().mrange(
-        0,
-        3,
-        filters=["Test=This"],
-        groupby="team",
-        reduce="min")
+    res = client.ts().mrange(0, 3, filters=["Test=This"], groupby="team", reduce="min")
     assert 2 == len(res)
     assert [(0, 0.0), (1, 1.0), (2, 2.0), (3, 3.0)] == res[0]["team=ny"][1]
     assert [(0, 0.0), (1, 1.0), (2, 2.0), (3, 3.0)] == res[1]["team=sf"][1]
@@ -401,10 +352,7 @@ def test_multi_range_advanced(client):
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 def test_multi_reverse_range(client):
     client.ts().create(1, labels={"Test": "This", "team": "ny"})
-    client.ts().create(
-        2,
-        labels={"Test": "This", "Taste": "That", "team": "sf"}
-    )
+    client.ts().create(2, labels={"Test": "This", "Taste": "That", "team": "sf"})
     for i in range(100):
         client.ts().add(1, i, i % 7)
         client.ts().add(2, i, i % 11)
@@ -419,31 +367,18 @@ def test_multi_reverse_range(client):
     for i in range(100):
         client.ts().add(1, i + 200, i % 7)
     res = client.ts().mrevrange(
-        0,
-        500,
-        filters=["Test=This"],
-        aggregation_type="avg",
-        bucket_size_msec=10
+        0, 500, filters=["Test=This"], aggregation_type="avg", bucket_size_msec=10
     )
     assert 2 == len(res)
     assert 20 == len(res[0]["1"][1])
     assert {} == res[0]["1"][0]
 
     # test withlabels
-    res = client.ts().mrevrange(
-        0,
-        200,
-        filters=["Test=This"],
-        with_labels=True
-    )
+    res = client.ts().mrevrange(0, 200, filters=["Test=This"], with_labels=True)
     assert {"Test": "This", "team": "ny"} == res[0]["1"][0]
 
     # test with selected labels
-    res = client.ts().mrevrange(
-        0,
-        200,
-        filters=["Test=This"], select_labels=["team"]
-    )
+    res = client.ts().mrevrange(0, 200, filters=["Test=This"], select_labels=["team"])
     assert {"team": "ny"} == res[0]["1"][0]
     assert {"team": "sf"} == res[1]["2"][0]
 
@@ -529,11 +464,7 @@ def test_mget(client):
 
 @pytest.mark.redismod
 def test_info(client):
-    client.ts().create(
-        1,
-        retention_msecs=5,
-        labels={"currentLabel": "currentData"}
-    )
+    client.ts().create(1, retention_msecs=5, labels={"currentLabel": "currentData"})
     info = client.ts().info(1)
     assert 5 == info.retention_msecs
     assert info.labels["currentLabel"] == "currentData"
@@ -542,11 +473,7 @@ def test_info(client):
 @pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
 def testInfoDuplicatePolicy(client):
-    client.ts().create(
-        1,
-        retention_msecs=5,
-        labels={"currentLabel": "currentData"}
-    )
+    client.ts().create(1, retention_msecs=5, labels={"currentLabel": "currentData"})
     info = client.ts().info(1)
     assert info.duplicate_policy is None
 
diff --git a/tox.ini b/tox.ini
index f710bbaca8..9d78e2a028 100644
--- a/tox.ini
+++ b/tox.ini
@@ -90,6 +90,9 @@ healtcheck_cmd = python -c "import socket;print(True) if all([0 == socket.socket
 volumes =
     bind:rw:{toxinidir}/docker/cluster/redis.conf:/redis.conf
 
+[isort]
+profile = black
+multi_line_output = 3
 
 [testenv]
 deps =
@@ -130,7 +133,9 @@ commands = /usr/bin/echo
 deps_files = dev_requirements.txt
 docker =
 commands =
-    flake8 --max-line-length=88
+    flake8
+    black --target-version py36 --check --diff .
+    isort --check-only --diff .
     vulture redis whitelist.py --min-confidence 80
     flynt --fail-on-change --dry-run .
 skipsdist = true
@@ -150,6 +155,7 @@ allowlist_externals = make
 commands = make html
 
 [flake8]
+max-line-length = 88
 exclude =
     *.egg-info,
     *.pyc,
@@ -162,3 +168,7 @@ exclude =
     docker,
     venv*,
     whitelist.py
+ignore =
+    W503
+    E203
+    E126

From 175a05f4de17918b74bde7f554182968b1f6aabb Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Tue, 30 Nov 2021 17:47:25 +0100
Subject: [PATCH 0280/1164] Adding RedisGraph support (#1673)

Co-authored-by: Chayim I. Kirshen <c@kirshen.com>
---
 redis/commands/graph/__init__.py     | 162 +++++++++
 redis/commands/graph/commands.py     | 200 +++++++++++
 redis/commands/graph/edge.py         |  87 +++++
 redis/commands/graph/exceptions.py   |   3 +
 redis/commands/graph/node.py         |  84 +++++
 redis/commands/graph/path.py         |  74 +++++
 redis/commands/graph/query_result.py | 362 ++++++++++++++++++++
 redis/commands/helpers.py            |  38 +++
 redis/commands/redismodules.py       |  10 +
 setup.py                             |   1 +
 tests/test_graph.py                  | 477 +++++++++++++++++++++++++++
 tests/test_graph_utils/__init__.py   |   0
 tests/test_graph_utils/test_edge.py  |  77 +++++
 tests/test_graph_utils/test_node.py  |  52 +++
 tests/test_graph_utils/test_path.py  |  91 +++++
 tox.ini                              |   3 +-
 16 files changed, 1720 insertions(+), 1 deletion(-)
 create mode 100644 redis/commands/graph/__init__.py
 create mode 100644 redis/commands/graph/commands.py
 create mode 100644 redis/commands/graph/edge.py
 create mode 100644 redis/commands/graph/exceptions.py
 create mode 100644 redis/commands/graph/node.py
 create mode 100644 redis/commands/graph/path.py
 create mode 100644 redis/commands/graph/query_result.py
 create mode 100644 tests/test_graph.py
 create mode 100644 tests/test_graph_utils/__init__.py
 create mode 100644 tests/test_graph_utils/test_edge.py
 create mode 100644 tests/test_graph_utils/test_node.py
 create mode 100644 tests/test_graph_utils/test_path.py

diff --git a/redis/commands/graph/__init__.py b/redis/commands/graph/__init__.py
new file mode 100644
index 0000000000..7b9972ad9b
--- /dev/null
+++ b/redis/commands/graph/__init__.py
@@ -0,0 +1,162 @@
+from ..helpers import quote_string, random_string, stringify_param_value
+from .commands import GraphCommands
+from .edge import Edge  # noqa
+from .node import Node  # noqa
+from .path import Path  # noqa
+
+
+class Graph(GraphCommands):
+    """
+    Graph, collection of nodes and edges.
+    """
+
+    def __init__(self, client, name=random_string()):
+        """
+        Create a new graph.
+        """
+        self.NAME = name  # Graph key
+        self.client = client
+        self.execute_command = client.execute_command
+
+        self.nodes = {}
+        self.edges = []
+        self._labels = []  # List of node labels.
+        self._properties = []  # List of properties.
+        self._relationshipTypes = []  # List of relation types.
+        self.version = 0  # Graph version
+
+    @property
+    def name(self):
+        return self.NAME
+
+    def _clear_schema(self):
+        self._labels = []
+        self._properties = []
+        self._relationshipTypes = []
+
+    def _refresh_schema(self):
+        self._clear_schema()
+        self._refresh_labels()
+        self._refresh_relations()
+        self._refresh_attributes()
+
+    def _refresh_labels(self):
+        lbls = self.labels()
+
+        # Unpack data.
+        self._labels = [None] * len(lbls)
+        for i, l in enumerate(lbls):
+            self._labels[i] = l[0]
+
+    def _refresh_relations(self):
+        rels = self.relationshipTypes()
+
+        # Unpack data.
+        self._relationshipTypes = [None] * len(rels)
+        for i, r in enumerate(rels):
+            self._relationshipTypes[i] = r[0]
+
+    def _refresh_attributes(self):
+        props = self.propertyKeys()
+
+        # Unpack data.
+        self._properties = [None] * len(props)
+        for i, p in enumerate(props):
+            self._properties[i] = p[0]
+
+    def get_label(self, idx):
+        """
+        Returns a label by it's index
+
+        Args:
+
+        idx:
+            The index of the label
+        """
+        try:
+            label = self._labels[idx]
+        except IndexError:
+            # Refresh labels.
+            self._refresh_labels()
+            label = self._labels[idx]
+        return label
+
+    def get_relation(self, idx):
+        """
+        Returns a relationship type by it's index
+
+        Args:
+
+        idx:
+            The index of the relation
+        """
+        try:
+            relationship_type = self._relationshipTypes[idx]
+        except IndexError:
+            # Refresh relationship types.
+            self._refresh_relations()
+            relationship_type = self._relationshipTypes[idx]
+        return relationship_type
+
+    def get_property(self, idx):
+        """
+        Returns a property by it's index
+
+        Args:
+
+        idx:
+            The index of the property
+        """
+        try:
+            propertie = self._properties[idx]
+        except IndexError:
+            # Refresh properties.
+            self._refresh_attributes()
+            propertie = self._properties[idx]
+        return propertie
+
+    def add_node(self, node):
+        """
+        Adds a node to the graph.
+        """
+        if node.alias is None:
+            node.alias = random_string()
+        self.nodes[node.alias] = node
+
+    def add_edge(self, edge):
+        """
+        Adds an edge to the graph.
+        """
+        if not (self.nodes[edge.src_node.alias] and self.nodes[edge.dest_node.alias]):
+            raise AssertionError("Both edge's end must be in the graph")
+
+        self.edges.append(edge)
+
+    def _build_params_header(self, params):
+        if not isinstance(params, dict):
+            raise TypeError("'params' must be a dict")
+        # Header starts with "CYPHER"
+        params_header = "CYPHER "
+        for key, value in params.items():
+            params_header += str(key) + "=" + stringify_param_value(value) + " "
+        return params_header
+
+    # Procedures.
+    def call_procedure(self, procedure, *args, read_only=False, **kwagrs):
+        args = [quote_string(arg) for arg in args]
+        q = f"CALL {procedure}({','.join(args)})"
+
+        y = kwagrs.get("y", None)
+        if y:
+            q += f" YIELD {','.join(y)}"
+
+        return self.query(q, read_only=read_only)
+
+    def labels(self):
+        return self.call_procedure("db.labels", read_only=True).result_set
+
+    def relationshipTypes(self):
+        return self.call_procedure("db.relationshipTypes", read_only=True).result_set
+
+    def propertyKeys(self):
+        return self.call_procedure("db.propertyKeys", read_only=True).result_set
diff --git a/redis/commands/graph/commands.py b/redis/commands/graph/commands.py
new file mode 100644
index 0000000000..f0c1d687ed
--- /dev/null
+++ b/redis/commands/graph/commands.py
@@ -0,0 +1,200 @@
+from redis import DataError
+from redis.exceptions import ResponseError
+
+from .exceptions import VersionMismatchException
+from .query_result import QueryResult
+
+
+class GraphCommands:
+    def commit(self):
+        """
+        Create entire graph.
+        For more information see `CREATE <https://oss.redis.com/redisgraph/master/commands/#create>`_. # noqa
+        """
+        if len(self.nodes) == 0 and len(self.edges) == 0:
+            return None
+
+        query = "CREATE "
+        for _, node in self.nodes.items():
+            query += str(node) + ","
+
+        query += ",".join([str(edge) for edge in self.edges])
+
+        # Discard leading comma.
+        if query[-1] == ",":
+            query = query[:-1]
+
+        return self.query(query)
+
+    def query(self, q, params=None, timeout=None, read_only=False, profile=False):
+        """
+        Executes a query against the graph.
+        For more information see `GRAPH.QUERY <https://oss.redis.com/redisgraph/master/commands/#graphquery>`_. # noqa
+
+        Args:
+
+        -------
+        q :
+            The query.
+        params : dict
+            Query parameters.
+        timeout : int
+            Maximum runtime for read queries in milliseconds.
+        read_only : bool
+            Executes a readonly query if set to True.
+        profile : bool
+            Return details on results produced by and time
+            spent in each operation.
+        """
+
+        # maintain original 'q'
+        query = q
+
+        # handle query parameters
+        if params is not None:
+            query = self._build_params_header(params) + query
+
+        # construct query command
+        # ask for compact result-set format
+        # specify known graph version
+        if profile:
+            cmd = "GRAPH.PROFILE"
+        else:
+            cmd = "GRAPH.RO_QUERY" if read_only else "GRAPH.QUERY"
+        command = [cmd, self.name, query, "--compact"]
+
+        # include timeout is specified
+        if timeout:
+            if not isinstance(timeout, int):
+                raise Exception("Timeout argument must be a positive integer")
+            command += ["timeout", timeout]
+
+        # issue query
+        try:
+            response = self.execute_command(*command)
+            return QueryResult(self, response, profile)
+        except ResponseError as e:
+            if "wrong number of arguments" in str(e):
+                print(
+                    "Note: RedisGraph Python requires server version 2.2.8 or above"
+                )  # noqa
+            if "unknown command" in str(e) and read_only:
+                # `GRAPH.RO_QUERY` is unavailable in older versions.
+                return self.query(q, params, timeout, read_only=False)
+            raise e
+        except VersionMismatchException as e:
+            # client view over the graph schema is out of sync
+            # set client version and refresh local schema
+            self.version = e.version
+            self._refresh_schema()
+            # re-issue query
+            return self.query(q, params, timeout, read_only)
+
+    def merge(self, pattern):
+        """
+        Merge pattern.
+        For more information see `MERGE <https://oss.redis.com/redisgraph/master/commands/#merge>`_. # noqa
+        """
+        query = "MERGE "
+        query += str(pattern)
+
+        return self.query(query)
+
+    def delete(self):
+        """
+        Deletes graph.
+        For more information see `DELETE <https://oss.redis.com/redisgraph/master/commands/#delete>`_. # noqa
+        """
+        self._clear_schema()
+        return self.execute_command("GRAPH.DELETE", self.name)
+
+    # declared here, to override the built in redis.db.flush()
+    def flush(self):
+        """
+        Commit the graph and reset the edges and the nodes to zero length.
+        """
+        self.commit()
+        self.nodes = {}
+        self.edges = []
+
+    def explain(self, query, params=None):
+        """
+        Get the execution plan for given query,
+        Returns an array of operations.
+        For more information see `GRAPH.EXPLAIN <https://oss.redis.com/redisgraph/master/commands/#graphexplain>`_. # noqa
+
+        Args:
+
+        -------
+        query:
+            The query that will be executed.
+        params: dict
+            Query parameters.
+        """
+        if params is not None:
+            query = self._build_params_header(params) + query
+
+        plan = self.execute_command("GRAPH.EXPLAIN", self.name, query)
+        return "\n".join(plan)
+
+    def bulk(self, **kwargs):
+        """Internal only. Not supported."""
+        raise NotImplementedError(
+            "GRAPH.BULK is internal only. "
+            "Use https://github.com/redisgraph/redisgraph-bulk-loader."
+        )
+
+    def profile(self, query):
+        """
+        Execute a query and produce an execution plan augmented with metrics
+        for each operation's execution. Return a string representation of a
+        query execution plan, with details on results produced by and time
+        spent in each operation.
+        For more information see `GRAPH.PROFILE <https://oss.redis.com/redisgraph/master/commands/#graphprofile>`_. # noqa
+        """
+        return self.query(query, profile=True)
+
+    def slowlog(self):
+        """
+        Get a list containing up to 10 of the slowest queries issued
+        against the given graph ID.
+        For more information see `GRAPH.SLOWLOG <https://oss.redis.com/redisgraph/master/commands/#graphslowlog>`_. # noqa
+
+        Each item in the list has the following structure:
+        1. A unix timestamp at which the log entry was processed.
+        2. The issued command.
+        3. The issued query.
+        4. The amount of time needed for its execution, in milliseconds.
+        """
+        return self.execute_command("GRAPH.SLOWLOG", self.name)
+
+    def config(self, name, value=None, set=False):
+        """
+        Retrieve or update a RedisGraph configuration.
+        For more information see `GRAPH.CONFIG <https://oss.redis.com/redisgraph/master/commands/#graphconfig>`_. # noqa
+
+        Args:
+
+        name : str
+            The name of the configuration
+        value :
+            The value we want to ser (can be used only when `set` is on)
+        set : bool
+            Turn on to set a configuration. Default behavior is get.
+        """
+        params = ["SET" if set else "GET", name]
+        if value is not None:
+            if set:
+                params.append(value)
+            else:
+                raise DataError(
+                    "``value`` can be provided only when ``set`` is True"
+                )  # noqa
+        return self.execute_command("GRAPH.CONFIG", *params)
+
+    def list_keys(self):
+        """
+        Lists all graph keys in the keyspace.
+        For more information see `GRAPH.LIST <https://oss.redis.com/redisgraph/master/commands/#graphlist>`_. # noqa
+        """
+        return self.execute_command("GRAPH.LIST")
diff --git a/redis/commands/graph/edge.py b/redis/commands/graph/edge.py
new file mode 100644
index 0000000000..b334293fb2
--- /dev/null
+++ b/redis/commands/graph/edge.py
@@ -0,0 +1,87 @@
+from ..helpers import quote_string
+from .node import Node
+
+
+class Edge:
+    """
+    An edge connecting two nodes.
+    """
+
+    def __init__(self, src_node, relation, dest_node, edge_id=None, properties=None):
+        """
+        Create a new edge.
+        """
+        if src_node is None or dest_node is None:
+            # NOTE(bors-42): It makes sense to change AssertionError to
+            #                ValueError here
+            raise AssertionError("Both src_node & dest_node must be provided")
+
+        self.id = edge_id
+        self.relation = relation or ""
+        self.properties = properties or {}
+        self.src_node = src_node
+        self.dest_node = dest_node
+
+    def toString(self):
+        res = ""
+        if self.properties:
+            props = ",".join(
+                key + ":" + str(quote_string(val))
+                for key, val in sorted(self.properties.items())
+            )
+            res += "{" + props + "}"
+
+        return res
+
+    def __str__(self):
+        # Source node.
+        if isinstance(self.src_node, Node):
+            res = str(self.src_node)
+        else:
+            res = "()"
+
+        # Edge
+        res += "-["
+        if self.relation:
+            res += ":" + self.relation
+        if self.properties:
+            props = ",".join(
+                key + ":" + str(quote_string(val))
+                for key, val in sorted(self.properties.items())
+            )
+            res += "{" + props + "}"
+        res += "]->"
+
+        # Dest node.
+        if isinstance(self.dest_node, Node):
+            res += str(self.dest_node)
+        else:
+            res += "()"
+
+        return res
+
+    def __eq__(self, rhs):
+        # Quick positive check, if both IDs are set.
+        if self.id is not None and rhs.id is not None and self.id == rhs.id:
+            return True
+
+        # Source and destination nodes should match.
+        if self.src_node != rhs.src_node:
+            return False
+
+        if self.dest_node != rhs.dest_node:
+            return False
+
+        # Relation should match.
+        if self.relation != rhs.relation:
+            return False
+
+        # Quick check for number of properties.
+        if len(self.properties) != len(rhs.properties):
+            return False
+
+        # Compare properties.
+        if self.properties != rhs.properties:
+            return False
+
+        return True
diff --git a/redis/commands/graph/exceptions.py b/redis/commands/graph/exceptions.py
new file mode 100644
index 0000000000..4bbac1008e
--- /dev/null
+++ b/redis/commands/graph/exceptions.py
@@ -0,0 +1,3 @@
+class VersionMismatchException(Exception):
+    def __init__(self, version):
+        self.version = version
diff --git a/redis/commands/graph/node.py b/redis/commands/graph/node.py
new file mode 100644
index 0000000000..47e4eeb8e2
--- /dev/null
+++ b/redis/commands/graph/node.py
@@ -0,0 +1,84 @@
+from ..helpers import quote_string
+
+
+class Node:
+    """
+    A node within the graph.
+    """
+
+    def __init__(self, node_id=None, alias=None, label=None, properties=None):
+        """
+        Create a new node.
+        """
+        self.id = node_id
+        self.alias = alias
+        if isinstance(label, list):
+            label = [inner_label for inner_label in label if inner_label != ""]
+
+        if (
+            label is None
+            or label == ""
+            or (isinstance(label, list) and len(label) == 0)
+        ):
+            self.label = None
+            self.labels = None
+        elif isinstance(label, str):
+            self.label = label
+            self.labels = [label]
+        elif isinstance(label, list) and all(
+            [isinstance(inner_label, str) for inner_label in label]
+        ):
+            self.label = label[0]
+            self.labels = label
+        else:
+            raise AssertionError(
+                "label should be either None, " "string or a list of strings"
+            )
+
+        self.properties = properties or {}
+
+    def toString(self):
+        res = ""
+        if self.properties:
+            props = ",".join(
+                key + ":" + str(quote_string(val))
+                for key, val in sorted(self.properties.items())
+            )
+            res += "{" + props + "}"
+
+        return res
+
+    def __str__(self):
+        res = "("
+        if self.alias:
+            res += self.alias
+        if self.labels:
+            res += ":" + ":".join(self.labels)
+        if self.properties:
+            props = ",".join(
+                key + ":" + str(quote_string(val))
+                for key, val in sorted(self.properties.items())
+            )
+            res += "{" + props + "}"
+        res += ")"
+
+        return res
+
+    def __eq__(self, rhs):
+        # Quick positive check, if both IDs are set.
+        if self.id is not None and rhs.id is not None and self.id != rhs.id:
+            return False
+
+        # Label should match.
+        if self.label != rhs.label:
+            return False
+
+        # Quick check for number of properties.
+        if len(self.properties) != len(rhs.properties):
+            return False
+
+        # Compare properties.
+        if self.properties != rhs.properties:
+            return False
+
+        return True
diff --git a/redis/commands/graph/path.py b/redis/commands/graph/path.py
new file mode 100644
index 0000000000..6f2214a3b5
--- /dev/null
+++ b/redis/commands/graph/path.py
@@ -0,0 +1,74 @@
+from .edge import Edge
+from .node import Node
+
+
+class Path:
+    def __init__(self, nodes, edges):
+        if not (isinstance(nodes, list) and isinstance(edges, list)):
+            raise TypeError("nodes and edges must be list")
+
+        self._nodes = nodes
+        self._edges = edges
+        self.append_type = Node
+
+    @classmethod
+    def new_empty_path(cls):
+        return cls([], [])
+
+    def nodes(self):
+        return self._nodes
+
+    def edges(self):
+        return self._edges
+
+    def get_node(self, index):
+        return self._nodes[index]
+
+    def get_relationship(self, index):
+        return self._edges[index]
+
+    def first_node(self):
+        return self._nodes[0]
+
+    def last_node(self):
+        return self._nodes[-1]
+
+    def edge_count(self):
+        return len(self._edges)
+
+    def nodes_count(self):
+        return len(self._nodes)
+
+    def add_node(self, node):
+        if not isinstance(node, self.append_type):
+            raise AssertionError("Add Edge before adding Node")
+        self._nodes.append(node)
+        self.append_type = Edge
+        return self
+
+    def add_edge(self, edge):
+        if not isinstance(edge, self.append_type):
+            raise AssertionError("Add Node before adding Edge")
+        self._edges.append(edge)
+        self.append_type = Node
+        return self
+
+    def __eq__(self, other):
+        return self.nodes() == other.nodes() and self.edges() == other.edges()
+
+    def __str__(self):
+        res = "<"
+        edge_count = self.edge_count()
+        for i in range(0, edge_count):
+            node_id = self.get_node(i).id
+            res += "(" + str(node_id) + ")"
+            edge = self.get_relationship(i)
+            res += (
+                "-[" + str(int(edge.id)) + "]->"
+                if edge.src_node == node_id
+                else "<-[" + str(int(edge.id)) + "]-"
+            )
+        node_id = self.get_node(edge_count).id
+        res += "(" + str(node_id) + ")"
+        res += ">"
+        return res
diff --git a/redis/commands/graph/query_result.py b/redis/commands/graph/query_result.py
new file mode 100644
index 0000000000..e9d9f4d3fd
--- /dev/null
+++ b/redis/commands/graph/query_result.py
@@ -0,0 +1,362 @@
+from collections import OrderedDict
+
+# from prettytable import PrettyTable
+from redis import ResponseError
+
+from .edge import Edge
+from .exceptions import VersionMismatchException
+from .node import Node
+from .path import Path
+
+LABELS_ADDED = "Labels added"
+NODES_CREATED = "Nodes created"
+NODES_DELETED = "Nodes deleted"
+RELATIONSHIPS_DELETED = "Relationships deleted"
+PROPERTIES_SET = "Properties set"
+RELATIONSHIPS_CREATED = "Relationships created"
+INDICES_CREATED = "Indices created"
+INDICES_DELETED = "Indices deleted"
+CACHED_EXECUTION = "Cached execution"
+INTERNAL_EXECUTION_TIME = "internal execution time"
+
+STATS = [
+    LABELS_ADDED,
+    NODES_CREATED,
+    PROPERTIES_SET,
+    RELATIONSHIPS_CREATED,
+    NODES_DELETED,
+    RELATIONSHIPS_DELETED,
+    INDICES_CREATED,
+    INDICES_DELETED,
+    CACHED_EXECUTION,
+    INTERNAL_EXECUTION_TIME,
+]
+
+
+class ResultSetColumnTypes:
+    COLUMN_UNKNOWN = 0
+    COLUMN_SCALAR = 1
+    COLUMN_NODE = 2  # Unused as of RedisGraph v2.1.0, retained for backwards compatibility. # noqa
+    COLUMN_RELATION = 3  # Unused as of RedisGraph v2.1.0, retained for backwards compatibility. # noqa
+
+
+class ResultSetScalarTypes:
+    VALUE_UNKNOWN = 0
+    VALUE_NULL = 1
+    VALUE_STRING = 2
+    VALUE_INTEGER = 3
+    VALUE_BOOLEAN = 4
+    VALUE_DOUBLE = 5
+    VALUE_ARRAY = 6
+    VALUE_EDGE = 7
+    VALUE_NODE = 8
+    VALUE_PATH = 9
+    VALUE_MAP = 10
+    VALUE_POINT = 11
+
+
+class QueryResult:
+    def __init__(self, graph, response, profile=False):
+        """
+        A class that represents a result of the query operation.
+
+        Args:
+
+        graph:
+            The graph on which the query was executed.
+        response:
+            The response from the server.
+        profile:
+            A boolean indicating if the query command was "GRAPH.PROFILE"
+        """
+        self.graph = graph
+        self.header = []
+        self.result_set = []
+
+        # in case of an error an exception will be raised
+        self._check_for_errors(response)
+
+        if len(response) == 1:
+            self.parse_statistics(response[0])
+        elif profile:
+            self.parse_profile(response)
+        else:
+            # start by parsing statistics, matches the one we have
+            self.parse_statistics(response[-1])  # Last element.
+            self.parse_results(response)
+
+    def _check_for_errors(self, response):
+        if isinstance(response[0], ResponseError):
+            error = response[0]
+            if str(error) == "version mismatch":
+                version = response[1]
+                error = VersionMismatchException(version)
+            raise error
+
+        # If we encountered a run-time error, the last response
+        # element will be an exception
+        if isinstance(response[-1], ResponseError):
+            raise response[-1]
+
+    def parse_results(self, raw_result_set):
+        self.header = self.parse_header(raw_result_set)
+
+        # Empty header.
+        if len(self.header) == 0:
+            return
+
+        self.result_set = self.parse_records(raw_result_set)
+
+    def parse_statistics(self, raw_statistics):
+        self.statistics = {}
+
+        # decode statistics
+        for idx, stat in enumerate(raw_statistics):
+            if isinstance(stat, bytes):
+                raw_statistics[idx] = stat.decode()
+
+        for s in STATS:
+            v = self._get_value(s, raw_statistics)
+            if v is not None:
+                self.statistics[s] = v
+
+    def parse_header(self, raw_result_set):
+        # An array of column name/column type pairs.
+        header = raw_result_set[0]
+        return header
+
+    def parse_records(self, raw_result_set):
+        records = []
+        result_set = raw_result_set[1]
+        for row in result_set:
+            record = []
+            for idx, cell in enumerate(row):
+                if self.header[idx][0] == ResultSetColumnTypes.COLUMN_SCALAR:  # noqa
+                    record.append(self.parse_scalar(cell))
+                elif self.header[idx][0] == ResultSetColumnTypes.COLUMN_NODE:  # noqa
+                    record.append(self.parse_node(cell))
+                elif (
+                    self.header[idx][0] == ResultSetColumnTypes.COLUMN_RELATION
+                ):  # noqa
+                    record.append(self.parse_edge(cell))
+                else:
+                    print("Unknown column type.\n")
+            records.append(record)
+
+        return records
+
+    def parse_entity_properties(self, props):
+        # [[name, value type, value] X N]
+        properties = {}
+        for prop in props:
+            prop_name = self.graph.get_property(prop[0])
+            prop_value = self.parse_scalar(prop[1:])
+            properties[prop_name] = prop_value
+
+        return properties
+
+    def parse_string(self, cell):
+        if isinstance(cell, bytes):
+            return cell.decode()
+        elif not isinstance(cell, str):
+            return str(cell)
+        else:
+            return cell
+
+    def parse_node(self, cell):
+        # Node ID (integer),
+        # [label string offset (integer)],
+        # [[name, value type, value] X N]
+
+        node_id = int(cell[0])
+        labels = None
+        if len(cell[1]) > 0:
+            labels = []
+            for inner_label in cell[1]:
+                labels.append(self.graph.get_label(inner_label))
+        properties = self.parse_entity_properties(cell[2])
+        return Node(node_id=node_id, label=labels, properties=properties)
+
+    def parse_edge(self, cell):
+        # Edge ID (integer),
+        # reltype string offset (integer),
+        # src node ID offset (integer),
+        # dest node ID offset (integer),
+        # [[name, value, value type] X N]
+
+        edge_id = int(cell[0])
+        relation = self.graph.get_relation(cell[1])
+        src_node_id = int(cell[2])
+        dest_node_id = int(cell[3])
+        properties = self.parse_entity_properties(cell[4])
+        return Edge(
+            src_node_id, relation, dest_node_id, edge_id=edge_id, properties=properties
+        )
+
+    def parse_path(self, cell):
+        nodes = self.parse_scalar(cell[0])
+        edges = self.parse_scalar(cell[1])
+        return Path(nodes, edges)
+
+    def parse_map(self, cell):
+        m = OrderedDict()
+        n_entries = len(cell)
+
+        # A map is an array of key value pairs.
+        # 1. key (string)
+        # 2. array: (value type, value)
+        for i in range(0, n_entries, 2):
+            key = self.parse_string(cell[i])
+            m[key] = self.parse_scalar(cell[i + 1])
+
+        return m
+
+    def parse_point(self, cell):
+        p = {}
+        # A point is received an array of the form: [latitude, longitude]
+        # It is returned as a map of the form: {"latitude": latitude, "longitude": longitude} # noqa
+        p["latitude"] = float(cell[0])
+        p["longitude"] = float(cell[1])
+        return p
+
+    def parse_scalar(self, cell):
+        scalar_type = int(cell[0])
+        value = cell[1]
+        scalar = None
+
+        if scalar_type == ResultSetScalarTypes.VALUE_NULL:
+            scalar = None
+
+        elif scalar_type == ResultSetScalarTypes.VALUE_STRING:
+            scalar = self.parse_string(value)
+
+        elif scalar_type == ResultSetScalarTypes.VALUE_INTEGER:
+            scalar = int(value)
+
+        elif scalar_type == ResultSetScalarTypes.VALUE_BOOLEAN:
+            value = value.decode() if isinstance(value, bytes) else value
+            if value == "true":
+                scalar = True
+            elif value == "false":
+                scalar = False
+            else:
+                print("Unknown boolean type\n")
+
+        elif scalar_type == ResultSetScalarTypes.VALUE_DOUBLE:
+            scalar = float(value)
+
+        elif scalar_type == ResultSetScalarTypes.VALUE_ARRAY:
+            # array variable is introduced only for readability
+            scalar = array = value
+            for i in range(len(array)):
+                scalar[i] = self.parse_scalar(array[i])
+
+        elif scalar_type == ResultSetScalarTypes.VALUE_NODE:
+            scalar = self.parse_node(value)
+
+        elif scalar_type == ResultSetScalarTypes.VALUE_EDGE:
+            scalar = self.parse_edge(value)
+
+        elif scalar_type == ResultSetScalarTypes.VALUE_PATH:
+            scalar = self.parse_path(value)
+
+        elif scalar_type == ResultSetScalarTypes.VALUE_MAP:
+            scalar = self.parse_map(value)
+
+        elif scalar_type == ResultSetScalarTypes.VALUE_POINT:
+            scalar = self.parse_point(value)
+
+        elif scalar_type == ResultSetScalarTypes.VALUE_UNKNOWN:
+            print("Unknown scalar type\n")
+
+        return scalar
+
+    def parse_profile(self, response):
+        self.result_set = [x[0 : x.index(",")].strip() for x in response]
+
+    # """Prints the data from the query response:
+    #    1. First row result_set contains the columns names.
+    #       Thus the first row in PrettyTable will contain the
+    #       columns.
+    #    2. The row after that will contain the data returned,
+    #       or 'No Data returned' if there is none.
+    #    3. Prints the statistics of the query.
+    # """
+
+    # def pretty_print(self):
+    #     if not self.is_empty():
+    #         header = [col[1] for col in self.header]
+    #         tbl = PrettyTable(header)
+
+    #         for row in self.result_set:
+    #             record = []
+    #             for idx, cell in enumerate(row):
+    #                 if type(cell) is Node:
+    #                     record.append(cell.toString())
+    #                 elif type(cell) is Edge:
+    #                     record.append(cell.toString())
+    #                 else:
+    #                     record.append(cell)
+    #             tbl.add_row(record)
+
+    #         if len(self.result_set) == 0:
+    #             tbl.add_row(['No data returned.'])
+
+    #         print(str(tbl) + '\n')
+
+    #     for stat in self.statistics:
+    #         print("%s %s" % (stat, self.statistics[stat]))
+
+    def is_empty(self):
+        return len(self.result_set) == 0
+
+    @staticmethod
+    def _get_value(prop, statistics):
+        for stat in statistics:
+            if prop in stat:
+                return float(stat.split(": ")[1].split(" ")[0])
+
+        return None
+
+    def _get_stat(self, stat):
+        return self.statistics[stat] if stat in self.statistics else 0
+
+    @property
+    def labels_added(self):
+        return self._get_stat(LABELS_ADDED)
+
+    @property
+    def nodes_created(self):
+        return self._get_stat(NODES_CREATED)
+
+    @property
+    def nodes_deleted(self):
+        return self._get_stat(NODES_DELETED)
+
+    @property
+    def properties_set(self):
+        return self._get_stat(PROPERTIES_SET)
+
+    @property
+    def relationships_created(self):
+        return self._get_stat(RELATIONSHIPS_CREATED)
+
+    @property
+    def relationships_deleted(self):
+        return self._get_stat(RELATIONSHIPS_DELETED)
+
+    @property
+    def indices_created(self):
+        return self._get_stat(INDICES_CREATED)
+
+    @property
+    def indices_deleted(self):
+        return self._get_stat(INDICES_DELETED)
+
+    @property
+    def cached_execution(self):
+        return self._get_stat(CACHED_EXECUTION) == 1
+
+    @property
+    def run_time_ms(self):
+        return self._get_stat(INTERNAL_EXECUTION_TIME)
diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
index 80dfd76a15..afb4f9fae8 100644
--- a/redis/commands/helpers.py
+++ b/redis/commands/helpers.py
@@ -1,3 +1,4 @@
+import copy
 import random
 import string
 
@@ -114,3 +115,40 @@ def quote_string(v):
     v = v.replace('"', '\\"')
 
     return f'"{v}"'
+
+
+def decodeDictKeys(obj):
+    """Decode the keys of the given dictionary with utf-8."""
+    newobj = copy.copy(obj)
+    for k in obj.keys():
+        if isinstance(k, bytes):
+            newobj[k.decode("utf-8")] = newobj[k]
+            newobj.pop(k)
+    return newobj
+
+
+def stringify_param_value(value):
+    """
+    Turn a parameter value into a string suitable for the params header of
+    a Cypher command.
+    You may pass any value that would be accepted by `json.dumps()`.
+
+    Ways in which output differs from that of `str()`:
+        * Strings are quoted.
+        * None --> "null".
+        * In dictionaries, keys are _not_ quoted.
+
+    :param value: The parameter value to be turned into a string.
+    :return: string
+    """
+
+    if isinstance(value, str):
+        return quote_string(value)
+    elif value is None:
+        return "null"
+    elif isinstance(value, (list, tuple)):
+        return f'[{",".join(map(stringify_param_value, value))}]'
+    elif isinstance(value, dict):
+        return f'{{{",".join(f"{k}:{stringify_param_value(v)}" for k, v in value.items())}}}'  # noqa
+    else:
+        return str(value)
diff --git a/redis/commands/redismodules.py b/redis/commands/redismodules.py
index 2420d7b6fb..e5ace63113 100644
--- a/redis/commands/redismodules.py
+++ b/redis/commands/redismodules.py
@@ -31,3 +31,13 @@ def ts(self):
 
         s = TimeSeries(client=self)
         return s
+
+    def graph(self, index_name="idx"):
+        """Access the timeseries namespace, providing support for
+        redis timeseries data.
+        """
+
+        from .graph import Graph
+
+        g = Graph(client=self, name=index_name)
+        return g
diff --git a/setup.py b/setup.py
index ee91298289..d8308010c9 100644
--- a/setup.py
+++ b/setup.py
@@ -18,6 +18,7 @@
             "redis.commands.json",
             "redis.commands.search",
             "redis.commands.timeseries",
+            "redis.commands.graph",
         ]
     ),
     url="https://github.com/redis/redis-py",
diff --git a/tests/test_graph.py b/tests/test_graph.py
new file mode 100644
index 0000000000..c6dc9a4371
--- /dev/null
+++ b/tests/test_graph.py
@@ -0,0 +1,477 @@
+import pytest
+
+from redis.commands.graph import Edge, Node, Path
+from redis.exceptions import ResponseError
+
+
+@pytest.fixture
+def client(modclient):
+    modclient.flushdb()
+    return modclient
+
+
+@pytest.mark.redismod
+def test_bulk(client):
+    with pytest.raises(NotImplementedError):
+        client.graph().bulk()
+        client.graph().bulk(foo="bar!")
+
+
+@pytest.mark.redismod
+def test_graph_creation(client):
+    graph = client.graph()
+
+    john = Node(
+        label="person",
+        properties={
+            "name": "John Doe",
+            "age": 33,
+            "gender": "male",
+            "status": "single",
+        },
+    )
+    graph.add_node(john)
+    japan = Node(label="country", properties={"name": "Japan"})
+
+    graph.add_node(japan)
+    edge = Edge(john, "visited", japan, properties={"purpose": "pleasure"})
+    graph.add_edge(edge)
+
+    graph.commit()
+
+    query = (
+        'MATCH (p:person)-[v:visited {purpose:"pleasure"}]->(c:country) '
+        "RETURN p, v, c"
+    )
+
+    result = graph.query(query)
+
+    person = result.result_set[0][0]
+    visit = result.result_set[0][1]
+    country = result.result_set[0][2]
+
+    assert person == john
+    assert visit.properties == edge.properties
+    assert country == japan
+
+    query = """RETURN [1, 2.3, "4", true, false, null]"""
+    result = graph.query(query)
+    assert [1, 2.3, "4", True, False, None] == result.result_set[0][0]
+
+    # All done, remove graph.
+    graph.delete()
+
+
+@pytest.mark.redismod
+def test_array_functions(client):
+    query = """CREATE (p:person{name:'a',age:32, array:[0,1,2]})"""
+    client.graph().query(query)
+
+    query = """WITH [0,1,2] as x return x"""
+    result = client.graph().query(query)
+    assert [0, 1, 2] == result.result_set[0][0]
+
+    query = """MATCH(n) return collect(n)"""
+    result = client.graph().query(query)
+
+    a = Node(
+        node_id=0,
+        label="person",
+        properties={"name": "a", "age": 32, "array": [0, 1, 2]},
+    )
+
+    assert [a] == result.result_set[0][0]
+
+
+@pytest.mark.redismod
+def test_path(client):
+    node0 = Node(node_id=0, label="L1")
+    node1 = Node(node_id=1, label="L1")
+    edge01 = Edge(node0, "R1", node1, edge_id=0, properties={"value": 1})
+
+    graph = client.graph()
+    graph.add_node(node0)
+    graph.add_node(node1)
+    graph.add_edge(edge01)
+    graph.flush()
+
+    path01 = Path.new_empty_path().add_node(node0).add_edge(edge01).add_node(node1)
+    expected_results = [[path01]]
+
+    query = "MATCH p=(:L1)-[:R1]->(:L1) RETURN p ORDER BY p"
+    result = graph.query(query)
+    assert expected_results == result.result_set
+
+
+@pytest.mark.redismod
+def test_param(client):
+    params = [1, 2.3, "str", True, False, None, [0, 1, 2]]
+    query = "RETURN $param"
+    for param in params:
+        result = client.graph().query(query, {"param": param})
+        expected_results = [[param]]
+        assert expected_results == result.result_set
+
+
+@pytest.mark.redismod
+def test_map(client):
+    query = "RETURN {a:1, b:'str', c:NULL, d:[1,2,3], e:True, f:{x:1, y:2}}"
+
+    actual = client.graph().query(query).result_set[0][0]
+    expected = {
+        "a": 1,
+        "b": "str",
+        "c": None,
+        "d": [1, 2, 3],
+        "e": True,
+        "f": {"x": 1, "y": 2},
+    }
+
+    assert actual == expected
+
+
+@pytest.mark.redismod
+def test_point(client):
+    query = "RETURN point({latitude: 32.070794860, longitude: 34.820751118})"
+    expected_lat = 32.070794860
+    expected_lon = 34.820751118
+    actual = client.graph().query(query).result_set[0][0]
+    assert abs(actual["latitude"] - expected_lat) < 0.001
+    assert abs(actual["longitude"] - expected_lon) < 0.001
+
+    query = "RETURN point({latitude: 32, longitude: 34.0})"
+    expected_lat = 32
+    expected_lon = 34
+    actual = client.graph().query(query).result_set[0][0]
+    assert abs(actual["latitude"] - expected_lat) < 0.001
+    assert abs(actual["longitude"] - expected_lon) < 0.001
+
+
+@pytest.mark.redismod
+def test_index_response(client):
+    result_set = client.graph().query("CREATE INDEX ON :person(age)")
+    assert 1 == result_set.indices_created
+
+    result_set = client.graph().query("CREATE INDEX ON :person(age)")
+    assert 0 == result_set.indices_created
+
+    result_set = client.graph().query("DROP INDEX ON :person(age)")
+    assert 1 == result_set.indices_deleted
+
+    with pytest.raises(ResponseError):
+        client.graph().query("DROP INDEX ON :person(age)")
+
+
+@pytest.mark.redismod
+def test_stringify_query_result(client):
+    graph = client.graph()
+
+    john = Node(
+        alias="a",
+        label="person",
+        properties={
+            "name": "John Doe",
+            "age": 33,
+            "gender": "male",
+            "status": "single",
+        },
+    )
+    graph.add_node(john)
+
+    japan = Node(alias="b", label="country", properties={"name": "Japan"})
+    graph.add_node(japan)
+
+    edge = Edge(john, "visited", japan, properties={"purpose": "pleasure"})
+    graph.add_edge(edge)
+
+    assert (
+        str(john)
+        == """(a:person{age:33,gender:"male",name:"John Doe",status:"single"})"""  # noqa
+    )
+    assert (
+        str(edge)
+        == """(a:person{age:33,gender:"male",name:"John Doe",status:"single"})"""  # noqa
+        + """-[:visited{purpose:"pleasure"}]->"""
+        + """(b:country{name:"Japan"})"""
+    )
+    assert str(japan) == """(b:country{name:"Japan"})"""
+
+    graph.commit()
+
+    query = """MATCH (p:person)-[v:visited {purpose:"pleasure"}]->(c:country)
+            RETURN p, v, c"""
+
+    result = client.graph().query(query)
+    person = result.result_set[0][0]
+    visit = result.result_set[0][1]
+    country = result.result_set[0][2]
+
+    assert (
+        str(person)
+        == """(:person{age:33,gender:"male",name:"John Doe",status:"single"})"""  # noqa
+    )
+    assert str(visit) == """()-[:visited{purpose:"pleasure"}]->()"""
+    assert str(country) == """(:country{name:"Japan"})"""
+
+    graph.delete()
+
+
+@pytest.mark.redismod
+def test_optional_match(client):
+    # Build a graph of form (a)-[R]->(b)
+    node0 = Node(node_id=0, label="L1", properties={"value": "a"})
+    node1 = Node(node_id=1, label="L1", properties={"value": "b"})
+
+    edge01 = Edge(node0, "R", node1, edge_id=0)
+
+    graph = client.graph()
+    graph.add_node(node0)
+    graph.add_node(node1)
+    graph.add_edge(edge01)
+    graph.flush()
+
+    # Issue a query that collects all outgoing edges from both nodes
+    # (the second has none)
+    query = """MATCH (a) OPTIONAL MATCH (a)-[e]->(b) RETURN a, e, b ORDER BY a.value"""  # noqa
+    expected_results = [[node0, edge01, node1], [node1, None, None]]
+
+    result = client.graph().query(query)
+    assert expected_results == result.result_set
+
+    graph.delete()
+
+
+@pytest.mark.redismod
+def test_cached_execution(client):
+    client.graph().query("CREATE ()")
+
+    uncached_result = client.graph().query("MATCH (n) RETURN n, $param", {"param": [0]})
+    assert uncached_result.cached_execution is False
+
+    # loop to make sure the query is cached on each thread on server
+    for x in range(0, 64):
+        cached_result = client.graph().query(
+            "MATCH (n) RETURN n, $param", {"param": [0]}
+        )
+        assert uncached_result.result_set == cached_result.result_set
+
+    # should be cached on all threads by now
+    assert cached_result.cached_execution
+
+
+@pytest.mark.redismod
+def test_explain(client):
+    create_query = """CREATE (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
+    (:Rider {name:'Dani Pedrosa'})-[:rides]->(:Team {name:'Honda'}),
+    (:Rider {name:'Andrea Dovizioso'})-[:rides]->(:Team {name:'Ducati'})"""
+    client.graph().query(create_query)
+
+    result = client.graph().explain(
+        "MATCH (r:Rider)-[:rides]->(t:Team) WHERE t.name = $name RETURN r.name, t.name, $params",  # noqa
+        {"name": "Yehuda"},
+    )
+    expected = "Results\n    Project\n        Conditional Traverse | (t:Team)->(r:Rider)\n            Filter\n                Node By Label Scan | (t:Team)"  # noqa
+    assert result == expected
+
+
+@pytest.mark.redismod
+def test_slowlog(client):
+    create_query = """CREATE (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
+    (:Rider {name:'Dani Pedrosa'})-[:rides]->(:Team {name:'Honda'}),
+    (:Rider {name:'Andrea Dovizioso'})-[:rides]->(:Team {name:'Ducati'})"""
+    client.graph().query(create_query)
+
+    results = client.graph().slowlog()
+    assert results[0][1] == "GRAPH.QUERY"
+    assert results[0][2] == create_query
+
+
+@pytest.mark.redismod
+def test_query_timeout(client):
+    # Build a sample graph with 1000 nodes.
+    client.graph().query("UNWIND range(0,1000) as val CREATE ({v: val})")
+    # Issue a long-running query with a 1-millisecond timeout.
+    with pytest.raises(ResponseError):
+        client.graph().query("MATCH (a), (b), (c), (d) RETURN *", timeout=1)
+        assert False is False
+
+    with pytest.raises(Exception):
+        client.graph().query("RETURN 1", timeout="str")
+        assert False is False
+
+
+@pytest.mark.redismod
+def test_read_only_query(client):
+    with pytest.raises(Exception):
+        # Issue a write query, specifying read-only true,
+        # this call should fail.
+        client.graph().query("CREATE (p:person {name:'a'})", read_only=True)
+        assert False is False
+
+
+@pytest.mark.redismod
+def test_profile(client):
+    q = """UNWIND range(1, 3) AS x CREATE (p:Person {v:x})"""
+    profile = client.graph().profile(q).result_set
+    assert "Create | Records produced: 3" in profile
+    assert "Unwind | Records produced: 3" in profile
+
+    q = "MATCH (p:Person) WHERE p.v > 1 RETURN p"
+    profile = client.graph().profile(q).result_set
+    assert "Results | Records produced: 2" in profile
+    assert "Project | Records produced: 2" in profile
+    assert "Filter | Records produced: 2" in profile
+    assert "Node By Label Scan | (p:Person) | Records produced: 3" in profile
+
+
+@pytest.mark.redismod
+def test_config(client):
+    config_name = "RESULTSET_SIZE"
+    config_value = 3
+
+    # Set configuration
+    response = client.graph().config(config_name, config_value, set=True)
+    assert response == "OK"
+
+    # Make sure config been updated.
+    response = client.graph().config(config_name, set=False)
+    expected_response = [config_name, config_value]
+    assert response == expected_response
+
+    config_name = "QUERY_MEM_CAPACITY"
+    config_value = 1 << 20  # 1MB
+
+    # Set configuration
+    response = client.graph().config(config_name, config_value, set=True)
+    assert response == "OK"
+
+    # Make sure config been updated.
+    response = client.graph().config(config_name, set=False)
+    expected_response = [config_name, config_value]
+    assert response == expected_response
+
+    # reset to default
+    client.graph().config("QUERY_MEM_CAPACITY", 0, set=True)
+    client.graph().config("RESULTSET_SIZE", -100, set=True)
+
+
+@pytest.mark.redismod
+def test_list_keys(client):
+    result = client.graph().list_keys()
+    assert result == []
+
+    client.execute_command("GRAPH.EXPLAIN", "G", "RETURN 1")
+    result = client.graph().list_keys()
+    assert result == ["G"]
+
+    client.execute_command("GRAPH.EXPLAIN", "X", "RETURN 1")
+    result = client.graph().list_keys()
+    assert result == ["G", "X"]
+
+    client.delete("G")
+    client.rename("X", "Z")
+    result = client.graph().list_keys()
+    assert result == ["Z"]
+
+    client.delete("Z")
+    result = client.graph().list_keys()
+    assert result == []
+
+
+@pytest.mark.redismod
+def test_multi_label(client):
+    redis_graph = client.graph("g")
+
+    node = Node(label=["l", "ll"])
+    redis_graph.add_node(node)
+    redis_graph.commit()
+
+    query = "MATCH (n) RETURN n"
+    result = redis_graph.query(query)
+    result_node = result.result_set[0][0]
+    assert result_node == node
+
+    try:
+        Node(label=1)
+        assert False
+    except AssertionError:
+        assert True
+
+    try:
+        Node(label=["l", 1])
+        assert False
+    except AssertionError:
+        assert True
+
+
+@pytest.mark.redismod
+def test_cache_sync(client):
+    pass
+    return
+    # This test verifies that client internal graph schema cache stays
+    # in sync with the graph schema
+    #
+    # Client B will try to get Client A out of sync by:
+    # 1. deleting the graph
+    # 2. reconstructing the graph in a different order, this will casuse
+    #    a differance in the current mapping between string IDs and the
+    #    mapping Client A is aware of
+    #
+    # Client A should pick up on the changes by comparing graph versions
+    # and resyncing its cache.
+
+    A = client.graph("cache-sync")
+    B = client.graph("cache-sync")
+
+    # Build order:
+    # 1. introduce label 'L' and 'K'
+    # 2. introduce attribute 'x' and 'q'
+    # 3. introduce relationship-type 'R' and 'S'
+
+    A.query("CREATE (:L)")
+    B.query("CREATE (:K)")
+    A.query("MATCH (n) SET n.x = 1")
+    B.query("MATCH (n) SET n.q = 1")
+    A.query("MATCH (n) CREATE (n)-[:R]->()")
+    B.query("MATCH (n) CREATE (n)-[:S]->()")
+
+    # Cause client A to populate its cache
+    A.query("MATCH (n)-[e]->() RETURN n, e")
+
+    assert len(A._labels) == 2
+    assert len(A._properties) == 2
+    assert len(A._relationshipTypes) == 2
+    assert A._labels[0] == "L"
+    assert A._labels[1] == "K"
+    assert A._properties[0] == "x"
+    assert A._properties[1] == "q"
+    assert A._relationshipTypes[0] == "R"
+    assert A._relationshipTypes[1] == "S"
+
+    # Have client B reconstruct the graph in a different order.
+    B.delete()
+
+    # Build order:
+    # 1. introduce relationship-type 'R'
+    # 2. introduce label 'L'
+    # 3. introduce attribute 'x'
+    B.query("CREATE ()-[:S]->()")
+    B.query("CREATE ()-[:R]->()")
+    B.query("CREATE (:K)")
+    B.query("CREATE (:L)")
+    B.query("MATCH (n) SET n.q = 1")
+    B.query("MATCH (n) SET n.x = 1")
+
+    # A's internal cached mapping is now out of sync
+    # issue a query and make sure A's cache is synced.
+    A.query("MATCH (n)-[e]->() RETURN n, e")
+
+    assert len(A._labels) == 2
+    assert len(A._properties) == 2
+    assert len(A._relationshipTypes) == 2
+    assert A._labels[0] == "K"
+    assert A._labels[1] == "L"
+    assert A._properties[0] == "q"
+    assert A._properties[1] == "x"
+    assert A._relationshipTypes[0] == "S"
+    assert A._relationshipTypes[1] == "R"
diff --git a/tests/test_graph_utils/__init__.py b/tests/test_graph_utils/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/tests/test_graph_utils/test_edge.py b/tests/test_graph_utils/test_edge.py
new file mode 100644
index 0000000000..42358de19a
--- /dev/null
+++ b/tests/test_graph_utils/test_edge.py
@@ -0,0 +1,77 @@
+import pytest
+
+from redis.commands.graph import edge, node
+
+
+@pytest.mark.redismod
+def test_init():
+
+    with pytest.raises(AssertionError):
+        edge.Edge(None, None, None)
+        edge.Edge(node.Node(), None, None)
+        edge.Edge(None, None, node.Node())
+
+    assert isinstance(
+        edge.Edge(node.Node(node_id=1), None, node.Node(node_id=2)), edge.Edge
+    )
+
+
+@pytest.mark.redismod
+def test_toString():
+    props_result = edge.Edge(
+        node.Node(), None, node.Node(), properties={"a": "a", "b": 10}
+    ).toString()
+    assert props_result == '{a:"a",b:10}'
+
+    no_props_result = edge.Edge(
+        node.Node(), None, node.Node(), properties={}
+    ).toString()
+    assert no_props_result == ""
+
+
+@pytest.mark.redismod
+def test_stringify():
+    john = node.Node(
+        alias="a",
+        label="person",
+        properties={"name": "John Doe", "age": 33, "someArray": [1, 2, 3]},
+    )
+    japan = node.Node(alias="b", label="country", properties={"name": "Japan"})
+    edge_with_relation = edge.Edge(
+        john, "visited", japan, properties={"purpose": "pleasure"}
+    )
+    assert (
+        '(a:person{age:33,name:"John Doe",someArray:[1, 2, 3]})'
+        '-[:visited{purpose:"pleasure"}]->'
+        '(b:country{name:"Japan"})' == str(edge_with_relation)
+    )
+
+    edge_no_relation_no_props = edge.Edge(japan, "", john)
+    assert (
+        '(b:country{name:"Japan"})'
+        "-[]->"
+        '(a:person{age:33,name:"John Doe",someArray:[1, 2, 3]})'
+        == str(edge_no_relation_no_props)
+    )
+
+    edge_only_props = edge.Edge(john, "", japan, properties={"a": "b", "c": 3})
+    assert (
+        '(a:person{age:33,name:"John Doe",someArray:[1, 2, 3]})'
+        '-[{a:"b",c:3}]->'
+        '(b:country{name:"Japan"})' == str(edge_only_props)
+    )
+
+
+@pytest.mark.redismod
+def test_comparision():
+    node1 = node.Node(node_id=1)
+    node2 = node.Node(node_id=2)
+    node3 = node.Node(node_id=3)
+
+    edge1 = edge.Edge(node1, None, node2)
+    assert edge1 == edge.Edge(node1, None, node2)
+    assert edge1 != edge.Edge(node1, "bla", node2)
+    assert edge1 != edge.Edge(node1, None, node3)
+    assert edge1 != edge.Edge(node3, None, node2)
+    assert edge1 != edge.Edge(node2, None, node1)
+    assert edge1 != edge.Edge(node1, None, node2, properties={"a": 10})
diff --git a/tests/test_graph_utils/test_node.py b/tests/test_graph_utils/test_node.py
new file mode 100644
index 0000000000..faf8ab6458
--- /dev/null
+++ b/tests/test_graph_utils/test_node.py
@@ -0,0 +1,52 @@
+import pytest
+
+from redis.commands.graph import node
+
+
+@pytest.fixture
+def fixture():
+    no_args = node.Node()
+    no_props = node.Node(node_id=1, alias="alias", label="l")
+    props_only = node.Node(properties={"a": "a", "b": 10})
+    no_label = node.Node(node_id=1, alias="alias", properties={"a": "a"})
+    multi_label = node.Node(node_id=1, alias="alias", label=["l", "ll"])
+    return no_args, no_props, props_only, no_label, multi_label
+
+
+@pytest.mark.redismod
+def test_toString(fixture):
+    no_args, no_props, props_only, no_label, multi_label = fixture
+    assert no_args.toString() == ""
+    assert no_props.toString() == ""
+    assert props_only.toString() == '{a:"a",b:10}'
+    assert no_label.toString() == '{a:"a"}'
+    assert multi_label.toString() == ""
+
+
+@pytest.mark.redismod
+def test_stringify(fixture):
+    no_args, no_props, props_only, no_label, multi_label = fixture
+    assert str(no_args) == "()"
+    assert str(no_props) == "(alias:l)"
+    assert str(props_only) == '({a:"a",b:10})'
+    assert str(no_label) == '(alias{a:"a"})'
+    assert str(multi_label) == "(alias:l:ll)"
+
+
+@pytest.mark.redismod
+def test_comparision(fixture):
+    no_args, no_props, props_only, no_label, multi_label = fixture
+
+    assert node.Node() == node.Node()
+    assert node.Node(node_id=1) == node.Node(node_id=1)
+    assert node.Node(node_id=1) != node.Node(node_id=2)
+    assert node.Node(node_id=1, alias="a") == node.Node(node_id=1, alias="b")
+    assert node.Node(node_id=1, alias="a") == node.Node(node_id=1, alias="a")
+    assert node.Node(node_id=1, label="a") == node.Node(node_id=1, label="a")
+    assert node.Node(node_id=1, label="a") != node.Node(node_id=1, label="b")
+    assert node.Node(node_id=1, alias="a", label="l") == node.Node(
+        node_id=1, alias="a", label="l"
+    )
+    assert node.Node(alias="a", label="l") != node.Node(alias="a", label="l1")
+    assert node.Node(properties={"a": 10}) == node.Node(properties={"a": 10})
+    assert node.Node() != node.Node(properties={"a": 10})
diff --git a/tests/test_graph_utils/test_path.py b/tests/test_graph_utils/test_path.py
new file mode 100644
index 0000000000..d581269307
--- /dev/null
+++ b/tests/test_graph_utils/test_path.py
@@ -0,0 +1,91 @@
+import pytest
+
+from redis.commands.graph import edge, node, path
+
+
+@pytest.mark.redismod
+def test_init():
+    with pytest.raises(TypeError):
+        path.Path(None, None)
+        path.Path([], None)
+        path.Path(None, [])
+
+    assert isinstance(path.Path([], []), path.Path)
+
+
+@pytest.mark.redismod
+def test_new_empty_path():
+    new_empty_path = path.Path.new_empty_path()
+    assert isinstance(new_empty_path, path.Path)
+    assert new_empty_path._nodes == []
+    assert new_empty_path._edges == []
+
+
+@pytest.mark.redismod
+def test_wrong_flows():
+    node_1 = node.Node(node_id=1)
+    node_2 = node.Node(node_id=2)
+    node_3 = node.Node(node_id=3)
+
+    edge_1 = edge.Edge(node_1, None, node_2)
+    edge_2 = edge.Edge(node_1, None, node_3)
+
+    p = path.Path.new_empty_path()
+    with pytest.raises(AssertionError):
+        p.add_edge(edge_1)
+
+    p.add_node(node_1)
+    with pytest.raises(AssertionError):
+        p.add_node(node_2)
+
+    p.add_edge(edge_1)
+    with pytest.raises(AssertionError):
+        p.add_edge(edge_2)
+
+
+@pytest.mark.redismod
+def test_nodes_and_edges():
+    node_1 = node.Node(node_id=1)
+    node_2 = node.Node(node_id=2)
+    edge_1 = edge.Edge(node_1, None, node_2)
+
+    p = path.Path.new_empty_path()
+    assert p.nodes() == []
+    p.add_node(node_1)
+    assert [] == p.edges()
+    assert 0 == p.edge_count()
+    assert [node_1] == p.nodes()
+    assert node_1 == p.get_node(0)
+    assert node_1 == p.first_node()
+    assert node_1 == p.last_node()
+    assert 1 == p.nodes_count()
+    p.add_edge(edge_1)
+    assert [edge_1] == p.edges()
+    assert 1 == p.edge_count()
+    assert edge_1 == p.get_relationship(0)
+    p.add_node(node_2)
+    assert [node_1, node_2] == p.nodes()
+    assert node_1 == p.first_node()
+    assert node_2 == p.last_node()
+    assert 2 == p.nodes_count()
+
+
+@pytest.mark.redismod
+def test_compare():
+    node_1 = node.Node(node_id=1)
+    node_2 = node.Node(node_id=2)
+    edge_1 = edge.Edge(node_1, None, node_2)
+
+    assert path.Path.new_empty_path() == path.Path.new_empty_path()
+    assert path.Path(nodes=[node_1, node_2], edges=[edge_1]) == path.Path(
+        nodes=[node_1, node_2], edges=[edge_1]
+    )
+    assert path.Path(nodes=[node_1], edges=[]) != path.Path(nodes=[], edges=[])
+    assert path.Path(nodes=[node_1], edges=[]) != path.Path(nodes=[], edges=[])
+    assert path.Path(nodes=[node_1], edges=[]) != path.Path(nodes=[node_2], edges=[])
+    assert path.Path(nodes=[node_1], edges=[edge_1]) != path.Path(
+        nodes=[node_1], edges=[]
+    )
+    assert path.Path(nodes=[node_1], edges=[edge_1]) != path.Path(
+        nodes=[node_2], edges=[edge_1]
+    )
diff --git a/tox.ini b/tox.ini
index 9d78e2a028..0ccc9bb537 100644
--- a/tox.ini
+++ b/tox.ini
@@ -2,13 +2,14 @@
 addopts = -s
 markers =
     redismod: run only the redis module tests
+    pipeline: pipeline tests
     onlycluster: marks tests to be run only with cluster mode redis
     onlynoncluster: marks tests to be run only with standalone redis
 
 [tox]
 minversion = 3.2.0
 requires = tox-docker
-envlist = {standalone,cluster}-{plain,hiredis}-{py35,py36,py37,py38,py39,pypy3},linters,docs
+envlist = {standalone,cluster}-{plain,hiredis}-{py36,py37,py38,py39,pypy3},linters,docs
 
 [docker:master]
 name = master

From e16e26ea597e6e0c576d7462d3a2285a8647617d Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Wed, 1 Dec 2021 17:32:38 +0100
Subject: [PATCH 0281/1164] Remove unused aggregation  subclasses (#1754)

---
 redis/commands/search/aggregation.py | 104 +++++++--------------------
 1 file changed, 27 insertions(+), 77 deletions(-)

diff --git a/redis/commands/search/aggregation.py b/redis/commands/search/aggregation.py
index b1ac6b04dc..3db5542ae1 100644
--- a/redis/commands/search/aggregation.py
+++ b/redis/commands/search/aggregation.py
@@ -82,75 +82,6 @@ class Desc(SortDirection):
     DIRSTRING = "DESC"
 
 
-class Group:
-    """
-    This object automatically created in the `AggregateRequest.group_by()`
-    """
-
-    def __init__(self, fields, reducers):
-        if not reducers:
-            raise ValueError("Need at least one reducer")
-
-        fields = [fields] if isinstance(fields, str) else fields
-        reducers = [reducers] if isinstance(reducers, Reducer) else reducers
-
-        self.fields = fields
-        self.reducers = reducers
-        self.limit = Limit()
-
-    def build_args(self):
-        ret = ["GROUPBY", str(len(self.fields))]
-        ret.extend(self.fields)
-        for reducer in self.reducers:
-            ret += ["REDUCE", reducer.NAME, str(len(reducer.args))]
-            ret.extend(reducer.args)
-            if reducer._alias is not None:
-                ret += ["AS", reducer._alias]
-        return ret
-
-
-class Projection:
-    """
-    This object automatically created in the `AggregateRequest.apply()`
-    """
-
-    def __init__(self, projector, alias=None):
-        self.alias = alias
-        self.projector = projector
-
-    def build_args(self):
-        ret = ["APPLY", self.projector]
-        if self.alias is not None:
-            ret += ["AS", self.alias]
-
-        return ret
-
-
-class SortBy:
-    """
-    This object automatically created in the `AggregateRequest.sort_by()`
-    """
-
-    def __init__(self, fields, max=0):
-        self.fields = fields
-        self.max = max
-
-    def build_args(self):
-        fields_args = []
-        for f in self.fields:
-            if isinstance(f, SortDirection):
-                fields_args += [f.field, f.DIRSTRING]
-            else:
-                fields_args += [f]
-
-        ret = ["SORTBY", str(len(fields_args))]
-        ret.extend(fields_args)
-        if self.max > 0:
-            ret += ["MAX", str(self.max)]
-
-        return ret
-
-
 class AggregateRequest:
     """
     Aggregation request which can be passed to `Client.aggregate`.
@@ -202,9 +133,17 @@ def group_by(self, fields, *reducers):
         - **reducers**: One or more reducers. Reducers may be found in the
             `aggregation` module.
         """
-        group = Group(fields, reducers)
-        self._aggregateplan.extend(group.build_args())
+        fields = [fields] if isinstance(fields, str) else fields
+        reducers = [reducers] if isinstance(reducers, Reducer) else reducers
 
+        ret = ["GROUPBY", str(len(fields)), *fields]
+        for reducer in reducers:
+            ret += ["REDUCE", reducer.NAME, str(len(reducer.args))]
+            ret.extend(reducer.args)
+            if reducer._alias is not None:
+                ret += ["AS", reducer._alias]
+
+        self._aggregateplan.extend(ret)
         return self
 
     def apply(self, **kwexpr):
@@ -218,8 +157,10 @@ def apply(self, **kwexpr):
             expression itself, for example `apply(square_root="sqrt(@foo)")`
         """
         for alias, expr in kwexpr.items():
-            projection = Projection(expr, alias)
-            self._aggregateplan.extend(projection.build_args())
+            ret = ["APPLY", expr]
+            if alias is not None:
+                ret += ["AS", alias]
+            self._aggregateplan.extend(ret)
 
         return self
 
@@ -265,8 +206,7 @@ def limit(self, offset, num):
         `sort_by()` instead.
 
         """
-        limit = Limit(offset, num)
-        self._limit = limit
+        self._limit = Limit(offset, num)
         return self
 
     def sort_by(self, *fields, **kwargs):
@@ -300,10 +240,20 @@ def sort_by(self, *fields, **kwargs):
         if isinstance(fields, (str, SortDirection)):
             fields = [fields]
 
+        fields_args = []
+        for f in fields:
+            if isinstance(f, SortDirection):
+                fields_args += [f.field, f.DIRSTRING]
+            else:
+                fields_args += [f]
+
+        ret = ["SORTBY", str(len(fields_args))]
+        ret.extend(fields_args)
         max = kwargs.get("max", 0)
-        sortby = SortBy(fields, max)
+        if max > 0:
+            ret += ["MAX", str(max)]
 
-        self._aggregateplan.extend(sortby.build_args())
+        self._aggregateplan.extend(ret)
         return self
 
     def filter(self, expressions):

From d4252277a9dafed5af34b3f40ed7a57fc952d273 Mon Sep 17 00:00:00 2001
From: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Date: Wed, 1 Dec 2021 18:33:44 +0200
Subject: [PATCH 0282/1164] Migrated targeted nodes to kwargs in Cluster Mode
 (#1762)

---
 README.md                  |   4 +-
 redis/client.py            |  12 +
 redis/cluster.py           |  39 ++-
 redis/commands/__init__.py |   4 +-
 redis/commands/cluster.py  | 598 +++----------------------------------
 redis/commands/core.py     | 354 ++++++++++++----------
 tests/test_cluster.py      |  63 +++-
 tests/test_commands.py     |  15 +-
 8 files changed, 342 insertions(+), 747 deletions(-)

diff --git a/README.md b/README.md
index d068c68f14..f9d6309231 100644
--- a/README.md
+++ b/README.md
@@ -1046,7 +1046,7 @@ and attempt to retry executing the command.
     >>> rc.cluster_meet('127.0.0.1', 6379, target_nodes=Redis.ALL_NODES)
     >>> # ping all replicas
     >>> rc.ping(target_nodes=Redis.REPLICAS)
-    >>> # ping a specific node
+    >>> # ping a random node
     >>> rc.ping(target_nodes=Redis.RANDOM)
     >>> # get the keys from all cluster nodes
     >>> rc.keys(target_nodes=Redis.ALL_NODES)
@@ -1158,7 +1158,7 @@ readwrite() method.
     >>> from cluster import RedisCluster as Redis
     # Use 'debug' log level to print the node that the command is executed on
     >>> rc_readonly = Redis(startup_nodes=startup_nodes, 
-                    read_from_replicas=True, debug=True)
+                    read_from_replicas=True)
     >>> rc_readonly.set('{foo}1', 'bar1')
     >>> for i in range(0, 4):
             # Assigns read command to the slot's hosts in a Round-Robin manner
diff --git a/redis/client.py b/redis/client.py
index 14e588a1d7..c02bc3a4d5 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -960,6 +960,18 @@ def __init__(
     def __repr__(self):
         return f"{type(self).__name__}<{repr(self.connection_pool)}>"
 
+    def get_encoder(self):
+        """
+        Get the connection pool's encoder
+        """
+        return self.connection_pool.get_encoder()
+
+    def get_connection_kwargs(self):
+        """
+        Get the connection's key-word arguments
+        """
+        return self.connection_pool.connection_kwargs
+
     def set_response_callback(self, command, callback):
         "Set a custom Response Callback"
         self.response_callbacks[command] = callback
diff --git a/redis/cluster.py b/redis/cluster.py
index 57e8316ba2..eead2b4dfe 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -8,7 +8,7 @@
 from collections import OrderedDict
 
 from redis.client import CaseInsensitiveDict, PubSub, Redis
-from redis.commands import ClusterCommands, CommandsParser
+from redis.commands import CommandsParser, RedisClusterCommands
 from redis.connection import ConnectionPool, DefaultParser, Encoder, parse_url
 from redis.crc import REDIS_CLUSTER_HASH_SLOTS, key_slot
 from redis.exceptions import (
@@ -94,6 +94,7 @@ def fix_server(*args):
     "charset",
     "connection_class",
     "connection_pool",
+    "client_name",
     "db",
     "decode_responses",
     "encoding",
@@ -198,7 +199,7 @@ class ClusterParser(DefaultParser):
     )
 
 
-class RedisCluster(ClusterCommands):
+class RedisCluster(RedisClusterCommands):
     RedisClusterRequestTTL = 16
 
     PRIMARIES = "primaries"
@@ -212,6 +213,18 @@ class RedisCluster(ClusterCommands):
     COMMAND_FLAGS = dict_merge(
         list_keys_to_dict(
             [
+                "ACL CAT",
+                "ACL DELUSER",
+                "ACL GENPASS",
+                "ACL GETUSER",
+                "ACL HELP",
+                "ACL LIST",
+                "ACL LOG",
+                "ACL LOAD",
+                "ACL SAVE",
+                "ACL SETUSER",
+                "ACL USERS",
+                "ACL WHOAMI",
                 "CLIENT LIST",
                 "CLIENT SETNAME",
                 "CLIENT GETNAME",
@@ -770,6 +783,18 @@ def determine_slot(self, *args):
     def reinitialize_caches(self):
         self.nodes_manager.initialize()
 
+    def get_encoder(self):
+        """
+        Get the connections' encoder
+        """
+        return self.encoder
+
+    def get_connection_kwargs(self):
+        """
+        Get the connections' key-word arguments
+        """
+        return self.nodes_manager.connection_kwargs
+
     def _is_nodes_flag(self, target_nodes):
         return isinstance(target_nodes, str) and target_nodes in self.node_flags
 
@@ -1383,7 +1408,8 @@ def initialize(self):
             # isn't a full coverage
             raise RedisClusterException(
                 f"All slots are not covered after query all startup_nodes. "
-                f"{len(self.slots_cache)} of {REDIS_CLUSTER_HASH_SLOTS} covered..."
+                f"{len(self.slots_cache)} of {REDIS_CLUSTER_HASH_SLOTS} "
+                f"covered..."
             )
         elif not fully_covered and not self._require_full_coverage:
             # The user set require_full_coverage to False.
@@ -1402,7 +1428,8 @@ def initialize(self):
                     "cluster-require-full-coverage configuration to no on "
                     "all of the cluster nodes if you wish the cluster to "
                     "be able to serve without being fully covered."
-                    f"{len(self.slots_cache)} of {REDIS_CLUSTER_HASH_SLOTS} covered..."
+                    f"{len(self.slots_cache)} of {REDIS_CLUSTER_HASH_SLOTS} "
+                    f"covered..."
                 )
 
         # Set the tmp variables to the real variables
@@ -1950,8 +1977,8 @@ def block_pipeline_command(func):
 
     def inner(*args, **kwargs):
         raise RedisClusterException(
-            f"ERROR: Calling pipelined function {func.__name__} is blocked when "
-            f"running redis in cluster mode..."
+            f"ERROR: Calling pipelined function {func.__name__} is blocked "
+            f"when running redis in cluster mode..."
         )
 
     return inner
diff --git a/redis/commands/__init__.py b/redis/commands/__init__.py
index bc1e78c60c..07fa7f1431 100644
--- a/redis/commands/__init__.py
+++ b/redis/commands/__init__.py
@@ -1,4 +1,4 @@
-from .cluster import ClusterCommands
+from .cluster import RedisClusterCommands
 from .core import CoreCommands
 from .helpers import list_or_args
 from .parser import CommandsParser
@@ -6,7 +6,7 @@
 from .sentinel import SentinelCommands
 
 __all__ = [
-    "ClusterCommands",
+    "RedisClusterCommands",
     "CommandsParser",
     "CoreCommands",
     "list_or_args",
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index 0df073ab16..5d0e804628 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -1,7 +1,7 @@
 from redis.crc import key_slot
-from redis.exceptions import ConnectionError, DataError, RedisError
+from redis.exceptions import RedisClusterException, RedisError
 
-from .core import DataAccessCommands
+from .core import ACLCommands, DataAccessCommands, ManagementCommands, PubSubCommands
 from .helpers import list_or_args
 
 
@@ -144,451 +144,31 @@ def unlink(self, *keys):
         return self._split_command_across_slots("UNLINK", *keys)
 
 
-class ClusterManagementCommands:
+class ClusterManagementCommands(ManagementCommands):
     """
-    Redis Cluster management commands
+    A class for Redis Cluster management commands
 
-    Commands with the 'target_nodes' argument can be executed on specified
-    nodes. By default, if target_nodes is not specified, the command will be
-    executed on the default cluster node.
-
-    :param :target_nodes: type can be one of the followings:
-        - nodes flag: 'all', 'primaries', 'replicas', 'random'
-        - 'ClusterNode'
-        - 'list(ClusterNodes)'
-        - 'dict(any:clusterNodes)'
-
-    for example:
-        primary = r.get_primaries()[0]
-        r.bgsave(target_nodes=primary)
-        r.bgsave(target_nodes='primaries')
+    The class inherits from Redis's core ManagementCommands class and do the
+    required adjustments to work with cluster mode
     """
 
-    def bgsave(self, schedule=True, target_nodes=None):
-        """
-        Tell the Redis server to save its data to disk.  Unlike save(),
-        this method is asynchronous and returns immediately.
-        """
-        pieces = []
-        if schedule:
-            pieces.append("SCHEDULE")
-        return self.execute_command("BGSAVE", *pieces, target_nodes=target_nodes)
-
-    def client_getname(self, target_nodes=None):
-        """
-        Returns the current connection name from all nodes.
-        The result will be a dictionary with the IP and
-        connection name.
-        """
-        return self.execute_command("CLIENT GETNAME", target_nodes=target_nodes)
-
-    def client_getredir(self, target_nodes=None):
-        """Returns the ID (an integer) of the client to whom we are
-        redirecting tracking notifications.
-
-        see: https://redis.io/commands/client-getredir
-        """
-        return self.execute_command("CLIENT GETREDIR", target_nodes=target_nodes)
-
-    def client_id(self, target_nodes=None):
-        """Returns the current connection id"""
-        return self.execute_command("CLIENT ID", target_nodes=target_nodes)
-
-    def client_info(self, target_nodes=None):
-        """
-        Returns information and statistics about the current
-        client connection.
-        """
-        return self.execute_command("CLIENT INFO", target_nodes=target_nodes)
-
-    def client_kill_filter(
-        self,
-        _id=None,
-        _type=None,
-        addr=None,
-        skipme=None,
-        laddr=None,
-        user=None,
-        target_nodes=None,
-    ):
-        """
-        Disconnects client(s) using a variety of filter options
-        :param id: Kills a client by its unique ID field
-        :param type: Kills a client by type where type is one of 'normal',
-        'master', 'slave' or 'pubsub'
-        :param addr: Kills a client by its 'address:port'
-        :param skipme: If True, then the client calling the command
-        will not get killed even if it is identified by one of the filter
-        options. If skipme is not provided, the server defaults to skipme=True
-        :param laddr: Kills a client by its 'local (bind) address:port'
-        :param user: Kills a client for a specific user name
-        """
-        args = []
-        if _type is not None:
-            client_types = ("normal", "master", "slave", "pubsub")
-            if str(_type).lower() not in client_types:
-                raise DataError(f"CLIENT KILL type must be one of {client_types!r}")
-            args.extend((b"TYPE", _type))
-        if skipme is not None:
-            if not isinstance(skipme, bool):
-                raise DataError("CLIENT KILL skipme must be a bool")
-            if skipme:
-                args.extend((b"SKIPME", b"YES"))
-            else:
-                args.extend((b"SKIPME", b"NO"))
-        if _id is not None:
-            args.extend((b"ID", _id))
-        if addr is not None:
-            args.extend((b"ADDR", addr))
-        if laddr is not None:
-            args.extend((b"LADDR", laddr))
-        if user is not None:
-            args.extend((b"USER", user))
-        if not args:
-            raise DataError(
-                "CLIENT KILL <filter> <value> ... ... <filter> "
-                "<value> must specify at least one filter"
-            )
-        return self.execute_command("CLIENT KILL", *args, target_nodes=target_nodes)
-
-    def client_kill(self, address, target_nodes=None):
-        "Disconnects the client at ``address`` (ip:port)"
-        return self.execute_command("CLIENT KILL", address, target_nodes=target_nodes)
-
-    def client_list(self, _type=None, target_nodes=None):
-        """
-        Returns a list of currently connected clients to the entire cluster.
-        If type of client specified, only that type will be returned.
-        :param _type: optional. one of the client types (normal, master,
-         replica, pubsub)
-        """
-        if _type is not None:
-            client_types = ("normal", "master", "replica", "pubsub")
-            if str(_type).lower() not in client_types:
-                raise DataError(f"CLIENT LIST _type must be one of {client_types!r}")
-            return self.execute_command(
-                "CLIENT LIST", b"TYPE", _type, target_noes=target_nodes
-            )
-        return self.execute_command("CLIENT LIST", target_nodes=target_nodes)
-
-    def client_pause(self, timeout, target_nodes=None):
-        """
-        Suspend all the Redis clients for the specified amount of time
-        :param timeout: milliseconds to pause clients
-        """
-        if not isinstance(timeout, int):
-            raise DataError("CLIENT PAUSE timeout must be an integer")
-        return self.execute_command(
-            "CLIENT PAUSE", str(timeout), target_nodes=target_nodes
-        )
-
-    def client_reply(self, reply, target_nodes=None):
-        """Enable and disable redis server replies.
-        ``reply`` Must be ON OFF or SKIP,
-            ON - The default most with server replies to commands
-            OFF - Disable server responses to commands
-            SKIP - Skip the response of the immediately following command.
-
-        Note: When setting OFF or SKIP replies, you will need a client object
-        with a timeout specified in seconds, and will need to catch the
-        TimeoutError.
-              The test_client_reply unit test illustrates this, and
-              conftest.py has a client with a timeout.
-        See https://redis.io/commands/client-reply
-        """
-        replies = ["ON", "OFF", "SKIP"]
-        if reply not in replies:
-            raise DataError(f"CLIENT REPLY must be one of {replies!r}")
-        return self.execute_command("CLIENT REPLY", reply, target_nodes=target_nodes)
-
-    def client_setname(self, name, target_nodes=None):
-        "Sets the current connection name"
-        return self.execute_command("CLIENT SETNAME", name, target_nodes=target_nodes)
-
-    def client_trackinginfo(self, target_nodes=None):
-        """
-        Returns the information about the current client connection's
-        use of the server assisted client side cache.
-        See https://redis.io/commands/client-trackinginfo
-        """
-        return self.execute_command("CLIENT TRACKINGINFO", target_nodes=target_nodes)
-
-    def client_unblock(self, client_id, error=False, target_nodes=None):
-        """
-        Unblocks a connection by its client id.
-        If ``error`` is True, unblocks the client with a special error message.
-        If ``error`` is False (default), the client is unblocked using the
-        regular timeout mechanism.
-        """
-        args = ["CLIENT UNBLOCK", int(client_id)]
-        if error:
-            args.append(b"ERROR")
-        return self.execute_command(*args, target_nodes=target_nodes)
-
-    def client_unpause(self, target_nodes=None):
-        """
-        Unpause all redis clients
-        """
-        return self.execute_command("CLIENT UNPAUSE", target_nodes=target_nodes)
-
-    def command(self, target_nodes=None):
-        """
-        Returns dict reply of details about all Redis commands.
-        """
-        return self.execute_command("COMMAND", target_nodes=target_nodes)
-
-    def command_count(self, target_nodes=None):
-        """
-        Returns Integer reply of number of total commands in this Redis server.
-        """
-        return self.execute_command("COMMAND COUNT", target_nodes=target_nodes)
-
-    def config_get(self, pattern="*", target_nodes=None):
-        """
-        Return a dictionary of configuration based on the ``pattern``
-        """
-        return self.execute_command("CONFIG GET", pattern, target_nodes=target_nodes)
-
-    def config_resetstat(self, target_nodes=None):
-        """Reset runtime statistics"""
-        return self.execute_command("CONFIG RESETSTAT", target_nodes=target_nodes)
-
-    def config_rewrite(self, target_nodes=None):
-        """
-        Rewrite config file with the minimal change to reflect running config.
-        """
-        return self.execute_command("CONFIG REWRITE", target_nodes=target_nodes)
-
-    def config_set(self, name, value, target_nodes=None):
-        "Set config item ``name`` with ``value``"
-        return self.execute_command(
-            "CONFIG SET", name, value, target_nodes=target_nodes
-        )
-
-    def dbsize(self, target_nodes=None):
-        """
-        Sums the number of keys in the target nodes' DB.
-
-        :target_nodes: 'ClusterNode' or 'list(ClusterNodes)'
-            The node/s to execute the command on
-        """
-        return self.execute_command("DBSIZE", target_nodes=target_nodes)
-
-    def debug_object(self, key):
-        raise NotImplementedError(
-            "DEBUG OBJECT is intentionally not implemented in the client."
-        )
-
-    def debug_segfault(self):
-        raise NotImplementedError(
-            "DEBUG SEGFAULT is intentionally not implemented in the client."
-        )
-
-    def echo(self, value, target_nodes):
-        """Echo the string back from the server"""
-        return self.execute_command("ECHO", value, target_nodes=target_nodes)
-
-    def flushall(self, asynchronous=False, target_nodes=None):
-        """
-        Delete all keys in the database.
-        In cluster mode this method is the same as flushdb
-
-        ``asynchronous`` indicates whether the operation is
-        executed asynchronously by the server.
-        """
-        args = []
-        if asynchronous:
-            args.append(b"ASYNC")
-        return self.execute_command("FLUSHALL", *args, target_nodes=target_nodes)
-
-    def flushdb(self, asynchronous=False, target_nodes=None):
-        """
-        Delete all keys in the database.
-
-        ``asynchronous`` indicates whether the operation is
-        executed asynchronously by the server.
-        """
-        args = []
-        if asynchronous:
-            args.append(b"ASYNC")
-        return self.execute_command("FLUSHDB", *args, target_nodes=target_nodes)
-
-    def info(self, section=None, target_nodes=None):
-        """
-        Returns a dictionary containing information about the Redis server
-
-        The ``section`` option can be used to select a specific section
-        of information
-
-        The section option is not supported by older versions of Redis Server,
-        and will generate ResponseError
-        """
-        if section is None:
-            return self.execute_command("INFO", target_nodes=target_nodes)
-        else:
-            return self.execute_command("INFO", section, target_nodes=target_nodes)
-
-    def keys(self, pattern="*", target_nodes=None):
-        "Returns a list of keys matching ``pattern``"
-        return self.execute_command("KEYS", pattern, target_nodes=target_nodes)
-
-    def lastsave(self, target_nodes=None):
-        """
-        Return a Python datetime object representing the last time the
-        Redis database was saved to disk
-        """
-        return self.execute_command("LASTSAVE", target_nodes=target_nodes)
-
-    def memory_doctor(self):
-        raise NotImplementedError(
-            "MEMORY DOCTOR is intentionally not implemented in the client."
-        )
-
-    def memory_help(self):
-        raise NotImplementedError(
-            "MEMORY HELP is intentionally not implemented in the client."
-        )
-
-    def memory_malloc_stats(self, target_nodes=None):
-        """Return an internal statistics report from the memory allocator."""
-        return self.execute_command("MEMORY MALLOC-STATS", target_nodes=target_nodes)
-
-    def memory_purge(self, target_nodes=None):
-        """Attempts to purge dirty pages for reclamation by allocator"""
-        return self.execute_command("MEMORY PURGE", target_nodes=target_nodes)
+    def slaveof(self, *args, **kwargs):
+        raise RedisClusterException("SLAVEOF is not supported in cluster mode")
 
-    def memory_stats(self, target_nodes=None):
-        """Return a dictionary of memory stats"""
-        return self.execute_command("MEMORY STATS", target_nodes=target_nodes)
+    def replicaof(self, *args, **kwargs):
+        raise RedisClusterException("REPLICAOF is not supported in cluster" " mode")
 
-    def memory_usage(self, key, samples=None):
-        """
-        Return the total memory usage for key, its value and associated
-        administrative overheads.
-
-        For nested data structures, ``samples`` is the number of elements to
-        sample. If left unspecified, the server's default is 5. Use 0 to sample
-        all elements.
-        """
-        args = []
-        if isinstance(samples, int):
-            args.extend([b"SAMPLES", samples])
-        return self.execute_command("MEMORY USAGE", key, *args)
-
-    def object(self, infotype, key):
-        """Return the encoding, idletime, or refcount about the key"""
-        return self.execute_command("OBJECT", infotype, key, infotype=infotype)
-
-    def ping(self, target_nodes=None):
-        """
-        Ping the cluster's servers.
-        If no target nodes are specified, sent to all nodes and returns True if
-         the ping was successful across all nodes.
-        """
-        return self.execute_command("PING", target_nodes=target_nodes)
-
-    def randomkey(self, target_nodes=None):
-        """
-        Returns the name of a random key"
-        """
-        return self.execute_command("RANDOMKEY", target_nodes=target_nodes)
+    def swapdb(self, *args, **kwargs):
+        raise RedisClusterException("SWAPDB is not supported in cluster" " mode")
 
-    def save(self, target_nodes=None):
-        """
-        Tell the Redis server to save its data to disk,
-        blocking until the save is complete
-        """
-        return self.execute_command("SAVE", target_nodes=target_nodes)
-
-    def scan(self, cursor=0, match=None, count=None, _type=None, target_nodes=None):
-        """
-        Incrementally return lists of key names. Also return a cursor
-        indicating the scan position.
-
-        ``match`` allows for filtering the keys by pattern
-
-        ``count`` provides a hint to Redis about the number of keys to
-            return per batch.
-
-        ``_type`` filters the returned values by a particular Redis type.
-            Stock Redis instances allow for the following types:
-            HASH, LIST, SET, STREAM, STRING, ZSET
-            Additionally, Redis modules can expose other types as well.
-        """
-        pieces = [cursor]
-        if match is not None:
-            pieces.extend([b"MATCH", match])
-        if count is not None:
-            pieces.extend([b"COUNT", count])
-        if _type is not None:
-            pieces.extend([b"TYPE", _type])
-        return self.execute_command("SCAN", *pieces, target_nodes=target_nodes)
-
-    def scan_iter(self, match=None, count=None, _type=None, target_nodes=None):
-        """
-        Make an iterator using the SCAN command so that the client doesn't
-        need to remember the cursor position.
 
-        ``match`` allows for filtering the keys by pattern
-
-        ``count`` provides a hint to Redis about the number of keys to
-            return per batch.
+class ClusterDataAccessCommands(DataAccessCommands):
+    """
+    A class for Redis Cluster Data Access Commands
 
-        ``_type`` filters the returned values by a particular Redis type.
-            Stock Redis instances allow for the following types:
-            HASH, LIST, SET, STREAM, STRING, ZSET
-            Additionally, Redis modules can expose other types as well.
-        """
-        cursor = "0"
-        while cursor != 0:
-            cursor, data = self.scan(
-                cursor=cursor,
-                match=match,
-                count=count,
-                _type=_type,
-                target_nodes=target_nodes,
-            )
-            yield from data
-
-    def shutdown(self, save=False, nosave=False, target_nodes=None):
-        """Shutdown the Redis server.  If Redis has persistence configured,
-        data will be flushed before shutdown.  If the "save" option is set,
-        a data flush will be attempted even if there is no persistence
-        configured.  If the "nosave" option is set, no data flush will be
-        attempted.  The "save" and "nosave" options cannot both be set.
-        """
-        if save and nosave:
-            raise DataError("SHUTDOWN save and nosave cannot both be set")
-        args = ["SHUTDOWN"]
-        if save:
-            args.append("SAVE")
-        if nosave:
-            args.append("NOSAVE")
-        try:
-            self.execute_command(*args, target_nodes=target_nodes)
-        except ConnectionError:
-            # a ConnectionError here is expected
-            return
-        raise RedisError("SHUTDOWN seems to have failed.")
-
-    def slowlog_get(self, num=None, target_nodes=None):
-        """
-        Get the entries from the slowlog. If ``num`` is specified, get the
-        most recent ``num`` items.
-        """
-        args = ["SLOWLOG GET"]
-        if num is not None:
-            args.append(num)
-
-        return self.execute_command(*args, target_nodes=target_nodes)
-
-    def slowlog_len(self, target_nodes=None):
-        "Get the number of items in the slowlog"
-        return self.execute_command("SLOWLOG LEN", target_nodes=target_nodes)
-
-    def slowlog_reset(self, target_nodes=None):
-        "Remove all items in the slowlog"
-        return self.execute_command("SLOWLOG RESET", target_nodes=target_nodes)
+    The class inherits from Redis's core DataAccessCommand class and do the
+    required adjustments to work with cluster mode
+    """
 
     def stralgo(
         self,
@@ -600,138 +180,50 @@ def stralgo(
         idx=False,
         minmatchlen=None,
         withmatchlen=False,
-        target_nodes=None,
+        **kwargs,
     ):
-        """
-        Implements complex algorithms that operate on strings.
-        Right now the only algorithm implemented is the LCS algorithm
-        (longest common substring). However new algorithms could be
-        implemented in the future.
-
-        ``algo`` Right now must be LCS
-        ``value1`` and ``value2`` Can be two strings or two keys
-        ``specific_argument`` Specifying if the arguments to the algorithm
-        will be keys or strings. strings is the default.
-        ``len`` Returns just the len of the match.
-        ``idx`` Returns the match positions in each string.
-        ``minmatchlen`` Restrict the list of matches to the ones of a given
-        minimal length. Can be provided only when ``idx`` set to True.
-        ``withmatchlen`` Returns the matches with the len of the match.
-        Can be provided only when ``idx`` set to True.
-        """
-        # check validity
-        supported_algo = ["LCS"]
-        if algo not in supported_algo:
-            supported_algos_str = ", ".join(supported_algo)
-            raise DataError(f"The supported algorithms are: {supported_algos_str}")
-        if specific_argument not in ["keys", "strings"]:
-            raise DataError("specific_argument can be only keys or strings")
-        if len and idx:
-            raise DataError("len and idx cannot be provided together.")
-
-        pieces = [algo, specific_argument.upper(), value1, value2]
-        if len:
-            pieces.append(b"LEN")
-        if idx:
-            pieces.append(b"IDX")
-        try:
-            int(minmatchlen)
-            pieces.extend([b"MINMATCHLEN", minmatchlen])
-        except TypeError:
-            pass
-        if withmatchlen:
-            pieces.append(b"WITHMATCHLEN")
+        target_nodes = kwargs.pop("target_nodes", None)
         if specific_argument == "strings" and target_nodes is None:
             target_nodes = "default-node"
-        return self.execute_command(
-            "STRALGO",
-            *pieces,
-            len=len,
-            idx=idx,
-            minmatchlen=minmatchlen,
-            withmatchlen=withmatchlen,
-            target_nodes=target_nodes,
-        )
-
-    def time(self, target_nodes=None):
-        """
-        Returns the server time as a 2-item tuple of ints:
-        (seconds since epoch, microseconds into this second).
-        """
-        return self.execute_command("TIME", target_nodes=target_nodes)
-
-    def wait(self, num_replicas, timeout, target_nodes=None):
-        """
-        Redis synchronous replication
-        That returns the number of replicas that processed the query when
-        we finally have at least ``num_replicas``, or when the ``timeout`` was
-        reached.
-
-        If more than one target node are passed the result will be summed up
-        """
-        return self.execute_command(
-            "WAIT", num_replicas, timeout, target_nodes=target_nodes
+        kwargs.update({"target_nodes": target_nodes})
+        return super().stralgo(
+            algo,
+            value1,
+            value2,
+            specific_argument,
+            len,
+            idx,
+            minmatchlen,
+            withmatchlen,
+            **kwargs,
         )
 
 
-class ClusterPubSubCommands:
-    """
-    Redis PubSub commands for RedisCluster use.
-    see https://redis.io/topics/pubsub
-    """
-
-    def publish(self, channel, message, target_nodes=None):
-        """
-        Publish ``message`` on ``channel``.
-        Returns the number of subscribers the message was delivered to.
-        """
-        return self.execute_command(
-            "PUBLISH", channel, message, target_nodes=target_nodes
-        )
-
-    def pubsub_channels(self, pattern="*", target_nodes=None):
-        """
-        Return a list of channels that have at least one subscriber
-        """
-        return self.execute_command(
-            "PUBSUB CHANNELS", pattern, target_nodes=target_nodes
-        )
-
-    def pubsub_numpat(self, target_nodes=None):
-        """
-        Returns the number of subscriptions to patterns
-        """
-        return self.execute_command("PUBSUB NUMPAT", target_nodes=target_nodes)
-
-    def pubsub_numsub(self, *args, target_nodes=None):
-        """
-        Return a list of (channel, number of subscribers) tuples
-        for each channel given in ``*args``
-        """
-        return self.execute_command("PUBSUB NUMSUB", *args, target_nodes=target_nodes)
-
-
-class ClusterCommands(
-    ClusterManagementCommands,
+class RedisClusterCommands(
     ClusterMultiKeyCommands,
-    ClusterPubSubCommands,
-    DataAccessCommands,
+    ClusterManagementCommands,
+    ACLCommands,
+    PubSubCommands,
+    ClusterDataAccessCommands,
 ):
     """
-    Redis Cluster commands
+    A class for all Redis Cluster commands
+
+    For key-based commands, the target node(s) will be internally determined
+    by the keys' hash slot.
+    Non-key-based commands can be executed with the 'target_nodes' argument to
+    target specific nodes. By default, if target_nodes is not specified, the
+    command will be executed on the default cluster node.
 
-    Commands with the 'target_nodes' argument can be executed on specified
-    nodes. By default, if target_nodes is not specified, the command will be
-    executed on the default cluster node.
 
     :param :target_nodes: type can be one of the followings:
-        - nodes flag: 'all', 'primaries', 'replicas', 'random'
+        - nodes flag: ALL_NODES, PRIMARIES, REPLICAS, RANDOM
         - 'ClusterNode'
         - 'list(ClusterNodes)'
         - 'dict(any:clusterNodes)'
 
     for example:
-        r.cluster_info(target_nodes='all')
+        r.cluster_info(target_nodes=RedisCluster.ALL_NODES)
     """
 
     def cluster_addslots(self, target_node, *slots):
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 688e1dda1b..462fba7f82 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -14,7 +14,7 @@ class ACLCommands:
     see: https://redis.io/topics/acl
     """
 
-    def acl_cat(self, category=None):
+    def acl_cat(self, category=None, **kwargs):
         """
         Returns a list of categories or commands within a category.
 
@@ -25,17 +25,17 @@ def acl_cat(self, category=None):
         For more information check https://redis.io/commands/acl-cat
         """
         pieces = [category] if category else []
-        return self.execute_command("ACL CAT", *pieces)
+        return self.execute_command("ACL CAT", *pieces, **kwargs)
 
-    def acl_deluser(self, *username):
+    def acl_deluser(self, *username, **kwargs):
         """
         Delete the ACL for the specified ``username``s
 
         For more information check https://redis.io/commands/acl-deluser
         """
-        return self.execute_command("ACL DELUSER", *username)
+        return self.execute_command("ACL DELUSER", *username, **kwargs)
 
-    def acl_genpass(self, bits=None):
+    def acl_genpass(self, bits=None, **kwargs):
         """Generate a random password value.
         If ``bits`` is supplied then use this number of bits, rounded to
         the next multiple of 4.
@@ -51,9 +51,9 @@ def acl_genpass(self, bits=None):
                 raise DataError(
                     "genpass optionally accepts a bits argument, " "between 0 and 4096."
                 )
-        return self.execute_command("ACL GENPASS", *pieces)
+        return self.execute_command("ACL GENPASS", *pieces, **kwargs)
 
-    def acl_getuser(self, username):
+    def acl_getuser(self, username, **kwargs):
         """
         Get the ACL details for the specified ``username``.
 
@@ -61,25 +61,25 @@ def acl_getuser(self, username):
 
         For more information check https://redis.io/commands/acl-getuser
         """
-        return self.execute_command("ACL GETUSER", username)
+        return self.execute_command("ACL GETUSER", username, **kwargs)
 
-    def acl_help(self):
+    def acl_help(self, **kwargs):
         """The ACL HELP command returns helpful text describing
         the different subcommands.
 
         For more information check https://redis.io/commands/acl-help
         """
-        return self.execute_command("ACL HELP")
+        return self.execute_command("ACL HELP", **kwargs)
 
-    def acl_list(self):
+    def acl_list(self, **kwargs):
         """
         Return a list of all ACLs on the server
 
         For more information check https://redis.io/commands/acl-list
         """
-        return self.execute_command("ACL LIST")
+        return self.execute_command("ACL LIST", **kwargs)
 
-    def acl_log(self, count=None):
+    def acl_log(self, count=None, **kwargs):
         """
         Get ACL logs as a list.
         :param int count: Get logs[0:count].
@@ -93,9 +93,9 @@ def acl_log(self, count=None):
                 raise DataError("ACL LOG count must be an " "integer")
             args.append(count)
 
-        return self.execute_command("ACL LOG", *args)
+        return self.execute_command("ACL LOG", *args, **kwargs)
 
-    def acl_log_reset(self):
+    def acl_log_reset(self, **kwargs):
         """
         Reset ACL logs.
         :rtype: Boolean.
@@ -103,9 +103,9 @@ def acl_log_reset(self):
         For more information check https://redis.io/commands/acl-log
         """
         args = [b"RESET"]
-        return self.execute_command("ACL LOG", *args)
+        return self.execute_command("ACL LOG", *args, **kwargs)
 
-    def acl_load(self):
+    def acl_load(self, **kwargs):
         """
         Load ACL rules from the configured ``aclfile``.
 
@@ -114,9 +114,9 @@ def acl_load(self):
 
         For more information check https://redis.io/commands/acl-load
         """
-        return self.execute_command("ACL LOAD")
+        return self.execute_command("ACL LOAD", **kwargs)
 
-    def acl_save(self):
+    def acl_save(self, **kwargs):
         """
         Save ACL rules to the configured ``aclfile``.
 
@@ -125,7 +125,7 @@ def acl_save(self):
 
         For more information check https://redis.io/commands/acl-save
         """
-        return self.execute_command("ACL SAVE")
+        return self.execute_command("ACL SAVE", **kwargs)
 
     def acl_setuser(
         self,
@@ -140,6 +140,7 @@ def acl_setuser(
         reset=False,
         reset_keys=False,
         reset_passwords=False,
+        **kwargs,
     ):
         """
         Create or update an ACL user.
@@ -202,7 +203,7 @@ def acl_setuser(
 
         For more information check https://redis.io/commands/acl-setuser
         """
-        encoder = self.connection_pool.get_encoder()
+        encoder = self.get_encoder()
         pieces = [username]
 
         if reset:
@@ -291,21 +292,21 @@ def acl_setuser(
                 key = encoder.encode(key)
                 pieces.append(b"~%s" % key)
 
-        return self.execute_command("ACL SETUSER", *pieces)
+        return self.execute_command("ACL SETUSER", *pieces, **kwargs)
 
-    def acl_users(self):
+    def acl_users(self, **kwargs):
         """Returns a list of all registered users on the server.
 
         For more information check https://redis.io/commands/acl-users
         """
-        return self.execute_command("ACL USERS")
+        return self.execute_command("ACL USERS", **kwargs)
 
-    def acl_whoami(self):
+    def acl_whoami(self, **kwargs):
         """Get the username for the current connection
 
         For more information check https://redis.io/commands/acl-whoami
         """
-        return self.execute_command("ACL WHOAMI")
+        return self.execute_command("ACL WHOAMI", **kwargs)
 
 
 class ManagementCommands:
@@ -313,14 +314,14 @@ class ManagementCommands:
     Redis management commands
     """
 
-    def bgrewriteaof(self):
+    def bgrewriteaof(self, **kwargs):
         """Tell the Redis server to rewrite the AOF file from data in memory.
 
         For more information check https://redis.io/commands/bgrewriteaof
         """
-        return self.execute_command("BGREWRITEAOF")
+        return self.execute_command("BGREWRITEAOF", **kwargs)
 
-    def bgsave(self, schedule=True):
+    def bgsave(self, schedule=True, **kwargs):
         """
         Tell the Redis server to save its data to disk.  Unlike save(),
         this method is asynchronous and returns immediately.
@@ -330,17 +331,24 @@ def bgsave(self, schedule=True):
         pieces = []
         if schedule:
             pieces.append("SCHEDULE")
-        return self.execute_command("BGSAVE", *pieces)
+        return self.execute_command("BGSAVE", *pieces, **kwargs)
 
-    def client_kill(self, address):
+    def client_kill(self, address, **kwargs):
         """Disconnects the client at ``address`` (ip:port)
 
         For more information check https://redis.io/commands/client-kill
         """
-        return self.execute_command("CLIENT KILL", address)
+        return self.execute_command("CLIENT KILL", address, **kwargs)
 
     def client_kill_filter(
-        self, _id=None, _type=None, addr=None, skipme=None, laddr=None, user=None
+        self,
+        _id=None,
+        _type=None,
+        addr=None,
+        skipme=None,
+        laddr=None,
+        user=None,
+        **kwargs,
     ):
         """
         Disconnects client(s) using a variety of filter options
@@ -380,18 +388,18 @@ def client_kill_filter(
                 "CLIENT KILL <filter> <value> ... ... <filter> "
                 "<value> must specify at least one filter"
             )
-        return self.execute_command("CLIENT KILL", *args)
+        return self.execute_command("CLIENT KILL", *args, **kwargs)
 
-    def client_info(self):
+    def client_info(self, **kwargs):
         """
         Returns information and statistics about the current
         client connection.
 
         For more information check https://redis.io/commands/client-info
         """
-        return self.execute_command("CLIENT INFO")
+        return self.execute_command("CLIENT INFO", **kwargs)
 
-    def client_list(self, _type=None, client_id=[]):
+    def client_list(self, _type=None, client_id=[], **kwargs):
         """
         Returns a list of currently connected clients.
         If type of client specified, only that type will be returned.
@@ -413,26 +421,26 @@ def client_list(self, _type=None, client_id=[]):
         if client_id != []:
             args.append(b"ID")
             args.append(" ".join(client_id))
-        return self.execute_command("CLIENT LIST", *args)
+        return self.execute_command("CLIENT LIST", *args, **kwargs)
 
-    def client_getname(self):
+    def client_getname(self, **kwargs):
         """
         Returns the current connection name
 
         For more information check https://redis.io/commands/client-getname
         """
-        return self.execute_command("CLIENT GETNAME")
+        return self.execute_command("CLIENT GETNAME", **kwargs)
 
-    def client_getredir(self):
+    def client_getredir(self, **kwargs):
         """
         Returns the ID (an integer) of the client to whom we are
         redirecting tracking notifications.
 
         see: https://redis.io/commands/client-getredir
         """
-        return self.execute_command("CLIENT GETREDIR")
+        return self.execute_command("CLIENT GETREDIR", **kwargs)
 
-    def client_reply(self, reply):
+    def client_reply(self, reply, **kwargs):
         """
         Enable and disable redis server replies.
         ``reply`` Must be ON OFF or SKIP,
@@ -451,34 +459,34 @@ def client_reply(self, reply):
         replies = ["ON", "OFF", "SKIP"]
         if reply not in replies:
             raise DataError(f"CLIENT REPLY must be one of {replies!r}")
-        return self.execute_command("CLIENT REPLY", reply)
+        return self.execute_command("CLIENT REPLY", reply, **kwargs)
 
-    def client_id(self):
+    def client_id(self, **kwargs):
         """
         Returns the current connection id
 
         For more information check https://redis.io/commands/client-id
         """
-        return self.execute_command("CLIENT ID")
+        return self.execute_command("CLIENT ID", **kwargs)
 
-    def client_trackinginfo(self):
+    def client_trackinginfo(self, **kwargs):
         """
         Returns the information about the current client connection's
         use of the server assisted client side cache.
 
         See https://redis.io/commands/client-trackinginfo
         """
-        return self.execute_command("CLIENT TRACKINGINFO")
+        return self.execute_command("CLIENT TRACKINGINFO", **kwargs)
 
-    def client_setname(self, name):
+    def client_setname(self, name, **kwargs):
         """
         Sets the current connection name
 
         For more information check https://redis.io/commands/client-setname
         """
-        return self.execute_command("CLIENT SETNAME", name)
+        return self.execute_command("CLIENT SETNAME", name, **kwargs)
 
-    def client_unblock(self, client_id, error=False):
+    def client_unblock(self, client_id, error=False, **kwargs):
         """
         Unblocks a connection by its client id.
         If ``error`` is True, unblocks the client with a special error message.
@@ -490,9 +498,9 @@ def client_unblock(self, client_id, error=False):
         args = ["CLIENT UNBLOCK", int(client_id)]
         if error:
             args.append(b"ERROR")
-        return self.execute_command(*args)
+        return self.execute_command(*args, **kwargs)
 
-    def client_pause(self, timeout):
+    def client_pause(self, timeout, **kwargs):
         """
         Suspend all the Redis clients for the specified amount of time
         :param timeout: milliseconds to pause clients
@@ -501,91 +509,80 @@ def client_pause(self, timeout):
         """
         if not isinstance(timeout, int):
             raise DataError("CLIENT PAUSE timeout must be an integer")
-        return self.execute_command("CLIENT PAUSE", str(timeout))
+        return self.execute_command("CLIENT PAUSE", str(timeout), **kwargs)
 
-    def client_unpause(self):
+    def client_unpause(self, **kwargs):
         """
         Unpause all redis clients
 
         For more information check https://redis.io/commands/client-unpause
         """
-        return self.execute_command("CLIENT UNPAUSE")
-
-    def command_info(self):
-        raise NotImplementedError(
-            "COMMAND INFO is intentionally not implemented in the client."
-        )
+        return self.execute_command("CLIENT UNPAUSE", **kwargs)
 
-    def command_count(self):
-        return self.execute_command("COMMAND COUNT")
-
-    def readwrite(self):
+    def command(self, **kwargs):
         """
-        Disables read queries for a connection to a Redis Cluster slave node.
+        Returns dict reply of details about all Redis commands.
 
-        For more information check https://redis.io/commands/readwrite
+        For more information check https://redis.io/commands/command
         """
-        return self.execute_command("READWRITE")
+        return self.execute_command("COMMAND", **kwargs)
 
-    def readonly(self):
-        """
-        Enables read queries for a connection to a Redis Cluster replica node.
+    def command_info(self, **kwargs):
+        raise NotImplementedError(
+            "COMMAND INFO is intentionally not implemented in the client."
+        )
 
-        For more information check https://redis.io/commands/readonly
-        """
-        return self.execute_command("READONLY")
+    def command_count(self, **kwargs):
+        return self.execute_command("COMMAND COUNT", **kwargs)
 
-    def config_get(self, pattern="*"):
+    def config_get(self, pattern="*", **kwargs):
         """
         Return a dictionary of configuration based on the ``pattern``
 
         For more information check https://redis.io/commands/config-get
         """
-        return self.execute_command("CONFIG GET", pattern)
+        return self.execute_command("CONFIG GET", pattern, **kwargs)
 
-    def config_set(self, name, value):
+    def config_set(self, name, value, **kwargs):
         """Set config item ``name`` with ``value``
 
         For more information check https://redis.io/commands/config-set
         """
-        return self.execute_command("CONFIG SET", name, value)
+        return self.execute_command("CONFIG SET", name, value, **kwargs)
 
-    def config_resetstat(self):
+    def config_resetstat(self, **kwargs):
         """
         Reset runtime statistics
 
         For more information check https://redis.io/commands/config-resetstat
         """
-        return self.execute_command("CONFIG RESETSTAT")
+        return self.execute_command("CONFIG RESETSTAT", **kwargs)
 
-    def config_rewrite(self):
+    def config_rewrite(self, **kwargs):
         """
         Rewrite config file with the minimal change to reflect running config.
 
         For more information check https://redis.io/commands/config-rewrite
         """
-        return self.execute_command("CONFIG REWRITE")
+        return self.execute_command("CONFIG REWRITE", **kwargs)
 
-    def cluster(self, cluster_arg, *args):
-        return self.execute_command(f"CLUSTER {cluster_arg.upper()}", *args)
-
-    def dbsize(self):
+    def dbsize(self, **kwargs):
         """
         Returns the number of keys in the current database
 
         For more information check https://redis.io/commands/dbsize
         """
-        return self.execute_command("DBSIZE")
+        return self.execute_command("DBSIZE", **kwargs)
 
-    def debug_object(self, key):
+    def debug_object(self, key, **kwargs):
         """
         Returns version specific meta information about a given key
 
         For more information check https://redis.io/commands/debug-object
         """
-        return self.execute_command("DEBUG OBJECT", key)
+        return self.execute_command("DEBUG OBJECT", key, **kwargs)
 
-    def debug_segfault(self):
+    def debug_segfault(self, **kwargs):
         raise NotImplementedError(
             """
             DEBUG SEGFAULT is intentionally not implemented in the client.
@@ -594,15 +591,15 @@ def debug_segfault(self):
             """
         )
 
-    def echo(self, value):
+    def echo(self, value, **kwargs):
         """
         Echo the string back from the server
 
         For more information check https://redis.io/commands/echo
         """
-        return self.execute_command("ECHO", value)
+        return self.execute_command("ECHO", value, **kwargs)
 
-    def flushall(self, asynchronous=False):
+    def flushall(self, asynchronous=False, **kwargs):
         """
         Delete all keys in all databases on the current host.
 
@@ -614,9 +611,9 @@ def flushall(self, asynchronous=False):
         args = []
         if asynchronous:
             args.append(b"ASYNC")
-        return self.execute_command("FLUSHALL", *args)
+        return self.execute_command("FLUSHALL", *args, **kwargs)
 
-    def flushdb(self, asynchronous=False):
+    def flushdb(self, asynchronous=False, **kwargs):
         """
         Delete all keys in the current database.
 
@@ -628,17 +625,17 @@ def flushdb(self, asynchronous=False):
         args = []
         if asynchronous:
             args.append(b"ASYNC")
-        return self.execute_command("FLUSHDB", *args)
+        return self.execute_command("FLUSHDB", *args, **kwargs)
 
-    def swapdb(self, first, second):
+    def swapdb(self, first, second, **kwargs):
         """
         Swap two databases
 
         For more information check https://redis.io/commands/swapdb
         """
-        return self.execute_command("SWAPDB", first, second)
+        return self.execute_command("SWAPDB", first, second, **kwargs)
 
-    def info(self, section=None):
+    def info(self, section=None, **kwargs):
         """
         Returns a dictionary containing information about the Redis server
 
@@ -651,29 +648,29 @@ def info(self, section=None):
         For more information check https://redis.io/commands/info
         """
         if section is None:
-            return self.execute_command("INFO")
+            return self.execute_command("INFO", **kwargs)
         else:
-            return self.execute_command("INFO", section)
+            return self.execute_command("INFO", section, **kwargs)
 
-    def lastsave(self):
+    def lastsave(self, **kwargs):
         """
         Return a Python datetime object representing the last time the
         Redis database was saved to disk
 
         For more information check https://redis.io/commands/lastsave
         """
-        return self.execute_command("LASTSAVE")
+        return self.execute_command("LASTSAVE", **kwargs)
 
-    def lolwut(self, *version_numbers):
+    def lolwut(self, *version_numbers, **kwargs):
         """
         Get the Redis version and a piece of generative computer art
 
         See: https://redis.io/commands/lolwut
         """
         if version_numbers:
-            return self.execute_command("LOLWUT VERSION", *version_numbers)
+            return self.execute_command("LOLWUT VERSION", *version_numbers, **kwargs)
         else:
-            return self.execute_command("LOLWUT")
+            return self.execute_command("LOLWUT", **kwargs)
 
     def migrate(
         self,
@@ -685,6 +682,7 @@ def migrate(
         copy=False,
         replace=False,
         auth=None,
+        **kwargs,
     ):
         """
         Migrate 1 or more keys from the current Redis server to a different
@@ -719,16 +717,18 @@ def migrate(
         pieces.append(b"KEYS")
         pieces.extend(keys)
         return self.execute_command(
-            "MIGRATE", host, port, "", destination_db, timeout, *pieces
+            "MIGRATE", host, port, "", destination_db, timeout, *pieces, **kwargs
         )
 
-    def object(self, infotype, key):
+    def object(self, infotype, key, **kwargs):
         """
         Return the encoding, idletime, or refcount about the key
         """
-        return self.execute_command("OBJECT", infotype, key, infotype=infotype)
+        return self.execute_command(
+            "OBJECT", infotype, key, infotype=infotype, **kwargs
+        )
 
-    def memory_doctor(self):
+    def memory_doctor(self, **kwargs):
         raise NotImplementedError(
             """
             MEMORY DOCTOR is intentionally not implemented in the client.
@@ -737,7 +737,7 @@ def memory_doctor(self):
             """
         )
 
-    def memory_help(self):
+    def memory_help(self, **kwargs):
         raise NotImplementedError(
             """
             MEMORY HELP is intentionally not implemented in the client.
@@ -746,23 +746,23 @@ def memory_help(self):
             """
         )
 
-    def memory_stats(self):
+    def memory_stats(self, **kwargs):
         """
         Return a dictionary of memory stats
 
         For more information check https://redis.io/commands/memory-stats
         """
-        return self.execute_command("MEMORY STATS")
+        return self.execute_command("MEMORY STATS", **kwargs)
 
-    def memory_malloc_stats(self):
+    def memory_malloc_stats(self, **kwargs):
         """
         Return an internal statistics report from the memory allocator.
 
         See: https://redis.io/commands/memory-malloc-stats
         """
-        return self.execute_command("MEMORY MALLOC-STATS")
+        return self.execute_command("MEMORY MALLOC-STATS", **kwargs)
 
-    def memory_usage(self, key, samples=None):
+    def memory_usage(self, key, samples=None, **kwargs):
         """
         Return the total memory usage for key, its value and associated
         administrative overheads.
@@ -776,33 +776,33 @@ def memory_usage(self, key, samples=None):
         args = []
         if isinstance(samples, int):
             args.extend([b"SAMPLES", samples])
-        return self.execute_command("MEMORY USAGE", key, *args)
+        return self.execute_command("MEMORY USAGE", key, *args, **kwargs)
 
-    def memory_purge(self):
+    def memory_purge(self, **kwargs):
         """
         Attempts to purge dirty pages for reclamation by allocator
 
         For more information check https://redis.io/commands/memory-purge
         """
-        return self.execute_command("MEMORY PURGE")
+        return self.execute_command("MEMORY PURGE", **kwargs)
 
-    def ping(self):
+    def ping(self, **kwargs):
         """
         Ping the Redis server
 
         For more information check https://redis.io/commands/ping
         """
-        return self.execute_command("PING")
+        return self.execute_command("PING", **kwargs)
 
-    def quit(self):
+    def quit(self, **kwargs):
         """
         Ask the server to close the connection.
 
         For more information check https://redis.io/commands/quit
         """
-        return self.execute_command("QUIT")
+        return self.execute_command("QUIT", **kwargs)
 
-    def replicaof(self, *args):
+    def replicaof(self, *args, **kwargs):
         """
         Update the replication settings of a redis replica, on the fly.
         Examples of valid arguments include:
@@ -811,18 +811,18 @@ def replicaof(self, *args):
 
         For more information check  https://redis.io/commands/replicaof
         """
-        return self.execute_command("REPLICAOF", *args)
+        return self.execute_command("REPLICAOF", *args, **kwargs)
 
-    def save(self):
+    def save(self, **kwargs):
         """
         Tell the Redis server to save its data to disk,
         blocking until the save is complete
 
         For more information check https://redis.io/commands/save
         """
-        return self.execute_command("SAVE")
+        return self.execute_command("SAVE", **kwargs)
 
-    def shutdown(self, save=False, nosave=False):
+    def shutdown(self, save=False, nosave=False, **kwargs):
         """Shutdown the Redis server.  If Redis has persistence configured,
         data will be flushed before shutdown.  If the "save" option is set,
         a data flush will be attempted even if there is no persistence
@@ -839,13 +839,13 @@ def shutdown(self, save=False, nosave=False):
         if nosave:
             args.append("NOSAVE")
         try:
-            self.execute_command(*args)
+            self.execute_command(*args, **kwargs)
         except ConnectionError:
             # a ConnectionError here is expected
             return
         raise RedisError("SHUTDOWN seems to have failed.")
 
-    def slaveof(self, host=None, port=None):
+    def slaveof(self, host=None, port=None, **kwargs):
         """
         Set the server to be a replicated slave of the instance identified
         by the ``host`` and ``port``. If called without arguments, the
@@ -854,10 +854,10 @@ def slaveof(self, host=None, port=None):
         For more information check https://redis.io/commands/slaveof
         """
         if host is None and port is None:
-            return self.execute_command("SLAVEOF", b"NO", b"ONE")
-        return self.execute_command("SLAVEOF", host, port)
+            return self.execute_command("SLAVEOF", b"NO", b"ONE", **kwargs)
+        return self.execute_command("SLAVEOF", host, port, **kwargs)
 
-    def slowlog_get(self, num=None):
+    def slowlog_get(self, num=None, **kwargs):
         """
         Get the entries from the slowlog. If ``num`` is specified, get the
         most recent ``num`` items.
@@ -867,37 +867,35 @@ def slowlog_get(self, num=None):
         args = ["SLOWLOG GET"]
         if num is not None:
             args.append(num)
-        decode_responses = self.connection_pool.connection_kwargs.get(
-            "decode_responses", False
-        )
-        return self.execute_command(*args, decode_responses=decode_responses)
+        decode_responses = self.get_connection_kwargs().get("decode_responses", False)
+        return self.execute_command(*args, decode_responses=decode_responses, **kwargs)
 
-    def slowlog_len(self):
+    def slowlog_len(self, **kwargs):
         """
         Get the number of items in the slowlog
 
         For more information check https://redis.io/commands/slowlog-len
         """
-        return self.execute_command("SLOWLOG LEN")
+        return self.execute_command("SLOWLOG LEN", **kwargs)
 
-    def slowlog_reset(self):
+    def slowlog_reset(self, **kwargs):
         """
         Remove all items in the slowlog
 
         For more information check https://redis.io/commands/slowlog-reset
         """
-        return self.execute_command("SLOWLOG RESET")
+        return self.execute_command("SLOWLOG RESET", **kwargs)
 
-    def time(self):
+    def time(self, **kwargs):
         """
         Returns the server time as a 2-item tuple of ints:
         (seconds since epoch, microseconds into this second).
 
         For more information check https://redis.io/commands/time
         """
-        return self.execute_command("TIME")
+        return self.execute_command("TIME", **kwargs)
 
-    def wait(self, num_replicas, timeout):
+    def wait(self, num_replicas, timeout, **kwargs):
         """
         Redis synchronous replication
         That returns the number of replicas that processed the query when
@@ -906,7 +904,7 @@ def wait(self, num_replicas, timeout):
 
         For more information check https://redis.io/commands/wait
         """
-        return self.execute_command("WAIT", num_replicas, timeout)
+        return self.execute_command("WAIT", num_replicas, timeout, **kwargs)
 
 
 class BasicKeyCommands:
@@ -1218,13 +1216,13 @@ def incrbyfloat(self, name, amount=1.0):
         """
         return self.execute_command("INCRBYFLOAT", name, amount)
 
-    def keys(self, pattern="*"):
+    def keys(self, pattern="*", **kwargs):
         """
         Returns a list of keys matching ``pattern``
 
         For more information check https://redis.io/commands/keys
         """
-        return self.execute_command("KEYS", pattern)
+        return self.execute_command("KEYS", pattern, **kwargs)
 
     def lmove(self, first_list, second_list, src="LEFT", dest="RIGHT"):
         """
@@ -1370,13 +1368,13 @@ def hrandfield(self, key, count=None, withvalues=False):
 
         return self.execute_command("HRANDFIELD", key, *params)
 
-    def randomkey(self):
+    def randomkey(self, **kwargs):
         """
         Returns the name of a random key
 
         For more information check https://redis.io/commands/randomkey
         """
-        return self.execute_command("RANDOMKEY")
+        return self.execute_command("RANDOMKEY", **kwargs)
 
     def rename(self, src, dst):
         """
@@ -1587,6 +1585,7 @@ def stralgo(
         idx=False,
         minmatchlen=None,
         withmatchlen=False,
+        **kwargs,
     ):
         """
         Implements complex algorithms that operate on strings.
@@ -1637,6 +1636,7 @@ def stralgo(
             idx=idx,
             minmatchlen=minmatchlen,
             withmatchlen=withmatchlen,
+            **kwargs,
         )
 
     def strlen(self, name):
@@ -2028,7 +2028,7 @@ class ScanCommands:
     see: https://redis.io/commands/scan
     """
 
-    def scan(self, cursor=0, match=None, count=None, _type=None):
+    def scan(self, cursor=0, match=None, count=None, _type=None, **kwargs):
         """
         Incrementally return lists of key names. Also return a cursor
         indicating the scan position.
@@ -2052,9 +2052,9 @@ def scan(self, cursor=0, match=None, count=None, _type=None):
             pieces.extend([b"COUNT", count])
         if _type is not None:
             pieces.extend([b"TYPE", _type])
-        return self.execute_command("SCAN", *pieces)
+        return self.execute_command("SCAN", *pieces, **kwargs)
 
-    def scan_iter(self, match=None, count=None, _type=None):
+    def scan_iter(self, match=None, count=None, _type=None, **kwargs):
         """
         Make an iterator using the SCAN command so that the client doesn't
         need to remember the cursor position.
@@ -2072,7 +2072,7 @@ def scan_iter(self, match=None, count=None, _type=None):
         cursor = "0"
         while cursor != 0:
             cursor, data = self.scan(
-                cursor=cursor, match=match, count=count, _type=_type
+                cursor=cursor, match=match, count=count, _type=_type, **kwargs
             )
             yield from data
 
@@ -3677,39 +3677,39 @@ class PubSubCommands:
     see https://redis.io/topics/pubsub
     """
 
-    def publish(self, channel, message):
+    def publish(self, channel, message, **kwargs):
         """
         Publish ``message`` on ``channel``.
         Returns the number of subscribers the message was delivered to.
 
         For more information check https://redis.io/commands/publish
         """
-        return self.execute_command("PUBLISH", channel, message)
+        return self.execute_command("PUBLISH", channel, message, **kwargs)
 
-    def pubsub_channels(self, pattern="*"):
+    def pubsub_channels(self, pattern="*", **kwargs):
         """
         Return a list of channels that have at least one subscriber
 
         For more information check https://redis.io/commands/pubsub-channels
         """
-        return self.execute_command("PUBSUB CHANNELS", pattern)
+        return self.execute_command("PUBSUB CHANNELS", pattern, **kwargs)
 
-    def pubsub_numpat(self):
+    def pubsub_numpat(self, **kwargs):
         """
         Returns the number of subscriptions to patterns
 
         For more information check https://redis.io/commands/pubsub-numpat
         """
-        return self.execute_command("PUBSUB NUMPAT")
+        return self.execute_command("PUBSUB NUMPAT", **kwargs)
 
-    def pubsub_numsub(self, *args):
+    def pubsub_numsub(self, *args, **kwargs):
         """
         Return a list of (channel, number of subscribers) tuples
         for each channel given in ``*args``
 
         For more information check https://redis.io/commands/pubsub-numsub
         """
-        return self.execute_command("PUBSUB NUMSUB", *args)
+        return self.execute_command("PUBSUB NUMSUB", *args, **kwargs)
 
 
 class ScriptCommands:
@@ -4399,16 +4399,41 @@ def execute(self):
         return self.client.execute_command(*command)
 
 
+class ClusterCommands:
+    """
+    Class for Redis Cluster commands
+    """
+
+    def cluster(self, cluster_arg, *args, **kwargs):
+        return self.execute_command(f"CLUSTER {cluster_arg.upper()}", *args, **kwargs)
+
+    def readwrite(self, **kwargs):
+        """
+        Disables read queries for a connection to a Redis Cluster slave node.
+
+        For more information check https://redis.io/commands/readwrite
+        """
+        return self.execute_command("READWRITE", **kwargs)
+
+    def readonly(self, **kwargs):
+        """
+        Enables read queries for a connection to a Redis Cluster replica node.
+
+        For more information check https://redis.io/commands/readonly
+        """
+        return self.execute_command("READONLY", **kwargs)
+
+
 class DataAccessCommands(
     BasicKeyCommands,
+    HyperlogCommands,
+    HashCommands,
+    GeoCommands,
     ListCommands,
     ScanCommands,
     SetCommands,
     StreamCommands,
     SortedSetCommands,
-    HyperlogCommands,
-    HashCommands,
-    GeoCommands,
 ):
     """
     A class containing all of the implemented data access redis commands.
@@ -4418,6 +4443,7 @@ class DataAccessCommands(
 
 class CoreCommands(
     ACLCommands,
+    ClusterCommands,
     DataAccessCommands,
     ManagementCommands,
     ModuleCommands,
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 84d74bd43b..b76ed80958 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -24,13 +24,19 @@
     ClusterDownError,
     DataError,
     MovedError,
+    NoPermissionError,
     RedisClusterException,
     RedisError,
 )
 from redis.utils import str_if_bytes
 from tests.test_pubsub import wait_for_message
 
-from .conftest import _get_client, skip_if_server_version_lt, skip_unless_arch_bits
+from .conftest import (
+    _get_client,
+    skip_if_redis_enterprise,
+    skip_if_server_version_lt,
+    skip_unless_arch_bits,
+)
 
 default_host = "127.0.0.1"
 default_port = 7000
@@ -265,7 +271,7 @@ def test_execute_command_node_flag_primaries(self, r):
         primaries = r.get_primaries()
         replicas = r.get_replicas()
         mock_all_nodes_resp(r, "PONG")
-        assert r.ping(RedisCluster.PRIMARIES) is True
+        assert r.ping(target_nodes=RedisCluster.PRIMARIES) is True
         for primary in primaries:
             conn = primary.redis_connection.connection
             assert conn.read_response.called is True
@@ -282,7 +288,7 @@ def test_execute_command_node_flag_replicas(self, r):
             r = get_mocked_redis_client(default_host, default_port)
         primaries = r.get_primaries()
         mock_all_nodes_resp(r, "PONG")
-        assert r.ping(RedisCluster.REPLICAS) is True
+        assert r.ping(target_nodes=RedisCluster.REPLICAS) is True
         for replica in replicas:
             conn = replica.redis_connection.connection
             assert conn.read_response.called is True
@@ -295,7 +301,7 @@ def test_execute_command_node_flag_all_nodes(self, r):
         Test command execution with nodes flag ALL_NODES
         """
         mock_all_nodes_resp(r, "PONG")
-        assert r.ping(RedisCluster.ALL_NODES) is True
+        assert r.ping(target_nodes=RedisCluster.ALL_NODES) is True
         for node in r.get_nodes():
             conn = node.redis_connection.connection
             assert conn.read_response.called is True
@@ -305,7 +311,7 @@ def test_execute_command_node_flag_random(self, r):
         Test command execution with nodes flag RANDOM
         """
         mock_all_nodes_resp(r, "PONG")
-        assert r.ping(RedisCluster.RANDOM) is True
+        assert r.ping(target_nodes=RedisCluster.RANDOM) is True
         called_count = 0
         for node in r.get_nodes():
             conn = node.redis_connection.connection
@@ -1135,7 +1141,7 @@ def test_lastsave(self, r):
 
     def test_cluster_echo(self, r):
         node = r.get_primaries()[0]
-        assert r.echo("foo bar", node) == b"foo bar"
+        assert r.echo("foo bar", target_nodes=node) == b"foo bar"
 
     @skip_if_server_version_lt("1.0.0")
     def test_debug_segfault(self, r):
@@ -1764,6 +1770,51 @@ def test_cluster_randomkey(self, r):
             r[key] = 1
         assert r.randomkey(target_nodes=node) in (b"{foo}a", b"{foo}b", b"{foo}c")
 
+    @skip_if_server_version_lt("6.0.0")
+    @skip_if_redis_enterprise
+    def test_acl_log(self, r, request):
+        key = "{cache}:"
+        node = r.get_node_from_key(key)
+        username = "redis-py-user"
+
+        def teardown():
+            r.acl_deluser(username, target_nodes="primaries")
+
+        request.addfinalizer(teardown)
+        r.acl_setuser(
+            username,
+            enabled=True,
+            reset=True,
+            commands=["+get", "+set", "+select", "+cluster", "+command"],
+            keys=["{cache}:*"],
+            nopass=True,
+            target_nodes="primaries",
+        )
+        r.acl_log_reset(target_nodes=node)
+
+        user_client = _get_client(
+            RedisCluster, request, flushdb=False, username=username
+        )
+
+        # Valid operation and key
+        assert user_client.set("{cache}:0", 1)
+        assert user_client.get("{cache}:0") == b"1"
+
+        # Invalid key
+        with pytest.raises(NoPermissionError):
+            user_client.get("{cache}violated_cache:0")
+
+        # Invalid operation
+        with pytest.raises(NoPermissionError):
+            user_client.hset("{cache}:0", "hkey", "hval")
+
+        assert isinstance(r.acl_log(target_nodes=node), list)
+        assert len(r.acl_log(target_nodes=node)) == 2
+        assert len(r.acl_log(count=1, target_nodes=node)) == 1
+        assert isinstance(r.acl_log(target_nodes=node)[0], dict)
+        assert "client-info" in r.acl_log(count=1, target_nodes=node)[0]
+        assert r.acl_log_reset(target_nodes=node)
+
 
 @pytest.mark.onlycluster
 class TestNodesManager:
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 1eb35f8673..7c7d0f3d9e 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -71,21 +71,18 @@ def test_command_on_invalid_key_type(self, r):
             r["a"]
 
     # SERVER INFORMATION
-    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     def test_acl_cat_no_category(self, r):
         categories = r.acl_cat()
         assert isinstance(categories, list)
         assert "read" in categories
 
-    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     def test_acl_cat_with_category(self, r):
         commands = r.acl_cat("read")
         assert isinstance(commands, list)
         assert "get" in commands
 
-    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_deluser(self, r, request):
@@ -111,7 +108,6 @@ def teardown():
         assert r.acl_getuser(users[3]) is None
         assert r.acl_getuser(users[4]) is None
 
-    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_genpass(self, r):
@@ -126,7 +122,6 @@ def test_acl_genpass(self, r):
         r.acl_genpass(555)
         assert isinstance(password, str)
 
-    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_getuser_setuser(self, r, request):
@@ -234,14 +229,12 @@ def teardown():
         )
         assert len(r.acl_getuser(username)["passwords"]) == 1
 
-    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     def test_acl_help(self, r):
         res = r.acl_help()
         assert isinstance(res, list)
         assert len(res) != 0
 
-    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_list(self, r, request):
@@ -256,7 +249,6 @@ def teardown():
         users = r.acl_list()
         assert len(users) == 2
 
-    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_log(self, r, request):
@@ -299,7 +291,6 @@ def teardown():
         assert "client-info" in r.acl_log(count=1)[0]
         assert r.acl_log_reset()
 
-    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_setuser_categories_without_prefix_fails(self, r, request):
@@ -313,7 +304,6 @@ def teardown():
         with pytest.raises(exceptions.DataError):
             r.acl_setuser(username, categories=["list"])
 
-    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_setuser_commands_without_prefix_fails(self, r, request):
@@ -327,7 +317,6 @@ def teardown():
         with pytest.raises(exceptions.DataError):
             r.acl_setuser(username, commands=["get"])
 
-    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise
     def test_acl_setuser_add_passwords_and_nopass_fails(self, r, request):
@@ -341,14 +330,12 @@ def teardown():
         with pytest.raises(exceptions.DataError):
             r.acl_setuser(username, passwords="+mypass", nopass=True)
 
-    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     def test_acl_users(self, r):
         users = r.acl_users()
         assert isinstance(users, list)
         assert len(users) > 0
 
-    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
     def test_acl_whoami(self, r):
         username = r.acl_whoami()
@@ -549,7 +536,7 @@ def test_client_kill_filter_by_user(self, r, request):
             killuser,
             enabled=True,
             reset=True,
-            commands=["+get", "+set", "+select"],
+            commands=["+get", "+set", "+select", "+cluster", "+command"],
             keys=["cache:*"],
             nopass=True,
         )

From 42101fc383829bb179a266420132d3f862861972 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Wed, 1 Dec 2021 19:03:18 +0100
Subject: [PATCH 0283/1164] Integrate RedisBloom support (#1683)

Co-authored-by: Chayim I. Kirshen <c@kirshen.com>
---
 redis/commands/bf/__init__.py  | 204 ++++++++++++++
 redis/commands/bf/commands.py  | 494 +++++++++++++++++++++++++++++++++
 redis/commands/bf/info.py      |  85 ++++++
 redis/commands/redismodules.py |  40 +++
 setup.py                       |   1 +
 tests/test_bloom.py            | 383 +++++++++++++++++++++++++
 tox.ini                        |   1 +
 7 files changed, 1208 insertions(+)
 create mode 100644 redis/commands/bf/__init__.py
 create mode 100644 redis/commands/bf/commands.py
 create mode 100644 redis/commands/bf/info.py
 create mode 100644 tests/test_bloom.py

diff --git a/redis/commands/bf/__init__.py b/redis/commands/bf/__init__.py
new file mode 100644
index 0000000000..f34e11d9bb
--- /dev/null
+++ b/redis/commands/bf/__init__.py
@@ -0,0 +1,204 @@
+from redis.client import bool_ok
+
+from ..helpers import parse_to_list
+from .commands import *  # noqa
+from .info import BFInfo, CFInfo, CMSInfo, TDigestInfo, TopKInfo
+
+
+class AbstractBloom(object):
+    """
+    The client allows to interact with RedisBloom and use all of
+    it's functionality.
+
+    - BF for Bloom Filter
+    - CF for Cuckoo Filter
+    - CMS for Count-Min Sketch
+    - TOPK for TopK Data Structure
+    - TDIGEST for estimate rank statistics
+    """
+
+    @staticmethod
+    def appendItems(params, items):
+        """Append ITEMS to params."""
+        params.extend(["ITEMS"])
+        params += items
+
+    @staticmethod
+    def appendError(params, error):
+        """Append ERROR to params."""
+        if error is not None:
+            params.extend(["ERROR", error])
+
+    @staticmethod
+    def appendCapacity(params, capacity):
+        """Append CAPACITY to params."""
+        if capacity is not None:
+            params.extend(["CAPACITY", capacity])
+
+    @staticmethod
+    def appendExpansion(params, expansion):
+        """Append EXPANSION to params."""
+        if expansion is not None:
+            params.extend(["EXPANSION", expansion])
+
+    @staticmethod
+    def appendNoScale(params, noScale):
+        """Append NONSCALING tag to params."""
+        if noScale is not None:
+            params.extend(["NONSCALING"])
+
+    @staticmethod
+    def appendWeights(params, weights):
+        """Append WEIGHTS to params."""
+        if len(weights) > 0:
+            params.append("WEIGHTS")
+            params += weights
+
+    @staticmethod
+    def appendNoCreate(params, noCreate):
+        """Append NOCREATE tag to params."""
+        if noCreate is not None:
+            params.extend(["NOCREATE"])
+
+    @staticmethod
+    def appendItemsAndIncrements(params, items, increments):
+        """Append pairs of items and increments to params."""
+        for i in range(len(items)):
+            params.append(items[i])
+            params.append(increments[i])
+
+    @staticmethod
+    def appendValuesAndWeights(params, items, weights):
+        """Append pairs of items and weights to params."""
+        for i in range(len(items)):
+            params.append(items[i])
+            params.append(weights[i])
+
+    @staticmethod
+    def appendMaxIterations(params, max_iterations):
+        """Append MAXITERATIONS to params."""
+        if max_iterations is not None:
+            params.extend(["MAXITERATIONS", max_iterations])
+
+    @staticmethod
+    def appendBucketSize(params, bucket_size):
+        """Append BUCKETSIZE to params."""
+        if bucket_size is not None:
+            params.extend(["BUCKETSIZE", bucket_size])
+
+
+class CMSBloom(CMSCommands, AbstractBloom):
+    def __init__(self, client, **kwargs):
+        """Create a new RedisBloom client."""
+        # Set the module commands' callbacks
+        MODULE_CALLBACKS = {
+            CMS_INITBYDIM: bool_ok,
+            CMS_INITBYPROB: bool_ok,
+            # CMS_INCRBY: spaceHolder,
+            # CMS_QUERY: spaceHolder,
+            CMS_MERGE: bool_ok,
+            CMS_INFO: CMSInfo,
+        }
+
+        self.client = client
+        self.commandmixin = CMSCommands
+        self.execute_command = client.execute_command
+
+        for k, v in MODULE_CALLBACKS.items():
+            self.client.set_response_callback(k, v)
+
+
+class TOPKBloom(TOPKCommands, AbstractBloom):
+    def __init__(self, client, **kwargs):
+        """Create a new RedisBloom client."""
+        # Set the module commands' callbacks
+        MODULE_CALLBACKS = {
+            TOPK_RESERVE: bool_ok,
+            TOPK_ADD: parse_to_list,
+            TOPK_INCRBY: parse_to_list,
+            # TOPK_QUERY: spaceHolder,
+            # TOPK_COUNT: spaceHolder,
+            TOPK_LIST: parse_to_list,
+            TOPK_INFO: TopKInfo,
+        }
+
+        self.client = client
+        self.commandmixin = TOPKCommands
+        self.execute_command = client.execute_command
+
+        for k, v in MODULE_CALLBACKS.items():
+            self.client.set_response_callback(k, v)
+
+
+class CFBloom(CFCommands, AbstractBloom):
+    def __init__(self, client, **kwargs):
+        """Create a new RedisBloom client."""
+        # Set the module commands' callbacks
+        MODULE_CALLBACKS = {
+            CF_RESERVE: bool_ok,
+            # CF_ADD: spaceHolder,
+            # CF_ADDNX: spaceHolder,
+            # CF_INSERT: spaceHolder,
+            # CF_INSERTNX: spaceHolder,
+            # CF_EXISTS: spaceHolder,
+            # CF_DEL: spaceHolder,
+            # CF_COUNT: spaceHolder,
+            # CF_SCANDUMP: spaceHolder,
+            # CF_LOADCHUNK: spaceHolder,
+            CF_INFO: CFInfo,
+        }
+
+        self.client = client
+        self.commandmixin = CFCommands
+        self.execute_command = client.execute_command
+
+        for k, v in MODULE_CALLBACKS.items():
+            self.client.set_response_callback(k, v)
+
+
+class TDigestBloom(TDigestCommands, AbstractBloom):
+    def __init__(self, client, **kwargs):
+        """Create a new RedisBloom client."""
+        # Set the module commands' callbacks
+        MODULE_CALLBACKS = {
+            TDIGEST_CREATE: bool_ok,
+            # TDIGEST_RESET: bool_ok,
+            # TDIGEST_ADD: spaceHolder,
+            # TDIGEST_MERGE: spaceHolder,
+            TDIGEST_CDF: float,
+            TDIGEST_QUANTILE: float,
+            TDIGEST_MIN: float,
+            TDIGEST_MAX: float,
+            TDIGEST_INFO: TDigestInfo,
+        }
+
+        self.client = client
+        self.commandmixin = TDigestCommands
+        self.execute_command = client.execute_command
+
+        for k, v in MODULE_CALLBACKS.items():
+            self.client.set_response_callback(k, v)
+
+
+class BFBloom(BFCommands, AbstractBloom):
+    def __init__(self, client, **kwargs):
+        """Create a new RedisBloom client."""
+        # Set the module commands' callbacks
+        MODULE_CALLBACKS = {
+            BF_RESERVE: bool_ok,
+            # BF_ADD: spaceHolder,
+            # BF_MADD: spaceHolder,
+            # BF_INSERT: spaceHolder,
+            # BF_EXISTS: spaceHolder,
+            # BF_MEXISTS: spaceHolder,
+            # BF_SCANDUMP: spaceHolder,
+            # BF_LOADCHUNK: spaceHolder,
+            BF_INFO: BFInfo,
+        }
+
+        self.client = client
+        self.commandmixin = BFCommands
+        self.execute_command = client.execute_command
+
+        for k, v in MODULE_CALLBACKS.items():
+            self.client.set_response_callback(k, v)
diff --git a/redis/commands/bf/commands.py b/redis/commands/bf/commands.py
new file mode 100644
index 0000000000..3c8bf7f31e
--- /dev/null
+++ b/redis/commands/bf/commands.py
@@ -0,0 +1,494 @@
+from redis.client import NEVER_DECODE
+from redis.exceptions import ModuleError
+from redis.utils import HIREDIS_AVAILABLE
+
+BF_RESERVE = "BF.RESERVE"
+BF_ADD = "BF.ADD"
+BF_MADD = "BF.MADD"
+BF_INSERT = "BF.INSERT"
+BF_EXISTS = "BF.EXISTS"
+BF_MEXISTS = "BF.MEXISTS"
+BF_SCANDUMP = "BF.SCANDUMP"
+BF_LOADCHUNK = "BF.LOADCHUNK"
+BF_INFO = "BF.INFO"
+
+CF_RESERVE = "CF.RESERVE"
+CF_ADD = "CF.ADD"
+CF_ADDNX = "CF.ADDNX"
+CF_INSERT = "CF.INSERT"
+CF_INSERTNX = "CF.INSERTNX"
+CF_EXISTS = "CF.EXISTS"
+CF_DEL = "CF.DEL"
+CF_COUNT = "CF.COUNT"
+CF_SCANDUMP = "CF.SCANDUMP"
+CF_LOADCHUNK = "CF.LOADCHUNK"
+CF_INFO = "CF.INFO"
+
+CMS_INITBYDIM = "CMS.INITBYDIM"
+CMS_INITBYPROB = "CMS.INITBYPROB"
+CMS_INCRBY = "CMS.INCRBY"
+CMS_QUERY = "CMS.QUERY"
+CMS_MERGE = "CMS.MERGE"
+CMS_INFO = "CMS.INFO"
+
+TOPK_RESERVE = "TOPK.RESERVE"
+TOPK_ADD = "TOPK.ADD"
+TOPK_INCRBY = "TOPK.INCRBY"
+TOPK_QUERY = "TOPK.QUERY"
+TOPK_COUNT = "TOPK.COUNT"
+TOPK_LIST = "TOPK.LIST"
+TOPK_INFO = "TOPK.INFO"
+
+TDIGEST_CREATE = "TDIGEST.CREATE"
+TDIGEST_RESET = "TDIGEST.RESET"
+TDIGEST_ADD = "TDIGEST.ADD"
+TDIGEST_MERGE = "TDIGEST.MERGE"
+TDIGEST_CDF = "TDIGEST.CDF"
+TDIGEST_QUANTILE = "TDIGEST.QUANTILE"
+TDIGEST_MIN = "TDIGEST.MIN"
+TDIGEST_MAX = "TDIGEST.MAX"
+TDIGEST_INFO = "TDIGEST.INFO"
+
+
+class BFCommands:
+    """RedisBloom commands."""
+
+    # region Bloom Filter Functions
+    def create(self, key, errorRate, capacity, expansion=None, noScale=None):
+        """
+        Create a new Bloom Filter `key` with desired probability of false positives
+        `errorRate` expected entries to be inserted as `capacity`.
+        Default expansion value is 2. By default, filter is auto-scaling.
+        For more information see `BF.RESERVE <https://oss.redis.com/redisbloom/master/Bloom_Commands/#bfreserve>`_.
+        """  # noqa
+        params = [key, errorRate, capacity]
+        self.appendExpansion(params, expansion)
+        self.appendNoScale(params, noScale)
+        return self.execute_command(BF_RESERVE, *params)
+
+    def add(self, key, item):
+        """
+        Add to a Bloom Filter `key` an `item`.
+        For more information see `BF.ADD <https://oss.redis.com/redisbloom/master/Bloom_Commands/#bfadd>`_.
+        """  # noqa
+        params = [key, item]
+        return self.execute_command(BF_ADD, *params)
+
+    def madd(self, key, *items):
+        """
+        Add to a Bloom Filter `key` multiple `items`.
+        For more information see `BF.MADD <https://oss.redis.com/redisbloom/master/Bloom_Commands/#bfmadd>`_.
+        """  # noqa
+        params = [key]
+        params += items
+        return self.execute_command(BF_MADD, *params)
+
+    def insert(
+        self,
+        key,
+        items,
+        capacity=None,
+        error=None,
+        noCreate=None,
+        expansion=None,
+        noScale=None,
+    ):
+        """
+        Add to a Bloom Filter `key` multiple `items`.
+
+        If `nocreate` remain `None` and `key` does not exist, a new Bloom Filter
+        `key` will be created with desired probability of false positives `errorRate`
+        and expected entries to be inserted as `size`.
+        For more information see `BF.INSERT <https://oss.redis.com/redisbloom/master/Bloom_Commands/#bfinsert>`_.
+        """  # noqa
+        params = [key]
+        self.appendCapacity(params, capacity)
+        self.appendError(params, error)
+        self.appendExpansion(params, expansion)
+        self.appendNoCreate(params, noCreate)
+        self.appendNoScale(params, noScale)
+        self.appendItems(params, items)
+
+        return self.execute_command(BF_INSERT, *params)
+
+    def exists(self, key, item):
+        """
+        Check whether an `item` exists in Bloom Filter `key`.
+        For more information see `BF.EXISTS <https://oss.redis.com/redisbloom/master/Bloom_Commands/#bfexists>`_.
+        """  # noqa
+        params = [key, item]
+        return self.execute_command(BF_EXISTS, *params)
+
+    def mexists(self, key, *items):
+        """
+        Check whether `items` exist in Bloom Filter `key`.
+        For more information see `BF.MEXISTS <https://oss.redis.com/redisbloom/master/Bloom_Commands/#bfmexists>`_.
+        """  # noqa
+        params = [key]
+        params += items
+        return self.execute_command(BF_MEXISTS, *params)
+
+    def scandump(self, key, iter):
+        """
+        Begin an incremental save of the bloom filter `key`.
+
+        This is useful for large bloom filters which cannot fit into the normal SAVE and RESTORE model.
+        The first time this command is called, the value of `iter` should be 0.
+        This command will return successive (iter, data) pairs until (0, NULL) to indicate completion.
+        For more information see `BF.SCANDUMP <https://oss.redis.com/redisbloom/master/Bloom_Commands/#bfscandump>`_.
+        """  # noqa
+        if HIREDIS_AVAILABLE:
+            raise ModuleError("This command cannot be used when hiredis is available.")
+
+        params = [key, iter]
+        options = {}
+        options[NEVER_DECODE] = []
+        return self.execute_command(BF_SCANDUMP, *params, **options)
+
+    def loadchunk(self, key, iter, data):
+        """
+        Restore a filter previously saved using SCANDUMP.
+
+        See the SCANDUMP command for example usage.
+        This command will overwrite any bloom filter stored under key.
+        Ensure that the bloom filter will not be modified between invocations.
+        For more information see `BF.LOADCHUNK <https://oss.redis.com/redisbloom/master/Bloom_Commands/#bfloadchunk>`_.
+        """  # noqa
+        params = [key, iter, data]
+        return self.execute_command(BF_LOADCHUNK, *params)
+
+    def info(self, key):
+        """
+        Return capacity, size, number of filters, number of items inserted, and expansion rate.
+        For more information see `BF.INFO <https://oss.redis.com/redisbloom/master/Bloom_Commands/#bfinfo>`_.
+        """  # noqa
+        return self.execute_command(BF_INFO, key)
+
+
+class CFCommands:
+
+    # region Cuckoo Filter Functions
+    def create(
+        self, key, capacity, expansion=None, bucket_size=None, max_iterations=None
+    ):
+        """
+        Create a new Cuckoo Filter `key` an initial `capacity` items.
+        For more information see `CF.RESERVE <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfreserve>`_.
+        """  # noqa
+        params = [key, capacity]
+        self.appendExpansion(params, expansion)
+        self.appendBucketSize(params, bucket_size)
+        self.appendMaxIterations(params, max_iterations)
+        return self.execute_command(CF_RESERVE, *params)
+
+    def add(self, key, item):
+        """
+        Add an `item` to a Cuckoo Filter `key`.
+        For more information see `CF.ADD <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfadd>`_.
+        """  # noqa
+        params = [key, item]
+        return self.execute_command(CF_ADD, *params)
+
+    def addnx(self, key, item):
+        """
+        Add an `item` to a Cuckoo Filter `key` only if item does not yet exist.
+        Command might be slower that `add`.
+        For more information see `CF.ADDNX <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfaddnx>`_.
+        """  # noqa
+        params = [key, item]
+        return self.execute_command(CF_ADDNX, *params)
+
+    def insert(self, key, items, capacity=None, nocreate=None):
+        """
+        Add multiple `items` to a Cuckoo Filter `key`, allowing the filter
+        to be created with a custom `capacity` if it does not yet exist.
+        `items` must be provided as a list.
+        For more information see `CF.INSERT <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfinsert>`_.
+        """  # noqa
+        params = [key]
+        self.appendCapacity(params, capacity)
+        self.appendNoCreate(params, nocreate)
+        self.appendItems(params, items)
+        return self.execute_command(CF_INSERT, *params)
+
+    def insertnx(self, key, items, capacity=None, nocreate=None):
+        """
+        Add multiple `items` to a Cuckoo Filter `key` only if they do not exist yet,
+        allowing the filter to be created with a custom `capacity` if it does not yet exist.
+        `items` must be provided as a list.
+        For more information see `CF.INSERTNX <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfinsertnx>`_.
+        """  # noqa
+        params = [key]
+        self.appendCapacity(params, capacity)
+        self.appendNoCreate(params, nocreate)
+        self.appendItems(params, items)
+        return self.execute_command(CF_INSERTNX, *params)
+
+    def exists(self, key, item):
+        """
+        Check whether an `item` exists in Cuckoo Filter `key`.
+        For more information see `CF.EXISTS <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfexists>`_.
+        """  # noqa
+        params = [key, item]
+        return self.execute_command(CF_EXISTS, *params)
+
+    def delete(self, key, item):
+        """
+        Delete `item` from `key`.
+        For more information see `CF.DEL <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfdel>`_.
+        """  # noqa
+        params = [key, item]
+        return self.execute_command(CF_DEL, *params)
+
+    def count(self, key, item):
+        """
+        Return the number of times an `item` may be in the `key`.
+        For more information see `CF.COUNT <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfcount>`_.
+        """  # noqa
+        params = [key, item]
+        return self.execute_command(CF_COUNT, *params)
+
+    def scandump(self, key, iter):
+        """
+        Begin an incremental save of the Cuckoo filter `key`.
+
+        This is useful for large Cuckoo filters which cannot fit into the normal
+        SAVE and RESTORE model.
+        The first time this command is called, the value of `iter` should be 0.
+        This command will return successive (iter, data) pairs until
+        (0, NULL) to indicate completion.
+        For more information see `CF.SCANDUMP <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfscandump>`_.
+        """  # noqa
+        params = [key, iter]
+        return self.execute_command(CF_SCANDUMP, *params)
+
+    def loadchunk(self, key, iter, data):
+        """
+        Restore a filter previously saved using SCANDUMP. See the SCANDUMP command for example usage.
+
+        This command will overwrite any Cuckoo filter stored under key.
+        Ensure that the Cuckoo filter will not be modified between invocations.
+        For more information see `CF.LOADCHUNK <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfloadchunk>`_.
+        """  # noqa
+        params = [key, iter, data]
+        return self.execute_command(CF_LOADCHUNK, *params)
+
+    def info(self, key):
+        """
+        Return size, number of buckets, number of filter, number of items inserted,
+        number of items deleted, bucket size, expansion rate, and max iteration.
+        For more information see `CF.INFO <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfinfo>`_.
+        """  # noqa
+        return self.execute_command(CF_INFO, key)
+
+
+class TOPKCommands:
+    def reserve(self, key, k, width, depth, decay):
+        """
+        Create a new Top-K Filter `key` with desired probability of false
+        positives `errorRate` expected entries to be inserted as `size`.
+        For more information see `TOPK.RESERVE <https://oss.redis.com/redisbloom/master/TopK_Commands/#topkreserve>`_.
+        """  # noqa
+        params = [key, k, width, depth, decay]
+        return self.execute_command(TOPK_RESERVE, *params)
+
+    def add(self, key, *items):
+        """
+        Add one `item` or more to a Top-K Filter `key`.
+        For more information see `TOPK.ADD <https://oss.redis.com/redisbloom/master/TopK_Commands/#topkadd>`_.
+        """  # noqa
+        params = [key]
+        params += items
+        return self.execute_command(TOPK_ADD, *params)
+
+    def incrby(self, key, items, increments):
+        """
+        Add/increase `items` to a Top-K Sketch `key` by ''increments''.
+        Both `items` and `increments` are lists.
+        For more information see `TOPK.INCRBY <https://oss.redis.com/redisbloom/master/TopK_Commands/#topkincrby>`_.
+
+        Example:
+
+        >>> topkincrby('A', ['foo'], [1])
+        """  # noqa
+        params = [key]
+        self.appendItemsAndIncrements(params, items, increments)
+        return self.execute_command(TOPK_INCRBY, *params)
+
+    def query(self, key, *items):
+        """
+        Check whether one `item` or more is a Top-K item at `key`.
+        For more information see `TOPK.QUERY <https://oss.redis.com/redisbloom/master/TopK_Commands/#topkquery>`_.
+        """  # noqa
+        params = [key]
+        params += items
+        return self.execute_command(TOPK_QUERY, *params)
+
+    def count(self, key, *items):
+        """
+        Return count for one `item` or more from `key`.
+        For more information see `TOPK.COUNT <https://oss.redis.com/redisbloom/master/TopK_Commands/#topkcount>`_.
+        """  # noqa
+        params = [key]
+        params += items
+        return self.execute_command(TOPK_COUNT, *params)
+
+    def list(self, key, withcount=False):
+        """
+        Return full list of items in Top-K list of `key`.
+        If `withcount` set to True, return full list of items
+        with probabilistic count in Top-K list of `key`.
+        For more information see `TOPK.LIST <https://oss.redis.com/redisbloom/master/TopK_Commands/#topklist>`_.
+        """  # noqa
+        params = [key]
+        if withcount:
+            params.append("WITHCOUNT")
+        return self.execute_command(TOPK_LIST, *params)
+
+    def info(self, key):
+        """
+        Return k, width, depth and decay values of `key`.
+        For more information see `TOPK.INFO <https://oss.redis.com/redisbloom/master/TopK_Commands/#topkinfo>`_.
+        """  # noqa
+        return self.execute_command(TOPK_INFO, key)
+
+
+class TDigestCommands:
+    def create(self, key, compression):
+        """
+        Allocate the memory and initialize the t-digest.
+        For more information see `TDIGEST.CREATE <https://oss.redis.com/redisbloom/master/TDigest_Commands/#tdigestcreate>`_.
+        """  # noqa
+        params = [key, compression]
+        return self.execute_command(TDIGEST_CREATE, *params)
+
+    def reset(self, key):
+        """
+        Reset the sketch `key` to zero - empty out the sketch and re-initialize it.
+        For more information see `TDIGEST.RESET <https://oss.redis.com/redisbloom/master/TDigest_Commands/#tdigestreset>`_.
+        """  # noqa
+        return self.execute_command(TDIGEST_RESET, key)
+
+    def add(self, key, values, weights):
+        """
+        Add one or more samples (value with weight) to a sketch `key`.
+        Both `values` and `weights` are lists.
+        For more information see `TDIGEST.ADD <https://oss.redis.com/redisbloom/master/TDigest_Commands/#tdigestadd>`_.
+
+        Example:
+
+        >>> tdigestadd('A', [1500.0], [1.0])
+        """  # noqa
+        params = [key]
+        self.appendValuesAndWeights(params, values, weights)
+        return self.execute_command(TDIGEST_ADD, *params)
+
+    def merge(self, toKey, fromKey):
+        """
+        Merge all of the values from 'fromKey' to 'toKey' sketch.
+        For more information see `TDIGEST.MERGE <https://oss.redis.com/redisbloom/master/TDigest_Commands/#tdigestmerge>`_.
+        """  # noqa
+        params = [toKey, fromKey]
+        return self.execute_command(TDIGEST_MERGE, *params)
+
+    def min(self, key):
+        """
+        Return minimum value from the sketch `key`. Will return DBL_MAX if the sketch is empty.
+        For more information see `TDIGEST.MIN <https://oss.redis.com/redisbloom/master/TDigest_Commands/#tdigestmin>`_.
+        """  # noqa
+        return self.execute_command(TDIGEST_MIN, key)
+
+    def max(self, key):
+        """
+        Return maximum value from the sketch `key`. Will return DBL_MIN if the sketch is empty.
+        For more information see `TDIGEST.MAX <https://oss.redis.com/redisbloom/master/TDigest_Commands/#tdigestmax>`_.
+        """  # noqa
+        return self.execute_command(TDIGEST_MAX, key)
+
+    def quantile(self, key, quantile):
+        """
+        Return double value estimate of the cutoff such that a specified fraction of the data
+        added to this TDigest would be less than or equal to the cutoff.
+        For more information see `TDIGEST.QUANTILE <https://oss.redis.com/redisbloom/master/TDigest_Commands/#tdigestquantile>`_.
+        """  # noqa
+        params = [key, quantile]
+        return self.execute_command(TDIGEST_QUANTILE, *params)
+
+    def cdf(self, key, value):
+        """
+        Return double fraction of all points added which are <= value.
+        For more information see `TDIGEST.CDF <https://oss.redis.com/redisbloom/master/TDigest_Commands/#tdigestcdf>`_.
+        """  # noqa
+        params = [key, value]
+        return self.execute_command(TDIGEST_CDF, *params)
+
+    def info(self, key):
+        """
+        Return Compression, Capacity, Merged Nodes, Unmerged Nodes, Merged Weight, Unmerged Weight
+        and Total Compressions.
+        For more information see `TDIGEST.INFO <https://oss.redis.com/redisbloom/master/TDigest_Commands/#tdigestinfo>`_.
+        """  # noqa
+        return self.execute_command(TDIGEST_INFO, key)
+
+
+class CMSCommands:
+
+    # region Count-Min Sketch Functions
+    def initbydim(self, key, width, depth):
+        """
+        Initialize a Count-Min Sketch `key` to dimensions (`width`, `depth`) specified by user.
+        For more information see `CMS.INITBYDIM <https://oss.redis.com/redisbloom/master/CountMinSketch_Commands/#cmsinitbydim>`_.
+        """  # noqa
+        params = [key, width, depth]
+        return self.execute_command(CMS_INITBYDIM, *params)
+
+    def initbyprob(self, key, error, probability):
+        """
+        Initialize a Count-Min Sketch `key` to characteristics (`error`, `probability`) specified by user.
+        For more information see `CMS.INITBYPROB <https://oss.redis.com/redisbloom/master/CountMinSketch_Commands/#cmsinitbyprob>`_.
+        """  # noqa
+        params = [key, error, probability]
+        return self.execute_command(CMS_INITBYPROB, *params)
+
+    def incrby(self, key, items, increments):
+        """
+        Add/increase `items` to a Count-Min Sketch `key` by ''increments''.
+        Both `items` and `increments` are lists.
+        For more information see `CMS.INCRBY <https://oss.redis.com/redisbloom/master/CountMinSketch_Commands/#cmsincrby>`_.
+
+        Example:
+
+        >>> cmsincrby('A', ['foo'], [1])
+        """  # noqa
+        params = [key]
+        self.appendItemsAndIncrements(params, items, increments)
+        return self.execute_command(CMS_INCRBY, *params)
+
+    def query(self, key, *items):
+        """
+        Return count for an `item` from `key`. Multiple items can be queried with one call.
+        For more information see `CMS.QUERY <https://oss.redis.com/redisbloom/master/CountMinSketch_Commands/#cmsquery>`_.
+        """  # noqa
+        params = [key]
+        params += items
+        return self.execute_command(CMS_QUERY, *params)
+
+    def merge(self, destKey, numKeys, srcKeys, weights=[]):
+        """
+        Merge `numKeys` of sketches into `destKey`. Sketches specified in `srcKeys`.
+        All sketches must have identical width and depth.
+        `Weights` can be used to multiply certain sketches. Default weight is 1.
+        Both `srcKeys` and `weights` are lists.
+        For more information see `CMS.MERGE <https://oss.redis.com/redisbloom/master/CountMinSketch_Commands/#cmsmerge>`_.
+        """  # noqa
+        params = [destKey, numKeys]
+        params += srcKeys
+        self.appendWeights(params, weights)
+        return self.execute_command(CMS_MERGE, *params)
+
+    def info(self, key):
+        """
+        Return width, depth and total count of the sketch.
+        For more information see `CMS.INFO <https://oss.redis.com/redisbloom/master/CountMinSketch_Commands/#cmsinfo>`_.
+        """  # noqa
+        return self.execute_command(CMS_INFO, key)
diff --git a/redis/commands/bf/info.py b/redis/commands/bf/info.py
new file mode 100644
index 0000000000..24c5419bb7
--- /dev/null
+++ b/redis/commands/bf/info.py
@@ -0,0 +1,85 @@
+from ..helpers import nativestr
+
+
+class BFInfo(object):
+    capacity = None
+    size = None
+    filterNum = None
+    insertedNum = None
+    expansionRate = None
+
+    def __init__(self, args):
+        response = dict(zip(map(nativestr, args[::2]), args[1::2]))
+        self.capacity = response["Capacity"]
+        self.size = response["Size"]
+        self.filterNum = response["Number of filters"]
+        self.insertedNum = response["Number of items inserted"]
+        self.expansionRate = response["Expansion rate"]
+
+
+class CFInfo(object):
+    size = None
+    bucketNum = None
+    filterNum = None
+    insertedNum = None
+    deletedNum = None
+    bucketSize = None
+    expansionRate = None
+    maxIteration = None
+
+    def __init__(self, args):
+        response = dict(zip(map(nativestr, args[::2]), args[1::2]))
+        self.size = response["Size"]
+        self.bucketNum = response["Number of buckets"]
+        self.filterNum = response["Number of filters"]
+        self.insertedNum = response["Number of items inserted"]
+        self.deletedNum = response["Number of items deleted"]
+        self.bucketSize = response["Bucket size"]
+        self.expansionRate = response["Expansion rate"]
+        self.maxIteration = response["Max iterations"]
+
+
+class CMSInfo(object):
+    width = None
+    depth = None
+    count = None
+
+    def __init__(self, args):
+        response = dict(zip(map(nativestr, args[::2]), args[1::2]))
+        self.width = response["width"]
+        self.depth = response["depth"]
+        self.count = response["count"]
+
+
+class TopKInfo(object):
+    k = None
+    width = None
+    depth = None
+    decay = None
+
+    def __init__(self, args):
+        response = dict(zip(map(nativestr, args[::2]), args[1::2]))
+        self.k = response["k"]
+        self.width = response["width"]
+        self.depth = response["depth"]
+        self.decay = response["decay"]
+
+
+class TDigestInfo(object):
+    compression = None
+    capacity = None
+    mergedNodes = None
+    unmergedNodes = None
+    mergedWeight = None
+    unmergedWeight = None
+    totalCompressions = None
+
+    def __init__(self, args):
+        response = dict(zip(map(nativestr, args[::2]), args[1::2]))
+        self.compression = response["Compression"]
+        self.capacity = response["Capacity"]
+        self.mergedNodes = response["Merged nodes"]
+        self.unmergedNodes = response["Unmerged nodes"]
+        self.mergedWeight = response["Merged weight"]
+        self.unmergedWeight = response["Unmerged weight"]
+        self.totalCompressions = response["Total compressions"]
diff --git a/redis/commands/redismodules.py b/redis/commands/redismodules.py
index e5ace63113..eafd6500ea 100644
--- a/redis/commands/redismodules.py
+++ b/redis/commands/redismodules.py
@@ -32,6 +32,46 @@ def ts(self):
         s = TimeSeries(client=self)
         return s
 
+    def bf(self):
+        """Access the bloom namespace."""
+
+        from .bf import BFBloom
+
+        bf = BFBloom(client=self)
+        return bf
+
+    def cf(self):
+        """Access the bloom namespace."""
+
+        from .bf import CFBloom
+
+        cf = CFBloom(client=self)
+        return cf
+
+    def cms(self):
+        """Access the bloom namespace."""
+
+        from .bf import CMSBloom
+
+        cms = CMSBloom(client=self)
+        return cms
+
+    def topk(self):
+        """Access the bloom namespace."""
+
+        from .bf import TOPKBloom
+
+        topk = TOPKBloom(client=self)
+        return topk
+
+    def tdigest(self):
+        """Access the bloom namespace."""
+
+        from .bf import TDigestBloom
+
+        tdigest = TDigestBloom(client=self)
+        return tdigest
+
     def graph(self, index_name="idx"):
         """Access the timeseries namespace, providing support for
         redis timeseries data.
diff --git a/setup.py b/setup.py
index d8308010c9..58d753fb3a 100644
--- a/setup.py
+++ b/setup.py
@@ -15,6 +15,7 @@
         include=[
             "redis",
             "redis.commands",
+            "redis.commands.bf",
             "redis.commands.json",
             "redis.commands.search",
             "redis.commands.timeseries",
diff --git a/tests/test_bloom.py b/tests/test_bloom.py
new file mode 100644
index 0000000000..8936584ea8
--- /dev/null
+++ b/tests/test_bloom.py
@@ -0,0 +1,383 @@
+import pytest
+
+import redis.commands.bf
+from redis.exceptions import ModuleError, RedisError
+from redis.utils import HIREDIS_AVAILABLE
+
+
+def intlist(obj):
+    return [int(v) for v in obj]
+
+
+@pytest.fixture
+def client(modclient):
+    assert isinstance(modclient.bf(), redis.commands.bf.BFBloom)
+    assert isinstance(modclient.cf(), redis.commands.bf.CFBloom)
+    assert isinstance(modclient.cms(), redis.commands.bf.CMSBloom)
+    assert isinstance(modclient.tdigest(), redis.commands.bf.TDigestBloom)
+    assert isinstance(modclient.topk(), redis.commands.bf.TOPKBloom)
+
+    modclient.flushdb()
+    return modclient
+
+
+@pytest.mark.redismod
+def test_create(client):
+    """Test CREATE/RESERVE calls"""
+    assert client.bf().create("bloom", 0.01, 1000)
+    assert client.bf().create("bloom_e", 0.01, 1000, expansion=1)
+    assert client.bf().create("bloom_ns", 0.01, 1000, noScale=True)
+    assert client.cf().create("cuckoo", 1000)
+    assert client.cf().create("cuckoo_e", 1000, expansion=1)
+    assert client.cf().create("cuckoo_bs", 1000, bucket_size=4)
+    assert client.cf().create("cuckoo_mi", 1000, max_iterations=10)
+    assert client.cms().initbydim("cmsDim", 100, 5)
+    assert client.cms().initbyprob("cmsProb", 0.01, 0.01)
+    assert client.topk().reserve("topk", 5, 100, 5, 0.9)
+    assert client.tdigest().create("tDigest", 100)
+
+
+# region Test Bloom Filter
+@pytest.mark.redismod
+def test_bf_add(client):
+    assert client.bf().create("bloom", 0.01, 1000)
+    assert 1 == client.bf().add("bloom", "foo")
+    assert 0 == client.bf().add("bloom", "foo")
+    assert [0] == intlist(client.bf().madd("bloom", "foo"))
+    assert [0, 1] == client.bf().madd("bloom", "foo", "bar")
+    assert [0, 0, 1] == client.bf().madd("bloom", "foo", "bar", "baz")
+    assert 1 == client.bf().exists("bloom", "foo")
+    assert 0 == client.bf().exists("bloom", "noexist")
+    assert [1, 0] == intlist(client.bf().mexists("bloom", "foo", "noexist"))
+
+
+@pytest.mark.redismod
+def test_bf_insert(client):
+    assert client.bf().create("bloom", 0.01, 1000)
+    assert [1] == intlist(client.bf().insert("bloom", ["foo"]))
+    assert [0, 1] == intlist(client.bf().insert("bloom", ["foo", "bar"]))
+    assert [1] == intlist(client.bf().insert("captest", ["foo"], capacity=10))
+    assert [1] == intlist(client.bf().insert("errtest", ["foo"], error=0.01))
+    assert 1 == client.bf().exists("bloom", "foo")
+    assert 0 == client.bf().exists("bloom", "noexist")
+    assert [1, 0] == intlist(client.bf().mexists("bloom", "foo", "noexist"))
+    info = client.bf().info("bloom")
+    assert 2 == info.insertedNum
+    assert 1000 == info.capacity
+    assert 1 == info.filterNum
+
+
+@pytest.mark.redismod
+def test_bf_scandump_and_loadchunk(client):
+    # Store a filter
+    client.bf().create("myBloom", "0.0001", "1000")
+
+    # test is probabilistic and might fail. It is OK to change variables if
+    # certain to not break anything
+    def do_verify():
+        res = 0
+        for x in range(1000):
+            client.bf().add("myBloom", x)
+            rv = client.bf().exists("myBloom", x)
+            assert rv
+            rv = client.bf().exists("myBloom", f"nonexist_{x}")
+            res += rv == x
+        assert res < 5
+
+    do_verify()
+    cmds = []
+    if HIREDIS_AVAILABLE:
+        with pytest.raises(ModuleError):
+            cur = client.bf().scandump("myBloom", 0)
+        return
+
+    cur = client.bf().scandump("myBloom", 0)
+    first = cur[0]
+    cmds.append(cur)
+
+    while True:
+        cur = client.bf().scandump("myBloom", first)
+        first = cur[0]
+        if first == 0:
+            break
+        else:
+            cmds.append(cur)
+    prev_info = client.bf().execute_command("bf.debug", "myBloom")
+
+    # Remove the filter
+    client.bf().client.delete("myBloom")
+
+    # Now, load all the commands:
+    for cmd in cmds:
+        client.bf().loadchunk("myBloom", *cmd)
+
+    cur_info = client.bf().execute_command("bf.debug", "myBloom")
+    assert prev_info == cur_info
+    do_verify()
+
+    client.bf().client.delete("myBloom")
+    client.bf().create("myBloom", "0.0001", "10000000")
+
+
+@pytest.mark.redismod
+def test_bf_info(client):
+    expansion = 4
+    # Store a filter
+    client.bf().create("nonscaling", "0.0001", "1000", noScale=True)
+    info = client.bf().info("nonscaling")
+    assert info.expansionRate is None
+
+    client.bf().create("expanding", "0.0001", "1000", expansion=expansion)
+    info = client.bf().info("expanding")
+    assert info.expansionRate == 4
+
+    try:
+        # noScale mean no expansion
+        client.bf().create(
+            "myBloom", "0.0001", "1000", expansion=expansion, noScale=True
+        )
+        assert False
+    except RedisError:
+        assert True
+
+
+# region Test Cuckoo Filter
+@pytest.mark.redismod
+def test_cf_add_and_insert(client):
+    assert client.cf().create("cuckoo", 1000)
+    assert client.cf().add("cuckoo", "filter")
+    assert not client.cf().addnx("cuckoo", "filter")
+    assert 1 == client.cf().addnx("cuckoo", "newItem")
+    assert [1] == client.cf().insert("captest", ["foo"])
+    assert [1] == client.cf().insert("captest", ["foo"], capacity=1000)
+    assert [1] == client.cf().insertnx("captest", ["bar"])
+    assert [1] == client.cf().insertnx("captest", ["food"], nocreate="1")
+    assert [0, 0, 1] == client.cf().insertnx("captest", ["foo", "bar", "baz"])
+    assert [0] == client.cf().insertnx("captest", ["bar"], capacity=1000)
+    assert [1] == client.cf().insert("empty1", ["foo"], capacity=1000)
+    assert [1] == client.cf().insertnx("empty2", ["bar"], capacity=1000)
+    info = client.cf().info("captest")
+    assert 5 == info.insertedNum
+    assert 0 == info.deletedNum
+    assert 1 == info.filterNum
+
+
+@pytest.mark.redismod
+def test_cf_exists_and_del(client):
+    assert client.cf().create("cuckoo", 1000)
+    assert client.cf().add("cuckoo", "filter")
+    assert client.cf().exists("cuckoo", "filter")
+    assert not client.cf().exists("cuckoo", "notexist")
+    assert 1 == client.cf().count("cuckoo", "filter")
+    assert 0 == client.cf().count("cuckoo", "notexist")
+    assert client.cf().delete("cuckoo", "filter")
+    assert 0 == client.cf().count("cuckoo", "filter")
+
+
+# region Test Count-Min Sketch
+@pytest.mark.redismod
+def test_cms(client):
+    assert client.cms().initbydim("dim", 1000, 5)
+    assert client.cms().initbyprob("prob", 0.01, 0.01)
+    assert client.cms().incrby("dim", ["foo"], [5])
+    assert [0] == client.cms().query("dim", "notexist")
+    assert [5] == client.cms().query("dim", "foo")
+    assert [10, 15] == client.cms().incrby("dim", ["foo", "bar"], [5, 15])
+    assert [10, 15] == client.cms().query("dim", "foo", "bar")
+    info = client.cms().info("dim")
+    assert 1000 == info.width
+    assert 5 == info.depth
+    assert 25 == info.count
+
+
+@pytest.mark.redismod
+def test_cms_merge(client):
+    assert client.cms().initbydim("A", 1000, 5)
+    assert client.cms().initbydim("B", 1000, 5)
+    assert client.cms().initbydim("C", 1000, 5)
+    assert client.cms().incrby("A", ["foo", "bar", "baz"], [5, 3, 9])
+    assert client.cms().incrby("B", ["foo", "bar", "baz"], [2, 3, 1])
+    assert [5, 3, 9] == client.cms().query("A", "foo", "bar", "baz")
+    assert [2, 3, 1] == client.cms().query("B", "foo", "bar", "baz")
+    assert client.cms().merge("C", 2, ["A", "B"])
+    assert [7, 6, 10] == client.cms().query("C", "foo", "bar", "baz")
+    assert client.cms().merge("C", 2, ["A", "B"], ["1", "2"])
+    assert [9, 9, 11] == client.cms().query("C", "foo", "bar", "baz")
+    assert client.cms().merge("C", 2, ["A", "B"], ["2", "3"])
+    assert [16, 15, 21] == client.cms().query("C", "foo", "bar", "baz")
+
+
+# endregion
+
+
+# region Test Top-K
+@pytest.mark.redismod
+def test_topk(client):
+    # test list with empty buckets
+    assert client.topk().reserve("topk", 3, 50, 4, 0.9)
+    assert [
+        None,
+        None,
+        None,
+        "A",
+        "C",
+        "D",
+        None,
+        None,
+        "E",
+        None,
+        "B",
+        "C",
+        None,
+        None,
+        None,
+        "D",
+        None,
+    ] == client.topk().add(
+        "topk",
+        "A",
+        "B",
+        "C",
+        "D",
+        "E",
+        "A",
+        "A",
+        "B",
+        "C",
+        "G",
+        "D",
+        "B",
+        "D",
+        "A",
+        "E",
+        "E",
+        1,
+    )
+    assert [1, 1, 0, 0, 1, 0, 0] == client.topk().query(
+        "topk", "A", "B", "C", "D", "E", "F", "G"
+    )
+    assert [4, 3, 2, 3, 3, 0, 1] == client.topk().count(
+        "topk", "A", "B", "C", "D", "E", "F", "G"
+    )
+
+    # test full list
+    assert client.topk().reserve("topklist", 3, 50, 3, 0.9)
+    assert client.topk().add(
+        "topklist",
+        "A",
+        "B",
+        "C",
+        "D",
+        "E",
+        "A",
+        "A",
+        "B",
+        "C",
+        "G",
+        "D",
+        "B",
+        "D",
+        "A",
+        "E",
+        "E",
+    )
+    assert ["A", "B", "E"] == client.topk().list("topklist")
+    assert ["A", 4, "B", 3, "E", 3] == client.topk().list("topklist", withcount=True)
+    info = client.topk().info("topklist")
+    assert 3 == info.k
+    assert 50 == info.width
+    assert 3 == info.depth
+    assert 0.9 == round(float(info.decay), 1)
+
+
+@pytest.mark.redismod
+def test_topk_incrby(client):
+    client.flushdb()
+    assert client.topk().reserve("topk", 3, 10, 3, 1)
+    assert [None, None, None] == client.topk().incrby(
+        "topk", ["bar", "baz", "42"], [3, 6, 2]
+    )
+    assert [None, "bar"] == client.topk().incrby("topk", ["42", "xyzzy"], [8, 4])
+    assert [3, 6, 10, 4, 0] == client.topk().count(
+        "topk", "bar", "baz", "42", "xyzzy", 4
+    )
+
+
+# region Test T-Digest
+@pytest.mark.redismod
+def test_tdigest_reset(client):
+    assert client.tdigest().create("tDigest", 10)
+    # reset on empty histogram
+    assert client.tdigest().reset("tDigest")
+    # insert data-points into sketch
+    assert client.tdigest().add("tDigest", list(range(10)), [1.0] * 10)
+
+    assert client.tdigest().reset("tDigest")
+    # assert we have 0 unmerged nodes
+    assert 0 == client.tdigest().info("tDigest").unmergedNodes
+
+
+@pytest.mark.redismod
+def test_tdigest_merge(client):
+    assert client.tdigest().create("to-tDigest", 10)
+    assert client.tdigest().create("from-tDigest", 10)
+    # insert data-points into sketch
+    assert client.tdigest().add("from-tDigest", [1.0] * 10, [1.0] * 10)
+    assert client.tdigest().add("to-tDigest", [2.0] * 10, [10.0] * 10)
+    # merge from-tdigest into to-tdigest
+    assert client.tdigest().merge("to-tDigest", "from-tDigest")
+    # we should now have 110 weight on to-histogram
+    info = client.tdigest().info("to-tDigest")
+    total_weight_to = float(info.mergedWeight) + float(info.unmergedWeight)
+    assert 110 == total_weight_to
+
+
+@pytest.mark.redismod
+def test_tdigest_min_and_max(client):
+    assert client.tdigest().create("tDigest", 100)
+    # insert data-points into sketch
+    assert client.tdigest().add("tDigest", [1, 2, 3], [1.0] * 3)
+    # min/max
+    assert 3 == client.tdigest().max("tDigest")
+    assert 1 == client.tdigest().min("tDigest")
+
+
+@pytest.mark.redismod
+def test_tdigest_quantile(client):
+    assert client.tdigest().create("tDigest", 500)
+    # insert data-points into sketch
+    assert client.tdigest().add(
+        "tDigest", list([x * 0.01 for x in range(1, 10000)]), [1.0] * 10000
+    )
+    # assert min min/max have same result as quantile 0 and 1
+    assert client.tdigest().max("tDigest") == client.tdigest().quantile("tDigest", 1.0)
+    assert client.tdigest().min("tDigest") == client.tdigest().quantile("tDigest", 0.0)
+
+    assert 1.0 == round(client.tdigest().quantile("tDigest", 0.01), 2)
+    assert 99.0 == round(client.tdigest().quantile("tDigest", 0.99), 2)
+
+
+@pytest.mark.redismod
+def test_tdigest_cdf(client):
+    assert client.tdigest().create("tDigest", 100)
+    # insert data-points into sketch
+    assert client.tdigest().add("tDigest", list(range(1, 10)), [1.0] * 10)
+    assert 0.1 == round(client.tdigest().cdf("tDigest", 1.0), 1)
+    assert 0.9 == round(client.tdigest().cdf("tDigest", 9.0), 1)
+
+
+# @pytest.mark.redismod
+# def test_pipeline(client):
+#     pipeline = client.bf().pipeline()
+#     assert not client.bf().execute_command("get pipeline")
+#
+#     assert client.bf().create("pipeline", 0.01, 1000)
+#     for i in range(100):
+#         pipeline.add("pipeline", i)
+#     for i in range(100):
+#         assert not (client.bf().exists("pipeline", i))
+#
+#     pipeline.execute()
+#
+#     for i in range(100):
+#         assert client.bf().exists("pipeline", i)
diff --git a/tox.ini b/tox.ini
index 0ccc9bb537..f4eaedc8c7 100644
--- a/tox.ini
+++ b/tox.ini
@@ -170,6 +170,7 @@ exclude =
     venv*,
     whitelist.py
 ignore =
+    F405
     W503
     E203
     E126

From 8f5c1e6b14c4c82d04a3ad141821e2fdabdd0dab Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Thu, 2 Dec 2021 14:52:46 +0100
Subject: [PATCH 0284/1164] Aggregation loadall (#1735)

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/commands/search/aggregation.py | 14 +++++++++++---
 tests/test_search.py                 |  5 +++++
 2 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/redis/commands/search/aggregation.py b/redis/commands/search/aggregation.py
index 3db5542ae1..061e69c235 100644
--- a/redis/commands/search/aggregation.py
+++ b/redis/commands/search/aggregation.py
@@ -103,6 +103,7 @@ def __init__(self, query="*"):
         self._query = query
         self._aggregateplan = []
         self._loadfields = []
+        self._loadall = False
         self._limit = Limit()
         self._max = 0
         self._with_schema = False
@@ -116,9 +117,13 @@ def load(self, *fields):
 
         ### Parameters
 
-        - **fields**: One or more fields in the format of `@field`
+        - **fields**: If fields not specified, all the fields will be loaded.
+        Otherwise, fields should be given in the format of `@field`.
         """
-        self._loadfields.extend(fields)
+        if fields:
+            self._loadfields.extend(fields)
+        else:
+            self._loadall = True
         return self
 
     def group_by(self, fields, *reducers):
@@ -308,7 +313,10 @@ def build_args(self):
         if self._cursor:
             ret += self._cursor
 
-        if self._loadfields:
+        if self._loadall:
+            ret.append("LOAD")
+            ret.append("*")
+        elif self._loadfields:
             ret.append("LOAD")
             ret.append(str(len(self._loadfields)))
             ret.extend(self._loadfields)
diff --git a/tests/test_search.py b/tests/test_search.py
index 5b6a66009a..1a22b665a8 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1054,6 +1054,11 @@ def test_aggregations_load(client):
     res = client.ft().aggregate(req)
     assert res.rows[0] == ["t2", "world"]
 
+    # load all
+    req = aggregations.AggregateRequest("*").load()
+    res = client.ft().aggregate(req)
+    assert res.rows[0] == ["t1", "hello", "t2", "world"]
+
 
 @pytest.mark.redismod
 def test_aggregations_apply(client):

From 1a59a7a45feaed2bd0e33ccdbcd92cd305fd7e44 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 2 Dec 2021 15:54:29 +0200
Subject: [PATCH 0285/1164] Run actions in Parallel  (#1763)

---
 .github/workflows/integration.yaml | 6 ++++--
 tasks.py                           | 2 +-
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 5384996c70..10ab3ed03e 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -34,9 +34,11 @@ jobs:
        max-parallel: 6
        matrix:
          python-version: ['3.6', '3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
+         test-type: ['standalone', 'cluster']
+         connection-type: ['hiredis', 'plain']
      env:
        ACTIONS_ALLOW_UNSECURE_COMMANDS: true
-     name: Python ${{ matrix.python-version }} tests
+     name: Python ${{ matrix.python-version }} ${{matrix.test-type}}-${{matrix.connection-type}} tests
      steps:
        - uses: actions/checkout@v2
        - name: install python
@@ -46,7 +48,7 @@ jobs:
        - name: run tests
          run: |
            pip install -r dev_requirements.txt
-           invoke tests
+           tox -e ${{matrix.test-type}}-${{matrix.connection-type}}
        - name: Upload codecov coverage
          uses: codecov/codecov-action@v2
          with:
diff --git a/tasks.py b/tasks.py
index 9291e7effb..880e70dcf0 100644
--- a/tasks.py
+++ b/tasks.py
@@ -55,7 +55,7 @@ def standalone_tests(c):
     """Run all Redis tests against the current python,
     with and without hiredis."""
     print("Starting Redis tests")
-    run("tox -e standalone-'{hiredis}'")
+    run("tox -e standalone-'{plain,hiredis}'")
 
 
 @task

From d4a9825a72e1b7715d79ce8134e678d9ef537dce Mon Sep 17 00:00:00 2001
From: Maksim Novikov <maksim.novikov@aiven.io>
Date: Thu, 2 Dec 2021 15:02:43 +0100
Subject: [PATCH 0286/1164] Allow overriding connection class via keyword
 arguments (#1752)

---
 redis/connection.py           |  4 ++++
 tests/test_connection_pool.py | 18 ++++++++++++++++++
 2 files changed, 22 insertions(+)

diff --git a/redis/connection.py b/redis/connection.py
index d13fe65ef8..2001c6447b 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1131,6 +1131,10 @@ class initializer. In the case of conflicting arguments, querystring
         arguments always win.
         """
         url_options = parse_url(url)
+
+        if "connection_class" in kwargs:
+            url_options["connection_class"] = kwargs["connection_class"]
+
         kwargs.update(url_options)
         return cls(**kwargs)
 
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 2602af82e1..276e77cdb9 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -445,6 +445,15 @@ def test_extra_querystring_options(self):
         assert pool.connection_class == redis.UnixDomainSocketConnection
         assert pool.connection_kwargs == {"path": "/socket", "a": "1", "b": "2"}
 
+    def test_connection_class_override(self):
+        class MyConnection(redis.UnixDomainSocketConnection):
+            pass
+
+        pool = redis.ConnectionPool.from_url(
+            'unix:///socket', connection_class=MyConnection
+        )
+        assert pool.connection_class == MyConnection
+
 
 @pytest.mark.skipif(not ssl_available, reason="SSL not installed")
 class TestSSLConnectionURLParsing:
@@ -455,6 +464,15 @@ def test_host(self):
             "host": "my.host",
         }
 
+    def test_connection_class_override(self):
+        class MyConnection(redis.SSLConnection):
+            pass
+
+        pool = redis.ConnectionPool.from_url(
+            'rediss://my.host', connection_class=MyConnection
+        )
+        assert pool.connection_class == MyConnection
+
     def test_cert_reqs_options(self):
         import ssl
 

From 8af9a3f559452cde86b234ee29cfb5627eb69e5b Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 2 Dec 2021 18:36:03 +0200
Subject: [PATCH 0287/1164] Fixing lint merge issue (#1770)

---
 tests/test_connection_pool.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 276e77cdb9..138fcad4c9 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -450,7 +450,7 @@ class MyConnection(redis.UnixDomainSocketConnection):
             pass
 
         pool = redis.ConnectionPool.from_url(
-            'unix:///socket', connection_class=MyConnection
+            "unix:///socket", connection_class=MyConnection
         )
         assert pool.connection_class == MyConnection
 
@@ -469,7 +469,7 @@ class MyConnection(redis.SSLConnection):
             pass
 
         pool = redis.ConnectionPool.from_url(
-            'rediss://my.host', connection_class=MyConnection
+            "rediss://my.host", connection_class=MyConnection
         )
         assert pool.connection_class == MyConnection
 

From 48b19dfc526102864c7289cf1f3c4889c858d359 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 2 Dec 2021 18:36:45 +0200
Subject: [PATCH 0288/1164] Locking latest tag for pythons docker (#1769)

---
 tox.ini | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tox.ini b/tox.ini
index f4eaedc8c7..32d1680a2a 100644
--- a/tox.ini
+++ b/tox.ini
@@ -73,7 +73,7 @@ healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(sock
 
 [docker:lots-of-pythons]
 name = lots-of-pythons
-image = redisfab/lots-of-pythons
+image = redisfab/lots-of-pythons:latest
 volumes =
     bind:rw:{toxinidir}:/data
 

From c2d4621d5da2f4506fb484eb787f004a235c76b1 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Thu, 2 Dec 2021 18:53:00 +0100
Subject: [PATCH 0289/1164] Adding ROLE Command (#1610)

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/commands/core.py | 16 +++++++++++++++-
 tests/test_commands.py |  7 +++++++
 2 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 462fba7f82..fec3095cc5 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -333,6 +333,16 @@ def bgsave(self, schedule=True, **kwargs):
             pieces.append("SCHEDULE")
         return self.execute_command("BGSAVE", *pieces, **kwargs)
 
+    def role(self):
+        """
+        Provide information on the role of a Redis instance in
+        the context of replication, by returning if the instance
+        is currently a master, slave, or sentinel.
+
+        For more information check https://redis.io/commands/role
+        """
+        return self.execute_command("ROLE")
+
     def client_kill(self, address, **kwargs):
         """Disconnects the client at ``address`` (ip:port)
 
@@ -864,11 +874,15 @@ def slowlog_get(self, num=None, **kwargs):
 
         For more information check https://redis.io/commands/slowlog-get
         """
+        from redis.client import NEVER_DECODE
+
         args = ["SLOWLOG GET"]
         if num is not None:
             args.append(num)
         decode_responses = self.get_connection_kwargs().get("decode_responses", False)
-        return self.execute_command(*args, decode_responses=decode_responses, **kwargs)
+        if decode_responses is True:
+            kwargs[NEVER_DECODE] = []
+        return self.execute_command(*args, **kwargs)
 
     def slowlog_len(self, **kwargs):
         """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 7c7d0f3d9e..556df840ad 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -653,6 +653,13 @@ def test_ping(self, r):
     def test_quit(self, r):
         assert r.quit()
 
+    @skip_if_server_version_lt("2.8.12")
+    @pytest.mark.onlynoncluster
+    def test_role(self, r):
+        assert r.role()[0] == b"master"
+        assert isinstance(r.role()[1], int)
+        assert isinstance(r.role()[2], list)
+
     @pytest.mark.onlynoncluster
     def test_slowlog_get(self, r, slowlog):
         assert r.slowlog_reset()

From b7ffec08da97b71b10bbd139b32ff82d33d907f1 Mon Sep 17 00:00:00 2001
From: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Date: Thu, 2 Dec 2021 22:54:08 +0200
Subject: [PATCH 0290/1164] Improved RedisCluster's reinitialize_steps and
 documentation (#1765)

---
 redis/cluster.py      | 36 +++++++++++++++++++++++++++++-------
 tests/test_cluster.py | 20 +++++++++++++++++++-
 2 files changed, 48 insertions(+), 8 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index eead2b4dfe..c5634a05d8 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -414,14 +414,25 @@ def __init__(
              stale data.
              When set to true, read commands will be assigned between the
              primary and its replications in a Round-Robin manner.
-         :cluster_error_retry_attempts: 'int'
+        :cluster_error_retry_attempts: 'int'
              Retry command execution attempts when encountering ClusterDownError
              or ConnectionError
-         :retry_on_timeout: 'bool'
+        :retry_on_timeout: 'bool'
              To specify a retry policy, first set `retry_on_timeout` to `True`
              then set `retry` to a valid `Retry` object
-         :retry: 'Retry'
+        :retry: 'Retry'
               a `Retry` object
+        :reinitialize_steps: 'int'
+            Specifies the number of MOVED errors that need to occur before
+            reinitializing the whole cluster topology. If a MOVED error occurs
+            and the cluster does not need to be reinitialized on this current
+            error handling, only the MOVED slot will be patched with the
+            redirected node.
+            To reinitialize the cluster on every MOVED error, set
+            reinitialize_steps to 1.
+            To avoid reinitializing the cluster on moved errors, set
+            reinitialize_steps to 0.
+
          :**kwargs:
              Extra arguments that will be sent into Redis instance when created
              (See Official redis-py doc for supported kwargs
@@ -727,7 +738,9 @@ def _determine_nodes(self, *args, **kwargs):
             return [node]
 
     def _should_reinitialized(self):
-        # In order not to reinitialize the cluster, the user can set
+        # To reinitialize the cluster on every MOVED error,
+        # set reinitialize_steps to 1.
+        # To avoid reinitializing the cluster on moved errors, set
         # reinitialize_steps to 0.
         if self.reinitialize_steps == 0:
             return False
@@ -958,8 +971,8 @@ def _execute_command(self, target_node, *args, **kwargs):
                 # redirected node output and try again. If MovedError exceeds
                 # 'reinitialize_steps' number of times, we will force
                 # reinitializing the tables, and then try again.
-                # 'reinitialize_steps' counter will increase faster when the
-                # same client object is shared between multiple threads. To
+                # 'reinitialize_steps' counter will increase faster when
+                # the same client object is shared between multiple threads. To
                 # reduce the frequency you can set this variable in the
                 # RedisCluster constructor.
                 log.exception("MovedError")
@@ -1055,6 +1068,10 @@ def __repr__(self):
     def __eq__(self, obj):
         return isinstance(obj, ClusterNode) and obj.name == self.name
 
+    def __del__(self):
+        if self.redis_connection is not None:
+            self.redis_connection.close()
+
 
 class LoadBalancer:
     """
@@ -1300,6 +1317,11 @@ def initialize(self):
                         startup_node.host, startup_node.port, **copy_kwargs
                     )
                     self.startup_nodes[startup_node.name].redis_connection = r
+                # Make sure cluster mode is enabled on this node
+                if bool(r.info().get("cluster_enabled")) is False:
+                    raise RedisClusterException(
+                        "Cluster mode is not enabled on this node"
+                    )
                 cluster_slots = r.execute_command("CLUSTER SLOTS")
                 startup_nodes_reachable = True
             except (ConnectionError, TimeoutError) as e:
@@ -1327,7 +1349,7 @@ def initialize(self):
                 message = e.__str__()
                 raise RedisClusterException(
                     'ERROR sending "cluster slots" command to redis '
-                    f"server: {startup_node}. error: {message}"
+                    f"server {startup_node.name}. error: {message}"
                 )
 
             # CLUSTER SLOTS command results in the following output:
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index b76ed80958..4087d33542 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -84,6 +84,7 @@ def get_mocked_redis_client(func=None, *args, **kwargs):
     """
     cluster_slots = kwargs.pop("cluster_slots", default_cluster_slots)
     coverage_res = kwargs.pop("coverage_result", "yes")
+    cluster_enabled = kwargs.pop("cluster_enabled", True)
     with patch.object(Redis, "execute_command") as execute_command_mock:
 
         def execute_command(*_args, **_kwargs):
@@ -92,7 +93,9 @@ def execute_command(*_args, **_kwargs):
                 return mock_cluster_slots
             elif _args[0] == "COMMAND":
                 return {"get": [], "set": []}
-            elif _args[1] == "cluster-require-full-coverage":
+            elif _args[0] == "INFO":
+                return {"cluster_enabled": cluster_enabled}
+            elif len(_args) > 1 and _args[1] == "cluster-require-full-coverage":
                 return {"cluster-require-full-coverage": coverage_res}
             elif func is not None:
                 return func(*args, **kwargs)
@@ -1974,6 +1977,17 @@ def test_init_slots_cache(self):
 
         assert len(n_manager.nodes_cache) == 6
 
+    def test_init_slots_cache_cluster_mode_disabled(self):
+        """
+        Test that creating a RedisCluster failes if one of the startup nodes
+        has cluster mode disabled
+        """
+        with pytest.raises(RedisClusterException) as e:
+            get_mocked_redis_client(
+                host=default_host, port=default_port, cluster_enabled=False
+            )
+            assert "Cluster mode is not enabled on this node" in str(e.value)
+
     def test_empty_startup_nodes(self):
         """
         It should not be possible to create a node manager with no nodes
@@ -2044,6 +2058,8 @@ def create_mocked_redis_node(host, port, **kwargs):
                 def execute_command(*args, **kwargs):
                     if args[0] == "CLUSTER SLOTS":
                         return result
+                    elif args[0] == "INFO":
+                        return {"cluster_enabled": True}
                     elif args[1] == "cluster-require-full-coverage":
                         return {"cluster-require-full-coverage": "yes"}
                     else:
@@ -2108,6 +2124,8 @@ def execute_command(*args, **kwargs):
                                 ["127.0.0.1", 7002, "node_2"],
                             ],
                         ]
+                    elif args[0] == "INFO":
+                        return {"cluster_enabled": True}
                     elif args[1] == "cluster-require-full-coverage":
                         return {"cluster-require-full-coverage": "yes"}
 

From 11b14630a6845c28acfd4220b72ed62d72913305 Mon Sep 17 00:00:00 2001
From: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Date: Thu, 2 Dec 2021 22:59:06 +0200
Subject: [PATCH 0291/1164] Added support for MONITOR in clusters (#1756)

---
 redis/cluster.py              | 17 +++++++++++
 tests/conftest.py             | 20 +++++++------
 tests/test_cluster.py         | 54 ++++++++++++++++++++++++++++++++++-
 tests/test_commands.py        | 53 +++++++++++++++++-----------------
 tests/test_connection_pool.py | 12 ++++----
 tests/test_monitor.py         |  4 +--
 tests/test_pubsub.py          |  2 +-
 7 files changed, 117 insertions(+), 45 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index c5634a05d8..b1adeb7341 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -670,6 +670,23 @@ def set_default_node(self, node):
         log.info(f"Changed the default cluster node to {node}")
         return True
 
+    def monitor(self, target_node=None):
+        """
+        Returns a Monitor object for the specified target node.
+        The default cluster node will be selected if no target node was
+        specified.
+        Monitor is useful for handling the MONITOR command to the redis server.
+        next_command() method returns one command from monitor
+        listen() method yields commands from monitor.
+        """
+        if target_node is None:
+            target_node = self.get_default_node()
+        if target_node.redis_connection is None:
+            raise RedisClusterException(
+                f"Cluster Node {target_node.name} has no redis_connection"
+            )
+        return target_node.redis_connection.monitor()
+
     def pubsub(self, node=None, host=None, port=None, **kwargs):
         """
         Allows passing a ClusterNode, or host&port, to get a pubsub instance
diff --git a/tests/conftest.py b/tests/conftest.py
index 24783c0466..ab29ee4fcd 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -151,12 +151,12 @@ def skip_ifmodversion_lt(min_version: str, module_name: str):
     raise AttributeError(f"No redis module named {module_name}")
 
 
-def skip_if_redis_enterprise(func):
+def skip_if_redis_enterprise():
     check = REDIS_INFO["enterprise"] is True
     return pytest.mark.skipif(check, reason="Redis enterprise")
 
 
-def skip_ifnot_redis_enterprise(func):
+def skip_ifnot_redis_enterprise():
     check = REDIS_INFO["enterprise"] is False
     return pytest.mark.skipif(check, reason="Not running in redis enterprise")
 
@@ -324,16 +324,18 @@ def master_host(request):
     yield parts.hostname, parts.port
 
 
-def wait_for_command(client, monitor, command):
+def wait_for_command(client, monitor, command, key=None):
     # issue a command with a key name that's local to this process.
     # if we find a command with our key before the command we're waiting
     # for, something went wrong
-    redis_version = REDIS_INFO["version"]
-    if LooseVersion(redis_version) >= LooseVersion("5.0.0"):
-        id_str = str(client.client_id())
-    else:
-        id_str = f"{random.randrange(2 ** 32):08x}"
-    key = f"__REDIS-PY-{id_str}__"
+    if key is None:
+        # generate key
+        redis_version = REDIS_INFO["version"]
+        if LooseVersion(redis_version) >= LooseVersion("5.0.0"):
+            id_str = str(client.client_id())
+        else:
+            id_str = f"{random.randrange(2 ** 32):08x}"
+        key = f"__REDIS-PY-{id_str}__"
     client.get(key)
     while True:
         monitor_response = monitor.next_command()
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 4087d33542..15d8ac6c35 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -36,6 +36,7 @@
     skip_if_redis_enterprise,
     skip_if_server_version_lt,
     skip_unless_arch_bits,
+    wait_for_command,
 )
 
 default_host = "127.0.0.1"
@@ -1774,7 +1775,7 @@ def test_cluster_randomkey(self, r):
         assert r.randomkey(target_nodes=node) in (b"{foo}a", b"{foo}b", b"{foo}c")
 
     @skip_if_server_version_lt("6.0.0")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_acl_log(self, r, request):
         key = "{cache}:"
         node = r.get_node_from_key(key)
@@ -2631,3 +2632,54 @@ def test_readonly_pipeline_from_readonly_client(self, request):
                         if executed_on_replica:
                             break
                 assert executed_on_replica is True
+
+
+@pytest.mark.onlycluster
+class TestClusterMonitor:
+    def test_wait_command_not_found(self, r):
+        "Make sure the wait_for_command func works when command is not found"
+        key = "foo"
+        node = r.get_node_from_key(key)
+        with r.monitor(target_node=node) as m:
+            response = wait_for_command(r, m, "nothing", key=key)
+            assert response is None
+
+    def test_response_values(self, r):
+        db = 0
+        key = "foo"
+        node = r.get_node_from_key(key)
+        with r.monitor(target_node=node) as m:
+            r.ping(target_nodes=node)
+            response = wait_for_command(r, m, "PING", key=key)
+            assert isinstance(response["time"], float)
+            assert response["db"] == db
+            assert response["client_type"] in ("tcp", "unix")
+            assert isinstance(response["client_address"], str)
+            assert isinstance(response["client_port"], str)
+            assert response["command"] == "PING"
+
+    def test_command_with_quoted_key(self, r):
+        key = "{foo}1"
+        node = r.get_node_from_key(key)
+        with r.monitor(node) as m:
+            r.get('{foo}"bar')
+            response = wait_for_command(r, m, 'GET {foo}"bar', key=key)
+            assert response["command"] == 'GET {foo}"bar'
+
+    def test_command_with_binary_data(self, r):
+        key = "{foo}1"
+        node = r.get_node_from_key(key)
+        with r.monitor(target_node=node) as m:
+            byte_string = b"{foo}bar\x92"
+            r.get(byte_string)
+            response = wait_for_command(r, m, "GET {foo}bar\\x92", key=key)
+            assert response["command"] == "GET {foo}bar\\x92"
+
+    def test_command_with_escaped_data(self, r):
+        key = "{foo}1"
+        node = r.get_node_from_key(key)
+        with r.monitor(target_node=node) as m:
+            byte_string = b"{foo}bar\\x92"
+            r.get(byte_string)
+            response = wait_for_command(r, m, "GET {foo}bar\\\\x92", key=key)
+            assert response["command"] == "GET {foo}bar\\\\x92"
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 556df840ad..936cbe5a40 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -84,7 +84,7 @@ def test_acl_cat_with_category(self, r):
         assert "get" in commands
 
     @skip_if_server_version_lt("6.0.0")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_acl_deluser(self, r, request):
         username = "redis-py-user"
 
@@ -109,7 +109,7 @@ def teardown():
         assert r.acl_getuser(users[4]) is None
 
     @skip_if_server_version_lt("6.0.0")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_acl_genpass(self, r):
         password = r.acl_genpass()
         assert isinstance(password, str)
@@ -123,7 +123,7 @@ def test_acl_genpass(self, r):
         assert isinstance(password, str)
 
     @skip_if_server_version_lt("6.0.0")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_acl_getuser_setuser(self, r, request):
         username = "redis-py-user"
 
@@ -236,7 +236,7 @@ def test_acl_help(self, r):
         assert len(res) != 0
 
     @skip_if_server_version_lt("6.0.0")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_acl_list(self, r, request):
         username = "redis-py-user"
 
@@ -250,7 +250,8 @@ def teardown():
         assert len(users) == 2
 
     @skip_if_server_version_lt("6.0.0")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
+    @pytest.mark.onlynoncluster
     def test_acl_log(self, r, request):
         username = "redis-py-user"
 
@@ -292,7 +293,7 @@ def teardown():
         assert r.acl_log_reset()
 
     @skip_if_server_version_lt("6.0.0")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_acl_setuser_categories_without_prefix_fails(self, r, request):
         username = "redis-py-user"
 
@@ -305,7 +306,7 @@ def teardown():
             r.acl_setuser(username, categories=["list"])
 
     @skip_if_server_version_lt("6.0.0")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_acl_setuser_commands_without_prefix_fails(self, r, request):
         username = "redis-py-user"
 
@@ -318,7 +319,7 @@ def teardown():
             r.acl_setuser(username, commands=["get"])
 
     @skip_if_server_version_lt("6.0.0")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_acl_setuser_add_passwords_and_nopass_fails(self, r, request):
         username = "redis-py-user"
 
@@ -363,7 +364,7 @@ def test_client_list_types_not_replica(self, r):
             clients = r.client_list(_type=client_type)
             assert isinstance(clients, list)
 
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_client_list_replica(self, r):
         clients = r.client_list(_type="replica")
         assert isinstance(clients, list)
@@ -529,7 +530,7 @@ def test_client_kill_filter_by_laddr(self, r, r2):
         assert r.client_kill_filter(laddr=client_2_addr)
 
     @skip_if_server_version_lt("6.0.0")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_client_kill_filter_by_user(self, r, request):
         killuser = "user_to_kill"
         r.acl_setuser(
@@ -549,7 +550,7 @@ def test_client_kill_filter_by_user(self, r, request):
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.9.50")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_client_pause(self, r):
         assert r.client_pause(1)
         assert r.client_pause(timeout=1)
@@ -558,7 +559,7 @@ def test_client_pause(self, r):
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.2.0")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_client_unpause(self, r):
         assert r.client_unpause() == b"OK"
 
@@ -578,7 +579,7 @@ def test_client_reply(self, r, r_timeout):
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_client_getredir(self, r):
         assert isinstance(r.client_getredir(), int)
         assert r.client_getredir() == -1
@@ -590,7 +591,7 @@ def test_config_get(self, r):
         # assert data['maxmemory'].isdigit()
 
     @pytest.mark.onlynoncluster
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_config_resetstat(self, r):
         r.ping()
         prior_commands_processed = int(r.info()["total_commands_processed"])
@@ -599,7 +600,7 @@ def test_config_resetstat(self, r):
         reset_commands_processed = int(r.info()["total_commands_processed"])
         assert reset_commands_processed < prior_commands_processed
 
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_config_set(self, r):
         r.config_set("timeout", 70)
         assert r.config_get()["timeout"] == "70"
@@ -626,7 +627,7 @@ def test_info(self, r):
         assert "redis_version" in info.keys()
 
     @pytest.mark.onlynoncluster
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_lastsave(self, r):
         assert isinstance(r.lastsave(), datetime.datetime)
 
@@ -731,7 +732,7 @@ def test_time(self, r):
         assert isinstance(t[0], int)
         assert isinstance(t[1], int)
 
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_bgsave(self, r):
         assert r.bgsave()
         time.sleep(0.3)
@@ -1312,7 +1313,7 @@ def test_stralgo_lcs(self, r):
         value2 = "mynewtext"
         res = "mytext"
 
-        if skip_if_redis_enterprise(None).args[0] is True:
+        if skip_if_redis_enterprise().args[0] is True:
             with pytest.raises(redis.exceptions.ResponseError):
                 assert r.stralgo("LCS", value1, value2) == res
             return
@@ -1354,7 +1355,7 @@ def test_strlen(self, r):
     def test_substr(self, r):
         r["a"] = "0123456789"
 
-        if skip_if_redis_enterprise(None).args[0] is True:
+        if skip_if_redis_enterprise().args[0] is True:
             with pytest.raises(redis.exceptions.ResponseError):
                 assert r.substr("a", 0) == b"0123456789"
             return
@@ -2665,7 +2666,7 @@ def test_cluster_slaves(self, mock_cluster_resp_slaves):
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("3.0.0")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_readwrite(self, r):
         assert r.readwrite()
 
@@ -4016,7 +4017,7 @@ def test_memory_doctor(self, r):
 
     @skip_if_server_version_lt("4.0.0")
     def test_memory_malloc_stats(self, r):
-        if skip_if_redis_enterprise(None).args[0] is True:
+        if skip_if_redis_enterprise().args[0] is True:
             with pytest.raises(redis.exceptions.ResponseError):
                 assert r.memory_malloc_stats()
             return
@@ -4029,7 +4030,7 @@ def test_memory_stats(self, r):
         # has data
         r.set("foo", "bar")
 
-        if skip_if_redis_enterprise(None).args[0] is True:
+        if skip_if_redis_enterprise().args[0] is True:
             with pytest.raises(redis.exceptions.ResponseError):
                 stats = r.memory_stats()
             return
@@ -4047,7 +4048,7 @@ def test_memory_usage(self, r):
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("4.0.0")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_module_list(self, r):
         assert isinstance(r.module_list(), list)
         for x in r.module_list():
@@ -4088,7 +4089,7 @@ def test_command(self, r):
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("4.0.0")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_module(self, r):
         with pytest.raises(redis.exceptions.ModuleError) as excinfo:
             r.module_load("/some/fake/path")
@@ -4144,7 +4145,7 @@ def test_restore_frequency(self, r):
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("5.0.0")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_replicaof(self, r):
         with pytest.raises(redis.ResponseError):
             assert r.replicaof("NO ONE")
@@ -4226,7 +4227,7 @@ def test_22_info(self, r):
         assert "6" in parsed["allocation_stats"]
         assert ">=256" in parsed["allocation_stats"]
 
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_large_responses(self, r):
         "The PythonParser has some special cases for return values > 1MB"
         # load up 5MB of data into a key
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 138fcad4c9..3e1fbaed27 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -514,7 +514,7 @@ def test_on_connect_error(self):
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.8.8")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_busy_loading_disconnects_socket(self, r):
         """
         If Redis raises a LOADING error, the connection should be
@@ -526,7 +526,7 @@ def test_busy_loading_disconnects_socket(self, r):
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.8.8")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_busy_loading_from_pipeline_immediate_command(self, r):
         """
         BusyLoadingErrors should raise from Pipelines that execute a
@@ -542,7 +542,7 @@ def test_busy_loading_from_pipeline_immediate_command(self, r):
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.8.8")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_busy_loading_from_pipeline(self, r):
         """
         BusyLoadingErrors should be raised from a pipeline execution
@@ -558,7 +558,7 @@ def test_busy_loading_from_pipeline(self, r):
         assert not pool._available_connections[0]._sock
 
     @skip_if_server_version_lt("2.8.8")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_read_only_error(self, r):
         "READONLY errors get turned in ReadOnlyError exceptions"
         with pytest.raises(redis.ReadOnlyError):
@@ -584,7 +584,7 @@ def test_connect_from_url_unix(self):
             "path=/path/to/socket,db=0",
         )
 
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_connect_no_auth_supplied_when_required(self, r):
         """
         AuthenticationError should be raised when the server requires a
@@ -595,7 +595,7 @@ def test_connect_no_auth_supplied_when_required(self, r):
                 "DEBUG", "ERROR", "ERR Client sent AUTH, but no password is set"
             )
 
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_connect_invalid_password_supplied(self, r):
         "AuthenticationError should be raised when sending the wrong password"
         with pytest.raises(redis.AuthenticationError):
diff --git a/tests/test_monitor.py b/tests/test_monitor.py
index 40d9e43094..9b07c80201 100644
--- a/tests/test_monitor.py
+++ b/tests/test_monitor.py
@@ -47,7 +47,7 @@ def test_command_with_escaped_data(self, r):
             response = wait_for_command(r, m, "GET foo\\\\x92")
             assert response["command"] == "GET foo\\\\x92"
 
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_lua_script(self, r):
         with r.monitor() as m:
             script = 'return redis.call("GET", "foo")'
@@ -58,7 +58,7 @@ def test_lua_script(self, r):
             assert response["client_address"] == "lua"
             assert response["client_port"] == ""
 
-    @skip_ifnot_redis_enterprise
+    @skip_ifnot_redis_enterprise()
     def test_lua_script_in_enterprise(self, r):
         with r.monitor() as m:
             script = 'return redis.call("GET", "foo")'
diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index 6df0fafd4b..20ae0a05c1 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -530,7 +530,7 @@ def test_send_pubsub_ping_message(self, r):
 @pytest.mark.onlynoncluster
 class TestPubSubConnectionKilled:
     @skip_if_server_version_lt("3.0.0")
-    @skip_if_redis_enterprise
+    @skip_if_redis_enterprise()
     def test_connection_error_raised_when_connection_dies(self, r):
         p = r.pubsub()
         p.subscribe("foo")

From 748c8d1029f018e752b4039253dcb8de2fc57a34 Mon Sep 17 00:00:00 2001
From: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Date: Wed, 8 Dec 2021 10:17:38 +0200
Subject: [PATCH 0292/1164] Fix cluster ACL tests (#1774)

---
 tests/test_cluster.py  | 2 +-
 tests/test_commands.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 15d8ac6c35..e1c8c34768 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -1789,7 +1789,7 @@ def teardown():
             username,
             enabled=True,
             reset=True,
-            commands=["+get", "+set", "+select", "+cluster", "+command"],
+            commands=["+get", "+set", "+select", "+cluster", "+command", "+info"],
             keys=["{cache}:*"],
             nopass=True,
             target_nodes="primaries",
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 936cbe5a40..eab9072c0d 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -537,7 +537,7 @@ def test_client_kill_filter_by_user(self, r, request):
             killuser,
             enabled=True,
             reset=True,
-            commands=["+get", "+set", "+select", "+cluster", "+command"],
+            commands=["+get", "+set", "+select", "+cluster", "+command", "+info"],
             keys=["cache:*"],
             nopass=True,
         )

From bba31cde198fa16520eaf3cc272b403d13e00fdc Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 8 Dec 2021 13:04:51 +0200
Subject: [PATCH 0293/1164] Removing distutils from tests (#1773)

Co-authored-by: Bar Shaul <88437685+barshaul@users.noreply.github.com>
---
 tests/conftest.py    | 8 ++++----
 tests/test_search.py | 4 ++--
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/tests/conftest.py b/tests/conftest.py
index ab29ee4fcd..4b5f6cbd5c 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -1,10 +1,10 @@
 import random
 import time
-from distutils.version import LooseVersion
 from unittest.mock import Mock
 from urllib.parse import urlparse
 
 import pytest
+from packaging.version import Version
 
 import redis
 from redis.backoff import NoBackoff
@@ -117,13 +117,13 @@ def wait_for_cluster_creation(redis_url, cluster_nodes, timeout=20):
 
 def skip_if_server_version_lt(min_version):
     redis_version = REDIS_INFO["version"]
-    check = LooseVersion(redis_version) < LooseVersion(min_version)
+    check = Version(redis_version) < Version(min_version)
     return pytest.mark.skipif(check, reason=f"Redis version required >= {min_version}")
 
 
 def skip_if_server_version_gte(min_version):
     redis_version = REDIS_INFO["version"]
-    check = LooseVersion(redis_version) >= LooseVersion(min_version)
+    check = Version(redis_version) >= Version(min_version)
     return pytest.mark.skipif(check, reason=f"Redis version required < {min_version}")
 
 
@@ -331,7 +331,7 @@ def wait_for_command(client, monitor, command, key=None):
     if key is None:
         # generate key
         redis_version = REDIS_INFO["version"]
-        if LooseVersion(redis_version) >= LooseVersion("5.0.0"):
+        if Version(redis_version) >= Version("5.0.0"):
             id_str = str(client.client_id())
         else:
             id_str = f"{random.randrange(2 ** 32):08x}"
diff --git a/tests/test_search.py b/tests/test_search.py
index 1a22b665a8..7d666cbd96 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1419,7 +1419,7 @@ def test_profile(client):
     assert det["Iterators profile"]["Counter"] == 2.0
     assert len(det["Iterators profile"]["Child iterators"]) == 2
     assert det["Iterators profile"]["Type"] == "UNION"
-    assert det["Parsing time"] < 0.3
+    assert det["Parsing time"] < 0.5
     assert len(res.docs) == 2  # check also the search result
 
     # check using AggregateRequest
@@ -1431,7 +1431,7 @@ def test_profile(client):
     res, det = client.ft().profile(req)
     assert det["Iterators profile"]["Counter"] == 2.0
     assert det["Iterators profile"]["Type"] == "WILDCARD"
-    assert det["Parsing time"] < 0.3
+    assert det["Parsing time"] < 0.5
     assert len(res.rows) == 2  # check also the search result
 
 

From 291baa93b8712d104ce50a61f52e23b68e2b7a99 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 8 Dec 2021 18:15:32 +0200
Subject: [PATCH 0294/1164] Fixing the license link in the readme (#1778)

---
 README.md | 104 +++++++++++++++++++++++++++---------------------------
 1 file changed, 52 insertions(+), 52 deletions(-)

diff --git a/README.md b/README.md
index f9d6309231..f8e76701fe 100644
--- a/README.md
+++ b/README.md
@@ -2,10 +2,10 @@
 
 The Python interface to the Redis key-value store.
 
-[![CI](https://github.com/redis/redis-py/workflows/CI/badge.svg?branch=master)](https://github.com/redis/redis-py/actions?query=workflow%3ACI+branch%3Amaster) 
-[![docs](https://readthedocs.org/projects/redis-py/badge/?version=stable&style=flat)](https://redis-py.readthedocs.io/en/stable/) 
-[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE.txt)
-[![pypi](https://badge.fury.io/py/redis.svg)](https://pypi.org/project/redis/) 
+[![CI](https://github.com/redis/redis-py/workflows/CI/badge.svg?branch=master)](https://github.com/redis/redis-py/actions?query=workflow%3ACI+branch%3Amaster)
+[![docs](https://readthedocs.org/projects/redis-py/badge/?version=stable&style=flat)](https://redis-py.readthedocs.io/en/stable/)
+[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
+[![pypi](https://badge.fury.io/py/redis.svg)](https://pypi.org/project/redis/)
 [![codecov](https://codecov.io/gh/redis/redis-py/branch/master/graph/badge.svg?token=yenl5fzxxr)](https://codecov.io/gh/redis/redis-py)
 [![Total alerts](https://img.shields.io/lgtm/alerts/g/redis/redis-py.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/redis/redis-py/alerts/)
 
@@ -72,7 +72,7 @@ specified.
 The default encoding is utf-8, but this can be customized by specifiying the
 encoding argument for the redis.Redis class.
 The encoding will be used to automatically encode any
-strings passed to commands, such as key names and values. 
+strings passed to commands, such as key names and values.
 
 
 --------------------
@@ -951,16 +951,16 @@ C 3
 redis-py is now supports cluster mode and provides a client for
 [Redis Cluster](<https://redis.io/topics/cluster-tutorial>).
 
-The cluster client is based on Grokzen's 
-[redis-py-cluster](https://github.com/Grokzen/redis-py-cluster), has added bug 
-fixes, and now supersedes that library. Support for these changes is thanks to 
+The cluster client is based on Grokzen's
+[redis-py-cluster](https://github.com/Grokzen/redis-py-cluster), has added bug
+fixes, and now supersedes that library. Support for these changes is thanks to
 his contributions.
 
 
 **Create RedisCluster:**
 
-Connecting redis-py to a Redis Cluster instance(s) requires at a minimum a 
-single node for cluster discovery. There are multiple ways in which a cluster 
+Connecting redis-py to a Redis Cluster instance(s) requires at a minimum a
+single node for cluster discovery. There are multiple ways in which a cluster
 instance can be created:
 
 - Using 'host' and 'port' arguments:
@@ -1001,16 +1001,16 @@ RedisCluster instance can be directly used to execute Redis commands. When a
 command is being executed through the cluster instance, the target node(s) will
 be internally determined. When using a key-based command, the target node will
 be the node that holds the key's slot.
-Cluster management commands and other commands that are not key-based have a 
-parameter called 'target_nodes' where you can specify which nodes to execute 
-the command on. In the absence of target_nodes, the command will be executed 
-on the default cluster node. As part of cluster instance initialization, the 
-cluster's default node is randomly selected from the cluster's primaries, and 
-will be updated upon reinitialization. Using r.get_default_node(), you can 
-get the cluster's default node, or you can change it using the 
+Cluster management commands and other commands that are not key-based have a
+parameter called 'target_nodes' where you can specify which nodes to execute
+the command on. In the absence of target_nodes, the command will be executed
+on the default cluster node. As part of cluster instance initialization, the
+cluster's default node is randomly selected from the cluster's primaries, and
+will be updated upon reinitialization. Using r.get_default_node(), you can
+get the cluster's default node, or you can change it using the
 'set_default_node' method.
 
-The 'target_nodes' parameter is explained in the following section, 
+The 'target_nodes' parameter is explained in the following section,
 'Specifying Target Nodes'.
 
 ``` pycon
@@ -1030,8 +1030,8 @@ The 'target_nodes' parameter is explained in the following section,
 
 **Specifying Target Nodes:**
 
-As mentioned above, all non key-based RedisCluster commands accept the kwarg 
-parameter 'target_nodes' that specifies the node/nodes that the command should 
+As mentioned above, all non key-based RedisCluster commands accept the kwarg
+parameter 'target_nodes' that specifies the node/nodes that the command should
 be executed on.
 The best practice is to specify target nodes using RedisCluster class's node
 flags: PRIMARIES, REPLICAS, ALL_NODES, RANDOM. When a nodes flag is passed
@@ -1070,7 +1070,7 @@ the relevant cluster or connection error will be returned.
     >>> rc.info(target_nodes=subset_primaries)
 ```
 
-In addition, the RedisCluster instance can query the Redis instance of a 
+In addition, the RedisCluster instance can query the Redis instance of a
 specific node and execute commands on that node directly. The Redis client,
 however, does not handle cluster failures and retries.
 
@@ -1094,7 +1094,7 @@ By using RedisCluster client, you can use the known functions (e.g. mget, mset)
 to perform an atomic multi-key operation. However, you must ensure all keys are
 mapped to the same slot, otherwise a RedisClusterException will be thrown.
 Redis Cluster implements a concept called hash tags that can be used in order
-to force certain keys to be stored in the same hash slot, see 
+to force certain keys to be stored in the same hash slot, see
 [Keys hash tag](https://redis.io/topics/cluster-spec#keys-hash-tags).
 You can also use nonatomic for some of the multikey operations, and pass keys
 that aren't mapped to the same slot. The client will then map the keys to the
@@ -1121,15 +1121,15 @@ first command execution. The node will be determined by:
  1. Hashing the channel name in the request to find its keyslot
  2. Selecting a node that handles the keyslot: If read_from_replicas is
     set to true, a replica can be selected.
-    
+
 *Known limitations with pubsub:*
 
-Pattern subscribe and publish do not currently work properly due to key slots. 
-If we hash a pattern like fo* we will receive a keyslot for that string but 
-there are endless possibilities for channel names based on this pattern - 
-unknowable in advance. This feature is not disabled but the commands are not 
+Pattern subscribe and publish do not currently work properly due to key slots.
+If we hash a pattern like fo* we will receive a keyslot for that string but
+there are endless possibilities for channel names based on this pattern -
+unknowable in advance. This feature is not disabled but the commands are not
 currently recommended for use.
-See [redis-py-cluster documentation](https://redis-py-cluster.readthedocs.io/en/stable/pubsub.html) 
+See [redis-py-cluster documentation](https://redis-py-cluster.readthedocs.io/en/stable/pubsub.html)
  for more.
 
 ``` pycon
@@ -1142,22 +1142,22 @@ See [redis-py-cluster documentation](https://redis-py-cluster.readthedocs.io/en/
 
 **Read Only Mode**
 
-By default, Redis Cluster always returns MOVE redirection response on accessing 
-a replica node. You can overcome this limitation and scale read commands by 
+By default, Redis Cluster always returns MOVE redirection response on accessing
+a replica node. You can overcome this limitation and scale read commands by
 triggering READONLY mode.
 
-To enable READONLY mode pass read_from_replicas=True to RedisCluster 
+To enable READONLY mode pass read_from_replicas=True to RedisCluster
 constructor. When set to true, read commands will be assigned between the
-primary and its replications in a Round-Robin manner. 
+primary and its replications in a Round-Robin manner.
 
-READONLY mode can be set at runtime by calling the readonly() method with 
-target_nodes='replicas', and read-write access can be restored by calling the 
+READONLY mode can be set at runtime by calling the readonly() method with
+target_nodes='replicas', and read-write access can be restored by calling the
 readwrite() method.
 
 ``` pycon
     >>> from cluster import RedisCluster as Redis
     # Use 'debug' log level to print the node that the command is executed on
-    >>> rc_readonly = Redis(startup_nodes=startup_nodes, 
+    >>> rc_readonly = Redis(startup_nodes=startup_nodes,
                     read_from_replicas=True)
     >>> rc_readonly.set('{foo}1', 'bar1')
     >>> for i in range(0, 4):
@@ -1173,15 +1173,15 @@ readwrite() method.
 
 **Cluster Pipeline**
 
-ClusterPipeline is a subclass of RedisCluster that provides support for Redis 
-pipelines in cluster mode. 
-When calling the execute() command, all the commands are grouped by the node 
-on which they will be executed, and are then executed by the respective nodes 
-in parallel. The pipeline instance will wait for all the nodes to respond 
-before returning the result to the caller. Command responses are returned as a 
+ClusterPipeline is a subclass of RedisCluster that provides support for Redis
+pipelines in cluster mode.
+When calling the execute() command, all the commands are grouped by the node
+on which they will be executed, and are then executed by the respective nodes
+in parallel. The pipeline instance will wait for all the nodes to respond
+before returning the result to the caller. Command responses are returned as a
 list sorted in the same order in which they were sent.
-Pipelines can be used to dramatically increase the throughput of Redis Cluster 
-by significantly reducing the the number of network round trips between the 
+Pipelines can be used to dramatically increase the throughput of Redis Cluster
+by significantly reducing the the number of network round trips between the
 client and the server.
 
 ``` pycon
@@ -1198,16 +1198,16 @@ client and the server.
 Please note:
 - RedisCluster pipelines currently only support key-based commands.
 - The pipeline gets its 'read_from_replicas' value from the cluster's parameter.
-Thus, if read from replications is enabled in the cluster instance, the pipeline 
+Thus, if read from replications is enabled in the cluster instance, the pipeline
 will also direct read commands to replicas.
-- The 'transcation' option is NOT supported in cluster-mode. In non-cluster mode, 
-the 'transaction' option is available when executing pipelines. This wraps the 
-pipeline commands with MULTI/EXEC commands, and effectively turns the pipeline 
-commands into a single transaction block. This means that all commands are 
-executed sequentially without any interruptions from other clients. However, 
-in cluster-mode this is not possible, because commands are partitioned 
-according to their respective destination nodes. This means that we can not 
-turn the pipeline commands into one transaction block, because in most cases 
+- The 'transcation' option is NOT supported in cluster-mode. In non-cluster mode,
+the 'transaction' option is available when executing pipelines. This wraps the
+pipeline commands with MULTI/EXEC commands, and effectively turns the pipeline
+commands into a single transaction block. This means that all commands are
+executed sequentially without any interruptions from other clients. However,
+in cluster-mode this is not possible, because commands are partitioned
+according to their respective destination nodes. This means that we can not
+turn the pipeline commands into one transaction block, because in most cases
 they are split up into several smaller pipelines.
 
 

From a58f4235e554cb50b312caf1a9076114c77d0529 Mon Sep 17 00:00:00 2001
From: Sebastian Pipping <sebastian@pipping.org>
Date: Thu, 9 Dec 2021 08:45:14 +0100
Subject: [PATCH 0295/1164] Add packaging to setup_requires, and use >= to play
 nice to setup.py (fixes #1625) (#1780)

---
 setup.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/setup.py b/setup.py
index 58d753fb3a..b9c2e3e315 100644
--- a/setup.py
+++ b/setup.py
@@ -26,9 +26,12 @@
     author="Redis Inc.",
     author_email="oss@redis.com",
     python_requires=">=3.6",
+    setup_requires=[
+        "packaging>=21.3",
+    ],
     install_requires=[
-        "deprecated==1.2.3",
-        "packaging==21.3",
+        "deprecated>=1.2.3",
+        "packaging>=21.3",
     ],
     classifiers=[
         "Development Status :: 5 - Production/Stable",

From 12c17bfc436ea6784bbc8b2d327d981520858eb7 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 9 Dec 2021 09:49:35 +0200
Subject: [PATCH 0296/1164] Adding cluster, bloom, and graph docs (#1779)

---
 docs/index.rst                                |  20 ++-
 docs/redis_cluster_commands.rst               |   7 +
 ...s_core_commands.rst => redis_commands.rst} |   6 +-
 docs/redismodules.rst                         | 123 +++++++++++++++++-
 redis/commands/bf/commands.py                 |   6 +-
 redis/commands/graph/commands.py              |   2 +
 6 files changed, 152 insertions(+), 12 deletions(-)
 create mode 100644 docs/redis_cluster_commands.rst
 rename docs/{redis_core_commands.rst => redis_commands.rst} (88%)

diff --git a/docs/index.rst b/docs/index.rst
index 8e243f3e28..d088708e50 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -16,21 +16,30 @@ redis-py can be installed using pip via ``pip install redis``.
 
 
 Quickly connecting to redis
-************
+***************************
 
 There are two quick ways to connect to Redis.
 
-Assuming you run Redis on localhost:6379 (the default)::
+**Assuming you run Redis on localhost:6379 (the default)**
+
+.. code-block:: python
+
    import redis
    r = redis.Redis()
    r.ping()
 
-Running redis on foo.bar.com, port 12345::
+**Running redis on foo.bar.com, port 12345**
+
+.. code-block:: python
+
    import redis
    r = redis.Redis(host='foo.bar.com', port=12345)
    r.ping()
 
-Another example with foo.bar.com, port 12345::
+**Another example with foo.bar.com, port 12345**
+
+.. code-block:: python
+
    import redis
    r = redis.from_url('redis://foo.bar.com:12345')
    r.ping()
@@ -47,7 +56,8 @@ Redis Command Functions
 .. toctree::
    :maxdepth: 2
 
-   redis_core_commands
+   redis_commands
+   redis_cluster_commands
    sentinel_commands
    redismodules
 
diff --git a/docs/redis_cluster_commands.rst b/docs/redis_cluster_commands.rst
new file mode 100644
index 0000000000..de520de905
--- /dev/null
+++ b/docs/redis_cluster_commands.rst
@@ -0,0 +1,7 @@
+Redis Cluster Commands
+######################
+
+The following `Redis commands <https://redis.io/commands>`_ are available within a `Redis Cluster <https://redis.io/topics/cluster-tutorial>`_.  Generally they can be used as functions on your redis connection.
+
+.. autoclass:: redis.commands.cluster.RedisClusterCommands
+   :inherited-members:
diff --git a/docs/redis_core_commands.rst b/docs/redis_commands.rst
similarity index 88%
rename from docs/redis_core_commands.rst
rename to docs/redis_commands.rst
index edfd7fe939..efb76e79c6 100644
--- a/docs/redis_core_commands.rst
+++ b/docs/redis_commands.rst
@@ -1,5 +1,5 @@
-Redis Core Commands
-####################
+Redis Commands
+###############
 
 The following functions can be used to replicate their equivalent `Redis command <https://redis.io/commands>`_.  Generally they can be used as functions on your redis connection.  For the simplest example, see below:
 
@@ -11,4 +11,4 @@ Getting and settings data in redis::
    r.get('mykey')
 
 .. autoclass:: redis.commands.core.CoreCommands
-   :members:
\ No newline at end of file
+   :inherited-members:
diff --git a/docs/redismodules.rst b/docs/redismodules.rst
index da8c36b7b4..0cb8c49660 100644
--- a/docs/redismodules.rst
+++ b/docs/redismodules.rst
@@ -5,15 +5,132 @@ Accessing redis module commands requires the installation of the supported `Redi
 
 RedisTimeSeries Commands
 ************************
+
+These are the commands for interacting with the `RedisTimeSeries module <https://redistimeseries.io>`_. Below is a brief example, as well as documentation on the commands themselves.
+
+
+**Create a timeseries object with 5 second retention**
+
+.. code-block:: python
+
+    import redis
+    r = redis.Redis()
+    r.timeseries().create(2, retension_msecs=5)
+
 .. automodule:: redis.commands.timeseries.commands
-   :members: TimeSeriesCommands
+    :members: TimeSeriesCommands
+
+-----
 
 RedisJSON Commands
 ******************
+
+These are the commands for interacting with the `RedisJSON module <https://redisjson.io>`_. Below is a brief example, as well as documentation on the commands themselves.
+
+**Create a json object**
+
+.. code-block:: python
+
+    import redis
+    r = redis.Redis()
+    r.json().set("mykey", ".", {"hello": "world", "i am": ["a", "json", "object!"]}
+
+
 .. automodule:: redis.commands.json.commands
-   :members: JSONCommands
+    :members: JSONCommands
+
+-----
 
 RediSearch Commands
 *******************
+
+These are the commands for interacting with the `RediSearch module <https://redisjson.io>`_. Below is a brief example, as well as documentation on the commands themselves.
+
+**Create a search index, and display its information**
+
+.. code-block:: python
+
+    import redis
+    r = redis.Redis()
+    r.ft().create_index(TextField("play", weight=5.0), TextField("ball"))
+    print(r.ft().info())
+
+
 .. automodule:: redis.commands.search.commands
-   :members: SearchCommands
\ No newline at end of file
+    :members: SearchCommands
+
+-----
+
+RedisGraph Commands
+*******************
+
+These are the commands for interacting with the `RedisGraph module <https://redisjson.io>`_. Below is a brief example, as well as documentation on the commands themselves.
+
+**Create a graph, adding two nodes**
+
+.. code-block:: python
+
+    import redis
+    from redis.graph.node import Node
+
+    john = Node(label="person", properties={"name": "John Doe", "age": 33}
+    jane = Node(label="person", properties={"name": "Jane Doe", "age": 34}
+
+    r = redis.Redis()
+    graph = r.graph()
+    graph.add_node(john)
+    graph.add_node(jane)
+    graph.add_node(pat)
+    graph.commit()
+
+.. automodule:: redis.commands.graph.node
+    :members: Node
+
+.. automodule:: redis.commands.graph.edge
+    :members: Edge
+
+.. automodule:: redis.commands.graph.commands
+    :members: GraphCommands
+
+-----
+
+RedisBloom Commands
+*******************
+
+These are the commands for interacting with the `RedisBloom module <https://redisjson.io>`_. Below is a brief example, as well as documentation on the commands themselves.
+
+**Create and add to a bloom filter**
+
+.. code-block:: python
+
+    import redis
+    filter = redis.bf().create("bloom", 0.01, 1000)
+    filter.add("bloom", "foo")
+
+**Create and add to a cuckoo filter**
+
+.. code-block:: python
+
+    import redis
+    filter = redis.cf().create("cuckoo", 1000)
+    filter.add("cuckoo", "filter")
+
+**Create Count-Min Sketch and get information**
+
+.. code-block:: python
+
+    import redis
+    r = redis.cms().initbydim("dim", 1000, 5)
+    r.cms().incrby("dim", ["foo"], [5])
+    r.cms().info("dim")
+
+**Create a topk list, and access the results**
+
+.. code-block:: python
+
+    import redis
+    r = redis.topk().reserve("mytopk", 3, 50, 4, 0.9)
+    info = r.topk().info("mytopk)
+
+.. automodule:: redis.commands.bf.commands
+    :members: BFCommands, CFCommands, CMSCommands, TOPKCommands
diff --git a/redis/commands/bf/commands.py b/redis/commands/bf/commands.py
index 3c8bf7f31e..7fc507d2d9 100644
--- a/redis/commands/bf/commands.py
+++ b/redis/commands/bf/commands.py
@@ -51,7 +51,7 @@
 
 
 class BFCommands:
-    """RedisBloom commands."""
+    """Bloom Filter commands."""
 
     # region Bloom Filter Functions
     def create(self, key, errorRate, capacity, expansion=None, noScale=None):
@@ -166,6 +166,7 @@ def info(self, key):
 
 
 class CFCommands:
+    """Cuckoo Filter commands."""
 
     # region Cuckoo Filter Functions
     def create(
@@ -283,6 +284,8 @@ def info(self, key):
 
 
 class TOPKCommands:
+    """TOP-k Filter commands."""
+
     def reserve(self, key, k, width, depth, decay):
         """
         Create a new Top-K Filter `key` with desired probability of false
@@ -432,6 +435,7 @@ def info(self, key):
 
 
 class CMSCommands:
+    """Count-Min Sketch Commands"""
 
     # region Count-Min Sketch Functions
     def initbydim(self, key, width, depth):
diff --git a/redis/commands/graph/commands.py b/redis/commands/graph/commands.py
index f0c1d687ed..e097936503 100644
--- a/redis/commands/graph/commands.py
+++ b/redis/commands/graph/commands.py
@@ -6,6 +6,8 @@
 
 
 class GraphCommands:
+    """RedisGraph Commands"""
+
     def commit(self):
         """
         Create entire graph.

From f82ab336c3e249ee871ee5e50e10c0de08c4f38a Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Mon, 13 Dec 2021 11:27:40 +0200
Subject: [PATCH 0297/1164] Disabling JSON.DEBUG tests (#1787)

---
 tests/test_json.py | 58 +++++++++++++++++++++++-----------------------
 1 file changed, 29 insertions(+), 29 deletions(-)

diff --git a/tests/test_json.py b/tests/test_json.py
index 1686f9d05e..a99547dd04 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -134,14 +134,14 @@ def test_strappend(client):
     assert "foobar" == client.json().get("jsonkey", Path.rootPath())
 
 
-@pytest.mark.redismod
-def test_debug(client):
-    client.json().set("str", Path.rootPath(), "foo")
-    assert 24 == client.json().debug("MEMORY", "str", Path.rootPath())
-    assert 24 == client.json().debug("MEMORY", "str")
-
-    # technically help is valid
-    assert isinstance(client.json().debug("HELP"), list)
+# @pytest.mark.redismod
+# def test_debug(client):
+#    client.json().set("str", Path.rootPath(), "foo")
+#    assert 24 == client.json().debug("MEMORY", "str", Path.rootPath())
+#    assert 24 == client.json().debug("MEMORY", "str")
+#
+#    # technically help is valid
+#    assert isinstance(client.json().debug("HELP"), list)
 
 
 @pytest.mark.redismod
@@ -969,27 +969,27 @@ def test_toggle_dollar(client):
         client.json().toggle("non_existing_doc", "$..a")
 
 
-@pytest.mark.redismod
-def test_debug_dollar(client):
-
-    jdata, jtypes = load_types_data("a")
-
-    client.json().set("doc1", "$", jdata)
-
-    # Test multi
-    assert client.json().debug("MEMORY", "doc1", "$..a") == [72, 24, 24, 16, 16, 1, 0]
-
-    # Test single
-    assert client.json().debug("MEMORY", "doc1", "$.nested2.a") == [24]
-
-    # Test legacy
-    assert client.json().debug("MEMORY", "doc1", "..a") == 72
-
-    # Test missing path (defaults to root)
-    assert client.json().debug("MEMORY", "doc1") == 72
-
-    # Test missing key
-    assert client.json().debug("MEMORY", "non_existing_doc", "$..a") == []
+# @pytest.mark.redismod
+# def test_debug_dollar(client):
+#
+#    jdata, jtypes = load_types_data("a")
+#
+#    client.json().set("doc1", "$", jdata)
+#
+#    # Test multi
+#    assert client.json().debug("MEMORY", "doc1", "$..a") == [72, 24, 24, 16, 16, 1, 0]
+#
+#    # Test single
+#    assert client.json().debug("MEMORY", "doc1", "$.nested2.a") == [24]
+#
+#    # Test legacy
+#    assert client.json().debug("MEMORY", "doc1", "..a") == 72
+#
+#    # Test missing path (defaults to root)
+#    assert client.json().debug("MEMORY", "doc1") == 72
+#
+#    # Test missing key
+#    assert client.json().debug("MEMORY", "non_existing_doc", "$..a") == []
 
 
 @pytest.mark.redismod

From c8dfe158ad0d28ad62965d5da9fb8dc860251be0 Mon Sep 17 00:00:00 2001
From: Akuli <akuviljanen17@gmail.com>
Date: Wed, 15 Dec 2021 14:26:31 +0200
Subject: [PATCH 0298/1164] Fix link in lmove docstring (#1793)

---
 redis/commands/core.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index fec3095cc5..62e3ba85c2 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1244,7 +1244,7 @@ def lmove(self, first_list, second_list, src="LEFT", dest="RIGHT"):
         pushing it as the first/last element on the destination list.
         Returns the element being popped and pushed.
 
-        For more information check https://redis.io/commands/lmov
+        For more information check https://redis.io/commands/lmove
         """
         params = [first_list, second_list, src, dest]
         return self.execute_command("LMOVE", *params)

From d17ff5913e375568eaab4c5d9a798d249aabe1e4 Mon Sep 17 00:00:00 2001
From: Ali-Akber Saifee <ali@indydevs.org>
Date: Wed, 15 Dec 2021 05:00:06 -0800
Subject: [PATCH 0299/1164] Ensure redis_connect_func is set on uds connection
 (#1794)

---
 redis/connection.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/redis/connection.py b/redis/connection.py
index 2001c6447b..4ba58fe495 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -552,8 +552,8 @@ def __init__(
             self.retry = Retry(NoBackoff(), 0)
         self.health_check_interval = health_check_interval
         self.next_health_check = 0
-        self.encoder = Encoder(encoding, encoding_errors, decode_responses)
         self.redis_connect_func = redis_connect_func
+        self.encoder = Encoder(encoding, encoding_errors, decode_responses)
         self._sock = None
         self._socket_read_size = socket_read_size
         self.set_parser(parser_class)
@@ -942,6 +942,7 @@ def __init__(
         health_check_interval=0,
         client_name=None,
         retry=None,
+        redis_connect_func=None,
     ):
         """
         Initialize a new UnixDomainSocketConnection.
@@ -966,6 +967,7 @@ def __init__(
             self.retry = Retry(NoBackoff(), 0)
         self.health_check_interval = health_check_interval
         self.next_health_check = 0
+        self.redis_connect_func = redis_connect_func
         self.encoder = Encoder(encoding, encoding_errors, decode_responses)
         self._sock = None
         self._socket_read_size = socket_read_size

From c858f8e9157dbb7915fac6d6920c31b12c061ab0 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 15 Dec 2021 17:00:39 +0200
Subject: [PATCH 0300/1164] Single sourcing the package version (#1791)

---
 redis/__init__.py | 12 +++++++++++-
 setup.py          |  8 ++------
 2 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/redis/__init__.py b/redis/__init__.py
index 051b039d06..35044be29d 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -1,3 +1,10 @@
+import sys
+
+if sys.version_info >= (3, 8):
+    from importlib import metadata
+else:
+    import importlib_metadata as metadata
+
 from redis.client import Redis, StrictRedis
 from redis.cluster import RedisCluster
 from redis.connection import (
@@ -38,7 +45,10 @@ def int_or_str(value):
         return value
 
 
-__version__ = "4.1.0rc2"
+try:
+    __version__ = metadata.version("redis")
+except metadata.PackageNotFoundError:
+    __version__ = "99.99.99"
 
 
 VERSION = tuple(map(int_or_str, __version__.split(".")))
diff --git a/setup.py b/setup.py
index b9c2e3e315..524ea845d1 100644
--- a/setup.py
+++ b/setup.py
@@ -1,8 +1,6 @@
 #!/usr/bin/env python
 from setuptools import find_packages, setup
 
-import redis
-
 setup(
     name="redis",
     description="Python client for Redis database and key-value store",
@@ -10,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version=redis.__version__,
+    version="4.1.0rc2",
     packages=find_packages(
         include=[
             "redis",
@@ -26,12 +24,10 @@
     author="Redis Inc.",
     author_email="oss@redis.com",
     python_requires=">=3.6",
-    setup_requires=[
-        "packaging>=21.3",
-    ],
     install_requires=[
         "deprecated>=1.2.3",
         "packaging>=21.3",
+        'importlib-metadata >= 1.0; python_version < "3.8"',
     ],
     classifiers=[
         "Development Status :: 5 - Production/Stable",

From 6c1e215bc8803a4cf72e07d15dedaa51c81d0ff2 Mon Sep 17 00:00:00 2001
From: Ashwani Gupta <ashwanigupta125@gmail.com>
Date: Wed, 15 Dec 2021 20:33:27 +0530
Subject: [PATCH 0301/1164] Add CI action to install package from commit hash
 (#1781) (#1790)

---
 .github/workflows/integration.yaml | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 10ab3ed03e..bd0fb2d076 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -70,3 +70,19 @@ jobs:
       - name: Run installed unit tests
         run: |
           bash .github/workflows/install_and_test.sh ${{ matrix.extension }}
+
+   install_package_from_commit:
+    name: Install package from commit hash
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.6', '3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
+    steps:
+      - uses: actions/checkout@v2
+      - name: install python ${{ matrix.python-version }}
+        uses: actions/setup-python@v2
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: install from pip
+        run: |
+          pip install --quiet git+${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}.git@${GITHUB_SHA}

From 82bad1686177c4c543818a8bfac35c6fdfc9ddf1 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Wed, 15 Dec 2021 16:03:45 +0100
Subject: [PATCH 0302/1164] Support SYNC and PSYNC (#1741)

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/commands/core.py | 25 +++++++++++++++++++++++++
 redis/connection.py    |  2 +-
 tests/test_commands.py | 12 ++++++++++++
 3 files changed, 38 insertions(+), 1 deletion(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 62e3ba85c2..835ea6125a 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -637,6 +637,31 @@ def flushdb(self, asynchronous=False, **kwargs):
             args.append(b"ASYNC")
         return self.execute_command("FLUSHDB", *args, **kwargs)
 
+    def sync(self):
+        """
+        Initiates a replication stream from the master.
+
+        For more information check https://redis.io/commands/sync
+        """
+        from redis.client import NEVER_DECODE
+
+        options = {}
+        options[NEVER_DECODE] = []
+        return self.execute_command("SYNC", **options)
+
+    def psync(self, replicationid, offset):
+        """
+        Initiates a replication stream from the master.
+        Newer version for `sync`.
+
+        For more information check https://redis.io/commands/sync
+        """
+        from redis.client import NEVER_DECODE
+
+        options = {}
+        options[NEVER_DECODE] = []
+        return self.execute_command("PSYNC", replicationid, offset, **options)
+
     def swapdb(self, first, second, **kwargs):
         """
         Swap two databases
diff --git a/redis/connection.py b/redis/connection.py
index 4ba58fe495..6c4494b145 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -382,7 +382,7 @@ def __del__(self):
         except Exception:
             pass
 
-    def on_connect(self, connection):
+    def on_connect(self, connection, **kwargs):
         self._sock = connection._sock
         self._socket_timeout = connection.socket_timeout
         kwargs = {
diff --git a/tests/test_commands.py b/tests/test_commands.py
index eab9072c0d..b8dc69f9eb 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -4151,6 +4151,18 @@ def test_replicaof(self, r):
             assert r.replicaof("NO ONE")
         assert r.replicaof("NO", "ONE")
 
+    @skip_if_server_version_lt("2.8.0")
+    def test_sync(self, r):
+        r2 = redis.Redis(port=6380, decode_responses=False)
+        res = r2.sync()
+        assert b"REDIS" in res
+
+    @skip_if_server_version_lt("2.8.0")
+    def test_psync(self, r):
+        r2 = redis.Redis(port=6380, decode_responses=False)
+        res = r2.psync(r2.client_id(), 1)
+        assert b"FULLRESYNC" in res
+
 
 @pytest.mark.onlynoncluster
 class TestBinarySave:

From a8b8f142399a62e64c3003adda2d9563eea95ef4 Mon Sep 17 00:00:00 2001
From: Paul Brown <paul90brown@gmail.com>
Date: Thu, 16 Dec 2021 07:35:22 +0000
Subject: [PATCH 0303/1164] close socket after server disconnect (#1797)

---
 redis/connection.py      |  9 +++++++--
 tests/test_connection.py | 34 ++++++++++++++++++++++++++++++++++
 2 files changed, 41 insertions(+), 2 deletions(-)

diff --git a/redis/connection.py b/redis/connection.py
index 6c4494b145..1bb8eb50f9 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -717,9 +717,14 @@ def disconnect(self):
         self._parser.on_disconnect()
         if self._sock is None:
             return
-        try:
-            if os.getpid() == self.pid:
+
+        if os.getpid() == self.pid:
+            try:
                 self._sock.shutdown(socket.SHUT_RDWR)
+            except OSError:
+                pass
+
+        try:
             self._sock.close()
         except OSError:
             pass
diff --git a/tests/test_connection.py b/tests/test_connection.py
index 22f1b718de..d94a815159 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -3,6 +3,7 @@
 
 import pytest
 
+from redis.connection import Connection
 from redis.exceptions import InvalidResponse
 from redis.utils import HIREDIS_AVAILABLE
 
@@ -40,3 +41,36 @@ def inner():
     # mod = j(modclient)
     # mod.set("fookey", ".", d)
     # assert mod.get('fookey') == d
+
+
+class TestConnection:
+    def test_disconnect(self):
+        conn = Connection()
+        mock_sock = mock.Mock()
+        conn._sock = mock_sock
+        conn.disconnect()
+        mock_sock.shutdown.assert_called_once()
+        mock_sock.close.assert_called_once()
+        assert conn._sock is None
+
+    def test_disconnect__shutdown_OSError(self):
+        """An OSError on socket shutdown will still close the socket."""
+        conn = Connection()
+        mock_sock = mock.Mock()
+        conn._sock = mock_sock
+        conn._sock.shutdown.side_effect = OSError
+        conn.disconnect()
+        mock_sock.shutdown.assert_called_once()
+        mock_sock.close.assert_called_once()
+        assert conn._sock is None
+
+    def test_disconnect__close_OSError(self):
+        """An OSError on socket close will still clear out the socket."""
+        conn = Connection()
+        mock_sock = mock.Mock()
+        conn._sock = mock_sock
+        conn._sock.close.side_effect = OSError
+        conn.disconnect()
+        mock_sock.shutdown.assert_called_once()
+        mock_sock.close.assert_called_once()
+        assert conn._sock is None

From 18c6809b761bc6755349e1d7e08e74e857ec2c65 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 16 Dec 2021 09:36:56 +0200
Subject: [PATCH 0304/1164] Support for password-encrypted SSL private keys
 (#1782)

Adding support for SSL private keys with a password.  This PR also adds support for future SSL tests.
---
 .github/workflows/install_and_test.sh |  2 +-
 .github/workflows/integration.yaml    |  1 +
 .gitignore                            |  1 +
 CONTRIBUTING.md                       |  3 +-
 dev_requirements.txt                  |  1 +
 docker/base/Dockerfile                |  1 +
 docker/base/Dockerfile.cluster        |  3 +-
 docker/base/Dockerfile.sentinel       |  1 +
 docker/base/Dockerfile.stunnel        | 11 +++++
 docker/stunnel/conf/redis.conf        |  6 +++
 docker/stunnel/create_certs.sh        | 46 ++++++++++++++++++++
 redis/client.py                       |  3 ++
 redis/connection.py                   | 35 +++++++++++++--
 tasks.py                              | 13 ++++++
 tests/conftest.py                     | 17 +++++++-
 tests/test_ssl.py                     | 61 +++++++++++++++++++++++++++
 tox.ini                               | 27 ++++++++----
 17 files changed, 215 insertions(+), 17 deletions(-)
 create mode 100644 docker/base/Dockerfile.stunnel
 create mode 100644 docker/stunnel/conf/redis.conf
 create mode 100755 docker/stunnel/create_certs.sh
 create mode 100644 tests/test_ssl.py

diff --git a/.github/workflows/install_and_test.sh b/.github/workflows/install_and_test.sh
index 7a8cd672fd..33a1edb1e7 100755
--- a/.github/workflows/install_and_test.sh
+++ b/.github/workflows/install_and_test.sh
@@ -42,4 +42,4 @@ pip install ${PKG}
 pytest -m 'not onlycluster'
 # RedisCluster tests
 CLUSTER_URL="redis://localhost:16379/0"
-pytest -m 'not onlynoncluster and not redismod' --redis-url=${CLUSTER_URL}
+pytest -m 'not onlynoncluster and not redismod and not ssl' --redis-url=${CLUSTER_URL}
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index bd0fb2d076..e81cf339fd 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -48,6 +48,7 @@ jobs:
        - name: run tests
          run: |
            pip install -r dev_requirements.txt
+           bash docker/stunnel/create_certs.sh
            tox -e ${{matrix.test-type}}-${{matrix.connection-type}}
        - name: Upload codecov coverage
          uses: codecov/codecov-action@v2
diff --git a/.gitignore b/.gitignore
index 08138d7c8c..96fbdd5646 100644
--- a/.gitignore
+++ b/.gitignore
@@ -17,3 +17,4 @@ coverage.xml
 .venv
 *.xml
 .coverage*
+docker/stunnel/keys
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index fe37ff9abe..04f989a308 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -58,6 +58,7 @@ can execute docker and its various commands.
 -   A Redis replica node
 -   Three sentinel Redis nodes
 -   A multi-python docker, with your source code mounted in /data
+-   An stunnel docker, fronting the master Redis node
 
 The replica node, is a replica of the master node, using the
 [leader-follower replication](https://redis.io/topics/replication)
@@ -73,7 +74,7 @@ tests as well. With the 'tests' and 'all-tests' targets, all Redis and
 RedisCluster tests will be run. 
 
 It is possible to run only Redis client tests (with cluster mode disabled) by 
-using `invoke redis-tests`; similarly, RedisCluster tests can be run by using 
+using `invoke standalone-tests`; similarly, RedisCluster tests can be run by using 
 `invoke cluster-tests`.
 
 Each run of tox starts and stops the various dockers required. Sometimes
diff --git a/dev_requirements.txt b/dev_requirements.txt
index 2a4f37762f..1d33b9875b 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -6,6 +6,7 @@ pytest==6.2.5
 pytest-timeout==2.0.1
 tox==3.24.4
 tox-docker==3.1.0
+tox-run-before==0.1
 invoke==1.6.0
 pytest-cov>=3.0.0
 vulture>=2.3.0
diff --git a/docker/base/Dockerfile b/docker/base/Dockerfile
index 60be37483b..c76d15db36 100644
--- a/docker/base/Dockerfile
+++ b/docker/base/Dockerfile
@@ -1,3 +1,4 @@
+# produces redisfab/redis-py:6.2.6
 FROM redis:6.2.6-buster
 
 CMD ["redis-server", "/redis.conf"]
diff --git a/docker/base/Dockerfile.cluster b/docker/base/Dockerfile.cluster
index 70e8013631..70df5babf0 100644
--- a/docker/base/Dockerfile.cluster
+++ b/docker/base/Dockerfile.cluster
@@ -1,3 +1,4 @@
+# produces redisfab/redis-py-cluster:6.2.6
 FROM redis:6.2.6-buster
 
 COPY create_cluster.sh /create_cluster.sh
@@ -5,4 +6,4 @@ RUN chmod +x /create_cluster.sh
 
 EXPOSE 16379 16380 16381 16382 16383 16384
 
-CMD [ "/create_cluster.sh"]
\ No newline at end of file
+CMD [ "/create_cluster.sh"]
diff --git a/docker/base/Dockerfile.sentinel b/docker/base/Dockerfile.sentinel
index 93c16a71ab..ef659e3004 100644
--- a/docker/base/Dockerfile.sentinel
+++ b/docker/base/Dockerfile.sentinel
@@ -1,3 +1,4 @@
+# produces redisfab/redis-py-sentinel:6.2.6
 FROM redis:6.2.6-buster
 
 CMD ["redis-sentinel", "/sentinel.conf"]
diff --git a/docker/base/Dockerfile.stunnel b/docker/base/Dockerfile.stunnel
new file mode 100644
index 0000000000..bf4510907c
--- /dev/null
+++ b/docker/base/Dockerfile.stunnel
@@ -0,0 +1,11 @@
+# produces redisfab/stunnel:latest
+FROM ubuntu:18.04
+
+RUN apt-get update -qq --fix-missing
+RUN apt-get upgrade -qqy
+RUN apt install -qqy stunnel
+RUN mkdir -p /etc/stunnel/conf.d
+RUN echo "foreground = yes\ninclude = /etc/stunnel/conf.d" > /etc/stunnel/stunnel.conf
+RUN chown -R root:root /etc/stunnel/
+
+CMD ["/usr/bin/stunnel"]
diff --git a/docker/stunnel/conf/redis.conf b/docker/stunnel/conf/redis.conf
new file mode 100644
index 0000000000..84f6d40133
--- /dev/null
+++ b/docker/stunnel/conf/redis.conf
@@ -0,0 +1,6 @@
+[redis]
+accept = 6666
+connect = master:6379
+cert = /etc/stunnel/keys/server-cert.pem
+key = /etc/stunnel/keys/server-key.pem
+verify = 0
diff --git a/docker/stunnel/create_certs.sh b/docker/stunnel/create_certs.sh
new file mode 100755
index 0000000000..f3bcea6f5d
--- /dev/null
+++ b/docker/stunnel/create_certs.sh
@@ -0,0 +1,46 @@
+#!/bin/bash
+
+set -e
+
+DESTDIR=`dirname "$0"`/keys
+test -d ${DESTDIR} || mkdir ${DESTDIR}
+cd ${DESTDIR}
+
+SSL_SUBJECT="/C=CA/ST=Winnipeg/L=Manitoba/O=Some Corp/OU=IT Department/CN=example.com"
+which openssl &>/dev/null
+if [ $? -ne 0 ]; then
+	echo "No openssl binary present, exiting."
+	exit 1
+fi
+
+openssl genrsa -out ca-key.pem 2048 &>/dev/null
+
+openssl req -new -x509 -nodes -days 365000 \
+   -key ca-key.pem \
+   -out ca-cert.pem \
+   -subj "${SSL_SUBJECT}" &>/dev/null
+
+openssl req -newkey rsa:2048 -nodes -days 365000 \
+   -keyout server-key.pem \
+   -out server-req.pem \
+   -subj "${SSL_SUBJECT}" &>/dev/null
+
+openssl x509 -req -days 365000 -set_serial 01 \
+   -in server-req.pem \
+   -out server-cert.pem \
+   -CA ca-cert.pem \
+   -CAkey ca-key.pem &>/dev/null
+
+openssl req -newkey rsa:2048 -nodes -days 365000 \
+   -keyout client-key.pem \
+   -out client-req.pem \
+   -subj "${SSL_SUBJECT}" &>/dev/null
+
+openssl x509 -req -days 365000 -set_serial 01 \
+   -in client-req.pem \
+   -out client-cert.pem \
+   -CA ca-cert.pem \
+   -CAkey ca-key.pem &>/dev/null
+
+echo "Keys generated in ${DESTDIR}:"
+ls
diff --git a/redis/client.py b/redis/client.py
index c02bc3a4d5..3ae133c300 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -873,7 +873,9 @@ def __init__(
         ssl_certfile=None,
         ssl_cert_reqs="required",
         ssl_ca_certs=None,
+        ssl_ca_path=None,
         ssl_check_hostname=False,
+        ssl_password=None,
         max_connections=None,
         single_connection_client=False,
         health_check_interval=0,
@@ -947,6 +949,7 @@ def __init__(
                             "ssl_cert_reqs": ssl_cert_reqs,
                             "ssl_ca_certs": ssl_ca_certs,
                             "ssl_check_hostname": ssl_check_hostname,
+                            "ssl_password": ssl_password,
                         }
                     )
             connection_pool = ConnectionPool(**kwargs)
diff --git a/redis/connection.py b/redis/connection.py
index 1bb8eb50f9..3fe8543ca6 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -884,6 +884,11 @@ def pack_commands(self, commands):
 
 
 class SSLConnection(Connection):
+    """Manages SSL connections to and from the Redis server(s).
+    This class extends the Connection class, adding SSL functionality, and making
+    use of ssl.SSLContext (https://docs.python.org/3/library/ssl.html#ssl.SSLContext)
+    """  # noqa
+
     def __init__(
         self,
         ssl_keyfile=None,
@@ -891,8 +896,24 @@ def __init__(
         ssl_cert_reqs="required",
         ssl_ca_certs=None,
         ssl_check_hostname=False,
+        ssl_ca_path=None,
+        ssl_password=None,
         **kwargs,
     ):
+        """Constructor
+
+        Args:
+            ssl_keyfile: Path to an ssl private key. Defaults to None.
+            ssl_certfile: Path to an ssl certificate. Defaults to None.
+            ssl_cert_reqs: The string value for the SSLContext.verify_mode (none, optional, required). Defaults to "required".
+            ssl_ca_certs: The path to a file of concatenated CA certificates in PEM format. Defaults to None.
+            ssl_check_hostname: If set, match the hostname during the SSL handshake. Defaults to False.
+            ssl_ca_path: The path to a directory containing several CA certificates in PEM format. Defaults to None.
+            ssl_password: Password for unlocking an encrypted private key. Defaults to None.
+
+        Raises:
+            RedisError
+        """  # noqa
         if not ssl_available:
             raise RedisError("Python wasn't built with SSL support")
 
@@ -915,7 +936,9 @@ def __init__(
             ssl_cert_reqs = CERT_REQS[ssl_cert_reqs]
         self.cert_reqs = ssl_cert_reqs
         self.ca_certs = ssl_ca_certs
+        self.ca_path = ssl_ca_path
         self.check_hostname = ssl_check_hostname
+        self.certificate_password = ssl_password
 
     def _connect(self):
         "Wrap the socket with SSL support"
@@ -923,10 +946,14 @@ def _connect(self):
         context = ssl.create_default_context()
         context.check_hostname = self.check_hostname
         context.verify_mode = self.cert_reqs
-        if self.certfile and self.keyfile:
-            context.load_cert_chain(certfile=self.certfile, keyfile=self.keyfile)
-        if self.ca_certs:
-            context.load_verify_locations(self.ca_certs)
+        if self.certfile or self.keyfile:
+            context.load_cert_chain(
+                certfile=self.certfile,
+                keyfile=self.keyfile,
+                password=self.certificate_password,
+            )
+        if self.ca_certs is not None or self.ca_path is not None:
+            context.load_verify_locations(cafile=self.ca_certs, capath=self.ca_path)
         return context.wrap_socket(sock, server_hostname=self.host)
 
 
diff --git a/tasks.py b/tasks.py
index 880e70dcf0..98ed483fb1 100644
--- a/tasks.py
+++ b/tasks.py
@@ -3,6 +3,11 @@
 
 from invoke import run, task
 
+
+def _generate_keys():
+    run("bash docker/stunnel/create_certs.sh")
+
+
 with open("tox.ini") as fp:
     lines = fp.read().split("\n")
     dockers = [line.split("=")[1].strip() for line in lines if line.find("name") != -1]
@@ -14,6 +19,7 @@ def devenv(c):
     specified in the tox.ini file.
     """
     clean(c)
+    _generate_keys()
     cmd = "tox -e devenv"
     for d in dockers:
         cmd += f" --docker-dont-stop={d}"
@@ -29,6 +35,7 @@ def build_docs(c):
 @task
 def linters(c):
     """Run code linters"""
+    _generate_keys()
     run("tox -e linters")
 
 
@@ -37,6 +44,7 @@ def all_tests(c):
     """Run all linters, and tests in redis-py. This assumes you have all
     the python versions specified in the tox.ini file.
     """
+    _generate_keys()
     linters(c)
     tests(c)
 
@@ -47,6 +55,7 @@ def tests(c):
     with and without hiredis.
     """
     print("Starting Redis tests")
+    _generate_keys()
     run("tox -e '{standalone,cluster}'-'{plain,hiredis}'")
 
 
@@ -55,6 +64,7 @@ def standalone_tests(c):
     """Run all Redis tests against the current python,
     with and without hiredis."""
     print("Starting Redis tests")
+    _generate_keys()
     run("tox -e standalone-'{plain,hiredis}'")
 
 
@@ -63,6 +73,7 @@ def cluster_tests(c):
     """Run all Redis Cluster tests against the current python,
     with and without hiredis."""
     print("Starting RedisCluster tests")
+    _generate_keys()
     run("tox -e cluster-'{plain,hiredis}'")
 
 
@@ -74,6 +85,8 @@ def clean(c):
     if os.path.isdir("dist"):
         shutil.rmtree("dist")
     run(f"docker rm -f {' '.join(dockers)}")
+    if os.path.isdir("docker/stunnel/keys"):
+        shutil.rmtree("docker/stunnel/keys")
 
 
 @task
diff --git a/tests/conftest.py b/tests/conftest.py
index 4b5f6cbd5c..0149166d65 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -14,8 +14,10 @@
 
 REDIS_INFO = {}
 default_redis_url = "redis://localhost:6379/9"
-
 default_redismod_url = "redis://localhost:36379"
+
+# default ssl client ignores verification for the purpose of testing
+default_redis_ssl_url = "rediss://localhost:6666"
 default_cluster_nodes = 6
 
 
@@ -36,6 +38,13 @@ def pytest_addoption(parser):
         " defaults to `%(default)s`",
     )
 
+    parser.addoption(
+        "--redis-ssl-url",
+        default=default_redis_ssl_url,
+        action="store",
+        help="Redis SSL connection string," " defaults to `%(default)s`",
+    )
+
     parser.addoption(
         "--redis-cluster-nodes",
         default=default_cluster_nodes,
@@ -248,6 +257,12 @@ def r2(request):
         yield client
 
 
+@pytest.fixture()
+def sslclient(request):
+    with _get_client(redis.Redis, request, ssl=True) as client:
+        yield client
+
+
 def _gen_cluster_mock_resp(r, response):
     connection = Mock()
     connection.retry = Retry(NoBackoff(), 0)
diff --git a/tests/test_ssl.py b/tests/test_ssl.py
new file mode 100644
index 0000000000..70f9e58b76
--- /dev/null
+++ b/tests/test_ssl.py
@@ -0,0 +1,61 @@
+import os
+from urllib.parse import urlparse
+
+import pytest
+
+import redis
+from redis.exceptions import ConnectionError
+
+
+@pytest.mark.ssl
+class TestSSL:
+    """Tests for SSL connections
+
+    This relies on the --redis-ssl-url purely for rebuilding the client
+    and connecting to the appropriate port.
+    """
+
+    ROOT = os.path.join(os.path.dirname(__file__), "..")
+    CERT_DIR = os.path.abspath(os.path.join(ROOT, "docker", "stunnel", "keys"))
+    if not os.path.isdir(CERT_DIR):  # github actions package validation case
+        CERT_DIR = os.path.abspath(
+            os.path.join(ROOT, "..", "docker", "stunnel", "keys")
+        )
+        if not os.path.isdir(CERT_DIR):
+            raise IOError(f"No SSL certificates found. They should be in {CERT_DIR}")
+
+    def test_ssl_with_invalid_cert(self, request):
+        ssl_url = request.config.option.redis_ssl_url
+        sslclient = redis.from_url(ssl_url)
+        with pytest.raises(ConnectionError) as e:
+            sslclient.ping()
+            assert "SSL: CERTIFICATE_VERIFY_FAILED" in str(e)
+
+    def test_ssl_connection(self, request):
+        ssl_url = request.config.option.redis_ssl_url
+        p = urlparse(ssl_url)[1].split(":")
+        r = redis.Redis(host=p[0], port=p[1], ssl=True, ssl_cert_reqs="none")
+        assert r.ping()
+
+    def test_ssl_connection_without_ssl(self, request):
+        ssl_url = request.config.option.redis_ssl_url
+        p = urlparse(ssl_url)[1].split(":")
+        r = redis.Redis(host=p[0], port=p[1], ssl=False)
+
+        with pytest.raises(ConnectionError) as e:
+            r.ping()
+            assert "Connection closed by server" in str(e)
+
+    def test_validating_self_signed_certificate(self, request):
+        ssl_url = request.config.option.redis_ssl_url
+        p = urlparse(ssl_url)[1].split(":")
+        r = redis.Redis(
+            host=p[0],
+            port=p[1],
+            ssl=True,
+            ssl_certfile=os.path.join(self.CERT_DIR, "server-cert.pem"),
+            ssl_keyfile=os.path.join(self.CERT_DIR, "server-key.pem"),
+            ssl_cert_reqs="required",
+            ssl_ca_certs=os.path.join(self.CERT_DIR, "server-cert.pem"),
+        )
+        assert r.ping()
diff --git a/tox.ini b/tox.ini
index 32d1680a2a..b574d17b57 100644
--- a/tox.ini
+++ b/tox.ini
@@ -5,6 +5,7 @@ markers =
     pipeline: pipeline tests
     onlycluster: marks tests to be run only with cluster mode redis
     onlynoncluster: marks tests to be run only with standalone redis
+    ssl: marker for only the ssl tests
 
 [tox]
 minversion = 3.2.0
@@ -31,6 +32,7 @@ healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(sock
 volumes =
     bind:rw:{toxinidir}/docker/replica/redis.conf:/redis.conf
 
+
 [docker:sentinel_1]
 name = sentinel_1
 image = redisfab/redis-py-sentinel:6.2.6-buster
@@ -91,6 +93,18 @@ healtcheck_cmd = python -c "import socket;print(True) if all([0 == socket.socket
 volumes =
     bind:rw:{toxinidir}/docker/cluster/redis.conf:/redis.conf
 
+[docker:stunnel]
+name = stunnel
+image = redisfab/stunnel:latest
+healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',6666)) else False"
+links =
+    master:master
+ports =
+    6666:6666/tcp
+volumes =
+    bind:ro:{toxinidir}/docker/stunnel/conf:/etc/stunnel/conf.d
+    bind:ro:{toxinidir}/docker/stunnel/keys:/etc/stunnel/keys
+
 [isort]
 profile = black
 multi_line_output = 3
@@ -107,10 +121,12 @@ docker =
     sentinel_3
     redis_cluster
     redismod
+    stunnel
 extras =
     hiredis: hiredis
 setenv =
     CLUSTER_URL = "redis://localhost:16379/0"
+run_before = {toxinidir}/docker/stunnel/create_certs.sh
 commands =
     standalone: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' {posargs}
     cluster: pytest --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={env:CLUSTER_URL:} {posargs}
@@ -119,16 +135,9 @@ commands =
 skipsdist = true
 skip_install = true
 deps = -r {toxinidir}/dev_requirements.txt
-docker =
-    master
-    replica
-    sentinel_1
-    sentinel_2
-    sentinel_3
-    redis_cluster
-    redismod
-    lots-of-pythons
+docker = {[testenv]docker}
 commands = /usr/bin/echo
+run_before = {[testenv]run_before}
 
 [testenv:linters]
 deps_files = dev_requirements.txt

From 4831034c0be47fd0979ce43b186173bcb6b2011d Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 19 Dec 2021 10:39:37 +0200
Subject: [PATCH 0305/1164] Allow ssl_ca_path with rediss:// urls (#1814)

---
 redis/client.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/redis/client.py b/redis/client.py
index 3ae133c300..ae4fae2ace 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -950,6 +950,7 @@ def __init__(
                             "ssl_ca_certs": ssl_ca_certs,
                             "ssl_check_hostname": ssl_check_hostname,
                             "ssl_password": ssl_password,
+                            "ssl_ca_path": ssl_ca_path,
                         }
                     )
             connection_pool = ConnectionPool(**kwargs)

From aa0c80906a58ce4f79b3251e095d1fe0b816cf15 Mon Sep 17 00:00:00 2001
From: dvora-h <dvora.heller@redis.com>
Date: Sun, 19 Dec 2021 17:38:57 +0200
Subject: [PATCH 0306/1164] add set_file and set_path

---
 redis/commands/json/commands.py | 39 +++++++++++++++++++++++++++++++++
 tests/test_json.py              | 12 ++++++++++
 2 files changed, 51 insertions(+)

diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index e7f07b612f..92b018c572 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -4,6 +4,8 @@
 
 from .decoders import decode_dict_keys
 from .path import Path
+from json import loads, JSONDecodeError
+import os
 
 
 class JSONCommands:
@@ -213,6 +215,43 @@ def set(self, name, path, obj, nx=False, xx=False, decode_keys=False):
             pieces.append("XX")
         return self.execute_command("JSON.SET", *pieces)
 
+    def set_file(self, name, path, file_name, nx=False, xx=False, decode_keys=False):
+        """
+        Set the JSON value at key ``name`` under the ``path`` to the contents of the json file ``file_name``.
+
+        ``nx`` if set to True, set ``value`` only if it does not exist.
+        ``xx`` if set to True, set ``value`` only if it exists.
+        ``decode_keys`` If set to True, the keys of ``obj`` will be decoded
+        with utf-8.
+
+        """
+        try:
+            file_content = loads(file_name)
+        except JSONDecodeError:
+            raise JSONDecodeError("Inappropriate file type, set_file() requires json file")
+        
+        return self.set(name, path, file_content, nx, xx, decode_keys)
+
+
+    def set_path(self, json_path, root_directory , nx=False, xx=False, decode_keys=False):
+        """ 
+
+        """
+        set_files_result = {}
+        for root, dirs, files in os.walk(root_directory):
+            for file in files:
+                try:
+                    file_name = file.rsplit('.')[0]
+                    file_path = os.path.join(root, file)
+                    self.set_file(file_name, json_path, file_path, nx, xx, decode_keys)
+                    set_files_result[os.path.join(root, file)] = True
+                except JSONDecodeError:
+                    set_files_result[os.path.join(root, file)] = False
+
+        return set_files_result
+
+
+
     def strlen(self, name, path=None):
         """Return the length of the string JSON value under ``path`` at key
         ``name``.
diff --git a/tests/test_json.py b/tests/test_json.py
index a99547dd04..74b00ea087 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -1392,3 +1392,15 @@ def test_custom_decoder(client):
     assert client.exists("foo") == 0
     assert not isinstance(cj.__encoder__, json.JSONEncoder)
     assert not isinstance(cj.__decoder__, json.JSONDecoder)
+
+
+@pytest.mark.redismod
+def test_set_file(client):
+    import tempfile
+    import json
+
+    jsonfile = tempfile.NamedTemporaryFile(suffix=".json")
+    with open(jsonfile.name, 'w+') as fp:
+        fp.write(json.dumps({"hello": "world"}))
+
+    assert client.json().set("test", Path.rootPath(), jsonfile.name)
\ No newline at end of file

From 58d383f01c0859c3ff76a2a9695cf7f1730d6075 Mon Sep 17 00:00:00 2001
From: dvora-h <dvora.heller@redis.com>
Date: Mon, 20 Dec 2021 12:16:04 +0200
Subject: [PATCH 0307/1164] fixing tests and lint

---
 redis/commands/json/commands.py | 33 +++++++++++++++++++--------------
 tests/test_json.py              | 33 ++++++++++++++++++++++++++++++---
 2 files changed, 49 insertions(+), 17 deletions(-)

diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index 92b018c572..626f2c1898 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -1,11 +1,12 @@
+import os
+from json import JSONDecodeError, loads
+
 from deprecated import deprecated
 
 from redis.exceptions import DataError
 
 from .decoders import decode_dict_keys
 from .path import Path
-from json import loads, JSONDecodeError
-import os
 
 
 class JSONCommands:
@@ -217,7 +218,8 @@ def set(self, name, path, obj, nx=False, xx=False, decode_keys=False):
 
     def set_file(self, name, path, file_name, nx=False, xx=False, decode_keys=False):
         """
-        Set the JSON value at key ``name`` under the ``path`` to the contents of the json file ``file_name``.
+        Set the JSON value at key ``name`` under the ``path`` to the content
+        of the json file ``file_name``.
 
         ``nx`` if set to True, set ``value`` only if it does not exist.
         ``xx`` if set to True, set ``value`` only if it exists.
@@ -225,23 +227,28 @@ def set_file(self, name, path, file_name, nx=False, xx=False, decode_keys=False)
         with utf-8.
 
         """
-        try:
-            file_content = loads(file_name)
-        except JSONDecodeError:
-            raise JSONDecodeError("Inappropriate file type, set_file() requires json file")
-        
+
+        with open(file_name, "r") as fp:
+            file_content = loads(fp.read())
+
         return self.set(name, path, file_content, nx, xx, decode_keys)
 
+    def set_path(self, json_path, root_folder, nx=False, xx=False, decode_keys=False):
+        """
+        Iterate over ``root_folder`` and set each JSON file to a value
+        under ``json_path`` with the file name as the key.
 
-    def set_path(self, json_path, root_directory , nx=False, xx=False, decode_keys=False):
-        """ 
+        ``nx`` if set to True, set ``value`` only if it does not exist.
+        ``xx`` if set to True, set ``value`` only if it exists.
+        ``decode_keys`` If set to True, the keys of ``obj`` will be decoded
+        with utf-8.
 
         """
         set_files_result = {}
-        for root, dirs, files in os.walk(root_directory):
+        for root, dirs, files in os.walk(root_folder):
             for file in files:
                 try:
-                    file_name = file.rsplit('.')[0]
+                    file_name = os.path.join(root, file).rsplit(".")[0]
                     file_path = os.path.join(root, file)
                     self.set_file(file_name, json_path, file_path, nx, xx, decode_keys)
                     set_files_result[os.path.join(root, file)] = True
@@ -250,8 +257,6 @@ def set_path(self, json_path, root_directory , nx=False, xx=False, decode_keys=F
 
         return set_files_result
 
-
-
     def strlen(self, name, path=None):
         """Return the length of the string JSON value under ``path`` at key
         ``name``.
diff --git a/tests/test_json.py b/tests/test_json.py
index 74b00ea087..9faf0aebce 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -1396,11 +1396,38 @@ def test_custom_decoder(client):
 
 @pytest.mark.redismod
 def test_set_file(client):
-    import tempfile
     import json
+    import tempfile
 
+    obj = {"hello": "world"}
     jsonfile = tempfile.NamedTemporaryFile(suffix=".json")
-    with open(jsonfile.name, 'w+') as fp:
+    with open(jsonfile.name, "w+") as fp:
+        fp.write(json.dumps(obj))
+
+    nojsonfile = tempfile.NamedTemporaryFile()
+    nojsonfile.write(b"Hello World")
+
+    assert client.json().set_file("test", Path.rootPath(), jsonfile.name)
+    assert client.json().get("test") == obj
+    with pytest.raises(json.JSONDecodeError):
+        client.json().set_file("test2", Path.rootPath(), nojsonfile.name)
+
+
+@pytest.mark.redismod
+def test_set_path(client):
+    import json
+    import os
+    import tempfile
+
+    root = tempfile.mkdtemp()
+    sub = tempfile.mkdtemp(dir=root)
+    ospointer, jsonfile = tempfile.mkstemp(suffix=".json", dir=sub)
+    ospointer2, nojsonfile = tempfile.mkstemp(dir=root)
+
+    with open(jsonfile, "w+") as fp:
         fp.write(json.dumps({"hello": "world"}))
+    open(nojsonfile, "a+").write("hello")
 
-    assert client.json().set("test", Path.rootPath(), jsonfile.name)
\ No newline at end of file
+    result = {"/private" + jsonfile: True, "/private" + nojsonfile: False}
+    assert client.json().set_path(Path.rootPath(), os.path.realpath(root)) == result
+    assert client.json().get("/private" + jsonfile.rsplit(".")[0]) == {"hello": "world"}

From b58cd9015a33aa39f04eb417e9e4496e2961efad Mon Sep 17 00:00:00 2001
From: dvora-h <dvora.heller@redis.com>
Date: Mon, 20 Dec 2021 16:56:48 +0200
Subject: [PATCH 0308/1164] fix test_set_path

---
 tests/test_json.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/tests/test_json.py b/tests/test_json.py
index 9faf0aebce..8bd1d77718 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -1416,18 +1416,18 @@ def test_set_file(client):
 @pytest.mark.redismod
 def test_set_path(client):
     import json
-    import os
     import tempfile
 
     root = tempfile.mkdtemp()
     sub = tempfile.mkdtemp(dir=root)
-    ospointer, jsonfile = tempfile.mkstemp(suffix=".json", dir=sub)
-    ospointer2, nojsonfile = tempfile.mkstemp(dir=root)
+    jsonfile = tempfile.mktemp(suffix=".json", dir=sub)
+    nojsonfile = tempfile.mktemp(dir=root)
 
     with open(jsonfile, "w+") as fp:
         fp.write(json.dumps({"hello": "world"}))
     open(nojsonfile, "a+").write("hello")
 
-    result = {"/private" + jsonfile: True, "/private" + nojsonfile: False}
-    assert client.json().set_path(Path.rootPath(), os.path.realpath(root)) == result
-    assert client.json().get("/private" + jsonfile.rsplit(".")[0]) == {"hello": "world"}
+    result = {jsonfile: True, nojsonfile: False}
+    print(result)
+    assert client.json().set_path(Path.rootPath(), root) == result
+    assert client.json().get(jsonfile.rsplit(".")[0]) == {"hello": "world"}

From 1757d97e0483bd27917124508ce52105b57d2994 Mon Sep 17 00:00:00 2001
From: dvora-h <dvora.heller@redis.com>
Date: Tue, 21 Dec 2021 10:38:58 +0200
Subject: [PATCH 0309/1164] fixing PR comments

---
 redis/commands/json/commands.py | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index 626f2c1898..a132b8ee8d 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -231,7 +231,7 @@ def set_file(self, name, path, file_name, nx=False, xx=False, decode_keys=False)
         with open(file_name, "r") as fp:
             file_content = loads(fp.read())
 
-        return self.set(name, path, file_content, nx, xx, decode_keys)
+        return self.set(name, path, file_content, nx=nx, xx=xx, decode_keys=decode_keys)
 
     def set_path(self, json_path, root_folder, nx=False, xx=False, decode_keys=False):
         """
@@ -247,13 +247,20 @@ def set_path(self, json_path, root_folder, nx=False, xx=False, decode_keys=False
         set_files_result = {}
         for root, dirs, files in os.walk(root_folder):
             for file in files:
+                file_path = os.path.join(root, file)
                 try:
-                    file_name = os.path.join(root, file).rsplit(".")[0]
-                    file_path = os.path.join(root, file)
-                    self.set_file(file_name, json_path, file_path, nx, xx, decode_keys)
-                    set_files_result[os.path.join(root, file)] = True
+                    file_name = file_path.rsplit(".")[0]
+                    self.set_file(
+                        file_name,
+                        json_path,
+                        file_path,
+                        nx=nx,
+                        xx=xx,
+                        decode_keys=decode_keys,
+                    )
+                    set_files_result[file_path] = True
                 except JSONDecodeError:
-                    set_files_result[os.path.join(root, file)] = False
+                    set_files_result[file_path] = False
 
         return set_files_result
 

From 01fedafedbdd464600f6fbcf7d21a93333b24f7f Mon Sep 17 00:00:00 2001
From: yanivhershkovich <48108541+yanivhershkovich@users.noreply.github.com>
Date: Tue, 21 Dec 2021 22:30:22 -0800
Subject: [PATCH 0310/1164] Update redismodules.rst (#1822)

Updated links to RediSearch, RedisGraph and RedisBloom sites as they were all pointing to RedisJSON instead.
---
 docs/redismodules.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/redismodules.rst b/docs/redismodules.rst
index 0cb8c49660..53a5008133 100644
--- a/docs/redismodules.rst
+++ b/docs/redismodules.rst
@@ -44,7 +44,7 @@ These are the commands for interacting with the `RedisJSON module <https://redis
 RediSearch Commands
 *******************
 
-These are the commands for interacting with the `RediSearch module <https://redisjson.io>`_. Below is a brief example, as well as documentation on the commands themselves.
+These are the commands for interacting with the `RediSearch module <https://redisearch.io>`_. Below is a brief example, as well as documentation on the commands themselves.
 
 **Create a search index, and display its information**
 
@@ -64,7 +64,7 @@ These are the commands for interacting with the `RediSearch module <https://redi
 RedisGraph Commands
 *******************
 
-These are the commands for interacting with the `RedisGraph module <https://redisjson.io>`_. Below is a brief example, as well as documentation on the commands themselves.
+These are the commands for interacting with the `RedisGraph module <https://redisgraph.io>`_. Below is a brief example, as well as documentation on the commands themselves.
 
 **Create a graph, adding two nodes**
 
@@ -97,7 +97,7 @@ These are the commands for interacting with the `RedisGraph module <https://redi
 RedisBloom Commands
 *******************
 
-These are the commands for interacting with the `RedisBloom module <https://redisjson.io>`_. Below is a brief example, as well as documentation on the commands themselves.
+These are the commands for interacting with the `RedisBloom module <https://redisbloom.io>`_. Below is a brief example, as well as documentation on the commands themselves.
 
 **Create and add to a bloom filter**
 

From e0d3ba5bd73406f80cf89609be45a0006a5382d8 Mon Sep 17 00:00:00 2001
From: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Date: Wed, 22 Dec 2021 10:01:17 +0200
Subject: [PATCH 0311/1164] Fixed MovedError, and stopped iterating through
 startup nodes when slots are fully covered (#1819)

---
 redis/cluster.py | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index b1adeb7341..0c2fc715d7 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -996,9 +996,11 @@ def _execute_command(self, target_node, *args, **kwargs):
                 self.reinitialize_counter += 1
                 if self._should_reinitialized():
                     self.nodes_manager.initialize()
+                    # Reset the counter
+                    self.reinitialize_counter = 0
                 else:
                     self.nodes_manager.update_moved_exception(e)
-                    moved = True
+                moved = True
             except TryAgainError:
                 log.exception("TryAgainError")
 
@@ -1320,6 +1322,7 @@ def initialize(self):
         tmp_slots = {}
         disagreements = []
         startup_nodes_reachable = False
+        fully_covered = False
         kwargs = self.connection_kwargs
         for startup_node in self.startup_nodes.values():
             try:
@@ -1431,6 +1434,12 @@ def initialize(self):
                                     f'slots cache: {", ".join(disagreements)}'
                                 )
 
+            fully_covered = self.check_slots_coverage(tmp_slots)
+            if fully_covered:
+                # Don't need to continue to the next startup node if all
+                # slots are covered
+                break
+
         if not startup_nodes_reachable:
             raise RedisClusterException(
                 "Redis Cluster cannot be connected. Please provide at least "
@@ -1440,7 +1449,6 @@ def initialize(self):
         # Create Redis connections to all nodes
         self.create_redis_connections(list(tmp_nodes_cache.values()))
 
-        fully_covered = self.check_slots_coverage(tmp_slots)
         # Check if the slots are not fully covered
         if not fully_covered and self._require_full_coverage:
             # Despite the requirement that the slots be covered, there
@@ -1478,6 +1486,8 @@ def initialize(self):
         self.default_node = self.get_nodes_by_server_type(PRIMARY)[0]
         # Populate the startup nodes with all discovered nodes
         self.populate_startup_nodes(self.nodes_cache.values())
+        # If initialize was called after a MovedError, clear it
+        self._moved_exception = None
 
     def close(self):
         self.default_node = None

From f99744b9049be78bbbe558fbc8ac62d94ac62a4d Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Wed, 22 Dec 2021 10:51:53 +0100
Subject: [PATCH 0312/1164] Support WRITE in CLIENT PAUSE (#1549)

Co-authored-by: Chayim I. Kirshen <c@kirshen.com>
---
 redis/commands/core.py | 18 +++++++++++++++---
 tests/test_commands.py |  7 +++++++
 tests/test_json.py     |  1 -
 3 files changed, 22 insertions(+), 4 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 835ea6125a..6a8cd159ba 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -510,16 +510,28 @@ def client_unblock(self, client_id, error=False, **kwargs):
             args.append(b"ERROR")
         return self.execute_command(*args, **kwargs)
 
-    def client_pause(self, timeout, **kwargs):
+    def client_pause(self, timeout, all=True, **kwargs):
         """
         Suspend all the Redis clients for the specified amount of time
         :param timeout: milliseconds to pause clients
 
         For more information check https://redis.io/commands/client-pause
-        """
+        :param all: If true (default) all client commands are blocked.
+             otherwise, clients are only blocked if they attempt to execute
+             a write command.
+             For the WRITE mode, some commands have special behavior:
+                 EVAL/EVALSHA: Will block client for all scripts.
+                 PUBLISH: Will block client.
+                 PFCOUNT: Will block client.
+                 WAIT: Acknowledgments will be delayed, so this command will
+                 appear blocked.
+        """
+        args = ["CLIENT PAUSE", str(timeout)]
         if not isinstance(timeout, int):
             raise DataError("CLIENT PAUSE timeout must be an integer")
-        return self.execute_command("CLIENT PAUSE", str(timeout), **kwargs)
+        if not all:
+            args.append("WRITE")
+        return self.execute_command(*args, **kwargs)
 
     def client_unpause(self, **kwargs):
         """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index b8dc69f9eb..510ec7dbcf 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -557,6 +557,13 @@ def test_client_pause(self, r):
         with pytest.raises(exceptions.RedisError):
             r.client_pause(timeout="not an integer")
 
+    @skip_if_server_version_lt("6.2.0")
+    def test_client_pause_all(self, r, r2):
+        assert r.client_pause(1, all=False)
+        assert r2.set("foo", "bar")
+        assert r2.get("foo") == b"bar"
+        assert r.get("foo") == b"bar"
+
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.2.0")
     @skip_if_redis_enterprise()
diff --git a/tests/test_json.py b/tests/test_json.py
index 8bd1d77718..6980e67398 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -1428,6 +1428,5 @@ def test_set_path(client):
     open(nojsonfile, "a+").write("hello")
 
     result = {jsonfile: True, nojsonfile: False}
-    print(result)
     assert client.json().set_path(Path.rootPath(), root) == result
     assert client.json().get(jsonfile.rsplit(".")[0]) == {"hello": "world"}

From 1bcdf2d7835fad8e7a782fccea9cbbec745bcf24 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 22 Dec 2021 11:52:03 +0200
Subject: [PATCH 0313/1164] Fixing exception in listen (#1823)

---
 redis/client.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/redis/client.py b/redis/client.py
index ae4fae2ace..16ffbb01fd 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1530,6 +1530,8 @@ def handle_message(self, response, ignore_subscribe_messages=False):
         with a message handler, the handler is invoked instead of a parsed
         message being returned.
         """
+        if response is None:
+            return None
         message_type = str_if_bytes(response[0])
         if message_type == "pmessage":
             message = {

From 139bcbb07e7bc45a4762c7bcb17f4e80235ef8f8 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Wed, 22 Dec 2021 10:52:13 +0100
Subject: [PATCH 0314/1164] Support CLIENT TRACKING (#1612)

Co-authored-by: Chayim I. Kirshen <c@kirshen.com>
---
 redis/commands/core.py | 98 ++++++++++++++++++++++++++++++++++++++++++
 tests/test_commands.py | 22 ++++++++++
 2 files changed, 120 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 6a8cd159ba..2dd7c106d9 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -479,6 +479,104 @@ def client_id(self, **kwargs):
         """
         return self.execute_command("CLIENT ID", **kwargs)
 
+    def client_tracking_on(
+        self,
+        clientid=None,
+        prefix=[],
+        bcast=False,
+        optin=False,
+        optout=False,
+        noloop=False,
+    ):
+        """
+        Turn on the tracking mode.
+        For more information about the options look at client_tracking func.
+
+        See https://redis.io/commands/client-tracking
+        """
+        return self.client_tracking(
+            True, clientid, prefix, bcast, optin, optout, noloop
+        )
+
+    def client_tracking_off(
+        self,
+        clientid=None,
+        prefix=[],
+        bcast=False,
+        optin=False,
+        optout=False,
+        noloop=False,
+    ):
+        """
+        Turn off the tracking mode.
+        For more information about the options look at client_tracking func.
+
+        See https://redis.io/commands/client-tracking
+        """
+        return self.client_tracking(
+            False, clientid, prefix, bcast, optin, optout, noloop
+        )
+
+    def client_tracking(
+        self,
+        on=True,
+        clientid=None,
+        prefix=[],
+        bcast=False,
+        optin=False,
+        optout=False,
+        noloop=False,
+        **kwargs,
+    ):
+        """
+        Enables the tracking feature of the Redis server, that is used
+        for server assisted client side caching.
+
+        ``on`` indicate for tracking on or tracking off. The dafualt is on.
+
+        ``clientid`` send invalidation messages to the connection with
+        the specified ID.
+
+        ``bcast`` enable tracking in broadcasting mode. In this mode
+        invalidation messages are reported for all the prefixes
+        specified, regardless of the keys requested by the connection.
+
+        ``optin``  when broadcasting is NOT active, normally don't track
+        keys in read only commands, unless they are called immediately
+        after a CLIENT CACHING yes command.
+
+        ``optout`` when broadcasting is NOT active, normally track keys in
+        read only commands, unless they are called immediately after a
+        CLIENT CACHING no command.
+
+        ``noloop`` don't send notifications about keys modified by this
+        connection itself.
+
+        ``prefix``  for broadcasting, register a given key prefix, so that
+        notifications will be provided only for keys starting with this string.
+
+        See https://redis.io/commands/client-tracking
+        """
+
+        if len(prefix) != 0 and bcast is False:
+            raise DataError("Prefix can only be used with bcast")
+
+        pieces = ["ON"] if on else ["OFF"]
+        if clientid is not None:
+            pieces.extend(["REDIRECT", clientid])
+        for p in prefix:
+            pieces.extend(["PREFIX", p])
+        if bcast:
+            pieces.append("BCAST")
+        if optin:
+            pieces.append("OPTIN")
+        if optout:
+            pieces.append("OPTOUT")
+        if noloop:
+            pieces.append("NOLOOP")
+
+        return self.execute_command("CLIENT TRACKING", *pieces)
+
     def client_trackinginfo(self, **kwargs):
         """
         Returns the information about the current client connection's
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 510ec7dbcf..f91804328e 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -396,6 +396,28 @@ def test_client_trackinginfo(self, r):
         assert len(res) > 2
         assert "prefixes" in res
 
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("6.0.0")
+    def test_client_tracking(self, r, r2):
+
+        # simple case
+        assert r.client_tracking_on()
+        assert r.client_tracking_off()
+
+        # id based
+        client_id = r.client_id()
+        assert r.client_tracking_on(client_id)
+        assert r.client_tracking_off(client_id)
+
+        # id exists
+        client_id = r2.client_id()
+        assert r.client_tracking_on(client_id)
+        assert r2.client_tracking_off(client_id)
+
+        # now with some prefixes
+        with pytest.raises(exceptions.DataError):
+            assert r.client_tracking_on(prefix=["foo", "bar", "blee"])
+
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("5.0.0")
     def test_client_unblock(self, r):

From 989d06d0832c2cccdb5b74f1b2afab2b2441fc79 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 22 Dec 2021 11:52:25 +0200
Subject: [PATCH 0315/1164] Support for RESET command since Redis 6.2.0 (#1824)

---
 redis/client.py        | 1 +
 redis/commands/core.py | 7 +++++++
 tests/test_commands.py | 5 +++++
 3 files changed, 13 insertions(+)

diff --git a/redis/client.py b/redis/client.py
index 16ffbb01fd..c7aa17bf82 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -768,6 +768,7 @@ class Redis(RedisModuleCommands, CoreCommands, SentinelCommands):
         "STRALGO": parse_stralgo,
         "PUBSUB NUMSUB": parse_pubsub_numsub,
         "RANDOMKEY": lambda r: r and r or None,
+        "RESET": str_if_bytes,
         "SCAN": parse_scan,
         "SCRIPT EXISTS": lambda r: list(map(bool, r)),
         "SCRIPT FLUSH": bool_ok,
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 2dd7c106d9..0823315a01 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -817,6 +817,13 @@ def lolwut(self, *version_numbers, **kwargs):
         else:
             return self.execute_command("LOLWUT", **kwargs)
 
+    def reset(self):
+        """Perform a full reset on the connection's server side contenxt.
+
+        See: https://redis.io/commands/reset
+        """
+        return self.execute_command("RESET")
+
     def migrate(
         self,
         host,
diff --git a/tests/test_commands.py b/tests/test_commands.py
index f91804328e..09121617cb 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -669,6 +669,11 @@ def test_lolwut(self, r):
         lolwut = r.lolwut(5, 6, 7, 8).decode("utf-8")
         assert "Redis ver." in lolwut
 
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("6.2.0")
+    def test_reset(self, r):
+        assert r.reset() == "RESET"
+
     def test_object(self, r):
         r["a"] = "foo"
         assert isinstance(r.object("refcount", "a"), int)

From 940d9fc428c3dbe320af003befabe812a8d8537b Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 23 Dec 2021 09:33:02 +0200
Subject: [PATCH 0316/1164] Removing lots-of-pythons container (#1827)

---
 CONTRIBUTING.md | 16 +++++++---------
 tox.ini         |  6 ------
 2 files changed, 7 insertions(+), 15 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 04f989a308..0f9ca0b113 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -32,7 +32,7 @@ Here's how to get started with your code contribution:
 
 1.  Create your own fork of redis-py
 2.  Do the changes in your fork
-3.  
+3.
     *Create a virtualenv and install the development dependencies from the dev_requirements.txt file:*
 
         a.  python -m venv .venv
@@ -69,12 +69,12 @@ configuration](https://redis.io/topics/sentinel).
 
 ## Testing
 
-Call `invoke tests` to run all tests, or `invoke all-tests` to run linters 
-tests as well. With the 'tests' and 'all-tests' targets, all Redis and 
-RedisCluster tests will be run. 
+Call `invoke tests` to run all tests, or `invoke all-tests` to run linters
+tests as well. With the 'tests' and 'all-tests' targets, all Redis and
+RedisCluster tests will be run.
 
-It is possible to run only Redis client tests (with cluster mode disabled) by 
-using `invoke standalone-tests`; similarly, RedisCluster tests can be run by using 
+It is possible to run only Redis client tests (with cluster mode disabled) by
+using `invoke standalone-tests`; similarly, RedisCluster tests can be run by using
 `invoke cluster-tests`.
 
 Each run of tox starts and stops the various dockers required. Sometimes
@@ -85,9 +85,7 @@ tests against multiple versions of python. Feel free to test your
 changes against all the python versions supported, as declared by the
 tox.ini file (eg: tox -e py39). If you have the various python versions
 on your desktop, you can run *tox* by itself, to test all supported
-versions. Alternatively, as your source code is mounted in the
-**lots-of-pythons** docker, you can start exploring from there, with all
-supported python versions!
+versions.
 
 ### Docker Tips
 
diff --git a/tox.ini b/tox.ini
index b574d17b57..bceab0bf15 100644
--- a/tox.ini
+++ b/tox.ini
@@ -73,12 +73,6 @@ ports =
     36379:6379/tcp
 healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',36379)) else False"
 
-[docker:lots-of-pythons]
-name = lots-of-pythons
-image = redisfab/lots-of-pythons:latest
-volumes =
-    bind:rw:{toxinidir}:/data
-
 [docker:redis_cluster]
 name = redis_cluster
 image = redisfab/redis-py-cluster:6.2.6-buster

From ddc51c4ace0caa0787715801b9df42e65c790d46 Mon Sep 17 00:00:00 2001
From: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Date: Thu, 23 Dec 2021 11:42:30 +0200
Subject: [PATCH 0317/1164] Support for specifying error types with retry
 (#1817)

---
 redis/client.py     |  21 +++++---
 redis/connection.py |  27 ++++++++--
 redis/retry.py      |   8 +++
 tests/test_retry.py | 125 +++++++++++++++++++++++++++++++++++++++++++-
 4 files changed, 169 insertions(+), 12 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index c7aa17bf82..0236f20a32 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -869,6 +869,7 @@ def __init__(
         errors=None,
         decode_responses=False,
         retry_on_timeout=False,
+        retry_on_error=[],
         ssl=False,
         ssl_keyfile=None,
         ssl_certfile=None,
@@ -887,8 +888,10 @@ def __init__(
     ):
         """
         Initialize a new Redis client.
-        To specify a retry policy, first set `retry_on_timeout` to `True`
-        then set `retry` to a valid `Retry` object
+        To specify a retry policy for specific errors, first set
+        `retry_on_error` to a list of the error/s to retry on, then set
+        `retry` to a valid `Retry` object.
+        To retry on TimeoutError, `retry_on_timeout` can also be set to `True`.
         """
         if not connection_pool:
             if charset is not None:
@@ -905,7 +908,8 @@ def __init__(
                     )
                 )
                 encoding_errors = errors
-
+            if retry_on_timeout is True:
+                retry_on_error.append(TimeoutError)
             kwargs = {
                 "db": db,
                 "username": username,
@@ -914,7 +918,7 @@ def __init__(
                 "encoding": encoding,
                 "encoding_errors": encoding_errors,
                 "decode_responses": decode_responses,
-                "retry_on_timeout": retry_on_timeout,
+                "retry_on_error": retry_on_error,
                 "retry": copy.deepcopy(retry),
                 "max_connections": max_connections,
                 "health_check_interval": health_check_interval,
@@ -1146,11 +1150,14 @@ def _send_command_parse_response(self, conn, command_name, *args, **options):
     def _disconnect_raise(self, conn, error):
         """
         Close the connection and raise an exception
-        if retry_on_timeout is not set or the error
-        is not a TimeoutError
+        if retry_on_error is not set or the error
+        is not one of the specified error types
         """
         conn.disconnect()
-        if not (conn.retry_on_timeout and isinstance(error, TimeoutError)):
+        if (
+            conn.retry_on_error is None
+            or isinstance(error, tuple(conn.retry_on_error)) is False
+        ):
             raise error
 
     # COMMAND EXECUTION AND PROTOCOL PARSING
diff --git a/redis/connection.py b/redis/connection.py
index 3fe8543ca6..a349a0f23b 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -513,6 +513,7 @@ def __init__(
         socket_keepalive_options=None,
         socket_type=0,
         retry_on_timeout=False,
+        retry_on_error=[],
         encoding="utf-8",
         encoding_errors="strict",
         decode_responses=False,
@@ -526,8 +527,10 @@ def __init__(
     ):
         """
         Initialize a new Connection.
-        To specify a retry policy, first set `retry_on_timeout` to `True`
-        then set `retry` to a valid `Retry` object
+        To specify a retry policy for specific errors, first set
+        `retry_on_error` to a list of the error/s to retry on, then set
+        `retry` to a valid `Retry` object.
+        To retry on TimeoutError, `retry_on_timeout` can also be set to `True`.
         """
         self.pid = os.getpid()
         self.host = host
@@ -543,11 +546,17 @@ def __init__(
         self.socket_type = socket_type
         self.retry_on_timeout = retry_on_timeout
         if retry_on_timeout:
+            # Add TimeoutError to the errors list to retry on
+            retry_on_error.append(TimeoutError)
+        self.retry_on_error = retry_on_error
+        if retry_on_error:
             if retry is None:
                 self.retry = Retry(NoBackoff(), 1)
             else:
                 # deep-copy the Retry object as it is mutable
                 self.retry = copy.deepcopy(retry)
+            # Update the retry's supported errors with the specified errors
+            self.retry.update_supported_erros(retry_on_error)
         else:
             self.retry = Retry(NoBackoff(), 0)
         self.health_check_interval = health_check_interval
@@ -969,6 +978,7 @@ def __init__(
         encoding_errors="strict",
         decode_responses=False,
         retry_on_timeout=False,
+        retry_on_error=[],
         parser_class=DefaultParser,
         socket_read_size=65536,
         health_check_interval=0,
@@ -978,8 +988,10 @@ def __init__(
     ):
         """
         Initialize a new UnixDomainSocketConnection.
-        To specify a retry policy, first set `retry_on_timeout` to `True`
-        then set `retry` to a valid `Retry` object
+        To specify a retry policy for specific errors, first set
+        `retry_on_error` to a list of the error/s to retry on, then set
+        `retry` to a valid `Retry` object.
+        To retry on TimeoutError, `retry_on_timeout` can also be set to `True`.
         """
         self.pid = os.getpid()
         self.path = path
@@ -990,11 +1002,17 @@ def __init__(
         self.socket_timeout = socket_timeout
         self.retry_on_timeout = retry_on_timeout
         if retry_on_timeout:
+            # Add TimeoutError to the errors list to retry on
+            retry_on_error.append(TimeoutError)
+        self.retry_on_error = retry_on_error
+        if self.retry_on_error:
             if retry is None:
                 self.retry = Retry(NoBackoff(), 1)
             else:
                 # deep-copy the Retry object as it is mutable
                 self.retry = copy.deepcopy(retry)
+            # Update the retry's supported errors with the specified errors
+            self.retry.update_supported_erros(retry_on_error)
         else:
             self.retry = Retry(NoBackoff(), 0)
         self.health_check_interval = health_check_interval
@@ -1052,6 +1070,7 @@ def to_bool(value):
     "socket_connect_timeout": float,
     "socket_keepalive": to_bool,
     "retry_on_timeout": to_bool,
+    "retry_on_error": list,
     "max_connections": int,
     "health_check_interval": int,
     "ssl_check_hostname": to_bool,
diff --git a/redis/retry.py b/redis/retry.py
index 75504c77e7..6147fbd9f9 100644
--- a/redis/retry.py
+++ b/redis/retry.py
@@ -19,6 +19,14 @@ def __init__(
         self._retries = retries
         self._supported_errors = supported_errors
 
+    def update_supported_erros(self, specified_errors: list):
+        """
+        Updates the supported errors with the specified error types
+        """
+        self._supported_errors = tuple(
+            set(self._supported_errors + tuple(specified_errors))
+        )
+
     def call_with_retry(self, do, fail):
         """
         Execute an operation that might fail and returns its result, or
diff --git a/tests/test_retry.py b/tests/test_retry.py
index c4650bc650..0094787247 100644
--- a/tests/test_retry.py
+++ b/tests/test_retry.py
@@ -1,10 +1,20 @@
+from unittest.mock import patch
+
 import pytest
 
 from redis.backoff import NoBackoff
+from redis.client import Redis
 from redis.connection import Connection, UnixDomainSocketConnection
-from redis.exceptions import ConnectionError
+from redis.exceptions import (
+    BusyLoadingError,
+    ConnectionError,
+    ReadOnlyError,
+    TimeoutError,
+)
 from redis.retry import Retry
 
+from .conftest import _get_client
+
 
 class BackoffMock:
     def __init__(self):
@@ -39,6 +49,37 @@ def test_retry_on_timeout_retry(self, Class, retries):
         assert isinstance(c.retry, Retry)
         assert c.retry._retries == retries
 
+    @pytest.mark.parametrize("Class", [Connection, UnixDomainSocketConnection])
+    def test_retry_on_error(self, Class):
+        c = Class(retry_on_error=[ReadOnlyError])
+        assert c.retry_on_error == [ReadOnlyError]
+        assert isinstance(c.retry, Retry)
+        assert c.retry._retries == 1
+
+    @pytest.mark.parametrize("Class", [Connection, UnixDomainSocketConnection])
+    def test_retry_on_error_empty_value(self, Class):
+        c = Class(retry_on_error=[])
+        assert c.retry_on_error == []
+        assert isinstance(c.retry, Retry)
+        assert c.retry._retries == 0
+
+    @pytest.mark.parametrize("Class", [Connection, UnixDomainSocketConnection])
+    def test_retry_on_error_and_timeout(self, Class):
+        c = Class(
+            retry_on_error=[ReadOnlyError, BusyLoadingError], retry_on_timeout=True
+        )
+        assert c.retry_on_error == [ReadOnlyError, BusyLoadingError, TimeoutError]
+        assert isinstance(c.retry, Retry)
+        assert c.retry._retries == 1
+
+    @pytest.mark.parametrize("retries", range(10))
+    @pytest.mark.parametrize("Class", [Connection, UnixDomainSocketConnection])
+    def test_retry_on_error_retry(self, Class, retries):
+        c = Class(retry_on_error=[ReadOnlyError], retry=Retry(NoBackoff(), retries))
+        assert c.retry_on_error == [ReadOnlyError]
+        assert isinstance(c.retry, Retry)
+        assert c.retry._retries == retries
+
 
 class TestRetry:
     "Test that Retry calls backoff and retries the expected number of times"
@@ -65,3 +106,85 @@ def test_retry(self, retries):
         assert self.actual_failures == 1 + retries
         assert backoff.reset_calls == 1
         assert backoff.calls == retries
+
+
+@pytest.mark.onlynoncluster
+class TestRedisClientRetry:
+    "Test the standalone Redis client behavior with retries"
+
+    def test_client_retry_on_error_with_success(self, request):
+        with patch.object(Redis, "parse_response") as parse_response:
+
+            def mock_parse_response(connection, *args, **options):
+                def ok_response(connection, *args, **options):
+                    return "MOCK_OK"
+
+                parse_response.side_effect = ok_response
+                raise ReadOnlyError()
+
+            parse_response.side_effect = mock_parse_response
+            r = _get_client(Redis, request, retry_on_error=[ReadOnlyError])
+            assert r.get("foo") == "MOCK_OK"
+            assert parse_response.call_count == 2
+
+    def test_client_retry_on_error_raise(self, request):
+        with patch.object(Redis, "parse_response") as parse_response:
+            parse_response.side_effect = BusyLoadingError()
+            retries = 3
+            r = _get_client(
+                Redis,
+                request,
+                retry_on_error=[ReadOnlyError, BusyLoadingError],
+                retry=Retry(NoBackoff(), retries),
+            )
+            with pytest.raises(BusyLoadingError):
+                try:
+                    r.get("foo")
+                finally:
+                    assert parse_response.call_count == retries + 1
+
+    def test_client_retry_on_error_different_error_raised(self, request):
+        with patch.object(Redis, "parse_response") as parse_response:
+            parse_response.side_effect = TimeoutError()
+            retries = 3
+            r = _get_client(
+                Redis,
+                request,
+                retry_on_error=[ReadOnlyError],
+                retry=Retry(NoBackoff(), retries),
+            )
+            with pytest.raises(TimeoutError):
+                try:
+                    r.get("foo")
+                finally:
+                    assert parse_response.call_count == 1
+
+    def test_client_retry_on_error_and_timeout(self, request):
+        with patch.object(Redis, "parse_response") as parse_response:
+            parse_response.side_effect = TimeoutError()
+            retries = 3
+            r = _get_client(
+                Redis,
+                request,
+                retry_on_error=[ReadOnlyError],
+                retry_on_timeout=True,
+                retry=Retry(NoBackoff(), retries),
+            )
+            with pytest.raises(TimeoutError):
+                try:
+                    r.get("foo")
+                finally:
+                    assert parse_response.call_count == retries + 1
+
+    def test_client_retry_on_timeout(self, request):
+        with patch.object(Redis, "parse_response") as parse_response:
+            parse_response.side_effect = TimeoutError()
+            retries = 3
+            r = _get_client(
+                Redis, request, retry_on_timeout=True, retry=Retry(NoBackoff(), retries)
+            )
+            with pytest.raises(TimeoutError):
+                try:
+                    r.get("foo")
+                finally:
+                    assert parse_response.call_count == retries + 1

From d6cb997bc7b96f4e646a497a89f9466c97aeffef Mon Sep 17 00:00:00 2001
From: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Date: Thu, 23 Dec 2021 11:42:44 +0200
Subject: [PATCH 0318/1164] Fixing read race condition during pubsub (#1737)

---
 redis/client.py      | 74 ++++++++++++++++++++++++++++++++++++++++----
 tests/test_pubsub.py | 43 +++++++++++++++++++------
 2 files changed, 102 insertions(+), 15 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 0236f20a32..5116482cc6 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1288,18 +1288,17 @@ def __init__(
         self.shard_hint = shard_hint
         self.ignore_subscribe_messages = ignore_subscribe_messages
         self.connection = None
+        self.subscribed_event = threading.Event()
         # we need to know the encoding options for this connection in order
         # to lookup channel and pattern names for callback handlers.
         self.encoder = encoder
         if self.encoder is None:
             self.encoder = self.connection_pool.get_encoder()
+        self.health_check_response_b = self.encoder.encode(self.HEALTH_CHECK_MESSAGE)
         if self.encoder.decode_responses:
             self.health_check_response = ["pong", self.HEALTH_CHECK_MESSAGE]
         else:
-            self.health_check_response = [
-                b"pong",
-                self.encoder.encode(self.HEALTH_CHECK_MESSAGE),
-            ]
+            self.health_check_response = [b"pong", self.health_check_response_b]
         self.reset()
 
     def __enter__(self):
@@ -1324,9 +1323,11 @@ def reset(self):
             self.connection_pool.release(self.connection)
             self.connection = None
         self.channels = {}
+        self.health_check_response_counter = 0
         self.pending_unsubscribe_channels = set()
         self.patterns = {}
         self.pending_unsubscribe_patterns = set()
+        self.subscribed_event.clear()
 
     def close(self):
         self.reset()
@@ -1352,7 +1353,7 @@ def on_connect(self, connection):
     @property
     def subscribed(self):
         "Indicates if there are subscriptions to any channels or patterns"
-        return bool(self.channels or self.patterns)
+        return self.subscribed_event.is_set()
 
     def execute_command(self, *args):
         "Execute a publish/subscribe command"
@@ -1370,8 +1371,28 @@ def execute_command(self, *args):
             self.connection.register_connect_callback(self.on_connect)
         connection = self.connection
         kwargs = {"check_health": not self.subscribed}
+        if not self.subscribed:
+            self.clean_health_check_responses()
         self._execute(connection, connection.send_command, *args, **kwargs)
 
+    def clean_health_check_responses(self):
+        """
+        If any health check responses are present, clean them
+        """
+        ttl = 10
+        conn = self.connection
+        while self.health_check_response_counter > 0 and ttl > 0:
+            if self._execute(conn, conn.can_read, timeout=conn.socket_timeout):
+                response = self._execute(conn, conn.read_response)
+                if self.is_health_check_response(response):
+                    self.health_check_response_counter -= 1
+                else:
+                    raise PubSubError(
+                        "A non health check response was cleaned by "
+                        "execute_command: {0}".format(response)
+                    )
+            ttl -= 1
+
     def _disconnect_raise_connect(self, conn, error):
         """
         Close the connection and raise an exception
@@ -1411,11 +1432,23 @@ def parse_response(self, block=True, timeout=0):
             return None
         response = self._execute(conn, conn.read_response)
 
-        if conn.health_check_interval and response == self.health_check_response:
+        if self.is_health_check_response(response):
             # ignore the health check message as user might not expect it
+            self.health_check_response_counter -= 1
             return None
         return response
 
+    def is_health_check_response(self, response):
+        """
+        Check if the response is a health check response.
+        If there are no subscriptions redis responds to PING command with a
+        bulk response, instead of a multi-bulk with "pong" and the response.
+        """
+        return response in [
+            self.health_check_response,  # If there was a subscription
+            self.health_check_response_b,  # If there wasn't
+        ]
+
     def check_health(self):
         conn = self.connection
         if conn is None:
@@ -1426,6 +1459,7 @@ def check_health(self):
 
         if conn.health_check_interval and time.time() > conn.next_health_check:
             conn.send_command("PING", self.HEALTH_CHECK_MESSAGE, check_health=False)
+            self.health_check_response_counter += 1
 
     def _normalize_keys(self, data):
         """
@@ -1455,6 +1489,11 @@ def psubscribe(self, *args, **kwargs):
         # for the reconnection.
         new_patterns = self._normalize_keys(new_patterns)
         self.patterns.update(new_patterns)
+        if not self.subscribed:
+            # Set the subscribed_event flag to True
+            self.subscribed_event.set()
+            # Clear the health check counter
+            self.health_check_response_counter = 0
         self.pending_unsubscribe_patterns.difference_update(new_patterns)
         return ret_val
 
@@ -1489,6 +1528,11 @@ def subscribe(self, *args, **kwargs):
         # for the reconnection.
         new_channels = self._normalize_keys(new_channels)
         self.channels.update(new_channels)
+        if not self.subscribed:
+            # Set the subscribed_event flag to True
+            self.subscribed_event.set()
+            # Clear the health check counter
+            self.health_check_response_counter = 0
         self.pending_unsubscribe_channels.difference_update(new_channels)
         return ret_val
 
@@ -1520,6 +1564,20 @@ def get_message(self, ignore_subscribe_messages=False, timeout=0):
         before returning. Timeout should be specified as a floating point
         number.
         """
+        if not self.subscribed:
+            # Wait for subscription
+            start_time = time.time()
+            if self.subscribed_event.wait(timeout) is True:
+                # The connection was subscribed during the timeout time frame.
+                # The timeout should be adjusted based on the time spent
+                # waiting for the subscription
+                time_spent = time.time() - start_time
+                timeout = max(0.0, timeout - time_spent)
+            else:
+                # The connection isn't subscribed to any channels or patterns,
+                # so no messages are available
+                return None
+
         response = self.parse_response(block=False, timeout=timeout)
         if response:
             return self.handle_message(response, ignore_subscribe_messages)
@@ -1575,6 +1633,10 @@ def handle_message(self, response, ignore_subscribe_messages=False):
                 if channel in self.pending_unsubscribe_channels:
                     self.pending_unsubscribe_channels.remove(channel)
                     self.channels.pop(channel, None)
+            if not self.channels and not self.patterns:
+                # There are no subscriptions anymore, set subscribed_event flag
+                # to false
+                self.subscribed_event.clear()
 
         if message_type in self.PUBLISH_MESSAGE_TYPES:
             # if there's a message handler, invoke it
diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index 20ae0a05c1..23af46153f 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -2,6 +2,7 @@
 import threading
 import time
 from unittest import mock
+from unittest.mock import patch
 
 import pytest
 
@@ -348,15 +349,6 @@ def test_unicode_pattern_message_handler(self, r):
             "pmessage", channel, "test message", pattern=pattern
         )
 
-    def test_get_message_without_subscribe(self, r):
-        p = r.pubsub()
-        with pytest.raises(RuntimeError) as info:
-            p.get_message()
-        expect = (
-            "connection not set: " "did you forget to call subscribe() or psubscribe()?"
-        )
-        assert expect in info.exconly()
-
 
 class TestPubSubAutoDecoding:
     "These tests only validate that we get unicode values back"
@@ -549,6 +541,39 @@ def test_get_message_with_timeout_returns_none(self, r):
         assert wait_for_message(p) == make_message("subscribe", "foo", 1)
         assert p.get_message(timeout=0.01) is None
 
+    def test_get_message_not_subscribed_return_none(self, r):
+        p = r.pubsub()
+        assert p.subscribed is False
+        assert p.get_message() is None
+        assert p.get_message(timeout=0.1) is None
+        with patch.object(threading.Event, "wait") as mock:
+            mock.return_value = False
+            assert p.get_message(timeout=0.01) is None
+            assert mock.called
+
+    def test_get_message_subscribe_during_waiting(self, r):
+        p = r.pubsub()
+
+        def poll(ps, expected_res):
+            assert ps.get_message() is None
+            message = ps.get_message(timeout=1)
+            assert message == expected_res
+
+        subscribe_response = make_message("subscribe", "foo", 1)
+        poller = threading.Thread(target=poll, args=(p, subscribe_response))
+        poller.start()
+        time.sleep(0.2)
+        p.subscribe("foo")
+        poller.join()
+
+    def test_get_message_wait_for_subscription_not_being_called(self, r):
+        p = r.pubsub()
+        p.subscribe("foo")
+        with patch.object(threading.Event, "wait") as mock:
+            assert p.subscribed is True
+            assert wait_for_message(p) == make_message("subscribe", "foo", 1)
+            assert mock.called is False
+
 
 class TestPubSubWorkerThread:
     @pytest.mark.skipif(

From 3347888bfa19f9e82a71ae6dc13a4837c87ea893 Mon Sep 17 00:00:00 2001
From: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Date: Thu, 23 Dec 2021 12:18:02 +0200
Subject: [PATCH 0319/1164] Retry on error exception and timeout fixes (#1821)

---
 redis/cluster.py      | 101 ++++++++++++++++++++----------------------
 tests/test_cluster.py |  39 ++++------------
 2 files changed, 58 insertions(+), 82 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index 0c2fc715d7..5707a9da32 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -17,6 +17,7 @@
     ClusterCrossSlotError,
     ClusterDownError,
     ClusterError,
+    ConnectionError,
     DataError,
     MasterDownError,
     MovedError,
@@ -374,6 +375,12 @@ class RedisCluster(RedisClusterCommands):
         ),
     )
 
+    ERRORS_ALLOW_RETRY = (
+        ConnectionError,
+        TimeoutError,
+        ClusterDownError,
+    )
+
     def __init__(
         self,
         host=None,
@@ -385,8 +392,6 @@ def __init__(
         reinitialize_steps=10,
         read_from_replicas=False,
         url=None,
-        retry_on_timeout=False,
-        retry=None,
         **kwargs,
     ):
         """
@@ -417,11 +422,6 @@ def __init__(
         :cluster_error_retry_attempts: 'int'
              Retry command execution attempts when encountering ClusterDownError
              or ConnectionError
-        :retry_on_timeout: 'bool'
-             To specify a retry policy, first set `retry_on_timeout` to `True`
-             then set `retry` to a valid `Retry` object
-        :retry: 'Retry'
-              a `Retry` object
         :reinitialize_steps: 'int'
             Specifies the number of MOVED errors that need to occur before
             reinitializing the whole cluster topology. If a MOVED error occurs
@@ -452,9 +452,6 @@ def __init__(
                 "Argument 'db' is not possible to use in cluster mode"
             )
 
-        if retry_on_timeout:
-            kwargs.update({"retry_on_timeout": retry_on_timeout, "retry": retry})
-
         # Get the startup node/s
         from_url = False
         if url is not None:
@@ -850,7 +847,7 @@ def _parse_target_nodes(self, target_nodes):
 
     def execute_command(self, *args, **kwargs):
         """
-        Wrapper for ClusterDownError and ConnectionError error handling.
+        Wrapper for ERRORS_ALLOW_RETRY error handling.
 
         It will try the number of times specified by the config option
         "self.cluster_error_retry_attempts" which defaults to 3 unless manually
@@ -865,18 +862,19 @@ def execute_command(self, *args, **kwargs):
             dict<Any, ClusterNode>
         """
         target_nodes_specified = False
-        target_nodes = kwargs.pop("target_nodes", None)
-        if target_nodes is not None and not self._is_nodes_flag(target_nodes):
-            target_nodes = self._parse_target_nodes(target_nodes)
+        target_nodes = None
+        passed_targets = kwargs.pop("target_nodes", None)
+        if passed_targets is not None and not self._is_nodes_flag(passed_targets):
+            target_nodes = self._parse_target_nodes(passed_targets)
             target_nodes_specified = True
-        # If ClusterDownError/ConnectionError were thrown, the nodes
-        # and slots cache were reinitialized. We will retry executing the
-        # command with the updated cluster setup only when the target nodes
-        # can be determined again with the new cache tables. Therefore,
-        # when target nodes were passed to this function, we cannot retry
-        # the command execution since the nodes may not be valid anymore
-        # after the tables were reinitialized. So in case of passed target
-        # nodes, retry_attempts will be set to 1.
+        # If an error that allows retrying was thrown, the nodes and slots
+        # cache were reinitialized. We will retry executing the command with
+        # the updated cluster setup only when the target nodes can be
+        # determined again with the new cache tables. Therefore, when target
+        # nodes were passed to this function, we cannot retry the command
+        # execution since the nodes may not be valid anymore after the tables
+        # were reinitialized. So in case of passed target nodes,
+        # retry_attempts will be set to 1.
         retry_attempts = (
             1 if target_nodes_specified else self.cluster_error_retry_attempts
         )
@@ -887,7 +885,7 @@ def execute_command(self, *args, **kwargs):
                 if not target_nodes_specified:
                     # Determine the nodes to execute the command on
                     target_nodes = self._determine_nodes(
-                        *args, **kwargs, nodes_flag=target_nodes
+                        *args, **kwargs, nodes_flag=passed_targets
                     )
                     if not target_nodes:
                         raise RedisClusterException(
@@ -897,11 +895,14 @@ def execute_command(self, *args, **kwargs):
                     res[node.name] = self._execute_command(node, *args, **kwargs)
                 # Return the processed result
                 return self._process_result(args[0], res, **kwargs)
-            except (ClusterDownError, ConnectionError) as e:
-                # The nodes and slots cache were reinitialized.
-                # Try again with the new cluster setup. All other errors
-                # should be raised.
-                exception = e
+            except BaseException as e:
+                if type(e) in RedisCluster.ERRORS_ALLOW_RETRY:
+                    # The nodes and slots cache were reinitialized.
+                    # Try again with the new cluster setup.
+                    exception = e
+                else:
+                    # All other errors should be raised.
+                    raise e
 
         # If it fails the configured number of times then raise exception back
         # to caller of this method
@@ -953,11 +954,11 @@ def _execute_command(self, target_node, *args, **kwargs):
                     )
                 return response
 
-            except (RedisClusterException, BusyLoadingError):
-                log.exception("RedisClusterException || BusyLoadingError")
+            except (RedisClusterException, BusyLoadingError) as e:
+                log.exception(type(e))
                 raise
-            except ConnectionError:
-                log.exception("ConnectionError")
+            except (ConnectionError, TimeoutError) as e:
+                log.exception(type(e))
                 # ConnectionError can also be raised if we couldn't get a
                 # connection from the pool before timing out, so check that
                 # this is an actual connection before attempting to disconnect.
@@ -976,13 +977,6 @@ def _execute_command(self, target_node, *args, **kwargs):
                     # and try again with the new setup
                     self.nodes_manager.initialize()
                     raise
-            except TimeoutError:
-                log.exception("TimeoutError")
-                if connection is not None:
-                    connection.disconnect()
-
-                if ttl < self.RedisClusterRequestTTL / 2:
-                    time.sleep(0.05)
             except MovedError as e:
                 # First, we will try to patch the slots/nodes cache with the
                 # redirected node output and try again. If MovedError exceeds
@@ -1016,7 +1010,7 @@ def _execute_command(self, target_node, *args, **kwargs):
                 # ClusterDownError can occur during a failover and to get
                 # self-healed, we will try to reinitialize the cluster layout
                 # and retry executing the command
-                time.sleep(0.05)
+                time.sleep(0.25)
                 self.nodes_manager.initialize()
                 raise e
             except ResponseError as e:
@@ -1342,7 +1336,7 @@ def initialize(self):
                     raise RedisClusterException(
                         "Cluster mode is not enabled on this node"
                     )
-                cluster_slots = r.execute_command("CLUSTER SLOTS")
+                cluster_slots = str_if_bytes(r.execute_command("CLUSTER SLOTS"))
                 startup_nodes_reachable = True
             except (ConnectionError, TimeoutError) as e:
                 msg = e.__str__
@@ -1631,21 +1625,20 @@ def get_redis_connection(self):
             return self.node.redis_connection
 
 
-ERRORS_ALLOW_RETRY = (
-    ConnectionError,
-    TimeoutError,
-    MovedError,
-    AskError,
-    TryAgainError,
-)
-
-
 class ClusterPipeline(RedisCluster):
     """
     Support for Redis pipeline
     in cluster mode
     """
 
+    ERRORS_ALLOW_RETRY = (
+        ConnectionError,
+        TimeoutError,
+        MovedError,
+        AskError,
+        TryAgainError,
+    )
+
     def __init__(
         self,
         nodes_manager,
@@ -1653,7 +1646,7 @@ def __init__(
         cluster_response_callbacks=None,
         startup_nodes=None,
         read_from_replicas=False,
-        cluster_error_retry_attempts=3,
+        cluster_error_retry_attempts=5,
         reinitialize_steps=10,
         **kwargs,
     ):
@@ -1915,7 +1908,11 @@ def _send_cluster_commands(
         # collect all the commands we are allowed to retry.
         # (MOVED, ASK, or connection errors or timeout errors)
         attempt = sorted(
-            (c for c in attempt if isinstance(c.result, ERRORS_ALLOW_RETRY)),
+            (
+                c
+                for c in attempt
+                if isinstance(c.result, ClusterPipeline.ERRORS_ALLOW_RETRY)
+            ),
             key=lambda x: x.position,
         )
         if attempt and allow_redirections:
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index e1c8c34768..496ed9818b 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -22,6 +22,7 @@
 from redis.exceptions import (
     AskError,
     ClusterDownError,
+    ConnectionError,
     DataError,
     MovedError,
     NoPermissionError,
@@ -555,46 +556,24 @@ def test_all_nodes_masters(self, r):
         for node in r.get_primaries():
             assert node in nodes
 
-    def test_cluster_down_overreaches_retry_attempts(self):
+    @pytest.mark.parametrize("error", RedisCluster.ERRORS_ALLOW_RETRY)
+    def test_cluster_down_overreaches_retry_attempts(self, error):
         """
-        When ClusterDownError is thrown, test that we retry executing the
-        command as many times as configured in cluster_error_retry_attempts
+        When error that allows retry is thrown, test that we retry executing
+        the command as many times as configured in cluster_error_retry_attempts
         and then raise the exception
         """
         with patch.object(RedisCluster, "_execute_command") as execute_command:
 
-            def raise_cluster_down_error(target_node, *args, **kwargs):
+            def raise_error(target_node, *args, **kwargs):
                 execute_command.failed_calls += 1
-                raise ClusterDownError(
-                    "CLUSTERDOWN The cluster is down. Use CLUSTER INFO for "
-                    "more information"
-                )
+                raise error("mocked error")
 
-            execute_command.side_effect = raise_cluster_down_error
+            execute_command.side_effect = raise_error
 
             rc = get_mocked_redis_client(host=default_host, port=default_port)
 
-            with pytest.raises(ClusterDownError):
-                rc.get("bar")
-                assert execute_command.failed_calls == rc.cluster_error_retry_attempts
-
-    def test_connection_error_overreaches_retry_attempts(self):
-        """
-        When ConnectionError is thrown, test that we retry executing the
-        command as many times as configured in cluster_error_retry_attempts
-        and then raise the exception
-        """
-        with patch.object(RedisCluster, "_execute_command") as execute_command:
-
-            def raise_conn_error(target_node, *args, **kwargs):
-                execute_command.failed_calls += 1
-                raise ConnectionError()
-
-            execute_command.side_effect = raise_conn_error
-
-            rc = get_mocked_redis_client(host=default_host, port=default_port)
-
-            with pytest.raises(ConnectionError):
+            with pytest.raises(error):
                 rc.get("bar")
                 assert execute_command.failed_calls == rc.cluster_error_retry_attempts
 

From 83570a74483794a1465e10c10e3405d0fbbf0589 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 23 Dec 2021 12:18:34 +0200
Subject: [PATCH 0320/1164] Support for SELECT (#1825)

---
 redis/commands/core.py | 7 +++++++
 tests/test_commands.py | 6 ++++++
 2 files changed, 13 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 0823315a01..4f0accd957 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -780,6 +780,13 @@ def swapdb(self, first, second, **kwargs):
         """
         return self.execute_command("SWAPDB", first, second, **kwargs)
 
+    def select(self, index, **kwargs):
+        """Select the Redis logical database at index.
+
+        See: https://redis.io/commands/select
+        """
+        return self.execute_command("SELECT", index, **kwargs)
+
     def info(self, section=None, **kwargs):
         """
         Returns a dictionary containing information about the Redis server
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 09121617cb..f4ffb6329c 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -695,6 +695,12 @@ def test_role(self, r):
         assert isinstance(r.role()[1], int)
         assert isinstance(r.role()[2], list)
 
+    @pytest.mark.onlynoncluster
+    def test_select(self, r):
+        assert r.select(5)
+        assert r.select(2)
+        assert r.select(9)
+
     @pytest.mark.onlynoncluster
     def test_slowlog_get(self, r, slowlog):
         assert r.slowlog_reset()

From 04b8d34e212723974b9b1f484fe7cd9e93f0e315 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 23 Dec 2021 16:23:06 +0200
Subject: [PATCH 0321/1164] Marking STRALGO as prior to redis 7 (#1829)

---
 tests/test_commands.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tests/test_commands.py b/tests/test_commands.py
index f4ffb6329c..897fcceed1 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1346,6 +1346,7 @@ def test_setrange(self, r):
         assert r["a"] == b"abcdef12345"
 
     @skip_if_server_version_lt("6.0.0")
+    @skip_if_server_version_gte("7.0.0")
     def test_stralgo_lcs(self, r):
         key1 = "{foo}key1"
         key2 = "{foo}key2"

From f03d008ba226c698e266158012b47b348b89b503 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Sun, 26 Dec 2021 08:06:04 +0100
Subject: [PATCH 0322/1164] SRTALGO - skip for redis versions greater than
 7.0.0 (#1831)

---
 tests/test_commands.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tests/test_commands.py b/tests/test_commands.py
index 897fcceed1..b28b63ea6e 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1379,6 +1379,7 @@ def test_stralgo_lcs(self, r):
         ) == {"len": len(res), "matches": [[4, (4, 7), (5, 8)]]}
 
     @skip_if_server_version_lt("6.0.0")
+    @skip_if_server_version_gte("7.0.0")
     def test_stralgo_negative(self, r):
         with pytest.raises(exceptions.DataError):
             r.stralgo("ISSUB", "value1", "value2")

From b426d0d41cc28f1b0f6ec7092cfb819ce00a6e16 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 26 Dec 2021 15:02:43 +0200
Subject: [PATCH 0323/1164] OCSP stapling support (#1820)

---
 redis/client.py     |   2 +
 redis/connection.py |  17 ++++-
 redis/exceptions.py |   4 ++
 redis/ocsp.py       | 159 ++++++++++++++++++++++++++++++++++++++++++++
 redis/utils.py      |   7 ++
 setup.py            |   1 +
 tasks.py            |   2 +-
 tests/conftest.py   |  18 +++++
 tests/test_ssl.py   | 102 +++++++++++++++++++++++++++-
 tox.ini             |   9 +--
 10 files changed, 310 insertions(+), 11 deletions(-)
 create mode 100644 redis/ocsp.py

diff --git a/redis/client.py b/redis/client.py
index 5116482cc6..0984a7c243 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -878,6 +878,7 @@ def __init__(
         ssl_ca_path=None,
         ssl_check_hostname=False,
         ssl_password=None,
+        ssl_validate_ocsp=False,
         max_connections=None,
         single_connection_client=False,
         health_check_interval=0,
@@ -956,6 +957,7 @@ def __init__(
                             "ssl_check_hostname": ssl_check_hostname,
                             "ssl_password": ssl_password,
                             "ssl_ca_path": ssl_ca_path,
+                            "ssl_validate_ocsp": ssl_validate_ocsp,
                         }
                     )
             connection_pool = ConnectionPool(**kwargs)
diff --git a/redis/connection.py b/redis/connection.py
index a349a0f23b..bde74b17df 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -31,7 +31,7 @@
     TimeoutError,
 )
 from redis.retry import Retry
-from redis.utils import HIREDIS_AVAILABLE, str_if_bytes
+from redis.utils import CRYPTOGRAPHY_AVAILABLE, HIREDIS_AVAILABLE, str_if_bytes
 
 try:
     import ssl
@@ -907,6 +907,7 @@ def __init__(
         ssl_check_hostname=False,
         ssl_ca_path=None,
         ssl_password=None,
+        ssl_validate_ocsp=False,
         **kwargs,
     ):
         """Constructor
@@ -948,6 +949,7 @@ def __init__(
         self.ca_path = ssl_ca_path
         self.check_hostname = ssl_check_hostname
         self.certificate_password = ssl_password
+        self.ssl_validate_ocsp = ssl_validate_ocsp
 
     def _connect(self):
         "Wrap the socket with SSL support"
@@ -963,7 +965,18 @@ def _connect(self):
             )
         if self.ca_certs is not None or self.ca_path is not None:
             context.load_verify_locations(cafile=self.ca_certs, capath=self.ca_path)
-        return context.wrap_socket(sock, server_hostname=self.host)
+        sslsock = context.wrap_socket(sock, server_hostname=self.host)
+        if self.ssl_validate_ocsp is True and CRYPTOGRAPHY_AVAILABLE is False:
+            raise RedisError("cryptography is not installed.")
+        elif self.ssl_validate_ocsp is True and CRYPTOGRAPHY_AVAILABLE:
+            from .ocsp import OCSPVerifier
+
+            o = OCSPVerifier(sslsock, self.host, self.port, self.ca_certs)
+            if o.is_valid():
+                return sslsock
+            else:
+                raise ConnectionError("ocsp validation error")
+        return sslsock
 
 
 class UnixDomainSocketConnection(Connection):
diff --git a/redis/exceptions.py b/redis/exceptions.py
index e37cad358e..d18b354454 100644
--- a/redis/exceptions.py
+++ b/redis/exceptions.py
@@ -17,6 +17,10 @@ class AuthenticationError(ConnectionError):
     pass
 
 
+class AuthorizationError(ConnectionError):
+    pass
+
+
 class BusyLoadingError(ConnectionError):
     pass
 
diff --git a/redis/ocsp.py b/redis/ocsp.py
new file mode 100644
index 0000000000..49aaddf48b
--- /dev/null
+++ b/redis/ocsp.py
@@ -0,0 +1,159 @@
+import base64
+import ssl
+from urllib.parse import urljoin, urlparse
+
+import cryptography.hazmat.primitives.hashes
+import requests
+from cryptography import hazmat, x509
+from cryptography.hazmat import backends
+from cryptography.x509 import ocsp
+
+from redis.exceptions import AuthorizationError, ConnectionError
+
+
+class OCSPVerifier:
+    """A class to verify ssl sockets for RFC6960/RFC6961.
+
+    @see https://datatracker.ietf.org/doc/html/rfc6960
+    @see https://datatracker.ietf.org/doc/html/rfc6961
+    """
+
+    def __init__(self, sock, host, port, ca_certs=None):
+        self.SOCK = sock
+        self.HOST = host
+        self.PORT = port
+        self.CA_CERTS = ca_certs
+
+    def _bin2ascii(self, der):
+        """Convert SSL certificates in a binary (DER) format to ASCII PEM."""
+
+        pem = ssl.DER_cert_to_PEM_cert(der)
+        cert = x509.load_pem_x509_certificate(pem.encode(), backends.default_backend())
+        return cert
+
+    def components_from_socket(self):
+        """This function returns the certificate, primary issuer, and primary ocsp server
+        in the chain for a socket already wrapped with ssl.
+        """
+
+        # convert the binary certifcate to text
+        der = self.SOCK.getpeercert(True)
+        if der is False:
+            raise ConnectionError("no certificate found for ssl peer")
+        cert = self._bin2ascii(der)
+        return self._certificate_components(cert)
+
+    def _certificate_components(self, cert):
+        """Given an SSL certificate, retract the useful components for
+        validating the certificate status with an OCSP server.
+
+        Args:
+            cert ([bytes]): A PEM encoded ssl certificate
+        """
+
+        try:
+            aia = cert.extensions.get_extension_for_oid(
+                x509.oid.ExtensionOID.AUTHORITY_INFORMATION_ACCESS
+            ).value
+        except cryptography.x509.extensions.ExtensionNotFound:
+            raise ConnectionError("No AIA information present in ssl certificate")
+
+        # fetch certificate issuers
+        issuers = [
+            i
+            for i in aia
+            if i.access_method == x509.oid.AuthorityInformationAccessOID.CA_ISSUERS
+        ]
+        try:
+            issuer = issuers[0].access_location.value
+        except IndexError:
+            raise ConnectionError("no issuers in certificate")
+
+        # now, the series of ocsp server entries
+        ocsps = [
+            i
+            for i in aia
+            if i.access_method == x509.oid.AuthorityInformationAccessOID.OCSP
+        ]
+
+        try:
+            ocsp = ocsps[0].access_location.value
+        except IndexError:
+            raise ConnectionError("no ocsp servers in certificate")
+
+        return cert, issuer, ocsp
+
+    def components_from_direct_connection(self):
+        """Return the certificate, primary issuer, and primary ocsp server
+        from the host defined by the socket. This is useful in cases where
+        different certificates are occasionally presented.
+        """
+
+        pem = ssl.get_server_certificate((self.HOST, self.PORT), ca_certs=self.CA_CERTS)
+        cert = x509.load_pem_x509_certificate(pem.encode(), backends.default_backend())
+        return self._certificate_components(cert)
+
+    def build_certificate_url(self, server, cert, issuer_cert):
+        """Return the complete url to the ocsp"""
+        orb = ocsp.OCSPRequestBuilder()
+
+        # add_certificate returns an initialized OCSPRequestBuilder
+        orb = orb.add_certificate(
+            cert, issuer_cert, cryptography.hazmat.primitives.hashes.SHA256()
+        )
+        request = orb.build()
+
+        path = base64.b64encode(
+            request.public_bytes(hazmat.primitives.serialization.Encoding.DER)
+        )
+        url = urljoin(server, path.decode("ascii"))
+        return url
+
+    def check_certificate(self, server, cert, issuer_url):
+        """Checks the validitity of an ocsp server for an issuer"""
+
+        r = requests.get(issuer_url)
+        if not r.ok:
+            raise ConnectionError("failed to fetch issuer certificate")
+        der = r.content
+        issuer_cert = self._bin2ascii(der)
+
+        ocsp_url = self.build_certificate_url(server, cert, issuer_cert)
+
+        # HTTP 1.1 mandates the addition of the Host header in ocsp responses
+        header = {
+            "Host": urlparse(ocsp_url).netloc,
+            "Content-Type": "application/ocsp-request",
+        }
+        r = requests.get(ocsp_url, headers=header)
+        if not r.ok:
+            raise ConnectionError("failed to fetch ocsp certificate")
+
+        ocsp_response = ocsp.load_der_ocsp_response(r.content)
+        if ocsp_response.response_status == ocsp.OCSPResponseStatus.UNAUTHORIZED:
+            raise AuthorizationError(
+                "you are not authorized to view this ocsp certificate"
+            )
+        if ocsp_response.response_status == ocsp.OCSPResponseStatus.SUCCESSFUL:
+            if ocsp_response.certificate_status == ocsp.OCSPCertStatus.REVOKED:
+                return False
+            else:
+                return True
+        else:
+            return False
+
+    def is_valid(self):
+        """Returns the validity of the certificate wrapping our socket.
+        This first retrieves for validate the certificate, issuer_url,
+        and ocsp_server for certificate validate. Then retrieves the
+        issuer certificate from the issuer_url, and finally checks
+        the valididy of OCSP revocation status.
+        """
+
+        # validate the certificate
+        try:
+            cert, issuer_url, ocsp_server = self.components_from_socket()
+            return self.check_certificate(ocsp_server, cert, issuer_url)
+        except AuthorizationError:
+            cert, issuer_url, ocsp_server = self.components_from_direct_connection()
+            return self.check_certificate(ocsp_server, cert, issuer_url)
diff --git a/redis/utils.py b/redis/utils.py
index 50961cb767..56fec49b70 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -7,6 +7,13 @@
 except ImportError:
     HIREDIS_AVAILABLE = False
 
+try:
+    import cryptography  # noqa
+
+    CRYPTOGRAPHY_AVAILABLE = True
+except ImportError:
+    CRYPTOGRAPHY_AVAILABLE = False
+
 
 def from_url(url, **kwargs):
     """
diff --git a/setup.py b/setup.py
index 524ea845d1..83b4a449dd 100644
--- a/setup.py
+++ b/setup.py
@@ -48,5 +48,6 @@
     ],
     extras_require={
         "hiredis": ["hiredis>=1.0.0"],
+        "cryptography": ["cryptography>=36.0.1", "requests>=2.26.0"],
     },
 )
diff --git a/tasks.py b/tasks.py
index 98ed483fb1..0fbb5e8352 100644
--- a/tasks.py
+++ b/tasks.py
@@ -65,7 +65,7 @@ def standalone_tests(c):
     with and without hiredis."""
     print("Starting Redis tests")
     _generate_keys()
-    run("tox -e standalone-'{plain,hiredis}'")
+    run("tox -e standalone-'{plain,hiredis,cryptography}'")
 
 
 @task
diff --git a/tests/conftest.py b/tests/conftest.py
index 0149166d65..505a6e47e1 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -170,6 +170,24 @@ def skip_ifnot_redis_enterprise():
     return pytest.mark.skipif(check, reason="Not running in redis enterprise")
 
 
+def skip_if_nocryptography():
+    try:
+        import cryptography  # noqa
+
+        return pytest.mark.skipif(False, reason="Cryptography dependency found")
+    except ImportError:
+        return pytest.mark.skipif(True, reason="No cryptography dependency")
+
+
+def skip_if_cryptography():
+    try:
+        import cryptography  # noqa
+
+        return pytest.mark.skipif(True, reason="Cryptography dependency found")
+    except ImportError:
+        return pytest.mark.skipif(False, reason="No cryptography dependency")
+
+
 def _get_client(
     cls, request, single_connection_client=True, flushdb=True, from_url=None, **kwargs
 ):
diff --git a/tests/test_ssl.py b/tests/test_ssl.py
index 70f9e58b76..a2f66b26ef 100644
--- a/tests/test_ssl.py
+++ b/tests/test_ssl.py
@@ -1,10 +1,14 @@
 import os
+import socket
+import ssl
 from urllib.parse import urlparse
 
 import pytest
 
 import redis
-from redis.exceptions import ConnectionError
+from redis.exceptions import ConnectionError, RedisError
+
+from .conftest import skip_if_cryptography, skip_if_nocryptography
 
 
 @pytest.mark.ssl
@@ -59,3 +63,99 @@ def test_validating_self_signed_certificate(self, request):
             ssl_ca_certs=os.path.join(self.CERT_DIR, "server-cert.pem"),
         )
         assert r.ping()
+
+    def _create_oscp_conn(self, request):
+        ssl_url = request.config.option.redis_ssl_url
+        p = urlparse(ssl_url)[1].split(":")
+        r = redis.Redis(
+            host=p[0],
+            port=p[1],
+            ssl=True,
+            ssl_certfile=os.path.join(self.CERT_DIR, "server-cert.pem"),
+            ssl_keyfile=os.path.join(self.CERT_DIR, "server-key.pem"),
+            ssl_cert_reqs="required",
+            ssl_ca_certs=os.path.join(self.CERT_DIR, "server-cert.pem"),
+            ssl_validate_ocsp=True,
+        )
+        return r
+
+    @skip_if_cryptography()
+    def test_ssl_ocsp_called(self, request):
+        r = self._create_oscp_conn(request)
+        with pytest.raises(RedisError) as e:
+            assert r.ping()
+            assert "cryptography not installed" in str(e)
+
+    @skip_if_nocryptography()
+    def test_ssl_ocsp_called_withcrypto(self, request):
+        r = self._create_oscp_conn(request)
+        with pytest.raises(ConnectionError) as e:
+            assert r.ping()
+            assert "No AIA information present in ssl certificate" in str(e)
+
+        # rediss://, url based
+        ssl_url = request.config.option.redis_ssl_url
+        sslclient = redis.from_url(ssl_url)
+        with pytest.raises(ConnectionError) as e:
+            sslclient.ping()
+            assert "No AIA information present in ssl certificate" in str(e)
+
+    @skip_if_nocryptography()
+    def test_valid_ocsp_cert_http(self):
+        from redis.ocsp import OCSPVerifier
+
+        hostnames = ["github.com", "aws.amazon.com", "ynet.co.il", "microsoft.com"]
+        for hostname in hostnames:
+            context = ssl.create_default_context()
+            with socket.create_connection((hostname, 443)) as sock:
+                with context.wrap_socket(sock, server_hostname=hostname) as wrapped:
+                    ocsp = OCSPVerifier(wrapped, hostname, 443)
+                    assert ocsp.is_valid()
+
+    @skip_if_nocryptography()
+    def test_revoked_ocsp_certificate(self):
+        from redis.ocsp import OCSPVerifier
+
+        context = ssl.create_default_context()
+        hostname = "revoked.badssl.com"
+        with socket.create_connection((hostname, 443)) as sock:
+            with context.wrap_socket(sock, server_hostname=hostname) as wrapped:
+                ocsp = OCSPVerifier(wrapped, hostname, 443)
+                assert ocsp.is_valid() is False
+
+    @skip_if_nocryptography()
+    def test_unauthorized_ocsp(self):
+        from redis.ocsp import OCSPVerifier
+
+        context = ssl.create_default_context()
+        hostname = "stackoverflow.com"
+        with socket.create_connection((hostname, 443)) as sock:
+            with context.wrap_socket(sock, server_hostname=hostname) as wrapped:
+                ocsp = OCSPVerifier(wrapped, hostname, 443)
+                with pytest.raises(ConnectionError):
+                    ocsp.is_valid()
+
+    @skip_if_nocryptography()
+    def test_ocsp_not_present_in_response(self):
+        from redis.ocsp import OCSPVerifier
+
+        context = ssl.create_default_context()
+        hostname = "google.co.il"
+        with socket.create_connection((hostname, 443)) as sock:
+            with context.wrap_socket(sock, server_hostname=hostname) as wrapped:
+                ocsp = OCSPVerifier(wrapped, hostname, 443)
+                assert ocsp.is_valid() is False
+
+    @skip_if_nocryptography()
+    def test_unauthorized_then_direct(self):
+        from redis.ocsp import OCSPVerifier
+
+        # these certificates on the socket end return unauthorized
+        # then the second call succeeds
+        hostnames = ["wikipedia.org", "squarespace.com"]
+        for hostname in hostnames:
+            context = ssl.create_default_context()
+            with socket.create_connection((hostname, 443)) as sock:
+                with context.wrap_socket(sock, server_hostname=hostname) as wrapped:
+                    ocsp = OCSPVerifier(wrapped, hostname, 443)
+                    assert ocsp.is_valid()
diff --git a/tox.ini b/tox.ini
index bceab0bf15..0da66ed4f0 100644
--- a/tox.ini
+++ b/tox.ini
@@ -10,7 +10,7 @@ markers =
 [tox]
 minversion = 3.2.0
 requires = tox-docker
-envlist = {standalone,cluster}-{plain,hiredis}-{py36,py37,py38,py39,pypy3},linters,docs
+envlist = {standalone,cluster}-{plain,hiredis,cryptography}-{py36,py37,py38,py39,pypy3},linters,docs
 
 [docker:master]
 name = master
@@ -118,6 +118,7 @@ docker =
     stunnel
 extras =
     hiredis: hiredis
+    cryptography: cryptography, requests
 setenv =
     CLUSTER_URL = "redis://localhost:16379/0"
 run_before = {toxinidir}/docker/stunnel/create_certs.sh
@@ -145,12 +146,6 @@ commands =
 skipsdist = true
 skip_install = true
 
-[testenv:pypy3-plain]
-basepython = pypy3
-
-[testenv:pypy3-hiredis]
-basepython = pypy3
-
 [testenv:docs]
 deps_files = docs/requirements.txt
 docker =

From 1b7d5bbac89d1dc65154e52360af43373d45ebc6 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 26 Dec 2021 15:23:03 +0200
Subject: [PATCH 0324/1164] 4.1.0 (#1828)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 83b4a449dd..7733220838 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.1.0rc2",
+    version="4.1.0",
     packages=find_packages(
         include=[
             "redis",

From deaaa536568e50b6ce958de0dd6306392e98f13e Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 30 Dec 2021 11:40:48 +0200
Subject: [PATCH 0325/1164] Connection examples (#1835)

Co-authored-by: Chayim I. Kirshen <c@kirshen.com>
---
 docs/conf.py                                  |   4 +-
 docs/examples.rst                             |   8 +
 .../connection_example-checkpoint.ipynb       | 180 +++++++++++++
 {examples => docs/examples}/README.md         |   0
 docs/examples/connection_example.ipynb        | 254 ++++++++++++++++++
 docs/index.rst                                |   1 +
 docs/requirements.txt                         |   3 +
 tasks.py                                      |   1 +
 tox.ini                                       |   4 +-
 9 files changed, 452 insertions(+), 3 deletions(-)
 create mode 100644 docs/examples.rst
 create mode 100644 docs/examples/.ipynb_checkpoints/connection_example-checkpoint.ipynb
 rename {examples => docs/examples}/README.md (100%)
 create mode 100644 docs/examples/connection_example.ipynb

diff --git a/docs/conf.py b/docs/conf.py
index 7e83e42156..0f11442232 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -27,6 +27,8 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
 extensions = [
+    "nbsphinx",
+    "sphinx_gallery.load_style",
     "sphinx.ext.autodoc",
     "sphinx.ext.doctest",
     "sphinx.ext.viewcode",
@@ -73,7 +75,7 @@
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
-exclude_patterns = ["_build"]
+exclude_patterns = ["_build", "**.ipynb_checkponts"]
 
 # The reST default role (used for this markup: `text`) to use for all
 # documents.
diff --git a/docs/examples.rst b/docs/examples.rst
new file mode 100644
index 0000000000..1a82182869
--- /dev/null
+++ b/docs/examples.rst
@@ -0,0 +1,8 @@
+Examples
+########
+
+.. toctree::
+   :maxdepth: 3
+   :glob:
+
+   examples/connection_example
diff --git a/docs/examples/.ipynb_checkpoints/connection_example-checkpoint.ipynb b/docs/examples/.ipynb_checkpoints/connection_example-checkpoint.ipynb
new file mode 100644
index 0000000000..04de8fe1c5
--- /dev/null
+++ b/docs/examples/.ipynb_checkpoints/connection_example-checkpoint.ipynb
@@ -0,0 +1,180 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Connect to redis running locally with default parameters "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 40,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "True\n"
+     ]
+    }
+   ],
+   "source": [
+    "import redis\n",
+    "r = redis.Redis()\n",
+    "print(r.ping())"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Overwrite default parameters - connect to redis on specific host and port using username and password"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 39,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "True\n"
+     ]
+    }
+   ],
+   "source": [
+    "import redis\n",
+    "r = redis.Redis(host='localhost', port=6380, username='dvora', password='redis')\n",
+    "print(r.ping())"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Create a SSL wrapped TCP socket connection"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 38,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "True\n"
+     ]
+    }
+   ],
+   "source": [
+    "import redis\n",
+    "r = redis.Redis(host='localhost', port=6666, ssl=True, ssl_cert_reqs=\"none\")\n",
+    "print(r.ping())"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Add more parameters..."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 37,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "True\n"
+     ]
+    }
+   ],
+   "source": [
+    "import os\n",
+    "import redis\n",
+    "\n",
+    "ROOT = os.path.join(os.getcwd(), \"..\")\n",
+    "CERT_DIR = os.path.abspath(os.path.join(ROOT, \"docker\", \"stunnel\", \"keys\"))\n",
+    "\n",
+    "r = redis.Redis(\n",
+    "    host=\"localhost\",\n",
+    "    port=6666,\n",
+    "    ssl=True,\n",
+    "    ssl_certfile=os.path.join(CERT_DIR, \"server-cert.pem\"),\n",
+    "    ssl_keyfile=os.path.join(CERT_DIR, \"server-key.pem\"),\n",
+    "    ssl_cert_reqs=\"required\",\n",
+    "    ssl_ca_certs=os.path.join(CERT_DIR, \"server-cert.pem\"),\n",
+    ")\n",
+    "print(r.ping())"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Connect to redis client object configured from given URL\n",
+    "##### Three URL schemes are supported:\n",
+    "\n",
+    "##### - `redis://` creates a TCP socket connection. See more at:\n",
+    "##### <https://www.iana.org/assignments/uri-schemes/prov/redis>\n",
+    "##### - `rediss://` creates a SSL wrapped TCP socket connection. See more at:\n",
+    "##### <https://www.iana.org/assignments/uri-schemes/prov/rediss>\n",
+    "##### - ``unix://``: creates a Unix Domain Socket connection.\n",
+    "\n",
+    "##### Parameters are passed through querystring"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 36,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "True\n"
+     ]
+    }
+   ],
+   "source": [
+    "import redis\n",
+    "r = redis.from_url(\"rediss://localhost:6666?ssl_cert_reqs=none\")\n",
+    "print(r.ping())"
+   ]
+  }
+ ],
+ "metadata": {
+  "interpreter": {
+   "hash": "d45c99ba0feda92868abafa8257cbb4709c97f1a0b5dc62bbeebdf89d4fad7fe"
+  },
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.9.9"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/examples/README.md b/docs/examples/README.md
similarity index 100%
rename from examples/README.md
rename to docs/examples/README.md
diff --git a/docs/examples/connection_example.ipynb b/docs/examples/connection_example.ipynb
new file mode 100644
index 0000000000..af5193e0d7
--- /dev/null
+++ b/docs/examples/connection_example.ipynb
@@ -0,0 +1,254 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Connection Examples"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import redis"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Connecting to a default Redis instance, running locally."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 2,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "connection = redis.Redis()\n",
+    "connection.ping()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### by default Redis return binary responses, to decode them use decode_responses=True"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 3,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "decode_connection = redis.Redis(decode_responses=True)\n",
+    "connection.ping()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Connecting to a redis instance, specifying a host and port with credentials."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 4,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "user_connection = redis.Redis(host='localhost', port=6380, username='dvora', password='redis', decode_responses=True)\n",
+    "user_connection.ping()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Connecting to a Redis instance via SSL."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 5,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "ssl_connection = redis.Redis(host='localhost', port=6666, ssl=True, ssl_cert_reqs=\"none\")\n",
+    "ssl_connection.ping()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Connecting to a Redis instance via SSL, while specifying a self-signed SSL certificate."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 6,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "import os\n",
+    "\n",
+    "ROOT = os.path.join(os.getcwd(), \"..\", \"..\")\n",
+    "CERT_DIR = os.path.abspath(os.path.join(ROOT, \"docker\", \"stunnel\", \"keys\"))\n",
+    "ssl_certfile=os.path.join(CERT_DIR, \"server-cert.pem\")\n",
+    "ssl_keyfile=os.path.join(CERT_DIR, \"server-key.pem\")\n",
+    "ssl_ca_certs=os.path.join(CERT_DIR, \"server-cert.pem\")\n",
+    "\n",
+    "ssl_cert_conn = redis.Redis(\n",
+    "    host=\"localhost\",\n",
+    "    port=6666,\n",
+    "    ssl=True,\n",
+    "    ssl_certfile=ssl_certfile,\n",
+    "    ssl_keyfile=ssl_keyfile,\n",
+    "    ssl_cert_reqs=\"required\",\n",
+    "    ssl_ca_certs=ssl_ca_certs,\n",
+    ")\n",
+    "ssl_cert_conn.ping()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Connecting to Redis instances by specifying a URL scheme.\n",
+    "Parameters are passed to the following schems, as parameters to the url scheme.\n",
+    "\n",
+    "Three URL schemes are supported:\n",
+    "\n",
+    "- `redis://` creates a TCP socket connection. <https://www.iana.org/assignments/uri-schemes/prov/redis>\n",
+    "- `rediss://` creates a SSL wrapped TCP socket connection. <https://www.iana.org/assignments/uri-schemes/prov/rediss>\n",
+    "- ``unix://``: creates a Unix Domain Socket connection.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 7,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "url_connection = redis.from_url(\"rediss://localhost:6666?ssl_cert_reqs=none&decode_responses=True&health_check_interval=2\")\n",
+    "\n",
+    "url_connection.ping()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Connecting to a Sentinel instance"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from redis.sentinel import Sentinel\n",
+    "sentinel = Sentinel([('localhost', 26379)], socket_timeout=0.1)\n",
+    "sentinel.discover_master(\"redis-py-test\")"
+   ]
+  }
+ ],
+ "metadata": {
+  "interpreter": {
+   "hash": "d45c99ba0feda92868abafa8257cbb4709c97f1a0b5dc62bbeebdf89d4fad7fe"
+  },
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.8.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/docs/index.rst b/docs/index.rst
index d088708e50..cbf5115cde 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -71,6 +71,7 @@ Module Documentation
    exceptions
    lock
    retry
+   examples
 
 Contributing
 *************
diff --git a/docs/requirements.txt b/docs/requirements.txt
index 6dc905f6b3..bbb7dc6149 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,3 +1,6 @@
 sphinx<2
 docutils<0.18
 sphinx-rtd-theme
+nbsphinx
+sphinx_gallery
+ipython
diff --git a/tasks.py b/tasks.py
index 0fbb5e8352..313986d427 100644
--- a/tasks.py
+++ b/tasks.py
@@ -29,6 +29,7 @@ def devenv(c):
 @task
 def build_docs(c):
     """Generates the sphinx documentation."""
+    _generate_keys()
     run("tox -e docs")
 
 
diff --git a/tox.ini b/tox.ini
index 0da66ed4f0..3ca4533b55 100644
--- a/tox.ini
+++ b/tox.ini
@@ -131,7 +131,7 @@ skipsdist = true
 skip_install = true
 deps = -r {toxinidir}/dev_requirements.txt
 docker = {[testenv]docker}
-commands = /usr/bin/echo
+commands = /usr/bin/echo docker_up
 run_before = {[testenv]run_before}
 
 [testenv:linters]
@@ -147,7 +147,7 @@ skipsdist = true
 skip_install = true
 
 [testenv:docs]
-deps_files = docs/requirements.txt
+deps = -r docs/requirements.txt
 docker =
 changedir = {toxinidir}/docs
 allowlist_externals = make

From bc3dbb45d7236f96d614c33684a94f3e0fd9ac4a Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 30 Dec 2021 12:52:11 +0200
Subject: [PATCH 0326/1164] Documentation cleanup (#1841)

---
 docs/commands.rst                 |  30 ++++++++
 docs/connections.rst              |  35 ++++++++-
 docs/index.rst                    |   4 +-
 docs/redis_cluster_commands.rst   |   7 --
 docs/redis_commands.rst           |  14 ----
 docs/redismodules.rst             | 115 +++++++++++++++---------------
 docs/sentinel_commands.rst        |  20 ------
 redis/client.py                   |   1 +
 redis/cluster.py                  |   1 +
 redis/commands/graph/commands.py  |   2 -
 redis/commands/search/commands.py |  46 ++++++------
 redis/connection.py               |   5 +-
 redis/sentinel.py                 |   2 +-
 13 files changed, 149 insertions(+), 133 deletions(-)
 create mode 100644 docs/commands.rst
 delete mode 100644 docs/redis_cluster_commands.rst
 delete mode 100644 docs/redis_commands.rst
 delete mode 100644 docs/sentinel_commands.rst

diff --git a/docs/commands.rst b/docs/commands.rst
new file mode 100644
index 0000000000..d35f290ace
--- /dev/null
+++ b/docs/commands.rst
@@ -0,0 +1,30 @@
+Redis Commands
+##############
+
+Core Commands
+*************
+
+The following functions can be used to replicate their equivalent `Redis command <https://redis.io/commands>`_.  Generally they can be used as functions on your redis connection.  For the simplest example, see below:
+
+Getting and settings data in redis::
+
+   import redis
+   r = redis.Redis(decode_responses=True)
+   r.set('mykey', 'thevalueofmykey')
+   r.get('mykey')
+
+.. autoclass:: redis.commands.core.CoreCommands
+   :inherited-members:
+
+Sentinel Commands
+*****************
+.. autoclass:: redis.commands.sentinel.SentinelCommands
+   :inherited-members:
+
+Redis Cluster Commands
+**********************
+
+The following `Redis commands <https://redis.io/commands>`_ are available within a `Redis Cluster <https://redis.io/topics/cluster-tutorial>`_.  Generally they can be used as functions on your redis connection.
+
+.. autoclass:: redis.commands.cluster.RedisClusterCommands
+   :inherited-members:
diff --git a/docs/connections.rst b/docs/connections.rst
index 973821bb07..cf4657b95b 100644
--- a/docs/connections.rst
+++ b/docs/connections.rst
@@ -3,10 +3,41 @@ Connecting to Redis
 
 Generic Client
 **************
-.. autoclass:: redis.client.Redis
+
+This is the client used to connect directly to a standard redis node.
+
+.. autoclass:: redis.Redis
+   :members:
+
+Sentinel Client
+***************
+
+Redis `Sentinel <https://redis.io/topics/sentinel>`_ provides high availability for Redis. There are commands that can only be executed against a redis node running in sentinel mode. Connecting to those nodes, and executing commands against them requires a Sentinel connection.
+
+Connection example (assumes redis redis on the ports listed below):
+
+   >>> from redis import Sentinel
+   >>> sentinel = Sentinel([('localhost', 26379)], socket_timeout=0.1)
+   >>> sentinel.discover_master('mymaster')
+   ('127.0.0.1', 6379)
+   >>> sentinel.discover_slaves('mymaster')
+   [('127.0.0.1', 6380)]
+
+.. autoclass:: redis.sentinel.Sentinel
+    :members:
+
+.. autoclass:: redis.sentinel.SentinelConnectionPool
+    :members:
+
+Cluster Client
+**************
+
+This client is used for connecting to a redis cluser.
+
+.. autoclass:: redis.cluster.RedisCluster
     :members:
 
 Connection Pools
 *****************
 .. autoclass:: redis.connection.ConnectionPool
-    :members:
\ No newline at end of file
+    :members:
diff --git a/docs/index.rst b/docs/index.rst
index cbf5115cde..51b38a2bf7 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -56,9 +56,7 @@ Redis Command Functions
 .. toctree::
    :maxdepth: 2
 
-   redis_commands
-   redis_cluster_commands
-   sentinel_commands
+   commands
    redismodules
 
 Module Documentation
diff --git a/docs/redis_cluster_commands.rst b/docs/redis_cluster_commands.rst
deleted file mode 100644
index de520de905..0000000000
--- a/docs/redis_cluster_commands.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-Redis Cluster Commands
-######################
-
-The following `Redis commands <https://redis.io/commands>`_ are available within a `Redis Cluster <https://redis.io/topics/cluster-tutorial>`_.  Generally they can be used as functions on your redis connection.
-
-.. autoclass:: redis.commands.cluster.RedisClusterCommands
-   :inherited-members:
diff --git a/docs/redis_commands.rst b/docs/redis_commands.rst
deleted file mode 100644
index efb76e79c6..0000000000
--- a/docs/redis_commands.rst
+++ /dev/null
@@ -1,14 +0,0 @@
-Redis Commands
-###############
-
-The following functions can be used to replicate their equivalent `Redis command <https://redis.io/commands>`_.  Generally they can be used as functions on your redis connection.  For the simplest example, see below:
-
-Getting and settings data in redis::
-
-   import redis
-   r = redis.Redis(decode_responses=True)
-   r.set('mykey', 'thevalueofmykey')
-   r.get('mykey')
-
-.. autoclass:: redis.commands.core.CoreCommands
-   :inherited-members:
diff --git a/docs/redismodules.rst b/docs/redismodules.rst
index 53a5008133..f31167555b 100644
--- a/docs/redismodules.rst
+++ b/docs/redismodules.rst
@@ -3,63 +3,49 @@ Redis Modules Commands
 
 Accessing redis module commands requires the installation of the supported `Redis module <https://docs.redis.com/latest/modules/>`_. For a quick start with redis modules, try the `Redismod docker <https://hub.docker.com/r/redislabs/redismod>`_.
 
-RedisTimeSeries Commands
-************************
 
-These are the commands for interacting with the `RedisTimeSeries module <https://redistimeseries.io>`_. Below is a brief example, as well as documentation on the commands themselves.
+RedisBloom Commands
+*******************
 
+These are the commands for interacting with the `RedisBloom module <https://redisbloom.io>`_. Below is a brief example, as well as documentation on the commands themselves.
 
-**Create a timeseries object with 5 second retention**
+**Create and add to a bloom filter**
 
 .. code-block:: python
 
     import redis
-    r = redis.Redis()
-    r.timeseries().create(2, retension_msecs=5)
-
-.. automodule:: redis.commands.timeseries.commands
-    :members: TimeSeriesCommands
-
------
-
-RedisJSON Commands
-******************
-
-These are the commands for interacting with the `RedisJSON module <https://redisjson.io>`_. Below is a brief example, as well as documentation on the commands themselves.
+    filter = redis.bf().create("bloom", 0.01, 1000)
+    filter.add("bloom", "foo")
 
-**Create a json object**
+**Create and add to a cuckoo filter**
 
 .. code-block:: python
 
     import redis
-    r = redis.Redis()
-    r.json().set("mykey", ".", {"hello": "world", "i am": ["a", "json", "object!"]}
-
-
-.. automodule:: redis.commands.json.commands
-    :members: JSONCommands
+    filter = redis.cf().create("cuckoo", 1000)
+    filter.add("cuckoo", "filter")
 
------
+**Create Count-Min Sketch and get information**
 
-RediSearch Commands
-*******************
+.. code-block:: python
 
-These are the commands for interacting with the `RediSearch module <https://redisearch.io>`_. Below is a brief example, as well as documentation on the commands themselves.
+    import redis
+    r = redis.cms().initbydim("dim", 1000, 5)
+    r.cms().incrby("dim", ["foo"], [5])
+    r.cms().info("dim")
 
-**Create a search index, and display its information**
+**Create a topk list, and access the results**
 
 .. code-block:: python
 
     import redis
-    r = redis.Redis()
-    r.ft().create_index(TextField("play", weight=5.0), TextField("ball"))
-    print(r.ft().info())
-
+    r = redis.topk().reserve("mytopk", 3, 50, 4, 0.9)
+    info = r.topk().info("mytopk)
 
-.. automodule:: redis.commands.search.commands
-    :members: SearchCommands
+.. automodule:: redis.commands.bf.commands
+    :members: BFCommands, CFCommands, CMSCommands, TOPKCommands
 
------
+------
 
 RedisGraph Commands
 *******************
@@ -92,45 +78,62 @@ These are the commands for interacting with the `RedisGraph module <https://redi
 .. automodule:: redis.commands.graph.commands
     :members: GraphCommands
 
------
+------
 
-RedisBloom Commands
-*******************
+RedisJSON Commands
+******************
 
-These are the commands for interacting with the `RedisBloom module <https://redisbloom.io>`_. Below is a brief example, as well as documentation on the commands themselves.
+These are the commands for interacting with the `RedisJSON module <https://redisjson.io>`_. Below is a brief example, as well as documentation on the commands themselves.
 
-**Create and add to a bloom filter**
+**Create a json object**
 
 .. code-block:: python
 
     import redis
-    filter = redis.bf().create("bloom", 0.01, 1000)
-    filter.add("bloom", "foo")
+    r = redis.Redis()
+    r.json().set("mykey", ".", {"hello": "world", "i am": ["a", "json", "object!"]}
 
-**Create and add to a cuckoo filter**
 
-.. code-block:: python
+.. automodule:: redis.commands.json.commands
+    :members: JSONCommands
 
-    import redis
-    filter = redis.cf().create("cuckoo", 1000)
-    filter.add("cuckoo", "filter")
+-----
 
-**Create Count-Min Sketch and get information**
+RediSearch Commands
+*******************
+
+These are the commands for interacting with the `RediSearch module <https://redisearch.io>`_. Below is a brief example, as well as documentation on the commands themselves.
+
+**Create a search index, and display its information**
 
 .. code-block:: python
 
     import redis
-    r = redis.cms().initbydim("dim", 1000, 5)
-    r.cms().incrby("dim", ["foo"], [5])
-    r.cms().info("dim")
+    r = redis.Redis()
+    r.ft().create_index(TextField("play", weight=5.0), TextField("ball"))
+    print(r.ft().info())
 
-**Create a topk list, and access the results**
+
+.. automodule:: redis.commands.search.commands
+    :members: SearchCommands
+
+-----
+
+RedisTimeSeries Commands
+************************
+
+These are the commands for interacting with the `RedisTimeSeries module <https://redistimeseries.io>`_. Below is a brief example, as well as documentation on the commands themselves.
+
+
+**Create a timeseries object with 5 second retention**
 
 .. code-block:: python
 
     import redis
-    r = redis.topk().reserve("mytopk", 3, 50, 4, 0.9)
-    info = r.topk().info("mytopk)
+    r = redis.Redis()
+    r.timeseries().create(2, retension_msecs=5)
+
+.. automodule:: redis.commands.timeseries.commands
+    :members: TimeSeriesCommands
+
 
-.. automodule:: redis.commands.bf.commands
-    :members: BFCommands, CFCommands, CMSCommands, TOPKCommands
diff --git a/docs/sentinel_commands.rst b/docs/sentinel_commands.rst
deleted file mode 100644
index e5be11e85a..0000000000
--- a/docs/sentinel_commands.rst
+++ /dev/null
@@ -1,20 +0,0 @@
-Redis Sentinel Commands
-=======================
-
-redis-py can be used together with `Redis
-Sentinel <https://redis.io/topics/sentinel>`_ to discover Redis nodes. You
-need to have at least one Sentinel daemon running in order to use
-redis-py's Sentinel support.
-
-Connection example (assumes redis redis on the ports listed below):
-
-   >>> from redis import Sentinel
-   >>> sentinel = Sentinel([('localhost', 26379)], socket_timeout=0.1)
-   >>> sentinel.discover_master('mymaster')
-   ('127.0.0.1', 6379)
-   >>> sentinel.discover_slaves('mymaster')
-   [('127.0.0.1', 6380)]
-
-
-.. autoclass:: redis.commands.sentinel.SentinelCommands
-   :members:
\ No newline at end of file
diff --git a/redis/client.py b/redis/client.py
index 0984a7c243..490b06d606 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -832,6 +832,7 @@ def from_url(cls, url, **kwargs):
 
         There are several ways to specify a database number. The first value
         found will be used:
+
             1. A ``db`` querystring option, e.g. redis://localhost?db=0
             2. If using the redis:// or rediss:// schemes, the path argument
                of the url, e.g. redis://localhost/0
diff --git a/redis/cluster.py b/redis/cluster.py
index 5707a9da32..ec752741f3 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -564,6 +564,7 @@ def from_url(cls, url, **kwargs):
 
         There are several ways to specify a database number. The first value
         found will be used:
+
             1. A ``db`` querystring option, e.g. redis://localhost?db=0
             2. If using the redis:// or rediss:// schemes, the path argument
                of the url, e.g. redis://localhost/0
diff --git a/redis/commands/graph/commands.py b/redis/commands/graph/commands.py
index e097936503..1db8275223 100644
--- a/redis/commands/graph/commands.py
+++ b/redis/commands/graph/commands.py
@@ -35,7 +35,6 @@ def query(self, q, params=None, timeout=None, read_only=False, profile=False):
 
         Args:
 
-        -------
         q :
             The query.
         params : dict
@@ -127,7 +126,6 @@ def explain(self, query, params=None):
 
         Args:
 
-        -------
         query:
             The query that will be executed.
         params: dict
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 4ec6fc9dfa..d22afeb875 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -73,12 +73,9 @@ def create_index(
         ### Parameters:
 
         - **fields**: a list of TextField or NumericField objects
-        - **no_term_offsets**: If true, we will not save term offsets in
-        the index
-        - **no_field_flags**: If true, we will not save field flags that
-        allow searching in specific fields
-        - **stopwords**: If not None, we create the index with this custom
-        stopword list. The list can be empty
+        - **no_term_offsets**: If true, we will not save term offsets in the index
+        - **no_field_flags**: If true, we will not save field flags that allow searching in specific fields
+        - **stopwords**: If not None, we create the index with this custom stopword list. The list can be empty
 
         For more information: https://oss.redis.com/redisearch/Commands/#ftcreate
         """  # noqa
@@ -132,6 +129,7 @@ def dropindex(self, delete_documents=False):
         ### Parameters:
 
         - **delete_documents**: If `True`, all documents will be deleted.
+
         For more information: https://oss.redis.com/redisearch/Commands/#ftdropindex
         """  # noqa
         keep_str = "" if delete_documents else "KEEPDOCS"
@@ -219,27 +217,23 @@ def add_document(
         ### Parameters
 
         - **doc_id**: the id of the saved document.
-        - **nosave**: if set to true, we just index the document, and don't
-                      save a copy of it. This means that searches will just
-                      return ids.
-        - **score**: the document ranking, between 0.0 and 1.0
-        - **payload**: optional inner-index payload we can save for fast
-        i              access in scoring functions
-        - **replace**: if True, and the document already is in the index,
+        - **nosave**: if set to true, we just index the document, and don't \
+        save a copy of it. This means that searches will just return ids.
+        - **score**: the document ranking, between 0.0 and 1.0.
+        - **payload**: optional inner-index payload we can save for fast access in scoring functions
+        - **replace**: if True, and the document already is in the index, \
         we perform an update and reindex the document
-        - **partial**: if True, the fields specified will be added to the
-                       existing document.
-                       This has the added benefit that any fields specified
-                       with `no_index`
-                       will not be reindexed again. Implies `replace`
+        - **partial**: if True, the fields specified will be added to the \
+        existing document. \
+        This has the added benefit that any fields specified \
+        with `no_index` will not be reindexed again. Implies `replace`
         - **language**: Specify the language used for document tokenization.
-        - **no_create**: if True, the document is only updated and reindexed
-                         if it already exists.
-                         If the document does not exist, an error will be
-                         returned. Implies `replace`
-        - **fields** kwargs dictionary of the document fields to be saved
-                         and/or indexed.
-                     NOTE: Geo points shoule be encoded as strings of "lon,lat"
+        - **no_create**: if True, the document is only updated and reindexed \
+        if it already exists.  If the document does not exist, an error will be \
+        returned. Implies `replace`
+        - **fields** kwargs dictionary of the document fields to be saved and/or indexed.
+
+        NOTE: Geo points shoule be encoded as strings of "lon,lat"
 
         For more information: https://oss.redis.com/redisearch/Commands/#ftadd
         """  # noqa
@@ -487,7 +481,7 @@ def spellcheck(self, query, distance=None, include=None, exclude=None):
 
         **query**: search query.
         **distance***: the maximal Levenshtein distance for spelling
-                       suggestions (default: 1, max: 4).
+        suggestions (default: 1, max: 4).
         **include**: specifies an inclusion custom dictionary.
         **exclude**: specifies an exclusion custom dictionary.
 
diff --git a/redis/connection.py b/redis/connection.py
index bde74b17df..8fdb4bdf8c 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1145,11 +1145,11 @@ def parse_url(url):
 class ConnectionPool:
     """
     Create a connection pool. ``If max_connections`` is set, then this
-    object raises :py:class:`~redis.ConnectionError` when the pool's
+    object raises :py:class:`~redis.exceptions.ConnectionError` when the pool's
     limit is reached.
 
     By default, TCP connections are created unless ``connection_class``
-    is specified. Use :py:class:`~redis.UnixDomainSocketConnection` for
+    is specified. Use class:`.UnixDomainSocketConnection` for
     unix sockets.
 
     Any additional keyword arguments are passed to the constructor of
@@ -1181,6 +1181,7 @@ def from_url(cls, url, **kwargs):
 
         There are several ways to specify a database number. The first value
         found will be used:
+
             1. A ``db`` querystring option, e.g. redis://localhost?db=0
             2. If using the redis:// or rediss:// schemes, the path argument
                of the url, e.g. redis://localhost/0
diff --git a/redis/sentinel.py b/redis/sentinel.py
index c9383d30a9..025ab39c8c 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -190,7 +190,7 @@ def execute_command(self, *args, **kwargs):
         """
         Execute Sentinel command in sentinel nodes.
         once - If set to True, then execute the resulting command on a single
-               node at random, rather than across the entire sentinel cluster.
+        node at random, rather than across the entire sentinel cluster.
         """
         once = bool(kwargs.get("once", False))
         if "once" in kwargs.keys():

From 231d40275e57bfdf8cc3b98642e886fae9433389 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 30 Dec 2021 13:58:46 +0200
Subject: [PATCH 0327/1164] Support for unstable docker (#1842)

---
 CONTRIBUTING.md                 |  3 ++-
 docker/base/Dockerfile.unstable | 18 ++++++++++++++++++
 docker/unstable/redis.conf      |  3 +++
 tox.ini                         | 10 ++++++++++
 4 files changed, 33 insertions(+), 1 deletion(-)
 create mode 100644 docker/base/Dockerfile.unstable
 create mode 100644 docker/unstable/redis.conf

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 0f9ca0b113..ebb66bbf3e 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -57,8 +57,9 @@ can execute docker and its various commands.
 -   A master Redis node
 -   A Redis replica node
 -   Three sentinel Redis nodes
--   A multi-python docker, with your source code mounted in /data
+-   A redis cluster
 -   An stunnel docker, fronting the master Redis node
+-   A Redis node, running unstable - the latest redis
 
 The replica node, is a replica of the master node, using the
 [leader-follower replication](https://redis.io/topics/replication)
diff --git a/docker/base/Dockerfile.unstable b/docker/base/Dockerfile.unstable
new file mode 100644
index 0000000000..ab5b7fc6fb
--- /dev/null
+++ b/docker/base/Dockerfile.unstable
@@ -0,0 +1,18 @@
+# produces redisfab/redis-py:unstable
+FROM ubuntu:bionic as builder
+RUN apt-get update
+RUN apt-get upgrade -y
+RUN apt-get install -y build-essential git
+RUN mkdir /build
+WORKDIR /build
+RUN git clone https://github.com/redis/redis
+WORKDIR /build/redis
+RUN make
+
+FROM ubuntu:bionic as runner
+COPY --from=builder /build/redis/src/redis-server /usr/bin/redis-server
+COPY --from=builder /build/redis/src/redis-cli /usr/bin/redis-cli
+COPY --from=builder /build/redis/src/redis-sentinel /usr/bin/redis-sentinel
+
+EXPOSE 6379
+CMD ["redis-server", "/redis.conf"]
diff --git a/docker/unstable/redis.conf b/docker/unstable/redis.conf
new file mode 100644
index 0000000000..93a55cf3b3
--- /dev/null
+++ b/docker/unstable/redis.conf
@@ -0,0 +1,3 @@
+port 6378
+protected-mode no
+save ""
diff --git a/tox.ini b/tox.ini
index 3ca4533b55..ac7f01a6ca 100644
--- a/tox.ini
+++ b/tox.ini
@@ -32,6 +32,15 @@ healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(sock
 volumes =
     bind:rw:{toxinidir}/docker/replica/redis.conf:/redis.conf
 
+[docker:unstable]
+name = unstable
+image = redisfab/redis-py:unstable-bionic
+ports =
+    6378:6378/tcp
+healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',6378)) else False"
+volumes =
+    bind:rw:{toxinidir}/docker/unstable/redis.conf:/redis.conf
+
 
 [docker:sentinel_1]
 name = sentinel_1
@@ -108,6 +117,7 @@ deps =
     -r {toxinidir}/requirements.txt
     -r {toxinidir}/dev_requirements.txt
 docker =
+    unstable
     master
     replica
     sentinel_1

From 15f315a496c3267c8cbcc6d6d9c6005ea4d4a4d5 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 4 Jan 2022 12:27:37 +0200
Subject: [PATCH 0328/1164] Support test with redis unstable docker (#1850)

---
 tests/conftest.py | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/tests/conftest.py b/tests/conftest.py
index 505a6e47e1..9ba63d6caa 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -15,6 +15,7 @@
 REDIS_INFO = {}
 default_redis_url = "redis://localhost:6379/9"
 default_redismod_url = "redis://localhost:36379"
+default_redis_unstable_url = "redis://localhost:6378"
 
 # default ssl client ignores verification for the purpose of testing
 default_redis_ssl_url = "rediss://localhost:6666"
@@ -54,6 +55,14 @@ def pytest_addoption(parser):
         " defaults to `%(default)s`",
     )
 
+    parser.addoption(
+        "--redis-unstable-url",
+        default=default_redis_unstable_url,
+        action="store",
+        help="Redis unstable (latest version) connection string "
+        "defaults to %(default)s`",
+    )
+
 
 def _get_info(redis_url):
     client = redis.Redis.from_url(redis_url)
@@ -357,6 +366,13 @@ def master_host(request):
     yield parts.hostname, parts.port
 
 
+@pytest.fixture()
+def unstable_r(request):
+    url = request.config.getoption("--redis-unstable-url")
+    with _get_client(redis.Redis, request, from_url=url) as client:
+        yield client
+
+
 def wait_for_command(client, monitor, command, key=None):
     # issue a command with a key name that's local to this process.
     # if we find a command with our key before the command we're waiting

From 1fbc2d10cb94b888883cb3e7908bb9e2a4389806 Mon Sep 17 00:00:00 2001
From: Tony Narlock <tony@git-pull.com>
Date: Mon, 10 Jan 2022 02:18:42 -0600
Subject: [PATCH 0329/1164] `setup.py`: Add project_urls for PyPI (#1867)

---
 setup.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/setup.py b/setup.py
index 7733220838..054b0c023c 100644
--- a/setup.py
+++ b/setup.py
@@ -21,6 +21,12 @@
         ]
     ),
     url="https://github.com/redis/redis-py",
+    project_urls={
+        "Documentation": "https://redis.readthedocs.io/en/latest/",
+        "Changes": "https://github.com/redis/redis-py/releases",
+        "Code": "https://github.com/redis/redis-py",
+        "Issue tracker": "https://github.com/redis/redis-py/issues",
+    },
     author="Redis Inc.",
     author_email="oss@redis.com",
     python_requires=">=3.6",

From cb198730868b05ca804db2d689ebcf208f1d7ba2 Mon Sep 17 00:00:00 2001
From: Avital Fine <79420960+AvitalFineRedis@users.noreply.github.com>
Date: Mon, 10 Jan 2022 09:18:55 +0100
Subject: [PATCH 0330/1164] FT.CREATE - support MAXTEXTFIELDS, TEMPORARY, NOHL,
 NOFREQS, SKIPINITIALSCAN (#1847)

Co-authored-by: Chayim I. Kirshen <c@kirshen.com>
---
 redis/commands/search/commands.py | 78 +++++++++++++++++++++++--------
 tests/test_search.py              | 66 ++++++++++++++++++++++++++
 2 files changed, 124 insertions(+), 20 deletions(-)

diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index d22afeb875..3f768ab320 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -44,7 +44,12 @@
 
 NOOFFSETS = "NOOFFSETS"
 NOFIELDS = "NOFIELDS"
+NOHL = "NOHL"
+NOFREQS = "NOFREQS"
+MAXTEXTFIELDS = "MAXTEXTFIELDS"
+TEMPORARY = "TEMPORARY"
 STOPWORDS = "STOPWORDS"
+SKIPINITIALSCAN = "SKIPINITIALSCAN"
 WITHSCORES = "WITHSCORES"
 FUZZY = "FUZZY"
 WITHPAYLOADS = "WITHPAYLOADS"
@@ -66,6 +71,11 @@ def create_index(
         no_field_flags=False,
         stopwords=None,
         definition=None,
+        max_text_fields=False,
+        temporary=None,
+        no_highlight=False,
+        no_term_frequencies=False,
+        skip_initial_scan=False,
     ):
         """
         Create the search index. The index must not already exist.
@@ -73,9 +83,23 @@ def create_index(
         ### Parameters:
 
         - **fields**: a list of TextField or NumericField objects
-        - **no_term_offsets**: If true, we will not save term offsets in the index
-        - **no_field_flags**: If true, we will not save field flags that allow searching in specific fields
-        - **stopwords**: If not None, we create the index with this custom stopword list. The list can be empty
+        - **no_term_offsets**: If true, we will not save term offsets in
+        the index
+        - **no_field_flags**: If true, we will not save field flags that
+        allow searching in specific fields
+        - **stopwords**: If not None, we create the index with this custom
+        stopword list. The list can be empty
+        - **max_text_fields**: If true, we will encode indexes as if there
+        were more than 32 text fields which allows you to add additional
+        fields (beyond 32).
+        - **temporary**: Create a lightweight temporary index which will
+        expire after the specified period of inactivity (in seconds). The
+        internal idle timer is reset whenever the index is searched or added to.
+        - **no_highlight**: If true, disabling highlighting support.
+        Also implied by no_term_offsets.
+        - **no_term_frequencies**: If true, we avoid saving the term frequencies
+        in the index.
+        - **skip_initial_scan**: If true, we do not scan and index.
 
         For more information: https://oss.redis.com/redisearch/Commands/#ftcreate
         """  # noqa
@@ -83,10 +107,21 @@ def create_index(
         args = [CREATE_CMD, self.index_name]
         if definition is not None:
             args += definition.args
+        if max_text_fields:
+            args.append(MAXTEXTFIELDS)
+        if temporary is not None and isinstance(temporary, int):
+            args.append(TEMPORARY)
+            args.append(temporary)
         if no_term_offsets:
             args.append(NOOFFSETS)
+        if no_highlight:
+            args.append(NOHL)
         if no_field_flags:
             args.append(NOFIELDS)
+        if no_term_frequencies:
+            args.append(NOFREQS)
+        if skip_initial_scan:
+            args.append(SKIPINITIALSCAN)
         if stopwords is not None and isinstance(stopwords, (list, tuple, set)):
             args += [STOPWORDS, len(stopwords)]
             if len(stopwords) > 0:
@@ -129,7 +164,6 @@ def dropindex(self, delete_documents=False):
         ### Parameters:
 
         - **delete_documents**: If `True`, all documents will be deleted.
-
         For more information: https://oss.redis.com/redisearch/Commands/#ftdropindex
         """  # noqa
         keep_str = "" if delete_documents else "KEEPDOCS"
@@ -217,23 +251,27 @@ def add_document(
         ### Parameters
 
         - **doc_id**: the id of the saved document.
-        - **nosave**: if set to true, we just index the document, and don't \
-        save a copy of it. This means that searches will just return ids.
-        - **score**: the document ranking, between 0.0 and 1.0.
-        - **payload**: optional inner-index payload we can save for fast access in scoring functions
-        - **replace**: if True, and the document already is in the index, \
+        - **nosave**: if set to true, we just index the document, and don't
+                      save a copy of it. This means that searches will just
+                      return ids.
+        - **score**: the document ranking, between 0.0 and 1.0
+        - **payload**: optional inner-index payload we can save for fast
+        i              access in scoring functions
+        - **replace**: if True, and the document already is in the index,
         we perform an update and reindex the document
-        - **partial**: if True, the fields specified will be added to the \
-        existing document. \
-        This has the added benefit that any fields specified \
-        with `no_index` will not be reindexed again. Implies `replace`
+        - **partial**: if True, the fields specified will be added to the
+                       existing document.
+                       This has the added benefit that any fields specified
+                       with `no_index`
+                       will not be reindexed again. Implies `replace`
         - **language**: Specify the language used for document tokenization.
-        - **no_create**: if True, the document is only updated and reindexed \
-        if it already exists.  If the document does not exist, an error will be \
-        returned. Implies `replace`
-        - **fields** kwargs dictionary of the document fields to be saved and/or indexed.
-
-        NOTE: Geo points shoule be encoded as strings of "lon,lat"
+        - **no_create**: if True, the document is only updated and reindexed
+                         if it already exists.
+                         If the document does not exist, an error will be
+                         returned. Implies `replace`
+        - **fields** kwargs dictionary of the document fields to be saved
+                         and/or indexed.
+                     NOTE: Geo points shoule be encoded as strings of "lon,lat"
 
         For more information: https://oss.redis.com/redisearch/Commands/#ftadd
         """  # noqa
@@ -481,7 +519,7 @@ def spellcheck(self, query, distance=None, include=None, exclude=None):
 
         **query**: search query.
         **distance***: the maximal Levenshtein distance for spelling
-        suggestions (default: 1, max: 4).
+                       suggestions (default: 1, max: 4).
         **include**: specifies an inclusion custom dictionary.
         **exclude**: specifies an exclusion custom dictionary.
 
diff --git a/tests/test_search.py b/tests/test_search.py
index 7d666cbd96..6c79041cfe 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1154,6 +1154,72 @@ def test_index_definition(client):
     createIndex(client.ft(), num_docs=500, definition=definition)
 
 
+@pytest.mark.redismod
+def testExpire(client):
+    client.ft().create_index((TextField("txt", sortable=True),), temporary=4)
+    ttl = client.execute_command("ft.debug", "TTL", "idx")
+    assert ttl > 2
+
+    while ttl > 2:
+        ttl = client.execute_command("ft.debug", "TTL", "idx")
+        time.sleep(0.01)
+
+    # add document - should reset the ttl
+    client.ft().add_document("doc", txt="foo bar", text="this is a simple test")
+    ttl = client.execute_command("ft.debug", "TTL", "idx")
+    assert ttl > 2
+    try:
+        while True:
+            ttl = client.execute_command("ft.debug", "TTL", "idx")
+            time.sleep(0.5)
+    except redis.exceptions.ResponseError:
+        assert ttl == 0
+
+
+@pytest.mark.redismod
+def testSkipInitialScan(client):
+    client.hset("doc1", "foo", "bar")
+    q = Query("@foo:bar")
+
+    client.ft().create_index((TextField("foo"),), skip_initial_scan=True)
+    assert 0 == client.ft().search(q).total
+
+
+@pytest.mark.redismod
+def testSummarizeDisabled_nooffset(client):
+    client.ft().create_index((TextField("txt"),), no_term_offsets=True)
+    client.ft().add_document("doc1", txt="foo bar")
+    with pytest.raises(Exception):
+        client.ft().search(Query("foo").summarize(fields=["txt"]))
+
+
+@pytest.mark.redismod
+def testSummarizeDisabled_nohl(client):
+    client.ft().create_index((TextField("txt"),), no_highlight=True)
+    client.ft().add_document("doc1", txt="foo bar")
+    with pytest.raises(Exception):
+        client.ft().search(Query("foo").summarize(fields=["txt"]))
+
+
+@pytest.mark.redismod
+def testMaxTextFields(client):
+    # Creating the index definition
+    client.ft().create_index((TextField("f0"),))
+    for x in range(1, 32):
+        client.ft().alter_schema_add((TextField(f"f{x}"),))
+
+    # Should be too many indexes
+    with pytest.raises(redis.ResponseError):
+        client.ft().alter_schema_add((TextField(f"f{x}"),))
+
+    client.ft().dropindex("idx")
+    # Creating the index definition
+    client.ft().create_index((TextField("f0"),), max_text_fields=True)
+    # Fill the index with fields
+    for x in range(1, 50):
+        client.ft().alter_schema_add((TextField(f"f{x}"),))
+
+
 @pytest.mark.redismod
 @skip_ifmodversion_lt("2.0.0", "search")
 def test_create_client_definition(client):

From 1fc1233ffd9e925ecfb7d9ad83a9641a03508985 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=B8ren=20Bjerregaard=20Vrist?= <sbv@csis.dk>
Date: Mon, 10 Jan 2022 09:21:34 +0100
Subject: [PATCH 0331/1164] Allowing poetry and redis-py to install together
 (#1854)

This moves packaging to >=20.4 rather than the latest.
---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 054b0c023c..559e521982 100644
--- a/setup.py
+++ b/setup.py
@@ -32,7 +32,7 @@
     python_requires=">=3.6",
     install_requires=[
         "deprecated>=1.2.3",
-        "packaging>=21.3",
+        "packaging>=20.4",
         'importlib-metadata >= 1.0; python_version < "3.8"',
     ],
     classifiers=[

From a5b4dcbb414bdc51ad50439bf82ec39055084a09 Mon Sep 17 00:00:00 2001
From: Andrew Chen Wang <60190294+Andrew-Chen-Wang@users.noreply.github.com>
Date: Mon, 10 Jan 2022 03:22:37 -0500
Subject: [PATCH 0332/1164] Typo and typing in GraphCommands documentation
 (#1855)

---
 redis/commands/graph/commands.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/redis/commands/graph/commands.py b/redis/commands/graph/commands.py
index 1db8275223..fa0a9da55f 100644
--- a/redis/commands/graph/commands.py
+++ b/redis/commands/graph/commands.py
@@ -35,7 +35,7 @@ def query(self, q, params=None, timeout=None, read_only=False, profile=False):
 
         Args:
 
-        q :
+        q : str
             The query.
         params : dict
             Query parameters.
@@ -178,7 +178,7 @@ def config(self, name, value=None, set=False):
         name : str
             The name of the configuration
         value :
-            The value we want to ser (can be used only when `set` is on)
+            The value we want to set (can be used only when `set` is on)
         set : bool
             Turn on to set a configuration. Default behavior is get.
         """

From 80f1d2f3f056f5e4e81796158dd29b0799f54dc7 Mon Sep 17 00:00:00 2001
From: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Date: Mon, 10 Jan 2022 13:03:48 +0200
Subject: [PATCH 0333/1164] Clusters should optionally require full slot
 coverage (#1845)

---
 redis/cluster.py      | 75 ++++++-------------------------------
 tests/test_cluster.py | 86 ++++++++++++++++---------------------------
 2 files changed, 44 insertions(+), 117 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index ec752741f3..546472357d 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -387,8 +387,7 @@ def __init__(
         port=6379,
         startup_nodes=None,
         cluster_error_retry_attempts=3,
-        require_full_coverage=True,
-        skip_full_coverage_check=False,
+        require_full_coverage=False,
         reinitialize_steps=10,
         read_from_replicas=False,
         url=None,
@@ -404,16 +403,15 @@ def __init__(
          :port: 'int'
              Can be used to point to a startup node
          :require_full_coverage: 'bool'
-             If set to True, as it is by default, all slots must be covered.
-             If set to False and not all slots are covered, the instance
-             creation will succeed only if 'cluster-require-full-coverage'
-             configuration is set to 'no' in all of the cluster's nodes.
-             Otherwise, RedisClusterException will be thrown.
-         :skip_full_coverage_check: 'bool'
-             If require_full_coverage is set to False, a check of
-             cluster-require-full-coverage config will be executed against all
-             nodes. Set skip_full_coverage_check to True to skip this check.
-             Useful for clusters without the CONFIG command (like ElastiCache)
+            When set to False (default value): the client will not require a
+            full coverage of the slots. However, if not all slots are covered,
+            and at least one node has 'cluster-require-full-coverage' set to
+            'yes,' the server will throw a ClusterDownError for some key-based
+            commands. See -
+            https://redis.io/topics/cluster-tutorial#redis-cluster-configuration-parameters
+            When set to True: all slots must be covered to construct the
+            cluster client. If not all slots are covered, RedisClusterException
+            will be thrown.
         :read_from_replicas: 'bool'
              Enable read from replicas in READONLY mode. You can read possibly
              stale data.
@@ -510,7 +508,6 @@ def __init__(
             startup_nodes=startup_nodes,
             from_url=from_url,
             require_full_coverage=require_full_coverage,
-            skip_full_coverage_check=skip_full_coverage_check,
             **kwargs,
         )
 
@@ -1111,8 +1108,7 @@ def __init__(
         self,
         startup_nodes,
         from_url=False,
-        require_full_coverage=True,
-        skip_full_coverage_check=False,
+        require_full_coverage=False,
         lock=None,
         **kwargs,
     ):
@@ -1123,7 +1119,6 @@ def __init__(
         self.populate_startup_nodes(startup_nodes)
         self.from_url = from_url
         self._require_full_coverage = require_full_coverage
-        self._skip_full_coverage_check = skip_full_coverage_check
         self._moved_exception = None
         self.connection_kwargs = kwargs
         self.read_load_balancer = LoadBalancer()
@@ -1249,32 +1244,6 @@ def populate_startup_nodes(self, nodes):
         for n in nodes:
             self.startup_nodes[n.name] = n
 
-    def cluster_require_full_coverage(self, cluster_nodes):
-        """
-        if exists 'cluster-require-full-coverage no' config on redis servers,
-        then even all slots are not covered, cluster still will be able to
-        respond
-        """
-
-        def node_require_full_coverage(node):
-            try:
-                return (
-                    "yes"
-                    in node.redis_connection.config_get(
-                        "cluster-require-full-coverage"
-                    ).values()
-                )
-            except ConnectionError:
-                return False
-            except Exception as e:
-                raise RedisClusterException(
-                    'ERROR sending "config get cluster-require-full-coverage"'
-                    f" command to redis server: {node.name}, {e}"
-                )
-
-        # at least one node should have cluster-require-full-coverage yes
-        return any(node_require_full_coverage(node) for node in cluster_nodes.values())
-
     def check_slots_coverage(self, slots_cache):
         # Validate if all slots are covered or if we should try next
         # startup node
@@ -1450,29 +1419,9 @@ def initialize(self):
             # isn't a full coverage
             raise RedisClusterException(
                 f"All slots are not covered after query all startup_nodes. "
-                f"{len(self.slots_cache)} of {REDIS_CLUSTER_HASH_SLOTS} "
+                f"{len(tmp_slots)} of {REDIS_CLUSTER_HASH_SLOTS} "
                 f"covered..."
             )
-        elif not fully_covered and not self._require_full_coverage:
-            # The user set require_full_coverage to False.
-            # In case of full coverage requirement in the cluster's Redis
-            # configurations, we will raise an exception. Otherwise, we may
-            # continue with partial coverage.
-            # see Redis Cluster configuration parameters in
-            # https://redis.io/topics/cluster-tutorial
-            if (
-                not self._skip_full_coverage_check
-                and self.cluster_require_full_coverage(tmp_nodes_cache)
-            ):
-                raise RedisClusterException(
-                    "Not all slots are covered but the cluster's "
-                    "configuration requires full coverage. Set "
-                    "cluster-require-full-coverage configuration to no on "
-                    "all of the cluster nodes if you wish the cluster to "
-                    "be able to serve without being fully covered."
-                    f"{len(self.slots_cache)} of {REDIS_CLUSTER_HASH_SLOTS} "
-                    f"covered..."
-                )
 
         # Set the tmp variables to the real variables
         self.nodes_cache = tmp_nodes_cache
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 496ed9818b..90f52d4899 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -28,6 +28,7 @@
     NoPermissionError,
     RedisClusterException,
     RedisError,
+    ResponseError,
 )
 from redis.utils import str_if_bytes
 from tests.test_pubsub import wait_for_message
@@ -628,6 +629,32 @@ def test_get_node_from_key(self, r):
             assert replica.server_type == REPLICA
             assert replica in slot_nodes
 
+    def test_not_require_full_coverage_cluster_down_error(self, r):
+        """
+        When require_full_coverage is set to False (default client config) and not
+        all slots are covered, if one of the nodes has 'cluster-require_full_coverage'
+        config set to 'yes' some key-based commands should throw ClusterDownError
+        """
+        node = r.get_node_from_key("foo")
+        missing_slot = r.keyslot("foo")
+        assert r.set("foo", "bar") is True
+        try:
+            assert all(r.cluster_delslots(missing_slot))
+            with pytest.raises(ClusterDownError):
+                r.exists("foo")
+        finally:
+            try:
+                # Add back the missing slot
+                assert r.cluster_addslots(node, missing_slot) is True
+                # Make sure we are not getting ClusterDownError anymore
+                assert r.exists("foo") == 1
+            except ResponseError as e:
+                if f"Slot {missing_slot} is already busy" in str(e):
+                    # It can happen if the test failed to delete this slot
+                    pass
+                else:
+                    raise e
+
 
 @pytest.mark.onlycluster
 class TestClusterRedisCommands:
@@ -1848,40 +1875,20 @@ def test_init_slots_cache_not_all_slots_covered(self):
             [10923, 16383, ["127.0.0.1", 7002], ["127.0.0.1", 7005]],
         ]
         with pytest.raises(RedisClusterException) as ex:
-            get_mocked_redis_client(
-                host=default_host, port=default_port, cluster_slots=cluster_slots
-            )
-        assert str(ex.value).startswith(
-            "All slots are not covered after query all startup_nodes."
-        )
-
-    def test_init_slots_cache_not_require_full_coverage_error(self):
-        """
-        When require_full_coverage is set to False and not all slots are
-        covered, if one of the nodes has 'cluster-require_full_coverage'
-        config set to 'yes' the cluster initialization should fail
-        """
-        # Missing slot 5460
-        cluster_slots = [
-            [0, 5459, ["127.0.0.1", 7000], ["127.0.0.1", 7003]],
-            [5461, 10922, ["127.0.0.1", 7001], ["127.0.0.1", 7004]],
-            [10923, 16383, ["127.0.0.1", 7002], ["127.0.0.1", 7005]],
-        ]
-
-        with pytest.raises(RedisClusterException):
             get_mocked_redis_client(
                 host=default_host,
                 port=default_port,
                 cluster_slots=cluster_slots,
-                require_full_coverage=False,
-                coverage_result="yes",
+                require_full_coverage=True,
             )
+        assert str(ex.value).startswith(
+            "All slots are not covered after query all startup_nodes."
+        )
 
     def test_init_slots_cache_not_require_full_coverage_success(self):
         """
         When require_full_coverage is set to False and not all slots are
-        covered, if all of the nodes has 'cluster-require_full_coverage'
-        config set to 'no' the cluster initialization should succeed
+        covered the cluster client initialization should succeed
         """
         # Missing slot 5460
         cluster_slots = [
@@ -1895,39 +1902,10 @@ def test_init_slots_cache_not_require_full_coverage_success(self):
             port=default_port,
             cluster_slots=cluster_slots,
             require_full_coverage=False,
-            coverage_result="no",
         )
 
         assert 5460 not in rc.nodes_manager.slots_cache
 
-    def test_init_slots_cache_not_require_full_coverage_skips_check(self):
-        """
-        Test that when require_full_coverage is set to False and
-        skip_full_coverage_check is set to true, the cluster initialization
-        succeed without checking the nodes' Redis configurations
-        """
-        # Missing slot 5460
-        cluster_slots = [
-            [0, 5459, ["127.0.0.1", 7000], ["127.0.0.1", 7003]],
-            [5461, 10922, ["127.0.0.1", 7001], ["127.0.0.1", 7004]],
-            [10923, 16383, ["127.0.0.1", 7002], ["127.0.0.1", 7005]],
-        ]
-
-        with patch.object(
-            NodesManager, "cluster_require_full_coverage"
-        ) as conf_check_mock:
-            rc = get_mocked_redis_client(
-                host=default_host,
-                port=default_port,
-                cluster_slots=cluster_slots,
-                require_full_coverage=False,
-                skip_full_coverage_check=True,
-                coverage_result="no",
-            )
-
-            assert conf_check_mock.called is False
-            assert 5460 not in rc.nodes_manager.slots_cache
-
     def test_init_slots_cache(self):
         """
         Test that slots cache can in initialized and all slots are covered

From 39ce6852f56021ac9f80359f3a1e387593cfbbbb Mon Sep 17 00:00:00 2001
From: Andrew Chen Wang <60190294+Andrew-Chen-Wang@users.noreply.github.com>
Date: Mon, 10 Jan 2022 06:19:40 -0500
Subject: [PATCH 0334/1164] Set keys var otherwise variable not created (#1853)

---
 redis/commands/parser.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/redis/commands/parser.py b/redis/commands/parser.py
index dadf3c6bf8..4cce800ec3 100644
--- a/redis/commands/parser.py
+++ b/redis/commands/parser.py
@@ -103,6 +103,7 @@ def _get_pubsub_keys(self, *args):
             return None
         args = [str_if_bytes(arg) for arg in args]
         command = args[0].upper()
+        keys = None
         if command == "PUBSUB":
             # the second argument is a part of the command name, e.g.
             # ['PUBSUB', 'NUMSUB', 'foo'].
@@ -117,6 +118,4 @@ def _get_pubsub_keys(self, *args):
             # format example:
             # PUBLISH channel message
             keys = [args[1]]
-        else:
-            keys = None
         return keys

From 9a8674a94740cd299e5c852fd3d9b9841995b1a5 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Mon, 10 Jan 2022 13:19:57 +0200
Subject: [PATCH 0335/1164] syncing requirements (#1870)

---
 requirements.txt | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index f1e7e7ecdc..b05ff454bf 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,2 +1,2 @@
-deprecated
-packaging
+deprecated>=1.2.3
+packaging>=20.4

From 41cef4703a9e23af72040966a9411ee55d92d917 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?I=C3=B1aki=20Ucar?= <iucar@fedoraproject.org>
Date: Mon, 10 Jan 2022 12:20:20 +0100
Subject: [PATCH 0336/1164] get_connection: catch OSError too (#1832)

---
 redis/connection.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/connection.py b/redis/connection.py
index 8fdb4bdf8c..4178f67c57 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1317,7 +1317,7 @@ def get_connection(self, command_name, *keys, **options):
             try:
                 if connection.can_read():
                     raise ConnectionError("Connection has data")
-            except ConnectionError:
+            except (ConnectionError, OSError):
                 connection.disconnect()
                 connection.connect()
                 if connection.can_read():

From f807f3ba1bb25138696e42f75ac59036e323a687 Mon Sep 17 00:00:00 2001
From: Andrew Chen Wang <60190294+Andrew-Chen-Wang@users.noreply.github.com>
Date: Wed, 12 Jan 2022 02:04:55 -0500
Subject: [PATCH 0337/1164] Triple quote docstrings in client.py PEP 257
 (#1876)

---
 redis/client.py | 41 +++++++++++++++++++----------------------
 1 file changed, 19 insertions(+), 22 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 490b06d606..2832d2c103 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -94,14 +94,14 @@ def parse_debug_object(response):
 
 
 def parse_object(response, infotype):
-    "Parse the results of an OBJECT command"
+    """Parse the results of an OBJECT command"""
     if infotype in ("idletime", "refcount"):
         return int_or_none(response)
     return response
 
 
 def parse_info(response):
-    "Parse the result of Redis's INFO command into a Python dict"
+    """Parse the result of Redis's INFO command into a Python dict"""
     info = {}
     response = str_if_bytes(response)
 
@@ -145,7 +145,7 @@ def get_value(value):
 
 
 def parse_memory_stats(response, **kwargs):
-    "Parse the results of MEMORY STATS"
+    """Parse the results of MEMORY STATS"""
     stats = pairs_to_dict(response, decode_keys=True, decode_string_values=True)
     for key, value in stats.items():
         if key.startswith("db."):
@@ -219,7 +219,7 @@ def parse_sentinel_get_master(response):
 
 
 def pairs_to_dict(response, decode_keys=False, decode_string_values=False):
-    "Create a dict given a list of key/value pairs"
+    """Create a dict given a list of key/value pairs"""
     if response is None:
         return {}
     if decode_keys or decode_string_values:
@@ -973,19 +973,15 @@ def __repr__(self):
         return f"{type(self).__name__}<{repr(self.connection_pool)}>"
 
     def get_encoder(self):
-        """
-        Get the connection pool's encoder
-        """
+        """Get the connection pool's encoder"""
         return self.connection_pool.get_encoder()
 
     def get_connection_kwargs(self):
-        """
-        Get the connection's key-word arguments
-        """
+        """Get the connection's key-word arguments"""
         return self.connection_pool.connection_kwargs
 
     def set_response_callback(self, command, callback):
-        "Set a custom Response Callback"
+        """Set a custom Response Callback"""
         self.response_callbacks[command] = callback
 
     def load_external_module(
@@ -1165,7 +1161,7 @@ def _disconnect_raise(self, conn, error):
 
     # COMMAND EXECUTION AND PROTOCOL PARSING
     def execute_command(self, *args, **options):
-        "Execute a command and return a parsed response"
+        """Execute a command and return a parsed response"""
         pool = self.connection_pool
         command_name = args[0]
         conn = self.connection or pool.get_connection(command_name, **options)
@@ -1182,7 +1178,7 @@ def execute_command(self, *args, **options):
                 pool.release(conn)
 
     def parse_response(self, connection, command_name, **options):
-        "Parses a response from the Redis server"
+        """Parses a response from the Redis server"""
         try:
             if NEVER_DECODE in options:
                 response = connection.read_response(disable_decoding=True)
@@ -1227,7 +1223,7 @@ def __exit__(self, *args):
         self.connection_pool.release(self.connection)
 
     def next_command(self):
-        "Parse the response from a monitor command"
+        """Parse the response from a monitor command"""
         response = self.connection.read_response()
         if isinstance(response, bytes):
             response = self.connection.encoder.decode(response, force=True)
@@ -1262,7 +1258,7 @@ def next_command(self):
         }
 
     def listen(self):
-        "Listen for commands coming to the server."
+        """Listen for commands coming to the server."""
         while True:
             yield self.next_command()
 
@@ -1355,11 +1351,11 @@ def on_connect(self, connection):
 
     @property
     def subscribed(self):
-        "Indicates if there are subscriptions to any channels or patterns"
+        """Indicates if there are subscriptions to any channels or patterns"""
         return self.subscribed_event.is_set()
 
     def execute_command(self, *args):
-        "Execute a publish/subscribe command"
+        """Execute a publish/subscribe command"""
 
         # NOTE: don't parse the response in this function -- it could pull a
         # legitimate message off the stack if the connection is already
@@ -1751,7 +1747,7 @@ def __len__(self):
         return len(self.command_stack)
 
     def __bool__(self):
-        "Pipeline instances should always evaluate to True"
+        """Pipeline instances should always evaluate to True"""
         return True
 
     def reset(self):
@@ -1992,7 +1988,7 @@ def _disconnect_raise_reset(self, conn, error):
             raise
 
     def execute(self, raise_on_error=True):
-        "Execute all the commands in the current pipeline"
+        """Execute all the commands in the current pipeline"""
         stack = self.command_stack
         if not stack and not self.watching:
             return []
@@ -2019,17 +2015,18 @@ def execute(self, raise_on_error=True):
             self.reset()
 
     def discard(self):
-        """Flushes all previously queued commands
+        """
+        Flushes all previously queued commands
         See: https://redis.io/commands/DISCARD
         """
         self.execute_command("DISCARD")
 
     def watch(self, *names):
-        "Watches the values at keys ``names``"
+        """Watches the values at keys ``names``"""
         if self.explicit_transaction:
             raise RedisError("Cannot issue a WATCH after a MULTI")
         return self.execute_command("WATCH", *names)
 
     def unwatch(self):
-        "Unwatches all previously specified keys"
+        """Unwatches all previously specified keys"""
         return self.watching and self.execute_command("UNWATCH") or True

From 0affa0ed3f3cbcb6dec29b34a580f769f69ae9f7 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 12 Jan 2022 09:11:29 +0200
Subject: [PATCH 0338/1164] Timeseries docs fix (#1877)

---
 docs/redismodules.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/redismodules.rst b/docs/redismodules.rst
index f31167555b..24be4da5b4 100644
--- a/docs/redismodules.rst
+++ b/docs/redismodules.rst
@@ -131,7 +131,7 @@ These are the commands for interacting with the `RedisTimeSeries module <https:/
 
     import redis
     r = redis.Redis()
-    r.timeseries().create(2, retension_msecs=5)
+    r.ts().create(2, retension_msecs=5)
 
 .. automodule:: redis.commands.timeseries.commands
     :members: TimeSeriesCommands

From d846f52cb581a20af731138ccaf14745464e7356 Mon Sep 17 00:00:00 2001
From: Ori Avtalion <ori@avtalion.name>
Date: Sun, 16 Jan 2022 17:49:24 +0200
Subject: [PATCH 0339/1164] Define incr/decr as aliases of incrby/decrby
 (#1874)

---
 redis/commands/core.py | 26 ++++----------------------
 1 file changed, 4 insertions(+), 22 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 4f0accd957..73003e7fb6 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1159,17 +1159,6 @@ def copy(self, source, destination, destination_db=None, replace=False):
             params.append("REPLACE")
         return self.execute_command("COPY", *params)
 
-    def decr(self, name, amount=1):
-        """
-        Decrements the value of ``key`` by ``amount``.  If no key exists,
-        the value will be initialized as 0 - ``amount``
-
-        For more information check https://redis.io/commands/decr
-        """
-        # An alias for ``decr()``, because it is already implemented
-        # as DECRBY redis command.
-        return self.decrby(name, amount)
-
     def decrby(self, name, amount=1):
         """
         Decrements the value of ``key`` by ``amount``.  If no key exists,
@@ -1179,6 +1168,8 @@ def decrby(self, name, amount=1):
         """
         return self.execute_command("DECRBY", name, amount)
 
+    decr = decrby
+
     def delete(self, *names):
         """
         Delete one or more keys specified by ``names``
@@ -1350,15 +1341,6 @@ def getset(self, name, value):
         """
         return self.execute_command("GETSET", name, value)
 
-    def incr(self, name, amount=1):
-        """
-        Increments the value of ``key`` by ``amount``.  If no key exists,
-        the value will be initialized as ``amount``
-
-        For more information check https://redis.io/commands/incr
-        """
-        return self.incrby(name, amount)
-
     def incrby(self, name, amount=1):
         """
         Increments the value of ``key`` by ``amount``.  If no key exists,
@@ -1366,10 +1348,10 @@ def incrby(self, name, amount=1):
 
         For more information check https://redis.io/commands/incrby
         """
-        # An alias for ``incr()``, because it is already implemented
-        # as INCRBY redis command.
         return self.execute_command("INCRBY", name, amount)
 
+    incr = incrby
+
     def incrbyfloat(self, name, amount=1.0):
         """
         Increments the value at key ``name`` by floating ``amount``.

From d1291660908f656447bb9132c92813489342ead4 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Mon, 17 Jan 2022 09:13:35 +0200
Subject: [PATCH 0340/1164] More parallel CI workflows (#1881)

---
 .github/workflows/integration.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index e81cf339fd..92f48a49e9 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -31,7 +31,7 @@ jobs:
    run-tests:
      runs-on: ubuntu-latest
      strategy:
-       max-parallel: 6
+       max-parallel: 15
        matrix:
          python-version: ['3.6', '3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
          test-type: ['standalone', 'cluster']

From f0c0ab24e8b1a98fcc1e6bc7cc5c6ecfcd75da85 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Mon, 17 Jan 2022 09:14:16 +0200
Subject: [PATCH 0341/1164] OCSP Stapling Support (#1873)

---
 .github/workflows/integration.yaml            |   1 +
 docs/examples.rst                             |   3 +-
 ...xample.ipynb => connection_examples.ipynb} |  93 +-----
 docs/examples/ssl_connecton_examples.ipynb    | 277 ++++++++++++++++++
 redis/client.py                               |   6 +
 redis/connection.py                           |  48 ++-
 redis/ocsp.py                                 | 174 ++++++++++-
 setup.py                                      |   2 +-
 tasks.py                                      |   2 +-
 tests/test_ssl.py                             |  72 ++++-
 tox.ini                                       |   4 +-
 11 files changed, 571 insertions(+), 111 deletions(-)
 rename docs/examples/{connection_example.ipynb => connection_examples.ipynb} (63%)
 create mode 100644 docs/examples/ssl_connecton_examples.ipynb

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 92f48a49e9..b034428bcd 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -30,6 +30,7 @@ jobs:
 
    run-tests:
      runs-on: ubuntu-latest
+     timeout-minutes: 30
      strategy:
        max-parallel: 15
        matrix:
diff --git a/docs/examples.rst b/docs/examples.rst
index 1a82182869..7a328afd82 100644
--- a/docs/examples.rst
+++ b/docs/examples.rst
@@ -5,4 +5,5 @@ Examples
    :maxdepth: 3
    :glob:
 
-   examples/connection_example
+   examples/connection_examples
+   examples/ssl_connection_examples
diff --git a/docs/examples/connection_example.ipynb b/docs/examples/connection_examples.ipynb
similarity index 63%
rename from docs/examples/connection_example.ipynb
rename to docs/examples/connection_examples.ipynb
index af5193e0d7..b0084ff055 100644
--- a/docs/examples/connection_example.ipynb
+++ b/docs/examples/connection_examples.ipynb
@@ -7,15 +7,6 @@
     "# Connection Examples"
    ]
   },
-  {
-   "cell_type": "code",
-   "execution_count": 1,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "import redis"
-   ]
-  },
   {
    "cell_type": "markdown",
    "metadata": {},
@@ -40,6 +31,8 @@
     }
    ],
    "source": [
+    "import redis\n",
+    "\n",
     "connection = redis.Redis()\n",
     "connection.ping()"
    ]
@@ -68,8 +61,10 @@
     }
    ],
    "source": [
-    "decode_connection = redis.Redis(decode_responses=True)\n",
-    "connection.ping()"
+    "import redis\n",
+    "\n",
+    "decoded_connection = redis.Redis(decode_responses=True)\n",
+    "decoded_connection.ping()"
    ]
   },
   {
@@ -96,82 +91,12 @@
     }
    ],
    "source": [
+    "import redis\n",
+    "\n",
     "user_connection = redis.Redis(host='localhost', port=6380, username='dvora', password='redis', decode_responses=True)\n",
     "user_connection.ping()"
    ]
   },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "## Connecting to a Redis instance via SSL."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 5,
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/plain": [
-       "True"
-      ]
-     },
-     "execution_count": 5,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "ssl_connection = redis.Redis(host='localhost', port=6666, ssl=True, ssl_cert_reqs=\"none\")\n",
-    "ssl_connection.ping()"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "## Connecting to a Redis instance via SSL, while specifying a self-signed SSL certificate."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 6,
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/plain": [
-       "True"
-      ]
-     },
-     "execution_count": 6,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "import os\n",
-    "\n",
-    "ROOT = os.path.join(os.getcwd(), \"..\", \"..\")\n",
-    "CERT_DIR = os.path.abspath(os.path.join(ROOT, \"docker\", \"stunnel\", \"keys\"))\n",
-    "ssl_certfile=os.path.join(CERT_DIR, \"server-cert.pem\")\n",
-    "ssl_keyfile=os.path.join(CERT_DIR, \"server-key.pem\")\n",
-    "ssl_ca_certs=os.path.join(CERT_DIR, \"server-cert.pem\")\n",
-    "\n",
-    "ssl_cert_conn = redis.Redis(\n",
-    "    host=\"localhost\",\n",
-    "    port=6666,\n",
-    "    ssl=True,\n",
-    "    ssl_certfile=ssl_certfile,\n",
-    "    ssl_keyfile=ssl_keyfile,\n",
-    "    ssl_cert_reqs=\"required\",\n",
-    "    ssl_ca_certs=ssl_ca_certs,\n",
-    ")\n",
-    "ssl_cert_conn.ping()"
-   ]
-  },
   {
    "cell_type": "markdown",
    "metadata": {},
@@ -203,7 +128,7 @@
     }
    ],
    "source": [
-    "url_connection = redis.from_url(\"rediss://localhost:6666?ssl_cert_reqs=none&decode_responses=True&health_check_interval=2\")\n",
+    "url_connection = redis.from_url(\"redis://localhost:6379?decode_responses=True&health_check_interval=2\")\n",
     "\n",
     "url_connection.ping()"
    ]
diff --git a/docs/examples/ssl_connecton_examples.ipynb b/docs/examples/ssl_connecton_examples.ipynb
new file mode 100644
index 0000000000..386e4af452
--- /dev/null
+++ b/docs/examples/ssl_connecton_examples.ipynb
@@ -0,0 +1,277 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# SSL Connection Examples"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Connecting to a Redis instance via SSL."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 5,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "import redis\n",
+    "\n",
+    "ssl_connection = redis.Redis(host='localhost', port=6666, ssl=True, ssl_cert_reqs=\"none\")\n",
+    "ssl_connection.ping()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Connecting to a Redis instance via a URL string"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import redis\n",
+    "url_connection = redis.from_url(\"redis://localhost:6379?ssl_cert_reqs=none&decode_responses=True&health_check_interval=2\")\n",
+    "url_connection.ping()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Connecting to a Redis instance via SSL, while specifying a self-signed SSL certificate."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 6,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "import os\n",
+    "import redis\n",
+    "\n",
+    "ssl_certfile=\"some-certificate.pem\"\n",
+    "ssl_keyfile=\"some-key.pem\"\n",
+    "ssl_ca_certs=ssl_certfile\n",
+    "\n",
+    "ssl_cert_conn = redis.Redis(\n",
+    "    host=\"localhost\",\n",
+    "    port=6666,\n",
+    "    ssl=True,\n",
+    "    ssl_certfile=ssl_certfile,\n",
+    "    ssl_keyfile=ssl_keyfile,\n",
+    "    ssl_cert_reqs=\"required\",\n",
+    "    ssl_ca_certs=ssl_ca_certs,\n",
+    ")\n",
+    "ssl_cert_conn.ping()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Connecting to a Redis instance via SSL, and validate the OCSP status of the certificate\n",
+    "\n",
+    "The redis package is design to be small, meaning extra libraries must be installed, in order to support OCSP stapling. As a result, first install redis via:\n",
+    "\n",
+    "*pip install redis[ocsp]*\n",
+    "\n",
+    "This will install cryptography, requests, and PyOpenSSL, none of which are generally required to use Redis."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "import os\n",
+    "import redis\n",
+    "\n",
+    "ssl_certfile=\"some-certificate.pem\"\n",
+    "ssl_keyfile=\"some-key.pem\"\n",
+    "ssl_ca_certs=ssl_certfile\n",
+    "\n",
+    "ssl_cert_conn = redis.Redis(\n",
+    "    host=\"localhost\",\n",
+    "    port=6666,\n",
+    "    ssl=True,\n",
+    "    ssl_certfile=ssl_certfile,\n",
+    "    ssl_keyfile=ssl_keyfile,\n",
+    "    ssl_cert_reqs=\"required\",\n",
+    "    ssl_validate_ocsp=True\n",
+    ")\n",
+    "ssl_cert_conn.ping()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Connect via SSL, validate OCSP-stapled certificates\n",
+    "\n",
+    "The redis package is design to be small, meaning extra libraries must be installed, in order to support OCSP stapling. As a result, first install redis via:\n",
+    "\n",
+    "*pip install redis[ocsp]*\n",
+    "\n",
+    "This will install cryptography, requests, and PyOpenSSL, none of which are generally required to use Redis."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Using a custom SSL context and validating against an expected certificate"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "import redis\n",
+    "import OpenSSL\n",
+    "\n",
+    "ssl_certfile=\"some-certificate.pem\"\n",
+    "ssl_keyfile=\"some-key.pem\"\n",
+    "ssl_ca_certs=ssl_certfile\n",
+    "ssl_expected_certificate = \"expected-ocsp-certificate.pem\"\n",
+    "\n",
+    "# PyOpenSSL is used only for the purpose of validating the ocsp\n",
+    "# stapled response\n",
+    "ctx = OpenSSL.SSL.Context(OpenSSL.SSL.SSLv23_METHOD)\n",
+    "ctx.use_certificate_file=ssl_certfile\n",
+    "ctx.use_privatekey_file=ssl_keyfile\n",
+    "expected_certificate = open(ssl_expected_certificate, 'rb').read()\n",
+    "\n",
+    "ssl_cert_conn = redis.Redis(\n",
+    "    host=\"localhost\",\n",
+    "    port=6666,\n",
+    "    ssl=True,\n",
+    "    ssl_certfile=ssl_certfile,\n",
+    "    ssl_keyfile=ssl_keyfile,\n",
+    "    ssl_cert_reqs=\"required\",\n",
+    "    ssl_ocsp_context=ctx,\n",
+    "    ssl_ocsp_expected_cert=expected_certificate,\n",
+    ")\n",
+    "ssl_cert_conn.ping()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Naive validation of a stapled OCSP certificate"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import redis\n",
+    "import OpenSSL\n",
+    "\n",
+    "ssl_certfile=\"some-certificate.pem\"\n",
+    "ssl_keyfile=\"some-key.pem\"\n",
+    "ssl_ca_certs=ssl_certfile\n",
+    "ssl_expected_certificate = \"expected-ocsp-certificate.pem\"\n",
+    "\n",
+    "# PyOpenSSL is used only for the purpose of validating the ocsp\n",
+    "# stapled response\n",
+    "ctx = OpenSSL.SSL.Context(OpenSSL.SSL.SSLv23_METHOD)\n",
+    "ctx.use_certificate_file=ssl_certfile\n",
+    "ctx.use_privatekey_file=ssl_keyfile\n",
+    "\n",
+    "ssl_cert_conn = redis.Redis(\n",
+    "    host=\"localhost\",\n",
+    "    port=6666,\n",
+    "    ssl=True,\n",
+    "    ssl_certfile=ssl_certfile,\n",
+    "    ssl_keyfile=ssl_keyfile,\n",
+    "    ssl_cert_reqs=\"required\",\n",
+    "    ssl_validate_ocsp_stapled=True,\n",
+    ")\n",
+    "ssl_cert_conn.ping()"
+   ]
+  }
+ ],
+ "metadata": {
+  "interpreter": {
+   "hash": "d45c99ba0feda92868abafa8257cbb4709c97f1a0b5dc62bbeebdf89d4fad7fe"
+  },
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.8.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/redis/client.py b/redis/client.py
index 2832d2c103..612f91170a 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -880,6 +880,9 @@ def __init__(
         ssl_check_hostname=False,
         ssl_password=None,
         ssl_validate_ocsp=False,
+        ssl_validate_ocsp_stapled=False,
+        ssl_ocsp_context=None,
+        ssl_ocsp_expected_cert=None,
         max_connections=None,
         single_connection_client=False,
         health_check_interval=0,
@@ -958,7 +961,10 @@ def __init__(
                             "ssl_check_hostname": ssl_check_hostname,
                             "ssl_password": ssl_password,
                             "ssl_ca_path": ssl_ca_path,
+                            "ssl_validate_ocsp_stapled": ssl_validate_ocsp_stapled,
                             "ssl_validate_ocsp": ssl_validate_ocsp,
+                            "ssl_ocsp_context": ssl_ocsp_context,
+                            "ssl_ocsp_expected_cert": ssl_ocsp_expected_cert,
                         }
                     )
             connection_pool = ConnectionPool(**kwargs)
diff --git a/redis/connection.py b/redis/connection.py
index 4178f67c57..5fdac54c00 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -908,6 +908,9 @@ def __init__(
         ssl_ca_path=None,
         ssl_password=None,
         ssl_validate_ocsp=False,
+        ssl_validate_ocsp_stapled=False,
+        ssl_ocsp_context=None,
+        ssl_ocsp_expected_cert=None,
         **kwargs,
     ):
         """Constructor
@@ -921,6 +924,11 @@ def __init__(
             ssl_ca_path: The path to a directory containing several CA certificates in PEM format. Defaults to None.
             ssl_password: Password for unlocking an encrypted private key. Defaults to None.
 
+            ssl_validate_ocsp: If set, perform a full ocsp validation (i.e not a stapled verification)
+            ssl_validate_ocsp_stapled: If set, perform a validation on a stapled ocsp response
+            ssl_ocsp_context: A fully initialized OpenSSL.SSL.Context object to be used in verifying the ssl_ocsp_expected_cert
+            ssl_ocsp_expected_cert: A PEM armoured string containing the expected certificate to be returned from the ocsp verification service.
+
         Raises:
             RedisError
         """  # noqa
@@ -950,6 +958,9 @@ def __init__(
         self.check_hostname = ssl_check_hostname
         self.certificate_password = ssl_password
         self.ssl_validate_ocsp = ssl_validate_ocsp
+        self.ssl_validate_ocsp_stapled = ssl_validate_ocsp_stapled
+        self.ssl_ocsp_context = ssl_ocsp_context
+        self.ssl_ocsp_expected_cert = ssl_ocsp_expected_cert
 
     def _connect(self):
         "Wrap the socket with SSL support"
@@ -968,7 +979,42 @@ def _connect(self):
         sslsock = context.wrap_socket(sock, server_hostname=self.host)
         if self.ssl_validate_ocsp is True and CRYPTOGRAPHY_AVAILABLE is False:
             raise RedisError("cryptography is not installed.")
-        elif self.ssl_validate_ocsp is True and CRYPTOGRAPHY_AVAILABLE:
+
+        if self.ssl_validate_ocsp_stapled and self.ssl_validate_ocsp:
+            raise RedisError(
+                "Either an OCSP staple or pure OCSP connection must be validated "
+                "- not both."
+            )
+
+        # validation for the stapled case
+        if self.ssl_validate_ocsp_stapled:
+            import OpenSSL
+
+            from .ocsp import ocsp_staple_verifier
+
+            # if a context is provided use it - otherwise, a basic context
+            if self.ssl_ocsp_context is None:
+                staple_ctx = OpenSSL.SSL.Context(OpenSSL.SSL.SSLv23_METHOD)
+                staple_ctx.use_certificate_file(self.certfile)
+                staple_ctx.use_privatekey_file(self.keyfile)
+            else:
+                staple_ctx = self.ssl_ocsp_context
+
+            staple_ctx.set_ocsp_client_callback(
+                ocsp_staple_verifier,
+                self.ssl_ocsp_expected_cert,
+            )
+
+            #  need another socket
+            con = OpenSSL.SSL.Connection(staple_ctx, socket.socket())
+            con.request_ocsp()
+            con.connect((self.host, self.port))
+            con.do_handshake()
+            con.shutdown()
+            return sslsock
+
+        # pure ocsp validation
+        if self.ssl_validate_ocsp is True and CRYPTOGRAPHY_AVAILABLE:
             from .ocsp import OCSPVerifier
 
             o = OCSPVerifier(sslsock, self.host, self.port, self.ca_certs)
diff --git a/redis/ocsp.py b/redis/ocsp.py
index 49aaddf48b..666c7dcd08 100644
--- a/redis/ocsp.py
+++ b/redis/ocsp.py
@@ -1,18 +1,170 @@
 import base64
+import datetime
 import ssl
 from urllib.parse import urljoin, urlparse
 
 import cryptography.hazmat.primitives.hashes
 import requests
 from cryptography import hazmat, x509
+from cryptography.exceptions import InvalidSignature
 from cryptography.hazmat import backends
+from cryptography.hazmat.primitives.asymmetric.dsa import DSAPublicKey
+from cryptography.hazmat.primitives.asymmetric.ec import ECDSA, EllipticCurvePublicKey
+from cryptography.hazmat.primitives.asymmetric.padding import PKCS1v15
+from cryptography.hazmat.primitives.asymmetric.rsa import RSAPublicKey
+from cryptography.hazmat.primitives.hashes import SHA1, Hash
+from cryptography.hazmat.primitives.serialization import Encoding, PublicFormat
 from cryptography.x509 import ocsp
 
 from redis.exceptions import AuthorizationError, ConnectionError
 
 
+def _verify_response(issuer_cert, ocsp_response):
+    pubkey = issuer_cert.public_key()
+    try:
+        if isinstance(pubkey, RSAPublicKey):
+            pubkey.verify(
+                ocsp_response.signature,
+                ocsp_response.tbs_response_bytes,
+                PKCS1v15(),
+                ocsp_response.signature_hash_algorithm,
+            )
+        elif isinstance(pubkey, DSAPublicKey):
+            pubkey.verify(
+                ocsp_response.signature,
+                ocsp_response.tbs_response_bytes,
+                ocsp_response.signature_hash_algorithm,
+            )
+        elif isinstance(pubkey, EllipticCurvePublicKey):
+            pubkey.verify(
+                ocsp_response.signature,
+                ocsp_response.tbs_response_bytes,
+                ECDSA(ocsp_response.signature_hash_algorithm),
+            )
+        else:
+            pubkey.verify(ocsp_response.signature, ocsp_response.tbs_response_bytes)
+    except InvalidSignature:
+        raise ConnectionError("failed to valid ocsp response")
+
+
+def _check_certificate(issuer_cert, ocsp_bytes, validate=True):
+    """A wrapper the return the validity of a known ocsp certificate"""
+
+    ocsp_response = ocsp.load_der_ocsp_response(ocsp_bytes)
+
+    if ocsp_response.response_status == ocsp.OCSPResponseStatus.UNAUTHORIZED:
+        raise AuthorizationError("you are not authorized to view this ocsp certificate")
+    if ocsp_response.response_status == ocsp.OCSPResponseStatus.SUCCESSFUL:
+        if ocsp_response.certificate_status != ocsp.OCSPCertStatus.GOOD:
+            return False
+    else:
+        return False
+
+    if ocsp_response.this_update >= datetime.datetime.now():
+        raise ConnectionError("ocsp certificate was issued in the future")
+
+    if (
+        ocsp_response.next_update
+        and ocsp_response.next_update < datetime.datetime.now()
+    ):
+        raise ConnectionError("ocsp certificate has invalid update - in the past")
+
+    responder_name = ocsp_response.responder_name
+    issuer_hash = ocsp_response.issuer_key_hash
+    responder_hash = ocsp_response.responder_key_hash
+
+    cert_to_validate = issuer_cert
+    if (
+        responder_name is not None
+        and responder_name == issuer_cert.subject
+        or responder_hash == issuer_hash
+    ):
+        cert_to_validate = issuer_cert
+    else:
+        certs = ocsp_response.certificates
+        responder_certs = _get_certificates(
+            certs, issuer_cert, responder_name, responder_hash
+        )
+
+        try:
+            responder_cert = responder_certs[0]
+        except IndexError:
+            raise ConnectionError("no certificates found for the responder")
+
+        ext = responder_cert.extensions.get_extension_for_class(x509.ExtendedKeyUsage)
+        if ext is None or x509.oid.ExtendedKeyUsageOID.OCSP_SIGNING not in ext.value:
+            raise ConnectionError("delegate not autorized for ocsp signing")
+        cert_to_validate = responder_cert
+
+    if validate:
+        _verify_response(cert_to_validate, ocsp_response)
+    return True
+
+
+def _get_certificates(certs, issuer_cert, responder_name, responder_hash):
+    if responder_name is None:
+        certificates = [
+            c
+            for c in certs
+            if _get_pubkey_hash(c) == responder_hash and c.issuer == issuer_cert.subject
+        ]
+    else:
+        certificates = [
+            c
+            for c in certs
+            if c.subject == responder_name and c.issuer == issuer_cert.subject
+        ]
+
+    return certificates
+
+
+def _get_pubkey_hash(certificate):
+    pubkey = certificate.public_key()
+
+    # https://stackoverflow.com/a/46309453/600498
+    if isinstance(pubkey, RSAPublicKey):
+        h = pubkey.public_bytes(Encoding.DER, PublicFormat.PKCS1)
+    elif isinstance(pubkey, EllipticCurvePublicKey):
+        h = pubkey.public_bytes(Encoding.X962, PublicFormat.UncompressedPoint)
+    else:
+        h = pubkey.public_bytes(Encoding.DER, PublicFormat.SubjectPublicKeyInfo)
+
+    sha1 = Hash(SHA1(), backend=backends.default_backend())
+    sha1.update(h)
+    return sha1.finalize()
+
+
+def ocsp_staple_verifier(con, ocsp_bytes, expected=None):
+    """An implemention of a function for set_ocsp_client_callback in PyOpenSSL.
+
+    This function validates that the provide ocsp_bytes response is valid,
+    and matches the expected, stapled responses.
+    """
+    if ocsp_bytes in [b"", None]:
+        raise ConnectionError("no ocsp response present")
+
+    issuer_cert = None
+    peer_cert = con.get_peer_certificate().to_cryptography()
+    for c in con.get_peer_cert_chain():
+        cert = c.to_cryptography()
+        if cert.subject == peer_cert.issuer:
+            issuer_cert = cert
+            break
+
+    if issuer_cert is None:
+        raise ConnectionError("no matching issuer cert found in certificate chain")
+
+    if expected is not None:
+        e = x509.load_pem_x509_certificate(expected)
+        if peer_cert != e:
+            raise ConnectionError("received and expected certificates do not match")
+
+    return _check_certificate(issuer_cert, ocsp_bytes)
+
+
 class OCSPVerifier:
-    """A class to verify ssl sockets for RFC6960/RFC6961.
+    """A class to verify ssl sockets for RFC6960/RFC6961. This can be used
+    when using direct validation of OCSP responses and certificate revocations.
 
     @see https://datatracker.ietf.org/doc/html/rfc6960
     @see https://datatracker.ietf.org/doc/html/rfc6961
@@ -67,7 +219,7 @@ def _certificate_components(self, cert):
         try:
             issuer = issuers[0].access_location.value
         except IndexError:
-            raise ConnectionError("no issuers in certificate")
+            issuer = None
 
         # now, the series of ocsp server entries
         ocsps = [
@@ -128,19 +280,7 @@ def check_certificate(self, server, cert, issuer_url):
         r = requests.get(ocsp_url, headers=header)
         if not r.ok:
             raise ConnectionError("failed to fetch ocsp certificate")
-
-        ocsp_response = ocsp.load_der_ocsp_response(r.content)
-        if ocsp_response.response_status == ocsp.OCSPResponseStatus.UNAUTHORIZED:
-            raise AuthorizationError(
-                "you are not authorized to view this ocsp certificate"
-            )
-        if ocsp_response.response_status == ocsp.OCSPResponseStatus.SUCCESSFUL:
-            if ocsp_response.certificate_status == ocsp.OCSPCertStatus.REVOKED:
-                return False
-            else:
-                return True
-        else:
-            return False
+        return _check_certificate(issuer_cert, r.content, True)
 
     def is_valid(self):
         """Returns the validity of the certificate wrapping our socket.
@@ -153,7 +293,11 @@ def is_valid(self):
         # validate the certificate
         try:
             cert, issuer_url, ocsp_server = self.components_from_socket()
+            if issuer_url is None:
+                raise ConnectionError("no issuers found in certificate chain")
             return self.check_certificate(ocsp_server, cert, issuer_url)
         except AuthorizationError:
             cert, issuer_url, ocsp_server = self.components_from_direct_connection()
+            if issuer_url is None:
+                raise ConnectionError("no issuers found in certificate chain")
             return self.check_certificate(ocsp_server, cert, issuer_url)
diff --git a/setup.py b/setup.py
index 559e521982..218fc27b84 100644
--- a/setup.py
+++ b/setup.py
@@ -54,6 +54,6 @@
     ],
     extras_require={
         "hiredis": ["hiredis>=1.0.0"],
-        "cryptography": ["cryptography>=36.0.1", "requests>=2.26.0"],
+        "ocsp": ["cryptography>=36.0.1", "pyopenssl==20.0.1", "requests>=2.26.0"],
     },
 )
diff --git a/tasks.py b/tasks.py
index 313986d427..96005ca4e3 100644
--- a/tasks.py
+++ b/tasks.py
@@ -66,7 +66,7 @@ def standalone_tests(c):
     with and without hiredis."""
     print("Starting Redis tests")
     _generate_keys()
-    run("tox -e standalone-'{plain,hiredis,cryptography}'")
+    run("tox -e standalone-'{plain,hiredis,ocsp}'")
 
 
 @task
diff --git a/tests/test_ssl.py b/tests/test_ssl.py
index a2f66b26ef..0ae7440daf 100644
--- a/tests/test_ssl.py
+++ b/tests/test_ssl.py
@@ -28,6 +28,9 @@ class TestSSL:
         if not os.path.isdir(CERT_DIR):
             raise IOError(f"No SSL certificates found. They should be in {CERT_DIR}")
 
+    SERVER_CERT = os.path.join(CERT_DIR, "server-cert.pem")
+    SERVER_KEY = os.path.join(CERT_DIR, "server-key.pem")
+
     def test_ssl_with_invalid_cert(self, request):
         ssl_url = request.config.option.redis_ssl_url
         sslclient = redis.from_url(ssl_url)
@@ -57,10 +60,10 @@ def test_validating_self_signed_certificate(self, request):
             host=p[0],
             port=p[1],
             ssl=True,
-            ssl_certfile=os.path.join(self.CERT_DIR, "server-cert.pem"),
-            ssl_keyfile=os.path.join(self.CERT_DIR, "server-key.pem"),
+            ssl_certfile=self.SERVER_CERT,
+            ssl_keyfile=self.SERVER_KEY,
             ssl_cert_reqs="required",
-            ssl_ca_certs=os.path.join(self.CERT_DIR, "server-cert.pem"),
+            ssl_ca_certs=self.SERVER_CERT,
         )
         assert r.ping()
 
@@ -71,10 +74,10 @@ def _create_oscp_conn(self, request):
             host=p[0],
             port=p[1],
             ssl=True,
-            ssl_certfile=os.path.join(self.CERT_DIR, "server-cert.pem"),
-            ssl_keyfile=os.path.join(self.CERT_DIR, "server-key.pem"),
+            ssl_certfile=self.SERVER_CERT,
+            ssl_keyfile=self.SERVER_KEY,
             ssl_cert_reqs="required",
-            ssl_ca_certs=os.path.join(self.CERT_DIR, "server-cert.pem"),
+            ssl_ca_certs=self.SERVER_CERT,
             ssl_validate_ocsp=True,
         )
         return r
@@ -159,3 +162,60 @@ def test_unauthorized_then_direct(self):
                 with context.wrap_socket(sock, server_hostname=hostname) as wrapped:
                     ocsp = OCSPVerifier(wrapped, hostname, 443)
                     assert ocsp.is_valid()
+
+    @skip_if_nocryptography()
+    def test_mock_ocsp_staple(self, request):
+        import OpenSSL
+
+        ssl_url = request.config.option.redis_ssl_url
+        p = urlparse(ssl_url)[1].split(":")
+        r = redis.Redis(
+            host=p[0],
+            port=p[1],
+            ssl=True,
+            ssl_certfile=self.SERVER_CERT,
+            ssl_keyfile=self.SERVER_KEY,
+            ssl_cert_reqs="required",
+            ssl_ca_certs=self.SERVER_CERT,
+            ssl_validate_ocsp=True,
+            ssl_ocsp_context=p,  # just needs to not be none
+        )
+
+        with pytest.raises(RedisError):
+            r.ping()
+
+        ctx = OpenSSL.SSL.Context(OpenSSL.SSL.SSLv23_METHOD)
+        ctx.use_certificate_file(self.SERVER_CERT)
+        ctx.use_privatekey_file(self.SERVER_KEY)
+
+        r = redis.Redis(
+            host=p[0],
+            port=p[1],
+            ssl=True,
+            ssl_certfile=self.SERVER_CERT,
+            ssl_keyfile=self.SERVER_KEY,
+            ssl_cert_reqs="required",
+            ssl_ca_certs=self.SERVER_CERT,
+            ssl_ocsp_context=ctx,
+            ssl_ocsp_expected_cert=open(self.SERVER_KEY, "rb").read(),
+            ssl_validate_ocsp_stapled=True,
+        )
+
+        with pytest.raises(ConnectionError) as e:
+            r.ping()
+            assert "no ocsp response present" in str(e)
+
+        r = redis.Redis(
+            host=p[0],
+            port=p[1],
+            ssl=True,
+            ssl_certfile=self.SERVER_CERT,
+            ssl_keyfile=self.SERVER_KEY,
+            ssl_cert_reqs="required",
+            ssl_ca_certs=self.SERVER_CERT,
+            ssl_validate_ocsp_stapled=True,
+        )
+
+        with pytest.raises(ConnectionError) as e:
+            r.ping()
+            assert "no ocsp response present" in str(e)
diff --git a/tox.ini b/tox.ini
index ac7f01a6ca..abebf004ba 100644
--- a/tox.ini
+++ b/tox.ini
@@ -10,7 +10,7 @@ markers =
 [tox]
 minversion = 3.2.0
 requires = tox-docker
-envlist = {standalone,cluster}-{plain,hiredis,cryptography}-{py36,py37,py38,py39,pypy3},linters,docs
+envlist = {standalone,cluster}-{plain,hiredis,ocsp}-{py36,py37,py38,py39,pypy3},linters,docs
 
 [docker:master]
 name = master
@@ -128,7 +128,7 @@ docker =
     stunnel
 extras =
     hiredis: hiredis
-    cryptography: cryptography, requests
+    ocsp: cryptography, pyopenssl, requests
 setenv =
     CLUSTER_URL = "redis://localhost:16379/0"
 run_before = {toxinidir}/docker/stunnel/create_certs.sh

From 0e30d8da4d1e7cba14bce4ab0e247a97d492d142 Mon Sep 17 00:00:00 2001
From: Jonathan Dieter <jdieter@gmail.com>
Date: Mon, 17 Jan 2022 10:17:39 +0000
Subject: [PATCH 0342/1164] Add retries to connections in Sentinel Pools
 (#1879)

---
 redis/sentinel.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/redis/sentinel.py b/redis/sentinel.py
index 025ab39c8c..b3f14907d0 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -37,7 +37,7 @@ def connect_to(self, address):
             if str_if_bytes(self.read_response()) != "PONG":
                 raise ConnectionError("PING failed")
 
-    def connect(self):
+    def _connect_retry(self):
         if self._sock:
             return  # already connected
         if self.connection_pool.is_master:
@@ -50,6 +50,12 @@ def connect(self):
                     continue
             raise SlaveNotFoundError  # Never be here
 
+    def connect(self):
+        return self.retry.call_with_retry(
+            self._connect_retry,
+            lambda error: None,
+        )
+
     def read_response(self, disable_decoding=False):
         try:
             return super().read_response(disable_decoding=disable_decoding)

From 90295ea422dffe54689458acc995d71aa16e0979 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 17 Jan 2022 12:38:02 +0200
Subject: [PATCH 0343/1164] 4.1.1 (#1883)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 218fc27b84..8b84c2a97a 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.1.0",
+    version="4.1.1",
     packages=find_packages(
         include=[
             "redis",

From c605690051baff404123e7fe328ac4e50eb00e72 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 18 Jan 2022 17:51:31 +0200
Subject: [PATCH 0344/1164] direct link to readthedocs (#1885)

---
 README.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index f8e76701fe..166e80c23b 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,7 @@
 The Python interface to the Redis key-value store.
 
 [![CI](https://github.com/redis/redis-py/workflows/CI/badge.svg?branch=master)](https://github.com/redis/redis-py/actions?query=workflow%3ACI+branch%3Amaster)
-[![docs](https://readthedocs.org/projects/redis-py/badge/?version=stable&style=flat)](https://redis-py.readthedocs.io/en/stable/)
+[![docs](https://readthedocs.org/projects/redis/badge/?version=stable&style=flat)](https://redis-py.readthedocs.io/en/stable/)
 [![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 [![pypi](https://badge.fury.io/py/redis.svg)](https://pypi.org/project/redis/)
 [![codecov](https://codecov.io/gh/redis/redis-py/branch/master/graph/badge.svg?token=yenl5fzxxr)](https://codecov.io/gh/redis/redis-py)
@@ -41,6 +41,8 @@ or from source:
 $ python setup.py install
 ```
 
+View the current documentation [here](https://readthedocs.org/projects/redis/).
+
 ## Contributing
 
 Want to contribute a feature, bug fix, or report an issue? Check out

From afaa1c8f6d4bd7c66d6769a0a4b8d4f9a2d600d8 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 19 Jan 2022 14:51:01 +0200
Subject: [PATCH 0345/1164] Add search-json examples (#1886)

---
 docs/connections.rst                          |   2 +
 docs/examples.rst                             |   1 +
 .../connection_example-checkpoint.ipynb       | 180 ---------------
 docs/examples/search_json_examples.ipynb      | 214 ++++++++++++++++++
 docs/redismodules.rst                         |   1 +
 5 files changed, 218 insertions(+), 180 deletions(-)
 delete mode 100644 docs/examples/.ipynb_checkpoints/connection_example-checkpoint.ipynb
 create mode 100644 docs/examples/search_json_examples.ipynb

diff --git a/docs/connections.rst b/docs/connections.rst
index cf4657b95b..ba39f3341f 100644
--- a/docs/connections.rst
+++ b/docs/connections.rst
@@ -41,3 +41,5 @@ Connection Pools
 *****************
 .. autoclass:: redis.connection.ConnectionPool
     :members:
+
+More connection examples can be found `here <examples/connection_examples.html>`_.
\ No newline at end of file
diff --git a/docs/examples.rst b/docs/examples.rst
index 7a328afd82..cf70c09bf9 100644
--- a/docs/examples.rst
+++ b/docs/examples.rst
@@ -7,3 +7,4 @@ Examples
 
    examples/connection_examples
    examples/ssl_connection_examples
+   examples/search_json_examples
diff --git a/docs/examples/.ipynb_checkpoints/connection_example-checkpoint.ipynb b/docs/examples/.ipynb_checkpoints/connection_example-checkpoint.ipynb
deleted file mode 100644
index 04de8fe1c5..0000000000
--- a/docs/examples/.ipynb_checkpoints/connection_example-checkpoint.ipynb
+++ /dev/null
@@ -1,180 +0,0 @@
-{
- "cells": [
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "### Connect to redis running locally with default parameters "
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 40,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "True\n"
-     ]
-    }
-   ],
-   "source": [
-    "import redis\n",
-    "r = redis.Redis()\n",
-    "print(r.ping())"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "### Overwrite default parameters - connect to redis on specific host and port using username and password"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 39,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "True\n"
-     ]
-    }
-   ],
-   "source": [
-    "import redis\n",
-    "r = redis.Redis(host='localhost', port=6380, username='dvora', password='redis')\n",
-    "print(r.ping())"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "### Create a SSL wrapped TCP socket connection"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 38,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "True\n"
-     ]
-    }
-   ],
-   "source": [
-    "import redis\n",
-    "r = redis.Redis(host='localhost', port=6666, ssl=True, ssl_cert_reqs=\"none\")\n",
-    "print(r.ping())"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "### Add more parameters..."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 37,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "True\n"
-     ]
-    }
-   ],
-   "source": [
-    "import os\n",
-    "import redis\n",
-    "\n",
-    "ROOT = os.path.join(os.getcwd(), \"..\")\n",
-    "CERT_DIR = os.path.abspath(os.path.join(ROOT, \"docker\", \"stunnel\", \"keys\"))\n",
-    "\n",
-    "r = redis.Redis(\n",
-    "    host=\"localhost\",\n",
-    "    port=6666,\n",
-    "    ssl=True,\n",
-    "    ssl_certfile=os.path.join(CERT_DIR, \"server-cert.pem\"),\n",
-    "    ssl_keyfile=os.path.join(CERT_DIR, \"server-key.pem\"),\n",
-    "    ssl_cert_reqs=\"required\",\n",
-    "    ssl_ca_certs=os.path.join(CERT_DIR, \"server-cert.pem\"),\n",
-    ")\n",
-    "print(r.ping())"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "### Connect to redis client object configured from given URL\n",
-    "##### Three URL schemes are supported:\n",
-    "\n",
-    "##### - `redis://` creates a TCP socket connection. See more at:\n",
-    "##### <https://www.iana.org/assignments/uri-schemes/prov/redis>\n",
-    "##### - `rediss://` creates a SSL wrapped TCP socket connection. See more at:\n",
-    "##### <https://www.iana.org/assignments/uri-schemes/prov/rediss>\n",
-    "##### - ``unix://``: creates a Unix Domain Socket connection.\n",
-    "\n",
-    "##### Parameters are passed through querystring"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 36,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "True\n"
-     ]
-    }
-   ],
-   "source": [
-    "import redis\n",
-    "r = redis.from_url(\"rediss://localhost:6666?ssl_cert_reqs=none\")\n",
-    "print(r.ping())"
-   ]
-  }
- ],
- "metadata": {
-  "interpreter": {
-   "hash": "d45c99ba0feda92868abafa8257cbb4709c97f1a0b5dc62bbeebdf89d4fad7fe"
-  },
-  "kernelspec": {
-   "display_name": "Python 3 (ipykernel)",
-   "language": "python",
-   "name": "python3"
-  },
-  "language_info": {
-   "codemirror_mode": {
-    "name": "ipython",
-    "version": 3
-   },
-   "file_extension": ".py",
-   "mimetype": "text/x-python",
-   "name": "python",
-   "nbconvert_exporter": "python",
-   "pygments_lexer": "ipython3",
-   "version": "3.9.9"
-  }
- },
- "nbformat": 4,
- "nbformat_minor": 2
-}
diff --git a/docs/examples/search_json_examples.ipynb b/docs/examples/search_json_examples.ipynb
new file mode 100644
index 0000000000..6673663687
--- /dev/null
+++ b/docs/examples/search_json_examples.ipynb
@@ -0,0 +1,214 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Indexing / querying JSON documents\n",
+    "## Adding a JSON document to an index"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "b'OK'"
+      ]
+     },
+     "execution_count": 1,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "import redis\n",
+    "from redis.commands.json.path import Path\n",
+    "import redis.commands.search.aggregation as aggregations\n",
+    "import redis.commands.search.reducers as reducers\n",
+    "from redis.commands.search.field import TextField, NumericField, TagField\n",
+    "from redis.commands.search.indexDefinition import IndexDefinition, IndexType\n",
+    "from redis.commands.search.query import NumericFilter, Query\n",
+    "\n",
+    "\n",
+    "r = redis.Redis(host='localhost', port=36379)\n",
+    "user1 = {\n",
+    "    \"user\":{\n",
+    "        \"name\": \"Paul John\",\n",
+    "        \"email\": \"paul.john@example.com\",\n",
+    "        \"age\": 42,\n",
+    "        \"city\": \"London\"\n",
+    "    }\n",
+    "}\n",
+    "user2 = {\n",
+    "    \"user\":{\n",
+    "        \"name\": \"Eden Zamir\",\n",
+    "        \"email\": \"eden.zamir@example.com\",\n",
+    "        \"age\": 29,\n",
+    "        \"city\": \"Tel Aviv\"\n",
+    "    }\n",
+    "}\n",
+    "user3 = {\n",
+    "    \"user\":{\n",
+    "        \"name\": \"Paul Zamir\",\n",
+    "        \"email\": \"paul.zamir@example.com\",\n",
+    "        \"age\": 35,\n",
+    "        \"city\": \"Tel Aviv\"\n",
+    "    }\n",
+    "}\n",
+    "r.json().set(\"user:1\", Path.rootPath(), user1)\n",
+    "r.json().set(\"user:2\", Path.rootPath(), user2)\n",
+    "r.json().set(\"user:3\", Path.rootPath(), user3)\n",
+    "\n",
+    "schema = (TextField(\"$.user.name\", as_name=\"name\"),TagField(\"$.user.city\", as_name=\"city\"), NumericField(\"$.user.age\", as_name=\"age\"))\n",
+    "r.ft().create_index(schema, definition=IndexDefinition(prefix=[\"user:\"], index_type=IndexType.JSON))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Searching"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Simple search"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "Result{2 total, docs: [Document {'id': 'user:1', 'payload': None, 'json': '{\"user\":{\"name\":\"Paul John\",\"email\":\"paul.john@example.com\",\"age\":42,\"city\":\"London\"}}'}, Document {'id': 'user:3', 'payload': None, 'json': '{\"user\":{\"name\":\"Paul Zamir\",\"email\":\"paul.zamir@example.com\",\"age\":35,\"city\":\"Tel Aviv\"}}'}]}"
+      ]
+     },
+     "execution_count": 2,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "r.ft().search(\"Paul\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Filtering search results"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "Result{1 total, docs: [Document {'id': 'user:3', 'payload': None, 'json': '{\"user\":{\"name\":\"Paul Zamir\",\"email\":\"paul.zamir@example.com\",\"age\":35,\"city\":\"Tel Aviv\"}}'}]}"
+      ]
+     },
+     "execution_count": 3,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "q1 = Query(\"Paul\").add_filter(NumericFilter(\"age\", 30, 40))\n",
+    "r.ft().search(q1)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Projecting using JSON Path expressions "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[Document {'id': 'user:1', 'payload': None, 'city': 'London'},\n",
+       " Document {'id': 'user:3', 'payload': None, 'city': 'Tel Aviv'}]"
+      ]
+     },
+     "execution_count": 4,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "r.ft().search(Query(\"Paul\").return_field(\"$.user.city\", as_field=\"city\")).docs"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Aggregation"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[[b'age', b'35'], [b'age', b'42']]"
+      ]
+     },
+     "execution_count": 5,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "req = aggregations.AggregateRequest(\"Paul\").sort_by(\"@age\")\n",
+    "r.ft().aggregate(req).rows"
+   ]
+  }
+ ],
+ "metadata": {
+  "interpreter": {
+   "hash": "d45c99ba0feda92868abafa8257cbb4709c97f1a0b5dc62bbeebdf89d4fad7fe"
+  },
+  "kernelspec": {
+   "display_name": "Python 3.8.12 64-bit ('venv': venv)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.8.12"
+  },
+  "orig_nbformat": 4
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/docs/redismodules.rst b/docs/redismodules.rst
index 24be4da5b4..07e756d87e 100644
--- a/docs/redismodules.rst
+++ b/docs/redismodules.rst
@@ -93,6 +93,7 @@ These are the commands for interacting with the `RedisJSON module <https://redis
     r = redis.Redis()
     r.json().set("mykey", ".", {"hello": "world", "i am": ["a", "json", "object!"]}
 
+Examples of how to combine search and json can be found `here <examples/search_json_examples.html>`_.
 
 .. automodule:: redis.commands.json.commands
     :members: JSONCommands

From 7d23974a62982d1b4b5586a648f8e7b17eccc6e5 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 19 Jan 2022 17:55:19 +0200
Subject: [PATCH 0346/1164] Documentation fixes: JSON Example, SSL Connection
 Examples, RTD version (#1887)

---
 docs/conf.py                                       | 14 ++++++++++----
 ...xamples.ipynb => ssl_connection_examples.ipynb} |  0
 docs/redismodules.rst                              |  2 ++
 3 files changed, 12 insertions(+), 4 deletions(-)
 rename docs/examples/{ssl_connecton_examples.ipynb => ssl_connection_examples.ipynb} (100%)

diff --git a/docs/conf.py b/docs/conf.py
index 0f11442232..b99e46c879 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -35,6 +35,12 @@
     "sphinx.ext.autosectionlabel",
 ]
 
+# AutosectionLabel settings.
+# Uses a <page>:<label> schema which doesn't work for duplicate sub-section
+# labels, so set max depth.
+autosectionlabel_prefix_document = True
+autosectionlabel_maxdepth = 2
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
 
@@ -58,10 +64,10 @@
 # The short X.Y version.
 import redis
 
-version = ".".join(redis.__version__.split(".")[0:2])
-
-# The full version, including alpha/beta/rc tags.
-release = redis.__version__
+version = ".".join(redis.__version__.split(".")[0:3])
+release = version
+if version == "99.99.99":
+    release = "dev"
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
diff --git a/docs/examples/ssl_connecton_examples.ipynb b/docs/examples/ssl_connection_examples.ipynb
similarity index 100%
rename from docs/examples/ssl_connecton_examples.ipynb
rename to docs/examples/ssl_connection_examples.ipynb
diff --git a/docs/redismodules.rst b/docs/redismodules.rst
index 07e756d87e..e4d36b180c 100644
--- a/docs/redismodules.rst
+++ b/docs/redismodules.rst
@@ -110,6 +110,8 @@ These are the commands for interacting with the `RediSearch module <https://redi
 .. code-block:: python
 
     import redis
+    from redis.commands.search.field import TextField
+
     r = redis.Redis()
     r.ft().create_index(TextField("play", weight=5.0), TextField("ball"))
     print(r.ft().info())

From 168467e49db8933b3815747efc8ed8ba2a983b1b Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 25 Jan 2022 08:57:13 +0200
Subject: [PATCH 0347/1164] Fix link in the main page (#1897)

---
 docs/index.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/index.rst b/docs/index.rst
index 51b38a2bf7..2e42acb81b 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -44,7 +44,7 @@ There are two quick ways to connect to Redis.
    r = redis.from_url('redis://foo.bar.com:12345')
    r.ping()
 
-After that, you probably want to `run redis commands <redis_core_commands.html>`_.
+After that, you probably want to `run redis commands <commands.html>`_.
 
 .. toctree::
    :hidden:

From 476529845ba54bed98693076e67f290f01d0603b Mon Sep 17 00:00:00 2001
From: Soumendra kumar sahoo <soumendra.sahoo@freshworks.com>
Date: Tue, 25 Jan 2022 12:28:12 +0530
Subject: [PATCH 0348/1164] README code snippets formatted to highlight
 properly (#1888)

---
 README.md | 169 +++++++++++++++++++++++++++---------------------------
 1 file changed, 85 insertions(+), 84 deletions(-)

diff --git a/README.md b/README.md
index 166e80c23b..867f921d99 100644
--- a/README.md
+++ b/README.md
@@ -968,25 +968,25 @@ instance can be created:
 - Using 'host' and 'port' arguments:
 
 ``` pycon
-    >>> from redis.cluster import RedisCluster as Redis
-    >>> rc = Redis(host='localhost', port=6379)
-    >>> print(rc.get_nodes())
+>>> from redis.cluster import RedisCluster as Redis
+>>> rc = Redis(host='localhost', port=6379)
+>>> print(rc.get_nodes())
     [[host=127.0.0.1,port=6379,name=127.0.0.1:6379,server_type=primary,redis_connection=Redis<ConnectionPool<Connection<host=127.0.0.1,port=6379,db=0>>>], [host=127.0.0.1,port=6378,name=127.0.0.1:6378,server_type=primary,redis_connection=Redis<ConnectionPool<Connection<host=127.0.0.1,port=6378,db=0>>>], [host=127.0.0.1,port=6377,name=127.0.0.1:6377,server_type=replica,redis_connection=Redis<ConnectionPool<Connection<host=127.0.0.1,port=6377,db=0>>>]]
 ```
 - Using the Redis URL specification:
 
 ``` pycon
-    >>> from redis.cluster import RedisCluster as Redis
-    >>> rc = Redis.from_url("redis://localhost:6379/0")
+>>> from redis.cluster import RedisCluster as Redis
+>>> rc = Redis.from_url("redis://localhost:6379/0")
 ```
 
 - Directly, via the ClusterNode class:
 
 ``` pycon
-    >>> from redis.cluster import RedisCluster as Redis
-    >>> from redis.cluster import ClusterNode
-    >>> nodes = [ClusterNode('localhost', 6379), ClusterNode('localhost', 6378)]
-    >>> rc = Redis(startup_nodes=nodes)
+>>> from redis.cluster import RedisCluster as Redis
+>>> from redis.cluster import ClusterNode
+>>> nodes = [ClusterNode('localhost', 6379), ClusterNode('localhost', 6378)]
+>>> rc = Redis(startup_nodes=nodes)
 ```
 
 When a RedisCluster instance is being created it first attempts to establish a
@@ -1016,18 +1016,18 @@ The 'target_nodes' parameter is explained in the following section,
 'Specifying Target Nodes'.
 
 ``` pycon
-    >>> # target-nodes: the node that holds 'foo1's key slot
-    >>> rc.set('foo1', 'bar1')
-    >>> # target-nodes: the node that holds 'foo2's key slot
-    >>> rc.set('foo2', 'bar2')
-    >>> # target-nodes: the node that holds 'foo1's key slot
-    >>> print(rc.get('foo1'))
-    b'bar'
-    >>> # target-node: default-node
-    >>> print(rc.keys())
-    [b'foo1']
-    >>> # target-node: default-node
-    >>> rc.ping()
+>>> # target-nodes: the node that holds 'foo1's key slot
+>>> rc.set('foo1', 'bar1')
+>>> # target-nodes: the node that holds 'foo2's key slot
+>>> rc.set('foo2', 'bar2')
+>>> # target-nodes: the node that holds 'foo1's key slot
+>>> print(rc.get('foo1'))
+b'bar'
+>>> # target-node: default-node
+>>> print(rc.keys())
+[b'foo1']
+>>> # target-node: default-node
+>>> rc.ping()
 ```
 
 **Specifying Target Nodes:**
@@ -1043,18 +1043,18 @@ the client will be able to resolve the nodes flag again with the new topology
 and attempt to retry executing the command.
 
 ``` pycon
-    >>> from redis.cluster import RedisCluster as Redis
-    >>> # run cluster-meet command on all of the cluster's nodes
-    >>> rc.cluster_meet('127.0.0.1', 6379, target_nodes=Redis.ALL_NODES)
-    >>> # ping all replicas
-    >>> rc.ping(target_nodes=Redis.REPLICAS)
-    >>> # ping a random node
-    >>> rc.ping(target_nodes=Redis.RANDOM)
-    >>> # get the keys from all cluster nodes
-    >>> rc.keys(target_nodes=Redis.ALL_NODES)
-    [b'foo1', b'foo2']
-    >>> # execute bgsave in all primaries
-    >>> rc.bgsave(Redis.PRIMARIES)
+>>> from redis.cluster import RedisCluster as Redis
+>>> # run cluster-meet command on all of the cluster's nodes
+>>> rc.cluster_meet('127.0.0.1', 6379, target_nodes=Redis.ALL_NODES)
+>>> # ping all replicas
+>>> rc.ping(target_nodes=Redis.REPLICAS)
+>>> # ping a random node
+>>> rc.ping(target_nodes=Redis.RANDOM)
+>>> # get the keys from all cluster nodes
+>>> rc.keys(target_nodes=Redis.ALL_NODES)
+[b'foo1', b'foo2']
+>>> # execute bgsave in all primaries
+>>> rc.bgsave(Redis.PRIMARIES)
 ```
 
 You could also pass ClusterNodes directly if you want to execute a command on a
@@ -1064,12 +1064,12 @@ will not be made, since the passed target node/s may no longer be valid, and
 the relevant cluster or connection error will be returned.
 
 ``` pycon
-    >>> node = rc.get_node('localhost', 6379)
-    >>> # Get the keys only for that specific node
-    >>> rc.keys(target_nodes=node)
-    >>> # get Redis info from a subset of primaries
-    >>> subset_primaries = [node for node in rc.get_primaries() if node.port > 6378]
-    >>> rc.info(target_nodes=subset_primaries)
+>>> node = rc.get_node('localhost', 6379)
+>>> # Get the keys only for that specific node
+>>> rc.keys(target_nodes=node)
+>>> # get Redis info from a subset of primaries
+>>> subset_primaries = [node for node in rc.get_primaries() if node.port > 6378]
+>>> rc.info(target_nodes=subset_primaries)
 ```
 
 In addition, the RedisCluster instance can query the Redis instance of a
@@ -1077,15 +1077,15 @@ specific node and execute commands on that node directly. The Redis client,
 however, does not handle cluster failures and retries.
 
 ``` pycon
-    >>> cluster_node = rc.get_node(host='localhost', port=6379)
-    >>> print(cluster_node)
-    [host=127.0.0.1,port=6379,name=127.0.0.1:6379,server_type=primary,redis_connection=Redis<ConnectionPool<Connection<host=127.0.0.1,port=6379,db=0>>>]
-    >>> r = cluster_node.redis_connection
-    >>> r.client_list()
-    [{'id': '276', 'addr': '127.0.0.1:64108', 'fd': '16', 'name': '', 'age': '0', 'idle': '0', 'flags': 'N', 'db': '0', 'sub': '0', 'psub': '0', 'multi': '-1', 'qbuf': '26', 'qbuf-free': '32742', 'argv-mem': '10', 'obl': '0', 'oll': '0', 'omem': '0', 'tot-mem': '54298', 'events': 'r', 'cmd': 'client', 'user': 'default'}]
-    >>> # Get the keys only for that specific node
-    >>> r.keys()
-    [b'foo1']
+>>> cluster_node = rc.get_node(host='localhost', port=6379)
+>>> print(cluster_node)
+[host=127.0.0.1,port=6379,name=127.0.0.1:6379,server_type=primary,redis_connection=Redis<ConnectionPool<Connection<host=127.0.0.1,port=6379,db=0>>>]
+>>> r = cluster_node.redis_connection
+>>> r.client_list()
+[{'id': '276', 'addr': '127.0.0.1:64108', 'fd': '16', 'name': '', 'age': '0', 'idle': '0', 'flags': 'N', 'db': '0', 'sub': '0', 'psub': '0', 'multi': '-1', 'qbuf': '26', 'qbuf-free': '32742', 'argv-mem': '10', 'obl': '0', 'oll': '0', 'omem': '0', 'tot-mem': '54298', 'events': 'r', 'cmd': 'client', 'user': 'default'}]
+>>> # Get the keys only for that specific node
+>>> r.keys()
+[b'foo1']
 ```
 
 **Multi-key commands:**
@@ -1105,14 +1105,14 @@ operations batch the keys according to their hash value, and then each batch is
 sent separately to the slot's owner.
 
 ``` pycon
-    #  Atomic operations can be used when all keys are mapped to the same slot
-    >>> rc.mset({'{foo}1': 'bar1', '{foo}2': 'bar2'})
-    >>> rc.mget('{foo}1', '{foo}2')
-    [b'bar1', b'bar2']
-    # Non-atomic multi-key operations splits the keys into different slots
-    >>> rc.mset_nonatomic({'foo': 'value1', 'bar': 'value2', 'zzz': 'value3')
-    >>> rc.mget_nonatomic('foo', 'bar', 'zzz')
-    [b'value1', b'value2', b'value3']
+# Atomic operations can be used when all keys are mapped to the same slot
+>>> rc.mset({'{foo}1': 'bar1', '{foo}2': 'bar2'})
+>>> rc.mget('{foo}1', '{foo}2')
+[b'bar1', b'bar2']
+# Non-atomic multi-key operations splits the keys into different slots
+>>> rc.mset_nonatomic({'foo': 'value1', 'bar': 'value2', 'zzz': 'value3')
+>>> rc.mget_nonatomic('foo', 'bar', 'zzz')
+[b'value1', b'value2', b'value3']
 ```
 
 **Cluster PubSub:**
@@ -1135,11 +1135,11 @@ See [redis-py-cluster documentation](https://redis-py-cluster.readthedocs.io/en/
  for more.
 
 ``` pycon
-    >>> p1 = rc.pubsub()
-    # p1 connection will be set to the node that holds 'foo' keyslot
-    >>> p1.subscribe('foo')
-    # p2 connection will be set to node 'localhost:6379'
-    >>> p2 = rc.pubsub(rc.get_node('localhost', 6379))
+>>> p1 = rc.pubsub()
+# p1 connection will be set to the node that holds 'foo' keyslot
+>>> p1.subscribe('foo')
+# p2 connection will be set to node 'localhost:6379'
+>>> p2 = rc.pubsub(rc.get_node('localhost', 6379))
 ```
 
 **Read Only Mode**
@@ -1157,20 +1157,20 @@ target_nodes='replicas', and read-write access can be restored by calling the
 readwrite() method.
 
 ``` pycon
-    >>> from cluster import RedisCluster as Redis
-    # Use 'debug' log level to print the node that the command is executed on
-    >>> rc_readonly = Redis(startup_nodes=startup_nodes,
-                    read_from_replicas=True)
-    >>> rc_readonly.set('{foo}1', 'bar1')
-    >>> for i in range(0, 4):
-            # Assigns read command to the slot's hosts in a Round-Robin manner
-    >>>     rc_readonly.get('{foo}1')
-    # set command would be directed only to the slot's primary node
-    >>> rc_readonly.set('{foo}2', 'bar2')
-    # reset READONLY flag
-    >>> rc_readonly.readwrite(target_nodes='replicas')
-    # now the get command would be directed only to the slot's primary node
-    >>> rc_readonly.get('{foo}1')
+>>> from cluster import RedisCluster as Redis
+# Use 'debug' log level to print the node that the command is executed on
+>>> rc_readonly = Redis(startup_nodes=startup_nodes,
+...                     read_from_replicas=True)
+>>> rc_readonly.set('{foo}1', 'bar1')
+>>> for i in range(0, 4):
+...     # Assigns read command to the slot's hosts in a Round-Robin manner
+...     rc_readonly.get('{foo}1')
+# set command would be directed only to the slot's primary node
+>>> rc_readonly.set('{foo}2', 'bar2')
+# reset READONLY flag
+>>> rc_readonly.readwrite(target_nodes='replicas')
+# now the get command would be directed only to the slot's primary node
+>>> rc_readonly.get('{foo}1')
 ```
 
 **Cluster Pipeline**
@@ -1187,16 +1187,17 @@ by significantly reducing the the number of network round trips between the
 client and the server.
 
 ``` pycon
-    >>> with rc.pipeline() as pipe:
-    >>>     pipe.set('foo', 'value1')
-    >>>     pipe.set('bar', 'value2')
-    >>>     pipe.get('foo')
-    >>>     pipe.get('bar')
-    >>>     print(pipe.execute())
-    [True, True, b'value1', b'value2']
-    >>>     pipe.set('foo1', 'bar1').get('foo1').execute()
-    [True, b'bar1']
+>>> with rc.pipeline() as pipe:
+...     pipe.set('foo', 'value1')
+...     pipe.set('bar', 'value2')
+...     pipe.get('foo')
+...     pipe.get('bar')
+...     print(pipe.execute())
+[True, True, b'value1', b'value2']
+...     pipe.set('foo1', 'bar1').get('foo1').execute()
+[True, b'bar1']
 ```
+
 Please note:
 - RedisCluster pipelines currently only support key-based commands.
 - The pipeline gets its 'read_from_replicas' value from the cluster's parameter.

From fa5841e50c242a7584eedda59ea918570adbf729 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 25 Jan 2022 08:58:58 +0200
Subject: [PATCH 0349/1164] redis-unstable cluster docker (#1889)

---
 docker/base/Dockerfile.cluster          |  2 +-
 docker/base/Dockerfile.unstable_cluster |  9 +++++++++
 docker/base/create_cluster.sh           |  6 ++++--
 docker/unstable_cluster/redis.conf      |  4 ++++
 tox.ini                                 | 14 ++++++++++++++
 5 files changed, 32 insertions(+), 3 deletions(-)
 create mode 100644 docker/base/Dockerfile.unstable_cluster
 create mode 100644 docker/unstable_cluster/redis.conf

diff --git a/docker/base/Dockerfile.cluster b/docker/base/Dockerfile.cluster
index 70df5babf0..5d419801fc 100644
--- a/docker/base/Dockerfile.cluster
+++ b/docker/base/Dockerfile.cluster
@@ -6,4 +6,4 @@ RUN chmod +x /create_cluster.sh
 
 EXPOSE 16379 16380 16381 16382 16383 16384
 
-CMD [ "/create_cluster.sh"]
+CMD /create_cluster.sh  16379  16384
diff --git a/docker/base/Dockerfile.unstable_cluster b/docker/base/Dockerfile.unstable_cluster
new file mode 100644
index 0000000000..31e4275d3c
--- /dev/null
+++ b/docker/base/Dockerfile.unstable_cluster
@@ -0,0 +1,9 @@
+# produces redisfab/redis-py-cluster:6.2.6
+FROM redisfab/redis-py:unstable-bionic
+
+COPY create_cluster.sh /create_cluster.sh
+RUN chmod +x /create_cluster.sh
+
+EXPOSE 6372 6373 6374 6375 6376 6377
+
+CMD /create_cluster.sh  6372 6377
diff --git a/docker/base/create_cluster.sh b/docker/base/create_cluster.sh
index 82a79c80da..72332944b3 100644
--- a/docker/base/create_cluster.sh
+++ b/docker/base/create_cluster.sh
@@ -1,7 +1,9 @@
 #! /bin/bash
 mkdir -p /nodes
 touch /nodes/nodemap
-for PORT in $(seq 16379 16384); do
+START_NODE=$1
+END_NODE=$2
+for PORT in `seq ${START_NODE} ${END_NODE}`; do
   mkdir -p /nodes/$PORT
   if [[ -e /redis.conf ]]; then
     cp /redis.conf /nodes/$PORT/redis.conf
@@ -22,5 +24,5 @@ EOF
   fi
   echo 127.0.0.1:$PORT >> /nodes/nodemap
 done
-echo yes | redis-cli --cluster create $(seq -f 127.0.0.1:%g 16379 16384) --cluster-replicas 1
+echo yes | redis-cli --cluster create $(seq -f 127.0.0.1:%g ${START_NODE} ${END_NODE}) --cluster-replicas 1
 tail -f /redis.log
diff --git a/docker/unstable_cluster/redis.conf b/docker/unstable_cluster/redis.conf
new file mode 100644
index 0000000000..f307a63757
--- /dev/null
+++ b/docker/unstable_cluster/redis.conf
@@ -0,0 +1,4 @@
+# Redis Cluster config file will be shared across all nodes.
+# Do not change the following configurations that are already set:
+# port, cluster-enabled, daemonize, logfile, dir
+protected-mode no
diff --git a/tox.ini b/tox.ini
index abebf004ba..0d72f91665 100644
--- a/tox.ini
+++ b/tox.ini
@@ -41,6 +41,19 @@ healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(sock
 volumes =
     bind:rw:{toxinidir}/docker/unstable/redis.conf:/redis.conf
 
+[docker:unstable_cluster]
+name = unstable_cluster
+image = redisfab/redis-py-cluster:unstable-bionic
+ports =
+    6372:6372/tcp
+    6373:6373/tcp
+    6374:6374/tcp
+    6375:6375/tcp
+    6376:6376/tcp
+    6377:6377/tcp
+healtcheck_cmd = python -c "import socket;print(True) if all([0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',port)) for port in range(6372,6377)]) else False"
+volumes =
+    bind:rw:{toxinidir}/docker/cluster/redis.conf:/redis.conf
 
 [docker:sentinel_1]
 name = sentinel_1
@@ -118,6 +131,7 @@ deps =
     -r {toxinidir}/dev_requirements.txt
 docker =
     unstable
+    unstable_cluster
     master
     replica
     sentinel_1

From 039257613f523e6a30736f218ca2d37d2f12320f Mon Sep 17 00:00:00 2001
From: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Date: Tue, 25 Jan 2022 09:01:48 +0200
Subject: [PATCH 0350/1164] Added retry mechanism on socket timeouts when
 connecting to the server (#1895)

---
 redis/connection.py      |  6 +++--
 redis/retry.py           |  6 ++++-
 tests/test_connection.py | 50 +++++++++++++++++++++++++++++++++++++++-
 3 files changed, 58 insertions(+), 4 deletions(-)

diff --git a/redis/connection.py b/redis/connection.py
index 5fdac54c00..508c1961e5 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -604,7 +604,9 @@ def connect(self):
         if self._sock:
             return
         try:
-            sock = self._connect()
+            sock = self.retry.call_with_retry(
+                lambda: self._connect(), lambda error: self.disconnect(error)
+            )
         except socket.timeout:
             raise TimeoutError("Timeout connecting to server")
         except OSError as e:
@@ -721,7 +723,7 @@ def on_connect(self):
             if str_if_bytes(self.read_response()) != "OK":
                 raise ConnectionError("Invalid Database")
 
-    def disconnect(self):
+    def disconnect(self, *args):
         "Disconnects from the Redis server"
         self._parser.on_disconnect()
         if self._sock is None:
diff --git a/redis/retry.py b/redis/retry.py
index 6147fbd9f9..3dced35d24 100644
--- a/redis/retry.py
+++ b/redis/retry.py
@@ -1,3 +1,4 @@
+import socket
 from time import sleep
 
 from redis.exceptions import ConnectionError, TimeoutError
@@ -7,7 +8,10 @@ class Retry:
     """Retry a specific number of times after a failure"""
 
     def __init__(
-        self, backoff, retries, supported_errors=(ConnectionError, TimeoutError)
+        self,
+        backoff,
+        retries,
+        supported_errors=(ConnectionError, TimeoutError, socket.timeout),
     ):
         """
         Initialize a `Retry` object with a `Backoff` object
diff --git a/tests/test_connection.py b/tests/test_connection.py
index d94a815159..d9251c31dc 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -1,10 +1,14 @@
+import socket
 import types
 from unittest import mock
+from unittest.mock import patch
 
 import pytest
 
+from redis.backoff import NoBackoff
 from redis.connection import Connection
-from redis.exceptions import InvalidResponse
+from redis.exceptions import ConnectionError, InvalidResponse, TimeoutError
+from redis.retry import Retry
 from redis.utils import HIREDIS_AVAILABLE
 
 from .conftest import skip_if_server_version_lt
@@ -74,3 +78,47 @@ def test_disconnect__close_OSError(self):
         mock_sock.shutdown.assert_called_once()
         mock_sock.close.assert_called_once()
         assert conn._sock is None
+
+    def clear(self, conn):
+        conn.retry_on_error.clear()
+
+    def test_retry_connect_on_timeout_error(self):
+        """Test that the _connect function is retried in case of a timeout"""
+        conn = Connection(retry_on_timeout=True, retry=Retry(NoBackoff(), 3))
+        origin_connect = conn._connect
+        conn._connect = mock.Mock()
+
+        def mock_connect():
+            # connect only on the last retry
+            if conn._connect.call_count <= 2:
+                raise socket.timeout
+            else:
+                return origin_connect()
+
+        conn._connect.side_effect = mock_connect
+        conn.connect()
+        assert conn._connect.call_count == 3
+        self.clear(conn)
+
+    def test_connect_without_retry_on_os_error(self):
+        """Test that the _connect function is not being retried in case of a OSError"""
+        with patch.object(Connection, "_connect") as _connect:
+            _connect.side_effect = OSError("")
+            conn = Connection(retry_on_timeout=True, retry=Retry(NoBackoff(), 2))
+            with pytest.raises(ConnectionError):
+                conn.connect()
+            assert _connect.call_count == 1
+            self.clear(conn)
+
+    def test_connect_timeout_error_without_retry(self):
+        """Test that the _connect function is not being retried if retry_on_timeout is
+        set to False"""
+        conn = Connection(retry_on_timeout=False)
+        conn._connect = mock.Mock()
+        conn._connect.side_effect = socket.timeout
+
+        with pytest.raises(TimeoutError) as e:
+            conn.connect()
+        assert conn._connect.call_count == 1
+        assert str(e.value) == "Timeout connecting to server"
+        self.clear(conn)

From 9f4bf4b018c9e5c46822cde4dc5db149e46ef1b1 Mon Sep 17 00:00:00 2001
From: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Date: Tue, 25 Jan 2022 11:54:23 +0200
Subject: [PATCH 0351/1164] Increased pubsub's wait_for_messages timeout to
 prevent flaky tests (#1893)

---
 tests/test_pubsub.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index 23af46153f..6456370c26 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -12,7 +12,7 @@
 from .conftest import _get_client, skip_if_redis_enterprise, skip_if_server_version_lt
 
 
-def wait_for_message(pubsub, timeout=0.1, ignore_subscribe_messages=False):
+def wait_for_message(pubsub, timeout=0.5, ignore_subscribe_messages=False):
     now = time.time()
     timeout = now + timeout
     while now < timeout:

From 503a590e66a10c3fad23ffa0df7e71eea8854e37 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 26 Jan 2022 09:09:53 +0200
Subject: [PATCH 0352/1164] Fixing TypeError in GraphCommands.explain (#1901)

---
 redis/commands/graph/commands.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/redis/commands/graph/commands.py b/redis/commands/graph/commands.py
index fa0a9da55f..157f628339 100644
--- a/redis/commands/graph/commands.py
+++ b/redis/commands/graph/commands.py
@@ -135,6 +135,8 @@ def explain(self, query, params=None):
             query = self._build_params_header(params) + query
 
         plan = self.execute_command("GRAPH.EXPLAIN", self.name, query)
+        if isinstance(plan[0], bytes):
+            plan = [b.decode() for b in plan]
         return "\n".join(plan)
 
     def bulk(self, **kwargs):

From fb53a89587d2467cb8253801a9f95c06422e895f Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 26 Jan 2022 13:48:23 +0200
Subject: [PATCH 0353/1164] Fixing AttributeError in UnixDomainSocketConnection
 (#1903)

---
 redis/connection.py | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/redis/connection.py b/redis/connection.py
index 508c1961e5..100f90206d 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -677,12 +677,19 @@ def _error_message(self, exception):
         # args for socket.error can either be (errno, "message")
         # or just "message"
         if len(exception.args) == 1:
-            return f"Error connecting to {self.host}:{self.port}. {exception.args[0]}."
+            try:
+                return f"Error connecting to {self.host}:{self.port}. \
+                        {exception.args[0]}."
+            except AttributeError:
+                return f"Connection Error: {exception.args[0]}"
         else:
-            return (
-                f"Error {exception.args[0]} connecting to "
-                f"{self.host}:{self.port}. {exception.args[1]}."
-            )
+            try:
+                return (
+                    f"Error {exception.args[0]} connecting to "
+                    f"{self.host}:{self.port}. {exception.args[1]}."
+                )
+            except AttributeError:
+                return f"Connection Error: {exception.args[0]}"
 
     def on_connect(self):
         "Initialize the connection, authenticate and select a database"

From 26491dc25bfc88ea5c9b26d18daf38e3227db751 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 26 Jan 2022 16:50:48 +0200
Subject: [PATCH 0354/1164] Fixing AttributeError on some connection errors
 (#1905)

---
 redis/connection.py | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/redis/connection.py b/redis/connection.py
index 100f90206d..891695d31e 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -805,16 +805,19 @@ def can_read(self, timeout=0):
 
     def read_response(self, disable_decoding=False):
         """Read the response from a previously sent command"""
+        try:
+            hosterr = f"{self.host}:{self.port}"
+        except AttributeError:
+            hosterr = "connection"
+
         try:
             response = self._parser.read_response(disable_decoding=disable_decoding)
         except socket.timeout:
             self.disconnect()
-            raise TimeoutError(f"Timeout reading from {self.host}:{self.port}")
+            raise TimeoutError(f"Timeout reading from {hosterr}")
         except OSError as e:
             self.disconnect()
-            raise ConnectionError(
-                f"Error while reading from {self.host}:{self.port}" f" : {e.args}"
-            )
+            raise ConnectionError(f"Error while reading from {hosterr}" f" : {e.args}")
         except BaseException:
             self.disconnect()
             raise

From 9292e56a26e90a833763dabd92d0c848eecc6685 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 26 Jan 2022 16:51:08 +0200
Subject: [PATCH 0355/1164] cluster script fixes to support future cluster
 versions and redis unstable (#1900)

---
 docker/base/Dockerfile.cluster           |  4 +++-
 docker/base/Dockerfile.unstable_cluster  |  4 +++-
 docker/base/Dockerfile.unstable_sentinel | 17 ++++++++++++++
 docker/base/create_cluster.sh            | 28 +++++++++++++++++++-----
 4 files changed, 46 insertions(+), 7 deletions(-)
 create mode 100644 docker/base/Dockerfile.unstable_sentinel

diff --git a/docker/base/Dockerfile.cluster b/docker/base/Dockerfile.cluster
index 5d419801fc..5c246dcf28 100644
--- a/docker/base/Dockerfile.cluster
+++ b/docker/base/Dockerfile.cluster
@@ -6,4 +6,6 @@ RUN chmod +x /create_cluster.sh
 
 EXPOSE 16379 16380 16381 16382 16383 16384
 
-CMD /create_cluster.sh  16379  16384
+ENV START_PORT=16379
+ENV END_PORT=16384
+CMD /create_cluster.sh
diff --git a/docker/base/Dockerfile.unstable_cluster b/docker/base/Dockerfile.unstable_cluster
index 31e4275d3c..2e3ed55371 100644
--- a/docker/base/Dockerfile.unstable_cluster
+++ b/docker/base/Dockerfile.unstable_cluster
@@ -6,4 +6,6 @@ RUN chmod +x /create_cluster.sh
 
 EXPOSE 6372 6373 6374 6375 6376 6377
 
-CMD /create_cluster.sh  6372 6377
+ENV START_PORT=6372
+ENV END_PORT=6377
+CMD ["/create_cluster.sh"]
diff --git a/docker/base/Dockerfile.unstable_sentinel b/docker/base/Dockerfile.unstable_sentinel
new file mode 100644
index 0000000000..fe6d062de8
--- /dev/null
+++ b/docker/base/Dockerfile.unstable_sentinel
@@ -0,0 +1,17 @@
+# produces redisfab/redis-py-sentinel:unstable
+FROM ubuntu:bionic as builder
+RUN apt-get update
+RUN apt-get upgrade -y
+RUN apt-get install -y build-essential git
+RUN mkdir /build
+WORKDIR /build
+RUN git clone https://github.com/redis/redis
+WORKDIR /build/redis
+RUN make
+
+FROM ubuntu:bionic as runner
+COPY --from=builder /build/redis/src/redis-server /usr/bin/redis-server
+COPY --from=builder /build/redis/src/redis-cli /usr/bin/redis-cli
+COPY --from=builder /build/redis/src/redis-sentinel /usr/bin/redis-sentinel
+
+CMD ["redis-sentinel", "/sentinel.conf"]
diff --git a/docker/base/create_cluster.sh b/docker/base/create_cluster.sh
index 72332944b3..fcb1b1cd8d 100644
--- a/docker/base/create_cluster.sh
+++ b/docker/base/create_cluster.sh
@@ -1,9 +1,21 @@
 #! /bin/bash
+
 mkdir -p /nodes
 touch /nodes/nodemap
-START_NODE=$1
-END_NODE=$2
-for PORT in `seq ${START_NODE} ${END_NODE}`; do
+if [ -z ${START_PORT} ]; then
+    START_PORT=16379
+fi
+if [ -z ${END_PORT} ]; then
+    END_PORT=16384
+fi
+if [ ! -z "$3" ]; then
+    START_PORT=$2
+    START_PORT=$3
+fi
+echo "STARTING: ${START_PORT}"
+echo "ENDING: ${END_PORT}"
+
+for PORT in `seq ${START_PORT} ${END_PORT}`; do
   mkdir -p /nodes/$PORT
   if [[ -e /redis.conf ]]; then
     cp /redis.conf /nodes/$PORT/redis.conf
@@ -17,12 +29,18 @@ daemonize yes
 logfile /redis.log
 dir /nodes/$PORT
 EOF
+
+  set -x
   redis-server /nodes/$PORT/redis.conf
   if [ $? -ne 0 ]; then
     echo "Redis failed to start, exiting."
-    exit 3
+    continue
   fi
   echo 127.0.0.1:$PORT >> /nodes/nodemap
 done
-echo yes | redis-cli --cluster create $(seq -f 127.0.0.1:%g ${START_NODE} ${END_NODE}) --cluster-replicas 1
+if [ -z "${REDIS_PASSWORD}" ]; then
+    echo yes | redis-cli --cluster create `seq -f 127.0.0.1:%g ${START_PORT} ${END_PORT}` --cluster-replicas 1
+else
+    echo yes | redis-cli -a ${REDIS_PASSWORD} --cluster create `seq -f 127.0.0.1:%g ${START_PORT} ${END_PORT}` --cluster-replicas 1
+fi
 tail -f /redis.log

From 24cdd70761c7c275d5010f628f83d919bf35fc90 Mon Sep 17 00:00:00 2001
From: Varun Chopra <v@chopraaa.com>
Date: Thu, 27 Jan 2022 12:49:24 +0530
Subject: [PATCH 0356/1164] Fixing LMOVE, BLMOVE returning an incorrect
 response (#1906)

---
 redis/client.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 612f91170a..1317cb6ffc 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -658,8 +658,8 @@ class Redis(RedisModuleCommands, CoreCommands, SentinelCommands):
     RESPONSE_CALLBACKS = {
         **string_keys_to_dict(
             "AUTH COPY EXPIRE EXPIREAT PEXPIRE PEXPIREAT "
-            "HEXISTS HMSET LMOVE BLMOVE MOVE "
-            "MSETNX PERSIST PSETEX RENAMENX SISMEMBER SMOVE SETEX SETNX",
+            "HEXISTS HMSET MOVE MSETNX PERSIST "
+            "PSETEX RENAMENX SISMEMBER SMOVE SETEX SETNX",
             bool,
         ),
         **string_keys_to_dict(

From 42a0114a639fcda7668c64b619d1da288abd8fcd Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 27 Jan 2022 12:12:56 +0200
Subject: [PATCH 0357/1164] Raising ConnectionError on invalid ocsp
 certificates - with status information (#1907)

---
 redis/ocsp.py     |  9 +++++++--
 tests/test_ssl.py | 10 +++++++---
 2 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/redis/ocsp.py b/redis/ocsp.py
index 666c7dcd08..4753434fba 100644
--- a/redis/ocsp.py
+++ b/redis/ocsp.py
@@ -56,9 +56,14 @@ def _check_certificate(issuer_cert, ocsp_bytes, validate=True):
         raise AuthorizationError("you are not authorized to view this ocsp certificate")
     if ocsp_response.response_status == ocsp.OCSPResponseStatus.SUCCESSFUL:
         if ocsp_response.certificate_status != ocsp.OCSPCertStatus.GOOD:
-            return False
+            raise ConnectionError(
+                f'Received an {str(ocsp_response.certificate_status).split(".")[1]} '
+                "ocsp certificate status"
+            )
     else:
-        return False
+        raise ConnectionError(
+            "failed to retrieve a sucessful response from the ocsp responder"
+        )
 
     if ocsp_response.this_update >= datetime.datetime.now():
         raise ConnectionError("ocsp certificate was issued in the future")
diff --git a/tests/test_ssl.py b/tests/test_ssl.py
index 0ae7440daf..ab5d47f293 100644
--- a/tests/test_ssl.py
+++ b/tests/test_ssl.py
@@ -107,7 +107,7 @@ def test_ssl_ocsp_called_withcrypto(self, request):
     def test_valid_ocsp_cert_http(self):
         from redis.ocsp import OCSPVerifier
 
-        hostnames = ["github.com", "aws.amazon.com", "ynet.co.il", "microsoft.com"]
+        hostnames = ["github.com", "aws.amazon.com", "ynet.co.il"]
         for hostname in hostnames:
             context = ssl.create_default_context()
             with socket.create_connection((hostname, 443)) as sock:
@@ -124,7 +124,9 @@ def test_revoked_ocsp_certificate(self):
         with socket.create_connection((hostname, 443)) as sock:
             with context.wrap_socket(sock, server_hostname=hostname) as wrapped:
                 ocsp = OCSPVerifier(wrapped, hostname, 443)
-                assert ocsp.is_valid() is False
+                with pytest.raises(ConnectionError) as e:
+                    assert ocsp.is_valid()
+                    assert "REVOKED" in str(e)
 
     @skip_if_nocryptography()
     def test_unauthorized_ocsp(self):
@@ -147,7 +149,9 @@ def test_ocsp_not_present_in_response(self):
         with socket.create_connection((hostname, 443)) as sock:
             with context.wrap_socket(sock, server_hostname=hostname) as wrapped:
                 ocsp = OCSPVerifier(wrapped, hostname, 443)
-                assert ocsp.is_valid() is False
+                with pytest.raises(ConnectionError) as e:
+                    assert ocsp.is_valid()
+                    assert "from the" in str(e)
 
     @skip_if_nocryptography()
     def test_unauthorized_then_direct(self):

From 45f3934d87780b6161dbf0de92f47b42de5f8864 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 27 Jan 2022 12:13:35 +0200
Subject: [PATCH 0358/1164] 4.1.2 (#1904)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 8b84c2a97a..a44fe620d7 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.1.1",
+    version="4.1.2",
     packages=find_packages(
         include=[
             "redis",

From 1ea842cd5ee1316a84bce2040b3f16e35acf6e1a Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 27 Jan 2022 12:59:37 +0200
Subject: [PATCH 0359/1164] adding cluster env timeout time (#1908)

---
 tests/conftest.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/conftest.py b/tests/conftest.py
index 9ba63d6caa..d9de876933 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -102,7 +102,7 @@ def pytest_sessionstart(session):
         wait_for_cluster_creation(redis_url, cluster_nodes)
 
 
-def wait_for_cluster_creation(redis_url, cluster_nodes, timeout=20):
+def wait_for_cluster_creation(redis_url, cluster_nodes, timeout=60):
     """
     Waits for the cluster creation to complete.
     As soon as all :cluster_nodes: nodes become available, the cluster will be

From 75fe6eb78b6e45100455adcc3b1df9fd033d5fda Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 30 Jan 2022 14:58:23 +0200
Subject: [PATCH 0360/1164] Update changes file with changes since 4.0.0-beta2
 (#1915)

---
 CHANGES | 160 +++++++++++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 152 insertions(+), 8 deletions(-)

diff --git a/CHANGES b/CHANGES
index b4372be34e..d32d52d5da 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,11 +1,155 @@
-# DEPRECATED
-
-This file is historic. Starting with redis-py 4.0.0b1, please see the GitHub releases page at
-https://github.com/redis/redis-py/releases.
-
-------------------------------------------------------------------------------------------------
-
-* (in development)
+* 4.1.2 (Jan 27, 2022)
+    * Invalid OCSP certificates should raise ConnectionError on failed validation (#1907)
+    * Added retry mechanism on socket timeouts when connecting to the server (#1895)
+    * LMOVE, BLMOVE return incorrect responses (#1906)
+    * Fixing AttributeError in UnixDomainSocketConnection (#1903)
+    * Fixing TypeError in GraphCommands.explain (#1901)
+    * For tests, increasing wait time for the cluster (#1908)
+    * Increased pubsub's wait_for_messages timeout to prevent flaky tests (#1893)
+    * README code snippets formatted to highlight properly (#1888)
+    * Fix link in the main page (#1897)
+    * Documentation fixes: JSON Example, SSL Connection Examples, RTD version (#1887)
+    * Direct link to readthedocs (#1885)
+* 4.1.1 (Jan 17, 2022)
+    * Add retries to connections in Sentinel Pools (#1879)
+    * OCSP Stapling Support (#1873)
+    * Define incr/decr as aliases of incrby/decrby (#1874)
+    * FT.CREATE - support MAXTEXTFIELDS, TEMPORARY, NOHL, NOFREQS, SKIPINITIALSCAN (#1847)
+    * Timeseries docs fix (#1877)
+    * get_connection: catch OSError too (#1832)
+    * Set keys var otherwise variable not created (#1853)
+    * Clusters should optionally require full slot coverage (#1845)
+    * Triple quote docstrings in client.py PEP 257 (#1876)
+    * syncing requirements (#1870)
+    * Typo and typing in GraphCommands documentation (#1855)
+    * Allowing poetry and redis-py to install together (#1854)
+    * setup.py: Add project_urls for PyPI (#1867)
+    * Support test with redis unstable docker (#1850)
+    * Connection examples (#1835)
+    * Documentation cleanup (#1841)
+* 4.1.0 (Dec 26, 2021)
+    * OCSP stapling support (#1820)
+    * Support for SELECT (#1825)
+    * Support for specifying error types with retry (#1817)
+    * Support for RESET command since Redis 6.2.0 (#1824)
+    * Support CLIENT TRACKING (#1612)
+    * Support WRITE in CLIENT PAUSE (#1549)
+    * JSON set_file and set_path support (#1818)
+    * Allow ssl_ca_path with rediss:// urls (#1814)
+    * Support for password-encrypted SSL private keys (#1782)
+    * Support SYNC and PSYNC (#1741)
+    * Retry on error exception and timeout fixes (#1821)
+    * Fixing read race condition during pubsub (#1737)
+    * Fixing exception in listen (#1823)
+    * Fixed MovedError, and stopped iterating through startup nodes when slots are fully covered (#1819)
+    * Socket not closing after server disconnect (#1797)
+    * Single sourcing the package version (#1791)
+    * Ensure redis_connect_func is set on uds connection (#1794)
+    * SRTALGO - Skip for redis versions greater than 7.0.0 (#1831)
+    * Documentation updates (#1822)
+    * Add CI action to install package from repository commit hash (#1781) (#1790)
+    * Fix link in lmove docstring (#1793)
+    * Disabling JSON.DEBUG tests (#1787)
+    * Migrated targeted nodes to kwargs in Cluster Mode (#1762)
+    * Added support for MONITOR in clusters (#1756)
+    * Adding ROLE Command (#1610)
+    * Integrate RedisBloom support (#1683)
+    * Adding RedisGraph support (#1556)
+    * Allow overriding connection class via keyword arguments (#1752)
+    * Aggregation LOAD * support for RediSearch (#1735)
+    * Adding cluster, bloom, and graph docs (#1779)
+    * Add packaging to setup_requires, and use >= to play nice to setup.py (fixes #1625) (#1780)
+    * Fixing the license link in the readme (#1778)
+    * Removing distutils from tests (#1773)
+    * Fix cluster ACL tests (#1774)
+    * Improved RedisCluster's reinitialize_steps and documentation (#1765)
+    * Added black and isort (#1734)
+    * Link Documents for all module commands (#1711)
+    * Pyupgrade + flynt + f-strings (#1759)
+    * Remove unused aggregation subclasses in RediSearch (#1754)
+    * Adding RedisCluster client to support Redis Cluster Mode (#1660)
+    * Support RediSearch FT.PROFILE command (#1727)
+    * Adding support for non-decodable commands (#1731)
+    * COMMAND GETKEYS support (#1738)
+    * RedisJSON 2.0.4 behaviour support (#1747)
+    * Removing deprecating distutils (PEP 632) (#1730)
+    * Updating PR template (#1745)
+    * Removing duplication of Script class (#1751)
+    * Splitting documentation for read the docs (#1743)
+    * Improve code coverage for aggregation tests (#1713)
+    * Fixing COMMAND GETKEYS tests (#1750)
+    * GitHub release improvements (#1684)
+* 4.0.2 (Nov 22, 2021)
+    * Restoring Sentinel commands to redis client (#1723)
+    * Better removal of hiredis warning (#1726)
+    * Adding links to redis documents in function calls (#1719)
+* 4.0.1 (Nov 17, 2021)
+    * Removing command on initial connections (#1722)
+    * Removing hiredis warning when not installed (#1721)
+* 4.0.0 (Nov 15, 2021)
+    * FT.EXPLAINCLI intentionally raising NotImplementedError 
+    * Restoring ZRANGE desc for Redis < 6.2.0 (#1697)
+    * Response parsing occasionally fails to parse floats (#1692)
+    * Re-enabling read-the-docs (#1707) 
+    * Call HSET after FT.CREATE to avoid keyspace scan (#1706)
+    * Unit tests fixes for compatibility (#1703)
+    * Improve documentation about Locks (#1701)
+    * Fixes to allow --redis-url to pass through all tests (#1700)
+    * Fix unit tests running against Redis 4.0.0 (#1699)
+    * Search alias test fix (#1695)
+    * Adding RediSearch/RedisJSON tests (#1691)
+    * Updating codecov rules (#1689)
+    * Tests to validate custom JSON decoders (#1681)
+    * Added breaking icon to release drafter (#1702)
+    * Removing dependency on six (#1676)
+    * Re-enable pipeline support for JSON and TimeSeries (#1674)
+    * Export Sentinel, and SSL like other classes (#1671)
+    * Restore zrange functionality for older versions of Redis (#1670)
+    * Fixed garbage collection deadlock (#1578)
+    * Tests to validate built python packages (#1678)
+    * Sleep for flaky search test (#1680)
+    * Test function renames, to match standards (#1679)
+    * Docstring improvements for Redis class (#1675)
+    * Fix georadius tests (#1672) 
+    * Improvements to JSON coverage (#1666)
+    * Add python_requires setuptools check for python > 3.6 (#1656)
+    * SMISMEMBER support (#1667)
+    * Exposing the module version in loaded_modules (#1648)
+    * RedisTimeSeries support (#1652)
+    * Support for json multipath ($) (#1663)
+    * Added boolean parsing to PEXPIRE and PEXPIREAT (#1665)
+    * Add python_requires setuptools check for python > 3.6 (#1656)
+    * Adding vulture for static analysis (#1655)
+    * Starting to clean the docs (#1657)
+    * Update README.md (#1654)
+    * Adding description format for package (#1651)
+    * Publish to pypi as releases are generated with the release drafter (#1647)
+    * Restore actions to prs (#1653)
+    * Fixing the package to include commands (#1649)
+    * Re-enabling codecov as part of CI process (#1646)
+    * Adding support for redisearch (#1640) Thanks @chayim
+    * redisjson support (#1636) Thanks @chayim
+    * Sentinel: Add SentinelManagedSSLConnection (#1419) Thanks @AbdealiJK
+    * Enable floating parameters in SET (ex and px) (#1635) Thanks @AvitalFineRedis
+    * Add warning when hiredis not installed. Recommend installation. (#1621) Thanks @adiamzn
+    * Raising NotImplementedError for SCRIPT DEBUG and DEBUG SEGFAULT (#1624) Thanks @chayim
+    * CLIENT REDIR command support (#1623) Thanks @chayim
+    * REPLICAOF command implementation (#1622) Thanks @chayim
+    * Add support to NX XX and CH to GEOADD (#1605) Thanks @AvitalFineRedis
+    * Add support to ZRANGE and ZRANGESTORE parameters (#1603) Thanks @AvitalFineRedis
+    * Pre 6.2 redis should default to None for script flush (#1641) Thanks @chayim
+    * Add FULL option to XINFO SUMMARY (#1638) Thanks @agusdmb
+    * Geosearch test should use any=True (#1594) Thanks @Andrew-Chen-Wang
+    * Removing packaging dependency (#1626) Thanks @chayim
+    * Fix client_kill_filter docs for skimpy (#1596) Thanks @Andrew-Chen-Wang
+    * Normalize minid and maxlen docs (#1593) Thanks @Andrew-Chen-Wang
+    * Update docs for multiple usernames for ACL DELUSER (#1595) Thanks @Andrew-Chen-Wang
+    * Fix grammar of get param in set command (#1588) Thanks @Andrew-Chen-Wang
+    * Fix docs for client_kill_filter (#1584) Thanks @Andrew-Chen-Wang
+    * Convert README & CONTRIBUTING from rst to md (#1633) Thanks @davidylee
+    * Test BYLEX param in zrangestore (#1634) Thanks @AvitalFineRedis
+    * Tox integrations with invoke and docker (#1632) Thanks @chayim
+    * Adding the release drafter to help simplify release notes (#1618). Thanks @chayim
     * BACKWARDS INCOMPATIBLE: Removed support for end of life Python 2.7. #1318
     * BACKWARDS INCOMPATIBLE: All values within Redis URLs are unquoted via
       urllib.parse.unquote. Prior versions of redis-py supported this by

From 8499adc46132638c4761c4885f13da8e96d0a944 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 30 Jan 2022 14:58:33 +0200
Subject: [PATCH 0361/1164] Fixing volume for unstable_cluster docker (#1914)

---
 tox.ini | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tox.ini b/tox.ini
index 0d72f91665..5fbf6cd8a1 100644
--- a/tox.ini
+++ b/tox.ini
@@ -53,7 +53,7 @@ ports =
     6377:6377/tcp
 healtcheck_cmd = python -c "import socket;print(True) if all([0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',port)) for port in range(6372,6377)]) else False"
 volumes =
-    bind:rw:{toxinidir}/docker/cluster/redis.conf:/redis.conf
+    bind:rw:{toxinidir}/docker/unstable_cluster/redis.conf:/redis.conf
 
 [docker:sentinel_1]
 name = sentinel_1

From eaa88ce67f708d2dc1d5235526d03f41fc4cae7c Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 2 Feb 2022 12:48:11 +0200
Subject: [PATCH 0362/1164] Change json.clear test multi to be up to date with
 redisjson (#1922)

* fix json clear test

* fix json clear test
---
 tests/test_json.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/test_json.py b/tests/test_json.py
index 6980e67398..21bdc08b5e 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -905,10 +905,10 @@ def test_clear_dollar(client):
         },
     )
     # Test multi
-    assert client.json().clear("doc1", "$..a") == 3
+    assert client.json().clear("doc1", "$..a") == 4
 
     assert client.json().get("doc1", "$") == [
-        {"nested1": {"a": {}}, "a": [], "nested2": {"a": "claro"}, "nested3": {"a": {}}}
+        {"nested1": {"a": {}}, "a": [], "nested2": {"a": ""}, "nested3": {"a": {}}}
     ]
 
     # Test single

From c3c0b0b995f22fe0384e01713a103d6fef8c8568 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 2 Feb 2022 12:49:18 +0200
Subject: [PATCH 0363/1164] Add support for BZMPOP (#1851)

* add bzmpop

* add comment

* fix pr comment

* fix linters

* fix pr comments
---
 redis/commands/core.py | 33 +++++++++++++++++++++++++++++++++
 tests/test_commands.py | 13 +++++++++++++
 2 files changed, 46 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 73003e7fb6..17194c341f 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -2,6 +2,7 @@
 import hashlib
 import time
 import warnings
+from typing import List, Optional
 
 from redis.exceptions import ConnectionError, DataError, NoScriptError, RedisError
 
@@ -3237,6 +3238,38 @@ def bzpopmin(self, keys, timeout=0):
         keys.append(timeout)
         return self.execute_command("BZPOPMIN", *keys)
 
+    def bzmpop(
+        self,
+        timeout: float,
+        numkeys: int,
+        keys: List[str],
+        min: Optional[bool] = False,
+        max: Optional[bool] = False,
+        count: Optional[int] = 1,
+    ) -> Optional[list]:
+        """
+        Pop ``count`` values (default 1) off of the first non-empty sorted set
+        named in the ``keys`` list.
+
+        If none of the sorted sets in ``keys`` has a value to pop,
+        then block for ``timeout`` seconds, or until a member gets added
+        to one of the sorted sets.
+
+        If timeout is 0, then block indefinitely.
+
+        For more information check https://redis.io/commands/bzmpop
+        """
+        args = [timeout, numkeys, *keys]
+        if (min and max) or (not min and not max):
+            raise DataError("Either min or max, but not both must be set")
+        elif min:
+            args.append("MIN")
+        else:
+            args.append("MAX")
+        args.extend(["COUNT", count])
+
+        return self.execute_command("BZMPOP", *args)
+
     def _zrange(
         self,
         command,
diff --git a/tests/test_commands.py b/tests/test_commands.py
index b28b63ea6e..937172a195 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2058,6 +2058,19 @@ def test_bzpopmin(self, r):
         r.zadd("c", {"c1": 100})
         assert r.bzpopmin("c", timeout=1) == (b"c", b"c1", 100)
 
+    @pytest.mark.onlynoncluster
+    # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
+    def test_bzmpop(self, unstable_r):
+        unstable_r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        res = [b"a", [[b"a1", b"1"], [b"a2", b"2"]]]
+        assert unstable_r.bzmpop(1, "2", ["b", "a"], min=True, count=2) == res
+        with pytest.raises(redis.DataError):
+            unstable_r.bzmpop(1, "2", ["b", "a"], count=2)
+        unstable_r.zadd("b", {"b1": 10, "ab": 9, "b3": 8})
+        res = [b"b", [[b"b1", b"10"]]]
+        assert unstable_r.bzmpop(0, "2", ["b", "a"], max=True) == res
+        assert unstable_r.bzmpop(1, "2", ["foo", "bar"], max=True) is None
+
     def test_zrange(self, r):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
         assert r.zrange("a", 0, 1) == [b"a1", b"a2"]

From 146e58eb3531dc8b7136b88200e6079f50cee4a8 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 2 Feb 2022 12:52:37 +0200
Subject: [PATCH 0364/1164] add client no-evict (#1856)

---
 redis/commands/core.py | 8 ++++++++
 tests/test_commands.py | 7 +++++++
 2 files changed, 15 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 17194c341f..b06bb5c941 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -640,6 +640,14 @@ def client_unpause(self, **kwargs):
         """
         return self.execute_command("CLIENT UNPAUSE", **kwargs)
 
+    def client_no_evict(self, mode: str) -> str:
+        """
+        Sets the client eviction mode for the current connection.
+
+        For more information check https://redis.io/commands/client-no-evict
+        """
+        return self.execute_command("CLIENT NO-EVICT", mode)
+
     def command(self, **kwargs):
         """
         Returns dict reply of details about all Redis commands.
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 937172a195..cdcf1202d8 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -592,6 +592,13 @@ def test_client_pause_all(self, r, r2):
     def test_client_unpause(self, r):
         assert r.client_unpause() == b"OK"
 
+    @pytest.mark.onlynoncluster
+    # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
+    def test_client_no_evict(self, unstable_r):
+        assert unstable_r.client_no_evict("ON") == b"OK"
+        with pytest.raises(TypeError):
+            unstable_r.client_no_evict()
+
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("3.2.0")
     def test_client_reply(self, r, r_timeout):

From e37ebd5f399c294dc7d886448eba62065778f7e9 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 2 Feb 2022 13:20:58 +0200
Subject: [PATCH 0365/1164] Add support for ZINTERCARD (#1857)

* add zintercard

* fix pr comment

* linters
---
 redis/commands/core.py | 13 +++++++++++++
 tests/test_commands.py |  9 +++++++++
 2 files changed, 22 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index b06bb5c941..a4a48f95f1 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3153,6 +3153,19 @@ def zinterstore(self, dest, keys, aggregate=None):
         """
         return self._zaggregate("ZINTERSTORE", dest, keys, aggregate)
 
+    def zintercard(self, numkeys: int, keys: List[str], limit: int = 0) -> int:
+        """
+        Return the cardinality of the intersect of multiple sorted sets
+        specified by ``keys`.
+        When LIMIT provided (defaults to 0 and means unlimited), if the intersection
+        cardinality reaches limit partway through the computation, the algorithm will
+        exit and yield limit as the cardinality
+
+        For more information check https://redis.io/commands/zintercard
+        """
+        args = [numkeys, *keys, "LIMIT", limit]
+        return self.execute_command("ZINTERCARD", *args)
+
     def zlexcount(self, name, min, max):
         """
         Return the number of items in the sorted set ``name`` between the
diff --git a/tests/test_commands.py b/tests/test_commands.py
index cdcf1202d8..f4d7fa73e0 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1979,6 +1979,15 @@ def test_zinter(self, r):
             (b"a1", 23),
         ]
 
+    @pytest.mark.onlynoncluster
+    # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
+    def test_zintercard(self, unstable_r):
+        unstable_r.zadd("a", {"a1": 1, "a2": 2, "a3": 1})
+        unstable_r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
+        unstable_r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
+        assert unstable_r.zintercard(3, ["a", "b", "c"]) == 2
+        assert unstable_r.zintercard(3, ["a", "b", "c"], limit=1) == 1
+
     @pytest.mark.onlynoncluster
     def test_zinterstore_sum(self, r):
         r.zadd("a", {"a1": 1, "a2": 1, "a3": 1})

From 58b28e43410b8e6e554de8f082f83a5835b075a6 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 2 Feb 2022 13:25:42 +0200
Subject: [PATCH 0366/1164] Add support for EVAL_RO (#1862)

* add sort_ro

* mark test as onlynon cluster

* delete mark test as onlynoncluster

* add eval_ro

* fix linters

* delete sort_ro

* fix pr comment

* add type hints

* add type hints

* linters
---
 redis/commands/core.py  | 21 +++++++++++++++++++--
 tests/test_scripting.py |  8 ++++++++
 2 files changed, 27 insertions(+), 2 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index a4a48f95f1..80fad1a716 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3917,7 +3917,12 @@ class ScriptCommands:
     https://redis.com/ebook/part-3-next-steps/chapter-11-scripting-redis-with-lua/
     """
 
-    def eval(self, script, numkeys, *keys_and_args):
+    def _eval(
+        self, command: str, script: str, numkeys: int, *keys_and_args: list
+    ) -> str:
+        return self.execute_command(command, script, numkeys, *keys_and_args)
+
+    def eval(self, script: str, numkeys: int, *keys_and_args: list) -> str:
         """
         Execute the Lua ``script``, specifying the ``numkeys`` the script
         will touch and the key names and argument values in ``keys_and_args``.
@@ -3928,7 +3933,19 @@ def eval(self, script, numkeys, *keys_and_args):
 
         For more information check  https://redis.io/commands/eval
         """
-        return self.execute_command("EVAL", script, numkeys, *keys_and_args)
+        return self._eval("EVAL", script, numkeys, *keys_and_args)
+
+    def eval_ro(self, script: str, numkeys: int, *keys_and_args: list) -> str:
+        """
+        The read-only variant of the EVAL command
+
+        Execute the read-only Lue ``script`` specifying the ``numkeys`` the script
+        will touch and the key names and argument values in ``keys_and_args``.
+        Returns the result of the script.
+
+        For more information check  https://redis.io/commands/eval_ro
+        """
+        return self._eval("EVAL_RO", script, numkeys, *keys_and_args)
 
     def evalsha(self, sha, numkeys, *keys_and_args):
         """
diff --git a/tests/test_scripting.py b/tests/test_scripting.py
index 9f4f82023f..b0d76c7335 100644
--- a/tests/test_scripting.py
+++ b/tests/test_scripting.py
@@ -1,5 +1,6 @@
 import pytest
 
+import redis
 from redis import exceptions
 from tests.conftest import skip_if_server_version_lt
 
@@ -31,6 +32,13 @@ def test_eval(self, r):
         # 2 * 3 == 6
         assert r.eval(multiply_script, 1, "a", 3) == 6
 
+    # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
+    def test_eval_ro(self, unstable_r):
+        unstable_r.set("a", "b")
+        assert unstable_r.eval_ro("return redis.call('GET', KEYS[1])", 1, "a") == b"b"
+        with pytest.raises(redis.ResponseError):
+            unstable_r.eval_ro("return redis.call('DEL', KEYS[1])", 1, "a")
+
     @skip_if_server_version_lt("6.2.0")
     def test_script_flush_620(self, r):
         r.set("a", 2)

From 7f7f4f6c85c2d05e1810b512890ec42f64ffa0b3 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 2 Feb 2022 13:26:00 +0200
Subject: [PATCH 0367/1164] Add support for EVALSHA_RO (#1863)

* add evalsha-ro

* fix pr comment

* add type hints

* add type hints
---
 redis/commands/core.py  | 22 ++++++++++++++++++++--
 tests/test_scripting.py |  9 +++++++++
 2 files changed, 29 insertions(+), 2 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 80fad1a716..383c635aea 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3947,7 +3947,12 @@ def eval_ro(self, script: str, numkeys: int, *keys_and_args: list) -> str:
         """
         return self._eval("EVAL_RO", script, numkeys, *keys_and_args)
 
-    def evalsha(self, sha, numkeys, *keys_and_args):
+    def _evalsha(
+        self, command: str, sha: str, numkeys: int, *keys_and_args: list
+    ) -> str:
+        return self.execute_command(command, sha, numkeys, *keys_and_args)
+
+    def evalsha(self, sha: str, numkeys: int, *keys_and_args: list) -> str:
         """
         Use the ``sha`` to execute a Lua script already registered via EVAL
         or SCRIPT LOAD. Specify the ``numkeys`` the script will touch and the
@@ -3959,7 +3964,20 @@ def evalsha(self, sha, numkeys, *keys_and_args):
 
         For more information check  https://redis.io/commands/evalsha
         """
-        return self.execute_command("EVALSHA", sha, numkeys, *keys_and_args)
+        return self._evalsha("EVALSHA", sha, numkeys, *keys_and_args)
+
+    def evalsha_ro(self, sha: str, numkeys: int, *keys_and_args: list) -> str:
+        """
+        The read-only variant of the EVALSHA command
+
+        Use the ``sha`` to execute a read-only Lua script already registered via EVAL
+        or SCRIPT LOAD. Specify the ``numkeys`` the script will touch and the
+        key names and argument values in ``keys_and_args``. Returns the result
+        of the script.
+
+        For more information check  https://redis.io/commands/evalsha_ro
+        """
+        return self._evalsha("EVALSHA_RO", sha, numkeys, *keys_and_args)
 
     def script_exists(self, *args):
         """
diff --git a/tests/test_scripting.py b/tests/test_scripting.py
index b0d76c7335..f4671a5f9a 100644
--- a/tests/test_scripting.py
+++ b/tests/test_scripting.py
@@ -74,6 +74,15 @@ def test_evalsha(self, r):
         # 2 * 3 == 6
         assert r.evalsha(sha, 1, "a", 3) == 6
 
+    # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
+    def test_evalsha_ro(self, unstable_r):
+        unstable_r.set("a", "b")
+        get_sha = unstable_r.script_load("return redis.call('GET', KEYS[1])")
+        del_sha = unstable_r.script_load("return redis.call('DEL', KEYS[1])")
+        assert unstable_r.evalsha_ro(get_sha, 1, "a") == b"b"
+        with pytest.raises(redis.ResponseError):
+            unstable_r.evalsha_ro(del_sha, 1, "a")
+
     def test_evalsha_script_not_loaded(self, r):
         r.set("a", 2)
         sha = r.script_load(multiply_script)

From 7ea1bf7593f72b5e23f7e4efc7890faec8a3dde5 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 2 Feb 2022 13:26:29 +0200
Subject: [PATCH 0368/1164] Fix naming conventions (#1872)

* fix naming convention

* fix worng changes
---
 redis/commands/bf/__init__.py            |  22 ++--
 redis/commands/bf/commands.py            |  42 +++---
 redis/commands/graph/__init__.py         |  20 +--
 redis/commands/graph/edge.py             |   2 +-
 redis/commands/graph/node.py             |   2 +-
 redis/commands/graph/query_result.py     |   4 +-
 redis/commands/helpers.py                |   2 +-
 redis/commands/json/commands.py          |  28 ++--
 redis/commands/json/path.py              |   2 +-
 redis/commands/search/commands.py        |   6 +-
 redis/commands/search/indexDefinition.py |  24 ++--
 redis/commands/timeseries/commands.py    | 100 +++++++-------
 tests/test_graph.py                      |  12 +-
 tests/test_graph_utils/test_edge.py      |   6 +-
 tests/test_graph_utils/test_node.py      |  12 +-
 tests/test_json.py                       | 160 +++++++++++------------
 tests/test_search.py                     |  16 +--
 17 files changed, 230 insertions(+), 230 deletions(-)

diff --git a/redis/commands/bf/__init__.py b/redis/commands/bf/__init__.py
index f34e11d9bb..d62d8a0d83 100644
--- a/redis/commands/bf/__init__.py
+++ b/redis/commands/bf/__init__.py
@@ -18,70 +18,70 @@ class AbstractBloom(object):
     """
 
     @staticmethod
-    def appendItems(params, items):
+    def append_items(params, items):
         """Append ITEMS to params."""
         params.extend(["ITEMS"])
         params += items
 
     @staticmethod
-    def appendError(params, error):
+    def append_error(params, error):
         """Append ERROR to params."""
         if error is not None:
             params.extend(["ERROR", error])
 
     @staticmethod
-    def appendCapacity(params, capacity):
+    def append_capacity(params, capacity):
         """Append CAPACITY to params."""
         if capacity is not None:
             params.extend(["CAPACITY", capacity])
 
     @staticmethod
-    def appendExpansion(params, expansion):
+    def append_expansion(params, expansion):
         """Append EXPANSION to params."""
         if expansion is not None:
             params.extend(["EXPANSION", expansion])
 
     @staticmethod
-    def appendNoScale(params, noScale):
+    def append_no_scale(params, noScale):
         """Append NONSCALING tag to params."""
         if noScale is not None:
             params.extend(["NONSCALING"])
 
     @staticmethod
-    def appendWeights(params, weights):
+    def append_weights(params, weights):
         """Append WEIGHTS to params."""
         if len(weights) > 0:
             params.append("WEIGHTS")
             params += weights
 
     @staticmethod
-    def appendNoCreate(params, noCreate):
+    def append_no_create(params, noCreate):
         """Append NOCREATE tag to params."""
         if noCreate is not None:
             params.extend(["NOCREATE"])
 
     @staticmethod
-    def appendItemsAndIncrements(params, items, increments):
+    def append_items_and_increments(params, items, increments):
         """Append pairs of items and increments to params."""
         for i in range(len(items)):
             params.append(items[i])
             params.append(increments[i])
 
     @staticmethod
-    def appendValuesAndWeights(params, items, weights):
+    def append_values_and_weights(params, items, weights):
         """Append pairs of items and weights to params."""
         for i in range(len(items)):
             params.append(items[i])
             params.append(weights[i])
 
     @staticmethod
-    def appendMaxIterations(params, max_iterations):
+    def append_max_iterations(params, max_iterations):
         """Append MAXITERATIONS to params."""
         if max_iterations is not None:
             params.extend(["MAXITERATIONS", max_iterations])
 
     @staticmethod
-    def appendBucketSize(params, bucket_size):
+    def append_bucket_size(params, bucket_size):
         """Append BUCKETSIZE to params."""
         if bucket_size is not None:
             params.extend(["BUCKETSIZE", bucket_size])
diff --git a/redis/commands/bf/commands.py b/redis/commands/bf/commands.py
index 7fc507d2d9..e911efc621 100644
--- a/redis/commands/bf/commands.py
+++ b/redis/commands/bf/commands.py
@@ -62,8 +62,8 @@ def create(self, key, errorRate, capacity, expansion=None, noScale=None):
         For more information see `BF.RESERVE <https://oss.redis.com/redisbloom/master/Bloom_Commands/#bfreserve>`_.
         """  # noqa
         params = [key, errorRate, capacity]
-        self.appendExpansion(params, expansion)
-        self.appendNoScale(params, noScale)
+        self.append_expansion(params, expansion)
+        self.append_no_scale(params, noScale)
         return self.execute_command(BF_RESERVE, *params)
 
     def add(self, key, item):
@@ -102,12 +102,12 @@ def insert(
         For more information see `BF.INSERT <https://oss.redis.com/redisbloom/master/Bloom_Commands/#bfinsert>`_.
         """  # noqa
         params = [key]
-        self.appendCapacity(params, capacity)
-        self.appendError(params, error)
-        self.appendExpansion(params, expansion)
-        self.appendNoCreate(params, noCreate)
-        self.appendNoScale(params, noScale)
-        self.appendItems(params, items)
+        self.append_capacity(params, capacity)
+        self.append_error(params, error)
+        self.append_expansion(params, expansion)
+        self.append_no_create(params, noCreate)
+        self.append_no_scale(params, noScale)
+        self.append_items(params, items)
 
         return self.execute_command(BF_INSERT, *params)
 
@@ -177,9 +177,9 @@ def create(
         For more information see `CF.RESERVE <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfreserve>`_.
         """  # noqa
         params = [key, capacity]
-        self.appendExpansion(params, expansion)
-        self.appendBucketSize(params, bucket_size)
-        self.appendMaxIterations(params, max_iterations)
+        self.append_expansion(params, expansion)
+        self.append_bucket_size(params, bucket_size)
+        self.append_max_iterations(params, max_iterations)
         return self.execute_command(CF_RESERVE, *params)
 
     def add(self, key, item):
@@ -207,9 +207,9 @@ def insert(self, key, items, capacity=None, nocreate=None):
         For more information see `CF.INSERT <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfinsert>`_.
         """  # noqa
         params = [key]
-        self.appendCapacity(params, capacity)
-        self.appendNoCreate(params, nocreate)
-        self.appendItems(params, items)
+        self.append_capacity(params, capacity)
+        self.append_no_create(params, nocreate)
+        self.append_items(params, items)
         return self.execute_command(CF_INSERT, *params)
 
     def insertnx(self, key, items, capacity=None, nocreate=None):
@@ -220,9 +220,9 @@ def insertnx(self, key, items, capacity=None, nocreate=None):
         For more information see `CF.INSERTNX <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfinsertnx>`_.
         """  # noqa
         params = [key]
-        self.appendCapacity(params, capacity)
-        self.appendNoCreate(params, nocreate)
-        self.appendItems(params, items)
+        self.append_capacity(params, capacity)
+        self.append_no_create(params, nocreate)
+        self.append_items(params, items)
         return self.execute_command(CF_INSERTNX, *params)
 
     def exists(self, key, item):
@@ -315,7 +315,7 @@ def incrby(self, key, items, increments):
         >>> topkincrby('A', ['foo'], [1])
         """  # noqa
         params = [key]
-        self.appendItemsAndIncrements(params, items, increments)
+        self.append_items_and_increments(params, items, increments)
         return self.execute_command(TOPK_INCRBY, *params)
 
     def query(self, key, *items):
@@ -383,7 +383,7 @@ def add(self, key, values, weights):
         >>> tdigestadd('A', [1500.0], [1.0])
         """  # noqa
         params = [key]
-        self.appendValuesAndWeights(params, values, weights)
+        self.append_values_and_weights(params, values, weights)
         return self.execute_command(TDIGEST_ADD, *params)
 
     def merge(self, toKey, fromKey):
@@ -465,7 +465,7 @@ def incrby(self, key, items, increments):
         >>> cmsincrby('A', ['foo'], [1])
         """  # noqa
         params = [key]
-        self.appendItemsAndIncrements(params, items, increments)
+        self.append_items_and_increments(params, items, increments)
         return self.execute_command(CMS_INCRBY, *params)
 
     def query(self, key, *items):
@@ -487,7 +487,7 @@ def merge(self, destKey, numKeys, srcKeys, weights=[]):
         """  # noqa
         params = [destKey, numKeys]
         params += srcKeys
-        self.appendWeights(params, weights)
+        self.append_weights(params, weights)
         return self.execute_command(CMS_MERGE, *params)
 
     def info(self, key):
diff --git a/redis/commands/graph/__init__.py b/redis/commands/graph/__init__.py
index 7b9972ad9b..3736195007 100644
--- a/redis/commands/graph/__init__.py
+++ b/redis/commands/graph/__init__.py
@@ -22,7 +22,7 @@ def __init__(self, client, name=random_string()):
         self.edges = []
         self._labels = []  # List of node labels.
         self._properties = []  # List of properties.
-        self._relationshipTypes = []  # List of relation types.
+        self._relationship_types = []  # List of relation types.
         self.version = 0  # Graph version
 
     @property
@@ -32,7 +32,7 @@ def name(self):
     def _clear_schema(self):
         self._labels = []
         self._properties = []
-        self._relationshipTypes = []
+        self._relationship_types = []
 
     def _refresh_schema(self):
         self._clear_schema()
@@ -49,15 +49,15 @@ def _refresh_labels(self):
             self._labels[i] = l[0]
 
     def _refresh_relations(self):
-        rels = self.relationshipTypes()
+        rels = self.relationship_types()
 
         # Unpack data.
-        self._relationshipTypes = [None] * len(rels)
+        self._relationship_types = [None] * len(rels)
         for i, r in enumerate(rels):
-            self._relationshipTypes[i] = r[0]
+            self._relationship_types[i] = r[0]
 
     def _refresh_attributes(self):
-        props = self.propertyKeys()
+        props = self.property_keys()
 
         # Unpack data.
         self._properties = [None] * len(props)
@@ -91,11 +91,11 @@ def get_relation(self, idx):
             The index of the relation
         """
         try:
-            relationship_type = self._relationshipTypes[idx]
+            relationship_type = self._relationship_types[idx]
         except IndexError:
             # Refresh relationship types.
             self._refresh_relations()
-            relationship_type = self._relationshipTypes[idx]
+            relationship_type = self._relationship_types[idx]
         return relationship_type
 
     def get_property(self, idx):
@@ -155,8 +155,8 @@ def call_procedure(self, procedure, *args, read_only=False, **kwagrs):
     def labels(self):
         return self.call_procedure("db.labels", read_only=True).result_set
 
-    def relationshipTypes(self):
+    def relationship_types(self):
         return self.call_procedure("db.relationshipTypes", read_only=True).result_set
 
-    def propertyKeys(self):
+    def property_keys(self):
         return self.call_procedure("db.propertyKeys", read_only=True).result_set
diff --git a/redis/commands/graph/edge.py b/redis/commands/graph/edge.py
index b334293fb2..b0141d9452 100644
--- a/redis/commands/graph/edge.py
+++ b/redis/commands/graph/edge.py
@@ -22,7 +22,7 @@ def __init__(self, src_node, relation, dest_node, edge_id=None, properties=None)
         self.src_node = src_node
         self.dest_node = dest_node
 
-    def toString(self):
+    def to_string(self):
         res = ""
         if self.properties:
             props = ",".join(
diff --git a/redis/commands/graph/node.py b/redis/commands/graph/node.py
index 47e4eeb8e2..c5f842906b 100644
--- a/redis/commands/graph/node.py
+++ b/redis/commands/graph/node.py
@@ -37,7 +37,7 @@ def __init__(self, node_id=None, alias=None, label=None, properties=None):
 
         self.properties = properties or {}
 
-    def toString(self):
+    def to_string(self):
         res = ""
         if self.properties:
             props = ",".join(
diff --git a/redis/commands/graph/query_result.py b/redis/commands/graph/query_result.py
index e9d9f4d3fd..644ac5a3db 100644
--- a/redis/commands/graph/query_result.py
+++ b/redis/commands/graph/query_result.py
@@ -292,9 +292,9 @@ def parse_profile(self, response):
     #             record = []
     #             for idx, cell in enumerate(row):
     #                 if type(cell) is Node:
-    #                     record.append(cell.toString())
+    #                     record.append(cell.to_string())
     #                 elif type(cell) is Edge:
-    #                     record.append(cell.toString())
+    #                     record.append(cell.to_string())
     #                 else:
     #                     record.append(cell)
     #             tbl.add_row(record)
diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
index afb4f9fae8..2b873e3385 100644
--- a/redis/commands/helpers.py
+++ b/redis/commands/helpers.py
@@ -117,7 +117,7 @@ def quote_string(v):
     return f'"{v}"'
 
 
-def decodeDictKeys(obj):
+def decode_dict_keys(obj):
     """Decode the keys of the given dictionary with utf-8."""
     newobj = copy.copy(obj)
     for k in obj.keys():
diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index a132b8ee8d..03ab0c4b8d 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -12,7 +12,7 @@
 class JSONCommands:
     """json commands."""
 
-    def arrappend(self, name, path=Path.rootPath(), *args):
+    def arrappend(self, name, path=Path.root_path(), *args):
         """Append the objects ``args`` to the array under the
         ``path` in key ``name``.
 
@@ -48,7 +48,7 @@ def arrinsert(self, name, path, index, *args):
             pieces.append(self._encode(o))
         return self.execute_command("JSON.ARRINSERT", *pieces)
 
-    def arrlen(self, name, path=Path.rootPath()):
+    def arrlen(self, name, path=Path.root_path()):
         """Return the length of the array JSON value under ``path``
         at key``name``.
 
@@ -56,7 +56,7 @@ def arrlen(self, name, path=Path.rootPath()):
         """  # noqa
         return self.execute_command("JSON.ARRLEN", name, str(path))
 
-    def arrpop(self, name, path=Path.rootPath(), index=-1):
+    def arrpop(self, name, path=Path.root_path(), index=-1):
         """Pop the element at ``index`` in the array JSON value under
         ``path`` at key ``name``.
 
@@ -72,21 +72,21 @@ def arrtrim(self, name, path, start, stop):
         """  # noqa
         return self.execute_command("JSON.ARRTRIM", name, str(path), start, stop)
 
-    def type(self, name, path=Path.rootPath()):
+    def type(self, name, path=Path.root_path()):
         """Get the type of the JSON value under ``path`` from key ``name``.
 
         For more information: https://oss.redis.com/redisjson/commands/#jsontype
         """  # noqa
         return self.execute_command("JSON.TYPE", name, str(path))
 
-    def resp(self, name, path=Path.rootPath()):
+    def resp(self, name, path=Path.root_path()):
         """Return the JSON value under ``path`` at key ``name``.
 
         For more information: https://oss.redis.com/redisjson/commands/#jsonresp
         """  # noqa
         return self.execute_command("JSON.RESP", name, str(path))
 
-    def objkeys(self, name, path=Path.rootPath()):
+    def objkeys(self, name, path=Path.root_path()):
         """Return the key names in the dictionary JSON value under ``path`` at
         key ``name``.
 
@@ -94,7 +94,7 @@ def objkeys(self, name, path=Path.rootPath()):
         """  # noqa
         return self.execute_command("JSON.OBJKEYS", name, str(path))
 
-    def objlen(self, name, path=Path.rootPath()):
+    def objlen(self, name, path=Path.root_path()):
         """Return the length of the dictionary JSON value under ``path`` at key
         ``name``.
 
@@ -123,7 +123,7 @@ def nummultby(self, name, path, number):
             "JSON.NUMMULTBY", name, str(path), self._encode(number)
         )
 
-    def clear(self, name, path=Path.rootPath()):
+    def clear(self, name, path=Path.root_path()):
         """
         Empty arrays and objects (to have zero slots/keys without deleting the
         array/object).
@@ -135,7 +135,7 @@ def clear(self, name, path=Path.rootPath()):
         """  # noqa
         return self.execute_command("JSON.CLEAR", name, str(path))
 
-    def delete(self, key, path=Path.rootPath()):
+    def delete(self, key, path=Path.root_path()):
         """Delete the JSON value stored at key ``key`` under ``path``.
 
         For more information: https://oss.redis.com/redisjson/commands/#jsondel
@@ -160,7 +160,7 @@ def get(self, name, *args, no_escape=False):
             pieces.append("noescape")
 
         if len(args) == 0:
-            pieces.append(Path.rootPath())
+            pieces.append(Path.root_path())
 
         else:
             for p in args:
@@ -275,7 +275,7 @@ def strlen(self, name, path=None):
             pieces.append(str(path))
         return self.execute_command("JSON.STRLEN", *pieces)
 
-    def toggle(self, name, path=Path.rootPath()):
+    def toggle(self, name, path=Path.root_path()):
         """Toggle boolean value under ``path`` at key ``name``.
         returning the new value.
 
@@ -283,17 +283,17 @@ def toggle(self, name, path=Path.rootPath()):
         """  # noqa
         return self.execute_command("JSON.TOGGLE", name, str(path))
 
-    def strappend(self, name, value, path=Path.rootPath()):
+    def strappend(self, name, value, path=Path.root_path()):
         """Append to the string JSON value. If two options are specified after
         the key name, the path is determined to be the first. If a single
-        option is passed, then the rootpath (i.e Path.rootPath()) is used.
+        option is passed, then the root_path (i.e Path.root_path()) is used.
 
         For more information: https://oss.redis.com/redisjson/commands/#jsonstrappend
         """  # noqa
         pieces = [name, str(path), self._encode(value)]
         return self.execute_command("JSON.STRAPPEND", *pieces)
 
-    def debug(self, subcommand, key=None, path=Path.rootPath()):
+    def debug(self, subcommand, key=None, path=Path.root_path()):
         """Return the memory usage in bytes of a value under ``path`` from
         key ``name``.
 
diff --git a/redis/commands/json/path.py b/redis/commands/json/path.py
index f0a413a00d..bfb0ab2db0 100644
--- a/redis/commands/json/path.py
+++ b/redis/commands/json/path.py
@@ -4,7 +4,7 @@ class Path:
     strPath = ""
 
     @staticmethod
-    def rootPath():
+    def root_path():
         """Return the root path's string representation."""
         return "."
 
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 3f768ab320..94edea168c 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -447,9 +447,9 @@ def aggregate(self, query):
             raise ValueError("Bad query", query)
 
         raw = self.execute_command(*cmd)
-        return self._get_AggregateResult(raw, query, has_cursor)
+        return self._get_aggregate_result(raw, query, has_cursor)
 
-    def _get_AggregateResult(self, raw, query, has_cursor):
+    def _get_aggregate_result(self, raw, query, has_cursor):
         if has_cursor:
             if isinstance(query, Cursor):
                 query.cid = raw[1]
@@ -499,7 +499,7 @@ def profile(self, query, limited=False):
         res = self.execute_command(*cmd)
 
         if isinstance(query, AggregateRequest):
-            result = self._get_AggregateResult(res[0], query, query._cursor)
+            result = self._get_aggregate_result(res[0], query, query._cursor)
         else:
             result = Result(
                 res[0],
diff --git a/redis/commands/search/indexDefinition.py b/redis/commands/search/indexDefinition.py
index 0c7a3b0635..a668e85b42 100644
--- a/redis/commands/search/indexDefinition.py
+++ b/redis/commands/search/indexDefinition.py
@@ -24,14 +24,14 @@ def __init__(
         index_type=None,
     ):
         self.args = []
-        self._appendIndexType(index_type)
-        self._appendPrefix(prefix)
-        self._appendFilter(filter)
-        self._appendLanguage(language_field, language)
-        self._appendScore(score_field, score)
-        self._appendPayload(payload_field)
+        self._append_index_type(index_type)
+        self._append_prefix(prefix)
+        self._append_filter(filter)
+        self._append_language(language_field, language)
+        self._append_score(score_field, score)
+        self._append_payload(payload_field)
 
-    def _appendIndexType(self, index_type):
+    def _append_index_type(self, index_type):
         """Append `ON HASH` or `ON JSON` according to the enum."""
         if index_type is IndexType.HASH:
             self.args.extend(["ON", "HASH"])
@@ -40,7 +40,7 @@ def _appendIndexType(self, index_type):
         elif index_type is not None:
             raise RuntimeError(f"index_type must be one of {list(IndexType)}")
 
-    def _appendPrefix(self, prefix):
+    def _append_prefix(self, prefix):
         """Append PREFIX."""
         if len(prefix) > 0:
             self.args.append("PREFIX")
@@ -48,13 +48,13 @@ def _appendPrefix(self, prefix):
             for p in prefix:
                 self.args.append(p)
 
-    def _appendFilter(self, filter):
+    def _append_filter(self, filter):
         """Append FILTER."""
         if filter is not None:
             self.args.append("FILTER")
             self.args.append(filter)
 
-    def _appendLanguage(self, language_field, language):
+    def _append_language(self, language_field, language):
         """Append LANGUAGE_FIELD and LANGUAGE."""
         if language_field is not None:
             self.args.append("LANGUAGE_FIELD")
@@ -63,7 +63,7 @@ def _appendLanguage(self, language_field, language):
             self.args.append("LANGUAGE")
             self.args.append(language)
 
-    def _appendScore(self, score_field, score):
+    def _append_score(self, score_field, score):
         """Append SCORE_FIELD and SCORE."""
         if score_field is not None:
             self.args.append("SCORE_FIELD")
@@ -72,7 +72,7 @@ def _appendScore(self, score_field, score):
             self.args.append("SCORE")
             self.args.append(score)
 
-    def _appendPayload(self, payload_field):
+    def _append_payload(self, payload_field):
         """Append PAYLOAD_FIELD."""
         if payload_field is not None:
             self.args.append("PAYLOAD_FIELD")
diff --git a/redis/commands/timeseries/commands.py b/redis/commands/timeseries/commands.py
index c86e0b98b7..3a30c246d5 100644
--- a/redis/commands/timeseries/commands.py
+++ b/redis/commands/timeseries/commands.py
@@ -66,11 +66,11 @@ def create(self, key, **kwargs):
         chunk_size = kwargs.get("chunk_size", None)
         duplicate_policy = kwargs.get("duplicate_policy", None)
         params = [key]
-        self._appendRetention(params, retention_msecs)
-        self._appendUncompressed(params, uncompressed)
-        self._appendChunkSize(params, chunk_size)
-        self._appendDuplicatePolicy(params, CREATE_CMD, duplicate_policy)
-        self._appendLabels(params, labels)
+        self._append_retention(params, retention_msecs)
+        self._append_uncompressed(params, uncompressed)
+        self._append_chunk_size(params, chunk_size)
+        self._append_duplicate_policy(params, CREATE_CMD, duplicate_policy)
+        self._append_labels(params, labels)
 
         return self.execute_command(CREATE_CMD, *params)
 
@@ -87,9 +87,9 @@ def alter(self, key, **kwargs):
         labels = kwargs.get("labels", {})
         duplicate_policy = kwargs.get("duplicate_policy", None)
         params = [key]
-        self._appendRetention(params, retention_msecs)
-        self._appendDuplicatePolicy(params, ALTER_CMD, duplicate_policy)
-        self._appendLabels(params, labels)
+        self._append_retention(params, retention_msecs)
+        self._append_duplicate_policy(params, ALTER_CMD, duplicate_policy)
+        self._append_labels(params, labels)
 
         return self.execute_command(ALTER_CMD, *params)
 
@@ -137,11 +137,11 @@ def add(self, key, timestamp, value, **kwargs):
         chunk_size = kwargs.get("chunk_size", None)
         duplicate_policy = kwargs.get("duplicate_policy", None)
         params = [key, timestamp, value]
-        self._appendRetention(params, retention_msecs)
-        self._appendUncompressed(params, uncompressed)
-        self._appendChunkSize(params, chunk_size)
-        self._appendDuplicatePolicy(params, ADD_CMD, duplicate_policy)
-        self._appendLabels(params, labels)
+        self._append_retention(params, retention_msecs)
+        self._append_uncompressed(params, uncompressed)
+        self._append_chunk_size(params, chunk_size)
+        self._append_duplicate_policy(params, ADD_CMD, duplicate_policy)
+        self._append_labels(params, labels)
 
         return self.execute_command(ADD_CMD, *params)
 
@@ -197,11 +197,11 @@ def incrby(self, key, value, **kwargs):
         labels = kwargs.get("labels", {})
         chunk_size = kwargs.get("chunk_size", None)
         params = [key, value]
-        self._appendTimestamp(params, timestamp)
-        self._appendRetention(params, retention_msecs)
-        self._appendUncompressed(params, uncompressed)
-        self._appendChunkSize(params, chunk_size)
-        self._appendLabels(params, labels)
+        self._append_timestamp(params, timestamp)
+        self._append_retention(params, retention_msecs)
+        self._append_uncompressed(params, uncompressed)
+        self._append_chunk_size(params, chunk_size)
+        self._append_labels(params, labels)
 
         return self.execute_command(INCRBY_CMD, *params)
 
@@ -245,11 +245,11 @@ def decrby(self, key, value, **kwargs):
         labels = kwargs.get("labels", {})
         chunk_size = kwargs.get("chunk_size", None)
         params = [key, value]
-        self._appendTimestamp(params, timestamp)
-        self._appendRetention(params, retention_msecs)
-        self._appendUncompressed(params, uncompressed)
-        self._appendChunkSize(params, chunk_size)
-        self._appendLabels(params, labels)
+        self._append_timestamp(params, timestamp)
+        self._append_retention(params, retention_msecs)
+        self._append_uncompressed(params, uncompressed)
+        self._append_chunk_size(params, chunk_size)
+        self._append_labels(params, labels)
 
         return self.execute_command(DECRBY_CMD, *params)
 
@@ -285,7 +285,7 @@ def createrule(self, source_key, dest_key, aggregation_type, bucket_size_msec):
         For more information: https://oss.redis.com/redistimeseries/master/commands/#tscreaterule
         """  # noqa
         params = [source_key, dest_key]
-        self._appendAggregation(params, aggregation_type, bucket_size_msec)
+        self._append_aggregation(params, aggregation_type, bucket_size_msec)
 
         return self.execute_command(CREATERULE_CMD, *params)
 
@@ -313,11 +313,11 @@ def __range_params(
     ):
         """Create TS.RANGE and TS.REVRANGE arguments."""
         params = [key, from_time, to_time]
-        self._appendFilerByTs(params, filter_by_ts)
-        self._appendFilerByValue(params, filter_by_min_value, filter_by_max_value)
-        self._appendCount(params, count)
-        self._appendAlign(params, align)
-        self._appendAggregation(params, aggregation_type, bucket_size_msec)
+        self._append_filer_by_ts(params, filter_by_ts)
+        self._append_filer_by_value(params, filter_by_min_value, filter_by_max_value)
+        self._append_count(params, count)
+        self._append_align(params, align)
+        self._append_aggregation(params, aggregation_type, bucket_size_msec)
 
         return params
 
@@ -459,15 +459,15 @@ def __mrange_params(
     ):
         """Create TS.MRANGE and TS.MREVRANGE arguments."""
         params = [from_time, to_time]
-        self._appendFilerByTs(params, filter_by_ts)
-        self._appendFilerByValue(params, filter_by_min_value, filter_by_max_value)
-        self._appendCount(params, count)
-        self._appendAlign(params, align)
-        self._appendAggregation(params, aggregation_type, bucket_size_msec)
-        self._appendWithLabels(params, with_labels, select_labels)
+        self._append_filer_by_ts(params, filter_by_ts)
+        self._append_filer_by_value(params, filter_by_min_value, filter_by_max_value)
+        self._append_count(params, count)
+        self._append_align(params, align)
+        self._append_aggregation(params, aggregation_type, bucket_size_msec)
+        self._append_with_labels(params, with_labels, select_labels)
         params.extend(["FILTER"])
         params += filters
-        self._appendGroupbyReduce(params, groupby, reduce)
+        self._append_groupby_reduce(params, groupby, reduce)
         return params
 
     def mrange(
@@ -653,7 +653,7 @@ def mget(self, filters, with_labels=False):
         For more information: https://oss.redis.com/redistimeseries/master/commands/#tsmget
         """  # noqa
         params = []
-        self._appendWithLabels(params, with_labels)
+        self._append_with_labels(params, with_labels)
         params.extend(["FILTER"])
         params += filters
         return self.execute_command(MGET_CMD, *params)
@@ -675,13 +675,13 @@ def queryindex(self, filters):
         return self.execute_command(QUERYINDEX_CMD, *filters)
 
     @staticmethod
-    def _appendUncompressed(params, uncompressed):
+    def _append_uncompressed(params, uncompressed):
         """Append UNCOMPRESSED tag to params."""
         if uncompressed:
             params.extend(["UNCOMPRESSED"])
 
     @staticmethod
-    def _appendWithLabels(params, with_labels, select_labels=None):
+    def _append_with_labels(params, with_labels, select_labels=None):
         """Append labels behavior to params."""
         if with_labels and select_labels:
             raise DataError(
@@ -694,19 +694,19 @@ def _appendWithLabels(params, with_labels, select_labels=None):
             params.extend(["SELECTED_LABELS", *select_labels])
 
     @staticmethod
-    def _appendGroupbyReduce(params, groupby, reduce):
+    def _append_groupby_reduce(params, groupby, reduce):
         """Append GROUPBY REDUCE property to params."""
         if groupby is not None and reduce is not None:
             params.extend(["GROUPBY", groupby, "REDUCE", reduce.upper()])
 
     @staticmethod
-    def _appendRetention(params, retention):
+    def _append_retention(params, retention):
         """Append RETENTION property to params."""
         if retention is not None:
             params.extend(["RETENTION", retention])
 
     @staticmethod
-    def _appendLabels(params, labels):
+    def _append_labels(params, labels):
         """Append LABELS property to params."""
         if labels:
             params.append("LABELS")
@@ -714,38 +714,38 @@ def _appendLabels(params, labels):
                 params.extend([k, v])
 
     @staticmethod
-    def _appendCount(params, count):
+    def _append_count(params, count):
         """Append COUNT property to params."""
         if count is not None:
             params.extend(["COUNT", count])
 
     @staticmethod
-    def _appendTimestamp(params, timestamp):
+    def _append_timestamp(params, timestamp):
         """Append TIMESTAMP property to params."""
         if timestamp is not None:
             params.extend(["TIMESTAMP", timestamp])
 
     @staticmethod
-    def _appendAlign(params, align):
+    def _append_align(params, align):
         """Append ALIGN property to params."""
         if align is not None:
             params.extend(["ALIGN", align])
 
     @staticmethod
-    def _appendAggregation(params, aggregation_type, bucket_size_msec):
+    def _append_aggregation(params, aggregation_type, bucket_size_msec):
         """Append AGGREGATION property to params."""
         if aggregation_type is not None:
             params.append("AGGREGATION")
             params.extend([aggregation_type, bucket_size_msec])
 
     @staticmethod
-    def _appendChunkSize(params, chunk_size):
+    def _append_chunk_size(params, chunk_size):
         """Append CHUNK_SIZE property to params."""
         if chunk_size is not None:
             params.extend(["CHUNK_SIZE", chunk_size])
 
     @staticmethod
-    def _appendDuplicatePolicy(params, command, duplicate_policy):
+    def _append_duplicate_policy(params, command, duplicate_policy):
         """Append DUPLICATE_POLICY property to params on CREATE
         and ON_DUPLICATE on ADD.
         """
@@ -756,13 +756,13 @@ def _appendDuplicatePolicy(params, command, duplicate_policy):
                 params.extend(["DUPLICATE_POLICY", duplicate_policy])
 
     @staticmethod
-    def _appendFilerByTs(params, ts_list):
+    def _append_filer_by_ts(params, ts_list):
         """Append FILTER_BY_TS property to params."""
         if ts_list is not None:
             params.extend(["FILTER_BY_TS", *ts_list])
 
     @staticmethod
-    def _appendFilerByValue(params, min_value, max_value):
+    def _append_filer_by_value(params, min_value, max_value):
         """Append FILTER_BY_VALUE property to params."""
         if min_value is not None and max_value is not None:
             params.extend(["FILTER_BY_VALUE", min_value, max_value])
diff --git a/tests/test_graph.py b/tests/test_graph.py
index c6dc9a4371..2125d4a2fc 100644
--- a/tests/test_graph.py
+++ b/tests/test_graph.py
@@ -440,13 +440,13 @@ def test_cache_sync(client):
 
     assert len(A._labels) == 2
     assert len(A._properties) == 2
-    assert len(A._relationshipTypes) == 2
+    assert len(A._relationship_types) == 2
     assert A._labels[0] == "L"
     assert A._labels[1] == "K"
     assert A._properties[0] == "x"
     assert A._properties[1] == "q"
-    assert A._relationshipTypes[0] == "R"
-    assert A._relationshipTypes[1] == "S"
+    assert A._relationship_types[0] == "R"
+    assert A._relationship_types[1] == "S"
 
     # Have client B reconstruct the graph in a different order.
     B.delete()
@@ -468,10 +468,10 @@ def test_cache_sync(client):
 
     assert len(A._labels) == 2
     assert len(A._properties) == 2
-    assert len(A._relationshipTypes) == 2
+    assert len(A._relationship_types) == 2
     assert A._labels[0] == "K"
     assert A._labels[1] == "L"
     assert A._properties[0] == "q"
     assert A._properties[1] == "x"
-    assert A._relationshipTypes[0] == "S"
-    assert A._relationshipTypes[1] == "R"
+    assert A._relationship_types[0] == "S"
+    assert A._relationship_types[1] == "R"
diff --git a/tests/test_graph_utils/test_edge.py b/tests/test_graph_utils/test_edge.py
index 42358de19a..b5b7362389 100644
--- a/tests/test_graph_utils/test_edge.py
+++ b/tests/test_graph_utils/test_edge.py
@@ -17,15 +17,15 @@ def test_init():
 
 
 @pytest.mark.redismod
-def test_toString():
+def test_to_string():
     props_result = edge.Edge(
         node.Node(), None, node.Node(), properties={"a": "a", "b": 10}
-    ).toString()
+    ).to_string()
     assert props_result == '{a:"a",b:10}'
 
     no_props_result = edge.Edge(
         node.Node(), None, node.Node(), properties={}
-    ).toString()
+    ).to_string()
     assert no_props_result == ""
 
 
diff --git a/tests/test_graph_utils/test_node.py b/tests/test_graph_utils/test_node.py
index faf8ab6458..cd4e936719 100644
--- a/tests/test_graph_utils/test_node.py
+++ b/tests/test_graph_utils/test_node.py
@@ -14,13 +14,13 @@ def fixture():
 
 
 @pytest.mark.redismod
-def test_toString(fixture):
+def test_to_string(fixture):
     no_args, no_props, props_only, no_label, multi_label = fixture
-    assert no_args.toString() == ""
-    assert no_props.toString() == ""
-    assert props_only.toString() == '{a:"a",b:10}'
-    assert no_label.toString() == '{a:"a"}'
-    assert multi_label.toString() == ""
+    assert no_args.to_string() == ""
+    assert no_props.to_string() == ""
+    assert props_only.to_string() == '{a:"a",b:10}'
+    assert no_label.to_string() == '{a:"a"}'
+    assert multi_label.to_string() == ""
 
 
 @pytest.mark.redismod
diff --git a/tests/test_json.py b/tests/test_json.py
index 21bdc08b5e..3d9b67841f 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -18,13 +18,13 @@ def client(modclient):
 def test_json_setbinarykey(client):
     d = {"hello": "world", b"some": "value"}
     with pytest.raises(TypeError):
-        client.json().set("somekey", Path.rootPath(), d)
-    assert client.json().set("somekey", Path.rootPath(), d, decode_keys=True)
+        client.json().set("somekey", Path.root_path(), d)
+    assert client.json().set("somekey", Path.root_path(), d, decode_keys=True)
 
 
 @pytest.mark.redismod
 def test_json_setgetdeleteforget(client):
-    assert client.json().set("foo", Path.rootPath(), "bar")
+    assert client.json().set("foo", Path.root_path(), "bar")
     assert client.json().get("foo") == "bar"
     assert client.json().get("baz") is None
     assert client.json().delete("foo") == 1
@@ -34,13 +34,13 @@ def test_json_setgetdeleteforget(client):
 
 @pytest.mark.redismod
 def test_jsonget(client):
-    client.json().set("foo", Path.rootPath(), "bar")
+    client.json().set("foo", Path.root_path(), "bar")
     assert client.json().get("foo") == "bar"
 
 
 @pytest.mark.redismod
 def test_json_get_jset(client):
-    assert client.json().set("foo", Path.rootPath(), "bar")
+    assert client.json().set("foo", Path.root_path(), "bar")
     assert "bar" == client.json().get("foo")
     assert client.json().get("baz") is None
     assert 1 == client.json().delete("foo")
@@ -49,7 +49,7 @@ def test_json_get_jset(client):
 
 @pytest.mark.redismod
 def test_nonascii_setgetdelete(client):
-    assert client.json().set("notascii", Path.rootPath(), "hyvää-élève")
+    assert client.json().set("notascii", Path.root_path(), "hyvää-élève")
     assert "hyvää-élève" == client.json().get("notascii", no_escape=True)
     assert 1 == client.json().delete("notascii")
     assert client.exists("notascii") == 0
@@ -58,7 +58,7 @@ def test_nonascii_setgetdelete(client):
 @pytest.mark.redismod
 def test_jsonsetexistentialmodifiersshouldsucceed(client):
     obj = {"foo": "bar"}
-    assert client.json().set("obj", Path.rootPath(), obj)
+    assert client.json().set("obj", Path.root_path(), obj)
 
     # Test that flags prevent updates when conditions are unmet
     assert client.json().set("obj", Path("foo"), "baz", nx=True) is None
@@ -75,69 +75,69 @@ def test_jsonsetexistentialmodifiersshouldsucceed(client):
 
 @pytest.mark.redismod
 def test_mgetshouldsucceed(client):
-    client.json().set("1", Path.rootPath(), 1)
-    client.json().set("2", Path.rootPath(), 2)
-    assert client.json().mget(["1"], Path.rootPath()) == [1]
+    client.json().set("1", Path.root_path(), 1)
+    client.json().set("2", Path.root_path(), 2)
+    assert client.json().mget(["1"], Path.root_path()) == [1]
 
-    assert client.json().mget([1, 2], Path.rootPath()) == [1, 2]
+    assert client.json().mget([1, 2], Path.root_path()) == [1, 2]
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
 def test_clear(client):
-    client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
-    assert 1 == client.json().clear("arr", Path.rootPath())
+    client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 1 == client.json().clear("arr", Path.root_path())
     assert [] == client.json().get("arr")
 
 
 @pytest.mark.redismod
 def test_type(client):
-    client.json().set("1", Path.rootPath(), 1)
-    assert "integer" == client.json().type("1", Path.rootPath())
+    client.json().set("1", Path.root_path(), 1)
+    assert "integer" == client.json().type("1", Path.root_path())
     assert "integer" == client.json().type("1")
 
 
 @pytest.mark.redismod
 def test_numincrby(client):
-    client.json().set("num", Path.rootPath(), 1)
-    assert 2 == client.json().numincrby("num", Path.rootPath(), 1)
-    assert 2.5 == client.json().numincrby("num", Path.rootPath(), 0.5)
-    assert 1.25 == client.json().numincrby("num", Path.rootPath(), -1.25)
+    client.json().set("num", Path.root_path(), 1)
+    assert 2 == client.json().numincrby("num", Path.root_path(), 1)
+    assert 2.5 == client.json().numincrby("num", Path.root_path(), 0.5)
+    assert 1.25 == client.json().numincrby("num", Path.root_path(), -1.25)
 
 
 @pytest.mark.redismod
 def test_nummultby(client):
-    client.json().set("num", Path.rootPath(), 1)
+    client.json().set("num", Path.root_path(), 1)
 
     with pytest.deprecated_call():
-        assert 2 == client.json().nummultby("num", Path.rootPath(), 2)
-        assert 5 == client.json().nummultby("num", Path.rootPath(), 2.5)
-        assert 2.5 == client.json().nummultby("num", Path.rootPath(), 0.5)
+        assert 2 == client.json().nummultby("num", Path.root_path(), 2)
+        assert 5 == client.json().nummultby("num", Path.root_path(), 2.5)
+        assert 2.5 == client.json().nummultby("num", Path.root_path(), 0.5)
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
 def test_toggle(client):
-    client.json().set("bool", Path.rootPath(), False)
-    assert client.json().toggle("bool", Path.rootPath())
-    assert client.json().toggle("bool", Path.rootPath()) is False
+    client.json().set("bool", Path.root_path(), False)
+    assert client.json().toggle("bool", Path.root_path())
+    assert client.json().toggle("bool", Path.root_path()) is False
     # check non-boolean value
-    client.json().set("num", Path.rootPath(), 1)
+    client.json().set("num", Path.root_path(), 1)
     with pytest.raises(redis.exceptions.ResponseError):
-        client.json().toggle("num", Path.rootPath())
+        client.json().toggle("num", Path.root_path())
 
 
 @pytest.mark.redismod
 def test_strappend(client):
-    client.json().set("jsonkey", Path.rootPath(), "foo")
+    client.json().set("jsonkey", Path.root_path(), "foo")
     assert 6 == client.json().strappend("jsonkey", "bar")
-    assert "foobar" == client.json().get("jsonkey", Path.rootPath())
+    assert "foobar" == client.json().get("jsonkey", Path.root_path())
 
 
 # @pytest.mark.redismod
 # def test_debug(client):
-#    client.json().set("str", Path.rootPath(), "foo")
-#    assert 24 == client.json().debug("MEMORY", "str", Path.rootPath())
+#    client.json().set("str", Path.root_path(), "foo")
+#    assert 24 == client.json().debug("MEMORY", "str", Path.root_path())
 #    assert 24 == client.json().debug("MEMORY", "str")
 #
 #    # technically help is valid
@@ -146,34 +146,34 @@ def test_strappend(client):
 
 @pytest.mark.redismod
 def test_strlen(client):
-    client.json().set("str", Path.rootPath(), "foo")
-    assert 3 == client.json().strlen("str", Path.rootPath())
-    client.json().strappend("str", "bar", Path.rootPath())
-    assert 6 == client.json().strlen("str", Path.rootPath())
+    client.json().set("str", Path.root_path(), "foo")
+    assert 3 == client.json().strlen("str", Path.root_path())
+    client.json().strappend("str", "bar", Path.root_path())
+    assert 6 == client.json().strlen("str", Path.root_path())
     assert 6 == client.json().strlen("str")
 
 
 @pytest.mark.redismod
 def test_arrappend(client):
-    client.json().set("arr", Path.rootPath(), [1])
-    assert 2 == client.json().arrappend("arr", Path.rootPath(), 2)
-    assert 4 == client.json().arrappend("arr", Path.rootPath(), 3, 4)
-    assert 7 == client.json().arrappend("arr", Path.rootPath(), *[5, 6, 7])
+    client.json().set("arr", Path.root_path(), [1])
+    assert 2 == client.json().arrappend("arr", Path.root_path(), 2)
+    assert 4 == client.json().arrappend("arr", Path.root_path(), 3, 4)
+    assert 7 == client.json().arrappend("arr", Path.root_path(), *[5, 6, 7])
 
 
 @pytest.mark.redismod
 def test_arrindex(client):
-    client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
-    assert 1 == client.json().arrindex("arr", Path.rootPath(), 1)
-    assert -1 == client.json().arrindex("arr", Path.rootPath(), 1, 2)
+    client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 1 == client.json().arrindex("arr", Path.root_path(), 1)
+    assert -1 == client.json().arrindex("arr", Path.root_path(), 1, 2)
 
 
 @pytest.mark.redismod
 def test_arrinsert(client):
-    client.json().set("arr", Path.rootPath(), [0, 4])
+    client.json().set("arr", Path.root_path(), [0, 4])
     assert 5 - -client.json().arrinsert(
         "arr",
-        Path.rootPath(),
+        Path.root_path(),
         1,
         *[
             1,
@@ -184,64 +184,64 @@ def test_arrinsert(client):
     assert [0, 1, 2, 3, 4] == client.json().get("arr")
 
     # test prepends
-    client.json().set("val2", Path.rootPath(), [5, 6, 7, 8, 9])
-    client.json().arrinsert("val2", Path.rootPath(), 0, ["some", "thing"])
+    client.json().set("val2", Path.root_path(), [5, 6, 7, 8, 9])
+    client.json().arrinsert("val2", Path.root_path(), 0, ["some", "thing"])
     assert client.json().get("val2") == [["some", "thing"], 5, 6, 7, 8, 9]
 
 
 @pytest.mark.redismod
 def test_arrlen(client):
-    client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
-    assert 5 == client.json().arrlen("arr", Path.rootPath())
+    client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 5 == client.json().arrlen("arr", Path.root_path())
     assert 5 == client.json().arrlen("arr")
     assert client.json().arrlen("fakekey") is None
 
 
 @pytest.mark.redismod
 def test_arrpop(client):
-    client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
-    assert 4 == client.json().arrpop("arr", Path.rootPath(), 4)
-    assert 3 == client.json().arrpop("arr", Path.rootPath(), -1)
-    assert 2 == client.json().arrpop("arr", Path.rootPath())
-    assert 0 == client.json().arrpop("arr", Path.rootPath(), 0)
+    client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 4 == client.json().arrpop("arr", Path.root_path(), 4)
+    assert 3 == client.json().arrpop("arr", Path.root_path(), -1)
+    assert 2 == client.json().arrpop("arr", Path.root_path())
+    assert 0 == client.json().arrpop("arr", Path.root_path(), 0)
     assert [1] == client.json().get("arr")
 
     # test out of bounds
-    client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
-    assert 4 == client.json().arrpop("arr", Path.rootPath(), 99)
+    client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 4 == client.json().arrpop("arr", Path.root_path(), 99)
 
     # none test
-    client.json().set("arr", Path.rootPath(), [])
+    client.json().set("arr", Path.root_path(), [])
     assert client.json().arrpop("arr") is None
 
 
 @pytest.mark.redismod
 def test_arrtrim(client):
-    client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
-    assert 3 == client.json().arrtrim("arr", Path.rootPath(), 1, 3)
+    client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 3 == client.json().arrtrim("arr", Path.root_path(), 1, 3)
     assert [1, 2, 3] == client.json().get("arr")
 
     # <0 test, should be 0 equivalent
-    client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
-    assert 0 == client.json().arrtrim("arr", Path.rootPath(), -1, 3)
+    client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 0 == client.json().arrtrim("arr", Path.root_path(), -1, 3)
 
     # testing stop > end
-    client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
-    assert 2 == client.json().arrtrim("arr", Path.rootPath(), 3, 99)
+    client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 2 == client.json().arrtrim("arr", Path.root_path(), 3, 99)
 
     # start > array size and stop
-    client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
-    assert 0 == client.json().arrtrim("arr", Path.rootPath(), 9, 1)
+    client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 0 == client.json().arrtrim("arr", Path.root_path(), 9, 1)
 
     # all larger
-    client.json().set("arr", Path.rootPath(), [0, 1, 2, 3, 4])
-    assert 0 == client.json().arrtrim("arr", Path.rootPath(), 9, 11)
+    client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 0 == client.json().arrtrim("arr", Path.root_path(), 9, 11)
 
 
 @pytest.mark.redismod
 def test_resp(client):
     obj = {"foo": "bar", "baz": 1, "qaz": True}
-    client.json().set("obj", Path.rootPath(), obj)
+    client.json().set("obj", Path.root_path(), obj)
     assert "bar" == client.json().resp("obj", Path("foo"))
     assert 1 == client.json().resp("obj", Path("baz"))
     assert client.json().resp("obj", Path("qaz"))
@@ -251,14 +251,14 @@ def test_resp(client):
 @pytest.mark.redismod
 def test_objkeys(client):
     obj = {"foo": "bar", "baz": "qaz"}
-    client.json().set("obj", Path.rootPath(), obj)
-    keys = client.json().objkeys("obj", Path.rootPath())
+    client.json().set("obj", Path.root_path(), obj)
+    keys = client.json().objkeys("obj", Path.root_path())
     keys.sort()
     exp = list(obj.keys())
     exp.sort()
     assert exp == keys
 
-    client.json().set("obj", Path.rootPath(), obj)
+    client.json().set("obj", Path.root_path(), obj)
     keys = client.json().objkeys("obj")
     assert keys == list(obj.keys())
 
@@ -268,17 +268,17 @@ def test_objkeys(client):
 @pytest.mark.redismod
 def test_objlen(client):
     obj = {"foo": "bar", "baz": "qaz"}
-    client.json().set("obj", Path.rootPath(), obj)
-    assert len(obj) == client.json().objlen("obj", Path.rootPath())
+    client.json().set("obj", Path.root_path(), obj)
+    assert len(obj) == client.json().objlen("obj", Path.root_path())
 
-    client.json().set("obj", Path.rootPath(), obj)
+    client.json().set("obj", Path.root_path(), obj)
     assert len(obj) == client.json().objlen("obj")
 
 
 @pytest.mark.redismod
 def test_json_commands_in_pipeline(client):
     p = client.json().pipeline()
-    p.set("foo", Path.rootPath(), "bar")
+    p.set("foo", Path.root_path(), "bar")
     p.get("foo")
     p.delete("foo")
     assert [True, "bar", 1] == p.execute()
@@ -290,7 +290,7 @@ def test_json_commands_in_pipeline(client):
     p = client.json().pipeline()
     d = {"hello": "world", "oh": "snap"}
     with pytest.deprecated_call():
-        p.jsonset("foo", Path.rootPath(), d)
+        p.jsonset("foo", Path.root_path(), d)
         p.jsonget("foo")
     p.exists("notarealkey")
     p.delete("foo")
@@ -1385,7 +1385,7 @@ def test_custom_decoder(client):
     import ujson
 
     cj = client.json(encoder=ujson, decoder=ujson)
-    assert cj.set("foo", Path.rootPath(), "bar")
+    assert cj.set("foo", Path.root_path(), "bar")
     assert "bar" == cj.get("foo")
     assert cj.get("baz") is None
     assert 1 == cj.delete("foo")
@@ -1407,10 +1407,10 @@ def test_set_file(client):
     nojsonfile = tempfile.NamedTemporaryFile()
     nojsonfile.write(b"Hello World")
 
-    assert client.json().set_file("test", Path.rootPath(), jsonfile.name)
+    assert client.json().set_file("test", Path.root_path(), jsonfile.name)
     assert client.json().get("test") == obj
     with pytest.raises(json.JSONDecodeError):
-        client.json().set_file("test2", Path.rootPath(), nojsonfile.name)
+        client.json().set_file("test2", Path.root_path(), nojsonfile.name)
 
 
 @pytest.mark.redismod
@@ -1428,5 +1428,5 @@ def test_set_path(client):
     open(nojsonfile, "a+").write("hello")
 
     result = {jsonfile: True, nojsonfile: False}
-    assert client.json().set_path(Path.rootPath(), root) == result
+    assert client.json().set_path(Path.root_path(), root) == result
     assert client.json().get(jsonfile.rsplit(".")[0]) == {"hello": "world"}
diff --git a/tests/test_search.py b/tests/test_search.py
index 6c79041cfe..18bb9adecf 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1266,8 +1266,8 @@ def test_create_client_definition_json(client):
     definition = IndexDefinition(prefix=["king:"], index_type=IndexType.JSON)
     client.ft().create_index((TextField("$.name"),), definition=definition)
 
-    client.json().set("king:1", Path.rootPath(), {"name": "henry"})
-    client.json().set("king:2", Path.rootPath(), {"name": "james"})
+    client.json().set("king:1", Path.root_path(), {"name": "henry"})
+    client.json().set("king:2", Path.root_path(), {"name": "james"})
 
     res = client.ft().search("henry")
     assert res.docs[0].id == "king:1"
@@ -1288,7 +1288,7 @@ def test_fields_as_name(client):
     client.ft().create_index(SCHEMA, definition=definition)
 
     # insert json data
-    res = client.json().set("doc:1", Path.rootPath(), {"name": "Jon", "age": 25})
+    res = client.json().set("doc:1", Path.root_path(), {"name": "Jon", "age": 25})
     assert res
 
     total = client.ft().search(Query("Jon").return_fields("name", "just_a_number")).docs
@@ -1303,7 +1303,7 @@ def test_fields_as_name(client):
 def test_search_return_fields(client):
     res = client.json().set(
         "doc:1",
-        Path.rootPath(),
+        Path.root_path(),
         {"t": "riceratops", "t2": "telmatosaurus", "n": 9072, "flt": 97.2},
     )
     assert res
@@ -1389,8 +1389,8 @@ def test_create_json_with_alias(client):
         definition=definition,
     )
 
-    client.json().set("king:1", Path.rootPath(), {"name": "henry", "num": 42})
-    client.json().set("king:2", Path.rootPath(), {"name": "james", "num": 3.14})
+    client.json().set("king:1", Path.root_path(), {"name": "henry", "num": 42})
+    client.json().set("king:2", Path.root_path(), {"name": "james", "num": 3.14})
 
     res = client.ft().search("@name:henry")
     assert res.docs[0].id == "king:1"
@@ -1421,7 +1421,7 @@ def test_json_with_multipath(client):
     )
 
     client.json().set(
-        "king:1", Path.rootPath(), {"name": "henry", "country": {"name": "england"}}
+        "king:1", Path.root_path(), {"name": "henry", "country": {"name": "england"}}
     )
 
     res = client.ft().search("@name:{henry}")
@@ -1447,7 +1447,7 @@ def test_json_with_jsonpath(client):
         definition=definition,
     )
 
-    client.json().set("doc:1", Path.rootPath(), {"prod:name": "RediSearch"})
+    client.json().set("doc:1", Path.root_path(), {"prod:name": "RediSearch"})
 
     # query for a supported field succeeds
     res = client.ft().search(Query("@name:RediSearch"))

From b541da6b00c00f038293b596a62b5ecb6fdbbaa4 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 2 Feb 2022 13:52:34 +0200
Subject: [PATCH 0369/1164] Add support for SINTERCARD (#1859)

* add sintercard

* fix pr comment
---
 redis/commands/core.py | 13 +++++++++++++
 tests/test_commands.py |  9 +++++++++
 2 files changed, 22 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 383c635aea..5df93455c4 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -2388,6 +2388,19 @@ def sinter(self, keys, *args):
         args = list_or_args(keys, args)
         return self.execute_command("SINTER", *args)
 
+    def sintercard(self, numkeys: int, keys: List[str], limit: int = 0) -> int:
+        """
+        Return the cardinality of the intersect of multiple sets specified by ``keys`.
+
+        When LIMIT provided (defaults to 0 and means unlimited), if the intersection
+        cardinality reaches limit partway through the computation, the algorithm will
+        exit and yield limit as the cardinality
+
+        For more information check https://redis.io/commands/sintercard
+        """
+        args = [numkeys, *keys, "LIMIT", limit]
+        return self.execute_command("SINTERCARD", *args)
+
     def sinterstore(self, dest, keys, *args):
         """
         Store the intersection of sets specified by ``keys`` into a new
diff --git a/tests/test_commands.py b/tests/test_commands.py
index f4d7fa73e0..a7135c03a8 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1748,6 +1748,15 @@ def test_sinter(self, r):
         r.sadd("b", "2", "3")
         assert r.sinter("a", "b") == {b"2", b"3"}
 
+    @pytest.mark.onlynoncluster
+    # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
+    def test_sintercard(self, unstable_r):
+        unstable_r.sadd("a", 1, 2, 3)
+        unstable_r.sadd("b", 1, 2, 3)
+        unstable_r.sadd("c", 1, 3, 4)
+        assert unstable_r.sintercard(3, ["a", "b", "c"]) == 2
+        assert unstable_r.sintercard(3, ["a", "b", "c"], limit=1) == 1
+
     @pytest.mark.onlynoncluster
     def test_sinterstore(self, r):
         r.sadd("a", "1", "2", "3")

From aaddeb6a9c0d2fcacf240c5ace7ba76fddee2fc1 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 2 Feb 2022 14:08:47 +0200
Subject: [PATCH 0370/1164] Add support for LMPOP (#1843)

* Add support for LMPOP

* add type hints

* fix linters
---
 redis/commands/core.py | 19 +++++++++++++++++++
 tests/test_commands.py | 11 +++++++++++
 2 files changed, 30 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 5df93455c4..06773e3f35 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1917,6 +1917,25 @@ def brpoplpush(self, src, dst, timeout=0):
             timeout = 0
         return self.execute_command("BRPOPLPUSH", src, dst, timeout)
 
+    def lmpop(
+        self,
+        num_keys: int,
+        *args: List[str],
+        direction: str = None,
+        count: Optional[int] = 1,
+    ) -> List:
+        """
+        Pop ``count`` values (default 1) first non-empty list key from the list
+        of args provided key names.
+
+        For more information check https://redis.io/commands/lmpop
+        """
+        args = [num_keys] + list(args) + [direction]
+        if count != 1:
+            args.extend(["COUNT", count])
+
+        return self.execute_command("LMPOP", *args)
+
     def lindex(self, name, index):
         """
         Return the item from list ``name`` at position ``index``
diff --git a/tests/test_commands.py b/tests/test_commands.py
index a7135c03a8..ed69c40693 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1480,6 +1480,17 @@ def test_brpoplpush_empty_string(self, r):
         r.rpush("a", "")
         assert r.brpoplpush("a", "b") == b""
 
+    @pytest.mark.onlynoncluster
+    # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
+    def test_lmpop(self, unstable_r):
+        unstable_r.rpush("foo", "1", "2", "3", "4", "5")
+        result = [b"foo", [b"1", b"2"]]
+        assert unstable_r.lmpop("2", "bar", "foo", direction="LEFT", count=2) == result
+        with pytest.raises(redis.ResponseError):
+            unstable_r.lmpop("2", "bar", "foo", direction="up", count=2)
+        unstable_r.rpush("bar", "a", "b", "c", "d")
+        assert unstable_r.lmpop("2", "bar", "foo", direction="LEFT") == [b"bar", [b"a"]]
+
     def test_lindex(self, r):
         r.rpush("a", "1", "2", "3")
         assert r.lindex("a", "0") == b"1"

From 4d7de6df66733dc85baa6235a122747dfe463b9a Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 2 Feb 2022 14:50:46 +0200
Subject: [PATCH 0371/1164] Add support for BLMPOP (#1849)

* Add support for BLMPOP

* add type hints

* fix test

* fix comment

* fix pr comment

* delete count check

* change numkeys

* linters

* mark test as onlynoncluster
---
 redis/commands/core.py | 21 +++++++++++++++++++++
 tests/test_commands.py | 12 ++++++++++++
 2 files changed, 33 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 06773e3f35..da95cea584 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1917,6 +1917,27 @@ def brpoplpush(self, src, dst, timeout=0):
             timeout = 0
         return self.execute_command("BRPOPLPUSH", src, dst, timeout)
 
+    def blmpop(
+        self,
+        timeout: float,
+        numkeys: int,
+        *args: List[str],
+        direction: str,
+        count: Optional[int] = 1,
+    ) -> Optional[list]:
+        """
+        Pop ``count`` values (default 1) from first non-empty in the list
+        of provided key names.
+
+        When all lists are empty this command blocks the connection until another
+        client pushes to it or until the timeout, timeout of 0 blocks indefinitely
+
+        For more information check https://redis.io/commands/blmpop
+        """
+        args = [timeout, numkeys, *args, direction, "COUNT", count]
+
+        return self.execute_command("BLMPOP", *args)
+
     def lmpop(
         self,
         num_keys: int,
diff --git a/tests/test_commands.py b/tests/test_commands.py
index ed69c40693..c8f7ddc3f4 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1480,6 +1480,18 @@ def test_brpoplpush_empty_string(self, r):
         r.rpush("a", "")
         assert r.brpoplpush("a", "b") == b""
 
+    @pytest.mark.onlynoncluster
+    # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
+    def test_blmpop(self, unstable_r):
+        unstable_r.rpush("a", "1", "2", "3", "4", "5")
+        res = [b"a", [b"1", b"2"]]
+        assert unstable_r.blmpop(1, "2", "b", "a", direction="LEFT", count=2) == res
+        with pytest.raises(TypeError):
+            unstable_r.blmpop(1, "2", "b", "a", count=2)
+        unstable_r.rpush("b", "6", "7", "8", "9")
+        assert unstable_r.blmpop(0, "2", "b", "a", direction="LEFT") == [b"b", [b"6"]]
+        assert unstable_r.blmpop(1, "2", "foo", "bar", direction="RIGHT") is None
+
     @pytest.mark.onlynoncluster
     # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
     def test_lmpop(self, unstable_r):

From 0d26117625a0cebd8a73d510b51d71142a558c00 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 3 Feb 2022 00:26:05 +0200
Subject: [PATCH 0372/1164] Add redis5 and redis4 dockers (#1871)

* add redis5 and redis4 dockers

* redis versions testenv

* path changes

* fix linters

* fix tests

* fixing linter

* Increased pubsub's wait_for_messages timeout to prevent flaky tests (#1893)

* Fixing TypeError in GraphCommands.explain (#1901)

* Fixing AttributeError in UnixDomainSocketConnection (#1903)

* Fixing AttributeError on some connection errors (#1905)

* cluster script fixes to support future cluster versions and redis unstable (#1900)

* Fixing LMOVE, BLMOVE returning an incorrect response (#1906)

* Raising ConnectionError on invalid ocsp certificates - with status information (#1907)

* 4.1.2 (#1904)

* adding cluster env timeout time (#1908)

* Update changes file with changes since 4.0.0-beta2 (#1915)

* Fixing volume for unstable_cluster docker (#1914)

* Change json.clear test multi to be up to date with redisjson (#1922)

* fix json clear test

* fix json clear test

* Add support for BZMPOP (#1851)

* add bzmpop

* add comment

* fix pr comment

* fix linters

* fix pr comments

* add client no-evict (#1856)

* Add support for ZINTERCARD (#1857)

* add zintercard

* fix pr comment

* linters

* Add support for EVAL_RO (#1862)

* add sort_ro

* mark test as onlynon cluster

* delete mark test as onlynoncluster

* add eval_ro

* fix linters

* delete sort_ro

* fix pr comment

* add type hints

* add type hints

* linters

* Add support for EVALSHA_RO (#1863)

* add evalsha-ro

* fix pr comment

* add type hints

* add type hints

* Fix naming conventions (#1872)

* fix naming convention

* fix worng changes

* change ports to resolve conflict with unstable_cluster

Co-authored-by: Chayim I. Kirshen <c@kirshen.com>
Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Co-authored-by: Varun Chopra <v@chopraaa.com>
---
 .github/workflows/integration.yaml            |   1 -
 dev_requirements.txt                          |   1 -
 docker/base/Dockerfile.cluster4               |   9 +
 docker/base/Dockerfile.cluster5               |   9 +
 docker/base/Dockerfile.redis4                 |   4 +
 docker/base/Dockerfile.redis5                 |   4 +
 docker/base/Dockerfile.sentinel4              |   4 +
 docker/base/Dockerfile.sentinel5              |   4 +
 docker/base/create_cluster.sh                 |   0
 docker/base/create_cluster4.sh                |  26 +++
 docker/base/create_cluster5.sh                |  26 +++
 docker/redis4/master/redis.conf               |   2 +
 docker/redis4/sentinel/sentinel_1.conf        |   6 +
 docker/redis4/sentinel/sentinel_2.conf        |   6 +
 docker/redis4/sentinel/sentinel_3.conf        |   6 +
 docker/redis5/master/redis.conf               |   2 +
 docker/redis5/replica/redis.conf              |   3 +
 docker/redis5/sentinel/sentinel_1.conf        |   6 +
 docker/redis5/sentinel/sentinel_2.conf        |   6 +
 docker/redis5/sentinel/sentinel_3.conf        |   6 +
 docker/{ => redis6.2}/master/redis.conf       |   0
 docker/{ => redis6.2}/replica/redis.conf      |   0
 .../sentinel/sentinel_1.conf}                 |   0
 .../sentinel/sentinel_2.conf}                 |   0
 .../sentinel/sentinel_3.conf}                 |   0
 docker/stunnel/README                         |   1 +
 docker/stunnel/keys/ca-cert.pem               |  21 +++
 docker/stunnel/keys/ca-key.pem                |  27 +++
 docker/stunnel/keys/client-cert.pem           |  21 +++
 docker/stunnel/keys/client-key.pem            |  28 +++
 docker/stunnel/keys/client-req.pem            |  17 ++
 docker/stunnel/keys/server-cert.pem           |  21 +++
 docker/stunnel/keys/server-key.pem            |  28 +++
 docker/stunnel/keys/server-req.pem            |  17 ++
 tasks.py                                      |  14 --
 tox.ini                                       | 174 +++++++++++++++++-
 36 files changed, 477 insertions(+), 23 deletions(-)
 create mode 100644 docker/base/Dockerfile.cluster4
 create mode 100644 docker/base/Dockerfile.cluster5
 create mode 100644 docker/base/Dockerfile.redis4
 create mode 100644 docker/base/Dockerfile.redis5
 create mode 100644 docker/base/Dockerfile.sentinel4
 create mode 100644 docker/base/Dockerfile.sentinel5
 mode change 100644 => 100755 docker/base/create_cluster.sh
 create mode 100755 docker/base/create_cluster4.sh
 create mode 100755 docker/base/create_cluster5.sh
 create mode 100644 docker/redis4/master/redis.conf
 create mode 100644 docker/redis4/sentinel/sentinel_1.conf
 create mode 100644 docker/redis4/sentinel/sentinel_2.conf
 create mode 100644 docker/redis4/sentinel/sentinel_3.conf
 create mode 100644 docker/redis5/master/redis.conf
 create mode 100644 docker/redis5/replica/redis.conf
 create mode 100644 docker/redis5/sentinel/sentinel_1.conf
 create mode 100644 docker/redis5/sentinel/sentinel_2.conf
 create mode 100644 docker/redis5/sentinel/sentinel_3.conf
 rename docker/{ => redis6.2}/master/redis.conf (100%)
 rename docker/{ => redis6.2}/replica/redis.conf (100%)
 rename docker/{sentinel_1/sentinel.conf => redis6.2/sentinel/sentinel_1.conf} (100%)
 rename docker/{sentinel_2/sentinel.conf => redis6.2/sentinel/sentinel_2.conf} (100%)
 rename docker/{sentinel_3/sentinel.conf => redis6.2/sentinel/sentinel_3.conf} (100%)
 create mode 100644 docker/stunnel/README
 create mode 100644 docker/stunnel/keys/ca-cert.pem
 create mode 100644 docker/stunnel/keys/ca-key.pem
 create mode 100644 docker/stunnel/keys/client-cert.pem
 create mode 100644 docker/stunnel/keys/client-key.pem
 create mode 100644 docker/stunnel/keys/client-req.pem
 create mode 100644 docker/stunnel/keys/server-cert.pem
 create mode 100644 docker/stunnel/keys/server-key.pem
 create mode 100644 docker/stunnel/keys/server-req.pem

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index b034428bcd..a73bb71160 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -49,7 +49,6 @@ jobs:
        - name: run tests
          run: |
            pip install -r dev_requirements.txt
-           bash docker/stunnel/create_certs.sh
            tox -e ${{matrix.test-type}}-${{matrix.connection-type}}
        - name: Upload codecov coverage
          uses: codecov/codecov-action@v2
diff --git a/dev_requirements.txt b/dev_requirements.txt
index 1d33b9875b..2a4f37762f 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -6,7 +6,6 @@ pytest==6.2.5
 pytest-timeout==2.0.1
 tox==3.24.4
 tox-docker==3.1.0
-tox-run-before==0.1
 invoke==1.6.0
 pytest-cov>=3.0.0
 vulture>=2.3.0
diff --git a/docker/base/Dockerfile.cluster4 b/docker/base/Dockerfile.cluster4
new file mode 100644
index 0000000000..3158d6edd4
--- /dev/null
+++ b/docker/base/Dockerfile.cluster4
@@ -0,0 +1,9 @@
+# produces redisfab/redis-py-cluster:4.0
+FROM redis:4.0-buster
+
+COPY create_cluster4.sh /create_cluster4.sh
+RUN chmod +x /create_cluster4.sh
+
+EXPOSE 16391 16392 16393 16394 16395 16396
+
+CMD [ "/create_cluster4.sh"]
\ No newline at end of file
diff --git a/docker/base/Dockerfile.cluster5 b/docker/base/Dockerfile.cluster5
new file mode 100644
index 0000000000..3becfc853a
--- /dev/null
+++ b/docker/base/Dockerfile.cluster5
@@ -0,0 +1,9 @@
+# produces redisfab/redis-py-cluster:5.0
+FROM redis:5.0-buster
+
+COPY create_cluster5.sh /create_cluster5.sh
+RUN chmod +x /create_cluster5.sh
+
+EXPOSE 16385 16386 16387 16388 16389 16390
+
+CMD [ "/create_cluster5.sh"]
\ No newline at end of file
diff --git a/docker/base/Dockerfile.redis4 b/docker/base/Dockerfile.redis4
new file mode 100644
index 0000000000..7528ac1631
--- /dev/null
+++ b/docker/base/Dockerfile.redis4
@@ -0,0 +1,4 @@
+# produces redisfab/redis-py:4.0
+FROM redis:4.0-buster
+
+CMD ["redis-server", "/redis.conf"]
\ No newline at end of file
diff --git a/docker/base/Dockerfile.redis5 b/docker/base/Dockerfile.redis5
new file mode 100644
index 0000000000..6bcbe20bfc
--- /dev/null
+++ b/docker/base/Dockerfile.redis5
@@ -0,0 +1,4 @@
+# produces redisfab/redis-py:5.0
+FROM redis:5.0-buster
+
+CMD ["redis-server", "/redis.conf"]
\ No newline at end of file
diff --git a/docker/base/Dockerfile.sentinel4 b/docker/base/Dockerfile.sentinel4
new file mode 100644
index 0000000000..45bb03e88e
--- /dev/null
+++ b/docker/base/Dockerfile.sentinel4
@@ -0,0 +1,4 @@
+# produces redisfab/redis-py-sentinel:4.0
+FROM redis:4.0-buster
+
+CMD ["redis-sentinel", "/sentinel.conf"]
\ No newline at end of file
diff --git a/docker/base/Dockerfile.sentinel5 b/docker/base/Dockerfile.sentinel5
new file mode 100644
index 0000000000..6958154e46
--- /dev/null
+++ b/docker/base/Dockerfile.sentinel5
@@ -0,0 +1,4 @@
+# produces redisfab/redis-py-sentinel:5.0
+FROM redis:5.0-buster
+
+CMD ["redis-sentinel", "/sentinel.conf"]
\ No newline at end of file
diff --git a/docker/base/create_cluster.sh b/docker/base/create_cluster.sh
old mode 100644
new mode 100755
diff --git a/docker/base/create_cluster4.sh b/docker/base/create_cluster4.sh
new file mode 100755
index 0000000000..a39da58784
--- /dev/null
+++ b/docker/base/create_cluster4.sh
@@ -0,0 +1,26 @@
+#! /bin/bash
+mkdir -p /nodes
+touch /nodes/nodemap
+for PORT in $(seq 16391 16396); do
+  mkdir -p /nodes/$PORT
+  if [[ -e /redis.conf ]]; then
+    cp /redis.conf /nodes/$PORT/redis.conf
+  else
+    touch /nodes/$PORT/redis.conf
+  fi
+  cat << EOF >> /nodes/$PORT/redis.conf
+port ${PORT}
+cluster-enabled yes
+daemonize yes
+logfile /redis.log
+dir /nodes/$PORT
+EOF
+  redis-server /nodes/$PORT/redis.conf
+  if [ $? -ne 0 ]; then
+    echo "Redis failed to start, exiting."
+    exit 3
+  fi
+  echo 127.0.0.1:$PORT >> /nodes/nodemap
+done
+echo yes | redis-cli --cluster create $(seq -f 127.0.0.1:%g 16391 16396) --cluster-replicas 1
+tail -f /redis.log
\ No newline at end of file
diff --git a/docker/base/create_cluster5.sh b/docker/base/create_cluster5.sh
new file mode 100755
index 0000000000..0c63d8e910
--- /dev/null
+++ b/docker/base/create_cluster5.sh
@@ -0,0 +1,26 @@
+#! /bin/bash
+mkdir -p /nodes
+touch /nodes/nodemap
+for PORT in $(seq 16385 16390); do
+  mkdir -p /nodes/$PORT
+  if [[ -e /redis.conf ]]; then
+    cp /redis.conf /nodes/$PORT/redis.conf
+  else
+    touch /nodes/$PORT/redis.conf
+  fi
+  cat << EOF >> /nodes/$PORT/redis.conf
+port ${PORT}
+cluster-enabled yes
+daemonize yes
+logfile /redis.log
+dir /nodes/$PORT
+EOF
+  redis-server /nodes/$PORT/redis.conf
+  if [ $? -ne 0 ]; then
+    echo "Redis failed to start, exiting."
+    exit 3
+  fi
+  echo 127.0.0.1:$PORT >> /nodes/nodemap
+done
+echo yes | redis-cli --cluster create $(seq -f 127.0.0.1:%g 16385 16390) --cluster-replicas 1
+tail -f /redis.log
\ No newline at end of file
diff --git a/docker/redis4/master/redis.conf b/docker/redis4/master/redis.conf
new file mode 100644
index 0000000000..b7ed0ebf00
--- /dev/null
+++ b/docker/redis4/master/redis.conf
@@ -0,0 +1,2 @@
+port 6381
+save ""
diff --git a/docker/redis4/sentinel/sentinel_1.conf b/docker/redis4/sentinel/sentinel_1.conf
new file mode 100644
index 0000000000..cfee17c051
--- /dev/null
+++ b/docker/redis4/sentinel/sentinel_1.conf
@@ -0,0 +1,6 @@
+port 26385
+
+sentinel monitor redis-py-test 127.0.0.1 6381 2
+sentinel down-after-milliseconds redis-py-test 5000
+sentinel failover-timeout redis-py-test 60000
+sentinel parallel-syncs redis-py-test 1
diff --git a/docker/redis4/sentinel/sentinel_2.conf b/docker/redis4/sentinel/sentinel_2.conf
new file mode 100644
index 0000000000..68d930aea8
--- /dev/null
+++ b/docker/redis4/sentinel/sentinel_2.conf
@@ -0,0 +1,6 @@
+port 26386
+
+sentinel monitor redis-py-test 127.0.0.1 6381 2
+sentinel down-after-milliseconds redis-py-test 5000
+sentinel failover-timeout redis-py-test 60000
+sentinel parallel-syncs redis-py-test 1
\ No newline at end of file
diff --git a/docker/redis4/sentinel/sentinel_3.conf b/docker/redis4/sentinel/sentinel_3.conf
new file mode 100644
index 0000000000..60abf65c9b
--- /dev/null
+++ b/docker/redis4/sentinel/sentinel_3.conf
@@ -0,0 +1,6 @@
+port 26387
+
+sentinel monitor redis-py-test 127.0.0.1 6381 2
+sentinel down-after-milliseconds redis-py-test 5000
+sentinel failover-timeout redis-py-test 60000
+sentinel parallel-syncs redis-py-test 1
\ No newline at end of file
diff --git a/docker/redis5/master/redis.conf b/docker/redis5/master/redis.conf
new file mode 100644
index 0000000000..e479c48b28
--- /dev/null
+++ b/docker/redis5/master/redis.conf
@@ -0,0 +1,2 @@
+port 6382
+save ""
diff --git a/docker/redis5/replica/redis.conf b/docker/redis5/replica/redis.conf
new file mode 100644
index 0000000000..a2dc9e0945
--- /dev/null
+++ b/docker/redis5/replica/redis.conf
@@ -0,0 +1,3 @@
+port 6383
+save ""
+replicaof master 6382
diff --git a/docker/redis5/sentinel/sentinel_1.conf b/docker/redis5/sentinel/sentinel_1.conf
new file mode 100644
index 0000000000..c748a0ba72
--- /dev/null
+++ b/docker/redis5/sentinel/sentinel_1.conf
@@ -0,0 +1,6 @@
+port 26382
+
+sentinel monitor redis-py-test 127.0.0.1 6382 2
+sentinel down-after-milliseconds redis-py-test 5000
+sentinel failover-timeout redis-py-test 60000
+sentinel parallel-syncs redis-py-test 1
diff --git a/docker/redis5/sentinel/sentinel_2.conf b/docker/redis5/sentinel/sentinel_2.conf
new file mode 100644
index 0000000000..0a50c9a623
--- /dev/null
+++ b/docker/redis5/sentinel/sentinel_2.conf
@@ -0,0 +1,6 @@
+port 26383
+
+sentinel monitor redis-py-test 127.0.0.1 6382 2
+sentinel down-after-milliseconds redis-py-test 5000
+sentinel failover-timeout redis-py-test 60000
+sentinel parallel-syncs redis-py-test 1
\ No newline at end of file
diff --git a/docker/redis5/sentinel/sentinel_3.conf b/docker/redis5/sentinel/sentinel_3.conf
new file mode 100644
index 0000000000..a0e350ba0f
--- /dev/null
+++ b/docker/redis5/sentinel/sentinel_3.conf
@@ -0,0 +1,6 @@
+port 26384
+
+sentinel monitor redis-py-test 127.0.0.1 6383 2
+sentinel down-after-milliseconds redis-py-test 5000
+sentinel failover-timeout redis-py-test 60000
+sentinel parallel-syncs redis-py-test 1
\ No newline at end of file
diff --git a/docker/master/redis.conf b/docker/redis6.2/master/redis.conf
similarity index 100%
rename from docker/master/redis.conf
rename to docker/redis6.2/master/redis.conf
diff --git a/docker/replica/redis.conf b/docker/redis6.2/replica/redis.conf
similarity index 100%
rename from docker/replica/redis.conf
rename to docker/redis6.2/replica/redis.conf
diff --git a/docker/sentinel_1/sentinel.conf b/docker/redis6.2/sentinel/sentinel_1.conf
similarity index 100%
rename from docker/sentinel_1/sentinel.conf
rename to docker/redis6.2/sentinel/sentinel_1.conf
diff --git a/docker/sentinel_2/sentinel.conf b/docker/redis6.2/sentinel/sentinel_2.conf
similarity index 100%
rename from docker/sentinel_2/sentinel.conf
rename to docker/redis6.2/sentinel/sentinel_2.conf
diff --git a/docker/sentinel_3/sentinel.conf b/docker/redis6.2/sentinel/sentinel_3.conf
similarity index 100%
rename from docker/sentinel_3/sentinel.conf
rename to docker/redis6.2/sentinel/sentinel_3.conf
diff --git a/docker/stunnel/README b/docker/stunnel/README
new file mode 100644
index 0000000000..e92ae78981
--- /dev/null
+++ b/docker/stunnel/README
@@ -0,0 +1 @@
+ This directory contains a helper script to create ssl certificates for ssl tests. If the certificates are out of date, re-run create_certs and check them in. These are snake oil certificates.
diff --git a/docker/stunnel/keys/ca-cert.pem b/docker/stunnel/keys/ca-cert.pem
new file mode 100644
index 0000000000..460354d9ad
--- /dev/null
+++ b/docker/stunnel/keys/ca-cert.pem
@@ -0,0 +1,21 @@
+-----BEGIN CERTIFICATE-----
+MIIDaDCCAlACCQCui7X/vxmwGjANBgkqhkiG9w0BAQsFADB1MQswCQYDVQQGEwJD
+QTERMA8GA1UECAwIV2lubmlwZWcxETAPBgNVBAcMCE1hbml0b2JhMRIwEAYDVQQK
+DAlTb21lIENvcnAxFjAUBgNVBAsMDUlUIERlcGFydG1lbnQxFDASBgNVBAMMC2V4
+YW1wbGUuY29tMCAXDTIyMDExMjE0NTQyMVoYDzMwMjEwNTE1MTQ1NDIxWjB1MQsw
+CQYDVQQGEwJDQTERMA8GA1UECAwIV2lubmlwZWcxETAPBgNVBAcMCE1hbml0b2Jh
+MRIwEAYDVQQKDAlTb21lIENvcnAxFjAUBgNVBAsMDUlUIERlcGFydG1lbnQxFDAS
+BgNVBAMMC2V4YW1wbGUuY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
+AQEAtSqof5fXyN/Y6GSLBBNA/zhrqw2qcBW4va6+Wc24WTaBXcP0w13njz+j1b5V
+9rbpz0i7WUkg3bBPecFFuCFyQnvn2JaE9b7kX1lLmszanrYfWQ9bYQyecox3HuYq
+eu330S+bD0liYh5rV7oEanuSCJW+a/dgEl3l/+Qb0zo2ZNEAXRuBv6lNmvBSsdIt
+lc5n/P06ntJ6Ia/7rO0ZEiBb6hLFKfiIo/XvDrGNlYulJEcDmC3PkzzJRGnA7R2F
+7Vggj4l4pGE/3EtnA4C/rd0Shf9TIPQFA2HOx3oYsrOonuBYM2urciNeojP5XGY/
+Zdau7hzgFBgF8tWsLU6bKyZ3NwIDAQABMA0GCSqGSIb3DQEBCwUAA4IBAQBJwnf3
+FARRxQF1Q2jIXQdyUS/lqq74C+PZF5IKOKb2K3dT1BFJlBgduvj4Ih5KUakImhMB
+SdaiwKzgB9APXNVAgrzSCb49PzXzvmaIFhPmBXSITFFfGupxpo0ZStwI03B0KZBs
+l3Zd0SzjKqZNVtTnxyDyWnYNFJtuCGanTjyPcCAFvVwzDQyzZ14liyM389WM950a
+ANM7H0iv6U/h7lWhnvBOlRfj89JChBvEROlWuYfyyELZpAXsmuwWdh0pwgGpqMI/
+EtLas2sbX5apE8P1S2Uxc+dS4IjoA/TrnP21rXwJ8AWzrntsZalSx9uueb1qhPp8
+EL7asG4+G3BpQrL1
+-----END CERTIFICATE-----
diff --git a/docker/stunnel/keys/ca-key.pem b/docker/stunnel/keys/ca-key.pem
new file mode 100644
index 0000000000..64db528c48
--- /dev/null
+++ b/docker/stunnel/keys/ca-key.pem
@@ -0,0 +1,27 @@
+-----BEGIN RSA PRIVATE KEY-----
+MIIEogIBAAKCAQEAtSqof5fXyN/Y6GSLBBNA/zhrqw2qcBW4va6+Wc24WTaBXcP0
+w13njz+j1b5V9rbpz0i7WUkg3bBPecFFuCFyQnvn2JaE9b7kX1lLmszanrYfWQ9b
+YQyecox3HuYqeu330S+bD0liYh5rV7oEanuSCJW+a/dgEl3l/+Qb0zo2ZNEAXRuB
+v6lNmvBSsdItlc5n/P06ntJ6Ia/7rO0ZEiBb6hLFKfiIo/XvDrGNlYulJEcDmC3P
+kzzJRGnA7R2F7Vggj4l4pGE/3EtnA4C/rd0Shf9TIPQFA2HOx3oYsrOonuBYM2ur
+ciNeojP5XGY/Zdau7hzgFBgF8tWsLU6bKyZ3NwIDAQABAoIBACq8mWsgAsNcKusH
+bNPVRuvt/1gmrSIrvZzhb/33TZmeBf58j2zW5h0gwiFV+SluFNHVMnzph1tEkDsE
+oNHC8hVE7XhmaY8fLPhhNDicQqZWCCcWPFQ0idwzzpX3beX55Q/vzwBYK2FCE8hq
+FUiZReXIjVci0AMFK5Cl2vqFLPezAGvaZ4/M1reOF3vCgWl8IXTwYOs4EYd1CJt7
+bMwO9Q6P8V0BVhJO2tdwIe5XL5X086sMMPYXqMuwX9m3vZFQFpsZobmoAyYLVY+h
+IMoQZdh4O4sFYPQBPzhZXluFDl8rX6G5A9jUPxDfeVz+799RXi31jTYeH01OwM89
+/0BNryECgYEA15hU0qDAnM7fBiTTGbRUT/QPOmEUOPcnWfLWOyJsovAVLL1X0jmt
+GFm+FkTtOlcTVgDHXeHNw81zrgDDuW7fwaKloPeyWhyO6rp2jntAz/OayfA5UYOf
+REhXdQH7rMAkGgy1t7zKGHTYAslHjD2dOikCuHH/13otSJS4wNvTaZUCgYEA1x6L
+abxYDpR7jn2Yym0CbIiZ6tqShtqLi4eNF7PDVe3rUM7gYU767UFSKPvRpsq+BFwf
+LLRFgpggNRDrZWoK0ZekHD1x8pCJF+O4pj/Fhra4uI+hInycRQ4xsj9VU/WftxQ4
+aOojB28F0fBO56T90caQVSR09DGNmElSQFcw4psCgYApf8n8DTNmO6/UV+xGi16b
+UUhJHXyuBm0NtF+mXFb6+impRf0Mm0uFX2jmknfzfeVb7aRyns9jvD1jJgSGwh/R
+/wPQuz0aeVrNNf0yKels3eBStKnj1eknVKF5BVuzgfyxAvdLmcxw7rTRvHrINOf5
+1QEQDemISZ1D1lTF0sqcDQKBgCmE6rGAuZouzF4nHZtMSOB7yQFMKGXAvpgylGfT
+uUrXfch99U6yuLmcFuh0GfXQQbaDtTyimpvnEqhLWLOdMPNdCj6tGVYQ0XT77cKg
+olYq5CIzDo2icWLep3bYxHZM/QOP8odFUXd41S287O3GqXqYkXjtbWlIOyT+WdKz
+QWsrAoGALnac4Vh2s12Cv3YiQbkPtBRe8oxI0h6DEIdBciPDGq6WXq6O2PXXuBhM
+X47mObUsSuzI6hI4/vd4/tXD7TM3fS1YDdZXj7d51ZjT/jmlTVxAHa3DJ8i7o+rH
+Fqv/lh6MB6FGkXZ9vAGQe5RwUbDD16QO/1mz7fg0YBA9A8plM8s=
+-----END RSA PRIVATE KEY-----
diff --git a/docker/stunnel/keys/client-cert.pem b/docker/stunnel/keys/client-cert.pem
new file mode 100644
index 0000000000..5c48eb8b3d
--- /dev/null
+++ b/docker/stunnel/keys/client-cert.pem
@@ -0,0 +1,21 @@
+-----BEGIN CERTIFICATE-----
+MIIDYDCCAkgCAQEwDQYJKoZIhvcNAQEFBQAwdTELMAkGA1UEBhMCQ0ExETAPBgNV
+BAgMCFdpbm5pcGVnMREwDwYDVQQHDAhNYW5pdG9iYTESMBAGA1UECgwJU29tZSBD
+b3JwMRYwFAYDVQQLDA1JVCBEZXBhcnRtZW50MRQwEgYDVQQDDAtleGFtcGxlLmNv
+bTAgFw0yMjAxMTIxNDU0MjFaGA8zMDIxMDUxNTE0NTQyMVowdTELMAkGA1UEBhMC
+Q0ExETAPBgNVBAgMCFdpbm5pcGVnMREwDwYDVQQHDAhNYW5pdG9iYTESMBAGA1UE
+CgwJU29tZSBDb3JwMRYwFAYDVQQLDA1JVCBEZXBhcnRtZW50MRQwEgYDVQQDDAtl
+eGFtcGxlLmNvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALwWezv2
+WHf6fCyiLYHmi3+Qf/33VmdNAapWzpOZ0Xmuzf8SSoEep/YotvnmIBe8DqspjzBW
+eeg+n7qre+qawGv1AOANlStLKeNvnXhWS0bdoAKMP68Q8jvU+YSmJNZTRkg/39MA
+YNqxYABYamoIQ7qX+g91HsCxPSzqIyjLwY4hPHGYfxGhRH5ne2RtsYEcMjOJWs8s
+U4x6wpwn9Y4vnG1AqpcwY4xm65g/52BWWM9WfZ++y17MynSdoE29EqXCAGqhh1i1
+IRlKN1vr/792VYzOm2fHScaaCaCmhDIlTw0TlOgnfi7CFtY0z6uizSwG4RWCW+3/
+g47T3q8aCnvlkCkCAwEAATANBgkqhkiG9w0BAQUFAAOCAQEAGuNzbKtvKsdfQaAV
+SmeNAZqyoG2Fbmh/txj6j+UThu3tadk07/SukgsM6yepeq05+wguW43eBtig/LzH
+pSHCn4s/w0fvu1GqePWsTdGI3xnJakZIlkOXPStIgZJNewT9rD6WoRfthvTOda8v
+NBjW0InACnVvzAivX9xhbUB4K/I8aEGaAZwzIGnQbsxygPVZKe/Y8oWhiks0qYo2
+Wev1Swli4EeqbYvg+3TMy7T1pDkjAmAdsv7yJAYKsM3xCu7K8vA/e+2J2hjUQIfI
+Thdjb6FNywihVaAK2BUqL6cMgF8I+nX7ywVOBAz+a3F00sSogapztinzqsjFDeT9
+5V/MSg==
+-----END CERTIFICATE-----
diff --git a/docker/stunnel/keys/client-key.pem b/docker/stunnel/keys/client-key.pem
new file mode 100644
index 0000000000..4117706d0e
--- /dev/null
+++ b/docker/stunnel/keys/client-key.pem
@@ -0,0 +1,28 @@
+-----BEGIN PRIVATE KEY-----
+MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQC8Fns79lh3+nws
+oi2B5ot/kH/991ZnTQGqVs6TmdF5rs3/EkqBHqf2KLb55iAXvA6rKY8wVnnoPp+6
+q3vqmsBr9QDgDZUrSynjb514VktG3aACjD+vEPI71PmEpiTWU0ZIP9/TAGDasWAA
+WGpqCEO6l/oPdR7AsT0s6iMoy8GOITxxmH8RoUR+Z3tkbbGBHDIziVrPLFOMesKc
+J/WOL5xtQKqXMGOMZuuYP+dgVljPVn2fvstezMp0naBNvRKlwgBqoYdYtSEZSjdb
+6/+/dlWMzptnx0nGmgmgpoQyJU8NE5ToJ34uwhbWNM+ros0sBuEVglvt/4OO096v
+Ggp75ZApAgMBAAECggEBAJDXLydJ2W7rMdydNzYld59Qg3/rjFoYbwPhvUrk1O9D
+sdaPG1i7ZtSlHeLrWCNu6kzcwCuVLGOwdgimLdLIQQ3hqj7fttOUGjnOphEZQvbb
+jHDp19DU1/VDWLLRzuRNVH4m0hIG5I8EsM0TST9GBgIXLrXgl0IEOvvvggvUfMUZ
+eGrrVsW56XIc25LZCalf20lcoyKa2hVjtlF2ds41PY6WqytkRJ7zpnBzO4g+Kz3D
+iA2rzNn/Ds2CCvuNDA8UF6qG/INbcySaq+qbSYLohWSsz9smIhkWUyF4YfbtziZr
+8AbxZKbS8VopSFxF+o35CbEZeTPkFkrBfbD0xUlCeEECgYEA6h1hLodTeQUpQoc3
+6brWvw1gM/tM0RyKbpOEwJGK1MnX99IM5z6qGY+d1htl7cB3RARpaY1HAvRXHhXt
+9qaSdhqR1hagZLn2vbelFkbJ0N1agdR6XYgGoxfH2RCluNfZZPOB6urfCLNbMjgb
+B1rkvIWiELCzujwsZ6m5sOomP70CgYEAzauggpcqEXQ4P4+y6B/8gOt7chuRczft
+1YTj2Y5tfZSTZmh01BUgenDgA1+NFJ9ni33P6+Ij/1D0ZGdea5Lqw2VP1ZDEIYSm
+j3ekkge/0AljZgIil2UviBhx5W2BlwnlukIwMvzVRwDulQsV3sDxprZKHYTaRcnC
+EB4Y9T6uUt0CgYBjeCojP8IaiDPYnWUHPKgjMoaub1Za/ppekvTzcKMg98V3+Noc
+okZZZ+iy4J81HfJOhuVWwHzsZ25gTQb3JhzSa0WNRb3OLikEwHM2/MqgoHvk76cx
++CqBvwfdVTJkT+mA9+k6K6KpqrLTqnzpahgHdWu/VaR3OzvOq5FG9qVbrQKBgF5F
+xRUW5RmLBB1eaMstnjgZuEPdjxYZFNNCTo5yUo21hLr0NljgNjrpckUZjzlct8Gg
+saWVyppFKUC8gPMeLK3TynxCFySmARLR7IVjN/DL3NvtLp3mq5reWZaoUzZAOyTd
+Ieq9KaWaL8HxitzH4/xeoipVsxc6G9H3eckwKgehAoGBAM/E0qLpEXOaLxODY8tt
++qpoNWHZn1M6cVX+tA/6igKfqUY96lefLmEiV1N01qW7+keFMXT12X/edsykG8jd
+gcNkNjSNwDSi8ixl0YlQwRJjX93TEip78sisQ3mCUqZUCNbm0Dm66Bqe8rAD5AdF
+G4oVbUu1gN0StX85Uw8J0AYS
+-----END PRIVATE KEY-----
diff --git a/docker/stunnel/keys/client-req.pem b/docker/stunnel/keys/client-req.pem
new file mode 100644
index 0000000000..ecf83f4daa
--- /dev/null
+++ b/docker/stunnel/keys/client-req.pem
@@ -0,0 +1,17 @@
+-----BEGIN CERTIFICATE REQUEST-----
+MIICujCCAaICAQAwdTELMAkGA1UEBhMCQ0ExETAPBgNVBAgMCFdpbm5pcGVnMREw
+DwYDVQQHDAhNYW5pdG9iYTESMBAGA1UECgwJU29tZSBDb3JwMRYwFAYDVQQLDA1J
+VCBEZXBhcnRtZW50MRQwEgYDVQQDDAtleGFtcGxlLmNvbTCCASIwDQYJKoZIhvcN
+AQEBBQADggEPADCCAQoCggEBALwWezv2WHf6fCyiLYHmi3+Qf/33VmdNAapWzpOZ
+0Xmuzf8SSoEep/YotvnmIBe8DqspjzBWeeg+n7qre+qawGv1AOANlStLKeNvnXhW
+S0bdoAKMP68Q8jvU+YSmJNZTRkg/39MAYNqxYABYamoIQ7qX+g91HsCxPSzqIyjL
+wY4hPHGYfxGhRH5ne2RtsYEcMjOJWs8sU4x6wpwn9Y4vnG1AqpcwY4xm65g/52BW
+WM9WfZ++y17MynSdoE29EqXCAGqhh1i1IRlKN1vr/792VYzOm2fHScaaCaCmhDIl
+Tw0TlOgnfi7CFtY0z6uizSwG4RWCW+3/g47T3q8aCnvlkCkCAwEAAaAAMA0GCSqG
+SIb3DQEBCwUAA4IBAQAqLgfkWWIE1RV1TENnr9jT+SK8u3F2nX4mUzNmy8azq52I
+fO8qPKmvV2amt5y961jNpR+rRpARncONuf6NQR5qCMu/EKjVi9BhOkoIOK0RjgtK
+AkCTON1J8022JDQpN5/H5ZpLDkIlBtpwDvEaR/PnTaJxtGwLY8HxY6h20PDjP3J9
+Xu3w3m/s3uVjFG07RDvbwK02vYskePnlsKVw+uu5C2blOQRlRVvdCCkwN0y6IiWW
+uRGRSzwufgejrfDUJG4VZuNpvWjFfzjHW105g1AxaTW3anRqBSNxYF+iawfbGdf4
+bGT4Wazbwq5uU3uixxOzxPMI5ZP/gn0ywz9S1RRK
+-----END CERTIFICATE REQUEST-----
diff --git a/docker/stunnel/keys/server-cert.pem b/docker/stunnel/keys/server-cert.pem
new file mode 100644
index 0000000000..3a1bf72011
--- /dev/null
+++ b/docker/stunnel/keys/server-cert.pem
@@ -0,0 +1,21 @@
+-----BEGIN CERTIFICATE-----
+MIIDYDCCAkgCAQEwDQYJKoZIhvcNAQEFBQAwdTELMAkGA1UEBhMCQ0ExETAPBgNV
+BAgMCFdpbm5pcGVnMREwDwYDVQQHDAhNYW5pdG9iYTESMBAGA1UECgwJU29tZSBD
+b3JwMRYwFAYDVQQLDA1JVCBEZXBhcnRtZW50MRQwEgYDVQQDDAtleGFtcGxlLmNv
+bTAgFw0yMjAxMTIxNDU0MjFaGA8zMDIxMDUxNTE0NTQyMVowdTELMAkGA1UEBhMC
+Q0ExETAPBgNVBAgMCFdpbm5pcGVnMREwDwYDVQQHDAhNYW5pdG9iYTESMBAGA1UE
+CgwJU29tZSBDb3JwMRYwFAYDVQQLDA1JVCBEZXBhcnRtZW50MRQwEgYDVQQDDAtl
+eGFtcGxlLmNvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMxZETTb
+dxqFsNjUIJbpS6ZT9RkH/dWYTVk1uRUMh6Cr6920g/7pSaRLIx8guTDHa1jhPIlX
+lax7oZyX9coLjhSc6cy0ZmoH0zrp8ZbRc/qOawuO62arKP89pO/18MB3r9zPb1PJ
+evTP203+2a8ly25cscMTUge+rHMFAUW+/01hc90CY9ial9oCl9wtoPdPGA8XlX3u
+RswOAM79fM+Szvv+bX0VvFakkfHIE8oIK5/rJYDswBKAshw5CjW/OEjD6FbCb84c
+1E7jJhwwd6X70yDMOrJ8iVkA/lpzfoosiuYm/okgbPPXWEo8aa//MrSH90l2+M9q
+Vvn8hbmwlJl+2IMCAwEAATANBgkqhkiG9w0BAQUFAAOCAQEAEcTps0CUnBZJBH/w
+8oJo8kAvsHhFTLJpTtiztut5qI+FMgC6sPcVUKi95gie2pdJ91y6sFzqLpghAciR
+ocYBy/jxK0M7OGJHLpUPeCS1yxeEyeZXpMPS90bUo1tPh7QDAojoRrFYo6M6DbL3
+dcErTJlvKnBBT9/DmENx75R+1nSB86vq0je+X0IqbZXeJyWju6ybjbwo1NPpnu+f
+jnXTG0+ZIsepms0VTXwcTy3dthIE+uw4XqTQ1qYg2stQAOUJ0nmb68NExi5zom5G
+0nh7tZnL0N+Z+XeNo7gaVatxfmgyk/HO2Vl4Wk4NA0PkR0yk2vNUwS0rKAb2mYc6
+T2gHdQ==
+-----END CERTIFICATE-----
diff --git a/docker/stunnel/keys/server-key.pem b/docker/stunnel/keys/server-key.pem
new file mode 100644
index 0000000000..62595e017c
--- /dev/null
+++ b/docker/stunnel/keys/server-key.pem
@@ -0,0 +1,28 @@
+-----BEGIN PRIVATE KEY-----
+MIIEvwIBADANBgkqhkiG9w0BAQEFAASCBKkwggSlAgEAAoIBAQDMWRE023cahbDY
+1CCW6UumU/UZB/3VmE1ZNbkVDIegq+vdtIP+6UmkSyMfILkwx2tY4TyJV5Wse6Gc
+l/XKC44UnOnMtGZqB9M66fGW0XP6jmsLjutmqyj/PaTv9fDAd6/cz29TyXr0z9tN
+/tmvJctuXLHDE1IHvqxzBQFFvv9NYXPdAmPYmpfaApfcLaD3TxgPF5V97kbMDgDO
+/XzPks77/m19FbxWpJHxyBPKCCuf6yWA7MASgLIcOQo1vzhIw+hWwm/OHNRO4yYc
+MHel+9MgzDqyfIlZAP5ac36KLIrmJv6JIGzz11hKPGmv/zK0h/dJdvjPalb5/IW5
+sJSZftiDAgMBAAECggEAct5+daAIy7frOXfE+hAanl0DohaD8dWzZTp12Ac7Fm6O
+IAqhSGILK3exPoY+k9UF2uiCBxJc6KB2sHgbioAEVkH+izu9dkz/yFZJn+YNtALq
+2Yx1dzkvyor0dI9jzk15Zj6U7hyMKaHOPYHNDE/Kkzc4Fdh+fCwK9H0TwgkjqnLj
+hfRK32+SqaftkhZnCxaFfdVVzhonWsaB7VcyUPdIHAMG0xUQ9oNTM0WLPotU/uh0
+XDCemwXhkqfKaAlnj0YBsu65WOTTiPixOPigDe745CHFBXwvCF28kxjSbCAVlHIv
+JcTtq1EA+fNHRTeHgNGSpqOdfuVrBMyp3KiztLBfQQKBgQD47MFmQphXVQWRmKoU
+gCFf28notV8J0VGyG7E0tFMS3GgyAAl8H8I6fB9UYOmD95PrHTROxKpc7jYtZRW3
+KcYJP5zKa+DqSSks8I5dLwFkKYVC0GiEJWuRwS9aHaD7ja65NtXJO+2iZ598s39w
+iSx0OAvaf9cFUrsAmHAE84c+/QKBgQDSJ/VE1CS0Tv2kL5Wbr/RmgYBZbXHnRz6j
+LFA7JwX3seHtuo+WBe8BMOMS4YqW6K2YTqwU8NtN1oATWg72TcLhwJZ3sKGPiMhM
+/cHW0dJqYsXujIOd/dlSr+j9Mouoxm6Spl+hGpj2IPUV9Dlm8N4SqPk83m0O+8Hy
+P088HK7NfwKBgQC3D0XbMjZeY0RJIoBRuzjQCg6eeGOAENOHrB3RqJs/T5/AxY40
+Hhb0c7uGjg6s4jGBwmRpWPAAj56AG8qwfKQKwSFJK7SoF02UowPPO3ZGdtJtpF54
+cBx/gBaWqxtsY3GO++iUqOHFgXckeczKsdZjUaRF96XlYEXt1izrNzzK8QKBgQCP
+OsCE6nkhknx3/B5g/2j4u+Y4DMmGsR3VpAwCZLRCfq/WkEHwI5cjHqiEY8dK1sYJ
+egT6OLWetUSQ694qrBDYP6PNa0qRQs4Q+xmzSUm5TBxOWuIROcN2AYIvntVkb+lI
+da/TYwdBKHEhR1Qf/qW73gIQJB/8CEXEzrU36OySDQKBgQD35khRdiU+1bPt/DpW
++8A+88BuxXMFxKYtEoMuTJnb7enarwp7+FtY6WhNgOgxELTpRbYw9496mOmNbJKL
+PmTXzs3aS5bv/2JTtc5+CHzf9PJ+jAYWnh9hCq9x/mA0QRMQAZEi8vhhYFaWiiV3
+wUYnDFnnAKia1VILt9jZ7I4T7Q==
+-----END PRIVATE KEY-----
diff --git a/docker/stunnel/keys/server-req.pem b/docker/stunnel/keys/server-req.pem
new file mode 100644
index 0000000000..361891d1c8
--- /dev/null
+++ b/docker/stunnel/keys/server-req.pem
@@ -0,0 +1,17 @@
+-----BEGIN CERTIFICATE REQUEST-----
+MIICujCCAaICAQAwdTELMAkGA1UEBhMCQ0ExETAPBgNVBAgMCFdpbm5pcGVnMREw
+DwYDVQQHDAhNYW5pdG9iYTESMBAGA1UECgwJU29tZSBDb3JwMRYwFAYDVQQLDA1J
+VCBEZXBhcnRtZW50MRQwEgYDVQQDDAtleGFtcGxlLmNvbTCCASIwDQYJKoZIhvcN
+AQEBBQADggEPADCCAQoCggEBAMxZETTbdxqFsNjUIJbpS6ZT9RkH/dWYTVk1uRUM
+h6Cr6920g/7pSaRLIx8guTDHa1jhPIlXlax7oZyX9coLjhSc6cy0ZmoH0zrp8ZbR
+c/qOawuO62arKP89pO/18MB3r9zPb1PJevTP203+2a8ly25cscMTUge+rHMFAUW+
+/01hc90CY9ial9oCl9wtoPdPGA8XlX3uRswOAM79fM+Szvv+bX0VvFakkfHIE8oI
+K5/rJYDswBKAshw5CjW/OEjD6FbCb84c1E7jJhwwd6X70yDMOrJ8iVkA/lpzfoos
+iuYm/okgbPPXWEo8aa//MrSH90l2+M9qVvn8hbmwlJl+2IMCAwEAAaAAMA0GCSqG
+SIb3DQEBCwUAA4IBAQCljqLOTU3tFEqxJ2AbZ5HVg9AN/SEUX8c/SyzCBii3r9Dj
+ubp0YWvYvgm7lnXsFAVDznf89RAzwdFur5iAQ95VfWBW6NEjdFQIh51KF6P/Qzjg
+TbctVeX/MTPuKewVhkQg9/sRmegbb+RBKEeCZccLUVuk5DAgFmi0cFP4e50uuNRG
+gwskG9nJp/X5aBd4Y1YKg8XS+WLPwwrYvffoHN8mWHh+YqF16MbxMHM5xRMWu6E7
+801EzEWAW5Y8J2ssp/9FSI+aXOhk68aNlIVNc2R6Rg1IA8zKV4WSWTMUWAud832h
+z9UZH/YkPgipuiflpKBGs5lbElRx3o6lYblhRL8J
+-----END CERTIFICATE REQUEST-----
diff --git a/tasks.py b/tasks.py
index 96005ca4e3..64b3aef80f 100644
--- a/tasks.py
+++ b/tasks.py
@@ -3,11 +3,6 @@
 
 from invoke import run, task
 
-
-def _generate_keys():
-    run("bash docker/stunnel/create_certs.sh")
-
-
 with open("tox.ini") as fp:
     lines = fp.read().split("\n")
     dockers = [line.split("=")[1].strip() for line in lines if line.find("name") != -1]
@@ -19,7 +14,6 @@ def devenv(c):
     specified in the tox.ini file.
     """
     clean(c)
-    _generate_keys()
     cmd = "tox -e devenv"
     for d in dockers:
         cmd += f" --docker-dont-stop={d}"
@@ -29,14 +23,12 @@ def devenv(c):
 @task
 def build_docs(c):
     """Generates the sphinx documentation."""
-    _generate_keys()
     run("tox -e docs")
 
 
 @task
 def linters(c):
     """Run code linters"""
-    _generate_keys()
     run("tox -e linters")
 
 
@@ -45,7 +37,6 @@ def all_tests(c):
     """Run all linters, and tests in redis-py. This assumes you have all
     the python versions specified in the tox.ini file.
     """
-    _generate_keys()
     linters(c)
     tests(c)
 
@@ -56,7 +47,6 @@ def tests(c):
     with and without hiredis.
     """
     print("Starting Redis tests")
-    _generate_keys()
     run("tox -e '{standalone,cluster}'-'{plain,hiredis}'")
 
 
@@ -65,7 +55,6 @@ def standalone_tests(c):
     """Run all Redis tests against the current python,
     with and without hiredis."""
     print("Starting Redis tests")
-    _generate_keys()
     run("tox -e standalone-'{plain,hiredis,ocsp}'")
 
 
@@ -74,7 +63,6 @@ def cluster_tests(c):
     """Run all Redis Cluster tests against the current python,
     with and without hiredis."""
     print("Starting RedisCluster tests")
-    _generate_keys()
     run("tox -e cluster-'{plain,hiredis}'")
 
 
@@ -86,8 +74,6 @@ def clean(c):
     if os.path.isdir("dist"):
         shutil.rmtree("dist")
     run(f"docker rm -f {' '.join(dockers)}")
-    if os.path.isdir("docker/stunnel/keys"):
-        shutil.rmtree("docker/stunnel/keys")
 
 
 @task
diff --git a/tox.ini b/tox.ini
index 5fbf6cd8a1..2639cb7a2e 100644
--- a/tox.ini
+++ b/tox.ini
@@ -19,7 +19,7 @@ ports =
     6379:6379/tcp
 healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',6379)) else False"
 volumes =
-    bind:rw:{toxinidir}/docker/master/redis.conf:/redis.conf
+    bind:rw:{toxinidir}/docker/redis6.2/master/redis.conf:/redis.conf
 
 [docker:replica]
 name = replica
@@ -30,7 +30,7 @@ ports =
     6380:6380/tcp
 healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',6380)) else False"
 volumes =
-    bind:rw:{toxinidir}/docker/replica/redis.conf:/redis.conf
+    bind:rw:{toxinidir}/docker/redis6.2/replica/redis.conf:/redis.conf
 
 [docker:unstable]
 name = unstable
@@ -64,7 +64,7 @@ ports =
     26379:26379/tcp
 healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26379)) else False"
 volumes =
-    bind:rw:{toxinidir}/docker/sentinel_1/sentinel.conf:/sentinel.conf
+    bind:rw:{toxinidir}/docker/redis6.2/sentinel/sentinel_1.conf:/sentinel.conf
 
 [docker:sentinel_2]
 name = sentinel_2
@@ -75,7 +75,7 @@ ports =
     26380:26380/tcp
 healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26380)) else False"
 volumes =
-    bind:rw:{toxinidir}/docker/sentinel_2/sentinel.conf:/sentinel.conf
+    bind:rw:{toxinidir}/docker/redis6.2/sentinel/sentinel_2.conf:/sentinel.conf
 
 [docker:sentinel_3]
 name = sentinel_3
@@ -86,7 +86,7 @@ ports =
     26381:26381/tcp
 healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26381)) else False"
 volumes =
-    bind:rw:{toxinidir}/docker/sentinel_3/sentinel.conf:/sentinel.conf
+    bind:rw:{toxinidir}/docker/redis6.2/sentinel/sentinel_3.conf:/sentinel.conf
 
 [docker:redismod]
 name = redismod
@@ -121,6 +121,129 @@ volumes =
     bind:ro:{toxinidir}/docker/stunnel/conf:/etc/stunnel/conf.d
     bind:ro:{toxinidir}/docker/stunnel/keys:/etc/stunnel/keys
 
+[docker:redis5_master]
+name = redis5_master
+image = redisfab/redis-py:5.0-buster
+ports =
+    6382:6382/tcp
+healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',6382)) else False"
+volumes =
+    bind:rw:{toxinidir}/docker/redis5/master/redis.conf:/redis.conf
+
+[docker:redis5_replica]
+name = redis5_replica
+image = redisfab/redis-py:5.0-buster
+links =
+    redis5_master:redis5_master
+ports =
+    6383:6383/tcp
+healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',6383)) else False"
+volumes =
+    bind:rw:{toxinidir}/docker/redis5/replica/redis.conf:/redis.conf
+
+[docker:redis5_sentinel_1]
+name = redis5_sentinel_1
+image = redisfab/redis-py-sentinel:5.0-buster
+links =
+    redis5_master:redis5_master
+ports =
+    26382:26382/tcp
+healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26382)) else False"
+volumes =
+    bind:rw:{toxinidir}/docker/redis5/sentinel/sentinel_1.conf:/sentinel.conf
+
+[docker:redis5_sentinel_2]
+name = redis5_sentinel_2
+image = redisfab/redis-py-sentinel:5.0-buster
+links =
+    redis5_master:redis5_master
+ports =
+    26383:26383/tcp
+healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26383)) else False"
+volumes =
+    bind:rw:{toxinidir}/docker/redis5/sentinel/sentinel_2.conf:/sentinel.conf
+
+[docker:redis5_sentinel_3]
+name = redis5_sentinel_3
+image = redisfab/redis-py-sentinel:5.0-buster
+links =
+    redis5_master:redis5_master
+ports =
+    26384:26384/tcp
+healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26384)) else False"
+volumes =
+    bind:rw:{toxinidir}/docker/redis5/sentinel/sentinel_3.conf:/sentinel.conf
+
+[docker:redis5_cluster]
+name = redis5_cluster
+image = redisfab/redis-py-cluster:5.0-buster
+ports =
+    16385:16385/tcp
+    16386:16386/tcp
+    16387:16387/tcp
+    16388:16388/tcp
+    16389:16389/tcp
+    16390:16390/tcp
+healtcheck_cmd = python -c "import socket;print(True) if all([0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',port)) for port in range(16385,16390)]) else False"
+volumes =
+    bind:rw:{toxinidir}/docker/cluster/redis.conf:/redis.conf
+
+[docker:redis4_master]
+name = redis4_master
+image = redisfab/redis-py:4.0-buster
+ports =
+    6381:6381/tcp
+healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',6381)) else False"
+volumes =
+    bind:rw:{toxinidir}/docker/redis4/master/redis.conf:/redis.conf
+
+[docker:redis4_sentinel_1]
+name = redis4_sentinel_1
+image = redisfab/redis-py-sentinel:4.0-buster
+links =
+    redis4_master:redis4_master
+ports =
+    26385:26385/tcp
+healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26385)) else False"
+volumes =
+    bind:rw:{toxinidir}/docker/redis4/sentinel/sentinel_1.conf:/sentinel.conf
+
+[docker:redis4_sentinel_2]
+name = redis4_sentinel_2
+image = redisfab/redis-py-sentinel:4.0-buster
+links =
+    redis4_master:redis4_master
+ports =
+    26386:26386/tcp
+healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26386)) else False"
+volumes =
+    bind:rw:{toxinidir}/docker/redis4/sentinel/sentinel_2.conf:/sentinel.conf
+
+[docker:redis4_sentinel_3]
+name = redis4_sentinel_3
+image = redisfab/redis-py-sentinel:4.0-buster
+links =
+    redis4_master:redis4_master
+ports =
+    26387:26387/tcp
+healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26387)) else False"
+volumes =
+    bind:rw:{toxinidir}/docker/redis4/sentinel/sentinel_3.conf:/sentinel.conf
+
+[docker:redis4_cluster]
+name = redis4_cluster
+image = redisfab/redis-py-cluster:4.0-buster
+ports =
+    16391:16391/tcp
+    16392:16392/tcp
+    16393:16393/tcp
+    16394:16394/tcp
+    16395:16395/tcp
+    16396:16396/tcp
+healtcheck_cmd = python -c "import socket;print(True) if all([0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',port)) for port in range(16391,16396)]) else False"
+volumes =
+    bind:rw:{toxinidir}/docker/cluster/redis.conf:/redis.conf
+
 [isort]
 profile = black
 multi_line_output = 3
@@ -145,18 +268,55 @@ extras =
     ocsp: cryptography, pyopenssl, requests
 setenv =
     CLUSTER_URL = "redis://localhost:16379/0"
-run_before = {toxinidir}/docker/stunnel/create_certs.sh
 commands =
     standalone: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' {posargs}
     cluster: pytest --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={env:CLUSTER_URL:} {posargs}
 
+[testenv:redis5]
+deps =
+    -r {toxinidir}/requirements.txt
+    -r {toxinidir}/dev_requirements.txt
+docker =
+    redis5_master
+    redis5_replica
+    redis5_sentinel_1
+    redis5_sentinel_2
+    redis5_sentinel_3
+    redis5_cluster
+extras =
+    hiredis: hiredis
+    cryptography: cryptography, requests
+setenv =
+    CLUSTER_URL = "redis://localhost:16385/0"
+commands =
+    standalone: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster and not redismod' {posargs}
+    cluster: pytest --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={env:CLUSTER_URL:} {posargs}
+
+[testenv:redis4]
+deps =
+    -r {toxinidir}/requirements.txt
+    -r {toxinidir}/dev_requirements.txt
+docker =
+    redis4_master
+    redis4_sentinel_1
+    redis4_sentinel_2
+    redis4_sentinel_3
+    redis4_cluster
+extras =
+    hiredis: hiredis
+    cryptography: cryptography, requests
+setenv =
+    CLUSTER_URL = "redis://localhost:16391/0"
+commands =
+    standalone: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster and not redismod' {posargs}
+    cluster: pytest --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={env:CLUSTER_URL:} {posargs}
+
 [testenv:devenv]
 skipsdist = true
 skip_install = true
 deps = -r {toxinidir}/dev_requirements.txt
 docker = {[testenv]docker}
 commands = /usr/bin/echo docker_up
-run_before = {[testenv]run_before}
 
 [testenv:linters]
 deps_files = dev_requirements.txt

From a5e59960ba1f53e75b2624999638d15ffd7592ca Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 3 Feb 2022 13:38:59 +0200
Subject: [PATCH 0373/1164] Add type hints for list commands (#1917)

* add type hints for list commands

* fix cluster tests

* linters

* delete breaking changes and switch to List

* linters
---
 redis/commands/core.py | 69 ++++++++++++++++++++++++------------------
 1 file changed, 39 insertions(+), 30 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index da95cea584..8e7683c6e4 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -2,7 +2,7 @@
 import hashlib
 import time
 import warnings
-from typing import List, Optional
+from typing import List, Optional, Union
 
 from redis.exceptions import ConnectionError, DataError, NoScriptError, RedisError
 
@@ -1864,7 +1864,7 @@ class ListCommands:
     see: https://redis.io/topics/data-types#lists
     """
 
-    def blpop(self, keys, timeout=0):
+    def blpop(self, keys: List, timeout: Optional[int] = 0) -> List:
         """
         LPOP a value off of the first non-empty list
         named in the ``keys`` list.
@@ -1883,7 +1883,7 @@ def blpop(self, keys, timeout=0):
         keys.append(timeout)
         return self.execute_command("BLPOP", *keys)
 
-    def brpop(self, keys, timeout=0):
+    def brpop(self, keys: List, timeout: Optional[int] = 0) -> List:
         """
         RPOP a value off of the first non-empty list
         named in the ``keys`` list.
@@ -1902,7 +1902,9 @@ def brpop(self, keys, timeout=0):
         keys.append(timeout)
         return self.execute_command("BRPOP", *keys)
 
-    def brpoplpush(self, src, dst, timeout=0):
+    def brpoplpush(
+        self, src: str, dst: str, timeout: Optional[int] = 0
+    ) -> Optional[str]:
         """
         Pop a value off the tail of ``src``, push it on the head of ``dst``
         and then return it.
@@ -1957,7 +1959,7 @@ def lmpop(
 
         return self.execute_command("LMPOP", *args)
 
-    def lindex(self, name, index):
+    def lindex(self, name: str, index: int) -> Optional[str]:
         """
         Return the item from list ``name`` at position ``index``
 
@@ -1968,7 +1970,7 @@ def lindex(self, name, index):
         """
         return self.execute_command("LINDEX", name, index)
 
-    def linsert(self, name, where, refvalue, value):
+    def linsert(self, name: str, where: str, refvalue: str, value: str) -> int:
         """
         Insert ``value`` in list ``name`` either immediately before or after
         [``where``] ``refvalue``
@@ -1980,7 +1982,7 @@ def linsert(self, name, where, refvalue, value):
         """
         return self.execute_command("LINSERT", name, where, refvalue, value)
 
-    def llen(self, name):
+    def llen(self, name: str) -> int:
         """
         Return the length of the list ``name``
 
@@ -1988,7 +1990,7 @@ def llen(self, name):
         """
         return self.execute_command("LLEN", name)
 
-    def lpop(self, name, count=None):
+    def lpop(self, name: str, count: Optional[int] = None) -> Union[str, List, None]:
         """
         Removes and returns the first elements of the list ``name``.
 
@@ -2003,7 +2005,7 @@ def lpop(self, name, count=None):
         else:
             return self.execute_command("LPOP", name)
 
-    def lpush(self, name, *values):
+    def lpush(self, name: str, *values: List) -> int:
         """
         Push ``values`` onto the head of the list ``name``
 
@@ -2011,7 +2013,7 @@ def lpush(self, name, *values):
         """
         return self.execute_command("LPUSH", name, *values)
 
-    def lpushx(self, name, *values):
+    def lpushx(self, name: str, *values: List) -> int:
         """
         Push ``value`` onto the head of the list ``name`` if ``name`` exists
 
@@ -2019,7 +2021,7 @@ def lpushx(self, name, *values):
         """
         return self.execute_command("LPUSHX", name, *values)
 
-    def lrange(self, name, start, end):
+    def lrange(self, name: str, start: int, end: int) -> List:
         """
         Return a slice of the list ``name`` between
         position ``start`` and ``end``
@@ -2031,7 +2033,7 @@ def lrange(self, name, start, end):
         """
         return self.execute_command("LRANGE", name, start, end)
 
-    def lrem(self, name, count, value):
+    def lrem(self, name: str, count: int, value: str) -> int:
         """
         Remove the first ``count`` occurrences of elements equal to ``value``
         from the list stored at ``name``.
@@ -2045,15 +2047,15 @@ def lrem(self, name, count, value):
         """
         return self.execute_command("LREM", name, count, value)
 
-    def lset(self, name, index, value):
+    def lset(self, name: str, index: int, value: str) -> str:
         """
-        Set ``position`` of list ``name`` to ``value``
+        Set element at ``index`` of list ``name`` to ``value``
 
         For more information check https://redis.io/commands/lset
         """
         return self.execute_command("LSET", name, index, value)
 
-    def ltrim(self, name, start, end):
+    def ltrim(self, name: str, start: int, end: int) -> str:
         """
         Trim the list ``name``, removing all values not within the slice
         between ``start`` and ``end``
@@ -2065,7 +2067,7 @@ def ltrim(self, name, start, end):
         """
         return self.execute_command("LTRIM", name, start, end)
 
-    def rpop(self, name, count=None):
+    def rpop(self, name: str, count: Optional[int] = None) -> Union[str, List, None]:
         """
         Removes and returns the last elements of the list ``name``.
 
@@ -2080,7 +2082,7 @@ def rpop(self, name, count=None):
         else:
             return self.execute_command("RPOP", name)
 
-    def rpoplpush(self, src, dst):
+    def rpoplpush(self, src: str, dst: str) -> str:
         """
         RPOP a value off of the ``src`` list and atomically LPUSH it
         on to the ``dst`` list.  Returns the value.
@@ -2089,7 +2091,7 @@ def rpoplpush(self, src, dst):
         """
         return self.execute_command("RPOPLPUSH", src, dst)
 
-    def rpush(self, name, *values):
+    def rpush(self, name: str, *values: List) -> int:
         """
         Push ``values`` onto the tail of the list ``name``
 
@@ -2097,7 +2099,7 @@ def rpush(self, name, *values):
         """
         return self.execute_command("RPUSH", name, *values)
 
-    def rpushx(self, name, value):
+    def rpushx(self, name: str, value: str) -> int:
         """
         Push ``value`` onto the tail of the list ``name`` if ``name`` exists
 
@@ -2105,7 +2107,14 @@ def rpushx(self, name, value):
         """
         return self.execute_command("RPUSHX", name, value)
 
-    def lpos(self, name, value, rank=None, count=None, maxlen=None):
+    def lpos(
+        self,
+        name: str,
+        value: str,
+        rank: Optional[int] = None,
+        count: Optional[int] = None,
+        maxlen: Optional[int] = None,
+    ) -> Union[str, List, None]:
         """
         Get position of ``value`` within the list ``name``
 
@@ -2145,16 +2154,16 @@ def lpos(self, name, value, rank=None, count=None, maxlen=None):
 
     def sort(
         self,
-        name,
-        start=None,
-        num=None,
-        by=None,
-        get=None,
-        desc=False,
-        alpha=False,
-        store=None,
-        groups=False,
-    ):
+        name: str,
+        start: Optional[int] = None,
+        num: Optional[int] = None,
+        by: Optional[str] = None,
+        get: Optional[List[str]] = None,
+        desc: bool = False,
+        alpha: bool = False,
+        store: Optional[str] = None,
+        groups: Optional[bool] = False,
+    ) -> Union[List, int]:
         """
         Sort and return the list, set or sorted set at ``name``.
 

From ee078bf994b64f3f2b193f25fa4e0681e09e0da9 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 3 Feb 2022 14:07:52 +0200
Subject: [PATCH 0374/1164] Add type hints for hash commands (#1919)

* Add type hint for hash commands

* switch to List

* linters
---
 redis/commands/core.py | 34 ++++++++++++++++++++--------------
 1 file changed, 20 insertions(+), 14 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 8e7683c6e4..eac21f2463 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3792,7 +3792,7 @@ class HashCommands:
     see: https://redis.io/topics/data-types-intro#redis-hashes
     """
 
-    def hdel(self, name, *keys):
+    def hdel(self, name: str, *keys: List) -> int:
         """
         Delete ``keys`` from hash ``name``
 
@@ -3800,7 +3800,7 @@ def hdel(self, name, *keys):
         """
         return self.execute_command("HDEL", name, *keys)
 
-    def hexists(self, name, key):
+    def hexists(self, name: str, key: str) -> bool:
         """
         Returns a boolean indicating if ``key`` exists within hash ``name``
 
@@ -3808,7 +3808,7 @@ def hexists(self, name, key):
         """
         return self.execute_command("HEXISTS", name, key)
 
-    def hget(self, name, key):
+    def hget(self, name: str, key: str) -> Optional[str]:
         """
         Return the value of ``key`` within the hash ``name``
 
@@ -3816,7 +3816,7 @@ def hget(self, name, key):
         """
         return self.execute_command("HGET", name, key)
 
-    def hgetall(self, name):
+    def hgetall(self, name: str) -> dict:
         """
         Return a Python dict of the hash's name/value pairs
 
@@ -3824,7 +3824,7 @@ def hgetall(self, name):
         """
         return self.execute_command("HGETALL", name)
 
-    def hincrby(self, name, key, amount=1):
+    def hincrby(self, name: str, key: str, amount: int = 1) -> int:
         """
         Increment the value of ``key`` in hash ``name`` by ``amount``
 
@@ -3832,7 +3832,7 @@ def hincrby(self, name, key, amount=1):
         """
         return self.execute_command("HINCRBY", name, key, amount)
 
-    def hincrbyfloat(self, name, key, amount=1.0):
+    def hincrbyfloat(self, name: str, key: str, amount: float = 1.0) -> float:
         """
         Increment the value of ``key`` in hash ``name`` by floating ``amount``
 
@@ -3840,7 +3840,7 @@ def hincrbyfloat(self, name, key, amount=1.0):
         """
         return self.execute_command("HINCRBYFLOAT", name, key, amount)
 
-    def hkeys(self, name):
+    def hkeys(self, name: str) -> List:
         """
         Return the list of keys within hash ``name``
 
@@ -3848,7 +3848,7 @@ def hkeys(self, name):
         """
         return self.execute_command("HKEYS", name)
 
-    def hlen(self, name):
+    def hlen(self, name: str) -> int:
         """
         Return the number of elements in hash ``name``
 
@@ -3856,7 +3856,13 @@ def hlen(self, name):
         """
         return self.execute_command("HLEN", name)
 
-    def hset(self, name, key=None, value=None, mapping=None):
+    def hset(
+        self,
+        name: str,
+        key: Optional[str] = None,
+        value: Optional[str] = None,
+        mapping: Optional[dict] = None,
+    ) -> int:
         """
         Set ``key`` to ``value`` within hash ``name``,
         ``mapping`` accepts a dict of key/value pairs that will be
@@ -3876,7 +3882,7 @@ def hset(self, name, key=None, value=None, mapping=None):
 
         return self.execute_command("HSET", name, *items)
 
-    def hsetnx(self, name, key, value):
+    def hsetnx(self, name: str, key: str, value: str) -> bool:
         """
         Set ``key`` to ``value`` within hash ``name`` if ``key`` does not
         exist.  Returns 1 if HSETNX created a field, otherwise 0.
@@ -3885,7 +3891,7 @@ def hsetnx(self, name, key, value):
         """
         return self.execute_command("HSETNX", name, key, value)
 
-    def hmset(self, name, mapping):
+    def hmset(self, name: str, mapping: dict) -> str:
         """
         Set key to value within hash ``name`` for each corresponding
         key and value from the ``mapping`` dict.
@@ -3905,7 +3911,7 @@ def hmset(self, name, mapping):
             items.extend(pair)
         return self.execute_command("HMSET", name, *items)
 
-    def hmget(self, name, keys, *args):
+    def hmget(self, name: str, keys: List, *args: List) -> List:
         """
         Returns a list of values ordered identically to ``keys``
 
@@ -3914,7 +3920,7 @@ def hmget(self, name, keys, *args):
         args = list_or_args(keys, args)
         return self.execute_command("HMGET", name, *args)
 
-    def hvals(self, name):
+    def hvals(self, name: str) -> List:
         """
         Return the list of values within hash ``name``
 
@@ -3922,7 +3928,7 @@ def hvals(self, name):
         """
         return self.execute_command("HVALS", name)
 
-    def hstrlen(self, name, key):
+    def hstrlen(self, name: str, key: str) -> int:
         """
         Return the number of bytes stored in the value of ``key``
         within hash ``name``

From 9442d34beb8254aebe87b9b48ef7e627e1079837 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 3 Feb 2022 14:37:26 +0200
Subject: [PATCH 0375/1164] Add type hints for set commands (#1918)

* add type hint for set commands

* switch to List
---
 redis/commands/core.py | 34 +++++++++++++++++++---------------
 1 file changed, 19 insertions(+), 15 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index eac21f2463..8c259792cd 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -2393,7 +2393,7 @@ class SetCommands:
     see: https://redis.io/topics/data-types#sets
     """
 
-    def sadd(self, name, *values):
+    def sadd(self, name: str, *values: List) -> int:
         """
         Add ``value(s)`` to set ``name``
 
@@ -2401,7 +2401,7 @@ def sadd(self, name, *values):
         """
         return self.execute_command("SADD", name, *values)
 
-    def scard(self, name):
+    def scard(self, name: str) -> int:
         """
         Return the number of elements in set ``name``
 
@@ -2409,7 +2409,7 @@ def scard(self, name):
         """
         return self.execute_command("SCARD", name)
 
-    def sdiff(self, keys, *args):
+    def sdiff(self, keys: List, *args: List) -> List:
         """
         Return the difference of sets specified by ``keys``
 
@@ -2418,7 +2418,7 @@ def sdiff(self, keys, *args):
         args = list_or_args(keys, args)
         return self.execute_command("SDIFF", *args)
 
-    def sdiffstore(self, dest, keys, *args):
+    def sdiffstore(self, dest: str, keys: List, *args: List) -> int:
         """
         Store the difference of sets specified by ``keys`` into a new
         set named ``dest``.  Returns the number of keys in the new set.
@@ -2428,7 +2428,7 @@ def sdiffstore(self, dest, keys, *args):
         args = list_or_args(keys, args)
         return self.execute_command("SDIFFSTORE", dest, *args)
 
-    def sinter(self, keys, *args):
+    def sinter(self, keys: List, *args: List) -> List:
         """
         Return the intersection of sets specified by ``keys``
 
@@ -2450,7 +2450,7 @@ def sintercard(self, numkeys: int, keys: List[str], limit: int = 0) -> int:
         args = [numkeys, *keys, "LIMIT", limit]
         return self.execute_command("SINTERCARD", *args)
 
-    def sinterstore(self, dest, keys, *args):
+    def sinterstore(self, dest: str, keys: List, *args: List) -> int:
         """
         Store the intersection of sets specified by ``keys`` into a new
         set named ``dest``.  Returns the number of keys in the new set.
@@ -2460,7 +2460,7 @@ def sinterstore(self, dest, keys, *args):
         args = list_or_args(keys, args)
         return self.execute_command("SINTERSTORE", dest, *args)
 
-    def sismember(self, name, value):
+    def sismember(self, name: str, value: str) -> bool:
         """
         Return a boolean indicating if ``value`` is a member of set ``name``
 
@@ -2468,7 +2468,7 @@ def sismember(self, name, value):
         """
         return self.execute_command("SISMEMBER", name, value)
 
-    def smembers(self, name):
+    def smembers(self, name: str) -> List:
         """
         Return all members of the set ``name``
 
@@ -2476,7 +2476,7 @@ def smembers(self, name):
         """
         return self.execute_command("SMEMBERS", name)
 
-    def smismember(self, name, values, *args):
+    def smismember(self, name: str, values: List, *args: List) -> List[bool]:
         """
         Return whether each value in ``values`` is a member of the set ``name``
         as a list of ``bool`` in the order of ``values``
@@ -2486,7 +2486,7 @@ def smismember(self, name, values, *args):
         args = list_or_args(values, args)
         return self.execute_command("SMISMEMBER", name, *args)
 
-    def smove(self, src, dst, value):
+    def smove(self, src: str, dst: str, value: str) -> bool:
         """
         Move ``value`` from set ``src`` to set ``dst`` atomically
 
@@ -2494,7 +2494,7 @@ def smove(self, src, dst, value):
         """
         return self.execute_command("SMOVE", src, dst, value)
 
-    def spop(self, name, count=None):
+    def spop(self, name: str, count: Optional[int] = None) -> Union[str, List, None]:
         """
         Remove and return a random member of set ``name``
 
@@ -2503,7 +2503,11 @@ def spop(self, name, count=None):
         args = (count is not None) and [count] or []
         return self.execute_command("SPOP", name, *args)
 
-    def srandmember(self, name, number=None):
+    def srandmember(
+        self,
+        name: str,
+        number: Optional[int] = None,
+    ) -> Union[str, List, None]:
         """
         If ``number`` is None, returns a random member of set ``name``.
 
@@ -2516,7 +2520,7 @@ def srandmember(self, name, number=None):
         args = (number is not None) and [number] or []
         return self.execute_command("SRANDMEMBER", name, *args)
 
-    def srem(self, name, *values):
+    def srem(self, name: str, *values: List) -> int:
         """
         Remove ``values`` from set ``name``
 
@@ -2524,7 +2528,7 @@ def srem(self, name, *values):
         """
         return self.execute_command("SREM", name, *values)
 
-    def sunion(self, keys, *args):
+    def sunion(self, keys: List, *args: List) -> List:
         """
         Return the union of sets specified by ``keys``
 
@@ -2533,7 +2537,7 @@ def sunion(self, keys, *args):
         args = list_or_args(keys, args)
         return self.execute_command("SUNION", *args)
 
-    def sunionstore(self, dest, keys, *args):
+    def sunionstore(self, dest: str, keys: List, *args: List) -> int:
         """
         Store the union of sets specified by ``keys`` into a new
         set named ``dest``.  Returns the number of keys in the new set.

From a87a750ed1a39138ba4526537335012fc95142c9 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 6 Feb 2022 10:19:36 +0200
Subject: [PATCH 0376/1164] Add support for ZMPOP (#1923)

---
 redis/commands/core.py | 25 +++++++++++++++++++++++++
 tests/test_commands.py | 11 +++++++++++
 2 files changed, 36 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 8c259792cd..80eb8e8feb 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3325,6 +3325,31 @@ def bzpopmin(self, keys, timeout=0):
         keys.append(timeout)
         return self.execute_command("BZPOPMIN", *keys)
 
+    def zmpop(
+        self,
+        num_keys: int,
+        keys: List[str],
+        min: Optional[bool] = False,
+        max: Optional[bool] = False,
+        count: Optional[int] = 1,
+    ) -> list:
+        """
+        Pop ``count`` values (default 1) off of the first non-empty sorted set
+        named in the ``keys`` list.
+        For more information check https://redis.io/commands/zmpop
+        """
+        args = [num_keys] + keys
+        if (min and max) or (not min and not max):
+            raise DataError
+        elif min:
+            args.append("MIN")
+        else:
+            args.append("MAX")
+        if count != 1:
+            args.extend(["COUNT", count])
+
+        return self.execute_command("ZMPOP", *args)
+
     def bzmpop(
         self,
         timeout: float,
diff --git a/tests/test_commands.py b/tests/test_commands.py
index c8f7ddc3f4..a2d9335952 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2106,6 +2106,17 @@ def test_bzpopmin(self, r):
         r.zadd("c", {"c1": 100})
         assert r.bzpopmin("c", timeout=1) == (b"c", b"c1", 100)
 
+    @pytest.mark.onlynoncluster
+    # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
+    def test_zmpop(self, unstable_r):
+        unstable_r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        res = [b"a", [[b"a1", b"1"], [b"a2", b"2"]]]
+        assert unstable_r.zmpop("2", ["b", "a"], min=True, count=2) == res
+        with pytest.raises(redis.DataError):
+            unstable_r.zmpop("2", ["b", "a"], count=2)
+        unstable_r.zadd("b", {"b1": 10, "ab": 9, "b3": 8})
+        assert unstable_r.zmpop("2", ["b", "a"], max=True) == [b"b", [[b"b1", b"10"]]]
+
     @pytest.mark.onlynoncluster
     # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
     def test_bzmpop(self, unstable_r):

From d7dab861280ecd7dece8d96b3d05cea85d7abac2 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 6 Feb 2022 12:05:10 +0200
Subject: [PATCH 0377/1164] Throw NotImplementedError for AUTH (#1910)

* unsupported auth

* unsupported-auth

* add test and docstring

* fix docstring
---
 redis/commands/core.py | 9 +++++++++
 tests/test_commands.py | 4 ++++
 2 files changed, 13 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 80eb8e8feb..99bf14dc44 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -315,6 +315,15 @@ class ManagementCommands:
     Redis management commands
     """
 
+    def auth(self):
+        """
+        This function throws a NotImplementedError since it is intentionally
+        not supported.
+        """
+        raise NotImplementedError(
+            "AUTH is intentionally not implemented in the client."
+        )
+
     def bgrewriteaof(self, **kwargs):
         """Tell the Redis server to rewrite the AOF file from data in memory.
 
diff --git a/tests/test_commands.py b/tests/test_commands.py
index a2d9335952..6ee204b04c 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -71,6 +71,10 @@ def test_command_on_invalid_key_type(self, r):
             r["a"]
 
     # SERVER INFORMATION
+    def test_auth_not_implemented(self, r):
+        with pytest.raises(NotImplementedError):
+            r.auth()
+
     @skip_if_server_version_lt("6.0.0")
     def test_acl_cat_no_category(self, r):
         categories = r.acl_cat()

From f9d8091bec3e83cbc0a699ac7b79894559ee0b3f Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 6 Feb 2022 12:05:39 +0200
Subject: [PATCH 0378/1164] Throw NotImplementedError for FAILOVER (#1911)

* unsupported failover

* add test and docstring

* fix docstring
---
 redis/commands/core.py | 9 +++++++++
 tests/test_commands.py | 5 +++++
 2 files changed, 14 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 99bf14dc44..139208e0b8 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1087,6 +1087,15 @@ def wait(self, num_replicas, timeout, **kwargs):
         """
         return self.execute_command("WAIT", num_replicas, timeout, **kwargs)
 
+    def failover(self):
+        """
+        This function throws a NotImplementedError since it is intentionally
+        not supported.
+        """
+        raise NotImplementedError(
+            "FAILOVER is intentionally not implemented in the client."
+        )
+
 
 class BasicKeyCommands:
     """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 6ee204b04c..f2d5ed9e17 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -647,6 +647,11 @@ def test_config_set(self, r):
         assert r.config_set("timeout", 0)
         assert r.config_get()["timeout"] == "0"
 
+    @skip_if_server_version_lt("6.0.0")
+    def test_failover(self, r):
+        with pytest.raises(NotImplementedError):
+            r.failover()
+
     @pytest.mark.onlynoncluster
     def test_dbsize(self, r):
         r["a"] = "foo"

From ba3134cd6bbd9093028badfb3f37f214b6668055 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 6 Feb 2022 13:17:45 +0200
Subject: [PATCH 0379/1164] Throw NotImplementedError for HELLO (#1912)

* unsupported hello

* add test and docstring

* linters

* fix docstring

* linters

* linters
---
 redis/commands/core.py | 9 +++++++++
 tests/test_commands.py | 5 +++++
 2 files changed, 14 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 139208e0b8..1b8cb80700 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1087,6 +1087,15 @@ def wait(self, num_replicas, timeout, **kwargs):
         """
         return self.execute_command("WAIT", num_replicas, timeout, **kwargs)
 
+    def hello(self):
+        """
+        This function throws a NotImplementedError since it is intentionally
+        not supported.
+        """
+        raise NotImplementedError(
+            "HELLO is intentionally not implemented in the client."
+        )
+
     def failover(self):
         """
         This function throws a NotImplementedError since it is intentionally
diff --git a/tests/test_commands.py b/tests/test_commands.py
index f2d5ed9e17..7d9866500f 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -624,6 +624,11 @@ def test_client_getredir(self, r):
         assert isinstance(r.client_getredir(), int)
         assert r.client_getredir() == -1
 
+    @skip_if_server_version_lt("6.0.0")
+    def test_hello_notI_implemented(self, r):
+        with pytest.raises(NotImplementedError):
+            r.hello()
+
     def test_config_get(self, r):
         data = r.config_get()
         assert len(data.keys()) > 10

From 30be3a35b18c0041e96e6a1b17fa6b323253d2b2 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 6 Feb 2022 14:24:07 +0200
Subject: [PATCH 0380/1164] Add type hints for JSON commands (#1921)

* add type hints for json commands

* Change json.clear test multi to be up to date with redisjson (#1922)

* fix json clear test

* fix json clear test

* Add support for BZMPOP (#1851)

* add bzmpop

* add comment

* fix pr comment

* fix linters

* fix pr comments

* add client no-evict (#1856)

* Add support for ZINTERCARD (#1857)

* add zintercard

* fix pr comment

* linters

* Add support for EVAL_RO (#1862)

* add sort_ro

* mark test as onlynon cluster

* delete mark test as onlynoncluster

* add eval_ro

* fix linters

* delete sort_ro

* fix pr comment

* add type hints

* add type hints

* linters

* Add support for EVALSHA_RO (#1863)

* add evalsha-ro

* fix pr comment

* add type hints

* add type hints

* Fix naming conventions (#1872)

* fix naming convention

* fix worng changes

* fix naming convention in rootPath
---
 docs/examples/search_json_examples.ipynb |   6 +-
 redis/commands/json/_util.py             |   3 +
 redis/commands/json/commands.py          | 107 ++++++++++++++++++-----
 3 files changed, 89 insertions(+), 27 deletions(-)
 create mode 100644 redis/commands/json/_util.py

diff --git a/docs/examples/search_json_examples.ipynb b/docs/examples/search_json_examples.ipynb
index 6673663687..b66e3361c7 100644
--- a/docs/examples/search_json_examples.ipynb
+++ b/docs/examples/search_json_examples.ipynb
@@ -59,9 +59,9 @@
     "        \"city\": \"Tel Aviv\"\n",
     "    }\n",
     "}\n",
-    "r.json().set(\"user:1\", Path.rootPath(), user1)\n",
-    "r.json().set(\"user:2\", Path.rootPath(), user2)\n",
-    "r.json().set(\"user:3\", Path.rootPath(), user3)\n",
+    "r.json().set(\"user:1\", Path.root_path(), user1)\n",
+    "r.json().set(\"user:2\", Path.root_path(), user2)\n",
+    "r.json().set(\"user:3\", Path.root_path(), user3)\n",
     "\n",
     "schema = (TextField(\"$.user.name\", as_name=\"name\"),TagField(\"$.user.city\", as_name=\"city\"), NumericField(\"$.user.age\", as_name=\"age\"))\n",
     "r.ft().create_index(schema, definition=IndexDefinition(prefix=[\"user:\"], index_type=IndexType.JSON))"
diff --git a/redis/commands/json/_util.py b/redis/commands/json/_util.py
new file mode 100644
index 0000000000..3400bcd60f
--- /dev/null
+++ b/redis/commands/json/_util.py
@@ -0,0 +1,3 @@
+from typing import Any, Dict, List, Union
+
+JsonType = Union[str, int, float, bool, None, Dict[str, Any], List[Any]]
diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index 03ab0c4b8d..6588aca0f2 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -1,10 +1,12 @@
 import os
 from json import JSONDecodeError, loads
+from typing import Dict, List, Optional, Union
 
 from deprecated import deprecated
 
 from redis.exceptions import DataError
 
+from ._util import JsonType
 from .decoders import decode_dict_keys
 from .path import Path
 
@@ -12,7 +14,9 @@
 class JSONCommands:
     """json commands."""
 
-    def arrappend(self, name, path=Path.root_path(), *args):
+    def arrappend(
+        self, name: str, path: Optional[str] = Path.root_path(), *args: List[JsonType]
+    ) -> List[Union[int, None]]:
         """Append the objects ``args`` to the array under the
         ``path` in key ``name``.
 
@@ -23,7 +27,14 @@ def arrappend(self, name, path=Path.root_path(), *args):
             pieces.append(self._encode(o))
         return self.execute_command("JSON.ARRAPPEND", *pieces)
 
-    def arrindex(self, name, path, scalar, start=0, stop=-1):
+    def arrindex(
+        self,
+        name: str,
+        path: str,
+        scalar: int,
+        start: Optional[int] = 0,
+        stop: Optional[int] = -1,
+    ) -> List[Union[int, None]]:
         """
         Return the index of ``scalar`` in the JSON array under ``path`` at key
         ``name``.
@@ -37,7 +48,9 @@ def arrindex(self, name, path, scalar, start=0, stop=-1):
             "JSON.ARRINDEX", name, str(path), self._encode(scalar), start, stop
         )
 
-    def arrinsert(self, name, path, index, *args):
+    def arrinsert(
+        self, name: str, path: str, index: int, *args: List[JsonType]
+    ) -> List[Union[int, None]]:
         """Insert the objects ``args`` to the array at index ``index``
         under the ``path` in key ``name``.
 
@@ -48,7 +61,9 @@ def arrinsert(self, name, path, index, *args):
             pieces.append(self._encode(o))
         return self.execute_command("JSON.ARRINSERT", *pieces)
 
-    def arrlen(self, name, path=Path.root_path()):
+    def arrlen(
+        self, name: str, path: Optional[str] = Path.root_path()
+    ) -> List[Union[int, None]]:
         """Return the length of the array JSON value under ``path``
         at key``name``.
 
@@ -56,7 +71,13 @@ def arrlen(self, name, path=Path.root_path()):
         """  # noqa
         return self.execute_command("JSON.ARRLEN", name, str(path))
 
-    def arrpop(self, name, path=Path.root_path(), index=-1):
+    def arrpop(
+        self,
+        name: str,
+        path: Optional[str] = Path.root_path(),
+        index: Optional[int] = -1,
+    ) -> List[Union[str, None]]:
+
         """Pop the element at ``index`` in the array JSON value under
         ``path`` at key ``name``.
 
@@ -64,7 +85,9 @@ def arrpop(self, name, path=Path.root_path(), index=-1):
         """  # noqa
         return self.execute_command("JSON.ARRPOP", name, str(path), index)
 
-    def arrtrim(self, name, path, start, stop):
+    def arrtrim(
+        self, name: str, path: str, start: int, stop: int
+    ) -> List[Union[int, None]]:
         """Trim the array JSON value under ``path`` at key ``name`` to the
         inclusive range given by ``start`` and ``stop``.
 
@@ -72,21 +95,23 @@ def arrtrim(self, name, path, start, stop):
         """  # noqa
         return self.execute_command("JSON.ARRTRIM", name, str(path), start, stop)
 
-    def type(self, name, path=Path.root_path()):
+    def type(self, name: str, path: Optional[str] = Path.root_path()) -> List[str]:
         """Get the type of the JSON value under ``path`` from key ``name``.
 
         For more information: https://oss.redis.com/redisjson/commands/#jsontype
         """  # noqa
         return self.execute_command("JSON.TYPE", name, str(path))
 
-    def resp(self, name, path=Path.root_path()):
+    def resp(self, name: str, path: Optional[str] = Path.root_path()) -> List:
         """Return the JSON value under ``path`` at key ``name``.
 
         For more information: https://oss.redis.com/redisjson/commands/#jsonresp
         """  # noqa
         return self.execute_command("JSON.RESP", name, str(path))
 
-    def objkeys(self, name, path=Path.root_path()):
+    def objkeys(
+        self, name: str, path: Optional[str] = Path.root_path()
+    ) -> List[Union[List[str], None]]:
         """Return the key names in the dictionary JSON value under ``path`` at
         key ``name``.
 
@@ -94,7 +119,7 @@ def objkeys(self, name, path=Path.root_path()):
         """  # noqa
         return self.execute_command("JSON.OBJKEYS", name, str(path))
 
-    def objlen(self, name, path=Path.root_path()):
+    def objlen(self, name: str, path: Optional[str] = Path.root_path()) -> int:
         """Return the length of the dictionary JSON value under ``path`` at key
         ``name``.
 
@@ -102,7 +127,7 @@ def objlen(self, name, path=Path.root_path()):
         """  # noqa
         return self.execute_command("JSON.OBJLEN", name, str(path))
 
-    def numincrby(self, name, path, number):
+    def numincrby(self, name: str, path: str, number: int) -> str:
         """Increment the numeric (integer or floating point) JSON value under
         ``path`` at key ``name`` by the provided ``number``.
 
@@ -113,7 +138,7 @@ def numincrby(self, name, path, number):
         )
 
     @deprecated(version="4.0.0", reason="deprecated since redisjson 1.0.0")
-    def nummultby(self, name, path, number):
+    def nummultby(self, name: str, path: str, number: int) -> str:
         """Multiply the numeric (integer or floating point) JSON value under
         ``path`` at key ``name`` with the provided ``number``.
 
@@ -123,7 +148,7 @@ def nummultby(self, name, path, number):
             "JSON.NUMMULTBY", name, str(path), self._encode(number)
         )
 
-    def clear(self, name, path=Path.root_path()):
+    def clear(self, name: str, path: Optional[str] = Path.root_path()) -> int:
         """
         Empty arrays and objects (to have zero slots/keys without deleting the
         array/object).
@@ -135,7 +160,7 @@ def clear(self, name, path=Path.root_path()):
         """  # noqa
         return self.execute_command("JSON.CLEAR", name, str(path))
 
-    def delete(self, key, path=Path.root_path()):
+    def delete(self, key: str, path: Optional[str] = Path.root_path()) -> int:
         """Delete the JSON value stored at key ``key`` under ``path``.
 
         For more information: https://oss.redis.com/redisjson/commands/#jsondel
@@ -145,7 +170,9 @@ def delete(self, key, path=Path.root_path()):
     # forget is an alias for delete
     forget = delete
 
-    def get(self, name, *args, no_escape=False):
+    def get(
+        self, name: str, *args, no_escape: Optional[bool] = False
+    ) -> List[JsonType]:
         """
         Get the object stored as a JSON value at key ``name``.
 
@@ -173,7 +200,7 @@ def get(self, name, *args, no_escape=False):
         except TypeError:
             return None
 
-    def mget(self, keys, path):
+    def mget(self, keys: List[str], path: str) -> List[JsonType]:
         """
         Get the objects stored as a JSON values under ``path``. ``keys``
         is a list of one or more keys.
@@ -185,7 +212,15 @@ def mget(self, keys, path):
         pieces.append(str(path))
         return self.execute_command("JSON.MGET", *pieces)
 
-    def set(self, name, path, obj, nx=False, xx=False, decode_keys=False):
+    def set(
+        self,
+        name: str,
+        path: str,
+        obj: JsonType,
+        nx: Optional[bool] = False,
+        xx: Optional[bool] = False,
+        decode_keys: Optional[bool] = False,
+    ) -> Optional[str]:
         """
         Set the JSON value at key ``name`` under the ``path`` to ``obj``.
 
@@ -216,7 +251,15 @@ def set(self, name, path, obj, nx=False, xx=False, decode_keys=False):
             pieces.append("XX")
         return self.execute_command("JSON.SET", *pieces)
 
-    def set_file(self, name, path, file_name, nx=False, xx=False, decode_keys=False):
+    def set_file(
+        self,
+        name: str,
+        path: str,
+        file_name: str,
+        nx: Optional[bool] = False,
+        xx: Optional[bool] = False,
+        decode_keys: Optional[bool] = False,
+    ) -> Optional[str]:
         """
         Set the JSON value at key ``name`` under the ``path`` to the content
         of the json file ``file_name``.
@@ -233,7 +276,14 @@ def set_file(self, name, path, file_name, nx=False, xx=False, decode_keys=False)
 
         return self.set(name, path, file_content, nx=nx, xx=xx, decode_keys=decode_keys)
 
-    def set_path(self, json_path, root_folder, nx=False, xx=False, decode_keys=False):
+    def set_path(
+        self,
+        json_path: str,
+        root_folder: str,
+        nx: Optional[bool] = False,
+        xx: Optional[bool] = False,
+        decode_keys: Optional[bool] = False,
+    ) -> List[Dict[str, bool]]:
         """
         Iterate over ``root_folder`` and set each JSON file to a value
         under ``json_path`` with the file name as the key.
@@ -264,7 +314,7 @@ def set_path(self, json_path, root_folder, nx=False, xx=False, decode_keys=False
 
         return set_files_result
 
-    def strlen(self, name, path=None):
+    def strlen(self, name: str, path: Optional[str] = None) -> List[Union[int, None]]:
         """Return the length of the string JSON value under ``path`` at key
         ``name``.
 
@@ -275,7 +325,9 @@ def strlen(self, name, path=None):
             pieces.append(str(path))
         return self.execute_command("JSON.STRLEN", *pieces)
 
-    def toggle(self, name, path=Path.root_path()):
+    def toggle(
+        self, name: str, path: Optional[str] = Path.root_path()
+    ) -> Union[bool, List[Optional[int]]]:
         """Toggle boolean value under ``path`` at key ``name``.
         returning the new value.
 
@@ -283,7 +335,9 @@ def toggle(self, name, path=Path.root_path()):
         """  # noqa
         return self.execute_command("JSON.TOGGLE", name, str(path))
 
-    def strappend(self, name, value, path=Path.root_path()):
+    def strappend(
+        self, name: str, value: str, path: Optional[int] = Path.root_path()
+    ) -> Union[int, List[Optional[int]]]:
         """Append to the string JSON value. If two options are specified after
         the key name, the path is determined to be the first. If a single
         option is passed, then the root_path (i.e Path.root_path()) is used.
@@ -293,11 +347,16 @@ def strappend(self, name, value, path=Path.root_path()):
         pieces = [name, str(path), self._encode(value)]
         return self.execute_command("JSON.STRAPPEND", *pieces)
 
-    def debug(self, subcommand, key=None, path=Path.root_path()):
+    def debug(
+        self,
+        subcommand: str,
+        key: Optional[str] = None,
+        path: Optional[str] = Path.root_path(),
+    ) -> Union[int, List[str]]:
         """Return the memory usage in bytes of a value under ``path`` from
         key ``name``.
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsondebg
+        For more information: https://oss.redis.com/redisjson/commands/#jsondebug
         """  # noqa
         valid_subcommands = ["MEMORY", "HELP"]
         if subcommand not in valid_subcommands:

From 9b99bf98375574540a5f1642d0fd7900781d0761 Mon Sep 17 00:00:00 2001
From: dogukanteber <47397379+dogukanteber@users.noreply.github.com>
Date: Sun, 6 Feb 2022 16:08:51 +0300
Subject: [PATCH 0381/1164] Add set and get examples (#1916)

---
 docs/examples.rst                        |   1 +
 docs/examples/set_and_get_examples.ipynb | 302 +++++++++++++++++++++++
 2 files changed, 303 insertions(+)
 create mode 100644 docs/examples/set_and_get_examples.ipynb

diff --git a/docs/examples.rst b/docs/examples.rst
index cf70c09bf9..fb57499e65 100644
--- a/docs/examples.rst
+++ b/docs/examples.rst
@@ -8,3 +8,4 @@ Examples
    examples/connection_examples
    examples/ssl_connection_examples
    examples/search_json_examples
+   examples/set_and_get_examples
diff --git a/docs/examples/set_and_get_examples.ipynb b/docs/examples/set_and_get_examples.ipynb
new file mode 100644
index 0000000000..e45c72a665
--- /dev/null
+++ b/docs/examples/set_and_get_examples.ipynb
@@ -0,0 +1,302 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "a3b456e8",
+   "metadata": {},
+   "source": [
+    "# Basic ```set``` and ```get``` operations"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a59abd54",
+   "metadata": {},
+   "source": [
+    "## Start off by connecting to the redis server\n",
+    "\n",
+    "To understand what ```decode_responses=True``` does, refer back to [this document](connection_examples.ipynb)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "97aa8747",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 1,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "import redis \n",
+    "\n",
+    "r = redis.Redis(decode_responses=True)\n",
+    "r.ping()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "218e137f",
+   "metadata": {},
+   "source": [
+    "The most basic usage of ```set``` and ```get```"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "12992c68",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 2,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "r.set(\"full_name\", \"john doe\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "bc9f3888",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "1"
+      ]
+     },
+     "execution_count": 3,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "r.exists(\"full_name\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "id": "dc64aec8",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "'john doe'"
+      ]
+     },
+     "execution_count": 4,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "r.get(\"full_name\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "353d334f",
+   "metadata": {},
+   "source": [
+    "We can override the existing value by calling ```set``` method for the same key"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "id": "c61389ce",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 5,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "r.set(\"full_name\", \"overridee!\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "id": "5e34a520",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "'overridee!'"
+      ]
+     },
+     "execution_count": 6,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "r.get(\"full_name\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "4ae3747b",
+   "metadata": {},
+   "source": [
+    "It is also possible to pass an expiration value to the key by using ```setex``` method"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "9b87449b",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 7,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "r.setex(\"important_key\", 100, \"important_value\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "id": "a11fe79d",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "100"
+      ]
+     },
+     "execution_count": 8,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "r.ttl(\"important_key\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "87c16991",
+   "metadata": {},
+   "source": [
+    "A dictionary can be inserted like this"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "id": "3cfa5713",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 9,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "dict_data = {\n",
+    "    \"employee_name\": \"Adam Adams\",\n",
+    "    \"employee_age\": 30,\n",
+    "    \"position\": \"Software Engineer\",\n",
+    "}\n",
+    "\n",
+    "r.mset(dict_data)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6d32dbee",
+   "metadata": {},
+   "source": [
+    "To get multiple keys' values, we can use mget. If a non-existing key is also passed, Redis return None for that key"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "id": "45ce1231",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "['Adam Adams', '30', 'Software Engineer', None]"
+      ]
+     },
+     "execution_count": 10,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "r.mget(\"employee_name\", \"employee_age\", \"position\", \"non_existing\")"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.9.5"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

From b1ffbc91b2c0ee305dd9fd9ebe01654a7ec18e8b Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 6 Feb 2022 15:24:08 +0200
Subject: [PATCH 0382/1164] add support for lcs (#1924)

---
 redis/commands/core.py | 29 +++++++++++++++++++++++++++++
 tests/test_commands.py | 11 +++++++++++
 2 files changed, 40 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 1b8cb80700..cef0c28e57 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1884,6 +1884,35 @@ def unlink(self, *names):
         """
         return self.execute_command("UNLINK", *names)
 
+    def lcs(
+        self,
+        key1: str,
+        key2: str,
+        len: Optional[bool] = False,
+        idx: Optional[bool] = False,
+        minmatchlen: Optional[int] = 0,
+        withmatchlen: Optional[bool] = False,
+    ) -> Union[str, int, list]:
+        """
+        Find the longest common subsequence between ``key1`` and ``key2``.
+        If ``len`` is true the length of the match will will be returned.
+        If ``idx`` is true the match position in each strings will be returned.
+        ``minmatchlen`` restrict the list of matches to the ones of
+        the given ``minmatchlen``.
+        If ``withmatchlen`` the length of the match also will be returned.
+        For more information check https://redis.io/commands/lcs
+        """
+        pieces = [key1, key2]
+        if len:
+            pieces.append("LEN")
+        if idx:
+            pieces.append("IDX")
+        if minmatchlen != 0:
+            pieces.extend(["MINMATCHLEN", minmatchlen])
+        if withmatchlen:
+            pieces.append("WITHMATCHLEN")
+        return self.execute_command("LCS", *pieces)
+
 
 class ListCommands:
     """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 7d9866500f..0e27836b05 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -968,6 +968,17 @@ def test_unlink_with_multiple_keys(self, r):
         assert r.get("a") is None
         assert r.get("b") is None
 
+    @pytest.mark.onlynoncluster
+    # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
+    def test_lcs(self, unstable_r):
+        unstable_r.mset({"foo": "ohmytext", "bar": "mynewtext"})
+        assert unstable_r.lcs("foo", "bar") == b"mytext"
+        assert unstable_r.lcs("foo", "bar", len=True) == 6
+        result = [b"matches", [[[4, 7], [5, 8]]], b"len", 6]
+        assert unstable_r.lcs("foo", "bar", idx=True, minmatchlen=3) == result
+        with pytest.raises(redis.ResponseError):
+            assert unstable_r.lcs("foo", "bar", len=True, idx=True)
+
     @skip_if_server_version_lt("2.6.0")
     def test_dump_and_restore(self, r):
         r["a"] = "foo"

From 045d5ed15305ccc44a0330e6f65f669998815598 Mon Sep 17 00:00:00 2001
From: "Meir Shpilraien (Spielrein)" <meir@redis.com>
Date: Mon, 7 Feb 2022 09:46:45 +0200
Subject: [PATCH 0383/1164] Fix flushdb and flushall (#1926)

* Fix flushdb and flushall

Both commands should be broadcasted to all the shards.

* Support ssl_password on cluster

* linter fix

* change commands to run only on primary nodes

Co-authored-by: Chayim I. Kirshen <c@kirshen.com>
Co-authored-by: dvora-h <dvora.heller@redis.com>
---
 redis/cluster.py      | 10 ++++++++--
 tests/test_cluster.py |  7 +++++++
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index 546472357d..b594d3084a 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -118,6 +118,7 @@ def fix_server(*args):
     "ssl_certfile",
     "ssl_cert_reqs",
     "ssl_keyfile",
+    "ssl_password",
     "unix_socket_path",
     "username",
 )
@@ -241,8 +242,6 @@ class RedisCluster(RedisClusterCommands):
                 "SHUTDOWN",
                 "KEYS",
                 "SCAN",
-                "FLUSHALL",
-                "FLUSHDB",
                 "DBSIZE",
                 "BGSAVE",
                 "SLOWLOG GET",
@@ -286,6 +285,13 @@ class RedisCluster(RedisClusterCommands):
             ],
             DEFAULT_NODE,
         ),
+        list_keys_to_dict(
+            [
+                "FLUSHALL",
+                "FLUSHDB",
+            ],
+            PRIMARIES,
+        ),
         list_keys_to_dict(
             [
                 "CLUSTER COUNTKEYSINSLOT",
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 90f52d4899..ab98ed515d 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -2640,3 +2640,10 @@ def test_command_with_escaped_data(self, r):
             r.get(byte_string)
             response = wait_for_command(r, m, "GET {foo}bar\\\\x92", key=key)
             assert response["command"] == "GET {foo}bar\\\\x92"
+
+    def test_flush(self, r):
+        r.set("x", "1")
+        r.set("z", "1")
+        r.flushall()
+        assert r.get("x") is None
+        assert r.get("y") is None

From 42ffc3e06564b4b02975fa3114cbb37ab6572ca6 Mon Sep 17 00:00:00 2001
From: Ariel Shtul <ariel.shtul@redislabs.com>
Date: Wed, 9 Feb 2022 19:01:14 +0200
Subject: [PATCH 0384/1164] fix quantile test (#1920)

* fix quantile test

* add space
---
 tests/test_search.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/test_search.py b/tests/test_search.py
index 18bb9adecf..531cbb6015 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -964,7 +964,7 @@ def test_aggregations_groupby(client):
 
     res = client.ft().aggregate(req).rows[0]
     assert res[1] == "redis"
-    assert res[3] == "10"
+    assert res[3] == "8"  # median of 3,8,10
 
     req = aggregations.AggregateRequest("redis").group_by(
         "@parent",

From ae043a6031d7d569511912f4e9234d0395ee9e40 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 10 Feb 2022 14:31:53 +0200
Subject: [PATCH 0385/1164] update 4.1.3 changes (#1934)

---
 CHANGES | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/CHANGES b/CHANGES
index d32d52d5da..d3dca69a47 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,9 @@
+* 4.1.3 (Feb 8, 2022)
+  * Fix flushdb and flushall (#1926)
+  * Add redis5 and redis4 dockers (#1871)
+  * Change json.clear test multi to be up to date with redisjson (#1922)
+  * Fixing volume for unstable_cluster docker (#1914)
+  * Update changes file with changes since 4.0.0-beta2 (#1915)
 * 4.1.2 (Jan 27, 2022)
     * Invalid OCSP certificates should raise ConnectionError on failed validation (#1907)
     * Added retry mechanism on socket timeouts when connecting to the server (#1895)

From 195880a310a068f370eb71ad59fc8240e308e00d Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 10 Feb 2022 15:35:19 +0200
Subject: [PATCH 0386/1164] add changes workflow (#1913)

---
 .github/workflows/update-changes.yaml | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 .github/workflows/update-changes.yaml

diff --git a/.github/workflows/update-changes.yaml b/.github/workflows/update-changes.yaml
new file mode 100644
index 0000000000..5cffb94c5e
--- /dev/null
+++ b/.github/workflows/update-changes.yaml
@@ -0,0 +1,24 @@
+name: Update CHANGES File
+on:
+  push:
+    paths-ignore:
+      - 'CHANGES'
+    branches:
+      - master
+jobs:
+  update-changes:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@master
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+      - name: Update CHANGES file
+        run: |
+          sed -i '1s/^/* ${{ github.event.head_commit.message }}. Thanks @${{ github.actor }}\n/' changes
+      - name: Commit & Push changes
+        uses: actions-js/push@master
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          branch: master
+          message: ${{ github.event.head_commit.message }}
\ No newline at end of file

From c5eafcc6e551de4d899b43f9a115e0d9965e6111 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 10 Feb 2022 15:52:16 +0200
Subject: [PATCH 0387/1164] Fix changes workflow (#1935)

* add changes workflow

* Update update-changes.yaml
---
 .github/workflows/update-changes.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/update-changes.yaml b/.github/workflows/update-changes.yaml
index 5cffb94c5e..4bb2bca8bb 100644
--- a/.github/workflows/update-changes.yaml
+++ b/.github/workflows/update-changes.yaml
@@ -15,10 +15,10 @@ jobs:
           fetch-depth: 0
       - name: Update CHANGES file
         run: |
-          sed -i '1s/^/* ${{ github.event.head_commit.message }}. Thanks @${{ github.actor }}\n/' changes
+          sed -i '1s/^/* ${{ github.event.head_commit.message }}. Thanks @${{ github.actor }}\n/' CHANGES
       - name: Commit & Push changes
         uses: actions-js/push@master
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           branch: master
-          message: ${{ github.event.head_commit.message }}
\ No newline at end of file
+          message: ${{ github.event.head_commit.message }}

From 857d839459b647b7bef073b5a871e17923ac5916 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 13 Feb 2022 12:23:45 +0200
Subject: [PATCH 0388/1164] Fix changes workflow (#1962)

* add changes workflow

* Update update-changes.yaml

* Fix changes workflow
---
 .github/workflows/update-changes.yaml | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/update-changes.yaml b/.github/workflows/update-changes.yaml
index 4bb2bca8bb..e2add9acee 100644
--- a/.github/workflows/update-changes.yaml
+++ b/.github/workflows/update-changes.yaml
@@ -15,7 +15,11 @@ jobs:
           fetch-depth: 0
       - name: Update CHANGES file
         run: |
-          sed -i '1s/^/* ${{ github.event.head_commit.message }}. Thanks @${{ github.actor }}\n/' CHANGES
+          COMMIT="${{ github.event.head_commit.message }}"
+          PR_TITLE=`echo "${COMMIT}" | head -n 1`
+          echo "* ${PR_TITLE}" Thanks @${{ github.actor }} > TMP_CHANGES
+          cat CHANGES >> TMP_CHANGES
+          mv TMP_CHANGES CHANGES
       - name: Commit & Push changes
         uses: actions-js/push@master
         with:

From aafa7f1ba150afb6d003e813386895e7ca08db6d Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 14 Feb 2022 13:23:32 +0200
Subject: [PATCH 0389/1164] Change changes-workflow to run on PR (#1983)

* add changes workflow

* Update update-changes.yaml

* Fix changes workflow

* change workflow to run on pull request

* delete condition from commit & push

* adding tab in beginning of line
---
 .github/workflows/update-changes.yaml | 25 ++++++++++++++-----------
 1 file changed, 14 insertions(+), 11 deletions(-)

diff --git a/.github/workflows/update-changes.yaml b/.github/workflows/update-changes.yaml
index e2add9acee..960da04cda 100644
--- a/.github/workflows/update-changes.yaml
+++ b/.github/workflows/update-changes.yaml
@@ -1,28 +1,31 @@
 name: Update CHANGES File
 on:
-  push:
-    paths-ignore:
-      - 'CHANGES'
+  pull_request:
+    types: [opened]
     branches:
       - master
 jobs:
   update-changes:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@master
+      - uses: actions/checkout@v2
         with:
           persist-credentials: false
           fetch-depth: 0
+          
+      - name: Get changed files
+        id: changed-files
+        uses: tj-actions/changed-files@v14.6
+          
       - name: Update CHANGES file
+        if: "!contains(steps.changed-files.outputs.all_changed_files, 'CHANGES')" 
         run: |
-          COMMIT="${{ github.event.head_commit.message }}"
-          PR_TITLE=`echo "${COMMIT}" | head -n 1`
-          echo "* ${PR_TITLE}" Thanks @${{ github.actor }} > TMP_CHANGES
-          cat CHANGES >> TMP_CHANGES
-          mv TMP_CHANGES CHANGES
+          echo -e "\t* ${{ github.event.pull_request.title }} (#${{ github.event.pull_request.number }}). Thanks @${{ github.actor }}" > CHANGES2
+          cat CHANGES >> CHANGES2
+          mv CHANGES2 CHANGES
       - name: Commit & Push changes
         uses: actions-js/push@master
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          branch: master
-          message: ${{ github.event.head_commit.message }}
+          branch: ${{ github.head_ref }}
+          message: "Update CHANGES file"

From 968035308e12e2fcefe28b6507e9c4e715eb8331 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 15 Feb 2022 13:06:56 +0200
Subject: [PATCH 0390/1164] Delete update-changes workflow and edit PR template
 (#1990)

---
 .github/PULL_REQUEST_TEMPLATE.md      |  1 +
 .github/workflows/update-changes.yaml | 31 ---------------------------
 2 files changed, 1 insertion(+), 31 deletions(-)
 delete mode 100644 .github/workflows/update-changes.yaml

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index 58062a1e2d..a46d8c9bbc 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -7,6 +7,7 @@ _Please make sure to review and check all of these items:_
 - [ ] Is the new or changed code fully tested?
 - [ ] Is a documentation update included (if this change modifies existing APIs, or introduces new ones)?
 - [ ] Is there an example added to the examples folder (if applicable)?
+- [ ] Is the changes added to CHANGES file?
 
 _NOTE: these things are not required to open a PR and can be done
 afterwards / while the PR is open._
diff --git a/.github/workflows/update-changes.yaml b/.github/workflows/update-changes.yaml
deleted file mode 100644
index 960da04cda..0000000000
--- a/.github/workflows/update-changes.yaml
+++ /dev/null
@@ -1,31 +0,0 @@
-name: Update CHANGES File
-on:
-  pull_request:
-    types: [opened]
-    branches:
-      - master
-jobs:
-  update-changes:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
-        with:
-          persist-credentials: false
-          fetch-depth: 0
-          
-      - name: Get changed files
-        id: changed-files
-        uses: tj-actions/changed-files@v14.6
-          
-      - name: Update CHANGES file
-        if: "!contains(steps.changed-files.outputs.all_changed_files, 'CHANGES')" 
-        run: |
-          echo -e "\t* ${{ github.event.pull_request.title }} (#${{ github.event.pull_request.number }}). Thanks @${{ github.actor }}" > CHANGES2
-          cat CHANGES >> CHANGES2
-          mv CHANGES2 CHANGES
-      - name: Commit & Push changes
-        uses: actions-js/push@master
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          branch: ${{ github.head_ref }}
-          message: "Update CHANGES file"

From ec3680bcdd268914626fd1679fe24401ac50dc9a Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 15 Feb 2022 13:08:35 +0200
Subject: [PATCH 0391/1164] Vector similarity search support (#1986)

---
 redis/commands/search/commands.py | 42 ++++++++++++++++++++----
 tests/test_search.py              | 53 +++++++++++++++++++++++++++++++
 2 files changed, 88 insertions(+), 7 deletions(-)

diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 94edea168c..5c4734c7c8 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -1,5 +1,6 @@
 import itertools
 import time
+from typing import Dict, Union
 
 from ..helpers import parse_to_dict
 from ._util import to_string
@@ -377,7 +378,17 @@ def info(self):
         it = map(to_string, res)
         return dict(zip(it, it))
 
-    def _mk_query_args(self, query):
+    def get_params_args(self, query_params: Dict[str, Union[str, int, float]]):
+        args = []
+        if len(query_params) > 0:
+            args.append("params")
+            args.append(len(query_params) * 2)
+            for key, value in query_params.items():
+                args.append(key)
+                args.append(value)
+        return args
+
+    def _mk_query_args(self, query, query_params: Dict[str, Union[str, int, float]]):
         args = [self.index_name]
 
         if isinstance(query, str):
@@ -387,9 +398,16 @@ def _mk_query_args(self, query):
             raise ValueError(f"Bad query type {type(query)}")
 
         args += query.get_args()
+        if query_params is not None:
+            args += self.get_params_args(query_params)
+
         return args, query
 
-    def search(self, query):
+    def search(
+        self,
+        query: Union[str, Query],
+        query_params: Dict[str, Union[str, int, float]] = None,
+    ):
         """
         Search the index for a given query, and return a result of documents
 
@@ -401,7 +419,7 @@ def search(self, query):
 
         For more information: https://oss.redis.com/redisearch/Commands/#ftsearch
         """  # noqa
-        args, query = self._mk_query_args(query)
+        args, query = self._mk_query_args(query, query_params=query_params)
         st = time.time()
         res = self.execute_command(SEARCH_CMD, *args)
 
@@ -413,18 +431,26 @@ def search(self, query):
             with_scores=query._with_scores,
         )
 
-    def explain(self, query):
+    def explain(
+        self,
+        query=Union[str, Query],
+        query_params: Dict[str, Union[str, int, float]] = None,
+    ):
         """Returns the execution plan for a complex query.
 
         For more information: https://oss.redis.com/redisearch/Commands/#ftexplain
         """  # noqa
-        args, query_text = self._mk_query_args(query)
+        args, query_text = self._mk_query_args(query, query_params=query_params)
         return self.execute_command(EXPLAIN_CMD, *args)
 
-    def explain_cli(self, query):  # noqa
+    def explain_cli(self, query: Union[str, Query]):  # noqa
         raise NotImplementedError("EXPLAINCLI will not be implemented.")
 
-    def aggregate(self, query):
+    def aggregate(
+        self,
+        query: Union[str, Query],
+        query_params: Dict[str, Union[str, int, float]] = None,
+    ):
         """
         Issue an aggregation query.
 
@@ -445,6 +471,8 @@ def aggregate(self, query):
             cmd = [CURSOR_CMD, "READ", self.index_name] + query.build_args()
         else:
             raise ValueError("Bad query", query)
+        if query_params is not None:
+            cmd += self.get_params_args(query_params)
 
         raw = self.execute_command(*cmd)
         return self._get_aggregate_result(raw, query, has_cursor)
diff --git a/tests/test_search.py b/tests/test_search.py
index 531cbb6015..5ee17a2c36 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1521,3 +1521,56 @@ def test_profile_limited(client):
     )
     assert det["Iterators profile"]["Type"] == "INTERSECT"
     assert len(res.docs) == 3  # check also the search result
+
+
+@pytest.mark.redismod
+def test_text_params(modclient):
+    modclient.flushdb()
+    modclient.ft().create_index((TextField("name"),))
+
+    modclient.ft().add_document("doc1", name="Alice")
+    modclient.ft().add_document("doc2", name="Bob")
+    modclient.ft().add_document("doc3", name="Carol")
+
+    params_dict = {"name1": "Alice", "name2": "Bob"}
+    q = Query("@name:($name1 | $name2 )")
+    res = modclient.ft().search(q, query_params=params_dict)
+    assert 2 == res.total
+    assert "doc1" == res.docs[0].id
+    assert "doc2" == res.docs[1].id
+
+
+@pytest.mark.redismod
+def test_numeric_params(modclient):
+    modclient.flushdb()
+    modclient.ft().create_index((NumericField("numval"),))
+
+    modclient.ft().add_document("doc1", numval=101)
+    modclient.ft().add_document("doc2", numval=102)
+    modclient.ft().add_document("doc3", numval=103)
+
+    params_dict = {"min": 101, "max": 102}
+    q = Query("@numval:[$min $max]")
+    res = modclient.ft().search(q, query_params=params_dict)
+
+    assert 2 == res.total
+    assert "doc1" == res.docs[0].id
+    assert "doc2" == res.docs[1].id
+
+
+@pytest.mark.redismod
+def test_geo_params(modclient):
+
+    modclient.flushdb()
+    modclient.ft().create_index((GeoField("g")))
+    modclient.ft().add_document("doc1", g="29.69465, 34.95126")
+    modclient.ft().add_document("doc2", g="29.69350, 34.94737")
+    modclient.ft().add_document("doc3", g="29.68746, 34.94882")
+
+    params_dict = {"lat": "34.95126", "lon": "29.69465", "radius": 1000, "units": "km"}
+    q = Query("@g:[$lon $lat $radius $units]")
+    res = modclient.ft().search(q, query_params=params_dict)
+    assert 3 == res.total
+    assert "doc1" == res.docs[0].id
+    assert "doc2" == res.docs[1].id
+    assert "doc3" == res.docs[2].id

From d6fad87fab5275125556ff4db6a3a66f596ebb12 Mon Sep 17 00:00:00 2001
From: Jason Huang <huangmianrui0310@outlook.com>
Date: Tue, 15 Feb 2022 19:10:01 +0800
Subject: [PATCH 0392/1164] docs: fix the wrong link to watch command (#1984)

---
 redis/commands/core.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index cef0c28e57..5074e8064d 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1864,7 +1864,7 @@ def watch(self, *names):
         """
         Watches the values at keys ``names``, or None if the key doesn't exist
 
-        For more information check https://redis.io/commands/type
+        For more information check https://redis.io/commands/watch
         """
         warnings.warn(DeprecationWarning("Call WATCH from a Pipeline object"))
 

From 9a02bfd569c632e3563ad4c4af1f363174ec1af8 Mon Sep 17 00:00:00 2001
From: Jose Toro <josetoro@google.com>
Date: Tue, 15 Feb 2022 12:10:24 +0100
Subject: [PATCH 0393/1164] Fix typo in readme (#1936)

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 867f921d99..f35c7bb13a 100644
--- a/README.md
+++ b/README.md
@@ -1203,7 +1203,7 @@ Please note:
 - The pipeline gets its 'read_from_replicas' value from the cluster's parameter.
 Thus, if read from replications is enabled in the cluster instance, the pipeline
 will also direct read commands to replicas.
-- The 'transcation' option is NOT supported in cluster-mode. In non-cluster mode,
+- The 'transaction' option is NOT supported in cluster-mode. In non-cluster mode,
 the 'transaction' option is available when executing pipelines. This wraps the
 pipeline commands with MULTI/EXEC commands, and effectively turns the pipeline
 commands into a single transaction block. This means that all commands are

From e6ccc9ce52047c455d16abb87dd0ba8004347b75 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 15 Feb 2022 16:18:40 +0200
Subject: [PATCH 0394/1164] Create codeql-analysis.yml (#1988)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
---
 .github/workflows/codeql-analysis.yml | 68 +++++++++++++++++++++++++++
 CHANGES                               |  1 +
 2 files changed, 69 insertions(+)
 create mode 100644 .github/workflows/codeql-analysis.yml

diff --git a/.github/workflows/codeql-analysis.yml b/.github/workflows/codeql-analysis.yml
new file mode 100644
index 0000000000..b92c52f88d
--- /dev/null
+++ b/.github/workflows/codeql-analysis.yml
@@ -0,0 +1,68 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: [ master ]
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'python' ]
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby' ]
+        # Learn more about CodeQL language support at https://git.io/codeql-language-support
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v2
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v1
+      with:
+        languages: ${{ matrix.language }}
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+        # queries: ./path/to/local/query, your-org/your-repo/queries@main
+
+    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
+    # If this step fails, then you should remove it and run the build manually (see below)
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v1
+
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 https://git.io/JvXDl
+
+    # ✏️ If the Autobuild fails above, remove it and uncomment the following three lines
+    #    and modify them (or add more) to build your code if your project
+    #    uses a compiled language
+
+    #- run: |
+    #   make bootstrap
+    #   make release
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v1
diff --git a/CHANGES b/CHANGES
index d3dca69a47..8da3a8b675 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+	* Create codeql-analysis.yml (#1988). Thanks @chayim
 * 4.1.3 (Feb 8, 2022)
   * Fix flushdb and flushall (#1926)
   * Add redis5 and redis4 dockers (#1871)

From c56a7584388f9e76c689ee147fae548cdcba59b9 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 16 Feb 2022 09:28:56 +0200
Subject: [PATCH 0395/1164] Adding ExecutionPlan support for graph (#1993)

---
 redis/commands/graph/commands.py       |  52 ++++---
 redis/commands/graph/execution_plan.py | 208 +++++++++++++++++++++++++
 tests/test_graph.py                    | 127 +++++++++++++--
 3 files changed, 351 insertions(+), 36 deletions(-)
 create mode 100644 redis/commands/graph/execution_plan.py

diff --git a/redis/commands/graph/commands.py b/redis/commands/graph/commands.py
index 157f628339..baed1fc2f7 100644
--- a/redis/commands/graph/commands.py
+++ b/redis/commands/graph/commands.py
@@ -2,6 +2,7 @@
 from redis.exceptions import ResponseError
 
 from .exceptions import VersionMismatchException
+from .execution_plan import ExecutionPlan
 from .query_result import QueryResult
 
 
@@ -118,27 +119,6 @@ def flush(self):
         self.nodes = {}
         self.edges = []
 
-    def explain(self, query, params=None):
-        """
-        Get the execution plan for given query,
-        Returns an array of operations.
-        For more information see `GRAPH.EXPLAIN <https://oss.redis.com/redisgraph/master/commands/#graphexplain>`_. # noqa
-
-        Args:
-
-        query:
-            The query that will be executed.
-        params: dict
-            Query parameters.
-        """
-        if params is not None:
-            query = self._build_params_header(params) + query
-
-        plan = self.execute_command("GRAPH.EXPLAIN", self.name, query)
-        if isinstance(plan[0], bytes):
-            plan = [b.decode() for b in plan]
-        return "\n".join(plan)
-
     def bulk(self, **kwargs):
         """Internal only. Not supported."""
         raise NotImplementedError(
@@ -200,3 +180,33 @@ def list_keys(self):
         For more information see `GRAPH.LIST <https://oss.redis.com/redisgraph/master/commands/#graphlist>`_. # noqa
         """
         return self.execute_command("GRAPH.LIST")
+
+    def execution_plan(self, query, params=None):
+        """
+        Get the execution plan for given query,
+        GRAPH.EXPLAIN returns an array of operations.
+
+        Args:
+            query: the query that will be executed
+            params: query parameters
+        """
+        if params is not None:
+            query = self._build_params_header(params) + query
+
+        plan = self.execute_command("GRAPH.EXPLAIN", self.name, query)
+        return "\n".join(plan)
+
+    def explain(self, query, params=None):
+        """
+        Get the execution plan for given query,
+        GRAPH.EXPLAIN returns ExecutionPlan object.
+
+        Args:
+            query: the query that will be executed
+            params: query parameters
+        """
+        if params is not None:
+            query = self._build_params_header(params) + query
+
+        plan = self.execute_command("GRAPH.EXPLAIN", self.name, query)
+        return ExecutionPlan(plan)
diff --git a/redis/commands/graph/execution_plan.py b/redis/commands/graph/execution_plan.py
new file mode 100644
index 0000000000..a9b4ad076a
--- /dev/null
+++ b/redis/commands/graph/execution_plan.py
@@ -0,0 +1,208 @@
+import re
+
+
+class ProfileStats:
+    """
+    ProfileStats, runtime execution statistics of operation.
+    """
+
+    def __init__(self, records_produced, execution_time):
+        self.records_produced = records_produced
+        self.execution_time = execution_time
+
+
+class Operation:
+    """
+    Operation, single operation within execution plan.
+    """
+
+    def __init__(self, name, args=None, profile_stats=None):
+        """
+        Create a new operation.
+
+        Args:
+            name: string that represents the name of the operation
+            args: operation arguments
+            profile_stats: profile statistics
+        """
+        self.name = name
+        self.args = args
+        self.profile_stats = profile_stats
+        self.children = []
+
+    def append_child(self, child):
+        if not isinstance(child, Operation) or self is child:
+            raise Exception("child must be Operation")
+
+        self.children.append(child)
+        return self
+
+    def child_count(self):
+        return len(self.children)
+
+    def __eq__(self, o: object) -> bool:
+        if not isinstance(o, Operation):
+            return False
+
+        return self.name == o.name and self.args == o.args
+
+    def __str__(self) -> str:
+        args_str = "" if self.args is None else " | " + self.args
+        return f"{self.name}{args_str}"
+
+
+class ExecutionPlan:
+    """
+    ExecutionPlan, collection of operations.
+    """
+
+    def __init__(self, plan):
+        """
+        Create a new execution plan.
+
+        Args:
+            plan: array of strings that represents the collection operations
+                  the output from GRAPH.EXPLAIN
+        """
+        if not isinstance(plan, list):
+            raise Exception("plan must be an array")
+
+        self.plan = plan
+        self.structured_plan = self._operation_tree()
+
+    def _compare_operations(self, root_a, root_b):
+        """
+        Compare execution plan operation tree
+
+        Return: True if operation trees are equal, False otherwise
+        """
+
+        # compare current root
+        if root_a != root_b:
+            return False
+
+        # make sure root have the same number of children
+        if root_a.child_count() != root_b.child_count():
+            return False
+
+        # recursively compare children
+        for i in range(root_a.child_count()):
+            if not self._compare_operations(root_a.children[i], root_b.children[i]):
+                return False
+
+        return True
+
+    def __str__(self) -> str:
+        def aggraget_str(str_children):
+            return "\n".join(
+                [
+                    "    " + line
+                    for str_child in str_children
+                    for line in str_child.splitlines()
+                ]
+            )
+
+        def combine_str(x, y):
+            return f"{x}\n{y}"
+
+        return self._operation_traverse(
+            self.structured_plan, str, aggraget_str, combine_str
+        )
+
+    def __eq__(self, o: object) -> bool:
+        """Compares two execution plans
+
+        Return: True if the two plans are equal False otherwise
+        """
+        # make sure 'o' is an execution-plan
+        if not isinstance(o, ExecutionPlan):
+            return False
+
+        # get root for both plans
+        root_a = self.structured_plan
+        root_b = o.structured_plan
+
+        # compare execution trees
+        return self._compare_operations(root_a, root_b)
+
+    def _operation_traverse(self, op, op_f, aggregate_f, combine_f):
+        """
+        Traverse operation tree recursively applying functions
+
+        Args:
+            op: operation to traverse
+            op_f: function applied for each operation
+            aggregate_f: aggregation function applied for all children of a single operation
+            combine_f: combine function applied for the operation result and the children result
+        """  # noqa
+        # apply op_f for each operation
+        op_res = op_f(op)
+        if len(op.children) == 0:
+            return op_res  # no children return
+        else:
+            # apply _operation_traverse recursively
+            children = [
+                self._operation_traverse(child, op_f, aggregate_f, combine_f)
+                for child in op.children
+            ]
+            # combine the operation result with the children aggregated result
+            return combine_f(op_res, aggregate_f(children))
+
+    def _operation_tree(self):
+        """Build the operation tree from the string representation"""
+
+        # initial state
+        i = 0
+        level = 0
+        stack = []
+        current = None
+
+        def _create_operation(args):
+            profile_stats = None
+            name = args[0].strip()
+            args.pop(0)
+            if len(args) > 0 and "Records produced" in args[-1]:
+                records_produced = int(
+                    re.search("Records produced: (\\d+)", args[-1]).group(1)
+                )
+                execution_time = float(
+                    re.search("Execution time: (\\d+.\\d+) ms", args[-1]).group(1)
+                )
+                profile_stats = ProfileStats(records_produced, execution_time)
+                args.pop(-1)
+            return Operation(
+                name, None if len(args) == 0 else args[0].strip(), profile_stats
+            )
+
+        # iterate plan operations
+        while i < len(self.plan):
+            current_op = self.plan[i]
+            op_level = current_op.count("    ")
+            if op_level == level:
+                # if the operation level equal to the current level
+                # set the current operation and move next
+                child = _create_operation(current_op.split("|"))
+                if current:
+                    current = stack.pop()
+                    current.append_child(child)
+                current = child
+                i += 1
+            elif op_level == level + 1:
+                # if the operation is child of the current operation
+                # add it as child and set as current operation
+                child = _create_operation(current_op.split("|"))
+                current.append_child(child)
+                stack.append(current)
+                current = child
+                level += 1
+                i += 1
+            elif op_level < level:
+                # if the operation is not child of current operation
+                # go back to it's parent operation
+                levels_back = level - op_level + 1
+                for _ in range(levels_back):
+                    current = stack.pop()
+                level -= levels_back
+            else:
+                raise Exception("corrupted plan")
+        return stack[0]
diff --git a/tests/test_graph.py b/tests/test_graph.py
index 2125d4a2fc..8de63465a0 100644
--- a/tests/test_graph.py
+++ b/tests/test_graph.py
@@ -1,6 +1,7 @@
 import pytest
 
 from redis.commands.graph import Edge, Node, Path
+from redis.commands.graph.execution_plan import Operation
 from redis.exceptions import ResponseError
 
 
@@ -259,21 +260,6 @@ def test_cached_execution(client):
     assert cached_result.cached_execution
 
 
-@pytest.mark.redismod
-def test_explain(client):
-    create_query = """CREATE (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
-    (:Rider {name:'Dani Pedrosa'})-[:rides]->(:Team {name:'Honda'}),
-    (:Rider {name:'Andrea Dovizioso'})-[:rides]->(:Team {name:'Ducati'})"""
-    client.graph().query(create_query)
-
-    result = client.graph().explain(
-        "MATCH (r:Rider)-[:rides]->(t:Team) WHERE t.name = $name RETURN r.name, t.name, $params",  # noqa
-        {"name": "Yehuda"},
-    )
-    expected = "Results\n    Project\n        Conditional Traverse | (t:Team)->(r:Rider)\n            Filter\n                Node By Label Scan | (t:Team)"  # noqa
-    assert result == expected
-
-
 @pytest.mark.redismod
 def test_slowlog(client):
     create_query = """CREATE (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
@@ -475,3 +461,114 @@ def test_cache_sync(client):
     assert A._properties[1] == "x"
     assert A._relationship_types[0] == "S"
     assert A._relationship_types[1] == "R"
+
+
+@pytest.mark.redismod
+def test_execution_plan(client):
+    redis_graph = client.graph("execution_plan")
+    create_query = """CREATE (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
+    (:Rider {name:'Dani Pedrosa'})-[:rides]->(:Team {name:'Honda'}),
+    (:Rider {name:'Andrea Dovizioso'})-[:rides]->(:Team {name:'Ducati'})"""
+    redis_graph.query(create_query)
+
+    result = redis_graph.execution_plan(
+        "MATCH (r:Rider)-[:rides]->(t:Team) WHERE t.name = $name RETURN r.name, t.name, $params",  # noqa
+        {"name": "Yehuda"},
+    )
+    expected = "Results\n    Project\n        Conditional Traverse | (t:Team)->(r:Rider)\n            Filter\n                Node By Label Scan | (t:Team)"  # noqa
+    assert result == expected
+
+    redis_graph.delete()
+
+
+@pytest.mark.redismod
+def test_explain(client):
+    redis_graph = client.graph("execution_plan")
+    # graph creation / population
+    create_query = """CREATE
+(:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
+(:Rider {name:'Dani Pedrosa'})-[:rides]->(:Team {name:'Honda'}),
+(:Rider {name:'Andrea Dovizioso'})-[:rides]->(:Team {name:'Ducati'})"""
+    redis_graph.query(create_query)
+
+    result = redis_graph.explain(
+        """MATCH (r:Rider)-[:rides]->(t:Team)
+WHERE t.name = $name
+RETURN r.name, t.name
+UNION
+MATCH (r:Rider)-[:rides]->(t:Team)
+WHERE t.name = $name
+RETURN r.name, t.name""",
+        {"name": "Yamaha"},
+    )
+    expected = """\
+Results
+Distinct
+    Join
+        Project
+            Conditional Traverse | (t:Team)->(r:Rider)
+                Filter
+                    Node By Label Scan | (t:Team)
+        Project
+            Conditional Traverse | (t:Team)->(r:Rider)
+                Filter
+                    Node By Label Scan | (t:Team)"""
+    assert str(result).replace(" ", "").replace("\n", "") == expected.replace(
+        " ", ""
+    ).replace("\n", "")
+
+    expected = Operation("Results").append_child(
+        Operation("Distinct").append_child(
+            Operation("Join")
+            .append_child(
+                Operation("Project").append_child(
+                    Operation(
+                        "Conditional Traverse", "(t:Team)->(r:Rider)"
+                    ).append_child(
+                        Operation("Filter").append_child(
+                            Operation("Node By Label Scan", "(t:Team)")
+                        )
+                    )
+                )
+            )
+            .append_child(
+                Operation("Project").append_child(
+                    Operation(
+                        "Conditional Traverse", "(t:Team)->(r:Rider)"
+                    ).append_child(
+                        Operation("Filter").append_child(
+                            Operation("Node By Label Scan", "(t:Team)")
+                        )
+                    )
+                )
+            )
+        )
+    )
+
+    assert result.structured_plan == expected
+
+    result = redis_graph.explain(
+        """MATCH (r:Rider), (t:Team)
+                                    RETURN r.name, t.name"""
+    )
+    expected = """\
+Results
+Project
+    Cartesian Product
+        Node By Label Scan | (r:Rider)
+        Node By Label Scan | (t:Team)"""
+    assert str(result).replace(" ", "").replace("\n", "") == expected.replace(
+        " ", ""
+    ).replace("\n", "")
+
+    expected = Operation("Results").append_child(
+        Operation("Project").append_child(
+            Operation("Cartesian Product")
+            .append_child(Operation("Node By Label Scan"))
+            .append_child(Operation("Node By Label Scan"))
+        )
+    )
+
+    assert result.structured_plan == expected
+
+    redis_graph.delete()

From 9a1b00f92fd2694babb57ac9f5e57639201a9827 Mon Sep 17 00:00:00 2001
From: dogukanteber <47397379+dogukanteber@users.noreply.github.com>
Date: Wed, 16 Feb 2022 11:31:05 +0300
Subject: [PATCH 0396/1164] Add support for ACL DRYRUN (#1992)

* Add support for ACL DRYRUN

* Fix linter error

* Revert "Fix linter error"

This reverts commit aa1cf04ea7e93abedfd3a33b818f8f64b92147c4.

* Fix linter error
---
 redis/commands/core.py |  8 ++++++++
 tests/test_commands.py | 13 +++++++++++++
 2 files changed, 21 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 5074e8064d..1e221c9402 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -28,6 +28,14 @@ def acl_cat(self, category=None, **kwargs):
         pieces = [category] if category else []
         return self.execute_command("ACL CAT", *pieces, **kwargs)
 
+    def acl_dryrun(self, username, *args, **kwargs):
+        """
+        Simulate the execution of a given command by a given ``username``.
+
+        For more information check https://redis.io/commands/acl-dryrun
+        """
+        return self.execute_command("ACL DRYRUN", username, *args, **kwargs)
+
     def acl_deluser(self, *username, **kwargs):
         """
         Delete the ACL for the specified ``username``s
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 0e27836b05..ad9ee2c5fd 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -87,6 +87,19 @@ def test_acl_cat_with_category(self, r):
         assert isinstance(commands, list)
         assert "get" in commands
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_acl_dryrun(self, r):
+        username = "redis-py-user"
+        r.acl_setuser(
+            username,
+            keys=["*"],
+            commands=["+set"],
+        )
+        assert r.acl_dryrun(username, "set", "key", "value") == b"OK"
+        assert r.acl_dryrun(username, "get", "key").startswith(
+            b"This user has no permissions to run the"
+        )
+
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise()
     def test_acl_deluser(self, r, request):

From cf8b192f11f52516cf463a22ee465ed6c2386947 Mon Sep 17 00:00:00 2001
From: Sebastian Rittau <srittau@rittau.biz>
Date: Thu, 17 Feb 2022 10:17:00 +0100
Subject: [PATCH 0397/1164] Fixing type annotation for EXPLAIN (#1997)

---
 redis/commands/search/commands.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 5c4734c7c8..39c599fbd5 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -433,7 +433,7 @@ def search(
 
     def explain(
         self,
-        query=Union[str, Query],
+        query: Union[str, Query],
         query_params: Dict[str, Union[str, int, float]] = None,
     ):
         """Returns the execution plan for a complex query.

From e3c989d93e914e6502bd5a72f15ded49a135c5be Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 17 Feb 2022 11:17:23 +0200
Subject: [PATCH 0398/1164] Ensuring CI runs against integration branches
 (#1995)

---
 .github/workflows/integration.yaml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index a73bb71160..1d8a33a22a 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -8,9 +8,11 @@ on:
       - '**/*.md'
     branches:
       - master
+      - '[0-9].[0-9]'
   pull_request:
     branches:
       - master
+      - '[0-9].[0-9]'
 
 jobs:
 

From d56baeb683fc1935cfa343fa2eeb0fa9bd955283 Mon Sep 17 00:00:00 2001
From: Andrew Chen Wang <60190294+Andrew-Chen-Wang@users.noreply.github.com>
Date: Tue, 22 Feb 2022 05:29:55 -0500
Subject: [PATCH 0399/1164] Add Async Support (#1899)

Co-authored-by: Chayim I. Kirshen <c@kirshen.com>
Co-authored-by: dvora-h <dvora.heller@redis.com>
---
 .github/workflows/integration.yaml         |    5 +-
 .gitignore                                 |    2 +-
 .mypy.ini                                  |   24 +
 CONTRIBUTING.md                            |    6 +-
 README.md                                  |    7 +-
 dev_requirements.txt                       |    3 +
 docs/connections.rst                       |   12 +-
 docs/examples.rst                          |    1 +
 docs/examples/asyncio_examples.ipynb       |  301 ++++
 docs/index.rst                             |    2 +-
 redis/__init__.py                          |   10 +-
 redis/asyncio/__init__.py                  |   58 +
 redis/asyncio/client.py                    | 1344 ++++++++++++++
 redis/asyncio/connection.py                | 1707 ++++++++++++++++++
 redis/asyncio/lock.py                      |  311 ++++
 redis/asyncio/retry.py                     |   58 +
 redis/asyncio/sentinel.py                  |  353 ++++
 redis/asyncio/utils.py                     |   28 +
 redis/client.py                            |   28 +-
 redis/commands/__init__.py                 |    6 +-
 redis/commands/core.py                     | 1829 +++++++++++++-------
 redis/commands/sentinel.py                 |   24 +-
 redis/compat.py                            |    9 +
 redis/typing.py                            |   45 +
 requirements.txt                           |    2 +
 setup.py                                   |    3 +
 tests/conftest.py                          |   79 +-
 tests/test_asyncio/__init__.py             |    0
 tests/test_asyncio/compat.py               |    6 +
 tests/test_asyncio/conftest.py             |  205 +++
 tests/test_asyncio/test_commands.py        |    3 +
 tests/test_asyncio/test_connection.py      |   64 +
 tests/test_asyncio/test_connection_pool.py |  884 ++++++++++
 tests/test_asyncio/test_encoding.py        |  126 ++
 tests/test_asyncio/test_lock.py            |  242 +++
 tests/test_asyncio/test_monitor.py         |   67 +
 tests/test_asyncio/test_pipeline.py        |  409 +++++
 tests/test_asyncio/test_pubsub.py          |  660 +++++++
 tests/test_asyncio/test_retry.py           |   70 +
 tests/test_asyncio/test_scripting.py       |  159 ++
 tests/test_asyncio/test_sentinel.py        |  249 +++
 tox.ini                                    |    5 +-
 whitelist.py                               |    5 +
 43 files changed, 8773 insertions(+), 638 deletions(-)
 create mode 100644 .mypy.ini
 create mode 100644 docs/examples/asyncio_examples.ipynb
 create mode 100644 redis/asyncio/__init__.py
 create mode 100644 redis/asyncio/client.py
 create mode 100644 redis/asyncio/connection.py
 create mode 100644 redis/asyncio/lock.py
 create mode 100644 redis/asyncio/retry.py
 create mode 100644 redis/asyncio/sentinel.py
 create mode 100644 redis/asyncio/utils.py
 create mode 100644 redis/compat.py
 create mode 100644 redis/typing.py
 create mode 100644 tests/test_asyncio/__init__.py
 create mode 100644 tests/test_asyncio/compat.py
 create mode 100644 tests/test_asyncio/conftest.py
 create mode 100644 tests/test_asyncio/test_commands.py
 create mode 100644 tests/test_asyncio/test_connection.py
 create mode 100644 tests/test_asyncio/test_connection_pool.py
 create mode 100644 tests/test_asyncio/test_encoding.py
 create mode 100644 tests/test_asyncio/test_lock.py
 create mode 100644 tests/test_asyncio/test_monitor.py
 create mode 100644 tests/test_asyncio/test_pipeline.py
 create mode 100644 tests/test_asyncio/test_pubsub.py
 create mode 100644 tests/test_asyncio/test_retry.py
 create mode 100644 tests/test_asyncio/test_scripting.py
 create mode 100644 tests/test_asyncio/test_sentinel.py

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 1d8a33a22a..bfd1841669 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -36,7 +36,7 @@ jobs:
      strategy:
        max-parallel: 15
        matrix:
-         python-version: ['3.6', '3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
+         python-version: ['3.6','3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
          test-type: ['standalone', 'cluster']
          connection-type: ['hiredis', 'plain']
      env:
@@ -50,6 +50,7 @@ jobs:
            python-version: ${{ matrix.python-version }}
        - name: run tests
          run: |
+           pip install -U setuptools wheel
            pip install -r dev_requirements.txt
            tox -e ${{matrix.test-type}}-${{matrix.connection-type}}
        - name: Upload codecov coverage
@@ -79,7 +80,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.6', '3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
+        python-version: ['3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
     steps:
       - uses: actions/checkout@v2
       - name: install python ${{ matrix.python-version }}
diff --git a/.gitignore b/.gitignore
index 96fbdd5646..b392a2d748 100644
--- a/.gitignore
+++ b/.gitignore
@@ -14,7 +14,7 @@ vagrant/.vagrant
 env
 venv
 coverage.xml
-.venv
+.venv*
 *.xml
 .coverage*
 docker/stunnel/keys
diff --git a/.mypy.ini b/.mypy.ini
new file mode 100644
index 0000000000..942574e0f3
--- /dev/null
+++ b/.mypy.ini
@@ -0,0 +1,24 @@
+[mypy]
+#, docs/examples, tests
+files = redis
+check_untyped_defs = True
+follow_imports_for_stubs asyncio.= True
+#disallow_any_decorated = True
+disallow_subclassing_any = True
+#disallow_untyped_calls = True
+disallow_untyped_decorators = True
+#disallow_untyped_defs = True
+implicit_reexport = False
+no_implicit_optional = True
+show_error_codes = True
+strict_equality = True
+warn_incomplete_stub = True
+warn_redundant_casts = True
+warn_unreachable = True
+warn_unused_ignores = True
+disallow_any_unimported = True
+#warn_return_any = True
+
+[mypy-redis.asyncio.lock]
+# TODO: Remove once locks has been rewritten
+ignore_errors = True
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index ebb66bbf3e..827a25f9c4 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -112,12 +112,12 @@ You can see the logging output of a containers like this:
 `$ docker logs -f <service>`
 
 The command make test runs all tests in all tested Python
-environments. To run the tests in a single environment, like Python 3.6,
+environments. To run the tests in a single environment, like Python 3.9,
 use a command like this:
 
-`$ docker-compose run test tox -e py36 -- --redis-url=redis://master:6379/9`
+`$ docker-compose run test tox -e py39 -- --redis-url=redis://master:6379/9`
 
-Here, the flag `-e py36` runs tests against the Python 3.6 tox
+Here, the flag `-e py39` runs tests against the Python 3.9 tox
 environment. And note from the example that whenever you run tests like
 this, instead of using make test, you need to pass
 `-- --redis-url=redis://master:6379/9`. This points the tests at the
diff --git a/README.md b/README.md
index f35c7bb13a..c6ee3c10eb 100644
--- a/README.md
+++ b/README.md
@@ -13,6 +13,11 @@ The Python interface to the Redis key-value store.
 
 ---------------------------------------------
 
+## Python Notice
+
+redis-py 4.2.x will be the last generation of redis-py to support python 3.6 as it has been [End of Life'd](https://www.python.org/dev/peps/pep-0494/#schedule-last-security-only-release).  Async support was introduced in redis-py 4.2.x thanks to [aioredis](https://github.com/aio-libs/aioredis-py), which necessitates this change. We will continue to maintain 3.6 support as long as possible - but the plan is for redis-py version 5+ to offically remove 3.6.
+
+---------------------------
 
 ## Installation
 
@@ -51,7 +56,7 @@ contributing](https://github.com/redis/redis-py/blob/master/CONTRIBUTING.md).
 
 ## Getting Started
 
-redis-py supports Python 3.6+.
+redis-py supports Python 3.7+.
 
 ``` pycon
 >>> import redis
diff --git a/dev_requirements.txt b/dev_requirements.txt
index 2a4f37762f..0c4bee9f35 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -2,8 +2,10 @@ black==21.11b1
 flake8==4.0.1
 flynt~=0.69.0
 isort==5.10.1
+mock==4.0.3
 pytest==6.2.5
 pytest-timeout==2.0.1
+pytest-asyncio>=0.16.0
 tox==3.24.4
 tox-docker==3.1.0
 invoke==1.6.0
@@ -11,3 +13,4 @@ pytest-cov>=3.0.0
 vulture>=2.3.0
 ujson>=4.2.0
 wheel>=0.30.0
+uvloop
diff --git a/docs/connections.rst b/docs/connections.rst
index ba39f3341f..9804a15bf1 100644
--- a/docs/connections.rst
+++ b/docs/connections.rst
@@ -42,4 +42,14 @@ Connection Pools
 .. autoclass:: redis.connection.ConnectionPool
     :members:
 
-More connection examples can be found `here <examples/connection_examples.html>`_.
\ No newline at end of file
+More connection examples can be found `here <examples/connection_examples.html>`_.
+
+Async Client
+************
+
+This client is used for communicating with Redis, asynchronously.
+
+.. autoclass:: redis.asyncio.connection.Connection
+    :members:
+
+More connection examples can be found `here <examples/asyncio_examples.html>`_
\ No newline at end of file
diff --git a/docs/examples.rst b/docs/examples.rst
index fb57499e65..6d659a0b75 100644
--- a/docs/examples.rst
+++ b/docs/examples.rst
@@ -7,5 +7,6 @@ Examples
 
    examples/connection_examples
    examples/ssl_connection_examples
+   examples/asyncio_examples
    examples/search_json_examples
    examples/set_and_get_examples
diff --git a/docs/examples/asyncio_examples.ipynb b/docs/examples/asyncio_examples.ipynb
new file mode 100644
index 0000000000..66d435835b
--- /dev/null
+++ b/docs/examples/asyncio_examples.ipynb
@@ -0,0 +1,301 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "collapsed": true,
+    "pycharm": {
+     "name": "#%% md\n"
+    }
+   },
+   "source": [
+    "# Asyncio Examples\n",
+    "\n",
+    "All commands are coroutine functions.\n",
+    "\n",
+    "## Connecting and Disconnecting\n",
+    "\n",
+    "Utilizing asyncio Redis requires an explicit disconnect of the connection since there is no asyncio deconstructor magic method. By default, a connection pool is created on `redis.Redis()` and attached to this `Redis` instance. The connection pool closes automatically on the call to `Redis.close` which disconnects all connections."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {
+    "pycharm": {
+     "name": "#%%\n"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Ping successful: True\n"
+     ]
+    }
+   ],
+   "source": [
+    "import redis.asyncio as redis\n",
+    "\n",
+    "connection = redis.Redis()\n",
+    "print(f\"Ping successful: {await connection.ping()}\")\n",
+    "await connection.close()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "pycharm": {
+     "name": "#%% md\n"
+    }
+   },
+   "source": [
+    "If you supply a custom `ConnectionPool` that is supplied to several `Redis` instances, you may want to disconnect the connection pool explicitly. Disconnecting the connection pool simply disconnects all connections hosted in the pool."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {
+    "pycharm": {
+     "name": "#%%\n"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "import redis.asyncio as redis\n",
+    "\n",
+    "connection = redis.Redis(auto_close_connection_pool=False)\n",
+    "await connection.close()\n",
+    "# Or: await connection.close(close_connection_pool=False)\n",
+    "await connection.connection_pool.disconnect()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "pycharm": {
+     "name": "#%% md\n"
+    }
+   },
+   "source": [
+    "## Transactions (Multi/Exec)\n",
+    "\n",
+    "The aioredis.Redis.pipeline will return a aioredis.Pipeline object, which will buffer all commands in-memory and compile them into batches using the Redis Bulk String protocol. Additionally, each command will return the Pipeline instance, allowing you to chain your commands, i.e., p.set('foo', 1).set('bar', 2).mget('foo', 'bar').\n",
+    "\n",
+    "The commands will not be reflected in Redis until execute() is called & awaited.\n",
+    "\n",
+    "Usually, when performing a bulk operation, taking advantage of a “transaction” (e.g., Multi/Exec) is to be desired, as it will also add a layer of atomicity to your bulk operation."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {
+    "pycharm": {
+     "name": "#%%\n"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "import redis.asyncio as redis\n",
+    "\n",
+    "r = await redis.from_url(\"redis://localhost\")\n",
+    "async with r.pipeline(transaction=True) as pipe:\n",
+    "    ok1, ok2 = await (pipe.set(\"key1\", \"value1\").set(\"key2\", \"value2\").execute())\n",
+    "assert ok1\n",
+    "assert ok2"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Pub/Sub Mode\n",
+    "\n",
+    "Subscribing to specific channels:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {
+    "pycharm": {
+     "name": "#%%\n"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "(Reader) Message Received: {'type': 'message', 'pattern': None, 'channel': b'channel:1', 'data': b'Hello'}\n",
+      "(Reader) Message Received: {'type': 'message', 'pattern': None, 'channel': b'channel:2', 'data': b'World'}\n",
+      "(Reader) Message Received: {'type': 'message', 'pattern': None, 'channel': b'channel:1', 'data': b'STOP'}\n",
+      "(Reader) STOP\n"
+     ]
+    }
+   ],
+   "source": [
+    "import asyncio\n",
+    "\n",
+    "import async_timeout\n",
+    "\n",
+    "import redis.asyncio as redis\n",
+    "\n",
+    "STOPWORD = \"STOP\"\n",
+    "\n",
+    "\n",
+    "async def reader(channel: redis.client.PubSub):\n",
+    "    while True:\n",
+    "        try:\n",
+    "            async with async_timeout.timeout(1):\n",
+    "                message = await channel.get_message(ignore_subscribe_messages=True)\n",
+    "                if message is not None:\n",
+    "                    print(f\"(Reader) Message Received: {message}\")\n",
+    "                    if message[\"data\"].decode() == STOPWORD:\n",
+    "                        print(\"(Reader) STOP\")\n",
+    "                        break\n",
+    "                await asyncio.sleep(0.01)\n",
+    "        except asyncio.TimeoutError:\n",
+    "            pass\n",
+    "\n",
+    "r = redis.from_url(\"redis://localhost\")\n",
+    "pubsub = r.pubsub()\n",
+    "await pubsub.subscribe(\"channel:1\", \"channel:2\")\n",
+    "\n",
+    "future = asyncio.create_task(reader(pubsub))\n",
+    "\n",
+    "await r.publish(\"channel:1\", \"Hello\")\n",
+    "await r.publish(\"channel:2\", \"World\")\n",
+    "await r.publish(\"channel:1\", STOPWORD)\n",
+    "\n",
+    "await future"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Subscribing to channels matching a glob-style pattern:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {
+    "pycharm": {
+     "name": "#%%\n"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "(Reader) Message Received: {'type': 'pmessage', 'pattern': b'channel:*', 'channel': b'channel:1', 'data': b'Hello'}\n",
+      "(Reader) Message Received: {'type': 'pmessage', 'pattern': b'channel:*', 'channel': b'channel:2', 'data': b'World'}\n",
+      "(Reader) Message Received: {'type': 'pmessage', 'pattern': b'channel:*', 'channel': b'channel:1', 'data': b'STOP'}\n",
+      "(Reader) STOP\n"
+     ]
+    }
+   ],
+   "source": [
+    "import asyncio\n",
+    "\n",
+    "import async_timeout\n",
+    "\n",
+    "import redis.asyncio as redis\n",
+    "\n",
+    "STOPWORD = \"STOP\"\n",
+    "\n",
+    "\n",
+    "async def reader(channel: redis.client.PubSub):\n",
+    "    while True:\n",
+    "        try:\n",
+    "            async with async_timeout.timeout(1):\n",
+    "                message = await channel.get_message(ignore_subscribe_messages=True)\n",
+    "                if message is not None:\n",
+    "                    print(f\"(Reader) Message Received: {message}\")\n",
+    "                    if message[\"data\"].decode() == STOPWORD:\n",
+    "                        print(\"(Reader) STOP\")\n",
+    "                        break\n",
+    "                await asyncio.sleep(0.01)\n",
+    "        except asyncio.TimeoutError:\n",
+    "            pass\n",
+    "\n",
+    "\n",
+    "r = await redis.from_url(\"redis://localhost\")\n",
+    "pubsub = r.pubsub()\n",
+    "await pubsub.psubscribe(\"channel:*\")\n",
+    "\n",
+    "future = asyncio.create_task(reader(pubsub))\n",
+    "\n",
+    "await r.publish(\"channel:1\", \"Hello\")\n",
+    "await r.publish(\"channel:2\", \"World\")\n",
+    "await r.publish(\"channel:1\", STOPWORD)\n",
+    "\n",
+    "await future"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Sentinel Client\n",
+    "\n",
+    "The Sentinel client requires a list of Redis Sentinel addresses to connect to and start discovering services.\n",
+    "\n",
+    "Calling aioredis.sentinel.Sentinel.master_for or aioredis.sentinel.Sentinel.slave_for methods will return Redis clients connected to specified services monitored by Sentinel.\n",
+    "\n",
+    "Sentinel client will detect failover and reconnect Redis clients automatically."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "pycharm": {
+     "name": "#%%\n"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "import asyncio\n",
+    "\n",
+    "from redis.asyncio.sentinel import Sentinel\n",
+    "\n",
+    "\n",
+    "sentinel = Sentinel([(\"localhost\", 26379), (\"sentinel2\", 26379)])\n",
+    "r = sentinel.master_for(\"mymaster\")\n",
+    "\n",
+    "ok = await r.set(\"key\", \"value\")\n",
+    "assert ok\n",
+    "val = await r.get(\"key\")\n",
+    "assert val == b\"value\""
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.9.7"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 1
+}
\ No newline at end of file
diff --git a/docs/index.rst b/docs/index.rst
index 2e42acb81b..630bad4f55 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -9,7 +9,7 @@ Welcome to redis-py's documentation!
 Getting Started
 ****************
 
-`redis-py <https://pypi.org/project/redis>`_ requires a running Redis server, and Python 3.6+. See the `Redis
+`redis-py <https://pypi.org/project/redis>`_ requires a running Redis server, and Python 3.7+. See the `Redis
 quickstart <https://redis.io/topics/quickstart>`_ for Redis installation instructions.
 
 redis-py can be installed using pip via ``pip install redis``.
diff --git a/redis/__init__.py b/redis/__init__.py
index 35044be29d..b7560a6715 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -1,10 +1,5 @@
 import sys
 
-if sys.version_info >= (3, 8):
-    from importlib import metadata
-else:
-    import importlib_metadata as metadata
-
 from redis.client import Redis, StrictRedis
 from redis.cluster import RedisCluster
 from redis.connection import (
@@ -37,6 +32,11 @@
 )
 from redis.utils import from_url
 
+if sys.version_info >= (3, 8):
+    from importlib import metadata
+else:
+    import importlib_metadata as metadata
+
 
 def int_or_str(value):
     try:
diff --git a/redis/asyncio/__init__.py b/redis/asyncio/__init__.py
new file mode 100644
index 0000000000..c655c7da4b
--- /dev/null
+++ b/redis/asyncio/__init__.py
@@ -0,0 +1,58 @@
+from redis.asyncio.client import Redis, StrictRedis
+from redis.asyncio.connection import (
+    BlockingConnectionPool,
+    Connection,
+    ConnectionPool,
+    SSLConnection,
+    UnixDomainSocketConnection,
+)
+from redis.asyncio.sentinel import (
+    Sentinel,
+    SentinelConnectionPool,
+    SentinelManagedConnection,
+    SentinelManagedSSLConnection,
+)
+from redis.asyncio.utils import from_url
+from redis.exceptions import (
+    AuthenticationError,
+    AuthenticationWrongNumberOfArgsError,
+    BusyLoadingError,
+    ChildDeadlockedError,
+    ConnectionError,
+    DataError,
+    InvalidResponse,
+    PubSubError,
+    ReadOnlyError,
+    RedisError,
+    ResponseError,
+    TimeoutError,
+    WatchError,
+)
+
+__all__ = [
+    "AuthenticationError",
+    "AuthenticationWrongNumberOfArgsError",
+    "BlockingConnectionPool",
+    "BusyLoadingError",
+    "ChildDeadlockedError",
+    "Connection",
+    "ConnectionError",
+    "ConnectionPool",
+    "DataError",
+    "from_url",
+    "InvalidResponse",
+    "PubSubError",
+    "ReadOnlyError",
+    "Redis",
+    "RedisError",
+    "ResponseError",
+    "Sentinel",
+    "SentinelConnectionPool",
+    "SentinelManagedConnection",
+    "SentinelManagedSSLConnection",
+    "SSLConnection",
+    "StrictRedis",
+    "TimeoutError",
+    "UnixDomainSocketConnection",
+    "WatchError",
+]
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
new file mode 100644
index 0000000000..619592ef76
--- /dev/null
+++ b/redis/asyncio/client.py
@@ -0,0 +1,1344 @@
+import asyncio
+import copy
+import inspect
+import re
+import warnings
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncIterator,
+    Awaitable,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Mapping,
+    MutableMapping,
+    NoReturn,
+    Optional,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+)
+
+from redis.asyncio.connection import (
+    Connection,
+    ConnectionPool,
+    SSLConnection,
+    UnixDomainSocketConnection,
+)
+from redis.client import (
+    EMPTY_RESPONSE,
+    NEVER_DECODE,
+    AbstractRedis,
+    CaseInsensitiveDict,
+    bool_ok,
+)
+from redis.commands import (
+    AsyncCoreCommands,
+    AsyncSentinelCommands,
+    RedisModuleCommands,
+    list_or_args,
+)
+from redis.compat import Protocol, TypedDict
+from redis.exceptions import (
+    ConnectionError,
+    ExecAbortError,
+    PubSubError,
+    RedisError,
+    ResponseError,
+    TimeoutError,
+    WatchError,
+)
+from redis.lock import Lock
+from redis.retry import Retry
+from redis.typing import ChannelT, EncodableT, KeyT
+from redis.utils import safe_str, str_if_bytes
+
+PubSubHandler = Callable[[Dict[str, str]], Awaitable[None]]
+_KeyT = TypeVar("_KeyT", bound=KeyT)
+_ArgT = TypeVar("_ArgT", KeyT, EncodableT)
+_RedisT = TypeVar("_RedisT", bound="Redis")
+_NormalizeKeysT = TypeVar("_NormalizeKeysT", bound=Mapping[ChannelT, object])
+if TYPE_CHECKING:
+    from redis.commands.core import Script
+
+
+class ResponseCallbackProtocol(Protocol):
+    def __call__(self, response: Any, **kwargs):
+        ...
+
+
+class AsyncResponseCallbackProtocol(Protocol):
+    async def __call__(self, response: Any, **kwargs):
+        ...
+
+
+ResponseCallbackT = Union[ResponseCallbackProtocol, AsyncResponseCallbackProtocol]
+
+
+class Redis(
+    AbstractRedis, RedisModuleCommands, AsyncCoreCommands, AsyncSentinelCommands
+):
+    """
+    Implementation of the Redis protocol.
+
+    This abstract class provides a Python interface to all Redis commands
+    and an implementation of the Redis protocol.
+
+    Pipelines derive from this, implementing how
+    the commands are sent and received to the Redis server. Based on
+    configuration, an instance will either use a ConnectionPool, or
+    Connection object to talk to redis.
+    """
+
+    response_callbacks: MutableMapping[Union[str, bytes], ResponseCallbackT]
+
+    @classmethod
+    def from_url(cls, url: str, **kwargs):
+        """
+        Return a Redis client object configured from the given URL
+
+        For example::
+
+            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 TCP socket connection. See more at:
+          <https://www.iana.org/assignments/uri-schemes/prov/redis>
+        - `rediss://` creates a SSL wrapped TCP socket connection. See more at:
+          <https://www.iana.org/assignments/uri-schemes/prov/rediss>
+        - ``unix://``: creates a Unix Domain Socket connection.
+
+        The username, password, hostname, path and all querystring values
+        are passed through urllib.parse.unquote in order to replace any
+        percent-encoded values with their corresponding characters.
+
+        There are several ways to specify a database number. The first value
+        found will be used:
+            1. A ``db`` querystring option, e.g. redis://localhost?db=0
+            2. If using the redis:// or rediss:// schemes, the path argument
+               of the url, e.g. redis://localhost/0
+            3. A ``db`` keyword argument to this function.
+
+        If none of these options are specified, the default db=0 is used.
+
+        All querystring options are cast to their appropriate Python types.
+        Boolean arguments can be specified with string values "True"/"False"
+        or "Yes"/"No". Values that cannot be properly cast cause a
+        ``ValueError`` to be raised. Once parsed, the querystring arguments
+        and keyword arguments are passed to the ``ConnectionPool``'s
+        class initializer. In the case of conflicting arguments, querystring
+        arguments always win.
+
+        """
+        connection_pool = ConnectionPool.from_url(url, **kwargs)
+        return cls(connection_pool=connection_pool)
+
+    def __init__(
+        self,
+        *,
+        host: str = "localhost",
+        port: int = 6379,
+        db: Union[str, int] = 0,
+        password: Optional[str] = None,
+        socket_timeout: Optional[float] = None,
+        socket_connect_timeout: Optional[float] = None,
+        socket_keepalive: Optional[bool] = None,
+        socket_keepalive_options: Optional[Mapping[int, Union[int, bytes]]] = None,
+        connection_pool: Optional[ConnectionPool] = None,
+        unix_socket_path: Optional[str] = None,
+        encoding: str = "utf-8",
+        encoding_errors: str = "strict",
+        decode_responses: bool = False,
+        retry_on_timeout: bool = False,
+        ssl: bool = False,
+        ssl_keyfile: Optional[str] = None,
+        ssl_certfile: Optional[str] = None,
+        ssl_cert_reqs: str = "required",
+        ssl_ca_certs: Optional[str] = None,
+        ssl_check_hostname: bool = False,
+        max_connections: Optional[int] = None,
+        single_connection_client: bool = False,
+        health_check_interval: int = 0,
+        client_name: Optional[str] = None,
+        username: Optional[str] = None,
+        retry: Optional[Retry] = None,
+        auto_close_connection_pool: bool = True,
+    ):
+        """
+        Initialize a new Redis client.
+        To specify a retry policy, first set `retry_on_timeout` to `True`
+        then set `retry` to a valid `Retry` object
+        """
+        kwargs: Dict[str, Any]
+        # auto_close_connection_pool only has an effect if connection_pool is
+        # None. This is a similar feature to the missing __del__ to resolve #1103,
+        # but it accounts for whether a user wants to manually close the connection
+        # pool, as a similar feature to ConnectionPool's __del__.
+        self.auto_close_connection_pool = (
+            auto_close_connection_pool if connection_pool is None else False
+        )
+        if not connection_pool:
+            kwargs = {
+                "db": db,
+                "username": username,
+                "password": password,
+                "socket_timeout": socket_timeout,
+                "encoding": encoding,
+                "encoding_errors": encoding_errors,
+                "decode_responses": decode_responses,
+                "retry_on_timeout": retry_on_timeout,
+                "retry": copy.deepcopy(retry),
+                "max_connections": max_connections,
+                "health_check_interval": health_check_interval,
+                "client_name": client_name,
+            }
+            # based on input, setup appropriate connection args
+            if unix_socket_path is not None:
+                kwargs.update(
+                    {
+                        "path": unix_socket_path,
+                        "connection_class": UnixDomainSocketConnection,
+                    }
+                )
+            else:
+                # TCP specific options
+                kwargs.update(
+                    {
+                        "host": host,
+                        "port": port,
+                        "socket_connect_timeout": socket_connect_timeout,
+                        "socket_keepalive": socket_keepalive,
+                        "socket_keepalive_options": socket_keepalive_options,
+                    }
+                )
+
+                if ssl:
+                    kwargs.update(
+                        {
+                            "connection_class": SSLConnection,
+                            "ssl_keyfile": ssl_keyfile,
+                            "ssl_certfile": ssl_certfile,
+                            "ssl_cert_reqs": ssl_cert_reqs,
+                            "ssl_ca_certs": ssl_ca_certs,
+                            "ssl_check_hostname": ssl_check_hostname,
+                        }
+                    )
+            connection_pool = ConnectionPool(**kwargs)
+        self.connection_pool = connection_pool
+        self.single_connection_client = single_connection_client
+        self.connection: Optional[Connection] = None
+
+        self.response_callbacks = CaseInsensitiveDict(self.__class__.RESPONSE_CALLBACKS)
+
+    def __repr__(self):
+        return f"{self.__class__.__name__}<{self.connection_pool!r}>"
+
+    def __await__(self):
+        return self.initialize().__await__()
+
+    async def initialize(self: _RedisT) -> _RedisT:
+        if self.single_connection_client and self.connection is None:
+            self.connection = await self.connection_pool.get_connection("_")
+        return self
+
+    def set_response_callback(self, command: str, callback: ResponseCallbackT):
+        """Set a custom Response Callback"""
+        self.response_callbacks[command] = callback
+
+    def load_external_module(
+        self,
+        funcname,
+        func,
+    ):
+        """
+        This function can be used to add externally defined redis modules,
+        and their namespaces to the redis client.
+
+        funcname - A string containing the name of the function to create
+        func - The function, being added to this class.
+
+        ex: Assume that one has a custom redis module named foomod that
+        creates command named 'foo.dothing' and 'foo.anotherthing' in redis.
+        To load function functions into this namespace:
+
+        from redis import Redis
+        from foomodule import F
+        r = Redis()
+        r.load_external_module("foo", F)
+        r.foo().dothing('your', 'arguments')
+
+        For a concrete example see the reimport of the redisjson module in
+        tests/test_connection.py::test_loading_external_modules
+        """
+        setattr(self, funcname, func)
+
+    def pipeline(
+        self, transaction: bool = True, shard_hint: Optional[str] = None
+    ) -> "Pipeline":
+        """
+        Return a new pipeline object that can queue multiple commands for
+        later execution. ``transaction`` indicates whether all commands
+        should be executed atomically. Apart from making a group of operations
+        atomic, pipelines are useful for reducing the back-and-forth overhead
+        between the client and server.
+        """
+        return Pipeline(
+            self.connection_pool, self.response_callbacks, transaction, shard_hint
+        )
+
+    async def transaction(
+        self,
+        func: Callable[["Pipeline"], Union[Any, Awaitable[Any]]],
+        *watches: KeyT,
+        shard_hint: Optional[str] = None,
+        value_from_callable: bool = False,
+        watch_delay: Optional[float] = None,
+    ):
+        """
+        Convenience method for executing the callable `func` as a transaction
+        while watching all keys specified in `watches`. The 'func' callable
+        should expect a single argument which is a Pipeline object.
+        """
+        pipe: Pipeline
+        async with self.pipeline(True, shard_hint) as pipe:
+            while True:
+                try:
+                    if watches:
+                        await pipe.watch(*watches)
+                    func_value = func(pipe)
+                    if inspect.isawaitable(func_value):
+                        func_value = await func_value
+                    exec_value = await pipe.execute()
+                    return func_value if value_from_callable else exec_value
+                except WatchError:
+                    if watch_delay is not None and watch_delay > 0:
+                        await asyncio.sleep(watch_delay)
+                    continue
+
+    def lock(
+        self,
+        name: KeyT,
+        timeout: Optional[float] = None,
+        sleep: float = 0.1,
+        blocking_timeout: Optional[float] = None,
+        lock_class: Optional[Type[Lock]] = None,
+        thread_local: bool = True,
+    ) -> Lock:
+        """
+        Return a new Lock object using key ``name`` that mimics
+        the behavior of threading.Lock.
+
+        If specified, ``timeout`` indicates a maximum life for the lock.
+        By default, it will remain locked until release() is called.
+
+        ``sleep`` indicates the amount of time to sleep per loop iteration
+        when the lock is in blocking mode and another client is currently
+        holding the lock.
+
+        ``blocking_timeout`` indicates the maximum amount of time in seconds to
+        spend trying to acquire the lock. A value of ``None`` indicates
+        continue trying forever. ``blocking_timeout`` can be specified as a
+        float or integer, both representing the number of seconds to wait.
+
+        ``lock_class`` forces the specified lock implementation.
+
+        ``thread_local`` indicates whether the lock token is placed in
+        thread-local storage. By default, the token is placed in thread local
+        storage so that a thread only sees its token, not a token set by
+        another thread. Consider the following timeline:
+
+            time: 0, thread-1 acquires `my-lock`, with a timeout of 5 seconds.
+                     thread-1 sets the token to "abc"
+            time: 1, thread-2 blocks trying to acquire `my-lock` using the
+                     Lock instance.
+            time: 5, thread-1 has not yet completed. redis expires the lock
+                     key.
+            time: 5, thread-2 acquired `my-lock` now that it's available.
+                     thread-2 sets the token to "xyz"
+            time: 6, thread-1 finishes its work and calls release(). if the
+                     token is *not* stored in thread local storage, then
+                     thread-1 would see the token value as "xyz" and would be
+                     able to successfully release the thread-2's lock.
+
+        In some use cases it's necessary to disable thread local storage. For
+        example, if you have code where one thread acquires a lock and passes
+        that lock instance to a worker thread to release later. If thread
+        local storage isn't disabled in this case, the worker thread won't see
+        the token set by the thread that acquired the lock. Our assumption
+        is that these cases aren't common and as such default to using
+        thread local storage."""
+        if lock_class is None:
+            lock_class = Lock
+        return lock_class(
+            self,
+            name,
+            timeout=timeout,
+            sleep=sleep,
+            blocking_timeout=blocking_timeout,
+            thread_local=thread_local,
+        )
+
+    def pubsub(self, **kwargs) -> "PubSub":
+        """
+        Return a Publish/Subscribe object. With this object, you can
+        subscribe to channels and listen for messages that get published to
+        them.
+        """
+        return PubSub(self.connection_pool, **kwargs)
+
+    def monitor(self) -> "Monitor":
+        return Monitor(self.connection_pool)
+
+    def client(self) -> "Redis":
+        return self.__class__(
+            connection_pool=self.connection_pool, single_connection_client=True
+        )
+
+    async def __aenter__(self: _RedisT) -> _RedisT:
+        return await self.initialize()
+
+    async def __aexit__(self, exc_type, exc_value, traceback):
+        await self.close()
+
+    _DEL_MESSAGE = "Unclosed Redis client"
+
+    def __del__(self, _warnings: Any = warnings) -> None:
+        if self.connection is not None:
+            _warnings.warn(
+                f"Unclosed client session {self!r}",
+                ResourceWarning,
+                source=self,
+            )
+            context = {"client": self, "message": self._DEL_MESSAGE}
+            asyncio.get_event_loop().call_exception_handler(context)
+
+    async def close(self, close_connection_pool: Optional[bool] = None) -> None:
+        """
+        Closes Redis client connection
+
+        :param close_connection_pool: decides whether to close the connection pool used
+        by this Redis client, overriding Redis.auto_close_connection_pool. By default,
+        let Redis.auto_close_connection_pool decide whether to close the connection
+        pool.
+        """
+        conn = self.connection
+        if conn:
+            self.connection = None
+            await self.connection_pool.release(conn)
+        if close_connection_pool or (
+            close_connection_pool is None and self.auto_close_connection_pool
+        ):
+            await self.connection_pool.disconnect()
+
+    async def _send_command_parse_response(self, conn, command_name, *args, **options):
+        """
+        Send a command and parse the response
+        """
+        await conn.send_command(*args)
+        return await self.parse_response(conn, command_name, **options)
+
+    async def _disconnect_raise(self, conn: Connection, error: Exception):
+        """
+        Close the connection and raise an exception
+        if retry_on_timeout is not set or the error
+        is not a TimeoutError
+        """
+        await conn.disconnect()
+        if not (conn.retry_on_timeout and isinstance(error, TimeoutError)):
+            raise error
+
+    # COMMAND EXECUTION AND PROTOCOL PARSING
+    async def execute_command(self, *args, **options):
+        """Execute a command and return a parsed response"""
+        await self.initialize()
+        pool = self.connection_pool
+        command_name = args[0]
+        conn = self.connection or await pool.get_connection(command_name, **options)
+
+        try:
+            return await conn.retry.call_with_retry(
+                lambda: self._send_command_parse_response(
+                    conn, command_name, *args, **options
+                ),
+                lambda error: self._disconnect_raise(conn, error),
+            )
+        finally:
+            if not self.connection:
+                await pool.release(conn)
+
+    async def parse_response(
+        self, connection: Connection, command_name: Union[str, bytes], **options
+    ):
+        """Parses a response from the Redis server"""
+        try:
+            if NEVER_DECODE in options:
+                response = await connection.read_response(disable_encoding=True)
+            else:
+                response = await connection.read_response()
+        except ResponseError:
+            if EMPTY_RESPONSE in options:
+                return options[EMPTY_RESPONSE]
+            raise
+        if command_name in self.response_callbacks:
+            # Mypy bug: https://github.com/python/mypy/issues/10977
+            command_name = cast(str, command_name)
+            retval = self.response_callbacks[command_name](response, **options)
+            return await retval if inspect.isawaitable(retval) else retval
+        return response
+
+
+StrictRedis = Redis
+
+
+class MonitorCommandInfo(TypedDict):
+    time: float
+    db: int
+    client_address: str
+    client_port: str
+    client_type: str
+    command: str
+
+
+class Monitor:
+    """
+    Monitor is useful for handling the MONITOR command to the redis server.
+    next_command() method returns one command from monitor
+    listen() method yields commands from monitor.
+    """
+
+    monitor_re = re.compile(r"\[(\d+) (.*)\] (.*)")
+    command_re = re.compile(r'"(.*?)(?<!\\)"')
+
+    def __init__(self, connection_pool: ConnectionPool):
+        self.connection_pool = connection_pool
+        self.connection: Optional[Connection] = None
+
+    async def connect(self):
+        if self.connection is None:
+            self.connection = await self.connection_pool.get_connection("MONITOR")
+
+    async def __aenter__(self):
+        await self.connect()
+        await self.connection.send_command("MONITOR")
+        # check that monitor returns 'OK', but don't return it to user
+        response = await self.connection.read_response()
+        if not bool_ok(response):
+            raise RedisError(f"MONITOR failed: {response}")
+        return self
+
+    async def __aexit__(self, *args):
+        await self.connection.disconnect()
+        await self.connection_pool.release(self.connection)
+
+    async def next_command(self) -> MonitorCommandInfo:
+        """Parse the response from a monitor command"""
+        await self.connect()
+        response = await self.connection.read_response()
+        if isinstance(response, bytes):
+            response = self.connection.encoder.decode(response, force=True)
+        command_time, command_data = response.split(" ", 1)
+        m = self.monitor_re.match(command_data)
+        db_id, client_info, command = m.groups()
+        command = " ".join(self.command_re.findall(command))
+        # Redis escapes double quotes because each piece of the command
+        # string is surrounded by double quotes. We don't have that
+        # requirement so remove the escaping and leave the quote.
+        command = command.replace('\\"', '"')
+
+        if client_info == "lua":
+            client_address = "lua"
+            client_port = ""
+            client_type = "lua"
+        elif client_info.startswith("unix"):
+            client_address = "unix"
+            client_port = client_info[5:]
+            client_type = "unix"
+        else:
+            # use rsplit as ipv6 addresses contain colons
+            client_address, client_port = client_info.rsplit(":", 1)
+            client_type = "tcp"
+        return {
+            "time": float(command_time),
+            "db": int(db_id),
+            "client_address": client_address,
+            "client_port": client_port,
+            "client_type": client_type,
+            "command": command,
+        }
+
+    async def listen(self) -> AsyncIterator[MonitorCommandInfo]:
+        """Listen for commands coming to the server."""
+        while True:
+            yield await self.next_command()
+
+
+class PubSub:
+    """
+    PubSub provides publish, subscribe and listen support to Redis channels.
+
+    After subscribing to one or more channels, the listen() method will block
+    until a message arrives on one of the subscribed channels. That message
+    will be returned and it's safe to start listening again.
+    """
+
+    PUBLISH_MESSAGE_TYPES = ("message", "pmessage")
+    UNSUBSCRIBE_MESSAGE_TYPES = ("unsubscribe", "punsubscribe")
+    HEALTH_CHECK_MESSAGE = "redis-py-health-check"
+
+    def __init__(
+        self,
+        connection_pool: ConnectionPool,
+        shard_hint: Optional[str] = None,
+        ignore_subscribe_messages: bool = False,
+        encoder=None,
+    ):
+        self.connection_pool = connection_pool
+        self.shard_hint = shard_hint
+        self.ignore_subscribe_messages = ignore_subscribe_messages
+        self.connection = None
+        # we need to know the encoding options for this connection in order
+        # to lookup channel and pattern names for callback handlers.
+        self.encoder = encoder
+        if self.encoder is None:
+            self.encoder = self.connection_pool.get_encoder()
+        if self.encoder.decode_responses:
+            self.health_check_response: Iterable[Union[str, bytes]] = [
+                "pong",
+                self.HEALTH_CHECK_MESSAGE,
+            ]
+        else:
+            self.health_check_response = [
+                b"pong",
+                self.encoder.encode(self.HEALTH_CHECK_MESSAGE),
+            ]
+        self.channels = {}
+        self.pending_unsubscribe_channels = set()
+        self.patterns = {}
+        self.pending_unsubscribe_patterns = set()
+        self._lock = asyncio.Lock()
+
+    async def __aenter__(self):
+        return self
+
+    async def __aexit__(self, exc_type, exc_value, traceback):
+        await self.reset()
+
+    def __del__(self):
+        if self.connection:
+            self.connection.clear_connect_callbacks()
+
+    async def reset(self):
+        async with self._lock:
+            if self.connection:
+                await self.connection.disconnect()
+                self.connection.clear_connect_callbacks()
+                await self.connection_pool.release(self.connection)
+                self.connection = None
+            self.channels = {}
+            self.pending_unsubscribe_channels = set()
+            self.patterns = {}
+            self.pending_unsubscribe_patterns = set()
+
+    def close(self) -> Awaitable[NoReturn]:
+        return self.reset()
+
+    async def on_connect(self, connection: Connection):
+        """Re-subscribe to any channels and patterns previously subscribed to"""
+        # NOTE: for python3, we can't pass bytestrings as keyword arguments
+        # so we need to decode channel/pattern names back to unicode strings
+        # before passing them to [p]subscribe.
+        self.pending_unsubscribe_channels.clear()
+        self.pending_unsubscribe_patterns.clear()
+        if self.channels:
+            channels = {}
+            for k, v in self.channels.items():
+                channels[self.encoder.decode(k, force=True)] = v
+            await self.subscribe(**channels)
+        if self.patterns:
+            patterns = {}
+            for k, v in self.patterns.items():
+                patterns[self.encoder.decode(k, force=True)] = v
+            await self.psubscribe(**patterns)
+
+    @property
+    def subscribed(self):
+        """Indicates if there are subscriptions to any channels or patterns"""
+        return bool(self.channels or self.patterns)
+
+    async def execute_command(self, *args: EncodableT):
+        """Execute a publish/subscribe command"""
+
+        # NOTE: don't parse the response in this function -- it could pull a
+        # legitimate message off the stack if the connection is already
+        # subscribed to one or more channels
+
+        if self.connection is None:
+            self.connection = await self.connection_pool.get_connection(
+                "pubsub", self.shard_hint
+            )
+            # register a callback that re-subscribes to any channels we
+            # were listening to when we were disconnected
+            self.connection.register_connect_callback(self.on_connect)
+        connection = self.connection
+        kwargs = {"check_health": not self.subscribed}
+        await self._execute(connection, connection.send_command, *args, **kwargs)
+
+    async def _disconnect_raise_connect(self, conn, error):
+        """
+        Close the connection and raise an exception
+        if retry_on_timeout is not set or the error
+        is not a TimeoutError. Otherwise, try to reconnect
+        """
+        await conn.disconnect()
+        if not (conn.retry_on_timeout and isinstance(error, TimeoutError)):
+            raise error
+        await conn.connect()
+
+    async def _execute(self, conn, command, *args, **kwargs):
+        """
+        Connect manually upon disconnection. If the Redis server is down,
+        this will fail and raise a ConnectionError as desired.
+        After reconnection, the ``on_connect`` callback should have been
+        called by the # connection to resubscribe us to any channels and
+        patterns we were previously listening to
+        """
+        return await conn.retry.call_with_retry(
+            lambda: command(*args, **kwargs),
+            lambda error: self._disconnect_raise_connect(conn, error),
+        )
+
+    async def parse_response(self, block: bool = True, timeout: float = 0):
+        """Parse the response from a publish/subscribe command"""
+        conn = self.connection
+        if conn is None:
+            raise RuntimeError(
+                "pubsub connection not set: "
+                "did you forget to call subscribe() or psubscribe()?"
+            )
+
+        await self.check_health()
+
+        if not block and not await self._execute(conn, conn.can_read, timeout=timeout):
+            return None
+        response = await self._execute(conn, conn.read_response)
+
+        if conn.health_check_interval and response == self.health_check_response:
+            # ignore the health check message as user might not expect it
+            return None
+        return response
+
+    async def check_health(self):
+        conn = self.connection
+        if conn is None:
+            raise RuntimeError(
+                "pubsub connection not set: "
+                "did you forget to call subscribe() or psubscribe()?"
+            )
+
+        if (
+            conn.health_check_interval
+            and asyncio.get_event_loop().time() > conn.next_health_check
+        ):
+            await conn.send_command(
+                "PING", self.HEALTH_CHECK_MESSAGE, check_health=False
+            )
+
+    def _normalize_keys(self, data: _NormalizeKeysT) -> _NormalizeKeysT:
+        """
+        normalize channel/pattern names to be either bytes or strings
+        based on whether responses are automatically decoded. this saves us
+        from coercing the value for each message coming in.
+        """
+        encode = self.encoder.encode
+        decode = self.encoder.decode
+        return {decode(encode(k)): v for k, v in data.items()}  # type: ignore[return-value]  # noqa: E501
+
+    async def psubscribe(self, *args: ChannelT, **kwargs: PubSubHandler):
+        """
+        Subscribe to channel patterns. Patterns supplied as keyword arguments
+        expect a pattern name as the key and a callable as the value. A
+        pattern's callable will be invoked automatically when a message is
+        received on that pattern rather than producing a message via
+        ``listen()``.
+        """
+        parsed_args = list_or_args((args[0],), args[1:]) if args else args
+        new_patterns: Dict[ChannelT, PubSubHandler] = dict.fromkeys(parsed_args)
+        # Mypy bug: https://github.com/python/mypy/issues/10970
+        new_patterns.update(kwargs)  # type: ignore[arg-type]
+        ret_val = await self.execute_command("PSUBSCRIBE", *new_patterns.keys())
+        # update the patterns dict AFTER we send the command. we don't want to
+        # subscribe twice to these patterns, once for the command and again
+        # for the reconnection.
+        new_patterns = self._normalize_keys(new_patterns)
+        self.patterns.update(new_patterns)
+        self.pending_unsubscribe_patterns.difference_update(new_patterns)
+        return ret_val
+
+    def punsubscribe(self, *args: ChannelT) -> Awaitable:
+        """
+        Unsubscribe from the supplied patterns. If empty, unsubscribe from
+        all patterns.
+        """
+        patterns: Iterable[ChannelT]
+        if args:
+            parsed_args = list_or_args((args[0],), args[1:])
+            patterns = self._normalize_keys(dict.fromkeys(parsed_args)).keys()
+        else:
+            parsed_args = []
+            patterns = self.patterns
+        self.pending_unsubscribe_patterns.update(patterns)
+        return self.execute_command("PUNSUBSCRIBE", *parsed_args)
+
+    async def subscribe(self, *args: ChannelT, **kwargs: Callable):
+        """
+        Subscribe to channels. Channels supplied as keyword arguments expect
+        a channel name as the key and a callable as the value. A channel's
+        callable will be invoked automatically when a message is received on
+        that channel rather than producing a message via ``listen()`` or
+        ``get_message()``.
+        """
+        parsed_args = list_or_args((args[0],), args[1:]) if args else ()
+        new_channels = dict.fromkeys(parsed_args)
+        # Mypy bug: https://github.com/python/mypy/issues/10970
+        new_channels.update(kwargs)  # type: ignore[arg-type]
+        ret_val = await self.execute_command("SUBSCRIBE", *new_channels.keys())
+        # update the channels dict AFTER we send the command. we don't want to
+        # subscribe twice to these channels, once for the command and again
+        # for the reconnection.
+        new_channels = self._normalize_keys(new_channels)
+        self.channels.update(new_channels)
+        self.pending_unsubscribe_channels.difference_update(new_channels)
+        return ret_val
+
+    def unsubscribe(self, *args) -> Awaitable:
+        """
+        Unsubscribe from the supplied channels. If empty, unsubscribe from
+        all channels
+        """
+        if args:
+            parsed_args = list_or_args(args[0], args[1:])
+            channels = self._normalize_keys(dict.fromkeys(parsed_args))
+        else:
+            parsed_args = []
+            channels = self.channels
+        self.pending_unsubscribe_channels.update(channels)
+        return self.execute_command("UNSUBSCRIBE", *parsed_args)
+
+    async def listen(self) -> AsyncIterator:
+        """Listen for messages on channels this client has been subscribed to"""
+        while self.subscribed:
+            response = await self.handle_message(await self.parse_response(block=True))
+            if response is not None:
+                yield response
+
+    async def get_message(
+        self, ignore_subscribe_messages: bool = False, timeout: float = 0.0
+    ):
+        """
+        Get the next message if one is available, otherwise None.
+
+        If timeout is specified, the system will wait for `timeout` seconds
+        before returning. Timeout should be specified as a floating point
+        number.
+        """
+        response = await self.parse_response(block=False, timeout=timeout)
+        if response:
+            return await self.handle_message(response, ignore_subscribe_messages)
+        return None
+
+    def ping(self, message=None) -> Awaitable:
+        """
+        Ping the Redis server
+        """
+        message = "" if message is None else message
+        return self.execute_command("PING", message)
+
+    async def handle_message(self, response, ignore_subscribe_messages=False):
+        """
+        Parses a pub/sub message. If the channel or pattern was subscribed to
+        with a message handler, the handler is invoked instead of a parsed
+        message being returned.
+        """
+        message_type = str_if_bytes(response[0])
+        if message_type == "pmessage":
+            message = {
+                "type": message_type,
+                "pattern": response[1],
+                "channel": response[2],
+                "data": response[3],
+            }
+        elif message_type == "pong":
+            message = {
+                "type": message_type,
+                "pattern": None,
+                "channel": None,
+                "data": response[1],
+            }
+        else:
+            message = {
+                "type": message_type,
+                "pattern": None,
+                "channel": response[1],
+                "data": response[2],
+            }
+
+        # if this is an unsubscribe message, remove it from memory
+        if message_type in self.UNSUBSCRIBE_MESSAGE_TYPES:
+            if message_type == "punsubscribe":
+                pattern = response[1]
+                if pattern in self.pending_unsubscribe_patterns:
+                    self.pending_unsubscribe_patterns.remove(pattern)
+                    self.patterns.pop(pattern, None)
+            else:
+                channel = response[1]
+                if channel in self.pending_unsubscribe_channels:
+                    self.pending_unsubscribe_channels.remove(channel)
+                    self.channels.pop(channel, None)
+
+        if message_type in self.PUBLISH_MESSAGE_TYPES:
+            # if there's a message handler, invoke it
+            if message_type == "pmessage":
+                handler = self.patterns.get(message["pattern"], None)
+            else:
+                handler = self.channels.get(message["channel"], None)
+            if handler:
+                if inspect.iscoroutinefunction(handler):
+                    await handler(message)
+                else:
+                    handler(message)
+                return None
+        elif message_type != "pong":
+            # this is a subscribe/unsubscribe message. ignore if we don't
+            # want them
+            if ignore_subscribe_messages or self.ignore_subscribe_messages:
+                return None
+
+        return message
+
+    async def run(
+        self,
+        *,
+        exception_handler: Optional["PSWorkerThreadExcHandlerT"] = None,
+        poll_timeout: float = 1.0,
+    ) -> None:
+        """Process pub/sub messages using registered callbacks.
+
+        This is the equivalent of :py:meth:`redis.PubSub.run_in_thread` in
+        redis-py, but it is a coroutine. To launch it as a separate task, use
+        ``asyncio.create_task``:
+
+            >>> task = asyncio.create_task(pubsub.run())
+
+        To shut it down, use asyncio cancellation:
+
+            >>> task.cancel()
+            >>> await task
+        """
+        for channel, handler in self.channels.items():
+            if handler is None:
+                raise PubSubError(f"Channel: '{channel}' has no handler registered")
+        for pattern, handler in self.patterns.items():
+            if handler is None:
+                raise PubSubError(f"Pattern: '{pattern}' has no handler registered")
+
+        while True:
+            try:
+                await self.get_message(
+                    ignore_subscribe_messages=True, timeout=poll_timeout
+                )
+            except asyncio.CancelledError:
+                raise
+            except BaseException as e:
+                if exception_handler is None:
+                    raise
+                res = exception_handler(e, self)
+                if inspect.isawaitable(res):
+                    await res
+            # Ensure that other tasks on the event loop get a chance to run
+            # if we didn't have to block for I/O anywhere.
+            await asyncio.sleep(0)
+
+
+class PubsubWorkerExceptionHandler(Protocol):
+    def __call__(self, e: BaseException, pubsub: PubSub):
+        ...
+
+
+class AsyncPubsubWorkerExceptionHandler(Protocol):
+    async def __call__(self, e: BaseException, pubsub: PubSub):
+        ...
+
+
+PSWorkerThreadExcHandlerT = Union[
+    PubsubWorkerExceptionHandler, AsyncPubsubWorkerExceptionHandler
+]
+
+
+CommandT = Tuple[Tuple[Union[str, bytes], ...], Mapping[str, Any]]
+CommandStackT = List[CommandT]
+
+
+class Pipeline(Redis):  # lgtm [py/init-calls-subclass]
+    """
+    Pipelines provide a way to transmit multiple commands to the Redis server
+    in one transmission.  This is convenient for batch processing, such as
+    saving all the values in a list to Redis.
+
+    All commands executed within a pipeline are wrapped with MULTI and EXEC
+    calls. This guarantees all commands executed in the pipeline will be
+    executed atomically.
+
+    Any command raising an exception does *not* halt the execution of
+    subsequent commands in the pipeline. Instead, the exception is caught
+    and its instance is placed into the response list returned by execute().
+    Code iterating over the response list should be able to deal with an
+    instance of an exception as a potential value. In general, these will be
+    ResponseError exceptions, such as those raised when issuing a command
+    on a key of a different datatype.
+    """
+
+    UNWATCH_COMMANDS = {"DISCARD", "EXEC", "UNWATCH"}
+
+    def __init__(
+        self,
+        connection_pool: ConnectionPool,
+        response_callbacks: MutableMapping[Union[str, bytes], ResponseCallbackT],
+        transaction: bool,
+        shard_hint: Optional[str],
+    ):
+        self.connection_pool = connection_pool
+        self.connection = None
+        self.response_callbacks = response_callbacks
+        self.is_transaction = transaction
+        self.shard_hint = shard_hint
+        self.watching = False
+        self.command_stack: CommandStackT = []
+        self.scripts: Set["Script"] = set()
+        self.explicit_transaction = False
+
+    async def __aenter__(self: _RedisT) -> _RedisT:
+        return self
+
+    async def __aexit__(self, exc_type, exc_value, traceback):
+        await self.reset()
+
+    def __await__(self):
+        return self._async_self().__await__()
+
+    _DEL_MESSAGE = "Unclosed Pipeline client"
+
+    def __len__(self):
+        return len(self.command_stack)
+
+    def __bool__(self):
+        """Pipeline instances should always evaluate to True"""
+        return True
+
+    async def _async_self(self):
+        return self
+
+    async def reset(self):
+        self.command_stack = []
+        self.scripts = set()
+        # make sure to reset the connection state in the event that we were
+        # watching something
+        if self.watching and self.connection:
+            try:
+                # call this manually since our unwatch or
+                # immediate_execute_command methods can call reset()
+                await self.connection.send_command("UNWATCH")
+                await self.connection.read_response()
+            except ConnectionError:
+                # disconnect will also remove any previous WATCHes
+                if self.connection:
+                    await self.connection.disconnect()
+        # clean up the other instance attributes
+        self.watching = False
+        self.explicit_transaction = False
+        # we can safely return the connection to the pool here since we're
+        # sure we're no longer WATCHing anything
+        if self.connection:
+            await self.connection_pool.release(self.connection)
+            self.connection = None
+
+    def multi(self):
+        """
+        Start a transactional block of the pipeline after WATCH commands
+        are issued. End the transactional block with `execute`.
+        """
+        if self.explicit_transaction:
+            raise RedisError("Cannot issue nested calls to MULTI")
+        if self.command_stack:
+            raise RedisError(
+                "Commands without an initial WATCH have already " "been issued"
+            )
+        self.explicit_transaction = True
+
+    def execute_command(
+        self, *args, **kwargs
+    ) -> Union["Pipeline", Awaitable["Pipeline"]]:
+        if (self.watching or args[0] == "WATCH") and not self.explicit_transaction:
+            return self.immediate_execute_command(*args, **kwargs)
+        return self.pipeline_execute_command(*args, **kwargs)
+
+    async def _disconnect_reset_raise(self, conn, error):
+        """
+        Close the connection, reset watching state and
+        raise an exception if we were watching,
+        retry_on_timeout is not set,
+        or the error is not a TimeoutError
+        """
+        await conn.disconnect()
+        # if we were already watching a variable, the watch is no longer
+        # valid since this connection has died. raise a WatchError, which
+        # indicates the user should retry this transaction.
+        if self.watching:
+            await self.reset()
+            raise WatchError(
+                "A ConnectionError occurred on while " "watching one or more keys"
+            )
+        # if retry_on_timeout is not set, or the error is not
+        # a TimeoutError, raise it
+        if not (conn.retry_on_timeout and isinstance(error, TimeoutError)):
+            await self.reset()
+            raise
+
+    async def immediate_execute_command(self, *args, **options):
+        """
+        Execute a command immediately, but don't auto-retry on a
+        ConnectionError if we're already WATCHing a variable. Used when
+        issuing WATCH or subsequent commands retrieving their values but before
+        MULTI is called.
+        """
+        command_name = args[0]
+        conn = self.connection
+        # if this is the first call, we need a connection
+        if not conn:
+            conn = await self.connection_pool.get_connection(
+                command_name, self.shard_hint
+            )
+            self.connection = conn
+
+        return await conn.retry.call_with_retry(
+            lambda: self._send_command_parse_response(
+                conn, command_name, *args, **options
+            ),
+            lambda error: self._disconnect_reset_raise(conn, error),
+        )
+
+    def pipeline_execute_command(self, *args, **options):
+        """
+        Stage a command to be executed when execute() is next called
+
+        Returns the current Pipeline object back so commands can be
+        chained together, such as:
+
+        pipe = pipe.set('foo', 'bar').incr('baz').decr('bang')
+
+        At some other point, you can then run: pipe.execute(),
+        which will execute all commands queued in the pipe.
+        """
+        self.command_stack.append((args, options))
+        return self
+
+    async def _execute_transaction(  # noqa: C901
+        self, connection: Connection, commands: CommandStackT, raise_on_error
+    ):
+        pre: CommandT = (("MULTI",), {})
+        post: CommandT = (("EXEC",), {})
+        cmds = (pre, *commands, post)
+        all_cmds = connection.pack_commands(
+            args for args, options in cmds if EMPTY_RESPONSE not in options
+        )
+        await connection.send_packed_command(all_cmds)
+        errors = []
+
+        # parse off the response for MULTI
+        # NOTE: we need to handle ResponseErrors here and continue
+        # so that we read all the additional command messages from
+        # the socket
+        try:
+            await self.parse_response(connection, "_")
+        except ResponseError as err:
+            errors.append((0, err))
+
+        # and all the other commands
+        for i, command in enumerate(commands):
+            if EMPTY_RESPONSE in command[1]:
+                errors.append((i, command[1][EMPTY_RESPONSE]))
+            else:
+                try:
+                    await self.parse_response(connection, "_")
+                except ResponseError as err:
+                    self.annotate_exception(err, i + 1, command[0])
+                    errors.append((i, err))
+
+        # parse the EXEC.
+        try:
+            response = await self.parse_response(connection, "_")
+        except ExecAbortError as err:
+            if errors:
+                raise errors[0][1] from err
+            raise
+
+        # EXEC clears any watched keys
+        self.watching = False
+
+        if response is None:
+            raise WatchError("Watched variable changed.") from None
+
+        # put any parse errors into the response
+        for i, e in errors:
+            response.insert(i, e)
+
+        if len(response) != len(commands):
+            if self.connection:
+                await self.connection.disconnect()
+            raise ResponseError(
+                "Wrong number of response items from pipeline execution"
+            ) from None
+
+        # find any errors in the response and raise if necessary
+        if raise_on_error:
+            self.raise_first_error(commands, response)
+
+        # We have to run response callbacks manually
+        data = []
+        for r, cmd in zip(response, commands):
+            if not isinstance(r, Exception):
+                args, options = cmd
+                command_name = args[0]
+                if command_name in self.response_callbacks:
+                    r = self.response_callbacks[command_name](r, **options)
+                    if inspect.isawaitable(r):
+                        r = await r
+            data.append(r)
+        return data
+
+    async def _execute_pipeline(
+        self, connection: Connection, commands: CommandStackT, raise_on_error: bool
+    ):
+        # build up all commands into a single request to increase network perf
+        all_cmds = connection.pack_commands([args for args, _ in commands])
+        await connection.send_packed_command(all_cmds)
+
+        response = []
+        for args, options in commands:
+            try:
+                response.append(
+                    await self.parse_response(connection, args[0], **options)
+                )
+            except ResponseError as e:
+                response.append(e)
+
+        if raise_on_error:
+            self.raise_first_error(commands, response)
+        return response
+
+    def raise_first_error(self, commands: CommandStackT, response: Iterable[Any]):
+        for i, r in enumerate(response):
+            if isinstance(r, ResponseError):
+                self.annotate_exception(r, i + 1, commands[i][0])
+                raise r
+
+    def annotate_exception(
+        self, exception: Exception, number: int, command: Iterable[object]
+    ) -> None:
+        cmd = " ".join(map(safe_str, command))
+        msg = f"Command # {number} ({cmd}) of pipeline caused error: {exception.args}"
+        exception.args = (msg,) + exception.args[1:]
+
+    async def parse_response(
+        self, connection: Connection, command_name: Union[str, bytes], **options
+    ):
+        result = await super().parse_response(connection, command_name, **options)
+        if command_name in self.UNWATCH_COMMANDS:
+            self.watching = False
+        elif command_name == "WATCH":
+            self.watching = True
+        return result
+
+    async def load_scripts(self):
+        # make sure all scripts that are about to be run on this pipeline exist
+        scripts = list(self.scripts)
+        immediate = self.immediate_execute_command
+        shas = [s.sha for s in scripts]
+        # we can't use the normal script_* methods because they would just
+        # get buffered in the pipeline.
+        exists = await immediate("SCRIPT EXISTS", *shas)
+        if not all(exists):
+            for s, exist in zip(scripts, exists):
+                if not exist:
+                    s.sha = await immediate("SCRIPT LOAD", s.script)
+
+    async def _disconnect_raise_reset(self, conn: Connection, error: Exception):
+        """
+        Close the connection, raise an exception if we were watching,
+        and raise an exception if retry_on_timeout is not set,
+        or the error is not a TimeoutError
+        """
+        await conn.disconnect()
+        # if we were watching a variable, the watch is no longer valid
+        # since this connection has died. raise a WatchError, which
+        # indicates the user should retry this transaction.
+        if self.watching:
+            raise WatchError(
+                "A ConnectionError occurred on while " "watching one or more keys"
+            )
+        # if retry_on_timeout is not set, or the error is not
+        # a TimeoutError, raise it
+        if not (conn.retry_on_timeout and isinstance(error, TimeoutError)):
+            await self.reset()
+            raise
+
+    async def execute(self, raise_on_error: bool = True):
+        """Execute all the commands in the current pipeline"""
+        stack = self.command_stack
+        if not stack and not self.watching:
+            return []
+        if self.scripts:
+            await self.load_scripts()
+        if self.is_transaction or self.explicit_transaction:
+            execute = self._execute_transaction
+        else:
+            execute = self._execute_pipeline
+
+        conn = self.connection
+        if not conn:
+            conn = await self.connection_pool.get_connection("MULTI", self.shard_hint)
+            # assign to self.connection so reset() releases the connection
+            # back to the pool after we're done
+            self.connection = conn
+        conn = cast(Connection, conn)
+
+        try:
+            return await conn.retry.call_with_retry(
+                lambda: execute(conn, stack, raise_on_error),
+                lambda error: self._disconnect_raise_reset(conn, error),
+            )
+        finally:
+            await self.reset()
+
+    async def discard(self):
+        """Flushes all previously queued commands
+        See: https://redis.io/commands/DISCARD
+        """
+        await self.execute_command("DISCARD")
+
+    async def watch(self, *names: KeyT):
+        """Watches the values at keys ``names``"""
+        if self.explicit_transaction:
+            raise RedisError("Cannot issue a WATCH after a MULTI")
+        return await self.execute_command("WATCH", *names)
+
+    async def unwatch(self):
+        """Unwatches all previously specified keys"""
+        return self.watching and await self.execute_command("UNWATCH") or True
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
new file mode 100644
index 0000000000..ae54d8147a
--- /dev/null
+++ b/redis/asyncio/connection.py
@@ -0,0 +1,1707 @@
+import asyncio
+import copy
+import enum
+import errno
+import inspect
+import io
+import os
+import socket
+import ssl
+import sys
+import threading
+import weakref
+from itertools import chain
+from types import MappingProxyType
+from typing import (
+    Any,
+    Callable,
+    Iterable,
+    List,
+    Mapping,
+    Optional,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+)
+from urllib.parse import ParseResult, parse_qs, unquote, urlparse
+
+import async_timeout
+
+from redis.asyncio.retry import Retry
+from redis.backoff import NoBackoff
+from redis.compat import Protocol, TypedDict
+from redis.exceptions import (
+    AuthenticationError,
+    AuthenticationWrongNumberOfArgsError,
+    BusyLoadingError,
+    ChildDeadlockedError,
+    ConnectionError,
+    DataError,
+    ExecAbortError,
+    InvalidResponse,
+    ModuleError,
+    NoPermissionError,
+    NoScriptError,
+    ReadOnlyError,
+    RedisError,
+    ResponseError,
+    TimeoutError,
+)
+from redis.typing import EncodableT, EncodedT
+from redis.utils import HIREDIS_AVAILABLE, str_if_bytes
+
+hiredis = None
+if HIREDIS_AVAILABLE:
+    import hiredis
+
+NONBLOCKING_EXCEPTION_ERROR_NUMBERS = {
+    BlockingIOError: errno.EWOULDBLOCK,
+    ssl.SSLWantReadError: 2,
+    ssl.SSLWantWriteError: 2,
+    ssl.SSLError: 2,
+}
+
+NONBLOCKING_EXCEPTIONS = tuple(NONBLOCKING_EXCEPTION_ERROR_NUMBERS.keys())
+
+
+SYM_STAR = b"*"
+SYM_DOLLAR = b"$"
+SYM_CRLF = b"\r\n"
+SYM_LF = b"\n"
+SYM_EMPTY = b""
+
+SERVER_CLOSED_CONNECTION_ERROR = "Connection closed by server."
+
+
+class _Sentinel(enum.Enum):
+    sentinel = object()
+
+
+SENTINEL = _Sentinel.sentinel
+MODULE_LOAD_ERROR = "Error loading the extension. Please check the server logs."
+NO_SUCH_MODULE_ERROR = "Error unloading module: no such module with that name"
+MODULE_UNLOAD_NOT_POSSIBLE_ERROR = "Error unloading module: operation not possible."
+MODULE_EXPORTS_DATA_TYPES_ERROR = (
+    "Error unloading module: the module "
+    "exports one or more module-side data "
+    "types, can't unload"
+)
+
+
+class _HiredisReaderArgs(TypedDict, total=False):
+    protocolError: Callable[[str], Exception]
+    replyError: Callable[[str], Exception]
+    encoding: Optional[str]
+    errors: Optional[str]
+
+
+class Encoder:
+    """Encode strings to bytes-like and decode bytes-like to strings"""
+
+    __slots__ = "encoding", "encoding_errors", "decode_responses"
+
+    def __init__(self, encoding: str, encoding_errors: str, decode_responses: bool):
+        self.encoding = encoding
+        self.encoding_errors = encoding_errors
+        self.decode_responses = decode_responses
+
+    def encode(self, value: EncodableT) -> EncodedT:
+        """Return a bytestring or bytes-like representation of the value"""
+        if isinstance(value, (bytes, memoryview)):
+            return value
+        if isinstance(value, bool):
+            # special case bool since it is a subclass of int
+            raise DataError(
+                "Invalid input of type: 'bool'. "
+                "Convert to a bytes, string, int or float first."
+            )
+        if isinstance(value, (int, float)):
+            return repr(value).encode()
+        if not isinstance(value, str):
+            # a value we don't know how to deal with. throw an error
+            typename = value.__class__.__name__  # type: ignore[unreachable]
+            raise DataError(
+                f"Invalid input of type: {typename!r}. "
+                "Convert to a bytes, string, int or float first."
+            )
+        return value.encode(self.encoding, self.encoding_errors)
+
+    def decode(self, value: EncodableT, force=False) -> EncodableT:
+        """Return a unicode string from the bytes-like representation"""
+        if self.decode_responses or force:
+            if isinstance(value, memoryview):
+                return value.tobytes().decode(self.encoding, self.encoding_errors)
+            if isinstance(value, bytes):
+                return value.decode(self.encoding, self.encoding_errors)
+        return value
+
+
+ExceptionMappingT = Mapping[str, Union[Type[Exception], Mapping[str, Type[Exception]]]]
+
+
+class BaseParser:
+    """Plain Python parsing class"""
+
+    __slots__ = "_stream", "_buffer", "_read_size"
+
+    EXCEPTION_CLASSES: ExceptionMappingT = {
+        "ERR": {
+            "max number of clients reached": ConnectionError,
+            "Client sent AUTH, but no password is set": AuthenticationError,
+            "invalid password": AuthenticationError,
+            # some Redis server versions report invalid command syntax
+            # in lowercase
+            "wrong number of arguments for 'auth' command": AuthenticationWrongNumberOfArgsError,  # noqa: E501
+            # some Redis server versions report invalid command syntax
+            # in uppercase
+            "wrong number of arguments for 'AUTH' command": AuthenticationWrongNumberOfArgsError,  # noqa: E501
+            MODULE_LOAD_ERROR: ModuleError,
+            MODULE_EXPORTS_DATA_TYPES_ERROR: ModuleError,
+            NO_SUCH_MODULE_ERROR: ModuleError,
+            MODULE_UNLOAD_NOT_POSSIBLE_ERROR: ModuleError,
+        },
+        "EXECABORT": ExecAbortError,
+        "LOADING": BusyLoadingError,
+        "NOSCRIPT": NoScriptError,
+        "READONLY": ReadOnlyError,
+        "NOAUTH": AuthenticationError,
+        "NOPERM": NoPermissionError,
+    }
+
+    def __init__(self, socket_read_size: int):
+        self._stream: Optional[asyncio.StreamReader] = None
+        self._buffer: Optional[SocketBuffer] = None
+        self._read_size = socket_read_size
+
+    def __del__(self):
+        try:
+            self.on_disconnect()
+        except Exception:
+            pass
+
+    def parse_error(self, response: str) -> ResponseError:
+        """Parse an error response"""
+        error_code = response.split(" ")[0]
+        if error_code in self.EXCEPTION_CLASSES:
+            response = response[len(error_code) + 1 :]
+            exception_class = self.EXCEPTION_CLASSES[error_code]
+            if isinstance(exception_class, dict):
+                exception_class = exception_class.get(response, ResponseError)
+            return exception_class(response)
+        return ResponseError(response)
+
+    def on_disconnect(self):
+        raise NotImplementedError()
+
+    def on_connect(self, connection: "Connection"):
+        raise NotImplementedError()
+
+    async def can_read(self, timeout: float) -> bool:
+        raise NotImplementedError()
+
+    async def read_response(
+        self, disable_decoding: bool = False
+    ) -> Union[EncodableT, ResponseError, None, List[EncodableT]]:
+        raise NotImplementedError()
+
+
+class SocketBuffer:
+    """Async-friendly re-impl of redis-py's SocketBuffer.
+
+    TODO: We're currently passing through two buffers,
+        the asyncio.StreamReader and this. I imagine we can reduce the layers here
+        while maintaining compliance with prior art.
+    """
+
+    def __init__(
+        self,
+        stream_reader: asyncio.StreamReader,
+        socket_read_size: int,
+        socket_timeout: Optional[float],
+    ):
+        self._stream: Optional[asyncio.StreamReader] = stream_reader
+        self.socket_read_size = socket_read_size
+        self.socket_timeout = socket_timeout
+        self._buffer: Optional[io.BytesIO] = io.BytesIO()
+        # number of bytes written to the buffer from the socket
+        self.bytes_written = 0
+        # number of bytes read from the buffer
+        self.bytes_read = 0
+
+    @property
+    def length(self):
+        return self.bytes_written - self.bytes_read
+
+    async def _read_from_socket(
+        self,
+        length: Optional[int] = None,
+        timeout: Union[float, None, _Sentinel] = SENTINEL,
+        raise_on_timeout: bool = True,
+    ) -> bool:
+        buf = self._buffer
+        if buf is None or self._stream is None:
+            raise RedisError("Buffer is closed.")
+        buf.seek(self.bytes_written)
+        marker = 0
+        timeout = timeout if timeout is not SENTINEL else self.socket_timeout
+
+        try:
+            while True:
+                async with async_timeout.timeout(timeout):
+                    data = await self._stream.read(self.socket_read_size)
+                # an empty string indicates the server shutdown the socket
+                if isinstance(data, bytes) and len(data) == 0:
+                    raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
+                buf.write(data)
+                data_length = len(data)
+                self.bytes_written += data_length
+                marker += data_length
+
+                if length is not None and length > marker:
+                    continue
+                return True
+        except (socket.timeout, asyncio.TimeoutError):
+            if raise_on_timeout:
+                raise TimeoutError("Timeout reading from socket")
+            return False
+        except NONBLOCKING_EXCEPTIONS as ex:
+            # if we're in nonblocking mode and the recv raises a
+            # blocking error, simply return False indicating that
+            # there's no data to be read. otherwise raise the
+            # original exception.
+            allowed = NONBLOCKING_EXCEPTION_ERROR_NUMBERS.get(ex.__class__, -1)
+            if not raise_on_timeout and ex.errno == allowed:
+                return False
+            raise ConnectionError(f"Error while reading from socket: {ex.args}")
+
+    async def can_read(self, timeout: float) -> bool:
+        return bool(self.length) or await self._read_from_socket(
+            timeout=timeout, raise_on_timeout=False
+        )
+
+    async def read(self, length: int) -> bytes:
+        length = length + 2  # make sure to read the \r\n terminator
+        # make sure we've read enough data from the socket
+        if length > self.length:
+            await self._read_from_socket(length - self.length)
+
+        if self._buffer is None:
+            raise RedisError("Buffer is closed.")
+
+        self._buffer.seek(self.bytes_read)
+        data = self._buffer.read(length)
+        self.bytes_read += len(data)
+
+        # purge the buffer when we've consumed it all so it doesn't
+        # grow forever
+        if self.bytes_read == self.bytes_written:
+            self.purge()
+
+        return data[:-2]
+
+    async def readline(self) -> bytes:
+        buf = self._buffer
+        if buf is None:
+            raise RedisError("Buffer is closed.")
+
+        buf.seek(self.bytes_read)
+        data = buf.readline()
+        while not data.endswith(SYM_CRLF):
+            # there's more data in the socket that we need
+            await self._read_from_socket()
+            buf.seek(self.bytes_read)
+            data = buf.readline()
+
+        self.bytes_read += len(data)
+
+        # purge the buffer when we've consumed it all so it doesn't
+        # grow forever
+        if self.bytes_read == self.bytes_written:
+            self.purge()
+
+        return data[:-2]
+
+    def purge(self):
+        if self._buffer is None:
+            raise RedisError("Buffer is closed.")
+
+        self._buffer.seek(0)
+        self._buffer.truncate()
+        self.bytes_written = 0
+        self.bytes_read = 0
+
+    def close(self):
+        try:
+            self.purge()
+            self._buffer.close()  # type: ignore[union-attr]
+        except Exception:
+            # issue #633 suggests the purge/close somehow raised a
+            # BadFileDescriptor error. Perhaps the client ran out of
+            # memory or something else? It's probably OK to ignore
+            # any error being raised from purge/close since we're
+            # removing the reference to the instance below.
+            pass
+        self._buffer = None
+        self._stream = None
+
+
+class PythonParser(BaseParser):
+    """Plain Python parsing class"""
+
+    __slots__ = BaseParser.__slots__ + ("encoder",)
+
+    def __init__(self, socket_read_size: int):
+        super().__init__(socket_read_size)
+        self.encoder: Optional[Encoder] = None
+
+    def on_connect(self, connection: "Connection"):
+        """Called when the stream connects"""
+        self._stream = connection._reader
+        if self._stream is None:
+            raise RedisError("Buffer is closed.")
+
+        self._buffer = SocketBuffer(
+            self._stream, self._read_size, connection.socket_timeout
+        )
+        self.encoder = connection.encoder
+
+    def on_disconnect(self):
+        """Called when the stream disconnects"""
+        if self._stream is not None:
+            self._stream = None
+        if self._buffer is not None:
+            self._buffer.close()
+            self._buffer = None
+        self.encoder = None
+
+    async def can_read(self, timeout: float):
+        return self._buffer and bool(await self._buffer.can_read(timeout))
+
+    async def read_response(
+        self, disable_decoding: bool = False
+    ) -> Union[EncodableT, ResponseError, None]:
+        if not self._buffer or not self.encoder:
+            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
+        raw = await self._buffer.readline()
+        if not raw:
+            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
+        response: Any
+        byte, response = raw[:1], raw[1:]
+
+        if byte not in (b"-", b"+", b":", b"$", b"*"):
+            raise InvalidResponse(f"Protocol Error: {raw!r}")
+
+        # server returned an error
+        if byte == b"-":
+            response = response.decode("utf-8", errors="replace")
+            error = self.parse_error(response)
+            # if the error is a ConnectionError, raise immediately so the user
+            # is notified
+            if isinstance(error, ConnectionError):
+                raise error
+            # otherwise, we're dealing with a ResponseError that might belong
+            # inside a pipeline response. the connection's read_response()
+            # and/or the pipeline's execute() will raise this error if
+            # necessary, so just return the exception instance here.
+            return error
+        # single value
+        elif byte == b"+":
+            pass
+        # int value
+        elif byte == b":":
+            response = int(response)
+        # bulk response
+        elif byte == b"$":
+            length = int(response)
+            if length == -1:
+                return None
+            response = await self._buffer.read(length)
+        # multi-bulk response
+        elif byte == b"*":
+            length = int(response)
+            if length == -1:
+                return None
+            response = [
+                (await self.read_response(disable_decoding)) for _ in range(length)
+            ]
+        if isinstance(response, bytes) and disable_decoding is False:
+            response = self.encoder.decode(response)
+        return response
+
+
+class HiredisParser(BaseParser):
+    """Parser class for connections using Hiredis"""
+
+    __slots__ = BaseParser.__slots__ + ("_next_response", "_reader", "_socket_timeout")
+
+    _next_response: bool
+
+    def __init__(self, socket_read_size: int):
+        if not HIREDIS_AVAILABLE:
+            raise RedisError("Hiredis is not available.")
+        super().__init__(socket_read_size=socket_read_size)
+        self._reader: Optional[hiredis.Reader] = None
+        self._socket_timeout: Optional[float] = None
+
+    def on_connect(self, connection: "Connection"):
+        self._stream = connection._reader
+        kwargs: _HiredisReaderArgs = {
+            "protocolError": InvalidResponse,
+            "replyError": self.parse_error,
+        }
+        if connection.encoder.decode_responses:
+            kwargs["encoding"] = connection.encoder.encoding
+            kwargs["errors"] = connection.encoder.encoding_errors
+
+        self._reader = hiredis.Reader(**kwargs)
+        self._next_response = False
+        self._socket_timeout = connection.socket_timeout
+
+    def on_disconnect(self):
+        self._stream = None
+        self._reader = None
+        self._next_response = False
+
+    async def can_read(self, timeout: float):
+        if not self._reader:
+            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
+
+        if self._next_response is False:
+            self._next_response = self._reader.gets()
+        if self._next_response is False:
+            return await self.read_from_socket(timeout=timeout, raise_on_timeout=False)
+        return True
+
+    async def read_from_socket(
+        self,
+        timeout: Union[float, None, _Sentinel] = SENTINEL,
+        raise_on_timeout: bool = True,
+    ):
+        if self._stream is None or self._reader is None:
+            raise RedisError("Parser already closed.")
+
+        timeout = self._socket_timeout if timeout is SENTINEL else timeout
+        try:
+            async with async_timeout.timeout(timeout):
+                buffer = await self._stream.read(self._read_size)
+            if not isinstance(buffer, bytes) or len(buffer) == 0:
+                raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR) from None
+            self._reader.feed(buffer)
+            # data was read from the socket and added to the buffer.
+            # return True to indicate that data was read.
+            return True
+        except asyncio.CancelledError:
+            raise
+        except (socket.timeout, asyncio.TimeoutError):
+            if raise_on_timeout:
+                raise TimeoutError("Timeout reading from socket") from None
+            return False
+        except NONBLOCKING_EXCEPTIONS as ex:
+            # if we're in nonblocking mode and the recv raises a
+            # blocking error, simply return False indicating that
+            # there's no data to be read. otherwise raise the
+            # original exception.
+            allowed = NONBLOCKING_EXCEPTION_ERROR_NUMBERS.get(ex.__class__, -1)
+            if not raise_on_timeout and ex.errno == allowed:
+                return False
+            raise ConnectionError(f"Error while reading from socket: {ex.args}")
+
+    async def read_response(
+        self, disable_decoding: bool = False
+    ) -> Union[EncodableT, List[EncodableT]]:
+        if not self._stream or not self._reader:
+            self.on_disconnect()
+            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR) from None
+
+        response: Union[
+            EncodableT, ConnectionError, List[Union[EncodableT, ConnectionError]]
+        ]
+        # _next_response might be cached from a can_read() call
+        if self._next_response is not False:
+            response = self._next_response
+            self._next_response = False
+            return response
+
+        response = self._reader.gets()
+        while response is False:
+            await self.read_from_socket()
+            response = self._reader.gets()
+
+        # if the response is a ConnectionError or the response is a list and
+        # the first item is a ConnectionError, raise it as something bad
+        # happened
+        if isinstance(response, ConnectionError):
+            raise response
+        elif (
+            isinstance(response, list)
+            and response
+            and isinstance(response[0], ConnectionError)
+        ):
+            raise response[0]
+        # cast as there won't be a ConnectionError here.
+        return cast(Union[EncodableT, List[EncodableT]], response)
+
+
+DefaultParser: Type[Union[PythonParser, HiredisParser]]
+if HIREDIS_AVAILABLE:
+    DefaultParser = HiredisParser
+else:
+    DefaultParser = PythonParser
+
+
+class ConnectCallbackProtocol(Protocol):
+    def __call__(self, connection: "Connection"):
+        ...
+
+
+class AsyncConnectCallbackProtocol(Protocol):
+    async def __call__(self, connection: "Connection"):
+        ...
+
+
+ConnectCallbackT = Union[ConnectCallbackProtocol, AsyncConnectCallbackProtocol]
+
+
+class Connection:
+    """Manages TCP communication to and from a Redis server"""
+
+    __slots__ = (
+        "pid",
+        "host",
+        "port",
+        "db",
+        "username",
+        "client_name",
+        "password",
+        "socket_timeout",
+        "socket_connect_timeout",
+        "socket_keepalive",
+        "socket_keepalive_options",
+        "socket_type",
+        "redis_connect_func",
+        "retry_on_timeout",
+        "health_check_interval",
+        "next_health_check",
+        "last_active_at",
+        "encoder",
+        "ssl_context",
+        "_reader",
+        "_writer",
+        "_parser",
+        "_connect_callbacks",
+        "_buffer_cutoff",
+        "_lock",
+        "_socket_read_size",
+        "__dict__",
+    )
+
+    def __init__(
+        self,
+        *,
+        host: str = "localhost",
+        port: Union[str, int] = 6379,
+        db: Union[str, int] = 0,
+        password: Optional[str] = None,
+        socket_timeout: Optional[float] = None,
+        socket_connect_timeout: Optional[float] = None,
+        socket_keepalive: bool = False,
+        socket_keepalive_options: Optional[Mapping[int, Union[int, bytes]]] = None,
+        socket_type: int = 0,
+        retry_on_timeout: bool = False,
+        encoding: str = "utf-8",
+        encoding_errors: str = "strict",
+        decode_responses: bool = False,
+        parser_class: Type[BaseParser] = DefaultParser,
+        socket_read_size: int = 65536,
+        health_check_interval: float = 0,
+        client_name: Optional[str] = None,
+        username: Optional[str] = None,
+        retry: Optional[Retry] = None,
+        redis_connect_func: Optional[ConnectCallbackT] = None,
+        encoder_class: Type[Encoder] = Encoder,
+    ):
+        self.pid = os.getpid()
+        self.host = host
+        self.port = int(port)
+        self.db = db
+        self.username = username
+        self.client_name = client_name
+        self.password = password
+        self.socket_timeout = socket_timeout
+        self.socket_connect_timeout = socket_connect_timeout or socket_timeout or None
+        self.socket_keepalive = socket_keepalive
+        self.socket_keepalive_options = socket_keepalive_options or {}
+        self.socket_type = socket_type
+        self.retry_on_timeout = retry_on_timeout
+        if retry_on_timeout:
+            if retry is None:
+                self.retry = Retry(NoBackoff(), 1)
+            else:
+                # deep-copy the Retry object as it is mutable
+                self.retry = copy.deepcopy(retry)
+        else:
+            self.retry = Retry(NoBackoff(), 0)
+        self.health_check_interval = health_check_interval
+        self.next_health_check: float = -1
+        self.ssl_context: Optional[RedisSSLContext] = None
+        self.encoder = encoder_class(encoding, encoding_errors, decode_responses)
+        self.redis_connect_func = redis_connect_func
+        self._reader: Optional[asyncio.StreamReader] = None
+        self._writer: Optional[asyncio.StreamWriter] = None
+        self._socket_read_size = socket_read_size
+        self.set_parser(parser_class)
+        self._connect_callbacks: List[weakref.WeakMethod[ConnectCallbackT]] = []
+        self._buffer_cutoff = 6000
+        self._lock = asyncio.Lock()
+
+    def __repr__(self):
+        repr_args = ",".join((f"{k}={v}" for k, v in self.repr_pieces()))
+        return f"{self.__class__.__name__}<{repr_args}>"
+
+    def repr_pieces(self):
+        pieces = [("host", self.host), ("port", self.port), ("db", self.db)]
+        if self.client_name:
+            pieces.append(("client_name", self.client_name))
+        return pieces
+
+    def __del__(self):
+        try:
+            if self.is_connected:
+                loop = asyncio.get_event_loop()
+                coro = self.disconnect()
+                if loop.is_running():
+                    loop.create_task(coro)
+                else:
+                    loop.run_until_complete(coro)
+        except Exception:
+            pass
+
+    @property
+    def is_connected(self):
+        return bool(self._reader and self._writer)
+
+    def register_connect_callback(self, callback):
+        self._connect_callbacks.append(weakref.WeakMethod(callback))
+
+    def clear_connect_callbacks(self):
+        self._connect_callbacks = []
+
+    def set_parser(self, parser_class):
+        """
+        Creates a new instance of parser_class with socket size:
+        _socket_read_size and assigns it to the parser for the connection
+        :param parser_class: The required parser class
+        """
+        self._parser = parser_class(socket_read_size=self._socket_read_size)
+
+    async def connect(self):
+        """Connects to the Redis server if not already connected"""
+        if self.is_connected:
+            return
+        try:
+            await self._connect()
+        except asyncio.CancelledError:
+            raise
+        except (socket.timeout, asyncio.TimeoutError):
+            raise TimeoutError("Timeout connecting to server")
+        except OSError as e:
+            raise ConnectionError(self._error_message(e))
+        except Exception as exc:
+            raise ConnectionError(exc) from exc
+
+        try:
+            if self.redis_connect_func is None:
+                # Use the default on_connect function
+                await self.on_connect()
+            else:
+                # Use the passed function redis_connect_func
+                await self.redis_connect_func(self) if asyncio.iscoroutinefunction(
+                    self.redis_connect_func
+                ) else self.redis_connect_func(self)
+        except RedisError:
+            # clean up after any error in on_connect
+            await self.disconnect()
+            raise
+
+        # run any user callbacks. right now the only internal callback
+        # is for pubsub channel/pattern resubscription
+        for ref in self._connect_callbacks:
+            callback = ref()
+            task = callback(self)
+            if task and inspect.isawaitable(task):
+                await task
+
+    async def _connect(self):
+        """Create a TCP socket connection"""
+        async with async_timeout.timeout(self.socket_connect_timeout):
+            reader, writer = await asyncio.open_connection(
+                host=self.host,
+                port=self.port,
+                ssl=self.ssl_context.get() if self.ssl_context else None,
+            )
+        self._reader = reader
+        self._writer = writer
+        sock = writer.transport.get_extra_info("socket")
+        if sock is not None:
+            sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)
+            try:
+                # TCP_KEEPALIVE
+                if self.socket_keepalive:
+                    sock.setsockopt(socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1)
+                    for k, v in self.socket_keepalive_options.items():
+                        sock.setsockopt(socket.SOL_TCP, k, v)
+
+            except (OSError, TypeError):
+                # `socket_keepalive_options` might contain invalid options
+                # causing an error. Do not leave the connection open.
+                writer.close()
+                raise
+
+    def _error_message(self, exception):
+        # args for socket.error can either be (errno, "message")
+        # or just "message"
+        if len(exception.args) == 1:
+            return f"Error connecting to {self.host}:{self.port}. {exception.args[0]}."
+        else:
+            return (
+                f"Error {exception.args[0]} connecting to {self.host}:{self.port}. "
+                f"{exception.args[0]}."
+            )
+
+    async def on_connect(self):
+        """Initialize the connection, authenticate and select a database"""
+        self._parser.on_connect(self)
+
+        # if username and/or password are set, authenticate
+        if self.username or self.password:
+            auth_args: Union[Tuple[str], Tuple[str, str]]
+            if self.username:
+                auth_args = (self.username, self.password or "")
+            else:
+                # Mypy bug: https://github.com/python/mypy/issues/10944
+                auth_args = (self.password or "",)
+            # avoid checking health here -- PING will fail if we try
+            # to check the health prior to the AUTH
+            await self.send_command("AUTH", *auth_args, check_health=False)
+
+            try:
+                auth_response = await self.read_response()
+            except AuthenticationWrongNumberOfArgsError:
+                # a username and password were specified but the Redis
+                # server seems to be < 6.0.0 which expects a single password
+                # arg. retry auth with just the password.
+                # https://github.com/andymccurdy/redis-py/issues/1274
+                await self.send_command("AUTH", self.password, check_health=False)
+                auth_response = await self.read_response()
+
+            if str_if_bytes(auth_response) != "OK":
+                raise AuthenticationError("Invalid Username or Password")
+
+        # if a client_name is given, set it
+        if self.client_name:
+            await self.send_command("CLIENT", "SETNAME", self.client_name)
+            if str_if_bytes(await self.read_response()) != "OK":
+                raise ConnectionError("Error setting client name")
+
+        # if a database is specified, switch to it
+        if self.db:
+            await self.send_command("SELECT", self.db)
+            if str_if_bytes(await self.read_response()) != "OK":
+                raise ConnectionError("Invalid Database")
+
+    async def disconnect(self):
+        """Disconnects from the Redis server"""
+        try:
+            async with async_timeout.timeout(self.socket_connect_timeout):
+                self._parser.on_disconnect()
+                if not self.is_connected:
+                    return
+                try:
+                    if os.getpid() == self.pid:
+                        self._writer.close()  # type: ignore[union-attr]
+                        # py3.6 doesn't have this method
+                        if hasattr(self._writer, "wait_closed"):
+                            await self._writer.wait_closed()  # type: ignore[union-attr]
+                except OSError:
+                    pass
+                self._reader = None
+                self._writer = None
+        except asyncio.TimeoutError:
+            raise TimeoutError(
+                f"Timed out closing connection after {self.socket_connect_timeout}"
+            ) from None
+
+    async def _send_ping(self):
+        """Send PING, expect PONG in return"""
+        await self.send_command("PING", check_health=False)
+        if str_if_bytes(await self.read_response()) != "PONG":
+            raise ConnectionError("Bad response from PING health check")
+
+    async def _ping_failed(self, error):
+        """Function to call when PING fails"""
+        await self.disconnect()
+
+    async def check_health(self):
+        """Check the health of the connection with a PING/PONG"""
+        if sys.version_info[0:2] == (3, 6):
+            func = asyncio.get_event_loop
+        else:
+            func = asyncio.get_running_loop
+
+        if self.health_check_interval and func().time() > self.next_health_check:
+            await self.retry.call_with_retry(self._send_ping, self._ping_failed)
+
+    async def _send_packed_command(self, command: Iterable[bytes]) -> None:
+        if self._writer is None:
+            raise RedisError("Connection already closed.")
+
+        self._writer.writelines(command)
+        await self._writer.drain()
+
+    async def send_packed_command(
+        self,
+        command: Union[bytes, str, Iterable[bytes]],
+        check_health: bool = True,
+    ):
+        """Send an already packed command to the Redis server"""
+        if not self._writer:
+            await self.connect()
+        # guard against health check recursion
+        if check_health:
+            await self.check_health()
+        try:
+            if isinstance(command, str):
+                command = command.encode()
+            if isinstance(command, bytes):
+                command = [command]
+            await asyncio.wait_for(
+                self._send_packed_command(command),
+                self.socket_timeout,
+            )
+        except asyncio.TimeoutError:
+            await self.disconnect()
+            raise TimeoutError("Timeout writing to socket") from None
+        except OSError as e:
+            await self.disconnect()
+            if len(e.args) == 1:
+                err_no, errmsg = "UNKNOWN", e.args[0]
+            else:
+                err_no = e.args[0]
+                errmsg = e.args[1]
+            raise ConnectionError(
+                f"Error {err_no} while writing to socket. {errmsg}."
+            ) from e
+        except BaseException:
+            await self.disconnect()
+            raise
+
+    async def send_command(self, *args, **kwargs):
+        """Pack and send a command to the Redis server"""
+        if not self.is_connected:
+            await self.connect()
+        await self.send_packed_command(
+            self.pack_command(*args), check_health=kwargs.get("check_health", True)
+        )
+
+    async def can_read(self, timeout: float = 0):
+        """Poll the socket to see if there's data that can be read."""
+        if not self.is_connected:
+            await self.connect()
+        return await self._parser.can_read(timeout)
+
+    async def read_response(self, disable_decoding: bool = False):
+        """Read the response from a previously sent command"""
+        try:
+            async with self._lock:
+                async with async_timeout.timeout(self.socket_timeout):
+                    response = await self._parser.read_response(
+                        disable_decoding=disable_decoding
+                    )
+        except asyncio.TimeoutError:
+            await self.disconnect()
+            raise TimeoutError(f"Timeout reading from {self.host}:{self.port}")
+        except OSError as e:
+            await self.disconnect()
+            raise ConnectionError(
+                f"Error while reading from {self.host}:{self.port} : {e.args}"
+            )
+        except BaseException:
+            await self.disconnect()
+            raise
+
+        if self.health_check_interval:
+            if sys.version_info[0:2] == (3, 6):
+                func = asyncio.get_event_loop
+            else:
+                func = asyncio.get_running_loop
+            self.next_health_check = func().time() + self.health_check_interval
+
+        if isinstance(response, ResponseError):
+            raise response from None
+        return response
+
+    def pack_command(self, *args: EncodableT) -> List[bytes]:
+        """Pack a series of arguments into the Redis protocol"""
+        output = []
+        # the client might have included 1 or more literal arguments in
+        # the command name, e.g., 'CONFIG GET'. The Redis server expects these
+        # arguments to be sent separately, so split the first argument
+        # manually. These arguments should be bytestrings so that they are
+        # not encoded.
+        assert not isinstance(args[0], float)
+        if isinstance(args[0], str):
+            args = tuple(args[0].encode().split()) + args[1:]
+        elif b" " in args[0]:
+            args = tuple(args[0].split()) + args[1:]
+
+        buff = SYM_EMPTY.join((SYM_STAR, str(len(args)).encode(), SYM_CRLF))
+
+        buffer_cutoff = self._buffer_cutoff
+        for arg in map(self.encoder.encode, args):
+            # to avoid large string mallocs, chunk the command into the
+            # output list if we're sending large values or memoryviews
+            arg_length = len(arg)
+            if (
+                len(buff) > buffer_cutoff
+                or arg_length > buffer_cutoff
+                or isinstance(arg, memoryview)
+            ):
+                buff = SYM_EMPTY.join(
+                    (buff, SYM_DOLLAR, str(arg_length).encode(), SYM_CRLF)
+                )
+                output.append(buff)
+                output.append(arg)
+                buff = SYM_CRLF
+            else:
+                buff = SYM_EMPTY.join(
+                    (
+                        buff,
+                        SYM_DOLLAR,
+                        str(arg_length).encode(),
+                        SYM_CRLF,
+                        arg,
+                        SYM_CRLF,
+                    )
+                )
+        output.append(buff)
+        return output
+
+    def pack_commands(self, commands: Iterable[Iterable[EncodableT]]) -> List[bytes]:
+        """Pack multiple commands into the Redis protocol"""
+        output: List[bytes] = []
+        pieces: List[bytes] = []
+        buffer_length = 0
+        buffer_cutoff = self._buffer_cutoff
+
+        for cmd in commands:
+            for chunk in self.pack_command(*cmd):
+                chunklen = len(chunk)
+                if (
+                    buffer_length > buffer_cutoff
+                    or chunklen > buffer_cutoff
+                    or isinstance(chunk, memoryview)
+                ):
+                    output.append(SYM_EMPTY.join(pieces))
+                    buffer_length = 0
+                    pieces = []
+
+                if chunklen > buffer_cutoff or isinstance(chunk, memoryview):
+                    output.append(chunk)
+                else:
+                    pieces.append(chunk)
+                    buffer_length += chunklen
+
+        if pieces:
+            output.append(SYM_EMPTY.join(pieces))
+        return output
+
+
+class SSLConnection(Connection):
+    def __init__(
+        self,
+        ssl_keyfile: Optional[str] = None,
+        ssl_certfile: Optional[str] = None,
+        ssl_cert_reqs: str = "required",
+        ssl_ca_certs: Optional[str] = None,
+        ssl_check_hostname: bool = False,
+        **kwargs,
+    ):
+        super().__init__(**kwargs)
+        self.ssl_context: RedisSSLContext = RedisSSLContext(
+            keyfile=ssl_keyfile,
+            certfile=ssl_certfile,
+            cert_reqs=ssl_cert_reqs,
+            ca_certs=ssl_ca_certs,
+            check_hostname=ssl_check_hostname,
+        )
+
+    @property
+    def keyfile(self):
+        return self.ssl_context.keyfile
+
+    @property
+    def certfile(self):
+        return self.ssl_context.certfile
+
+    @property
+    def cert_reqs(self):
+        return self.ssl_context.cert_reqs
+
+    @property
+    def ca_certs(self):
+        return self.ssl_context.ca_certs
+
+    @property
+    def check_hostname(self):
+        return self.ssl_context.check_hostname
+
+
+class RedisSSLContext:
+    __slots__ = (
+        "keyfile",
+        "certfile",
+        "cert_reqs",
+        "ca_certs",
+        "context",
+        "check_hostname",
+    )
+
+    def __init__(
+        self,
+        keyfile: Optional[str] = None,
+        certfile: Optional[str] = None,
+        cert_reqs: Optional[str] = None,
+        ca_certs: Optional[str] = None,
+        check_hostname: bool = False,
+    ):
+        self.keyfile = keyfile
+        self.certfile = certfile
+        if cert_reqs is None:
+            self.cert_reqs = ssl.CERT_NONE
+        elif isinstance(cert_reqs, str):
+            CERT_REQS = {
+                "none": ssl.CERT_NONE,
+                "optional": ssl.CERT_OPTIONAL,
+                "required": ssl.CERT_REQUIRED,
+            }
+            if cert_reqs not in CERT_REQS:
+                raise RedisError(
+                    f"Invalid SSL Certificate Requirements Flag: {cert_reqs}"
+                )
+            self.cert_reqs = CERT_REQS[cert_reqs]
+        self.ca_certs = ca_certs
+        self.check_hostname = check_hostname
+        self.context: Optional[ssl.SSLContext] = None
+
+    def get(self) -> ssl.SSLContext:
+        if not self.context:
+            context = ssl.create_default_context()
+            context.check_hostname = self.check_hostname
+            context.verify_mode = self.cert_reqs
+            if self.certfile and self.keyfile:
+                context.load_cert_chain(certfile=self.certfile, keyfile=self.keyfile)
+            if self.ca_certs:
+                context.load_verify_locations(self.ca_certs)
+            self.context = context
+        return self.context
+
+
+class UnixDomainSocketConnection(Connection):  # lgtm [py/missing-call-to-init]
+    def __init__(
+        self,
+        *,
+        path: str = "",
+        db: Union[str, int] = 0,
+        username: Optional[str] = None,
+        password: Optional[str] = None,
+        socket_timeout: Optional[float] = None,
+        socket_connect_timeout: Optional[float] = None,
+        encoding: str = "utf-8",
+        encoding_errors: str = "strict",
+        decode_responses: bool = False,
+        retry_on_timeout: bool = False,
+        parser_class: Type[BaseParser] = DefaultParser,
+        socket_read_size: int = 65536,
+        health_check_interval: float = 0.0,
+        client_name: str = None,
+        retry: Optional[Retry] = None,
+    ):
+        """
+        Initialize a new UnixDomainSocketConnection.
+        To specify a retry policy, first set `retry_on_timeout` to `True`
+        then set `retry` to a valid `Retry` object
+        """
+        self.pid = os.getpid()
+        self.path = path
+        self.db = db
+        self.username = username
+        self.client_name = client_name
+        self.password = password
+        self.socket_timeout = socket_timeout
+        self.socket_connect_timeout = socket_connect_timeout or socket_timeout or None
+        self.retry_on_timeout = retry_on_timeout
+        if retry_on_timeout:
+            if retry is None:
+                self.retry = Retry(NoBackoff(), 1)
+            else:
+                # deep-copy the Retry object as it is mutable
+                self.retry = copy.deepcopy(retry)
+        else:
+            self.retry = Retry(NoBackoff(), 0)
+        self.health_check_interval = health_check_interval
+        self.next_health_check = -1
+        self.encoder = Encoder(encoding, encoding_errors, decode_responses)
+        self._sock = None
+        self._reader = None
+        self._writer = None
+        self._socket_read_size = socket_read_size
+        self.set_parser(parser_class)
+        self._connect_callbacks = []
+        self._buffer_cutoff = 6000
+        self._lock = asyncio.Lock()
+
+    def repr_pieces(self) -> Iterable[Tuple[str, Union[str, int]]]:
+        pieces = [
+            ("path", self.path),
+            ("db", self.db),
+        ]
+        if self.client_name:
+            pieces.append(("client_name", self.client_name))
+        return pieces
+
+    async def _connect(self):
+        async with async_timeout.timeout(self.socket_connect_timeout):
+            reader, writer = await asyncio.open_unix_connection(path=self.path)
+        self._reader = reader
+        self._writer = writer
+        await self.on_connect()
+
+    def _error_message(self, exception):
+        # args for socket.error can either be (errno, "message")
+        # or just "message"
+        if len(exception.args) == 1:
+            return f"Error connecting to unix socket: {self.path}. {exception.args[0]}."
+        else:
+            return (
+                f"Error {exception.args[0]} connecting to unix socket: "
+                f"{self.path}. {exception.args[1]}."
+            )
+
+
+FALSE_STRINGS = ("0", "F", "FALSE", "N", "NO")
+
+
+def to_bool(value) -> Optional[bool]:
+    if value is None or value == "":
+        return None
+    if isinstance(value, str) and value.upper() in FALSE_STRINGS:
+        return False
+    return bool(value)
+
+
+URL_QUERY_ARGUMENT_PARSERS: Mapping[str, Callable[..., object]] = MappingProxyType(
+    {
+        "db": int,
+        "socket_timeout": float,
+        "socket_connect_timeout": float,
+        "socket_keepalive": to_bool,
+        "retry_on_timeout": to_bool,
+        "max_connections": int,
+        "health_check_interval": int,
+        "ssl_check_hostname": to_bool,
+    }
+)
+
+
+class ConnectKwargs(TypedDict, total=False):
+    username: str
+    password: str
+    connection_class: Type[Connection]
+    host: str
+    port: int
+    db: int
+    path: str
+
+
+def parse_url(url: str) -> ConnectKwargs:
+    parsed: ParseResult = urlparse(url)
+    kwargs: ConnectKwargs = {}
+
+    for name, value_list in parse_qs(parsed.query).items():
+        if value_list and len(value_list) > 0:
+            value = unquote(value_list[0])
+            parser = URL_QUERY_ARGUMENT_PARSERS.get(name)
+            if parser:
+                try:
+                    # We can't type this.
+                    kwargs[name] = parser(value)  # type: ignore[misc]
+                except (TypeError, ValueError):
+                    raise ValueError(f"Invalid value for `{name}` in connection URL.")
+            else:
+                kwargs[name] = value  # type: ignore[misc]
+
+    if parsed.username:
+        kwargs["username"] = unquote(parsed.username)
+    if parsed.password:
+        kwargs["password"] = unquote(parsed.password)
+
+    # We only support redis://, rediss:// and unix:// schemes.
+    if parsed.scheme == "unix":
+        if parsed.path:
+            kwargs["path"] = unquote(parsed.path)
+        kwargs["connection_class"] = UnixDomainSocketConnection
+
+    elif parsed.scheme in ("redis", "rediss"):
+        if parsed.hostname:
+            kwargs["host"] = unquote(parsed.hostname)
+        if parsed.port:
+            kwargs["port"] = int(parsed.port)
+
+        # If there's a path argument, use it as the db argument if a
+        # querystring value wasn't specified
+        if parsed.path and "db" not in kwargs:
+            try:
+                kwargs["db"] = int(unquote(parsed.path).replace("/", ""))
+            except (AttributeError, ValueError):
+                pass
+
+        if parsed.scheme == "rediss":
+            kwargs["connection_class"] = SSLConnection
+    else:
+        valid_schemes = "redis://, rediss://, unix://"
+        raise ValueError(
+            f"Redis URL must specify one of the following schemes ({valid_schemes})"
+        )
+
+    return kwargs
+
+
+_CP = TypeVar("_CP", bound="ConnectionPool")
+
+
+class ConnectionPool:
+    """
+    Create a connection pool. ``If max_connections`` is set, then this
+    object raises :py:class:`~redis.ConnectionError` when the pool's
+    limit is reached.
+
+    By default, TCP connections are created unless ``connection_class``
+    is specified. Use :py:class:`~redis.UnixDomainSocketConnection` for
+    unix sockets.
+
+    Any additional keyword arguments are passed to the constructor of
+    ``connection_class``.
+    """
+
+    @classmethod
+    def from_url(cls: Type[_CP], url: str, **kwargs) -> _CP:
+        """
+        Return a connection pool configured from the given URL.
+
+        For example::
+
+            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 TCP socket connection. See more at:
+          <https://www.iana.org/assignments/uri-schemes/prov/redis>
+        - `rediss://` creates a SSL wrapped TCP socket connection. See more at:
+          <https://www.iana.org/assignments/uri-schemes/prov/rediss>
+        - ``unix://``: creates a Unix Domain Socket connection.
+
+        The username, password, hostname, path and all querystring values
+        are passed through urllib.parse.unquote in order to replace any
+        percent-encoded values with their corresponding characters.
+
+        There are several ways to specify a database number. The first value
+        found will be used:
+            1. A ``db`` querystring option, e.g. redis://localhost?db=0
+            2. If using the redis:// or rediss:// schemes, the path argument
+               of the url, e.g. redis://localhost/0
+            3. A ``db`` keyword argument to this function.
+
+        If none of these options are specified, the default db=0 is used.
+
+        All querystring options are cast to their appropriate Python types.
+        Boolean arguments can be specified with string values "True"/"False"
+        or "Yes"/"No". Values that cannot be properly cast cause a
+        ``ValueError`` to be raised. Once parsed, the querystring arguments
+        and keyword arguments are passed to the ``ConnectionPool``'s
+        class initializer. In the case of conflicting arguments, querystring
+        arguments always win.
+        """
+        url_options = parse_url(url)
+        kwargs.update(url_options)
+        return cls(**kwargs)
+
+    def __init__(
+        self,
+        connection_class: Type[Connection] = Connection,
+        max_connections: Optional[int] = None,
+        **connection_kwargs,
+    ):
+        max_connections = max_connections or 2 ** 31
+        if not isinstance(max_connections, int) or max_connections < 0:
+            raise ValueError('"max_connections" must be a positive integer')
+
+        self.connection_class = connection_class
+        self.connection_kwargs = connection_kwargs
+        self.max_connections = max_connections
+
+        # a lock to protect the critical section in _checkpid().
+        # this lock is acquired when the process id changes, such as
+        # after a fork. during this time, multiple threads in the child
+        # process could attempt to acquire this lock. the first thread
+        # to acquire the lock will reset the data structures and lock
+        # object of this pool. subsequent threads acquiring this lock
+        # will notice the first thread already did the work and simply
+        # release the lock.
+        self._fork_lock = threading.Lock()
+        self._lock = asyncio.Lock()
+        self._created_connections: int
+        self._available_connections: List[Connection]
+        self._in_use_connections: Set[Connection]
+        self.reset()  # lgtm [py/init-calls-subclass]
+        self.encoder_class = self.connection_kwargs.get("encoder_class", Encoder)
+
+    def __repr__(self):
+        return (
+            f"{self.__class__.__name__}"
+            f"<{self.connection_class(**self.connection_kwargs)!r}>"
+        )
+
+    def reset(self):
+        self._lock = asyncio.Lock()
+        self._created_connections = 0
+        self._available_connections = []
+        self._in_use_connections = set()
+
+        # this must be the last operation in this method. while reset() is
+        # called when holding _fork_lock, other threads in this process
+        # can call _checkpid() which compares self.pid and os.getpid() without
+        # holding any lock (for performance reasons). keeping this assignment
+        # as the last operation ensures that those other threads will also
+        # notice a pid difference and block waiting for the first thread to
+        # release _fork_lock. when each of these threads eventually acquire
+        # _fork_lock, they will notice that another thread already called
+        # reset() and they will immediately release _fork_lock and continue on.
+        self.pid = os.getpid()
+
+    def _checkpid(self):
+        # _checkpid() attempts to keep ConnectionPool fork-safe on modern
+        # systems. this is called by all ConnectionPool methods that
+        # manipulate the pool's state such as get_connection() and release().
+        #
+        # _checkpid() determines whether the process has forked by comparing
+        # the current process id to the process id saved on the ConnectionPool
+        # instance. if these values are the same, _checkpid() simply returns.
+        #
+        # when the process ids differ, _checkpid() assumes that the process
+        # has forked and that we're now running in the child process. the child
+        # process cannot use the parent's file descriptors (e.g., sockets).
+        # therefore, when _checkpid() sees the process id change, it calls
+        # reset() in order to reinitialize the child's ConnectionPool. this
+        # will cause the child to make all new connection objects.
+        #
+        # _checkpid() is protected by self._fork_lock to ensure that multiple
+        # threads in the child process do not call reset() multiple times.
+        #
+        # there is an extremely small chance this could fail in the following
+        # scenario:
+        #   1. process A calls _checkpid() for the first time and acquires
+        #      self._fork_lock.
+        #   2. while holding self._fork_lock, process A forks (the fork()
+        #      could happen in a different thread owned by process A)
+        #   3. process B (the forked child process) inherits the
+        #      ConnectionPool's state from the parent. that state includes
+        #      a locked _fork_lock. process B will not be notified when
+        #      process A releases the _fork_lock and will thus never be
+        #      able to acquire the _fork_lock.
+        #
+        # to mitigate this possible deadlock, _checkpid() will only wait 5
+        # seconds to acquire _fork_lock. if _fork_lock cannot be acquired in
+        # that time it is assumed that the child is deadlocked and a
+        # redis.ChildDeadlockedError error is raised.
+        if self.pid != os.getpid():
+            acquired = self._fork_lock.acquire(timeout=5)
+            if not acquired:
+                raise ChildDeadlockedError
+            # reset() the instance for the new process if another thread
+            # hasn't already done so
+            try:
+                if self.pid != os.getpid():
+                    self.reset()
+            finally:
+                self._fork_lock.release()
+
+    async def get_connection(self, command_name, *keys, **options):
+        """Get a connection from the pool"""
+        self._checkpid()
+        async with self._lock:
+            try:
+                connection = self._available_connections.pop()
+            except IndexError:
+                connection = self.make_connection()
+            self._in_use_connections.add(connection)
+
+        try:
+            # ensure this connection is connected to Redis
+            await connection.connect()
+            # connections that the pool provides should be ready to send
+            # a command. if not, the connection was either returned to the
+            # pool before all data has been read or the socket has been
+            # closed. either way, reconnect and verify everything is good.
+            try:
+                if await connection.can_read():
+                    raise ConnectionError("Connection has data") from None
+            except ConnectionError:
+                await connection.disconnect()
+                await connection.connect()
+                if await connection.can_read():
+                    raise ConnectionError("Connection not ready") from None
+        except BaseException:
+            # release the connection back to the pool so that we don't
+            # leak it
+            await self.release(connection)
+            raise
+
+        return connection
+
+    def get_encoder(self):
+        """Return an encoder based on encoding settings"""
+        kwargs = self.connection_kwargs
+        return self.encoder_class(
+            encoding=kwargs.get("encoding", "utf-8"),
+            encoding_errors=kwargs.get("encoding_errors", "strict"),
+            decode_responses=kwargs.get("decode_responses", False),
+        )
+
+    def make_connection(self):
+        """Create a new connection"""
+        if self._created_connections >= self.max_connections:
+            raise ConnectionError("Too many connections")
+        self._created_connections += 1
+        return self.connection_class(**self.connection_kwargs)
+
+    async def release(self, connection: Connection):
+        """Releases the connection back to the pool"""
+        self._checkpid()
+        async with self._lock:
+            try:
+                self._in_use_connections.remove(connection)
+            except KeyError:
+                # Gracefully fail when a connection is returned to this pool
+                # that the pool doesn't actually own
+                pass
+
+            if self.owns_connection(connection):
+                self._available_connections.append(connection)
+            else:
+                # pool doesn't own this connection. do not add it back
+                # to the pool and decrement the count so that another
+                # connection can take its place if needed
+                self._created_connections -= 1
+                await connection.disconnect()
+                return
+
+    def owns_connection(self, connection: Connection):
+        return connection.pid == self.pid
+
+    async def disconnect(self, inuse_connections: bool = True):
+        """
+        Disconnects connections in the pool
+
+        If ``inuse_connections`` is True, disconnect connections that are
+        current in use, potentially by other tasks. Otherwise only disconnect
+        connections that are idle in the pool.
+        """
+        self._checkpid()
+        async with self._lock:
+            if inuse_connections:
+                connections: Iterable[Connection] = chain(
+                    self._available_connections, self._in_use_connections
+                )
+            else:
+                connections = self._available_connections
+            resp = await asyncio.gather(
+                *(connection.disconnect() for connection in connections),
+                return_exceptions=True,
+            )
+            exc = next((r for r in resp if isinstance(r, BaseException)), None)
+            if exc:
+                raise exc
+
+
+class BlockingConnectionPool(ConnectionPool):
+    """
+    Thread-safe blocking connection pool::
+
+        >>> from redis.client import Redis
+        >>> client = Redis(connection_pool=BlockingConnectionPool())
+
+    It performs the same function as the default
+    :py:class:`~redis.ConnectionPool` implementation, in that,
+    it maintains a pool of reusable connections that can be shared by
+    multiple redis clients (safely across threads if required).
+
+    The difference is that, in the event that a client tries to get a
+    connection from the pool when all of connections are in use, rather than
+    raising a :py:class:`~redis.ConnectionError` (as the default
+    :py:class:`~redis.ConnectionPool` implementation does), it
+    makes the client wait ("blocks") for a specified number of seconds until
+    a connection becomes available.
+
+    Use ``max_connections`` to increase / decrease the pool size::
+
+        >>> pool = BlockingConnectionPool(max_connections=10)
+
+    Use ``timeout`` to tell it either how many seconds to wait for a connection
+    to become available, or to block forever:
+
+        >>> # Block forever.
+        >>> pool = BlockingConnectionPool(timeout=None)
+
+        >>> # Raise a ``ConnectionError`` after five seconds if a connection is
+        >>> # not available.
+        >>> pool = BlockingConnectionPool(timeout=5)
+    """
+
+    def __init__(
+        self,
+        max_connections: int = 50,
+        timeout: Optional[int] = 20,
+        connection_class: Type[Connection] = Connection,
+        queue_class: Type[asyncio.Queue] = asyncio.LifoQueue,
+        **connection_kwargs,
+    ):
+
+        self.queue_class = queue_class
+        self.timeout = timeout
+        self._connections: List[Connection]
+        super().__init__(
+            connection_class=connection_class,
+            max_connections=max_connections,
+            **connection_kwargs,
+        )
+
+    def reset(self):
+        # Create and fill up a thread safe queue with ``None`` values.
+        self.pool = self.queue_class(self.max_connections)
+        while True:
+            try:
+                self.pool.put_nowait(None)
+            except asyncio.QueueFull:
+                break
+
+        # Keep a list of actual connection instances so that we can
+        # disconnect them later.
+        self._connections = []
+
+        # this must be the last operation in this method. while reset() is
+        # called when holding _fork_lock, other threads in this process
+        # can call _checkpid() which compares self.pid and os.getpid() without
+        # holding any lock (for performance reasons). keeping this assignment
+        # as the last operation ensures that those other threads will also
+        # notice a pid difference and block waiting for the first thread to
+        # release _fork_lock. when each of these threads eventually acquire
+        # _fork_lock, they will notice that another thread already called
+        # reset() and they will immediately release _fork_lock and continue on.
+        self.pid = os.getpid()
+
+    def make_connection(self):
+        """Make a fresh connection."""
+        connection = self.connection_class(**self.connection_kwargs)
+        self._connections.append(connection)
+        return connection
+
+    async def get_connection(self, command_name, *keys, **options):
+        """
+        Get a connection, blocking for ``self.timeout`` until a connection
+        is available from the pool.
+
+        If the connection returned is ``None`` then creates a new connection.
+        Because we use a last-in first-out queue, the existing connections
+        (having been returned to the pool after the initial ``None`` values
+        were added) will be returned before ``None`` values. This means we only
+        create new connections when we need to, i.e.: the actual number of
+        connections will only increase in response to demand.
+        """
+        # Make sure we haven't changed process.
+        self._checkpid()
+
+        # Try and get a connection from the pool. If one isn't available within
+        # self.timeout then raise a ``ConnectionError``.
+        connection = None
+        try:
+            async with async_timeout.timeout(self.timeout):
+                connection = await self.pool.get()
+        except (asyncio.QueueEmpty, asyncio.TimeoutError):
+            # Note that this is not caught by the redis client and will be
+            # raised unless handled by application code. If you want never to
+            raise ConnectionError("No connection available.")
+
+        # If the ``connection`` is actually ``None`` then that's a cue to make
+        # a new connection to add to the pool.
+        if connection is None:
+            connection = self.make_connection()
+
+        try:
+            # ensure this connection is connected to Redis
+            await connection.connect()
+            # connections that the pool provides should be ready to send
+            # a command. if not, the connection was either returned to the
+            # pool before all data has been read or the socket has been
+            # closed. either way, reconnect and verify everything is good.
+            try:
+                if await connection.can_read():
+                    raise ConnectionError("Connection has data") from None
+            except ConnectionError:
+                await connection.disconnect()
+                await connection.connect()
+                if await connection.can_read():
+                    raise ConnectionError("Connection not ready") from None
+        except BaseException:
+            # release the connection back to the pool so that we don't leak it
+            await self.release(connection)
+            raise
+
+        return connection
+
+    async def release(self, connection: Connection):
+        """Releases the connection back to the pool."""
+        # Make sure we haven't changed process.
+        self._checkpid()
+        if not self.owns_connection(connection):
+            # pool doesn't own this connection. do not add it back
+            # to the pool. instead add a None value which is a placeholder
+            # that will cause the pool to recreate the connection if
+            # its needed.
+            await connection.disconnect()
+            self.pool.put_nowait(None)
+            return
+
+        # Put the connection back into the pool.
+        try:
+            self.pool.put_nowait(connection)
+        except asyncio.QueueFull:
+            # perhaps the pool has been reset() after a fork? regardless,
+            # we don't want this connection
+            pass
+
+    async def disconnect(self, inuse_connections: bool = True):
+        """Disconnects all connections in the pool."""
+        self._checkpid()
+        async with self._lock:
+            resp = await asyncio.gather(
+                *(connection.disconnect() for connection in self._connections),
+                return_exceptions=True,
+            )
+            exc = next((r for r in resp if isinstance(r, BaseException)), None)
+            if exc:
+                raise exc
diff --git a/redis/asyncio/lock.py b/redis/asyncio/lock.py
new file mode 100644
index 0000000000..d4861329a0
--- /dev/null
+++ b/redis/asyncio/lock.py
@@ -0,0 +1,311 @@
+import asyncio
+import sys
+import threading
+import uuid
+from types import SimpleNamespace
+from typing import TYPE_CHECKING, Awaitable, NoReturn, Optional, Union
+
+from redis.exceptions import LockError, LockNotOwnedError
+
+if TYPE_CHECKING:
+    from redis.asyncio import Redis
+
+
+class Lock:
+    """
+    A shared, distributed Lock. Using Redis for locking allows the Lock
+    to be shared across processes and/or machines.
+
+    It's left to the user to resolve deadlock issues and make sure
+    multiple clients play nicely together.
+    """
+
+    lua_release = None
+    lua_extend = None
+    lua_reacquire = None
+
+    # KEYS[1] - lock name
+    # ARGV[1] - token
+    # return 1 if the lock was released, otherwise 0
+    LUA_RELEASE_SCRIPT = """
+        local token = redis.call('get', KEYS[1])
+        if not token or token ~= ARGV[1] then
+            return 0
+        end
+        redis.call('del', KEYS[1])
+        return 1
+    """
+
+    # KEYS[1] - lock name
+    # ARGV[1] - token
+    # ARGV[2] - additional milliseconds
+    # ARGV[3] - "0" if the additional time should be added to the lock's
+    #           existing ttl or "1" if the existing ttl should be replaced
+    # return 1 if the locks time was extended, otherwise 0
+    LUA_EXTEND_SCRIPT = """
+        local token = redis.call('get', KEYS[1])
+        if not token or token ~= ARGV[1] then
+            return 0
+        end
+        local expiration = redis.call('pttl', KEYS[1])
+        if not expiration then
+            expiration = 0
+        end
+        if expiration < 0 then
+            return 0
+        end
+
+        local newttl = ARGV[2]
+        if ARGV[3] == "0" then
+            newttl = ARGV[2] + expiration
+        end
+        redis.call('pexpire', KEYS[1], newttl)
+        return 1
+    """
+
+    # KEYS[1] - lock name
+    # ARGV[1] - token
+    # ARGV[2] - milliseconds
+    # return 1 if the locks time was reacquired, otherwise 0
+    LUA_REACQUIRE_SCRIPT = """
+        local token = redis.call('get', KEYS[1])
+        if not token or token ~= ARGV[1] then
+            return 0
+        end
+        redis.call('pexpire', KEYS[1], ARGV[2])
+        return 1
+    """
+
+    def __init__(
+        self,
+        redis: "Redis",
+        name: Union[str, bytes, memoryview],
+        timeout: Optional[float] = None,
+        sleep: float = 0.1,
+        blocking: bool = True,
+        blocking_timeout: Optional[float] = None,
+        thread_local: bool = True,
+    ):
+        """
+        Create a new Lock instance named ``name`` using the Redis client
+        supplied by ``redis``.
+
+        ``timeout`` indicates a maximum life for the lock in seconds.
+        By default, it will remain locked until release() is called.
+        ``timeout`` can be specified as a float or integer, both representing
+        the number of seconds to wait.
+
+        ``sleep`` indicates the amount of time to sleep in seconds per loop
+        iteration when the lock is in blocking mode and another client is
+        currently holding the lock.
+
+        ``blocking`` indicates whether calling ``acquire`` should block until
+        the lock has been acquired or to fail immediately, causing ``acquire``
+        to return False and the lock not being acquired. Defaults to True.
+        Note this value can be overridden by passing a ``blocking``
+        argument to ``acquire``.
+
+        ``blocking_timeout`` indicates the maximum amount of time in seconds to
+        spend trying to acquire the lock. A value of ``None`` indicates
+        continue trying forever. ``blocking_timeout`` can be specified as a
+        float or integer, both representing the number of seconds to wait.
+
+        ``thread_local`` indicates whether the lock token is placed in
+        thread-local storage. By default, the token is placed in thread local
+        storage so that a thread only sees its token, not a token set by
+        another thread. Consider the following timeline:
+
+            time: 0, thread-1 acquires `my-lock`, with a timeout of 5 seconds.
+                     thread-1 sets the token to "abc"
+            time: 1, thread-2 blocks trying to acquire `my-lock` using the
+                     Lock instance.
+            time: 5, thread-1 has not yet completed. redis expires the lock
+                     key.
+            time: 5, thread-2 acquired `my-lock` now that it's available.
+                     thread-2 sets the token to "xyz"
+            time: 6, thread-1 finishes its work and calls release(). if the
+                     token is *not* stored in thread local storage, then
+                     thread-1 would see the token value as "xyz" and would be
+                     able to successfully release the thread-2's lock.
+
+        In some use cases it's necessary to disable thread local storage. For
+        example, if you have code where one thread acquires a lock and passes
+        that lock instance to a worker thread to release later. If thread
+        local storage isn't disabled in this case, the worker thread won't see
+        the token set by the thread that acquired the lock. Our assumption
+        is that these cases aren't common and as such default to using
+        thread local storage.
+        """
+        self.redis = redis
+        self.name = name
+        self.timeout = timeout
+        self.sleep = sleep
+        self.blocking = blocking
+        self.blocking_timeout = blocking_timeout
+        self.thread_local = bool(thread_local)
+        self.local = threading.local() if self.thread_local else SimpleNamespace()
+        self.local.token = None
+        self.register_scripts()
+
+    def register_scripts(self):
+        cls = self.__class__
+        client = self.redis
+        if cls.lua_release is None:
+            cls.lua_release = client.register_script(cls.LUA_RELEASE_SCRIPT)
+        if cls.lua_extend is None:
+            cls.lua_extend = client.register_script(cls.LUA_EXTEND_SCRIPT)
+        if cls.lua_reacquire is None:
+            cls.lua_reacquire = client.register_script(cls.LUA_REACQUIRE_SCRIPT)
+
+    async def __aenter__(self):
+        if await self.acquire():
+            return self
+        raise LockError("Unable to acquire lock within the time specified")
+
+    async def __aexit__(self, exc_type, exc_value, traceback):
+        await self.release()
+
+    async def acquire(
+        self,
+        blocking: Optional[bool] = None,
+        blocking_timeout: Optional[float] = None,
+        token: Optional[Union[str, bytes]] = None,
+    ):
+        """
+        Use Redis to hold a shared, distributed lock named ``name``.
+        Returns True once the lock is acquired.
+
+        If ``blocking`` is False, always return immediately. If the lock
+        was acquired, return True, otherwise return False.
+
+        ``blocking_timeout`` specifies the maximum number of seconds to
+        wait trying to acquire the lock.
+
+        ``token`` specifies the token value to be used. If provided, token
+        must be a bytes object or a string that can be encoded to a bytes
+        object with the default encoding. If a token isn't specified, a UUID
+        will be generated.
+        """
+        if sys.version_info[0:2] != (3, 6):
+            loop = asyncio.get_running_loop()
+        else:
+            loop = asyncio.get_event_loop()
+
+        sleep = self.sleep
+        if token is None:
+            token = uuid.uuid1().hex.encode()
+        else:
+            encoder = self.redis.connection_pool.get_encoder()
+            token = encoder.encode(token)
+        if blocking is None:
+            blocking = self.blocking
+        if blocking_timeout is None:
+            blocking_timeout = self.blocking_timeout
+        stop_trying_at = None
+        if blocking_timeout is not None:
+            stop_trying_at = loop.time() + blocking_timeout
+        while True:
+            if await self.do_acquire(token):
+                self.local.token = token
+                return True
+            if not blocking:
+                return False
+            next_try_at = loop.time() + sleep
+            if stop_trying_at is not None and next_try_at > stop_trying_at:
+                return False
+            await asyncio.sleep(sleep)
+
+    async def do_acquire(self, token: Union[str, bytes]) -> bool:
+        if self.timeout:
+            # convert to milliseconds
+            timeout = int(self.timeout * 1000)
+        else:
+            timeout = None
+        if await self.redis.set(self.name, token, nx=True, px=timeout):
+            return True
+        return False
+
+    async def locked(self) -> bool:
+        """
+        Returns True if this key is locked by any process, otherwise False.
+        """
+        return await self.redis.get(self.name) is not None
+
+    async def owned(self) -> bool:
+        """
+        Returns True if this key is locked by this lock, otherwise False.
+        """
+        stored_token = await self.redis.get(self.name)
+        # need to always compare bytes to bytes
+        # TODO: this can be simplified when the context manager is finished
+        if stored_token and not isinstance(stored_token, bytes):
+            encoder = self.redis.connection_pool.get_encoder()
+            stored_token = encoder.encode(stored_token)
+        return self.local.token is not None and stored_token == self.local.token
+
+    def release(self) -> Awaitable[NoReturn]:
+        """Releases the already acquired lock"""
+        expected_token = self.local.token
+        if expected_token is None:
+            raise LockError("Cannot release an unlocked lock")
+        self.local.token = None
+        return self.do_release(expected_token)
+
+    async def do_release(self, expected_token: bytes):
+        if not bool(
+            await self.lua_release(
+                keys=[self.name], args=[expected_token], client=self.redis
+            )
+        ):
+            raise LockNotOwnedError("Cannot release a lock" " that's no longer owned")
+
+    def extend(
+        self, additional_time: float, replace_ttl: bool = False
+    ) -> Awaitable[bool]:
+        """
+        Adds more time to an already acquired lock.
+
+        ``additional_time`` can be specified as an integer or a float, both
+        representing the number of seconds to add.
+
+        ``replace_ttl`` if False (the default), add `additional_time` to
+        the lock's existing ttl. If True, replace the lock's ttl with
+        `additional_time`.
+        """
+        if self.local.token is None:
+            raise LockError("Cannot extend an unlocked lock")
+        if self.timeout is None:
+            raise LockError("Cannot extend a lock with no timeout")
+        return self.do_extend(additional_time, replace_ttl)
+
+    async def do_extend(self, additional_time, replace_ttl) -> bool:
+        additional_time = int(additional_time * 1000)
+        if not bool(
+            await self.lua_extend(
+                keys=[self.name],
+                args=[self.local.token, additional_time, replace_ttl and "1" or "0"],
+                client=self.redis,
+            )
+        ):
+            raise LockNotOwnedError("Cannot extend a lock that's" " no longer owned")
+        return True
+
+    def reacquire(self) -> Awaitable[bool]:
+        """
+        Resets a TTL of an already acquired lock back to a timeout value.
+        """
+        if self.local.token is None:
+            raise LockError("Cannot reacquire an unlocked lock")
+        if self.timeout is None:
+            raise LockError("Cannot reacquire a lock with no timeout")
+        return self.do_reacquire()
+
+    async def do_reacquire(self) -> bool:
+        timeout = int(self.timeout * 1000)
+        if not bool(
+            await self.lua_reacquire(
+                keys=[self.name], args=[self.local.token, timeout], client=self.redis
+            )
+        ):
+            raise LockNotOwnedError("Cannot reacquire a lock that's" " no longer owned")
+        return True
diff --git a/redis/asyncio/retry.py b/redis/asyncio/retry.py
new file mode 100644
index 0000000000..9b5349402c
--- /dev/null
+++ b/redis/asyncio/retry.py
@@ -0,0 +1,58 @@
+from asyncio import sleep
+from typing import TYPE_CHECKING, Any, Awaitable, Callable, Tuple, TypeVar
+
+from redis.exceptions import ConnectionError, RedisError, TimeoutError
+
+if TYPE_CHECKING:
+    from redis.backoff import AbstractBackoff
+
+
+T = TypeVar("T")
+
+
+class Retry:
+    """Retry a specific number of times after a failure"""
+
+    __slots__ = "_backoff", "_retries", "_supported_errors"
+
+    def __init__(
+        self,
+        backoff: "AbstractBackoff",
+        retries: int,
+        supported_errors: Tuple[RedisError, ...] = (
+            ConnectionError,
+            TimeoutError,
+        ),
+    ):
+        """
+        Initialize a `Retry` object with a `Backoff` object
+        that retries a maximum of `retries` times.
+        You can specify the types of supported errors which trigger
+        a retry with the `supported_errors` parameter.
+        """
+        self._backoff = backoff
+        self._retries = retries
+        self._supported_errors = supported_errors
+
+    async def call_with_retry(
+        self, do: Callable[[], Awaitable[T]], fail: Callable[[RedisError], Any]
+    ) -> T:
+        """
+        Execute an operation that might fail and returns its result, or
+        raise the exception that was thrown depending on the `Backoff` object.
+        `do`: the operation to call. Expects no argument.
+        `fail`: the failure handler, expects the last error that was thrown
+        """
+        self._backoff.reset()
+        failures = 0
+        while True:
+            try:
+                return await do()
+            except self._supported_errors as error:
+                failures += 1
+                await fail(error)
+                if failures > self._retries:
+                    raise error
+                backoff = self._backoff.compute(failures)
+                if backoff > 0:
+                    await sleep(backoff)
diff --git a/redis/asyncio/sentinel.py b/redis/asyncio/sentinel.py
new file mode 100644
index 0000000000..5aefd09ebd
--- /dev/null
+++ b/redis/asyncio/sentinel.py
@@ -0,0 +1,353 @@
+import asyncio
+import random
+import weakref
+from typing import AsyncIterator, Iterable, Mapping, Sequence, Tuple, Type
+
+from redis.asyncio.client import Redis
+from redis.asyncio.connection import (
+    Connection,
+    ConnectionPool,
+    EncodableT,
+    SSLConnection,
+)
+from redis.commands import AsyncSentinelCommands
+from redis.exceptions import ConnectionError, ReadOnlyError, ResponseError, TimeoutError
+from redis.utils import str_if_bytes
+
+
+class MasterNotFoundError(ConnectionError):
+    pass
+
+
+class SlaveNotFoundError(ConnectionError):
+    pass
+
+
+class SentinelManagedConnection(Connection):
+    def __init__(self, **kwargs):
+        self.connection_pool = kwargs.pop("connection_pool")
+        super().__init__(**kwargs)
+
+    def __repr__(self):
+        pool = self.connection_pool
+        s = f"{self.__class__.__name__}<service={pool.service_name}"
+        if self.host:
+            host_info = f",host={self.host},port={self.port}"
+            s += host_info
+        return s + ">"
+
+    async def connect_to(self, address):
+        self.host, self.port = address
+        await super().connect()
+        if self.connection_pool.check_connection:
+            await self.send_command("PING")
+            if str_if_bytes(await self.read_response()) != "PONG":
+                raise ConnectionError("PING failed")
+
+    async def connect(self):
+        if self._reader:
+            return  # already connected
+        if self.connection_pool.is_master:
+            await self.connect_to(await self.connection_pool.get_master_address())
+        else:
+            async for slave in self.connection_pool.rotate_slaves():
+                try:
+                    return await self.connect_to(slave)
+                except ConnectionError:
+                    continue
+            raise SlaveNotFoundError  # Never be here
+
+    async def read_response(self, disable_decoding: bool = False):
+        try:
+            return await super().read_response(disable_decoding=disable_decoding)
+        except ReadOnlyError:
+            if self.connection_pool.is_master:
+                # When talking to a master, a ReadOnlyError when likely
+                # indicates that the previous master that we're still connected
+                # to has been demoted to a slave and there's a new master.
+                # calling disconnect will force the connection to re-query
+                # sentinel during the next connect() attempt.
+                await self.disconnect()
+                raise ConnectionError("The previous master is now a slave")
+            raise
+
+
+class SentinelManagedSSLConnection(SentinelManagedConnection, SSLConnection):
+    pass
+
+
+class SentinelConnectionPool(ConnectionPool):
+    """
+    Sentinel backed connection pool.
+
+    If ``check_connection`` flag is set to True, SentinelManagedConnection
+    sends a PING command right after establishing the connection.
+    """
+
+    def __init__(self, service_name, sentinel_manager, **kwargs):
+        kwargs["connection_class"] = kwargs.get(
+            "connection_class",
+            SentinelManagedSSLConnection
+            if kwargs.pop("ssl", False)
+            else SentinelManagedConnection,
+        )
+        self.is_master = kwargs.pop("is_master", True)
+        self.check_connection = kwargs.pop("check_connection", False)
+        super().__init__(**kwargs)
+        self.connection_kwargs["connection_pool"] = weakref.proxy(self)
+        self.service_name = service_name
+        self.sentinel_manager = sentinel_manager
+        self.master_address = None
+        self.slave_rr_counter = None
+
+    def __repr__(self):
+        return (
+            f"{self.__class__.__name__}"
+            f"<service={self.service_name}({self.is_master and 'master' or 'slave'})>"
+        )
+
+    def reset(self):
+        super().reset()
+        self.master_address = None
+        self.slave_rr_counter = None
+
+    def owns_connection(self, connection: Connection):
+        check = not self.is_master or (
+            self.is_master and self.master_address == (connection.host, connection.port)
+        )
+        return check and super().owns_connection(connection)
+
+    async def get_master_address(self):
+        master_address = await self.sentinel_manager.discover_master(self.service_name)
+        if self.is_master:
+            if self.master_address != master_address:
+                self.master_address = master_address
+                # disconnect any idle connections so that they reconnect
+                # to the new master the next time that they are used.
+                await self.disconnect(inuse_connections=False)
+        return master_address
+
+    async def rotate_slaves(self) -> AsyncIterator:
+        """Round-robin slave balancer"""
+        slaves = await self.sentinel_manager.discover_slaves(self.service_name)
+        if slaves:
+            if self.slave_rr_counter is None:
+                self.slave_rr_counter = random.randint(0, len(slaves) - 1)
+            for _ in range(len(slaves)):
+                self.slave_rr_counter = (self.slave_rr_counter + 1) % len(slaves)
+                slave = slaves[self.slave_rr_counter]
+                yield slave
+        # Fallback to the master connection
+        try:
+            yield await self.get_master_address()
+        except MasterNotFoundError:
+            pass
+        raise SlaveNotFoundError(f"No slave found for {self.service_name!r}")
+
+
+class Sentinel(AsyncSentinelCommands):
+    """
+    Redis Sentinel cluster client
+
+    >>> from redis.sentinel import Sentinel
+    >>> sentinel = Sentinel([('localhost', 26379)], socket_timeout=0.1)
+    >>> master = sentinel.master_for('mymaster', socket_timeout=0.1)
+    >>> await master.set('foo', 'bar')
+    >>> slave = sentinel.slave_for('mymaster', socket_timeout=0.1)
+    >>> await slave.get('foo')
+    b'bar'
+
+    ``sentinels`` is a list of sentinel nodes. Each node is represented by
+    a pair (hostname, port).
+
+    ``min_other_sentinels`` defined a minimum number of peers for a sentinel.
+    When querying a sentinel, if it doesn't meet this threshold, responses
+    from that sentinel won't be considered valid.
+
+    ``sentinel_kwargs`` is a dictionary of connection arguments used when
+    connecting to sentinel instances. Any argument that can be passed to
+    a normal Redis connection can be specified here. If ``sentinel_kwargs`` is
+    not specified, any socket_timeout and socket_keepalive options specified
+    in ``connection_kwargs`` will be used.
+
+    ``connection_kwargs`` are keyword arguments that will be used when
+    establishing a connection to a Redis server.
+    """
+
+    def __init__(
+        self,
+        sentinels,
+        min_other_sentinels=0,
+        sentinel_kwargs=None,
+        **connection_kwargs,
+    ):
+        # if sentinel_kwargs isn't defined, use the socket_* options from
+        # connection_kwargs
+        if sentinel_kwargs is None:
+            sentinel_kwargs = {
+                k: v for k, v in connection_kwargs.items() if k.startswith("socket_")
+            }
+        self.sentinel_kwargs = sentinel_kwargs
+
+        self.sentinels = [
+            Redis(host=hostname, port=port, **self.sentinel_kwargs)
+            for hostname, port in sentinels
+        ]
+        self.min_other_sentinels = min_other_sentinels
+        self.connection_kwargs = connection_kwargs
+
+    async def execute_command(self, *args, **kwargs):
+        """
+        Execute Sentinel command in sentinel nodes.
+        once - If set to True, then execute the resulting command on a single
+               node at random, rather than across the entire sentinel cluster.
+        """
+        once = bool(kwargs.get("once", False))
+        if "once" in kwargs.keys():
+            kwargs.pop("once")
+
+        if once:
+            tasks = [
+                asyncio.Task(sentinel.execute_command(*args, **kwargs))
+                for sentinel in self.sentinels
+            ]
+            await asyncio.gather(*tasks)
+        else:
+            await random.choice(self.sentinels).execute_command(*args, **kwargs)
+        return True
+
+    def __repr__(self):
+        sentinel_addresses = []
+        for sentinel in self.sentinels:
+            sentinel_addresses.append(
+                f"{sentinel.connection_pool.connection_kwargs['host']}:"
+                f"{sentinel.connection_pool.connection_kwargs['port']}"
+            )
+        return f"{self.__class__.__name__}<sentinels=[{','.join(sentinel_addresses)}]>"
+
+    def check_master_state(self, state: dict, service_name: str) -> bool:
+        if not state["is_master"] or state["is_sdown"] or state["is_odown"]:
+            return False
+        # Check if our sentinel doesn't see other nodes
+        if state["num-other-sentinels"] < self.min_other_sentinels:
+            return False
+        return True
+
+    async def discover_master(self, service_name: str):
+        """
+        Asks sentinel servers for the Redis master's address corresponding
+        to the service labeled ``service_name``.
+
+        Returns a pair (address, port) or raises MasterNotFoundError if no
+        master is found.
+        """
+        for sentinel_no, sentinel in enumerate(self.sentinels):
+            try:
+                masters = await sentinel.sentinel_masters()
+            except (ConnectionError, TimeoutError):
+                continue
+            state = masters.get(service_name)
+            if state and self.check_master_state(state, service_name):
+                # Put this sentinel at the top of the list
+                self.sentinels[0], self.sentinels[sentinel_no] = (
+                    sentinel,
+                    self.sentinels[0],
+                )
+                return state["ip"], state["port"]
+        raise MasterNotFoundError(f"No master found for {service_name!r}")
+
+    def filter_slaves(
+        self, slaves: Iterable[Mapping]
+    ) -> Sequence[Tuple[EncodableT, EncodableT]]:
+        """Remove slaves that are in an ODOWN or SDOWN state"""
+        slaves_alive = []
+        for slave in slaves:
+            if slave["is_odown"] or slave["is_sdown"]:
+                continue
+            slaves_alive.append((slave["ip"], slave["port"]))
+        return slaves_alive
+
+    async def discover_slaves(
+        self, service_name: str
+    ) -> Sequence[Tuple[EncodableT, EncodableT]]:
+        """Returns a list of alive slaves for service ``service_name``"""
+        for sentinel in self.sentinels:
+            try:
+                slaves = await sentinel.sentinel_slaves(service_name)
+            except (ConnectionError, ResponseError, TimeoutError):
+                continue
+            slaves = self.filter_slaves(slaves)
+            if slaves:
+                return slaves
+        return []
+
+    def master_for(
+        self,
+        service_name: str,
+        redis_class: Type[Redis] = Redis,
+        connection_pool_class: Type[SentinelConnectionPool] = SentinelConnectionPool,
+        **kwargs,
+    ):
+        """
+        Returns a redis client instance for the ``service_name`` master.
+
+        A :py:class:`~redis.sentinel.SentinelConnectionPool` class is
+        used to retrieve the master's address before establishing a new
+        connection.
+
+        NOTE: If the master's address has changed, any cached connections to
+        the old master are closed.
+
+        By default clients will be a :py:class:`~redis.Redis` instance.
+        Specify a different class to the ``redis_class`` argument if you
+        desire something different.
+
+        The ``connection_pool_class`` specifies the connection pool to
+        use.  The :py:class:`~redis.sentinel.SentinelConnectionPool`
+        will be used by default.
+
+        All other keyword arguments are merged with any connection_kwargs
+        passed to this class and passed to the connection pool as keyword
+        arguments to be used to initialize Redis connections.
+        """
+        kwargs["is_master"] = True
+        connection_kwargs = dict(self.connection_kwargs)
+        connection_kwargs.update(kwargs)
+        return redis_class(
+            connection_pool=connection_pool_class(
+                service_name, self, **connection_kwargs
+            )
+        )
+
+    def slave_for(
+        self,
+        service_name: str,
+        redis_class: Type[Redis] = Redis,
+        connection_pool_class: Type[SentinelConnectionPool] = SentinelConnectionPool,
+        **kwargs,
+    ):
+        """
+        Returns redis client instance for the ``service_name`` slave(s).
+
+        A SentinelConnectionPool class is used to retrieve the slave's
+        address before establishing a new connection.
+
+        By default clients will be a :py:class:`~redis.Redis` instance.
+        Specify a different class to the ``redis_class`` argument if you
+        desire something different.
+
+        The ``connection_pool_class`` specifies the connection pool to use.
+        The SentinelConnectionPool will be used by default.
+
+        All other keyword arguments are merged with any connection_kwargs
+        passed to this class and passed to the connection pool as keyword
+        arguments to be used to initialize Redis connections.
+        """
+        kwargs["is_master"] = False
+        connection_kwargs = dict(self.connection_kwargs)
+        connection_kwargs.update(kwargs)
+        return redis_class(
+            connection_pool=connection_pool_class(
+                service_name, self, **connection_kwargs
+            )
+        )
diff --git a/redis/asyncio/utils.py b/redis/asyncio/utils.py
new file mode 100644
index 0000000000..5a55b36a33
--- /dev/null
+++ b/redis/asyncio/utils.py
@@ -0,0 +1,28 @@
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from redis.asyncio.client import Pipeline, Redis
+
+
+def from_url(url, **kwargs):
+    """
+    Returns an active Redis client generated from the given database URL.
+
+    Will attempt to extract the database id from the path url fragment, if
+    none is provided.
+    """
+    from redis.asyncio.client import Redis
+
+    return Redis.from_url(url, **kwargs)
+
+
+class pipeline:
+    def __init__(self, redis_obj: "Redis"):
+        self.p: "Pipeline" = redis_obj.pipeline()
+
+    async def __aenter__(self) -> "Pipeline":
+        return self.p
+
+    async def __aexit__(self, exc_type, exc_value, traceback):
+        await self.p.execute()
+        del self.p
diff --git a/redis/client.py b/redis/client.py
index 1317cb6ffc..22c5dc1e57 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -642,19 +642,7 @@ def parse_set_result(response, **options):
     return response and str_if_bytes(response) == "OK"
 
 
-class Redis(RedisModuleCommands, CoreCommands, SentinelCommands):
-    """
-    Implementation of the Redis protocol.
-
-    This abstract class provides a Python interface to all Redis commands
-    and an implementation of the Redis protocol.
-
-    Pipelines derive from this, implementing how
-    the commands are sent and received to the Redis server. Based on
-    configuration, an instance will either use a ConnectionPool, or
-    Connection object to talk to redis.
-    """
-
+class AbstractRedis:
     RESPONSE_CALLBACKS = {
         **string_keys_to_dict(
             "AUTH COPY EXPIRE EXPIREAT PEXPIRE PEXPIREAT "
@@ -807,6 +795,20 @@ class Redis(RedisModuleCommands, CoreCommands, SentinelCommands):
         "ZMSCORE": parse_zmscore,
     }
 
+
+class Redis(AbstractRedis, RedisModuleCommands, CoreCommands, SentinelCommands):
+    """
+    Implementation of the Redis protocol.
+
+    This abstract class provides a Python interface to all Redis commands
+    and an implementation of the Redis protocol.
+
+    Pipelines derive from this, implementing how
+    the commands are sent and received to the Redis server. Based on
+    configuration, an instance will either use a ConnectionPool, or
+    Connection object to talk to redis.
+    """
+
     @classmethod
     def from_url(cls, url, **kwargs):
         """
diff --git a/redis/commands/__init__.py b/redis/commands/__init__.py
index 07fa7f1431..b9dd0b7210 100644
--- a/redis/commands/__init__.py
+++ b/redis/commands/__init__.py
@@ -1,15 +1,17 @@
 from .cluster import RedisClusterCommands
-from .core import CoreCommands
+from .core import AsyncCoreCommands, CoreCommands
 from .helpers import list_or_args
 from .parser import CommandsParser
 from .redismodules import RedisModuleCommands
-from .sentinel import SentinelCommands
+from .sentinel import AsyncSentinelCommands, SentinelCommands
 
 __all__ = [
     "RedisClusterCommands",
     "CommandsParser",
+    "AsyncCoreCommands",
     "CoreCommands",
     "list_or_args",
     "RedisModuleCommands",
+    "AsyncSentinelCommands",
     "SentinelCommands",
 ]
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 1e221c9402..80bc55ff22 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1,21 +1,64 @@
+# from __future__ import annotations
+
 import datetime
 import hashlib
 import time
 import warnings
-from typing import List, Optional, Union
-
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncIterator,
+    Awaitable,
+    Callable,
+    Dict,
+    Iterable,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Sequence,
+    Tuple,
+    Union,
+)
+
+from redis.compat import Literal
 from redis.exceptions import ConnectionError, DataError, NoScriptError, RedisError
+from redis.typing import (
+    AbsExpiryT,
+    AnyKeyT,
+    BitfieldOffsetT,
+    ChannelT,
+    CommandsProtocol,
+    ConsumerT,
+    EncodableT,
+    ExpiryT,
+    FieldT,
+    GroupT,
+    KeysT,
+    KeyT,
+    PatternT,
+    ScriptTextT,
+    StreamIdT,
+    TimeoutSecT,
+    ZScoreBoundT,
+)
 
 from .helpers import list_or_args
 
+if TYPE_CHECKING:
+    from redis.asyncio.client import Redis as AsyncRedis
+    from redis.client import Redis
+
+ResponseT = Union[Awaitable, Any]
+
 
-class ACLCommands:
+class ACLCommands(CommandsProtocol):
     """
     Redis Access Control List (ACL) commands.
     see: https://redis.io/topics/acl
     """
 
-    def acl_cat(self, category=None, **kwargs):
+    def acl_cat(self, category: Union[str, None] = None, **kwargs) -> ResponseT:
         """
         Returns a list of categories or commands within a category.
 
@@ -25,7 +68,7 @@ def acl_cat(self, category=None, **kwargs):
 
         For more information check https://redis.io/commands/acl-cat
         """
-        pieces = [category] if category else []
+        pieces: list[EncodableT] = [category] if category else []
         return self.execute_command("ACL CAT", *pieces, **kwargs)
 
     def acl_dryrun(self, username, *args, **kwargs):
@@ -36,7 +79,7 @@ def acl_dryrun(self, username, *args, **kwargs):
         """
         return self.execute_command("ACL DRYRUN", username, *args, **kwargs)
 
-    def acl_deluser(self, *username, **kwargs):
+    def acl_deluser(self, *username: str, **kwargs) -> ResponseT:
         """
         Delete the ACL for the specified ``username``s
 
@@ -44,7 +87,7 @@ def acl_deluser(self, *username, **kwargs):
         """
         return self.execute_command("ACL DELUSER", *username, **kwargs)
 
-    def acl_genpass(self, bits=None, **kwargs):
+    def acl_genpass(self, bits: Union[int, None] = None, **kwargs) -> ResponseT:
         """Generate a random password value.
         If ``bits`` is supplied then use this number of bits, rounded to
         the next multiple of 4.
@@ -62,7 +105,7 @@ def acl_genpass(self, bits=None, **kwargs):
                 )
         return self.execute_command("ACL GENPASS", *pieces, **kwargs)
 
-    def acl_getuser(self, username, **kwargs):
+    def acl_getuser(self, username: str, **kwargs) -> ResponseT:
         """
         Get the ACL details for the specified ``username``.
 
@@ -72,7 +115,7 @@ def acl_getuser(self, username, **kwargs):
         """
         return self.execute_command("ACL GETUSER", username, **kwargs)
 
-    def acl_help(self, **kwargs):
+    def acl_help(self, **kwargs) -> ResponseT:
         """The ACL HELP command returns helpful text describing
         the different subcommands.
 
@@ -80,7 +123,7 @@ def acl_help(self, **kwargs):
         """
         return self.execute_command("ACL HELP", **kwargs)
 
-    def acl_list(self, **kwargs):
+    def acl_list(self, **kwargs) -> ResponseT:
         """
         Return a list of all ACLs on the server
 
@@ -88,7 +131,7 @@ def acl_list(self, **kwargs):
         """
         return self.execute_command("ACL LIST", **kwargs)
 
-    def acl_log(self, count=None, **kwargs):
+    def acl_log(self, count: Union[int, None] = None, **kwargs) -> ResponseT:
         """
         Get ACL logs as a list.
         :param int count: Get logs[0:count].
@@ -104,7 +147,7 @@ def acl_log(self, count=None, **kwargs):
 
         return self.execute_command("ACL LOG", *args, **kwargs)
 
-    def acl_log_reset(self, **kwargs):
+    def acl_log_reset(self, **kwargs) -> ResponseT:
         """
         Reset ACL logs.
         :rtype: Boolean.
@@ -114,7 +157,7 @@ def acl_log_reset(self, **kwargs):
         args = [b"RESET"]
         return self.execute_command("ACL LOG", *args, **kwargs)
 
-    def acl_load(self, **kwargs):
+    def acl_load(self, **kwargs) -> ResponseT:
         """
         Load ACL rules from the configured ``aclfile``.
 
@@ -125,7 +168,7 @@ def acl_load(self, **kwargs):
         """
         return self.execute_command("ACL LOAD", **kwargs)
 
-    def acl_save(self, **kwargs):
+    def acl_save(self, **kwargs) -> ResponseT:
         """
         Save ACL rules to the configured ``aclfile``.
 
@@ -138,19 +181,19 @@ def acl_save(self, **kwargs):
 
     def acl_setuser(
         self,
-        username,
-        enabled=False,
-        nopass=False,
-        passwords=None,
-        hashed_passwords=None,
-        categories=None,
-        commands=None,
-        keys=None,
-        reset=False,
-        reset_keys=False,
-        reset_passwords=False,
+        username: str,
+        enabled: bool = False,
+        nopass: bool = False,
+        passwords: Union[str, Iterable[str], None] = None,
+        hashed_passwords: Union[str, Iterable[str], None] = None,
+        categories: Union[Iterable[str], None] = None,
+        commands: Union[Iterable[str], None] = None,
+        keys: Union[Iterable[KeyT], None] = None,
+        reset: bool = False,
+        reset_keys: bool = False,
+        reset_passwords: bool = False,
         **kwargs,
-    ):
+    ) -> ResponseT:
         """
         Create or update an ACL user.
 
@@ -213,7 +256,7 @@ def acl_setuser(
         For more information check https://redis.io/commands/acl-setuser
         """
         encoder = self.get_encoder()
-        pieces = [username]
+        pieces: list[str | bytes] = [username]
 
         if reset:
             pieces.append(b"reset")
@@ -303,14 +346,14 @@ def acl_setuser(
 
         return self.execute_command("ACL SETUSER", *pieces, **kwargs)
 
-    def acl_users(self, **kwargs):
+    def acl_users(self, **kwargs) -> ResponseT:
         """Returns a list of all registered users on the server.
 
         For more information check https://redis.io/commands/acl-users
         """
         return self.execute_command("ACL USERS", **kwargs)
 
-    def acl_whoami(self, **kwargs):
+    def acl_whoami(self, **kwargs) -> ResponseT:
         """Get the username for the current connection
 
         For more information check https://redis.io/commands/acl-whoami
@@ -318,7 +361,10 @@ def acl_whoami(self, **kwargs):
         return self.execute_command("ACL WHOAMI", **kwargs)
 
 
-class ManagementCommands:
+AsyncACLCommands = ACLCommands
+
+
+class ManagementCommands(CommandsProtocol):
     """
     Redis management commands
     """
@@ -339,7 +385,7 @@ def bgrewriteaof(self, **kwargs):
         """
         return self.execute_command("BGREWRITEAOF", **kwargs)
 
-    def bgsave(self, schedule=True, **kwargs):
+    def bgsave(self, schedule: bool = True, **kwargs) -> ResponseT:
         """
         Tell the Redis server to save its data to disk.  Unlike save(),
         this method is asynchronous and returns immediately.
@@ -351,7 +397,7 @@ def bgsave(self, schedule=True, **kwargs):
             pieces.append("SCHEDULE")
         return self.execute_command("BGSAVE", *pieces, **kwargs)
 
-    def role(self):
+    def role(self) -> ResponseT:
         """
         Provide information on the role of a Redis instance in
         the context of replication, by returning if the instance
@@ -361,7 +407,7 @@ def role(self):
         """
         return self.execute_command("ROLE")
 
-    def client_kill(self, address, **kwargs):
+    def client_kill(self, address: str, **kwargs) -> ResponseT:
         """Disconnects the client at ``address`` (ip:port)
 
         For more information check https://redis.io/commands/client-kill
@@ -370,18 +416,18 @@ def client_kill(self, address, **kwargs):
 
     def client_kill_filter(
         self,
-        _id=None,
-        _type=None,
-        addr=None,
-        skipme=None,
-        laddr=None,
-        user=None,
+        _id: Union[str, None] = None,
+        _type: Union[str, None] = None,
+        addr: Union[str, None] = None,
+        skipme: Union[bool, None] = None,
+        laddr: Union[bool, None] = None,
+        user: str = None,
         **kwargs,
-    ):
+    ) -> ResponseT:
         """
         Disconnects client(s) using a variety of filter options
-        :param id: Kills a client by its unique ID field
-        :param type: Kills a client by type where type is one of 'normal',
+        :param _id: Kills a client by its unique ID field
+        :param _type: Kills a client by type where type is one of 'normal',
         'master', 'slave' or 'pubsub'
         :param addr: Kills a client by its 'address:port'
         :param skipme: If True, then the client calling the command
@@ -418,7 +464,7 @@ def client_kill_filter(
             )
         return self.execute_command("CLIENT KILL", *args, **kwargs)
 
-    def client_info(self, **kwargs):
+    def client_info(self, **kwargs) -> ResponseT:
         """
         Returns information and statistics about the current
         client connection.
@@ -427,7 +473,12 @@ def client_info(self, **kwargs):
         """
         return self.execute_command("CLIENT INFO", **kwargs)
 
-    def client_list(self, _type=None, client_id=[], **kwargs):
+    def client_list(
+        self,
+        _type: Union[str, None] = None,
+        client_id: List[EncodableT] = [],
+        **kwargs,
+    ) -> ResponseT:
         """
         Returns a list of currently connected clients.
         If type of client specified, only that type will be returned.
@@ -446,12 +497,12 @@ def client_list(self, _type=None, client_id=[], **kwargs):
             args.append(_type)
         if not isinstance(client_id, list):
             raise DataError("client_id must be a list")
-        if client_id != []:
+        if client_id:
             args.append(b"ID")
             args.append(" ".join(client_id))
         return self.execute_command("CLIENT LIST", *args, **kwargs)
 
-    def client_getname(self, **kwargs):
+    def client_getname(self, **kwargs) -> ResponseT:
         """
         Returns the current connection name
 
@@ -459,7 +510,7 @@ def client_getname(self, **kwargs):
         """
         return self.execute_command("CLIENT GETNAME", **kwargs)
 
-    def client_getredir(self, **kwargs):
+    def client_getredir(self, **kwargs) -> ResponseT:
         """
         Returns the ID (an integer) of the client to whom we are
         redirecting tracking notifications.
@@ -468,7 +519,11 @@ def client_getredir(self, **kwargs):
         """
         return self.execute_command("CLIENT GETREDIR", **kwargs)
 
-    def client_reply(self, reply, **kwargs):
+    def client_reply(
+        self,
+        reply: Union[Literal["ON"], Literal["OFF"], Literal["SKIP"]],
+        **kwargs,
+    ) -> ResponseT:
         """
         Enable and disable redis server replies.
         ``reply`` Must be ON OFF or SKIP,
@@ -489,7 +544,7 @@ def client_reply(self, reply, **kwargs):
             raise DataError(f"CLIENT REPLY must be one of {replies!r}")
         return self.execute_command("CLIENT REPLY", reply, **kwargs)
 
-    def client_id(self, **kwargs):
+    def client_id(self, **kwargs) -> ResponseT:
         """
         Returns the current connection id
 
@@ -499,13 +554,13 @@ def client_id(self, **kwargs):
 
     def client_tracking_on(
         self,
-        clientid=None,
-        prefix=[],
-        bcast=False,
-        optin=False,
-        optout=False,
-        noloop=False,
-    ):
+        clientid: Union[int, None] = None,
+        prefix: Sequence[KeyT] = [],
+        bcast: bool = False,
+        optin: bool = False,
+        optout: bool = False,
+        noloop: bool = False,
+    ) -> ResponseT:
         """
         Turn on the tracking mode.
         For more information about the options look at client_tracking func.
@@ -518,13 +573,13 @@ def client_tracking_on(
 
     def client_tracking_off(
         self,
-        clientid=None,
-        prefix=[],
-        bcast=False,
-        optin=False,
-        optout=False,
-        noloop=False,
-    ):
+        clientid: Union[int, None] = None,
+        prefix: Sequence[KeyT] = [],
+        bcast: bool = False,
+        optin: bool = False,
+        optout: bool = False,
+        noloop: bool = False,
+    ) -> ResponseT:
         """
         Turn off the tracking mode.
         For more information about the options look at client_tracking func.
@@ -537,15 +592,15 @@ def client_tracking_off(
 
     def client_tracking(
         self,
-        on=True,
-        clientid=None,
-        prefix=[],
-        bcast=False,
-        optin=False,
-        optout=False,
-        noloop=False,
+        on: bool = True,
+        clientid: Union[int, None] = None,
+        prefix: Sequence[KeyT] = [],
+        bcast: bool = False,
+        optin: bool = False,
+        optout: bool = False,
+        noloop: bool = False,
         **kwargs,
-    ):
+    ) -> ResponseT:
         """
         Enables the tracking feature of the Redis server, that is used
         for server assisted client side caching.
@@ -595,7 +650,7 @@ def client_tracking(
 
         return self.execute_command("CLIENT TRACKING", *pieces)
 
-    def client_trackinginfo(self, **kwargs):
+    def client_trackinginfo(self, **kwargs) -> ResponseT:
         """
         Returns the information about the current client connection's
         use of the server assisted client side cache.
@@ -604,7 +659,7 @@ def client_trackinginfo(self, **kwargs):
         """
         return self.execute_command("CLIENT TRACKINGINFO", **kwargs)
 
-    def client_setname(self, name, **kwargs):
+    def client_setname(self, name: str, **kwargs) -> ResponseT:
         """
         Sets the current connection name
 
@@ -612,7 +667,12 @@ def client_setname(self, name, **kwargs):
         """
         return self.execute_command("CLIENT SETNAME", name, **kwargs)
 
-    def client_unblock(self, client_id, error=False, **kwargs):
+    def client_unblock(
+        self,
+        client_id: int,
+        error: bool = False,
+        **kwargs,
+    ) -> ResponseT:
         """
         Unblocks a connection by its client id.
         If ``error`` is True, unblocks the client with a special error message.
@@ -626,7 +686,7 @@ def client_unblock(self, client_id, error=False, **kwargs):
             args.append(b"ERROR")
         return self.execute_command(*args, **kwargs)
 
-    def client_pause(self, timeout, all=True, **kwargs):
+    def client_pause(self, timeout: int, all: bool = True, **kwargs) -> ResponseT:
         """
         Suspend all the Redis clients for the specified amount of time
         :param timeout: milliseconds to pause clients
@@ -649,7 +709,7 @@ def client_pause(self, timeout, all=True, **kwargs):
             args.append("WRITE")
         return self.execute_command(*args, **kwargs)
 
-    def client_unpause(self, **kwargs):
+    def client_unpause(self, **kwargs) -> ResponseT:
         """
         Unpause all redis clients
 
@@ -673,15 +733,15 @@ def command(self, **kwargs):
         """
         return self.execute_command("COMMAND", **kwargs)
 
-    def command_info(self, **kwargs):
+    def command_info(self, **kwargs) -> None:
         raise NotImplementedError(
             "COMMAND INFO is intentionally not implemented in the client."
         )
 
-    def command_count(self, **kwargs):
+    def command_count(self, **kwargs) -> ResponseT:
         return self.execute_command("COMMAND COUNT", **kwargs)
 
-    def config_get(self, pattern="*", **kwargs):
+    def config_get(self, pattern: PatternT = "*", **kwargs) -> ResponseT:
         """
         Return a dictionary of configuration based on the ``pattern``
 
@@ -689,14 +749,14 @@ def config_get(self, pattern="*", **kwargs):
         """
         return self.execute_command("CONFIG GET", pattern, **kwargs)
 
-    def config_set(self, name, value, **kwargs):
+    def config_set(self, name: KeyT, value: EncodableT, **kwargs) -> ResponseT:
         """Set config item ``name`` with ``value``
 
         For more information check https://redis.io/commands/config-set
         """
         return self.execute_command("CONFIG SET", name, value, **kwargs)
 
-    def config_resetstat(self, **kwargs):
+    def config_resetstat(self, **kwargs) -> ResponseT:
         """
         Reset runtime statistics
 
@@ -704,7 +764,7 @@ def config_resetstat(self, **kwargs):
         """
         return self.execute_command("CONFIG RESETSTAT", **kwargs)
 
-    def config_rewrite(self, **kwargs):
+    def config_rewrite(self, **kwargs) -> ResponseT:
         """
         Rewrite config file with the minimal change to reflect running config.
 
@@ -712,7 +772,7 @@ def config_rewrite(self, **kwargs):
         """
         return self.execute_command("CONFIG REWRITE", **kwargs)
 
-    def dbsize(self, **kwargs):
+    def dbsize(self, **kwargs) -> ResponseT:
         """
         Returns the number of keys in the current database
 
@@ -720,7 +780,7 @@ def dbsize(self, **kwargs):
         """
         return self.execute_command("DBSIZE", **kwargs)
 
-    def debug_object(self, key, **kwargs):
+    def debug_object(self, key: KeyT, **kwargs) -> ResponseT:
         """
         Returns version specific meta information about a given key
 
@@ -728,7 +788,7 @@ def debug_object(self, key, **kwargs):
         """
         return self.execute_command("DEBUG OBJECT", key, **kwargs)
 
-    def debug_segfault(self, **kwargs):
+    def debug_segfault(self, **kwargs) -> None:
         raise NotImplementedError(
             """
             DEBUG SEGFAULT is intentionally not implemented in the client.
@@ -737,7 +797,7 @@ def debug_segfault(self, **kwargs):
             """
         )
 
-    def echo(self, value, **kwargs):
+    def echo(self, value: EncodableT, **kwargs) -> ResponseT:
         """
         Echo the string back from the server
 
@@ -745,7 +805,7 @@ def echo(self, value, **kwargs):
         """
         return self.execute_command("ECHO", value, **kwargs)
 
-    def flushall(self, asynchronous=False, **kwargs):
+    def flushall(self, asynchronous: bool = False, **kwargs) -> ResponseT:
         """
         Delete all keys in all databases on the current host.
 
@@ -759,7 +819,7 @@ def flushall(self, asynchronous=False, **kwargs):
             args.append(b"ASYNC")
         return self.execute_command("FLUSHALL", *args, **kwargs)
 
-    def flushdb(self, asynchronous=False, **kwargs):
+    def flushdb(self, asynchronous: bool = False, **kwargs) -> ResponseT:
         """
         Delete all keys in the current database.
 
@@ -773,7 +833,7 @@ def flushdb(self, asynchronous=False, **kwargs):
             args.append(b"ASYNC")
         return self.execute_command("FLUSHDB", *args, **kwargs)
 
-    def sync(self):
+    def sync(self) -> ResponseT:
         """
         Initiates a replication stream from the master.
 
@@ -785,7 +845,7 @@ def sync(self):
         options[NEVER_DECODE] = []
         return self.execute_command("SYNC", **options)
 
-    def psync(self, replicationid, offset):
+    def psync(self, replicationid: str, offset: int):
         """
         Initiates a replication stream from the master.
         Newer version for `sync`.
@@ -798,7 +858,7 @@ def psync(self, replicationid, offset):
         options[NEVER_DECODE] = []
         return self.execute_command("PSYNC", replicationid, offset, **options)
 
-    def swapdb(self, first, second, **kwargs):
+    def swapdb(self, first: int, second: int, **kwargs) -> ResponseT:
         """
         Swap two databases
 
@@ -806,14 +866,14 @@ def swapdb(self, first, second, **kwargs):
         """
         return self.execute_command("SWAPDB", first, second, **kwargs)
 
-    def select(self, index, **kwargs):
+    def select(self, index: int, **kwargs) -> ResponseT:
         """Select the Redis logical database at index.
 
         See: https://redis.io/commands/select
         """
         return self.execute_command("SELECT", index, **kwargs)
 
-    def info(self, section=None, **kwargs):
+    def info(self, section: Union[str, None] = None, **kwargs) -> ResponseT:
         """
         Returns a dictionary containing information about the Redis server
 
@@ -830,7 +890,7 @@ def info(self, section=None, **kwargs):
         else:
             return self.execute_command("INFO", section, **kwargs)
 
-    def lastsave(self, **kwargs):
+    def lastsave(self, **kwargs) -> ResponseT:
         """
         Return a Python datetime object representing the last time the
         Redis database was saved to disk
@@ -839,7 +899,7 @@ def lastsave(self, **kwargs):
         """
         return self.execute_command("LASTSAVE", **kwargs)
 
-    def lolwut(self, *version_numbers, **kwargs):
+    def lolwut(self, *version_numbers: Union[str, float], **kwargs) -> ResponseT:
         """
         Get the Redis version and a piece of generative computer art
 
@@ -850,7 +910,7 @@ def lolwut(self, *version_numbers, **kwargs):
         else:
             return self.execute_command("LOLWUT", **kwargs)
 
-    def reset(self):
+    def reset(self) -> ResponseT:
         """Perform a full reset on the connection's server side contenxt.
 
         See: https://redis.io/commands/reset
@@ -859,16 +919,16 @@ def reset(self):
 
     def migrate(
         self,
-        host,
-        port,
-        keys,
-        destination_db,
-        timeout,
-        copy=False,
-        replace=False,
-        auth=None,
+        host: str,
+        port: int,
+        keys: KeysT,
+        destination_db: int,
+        timeout: int,
+        copy: bool = False,
+        replace: bool = False,
+        auth: Union[str, None] = None,
         **kwargs,
-    ):
+    ) -> ResponseT:
         """
         Migrate 1 or more keys from the current Redis server to a different
         server specified by the ``host``, ``port`` and ``destination_db``.
@@ -905,7 +965,7 @@ def migrate(
             "MIGRATE", host, port, "", destination_db, timeout, *pieces, **kwargs
         )
 
-    def object(self, infotype, key, **kwargs):
+    def object(self, infotype: str, key: KeyT, **kwargs) -> ResponseT:
         """
         Return the encoding, idletime, or refcount about the key
         """
@@ -913,7 +973,7 @@ def object(self, infotype, key, **kwargs):
             "OBJECT", infotype, key, infotype=infotype, **kwargs
         )
 
-    def memory_doctor(self, **kwargs):
+    def memory_doctor(self, **kwargs) -> None:
         raise NotImplementedError(
             """
             MEMORY DOCTOR is intentionally not implemented in the client.
@@ -922,7 +982,7 @@ def memory_doctor(self, **kwargs):
             """
         )
 
-    def memory_help(self, **kwargs):
+    def memory_help(self, **kwargs) -> None:
         raise NotImplementedError(
             """
             MEMORY HELP is intentionally not implemented in the client.
@@ -931,7 +991,7 @@ def memory_help(self, **kwargs):
             """
         )
 
-    def memory_stats(self, **kwargs):
+    def memory_stats(self, **kwargs) -> ResponseT:
         """
         Return a dictionary of memory stats
 
@@ -939,7 +999,7 @@ def memory_stats(self, **kwargs):
         """
         return self.execute_command("MEMORY STATS", **kwargs)
 
-    def memory_malloc_stats(self, **kwargs):
+    def memory_malloc_stats(self, **kwargs) -> ResponseT:
         """
         Return an internal statistics report from the memory allocator.
 
@@ -947,7 +1007,9 @@ def memory_malloc_stats(self, **kwargs):
         """
         return self.execute_command("MEMORY MALLOC-STATS", **kwargs)
 
-    def memory_usage(self, key, samples=None, **kwargs):
+    def memory_usage(
+        self, key: KeyT, samples: Union[int, None] = None, **kwargs
+    ) -> ResponseT:
         """
         Return the total memory usage for key, its value and associated
         administrative overheads.
@@ -963,7 +1025,7 @@ def memory_usage(self, key, samples=None, **kwargs):
             args.extend([b"SAMPLES", samples])
         return self.execute_command("MEMORY USAGE", key, *args, **kwargs)
 
-    def memory_purge(self, **kwargs):
+    def memory_purge(self, **kwargs) -> ResponseT:
         """
         Attempts to purge dirty pages for reclamation by allocator
 
@@ -971,7 +1033,7 @@ def memory_purge(self, **kwargs):
         """
         return self.execute_command("MEMORY PURGE", **kwargs)
 
-    def ping(self, **kwargs):
+    def ping(self, **kwargs) -> ResponseT:
         """
         Ping the Redis server
 
@@ -979,7 +1041,7 @@ def ping(self, **kwargs):
         """
         return self.execute_command("PING", **kwargs)
 
-    def quit(self, **kwargs):
+    def quit(self, **kwargs) -> ResponseT:
         """
         Ask the server to close the connection.
 
@@ -987,7 +1049,7 @@ def quit(self, **kwargs):
         """
         return self.execute_command("QUIT", **kwargs)
 
-    def replicaof(self, *args, **kwargs):
+    def replicaof(self, *args, **kwargs) -> ResponseT:
         """
         Update the replication settings of a redis replica, on the fly.
         Examples of valid arguments include:
@@ -998,7 +1060,7 @@ def replicaof(self, *args, **kwargs):
         """
         return self.execute_command("REPLICAOF", *args, **kwargs)
 
-    def save(self, **kwargs):
+    def save(self, **kwargs) -> ResponseT:
         """
         Tell the Redis server to save its data to disk,
         blocking until the save is complete
@@ -1007,7 +1069,7 @@ def save(self, **kwargs):
         """
         return self.execute_command("SAVE", **kwargs)
 
-    def shutdown(self, save=False, nosave=False, **kwargs):
+    def shutdown(self, save: bool = False, nosave: bool = False, **kwargs) -> None:
         """Shutdown the Redis server.  If Redis has persistence configured,
         data will be flushed before shutdown.  If the "save" option is set,
         a data flush will be attempted even if there is no persistence
@@ -1030,7 +1092,9 @@ def shutdown(self, save=False, nosave=False, **kwargs):
             return
         raise RedisError("SHUTDOWN seems to have failed.")
 
-    def slaveof(self, host=None, port=None, **kwargs):
+    def slaveof(
+        self, host: Union[str, None] = None, port: Union[int, None] = None, **kwargs
+    ) -> ResponseT:
         """
         Set the server to be a replicated slave of the instance identified
         by the ``host`` and ``port``. If called without arguments, the
@@ -1042,7 +1106,7 @@ def slaveof(self, host=None, port=None, **kwargs):
             return self.execute_command("SLAVEOF", b"NO", b"ONE", **kwargs)
         return self.execute_command("SLAVEOF", host, port, **kwargs)
 
-    def slowlog_get(self, num=None, **kwargs):
+    def slowlog_get(self, num: Union[int, None] = None, **kwargs) -> ResponseT:
         """
         Get the entries from the slowlog. If ``num`` is specified, get the
         most recent ``num`` items.
@@ -1059,7 +1123,7 @@ def slowlog_get(self, num=None, **kwargs):
             kwargs[NEVER_DECODE] = []
         return self.execute_command(*args, **kwargs)
 
-    def slowlog_len(self, **kwargs):
+    def slowlog_len(self, **kwargs) -> ResponseT:
         """
         Get the number of items in the slowlog
 
@@ -1067,7 +1131,7 @@ def slowlog_len(self, **kwargs):
         """
         return self.execute_command("SLOWLOG LEN", **kwargs)
 
-    def slowlog_reset(self, **kwargs):
+    def slowlog_reset(self, **kwargs) -> ResponseT:
         """
         Remove all items in the slowlog
 
@@ -1075,7 +1139,7 @@ def slowlog_reset(self, **kwargs):
         """
         return self.execute_command("SLOWLOG RESET", **kwargs)
 
-    def time(self, **kwargs):
+    def time(self, **kwargs) -> ResponseT:
         """
         Returns the server time as a 2-item tuple of ints:
         (seconds since epoch, microseconds into this second).
@@ -1084,7 +1148,7 @@ def time(self, **kwargs):
         """
         return self.execute_command("TIME", **kwargs)
 
-    def wait(self, num_replicas, timeout, **kwargs):
+    def wait(self, num_replicas: int, timeout: int, **kwargs) -> ResponseT:
         """
         Redis synchronous replication
         That returns the number of replicas that processed the query when
@@ -1114,12 +1178,166 @@ def failover(self):
         )
 
 
-class BasicKeyCommands:
+AsyncManagementCommands = ManagementCommands
+
+
+class AsyncManagementCommands(ManagementCommands):
+    async def command_info(self, **kwargs) -> None:
+        return super().command_info(**kwargs)
+
+    async def debug_segfault(self, **kwargs) -> None:
+        return super().debug_segfault(**kwargs)
+
+    async def memory_doctor(self, **kwargs) -> None:
+        return super().memory_doctor(**kwargs)
+
+    async def memory_help(self, **kwargs) -> None:
+        return super().memory_help(**kwargs)
+
+    async def shutdown(
+        self, save: bool = False, nosave: bool = False, **kwargs
+    ) -> None:
+        """Shutdown the Redis server.  If Redis has persistence configured,
+        data will be flushed before shutdown.  If the "save" option is set,
+        a data flush will be attempted even if there is no persistence
+        configured.  If the "nosave" option is set, no data flush will be
+        attempted.  The "save" and "nosave" options cannot both be set.
+
+        For more information check https://redis.io/commands/shutdown
+        """
+        if save and nosave:
+            raise DataError("SHUTDOWN save and nosave cannot both be set")
+        args = ["SHUTDOWN"]
+        if save:
+            args.append("SAVE")
+        if nosave:
+            args.append("NOSAVE")
+        try:
+            await self.execute_command(*args, **kwargs)
+        except ConnectionError:
+            # a ConnectionError here is expected
+            return
+        raise RedisError("SHUTDOWN seems to have failed.")
+
+
+class BitFieldOperation:
+    """
+    Command builder for BITFIELD commands.
+    """
+
+    def __init__(
+        self,
+        client: Union["Redis", "AsyncRedis"],
+        key: str,
+        default_overflow: Union[str, None] = None,
+    ):
+        self.client = client
+        self.key = key
+        self._default_overflow = default_overflow
+        # for typing purposes, run the following in constructor and in reset()
+        self.operations: list[tuple[EncodableT, ...]] = []
+        self._last_overflow = "WRAP"
+        self.reset()
+
+    def reset(self):
+        """
+        Reset the state of the instance to when it was constructed
+        """
+        self.operations = []
+        self._last_overflow = "WRAP"
+        self.overflow(self._default_overflow or self._last_overflow)
+
+    def overflow(self, overflow: str):
+        """
+        Update the overflow algorithm of successive INCRBY operations
+        :param overflow: Overflow algorithm, one of WRAP, SAT, FAIL. See the
+            Redis docs for descriptions of these algorithmsself.
+        :returns: a :py:class:`BitFieldOperation` instance.
+        """
+        overflow = overflow.upper()
+        if overflow != self._last_overflow:
+            self._last_overflow = overflow
+            self.operations.append(("OVERFLOW", overflow))
+        return self
+
+    def incrby(
+        self,
+        fmt: str,
+        offset: BitfieldOffsetT,
+        increment: int,
+        overflow: Union[str, None] = None,
+    ):
+        """
+        Increment a bitfield by a given amount.
+        :param fmt: format-string for the bitfield being updated, e.g. 'u8'
+            for an unsigned 8-bit integer.
+        :param offset: offset (in number of bits). If prefixed with a
+            '#', this is an offset multiplier, e.g. given the arguments
+            fmt='u8', offset='#2', the offset will be 16.
+        :param int increment: value to increment the bitfield by.
+        :param str overflow: overflow algorithm. Defaults to WRAP, but other
+            acceptable values are SAT and FAIL. See the Redis docs for
+            descriptions of these algorithms.
+        :returns: a :py:class:`BitFieldOperation` instance.
+        """
+        if overflow is not None:
+            self.overflow(overflow)
+
+        self.operations.append(("INCRBY", fmt, offset, increment))
+        return self
+
+    def get(self, fmt: str, offset: BitfieldOffsetT):
+        """
+        Get the value of a given bitfield.
+        :param fmt: format-string for the bitfield being read, e.g. 'u8' for
+            an unsigned 8-bit integer.
+        :param offset: offset (in number of bits). If prefixed with a
+            '#', this is an offset multiplier, e.g. given the arguments
+            fmt='u8', offset='#2', the offset will be 16.
+        :returns: a :py:class:`BitFieldOperation` instance.
+        """
+        self.operations.append(("GET", fmt, offset))
+        return self
+
+    def set(self, fmt: str, offset: BitfieldOffsetT, value: int):
+        """
+        Set the value of a given bitfield.
+        :param fmt: format-string for the bitfield being read, e.g. 'u8' for
+            an unsigned 8-bit integer.
+        :param offset: offset (in number of bits). If prefixed with a
+            '#', this is an offset multiplier, e.g. given the arguments
+            fmt='u8', offset='#2', the offset will be 16.
+        :param int value: value to set at the given position.
+        :returns: a :py:class:`BitFieldOperation` instance.
+        """
+        self.operations.append(("SET", fmt, offset, value))
+        return self
+
+    @property
+    def command(self):
+        cmd = ["BITFIELD", self.key]
+        for ops in self.operations:
+            cmd.extend(ops)
+        return cmd
+
+    def execute(self) -> ResponseT:
+        """
+        Execute the operation(s) in a single BITFIELD command. The return value
+        is a list of values corresponding to each operation. If the client
+        used to create this instance was a pipeline, the list of values
+        will be present within the pipeline's execute.
+        """
+        command = self.command
+        self.reset()
+        return self.client.execute_command(*command)
+
+
+class BasicKeyCommands(CommandsProtocol):
     """
     Redis basic key-based commands
     """
 
-    def append(self, key, value):
+    def append(self, key: KeyT, value: EncodableT) -> ResponseT:
         """
         Appends the string ``value`` to the value at ``key``. If ``key``
         doesn't already exist, create it with a value of ``value``.
@@ -1129,7 +1347,12 @@ def append(self, key, value):
         """
         return self.execute_command("APPEND", key, value)
 
-    def bitcount(self, key, start=None, end=None):
+    def bitcount(
+        self,
+        key: KeyT,
+        start: Union[int, None] = None,
+        end: Union[int, None] = None,
+    ) -> ResponseT:
         """
         Returns the count of set bits in the value of ``key``.  Optional
         ``start`` and ``end`` parameters indicate which bytes to consider
@@ -1144,7 +1367,11 @@ def bitcount(self, key, start=None, end=None):
             raise DataError("Both start and end must be specified")
         return self.execute_command("BITCOUNT", *params)
 
-    def bitfield(self, key, default_overflow=None):
+    def bitfield(
+        self: Union["Redis", "AsyncRedis"],
+        key: KeyT,
+        default_overflow: Union[str, None] = None,
+    ) -> BitFieldOperation:
         """
         Return a BitFieldOperation instance to conveniently construct one or
         more bitfield operations on ``key``.
@@ -1153,7 +1380,12 @@ def bitfield(self, key, default_overflow=None):
         """
         return BitFieldOperation(self, key, default_overflow=default_overflow)
 
-    def bitop(self, operation, dest, *keys):
+    def bitop(
+        self,
+        operation: str,
+        dest: KeyT,
+        *keys: KeyT,
+    ) -> ResponseT:
         """
         Perform a bitwise operation using ``operation`` between ``keys`` and
         store the result in ``dest``.
@@ -1162,7 +1394,13 @@ def bitop(self, operation, dest, *keys):
         """
         return self.execute_command("BITOP", operation, dest, *keys)
 
-    def bitpos(self, key, bit, start=None, end=None):
+    def bitpos(
+        self,
+        key: KeyT,
+        bit: int,
+        start: Union[int, None] = None,
+        end: Union[int, None] = None,
+    ) -> ResponseT:
         """
         Return the position of the first bit set to 1 or 0 in a string.
         ``start`` and ``end`` defines search range. The range is interpreted
@@ -1183,7 +1421,13 @@ def bitpos(self, key, bit, start=None, end=None):
             raise DataError("start argument is not set, " "when end is specified")
         return self.execute_command("BITPOS", *params)
 
-    def copy(self, source, destination, destination_db=None, replace=False):
+    def copy(
+        self,
+        source: str,
+        destination: str,
+        destination_db: Union[str, None] = None,
+        replace: bool = False,
+    ) -> ResponseT:
         """
         Copy the value stored in the ``source`` key to the ``destination`` key.
 
@@ -1203,7 +1447,7 @@ def copy(self, source, destination, destination_db=None, replace=False):
             params.append("REPLACE")
         return self.execute_command("COPY", *params)
 
-    def decrby(self, name, amount=1):
+    def decrby(self, name: KeyT, amount: int = 1) -> ResponseT:
         """
         Decrements the value of ``key`` by ``amount``.  If no key exists,
         the value will be initialized as 0 - ``amount``
@@ -1214,16 +1458,16 @@ def decrby(self, name, amount=1):
 
     decr = decrby
 
-    def delete(self, *names):
+    def delete(self, *names: KeyT) -> ResponseT:
         """
         Delete one or more keys specified by ``names``
         """
         return self.execute_command("DEL", *names)
 
-    def __delitem__(self, name):
+    def __delitem__(self, name: KeyT):
         self.delete(name)
 
-    def dump(self, name):
+    def dump(self, name: KeyT) -> ResponseT:
         """
         Return a serialized version of the value stored at the specified key.
         If key does not exist a nil bulk reply is returned.
@@ -1236,7 +1480,7 @@ def dump(self, name):
         options[NEVER_DECODE] = []
         return self.execute_command("DUMP", name, **options)
 
-    def exists(self, *names):
+    def exists(self, *names: KeyT) -> ResponseT:
         """
         Returns the number of ``names`` that exist
 
@@ -1246,7 +1490,7 @@ def exists(self, *names):
 
     __contains__ = exists
 
-    def expire(self, name, time):
+    def expire(self, name: KeyT, time: ExpiryT) -> ResponseT:
         """
         Set an expire flag on key ``name`` for ``time`` seconds. ``time``
         can be represented by an integer or a Python timedelta object.
@@ -1257,7 +1501,7 @@ def expire(self, name, time):
             time = int(time.total_seconds())
         return self.execute_command("EXPIRE", name, time)
 
-    def expireat(self, name, when):
+    def expireat(self, name: KeyT, when: AbsExpiryT) -> ResponseT:
         """
         Set an expire flag on key ``name``. ``when`` can be represented
         as an integer indicating unix time or a Python datetime object.
@@ -1268,7 +1512,7 @@ def expireat(self, name, when):
             when = int(time.mktime(when.timetuple()))
         return self.execute_command("EXPIREAT", name, when)
 
-    def get(self, name):
+    def get(self, name: KeyT) -> ResponseT:
         """
         Return the value at key ``name``, or None if the key doesn't exist
 
@@ -1276,7 +1520,7 @@ def get(self, name):
         """
         return self.execute_command("GET", name)
 
-    def getdel(self, name):
+    def getdel(self, name: KeyT) -> ResponseT:
         """
         Get the value at key ``name`` and delete the key. This command
         is similar to GET, except for the fact that it also deletes
@@ -1287,7 +1531,15 @@ def getdel(self, name):
         """
         return self.execute_command("GETDEL", name)
 
-    def getex(self, name, ex=None, px=None, exat=None, pxat=None, persist=False):
+    def getex(
+        self,
+        name: KeyT,
+        ex: Union[ExpiryT, None] = None,
+        px: Union[ExpiryT, None] = None,
+        exat: Union[AbsExpiryT, None] = None,
+        pxat: Union[AbsExpiryT, None] = None,
+        persist: bool = False,
+    ) -> ResponseT:
         """
         Get the value of key and optionally set its expiration.
         GETEX is similar to GET, but is a write command with
@@ -1316,7 +1568,7 @@ def getex(self, name, ex=None, px=None, exat=None, pxat=None, persist=False):
                 "and ``persist`` are mutually exclusive."
             )
 
-        pieces = []
+        pieces: list[EncodableT] = []
         # similar to set command
         if ex is not None:
             pieces.append("EX")
@@ -1346,7 +1598,7 @@ def getex(self, name, ex=None, px=None, exat=None, pxat=None, persist=False):
 
         return self.execute_command("GETEX", name, *pieces)
 
-    def __getitem__(self, name):
+    def __getitem__(self, name: KeyT):
         """
         Return the value at key ``name``, raises a KeyError if the key
         doesn't exist.
@@ -1356,7 +1608,7 @@ def __getitem__(self, name):
             return value
         raise KeyError(name)
 
-    def getbit(self, name, offset):
+    def getbit(self, name: KeyT, offset: int) -> ResponseT:
         """
         Returns a boolean indicating the value of ``offset`` in ``name``
 
@@ -1364,7 +1616,7 @@ def getbit(self, name, offset):
         """
         return self.execute_command("GETBIT", name, offset)
 
-    def getrange(self, key, start, end):
+    def getrange(self, key: KeyT, start: int, end: int) -> ResponseT:
         """
         Returns the substring of the string value stored at ``key``,
         determined by the offsets ``start`` and ``end`` (both are inclusive)
@@ -1373,7 +1625,7 @@ def getrange(self, key, start, end):
         """
         return self.execute_command("GETRANGE", key, start, end)
 
-    def getset(self, name, value):
+    def getset(self, name: KeyT, value: EncodableT) -> ResponseT:
         """
         Sets the value at key ``name`` to ``value``
         and returns the old value at key ``name`` atomically.
@@ -1385,7 +1637,7 @@ def getset(self, name, value):
         """
         return self.execute_command("GETSET", name, value)
 
-    def incrby(self, name, amount=1):
+    def incrby(self, name: KeyT, amount: int = 1) -> ResponseT:
         """
         Increments the value of ``key`` by ``amount``.  If no key exists,
         the value will be initialized as ``amount``
@@ -1396,7 +1648,7 @@ def incrby(self, name, amount=1):
 
     incr = incrby
 
-    def incrbyfloat(self, name, amount=1.0):
+    def incrbyfloat(self, name: KeyT, amount: float = 1.0) -> ResponseT:
         """
         Increments the value at key ``name`` by floating ``amount``.
         If no key exists, the value will be initialized as ``amount``
@@ -1405,7 +1657,7 @@ def incrbyfloat(self, name, amount=1.0):
         """
         return self.execute_command("INCRBYFLOAT", name, amount)
 
-    def keys(self, pattern="*", **kwargs):
+    def keys(self, pattern: PatternT = "*", **kwargs) -> ResponseT:
         """
         Returns a list of keys matching ``pattern``
 
@@ -1413,7 +1665,13 @@ def keys(self, pattern="*", **kwargs):
         """
         return self.execute_command("KEYS", pattern, **kwargs)
 
-    def lmove(self, first_list, second_list, src="LEFT", dest="RIGHT"):
+    def lmove(
+        self,
+        first_list: str,
+        second_list: str,
+        src: str = "LEFT",
+        dest: str = "RIGHT",
+    ) -> ResponseT:
         """
         Atomically returns and removes the first/last element of a list,
         pushing it as the first/last element on the destination list.
@@ -1424,7 +1682,14 @@ def lmove(self, first_list, second_list, src="LEFT", dest="RIGHT"):
         params = [first_list, second_list, src, dest]
         return self.execute_command("LMOVE", *params)
 
-    def blmove(self, first_list, second_list, timeout, src="LEFT", dest="RIGHT"):
+    def blmove(
+        self,
+        first_list: str,
+        second_list: str,
+        timeout: int,
+        src: str = "LEFT",
+        dest: str = "RIGHT",
+    ) -> ResponseT:
         """
         Blocking version of lmove.
 
@@ -1433,7 +1698,7 @@ def blmove(self, first_list, second_list, timeout, src="LEFT", dest="RIGHT"):
         params = [first_list, second_list, src, dest, timeout]
         return self.execute_command("BLMOVE", *params)
 
-    def mget(self, keys, *args):
+    def mget(self, keys: KeysT, *args: EncodableT) -> ResponseT:
         """
         Returns a list of values ordered identically to ``keys``
 
@@ -1447,7 +1712,7 @@ def mget(self, keys, *args):
             options[EMPTY_RESPONSE] = []
         return self.execute_command("MGET", *args, **options)
 
-    def mset(self, mapping):
+    def mset(self, mapping: Mapping[AnyKeyT, EncodableT]) -> ResponseT:
         """
         Sets key/values based on a mapping. Mapping is a dictionary of
         key/value pairs. Both keys and values should be strings or types that
@@ -1460,7 +1725,7 @@ def mset(self, mapping):
             items.extend(pair)
         return self.execute_command("MSET", *items)
 
-    def msetnx(self, mapping):
+    def msetnx(self, mapping: Mapping[AnyKeyT, EncodableT]) -> ResponseT:
         """
         Sets key/values based on a mapping if none of the keys are already set.
         Mapping is a dictionary of key/value pairs. Both keys and values
@@ -1474,7 +1739,7 @@ def msetnx(self, mapping):
             items.extend(pair)
         return self.execute_command("MSETNX", *items)
 
-    def move(self, name, db):
+    def move(self, name: KeyT, db: int) -> ResponseT:
         """
         Moves the key ``name`` to a different Redis database ``db``
 
@@ -1482,7 +1747,7 @@ def move(self, name, db):
         """
         return self.execute_command("MOVE", name, db)
 
-    def persist(self, name):
+    def persist(self, name: KeyT) -> ResponseT:
         """
         Removes an expiration on ``name``
 
@@ -1490,7 +1755,7 @@ def persist(self, name):
         """
         return self.execute_command("PERSIST", name)
 
-    def pexpire(self, name, time):
+    def pexpire(self, name: KeyT, time: ExpiryT) -> ResponseT:
         """
         Set an expire flag on key ``name`` for ``time`` milliseconds.
         ``time`` can be represented by an integer or a Python timedelta
@@ -1502,7 +1767,7 @@ def pexpire(self, name, time):
             time = int(time.total_seconds() * 1000)
         return self.execute_command("PEXPIRE", name, time)
 
-    def pexpireat(self, name, when):
+    def pexpireat(self, name: KeyT, when: AbsExpiryT) -> ResponseT:
         """
         Set an expire flag on key ``name``. ``when`` can be represented
         as an integer representing unix time in milliseconds (unix time * 1000)
@@ -1515,7 +1780,12 @@ def pexpireat(self, name, when):
             when = int(time.mktime(when.timetuple())) * 1000 + ms
         return self.execute_command("PEXPIREAT", name, when)
 
-    def psetex(self, name, time_ms, value):
+    def psetex(
+        self,
+        name: KeyT,
+        time_ms: ExpiryT,
+        value: EncodableT,
+    ):
         """
         Set the value of key ``name`` to ``value`` that expires in ``time_ms``
         milliseconds. ``time_ms`` can be represented by an integer or a Python
@@ -1527,7 +1797,7 @@ def psetex(self, name, time_ms, value):
             time_ms = int(time_ms.total_seconds() * 1000)
         return self.execute_command("PSETEX", name, time_ms, value)
 
-    def pttl(self, name):
+    def pttl(self, name: KeyT) -> ResponseT:
         """
         Returns the number of milliseconds until the key ``name`` will expire
 
@@ -1535,7 +1805,12 @@ def pttl(self, name):
         """
         return self.execute_command("PTTL", name)
 
-    def hrandfield(self, key, count=None, withvalues=False):
+    def hrandfield(
+        self,
+        key: str,
+        count: int = None,
+        withvalues: bool = False,
+    ) -> ResponseT:
         """
         Return a random field from the hash value stored at key.
 
@@ -1557,7 +1832,7 @@ def hrandfield(self, key, count=None, withvalues=False):
 
         return self.execute_command("HRANDFIELD", key, *params)
 
-    def randomkey(self, **kwargs):
+    def randomkey(self, **kwargs) -> ResponseT:
         """
         Returns the name of a random key
 
@@ -1565,7 +1840,7 @@ def randomkey(self, **kwargs):
         """
         return self.execute_command("RANDOMKEY", **kwargs)
 
-    def rename(self, src, dst):
+    def rename(self, src: KeyT, dst: KeyT) -> ResponseT:
         """
         Rename key ``src`` to ``dst``
 
@@ -1573,7 +1848,7 @@ def rename(self, src, dst):
         """
         return self.execute_command("RENAME", src, dst)
 
-    def renamenx(self, src, dst):
+    def renamenx(self, src: KeyT, dst: KeyT):
         """
         Rename key ``src`` to ``dst`` if ``dst`` doesn't already exist
 
@@ -1583,14 +1858,14 @@ def renamenx(self, src, dst):
 
     def restore(
         self,
-        name,
-        ttl,
-        value,
-        replace=False,
-        absttl=False,
-        idletime=None,
-        frequency=None,
-    ):
+        name: KeyT,
+        ttl: float,
+        value: EncodableT,
+        replace: bool = False,
+        absttl: bool = False,
+        idletime: Union[int, None] = None,
+        frequency: Union[int, None] = None,
+    ) -> ResponseT:
         """
         Create a key using the provided serialized value, previously obtained
         using DUMP.
@@ -1633,17 +1908,17 @@ def restore(
 
     def set(
         self,
-        name,
-        value,
-        ex=None,
-        px=None,
-        nx=False,
-        xx=False,
-        keepttl=False,
-        get=False,
-        exat=None,
-        pxat=None,
-    ):
+        name: KeyT,
+        value: EncodableT,
+        ex: Union[ExpiryT, None] = None,
+        px: Union[ExpiryT, None] = None,
+        nx: bool = False,
+        xx: bool = False,
+        keepttl: bool = False,
+        get: bool = False,
+        exat: Union[AbsExpiryT, None] = None,
+        pxat: Union[AbsExpiryT, None] = None,
+    ) -> ResponseT:
         """
         Set the value at key ``name`` to ``value``
 
@@ -1672,7 +1947,7 @@ def set(
 
         For more information check https://redis.io/commands/set
         """
-        pieces = [name, value]
+        pieces: list[EncodableT] = [name, value]
         options = {}
         if ex is not None:
             pieces.append("EX")
@@ -1716,10 +1991,10 @@ def set(
 
         return self.execute_command("SET", *pieces, **options)
 
-    def __setitem__(self, name, value):
+    def __setitem__(self, name: KeyT, value: EncodableT):
         self.set(name, value)
 
-    def setbit(self, name, offset, value):
+    def setbit(self, name: KeyT, offset: int, value: int) -> ResponseT:
         """
         Flag the ``offset`` in ``name`` as ``value``. Returns a boolean
         indicating the previous value of ``offset``.
@@ -1729,7 +2004,7 @@ def setbit(self, name, offset, value):
         value = value and 1 or 0
         return self.execute_command("SETBIT", name, offset, value)
 
-    def setex(self, name, time, value):
+    def setex(self, name: KeyT, time: ExpiryT, value: EncodableT) -> ResponseT:
         """
         Set the value of key ``name`` to ``value`` that expires in ``time``
         seconds. ``time`` can be represented by an integer or a Python
@@ -1741,7 +2016,7 @@ def setex(self, name, time, value):
             time = int(time.total_seconds())
         return self.execute_command("SETEX", name, time, value)
 
-    def setnx(self, name, value):
+    def setnx(self, name: KeyT, value: EncodableT) -> ResponseT:
         """
         Set the value of key ``name`` to ``value`` if key doesn't exist
 
@@ -1749,7 +2024,12 @@ def setnx(self, name, value):
         """
         return self.execute_command("SETNX", name, value)
 
-    def setrange(self, name, offset, value):
+    def setrange(
+        self,
+        name: KeyT,
+        offset: int,
+        value: EncodableT,
+    ) -> ResponseT:
         """
         Overwrite bytes in the value of ``name`` starting at ``offset`` with
         ``value``. If ``offset`` plus the length of ``value`` exceeds the
@@ -1766,16 +2046,16 @@ def setrange(self, name, offset, value):
 
     def stralgo(
         self,
-        algo,
-        value1,
-        value2,
-        specific_argument="strings",
-        len=False,
-        idx=False,
-        minmatchlen=None,
-        withmatchlen=False,
+        algo: Literal["LCS"],
+        value1: KeyT,
+        value2: KeyT,
+        specific_argument: Union[Literal["strings"], Literal["keys"]] = "strings",
+        len: bool = False,
+        idx: bool = False,
+        minmatchlen: Union[int, None] = None,
+        withmatchlen: bool = False,
         **kwargs,
-    ):
+    ) -> ResponseT:
         """
         Implements complex algorithms that operate on strings.
         Right now the only algorithm implemented is the LCS algorithm
@@ -1805,7 +2085,7 @@ def stralgo(
         if len and idx:
             raise DataError("len and idx cannot be provided together.")
 
-        pieces = [algo, specific_argument.upper(), value1, value2]
+        pieces: list[EncodableT] = [algo, specific_argument.upper(), value1, value2]
         if len:
             pieces.append(b"LEN")
         if idx:
@@ -1828,7 +2108,7 @@ def stralgo(
             **kwargs,
         )
 
-    def strlen(self, name):
+    def strlen(self, name: KeyT) -> ResponseT:
         """
         Return the number of bytes stored in the value of ``name``
 
@@ -1836,14 +2116,14 @@ def strlen(self, name):
         """
         return self.execute_command("STRLEN", name)
 
-    def substr(self, name, start, end=-1):
+    def substr(self, name: KeyT, start: int, end: int = -1) -> ResponseT:
         """
         Return a substring of the string at key ``name``. ``start`` and ``end``
         are 0-based integers specifying the portion of the string to return.
         """
         return self.execute_command("SUBSTR", name, start, end)
 
-    def touch(self, *args):
+    def touch(self, *args: KeyT) -> ResponseT:
         """
         Alters the last access time of a key(s) ``*args``. A key is ignored
         if it does not exist.
@@ -1852,7 +2132,7 @@ def touch(self, *args):
         """
         return self.execute_command("TOUCH", *args)
 
-    def ttl(self, name):
+    def ttl(self, name: KeyT) -> ResponseT:
         """
         Returns the number of seconds until the key ``name`` will expire
 
@@ -1860,7 +2140,7 @@ def ttl(self, name):
         """
         return self.execute_command("TTL", name)
 
-    def type(self, name):
+    def type(self, name: KeyT) -> ResponseT:
         """
         Returns the type of key ``name``
 
@@ -1868,7 +2148,7 @@ def type(self, name):
         """
         return self.execute_command("TYPE", name)
 
-    def watch(self, *names):
+    def watch(self, *names: KeyT) -> None:
         """
         Watches the values at keys ``names``, or None if the key doesn't exist
 
@@ -1876,7 +2156,7 @@ def watch(self, *names):
         """
         warnings.warn(DeprecationWarning("Call WATCH from a Pipeline object"))
 
-    def unwatch(self):
+    def unwatch(self) -> None:
         """
         Unwatches the value at key ``name``, or None of the key doesn't exist
 
@@ -1884,7 +2164,7 @@ def unwatch(self):
         """
         warnings.warn(DeprecationWarning("Call UNWATCH from a Pipeline object"))
 
-    def unlink(self, *names):
+    def unlink(self, *names: KeyT) -> ResponseT:
         """
         Unlink one or more keys specified by ``names``
 
@@ -1922,7 +2202,27 @@ def lcs(
         return self.execute_command("LCS", *pieces)
 
 
-class ListCommands:
+class AsyncBasicKeyCommands(BasicKeyCommands):
+    def __delitem__(self, name: KeyT):
+        raise TypeError("Async Redis client does not support class deletion")
+
+    def __contains__(self, name: KeyT):
+        raise TypeError("Async Redis client does not support class inclusion")
+
+    def __getitem__(self, name: KeyT):
+        raise TypeError("Async Redis client does not support class retrieval")
+
+    def __setitem__(self, name: KeyT, value: EncodableT):
+        raise TypeError("Async Redis client does not support class assignment")
+
+    async def watch(self, *names: KeyT) -> None:
+        return super().watch(*names)
+
+    async def unwatch(self) -> None:
+        return super().unwatch()
+
+
+class ListCommands(CommandsProtocol):
     """
     Redis commands for List data type.
     see: https://redis.io/topics/data-types#lists
@@ -2204,7 +2504,7 @@ def lpos(
 
          For more information check https://redis.io/commands/lpos
         """
-        pieces = [name, value]
+        pieces: list[EncodableT] = [name, value]
         if rank is not None:
             pieces.extend(["RANK", rank])
 
@@ -2256,7 +2556,7 @@ def sort(
         if (start is not None and num is None) or (num is not None and start is None):
             raise DataError("``start`` and ``num`` must both be specified")
 
-        pieces = [name]
+        pieces: list[EncodableT] = [name]
         if by is not None:
             pieces.extend([b"BY", by])
         if start is not None and num is not None:
@@ -2289,13 +2589,23 @@ def sort(
         return self.execute_command("SORT", *pieces, **options)
 
 
-class ScanCommands:
+AsyncListCommands = ListCommands
+
+
+class ScanCommands(CommandsProtocol):
     """
     Redis SCAN commands.
     see: https://redis.io/commands/scan
     """
 
-    def scan(self, cursor=0, match=None, count=None, _type=None, **kwargs):
+    def scan(
+        self,
+        cursor: int = 0,
+        match: Union[PatternT, None] = None,
+        count: Union[int, None] = None,
+        _type: Union[str, None] = None,
+        **kwargs,
+    ) -> ResponseT:
         """
         Incrementally return lists of key names. Also return a cursor
         indicating the scan position.
@@ -2312,7 +2622,7 @@ def scan(self, cursor=0, match=None, count=None, _type=None, **kwargs):
 
         For more information check https://redis.io/commands/scan
         """
-        pieces = [cursor]
+        pieces: list[EncodableT] = [cursor]
         if match is not None:
             pieces.extend([b"MATCH", match])
         if count is not None:
@@ -2321,7 +2631,13 @@ def scan(self, cursor=0, match=None, count=None, _type=None, **kwargs):
             pieces.extend([b"TYPE", _type])
         return self.execute_command("SCAN", *pieces, **kwargs)
 
-    def scan_iter(self, match=None, count=None, _type=None, **kwargs):
+    def scan_iter(
+        self,
+        match: Union[PatternT, None] = None,
+        count: Union[int, None] = None,
+        _type: Union[str, None] = None,
+        **kwargs,
+    ) -> Iterator:
         """
         Make an iterator using the SCAN command so that the client doesn't
         need to remember the cursor position.
@@ -2343,7 +2659,13 @@ def scan_iter(self, match=None, count=None, _type=None, **kwargs):
             )
             yield from data
 
-    def sscan(self, name, cursor=0, match=None, count=None):
+    def sscan(
+        self,
+        name: KeyT,
+        cursor: int = 0,
+        match: Union[PatternT, None] = None,
+        count: Union[int, None] = None,
+    ) -> ResponseT:
         """
         Incrementally return lists of elements in a set. Also return a cursor
         indicating the scan position.
@@ -2354,14 +2676,19 @@ def sscan(self, name, cursor=0, match=None, count=None):
 
         For more information check https://redis.io/commands/sscan
         """
-        pieces = [name, cursor]
+        pieces: list[EncodableT] = [name, cursor]
         if match is not None:
             pieces.extend([b"MATCH", match])
         if count is not None:
             pieces.extend([b"COUNT", count])
         return self.execute_command("SSCAN", *pieces)
 
-    def sscan_iter(self, name, match=None, count=None):
+    def sscan_iter(
+        self,
+        name: KeyT,
+        match: Union[PatternT, None] = None,
+        count: Union[int, None] = None,
+    ) -> Iterator:
         """
         Make an iterator using the SSCAN command so that the client doesn't
         need to remember the cursor position.
@@ -2375,7 +2702,13 @@ def sscan_iter(self, name, match=None, count=None):
             cursor, data = self.sscan(name, cursor=cursor, match=match, count=count)
             yield from data
 
-    def hscan(self, name, cursor=0, match=None, count=None):
+    def hscan(
+        self,
+        name: KeyT,
+        cursor: int = 0,
+        match: Union[PatternT, None] = None,
+        count: Union[int, None] = None,
+    ) -> ResponseT:
         """
         Incrementally return key/value slices in a hash. Also return a cursor
         indicating the scan position.
@@ -2386,14 +2719,19 @@ def hscan(self, name, cursor=0, match=None, count=None):
 
         For more information check https://redis.io/commands/hscan
         """
-        pieces = [name, cursor]
+        pieces: list[EncodableT] = [name, cursor]
         if match is not None:
             pieces.extend([b"MATCH", match])
         if count is not None:
             pieces.extend([b"COUNT", count])
         return self.execute_command("HSCAN", *pieces)
 
-    def hscan_iter(self, name, match=None, count=None):
+    def hscan_iter(
+        self,
+        name: str,
+        match: Union[PatternT, None] = None,
+        count: Union[int, None] = None,
+    ) -> Iterator:
         """
         Make an iterator using the HSCAN command so that the client doesn't
         need to remember the cursor position.
@@ -2407,7 +2745,14 @@ def hscan_iter(self, name, match=None, count=None):
             cursor, data = self.hscan(name, cursor=cursor, match=match, count=count)
             yield from data.items()
 
-    def zscan(self, name, cursor=0, match=None, count=None, score_cast_func=float):
+    def zscan(
+        self,
+        name: KeyT,
+        cursor: int = 0,
+        match: Union[PatternT, None] = None,
+        count: Union[int, None] = None,
+        score_cast_func: Union[type, Callable] = float,
+    ) -> ResponseT:
         """
         Incrementally return lists of elements in a sorted set. Also return a
         cursor indicating the scan position.
@@ -2428,7 +2773,13 @@ def zscan(self, name, cursor=0, match=None, count=None, score_cast_func=float):
         options = {"score_cast_func": score_cast_func}
         return self.execute_command("ZSCAN", *pieces, **options)
 
-    def zscan_iter(self, name, match=None, count=None, score_cast_func=float):
+    def zscan_iter(
+        self,
+        name: KeyT,
+        match: Union[PatternT, None] = None,
+        count: Union[int, None] = None,
+        score_cast_func: Union[type, Callable] = float,
+    ) -> Iterator:
         """
         Make an iterator using the ZSCAN command so that the client doesn't
         need to remember the cursor position.
@@ -2451,7 +2802,111 @@ def zscan_iter(self, name, match=None, count=None, score_cast_func=float):
             yield from data
 
 
-class SetCommands:
+class AsyncScanCommands(ScanCommands):
+    async def scan_iter(
+        self,
+        match: Union[PatternT, None] = None,
+        count: Union[int, None] = None,
+        _type: Union[str, None] = None,
+        **kwargs,
+    ) -> AsyncIterator:
+        """
+        Make an iterator using the SCAN command so that the client doesn't
+        need to remember the cursor position.
+
+        ``match`` allows for filtering the keys by pattern
+
+        ``count`` provides a hint to Redis about the number of keys to
+            return per batch.
+
+        ``_type`` filters the returned values by a particular Redis type.
+            Stock Redis instances allow for the following types:
+            HASH, LIST, SET, STREAM, STRING, ZSET
+            Additionally, Redis modules can expose other types as well.
+        """
+        cursor = "0"
+        while cursor != 0:
+            cursor, data = await self.scan(
+                cursor=cursor, match=match, count=count, _type=_type, **kwargs
+            )
+            for d in data:
+                yield d
+
+    async def sscan_iter(
+        self,
+        name: KeyT,
+        match: Union[PatternT, None] = None,
+        count: Union[int, None] = None,
+    ) -> AsyncIterator:
+        """
+        Make an iterator using the SSCAN command so that the client doesn't
+        need to remember the cursor position.
+
+        ``match`` allows for filtering the keys by pattern
+
+        ``count`` allows for hint the minimum number of returns
+        """
+        cursor = "0"
+        while cursor != 0:
+            cursor, data = await self.sscan(
+                name, cursor=cursor, match=match, count=count
+            )
+            for d in data:
+                yield d
+
+    async def hscan_iter(
+        self,
+        name: str,
+        match: Union[PatternT, None] = None,
+        count: Union[int, None] = None,
+    ) -> AsyncIterator:
+        """
+        Make an iterator using the HSCAN command so that the client doesn't
+        need to remember the cursor position.
+
+        ``match`` allows for filtering the keys by pattern
+
+        ``count`` allows for hint the minimum number of returns
+        """
+        cursor = "0"
+        while cursor != 0:
+            cursor, data = await self.hscan(
+                name, cursor=cursor, match=match, count=count
+            )
+            for it in data.items():
+                yield it
+
+    async def zscan_iter(
+        self,
+        name: KeyT,
+        match: Union[PatternT, None] = None,
+        count: Union[int, None] = None,
+        score_cast_func: Union[type, Callable] = float,
+    ) -> AsyncIterator:
+        """
+        Make an iterator using the ZSCAN command so that the client doesn't
+        need to remember the cursor position.
+
+        ``match`` allows for filtering the keys by pattern
+
+        ``count`` allows for hint the minimum number of returns
+
+        ``score_cast_func`` a callable used to cast the score return value
+        """
+        cursor = "0"
+        while cursor != 0:
+            cursor, data = await self.zscan(
+                name,
+                cursor=cursor,
+                match=match,
+                count=count,
+                score_cast_func=score_cast_func,
+            )
+            for d in data:
+                yield d
+
+
+class SetCommands(CommandsProtocol):
     """
     Redis commands for Set data type.
     see: https://redis.io/topics/data-types#sets
@@ -2612,13 +3067,21 @@ def sunionstore(self, dest: str, keys: List, *args: List) -> int:
         return self.execute_command("SUNIONSTORE", dest, *args)
 
 
-class StreamCommands:
+AsyncSetCommands = SetCommands
+
+
+class StreamCommands(CommandsProtocol):
     """
     Redis commands for Stream data type.
     see: https://redis.io/topics/streams-intro
     """
 
-    def xack(self, name, groupname, *ids):
+    def xack(
+        self,
+        name: KeyT,
+        groupname: GroupT,
+        *ids: StreamIdT,
+    ) -> ResponseT:
         """
         Acknowledges the successful processing of one or more messages.
         name: name of the stream.
@@ -2631,15 +3094,15 @@ def xack(self, name, groupname, *ids):
 
     def xadd(
         self,
-        name,
-        fields,
-        id="*",
-        maxlen=None,
-        approximate=True,
-        nomkstream=False,
-        minid=None,
-        limit=None,
-    ):
+        name: KeyT,
+        fields: Dict[FieldT, EncodableT],
+        id: StreamIdT = "*",
+        maxlen: Union[int, None] = None,
+        approximate: bool = True,
+        nomkstream: bool = False,
+        minid: Union[StreamIdT, None] = None,
+        limit: Union[int, None] = None,
+    ) -> ResponseT:
         """
         Add to a stream.
         name: name of the stream
@@ -2655,7 +3118,7 @@ def xadd(
 
         For more information check https://redis.io/commands/xadd
         """
-        pieces = []
+        pieces: list[EncodableT] = []
         if maxlen is not None and minid is not None:
             raise DataError(
                 "Only one of ```maxlen``` or ```minid``` " "may be specified"
@@ -2686,14 +3149,14 @@ def xadd(
 
     def xautoclaim(
         self,
-        name,
-        groupname,
-        consumername,
-        min_idle_time,
-        start_id=0,
-        count=None,
-        justid=False,
-    ):
+        name: KeyT,
+        groupname: GroupT,
+        consumername: ConsumerT,
+        min_idle_time: int,
+        start_id: int = 0,
+        count: Union[int, None] = None,
+        justid: bool = False,
+    ) -> ResponseT:
         """
         Transfers ownership of pending stream entries that match the specified
         criteria. Conceptually, equivalent to calling XPENDING and then XCLAIM,
@@ -2737,17 +3200,17 @@ def xautoclaim(
 
     def xclaim(
         self,
-        name,
-        groupname,
-        consumername,
-        min_idle_time,
-        message_ids,
-        idle=None,
-        time=None,
-        retrycount=None,
-        force=False,
-        justid=False,
-    ):
+        name: KeyT,
+        groupname: GroupT,
+        consumername: ConsumerT,
+        min_idle_time: int,
+        message_ids: [List[StreamIdT], Tuple[StreamIdT]],
+        idle: Union[int, None] = None,
+        time: Union[int, None] = None,
+        retrycount: Union[int, None] = None,
+        force: bool = False,
+        justid: bool = False,
+    ) -> ResponseT:
         """
         Changes the ownership of a pending message.
         name: name of the stream.
@@ -2781,7 +3244,7 @@ def xclaim(
             )
 
         kwargs = {}
-        pieces = [name, groupname, consumername, str(min_idle_time)]
+        pieces: list[EncodableT] = [name, groupname, consumername, str(min_idle_time)]
         pieces.extend(list(message_ids))
 
         if idle is not None:
@@ -2808,7 +3271,7 @@ def xclaim(
             kwargs["parse_justid"] = True
         return self.execute_command("XCLAIM", *pieces, **kwargs)
 
-    def xdel(self, name, *ids):
+    def xdel(self, name: KeyT, *ids: StreamIdT) -> ResponseT:
         """
         Deletes one or more messages from a stream.
         name: name of the stream.
@@ -2818,7 +3281,13 @@ def xdel(self, name, *ids):
         """
         return self.execute_command("XDEL", name, *ids)
 
-    def xgroup_create(self, name, groupname, id="$", mkstream=False):
+    def xgroup_create(
+        self,
+        name: KeyT,
+        groupname: GroupT,
+        id: StreamIdT = "$",
+        mkstream: bool = False,
+    ) -> ResponseT:
         """
         Create a new consumer group associated with a stream.
         name: name of the stream.
@@ -2827,12 +3296,17 @@ def xgroup_create(self, name, groupname, id="$", mkstream=False):
 
         For more information check https://redis.io/commands/xgroup-create
         """
-        pieces = ["XGROUP CREATE", name, groupname, id]
+        pieces: list[EncodableT] = ["XGROUP CREATE", name, groupname, id]
         if mkstream:
             pieces.append(b"MKSTREAM")
         return self.execute_command(*pieces)
 
-    def xgroup_delconsumer(self, name, groupname, consumername):
+    def xgroup_delconsumer(
+        self,
+        name: KeyT,
+        groupname: GroupT,
+        consumername: ConsumerT,
+    ) -> ResponseT:
         """
         Remove a specific consumer from a consumer group.
         Returns the number of pending messages that the consumer had before it
@@ -2845,7 +3319,7 @@ def xgroup_delconsumer(self, name, groupname, consumername):
         """
         return self.execute_command("XGROUP DELCONSUMER", name, groupname, consumername)
 
-    def xgroup_destroy(self, name, groupname):
+    def xgroup_destroy(self, name: KeyT, groupname: GroupT) -> ResponseT:
         """
         Destroy a consumer group.
         name: name of the stream.
@@ -2855,7 +3329,12 @@ def xgroup_destroy(self, name, groupname):
         """
         return self.execute_command("XGROUP DESTROY", name, groupname)
 
-    def xgroup_createconsumer(self, name, groupname, consumername):
+    def xgroup_createconsumer(
+        self,
+        name: KeyT,
+        groupname: GroupT,
+        consumername: ConsumerT,
+    ) -> ResponseT:
         """
         Consumers in a consumer group are auto-created every time a new
         consumer name is mentioned by some command.
@@ -2870,7 +3349,12 @@ def xgroup_createconsumer(self, name, groupname, consumername):
             "XGROUP CREATECONSUMER", name, groupname, consumername
         )
 
-    def xgroup_setid(self, name, groupname, id):
+    def xgroup_setid(
+        self,
+        name: KeyT,
+        groupname: GroupT,
+        id: StreamIdT,
+    ) -> ResponseT:
         """
         Set the consumer group last delivered ID to something else.
         name: name of the stream.
@@ -2881,7 +3365,7 @@ def xgroup_setid(self, name, groupname, id):
         """
         return self.execute_command("XGROUP SETID", name, groupname, id)
 
-    def xinfo_consumers(self, name, groupname):
+    def xinfo_consumers(self, name: KeyT, groupname: GroupT) -> ResponseT:
         """
         Returns general information about the consumers in the group.
         name: name of the stream.
@@ -2891,7 +3375,7 @@ def xinfo_consumers(self, name, groupname):
         """
         return self.execute_command("XINFO CONSUMERS", name, groupname)
 
-    def xinfo_groups(self, name):
+    def xinfo_groups(self, name: KeyT) -> ResponseT:
         """
         Returns general information about the consumer groups of the stream.
         name: name of the stream.
@@ -2900,7 +3384,7 @@ def xinfo_groups(self, name):
         """
         return self.execute_command("XINFO GROUPS", name)
 
-    def xinfo_stream(self, name, full=False):
+    def xinfo_stream(self, name: KeyT, full: bool = False) -> ResponseT:
         """
         Returns general information about the stream.
         name: name of the stream.
@@ -2915,7 +3399,7 @@ def xinfo_stream(self, name, full=False):
             options = {"full": full}
         return self.execute_command("XINFO STREAM", *pieces, **options)
 
-    def xlen(self, name):
+    def xlen(self, name: KeyT) -> ResponseT:
         """
         Returns the number of elements in a given stream.
 
@@ -2923,7 +3407,7 @@ def xlen(self, name):
         """
         return self.execute_command("XLEN", name)
 
-    def xpending(self, name, groupname):
+    def xpending(self, name: KeyT, groupname: GroupT) -> ResponseT:
         """
         Returns information about pending messages of a group.
         name: name of the stream.
@@ -2935,14 +3419,14 @@ def xpending(self, name, groupname):
 
     def xpending_range(
         self,
-        name,
-        groupname,
-        idle=None,
-        min=None,
-        max=None,
-        count=None,
-        consumername=None,
-    ):
+        name: KeyT,
+        groupname: GroupT,
+        min: StreamIdT,
+        max: StreamIdT,
+        count: int,
+        consumername: Union[ConsumerT, None] = None,
+        idle: Union[int, None] = None,
+    ) -> ResponseT:
         """
         Returns information about pending messages, in a range.
 
@@ -2990,7 +3474,13 @@ def xpending_range(
 
         return self.execute_command("XPENDING", *pieces, parse_detail=True)
 
-    def xrange(self, name, min="-", max="+", count=None):
+    def xrange(
+        self,
+        name: KeyT,
+        min: StreamIdT = "-",
+        max: StreamIdT = "+",
+        count: Union[int, None] = None,
+    ) -> ResponseT:
         """
         Read stream values within an interval.
         name: name of the stream.
@@ -3012,7 +3502,12 @@ def xrange(self, name, min="-", max="+", count=None):
 
         return self.execute_command("XRANGE", name, *pieces)
 
-    def xread(self, streams, count=None, block=None):
+    def xread(
+        self,
+        streams: Dict[KeyT, StreamIdT],
+        count: Union[int, None] = None,
+        block: Union[int, None] = None,
+    ) -> ResponseT:
         """
         Block and monitor multiple streams for new data.
         streams: a dict of stream names to stream IDs, where
@@ -3043,8 +3538,14 @@ def xread(self, streams, count=None, block=None):
         return self.execute_command("XREAD", *pieces)
 
     def xreadgroup(
-        self, groupname, consumername, streams, count=None, block=None, noack=False
-    ):
+        self,
+        groupname: str,
+        consumername: str,
+        streams: Dict[KeyT, StreamIdT],
+        count: Union[int, None] = None,
+        block: Union[int, None] = None,
+        noack: bool = False,
+    ) -> ResponseT:
         """
         Read from a stream via a consumer group.
         groupname: name of the consumer group.
@@ -3058,7 +3559,7 @@ def xreadgroup(
 
         For more information check https://redis.io/commands/xreadgroup
         """
-        pieces = [b"GROUP", groupname, consumername]
+        pieces: list[EncodableT] = [b"GROUP", groupname, consumername]
         if count is not None:
             if not isinstance(count, int) or count < 1:
                 raise DataError("XREADGROUP count must be a positive integer")
@@ -3078,7 +3579,13 @@ def xreadgroup(
         pieces.extend(streams.values())
         return self.execute_command("XREADGROUP", *pieces)
 
-    def xrevrange(self, name, max="+", min="-", count=None):
+    def xrevrange(
+        self,
+        name: KeyT,
+        max: StreamIdT = "+",
+        min: StreamIdT = "-",
+        count: Union[int, None] = None,
+    ) -> ResponseT:
         """
         Read stream values within an interval, in reverse order.
         name: name of the stream
@@ -3091,7 +3598,7 @@ def xrevrange(self, name, max="+", min="-", count=None):
 
         For more information check https://redis.io/commands/xrevrange
         """
-        pieces = [max, min]
+        pieces: list[EncodableT] = [max, min]
         if count is not None:
             if not isinstance(count, int) or count < 1:
                 raise DataError("XREVRANGE count must be a positive integer")
@@ -3100,7 +3607,14 @@ def xrevrange(self, name, max="+", min="-", count=None):
 
         return self.execute_command("XREVRANGE", name, *pieces)
 
-    def xtrim(self, name, maxlen=None, approximate=True, minid=None, limit=None):
+    def xtrim(
+        self,
+        name: KeyT,
+        maxlen: int,
+        approximate: bool = True,
+        minid: Union[StreamIdT, None] = None,
+        limit: Union[int, None] = None,
+    ) -> ResponseT:
         """
         Trims old messages from a stream.
         name: name of the stream.
@@ -3113,7 +3627,7 @@ def xtrim(self, name, maxlen=None, approximate=True, minid=None, limit=None):
 
         For more information check https://redis.io/commands/xtrim
         """
-        pieces = []
+        pieces: list[EncodableT] = []
         if maxlen is not None and minid is not None:
             raise DataError("Only one of ``maxlen`` or ``minid`` " "may be specified")
 
@@ -3134,15 +3648,26 @@ def xtrim(self, name, maxlen=None, approximate=True, minid=None, limit=None):
         return self.execute_command("XTRIM", name, *pieces)
 
 
-class SortedSetCommands:
+AsyncStreamCommands = StreamCommands
+
+
+class SortedSetCommands(CommandsProtocol):
     """
     Redis commands for Sorted Sets data type.
     see: https://redis.io/topics/data-types-intro#redis-sorted-sets
     """
 
     def zadd(
-        self, name, mapping, nx=False, xx=False, ch=False, incr=False, gt=None, lt=None
-    ):
+        self,
+        name: KeyT,
+        mapping: Mapping[AnyKeyT, EncodableT],
+        nx: bool = False,
+        xx: bool = False,
+        ch: bool = False,
+        incr: bool = False,
+        gt: bool = None,
+        lt: bool = None,
+    ) -> ResponseT:
         """
         Set any number of element-name, score pairs to the key ``name``. Pairs
         are specified as a dict of element-names keys to score values.
@@ -3188,7 +3713,7 @@ def zadd(
         if nx is True and (gt is not None or lt is not None):
             raise DataError("Only one of 'nx', 'lt', or 'gr' may be defined.")
 
-        pieces = []
+        pieces: list[EncodableT] = []
         options = {}
         if nx:
             pieces.append(b"NX")
@@ -3208,7 +3733,7 @@ def zadd(
             pieces.append(pair[0])
         return self.execute_command("ZADD", name, *pieces, **options)
 
-    def zcard(self, name):
+    def zcard(self, name: KeyT):
         """
         Return the number of elements in the sorted set ``name``
 
@@ -3216,7 +3741,7 @@ def zcard(self, name):
         """
         return self.execute_command("ZCARD", name)
 
-    def zcount(self, name, min, max):
+    def zcount(self, name: KeyT, min: ZScoreBoundT, max: ZScoreBoundT) -> ResponseT:
         """
         Returns the number of elements in the sorted set at key ``name`` with
         a score between ``min`` and ``max``.
@@ -3225,7 +3750,7 @@ def zcount(self, name, min, max):
         """
         return self.execute_command("ZCOUNT", name, min, max)
 
-    def zdiff(self, keys, withscores=False):
+    def zdiff(self, keys: KeysT, withscores: bool = False) -> ResponseT:
         """
         Returns the difference between the first and all successive input
         sorted sets provided in ``keys``.
@@ -3237,7 +3762,7 @@ def zdiff(self, keys, withscores=False):
             pieces.append("WITHSCORES")
         return self.execute_command("ZDIFF", *pieces)
 
-    def zdiffstore(self, dest, keys):
+    def zdiffstore(self, dest: KeyT, keys: KeysT) -> ResponseT:
         """
         Computes the difference between the first and all successive input
         sorted sets provided in ``keys`` and stores the result in ``dest``.
@@ -3247,7 +3772,12 @@ def zdiffstore(self, dest, keys):
         pieces = [len(keys), *keys]
         return self.execute_command("ZDIFFSTORE", dest, *pieces)
 
-    def zincrby(self, name, amount, value):
+    def zincrby(
+        self,
+        name: KeyT,
+        amount: float,
+        value: EncodableT,
+    ) -> ResponseT:
         """
         Increment the score of ``value`` in sorted set ``name`` by ``amount``
 
@@ -3255,7 +3785,12 @@ def zincrby(self, name, amount, value):
         """
         return self.execute_command("ZINCRBY", name, amount, value)
 
-    def zinter(self, keys, aggregate=None, withscores=False):
+    def zinter(
+        self,
+        keys: KeysT,
+        aggregate: Union[str, None] = None,
+        withscores: bool = False,
+    ) -> ResponseT:
         """
         Return the intersect of multiple sorted sets specified by ``keys``.
         With the ``aggregate`` option, it is possible to specify how the
@@ -3269,7 +3804,12 @@ def zinter(self, keys, aggregate=None, withscores=False):
         """
         return self._zaggregate("ZINTER", None, keys, aggregate, withscores=withscores)
 
-    def zinterstore(self, dest, keys, aggregate=None):
+    def zinterstore(
+        self,
+        dest: KeyT,
+        keys: Union[Sequence[KeyT], Mapping[AnyKeyT, float]],
+        aggregate: Union[str, None] = None,
+    ) -> ResponseT:
         """
         Intersect multiple sorted sets specified by ``keys`` into a new
         sorted set, ``dest``. Scores in the destination will be aggregated
@@ -3305,7 +3845,11 @@ def zlexcount(self, name, min, max):
         """
         return self.execute_command("ZLEXCOUNT", name, min, max)
 
-    def zpopmax(self, name, count=None):
+    def zpopmax(
+        self,
+        name: KeyT,
+        count: Union[int, None] = None,
+    ) -> ResponseT:
         """
         Remove and return up to ``count`` members with the highest scores
         from the sorted set ``name``.
@@ -3316,7 +3860,11 @@ def zpopmax(self, name, count=None):
         options = {"withscores": True}
         return self.execute_command("ZPOPMAX", name, *args, **options)
 
-    def zpopmin(self, name, count=None):
+    def zpopmin(
+        self,
+        name: KeyT,
+        count: Union[int, None] = None,
+    ) -> ResponseT:
         """
         Remove and return up to ``count`` members with the lowest scores
         from the sorted set ``name``.
@@ -3327,7 +3875,12 @@ def zpopmin(self, name, count=None):
         options = {"withscores": True}
         return self.execute_command("ZPOPMIN", name, *args, **options)
 
-    def zrandmember(self, key, count=None, withscores=False):
+    def zrandmember(
+        self,
+        key: KeyT,
+        count: int = None,
+        withscores: bool = False,
+    ) -> ResponseT:
         """
         Return a random element from the sorted set value stored at key.
 
@@ -3351,7 +3904,7 @@ def zrandmember(self, key, count=None, withscores=False):
 
         return self.execute_command("ZRANDMEMBER", key, *params)
 
-    def bzpopmax(self, keys, timeout=0):
+    def bzpopmax(self, keys: KeysT, timeout: TimeoutSecT = 0) -> ResponseT:
         """
         ZPOPMAX a value off of the first non-empty sorted set
         named in the ``keys`` list.
@@ -3370,7 +3923,7 @@ def bzpopmax(self, keys, timeout=0):
         keys.append(timeout)
         return self.execute_command("BZPOPMAX", *keys)
 
-    def bzpopmin(self, keys, timeout=0):
+    def bzpopmin(self, keys: KeysT, timeout: TimeoutSecT = 0) -> ResponseT:
         """
         ZPOPMIN a value off of the first non-empty sorted set
         named in the ``keys`` list.
@@ -3385,7 +3938,7 @@ def bzpopmin(self, keys, timeout=0):
         """
         if timeout is None:
             timeout = 0
-        keys = list_or_args(keys, None)
+        keys: list[EncodableT] = list_or_args(keys, None)
         keys.append(timeout)
         return self.execute_command("BZPOPMIN", *keys)
 
@@ -3449,18 +4002,18 @@ def bzmpop(
     def _zrange(
         self,
         command,
-        dest,
-        name,
-        start,
-        end,
-        desc=False,
-        byscore=False,
-        bylex=False,
-        withscores=False,
-        score_cast_func=float,
-        offset=None,
-        num=None,
-    ):
+        dest: Union[KeyT, None],
+        name: KeyT,
+        start: int,
+        end: int,
+        desc: bool = False,
+        byscore: bool = False,
+        bylex: bool = False,
+        withscores: bool = False,
+        score_cast_func: Union[type, Callable, None] = float,
+        offset: Union[int, None] = None,
+        num: Union[int, None] = None,
+    ) -> ResponseT:
         if byscore and bylex:
             raise DataError(
                 "``byscore`` and ``bylex`` can not be " "specified together."
@@ -3490,17 +4043,17 @@ def _zrange(
 
     def zrange(
         self,
-        name,
-        start,
-        end,
-        desc=False,
-        withscores=False,
-        score_cast_func=float,
-        byscore=False,
-        bylex=False,
-        offset=None,
-        num=None,
-    ):
+        name: KeyT,
+        start: int,
+        end: int,
+        desc: bool = False,
+        withscores: bool = False,
+        score_cast_func: Union[type, Callable] = float,
+        byscore: bool = False,
+        bylex: bool = False,
+        offset: int = None,
+        num: int = None,
+    ) -> ResponseT:
         """
         Return a range of values from sorted set ``name`` between
         ``start`` and ``end`` sorted in ascending order.
@@ -3549,7 +4102,14 @@ def zrange(
             num,
         )
 
-    def zrevrange(self, name, start, end, withscores=False, score_cast_func=float):
+    def zrevrange(
+        self,
+        name: KeyT,
+        start: int,
+        end: int,
+        withscores: bool = False,
+        score_cast_func: Union[type, Callable] = float,
+    ) -> ResponseT:
         """
         Return a range of values from sorted set ``name`` between
         ``start`` and ``end`` sorted in descending order.
@@ -3571,16 +4131,16 @@ def zrevrange(self, name, start, end, withscores=False, score_cast_func=float):
 
     def zrangestore(
         self,
-        dest,
-        name,
-        start,
-        end,
-        byscore=False,
-        bylex=False,
-        desc=False,
-        offset=None,
-        num=None,
-    ):
+        dest: KeyT,
+        name: KeyT,
+        start: int,
+        end: int,
+        byscore: bool = False,
+        bylex: bool = False,
+        desc: bool = False,
+        offset: Union[int, None] = None,
+        num: Union[int, None] = None,
+    ) -> ResponseT:
         """
         Stores in ``dest`` the result of a range of values from sorted set
         ``name`` between ``start`` and ``end`` sorted in ascending order.
@@ -3619,7 +4179,14 @@ def zrangestore(
             num,
         )
 
-    def zrangebylex(self, name, min, max, start=None, num=None):
+    def zrangebylex(
+        self,
+        name: KeyT,
+        min: EncodableT,
+        max: EncodableT,
+        start: Union[int, None] = None,
+        num: Union[int, None] = None,
+    ) -> ResponseT:
         """
         Return the lexicographical range of values from sorted set ``name``
         between ``min`` and ``max``.
@@ -3636,7 +4203,14 @@ def zrangebylex(self, name, min, max, start=None, num=None):
             pieces.extend([b"LIMIT", start, num])
         return self.execute_command(*pieces)
 
-    def zrevrangebylex(self, name, max, min, start=None, num=None):
+    def zrevrangebylex(
+        self,
+        name: KeyT,
+        max: EncodableT,
+        min: EncodableT,
+        start: Union[int, None] = None,
+        num: Union[int, None] = None,
+    ) -> ResponseT:
         """
         Return the reversed lexicographical range of values from sorted set
         ``name`` between ``max`` and ``min``.
@@ -3655,14 +4229,14 @@ def zrevrangebylex(self, name, max, min, start=None, num=None):
 
     def zrangebyscore(
         self,
-        name,
-        min,
-        max,
-        start=None,
-        num=None,
-        withscores=False,
-        score_cast_func=float,
-    ):
+        name: KeyT,
+        min: ZScoreBoundT,
+        max: ZScoreBoundT,
+        start: Union[int, None] = None,
+        num: Union[int, None] = None,
+        withscores: bool = False,
+        score_cast_func: Union[type, Callable] = float,
+    ) -> ResponseT:
         """
         Return a range of values from the sorted set ``name`` with scores
         between ``min`` and ``max``.
@@ -3689,13 +4263,13 @@ def zrangebyscore(
 
     def zrevrangebyscore(
         self,
-        name,
-        max,
-        min,
-        start=None,
-        num=None,
-        withscores=False,
-        score_cast_func=float,
+        name: KeyT,
+        max: ZScoreBoundT,
+        min: ZScoreBoundT,
+        start: Union[int, None] = None,
+        num: Union[int, None] = None,
+        withscores: bool = False,
+        score_cast_func: Union[type, Callable] = float,
     ):
         """
         Return a range of values from the sorted set ``name`` with scores
@@ -3721,7 +4295,7 @@ def zrevrangebyscore(
         options = {"withscores": withscores, "score_cast_func": score_cast_func}
         return self.execute_command(*pieces, **options)
 
-    def zrank(self, name, value):
+    def zrank(self, name: KeyT, value: EncodableT) -> ResponseT:
         """
         Returns a 0-based value indicating the rank of ``value`` in sorted set
         ``name``
@@ -3730,7 +4304,7 @@ def zrank(self, name, value):
         """
         return self.execute_command("ZRANK", name, value)
 
-    def zrem(self, name, *values):
+    def zrem(self, name: KeyT, *values: EncodableT) -> ResponseT:
         """
         Remove member ``values`` from sorted set ``name``
 
@@ -3738,7 +4312,7 @@ def zrem(self, name, *values):
         """
         return self.execute_command("ZREM", name, *values)
 
-    def zremrangebylex(self, name, min, max):
+    def zremrangebylex(self, name: KeyT, min: EncodableT, max: EncodableT) -> ResponseT:
         """
         Remove all elements in the sorted set ``name`` between the
         lexicographical range specified by ``min`` and ``max``.
@@ -3749,7 +4323,7 @@ def zremrangebylex(self, name, min, max):
         """
         return self.execute_command("ZREMRANGEBYLEX", name, min, max)
 
-    def zremrangebyrank(self, name, min, max):
+    def zremrangebyrank(self, name: KeyT, min: int, max: int) -> ResponseT:
         """
         Remove all elements in the sorted set ``name`` with ranks between
         ``min`` and ``max``. Values are 0-based, ordered from smallest score
@@ -3760,7 +4334,9 @@ def zremrangebyrank(self, name, min, max):
         """
         return self.execute_command("ZREMRANGEBYRANK", name, min, max)
 
-    def zremrangebyscore(self, name, min, max):
+    def zremrangebyscore(
+        self, name: KeyT, min: ZScoreBoundT, max: ZScoreBoundT
+    ) -> ResponseT:
         """
         Remove all elements in the sorted set ``name`` with scores
         between ``min`` and ``max``. Returns the number of elements removed.
@@ -3769,7 +4345,7 @@ def zremrangebyscore(self, name, min, max):
         """
         return self.execute_command("ZREMRANGEBYSCORE", name, min, max)
 
-    def zrevrank(self, name, value):
+    def zrevrank(self, name: KeyT, value: EncodableT) -> ResponseT:
         """
         Returns a 0-based value indicating the descending rank of
         ``value`` in sorted set ``name``
@@ -3778,7 +4354,7 @@ def zrevrank(self, name, value):
         """
         return self.execute_command("ZREVRANK", name, value)
 
-    def zscore(self, name, value):
+    def zscore(self, name: KeyT, value: EncodableT) -> ResponseT:
         """
         Return the score of element ``value`` in sorted set ``name``
 
@@ -3786,7 +4362,12 @@ def zscore(self, name, value):
         """
         return self.execute_command("ZSCORE", name, value)
 
-    def zunion(self, keys, aggregate=None, withscores=False):
+    def zunion(
+        self,
+        keys: Union[Sequence[KeyT], Mapping[AnyKeyT, float]],
+        aggregate: Union[str, None] = None,
+        withscores: bool = False,
+    ) -> ResponseT:
         """
         Return the union of multiple sorted sets specified by ``keys``.
         ``keys`` can be provided as dictionary of keys and their weights.
@@ -3797,7 +4378,12 @@ def zunion(self, keys, aggregate=None, withscores=False):
         """
         return self._zaggregate("ZUNION", None, keys, aggregate, withscores=withscores)
 
-    def zunionstore(self, dest, keys, aggregate=None):
+    def zunionstore(
+        self,
+        dest: KeyT,
+        keys: Union[Sequence[KeyT], Mapping[AnyKeyT, float]],
+        aggregate: Union[str, None] = None,
+    ) -> ResponseT:
         """
         Union multiple sorted sets specified by ``keys`` into
         a new sorted set, ``dest``. Scores in the destination will be
@@ -3807,7 +4393,11 @@ def zunionstore(self, dest, keys, aggregate=None):
         """
         return self._zaggregate("ZUNIONSTORE", dest, keys, aggregate)
 
-    def zmscore(self, key, members):
+    def zmscore(
+        self,
+        key: KeyT,
+        members: List[str],
+    ) -> ResponseT:
         """
         Returns the scores associated with the specified members
         in the sorted set stored at key.
@@ -3823,8 +4413,15 @@ def zmscore(self, key, members):
         pieces = [key] + members
         return self.execute_command("ZMSCORE", *pieces)
 
-    def _zaggregate(self, command, dest, keys, aggregate=None, **options):
-        pieces = [command]
+    def _zaggregate(
+        self,
+        command: str,
+        dest: Union[KeyT, None],
+        keys: Union[Sequence[KeyT], Mapping[AnyKeyT, float]],
+        aggregate: Union[str, None] = None,
+        **options,
+    ) -> ResponseT:
+        pieces: list[EncodableT] = [command]
         if dest is not None:
             pieces.append(dest)
         pieces.append(len(keys))
@@ -3847,13 +4444,16 @@ def _zaggregate(self, command, dest, keys, aggregate=None, **options):
         return self.execute_command(*pieces, **options)
 
 
-class HyperlogCommands:
+AsyncSortedSetCommands = SortedSetCommands
+
+
+class HyperlogCommands(CommandsProtocol):
     """
     Redis commands of HyperLogLogs data type.
     see: https://redis.io/topics/data-types-intro#hyperloglogs
     """
 
-    def pfadd(self, name, *values):
+    def pfadd(self, name: KeyT, *values: EncodableT) -> ResponseT:
         """
         Adds the specified elements to the specified HyperLogLog.
 
@@ -3861,7 +4461,7 @@ def pfadd(self, name, *values):
         """
         return self.execute_command("PFADD", name, *values)
 
-    def pfcount(self, *sources):
+    def pfcount(self, *sources: KeyT) -> ResponseT:
         """
         Return the approximated cardinality of
         the set observed by the HyperLogLog at key(s).
@@ -3870,7 +4470,7 @@ def pfcount(self, *sources):
         """
         return self.execute_command("PFCOUNT", *sources)
 
-    def pfmerge(self, dest, *sources):
+    def pfmerge(self, dest: KeyT, *sources: KeyT) -> ResponseT:
         """
         Merge N different HyperLogLogs into a single one.
 
@@ -3879,7 +4479,10 @@ def pfmerge(self, dest, *sources):
         return self.execute_command("PFMERGE", dest, *sources)
 
 
-class HashCommands:
+AsyncHyperlogCommands = HyperlogCommands
+
+
+class HashCommands(CommandsProtocol):
     """
     Redis commands for Hash data type.
     see: https://redis.io/topics/data-types-intro#redis-hashes
@@ -4031,13 +4634,106 @@ def hstrlen(self, name: str, key: str) -> int:
         return self.execute_command("HSTRLEN", name, key)
 
 
-class PubSubCommands:
+AsyncHashCommands = HashCommands
+
+
+class Script:
+    """
+    An executable Lua script object returned by ``register_script``
+    """
+
+    def __init__(self, registered_client: "Redis", script: ScriptTextT):
+        self.registered_client = registered_client
+        self.script = script
+        # Precalculate and store the SHA1 hex digest of the script.
+
+        if isinstance(script, str):
+            # We need the encoding from the client in order to generate an
+            # accurate byte representation of the script
+            encoder = registered_client.connection_pool.get_encoder()
+            script = encoder.encode(script)
+        self.sha = hashlib.sha1(script).hexdigest()
+
+    def __call__(
+        self,
+        keys: Union[Sequence[KeyT], None] = None,
+        args: Union[Iterable[EncodableT], None] = None,
+        client: Union["Redis", None] = None,
+    ):
+        """Execute the script, passing any required ``args``"""
+        keys = keys or []
+        args = args or []
+        if client is None:
+            client = self.registered_client
+        args = tuple(keys) + tuple(args)
+        # make sure the Redis server knows about the script
+        from redis.client import Pipeline
+
+        if isinstance(client, Pipeline):
+            # Make sure the pipeline can register the script before executing.
+            client.scripts.add(self)
+        try:
+            return client.evalsha(self.sha, len(keys), *args)
+        except NoScriptError:
+            # Maybe the client is pointed to a different server than the client
+            # that created this instance?
+            # Overwrite the sha just in case there was a discrepancy.
+            self.sha = client.script_load(self.script)
+            return client.evalsha(self.sha, len(keys), *args)
+
+
+class AsyncScript:
+    """
+    An executable Lua script object returned by ``register_script``
+    """
+
+    def __init__(self, registered_client: "AsyncRedis", script: ScriptTextT):
+        self.registered_client = registered_client
+        self.script = script
+        # Precalculate and store the SHA1 hex digest of the script.
+
+        if isinstance(script, str):
+            # We need the encoding from the client in order to generate an
+            # accurate byte representation of the script
+            encoder = registered_client.connection_pool.get_encoder()
+            script = encoder.encode(script)
+        self.sha = hashlib.sha1(script).hexdigest()
+
+    async def __call__(
+        self,
+        keys: Union[Sequence[KeyT], None] = None,
+        args: Union[Iterable[EncodableT], None] = None,
+        client: Union["AsyncRedis", None] = None,
+    ):
+        """Execute the script, passing any required ``args``"""
+        keys = keys or []
+        args = args or []
+        if client is None:
+            client = self.registered_client
+        args = tuple(keys) + tuple(args)
+        # make sure the Redis server knows about the script
+        from redis.asyncio.client import Pipeline
+
+        if isinstance(client, Pipeline):
+            # Make sure the pipeline can register the script before executing.
+            client.scripts.add(self)
+        try:
+            return await client.evalsha(self.sha, len(keys), *args)
+        except NoScriptError:
+            # Maybe the client is pointed to a different server than the client
+            # that created this instance?
+            # Overwrite the sha just in case there was a discrepancy.
+            self.sha = await client.script_load(self.script)
+            return await client.evalsha(self.sha, len(keys), *args)
+
+
+class PubSubCommands(CommandsProtocol):
     """
     Redis PubSub commands.
     see https://redis.io/topics/pubsub
     """
 
-    def publish(self, channel, message, **kwargs):
+    def publish(self, channel: ChannelT, message: EncodableT, **kwargs) -> ResponseT:
         """
         Publish ``message`` on ``channel``.
         Returns the number of subscribers the message was delivered to.
@@ -4046,7 +4742,7 @@ def publish(self, channel, message, **kwargs):
         """
         return self.execute_command("PUBLISH", channel, message, **kwargs)
 
-    def pubsub_channels(self, pattern="*", **kwargs):
+    def pubsub_channels(self, pattern: PatternT = "*", **kwargs) -> ResponseT:
         """
         Return a list of channels that have at least one subscriber
 
@@ -4054,7 +4750,7 @@ def pubsub_channels(self, pattern="*", **kwargs):
         """
         return self.execute_command("PUBSUB CHANNELS", pattern, **kwargs)
 
-    def pubsub_numpat(self, **kwargs):
+    def pubsub_numpat(self, **kwargs) -> ResponseT:
         """
         Returns the number of subscriptions to patterns
 
@@ -4062,7 +4758,7 @@ def pubsub_numpat(self, **kwargs):
         """
         return self.execute_command("PUBSUB NUMPAT", **kwargs)
 
-    def pubsub_numsub(self, *args, **kwargs):
+    def pubsub_numsub(self, *args: ChannelT, **kwargs) -> ResponseT:
         """
         Return a list of (channel, number of subscribers) tuples
         for each channel given in ``*args``
@@ -4072,7 +4768,10 @@ def pubsub_numsub(self, *args, **kwargs):
         return self.execute_command("PUBSUB NUMSUB", *args, **kwargs)
 
 
-class ScriptCommands:
+AsyncPubSubCommands = PubSubCommands
+
+
+class ScriptCommands(CommandsProtocol):
     """
     Redis Lua script commands. see:
     https://redis.com/ebook/part-3-next-steps/chapter-11-scripting-redis-with-lua/
@@ -4140,7 +4839,7 @@ def evalsha_ro(self, sha: str, numkeys: int, *keys_and_args: list) -> str:
         """
         return self._evalsha("EVALSHA_RO", sha, numkeys, *keys_and_args)
 
-    def script_exists(self, *args):
+    def script_exists(self, *args: str):
         """
         Check if a script exists in the script cache by specifying the SHAs of
         each script as ``args``. Returns a list of boolean values indicating if
@@ -4150,12 +4849,14 @@ def script_exists(self, *args):
         """
         return self.execute_command("SCRIPT EXISTS", *args)
 
-    def script_debug(self, *args):
+    def script_debug(self, *args) -> None:
         raise NotImplementedError(
             "SCRIPT DEBUG is intentionally not implemented in the client."
         )
 
-    def script_flush(self, sync_type=None):
+    def script_flush(
+        self, sync_type: Union[Literal["SYNC"], Literal["ASYNC"]] = None
+    ) -> ResponseT:
         """Flush all scripts from the script cache.
         ``sync_type`` is by default SYNC (synchronous) but it can also be
                       ASYNC.
@@ -4175,7 +4876,7 @@ def script_flush(self, sync_type=None):
             pieces = [sync_type]
         return self.execute_command("SCRIPT FLUSH", *pieces)
 
-    def script_kill(self):
+    def script_kill(self) -> ResponseT:
         """
         Kill the currently executing Lua script
 
@@ -4183,7 +4884,7 @@ def script_kill(self):
         """
         return self.execute_command("SCRIPT KILL")
 
-    def script_load(self, script):
+    def script_load(self, script: ScriptTextT) -> ResponseT:
         """
         Load a Lua ``script`` into the script cache. Returns the SHA.
 
@@ -4191,7 +4892,7 @@ def script_load(self, script):
         """
         return self.execute_command("SCRIPT LOAD", script)
 
-    def register_script(self, script):
+    def register_script(self: "Redis", script: ScriptTextT) -> Script:
         """
         Register a Lua ``script`` specifying the ``keys`` it will touch.
         Returns a Script object that is callable and hides the complexity of
@@ -4201,13 +4902,34 @@ def register_script(self, script):
         return Script(self, script)
 
 
-class GeoCommands:
+class AsyncScriptCommands(ScriptCommands):
+    async def script_debug(self, *args) -> None:
+        return super().script_debug()
+
+    def register_script(self: "AsyncRedis", script: ScriptTextT) -> AsyncScript:
+        """
+        Register a Lua ``script`` specifying the ``keys`` it will touch.
+        Returns a Script object that is callable and hides the complexity of
+        deal with scripts, keys, and shas. This is the preferred way to work
+        with Lua scripts.
+        """
+        return AsyncScript(self, script)
+
+
+class GeoCommands(CommandsProtocol):
     """
     Redis Geospatial commands.
     see: https://redis.com/redis-best-practices/indexing-patterns/geospatial/
     """
 
-    def geoadd(self, name, values, nx=False, xx=False, ch=False):
+    def geoadd(
+        self,
+        name: KeyT,
+        values: Sequence[EncodableT],
+        nx: bool = False,
+        xx: bool = False,
+        ch: bool = False,
+    ) -> ResponseT:
         """
         Add the specified geospatial items to the specified key identified
         by the ``name`` argument. The Geospatial items are given as ordered
@@ -4242,7 +4964,13 @@ def geoadd(self, name, values, nx=False, xx=False, ch=False):
         pieces.extend(values)
         return self.execute_command("GEOADD", *pieces)
 
-    def geodist(self, name, place1, place2, unit=None):
+    def geodist(
+        self,
+        name: KeyT,
+        place1: FieldT,
+        place2: FieldT,
+        unit: Union[str, None] = None,
+    ) -> ResponseT:
         """
         Return the distance between ``place1`` and ``place2`` members of the
         ``name`` key.
@@ -4251,14 +4979,14 @@ def geodist(self, name, place1, place2, unit=None):
 
         For more information check https://redis.io/commands/geodist
         """
-        pieces = [name, place1, place2]
+        pieces: list[EncodableT] = [name, place1, place2]
         if unit and unit not in ("m", "km", "mi", "ft"):
             raise DataError("GEODIST invalid unit")
         elif unit:
             pieces.append(unit)
         return self.execute_command("GEODIST", *pieces)
 
-    def geohash(self, name, *values):
+    def geohash(self, name: KeyT, *values: FieldT) -> ResponseT:
         """
         Return the geo hash string for each item of ``values`` members of
         the specified key identified by the ``name`` argument.
@@ -4267,7 +4995,7 @@ def geohash(self, name, *values):
         """
         return self.execute_command("GEOHASH", name, *values)
 
-    def geopos(self, name, *values):
+    def geopos(self, name: KeyT, *values: FieldT) -> ResponseT:
         """
         Return the positions of each item of ``values`` as members of
         the specified key identified by the ``name`` argument. Each position
@@ -4279,20 +5007,20 @@ def geopos(self, name, *values):
 
     def georadius(
         self,
-        name,
-        longitude,
-        latitude,
-        radius,
-        unit=None,
-        withdist=False,
-        withcoord=False,
-        withhash=False,
-        count=None,
-        sort=None,
-        store=None,
-        store_dist=None,
-        any=False,
-    ):
+        name: KeyT,
+        longitude: float,
+        latitude: float,
+        radius: float,
+        unit: Union[str, None] = None,
+        withdist: bool = False,
+        withcoord: bool = False,
+        withhash: bool = False,
+        count: Union[int, None] = None,
+        sort: Union[str, None] = None,
+        store: Union[KeyT, None] = None,
+        store_dist: Union[KeyT, None] = None,
+        any: bool = False,
+    ) -> ResponseT:
         """
         Return the members of the specified key identified by the
         ``name`` argument which are within the borders of the area specified
@@ -4342,19 +5070,19 @@ def georadius(
 
     def georadiusbymember(
         self,
-        name,
-        member,
-        radius,
-        unit=None,
-        withdist=False,
-        withcoord=False,
-        withhash=False,
-        count=None,
-        sort=None,
-        store=None,
-        store_dist=None,
-        any=False,
-    ):
+        name: KeyT,
+        member: FieldT,
+        radius: float,
+        unit: Union[str, None] = None,
+        withdist: bool = False,
+        withcoord: bool = False,
+        withhash: bool = False,
+        count: Union[int, None] = None,
+        sort: Union[str, None] = None,
+        store: Union[KeyT, None] = None,
+        store_dist: Union[KeyT, None] = None,
+        any: bool = False,
+    ) -> ResponseT:
         """
         This command is exactly like ``georadius`` with the sole difference
         that instead of taking, as the center of the area to query, a longitude
@@ -4379,7 +5107,12 @@ def georadiusbymember(
             any=any,
         )
 
-    def _georadiusgeneric(self, command, *args, **kwargs):
+    def _georadiusgeneric(
+        self,
+        command: str,
+        *args: EncodableT,
+        **kwargs: Union[EncodableT, None],
+    ) -> ResponseT:
         pieces = list(args)
         if kwargs["unit"] and kwargs["unit"] not in ("m", "km", "mi", "ft"):
             raise DataError("GEORADIUS invalid unit")
@@ -4427,21 +5160,21 @@ def _georadiusgeneric(self, command, *args, **kwargs):
 
     def geosearch(
         self,
-        name,
-        member=None,
-        longitude=None,
-        latitude=None,
-        unit="m",
-        radius=None,
-        width=None,
-        height=None,
-        sort=None,
-        count=None,
-        any=False,
-        withcoord=False,
-        withdist=False,
-        withhash=False,
-    ):
+        name: KeyT,
+        member: Union[FieldT, None] = None,
+        longitude: Union[float, None] = None,
+        latitude: Union[float, None] = None,
+        unit: str = "m",
+        radius: Union[float, None] = None,
+        width: Union[float, None] = None,
+        height: Union[float, None] = None,
+        sort: Union[str, None] = None,
+        count: Union[int, None] = None,
+        any: bool = False,
+        withcoord: bool = False,
+        withdist: bool = False,
+        withhash: bool = False,
+    ) -> ResponseT:
         """
         Return the members of specified key identified by the
         ``name`` argument, which are within the borders of the
@@ -4499,20 +5232,20 @@ def geosearch(
 
     def geosearchstore(
         self,
-        dest,
-        name,
-        member=None,
-        longitude=None,
-        latitude=None,
-        unit="m",
-        radius=None,
-        width=None,
-        height=None,
-        sort=None,
-        count=None,
-        any=False,
-        storedist=False,
-    ):
+        dest: KeyT,
+        name: KeyT,
+        member: Union[FieldT, None] = None,
+        longitude: Union[float, None] = None,
+        latitude: Union[float, None] = None,
+        unit: str = "m",
+        radius: Union[float, None] = None,
+        width: Union[float, None] = None,
+        height: Union[float, None] = None,
+        sort: Union[str, None] = None,
+        count: Union[int, None] = None,
+        any: bool = False,
+        storedist: bool = False,
+    ) -> ResponseT:
         """
         This command is like GEOSEARCH, but stores the result in
         ``dest``. By default, it stores the results in the destination
@@ -4544,7 +5277,12 @@ def geosearchstore(
             store_dist=storedist,
         )
 
-    def _geosearchgeneric(self, command, *args, **kwargs):
+    def _geosearchgeneric(
+        self,
+        command: str,
+        *args: EncodableT,
+        **kwargs: Union[EncodableT, None],
+    ) -> ResponseT:
         pieces = list(args)
 
         # FROMMEMBER or FROMLONLAT
@@ -4609,13 +5347,16 @@ def _geosearchgeneric(self, command, *args, **kwargs):
         return self.execute_command(command, *pieces, **kwargs)
 
 
-class ModuleCommands:
+AsyncGeoCommands = GeoCommands
+
+
+class ModuleCommands(CommandsProtocol):
     """
     Redis Module commands.
     see: https://redis.io/topics/modules-intro
     """
 
-    def module_load(self, path, *args):
+    def module_load(self, path, *args) -> ResponseT:
         """
         Loads the module from ``path``.
         Passes all ``*args`` to the module, during loading.
@@ -4625,7 +5366,7 @@ def module_load(self, path, *args):
         """
         return self.execute_command("MODULE LOAD", path, *args)
 
-    def module_unload(self, name):
+    def module_unload(self, name) -> ResponseT:
         """
         Unloads the module ``name``.
         Raises ``ModuleError`` if ``name`` is not in loaded modules.
@@ -4634,7 +5375,7 @@ def module_unload(self, name):
         """
         return self.execute_command("MODULE UNLOAD", name)
 
-    def module_list(self):
+    def module_list(self) -> ResponseT:
         """
         Returns a list of dictionaries containing the name and version of
         all loaded modules.
@@ -4643,166 +5384,35 @@ def module_list(self):
         """
         return self.execute_command("MODULE LIST")
 
-    def command_info(self):
+    def command_info(self) -> None:
         raise NotImplementedError(
             "COMMAND INFO is intentionally not implemented in the client."
         )
 
-    def command_count(self):
+    def command_count(self) -> ResponseT:
         return self.execute_command("COMMAND COUNT")
 
-    def command_getkeys(self, *args):
+    def command_getkeys(self, *args) -> ResponseT:
         return self.execute_command("COMMAND GETKEYS", *args)
 
-    def command(self):
+    def command(self) -> ResponseT:
         return self.execute_command("COMMAND")
 
 
-class Script:
-    """
-    An executable Lua script object returned by ``register_script``
-    """
-
-    def __init__(self, registered_client, script):
-        self.registered_client = registered_client
-        self.script = script
-        # Precalculate and store the SHA1 hex digest of the script.
-
-        if isinstance(script, str):
-            # We need the encoding from the client in order to generate an
-            # accurate byte representation of the script
-            encoder = registered_client.connection_pool.get_encoder()
-            script = encoder.encode(script)
-        self.sha = hashlib.sha1(script).hexdigest()
-
-    def __call__(self, keys=[], args=[], client=None):
-        "Execute the script, passing any required ``args``"
-        if client is None:
-            client = self.registered_client
-        args = tuple(keys) + tuple(args)
-        # make sure the Redis server knows about the script
-        from redis.client import Pipeline
-
-        if isinstance(client, Pipeline):
-            # Make sure the pipeline can register the script before executing.
-            client.scripts.add(self)
-        try:
-            return client.evalsha(self.sha, len(keys), *args)
-        except NoScriptError:
-            # Maybe the client is pointed to a different server than the client
-            # that created this instance?
-            # Overwrite the sha just in case there was a discrepancy.
-            self.sha = client.script_load(self.script)
-            return client.evalsha(self.sha, len(keys), *args)
-
-
-class BitFieldOperation:
-    """
-    Command builder for BITFIELD commands.
-    """
-
-    def __init__(self, client, key, default_overflow=None):
-        self.client = client
-        self.key = key
-        self._default_overflow = default_overflow
-        self.reset()
-
-    def reset(self):
-        """
-        Reset the state of the instance to when it was constructed
-        """
-        self.operations = []
-        self._last_overflow = "WRAP"
-        self.overflow(self._default_overflow or self._last_overflow)
-
-    def overflow(self, overflow):
-        """
-        Update the overflow algorithm of successive INCRBY operations
-        :param overflow: Overflow algorithm, one of WRAP, SAT, FAIL. See the
-            Redis docs for descriptions of these algorithmsself.
-        :returns: a :py:class:`BitFieldOperation` instance.
-        """
-        overflow = overflow.upper()
-        if overflow != self._last_overflow:
-            self._last_overflow = overflow
-            self.operations.append(("OVERFLOW", overflow))
-        return self
-
-    def incrby(self, fmt, offset, increment, overflow=None):
-        """
-        Increment a bitfield by a given amount.
-        :param fmt: format-string for the bitfield being updated, e.g. 'u8'
-            for an unsigned 8-bit integer.
-        :param offset: offset (in number of bits). If prefixed with a
-            '#', this is an offset multiplier, e.g. given the arguments
-            fmt='u8', offset='#2', the offset will be 16.
-        :param int increment: value to increment the bitfield by.
-        :param str overflow: overflow algorithm. Defaults to WRAP, but other
-            acceptable values are SAT and FAIL. See the Redis docs for
-            descriptions of these algorithms.
-        :returns: a :py:class:`BitFieldOperation` instance.
-        """
-        if overflow is not None:
-            self.overflow(overflow)
+class AsyncModuleCommands(ModuleCommands):
+    async def command_info(self) -> None:
+        return super().command_info()
 
-        self.operations.append(("INCRBY", fmt, offset, increment))
-        return self
 
-    def get(self, fmt, offset):
-        """
-        Get the value of a given bitfield.
-        :param fmt: format-string for the bitfield being read, e.g. 'u8' for
-            an unsigned 8-bit integer.
-        :param offset: offset (in number of bits). If prefixed with a
-            '#', this is an offset multiplier, e.g. given the arguments
-            fmt='u8', offset='#2', the offset will be 16.
-        :returns: a :py:class:`BitFieldOperation` instance.
-        """
-        self.operations.append(("GET", fmt, offset))
-        return self
-
-    def set(self, fmt, offset, value):
-        """
-        Set the value of a given bitfield.
-        :param fmt: format-string for the bitfield being read, e.g. 'u8' for
-            an unsigned 8-bit integer.
-        :param offset: offset (in number of bits). If prefixed with a
-            '#', this is an offset multiplier, e.g. given the arguments
-            fmt='u8', offset='#2', the offset will be 16.
-        :param int value: value to set at the given position.
-        :returns: a :py:class:`BitFieldOperation` instance.
-        """
-        self.operations.append(("SET", fmt, offset, value))
-        return self
-
-    @property
-    def command(self):
-        cmd = ["BITFIELD", self.key]
-        for ops in self.operations:
-            cmd.extend(ops)
-        return cmd
-
-    def execute(self):
-        """
-        Execute the operation(s) in a single BITFIELD command. The return value
-        is a list of values corresponding to each operation. If the client
-        used to create this instance was a pipeline, the list of values
-        will be present within the pipeline's execute.
-        """
-        command = self.command
-        self.reset()
-        return self.client.execute_command(*command)
-
-
-class ClusterCommands:
+class ClusterCommands(CommandsProtocol):
     """
     Class for Redis Cluster commands
     """
 
-    def cluster(self, cluster_arg, *args, **kwargs):
+    def cluster(self, cluster_arg, *args, **kwargs) -> ResponseT:
         return self.execute_command(f"CLUSTER {cluster_arg.upper()}", *args, **kwargs)
 
-    def readwrite(self, **kwargs):
+    def readwrite(self, **kwargs) -> ResponseT:
         """
         Disables read queries for a connection to a Redis Cluster slave node.
 
@@ -4810,7 +5420,7 @@ def readwrite(self, **kwargs):
         """
         return self.execute_command("READWRITE", **kwargs)
 
-    def readonly(self, **kwargs):
+    def readonly(self, **kwargs) -> ResponseT:
         """
         Enables read queries for a connection to a Redis Cluster replica node.
 
@@ -4819,6 +5429,9 @@ def readonly(self, **kwargs):
         return self.execute_command("READONLY", **kwargs)
 
 
+AsyncClusterCommands = ClusterCommands
+
+
 class DataAccessCommands(
     BasicKeyCommands,
     HyperlogCommands,
@@ -4832,7 +5445,24 @@ class DataAccessCommands(
 ):
     """
     A class containing all of the implemented data access redis commands.
-    This class is to be used as a mixin.
+    This class is to be used as a mixin for synchronous Redis clients.
+    """
+
+
+class AsyncDataAccessCommands(
+    AsyncBasicKeyCommands,
+    AsyncHyperlogCommands,
+    AsyncHashCommands,
+    AsyncGeoCommands,
+    AsyncListCommands,
+    AsyncScanCommands,
+    AsyncSetCommands,
+    AsyncStreamCommands,
+    AsyncSortedSetCommands,
+):
+    """
+    A class containing all of the implemented data access redis commands.
+    This class is to be used as a mixin for asynchronous Redis clients.
     """
 
 
@@ -4847,5 +5477,20 @@ class CoreCommands(
 ):
     """
     A class containing all of the implemented redis commands. This class is
-    to be used as a mixin.
+    to be used as a mixin for synchronous Redis clients.
+    """
+
+
+class AsyncCoreCommands(
+    AsyncACLCommands,
+    AsyncClusterCommands,
+    AsyncDataAccessCommands,
+    AsyncManagementCommands,
+    AsyncModuleCommands,
+    AsyncPubSubCommands,
+    AsyncScriptCommands,
+):
+    """
+    A class containing all of the implemented redis commands. This class is
+    to be used as a mixin for asynchronous Redis clients.
     """
diff --git a/redis/commands/sentinel.py b/redis/commands/sentinel.py
index a9b06c2f6e..e054ec6a38 100644
--- a/redis/commands/sentinel.py
+++ b/redis/commands/sentinel.py
@@ -8,39 +8,39 @@ class SentinelCommands:
     """
 
     def sentinel(self, *args):
-        "Redis Sentinel's SENTINEL command."
+        """Redis Sentinel's SENTINEL command."""
         warnings.warn(DeprecationWarning("Use the individual sentinel_* methods"))
 
     def sentinel_get_master_addr_by_name(self, service_name):
-        "Returns a (host, port) pair for the given ``service_name``"
+        """Returns a (host, port) pair for the given ``service_name``"""
         return self.execute_command("SENTINEL GET-MASTER-ADDR-BY-NAME", service_name)
 
     def sentinel_master(self, service_name):
-        "Returns a dictionary containing the specified masters state."
+        """Returns a dictionary containing the specified masters state."""
         return self.execute_command("SENTINEL MASTER", service_name)
 
     def sentinel_masters(self):
-        "Returns a list of dictionaries containing each master's state."
+        """Returns a list of dictionaries containing each master's state."""
         return self.execute_command("SENTINEL MASTERS")
 
     def sentinel_monitor(self, name, ip, port, quorum):
-        "Add a new master to Sentinel to be monitored"
+        """Add a new master to Sentinel to be monitored"""
         return self.execute_command("SENTINEL MONITOR", name, ip, port, quorum)
 
     def sentinel_remove(self, name):
-        "Remove a master from Sentinel's monitoring"
+        """Remove a master from Sentinel's monitoring"""
         return self.execute_command("SENTINEL REMOVE", name)
 
     def sentinel_sentinels(self, service_name):
-        "Returns a list of sentinels for ``service_name``"
+        """Returns a list of sentinels for ``service_name``"""
         return self.execute_command("SENTINEL SENTINELS", service_name)
 
     def sentinel_set(self, name, option, value):
-        "Set Sentinel monitoring parameters for a given master"
+        """Set Sentinel monitoring parameters for a given master"""
         return self.execute_command("SENTINEL SET", name, option, value)
 
     def sentinel_slaves(self, service_name):
-        "Returns a list of slaves for ``service_name``"
+        """Returns a list of slaves for ``service_name``"""
         return self.execute_command("SENTINEL SLAVES", service_name)
 
     def sentinel_reset(self, pattern):
@@ -91,3 +91,9 @@ def sentinel_flushconfig(self):
         completely missing.
         """
         return self.execute_command("SENTINEL FLUSHCONFIG")
+
+
+class AsyncSentinelCommands(SentinelCommands):
+    async def sentinel(self, *args) -> None:
+        """Redis Sentinel's SENTINEL command."""
+        super().sentinel(*args)
diff --git a/redis/compat.py b/redis/compat.py
new file mode 100644
index 0000000000..738687f645
--- /dev/null
+++ b/redis/compat.py
@@ -0,0 +1,9 @@
+# flake8: noqa
+try:
+    from typing import Literal, Protocol, TypedDict  # lgtm [py/unused-import]
+except ImportError:
+    from typing_extensions import (  # lgtm [py/unused-import]
+        Literal,
+        Protocol,
+        TypedDict,
+    )
diff --git a/redis/typing.py b/redis/typing.py
new file mode 100644
index 0000000000..d96e4e3a5d
--- /dev/null
+++ b/redis/typing.py
@@ -0,0 +1,45 @@
+# from __future__ import annotations
+
+from datetime import datetime, timedelta
+from typing import TYPE_CHECKING, Iterable, TypeVar, Union
+
+from redis.compat import Protocol
+
+if TYPE_CHECKING:
+    from redis.asyncio.connection import ConnectionPool as AsyncConnectionPool
+    from redis.connection import ConnectionPool
+
+
+EncodedT = Union[bytes, memoryview]
+DecodedT = Union[str, int, float]
+EncodableT = Union[EncodedT, DecodedT]
+AbsExpiryT = Union[int, datetime]
+ExpiryT = Union[float, timedelta]
+ZScoreBoundT = Union[float, str]  # str allows for the [ or ( prefix
+BitfieldOffsetT = Union[int, str]  # str allows for #x syntax
+_StringLikeT = Union[bytes, str, memoryview]
+KeyT = _StringLikeT  # Main redis key space
+PatternT = _StringLikeT  # Patterns matched against keys, fields etc
+FieldT = EncodableT  # Fields within hash tables, streams and geo commands
+KeysT = Union[KeyT, Iterable[KeyT]]
+ChannelT = _StringLikeT
+GroupT = _StringLikeT  # Consumer group
+ConsumerT = _StringLikeT  # Consumer name
+StreamIdT = Union[int, _StringLikeT]
+ScriptTextT = _StringLikeT
+TimeoutSecT = Union[int, float, _StringLikeT]
+# Mapping is not covariant in the key type, which prevents
+# Mapping[_StringLikeT, X from accepting arguments of type Dict[str, X]. Using
+# a TypeVar instead of a Union allows mappings with any of the permitted types
+# to be passed. Care is needed if there is more than one such mapping in a
+# type signature because they will all be required to be the same key type.
+AnyKeyT = TypeVar("AnyKeyT", bytes, str, memoryview)
+AnyFieldT = TypeVar("AnyFieldT", bytes, str, memoryview)
+AnyChannelT = TypeVar("AnyChannelT", bytes, str, memoryview)
+
+
+class CommandsProtocol(Protocol):
+    connection_pool: Union["AsyncConnectionPool", "ConnectionPool"]
+
+    def execute_command(self, *args, **options):
+        ...
diff --git a/requirements.txt b/requirements.txt
index b05ff454bf..7f0ebf0c69 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,2 +1,4 @@
+async-timeout>=4.0.2
 deprecated>=1.2.3
 packaging>=20.4
+typing-extensions
diff --git a/setup.py b/setup.py
index a44fe620d7..a6d5cf0679 100644
--- a/setup.py
+++ b/setup.py
@@ -12,6 +12,7 @@
     packages=find_packages(
         include=[
             "redis",
+            "redis.asyncio",
             "redis.commands",
             "redis.commands.bf",
             "redis.commands.json",
@@ -34,6 +35,8 @@
         "deprecated>=1.2.3",
         "packaging>=20.4",
         'importlib-metadata >= 1.0; python_version < "3.8"',
+        "typing-extensions",
+        "async-timeout>=4.0.2",
     ],
     classifiers=[
         "Development Status :: 5 - Production/Stable",
diff --git a/tests/conftest.py b/tests/conftest.py
index d9de876933..2534ca0c95 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -1,5 +1,7 @@
+import argparse
 import random
 import time
+from typing import Callable, TypeVar
 from unittest.mock import Mock
 from urllib.parse import urlparse
 
@@ -21,6 +23,54 @@
 default_redis_ssl_url = "rediss://localhost:6666"
 default_cluster_nodes = 6
 
+_DecoratedTest = TypeVar("_DecoratedTest", bound="Callable")
+_TestDecorator = Callable[[_DecoratedTest], _DecoratedTest]
+
+
+# Taken from python3.9
+class BooleanOptionalAction(argparse.Action):
+    def __init__(
+        self,
+        option_strings,
+        dest,
+        default=None,
+        type=None,
+        choices=None,
+        required=False,
+        help=None,
+        metavar=None,
+    ):
+
+        _option_strings = []
+        for option_string in option_strings:
+            _option_strings.append(option_string)
+
+            if option_string.startswith("--"):
+                option_string = "--no-" + option_string[2:]
+                _option_strings.append(option_string)
+
+        if help is not None and default is not None:
+            help += f" (default: {default})"
+
+        super().__init__(
+            option_strings=_option_strings,
+            dest=dest,
+            nargs=0,
+            default=default,
+            type=type,
+            choices=choices,
+            required=required,
+            help=help,
+            metavar=metavar,
+        )
+
+    def __call__(self, parser, namespace, values, option_string=None):
+        if option_string in self.option_strings:
+            setattr(namespace, self.dest, not option_string.startswith("--no-"))
+
+    def format_usage(self):
+        return " | ".join(self.option_strings)
+
 
 def pytest_addoption(parser):
     parser.addoption(
@@ -62,6 +112,9 @@ def pytest_addoption(parser):
         help="Redis unstable (latest version) connection string "
         "defaults to %(default)s`",
     )
+    parser.addoption(
+        "--uvloop", action=BooleanOptionalAction, help="Run tests with uvloop"
+    )
 
 
 def _get_info(redis_url):
@@ -101,6 +154,18 @@ def pytest_sessionstart(session):
         cluster_nodes = session.config.getoption("--redis-cluster-nodes")
         wait_for_cluster_creation(redis_url, cluster_nodes)
 
+    use_uvloop = session.config.getoption("--uvloop")
+
+    if use_uvloop:
+        try:
+            import uvloop
+
+            uvloop.install()
+        except ImportError as e:
+            raise RuntimeError(
+                "Can not import uvloop, make sure it is installed"
+            ) from e
+
 
 def wait_for_cluster_creation(redis_url, cluster_nodes, timeout=60):
     """
@@ -133,19 +198,19 @@ def wait_for_cluster_creation(redis_url, cluster_nodes, timeout=60):
         )
 
 
-def skip_if_server_version_lt(min_version):
+def skip_if_server_version_lt(min_version: str) -> _TestDecorator:
     redis_version = REDIS_INFO["version"]
     check = Version(redis_version) < Version(min_version)
     return pytest.mark.skipif(check, reason=f"Redis version required >= {min_version}")
 
 
-def skip_if_server_version_gte(min_version):
+def skip_if_server_version_gte(min_version: str) -> _TestDecorator:
     redis_version = REDIS_INFO["version"]
     check = Version(redis_version) >= Version(min_version)
     return pytest.mark.skipif(check, reason=f"Redis version required < {min_version}")
 
 
-def skip_unless_arch_bits(arch_bits):
+def skip_unless_arch_bits(arch_bits: int) -> _TestDecorator:
     return pytest.mark.skipif(
         REDIS_INFO["arch_bits"] != arch_bits, reason=f"server is not {arch_bits}-bit"
     )
@@ -169,17 +234,17 @@ def skip_ifmodversion_lt(min_version: str, module_name: str):
     raise AttributeError(f"No redis module named {module_name}")
 
 
-def skip_if_redis_enterprise():
+def skip_if_redis_enterprise() -> _TestDecorator:
     check = REDIS_INFO["enterprise"] is True
     return pytest.mark.skipif(check, reason="Redis enterprise")
 
 
-def skip_ifnot_redis_enterprise():
+def skip_ifnot_redis_enterprise() -> _TestDecorator:
     check = REDIS_INFO["enterprise"] is False
     return pytest.mark.skipif(check, reason="Not running in redis enterprise")
 
 
-def skip_if_nocryptography():
+def skip_if_nocryptography() -> _TestDecorator:
     try:
         import cryptography  # noqa
 
@@ -188,7 +253,7 @@ def skip_if_nocryptography():
         return pytest.mark.skipif(True, reason="No cryptography dependency")
 
 
-def skip_if_cryptography():
+def skip_if_cryptography() -> _TestDecorator:
     try:
         import cryptography  # noqa
 
diff --git a/tests/test_asyncio/__init__.py b/tests/test_asyncio/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/tests/test_asyncio/compat.py b/tests/test_asyncio/compat.py
new file mode 100644
index 0000000000..ced4974196
--- /dev/null
+++ b/tests/test_asyncio/compat.py
@@ -0,0 +1,6 @@
+from unittest import mock
+
+try:
+    mock.AsyncMock
+except AttributeError:
+    import mock
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
new file mode 100644
index 0000000000..0e9c73ec61
--- /dev/null
+++ b/tests/test_asyncio/conftest.py
@@ -0,0 +1,205 @@
+import asyncio
+import random
+import sys
+from typing import Union
+from urllib.parse import urlparse
+
+if sys.version_info[0:2] == (3, 6):
+    import pytest as pytest_asyncio
+else:
+    import pytest_asyncio
+
+import pytest
+from packaging.version import Version
+
+import redis.asyncio as redis
+from redis.asyncio.client import Monitor
+from redis.asyncio.connection import (
+    HIREDIS_AVAILABLE,
+    HiredisParser,
+    PythonParser,
+    parse_url,
+)
+from tests.conftest import REDIS_INFO
+
+from .compat import mock
+
+
+async def _get_info(redis_url):
+    client = redis.Redis.from_url(redis_url)
+    info = await client.info()
+    await client.connection_pool.disconnect()
+    return info
+
+
+@pytest_asyncio.fixture(
+    params=[
+        (True, PythonParser),
+        (False, PythonParser),
+        pytest.param(
+            (True, HiredisParser),
+            marks=pytest.mark.skipif(
+                not HIREDIS_AVAILABLE, reason="hiredis is not installed"
+            ),
+        ),
+        pytest.param(
+            (False, HiredisParser),
+            marks=pytest.mark.skipif(
+                not HIREDIS_AVAILABLE, reason="hiredis is not installed"
+            ),
+        ),
+    ],
+    ids=[
+        "single-python-parser",
+        "pool-python-parser",
+        "single-hiredis",
+        "pool-hiredis",
+    ],
+)
+def create_redis(request, event_loop: asyncio.BaseEventLoop):
+    """Wrapper around redis.create_redis."""
+    single_connection, parser_cls = request.param
+
+    async def f(url: str = request.config.getoption("--redis-url"), **kwargs):
+        single = kwargs.pop("single_connection_client", False) or single_connection
+        parser_class = kwargs.pop("parser_class", None) or parser_cls
+        url_options = parse_url(url)
+        url_options.update(kwargs)
+        pool = redis.ConnectionPool(parser_class=parser_class, **url_options)
+        client: redis.Redis = redis.Redis(connection_pool=pool)
+        if single:
+            client = client.client()
+            await client.initialize()
+
+        def teardown():
+            async def ateardown():
+                if "username" in kwargs:
+                    return
+                try:
+                    await client.flushdb()
+                except redis.ConnectionError:
+                    # handle cases where a test disconnected a client
+                    # just manually retry the flushdb
+                    await client.flushdb()
+                await client.close()
+                await client.connection_pool.disconnect()
+
+            if event_loop.is_running():
+                event_loop.create_task(ateardown())
+            else:
+                event_loop.run_until_complete(ateardown())
+
+        request.addfinalizer(teardown)
+
+        return client
+
+    return f
+
+
+@pytest_asyncio.fixture()
+async def r(create_redis):
+    yield await create_redis()
+
+
+@pytest_asyncio.fixture()
+async def r2(create_redis):
+    """A second client for tests that need multiple"""
+    yield await create_redis()
+
+
+def _gen_cluster_mock_resp(r, response):
+    connection = mock.AsyncMock()
+    connection.read_response.return_value = response
+    r.connection = connection
+    return r
+
+
+@pytest_asyncio.fixture()
+async def mock_cluster_resp_ok(create_redis, **kwargs):
+    r = await create_redis(**kwargs)
+    return _gen_cluster_mock_resp(r, "OK")
+
+
+@pytest_asyncio.fixture()
+async def mock_cluster_resp_int(create_redis, **kwargs):
+    r = await create_redis(**kwargs)
+    return _gen_cluster_mock_resp(r, "2")
+
+
+@pytest_asyncio.fixture()
+async def mock_cluster_resp_info(create_redis, **kwargs):
+    r = await create_redis(**kwargs)
+    response = (
+        "cluster_state:ok\r\ncluster_slots_assigned:16384\r\n"
+        "cluster_slots_ok:16384\r\ncluster_slots_pfail:0\r\n"
+        "cluster_slots_fail:0\r\ncluster_known_nodes:7\r\n"
+        "cluster_size:3\r\ncluster_current_epoch:7\r\n"
+        "cluster_my_epoch:2\r\ncluster_stats_messages_sent:170262\r\n"
+        "cluster_stats_messages_received:105653\r\n"
+    )
+    return _gen_cluster_mock_resp(r, response)
+
+
+@pytest_asyncio.fixture()
+async def mock_cluster_resp_nodes(create_redis, **kwargs):
+    r = await create_redis(**kwargs)
+    response = (
+        "c8253bae761cb1ecb2b61857d85dfe455a0fec8b 172.17.0.7:7006 "
+        "slave aa90da731f673a99617dfe930306549a09f83a6b 0 "
+        "1447836263059 5 connected\n"
+        "9bd595fe4821a0e8d6b99d70faa660638a7612b3 172.17.0.7:7008 "
+        "master - 0 1447836264065 0 connected\n"
+        "aa90da731f673a99617dfe930306549a09f83a6b 172.17.0.7:7003 "
+        "myself,master - 0 0 2 connected 5461-10922\n"
+        "1df047e5a594f945d82fc140be97a1452bcbf93e 172.17.0.7:7007 "
+        "slave 19efe5a631f3296fdf21a5441680f893e8cc96ec 0 "
+        "1447836262556 3 connected\n"
+        "4ad9a12e63e8f0207025eeba2354bcf4c85e5b22 172.17.0.7:7005 "
+        "master - 0 1447836262555 7 connected 0-5460\n"
+        "19efe5a631f3296fdf21a5441680f893e8cc96ec 172.17.0.7:7004 "
+        "master - 0 1447836263562 3 connected 10923-16383\n"
+        "fbb23ed8cfa23f17eaf27ff7d0c410492a1093d6 172.17.0.7:7002 "
+        "master,fail - 1447829446956 1447829444948 1 disconnected\n"
+    )
+    return _gen_cluster_mock_resp(r, response)
+
+
+@pytest_asyncio.fixture()
+async def mock_cluster_resp_slaves(create_redis, **kwargs):
+    r = await create_redis(**kwargs)
+    response = (
+        "['1df047e5a594f945d82fc140be97a1452bcbf93e 172.17.0.7:7007 "
+        "slave 19efe5a631f3296fdf21a5441680f893e8cc96ec 0 "
+        "1447836789290 3 connected']"
+    )
+    return _gen_cluster_mock_resp(r, response)
+
+
+@pytest_asyncio.fixture(scope="session")
+def master_host(request):
+    url = request.config.getoption("--redis-url")
+    parts = urlparse(url)
+    yield parts.hostname
+
+
+async def wait_for_command(
+    client: redis.Redis, monitor: Monitor, command: str, key: Union[str, None] = None
+):
+    # issue a command with a key name that's local to this process.
+    # if we find a command with our key before the command we're waiting
+    # for, something went wrong
+    if key is None:
+        # generate key
+        redis_version = REDIS_INFO["version"]
+        if Version(redis_version) >= Version("5.0.0"):
+            id_str = str(client.client_id())
+        else:
+            id_str = f"{random.randrange(2 ** 32):08x}"
+        key = f"__REDIS-PY-{id_str}__"
+    await client.get(key)
+    while True:
+        monitor_response = await monitor.next_command()
+        if command in monitor_response["command"]:
+            return monitor_response
+        if key in monitor_response["command"]:
+            return None
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
new file mode 100644
index 0000000000..12855c9326
--- /dev/null
+++ b/tests/test_asyncio/test_commands.py
@@ -0,0 +1,3 @@
+"""
+Tests async overrides of commands from their mixins
+"""
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
new file mode 100644
index 0000000000..46abec01d6
--- /dev/null
+++ b/tests/test_asyncio/test_connection.py
@@ -0,0 +1,64 @@
+import asyncio
+import types
+
+import pytest
+
+from redis.asyncio.connection import PythonParser, UnixDomainSocketConnection
+from redis.exceptions import InvalidResponse
+from redis.utils import HIREDIS_AVAILABLE
+from tests.conftest import skip_if_server_version_lt
+
+from .compat import mock
+
+pytestmark = pytest.mark.asyncio
+
+
+@pytest.mark.onlynoncluster
+@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+async def test_invalid_response(create_redis):
+    r = await create_redis(single_connection_client=True)
+
+    raw = b"x"
+    readline_mock = mock.AsyncMock(return_value=raw)
+
+    parser: "PythonParser" = r.connection._parser
+    with mock.patch.object(parser._buffer, "readline", readline_mock):
+        with pytest.raises(InvalidResponse) as cm:
+            await parser.read_response()
+    assert str(cm.value) == f"Protocol Error: {raw!r}"
+
+
+@skip_if_server_version_lt("4.0.0")
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+async def test_loading_external_modules(modclient):
+    def inner():
+        pass
+
+    modclient.load_external_module("myfuncname", inner)
+    assert getattr(modclient, "myfuncname") == inner
+    assert isinstance(getattr(modclient, "myfuncname"), types.FunctionType)
+
+    # and call it
+    from redis.commands import RedisModuleCommands
+
+    j = RedisModuleCommands.json
+    modclient.load_external_module("sometestfuncname", j)
+
+    # d = {'hello': 'world!'}
+    # mod = j(modclient)
+    # mod.set("fookey", ".", d)
+    # assert mod.get('fookey') == d
+
+
+@pytest.mark.onlynoncluster
+async def test_socket_param_regression(r):
+    """A regression test for issue #1060"""
+    conn = UnixDomainSocketConnection()
+    _ = await conn.disconnect() is True
+
+
+@pytest.mark.onlynoncluster
+async def test_can_run_concurrent_commands(r):
+    assert await r.ping() is True
+    assert all(await asyncio.gather(*(r.ping() for _ in range(10))))
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
new file mode 100644
index 0000000000..f9dfefd5cc
--- /dev/null
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -0,0 +1,884 @@
+import asyncio
+import os
+import re
+import sys
+
+import pytest
+
+if sys.version_info[0:2] == (3, 6):
+    import pytest as pytest_asyncio
+else:
+    import pytest_asyncio
+
+import redis.asyncio as redis
+from redis.asyncio.connection import Connection, to_bool
+from tests.conftest import skip_if_redis_enterprise, skip_if_server_version_lt
+
+from .compat import mock
+from .test_pubsub import wait_for_message
+
+pytestmark = pytest.mark.asyncio
+
+
+class TestRedisAutoReleaseConnectionPool:
+    @pytest_asyncio.fixture
+    async def r(self, create_redis) -> redis.Redis:
+        """This is necessary since r and r2 create ConnectionPools behind the scenes"""
+        r = await create_redis()
+        r.auto_close_connection_pool = True
+        yield r
+
+    @staticmethod
+    def get_total_connected_connections(pool):
+        return len(pool._available_connections) + len(pool._in_use_connections)
+
+    @staticmethod
+    async def create_two_conn(r: redis.Redis):
+        if not r.single_connection_client:  # Single already initialized connection
+            r.connection = await r.connection_pool.get_connection("_")
+        return await r.connection_pool.get_connection("_")
+
+    @staticmethod
+    def has_no_connected_connections(pool: redis.ConnectionPool):
+        return not any(
+            x.is_connected
+            for x in pool._available_connections + list(pool._in_use_connections)
+        )
+
+    async def test_auto_disconnect_redis_created_pool(self, r: redis.Redis):
+        new_conn = await self.create_two_conn(r)
+        assert new_conn != r.connection
+        assert self.get_total_connected_connections(r.connection_pool) == 2
+        await r.close()
+        assert self.has_no_connected_connections(r.connection_pool)
+
+    async def test_do_not_auto_disconnect_redis_created_pool(self, r2: redis.Redis):
+        assert r2.auto_close_connection_pool is False, (
+            "The connection pool should not be disconnected as a manually created "
+            "connection pool was passed in in conftest.py"
+        )
+        new_conn = await self.create_two_conn(r2)
+        assert self.get_total_connected_connections(r2.connection_pool) == 2
+        await r2.close()
+        assert r2.connection_pool._in_use_connections == {new_conn}
+        assert new_conn.is_connected
+        assert len(r2.connection_pool._available_connections) == 1
+        assert r2.connection_pool._available_connections[0].is_connected
+
+    async def test_auto_release_override_true_manual_created_pool(self, r: redis.Redis):
+        assert r.auto_close_connection_pool is True, "This is from the class fixture"
+        await self.create_two_conn(r)
+        await r.close()
+        assert self.get_total_connected_connections(r.connection_pool) == 2, (
+            "The connection pool should not be disconnected as a manually created "
+            "connection pool was passed in in conftest.py"
+        )
+        assert self.has_no_connected_connections(r.connection_pool)
+
+    @pytest.mark.parametrize("auto_close_conn_pool", [True, False])
+    async def test_close_override(self, r: redis.Redis, auto_close_conn_pool):
+        r.auto_close_connection_pool = auto_close_conn_pool
+        await self.create_two_conn(r)
+        await r.close(close_connection_pool=True)
+        assert self.has_no_connected_connections(r.connection_pool)
+
+    @pytest.mark.parametrize("auto_close_conn_pool", [True, False])
+    async def test_negate_auto_close_client_pool(
+        self, r: redis.Redis, auto_close_conn_pool
+    ):
+        r.auto_close_connection_pool = auto_close_conn_pool
+        new_conn = await self.create_two_conn(r)
+        await r.close(close_connection_pool=False)
+        assert not self.has_no_connected_connections(r.connection_pool)
+        assert r.connection_pool._in_use_connections == {new_conn}
+        assert r.connection_pool._available_connections[0].is_connected
+        assert self.get_total_connected_connections(r.connection_pool) == 2
+
+
+class DummyConnection(Connection):
+    description_format = "DummyConnection<>"
+
+    def __init__(self, **kwargs):
+        self.kwargs = kwargs
+        self.pid = os.getpid()
+
+    async def connect(self):
+        pass
+
+    async def disconnect(self):
+        pass
+
+    async def can_read(self, timeout: float = 0):
+        return False
+
+
+@pytest.mark.onlynoncluster
+class TestConnectionPool:
+    def get_pool(
+        self,
+        connection_kwargs=None,
+        max_connections=None,
+        connection_class=redis.Connection,
+    ):
+        connection_kwargs = connection_kwargs or {}
+        pool = redis.ConnectionPool(
+            connection_class=connection_class,
+            max_connections=max_connections,
+            **connection_kwargs,
+        )
+        return pool
+
+    async def test_connection_creation(self):
+        connection_kwargs = {"foo": "bar", "biz": "baz"}
+        pool = self.get_pool(
+            connection_kwargs=connection_kwargs, connection_class=DummyConnection
+        )
+        connection = await pool.get_connection("_")
+        assert isinstance(connection, DummyConnection)
+        assert connection.kwargs == connection_kwargs
+
+    async def test_multiple_connections(self, master_host):
+        connection_kwargs = {"host": master_host}
+        pool = self.get_pool(connection_kwargs=connection_kwargs)
+        c1 = await pool.get_connection("_")
+        c2 = await pool.get_connection("_")
+        assert c1 != c2
+
+    async def test_max_connections(self, master_host):
+        connection_kwargs = {"host": master_host}
+        pool = self.get_pool(max_connections=2, connection_kwargs=connection_kwargs)
+        await pool.get_connection("_")
+        await pool.get_connection("_")
+        with pytest.raises(redis.ConnectionError):
+            await pool.get_connection("_")
+
+    async def test_reuse_previously_released_connection(self, master_host):
+        connection_kwargs = {"host": master_host}
+        pool = self.get_pool(connection_kwargs=connection_kwargs)
+        c1 = await pool.get_connection("_")
+        await pool.release(c1)
+        c2 = await pool.get_connection("_")
+        assert c1 == c2
+
+    def test_repr_contains_db_info_tcp(self):
+        connection_kwargs = {
+            "host": "localhost",
+            "port": 6379,
+            "db": 1,
+            "client_name": "test-client",
+        }
+        pool = self.get_pool(
+            connection_kwargs=connection_kwargs, connection_class=redis.Connection
+        )
+        expected = (
+            "ConnectionPool<Connection<"
+            "host=localhost,port=6379,db=1,client_name=test-client>>"
+        )
+        assert repr(pool) == expected
+
+    def test_repr_contains_db_info_unix(self):
+        connection_kwargs = {"path": "/abc", "db": 1, "client_name": "test-client"}
+        pool = self.get_pool(
+            connection_kwargs=connection_kwargs,
+            connection_class=redis.UnixDomainSocketConnection,
+        )
+        expected = (
+            "ConnectionPool<UnixDomainSocketConnection<"
+            "path=/abc,db=1,client_name=test-client>>"
+        )
+        assert repr(pool) == expected
+
+
+@pytest.mark.onlynoncluster
+class TestBlockingConnectionPool:
+    def get_pool(self, connection_kwargs=None, max_connections=10, timeout=20):
+        connection_kwargs = connection_kwargs or {}
+        pool = redis.BlockingConnectionPool(
+            connection_class=DummyConnection,
+            max_connections=max_connections,
+            timeout=timeout,
+            **connection_kwargs,
+        )
+        return pool
+
+    async def test_connection_creation(self, master_host):
+        connection_kwargs = {
+            "foo": "bar",
+            "biz": "baz",
+            "host": master_host[0],
+            "port": master_host[1],
+        }
+        pool = self.get_pool(connection_kwargs=connection_kwargs)
+        connection = await pool.get_connection("_")
+        assert isinstance(connection, DummyConnection)
+        assert connection.kwargs == connection_kwargs
+
+    async def test_disconnect(self, master_host):
+        """A regression test for #1047"""
+        connection_kwargs = {
+            "foo": "bar",
+            "biz": "baz",
+            "host": master_host[0],
+            "port": master_host[1],
+        }
+        pool = self.get_pool(connection_kwargs=connection_kwargs)
+        await pool.get_connection("_")
+        await pool.disconnect()
+
+    async def test_multiple_connections(self, master_host):
+        connection_kwargs = {"host": master_host[0], "port": master_host[1]}
+        pool = self.get_pool(connection_kwargs=connection_kwargs)
+        c1 = await pool.get_connection("_")
+        c2 = await pool.get_connection("_")
+        assert c1 != c2
+
+    async def test_connection_pool_blocks_until_timeout(self, master_host):
+        """When out of connections, block for timeout seconds, then raise"""
+        connection_kwargs = {"host": master_host}
+        pool = self.get_pool(
+            max_connections=1, timeout=0.1, connection_kwargs=connection_kwargs
+        )
+        await pool.get_connection("_")
+
+        start = asyncio.get_event_loop().time()
+        with pytest.raises(redis.ConnectionError):
+            await pool.get_connection("_")
+        # we should have waited at least 0.1 seconds
+        assert asyncio.get_event_loop().time() - start >= 0.1
+
+    async def test_connection_pool_blocks_until_conn_available(self, master_host):
+        """
+        When out of connections, block until another connection is released
+        to the pool
+        """
+        connection_kwargs = {"host": master_host[0], "port": master_host[1]}
+        pool = self.get_pool(
+            max_connections=1, timeout=2, connection_kwargs=connection_kwargs
+        )
+        c1 = await pool.get_connection("_")
+
+        async def target():
+            await asyncio.sleep(0.1)
+            await pool.release(c1)
+
+        start = asyncio.get_event_loop().time()
+        await asyncio.gather(target(), pool.get_connection("_"))
+        assert asyncio.get_event_loop().time() - start >= 0.1
+
+    async def test_reuse_previously_released_connection(self, master_host):
+        connection_kwargs = {"host": master_host}
+        pool = self.get_pool(connection_kwargs=connection_kwargs)
+        c1 = await pool.get_connection("_")
+        await pool.release(c1)
+        c2 = await pool.get_connection("_")
+        assert c1 == c2
+
+    def test_repr_contains_db_info_tcp(self):
+        pool = redis.ConnectionPool(
+            host="localhost", port=6379, client_name="test-client"
+        )
+        expected = (
+            "ConnectionPool<Connection<"
+            "host=localhost,port=6379,db=0,client_name=test-client>>"
+        )
+        assert repr(pool) == expected
+
+    def test_repr_contains_db_info_unix(self):
+        pool = redis.ConnectionPool(
+            connection_class=redis.UnixDomainSocketConnection,
+            path="abc",
+            client_name="test-client",
+        )
+        expected = (
+            "ConnectionPool<UnixDomainSocketConnection<"
+            "path=abc,db=0,client_name=test-client>>"
+        )
+        assert repr(pool) == expected
+
+
+@pytest.mark.onlynoncluster
+class TestConnectionPoolURLParsing:
+    def test_hostname(self):
+        pool = redis.ConnectionPool.from_url("redis://my.host")
+        assert pool.connection_class == redis.Connection
+        assert pool.connection_kwargs == {
+            "host": "my.host",
+        }
+
+    def test_quoted_hostname(self):
+        pool = redis.ConnectionPool.from_url("redis://my %2F host %2B%3D+")
+        assert pool.connection_class == redis.Connection
+        assert pool.connection_kwargs == {
+            "host": "my / host +=+",
+        }
+
+    def test_port(self):
+        pool = redis.ConnectionPool.from_url("redis://localhost:6380")
+        assert pool.connection_class == redis.Connection
+        assert pool.connection_kwargs == {
+            "host": "localhost",
+            "port": 6380,
+        }
+
+    @skip_if_server_version_lt("6.0.0")
+    def test_username(self):
+        pool = redis.ConnectionPool.from_url("redis://myuser:@localhost")
+        assert pool.connection_class == redis.Connection
+        assert pool.connection_kwargs == {
+            "host": "localhost",
+            "username": "myuser",
+        }
+
+    @skip_if_server_version_lt("6.0.0")
+    def test_quoted_username(self):
+        pool = redis.ConnectionPool.from_url(
+            "redis://%2Fmyuser%2F%2B name%3D%24+:@localhost"
+        )
+        assert pool.connection_class == redis.Connection
+        assert pool.connection_kwargs == {
+            "host": "localhost",
+            "username": "/myuser/+ name=$+",
+        }
+
+    def test_password(self):
+        pool = redis.ConnectionPool.from_url("redis://:mypassword@localhost")
+        assert pool.connection_class == redis.Connection
+        assert pool.connection_kwargs == {
+            "host": "localhost",
+            "password": "mypassword",
+        }
+
+    def test_quoted_password(self):
+        pool = redis.ConnectionPool.from_url(
+            "redis://:%2Fmypass%2F%2B word%3D%24+@localhost"
+        )
+        assert pool.connection_class == redis.Connection
+        assert pool.connection_kwargs == {
+            "host": "localhost",
+            "password": "/mypass/+ word=$+",
+        }
+
+    @skip_if_server_version_lt("6.0.0")
+    def test_username_and_password(self):
+        pool = redis.ConnectionPool.from_url("redis://myuser:mypass@localhost")
+        assert pool.connection_class == redis.Connection
+        assert pool.connection_kwargs == {
+            "host": "localhost",
+            "username": "myuser",
+            "password": "mypass",
+        }
+
+    def test_db_as_argument(self):
+        pool = redis.ConnectionPool.from_url("redis://localhost", db=1)
+        assert pool.connection_class == redis.Connection
+        assert pool.connection_kwargs == {
+            "host": "localhost",
+            "db": 1,
+        }
+
+    def test_db_in_path(self):
+        pool = redis.ConnectionPool.from_url("redis://localhost/2", db=1)
+        assert pool.connection_class == redis.Connection
+        assert pool.connection_kwargs == {
+            "host": "localhost",
+            "db": 2,
+        }
+
+    def test_db_in_querystring(self):
+        pool = redis.ConnectionPool.from_url("redis://localhost/2?db=3", db=1)
+        assert pool.connection_class == redis.Connection
+        assert pool.connection_kwargs == {
+            "host": "localhost",
+            "db": 3,
+        }
+
+    def test_extra_typed_querystring_options(self):
+        pool = redis.ConnectionPool.from_url(
+            "redis://localhost/2?socket_timeout=20&socket_connect_timeout=10"
+            "&socket_keepalive=&retry_on_timeout=Yes&max_connections=10"
+        )
+
+        assert pool.connection_class == redis.Connection
+        assert pool.connection_kwargs == {
+            "host": "localhost",
+            "db": 2,
+            "socket_timeout": 20.0,
+            "socket_connect_timeout": 10.0,
+            "retry_on_timeout": True,
+        }
+        assert pool.max_connections == 10
+
+    def test_boolean_parsing(self):
+        for expected, value in (
+            (None, None),
+            (None, ""),
+            (False, 0),
+            (False, "0"),
+            (False, "f"),
+            (False, "F"),
+            (False, "False"),
+            (False, "n"),
+            (False, "N"),
+            (False, "No"),
+            (True, 1),
+            (True, "1"),
+            (True, "y"),
+            (True, "Y"),
+            (True, "Yes"),
+        ):
+            assert expected is to_bool(value)
+
+    def test_client_name_in_querystring(self):
+        pool = redis.ConnectionPool.from_url("redis://location?client_name=test-client")
+        assert pool.connection_kwargs["client_name"] == "test-client"
+
+    def test_invalid_extra_typed_querystring_options(self):
+        with pytest.raises(ValueError):
+            redis.ConnectionPool.from_url(
+                "redis://localhost/2?socket_timeout=_&" "socket_connect_timeout=abc"
+            )
+
+    def test_extra_querystring_options(self):
+        pool = redis.ConnectionPool.from_url("redis://localhost?a=1&b=2")
+        assert pool.connection_class == redis.Connection
+        assert pool.connection_kwargs == {"host": "localhost", "a": "1", "b": "2"}
+
+    def test_calling_from_subclass_returns_correct_instance(self):
+        pool = redis.BlockingConnectionPool.from_url("redis://localhost")
+        assert isinstance(pool, redis.BlockingConnectionPool)
+
+    def test_client_creates_connection_pool(self):
+        r = redis.Redis.from_url("redis://myhost")
+        assert r.connection_pool.connection_class == redis.Connection
+        assert r.connection_pool.connection_kwargs == {
+            "host": "myhost",
+        }
+
+    def test_invalid_scheme_raises_error(self):
+        with pytest.raises(ValueError) as cm:
+            redis.ConnectionPool.from_url("localhost")
+        assert str(cm.value) == (
+            "Redis URL must specify one of the following schemes "
+            "(redis://, rediss://, unix://)"
+        )
+
+
+@pytest.mark.onlynoncluster
+class TestConnectionPoolUnixSocketURLParsing:
+    def test_defaults(self):
+        pool = redis.ConnectionPool.from_url("unix:///socket")
+        assert pool.connection_class == redis.UnixDomainSocketConnection
+        assert pool.connection_kwargs == {
+            "path": "/socket",
+        }
+
+    @skip_if_server_version_lt("6.0.0")
+    def test_username(self):
+        pool = redis.ConnectionPool.from_url("unix://myuser:@/socket")
+        assert pool.connection_class == redis.UnixDomainSocketConnection
+        assert pool.connection_kwargs == {
+            "path": "/socket",
+            "username": "myuser",
+        }
+
+    @skip_if_server_version_lt("6.0.0")
+    def test_quoted_username(self):
+        pool = redis.ConnectionPool.from_url(
+            "unix://%2Fmyuser%2F%2B name%3D%24+:@/socket"
+        )
+        assert pool.connection_class == redis.UnixDomainSocketConnection
+        assert pool.connection_kwargs == {
+            "path": "/socket",
+            "username": "/myuser/+ name=$+",
+        }
+
+    def test_password(self):
+        pool = redis.ConnectionPool.from_url("unix://:mypassword@/socket")
+        assert pool.connection_class == redis.UnixDomainSocketConnection
+        assert pool.connection_kwargs == {
+            "path": "/socket",
+            "password": "mypassword",
+        }
+
+    def test_quoted_password(self):
+        pool = redis.ConnectionPool.from_url(
+            "unix://:%2Fmypass%2F%2B word%3D%24+@/socket"
+        )
+        assert pool.connection_class == redis.UnixDomainSocketConnection
+        assert pool.connection_kwargs == {
+            "path": "/socket",
+            "password": "/mypass/+ word=$+",
+        }
+
+    def test_quoted_path(self):
+        pool = redis.ConnectionPool.from_url(
+            "unix://:mypassword@/my%2Fpath%2Fto%2F..%2F+_%2B%3D%24ocket"
+        )
+        assert pool.connection_class == redis.UnixDomainSocketConnection
+        assert pool.connection_kwargs == {
+            "path": "/my/path/to/../+_+=$ocket",
+            "password": "mypassword",
+        }
+
+    def test_db_as_argument(self):
+        pool = redis.ConnectionPool.from_url("unix:///socket", db=1)
+        assert pool.connection_class == redis.UnixDomainSocketConnection
+        assert pool.connection_kwargs == {
+            "path": "/socket",
+            "db": 1,
+        }
+
+    def test_db_in_querystring(self):
+        pool = redis.ConnectionPool.from_url("unix:///socket?db=2", db=1)
+        assert pool.connection_class == redis.UnixDomainSocketConnection
+        assert pool.connection_kwargs == {
+            "path": "/socket",
+            "db": 2,
+        }
+
+    def test_client_name_in_querystring(self):
+        pool = redis.ConnectionPool.from_url("redis://location?client_name=test-client")
+        assert pool.connection_kwargs["client_name"] == "test-client"
+
+    def test_extra_querystring_options(self):
+        pool = redis.ConnectionPool.from_url("unix:///socket?a=1&b=2")
+        assert pool.connection_class == redis.UnixDomainSocketConnection
+        assert pool.connection_kwargs == {"path": "/socket", "a": "1", "b": "2"}
+
+
+@pytest.mark.onlynoncluster
+class TestSSLConnectionURLParsing:
+    def test_host(self):
+        pool = redis.ConnectionPool.from_url("rediss://my.host")
+        assert pool.connection_class == redis.SSLConnection
+        assert pool.connection_kwargs == {
+            "host": "my.host",
+        }
+
+    def test_cert_reqs_options(self):
+        import ssl
+
+        class DummyConnectionPool(redis.ConnectionPool):
+            def get_connection(self, *args, **kwargs):
+                return self.make_connection()
+
+        pool = DummyConnectionPool.from_url("rediss://?ssl_cert_reqs=none")
+        assert pool.get_connection("_").cert_reqs == ssl.CERT_NONE
+
+        pool = DummyConnectionPool.from_url("rediss://?ssl_cert_reqs=optional")
+        assert pool.get_connection("_").cert_reqs == ssl.CERT_OPTIONAL
+
+        pool = DummyConnectionPool.from_url("rediss://?ssl_cert_reqs=required")
+        assert pool.get_connection("_").cert_reqs == ssl.CERT_REQUIRED
+
+        pool = DummyConnectionPool.from_url("rediss://?ssl_check_hostname=False")
+        assert pool.get_connection("_").check_hostname is False
+
+        pool = DummyConnectionPool.from_url("rediss://?ssl_check_hostname=True")
+        assert pool.get_connection("_").check_hostname is True
+
+
+@pytest.mark.onlynoncluster
+class TestConnection:
+    async def test_on_connect_error(self):
+        """
+        An error in Connection.on_connect should disconnect from the server
+        see for details: https://github.com/andymccurdy/redis-py/issues/368
+        """
+        # this assumes the Redis server being tested against doesn't have
+        # 9999 databases ;)
+        bad_connection = redis.Redis(db=9999)
+        # an error should be raised on connect
+        with pytest.raises(redis.RedisError):
+            await bad_connection.info()
+        pool = bad_connection.connection_pool
+        assert len(pool._available_connections) == 1
+        assert not pool._available_connections[0]._reader
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("2.8.8")
+    @skip_if_redis_enterprise()
+    async def test_busy_loading_disconnects_socket(self, r):
+        """
+        If Redis raises a LOADING error, the connection should be
+        disconnected and a BusyLoadingError raised
+        """
+        with pytest.raises(redis.BusyLoadingError):
+            await r.execute_command("DEBUG", "ERROR", "LOADING fake message")
+        if r.connection:
+            assert not r.connection._reader
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("2.8.8")
+    @skip_if_redis_enterprise()
+    async def test_busy_loading_from_pipeline_immediate_command(self, r):
+        """
+        BusyLoadingErrors should raise from Pipelines that execute a
+        command immediately, like WATCH does.
+        """
+        pipe = r.pipeline()
+        with pytest.raises(redis.BusyLoadingError):
+            await pipe.immediate_execute_command(
+                "DEBUG", "ERROR", "LOADING fake message"
+            )
+        pool = r.connection_pool
+        assert not pipe.connection
+        assert len(pool._available_connections) == 1
+        assert not pool._available_connections[0]._reader
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("2.8.8")
+    @skip_if_redis_enterprise()
+    async def test_busy_loading_from_pipeline(self, r):
+        """
+        BusyLoadingErrors should be raised from a pipeline execution
+        regardless of the raise_on_error flag.
+        """
+        pipe = r.pipeline()
+        pipe.execute_command("DEBUG", "ERROR", "LOADING fake message")
+        with pytest.raises(redis.BusyLoadingError):
+            await pipe.execute()
+        pool = r.connection_pool
+        assert not pipe.connection
+        assert len(pool._available_connections) == 1
+        assert not pool._available_connections[0]._reader
+
+    @skip_if_server_version_lt("2.8.8")
+    @skip_if_redis_enterprise()
+    async def test_read_only_error(self, r):
+        """READONLY errors get turned in ReadOnlyError exceptions"""
+        with pytest.raises(redis.ReadOnlyError):
+            await r.execute_command("DEBUG", "ERROR", "READONLY blah blah")
+
+    def test_connect_from_url_tcp(self):
+        connection = redis.Redis.from_url("redis://localhost")
+        pool = connection.connection_pool
+
+        assert re.match("(.*)<(.*)<(.*)>>", repr(pool)).groups() == (
+            "ConnectionPool",
+            "Connection",
+            "host=localhost,port=6379,db=0",
+        )
+
+    def test_connect_from_url_unix(self):
+        connection = redis.Redis.from_url("unix:///path/to/socket")
+        pool = connection.connection_pool
+
+        assert re.match("(.*)<(.*)<(.*)>>", repr(pool)).groups() == (
+            "ConnectionPool",
+            "UnixDomainSocketConnection",
+            "path=/path/to/socket,db=0",
+        )
+
+    @skip_if_redis_enterprise()
+    async def test_connect_no_auth_supplied_when_required(self, r):
+        """
+        AuthenticationError should be raised when the server requires a
+        password but one isn't supplied.
+        """
+        with pytest.raises(redis.AuthenticationError):
+            await r.execute_command(
+                "DEBUG", "ERROR", "ERR Client sent AUTH, but no password is set"
+            )
+
+    @skip_if_redis_enterprise()
+    async def test_connect_invalid_password_supplied(self, r):
+        """AuthenticationError should be raised when sending the wrong password"""
+        with pytest.raises(redis.AuthenticationError):
+            await r.execute_command("DEBUG", "ERROR", "ERR invalid password")
+
+
+@pytest.mark.onlynoncluster
+class TestMultiConnectionClient:
+    @pytest_asyncio.fixture()
+    async def r(self, create_redis, server):
+        redis = await create_redis(single_connection_client=False)
+        yield redis
+        await redis.flushall()
+
+
+@pytest.mark.onlynoncluster
+class TestHealthCheck:
+    interval = 60
+
+    @pytest_asyncio.fixture()
+    async def r(self, create_redis):
+        redis = await create_redis(health_check_interval=self.interval)
+        yield redis
+        await redis.flushall()
+
+    def assert_interval_advanced(self, connection):
+        diff = connection.next_health_check - asyncio.get_event_loop().time()
+        assert self.interval > diff > (self.interval - 1)
+
+    async def test_health_check_runs(self, r):
+        if r.connection:
+            r.connection.next_health_check = asyncio.get_event_loop().time() - 1
+            await r.connection.check_health()
+            self.assert_interval_advanced(r.connection)
+
+    async def test_arbitrary_command_invokes_health_check(self, r):
+        # invoke a command to make sure the connection is entirely setup
+        if r.connection:
+            await r.get("foo")
+            r.connection.next_health_check = asyncio.get_event_loop().time()
+            with mock.patch.object(
+                r.connection, "send_command", wraps=r.connection.send_command
+            ) as m:
+                await r.get("foo")
+                m.assert_called_with("PING", check_health=False)
+
+            self.assert_interval_advanced(r.connection)
+
+    async def test_arbitrary_command_advances_next_health_check(self, r):
+        if r.connection:
+            await r.get("foo")
+            next_health_check = r.connection.next_health_check
+            await r.get("foo")
+            assert next_health_check < r.connection.next_health_check
+
+    async def test_health_check_not_invoked_within_interval(self, r):
+        if r.connection:
+            await r.get("foo")
+            with mock.patch.object(
+                r.connection, "send_command", wraps=r.connection.send_command
+            ) as m:
+                await r.get("foo")
+                ping_call_spec = (("PING",), {"check_health": False})
+                assert ping_call_spec not in m.call_args_list
+
+    async def test_health_check_in_pipeline(self, r):
+        async with r.pipeline(transaction=False) as pipe:
+            pipe.connection = await pipe.connection_pool.get_connection("_")
+            pipe.connection.next_health_check = 0
+            with mock.patch.object(
+                pipe.connection, "send_command", wraps=pipe.connection.send_command
+            ) as m:
+                responses = await pipe.set("foo", "bar").get("foo").execute()
+                m.assert_any_call("PING", check_health=False)
+                assert responses == [True, b"bar"]
+
+    async def test_health_check_in_transaction(self, r):
+        async with r.pipeline(transaction=True) as pipe:
+            pipe.connection = await pipe.connection_pool.get_connection("_")
+            pipe.connection.next_health_check = 0
+            with mock.patch.object(
+                pipe.connection, "send_command", wraps=pipe.connection.send_command
+            ) as m:
+                responses = await pipe.set("foo", "bar").get("foo").execute()
+                m.assert_any_call("PING", check_health=False)
+                assert responses == [True, b"bar"]
+
+    async def test_health_check_in_watched_pipeline(self, r):
+        await r.set("foo", "bar")
+        async with r.pipeline(transaction=False) as pipe:
+            pipe.connection = await pipe.connection_pool.get_connection("_")
+            pipe.connection.next_health_check = 0
+            with mock.patch.object(
+                pipe.connection, "send_command", wraps=pipe.connection.send_command
+            ) as m:
+                await pipe.watch("foo")
+                # the health check should be called when watching
+                m.assert_called_with("PING", check_health=False)
+                self.assert_interval_advanced(pipe.connection)
+                assert await pipe.get("foo") == b"bar"
+
+                # reset the mock to clear the call list and schedule another
+                # health check
+                m.reset_mock()
+                pipe.connection.next_health_check = 0
+
+                pipe.multi()
+                responses = await pipe.set("foo", "not-bar").get("foo").execute()
+                assert responses == [True, b"not-bar"]
+                m.assert_any_call("PING", check_health=False)
+
+    async def test_health_check_in_pubsub_before_subscribe(self, r):
+        """A health check happens before the first [p]subscribe"""
+        p = r.pubsub()
+        p.connection = await p.connection_pool.get_connection("_")
+        p.connection.next_health_check = 0
+        with mock.patch.object(
+            p.connection, "send_command", wraps=p.connection.send_command
+        ) as m:
+            assert not p.subscribed
+            await p.subscribe("foo")
+            # the connection is not yet in pubsub mode, so the normal
+            # ping/pong within connection.send_command should check
+            # the health of the connection
+            m.assert_any_call("PING", check_health=False)
+            self.assert_interval_advanced(p.connection)
+
+            subscribe_message = await wait_for_message(p)
+            assert subscribe_message["type"] == "subscribe"
+
+    async def test_health_check_in_pubsub_after_subscribed(self, r):
+        """
+        Pubsub can handle a new subscribe when it's time to check the
+        connection health
+        """
+        p = r.pubsub()
+        p.connection = await p.connection_pool.get_connection("_")
+        p.connection.next_health_check = 0
+        with mock.patch.object(
+            p.connection, "send_command", wraps=p.connection.send_command
+        ) as m:
+            await p.subscribe("foo")
+            subscribe_message = await wait_for_message(p)
+            assert subscribe_message["type"] == "subscribe"
+            self.assert_interval_advanced(p.connection)
+            # because we weren't subscribed when sending the subscribe
+            # message to 'foo', the connection's standard check_health ran
+            # prior to subscribing.
+            m.assert_any_call("PING", check_health=False)
+
+            p.connection.next_health_check = 0
+            m.reset_mock()
+
+            await p.subscribe("bar")
+            # the second subscribe issues exactly only command (the subscribe)
+            # and the health check is not invoked
+            m.assert_called_once_with("SUBSCRIBE", "bar", check_health=False)
+
+            # since no message has been read since the health check was
+            # reset, it should still be 0
+            assert p.connection.next_health_check == 0
+
+            subscribe_message = await wait_for_message(p)
+            assert subscribe_message["type"] == "subscribe"
+            assert await wait_for_message(p) is None
+            # now that the connection is subscribed, the pubsub health
+            # check should have taken over and include the HEALTH_CHECK_MESSAGE
+            m.assert_any_call("PING", p.HEALTH_CHECK_MESSAGE, check_health=False)
+            self.assert_interval_advanced(p.connection)
+
+    async def test_health_check_in_pubsub_poll(self, r):
+        """
+        Polling a pubsub connection that's subscribed will regularly
+        check the connection's health.
+        """
+        p = r.pubsub()
+        p.connection = await p.connection_pool.get_connection("_")
+        with mock.patch.object(
+            p.connection, "send_command", wraps=p.connection.send_command
+        ) as m:
+            await p.subscribe("foo")
+            subscribe_message = await wait_for_message(p)
+            assert subscribe_message["type"] == "subscribe"
+            self.assert_interval_advanced(p.connection)
+
+            # polling the connection before the health check interval
+            # doesn't result in another health check
+            m.reset_mock()
+            next_health_check = p.connection.next_health_check
+            assert await wait_for_message(p) is None
+            assert p.connection.next_health_check == next_health_check
+            m.assert_not_called()
+
+            # reset the health check and poll again
+            # we should not receive a pong message, but the next_health_check
+            # should be advanced
+            p.connection.next_health_check = 0
+            assert await wait_for_message(p) is None
+            m.assert_called_with("PING", p.HEALTH_CHECK_MESSAGE, check_health=False)
+            self.assert_interval_advanced(p.connection)
diff --git a/tests/test_asyncio/test_encoding.py b/tests/test_asyncio/test_encoding.py
new file mode 100644
index 0000000000..da2983738e
--- /dev/null
+++ b/tests/test_asyncio/test_encoding.py
@@ -0,0 +1,126 @@
+import sys
+
+import pytest
+
+if sys.version_info[0:2] == (3, 6):
+    import pytest as pytest_asyncio
+else:
+    import pytest_asyncio
+
+import redis.asyncio as redis
+from redis.exceptions import DataError
+
+pytestmark = pytest.mark.asyncio
+
+
+@pytest.mark.onlynoncluster
+class TestEncoding:
+    @pytest_asyncio.fixture()
+    async def r(self, create_redis):
+        redis = await create_redis(decode_responses=True)
+        yield redis
+        await redis.flushall()
+
+    @pytest_asyncio.fixture()
+    async def r_no_decode(self, create_redis):
+        redis = await create_redis(decode_responses=False)
+        yield redis
+        await redis.flushall()
+
+    async def test_simple_encoding(self, r_no_decode: redis.Redis):
+        unicode_string = chr(3456) + "abcd" + chr(3421)
+        await r_no_decode.set("unicode-string", unicode_string.encode("utf-8"))
+        cached_val = await r_no_decode.get("unicode-string")
+        assert isinstance(cached_val, bytes)
+        assert unicode_string == cached_val.decode("utf-8")
+
+    async def test_simple_encoding_and_decoding(self, r: redis.Redis):
+        unicode_string = chr(3456) + "abcd" + chr(3421)
+        await r.set("unicode-string", unicode_string)
+        cached_val = await r.get("unicode-string")
+        assert isinstance(cached_val, str)
+        assert unicode_string == cached_val
+
+    async def test_memoryview_encoding(self, r_no_decode: redis.Redis):
+        unicode_string = chr(3456) + "abcd" + chr(3421)
+        unicode_string_view = memoryview(unicode_string.encode("utf-8"))
+        await r_no_decode.set("unicode-string-memoryview", unicode_string_view)
+        cached_val = await r_no_decode.get("unicode-string-memoryview")
+        # The cached value won't be a memoryview because it's a copy from Redis
+        assert isinstance(cached_val, bytes)
+        assert unicode_string == cached_val.decode("utf-8")
+
+    async def test_memoryview_encoding_and_decoding(self, r: redis.Redis):
+        unicode_string = chr(3456) + "abcd" + chr(3421)
+        unicode_string_view = memoryview(unicode_string.encode("utf-8"))
+        await r.set("unicode-string-memoryview", unicode_string_view)
+        cached_val = await r.get("unicode-string-memoryview")
+        assert isinstance(cached_val, str)
+        assert unicode_string == cached_val
+
+    async def test_list_encoding(self, r: redis.Redis):
+        unicode_string = chr(3456) + "abcd" + chr(3421)
+        result = [unicode_string, unicode_string, unicode_string]
+        await r.rpush("a", *result)
+        assert await r.lrange("a", 0, -1) == result
+
+
+@pytest.mark.onlynoncluster
+class TestEncodingErrors:
+    async def test_ignore(self, create_redis):
+        r = await create_redis(
+            decode_responses=True,
+            encoding_errors="ignore",
+        )
+        await r.set("a", b"foo\xff")
+        assert await r.get("a") == "foo"
+
+    async def test_replace(self, create_redis):
+        r = await create_redis(
+            decode_responses=True,
+            encoding_errors="replace",
+        )
+        await r.set("a", b"foo\xff")
+        assert await r.get("a") == "foo\ufffd"
+
+
+@pytest.mark.onlynoncluster
+class TestMemoryviewsAreNotPacked:
+    async def test_memoryviews_are_not_packed(self, r):
+        arg = memoryview(b"some_arg")
+        arg_list = ["SOME_COMMAND", arg]
+        c = r.connection or await r.connection_pool.get_connection("_")
+        cmd = c.pack_command(*arg_list)
+        assert cmd[1] is arg
+        cmds = c.pack_commands([arg_list, arg_list])
+        assert cmds[1] is arg
+        assert cmds[3] is arg
+
+
+class TestCommandsAreNotEncoded:
+    @pytest_asyncio.fixture()
+    async def r(self, create_redis):
+        redis = await create_redis(encoding="utf-16")
+        yield redis
+        await redis.flushall()
+
+    async def test_basic_command(self, r: redis.Redis):
+        await r.set("hello", "world")
+
+
+class TestInvalidUserInput:
+    async def test_boolean_fails(self, r: redis.Redis):
+        with pytest.raises(DataError):
+            await r.set("a", True)  # type: ignore
+
+    async def test_none_fails(self, r: redis.Redis):
+        with pytest.raises(DataError):
+            await r.set("a", None)  # type: ignore
+
+    async def test_user_type_fails(self, r: redis.Redis):
+        class Foo:
+            def __str__(self):
+                return "Foo"
+
+        with pytest.raises(DataError):
+            await r.set("a", Foo())  # type: ignore
diff --git a/tests/test_asyncio/test_lock.py b/tests/test_asyncio/test_lock.py
new file mode 100644
index 0000000000..c496718a67
--- /dev/null
+++ b/tests/test_asyncio/test_lock.py
@@ -0,0 +1,242 @@
+import asyncio
+import sys
+
+import pytest
+
+if sys.version_info[0:2] == (3, 6):
+    import pytest as pytest_asyncio
+else:
+    import pytest_asyncio
+
+from redis.asyncio.lock import Lock
+from redis.exceptions import LockError, LockNotOwnedError
+
+pytestmark = pytest.mark.asyncio
+
+
+@pytest.mark.onlynoncluster
+class TestLock:
+    @pytest_asyncio.fixture()
+    async def r_decoded(self, create_redis):
+        redis = await create_redis(decode_responses=True)
+        yield redis
+        await redis.flushall()
+
+    def get_lock(self, redis, *args, **kwargs):
+        kwargs["lock_class"] = Lock
+        return redis.lock(*args, **kwargs)
+
+    async def test_lock(self, r):
+        lock = self.get_lock(r, "foo")
+        assert await lock.acquire(blocking=False)
+        assert await r.get("foo") == lock.local.token
+        assert await r.ttl("foo") == -1
+        await lock.release()
+        assert await r.get("foo") is None
+
+    async def test_lock_token(self, r):
+        lock = self.get_lock(r, "foo")
+        await self._test_lock_token(r, lock)
+
+    async def test_lock_token_thread_local_false(self, r):
+        lock = self.get_lock(r, "foo", thread_local=False)
+        await self._test_lock_token(r, lock)
+
+    async def _test_lock_token(self, r, lock):
+        assert await lock.acquire(blocking=False, token="test")
+        assert await r.get("foo") == b"test"
+        assert lock.local.token == b"test"
+        assert await r.ttl("foo") == -1
+        await lock.release()
+        assert await r.get("foo") is None
+        assert lock.local.token is None
+
+    async def test_locked(self, r):
+        lock = self.get_lock(r, "foo")
+        assert await lock.locked() is False
+        await lock.acquire(blocking=False)
+        assert await lock.locked() is True
+        await lock.release()
+        assert await lock.locked() is False
+
+    async def _test_owned(self, client):
+        lock = self.get_lock(client, "foo")
+        assert await lock.owned() is False
+        await lock.acquire(blocking=False)
+        assert await lock.owned() is True
+        await lock.release()
+        assert await lock.owned() is False
+
+        lock2 = self.get_lock(client, "foo")
+        assert await lock.owned() is False
+        assert await lock2.owned() is False
+        await lock2.acquire(blocking=False)
+        assert await lock.owned() is False
+        assert await lock2.owned() is True
+        await lock2.release()
+        assert await lock.owned() is False
+        assert await lock2.owned() is False
+
+    async def test_owned(self, r):
+        await self._test_owned(r)
+
+    async def test_owned_with_decoded_responses(self, r_decoded):
+        await self._test_owned(r_decoded)
+
+    async def test_competing_locks(self, r):
+        lock1 = self.get_lock(r, "foo")
+        lock2 = self.get_lock(r, "foo")
+        assert await lock1.acquire(blocking=False)
+        assert not await lock2.acquire(blocking=False)
+        await lock1.release()
+        assert await lock2.acquire(blocking=False)
+        assert not await lock1.acquire(blocking=False)
+        await lock2.release()
+
+    async def test_timeout(self, r):
+        lock = self.get_lock(r, "foo", timeout=10)
+        assert await lock.acquire(blocking=False)
+        assert 8 < (await r.ttl("foo")) <= 10
+        await lock.release()
+
+    async def test_float_timeout(self, r):
+        lock = self.get_lock(r, "foo", timeout=9.5)
+        assert await lock.acquire(blocking=False)
+        assert 8 < (await r.pttl("foo")) <= 9500
+        await lock.release()
+
+    async def test_blocking_timeout(self, r, event_loop):
+        lock1 = self.get_lock(r, "foo")
+        assert await lock1.acquire(blocking=False)
+        bt = 0.2
+        sleep = 0.05
+        lock2 = self.get_lock(r, "foo", sleep=sleep, blocking_timeout=bt)
+        start = event_loop.time()
+        assert not await lock2.acquire()
+        # The elapsed duration should be less than the total blocking_timeout
+        assert bt > (event_loop.time() - start) > bt - sleep
+        await lock1.release()
+
+    async def test_context_manager(self, r):
+        # blocking_timeout prevents a deadlock if the lock can't be acquired
+        # for some reason
+        async with self.get_lock(r, "foo", blocking_timeout=0.2) as lock:
+            assert await r.get("foo") == lock.local.token
+        assert await r.get("foo") is None
+
+    async def test_context_manager_raises_when_locked_not_acquired(self, r):
+        await r.set("foo", "bar")
+        with pytest.raises(LockError):
+            async with self.get_lock(r, "foo", blocking_timeout=0.1):
+                pass
+
+    async def test_high_sleep_small_blocking_timeout(self, r):
+        lock1 = self.get_lock(r, "foo")
+        assert await lock1.acquire(blocking=False)
+        sleep = 60
+        bt = 1
+        lock2 = self.get_lock(r, "foo", sleep=sleep, blocking_timeout=bt)
+        start = asyncio.get_event_loop().time()
+        assert not await lock2.acquire()
+        # the elapsed timed is less than the blocking_timeout as the lock is
+        # unattainable given the sleep/blocking_timeout configuration
+        assert bt > (asyncio.get_event_loop().time() - start)
+        await lock1.release()
+
+    async def test_releasing_unlocked_lock_raises_error(self, r):
+        lock = self.get_lock(r, "foo")
+        with pytest.raises(LockError):
+            await lock.release()
+
+    async def test_releasing_lock_no_longer_owned_raises_error(self, r):
+        lock = self.get_lock(r, "foo")
+        await lock.acquire(blocking=False)
+        # manually change the token
+        await r.set("foo", "a")
+        with pytest.raises(LockNotOwnedError):
+            await lock.release()
+        # even though we errored, the token is still cleared
+        assert lock.local.token is None
+
+    async def test_extend_lock(self, r):
+        lock = self.get_lock(r, "foo", timeout=10)
+        assert await lock.acquire(blocking=False)
+        assert 8000 < (await r.pttl("foo")) <= 10000
+        assert await lock.extend(10)
+        assert 16000 < (await r.pttl("foo")) <= 20000
+        await lock.release()
+
+    async def test_extend_lock_replace_ttl(self, r):
+        lock = self.get_lock(r, "foo", timeout=10)
+        assert await lock.acquire(blocking=False)
+        assert 8000 < (await r.pttl("foo")) <= 10000
+        assert await lock.extend(10, replace_ttl=True)
+        assert 8000 < (await r.pttl("foo")) <= 10000
+        await lock.release()
+
+    async def test_extend_lock_float(self, r):
+        lock = self.get_lock(r, "foo", timeout=10.0)
+        assert await lock.acquire(blocking=False)
+        assert 8000 < (await r.pttl("foo")) <= 10000
+        assert await lock.extend(10.0)
+        assert 16000 < (await r.pttl("foo")) <= 20000
+        await lock.release()
+
+    async def test_extending_unlocked_lock_raises_error(self, r):
+        lock = self.get_lock(r, "foo", timeout=10)
+        with pytest.raises(LockError):
+            await lock.extend(10)
+
+    async def test_extending_lock_with_no_timeout_raises_error(self, r):
+        lock = self.get_lock(r, "foo")
+        assert await lock.acquire(blocking=False)
+        with pytest.raises(LockError):
+            await lock.extend(10)
+        await lock.release()
+
+    async def test_extending_lock_no_longer_owned_raises_error(self, r):
+        lock = self.get_lock(r, "foo", timeout=10)
+        assert await lock.acquire(blocking=False)
+        await r.set("foo", "a")
+        with pytest.raises(LockNotOwnedError):
+            await lock.extend(10)
+
+    async def test_reacquire_lock(self, r):
+        lock = self.get_lock(r, "foo", timeout=10)
+        assert await lock.acquire(blocking=False)
+        assert await r.pexpire("foo", 5000)
+        assert await r.pttl("foo") <= 5000
+        assert await lock.reacquire()
+        assert 8000 < (await r.pttl("foo")) <= 10000
+        await lock.release()
+
+    async def test_reacquiring_unlocked_lock_raises_error(self, r):
+        lock = self.get_lock(r, "foo", timeout=10)
+        with pytest.raises(LockError):
+            await lock.reacquire()
+
+    async def test_reacquiring_lock_with_no_timeout_raises_error(self, r):
+        lock = self.get_lock(r, "foo")
+        assert await lock.acquire(blocking=False)
+        with pytest.raises(LockError):
+            await lock.reacquire()
+        await lock.release()
+
+    async def test_reacquiring_lock_no_longer_owned_raises_error(self, r):
+        lock = self.get_lock(r, "foo", timeout=10)
+        assert await lock.acquire(blocking=False)
+        await r.set("foo", "a")
+        with pytest.raises(LockNotOwnedError):
+            await lock.reacquire()
+
+
+@pytest.mark.onlynoncluster
+class TestLockClassSelection:
+    def test_lock_class_argument(self, r):
+        class MyLock:
+            def __init__(self, *args, **kwargs):
+
+                pass
+
+        lock = r.lock("foo", lock_class=MyLock)
+        assert type(lock) == MyLock
diff --git a/tests/test_asyncio/test_monitor.py b/tests/test_asyncio/test_monitor.py
new file mode 100644
index 0000000000..783ba262b0
--- /dev/null
+++ b/tests/test_asyncio/test_monitor.py
@@ -0,0 +1,67 @@
+import pytest
+
+from tests.conftest import skip_if_redis_enterprise, skip_ifnot_redis_enterprise
+
+from .conftest import wait_for_command
+
+pytestmark = pytest.mark.asyncio
+
+
+@pytest.mark.onlynoncluster
+class TestMonitor:
+    async def test_wait_command_not_found(self, r):
+        """Make sure the wait_for_command func works when command is not found"""
+        async with r.monitor() as m:
+            response = await wait_for_command(r, m, "nothing")
+            assert response is None
+
+    async def test_response_values(self, r):
+        db = r.connection_pool.connection_kwargs.get("db", 0)
+        async with r.monitor() as m:
+            await r.ping()
+            response = await wait_for_command(r, m, "PING")
+            assert isinstance(response["time"], float)
+            assert response["db"] == db
+            assert response["client_type"] in ("tcp", "unix")
+            assert isinstance(response["client_address"], str)
+            assert isinstance(response["client_port"], str)
+            assert response["command"] == "PING"
+
+    async def test_command_with_quoted_key(self, r):
+        async with r.monitor() as m:
+            await r.get('foo"bar')
+            response = await wait_for_command(r, m, 'GET foo"bar')
+            assert response["command"] == 'GET foo"bar'
+
+    async def test_command_with_binary_data(self, r):
+        async with r.monitor() as m:
+            byte_string = b"foo\x92"
+            await r.get(byte_string)
+            response = await wait_for_command(r, m, "GET foo\\x92")
+            assert response["command"] == "GET foo\\x92"
+
+    async def test_command_with_escaped_data(self, r):
+        async with r.monitor() as m:
+            byte_string = b"foo\\x92"
+            await r.get(byte_string)
+            response = await wait_for_command(r, m, "GET foo\\\\x92")
+            assert response["command"] == "GET foo\\\\x92"
+
+    @skip_if_redis_enterprise()
+    async def test_lua_script(self, r):
+        async with r.monitor() as m:
+            script = 'return redis.call("GET", "foo")'
+            assert await r.eval(script, 0) is None
+            response = await wait_for_command(r, m, "GET foo")
+            assert response["command"] == "GET foo"
+            assert response["client_type"] == "lua"
+            assert response["client_address"] == "lua"
+            assert response["client_port"] == ""
+
+    @skip_ifnot_redis_enterprise()
+    async def test_lua_script_in_enterprise(self, r):
+        async with r.monitor() as m:
+            script = 'return redis.call("GET", "foo")'
+            assert await r.eval(script, 0) is None
+            response = await wait_for_command(r, m, "GET foo")
+            assert response is None
diff --git a/tests/test_asyncio/test_pipeline.py b/tests/test_asyncio/test_pipeline.py
new file mode 100644
index 0000000000..5bb1a8a4e0
--- /dev/null
+++ b/tests/test_asyncio/test_pipeline.py
@@ -0,0 +1,409 @@
+import pytest
+
+import redis
+from tests.conftest import skip_if_server_version_lt
+
+from .conftest import wait_for_command
+
+pytestmark = pytest.mark.asyncio
+
+
+@pytest.mark.onlynoncluster
+class TestPipeline:
+    async def test_pipeline_is_true(self, r):
+        """Ensure pipeline instances are not false-y"""
+        async with r.pipeline() as pipe:
+            assert pipe
+
+    async def test_pipeline(self, r):
+        async with r.pipeline() as pipe:
+            (
+                pipe.set("a", "a1")
+                .get("a")
+                .zadd("z", {"z1": 1})
+                .zadd("z", {"z2": 4})
+                .zincrby("z", 1, "z1")
+                .zrange("z", 0, 5, withscores=True)
+            )
+            assert await pipe.execute() == [
+                True,
+                b"a1",
+                True,
+                True,
+                2.0,
+                [(b"z1", 2.0), (b"z2", 4)],
+            ]
+
+    async def test_pipeline_memoryview(self, r):
+        async with r.pipeline() as pipe:
+            (pipe.set("a", memoryview(b"a1")).get("a"))
+            assert await pipe.execute() == [
+                True,
+                b"a1",
+            ]
+
+    async def test_pipeline_length(self, r):
+        async with r.pipeline() as pipe:
+            # Initially empty.
+            assert len(pipe) == 0
+
+            # Fill 'er up!
+            pipe.set("a", "a1").set("b", "b1").set("c", "c1")
+            assert len(pipe) == 3
+
+            # Execute calls reset(), so empty once again.
+            await pipe.execute()
+            assert len(pipe) == 0
+
+    @pytest.mark.onlynoncluster
+    async def test_pipeline_no_transaction(self, r):
+        async with r.pipeline(transaction=False) as pipe:
+            pipe.set("a", "a1").set("b", "b1").set("c", "c1")
+            assert await pipe.execute() == [True, True, True]
+            assert await r.get("a") == b"a1"
+            assert await r.get("b") == b"b1"
+            assert await r.get("c") == b"c1"
+
+    async def test_pipeline_no_transaction_watch(self, r):
+        await r.set("a", 0)
+
+        async with r.pipeline(transaction=False) as pipe:
+            await pipe.watch("a")
+            a = await pipe.get("a")
+
+            pipe.multi()
+            pipe.set("a", int(a) + 1)
+            assert await pipe.execute() == [True]
+
+    async def test_pipeline_no_transaction_watch_failure(self, r):
+        await r.set("a", 0)
+
+        async with r.pipeline(transaction=False) as pipe:
+            await pipe.watch("a")
+            a = await pipe.get("a")
+
+            await r.set("a", "bad")
+
+            pipe.multi()
+            pipe.set("a", int(a) + 1)
+
+            with pytest.raises(redis.WatchError):
+                await pipe.execute()
+
+            assert await r.get("a") == b"bad"
+
+    async def test_exec_error_in_response(self, r):
+        """
+        an invalid pipeline command at exec time adds the exception instance
+        to the list of returned values
+        """
+        await r.set("c", "a")
+        async with r.pipeline() as pipe:
+            pipe.set("a", 1).set("b", 2).lpush("c", 3).set("d", 4)
+            result = await pipe.execute(raise_on_error=False)
+
+            assert result[0]
+            assert await r.get("a") == b"1"
+            assert result[1]
+            assert await r.get("b") == b"2"
+
+            # we can't lpush to a key that's a string value, so this should
+            # be a ResponseError exception
+            assert isinstance(result[2], redis.ResponseError)
+            assert await r.get("c") == b"a"
+
+            # since this isn't a transaction, the other commands after the
+            # error are still executed
+            assert result[3]
+            assert await r.get("d") == b"4"
+
+            # make sure the pipe was restored to a working state
+            assert await pipe.set("z", "zzz").execute() == [True]
+            assert await r.get("z") == b"zzz"
+
+    async def test_exec_error_raised(self, r):
+        await r.set("c", "a")
+        async with r.pipeline() as pipe:
+            pipe.set("a", 1).set("b", 2).lpush("c", 3).set("d", 4)
+            with pytest.raises(redis.ResponseError) as ex:
+                await pipe.execute()
+            assert str(ex.value).startswith(
+                "Command # 3 (LPUSH c 3) of " "pipeline caused error: "
+            )
+
+            # make sure the pipe was restored to a working state
+            assert await pipe.set("z", "zzz").execute() == [True]
+            assert await r.get("z") == b"zzz"
+
+    @pytest.mark.onlynoncluster
+    async def test_transaction_with_empty_error_command(self, r):
+        """
+        Commands with custom EMPTY_ERROR functionality return their default
+        values in the pipeline no matter the raise_on_error preference
+        """
+        for error_switch in (True, False):
+            async with r.pipeline() as pipe:
+                pipe.set("a", 1).mget([]).set("c", 3)
+                result = await pipe.execute(raise_on_error=error_switch)
+
+                assert result[0]
+                assert result[1] == []
+                assert result[2]
+
+    @pytest.mark.onlynoncluster
+    async def test_pipeline_with_empty_error_command(self, r):
+        """
+        Commands with custom EMPTY_ERROR functionality return their default
+        values in the pipeline no matter the raise_on_error preference
+        """
+        for error_switch in (True, False):
+            async with r.pipeline(transaction=False) as pipe:
+                pipe.set("a", 1).mget([]).set("c", 3)
+                result = await pipe.execute(raise_on_error=error_switch)
+
+                assert result[0]
+                assert result[1] == []
+                assert result[2]
+
+    async def test_parse_error_raised(self, r):
+        async with r.pipeline() as pipe:
+            # the zrem is invalid because we don't pass any keys to it
+            pipe.set("a", 1).zrem("b").set("b", 2)
+            with pytest.raises(redis.ResponseError) as ex:
+                await pipe.execute()
+
+            assert str(ex.value).startswith(
+                "Command # 2 (ZREM b) of " "pipeline caused error: "
+            )
+
+            # make sure the pipe was restored to a working state
+            assert await pipe.set("z", "zzz").execute() == [True]
+            assert await r.get("z") == b"zzz"
+
+    @pytest.mark.onlynoncluster
+    async def test_parse_error_raised_transaction(self, r):
+        async with r.pipeline() as pipe:
+            pipe.multi()
+            # the zrem is invalid because we don't pass any keys to it
+            pipe.set("a", 1).zrem("b").set("b", 2)
+            with pytest.raises(redis.ResponseError) as ex:
+                await pipe.execute()
+
+            assert str(ex.value).startswith(
+                "Command # 2 (ZREM b) of " "pipeline caused error: "
+            )
+
+            # make sure the pipe was restored to a working state
+            assert await pipe.set("z", "zzz").execute() == [True]
+            assert await r.get("z") == b"zzz"
+
+    @pytest.mark.onlynoncluster
+    async def test_watch_succeed(self, r):
+        await r.set("a", 1)
+        await r.set("b", 2)
+
+        async with r.pipeline() as pipe:
+            await pipe.watch("a", "b")
+            assert pipe.watching
+            a_value = await pipe.get("a")
+            b_value = await pipe.get("b")
+            assert a_value == b"1"
+            assert b_value == b"2"
+            pipe.multi()
+
+            pipe.set("c", 3)
+            assert await pipe.execute() == [True]
+            assert not pipe.watching
+
+    @pytest.mark.onlynoncluster
+    async def test_watch_failure(self, r):
+        await r.set("a", 1)
+        await r.set("b", 2)
+
+        async with r.pipeline() as pipe:
+            await pipe.watch("a", "b")
+            await r.set("b", 3)
+            pipe.multi()
+            pipe.get("a")
+            with pytest.raises(redis.WatchError):
+                await pipe.execute()
+
+            assert not pipe.watching
+
+    @pytest.mark.onlynoncluster
+    async def test_watch_failure_in_empty_transaction(self, r):
+        await r.set("a", 1)
+        await r.set("b", 2)
+
+        async with r.pipeline() as pipe:
+            await pipe.watch("a", "b")
+            await r.set("b", 3)
+            pipe.multi()
+            with pytest.raises(redis.WatchError):
+                await pipe.execute()
+
+            assert not pipe.watching
+
+    @pytest.mark.onlynoncluster
+    async def test_unwatch(self, r):
+        await r.set("a", 1)
+        await r.set("b", 2)
+
+        async with r.pipeline() as pipe:
+            await pipe.watch("a", "b")
+            await r.set("b", 3)
+            await pipe.unwatch()
+            assert not pipe.watching
+            pipe.get("a")
+            assert await pipe.execute() == [b"1"]
+
+    @pytest.mark.onlynoncluster
+    async def test_watch_exec_no_unwatch(self, r):
+        await r.set("a", 1)
+        await r.set("b", 2)
+
+        async with r.monitor() as m:
+            async with r.pipeline() as pipe:
+                await pipe.watch("a", "b")
+                assert pipe.watching
+                a_value = await pipe.get("a")
+                b_value = await pipe.get("b")
+                assert a_value == b"1"
+                assert b_value == b"2"
+                pipe.multi()
+                pipe.set("c", 3)
+                assert await pipe.execute() == [True]
+                assert not pipe.watching
+
+            unwatch_command = await wait_for_command(r, m, "UNWATCH")
+            assert unwatch_command is None, "should not send UNWATCH"
+
+    @pytest.mark.onlynoncluster
+    async def test_watch_reset_unwatch(self, r):
+        await r.set("a", 1)
+
+        async with r.monitor() as m:
+            async with r.pipeline() as pipe:
+                await pipe.watch("a")
+                assert pipe.watching
+                await pipe.reset()
+                assert not pipe.watching
+
+            unwatch_command = await wait_for_command(r, m, "UNWATCH")
+            assert unwatch_command is not None
+            assert unwatch_command["command"] == "UNWATCH"
+
+    @pytest.mark.onlynoncluster
+    async def test_transaction_callable(self, r):
+        await r.set("a", 1)
+        await r.set("b", 2)
+        has_run = []
+
+        async def my_transaction(pipe):
+            a_value = await pipe.get("a")
+            assert a_value in (b"1", b"2")
+            b_value = await pipe.get("b")
+            assert b_value == b"2"
+
+            # silly run-once code... incr's "a" so WatchError should be raised
+            # forcing this all to run again. this should incr "a" once to "2"
+            if not has_run:
+                await r.incr("a")
+                has_run.append("it has")
+
+            pipe.multi()
+            pipe.set("c", int(a_value) + int(b_value))
+
+        result = await r.transaction(my_transaction, "a", "b")
+        assert result == [True]
+        assert await r.get("c") == b"4"
+
+    @pytest.mark.onlynoncluster
+    async def test_transaction_callable_returns_value_from_callable(self, r):
+        async def callback(pipe):
+            # No need to do anything here since we only want the return value
+            return "a"
+
+        res = await r.transaction(callback, "my-key", value_from_callable=True)
+        assert res == "a"
+
+    async def test_exec_error_in_no_transaction_pipeline(self, r):
+        await r.set("a", 1)
+        async with r.pipeline(transaction=False) as pipe:
+            pipe.llen("a")
+            pipe.expire("a", 100)
+
+            with pytest.raises(redis.ResponseError) as ex:
+                await pipe.execute()
+
+            assert str(ex.value).startswith(
+                "Command # 1 (LLEN a) of " "pipeline caused error: "
+            )
+
+        assert await r.get("a") == b"1"
+
+    async def test_exec_error_in_no_transaction_pipeline_unicode_command(self, r):
+        key = chr(3456) + "abcd" + chr(3421)
+        await r.set(key, 1)
+        async with r.pipeline(transaction=False) as pipe:
+            pipe.llen(key)
+            pipe.expire(key, 100)
+
+            with pytest.raises(redis.ResponseError) as ex:
+                await pipe.execute()
+
+            expected = f"Command # 1 (LLEN {key}) of pipeline caused error: "
+            assert str(ex.value).startswith(expected)
+
+        assert await r.get(key) == b"1"
+
+    async def test_pipeline_with_bitfield(self, r):
+        async with r.pipeline() as pipe:
+            pipe.set("a", "1")
+            bf = pipe.bitfield("b")
+            pipe2 = (
+                bf.set("u8", 8, 255)
+                .get("u8", 0)
+                .get("u4", 8)  # 1111
+                .get("u4", 12)  # 1111
+                .get("u4", 13)  # 1110
+                .execute()
+            )
+            pipe.get("a")
+            response = await pipe.execute()
+
+            assert pipe == pipe2
+            assert response == [True, [0, 0, 15, 15, 14], b"1"]
+
+    async def test_pipeline_get(self, r):
+        await r.set("a", "a1")
+        async with r.pipeline() as pipe:
+            await pipe.get("a")
+            assert await pipe.execute() == [b"a1"]
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("2.0.0")
+    async def test_pipeline_discard(self, r):
+
+        # empty pipeline should raise an error
+        async with r.pipeline() as pipe:
+            pipe.set("key", "someval")
+            await pipe.discard()
+            with pytest.raises(redis.exceptions.ResponseError):
+                await pipe.execute()
+
+        # setting a pipeline and discarding should do the same
+        async with r.pipeline() as pipe:
+            pipe.set("key", "someval")
+            pipe.set("someotherkey", "val")
+            response = await pipe.execute()
+            pipe.set("key", "another value!")
+            await pipe.discard()
+            pipe.set("key", "another vae!")
+            with pytest.raises(redis.exceptions.ResponseError):
+                await pipe.execute()
+
+            pipe.set("foo", "bar")
+            response = await pipe.execute()
+        assert response[0]
+        assert await r.get("foo") == b"bar"
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
new file mode 100644
index 0000000000..9efcd3cf8a
--- /dev/null
+++ b/tests/test_asyncio/test_pubsub.py
@@ -0,0 +1,660 @@
+import asyncio
+import sys
+from typing import Optional
+
+import pytest
+
+if sys.version_info[0:2] == (3, 6):
+    import pytest as pytest_asyncio
+else:
+    import pytest_asyncio
+
+import redis.asyncio as redis
+from redis.exceptions import ConnectionError
+from redis.typing import EncodableT
+from tests.conftest import skip_if_server_version_lt
+
+from .compat import mock
+
+pytestmark = pytest.mark.asyncio(forbid_global_loop=True)
+
+
+async def wait_for_message(pubsub, timeout=0.1, ignore_subscribe_messages=False):
+    now = asyncio.get_event_loop().time()
+    timeout = now + timeout
+    while now < timeout:
+        message = await pubsub.get_message(
+            ignore_subscribe_messages=ignore_subscribe_messages
+        )
+        if message is not None:
+            return message
+        await asyncio.sleep(0.01)
+        now = asyncio.get_event_loop().time()
+    return None
+
+
+def make_message(
+    type, channel: Optional[str], data: EncodableT, pattern: Optional[str] = None
+):
+    return {
+        "type": type,
+        "pattern": pattern and pattern.encode("utf-8") or None,
+        "channel": channel and channel.encode("utf-8") or None,
+        "data": data.encode("utf-8") if isinstance(data, str) else data,
+    }
+
+
+def make_subscribe_test_data(pubsub, type):
+    if type == "channel":
+        return {
+            "p": pubsub,
+            "sub_type": "subscribe",
+            "unsub_type": "unsubscribe",
+            "sub_func": pubsub.subscribe,
+            "unsub_func": pubsub.unsubscribe,
+            "keys": ["foo", "bar", "uni" + chr(4456) + "code"],
+        }
+    elif type == "pattern":
+        return {
+            "p": pubsub,
+            "sub_type": "psubscribe",
+            "unsub_type": "punsubscribe",
+            "sub_func": pubsub.psubscribe,
+            "unsub_func": pubsub.punsubscribe,
+            "keys": ["f*", "b*", "uni" + chr(4456) + "*"],
+        }
+    assert False, f"invalid subscribe type: {type}"
+
+
+@pytest.mark.onlynoncluster
+class TestPubSubSubscribeUnsubscribe:
+    async def _test_subscribe_unsubscribe(
+        self, p, sub_type, unsub_type, sub_func, unsub_func, keys
+    ):
+        for key in keys:
+            assert await sub_func(key) is None
+
+        # should be a message for each channel/pattern we just subscribed to
+        for i, key in enumerate(keys):
+            assert await wait_for_message(p) == make_message(sub_type, key, i + 1)
+
+        for key in keys:
+            assert await unsub_func(key) is None
+
+        # should be a message for each channel/pattern we just unsubscribed
+        # from
+        for i, key in enumerate(keys):
+            i = len(keys) - 1 - i
+            assert await wait_for_message(p) == make_message(unsub_type, key, i)
+
+    async def test_channel_subscribe_unsubscribe(self, r: redis.Redis):
+        kwargs = make_subscribe_test_data(r.pubsub(), "channel")
+        await self._test_subscribe_unsubscribe(**kwargs)
+
+    async def test_pattern_subscribe_unsubscribe(self, r: redis.Redis):
+        kwargs = make_subscribe_test_data(r.pubsub(), "pattern")
+        await self._test_subscribe_unsubscribe(**kwargs)
+
+    @pytest.mark.onlynoncluster
+    async def _test_resubscribe_on_reconnection(
+        self, p, sub_type, unsub_type, sub_func, unsub_func, keys
+    ):
+
+        for key in keys:
+            assert await sub_func(key) is None
+
+        # should be a message for each channel/pattern we just subscribed to
+        for i, key in enumerate(keys):
+            assert await wait_for_message(p) == make_message(sub_type, key, i + 1)
+
+        # manually disconnect
+        await p.connection.disconnect()
+
+        # calling get_message again reconnects and resubscribes
+        # note, we may not re-subscribe to channels in exactly the same order
+        # so we have to do some extra checks to make sure we got them all
+        messages = []
+        for i in range(len(keys)):
+            messages.append(await wait_for_message(p))
+
+        unique_channels = set()
+        assert len(messages) == len(keys)
+        for i, message in enumerate(messages):
+            assert message["type"] == sub_type
+            assert message["data"] == i + 1
+            assert isinstance(message["channel"], bytes)
+            channel = message["channel"].decode("utf-8")
+            unique_channels.add(channel)
+
+        assert len(unique_channels) == len(keys)
+        for channel in unique_channels:
+            assert channel in keys
+
+    async def test_resubscribe_to_channels_on_reconnection(self, r: redis.Redis):
+        kwargs = make_subscribe_test_data(r.pubsub(), "channel")
+        await self._test_resubscribe_on_reconnection(**kwargs)
+
+    async def test_resubscribe_to_patterns_on_reconnection(self, r: redis.Redis):
+        kwargs = make_subscribe_test_data(r.pubsub(), "pattern")
+        await self._test_resubscribe_on_reconnection(**kwargs)
+
+    async def _test_subscribed_property(
+        self, p, sub_type, unsub_type, sub_func, unsub_func, keys
+    ):
+
+        assert p.subscribed is False
+        await sub_func(keys[0])
+        # we're now subscribed even though we haven't processed the
+        # reply from the server just yet
+        assert p.subscribed is True
+        assert await wait_for_message(p) == make_message(sub_type, keys[0], 1)
+        # we're still subscribed
+        assert p.subscribed is True
+
+        # unsubscribe from all channels
+        await unsub_func()
+        # we're still technically subscribed until we process the
+        # response messages from the server
+        assert p.subscribed is True
+        assert await wait_for_message(p) == make_message(unsub_type, keys[0], 0)
+        # now we're no longer subscribed as no more messages can be delivered
+        # to any channels we were listening to
+        assert p.subscribed is False
+
+        # subscribing again flips the flag back
+        await sub_func(keys[0])
+        assert p.subscribed is True
+        assert await wait_for_message(p) == make_message(sub_type, keys[0], 1)
+
+        # unsubscribe again
+        await unsub_func()
+        assert p.subscribed is True
+        # subscribe to another channel before reading the unsubscribe response
+        await sub_func(keys[1])
+        assert p.subscribed is True
+        # read the unsubscribe for key1
+        assert await wait_for_message(p) == make_message(unsub_type, keys[0], 0)
+        # we're still subscribed to key2, so subscribed should still be True
+        assert p.subscribed is True
+        # read the key2 subscribe message
+        assert await wait_for_message(p) == make_message(sub_type, keys[1], 1)
+        await unsub_func()
+        # haven't read the message yet, so we're still subscribed
+        assert p.subscribed is True
+        assert await wait_for_message(p) == make_message(unsub_type, keys[1], 0)
+        # now we're finally unsubscribed
+        assert p.subscribed is False
+
+    async def test_subscribe_property_with_channels(self, r: redis.Redis):
+        kwargs = make_subscribe_test_data(r.pubsub(), "channel")
+        await self._test_subscribed_property(**kwargs)
+
+    @pytest.mark.onlynoncluster
+    async def test_subscribe_property_with_patterns(self, r: redis.Redis):
+        kwargs = make_subscribe_test_data(r.pubsub(), "pattern")
+        await self._test_subscribed_property(**kwargs)
+
+    async def test_ignore_all_subscribe_messages(self, r: redis.Redis):
+        p = r.pubsub(ignore_subscribe_messages=True)
+
+        checks = (
+            (p.subscribe, "foo"),
+            (p.unsubscribe, "foo"),
+            (p.psubscribe, "f*"),
+            (p.punsubscribe, "f*"),
+        )
+
+        assert p.subscribed is False
+        for func, channel in checks:
+            assert await func(channel) is None
+            assert p.subscribed is True
+            assert await wait_for_message(p) is None
+        assert p.subscribed is False
+
+    async def test_ignore_individual_subscribe_messages(self, r: redis.Redis):
+        p = r.pubsub()
+
+        checks = (
+            (p.subscribe, "foo"),
+            (p.unsubscribe, "foo"),
+            (p.psubscribe, "f*"),
+            (p.punsubscribe, "f*"),
+        )
+
+        assert p.subscribed is False
+        for func, channel in checks:
+            assert await func(channel) is None
+            assert p.subscribed is True
+            message = await wait_for_message(p, ignore_subscribe_messages=True)
+            assert message is None
+        assert p.subscribed is False
+
+    async def test_sub_unsub_resub_channels(self, r: redis.Redis):
+        kwargs = make_subscribe_test_data(r.pubsub(), "channel")
+        await self._test_sub_unsub_resub(**kwargs)
+
+    @pytest.mark.onlynoncluster
+    async def test_sub_unsub_resub_patterns(self, r: redis.Redis):
+        kwargs = make_subscribe_test_data(r.pubsub(), "pattern")
+        await self._test_sub_unsub_resub(**kwargs)
+
+    async def _test_sub_unsub_resub(
+        self, p, sub_type, unsub_type, sub_func, unsub_func, keys
+    ):
+        # https://github.com/andymccurdy/redis-py/issues/764
+        key = keys[0]
+        await sub_func(key)
+        await unsub_func(key)
+        await sub_func(key)
+        assert p.subscribed is True
+        assert await wait_for_message(p) == make_message(sub_type, key, 1)
+        assert await wait_for_message(p) == make_message(unsub_type, key, 0)
+        assert await wait_for_message(p) == make_message(sub_type, key, 1)
+        assert p.subscribed is True
+
+    async def test_sub_unsub_all_resub_channels(self, r: redis.Redis):
+        kwargs = make_subscribe_test_data(r.pubsub(), "channel")
+        await self._test_sub_unsub_all_resub(**kwargs)
+
+    async def test_sub_unsub_all_resub_patterns(self, r: redis.Redis):
+        kwargs = make_subscribe_test_data(r.pubsub(), "pattern")
+        await self._test_sub_unsub_all_resub(**kwargs)
+
+    async def _test_sub_unsub_all_resub(
+        self, p, sub_type, unsub_type, sub_func, unsub_func, keys
+    ):
+        # https://github.com/andymccurdy/redis-py/issues/764
+        key = keys[0]
+        await sub_func(key)
+        await unsub_func()
+        await sub_func(key)
+        assert p.subscribed is True
+        assert await wait_for_message(p) == make_message(sub_type, key, 1)
+        assert await wait_for_message(p) == make_message(unsub_type, key, 0)
+        assert await wait_for_message(p) == make_message(sub_type, key, 1)
+        assert p.subscribed is True
+
+
+@pytest.mark.onlynoncluster
+class TestPubSubMessages:
+    def setup_method(self, method):
+        self.message = None
+
+    def message_handler(self, message):
+        self.message = message
+
+    async def async_message_handler(self, message):
+        self.async_message = message
+
+    async def test_published_message_to_channel(self, r: redis.Redis):
+        p = r.pubsub()
+        await p.subscribe("foo")
+        assert await wait_for_message(p) == make_message("subscribe", "foo", 1)
+        assert await r.publish("foo", "test message") == 1
+
+        message = await wait_for_message(p)
+        assert isinstance(message, dict)
+        assert message == make_message("message", "foo", "test message")
+
+    async def test_published_message_to_pattern(self, r: redis.Redis):
+        p = r.pubsub()
+        await p.subscribe("foo")
+        await p.psubscribe("f*")
+        assert await wait_for_message(p) == make_message("subscribe", "foo", 1)
+        assert await wait_for_message(p) == make_message("psubscribe", "f*", 2)
+        # 1 to pattern, 1 to channel
+        assert await r.publish("foo", "test message") == 2
+
+        message1 = await wait_for_message(p)
+        message2 = await wait_for_message(p)
+        assert isinstance(message1, dict)
+        assert isinstance(message2, dict)
+
+        expected = [
+            make_message("message", "foo", "test message"),
+            make_message("pmessage", "foo", "test message", pattern="f*"),
+        ]
+
+        assert message1 in expected
+        assert message2 in expected
+        assert message1 != message2
+
+    async def test_channel_message_handler(self, r: redis.Redis):
+        p = r.pubsub(ignore_subscribe_messages=True)
+        await p.subscribe(foo=self.message_handler)
+        assert await wait_for_message(p) is None
+        assert await r.publish("foo", "test message") == 1
+        assert await wait_for_message(p) is None
+        assert self.message == make_message("message", "foo", "test message")
+
+    async def test_channel_async_message_handler(self, r):
+        p = r.pubsub(ignore_subscribe_messages=True)
+        await p.subscribe(foo=self.async_message_handler)
+        assert await wait_for_message(p) is None
+        assert await r.publish("foo", "test message") == 1
+        assert await wait_for_message(p) is None
+        assert self.async_message == make_message("message", "foo", "test message")
+
+    async def test_channel_sync_async_message_handler(self, r):
+        p = r.pubsub(ignore_subscribe_messages=True)
+        await p.subscribe(foo=self.message_handler)
+        await p.subscribe(bar=self.async_message_handler)
+        assert await wait_for_message(p) is None
+        assert await r.publish("foo", "test message") == 1
+        assert await r.publish("bar", "test message 2") == 1
+        assert await wait_for_message(p) is None
+        assert self.message == make_message("message", "foo", "test message")
+        assert self.async_message == make_message("message", "bar", "test message 2")
+
+    @pytest.mark.onlynoncluster
+    async def test_pattern_message_handler(self, r: redis.Redis):
+        p = r.pubsub(ignore_subscribe_messages=True)
+        await p.psubscribe(**{"f*": self.message_handler})
+        assert await wait_for_message(p) is None
+        assert await r.publish("foo", "test message") == 1
+        assert await wait_for_message(p) is None
+        assert self.message == make_message(
+            "pmessage", "foo", "test message", pattern="f*"
+        )
+
+    async def test_unicode_channel_message_handler(self, r: redis.Redis):
+        p = r.pubsub(ignore_subscribe_messages=True)
+        channel = "uni" + chr(4456) + "code"
+        channels = {channel: self.message_handler}
+        await p.subscribe(**channels)
+        assert await wait_for_message(p) is None
+        assert await r.publish(channel, "test message") == 1
+        assert await wait_for_message(p) is None
+        assert self.message == make_message("message", channel, "test message")
+
+    @pytest.mark.onlynoncluster
+    # see: https://redis-py-cluster.readthedocs.io/en/stable/pubsub.html
+    # #known-limitations-with-pubsub
+    async def test_unicode_pattern_message_handler(self, r: redis.Redis):
+        p = r.pubsub(ignore_subscribe_messages=True)
+        pattern = "uni" + chr(4456) + "*"
+        channel = "uni" + chr(4456) + "code"
+        await p.psubscribe(**{pattern: self.message_handler})
+        assert await wait_for_message(p) is None
+        assert await r.publish(channel, "test message") == 1
+        assert await wait_for_message(p) is None
+        assert self.message == make_message(
+            "pmessage", channel, "test message", pattern=pattern
+        )
+
+    async def test_get_message_without_subscribe(self, r: redis.Redis):
+        p = r.pubsub()
+        with pytest.raises(RuntimeError) as info:
+            await p.get_message()
+        expect = (
+            "connection not set: " "did you forget to call subscribe() or psubscribe()?"
+        )
+        assert expect in info.exconly()
+
+
+@pytest.mark.onlynoncluster
+class TestPubSubAutoDecoding:
+    """These tests only validate that we get unicode values back"""
+
+    channel = "uni" + chr(4456) + "code"
+    pattern = "uni" + chr(4456) + "*"
+    data = "abc" + chr(4458) + "123"
+
+    def make_message(self, type, channel, data, pattern=None):
+        return {"type": type, "channel": channel, "pattern": pattern, "data": data}
+
+    def setup_method(self, method):
+        self.message = None
+
+    def message_handler(self, message):
+        self.message = message
+
+    @pytest_asyncio.fixture()
+    async def r(self, create_redis):
+        return await create_redis(
+            decode_responses=True,
+        )
+
+    async def test_channel_subscribe_unsubscribe(self, r: redis.Redis):
+        p = r.pubsub()
+        await p.subscribe(self.channel)
+        assert await wait_for_message(p) == self.make_message(
+            "subscribe", self.channel, 1
+        )
+
+        await p.unsubscribe(self.channel)
+        assert await wait_for_message(p) == self.make_message(
+            "unsubscribe", self.channel, 0
+        )
+
+    async def test_pattern_subscribe_unsubscribe(self, r: redis.Redis):
+        p = r.pubsub()
+        await p.psubscribe(self.pattern)
+        assert await wait_for_message(p) == self.make_message(
+            "psubscribe", self.pattern, 1
+        )
+
+        await p.punsubscribe(self.pattern)
+        assert await wait_for_message(p) == self.make_message(
+            "punsubscribe", self.pattern, 0
+        )
+
+    async def test_channel_publish(self, r: redis.Redis):
+        p = r.pubsub()
+        await p.subscribe(self.channel)
+        assert await wait_for_message(p) == self.make_message(
+            "subscribe", self.channel, 1
+        )
+        await r.publish(self.channel, self.data)
+        assert await wait_for_message(p) == self.make_message(
+            "message", self.channel, self.data
+        )
+
+    @pytest.mark.onlynoncluster
+    async def test_pattern_publish(self, r: redis.Redis):
+        p = r.pubsub()
+        await p.psubscribe(self.pattern)
+        assert await wait_for_message(p) == self.make_message(
+            "psubscribe", self.pattern, 1
+        )
+        await r.publish(self.channel, self.data)
+        assert await wait_for_message(p) == self.make_message(
+            "pmessage", self.channel, self.data, pattern=self.pattern
+        )
+
+    async def test_channel_message_handler(self, r: redis.Redis):
+        p = r.pubsub(ignore_subscribe_messages=True)
+        await p.subscribe(**{self.channel: self.message_handler})
+        assert await wait_for_message(p) is None
+        await r.publish(self.channel, self.data)
+        assert await wait_for_message(p) is None
+        assert self.message == self.make_message("message", self.channel, self.data)
+
+        # test that we reconnected to the correct channel
+        self.message = None
+        await p.connection.disconnect()
+        assert await wait_for_message(p) is None  # should reconnect
+        new_data = self.data + "new data"
+        await r.publish(self.channel, new_data)
+        assert await wait_for_message(p) is None
+        assert self.message == self.make_message("message", self.channel, new_data)
+
+    async def test_pattern_message_handler(self, r: redis.Redis):
+        p = r.pubsub(ignore_subscribe_messages=True)
+        await p.psubscribe(**{self.pattern: self.message_handler})
+        assert await wait_for_message(p) is None
+        await r.publish(self.channel, self.data)
+        assert await wait_for_message(p) is None
+        assert self.message == self.make_message(
+            "pmessage", self.channel, self.data, pattern=self.pattern
+        )
+
+        # test that we reconnected to the correct pattern
+        self.message = None
+        await p.connection.disconnect()
+        assert await wait_for_message(p) is None  # should reconnect
+        new_data = self.data + "new data"
+        await r.publish(self.channel, new_data)
+        assert await wait_for_message(p) is None
+        assert self.message == self.make_message(
+            "pmessage", self.channel, new_data, pattern=self.pattern
+        )
+
+    async def test_context_manager(self, r: redis.Redis):
+        async with r.pubsub() as pubsub:
+            await pubsub.subscribe("foo")
+            assert pubsub.connection is not None
+
+        assert pubsub.connection is None
+        assert pubsub.channels == {}
+        assert pubsub.patterns == {}
+
+
+@pytest.mark.onlynoncluster
+class TestPubSubRedisDown:
+    async def test_channel_subscribe(self, r: redis.Redis):
+        r = redis.Redis(host="localhost", port=6390)
+        p = r.pubsub()
+        with pytest.raises(ConnectionError):
+            await p.subscribe("foo")
+
+
+@pytest.mark.onlynoncluster
+class TestPubSubSubcommands:
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("2.8.0")
+    async def test_pubsub_channels(self, r: redis.Redis):
+        p = r.pubsub()
+        await p.subscribe("foo", "bar", "baz", "quux")
+        for i in range(4):
+            assert (await wait_for_message(p))["type"] == "subscribe"
+        expected = [b"bar", b"baz", b"foo", b"quux"]
+        assert all([channel in await r.pubsub_channels() for channel in expected])
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("2.8.0")
+    async def test_pubsub_numsub(self, r: redis.Redis):
+        p1 = r.pubsub()
+        await p1.subscribe("foo", "bar", "baz")
+        for i in range(3):
+            assert (await wait_for_message(p1))["type"] == "subscribe"
+        p2 = r.pubsub()
+        await p2.subscribe("bar", "baz")
+        for i in range(2):
+            assert (await wait_for_message(p2))["type"] == "subscribe"
+        p3 = r.pubsub()
+        await p3.subscribe("baz")
+        assert (await wait_for_message(p3))["type"] == "subscribe"
+
+        channels = [(b"foo", 1), (b"bar", 2), (b"baz", 3)]
+        assert await r.pubsub_numsub("foo", "bar", "baz") == channels
+
+    @skip_if_server_version_lt("2.8.0")
+    async def test_pubsub_numpat(self, r: redis.Redis):
+        p = r.pubsub()
+        await p.psubscribe("*oo", "*ar", "b*z")
+        for i in range(3):
+            assert (await wait_for_message(p))["type"] == "psubscribe"
+        assert await r.pubsub_numpat() == 3
+
+
+@pytest.mark.onlynoncluster
+class TestPubSubPings:
+    @skip_if_server_version_lt("3.0.0")
+    async def test_send_pubsub_ping(self, r: redis.Redis):
+        p = r.pubsub(ignore_subscribe_messages=True)
+        await p.subscribe("foo")
+        await p.ping()
+        assert await wait_for_message(p) == make_message(
+            type="pong", channel=None, data="", pattern=None
+        )
+
+    @skip_if_server_version_lt("3.0.0")
+    async def test_send_pubsub_ping_message(self, r: redis.Redis):
+        p = r.pubsub(ignore_subscribe_messages=True)
+        await p.subscribe("foo")
+        await p.ping(message="hello world")
+        assert await wait_for_message(p) == make_message(
+            type="pong", channel=None, data="hello world", pattern=None
+        )
+
+
+@pytest.mark.onlynoncluster
+class TestPubSubConnectionKilled:
+    @skip_if_server_version_lt("3.0.0")
+    async def test_connection_error_raised_when_connection_dies(self, r: redis.Redis):
+        p = r.pubsub()
+        await p.subscribe("foo")
+        assert await wait_for_message(p) == make_message("subscribe", "foo", 1)
+        for client in await r.client_list():
+            if client["cmd"] == "subscribe":
+                await r.client_kill_filter(_id=client["id"])
+        with pytest.raises(ConnectionError):
+            await wait_for_message(p)
+
+
+@pytest.mark.onlynoncluster
+class TestPubSubTimeouts:
+    async def test_get_message_with_timeout_returns_none(self, r: redis.Redis):
+        p = r.pubsub()
+        await p.subscribe("foo")
+        assert await wait_for_message(p) == make_message("subscribe", "foo", 1)
+        assert await p.get_message(timeout=0.01) is None
+
+
+@pytest.mark.onlynoncluster
+class TestPubSubRun:
+    async def _subscribe(self, p, *args, **kwargs):
+        await p.subscribe(*args, **kwargs)
+        # Wait for the server to act on the subscription, to be sure that
+        # a subsequent publish on another connection will reach the pubsub.
+        while True:
+            message = await p.get_message(timeout=1)
+            if (
+                message is not None
+                and message["type"] == "subscribe"
+                and message["channel"] == b"foo"
+            ):
+                return
+
+    async def test_callbacks(self, r: redis.Redis):
+        def callback(message):
+            messages.put_nowait(message)
+
+        messages = asyncio.Queue()
+        p = r.pubsub()
+        await self._subscribe(p, foo=callback)
+        task = asyncio.get_event_loop().create_task(p.run())
+        await r.publish("foo", "bar")
+        message = await messages.get()
+        task.cancel()
+        try:
+            await task
+        except asyncio.CancelledError:
+            pass
+        assert message == {
+            "channel": b"foo",
+            "data": b"bar",
+            "pattern": None,
+            "type": "message",
+        }
+
+    async def test_exception_handler(self, r: redis.Redis):
+        def exception_handler_callback(e, pubsub) -> None:
+            assert pubsub == p
+            exceptions.put_nowait(e)
+
+        exceptions = asyncio.Queue()
+        p = r.pubsub()
+        await self._subscribe(p, foo=lambda x: None)
+        with mock.patch.object(p, "get_message", side_effect=Exception("error")):
+            task = asyncio.get_event_loop().create_task(
+                p.run(exception_handler=exception_handler_callback)
+            )
+            e = await exceptions.get()
+            task.cancel()
+            try:
+                await task
+            except asyncio.CancelledError:
+                pass
+        assert str(e) == "error"
diff --git a/tests/test_asyncio/test_retry.py b/tests/test_asyncio/test_retry.py
new file mode 100644
index 0000000000..e83e001847
--- /dev/null
+++ b/tests/test_asyncio/test_retry.py
@@ -0,0 +1,70 @@
+import pytest
+
+from redis.asyncio.connection import Connection, UnixDomainSocketConnection
+from redis.asyncio.retry import Retry
+from redis.backoff import AbstractBackoff, NoBackoff
+from redis.exceptions import ConnectionError
+
+
+class BackoffMock(AbstractBackoff):
+    def __init__(self):
+        self.reset_calls = 0
+        self.calls = 0
+
+    def reset(self):
+        self.reset_calls += 1
+
+    def compute(self, failures):
+        self.calls += 1
+        return 0
+
+
+@pytest.mark.onlynoncluster
+class TestConnectionConstructorWithRetry:
+    "Test that the Connection constructors properly handles Retry objects"
+
+    @pytest.mark.parametrize("retry_on_timeout", [False, True])
+    @pytest.mark.parametrize("Class", [Connection, UnixDomainSocketConnection])
+    def test_retry_on_timeout_boolean(self, Class, retry_on_timeout):
+        c = Class(retry_on_timeout=retry_on_timeout)
+        assert c.retry_on_timeout == retry_on_timeout
+        assert isinstance(c.retry, Retry)
+        assert c.retry._retries == (1 if retry_on_timeout else 0)
+
+    @pytest.mark.parametrize("retries", range(10))
+    @pytest.mark.parametrize("Class", [Connection, UnixDomainSocketConnection])
+    def test_retry_on_timeout_retry(self, Class, retries: int):
+        retry_on_timeout = retries > 0
+        c = Class(retry_on_timeout=retry_on_timeout, retry=Retry(NoBackoff(), retries))
+        assert c.retry_on_timeout == retry_on_timeout
+        assert isinstance(c.retry, Retry)
+        assert c.retry._retries == retries
+
+
+@pytest.mark.onlynoncluster
+class TestRetry:
+    "Test that Retry calls backoff and retries the expected number of times"
+
+    def setup_method(self, test_method):
+        self.actual_attempts = 0
+        self.actual_failures = 0
+
+    async def _do(self):
+        self.actual_attempts += 1
+        raise ConnectionError()
+
+    async def _fail(self, error):
+        self.actual_failures += 1
+
+    @pytest.mark.parametrize("retries", range(10))
+    @pytest.mark.asyncio
+    async def test_retry(self, retries: int):
+        backoff = BackoffMock()
+        retry = Retry(backoff, retries)
+        with pytest.raises(ConnectionError):
+            await retry.call_with_retry(self._do, self._fail)
+
+        assert self.actual_attempts == 1 + retries
+        assert self.actual_failures == 1 + retries
+        assert backoff.reset_calls == 1
+        assert backoff.calls == retries
diff --git a/tests/test_asyncio/test_scripting.py b/tests/test_asyncio/test_scripting.py
new file mode 100644
index 0000000000..764525fb4a
--- /dev/null
+++ b/tests/test_asyncio/test_scripting.py
@@ -0,0 +1,159 @@
+import sys
+
+import pytest
+
+if sys.version_info[0:2] == (3, 6):
+    import pytest as pytest_asyncio
+else:
+    import pytest_asyncio
+
+from redis import exceptions
+from tests.conftest import skip_if_server_version_lt
+
+multiply_script = """
+local value = redis.call('GET', KEYS[1])
+value = tonumber(value)
+return value * ARGV[1]"""
+
+msgpack_hello_script = """
+local message = cmsgpack.unpack(ARGV[1])
+local name = message['name']
+return "hello " .. name
+"""
+msgpack_hello_script_broken = """
+local message = cmsgpack.unpack(ARGV[1])
+local names = message['name']
+return "hello " .. name
+"""
+
+
+@pytest.mark.onlynoncluster
+class TestScripting:
+    @pytest_asyncio.fixture
+    async def r(self, create_redis):
+        redis = await create_redis()
+        yield redis
+        await redis.script_flush()
+
+    @pytest.mark.asyncio(forbid_global_loop=True)
+    async def test_eval(self, r):
+        await r.flushdb()
+        await r.set("a", 2)
+        # 2 * 3 == 6
+        assert await r.eval(multiply_script, 1, "a", 3) == 6
+
+    @pytest.mark.asyncio(forbid_global_loop=True)
+    @skip_if_server_version_lt("6.2.0")
+    async def test_script_flush(self, r):
+        await r.set("a", 2)
+        await r.script_load(multiply_script)
+        await r.script_flush("ASYNC")
+
+        await r.set("a", 2)
+        await r.script_load(multiply_script)
+        await r.script_flush("SYNC")
+
+        await r.set("a", 2)
+        await r.script_load(multiply_script)
+        await r.script_flush()
+
+        with pytest.raises(exceptions.DataError):
+            await r.set("a", 2)
+            await r.script_load(multiply_script)
+            await r.script_flush("NOTREAL")
+
+    @pytest.mark.asyncio(forbid_global_loop=True)
+    async def test_evalsha(self, r):
+        await r.set("a", 2)
+        sha = await r.script_load(multiply_script)
+        # 2 * 3 == 6
+        assert await r.evalsha(sha, 1, "a", 3) == 6
+
+    @pytest.mark.asyncio(forbid_global_loop=True)
+    async def test_evalsha_script_not_loaded(self, r):
+        await r.set("a", 2)
+        sha = await r.script_load(multiply_script)
+        # remove the script from Redis's cache
+        await r.script_flush()
+        with pytest.raises(exceptions.NoScriptError):
+            await r.evalsha(sha, 1, "a", 3)
+
+    @pytest.mark.asyncio(forbid_global_loop=True)
+    async def test_script_loading(self, r):
+        # get the sha, then clear the cache
+        sha = await r.script_load(multiply_script)
+        await r.script_flush()
+        assert await r.script_exists(sha) == [False]
+        await r.script_load(multiply_script)
+        assert await r.script_exists(sha) == [True]
+
+    @pytest.mark.asyncio(forbid_global_loop=True)
+    async def test_script_object(self, r):
+        await r.script_flush()
+        await r.set("a", 2)
+        multiply = r.register_script(multiply_script)
+        precalculated_sha = multiply.sha
+        assert precalculated_sha
+        assert await r.script_exists(multiply.sha) == [False]
+        # Test second evalsha block (after NoScriptError)
+        assert await multiply(keys=["a"], args=[3]) == 6
+        # At this point, the script should be loaded
+        assert await r.script_exists(multiply.sha) == [True]
+        # Test that the precalculated sha matches the one from redis
+        assert multiply.sha == precalculated_sha
+        # Test first evalsha block
+        assert await multiply(keys=["a"], args=[3]) == 6
+
+    @pytest.mark.asyncio(forbid_global_loop=True)
+    async def test_script_object_in_pipeline(self, r):
+        await r.script_flush()
+        multiply = r.register_script(multiply_script)
+        precalculated_sha = multiply.sha
+        assert precalculated_sha
+        pipe = r.pipeline()
+        pipe.set("a", 2)
+        pipe.get("a")
+        await multiply(keys=["a"], args=[3], client=pipe)
+        assert await r.script_exists(multiply.sha) == [False]
+        # [SET worked, GET 'a', result of multiple script]
+        assert await pipe.execute() == [True, b"2", 6]
+        # The script should have been loaded by pipe.execute()
+        assert await r.script_exists(multiply.sha) == [True]
+        # The precalculated sha should have been the correct one
+        assert multiply.sha == precalculated_sha
+
+        # purge the script from redis's cache and re-run the pipeline
+        # the multiply script should be reloaded by pipe.execute()
+        await r.script_flush()
+        pipe = r.pipeline()
+        pipe.set("a", 2)
+        pipe.get("a")
+        await multiply(keys=["a"], args=[3], client=pipe)
+        assert await r.script_exists(multiply.sha) == [False]
+        # [SET worked, GET 'a', result of multiple script]
+        assert await pipe.execute() == [True, b"2", 6]
+        assert await r.script_exists(multiply.sha) == [True]
+
+    @pytest.mark.asyncio(forbid_global_loop=True)
+    async def test_eval_msgpack_pipeline_error_in_lua(self, r):
+        msgpack_hello = r.register_script(msgpack_hello_script)
+        assert msgpack_hello.sha
+
+        pipe = r.pipeline()
+
+        # avoiding a dependency to msgpack, this is the output of
+        # msgpack.dumps({"name": "joe"})
+        msgpack_message_1 = b"\x81\xa4name\xa3Joe"
+
+        await msgpack_hello(args=[msgpack_message_1], client=pipe)
+
+        assert await r.script_exists(msgpack_hello.sha) == [False]
+        assert (await pipe.execute())[0] == b"hello Joe"
+        assert await r.script_exists(msgpack_hello.sha) == [True]
+
+        msgpack_hello_broken = r.register_script(msgpack_hello_script_broken)
+
+        await msgpack_hello_broken(args=[msgpack_message_1], client=pipe)
+        with pytest.raises(exceptions.ResponseError) as excinfo:
+            await pipe.execute()
+        assert excinfo.type == exceptions.ResponseError
diff --git a/tests/test_asyncio/test_sentinel.py b/tests/test_asyncio/test_sentinel.py
new file mode 100644
index 0000000000..cd6810c1b5
--- /dev/null
+++ b/tests/test_asyncio/test_sentinel.py
@@ -0,0 +1,249 @@
+import socket
+import sys
+
+import pytest
+
+if sys.version_info[0:2] == (3, 6):
+    import pytest as pytest_asyncio
+else:
+    import pytest_asyncio
+
+import redis.asyncio.sentinel
+from redis import exceptions
+from redis.asyncio.sentinel import (
+    MasterNotFoundError,
+    Sentinel,
+    SentinelConnectionPool,
+    SlaveNotFoundError,
+)
+
+pytestmark = pytest.mark.asyncio
+
+
+@pytest_asyncio.fixture(scope="module")
+def master_ip(master_host):
+    yield socket.gethostbyname(master_host)
+
+
+class SentinelTestClient:
+    def __init__(self, cluster, id):
+        self.cluster = cluster
+        self.id = id
+
+    async def sentinel_masters(self):
+        self.cluster.connection_error_if_down(self)
+        self.cluster.timeout_if_down(self)
+        return {self.cluster.service_name: self.cluster.master}
+
+    async def sentinel_slaves(self, master_name):
+        self.cluster.connection_error_if_down(self)
+        self.cluster.timeout_if_down(self)
+        if master_name != self.cluster.service_name:
+            return []
+        return self.cluster.slaves
+
+    async def execute_command(self, *args, **kwargs):
+        # wrapper purely to validate the calls don't explode
+        from redis.asyncio.client import bool_ok
+
+        return bool_ok
+
+
+class SentinelTestCluster:
+    def __init__(self, service_name="mymaster", ip="127.0.0.1", port=6379):
+        self.clients = {}
+        self.master = {
+            "ip": ip,
+            "port": port,
+            "is_master": True,
+            "is_sdown": False,
+            "is_odown": False,
+            "num-other-sentinels": 0,
+        }
+        self.service_name = service_name
+        self.slaves = []
+        self.nodes_down = set()
+        self.nodes_timeout = set()
+
+    def connection_error_if_down(self, node):
+        if node.id in self.nodes_down:
+            raise exceptions.ConnectionError
+
+    def timeout_if_down(self, node):
+        if node.id in self.nodes_timeout:
+            raise exceptions.TimeoutError
+
+    def client(self, host, port, **kwargs):
+        return SentinelTestClient(self, (host, port))
+
+
+@pytest_asyncio.fixture()
+async def cluster(master_ip):
+
+    cluster = SentinelTestCluster(ip=master_ip)
+    saved_Redis = redis.asyncio.sentinel.Redis
+    redis.asyncio.sentinel.Redis = cluster.client
+    yield cluster
+    redis.asyncio.sentinel.Redis = saved_Redis
+
+
+@pytest_asyncio.fixture()
+def sentinel(request, cluster):
+    return Sentinel([("foo", 26379), ("bar", 26379)])
+
+
+@pytest.mark.onlynoncluster
+async def test_discover_master(sentinel, master_ip):
+    address = await sentinel.discover_master("mymaster")
+    assert address == (master_ip, 6379)
+
+
+@pytest.mark.onlynoncluster
+async def test_discover_master_error(sentinel):
+    with pytest.raises(MasterNotFoundError):
+        await sentinel.discover_master("xxx")
+
+
+@pytest.mark.onlynoncluster
+async def test_discover_master_sentinel_down(cluster, sentinel, master_ip):
+    # Put first sentinel 'foo' down
+    cluster.nodes_down.add(("foo", 26379))
+    address = await sentinel.discover_master("mymaster")
+    assert address == (master_ip, 6379)
+    # 'bar' is now first sentinel
+    assert sentinel.sentinels[0].id == ("bar", 26379)
+
+
+@pytest.mark.onlynoncluster
+async def test_discover_master_sentinel_timeout(cluster, sentinel, master_ip):
+    # Put first sentinel 'foo' down
+    cluster.nodes_timeout.add(("foo", 26379))
+    address = await sentinel.discover_master("mymaster")
+    assert address == (master_ip, 6379)
+    # 'bar' is now first sentinel
+    assert sentinel.sentinels[0].id == ("bar", 26379)
+
+
+@pytest.mark.onlynoncluster
+async def test_master_min_other_sentinels(cluster, master_ip):
+    sentinel = Sentinel([("foo", 26379)], min_other_sentinels=1)
+    # min_other_sentinels
+    with pytest.raises(MasterNotFoundError):
+        await sentinel.discover_master("mymaster")
+    cluster.master["num-other-sentinels"] = 2
+    address = await sentinel.discover_master("mymaster")
+    assert address == (master_ip, 6379)
+
+
+@pytest.mark.onlynoncluster
+async def test_master_odown(cluster, sentinel):
+    cluster.master["is_odown"] = True
+    with pytest.raises(MasterNotFoundError):
+        await sentinel.discover_master("mymaster")
+
+
+@pytest.mark.onlynoncluster
+async def test_master_sdown(cluster, sentinel):
+    cluster.master["is_sdown"] = True
+    with pytest.raises(MasterNotFoundError):
+        await sentinel.discover_master("mymaster")
+
+
+@pytest.mark.onlynoncluster
+async def test_discover_slaves(cluster, sentinel):
+    assert await sentinel.discover_slaves("mymaster") == []
+
+    cluster.slaves = [
+        {"ip": "slave0", "port": 1234, "is_odown": False, "is_sdown": False},
+        {"ip": "slave1", "port": 1234, "is_odown": False, "is_sdown": False},
+    ]
+    assert await sentinel.discover_slaves("mymaster") == [
+        ("slave0", 1234),
+        ("slave1", 1234),
+    ]
+
+    # slave0 -> ODOWN
+    cluster.slaves[0]["is_odown"] = True
+    assert await sentinel.discover_slaves("mymaster") == [("slave1", 1234)]
+
+    # slave1 -> SDOWN
+    cluster.slaves[1]["is_sdown"] = True
+    assert await sentinel.discover_slaves("mymaster") == []
+
+    cluster.slaves[0]["is_odown"] = False
+    cluster.slaves[1]["is_sdown"] = False
+
+    # node0 -> DOWN
+    cluster.nodes_down.add(("foo", 26379))
+    assert await sentinel.discover_slaves("mymaster") == [
+        ("slave0", 1234),
+        ("slave1", 1234),
+    ]
+    cluster.nodes_down.clear()
+
+    # node0 -> TIMEOUT
+    cluster.nodes_timeout.add(("foo", 26379))
+    assert await sentinel.discover_slaves("mymaster") == [
+        ("slave0", 1234),
+        ("slave1", 1234),
+    ]
+
+
+@pytest.mark.onlynoncluster
+async def test_master_for(cluster, sentinel, master_ip):
+    master = sentinel.master_for("mymaster", db=9)
+    assert await master.ping()
+    assert master.connection_pool.master_address == (master_ip, 6379)
+
+    # Use internal connection check
+    master = sentinel.master_for("mymaster", db=9, check_connection=True)
+    assert await master.ping()
+
+
+@pytest.mark.onlynoncluster
+async def test_slave_for(cluster, sentinel):
+    cluster.slaves = [
+        {"ip": "127.0.0.1", "port": 6379, "is_odown": False, "is_sdown": False},
+    ]
+    slave = sentinel.slave_for("mymaster", db=9)
+    assert await slave.ping()
+
+
+@pytest.mark.onlynoncluster
+async def test_slave_for_slave_not_found_error(cluster, sentinel):
+    cluster.master["is_odown"] = True
+    slave = sentinel.slave_for("mymaster", db=9)
+    with pytest.raises(SlaveNotFoundError):
+        await slave.ping()
+
+
+@pytest.mark.onlynoncluster
+async def test_slave_round_robin(cluster, sentinel, master_ip):
+    cluster.slaves = [
+        {"ip": "slave0", "port": 6379, "is_odown": False, "is_sdown": False},
+        {"ip": "slave1", "port": 6379, "is_odown": False, "is_sdown": False},
+    ]
+    pool = SentinelConnectionPool("mymaster", sentinel)
+    rotator = pool.rotate_slaves()
+    assert await rotator.__anext__() in (("slave0", 6379), ("slave1", 6379))
+    assert await rotator.__anext__() in (("slave0", 6379), ("slave1", 6379))
+    # Fallback to master
+    assert await rotator.__anext__() == (master_ip, 6379)
+    with pytest.raises(SlaveNotFoundError):
+        await rotator.__anext__()
+
+
+@pytest.mark.onlynoncluster
+async def test_ckquorum(cluster, sentinel):
+    assert await sentinel.sentinel_ckquorum("mymaster")
+
+
+@pytest.mark.onlynoncluster
+async def test_flushconfig(cluster, sentinel):
+    assert await sentinel.sentinel_flushconfig()
+
+
+@pytest.mark.onlynoncluster
+async def test_reset(cluster, sentinel):
+    cluster.master["is_odown"] = True
+    assert await sentinel.sentinel_reset("mymaster")
diff --git a/tox.ini b/tox.ini
index 2639cb7a2e..3ef01ddead 100644
--- a/tox.ini
+++ b/tox.ini
@@ -10,7 +10,7 @@ markers =
 [tox]
 minversion = 3.2.0
 requires = tox-docker
-envlist = {standalone,cluster}-{plain,hiredis,ocsp}-{py36,py37,py38,py39,pypy3},linters,docs
+envlist = {standalone,cluster}-{plain,hiredis,ocsp}-{uvloop,asyncio}-{py36,py37,py38,py39,pypy3},linters,docs
 
 [docker:master]
 name = master
@@ -270,7 +270,9 @@ setenv =
     CLUSTER_URL = "redis://localhost:16379/0"
 commands =
     standalone: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' {posargs}
+    standalone-uvloop: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' --uvloop {posargs}
     cluster: pytest --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={env:CLUSTER_URL:} {posargs}
+    cluster-uvloop: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' --uvloop {posargs}
 
 [testenv:redis5]
 deps =
@@ -350,6 +352,7 @@ exclude =
     dist,
     docker,
     venv*,
+    .venv*,
     whitelist.py
 ignore =
     F405
diff --git a/whitelist.py b/whitelist.py
index 891ccd6022..27210284c7 100644
--- a/whitelist.py
+++ b/whitelist.py
@@ -10,3 +10,8 @@
 exc_type  # unused variable (/data/repos/redis/redis-py/redis/lock.py:156)
 exc_value  # unused variable (/data/repos/redis/redis-py/redis/lock.py:156)
 traceback  # unused variable (/data/repos/redis/redis-py/redis/lock.py:156)
+exc_type  # unused variable (/data/repos/redis/redis-py/redis/asyncio/utils.py:26)
+exc_value  # unused variable (/data/repos/redis/redis-py/redis/asyncio/utils.py:26)
+traceback  # unused variable (/data/repos/redis/redis-py/redis/asyncio/utils.py:26)
+AsyncConnectionPool  # unused import (//data/repos/redis/redis-py/redis/typing.py:9)
+AsyncRedis  # unused import (//data/repos/redis/redis-py/redis/commands/core.py:49)

From f2e34739fccab28a28a066a3ece955eb455b32f9 Mon Sep 17 00:00:00 2001
From: Mike Shchurov <mykhailo.shchurov@wolt.com>
Date: Tue, 22 Feb 2022 12:46:45 +0200
Subject: [PATCH 0400/1164] FixingElevated CPU utilization on one node when
 using RedisCluster pipeline (#1985)

---
 redis/cluster.py | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index b594d3084a..7151cfebce 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -712,6 +712,7 @@ def pipeline(self, transaction=None, shard_hint=None):
 
         return ClusterPipeline(
             nodes_manager=self.nodes_manager,
+            commands_parser=self.commands_parser,
             startup_nodes=self.nodes_manager.startup_nodes,
             result_callbacks=self.result_callbacks,
             cluster_response_callbacks=self.cluster_response_callbacks,
@@ -1598,6 +1599,7 @@ class ClusterPipeline(RedisCluster):
     def __init__(
         self,
         nodes_manager,
+        commands_parser,
         result_callbacks=None,
         cluster_response_callbacks=None,
         startup_nodes=None,
@@ -1610,6 +1612,7 @@ def __init__(
         log.info("Creating new instance of ClusterPipeline")
         self.command_stack = []
         self.nodes_manager = nodes_manager
+        self.commands_parser = commands_parser
         self.refresh_table_asap = False
         self.result_callbacks = (
             result_callbacks or self.__class__.RESULT_CALLBACKS.copy()
@@ -1627,11 +1630,6 @@ def __init__(
             kwargs.get("decode_responses", False),
         )
 
-        # The commands parser refers to the parent
-        # so that we don't push the COMMAND command
-        # onto the stack
-        self.commands_parser = CommandsParser(super())
-
     def __repr__(self):
         """ """
         return f"{type(self).__name__}"

From fa76ac49a9ea02c204bd4f1644f39d90140cf356 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 22 Feb 2022 13:11:55 +0200
Subject: [PATCH 0401/1164] Add support for Redis 7 functions (#1998)

* add function support

* linters

* test fcall

* decode reponses for unstable_r

* linters

* fix evalsho_ro test

* fix eval_ro test

* add response callbaks

* linters
---
 redis/client.py         |   4 ++
 redis/commands/core.py  | 126 ++++++++++++++++++++++++++++++++++++++++
 redis/connection.py     |  11 +++-
 tests/conftest.py       |   4 +-
 tests/test_commands.py  |  22 +++----
 tests/test_function.py  |  94 ++++++++++++++++++++++++++++++
 tests/test_scripting.py |   4 +-
 7 files changed, 249 insertions(+), 16 deletions(-)
 create mode 100644 tests/test_function.py

diff --git a/redis/client.py b/redis/client.py
index 22c5dc1e57..0eade79e90 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -733,6 +733,10 @@ class AbstractRedis:
         "CONFIG RESETSTAT": bool_ok,
         "CONFIG SET": bool_ok,
         "DEBUG OBJECT": parse_debug_object,
+        "FUNCTION DELETE": bool_ok,
+        "FUNCTION FLUSH": bool_ok,
+        "FUNCTION LOAD": bool_ok,
+        "FUNCTION RESTORE": bool_ok,
         "GEOHASH": lambda r: list(map(str_if_bytes, r)),
         "GEOPOS": lambda r: list(
             map(lambda ll: (float(ll[0]), float(ll[1])) if ll is not None else None, r)
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 80bc55ff22..e74550f335 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -5429,6 +5429,131 @@ def readonly(self, **kwargs) -> ResponseT:
         return self.execute_command("READONLY", **kwargs)
 
 
+class FunctionCommands:
+    """
+    Redis Function commands
+    """
+
+    def function_load(
+        self,
+        engine: str,
+        library: str,
+        code: str,
+        replace: Optional[bool] = False,
+        description: Optional[str] = None,
+    ) -> str:
+        """
+        Load a library to Redis.
+        :param engine: the name of the execution engine for the library
+        :param library: the unique name of the library
+        :param code: the source code
+        :param replace: changes the behavior to replace the library if a library called
+         ``library`` already exists
+        :param description: description to the library
+
+        For more information check https://redis.io/commands/function-load
+        """
+        pieces = [engine, library]
+        if replace:
+            pieces.append("REPLACE")
+        if description is not None:
+            pieces.append(description)
+        pieces.append(code)
+        return self.execute_command("FUNCTION LOAD", *pieces)
+
+    def function_delete(self, library: str) -> str:
+        """
+        Delete the library called ``library`` and all its functions.
+
+        For more information check https://redis.io/commands/function-delete
+        """
+        return self.execute_command("FUNCTION DELETE", library)
+
+    def function_flush(self, mode: str = "SYNC") -> str:
+        """
+        Deletes all the libraries.
+
+        For more information check https://redis.io/commands/function-flush
+        """
+        return self.execute_command("FUNCTION FLUSH", mode)
+
+    def function_list(
+        self, library: Optional[str] = "*", withcode: Optional[bool] = False
+    ) -> List:
+        """
+        Return information about the functions and libraries.
+        :param library: pecify a pattern for matching library names
+        :param withcode: cause the server to include the libraries source
+         implementation in the reply
+        """
+        args = ["LIBRARYNAME", library]
+        if withcode:
+            args.append("WITHCODE")
+        return self.execute_command("FUNCTION LIST", *args)
+
+    def _fcall(
+        self, command: str, function, numkeys: int, *keys_and_args: Optional[List]
+    ) -> str:
+        return self.execute_command(command, function, numkeys, *keys_and_args)
+
+    def fcall(self, function, numkeys: int, *keys_and_args: Optional[List]) -> str:
+        """
+        Invoke a function.
+
+        For more information check https://redis.io/commands/fcall
+        """
+        return self._fcall("FCALL", function, numkeys, *keys_and_args)
+
+    def fcall_ro(self, function, numkeys: int, *keys_and_args: Optional[List]) -> str:
+        """
+        This is a read-only variant of the FCALL command that cannot
+        execute commands that modify data.
+
+        For more information check https://redis.io/commands/fcal_ro
+        """
+        return self._fcall("FCALL_RO", function, numkeys, *keys_and_args)
+
+    def function_dump(self) -> str:
+        """
+        Return the serialized payload of loaded libraries.
+
+        For more information check https://redis.io/commands/function-dump
+        """
+        from redis.client import NEVER_DECODE
+
+        options = {}
+        options[NEVER_DECODE] = []
+
+        return self.execute_command("FUNCTION DUMP", **options)
+
+    def function_restore(self, payload: str, policy: Optional[str] = "APPEND") -> str:
+        """
+        Restore libraries from the serialized ``payload``.
+        You can use the optional policy argument to provide a policy
+        for handling existing libraries.
+
+        For more information check https://redis.io/commands/function-restore
+        """
+        return self.execute_command("FUNCTION RESTORE", payload, policy)
+
+    def function_kill(self) -> str:
+        """
+        Kill a function that is currently executing.
+
+        For more information check https://redis.io/commands/function-kill
+        """
+        return self.execute_command("FUNCTION KILL")
+
+    def function_stats(self) -> list:
+        """
+        Return information about the function that's currently running
+        and information about the available execution engines.
+
+        For more information check https://redis.io/commands/function-stats
+        """
+        return self.execute_command("FUNCTION STATS")
+
+
 AsyncClusterCommands = ClusterCommands
 
 
@@ -5474,6 +5599,7 @@ class CoreCommands(
     ModuleCommands,
     PubSubCommands,
     ScriptCommands,
+    FunctionCommands,
 ):
     """
     A class containing all of the implemented redis commands. This class is
diff --git a/redis/connection.py b/redis/connection.py
index 891695d31e..189cecb72f 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -463,10 +463,17 @@ def read_response(self, disable_decoding=False):
             self._next_response = False
             return response
 
-        response = self._reader.gets()
+        if disable_decoding:
+            response = self._reader.gets(False)
+        else:
+            response = self._reader.gets()
+
         while response is False:
             self.read_from_socket()
-            response = self._reader.gets()
+            if disable_decoding:
+                response = self._reader.gets(False)
+            else:
+                response = self._reader.gets()
         # if an older version of hiredis is installed, we need to attempt
         # to convert ResponseErrors to their appropriate types.
         if not HIREDIS_SUPPORTS_CALLABLE_ERRORS:
diff --git a/tests/conftest.py b/tests/conftest.py
index 2534ca0c95..b615915bb2 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -434,7 +434,9 @@ def master_host(request):
 @pytest.fixture()
 def unstable_r(request):
     url = request.config.getoption("--redis-unstable-url")
-    with _get_client(redis.Redis, request, from_url=url) as client:
+    with _get_client(
+        redis.Redis, request, from_url=url, decode_responses=True
+    ) as client:
         yield client
 
 
diff --git a/tests/test_commands.py b/tests/test_commands.py
index ad9ee2c5fd..5c32d5f296 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -612,7 +612,7 @@ def test_client_unpause(self, r):
     @pytest.mark.onlynoncluster
     # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
     def test_client_no_evict(self, unstable_r):
-        assert unstable_r.client_no_evict("ON") == b"OK"
+        assert unstable_r.client_no_evict("ON") == "OK"
         with pytest.raises(TypeError):
             unstable_r.client_no_evict()
 
@@ -985,9 +985,9 @@ def test_unlink_with_multiple_keys(self, r):
     # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
     def test_lcs(self, unstable_r):
         unstable_r.mset({"foo": "ohmytext", "bar": "mynewtext"})
-        assert unstable_r.lcs("foo", "bar") == b"mytext"
+        assert unstable_r.lcs("foo", "bar") == "mytext"
         assert unstable_r.lcs("foo", "bar", len=True) == 6
-        result = [b"matches", [[[4, 7], [5, 8]]], b"len", 6]
+        result = ["matches", [[[4, 7], [5, 8]]], "len", 6]
         assert unstable_r.lcs("foo", "bar", idx=True, minmatchlen=3) == result
         with pytest.raises(redis.ResponseError):
             assert unstable_r.lcs("foo", "bar", len=True, idx=True)
@@ -1522,24 +1522,24 @@ def test_brpoplpush_empty_string(self, r):
     # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
     def test_blmpop(self, unstable_r):
         unstable_r.rpush("a", "1", "2", "3", "4", "5")
-        res = [b"a", [b"1", b"2"]]
+        res = ["a", ["1", "2"]]
         assert unstable_r.blmpop(1, "2", "b", "a", direction="LEFT", count=2) == res
         with pytest.raises(TypeError):
             unstable_r.blmpop(1, "2", "b", "a", count=2)
         unstable_r.rpush("b", "6", "7", "8", "9")
-        assert unstable_r.blmpop(0, "2", "b", "a", direction="LEFT") == [b"b", [b"6"]]
+        assert unstable_r.blmpop(0, "2", "b", "a", direction="LEFT") == ["b", ["6"]]
         assert unstable_r.blmpop(1, "2", "foo", "bar", direction="RIGHT") is None
 
     @pytest.mark.onlynoncluster
     # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
     def test_lmpop(self, unstable_r):
         unstable_r.rpush("foo", "1", "2", "3", "4", "5")
-        result = [b"foo", [b"1", b"2"]]
+        result = ["foo", ["1", "2"]]
         assert unstable_r.lmpop("2", "bar", "foo", direction="LEFT", count=2) == result
         with pytest.raises(redis.ResponseError):
             unstable_r.lmpop("2", "bar", "foo", direction="up", count=2)
         unstable_r.rpush("bar", "a", "b", "c", "d")
-        assert unstable_r.lmpop("2", "bar", "foo", direction="LEFT") == [b"bar", [b"a"]]
+        assert unstable_r.lmpop("2", "bar", "foo", direction="LEFT") == ["bar", ["a"]]
 
     def test_lindex(self, r):
         r.rpush("a", "1", "2", "3")
@@ -2148,23 +2148,23 @@ def test_bzpopmin(self, r):
     # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
     def test_zmpop(self, unstable_r):
         unstable_r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
-        res = [b"a", [[b"a1", b"1"], [b"a2", b"2"]]]
+        res = ["a", [["a1", "1"], ["a2", "2"]]]
         assert unstable_r.zmpop("2", ["b", "a"], min=True, count=2) == res
         with pytest.raises(redis.DataError):
             unstable_r.zmpop("2", ["b", "a"], count=2)
         unstable_r.zadd("b", {"b1": 10, "ab": 9, "b3": 8})
-        assert unstable_r.zmpop("2", ["b", "a"], max=True) == [b"b", [[b"b1", b"10"]]]
+        assert unstable_r.zmpop("2", ["b", "a"], max=True) == ["b", [["b1", "10"]]]
 
     @pytest.mark.onlynoncluster
     # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
     def test_bzmpop(self, unstable_r):
         unstable_r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
-        res = [b"a", [[b"a1", b"1"], [b"a2", b"2"]]]
+        res = ["a", [["a1", "1"], ["a2", "2"]]]
         assert unstable_r.bzmpop(1, "2", ["b", "a"], min=True, count=2) == res
         with pytest.raises(redis.DataError):
             unstable_r.bzmpop(1, "2", ["b", "a"], count=2)
         unstable_r.zadd("b", {"b1": 10, "ab": 9, "b3": 8})
-        res = [b"b", [[b"b1", b"10"]]]
+        res = ["b", [["b1", "10"]]]
         assert unstable_r.bzmpop(0, "2", ["b", "a"], max=True) == res
         assert unstable_r.bzmpop(1, "2", ["foo", "bar"], max=True) is None
 
diff --git a/tests/test_function.py b/tests/test_function.py
new file mode 100644
index 0000000000..921ba30444
--- /dev/null
+++ b/tests/test_function.py
@@ -0,0 +1,94 @@
+import pytest
+
+from redis.exceptions import ResponseError
+
+function = "redis.register_function('myfunc', function(keys, args) return args[1] end)"
+function2 = "redis.register_function('hello', function() return 'Hello World' end)"
+set_function = "redis.register_function('set', function(keys, args) \
+                return redis.call('SET', keys[1], args[1]) end)"
+get_function = "redis.register_function('get', function(keys, args) \
+                return redis.call('GET', keys[1]) end)"
+
+
+@pytest.mark.onlynoncluster
+# @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
+class TestFunction:
+    @pytest.fixture(autouse=True)
+    def reset_functions(self, unstable_r):
+        unstable_r.function_flush()
+
+    def test_function_load(self, unstable_r):
+        assert unstable_r.function_load("Lua", "mylib", function)
+        assert unstable_r.function_load("Lua", "mylib", function, replace=True)
+        with pytest.raises(ResponseError):
+            unstable_r.function_load("Lua", "mylib", function)
+        with pytest.raises(ResponseError):
+            unstable_r.function_load("Lua", "mylib2", function)
+
+    def test_function_delete(self, unstable_r):
+        unstable_r.function_load("Lua", "mylib", set_function)
+        with pytest.raises(ResponseError):
+            unstable_r.function_load("Lua", "mylib", set_function)
+        assert unstable_r.fcall("set", 1, "foo", "bar") == "OK"
+        assert unstable_r.function_delete("mylib")
+        with pytest.raises(ResponseError):
+            unstable_r.fcall("set", 1, "foo", "bar")
+        assert unstable_r.function_load("Lua", "mylib", set_function)
+
+    def test_function_flush(self, unstable_r):
+        unstable_r.function_load("Lua", "mylib", function)
+        assert unstable_r.fcall("myfunc", 0, "hello") == "hello"
+        assert unstable_r.function_flush()
+        with pytest.raises(ResponseError):
+            unstable_r.fcall("myfunc", 0, "hello")
+        with pytest.raises(ResponseError):
+            unstable_r.function_flush("ABC")
+
+    def test_function_list(self, unstable_r):
+        unstable_r.function_load("Lua", "mylib", function)
+        res = [
+            [
+                "library_name",
+                "mylib",
+                "engine",
+                "LUA",
+                "description",
+                None,
+                "functions",
+                [["name", "myfunc", "description", None]],
+            ],
+        ]
+        assert unstable_r.function_list() == res
+        assert unstable_r.function_list(library="*lib") == res
+        assert unstable_r.function_list(withcode=True)[0][9] == function
+
+    def test_fcall(self, unstable_r):
+        unstable_r.function_load("Lua", "mylib", set_function)
+        unstable_r.function_load("Lua", "mylib2", get_function)
+        assert unstable_r.fcall("set", 1, "foo", "bar") == "OK"
+        assert unstable_r.fcall("get", 1, "foo") == "bar"
+        with pytest.raises(ResponseError):
+            unstable_r.fcall("myfunc", 0, "hello")
+
+    def test_fcall_ro(self, unstable_r):
+        unstable_r.function_load("Lua", "mylib", function)
+        assert unstable_r.fcall_ro("myfunc", 0, "hello") == "hello"
+        unstable_r.function_load("Lua", "mylib2", set_function)
+        with pytest.raises(ResponseError):
+            unstable_r.fcall_ro("set", 1, "foo", "bar")
+
+    def test_function_dump_restore(self, unstable_r):
+        unstable_r.function_load("Lua", "mylib", set_function)
+        payload = unstable_r.function_dump()
+        assert unstable_r.fcall("set", 1, "foo", "bar") == "OK"
+        unstable_r.function_delete("mylib")
+        with pytest.raises(ResponseError):
+            unstable_r.fcall("set", 1, "foo", "bar")
+        assert unstable_r.function_restore(payload)
+        assert unstable_r.fcall("set", 1, "foo", "bar") == "OK"
+        unstable_r.function_load("Lua", "mylib2", get_function)
+        assert unstable_r.fcall("get", 1, "foo") == "bar"
+        unstable_r.function_delete("mylib")
+        assert unstable_r.function_restore(payload, "FLUSH")
+        with pytest.raises(ResponseError):
+            unstable_r.fcall("get", 1, "foo")
diff --git a/tests/test_scripting.py b/tests/test_scripting.py
index f4671a5f9a..dcf8a78de5 100644
--- a/tests/test_scripting.py
+++ b/tests/test_scripting.py
@@ -35,7 +35,7 @@ def test_eval(self, r):
     # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
     def test_eval_ro(self, unstable_r):
         unstable_r.set("a", "b")
-        assert unstable_r.eval_ro("return redis.call('GET', KEYS[1])", 1, "a") == b"b"
+        assert unstable_r.eval_ro("return redis.call('GET', KEYS[1])", 1, "a") == "b"
         with pytest.raises(redis.ResponseError):
             unstable_r.eval_ro("return redis.call('DEL', KEYS[1])", 1, "a")
 
@@ -79,7 +79,7 @@ def test_evalsha_ro(self, unstable_r):
         unstable_r.set("a", "b")
         get_sha = unstable_r.script_load("return redis.call('GET', KEYS[1])")
         del_sha = unstable_r.script_load("return redis.call('DEL', KEYS[1])")
-        assert unstable_r.evalsha_ro(get_sha, 1, "a") == b"b"
+        assert unstable_r.evalsha_ro(get_sha, 1, "a") == "b"
         with pytest.raises(redis.ResponseError):
             unstable_r.evalsha_ro(del_sha, 1, "a")
 

From 1983905d5adceaba2c3b27ba8f569dcb5387cc35 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C3=89ric=20Lemoine?= <eric.lemoine@gmail.com>
Date: Tue, 22 Feb 2022 12:32:14 +0100
Subject: [PATCH 0402/1164] Catch OSError in
 BlockingConnectionPool.get_connection (#2001)

Co-authored-by: Chayim I. Kirshen <c@kirshen.com>
---
 redis/connection.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/connection.py b/redis/connection.py
index 189cecb72f..8a77e4bdee 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1577,7 +1577,7 @@ def get_connection(self, command_name, *keys, **options):
             try:
                 if connection.can_read():
                     raise ConnectionError("Connection has data")
-            except ConnectionError:
+            except (ConnectionError, OSError):
                 connection.disconnect()
                 connection.connect()
                 if connection.can_read():

From e5ac39ac7b2728d14bfc27aac989b1085b7f6199 Mon Sep 17 00:00:00 2001
From: Jake Barnwell <2320567+jakebarnwell@users.noreply.github.com>
Date: Tue, 22 Feb 2022 07:07:22 -0500
Subject: [PATCH 0403/1164] Add cluster support for scripting (#1937)

* Add cluster support for scripting

* Fall back to connection_pool.get_encoder if necessary

* Add documentation for cluster-based scripting

* Add test for flush response

Co-authored-by: dvora-h <dvora.heller@redis.com>
---
 README.md                    | 34 ++++++++++---
 redis/cluster.py             | 87 ++++++++++++++++++++++++++-------
 redis/commands/cluster.py    |  9 +++-
 redis/commands/core.py       | 56 +++++++++++++++++++++
 redis/commands/parser.py     | 17 ++++++-
 redis/utils.py               |  2 +-
 tests/test_command_parser.py | 15 ++++++
 tests/test_scripting.py      | 94 +++++++++++++++++++++++++++++++++++-
 8 files changed, 285 insertions(+), 29 deletions(-)

diff --git a/README.md b/README.md
index c6ee3c10eb..0735055820 100644
--- a/README.md
+++ b/README.md
@@ -862,7 +862,8 @@ Monitor object to block until a command is received.
 redis-py supports the EVAL, EVALSHA, and SCRIPT commands. However, there
 are a number of edge cases that make these commands tedious to use in
 real world scenarios. Therefore, redis-py exposes a Script object that
-makes scripting much easier to use.
+makes scripting much easier to use. (RedisClusters have limited support for
+scripting.)
 
 To create a Script instance, use the register_script
 function on a client instance passing the Lua code as the first
@@ -955,7 +956,7 @@ C 3
 
 ### Cluster Mode
 
-redis-py is now supports cluster mode and provides a client for
+redis-py now supports cluster mode and provides a client for
 [Redis Cluster](<https://redis.io/topics/cluster-tutorial>).
 
 The cluster client is based on Grokzen's
@@ -963,6 +964,8 @@ The cluster client is based on Grokzen's
 fixes, and now supersedes that library. Support for these changes is thanks to
 his contributions.
 
+To learn more about Redis Cluster, see
+[Redis Cluster specifications](https://redis.io/topics/cluster-spec).
 
 **Create RedisCluster:**
 
@@ -1218,10 +1221,29 @@ according to their respective destination nodes. This means that we can not
 turn the pipeline commands into one transaction block, because in most cases
 they are split up into several smaller pipelines.
 
-
-See [Redis Cluster tutorial](https://redis.io/topics/cluster-tutorial) and
-[Redis Cluster specifications](https://redis.io/topics/cluster-spec)
-to learn more about Redis Cluster.
+**Lua Scripting in Cluster Mode**
+
+Cluster mode has limited support for lua scripting.
+
+The following commands are supported, with caveats:
+- `EVAL` and `EVALSHA`: The command is sent to the relevant node, depending on
+the keys (i.e., in `EVAL "<script>" num_keys key_1 ... key_n ...`). The keys
+_must_ all be on the same node. If the script requires 0 keys, _the command is
+sent to a random (primary) node_.
+- `SCRIPT EXISTS`: The command is sent to all primaries. The result is a list
+of booleans corresponding to the input SHA hashes. Each boolean is an AND of
+"does the script exist on each node?". In other words, each boolean is True iff
+the script exists on all nodes.
+- `SCRIPT FLUSH`: The command is sent to all primaries. The result is a bool
+AND over all nodes' responses.
+- `SCRIPT LOAD`: The command is sent to all primaries. The result is the SHA1
+digest.
+
+The following commands are not supported:
+- `EVAL_RO`
+- `EVALSHA_RO`
+
+Using scripting within pipelines in cluster mode is **not supported**.
 
 ### Author
 
diff --git a/redis/cluster.py b/redis/cluster.py
index 7151cfebce..b8d6b1997f 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -289,6 +289,9 @@ class RedisCluster(RedisClusterCommands):
             [
                 "FLUSHALL",
                 "FLUSHDB",
+                "SCRIPT EXISTS",
+                "SCRIPT FLUSH",
+                "SCRIPT LOAD",
             ],
             PRIMARIES,
         ),
@@ -379,6 +382,24 @@ class RedisCluster(RedisClusterCommands):
             ],
             parse_scan_result,
         ),
+        list_keys_to_dict(
+            [
+                "SCRIPT LOAD",
+            ],
+            lambda command, res: list(res.values()).pop(),
+        ),
+        list_keys_to_dict(
+            [
+                "SCRIPT EXISTS",
+            ],
+            lambda command, res: [all(k) for k in zip(*res.values())],
+        ),
+        list_keys_to_dict(
+            [
+                "SCRIPT FLUSH",
+            ],
+            lambda command, res: all(res.values()),
+        ),
     )
 
     ERRORS_ALLOW_RETRY = (
@@ -778,40 +799,70 @@ def _get_command_keys(self, *args):
         """
         Get the keys in the command. If the command has no keys in in, None is
         returned.
+
+        NOTE: Due to a bug in redis<7.0, this function does not work properly
+        for EVAL or EVALSHA when the `numkeys` arg is 0.
+         - issue: https://github.com/redis/redis/issues/9493
+         - fix: https://github.com/redis/redis/pull/9733
+
+        So, don't use this function with EVAL or EVALSHA.
         """
         redis_conn = self.get_default_node().redis_connection
         return self.commands_parser.get_keys(redis_conn, *args)
 
     def determine_slot(self, *args):
         """
-        Figure out what slot based on command and args
+        Figure out what slot to use based on args.
+
+        Raises a RedisClusterException if there's a missing key and we can't
+            determine what slots to map the command to; or, if the keys don't
+            all map to the same key slot.
         """
-        if self.command_flags.get(args[0]) == SLOT_ID:
+        command = args[0]
+        if self.command_flags.get(command) == SLOT_ID:
             # The command contains the slot ID
             return args[1]
 
         # Get the keys in the command
-        keys = self._get_command_keys(*args)
-        if keys is None or len(keys) == 0:
-            raise RedisClusterException(
-                "No way to dispatch this command to Redis Cluster. "
-                "Missing key.\nYou can execute the command by specifying "
-                f"target nodes.\nCommand: {args}"
-            )
 
-        if len(keys) > 1:
-            # multi-key command, we need to make sure all keys are mapped to
-            # the same slot
-            slots = {self.keyslot(key) for key in keys}
-            if len(slots) != 1:
+        # EVAL and EVALSHA are common enough that it's wasteful to go to the
+        # redis server to parse the keys. Besides, there is a bug in redis<7.0
+        # where `self._get_command_keys()` fails anyway. So, we special case
+        # EVAL/EVALSHA.
+        if command in ("EVAL", "EVALSHA"):
+            # command syntax: EVAL "script body" num_keys ...
+            if len(args) <= 2:
+                raise RedisClusterException(f"Invalid args in command: {args}")
+            num_actual_keys = args[2]
+            eval_keys = args[3 : 3 + num_actual_keys]
+            # if there are 0 keys, that means the script can be run on any node
+            # so we can just return a random slot
+            if len(eval_keys) == 0:
+                return random.randrange(0, REDIS_CLUSTER_HASH_SLOTS)
+            keys = eval_keys
+        else:
+            keys = self._get_command_keys(*args)
+            if keys is None or len(keys) == 0:
                 raise RedisClusterException(
-                    f"{args[0]} - all keys must map to the same key slot"
+                    "No way to dispatch this command to Redis Cluster. "
+                    "Missing key.\nYou can execute the command by specifying "
+                    f"target nodes.\nCommand: {args}"
                 )
-            return slots.pop()
-        else:
-            # single key command
+
+        # single key command
+        if len(keys) == 1:
             return self.keyslot(keys[0])
 
+        # multi-key command; we need to make sure all keys are mapped to
+        # the same slot
+        slots = {self.keyslot(key) for key in keys}
+        if len(slots) != 1:
+            raise RedisClusterException(
+                f"{command} - all keys must map to the same key slot"
+            )
+
+        return slots.pop()
+
     def reinitialize_caches(self):
         self.nodes_manager.initialize()
 
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index 5d0e804628..8bdcbbadf6 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -1,7 +1,13 @@
 from redis.crc import key_slot
 from redis.exceptions import RedisClusterException, RedisError
 
-from .core import ACLCommands, DataAccessCommands, ManagementCommands, PubSubCommands
+from .core import (
+    ACLCommands,
+    DataAccessCommands,
+    ManagementCommands,
+    PubSubCommands,
+    ScriptCommands,
+)
 from .helpers import list_or_args
 
 
@@ -205,6 +211,7 @@ class RedisClusterCommands(
     ACLCommands,
     PubSubCommands,
     ClusterDataAccessCommands,
+    ScriptCommands,
 ):
     """
     A class for all Redis Cluster commands
diff --git a/redis/commands/core.py b/redis/commands/core.py
index e74550f335..7fd668e6ae 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -5399,6 +5399,62 @@ def command(self) -> ResponseT:
         return self.execute_command("COMMAND")
 
 
+class Script:
+    """
+    An executable Lua script object returned by ``register_script``
+    """
+
+    def __init__(self, registered_client, script):
+        self.registered_client = registered_client
+        self.script = script
+        # Precalculate and store the SHA1 hex digest of the script.
+
+        if isinstance(script, str):
+            # We need the encoding from the client in order to generate an
+            # accurate byte representation of the script
+            encoder = self.get_encoder()
+            script = encoder.encode(script)
+        self.sha = hashlib.sha1(script).hexdigest()
+
+    def __call__(self, keys=[], args=[], client=None):
+        "Execute the script, passing any required ``args``"
+        if client is None:
+            client = self.registered_client
+        args = tuple(keys) + tuple(args)
+        # make sure the Redis server knows about the script
+        from redis.client import Pipeline
+
+        if isinstance(client, Pipeline):
+            # Make sure the pipeline can register the script before executing.
+            client.scripts.add(self)
+        try:
+            return client.evalsha(self.sha, len(keys), *args)
+        except NoScriptError:
+            # Maybe the client is pointed to a different server than the client
+            # that created this instance?
+            # Overwrite the sha just in case there was a discrepancy.
+            self.sha = client.script_load(self.script)
+            return client.evalsha(self.sha, len(keys), *args)
+
+    def get_encoder(self):
+        """Get the encoder to encode string scripts into bytes."""
+        try:
+            return self.registered_client.get_encoder()
+        except AttributeError:
+            # DEPRECATED
+            # In version <=4.1.2, this was the code we used to get the encoder.
+            # However, after 4.1.2 we added support for scripting in clustered
+            # redis. ClusteredRedis doesn't have a `.connection_pool` attribute
+            # so we changed the Script class to use
+            # `self.registered_client.get_encoder` (see above).
+            # However, that is technically a breaking change, as consumers who
+            # use Scripts directly might inject a `registered_client` that
+            # doesn't have a `.get_encoder` field. This try/except prevents us
+            # from breaking backward-compatibility. Ideally, it would be
+            # removed in the next major release.
+            return self.registered_client.connection_pool.get_encoder()
+
+
 class AsyncModuleCommands(ModuleCommands):
     async def command_info(self) -> None:
         return super().command_info()
diff --git a/redis/commands/parser.py b/redis/commands/parser.py
index 4cce800ec3..2bb0576910 100644
--- a/redis/commands/parser.py
+++ b/redis/commands/parser.py
@@ -24,7 +24,14 @@ def initialize(self, r):
     # https://github.com/redis/redis/pull/8324
     def get_keys(self, redis_conn, *args):
         """
-        Get the keys from the passed command
+        Get the keys from the passed command.
+
+        NOTE: Due to a bug in redis<7.0, this function does not work properly
+        for EVAL or EVALSHA when the `numkeys` arg is 0.
+         - issue: https://github.com/redis/redis/issues/9493
+         - fix: https://github.com/redis/redis/pull/9733
+
+        So, don't use this function with EVAL or EVALSHA.
         """
         if len(args) < 2:
             # The command has no keys in it
@@ -72,6 +79,14 @@ def get_keys(self, redis_conn, *args):
         return keys
 
     def _get_moveable_keys(self, redis_conn, *args):
+        """
+        NOTE: Due to a bug in redis<7.0, this function does not work properly
+        for EVAL or EVALSHA when the `numkeys` arg is 0.
+         - issue: https://github.com/redis/redis/issues/9493
+         - fix: https://github.com/redis/redis/pull/9733
+
+        So, don't use this function with EVAL or EVALSHA.
+        """
         pieces = []
         cmd_name = args[0]
         # The command name should be splitted into separate arguments,
diff --git a/redis/utils.py b/redis/utils.py
index 56fec49b70..9ab75f2a97 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -67,7 +67,7 @@ def merge_result(command, res):
     Merge all items in `res` into a list.
 
     This command is used when sending a command to multiple nodes
-    and they result from each node should be merged into a single list.
+    and the result from each node should be merged into a single list.
 
     res : 'dict'
     """
diff --git a/tests/test_command_parser.py b/tests/test_command_parser.py
index ad29e69f37..ab050a74e7 100644
--- a/tests/test_command_parser.py
+++ b/tests/test_command_parser.py
@@ -2,6 +2,8 @@
 
 from redis.commands import CommandsParser
 
+from .conftest import skip_if_server_version_lt
+
 
 class TestCommandsParser:
     def test_init_commands(self, r):
@@ -68,6 +70,19 @@ def test_get_moveable_keys(self, r):
         assert commands_parser.get_keys(r, *args8) is None
         assert commands_parser.get_keys(r, *args9).sort() == ["key1", "key2"].sort()
 
+    # A bug in redis<7.0 causes this to fail: https://github.com/redis/redis/issues/9493
+    @skip_if_server_version_lt("7.0.0")
+    def test_get_eval_keys_with_0_keys(self, r):
+        commands_parser = CommandsParser(r)
+        args = [
+            "EVAL",
+            "return {ARGV[1],ARGV[2]}",
+            0,
+            "key1",
+            "key2",
+        ]
+        assert commands_parser.get_keys(r, *args) == []
+
     def test_get_pubsub_keys(self, r):
         commands_parser = CommandsParser(r)
         args1 = ["PUBLISH", "foo", "bar"]
diff --git a/tests/test_scripting.py b/tests/test_scripting.py
index dcf8a78de5..4635f9572d 100644
--- a/tests/test_scripting.py
+++ b/tests/test_scripting.py
@@ -2,6 +2,7 @@
 
 import redis
 from redis import exceptions
+from redis.commands.core import Script
 from tests.conftest import skip_if_server_version_lt
 
 multiply_script = """
@@ -21,24 +22,103 @@
 """
 
 
-@pytest.mark.onlynoncluster
+class TestScript:
+    """
+    We have a few tests to directly test the Script class.
+
+    However, most of the behavioral tests are covered by `TestScripting`.
+    """
+
+    @pytest.fixture()
+    def script_str(self):
+        return "fake-script"
+
+    @pytest.fixture()
+    def script_bytes(self):
+        return b"\xcf\x84o\xcf\x81\xce\xbdo\xcf\x82"
+
+    def test_script_text(self, r, script_str, script_bytes):
+        assert Script(r, script_str).script == "fake-script"
+        assert Script(r, script_bytes).script == b"\xcf\x84o\xcf\x81\xce\xbdo\xcf\x82"
+
+    def test_string_script_sha(self, r, script_str):
+        script = Script(r, script_str)
+        assert script.sha == "505e4245f0866b60552741b3cce9a0c3d3b66a87"
+
+    def test_bytes_script_sha(self, r, script_bytes):
+        script = Script(r, script_bytes)
+        assert script.sha == "1329344e6bf995a35a8dc57ab1a6af8b2d54a763"
+
+    def test_encoder(self, r, script_bytes):
+        encoder = Script(r, script_bytes).get_encoder()
+        assert encoder is not None
+        assert encoder.encode("fake-script") == b"fake-script"
+
+
 class TestScripting:
     @pytest.fixture(autouse=True)
     def reset_scripts(self, r):
         r.script_flush()
 
-    def test_eval(self, r):
+    def test_eval_multiply(self, r):
         r.set("a", 2)
         # 2 * 3 == 6
         assert r.eval(multiply_script, 1, "a", 3) == 6
 
     # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
+    @pytest.mark.onlynoncluster
     def test_eval_ro(self, unstable_r):
         unstable_r.set("a", "b")
         assert unstable_r.eval_ro("return redis.call('GET', KEYS[1])", 1, "a") == "b"
         with pytest.raises(redis.ResponseError):
             unstable_r.eval_ro("return redis.call('DEL', KEYS[1])", 1, "a")
 
+    def test_eval_msgpack(self, r):
+        msgpack_message_dumped = b"\x81\xa4name\xa3Joe"
+        # this is msgpack.dumps({"name": "joe"})
+        assert r.eval(msgpack_hello_script, 0, msgpack_message_dumped) == b"hello Joe"
+
+    def test_eval_same_slot(self, r):
+        """
+        In a clustered redis, the script keys must be in the same slot.
+
+        This test isn't very interesting for standalone redis, but it doesn't
+        hurt anything.
+        """
+        r.set("A{foo}", 2)
+        r.set("B{foo}", 4)
+        # 2 * 4 == 8
+
+        script = """
+        local value = redis.call('GET', KEYS[1])
+        local value2 = redis.call('GET', KEYS[2])
+        return value * value2
+        """
+        result = r.eval(script, 2, "A{foo}", "B{foo}")
+        assert result == 8
+
+    @pytest.mark.onlycluster
+    def test_eval_crossslot(self, r):
+        """
+        In a clustered redis, the script keys must be in the same slot.
+
+        This test should fail, because the two keys we send are in different
+        slots. This test assumes that {foo} and {bar} will not go to the same
+        server when used. In a setup with 3 primaries and 3 secondaries, this
+        assumption holds.
+        """
+        r.set("A{foo}", 2)
+        r.set("B{bar}", 4)
+        # 2 * 4 == 8
+
+        script = """
+        local value = redis.call('GET', KEYS[1])
+        local value2 = redis.call('GET', KEYS[2])
+        return value * value2
+        """
+        with pytest.raises(exceptions.RedisClusterException):
+            r.eval(script, 2, "A{foo}", "B{bar}")
+
     @skip_if_server_version_lt("6.2.0")
     def test_script_flush_620(self, r):
         r.set("a", 2)
@@ -75,6 +155,7 @@ def test_evalsha(self, r):
         assert r.evalsha(sha, 1, "a", 3) == 6
 
     # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
+    @pytest.mark.onlynoncluster
     def test_evalsha_ro(self, unstable_r):
         unstable_r.set("a", "b")
         get_sha = unstable_r.script_load("return redis.call('GET', KEYS[1])")
@@ -99,6 +180,11 @@ def test_script_loading(self, r):
         r.script_load(multiply_script)
         assert r.script_exists(sha) == [True]
 
+    def test_flush_response(self, r):
+        r.script_load(multiply_script)
+        flush_response = r.script_flush()
+        assert flush_response is True
+
     def test_script_object(self, r):
         r.set("a", 2)
         multiply = r.register_script(multiply_script)
@@ -114,6 +200,8 @@ def test_script_object(self, r):
         # Test first evalsha block
         assert multiply(keys=["a"], args=[3]) == 6
 
+    # Scripting is not supported in cluster pipelines
+    @pytest.mark.onlynoncluster
     def test_script_object_in_pipeline(self, r):
         multiply = r.register_script(multiply_script)
         precalculated_sha = multiply.sha
@@ -142,6 +230,8 @@ def test_script_object_in_pipeline(self, r):
         assert pipe.execute() == [True, b"2", 6]
         assert r.script_exists(multiply.sha) == [True]
 
+    # Scripting is not supported in cluster pipelines
+    @pytest.mark.onlynoncluster
     def test_eval_msgpack_pipeline_error_in_lua(self, r):
         msgpack_hello = r.register_script(msgpack_hello_script)
         assert msgpack_hello.sha

From 4a714aa64036b2a86a3da589b5d7a92a05726477 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 22 Feb 2022 15:57:55 +0200
Subject: [PATCH 0404/1164] v4.2.0-rc1 (#2005)

* v4.2.0-rc1

* 4.2.0rc1
---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index a6d5cf0679..7109ed45c7 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.1.2",
+    version="4.2.0rc1",
     packages=find_packages(
         include=[
             "redis",

From 6df1ba3b16aa8f1f930a5224cf911c334d1ba19b Mon Sep 17 00:00:00 2001
From: Andrew Chen Wang <60190294+Andrew-Chen-Wang@users.noreply.github.com>
Date: Wed, 23 Feb 2022 02:25:54 -0500
Subject: [PATCH 0405/1164] Add Python 3.6 back to hash verify CI (#2008)

---
 .github/workflows/integration.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index bfd1841669..74b25d6b27 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -36,7 +36,7 @@ jobs:
      strategy:
        max-parallel: 15
        matrix:
-         python-version: ['3.6','3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
+         python-version: ['3.6', '3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
          test-type: ['standalone', 'cluster']
          connection-type: ['hiredis', 'plain']
      env:
@@ -80,7 +80,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
+        python-version: ['3.6', '3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
     steps:
       - uses: actions/checkout@v2
       - name: install python ${{ matrix.python-version }}

From 1256fddae761f4b81783d684ff7cb803ca835931 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 23 Feb 2022 09:31:59 +0200
Subject: [PATCH 0406/1164] Renaming chore as maintenance (#2015)

---
 .github/PULL_REQUEST_TEMPLATE.md   | 2 +-
 .github/release-drafter-config.yml | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index a46d8c9bbc..a3b0b0e4e7 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -7,7 +7,7 @@ _Please make sure to review and check all of these items:_
 - [ ] Is the new or changed code fully tested?
 - [ ] Is a documentation update included (if this change modifies existing APIs, or introduces new ones)?
 - [ ] Is there an example added to the examples folder (if applicable)?
-- [ ] Is the changes added to CHANGES file?
+- [ ] Was the change added to CHANGES file?
 
 _NOTE: these things are not required to open a PR and can be done
 afterwards / while the PR is open._
diff --git a/.github/release-drafter-config.yml b/.github/release-drafter-config.yml
index a3a5d8392a..aab645f9e4 100644
--- a/.github/release-drafter-config.yml
+++ b/.github/release-drafter-config.yml
@@ -1,16 +1,16 @@
 name-template: 'Version $NEXT_PATCH_VERSION'
 tag-template: 'v$NEXT_PATCH_VERSION'
 autolabeler:
-  - label: 'chore'
+  - label: 'maintenance'
     files:
       - '*.md'
       - '.github/*'
   - label: 'bug'
     branch:
       - '/bug-.+'
-  - label: 'chore'
+  - label: 'maintenance'
     branch:
-      - '/chore-.+'
+      - '/maintenance-.+'
   - label: 'feature'
     branch:
       - '/feature-.+'
@@ -28,7 +28,7 @@ categories:
       - 'bugfix'
       - 'bug'
   - title: '🧰 Maintenance'
-    label: 'chore'
+    label: 'maintenance'
 change-template: '- $TITLE (#$NUMBER)'
 exclude-labels:
   - 'skip-changelog'

From afc83e11146a9cb4f7fdeedc3b7fec7e1fe2953c Mon Sep 17 00:00:00 2001
From: Andrew Chen Wang <60190294+Andrew-Chen-Wang@users.noreply.github.com>
Date: Thu, 24 Feb 2022 09:12:27 -0500
Subject: [PATCH 0407/1164] Add AsyncFunctionCommands (#2009)

---
 redis/commands/core.py | 34 ++++++++++++++++++++++------------
 1 file changed, 22 insertions(+), 12 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 7fd668e6ae..968b7cc412 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -5485,6 +5485,9 @@ def readonly(self, **kwargs) -> ResponseT:
         return self.execute_command("READONLY", **kwargs)
 
 
+AsyncClusterCommands = ClusterCommands
+
+
 class FunctionCommands:
     """
     Redis Function commands
@@ -5497,7 +5500,7 @@ def function_load(
         code: str,
         replace: Optional[bool] = False,
         description: Optional[str] = None,
-    ) -> str:
+    ) -> Union[Awaitable[str], str]:
         """
         Load a library to Redis.
         :param engine: the name of the execution engine for the library
@@ -5517,7 +5520,7 @@ def function_load(
         pieces.append(code)
         return self.execute_command("FUNCTION LOAD", *pieces)
 
-    def function_delete(self, library: str) -> str:
+    def function_delete(self, library: str) -> Union[Awaitable[str], str]:
         """
         Delete the library called ``library`` and all its functions.
 
@@ -5525,7 +5528,7 @@ def function_delete(self, library: str) -> str:
         """
         return self.execute_command("FUNCTION DELETE", library)
 
-    def function_flush(self, mode: str = "SYNC") -> str:
+    def function_flush(self, mode: str = "SYNC") -> Union[Awaitable[str], str]:
         """
         Deletes all the libraries.
 
@@ -5535,7 +5538,7 @@ def function_flush(self, mode: str = "SYNC") -> str:
 
     def function_list(
         self, library: Optional[str] = "*", withcode: Optional[bool] = False
-    ) -> List:
+    ) -> Union[Awaitable[list], list]:
         """
         Return information about the functions and libraries.
         :param library: pecify a pattern for matching library names
@@ -5549,10 +5552,12 @@ def function_list(
 
     def _fcall(
         self, command: str, function, numkeys: int, *keys_and_args: Optional[List]
-    ) -> str:
+    ) -> Union[Awaitable[str], str]:
         return self.execute_command(command, function, numkeys, *keys_and_args)
 
-    def fcall(self, function, numkeys: int, *keys_and_args: Optional[List]) -> str:
+    def fcall(
+        self, function, numkeys: int, *keys_and_args: Optional[List]
+    ) -> Union[Awaitable[str], str]:
         """
         Invoke a function.
 
@@ -5560,7 +5565,9 @@ def fcall(self, function, numkeys: int, *keys_and_args: Optional[List]) -> str:
         """
         return self._fcall("FCALL", function, numkeys, *keys_and_args)
 
-    def fcall_ro(self, function, numkeys: int, *keys_and_args: Optional[List]) -> str:
+    def fcall_ro(
+        self, function, numkeys: int, *keys_and_args: Optional[List]
+    ) -> Union[Awaitable[str], str]:
         """
         This is a read-only variant of the FCALL command that cannot
         execute commands that modify data.
@@ -5569,7 +5576,7 @@ def fcall_ro(self, function, numkeys: int, *keys_and_args: Optional[List]) -> st
         """
         return self._fcall("FCALL_RO", function, numkeys, *keys_and_args)
 
-    def function_dump(self) -> str:
+    def function_dump(self) -> Union[Awaitable[str], str]:
         """
         Return the serialized payload of loaded libraries.
 
@@ -5582,7 +5589,9 @@ def function_dump(self) -> str:
 
         return self.execute_command("FUNCTION DUMP", **options)
 
-    def function_restore(self, payload: str, policy: Optional[str] = "APPEND") -> str:
+    def function_restore(
+        self, payload: str, policy: Optional[str] = "APPEND"
+    ) -> Union[Awaitable[str], str]:
         """
         Restore libraries from the serialized ``payload``.
         You can use the optional policy argument to provide a policy
@@ -5592,7 +5601,7 @@ def function_restore(self, payload: str, policy: Optional[str] = "APPEND") -> st
         """
         return self.execute_command("FUNCTION RESTORE", payload, policy)
 
-    def function_kill(self) -> str:
+    def function_kill(self) -> Union[Awaitable[str], str]:
         """
         Kill a function that is currently executing.
 
@@ -5600,7 +5609,7 @@ def function_kill(self) -> str:
         """
         return self.execute_command("FUNCTION KILL")
 
-    def function_stats(self) -> list:
+    def function_stats(self) -> Union[Awaitable[list], list]:
         """
         Return information about the function that's currently running
         and information about the available execution engines.
@@ -5610,7 +5619,7 @@ def function_stats(self) -> list:
         return self.execute_command("FUNCTION STATS")
 
 
-AsyncClusterCommands = ClusterCommands
+AsyncFunctionCommands = FunctionCommands
 
 
 class DataAccessCommands(
@@ -5671,6 +5680,7 @@ class AsyncCoreCommands(
     AsyncModuleCommands,
     AsyncPubSubCommands,
     AsyncScriptCommands,
+    AsyncFunctionCommands,
 ):
     """
     A class containing all of the implemented redis commands. This class is

From d33ff442a0bf7e9a6f20874e20f09f20946917eb Mon Sep 17 00:00:00 2001
From: OfirMos <82366525+OfirMos@users.noreply.github.com>
Date: Tue, 1 Mar 2022 09:53:17 +0200
Subject: [PATCH 0408/1164] Fixing TimesSeries tests (#2029)

---
 tests/test_timeseries.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/tests/test_timeseries.py b/tests/test_timeseries.py
index 8c97ab804d..aee37aaa43 100644
--- a/tests/test_timeseries.py
+++ b/tests/test_timeseries.py
@@ -226,7 +226,7 @@ def test_range_advanced(client):
     assert [(0, 10.0), (10, 1.0)] == client.ts().range(
         1, 0, 10, aggregation_type="count", bucket_size_msec=10, align="+"
     )
-    assert [(-5, 5.0), (5, 6.0)] == client.ts().range(
+    assert [(0, 5.0), (5, 6.0)] == client.ts().range(
         1, 0, 10, aggregation_type="count", bucket_size_msec=10, align=5
     )
 
@@ -258,7 +258,7 @@ def test_rev_range(client):
     assert [(10, 1.0), (0, 10.0)] == client.ts().revrange(
         1, 0, 10, aggregation_type="count", bucket_size_msec=10, align="+"
     )
-    assert [(1, 10.0), (-9, 1.0)] == client.ts().revrange(
+    assert [(1, 10.0), (0, 1.0)] == client.ts().revrange(
         1, 0, 10, aggregation_type="count", bucket_size_msec=10, align=1
     )
 
@@ -345,7 +345,7 @@ def test_multi_range_advanced(client):
         bucket_size_msec=10,
         align=5,
     )
-    assert [(-5, 5.0), (5, 6.0)] == res[0]["1"][1]
+    assert [(0, 5.0), (5, 6.0)] == res[0]["1"][1]
 
 
 @pytest.mark.redismod
@@ -427,7 +427,7 @@ def test_multi_reverse_range(client):
         bucket_size_msec=10,
         align=1,
     )
-    assert [(1, 10.0), (-9, 1.0)] == res[0]["1"][1]
+    assert [(1, 10.0), (0, 1.0)] == res[0]["1"][1]
 
 
 @pytest.mark.redismod

From 87764e7eed05d19519110d06c66a4c00ea59bcac Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 1 Mar 2022 11:51:11 +0200
Subject: [PATCH 0409/1164] redismod cluster docker (#2022)

* redismod cluster docker

* add to tox

* mod cluster

Co-authored-by: dvora-h <dvora.heller@redis.com>
---
 docker/base/Dockerfile.redismod_cluster | 12 +++++++
 docker/base/create_redismod_cluster.sh  | 46 +++++++++++++++++++++++++
 docker/redismod_cluster/redis.conf      |  8 +++++
 tox.ini                                 | 15 ++++++++
 4 files changed, 81 insertions(+)
 create mode 100644 docker/base/Dockerfile.redismod_cluster
 create mode 100755 docker/base/create_redismod_cluster.sh
 create mode 100644 docker/redismod_cluster/redis.conf

diff --git a/docker/base/Dockerfile.redismod_cluster b/docker/base/Dockerfile.redismod_cluster
new file mode 100644
index 0000000000..5b80e495fb
--- /dev/null
+++ b/docker/base/Dockerfile.redismod_cluster
@@ -0,0 +1,12 @@
+# produces redisfab/redis-py-modcluster:6.2.6
+FROM redislabs/redismod:edge
+
+COPY create_redismod_cluster.sh /create_redismod_cluster.sh
+RUN chmod +x /create_redismod_cluster.sh
+
+EXPOSE 46379 46380 46381 46382 46383 46384
+
+ENV START_PORT=46379
+ENV END_PORT=46384
+ENTRYPOINT []
+CMD /create_redismod_cluster.sh
diff --git a/docker/base/create_redismod_cluster.sh b/docker/base/create_redismod_cluster.sh
new file mode 100755
index 0000000000..20443a4c42
--- /dev/null
+++ b/docker/base/create_redismod_cluster.sh
@@ -0,0 +1,46 @@
+#! /bin/bash
+
+mkdir -p /nodes
+touch /nodes/nodemap
+if [ -z ${START_PORT} ]; then
+    START_PORT=46379
+fi
+if [ -z ${END_PORT} ]; then
+    END_PORT=46384
+fi
+if [ ! -z "$3" ]; then
+    START_PORT=$2
+    START_PORT=$3
+fi
+echo "STARTING: ${START_PORT}"
+echo "ENDING: ${END_PORT}"
+
+for PORT in `seq ${START_PORT} ${END_PORT}`; do
+  mkdir -p /nodes/$PORT
+  if [[ -e /redis.conf ]]; then
+    cp /redis.conf /nodes/$PORT/redis.conf
+  else
+    touch /nodes/$PORT/redis.conf
+  fi
+  cat << EOF >> /nodes/$PORT/redis.conf
+port ${PORT}
+cluster-enabled yes
+daemonize yes
+logfile /redis.log
+dir /nodes/$PORT
+EOF
+
+  set -x
+  redis-server /nodes/$PORT/redis.conf
+  if [ $? -ne 0 ]; then
+    echo "Redis failed to start, exiting."
+    continue
+  fi
+  echo 127.0.0.1:$PORT >> /nodes/nodemap
+done
+if [ -z "${REDIS_PASSWORD}" ]; then
+    echo yes | redis-cli --cluster create `seq -f 127.0.0.1:%g ${START_PORT} ${END_PORT}` --cluster-replicas 1
+else
+    echo yes | redis-cli -a ${REDIS_PASSWORD} --cluster create `seq -f 127.0.0.1:%g ${START_PORT} ${END_PORT}` --cluster-replicas 1
+fi
+tail -f /redis.log
diff --git a/docker/redismod_cluster/redis.conf b/docker/redismod_cluster/redis.conf
new file mode 100644
index 0000000000..48f06668a8
--- /dev/null
+++ b/docker/redismod_cluster/redis.conf
@@ -0,0 +1,8 @@
+loadmodule /usr/lib/redis/modules/redisai.so
+loadmodule /usr/lib/redis/modules/redisearch.so
+loadmodule /usr/lib/redis/modules/redisgraph.so
+loadmodule /usr/lib/redis/modules/redistimeseries.so
+loadmodule /usr/lib/redis/modules/rejson.so
+loadmodule /usr/lib/redis/modules/redisbloom.so
+loadmodule /var/opt/redislabs/lib/modules/redisgears.so Plugin /var/opt/redislabs/modules/rg/plugin/gears_python.so Plugin /var/opt/redislabs/modules/rg/plugin/gears_jvm.so JvmOptions -Djava.class.path=/var/opt/redislabs/modules/rg/gear_runtime-jar-with-dependencies.jar JvmPath /var/opt/redislabs/modules/rg/OpenJDK/jdk-11.0.9.1+1/
+
diff --git a/tox.ini b/tox.ini
index 3ef01ddead..82e79d7611 100644
--- a/tox.ini
+++ b/tox.ini
@@ -109,6 +109,20 @@ healtcheck_cmd = python -c "import socket;print(True) if all([0 == socket.socket
 volumes =
     bind:rw:{toxinidir}/docker/cluster/redis.conf:/redis.conf
 
+[docker:redismod_cluster]
+name = redismod_cluster
+image = redisfab/redis-py-modcluster:6.2.6
+ports = 
+    46379:46379/tcp
+    46380:46380/tcp
+    46381:46381/tcp
+    46382:46382/tcp
+    46383:46383/tcp
+    46384:46384/tcp
+healtcheck_cmd = python -c "import socket;print(True) if all([0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',port)) for port in range(46379,46384)]) else False"
+volumes =
+    bind:rw:{toxinidir}/docker/redismod_cluster/redis.conf:/redis.conf
+
 [docker:stunnel]
 name = stunnel
 image = redisfab/stunnel:latest
@@ -262,6 +276,7 @@ docker =
     sentinel_3
     redis_cluster
     redismod
+    redismod_cluster
     stunnel
 extras =
     hiredis: hiredis

From 61490045fc1a3d34260b293821a57424436af29e Mon Sep 17 00:00:00 2001
From: Jake Barnwell <2320567+jakebarnwell@users.noreply.github.com>
Date: Tue, 1 Mar 2022 05:22:49 -0500
Subject: [PATCH 0410/1164] Implement locks for RedisCluster (#2013)

* Add support for .lock() for RedisCluster

* Update changelog with lua scripting and lock() changes

* Also update asyncio client .lock() doc

* Add Python 3.6 back to hash verify CI (#2008)

* Renaming chore as maintenance (#2015)

* Add AsyncFunctionCommands (#2009)

* Also update asyncio client .lock() doc

Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: Andrew Chen Wang <60190294+Andrew-Chen-Wang@users.noreply.github.com>
Co-authored-by: dvora-h <dvora.heller@redis.com>
---
 CHANGES                 | 20 ++++++------
 redis/asyncio/client.py |  5 ++-
 redis/client.py         |  5 ++-
 redis/cluster.py        | 67 +++++++++++++++++++++++++++++++++++++++++
 redis/lock.py           |  4 +--
 tests/test_lock.py      |  2 --
 6 files changed, 88 insertions(+), 15 deletions(-)

diff --git a/CHANGES b/CHANGES
index 8da3a8b675..ddf7cfd4e3 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,10 +1,12 @@
-	* Create codeql-analysis.yml (#1988). Thanks @chayim
+  	* Create codeql-analysis.yml (#1988). Thanks @chayim
+    * Add limited support for Lua scripting with RedisCluster
+    * Implement `.lock()` method on RedisCluster
 * 4.1.3 (Feb 8, 2022)
-  * Fix flushdb and flushall (#1926)
-  * Add redis5 and redis4 dockers (#1871)
-  * Change json.clear test multi to be up to date with redisjson (#1922)
-  * Fixing volume for unstable_cluster docker (#1914)
-  * Update changes file with changes since 4.0.0-beta2 (#1915)
+    * Fix flushdb and flushall (#1926)
+    * Add redis5 and redis4 dockers (#1871)
+    * Change json.clear test multi to be up to date with redisjson (#1922)
+    * Fixing volume for unstable_cluster docker (#1914)
+    * Update changes file with changes since 4.0.0-beta2 (#1915)
 * 4.1.2 (Jan 27, 2022)
     * Invalid OCSP certificates should raise ConnectionError on failed validation (#1907)
     * Added retry mechanism on socket timeouts when connecting to the server (#1895)
@@ -94,10 +96,10 @@
     * Removing command on initial connections (#1722)
     * Removing hiredis warning when not installed (#1721)
 * 4.0.0 (Nov 15, 2021)
-    * FT.EXPLAINCLI intentionally raising NotImplementedError 
+    * FT.EXPLAINCLI intentionally raising NotImplementedError
     * Restoring ZRANGE desc for Redis < 6.2.0 (#1697)
     * Response parsing occasionally fails to parse floats (#1692)
-    * Re-enabling read-the-docs (#1707) 
+    * Re-enabling read-the-docs (#1707)
     * Call HSET after FT.CREATE to avoid keyspace scan (#1706)
     * Unit tests fixes for compatibility (#1703)
     * Improve documentation about Locks (#1701)
@@ -117,7 +119,7 @@
     * Sleep for flaky search test (#1680)
     * Test function renames, to match standards (#1679)
     * Docstring improvements for Redis class (#1675)
-    * Fix georadius tests (#1672) 
+    * Fix georadius tests (#1672)
     * Improvements to JSON coverage (#1666)
     * Add python_requires setuptools check for python > 3.6 (#1656)
     * SMISMEMBER support (#1667)
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 619592ef76..2afad0f4d1 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -348,7 +348,10 @@ def lock(
         continue trying forever. ``blocking_timeout`` can be specified as a
         float or integer, both representing the number of seconds to wait.
 
-        ``lock_class`` forces the specified lock implementation.
+        ``lock_class`` forces the specified lock implementation. Note that as
+        of redis-py 3.0, the only lock class we implement is ``Lock`` (which is
+        a Lua-based lock). So, it's unlikely you'll need this parameter, unless
+        you have created your own custom lock class.
 
         ``thread_local`` indicates whether the lock token is placed in
         thread-local storage. By default, the token is placed in thread local
diff --git a/redis/client.py b/redis/client.py
index 0eade79e90..b12ad578d6 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1082,7 +1082,10 @@ def lock(
         continue trying forever. ``blocking_timeout`` can be specified as a
         float or integer, both representing the number of seconds to wait.
 
-        ``lock_class`` forces the specified lock implementation.
+        ``lock_class`` forces the specified lock implementation. Note that as
+        of redis-py 3.0, the only lock class we implement is ``Lock`` (which is
+        a Lua-based lock). So, it's unlikely you'll need this parameter, unless
+        you have created your own custom lock class.
 
         ``thread_local`` indicates whether the lock token is placed in
         thread-local storage. By default, the token is placed in thread local
diff --git a/redis/cluster.py b/redis/cluster.py
index b8d6b1997f..3b30a6e0a8 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -28,6 +28,7 @@
     TimeoutError,
     TryAgainError,
 )
+from redis.lock import Lock
 from redis.utils import (
     dict_merge,
     list_keys_to_dict,
@@ -742,6 +743,72 @@ def pipeline(self, transaction=None, shard_hint=None):
             reinitialize_steps=self.reinitialize_steps,
         )
 
+    def lock(
+        self,
+        name,
+        timeout=None,
+        sleep=0.1,
+        blocking_timeout=None,
+        lock_class=None,
+        thread_local=True,
+    ):
+        """
+        Return a new Lock object using key ``name`` that mimics
+        the behavior of threading.Lock.
+
+        If specified, ``timeout`` indicates a maximum life for the lock.
+        By default, it will remain locked until release() is called.
+
+        ``sleep`` indicates the amount of time to sleep per loop iteration
+        when the lock is in blocking mode and another client is currently
+        holding the lock.
+
+        ``blocking_timeout`` indicates the maximum amount of time in seconds to
+        spend trying to acquire the lock. A value of ``None`` indicates
+        continue trying forever. ``blocking_timeout`` can be specified as a
+        float or integer, both representing the number of seconds to wait.
+
+        ``lock_class`` forces the specified lock implementation. Note that as
+        of redis-py 3.0, the only lock class we implement is ``Lock`` (which is
+        a Lua-based lock). So, it's unlikely you'll need this parameter, unless
+        you have created your own custom lock class.
+
+        ``thread_local`` indicates whether the lock token is placed in
+        thread-local storage. By default, the token is placed in thread local
+        storage so that a thread only sees its token, not a token set by
+        another thread. Consider the following timeline:
+
+            time: 0, thread-1 acquires `my-lock`, with a timeout of 5 seconds.
+                     thread-1 sets the token to "abc"
+            time: 1, thread-2 blocks trying to acquire `my-lock` using the
+                     Lock instance.
+            time: 5, thread-1 has not yet completed. redis expires the lock
+                     key.
+            time: 5, thread-2 acquired `my-lock` now that it's available.
+                     thread-2 sets the token to "xyz"
+            time: 6, thread-1 finishes its work and calls release(). if the
+                     token is *not* stored in thread local storage, then
+                     thread-1 would see the token value as "xyz" and would be
+                     able to successfully release the thread-2's lock.
+
+        In some use cases it's necessary to disable thread local storage. For
+        example, if you have code where one thread acquires a lock and passes
+        that lock instance to a worker thread to release later. If thread
+        local storage isn't disabled in this case, the worker thread won't see
+        the token set by the thread that acquired the lock. Our assumption
+        is that these cases aren't common and as such default to using
+        thread local storage."""
+        if lock_class is None:
+            lock_class = Lock
+        return lock_class(
+            self,
+            name,
+            timeout=timeout,
+            sleep=sleep,
+            blocking_timeout=blocking_timeout,
+            thread_local=thread_local,
+        )
+
     def _determine_nodes(self, *args, **kwargs):
         command = args[0]
         nodes_flag = kwargs.pop("nodes_flag", None)
diff --git a/redis/lock.py b/redis/lock.py
index 95bb413d7e..74e769bfea 100644
--- a/redis/lock.py
+++ b/redis/lock.py
@@ -180,7 +180,7 @@ def acquire(self, blocking=None, blocking_timeout=None, token=None):
         if token is None:
             token = uuid.uuid1().hex.encode()
         else:
-            encoder = self.redis.connection_pool.get_encoder()
+            encoder = self.redis.get_encoder()
             token = encoder.encode(token)
         if blocking is None:
             blocking = self.blocking
@@ -224,7 +224,7 @@ def owned(self):
         # need to always compare bytes to bytes
         # TODO: this can be simplified when the context manager is finished
         if stored_token and not isinstance(stored_token, bytes):
-            encoder = self.redis.connection_pool.get_encoder()
+            encoder = self.redis.get_encoder()
             stored_token = encoder.encode(stored_token)
         return self.local.token is not None and stored_token == self.local.token
 
diff --git a/tests/test_lock.py b/tests/test_lock.py
index 02cca1b522..01ecb880b8 100644
--- a/tests/test_lock.py
+++ b/tests/test_lock.py
@@ -9,7 +9,6 @@
 from .conftest import _get_client
 
 
-@pytest.mark.onlynoncluster
 class TestLock:
     @pytest.fixture()
     def r_decoded(self, request):
@@ -223,7 +222,6 @@ def test_reacquiring_lock_no_longer_owned_raises_error(self, r):
             lock.reacquire()
 
 
-@pytest.mark.onlynoncluster
 class TestLockClassSelection:
     def test_lock_class_argument(self, r):
         class MyLock:

From b1ca339c50e5c77dbba066349842bdfe49357c5e Mon Sep 17 00:00:00 2001
From: Eddie Darling <58013020+spagh-eddie@users.noreply.github.com>
Date: Tue, 1 Mar 2022 02:28:06 -0800
Subject: [PATCH 0411/1164] Fix typo in comment (#2025)

---
 redis/typing.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/typing.py b/redis/typing.py
index d96e4e3a5d..73ae411f4d 100644
--- a/redis/typing.py
+++ b/redis/typing.py
@@ -29,7 +29,7 @@
 ScriptTextT = _StringLikeT
 TimeoutSecT = Union[int, float, _StringLikeT]
 # Mapping is not covariant in the key type, which prevents
-# Mapping[_StringLikeT, X from accepting arguments of type Dict[str, X]. Using
+# Mapping[_StringLikeT, X] from accepting arguments of type Dict[str, X]. Using
 # a TypeVar instead of a Union allows mappings with any of the permitted types
 # to be passed. Care is needed if there is more than one such mapping in a
 # type signature because they will all be required to be the same key type.

From 49af47cc5ca15b52dfdc2b3d013cc01e8ec3f1ac Mon Sep 17 00:00:00 2001
From: Andrew Chen Wang <60190294+Andrew-Chen-Wang@users.noreply.github.com>
Date: Tue, 1 Mar 2022 05:43:54 -0500
Subject: [PATCH 0412/1164] Fix asyncio retry.py typing (#2011)

---
 redis/asyncio/retry.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/redis/asyncio/retry.py b/redis/asyncio/retry.py
index 9b5349402c..284eacc7ff 100644
--- a/redis/asyncio/retry.py
+++ b/redis/asyncio/retry.py
@@ -1,5 +1,5 @@
 from asyncio import sleep
-from typing import TYPE_CHECKING, Any, Awaitable, Callable, Tuple, TypeVar
+from typing import TYPE_CHECKING, Any, Awaitable, Callable, Tuple, Type, TypeVar
 
 from redis.exceptions import ConnectionError, RedisError, TimeoutError
 
@@ -19,7 +19,7 @@ def __init__(
         self,
         backoff: "AbstractBackoff",
         retries: int,
-        supported_errors: Tuple[RedisError, ...] = (
+        supported_errors: Tuple[Type[RedisError], ...] = (
             ConnectionError,
             TimeoutError,
         ),

From a77df17cf3c36444540f6bce793720e1ee06f1c7 Mon Sep 17 00:00:00 2001
From: Andrew Chen Wang <60190294+Andrew-Chen-Wang@users.noreply.github.com>
Date: Tue, 1 Mar 2022 06:45:54 -0500
Subject: [PATCH 0413/1164] Add async typing support to commands' returns
 (#2010)

* Add async typing support to commands' returns

* Fix flake8 errors

* lint fix

Co-authored-by: Chayim I. Kirshen <c@kirshen.com>
Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/commands/core.py | 151 +++++++++++++++++++++++++----------------
 1 file changed, 94 insertions(+), 57 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 968b7cc412..44650f2a8b 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -717,7 +717,7 @@ def client_unpause(self, **kwargs) -> ResponseT:
         """
         return self.execute_command("CLIENT UNPAUSE", **kwargs)
 
-    def client_no_evict(self, mode: str) -> str:
+    def client_no_evict(self, mode: str) -> Union[Awaitable[str], str]:
         """
         Sets the client eviction mode for the current connection.
 
@@ -2228,7 +2228,9 @@ class ListCommands(CommandsProtocol):
     see: https://redis.io/topics/data-types#lists
     """
 
-    def blpop(self, keys: List, timeout: Optional[int] = 0) -> List:
+    def blpop(
+        self, keys: List, timeout: Optional[int] = 0
+    ) -> Union[Awaitable[list], list]:
         """
         LPOP a value off of the first non-empty list
         named in the ``keys`` list.
@@ -2247,7 +2249,9 @@ def blpop(self, keys: List, timeout: Optional[int] = 0) -> List:
         keys.append(timeout)
         return self.execute_command("BLPOP", *keys)
 
-    def brpop(self, keys: List, timeout: Optional[int] = 0) -> List:
+    def brpop(
+        self, keys: List, timeout: Optional[int] = 0
+    ) -> Union[Awaitable[list], list]:
         """
         RPOP a value off of the first non-empty list
         named in the ``keys`` list.
@@ -2268,7 +2272,7 @@ def brpop(self, keys: List, timeout: Optional[int] = 0) -> List:
 
     def brpoplpush(
         self, src: str, dst: str, timeout: Optional[int] = 0
-    ) -> Optional[str]:
+    ) -> Union[Awaitable[Optional[str]], Optional[str]]:
         """
         Pop a value off the tail of ``src``, push it on the head of ``dst``
         and then return it.
@@ -2310,7 +2314,7 @@ def lmpop(
         *args: List[str],
         direction: str = None,
         count: Optional[int] = 1,
-    ) -> List:
+    ) -> Union[Awaitable[list], list]:
         """
         Pop ``count`` values (default 1) first non-empty list key from the list
         of args provided key names.
@@ -2323,7 +2327,9 @@ def lmpop(
 
         return self.execute_command("LMPOP", *args)
 
-    def lindex(self, name: str, index: int) -> Optional[str]:
+    def lindex(
+        self, name: str, index: int
+    ) -> Union[Awaitable[Optional[str]], Optional[str]]:
         """
         Return the item from list ``name`` at position ``index``
 
@@ -2334,7 +2340,9 @@ def lindex(self, name: str, index: int) -> Optional[str]:
         """
         return self.execute_command("LINDEX", name, index)
 
-    def linsert(self, name: str, where: str, refvalue: str, value: str) -> int:
+    def linsert(
+        self, name: str, where: str, refvalue: str, value: str
+    ) -> Union[Awaitable[int], int]:
         """
         Insert ``value`` in list ``name`` either immediately before or after
         [``where``] ``refvalue``
@@ -2346,7 +2354,7 @@ def linsert(self, name: str, where: str, refvalue: str, value: str) -> int:
         """
         return self.execute_command("LINSERT", name, where, refvalue, value)
 
-    def llen(self, name: str) -> int:
+    def llen(self, name: str) -> Union[Awaitable[int], int]:
         """
         Return the length of the list ``name``
 
@@ -2369,7 +2377,7 @@ def lpop(self, name: str, count: Optional[int] = None) -> Union[str, List, None]
         else:
             return self.execute_command("LPOP", name)
 
-    def lpush(self, name: str, *values: List) -> int:
+    def lpush(self, name: str, *values: List) -> Union[Awaitable[int], int]:
         """
         Push ``values`` onto the head of the list ``name``
 
@@ -2377,7 +2385,7 @@ def lpush(self, name: str, *values: List) -> int:
         """
         return self.execute_command("LPUSH", name, *values)
 
-    def lpushx(self, name: str, *values: List) -> int:
+    def lpushx(self, name: str, *values: List) -> Union[Awaitable[int], int]:
         """
         Push ``value`` onto the head of the list ``name`` if ``name`` exists
 
@@ -2385,7 +2393,7 @@ def lpushx(self, name: str, *values: List) -> int:
         """
         return self.execute_command("LPUSHX", name, *values)
 
-    def lrange(self, name: str, start: int, end: int) -> List:
+    def lrange(self, name: str, start: int, end: int) -> Union[Awaitable[list], list]:
         """
         Return a slice of the list ``name`` between
         position ``start`` and ``end``
@@ -2397,7 +2405,7 @@ def lrange(self, name: str, start: int, end: int) -> List:
         """
         return self.execute_command("LRANGE", name, start, end)
 
-    def lrem(self, name: str, count: int, value: str) -> int:
+    def lrem(self, name: str, count: int, value: str) -> Union[Awaitable[int], int]:
         """
         Remove the first ``count`` occurrences of elements equal to ``value``
         from the list stored at ``name``.
@@ -2411,7 +2419,7 @@ def lrem(self, name: str, count: int, value: str) -> int:
         """
         return self.execute_command("LREM", name, count, value)
 
-    def lset(self, name: str, index: int, value: str) -> str:
+    def lset(self, name: str, index: int, value: str) -> Union[Awaitable[str], str]:
         """
         Set element at ``index`` of list ``name`` to ``value``
 
@@ -2419,7 +2427,7 @@ def lset(self, name: str, index: int, value: str) -> str:
         """
         return self.execute_command("LSET", name, index, value)
 
-    def ltrim(self, name: str, start: int, end: int) -> str:
+    def ltrim(self, name: str, start: int, end: int) -> Union[Awaitable[str], str]:
         """
         Trim the list ``name``, removing all values not within the slice
         between ``start`` and ``end``
@@ -2446,7 +2454,7 @@ def rpop(self, name: str, count: Optional[int] = None) -> Union[str, List, None]
         else:
             return self.execute_command("RPOP", name)
 
-    def rpoplpush(self, src: str, dst: str) -> str:
+    def rpoplpush(self, src: str, dst: str) -> Union[Awaitable[str], str]:
         """
         RPOP a value off of the ``src`` list and atomically LPUSH it
         on to the ``dst`` list.  Returns the value.
@@ -2455,7 +2463,7 @@ def rpoplpush(self, src: str, dst: str) -> str:
         """
         return self.execute_command("RPOPLPUSH", src, dst)
 
-    def rpush(self, name: str, *values: List) -> int:
+    def rpush(self, name: str, *values: List) -> Union[Awaitable[int], int]:
         """
         Push ``values`` onto the tail of the list ``name``
 
@@ -2463,7 +2471,7 @@ def rpush(self, name: str, *values: List) -> int:
         """
         return self.execute_command("RPUSH", name, *values)
 
-    def rpushx(self, name: str, value: str) -> int:
+    def rpushx(self, name: str, value: str) -> Union[Awaitable[int], int]:
         """
         Push ``value`` onto the tail of the list ``name`` if ``name`` exists
 
@@ -2912,7 +2920,7 @@ class SetCommands(CommandsProtocol):
     see: https://redis.io/topics/data-types#sets
     """
 
-    def sadd(self, name: str, *values: List) -> int:
+    def sadd(self, name: str, *values: List) -> Union[Awaitable[int], int]:
         """
         Add ``value(s)`` to set ``name``
 
@@ -2920,7 +2928,7 @@ def sadd(self, name: str, *values: List) -> int:
         """
         return self.execute_command("SADD", name, *values)
 
-    def scard(self, name: str) -> int:
+    def scard(self, name: str) -> Union[Awaitable[int], int]:
         """
         Return the number of elements in set ``name``
 
@@ -2928,7 +2936,7 @@ def scard(self, name: str) -> int:
         """
         return self.execute_command("SCARD", name)
 
-    def sdiff(self, keys: List, *args: List) -> List:
+    def sdiff(self, keys: List, *args: List) -> Union[Awaitable[list], list]:
         """
         Return the difference of sets specified by ``keys``
 
@@ -2937,7 +2945,9 @@ def sdiff(self, keys: List, *args: List) -> List:
         args = list_or_args(keys, args)
         return self.execute_command("SDIFF", *args)
 
-    def sdiffstore(self, dest: str, keys: List, *args: List) -> int:
+    def sdiffstore(
+        self, dest: str, keys: List, *args: List
+    ) -> Union[Awaitable[int], int]:
         """
         Store the difference of sets specified by ``keys`` into a new
         set named ``dest``.  Returns the number of keys in the new set.
@@ -2947,7 +2957,7 @@ def sdiffstore(self, dest: str, keys: List, *args: List) -> int:
         args = list_or_args(keys, args)
         return self.execute_command("SDIFFSTORE", dest, *args)
 
-    def sinter(self, keys: List, *args: List) -> List:
+    def sinter(self, keys: List, *args: List) -> Union[Awaitable[list], list]:
         """
         Return the intersection of sets specified by ``keys``
 
@@ -2956,7 +2966,9 @@ def sinter(self, keys: List, *args: List) -> List:
         args = list_or_args(keys, args)
         return self.execute_command("SINTER", *args)
 
-    def sintercard(self, numkeys: int, keys: List[str], limit: int = 0) -> int:
+    def sintercard(
+        self, numkeys: int, keys: List[str], limit: int = 0
+    ) -> Union[Awaitable[int], int]:
         """
         Return the cardinality of the intersect of multiple sets specified by ``keys`.
 
@@ -2969,7 +2981,9 @@ def sintercard(self, numkeys: int, keys: List[str], limit: int = 0) -> int:
         args = [numkeys, *keys, "LIMIT", limit]
         return self.execute_command("SINTERCARD", *args)
 
-    def sinterstore(self, dest: str, keys: List, *args: List) -> int:
+    def sinterstore(
+        self, dest: str, keys: List, *args: List
+    ) -> Union[Awaitable[int], int]:
         """
         Store the intersection of sets specified by ``keys`` into a new
         set named ``dest``.  Returns the number of keys in the new set.
@@ -2979,7 +2993,7 @@ def sinterstore(self, dest: str, keys: List, *args: List) -> int:
         args = list_or_args(keys, args)
         return self.execute_command("SINTERSTORE", dest, *args)
 
-    def sismember(self, name: str, value: str) -> bool:
+    def sismember(self, name: str, value: str) -> Union[Awaitable[bool], bool]:
         """
         Return a boolean indicating if ``value`` is a member of set ``name``
 
@@ -2987,7 +3001,7 @@ def sismember(self, name: str, value: str) -> bool:
         """
         return self.execute_command("SISMEMBER", name, value)
 
-    def smembers(self, name: str) -> List:
+    def smembers(self, name: str) -> Union[Awaitable[list], list]:
         """
         Return all members of the set ``name``
 
@@ -2995,7 +3009,12 @@ def smembers(self, name: str) -> List:
         """
         return self.execute_command("SMEMBERS", name)
 
-    def smismember(self, name: str, values: List, *args: List) -> List[bool]:
+    def smismember(
+        self,
+        name: str,
+        values: List,
+        *args: List,
+    ) -> Union[Awaitable[List[bool]], List[bool]]:
         """
         Return whether each value in ``values`` is a member of the set ``name``
         as a list of ``bool`` in the order of ``values``
@@ -3005,7 +3024,7 @@ def smismember(self, name: str, values: List, *args: List) -> List[bool]:
         args = list_or_args(values, args)
         return self.execute_command("SMISMEMBER", name, *args)
 
-    def smove(self, src: str, dst: str, value: str) -> bool:
+    def smove(self, src: str, dst: str, value: str) -> Union[Awaitable[bool], bool]:
         """
         Move ``value`` from set ``src`` to set ``dst`` atomically
 
@@ -3039,7 +3058,7 @@ def srandmember(
         args = (number is not None) and [number] or []
         return self.execute_command("SRANDMEMBER", name, *args)
 
-    def srem(self, name: str, *values: List) -> int:
+    def srem(self, name: str, *values: List) -> Union[Awaitable[int], int]:
         """
         Remove ``values`` from set ``name``
 
@@ -3047,7 +3066,7 @@ def srem(self, name: str, *values: List) -> int:
         """
         return self.execute_command("SREM", name, *values)
 
-    def sunion(self, keys: List, *args: List) -> List:
+    def sunion(self, keys: List, *args: List) -> Union[Awaitable[List], List]:
         """
         Return the union of sets specified by ``keys``
 
@@ -3056,7 +3075,9 @@ def sunion(self, keys: List, *args: List) -> List:
         args = list_or_args(keys, args)
         return self.execute_command("SUNION", *args)
 
-    def sunionstore(self, dest: str, keys: List, *args: List) -> int:
+    def sunionstore(
+        self, dest: str, keys: List, *args: List
+    ) -> Union[Awaitable[int], int]:
         """
         Store the union of sets specified by ``keys`` into a new
         set named ``dest``.  Returns the number of keys in the new set.
@@ -3733,7 +3754,7 @@ def zadd(
             pieces.append(pair[0])
         return self.execute_command("ZADD", name, *pieces, **options)
 
-    def zcard(self, name: KeyT):
+    def zcard(self, name: KeyT) -> ResponseT:
         """
         Return the number of elements in the sorted set ``name``
 
@@ -3823,7 +3844,9 @@ def zinterstore(
         """
         return self._zaggregate("ZINTERSTORE", dest, keys, aggregate)
 
-    def zintercard(self, numkeys: int, keys: List[str], limit: int = 0) -> int:
+    def zintercard(
+        self, numkeys: int, keys: List[str], limit: int = 0
+    ) -> Union[Awaitable[int], int]:
         """
         Return the cardinality of the intersect of multiple sorted sets
         specified by ``keys`.
@@ -3949,7 +3972,7 @@ def zmpop(
         min: Optional[bool] = False,
         max: Optional[bool] = False,
         count: Optional[int] = 1,
-    ) -> list:
+    ) -> Union[Awaitable[list], list]:
         """
         Pop ``count`` values (default 1) off of the first non-empty sorted set
         named in the ``keys`` list.
@@ -4488,7 +4511,7 @@ class HashCommands(CommandsProtocol):
     see: https://redis.io/topics/data-types-intro#redis-hashes
     """
 
-    def hdel(self, name: str, *keys: List) -> int:
+    def hdel(self, name: str, *keys: List) -> Union[Awaitable[int], int]:
         """
         Delete ``keys`` from hash ``name``
 
@@ -4496,7 +4519,7 @@ def hdel(self, name: str, *keys: List) -> int:
         """
         return self.execute_command("HDEL", name, *keys)
 
-    def hexists(self, name: str, key: str) -> bool:
+    def hexists(self, name: str, key: str) -> Union[Awaitable[bool], bool]:
         """
         Returns a boolean indicating if ``key`` exists within hash ``name``
 
@@ -4504,7 +4527,9 @@ def hexists(self, name: str, key: str) -> bool:
         """
         return self.execute_command("HEXISTS", name, key)
 
-    def hget(self, name: str, key: str) -> Optional[str]:
+    def hget(
+        self, name: str, key: str
+    ) -> Union[Awaitable[Optional[str]], Optional[str]]:
         """
         Return the value of ``key`` within the hash ``name``
 
@@ -4512,7 +4537,7 @@ def hget(self, name: str, key: str) -> Optional[str]:
         """
         return self.execute_command("HGET", name, key)
 
-    def hgetall(self, name: str) -> dict:
+    def hgetall(self, name: str) -> Union[Awaitable[dict], dict]:
         """
         Return a Python dict of the hash's name/value pairs
 
@@ -4520,7 +4545,9 @@ def hgetall(self, name: str) -> dict:
         """
         return self.execute_command("HGETALL", name)
 
-    def hincrby(self, name: str, key: str, amount: int = 1) -> int:
+    def hincrby(
+        self, name: str, key: str, amount: int = 1
+    ) -> Union[Awaitable[int], int]:
         """
         Increment the value of ``key`` in hash ``name`` by ``amount``
 
@@ -4528,7 +4555,9 @@ def hincrby(self, name: str, key: str, amount: int = 1) -> int:
         """
         return self.execute_command("HINCRBY", name, key, amount)
 
-    def hincrbyfloat(self, name: str, key: str, amount: float = 1.0) -> float:
+    def hincrbyfloat(
+        self, name: str, key: str, amount: float = 1.0
+    ) -> Union[Awaitable[float], float]:
         """
         Increment the value of ``key`` in hash ``name`` by floating ``amount``
 
@@ -4536,7 +4565,7 @@ def hincrbyfloat(self, name: str, key: str, amount: float = 1.0) -> float:
         """
         return self.execute_command("HINCRBYFLOAT", name, key, amount)
 
-    def hkeys(self, name: str) -> List:
+    def hkeys(self, name: str) -> Union[Awaitable[List], List]:
         """
         Return the list of keys within hash ``name``
 
@@ -4544,7 +4573,7 @@ def hkeys(self, name: str) -> List:
         """
         return self.execute_command("HKEYS", name)
 
-    def hlen(self, name: str) -> int:
+    def hlen(self, name: str) -> Union[Awaitable[int], int]:
         """
         Return the number of elements in hash ``name``
 
@@ -4558,7 +4587,7 @@ def hset(
         key: Optional[str] = None,
         value: Optional[str] = None,
         mapping: Optional[dict] = None,
-    ) -> int:
+    ) -> Union[Awaitable[int], int]:
         """
         Set ``key`` to ``value`` within hash ``name``,
         ``mapping`` accepts a dict of key/value pairs that will be
@@ -4578,7 +4607,7 @@ def hset(
 
         return self.execute_command("HSET", name, *items)
 
-    def hsetnx(self, name: str, key: str, value: str) -> bool:
+    def hsetnx(self, name: str, key: str, value: str) -> Union[Awaitable[bool], bool]:
         """
         Set ``key`` to ``value`` within hash ``name`` if ``key`` does not
         exist.  Returns 1 if HSETNX created a field, otherwise 0.
@@ -4587,7 +4616,7 @@ def hsetnx(self, name: str, key: str, value: str) -> bool:
         """
         return self.execute_command("HSETNX", name, key, value)
 
-    def hmset(self, name: str, mapping: dict) -> str:
+    def hmset(self, name: str, mapping: dict) -> Union[Awaitable[str], str]:
         """
         Set key to value within hash ``name`` for each corresponding
         key and value from the ``mapping`` dict.
@@ -4607,7 +4636,7 @@ def hmset(self, name: str, mapping: dict) -> str:
             items.extend(pair)
         return self.execute_command("HMSET", name, *items)
 
-    def hmget(self, name: str, keys: List, *args: List) -> List:
+    def hmget(self, name: str, keys: List, *args: List) -> Union[Awaitable[List], List]:
         """
         Returns a list of values ordered identically to ``keys``
 
@@ -4616,7 +4645,7 @@ def hmget(self, name: str, keys: List, *args: List) -> List:
         args = list_or_args(keys, args)
         return self.execute_command("HMGET", name, *args)
 
-    def hvals(self, name: str) -> List:
+    def hvals(self, name: str) -> Union[Awaitable[List], List]:
         """
         Return the list of values within hash ``name``
 
@@ -4624,7 +4653,7 @@ def hvals(self, name: str) -> List:
         """
         return self.execute_command("HVALS", name)
 
-    def hstrlen(self, name: str, key: str) -> int:
+    def hstrlen(self, name: str, key: str) -> Union[Awaitable[int], int]:
         """
         Return the number of bytes stored in the value of ``key``
         within hash ``name``
@@ -4779,10 +4808,12 @@ class ScriptCommands(CommandsProtocol):
 
     def _eval(
         self, command: str, script: str, numkeys: int, *keys_and_args: list
-    ) -> str:
+    ) -> Union[Awaitable[str], str]:
         return self.execute_command(command, script, numkeys, *keys_and_args)
 
-    def eval(self, script: str, numkeys: int, *keys_and_args: list) -> str:
+    def eval(
+        self, script: str, numkeys: int, *keys_and_args: list
+    ) -> Union[Awaitable[str], str]:
         """
         Execute the Lua ``script``, specifying the ``numkeys`` the script
         will touch and the key names and argument values in ``keys_and_args``.
@@ -4795,7 +4826,9 @@ def eval(self, script: str, numkeys: int, *keys_and_args: list) -> str:
         """
         return self._eval("EVAL", script, numkeys, *keys_and_args)
 
-    def eval_ro(self, script: str, numkeys: int, *keys_and_args: list) -> str:
+    def eval_ro(
+        self, script: str, numkeys: int, *keys_and_args: list
+    ) -> Union[Awaitable[str], str]:
         """
         The read-only variant of the EVAL command
 
@@ -4809,10 +4842,12 @@ def eval_ro(self, script: str, numkeys: int, *keys_and_args: list) -> str:
 
     def _evalsha(
         self, command: str, sha: str, numkeys: int, *keys_and_args: list
-    ) -> str:
+    ) -> Union[Awaitable[str], str]:
         return self.execute_command(command, sha, numkeys, *keys_and_args)
 
-    def evalsha(self, sha: str, numkeys: int, *keys_and_args: list) -> str:
+    def evalsha(
+        self, sha: str, numkeys: int, *keys_and_args: list
+    ) -> Union[Awaitable[str], str]:
         """
         Use the ``sha`` to execute a Lua script already registered via EVAL
         or SCRIPT LOAD. Specify the ``numkeys`` the script will touch and the
@@ -4826,7 +4861,9 @@ def evalsha(self, sha: str, numkeys: int, *keys_and_args: list) -> str:
         """
         return self._evalsha("EVALSHA", sha, numkeys, *keys_and_args)
 
-    def evalsha_ro(self, sha: str, numkeys: int, *keys_and_args: list) -> str:
+    def evalsha_ro(
+        self, sha: str, numkeys: int, *keys_and_args: list
+    ) -> Union[Awaitable[str], str]:
         """
         The read-only variant of the EVALSHA command
 
@@ -4839,7 +4876,7 @@ def evalsha_ro(self, sha: str, numkeys: int, *keys_and_args: list) -> str:
         """
         return self._evalsha("EVALSHA_RO", sha, numkeys, *keys_and_args)
 
-    def script_exists(self, *args: str):
+    def script_exists(self, *args: str) -> ResponseT:
         """
         Check if a script exists in the script cache by specifying the SHAs of
         each script as ``args``. Returns a list of boolean values indicating if
@@ -5538,7 +5575,7 @@ def function_flush(self, mode: str = "SYNC") -> Union[Awaitable[str], str]:
 
     def function_list(
         self, library: Optional[str] = "*", withcode: Optional[bool] = False
-    ) -> Union[Awaitable[list], list]:
+    ) -> Union[Awaitable[List], List]:
         """
         Return information about the functions and libraries.
         :param library: pecify a pattern for matching library names
@@ -5609,7 +5646,7 @@ def function_kill(self) -> Union[Awaitable[str], str]:
         """
         return self.execute_command("FUNCTION KILL")
 
-    def function_stats(self) -> Union[Awaitable[list], list]:
+    def function_stats(self) -> Union[Awaitable[List], List]:
         """
         Return information about the function that's currently running
         and information about the available execution engines.

From c5d19b8571d2b15a29637f56a51b0da560072945 Mon Sep 17 00:00:00 2001
From: dogukanteber <47397379+dogukanteber@users.noreply.github.com>
Date: Wed, 2 Mar 2022 13:27:12 +0300
Subject: [PATCH 0414/1164] Add support for AUTH (#1929)

* Add support for AUTH

* Fix linter error

* test fix

* fix test in cluster

Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: Chayim I. Kirshen <c@kirshen.com>
Co-authored-by: dvora-h <dvora.heller@redis.com>
---
 redis/cluster.py       |  1 +
 redis/commands/core.py | 14 ++++++++------
 tests/test_commands.py | 24 ++++++++++++++++++++----
 3 files changed, 29 insertions(+), 10 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index 3b30a6e0a8..4491e29f5a 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -228,6 +228,7 @@ class RedisCluster(RedisClusterCommands):
                 "ACL SETUSER",
                 "ACL USERS",
                 "ACL WHOAMI",
+                "AUTH",
                 "CLIENT LIST",
                 "CLIENT SETNAME",
                 "CLIENT GETNAME",
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 44650f2a8b..2937780577 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -369,14 +369,16 @@ class ManagementCommands(CommandsProtocol):
     Redis management commands
     """
 
-    def auth(self):
+    def auth(self, password, username=None, **kwargs):
         """
-        This function throws a NotImplementedError since it is intentionally
-        not supported.
+        Authenticates the user. If you do not pass username, Redis will try to
+        authenticate for the "default" user. If you do pass username, it will
+        authenticate for the given user.
+        For more information check https://redis.io/commands/auth
         """
-        raise NotImplementedError(
-            "AUTH is intentionally not implemented in the client."
-        )
+        if username:
+            return self.execute_command("AUTH", username, password, **kwargs)
+        return self.execute_command
 
     def bgrewriteaof(self, **kwargs):
         """Tell the Redis server to rewrite the AOF file from data in memory.
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 5c32d5f296..dc10cde165 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -65,16 +65,32 @@ def test_case_insensitive_command_names(self, r):
 
 
 class TestRedisCommands:
+    def test_auth(self, r, request):
+        username = "redis-py-auth"
+
+        def teardown():
+            r.acl_deluser(username)
+
+        request.addfinalizer(teardown)
+
+        assert r.acl_setuser(
+            username,
+            enabled=True,
+            passwords=["+strong_password"],
+            commands=["+acl"],
+        )
+
+        assert r.auth(username=username, password="strong_password") is True
+
+        with pytest.raises(exceptions.ResponseError):
+            r.auth(username=username, password="wrong_password")
+
     def test_command_on_invalid_key_type(self, r):
         r.lpush("a", "1")
         with pytest.raises(redis.ResponseError):
             r["a"]
 
     # SERVER INFORMATION
-    def test_auth_not_implemented(self, r):
-        with pytest.raises(NotImplementedError):
-            r.auth()
-
     @skip_if_server_version_lt("6.0.0")
     def test_acl_cat_no_category(self, r):
         categories = r.acl_cat()

From 98fd06eb8df1ecc109b4a5fb2d2a2e810142283e Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 6 Mar 2022 13:49:13 +0200
Subject: [PATCH 0415/1164] Add support for JSON, TIMESERIES, BLOOM & GRAPH
 commands in cluster (#2032)

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/cluster.py                      | 30 +++++++++++++++++++++++++-
 redis/commands/cluster.py             |  2 ++
 redis/commands/json/__init__.py       | 30 ++++++++++++++++++++------
 redis/commands/parser.py              |  9 +++++++-
 redis/commands/timeseries/__init__.py | 31 +++++++++++++++++++++------
 tests/test_bloom.py                   |  1 +
 tests/test_graph.py                   |  1 +
 tests/test_search.py                  |  3 +++
 tests/test_timeseries.py              |  5 +++++
 tox.ini                               |  2 +-
 10 files changed, 98 insertions(+), 16 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index 4491e29f5a..4b327ad79e 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -284,6 +284,7 @@ class RedisCluster(RedisClusterCommands):
                 "READONLY",
                 "READWRITE",
                 "TIME",
+                "GRAPH.CONFIG",
             ],
             DEFAULT_NODE,
         ),
@@ -810,6 +811,10 @@ def lock(
             thread_local=thread_local,
         )
 
+    def set_response_callback(self, command, callback):
+        """Set a custom Response Callback"""
+        self.cluster_response_callbacks[command] = callback
+
     def _determine_nodes(self, *args, **kwargs):
         command = args[0]
         nodes_flag = kwargs.pop("nodes_flag", None)
@@ -1181,6 +1186,20 @@ def _process_result(self, command, res, **kwargs):
         else:
             return res
 
+    def load_external_module(
+        self,
+        funcname,
+        func,
+    ):
+        """
+        This function can be used to add externally defined redis modules,
+        and their namespaces to the redis client.
+
+        ``funcname`` - A string containing the name of the function to create
+        ``func`` - The function, being added to this class.
+        """
+        setattr(self, funcname, func)
+
 
 class ClusterNode:
     def __init__(self, host, port, server_type=None, redis_connection=None):
@@ -2026,7 +2045,13 @@ def _send_cluster_commands(
 
         # turn the response back into a simple flat array that corresponds
         # to the sequence of commands issued in the stack in pipeline.execute()
-        response = [c.result for c in sorted(stack, key=lambda x: x.position)]
+        response = []
+        for c in sorted(stack, key=lambda x: x.position):
+            if c.args[0] in self.cluster_response_callbacks:
+                c.result = self.cluster_response_callbacks[c.args[0]](
+                    c.result, **c.options
+                )
+            response.append(c.result)
 
         if raise_on_error:
             self.raise_first_error(stack)
@@ -2040,6 +2065,9 @@ def _fail_on_redirect(self, allow_redirections):
                 "ASK & MOVED redirection not allowed in this pipeline"
             )
 
+    def exists(self, *keys):
+        return self.execute_command("EXISTS", *keys)
+
     def eval(self):
         """ """
         raise RedisClusterException("method eval() is not implemented")
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index 8bdcbbadf6..7342c0c482 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -9,6 +9,7 @@
     ScriptCommands,
 )
 from .helpers import list_or_args
+from .redismodules import RedisModuleCommands
 
 
 class ClusterMultiKeyCommands:
@@ -212,6 +213,7 @@ class RedisClusterCommands(
     PubSubCommands,
     ClusterDataAccessCommands,
     ScriptCommands,
+    RedisModuleCommands,
 ):
     """
     A class for all Redis Cluster commands
diff --git a/redis/commands/json/__init__.py b/redis/commands/json/__init__.py
index 12c0648722..638e4eb166 100644
--- a/redis/commands/json/__init__.py
+++ b/redis/commands/json/__init__.py
@@ -103,16 +103,34 @@ def pipeline(self, transaction=True, shard_hint=None):
         pipe.jsonget('foo')
         pipe.jsonget('notakey')
         """
-        p = Pipeline(
-            connection_pool=self.client.connection_pool,
-            response_callbacks=self.MODULE_CALLBACKS,
-            transaction=transaction,
-            shard_hint=shard_hint,
-        )
+        if isinstance(self.client, redis.RedisCluster):
+            p = ClusterPipeline(
+                nodes_manager=self.client.nodes_manager,
+                commands_parser=self.client.commands_parser,
+                startup_nodes=self.client.nodes_manager.startup_nodes,
+                result_callbacks=self.client.result_callbacks,
+                cluster_response_callbacks=self.client.cluster_response_callbacks,
+                cluster_error_retry_attempts=self.client.cluster_error_retry_attempts,
+                read_from_replicas=self.client.read_from_replicas,
+                reinitialize_steps=self.client.reinitialize_steps,
+            )
+
+        else:
+            p = Pipeline(
+                connection_pool=self.client.connection_pool,
+                response_callbacks=self.MODULE_CALLBACKS,
+                transaction=transaction,
+                shard_hint=shard_hint,
+            )
+
         p._encode = self._encode
         p._decode = self._decode
         return p
 
 
+class ClusterPipeline(JSONCommands, redis.cluster.ClusterPipeline):
+    """Cluster pipeline for the module."""
+
+
 class Pipeline(JSONCommands, redis.client.Pipeline):
     """Pipeline for the module."""
diff --git a/redis/commands/parser.py b/redis/commands/parser.py
index 2bb0576910..89292ab2d3 100644
--- a/redis/commands/parser.py
+++ b/redis/commands/parser.py
@@ -17,7 +17,14 @@ def __init__(self, redis_connection):
         self.initialize(redis_connection)
 
     def initialize(self, r):
-        self.commands = r.execute_command("COMMAND")
+        commands = r.execute_command("COMMAND")
+        uppercase_commands = []
+        for cmd in commands:
+            if any(x.isupper() for x in cmd):
+                uppercase_commands.append(cmd)
+        for cmd in uppercase_commands:
+            commands[cmd.lower()] = commands.pop(cmd)
+        self.commands = commands
 
     # As soon as this PR is merged into Redis, we should reimplement
     # our logic to use COMMAND INFO changes to determine the key positions
diff --git a/redis/commands/timeseries/__init__.py b/redis/commands/timeseries/__init__.py
index 5b1f15114d..4720a430f8 100644
--- a/redis/commands/timeseries/__init__.py
+++ b/redis/commands/timeseries/__init__.py
@@ -1,4 +1,4 @@
-import redis.client
+import redis
 
 from ..helpers import parse_to_list
 from .commands import (
@@ -67,14 +67,31 @@ def pipeline(self, transaction=True, shard_hint=None):
         pipeline.execute()
 
         """
-        p = Pipeline(
-            connection_pool=self.client.connection_pool,
-            response_callbacks=self.MODULE_CALLBACKS,
-            transaction=transaction,
-            shard_hint=shard_hint,
-        )
+        if isinstance(self.client, redis.RedisCluster):
+            p = ClusterPipeline(
+                nodes_manager=self.client.nodes_manager,
+                commands_parser=self.client.commands_parser,
+                startup_nodes=self.client.nodes_manager.startup_nodes,
+                result_callbacks=self.client.result_callbacks,
+                cluster_response_callbacks=self.client.cluster_response_callbacks,
+                cluster_error_retry_attempts=self.client.cluster_error_retry_attempts,
+                read_from_replicas=self.client.read_from_replicas,
+                reinitialize_steps=self.client.reinitialize_steps,
+            )
+
+        else:
+            p = Pipeline(
+                connection_pool=self.client.connection_pool,
+                response_callbacks=self.MODULE_CALLBACKS,
+                transaction=transaction,
+                shard_hint=shard_hint,
+            )
         return p
 
 
+class ClusterPipeline(TimeSeriesCommands, redis.cluster.ClusterPipeline):
+    """Cluster pipeline for the module."""
+
+
 class Pipeline(TimeSeriesCommands, redis.client.Pipeline):
     """Pipeline for the module."""
diff --git a/tests/test_bloom.py b/tests/test_bloom.py
index 8936584ea8..a3e9e158f4 100644
--- a/tests/test_bloom.py
+++ b/tests/test_bloom.py
@@ -191,6 +191,7 @@ def test_cms(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.onlynoncluster
 def test_cms_merge(client):
     assert client.cms().initbydim("A", 1000, 5)
     assert client.cms().initbydim("B", 1000, 5)
diff --git a/tests/test_graph.py b/tests/test_graph.py
index 8de63465a0..3a430ed4ab 100644
--- a/tests/test_graph.py
+++ b/tests/test_graph.py
@@ -342,6 +342,7 @@ def test_config(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.onlynoncluster
 def test_list_keys(client):
     result = client.graph().list_keys()
     assert result == []
diff --git a/tests/test_search.py b/tests/test_search.py
index 5ee17a2c36..88d57a921d 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -21,6 +21,9 @@
 
 from .conftest import default_redismod_url, skip_ifmodversion_lt
 
+pytestmark = pytest.mark.onlynoncluster
+
+
 WILL_PLAY_TEXT = os.path.abspath(
     os.path.join(os.path.dirname(__file__), "testdata", "will_play_text.csv.bz2")
 )
diff --git a/tests/test_timeseries.py b/tests/test_timeseries.py
index aee37aaa43..421c9d5c04 100644
--- a/tests/test_timeseries.py
+++ b/tests/test_timeseries.py
@@ -264,6 +264,7 @@ def test_rev_range(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.onlynoncluster
 def testMultiRange(client):
     client.ts().create(1, labels={"Test": "This", "team": "ny"})
     client.ts().create(2, labels={"Test": "This", "Taste": "That", "team": "sf"})
@@ -293,6 +294,7 @@ def testMultiRange(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 def test_multi_range_advanced(client):
     client.ts().create(1, labels={"Test": "This", "team": "ny"})
@@ -349,6 +351,7 @@ def test_multi_range_advanced(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 def test_multi_reverse_range(client):
     client.ts().create(1, labels={"Test": "This", "team": "ny"})
@@ -442,6 +445,7 @@ def test_get(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.onlynoncluster
 def test_mget(client):
     client.ts().create(1, labels={"Test": "This"})
     client.ts().create(2, labels={"Test": "This", "Taste": "That"})
@@ -483,6 +487,7 @@ def testInfoDuplicatePolicy(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.onlynoncluster
 def test_query_index(client):
     client.ts().create(1, labels={"Test": "This"})
     client.ts().create(2, labels={"Test": "This", "Taste": "That"})
diff --git a/tox.ini b/tox.ini
index 82e79d7611..d4f15acd50 100644
--- a/tox.ini
+++ b/tox.ini
@@ -286,7 +286,7 @@ setenv =
 commands =
     standalone: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' {posargs}
     standalone-uvloop: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' --uvloop {posargs}
-    cluster: pytest --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={env:CLUSTER_URL:} {posargs}
+    cluster: pytest --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={env:CLUSTER_URL:} --redismod-url={env:CLUSTER_URL:} {posargs}
     cluster-uvloop: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' --uvloop {posargs}
 
 [testenv:redis5]

From 6c798df564b644bdad1d7e09f1d750e4fee34848 Mon Sep 17 00:00:00 2001
From: Marek Czaplicki <mdczaplicki@gmail.com>
Date: Sun, 6 Mar 2022 13:29:01 +0100
Subject: [PATCH 0416/1164] Add support for HSET items (#2006)

* Add `items` parameter to `hset`

* Add test for `hset` with `items`

* Update CHANGES

* fix test_profile

Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: dvora-h <dvora.heller@redis.com>
---
 CHANGES                |  3 +++
 redis/commands/core.py |  7 +++++--
 tests/test_commands.py | 11 +++++++++++
 tests/test_search.py   |  2 +-
 4 files changed, 20 insertions(+), 3 deletions(-)

diff --git a/CHANGES b/CHANGES
index ddf7cfd4e3..ca2d2e818d 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,6 +1,9 @@
+
+    * Add `items` parameter to `hset` signature
   	* Create codeql-analysis.yml (#1988). Thanks @chayim
     * Add limited support for Lua scripting with RedisCluster
     * Implement `.lock()` method on RedisCluster
+
 * 4.1.3 (Feb 8, 2022)
     * Fix flushdb and flushall (#1926)
     * Add redis5 and redis4 dockers (#1871)
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 2937780577..457b5c8ad4 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -4589,18 +4589,21 @@ def hset(
         key: Optional[str] = None,
         value: Optional[str] = None,
         mapping: Optional[dict] = None,
+        items: Optional[list] = None,
     ) -> Union[Awaitable[int], int]:
         """
         Set ``key`` to ``value`` within hash ``name``,
         ``mapping`` accepts a dict of key/value pairs that will be
         added to hash ``name``.
+        ``items`` accepts a list of key/value pairs that will be
+        added to hash ``name``.
         Returns the number of fields that were added.
 
         For more information check https://redis.io/commands/hset
         """
-        if key is None and not mapping:
+        if key is None and not mapping and not items:
             raise DataError("'hset' with no key value pairs")
-        items = []
+        items = items or []
         if key is not None:
             items.extend((key, value))
         if mapping:
diff --git a/tests/test_commands.py b/tests/test_commands.py
index dc10cde165..46303e50ac 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2546,6 +2546,17 @@ def test_hset_with_multi_key_values(self, r):
         assert r.hget("b", "2") == b"2"
         assert r.hget("b", "foo") == b"bar"
 
+    def test_hset_with_key_values_passed_as_list(self, r):
+        r.hset("a", items=["1", 1, "2", 2, "3", 3])
+        assert r.hget("a", "1") == b"1"
+        assert r.hget("a", "2") == b"2"
+        assert r.hget("a", "3") == b"3"
+
+        r.hset("b", "foo", "bar", items=["1", 1, "2", 2])
+        assert r.hget("b", "1") == b"1"
+        assert r.hget("b", "2") == b"2"
+        assert r.hget("b", "foo") == b"bar"
+
     def test_hset_without_data(self, r):
         with pytest.raises(exceptions.DataError):
             r.hset("x")
diff --git a/tests/test_search.py b/tests/test_search.py
index 88d57a921d..5eb8e9762a 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1500,7 +1500,7 @@ def test_profile(client):
     res, det = client.ft().profile(req)
     assert det["Iterators profile"]["Counter"] == 2.0
     assert det["Iterators profile"]["Type"] == "WILDCARD"
-    assert det["Parsing time"] < 0.5
+    assert isinstance(det["Parsing time"], float)
     assert len(res.rows) == 2  # check also the search result
 
 

From c4e408880c0fbfe714cd9ad4e1e6b908f00be9b5 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 6 Mar 2022 21:25:34 +0200
Subject: [PATCH 0417/1164] Add cluster support for functions (#2016)

* cluster support for functions

* fix test_list_on_cluster mark

* fix mark

* cluster unstable url

* fix

* fix cluster url

* skip tests

* linters

* linters
---
 redis/cluster.py          |  13 ++++
 redis/commands/cluster.py |   2 +
 tests/test_function.py    | 128 +++++++++++++++++++++++---------------
 tox.ini                   |   3 +-
 4 files changed, 94 insertions(+), 52 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index 4b327ad79e..8c2dfc271b 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -292,12 +292,21 @@ class RedisCluster(RedisClusterCommands):
             [
                 "FLUSHALL",
                 "FLUSHDB",
+                "FUNCTION DELETE",
+                "FUNCTION FLUSH",
+                "FUNCTION LIST",
+                "FUNCTION LOAD",
+                "FUNCTION RESTORE",
                 "SCRIPT EXISTS",
                 "SCRIPT FLUSH",
                 "SCRIPT LOAD",
             ],
             PRIMARIES,
         ),
+        list_keys_to_dict(
+            ["FUNCTION DUMP"],
+            RANDOM,
+        ),
         list_keys_to_dict(
             [
                 "CLUSTER COUNTKEYSINSLOT",
@@ -916,6 +925,10 @@ def determine_slot(self, *args):
         else:
             keys = self._get_command_keys(*args)
             if keys is None or len(keys) == 0:
+                # FCALL can call a function with 0 keys, that means the function
+                #  can be run on any node so we can just return a random slot
+                if command in ("FCALL", "FCALL_RO"):
+                    return random.randrange(0, REDIS_CLUSTER_HASH_SLOTS)
                 raise RedisClusterException(
                     "No way to dispatch this command to Redis Cluster. "
                     "Missing key.\nYou can execute the command by specifying "
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index 7342c0c482..e14b6e35ee 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -4,6 +4,7 @@
 from .core import (
     ACLCommands,
     DataAccessCommands,
+    FunctionCommands,
     ManagementCommands,
     PubSubCommands,
     ScriptCommands,
@@ -213,6 +214,7 @@ class RedisClusterCommands(
     PubSubCommands,
     ClusterDataAccessCommands,
     ScriptCommands,
+    FunctionCommands,
     RedisModuleCommands,
 ):
     """
diff --git a/tests/test_function.py b/tests/test_function.py
index 921ba30444..6f0a6ec1e1 100644
--- a/tests/test_function.py
+++ b/tests/test_function.py
@@ -2,6 +2,8 @@
 
 from redis.exceptions import ResponseError
 
+from .conftest import skip_if_server_version_lt
+
 function = "redis.register_function('myfunc', function(keys, args) return args[1] end)"
 function2 = "redis.register_function('hello', function() return 'Hello World' end)"
 set_function = "redis.register_function('set', function(keys, args) \
@@ -10,42 +12,42 @@
                 return redis.call('GET', keys[1]) end)"
 
 
-@pytest.mark.onlynoncluster
-# @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
+@skip_if_server_version_lt("7.0.0")
 class TestFunction:
     @pytest.fixture(autouse=True)
-    def reset_functions(self, unstable_r):
-        unstable_r.function_flush()
+    def reset_functions(self, r):
+        r.function_flush()
 
-    def test_function_load(self, unstable_r):
-        assert unstable_r.function_load("Lua", "mylib", function)
-        assert unstable_r.function_load("Lua", "mylib", function, replace=True)
+    def test_function_load(self, r):
+        assert r.function_load("Lua", "mylib", function)
+        assert r.function_load("Lua", "mylib", function, replace=True)
         with pytest.raises(ResponseError):
-            unstable_r.function_load("Lua", "mylib", function)
+            r.function_load("Lua", "mylib", function)
         with pytest.raises(ResponseError):
-            unstable_r.function_load("Lua", "mylib2", function)
+            r.function_load("Lua", "mylib2", function)
 
-    def test_function_delete(self, unstable_r):
-        unstable_r.function_load("Lua", "mylib", set_function)
+    def test_function_delete(self, r):
+        r.function_load("Lua", "mylib", set_function)
         with pytest.raises(ResponseError):
-            unstable_r.function_load("Lua", "mylib", set_function)
-        assert unstable_r.fcall("set", 1, "foo", "bar") == "OK"
-        assert unstable_r.function_delete("mylib")
+            r.function_load("Lua", "mylib", set_function)
+        assert r.fcall("set", 1, "foo", "bar") == "OK"
+        assert r.function_delete("mylib")
         with pytest.raises(ResponseError):
-            unstable_r.fcall("set", 1, "foo", "bar")
-        assert unstable_r.function_load("Lua", "mylib", set_function)
+            r.fcall("set", 1, "foo", "bar")
+        assert r.function_load("Lua", "mylib", set_function)
 
-    def test_function_flush(self, unstable_r):
-        unstable_r.function_load("Lua", "mylib", function)
-        assert unstable_r.fcall("myfunc", 0, "hello") == "hello"
-        assert unstable_r.function_flush()
+    def test_function_flush(self, r):
+        r.function_load("Lua", "mylib", function)
+        assert r.fcall("myfunc", 0, "hello") == "hello"
+        assert r.function_flush()
         with pytest.raises(ResponseError):
-            unstable_r.fcall("myfunc", 0, "hello")
+            r.fcall("myfunc", 0, "hello")
         with pytest.raises(ResponseError):
-            unstable_r.function_flush("ABC")
+            r.function_flush("ABC")
 
-    def test_function_list(self, unstable_r):
-        unstable_r.function_load("Lua", "mylib", function)
+    @pytest.mark.onlynoncluster
+    def test_function_list(self, r):
+        r.function_load("Lua", "mylib", function)
         res = [
             [
                 "library_name",
@@ -58,37 +60,61 @@ def test_function_list(self, unstable_r):
                 [["name", "myfunc", "description", None]],
             ],
         ]
-        assert unstable_r.function_list() == res
-        assert unstable_r.function_list(library="*lib") == res
-        assert unstable_r.function_list(withcode=True)[0][9] == function
+        assert r.function_list() == res
+        assert r.function_list(library="*lib") == res
+        assert r.function_list(withcode=True)[0][9] == function
+
+    @pytest.mark.onlycluster
+    def test_function_list_on_cluster(self, r):
+        r.function_load("Lua", "mylib", function)
+        function_list = [
+            [
+                "library_name",
+                "mylib",
+                "engine",
+                "LUA",
+                "description",
+                None,
+                "functions",
+                [["name", "myfunc", "description", None]],
+            ],
+        ]
+        primaries = r.get_primaries()
+        res = {}
+        for node in primaries:
+            res[node.name] = function_list
+        assert r.function_list() == res
+        assert r.function_list(library="*lib") == res
+        node = primaries[0].name
+        assert r.function_list(withcode=True)[node][0][9] == function
 
-    def test_fcall(self, unstable_r):
-        unstable_r.function_load("Lua", "mylib", set_function)
-        unstable_r.function_load("Lua", "mylib2", get_function)
-        assert unstable_r.fcall("set", 1, "foo", "bar") == "OK"
-        assert unstable_r.fcall("get", 1, "foo") == "bar"
+    def test_fcall(self, r):
+        r.function_load("Lua", "mylib", set_function)
+        r.function_load("Lua", "mylib2", get_function)
+        assert r.fcall("set", 1, "foo", "bar") == "OK"
+        assert r.fcall("get", 1, "foo") == "bar"
         with pytest.raises(ResponseError):
-            unstable_r.fcall("myfunc", 0, "hello")
+            r.fcall("myfunc", 0, "hello")
 
-    def test_fcall_ro(self, unstable_r):
-        unstable_r.function_load("Lua", "mylib", function)
-        assert unstable_r.fcall_ro("myfunc", 0, "hello") == "hello"
-        unstable_r.function_load("Lua", "mylib2", set_function)
+    def test_fcall_ro(self, r):
+        r.function_load("Lua", "mylib", function)
+        assert r.fcall_ro("myfunc", 0, "hello") == "hello"
+        r.function_load("Lua", "mylib2", set_function)
         with pytest.raises(ResponseError):
-            unstable_r.fcall_ro("set", 1, "foo", "bar")
+            r.fcall_ro("set", 1, "foo", "bar")
 
-    def test_function_dump_restore(self, unstable_r):
-        unstable_r.function_load("Lua", "mylib", set_function)
-        payload = unstable_r.function_dump()
-        assert unstable_r.fcall("set", 1, "foo", "bar") == "OK"
-        unstable_r.function_delete("mylib")
+    def test_function_dump_restore(self, r):
+        r.function_load("Lua", "mylib", set_function)
+        payload = r.function_dump()
+        assert r.fcall("set", 1, "foo", "bar") == "OK"
+        r.function_delete("mylib")
         with pytest.raises(ResponseError):
-            unstable_r.fcall("set", 1, "foo", "bar")
-        assert unstable_r.function_restore(payload)
-        assert unstable_r.fcall("set", 1, "foo", "bar") == "OK"
-        unstable_r.function_load("Lua", "mylib2", get_function)
-        assert unstable_r.fcall("get", 1, "foo") == "bar"
-        unstable_r.function_delete("mylib")
-        assert unstable_r.function_restore(payload, "FLUSH")
+            r.fcall("set", 1, "foo", "bar")
+        assert r.function_restore(payload)
+        assert r.fcall("set", 1, "foo", "bar") == "OK"
+        r.function_load("Lua", "mylib2", get_function)
+        assert r.fcall("get", 1, "foo") == "bar"
+        r.function_delete("mylib")
+        assert r.function_restore(payload, "FLUSH")
         with pytest.raises(ResponseError):
-            unstable_r.fcall("get", 1, "foo")
+            r.fcall("get", 1, "foo")
diff --git a/tox.ini b/tox.ini
index d4f15acd50..e9174a66c5 100644
--- a/tox.ini
+++ b/tox.ini
@@ -283,10 +283,11 @@ extras =
     ocsp: cryptography, pyopenssl, requests
 setenv =
     CLUSTER_URL = "redis://localhost:16379/0"
+    UNSTABLE_CLUSTER_URL = "redis://localhost:6372/0"
 commands =
     standalone: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' {posargs}
     standalone-uvloop: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' --uvloop {posargs}
-    cluster: pytest --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={env:CLUSTER_URL:} --redismod-url={env:CLUSTER_URL:} {posargs}
+    cluster: pytest --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={env:CLUSTER_URL:} --redis-unstable-url={env:UNSTABLE_CLUSTER_URL:} {posargs}
     cluster-uvloop: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' --uvloop {posargs}
 
 [testenv:redis5]

From 4dc48d610f009ad14ff19ec7fcc3ac5c960d9490 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 7 Mar 2022 00:53:28 +0200
Subject: [PATCH 0418/1164] Implemented COMMAND DOCS by always throwing
 NotImplementedError (#2020)

* command docs

* Add support for AUTH (#1929)

* Add support for AUTH

* Fix linter error

* test fix

* fix test in cluster

Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: Chayim I. Kirshen <c@kirshen.com>
Co-authored-by: dvora-h <dvora.heller@redis.com>

* Add support for JSON, TIMESERIES, BLOOM & GRAPH commands in cluster (#2032)

Co-authored-by: Chayim <chayim@users.noreply.github.com>

* Add support for HSET items (#2006)

* Add `items` parameter to `hset`

* Add test for `hset` with `items`

* Update CHANGES

* fix test_profile

Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: dvora-h <dvora.heller@redis.com>

* Add cluster support for functions (#2016)

* cluster support for functions

* fix test_list_on_cluster mark

* fix mark

* cluster unstable url

* fix

* fix cluster url

* skip tests

* linters

* linters

* skip test

Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: dogukanteber <47397379+dogukanteber@users.noreply.github.com>
Co-authored-by: Chayim I. Kirshen <c@kirshen.com>
Co-authored-by: Marek Czaplicki <mdczaplicki@gmail.com>
---
 redis/commands/core.py | 9 +++++++++
 tests/test_commands.py | 5 +++++
 2 files changed, 14 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 457b5c8ad4..e9bb286593 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -743,6 +743,15 @@ def command_info(self, **kwargs) -> None:
     def command_count(self, **kwargs) -> ResponseT:
         return self.execute_command("COMMAND COUNT", **kwargs)
 
+    def command_docs(self, *args):
+        """
+        This function throws a NotImplementedError since it is intentionally
+        not supported.
+        """
+        raise NotImplementedError(
+            "COMMAND DOCS is intentionally not implemented in the client."
+        )
+
     def config_get(self, pattern: PatternT = "*", **kwargs) -> ResponseT:
         """
         Return a dictionary of configuration based on the ``pattern``
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 46303e50ac..f1651203b6 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -4239,6 +4239,11 @@ def test_command_count(self, r):
         assert isinstance(res, int)
         assert res >= 100
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_command_docs(self, r):
+        with pytest.raises(NotImplementedError):
+            r.command_docs("set")
+
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.8.13")
     def test_command_getkeys(self, r):

From f987a0cc86bd37aeaec3d73547c6176b651acd7b Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 7 Mar 2022 01:33:42 +0200
Subject: [PATCH 0419/1164] Add support for EXPIRETIME (#1860)

* add expiretime

* skip test
---
 redis/commands/core.py | 9 +++++++++
 tests/test_commands.py | 6 ++++++
 2 files changed, 15 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index e9bb286593..cdbb2676fb 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1523,6 +1523,15 @@ def expireat(self, name: KeyT, when: AbsExpiryT) -> ResponseT:
             when = int(time.mktime(when.timetuple()))
         return self.execute_command("EXPIREAT", name, when)
 
+    def expiretime(self, key: str) -> int:
+        """
+        Returns the absolute Unix timestamp (since January 1, 1970) in seconds
+        at which the given key will expire.
+
+        For more information check https://redis.io/commands/expiretime
+        """
+        return self.execute_command("EXPIRETIME", key)
+
     def get(self, name: KeyT) -> ResponseT:
         """
         Return the value at key ``name``, or None if the key doesn't exist
diff --git a/tests/test_commands.py b/tests/test_commands.py
index f1651203b6..be60b6ecdb 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1075,6 +1075,12 @@ def test_expireat_unixtime(self, r):
         assert r.expireat("a", expire_at_seconds) is True
         assert 0 < r.ttl("a") <= 61
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_expiretime(self, r):
+        r.set("a", "foo")
+        r.expireat("a", 33177117420)
+        assert r.expiretime("a") == 33177117420
+
     def test_get_and_set(self, r):
         # get and set can't be tested independently of each other
         assert r.get("a") is None

From 1f2259fa3078d38048060a429837fb13f397686e Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 7 Mar 2022 01:33:57 +0200
Subject: [PATCH 0420/1164] Add support for PEXPIRETIME (#1861)

* add pexpiretime

* skip test
---
 redis/commands/core.py | 9 +++++++++
 tests/test_commands.py | 6 ++++++
 2 files changed, 15 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index cdbb2676fb..3595677de6 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1800,6 +1800,15 @@ def pexpireat(self, name: KeyT, when: AbsExpiryT) -> ResponseT:
             when = int(time.mktime(when.timetuple())) * 1000 + ms
         return self.execute_command("PEXPIREAT", name, when)
 
+    def pexpiretime(self, key: str) -> int:
+        """
+        Returns the absolute Unix timestamp (since January 1, 1970) in milliseconds
+        at which the given key will expire.
+
+        For more information check https://redis.io/commands/pexpiretime
+        """
+        return self.execute_command("PEXPIRETIME", key)
+
     def psetex(
         self,
         name: KeyT,
diff --git a/tests/test_commands.py b/tests/test_commands.py
index be60b6ecdb..a73541ef10 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1254,6 +1254,12 @@ def test_pexpireat_unixtime(self, r):
         assert r.pexpireat("a", expire_at_seconds) is True
         assert 0 < r.pttl("a") <= 61000
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_pexpiretime(self, r):
+        r.set("a", "foo")
+        r.pexpireat("a", 33177117420000)
+        assert r.pexpiretime("a") == 33177117420000
+
     @skip_if_server_version_lt("2.6.0")
     def test_psetex(self, r):
         assert r.psetex("a", 1000, "value")

From 5bf9034266e89b9573a4efe2d4bbe56a961409eb Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 8 Mar 2022 09:25:40 +0200
Subject: [PATCH 0421/1164] Add pipeline support for search (#2038)

---
 redis/commands/search/__init__.py | 30 +++++++++++++++++++++++++-----
 redis/commands/search/commands.py | 31 ++++++++++++++++++++-----------
 tests/test_search.py              | 18 ++++++++++++++++++
 3 files changed, 63 insertions(+), 16 deletions(-)

diff --git a/redis/commands/search/__init__.py b/redis/commands/search/__init__.py
index 94bc037c3d..e9763b60a8 100644
--- a/redis/commands/search/__init__.py
+++ b/redis/commands/search/__init__.py
@@ -1,3 +1,5 @@
+import redis
+
 from .commands import SearchCommands
 
 
@@ -17,7 +19,7 @@ def __init__(self, client, chunk_size=1000):
 
             self.client = client
             self.execute_command = client.execute_command
-            self.pipeline = client.pipeline(transaction=False, shard_hint=None)
+            self._pipeline = client.pipeline(transaction=False, shard_hint=None)
             self.total = 0
             self.chunk_size = chunk_size
             self.current_chunk = 0
@@ -42,7 +44,7 @@ def add_document(
             """
             self.client._add_document(
                 doc_id,
-                conn=self.pipeline,
+                conn=self._pipeline,
                 nosave=nosave,
                 score=score,
                 payload=payload,
@@ -67,7 +69,7 @@ def add_document_hash(
             """
             self.client._add_document_hash(
                 doc_id,
-                conn=self.pipeline,
+                conn=self._pipeline,
                 score=score,
                 replace=replace,
             )
@@ -80,7 +82,7 @@ def commit(self):
             """
             Manually commit and flush the batch indexing query
             """
-            self.pipeline.execute()
+            self._pipeline.execute()
             self.current_chunk = 0
 
     def __init__(self, client, index_name="idx"):
@@ -90,7 +92,25 @@ def __init__(self, client, index_name="idx"):
 
         If conn is not None, we employ an already existing redis connection
         """
+        self.MODULE_CALLBACKS = {}
         self.client = client
         self.index_name = index_name
         self.execute_command = client.execute_command
-        self.pipeline = client.pipeline
+        self._pipeline = client.pipeline
+
+    def pipeline(self, transaction=True, shard_hint=None):
+        """Creates a pipeline for the SEARCH module, that can be used for executing
+        SEARCH commands, as well as classic core commands.
+        """
+        p = Pipeline(
+            connection_pool=self.client.connection_pool,
+            response_callbacks=self.MODULE_CALLBACKS,
+            transaction=transaction,
+            shard_hint=shard_hint,
+        )
+        p.index_name = self.index_name
+        return p
+
+
+class Pipeline(SearchCommands, redis.client.Pipeline):
+    """Pipeline for the module."""
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 39c599fbd5..158beec0de 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -2,6 +2,8 @@
 import time
 from typing import Dict, Union
 
+from redis.client import Pipeline
+
 from ..helpers import parse_to_dict
 from ._util import to_string
 from .aggregation import AggregateRequest, AggregateResult, Cursor
@@ -186,8 +188,6 @@ def _add_document(
         """
         Internal add_document used for both batch and single doc indexing
         """
-        if conn is None:
-            conn = self.client
 
         if partial or no_create:
             replace = True
@@ -208,7 +208,11 @@ def _add_document(
             args += ["LANGUAGE", language]
         args.append("FIELDS")
         args += list(itertools.chain(*fields.items()))
-        return conn.execute_command(*args)
+
+        if conn is not None:
+            return conn.execute_command(*args)
+
+        return self.execute_command(*args)
 
     def _add_document_hash(
         self,
@@ -221,8 +225,6 @@ def _add_document_hash(
         """
         Internal add_document_hash used for both batch and single doc indexing
         """
-        if conn is None:
-            conn = self.client
 
         args = [ADDHASH_CMD, self.index_name, doc_id, score]
 
@@ -232,7 +234,10 @@ def _add_document_hash(
         if language:
             args += ["LANGUAGE", language]
 
-        return conn.execute_command(*args)
+        if conn is not None:
+            return conn.execute_command(*args)
+
+        return self.execute_command(*args)
 
     def add_document(
         self,
@@ -331,12 +336,13 @@ def delete_document(self, doc_id, conn=None, delete_actual_document=False):
         For more information: https://oss.redis.com/redisearch/Commands/#ftdel
         """  # noqa
         args = [DEL_CMD, self.index_name, doc_id]
-        if conn is None:
-            conn = self.client
         if delete_actual_document:
             args.append("DD")
 
-        return conn.execute_command(*args)
+        if conn is not None:
+            return conn.execute_command(*args)
+
+        return self.execute_command(*args)
 
     def load_document(self, id):
         """
@@ -364,7 +370,7 @@ def get(self, *ids):
         For more information https://oss.redis.com/redisearch/Commands/#ftget
         """
 
-        return self.client.execute_command(MGET_CMD, self.index_name, *ids)
+        return self.execute_command(MGET_CMD, self.index_name, *ids)
 
     def info(self):
         """
@@ -374,7 +380,7 @@ def info(self):
         For more information https://oss.redis.com/redisearch/Commands/#ftinfo
         """
 
-        res = self.client.execute_command(INFO_CMD, self.index_name)
+        res = self.execute_command(INFO_CMD, self.index_name)
         it = map(to_string, res)
         return dict(zip(it, it))
 
@@ -423,6 +429,9 @@ def search(
         st = time.time()
         res = self.execute_command(SEARCH_CMD, *args)
 
+        if isinstance(res, Pipeline):
+            return res
+
         return Result(
             res,
             not query._no_content,
diff --git a/tests/test_search.py b/tests/test_search.py
index 5eb8e9762a..67f4357b4f 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1577,3 +1577,21 @@ def test_geo_params(modclient):
     assert "doc1" == res.docs[0].id
     assert "doc2" == res.docs[1].id
     assert "doc3" == res.docs[2].id
+
+
+@pytest.mark.redismod
+def test_search_commands_in_pipeline(client):
+    p = client.ft().pipeline()
+    p.create_index((TextField("txt"),))
+    p.add_document("doc1", payload="foo baz", txt="foo bar")
+    p.add_document("doc2", txt="foo bar")
+    q = Query("foo bar").with_payloads()
+    p.search(q)
+    res = p.execute()
+    assert res[:3] == ["OK", "OK", "OK"]
+    assert 2 == res[3][0]
+    assert "doc1" == res[3][1]
+    assert "doc2" == res[3][4]
+    assert "foo baz" == res[3][2]
+    assert res[3][5] is None
+    assert res[3][3] == res[3][6] == ["txt", "foo bar"]

From 6df00190f386f50c5ac5c0b34f30c547dfd40b5c Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 8 Mar 2022 10:34:23 +0200
Subject: [PATCH 0422/1164] v4.2.0rc2 (#2037)

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 7109ed45c7..8a483095b0 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.2.0rc1",
+    version="4.2.0rc2",
     packages=find_packages(
         include=[
             "redis",

From 8d949a3f39bc6fe17ee90009e78f17b32f69899a Mon Sep 17 00:00:00 2001
From: Kolja Lampe <razzeee@gmail.com>
Date: Thu, 10 Mar 2022 09:02:40 +0100
Subject: [PATCH 0423/1164] Fix typo (#2043)

---
 redis/commands/search/commands.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 158beec0de..a63868f98a 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -470,7 +470,7 @@ def aggregate(
         An `AggregateResult` object is returned. You can access the rows from
         its `rows` property, which will always yield the rows of the result.
 
-        Fpr more information: https://oss.redis.com/redisearch/Commands/#ftaggregate
+        For more information: https://oss.redis.com/redisearch/Commands/#ftaggregate
         """  # noqa
         if isinstance(query, AggregateRequest):
             has_cursor = bool(query._cursor)

From 9376ed82cd8b8296f5585eb96d137e54b56d723d Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 14 Mar 2022 13:43:05 +0200
Subject: [PATCH 0424/1164] Add support for CLUSTER ADDSLOTSRANGE (#2017)

* add cluster addslotsrange

* Add support for CLUSTER ADDSLOTSRANGE

* docstring

* fix test

* skip test

* linters
---
 redis/client.py           |  1 +
 redis/cluster.py          |  1 +
 redis/commands/cluster.py | 16 ++++++++++++++++
 tests/test_cluster.py     |  6 ++++++
 4 files changed, 24 insertions(+)

diff --git a/redis/client.py b/redis/client.py
index b12ad578d6..465bb5f2fd 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -710,6 +710,7 @@ class AbstractRedis:
         "CLIENT GETREDIR": int,
         "CLIENT TRACKINGINFO": lambda r: list(map(str_if_bytes, r)),
         "CLUSTER ADDSLOTS": bool_ok,
+        "CLUSTER ADDSLOTSRANGE": bool_ok,
         "CLUSTER COUNT-FAILURE-REPORTS": lambda x: int(x),
         "CLUSTER COUNTKEYSINSLOT": lambda x: int(x),
         "CLUSTER DELSLOTS": bool_ok,
diff --git a/redis/cluster.py b/redis/cluster.py
index 8c2dfc271b..b6e2ab2581 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -320,6 +320,7 @@ class RedisCluster(RedisClusterCommands):
 
     CLUSTER_COMMANDS_RESPONSE_CALLBACKS = {
         "CLUSTER ADDSLOTS": bool,
+        "CLUSTER ADDSLOTSRANGE": bool,
         "CLUSTER COUNT-FAILURE-REPORTS": int,
         "CLUSTER COUNTKEYSINSLOT": int,
         "CLUSTER DELSLOTS": bool,
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index e14b6e35ee..3d42317e2d 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -248,6 +248,22 @@ def cluster_addslots(self, target_node, *slots):
             "CLUSTER ADDSLOTS", *slots, target_nodes=target_node
         )
 
+    def cluster_addslotsrange(self, target_node, *slots):
+        """
+        Similar to the CLUSTER ADDSLOTS command.
+        The difference between the two commands is that ADDSLOTS takes a list of slots
+        to assign to the node, while ADDSLOTSRANGE takes a list of slot ranges
+        (specified by start and end slots) to assign to the node.
+
+        :target_node: 'ClusterNode'
+            The node to execute the command on
+
+        For more information check https://redis.io/commands/cluster-addslotsrange
+        """
+        return self.execute_command(
+            "CLUSTER ADDSLOTSRANGE", *slots, target_nodes=target_node
+        )
+
     def cluster_countkeysinslot(self, slot_id):
         """
         Return the number of local keys in the specified hash slot
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index ab98ed515d..aa28b2a555 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -853,6 +853,12 @@ def test_cluster_addslots(self, r):
         mock_node_resp(node, "OK")
         assert r.cluster_addslots(node, 1, 2, 3) is True
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_cluster_addslotsrange(self, r):
+        node = r.get_random_node()
+        mock_node_resp(node, "OK")
+        assert r.cluster_addslotsrange(node, 1, 5)
+
     def test_cluster_countkeysinslot(self, r):
         node = r.nodes_manager.get_node_from_slot(1)
         mock_node_resp(node, 2)

From 5d5f8923e48f7fe2d30959db50cc9bcfc953578b Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 14 Mar 2022 13:43:36 +0200
Subject: [PATCH 0425/1164] Add support for CLUSTER DELSLOTSRANGE (#2018)

* delslotsrange

* test

* linters

* skip test

* linters
---
 redis/client.py           |  1 +
 redis/cluster.py          |  2 ++
 redis/commands/cluster.py | 11 +++++++++++
 tests/test_cluster.py     |  7 +++++++
 4 files changed, 21 insertions(+)

diff --git a/redis/client.py b/redis/client.py
index 465bb5f2fd..de0180c191 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -714,6 +714,7 @@ class AbstractRedis:
         "CLUSTER COUNT-FAILURE-REPORTS": lambda x: int(x),
         "CLUSTER COUNTKEYSINSLOT": lambda x: int(x),
         "CLUSTER DELSLOTS": bool_ok,
+        "CLUSTER DELSLOTSRANGE": bool_ok,
         "CLUSTER FAILOVER": bool_ok,
         "CLUSTER FORGET": bool_ok,
         "CLUSTER INFO": parse_cluster_info,
diff --git a/redis/cluster.py b/redis/cluster.py
index b6e2ab2581..cfec4fc94f 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -311,6 +311,7 @@ class RedisCluster(RedisClusterCommands):
             [
                 "CLUSTER COUNTKEYSINSLOT",
                 "CLUSTER DELSLOTS",
+                "CLUSTER DELSLOTSRANGE",
                 "CLUSTER GETKEYSINSLOT",
                 "CLUSTER SETSLOT",
             ],
@@ -324,6 +325,7 @@ class RedisCluster(RedisClusterCommands):
         "CLUSTER COUNT-FAILURE-REPORTS": int,
         "CLUSTER COUNTKEYSINSLOT": int,
         "CLUSTER DELSLOTS": bool,
+        "CLUSTER DELSLOTSRANGE": bool,
         "CLUSTER FAILOVER": bool,
         "CLUSTER FORGET": bool,
         "CLUSTER GETKEYSINSLOT": list,
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index 3d42317e2d..4182726ba3 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -287,6 +287,17 @@ def cluster_delslots(self, *slots):
         """
         return [self.execute_command("CLUSTER DELSLOTS", slot) for slot in slots]
 
+    def cluster_delslotsrange(self, *slots):
+        """
+        Similar to the CLUSTER DELSLOTS command.
+        The difference is that CLUSTER DELSLOTS takes a list of hash slots to remove
+        from the node, while CLUSTER DELSLOTSRANGE takes a list of slot ranges to remove
+        from the node.
+
+        For more information check https://redis.io/commands/cluster-delslotsrange
+        """
+        return self.execute_command("CLUSTER DELSLOTSRANGE", *slots)
+
     def cluster_failover(self, target_node, option=None):
         """
         Forces a slave to perform a manual failover of its master
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index aa28b2a555..43e5632759 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -891,6 +891,13 @@ def test_cluster_delslots(self):
         assert node0.redis_connection.connection.read_response.called
         assert node1.redis_connection.connection.read_response.called
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_cluster_delslotsrange(self, r):
+        node = r.get_random_node()
+        mock_node_resp(node, "OK")
+        r.cluster_addslots(node, 1, 2, 3, 4, 5)
+        assert r.cluster_delslotsrange(1, 5)
+
     def test_cluster_failover(self, r):
         node = r.get_random_node()
         mock_node_resp(node, "OK")

From a6a003c1b04635b5c40616faf451a09c5bc6372d Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 14 Mar 2022 13:44:25 +0200
Subject: [PATCH 0426/1164] Add support for CLUSTER LINKS (#2019)

* cluster links

* docstring

* skip test

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/commands/cluster.py | 12 ++++++++++++
 tests/test_cluster.py     | 11 +++++++++++
 2 files changed, 23 insertions(+)

diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index 4182726ba3..d68f93bcac 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -427,6 +427,18 @@ def cluster_slots(self, target_nodes=None):
         """
         return self.execute_command("CLUSTER SLOTS", target_nodes=target_nodes)
 
+    def cluster_links(self, target_node):
+        """
+        Each node in a Redis Cluster maintains a pair of long-lived TCP link with each
+        peer in the cluster: One for sending outbound messages towards the peer and one
+        for receiving inbound messages from the peer.
+
+        This command outputs information of all such peer links as an array.
+
+        For more information check https://redis.io/commands/cluster-links
+        """
+        return self.execute_command("CLUSTER LINKS", target_nodes=target_node)
+
     def readonly(self, target_nodes=None):
         """
         Enables read queries.
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 43e5632759..e9242e008e 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -1029,6 +1029,17 @@ def test_cluster_replicas(self, r):
             == "r4xfga22229cf3c652b6fca0d09ff69f3e0d4d"
         )
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_cluster_links(self, r):
+        node = r.get_random_node()
+        res = r.cluster_links(node)
+        links_to = sum(x.count("to") for x in res)
+        links_for = sum(x.count("from") for x in res)
+        assert links_to == links_for
+        print(res)
+        for i in range(0, len(res) - 1, 2):
+            assert res[i][3] == res[i + 1][3]
+
     def test_readonly(self):
         r = get_mocked_redis_client(host=default_host, port=default_port)
         mock_all_nodes_resp(r, "OK")

From dd1157daf0c3be18848d1ff96fdad2a10feb1c82 Mon Sep 17 00:00:00 2001
From: ondrej <ondrej.dolejsi@gmail.com>
Date: Mon, 14 Mar 2022 12:47:10 +0100
Subject: [PATCH 0427/1164] Update sentinel.py (#2045)

Fixed a typo in word 'sentinel'
---
 redis/commands/sentinel.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/commands/sentinel.py b/redis/commands/sentinel.py
index e054ec6a38..f745757955 100644
--- a/redis/commands/sentinel.py
+++ b/redis/commands/sentinel.py
@@ -3,7 +3,7 @@
 
 class SentinelCommands:
     """
-    A class containing the commands specific to redis sentinal. This class is
+    A class containing the commands specific to redis sentinel. This class is
     to be used as a mixin.
     """
 

From 934c6891c221157985743db76a2c9edb93ef45d6 Mon Sep 17 00:00:00 2001
From: Lazaros Toumanidis <lazToum@users.noreply.github.com>
Date: Mon, 14 Mar 2022 13:47:27 +0200
Subject: [PATCH 0428/1164] redis_connect_func (#2046)

---
 redis/asyncio/connection.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index ae54d8147a..77fe95f25c 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -1128,6 +1128,7 @@ def __init__(
         health_check_interval: float = 0.0,
         client_name: str = None,
         retry: Optional[Retry] = None,
+        redis_connect_func=None,
     ):
         """
         Initialize a new UnixDomainSocketConnection.
@@ -1153,6 +1154,7 @@ def __init__(
             self.retry = Retry(NoBackoff(), 0)
         self.health_check_interval = health_check_interval
         self.next_health_check = -1
+        self.redis_connect_func = redis_connect_func
         self.encoder = Encoder(encoding, encoding_errors, decode_responses)
         self._sock = None
         self._reader = None

From a081173b650dd73fca06d419156ab525bc1c2200 Mon Sep 17 00:00:00 2001
From: Alon Diamant <diamant.alon@gmail.com>
Date: Mon, 14 Mar 2022 13:52:51 +0200
Subject: [PATCH 0429/1164] Fix: avoiding issue with
 PytestUnraisableExceptionWarning (#1458)

* Fix: avoiding issue with PytestUnraisableExceptionWarning that is raised because of __del__() calling self.close() in Redis class, as the self.connection attribute was not set due to early failure in the Redis() constructor. Example: calling redis.StrictRedis(**connectionInfo) in a constructor, with connectionInfo={'hog':'cat'}

* linters

* linters

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/client.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/redis/client.py b/redis/client.py
index de0180c191..c51ab9168d 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1151,6 +1151,12 @@ def __del__(self):
         self.close()
 
     def close(self):
+        # In case a connection property does not yet exist
+        # (due to a crash earlier in the Redis() constructor), return
+        # immediately as there is nothing to clean-up.
+        if not hasattr(self, "connection"):
+            return
+
         conn = self.connection
         if conn:
             self.connection = None

From a12b5fd5e9af55e4668c78b50388c4ffb73fdda0 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 14 Mar 2022 14:43:37 +0200
Subject: [PATCH 0430/1164] Add support to use certificates from string in ssl
 connection (#2048)

* ssl string cert

* fix async test

* linters

* change test name
---
 redis/asyncio/client.py     |  2 ++
 redis/asyncio/connection.py | 13 +++++++++++--
 redis/client.py             |  2 ++
 redis/cluster.py            |  1 +
 redis/connection.py         | 13 +++++++++++--
 tests/test_ssl.py           | 16 ++++++++++++++++
 6 files changed, 43 insertions(+), 4 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 2afad0f4d1..bbf2a676ed 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -163,6 +163,7 @@ def __init__(
         ssl_certfile: Optional[str] = None,
         ssl_cert_reqs: str = "required",
         ssl_ca_certs: Optional[str] = None,
+        ssl_ca_data: Optional[str] = None,
         ssl_check_hostname: bool = False,
         max_connections: Optional[int] = None,
         single_connection_client: bool = False,
@@ -228,6 +229,7 @@ def __init__(
                             "ssl_certfile": ssl_certfile,
                             "ssl_cert_reqs": ssl_cert_reqs,
                             "ssl_ca_certs": ssl_ca_certs,
+                            "ssl_ca_data": ssl_ca_data,
                             "ssl_check_hostname": ssl_check_hostname,
                         }
                     )
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 77fe95f25c..0c5398568e 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -1026,6 +1026,7 @@ def __init__(
         ssl_certfile: Optional[str] = None,
         ssl_cert_reqs: str = "required",
         ssl_ca_certs: Optional[str] = None,
+        ssl_ca_data: Optional[str] = None,
         ssl_check_hostname: bool = False,
         **kwargs,
     ):
@@ -1035,6 +1036,7 @@ def __init__(
             certfile=ssl_certfile,
             cert_reqs=ssl_cert_reqs,
             ca_certs=ssl_ca_certs,
+            ca_data=ssl_ca_data,
             check_hostname=ssl_check_hostname,
         )
 
@@ -1054,6 +1056,10 @@ def cert_reqs(self):
     def ca_certs(self):
         return self.ssl_context.ca_certs
 
+    @property
+    def ca_data(self):
+        return self.ssl_context.ca_data
+
     @property
     def check_hostname(self):
         return self.ssl_context.check_hostname
@@ -1065,6 +1071,7 @@ class RedisSSLContext:
         "certfile",
         "cert_reqs",
         "ca_certs",
+        "ca_data",
         "context",
         "check_hostname",
     )
@@ -1075,6 +1082,7 @@ def __init__(
         certfile: Optional[str] = None,
         cert_reqs: Optional[str] = None,
         ca_certs: Optional[str] = None,
+        ca_data: Optional[str] = None,
         check_hostname: bool = False,
     ):
         self.keyfile = keyfile
@@ -1093,6 +1101,7 @@ def __init__(
                 )
             self.cert_reqs = CERT_REQS[cert_reqs]
         self.ca_certs = ca_certs
+        self.ca_data = ca_data
         self.check_hostname = check_hostname
         self.context: Optional[ssl.SSLContext] = None
 
@@ -1103,8 +1112,8 @@ def get(self) -> ssl.SSLContext:
             context.verify_mode = self.cert_reqs
             if self.certfile and self.keyfile:
                 context.load_cert_chain(certfile=self.certfile, keyfile=self.keyfile)
-            if self.ca_certs:
-                context.load_verify_locations(self.ca_certs)
+            if self.ca_certs or self.ca_data:
+                context.load_verify_locations(cafile=self.ca_certs, cadata=self.ca_data)
             self.context = context
         return self.context
 
diff --git a/redis/client.py b/redis/client.py
index c51ab9168d..8c17665dbc 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -885,6 +885,7 @@ def __init__(
         ssl_cert_reqs="required",
         ssl_ca_certs=None,
         ssl_ca_path=None,
+        ssl_ca_data=None,
         ssl_check_hostname=False,
         ssl_password=None,
         ssl_validate_ocsp=False,
@@ -966,6 +967,7 @@ def __init__(
                             "ssl_certfile": ssl_certfile,
                             "ssl_cert_reqs": ssl_cert_reqs,
                             "ssl_ca_certs": ssl_ca_certs,
+                            "ssl_ca_data": ssl_ca_data,
                             "ssl_check_hostname": ssl_check_hostname,
                             "ssl_password": ssl_password,
                             "ssl_ca_path": ssl_ca_path,
diff --git a/redis/cluster.py b/redis/cluster.py
index cfec4fc94f..87643a71b0 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -116,6 +116,7 @@ def fix_server(*args):
     "socket_timeout",
     "ssl",
     "ssl_ca_certs",
+    "ssl_ca_data",
     "ssl_certfile",
     "ssl_cert_reqs",
     "ssl_keyfile",
diff --git a/redis/connection.py b/redis/connection.py
index 8a77e4bdee..0f97361e6e 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -923,6 +923,7 @@ def __init__(
         ssl_certfile=None,
         ssl_cert_reqs="required",
         ssl_ca_certs=None,
+        ssl_ca_data=None,
         ssl_check_hostname=False,
         ssl_ca_path=None,
         ssl_password=None,
@@ -939,6 +940,7 @@ def __init__(
             ssl_certfile: Path to an ssl certificate. Defaults to None.
             ssl_cert_reqs: The string value for the SSLContext.verify_mode (none, optional, required). Defaults to "required".
             ssl_ca_certs: The path to a file of concatenated CA certificates in PEM format. Defaults to None.
+            ssl_ca_data: Either an ASCII string of one or more PEM-encoded certificates or a bytes-like object of DER-encoded certificates.
             ssl_check_hostname: If set, match the hostname during the SSL handshake. Defaults to False.
             ssl_ca_path: The path to a directory containing several CA certificates in PEM format. Defaults to None.
             ssl_password: Password for unlocking an encrypted private key. Defaults to None.
@@ -973,6 +975,7 @@ def __init__(
             ssl_cert_reqs = CERT_REQS[ssl_cert_reqs]
         self.cert_reqs = ssl_cert_reqs
         self.ca_certs = ssl_ca_certs
+        self.ca_data = ssl_ca_data
         self.ca_path = ssl_ca_path
         self.check_hostname = ssl_check_hostname
         self.certificate_password = ssl_password
@@ -993,8 +996,14 @@ def _connect(self):
                 keyfile=self.keyfile,
                 password=self.certificate_password,
             )
-        if self.ca_certs is not None or self.ca_path is not None:
-            context.load_verify_locations(cafile=self.ca_certs, capath=self.ca_path)
+        if (
+            self.ca_certs is not None
+            or self.ca_path is not None
+            or self.ca_data is not None
+        ):
+            context.load_verify_locations(
+                cafile=self.ca_certs, capath=self.ca_path, cadata=self.ca_data
+            )
         sslsock = context.wrap_socket(sock, server_hostname=self.host)
         if self.ssl_validate_ocsp is True and CRYPTOGRAPHY_AVAILABLE is False:
             raise RedisError("cryptography is not installed.")
diff --git a/tests/test_ssl.py b/tests/test_ssl.py
index ab5d47f293..d029b80dcb 100644
--- a/tests/test_ssl.py
+++ b/tests/test_ssl.py
@@ -67,6 +67,22 @@ def test_validating_self_signed_certificate(self, request):
         )
         assert r.ping()
 
+    def test_validating_self_signed_string_certificate(self, request):
+        f = open(self.SERVER_CERT)
+        cert_data = f.read()
+        ssl_url = request.config.option.redis_ssl_url
+        p = urlparse(ssl_url)[1].split(":")
+        r = redis.Redis(
+            host=p[0],
+            port=p[1],
+            ssl=True,
+            ssl_certfile=self.SERVER_CERT,
+            ssl_keyfile=self.SERVER_KEY,
+            ssl_cert_reqs="required",
+            ssl_ca_data=cert_data,
+        )
+        assert r.ping()
+
     def _create_oscp_conn(self, request):
         ssl_url = request.config.option.redis_ssl_url
         p = urlparse(ssl_url)[1].split(":")

From 2c405855021ccc8d4a45fa1aae352ddb303baae0 Mon Sep 17 00:00:00 2001
From: dogukanteber <47397379+dogukanteber@users.noreply.github.com>
Date: Mon, 14 Mar 2022 16:02:46 +0300
Subject: [PATCH 0431/1164] Add support for EXPIRE command's options (#2002)

* Add support for EXPIRE command's options

* Add requested changes

* Change method arguments

* add variables to the function header

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: dvora-h <dvora.heller@redis.com>
---
 redis/commands/core.py | 34 ++++++++++++++++++++++++++++++----
 tests/test_commands.py | 25 +++++++++++++++++++++++++
 2 files changed, 55 insertions(+), 4 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 3595677de6..108da1b2e6 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1501,16 +1501,42 @@ def exists(self, *names: KeyT) -> ResponseT:
 
     __contains__ = exists
 
-    def expire(self, name: KeyT, time: ExpiryT) -> ResponseT:
+    def expire(
+        self,
+        name: KeyT,
+        time: ExpiryT,
+        nx: bool = False,
+        xx: bool = False,
+        gt: bool = False,
+        lt: bool = False,
+    ) -> ResponseT:
         """
-        Set an expire flag on key ``name`` for ``time`` seconds. ``time``
-        can be represented by an integer or a Python timedelta object.
+        Set an expire flag on key ``name`` for ``time`` seconds with given
+        ``option``. ``time`` can be represented by an integer or a Python timedelta
+        object.
+
+        Valid options are:
+            NX -> Set expiry only when the key has no expiry
+            XX -> Set expiry only when the key has an existing expiry
+            GT -> Set expiry only when the new expiry is greater than current one
+            LT -> Set expiry only when the new expiry is less than current one
 
         For more information check https://redis.io/commands/expire
         """
         if isinstance(time, datetime.timedelta):
             time = int(time.total_seconds())
-        return self.execute_command("EXPIRE", name, time)
+
+        exp_option = list()
+        if nx:
+            exp_option.append("NX")
+        if xx:
+            exp_option.append("XX")
+        if gt:
+            exp_option.append("GT")
+        if lt:
+            exp_option.append("LT")
+
+        return self.execute_command("EXPIRE", name, time, *exp_option)
 
     def expireat(self, name: KeyT, when: AbsExpiryT) -> ResponseT:
         """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index a73541ef10..c8bcc9cb54 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1058,6 +1058,31 @@ def test_expire(self, r):
         assert r.persist("a")
         assert r.ttl("a") == -1
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_expire_option_nx(self, r):
+        r.set("key", "val")
+        assert r.expire("key", 100, nx=True) == 1
+        assert r.expire("key", 500, nx=True) == 0
+
+    @skip_if_server_version_lt("7.0.0")
+    def test_expire_option_xx(self, r):
+        r.set("key", "val")
+        assert r.expire("key", 100, xx=True) == 0
+        assert r.expire("key", 100)
+        assert r.expire("key", 500, nx=True) == 1
+
+    @skip_if_server_version_lt("7.0.0")
+    def test_expire_option_gt(self, r):
+        r.set("key", "val", 100)
+        assert r.expire("key", 50, gt=True) == 0
+        assert r.expire("key", 500, gt=True) == 1
+
+    @skip_if_server_version_lt("7.0.0")
+    def test_expire_option_lt(self, r):
+        r.set("key", "val", 100)
+        assert r.expire("key", 50, lt=True) == 1
+        assert r.expire("key", 150, lt=True) == 0
+
     def test_expireat_datetime(self, r):
         expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
         r["a"] = "foo"

From eac3a34d162aa83c3094cbab80d535ca92fdf972 Mon Sep 17 00:00:00 2001
From: dogukanteber <47397379+dogukanteber@users.noreply.github.com>
Date: Mon, 14 Mar 2022 16:03:06 +0300
Subject: [PATCH 0432/1164] Add support for EXPIREAT command's options (#2024)

* Add support for EXPIREAT command's options

* Fix linter errors

* Make changes on method arguments

* Fix linter errors

* add variables to the function header

Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: dvora-h <dvora.heller@redis.com>
---
 redis/commands/core.py | 34 ++++++++++++++++++++++++++++++----
 tests/test_commands.py | 37 +++++++++++++++++++++++++++++++++++++
 2 files changed, 67 insertions(+), 4 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 108da1b2e6..5b6d42bdd0 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1538,16 +1538,42 @@ def expire(
 
         return self.execute_command("EXPIRE", name, time, *exp_option)
 
-    def expireat(self, name: KeyT, when: AbsExpiryT) -> ResponseT:
+    def expireat(
+        self,
+        name: KeyT,
+        when: AbsExpiryT,
+        nx: bool = False,
+        xx: bool = False,
+        gt: bool = False,
+        lt: bool = False,
+    ) -> ResponseT:
         """
-        Set an expire flag on key ``name``. ``when`` can be represented
-        as an integer indicating unix time or a Python datetime object.
+        Set an expire flag on key ``name`` with given ``option``. ``when``
+        can be represented as an integer indicating unix time or a Python
+        datetime object.
+
+        Valid options are:
+            -> NX -- Set expiry only when the key has no expiry
+            -> XX -- Set expiry only when the key has an existing expiry
+            -> GT -- Set expiry only when the new expiry is greater than current one
+            -> LT -- Set expiry only when the new expiry is less than current one
 
         For more information check https://redis.io/commands/expireat
         """
         if isinstance(when, datetime.datetime):
             when = int(time.mktime(when.timetuple()))
-        return self.execute_command("EXPIREAT", name, when)
+
+        exp_option = list()
+        if nx:
+            exp_option.append("NX")
+        if xx:
+            exp_option.append("XX")
+        if gt:
+            exp_option.append("GT")
+        if lt:
+            exp_option.append("LT")
+
+        return self.execute_command("EXPIREAT", name, when, *exp_option)
 
     def expiretime(self, key: str) -> int:
         """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index c8bcc9cb54..ae1adb1eb2 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1106,6 +1106,43 @@ def test_expiretime(self, r):
         r.expireat("a", 33177117420)
         assert r.expiretime("a") == 33177117420
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_expireat_option_nx(self, r):
+        assert r.set("key", "val") is True
+        expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
+        assert r.expireat("key", expire_at, nx=True) is True
+        expire_at = redis_server_time(r) + datetime.timedelta(minutes=2)
+        assert r.expireat("key", expire_at, nx=True) is False
+
+    @skip_if_server_version_lt("7.0.0")
+    def test_expireat_option_xx(self, r):
+        assert r.set("key", "val") is True
+        expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
+        assert r.expireat("key", expire_at, xx=True) is False
+        assert r.expireat("key", expire_at) is True
+        expire_at = redis_server_time(r) + datetime.timedelta(minutes=2)
+        assert r.expireat("key", expire_at, xx=True) is True
+
+    @skip_if_server_version_lt("7.0.0")
+    def test_expireat_option_gt(self, r):
+        expire_at = redis_server_time(r) + datetime.timedelta(minutes=2)
+        assert r.set("key", "val") is True
+        assert r.expireat("key", expire_at) is True
+        expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
+        assert r.expireat("key", expire_at, gt=True) is False
+        expire_at = redis_server_time(r) + datetime.timedelta(minutes=3)
+        assert r.expireat("key", expire_at, gt=True) is True
+
+    @skip_if_server_version_lt("7.0.0")
+    def test_expireat_option_lt(self, r):
+        expire_at = redis_server_time(r) + datetime.timedelta(minutes=2)
+        assert r.set("key", "val") is True
+        assert r.expireat("key", expire_at) is True
+        expire_at = redis_server_time(r) + datetime.timedelta(minutes=3)
+        assert r.expireat("key", expire_at, lt=True) is False
+        expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
+        assert r.expireat("key", expire_at, lt=True) is True
+
     def test_get_and_set(self, r):
         # get and set can't be tested independently of each other
         assert r.get("a") is None

From f43c3e08ab0facf5a2d70bcd91365faf74d7e220 Mon Sep 17 00:00:00 2001
From: dogukanteber <47397379+dogukanteber@users.noreply.github.com>
Date: Mon, 14 Mar 2022 16:03:28 +0300
Subject: [PATCH 0433/1164] Add support for PEXPIRE command's option (#2026)

* Add support for PEXPIRE command's option

* Alter method arguments

* add variables to the function header

Co-authored-by: dvora-h <dvora.heller@redis.com>
---
 redis/commands/core.py | 34 +++++++++++++++++++++++++++++-----
 tests/test_commands.py | 27 +++++++++++++++++++++++++++
 2 files changed, 56 insertions(+), 5 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 5b6d42bdd0..7e3514e3da 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1827,17 +1827,41 @@ def persist(self, name: KeyT) -> ResponseT:
         """
         return self.execute_command("PERSIST", name)
 
-    def pexpire(self, name: KeyT, time: ExpiryT) -> ResponseT:
+    def pexpire(
+        self,
+        name: KeyT,
+        time: ExpiryT,
+        nx: bool = False,
+        xx: bool = False,
+        gt: bool = False,
+        lt: bool = False,
+    ) -> ResponseT:
         """
-        Set an expire flag on key ``name`` for ``time`` milliseconds.
-        ``time`` can be represented by an integer or a Python timedelta
-        object.
+        Set an expire flag on key ``name`` for ``time`` milliseconds
+        with given ``option``. ``time`` can be represented by an
+        integer or a Python timedelta object.
+
+        Valid options are:
+            NX -> Set expiry only when the key has no expiry
+            XX -> Set expiry only when the key has an existing expiry
+            GT -> Set expiry only when the new expiry is greater than current one
+            LT -> Set expiry only when the new expiry is less than current one
 
         For more information check https://redis.io/commands/pexpire
         """
         if isinstance(time, datetime.timedelta):
             time = int(time.total_seconds() * 1000)
-        return self.execute_command("PEXPIRE", name, time)
+
+        exp_option = list()
+        if nx:
+            exp_option.append("NX")
+        if xx:
+            exp_option.append("XX")
+        if gt:
+            exp_option.append("GT")
+        if lt:
+            exp_option.append("LT")
+        return self.execute_command("PEXPIRE", name, time, *exp_option)
 
     def pexpireat(self, name: KeyT, when: AbsExpiryT) -> ResponseT:
         """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index ae1adb1eb2..2aa5a9608e 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1296,6 +1296,33 @@ def test_pexpire(self, r):
         assert r.persist("a")
         assert r.pttl("a") == -1
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_pexpire_option_nx(self, r):
+        assert r.set("key", "val") is True
+        assert r.pexpire("key", 60000, nx=True) is True
+        assert r.pexpire("key", 60000, nx=True) is False
+
+    @skip_if_server_version_lt("7.0.0")
+    def test_pexpire_option_xx(self, r):
+        assert r.set("key", "val") is True
+        assert r.pexpire("key", 60000, xx=True) is False
+        assert r.pexpire("key", 60000) is True
+        assert r.pexpire("key", 70000, xx=True) is True
+
+    @skip_if_server_version_lt("7.0.0")
+    def test_pexpire_option_gt(self, r):
+        assert r.set("key", "val") is True
+        assert r.pexpire("key", 60000) is True
+        assert r.pexpire("key", 70000, gt=True) is True
+        assert r.pexpire("key", 50000, gt=True) is False
+
+    @skip_if_server_version_lt("7.0.0")
+    def test_pexpire_option_lt(self, r):
+        assert r.set("key", "val") is True
+        assert r.pexpire("key", 60000) is True
+        assert r.pexpire("key", 50000, lt=True) is True
+        assert r.pexpire("key", 70000, lt=True) is False
+
     @skip_if_server_version_lt("2.6.0")
     def test_pexpireat_datetime(self, r):
         expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)

From fdf4f1adb9e2636a04343a3bfade2abac6877197 Mon Sep 17 00:00:00 2001
From: dogukanteber <47397379+dogukanteber@users.noreply.github.com>
Date: Mon, 14 Mar 2022 16:03:40 +0300
Subject: [PATCH 0434/1164] Add support for PEXPIREAT's options (#2027)

* Add support for PEXPIREAT's options

* add variables to the function header.

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
Co-authored-by: dvora-h <dvora.heller@redis.com>
---
 redis/commands/core.py | 33 ++++++++++++++++++++++++++++-----
 tests/test_commands.py | 35 +++++++++++++++++++++++++++++++++++
 2 files changed, 63 insertions(+), 5 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 7e3514e3da..56d6fa97ed 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1863,18 +1863,41 @@ def pexpire(
             exp_option.append("LT")
         return self.execute_command("PEXPIRE", name, time, *exp_option)
 
-    def pexpireat(self, name: KeyT, when: AbsExpiryT) -> ResponseT:
+    def pexpireat(
+        self,
+        name: KeyT,
+        when: AbsExpiryT,
+        nx: bool = False,
+        xx: bool = False,
+        gt: bool = False,
+        lt: bool = False,
+    ) -> ResponseT:
         """
-        Set an expire flag on key ``name``. ``when`` can be represented
-        as an integer representing unix time in milliseconds (unix time * 1000)
-        or a Python datetime object.
+        Set an expire flag on key ``name`` with given ``option``. ``when``
+        can be represented as an integer representing unix time in
+        milliseconds (unix time * 1000) or a Python datetime object.
+
+        Valid options are:
+            NX -> Set expiry only when the key has no expiry
+            XX -> Set expiry only when the key has an existing expiry
+            GT -> Set expiry only when the new expiry is greater than current one
+            LT -> Set expiry only when the new expiry is less than current one
 
         For more information check https://redis.io/commands/pexpireat
         """
         if isinstance(when, datetime.datetime):
             ms = int(when.microsecond / 1000)
             when = int(time.mktime(when.timetuple())) * 1000 + ms
-        return self.execute_command("PEXPIREAT", name, when)
+        exp_option = list()
+        if nx:
+            exp_option.append("NX")
+        if xx:
+            exp_option.append("XX")
+        if gt:
+            exp_option.append("GT")
+        if lt:
+            exp_option.append("LT")
+        return self.execute_command("PEXPIREAT", name, when, *exp_option)
 
     def pexpiretime(self, key: str) -> int:
         """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 2aa5a9608e..2c1ebe64a1 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1343,6 +1343,41 @@ def test_pexpireat_unixtime(self, r):
         assert r.pexpireat("a", expire_at_seconds) is True
         assert 0 < r.pttl("a") <= 61000
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_pexpireat_option_nx(self, r):
+        assert r.set("key", "val") is True
+        expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
+        assert r.pexpireat("key", expire_at, nx=True) is True
+        assert r.pexpireat("key", expire_at, nx=True) is False
+
+    @skip_if_server_version_lt("7.0.0")
+    def test_pexpireat_option_xx(self, r):
+        assert r.set("key", "val") is True
+        expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
+        assert r.pexpireat("key", expire_at, xx=True) is False
+        assert r.pexpireat("key", expire_at) is True
+        assert r.pexpireat("key", expire_at, xx=True) is True
+
+    @skip_if_server_version_lt("7.0.0")
+    def test_pexpireat_option_gt(self, r):
+        assert r.set("key", "val") is True
+        expire_at = redis_server_time(r) + datetime.timedelta(minutes=2)
+        assert r.pexpireat("key", expire_at) is True
+        expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
+        assert r.pexpireat("key", expire_at, gt=True) is False
+        expire_at = redis_server_time(r) + datetime.timedelta(minutes=3)
+        assert r.pexpireat("key", expire_at, gt=True) is True
+
+    @skip_if_server_version_lt("7.0.0")
+    def test_pexpireat_option_lt(self, r):
+        assert r.set("key", "val") is True
+        expire_at = redis_server_time(r) + datetime.timedelta(minutes=2)
+        assert r.pexpireat("key", expire_at) is True
+        expire_at = redis_server_time(r) + datetime.timedelta(minutes=3)
+        assert r.pexpireat("key", expire_at, lt=True) is False
+        expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
+        assert r.pexpireat("key", expire_at, lt=True) is True
+
     @skip_if_server_version_lt("7.0.0")
     def test_pexpiretime(self, r):
         r.set("a", "foo")

From b4421101aeb19aebcfbcb66ac03314e4c535f063 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 14 Mar 2022 15:03:58 +0200
Subject: [PATCH 0435/1164] Add support for SEARCH commands in cluster (#2042)

* Add support for SEARCH commands in cluster

* delete json tests mark & list search commands

* linters
---
 redis/cluster.py     | 47 ++++++++++++++++++++++++++++++++-----
 tests/conftest.py    |  2 +-
 tests/test_search.py | 56 ++++++++++++++++++++------------------------
 3 files changed, 68 insertions(+), 37 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index 87643a71b0..09c9ab7d0a 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -320,6 +320,42 @@ class RedisCluster(RedisClusterCommands):
         ),
     )
 
+    SEARCH_COMMANDS = (
+        [
+            "FT.CREATE",
+            "FT.SEARCH",
+            "FT.AGGREGATE",
+            "FT.EXPLAIN",
+            "FT.EXPLAINCLI",
+            "FT,PROFILE",
+            "FT.ALTER",
+            "FT.DROPINDEX",
+            "FT.ALIASADD",
+            "FT.ALIASUPDATE",
+            "FT.ALIASDEL",
+            "FT.TAGVALS",
+            "FT.SUGADD",
+            "FT.SUGGET",
+            "FT.SUGDEL",
+            "FT.SUGLEN",
+            "FT.SYNUPDATE",
+            "FT.SYNDUMP",
+            "FT.SPELLCHECK",
+            "FT.DICTADD",
+            "FT.DICTDEL",
+            "FT.DICTDUMP",
+            "FT.INFO",
+            "FT._LIST",
+            "FT.CONFIG",
+            "FT.ADD",
+            "FT.DEL",
+            "FT.DROP",
+            "FT.GET",
+            "FT.MGET",
+            "FT.SYNADD",
+        ],
+    )
+
     CLUSTER_COMMANDS_RESPONSE_CALLBACKS = {
         "CLUSTER ADDSLOTS": bool,
         "CLUSTER ADDSLOTSRANGE": bool,
@@ -854,6 +890,8 @@ def _determine_nodes(self, *args, **kwargs):
         elif command_flag == self.__class__.DEFAULT_NODE:
             # return the cluster's default node
             return [self.nodes_manager.default_node]
+        elif command in self.__class__.SEARCH_COMMANDS[0]:
+            return [self.nodes_manager.default_node]
         else:
             # get the node that holds the key's slot
             slot = self.determine_slot(*args)
@@ -1956,17 +1994,14 @@ def _send_cluster_commands(
             # refer to our internal node -> slot table that
             # tells us where a given
             # command should route to.
-            slot = self.determine_slot(*c.args)
-            node = self.nodes_manager.get_node_from_slot(
-                slot, self.read_from_replicas and c.args[0] in READ_COMMANDS
-            )
+            node = self._determine_nodes(*c.args)
 
             # now that we know the name of the node
             # ( it's just a string in the form of host:port )
             # we can build a list of commands for each node.
-            node_name = node.name
+            node_name = node[0].name
             if node_name not in nodes:
-                redis_node = self.get_redis_connection(node)
+                redis_node = self.get_redis_connection(node[0])
                 connection = get_connection(redis_node, c.args)
                 nodes[node_name] = NodeCommands(
                     redis_node.parse_response, redis_node.connection_pool, connection
diff --git a/tests/conftest.py b/tests/conftest.py
index b615915bb2..3b66adf46c 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -183,7 +183,7 @@ def wait_for_cluster_creation(redis_url, cluster_nodes, timeout=60):
     while now < end_time:
         try:
             client = redis.RedisCluster.from_url(redis_url)
-            if len(client.get_nodes()) == cluster_nodes:
+            if len(client.get_nodes()) == int(cluster_nodes):
                 print("All nodes are available!")
                 break
         except RedisClusterException:
diff --git a/tests/test_search.py b/tests/test_search.py
index 67f4357b4f..5dea7398e5 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -10,7 +10,6 @@
 import redis.commands.search
 import redis.commands.search.aggregation as aggregations
 import redis.commands.search.reducers as reducers
-from redis import Redis
 from redis.commands.json.path import Path
 from redis.commands.search import Search
 from redis.commands.search.field import GeoField, NumericField, TagField, TextField
@@ -19,10 +18,7 @@
 from redis.commands.search.result import Result
 from redis.commands.search.suggestion import Suggestion
 
-from .conftest import default_redismod_url, skip_ifmodversion_lt
-
-pytestmark = pytest.mark.onlynoncluster
-
+from .conftest import skip_ifmodversion_lt
 
 WILL_PLAY_TEXT = os.path.abspath(
     os.path.join(os.path.dirname(__file__), "testdata", "will_play_text.csv.bz2")
@@ -36,7 +32,7 @@
 def waitForIndex(env, idx, timeout=None):
     delay = 0.1
     while True:
-        res = env.execute_command("ft.info", idx)
+        res = env.execute_command("FT.INFO", idx)
         try:
             res.index("indexing")
         except ValueError:
@@ -52,13 +48,12 @@ def waitForIndex(env, idx, timeout=None):
                 break
 
 
-def getClient():
+def getClient(client):
     """
     Gets a client client attached to an index name which is ready to be
     created
     """
-    rc = Redis.from_url(default_redismod_url, decode_responses=True)
-    return rc
+    return client
 
 
 def createIndex(client, num_docs=100, definition=None):
@@ -96,12 +91,6 @@ def createIndex(client, num_docs=100, definition=None):
     indexer.commit()
 
 
-# override the default module client, search requires both db=0, and text
-@pytest.fixture
-def modclient():
-    return Redis.from_url(default_redismod_url, db=0, decode_responses=True)
-
-
 @pytest.fixture
 def client(modclient):
     modclient.flushdb()
@@ -234,6 +223,7 @@ def test_payloads(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.onlynoncluster
 def test_scores(client):
     client.ft().create_index((TextField("txt"),))
 
@@ -356,14 +346,14 @@ def test_sort_by(client):
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("2.0.0", "search")
-def test_drop_index():
+def test_drop_index(client):
     """
     Ensure the index gets dropped by data remains by default
     """
     for x in range(20):
         for keep_docs in [[True, {}], [False, {"name": "haveit"}]]:
             idx = "HaveIt"
-            index = getClient()
+            index = getClient(client)
             index.hset("index:haveit", mapping={"name": "haveit"})
             idef = IndexDefinition(prefix=["index:"])
             index.ft(idx).create_index((TextField("name"),), definition=idef)
@@ -574,9 +564,9 @@ def test_summarize(client):
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("2.0.0", "search")
-def test_alias():
-    index1 = getClient()
-    index2 = getClient()
+def test_alias(client):
+    index1 = getClient(client)
+    index2 = getClient(client)
 
     def1 = IndexDefinition(prefix=["index1:"])
     def2 = IndexDefinition(prefix=["index2:"])
@@ -594,7 +584,7 @@ def test_alias():
 
     # create alias and check for results
     ftindex1.aliasadd("spaceballs")
-    alias_client = getClient().ft("spaceballs")
+    alias_client = getClient(client).ft("spaceballs")
     res = alias_client.search("*").docs[0]
     assert "index1:lonestar" == res.id
 
@@ -604,7 +594,7 @@ def test_alias():
 
     # update alias and ensure new results
     ftindex2.aliasupdate("spaceballs")
-    alias_client2 = getClient().ft("spaceballs")
+    alias_client2 = getClient(client).ft("spaceballs")
 
     res = alias_client2.search("*").docs[0]
     assert "index2:yogurt" == res.id
@@ -615,21 +605,21 @@ def test_alias():
 
 
 @pytest.mark.redismod
-def test_alias_basic():
+def test_alias_basic(client):
     # Creating a client with one index
-    getClient().flushdb()
-    index1 = getClient().ft("testAlias")
+    getClient(client).flushdb()
+    index1 = getClient(client).ft("testAlias")
 
     index1.create_index((TextField("txt"),))
     index1.add_document("doc1", txt="text goes here")
 
-    index2 = getClient().ft("testAlias2")
+    index2 = getClient(client).ft("testAlias2")
     index2.create_index((TextField("txt"),))
     index2.add_document("doc2", txt="text goes here")
 
     # add the actual alias and check
     index1.aliasadd("myalias")
-    alias_client = getClient().ft("myalias")
+    alias_client = getClient(client).ft("myalias")
     res = sorted(alias_client.search("*").docs, key=lambda x: x.id)
     assert "doc1" == res[0].id
 
@@ -639,7 +629,7 @@ def test_alias_basic():
 
     # update the alias and ensure we get doc2
     index2.aliasupdate("myalias")
-    alias_client2 = getClient().ft("myalias")
+    alias_client2 = getClient(client).ft("myalias")
     res = sorted(alias_client2.search("*").docs, key=lambda x: x.id)
     assert "doc1" == res[0].id
 
@@ -790,6 +780,7 @@ def test_phonetic_matcher(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.onlynoncluster
 def test_scorer(client):
     client.ft().create_index((TextField("description"),))
 
@@ -842,6 +833,7 @@ def test_get(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("2.2.0", "search")
 def test_config(client):
     assert client.ft().config_set("TIMEOUT", "100")
@@ -854,6 +846,7 @@ def test_config(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.onlynoncluster
 def test_aggregations_groupby(client):
     # Creating the index definition and schema
     client.ft().create_index(
@@ -1085,8 +1078,8 @@ def test_aggregations_apply(client):
         CreatedDateTimeUTC="@CreatedDateTimeUTC * 10"
     )
     res = client.ft().aggregate(req)
-    assert res.rows[0] == ["CreatedDateTimeUTC", "6373878785249699840"]
-    assert res.rows[1] == ["CreatedDateTimeUTC", "6373878758592700416"]
+    res_set = set([res.rows[0][1], res.rows[1][1]])
+    assert res_set == set(["6373878785249699840", "6373878758592700416"])
 
 
 @pytest.mark.redismod
@@ -1158,6 +1151,7 @@ def test_index_definition(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.onlynoncluster
 def testExpire(client):
     client.ft().create_index((TextField("txt", sortable=True),), temporary=4)
     ttl = client.execute_command("ft.debug", "TTL", "idx")
@@ -1477,6 +1471,7 @@ def test_json_with_jsonpath(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.onlynoncluster
 def test_profile(client):
     client.ft().create_index((TextField("t"),))
     client.ft().client.hset("1", "t", "hello")
@@ -1505,6 +1500,7 @@ def test_profile(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.onlynoncluster
 def test_profile_limited(client):
     client.ft().create_index((TextField("t"),))
     client.ft().client.hset("1", "t", "hello")

From 160a7f6b951d2a11c17431cab34ee0457e128218 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 14 Mar 2022 15:43:02 +0200
Subject: [PATCH 0436/1164] fix TypeError (#2050)

---
 redis/commands/graph/commands.py       | 2 ++
 redis/commands/graph/execution_plan.py | 3 +++
 2 files changed, 5 insertions(+)

diff --git a/redis/commands/graph/commands.py b/redis/commands/graph/commands.py
index baed1fc2f7..2be46cd902 100644
--- a/redis/commands/graph/commands.py
+++ b/redis/commands/graph/commands.py
@@ -194,6 +194,8 @@ def execution_plan(self, query, params=None):
             query = self._build_params_header(params) + query
 
         plan = self.execute_command("GRAPH.EXPLAIN", self.name, query)
+        if isinstance(plan[0], bytes):
+            plan = [b.decode() for b in plan]
         return "\n".join(plan)
 
     def explain(self, query, params=None):
diff --git a/redis/commands/graph/execution_plan.py b/redis/commands/graph/execution_plan.py
index a9b4ad076a..179a80cca0 100644
--- a/redis/commands/graph/execution_plan.py
+++ b/redis/commands/graph/execution_plan.py
@@ -67,6 +67,9 @@ def __init__(self, plan):
         if not isinstance(plan, list):
             raise Exception("plan must be an array")
 
+        if isinstance(plan[0], bytes):
+            plan = [b.decode() for b in plan]
+
         self.plan = plan
         self.structured_plan = self._operation_tree()
 

From 4b2247645443ba27a3f5dc65a92735a406bac9f8 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 14 Mar 2022 15:57:58 +0200
Subject: [PATCH 0437/1164] Add support for SORT_RO (#1858)

* add sort_ro

* mark test as onlynon cluster

* delete mark test as onlynoncluster

* skip test
---
 redis/commands/core.py | 33 +++++++++++++++++++++++++++++++++
 tests/test_commands.py | 10 ++++++++++
 2 files changed, 43 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 56d6fa97ed..c367827359 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -2724,6 +2724,39 @@ def sort(
         options = {"groups": len(get) if groups else None}
         return self.execute_command("SORT", *pieces, **options)
 
+    def sort_ro(
+        self,
+        key: str,
+        start: Optional[int] = None,
+        num: Optional[int] = None,
+        by: Optional[str] = None,
+        get: Optional[List[str]] = None,
+        desc: bool = False,
+        alpha: bool = False,
+    ) -> list:
+        """
+        Returns the elements contained in the list, set or sorted set at key.
+        (read-only variant of the SORT command)
+
+        ``start`` and ``num`` allow for paging through the sorted data
+
+        ``by`` allows using an external key to weight and sort the items.
+            Use an "*" to indicate where in the key the item value is located
+
+        ``get`` allows for returning items from external keys rather than the
+            sorted data itself.  Use an "*" to indicate where in the key
+            the item value is located
+
+        ``desc`` allows for reversing the sort
+
+        ``alpha`` allows for sorting lexicographically rather than numerically
+
+        For more information check https://redis.io/commands/sort_ro
+        """
+        return self.sort(
+            key, start=start, num=num, by=by, get=get, desc=desc, alpha=alpha
+        )
+
 
 AsyncListCommands = ListCommands
 
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 2c1ebe64a1..0c5be9e81f 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2912,6 +2912,16 @@ def test_sort_all_options(self, r):
         assert num == 4
         assert r.lrange("sorted", 0, 10) == [b"vodka", b"milk", b"gin", b"apple juice"]
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_sort_ro(self, r):
+        r["score:1"] = 8
+        r["score:2"] = 3
+        r["score:3"] = 5
+        r.rpush("a", "3", "2", "1")
+        assert r.sort_ro("a", by="score:*") == [b"2", b"3", b"1"]
+        r.rpush("b", "2", "3", "1")
+        assert r.sort_ro("b", desc=True) == [b"3", b"2", b"1"]
+
     def test_sort_issue_924(self, r):
         # Tests for issue https://github.com/andymccurdy/redis-py/issues/924
         r.execute_command("SADD", "issue#924", 1)

From 95b32682b1924dcba4944ef383390c29aea18085 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 14 Mar 2022 16:38:34 +0200
Subject: [PATCH 0438/1164] v4.2.0rc3 (#2051)

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 8a483095b0..7bd0d9b045 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.2.0rc2",
+    version="4.2.0rc3",
     packages=find_packages(
         include=[
             "redis",

From 878e2f2cd961bab5bf00d9b98e4fc7d16d5acfe0 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 16 Mar 2022 14:13:40 +0200
Subject: [PATCH 0439/1164] Mark tests for redis-stack (#2052)

* mark tests for redis-stack

* linters
---
 tests/test_bloom.py     |  10 ++++
 tests/test_commands.py  | 112 ++++++++++++++++++++--------------------
 tests/test_scripting.py |  24 ++++-----
 tox.ini                 |   2 +
 4 files changed, 81 insertions(+), 67 deletions(-)

diff --git a/tests/test_bloom.py b/tests/test_bloom.py
index a3e9e158f4..4c6779bbd0 100644
--- a/tests/test_bloom.py
+++ b/tests/test_bloom.py
@@ -34,6 +34,11 @@ def test_create(client):
     assert client.cms().initbydim("cmsDim", 100, 5)
     assert client.cms().initbyprob("cmsProb", 0.01, 0.01)
     assert client.topk().reserve("topk", 5, 100, 5, 0.9)
+
+
+@pytest.mark.redismod
+@pytest.mark.experimental
+def test_tdigest_create(client):
     assert client.tdigest().create("tDigest", 100)
 
 
@@ -306,6 +311,7 @@ def test_topk_incrby(client):
 
 # region Test T-Digest
 @pytest.mark.redismod
+@pytest.mark.experimental
 def test_tdigest_reset(client):
     assert client.tdigest().create("tDigest", 10)
     # reset on empty histogram
@@ -319,6 +325,7 @@ def test_tdigest_reset(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.experimental
 def test_tdigest_merge(client):
     assert client.tdigest().create("to-tDigest", 10)
     assert client.tdigest().create("from-tDigest", 10)
@@ -334,6 +341,7 @@ def test_tdigest_merge(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.experimental
 def test_tdigest_min_and_max(client):
     assert client.tdigest().create("tDigest", 100)
     # insert data-points into sketch
@@ -344,6 +352,7 @@ def test_tdigest_min_and_max(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.experimental
 def test_tdigest_quantile(client):
     assert client.tdigest().create("tDigest", 500)
     # insert data-points into sketch
@@ -359,6 +368,7 @@ def test_tdigest_quantile(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.experimental
 def test_tdigest_cdf(client):
     assert client.tdigest().create("tDigest", 100)
     # insert data-points into sketch
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 0c5be9e81f..de6bcead1c 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -626,11 +626,11 @@ def test_client_unpause(self, r):
         assert r.client_unpause() == b"OK"
 
     @pytest.mark.onlynoncluster
-    # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
-    def test_client_no_evict(self, unstable_r):
-        assert unstable_r.client_no_evict("ON") == "OK"
+    @skip_if_server_version_lt("7.0.0")
+    def test_client_no_evict(self, r):
+        assert r.client_no_evict("ON") == "OK"
         with pytest.raises(TypeError):
-            unstable_r.client_no_evict()
+            r.client_no_evict()
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("3.2.0")
@@ -998,15 +998,15 @@ def test_unlink_with_multiple_keys(self, r):
         assert r.get("b") is None
 
     @pytest.mark.onlynoncluster
-    # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
-    def test_lcs(self, unstable_r):
-        unstable_r.mset({"foo": "ohmytext", "bar": "mynewtext"})
-        assert unstable_r.lcs("foo", "bar") == "mytext"
-        assert unstable_r.lcs("foo", "bar", len=True) == 6
+    @skip_if_server_version_lt("7.0.0")
+    def test_lcs(self, r):
+        r.mset({"foo": "ohmytext", "bar": "mynewtext"})
+        assert r.lcs("foo", "bar") == "mytext"
+        assert r.lcs("foo", "bar", len=True) == 6
         result = ["matches", [[[4, 7], [5, 8]]], "len", 6]
-        assert unstable_r.lcs("foo", "bar", idx=True, minmatchlen=3) == result
+        assert r.lcs("foo", "bar", idx=True, minmatchlen=3) == result
         with pytest.raises(redis.ResponseError):
-            assert unstable_r.lcs("foo", "bar", len=True, idx=True)
+            assert r.lcs("foo", "bar", len=True, idx=True)
 
     @skip_if_server_version_lt("2.6.0")
     def test_dump_and_restore(self, r):
@@ -1671,27 +1671,27 @@ def test_brpoplpush_empty_string(self, r):
         assert r.brpoplpush("a", "b") == b""
 
     @pytest.mark.onlynoncluster
-    # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
-    def test_blmpop(self, unstable_r):
-        unstable_r.rpush("a", "1", "2", "3", "4", "5")
+    @skip_if_server_version_lt("7.0.0")
+    def test_blmpop(self, r):
+        r.rpush("a", "1", "2", "3", "4", "5")
         res = ["a", ["1", "2"]]
-        assert unstable_r.blmpop(1, "2", "b", "a", direction="LEFT", count=2) == res
+        assert r.blmpop(1, "2", "b", "a", direction="LEFT", count=2) == res
         with pytest.raises(TypeError):
-            unstable_r.blmpop(1, "2", "b", "a", count=2)
-        unstable_r.rpush("b", "6", "7", "8", "9")
-        assert unstable_r.blmpop(0, "2", "b", "a", direction="LEFT") == ["b", ["6"]]
-        assert unstable_r.blmpop(1, "2", "foo", "bar", direction="RIGHT") is None
+            r.blmpop(1, "2", "b", "a", count=2)
+        r.rpush("b", "6", "7", "8", "9")
+        assert r.blmpop(0, "2", "b", "a", direction="LEFT") == ["b", ["6"]]
+        assert r.blmpop(1, "2", "foo", "bar", direction="RIGHT") is None
 
     @pytest.mark.onlynoncluster
-    # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
-    def test_lmpop(self, unstable_r):
-        unstable_r.rpush("foo", "1", "2", "3", "4", "5")
+    @skip_if_server_version_lt("7.0.0")
+    def test_lmpop(self, r):
+        r.rpush("foo", "1", "2", "3", "4", "5")
         result = ["foo", ["1", "2"]]
-        assert unstable_r.lmpop("2", "bar", "foo", direction="LEFT", count=2) == result
+        assert r.lmpop("2", "bar", "foo", direction="LEFT", count=2) == result
         with pytest.raises(redis.ResponseError):
-            unstable_r.lmpop("2", "bar", "foo", direction="up", count=2)
-        unstable_r.rpush("bar", "a", "b", "c", "d")
-        assert unstable_r.lmpop("2", "bar", "foo", direction="LEFT") == ["bar", ["a"]]
+            r.lmpop("2", "bar", "foo", direction="up", count=2)
+        r.rpush("bar", "a", "b", "c", "d")
+        assert r.lmpop("2", "bar", "foo", direction="LEFT") == ["bar", ["a"]]
 
     def test_lindex(self, r):
         r.rpush("a", "1", "2", "3")
@@ -1962,13 +1962,13 @@ def test_sinter(self, r):
         assert r.sinter("a", "b") == {b"2", b"3"}
 
     @pytest.mark.onlynoncluster
-    # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
-    def test_sintercard(self, unstable_r):
-        unstable_r.sadd("a", 1, 2, 3)
-        unstable_r.sadd("b", 1, 2, 3)
-        unstable_r.sadd("c", 1, 3, 4)
-        assert unstable_r.sintercard(3, ["a", "b", "c"]) == 2
-        assert unstable_r.sintercard(3, ["a", "b", "c"], limit=1) == 1
+    @skip_if_server_version_lt("7.0.0")
+    def test_sintercard(self, r):
+        r.sadd("a", 1, 2, 3)
+        r.sadd("b", 1, 2, 3)
+        r.sadd("c", 1, 3, 4)
+        assert r.sintercard(3, ["a", "b", "c"]) == 2
+        assert r.sintercard(3, ["a", "b", "c"], limit=1) == 1
 
     @pytest.mark.onlynoncluster
     def test_sinterstore(self, r):
@@ -2202,13 +2202,13 @@ def test_zinter(self, r):
         ]
 
     @pytest.mark.onlynoncluster
-    # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
-    def test_zintercard(self, unstable_r):
-        unstable_r.zadd("a", {"a1": 1, "a2": 2, "a3": 1})
-        unstable_r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
-        unstable_r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
-        assert unstable_r.zintercard(3, ["a", "b", "c"]) == 2
-        assert unstable_r.zintercard(3, ["a", "b", "c"], limit=1) == 1
+    @skip_if_server_version_lt("7.0.0")
+    def test_zintercard(self, r):
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 1})
+        r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
+        r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
+        assert r.zintercard(3, ["a", "b", "c"]) == 2
+        assert r.zintercard(3, ["a", "b", "c"], limit=1) == 1
 
     @pytest.mark.onlynoncluster
     def test_zinterstore_sum(self, r):
@@ -2297,28 +2297,28 @@ def test_bzpopmin(self, r):
         assert r.bzpopmin("c", timeout=1) == (b"c", b"c1", 100)
 
     @pytest.mark.onlynoncluster
-    # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
-    def test_zmpop(self, unstable_r):
-        unstable_r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+    @skip_if_server_version_lt("7.0.0")
+    def test_zmpop(self, r):
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
         res = ["a", [["a1", "1"], ["a2", "2"]]]
-        assert unstable_r.zmpop("2", ["b", "a"], min=True, count=2) == res
+        assert r.zmpop("2", ["b", "a"], min=True, count=2) == res
         with pytest.raises(redis.DataError):
-            unstable_r.zmpop("2", ["b", "a"], count=2)
-        unstable_r.zadd("b", {"b1": 10, "ab": 9, "b3": 8})
-        assert unstable_r.zmpop("2", ["b", "a"], max=True) == ["b", [["b1", "10"]]]
+            r.zmpop("2", ["b", "a"], count=2)
+        r.zadd("b", {"b1": 10, "ab": 9, "b3": 8})
+        assert r.zmpop("2", ["b", "a"], max=True) == ["b", [["b1", "10"]]]
 
     @pytest.mark.onlynoncluster
-    # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
-    def test_bzmpop(self, unstable_r):
-        unstable_r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+    @skip_if_server_version_lt("7.0.0")
+    def test_bzmpop(self, r):
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
         res = ["a", [["a1", "1"], ["a2", "2"]]]
-        assert unstable_r.bzmpop(1, "2", ["b", "a"], min=True, count=2) == res
+        assert r.bzmpop(1, "2", ["b", "a"], min=True, count=2) == res
         with pytest.raises(redis.DataError):
-            unstable_r.bzmpop(1, "2", ["b", "a"], count=2)
-        unstable_r.zadd("b", {"b1": 10, "ab": 9, "b3": 8})
+            r.bzmpop(1, "2", ["b", "a"], count=2)
+        r.zadd("b", {"b1": 10, "ab": 9, "b3": 8})
         res = ["b", [["b1", "10"]]]
-        assert unstable_r.bzmpop(0, "2", ["b", "a"], max=True) == res
-        assert unstable_r.bzmpop(1, "2", ["foo", "bar"], max=True) is None
+        assert r.bzmpop(0, "2", ["b", "a"], max=True) == res
+        assert r.bzmpop(1, "2", ["foo", "bar"], max=True) is None
 
     def test_zrange(self, r):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
@@ -4481,12 +4481,14 @@ def test_replicaof(self, r):
             assert r.replicaof("NO ONE")
         assert r.replicaof("NO", "ONE")
 
+    @pytest.mark.replica
     @skip_if_server_version_lt("2.8.0")
     def test_sync(self, r):
         r2 = redis.Redis(port=6380, decode_responses=False)
         res = r2.sync()
         assert b"REDIS" in res
 
+    @pytest.mark.replica
     @skip_if_server_version_lt("2.8.0")
     def test_psync(self, r):
         r2 = redis.Redis(port=6380, decode_responses=False)
diff --git a/tests/test_scripting.py b/tests/test_scripting.py
index 4635f9572d..8f6a24cdae 100644
--- a/tests/test_scripting.py
+++ b/tests/test_scripting.py
@@ -65,13 +65,13 @@ def test_eval_multiply(self, r):
         # 2 * 3 == 6
         assert r.eval(multiply_script, 1, "a", 3) == 6
 
-    # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
+    @skip_if_server_version_lt("7.0.0")
     @pytest.mark.onlynoncluster
-    def test_eval_ro(self, unstable_r):
-        unstable_r.set("a", "b")
-        assert unstable_r.eval_ro("return redis.call('GET', KEYS[1])", 1, "a") == "b"
+    def test_eval_ro(self, r):
+        r.set("a", "b")
+        assert r.eval_ro("return redis.call('GET', KEYS[1])", 1, "a") == "b"
         with pytest.raises(redis.ResponseError):
-            unstable_r.eval_ro("return redis.call('DEL', KEYS[1])", 1, "a")
+            r.eval_ro("return redis.call('DEL', KEYS[1])", 1, "a")
 
     def test_eval_msgpack(self, r):
         msgpack_message_dumped = b"\x81\xa4name\xa3Joe"
@@ -154,15 +154,15 @@ def test_evalsha(self, r):
         # 2 * 3 == 6
         assert r.evalsha(sha, 1, "a", 3) == 6
 
-    # @skip_if_server_version_lt("7.0.0") turn on after redis 7 release
+    @skip_if_server_version_lt("7.0.0")
     @pytest.mark.onlynoncluster
-    def test_evalsha_ro(self, unstable_r):
-        unstable_r.set("a", "b")
-        get_sha = unstable_r.script_load("return redis.call('GET', KEYS[1])")
-        del_sha = unstable_r.script_load("return redis.call('DEL', KEYS[1])")
-        assert unstable_r.evalsha_ro(get_sha, 1, "a") == "b"
+    def test_evalsha_ro(self, r):
+        r.set("a", "b")
+        get_sha = r.script_load("return redis.call('GET', KEYS[1])")
+        del_sha = r.script_load("return redis.call('DEL', KEYS[1])")
+        assert r.evalsha_ro(get_sha, 1, "a") == "b"
         with pytest.raises(redis.ResponseError):
-            unstable_r.evalsha_ro(del_sha, 1, "a")
+            r.evalsha_ro(del_sha, 1, "a")
 
     def test_evalsha_script_not_loaded(self, r):
         r.set("a", 2)
diff --git a/tox.ini b/tox.ini
index e9174a66c5..1a3450bdaa 100644
--- a/tox.ini
+++ b/tox.ini
@@ -6,6 +6,8 @@ markers =
     onlycluster: marks tests to be run only with cluster mode redis
     onlynoncluster: marks tests to be run only with standalone redis
     ssl: marker for only the ssl tests
+    replica: replica tests
+    experimental: run only experimental tests
 
 [tox]
 minversion = 3.2.0

From 032fd227d3325a24a47b9d33fc42bccaafba28e2 Mon Sep 17 00:00:00 2001
From: Joni Nevalainen <joni-@users.noreply.github.com>
Date: Wed, 23 Mar 2022 11:16:09 +0200
Subject: [PATCH 0440/1164] Remove verbose logging from cluster initializers
 (#2055)

---
 CHANGES          | 1 +
 redis/cluster.py | 4 ----
 2 files changed, 1 insertion(+), 4 deletions(-)

diff --git a/CHANGES b/CHANGES
index ca2d2e818d..aa5192d504 100644
--- a/CHANGES
+++ b/CHANGES
@@ -3,6 +3,7 @@
   	* Create codeql-analysis.yml (#1988). Thanks @chayim
     * Add limited support for Lua scripting with RedisCluster
     * Implement `.lock()` method on RedisCluster
+    * Remove verbose logging when initializing ClusterPubSub, ClusterPipeline or RedisCluster
 
 * 4.1.3 (Feb 8, 2022)
     * Fix flushdb and flushall (#1926)
diff --git a/redis/cluster.py b/redis/cluster.py
index 09c9ab7d0a..287fd4fb7a 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -518,8 +518,6 @@ def __init__(
              RedisClusterException:
                  - db (Redis do not support database SELECT in cluster mode)
         """
-        log.info("Creating a new instance of RedisCluster client")
-
         if startup_nodes is None:
             startup_nodes = []
 
@@ -1670,7 +1668,6 @@ def __init__(self, redis_cluster, node=None, host=None, port=None, **kwargs):
         :type host: str
         :type port: int
         """
-        log.info("Creating new instance of ClusterPubSub")
         self.node = None
         self.set_pubsub_node(redis_cluster, node, host, port)
         connection_pool = (
@@ -1802,7 +1799,6 @@ def __init__(
         **kwargs,
     ):
         """ """
-        log.info("Creating new instance of ClusterPipeline")
         self.command_stack = []
         self.nodes_manager = nodes_manager
         self.commands_parser = commands_parser

From 827dcde5c0af5f7aa9bdc3999fc86aa2ba945118 Mon Sep 17 00:00:00 2001
From: Utkarsh Gupta <utkarshgupta137@gmail.com>
Date: Wed, 23 Mar 2022 14:48:16 +0530
Subject: [PATCH 0441/1164] [CLUSTER] Fix scan command cursors & Fix scan_iter
 (#2054)

* cluster/scan: fix return cursor & change default node to primaries

* cluster/scan_iter: fix iteration

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 CHANGES                   |  4 ++-
 redis/cluster.py          | 16 +++++++----
 redis/commands/cluster.py | 38 +++++++++++++++++++++++++
 tests/test_cluster.py     | 59 +++++++++++++++++++++++++++++----------
 4 files changed, 96 insertions(+), 21 deletions(-)

diff --git a/CHANGES b/CHANGES
index aa5192d504..95843ec7ff 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,8 +1,10 @@
 
     * Add `items` parameter to `hset` signature
-  	* Create codeql-analysis.yml (#1988). Thanks @chayim
+    * Create codeql-analysis.yml (#1988). Thanks @chayim
     * Add limited support for Lua scripting with RedisCluster
     * Implement `.lock()` method on RedisCluster
+    * Fix cursor returned by SCAN for RedisCluster & change default target to PRIMARIES
+    * Fix scan_iter for RedisCluster
     * Remove verbose logging when initializing ClusterPubSub, ClusterPipeline or RedisCluster
 
 * 4.1.3 (Feb 8, 2022)
diff --git a/redis/cluster.py b/redis/cluster.py
index 287fd4fb7a..221df856c1 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -7,7 +7,7 @@
 import time
 from collections import OrderedDict
 
-from redis.client import CaseInsensitiveDict, PubSub, Redis
+from redis.client import CaseInsensitiveDict, PubSub, Redis, parse_scan
 from redis.commands import CommandsParser, RedisClusterCommands
 from redis.connection import ConnectionPool, DefaultParser, Encoder, parse_url
 from redis.crc import REDIS_CLUSTER_HASH_SLOTS, key_slot
@@ -51,10 +51,14 @@ def get_connection(redis_node, *args, **options):
 
 
 def parse_scan_result(command, res, **options):
-    keys_list = []
-    for primary_res in res.values():
-        keys_list += primary_res[1]
-    return 0, keys_list
+    cursors = {}
+    ret = []
+    for node_name, response in res.items():
+        cursor, r = parse_scan(response, **options)
+        cursors[node_name] = cursor
+        ret += r
+
+    return cursors, ret
 
 
 def parse_pubsub_numsub(command, res, **options):
@@ -244,7 +248,6 @@ class RedisCluster(RedisClusterCommands):
                 "INFO",
                 "SHUTDOWN",
                 "KEYS",
-                "SCAN",
                 "DBSIZE",
                 "BGSAVE",
                 "SLOWLOG GET",
@@ -298,6 +301,7 @@ class RedisCluster(RedisClusterCommands):
                 "FUNCTION LIST",
                 "FUNCTION LOAD",
                 "FUNCTION RESTORE",
+                "SCAN",
                 "SCRIPT EXISTS",
                 "SCRIPT FLUSH",
                 "SCRIPT LOAD",
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index d68f93bcac..bcbfbd599d 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -1,5 +1,8 @@
+from typing import Iterator, Union
+
 from redis.crc import key_slot
 from redis.exceptions import RedisClusterException, RedisError
+from redis.typing import PatternT
 
 from .core import (
     ACLCommands,
@@ -206,6 +209,41 @@ def stralgo(
             **kwargs,
         )
 
+    def scan_iter(
+        self,
+        match: Union[PatternT, None] = None,
+        count: Union[int, None] = None,
+        _type: Union[str, None] = None,
+        **kwargs,
+    ) -> Iterator:
+        # Do the first query with cursor=0 for all nodes
+        cursors, data = self.scan(match=match, count=count, _type=_type, **kwargs)
+        yield from data
+
+        cursors = {name: cursor for name, cursor in cursors.items() if cursor != 0}
+        if cursors:
+            # Get nodes by name
+            nodes = {name: self.get_node(node_name=name) for name in cursors.keys()}
+
+            # Iterate over each node till its cursor is 0
+            kwargs.pop("target_nodes", None)
+            while cursors:
+                for name, cursor in cursors.items():
+                    cur, data = self.scan(
+                        cursor=cursor,
+                        match=match,
+                        count=count,
+                        _type=_type,
+                        target_nodes=nodes[name],
+                        **kwargs,
+                    )
+                    yield from data
+                    cursors[name] = cur[name]
+
+                cursors = {
+                    name: cursor for name, cursor in cursors.items() if cursor != 0
+                }
+
 
 class RedisClusterCommands(
     ClusterMultiKeyCommands,
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index e9242e008e..70cbe4f9c4 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -1773,29 +1773,60 @@ def test_cluster_scan(self, r):
         r.set("a", 1)
         r.set("b", 2)
         r.set("c", 3)
-        cursor, keys = r.scan(target_nodes="primaries")
-        assert cursor == 0
-        assert set(keys) == {b"a", b"b", b"c"}
-        _, keys = r.scan(match="a", target_nodes="primaries")
-        assert set(keys) == {b"a"}
+
+        for target_nodes, nodes in zip(
+            ["primaries", "replicas"], [r.get_primaries(), r.get_replicas()]
+        ):
+            cursors, keys = r.scan(target_nodes=target_nodes)
+            assert sorted(keys) == [b"a", b"b", b"c"]
+            assert sorted(cursors.keys()) == sorted(node.name for node in nodes)
+            assert all(cursor == 0 for cursor in cursors.values())
+
+            cursors, keys = r.scan(match="a*", target_nodes=target_nodes)
+            assert sorted(keys) == [b"a"]
+            assert sorted(cursors.keys()) == sorted(node.name for node in nodes)
+            assert all(cursor == 0 for cursor in cursors.values())
 
     @skip_if_server_version_lt("6.0.0")
     def test_cluster_scan_type(self, r):
         r.sadd("a-set", 1)
+        r.sadd("b-set", 1)
+        r.sadd("c-set", 1)
         r.hset("a-hash", "foo", 2)
         r.lpush("a-list", "aux", 3)
-        _, keys = r.scan(match="a*", _type="SET", target_nodes="primaries")
-        assert set(keys) == {b"a-set"}
+
+        for target_nodes, nodes in zip(
+            ["primaries", "replicas"], [r.get_primaries(), r.get_replicas()]
+        ):
+            cursors, keys = r.scan(_type="SET", target_nodes=target_nodes)
+            assert sorted(keys) == [b"a-set", b"b-set", b"c-set"]
+            assert sorted(cursors.keys()) == sorted(node.name for node in nodes)
+            assert all(cursor == 0 for cursor in cursors.values())
+
+            cursors, keys = r.scan(_type="SET", match="a*", target_nodes=target_nodes)
+            assert sorted(keys) == [b"a-set"]
+            assert sorted(cursors.keys()) == sorted(node.name for node in nodes)
+            assert all(cursor == 0 for cursor in cursors.values())
 
     @skip_if_server_version_lt("2.8.0")
     def test_cluster_scan_iter(self, r):
-        r.set("a", 1)
-        r.set("b", 2)
-        r.set("c", 3)
-        keys = list(r.scan_iter(target_nodes="primaries"))
-        assert set(keys) == {b"a", b"b", b"c"}
-        keys = list(r.scan_iter(match="a", target_nodes="primaries"))
-        assert set(keys) == {b"a"}
+        keys_all = []
+        keys_1 = []
+        for i in range(100):
+            s = str(i)
+            r.set(s, 1)
+            keys_all.append(s.encode("utf-8"))
+            if s.startswith("1"):
+                keys_1.append(s.encode("utf-8"))
+        keys_all.sort()
+        keys_1.sort()
+
+        for target_nodes in ["primaries", "replicas"]:
+            keys = r.scan_iter(target_nodes=target_nodes)
+            assert sorted(keys) == keys_all
+
+            keys = r.scan_iter(match="1*", target_nodes=target_nodes)
+            assert sorted(keys) == keys_1
 
     def test_cluster_randomkey(self, r):
         node = r.get_node_from_key("{foo}")

From 019f651c822c86525e57ad85a7e19f72757255bb Mon Sep 17 00:00:00 2001
From: Avital Fine <98389525+Avital-Fine@users.noreply.github.com>
Date: Wed, 23 Mar 2022 13:02:46 +0100
Subject: [PATCH 0442/1164] Support for Vector Fields for Vector Similarity
 Search (#2041)

* Support Vector field in FT.CREATE command

* linters

* fix data error

* change to dic

* add type hints and docstring to constructor

* test not supported algorithm

* linters

* fix errors

* example

* delete example

Co-authored-by: dvora-h <dvora.heller@redis.com>
---
 redis/commands/search/field.py | 75 +++++++++++++++++++++++++++++++---
 tests/test_search.py           | 42 ++++++++++++++++++-
 2 files changed, 111 insertions(+), 6 deletions(-)

diff --git a/redis/commands/search/field.py b/redis/commands/search/field.py
index 69e39083b0..da6667df88 100644
--- a/redis/commands/search/field.py
+++ b/redis/commands/search/field.py
@@ -1,3 +1,8 @@
+from typing import List
+
+from redis import DataError
+
+
 class Field:
 
     NUMERIC = "NUMERIC"
@@ -5,11 +10,21 @@ class Field:
     WEIGHT = "WEIGHT"
     GEO = "GEO"
     TAG = "TAG"
+    VECTOR = "VECTOR"
     SORTABLE = "SORTABLE"
     NOINDEX = "NOINDEX"
     AS = "AS"
 
-    def __init__(self, name, args=[], sortable=False, no_index=False, as_name=None):
+    def __init__(
+        self,
+        name: str,
+        args: List[str] = None,
+        sortable: bool = False,
+        no_index: bool = False,
+        as_name: str = None,
+    ):
+        if args is None:
+            args = []
         self.name = name
         self.args = args
         self.args_suffix = list()
@@ -44,7 +59,12 @@ class TextField(Field):
     PHONETIC = "PHONETIC"
 
     def __init__(
-        self, name, weight=1.0, no_stem=False, phonetic_matcher=None, **kwargs
+        self,
+        name: str,
+        weight: float = 1.0,
+        no_stem: bool = False,
+        phonetic_matcher: str = None,
+        **kwargs,
     ):
         Field.__init__(self, name, args=[Field.TEXT, Field.WEIGHT, weight], **kwargs)
 
@@ -65,7 +85,7 @@ class NumericField(Field):
     NumericField is used to define a numeric field in a schema definition
     """
 
-    def __init__(self, name, **kwargs):
+    def __init__(self, name: str, **kwargs):
         Field.__init__(self, name, args=[Field.NUMERIC], **kwargs)
 
 
@@ -74,7 +94,7 @@ class GeoField(Field):
     GeoField is used to define a geo-indexing field in a schema definition
     """
 
-    def __init__(self, name, **kwargs):
+    def __init__(self, name: str, **kwargs):
         Field.__init__(self, name, args=[Field.GEO], **kwargs)
 
 
@@ -86,7 +106,52 @@ class TagField(Field):
 
     SEPARATOR = "SEPARATOR"
 
-    def __init__(self, name, separator=",", **kwargs):
+    def __init__(self, name: str, separator: str = ",", **kwargs):
         Field.__init__(
             self, name, args=[Field.TAG, self.SEPARATOR, separator], **kwargs
         )
+
+
+class VectorField(Field):
+    """
+    Allows vector similarity queries against the value in this attribute.
+    See https://oss.redis.com/redisearch/Vectors/#vector_fields.
+    """
+
+    def __init__(self, name: str, algorithm: str, attributes: dict, **kwargs):
+        """
+        Create Vector Field. Notice that Vector cannot have sortable or no_index tag,
+        although it's also a Field.
+
+        ``name`` is the name of the field.
+
+        ``algorithm`` can be "FLAT" or "HNSW".
+
+        ``attributes`` each algorithm can have specific attributes. Some of them
+        are mandatory and some of them are optional. See
+        https://oss.redis.com/redisearch/master/Vectors/#specific_creation_attributes_per_algorithm
+        for more information.
+        """
+        sort = kwargs.get("sortable", False)
+        noindex = kwargs.get("no_index", False)
+
+        if sort or noindex:
+            raise DataError("Cannot set 'sortable' or 'no_index' in Vector fields.")
+
+        if algorithm.upper() not in ["FLAT", "HNSW"]:
+            raise DataError(
+                "Realtime vector indexing supporting 2 Indexing Methods:"
+                "'FLAT' and 'HNSW'."
+            )
+
+        attr_li = []
+
+        for key, value in attributes.items():
+            attr_li.extend([key, value])
+
+        Field.__init__(
+            self,
+            name,
+            args=[Field.VECTOR, algorithm, len(attr_li), *attr_li],
+            **kwargs,
+        )
diff --git a/tests/test_search.py b/tests/test_search.py
index 5dea7398e5..b94ae058b2 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -12,7 +12,13 @@
 import redis.commands.search.reducers as reducers
 from redis.commands.json.path import Path
 from redis.commands.search import Search
-from redis.commands.search.field import GeoField, NumericField, TagField, TextField
+from redis.commands.search.field import (
+    GeoField,
+    NumericField,
+    TagField,
+    TextField,
+    VectorField,
+)
 from redis.commands.search.indexDefinition import IndexDefinition, IndexType
 from redis.commands.search.query import GeoFilter, NumericFilter, Query
 from redis.commands.search.result import Result
@@ -1522,6 +1528,40 @@ def test_profile_limited(client):
     assert len(res.docs) == 3  # check also the search result
 
 
+@pytest.mark.redismod
+def test_vector_field(modclient):
+    modclient.flushdb()
+    modclient.ft().create_index(
+        (
+            VectorField(
+                "v", "HNSW", {"TYPE": "FLOAT32", "DIM": 2, "DISTANCE_METRIC": "L2"}
+            ),
+        )
+    )
+    modclient.hset("a", "v", "aaaaaaaa")
+    modclient.hset("b", "v", "aaaabaaa")
+    modclient.hset("c", "v", "aaaaabaa")
+
+    q = Query("*=>[KNN 2 @v $vec]").return_field("__v_score").sort_by("__v_score", True)
+    res = modclient.ft().search(q, query_params={"vec": "aaaaaaaa"})
+
+    assert "a" == res.docs[0].id
+    assert "0" == res.docs[0].__getattribute__("__v_score")
+
+
+@pytest.mark.redismod
+def test_vector_field_error(modclient):
+    modclient.flushdb()
+
+    # sortable tag
+    with pytest.raises(Exception):
+        modclient.ft().create_index((VectorField("v", "HNSW", {}, sortable=True),))
+
+    # not supported algorithm
+    with pytest.raises(Exception):
+        modclient.ft().create_index((VectorField("v", "SORT", {}),))
+
+
 @pytest.mark.redismod
 def test_text_params(modclient):
     modclient.flushdb()

From ef4caf5b8bd55fc5c3ca7d994e2047e046f7e942 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 23 Mar 2022 14:21:16 +0200
Subject: [PATCH 0443/1164] v4.2.0 (#2059)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 7bd0d9b045..a3293addb2 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.2.0rc3",
+    version="4.2.0",
     packages=find_packages(
         include=[
             "redis",

From 9cfcaa4f42ac324aa85fa9135961834ff2b9395f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20G=C3=B3rny?= <mgorny@gentoo.org>
Date: Thu, 31 Mar 2022 08:34:35 +0200
Subject: [PATCH 0444/1164] Make typing_extensions conditional to Python < 3.8
 (#2062)

All the typing features used by redis-py are available in Python 3.8+,
so typing_extensions is not used at all in newer versions of Python.
Adjust the dependencies accordingly.
---
 requirements.txt | 2 +-
 setup.py         | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index 7f0ebf0c69..c40eca70e0 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,4 +1,4 @@
 async-timeout>=4.0.2
 deprecated>=1.2.3
 packaging>=20.4
-typing-extensions
+typing-extensions; python_version<"3.8"
diff --git a/setup.py b/setup.py
index a3293addb2..0e7b1f5801 100644
--- a/setup.py
+++ b/setup.py
@@ -35,7 +35,7 @@
         "deprecated>=1.2.3",
         "packaging>=20.4",
         'importlib-metadata >= 1.0; python_version < "3.8"',
-        "typing-extensions",
+        'typing-extensions; python_version<"3.8"',
         "async-timeout>=4.0.2",
     ],
     classifiers=[

From 0a5e4861a05c34d927e5cf1831b8515cb2094e1e Mon Sep 17 00:00:00 2001
From: Binbin <binloveplay1314@qq.com>
Date: Thu, 31 Mar 2022 14:36:43 +0800
Subject: [PATCH 0445/1164] Add support for CLUSTER MYID (#2063)

Co-authored-by: enjoy-binbin <binbin.zhu@tenclass.com>
---
 redis/commands/cluster.py | 11 +++++++++++
 tests/test_cluster.py     |  5 +++++
 2 files changed, 16 insertions(+)

diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index bcbfbd599d..c3d7bd6e49 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -275,6 +275,17 @@ class RedisClusterCommands(
         r.cluster_info(target_nodes=RedisCluster.ALL_NODES)
     """
 
+    def cluster_myid(self, target_node):
+        """
+        Returns the node’s id.
+
+        :target_node: 'ClusterNode'
+            The node to execute the command on
+
+        For more information check https://redis.io/commands/cluster-myid/
+        """
+        return self.execute_command("CLUSTER MYID", target_nodes=target_node)
+
     def cluster_addslots(self, target_node, *slots):
         """
         Assign new hash slots to receiving node. Sends to specified node.
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 70cbe4f9c4..ecc8624015 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -840,6 +840,11 @@ def test_cluster_pubsub_numsub(self, r):
         channels = [(b"foo", 1), (b"bar", 2), (b"baz", 3)]
         assert r.pubsub_numsub("foo", "bar", "baz", target_nodes="all") == channels
 
+    def test_cluster_myid(self, r):
+        node = r.get_random_node()
+        myid = r.cluster_myid(node)
+        assert len(myid) == 40
+
     def test_cluster_slots(self, r):
         mock_all_nodes_resp(r, default_cluster_slots)
         cluster_slots = r.cluster_slots()

From bdae7899f66a14f35ece0e815685ae405ac2c824 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 31 Mar 2022 11:54:20 +0300
Subject: [PATCH 0446/1164] Add dialect support for RediSearch queries (#2071)

* Add dialect support for RediSearch queries

* type hints

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/commands/search/query.py | 12 +++++++++
 tests/test_search.py           | 45 ++++++++++++++++++++++++++++++++++
 2 files changed, 57 insertions(+)

diff --git a/redis/commands/search/query.py b/redis/commands/search/query.py
index 2bb8347dbc..e51918f500 100644
--- a/redis/commands/search/query.py
+++ b/redis/commands/search/query.py
@@ -35,6 +35,7 @@ def __init__(self, query_string):
         self._highlight_fields = []
         self._language = None
         self._expander = None
+        self._dialect = None
 
     def query_string(self):
         """Return the query string of this query only."""
@@ -202,6 +203,8 @@ def _get_args_tags(self):
             args += ["LANGUAGE", self._language]
         if self._expander:
             args += ["EXPANDER", self._expander]
+        if self._dialect:
+            args += ["DIALECT", self._dialect]
 
         return args
 
@@ -288,6 +291,15 @@ def expander(self, expander):
         self._expander = expander
         return self
 
+    def dialect(self, dialect: int) -> "Query":
+        """
+        Add a dialect field to the query.
+
+        - **dialect** - dialect version to execute the query under
+        """
+        self._dialect = dialect
+        return self
+
 
 class Filter:
     def __init__(self, keyword, field, *args):
diff --git a/tests/test_search.py b/tests/test_search.py
index b94ae058b2..238e598db8 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1631,3 +1631,48 @@ def test_search_commands_in_pipeline(client):
     assert "foo baz" == res[3][2]
     assert res[3][5] is None
     assert res[3][3] == res[3][6] == ["txt", "foo bar"]
+
+
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+@skip_ifmodversion_lt("2.4.3", "search")
+def test_dialect_config(modclient: redis.Redis):
+    assert modclient.ft().config_get("DEFAULT_DIALECT") == {"DEFAULT_DIALECT": "1"}
+    assert modclient.ft().config_set("DEFAULT_DIALECT", 2)
+    assert modclient.ft().config_get("DEFAULT_DIALECT") == {"DEFAULT_DIALECT": "2"}
+    with pytest.raises(redis.ResponseError):
+        modclient.ft().config_set("DEFAULT_DIALECT", 0)
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+def test_dialect(modclient: redis.Redis):
+    modclient.ft().create_index(
+        (
+            TagField("title"),
+            TextField("t1"),
+            TextField("t2"),
+            NumericField("num"),
+            VectorField(
+                "v", "HNSW", {"TYPE": "FLOAT32", "DIM": 1, "DISTANCE_METRIC": "COSINE"}
+            ),
+        )
+    )
+    modclient.hset("h", "t1", "hello")
+    with pytest.raises(redis.ResponseError) as err:
+        modclient.ft().explain(Query("(*)").dialect(1))
+    assert "Syntax error" in str(err)
+    assert "WILDCARD" in modclient.ft().explain(Query("(*)").dialect(2))
+
+    with pytest.raises(redis.ResponseError) as err:
+        modclient.ft().explain(Query("$hello").dialect(1))
+    assert "Syntax error" in str(err)
+    q = Query("$hello").dialect(2)
+    expected = "UNION {\n  hello\n  +hello(expanded)\n}\n"
+    assert expected in modclient.ft().explain(q, query_params={"hello": "hello"})
+
+    expected = "NUMERIC {0.000000 <= @num <= 10.000000}\n"
+    assert expected in modclient.ft().explain(Query("@title:(@num:[0 10])").dialect(1))
+    with pytest.raises(redis.ResponseError) as err:
+        modclient.ft().explain(Query("@title:(@num:[0 10])").dialect(2))
+    assert "Syntax error" in str(err)

From ac483135d660b71ec18f2eb11af3d5932a8e7090 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 31 Mar 2022 12:17:29 +0300
Subject: [PATCH 0447/1164] Fix black (#2075)

* add click to dependencies

* typo
---
 dev_requirements.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev_requirements.txt b/dev_requirements.txt
index 0c4bee9f35..942edd6d0f 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -1,3 +1,4 @@
+click==8.0.4
 black==21.11b1
 flake8==4.0.1
 flynt~=0.69.0

From c7685a012cb684d2437806b23d493c2b173892f8 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 31 Mar 2022 12:34:03 +0300
Subject: [PATCH 0448/1164] v4.2.1 (#2074)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 0e7b1f5801..f91f26759b 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.2.0",
+    version="4.2.1",
     packages=find_packages(
         include=[
             "redis",

From 876cafc56ff465af5639a92ea18625f49de47563 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 31 Mar 2022 16:01:48 +0300
Subject: [PATCH 0449/1164] Fix search query with params tests (#2076)

---
 tests/test_search.py | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/tests/test_search.py b/tests/test_search.py
index 238e598db8..7f27fdb6ed 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1542,7 +1542,8 @@ def test_vector_field(modclient):
     modclient.hset("b", "v", "aaaabaaa")
     modclient.hset("c", "v", "aaaaabaa")
 
-    q = Query("*=>[KNN 2 @v $vec]").return_field("__v_score").sort_by("__v_score", True)
+    query = "*=>[KNN 2 @v $vec]"
+    q = Query(query).return_field("__v_score").sort_by("__v_score", True).dialect(2)
     res = modclient.ft().search(q, query_params={"vec": "aaaaaaaa"})
 
     assert "a" == res.docs[0].id
@@ -1572,7 +1573,7 @@ def test_text_params(modclient):
     modclient.ft().add_document("doc3", name="Carol")
 
     params_dict = {"name1": "Alice", "name2": "Bob"}
-    q = Query("@name:($name1 | $name2 )")
+    q = Query("@name:($name1 | $name2 )").dialect(2)
     res = modclient.ft().search(q, query_params=params_dict)
     assert 2 == res.total
     assert "doc1" == res.docs[0].id
@@ -1589,7 +1590,7 @@ def test_numeric_params(modclient):
     modclient.ft().add_document("doc3", numval=103)
 
     params_dict = {"min": 101, "max": 102}
-    q = Query("@numval:[$min $max]")
+    q = Query("@numval:[$min $max]").dialect(2)
     res = modclient.ft().search(q, query_params=params_dict)
 
     assert 2 == res.total
@@ -1607,7 +1608,7 @@ def test_geo_params(modclient):
     modclient.ft().add_document("doc3", g="29.68746, 34.94882")
 
     params_dict = {"lat": "34.95126", "lon": "29.69465", "radius": 1000, "units": "km"}
-    q = Query("@g:[$lon $lat $radius $units]")
+    q = Query("@g:[$lon $lat $radius $units]").dialect(2)
     res = modclient.ft().search(q, query_params=params_dict)
     assert 3 == res.total
     assert "doc1" == res.docs[0].id

From 17f1140506310748a4f8164259d73fd0a4d362d5 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 4 Apr 2022 12:32:48 +0300
Subject: [PATCH 0450/1164] Vector similarity search example (#2083)

* copy example

* fix
---
 docs/examples.rst                             |   1 +
 .../search_vector_similarity_examples.ipynb   | 107 ++++++++++++++++++
 2 files changed, 108 insertions(+)
 create mode 100644 docs/examples/search_vector_similarity_examples.ipynb

diff --git a/docs/examples.rst b/docs/examples.rst
index 6d659a0b75..be577c0696 100644
--- a/docs/examples.rst
+++ b/docs/examples.rst
@@ -10,3 +10,4 @@ Examples
    examples/asyncio_examples
    examples/search_json_examples
    examples/set_and_get_examples
+   examples/search_vector_similarity_examples
\ No newline at end of file
diff --git a/docs/examples/search_vector_similarity_examples.ipynb b/docs/examples/search_vector_similarity_examples.ipynb
new file mode 100644
index 0000000000..42c03f0c21
--- /dev/null
+++ b/docs/examples/search_vector_similarity_examples.ipynb
@@ -0,0 +1,107 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Vector Similarity\n",
+    "## Adding Vector Fields"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "b'OK'"
+      ]
+     },
+     "execution_count": 1,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "import redis\n",
+    "from redis.commands.search.field import VectorField\n",
+    "from redis.commands.search.query import Query\n",
+    "\n",
+    "r = redis.Redis(host='localhost', port=36379)\n",
+    "\n",
+    "schema = (VectorField(\"v\", \"HNSW\", {\"TYPE\": \"FLOAT32\", \"DIM\": 2, \"DISTANCE_METRIC\": \"L2\"}),)\n",
+    "r.ft().create_index(schema)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Searching"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Querying vector fields"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {
+    "pycharm": {
+     "name": "#%%\n"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "Result{2 total, docs: [Document {'id': 'a', 'payload': None, '__v_score': '0'}, Document {'id': 'b', 'payload': None, '__v_score': '3.09485009821e+26'}]}"
+      ]
+     },
+     "execution_count": 2,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "r.hset(\"a\", \"v\", \"aaaaaaaa\")\n",
+    "r.hset(\"b\", \"v\", \"aaaabaaa\")\n",
+    "r.hset(\"c\", \"v\", \"aaaaabaa\")\n",
+    "\n",
+    "q = Query(\"*=>[KNN 2 @v $vec]\").return_field(\"__v_score\")\n",
+    "r.ft().search(q, query_params={\"vec\": \"aaaaaaaa\"})"
+   ]
+  }
+ ],
+ "metadata": {
+  "interpreter": {
+   "hash": "d45c99ba0feda92868abafa8257cbb4709c97f1a0b5dc62bbeebdf89d4fad7fe"
+  },
+  "kernelspec": {
+   "display_name": "Python 3.8.12 64-bit ('venv': venv)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.9.2"
+  },
+  "orig_nbformat": 4
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

From d41f8aab791fe0d9a620f99ad0b277f5eed47c5f Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 4 Apr 2022 12:33:58 +0300
Subject: [PATCH 0451/1164] Clean up test supoort enterprise environments 
 (#2082)

* skip tests on enterprise

* delete dping implementation
---
 tests/conftest.py            |  6 +++---
 tests/test_cluster.py        | 27 +++++++++++++++++++++++++++
 tests/test_command_parser.py |  3 ++-
 tests/test_commands.py       | 35 +++++++++++++++++++++++++++++++++++
 tests/test_lock.py           |  2 +-
 tests/test_scripting.py      |  4 +++-
 tests/test_search.py         | 14 ++++++++++++--
 tox.ini                      |  1 +
 8 files changed, 84 insertions(+), 8 deletions(-)

diff --git a/tests/conftest.py b/tests/conftest.py
index 3b66adf46c..903e961b46 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -120,10 +120,10 @@ def pytest_addoption(parser):
 def _get_info(redis_url):
     client = redis.Redis.from_url(redis_url)
     info = client.info()
-    cmds = [command.upper() for command in client.command().keys()]
-    if "dping" in cmds:
+    try:
+        client.execute_command("DPING")
         info["enterprise"] = True
-    else:
+    except redis.ResponseError:
         info["enterprise"] = False
     client.connection_pool.disconnect()
     return info
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index ecc8624015..1ee5cdf450 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -629,6 +629,7 @@ def test_get_node_from_key(self, r):
             assert replica.server_type == REPLICA
             assert replica in slot_nodes
 
+    @skip_if_redis_enterprise()
     def test_not_require_full_coverage_cluster_down_error(self, r):
         """
         When require_full_coverage is set to False (default client config) and not
@@ -840,11 +841,13 @@ def test_cluster_pubsub_numsub(self, r):
         channels = [(b"foo", 1), (b"bar", 2), (b"baz", 3)]
         assert r.pubsub_numsub("foo", "bar", "baz", target_nodes="all") == channels
 
+    @skip_if_redis_enterprise()
     def test_cluster_myid(self, r):
         node = r.get_random_node()
         myid = r.cluster_myid(node)
         assert len(myid) == 40
 
+    @skip_if_redis_enterprise()
     def test_cluster_slots(self, r):
         mock_all_nodes_resp(r, default_cluster_slots)
         cluster_slots = r.cluster_slots()
@@ -853,17 +856,20 @@ def test_cluster_slots(self, r):
         assert cluster_slots.get((0, 8191)) is not None
         assert cluster_slots.get((0, 8191)).get("primary") == ("127.0.0.1", 7000)
 
+    @skip_if_redis_enterprise()
     def test_cluster_addslots(self, r):
         node = r.get_random_node()
         mock_node_resp(node, "OK")
         assert r.cluster_addslots(node, 1, 2, 3) is True
 
     @skip_if_server_version_lt("7.0.0")
+    @skip_if_redis_enterprise()
     def test_cluster_addslotsrange(self, r):
         node = r.get_random_node()
         mock_node_resp(node, "OK")
         assert r.cluster_addslotsrange(node, 1, 5)
 
+    @skip_if_redis_enterprise()
     def test_cluster_countkeysinslot(self, r):
         node = r.nodes_manager.get_node_from_slot(1)
         mock_node_resp(node, 2)
@@ -873,6 +879,7 @@ def test_cluster_count_failure_report(self, r):
         mock_all_nodes_resp(r, 0)
         assert r.cluster_count_failure_report("node_0") == 0
 
+    @skip_if_redis_enterprise()
     def test_cluster_delslots(self):
         cluster_slots = [
             [
@@ -897,12 +904,14 @@ def test_cluster_delslots(self):
         assert node1.redis_connection.connection.read_response.called
 
     @skip_if_server_version_lt("7.0.0")
+    @skip_if_redis_enterprise()
     def test_cluster_delslotsrange(self, r):
         node = r.get_random_node()
         mock_node_resp(node, "OK")
         r.cluster_addslots(node, 1, 2, 3, 4, 5)
         assert r.cluster_delslotsrange(1, 5)
 
+    @skip_if_redis_enterprise()
     def test_cluster_failover(self, r):
         node = r.get_random_node()
         mock_node_resp(node, "OK")
@@ -912,20 +921,24 @@ def test_cluster_failover(self, r):
         with pytest.raises(RedisError):
             r.cluster_failover(node, "FORCT")
 
+    @skip_if_redis_enterprise()
     def test_cluster_info(self, r):
         info = r.cluster_info()
         assert isinstance(info, dict)
         assert info["cluster_state"] == "ok"
 
+    @skip_if_redis_enterprise()
     def test_cluster_keyslot(self, r):
         mock_all_nodes_resp(r, 12182)
         assert r.cluster_keyslot("foo") == 12182
 
+    @skip_if_redis_enterprise()
     def test_cluster_meet(self, r):
         node = r.get_default_node()
         mock_node_resp(node, "OK")
         assert r.cluster_meet("127.0.0.1", 6379) is True
 
+    @skip_if_redis_enterprise()
     def test_cluster_nodes(self, r):
         response = (
             "c8253bae761cb1ecb2b61857d85dfe455a0fec8b 172.17.0.7:7006 "
@@ -954,6 +967,7 @@ def test_cluster_nodes(self, r):
             == "c8253bae761cb1ecb2b61857d85dfe455a0fec8b"
         )
 
+    @skip_if_redis_enterprise()
     def test_cluster_replicate(self, r):
         node = r.get_random_node()
         all_replicas = r.get_replicas()
@@ -966,6 +980,7 @@ def test_cluster_replicate(self, r):
         else:
             assert results is True
 
+    @skip_if_redis_enterprise()
     def test_cluster_reset(self, r):
         mock_all_nodes_resp(r, "OK")
         assert r.cluster_reset() is True
@@ -974,6 +989,7 @@ def test_cluster_reset(self, r):
         for res in all_results.values():
             assert res is True
 
+    @skip_if_redis_enterprise()
     def test_cluster_save_config(self, r):
         node = r.get_random_node()
         all_nodes = r.get_nodes()
@@ -983,6 +999,7 @@ def test_cluster_save_config(self, r):
         for res in all_results.values():
             assert res is True
 
+    @skip_if_redis_enterprise()
     def test_cluster_get_keys_in_slot(self, r):
         response = [b"{foo}1", b"{foo}2"]
         node = r.nodes_manager.get_node_from_slot(12182)
@@ -990,6 +1007,7 @@ def test_cluster_get_keys_in_slot(self, r):
         keys = r.cluster_get_keys_in_slot(12182, 4)
         assert keys == response
 
+    @skip_if_redis_enterprise()
     def test_cluster_set_config_epoch(self, r):
         mock_all_nodes_resp(r, "OK")
         assert r.cluster_set_config_epoch(3) is True
@@ -997,6 +1015,7 @@ def test_cluster_set_config_epoch(self, r):
         for res in all_results.values():
             assert res is True
 
+    @skip_if_redis_enterprise()
     def test_cluster_setslot(self, r):
         node = r.get_random_node()
         mock_node_resp(node, "OK")
@@ -1014,6 +1033,7 @@ def test_cluster_setslot_stable(self, r):
         assert r.cluster_setslot_stable(12182) is True
         assert node.redis_connection.connection.read_response.called
 
+    @skip_if_redis_enterprise()
     def test_cluster_replicas(self, r):
         response = [
             b"01eca22229cf3c652b6fca0d09ff6941e0d2e3 "
@@ -1045,6 +1065,7 @@ def test_cluster_links(self, r):
         for i in range(0, len(res) - 1, 2):
             assert res[i][3] == res[i + 1][3]
 
+    @skip_if_redis_enterprise()
     def test_readonly(self):
         r = get_mocked_redis_client(host=default_host, port=default_port)
         mock_all_nodes_resp(r, "OK")
@@ -1055,6 +1076,7 @@ def test_readonly(self):
         for replica in r.get_replicas():
             assert replica.redis_connection.connection.read_response.called
 
+    @skip_if_redis_enterprise()
     def test_readwrite(self):
         r = get_mocked_redis_client(host=default_host, port=default_port)
         mock_all_nodes_resp(r, "OK")
@@ -1065,6 +1087,7 @@ def test_readwrite(self):
         for replica in r.get_replicas():
             assert replica.redis_connection.connection.read_response.called
 
+    @skip_if_redis_enterprise()
     def test_bgsave(self, r):
         assert r.bgsave()
         sleep(0.3)
@@ -1149,10 +1172,12 @@ def test_memory_usage(self, r):
         assert isinstance(r.memory_usage("foo"), int)
 
     @skip_if_server_version_lt("4.0.0")
+    @skip_if_redis_enterprise()
     def test_memory_malloc_stats(self, r):
         assert r.memory_malloc_stats()
 
     @skip_if_server_version_lt("4.0.0")
+    @skip_if_redis_enterprise()
     def test_memory_stats(self, r):
         # put a key into the current db to make sure that "db.<current-db>"
         # has data
@@ -1174,6 +1199,7 @@ def test_memory_doctor(self, r):
         with pytest.raises(NotImplementedError):
             r.memory_doctor()
 
+    @skip_if_redis_enterprise()
     def test_lastsave(self, r):
         node = r.get_primaries()[0]
         assert isinstance(r.lastsave(target_nodes=node), datetime.datetime)
@@ -1216,6 +1242,7 @@ def test_client_pause(self, r):
             r.client_pause(timeout="not an integer", target_nodes=node)
 
     @skip_if_server_version_lt("6.2.0")
+    @skip_if_redis_enterprise()
     def test_client_unpause(self, r):
         assert r.client_unpause()
 
diff --git a/tests/test_command_parser.py b/tests/test_command_parser.py
index ab050a74e7..1457e27531 100644
--- a/tests/test_command_parser.py
+++ b/tests/test_command_parser.py
@@ -2,7 +2,7 @@
 
 from redis.commands import CommandsParser
 
-from .conftest import skip_if_server_version_lt
+from .conftest import skip_if_redis_enterprise, skip_if_server_version_lt
 
 
 class TestCommandsParser:
@@ -21,6 +21,7 @@ def test_get_keys_predetermined_key_location(self, r):
         assert commands_parser.get_keys(r, *args3) == ["foo", "bar", "foobar"]
 
     @pytest.mark.filterwarnings("ignore:ResponseError")
+    @skip_if_redis_enterprise()
     def test_get_moveable_keys(self, r):
         commands_parser = CommandsParser(r)
         args1 = [
diff --git a/tests/test_commands.py b/tests/test_commands.py
index de6bcead1c..a0d57f0441 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -65,6 +65,7 @@ def test_case_insensitive_command_names(self, r):
 
 
 class TestRedisCommands:
+    @skip_if_redis_enterprise()
     def test_auth(self, r, request):
         username = "redis-py-auth"
 
@@ -104,6 +105,7 @@ def test_acl_cat_with_category(self, r):
         assert "get" in commands
 
     @skip_if_server_version_lt("7.0.0")
+    @skip_if_redis_enterprise()
     def test_acl_dryrun(self, r):
         username = "redis-py-user"
         r.acl_setuser(
@@ -424,6 +426,7 @@ def test_client_id(self, r):
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.2.0")
+    @skip_if_redis_enterprise()
     def test_client_trackinginfo(self, r):
         res = r.client_trackinginfo()
         assert len(res) > 2
@@ -431,6 +434,7 @@ def test_client_trackinginfo(self, r):
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
+    @skip_if_redis_enterprise()
     def test_client_tracking(self, r, r2):
 
         # simple case
@@ -613,6 +617,7 @@ def test_client_pause(self, r):
             r.client_pause(timeout="not an integer")
 
     @skip_if_server_version_lt("6.2.0")
+    @skip_if_redis_enterprise()
     def test_client_pause_all(self, r, r2):
         assert r.client_pause(1, all=False)
         assert r2.set("foo", "bar")
@@ -682,6 +687,7 @@ def test_config_set(self, r):
         assert r.config_get()["timeout"] == "0"
 
     @skip_if_server_version_lt("6.0.0")
+    @skip_if_redis_enterprise()
     def test_failover(self, r):
         with pytest.raises(NotImplementedError):
             r.failover()
@@ -721,6 +727,7 @@ def test_lolwut(self, r):
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.2.0")
+    @skip_if_redis_enterprise()
     def test_reset(self, r):
         assert r.reset() == "RESET"
 
@@ -739,6 +746,7 @@ def test_quit(self, r):
         assert r.quit()
 
     @skip_if_server_version_lt("2.8.12")
+    @skip_if_redis_enterprise()
     @pytest.mark.onlynoncluster
     def test_role(self, r):
         assert r.role()[0] == b"master"
@@ -746,6 +754,7 @@ def test_role(self, r):
         assert isinstance(r.role()[2], list)
 
     @pytest.mark.onlynoncluster
+    @skip_if_redis_enterprise()
     def test_select(self, r):
         assert r.select(5)
         assert r.select(2)
@@ -1544,6 +1553,7 @@ def test_setrange(self, r):
 
     @skip_if_server_version_lt("6.0.0")
     @skip_if_server_version_gte("7.0.0")
+    @skip_if_redis_enterprise()
     def test_stralgo_lcs(self, r):
         key1 = "{foo}key1"
         key2 = "{foo}key2"
@@ -1577,6 +1587,7 @@ def test_stralgo_lcs(self, r):
 
     @skip_if_server_version_lt("6.0.0")
     @skip_if_server_version_gte("7.0.0")
+    @skip_if_redis_enterprise()
     def test_stralgo_negative(self, r):
         with pytest.raises(exceptions.DataError):
             r.stralgo("ISSUB", "value1", "value2")
@@ -2057,12 +2068,14 @@ def test_sunionstore(self, r):
         assert r.smembers("c") == {b"1", b"2", b"3"}
 
     @skip_if_server_version_lt("1.0.0")
+    @skip_if_redis_enterprise()
     def test_debug_segfault(self, r):
         with pytest.raises(NotImplementedError):
             r.debug_segfault()
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("3.2.0")
+    @skip_if_redis_enterprise()
     def test_script_debug(self, r):
         with pytest.raises(NotImplementedError):
             r.script_debug()
@@ -2928,64 +2941,79 @@ def test_sort_issue_924(self, r):
         r.execute_command("SORT", "issue#924")
 
     @pytest.mark.onlynoncluster
+    @skip_if_redis_enterprise()
     def test_cluster_addslots(self, mock_cluster_resp_ok):
         assert mock_cluster_resp_ok.cluster("ADDSLOTS", 1) is True
 
     @pytest.mark.onlynoncluster
+    @skip_if_redis_enterprise()
     def test_cluster_count_failure_reports(self, mock_cluster_resp_int):
         assert isinstance(
             mock_cluster_resp_int.cluster("COUNT-FAILURE-REPORTS", "node"), int
         )
 
     @pytest.mark.onlynoncluster
+    @skip_if_redis_enterprise()
     def test_cluster_countkeysinslot(self, mock_cluster_resp_int):
         assert isinstance(mock_cluster_resp_int.cluster("COUNTKEYSINSLOT", 2), int)
 
     @pytest.mark.onlynoncluster
+    @skip_if_redis_enterprise()
     def test_cluster_delslots(self, mock_cluster_resp_ok):
         assert mock_cluster_resp_ok.cluster("DELSLOTS", 1) is True
 
     @pytest.mark.onlynoncluster
+    @skip_if_redis_enterprise()
     def test_cluster_failover(self, mock_cluster_resp_ok):
         assert mock_cluster_resp_ok.cluster("FAILOVER", 1) is True
 
     @pytest.mark.onlynoncluster
+    @skip_if_redis_enterprise()
     def test_cluster_forget(self, mock_cluster_resp_ok):
         assert mock_cluster_resp_ok.cluster("FORGET", 1) is True
 
     @pytest.mark.onlynoncluster
+    @skip_if_redis_enterprise()
     def test_cluster_info(self, mock_cluster_resp_info):
         assert isinstance(mock_cluster_resp_info.cluster("info"), dict)
 
     @pytest.mark.onlynoncluster
+    @skip_if_redis_enterprise()
     def test_cluster_keyslot(self, mock_cluster_resp_int):
         assert isinstance(mock_cluster_resp_int.cluster("keyslot", "asdf"), int)
 
     @pytest.mark.onlynoncluster
+    @skip_if_redis_enterprise()
     def test_cluster_meet(self, mock_cluster_resp_ok):
         assert mock_cluster_resp_ok.cluster("meet", "ip", "port", 1) is True
 
     @pytest.mark.onlynoncluster
+    @skip_if_redis_enterprise()
     def test_cluster_nodes(self, mock_cluster_resp_nodes):
         assert isinstance(mock_cluster_resp_nodes.cluster("nodes"), dict)
 
     @pytest.mark.onlynoncluster
+    @skip_if_redis_enterprise()
     def test_cluster_replicate(self, mock_cluster_resp_ok):
         assert mock_cluster_resp_ok.cluster("replicate", "nodeid") is True
 
     @pytest.mark.onlynoncluster
+    @skip_if_redis_enterprise()
     def test_cluster_reset(self, mock_cluster_resp_ok):
         assert mock_cluster_resp_ok.cluster("reset", "hard") is True
 
     @pytest.mark.onlynoncluster
+    @skip_if_redis_enterprise()
     def test_cluster_saveconfig(self, mock_cluster_resp_ok):
         assert mock_cluster_resp_ok.cluster("saveconfig") is True
 
     @pytest.mark.onlynoncluster
+    @skip_if_redis_enterprise()
     def test_cluster_setslot(self, mock_cluster_resp_ok):
         assert mock_cluster_resp_ok.cluster("setslot", 1, "IMPORTING", "nodeid") is True
 
     @pytest.mark.onlynoncluster
+    @skip_if_redis_enterprise()
     def test_cluster_slaves(self, mock_cluster_resp_slaves):
         assert isinstance(mock_cluster_resp_slaves.cluster("slaves", "nodeid"), dict)
 
@@ -3003,6 +3031,7 @@ def test_readonly_invalid_cluster_state(self, r):
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("3.0.0")
+    @skip_if_redis_enterprise()
     def test_readonly(self, mock_cluster_resp_ok):
         assert mock_cluster_resp_ok.readonly() is True
 
@@ -4341,6 +4370,7 @@ def test_memory_doctor(self, r):
             r.memory_doctor()
 
     @skip_if_server_version_lt("4.0.0")
+    @skip_if_redis_enterprise()
     def test_memory_malloc_stats(self, r):
         if skip_if_redis_enterprise().args[0] is True:
             with pytest.raises(redis.exceptions.ResponseError):
@@ -4350,6 +4380,7 @@ def test_memory_malloc_stats(self, r):
         assert r.memory_malloc_stats()
 
     @skip_if_server_version_lt("4.0.0")
+    @skip_if_redis_enterprise()
     def test_memory_stats(self, r):
         # put a key into the current db to make sure that "db.<current-db>"
         # has data
@@ -4380,6 +4411,7 @@ def test_module_list(self, r):
             assert isinstance(x, dict)
 
     @skip_if_server_version_lt("2.8.13")
+    @skip_if_redis_enterprise()
     def test_command_count(self, r):
         res = r.command_count()
         assert isinstance(res, int)
@@ -4392,6 +4424,7 @@ def test_command_docs(self, r):
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.8.13")
+    @skip_if_redis_enterprise()
     def test_command_getkeys(self, r):
         res = r.command_getkeys("MSET", "a", "b", "c", "d", "e", "f")
         assert res == ["a", "c", "e"]
@@ -4483,6 +4516,7 @@ def test_replicaof(self, r):
 
     @pytest.mark.replica
     @skip_if_server_version_lt("2.8.0")
+    @skip_if_redis_enterprise()
     def test_sync(self, r):
         r2 = redis.Redis(port=6380, decode_responses=False)
         res = r2.sync()
@@ -4490,6 +4524,7 @@ def test_sync(self, r):
 
     @pytest.mark.replica
     @skip_if_server_version_lt("2.8.0")
+    @skip_if_redis_enterprise()
     def test_psync(self, r):
         r2 = redis.Redis(port=6380, decode_responses=False)
         res = r2.psync(r2.client_id(), 1)
diff --git a/tests/test_lock.py b/tests/test_lock.py
index 01ecb880b8..0a63f1e06c 100644
--- a/tests/test_lock.py
+++ b/tests/test_lock.py
@@ -100,7 +100,7 @@ def test_float_timeout(self, r):
     def test_blocking_timeout(self, r):
         lock1 = self.get_lock(r, "foo")
         assert lock1.acquire(blocking=False)
-        bt = 0.2
+        bt = 0.4
         sleep = 0.05
         lock2 = self.get_lock(r, "foo", sleep=sleep, blocking_timeout=bt)
         start = time.monotonic()
diff --git a/tests/test_scripting.py b/tests/test_scripting.py
index 8f6a24cdae..1ccd99a003 100644
--- a/tests/test_scripting.py
+++ b/tests/test_scripting.py
@@ -3,7 +3,7 @@
 import redis
 from redis import exceptions
 from redis.commands.core import Script
-from tests.conftest import skip_if_server_version_lt
+from tests.conftest import skip_if_redis_enterprise, skip_if_server_version_lt
 
 multiply_script = """
 local value = redis.call('GET', KEYS[1])
@@ -66,6 +66,7 @@ def test_eval_multiply(self, r):
         assert r.eval(multiply_script, 1, "a", 3) == 6
 
     @skip_if_server_version_lt("7.0.0")
+    @skip_if_redis_enterprise()
     @pytest.mark.onlynoncluster
     def test_eval_ro(self, r):
         r.set("a", "b")
@@ -155,6 +156,7 @@ def test_evalsha(self, r):
         assert r.evalsha(sha, 1, "a", 3) == 6
 
     @skip_if_server_version_lt("7.0.0")
+    @skip_if_redis_enterprise()
     @pytest.mark.onlynoncluster
     def test_evalsha_ro(self, r):
         r.set("a", "b")
diff --git a/tests/test_search.py b/tests/test_search.py
index 7f27fdb6ed..343ac0d540 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -24,7 +24,7 @@
 from redis.commands.search.result import Result
 from redis.commands.search.suggestion import Suggestion
 
-from .conftest import skip_ifmodversion_lt
+from .conftest import skip_if_redis_enterprise, skip_ifmodversion_lt
 
 WILL_PLAY_TEXT = os.path.abspath(
     os.path.join(os.path.dirname(__file__), "testdata", "will_play_text.csv.bz2")
@@ -389,6 +389,7 @@ def test_example(client):
 
 
 @pytest.mark.redismod
+@skip_if_redis_enterprise()
 def test_auto_complete(client):
     n = 0
     with open(TITLES_CSV) as f:
@@ -948,7 +949,8 @@ def test_aggregations_groupby(client):
 
     res = client.ft().aggregate(req).rows[0]
     assert res[1] == "redis"
-    assert res[3] == "7"  # (10+3+8)/3
+    index = res.index("__generated_aliasavgrandom_num")
+    assert res[index + 1] == "7"  # (10+3+8)/3
 
     req = aggregations.AggregateRequest("redis").group_by(
         "@parent",
@@ -1158,6 +1160,7 @@ def test_index_definition(client):
 
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
+@skip_if_redis_enterprise()
 def testExpire(client):
     client.ft().create_index((TextField("txt", sortable=True),), temporary=4)
     ttl = client.execute_command("ft.debug", "TTL", "idx")
@@ -1478,6 +1481,7 @@ def test_json_with_jsonpath(client):
 
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
+@skip_if_redis_enterprise()
 def test_profile(client):
     client.ft().create_index((TextField("t"),))
     client.ft().client.hset("1", "t", "hello")
@@ -1529,6 +1533,7 @@ def test_profile_limited(client):
 
 
 @pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
 def test_vector_field(modclient):
     modclient.flushdb()
     modclient.ft().create_index(
@@ -1551,6 +1556,7 @@ def test_vector_field(modclient):
 
 
 @pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
 def test_vector_field_error(modclient):
     modclient.flushdb()
 
@@ -1564,6 +1570,7 @@ def test_vector_field_error(modclient):
 
 
 @pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
 def test_text_params(modclient):
     modclient.flushdb()
     modclient.ft().create_index((TextField("name"),))
@@ -1581,6 +1588,7 @@ def test_text_params(modclient):
 
 
 @pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
 def test_numeric_params(modclient):
     modclient.flushdb()
     modclient.ft().create_index((NumericField("numval"),))
@@ -1599,6 +1607,7 @@ def test_numeric_params(modclient):
 
 
 @pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
 def test_geo_params(modclient):
 
     modclient.flushdb()
@@ -1617,6 +1626,7 @@ def test_geo_params(modclient):
 
 
 @pytest.mark.redismod
+@skip_if_redis_enterprise()
 def test_search_commands_in_pipeline(client):
     p = client.ft().pipeline()
     p.create_index((TextField("txt"),))
diff --git a/tox.ini b/tox.ini
index 1a3450bdaa..9ea8706f32 100644
--- a/tox.ini
+++ b/tox.ini
@@ -8,6 +8,7 @@ markers =
     ssl: marker for only the ssl tests
     replica: replica tests
     experimental: run only experimental tests
+    asyncio: marker for async tests
 
 [tox]
 minversion = 3.2.0

From 7b7c6c8867a66493c51ed6525c6a0863f437f530 Mon Sep 17 00:00:00 2001
From: Dustin Oprea <dustin@randomingenuity.com>
Date: Mon, 4 Apr 2022 05:35:12 -0400
Subject: [PATCH 0452/1164] commands/core.py: Clarify bit type (#2078)

Calling it 'boolean' is misleading in the context of Python.
---
 redis/commands/core.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index c367827359..55ec5ecd16 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1682,7 +1682,7 @@ def __getitem__(self, name: KeyT):
 
     def getbit(self, name: KeyT, offset: int) -> ResponseT:
         """
-        Returns a boolean indicating the value of ``offset`` in ``name``
+        Returns an integer indicating the value of ``offset`` in ``name``
 
         For more information check https://redis.io/commands/getbit
         """
@@ -2124,7 +2124,7 @@ def __setitem__(self, name: KeyT, value: EncodableT):
 
     def setbit(self, name: KeyT, offset: int, value: int) -> ResponseT:
         """
-        Flag the ``offset`` in ``name`` as ``value``. Returns a boolean
+        Flag the ``offset`` in ``name`` as ``value``. Returns an integer
         indicating the previous value of ``offset``.
 
         For more information check https://redis.io/commands/setbit

From d4fcd999b7206b7960f0aa01d8f5c71b699df491 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 4 Apr 2022 13:06:01 +0300
Subject: [PATCH 0453/1164] Add support for BIT|BYTE option (#2068)

* Add support for BIT|BYTE option

* linters
---
 redis/commands/core.py |  7 +++++++
 tests/test_commands.py | 18 ++++++++++++++++++
 2 files changed, 25 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 55ec5ecd16..e2d45fed54 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1363,6 +1363,7 @@ def bitcount(
         key: KeyT,
         start: Union[int, None] = None,
         end: Union[int, None] = None,
+        mode: Optional[str] = None,
     ) -> ResponseT:
         """
         Returns the count of set bits in the value of ``key``.  Optional
@@ -1376,6 +1377,8 @@ def bitcount(
             params.append(end)
         elif (start is not None and end is None) or (end is not None and start is None):
             raise DataError("Both start and end must be specified")
+        if mode is not None:
+            params.append(mode)
         return self.execute_command("BITCOUNT", *params)
 
     def bitfield(
@@ -1411,6 +1414,7 @@ def bitpos(
         bit: int,
         start: Union[int, None] = None,
         end: Union[int, None] = None,
+        mode: Optional[str] = None,
     ) -> ResponseT:
         """
         Return the position of the first bit set to 1 or 0 in a string.
@@ -1430,6 +1434,9 @@ def bitpos(
             params.append(end)
         elif start is None and end is not None:
             raise DataError("start argument is not set, " "when end is specified")
+
+        if mode is not None:
+            params.append(mode)
         return self.execute_command("BITPOS", *params)
 
     def copy(
diff --git a/tests/test_commands.py b/tests/test_commands.py
index a0d57f0441..de94539b82 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -863,6 +863,15 @@ def test_bitcount(self, r):
         assert r.bitcount("a", -2, -1) == 2
         assert r.bitcount("a", 1, 1) == 1
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_bitcount_mode(self, r):
+        r.set("mykey", "foobar")
+        assert r.bitcount("mykey") == 26
+        assert r.bitcount("mykey", 1, 1, "byte") == 6
+        assert r.bitcount("mykey", 5, 30, "bit") == 17
+        with pytest.raises(redis.ResponseError):
+            assert r.bitcount("mykey", 5, 30, "but")
+
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.6.0")
     def test_bitop_not_empty_string(self, r):
@@ -935,6 +944,15 @@ def test_bitpos_wrong_arguments(self, r):
         with pytest.raises(exceptions.RedisError):
             r.bitpos(key, 7) == 12
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_bitpos_mode(self, r):
+        r.set("mykey", b"\x00\xff\xf0")
+        assert r.bitpos("mykey", 1, 0) == 8
+        assert r.bitpos("mykey", 1, 2, -1, "byte") == 16
+        assert r.bitpos("mykey", 0, 7, 15, "bit") == 7
+        with pytest.raises(redis.ResponseError):
+            r.bitpos("mykey", 1, 7, 15, "bite")
+
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.2.0")
     def test_copy(self, r):

From 143107af05fec7d140a317230becc2b3d353335a Mon Sep 17 00:00:00 2001
From: Binbin <binloveplay1314@qq.com>
Date: Mon, 4 Apr 2022 18:06:20 +0800
Subject: [PATCH 0454/1164] Cluster commands linkdocs (#2069)

* Link documentation for all cluster commands

Added links to the documentation in the docstrings in redis/commands/cluster.py
Part of #1712

* copy stralgo comment from commands/core.py to commands/cluster.py

* fix linters

Co-authored-by: enjoy-binbin <binbin.zhu@tenclass.com>
Co-authored-by: Chayim I. Kirshen <c@kirshen.com>
Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/commands/cluster.py |  95 ++++++-
 redis/commands/core.py    | 516 +++++++++++++++++++-------------------
 2 files changed, 348 insertions(+), 263 deletions(-)

diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index c3d7bd6e49..e4628dbaa2 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -41,6 +41,8 @@ def mget_nonatomic(self, keys, *args):
         if keys belong to more than one slot.
 
         Returns a list of values ordered identically to ``keys``
+
+        For more information see https://redis.io/commands/mget
         """
 
         from redis.client import EMPTY_RESPONSE
@@ -77,6 +79,8 @@ def mset_nonatomic(self, mapping):
         Splits the keys into different slots and then calls MSET
         for the keys of every slot. This operation will not be atomic
         if keys belong to more than one slot.
+
+        For more information see https://redis.io/commands/mset
         """
 
         # Partition the keys by slot
@@ -115,6 +119,8 @@ def exists(self, *keys):
         Returns the number of ``names`` that exist in the
         whole cluster. The keys are first split up into slots
         and then an EXISTS command is sent for every slot
+
+        For more information see https://redis.io/commands/exists
         """
         return self._split_command_across_slots("EXISTS", *keys)
 
@@ -126,6 +132,8 @@ def delete(self, *keys):
 
         Non-existant keys are ignored.
         Returns the number of keys that were deleted.
+
+        For more information see https://redis.io/commands/del
         """
         return self._split_command_across_slots("DEL", *keys)
 
@@ -139,6 +147,8 @@ def touch(self, *keys):
 
         Non-existant keys are ignored.
         Returns the number of keys that were touched.
+
+        For more information see https://redis.io/commands/touch
         """
         return self._split_command_across_slots("TOUCH", *keys)
 
@@ -151,6 +161,8 @@ def unlink(self, *keys):
 
         Non-existant keys are ignored.
         Returns the number of keys that were unlinked.
+
+        For more information see https://redis.io/commands/unlink
         """
         return self._split_command_across_slots("UNLINK", *keys)
 
@@ -164,12 +176,27 @@ class ClusterManagementCommands(ManagementCommands):
     """
 
     def slaveof(self, *args, **kwargs):
+        """
+        Make the server a replica of another instance, or promote it as master.
+
+        For more information see https://redis.io/commands/slaveof
+        """
         raise RedisClusterException("SLAVEOF is not supported in cluster mode")
 
     def replicaof(self, *args, **kwargs):
+        """
+        Make the server a replica of another instance, or promote it as master.
+
+        For more information see https://redis.io/commands/replicaof
+        """
         raise RedisClusterException("REPLICAOF is not supported in cluster" " mode")
 
     def swapdb(self, *args, **kwargs):
+        """
+        Swaps two Redis databases.
+
+        For more information see https://redis.io/commands/swapdb
+        """
         raise RedisClusterException("SWAPDB is not supported in cluster" " mode")
 
 
@@ -193,6 +220,25 @@ def stralgo(
         withmatchlen=False,
         **kwargs,
     ):
+        """
+        Implements complex algorithms that operate on strings.
+        Right now the only algorithm implemented is the LCS algorithm
+        (longest common substring). However new algorithms could be
+        implemented in the future.
+
+        ``algo`` Right now must be LCS
+        ``value1`` and ``value2`` Can be two strings or two keys
+        ``specific_argument`` Specifying if the arguments to the algorithm
+        will be keys or strings. strings is the default.
+        ``len`` Returns just the len of the match.
+        ``idx`` Returns the match positions in each string.
+        ``minmatchlen`` Restrict the list of matches to the ones of a given
+        minimal length. Can be provided only when ``idx`` set to True.
+        ``withmatchlen`` Returns the matches with the len of the match.
+        Can be provided only when ``idx`` set to True.
+
+        For more information see https://redis.io/commands/stralgo
+        """
         target_nodes = kwargs.pop("target_nodes", None)
         if specific_argument == "strings" and target_nodes is None:
             target_nodes = "default-node"
@@ -292,6 +338,8 @@ def cluster_addslots(self, target_node, *slots):
 
         :target_node: 'ClusterNode'
             The node to execute the command on
+
+        For more information see https://redis.io/commands/cluster-addslots
         """
         return self.execute_command(
             "CLUSTER ADDSLOTS", *slots, target_nodes=target_node
@@ -307,7 +355,7 @@ def cluster_addslotsrange(self, target_node, *slots):
         :target_node: 'ClusterNode'
             The node to execute the command on
 
-        For more information check https://redis.io/commands/cluster-addslotsrange
+        For more information see https://redis.io/commands/cluster-addslotsrange
         """
         return self.execute_command(
             "CLUSTER ADDSLOTSRANGE", *slots, target_nodes=target_node
@@ -317,6 +365,8 @@ def cluster_countkeysinslot(self, slot_id):
         """
         Return the number of local keys in the specified hash slot
         Send to node based on specified slot_id
+
+        For more information see https://redis.io/commands/cluster-countkeysinslot
         """
         return self.execute_command("CLUSTER COUNTKEYSINSLOT", slot_id)
 
@@ -324,6 +374,8 @@ def cluster_count_failure_report(self, node_id):
         """
         Return the number of failure reports active for a given node
         Sends to a random node
+
+        For more information see https://redis.io/commands/cluster-count-failure-reports
         """
         return self.execute_command("CLUSTER COUNT-FAILURE-REPORTS", node_id)
 
@@ -333,6 +385,8 @@ def cluster_delslots(self, *slots):
         It determines by it self what node the slot is in and sends it there
 
         Returns a list of the results for each processed slot.
+
+        For more information see https://redis.io/commands/cluster-delslots
         """
         return [self.execute_command("CLUSTER DELSLOTS", slot) for slot in slots]
 
@@ -343,7 +397,7 @@ def cluster_delslotsrange(self, *slots):
         from the node, while CLUSTER DELSLOTSRANGE takes a list of slot ranges to remove
         from the node.
 
-        For more information check https://redis.io/commands/cluster-delslotsrange
+        For more information see https://redis.io/commands/cluster-delslotsrange
         """
         return self.execute_command("CLUSTER DELSLOTSRANGE", *slots)
 
@@ -354,6 +408,8 @@ def cluster_failover(self, target_node, option=None):
 
         :target_node: 'ClusterNode'
             The node to execute the command on
+
+        For more information see https://redis.io/commands/cluster-failover
         """
         if option:
             if option.upper() not in ["FORCE", "TAKEOVER"]:
@@ -372,6 +428,8 @@ def cluster_info(self, target_nodes=None):
         Provides info about Redis Cluster node state.
         The command will be sent to a random node in the cluster if no target
         node is specified.
+
+        For more information see https://redis.io/commands/cluster-info
         """
         return self.execute_command("CLUSTER INFO", target_nodes=target_nodes)
 
@@ -379,6 +437,8 @@ def cluster_keyslot(self, key):
         """
         Returns the hash slot of the specified key
         Sends to random node in the cluster
+
+        For more information see https://redis.io/commands/cluster-keyslot
         """
         return self.execute_command("CLUSTER KEYSLOT", key)
 
@@ -386,6 +446,8 @@ def cluster_meet(self, host, port, target_nodes=None):
         """
         Force a node cluster to handshake with another node.
         Sends to specified node.
+
+        For more information see https://redis.io/commands/cluster-meet
         """
         return self.execute_command(
             "CLUSTER MEET", host, port, target_nodes=target_nodes
@@ -393,15 +455,18 @@ def cluster_meet(self, host, port, target_nodes=None):
 
     def cluster_nodes(self):
         """
-        Force a node cluster to handshake with another node
-
+        Get Cluster config for the node.
         Sends to random node in the cluster
+
+        For more information see https://redis.io/commands/cluster-nodes
         """
         return self.execute_command("CLUSTER NODES")
 
     def cluster_replicate(self, target_nodes, node_id):
         """
         Reconfigure a node as a slave of the specified master node
+
+        For more information see https://redis.io/commands/cluster-replicate
         """
         return self.execute_command(
             "CLUSTER REPLICATE", node_id, target_nodes=target_nodes
@@ -413,6 +478,8 @@ def cluster_reset(self, soft=True, target_nodes=None):
 
         If 'soft' is True then it will send 'SOFT' argument
         If 'soft' is False then it will send 'HARD' argument
+
+        For more information see https://redis.io/commands/cluster-reset
         """
         return self.execute_command(
             "CLUSTER RESET", b"SOFT" if soft else b"HARD", target_nodes=target_nodes
@@ -421,18 +488,24 @@ def cluster_reset(self, soft=True, target_nodes=None):
     def cluster_save_config(self, target_nodes=None):
         """
         Forces the node to save cluster state on disk
+
+        For more information see https://redis.io/commands/cluster-saveconfig
         """
         return self.execute_command("CLUSTER SAVECONFIG", target_nodes=target_nodes)
 
     def cluster_get_keys_in_slot(self, slot, num_keys):
         """
         Returns the number of keys in the specified cluster slot
+
+        For more information see https://redis.io/commands/cluster-getkeysinslot
         """
         return self.execute_command("CLUSTER GETKEYSINSLOT", slot, num_keys)
 
     def cluster_set_config_epoch(self, epoch, target_nodes=None):
         """
         Set the configuration epoch in a new node
+
+        For more information see https://redis.io/commands/cluster-set-config-epoch
         """
         return self.execute_command(
             "CLUSTER SET-CONFIG-EPOCH", epoch, target_nodes=target_nodes
@@ -444,6 +517,8 @@ def cluster_setslot(self, target_node, node_id, slot_id, state):
 
         :target_node: 'ClusterNode'
             The node to execute the command on
+
+        For more information see https://redis.io/commands/cluster-setslot
         """
         if state.upper() in ("IMPORTING", "NODE", "MIGRATING"):
             return self.execute_command(
@@ -458,6 +533,8 @@ def cluster_setslot_stable(self, slot_id):
         """
         Clears migrating / importing state from the slot.
         It determines by it self what node the slot is in and sends it there.
+
+        For more information see https://redis.io/commands/cluster-setslot
         """
         return self.execute_command("CLUSTER SETSLOT", slot_id, "STABLE")
 
@@ -465,6 +542,8 @@ def cluster_replicas(self, node_id, target_nodes=None):
         """
         Provides a list of replica nodes replicating from the specified primary
         target node.
+
+        For more information see https://redis.io/commands/cluster-replicas
         """
         return self.execute_command(
             "CLUSTER REPLICAS", node_id, target_nodes=target_nodes
@@ -473,6 +552,8 @@ def cluster_replicas(self, node_id, target_nodes=None):
     def cluster_slots(self, target_nodes=None):
         """
         Get array of Cluster slot to node mappings
+
+        For more information see https://redis.io/commands/cluster-slots
         """
         return self.execute_command("CLUSTER SLOTS", target_nodes=target_nodes)
 
@@ -484,7 +565,7 @@ def cluster_links(self, target_node):
 
         This command outputs information of all such peer links as an array.
 
-        For more information check https://redis.io/commands/cluster-links
+        For more information see https://redis.io/commands/cluster-links
         """
         return self.execute_command("CLUSTER LINKS", target_nodes=target_node)
 
@@ -493,6 +574,8 @@ def readonly(self, target_nodes=None):
         Enables read queries.
         The command will be sent to the default cluster node if target_nodes is
         not specified.
+
+        For more information see https://redis.io/commands/readonly
         """
         if target_nodes == "replicas" or target_nodes == "all":
             # read_from_replicas will only be enabled if the READONLY command
@@ -505,6 +588,8 @@ def readwrite(self, target_nodes=None):
         Disables read queries.
         The command will be sent to the default cluster node if target_nodes is
         not specified.
+
+        For more information see https://redis.io/commands/readwrite
         """
         # Reset read from replicas flag
         self.read_from_replicas = False
diff --git a/redis/commands/core.py b/redis/commands/core.py
index e2d45fed54..606256a33c 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -66,7 +66,7 @@ def acl_cat(self, category: Union[str, None] = None, **kwargs) -> ResponseT:
         If ``category`` is supplied, returns a list of all commands within
         that category.
 
-        For more information check https://redis.io/commands/acl-cat
+        For more information see https://redis.io/commands/acl-cat
         """
         pieces: list[EncodableT] = [category] if category else []
         return self.execute_command("ACL CAT", *pieces, **kwargs)
@@ -75,7 +75,7 @@ def acl_dryrun(self, username, *args, **kwargs):
         """
         Simulate the execution of a given command by a given ``username``.
 
-        For more information check https://redis.io/commands/acl-dryrun
+        For more information see https://redis.io/commands/acl-dryrun
         """
         return self.execute_command("ACL DRYRUN", username, *args, **kwargs)
 
@@ -83,7 +83,7 @@ def acl_deluser(self, *username: str, **kwargs) -> ResponseT:
         """
         Delete the ACL for the specified ``username``s
 
-        For more information check https://redis.io/commands/acl-deluser
+        For more information see https://redis.io/commands/acl-deluser
         """
         return self.execute_command("ACL DELUSER", *username, **kwargs)
 
@@ -111,7 +111,7 @@ def acl_getuser(self, username: str, **kwargs) -> ResponseT:
 
         If ``username`` does not exist, return None
 
-        For more information check https://redis.io/commands/acl-getuser
+        For more information see https://redis.io/commands/acl-getuser
         """
         return self.execute_command("ACL GETUSER", username, **kwargs)
 
@@ -119,7 +119,7 @@ def acl_help(self, **kwargs) -> ResponseT:
         """The ACL HELP command returns helpful text describing
         the different subcommands.
 
-        For more information check https://redis.io/commands/acl-help
+        For more information see https://redis.io/commands/acl-help
         """
         return self.execute_command("ACL HELP", **kwargs)
 
@@ -127,7 +127,7 @@ def acl_list(self, **kwargs) -> ResponseT:
         """
         Return a list of all ACLs on the server
 
-        For more information check https://redis.io/commands/acl-list
+        For more information see https://redis.io/commands/acl-list
         """
         return self.execute_command("ACL LIST", **kwargs)
 
@@ -137,7 +137,7 @@ def acl_log(self, count: Union[int, None] = None, **kwargs) -> ResponseT:
         :param int count: Get logs[0:count].
         :rtype: List.
 
-        For more information check https://redis.io/commands/acl-log
+        For more information see https://redis.io/commands/acl-log
         """
         args = []
         if count is not None:
@@ -152,7 +152,7 @@ def acl_log_reset(self, **kwargs) -> ResponseT:
         Reset ACL logs.
         :rtype: Boolean.
 
-        For more information check https://redis.io/commands/acl-log
+        For more information see https://redis.io/commands/acl-log
         """
         args = [b"RESET"]
         return self.execute_command("ACL LOG", *args, **kwargs)
@@ -164,7 +164,7 @@ def acl_load(self, **kwargs) -> ResponseT:
         Note that the server must be configured with the ``aclfile``
         directive to be able to load ACL rules from an aclfile.
 
-        For more information check https://redis.io/commands/acl-load
+        For more information see https://redis.io/commands/acl-load
         """
         return self.execute_command("ACL LOAD", **kwargs)
 
@@ -175,7 +175,7 @@ def acl_save(self, **kwargs) -> ResponseT:
         Note that the server must be configured with the ``aclfile``
         directive to be able to save ACL rules to an aclfile.
 
-        For more information check https://redis.io/commands/acl-save
+        For more information see https://redis.io/commands/acl-save
         """
         return self.execute_command("ACL SAVE", **kwargs)
 
@@ -253,7 +253,7 @@ def acl_setuser(
         and 'nopass' status will be kept and any new specified passwords
         or hashed_passwords will be applied on top.
 
-        For more information check https://redis.io/commands/acl-setuser
+        For more information see https://redis.io/commands/acl-setuser
         """
         encoder = self.get_encoder()
         pieces: list[str | bytes] = [username]
@@ -349,14 +349,14 @@ def acl_setuser(
     def acl_users(self, **kwargs) -> ResponseT:
         """Returns a list of all registered users on the server.
 
-        For more information check https://redis.io/commands/acl-users
+        For more information see https://redis.io/commands/acl-users
         """
         return self.execute_command("ACL USERS", **kwargs)
 
     def acl_whoami(self, **kwargs) -> ResponseT:
         """Get the username for the current connection
 
-        For more information check https://redis.io/commands/acl-whoami
+        For more information see https://redis.io/commands/acl-whoami
         """
         return self.execute_command("ACL WHOAMI", **kwargs)
 
@@ -374,7 +374,7 @@ def auth(self, password, username=None, **kwargs):
         Authenticates the user. If you do not pass username, Redis will try to
         authenticate for the "default" user. If you do pass username, it will
         authenticate for the given user.
-        For more information check https://redis.io/commands/auth
+        For more information see https://redis.io/commands/auth
         """
         if username:
             return self.execute_command("AUTH", username, password, **kwargs)
@@ -383,7 +383,7 @@ def auth(self, password, username=None, **kwargs):
     def bgrewriteaof(self, **kwargs):
         """Tell the Redis server to rewrite the AOF file from data in memory.
 
-        For more information check https://redis.io/commands/bgrewriteaof
+        For more information see https://redis.io/commands/bgrewriteaof
         """
         return self.execute_command("BGREWRITEAOF", **kwargs)
 
@@ -392,7 +392,7 @@ def bgsave(self, schedule: bool = True, **kwargs) -> ResponseT:
         Tell the Redis server to save its data to disk.  Unlike save(),
         this method is asynchronous and returns immediately.
 
-        For more information check https://redis.io/commands/bgsave
+        For more information see https://redis.io/commands/bgsave
         """
         pieces = []
         if schedule:
@@ -405,14 +405,14 @@ def role(self) -> ResponseT:
         the context of replication, by returning if the instance
         is currently a master, slave, or sentinel.
 
-        For more information check https://redis.io/commands/role
+        For more information see https://redis.io/commands/role
         """
         return self.execute_command("ROLE")
 
     def client_kill(self, address: str, **kwargs) -> ResponseT:
         """Disconnects the client at ``address`` (ip:port)
 
-        For more information check https://redis.io/commands/client-kill
+        For more information see https://redis.io/commands/client-kill
         """
         return self.execute_command("CLIENT KILL", address, **kwargs)
 
@@ -471,7 +471,7 @@ def client_info(self, **kwargs) -> ResponseT:
         Returns information and statistics about the current
         client connection.
 
-        For more information check https://redis.io/commands/client-info
+        For more information see https://redis.io/commands/client-info
         """
         return self.execute_command("CLIENT INFO", **kwargs)
 
@@ -488,7 +488,7 @@ def client_list(
          replica, pubsub)
         :param client_id: optional. a list of client ids
 
-        For more information check https://redis.io/commands/client-list
+        For more information see https://redis.io/commands/client-list
         """
         args = []
         if _type is not None:
@@ -508,7 +508,7 @@ def client_getname(self, **kwargs) -> ResponseT:
         """
         Returns the current connection name
 
-        For more information check https://redis.io/commands/client-getname
+        For more information see https://redis.io/commands/client-getname
         """
         return self.execute_command("CLIENT GETNAME", **kwargs)
 
@@ -550,7 +550,7 @@ def client_id(self, **kwargs) -> ResponseT:
         """
         Returns the current connection id
 
-        For more information check https://redis.io/commands/client-id
+        For more information see https://redis.io/commands/client-id
         """
         return self.execute_command("CLIENT ID", **kwargs)
 
@@ -665,7 +665,7 @@ def client_setname(self, name: str, **kwargs) -> ResponseT:
         """
         Sets the current connection name
 
-        For more information check https://redis.io/commands/client-setname
+        For more information see https://redis.io/commands/client-setname
         """
         return self.execute_command("CLIENT SETNAME", name, **kwargs)
 
@@ -681,7 +681,7 @@ def client_unblock(
         If ``error`` is False (default), the client is unblocked using the
         regular timeout mechanism.
 
-        For more information check https://redis.io/commands/client-unblock
+        For more information see https://redis.io/commands/client-unblock
         """
         args = ["CLIENT UNBLOCK", int(client_id)]
         if error:
@@ -693,7 +693,7 @@ def client_pause(self, timeout: int, all: bool = True, **kwargs) -> ResponseT:
         Suspend all the Redis clients for the specified amount of time
         :param timeout: milliseconds to pause clients
 
-        For more information check https://redis.io/commands/client-pause
+        For more information see https://redis.io/commands/client-pause
         :param all: If true (default) all client commands are blocked.
              otherwise, clients are only blocked if they attempt to execute
              a write command.
@@ -715,7 +715,7 @@ def client_unpause(self, **kwargs) -> ResponseT:
         """
         Unpause all redis clients
 
-        For more information check https://redis.io/commands/client-unpause
+        For more information see https://redis.io/commands/client-unpause
         """
         return self.execute_command("CLIENT UNPAUSE", **kwargs)
 
@@ -723,7 +723,7 @@ def client_no_evict(self, mode: str) -> Union[Awaitable[str], str]:
         """
         Sets the client eviction mode for the current connection.
 
-        For more information check https://redis.io/commands/client-no-evict
+        For more information see https://redis.io/commands/client-no-evict
         """
         return self.execute_command("CLIENT NO-EVICT", mode)
 
@@ -731,7 +731,7 @@ def command(self, **kwargs):
         """
         Returns dict reply of details about all Redis commands.
 
-        For more information check https://redis.io/commands/command
+        For more information see https://redis.io/commands/command
         """
         return self.execute_command("COMMAND", **kwargs)
 
@@ -756,14 +756,14 @@ def config_get(self, pattern: PatternT = "*", **kwargs) -> ResponseT:
         """
         Return a dictionary of configuration based on the ``pattern``
 
-        For more information check https://redis.io/commands/config-get
+        For more information see https://redis.io/commands/config-get
         """
         return self.execute_command("CONFIG GET", pattern, **kwargs)
 
     def config_set(self, name: KeyT, value: EncodableT, **kwargs) -> ResponseT:
         """Set config item ``name`` with ``value``
 
-        For more information check https://redis.io/commands/config-set
+        For more information see https://redis.io/commands/config-set
         """
         return self.execute_command("CONFIG SET", name, value, **kwargs)
 
@@ -771,7 +771,7 @@ def config_resetstat(self, **kwargs) -> ResponseT:
         """
         Reset runtime statistics
 
-        For more information check https://redis.io/commands/config-resetstat
+        For more information see https://redis.io/commands/config-resetstat
         """
         return self.execute_command("CONFIG RESETSTAT", **kwargs)
 
@@ -779,7 +779,7 @@ def config_rewrite(self, **kwargs) -> ResponseT:
         """
         Rewrite config file with the minimal change to reflect running config.
 
-        For more information check https://redis.io/commands/config-rewrite
+        For more information see https://redis.io/commands/config-rewrite
         """
         return self.execute_command("CONFIG REWRITE", **kwargs)
 
@@ -787,7 +787,7 @@ def dbsize(self, **kwargs) -> ResponseT:
         """
         Returns the number of keys in the current database
 
-        For more information check https://redis.io/commands/dbsize
+        For more information see https://redis.io/commands/dbsize
         """
         return self.execute_command("DBSIZE", **kwargs)
 
@@ -795,7 +795,7 @@ def debug_object(self, key: KeyT, **kwargs) -> ResponseT:
         """
         Returns version specific meta information about a given key
 
-        For more information check https://redis.io/commands/debug-object
+        For more information see https://redis.io/commands/debug-object
         """
         return self.execute_command("DEBUG OBJECT", key, **kwargs)
 
@@ -804,7 +804,7 @@ def debug_segfault(self, **kwargs) -> None:
             """
             DEBUG SEGFAULT is intentionally not implemented in the client.
 
-            For more information check https://redis.io/commands/debug-segfault
+            For more information see https://redis.io/commands/debug-segfault
             """
         )
 
@@ -812,7 +812,7 @@ def echo(self, value: EncodableT, **kwargs) -> ResponseT:
         """
         Echo the string back from the server
 
-        For more information check https://redis.io/commands/echo
+        For more information see https://redis.io/commands/echo
         """
         return self.execute_command("ECHO", value, **kwargs)
 
@@ -823,7 +823,7 @@ def flushall(self, asynchronous: bool = False, **kwargs) -> ResponseT:
         ``asynchronous`` indicates whether the operation is
         executed asynchronously by the server.
 
-        For more information check https://redis.io/commands/flushall
+        For more information see https://redis.io/commands/flushall
         """
         args = []
         if asynchronous:
@@ -837,7 +837,7 @@ def flushdb(self, asynchronous: bool = False, **kwargs) -> ResponseT:
         ``asynchronous`` indicates whether the operation is
         executed asynchronously by the server.
 
-        For more information check https://redis.io/commands/flushdb
+        For more information see https://redis.io/commands/flushdb
         """
         args = []
         if asynchronous:
@@ -848,7 +848,7 @@ def sync(self) -> ResponseT:
         """
         Initiates a replication stream from the master.
 
-        For more information check https://redis.io/commands/sync
+        For more information see https://redis.io/commands/sync
         """
         from redis.client import NEVER_DECODE
 
@@ -861,7 +861,7 @@ def psync(self, replicationid: str, offset: int):
         Initiates a replication stream from the master.
         Newer version for `sync`.
 
-        For more information check https://redis.io/commands/sync
+        For more information see https://redis.io/commands/sync
         """
         from redis.client import NEVER_DECODE
 
@@ -873,7 +873,7 @@ def swapdb(self, first: int, second: int, **kwargs) -> ResponseT:
         """
         Swap two databases
 
-        For more information check https://redis.io/commands/swapdb
+        For more information see https://redis.io/commands/swapdb
         """
         return self.execute_command("SWAPDB", first, second, **kwargs)
 
@@ -894,7 +894,7 @@ def info(self, section: Union[str, None] = None, **kwargs) -> ResponseT:
         The section option is not supported by older versions of Redis Server,
         and will generate ResponseError
 
-        For more information check https://redis.io/commands/info
+        For more information see https://redis.io/commands/info
         """
         if section is None:
             return self.execute_command("INFO", **kwargs)
@@ -906,7 +906,7 @@ def lastsave(self, **kwargs) -> ResponseT:
         Return a Python datetime object representing the last time the
         Redis database was saved to disk
 
-        For more information check https://redis.io/commands/lastsave
+        For more information see https://redis.io/commands/lastsave
         """
         return self.execute_command("LASTSAVE", **kwargs)
 
@@ -957,7 +957,7 @@ def migrate(
         If ``auth`` is specified, authenticate to the destination server with
         the password provided.
 
-        For more information check https://redis.io/commands/migrate
+        For more information see https://redis.io/commands/migrate
         """
         keys = list_or_args(keys, [])
         if not keys:
@@ -989,7 +989,7 @@ def memory_doctor(self, **kwargs) -> None:
             """
             MEMORY DOCTOR is intentionally not implemented in the client.
 
-            For more information check https://redis.io/commands/memory-doctor
+            For more information see https://redis.io/commands/memory-doctor
             """
         )
 
@@ -998,7 +998,7 @@ def memory_help(self, **kwargs) -> None:
             """
             MEMORY HELP is intentionally not implemented in the client.
 
-            For more information check https://redis.io/commands/memory-help
+            For more information see https://redis.io/commands/memory-help
             """
         )
 
@@ -1006,7 +1006,7 @@ def memory_stats(self, **kwargs) -> ResponseT:
         """
         Return a dictionary of memory stats
 
-        For more information check https://redis.io/commands/memory-stats
+        For more information see https://redis.io/commands/memory-stats
         """
         return self.execute_command("MEMORY STATS", **kwargs)
 
@@ -1029,7 +1029,7 @@ def memory_usage(
         sample. If left unspecified, the server's default is 5. Use 0 to sample
         all elements.
 
-        For more information check https://redis.io/commands/memory-usage
+        For more information see https://redis.io/commands/memory-usage
         """
         args = []
         if isinstance(samples, int):
@@ -1040,7 +1040,7 @@ def memory_purge(self, **kwargs) -> ResponseT:
         """
         Attempts to purge dirty pages for reclamation by allocator
 
-        For more information check https://redis.io/commands/memory-purge
+        For more information see https://redis.io/commands/memory-purge
         """
         return self.execute_command("MEMORY PURGE", **kwargs)
 
@@ -1048,7 +1048,7 @@ def ping(self, **kwargs) -> ResponseT:
         """
         Ping the Redis server
 
-        For more information check https://redis.io/commands/ping
+        For more information see https://redis.io/commands/ping
         """
         return self.execute_command("PING", **kwargs)
 
@@ -1056,7 +1056,7 @@ def quit(self, **kwargs) -> ResponseT:
         """
         Ask the server to close the connection.
 
-        For more information check https://redis.io/commands/quit
+        For more information see https://redis.io/commands/quit
         """
         return self.execute_command("QUIT", **kwargs)
 
@@ -1067,7 +1067,7 @@ def replicaof(self, *args, **kwargs) -> ResponseT:
             NO ONE (set no replication)
             host port (set to the host and port of a redis server)
 
-        For more information check  https://redis.io/commands/replicaof
+        For more information see  https://redis.io/commands/replicaof
         """
         return self.execute_command("REPLICAOF", *args, **kwargs)
 
@@ -1076,7 +1076,7 @@ def save(self, **kwargs) -> ResponseT:
         Tell the Redis server to save its data to disk,
         blocking until the save is complete
 
-        For more information check https://redis.io/commands/save
+        For more information see https://redis.io/commands/save
         """
         return self.execute_command("SAVE", **kwargs)
 
@@ -1087,7 +1087,7 @@ def shutdown(self, save: bool = False, nosave: bool = False, **kwargs) -> None:
         configured.  If the "nosave" option is set, no data flush will be
         attempted.  The "save" and "nosave" options cannot both be set.
 
-        For more information check https://redis.io/commands/shutdown
+        For more information see https://redis.io/commands/shutdown
         """
         if save and nosave:
             raise DataError("SHUTDOWN save and nosave cannot both be set")
@@ -1111,7 +1111,7 @@ def slaveof(
         by the ``host`` and ``port``. If called without arguments, the
         instance is promoted to a master instead.
 
-        For more information check https://redis.io/commands/slaveof
+        For more information see https://redis.io/commands/slaveof
         """
         if host is None and port is None:
             return self.execute_command("SLAVEOF", b"NO", b"ONE", **kwargs)
@@ -1122,7 +1122,7 @@ def slowlog_get(self, num: Union[int, None] = None, **kwargs) -> ResponseT:
         Get the entries from the slowlog. If ``num`` is specified, get the
         most recent ``num`` items.
 
-        For more information check https://redis.io/commands/slowlog-get
+        For more information see https://redis.io/commands/slowlog-get
         """
         from redis.client import NEVER_DECODE
 
@@ -1138,7 +1138,7 @@ def slowlog_len(self, **kwargs) -> ResponseT:
         """
         Get the number of items in the slowlog
 
-        For more information check https://redis.io/commands/slowlog-len
+        For more information see https://redis.io/commands/slowlog-len
         """
         return self.execute_command("SLOWLOG LEN", **kwargs)
 
@@ -1146,7 +1146,7 @@ def slowlog_reset(self, **kwargs) -> ResponseT:
         """
         Remove all items in the slowlog
 
-        For more information check https://redis.io/commands/slowlog-reset
+        For more information see https://redis.io/commands/slowlog-reset
         """
         return self.execute_command("SLOWLOG RESET", **kwargs)
 
@@ -1155,7 +1155,7 @@ def time(self, **kwargs) -> ResponseT:
         Returns the server time as a 2-item tuple of ints:
         (seconds since epoch, microseconds into this second).
 
-        For more information check https://redis.io/commands/time
+        For more information see https://redis.io/commands/time
         """
         return self.execute_command("TIME", **kwargs)
 
@@ -1166,7 +1166,7 @@ def wait(self, num_replicas: int, timeout: int, **kwargs) -> ResponseT:
         we finally have at least ``num_replicas``, or when the ``timeout`` was
         reached.
 
-        For more information check https://redis.io/commands/wait
+        For more information see https://redis.io/commands/wait
         """
         return self.execute_command("WAIT", num_replicas, timeout, **kwargs)
 
@@ -1214,7 +1214,7 @@ async def shutdown(
         configured.  If the "nosave" option is set, no data flush will be
         attempted.  The "save" and "nosave" options cannot both be set.
 
-        For more information check https://redis.io/commands/shutdown
+        For more information see https://redis.io/commands/shutdown
         """
         if save and nosave:
             raise DataError("SHUTDOWN save and nosave cannot both be set")
@@ -1354,7 +1354,7 @@ def append(self, key: KeyT, value: EncodableT) -> ResponseT:
         doesn't already exist, create it with a value of ``value``.
         Returns the new length of the value at ``key``.
 
-        For more information check https://redis.io/commands/append
+        For more information see https://redis.io/commands/append
         """
         return self.execute_command("APPEND", key, value)
 
@@ -1369,7 +1369,7 @@ def bitcount(
         Returns the count of set bits in the value of ``key``.  Optional
         ``start`` and ``end`` parameters indicate which bytes to consider
 
-        For more information check https://redis.io/commands/bitcount
+        For more information see https://redis.io/commands/bitcount
         """
         params = [key]
         if start is not None and end is not None:
@@ -1390,7 +1390,7 @@ def bitfield(
         Return a BitFieldOperation instance to conveniently construct one or
         more bitfield operations on ``key``.
 
-        For more information check https://redis.io/commands/bitfield
+        For more information see https://redis.io/commands/bitfield
         """
         return BitFieldOperation(self, key, default_overflow=default_overflow)
 
@@ -1404,7 +1404,7 @@ def bitop(
         Perform a bitwise operation using ``operation`` between ``keys`` and
         store the result in ``dest``.
 
-        For more information check https://redis.io/commands/bitop
+        For more information see https://redis.io/commands/bitop
         """
         return self.execute_command("BITOP", operation, dest, *keys)
 
@@ -1422,7 +1422,7 @@ def bitpos(
         as a range of bytes and not a range of bits, so start=0 and end=2
         means to look at the first three bytes.
 
-        For more information check https://redis.io/commands/bitpos
+        For more information see https://redis.io/commands/bitpos
         """
         if bit not in (0, 1):
             raise DataError("bit must be 0 or 1")
@@ -1456,7 +1456,7 @@ def copy(
         copying the value to it. By default, the value is not copied if
         the ``destination`` key already exists.
 
-        For more information check https://redis.io/commands/copy
+        For more information see https://redis.io/commands/copy
         """
         params = [source, destination]
         if destination_db is not None:
@@ -1470,7 +1470,7 @@ def decrby(self, name: KeyT, amount: int = 1) -> ResponseT:
         Decrements the value of ``key`` by ``amount``.  If no key exists,
         the value will be initialized as 0 - ``amount``
 
-        For more information check https://redis.io/commands/decrby
+        For more information see https://redis.io/commands/decrby
         """
         return self.execute_command("DECRBY", name, amount)
 
@@ -1490,7 +1490,7 @@ def dump(self, name: KeyT) -> ResponseT:
         Return a serialized version of the value stored at the specified key.
         If key does not exist a nil bulk reply is returned.
 
-        For more information check https://redis.io/commands/dump
+        For more information see https://redis.io/commands/dump
         """
         from redis.client import NEVER_DECODE
 
@@ -1502,7 +1502,7 @@ def exists(self, *names: KeyT) -> ResponseT:
         """
         Returns the number of ``names`` that exist
 
-        For more information check https://redis.io/commands/exists
+        For more information see https://redis.io/commands/exists
         """
         return self.execute_command("EXISTS", *names)
 
@@ -1528,7 +1528,7 @@ def expire(
             GT -> Set expiry only when the new expiry is greater than current one
             LT -> Set expiry only when the new expiry is less than current one
 
-        For more information check https://redis.io/commands/expire
+        For more information see https://redis.io/commands/expire
         """
         if isinstance(time, datetime.timedelta):
             time = int(time.total_seconds())
@@ -1565,7 +1565,7 @@ def expireat(
             -> GT -- Set expiry only when the new expiry is greater than current one
             -> LT -- Set expiry only when the new expiry is less than current one
 
-        For more information check https://redis.io/commands/expireat
+        For more information see https://redis.io/commands/expireat
         """
         if isinstance(when, datetime.datetime):
             when = int(time.mktime(when.timetuple()))
@@ -1587,7 +1587,7 @@ def expiretime(self, key: str) -> int:
         Returns the absolute Unix timestamp (since January 1, 1970) in seconds
         at which the given key will expire.
 
-        For more information check https://redis.io/commands/expiretime
+        For more information see https://redis.io/commands/expiretime
         """
         return self.execute_command("EXPIRETIME", key)
 
@@ -1595,7 +1595,7 @@ def get(self, name: KeyT) -> ResponseT:
         """
         Return the value at key ``name``, or None if the key doesn't exist
 
-        For more information check https://redis.io/commands/get
+        For more information see https://redis.io/commands/get
         """
         return self.execute_command("GET", name)
 
@@ -1606,7 +1606,7 @@ def getdel(self, name: KeyT) -> ResponseT:
         the key on success (if and only if the key's value type
         is a string).
 
-        For more information check https://redis.io/commands/getdel
+        For more information see https://redis.io/commands/getdel
         """
         return self.execute_command("GETDEL", name)
 
@@ -1637,7 +1637,7 @@ def getex(
 
         ``persist`` remove the time to live associated with ``name``.
 
-        For more information check https://redis.io/commands/getex
+        For more information see https://redis.io/commands/getex
         """
 
         opset = {ex, px, exat, pxat}
@@ -1691,7 +1691,7 @@ def getbit(self, name: KeyT, offset: int) -> ResponseT:
         """
         Returns an integer indicating the value of ``offset`` in ``name``
 
-        For more information check https://redis.io/commands/getbit
+        For more information see https://redis.io/commands/getbit
         """
         return self.execute_command("GETBIT", name, offset)
 
@@ -1700,7 +1700,7 @@ def getrange(self, key: KeyT, start: int, end: int) -> ResponseT:
         Returns the substring of the string value stored at ``key``,
         determined by the offsets ``start`` and ``end`` (both are inclusive)
 
-        For more information check https://redis.io/commands/getrange
+        For more information see https://redis.io/commands/getrange
         """
         return self.execute_command("GETRANGE", key, start, end)
 
@@ -1712,7 +1712,7 @@ def getset(self, name: KeyT, value: EncodableT) -> ResponseT:
         As per Redis 6.2, GETSET is considered deprecated.
         Please use SET with GET parameter in new code.
 
-        For more information check https://redis.io/commands/getset
+        For more information see https://redis.io/commands/getset
         """
         return self.execute_command("GETSET", name, value)
 
@@ -1721,7 +1721,7 @@ def incrby(self, name: KeyT, amount: int = 1) -> ResponseT:
         Increments the value of ``key`` by ``amount``.  If no key exists,
         the value will be initialized as ``amount``
 
-        For more information check https://redis.io/commands/incrby
+        For more information see https://redis.io/commands/incrby
         """
         return self.execute_command("INCRBY", name, amount)
 
@@ -1732,7 +1732,7 @@ def incrbyfloat(self, name: KeyT, amount: float = 1.0) -> ResponseT:
         Increments the value at key ``name`` by floating ``amount``.
         If no key exists, the value will be initialized as ``amount``
 
-        For more information check https://redis.io/commands/incrbyfloat
+        For more information see https://redis.io/commands/incrbyfloat
         """
         return self.execute_command("INCRBYFLOAT", name, amount)
 
@@ -1740,7 +1740,7 @@ def keys(self, pattern: PatternT = "*", **kwargs) -> ResponseT:
         """
         Returns a list of keys matching ``pattern``
 
-        For more information check https://redis.io/commands/keys
+        For more information see https://redis.io/commands/keys
         """
         return self.execute_command("KEYS", pattern, **kwargs)
 
@@ -1756,7 +1756,7 @@ def lmove(
         pushing it as the first/last element on the destination list.
         Returns the element being popped and pushed.
 
-        For more information check https://redis.io/commands/lmove
+        For more information see https://redis.io/commands/lmove
         """
         params = [first_list, second_list, src, dest]
         return self.execute_command("LMOVE", *params)
@@ -1772,7 +1772,7 @@ def blmove(
         """
         Blocking version of lmove.
 
-        For more information check https://redis.io/commands/blmove
+        For more information see https://redis.io/commands/blmove
         """
         params = [first_list, second_list, src, dest, timeout]
         return self.execute_command("BLMOVE", *params)
@@ -1781,7 +1781,7 @@ def mget(self, keys: KeysT, *args: EncodableT) -> ResponseT:
         """
         Returns a list of values ordered identically to ``keys``
 
-        For more information check https://redis.io/commands/mget
+        For more information see https://redis.io/commands/mget
         """
         from redis.client import EMPTY_RESPONSE
 
@@ -1797,7 +1797,7 @@ def mset(self, mapping: Mapping[AnyKeyT, EncodableT]) -> ResponseT:
         key/value pairs. Both keys and values should be strings or types that
         can be cast to a string via str().
 
-        For more information check https://redis.io/commands/mset
+        For more information see https://redis.io/commands/mset
         """
         items = []
         for pair in mapping.items():
@@ -1811,7 +1811,7 @@ def msetnx(self, mapping: Mapping[AnyKeyT, EncodableT]) -> ResponseT:
         should be strings or types that can be cast to a string via str().
         Returns a boolean indicating if the operation was successful.
 
-        For more information check https://redis.io/commands/msetnx
+        For more information see https://redis.io/commands/msetnx
         """
         items = []
         for pair in mapping.items():
@@ -1822,7 +1822,7 @@ def move(self, name: KeyT, db: int) -> ResponseT:
         """
         Moves the key ``name`` to a different Redis database ``db``
 
-        For more information check https://redis.io/commands/move
+        For more information see https://redis.io/commands/move
         """
         return self.execute_command("MOVE", name, db)
 
@@ -1830,7 +1830,7 @@ def persist(self, name: KeyT) -> ResponseT:
         """
         Removes an expiration on ``name``
 
-        For more information check https://redis.io/commands/persist
+        For more information see https://redis.io/commands/persist
         """
         return self.execute_command("PERSIST", name)
 
@@ -1854,7 +1854,7 @@ def pexpire(
             GT -> Set expiry only when the new expiry is greater than current one
             LT -> Set expiry only when the new expiry is less than current one
 
-        For more information check https://redis.io/commands/pexpire
+        For more information see https://redis.io/commands/pexpire
         """
         if isinstance(time, datetime.timedelta):
             time = int(time.total_seconds() * 1000)
@@ -1890,7 +1890,7 @@ def pexpireat(
             GT -> Set expiry only when the new expiry is greater than current one
             LT -> Set expiry only when the new expiry is less than current one
 
-        For more information check https://redis.io/commands/pexpireat
+        For more information see https://redis.io/commands/pexpireat
         """
         if isinstance(when, datetime.datetime):
             ms = int(when.microsecond / 1000)
@@ -1911,7 +1911,7 @@ def pexpiretime(self, key: str) -> int:
         Returns the absolute Unix timestamp (since January 1, 1970) in milliseconds
         at which the given key will expire.
 
-        For more information check https://redis.io/commands/pexpiretime
+        For more information see https://redis.io/commands/pexpiretime
         """
         return self.execute_command("PEXPIRETIME", key)
 
@@ -1926,7 +1926,7 @@ def psetex(
         milliseconds. ``time_ms`` can be represented by an integer or a Python
         timedelta object
 
-        For more information check https://redis.io/commands/psetex
+        For more information see https://redis.io/commands/psetex
         """
         if isinstance(time_ms, datetime.timedelta):
             time_ms = int(time_ms.total_seconds() * 1000)
@@ -1936,7 +1936,7 @@ def pttl(self, name: KeyT) -> ResponseT:
         """
         Returns the number of milliseconds until the key ``name`` will expire
 
-        For more information check https://redis.io/commands/pttl
+        For more information see https://redis.io/commands/pttl
         """
         return self.execute_command("PTTL", name)
 
@@ -1957,7 +1957,7 @@ def hrandfield(
         withvalues: The optional WITHVALUES modifier changes the reply so it
         includes the respective values of the randomly selected hash fields.
 
-        For more information check https://redis.io/commands/hrandfield
+        For more information see https://redis.io/commands/hrandfield
         """
         params = []
         if count is not None:
@@ -1971,7 +1971,7 @@ def randomkey(self, **kwargs) -> ResponseT:
         """
         Returns the name of a random key
 
-        For more information check https://redis.io/commands/randomkey
+        For more information see https://redis.io/commands/randomkey
         """
         return self.execute_command("RANDOMKEY", **kwargs)
 
@@ -1979,7 +1979,7 @@ def rename(self, src: KeyT, dst: KeyT) -> ResponseT:
         """
         Rename key ``src`` to ``dst``
 
-        For more information check https://redis.io/commands/rename
+        For more information see https://redis.io/commands/rename
         """
         return self.execute_command("RENAME", src, dst)
 
@@ -1987,7 +1987,7 @@ def renamenx(self, src: KeyT, dst: KeyT):
         """
         Rename key ``src`` to ``dst`` if ``dst`` doesn't already exist
 
-        For more information check https://redis.io/commands/renamenx
+        For more information see https://redis.io/commands/renamenx
         """
         return self.execute_command("RENAMENX", src, dst)
 
@@ -2018,7 +2018,7 @@ def restore(
         ``frequency`` Used for eviction, this is the frequency counter of
         the object stored at the key, prior to execution.
 
-        For more information check https://redis.io/commands/restore
+        For more information see https://redis.io/commands/restore
         """
         params = [name, ttl, value]
         if replace:
@@ -2080,7 +2080,7 @@ def set(
         ``pxat`` sets an expire flag on key ``name`` for ``ex`` milliseconds,
             specified in unix time.
 
-        For more information check https://redis.io/commands/set
+        For more information see https://redis.io/commands/set
         """
         pieces: list[EncodableT] = [name, value]
         options = {}
@@ -2134,7 +2134,7 @@ def setbit(self, name: KeyT, offset: int, value: int) -> ResponseT:
         Flag the ``offset`` in ``name`` as ``value``. Returns an integer
         indicating the previous value of ``offset``.
 
-        For more information check https://redis.io/commands/setbit
+        For more information see https://redis.io/commands/setbit
         """
         value = value and 1 or 0
         return self.execute_command("SETBIT", name, offset, value)
@@ -2145,7 +2145,7 @@ def setex(self, name: KeyT, time: ExpiryT, value: EncodableT) -> ResponseT:
         seconds. ``time`` can be represented by an integer or a Python
         timedelta object.
 
-        For more information check https://redis.io/commands/setex
+        For more information see https://redis.io/commands/setex
         """
         if isinstance(time, datetime.timedelta):
             time = int(time.total_seconds())
@@ -2155,7 +2155,7 @@ def setnx(self, name: KeyT, value: EncodableT) -> ResponseT:
         """
         Set the value of key ``name`` to ``value`` if key doesn't exist
 
-        For more information check https://redis.io/commands/setnx
+        For more information see https://redis.io/commands/setnx
         """
         return self.execute_command("SETNX", name, value)
 
@@ -2175,7 +2175,7 @@ def setrange(
 
         Returns the length of the new string.
 
-        For more information check https://redis.io/commands/setrange
+        For more information see https://redis.io/commands/setrange
         """
         return self.execute_command("SETRANGE", name, offset, value)
 
@@ -2208,7 +2208,7 @@ def stralgo(
         ``withmatchlen`` Returns the matches with the len of the match.
         Can be provided only when ``idx`` set to True.
 
-        For more information check https://redis.io/commands/stralgo
+        For more information see https://redis.io/commands/stralgo
         """
         # check validity
         supported_algo = ["LCS"]
@@ -2247,7 +2247,7 @@ def strlen(self, name: KeyT) -> ResponseT:
         """
         Return the number of bytes stored in the value of ``name``
 
-        For more information check https://redis.io/commands/strlen
+        For more information see https://redis.io/commands/strlen
         """
         return self.execute_command("STRLEN", name)
 
@@ -2263,7 +2263,7 @@ def touch(self, *args: KeyT) -> ResponseT:
         Alters the last access time of a key(s) ``*args``. A key is ignored
         if it does not exist.
 
-        For more information check https://redis.io/commands/touch
+        For more information see https://redis.io/commands/touch
         """
         return self.execute_command("TOUCH", *args)
 
@@ -2271,7 +2271,7 @@ def ttl(self, name: KeyT) -> ResponseT:
         """
         Returns the number of seconds until the key ``name`` will expire
 
-        For more information check https://redis.io/commands/ttl
+        For more information see https://redis.io/commands/ttl
         """
         return self.execute_command("TTL", name)
 
@@ -2279,7 +2279,7 @@ def type(self, name: KeyT) -> ResponseT:
         """
         Returns the type of key ``name``
 
-        For more information check https://redis.io/commands/type
+        For more information see https://redis.io/commands/type
         """
         return self.execute_command("TYPE", name)
 
@@ -2287,7 +2287,7 @@ def watch(self, *names: KeyT) -> None:
         """
         Watches the values at keys ``names``, or None if the key doesn't exist
 
-        For more information check https://redis.io/commands/watch
+        For more information see https://redis.io/commands/watch
         """
         warnings.warn(DeprecationWarning("Call WATCH from a Pipeline object"))
 
@@ -2295,7 +2295,7 @@ def unwatch(self) -> None:
         """
         Unwatches the value at key ``name``, or None of the key doesn't exist
 
-        For more information check https://redis.io/commands/unwatch
+        For more information see https://redis.io/commands/unwatch
         """
         warnings.warn(DeprecationWarning("Call UNWATCH from a Pipeline object"))
 
@@ -2303,7 +2303,7 @@ def unlink(self, *names: KeyT) -> ResponseT:
         """
         Unlink one or more keys specified by ``names``
 
-        For more information check https://redis.io/commands/unlink
+        For more information see https://redis.io/commands/unlink
         """
         return self.execute_command("UNLINK", *names)
 
@@ -2323,7 +2323,7 @@ def lcs(
         ``minmatchlen`` restrict the list of matches to the ones of
         the given ``minmatchlen``.
         If ``withmatchlen`` the length of the match also will be returned.
-        For more information check https://redis.io/commands/lcs
+        For more information see https://redis.io/commands/lcs
         """
         pieces = [key1, key2]
         if len:
@@ -2376,7 +2376,7 @@ def blpop(
 
         If timeout is 0, then block indefinitely.
 
-        For more information check https://redis.io/commands/blpop
+        For more information see https://redis.io/commands/blpop
         """
         if timeout is None:
             timeout = 0
@@ -2397,7 +2397,7 @@ def brpop(
 
         If timeout is 0, then block indefinitely.
 
-        For more information check https://redis.io/commands/brpop
+        For more information see https://redis.io/commands/brpop
         """
         if timeout is None:
             timeout = 0
@@ -2416,7 +2416,7 @@ def brpoplpush(
         seconds elapse, whichever is first. A ``timeout`` value of 0 blocks
         forever.
 
-        For more information check https://redis.io/commands/brpoplpush
+        For more information see https://redis.io/commands/brpoplpush
         """
         if timeout is None:
             timeout = 0
@@ -2437,7 +2437,7 @@ def blmpop(
         When all lists are empty this command blocks the connection until another
         client pushes to it or until the timeout, timeout of 0 blocks indefinitely
 
-        For more information check https://redis.io/commands/blmpop
+        For more information see https://redis.io/commands/blmpop
         """
         args = [timeout, numkeys, *args, direction, "COUNT", count]
 
@@ -2454,7 +2454,7 @@ def lmpop(
         Pop ``count`` values (default 1) first non-empty list key from the list
         of args provided key names.
 
-        For more information check https://redis.io/commands/lmpop
+        For more information see https://redis.io/commands/lmpop
         """
         args = [num_keys] + list(args) + [direction]
         if count != 1:
@@ -2471,7 +2471,7 @@ def lindex(
         Negative indexes are supported and will return an item at the
         end of the list
 
-        For more information check https://redis.io/commands/lindex
+        For more information see https://redis.io/commands/lindex
         """
         return self.execute_command("LINDEX", name, index)
 
@@ -2485,7 +2485,7 @@ def linsert(
         Returns the new length of the list on success or -1 if ``refvalue``
         is not in the list.
 
-        For more information check https://redis.io/commands/linsert
+        For more information see https://redis.io/commands/linsert
         """
         return self.execute_command("LINSERT", name, where, refvalue, value)
 
@@ -2493,7 +2493,7 @@ def llen(self, name: str) -> Union[Awaitable[int], int]:
         """
         Return the length of the list ``name``
 
-        For more information check https://redis.io/commands/llen
+        For more information see https://redis.io/commands/llen
         """
         return self.execute_command("LLEN", name)
 
@@ -2505,7 +2505,7 @@ def lpop(self, name: str, count: Optional[int] = None) -> Union[str, List, None]
         the list. When provided with the optional ``count`` argument, the reply
         will consist of up to count elements, depending on the list's length.
 
-        For more information check https://redis.io/commands/lpop
+        For more information see https://redis.io/commands/lpop
         """
         if count is not None:
             return self.execute_command("LPOP", name, count)
@@ -2516,7 +2516,7 @@ def lpush(self, name: str, *values: List) -> Union[Awaitable[int], int]:
         """
         Push ``values`` onto the head of the list ``name``
 
-        For more information check https://redis.io/commands/lpush
+        For more information see https://redis.io/commands/lpush
         """
         return self.execute_command("LPUSH", name, *values)
 
@@ -2524,7 +2524,7 @@ def lpushx(self, name: str, *values: List) -> Union[Awaitable[int], int]:
         """
         Push ``value`` onto the head of the list ``name`` if ``name`` exists
 
-        For more information check https://redis.io/commands/lpushx
+        For more information see https://redis.io/commands/lpushx
         """
         return self.execute_command("LPUSHX", name, *values)
 
@@ -2536,7 +2536,7 @@ def lrange(self, name: str, start: int, end: int) -> Union[Awaitable[list], list
         ``start`` and ``end`` can be negative numbers just like
         Python slicing notation
 
-        For more information check https://redis.io/commands/lrange
+        For more information see https://redis.io/commands/lrange
         """
         return self.execute_command("LRANGE", name, start, end)
 
@@ -2550,7 +2550,7 @@ def lrem(self, name: str, count: int, value: str) -> Union[Awaitable[int], int]:
             count < 0: Remove elements equal to value moving from tail to head.
             count = 0: Remove all elements equal to value.
 
-            For more information check https://redis.io/commands/lrem
+            For more information see https://redis.io/commands/lrem
         """
         return self.execute_command("LREM", name, count, value)
 
@@ -2558,7 +2558,7 @@ def lset(self, name: str, index: int, value: str) -> Union[Awaitable[str], str]:
         """
         Set element at ``index`` of list ``name`` to ``value``
 
-        For more information check https://redis.io/commands/lset
+        For more information see https://redis.io/commands/lset
         """
         return self.execute_command("LSET", name, index, value)
 
@@ -2570,7 +2570,7 @@ def ltrim(self, name: str, start: int, end: int) -> Union[Awaitable[str], str]:
         ``start`` and ``end`` can be negative numbers just like
         Python slicing notation
 
-        For more information check https://redis.io/commands/ltrim
+        For more information see https://redis.io/commands/ltrim
         """
         return self.execute_command("LTRIM", name, start, end)
 
@@ -2582,7 +2582,7 @@ def rpop(self, name: str, count: Optional[int] = None) -> Union[str, List, None]
         When provided with the optional ``count`` argument, the reply will
         consist of up to count elements, depending on the list's length.
 
-        For more information check https://redis.io/commands/rpop
+        For more information see https://redis.io/commands/rpop
         """
         if count is not None:
             return self.execute_command("RPOP", name, count)
@@ -2594,7 +2594,7 @@ def rpoplpush(self, src: str, dst: str) -> Union[Awaitable[str], str]:
         RPOP a value off of the ``src`` list and atomically LPUSH it
         on to the ``dst`` list.  Returns the value.
 
-        For more information check https://redis.io/commands/rpoplpush
+        For more information see https://redis.io/commands/rpoplpush
         """
         return self.execute_command("RPOPLPUSH", src, dst)
 
@@ -2602,7 +2602,7 @@ def rpush(self, name: str, *values: List) -> Union[Awaitable[int], int]:
         """
         Push ``values`` onto the tail of the list ``name``
 
-        For more information check https://redis.io/commands/rpush
+        For more information see https://redis.io/commands/rpush
         """
         return self.execute_command("RPUSH", name, *values)
 
@@ -2610,7 +2610,7 @@ def rpushx(self, name: str, value: str) -> Union[Awaitable[int], int]:
         """
         Push ``value`` onto the tail of the list ``name`` if ``name`` exists
 
-        For more information check https://redis.io/commands/rpushx
+        For more information see https://redis.io/commands/rpushx
         """
         return self.execute_command("RPUSHX", name, value)
 
@@ -2645,7 +2645,7 @@ def lpos(
          position(s) of items within the first 1000 entries in the list.
          A ``maxlen`` of 0 (the default) will scan the entire list.
 
-         For more information check https://redis.io/commands/lpos
+         For more information see https://redis.io/commands/lpos
         """
         pieces: list[EncodableT] = [name, value]
         if rank is not None:
@@ -2694,7 +2694,7 @@ def sort(
             elements, sort will return a list of tuples, each containing the
             values fetched from the arguments to ``get``.
 
-        For more information check https://redis.io/commands/sort
+        For more information see https://redis.io/commands/sort
         """
         if (start is not None and num is None) or (num is not None and start is None):
             raise DataError("``start`` and ``num`` must both be specified")
@@ -2758,7 +2758,7 @@ def sort_ro(
 
         ``alpha`` allows for sorting lexicographically rather than numerically
 
-        For more information check https://redis.io/commands/sort_ro
+        For more information see https://redis.io/commands/sort_ro
         """
         return self.sort(
             key, start=start, num=num, by=by, get=get, desc=desc, alpha=alpha
@@ -2796,7 +2796,7 @@ def scan(
             HASH, LIST, SET, STREAM, STRING, ZSET
             Additionally, Redis modules can expose other types as well.
 
-        For more information check https://redis.io/commands/scan
+        For more information see https://redis.io/commands/scan
         """
         pieces: list[EncodableT] = [cursor]
         if match is not None:
@@ -2850,7 +2850,7 @@ def sscan(
 
         ``count`` allows for hint the minimum number of returns
 
-        For more information check https://redis.io/commands/sscan
+        For more information see https://redis.io/commands/sscan
         """
         pieces: list[EncodableT] = [name, cursor]
         if match is not None:
@@ -2893,7 +2893,7 @@ def hscan(
 
         ``count`` allows for hint the minimum number of returns
 
-        For more information check https://redis.io/commands/hscan
+        For more information see https://redis.io/commands/hscan
         """
         pieces: list[EncodableT] = [name, cursor]
         if match is not None:
@@ -2939,7 +2939,7 @@ def zscan(
 
         ``score_cast_func`` a callable used to cast the score return value
 
-        For more information check https://redis.io/commands/zscan
+        For more information see https://redis.io/commands/zscan
         """
         pieces = [name, cursor]
         if match is not None:
@@ -3092,7 +3092,7 @@ def sadd(self, name: str, *values: List) -> Union[Awaitable[int], int]:
         """
         Add ``value(s)`` to set ``name``
 
-        For more information check https://redis.io/commands/sadd
+        For more information see https://redis.io/commands/sadd
         """
         return self.execute_command("SADD", name, *values)
 
@@ -3100,7 +3100,7 @@ def scard(self, name: str) -> Union[Awaitable[int], int]:
         """
         Return the number of elements in set ``name``
 
-        For more information check https://redis.io/commands/scard
+        For more information see https://redis.io/commands/scard
         """
         return self.execute_command("SCARD", name)
 
@@ -3108,7 +3108,7 @@ def sdiff(self, keys: List, *args: List) -> Union[Awaitable[list], list]:
         """
         Return the difference of sets specified by ``keys``
 
-        For more information check https://redis.io/commands/sdiff
+        For more information see https://redis.io/commands/sdiff
         """
         args = list_or_args(keys, args)
         return self.execute_command("SDIFF", *args)
@@ -3120,7 +3120,7 @@ def sdiffstore(
         Store the difference of sets specified by ``keys`` into a new
         set named ``dest``.  Returns the number of keys in the new set.
 
-        For more information check https://redis.io/commands/sdiffstore
+        For more information see https://redis.io/commands/sdiffstore
         """
         args = list_or_args(keys, args)
         return self.execute_command("SDIFFSTORE", dest, *args)
@@ -3129,7 +3129,7 @@ def sinter(self, keys: List, *args: List) -> Union[Awaitable[list], list]:
         """
         Return the intersection of sets specified by ``keys``
 
-        For more information check https://redis.io/commands/sinter
+        For more information see https://redis.io/commands/sinter
         """
         args = list_or_args(keys, args)
         return self.execute_command("SINTER", *args)
@@ -3144,7 +3144,7 @@ def sintercard(
         cardinality reaches limit partway through the computation, the algorithm will
         exit and yield limit as the cardinality
 
-        For more information check https://redis.io/commands/sintercard
+        For more information see https://redis.io/commands/sintercard
         """
         args = [numkeys, *keys, "LIMIT", limit]
         return self.execute_command("SINTERCARD", *args)
@@ -3156,7 +3156,7 @@ def sinterstore(
         Store the intersection of sets specified by ``keys`` into a new
         set named ``dest``.  Returns the number of keys in the new set.
 
-        For more information check https://redis.io/commands/sinterstore
+        For more information see https://redis.io/commands/sinterstore
         """
         args = list_or_args(keys, args)
         return self.execute_command("SINTERSTORE", dest, *args)
@@ -3165,7 +3165,7 @@ def sismember(self, name: str, value: str) -> Union[Awaitable[bool], bool]:
         """
         Return a boolean indicating if ``value`` is a member of set ``name``
 
-        For more information check https://redis.io/commands/sismember
+        For more information see https://redis.io/commands/sismember
         """
         return self.execute_command("SISMEMBER", name, value)
 
@@ -3173,7 +3173,7 @@ def smembers(self, name: str) -> Union[Awaitable[list], list]:
         """
         Return all members of the set ``name``
 
-        For more information check https://redis.io/commands/smembers
+        For more information see https://redis.io/commands/smembers
         """
         return self.execute_command("SMEMBERS", name)
 
@@ -3187,7 +3187,7 @@ def smismember(
         Return whether each value in ``values`` is a member of the set ``name``
         as a list of ``bool`` in the order of ``values``
 
-        For more information check https://redis.io/commands/smismember
+        For more information see https://redis.io/commands/smismember
         """
         args = list_or_args(values, args)
         return self.execute_command("SMISMEMBER", name, *args)
@@ -3196,7 +3196,7 @@ def smove(self, src: str, dst: str, value: str) -> Union[Awaitable[bool], bool]:
         """
         Move ``value`` from set ``src`` to set ``dst`` atomically
 
-        For more information check https://redis.io/commands/smove
+        For more information see https://redis.io/commands/smove
         """
         return self.execute_command("SMOVE", src, dst, value)
 
@@ -3204,7 +3204,7 @@ def spop(self, name: str, count: Optional[int] = None) -> Union[str, List, None]
         """
         Remove and return a random member of set ``name``
 
-        For more information check https://redis.io/commands/spop
+        For more information see https://redis.io/commands/spop
         """
         args = (count is not None) and [count] or []
         return self.execute_command("SPOP", name, *args)
@@ -3221,7 +3221,7 @@ def srandmember(
         members of set ``name``. Note this is only available when running
         Redis 2.6+.
 
-        For more information check https://redis.io/commands/srandmember
+        For more information see https://redis.io/commands/srandmember
         """
         args = (number is not None) and [number] or []
         return self.execute_command("SRANDMEMBER", name, *args)
@@ -3230,7 +3230,7 @@ def srem(self, name: str, *values: List) -> Union[Awaitable[int], int]:
         """
         Remove ``values`` from set ``name``
 
-        For more information check https://redis.io/commands/srem
+        For more information see https://redis.io/commands/srem
         """
         return self.execute_command("SREM", name, *values)
 
@@ -3238,7 +3238,7 @@ def sunion(self, keys: List, *args: List) -> Union[Awaitable[List], List]:
         """
         Return the union of sets specified by ``keys``
 
-        For more information check https://redis.io/commands/sunion
+        For more information see https://redis.io/commands/sunion
         """
         args = list_or_args(keys, args)
         return self.execute_command("SUNION", *args)
@@ -3250,7 +3250,7 @@ def sunionstore(
         Store the union of sets specified by ``keys`` into a new
         set named ``dest``.  Returns the number of keys in the new set.
 
-        For more information check https://redis.io/commands/sunionstore
+        For more information see https://redis.io/commands/sunionstore
         """
         args = list_or_args(keys, args)
         return self.execute_command("SUNIONSTORE", dest, *args)
@@ -3277,7 +3277,7 @@ def xack(
         groupname: name of the consumer group.
         *ids: message ids to acknowledge.
 
-        For more information check https://redis.io/commands/xack
+        For more information see https://redis.io/commands/xack
         """
         return self.execute_command("XACK", name, groupname, *ids)
 
@@ -3305,7 +3305,7 @@ def xadd(
         Can't be specified with maxlen.
         limit: specifies the maximum number of entries to retrieve
 
-        For more information check https://redis.io/commands/xadd
+        For more information see https://redis.io/commands/xadd
         """
         pieces: list[EncodableT] = []
         if maxlen is not None and minid is not None:
@@ -3362,7 +3362,7 @@ def xautoclaim(
         justid: optional boolean, false by default. Return just an array of IDs
         of messages successfully claimed, without returning the actual message
 
-        For more information check https://redis.io/commands/xautoclaim
+        For more information see https://redis.io/commands/xautoclaim
         """
         try:
             if int(min_idle_time) < 0:
@@ -3422,7 +3422,7 @@ def xclaim(
         justid: optional boolean, false by default. Return just an array of IDs
          of messages successfully claimed, without returning the actual message
 
-         For more information check https://redis.io/commands/xclaim
+         For more information see https://redis.io/commands/xclaim
         """
         if not isinstance(min_idle_time, int) or min_idle_time < 0:
             raise DataError("XCLAIM min_idle_time must be a non negative " "integer")
@@ -3466,7 +3466,7 @@ def xdel(self, name: KeyT, *ids: StreamIdT) -> ResponseT:
         name: name of the stream.
         *ids: message ids to delete.
 
-        For more information check https://redis.io/commands/xdel
+        For more information see https://redis.io/commands/xdel
         """
         return self.execute_command("XDEL", name, *ids)
 
@@ -3483,7 +3483,7 @@ def xgroup_create(
         groupname: name of the consumer group.
         id: ID of the last item in the stream to consider already delivered.
 
-        For more information check https://redis.io/commands/xgroup-create
+        For more information see https://redis.io/commands/xgroup-create
         """
         pieces: list[EncodableT] = ["XGROUP CREATE", name, groupname, id]
         if mkstream:
@@ -3504,7 +3504,7 @@ def xgroup_delconsumer(
         groupname: name of the consumer group.
         consumername: name of consumer to delete
 
-        For more information check https://redis.io/commands/xgroup-delconsumer
+        For more information see https://redis.io/commands/xgroup-delconsumer
         """
         return self.execute_command("XGROUP DELCONSUMER", name, groupname, consumername)
 
@@ -3514,7 +3514,7 @@ def xgroup_destroy(self, name: KeyT, groupname: GroupT) -> ResponseT:
         name: name of the stream.
         groupname: name of the consumer group.
 
-        For more information check https://redis.io/commands/xgroup-destroy
+        For more information see https://redis.io/commands/xgroup-destroy
         """
         return self.execute_command("XGROUP DESTROY", name, groupname)
 
@@ -3550,7 +3550,7 @@ def xgroup_setid(
         groupname: name of the consumer group.
         id: ID of the last item in the stream to consider already delivered.
 
-        For more information check https://redis.io/commands/xgroup-setid
+        For more information see https://redis.io/commands/xgroup-setid
         """
         return self.execute_command("XGROUP SETID", name, groupname, id)
 
@@ -3560,7 +3560,7 @@ def xinfo_consumers(self, name: KeyT, groupname: GroupT) -> ResponseT:
         name: name of the stream.
         groupname: name of the consumer group.
 
-        For more information check https://redis.io/commands/xinfo-consumers
+        For more information see https://redis.io/commands/xinfo-consumers
         """
         return self.execute_command("XINFO CONSUMERS", name, groupname)
 
@@ -3569,7 +3569,7 @@ def xinfo_groups(self, name: KeyT) -> ResponseT:
         Returns general information about the consumer groups of the stream.
         name: name of the stream.
 
-        For more information check https://redis.io/commands/xinfo-groups
+        For more information see https://redis.io/commands/xinfo-groups
         """
         return self.execute_command("XINFO GROUPS", name)
 
@@ -3579,7 +3579,7 @@ def xinfo_stream(self, name: KeyT, full: bool = False) -> ResponseT:
         name: name of the stream.
         full: optional boolean, false by default. Return full summary
 
-        For more information check https://redis.io/commands/xinfo-stream
+        For more information see https://redis.io/commands/xinfo-stream
         """
         pieces = [name]
         options = {}
@@ -3592,7 +3592,7 @@ def xlen(self, name: KeyT) -> ResponseT:
         """
         Returns the number of elements in a given stream.
 
-        For more information check https://redis.io/commands/xlen
+        For more information see https://redis.io/commands/xlen
         """
         return self.execute_command("XLEN", name)
 
@@ -3602,7 +3602,7 @@ def xpending(self, name: KeyT, groupname: GroupT) -> ResponseT:
         name: name of the stream.
         groupname: name of the consumer group.
 
-        For more information check https://redis.io/commands/xpending
+        For more information see https://redis.io/commands/xpending
         """
         return self.execute_command("XPENDING", name, groupname)
 
@@ -3680,7 +3680,7 @@ def xrange(
         count: if set, only return this many items, beginning with the
                earliest available.
 
-        For more information check https://redis.io/commands/xrange
+        For more information see https://redis.io/commands/xrange
         """
         pieces = [min, max]
         if count is not None:
@@ -3705,7 +3705,7 @@ def xread(
                earliest available.
         block: number of milliseconds to wait, if nothing already present.
 
-        For more information check https://redis.io/commands/xread
+        For more information see https://redis.io/commands/xread
         """
         pieces = []
         if block is not None:
@@ -3746,7 +3746,7 @@ def xreadgroup(
         block: number of milliseconds to wait, if nothing already present.
         noack: do not add messages to the PEL
 
-        For more information check https://redis.io/commands/xreadgroup
+        For more information see https://redis.io/commands/xreadgroup
         """
         pieces: list[EncodableT] = [b"GROUP", groupname, consumername]
         if count is not None:
@@ -3785,7 +3785,7 @@ def xrevrange(
         count: if set, only return this many items, beginning with the
                latest available.
 
-        For more information check https://redis.io/commands/xrevrange
+        For more information see https://redis.io/commands/xrevrange
         """
         pieces: list[EncodableT] = [max, min]
         if count is not None:
@@ -3814,7 +3814,7 @@ def xtrim(
         Can't be specified with maxlen.
         limit: specifies the maximum number of entries to retrieve
 
-        For more information check https://redis.io/commands/xtrim
+        For more information see https://redis.io/commands/xtrim
         """
         pieces: list[EncodableT] = []
         if maxlen is not None and minid is not None:
@@ -3926,7 +3926,7 @@ def zcard(self, name: KeyT) -> ResponseT:
         """
         Return the number of elements in the sorted set ``name``
 
-        For more information check https://redis.io/commands/zcard
+        For more information see https://redis.io/commands/zcard
         """
         return self.execute_command("ZCARD", name)
 
@@ -3935,7 +3935,7 @@ def zcount(self, name: KeyT, min: ZScoreBoundT, max: ZScoreBoundT) -> ResponseT:
         Returns the number of elements in the sorted set at key ``name`` with
         a score between ``min`` and ``max``.
 
-        For more information check https://redis.io/commands/zcount
+        For more information see https://redis.io/commands/zcount
         """
         return self.execute_command("ZCOUNT", name, min, max)
 
@@ -3944,7 +3944,7 @@ def zdiff(self, keys: KeysT, withscores: bool = False) -> ResponseT:
         Returns the difference between the first and all successive input
         sorted sets provided in ``keys``.
 
-        For more information check https://redis.io/commands/zdiff
+        For more information see https://redis.io/commands/zdiff
         """
         pieces = [len(keys), *keys]
         if withscores:
@@ -3956,7 +3956,7 @@ def zdiffstore(self, dest: KeyT, keys: KeysT) -> ResponseT:
         Computes the difference between the first and all successive input
         sorted sets provided in ``keys`` and stores the result in ``dest``.
 
-        For more information check https://redis.io/commands/zdiffstore
+        For more information see https://redis.io/commands/zdiffstore
         """
         pieces = [len(keys), *keys]
         return self.execute_command("ZDIFFSTORE", dest, *pieces)
@@ -3970,7 +3970,7 @@ def zincrby(
         """
         Increment the score of ``value`` in sorted set ``name`` by ``amount``
 
-        For more information check https://redis.io/commands/zincrby
+        For more information see https://redis.io/commands/zincrby
         """
         return self.execute_command("ZINCRBY", name, amount, value)
 
@@ -3989,7 +3989,7 @@ def zinter(
         set will contain the minimum or maximum score of an element across
         the inputs where it exists.
 
-        For more information check https://redis.io/commands/zinter
+        For more information see https://redis.io/commands/zinter
         """
         return self._zaggregate("ZINTER", None, keys, aggregate, withscores=withscores)
 
@@ -4008,7 +4008,7 @@ def zinterstore(
         contain the minimum or maximum score of an element across the inputs
         where it exists.
 
-        For more information check https://redis.io/commands/zinterstore
+        For more information see https://redis.io/commands/zinterstore
         """
         return self._zaggregate("ZINTERSTORE", dest, keys, aggregate)
 
@@ -4022,7 +4022,7 @@ def zintercard(
         cardinality reaches limit partway through the computation, the algorithm will
         exit and yield limit as the cardinality
 
-        For more information check https://redis.io/commands/zintercard
+        For more information see https://redis.io/commands/zintercard
         """
         args = [numkeys, *keys, "LIMIT", limit]
         return self.execute_command("ZINTERCARD", *args)
@@ -4032,7 +4032,7 @@ def zlexcount(self, name, min, max):
         Return the number of items in the sorted set ``name`` between the
         lexicographical range ``min`` and ``max``.
 
-        For more information check https://redis.io/commands/zlexcount
+        For more information see https://redis.io/commands/zlexcount
         """
         return self.execute_command("ZLEXCOUNT", name, min, max)
 
@@ -4045,7 +4045,7 @@ def zpopmax(
         Remove and return up to ``count`` members with the highest scores
         from the sorted set ``name``.
 
-        For more information check https://redis.io/commands/zpopmax
+        For more information see https://redis.io/commands/zpopmax
         """
         args = (count is not None) and [count] or []
         options = {"withscores": True}
@@ -4060,7 +4060,7 @@ def zpopmin(
         Remove and return up to ``count`` members with the lowest scores
         from the sorted set ``name``.
 
-        For more information check https://redis.io/commands/zpopmin
+        For more information see https://redis.io/commands/zpopmin
         """
         args = (count is not None) and [count] or []
         options = {"withscores": True}
@@ -4085,7 +4085,7 @@ def zrandmember(
         includes the respective scores of the randomly selected elements from
         the sorted set.
 
-        For more information check https://redis.io/commands/zrandmember
+        For more information see https://redis.io/commands/zrandmember
         """
         params = []
         if count is not None:
@@ -4106,7 +4106,7 @@ def bzpopmax(self, keys: KeysT, timeout: TimeoutSecT = 0) -> ResponseT:
 
         If timeout is 0, then block indefinitely.
 
-        For more information check https://redis.io/commands/bzpopmax
+        For more information see https://redis.io/commands/bzpopmax
         """
         if timeout is None:
             timeout = 0
@@ -4125,7 +4125,7 @@ def bzpopmin(self, keys: KeysT, timeout: TimeoutSecT = 0) -> ResponseT:
 
         If timeout is 0, then block indefinitely.
 
-        For more information check https://redis.io/commands/bzpopmin
+        For more information see https://redis.io/commands/bzpopmin
         """
         if timeout is None:
             timeout = 0
@@ -4144,7 +4144,7 @@ def zmpop(
         """
         Pop ``count`` values (default 1) off of the first non-empty sorted set
         named in the ``keys`` list.
-        For more information check https://redis.io/commands/zmpop
+        For more information see https://redis.io/commands/zmpop
         """
         args = [num_keys] + keys
         if (min and max) or (not min and not max):
@@ -4177,7 +4177,7 @@ def bzmpop(
 
         If timeout is 0, then block indefinitely.
 
-        For more information check https://redis.io/commands/bzmpop
+        For more information see https://redis.io/commands/bzmpop
         """
         args = [timeout, numkeys, *keys]
         if (min and max) or (not min and not max):
@@ -4271,7 +4271,7 @@ def zrange(
         ``offset`` and ``num`` are specified, then return a slice of the range.
         Can't be provided when using ``bylex``.
 
-        For more information check https://redis.io/commands/zrange
+        For more information see https://redis.io/commands/zrange
         """
         # Need to support ``desc`` also when using old redis version
         # because it was supported in 3.5.3 (of redis-py)
@@ -4312,7 +4312,7 @@ def zrevrange(
 
         ``score_cast_func`` a callable used to cast the score return value
 
-        For more information check https://redis.io/commands/zrevrange
+        For more information see https://redis.io/commands/zrevrange
         """
         pieces = ["ZREVRANGE", name, start, end]
         if withscores:
@@ -4353,7 +4353,7 @@ def zrangestore(
         ``offset`` and ``num`` are specified, then return a slice of the range.
         Can't be provided when using ``bylex``.
 
-        For more information check https://redis.io/commands/zrangestore
+        For more information see https://redis.io/commands/zrangestore
         """
         return self._zrange(
             "ZRANGESTORE",
@@ -4385,7 +4385,7 @@ def zrangebylex(
         If ``start`` and ``num`` are specified, then return a slice of the
         range.
 
-        For more information check https://redis.io/commands/zrangebylex
+        For more information see https://redis.io/commands/zrangebylex
         """
         if (start is not None and num is None) or (num is not None and start is None):
             raise DataError("``start`` and ``num`` must both be specified")
@@ -4409,7 +4409,7 @@ def zrevrangebylex(
         If ``start`` and ``num`` are specified, then return a slice of the
         range.
 
-        For more information check https://redis.io/commands/zrevrangebylex
+        For more information see https://redis.io/commands/zrevrangebylex
         """
         if (start is not None and num is None) or (num is not None and start is None):
             raise DataError("``start`` and ``num`` must both be specified")
@@ -4440,7 +4440,7 @@ def zrangebyscore(
 
         `score_cast_func`` a callable used to cast the score return value
 
-        For more information check https://redis.io/commands/zrangebyscore
+        For more information see https://redis.io/commands/zrangebyscore
         """
         if (start is not None and num is None) or (num is not None and start is None):
             raise DataError("``start`` and ``num`` must both be specified")
@@ -4474,7 +4474,7 @@ def zrevrangebyscore(
 
         ``score_cast_func`` a callable used to cast the score return value
 
-        For more information check https://redis.io/commands/zrevrangebyscore
+        For more information see https://redis.io/commands/zrevrangebyscore
         """
         if (start is not None and num is None) or (num is not None and start is None):
             raise DataError("``start`` and ``num`` must both be specified")
@@ -4491,7 +4491,7 @@ def zrank(self, name: KeyT, value: EncodableT) -> ResponseT:
         Returns a 0-based value indicating the rank of ``value`` in sorted set
         ``name``
 
-        For more information check https://redis.io/commands/zrank
+        For more information see https://redis.io/commands/zrank
         """
         return self.execute_command("ZRANK", name, value)
 
@@ -4499,7 +4499,7 @@ def zrem(self, name: KeyT, *values: EncodableT) -> ResponseT:
         """
         Remove member ``values`` from sorted set ``name``
 
-        For more information check https://redis.io/commands/zrem
+        For more information see https://redis.io/commands/zrem
         """
         return self.execute_command("ZREM", name, *values)
 
@@ -4510,7 +4510,7 @@ def zremrangebylex(self, name: KeyT, min: EncodableT, max: EncodableT) -> Respon
 
         Returns the number of elements removed.
 
-        For more information check https://redis.io/commands/zremrangebylex
+        For more information see https://redis.io/commands/zremrangebylex
         """
         return self.execute_command("ZREMRANGEBYLEX", name, min, max)
 
@@ -4521,7 +4521,7 @@ def zremrangebyrank(self, name: KeyT, min: int, max: int) -> ResponseT:
         to largest. Values can be negative indicating the highest scores.
         Returns the number of elements removed
 
-        For more information check https://redis.io/commands/zremrangebyrank
+        For more information see https://redis.io/commands/zremrangebyrank
         """
         return self.execute_command("ZREMRANGEBYRANK", name, min, max)
 
@@ -4532,7 +4532,7 @@ def zremrangebyscore(
         Remove all elements in the sorted set ``name`` with scores
         between ``min`` and ``max``. Returns the number of elements removed.
 
-        For more information check https://redis.io/commands/zremrangebyscore
+        For more information see https://redis.io/commands/zremrangebyscore
         """
         return self.execute_command("ZREMRANGEBYSCORE", name, min, max)
 
@@ -4541,7 +4541,7 @@ def zrevrank(self, name: KeyT, value: EncodableT) -> ResponseT:
         Returns a 0-based value indicating the descending rank of
         ``value`` in sorted set ``name``
 
-        For more information check https://redis.io/commands/zrevrank
+        For more information see https://redis.io/commands/zrevrank
         """
         return self.execute_command("ZREVRANK", name, value)
 
@@ -4549,7 +4549,7 @@ def zscore(self, name: KeyT, value: EncodableT) -> ResponseT:
         """
         Return the score of element ``value`` in sorted set ``name``
 
-        For more information check https://redis.io/commands/zscore
+        For more information see https://redis.io/commands/zscore
         """
         return self.execute_command("ZSCORE", name, value)
 
@@ -4565,7 +4565,7 @@ def zunion(
         Scores will be aggregated based on the ``aggregate``, or SUM if
         none is provided.
 
-        For more information check https://redis.io/commands/zunion
+        For more information see https://redis.io/commands/zunion
         """
         return self._zaggregate("ZUNION", None, keys, aggregate, withscores=withscores)
 
@@ -4580,7 +4580,7 @@ def zunionstore(
         a new sorted set, ``dest``. Scores in the destination will be
         aggregated based on the ``aggregate``, or SUM if none is provided.
 
-        For more information check https://redis.io/commands/zunionstore
+        For more information see https://redis.io/commands/zunionstore
         """
         return self._zaggregate("ZUNIONSTORE", dest, keys, aggregate)
 
@@ -4597,7 +4597,7 @@ def zmscore(
         If the member does not exist, a None will be returned
         in corresponding position.
 
-        For more information check https://redis.io/commands/zmscore
+        For more information see https://redis.io/commands/zmscore
         """
         if not members:
             raise DataError("ZMSCORE members must be a non-empty list")
@@ -4648,7 +4648,7 @@ def pfadd(self, name: KeyT, *values: EncodableT) -> ResponseT:
         """
         Adds the specified elements to the specified HyperLogLog.
 
-        For more information check https://redis.io/commands/pfadd
+        For more information see https://redis.io/commands/pfadd
         """
         return self.execute_command("PFADD", name, *values)
 
@@ -4657,7 +4657,7 @@ def pfcount(self, *sources: KeyT) -> ResponseT:
         Return the approximated cardinality of
         the set observed by the HyperLogLog at key(s).
 
-        For more information check https://redis.io/commands/pfcount
+        For more information see https://redis.io/commands/pfcount
         """
         return self.execute_command("PFCOUNT", *sources)
 
@@ -4665,7 +4665,7 @@ def pfmerge(self, dest: KeyT, *sources: KeyT) -> ResponseT:
         """
         Merge N different HyperLogLogs into a single one.
 
-        For more information check https://redis.io/commands/pfmerge
+        For more information see https://redis.io/commands/pfmerge
         """
         return self.execute_command("PFMERGE", dest, *sources)
 
@@ -4683,7 +4683,7 @@ def hdel(self, name: str, *keys: List) -> Union[Awaitable[int], int]:
         """
         Delete ``keys`` from hash ``name``
 
-        For more information check https://redis.io/commands/hdel
+        For more information see https://redis.io/commands/hdel
         """
         return self.execute_command("HDEL", name, *keys)
 
@@ -4691,7 +4691,7 @@ def hexists(self, name: str, key: str) -> Union[Awaitable[bool], bool]:
         """
         Returns a boolean indicating if ``key`` exists within hash ``name``
 
-        For more information check https://redis.io/commands/hexists
+        For more information see https://redis.io/commands/hexists
         """
         return self.execute_command("HEXISTS", name, key)
 
@@ -4701,7 +4701,7 @@ def hget(
         """
         Return the value of ``key`` within the hash ``name``
 
-        For more information check https://redis.io/commands/hget
+        For more information see https://redis.io/commands/hget
         """
         return self.execute_command("HGET", name, key)
 
@@ -4709,7 +4709,7 @@ def hgetall(self, name: str) -> Union[Awaitable[dict], dict]:
         """
         Return a Python dict of the hash's name/value pairs
 
-        For more information check https://redis.io/commands/hgetall
+        For more information see https://redis.io/commands/hgetall
         """
         return self.execute_command("HGETALL", name)
 
@@ -4719,7 +4719,7 @@ def hincrby(
         """
         Increment the value of ``key`` in hash ``name`` by ``amount``
 
-        For more information check https://redis.io/commands/hincrby
+        For more information see https://redis.io/commands/hincrby
         """
         return self.execute_command("HINCRBY", name, key, amount)
 
@@ -4729,7 +4729,7 @@ def hincrbyfloat(
         """
         Increment the value of ``key`` in hash ``name`` by floating ``amount``
 
-        For more information check https://redis.io/commands/hincrbyfloat
+        For more information see https://redis.io/commands/hincrbyfloat
         """
         return self.execute_command("HINCRBYFLOAT", name, key, amount)
 
@@ -4737,7 +4737,7 @@ def hkeys(self, name: str) -> Union[Awaitable[List], List]:
         """
         Return the list of keys within hash ``name``
 
-        For more information check https://redis.io/commands/hkeys
+        For more information see https://redis.io/commands/hkeys
         """
         return self.execute_command("HKEYS", name)
 
@@ -4745,7 +4745,7 @@ def hlen(self, name: str) -> Union[Awaitable[int], int]:
         """
         Return the number of elements in hash ``name``
 
-        For more information check https://redis.io/commands/hlen
+        For more information see https://redis.io/commands/hlen
         """
         return self.execute_command("HLEN", name)
 
@@ -4765,7 +4765,7 @@ def hset(
         added to hash ``name``.
         Returns the number of fields that were added.
 
-        For more information check https://redis.io/commands/hset
+        For more information see https://redis.io/commands/hset
         """
         if key is None and not mapping and not items:
             raise DataError("'hset' with no key value pairs")
@@ -4783,7 +4783,7 @@ def hsetnx(self, name: str, key: str, value: str) -> Union[Awaitable[bool], bool
         Set ``key`` to ``value`` within hash ``name`` if ``key`` does not
         exist.  Returns 1 if HSETNX created a field, otherwise 0.
 
-        For more information check https://redis.io/commands/hsetnx
+        For more information see https://redis.io/commands/hsetnx
         """
         return self.execute_command("HSETNX", name, key, value)
 
@@ -4792,7 +4792,7 @@ def hmset(self, name: str, mapping: dict) -> Union[Awaitable[str], str]:
         Set key to value within hash ``name`` for each corresponding
         key and value from the ``mapping`` dict.
 
-        For more information check https://redis.io/commands/hmset
+        For more information see https://redis.io/commands/hmset
         """
         warnings.warn(
             f"{self.__class__.__name__}.hmset() is deprecated. "
@@ -4811,7 +4811,7 @@ def hmget(self, name: str, keys: List, *args: List) -> Union[Awaitable[List], Li
         """
         Returns a list of values ordered identically to ``keys``
 
-        For more information check https://redis.io/commands/hmget
+        For more information see https://redis.io/commands/hmget
         """
         args = list_or_args(keys, args)
         return self.execute_command("HMGET", name, *args)
@@ -4820,7 +4820,7 @@ def hvals(self, name: str) -> Union[Awaitable[List], List]:
         """
         Return the list of values within hash ``name``
 
-        For more information check https://redis.io/commands/hvals
+        For more information see https://redis.io/commands/hvals
         """
         return self.execute_command("HVALS", name)
 
@@ -4829,7 +4829,7 @@ def hstrlen(self, name: str, key: str) -> Union[Awaitable[int], int]:
         Return the number of bytes stored in the value of ``key``
         within hash ``name``
 
-        For more information check https://redis.io/commands/hstrlen
+        For more information see https://redis.io/commands/hstrlen
         """
         return self.execute_command("HSTRLEN", name, key)
 
@@ -4938,7 +4938,7 @@ def publish(self, channel: ChannelT, message: EncodableT, **kwargs) -> ResponseT
         Publish ``message`` on ``channel``.
         Returns the number of subscribers the message was delivered to.
 
-        For more information check https://redis.io/commands/publish
+        For more information see https://redis.io/commands/publish
         """
         return self.execute_command("PUBLISH", channel, message, **kwargs)
 
@@ -4946,7 +4946,7 @@ def pubsub_channels(self, pattern: PatternT = "*", **kwargs) -> ResponseT:
         """
         Return a list of channels that have at least one subscriber
 
-        For more information check https://redis.io/commands/pubsub-channels
+        For more information see https://redis.io/commands/pubsub-channels
         """
         return self.execute_command("PUBSUB CHANNELS", pattern, **kwargs)
 
@@ -4954,7 +4954,7 @@ def pubsub_numpat(self, **kwargs) -> ResponseT:
         """
         Returns the number of subscriptions to patterns
 
-        For more information check https://redis.io/commands/pubsub-numpat
+        For more information see https://redis.io/commands/pubsub-numpat
         """
         return self.execute_command("PUBSUB NUMPAT", **kwargs)
 
@@ -4963,7 +4963,7 @@ def pubsub_numsub(self, *args: ChannelT, **kwargs) -> ResponseT:
         Return a list of (channel, number of subscribers) tuples
         for each channel given in ``*args``
 
-        For more information check https://redis.io/commands/pubsub-numsub
+        For more information see https://redis.io/commands/pubsub-numsub
         """
         return self.execute_command("PUBSUB NUMSUB", *args, **kwargs)
 
@@ -4993,7 +4993,7 @@ def eval(
         In practice, use the object returned by ``register_script``. This
         function exists purely for Redis API completion.
 
-        For more information check  https://redis.io/commands/eval
+        For more information see  https://redis.io/commands/eval
         """
         return self._eval("EVAL", script, numkeys, *keys_and_args)
 
@@ -5007,7 +5007,7 @@ def eval_ro(
         will touch and the key names and argument values in ``keys_and_args``.
         Returns the result of the script.
 
-        For more information check  https://redis.io/commands/eval_ro
+        For more information see  https://redis.io/commands/eval_ro
         """
         return self._eval("EVAL_RO", script, numkeys, *keys_and_args)
 
@@ -5028,7 +5028,7 @@ def evalsha(
         In practice, use the object returned by ``register_script``. This
         function exists purely for Redis API completion.
 
-        For more information check  https://redis.io/commands/evalsha
+        For more information see  https://redis.io/commands/evalsha
         """
         return self._evalsha("EVALSHA", sha, numkeys, *keys_and_args)
 
@@ -5043,7 +5043,7 @@ def evalsha_ro(
         key names and argument values in ``keys_and_args``. Returns the result
         of the script.
 
-        For more information check  https://redis.io/commands/evalsha_ro
+        For more information see  https://redis.io/commands/evalsha_ro
         """
         return self._evalsha("EVALSHA_RO", sha, numkeys, *keys_and_args)
 
@@ -5053,7 +5053,7 @@ def script_exists(self, *args: str) -> ResponseT:
         each script as ``args``. Returns a list of boolean values indicating if
         if each already script exists in the cache.
 
-        For more information check  https://redis.io/commands/script-exists
+        For more information see  https://redis.io/commands/script-exists
         """
         return self.execute_command("SCRIPT EXISTS", *args)
 
@@ -5068,7 +5068,7 @@ def script_flush(
         """Flush all scripts from the script cache.
         ``sync_type`` is by default SYNC (synchronous) but it can also be
                       ASYNC.
-        For more information check  https://redis.io/commands/script-flush
+        For more information see  https://redis.io/commands/script-flush
         """
 
         # Redis pre 6 had no sync_type.
@@ -5088,7 +5088,7 @@ def script_kill(self) -> ResponseT:
         """
         Kill the currently executing Lua script
 
-        For more information check https://redis.io/commands/script-kill
+        For more information see https://redis.io/commands/script-kill
         """
         return self.execute_command("SCRIPT KILL")
 
@@ -5096,7 +5096,7 @@ def script_load(self, script: ScriptTextT) -> ResponseT:
         """
         Load a Lua ``script`` into the script cache. Returns the SHA.
 
-        For more information check https://redis.io/commands/script-load
+        For more information see https://redis.io/commands/script-load
         """
         return self.execute_command("SCRIPT LOAD", script)
 
@@ -5156,7 +5156,7 @@ def geoadd(
         Changed elements include new elements that were added and elements
         whose scores changed.
 
-        For more information check https://redis.io/commands/geoadd
+        For more information see https://redis.io/commands/geoadd
         """
         if nx and xx:
             raise DataError("GEOADD allows either 'nx' or 'xx', not both")
@@ -5185,7 +5185,7 @@ def geodist(
         The units must be one of the following : m, km mi, ft. By default
         meters are used.
 
-        For more information check https://redis.io/commands/geodist
+        For more information see https://redis.io/commands/geodist
         """
         pieces: list[EncodableT] = [name, place1, place2]
         if unit and unit not in ("m", "km", "mi", "ft"):
@@ -5199,7 +5199,7 @@ def geohash(self, name: KeyT, *values: FieldT) -> ResponseT:
         Return the geo hash string for each item of ``values`` members of
         the specified key identified by the ``name`` argument.
 
-        For more information check https://redis.io/commands/geohash
+        For more information see https://redis.io/commands/geohash
         """
         return self.execute_command("GEOHASH", name, *values)
 
@@ -5209,7 +5209,7 @@ def geopos(self, name: KeyT, *values: FieldT) -> ResponseT:
         the specified key identified by the ``name`` argument. Each position
         is represented by the pairs lon and lat.
 
-        For more information check https://redis.io/commands/geopos
+        For more information see https://redis.io/commands/geopos
         """
         return self.execute_command("GEOPOS", name, *values)
 
@@ -5257,7 +5257,7 @@ def georadius(
         named with a specific key, instead of ``store`` the sorted set
         destination score is set with the distance.
 
-        For more information check https://redis.io/commands/georadius
+        For more information see https://redis.io/commands/georadius
         """
         return self._georadiusgeneric(
             "GEORADIUS",
@@ -5297,7 +5297,7 @@ def georadiusbymember(
         and latitude value, it takes the name of a member already existing
         inside the geospatial index represented by the sorted set.
 
-        For more information check https://redis.io/commands/georadiusbymember
+        For more information see https://redis.io/commands/georadiusbymember
         """
         return self._georadiusgeneric(
             "GEORADIUSBYMEMBER",
@@ -5415,7 +5415,7 @@ def geosearch(
         each place.
         ``withhash`` indicates to return the geohash string of each place.
 
-        For more information check https://redis.io/commands/geosearch
+        For more information see https://redis.io/commands/geosearch
         """
 
         return self._geosearchgeneric(
@@ -5462,7 +5462,7 @@ def geosearchstore(
         items in a sorted set populated with their distance from the
         center of the circle or box, as a floating-point number.
 
-        For more information check https://redis.io/commands/geosearchstore
+        For more information see https://redis.io/commands/geosearchstore
         """
         return self._geosearchgeneric(
             "GEOSEARCHSTORE",
@@ -5570,7 +5570,7 @@ def module_load(self, path, *args) -> ResponseT:
         Passes all ``*args`` to the module, during loading.
         Raises ``ModuleError`` if a module is not found at ``path``.
 
-        For more information check https://redis.io/commands/module-load
+        For more information see https://redis.io/commands/module-load
         """
         return self.execute_command("MODULE LOAD", path, *args)
 
@@ -5579,7 +5579,7 @@ def module_unload(self, name) -> ResponseT:
         Unloads the module ``name``.
         Raises ``ModuleError`` if ``name`` is not in loaded modules.
 
-        For more information check https://redis.io/commands/module-unload
+        For more information see https://redis.io/commands/module-unload
         """
         return self.execute_command("MODULE UNLOAD", name)
 
@@ -5588,7 +5588,7 @@ def module_list(self) -> ResponseT:
         Returns a list of dictionaries containing the name and version of
         all loaded modules.
 
-        For more information check https://redis.io/commands/module-list
+        For more information see https://redis.io/commands/module-list
         """
         return self.execute_command("MODULE LIST")
 
@@ -5680,7 +5680,7 @@ def readwrite(self, **kwargs) -> ResponseT:
         """
         Disables read queries for a connection to a Redis Cluster slave node.
 
-        For more information check https://redis.io/commands/readwrite
+        For more information see https://redis.io/commands/readwrite
         """
         return self.execute_command("READWRITE", **kwargs)
 
@@ -5688,7 +5688,7 @@ def readonly(self, **kwargs) -> ResponseT:
         """
         Enables read queries for a connection to a Redis Cluster replica node.
 
-        For more information check https://redis.io/commands/readonly
+        For more information see https://redis.io/commands/readonly
         """
         return self.execute_command("READONLY", **kwargs)
 
@@ -5718,7 +5718,7 @@ def function_load(
          ``library`` already exists
         :param description: description to the library
 
-        For more information check https://redis.io/commands/function-load
+        For more information see https://redis.io/commands/function-load
         """
         pieces = [engine, library]
         if replace:
@@ -5732,7 +5732,7 @@ def function_delete(self, library: str) -> Union[Awaitable[str], str]:
         """
         Delete the library called ``library`` and all its functions.
 
-        For more information check https://redis.io/commands/function-delete
+        For more information see https://redis.io/commands/function-delete
         """
         return self.execute_command("FUNCTION DELETE", library)
 
@@ -5740,7 +5740,7 @@ def function_flush(self, mode: str = "SYNC") -> Union[Awaitable[str], str]:
         """
         Deletes all the libraries.
 
-        For more information check https://redis.io/commands/function-flush
+        For more information see https://redis.io/commands/function-flush
         """
         return self.execute_command("FUNCTION FLUSH", mode)
 
@@ -5769,7 +5769,7 @@ def fcall(
         """
         Invoke a function.
 
-        For more information check https://redis.io/commands/fcall
+        For more information see https://redis.io/commands/fcall
         """
         return self._fcall("FCALL", function, numkeys, *keys_and_args)
 
@@ -5780,7 +5780,7 @@ def fcall_ro(
         This is a read-only variant of the FCALL command that cannot
         execute commands that modify data.
 
-        For more information check https://redis.io/commands/fcal_ro
+        For more information see https://redis.io/commands/fcal_ro
         """
         return self._fcall("FCALL_RO", function, numkeys, *keys_and_args)
 
@@ -5788,7 +5788,7 @@ def function_dump(self) -> Union[Awaitable[str], str]:
         """
         Return the serialized payload of loaded libraries.
 
-        For more information check https://redis.io/commands/function-dump
+        For more information see https://redis.io/commands/function-dump
         """
         from redis.client import NEVER_DECODE
 
@@ -5805,7 +5805,7 @@ def function_restore(
         You can use the optional policy argument to provide a policy
         for handling existing libraries.
 
-        For more information check https://redis.io/commands/function-restore
+        For more information see https://redis.io/commands/function-restore
         """
         return self.execute_command("FUNCTION RESTORE", payload, policy)
 
@@ -5813,7 +5813,7 @@ def function_kill(self) -> Union[Awaitable[str], str]:
         """
         Kill a function that is currently executing.
 
-        For more information check https://redis.io/commands/function-kill
+        For more information see https://redis.io/commands/function-kill
         """
         return self.execute_command("FUNCTION KILL")
 
@@ -5822,7 +5822,7 @@ def function_stats(self) -> Union[Awaitable[List], List]:
         Return information about the function that's currently running
         and information about the available execution engines.
 
-        For more information check https://redis.io/commands/function-stats
+        For more information see https://redis.io/commands/function-stats
         """
         return self.execute_command("FUNCTION STATS")
 

From 51a4dd91f05fe003ba0edacfcc6e6cebe2064e38 Mon Sep 17 00:00:00 2001
From: Mason <2600910+nosammai@users.noreply.github.com>
Date: Mon, 4 Apr 2022 03:16:18 -0700
Subject: [PATCH 0455/1164] Fix disable decode for dump command on asyncio
 (#2070)

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/asyncio/client.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index bbf2a676ed..368607b8a0 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -485,7 +485,7 @@ async def parse_response(
         """Parses a response from the Redis server"""
         try:
             if NEVER_DECODE in options:
-                response = await connection.read_response(disable_encoding=True)
+                response = await connection.read_response(disable_decoding=True)
             else:
                 response = await connection.read_response()
         except ResponseError:

From ff938171ecec864fd820a7e2b5add3e311b7b3df Mon Sep 17 00:00:00 2001
From: Bea Steers <bea.steers@gmail.com>
Date: Mon, 4 Apr 2022 06:18:32 -0400
Subject: [PATCH 0456/1164] always clear reference to closed reader/writer
 (#2077)

* always clear reference to reader/writer

* add #2065 to changes
---
 CHANGES                     | 1 +
 redis/asyncio/connection.py | 5 +++--
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/CHANGES b/CHANGES
index 95843ec7ff..010612f756 100644
--- a/CHANGES
+++ b/CHANGES
@@ -6,6 +6,7 @@
     * Fix cursor returned by SCAN for RedisCluster & change default target to PRIMARIES
     * Fix scan_iter for RedisCluster
     * Remove verbose logging when initializing ClusterPubSub, ClusterPipeline or RedisCluster
+    * Fix broken connection writer lock-up for asyncio (#2065)
 
 * 4.1.3 (Feb 8, 2022)
     * Fix flushdb and flushall (#1926)
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 0c5398568e..f0e6d3da4f 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -827,8 +827,9 @@ async def disconnect(self):
                             await self._writer.wait_closed()  # type: ignore[union-attr]
                 except OSError:
                     pass
-                self._reader = None
-                self._writer = None
+                finally:
+                    self._reader = None
+                    self._writer = None
         except asyncio.TimeoutError:
             raise TimeoutError(
                 f"Timed out closing connection after {self.socket_connect_timeout}"

From e6968f8d73f85c2ab50a145aeccfa289719fdddf Mon Sep 17 00:00:00 2001
From: wwqgtxx <wwqgtxx@gmail.com>
Date: Mon, 4 Apr 2022 18:21:43 +0800
Subject: [PATCH 0457/1164] fix asynic/client.py's import (#2079)

* fix asynic/client.py's import

Lock and Retry should be from redis.asyncio

* for code linters
---
 redis/asyncio/client.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 368607b8a0..7175e02972 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -30,6 +30,8 @@
     SSLConnection,
     UnixDomainSocketConnection,
 )
+from redis.asyncio.lock import Lock
+from redis.asyncio.retry import Retry
 from redis.client import (
     EMPTY_RESPONSE,
     NEVER_DECODE,
@@ -53,8 +55,6 @@
     TimeoutError,
     WatchError,
 )
-from redis.lock import Lock
-from redis.retry import Retry
 from redis.typing import ChannelT, EncodableT, KeyT
 from redis.utils import safe_str, str_if_bytes
 

From 0676892ae3ec18a0e2c292b22f08ec4b86e0bbe4 Mon Sep 17 00:00:00 2001
From: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Date: Mon, 4 Apr 2022 13:33:09 +0300
Subject: [PATCH 0458/1164] Extended "CLUSTER NODES" parser to support special
 slot entries (importing, migrating). (#2080)

See https://redis.io/commands/cluster-nodes/#special-slot-entries

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/client.py       | 33 ++++++++++++++++++++++++++++-----
 tests/test_cluster.py | 37 +++++++++++++++++++++++++++++++++++++
 2 files changed, 65 insertions(+), 5 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 8c17665dbc..d8d7a75ce0 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -466,7 +466,6 @@ def _parse_node_line(line):
     line_items = line.split(" ")
     node_id, addr, flags, master_id, ping, pong, epoch, connected = line.split(" ")[:8]
     addr = addr.split("@")[0]
-    slots = [sl.split("-") for sl in line_items[8:]]
     node_dict = {
         "node_id": node_id,
         "flags": flags,
@@ -474,18 +473,42 @@ def _parse_node_line(line):
         "last_ping_sent": ping,
         "last_pong_rcvd": pong,
         "epoch": epoch,
-        "slots": slots,
+        "slots": [],
+        "migrations": [],
         "connected": True if connected == "connected" else False,
     }
+    if len(line_items) >= 9:
+        slots, migrations = _parse_slots(line_items[8:])
+        node_dict["slots"], node_dict["migrations"] = slots, migrations
     return addr, node_dict
 
 
+def _parse_slots(slot_ranges):
+    slots, migrations = [], []
+    for s_range in slot_ranges:
+        if "->-" in s_range:
+            slot_id, dst_node_id = s_range[1:-1].split("->-", 1)
+            migrations.append(
+                {"slot": slot_id, "node_id": dst_node_id, "state": "migrating"}
+            )
+        elif "-<-" in s_range:
+            slot_id, src_node_id = s_range[1:-1].split("-<-", 1)
+            migrations.append(
+                {"slot": slot_id, "node_id": src_node_id, "state": "importing"}
+            )
+        else:
+            s_range = [sl for sl in s_range.split("-")]
+            slots.append(s_range)
+
+    return slots, migrations
+
+
 def parse_cluster_nodes(response, **options):
     """
-    @see: https://redis.io/commands/cluster-nodes  # string
-    @see: https://redis.io/commands/cluster-replicas # list of string
+    @see: https://redis.io/commands/cluster-nodes  # string / bytes
+    @see: https://redis.io/commands/cluster-replicas # list of string / bytes
     """
-    if isinstance(response, str):
+    if isinstance(response, (str, bytes)):
         response = response.splitlines()
     return dict(_parse_node_line(str_if_bytes(node)) for node in response)
 
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 1ee5cdf450..3794c31891 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -967,6 +967,43 @@ def test_cluster_nodes(self, r):
             == "c8253bae761cb1ecb2b61857d85dfe455a0fec8b"
         )
 
+    @skip_if_redis_enterprise()
+    def test_cluster_nodes_importing_migrating(self, r):
+        response = (
+            "488ead2fcce24d8c0f158f9172cb1f4a9e040fe5 127.0.0.1:16381@26381 "
+            "master - 0 1648975557664 3 connected 10923-16383\n"
+            "8ae2e70812db80776f739a72374e57fc4ae6f89d 127.0.0.1:16380@26380 "
+            "master - 0 1648975555000 2 connected 1 5461-10922 ["
+            "2-<-ed8007ccfa2d91a7b76f8e6fba7ba7e257034a16]\n"
+            "ed8007ccfa2d91a7b76f8e6fba7ba7e257034a16 127.0.0.1:16379@26379 "
+            "myself,master - 0 1648975556000 1 connected 0 2-5460 ["
+            "2->-8ae2e70812db80776f739a72374e57fc4ae6f89d]\n"
+        )
+        mock_all_nodes_resp(r, response)
+        nodes = r.cluster_nodes()
+        assert len(nodes) == 3
+        node_16379 = nodes.get("127.0.0.1:16379")
+        node_16380 = nodes.get("127.0.0.1:16380")
+        node_16381 = nodes.get("127.0.0.1:16381")
+        assert node_16379.get("migrations") == [
+            {
+                "slot": "2",
+                "node_id": "8ae2e70812db80776f739a72374e57fc4ae6f89d",
+                "state": "migrating",
+            }
+        ]
+        assert node_16379.get("slots") == [["0"], ["2", "5460"]]
+        assert node_16380.get("migrations") == [
+            {
+                "slot": "2",
+                "node_id": "ed8007ccfa2d91a7b76f8e6fba7ba7e257034a16",
+                "state": "importing",
+            }
+        ]
+        assert node_16380.get("slots") == [["1"], ["5461", "10922"]]
+        assert node_16381.get("slots") == [["10923", "16383"]]
+        assert node_16381.get("migrations") == []
+
     @skip_if_redis_enterprise()
     def test_cluster_replicate(self, r):
         node = r.get_random_node()

From 20e4b873151804f596fa324c38f18fae175c2e63 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 4 Apr 2022 14:05:58 +0300
Subject: [PATCH 0459/1164] v4.2.2 (#2084)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index f91f26759b..423117bb50 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.2.1",
+    version="4.2.2",
     packages=find_packages(
         include=[
             "redis",

From cb91eed751c226ebca5b1b8e8d62769fdee9bfbc Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 7 Apr 2022 14:46:11 +0300
Subject: [PATCH 0460/1164] Async tests for redis commands, json, bloom,
 timeseries (#2087)

* test async commands

* test async json commands

* test async timeseries commands

* test async bloom commands

* linters

* linters

* skip on cluster

* linters

* linters

* isort

* flynt

* remove print
---
 redis/asyncio/client.py               |    8 +
 tests/test_asyncio/conftest.py        |   12 +-
 tests/test_asyncio/test_bloom.py      |  402 ++++
 tests/test_asyncio/test_commands.py   | 3049 +++++++++++++++++++++++++
 tests/test_asyncio/test_json.py       |  964 ++++++++
 tests/test_asyncio/test_timeseries.py |  556 +++++
 tox.ini                               |    2 +-
 7 files changed, 4991 insertions(+), 2 deletions(-)
 create mode 100644 tests/test_asyncio/test_bloom.py
 create mode 100644 tests/test_asyncio/test_json.py
 create mode 100644 tests/test_asyncio/test_timeseries.py

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 7175e02972..559b74c9f6 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -255,6 +255,14 @@ def set_response_callback(self, command: str, callback: ResponseCallbackT):
         """Set a custom Response Callback"""
         self.response_callbacks[command] = callback
 
+    def get_encoder(self):
+        """Get the connection pool's encoder"""
+        return self.connection_pool.get_encoder()
+
+    def get_connection_kwargs(self):
+        """Get the connection's key-word arguments"""
+        return self.connection_pool.connection_kwargs
+
     def load_external_module(
         self,
         funcname,
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index 0e9c73ec61..34c22c5a55 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -20,6 +20,8 @@
     PythonParser,
     parse_url,
 )
+from redis.asyncio.retry import Retry
+from redis.backoff import NoBackoff
 from tests.conftest import REDIS_INFO
 
 from .compat import mock
@@ -97,7 +99,7 @@ async def ateardown():
 
 
 @pytest_asyncio.fixture()
-async def r(create_redis):
+async def r(request, create_redis):
     yield await create_redis()
 
 
@@ -107,8 +109,16 @@ async def r2(create_redis):
     yield await create_redis()
 
 
+@pytest_asyncio.fixture()
+async def modclient(request, create_redis):
+    yield await create_redis(
+        url=request.config.getoption("--redismod-url"), decode_responses=True
+    )
+
+
 def _gen_cluster_mock_resp(r, response):
     connection = mock.AsyncMock()
+    connection.retry = Retry(NoBackoff(), 0)
     connection.read_response.return_value = response
     r.connection = connection
     return r
diff --git a/tests/test_asyncio/test_bloom.py b/tests/test_asyncio/test_bloom.py
new file mode 100644
index 0000000000..feb98cc41e
--- /dev/null
+++ b/tests/test_asyncio/test_bloom.py
@@ -0,0 +1,402 @@
+import pytest
+
+import redis.asyncio as redis
+from redis.exceptions import ModuleError, RedisError
+from redis.utils import HIREDIS_AVAILABLE
+
+pytestmark = pytest.mark.asyncio
+
+
+def intlist(obj):
+    return [int(v) for v in obj]
+
+
+# @pytest.fixture
+# async def client(modclient):
+#     assert isinstance(modawait modclient.bf(), redis.commands.bf.BFBloom)
+#     assert isinstance(modawait modclient.cf(), redis.commands.bf.CFBloom)
+#     assert isinstance(modawait modclient.cms(), redis.commands.bf.CMSBloom)
+#     assert isinstance(modawait modclient.tdigest(), redis.commands.bf.TDigestBloom)
+#     assert isinstance(modawait modclient.topk(), redis.commands.bf.TOPKBloom)
+
+#     modawait modclient.flushdb()
+#     return modclient
+
+
+@pytest.mark.redismod
+async def test_create(modclient: redis.Redis):
+    """Test CREATE/RESERVE calls"""
+    assert await modclient.bf().create("bloom", 0.01, 1000)
+    assert await modclient.bf().create("bloom_e", 0.01, 1000, expansion=1)
+    assert await modclient.bf().create("bloom_ns", 0.01, 1000, noScale=True)
+    assert await modclient.cf().create("cuckoo", 1000)
+    assert await modclient.cf().create("cuckoo_e", 1000, expansion=1)
+    assert await modclient.cf().create("cuckoo_bs", 1000, bucket_size=4)
+    assert await modclient.cf().create("cuckoo_mi", 1000, max_iterations=10)
+    assert await modclient.cms().initbydim("cmsDim", 100, 5)
+    assert await modclient.cms().initbyprob("cmsProb", 0.01, 0.01)
+    assert await modclient.topk().reserve("topk", 5, 100, 5, 0.9)
+
+
+@pytest.mark.redismod
+@pytest.mark.experimental
+async def test_tdigest_create(modclient: redis.Redis):
+    assert await modclient.tdigest().create("tDigest", 100)
+
+
+# region Test Bloom Filter
+@pytest.mark.redismod
+async def test_bf_add(modclient: redis.Redis):
+    assert await modclient.bf().create("bloom", 0.01, 1000)
+    assert 1 == await modclient.bf().add("bloom", "foo")
+    assert 0 == await modclient.bf().add("bloom", "foo")
+    assert [0] == intlist(await modclient.bf().madd("bloom", "foo"))
+    assert [0, 1] == await modclient.bf().madd("bloom", "foo", "bar")
+    assert [0, 0, 1] == await modclient.bf().madd("bloom", "foo", "bar", "baz")
+    assert 1 == await modclient.bf().exists("bloom", "foo")
+    assert 0 == await modclient.bf().exists("bloom", "noexist")
+    assert [1, 0] == intlist(await modclient.bf().mexists("bloom", "foo", "noexist"))
+
+
+@pytest.mark.redismod
+async def test_bf_insert(modclient: redis.Redis):
+    assert await modclient.bf().create("bloom", 0.01, 1000)
+    assert [1] == intlist(await modclient.bf().insert("bloom", ["foo"]))
+    assert [0, 1] == intlist(await modclient.bf().insert("bloom", ["foo", "bar"]))
+    assert [1] == intlist(await modclient.bf().insert("captest", ["foo"], capacity=10))
+    assert [1] == intlist(await modclient.bf().insert("errtest", ["foo"], error=0.01))
+    assert 1 == await modclient.bf().exists("bloom", "foo")
+    assert 0 == await modclient.bf().exists("bloom", "noexist")
+    assert [1, 0] == intlist(await modclient.bf().mexists("bloom", "foo", "noexist"))
+    info = await modclient.bf().info("bloom")
+    assert 2 == info.insertedNum
+    assert 1000 == info.capacity
+    assert 1 == info.filterNum
+
+
+@pytest.mark.redismod
+async def test_bf_scandump_and_loadchunk(modclient: redis.Redis):
+    # Store a filter
+    await modclient.bf().create("myBloom", "0.0001", "1000")
+
+    # test is probabilistic and might fail. It is OK to change variables if
+    # certain to not break anything
+    async def do_verify():
+        res = 0
+        for x in range(1000):
+            await modclient.bf().add("myBloom", x)
+            rv = await modclient.bf().exists("myBloom", x)
+            assert rv
+            rv = await modclient.bf().exists("myBloom", f"nonexist_{x}")
+            res += rv == x
+        assert res < 5
+
+    do_verify()
+    cmds = []
+    if HIREDIS_AVAILABLE:
+        with pytest.raises(ModuleError):
+            cur = await modclient.bf().scandump("myBloom", 0)
+        return
+
+    cur = await modclient.bf().scandump("myBloom", 0)
+    first = cur[0]
+    cmds.append(cur)
+
+    while True:
+        cur = await modclient.bf().scandump("myBloom", first)
+        first = cur[0]
+        if first == 0:
+            break
+        else:
+            cmds.append(cur)
+    prev_info = await modclient.bf().execute_command("bf.debug", "myBloom")
+
+    # Remove the filter
+    await modclient.bf().client.delete("myBloom")
+
+    # Now, load all the commands:
+    for cmd in cmds:
+        await modclient.bf().loadchunk("myBloom", *cmd)
+
+    cur_info = await modclient.bf().execute_command("bf.debug", "myBloom")
+    assert prev_info == cur_info
+    do_verify()
+
+    await modclient.bf().client.delete("myBloom")
+    await modclient.bf().create("myBloom", "0.0001", "10000000")
+
+
+@pytest.mark.redismod
+async def test_bf_info(modclient: redis.Redis):
+    expansion = 4
+    # Store a filter
+    await modclient.bf().create("nonscaling", "0.0001", "1000", noScale=True)
+    info = await modclient.bf().info("nonscaling")
+    assert info.expansionRate is None
+
+    await modclient.bf().create("expanding", "0.0001", "1000", expansion=expansion)
+    info = await modclient.bf().info("expanding")
+    assert info.expansionRate == 4
+
+    try:
+        # noScale mean no expansion
+        await modclient.bf().create(
+            "myBloom", "0.0001", "1000", expansion=expansion, noScale=True
+        )
+        assert False
+    except RedisError:
+        assert True
+
+
+# region Test Cuckoo Filter
+@pytest.mark.redismod
+async def test_cf_add_and_insert(modclient: redis.Redis):
+    assert await modclient.cf().create("cuckoo", 1000)
+    assert await modclient.cf().add("cuckoo", "filter")
+    assert not await modclient.cf().addnx("cuckoo", "filter")
+    assert 1 == await modclient.cf().addnx("cuckoo", "newItem")
+    assert [1] == await modclient.cf().insert("captest", ["foo"])
+    assert [1] == await modclient.cf().insert("captest", ["foo"], capacity=1000)
+    assert [1] == await modclient.cf().insertnx("captest", ["bar"])
+    assert [1] == await modclient.cf().insertnx("captest", ["food"], nocreate="1")
+    assert [0, 0, 1] == await modclient.cf().insertnx("captest", ["foo", "bar", "baz"])
+    assert [0] == await modclient.cf().insertnx("captest", ["bar"], capacity=1000)
+    assert [1] == await modclient.cf().insert("empty1", ["foo"], capacity=1000)
+    assert [1] == await modclient.cf().insertnx("empty2", ["bar"], capacity=1000)
+    info = await modclient.cf().info("captest")
+    assert 5 == info.insertedNum
+    assert 0 == info.deletedNum
+    assert 1 == info.filterNum
+
+
+@pytest.mark.redismod
+async def test_cf_exists_and_del(modclient: redis.Redis):
+    assert await modclient.cf().create("cuckoo", 1000)
+    assert await modclient.cf().add("cuckoo", "filter")
+    assert await modclient.cf().exists("cuckoo", "filter")
+    assert not await modclient.cf().exists("cuckoo", "notexist")
+    assert 1 == await modclient.cf().count("cuckoo", "filter")
+    assert 0 == await modclient.cf().count("cuckoo", "notexist")
+    assert await modclient.cf().delete("cuckoo", "filter")
+    assert 0 == await modclient.cf().count("cuckoo", "filter")
+
+
+# region Test Count-Min Sketch
+@pytest.mark.redismod
+async def test_cms(modclient: redis.Redis):
+    assert await modclient.cms().initbydim("dim", 1000, 5)
+    assert await modclient.cms().initbyprob("prob", 0.01, 0.01)
+    assert await modclient.cms().incrby("dim", ["foo"], [5])
+    assert [0] == await modclient.cms().query("dim", "notexist")
+    assert [5] == await modclient.cms().query("dim", "foo")
+    assert [10, 15] == await modclient.cms().incrby("dim", ["foo", "bar"], [5, 15])
+    assert [10, 15] == await modclient.cms().query("dim", "foo", "bar")
+    info = await modclient.cms().info("dim")
+    assert 1000 == info.width
+    assert 5 == info.depth
+    assert 25 == info.count
+
+
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+async def test_cms_merge(modclient: redis.Redis):
+    assert await modclient.cms().initbydim("A", 1000, 5)
+    assert await modclient.cms().initbydim("B", 1000, 5)
+    assert await modclient.cms().initbydim("C", 1000, 5)
+    assert await modclient.cms().incrby("A", ["foo", "bar", "baz"], [5, 3, 9])
+    assert await modclient.cms().incrby("B", ["foo", "bar", "baz"], [2, 3, 1])
+    assert [5, 3, 9] == await modclient.cms().query("A", "foo", "bar", "baz")
+    assert [2, 3, 1] == await modclient.cms().query("B", "foo", "bar", "baz")
+    assert await modclient.cms().merge("C", 2, ["A", "B"])
+    assert [7, 6, 10] == await modclient.cms().query("C", "foo", "bar", "baz")
+    assert await modclient.cms().merge("C", 2, ["A", "B"], ["1", "2"])
+    assert [9, 9, 11] == await modclient.cms().query("C", "foo", "bar", "baz")
+    assert await modclient.cms().merge("C", 2, ["A", "B"], ["2", "3"])
+    assert [16, 15, 21] == await modclient.cms().query("C", "foo", "bar", "baz")
+
+
+# endregion
+
+
+# region Test Top-K
+@pytest.mark.redismod
+async def test_topk(modclient: redis.Redis):
+    # test list with empty buckets
+    assert await modclient.topk().reserve("topk", 3, 50, 4, 0.9)
+    assert [
+        None,
+        None,
+        None,
+        "A",
+        "C",
+        "D",
+        None,
+        None,
+        "E",
+        None,
+        "B",
+        "C",
+        None,
+        None,
+        None,
+        "D",
+        None,
+    ] == await modclient.topk().add(
+        "topk",
+        "A",
+        "B",
+        "C",
+        "D",
+        "E",
+        "A",
+        "A",
+        "B",
+        "C",
+        "G",
+        "D",
+        "B",
+        "D",
+        "A",
+        "E",
+        "E",
+        1,
+    )
+    assert [1, 1, 0, 0, 1, 0, 0] == await modclient.topk().query(
+        "topk", "A", "B", "C", "D", "E", "F", "G"
+    )
+    assert [4, 3, 2, 3, 3, 0, 1] == await modclient.topk().count(
+        "topk", "A", "B", "C", "D", "E", "F", "G"
+    )
+
+    # test full list
+    assert await modclient.topk().reserve("topklist", 3, 50, 3, 0.9)
+    assert await modclient.topk().add(
+        "topklist",
+        "A",
+        "B",
+        "C",
+        "D",
+        "E",
+        "A",
+        "A",
+        "B",
+        "C",
+        "G",
+        "D",
+        "B",
+        "D",
+        "A",
+        "E",
+        "E",
+    )
+    assert ["A", "B", "E"] == await modclient.topk().list("topklist")
+    res = await modclient.topk().list("topklist", withcount=True)
+    assert ["A", 4, "B", 3, "E", 3] == res
+    info = await modclient.topk().info("topklist")
+    assert 3 == info.k
+    assert 50 == info.width
+    assert 3 == info.depth
+    assert 0.9 == round(float(info.decay), 1)
+
+
+@pytest.mark.redismod
+async def test_topk_incrby(modclient: redis.Redis):
+    await modclient.flushdb()
+    assert await modclient.topk().reserve("topk", 3, 10, 3, 1)
+    assert [None, None, None] == await modclient.topk().incrby(
+        "topk", ["bar", "baz", "42"], [3, 6, 2]
+    )
+    res = await modclient.topk().incrby("topk", ["42", "xyzzy"], [8, 4])
+    assert [None, "bar"] == res
+    assert [3, 6, 10, 4, 0] == await modclient.topk().count(
+        "topk", "bar", "baz", "42", "xyzzy", 4
+    )
+
+
+# region Test T-Digest
+@pytest.mark.redismod
+@pytest.mark.experimental
+async def test_tdigest_reset(modclient: redis.Redis):
+    assert await modclient.tdigest().create("tDigest", 10)
+    # reset on empty histogram
+    assert await modclient.tdigest().reset("tDigest")
+    # insert data-points into sketch
+    assert await modclient.tdigest().add("tDigest", list(range(10)), [1.0] * 10)
+
+    assert await modclient.tdigest().reset("tDigest")
+    # assert we have 0 unmerged nodes
+    assert 0 == (await modclient.tdigest().info("tDigest")).unmergedNodes
+
+
+@pytest.mark.redismod
+@pytest.mark.experimental
+async def test_tdigest_merge(modclient: redis.Redis):
+    assert await modclient.tdigest().create("to-tDigest", 10)
+    assert await modclient.tdigest().create("from-tDigest", 10)
+    # insert data-points into sketch
+    assert await modclient.tdigest().add("from-tDigest", [1.0] * 10, [1.0] * 10)
+    assert await modclient.tdigest().add("to-tDigest", [2.0] * 10, [10.0] * 10)
+    # merge from-tdigest into to-tdigest
+    assert await modclient.tdigest().merge("to-tDigest", "from-tDigest")
+    # we should now have 110 weight on to-histogram
+    info = await modclient.tdigest().info("to-tDigest")
+    total_weight_to = float(info.mergedWeight) + float(info.unmergedWeight)
+    assert 110 == total_weight_to
+
+
+@pytest.mark.redismod
+@pytest.mark.experimental
+async def test_tdigest_min_and_max(modclient: redis.Redis):
+    assert await modclient.tdigest().create("tDigest", 100)
+    # insert data-points into sketch
+    assert await modclient.tdigest().add("tDigest", [1, 2, 3], [1.0] * 3)
+    # min/max
+    assert 3 == await modclient.tdigest().max("tDigest")
+    assert 1 == await modclient.tdigest().min("tDigest")
+
+
+@pytest.mark.redismod
+@pytest.mark.experimental
+async def test_tdigest_quantile(modclient: redis.Redis):
+    assert await modclient.tdigest().create("tDigest", 500)
+    # insert data-points into sketch
+    assert await modclient.tdigest().add(
+        "tDigest", list([x * 0.01 for x in range(1, 10000)]), [1.0] * 10000
+    )
+    # assert min min/max have same result as quantile 0 and 1
+    assert await modclient.tdigest().max(
+        "tDigest"
+    ) == await modclient.tdigest().quantile("tDigest", 1.0)
+    assert await modclient.tdigest().min(
+        "tDigest"
+    ) == await modclient.tdigest().quantile("tDigest", 0.0)
+
+    assert 1.0 == round(await modclient.tdigest().quantile("tDigest", 0.01), 2)
+    assert 99.0 == round(await modclient.tdigest().quantile("tDigest", 0.99), 2)
+
+
+@pytest.mark.redismod
+@pytest.mark.experimental
+async def test_tdigest_cdf(modclient: redis.Redis):
+    assert await modclient.tdigest().create("tDigest", 100)
+    # insert data-points into sketch
+    assert await modclient.tdigest().add("tDigest", list(range(1, 10)), [1.0] * 10)
+    assert 0.1 == round(await modclient.tdigest().cdf("tDigest", 1.0), 1)
+    assert 0.9 == round(await modclient.tdigest().cdf("tDigest", 9.0), 1)
+
+
+# @pytest.mark.redismod
+# async def test_pipeline(modclient: redis.Redis):
+#     pipeline = await modclient.bf().pipeline()
+#     assert not await modclient.bf().execute_command("get pipeline")
+#
+#     assert await modclient.bf().create("pipeline", 0.01, 1000)
+#     for i in range(100):
+#         pipeline.add("pipeline", i)
+#     for i in range(100):
+#         assert not (await modclient.bf().exists("pipeline", i))
+#
+#     pipeline.execute()
+#
+#     for i in range(100):
+#         assert await modclient.bf().exists("pipeline", i)
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 12855c9326..78220406eb 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -1,3 +1,3052 @@
 """
 Tests async overrides of commands from their mixins
 """
+import binascii
+import datetime
+import re
+import time
+from string import ascii_letters
+
+import pytest
+
+import redis
+from redis import exceptions
+from redis.client import parse_info
+from tests.conftest import (
+    skip_if_server_version_gte,
+    skip_if_server_version_lt,
+    skip_unless_arch_bits,
+)
+
+REDIS_6_VERSION = "5.9.0"
+
+
+pytestmark = [pytest.mark.asyncio, pytest.mark.onlynoncluster]
+
+
+@pytest.fixture()
+async def slowlog(r: redis.Redis, event_loop):
+    current_config = await r.config_get()
+    old_slower_than_value = current_config["slowlog-log-slower-than"]
+    old_max_legnth_value = current_config["slowlog-max-len"]
+
+    await r.config_set("slowlog-log-slower-than", 0)
+    await r.config_set("slowlog-max-len", 128)
+
+    yield
+
+    await r.config_set("slowlog-log-slower-than", old_slower_than_value)
+    await r.config_set("slowlog-max-len", old_max_legnth_value)
+
+
+async def redis_server_time(client: redis.Redis):
+    seconds, milliseconds = await client.time()
+    timestamp = float(f"{seconds}.{milliseconds}")
+    return datetime.datetime.fromtimestamp(timestamp)
+
+
+async def get_stream_message(client: redis.Redis, stream: str, message_id: str):
+    """Fetch a stream message and format it as a (message_id, fields) pair"""
+    response = await client.xrange(stream, min=message_id, max=message_id)
+    assert len(response) == 1
+    return response[0]
+
+
+# RESPONSE CALLBACKS
+class TestResponseCallbacks:
+    """Tests for the response callback system"""
+
+    async def test_response_callbacks(self, r: redis.Redis):
+        assert r.response_callbacks == redis.Redis.RESPONSE_CALLBACKS
+        assert id(r.response_callbacks) != id(redis.Redis.RESPONSE_CALLBACKS)
+        r.set_response_callback("GET", lambda x: "static")
+        await r.set("a", "foo")
+        assert await r.get("a") == "static"
+
+    async def test_case_insensitive_command_names(self, r: redis.Redis):
+        assert r.response_callbacks["del"] == r.response_callbacks["DEL"]
+
+
+class TestRedisCommands:
+    async def test_command_on_invalid_key_type(self, r: redis.Redis):
+        await r.lpush("a", "1")
+        with pytest.raises(redis.ResponseError):
+            await r.get("a")
+
+    # SERVER INFORMATION
+    @skip_if_server_version_lt(REDIS_6_VERSION)
+    async def test_acl_cat_no_category(self, r: redis.Redis):
+        categories = await r.acl_cat()
+        assert isinstance(categories, list)
+        assert "read" in categories
+
+    @skip_if_server_version_lt(REDIS_6_VERSION)
+    async def test_acl_cat_with_category(self, r: redis.Redis):
+        commands = await r.acl_cat("read")
+        assert isinstance(commands, list)
+        assert "get" in commands
+
+    @skip_if_server_version_lt(REDIS_6_VERSION)
+    async def test_acl_deluser(self, r: redis.Redis, request, event_loop):
+        username = "redis-py-user"
+
+        def teardown():
+            coro = r.acl_deluser(username)
+            if event_loop.is_running():
+                event_loop.create_task(coro)
+            else:
+                event_loop.run_until_complete(coro)
+
+        request.addfinalizer(teardown)
+
+        assert await r.acl_deluser(username) == 0
+        assert await r.acl_setuser(username, enabled=False, reset=True)
+        assert await r.acl_deluser(username) == 1
+
+    @skip_if_server_version_lt(REDIS_6_VERSION)
+    async def test_acl_genpass(self, r: redis.Redis):
+        password = await r.acl_genpass()
+        assert isinstance(password, str)
+
+    @skip_if_server_version_lt(REDIS_6_VERSION)
+    async def test_acl_getuser_setuser(self, r: redis.Redis, request, event_loop):
+        username = "redis-py-user"
+
+        def teardown():
+            coro = r.acl_deluser(username)
+            if event_loop.is_running():
+                event_loop.create_task(coro)
+            else:
+                event_loop.run_until_complete(coro)
+
+        request.addfinalizer(teardown)
+
+        # test enabled=False
+        assert await r.acl_setuser(username, enabled=False, reset=True)
+        assert await r.acl_getuser(username) == {
+            "categories": ["-@all"],
+            "commands": [],
+            "channels": [b"*"],
+            "enabled": False,
+            "flags": ["off", "allchannels", "sanitize-payload"],
+            "keys": [],
+            "passwords": [],
+        }
+
+        # test nopass=True
+        assert await r.acl_setuser(username, enabled=True, reset=True, nopass=True)
+        assert await r.acl_getuser(username) == {
+            "categories": ["-@all"],
+            "commands": [],
+            "channels": [b"*"],
+            "enabled": True,
+            "flags": ["on", "allchannels", "nopass", "sanitize-payload"],
+            "keys": [],
+            "passwords": [],
+        }
+
+        # test all args
+        assert await r.acl_setuser(
+            username,
+            enabled=True,
+            reset=True,
+            passwords=["+pass1", "+pass2"],
+            categories=["+set", "+@hash", "-geo"],
+            commands=["+get", "+mget", "-hset"],
+            keys=["cache:*", "objects:*"],
+        )
+        acl = await r.acl_getuser(username)
+        assert set(acl["categories"]) == {"-@all", "+@set", "+@hash"}
+        assert set(acl["commands"]) == {"+get", "+mget", "-hset"}
+        assert acl["enabled"] is True
+        assert acl["channels"] == [b"*"]
+        assert acl["flags"] == ["on", "allchannels", "sanitize-payload"]
+        assert set(acl["keys"]) == {b"cache:*", b"objects:*"}
+        assert len(acl["passwords"]) == 2
+
+        # test reset=False keeps existing ACL and applies new ACL on top
+        assert await r.acl_setuser(
+            username,
+            enabled=True,
+            reset=True,
+            passwords=["+pass1"],
+            categories=["+@set"],
+            commands=["+get"],
+            keys=["cache:*"],
+        )
+        assert await r.acl_setuser(
+            username,
+            enabled=True,
+            passwords=["+pass2"],
+            categories=["+@hash"],
+            commands=["+mget"],
+            keys=["objects:*"],
+        )
+        acl = await r.acl_getuser(username)
+        assert set(acl["categories"]) == {"-@all", "+@set", "+@hash"}
+        assert set(acl["commands"]) == {"+get", "+mget"}
+        assert acl["enabled"] is True
+        assert acl["channels"] == [b"*"]
+        assert acl["flags"] == ["on", "allchannels", "sanitize-payload"]
+        assert set(acl["keys"]) == {b"cache:*", b"objects:*"}
+        assert len(acl["passwords"]) == 2
+
+        # test removal of passwords
+        assert await r.acl_setuser(
+            username, enabled=True, reset=True, passwords=["+pass1", "+pass2"]
+        )
+        assert len((await r.acl_getuser(username))["passwords"]) == 2
+        assert await r.acl_setuser(username, enabled=True, passwords=["-pass2"])
+        assert len((await r.acl_getuser(username))["passwords"]) == 1
+
+        # Resets and tests that hashed passwords are set properly.
+        hashed_password = (
+            "5e884898da28047151d0e56f8dc629" "2773603d0d6aabbdd62a11ef721d1542d8"
+        )
+        assert await r.acl_setuser(
+            username, enabled=True, reset=True, hashed_passwords=["+" + hashed_password]
+        )
+        acl = await r.acl_getuser(username)
+        assert acl["passwords"] == [hashed_password]
+
+        # test removal of hashed passwords
+        assert await r.acl_setuser(
+            username,
+            enabled=True,
+            reset=True,
+            hashed_passwords=["+" + hashed_password],
+            passwords=["+pass1"],
+        )
+        assert len((await r.acl_getuser(username))["passwords"]) == 2
+        assert await r.acl_setuser(
+            username, enabled=True, hashed_passwords=["-" + hashed_password]
+        )
+        assert len((await r.acl_getuser(username))["passwords"]) == 1
+
+    @skip_if_server_version_lt(REDIS_6_VERSION)
+    async def test_acl_list(self, r: redis.Redis, request, event_loop):
+        username = "redis-py-user"
+
+        def teardown():
+            coro = r.acl_deluser(username)
+            if event_loop.is_running():
+                event_loop.create_task(coro)
+            else:
+                event_loop.run_until_complete(coro)
+
+        request.addfinalizer(teardown)
+
+        assert await r.acl_setuser(username, enabled=False, reset=True)
+        users = await r.acl_list()
+        assert f"user {username} off sanitize-payload &* -@all" in users
+
+    @skip_if_server_version_lt(REDIS_6_VERSION)
+    async def test_acl_log(self, r: redis.Redis, request, event_loop, create_redis):
+        username = "redis-py-user"
+
+        def teardown():
+            coro = r.acl_deluser(username)
+            if event_loop.is_running():
+                event_loop.create_task(coro)
+            else:
+                event_loop.run_until_complete(coro)
+
+        request.addfinalizer(teardown)
+        await r.acl_setuser(
+            username,
+            enabled=True,
+            reset=True,
+            commands=["+get", "+set", "+select"],
+            keys=["cache:*"],
+            nopass=True,
+        )
+        await r.acl_log_reset()
+
+        user_client = await create_redis(username=username)
+
+        # Valid operation and key
+        assert await user_client.set("cache:0", 1)
+        assert await user_client.get("cache:0") == b"1"
+
+        # Invalid key
+        with pytest.raises(exceptions.NoPermissionError):
+            await user_client.get("violated_cache:0")
+
+        # Invalid operation
+        with pytest.raises(exceptions.NoPermissionError):
+            await user_client.hset("cache:0", "hkey", "hval")
+
+        assert isinstance(await r.acl_log(), list)
+        assert len(await r.acl_log()) == 2
+        assert len(await r.acl_log(count=1)) == 1
+        assert isinstance((await r.acl_log())[0], dict)
+        assert "client-info" in (await r.acl_log(count=1))[0]
+        assert await r.acl_log_reset()
+
+    @skip_if_server_version_lt(REDIS_6_VERSION)
+    async def test_acl_setuser_categories_without_prefix_fails(
+        self, r: redis.Redis, request, event_loop
+    ):
+        username = "redis-py-user"
+
+        def teardown():
+            coro = r.acl_deluser(username)
+            if event_loop.is_running():
+                event_loop.create_task(coro)
+            else:
+                event_loop.run_until_complete(coro)
+
+        request.addfinalizer(teardown)
+
+        with pytest.raises(exceptions.DataError):
+            await r.acl_setuser(username, categories=["list"])
+
+    @skip_if_server_version_lt(REDIS_6_VERSION)
+    async def test_acl_setuser_commands_without_prefix_fails(
+        self, r: redis.Redis, request, event_loop
+    ):
+        username = "redis-py-user"
+
+        def teardown():
+            coro = r.acl_deluser(username)
+            if event_loop.is_running():
+                event_loop.create_task(coro)
+            else:
+                event_loop.run_until_complete(coro)
+
+        request.addfinalizer(teardown)
+
+        with pytest.raises(exceptions.DataError):
+            await r.acl_setuser(username, commands=["get"])
+
+    @skip_if_server_version_lt(REDIS_6_VERSION)
+    async def test_acl_setuser_add_passwords_and_nopass_fails(
+        self, r: redis.Redis, request, event_loop
+    ):
+        username = "redis-py-user"
+
+        def teardown():
+            coro = r.acl_deluser(username)
+            if event_loop.is_running():
+                event_loop.create_task(coro)
+            else:
+                event_loop.run_until_complete(coro)
+
+        request.addfinalizer(teardown)
+
+        with pytest.raises(exceptions.DataError):
+            await r.acl_setuser(username, passwords="+mypass", nopass=True)
+
+    @skip_if_server_version_lt(REDIS_6_VERSION)
+    async def test_acl_users(self, r: redis.Redis):
+        users = await r.acl_users()
+        assert isinstance(users, list)
+        assert len(users) > 0
+
+    @skip_if_server_version_lt(REDIS_6_VERSION)
+    async def test_acl_whoami(self, r: redis.Redis):
+        username = await r.acl_whoami()
+        assert isinstance(username, str)
+
+    async def test_client_list(self, r: redis.Redis):
+        clients = await r.client_list()
+        assert isinstance(clients[0], dict)
+        assert "addr" in clients[0]
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_client_list_type(self, r: redis.Redis):
+        with pytest.raises(exceptions.RedisError):
+            await r.client_list(_type="not a client type")
+        for client_type in ["normal", "master", "replica", "pubsub"]:
+            clients = await r.client_list(_type=client_type)
+            assert isinstance(clients, list)
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_client_id(self, r: redis.Redis):
+        assert await r.client_id() > 0
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_client_unblock(self, r: redis.Redis):
+        myid = await r.client_id()
+        assert not await r.client_unblock(myid)
+        assert not await r.client_unblock(myid, error=True)
+        assert not await r.client_unblock(myid, error=False)
+
+    @skip_if_server_version_lt("2.6.9")
+    async def test_client_getname(self, r: redis.Redis):
+        assert await r.client_getname() is None
+
+    @skip_if_server_version_lt("2.6.9")
+    async def test_client_setname(self, r: redis.Redis):
+        assert await r.client_setname("redis_py_test")
+        assert await r.client_getname() == "redis_py_test"
+
+    @skip_if_server_version_lt("2.6.9")
+    async def test_client_kill(self, r: redis.Redis, r2):
+        await r.client_setname("redis-py-c1")
+        await r2.client_setname("redis-py-c2")
+        clients = [
+            client
+            for client in await r.client_list()
+            if client.get("name") in ["redis-py-c1", "redis-py-c2"]
+        ]
+        assert len(clients) == 2
+
+        clients_by_name = {client.get("name"): client for client in clients}
+
+        client_addr = clients_by_name["redis-py-c2"].get("addr")
+        assert await r.client_kill(client_addr) is True
+
+        clients = [
+            client
+            for client in await r.client_list()
+            if client.get("name") in ["redis-py-c1", "redis-py-c2"]
+        ]
+        assert len(clients) == 1
+        assert clients[0].get("name") == "redis-py-c1"
+
+    @skip_if_server_version_lt("2.8.12")
+    async def test_client_kill_filter_invalid_params(self, r: redis.Redis):
+        # empty
+        with pytest.raises(exceptions.DataError):
+            await r.client_kill_filter()
+
+        # invalid skipme
+        with pytest.raises(exceptions.DataError):
+            await r.client_kill_filter(skipme="yeah")  # type: ignore
+
+        # invalid type
+        with pytest.raises(exceptions.DataError):
+            await r.client_kill_filter(_type="caster")  # type: ignore
+
+    @skip_if_server_version_lt("2.8.12")
+    async def test_client_kill_filter_by_id(self, r: redis.Redis, r2):
+        await r.client_setname("redis-py-c1")
+        await r2.client_setname("redis-py-c2")
+        clients = [
+            client
+            for client in await r.client_list()
+            if client.get("name") in ["redis-py-c1", "redis-py-c2"]
+        ]
+        assert len(clients) == 2
+
+        clients_by_name = {client.get("name"): client for client in clients}
+
+        client_2_id = clients_by_name["redis-py-c2"].get("id")
+        resp = await r.client_kill_filter(_id=client_2_id)
+        assert resp == 1
+
+        clients = [
+            client
+            for client in await r.client_list()
+            if client.get("name") in ["redis-py-c1", "redis-py-c2"]
+        ]
+        assert len(clients) == 1
+        assert clients[0].get("name") == "redis-py-c1"
+
+    @skip_if_server_version_lt("2.8.12")
+    async def test_client_kill_filter_by_addr(self, r: redis.Redis, r2):
+        await r.client_setname("redis-py-c1")
+        await r2.client_setname("redis-py-c2")
+        clients = [
+            client
+            for client in await r.client_list()
+            if client.get("name") in ["redis-py-c1", "redis-py-c2"]
+        ]
+        assert len(clients) == 2
+
+        clients_by_name = {client.get("name"): client for client in clients}
+
+        client_2_addr = clients_by_name["redis-py-c2"].get("addr")
+        resp = await r.client_kill_filter(addr=client_2_addr)
+        assert resp == 1
+
+        clients = [
+            client
+            for client in await r.client_list()
+            if client.get("name") in ["redis-py-c1", "redis-py-c2"]
+        ]
+        assert len(clients) == 1
+        assert clients[0].get("name") == "redis-py-c1"
+
+    @skip_if_server_version_lt("2.6.9")
+    async def test_client_list_after_client_setname(self, r: redis.Redis):
+        await r.client_setname("redis_py_test")
+        clients = await r.client_list()
+        # we don't know which client ours will be
+        assert "redis_py_test" in [c["name"] for c in clients]
+
+    @skip_if_server_version_lt("2.9.50")
+    async def test_client_pause(self, r: redis.Redis):
+        assert await r.client_pause(1)
+        assert await r.client_pause(timeout=1)
+        with pytest.raises(exceptions.RedisError):
+            await r.client_pause(timeout="not an integer")
+
+    async def test_config_get(self, r: redis.Redis):
+        data = await r.config_get()
+        assert "maxmemory" in data
+        assert data["maxmemory"].isdigit()
+
+    async def test_config_resetstat(self, r: redis.Redis):
+        await r.ping()
+        prior_commands_processed = int((await r.info())["total_commands_processed"])
+        assert prior_commands_processed >= 1
+        await r.config_resetstat()
+        reset_commands_processed = int((await r.info())["total_commands_processed"])
+        assert reset_commands_processed < prior_commands_processed
+
+    async def test_config_set(self, r: redis.Redis):
+        data = await r.config_get()
+        rdbname = data["dbfilename"]
+        try:
+            assert await r.config_set("dbfilename", "redis_py_test.rdb")
+            assert (await r.config_get())["dbfilename"] == "redis_py_test.rdb"
+        finally:
+            assert await r.config_set("dbfilename", rdbname)
+
+    async def test_dbsize(self, r: redis.Redis):
+        await r.set("a", "foo")
+        await r.set("b", "bar")
+        assert await r.dbsize() == 2
+
+    async def test_echo(self, r: redis.Redis):
+        assert await r.echo("foo bar") == b"foo bar"
+
+    async def test_info(self, r: redis.Redis):
+        await r.set("a", "foo")
+        await r.set("b", "bar")
+        info = await r.info()
+        assert isinstance(info, dict)
+        assert info["db9"]["keys"] == 2
+
+    async def test_lastsave(self, r: redis.Redis):
+        assert isinstance(await r.lastsave(), datetime.datetime)
+
+    async def test_object(self, r: redis.Redis):
+        await r.set("a", "foo")
+        assert isinstance(await r.object("refcount", "a"), int)
+        assert isinstance(await r.object("idletime", "a"), int)
+        assert await r.object("encoding", "a") in (b"raw", b"embstr")
+        assert await r.object("idletime", "invalid-key") is None
+
+    async def test_ping(self, r: redis.Redis):
+        assert await r.ping()
+
+    async def test_slowlog_get(self, r: redis.Redis, slowlog):
+        assert await r.slowlog_reset()
+        unicode_string = chr(3456) + "abcd" + chr(3421)
+        await r.get(unicode_string)
+        slowlog = await r.slowlog_get()
+        assert isinstance(slowlog, list)
+        commands = [log["command"] for log in slowlog]
+
+        get_command = b" ".join((b"GET", unicode_string.encode("utf-8")))
+        assert get_command in commands
+        assert b"SLOWLOG RESET" in commands
+        # the order should be ['GET <uni string>', 'SLOWLOG RESET'],
+        # but if other clients are executing commands at the same time, there
+        # could be commands, before, between, or after, so just check that
+        # the two we care about are in the appropriate order.
+        assert commands.index(get_command) < commands.index(b"SLOWLOG RESET")
+
+        # make sure other attributes are typed correctly
+        assert isinstance(slowlog[0]["start_time"], int)
+        assert isinstance(slowlog[0]["duration"], int)
+
+    async def test_slowlog_get_limit(self, r: redis.Redis, slowlog):
+        assert await r.slowlog_reset()
+        await r.get("foo")
+        slowlog = await r.slowlog_get(1)
+        assert isinstance(slowlog, list)
+        # only one command, based on the number we passed to slowlog_get()
+        assert len(slowlog) == 1
+
+    async def test_slowlog_length(self, r: redis.Redis, slowlog):
+        await r.get("foo")
+        assert isinstance(await r.slowlog_len(), int)
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_time(self, r: redis.Redis):
+        t = await r.time()
+        assert len(t) == 2
+        assert isinstance(t[0], int)
+        assert isinstance(t[1], int)
+
+    # BASIC KEY COMMANDS
+    async def test_append(self, r: redis.Redis):
+        assert await r.append("a", "a1") == 2
+        assert await r.get("a") == b"a1"
+        assert await r.append("a", "a2") == 4
+        assert await r.get("a") == b"a1a2"
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_bitcount(self, r: redis.Redis):
+        await r.setbit("a", 5, True)
+        assert await r.bitcount("a") == 1
+        await r.setbit("a", 6, True)
+        assert await r.bitcount("a") == 2
+        await r.setbit("a", 5, False)
+        assert await r.bitcount("a") == 1
+        await r.setbit("a", 9, True)
+        await r.setbit("a", 17, True)
+        await r.setbit("a", 25, True)
+        await r.setbit("a", 33, True)
+        assert await r.bitcount("a") == 5
+        assert await r.bitcount("a", 0, -1) == 5
+        assert await r.bitcount("a", 2, 3) == 2
+        assert await r.bitcount("a", 2, -1) == 3
+        assert await r.bitcount("a", -2, -1) == 2
+        assert await r.bitcount("a", 1, 1) == 1
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_bitop_not_empty_string(self, r: redis.Redis):
+        await r.set("a", "")
+        await r.bitop("not", "r", "a")
+        assert await r.get("r") is None
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_bitop_not(self, r: redis.Redis):
+        test_str = b"\xAA\x00\xFF\x55"
+        correct = ~0xAA00FF55 & 0xFFFFFFFF
+        await r.set("a", test_str)
+        await r.bitop("not", "r", "a")
+        assert int(binascii.hexlify(await r.get("r")), 16) == correct
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_bitop_not_in_place(self, r: redis.Redis):
+        test_str = b"\xAA\x00\xFF\x55"
+        correct = ~0xAA00FF55 & 0xFFFFFFFF
+        await r.set("a", test_str)
+        await r.bitop("not", "a", "a")
+        assert int(binascii.hexlify(await r.get("a")), 16) == correct
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_bitop_single_string(self, r: redis.Redis):
+        test_str = b"\x01\x02\xFF"
+        await r.set("a", test_str)
+        await r.bitop("and", "res1", "a")
+        await r.bitop("or", "res2", "a")
+        await r.bitop("xor", "res3", "a")
+        assert await r.get("res1") == test_str
+        assert await r.get("res2") == test_str
+        assert await r.get("res3") == test_str
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_bitop_string_operands(self, r: redis.Redis):
+        await r.set("a", b"\x01\x02\xFF\xFF")
+        await r.set("b", b"\x01\x02\xFF")
+        await r.bitop("and", "res1", "a", "b")
+        await r.bitop("or", "res2", "a", "b")
+        await r.bitop("xor", "res3", "a", "b")
+        assert int(binascii.hexlify(await r.get("res1")), 16) == 0x0102FF00
+        assert int(binascii.hexlify(await r.get("res2")), 16) == 0x0102FFFF
+        assert int(binascii.hexlify(await r.get("res3")), 16) == 0x000000FF
+
+    @skip_if_server_version_lt("2.8.7")
+    async def test_bitpos(self, r: redis.Redis):
+        key = "key:bitpos"
+        await r.set(key, b"\xff\xf0\x00")
+        assert await r.bitpos(key, 0) == 12
+        assert await r.bitpos(key, 0, 2, -1) == 16
+        assert await r.bitpos(key, 0, -2, -1) == 12
+        await r.set(key, b"\x00\xff\xf0")
+        assert await r.bitpos(key, 1, 0) == 8
+        assert await r.bitpos(key, 1, 1) == 8
+        await r.set(key, b"\x00\x00\x00")
+        assert await r.bitpos(key, 1) == -1
+
+    @skip_if_server_version_lt("2.8.7")
+    async def test_bitpos_wrong_arguments(self, r: redis.Redis):
+        key = "key:bitpos:wrong:args"
+        await r.set(key, b"\xff\xf0\x00")
+        with pytest.raises(exceptions.RedisError):
+            await r.bitpos(key, 0, end=1) == 12
+        with pytest.raises(exceptions.RedisError):
+            await r.bitpos(key, 7) == 12
+
+    async def test_decr(self, r: redis.Redis):
+        assert await r.decr("a") == -1
+        assert await r.get("a") == b"-1"
+        assert await r.decr("a") == -2
+        assert await r.get("a") == b"-2"
+        assert await r.decr("a", amount=5) == -7
+        assert await r.get("a") == b"-7"
+
+    async def test_decrby(self, r: redis.Redis):
+        assert await r.decrby("a", amount=2) == -2
+        assert await r.decrby("a", amount=3) == -5
+        assert await r.get("a") == b"-5"
+
+    async def test_delete(self, r: redis.Redis):
+        assert await r.delete("a") == 0
+        await r.set("a", "foo")
+        assert await r.delete("a") == 1
+
+    async def test_delete_with_multiple_keys(self, r: redis.Redis):
+        await r.set("a", "foo")
+        await r.set("b", "bar")
+        assert await r.delete("a", "b") == 2
+        assert await r.get("a") is None
+        assert await r.get("b") is None
+
+    async def test_delitem(self, r: redis.Redis):
+        await r.set("a", "foo")
+        await r.delete("a")
+        assert await r.get("a") is None
+
+    @skip_if_server_version_lt("4.0.0")
+    async def test_unlink(self, r: redis.Redis):
+        assert await r.unlink("a") == 0
+        await r.set("a", "foo")
+        assert await r.unlink("a") == 1
+        assert await r.get("a") is None
+
+    @skip_if_server_version_lt("4.0.0")
+    async def test_unlink_with_multiple_keys(self, r: redis.Redis):
+        await r.set("a", "foo")
+        await r.set("b", "bar")
+        assert await r.unlink("a", "b") == 2
+        assert await r.get("a") is None
+        assert await r.get("b") is None
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_dump_and_restore(self, r: redis.Redis):
+        await r.set("a", "foo")
+        dumped = await r.dump("a")
+        await r.delete("a")
+        await r.restore("a", 0, dumped)
+        assert await r.get("a") == b"foo"
+
+    @skip_if_server_version_lt("3.0.0")
+    async def test_dump_and_restore_and_replace(self, r: redis.Redis):
+        await r.set("a", "bar")
+        dumped = await r.dump("a")
+        with pytest.raises(redis.ResponseError):
+            await r.restore("a", 0, dumped)
+
+        await r.restore("a", 0, dumped, replace=True)
+        assert await r.get("a") == b"bar"
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_dump_and_restore_absttl(self, r: redis.Redis):
+        await r.set("a", "foo")
+        dumped = await r.dump("a")
+        await r.delete("a")
+        ttl = int(
+            (await redis_server_time(r) + datetime.timedelta(minutes=1)).timestamp()
+            * 1000
+        )
+        await r.restore("a", ttl, dumped, absttl=True)
+        assert await r.get("a") == b"foo"
+        assert 0 < await r.ttl("a") <= 61
+
+    async def test_exists(self, r: redis.Redis):
+        assert await r.exists("a") == 0
+        await r.set("a", "foo")
+        await r.set("b", "bar")
+        assert await r.exists("a") == 1
+        assert await r.exists("a", "b") == 2
+
+    async def test_exists_contains(self, r: redis.Redis):
+        assert not await r.exists("a")
+        await r.set("a", "foo")
+        assert await r.exists("a")
+
+    async def test_expire(self, r: redis.Redis):
+        assert not await r.expire("a", 10)
+        await r.set("a", "foo")
+        assert await r.expire("a", 10)
+        assert 0 < await r.ttl("a") <= 10
+        assert await r.persist("a")
+        assert await r.ttl("a") == -1
+
+    async def test_expireat_datetime(self, r: redis.Redis):
+        expire_at = await redis_server_time(r) + datetime.timedelta(minutes=1)
+        await r.set("a", "foo")
+        assert await r.expireat("a", expire_at)
+        assert 0 < await r.ttl("a") <= 61
+
+    async def test_expireat_no_key(self, r: redis.Redis):
+        expire_at = await redis_server_time(r) + datetime.timedelta(minutes=1)
+        assert not await r.expireat("a", expire_at)
+
+    async def test_expireat_unixtime(self, r: redis.Redis):
+        expire_at = await redis_server_time(r) + datetime.timedelta(minutes=1)
+        await r.set("a", "foo")
+        expire_at_seconds = int(time.mktime(expire_at.timetuple()))
+        assert await r.expireat("a", expire_at_seconds)
+        assert 0 < await r.ttl("a") <= 61
+
+    async def test_get_and_set(self, r: redis.Redis):
+        # get and set can't be tested independently of each other
+        assert await r.get("a") is None
+        byte_string = b"value"
+        integer = 5
+        unicode_string = chr(3456) + "abcd" + chr(3421)
+        assert await r.set("byte_string", byte_string)
+        assert await r.set("integer", 5)
+        assert await r.set("unicode_string", unicode_string)
+        assert await r.get("byte_string") == byte_string
+        assert await r.get("integer") == str(integer).encode()
+        assert (await r.get("unicode_string")).decode("utf-8") == unicode_string
+
+    async def test_get_set_bit(self, r: redis.Redis):
+        # no value
+        assert not await r.getbit("a", 5)
+        # set bit 5
+        assert not await r.setbit("a", 5, True)
+        assert await r.getbit("a", 5)
+        # unset bit 4
+        assert not await r.setbit("a", 4, False)
+        assert not await r.getbit("a", 4)
+        # set bit 4
+        assert not await r.setbit("a", 4, True)
+        assert await r.getbit("a", 4)
+        # set bit 5 again
+        assert await r.setbit("a", 5, True)
+        assert await r.getbit("a", 5)
+
+    async def test_getrange(self, r: redis.Redis):
+        await r.set("a", "foo")
+        assert await r.getrange("a", 0, 0) == b"f"
+        assert await r.getrange("a", 0, 2) == b"foo"
+        assert await r.getrange("a", 3, 4) == b""
+
+    async def test_getset(self, r: redis.Redis):
+        assert await r.getset("a", "foo") is None
+        assert await r.getset("a", "bar") == b"foo"
+        assert await r.get("a") == b"bar"
+
+    async def test_incr(self, r: redis.Redis):
+        assert await r.incr("a") == 1
+        assert await r.get("a") == b"1"
+        assert await r.incr("a") == 2
+        assert await r.get("a") == b"2"
+        assert await r.incr("a", amount=5) == 7
+        assert await r.get("a") == b"7"
+
+    async def test_incrby(self, r: redis.Redis):
+        assert await r.incrby("a") == 1
+        assert await r.incrby("a", 4) == 5
+        assert await r.get("a") == b"5"
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_incrbyfloat(self, r: redis.Redis):
+        assert await r.incrbyfloat("a") == 1.0
+        assert await r.get("a") == b"1"
+        assert await r.incrbyfloat("a", 1.1) == 2.1
+        assert float(await r.get("a")) == float(2.1)
+
+    async def test_keys(self, r: redis.Redis):
+        assert await r.keys() == []
+        keys_with_underscores = {b"test_a", b"test_b"}
+        keys = keys_with_underscores.union({b"testc"})
+        for key in keys:
+            await r.set(key, 1)
+        assert set(await r.keys(pattern="test_*")) == keys_with_underscores
+        assert set(await r.keys(pattern="test*")) == keys
+
+    async def test_mget(self, r: redis.Redis):
+        assert await r.mget([]) == []
+        assert await r.mget(["a", "b"]) == [None, None]
+        await r.set("a", "1")
+        await r.set("b", "2")
+        await r.set("c", "3")
+        assert await r.mget("a", "other", "b", "c") == [b"1", None, b"2", b"3"]
+
+    async def test_mset(self, r: redis.Redis):
+        d = {"a": b"1", "b": b"2", "c": b"3"}
+        assert await r.mset(d)
+        for k, v in d.items():
+            assert await r.get(k) == v
+
+    async def test_msetnx(self, r: redis.Redis):
+        d = {"a": b"1", "b": b"2", "c": b"3"}
+        assert await r.msetnx(d)
+        d2 = {"a": b"x", "d": b"4"}
+        assert not await r.msetnx(d2)
+        for k, v in d.items():
+            assert await r.get(k) == v
+        assert await r.get("d") is None
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_pexpire(self, r: redis.Redis):
+        assert not await r.pexpire("a", 60000)
+        await r.set("a", "foo")
+        assert await r.pexpire("a", 60000)
+        assert 0 < await r.pttl("a") <= 60000
+        assert await r.persist("a")
+        assert await r.pttl("a") == -1
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_pexpireat_datetime(self, r: redis.Redis):
+        expire_at = await redis_server_time(r) + datetime.timedelta(minutes=1)
+        await r.set("a", "foo")
+        assert await r.pexpireat("a", expire_at)
+        assert 0 < await r.pttl("a") <= 61000
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_pexpireat_no_key(self, r: redis.Redis):
+        expire_at = await redis_server_time(r) + datetime.timedelta(minutes=1)
+        assert not await r.pexpireat("a", expire_at)
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_pexpireat_unixtime(self, r: redis.Redis):
+        expire_at = await redis_server_time(r) + datetime.timedelta(minutes=1)
+        await r.set("a", "foo")
+        expire_at_seconds = int(time.mktime(expire_at.timetuple())) * 1000
+        assert await r.pexpireat("a", expire_at_seconds)
+        assert 0 < await r.pttl("a") <= 61000
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_psetex(self, r: redis.Redis):
+        assert await r.psetex("a", 1000, "value")
+        assert await r.get("a") == b"value"
+        assert 0 < await r.pttl("a") <= 1000
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_psetex_timedelta(self, r: redis.Redis):
+        expire_at = datetime.timedelta(milliseconds=1000)
+        assert await r.psetex("a", expire_at, "value")
+        assert await r.get("a") == b"value"
+        assert 0 < await r.pttl("a") <= 1000
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_pttl(self, r: redis.Redis):
+        assert not await r.pexpire("a", 10000)
+        await r.set("a", "1")
+        assert await r.pexpire("a", 10000)
+        assert 0 < await r.pttl("a") <= 10000
+        assert await r.persist("a")
+        assert await r.pttl("a") == -1
+
+    @skip_if_server_version_lt("2.8.0")
+    async def test_pttl_no_key(self, r: redis.Redis):
+        """PTTL on servers 2.8 and after return -2 when the key doesn't exist"""
+        assert await r.pttl("a") == -2
+
+    async def test_randomkey(self, r: redis.Redis):
+        assert await r.randomkey() is None
+        for key in ("a", "b", "c"):
+            await r.set(key, 1)
+        assert await r.randomkey() in (b"a", b"b", b"c")
+
+    async def test_rename(self, r: redis.Redis):
+        await r.set("a", "1")
+        assert await r.rename("a", "b")
+        assert await r.get("a") is None
+        assert await r.get("b") == b"1"
+
+    async def test_renamenx(self, r: redis.Redis):
+        await r.set("a", "1")
+        await r.set("b", "2")
+        assert not await r.renamenx("a", "b")
+        assert await r.get("a") == b"1"
+        assert await r.get("b") == b"2"
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_set_nx(self, r: redis.Redis):
+        assert await r.set("a", "1", nx=True)
+        assert not await r.set("a", "2", nx=True)
+        assert await r.get("a") == b"1"
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_set_xx(self, r: redis.Redis):
+        assert not await r.set("a", "1", xx=True)
+        assert await r.get("a") is None
+        await r.set("a", "bar")
+        assert await r.set("a", "2", xx=True)
+        assert await r.get("a") == b"2"
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_set_px(self, r: redis.Redis):
+        assert await r.set("a", "1", px=10000)
+        assert await r.get("a") == b"1"
+        assert 0 < await r.pttl("a") <= 10000
+        assert 0 < await r.ttl("a") <= 10
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_set_px_timedelta(self, r: redis.Redis):
+        expire_at = datetime.timedelta(milliseconds=1000)
+        assert await r.set("a", "1", px=expire_at)
+        assert 0 < await r.pttl("a") <= 1000
+        assert 0 < await r.ttl("a") <= 1
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_set_ex(self, r: redis.Redis):
+        assert await r.set("a", "1", ex=10)
+        assert 0 < await r.ttl("a") <= 10
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_set_ex_timedelta(self, r: redis.Redis):
+        expire_at = datetime.timedelta(seconds=60)
+        assert await r.set("a", "1", ex=expire_at)
+        assert 0 < await r.ttl("a") <= 60
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_set_multipleoptions(self, r: redis.Redis):
+        await r.set("a", "val")
+        assert await r.set("a", "1", xx=True, px=10000)
+        assert 0 < await r.ttl("a") <= 10
+
+    @skip_if_server_version_lt(REDIS_6_VERSION)
+    async def test_set_keepttl(self, r: redis.Redis):
+        await r.set("a", "val")
+        assert await r.set("a", "1", xx=True, px=10000)
+        assert 0 < await r.ttl("a") <= 10
+        await r.set("a", "2", keepttl=True)
+        assert await r.get("a") == b"2"
+        assert 0 < await r.ttl("a") <= 10
+
+    async def test_setex(self, r: redis.Redis):
+        assert await r.setex("a", 60, "1")
+        assert await r.get("a") == b"1"
+        assert 0 < await r.ttl("a") <= 60
+
+    async def test_setnx(self, r: redis.Redis):
+        assert await r.setnx("a", "1")
+        assert await r.get("a") == b"1"
+        assert not await r.setnx("a", "2")
+        assert await r.get("a") == b"1"
+
+    async def test_setrange(self, r: redis.Redis):
+        assert await r.setrange("a", 5, "foo") == 8
+        assert await r.get("a") == b"\0\0\0\0\0foo"
+        await r.set("a", "abcdefghijh")
+        assert await r.setrange("a", 6, "12345") == 11
+        assert await r.get("a") == b"abcdef12345"
+
+    async def test_strlen(self, r: redis.Redis):
+        await r.set("a", "foo")
+        assert await r.strlen("a") == 3
+
+    async def test_substr(self, r: redis.Redis):
+        await r.set("a", "0123456789")
+        assert await r.substr("a", 0) == b"0123456789"
+        assert await r.substr("a", 2) == b"23456789"
+        assert await r.substr("a", 3, 5) == b"345"
+        assert await r.substr("a", 3, -2) == b"345678"
+
+    async def test_ttl(self, r: redis.Redis):
+        await r.set("a", "1")
+        assert await r.expire("a", 10)
+        assert 0 < await r.ttl("a") <= 10
+        assert await r.persist("a")
+        assert await r.ttl("a") == -1
+
+    @skip_if_server_version_lt("2.8.0")
+    async def test_ttl_nokey(self, r: redis.Redis):
+        """TTL on servers 2.8 and after return -2 when the key doesn't exist"""
+        assert await r.ttl("a") == -2
+
+    async def test_type(self, r: redis.Redis):
+        assert await r.type("a") == b"none"
+        await r.set("a", "1")
+        assert await r.type("a") == b"string"
+        await r.delete("a")
+        await r.lpush("a", "1")
+        assert await r.type("a") == b"list"
+        await r.delete("a")
+        await r.sadd("a", "1")
+        assert await r.type("a") == b"set"
+        await r.delete("a")
+        await r.zadd("a", {"1": 1})
+        assert await r.type("a") == b"zset"
+
+    # LIST COMMANDS
+    async def test_blpop(self, r: redis.Redis):
+        await r.rpush("a", "1", "2")
+        await r.rpush("b", "3", "4")
+        assert await r.blpop(["b", "a"], timeout=1) == (b"b", b"3")
+        assert await r.blpop(["b", "a"], timeout=1) == (b"b", b"4")
+        assert await r.blpop(["b", "a"], timeout=1) == (b"a", b"1")
+        assert await r.blpop(["b", "a"], timeout=1) == (b"a", b"2")
+        assert await r.blpop(["b", "a"], timeout=1) is None
+        await r.rpush("c", "1")
+        assert await r.blpop("c", timeout=1) == (b"c", b"1")
+
+    async def test_brpop(self, r: redis.Redis):
+        await r.rpush("a", "1", "2")
+        await r.rpush("b", "3", "4")
+        assert await r.brpop(["b", "a"], timeout=1) == (b"b", b"4")
+        assert await r.brpop(["b", "a"], timeout=1) == (b"b", b"3")
+        assert await r.brpop(["b", "a"], timeout=1) == (b"a", b"2")
+        assert await r.brpop(["b", "a"], timeout=1) == (b"a", b"1")
+        assert await r.brpop(["b", "a"], timeout=1) is None
+        await r.rpush("c", "1")
+        assert await r.brpop("c", timeout=1) == (b"c", b"1")
+
+    async def test_brpoplpush(self, r: redis.Redis):
+        await r.rpush("a", "1", "2")
+        await r.rpush("b", "3", "4")
+        assert await r.brpoplpush("a", "b") == b"2"
+        assert await r.brpoplpush("a", "b") == b"1"
+        assert await r.brpoplpush("a", "b", timeout=1) is None
+        assert await r.lrange("a", 0, -1) == []
+        assert await r.lrange("b", 0, -1) == [b"1", b"2", b"3", b"4"]
+
+    async def test_brpoplpush_empty_string(self, r: redis.Redis):
+        await r.rpush("a", "")
+        assert await r.brpoplpush("a", "b") == b""
+
+    async def test_lindex(self, r: redis.Redis):
+        await r.rpush("a", "1", "2", "3")
+        assert await r.lindex("a", "0") == b"1"
+        assert await r.lindex("a", "1") == b"2"
+        assert await r.lindex("a", "2") == b"3"
+
+    async def test_linsert(self, r: redis.Redis):
+        await r.rpush("a", "1", "2", "3")
+        assert await r.linsert("a", "after", "2", "2.5") == 4
+        assert await r.lrange("a", 0, -1) == [b"1", b"2", b"2.5", b"3"]
+        assert await r.linsert("a", "before", "2", "1.5") == 5
+        assert await r.lrange("a", 0, -1) == [b"1", b"1.5", b"2", b"2.5", b"3"]
+
+    async def test_llen(self, r: redis.Redis):
+        await r.rpush("a", "1", "2", "3")
+        assert await r.llen("a") == 3
+
+    async def test_lpop(self, r: redis.Redis):
+        await r.rpush("a", "1", "2", "3")
+        assert await r.lpop("a") == b"1"
+        assert await r.lpop("a") == b"2"
+        assert await r.lpop("a") == b"3"
+        assert await r.lpop("a") is None
+
+    async def test_lpush(self, r: redis.Redis):
+        assert await r.lpush("a", "1") == 1
+        assert await r.lpush("a", "2") == 2
+        assert await r.lpush("a", "3", "4") == 4
+        assert await r.lrange("a", 0, -1) == [b"4", b"3", b"2", b"1"]
+
+    async def test_lpushx(self, r: redis.Redis):
+        assert await r.lpushx("a", "1") == 0
+        assert await r.lrange("a", 0, -1) == []
+        await r.rpush("a", "1", "2", "3")
+        assert await r.lpushx("a", "4") == 4
+        assert await r.lrange("a", 0, -1) == [b"4", b"1", b"2", b"3"]
+
+    async def test_lrange(self, r: redis.Redis):
+        await r.rpush("a", "1", "2", "3", "4", "5")
+        assert await r.lrange("a", 0, 2) == [b"1", b"2", b"3"]
+        assert await r.lrange("a", 2, 10) == [b"3", b"4", b"5"]
+        assert await r.lrange("a", 0, -1) == [b"1", b"2", b"3", b"4", b"5"]
+
+    async def test_lrem(self, r: redis.Redis):
+        await r.rpush("a", "Z", "b", "Z", "Z", "c", "Z", "Z")
+        # remove the first 'Z'  item
+        assert await r.lrem("a", 1, "Z") == 1
+        assert await r.lrange("a", 0, -1) == [b"b", b"Z", b"Z", b"c", b"Z", b"Z"]
+        # remove the last 2 'Z' items
+        assert await r.lrem("a", -2, "Z") == 2
+        assert await r.lrange("a", 0, -1) == [b"b", b"Z", b"Z", b"c"]
+        # remove all 'Z' items
+        assert await r.lrem("a", 0, "Z") == 2
+        assert await r.lrange("a", 0, -1) == [b"b", b"c"]
+
+    async def test_lset(self, r: redis.Redis):
+        await r.rpush("a", "1", "2", "3")
+        assert await r.lrange("a", 0, -1) == [b"1", b"2", b"3"]
+        assert await r.lset("a", 1, "4")
+        assert await r.lrange("a", 0, 2) == [b"1", b"4", b"3"]
+
+    async def test_ltrim(self, r: redis.Redis):
+        await r.rpush("a", "1", "2", "3")
+        assert await r.ltrim("a", 0, 1)
+        assert await r.lrange("a", 0, -1) == [b"1", b"2"]
+
+    async def test_rpop(self, r: redis.Redis):
+        await r.rpush("a", "1", "2", "3")
+        assert await r.rpop("a") == b"3"
+        assert await r.rpop("a") == b"2"
+        assert await r.rpop("a") == b"1"
+        assert await r.rpop("a") is None
+
+    async def test_rpoplpush(self, r: redis.Redis):
+        await r.rpush("a", "a1", "a2", "a3")
+        await r.rpush("b", "b1", "b2", "b3")
+        assert await r.rpoplpush("a", "b") == b"a3"
+        assert await r.lrange("a", 0, -1) == [b"a1", b"a2"]
+        assert await r.lrange("b", 0, -1) == [b"a3", b"b1", b"b2", b"b3"]
+
+    async def test_rpush(self, r: redis.Redis):
+        assert await r.rpush("a", "1") == 1
+        assert await r.rpush("a", "2") == 2
+        assert await r.rpush("a", "3", "4") == 4
+        assert await r.lrange("a", 0, -1) == [b"1", b"2", b"3", b"4"]
+
+    @skip_if_server_version_lt("6.0.6")
+    async def test_lpos(self, r: redis.Redis):
+        assert await r.rpush("a", "a", "b", "c", "1", "2", "3", "c", "c") == 8
+        assert await r.lpos("a", "a") == 0
+        assert await r.lpos("a", "c") == 2
+
+        assert await r.lpos("a", "c", rank=1) == 2
+        assert await r.lpos("a", "c", rank=2) == 6
+        assert await r.lpos("a", "c", rank=4) is None
+        assert await r.lpos("a", "c", rank=-1) == 7
+        assert await r.lpos("a", "c", rank=-2) == 6
+
+        assert await r.lpos("a", "c", count=0) == [2, 6, 7]
+        assert await r.lpos("a", "c", count=1) == [2]
+        assert await r.lpos("a", "c", count=2) == [2, 6]
+        assert await r.lpos("a", "c", count=100) == [2, 6, 7]
+
+        assert await r.lpos("a", "c", count=0, rank=2) == [6, 7]
+        assert await r.lpos("a", "c", count=2, rank=-1) == [7, 6]
+
+        assert await r.lpos("axxx", "c", count=0, rank=2) == []
+        assert await r.lpos("axxx", "c") is None
+
+        assert await r.lpos("a", "x", count=2) == []
+        assert await r.lpos("a", "x") is None
+
+        assert await r.lpos("a", "a", count=0, maxlen=1) == [0]
+        assert await r.lpos("a", "c", count=0, maxlen=1) == []
+        assert await r.lpos("a", "c", count=0, maxlen=3) == [2]
+        assert await r.lpos("a", "c", count=0, maxlen=3, rank=-1) == [7, 6]
+        assert await r.lpos("a", "c", count=0, maxlen=7, rank=2) == [6]
+
+    async def test_rpushx(self, r: redis.Redis):
+        assert await r.rpushx("a", "b") == 0
+        assert await r.lrange("a", 0, -1) == []
+        await r.rpush("a", "1", "2", "3")
+        assert await r.rpushx("a", "4") == 4
+        assert await r.lrange("a", 0, -1) == [b"1", b"2", b"3", b"4"]
+
+    # SCAN COMMANDS
+    @skip_if_server_version_lt("2.8.0")
+    async def test_scan(self, r: redis.Redis):
+        await r.set("a", 1)
+        await r.set("b", 2)
+        await r.set("c", 3)
+        cursor, keys = await r.scan()
+        assert cursor == 0
+        assert set(keys) == {b"a", b"b", b"c"}
+        _, keys = await r.scan(match="a")
+        assert set(keys) == {b"a"}
+
+    @skip_if_server_version_lt(REDIS_6_VERSION)
+    async def test_scan_type(self, r: redis.Redis):
+        await r.sadd("a-set", 1)
+        await r.hset("a-hash", "foo", 2)
+        await r.lpush("a-list", "aux", 3)
+        _, keys = await r.scan(match="a*", _type="SET")
+        assert set(keys) == {b"a-set"}
+
+    @skip_if_server_version_lt("2.8.0")
+    async def test_scan_iter(self, r: redis.Redis):
+        await r.set("a", 1)
+        await r.set("b", 2)
+        await r.set("c", 3)
+        keys = [k async for k in r.scan_iter()]
+        assert set(keys) == {b"a", b"b", b"c"}
+        keys = [k async for k in r.scan_iter(match="a")]
+        assert set(keys) == {b"a"}
+
+    @skip_if_server_version_lt("2.8.0")
+    async def test_sscan(self, r: redis.Redis):
+        await r.sadd("a", 1, 2, 3)
+        cursor, members = await r.sscan("a")
+        assert cursor == 0
+        assert set(members) == {b"1", b"2", b"3"}
+        _, members = await r.sscan("a", match=b"1")
+        assert set(members) == {b"1"}
+
+    @skip_if_server_version_lt("2.8.0")
+    async def test_sscan_iter(self, r: redis.Redis):
+        await r.sadd("a", 1, 2, 3)
+        members = [k async for k in r.sscan_iter("a")]
+        assert set(members) == {b"1", b"2", b"3"}
+        members = [k async for k in r.sscan_iter("a", match=b"1")]
+        assert set(members) == {b"1"}
+
+    @skip_if_server_version_lt("2.8.0")
+    async def test_hscan(self, r: redis.Redis):
+        await r.hset("a", mapping={"a": 1, "b": 2, "c": 3})
+        cursor, dic = await r.hscan("a")
+        assert cursor == 0
+        assert dic == {b"a": b"1", b"b": b"2", b"c": b"3"}
+        _, dic = await r.hscan("a", match="a")
+        assert dic == {b"a": b"1"}
+
+    @skip_if_server_version_lt("2.8.0")
+    async def test_hscan_iter(self, r: redis.Redis):
+        await r.hset("a", mapping={"a": 1, "b": 2, "c": 3})
+        dic = {k: v async for k, v in r.hscan_iter("a")}
+        assert dic == {b"a": b"1", b"b": b"2", b"c": b"3"}
+        dic = {k: v async for k, v in r.hscan_iter("a", match="a")}
+        assert dic == {b"a": b"1"}
+
+    @skip_if_server_version_lt("2.8.0")
+    async def test_zscan(self, r: redis.Redis):
+        await r.zadd("a", {"a": 1, "b": 2, "c": 3})
+        cursor, pairs = await r.zscan("a")
+        assert cursor == 0
+        assert set(pairs) == {(b"a", 1), (b"b", 2), (b"c", 3)}
+        _, pairs = await r.zscan("a", match="a")
+        assert set(pairs) == {(b"a", 1)}
+
+    @skip_if_server_version_lt("2.8.0")
+    async def test_zscan_iter(self, r: redis.Redis):
+        await r.zadd("a", {"a": 1, "b": 2, "c": 3})
+        pairs = [k async for k in r.zscan_iter("a")]
+        assert set(pairs) == {(b"a", 1), (b"b", 2), (b"c", 3)}
+        pairs = [k async for k in r.zscan_iter("a", match="a")]
+        assert set(pairs) == {(b"a", 1)}
+
+    # SET COMMANDS
+    async def test_sadd(self, r: redis.Redis):
+        members = {b"1", b"2", b"3"}
+        await r.sadd("a", *members)
+        assert await r.smembers("a") == members
+
+    async def test_scard(self, r: redis.Redis):
+        await r.sadd("a", "1", "2", "3")
+        assert await r.scard("a") == 3
+
+    async def test_sdiff(self, r: redis.Redis):
+        await r.sadd("a", "1", "2", "3")
+        assert await r.sdiff("a", "b") == {b"1", b"2", b"3"}
+        await r.sadd("b", "2", "3")
+        assert await r.sdiff("a", "b") == {b"1"}
+
+    async def test_sdiffstore(self, r: redis.Redis):
+        await r.sadd("a", "1", "2", "3")
+        assert await r.sdiffstore("c", "a", "b") == 3
+        assert await r.smembers("c") == {b"1", b"2", b"3"}
+        await r.sadd("b", "2", "3")
+        assert await r.sdiffstore("c", "a", "b") == 1
+        assert await r.smembers("c") == {b"1"}
+
+    async def test_sinter(self, r: redis.Redis):
+        await r.sadd("a", "1", "2", "3")
+        assert await r.sinter("a", "b") == set()
+        await r.sadd("b", "2", "3")
+        assert await r.sinter("a", "b") == {b"2", b"3"}
+
+    async def test_sinterstore(self, r: redis.Redis):
+        await r.sadd("a", "1", "2", "3")
+        assert await r.sinterstore("c", "a", "b") == 0
+        assert await r.smembers("c") == set()
+        await r.sadd("b", "2", "3")
+        assert await r.sinterstore("c", "a", "b") == 2
+        assert await r.smembers("c") == {b"2", b"3"}
+
+    async def test_sismember(self, r: redis.Redis):
+        await r.sadd("a", "1", "2", "3")
+        assert await r.sismember("a", "1")
+        assert await r.sismember("a", "2")
+        assert await r.sismember("a", "3")
+        assert not await r.sismember("a", "4")
+
+    async def test_smembers(self, r: redis.Redis):
+        await r.sadd("a", "1", "2", "3")
+        assert await r.smembers("a") == {b"1", b"2", b"3"}
+
+    async def test_smove(self, r: redis.Redis):
+        await r.sadd("a", "a1", "a2")
+        await r.sadd("b", "b1", "b2")
+        assert await r.smove("a", "b", "a1")
+        assert await r.smembers("a") == {b"a2"}
+        assert await r.smembers("b") == {b"b1", b"b2", b"a1"}
+
+    async def test_spop(self, r: redis.Redis):
+        s = [b"1", b"2", b"3"]
+        await r.sadd("a", *s)
+        value = await r.spop("a")
+        assert value in s
+        assert await r.smembers("a") == set(s) - {value}
+
+    @skip_if_server_version_lt("3.2.0")
+    async def test_spop_multi_value(self, r: redis.Redis):
+        s = [b"1", b"2", b"3"]
+        await r.sadd("a", *s)
+        values = await r.spop("a", 2)
+        assert len(values) == 2
+
+        for value in values:
+            assert value in s
+
+        assert await r.spop("a", 1) == list(set(s) - set(values))
+
+    async def test_srandmember(self, r: redis.Redis):
+        s = [b"1", b"2", b"3"]
+        await r.sadd("a", *s)
+        assert await r.srandmember("a") in s
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_srandmember_multi_value(self, r: redis.Redis):
+        s = [b"1", b"2", b"3"]
+        await r.sadd("a", *s)
+        randoms = await r.srandmember("a", number=2)
+        assert len(randoms) == 2
+        assert set(randoms).intersection(s) == set(randoms)
+
+    async def test_srem(self, r: redis.Redis):
+        await r.sadd("a", "1", "2", "3", "4")
+        assert await r.srem("a", "5") == 0
+        assert await r.srem("a", "2", "4") == 2
+        assert await r.smembers("a") == {b"1", b"3"}
+
+    async def test_sunion(self, r: redis.Redis):
+        await r.sadd("a", "1", "2")
+        await r.sadd("b", "2", "3")
+        assert await r.sunion("a", "b") == {b"1", b"2", b"3"}
+
+    async def test_sunionstore(self, r: redis.Redis):
+        await r.sadd("a", "1", "2")
+        await r.sadd("b", "2", "3")
+        assert await r.sunionstore("c", "a", "b") == 3
+        assert await r.smembers("c") == {b"1", b"2", b"3"}
+
+    # SORTED SET COMMANDS
+    async def test_zadd(self, r: redis.Redis):
+        mapping = {"a1": 1.0, "a2": 2.0, "a3": 3.0}
+        await r.zadd("a", mapping)
+        assert await r.zrange("a", 0, -1, withscores=True) == [
+            (b"a1", 1.0),
+            (b"a2", 2.0),
+            (b"a3", 3.0),
+        ]
+
+        # error cases
+        with pytest.raises(exceptions.DataError):
+            await r.zadd("a", {})
+
+        # cannot use both nx and xx options
+        with pytest.raises(exceptions.DataError):
+            await r.zadd("a", mapping, nx=True, xx=True)
+
+        # cannot use the incr options with more than one value
+        with pytest.raises(exceptions.DataError):
+            await r.zadd("a", mapping, incr=True)
+
+    async def test_zadd_nx(self, r: redis.Redis):
+        assert await r.zadd("a", {"a1": 1}) == 1
+        assert await r.zadd("a", {"a1": 99, "a2": 2}, nx=True) == 1
+        assert await r.zrange("a", 0, -1, withscores=True) == [
+            (b"a1", 1.0),
+            (b"a2", 2.0),
+        ]
+
+    async def test_zadd_xx(self, r: redis.Redis):
+        assert await r.zadd("a", {"a1": 1}) == 1
+        assert await r.zadd("a", {"a1": 99, "a2": 2}, xx=True) == 0
+        assert await r.zrange("a", 0, -1, withscores=True) == [(b"a1", 99.0)]
+
+    async def test_zadd_ch(self, r: redis.Redis):
+        assert await r.zadd("a", {"a1": 1}) == 1
+        assert await r.zadd("a", {"a1": 99, "a2": 2}, ch=True) == 2
+        assert await r.zrange("a", 0, -1, withscores=True) == [
+            (b"a2", 2.0),
+            (b"a1", 99.0),
+        ]
+
+    async def test_zadd_incr(self, r: redis.Redis):
+        assert await r.zadd("a", {"a1": 1}) == 1
+        assert await r.zadd("a", {"a1": 4.5}, incr=True) == 5.5
+
+    async def test_zadd_incr_with_xx(self, r: redis.Redis):
+        # this asks zadd to incr 'a1' only if it exists, but it clearly
+        # doesn't. Redis returns a null value in this case and so should
+        # redis-py
+        assert await r.zadd("a", {"a1": 1}, xx=True, incr=True) is None
+
+    async def test_zcard(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        assert await r.zcard("a") == 3
+
+    async def test_zcount(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        assert await r.zcount("a", "-inf", "+inf") == 3
+        assert await r.zcount("a", 1, 2) == 2
+        assert await r.zcount("a", "(" + str(1), 2) == 1
+        assert await r.zcount("a", 1, "(" + str(2)) == 1
+        assert await r.zcount("a", 10, 20) == 0
+
+    async def test_zincrby(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        assert await r.zincrby("a", 1, "a2") == 3.0
+        assert await r.zincrby("a", 5, "a3") == 8.0
+        assert await r.zscore("a", "a2") == 3.0
+        assert await r.zscore("a", "a3") == 8.0
+
+    @skip_if_server_version_lt("2.8.9")
+    async def test_zlexcount(self, r: redis.Redis):
+        await r.zadd("a", {"a": 0, "b": 0, "c": 0, "d": 0, "e": 0, "f": 0, "g": 0})
+        assert await r.zlexcount("a", "-", "+") == 7
+        assert await r.zlexcount("a", "[b", "[f") == 5
+
+    async def test_zinterstore_sum(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 1, "a3": 1})
+        await r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
+        await r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
+        assert await r.zinterstore("d", ["a", "b", "c"]) == 2
+        assert await r.zrange("d", 0, -1, withscores=True) == [(b"a3", 8), (b"a1", 9)]
+
+    async def test_zinterstore_max(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 1, "a3": 1})
+        await r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
+        await r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
+        assert await r.zinterstore("d", ["a", "b", "c"], aggregate="MAX") == 2
+        assert await r.zrange("d", 0, -1, withscores=True) == [(b"a3", 5), (b"a1", 6)]
+
+    async def test_zinterstore_min(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        await r.zadd("b", {"a1": 2, "a2": 3, "a3": 5})
+        await r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
+        assert await r.zinterstore("d", ["a", "b", "c"], aggregate="MIN") == 2
+        assert await r.zrange("d", 0, -1, withscores=True) == [(b"a1", 1), (b"a3", 3)]
+
+    async def test_zinterstore_with_weight(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 1, "a3": 1})
+        await r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
+        await r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
+        assert await r.zinterstore("d", {"a": 1, "b": 2, "c": 3}) == 2
+        assert await r.zrange("d", 0, -1, withscores=True) == [(b"a3", 20), (b"a1", 23)]
+
+    @skip_if_server_version_lt("4.9.0")
+    async def test_zpopmax(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        assert await r.zpopmax("a") == [(b"a3", 3)]
+
+        # with count
+        assert await r.zpopmax("a", count=2) == [(b"a2", 2), (b"a1", 1)]
+
+    @skip_if_server_version_lt("4.9.0")
+    async def test_zpopmin(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        assert await r.zpopmin("a") == [(b"a1", 1)]
+
+        # with count
+        assert await r.zpopmin("a", count=2) == [(b"a2", 2), (b"a3", 3)]
+
+    @skip_if_server_version_lt("4.9.0")
+    async def test_bzpopmax(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2})
+        await r.zadd("b", {"b1": 10, "b2": 20})
+        assert await r.bzpopmax(["b", "a"], timeout=1) == (b"b", b"b2", 20)
+        assert await r.bzpopmax(["b", "a"], timeout=1) == (b"b", b"b1", 10)
+        assert await r.bzpopmax(["b", "a"], timeout=1) == (b"a", b"a2", 2)
+        assert await r.bzpopmax(["b", "a"], timeout=1) == (b"a", b"a1", 1)
+        assert await r.bzpopmax(["b", "a"], timeout=1) is None
+        await r.zadd("c", {"c1": 100})
+        assert await r.bzpopmax("c", timeout=1) == (b"c", b"c1", 100)
+
+    @skip_if_server_version_lt("4.9.0")
+    async def test_bzpopmin(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2})
+        await r.zadd("b", {"b1": 10, "b2": 20})
+        assert await r.bzpopmin(["b", "a"], timeout=1) == (b"b", b"b1", 10)
+        assert await r.bzpopmin(["b", "a"], timeout=1) == (b"b", b"b2", 20)
+        assert await r.bzpopmin(["b", "a"], timeout=1) == (b"a", b"a1", 1)
+        assert await r.bzpopmin(["b", "a"], timeout=1) == (b"a", b"a2", 2)
+        assert await r.bzpopmin(["b", "a"], timeout=1) is None
+        await r.zadd("c", {"c1": 100})
+        assert await r.bzpopmin("c", timeout=1) == (b"c", b"c1", 100)
+
+    async def test_zrange(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        assert await r.zrange("a", 0, 1) == [b"a1", b"a2"]
+        assert await r.zrange("a", 1, 2) == [b"a2", b"a3"]
+
+        # withscores
+        assert await r.zrange("a", 0, 1, withscores=True) == [
+            (b"a1", 1.0),
+            (b"a2", 2.0),
+        ]
+        assert await r.zrange("a", 1, 2, withscores=True) == [
+            (b"a2", 2.0),
+            (b"a3", 3.0),
+        ]
+
+        # custom score function
+        assert await r.zrange("a", 0, 1, withscores=True, score_cast_func=int) == [
+            (b"a1", 1),
+            (b"a2", 2),
+        ]
+
+    @skip_if_server_version_lt("2.8.9")
+    async def test_zrangebylex(self, r: redis.Redis):
+        await r.zadd("a", {"a": 0, "b": 0, "c": 0, "d": 0, "e": 0, "f": 0, "g": 0})
+        assert await r.zrangebylex("a", "-", "[c") == [b"a", b"b", b"c"]
+        assert await r.zrangebylex("a", "-", "(c") == [b"a", b"b"]
+        assert await r.zrangebylex("a", "[aaa", "(g") == [b"b", b"c", b"d", b"e", b"f"]
+        assert await r.zrangebylex("a", "[f", "+") == [b"f", b"g"]
+        assert await r.zrangebylex("a", "-", "+", start=3, num=2) == [b"d", b"e"]
+
+    @skip_if_server_version_lt("2.9.9")
+    async def test_zrevrangebylex(self, r: redis.Redis):
+        await r.zadd("a", {"a": 0, "b": 0, "c": 0, "d": 0, "e": 0, "f": 0, "g": 0})
+        assert await r.zrevrangebylex("a", "[c", "-") == [b"c", b"b", b"a"]
+        assert await r.zrevrangebylex("a", "(c", "-") == [b"b", b"a"]
+        assert await r.zrevrangebylex("a", "(g", "[aaa") == [
+            b"f",
+            b"e",
+            b"d",
+            b"c",
+            b"b",
+        ]
+        assert await r.zrevrangebylex("a", "+", "[f") == [b"g", b"f"]
+        assert await r.zrevrangebylex("a", "+", "-", start=3, num=2) == [b"d", b"c"]
+
+    async def test_zrangebyscore(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
+        assert await r.zrangebyscore("a", 2, 4) == [b"a2", b"a3", b"a4"]
+
+        # slicing with start/num
+        assert await r.zrangebyscore("a", 2, 4, start=1, num=2) == [b"a3", b"a4"]
+
+        # withscores
+        assert await r.zrangebyscore("a", 2, 4, withscores=True) == [
+            (b"a2", 2.0),
+            (b"a3", 3.0),
+            (b"a4", 4.0),
+        ]
+
+        # custom score function
+        assert await r.zrangebyscore(
+            "a", 2, 4, withscores=True, score_cast_func=int
+        ) == [(b"a2", 2), (b"a3", 3), (b"a4", 4)]
+
+    async def test_zrank(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
+        assert await r.zrank("a", "a1") == 0
+        assert await r.zrank("a", "a2") == 1
+        assert await r.zrank("a", "a6") is None
+
+    async def test_zrem(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        assert await r.zrem("a", "a2") == 1
+        assert await r.zrange("a", 0, -1) == [b"a1", b"a3"]
+        assert await r.zrem("a", "b") == 0
+        assert await r.zrange("a", 0, -1) == [b"a1", b"a3"]
+
+    async def test_zrem_multiple_keys(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        assert await r.zrem("a", "a1", "a2") == 2
+        assert await r.zrange("a", 0, 5) == [b"a3"]
+
+    @skip_if_server_version_lt("2.8.9")
+    async def test_zremrangebylex(self, r: redis.Redis):
+        await r.zadd("a", {"a": 0, "b": 0, "c": 0, "d": 0, "e": 0, "f": 0, "g": 0})
+        assert await r.zremrangebylex("a", "-", "[c") == 3
+        assert await r.zrange("a", 0, -1) == [b"d", b"e", b"f", b"g"]
+        assert await r.zremrangebylex("a", "[f", "+") == 2
+        assert await r.zrange("a", 0, -1) == [b"d", b"e"]
+        assert await r.zremrangebylex("a", "[h", "+") == 0
+        assert await r.zrange("a", 0, -1) == [b"d", b"e"]
+
+    async def test_zremrangebyrank(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
+        assert await r.zremrangebyrank("a", 1, 3) == 3
+        assert await r.zrange("a", 0, 5) == [b"a1", b"a5"]
+
+    async def test_zremrangebyscore(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
+        assert await r.zremrangebyscore("a", 2, 4) == 3
+        assert await r.zrange("a", 0, -1) == [b"a1", b"a5"]
+        assert await r.zremrangebyscore("a", 2, 4) == 0
+        assert await r.zrange("a", 0, -1) == [b"a1", b"a5"]
+
+    async def test_zrevrange(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        assert await r.zrevrange("a", 0, 1) == [b"a3", b"a2"]
+        assert await r.zrevrange("a", 1, 2) == [b"a2", b"a1"]
+
+        # withscores
+        assert await r.zrevrange("a", 0, 1, withscores=True) == [
+            (b"a3", 3.0),
+            (b"a2", 2.0),
+        ]
+        assert await r.zrevrange("a", 1, 2, withscores=True) == [
+            (b"a2", 2.0),
+            (b"a1", 1.0),
+        ]
+
+        # custom score function
+        assert await r.zrevrange("a", 0, 1, withscores=True, score_cast_func=int) == [
+            (b"a3", 3.0),
+            (b"a2", 2.0),
+        ]
+
+    async def test_zrevrangebyscore(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
+        assert await r.zrevrangebyscore("a", 4, 2) == [b"a4", b"a3", b"a2"]
+
+        # slicing with start/num
+        assert await r.zrevrangebyscore("a", 4, 2, start=1, num=2) == [b"a3", b"a2"]
+
+        # withscores
+        assert await r.zrevrangebyscore("a", 4, 2, withscores=True) == [
+            (b"a4", 4.0),
+            (b"a3", 3.0),
+            (b"a2", 2.0),
+        ]
+
+        # custom score function
+        assert await r.zrevrangebyscore(
+            "a", 4, 2, withscores=True, score_cast_func=int
+        ) == [(b"a4", 4), (b"a3", 3), (b"a2", 2)]
+
+    async def test_zrevrank(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
+        assert await r.zrevrank("a", "a1") == 4
+        assert await r.zrevrank("a", "a2") == 3
+        assert await r.zrevrank("a", "a6") is None
+
+    async def test_zscore(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        assert await r.zscore("a", "a1") == 1.0
+        assert await r.zscore("a", "a2") == 2.0
+        assert await r.zscore("a", "a4") is None
+
+    async def test_zunionstore_sum(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 1, "a3": 1})
+        await r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
+        await r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
+        assert await r.zunionstore("d", ["a", "b", "c"]) == 4
+        assert await r.zrange("d", 0, -1, withscores=True) == [
+            (b"a2", 3),
+            (b"a4", 4),
+            (b"a3", 8),
+            (b"a1", 9),
+        ]
+
+    async def test_zunionstore_max(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 1, "a3": 1})
+        await r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
+        await r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
+        assert await r.zunionstore("d", ["a", "b", "c"], aggregate="MAX") == 4
+        assert await r.zrange("d", 0, -1, withscores=True) == [
+            (b"a2", 2),
+            (b"a4", 4),
+            (b"a3", 5),
+            (b"a1", 6),
+        ]
+
+    async def test_zunionstore_min(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        await r.zadd("b", {"a1": 2, "a2": 2, "a3": 4})
+        await r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
+        assert await r.zunionstore("d", ["a", "b", "c"], aggregate="MIN") == 4
+        assert await r.zrange("d", 0, -1, withscores=True) == [
+            (b"a1", 1),
+            (b"a2", 2),
+            (b"a3", 3),
+            (b"a4", 4),
+        ]
+
+    async def test_zunionstore_with_weight(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 1, "a3": 1})
+        await r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
+        await r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
+        assert await r.zunionstore("d", {"a": 1, "b": 2, "c": 3}) == 4
+        assert await r.zrange("d", 0, -1, withscores=True) == [
+            (b"a2", 5),
+            (b"a4", 12),
+            (b"a3", 20),
+            (b"a1", 23),
+        ]
+
+    # HYPERLOGLOG TESTS
+    @skip_if_server_version_lt("2.8.9")
+    async def test_pfadd(self, r: redis.Redis):
+        members = {b"1", b"2", b"3"}
+        assert await r.pfadd("a", *members) == 1
+        assert await r.pfadd("a", *members) == 0
+        assert await r.pfcount("a") == len(members)
+
+    @skip_if_server_version_lt("2.8.9")
+    async def test_pfcount(self, r: redis.Redis):
+        members = {b"1", b"2", b"3"}
+        await r.pfadd("a", *members)
+        assert await r.pfcount("a") == len(members)
+        members_b = {b"2", b"3", b"4"}
+        await r.pfadd("b", *members_b)
+        assert await r.pfcount("b") == len(members_b)
+        assert await r.pfcount("a", "b") == len(members_b.union(members))
+
+    @skip_if_server_version_lt("2.8.9")
+    async def test_pfmerge(self, r: redis.Redis):
+        mema = {b"1", b"2", b"3"}
+        memb = {b"2", b"3", b"4"}
+        memc = {b"5", b"6", b"7"}
+        await r.pfadd("a", *mema)
+        await r.pfadd("b", *memb)
+        await r.pfadd("c", *memc)
+        await r.pfmerge("d", "c", "a")
+        assert await r.pfcount("d") == 6
+        await r.pfmerge("d", "b")
+        assert await r.pfcount("d") == 7
+
+    # HASH COMMANDS
+    async def test_hget_and_hset(self, r: redis.Redis):
+        await r.hset("a", mapping={"1": 1, "2": 2, "3": 3})
+        assert await r.hget("a", "1") == b"1"
+        assert await r.hget("a", "2") == b"2"
+        assert await r.hget("a", "3") == b"3"
+
+        # field was updated, redis returns 0
+        assert await r.hset("a", "2", 5) == 0
+        assert await r.hget("a", "2") == b"5"
+
+        # field is new, redis returns 1
+        assert await r.hset("a", "4", 4) == 1
+        assert await r.hget("a", "4") == b"4"
+
+        # key inside of hash that doesn't exist returns null value
+        assert await r.hget("a", "b") is None
+
+        # keys with bool(key) == False
+        assert await r.hset("a", 0, 10) == 1
+        assert await r.hset("a", "", 10) == 1
+
+    async def test_hset_with_multi_key_values(self, r: redis.Redis):
+        await r.hset("a", mapping={"1": 1, "2": 2, "3": 3})
+        assert await r.hget("a", "1") == b"1"
+        assert await r.hget("a", "2") == b"2"
+        assert await r.hget("a", "3") == b"3"
+
+        await r.hset("b", "foo", "bar", mapping={"1": 1, "2": 2})
+        assert await r.hget("b", "1") == b"1"
+        assert await r.hget("b", "2") == b"2"
+        assert await r.hget("b", "foo") == b"bar"
+
+    async def test_hset_without_data(self, r: redis.Redis):
+        with pytest.raises(exceptions.DataError):
+            await r.hset("x")
+
+    async def test_hdel(self, r: redis.Redis):
+        await r.hset("a", mapping={"1": 1, "2": 2, "3": 3})
+        assert await r.hdel("a", "2") == 1
+        assert await r.hget("a", "2") is None
+        assert await r.hdel("a", "1", "3") == 2
+        assert await r.hlen("a") == 0
+
+    async def test_hexists(self, r: redis.Redis):
+        await r.hset("a", mapping={"1": 1, "2": 2, "3": 3})
+        assert await r.hexists("a", "1")
+        assert not await r.hexists("a", "4")
+
+    async def test_hgetall(self, r: redis.Redis):
+        h = {b"a1": b"1", b"a2": b"2", b"a3": b"3"}
+        await r.hset("a", mapping=h)
+        assert await r.hgetall("a") == h
+
+    async def test_hincrby(self, r: redis.Redis):
+        assert await r.hincrby("a", "1") == 1
+        assert await r.hincrby("a", "1", amount=2) == 3
+        assert await r.hincrby("a", "1", amount=-2) == 1
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_hincrbyfloat(self, r: redis.Redis):
+        assert await r.hincrbyfloat("a", "1") == 1.0
+        assert await r.hincrbyfloat("a", "1") == 2.0
+        assert await r.hincrbyfloat("a", "1", 1.2) == 3.2
+
+    async def test_hkeys(self, r: redis.Redis):
+        h = {b"a1": b"1", b"a2": b"2", b"a3": b"3"}
+        await r.hset("a", mapping=h)
+        local_keys = list(h.keys())
+        remote_keys = await r.hkeys("a")
+        assert sorted(local_keys) == sorted(remote_keys)
+
+    async def test_hlen(self, r: redis.Redis):
+        await r.hset("a", mapping={"1": 1, "2": 2, "3": 3})
+        assert await r.hlen("a") == 3
+
+    async def test_hmget(self, r: redis.Redis):
+        assert await r.hset("a", mapping={"a": 1, "b": 2, "c": 3})
+        assert await r.hmget("a", "a", "b", "c") == [b"1", b"2", b"3"]
+
+    async def test_hmset(self, r: redis.Redis):
+        warning_message = (
+            r"^Redis\.hmset\(\) is deprecated\. " r"Use Redis\.hset\(\) instead\.$"
+        )
+        h = {b"a": b"1", b"b": b"2", b"c": b"3"}
+        with pytest.warns(DeprecationWarning, match=warning_message):
+            assert await r.hmset("a", h)
+        assert await r.hgetall("a") == h
+
+    async def test_hsetnx(self, r: redis.Redis):
+        # Initially set the hash field
+        assert await r.hsetnx("a", "1", 1)
+        assert await r.hget("a", "1") == b"1"
+        assert not await r.hsetnx("a", "1", 2)
+        assert await r.hget("a", "1") == b"1"
+
+    async def test_hvals(self, r: redis.Redis):
+        h = {b"a1": b"1", b"a2": b"2", b"a3": b"3"}
+        await r.hset("a", mapping=h)
+        local_vals = list(h.values())
+        remote_vals = await r.hvals("a")
+        assert sorted(local_vals) == sorted(remote_vals)
+
+    @skip_if_server_version_lt("3.2.0")
+    async def test_hstrlen(self, r: redis.Redis):
+        await r.hset("a", mapping={"1": "22", "2": "333"})
+        assert await r.hstrlen("a", "1") == 2
+        assert await r.hstrlen("a", "2") == 3
+
+    # SORT
+    async def test_sort_basic(self, r: redis.Redis):
+        await r.rpush("a", "3", "2", "1", "4")
+        assert await r.sort("a") == [b"1", b"2", b"3", b"4"]
+
+    async def test_sort_limited(self, r: redis.Redis):
+        await r.rpush("a", "3", "2", "1", "4")
+        assert await r.sort("a", start=1, num=2) == [b"2", b"3"]
+
+    async def test_sort_by(self, r: redis.Redis):
+        await r.set("score:1", 8)
+        await r.set("score:2", 3)
+        await r.set("score:3", 5)
+        await r.rpush("a", "3", "2", "1")
+        assert await r.sort("a", by="score:*") == [b"2", b"3", b"1"]
+
+    async def test_sort_get(self, r: redis.Redis):
+        await r.set("user:1", "u1")
+        await r.set("user:2", "u2")
+        await r.set("user:3", "u3")
+        await r.rpush("a", "2", "3", "1")
+        assert await r.sort("a", get="user:*") == [b"u1", b"u2", b"u3"]
+
+    async def test_sort_get_multi(self, r: redis.Redis):
+        await r.set("user:1", "u1")
+        await r.set("user:2", "u2")
+        await r.set("user:3", "u3")
+        await r.rpush("a", "2", "3", "1")
+        assert await r.sort("a", get=("user:*", "#")) == [
+            b"u1",
+            b"1",
+            b"u2",
+            b"2",
+            b"u3",
+            b"3",
+        ]
+
+    async def test_sort_get_groups_two(self, r: redis.Redis):
+        await r.set("user:1", "u1")
+        await r.set("user:2", "u2")
+        await r.set("user:3", "u3")
+        await r.rpush("a", "2", "3", "1")
+        assert await r.sort("a", get=("user:*", "#"), groups=True) == [
+            (b"u1", b"1"),
+            (b"u2", b"2"),
+            (b"u3", b"3"),
+        ]
+
+    async def test_sort_groups_string_get(self, r: redis.Redis):
+        await r.set("user:1", "u1")
+        await r.set("user:2", "u2")
+        await r.set("user:3", "u3")
+        await r.rpush("a", "2", "3", "1")
+        with pytest.raises(exceptions.DataError):
+            await r.sort("a", get="user:*", groups=True)
+
+    async def test_sort_groups_just_one_get(self, r: redis.Redis):
+        await r.set("user:1", "u1")
+        await r.set("user:2", "u2")
+        await r.set("user:3", "u3")
+        await r.rpush("a", "2", "3", "1")
+        with pytest.raises(exceptions.DataError):
+            await r.sort("a", get=["user:*"], groups=True)
+
+    async def test_sort_groups_no_get(self, r: redis.Redis):
+        await r.set("user:1", "u1")
+        await r.set("user:2", "u2")
+        await r.set("user:3", "u3")
+        await r.rpush("a", "2", "3", "1")
+        with pytest.raises(exceptions.DataError):
+            await r.sort("a", groups=True)
+
+    async def test_sort_groups_three_gets(self, r: redis.Redis):
+        await r.set("user:1", "u1")
+        await r.set("user:2", "u2")
+        await r.set("user:3", "u3")
+        await r.set("door:1", "d1")
+        await r.set("door:2", "d2")
+        await r.set("door:3", "d3")
+        await r.rpush("a", "2", "3", "1")
+        assert await r.sort("a", get=("user:*", "door:*", "#"), groups=True) == [
+            (b"u1", b"d1", b"1"),
+            (b"u2", b"d2", b"2"),
+            (b"u3", b"d3", b"3"),
+        ]
+
+    async def test_sort_desc(self, r: redis.Redis):
+        await r.rpush("a", "2", "3", "1")
+        assert await r.sort("a", desc=True) == [b"3", b"2", b"1"]
+
+    async def test_sort_alpha(self, r: redis.Redis):
+        await r.rpush("a", "e", "c", "b", "d", "a")
+        assert await r.sort("a", alpha=True) == [b"a", b"b", b"c", b"d", b"e"]
+
+    async def test_sort_store(self, r: redis.Redis):
+        await r.rpush("a", "2", "3", "1")
+        assert await r.sort("a", store="sorted_values") == 3
+        assert await r.lrange("sorted_values", 0, -1) == [b"1", b"2", b"3"]
+
+    async def test_sort_all_options(self, r: redis.Redis):
+        await r.set("user:1:username", "zeus")
+        await r.set("user:2:username", "titan")
+        await r.set("user:3:username", "hermes")
+        await r.set("user:4:username", "hercules")
+        await r.set("user:5:username", "apollo")
+        await r.set("user:6:username", "athena")
+        await r.set("user:7:username", "hades")
+        await r.set("user:8:username", "dionysus")
+
+        await r.set("user:1:favorite_drink", "yuengling")
+        await r.set("user:2:favorite_drink", "rum")
+        await r.set("user:3:favorite_drink", "vodka")
+        await r.set("user:4:favorite_drink", "milk")
+        await r.set("user:5:favorite_drink", "pinot noir")
+        await r.set("user:6:favorite_drink", "water")
+        await r.set("user:7:favorite_drink", "gin")
+        await r.set("user:8:favorite_drink", "apple juice")
+
+        await r.rpush("gods", "5", "8", "3", "1", "2", "7", "6", "4")
+        num = await r.sort(
+            "gods",
+            start=2,
+            num=4,
+            by="user:*:username",
+            get="user:*:favorite_drink",
+            desc=True,
+            alpha=True,
+            store="sorted",
+        )
+        assert num == 4
+        assert await r.lrange("sorted", 0, 10) == [
+            b"vodka",
+            b"milk",
+            b"gin",
+            b"apple juice",
+        ]
+
+    async def test_sort_issue_924(self, r: redis.Redis):
+        # Tests for issue https://github.com/andymccurdy/redis-py/issues/924
+        await r.execute_command("SADD", "issue#924", 1)
+        await r.execute_command("SORT", "issue#924")
+
+    async def test_cluster_addslots(self, mock_cluster_resp_ok):
+        assert await mock_cluster_resp_ok.cluster("ADDSLOTS", 1) is True
+
+    async def test_cluster_count_failure_reports(self, mock_cluster_resp_int):
+        assert isinstance(
+            await mock_cluster_resp_int.cluster("COUNT-FAILURE-REPORTS", "node"), int
+        )
+
+    async def test_cluster_countkeysinslot(self, mock_cluster_resp_int):
+        assert isinstance(
+            await mock_cluster_resp_int.cluster("COUNTKEYSINSLOT", 2), int
+        )
+
+    async def test_cluster_delslots(self, mock_cluster_resp_ok):
+        assert await mock_cluster_resp_ok.cluster("DELSLOTS", 1) is True
+
+    async def test_cluster_failover(self, mock_cluster_resp_ok):
+        assert await mock_cluster_resp_ok.cluster("FAILOVER", 1) is True
+
+    async def test_cluster_forget(self, mock_cluster_resp_ok):
+        assert await mock_cluster_resp_ok.cluster("FORGET", 1) is True
+
+    async def test_cluster_info(self, mock_cluster_resp_info):
+        assert isinstance(await mock_cluster_resp_info.cluster("info"), dict)
+
+    async def test_cluster_keyslot(self, mock_cluster_resp_int):
+        assert isinstance(await mock_cluster_resp_int.cluster("keyslot", "asdf"), int)
+
+    async def test_cluster_meet(self, mock_cluster_resp_ok):
+        assert await mock_cluster_resp_ok.cluster("meet", "ip", "port", 1) is True
+
+    async def test_cluster_nodes(self, mock_cluster_resp_nodes):
+        assert isinstance(await mock_cluster_resp_nodes.cluster("nodes"), dict)
+
+    async def test_cluster_replicate(self, mock_cluster_resp_ok):
+        assert await mock_cluster_resp_ok.cluster("replicate", "nodeid") is True
+
+    async def test_cluster_reset(self, mock_cluster_resp_ok):
+        assert await mock_cluster_resp_ok.cluster("reset", "hard") is True
+
+    async def test_cluster_saveconfig(self, mock_cluster_resp_ok):
+        assert await mock_cluster_resp_ok.cluster("saveconfig") is True
+
+    async def test_cluster_setslot(self, mock_cluster_resp_ok):
+        assert (
+            await mock_cluster_resp_ok.cluster("setslot", 1, "IMPORTING", "nodeid")
+            is True
+        )
+
+    async def test_cluster_slaves(self, mock_cluster_resp_slaves):
+        assert isinstance(
+            await mock_cluster_resp_slaves.cluster("slaves", "nodeid"), dict
+        )
+
+    @skip_if_server_version_lt("3.0.0")
+    async def test_readwrite(self, r: redis.Redis):
+        assert await r.readwrite()
+
+    @skip_if_server_version_lt("3.0.0")
+    async def test_readonly_invalid_cluster_state(self, r: redis.Redis):
+        with pytest.raises(exceptions.RedisError):
+            await r.readonly()
+
+    @skip_if_server_version_lt("3.0.0")
+    async def test_readonly(self, mock_cluster_resp_ok):
+        assert await mock_cluster_resp_ok.readonly() is True
+
+    # GEO COMMANDS
+    @skip_if_server_version_lt("3.2.0")
+    async def test_geoadd(self, r: redis.Redis):
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+
+        assert await r.geoadd("barcelona", values) == 2
+        assert await r.zcard("barcelona") == 2
+
+    @skip_if_server_version_lt("3.2.0")
+    async def test_geoadd_invalid_params(self, r: redis.Redis):
+        with pytest.raises(exceptions.RedisError):
+            await r.geoadd("barcelona", (1, 2))
+
+    @skip_if_server_version_lt("3.2.0")
+    async def test_geodist(self, r: redis.Redis):
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+
+        assert await r.geoadd("barcelona", values) == 2
+        assert await r.geodist("barcelona", "place1", "place2") == 3067.4157
+
+    @skip_if_server_version_lt("3.2.0")
+    async def test_geodist_units(self, r: redis.Redis):
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+
+        await r.geoadd("barcelona", values)
+        assert await r.geodist("barcelona", "place1", "place2", "km") == 3.0674
+
+    @skip_if_server_version_lt("3.2.0")
+    async def test_geodist_missing_one_member(self, r: redis.Redis):
+        values = (2.1909389952632, 41.433791470673, "place1")
+        await r.geoadd("barcelona", values)
+        assert await r.geodist("barcelona", "place1", "missing_member", "km") is None
+
+    @skip_if_server_version_lt("3.2.0")
+    async def test_geodist_invalid_units(self, r: redis.Redis):
+        with pytest.raises(exceptions.RedisError):
+            assert await r.geodist("x", "y", "z", "inches")
+
+    @skip_if_server_version_lt("3.2.0")
+    async def test_geohash(self, r: redis.Redis):
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+
+        await r.geoadd("barcelona", values)
+        assert await r.geohash("barcelona", "place1", "place2", "place3") == [
+            "sp3e9yg3kd0",
+            "sp3e9cbc3t0",
+            None,
+        ]
+
+    @skip_if_server_version_lt("3.2.0")
+    async def test_geopos(self, r: redis.Redis):
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+
+        await r.geoadd("barcelona", values)
+        # redis uses 52 bits precision, hereby small errors may be introduced.
+        assert await r.geopos("barcelona", "place1", "place2") == [
+            (2.19093829393386841, 41.43379028184083523),
+            (2.18737632036209106, 41.40634178640635099),
+        ]
+
+    @skip_if_server_version_lt("4.0.0")
+    async def test_geopos_no_value(self, r: redis.Redis):
+        assert await r.geopos("barcelona", "place1", "place2") == [None, None]
+
+    @skip_if_server_version_lt("3.2.0")
+    @skip_if_server_version_gte("4.0.0")
+    async def test_old_geopos_no_value(self, r: redis.Redis):
+        assert await r.geopos("barcelona", "place1", "place2") == []
+
+    @skip_if_server_version_lt("3.2.0")
+    async def test_georadius(self, r: redis.Redis):
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            b"\x80place2",
+        )
+
+        await r.geoadd("barcelona", values)
+        assert await r.georadius("barcelona", 2.191, 41.433, 1000) == [b"place1"]
+        assert await r.georadius("barcelona", 2.187, 41.406, 1000) == [b"\x80place2"]
+
+    @skip_if_server_version_lt("3.2.0")
+    async def test_georadius_no_values(self, r: redis.Redis):
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+
+        await r.geoadd("barcelona", values)
+        assert await r.georadius("barcelona", 1, 2, 1000) == []
+
+    @skip_if_server_version_lt("3.2.0")
+    async def test_georadius_units(self, r: redis.Redis):
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+
+        await r.geoadd("barcelona", values)
+        assert await r.georadius("barcelona", 2.191, 41.433, 1, unit="km") == [
+            b"place1"
+        ]
+
+    @skip_unless_arch_bits(64)
+    @skip_if_server_version_lt("3.2.0")
+    async def test_georadius_with(self, r: redis.Redis):
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+
+        await r.geoadd("barcelona", values)
+
+        # test a bunch of combinations to test the parse response
+        # function.
+        assert await r.georadius(
+            "barcelona",
+            2.191,
+            41.433,
+            1,
+            unit="km",
+            withdist=True,
+            withcoord=True,
+            withhash=True,
+        ) == [
+            [
+                b"place1",
+                0.0881,
+                3471609698139488,
+                (2.19093829393386841, 41.43379028184083523),
+            ]
+        ]
+
+        assert await r.georadius(
+            "barcelona", 2.191, 41.433, 1, unit="km", withdist=True, withcoord=True
+        ) == [[b"place1", 0.0881, (2.19093829393386841, 41.43379028184083523)]]
+
+        assert await r.georadius(
+            "barcelona", 2.191, 41.433, 1, unit="km", withhash=True, withcoord=True
+        ) == [
+            [b"place1", 3471609698139488, (2.19093829393386841, 41.43379028184083523)]
+        ]
+
+        # test no values.
+        assert (
+            await r.georadius(
+                "barcelona",
+                2,
+                1,
+                1,
+                unit="km",
+                withdist=True,
+                withcoord=True,
+                withhash=True,
+            )
+            == []
+        )
+
+    @skip_if_server_version_lt("3.2.0")
+    async def test_georadius_count(self, r: redis.Redis):
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+
+        await r.geoadd("barcelona", values)
+        assert await r.georadius("barcelona", 2.191, 41.433, 3000, count=1) == [
+            b"place1"
+        ]
+
+    @skip_if_server_version_lt("3.2.0")
+    async def test_georadius_sort(self, r: redis.Redis):
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+
+        await r.geoadd("barcelona", values)
+        assert await r.georadius("barcelona", 2.191, 41.433, 3000, sort="ASC") == [
+            b"place1",
+            b"place2",
+        ]
+        assert await r.georadius("barcelona", 2.191, 41.433, 3000, sort="DESC") == [
+            b"place2",
+            b"place1",
+        ]
+
+    @skip_if_server_version_lt("3.2.0")
+    async def test_georadius_store(self, r: redis.Redis):
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+
+        await r.geoadd("barcelona", values)
+        await r.georadius("barcelona", 2.191, 41.433, 1000, store="places_barcelona")
+        assert await r.zrange("places_barcelona", 0, -1) == [b"place1"]
+
+    @skip_unless_arch_bits(64)
+    @skip_if_server_version_lt("3.2.0")
+    async def test_georadius_store_dist(self, r: redis.Redis):
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+
+        await r.geoadd("barcelona", values)
+        await r.georadius(
+            "barcelona", 2.191, 41.433, 1000, store_dist="places_barcelona"
+        )
+        # instead of save the geo score, the distance is saved.
+        assert await r.zscore("places_barcelona", "place1") == 88.05060698409301
+
+    @skip_unless_arch_bits(64)
+    @skip_if_server_version_lt("3.2.0")
+    async def test_georadiusmember(self, r: redis.Redis):
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            b"\x80place2",
+        )
+
+        await r.geoadd("barcelona", values)
+        assert await r.georadiusbymember("barcelona", "place1", 4000) == [
+            b"\x80place2",
+            b"place1",
+        ]
+        assert await r.georadiusbymember("barcelona", "place1", 10) == [b"place1"]
+
+        assert await r.georadiusbymember(
+            "barcelona", "place1", 4000, withdist=True, withcoord=True, withhash=True
+        ) == [
+            [
+                b"\x80place2",
+                3067.4157,
+                3471609625421029,
+                (2.187376320362091, 41.40634178640635),
+            ],
+            [
+                b"place1",
+                0.0,
+                3471609698139488,
+                (2.1909382939338684, 41.433790281840835),
+            ],
+        ]
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_xack(self, r: redis.Redis):
+        stream = "stream"
+        group = "group"
+        consumer = "consumer"
+        # xack on a stream that doesn't exist
+        assert await r.xack(stream, group, "0-0") == 0
+
+        m1 = await r.xadd(stream, {"one": "one"})
+        m2 = await r.xadd(stream, {"two": "two"})
+        m3 = await r.xadd(stream, {"three": "three"})
+
+        # xack on a group that doesn't exist
+        assert await r.xack(stream, group, m1) == 0
+
+        await r.xgroup_create(stream, group, 0)
+        await r.xreadgroup(group, consumer, streams={stream: ">"})
+        # xack returns the number of ack'd elements
+        assert await r.xack(stream, group, m1) == 1
+        assert await r.xack(stream, group, m2, m3) == 2
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_xadd(self, r: redis.Redis):
+        stream = "stream"
+        message_id = await r.xadd(stream, {"foo": "bar"})
+        assert re.match(rb"[0-9]+\-[0-9]+", message_id)
+
+        # explicit message id
+        message_id = b"9999999999999999999-0"
+        assert message_id == await r.xadd(stream, {"foo": "bar"}, id=message_id)
+
+        # with maxlen, the list evicts the first message
+        await r.xadd(stream, {"foo": "bar"}, maxlen=2, approximate=False)
+        assert await r.xlen(stream) == 2
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_xclaim(self, r: redis.Redis):
+        stream = "stream"
+        group = "group"
+        consumer1 = "consumer1"
+        consumer2 = "consumer2"
+
+        message_id = await r.xadd(stream, {"john": "wick"})
+        message = await get_stream_message(r, stream, message_id)
+        await r.xgroup_create(stream, group, 0)
+
+        # trying to claim a message that isn't already pending doesn't
+        # do anything
+        response = await r.xclaim(
+            stream, group, consumer2, min_idle_time=0, message_ids=(message_id,)
+        )
+        assert response == []
+
+        # read the group as consumer1 to initially claim the messages
+        await r.xreadgroup(group, consumer1, streams={stream: ">"})
+
+        # claim the message as consumer2
+        response = await r.xclaim(
+            stream, group, consumer2, min_idle_time=0, message_ids=(message_id,)
+        )
+        assert response[0] == message
+
+        # reclaim the message as consumer1, but use the justid argument
+        # which only returns message ids
+        assert (
+            await r.xclaim(
+                stream,
+                group,
+                consumer1,
+                min_idle_time=0,
+                message_ids=(message_id,),
+                justid=True,
+            )
+            == [message_id]
+        )
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_xclaim_trimmed(self, r: redis.Redis):
+        # xclaim should not raise an exception if the item is not there
+        stream = "stream"
+        group = "group"
+
+        await r.xgroup_create(stream, group, id="$", mkstream=True)
+
+        # add a couple of new items
+        sid1 = await r.xadd(stream, {"item": 0})
+        sid2 = await r.xadd(stream, {"item": 0})
+
+        # read them from consumer1
+        await r.xreadgroup(group, "consumer1", {stream: ">"})
+
+        # add a 3rd and trim the stream down to 2 items
+        await r.xadd(stream, {"item": 3}, maxlen=2, approximate=False)
+
+        # xclaim them from consumer2
+        # the item that is still in the stream should be returned
+        item = await r.xclaim(stream, group, "consumer2", 0, [sid1, sid2])
+        assert len(item) == 2
+        assert item[0] == (None, None)
+        assert item[1][0] == sid2
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_xdel(self, r: redis.Redis):
+        stream = "stream"
+
+        # deleting from an empty stream doesn't do anything
+        assert await r.xdel(stream, 1) == 0
+
+        m1 = await r.xadd(stream, {"foo": "bar"})
+        m2 = await r.xadd(stream, {"foo": "bar"})
+        m3 = await r.xadd(stream, {"foo": "bar"})
+
+        # xdel returns the number of deleted elements
+        assert await r.xdel(stream, m1) == 1
+        assert await r.xdel(stream, m2, m3) == 2
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_xgroup_create(self, r: redis.Redis):
+        # tests xgroup_create and xinfo_groups
+        stream = "stream"
+        group = "group"
+        await r.xadd(stream, {"foo": "bar"})
+
+        # no group is setup yet, no info to obtain
+        assert await r.xinfo_groups(stream) == []
+
+        assert await r.xgroup_create(stream, group, 0)
+        expected = [
+            {
+                "name": group.encode(),
+                "consumers": 0,
+                "pending": 0,
+                "last-delivered-id": b"0-0",
+            }
+        ]
+        assert await r.xinfo_groups(stream) == expected
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_xgroup_create_mkstream(self, r: redis.Redis):
+        # tests xgroup_create and xinfo_groups
+        stream = "stream"
+        group = "group"
+
+        # an error is raised if a group is created on a stream that
+        # doesn't already exist
+        with pytest.raises(exceptions.ResponseError):
+            await r.xgroup_create(stream, group, 0)
+
+        # however, with mkstream=True, the underlying stream is created
+        # automatically
+        assert await r.xgroup_create(stream, group, 0, mkstream=True)
+        expected = [
+            {
+                "name": group.encode(),
+                "consumers": 0,
+                "pending": 0,
+                "last-delivered-id": b"0-0",
+            }
+        ]
+        assert await r.xinfo_groups(stream) == expected
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_xgroup_delconsumer(self, r: redis.Redis):
+        stream = "stream"
+        group = "group"
+        consumer = "consumer"
+        await r.xadd(stream, {"foo": "bar"})
+        await r.xadd(stream, {"foo": "bar"})
+        await r.xgroup_create(stream, group, 0)
+
+        # a consumer that hasn't yet read any messages doesn't do anything
+        assert await r.xgroup_delconsumer(stream, group, consumer) == 0
+
+        # read all messages from the group
+        await r.xreadgroup(group, consumer, streams={stream: ">"})
+
+        # deleting the consumer should return 2 pending messages
+        assert await r.xgroup_delconsumer(stream, group, consumer) == 2
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_xgroup_destroy(self, r: redis.Redis):
+        stream = "stream"
+        group = "group"
+        await r.xadd(stream, {"foo": "bar"})
+
+        # destroying a nonexistent group returns False
+        assert not await r.xgroup_destroy(stream, group)
+
+        await r.xgroup_create(stream, group, 0)
+        assert await r.xgroup_destroy(stream, group)
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_xgroup_setid(self, r: redis.Redis):
+        stream = "stream"
+        group = "group"
+        message_id = await r.xadd(stream, {"foo": "bar"})
+
+        await r.xgroup_create(stream, group, 0)
+        # advance the last_delivered_id to the message_id
+        await r.xgroup_setid(stream, group, message_id)
+        expected = [
+            {
+                "name": group.encode(),
+                "consumers": 0,
+                "pending": 0,
+                "last-delivered-id": message_id,
+            }
+        ]
+        assert await r.xinfo_groups(stream) == expected
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_xinfo_consumers(self, r: redis.Redis):
+        stream = "stream"
+        group = "group"
+        consumer1 = "consumer1"
+        consumer2 = "consumer2"
+        await r.xadd(stream, {"foo": "bar"})
+        await r.xadd(stream, {"foo": "bar"})
+        await r.xadd(stream, {"foo": "bar"})
+
+        await r.xgroup_create(stream, group, 0)
+        await r.xreadgroup(group, consumer1, streams={stream: ">"}, count=1)
+        await r.xreadgroup(group, consumer2, streams={stream: ">"})
+        info = await r.xinfo_consumers(stream, group)
+        assert len(info) == 2
+        expected = [
+            {"name": consumer1.encode(), "pending": 1},
+            {"name": consumer2.encode(), "pending": 2},
+        ]
+
+        # we can't determine the idle time, so just make sure it's an int
+        assert isinstance(info[0].pop("idle"), int)
+        assert isinstance(info[1].pop("idle"), int)
+        assert info == expected
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_xinfo_stream(self, r: redis.Redis):
+        stream = "stream"
+        m1 = await r.xadd(stream, {"foo": "bar"})
+        m2 = await r.xadd(stream, {"foo": "bar"})
+        info = await r.xinfo_stream(stream)
+
+        assert info["length"] == 2
+        assert info["first-entry"] == await get_stream_message(r, stream, m1)
+        assert info["last-entry"] == await get_stream_message(r, stream, m2)
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_xlen(self, r: redis.Redis):
+        stream = "stream"
+        assert await r.xlen(stream) == 0
+        await r.xadd(stream, {"foo": "bar"})
+        await r.xadd(stream, {"foo": "bar"})
+        assert await r.xlen(stream) == 2
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_xpending(self, r: redis.Redis):
+        stream = "stream"
+        group = "group"
+        consumer1 = "consumer1"
+        consumer2 = "consumer2"
+        m1 = await r.xadd(stream, {"foo": "bar"})
+        m2 = await r.xadd(stream, {"foo": "bar"})
+        await r.xgroup_create(stream, group, 0)
+
+        # xpending on a group that has no consumers yet
+        expected = {"pending": 0, "min": None, "max": None, "consumers": []}
+        assert await r.xpending(stream, group) == expected
+
+        # read 1 message from the group with each consumer
+        await r.xreadgroup(group, consumer1, streams={stream: ">"}, count=1)
+        await r.xreadgroup(group, consumer2, streams={stream: ">"}, count=1)
+
+        expected = {
+            "pending": 2,
+            "min": m1,
+            "max": m2,
+            "consumers": [
+                {"name": consumer1.encode(), "pending": 1},
+                {"name": consumer2.encode(), "pending": 1},
+            ],
+        }
+        assert await r.xpending(stream, group) == expected
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_xpending_range(self, r: redis.Redis):
+        stream = "stream"
+        group = "group"
+        consumer1 = "consumer1"
+        consumer2 = "consumer2"
+        m1 = await r.xadd(stream, {"foo": "bar"})
+        m2 = await r.xadd(stream, {"foo": "bar"})
+        await r.xgroup_create(stream, group, 0)
+
+        # xpending range on a group that has no consumers yet
+        assert await r.xpending_range(stream, group, min="-", max="+", count=5) == []
+
+        # read 1 message from the group with each consumer
+        await r.xreadgroup(group, consumer1, streams={stream: ">"}, count=1)
+        await r.xreadgroup(group, consumer2, streams={stream: ">"}, count=1)
+
+        response = await r.xpending_range(stream, group, min="-", max="+", count=5)
+        assert len(response) == 2
+        assert response[0]["message_id"] == m1
+        assert response[0]["consumer"] == consumer1.encode()
+        assert response[1]["message_id"] == m2
+        assert response[1]["consumer"] == consumer2.encode()
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_xrange(self, r: redis.Redis):
+        stream = "stream"
+        m1 = await r.xadd(stream, {"foo": "bar"})
+        m2 = await r.xadd(stream, {"foo": "bar"})
+        m3 = await r.xadd(stream, {"foo": "bar"})
+        m4 = await r.xadd(stream, {"foo": "bar"})
+
+        def get_ids(results):
+            return [result[0] for result in results]
+
+        results = await r.xrange(stream, min=m1)
+        assert get_ids(results) == [m1, m2, m3, m4]
+
+        results = await r.xrange(stream, min=m2, max=m3)
+        assert get_ids(results) == [m2, m3]
+
+        results = await r.xrange(stream, max=m3)
+        assert get_ids(results) == [m1, m2, m3]
+
+        results = await r.xrange(stream, max=m2, count=1)
+        assert get_ids(results) == [m1]
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_xread(self, r: redis.Redis):
+        stream = "stream"
+        m1 = await r.xadd(stream, {"foo": "bar"})
+        m2 = await r.xadd(stream, {"bing": "baz"})
+
+        expected = [
+            [
+                stream.encode(),
+                [
+                    await get_stream_message(r, stream, m1),
+                    await get_stream_message(r, stream, m2),
+                ],
+            ]
+        ]
+        # xread starting at 0 returns both messages
+        assert await r.xread(streams={stream: 0}) == expected
+
+        expected = [
+            [
+                stream.encode(),
+                [
+                    await get_stream_message(r, stream, m1),
+                ],
+            ]
+        ]
+        # xread starting at 0 and count=1 returns only the first message
+        assert await r.xread(streams={stream: 0}, count=1) == expected
+
+        expected = [
+            [
+                stream.encode(),
+                [
+                    await get_stream_message(r, stream, m2),
+                ],
+            ]
+        ]
+        # xread starting at m1 returns only the second message
+        assert await r.xread(streams={stream: m1}) == expected
+
+        # xread starting at the last message returns an empty list
+        assert await r.xread(streams={stream: m2}) == []
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_xreadgroup(self, r: redis.Redis):
+        stream = "stream"
+        group = "group"
+        consumer = "consumer"
+        m1 = await r.xadd(stream, {"foo": "bar"})
+        m2 = await r.xadd(stream, {"bing": "baz"})
+        await r.xgroup_create(stream, group, 0)
+
+        expected = [
+            [
+                stream.encode(),
+                [
+                    await get_stream_message(r, stream, m1),
+                    await get_stream_message(r, stream, m2),
+                ],
+            ]
+        ]
+        # xread starting at 0 returns both messages
+        assert await r.xreadgroup(group, consumer, streams={stream: ">"}) == expected
+
+        await r.xgroup_destroy(stream, group)
+        await r.xgroup_create(stream, group, 0)
+
+        expected = [
+            [
+                stream.encode(),
+                [
+                    await get_stream_message(r, stream, m1),
+                ],
+            ]
+        ]
+        # xread with count=1 returns only the first message
+        assert (
+            await r.xreadgroup(group, consumer, streams={stream: ">"}, count=1)
+            == expected
+        )
+
+        await r.xgroup_destroy(stream, group)
+
+        # create the group using $ as the last id meaning subsequent reads
+        # will only find messages added after this
+        await r.xgroup_create(stream, group, "$")
+
+        expected = []
+        # xread starting after the last message returns an empty message list
+        assert await r.xreadgroup(group, consumer, streams={stream: ">"}) == expected
+
+        # xreadgroup with noack does not have any items in the PEL
+        await r.xgroup_destroy(stream, group)
+        await r.xgroup_create(stream, group, "0")
+        assert (
+            len(
+                (
+                    await r.xreadgroup(
+                        group, consumer, streams={stream: ">"}, noack=True
+                    )
+                )[0][1]
+            )
+            == 2
+        )
+        # now there should be nothing pending
+        assert (
+            len((await r.xreadgroup(group, consumer, streams={stream: "0"}))[0][1]) == 0
+        )
+
+        await r.xgroup_destroy(stream, group)
+        await r.xgroup_create(stream, group, "0")
+        # delete all the messages in the stream
+        expected = [
+            [
+                stream.encode(),
+                [
+                    (m1, {}),
+                    (m2, {}),
+                ],
+            ]
+        ]
+        await r.xreadgroup(group, consumer, streams={stream: ">"})
+        await r.xtrim(stream, 0)
+        assert await r.xreadgroup(group, consumer, streams={stream: "0"}) == expected
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_xrevrange(self, r: redis.Redis):
+        stream = "stream"
+        m1 = await r.xadd(stream, {"foo": "bar"})
+        m2 = await r.xadd(stream, {"foo": "bar"})
+        m3 = await r.xadd(stream, {"foo": "bar"})
+        m4 = await r.xadd(stream, {"foo": "bar"})
+
+        def get_ids(results):
+            return [result[0] for result in results]
+
+        results = await r.xrevrange(stream, max=m4)
+        assert get_ids(results) == [m4, m3, m2, m1]
+
+        results = await r.xrevrange(stream, max=m3, min=m2)
+        assert get_ids(results) == [m3, m2]
+
+        results = await r.xrevrange(stream, min=m3)
+        assert get_ids(results) == [m4, m3]
+
+        results = await r.xrevrange(stream, min=m2, count=1)
+        assert get_ids(results) == [m4]
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_xtrim(self, r: redis.Redis):
+        stream = "stream"
+
+        # trimming an empty key doesn't do anything
+        assert await r.xtrim(stream, 1000) == 0
+
+        await r.xadd(stream, {"foo": "bar"})
+        await r.xadd(stream, {"foo": "bar"})
+        await r.xadd(stream, {"foo": "bar"})
+        await r.xadd(stream, {"foo": "bar"})
+
+        # trimming an amount large than the number of messages
+        # doesn't do anything
+        assert await r.xtrim(stream, 5, approximate=False) == 0
+
+        # 1 message is trimmed
+        assert await r.xtrim(stream, 3, approximate=False) == 1
+
+    async def test_bitfield_operations(self, r: redis.Redis):
+        # comments show affected bits
+        await r.execute_command("SELECT", 10)
+        bf = r.bitfield("a")
+        resp = await (
+            bf.set("u8", 8, 255)  # 00000000 11111111
+            .get("u8", 0)  # 00000000
+            .get("u4", 8)  # 1111
+            .get("u4", 12)  # 1111
+            .get("u4", 13)  # 111 0
+            .execute()
+        )
+        assert resp == [0, 0, 15, 15, 14]
+
+        # .set() returns the previous value...
+        resp = await (
+            bf.set("u8", 4, 1)  # 0000 0001
+            .get("u16", 0)  # 00000000 00011111
+            .set("u16", 0, 0)  # 00000000 00000000
+            .execute()
+        )
+        assert resp == [15, 31, 31]
+
+        # incrby adds to the value
+        resp = await (
+            bf.incrby("u8", 8, 254)  # 00000000 11111110
+            .incrby("u8", 8, 1)  # 00000000 11111111
+            .get("u16", 0)  # 00000000 11111111
+            .execute()
+        )
+        assert resp == [254, 255, 255]
+
+        # Verify overflow protection works as a method:
+        await r.delete("a")
+        resp = await (
+            bf.set("u8", 8, 254)  # 00000000 11111110
+            .overflow("fail")
+            .incrby("u8", 8, 2)  # incrby 2 would overflow, None returned
+            .incrby("u8", 8, 1)  # 00000000 11111111
+            .incrby("u8", 8, 1)  # incrby 1 would overflow, None returned
+            .get("u16", 0)  # 00000000 11111111
+            .execute()
+        )
+        assert resp == [0, None, 255, None, 255]
+
+        # Verify overflow protection works as arg to incrby:
+        await r.delete("a")
+        resp = await (
+            bf.set("u8", 8, 255)  # 00000000 11111111
+            .incrby("u8", 8, 1)  # 00000000 00000000  wrap default
+            .set("u8", 8, 255)  # 00000000 11111111
+            .incrby("u8", 8, 1, "FAIL")  # 00000000 11111111  fail
+            .incrby("u8", 8, 1)  # 00000000 11111111  still fail
+            .get("u16", 0)  # 00000000 11111111
+            .execute()
+        )
+        assert resp == [0, 0, 0, None, None, 255]
+
+        # test default default_overflow
+        await r.delete("a")
+        bf = r.bitfield("a", default_overflow="FAIL")
+        resp = await (
+            bf.set("u8", 8, 255)  # 00000000 11111111
+            .incrby("u8", 8, 1)  # 00000000 11111111  fail default
+            .get("u16", 0)  # 00000000 11111111
+            .execute()
+        )
+        assert resp == [0, None, 255]
+
+    @skip_if_server_version_lt("4.0.0")
+    async def test_memory_stats(self, r: redis.Redis):
+        # put a key into the current db to make sure that "db.<current-db>"
+        # has data
+        await r.set("foo", "bar")
+        stats = await r.memory_stats()
+        assert isinstance(stats, dict)
+        for key, value in stats.items():
+            if key.startswith("db."):
+                assert isinstance(value, dict)
+
+    @skip_if_server_version_lt("4.0.0")
+    async def test_memory_usage(self, r: redis.Redis):
+        await r.set("foo", "bar")
+        assert isinstance(await r.memory_usage("foo"), int)
+
+    @skip_if_server_version_lt("4.0.0")
+    async def test_module_list(self, r: redis.Redis):
+        assert isinstance(await r.module_list(), list)
+        assert not await r.module_list()
+
+
+class TestBinarySave:
+    async def test_binary_get_set(self, r: redis.Redis):
+        assert await r.set(" foo bar ", "123")
+        assert await r.get(" foo bar ") == b"123"
+
+        assert await r.set(" foo\r\nbar\r\n ", "456")
+        assert await r.get(" foo\r\nbar\r\n ") == b"456"
+
+        assert await r.set(" \r\n\t\x07\x13 ", "789")
+        assert await r.get(" \r\n\t\x07\x13 ") == b"789"
+
+        assert sorted(await r.keys("*")) == [
+            b" \r\n\t\x07\x13 ",
+            b" foo\r\nbar\r\n ",
+            b" foo bar ",
+        ]
+
+        assert await r.delete(" foo bar ")
+        assert await r.delete(" foo\r\nbar\r\n ")
+        assert await r.delete(" \r\n\t\x07\x13 ")
+
+    async def test_binary_lists(self, r: redis.Redis):
+        mapping = {
+            b"foo bar": [b"1", b"2", b"3"],
+            b"foo\r\nbar\r\n": [b"4", b"5", b"6"],
+            b"foo\tbar\x07": [b"7", b"8", b"9"],
+        }
+        # fill in lists
+        for key, value in mapping.items():
+            await r.rpush(key, *value)
+
+        # check that KEYS returns all the keys as they are
+        assert sorted(await r.keys("*")) == sorted(mapping.keys())
+
+        # check that it is possible to get list content by key name
+        for key, value in mapping.items():
+            assert await r.lrange(key, 0, -1) == value
+
+    async def test_22_info(self, r: redis.Redis):
+        """
+        Older Redis versions contained 'allocation_stats' in INFO that
+        was the cause of a number of bugs when parsing.
+        """
+        info = (
+            "allocation_stats:6=1,7=1,8=7141,9=180,10=92,11=116,12=5330,"
+            "13=123,14=3091,15=11048,16=225842,17=1784,18=814,19=12020,"
+            "20=2530,21=645,22=15113,23=8695,24=142860,25=318,26=3303,"
+            "27=20561,28=54042,29=37390,30=1884,31=18071,32=31367,33=160,"
+            "34=169,35=201,36=10155,37=1045,38=15078,39=22985,40=12523,"
+            "41=15588,42=265,43=1287,44=142,45=382,46=945,47=426,48=171,"
+            "49=56,50=516,51=43,52=41,53=46,54=54,55=75,56=647,57=332,"
+            "58=32,59=39,60=48,61=35,62=62,63=32,64=221,65=26,66=30,"
+            "67=36,68=41,69=44,70=26,71=144,72=169,73=24,74=37,75=25,"
+            "76=42,77=21,78=126,79=374,80=27,81=40,82=43,83=47,84=46,"
+            "85=114,86=34,87=37,88=7240,89=34,90=38,91=18,92=99,93=20,"
+            "94=18,95=17,96=15,97=22,98=18,99=69,100=17,101=22,102=15,"
+            "103=29,104=39,105=30,106=70,107=22,108=21,109=26,110=52,"
+            "111=45,112=33,113=67,114=41,115=44,116=48,117=53,118=54,"
+            "119=51,120=75,121=44,122=57,123=44,124=66,125=56,126=52,"
+            "127=81,128=108,129=70,130=50,131=51,132=53,133=45,134=62,"
+            "135=12,136=13,137=7,138=15,139=21,140=11,141=20,142=6,143=7,"
+            "144=11,145=6,146=16,147=19,148=1112,149=1,151=83,154=1,"
+            "155=1,156=1,157=1,160=1,161=1,162=2,166=1,169=1,170=1,171=2,"
+            "172=1,174=1,176=2,177=9,178=34,179=73,180=30,181=1,185=3,"
+            "187=1,188=1,189=1,192=1,196=1,198=1,200=1,201=1,204=1,205=1,"
+            "207=1,208=1,209=1,214=2,215=31,216=78,217=28,218=5,219=2,"
+            "220=1,222=1,225=1,227=1,234=1,242=1,250=1,252=1,253=1,"
+            ">=256=203"
+        )
+        parsed = parse_info(info)
+        assert "allocation_stats" in parsed
+        assert "6" in parsed["allocation_stats"]
+        assert ">=256" in parsed["allocation_stats"]
+
+    async def test_large_responses(self, r: redis.Redis):
+        """The PythonParser has some special cases for return values > 1MB"""
+        # load up 5MB of data into a key
+        data = "".join([ascii_letters] * (5000000 // len(ascii_letters)))
+        await r.set("a", data)
+        assert await r.get("a") == data.encode()
+
+    async def test_floating_point_encoding(self, r: redis.Redis):
+        """
+        High precision floating point values sent to the server should keep
+        precision.
+        """
+        timestamp = 1349673917.939762
+        await r.zadd("a", {"a1": timestamp})
+        assert await r.zscore("a", "a1") == timestamp
diff --git a/tests/test_asyncio/test_json.py b/tests/test_asyncio/test_json.py
new file mode 100644
index 0000000000..6bd95810f6
--- /dev/null
+++ b/tests/test_asyncio/test_json.py
@@ -0,0 +1,964 @@
+import pytest
+
+import redis.asyncio as redis
+from redis import exceptions
+from redis.commands.json.path import Path
+from tests.conftest import skip_ifmodversion_lt
+
+pytestmark = pytest.mark.asyncio
+
+
+@pytest.mark.redismod
+async def test_json_setbinarykey(modclient: redis.Redis):
+    d = {"hello": "world", b"some": "value"}
+    with pytest.raises(TypeError):
+        modclient.json().set("somekey", Path.root_path(), d)
+    assert await modclient.json().set("somekey", Path.root_path(), d, decode_keys=True)
+
+
+@pytest.mark.redismod
+async def test_json_setgetdeleteforget(modclient: redis.Redis):
+    assert await modclient.json().set("foo", Path.root_path(), "bar")
+    assert await modclient.json().get("foo") == "bar"
+    assert await modclient.json().get("baz") is None
+    assert await modclient.json().delete("foo") == 1
+    assert await modclient.json().forget("foo") == 0  # second delete
+    assert await modclient.exists("foo") == 0
+
+
+@pytest.mark.redismod
+async def test_jsonget(modclient: redis.Redis):
+    await modclient.json().set("foo", Path.root_path(), "bar")
+    assert await modclient.json().get("foo") == "bar"
+
+
+@pytest.mark.redismod
+async def test_json_get_jset(modclient: redis.Redis):
+    assert await modclient.json().set("foo", Path.root_path(), "bar")
+    assert "bar" == await modclient.json().get("foo")
+    assert await modclient.json().get("baz") is None
+    assert 1 == await modclient.json().delete("foo")
+    assert await modclient.exists("foo") == 0
+
+
+@pytest.mark.redismod
+async def test_nonascii_setgetdelete(modclient: redis.Redis):
+    assert await modclient.json().set("notascii", Path.root_path(), "hyvää-élève")
+    assert "hyvää-élève" == await modclient.json().get("notascii", no_escape=True)
+    assert 1 == await modclient.json().delete("notascii")
+    assert await modclient.exists("notascii") == 0
+
+
+@pytest.mark.redismod
+async def test_jsonsetexistentialmodifiersshouldsucceed(modclient: redis.Redis):
+    obj = {"foo": "bar"}
+    assert await modclient.json().set("obj", Path.root_path(), obj)
+
+    # Test that flags prevent updates when conditions are unmet
+    assert await modclient.json().set("obj", Path("foo"), "baz", nx=True) is None
+    assert await modclient.json().set("obj", Path("qaz"), "baz", xx=True) is None
+
+    # Test that flags allow updates when conditions are met
+    assert await modclient.json().set("obj", Path("foo"), "baz", xx=True)
+    assert await modclient.json().set("obj", Path("qaz"), "baz", nx=True)
+
+    # Test that flags are mutually exlusive
+    with pytest.raises(Exception):
+        await modclient.json().set("obj", Path("foo"), "baz", nx=True, xx=True)
+
+
+@pytest.mark.redismod
+async def test_mgetshouldsucceed(modclient: redis.Redis):
+    await modclient.json().set("1", Path.root_path(), 1)
+    await modclient.json().set("2", Path.root_path(), 2)
+    assert await modclient.json().mget(["1"], Path.root_path()) == [1]
+
+    assert await modclient.json().mget([1, 2], Path.root_path()) == [1, 2]
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
+async def test_clear(modclient: redis.Redis):
+    await modclient.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 1 == await modclient.json().clear("arr", Path.root_path())
+    assert [] == await modclient.json().get("arr")
+
+
+@pytest.mark.redismod
+async def test_type(modclient: redis.Redis):
+    await modclient.json().set("1", Path.root_path(), 1)
+    assert "integer" == await modclient.json().type("1", Path.root_path())
+    assert "integer" == await modclient.json().type("1")
+
+
+@pytest.mark.redismod
+async def test_numincrby(modclient):
+    await modclient.json().set("num", Path.root_path(), 1)
+    assert 2 == await modclient.json().numincrby("num", Path.root_path(), 1)
+    assert 2.5 == await modclient.json().numincrby("num", Path.root_path(), 0.5)
+    assert 1.25 == await modclient.json().numincrby("num", Path.root_path(), -1.25)
+
+
+@pytest.mark.redismod
+async def test_nummultby(modclient: redis.Redis):
+    await modclient.json().set("num", Path.root_path(), 1)
+
+    with pytest.deprecated_call():
+        assert 2 == await modclient.json().nummultby("num", Path.root_path(), 2)
+        assert 5 == await modclient.json().nummultby("num", Path.root_path(), 2.5)
+        assert 2.5 == await modclient.json().nummultby("num", Path.root_path(), 0.5)
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
+async def test_toggle(modclient: redis.Redis):
+    await modclient.json().set("bool", Path.root_path(), False)
+    assert await modclient.json().toggle("bool", Path.root_path())
+    assert await modclient.json().toggle("bool", Path.root_path()) is False
+    # check non-boolean value
+    await modclient.json().set("num", Path.root_path(), 1)
+    with pytest.raises(exceptions.ResponseError):
+        await modclient.json().toggle("num", Path.root_path())
+
+
+@pytest.mark.redismod
+async def test_strappend(modclient: redis.Redis):
+    await modclient.json().set("jsonkey", Path.root_path(), "foo")
+    assert 6 == await modclient.json().strappend("jsonkey", "bar")
+    assert "foobar" == await modclient.json().get("jsonkey", Path.root_path())
+
+
+@pytest.mark.redismod
+async def test_strlen(modclient: redis.Redis):
+    await modclient.json().set("str", Path.root_path(), "foo")
+    assert 3 == await modclient.json().strlen("str", Path.root_path())
+    await modclient.json().strappend("str", "bar", Path.root_path())
+    assert 6 == await modclient.json().strlen("str", Path.root_path())
+    assert 6 == await modclient.json().strlen("str")
+
+
+@pytest.mark.redismod
+async def test_arrappend(modclient: redis.Redis):
+    await modclient.json().set("arr", Path.root_path(), [1])
+    assert 2 == await modclient.json().arrappend("arr", Path.root_path(), 2)
+    assert 4 == await modclient.json().arrappend("arr", Path.root_path(), 3, 4)
+    assert 7 == await modclient.json().arrappend("arr", Path.root_path(), *[5, 6, 7])
+
+
+@pytest.mark.redismod
+async def test_arrindex(modclient: redis.Redis):
+    await modclient.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 1 == await modclient.json().arrindex("arr", Path.root_path(), 1)
+    assert -1 == await modclient.json().arrindex("arr", Path.root_path(), 1, 2)
+
+
+@pytest.mark.redismod
+async def test_arrinsert(modclient: redis.Redis):
+    await modclient.json().set("arr", Path.root_path(), [0, 4])
+    assert 5 - -await modclient.json().arrinsert(
+        "arr",
+        Path.root_path(),
+        1,
+        *[
+            1,
+            2,
+            3,
+        ],
+    )
+    assert [0, 1, 2, 3, 4] == await modclient.json().get("arr")
+
+    # test prepends
+    await modclient.json().set("val2", Path.root_path(), [5, 6, 7, 8, 9])
+    await modclient.json().arrinsert("val2", Path.root_path(), 0, ["some", "thing"])
+    assert await modclient.json().get("val2") == [["some", "thing"], 5, 6, 7, 8, 9]
+
+
+@pytest.mark.redismod
+async def test_arrlen(modclient: redis.Redis):
+    await modclient.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 5 == await modclient.json().arrlen("arr", Path.root_path())
+    assert 5 == await modclient.json().arrlen("arr")
+    assert await modclient.json().arrlen("fakekey") is None
+
+
+@pytest.mark.redismod
+async def test_arrpop(modclient: redis.Redis):
+    await modclient.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 4 == await modclient.json().arrpop("arr", Path.root_path(), 4)
+    assert 3 == await modclient.json().arrpop("arr", Path.root_path(), -1)
+    assert 2 == await modclient.json().arrpop("arr", Path.root_path())
+    assert 0 == await modclient.json().arrpop("arr", Path.root_path(), 0)
+    assert [1] == await modclient.json().get("arr")
+
+    # test out of bounds
+    await modclient.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 4 == await modclient.json().arrpop("arr", Path.root_path(), 99)
+
+    # none test
+    await modclient.json().set("arr", Path.root_path(), [])
+    assert await modclient.json().arrpop("arr") is None
+
+
+@pytest.mark.redismod
+async def test_arrtrim(modclient: redis.Redis):
+    await modclient.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 3 == await modclient.json().arrtrim("arr", Path.root_path(), 1, 3)
+    assert [1, 2, 3] == await modclient.json().get("arr")
+
+    # <0 test, should be 0 equivalent
+    await modclient.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 0 == await modclient.json().arrtrim("arr", Path.root_path(), -1, 3)
+
+    # testing stop > end
+    await modclient.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 2 == await modclient.json().arrtrim("arr", Path.root_path(), 3, 99)
+
+    # start > array size and stop
+    await modclient.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 0 == await modclient.json().arrtrim("arr", Path.root_path(), 9, 1)
+
+    # all larger
+    await modclient.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 0 == await modclient.json().arrtrim("arr", Path.root_path(), 9, 11)
+
+
+@pytest.mark.redismod
+async def test_resp(modclient: redis.Redis):
+    obj = {"foo": "bar", "baz": 1, "qaz": True}
+    await modclient.json().set("obj", Path.root_path(), obj)
+    assert "bar" == await modclient.json().resp("obj", Path("foo"))
+    assert 1 == await modclient.json().resp("obj", Path("baz"))
+    assert await modclient.json().resp("obj", Path("qaz"))
+    assert isinstance(await modclient.json().resp("obj"), list)
+
+
+@pytest.mark.redismod
+async def test_objkeys(modclient: redis.Redis):
+    obj = {"foo": "bar", "baz": "qaz"}
+    await modclient.json().set("obj", Path.root_path(), obj)
+    keys = await modclient.json().objkeys("obj", Path.root_path())
+    keys.sort()
+    exp = list(obj.keys())
+    exp.sort()
+    assert exp == keys
+
+    await modclient.json().set("obj", Path.root_path(), obj)
+    keys = await modclient.json().objkeys("obj")
+    assert keys == list(obj.keys())
+
+    assert await modclient.json().objkeys("fakekey") is None
+
+
+@pytest.mark.redismod
+async def test_objlen(modclient: redis.Redis):
+    obj = {"foo": "bar", "baz": "qaz"}
+    await modclient.json().set("obj", Path.root_path(), obj)
+    assert len(obj) == await modclient.json().objlen("obj", Path.root_path())
+
+    await modclient.json().set("obj", Path.root_path(), obj)
+    assert len(obj) == await modclient.json().objlen("obj")
+
+
+# @pytest.mark.redismod
+# async def test_json_commands_in_pipeline(modclient: redis.Redis):
+#     async with modclient.json().pipeline() as p:
+#         p.set("foo", Path.root_path(), "bar")
+#         p.get("foo")
+#         p.delete("foo")
+#         assert [True, "bar", 1] == await p.execute()
+#     assert await modclient.keys() == []
+#     assert await modclient.get("foo") is None
+
+#     # now with a true, json object
+#     await modclient.flushdb()
+#     p = await modclient.json().pipeline()
+#     d = {"hello": "world", "oh": "snap"}
+#     with pytest.deprecated_call():
+#         p.jsonset("foo", Path.root_path(), d)
+#         p.jsonget("foo")
+#     p.exists("notarealkey")
+#     p.delete("foo")
+#     assert [True, d, 0, 1] == p.execute()
+#     assert await modclient.keys() == []
+#     assert await modclient.get("foo") is None
+
+
+@pytest.mark.redismod
+async def test_json_delete_with_dollar(modclient: redis.Redis):
+    doc1 = {"a": 1, "nested": {"a": 2, "b": 3}}
+    assert await modclient.json().set("doc1", "$", doc1)
+    assert await modclient.json().delete("doc1", "$..a") == 2
+    r = await modclient.json().get("doc1", "$")
+    assert r == [{"nested": {"b": 3}}]
+
+    doc2 = {"a": {"a": 2, "b": 3}, "b": ["a", "b"], "nested": {"b": [True, "a", "b"]}}
+    assert await modclient.json().set("doc2", "$", doc2)
+    assert await modclient.json().delete("doc2", "$..a") == 1
+    res = await modclient.json().get("doc2", "$")
+    assert res == [{"nested": {"b": [True, "a", "b"]}, "b": ["a", "b"]}]
+
+    doc3 = [
+        {
+            "ciao": ["non ancora"],
+            "nested": [
+                {"ciao": [1, "a"]},
+                {"ciao": [2, "a"]},
+                {"ciaoc": [3, "non", "ciao"]},
+                {"ciao": [4, "a"]},
+                {"e": [5, "non", "ciao"]},
+            ],
+        }
+    ]
+    assert await modclient.json().set("doc3", "$", doc3)
+    assert await modclient.json().delete("doc3", '$.[0]["nested"]..ciao') == 3
+
+    doc3val = [
+        [
+            {
+                "ciao": ["non ancora"],
+                "nested": [
+                    {},
+                    {},
+                    {"ciaoc": [3, "non", "ciao"]},
+                    {},
+                    {"e": [5, "non", "ciao"]},
+                ],
+            }
+        ]
+    ]
+    res = await modclient.json().get("doc3", "$")
+    assert res == doc3val
+
+    # Test async default path
+    assert await modclient.json().delete("doc3") == 1
+    assert await modclient.json().get("doc3", "$") is None
+
+    await modclient.json().delete("not_a_document", "..a")
+
+
+@pytest.mark.redismod
+async def test_json_forget_with_dollar(modclient: redis.Redis):
+    doc1 = {"a": 1, "nested": {"a": 2, "b": 3}}
+    assert await modclient.json().set("doc1", "$", doc1)
+    assert await modclient.json().forget("doc1", "$..a") == 2
+    r = await modclient.json().get("doc1", "$")
+    assert r == [{"nested": {"b": 3}}]
+
+    doc2 = {"a": {"a": 2, "b": 3}, "b": ["a", "b"], "nested": {"b": [True, "a", "b"]}}
+    assert await modclient.json().set("doc2", "$", doc2)
+    assert await modclient.json().forget("doc2", "$..a") == 1
+    res = await modclient.json().get("doc2", "$")
+    assert res == [{"nested": {"b": [True, "a", "b"]}, "b": ["a", "b"]}]
+
+    doc3 = [
+        {
+            "ciao": ["non ancora"],
+            "nested": [
+                {"ciao": [1, "a"]},
+                {"ciao": [2, "a"]},
+                {"ciaoc": [3, "non", "ciao"]},
+                {"ciao": [4, "a"]},
+                {"e": [5, "non", "ciao"]},
+            ],
+        }
+    ]
+    assert await modclient.json().set("doc3", "$", doc3)
+    assert await modclient.json().forget("doc3", '$.[0]["nested"]..ciao') == 3
+
+    doc3val = [
+        [
+            {
+                "ciao": ["non ancora"],
+                "nested": [
+                    {},
+                    {},
+                    {"ciaoc": [3, "non", "ciao"]},
+                    {},
+                    {"e": [5, "non", "ciao"]},
+                ],
+            }
+        ]
+    ]
+    res = await modclient.json().get("doc3", "$")
+    assert res == doc3val
+
+    # Test async default path
+    assert await modclient.json().forget("doc3") == 1
+    assert await modclient.json().get("doc3", "$") is None
+
+    await modclient.json().forget("not_a_document", "..a")
+
+
+@pytest.mark.redismod
+async def test_json_mget_dollar(modclient: redis.Redis):
+    # Test mget with multi paths
+    await modclient.json().set(
+        "doc1",
+        "$",
+        {"a": 1, "b": 2, "nested": {"a": 3}, "c": None, "nested2": {"a": None}},
+    )
+    await modclient.json().set(
+        "doc2",
+        "$",
+        {"a": 4, "b": 5, "nested": {"a": 6}, "c": None, "nested2": {"a": [None]}},
+    )
+    # Compare also to single JSON.GET
+    assert await modclient.json().get("doc1", "$..a") == [1, 3, None]
+    assert await modclient.json().get("doc2", "$..a") == [4, 6, [None]]
+
+    # Test mget with single path
+    await modclient.json().mget("doc1", "$..a") == [1, 3, None]
+    # Test mget with multi path
+    res = await modclient.json().mget(["doc1", "doc2"], "$..a")
+    assert res == [[1, 3, None], [4, 6, [None]]]
+
+    # Test missing key
+    res = await modclient.json().mget(["doc1", "missing_doc"], "$..a")
+    assert res == [[1, 3, None], None]
+    res = await modclient.json().mget(["missing_doc1", "missing_doc2"], "$..a")
+    assert res == [None, None]
+
+
+@pytest.mark.redismod
+async def test_numby_commands_dollar(modclient: redis.Redis):
+
+    # Test NUMINCRBY
+    await modclient.json().set(
+        "doc1", "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]}
+    )
+    # Test multi
+    assert await modclient.json().numincrby("doc1", "$..a", 2) == [None, 4, 7.0, None]
+
+    res = await modclient.json().numincrby("doc1", "$..a", 2.5)
+    assert res == [None, 6.5, 9.5, None]
+    # Test single
+    assert await modclient.json().numincrby("doc1", "$.b[1].a", 2) == [11.5]
+
+    assert await modclient.json().numincrby("doc1", "$.b[2].a", 2) == [None]
+    assert await modclient.json().numincrby("doc1", "$.b[1].a", 3.5) == [15.0]
+
+    # Test NUMMULTBY
+    await modclient.json().set(
+        "doc1", "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]}
+    )
+
+    # test list
+    with pytest.deprecated_call():
+        res = await modclient.json().nummultby("doc1", "$..a", 2)
+        assert res == [None, 4, 10, None]
+        res = await modclient.json().nummultby("doc1", "$..a", 2.5)
+        assert res == [None, 10.0, 25.0, None]
+
+    # Test single
+    with pytest.deprecated_call():
+        assert await modclient.json().nummultby("doc1", "$.b[1].a", 2) == [50.0]
+        assert await modclient.json().nummultby("doc1", "$.b[2].a", 2) == [None]
+        assert await modclient.json().nummultby("doc1", "$.b[1].a", 3) == [150.0]
+
+    # test missing keys
+    with pytest.raises(exceptions.ResponseError):
+        await modclient.json().numincrby("non_existing_doc", "$..a", 2)
+        await modclient.json().nummultby("non_existing_doc", "$..a", 2)
+
+    # Test legacy NUMINCRBY
+    await modclient.json().set(
+        "doc1", "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]}
+    )
+    await modclient.json().numincrby("doc1", ".b[0].a", 3) == 5
+
+    # Test legacy NUMMULTBY
+    await modclient.json().set(
+        "doc1", "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]}
+    )
+
+    with pytest.deprecated_call():
+        await modclient.json().nummultby("doc1", ".b[0].a", 3) == 6
+
+
+@pytest.mark.redismod
+async def test_strappend_dollar(modclient: redis.Redis):
+
+    await modclient.json().set(
+        "doc1", "$", {"a": "foo", "nested1": {"a": "hello"}, "nested2": {"a": 31}}
+    )
+    # Test multi
+    await modclient.json().strappend("doc1", "bar", "$..a") == [6, 8, None]
+
+    await modclient.json().get("doc1", "$") == [
+        {"a": "foobar", "nested1": {"a": "hellobar"}, "nested2": {"a": 31}}
+    ]
+    # Test single
+    await modclient.json().strappend("doc1", "baz", "$.nested1.a") == [11]
+
+    await modclient.json().get("doc1", "$") == [
+        {"a": "foobar", "nested1": {"a": "hellobarbaz"}, "nested2": {"a": 31}}
+    ]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        await modclient.json().strappend("non_existing_doc", "$..a", "err")
+
+    # Test multi
+    await modclient.json().strappend("doc1", "bar", ".*.a") == 8
+    await modclient.json().get("doc1", "$") == [
+        {"a": "foo", "nested1": {"a": "hellobar"}, "nested2": {"a": 31}}
+    ]
+
+    # Test missing path
+    with pytest.raises(exceptions.ResponseError):
+        await modclient.json().strappend("doc1", "piu")
+
+
+@pytest.mark.redismod
+async def test_strlen_dollar(modclient: redis.Redis):
+
+    # Test multi
+    await modclient.json().set(
+        "doc1", "$", {"a": "foo", "nested1": {"a": "hello"}, "nested2": {"a": 31}}
+    )
+    assert await modclient.json().strlen("doc1", "$..a") == [3, 5, None]
+
+    res2 = await modclient.json().strappend("doc1", "bar", "$..a")
+    res1 = await modclient.json().strlen("doc1", "$..a")
+    assert res1 == res2
+
+    # Test single
+    await modclient.json().strlen("doc1", "$.nested1.a") == [8]
+    await modclient.json().strlen("doc1", "$.nested2.a") == [None]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        await modclient.json().strlen("non_existing_doc", "$..a")
+
+
+@pytest.mark.redismod
+async def test_arrappend_dollar(modclient: redis.Redis):
+    await modclient.json().set(
+        "doc1",
+        "$",
+        {
+            "a": ["foo"],
+            "nested1": {"a": ["hello", None, "world"]},
+            "nested2": {"a": 31},
+        },
+    )
+    # Test multi
+    await modclient.json().arrappend("doc1", "$..a", "bar", "racuda") == [3, 5, None]
+    assert await modclient.json().get("doc1", "$") == [
+        {
+            "a": ["foo", "bar", "racuda"],
+            "nested1": {"a": ["hello", None, "world", "bar", "racuda"]},
+            "nested2": {"a": 31},
+        }
+    ]
+
+    # Test single
+    assert await modclient.json().arrappend("doc1", "$.nested1.a", "baz") == [6]
+    assert await modclient.json().get("doc1", "$") == [
+        {
+            "a": ["foo", "bar", "racuda"],
+            "nested1": {"a": ["hello", None, "world", "bar", "racuda", "baz"]},
+            "nested2": {"a": 31},
+        }
+    ]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        await modclient.json().arrappend("non_existing_doc", "$..a")
+
+    # Test legacy
+    await modclient.json().set(
+        "doc1",
+        "$",
+        {
+            "a": ["foo"],
+            "nested1": {"a": ["hello", None, "world"]},
+            "nested2": {"a": 31},
+        },
+    )
+    # Test multi (all paths are updated, but return result of last path)
+    assert await modclient.json().arrappend("doc1", "..a", "bar", "racuda") == 5
+
+    assert await modclient.json().get("doc1", "$") == [
+        {
+            "a": ["foo", "bar", "racuda"],
+            "nested1": {"a": ["hello", None, "world", "bar", "racuda"]},
+            "nested2": {"a": 31},
+        }
+    ]
+    # Test single
+    assert await modclient.json().arrappend("doc1", ".nested1.a", "baz") == 6
+    assert await modclient.json().get("doc1", "$") == [
+        {
+            "a": ["foo", "bar", "racuda"],
+            "nested1": {"a": ["hello", None, "world", "bar", "racuda", "baz"]},
+            "nested2": {"a": 31},
+        }
+    ]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        await modclient.json().arrappend("non_existing_doc", "$..a")
+
+
+@pytest.mark.redismod
+async def test_arrinsert_dollar(modclient: redis.Redis):
+    await modclient.json().set(
+        "doc1",
+        "$",
+        {
+            "a": ["foo"],
+            "nested1": {"a": ["hello", None, "world"]},
+            "nested2": {"a": 31},
+        },
+    )
+    # Test multi
+    res = await modclient.json().arrinsert("doc1", "$..a", "1", "bar", "racuda")
+    assert res == [3, 5, None]
+
+    assert await modclient.json().get("doc1", "$") == [
+        {
+            "a": ["foo", "bar", "racuda"],
+            "nested1": {"a": ["hello", "bar", "racuda", None, "world"]},
+            "nested2": {"a": 31},
+        }
+    ]
+    # Test single
+    assert await modclient.json().arrinsert("doc1", "$.nested1.a", -2, "baz") == [6]
+    assert await modclient.json().get("doc1", "$") == [
+        {
+            "a": ["foo", "bar", "racuda"],
+            "nested1": {"a": ["hello", "bar", "racuda", "baz", None, "world"]},
+            "nested2": {"a": 31},
+        }
+    ]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        await modclient.json().arrappend("non_existing_doc", "$..a")
+
+
+@pytest.mark.redismod
+async def test_arrlen_dollar(modclient: redis.Redis):
+
+    await modclient.json().set(
+        "doc1",
+        "$",
+        {
+            "a": ["foo"],
+            "nested1": {"a": ["hello", None, "world"]},
+            "nested2": {"a": 31},
+        },
+    )
+
+    # Test multi
+    assert await modclient.json().arrlen("doc1", "$..a") == [1, 3, None]
+    res = await modclient.json().arrappend("doc1", "$..a", "non", "abba", "stanza")
+    assert res == [4, 6, None]
+
+    await modclient.json().clear("doc1", "$.a")
+    assert await modclient.json().arrlen("doc1", "$..a") == [0, 6, None]
+    # Test single
+    assert await modclient.json().arrlen("doc1", "$.nested1.a") == [6]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        await modclient.json().arrappend("non_existing_doc", "$..a")
+
+    await modclient.json().set(
+        "doc1",
+        "$",
+        {
+            "a": ["foo"],
+            "nested1": {"a": ["hello", None, "world"]},
+            "nested2": {"a": 31},
+        },
+    )
+    # Test multi (return result of last path)
+    assert await modclient.json().arrlen("doc1", "$..a") == [1, 3, None]
+    assert await modclient.json().arrappend("doc1", "..a", "non", "abba", "stanza") == 6
+
+    # Test single
+    assert await modclient.json().arrlen("doc1", ".nested1.a") == 6
+
+    # Test missing key
+    assert await modclient.json().arrlen("non_existing_doc", "..a") is None
+
+
+@pytest.mark.redismod
+async def test_arrpop_dollar(modclient: redis.Redis):
+    await modclient.json().set(
+        "doc1",
+        "$",
+        {
+            "a": ["foo"],
+            "nested1": {"a": ["hello", None, "world"]},
+            "nested2": {"a": 31},
+        },
+    )
+
+    # # # Test multi
+    assert await modclient.json().arrpop("doc1", "$..a", 1) == ['"foo"', None, None]
+
+    assert await modclient.json().get("doc1", "$") == [
+        {"a": [], "nested1": {"a": ["hello", "world"]}, "nested2": {"a": 31}}
+    ]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        await modclient.json().arrpop("non_existing_doc", "..a")
+
+    # # Test legacy
+    await modclient.json().set(
+        "doc1",
+        "$",
+        {
+            "a": ["foo"],
+            "nested1": {"a": ["hello", None, "world"]},
+            "nested2": {"a": 31},
+        },
+    )
+    # Test multi (all paths are updated, but return result of last path)
+    await modclient.json().arrpop("doc1", "..a", "1") is None
+    assert await modclient.json().get("doc1", "$") == [
+        {"a": [], "nested1": {"a": ["hello", "world"]}, "nested2": {"a": 31}}
+    ]
+
+    # # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        await modclient.json().arrpop("non_existing_doc", "..a")
+
+
+@pytest.mark.redismod
+async def test_arrtrim_dollar(modclient: redis.Redis):
+
+    await modclient.json().set(
+        "doc1",
+        "$",
+        {
+            "a": ["foo"],
+            "nested1": {"a": ["hello", None, "world"]},
+            "nested2": {"a": 31},
+        },
+    )
+    # Test multi
+    assert await modclient.json().arrtrim("doc1", "$..a", "1", -1) == [0, 2, None]
+    assert await modclient.json().get("doc1", "$") == [
+        {"a": [], "nested1": {"a": [None, "world"]}, "nested2": {"a": 31}}
+    ]
+
+    assert await modclient.json().arrtrim("doc1", "$..a", "1", "1") == [0, 1, None]
+    assert await modclient.json().get("doc1", "$") == [
+        {"a": [], "nested1": {"a": ["world"]}, "nested2": {"a": 31}}
+    ]
+    # Test single
+    assert await modclient.json().arrtrim("doc1", "$.nested1.a", 1, 0) == [0]
+    assert await modclient.json().get("doc1", "$") == [
+        {"a": [], "nested1": {"a": []}, "nested2": {"a": 31}}
+    ]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        await modclient.json().arrtrim("non_existing_doc", "..a", "0", 1)
+
+    # Test legacy
+    await modclient.json().set(
+        "doc1",
+        "$",
+        {
+            "a": ["foo"],
+            "nested1": {"a": ["hello", None, "world"]},
+            "nested2": {"a": 31},
+        },
+    )
+
+    # Test multi (all paths are updated, but return result of last path)
+    assert await modclient.json().arrtrim("doc1", "..a", "1", "-1") == 2
+
+    # Test single
+    assert await modclient.json().arrtrim("doc1", ".nested1.a", "1", "1") == 1
+    assert await modclient.json().get("doc1", "$") == [
+        {"a": [], "nested1": {"a": ["world"]}, "nested2": {"a": 31}}
+    ]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        await modclient.json().arrtrim("non_existing_doc", "..a", 1, 1)
+
+
+@pytest.mark.redismod
+async def test_objkeys_dollar(modclient: redis.Redis):
+    await modclient.json().set(
+        "doc1",
+        "$",
+        {
+            "nested1": {"a": {"foo": 10, "bar": 20}},
+            "a": ["foo"],
+            "nested2": {"a": {"baz": 50}},
+        },
+    )
+
+    # Test single
+    assert await modclient.json().objkeys("doc1", "$.nested1.a") == [["foo", "bar"]]
+
+    # Test legacy
+    assert await modclient.json().objkeys("doc1", ".*.a") == ["foo", "bar"]
+    # Test single
+    assert await modclient.json().objkeys("doc1", ".nested2.a") == ["baz"]
+
+    # Test missing key
+    assert await modclient.json().objkeys("non_existing_doc", "..a") is None
+
+    # Test non existing doc
+    with pytest.raises(exceptions.ResponseError):
+        assert await modclient.json().objkeys("non_existing_doc", "$..a") == []
+
+    assert await modclient.json().objkeys("doc1", "$..nowhere") == []
+
+
+@pytest.mark.redismod
+async def test_objlen_dollar(modclient: redis.Redis):
+    await modclient.json().set(
+        "doc1",
+        "$",
+        {
+            "nested1": {"a": {"foo": 10, "bar": 20}},
+            "a": ["foo"],
+            "nested2": {"a": {"baz": 50}},
+        },
+    )
+    # Test multi
+    assert await modclient.json().objlen("doc1", "$..a") == [2, None, 1]
+    # Test single
+    assert await modclient.json().objlen("doc1", "$.nested1.a") == [2]
+
+    # Test missing key, and path
+    with pytest.raises(exceptions.ResponseError):
+        await modclient.json().objlen("non_existing_doc", "$..a")
+
+    assert await modclient.json().objlen("doc1", "$.nowhere") == []
+
+    # Test legacy
+    assert await modclient.json().objlen("doc1", ".*.a") == 2
+
+    # Test single
+    assert await modclient.json().objlen("doc1", ".nested2.a") == 1
+
+    # Test missing key
+    assert await modclient.json().objlen("non_existing_doc", "..a") is None
+
+    # Test missing path
+    # with pytest.raises(exceptions.ResponseError):
+    await modclient.json().objlen("doc1", ".nowhere")
+
+
+@pytest.mark.redismod
+def load_types_data(nested_key_name):
+    td = {
+        "object": {},
+        "array": [],
+        "string": "str",
+        "integer": 42,
+        "number": 1.2,
+        "boolean": False,
+        "null": None,
+    }
+    jdata = {}
+    types = []
+    for i, (k, v) in zip(range(1, len(td) + 1), iter(td.items())):
+        jdata["nested" + str(i)] = {nested_key_name: v}
+        types.append(k)
+
+    return jdata, types
+
+
+@pytest.mark.redismod
+async def test_type_dollar(modclient: redis.Redis):
+    jdata, jtypes = load_types_data("a")
+    await modclient.json().set("doc1", "$", jdata)
+    # Test multi
+    assert await modclient.json().type("doc1", "$..a") == jtypes
+
+    # Test single
+    assert await modclient.json().type("doc1", "$.nested2.a") == [jtypes[1]]
+
+    # Test missing key
+    assert await modclient.json().type("non_existing_doc", "..a") is None
+
+
+@pytest.mark.redismod
+async def test_clear_dollar(modclient: redis.Redis):
+
+    await modclient.json().set(
+        "doc1",
+        "$",
+        {
+            "nested1": {"a": {"foo": 10, "bar": 20}},
+            "a": ["foo"],
+            "nested2": {"a": "claro"},
+            "nested3": {"a": {"baz": 50}},
+        },
+    )
+    # Test multi
+    assert await modclient.json().clear("doc1", "$..a") == 4
+
+    assert await modclient.json().get("doc1", "$") == [
+        {"nested1": {"a": {}}, "a": [], "nested2": {"a": ""}, "nested3": {"a": {}}}
+    ]
+
+    # Test single
+    await modclient.json().set(
+        "doc1",
+        "$",
+        {
+            "nested1": {"a": {"foo": 10, "bar": 20}},
+            "a": ["foo"],
+            "nested2": {"a": "claro"},
+            "nested3": {"a": {"baz": 50}},
+        },
+    )
+    assert await modclient.json().clear("doc1", "$.nested1.a") == 1
+    assert await modclient.json().get("doc1", "$") == [
+        {
+            "nested1": {"a": {}},
+            "a": ["foo"],
+            "nested2": {"a": "claro"},
+            "nested3": {"a": {"baz": 50}},
+        }
+    ]
+
+    # Test missing path (async defaults to root)
+    assert await modclient.json().clear("doc1") == 1
+    assert await modclient.json().get("doc1", "$") == [{}]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        await modclient.json().clear("non_existing_doc", "$..a")
+
+
+@pytest.mark.redismod
+async def test_toggle_dollar(modclient: redis.Redis):
+    await modclient.json().set(
+        "doc1",
+        "$",
+        {
+            "a": ["foo"],
+            "nested1": {"a": False},
+            "nested2": {"a": 31},
+            "nested3": {"a": True},
+        },
+    )
+    # Test multi
+    assert await modclient.json().toggle("doc1", "$..a") == [None, 1, None, 0]
+    assert await modclient.json().get("doc1", "$") == [
+        {
+            "a": ["foo"],
+            "nested1": {"a": True},
+            "nested2": {"a": 31},
+            "nested3": {"a": False},
+        }
+    ]
+
+    # Test missing key
+    with pytest.raises(exceptions.ResponseError):
+        await modclient.json().toggle("non_existing_doc", "$..a")
diff --git a/tests/test_asyncio/test_timeseries.py b/tests/test_asyncio/test_timeseries.py
new file mode 100644
index 0000000000..70ca6fdeb6
--- /dev/null
+++ b/tests/test_asyncio/test_timeseries.py
@@ -0,0 +1,556 @@
+import time
+from time import sleep
+
+import pytest
+
+import redis.asyncio as redis
+from tests.conftest import skip_ifmodversion_lt
+
+pytestmark = pytest.mark.asyncio
+
+
+@pytest.mark.redismod
+async def test_create(modclient: redis.Redis):
+    assert await modclient.ts().create(1)
+    assert await modclient.ts().create(2, retention_msecs=5)
+    assert await modclient.ts().create(3, labels={"Redis": "Labs"})
+    assert await modclient.ts().create(4, retention_msecs=20, labels={"Time": "Series"})
+    info = await modclient.ts().info(4)
+    assert 20 == info.retention_msecs
+    assert "Series" == info.labels["Time"]
+
+    # Test for a chunk size of 128 Bytes
+    assert await modclient.ts().create("time-serie-1", chunk_size=128)
+    info = await modclient.ts().info("time-serie-1")
+    assert 128, info.chunk_size
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("1.4.0", "timeseries")
+async def test_create_duplicate_policy(modclient: redis.Redis):
+    # Test for duplicate policy
+    for duplicate_policy in ["block", "last", "first", "min", "max"]:
+        ts_name = f"time-serie-ooo-{duplicate_policy}"
+        assert await modclient.ts().create(ts_name, duplicate_policy=duplicate_policy)
+        info = await modclient.ts().info(ts_name)
+        assert duplicate_policy == info.duplicate_policy
+
+
+@pytest.mark.redismod
+async def test_alter(modclient: redis.Redis):
+    assert await modclient.ts().create(1)
+    res = await modclient.ts().info(1)
+    assert 0 == res.retention_msecs
+    assert await modclient.ts().alter(1, retention_msecs=10)
+    res = await modclient.ts().info(1)
+    assert {} == res.labels
+    res = await modclient.ts().info(1)
+    assert 10 == res.retention_msecs
+    assert await modclient.ts().alter(1, labels={"Time": "Series"})
+    res = await modclient.ts().info(1)
+    assert "Series" == res.labels["Time"]
+    res = await modclient.ts().info(1)
+    assert 10 == res.retention_msecs
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("1.4.0", "timeseries")
+async def test_alter_diplicate_policy(modclient: redis.Redis):
+    assert await modclient.ts().create(1)
+    info = await modclient.ts().info(1)
+    assert info.duplicate_policy is None
+    assert await modclient.ts().alter(1, duplicate_policy="min")
+    info = await modclient.ts().info(1)
+    assert "min" == info.duplicate_policy
+
+
+@pytest.mark.redismod
+async def test_add(modclient: redis.Redis):
+    assert 1 == await modclient.ts().add(1, 1, 1)
+    assert 2 == await modclient.ts().add(2, 2, 3, retention_msecs=10)
+    assert 3 == await modclient.ts().add(3, 3, 2, labels={"Redis": "Labs"})
+    assert 4 == await modclient.ts().add(
+        4, 4, 2, retention_msecs=10, labels={"Redis": "Labs", "Time": "Series"}
+    )
+    res = await modclient.ts().add(5, "*", 1)
+    assert round(time.time()) == round(float(res) / 1000)
+
+    info = await modclient.ts().info(4)
+    assert 10 == info.retention_msecs
+    assert "Labs" == info.labels["Redis"]
+
+    # Test for a chunk size of 128 Bytes on TS.ADD
+    assert await modclient.ts().add("time-serie-1", 1, 10.0, chunk_size=128)
+    info = await modclient.ts().info("time-serie-1")
+    assert 128 == info.chunk_size
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("1.4.0", "timeseries")
+async def test_add_duplicate_policy(modclient: redis.Redis):
+
+    # Test for duplicate policy BLOCK
+    assert 1 == await modclient.ts().add("time-serie-add-ooo-block", 1, 5.0)
+    with pytest.raises(Exception):
+        await modclient.ts().add(
+            "time-serie-add-ooo-block", 1, 5.0, duplicate_policy="block"
+        )
+
+    # Test for duplicate policy LAST
+    assert 1 == await modclient.ts().add("time-serie-add-ooo-last", 1, 5.0)
+    assert 1 == await modclient.ts().add(
+        "time-serie-add-ooo-last", 1, 10.0, duplicate_policy="last"
+    )
+    res = await modclient.ts().get("time-serie-add-ooo-last")
+    assert 10.0 == res[1]
+
+    # Test for duplicate policy FIRST
+    assert 1 == await modclient.ts().add("time-serie-add-ooo-first", 1, 5.0)
+    assert 1 == await modclient.ts().add(
+        "time-serie-add-ooo-first", 1, 10.0, duplicate_policy="first"
+    )
+    res = await modclient.ts().get("time-serie-add-ooo-first")
+    assert 5.0 == res[1]
+
+    # Test for duplicate policy MAX
+    assert 1 == await modclient.ts().add("time-serie-add-ooo-max", 1, 5.0)
+    assert 1 == await modclient.ts().add(
+        "time-serie-add-ooo-max", 1, 10.0, duplicate_policy="max"
+    )
+    res = await modclient.ts().get("time-serie-add-ooo-max")
+    assert 10.0 == res[1]
+
+    # Test for duplicate policy MIN
+    assert 1 == await modclient.ts().add("time-serie-add-ooo-min", 1, 5.0)
+    assert 1 == await modclient.ts().add(
+        "time-serie-add-ooo-min", 1, 10.0, duplicate_policy="min"
+    )
+    res = await modclient.ts().get("time-serie-add-ooo-min")
+    assert 5.0 == res[1]
+
+
+@pytest.mark.redismod
+async def test_madd(modclient: redis.Redis):
+    await modclient.ts().create("a")
+    assert [1, 2, 3] == await modclient.ts().madd(
+        [("a", 1, 5), ("a", 2, 10), ("a", 3, 15)]
+    )
+
+
+@pytest.mark.redismod
+async def test_incrby_decrby(modclient: redis.Redis):
+    for _ in range(100):
+        assert await modclient.ts().incrby(1, 1)
+        sleep(0.001)
+    assert 100 == (await modclient.ts().get(1))[1]
+    for _ in range(100):
+        assert await modclient.ts().decrby(1, 1)
+        sleep(0.001)
+    assert 0 == (await modclient.ts().get(1))[1]
+
+    assert await modclient.ts().incrby(2, 1.5, timestamp=5)
+    assert (5, 1.5) == await modclient.ts().get(2)
+    assert await modclient.ts().incrby(2, 2.25, timestamp=7)
+    assert (7, 3.75) == await modclient.ts().get(2)
+    assert await modclient.ts().decrby(2, 1.5, timestamp=15)
+    assert (15, 2.25) == await modclient.ts().get(2)
+
+    # Test for a chunk size of 128 Bytes on TS.INCRBY
+    assert await modclient.ts().incrby("time-serie-1", 10, chunk_size=128)
+    info = await modclient.ts().info("time-serie-1")
+    assert 128 == info.chunk_size
+
+    # Test for a chunk size of 128 Bytes on TS.DECRBY
+    assert await modclient.ts().decrby("time-serie-2", 10, chunk_size=128)
+    info = await modclient.ts().info("time-serie-2")
+    assert 128 == info.chunk_size
+
+
+@pytest.mark.redismod
+async def test_create_and_delete_rule(modclient: redis.Redis):
+    # test rule creation
+    time = 100
+    await modclient.ts().create(1)
+    await modclient.ts().create(2)
+    await modclient.ts().createrule(1, 2, "avg", 100)
+    for i in range(50):
+        await modclient.ts().add(1, time + i * 2, 1)
+        await modclient.ts().add(1, time + i * 2 + 1, 2)
+    await modclient.ts().add(1, time * 2, 1.5)
+    assert round((await modclient.ts().get(2))[1], 5) == 1.5
+    info = await modclient.ts().info(1)
+    assert info.rules[0][1] == 100
+
+    # test rule deletion
+    await modclient.ts().deleterule(1, 2)
+    info = await modclient.ts().info(1)
+    assert not info.rules
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("99.99.99", "timeseries")
+async def test_del_range(modclient: redis.Redis):
+    try:
+        await modclient.ts().delete("test", 0, 100)
+    except Exception as e:
+        assert e.__str__() != ""
+
+    for i in range(100):
+        await modclient.ts().add(1, i, i % 7)
+    assert 22 == await modclient.ts().delete(1, 0, 21)
+    assert [] == await modclient.ts().range(1, 0, 21)
+    assert [(22, 1.0)] == await modclient.ts().range(1, 22, 22)
+
+
+@pytest.mark.redismod
+async def test_range(modclient: redis.Redis):
+    for i in range(100):
+        await modclient.ts().add(1, i, i % 7)
+    assert 100 == len(await modclient.ts().range(1, 0, 200))
+    for i in range(100):
+        await modclient.ts().add(1, i + 200, i % 7)
+    assert 200 == len(await modclient.ts().range(1, 0, 500))
+    # last sample isn't returned
+    assert 20 == len(
+        await modclient.ts().range(
+            1, 0, 500, aggregation_type="avg", bucket_size_msec=10
+        )
+    )
+    assert 10 == len(await modclient.ts().range(1, 0, 500, count=10))
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("99.99.99", "timeseries")
+async def test_range_advanced(modclient: redis.Redis):
+    for i in range(100):
+        await modclient.ts().add(1, i, i % 7)
+        await modclient.ts().add(1, i + 200, i % 7)
+
+    assert 2 == len(
+        await modclient.ts().range(
+            1,
+            0,
+            500,
+            filter_by_ts=[i for i in range(10, 20)],
+            filter_by_min_value=1,
+            filter_by_max_value=2,
+        )
+    )
+    assert [(0, 10.0), (10, 1.0)] == await modclient.ts().range(
+        1, 0, 10, aggregation_type="count", bucket_size_msec=10, align="+"
+    )
+    assert [(0, 5.0), (5, 6.0)] == await modclient.ts().range(
+        1, 0, 10, aggregation_type="count", bucket_size_msec=10, align=5
+    )
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("99.99.99", "timeseries")
+async def test_rev_range(modclient: redis.Redis):
+    for i in range(100):
+        await modclient.ts().add(1, i, i % 7)
+    assert 100 == len(await modclient.ts().range(1, 0, 200))
+    for i in range(100):
+        await modclient.ts().add(1, i + 200, i % 7)
+    assert 200 == len(await modclient.ts().range(1, 0, 500))
+    # first sample isn't returned
+    assert 20 == len(
+        await modclient.ts().revrange(
+            1, 0, 500, aggregation_type="avg", bucket_size_msec=10
+        )
+    )
+    assert 10 == len(await modclient.ts().revrange(1, 0, 500, count=10))
+    assert 2 == len(
+        await modclient.ts().revrange(
+            1,
+            0,
+            500,
+            filter_by_ts=[i for i in range(10, 20)],
+            filter_by_min_value=1,
+            filter_by_max_value=2,
+        )
+    )
+    assert [(10, 1.0), (0, 10.0)] == await modclient.ts().revrange(
+        1, 0, 10, aggregation_type="count", bucket_size_msec=10, align="+"
+    )
+    assert [(1, 10.0), (0, 1.0)] == await modclient.ts().revrange(
+        1, 0, 10, aggregation_type="count", bucket_size_msec=10, align=1
+    )
+
+
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+async def testMultiRange(modclient: redis.Redis):
+    await modclient.ts().create(1, labels={"Test": "This", "team": "ny"})
+    await modclient.ts().create(
+        2, labels={"Test": "This", "Taste": "That", "team": "sf"}
+    )
+    for i in range(100):
+        await modclient.ts().add(1, i, i % 7)
+        await modclient.ts().add(2, i, i % 11)
+
+    res = await modclient.ts().mrange(0, 200, filters=["Test=This"])
+    assert 2 == len(res)
+    assert 100 == len(res[0]["1"][1])
+
+    res = await modclient.ts().mrange(0, 200, filters=["Test=This"], count=10)
+    assert 10 == len(res[0]["1"][1])
+
+    for i in range(100):
+        await modclient.ts().add(1, i + 200, i % 7)
+    res = await modclient.ts().mrange(
+        0, 500, filters=["Test=This"], aggregation_type="avg", bucket_size_msec=10
+    )
+    assert 2 == len(res)
+    assert 20 == len(res[0]["1"][1])
+
+    # test withlabels
+    assert {} == res[0]["1"][0]
+    res = await modclient.ts().mrange(0, 200, filters=["Test=This"], with_labels=True)
+    assert {"Test": "This", "team": "ny"} == res[0]["1"][0]
+
+
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+@skip_ifmodversion_lt("99.99.99", "timeseries")
+async def test_multi_range_advanced(modclient: redis.Redis):
+    await modclient.ts().create(1, labels={"Test": "This", "team": "ny"})
+    await modclient.ts().create(
+        2, labels={"Test": "This", "Taste": "That", "team": "sf"}
+    )
+    for i in range(100):
+        await modclient.ts().add(1, i, i % 7)
+        await modclient.ts().add(2, i, i % 11)
+
+    # test with selected labels
+    res = await modclient.ts().mrange(
+        0, 200, filters=["Test=This"], select_labels=["team"]
+    )
+    assert {"team": "ny"} == res[0]["1"][0]
+    assert {"team": "sf"} == res[1]["2"][0]
+
+    # test with filterby
+    res = await modclient.ts().mrange(
+        0,
+        200,
+        filters=["Test=This"],
+        filter_by_ts=[i for i in range(10, 20)],
+        filter_by_min_value=1,
+        filter_by_max_value=2,
+    )
+    assert [(15, 1.0), (16, 2.0)] == res[0]["1"][1]
+
+    # test groupby
+    res = await modclient.ts().mrange(
+        0, 3, filters=["Test=This"], groupby="Test", reduce="sum"
+    )
+    assert [(0, 0.0), (1, 2.0), (2, 4.0), (3, 6.0)] == res[0]["Test=This"][1]
+    res = await modclient.ts().mrange(
+        0, 3, filters=["Test=This"], groupby="Test", reduce="max"
+    )
+    assert [(0, 0.0), (1, 1.0), (2, 2.0), (3, 3.0)] == res[0]["Test=This"][1]
+    res = await modclient.ts().mrange(
+        0, 3, filters=["Test=This"], groupby="team", reduce="min"
+    )
+    assert 2 == len(res)
+    assert [(0, 0.0), (1, 1.0), (2, 2.0), (3, 3.0)] == res[0]["team=ny"][1]
+    assert [(0, 0.0), (1, 1.0), (2, 2.0), (3, 3.0)] == res[1]["team=sf"][1]
+
+    # test align
+    res = await modclient.ts().mrange(
+        0,
+        10,
+        filters=["team=ny"],
+        aggregation_type="count",
+        bucket_size_msec=10,
+        align="-",
+    )
+    assert [(0, 10.0), (10, 1.0)] == res[0]["1"][1]
+    res = await modclient.ts().mrange(
+        0,
+        10,
+        filters=["team=ny"],
+        aggregation_type="count",
+        bucket_size_msec=10,
+        align=5,
+    )
+    assert [(0, 5.0), (5, 6.0)] == res[0]["1"][1]
+
+
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+@skip_ifmodversion_lt("99.99.99", "timeseries")
+async def test_multi_reverse_range(modclient: redis.Redis):
+    await modclient.ts().create(1, labels={"Test": "This", "team": "ny"})
+    await modclient.ts().create(
+        2, labels={"Test": "This", "Taste": "That", "team": "sf"}
+    )
+    for i in range(100):
+        await modclient.ts().add(1, i, i % 7)
+        await modclient.ts().add(2, i, i % 11)
+
+    res = await modclient.ts().mrange(0, 200, filters=["Test=This"])
+    assert 2 == len(res)
+    assert 100 == len(res[0]["1"][1])
+
+    res = await modclient.ts().mrange(0, 200, filters=["Test=This"], count=10)
+    assert 10 == len(res[0]["1"][1])
+
+    for i in range(100):
+        await modclient.ts().add(1, i + 200, i % 7)
+    res = await modclient.ts().mrevrange(
+        0, 500, filters=["Test=This"], aggregation_type="avg", bucket_size_msec=10
+    )
+    assert 2 == len(res)
+    assert 20 == len(res[0]["1"][1])
+    assert {} == res[0]["1"][0]
+
+    # test withlabels
+    res = await modclient.ts().mrevrange(
+        0, 200, filters=["Test=This"], with_labels=True
+    )
+    assert {"Test": "This", "team": "ny"} == res[0]["1"][0]
+
+    # test with selected labels
+    res = await modclient.ts().mrevrange(
+        0, 200, filters=["Test=This"], select_labels=["team"]
+    )
+    assert {"team": "ny"} == res[0]["1"][0]
+    assert {"team": "sf"} == res[1]["2"][0]
+
+    # test filterby
+    res = await modclient.ts().mrevrange(
+        0,
+        200,
+        filters=["Test=This"],
+        filter_by_ts=[i for i in range(10, 20)],
+        filter_by_min_value=1,
+        filter_by_max_value=2,
+    )
+    assert [(16, 2.0), (15, 1.0)] == res[0]["1"][1]
+
+    # test groupby
+    res = await modclient.ts().mrevrange(
+        0, 3, filters=["Test=This"], groupby="Test", reduce="sum"
+    )
+    assert [(3, 6.0), (2, 4.0), (1, 2.0), (0, 0.0)] == res[0]["Test=This"][1]
+    res = await modclient.ts().mrevrange(
+        0, 3, filters=["Test=This"], groupby="Test", reduce="max"
+    )
+    assert [(3, 3.0), (2, 2.0), (1, 1.0), (0, 0.0)] == res[0]["Test=This"][1]
+    res = await modclient.ts().mrevrange(
+        0, 3, filters=["Test=This"], groupby="team", reduce="min"
+    )
+    assert 2 == len(res)
+    assert [(3, 3.0), (2, 2.0), (1, 1.0), (0, 0.0)] == res[0]["team=ny"][1]
+    assert [(3, 3.0), (2, 2.0), (1, 1.0), (0, 0.0)] == res[1]["team=sf"][1]
+
+    # test align
+    res = await modclient.ts().mrevrange(
+        0,
+        10,
+        filters=["team=ny"],
+        aggregation_type="count",
+        bucket_size_msec=10,
+        align="-",
+    )
+    assert [(10, 1.0), (0, 10.0)] == res[0]["1"][1]
+    res = await modclient.ts().mrevrange(
+        0,
+        10,
+        filters=["team=ny"],
+        aggregation_type="count",
+        bucket_size_msec=10,
+        align=1,
+    )
+    assert [(1, 10.0), (0, 1.0)] == res[0]["1"][1]
+
+
+@pytest.mark.redismod
+async def test_get(modclient: redis.Redis):
+    name = "test"
+    await modclient.ts().create(name)
+    assert await modclient.ts().get(name) is None
+    await modclient.ts().add(name, 2, 3)
+    assert 2 == (await modclient.ts().get(name))[0]
+    await modclient.ts().add(name, 3, 4)
+    assert 4 == (await modclient.ts().get(name))[1]
+
+
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+async def test_mget(modclient: redis.Redis):
+    await modclient.ts().create(1, labels={"Test": "This"})
+    await modclient.ts().create(2, labels={"Test": "This", "Taste": "That"})
+    act_res = await modclient.ts().mget(["Test=This"])
+    exp_res = [{"1": [{}, None, None]}, {"2": [{}, None, None]}]
+    assert act_res == exp_res
+    await modclient.ts().add(1, "*", 15)
+    await modclient.ts().add(2, "*", 25)
+    res = await modclient.ts().mget(["Test=This"])
+    assert 15 == res[0]["1"][2]
+    assert 25 == res[1]["2"][2]
+    res = await modclient.ts().mget(["Taste=That"])
+    assert 25 == res[0]["2"][2]
+
+    # test with_labels
+    assert {} == res[0]["2"][0]
+    res = await modclient.ts().mget(["Taste=That"], with_labels=True)
+    assert {"Taste": "That", "Test": "This"} == res[0]["2"][0]
+
+
+@pytest.mark.redismod
+async def test_info(modclient: redis.Redis):
+    await modclient.ts().create(
+        1, retention_msecs=5, labels={"currentLabel": "currentData"}
+    )
+    info = await modclient.ts().info(1)
+    assert 5 == info.retention_msecs
+    assert info.labels["currentLabel"] == "currentData"
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("1.4.0", "timeseries")
+async def testInfoDuplicatePolicy(modclient: redis.Redis):
+    await modclient.ts().create(
+        1, retention_msecs=5, labels={"currentLabel": "currentData"}
+    )
+    info = await modclient.ts().info(1)
+    assert info.duplicate_policy is None
+
+    await modclient.ts().create("time-serie-2", duplicate_policy="min")
+    info = await modclient.ts().info("time-serie-2")
+    assert "min" == info.duplicate_policy
+
+
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+async def test_query_index(modclient: redis.Redis):
+    await modclient.ts().create(1, labels={"Test": "This"})
+    await modclient.ts().create(2, labels={"Test": "This", "Taste": "That"})
+    assert 2 == len(await modclient.ts().queryindex(["Test=This"]))
+    assert 1 == len(await modclient.ts().queryindex(["Taste=That"]))
+    assert [2] == await modclient.ts().queryindex(["Taste=That"])
+
+
+# @pytest.mark.redismod
+# async def test_pipeline(modclient: redis.Redis):
+#     pipeline = await modclient.ts().pipeline()
+#     pipeline.create("with_pipeline")
+#     for i in range(100):
+#         pipeline.add("with_pipeline", i, 1.1 * i)
+#     pipeline.execute()
+
+#     info = await modclient.ts().info("with_pipeline")
+#     assert info.lastTimeStamp == 99
+#     assert info.total_samples == 100
+#     assert await modclient.ts().get("with_pipeline")[1] == 99 * 1.1
+
+
+@pytest.mark.redismod
+async def test_uncompressed(modclient: redis.Redis):
+    await modclient.ts().create("compressed")
+    await modclient.ts().create("uncompressed", uncompressed=True)
+    compressed_info = await modclient.ts().info("compressed")
+    uncompressed_info = await modclient.ts().info("uncompressed")
+    assert compressed_info.memory_usage != uncompressed_info.memory_usage
diff --git a/tox.ini b/tox.ini
index 9ea8706f32..a880da45a5 100644
--- a/tox.ini
+++ b/tox.ini
@@ -6,9 +6,9 @@ markers =
     onlycluster: marks tests to be run only with cluster mode redis
     onlynoncluster: marks tests to be run only with standalone redis
     ssl: marker for only the ssl tests
+    asyncio: marker for async tests
     replica: replica tests
     experimental: run only experimental tests
-    asyncio: marker for async tests
 
 [tox]
 minversion = 3.2.0

From 805b1842dbf7a732bad484e418dd7da4ec6ab890 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 13 Apr 2022 13:41:28 +0300
Subject: [PATCH 0461/1164] Adding (experimental) python 3.11 CI (#1991)

---
 .github/workflows/integration.yaml  | 20 ++++++++++++++++----
 .github/workflows/pypi-publish.yaml |  2 +-
 setup.py                            |  1 +
 3 files changed, 18 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 74b25d6b27..53e6777082 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -22,7 +22,7 @@ jobs:
      steps:
        - uses: actions/checkout@v2
        - name: install python
-         uses: actions/setup-python@v2
+         uses: actions/setup-python@v3
          with:
            python-version: 3.9
        - name: run code linters
@@ -32,6 +32,7 @@ jobs:
 
    run-tests:
      runs-on: ubuntu-latest
+     continue-on-error: ${{ matrix.experimental }}
      timeout-minutes: 30
      strategy:
        max-parallel: 15
@@ -39,13 +40,19 @@ jobs:
          python-version: ['3.6', '3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
          test-type: ['standalone', 'cluster']
          connection-type: ['hiredis', 'plain']
+         experimental: [false]
+         include:
+           - python-version: 3.11.0-alpha.6
+             experimental: true
+             test-type: standalone
+             connection-type: plain
      env:
        ACTIONS_ALLOW_UNSECURE_COMMANDS: true
      name: Python ${{ matrix.python-version }} ${{matrix.test-type}}-${{matrix.connection-type}} tests
      steps:
        - uses: actions/checkout@v2
        - name: install python
-         uses: actions/setup-python@v2
+         uses: actions/setup-python@v3
          with:
            python-version: ${{ matrix.python-version }}
        - name: run tests
@@ -68,7 +75,7 @@ jobs:
     steps:
       - uses: actions/checkout@v2
       - name: install python
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v3
         with:
           python-version: 3.9
       - name: Run installed unit tests
@@ -76,15 +83,20 @@ jobs:
           bash .github/workflows/install_and_test.sh ${{ matrix.extension }}
 
    install_package_from_commit:
+    continue-on-error: ${{ matrix.experimental }}
     name: Install package from commit hash
     runs-on: ubuntu-latest
     strategy:
       matrix:
         python-version: ['3.6', '3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
+        experimental: [false]
+        include:
+          - python-version: 3.11.0-alpha.5
+          - experimental: true
     steps:
       - uses: actions/checkout@v2
       - name: install python ${{ matrix.python-version }}
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v3
         with:
           python-version: ${{ matrix.python-version }}
       - name: install from pip
diff --git a/.github/workflows/pypi-publish.yaml b/.github/workflows/pypi-publish.yaml
index 3cccb067ac..0d100dd12d 100644
--- a/.github/workflows/pypi-publish.yaml
+++ b/.github/workflows/pypi-publish.yaml
@@ -11,7 +11,7 @@ jobs:
     steps:
       - uses: actions/checkout@v2
       - name: install python
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v3
         with:
           python-version: 3.9
       - name: Install dev tools
diff --git a/setup.py b/setup.py
index 423117bb50..ebb71f8ef2 100644
--- a/setup.py
+++ b/setup.py
@@ -52,6 +52,7 @@
         "Programming Language :: Python :: 3.8",
         "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
         "Programming Language :: Python :: Implementation :: CPython",
         "Programming Language :: Python :: Implementation :: PyPy",
     ],

From e5e265de87dfe7ef8cc5cad8c247d067c74fa44d Mon Sep 17 00:00:00 2001
From: Andrew Chen Wang <60190294+Andrew-Chen-Wang@users.noreply.github.com>
Date: Mon, 18 Apr 2022 04:35:59 -0400
Subject: [PATCH 0462/1164] Fix typing in getex command (#2088)

---
 redis/commands/core.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 606256a33c..d1d465d7a8 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -256,7 +256,7 @@ def acl_setuser(
         For more information see https://redis.io/commands/acl-setuser
         """
         encoder = self.get_encoder()
-        pieces: list[str | bytes] = [username]
+        pieces: List[EncodableT] = [username]
 
         if reset:
             pieces.append(b"reset")

From 6ba46418236718d95f9dee09adaa8a42a4d5c23b Mon Sep 17 00:00:00 2001
From: Avital Fine <98389525+Avital-Fine@users.noreply.github.com>
Date: Mon, 25 Apr 2022 15:39:37 +0300
Subject: [PATCH 0463/1164] Support CASESENSITIVE for TAG fields (#2112)

* Support CASESENSITIVE for TAG fields

* add wait fot index + update all the callings to use getattr() instead of the string "idx"
---
 redis/commands/search/field.py | 17 +++++++++---
 tests/test_search.py           | 47 ++++++++++++++++++++++++++--------
 2 files changed, 49 insertions(+), 15 deletions(-)

diff --git a/redis/commands/search/field.py b/redis/commands/search/field.py
index da6667df88..14328e9d3b 100644
--- a/redis/commands/search/field.py
+++ b/redis/commands/search/field.py
@@ -105,11 +105,20 @@ class TagField(Field):
     """
 
     SEPARATOR = "SEPARATOR"
+    CASESENSITIVE = "CASESENSITIVE"
 
-    def __init__(self, name: str, separator: str = ",", **kwargs):
-        Field.__init__(
-            self, name, args=[Field.TAG, self.SEPARATOR, separator], **kwargs
-        )
+    def __init__(
+        self,
+        name: str,
+        separator: str = ",",
+        case_sensitive: bool = False,
+        **kwargs,
+    ):
+        args = [Field.TAG, self.SEPARATOR, separator]
+        if case_sensitive:
+            args.append(self.CASESENSITIVE)
+
+        Field.__init__(self, name, args=args, **kwargs)
 
 
 class VectorField(Field):
diff --git a/tests/test_search.py b/tests/test_search.py
index 343ac0d540..aee37cdd6f 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -107,7 +107,7 @@ def client(modclient):
 def test_client(client):
     num_docs = 500
     createIndex(client.ft(), num_docs=num_docs)
-    waitForIndex(client, "idx")
+    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
     # verify info
     info = client.ft().info()
     for k in [
@@ -252,7 +252,7 @@ def test_replace(client):
 
     client.ft().add_document("doc1", txt="foo bar")
     client.ft().add_document("doc2", txt="foo bar")
-    waitForIndex(client, "idx")
+    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
     res = client.ft().search("foo bar")
     assert 2 == res.total
@@ -272,7 +272,7 @@ def test_stopwords(client):
     client.ft().create_index((TextField("txt"),), stopwords=["foo", "bar", "baz"])
     client.ft().add_document("doc1", txt="foo bar")
     client.ft().add_document("doc2", txt="hello world")
-    waitForIndex(client, "idx")
+    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
     q1 = Query("foo bar").no_content()
     q2 = Query("foo bar hello world").no_content()
@@ -287,7 +287,7 @@ def test_filters(client):
     client.ft().add_document("doc1", txt="foo bar", num=3.141, loc="-0.441,51.458")
     client.ft().add_document("doc2", txt="foo baz", num=2, loc="-0.1,51.2")
 
-    waitForIndex(client, "idx")
+    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
     # Test numerical filter
     q1 = Query("foo").add_filter(NumericFilter("num", 0, 2)).no_content()
     q2 = (
@@ -456,7 +456,7 @@ def test_no_index(client):
     client.ft().add_document(
         "doc2", field="aab", text="2", numeric="2", geo="2,2", tag="2"
     )
-    waitForIndex(client, "idx")
+    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
     res = client.ft().search(Query("@text:aa*"))
     assert 0 == res.total
@@ -498,7 +498,7 @@ def test_partial(client):
     client.ft().add_document("doc2", f1="f1_val", f2="f2_val")
     client.ft().add_document("doc1", f3="f3_val", partial=True)
     client.ft().add_document("doc2", f3="f3_val", replace=True)
-    waitForIndex(client, "idx")
+    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
     # Search for f3 value. All documents should have it
     res = client.ft().search("@f3:f3_val")
@@ -516,7 +516,7 @@ def test_no_create(client):
     client.ft().add_document("doc2", f1="f1_val", f2="f2_val")
     client.ft().add_document("doc1", f3="f3_val", no_create=True)
     client.ft().add_document("doc2", f3="f3_val", no_create=True, partial=True)
-    waitForIndex(client, "idx")
+    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
     # Search for f3 value. All documents should have it
     res = client.ft().search("@f3:f3_val")
@@ -546,7 +546,7 @@ def test_explaincli(client):
 @pytest.mark.redismod
 def test_summarize(client):
     createIndex(client.ft())
-    waitForIndex(client, "idx")
+    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
     q = Query("king henry").paging(0, 1)
     q.highlight(fields=("play", "txt"), tags=("<b>", "</b>"))
@@ -654,7 +654,7 @@ def test_tags(client):
 
     client.ft().add_document("doc1", txt="fooz barz", tags=tags)
     client.ft().add_document("doc2", txt="noodles", tags=tags2)
-    waitForIndex(client, "idx")
+    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
     q = Query("@tags:{foo}")
     res = client.ft().search(q)
@@ -714,7 +714,7 @@ def test_spell_check(client):
 
     client.ft().add_document("doc1", f1="some valid content", f2="this is sample text")
     client.ft().add_document("doc2", f1="very important", f2="lorem ipsum")
-    waitForIndex(client, "idx")
+    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
     # test spellcheck
     res = client.ft().spellcheck("impornant")
@@ -1304,6 +1304,31 @@ def test_fields_as_name(client):
     assert "25" == total[0].just_a_number
 
 
+@pytest.mark.redismod
+def test_casesensitive(client):
+    # create index
+    SCHEMA = (TagField("t", case_sensitive=False),)
+    client.ft().create_index(SCHEMA)
+    client.ft().client.hset("1", "t", "HELLO")
+    client.ft().client.hset("2", "t", "hello")
+
+    res = client.ft().search("@t:{HELLO}").docs
+
+    assert 2 == len(res)
+    assert "1" == res[0].id
+    assert "2" == res[1].id
+
+    # create casesensitive index
+    client.ft().dropindex()
+    SCHEMA = (TagField("t", case_sensitive=True),)
+    client.ft().create_index(SCHEMA)
+    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
+
+    res = client.ft().search("@t:{HELLO}").docs
+    assert 1 == len(res)
+    assert "1" == res[0].id
+
+
 @pytest.mark.redismod
 @skip_ifmodversion_lt("2.2.0", "search")
 def test_search_return_fields(client):
@@ -1321,7 +1346,7 @@ def test_search_return_fields(client):
         NumericField("$.flt"),
     )
     client.ft().create_index(SCHEMA, definition=definition)
-    waitForIndex(client, "idx")
+    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
     total = client.ft().search(Query("*").return_field("$.t", as_field="txt")).docs
     assert 1 == len(total)

From 683270557101cbfe26cad3eb4f187b7f8c218223 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 27 Apr 2022 16:21:29 +0300
Subject: [PATCH 0464/1164] Update FUNCTION LOAD changes (#2139)

---
 redis/client.py        |  1 -
 redis/commands/core.py | 20 ++++---------
 tests/test_function.py | 67 ++++++++++++++++++++++++------------------
 3 files changed, 44 insertions(+), 44 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index d8d7a75ce0..e44f5abeb2 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -760,7 +760,6 @@ class AbstractRedis:
         "DEBUG OBJECT": parse_debug_object,
         "FUNCTION DELETE": bool_ok,
         "FUNCTION FLUSH": bool_ok,
-        "FUNCTION LOAD": bool_ok,
         "FUNCTION RESTORE": bool_ok,
         "GEOHASH": lambda r: list(map(str_if_bytes, r)),
         "GEOPOS": lambda r: list(
diff --git a/redis/commands/core.py b/redis/commands/core.py
index d1d465d7a8..8aa2dce629 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -5703,28 +5703,20 @@ class FunctionCommands:
 
     def function_load(
         self,
-        engine: str,
-        library: str,
         code: str,
         replace: Optional[bool] = False,
-        description: Optional[str] = None,
     ) -> Union[Awaitable[str], str]:
         """
         Load a library to Redis.
-        :param engine: the name of the execution engine for the library
-        :param library: the unique name of the library
-        :param code: the source code
-        :param replace: changes the behavior to replace the library if a library called
-         ``library`` already exists
-        :param description: description to the library
+        :param code: the source code (must start with
+        Shebang statement that provides a metadata about the library)
+        :param replace: changes the behavior to overwrite the existing library
+        with the new contents.
+        Return the library name that was loaded.
 
         For more information see https://redis.io/commands/function-load
         """
-        pieces = [engine, library]
-        if replace:
-            pieces.append("REPLACE")
-        if description is not None:
-            pieces.append(description)
+        pieces = ["REPLACE"] if replace else []
         pieces.append(code)
         return self.execute_command("FUNCTION LOAD", *pieces)
 
diff --git a/tests/test_function.py b/tests/test_function.py
index 6f0a6ec1e1..e6c4bcd586 100644
--- a/tests/test_function.py
+++ b/tests/test_function.py
@@ -4,12 +4,16 @@
 
 from .conftest import skip_if_server_version_lt
 
-function = "redis.register_function('myfunc', function(keys, args) return args[1] end)"
+engine = "lua"
+lib = "mylib"
+lib2 = "mylib2"
+function = "redis.register_function{function_name='myfunc', callback=function(keys, \
+            args) return args[1] end, flags={ 'no-writes' }}"
 function2 = "redis.register_function('hello', function() return 'Hello World' end)"
-set_function = "redis.register_function('set', function(keys, args) \
-                return redis.call('SET', keys[1], args[1]) end)"
-get_function = "redis.register_function('get', function(keys, args) \
-                return redis.call('GET', keys[1]) end)"
+set_function = "redis.register_function('set', function(keys, args) return \
+                redis.call('SET', keys[1], args[1]) end)"
+get_function = "redis.register_function('get', function(keys, args) return \
+                redis.call('GET', keys[1]) end)"
 
 
 @skip_if_server_version_lt("7.0.0")
@@ -19,25 +23,28 @@ def reset_functions(self, r):
         r.function_flush()
 
     def test_function_load(self, r):
-        assert r.function_load("Lua", "mylib", function)
-        assert r.function_load("Lua", "mylib", function, replace=True)
+        print("!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!")
+        assert lib == r.function_load(f"#!{engine} name={lib} \n {function}")
+        assert lib == r.function_load(
+            f"#!{engine} name={lib} \n {function}", replace=True
+        )
         with pytest.raises(ResponseError):
-            r.function_load("Lua", "mylib", function)
+            r.function_load(f"#!{engine} name={lib} \n {function}")
         with pytest.raises(ResponseError):
-            r.function_load("Lua", "mylib2", function)
+            r.function_load(f"#!{engine} name={lib2} \n {function}")
 
     def test_function_delete(self, r):
-        r.function_load("Lua", "mylib", set_function)
+        r.function_load(f"#!{engine} name={lib} \n {set_function}")
         with pytest.raises(ResponseError):
-            r.function_load("Lua", "mylib", set_function)
+            r.function_load(f"#!{engine} name={lib} \n {set_function}")
         assert r.fcall("set", 1, "foo", "bar") == "OK"
         assert r.function_delete("mylib")
         with pytest.raises(ResponseError):
             r.fcall("set", 1, "foo", "bar")
-        assert r.function_load("Lua", "mylib", set_function)
+        assert lib == r.function_load(f"#!{engine} name={lib} \n {set_function}")
 
     def test_function_flush(self, r):
-        r.function_load("Lua", "mylib", function)
+        r.function_load(f"#!{engine} name={lib} \n {function}")
         assert r.fcall("myfunc", 0, "hello") == "hello"
         assert r.function_flush()
         with pytest.raises(ResponseError):
@@ -47,36 +54,35 @@ def test_function_flush(self, r):
 
     @pytest.mark.onlynoncluster
     def test_function_list(self, r):
-        r.function_load("Lua", "mylib", function)
+        r.function_load(f"#!{engine} name={lib} \n {function}")
         res = [
             [
                 "library_name",
                 "mylib",
                 "engine",
                 "LUA",
-                "description",
-                None,
                 "functions",
-                [["name", "myfunc", "description", None]],
+                [["name", "myfunc", "description", None, "flags", ["no-writes"]]],
             ],
         ]
         assert r.function_list() == res
         assert r.function_list(library="*lib") == res
-        assert r.function_list(withcode=True)[0][9] == function
+        assert (
+            r.function_list(withcode=True)[0][7]
+            == f"#!{engine} name={lib} \n {function}"
+        )
 
     @pytest.mark.onlycluster
     def test_function_list_on_cluster(self, r):
-        r.function_load("Lua", "mylib", function)
+        r.function_load(f"#!{engine} name={lib} \n {function}")
         function_list = [
             [
                 "library_name",
                 "mylib",
                 "engine",
                 "LUA",
-                "description",
-                None,
                 "functions",
-                [["name", "myfunc", "description", None]],
+                [["name", "myfunc", "description", None, "flags", ["no-writes"]]],
             ],
         ]
         primaries = r.get_primaries()
@@ -86,25 +92,28 @@ def test_function_list_on_cluster(self, r):
         assert r.function_list() == res
         assert r.function_list(library="*lib") == res
         node = primaries[0].name
-        assert r.function_list(withcode=True)[node][0][9] == function
+        assert (
+            r.function_list(withcode=True)[node][0][7]
+            == f"#!{engine} name={lib} \n {function}"
+        )
 
     def test_fcall(self, r):
-        r.function_load("Lua", "mylib", set_function)
-        r.function_load("Lua", "mylib2", get_function)
+        r.function_load(f"#!{engine} name={lib} \n {set_function}")
+        r.function_load(f"#!{engine} name={lib2} \n {get_function}")
         assert r.fcall("set", 1, "foo", "bar") == "OK"
         assert r.fcall("get", 1, "foo") == "bar"
         with pytest.raises(ResponseError):
             r.fcall("myfunc", 0, "hello")
 
     def test_fcall_ro(self, r):
-        r.function_load("Lua", "mylib", function)
+        r.function_load(f"#!{engine} name={lib} \n {function}")
         assert r.fcall_ro("myfunc", 0, "hello") == "hello"
-        r.function_load("Lua", "mylib2", set_function)
+        r.function_load(f"#!{engine} name={lib2} \n {set_function}")
         with pytest.raises(ResponseError):
             r.fcall_ro("set", 1, "foo", "bar")
 
     def test_function_dump_restore(self, r):
-        r.function_load("Lua", "mylib", set_function)
+        r.function_load(f"#!{engine} name={lib} \n {set_function}")
         payload = r.function_dump()
         assert r.fcall("set", 1, "foo", "bar") == "OK"
         r.function_delete("mylib")
@@ -112,7 +121,7 @@ def test_function_dump_restore(self, r):
             r.fcall("set", 1, "foo", "bar")
         assert r.function_restore(payload)
         assert r.fcall("set", 1, "foo", "bar") == "OK"
-        r.function_load("Lua", "mylib2", get_function)
+        r.function_load(f"#!{engine} name={lib2} \n {get_function}")
         assert r.fcall("get", 1, "foo") == "bar"
         r.function_delete("mylib")
         assert r.function_restore(payload, "FLUSH")

From 2da2ac3368bc88ad909d78fe73029bc9c627545d Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 27 Apr 2022 16:22:05 +0300
Subject: [PATCH 0465/1164] Add support for COMMAND GETKEYSANDFLAGS (#2141)

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/commands/core.py | 8 ++++++++
 tests/test_commands.py | 9 +++++++++
 2 files changed, 17 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 8aa2dce629..db48b46f7c 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -743,6 +743,14 @@ def command_info(self, **kwargs) -> None:
     def command_count(self, **kwargs) -> ResponseT:
         return self.execute_command("COMMAND COUNT", **kwargs)
 
+    def command_getkeysandflags(self, *args: List[str]) -> List[Union[str, List[str]]]:
+        """
+        Returns array of keys from a full Redis command and their usage flags.
+
+        For more information see https://redis.io/commands/command-getkeysandflags
+        """
+        return self.execute_command("COMMAND GETKEYSANDFLAGS", *args)
+
     def command_docs(self, *args):
         """
         This function throws a NotImplementedError since it is intentionally
diff --git a/tests/test_commands.py b/tests/test_commands.py
index de94539b82..f83bb7996d 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -4468,6 +4468,15 @@ def test_command(self, r):
         assert "set" in cmds
         assert "get" in cmds
 
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("7.0.0")
+    @skip_if_redis_enterprise()
+    def test_command_getkeysandflags(self, r: redis.Redis):
+        res = [["mylist1", ["RW", "access", "delete"]], ["mylist2", ["RW", "insert"]]]
+        assert res == r.command_getkeysandflags(
+            "LMOVE", "mylist1", "mylist2", "left", "left"
+        )
+
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("4.0.0")
     @skip_if_redis_enterprise()

From 2d8b90139710240d172e16f1a60b2cd847a0802c Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 27 Apr 2022 16:22:38 +0300
Subject: [PATCH 0466/1164] support get multi parameters (#2142)

---
 redis/commands/core.py | 6 ++++--
 tests/test_commands.py | 6 ++++++
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index db48b46f7c..83b97d781b 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -760,13 +760,15 @@ def command_docs(self, *args):
             "COMMAND DOCS is intentionally not implemented in the client."
         )
 
-    def config_get(self, pattern: PatternT = "*", **kwargs) -> ResponseT:
+    def config_get(
+        self, pattern: PatternT = "*", *args: List[PatternT], **kwargs
+    ) -> ResponseT:
         """
         Return a dictionary of configuration based on the ``pattern``
 
         For more information see https://redis.io/commands/config-get
         """
-        return self.execute_command("CONFIG GET", pattern, **kwargs)
+        return self.execute_command("CONFIG GET", pattern, *args, **kwargs)
 
     def config_set(self, name: KeyT, value: EncodableT, **kwargs) -> ResponseT:
         """Set config item ``name`` with ``value``
diff --git a/tests/test_commands.py b/tests/test_commands.py
index f83bb7996d..57182fc3de 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -669,6 +669,12 @@ def test_config_get(self, r):
         # # assert 'maxmemory' in data
         # assert data['maxmemory'].isdigit()
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_config_get_multi_params(self, r: redis.Redis):
+        res = r.config_get("*max-*-entries*", "maxmemory")
+        assert "maxmemory" in res
+        assert "hash-max-listpack-entries" in res
+
     @pytest.mark.onlynoncluster
     @skip_if_redis_enterprise()
     def test_config_resetstat(self, r):

From c198612a3ed67d78d7964b0253e96b3fa1d7d707 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 27 Apr 2022 16:23:11 +0300
Subject: [PATCH 0467/1164] support set multi parameters (#2143)

---
 redis/commands/core.py | 10 ++++++++--
 tests/test_commands.py | 10 ++++++++++
 2 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 83b97d781b..1d0be8afd6 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -770,12 +770,18 @@ def config_get(
         """
         return self.execute_command("CONFIG GET", pattern, *args, **kwargs)
 
-    def config_set(self, name: KeyT, value: EncodableT, **kwargs) -> ResponseT:
+    def config_set(
+        self,
+        name: KeyT,
+        value: EncodableT,
+        *args: List[Union[KeyT, EncodableT]],
+        **kwargs,
+    ) -> ResponseT:
         """Set config item ``name`` with ``value``
 
         For more information see https://redis.io/commands/config-set
         """
-        return self.execute_command("CONFIG SET", name, value, **kwargs)
+        return self.execute_command("CONFIG SET", name, value, *args, **kwargs)
 
     def config_resetstat(self, **kwargs) -> ResponseT:
         """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 57182fc3de..aa29e6f7cf 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -692,6 +692,16 @@ def test_config_set(self, r):
         assert r.config_set("timeout", 0)
         assert r.config_get()["timeout"] == "0"
 
+    @skip_if_server_version_lt("7.0.0")
+    @skip_if_redis_enterprise()
+    def test_config_set_multi_params(self, r: redis.Redis):
+        r.config_set("timeout", 70, "maxmemory", 100)
+        assert r.config_get()["timeout"] == "70"
+        assert r.config_get()["maxmemory"] == "100"
+        assert r.config_set("timeout", 0, "maxmemory", 0)
+        assert r.config_get()["timeout"] == "0"
+        assert r.config_get()["maxmemory"] == "0"
+
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise()
     def test_failover(self, r):

From a696fe5e3155238fd8e9ec65224f94f6f25bb72b Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 27 Apr 2022 16:23:43 +0300
Subject: [PATCH 0468/1164] INFO - add support for taking multiple section
 arguments (#2145)

* add support for taking multiple section arguments

* skip test
---
 redis/commands/core.py | 6 ++++--
 tests/test_commands.py | 8 ++++++++
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 1d0be8afd6..e6ab0095c8 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -900,7 +900,9 @@ def select(self, index: int, **kwargs) -> ResponseT:
         """
         return self.execute_command("SELECT", index, **kwargs)
 
-    def info(self, section: Union[str, None] = None, **kwargs) -> ResponseT:
+    def info(
+        self, section: Union[str, None] = None, *args: List[str], **kwargs
+    ) -> ResponseT:
         """
         Returns a dictionary containing information about the Redis server
 
@@ -915,7 +917,7 @@ def info(self, section: Union[str, None] = None, **kwargs) -> ResponseT:
         if section is None:
             return self.execute_command("INFO", **kwargs)
         else:
-            return self.execute_command("INFO", section, **kwargs)
+            return self.execute_command("INFO", section, *args, **kwargs)
 
     def lastsave(self, **kwargs) -> ResponseT:
         """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index aa29e6f7cf..05a90f293c 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -727,6 +727,14 @@ def test_info(self, r):
         assert "arch_bits" in info.keys()
         assert "redis_version" in info.keys()
 
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("7.0.0")
+    def test_info_multi_sections(self, r):
+        res = r.info("clients", "server")
+        assert isinstance(res, dict)
+        assert "redis_version" in res
+        assert "connected_clients" in res
+
     @pytest.mark.onlynoncluster
     @skip_if_redis_enterprise()
     def test_lastsave(self, r):

From 1f046ac23502521dad280a49ff31263b2e92f4b3 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 27 Apr 2022 16:24:00 +0300
Subject: [PATCH 0469/1164] Add support for MODULE LOADEX (#2146)

---
 redis/commands/core.py | 21 +++++++++++++++++++++
 tests/test_commands.py | 12 ++++++++++++
 2 files changed, 33 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index e6ab0095c8..fd6ad46c0d 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -5592,6 +5592,27 @@ def module_load(self, path, *args) -> ResponseT:
         """
         return self.execute_command("MODULE LOAD", path, *args)
 
+    def module_loadex(
+        self,
+        path: str,
+        options: Optional[List[str]] = None,
+        args: Optional[List[str]] = None,
+    ) -> ResponseT:
+        """
+        Loads a module from a dynamic library at runtime with configuration directives.
+
+        For more information see https://redis.io/commands/module-loadex
+        """
+        pieces = []
+        if options is not None:
+            pieces.append("CONFIG")
+            pieces.extend(options)
+        if args is not None:
+            pieces.append("ARGS")
+            pieces.extend(args)
+
+        return self.execute_command("MODULE LOADEX", path, *pieces)
+
     def module_unload(self, name) -> ResponseT:
         """
         Unloads the module ``name``.
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 05a90f293c..64fd87c095 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -4513,6 +4513,18 @@ def test_module(self, r):
             r.module_load("/some/fake/path", "arg1", "arg2", "arg3", "arg4")
             assert "Error loading the extension." in str(excinfo.value)
 
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("7.0.0")
+    @skip_if_redis_enterprise()
+    def test_module_loadex(self, r: redis.Redis):
+        with pytest.raises(redis.exceptions.ModuleError) as excinfo:
+            r.module_loadex("/some/fake/path")
+            assert "Error loading the extension." in str(excinfo.value)
+
+        with pytest.raises(redis.exceptions.ModuleError) as excinfo:
+            r.module_loadex("/some/fake/path", ["name", "value"], ["arg1", "arg2"])
+            assert "Error loading the extension." in str(excinfo.value)
+
     @skip_if_server_version_lt("2.6.0")
     def test_restore(self, r):
 

From cfebc0fa9c4f7e4ef141729959cd149861cfd706 Mon Sep 17 00:00:00 2001
From: Kamyab Taghizadeh <kamyab.zad@gmail.com>
Date: Thu, 28 Apr 2022 04:06:05 +0430
Subject: [PATCH 0470/1164] Fix incorrect return statement in auth (#2086)
 (#2092)

---
 CHANGES                |  1 +
 redis/commands/core.py |  8 +++++---
 tests/test_commands.py | 14 ++++++++++++++
 3 files changed, 20 insertions(+), 3 deletions(-)

diff --git a/CHANGES b/CHANGES
index 010612f756..9ca62f022a 100644
--- a/CHANGES
+++ b/CHANGES
@@ -7,6 +7,7 @@
     * Fix scan_iter for RedisCluster
     * Remove verbose logging when initializing ClusterPubSub, ClusterPipeline or RedisCluster
     * Fix broken connection writer lock-up for asyncio (#2065)
+    * Fix auth bug when provided with no username (#2086)
 
 * 4.1.3 (Feb 8, 2022)
     * Fix flushdb and flushall (#1926)
diff --git a/redis/commands/core.py b/redis/commands/core.py
index fd6ad46c0d..30102ebc52 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -376,9 +376,11 @@ def auth(self, password, username=None, **kwargs):
         authenticate for the given user.
         For more information see https://redis.io/commands/auth
         """
-        if username:
-            return self.execute_command("AUTH", username, password, **kwargs)
-        return self.execute_command
+        pieces = []
+        if username is not None:
+            pieces.append(username)
+        pieces.append(password)
+        return self.execute_command("AUTH", *pieces, **kwargs)
 
     def bgrewriteaof(self, **kwargs):
         """Tell the Redis server to rewrite the AOF file from data in memory.
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 64fd87c095..c8edd5774c 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -67,9 +67,23 @@ def test_case_insensitive_command_names(self, r):
 class TestRedisCommands:
     @skip_if_redis_enterprise()
     def test_auth(self, r, request):
+        # first, test for default user (`username` is supposed to be optional)
+        default_username = "default"
+        temp_pass = "temp_pass"
+        r.config_set("requirepass", temp_pass)
+
+        assert r.auth(temp_pass, default_username) is True
+        assert r.auth(temp_pass) is True
+
+        # test for other users
         username = "redis-py-auth"
 
         def teardown():
+            try:
+                r.auth(temp_pass)
+            except exceptions.ResponseError:
+                r.auth("default", "")
+            r.config_set("requirepass", "")
             r.acl_deluser(username)
 
         request.addfinalizer(teardown)

From 9e7e9733de7db3c68bdfd142ff94c63f27bf6bdf Mon Sep 17 00:00:00 2001
From: Rich Li <richli@users.noreply.github.com>
Date: Wed, 27 Apr 2022 16:38:56 -0700
Subject: [PATCH 0471/1164] Update xtrim type annotation (#2093)

---
 redis/commands/core.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 30102ebc52..b52ddfeca4 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3819,7 +3819,7 @@ def xrevrange(
     def xtrim(
         self,
         name: KeyT,
-        maxlen: int,
+        maxlen: Union[int, None],
         approximate: bool = True,
         minid: Union[StreamIdT, None] = None,
         limit: Union[int, None] = None,

From abd5aeffc5cca02826973ab32e4d43e200eff18e Mon Sep 17 00:00:00 2001
From: suxb201 <suxb201@gmail.com>
Date: Thu, 28 Apr 2022 14:17:31 +0800
Subject: [PATCH 0472/1164] fix execute_command() determine nodes error when no
 key command (#2097)

---
 redis/cluster.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index 221df856c1..bf7ac2049b 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -867,7 +867,10 @@ def set_response_callback(self, command, callback):
         self.cluster_response_callbacks[command] = callback
 
     def _determine_nodes(self, *args, **kwargs):
-        command = args[0]
+        command = args[0].upper()
+        if len(args) >= 2 and f"{args[0]} {args[1]}".upper() in self.command_flags:
+            command = f"{args[0]} {args[1]}".upper()
+
         nodes_flag = kwargs.pop("nodes_flag", None)
         if nodes_flag is not None:
             # nodes flag passed by the user

From c29d158c854c659994b6d8704d4b420faaa95bca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Thu, 28 Apr 2022 11:16:14 +0000
Subject: [PATCH 0473/1164] `Retry()`: Support negative `retries` value (#2110)

* Support negative `retries` value

* Add unit test

* Add unittest for blocking api
---
 CHANGES                          |  1 +
 redis/asyncio/retry.py           |  3 ++-
 redis/retry.py                   |  3 ++-
 tests/test_asyncio/test_retry.py | 16 ++++++++++++++++
 tests/test_retry.py              | 15 +++++++++++++++
 5 files changed, 36 insertions(+), 2 deletions(-)

diff --git a/CHANGES b/CHANGES
index 9ca62f022a..f954a07777 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,4 +1,5 @@
 
+    * Allow negative `retries` for `Retry` class to retry forever
     * Add `items` parameter to `hset` signature
     * Create codeql-analysis.yml (#1988). Thanks @chayim
     * Add limited support for Lua scripting with RedisCluster
diff --git a/redis/asyncio/retry.py b/redis/asyncio/retry.py
index 284eacc7ff..0934ad0d9f 100644
--- a/redis/asyncio/retry.py
+++ b/redis/asyncio/retry.py
@@ -27,6 +27,7 @@ def __init__(
         """
         Initialize a `Retry` object with a `Backoff` object
         that retries a maximum of `retries` times.
+        `retries` can be negative to retry forever.
         You can specify the types of supported errors which trigger
         a retry with the `supported_errors` parameter.
         """
@@ -51,7 +52,7 @@ async def call_with_retry(
             except self._supported_errors as error:
                 failures += 1
                 await fail(error)
-                if failures > self._retries:
+                if self._retries >= 0 and failures > self._retries:
                     raise error
                 backoff = self._backoff.compute(failures)
                 if backoff > 0:
diff --git a/redis/retry.py b/redis/retry.py
index 3dced35d24..57be971b4f 100644
--- a/redis/retry.py
+++ b/redis/retry.py
@@ -16,6 +16,7 @@ def __init__(
         """
         Initialize a `Retry` object with a `Backoff` object
         that retries a maximum of `retries` times.
+        `retries` can be negative to retry forever.
         You can specify the types of supported errors which trigger
         a retry with the `supported_errors` parameter.
         """
@@ -46,7 +47,7 @@ def call_with_retry(self, do, fail):
             except self._supported_errors as error:
                 failures += 1
                 fail(error)
-                if failures > self._retries:
+                if self._retries >= 0 and failures > self._retries:
                     raise error
                 backoff = self._backoff.compute(failures)
                 if backoff > 0:
diff --git a/tests/test_asyncio/test_retry.py b/tests/test_asyncio/test_retry.py
index e83e001847..dee83ba664 100644
--- a/tests/test_asyncio/test_retry.py
+++ b/tests/test_asyncio/test_retry.py
@@ -56,6 +56,11 @@ async def _do(self):
     async def _fail(self, error):
         self.actual_failures += 1
 
+    async def _fail_inf(self, error):
+        self.actual_failures += 1
+        if self.actual_failures == 5:
+            raise ConnectionError()
+
     @pytest.mark.parametrize("retries", range(10))
     @pytest.mark.asyncio
     async def test_retry(self, retries: int):
@@ -68,3 +73,14 @@ async def test_retry(self, retries: int):
         assert self.actual_failures == 1 + retries
         assert backoff.reset_calls == 1
         assert backoff.calls == retries
+
+    @pytest.mark.asyncio
+    async def test_infinite_retry(self):
+        backoff = BackoffMock()
+        # specify infinite retries, but give up after 5
+        retry = Retry(backoff, -1)
+        with pytest.raises(ConnectionError):
+            await retry.call_with_retry(self._do, self._fail_inf)
+
+        assert self.actual_attempts == 5
+        assert self.actual_failures == 5
diff --git a/tests/test_retry.py b/tests/test_retry.py
index 0094787247..f844fd0a12 100644
--- a/tests/test_retry.py
+++ b/tests/test_retry.py
@@ -95,6 +95,11 @@ def _do(self):
     def _fail(self, error):
         self.actual_failures += 1
 
+    def _fail_inf(self, error):
+        self.actual_failures += 1
+        if self.actual_failures == 5:
+            raise ConnectionError()
+
     @pytest.mark.parametrize("retries", range(10))
     def test_retry(self, retries):
         backoff = BackoffMock()
@@ -107,6 +112,16 @@ def test_retry(self, retries):
         assert backoff.reset_calls == 1
         assert backoff.calls == retries
 
+    def test_infinite_retry(self):
+        backoff = BackoffMock()
+        # specify infinite retries, but give up after 5
+        retry = Retry(backoff, -1)
+        with pytest.raises(ConnectionError):
+            retry.call_with_retry(self._do, self._fail_inf)
+
+        assert self.actual_attempts == 5
+        assert self.actual_failures == 5
+
 
 @pytest.mark.onlynoncluster
 class TestRedisClientRetry:

From 1475e5ced1469379a50502e47ec798458bd00f59 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 28 Apr 2022 14:16:47 +0300
Subject: [PATCH 0474/1164] Add async supoort for SEARCH commands (#2096)

* Add async supoort for SEARCH commands

* linters

* linters

* linters

* linters

* linters
---
 redis/asyncio/client.py                       |    4 +-
 redis/commands/__init__.py                    |    3 +-
 redis/commands/redismodules.py                |   10 +
 redis/commands/search/__init__.py             |   64 +-
 redis/commands/search/commands.py             |  242 +
 tests/test_asyncio/conftest.py                |    2 +-
 tests/test_asyncio/test_search.py             | 1067 ++++
 tests/test_asyncio/testdata/jsontestdata.py   |  617 +++
 tests/test_asyncio/testdata/titles.csv        | 4861 +++++++++++++++++
 .../testdata/will_play_text.csv.bz2           |  Bin 0 -> 2069623 bytes
 10 files changed, 6865 insertions(+), 5 deletions(-)
 create mode 100644 tests/test_asyncio/test_search.py
 create mode 100644 tests/test_asyncio/testdata/jsontestdata.py
 create mode 100644 tests/test_asyncio/testdata/titles.csv
 create mode 100755 tests/test_asyncio/testdata/will_play_text.csv.bz2

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 559b74c9f6..7689e120e3 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -41,8 +41,8 @@
 )
 from redis.commands import (
     AsyncCoreCommands,
+    AsyncRedisModuleCommands,
     AsyncSentinelCommands,
-    RedisModuleCommands,
     list_or_args,
 )
 from redis.compat import Protocol, TypedDict
@@ -81,7 +81,7 @@ async def __call__(self, response: Any, **kwargs):
 
 
 class Redis(
-    AbstractRedis, RedisModuleCommands, AsyncCoreCommands, AsyncSentinelCommands
+    AbstractRedis, AsyncRedisModuleCommands, AsyncCoreCommands, AsyncSentinelCommands
 ):
     """
     Implementation of the Redis protocol.
diff --git a/redis/commands/__init__.py b/redis/commands/__init__.py
index b9dd0b7210..de21a9e818 100644
--- a/redis/commands/__init__.py
+++ b/redis/commands/__init__.py
@@ -2,7 +2,7 @@
 from .core import AsyncCoreCommands, CoreCommands
 from .helpers import list_or_args
 from .parser import CommandsParser
-from .redismodules import RedisModuleCommands
+from .redismodules import AsyncRedisModuleCommands, RedisModuleCommands
 from .sentinel import AsyncSentinelCommands, SentinelCommands
 
 __all__ = [
@@ -11,6 +11,7 @@
     "AsyncCoreCommands",
     "CoreCommands",
     "list_or_args",
+    "AsyncRedisModuleCommands",
     "RedisModuleCommands",
     "AsyncSentinelCommands",
     "SentinelCommands",
diff --git a/redis/commands/redismodules.py b/redis/commands/redismodules.py
index eafd6500ea..c0238d3a39 100644
--- a/redis/commands/redismodules.py
+++ b/redis/commands/redismodules.py
@@ -81,3 +81,13 @@ def graph(self, index_name="idx"):
 
         g = Graph(client=self, name=index_name)
         return g
+
+
+class AsyncRedisModuleCommands(RedisModuleCommands):
+    def ft(self, index_name="idx"):
+        """Access the search namespace, providing support for redis search."""
+
+        from .search import AsyncSearch
+
+        s = AsyncSearch(client=self, index_name=index_name)
+        return s
diff --git a/redis/commands/search/__init__.py b/redis/commands/search/__init__.py
index e9763b60a8..bcad785495 100644
--- a/redis/commands/search/__init__.py
+++ b/redis/commands/search/__init__.py
@@ -1,6 +1,6 @@
 import redis
 
-from .commands import SearchCommands
+from .commands import AsyncSearchCommands, SearchCommands
 
 
 class Search(SearchCommands):
@@ -112,5 +112,67 @@ def pipeline(self, transaction=True, shard_hint=None):
         return p
 
 
+class AsyncSearch(Search, AsyncSearchCommands):
+    class BatchIndexer(Search.BatchIndexer):
+        """
+        A batch indexer allows you to automatically batch
+        document indexing in pipelines, flushing it every N documents.
+        """
+
+        async def add_document(
+            self,
+            doc_id,
+            nosave=False,
+            score=1.0,
+            payload=None,
+            replace=False,
+            partial=False,
+            no_create=False,
+            **fields,
+        ):
+            """
+            Add a document to the batch query
+            """
+            self.client._add_document(
+                doc_id,
+                conn=self._pipeline,
+                nosave=nosave,
+                score=score,
+                payload=payload,
+                replace=replace,
+                partial=partial,
+                no_create=no_create,
+                **fields,
+            )
+            self.current_chunk += 1
+            self.total += 1
+            if self.current_chunk >= self.chunk_size:
+                await self.commit()
+
+        async def commit(self):
+            """
+            Manually commit and flush the batch indexing query
+            """
+            await self._pipeline.execute()
+            self.current_chunk = 0
+
+    def pipeline(self, transaction=True, shard_hint=None):
+        """Creates a pipeline for the SEARCH module, that can be used for executing
+        SEARCH commands, as well as classic core commands.
+        """
+        p = AsyncPipeline(
+            connection_pool=self.client.connection_pool,
+            response_callbacks=self.MODULE_CALLBACKS,
+            transaction=transaction,
+            shard_hint=shard_hint,
+        )
+        p.index_name = self.index_name
+        return p
+
+
 class Pipeline(SearchCommands, redis.client.Pipeline):
     """Pipeline for the module."""
+
+
+class AsyncPipeline(AsyncSearchCommands, redis.asyncio.client.Pipeline):
+    """AsyncPipeline for the module."""
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index a63868f98a..3413fc11ec 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -857,3 +857,245 @@ def syndump(self):
         """  # noqa
         raw = self.execute_command(SYNDUMP_CMD, self.index_name)
         return {raw[i]: raw[i + 1] for i in range(0, len(raw), 2)}
+
+
+class AsyncSearchCommands(SearchCommands):
+    async def info(self):
+        """
+        Get info an stats about the the current index, including the number of
+        documents, memory consumption, etc
+
+        For more information https://oss.redis.com/redisearch/Commands/#ftinfo
+        """
+
+        res = await self.execute_command(INFO_CMD, self.index_name)
+        it = map(to_string, res)
+        return dict(zip(it, it))
+
+    async def search(
+        self,
+        query: Union[str, Query],
+        query_params: Dict[str, Union[str, int, float]] = None,
+    ):
+        """
+        Search the index for a given query, and return a result of documents
+
+        ### Parameters
+
+        - **query**: the search query. Either a text for simple queries with
+                     default parameters, or a Query object for complex queries.
+                     See RediSearch's documentation on query format
+
+        For more information: https://oss.redis.com/redisearch/Commands/#ftsearch
+        """  # noqa
+        args, query = self._mk_query_args(query, query_params=query_params)
+        st = time.time()
+        res = await self.execute_command(SEARCH_CMD, *args)
+
+        if isinstance(res, Pipeline):
+            return res
+
+        return Result(
+            res,
+            not query._no_content,
+            duration=(time.time() - st) * 1000.0,
+            has_payload=query._with_payloads,
+            with_scores=query._with_scores,
+        )
+
+    async def aggregate(
+        self,
+        query: Union[str, Query],
+        query_params: Dict[str, Union[str, int, float]] = None,
+    ):
+        """
+        Issue an aggregation query.
+
+        ### Parameters
+
+        **query**: This can be either an `AggregateRequest`, or a `Cursor`
+
+        An `AggregateResult` object is returned. You can access the rows from
+        its `rows` property, which will always yield the rows of the result.
+
+        For more information: https://oss.redis.com/redisearch/Commands/#ftaggregate
+        """  # noqa
+        if isinstance(query, AggregateRequest):
+            has_cursor = bool(query._cursor)
+            cmd = [AGGREGATE_CMD, self.index_name] + query.build_args()
+        elif isinstance(query, Cursor):
+            has_cursor = True
+            cmd = [CURSOR_CMD, "READ", self.index_name] + query.build_args()
+        else:
+            raise ValueError("Bad query", query)
+        if query_params is not None:
+            cmd += self.get_params_args(query_params)
+
+        raw = await self.execute_command(*cmd)
+        return self._get_aggregate_result(raw, query, has_cursor)
+
+    async def spellcheck(self, query, distance=None, include=None, exclude=None):
+        """
+        Issue a spellcheck query
+
+        ### Parameters
+
+        **query**: search query.
+        **distance***: the maximal Levenshtein distance for spelling
+                       suggestions (default: 1, max: 4).
+        **include**: specifies an inclusion custom dictionary.
+        **exclude**: specifies an exclusion custom dictionary.
+
+        For more information: https://oss.redis.com/redisearch/Commands/#ftspellcheck
+        """  # noqa
+        cmd = [SPELLCHECK_CMD, self.index_name, query]
+        if distance:
+            cmd.extend(["DISTANCE", distance])
+
+        if include:
+            cmd.extend(["TERMS", "INCLUDE", include])
+
+        if exclude:
+            cmd.extend(["TERMS", "EXCLUDE", exclude])
+
+        raw = await self.execute_command(*cmd)
+
+        corrections = {}
+        if raw == 0:
+            return corrections
+
+        for _correction in raw:
+            if isinstance(_correction, int) and _correction == 0:
+                continue
+
+            if len(_correction) != 3:
+                continue
+            if not _correction[2]:
+                continue
+            if not _correction[2][0]:
+                continue
+
+            corrections[_correction[1]] = [
+                {"score": _item[0], "suggestion": _item[1]} for _item in _correction[2]
+            ]
+
+        return corrections
+
+    async def config_set(self, option, value):
+        """Set runtime configuration option.
+
+        ### Parameters
+
+        - **option**: the name of the configuration option.
+        - **value**: a value for the configuration option.
+
+        For more information: https://oss.redis.com/redisearch/Commands/#ftconfig
+        """  # noqa
+        cmd = [CONFIG_CMD, "SET", option, value]
+        raw = await self.execute_command(*cmd)
+        return raw == "OK"
+
+    async def config_get(self, option):
+        """Get runtime configuration option value.
+
+        ### Parameters
+
+        - **option**: the name of the configuration option.
+
+        For more information: https://oss.redis.com/redisearch/Commands/#ftconfig
+        """  # noqa
+        cmd = [CONFIG_CMD, "GET", option]
+        res = {}
+        raw = await self.execute_command(*cmd)
+        if raw:
+            for kvs in raw:
+                res[kvs[0]] = kvs[1]
+        return res
+
+    async def load_document(self, id):
+        """
+        Load a single document by id
+        """
+        fields = await self.client.hgetall(id)
+        f2 = {to_string(k): to_string(v) for k, v in fields.items()}
+        fields = f2
+
+        try:
+            del fields["id"]
+        except KeyError:
+            pass
+
+        return Document(id=id, **fields)
+
+    async def sugadd(self, key, *suggestions, **kwargs):
+        """
+        Add suggestion terms to the AutoCompleter engine. Each suggestion has
+        a score and string.
+        If kwargs["increment"] is true and the terms are already in the
+        server's dictionary, we increment their scores.
+
+        For more information: https://oss.redis.com/redisearch/master/Commands/#ftsugadd
+        """  # noqa
+        # If Transaction is not False it will MULTI/EXEC which will error
+        pipe = self.pipeline(transaction=False)
+        for sug in suggestions:
+            args = [SUGADD_COMMAND, key, sug.string, sug.score]
+            if kwargs.get("increment"):
+                args.append("INCR")
+            if sug.payload:
+                args.append("PAYLOAD")
+                args.append(sug.payload)
+
+            pipe.execute_command(*args)
+
+        return (await pipe.execute())[-1]
+
+    async def sugget(
+        self, key, prefix, fuzzy=False, num=10, with_scores=False, with_payloads=False
+    ):
+        """
+        Get a list of suggestions from the AutoCompleter, for a given prefix.
+
+        Parameters:
+
+        prefix : str
+            The prefix we are searching. **Must be valid ascii or utf-8**
+        fuzzy : bool
+            If set to true, the prefix search is done in fuzzy mode.
+            **NOTE**: Running fuzzy searches on short (<3 letters) prefixes
+            can be very
+            slow, and even scan the entire index.
+        with_scores : bool
+            If set to true, we also return the (refactored) score of
+            each suggestion.
+            This is normally not needed, and is NOT the original score
+            inserted into the index.
+        with_payloads : bool
+            Return suggestion payloads
+        num : int
+            The maximum number of results we return. Note that we might
+            return less. The algorithm trims irrelevant suggestions.
+
+        Returns:
+
+        list:
+             A list of Suggestion objects. If with_scores was False, the
+             score of all suggestions is 1.
+
+        For more information: https://oss.redis.com/redisearch/master/Commands/#ftsugget
+        """  # noqa
+        args = [SUGGET_COMMAND, key, prefix, "MAX", num]
+        if fuzzy:
+            args.append(FUZZY)
+        if with_scores:
+            args.append(WITHSCORES)
+        if with_payloads:
+            args.append(WITHPAYLOADS)
+
+        ret = await self.execute_command(*args)
+        results = []
+        if not ret:
+            return results
+
+        parser = SuggestionParser(with_scores, with_payloads, ret)
+        return [s for s in parser]
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index 34c22c5a55..02f2fc577f 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -202,7 +202,7 @@ async def wait_for_command(
         # generate key
         redis_version = REDIS_INFO["version"]
         if Version(redis_version) >= Version("5.0.0"):
-            id_str = str(client.client_id())
+            id_str = str(await client.client_id())
         else:
             id_str = f"{random.randrange(2 ** 32):08x}"
         key = f"__REDIS-PY-{id_str}__"
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
new file mode 100644
index 0000000000..69ae54d027
--- /dev/null
+++ b/tests/test_asyncio/test_search.py
@@ -0,0 +1,1067 @@
+import bz2
+import csv
+import os
+import time
+from io import TextIOWrapper
+
+import pytest
+
+import redis.asyncio as redis
+import redis.commands.search
+import redis.commands.search.aggregation as aggregations
+import redis.commands.search.reducers as reducers
+from redis.commands.search import AsyncSearch
+from redis.commands.search.field import GeoField, NumericField, TagField, TextField
+from redis.commands.search.indexDefinition import IndexDefinition
+from redis.commands.search.query import GeoFilter, NumericFilter, Query
+from redis.commands.search.result import Result
+from redis.commands.search.suggestion import Suggestion
+from tests.conftest import skip_ifmodversion_lt
+
+pytestmark = pytest.mark.asyncio
+
+
+WILL_PLAY_TEXT = os.path.abspath(
+    os.path.join(os.path.dirname(__file__), "testdata", "will_play_text.csv.bz2")
+)
+
+TITLES_CSV = os.path.abspath(
+    os.path.join(os.path.dirname(__file__), "testdata", "titles.csv")
+)
+
+
+async def waitForIndex(env, idx, timeout=None):
+    delay = 0.1
+    while True:
+        res = await env.execute_command("FT.INFO", idx)
+        try:
+            res.index("indexing")
+        except ValueError:
+            break
+
+        if int(res[res.index("indexing") + 1]) == 0:
+            break
+
+        time.sleep(delay)
+        if timeout is not None:
+            timeout -= delay
+            if timeout <= 0:
+                break
+
+
+def getClient(modclient: redis.Redis):
+    """
+    Gets a client client attached to an index name which is ready to be
+    created
+    """
+    return modclient
+
+
+async def createIndex(modclient, num_docs=100, definition=None):
+    try:
+        await modclient.create_index(
+            (TextField("play", weight=5.0), TextField("txt"), NumericField("chapter")),
+            definition=definition,
+        )
+    except redis.ResponseError:
+        await modclient.dropindex(delete_documents=True)
+        return createIndex(modclient, num_docs=num_docs, definition=definition)
+
+    chapters = {}
+    bzfp = TextIOWrapper(bz2.BZ2File(WILL_PLAY_TEXT), encoding="utf8")
+
+    r = csv.reader(bzfp, delimiter=";")
+    for n, line in enumerate(r):
+
+        play, chapter, _, text = line[1], line[2], line[4], line[5]
+
+        key = f"{play}:{chapter}".lower()
+        d = chapters.setdefault(key, {})
+        d["play"] = play
+        d["txt"] = d.get("txt", "") + " " + text
+        d["chapter"] = int(chapter or 0)
+        if len(chapters) == num_docs:
+            break
+
+    indexer = modclient.batch_indexer(chunk_size=50)
+    assert isinstance(indexer, AsyncSearch.BatchIndexer)
+    assert 50 == indexer.chunk_size
+
+    for key, doc in chapters.items():
+        await indexer.add_document(key, **doc)
+    await indexer.commit()
+
+
+@pytest.mark.redismod
+async def test_client(modclient: redis.Redis):
+    num_docs = 500
+    await createIndex(modclient.ft(), num_docs=num_docs)
+    await waitForIndex(modclient, "idx")
+    # verify info
+    info = await modclient.ft().info()
+    for k in [
+        "index_name",
+        "index_options",
+        "attributes",
+        "num_docs",
+        "max_doc_id",
+        "num_terms",
+        "num_records",
+        "inverted_sz_mb",
+        "offset_vectors_sz_mb",
+        "doc_table_size_mb",
+        "key_table_size_mb",
+        "records_per_doc_avg",
+        "bytes_per_record_avg",
+        "offsets_per_term_avg",
+        "offset_bits_per_record_avg",
+    ]:
+        assert k in info
+
+    assert modclient.ft().index_name == info["index_name"]
+    assert num_docs == int(info["num_docs"])
+
+    res = await modclient.ft().search("henry iv")
+    assert isinstance(res, Result)
+    assert 225 == res.total
+    assert 10 == len(res.docs)
+    assert res.duration > 0
+
+    for doc in res.docs:
+        assert doc.id
+        assert doc.play == "Henry IV"
+        assert len(doc.txt) > 0
+
+    # test no content
+    res = await modclient.ft().search(Query("king").no_content())
+    assert 194 == res.total
+    assert 10 == len(res.docs)
+    for doc in res.docs:
+        assert "txt" not in doc.__dict__
+        assert "play" not in doc.__dict__
+
+    # test verbatim vs no verbatim
+    total = (await modclient.ft().search(Query("kings").no_content())).total
+    vtotal = (await modclient.ft().search(Query("kings").no_content().verbatim())).total
+    assert total > vtotal
+
+    # test in fields
+    txt_total = (
+        await modclient.ft().search(Query("henry").no_content().limit_fields("txt"))
+    ).total
+    play_total = (
+        await modclient.ft().search(Query("henry").no_content().limit_fields("play"))
+    ).total
+    both_total = (
+        await (
+            modclient.ft().search(
+                Query("henry").no_content().limit_fields("play", "txt")
+            )
+        )
+    ).total
+    assert 129 == txt_total
+    assert 494 == play_total
+    assert 494 == both_total
+
+    # test load_document
+    doc = await modclient.ft().load_document("henry vi part 3:62")
+    assert doc is not None
+    assert "henry vi part 3:62" == doc.id
+    assert doc.play == "Henry VI Part 3"
+    assert len(doc.txt) > 0
+
+    # test in-keys
+    ids = [x.id for x in (await modclient.ft().search(Query("henry"))).docs]
+    assert 10 == len(ids)
+    subset = ids[:5]
+    docs = await modclient.ft().search(Query("henry").limit_ids(*subset))
+    assert len(subset) == docs.total
+    ids = [x.id for x in docs.docs]
+    assert set(ids) == set(subset)
+
+    # test slop and in order
+    assert 193 == (await modclient.ft().search(Query("henry king"))).total
+    assert (
+        3 == (await modclient.ft().search(Query("henry king").slop(0).in_order())).total
+    )
+    assert (
+        52
+        == (await modclient.ft().search(Query("king henry").slop(0).in_order())).total
+    )
+    assert 53 == (await modclient.ft().search(Query("henry king").slop(0))).total
+    assert 167 == (await modclient.ft().search(Query("henry king").slop(100))).total
+
+    # test delete document
+    await modclient.ft().add_document("doc-5ghs2", play="Death of a Salesman")
+    res = await modclient.ft().search(Query("death of a salesman"))
+    assert 1 == res.total
+
+    assert 1 == await modclient.ft().delete_document("doc-5ghs2")
+    res = await modclient.ft().search(Query("death of a salesman"))
+    assert 0 == res.total
+    assert 0 == await modclient.ft().delete_document("doc-5ghs2")
+
+    await modclient.ft().add_document("doc-5ghs2", play="Death of a Salesman")
+    res = await modclient.ft().search(Query("death of a salesman"))
+    assert 1 == res.total
+    await modclient.ft().delete_document("doc-5ghs2")
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.2.0", "search")
+async def test_payloads(modclient: redis.Redis):
+    await modclient.ft().create_index((TextField("txt"),))
+
+    await modclient.ft().add_document("doc1", payload="foo baz", txt="foo bar")
+    await modclient.ft().add_document("doc2", txt="foo bar")
+
+    q = Query("foo bar").with_payloads()
+    res = await modclient.ft().search(q)
+    assert 2 == res.total
+    assert "doc1" == res.docs[0].id
+    assert "doc2" == res.docs[1].id
+    assert "foo baz" == res.docs[0].payload
+    assert res.docs[1].payload is None
+
+
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+async def test_scores(modclient: redis.Redis):
+    await modclient.ft().create_index((TextField("txt"),))
+
+    await modclient.ft().add_document("doc1", txt="foo baz")
+    await modclient.ft().add_document("doc2", txt="foo bar")
+
+    q = Query("foo ~bar").with_scores()
+    res = await modclient.ft().search(q)
+    assert 2 == res.total
+    assert "doc2" == res.docs[0].id
+    assert 3.0 == res.docs[0].score
+    assert "doc1" == res.docs[1].id
+    # todo: enable once new RS version is tagged
+    # self.assertEqual(0.2, res.docs[1].score)
+
+
+@pytest.mark.redismod
+async def test_replace(modclient: redis.Redis):
+    await modclient.ft().create_index((TextField("txt"),))
+
+    await modclient.ft().add_document("doc1", txt="foo bar")
+    await modclient.ft().add_document("doc2", txt="foo bar")
+    await waitForIndex(modclient, "idx")
+
+    res = await modclient.ft().search("foo bar")
+    assert 2 == res.total
+    await (
+        modclient.ft().add_document("doc1", replace=True, txt="this is a replaced doc")
+    )
+
+    res = await modclient.ft().search("foo bar")
+    assert 1 == res.total
+    assert "doc2" == res.docs[0].id
+
+    res = await modclient.ft().search("replaced doc")
+    assert 1 == res.total
+    assert "doc1" == res.docs[0].id
+
+
+@pytest.mark.redismod
+async def test_stopwords(modclient: redis.Redis):
+    stopwords = ["foo", "bar", "baz"]
+    await modclient.ft().create_index((TextField("txt"),), stopwords=stopwords)
+    await modclient.ft().add_document("doc1", txt="foo bar")
+    await modclient.ft().add_document("doc2", txt="hello world")
+    await waitForIndex(modclient, "idx")
+
+    q1 = Query("foo bar").no_content()
+    q2 = Query("foo bar hello world").no_content()
+    res1, res2 = await modclient.ft().search(q1), await modclient.ft().search(q2)
+    assert 0 == res1.total
+    assert 1 == res2.total
+
+
+@pytest.mark.redismod
+async def test_filters(modclient: redis.Redis):
+    await (
+        modclient.ft().create_index(
+            (TextField("txt"), NumericField("num"), GeoField("loc"))
+        )
+    )
+    await (
+        modclient.ft().add_document(
+            "doc1", txt="foo bar", num=3.141, loc="-0.441,51.458"
+        )
+    )
+    await modclient.ft().add_document("doc2", txt="foo baz", num=2, loc="-0.1,51.2")
+
+    await waitForIndex(modclient, "idx")
+    # Test numerical filter
+    q1 = Query("foo").add_filter(NumericFilter("num", 0, 2)).no_content()
+    q2 = (
+        Query("foo")
+        .add_filter(NumericFilter("num", 2, NumericFilter.INF, minExclusive=True))
+        .no_content()
+    )
+    res1, res2 = await modclient.ft().search(q1), await modclient.ft().search(q2)
+
+    assert 1 == res1.total
+    assert 1 == res2.total
+    assert "doc2" == res1.docs[0].id
+    assert "doc1" == res2.docs[0].id
+
+    # Test geo filter
+    q1 = Query("foo").add_filter(GeoFilter("loc", -0.44, 51.45, 10)).no_content()
+    q2 = Query("foo").add_filter(GeoFilter("loc", -0.44, 51.45, 100)).no_content()
+    res1, res2 = await modclient.ft().search(q1), await modclient.ft().search(q2)
+
+    assert 1 == res1.total
+    assert 2 == res2.total
+    assert "doc1" == res1.docs[0].id
+
+    # Sort results, after RDB reload order may change
+    res = [res2.docs[0].id, res2.docs[1].id]
+    res.sort()
+    assert ["doc1", "doc2"] == res
+
+
+@pytest.mark.redismod
+async def test_payloads_with_no_content(modclient: redis.Redis):
+    await modclient.ft().create_index((TextField("txt"),))
+    await modclient.ft().add_document("doc1", payload="foo baz", txt="foo bar")
+    await modclient.ft().add_document("doc2", payload="foo baz2", txt="foo bar")
+
+    q = Query("foo bar").with_payloads().no_content()
+    res = await modclient.ft().search(q)
+    assert 2 == len(res.docs)
+
+
+@pytest.mark.redismod
+async def test_sort_by(modclient: redis.Redis):
+    await (
+        modclient.ft().create_index(
+            (TextField("txt"), NumericField("num", sortable=True))
+        )
+    )
+    await modclient.ft().add_document("doc1", txt="foo bar", num=1)
+    await modclient.ft().add_document("doc2", txt="foo baz", num=2)
+    await modclient.ft().add_document("doc3", txt="foo qux", num=3)
+
+    # Test sort
+    q1 = Query("foo").sort_by("num", asc=True).no_content()
+    q2 = Query("foo").sort_by("num", asc=False).no_content()
+    res1, res2 = await modclient.ft().search(q1), await modclient.ft().search(q2)
+
+    assert 3 == res1.total
+    assert "doc1" == res1.docs[0].id
+    assert "doc2" == res1.docs[1].id
+    assert "doc3" == res1.docs[2].id
+    assert 3 == res2.total
+    assert "doc1" == res2.docs[2].id
+    assert "doc2" == res2.docs[1].id
+    assert "doc3" == res2.docs[0].id
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.0.0", "search")
+async def test_drop_index(modclient: redis.Redis):
+    """
+    Ensure the index gets dropped by data remains by default
+    """
+    for x in range(20):
+        for keep_docs in [[True, {}], [False, {"name": "haveit"}]]:
+            idx = "HaveIt"
+            index = getClient(modclient)
+            await index.hset("index:haveit", mapping={"name": "haveit"})
+            idef = IndexDefinition(prefix=["index:"])
+            await index.ft(idx).create_index((TextField("name"),), definition=idef)
+            await waitForIndex(index, idx)
+            await index.ft(idx).dropindex(delete_documents=keep_docs[0])
+            i = await index.hgetall("index:haveit")
+            assert i == keep_docs[1]
+
+
+@pytest.mark.redismod
+async def test_example(modclient: redis.Redis):
+    # Creating the index definition and schema
+    await (
+        modclient.ft().create_index((TextField("title", weight=5.0), TextField("body")))
+    )
+
+    # Indexing a document
+    await modclient.ft().add_document(
+        "doc1",
+        title="RediSearch",
+        body="Redisearch impements a search engine on top of redis",
+    )
+
+    # Searching with complex parameters:
+    q = Query("search engine").verbatim().no_content().paging(0, 5)
+
+    res = await modclient.ft().search(q)
+    assert res is not None
+
+
+@pytest.mark.redismod
+async def test_auto_complete(modclient: redis.Redis):
+    n = 0
+    with open(TITLES_CSV) as f:
+        cr = csv.reader(f)
+
+        for row in cr:
+            n += 1
+            term, score = row[0], float(row[1])
+            assert n == await modclient.ft().sugadd("ac", Suggestion(term, score=score))
+
+    assert n == await modclient.ft().suglen("ac")
+    ret = await modclient.ft().sugget("ac", "bad", with_scores=True)
+    assert 2 == len(ret)
+    assert "badger" == ret[0].string
+    assert isinstance(ret[0].score, float)
+    assert 1.0 != ret[0].score
+    assert "badalte rishtey" == ret[1].string
+    assert isinstance(ret[1].score, float)
+    assert 1.0 != ret[1].score
+
+    ret = await modclient.ft().sugget("ac", "bad", fuzzy=True, num=10)
+    assert 10 == len(ret)
+    assert 1.0 == ret[0].score
+    strs = {x.string for x in ret}
+
+    for sug in strs:
+        assert 1 == await modclient.ft().sugdel("ac", sug)
+    # make sure a second delete returns 0
+    for sug in strs:
+        assert 0 == await modclient.ft().sugdel("ac", sug)
+
+    # make sure they were actually deleted
+    ret2 = await modclient.ft().sugget("ac", "bad", fuzzy=True, num=10)
+    for sug in ret2:
+        assert sug.string not in strs
+
+    # Test with payload
+    await modclient.ft().sugadd("ac", Suggestion("pay1", payload="pl1"))
+    await modclient.ft().sugadd("ac", Suggestion("pay2", payload="pl2"))
+    await modclient.ft().sugadd("ac", Suggestion("pay3", payload="pl3"))
+
+    sugs = await (
+        modclient.ft().sugget("ac", "pay", with_payloads=True, with_scores=True)
+    )
+    assert 3 == len(sugs)
+    for sug in sugs:
+        assert sug.payload
+        assert sug.payload.startswith("pl")
+
+
+@pytest.mark.redismod
+async def test_no_index(modclient: redis.Redis):
+    await modclient.ft().create_index(
+        (
+            TextField("field"),
+            TextField("text", no_index=True, sortable=True),
+            NumericField("numeric", no_index=True, sortable=True),
+            GeoField("geo", no_index=True, sortable=True),
+            TagField("tag", no_index=True, sortable=True),
+        )
+    )
+
+    await modclient.ft().add_document(
+        "doc1", field="aaa", text="1", numeric="1", geo="1,1", tag="1"
+    )
+    await modclient.ft().add_document(
+        "doc2", field="aab", text="2", numeric="2", geo="2,2", tag="2"
+    )
+    await waitForIndex(modclient, "idx")
+
+    res = await modclient.ft().search(Query("@text:aa*"))
+    assert 0 == res.total
+
+    res = await modclient.ft().search(Query("@field:aa*"))
+    assert 2 == res.total
+
+    res = await modclient.ft().search(Query("*").sort_by("text", asc=False))
+    assert 2 == res.total
+    assert "doc2" == res.docs[0].id
+
+    res = await modclient.ft().search(Query("*").sort_by("text", asc=True))
+    assert "doc1" == res.docs[0].id
+
+    res = await modclient.ft().search(Query("*").sort_by("numeric", asc=True))
+    assert "doc1" == res.docs[0].id
+
+    res = await modclient.ft().search(Query("*").sort_by("geo", asc=True))
+    assert "doc1" == res.docs[0].id
+
+    res = await modclient.ft().search(Query("*").sort_by("tag", asc=True))
+    assert "doc1" == res.docs[0].id
+
+    # Ensure exception is raised for non-indexable, non-sortable fields
+    with pytest.raises(Exception):
+        TextField("name", no_index=True, sortable=False)
+    with pytest.raises(Exception):
+        NumericField("name", no_index=True, sortable=False)
+    with pytest.raises(Exception):
+        GeoField("name", no_index=True, sortable=False)
+    with pytest.raises(Exception):
+        TagField("name", no_index=True, sortable=False)
+
+
+@pytest.mark.redismod
+async def test_partial(modclient: redis.Redis):
+    await (
+        modclient.ft().create_index((TextField("f1"), TextField("f2"), TextField("f3")))
+    )
+    await modclient.ft().add_document("doc1", f1="f1_val", f2="f2_val")
+    await modclient.ft().add_document("doc2", f1="f1_val", f2="f2_val")
+    await modclient.ft().add_document("doc1", f3="f3_val", partial=True)
+    await modclient.ft().add_document("doc2", f3="f3_val", replace=True)
+    await waitForIndex(modclient, "idx")
+
+    # Search for f3 value. All documents should have it
+    res = await modclient.ft().search("@f3:f3_val")
+    assert 2 == res.total
+
+    # Only the document updated with PARTIAL should still have f1 and f2 values
+    res = await modclient.ft().search("@f3:f3_val @f2:f2_val @f1:f1_val")
+    assert 1 == res.total
+
+
+@pytest.mark.redismod
+async def test_no_create(modclient: redis.Redis):
+    await (
+        modclient.ft().create_index((TextField("f1"), TextField("f2"), TextField("f3")))
+    )
+    await modclient.ft().add_document("doc1", f1="f1_val", f2="f2_val")
+    await modclient.ft().add_document("doc2", f1="f1_val", f2="f2_val")
+    await modclient.ft().add_document("doc1", f3="f3_val", no_create=True)
+    await modclient.ft().add_document("doc2", f3="f3_val", no_create=True, partial=True)
+    await waitForIndex(modclient, "idx")
+
+    # Search for f3 value. All documents should have it
+    res = await modclient.ft().search("@f3:f3_val")
+    assert 2 == res.total
+
+    # Only the document updated with PARTIAL should still have f1 and f2 values
+    res = await modclient.ft().search("@f3:f3_val @f2:f2_val @f1:f1_val")
+    assert 1 == res.total
+
+    with pytest.raises(redis.ResponseError):
+        await (
+            modclient.ft().add_document(
+                "doc3", f2="f2_val", f3="f3_val", no_create=True
+            )
+        )
+
+
+@pytest.mark.redismod
+async def test_explain(modclient: redis.Redis):
+    await (
+        modclient.ft().create_index((TextField("f1"), TextField("f2"), TextField("f3")))
+    )
+    res = await modclient.ft().explain("@f3:f3_val @f2:f2_val @f1:f1_val")
+    assert res
+
+
+@pytest.mark.redismod
+async def test_explaincli(modclient: redis.Redis):
+    with pytest.raises(NotImplementedError):
+        await modclient.ft().explain_cli("foo")
+
+
+@pytest.mark.redismod
+async def test_summarize(modclient: redis.Redis):
+    await createIndex(modclient.ft())
+    await waitForIndex(modclient, "idx")
+
+    q = Query("king henry").paging(0, 1)
+    q.highlight(fields=("play", "txt"), tags=("<b>", "</b>"))
+    q.summarize("txt")
+
+    doc = sorted((await modclient.ft().search(q)).docs)[0]
+    assert "<b>Henry</b> IV" == doc.play
+    assert (
+        "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+        == doc.txt
+    )
+
+    q = Query("king henry").paging(0, 1).summarize().highlight()
+
+    doc = sorted((await modclient.ft().search(q)).docs)[0]
+    assert "<b>Henry</b> ... " == doc.play
+    assert (
+        "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+        == doc.txt
+    )
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.0.0", "search")
+async def test_alias(modclient: redis.Redis):
+    index1 = getClient(modclient)
+    index2 = getClient(modclient)
+
+    def1 = IndexDefinition(prefix=["index1:"])
+    def2 = IndexDefinition(prefix=["index2:"])
+
+    ftindex1 = index1.ft("testAlias")
+    ftindex2 = index2.ft("testAlias2")
+    await ftindex1.create_index((TextField("name"),), definition=def1)
+    await ftindex2.create_index((TextField("name"),), definition=def2)
+
+    await index1.hset("index1:lonestar", mapping={"name": "lonestar"})
+    await index2.hset("index2:yogurt", mapping={"name": "yogurt"})
+
+    res = (await ftindex1.search("*")).docs[0]
+    assert "index1:lonestar" == res.id
+
+    # create alias and check for results
+    await ftindex1.aliasadd("spaceballs")
+    alias_client = getClient(modclient).ft("spaceballs")
+    res = (await alias_client.search("*")).docs[0]
+    assert "index1:lonestar" == res.id
+
+    # Throw an exception when trying to add an alias that already exists
+    with pytest.raises(Exception):
+        await ftindex2.aliasadd("spaceballs")
+
+    # update alias and ensure new results
+    await ftindex2.aliasupdate("spaceballs")
+    alias_client2 = getClient(modclient).ft("spaceballs")
+
+    res = (await alias_client2.search("*")).docs[0]
+    assert "index2:yogurt" == res.id
+
+    await ftindex2.aliasdel("spaceballs")
+    with pytest.raises(Exception):
+        (await alias_client2.search("*")).docs[0]
+
+
+@pytest.mark.redismod
+async def test_alias_basic(modclient: redis.Redis):
+    # Creating a client with one index
+    client = getClient(modclient)
+    await client.flushdb()
+    index1 = getClient(modclient).ft("testAlias")
+
+    await index1.create_index((TextField("txt"),))
+    await index1.add_document("doc1", txt="text goes here")
+
+    index2 = getClient(modclient).ft("testAlias2")
+    await index2.create_index((TextField("txt"),))
+    await index2.add_document("doc2", txt="text goes here")
+
+    # add the actual alias and check
+    await index1.aliasadd("myalias")
+    alias_client = getClient(modclient).ft("myalias")
+    res = sorted((await alias_client.search("*")).docs, key=lambda x: x.id)
+    assert "doc1" == res[0].id
+
+    # Throw an exception when trying to add an alias that already exists
+    with pytest.raises(Exception):
+        await index2.aliasadd("myalias")
+
+    # update the alias and ensure we get doc2
+    await index2.aliasupdate("myalias")
+    alias_client2 = getClient(modclient).ft("myalias")
+    res = sorted((await alias_client2.search("*")).docs, key=lambda x: x.id)
+    assert "doc1" == res[0].id
+
+    # delete the alias and expect an error if we try to query again
+    await index2.aliasdel("myalias")
+    with pytest.raises(Exception):
+        _ = (await alias_client2.search("*")).docs[0]
+
+
+@pytest.mark.redismod
+async def test_tags(modclient: redis.Redis):
+    await modclient.ft().create_index((TextField("txt"), TagField("tags")))
+    tags = "foo,foo bar,hello;world"
+    tags2 = "soba,ramen"
+
+    await modclient.ft().add_document("doc1", txt="fooz barz", tags=tags)
+    await modclient.ft().add_document("doc2", txt="noodles", tags=tags2)
+    await waitForIndex(modclient, "idx")
+
+    q = Query("@tags:{foo}")
+    res = await modclient.ft().search(q)
+    assert 1 == res.total
+
+    q = Query("@tags:{foo bar}")
+    res = await modclient.ft().search(q)
+    assert 1 == res.total
+
+    q = Query("@tags:{foo\\ bar}")
+    res = await modclient.ft().search(q)
+    assert 1 == res.total
+
+    q = Query("@tags:{hello\\;world}")
+    res = await modclient.ft().search(q)
+    assert 1 == res.total
+
+    q2 = await modclient.ft().tagvals("tags")
+    assert (tags.split(",") + tags2.split(",")).sort() == q2.sort()
+
+
+@pytest.mark.redismod
+async def test_textfield_sortable_nostem(modclient: redis.Redis):
+    # Creating the index definition with sortable and no_stem
+    await modclient.ft().create_index((TextField("txt", sortable=True, no_stem=True),))
+
+    # Now get the index info to confirm its contents
+    response = await modclient.ft().info()
+    assert "SORTABLE" in response["attributes"][0]
+    assert "NOSTEM" in response["attributes"][0]
+
+
+@pytest.mark.redismod
+async def test_alter_schema_add(modclient: redis.Redis):
+    # Creating the index definition and schema
+    await modclient.ft().create_index(TextField("title"))
+
+    # Using alter to add a field
+    await modclient.ft().alter_schema_add(TextField("body"))
+
+    # Indexing a document
+    await modclient.ft().add_document(
+        "doc1", title="MyTitle", body="Some content only in the body"
+    )
+
+    # Searching with parameter only in the body (the added field)
+    q = Query("only in the body")
+
+    # Ensure we find the result searching on the added body field
+    res = await modclient.ft().search(q)
+    assert 1 == res.total
+
+
+@pytest.mark.redismod
+async def test_spell_check(modclient: redis.Redis):
+    await modclient.ft().create_index((TextField("f1"), TextField("f2")))
+
+    await (
+        modclient.ft().add_document(
+            "doc1", f1="some valid content", f2="this is sample text"
+        )
+    )
+    await modclient.ft().add_document("doc2", f1="very important", f2="lorem ipsum")
+    await waitForIndex(modclient, "idx")
+
+    # test spellcheck
+    res = await modclient.ft().spellcheck("impornant")
+    assert "important" == res["impornant"][0]["suggestion"]
+
+    res = await modclient.ft().spellcheck("contnt")
+    assert "content" == res["contnt"][0]["suggestion"]
+
+    # test spellcheck with Levenshtein distance
+    res = await modclient.ft().spellcheck("vlis")
+    assert res == {}
+    res = await modclient.ft().spellcheck("vlis", distance=2)
+    assert "valid" == res["vlis"][0]["suggestion"]
+
+    # test spellcheck include
+    await modclient.ft().dict_add("dict", "lore", "lorem", "lorm")
+    res = await modclient.ft().spellcheck("lorm", include="dict")
+    assert len(res["lorm"]) == 3
+    assert (
+        res["lorm"][0]["suggestion"],
+        res["lorm"][1]["suggestion"],
+        res["lorm"][2]["suggestion"],
+    ) == ("lorem", "lore", "lorm")
+    assert (res["lorm"][0]["score"], res["lorm"][1]["score"]) == ("0.5", "0")
+
+    # test spellcheck exclude
+    res = await modclient.ft().spellcheck("lorm", exclude="dict")
+    assert res == {}
+
+
+@pytest.mark.redismod
+async def test_dict_operations(modclient: redis.Redis):
+    await modclient.ft().create_index((TextField("f1"), TextField("f2")))
+    # Add three items
+    res = await modclient.ft().dict_add("custom_dict", "item1", "item2", "item3")
+    assert 3 == res
+
+    # Remove one item
+    res = await modclient.ft().dict_del("custom_dict", "item2")
+    assert 1 == res
+
+    # Dump dict and inspect content
+    res = await modclient.ft().dict_dump("custom_dict")
+    assert ["item1", "item3"] == res
+
+    # Remove rest of the items before reload
+    await modclient.ft().dict_del("custom_dict", *res)
+
+
+@pytest.mark.redismod
+async def test_phonetic_matcher(modclient: redis.Redis):
+    await modclient.ft().create_index((TextField("name"),))
+    await modclient.ft().add_document("doc1", name="Jon")
+    await modclient.ft().add_document("doc2", name="John")
+
+    res = await modclient.ft().search(Query("Jon"))
+    assert 1 == len(res.docs)
+    assert "Jon" == res.docs[0].name
+
+    # Drop and create index with phonetic matcher
+    await modclient.flushdb()
+
+    await modclient.ft().create_index((TextField("name", phonetic_matcher="dm:en"),))
+    await modclient.ft().add_document("doc1", name="Jon")
+    await modclient.ft().add_document("doc2", name="John")
+
+    res = await modclient.ft().search(Query("Jon"))
+    assert 2 == len(res.docs)
+    assert ["John", "Jon"] == sorted(d.name for d in res.docs)
+
+
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+async def test_scorer(modclient: redis.Redis):
+    await modclient.ft().create_index((TextField("description"),))
+
+    await modclient.ft().add_document(
+        "doc1", description="The quick brown fox jumps over the lazy dog"
+    )
+    await modclient.ft().add_document(
+        "doc2",
+        description="Quick alice was beginning to get very tired of sitting by her quick sister on the bank, and of having nothing to do.",  # noqa
+    )
+
+    # default scorer is TFIDF
+    res = await modclient.ft().search(Query("quick").with_scores())
+    assert 1.0 == res.docs[0].score
+    res = await modclient.ft().search(Query("quick").scorer("TFIDF").with_scores())
+    assert 1.0 == res.docs[0].score
+    res = await (
+        modclient.ft().search(Query("quick").scorer("TFIDF.DOCNORM").with_scores())
+    )
+    assert 0.1111111111111111 == res.docs[0].score
+    res = await modclient.ft().search(Query("quick").scorer("BM25").with_scores())
+    assert 0.17699114465425977 == res.docs[0].score
+    res = await modclient.ft().search(Query("quick").scorer("DISMAX").with_scores())
+    assert 2.0 == res.docs[0].score
+    res = await modclient.ft().search(Query("quick").scorer("DOCSCORE").with_scores())
+    assert 1.0 == res.docs[0].score
+    res = await modclient.ft().search(Query("quick").scorer("HAMMING").with_scores())
+    assert 0.0 == res.docs[0].score
+
+
+@pytest.mark.redismod
+async def test_get(modclient: redis.Redis):
+    await modclient.ft().create_index((TextField("f1"), TextField("f2")))
+
+    assert [None] == await modclient.ft().get("doc1")
+    assert [None, None] == await modclient.ft().get("doc2", "doc1")
+
+    await modclient.ft().add_document(
+        "doc1", f1="some valid content dd1", f2="this is sample text ff1"
+    )
+    await modclient.ft().add_document(
+        "doc2", f1="some valid content dd2", f2="this is sample text ff2"
+    )
+
+    assert [
+        ["f1", "some valid content dd2", "f2", "this is sample text ff2"]
+    ] == await modclient.ft().get("doc2")
+    assert [
+        ["f1", "some valid content dd1", "f2", "this is sample text ff1"],
+        ["f1", "some valid content dd2", "f2", "this is sample text ff2"],
+    ] == await modclient.ft().get("doc1", "doc2")
+
+
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+@skip_ifmodversion_lt("2.2.0", "search")
+async def test_config(modclient: redis.Redis):
+    assert await modclient.ft().config_set("TIMEOUT", "100")
+    with pytest.raises(redis.ResponseError):
+        await modclient.ft().config_set("TIMEOUT", "null")
+    res = await modclient.ft().config_get("*")
+    assert "100" == res["TIMEOUT"]
+    res = await modclient.ft().config_get("TIMEOUT")
+    assert "100" == res["TIMEOUT"]
+
+
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+async def test_aggregations_groupby(modclient: redis.Redis):
+    # Creating the index definition and schema
+    await modclient.ft().create_index(
+        (
+            NumericField("random_num"),
+            TextField("title"),
+            TextField("body"),
+            TextField("parent"),
+        )
+    )
+
+    # Indexing a document
+    await modclient.ft().add_document(
+        "search",
+        title="RediSearch",
+        body="Redisearch impements a search engine on top of redis",
+        parent="redis",
+        random_num=10,
+    )
+    await modclient.ft().add_document(
+        "ai",
+        title="RedisAI",
+        body="RedisAI executes Deep Learning/Machine Learning models and managing their data.",  # noqa
+        parent="redis",
+        random_num=3,
+    )
+    await modclient.ft().add_document(
+        "json",
+        title="RedisJson",
+        body="RedisJSON implements ECMA-404 The JSON Data Interchange Standard as a native data type.",  # noqa
+        parent="redis",
+        random_num=8,
+    )
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
+        reducers.count(),
+    )
+
+    res = (await modclient.ft().aggregate(req)).rows[0]
+    assert res[1] == "redis"
+    assert res[3] == "3"
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
+        reducers.count_distinct("@title"),
+    )
+
+    res = (await modclient.ft().aggregate(req)).rows[0]
+    assert res[1] == "redis"
+    assert res[3] == "3"
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
+        reducers.count_distinctish("@title"),
+    )
+
+    res = (await modclient.ft().aggregate(req)).rows[0]
+    assert res[1] == "redis"
+    assert res[3] == "3"
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
+        reducers.sum("@random_num"),
+    )
+
+    res = (await modclient.ft().aggregate(req)).rows[0]
+    assert res[1] == "redis"
+    assert res[3] == "21"  # 10+8+3
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
+        reducers.min("@random_num"),
+    )
+
+    res = (await modclient.ft().aggregate(req)).rows[0]
+    assert res[1] == "redis"
+    assert res[3] == "3"  # min(10,8,3)
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
+        reducers.max("@random_num"),
+    )
+
+    res = (await modclient.ft().aggregate(req)).rows[0]
+    assert res[1] == "redis"
+    assert res[3] == "10"  # max(10,8,3)
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
+        reducers.avg("@random_num"),
+    )
+
+    res = (await modclient.ft().aggregate(req)).rows[0]
+    assert res[1] == "redis"
+    assert res[3] == "7"  # (10+3+8)/3
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
+        reducers.stddev("random_num"),
+    )
+
+    res = (await modclient.ft().aggregate(req)).rows[0]
+    assert res[1] == "redis"
+    assert res[3] == "3.60555127546"
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
+        reducers.quantile("@random_num", 0.5),
+    )
+
+    res = (await modclient.ft().aggregate(req)).rows[0]
+    assert res[1] == "redis"
+    assert res[3] == "8"  # median of 3,8,10
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
+        reducers.tolist("@title"),
+    )
+
+    res = (await modclient.ft().aggregate(req)).rows[0]
+    assert res[1] == "redis"
+    assert res[3] == ["RediSearch", "RedisAI", "RedisJson"]
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
+        reducers.first_value("@title").alias("first"),
+    )
+
+    res = (await modclient.ft().aggregate(req)).rows[0]
+    assert res == ["parent", "redis", "first", "RediSearch"]
+
+    req = aggregations.AggregateRequest("redis").group_by(
+        "@parent",
+        reducers.random_sample("@title", 2).alias("random"),
+    )
+
+    res = (await modclient.ft().aggregate(req)).rows[0]
+    assert res[1] == "redis"
+    assert res[2] == "random"
+    assert len(res[3]) == 2
+    assert res[3][0] in ["RediSearch", "RedisAI", "RedisJson"]
+
+
+@pytest.mark.redismod
+async def test_aggregations_sort_by_and_limit(modclient: redis.Redis):
+    await modclient.ft().create_index(
+        (
+            TextField("t1"),
+            TextField("t2"),
+        )
+    )
+
+    await modclient.ft().client.hset("doc1", mapping={"t1": "a", "t2": "b"})
+    await modclient.ft().client.hset("doc2", mapping={"t1": "b", "t2": "a"})
+
+    # test sort_by using SortDirection
+    req = aggregations.AggregateRequest("*").sort_by(
+        aggregations.Asc("@t2"), aggregations.Desc("@t1")
+    )
+    res = await modclient.ft().aggregate(req)
+    assert res.rows[0] == ["t2", "a", "t1", "b"]
+    assert res.rows[1] == ["t2", "b", "t1", "a"]
+
+    # test sort_by without SortDirection
+    req = aggregations.AggregateRequest("*").sort_by("@t1")
+    res = await modclient.ft().aggregate(req)
+    assert res.rows[0] == ["t1", "a"]
+    assert res.rows[1] == ["t1", "b"]
+
+    # test sort_by with max
+    req = aggregations.AggregateRequest("*").sort_by("@t1", max=1)
+    res = await modclient.ft().aggregate(req)
+    assert len(res.rows) == 1
+
+    # test limit
+    req = aggregations.AggregateRequest("*").sort_by("@t1").limit(1, 1)
+    res = await modclient.ft().aggregate(req)
+    assert len(res.rows) == 1
+    assert res.rows[0] == ["t1", "b"]
diff --git a/tests/test_asyncio/testdata/jsontestdata.py b/tests/test_asyncio/testdata/jsontestdata.py
new file mode 100644
index 0000000000..0a920cc55b
--- /dev/null
+++ b/tests/test_asyncio/testdata/jsontestdata.py
@@ -0,0 +1,617 @@
+nested_large_key = r"""
+{
+  "jkra": [
+    154,
+    4472,
+    [
+      8567,
+      false,
+      363.84,
+      5276,
+      "ha",
+      "rizkzs",
+      93
+    ],
+    false
+  ],
+  "hh": 20.77,
+  "mr": 973.217,
+  "ihbe": [
+    68,
+    [
+      true,
+      {
+        "lqe": [
+          486.363,
+          [
+            true,
+            {
+              "mp": {
+                "ory": "rj",
+                "qnl": "tyfrju",
+                "hf": None
+              },
+              "uooc": 7418,
+              "xela": 20,
+              "bt": 7014,
+              "ia": 547,
+              "szec": 68.73
+            },
+            None
+          ],
+          3622,
+          "iwk",
+          None
+        ],
+        "fepi": 19.954,
+        "ivu": {
+          "rmnd": 65.539,
+          "bk": 98,
+          "nc": "bdg",
+          "dlb": {
+            "hw": {
+              "upzz": [
+                true,
+                {
+                  "nwb": [
+                    4259.47
+                  ],
+                  "nbt": "yl"
+                },
+                false,
+                false,
+                65,
+                [
+                  [
+                    [],
+                    629.149,
+                    "lvynqh",
+                    "hsk",
+                    [],
+                    2011.932,
+                    true,
+                    []
+                  ],
+                  None,
+                  "ymbc",
+                  None
+                ],
+                "aj",
+                97.425,
+                "hc",
+                58
+              ]
+            },
+            "jq": true,
+            "bi": 3333,
+            "hmf": "pl",
+            "mrbj": [
+              true,
+              false
+            ]
+          }
+        },
+        "hfj": "lwk",
+        "utdl": "aku",
+        "alqb": [
+          74,
+          534.389,
+          7235,
+          [
+            None,
+            false,
+            None
+          ]
+        ]
+      },
+      None,
+      {
+        "lbrx": {
+          "vm": "ubdrbb"
+        },
+        "tie": "iok",
+        "br": "ojro"
+      },
+      70.558,
+      [
+        {
+          "mmo": None,
+          "dryu": None
+        }
+      ]
+    ],
+    true,
+    None,
+    false,
+    {
+      "jqun": 98,
+      "ivhq": [
+        [
+          [
+            675.936,
+            [
+              520.15,
+              1587.4,
+              false
+            ],
+            "jt",
+            true,
+            {
+              "bn": None,
+              "ygn": "cve",
+              "zhh": true,
+              "aak": 9165,
+              "skx": true,
+              "qqsk": 662.28
+            },
+            {
+              "eio": 9933.6,
+              "agl": None,
+              "pf": false,
+              "kv": 5099.631,
+              "no": None,
+              "shly": 58
+            },
+            [
+              None,
+              [
+                "uiundu",
+                726.652,
+                false,
+                94.92,
+                259.62,
+                {
+                  "ntqu": None,
+                  "frv": None,
+                  "rvop": "upefj",
+                  "jvdp": {
+                    "nhx": [],
+                    "bxnu": {},
+                    "gs": None,
+                    "mqho": None,
+                    "xp": 65,
+                    "ujj": {}
+                  },
+                  "ts": false,
+                  "kyuk": [
+                    false,
+                    58,
+                    {},
+                    "khqqif"
+                  ]
+                },
+                167,
+                true,
+                "bhlej",
+                53
+              ],
+              64,
+              {
+                "eans": "wgzfo",
+                "zfgb": 431.67,
+                "udy": [
+                  {
+                    "gnt": [],
+                    "zeve": {}
+                  },
+                  {
+                    "pg": {},
+                    "vsuc": {},
+                    "dw": 19,
+                    "ffo": "uwsh",
+                    "spk": "pjdyam",
+                    "mc": [],
+                    "wunb": {},
+                    "qcze": 2271.15,
+                    "mcqx": None
+                  },
+                  "qob"
+                ],
+                "wo": "zy"
+              },
+              {
+                "dok": None,
+                "ygk": None,
+                "afdw": [
+                  7848,
+                  "ah",
+                  None
+                ],
+                "foobar": 3.141592,
+                "wnuo": {
+                  "zpvi": {
+                    "stw": true,
+                    "bq": {},
+                    "zord": true,
+                    "omne": 3061.73,
+                    "bnwm": "wuuyy",
+                    "tuv": 7053,
+                    "lepv": None,
+                    "xap": 94.26
+                  },
+                  "nuv": false,
+                  "hhza": 539.615,
+                  "rqw": {
+                    "dk": 2305,
+                    "wibo": 7512.9,
+                    "ytbc": 153,
+                    "pokp": None,
+                    "whzd": None,
+                    "judg": [],
+                    "zh": None
+                  },
+                  "bcnu": "ji",
+                  "yhqu": None,
+                  "gwc": true,
+                  "smp": {
+                    "fxpl": 75,
+                    "gc": [],
+                    "vx": 9352.895,
+                    "fbzf": 4138.27,
+                    "tiaq": 354.306,
+                    "kmfb": {},
+                    "fxhy": [],
+                    "af": 94.46,
+                    "wg": {},
+                    "fb": None
+                  }
+                },
+                "zvym": 2921,
+                "hhlh": [
+                  45,
+                  214.345
+                ],
+                "vv": "gqjoz"
+              },
+              [
+                "uxlu",
+                None,
+                "utl",
+                64,
+                [
+                  2695
+                ],
+                [
+                  false,
+                  None,
+                  [
+                    "cfcrl",
+                    [],
+                    [],
+                    562,
+                    1654.9,
+                    {},
+                    None,
+                    "sqzud",
+                    934.6
+                  ],
+                  {
+                    "hk": true,
+                    "ed": "lodube",
+                    "ye": "ziwddj",
+                    "ps": None,
+                    "ir": {},
+                    "heh": false
+                  },
+                  true,
+                  719,
+                  50.56,
+                  [
+                    99,
+                    6409,
+                    None,
+                    4886,
+                    "esdtkt",
+                    {},
+                    None
+                  ],
+                  [
+                    false,
+                    "bkzqw"
+                  ]
+                ],
+                None,
+                6357
+              ],
+              {
+                "asvv": 22.873,
+                "vqm": {
+                  "drmv": 68.12,
+                  "tmf": 140.495,
+                  "le": None,
+                  "sanf": [
+                    true,
+                    [],
+                    "vyawd",
+                    false,
+                    76.496,
+                    [],
+                    "sdfpr",
+                    33.16,
+                    "nrxy",
+                    "antje"
+                  ],
+                  "yrkh": 662.426,
+                  "vxj": true,
+                  "sn": 314.382,
+                  "eorg": None
+                },
+                "bavq": [
+                  21.18,
+                  8742.66,
+                  {
+                    "eq": "urnd"
+                  },
+                  56.63,
+                  "fw",
+                  [
+                    {},
+                    "pjtr",
+                    None,
+                    "apyemk",
+                    [],
+                    [],
+                    false,
+                    {}
+                  ],
+                  {
+                    "ho": None,
+                    "ir": 124,
+                    "oevp": 159,
+                    "xdrv": 6705,
+                    "ff": [],
+                    "sx": false
+                  },
+                  true,
+                  None,
+                  true
+                ],
+                "zw": "qjqaap",
+                "hr": {
+                  "xz": 32,
+                  "mj": 8235.32,
+                  "yrtv": None,
+                  "jcz": "vnemxe",
+                  "ywai": [
+                    None,
+                    564,
+                    false,
+                    "vbr",
+                    54.741
+                  ],
+                  "vw": 82,
+                  "wn": true,
+                  "pav": true
+                },
+                "vxa": 881
+              },
+              "bgt",
+              "vuzk",
+              857
+            ]
+          ]
+        ],
+        None,
+        None,
+        {
+          "xyzl": "nvfff"
+        },
+        true,
+        13
+      ],
+      "npd": None,
+      "ha": [
+        [
+          "du",
+          [
+            980,
+            {
+              "zdhd": [
+                129.986,
+                [
+                  "liehns",
+                  453,
+                  {
+                    "fuq": false,
+                    "dxpn": {},
+                    "hmpx": 49,
+                    "zb": "gbpt",
+                    "vdqc": None,
+                    "ysjg": false,
+                    "gug": 7990.66
+                  },
+                  "evek",
+                  [
+                    {}
+                  ],
+                  "dfywcu",
+                  9686,
+                  None
+                ]
+              ],
+              "gpi": {
+                "gt": {
+                  "qe": 7460,
+                  "nh": "nrn",
+                  "czj": 66.609,
+                  "jwd": true,
+                  "rb": "azwwe",
+                  "fj": {
+                    "csn": true,
+                    "foobar": 1.61803398875,
+                    "hm": "efsgw",
+                    "zn": "vbpizt",
+                    "tjo": 138.15,
+                    "teo": {},
+                    "hecf": [],
+                    "ls": false
+                  }
+                },
+                "xlc": 7916,
+                "jqst": 48.166,
+                "zj": "ivctu"
+              },
+              "jl": 369.27,
+              "mxkx": None,
+              "sh": [
+                true,
+                373,
+                false,
+                "sdis",
+                6217,
+                {
+                  "ernm": None,
+                  "srbo": 90.798,
+                  "py": 677,
+                  "jgrq": None,
+                  "zujl": None,
+                  "odsm": {
+                    "pfrd": None,
+                    "kwz": "kfvjzb",
+                    "ptkp": false,
+                    "pu": None,
+                    "xty": None,
+                    "ntx": [],
+                    "nq": 48.19,
+                    "lpyx": []
+                  },
+                  "ff": None,
+                  "rvi": [
+                    "ych",
+                    {},
+                    72,
+                    9379,
+                    7897.383,
+                    true,
+                    {},
+                    999.751,
+                    false
+                  ]
+                },
+                true
+              ],
+              "ghe": [
+                24,
+                {
+                  "lpr": true,
+                  "qrs": true
+                },
+                true,
+                false,
+                7951.94,
+                true,
+                2690.54,
+                [
+                  93,
+                  None,
+                  None,
+                  "rlz",
+                  true,
+                  "ky",
+                  true
+                ]
+              ],
+              "vet": false,
+              "olle": None
+            },
+            "jzm",
+            true
+          ],
+          None,
+          None,
+          19.17,
+          7145,
+          "ipsmk"
+        ],
+        false,
+        {
+          "du": 6550.959,
+          "sps": 8783.62,
+          "nblr": {
+            "dko": 9856.616,
+            "lz": {
+              "phng": "dj"
+            },
+            "zeu": 766,
+            "tn": "dkr"
+          },
+          "xa": "trdw",
+          "gn": 9875.687,
+          "dl": None,
+          "vuql": None
+        },
+        {
+          "qpjo": None,
+          "das": {
+            "or": {
+              "xfy": None,
+              "xwvs": 4181.86,
+              "yj": 206.325,
+              "bsr": [
+                "qrtsh"
+              ],
+              "wndm": {
+                "ve": 56,
+                "jyqa": true,
+                "ca": None
+              },
+              "rpd": 9906,
+              "ea": "dvzcyt"
+            },
+            "xwnn": 9272,
+            "rpx": "zpr",
+            "srzg": {
+              "beo": 325.6,
+              "sq": None,
+              "yf": None,
+              "nu": [
+                377,
+                "qda",
+                true
+              ],
+              "sfz": "zjk"
+            },
+            "kh": "xnpj",
+            "rk": None,
+            "hzhn": [
+              None
+            ],
+            "uio": 6249.12,
+            "nxrv": 1931.635,
+            "pd": None
+          },
+          "pxlc": true,
+          "mjer": false,
+          "hdev": "msr",
+          "er": None
+        },
+        "ug",
+        None,
+        "yrfoix",
+        503.89,
+        563
+      ],
+      "tcy": 300,
+      "me": 459.17,
+      "tm": [
+        134.761,
+        "jcoels",
+        None
+      ],
+      "iig": 945.57,
+      "ad": "be"
+    },
+    "ltpdm",
+    None,
+    14.53
+  ],
+  "xi": "gxzzs",
+  "zfpw": 1564.87,
+  "ow": None,
+  "tm": [
+    46,
+    876.85
+  ],
+  "xejv": None
+}
+"""  # noqa
diff --git a/tests/test_asyncio/testdata/titles.csv b/tests/test_asyncio/testdata/titles.csv
new file mode 100644
index 0000000000..6428dd2aa3
--- /dev/null
+++ b/tests/test_asyncio/testdata/titles.csv
@@ -0,0 +1,4861 @@
+bhoj shala,1
+radhika balakrishnan,1
+ltm,1
+sterlite energy,1
+troll doll,11
+sonnontio,1
+nickelodeon netherlands kids choice awards,1
+jamaica national basketball team,5
+clan mackenzie,1
+secure attention key,3
+template talk indo pakistani war of 1971,1
+hassan firouzabadi,2
+carter alan,1
+alan levy,1
+tim severin,2
+faux pas derived from chinese pronunciation,1
+jruby,3
+tobias nielsén,1
+avro 571 buffalo,1
+treasury stock,17
+שלום,10
+oxygen 19,1
+ntru,4
+tennis racquet,1
+place of birth,4
+council of canadians,1
+urshu,1
+american hotel,1
+dow corning corporation,3
+language based learning disability,3
+meri aashiqui tum se hi,30
+specificity,9
+edward l hedden,1
+pelli chesukundam,2
+of love and shadows,4
+fort san felipe,2
+american express gold card dress of lizzy gardiner,4
+jovian,5
+kitashinagawa station,1
+radhi jaidi,1
+cordelia scaife may,2
+minor earth major sky,1
+bunty lawless stakes,1
+high capacity color barcode,3
+lyla lerrol,1
+crawford roberts,1
+collin balester,1
+ugo crousillat,1
+om prakash chautala,3
+izzy hoyland,1
+the poet,2
+daryl sabara,6
+aromatic acid,2
+reina sofia,1
+swierczek masovian voivodeship,1
+housing segregation in the united states,2
+karen maser,1
+scaptia beyonceae,2
+kitakyushu city,1
+htc desire 610,4
+dostoevsky,3
+portal victorian era,1
+bose–einstein correlations,3
+ralph hodgson,1
+racquet club,2
+walter camp man of the year,1
+australian movies,1
+k04he,1
+australia–india relations,2
+john william howard thompson,1
+pro cathedral,1
+paddyfield pipit,2
+book finance,1
+ford maverick,10
+slurve,4
+mnozil brass,2
+fiesta 9 1/8 inch square luncheon plate sunflower,1
+korsi,1
+draft 140th operations group,2
+camp,29
+series acceleration,1
+aljouf,1
+democratic party of new mexico,2
+united kingdom general election debates 2010,2
+madura strait,2
+back examination,1
+borgata,2
+il ritorno di tobia,3
+ovaphagous,1
+motörhead,9
+hellmaster,1
+richard keynes,1
+cryogenic treatment,3
+monte porzio,1
+transliteration of arabic,1
+anti catholic,2
+a very merry pooh year,2
+suffixes in hebrew,3
+barr body,16
+alaska constitution,1
+juan garrido,1
+yi lijun,1
+wawa inc,2
+endre kelemen,1
+l brands,18
+lr44,1
+coat of arms of the nagorno karabakh republic,1
+antonino fernandez,1
+salisbury roller girls,1
+zayat,2
+ian meadows,2
+semigalia,1
+khloe and lamar,2
+holding,1
+larchmont edgewater,1
+dynamic parcel distribution,6
+seaworld,30
+assistant secretary of war,1
+digital currency,14
+mazomanie wisconsin,1
+sujatha rangarajan,8
+street child,1
+anna sheehan,1
+violence jack,2
+santi solari,1
+template talk texas in the civil war,1
+colorss foundation,1
+faucaria,1
+alfred gardyne de chastelain,2
+tramp,1
+cannington ontario,2
+penguinone,1
+cardiac arrest,2
+summan grouper,1
+cyndis list,1
+cbs,2
+salminus brasiliensis,2
+kodiak bear,26
+cinemascore,9
+phragmidium,1
+city of vultures,1
+lawrence g romo,1
+chandni chowk to china,1
+scarp retreat,1
+rosses point,1
+carretera de cádiz,1
+chamunda,8
+battle of stalingrad,1
+who came first,2
+salome,5
+portuguese historical museum,3
+westfield sarasota square,1
+muehrckes nails,3
+kennebec north carolina,1
+american classical league,1
+how do you like them apples,1
+mark halperin,20
+circo,1
+turner classic movies,2
+australian rules football in sweden,1
+household silver,3
+frank baird,1
+escape from east berlin,2
+a village romeo and juliet,1
+wally nesbitt,6
+joseph renzulli,2
+spalding gray,1
+dangaria kandha,1
+pms asterisk,2
+openal,1
+romy haag,1
+mh message handling system,4
+pioneer 4,4
+hmcs stettler,1
+gangsta,10
+major third,4
+joan osbourn,1
+mount columbia,2
+active galactic nucleus,14
+robert clary,8
+eva pracht,1
+ion implantation,5
+rydell poepon,4
+baller blockin,2
+enfield chase railway station,1
+serge aurier,13
+florin vlaicu,1
+van diemens land,9
+krishnapur bagalkot,1
+oleksandr zinchenko,96
+collaborations,2
+hecla,2
+amber marshall,7
+inácio henrique de gouveia,1
+bronze age korea,1
+slc punk,5
+ryan jack,2
+clathrus ruber,6
+angel of death,4
+valentines park,1
+extra pyramidal,1
+kiami davael,1
+oleg i shuplyak,1
+nidum,2
+friendship of salem,2
+bèze,3
+arnold weinstock,1
+able,1
+s d ugamchand,1
+the omega glory,2
+ami james,3
+denmark at the 1968 summer olympics,1
+kill me again,1
+richmond town square,1
+guy domville,1
+jessica simpson,1
+kinship care,1
+brugge railway station,2
+unobtainium,16
+carl johan bernadotte,3
+acacia concinna,5
+epinomis,1
+interlachen country club,1
+compromise tariff,1
+fairchild jk,1
+dog trainer,1
+brian dabul,1
+cai yong,1
+jezebel,7
+augarten porcelain,1
+summerslam 1992,1
+ion andoni goikoetxea,2
+dominican church vienna,1
+iffhs worlds best club coach,2
+uruguayan presidential election 2009,2
+saving the queen,1
+un cadavre,1
+history of the jews in france,4
+wbyg,1
+charles de brosses,2
+human weapon,2
+haunted castle,3
+austin maestro,1
+search for extra terrestrial intelligence,1
+suwon,9
+cost per impression,1
+osney lock,1
+markus eriksson,1
+cultural depictions of tony blair,2
+erich kempka,3
+pornogrind,5
+chekhov,1
+marilinda garcia,2
+hard drive,1
+small arms,9
+exploration of north america,8
+international korfball federation,1
+photographic lens design,4
+k hari prasad,1
+lebanese forces,3
+greece at the 2004 summer olympics,1
+lets trim our hair in accordance with the socialist lifestyle,2
+battle of cassinga,5
+donald and the wheel,1
+vti transmission,1
+gille chlerig earl of mar,1
+heart of atlanta motel inc v united states,6
+oh yeah,3
+carol decker,5
+prajakta shukre,4
+profiling,17
+thukima,1
+the great waldo search,1
+nick vincent,2
+the decision of the appeals jury is final and can only be overruled by a decision of the executive committee 2e,1
+civilization board game,1
+erasmus+,1
+eden phillpotts,1
+unleash the beast,1
+varoujan hakhbandian,1
+fermats last theorem,1
+conan the indomitable,1
+vagrant records,1
+house of villehardouin,1
+zoneyesha ulatha,1
+ashur bel nisheshu,1
+ten wijngaerde,2
+lgi homes,1
+american nietzsche a history of an icon and his ideas,1
+european magpie,3
+pablo soto,1
+terminiello v chicago,1
+vladimir cosma,2
+battle of yunnan burma road,1
+ophirodexia,1
+thudar,1
+northern irish,2
+bohemond of tarente,1
+anita moorjani,5
+serra do gerês,1
+fort horsted,1
+metre gauge,2
+stage show,3
+common flexor sheath of hand,2
+conall corc,1
+array slicing,6
+schüfftan process,1
+anmol malik,3
+out cold,2
+antiknock,2
+moss force,1
+paul medhurst,1
+somonauk illinois,1
+george crum,11
+baby talk,6
+daniel mann,4
+vacuum flask,10
+prostitution in the republic of ireland,5
+butch jones,7
+feminism in ukraine,1
+st marys church kilmore county wexford,1
+sonny emory,1
+satsuma han,1
+elben,1
+the best of the rippingtons,3
+m3p,1
+boat sharing,1
+iisco,1
+hoftoren,1
+cannabis in the united kingdom,6
+template talk germany districts saxony anhalt,1
+jean baptiste dutrou bornier,1
+teylers museum,1
+simons problem,2
+gerardus huysmans,1
+pupillary distance,5
+jane lowe,1
+palais de justice brussels,1
+hillsdale free will baptist college,1
+raf wattisham,2
+parnataara,1
+jensen beach campus of the florida institute of technology,1
+scottish gypsy and traveller groups,3
+cliffs shaft mine museum,3
+roaring forties,4
+where in time is carmen sandiego?,2
+perfect field,1
+rob schamberger,1
+lcd soundsystem,10
+alan rathbone,26
+setup,1
+gliding over all,4
+dastur,1
+flensburger brauerei,3
+berkeley global campus at richmond bay,1
+kanakapura,1
+mineworkers union of namibia,1
+tokneneng,3
+mapuche textiles,3
+peranakan beaded slippers,1
+goodra,2
+kanab ut,1
+the gold act 1968,4
+grey langur,1
+procol harum,5
+chris alexander,1
+ft walton beach metropolitan area,3
+dimensionless quantity,16
+the science of mind,1
+alfons schone,1
+euparthenos nubilis,1
+batrachotoxin,5
+fabric live 22,1
+mchenry boatwright,1
+langney sports club,1
+akela jones,1
+lookout,2
+matsuo tsurayaba,2
+general jackson,3
+hair removal,14
+african party for the independence of cape verde,4
+replica trick,1
+bromfenac,2
+make someone happy,1
+sam pancake,1
+denys finch hatton,10
+latin rhythm albums,1
+main bronchus,1
+campidoglio,4
+cathaoirleach,1
+emress justina,1
+sulzbach hesse,1
+noncicatricial alopecia,1
+sylvan place,4
+stalag i c,1
+league of extraordinary gentlemen,1
+sergey korolyov,2
+serbian presidential election 1997,1
+barnes lake millers lake michigan,1
+christmas island health centre,1
+dayton ballet,2
+gilles fauconnier,1
+harald svergja,1
+joanna newsom discography,2
+astro xi yue hd,1
+code sharing,3
+dreamcast vmu,1
+armand emmanuel du plessis duc de richelieu,1
+ecole supérieure des arts du cirque,2
+gerry mulligan,12
+kaaka kaaka,1
+mexico at the 2012 summer olympics,4
+bar wizards,2
+christmas is almost here again,2
+sterling heights michigan,4
+gaultheria procumbens,3
+eben etzebeth,8
+viktorija Čmilytė,1
+los angeles county california,39
+family entertainment,2
+quantum well,9
+elton,1
+allan frewin jones,1
+daniela ruah,32
+gkd legend,1
+coffman–graham algorithm,1
+santa clara durango,1
+brian protheroe,3
+crawler transporter,10
+lakshman,3
+fes el bali,2
+mary a krupsak,1
+irish rugby football union,5
+neuropsychiatry,2
+josé pirela,1
+bonaire status referendum 2015,1
+it,2
+playhouse in the park,1
+alexander yakovlev,7
+old bear,1
+graph tool,2
+merseyside west,1
+romanian armies in the battle of stalingrad,1
+dark they were and golden eyed,1
+aidan obrien,8
+town and davis,1
+suum cuique,3
+german american day,2
+northampton county pennsylvania,3
+candidates of the south australian state election 2010,1
+venator marginatus,2
+k60an,1
+template talk campaignbox seven years war european,1
+maravi,1
+flaithbertach ua néill,1
+junction ohio,1
+dave walter,1
+london transport board,1
+tuyuka,1
+the moodys,3
+noel,3
+eugen richter,1
+cowanshannock township armstrong county pennsylvania,1
+pre columbian gold museum,1
+lac demosson,1
+lincosamides,9
+the vegas connection,1
+stephen e harris,1
+alkali feldspar,2
+brant hansen,1
+draft carnatic music stub,4
+the chemicals between us,1
+blood and bravery,1
+san diego flash,3
+covert channel,5
+ernest w adams,1
+hills brothers coffee,1
+cosmic background explorer,4
+international union of pure and applied physics,2
+vladimir kramnik,21
+hinterland,2
+tinker bell and the legend of the neverbeast,5
+ophisops jerdonii,1
+fine gold,1
+net explosive quantity,3
+miss colorado teen usa,3
+royal philharmonic orchestra discography,1
+elyazid maddour,1
+matthew kelly,2
+templating language,1
+japan campaign,2
+barack obama on mass surveillance,2
+thomas r donahue,1
+old right,4
+spencer kimball,1
+golden kela awards,1
+blinn college,3
+w k simms,1
+quinto romano,1
+richard mulrooney,1
+mr backup z64,1
+monetization of us in kind food aid,1
+alex chilton,2
+propaganda in the peoples republic of china,4
+jiří skalák,8
+m5 stuart tank,1
+template talk ap defensive players of the year,1
+crisis,2
+azuchi momoyama period,1
+care and maintenance,2
+a$ap mob,3
+near field communication,111
+hips hips hooray,1
+promotional cd,1
+andean hairy armadillo,1
+trigueros del valle,1
+elmwood illinois,1
+cantonment florida,2
+margo t oge,1
+national park service,36
+monongalia county ballpark,3
+bakemonogatari,6
+felicia michaels,1
+institute of oriental studies of the russian academy of sciences,2
+economy of eritrea,2
+vincenzo chiarenza,1
+microelectronics,4
+fresno state bulldogs mens basketball,1
+maotou,1
+blokely,1
+duplicati,3
+goud,2
+niki reiser,1
+edward leonard ellington,1
+jaswant singh of marwar,1
+biharsharif,1
+dynasty /trackback/,1
+machrihanish,4
+jay steinberg,1
+peter luger steak house,3
+palookaville,1
+ferrari grand prix results,2
+bankruptcy discharge,2
+mike mccue,2
+nuestra belleza méxico 2013,2
+alex neal bullen,1
+gus macdonald baron macdonald of tradeston,2
+florida circuit court,1
+haarp,2
+v pudur block,1
+grocer,1
+shmuel hanavi,1
+isaqueena falls,2
+jean moulin university,1
+final fantasy collection,1
+template talk american frontier,1
+chex quest,4
+muslim students association,2
+marco pique,1
+jinja safari,1
+the collection,9
+urban districts of germany,5
+rajiv chilaka,1
+zion,2
+vf 32,1
+united states commission on civil rights,2
+zazam,1
+barnettas,4
+rebecca blasband,1
+lincoln village,1
+film soundtracks,1
+angus t jones,77
+snuppy,3
+w/indexphp,30
+file talk american world war ii senior military officials 1945jpeg,1
+worship leader,1
+ein qiniya,1
+buxton maine,1
+matt dewitt,1
+béla bollobás,3
+earlysville union church,1
+bae/mcdonnell douglas harrier ii gr9,1
+californian condor,2
+progressive enhancement,15
+its not my time,4
+ecw on tnn,2
+ihop,36
+aeronautical chart,1
+clique width,1
+fuengirola,8
+archicebus achilles,2
+comparison of alcopops,1
+carla anderson hills,1
+roanoke county virginia,2
+jaílson alves dos santos,1
+rameses revenge,1
+kaycee stroh,5
+les experts,1
+niels skousen,1
+apollo hoax theories,1
+mercedes w204,2
+enhanced mitigation experience toolkit,15
+bert barnes,1
+serializability,6
+ten plagues of egypt,1
+joe l brown,1
+category talk high importance chicago bears articles,1
+stephen caffrey,3
+european border surveillance system,2
+achytonix,1
+m2 machine gun,1
+gurieli,1
+kunefe,1
+m33 helmet,3
+little carmine,1
+smush,3
+josé horacio gómez,1
+product recall,1
+egger,1
+wisconsin highway 55,1
+harbledown,1
+low copy repeats,1
+curt gentry,1
+united colors of benetton,1
+adiabatic shear band,2
+pea galaxy,1
+where are you now,1
+dils,1
+surprise s1,1
+senate oceans caucus,2
+windsor new hampshire,1
+a hawk and a hacksaw,1
+i love it loud,2
+milbcom,1
+old world vulture,7
+camara v municipal court of city and county of san francisco,1
+ski dubai,1
+st cyprians school,2
+aibo,1
+ticker symbol,2
+hendrik houthakker,1
+shivering,5
+jacob arminius,1
+mowming,1
+panjiva,2
+namco libble rabble,5
+rudolph bing,1
+sindhi cap,2
+logician,1
+ford xa falcon,2
+the sunny side up show,1
+helen adams,2
+kharchin,1
+brittany maynard,13
+kim kyu jong,1
+messier 103,3
+leon boiler,1
+the rapeman,1
+twa flight 3,4
+leading ladies,1
+delta octantis,2
+qatari nationality law,1
+lionel cripps,1
+josé daniel carreño,1
+crypsotidia longicosta,1
+polish falcons,1
+highlands north gauteng,1
+the florida channel,1
+oreste barale,1
+ghazi of iraq,2
+charles grandison finney,4
+ahmet ali,1
+abbeytown,1
+caribou,3
+big two,2
+alien,14
+aslantaş dam,3
+theme of the traitor and the hero,1
+vladimir solovyov,1
+laguna ojo de liebre,1
+clive barton,1
+ebrahim daoud nonoo,1
+richard goodwin keats,2
+back to the who tour 51,1
+entertainmentwise,1
+ja preston,1
+john astin,19
+strict function,1
+cam ranh international airport,2
+gary pearson,1
+sven väth,8
+toad,6
+johnny pace,1
+hunt stockwell,1
+rolando schiavi,1
+claudia grassl,1
+oxford nova scotia,1
+maryland sheep and wool festival,1
+conquest of bread,1
+erevan,1
+comparison of islamic and jewish dietary laws,11
+sheila burnford,1
+estevan payan,1
+ocean butterflies international,7
+the royal winnipeg rifles,1
+green goblin in other media,2
+video gaming in japan,8
+church of the guanche people,4
+gustav hartlaub,2
+ian mcgeechan,4
+hammer and sickle,17
+konkiep river,1
+ceri richards,1
+decentralized,2
+depth psychology,3
+centennial parkway,1
+yugoslav monitor vardar,1
+battle of bobbili,2
+magnus iii of sweden,1
+england c national football team,2
+thuraakunu,1
+bab el ehr,1
+koi,1
+cully wilson,1
+money laundering,1
+stirling western australia,1
+jennifer dinoia,1
+eureka street,1
+message / call my name,1
+make in maharashtra,4
+huckleberry creek patrol cabin,1
+almost famous,5
+truck nuts,4
+vocus communications,1
+gikwik,1
+battle of bataan,4
+confluence pennsylvania,2
+islander 23,1
+mv skorpios ii,1
+single wire earth return,1
+politics of odisha,1
+crédit du nord,3
+piper methysticum,2
+coble,2
+kathleen a mattea,1
+coachella valley music and arts festival,50
+tooniverse,1
+spofforth castle,1
+arabian knight,2
+two airlines policy,1
+hinduja group,17
+swagg alabama,1
+portuguese profanity,1
+loomis gang,2
+nina veselova,2
+aegyrcitherium,1
+bees in paradise,1
+béládys anomaly,3
+badalte rishtey,1
+first bank fc,1
+cystoseira,1
+red book of endangered languages,1
+rose,6
+terry mcgurrin,3
+jason hawke,1
+peter chernin,1
+tu 204,1
+the man who walked alone,1
+tool grade steel,1
+wrist spin,1
+one step forward two steps back,1
+theodor boveri,1
+heunginjimun,1
+fama–french three factor model,34
+billy whitehurst,1
+rip it up,4
+red lorry yellow lorry,4
+nao tōyama,8
+general macarthur,1
+rabi oscillation,2
+devín,1
+olympus e 420,1
+hydra entertainment,1
+chris cheney,3
+rio all suite hotel and casino,3
+the death gate cycle,2
+fatima,1
+kamomioya shrine,1
+five nights at freddys 3,14
+the broom of the system,3
+robert blincoe,1
+history of wells fargo,9
+pinocytosis,4
+leaf phoenix,1
+wxmw,2
+tommy henriksen,13
+geri halliwell discography,2
+blade runneri have seen things you would not believe,1
+madhwa brahmins,1
+i/o ventures,1
+edorisi master ekhosuehi,2
+junior orange bowl,1
+khit,2
+sue jones,1
+immortalized,35
+city building series,4
+quran translation,1
+united states consulate,1
+dose response relationship,1
+caitriona,1
+colocolo,21
+medea class destroyer,1
+vaastav,1
+etc1,1
+john altoon,2
+thylacine,113
+cycling at the 1924 summer olympics,1
+margaret nagle,1
+superpower,57
+gülşen,1
+anthems to the welkin at dusk,4
+yerevan united fc,1
+the family fang,14
+domain,4
+high speed rail in india,14
+trifolium pratense,7
+florida mountains,2
+national city corp,5
+length of us participation in major wars,2
+acacia acanthoclada,1
+offas dyke path,2
+enduro,7
+howard center,1
+littlebits,4
+plácido domingo jr,1
+hookdale illinois,1
+the love language,1
+cupids arrows,1
+dc talk,7
+maesopsis eminii,1
+here comes goodbye,1
+freddie foreman,5
+marvel comics publishers,1
+consolidated city–county,5
+countess marianne bernadotte of wisborg,1
+los angeles baptist high school,1
+maglalatik,1
+deo,2
+meilichiu,1
+wade coleman,1
+monster soul,2
+julion alvarez,2
+platinum 166,1
+shark week,12
+hossbach memorandum,4
+jack c massey,3
+ardore,1
+philosopher king,5
+dynamic random access memory,5
+bronze age in southeastern europe,1
+tamil films of 2012,1
+nathalie cely,1
+italian capital,1
+optic tract,3
+shakti kumar,1
+who killed bruce lee,1
+parlement of brittany,3
+san juan national historic site,2
+livewell,2
+template talk om,1
+al bell,2
+pzl w 3 sokół,8
+durrës rail station,3
+david stubbs,1
+pharmacon,3
+railfan,7
+comics by country,2
+cullen baker,1
+maximum subarray problem,19
+outlaws and angels,1
+paradise falls,2
+mathias pogba,28
+donella meadows,4
+john leconte,2
+swaziland national football team,7
+gabriele detti,2
+if ever youre in my arms again,1
+christian basso,1
+helen shapiro,7
+taisha abelar,1
+fluid dynamics,1
+ernest wilberforce,1
+kocaeli university,2
+british m class submarine,1
+modern woodmen of america,1
+las posadas,3
+federal budget of germany,2
+liberation front of chad,1
+sandomierz,5
+ap italian language and culture,1
+manuel gonzález,1
+georgian military road,2
+clear creek county colorado,1
+matt clark,2
+test tube,18
+ak 47,1
+diège,1
+london school of economics+,1
+michael york,14
+half eagle,6
+strike force,1
+type 054 frigate,2
+sino indian relations,7
+fern,3
+louvencourt,1
+ghb receptor,2
+chondrolaryngoplasty,2
+andrew lewer,1
+ross king,1
+colpix records,1
+october 28,1
+tatsunori hara,1
+rossana lópez león,1
+haskell texas,3
+tower subway,2
+waspstrumental,1
+template talk nba anniversary teams,1
+george leo leech,1
+still nothing moves you,1
+blood cancer,3
+buffy lynne williams,1
+dpgc u know what im throwin up,1
+daniel nadler,1
+khalifa sankaré,2
+homo genus,1
+garðar thór cortes,3
+veyyil,1
+matt dodge,1
+hipponix subrufus,1
+anostraca,1
+hartshill park,1
+purple acid phosphatases,1
+austromyrtus dulcis,1
+shamirpet lake,1
+favila of asturias,2
+acute gastroenteritis,1
+dalton cache pleasant camp border crossing,1
+urobilinogen,13
+ss kawartha park,1
+professional chess association,1
+species extinction,1
+gapa hele bi sata,1
+phyllis lyon and del martin,1
+uk–us extradition treaty of 2003,1
+a woman killed with kindness,1
+how bizarre,1
+norm augustine,1
+geil,1
+volleyball at the 2015 southeast asian games,2
+jim ottaviani,1
+chekmagushevskiy district,1
+information search process,2
+queer,63
+william pidgeon,1
+amelia adamo,1
+nato ouvrage "g",1
+tamsin beaumont,1
+economy of syria,13
+douglas dc 8 20,1
+tama and friends,4
+pringles,22
+kannada grammar,7
+lotoja,1
+peony,1
+bmmi,1
+eurovision song contest 1992,11
+cerro blanco metro station,1
+sherlock the riddle of the crown jewels,4
+dorsa cato,1
+nkg2d,8
+specific heat,6
+nokia 6310i,2
+tergum,2
+bahai temple,1
+dal segno,5
+leigh chapman,2
+tupolev tu 144,60
+flight of ideas,1
+rita montaner,1
+vivien a schmidt,1
+battle of the treasury islands,2
+three kinds of evil destination,1
+richlite,1
+medinilla,2
+timeline of aids,1
+colin renfrew baron renfrew of kaimsthorn,2
+hélène rollès,1
+pedro winter,1
+sabine free state,1
+brzeg,1
+palisades park,1
+gas gangrene,11
+dotyk,2
+daniela kix,1
+canna,16
+property list,9
+john hamburg,1
+dunk island,5
+albreda,1
+scammed yankees,1
+wireball,3
+junior 4,1
+absolutely anything,15
+linux operating system,1
+solsbury hill,15
+notopholia,1
+scottish heraldry,2
+template talk paper data storage media,1
+category talk religion in ancient sparta,1
+category talk cancer deaths in puerto rico,1
+mid michigan community college,2
+tvb anniversary awards,1
+frederick taylor gates,1
+omoiyari yosan,3
+journal of the physical society of japan,1
+kings in the corner,2
+nungua,1
+amerika,4
+pacific marine environmental laboratory,1
+the thought exchange,1
+italian bee,5
+roma in spain,1
+sirinart,1
+crandon wisconsin,1
+shubnikov–de haas effect,6
+portrait of maria portinari,4
+colin mcmanus,1
+universal personal telecommunications,1
+royal docks,4
+brecon and radnorshire,3
+eilema caledonica,1
+chalon sur saône,8
+toyota grand hiace,1
+sophorose,1
+semirefined 2bwax,1
+mechanics institute chess club,1
+the culture high,2
+dont wake me up,1
+transcaucasian mole vole,1
+harry zvi tabor,1
+vhs assault rifle,1
+playing possum,2
+omar minaya,2
+private university,1
+yuki togashi,3
+ski free,2
+say no more,1
+diving at the 1999 summer universiade,1
+armando sosa peña,1
+timur tekkal,1
+jura elektroapparate,1
+pornographic magazine,1
+tukur yusuf buratai,1
+keep on moving,1
+laboulbeniomycetes,1
+chiropractor solve problems,1
+mark s allen,3
+committees of the european parliament,4
+blondie,7
+veblungsnes,1
+bank vault,10
+smiling irish eyes,1
+robert kalina,2
+polarization ellipse,2
+huntingdon priory,1
+energy in the united kingdom,34
+hamble,1
+raja sikander zaman,1
+perigea hippia,1
+college of liberal arts and sciences,1
+bootblock,1
+nato reporting names,2
+the serpentwar saga,1
+reformed churches in the netherlands,1
+collaborative document review,4
+combat mission beyond overlord,3
+vlra,2
+pat st john,1
+oceanid,5
+itapetinga,1
+insane championship wrestling,9
+nathaniel gorham,1
+estadio metropolitano de fútbol de lara,2
+william of saint amour,2
+new york drama critics circle award,1
+alliant rq 6 outrider,2
+ilsan,1
+top model po russki,1
+woolens,1
+rutledge minnesota,1
+joigny coach crash,2
+zhou enlai the last perfect revolutionary,1
+the theoretical minimum,1
+arrow security,1
+john shelton wilder,2
+jasdf,2
+katie may,2
+american jewish military history project,1
+business professionals of america,1
+questioned document examination,5
+motorola a760,1
+american steel & wire,1
+louis armstrong at the crescendo vol 1,1
+edward vernon,3
+maria taipaleenmäki,1
+margical history tour,2
+jar jar,1
+australian oxford dictionary,2
+revenue service,2
+odoardo farnese hereditary prince of parma,1
+weekend in new england,1
+laurence harbor new jersey,2
+aramark tower,1
+stealers wheel,1
+cephalon,1
+dawnguard,1
+saintsbury,2
+saint fuscien,1
+ryoko kuninaka,1
+farm to market road 1535,1
+alan kennedy,2
+esteban casagolda,1
+shin angyo onshi,1
+william gowland,1
+eastern religions,6
+kenny lala,1
+alphonso davies,1
+tadamasa hayashi,1
+meet the parents,2
+calvinist church,1
+ristorante paradiso,1
+jose joaquim champalimaud,1
+olis,1
+mill hill school,2
+lockroy,1
+battle of princeton,10
+cent,8
+brough superior ss80,1
+ras al khaima club,3
+washington international university,3
+bradley kasal,2
+miguel Ángel varvello,1
+oxygen permeability,1
+femoral circumflex artery,1
+golden sun dark dawn,4
+pusarla sindhu,1
+toyota winglet,1
+wind profiler,1
+montefiore medical center,2
+template talk guitar hero series,3
+little leaf linden,1
+ramana,4
+islam in the czech republic,2
+manuel vitorino,1
+joseph radetzky von radetz,3
+francois damiens,1
+parasite fighter,1
+friday night at st andrews,3
+hurbazum,1
+haidhausen,1
+petabox,2
+salmonella enteritidis,2
+matthew r denver,1
+de la salle,1
+anti terrorism act 2015,6
+brugsen,1
+mountain times,1
+columbia basin project,1
+common wallaroo,2
+clepsis brunneograpta,1
+red hot + dance,1
+mao fumei,1
+dark shrew,1
+coach,8
+come saturday morning,1
+aanmai thavarael,1
+hellenia,1
+donate life america,2
+plot of beauty and the beast toronto musical,1
+births in 1243,3
+main page/wiki/portal technology,8
+cambridgeshire archives and local studies,1
+big pines california,1
+pegasus in popular culture,4
+baron glendonbrook,1
+your face sounds familiar,5
+boom tube,2
+richard gough,8
+the new beginning in niigata,3
+american academy of health physics,1
+plain,9
+tushino airfield,1
+king george v coronation medal,1
+geologic overpressure,1
+seille,1
+calorimeter,25
+french civil service,1
+david l paterson,1
+chinese gunboat chung shan,2
+rhizobium inoculants,1
+wizard,4
+baghestan,1
+paustian house,2
+ellen pompeo,55
+damien williams,1
+tomoe tamiyasu,1
+acute epithelial keratitis,1
+casey abrams,8
+mendozite,1
+kantian ethics,2
+mcclure syndicate,1
+tokyo metro,6
+cuisine of guinea bissau,1
+mossberg 500,18
+mollie gillen,1
+above and beyond party,1
+joey carbone,1
+faulkner state community college,1
+tetsuya ishikawa,1
+electric flag,3
+meet the feebles,2
+kplm,1
+when we were twenty one,1
+horus bird,2
+youth in revolt,8
+spongebob squarepants revenge of the flying dutchman,3
+ehow,5
+nikos xydakis,2
+ziprasidone,19
+ulsan airport,1
+flechtingen,1
+dave christian,3
+delaware national guard,1
+skaria thomas,1
+iraca,1
+kkhi,2
+swimming at the 2015 world aquatics championships – mens 1500 metre freestyle,2
+crossing lines,37
+john du cane,1
+i8,1
+bauer pottery,1
+affinity sutton,4
+lotus 119,1
+uss arleigh burke,1
+palmar interossei,2
+nofx discography,4
+bwia west indies airways,3
+gopala ii,1
+north fork correctional facility,1
+szeged 2011,1
+milligram per cent,2
+halas and batchelor,1
+what the day owes the night,1
+sighișoara medieval festival,5
+scarning railway station,1
+cambridge hospital,1
+amnesia labyrinth,2
+cokie roberts,7
+savings identity,3
+pravia,1
+mcgrath,4
+pakistan boy scouts association,1
+dan carpenter,2
+marikina–infanta highway,2
+genetic analysis,2
+template talk ohio state university,1
+thomas chamberlain,4
+moe book,1
+coyote waits,1
+black protestant,1
+neetu singh,19
+mahmoud sarsak,1
+casa loma,28
+bedivere,8
+boundary park,2
+danger danger,14
+jennifer coolidge,49
+pop ya collar,1
+collaboration with the axis powers during world war ii,10
+greenskeepers,1
+the dukes children,1
+alaska off road warriors,1
+twenty five satang coin,1
+template talk private equity investors,2
+american red cross,24
+jason shepherd,1
+georgetown college,2
+ocean countess,1
+ammonium magnesium phosphate,1
+community supported agriculture,5
+philosophy of suicide,4
+yard ramp,2
+captain germany,1
+bob klapisch,1
+i will never let you down,2
+february 11,6
+ron dennis,13
+rancid,16
+the mall blackburn,1
+south high school,6
+charles allen culberson,1
+organizational behavior,66
+automatic route selection,1
+uss the sullivans,9
+yo no creo en los hombres,1
+janet,1
+serena armstrong jones viscountess linley,3
+louisiana–lafayette ragin cajuns mens basketball,1
+flower films,1
+michelle ellsworth,1
+norbertine rite,2
+spanish mump,1
+shah jahan,67
+fraser coast region,1
+matt cornwell,1
+nra,1
+crested butte mountain resort,1
+college football playoff national championship,2
+craig heaney,4
+devil weed,1
+satsuki sho,1
+jordaan brown,1
+little annie,4
+thiha htet aung,1
+the disreputable history of frankie landau banks,1
+mickey lewis,1
+eldar nizamutdinov,1
+m1825 forage cap,1
+antonina makarova,1
+mopani district municipality,2
+al jahra sc,1
+chaim topol,4
+tum saath ho jab apne,1
+piff the magic dragon,7
+imagining argentina,1
+ni 62,1
+phys rev lett,1
+the peoples political party,1
+casoto,1
+popular movement of the revolution,4
+huntingtown maryland,1
+la bohème,33
+khirbat al jawfa,1
+lycksele zoo,1
+deveti krug,2
+cuba at the 2000 summer olympics,2
+rose wilson,7
+sammy lee,2
+dave sheridan,10
+universal records,2
+antiquities trade,3
+shoveller,1
+tapered integration,1
+parker pen company,4
+mushahid hussain syed,1
+nynehead,1
+counter reformation,2
+nhl on nbc,11
+ronny rosenthal,2
+arsenie todiraş,3
+lobster random,1
+halliburton,37
+gordon county georgia,1
+belle isle florida,3
+molly stanton,3
+green crombec,1
+geodesist,2
+abd al rahman al sufi,4
+demography of japan,26
+live xxx tv,5
+naihanchi,1
+cofinite,1
+msnbot,5
+clausard,1
+mimidae,1
+wind direction,15
+irrational winding of a torus,1
+tursiops truncatus,1
+trustee,1
+lumacaftor/ivacaftor,2
+balancing lake,2
+shoe trees,1
+cycling at the 1928 summer olympics – mens team pursuit,1
+calponia harrisonfordi,1
+hindu rate of growth,1
+dee gordon,7
+passion white flag,2
+frog skin,1
+rudolf eucken,2
+bayantal govisümber,1
+christopher a iannella,1
+robert myers,1
+james simons,1
+meng xuenong,1
+abayomi olonisakin,1
+milton wynants,1
+cincinnatus powell,1
+atomic bomb band,1
+hopfield network,12
+jet pocket top must,1
+the state of the world,1
+welf i duke of bavaria,2
+american civil liberties union v national security agency,3
+elizabeth fedde,1
+librarything,2
+kim fletcher,1
+tracy island,2
+praise song for the day,1
+superstar,7
+ewen spencer,1
+back striped weasel,1
+cs concordia chiajna,1
+bruce curry,1
+malificent,1
+dr b r ambedkar university,2
+river plate,1
+desha county arkansas,1
+harare declaration,2
+patrick dehornoy,1
+paul alan cox,2
+auckland mounted rifles regiment,1
+mikoyan gurevich dis,3
+corn exchange manchester,2
+sharpshooter,1
+the new york times manga best sellers of 2013,1
+max perutz,2
+andrei makolov,1
+inazuma eleven saikyō gundan Ōga shūrai,2
+tatra 816,1
+ashwin sanghi,8
+pipestone township michigan,1
+craig shoemaker,1
+david bateson,1
+lew lehr,1
+crewe to manchester line,2
+samurai champloo,36
+tali ploskov,2
+janet sobel,3
+kabe station,1
+rippon,1
+alexander iii equestrian,1
+louban,2
+the twelfth night,1
+delaware state forest,1
+the amazing race china 3,1
+brillouins theorem,1
+extreme north,3
+super frelon,1
+george watsons,1
+mungo park,1
+workin together,3
+boy,12
+brownsville toros,1
+kim lim,1
+futsal,63
+motoring taxation in the united kingdom,1
+accelerator physics codes,1
+arytenoid cartilage,3
+the price of beauty,3
+life on the murder scene,2
+hydrophysa psyllalis,1
+jürgen brandt,2
+economic history association,2
+the sandwich girl,1
+heber macmahon,1
+volume 1 sound magic,2
+san francisco–oakland–hayward ca metropolitan statistical area,9
+harriet green,7
+tarnawa kolonia,1
+eur1 movement certificate,20
+anna nolan,2
+gulf of gökova,1
+havertown,2
+orlando scandrick,4
+doug owston correctional centre,1
+asterionella,4
+espostoa,1
+ranked voting system,10
+commercial law,39
+kirk,1
+mongolian cuisine,8
+turfanosuchus,1
+arthur anderson,4
+sven olof lindholm,1
+batherton,1
+dimetrodon,1
+pianos become the teeth,1
+united kingdom in the eurovision song contest 1976,1
+medieval,11
+it bites,1
+ion television,8
+seaboard system railroad,3
+sayan mountains,3
+musaffah,1
+charles de foucauld,3
+urgh a music war,1
+translit,1
+american revolutionary war/article from the 1911 encyclopedia part 1,1
+uss mauna kea,1
+powder burn,1
+bald faced hornet,9
+producer of the year,1
+the most wanted man,1
+clear history,8
+mikael lilius,1
+class invariant,4
+forever michael,3
+goofing off,3
+tower viewer,3
+claudiu marin,1
+nicolas cage,1
+waol,2
+s10 nbc respirator,2
+education outreach,1
+gyeongsan,2
+template talk saints2008draftpicks,1
+botaurus,1
+francis harper,1
+mauritanian general election 1971,1
+kirsty roper,2
+non steroidal anti inflammatory drug,17
+nearchus of elea,2
+resistance to antiviral drugs,1
+raghavendra rajkumar,5
+template talk cc sa/sandbox,1
+washington gubernatorial election 2012,2
+paul lovens,1
+express freighters australia,2
+bunny bleu,2
+osaka prefecture,2
+federal reserve bank of boston,4
+hacı ahmet,1
+underground chapter 1,10
+filippo simeoni,2
+the wonderful wizard of oz,3
+sailing away,1
+avelino gomez memorial award,1
+badger,65
+hongkou football stadium,3
+benjamin f cheatham,2
+fair isaac,2
+kwab,1
+al hank aaron award,3
+gender in dutch grammar,1
+idiom neutral,2
+da lata,1
+tuu languages,1
+derivations are used,1
+clete patterson,1
+danish folklore,4
+android app //orgwikipedia/http/enmwikipediaorg/wiki/westfield academy,1
+toto,8
+ea,1
+victory bond tour,1
+credai,2
+hérin,1
+st james louisiana,1
+necrolestes,2
+cable knit,1
+saunderstown,1
+us route 52 in ohio,1
+sailors rest tennessee,1
+adlai stevenson i,6
+miscibility,13
+help footnotes,13
+murrell belanger,1
+new holland pennsylvania,5
+haldanodon,1
+feminine psychology,2
+riot city wrestling,1
+mobile content management system,2
+zinio,1
+central differencing scheme,2
+enoch,2
+usp florence admax,1
+maester aemon,7
+norman "lechero" st john,1
+ice racing,1
+tiger cub economies,6
+klaipėda region,12
+wu qian,8
+malayalam films of 1987,1
+estadio nuevo la victoria,1
+nanotoxicology,2
+hot revolver,1
+nives ivankovic,1
+glen edward rogers,5
+epicene,3
+eochaid ailtlethan,1
+judiciary of finland,1
+en jersey,1
+statc,1
+atta kim,1
+mizi research,2
+acs applied materials & interfaces,1
+thank god youre here,9
+loneliness,8
+h e b plus,2
+corella bohol,1
+money in the bank,59
+golden circle air t bird,1
+flash forward,1
+category talk philippine television series by network,1
+dfmda,1
+the road to wellville,8
+ernst tüscher,1
+commission,14
+abdul rahman bin faisal,6
+oversea chinese banking corporation,7
+ray malavasi,1
+al qadisiyah fc,4
+anisfield wolf book award,1
+jacques van rees,1
+jakki tha motamouth,1
+scoop,1
+piti,2
+carlos reyes,1
+v o chidambaram pillai,6
+diamonds sparkle,1
+the great transformation,5
+cardston alberta temple,1
+la vendetta,1
+miyota nagano,1
+national shrine of st elizabeth ann seton,2
+chaotic,1
+breastfeeding and hiv,1
+friedemann schulz von thun,1
+mukhammas,2
+fishbowl worldwide media,1
+mohamed amin,3
+john densmore,10
+suryadevara nayaks,1
+metal gear solid peace walker,12
+ché café,2
+old growth,1
+lake view cemetery,1
+konigsberg class cruiser,1
+courts of law,1
+nova scotia peninsula,3
+jairam ramesh,4
+portal kerala/introduction,1
+edinburgh 50 000 – the final push,1
+ludachristmas,3
+motion blur,1
+deliberative process privilege,2
+bubblegram,1
+simon breach grenade,2
+tess henley,1
+gojinjo daiko,1
+common support aircraft,2
+zelda rubinstein,9
+yolanda kakabadse,1
+american studio woodturning movement,1
+richard carpenter,67
+vehicle door,3
+transmission system operator,9
+christa campbell,9
+marolles en brie,1
+korsholma castle,1
+murder of annie le,3
+kims,1
+zionist union,8
+portal current events/june 2004,2
+marination,8
+cap haïtien international airport,2
+fujima kansai,1
+vampire weekend discography,3
+moncton coliseum,2
+wing chair,1
+el laco,2
+castle fraser,1
+template talk greek political parties,1
+society finch,1
+chief executive officer,4
+battle of bloody run,3
+coat of arms of tunisia,2
+nishi kawaguchi station,1
+colonoscopy,30
+vic tayback,5
+lonnie mack discography,3
+yusuf salman yusuf,2
+marco simone,4
+saint just,1
+elizabeth taylor filmography,6
+haglöfs,2
+yunis al astal,1
+daymond john,36
+bedd y cawr hillfort,1
+durjoy datta,1
+wealtheow,1
+aaron mceneff,1
+culture in berlin,1
+temple of saturn,6
+nermin zolotić,1
+the darwin awards,1
+patricio pérez,1
+chris levine,1
+misanthropic,1
+dragster,2
+eldar,19
+chrzanowo gmina szelków,1
+zimmerberg base tunnel,6
+jakob schaffner,1
+california gubernatorial recall election 2003,1
+tommy moe,1
+bikrami calendar,1
+mama said,11
+hellenic armed forces,8
+candy box,3
+monstervision,3
+kachin independent army,1
+pro choice,1
+tshiluba language,1
+trucial states,9
+collana,1
+best music video short form,1
+pokémon +giratina+and+the+sky+warrior,1
+etteldorf,1
+academic grading in chile,2
+land and liberty,3
+australian bureau of meteorology,1
+cheoin gu,1
+william henry green,1
+ewsd,2
+gate of hell,1
+sioux falls regional airport,3
+nevelj zsenit,1
+bevo lebourveau,1
+ranjana ami ar asbona,1
+shaun fleming,1
+jean antoine siméon fort,1
+sports book,1
+vedran smailović,3
+simple harmonic motion,29
+wikipedia talk wikiproject film/archive 16,1
+princess jasmine,13
+great bustard,5
+allred unit,1
+cheng san,1
+mini paceman,1
+flavoprotein,2
+storage wars canada,3
+university rowing,2
+category talk wikiproject saskatchewan communities,1
+the washington sun,1
+rotary dial,6
+hailar district,1
+assistant secretary of the air force,2
+the décoration for the yellow house,5
+chris mclennan,1
+the cincinnati kid,4
+education in the republic of ireland,15
+steve brodie,2
+country club of detroit,1
+wazner,1
+portal spain,4
+senna,3
+william j bernd house,1
+balaji baji rao,8
+worth dying for,1
+cool ruler,1
+turn your lights down low,2
+mavroudis bougaidis,1
+national registry emergency medical technician,1
+james young,8
+eyewire,1
+dark matters twisted but true/,1
+josé pascual monzo,1
+german election 1928,2
+linton vassell,1
+convention on the participation of foreigners in public life at local level,1
+thorium fuel cycle,5
+honeybaby honeybaby,1
+golestan palace,3
+lombok international airport,11
+mainichi daily news,1
+k&p,1
+liberal network for latin america,1
+cádiz memorial,1
+grupo corripio,1
+elie and earlsferry,1
+isidore geoffroy saint hilaire,1
+al salmiya sc,2
+piano sonata hob xvi/33,1
+e f bleiler,1
+national register of historic places listings in york county virginia,3
+gupta empire,2
+german immigration to the united states,1
+through gates of splendor,2
+iap,1
+love takes wing,1
+tours de merle,1
+aleksey zelensky,1
+paul almond,2
+boston cambridge quincy ma nh metropolitan statistical area,1
+komiks presents dragonna,1
+princess victoire of france,1
+alan pownall,3
+tilak nagar,2
+lg life sciences co ltd,8
+before their eyes,1
+labor right,5
+michiko to hatchin,1
+susan p graber,1
+xii,1
+hanswulf,1
+symbol rate,17
+myo18b,2
+rowing at the 2010 asian games – mens coxed eight,1
+caspar weinberger jr,2
+bettle juice,1
+battle of the morannon,7
+darlington county south carolina,1
+mayfield pennsylvania,1
+ruwerrupt de mad,1
+luthfi assyaukanie,1
+fiat panda,30
+wickiup reservoir,1
+tanabe–sugano diagram,6
+alexander sacher masoch prize,1
+intracellular transport,1
+church of the val de grâce,1
+jebel ad dair,1
+rosalind e krauss,6
+cross origin resource sharing,97
+readiness to sacrifice,1
+creel terrazas family,1
+phase portrait,9
+subepithelial connective tissue graft,1
+lake malawi,18
+phillips & drew,1
+ernst vom rath,2
+infinitus,1
+geneva convention for the amelioration of the condition of the wounded and sick in armies in the field,2
+world heritage,1
+dole whip,8
+leveling effect,1
+bioship,3
+vanilloids,2
+superionic conductor,1
+basil bernstein,7
+armin b cremers,2
+szlichtyngowa,1
+beixinqiao station,1
+united states presidential election in utah 1980,1
+watson v united states,3
+willie mcgill,1
+melle belgium,1
+al majmaah,1
+mesolimbic dopamine pathway,1
+six flags new england,5
+acp,2
+geostrategy,2
+original folk blues,1
+wentworth military academy,1
+bromodichloromethane,3
+doublet,4
+tawfiq al rabiah,1
+sergej jakirović,1
+mako surgical corp,3
+empire of lies,1
+old southwest,1
+bay of arguin,1
+bringing up buddy,1
+mustapha hadji,7
+raymond kopa,7
+evil horde,1
+kettering england,1
+extravaganza,1
+christian labour party,2
+joice mujuru,6
+v,15
+le père,4
+my fathers dragon,2
+cumulus cloud,32
+fantasy on themes from mozarts figaro and don giovanni,1
+postpone indefinitely,1
+extreme point,1
+iraq–israel relations,1
+henry le scrope 3rd baron scrope of masham,1
+rating beer,1
+claude alvin villee jr,2
+clackamas town center,2
+roope latvala,4
+richard bethell 1st baron westbury,1
+ryan gosling,1
+yelina salas,1
+amicus,1
+cecilia bowes lyon countess of strathmore and kinghorne,6
+programming style,9
+now and then,9
+somethingawful,1
+nuka hiva campaign,1
+bostongurka,2
+jorge luis ochoa vázquez,1
+philip burton,1
+rainbow fish,7
+road kill,5
+christiane frenette,2
+as if,1
+paul ricard,1
+roberto dañino,1
+shoyu,1
+jakarta,96
+dean keith simonton,1
+mastocytosis,19
+hiroko yakushimaru,3
+problem of other minds,2
+jaunutis,1
+tfp deficiency,1
+access atlantech edutainment,1
+kristian thulesen dahl,1
+william wei,1
+andy san dimas,10
+kempten/allgäu,1
+augustus caesar,9
+conrad janis,1
+tugaya lanao del sur,1
+second generation antipsychotics,1
+anema e core,2
+sucking the 70s,1
+the czars,2
+vakulabharanam,1
+f double sharp,3
+prymnesin,1
+dick bavetta,2
+billy jones,3
+columbine,4
+file talk joseph bidenjpg,1
+mandelbrot set,79
+constant elasticity of variance model,2
+morris method,1
+al shamal stadium,5
+hes alright,1
+madurai massacre,1
+philip kwon,2
+christadelphians,7
+this man is dangerous,2
+kiowa creek community church,1
+pier paolo vergerio,1
+order of the most holy annunciation,2
+john plender,1
+vallée de joux,2
+graysby,1
+ludwig minkus,3
+potato aphid,1
+bánh bột chiên,1
+wilhelmstraße,1
+fee waybill,1
+designed to sell,1
+ironfall invasion,2
+lieutenant governor of the isle of man,1
+third reading,2
+eleanor roosevelt high school,1
+su zhe,1
+heat conductivity,1
+si satchanalai national park,1
+etale space,1
+faq,24
+low carbohydrate diet,1
+differentiation of integrals,1
+karl fogel,2
+tom chapman,3
+james gamble rogers,2
+jeff rector,1
+burkut,9
+joe robinson,1
+turtle flambeau flowage,1
+moves like jagger,3
+turbaco,1
+oghuz turk,2
+latent human error,5
+square number,17
+rugby football league championship third division,2
+altoona pennsylvania,23
+circus tent,1
+satirical novel,1
+claoxylon,1
+barbaros class frigate,4
+oyer and terminer,2
+telephone numbers in the bahamas,1
+thomas c krajeski,2
+mv glenachulish,1
+sports broadcasting contracts in australia,3
+car audio,1
+ted lewis,2
+eric bogosian/robotstxt,2
+furman university japanese garden,1
+jed clampett,2
+flintstone,2
+c of tranquility,2
+rutali,2
+berkhamsted place,1
+wissam ben yedder,13
+nt5e,1
+erol onaran,1
+allium amplectens,1
+the three musketeers,2
+north eastern alberta junior b hockey league,1
+doggie daddy,1
+lauma,1
+the love racket,1
+eta hoffman,1
+ryans four,3
+omerta – city of gangsters,1
+humberview secondary school,2
+parels,1
+the descent,1
+evgenia linetskaya,1
+manhunt international 1994,1
+american society of animal science,1
+american samoa national rugby union team,1
+faster faster,1
+all creatures great and small,1
+mama said knock you out,9
+rozhdestveno memorial estate,2
+wizard of odd,1
+lugalbanda,4
+beardsley minnesota,1
+the rogue prince,10
+uss escambia,1
+stormy weather,3
+couleurs sur paris,1
+madrigal,4
+colin tibbett,1
+lemelson–mit prize,2
+phonetical singing,1
+glucophage,3
+suetonius,10
+ungra,1
+black and white minstrel,1
+woolwich west by election 1975,1
+trolleybuses in wellington,2
+jason macdonald,3
+ussr state prize,2
+robert m anderson,1
+kichijōji,1
+apache kid wilderness,1
+sneaky pete,8
+edward knight,1
+fabiano santacroce,1
+hemendra kumar ray,1
+sweat therapy,1
+stewart onan,2
+israel–turkey relations,1
+natalie krill,5
+clinoporus biporosus,1
+kosmos 2470,2
+vladislav sendecki,1
+healthcare in madagascar,1
+template talk 2010 european ryder cup team,1
+richard lyons,1
+transfer of undertakings regs 2006,3
+image processor,3
+alvin wyckoff,1
+kōbō abe,1
+kettle valley rail trail,1
+my baby just cares for me,3
+u28,1
+western australia police,10
+scincidae,1
+partitionism,1
+glenmorangie distillery tour,1
+river cave,1
+szilárd tóth,1
+i dont want nobody to give me nothing,1
+city,67
+annabel dover,2
+placebo discography,8
+showbiz,8
+solio ranch,1
+loan,191
+morgan james,10
+international federation of film critics,3
+the frankenstones,2
+pastor bonus,1
+billy purvis,1
+the gunfighters,1
+sandefjord,2
+ohio wine,2
+for the love of a man,1
+drifters,10
+ilhéus,1
+bikini frankenstein,1
+subterranean homesick alien,1
+chemical nomenclature,17
+great wicomico river,1
+ingrid caven,1
+japanese destroyer takanami,1
+nosler partition,1
+wagaman northern territory,1
+slovak presidential election 2019,1
+fuggerei,12
+al hibah,1
+irish war of independence,2
+joan smallwood,1
+anthony j celebrezze jr,1
+mercedes benz m130 engine,2
+phineas and ferb,2
+belgium womens national football team,3
+reynevan,1
+joe,1
+alan wilson,1
+epha3,1
+belarus national handball team,1
+phaedra,14
+move,2
+amateur rocketry,3
+epizootic hemorrhagic disease,5
+prague derby,4
+basilica of st thérèse lisieux,1
+pompeianus,1
+solved game,3
+tramacet,19
+essar energy,3
+lumbar stenosis,1
+part,24
+hải vân tunnel,1
+vsm group,3
+walter hooper,2
+consumer needs,1
+bell helicopter,18
+launde abbey,2
+ramune,10
+declarations of war during world war ii,1
+saint laurent de la salanque,1
+balkenbrij,1
+balgheim,1
+out of the box,13
+cappella,1
+national pharmaceutical pricing authority,4
+friend and foe,1
+new democracy,1
+eastern phoebe,2
+isipum of geumgwan gaya,1
+tel quel,1
+traveler,12
+superbeast,1
+oddsac,1
+zamora spain,1
+declaration of state sovereignty of the russian soviet federative socialist republic,1
+chumash painted cave state historic park california,3
+zentiva,1
+british rail class 88,5
+west indies cricket board,3
+pauli jørgensen,1
+punisher kills the marvel universe,7
+william de percy,1
+vehicle production group,4
+uc irvine anteaters mens volleyball,2
+dong sik yoon,1
+hyæna,2
+canadian industries limited,1
+mr ii,1
+jim muhwezi,1
+citizen jane,2
+night and day concert,1
+double precision floating point format,2
+herbal liqueurs,1
+the fixed period,5
+pip/taz,1
+lesser caucasus,2
+uragasmanhandiya,2
+alternative words for british,2
+khuzaima qutbuddin,1
+helmut balderis,2
+wesley r edens,1
+scott sassa,4
+mutant mudds,3
+east krotz springs louisiana,1
+leonard frey,3
+counting sort,15
+leandro gonzález pírez,2
+shula marks,1
+sierville,1
+california commission on teacher credentialing,1
+raymond loewy,10
+beevor foundry,1
+dog snapper,2
+hitman contracts,5
+eduard herzog,1
+wittard nemesis of ragnarok,1
+cape may light,1
+al saunders,3
+distant earth,2
+beam of light,2
+arent we all?,1
+veridicality,1
+private enterprise,3
+rambhadracharya,3
+dps,5
+beckdorf,1
+rúaidhrí de valera,1
+vivian bang,3
+sugar pine,1
+vn parameswaran pillai,1
+henry ross perot sr,1
+the arcadian,1
+the record,6
+g turner howard iii,1
+oleksandr usyk,12
+mumbai suburban district,5
+vicente dutra,1
+paean,1
+scottish piping society of london,1
+ingot,11
+alex obrien,6
+autonomous counties of china,1
+kaleorid,1
+remix & repent,3
+gender performativity,7
+godheadsilo,1
+tonsilloliths,1
+la dawri,1
+kiran more,3
+billboard music award for woman of the year,1
+tahitian ukulele,1
+buick lacrosse,14
+draft helen milner jury sent home for the night,2
+history of japanese cuisine,6
+time tunnel,1
+albert odyssey 2,1
+oysters rockefeller,4
+jim mahon,1
+evolutionary invasion analysis,1
+sunk cost fallacy,3
+universidad de manila,1
+morgan crucible,1
+southern miss golden eagles football,2
+horatio alger,13
+biological psychopathology,1
+hollywood,115
+product manager,21
+thomas burgh 3rd baron burgh,1
+stan hack,1
+peloponesian war,1
+republic of china presidential election 2004,2
+sanitarium,4
+growthgate,1
+samuel e anderson,1
+bobo faulkner,1
+kaffebrenneriet,1
+monponsett pond seaplane base,1
+powers of horror,3
+viburnum burkwoodii,1
+new suez canal,5
+gerardo ortíz,2
+japhia life,1
+paul pastur,1
+fuller craft museum,1
+nomal valley,1
+inaugural address,1
+saint Étienne du vigan,1
+lip ribbon microphone,2
+mary cheney,2
+piebald,6
+kadambas,1
+transportation in omaha,7
+before the league,1
+feltham and heston by election 2011,1
+aboriginal music of canada,3
+dnssec,6
+sshtunnels,1
+robin benway,1
+swimming at the 1968 summer olympics – mens 4 x 200 metre freestyle relay,1
+commission internationale permanente pour lepreuve des armes à feu portatives,3
+death rock,1
+hugo junkers,6
+gmt,3
+keanu reeves,2
+beverly kansas,1
+charlotte blair parker,1
+kids,5
+weight bench,1
+kiasmos,8
+basque country autonomous basketball team,1
+gideon toury,2
+gugak/,1
+texass 32nd congressional district,2
+have you ever been lonely,1
+take the weather with you,1
+chukchi,1
+the magicians wife,1
+juan manuel bordeu,1
+port gaverne,1
+music for films iii,1
+northern edo masquerades,1
+hang gliding,15
+marine corps logistics base barstow,2
+century iii mall,1
+peter tarlow,1
+thermal hall effect,1
+david ogden stiers,18
+webmonkey,1
+five cereals,2
+osceola washington,1
+clover virginia,2
+sphinginae,2
+stuart brace,1
+al di meola discography,7
+sunflowers,1
+hasty generalization,4
+polish athletic association,1
+the purge 3,2
+bitetti combat mma 4,1
+hiroko nagata,2
+mona seilitz,1
+mixed member proportional representation,7
+rancho temecula,2
+sinai,1
+norrmalmstorg robbery,5
+silesian walls,1
+floyd stahl,1
+gary becker,1
+knowledge engineering,5
+port of mobile,1
+luckiest girl alive,2
+ilya rabinovich,1
+bridge,3
+el general,3
+cornerstone schools,1
+gozmo,1
+charles courtney curran,1
+broker,32
+us senate committee on banking housing and urban affairs,2
+retroversion of the sovereignty to the people,1
+giorgi baramidze,1
+lars grael,1
+abdul qadir,3
+pgrep,2
+category talk seasons in danish womens football,1
+malus sieversii,1
+god squad,4
+category of acts,1
+melkote,1
+linda langston,1
+sherry romanado,1
+montana sky,8
+history of burkina faso,1
+iso 639 kxu,1
+los angeles fire department museum and memorial,1
+recognize,1
+der bewegte mann,6
+davy pröpper,1
+outline of vehicles,2
+gesta francorum,1
+sidney w pink,1
+ronald pierce,1
+martin munkácsi,1
+nord noreg,1
+accounting rate of return,7
+urwerk,1
+albert gallo,1
+antennaria dioica,3
+transport in sudan,2
+fladry,1
+cumayeri,1
+bennington college,11
+pêro de alenquer,2
+sixth man,1
+william i of aquitaine,1
+radisson diamond,1
+belgian united nations command,1
+venus genetrix,1
+sayesha saigal,14
+inverse dynamics,2
+national constitutional assembly,1
+honey bear,4
+certosa di pavia,2
+selective breeding,31
+let your conscience be your guide,1
+han hyun jun,1
+closed loop,8
+template talk golf major championships master,1
+twin oaks community virginia,1
+red flag,3
+housing authority of new orleans,2
+joice heth,4
+toñito,1
+ivan pavlov,2
+madanapalle,4
+ptat,1
+renger van der zande,1
+anaerobic metabolism,2
+patrick osullivan,1
+shirakoya okuma,1
+permian high school,9
+thomas h ford,1
+southfield high school,1
+religion in kuwait,2
+nathrop colorado,1
+hefner hugh m,1
+whitney bashor,1
+pope shenouda iii of alexandria,7
+thomas henderson,1
+tokka and rahzar,13
+windows thumbnail cache,3
+consumer council for water,1
+sake bombs and happy endings,1
+lothlórien,1
+the space bar,4
+sakuma rail park,1
+oas albay,3
+dan frankel,1
+cliff hillegass,1
+iron sky,12
+pentile matrix family,1
+oregon system,1
+california sea lion,7
+jeanneau,2
+meadowhall interchange,1
+lille catholic university,1
+nuñomoral,1
+vending machine,30
+xarelto,1
+jonbenét ramsey,3
+progresso castelmaggiore,1
+tacticity,6
+wing arms,1
+gag,2
+hank greenberg,8
+garda síochána,14
+puggy,1
+p sainath,1
+the year of living dangerously,9
+army reserve components overseas training ribbon,1
+hmas nestor,1
+john beckwith,1
+florida constitution,2
+yonne,3
+benoît richaud,1
+mamilla pool,2
+gerald bull,14
+david halberstam,12
+my fair son,2
+ncaa division iii womens golf championships,1
+anniela,1
+king county,1
+kamil jankovský,1
+synaptic,3
+rab,6
+switched mode regulator,1
+history of biochemistry,1
+halaf,2
+henry colley,1
+co postcode area,3
+social finance uk,1
+cercospora,2
+the dao,1
+unité radicale,2
+shinji hashimoto,3
+tommy remengesau,3
+isobel gowdie,2
+mys prasad,9
+national palace museum of korea,1
+basílica del salvador,2
+no stone unturned,2
+walton group,1
+foramen ovale,1
+slavic neopaganism,1
+iowa county wisconsin,3
+melodi grand prix junior,1
+jarndyce and jarndyce,3
+talagunda,1
+nicholas of autrecourt,1
+substitution box,3
+the power of the daleks,1
+real gas,6
+edward w hincks,1
+kangxi dictionary,5
+natural world,1
+h h asquith,21
+francis steegmuller,1
+sasha roiz,3
+media manipulation,1
+looking for comedy in the muslim world,2
+bytown,4
+previsualization,1
+rita ora discography,11
+kiersey oklahoma,1
+henry greville 3rd earl of warwick,1
+draft,4
+phenolate,1
+i believe,1
+virologist,1
+relief in abstract,1
+eastern medical college,1
+purveyance,2
+ascending to infinity,2
+sportstime ohio,2
+church of wells,1
+ivory joe hunter,1
+wayne mcgregor,2
+luna 17,4
+viscount portman,2
+wikipedia talk wikipedia signpost/2009 07 27/technology report,1
+negramaro,1
+barking owl,2
+i need you,2
+brockway mountain drive,1
+template talk albatros aircraft,1
+future shock,11
+china national highway 317,1
+laurent gbagbo,7
+plum pudding model,18
+league of the rural people of finland,1
+dundees rising,1
+nikon f55,1
+olympic deaths,5
+gemma jones,19
+hafsa bint al hajj al rukuniyya,1
+personal child health record,1
+logic in computer science,11
+bhyve,3
+hothouse,1
+log house,6
+library of celsus,2
+the lizzie bennet diaries,1
+leave this town the b sides ep,1
+estimated time of arrival,8
+chariotry in ancient egypt,2
+american precision museum,1
+dimos moutsis,1
+scriptlet,1
+something in the wind,1
+sharka blue,1
+time on the cross the economics of american negro slavery,1
+tomislav kiš,1
+khalid islambouli,7
+bankruptcy abuse prevention and consumer protection act,7
+gračanica bosnia and herzegovina,2
+jungs theory of neurosis,5
+mgm animation,1
+soviet support for iran during the iran–iraq war,3
+native american,1
+template talk nigeria squad 1994 fifa world cup,1
+norwegian lutheran church,4
+adia barnes,1
+coatings,1
+mehdi hajizadeh,1
+the dead matter cemetery gates,1
+fuzzy little creatures,1
+waje,7
+anji,1
+heinz haber,1
+turkish albums chart,1
+sebastian steinberg,1
+price fixing cases,2
+bellator 48,1
+edgar r champlin,1
+otto hermann leopold heckmann,1
+bishops stortford fc,4
+stern–volmer relationship,6
+morgan quitno,2
+five star general,1
+iso 13406 2,1
+black prince,11
+leopard kung fu,1
+felix wong,5
+mary claire king,6
+alvar lidell,1
+playonline,1
+infantry branch,1
+andrew pattison,1
+john turmel,1
+kent,74
+edwin palmer hoyt,1
+captivity narratives,1
+jaguar xj220,1
+hms tanatside,2
+new faces,2
+edward levy lawson 1st baron burnham,1
+samuel woodfill,3
+jewish partisans,9
+abandonware,16
+early islamic philosophy,2
+sleeper cell,5
+media of africa,2
+san andreas,3
+luxuria,2
+egon hostovský,3
+pelagibacteraceae,1
+martin william currie,1
+borescope,21
+narratives of islamic origins the beginnings of islamic historical writing,1
+lecompton constitution,2
+axé bahia,2
+paul goodman,1
+template talk washington nationals roster navbox,1
+a saucerful of secrets,2
+david carol macdonnell mather,1
+portal buddhism,3
+florestópolis,1
+alecs+golf+ab,1
+bank alfalah,1
+frank pellegrino,3
+loutre,1
+erp4it,2
+monument to joe louis,2
+witch trial of nogaredo,1
+sabrina santiago,2
+no night so long,3
+helena carter,1
+renya mutaguchi,3
+yo yogi,4
+bolivarian alliance for the americas,3
+cooper boone,1
+uss iowa,24
+mitsuo iso,2
+cranberry,1
+batrachotomus,1
+richard lester,5
+bermudo pérez de traba,1
+rosser reeves ruby,1
+telecommunications in morocco,4
+i a richards,1
+nidhal guessoum,1
+lilliefors test,6
+the silenced,5
+mambilla plateau,1
+sociology of health and illness,3
+tereza chlebovská,2
+bismoll,3
+kim suna,1
+scream of the demon lover,1
+joan van ark,7
+intended nationally determined contributions,6
+dietary supplement,16
+last chance mining museum,1
+savoia marchetti s65,1
+if i can dream,1
+maharet and mekare,4
+nea anchialos national airport,2
+american journal of digestive diseases,1
+chance,2
+lockheed f 94c starfire,1
+the game game,1
+kuzey güney,3
+semmering base tunnel,1
+three mile island,1
+evaluation function,1
+robert mckee,4
+carmelo soria,1
+moneta nova,1
+pīnyīn,1
+international submarine band,3
+elections in the bahamas,5
+powell alabama,1
+kmgv,1
+charles stuart duke of kendal,2
+echo and narcissus,7
+trencrom hill,1
+ashwini dutt,1
+the herzegovina museum,1
+liverpool fc–manchester united fc rivalry,12
+kerber,1
+flakpanzer 38,8
+demographics of bihar,2
+rico reeds,1
+vandenberg afb space launch complex 3,1
+wiesendangen,1
+lamm,1
+allen doyle,2
+anusree,5
+broad spectrum,1
+bay middleton,2
+connect savannah,1
+history of immigration to canada,22
+waco fm,3
+nakano takeko,1
+murnau am staffelsee,2
+minarchy,1
+haymans dwarf epauletted fruit bat,1
+brachyglottis repanda,1
+associative,1
+mississippi aerial river transit,1
+stefano siragusa,2
+gregor the overlander,3
+marine raider,1
+pogorzans,1
+sportcity,2
+garancahua creek,1
+vincent dimartino,3
+ninja,2
+natural history museum of bern,1
+revolutionary catalonia,4
+chiayi,1
+alix strachey,3
+looe island,1
+college football usa 96,1
+off peak return,1
+minsk 1 airport,1
+evangelical lutheran church in burma,2
+riemann–roch theorem,1
+the comic strip,2
+vladimir istomin,1
+america again,2
+brown treecreeper,1
+american high school,1
+powerglide,2
+oolitic limestone,1
+daz1,1
+jarrow vikings,1
+pierre philippe thomire,1
+dorothy cadman,1
+gaston palewski,3
+twin river bridges,1
+im yours,1
+ambrose dudley 3rd earl of warwick,3
+ssim,2
+original hits,1
+cosmonaut,9
+special educational needs and disability act 2001,4
+will you speak this word,1
+history of wolverhampton wanderers fc,1
+don lawrence,1
+tokyo metropolitan museum of photography,1
+orduspor,1
+john lukacs,3
+patrice collazo,1
+lords resistance army insurgency,5
+ronald "slim" williams,5
+drivin for linemen 200,1
+nicolò da ponte,1
+bucky pope,1
+ewing miles brown,2
+ugly kid joe,28
+american flight 11,1
+louzouer,1
+district hospital agra,1
+jessica jane applegate,1
+sexuality educators,1
+serie a scandal of 2006,1
+at war with reality,1
+stephen wiltshire,13
+vechigen switzerland,1
+rikki clarke,3
+rayakottai,1
+permanent magnet electric motor,1
+qazi imdadul haq,1
+plywood,49
+ntr telugu desam party,1
+skin lightening,1
+royal natal national park,1
+uss mcdougal,2
+queen of the sun,1
+karanjachromene,1
+on 90,1
+enrique márquez,1
+siegfried and roy,1
+city manager,6
+wrdg,1
+why i am not a christian,3
+protein coding region,1
+royal bank of queensland gympie,1
+british invasions of the river plate,2
+yasufumi nakanoue,1
+magnetic man,1
+kickback,3
+tillandsia subg allardtia,1
+north american nr 349,1
+edict of amboise,1
+st andrew square edinburgh,2
+flag of washington,2
+timeless,2
+new york state route 125,3
+fudge,3
+single entry bookkeeping system,5
+refractive surgery,8
+bi monthly,1
+park high school stanmore,1
+norton anthology of english literature,1
+michael wines,1
+gaff rig,1
+kosmos 1793,1
+major facilitator superfamily,2
+talpur dynasty,1
+byron bradfute,1
+quercitello,1
+rcmp national protective security program,1
+ann kobayashi,1
+recurring saturday night live characters and sketches,3
+abraham hill,1
+nagapattinam district,4
+pidgeon,3
+mycalessos,1
+technical university of hamburg,1
+electric shock&ei=ahp0tbk0emvo gbe v2bbw&sa=x&oi=translate&ct=result&resnum=2&ved=0ceaq7gewaq&prev=/search?q=electric+shock&hl=da&biw=1024&bih=618&prmd=ivns,2
+aim 54 phoenix,18
+undercut,5
+gokhale memorial girls college,1
+digital penetration,19
+centre for peace studies tromsø,1
+richie williams,1
+walloon region,1
+albany city hall,2
+maxine carr,4
+anglosphere,18
+effect of world war i on children in the united states,1
+josh bell,1
+german thaya,1
+brian murphy,3
+marguerite countess of blessington,1
+leak,1
+bubble point,5
+international federation of human rights,1
+clubcorp,2
+greater philadelphia,1
+daniel albright,1
+macas,1
+roses,4
+woleu ntem,1
+shades of blue,1
+say aah,2
+curtiss sbc,1
+ion andone,1
+firstborn,1
+marringarr language,2
+ann e todd,1
+native american day,4
+stand my ground,1
+bavington,1
+classification of indigenous peoples of the americas,2
+always,6
+leola south dakota,1
+psycilicibin,2
+roy rogers,1
+marmalade,1
+national prize of the gdr,1
+shilp guru,1
+m2 e 50,1
+jorge majfud,2
+cutter and bone,1
+william steeves,1
+lisa swerling,2
+grace quigley,5
+telecommunications in yemen,1
+rarotonga international airport,7
+cycling at the 2010 central american and caribbean games,2
+mazda b3000,1
+hanwencun,1
+adurfrazgird,1
+ivan ivanov vano,1
+yhwh,1
+qarshi,4
+oshibori,2
+uppada,1
+iain clough,1
+painted desert,7
+tugzip,1
+my little pony fighting is magic,143
+pantheon,2
+chinese people in zambia,1
+yves saint laurent,3
+texas helicopter m79t jet wasp ii,1
+forever reign,1
+charlotte crosby,32
+ealdormen,9
+copper phosphate,2
+mean absolute difference,5
+hôtel de soubise,5
+josh rees,2
+non commissioned officer,70
+gb jones,1
+im feeling you,2
+book of shadows,9
+brain trauma,1
+sulpitius verulanus,1
+vikranth,5
+space adaptation syndrome,6
+united states presidential election in hawaii 1988,1
+joe garner,4
+river suir bridge,2
+the beach boys medley,1
+joyce castle,1
+christophe wargnier,1
+ik people,2
+sketch show,1
+buena vista police department,1
+file talk layzie bone clevelandjpg,1
+gillian osullivan,3
+prince albert of saxe coburg and gotha,2
+berean academy,1
+motorcraft quality parts 500,1
+frederick law olmsted,21
+born this way,9
+sterling virginia,4
+if wishes were horses beggars would ride,1
+section mark,1
+tapi,1
+navy cross,1
+housekeeper,1
+gian battista marino,1
+planá,1
+chiromantes haematocheir,1
+colonial life & accident insurance company,4
+aduana building,2
+kim johnston ulrich,1
+berkelium 254,1
+m&t bank corp,2
+sit up,1
+sheknows,1
+phantom lady,1
+bruce kamsinky,1
+commercial drive,1
+chinese people in the netherlands,1
+sylvia young theatre school,4
+influenza a virus subtype h2n3,1
+dracut,2
+nate webster,1
+vila velebita,1
+uaz patriot,4
+democratic unification party,1
+alexander slidell mackenzie,1
+portland mulino airport,1
+first person shooter,2
+the temporary widow,1
+terry austin,1
+the foremans treachery,1
+hms blenheim,1
+sodium dichloro s triazinetrione,1
+kurt becher,1
+cumberland gap tn,1
+newton cotes,1
+daphne guinness,6
+internal tide,1
+god and gender in hinduism,2
+howlin for you,1
+stellarator,14
+cavea,3
+faye ginsburg,1
+lady cop,3
+template talk yugoslavia squad 1986 fiba world championship,1
+solidarity economy,1
+second presidency of carlos andrés pérez,1
+bora bora,71
+xfs,1
+christina bonde,1
+agriculture in australia,20
+scenic drive,1
+richard mantell,1
+motordrome,1
+broadview hawks,1
+misty,2
+international bank of commerce,2
+istanbul sapphire,5
+changkat keruing,1
+the hotel inspector unseen,1
+tharwa australian capital territory,2
+strauss,2
+shock film,1
+ulick burke 1st marquess of clanricarde,2
+valencia cathedral,5
+kay bojesen,1
+palogneux,1
+texas beltway 8,1
+jackie walorski,7
+capital punishment in montana,1
+byte pair encoding,2
+upper deerfield township new jersey,2
+lucca comics & games,1
+lee chae young,1
+czar alexander ii,1
+kool ad,6
+leopold van limburg stirum,1
+john dunn,1
+policeman,2
+what dreams may come,3
+grant ginder,1
+chieverfueil,2
+long island express,1
+malmö sweden,2
+song for my father,1
+see saw,2
+jean jacques françois le barbier,5
+do rag,11
+dsb bank,2
+davical,6
+cervical cap,1
+gershon yankelewitz,1
+the last hurrah,4
+category talk educational institutions established in 1906,1
+tour pleyel,1
+león klimovsky,1
+phyoe phyoe aung,1
+phil sawyer,2
+android app //orgwikipedia/http/enmwikipediaorg/wiki/swiftkey,1
+deontological,3
+juan dixon,12
+robert pine,4
+alexander tilloch galt,2
+common tailorbird,12
+derailed,7
+mike campbell,3
+terminator 2 3 d battle across time,3
+technische universität münchen,4
+baloana,1
+echis leucogaster,1
+lahore pigeon,1
+william de beauchamp 9th earl of warwick,2
+erin go bragh,14
+economics u$a,1
+villafranca montes de oca,1
+pope eusebius,2
+martin kruskal,1
+félix de blochausen,1
+jeff jacoby,1
+mark krein,2
+travis wester,2
+fort louis de la louisiane,1
+weddingwire,2
+ping,54
+don swayze,8
+steve hamilton,3
+rhenish,1
+winrar,3
+births in 1561,4
+copyright law of the netherlands,2
+floodland,9
+tamil nadu tourism development corporation,1
+dolls house,1
+chkrootkit,1
+search for the hero,1
+avenal,1
+tini,2
+patamona,1
+aspendos international opera and ballet festival,2
+felix cora jr,5
+yellow cardinal,2
+antony jay,1
+conda,1
+a tramp shining,1
+william miller,1
+holomictic lake,2
+growler,2
+the violence of summer,1
+meerschaum,3
+cd138,1
+karl friedrich may,1
+history of iraq,2
+henry ford,139
+rumwold,1
+beatrice di tenda,1
+blaze,1
+nick corfield,1
+walt longmire,5
+eleazar maccabeus,1
+business edition,1
+karl oyston,4
+gypsy beats and balkan bangers,1
+fa premier league 2004 05,1
+agawan radar bomb scoring site,1
+the hall of the dead,1
+combat training centre,1
+moroccan portuguese conflicts,2
+pokipsy,1
+minor characters in csi crime scene investigation,1
+miguel molina,1
+buckypaper,2
+magazine,4
+forget about it,2
+marco schällibaum,1
+r d smith,1
+nfl playoff results,2
+four score,1
+centenary bank,2
+london borough of camden,12
+bhumij,1
+counter reformation/trackback/,1
+billy volek,1
+cover song,1
+awang bay,1
+douglas fitzgerald dowd,3
+architecture of ancient greece,5
+ny1,2
+academy award for best visual effects,3
+history of the mbta,2
+triangle group,1
+charles r fenwick,1
+berenice i of egypt,1
+window detector,1
+corruption perception index,1
+leffrinckoucke,1
+lee anna clark,1
+burndy,2
+inset day,2
+american association of motor vehicle administrators,1
+ckm matrix,1
+angiopoietin 1,1
+steven marsh,1
+open reading frame,27
+telesystems,1
+pastoral poetry,1
+west wycombe park,2
+lithium,7
+nogales international airport,1
+wajków,1
+sls 1,1
+trillo,2
+max s,1
+verndale,1
+yes sir i can boogie,1
+blog spam,10
+daniel veyt,1
+william brown,3
+takami yoshimoto,1
+josh greenberg,4
+geoffrey heyworth 1st baron heyworth,1
+medeina,3
+anja steinlechner,1
+riviera beach florida,2
+gerris wilkinson,1
+north american lutheran church,1
+paul dillett,11
+proto euphratean language,1
+best selling books,2
+pumpellyite,1
+business objects,1
+fodor,2
+xanadu,3
+london river,1
+draft juan de orduña,2
+barriemore barlow,3
+jew harp,1
+birmingham,1
+titus davis,1
+march 2012 gaza–israel clashes,1
+energy demand management,2
+aquarium of the americas,3
+tto,1
+l h c tippett,1
+optical fiber,88
+onești,2
+stanley ntagali,1
+prussian blue,1
+bill kovach,2
+hip pointer,3
+alessandra amoroso,4
+fleet racing,1
+navy maryland rivalry,1
+cornering force,1
+the mighty quest for epic loot,5
+katalyst,2
+the beef seeds,1
+shack out on 101,1
+aircraft carrier operations,1
+overseas province,2
+institute of state and law,1
+light truck,5
+plastics in the construction industry,2
+little zizou,2
+congenic,2
+adriaen van utrecht,1
+brian mcgrath,3
+parvati,1
+jason gwynne,1
+kphp,1
+miryusif mirbabayev,1
+kōriyama castle,3
+the making of a legend gone with the wind,2
+shot traps,1
+awa tag team championship,1
+littlebourne,2
+franchot tone,4
+john dudley 2nd earl of warwick,2
+mass spec,1
+final fantasy vi,44
+gerry ellis,1
+adon olam,3
+man 24310,1
+p n okeke ojiudu,1
+unqi,1
+snom,1
+bruce bagemihl,1
+category talk animals described in 1932,1
+metalist oblast sports complex,1
+colley harman scotland,1
+suka,1
+anita sarkeesian,81
+kazakhstan national under 17 football team,1
+ym,2
+matt barnes,1
+tour phare,1
+bellus–claisen rearrangement,2
+turkey at the 2012 summer olympics,1
+irréversible,32
+umbilical nonseverance,1
+wood stave,1
+indian pentecostal church of god,1
+camponotus nearcticus,3
+john tesh,13
+syncline,4
+skins,50
+kelsey manitoba,1
+alkayida,2
+polyglotism,17
+forensic statistics,2
+ram vilas sharma,8
+pearl jam,71
+dj max fever,1
+islamic view of miracles,5
+kds,1
+alabama cavefish,1
+johanna drucker,1
+tom wolk,4
+rottenburg,2
+goshen connecticut,2
+maker media,1
+morphett street adelaide,1
+keystone hotel,1
+baseball hall of fame balloting 2005,1
+gongzhuling south railway station,1
+ss charles bulfinch,1
+sig mkmo,1
+cartman finds love,2
+embassy of syria in washington dc,1
+charles prince of wales,175
+teachings of the prophet joseph smith,1
+charles iv,1
+alethea steven,1
+type i rifle,2
+a peter bailey,1
+brain cancer,1
+eric l clay,2
+jett bandy,1
+moro rebellion,9
+eustachów,1
+avianca el salvador,2
+dont stop the party,4
+reciprocal function,1
+dagmar damková,1
+hautmont,1
+penguin english dictionary,2
+waddie mitchell,1
+technician fourth grade,3
+hot girls in love,1
+critérium du dauphiné,59
+love song,2
+roger ii,2
+whitbread book award,1
+thomas colepeper 2nd baron colepeper,2
+a king and no king,1
+big fish & begonia,5
+mayville new york,2
+molecularity,1
+ed romero,1
+one watt initiative,3
+jeremy hellickson,2
+william morgan,1
+giammario piscitella,1
+eastern lesser bamboo lemur,1
+padre abad district,1
+don brodie,1
+facts on the ground,1
+undeniable evolution and the science of creation,1
+john of giscala,1
+bryce harper,45
+gabriela irimia,1
+empire earth mobile,1
+the queen vic,1
+helen rowland,1
+mixed nuts,5
+malacosteus niger,2
+george r r martin/a song of ice and fire,1
+brock osweiler,11
+tough,1
+outline of agriculture,4
+sea wolf,1
+mo vaughn,4
+the brood of erys,1
+composite unit training exercise,1
+isabella acres,4
+the jersey,5
+coal creek bridge,1
+habana libre,1
+nicole pulliam,1
+john shortland,1
+daniel pollen,1
+magic kit,1
+baruch adonai l&,1
+a daughters a daughter,2
+laughlin nevada,11
+tubercule,1
+louis laurie,1
+internet boom,3
+conversion of paul,1
+comparison of software calculators,1
+choctaw freedmen,2
+josh eady,1
+hôpital charles lemoyne,2
+u mobile,2
+john tomlinson,1
+baré esporte clube,2
+tuğçe güder,2
+highams park railway station,4
+newport east,1
+clothing industry,6
+scott rosenberg,6
+my 5 wives,2
+matt godfrey,1
+port ellen,2
+winecoff hotel fire,1
+fide world chess championship 2005,2
+lara piper,1
+the little mermaid,1
+foxmail,6
+penn lyon homes,1
+stockholm opera,1
+american journal of theology,1
+bernard gorcey,3
+rodger collins,1
+clarkeulia sepiaria,1
+korean era name,3
+melide ticino,1
+unknown to no one,1
+asilinae,1
+scânteia train accident,1
+parti de la liberté et de la justice sociale,1
+falkland islands sovereignty dispute,13
+castile,10
+french battleship flandre,1
+nils taube,1
+anisa haghdadi,1
+william tell told again,2
+magister,3
+zgc 7,1
+national agricultural cooperative marketing federation of india,3
+les bingaman,1
+chebfun,1
+portal current events/august 2014,2
+eparchy of oradea mare,1
+tempo and mode in evolution,2
+seili,1
+boniface,3
+supportersvereniging ajax,1
+support team,1
+lactometer,1
+twice as sweet,1
+spruce pine mining district,2
+banknotes of the east african shilling,1
+cerebral cortex,3
+tagalogs,1
+german diaspora,8
+grammelot,1
+max a,1
+category talk vienna culture,1
+cheung kong graduate school of business,1
+three certainties,1
+multani,3
+barry callebaut,15
+joanne mcneil,1
+z grill,4
+commonwealth of australia constitution act 1900,1
+ganzorigiin mandakhnaran,1
+peter h schultz,1
+ea pga tour,3
+scars & memories,1
+exodus from lydda,1
+states reorganisation act 1956,4
+guy brown,1
+horsebridge,1
+arthur mafokate,1
+aldus manutius,5
+american daylight,3
+jean chaufourier,2
+edmond de caillou,1
+hms iron duke,9
+displeased records,1
+quantum turing machine,3
+ncert textbook controversies,2
+dracs,1
+beyrouth governorate,1
+staphylococcus caprae,1
+tankard,2
+surfaid international,1
+hohenthurn,2
+mission x 41,1
+professional wrestling hall of fame,2
+george mountbatten 4th marquess of milford haven,2
+athletics at the 2012 summer paralympics womens club throw f31 32/51,1
+knots and crosses,1
+edge vector,1
+philippe arthuys,1
+baron raglan,1
+odell beckham jr,3
+elfriede geiringer,1
+hyflux,1
+author level metrics,2
+ieee fellow,1
+pori brigade,3
+polyphenol antioxidant,1
+the brothers,8
+kakaji Ōita,1
+shyam srinivasan,2
+shahid kapoor,88
+chuckie williams,1
+colonial,4
+roman spain,1
+convolvulus pluricaulis,1
+william j burns international detective agency,1
+accessibility for ontarians with disabilities act 2005,1
+linguist,1
+agonist,2
+xiaozi,1
+holker hall,1
+novatium,1
+alois jirásek,1
+lesser crested tern,1
+names of european cities in different languages z,1
+hydrogen cooled turbogenerator,2
+indian airlines flight 257,1
+united states attorney for the northern district of indiana,1
+this is us,11
+transaction capabilities application part,1
+culiacán,6
+hash based message authentication code,65
+heinz murach,1
+dual citizen,2
+zhizn’ za tsarya,1
+gabriel taborin technical school foundation inc,1
+deaths in july 1999,1
+aponi vi arizona,1
+amish in the city,2
+goodbye cruel world,1
+st augustine grass,10
+moesi,1
+violette leduc,3
+methyl formate,9
+you walk away,1
+the traveler,1
+bond,89
+moa cuba,3
+hebrew medicine,1
+women in the russian and soviet military,2
+help log,2
+cuillin,5
+back fire,14
+salesrepresentativesbiz,1
+hogsnort rupert,1
+dwarf minke whale,1
+embassy of albania ottawa,1
+cotai water jet,1
+st lucie county florida,8
+wesselman,1
+american indian art,1
+richard arkless,1
+trolleybuses in bergen,1
+vama buzăului,1
+far east movement,9
+threes a crowd,1
+insane,3
+linux technology center,4
+patty duke,24
+smuckers,1
+kapalua,1
+amf futsal world cup,5
+umes chandra college,1
+jnanappana,2
+bar bar bar,1
+beretta m951,2
+libertarian anarchism,1
+fart proudly,4
+peyton place,5
+phase detection autofocus,1
+cavalry in the american civil war,9
+class stratification,1
+battle of cockpit point,1
+regiment van heutsz,2
+ana rivas logan,1
+nenya,1
+westland wah 64 apache,1
+roslyn harbor new york,3
+august wilhelm von hofmann,1
+professional baseball,2
+douglas feith,1
+pogrom,21
+aušra kėdainiai,1
+pseudopeptidoglycan,4
+arquà petrarca,1
+wayampi,1
+conservative government 1866 1868,1
+world naked bike ride,28
+fruitvale oil field,2
+shuttle buran,1
+robert c pruyn,1
+totem,1
+megalotheca,1
+nkechi egbe,1
+james p comeford,1
+heavens memo pad,7
+cauca valley,1
+jungfraujoch railway station,2
+seo in guk,24
+bold for delphi,1
+multiple frames interface,1
+zhenli ye gon,6
+kyabram victoria,1
+two stars for peace solution,1
+couette flow,9
+new formalism,2
+template talk 1930s comedy film stub,1
+template talk scream,1
+joona toivio,4
+iaaf silver label road race,1
+super bowl xxviii,5
+i aint never,1
+paul little racing,1
+jacobite rising of 1715,3
+katherine archuleta,1
+programmable logic device,12
+footsteps of our fathers,2
+once upon a tour,1
+tauck,1
+budapest memorandum on security assurances,5
+prostitution in chad,2
+bebedouro,2
+vice,2
+madredeus,1
+p diddy,1
+princess alice of the united kingdom,20
+jerry hairston jr,1
+neo noir,3
+self evaluation motives,1
+relativity the special and the general theory,2
+the sign of four,3
+kevin deyoung,1
+robin long,1
+mokshaa helsa,1
+nagaon,1
+aniceto esquivel sáenz,1
+sda,2
+german battlecruiser gneisenau,1
+assisted reproductive technology,12
+cmmg,1
+vision of you,1
+keshia chanté discography,1
+biofuel in the united kingdom,1
+katinka ingabogovinanana,1
+hutt valley,1
+garwol dong,1
+tunceli province,3
+edwin bickerstaff,1
+halloween 3 awesomeland,1
+canadian records in track and field,1
+ubisoft são paulo,1
+midstream,16
+jethro tull,4
+childhoods end,55
+ss rohilla,1
+lagranges four square theorem,6
+bucky pizzarelli,3
+jannik bandowski,80
+guðni Ágústsson,1
+multidimensional probability distribution,1
+brno–tuřany airport,2
+broughtonia,5
+cold hands warm heart,1
+simone biles,32
+bf homes parañaque,2
+akaflieg köln ls11,3
+street fighter legacy,2
+beautiful kisses,1
+first modern olympics,1
+macbook air,1
+dublab,1
+silent night deadly night,6
+earth defense force 2025,2
+grant township carroll county iowa,1
+gary williams,1
+malmö aviation,1
+geographical pricing,2
+anaheim memorial medical center,1
+mary+mallon,1
+henry a byroade,1
+wawasan 2020,4
+eurovision dance contest,6
+lydia polgreen,1
+pilsen kansas,1
+colin sampson,1
+neelamegha perumal temple,1
+james bye,2
+canadian federation of agriculture,1
+f w de klerk,34
+bob casey jr,3
+northport east,1
+elian gonzalez affair,1
+aleksei bibik,1
+anthony dias blue,1
+pyaar ke side effects,4
+fusako kitashirakawa,1
+cal robertson,4
+shandong national cultural heritage list,1
+police story 3 super cop,5
+the third ingredient,3
+dean horrix,1
+pico el león,1
+cesar chavez street,1
+prospered,1
+children in cocoa production,5
+gervase helwys,1
+binary digit,1
+kovai sarala,4
+mathematics and music,1
+macroglossum,1
+f gary gray,21
+broadsoft,2
+cachan,4
+bukkake,21
+church of st margaret of scotland,1
+christopher cockerell,3
+amsterdam oud zuid,1
+county of bogong,1
+intel mobile communications,1
+the legend of white fang,1
+millwright,19
+will buckley,1
+bill jelen,2
+template talk san francisco 49ers coach navbox,1
+amalia garcía,1
+because he lives,1
+air charts,1
+stade edmond machtens,1
+henry stommel,1
+dxgi,1
+misr el makasa sc,1
+chad price,2
+carl henning wijkmark,1
+acanthogorgiidae,1
+diqduq,1
+prelog strain,2
+crispin the cross of lead,4
+avraham adan,2
+barbershop arranging,1
+free x tv,1
+eric guillot,1
+kht,1
+never a dull moment,1
+lwów school of mathematics,1
+sears centre,3
+chin state,6
+van halen 2007 2008 tour,1
+robert weinberg,3
+fierté montréal,2
+vince jack,1
+heikki kuula,1
+architecture of the republic of macedonia,1
+glossary of education terms,1
+aleksandra szwed,1
+military history of europe,3
+exeter central railway station,1
+staroselye,1
+lee thomas,7
+saint peters square,2
+romanization of hispania,2
+file talk dodecahedrongif,1
+signed and sealed in blood,8
+colleges of worcester consortium,1
+district electoral divisions,1
+galkot,1
+king África,3
+monetary policy,57
+brp ang pangulo,2
+battle of mạo khê,1
+air tube,1
+ruth ashton taylor,2
+keith jensen,1
+headland alabama,1
+willie loomis,1
+interactive data extraction and analysis,2
+georgetown city hall,2
+chuck es in love,2
+weeksville brooklyn,1
+anatoly sagalevich,2
+browett lindley & co,1
+barnawartha victoria,1
+pop,2
+black balance,2
+aceratorchis,1
+emmeline pethick lawrence baroness pethick lawrence,1
+osso buco,1
+herminie cadolle,2
+telegram & gazette,2
+le van hieu,1
+pine honey,2
+nexvax2,1
+leicester north railway station,1
+jacqueline foster,1
+bill handel,3
+nizami street,1
+radke,1
+bob mulder,1
+ambroise thomas,4
+carles puigdemont i casamajó,1
+callable bond,6
+tesco metro,2
+mohan dharia,1
+great hammerhead,12
+vinko coce,3
+john mayne,1
+cobb cloverleaf,1
+uhlan,10
+giulio migliaccio,1
+belmont university,6
+rinucumab,1
+kearny high school,1
+chūgen,1
+stages,2
+boar%27s head carol,1
+knight of the bath,1
+ayres thrush,7
+sing hallelujah,1
+the tender land,2
+wholesale banking,1
+jean jacques perrey,5
+maxime bossis,2
+sherman records,1
+alan osório da costa silva,1
+fannie willis johnson house,1
+blacks equation,2
+levinthals paradox,2
+thomas scully,2
+necron,3
+university of alberta school of business,5
+lake shetek,1
+toby maduot,1
+gavriil golovkin,1
+sweetwater,3
+atlantic revolutions,2
+jaime reyes (comics,1
+kajang by election 2014,1
+mycotoxigenic,1
+san marco altarpiece,2
+line impedance stabilization network,2
+santiago hernández,1
+jazzland,3
+host–guest chemistry,4
+giovanni florio,2
+st marylebone school,1
+acqua fragile,1
+the horse whisperer,10
+don francis,1
+mike molesevich,1
+brad wright,1
+north melbourne football club,3
+brady dragmire,1
+margaret snowling,2
+wing chun terms,4
+mckey sullivan,1
+derek ford,1
+cache bus,1
+bernie grant arts centre,2
+amata francisca,1
+sinha,2
+larissa loukianenko,1
+oceans apart&sa=u&ved=0ahukewjw4n6eqdblahun7gmkhxxebd8qfgg4mag&usg=afqjcnhhjagrbamjgaxc7rpsso4i9z jgw,1
+anemone heart,2
+alison mcinnes,1
+juan lindo,1
+mahesh bhupati,1
+baháí faith in taiwan,5
+cinema impero,1
+template talk rob thomas,1
+likin,1
+science & faith,1
+fort saint elmo,3
+delhi kumar,6
+juha lallukka,1
+situational sexual behavior,2
+milligan indiana,1
+william em lands,1
+karl anselm duke of urach,2
+hérold goulon,1
+vedic mathematics,20
+move to this,1
+koussan,1
+floored,1
+raghu nandan mandal,1
+angels gods secret agents,1
+orthogonal,2
+the little house on the prairie,1
+chilean pintail,1
+guardian angel,2
+st leonard maryland,1
+green parties in the united kingdom,1
+time to say goodbye,1
+alba michigan,2
+harbourfront centre,1
+corner tube boiler,1
+consensus government,1
+ppru 1,1
+corporate anniversary,4
+sazerac company,5
+kyle friend,1
+bmw k1100lt,1
+pergola marche,1
+commonwealth of kentucky,2
+taiwan passport,2
+clare quilty,1
+domenico caprioli,1
+frank m hull,1
+cheng sui,2
+nazi board games,3
+spark bridge,1
+derrick thomas,6
+wunnumin 1,1
+emotion remixed +,4
+brian howard dix,2
+brigalow queensland,2
+burgi dynasty,1
+apolonia supermercados,1
+brandon lafell,2
+one day,24
+nara period,9
+template talk the land before time,1
+assyrians in iraq,1
+trade union reform and employment rights act 1993,2
+template talk evansville crimson giants seasons,1
+boys be smile / 目覚めた朝にはきみが隣に,2
+kapuloan sundha kecil,1
+human impact of internet use,1
+kolkata metro line 2,3
+saint pardoux morterolles,1
+carfin grotto,2
+samuel johnson prize,3
+french royal family,1
+android app //orgwikipedia/http/enmwikipediaorg/wiki/victoria park,1
+mazda xedos 9,1
+măiestrit,1
+petroleum economist,2
+penetration,2
+adrian rawlins,8
+plutonium 239,11
+culture of montreal,1
+british germans,2
+warszawa wesoła railway station,1
+lorenzo di bonaventura,6
+military ranks of estonia,1
+uss flint,8
+arthur f defranzo,1
+sadeh,1
+jammu and kashmir,3
+igor budan,2
+charmila,2
+choi,1
+mohammed ali khan walajah,1
+sourabh varma,1
+after here through midland,1
+martyn day,1
+justin larouche,1
+illinoiss 6th congressional district,4
+jackson wy,1
+tyson apostol,4
+mitch morse,1
+robert davila,1
+canons regular of saint john cantius,1
+giant girdled lizard,2
+cascade volcanoes,5
+fools day,1
+cordyline indivisa,1
+pueraria,2
+swiss folklore,4
+meretz,3
+united states senate elections 1836 and 1837,1
+baby i need your love/ easy come easy go,1
+butrus al bustani,2
+the lion the lamb the man,1
+rushikulya,1
+brickworks,3
+alliance party of kenya,1
+ludlow college,1
+internationalism,11
+ernest halliwell,1
+constantine phipps 1st marquess of normanby,1
+kari ye bozorg,1
+signal flow,4
+i beam,1
+devils lake,1
+union of artists of the ussr,2
+index of saint kitts and nevis related articles,1
+ethernet physical layer,18
+dimensional analysis,16
+anatomical directions,2
+supreme court of guam,1
+sentul kuala lumpur,2
+ducefixion,1
+red breasted merganser,4
+reservation,3
+in the land of blood and honey,9
+kate spade,2
+albina airstrip,1
+kankakee,1
+servicelink,2
+castilleja levisecta,1
+tonmeister,2
+chanda sahib,1
+lists of patriarchs archbishops and bishops,1
+mach zehnder modulator,1
+giants causeway,79
+literal,7
+uss gerald r ford,1
+monster hunter portable 3rd,3
+bayern munich v norwich city,1
+banking industry,1
+prankton united,1
+st elmo w acosta,1
+speech disorder,9
+welcome to my dna,1
+nouriel roubini,6
+arthur kill,2
+bill grundy,7
+jake gyllenhaal,1
+world bowl 2000,1
+wnt7a,1
+pink flamingo,2
+tridentine calendar,1
+ray ratto,1
+f 88 voodoo,1
+super star,4
+ondřej havelka,1
+sophia dorothea of celle,12
+clavulina tepurumenga,1
+vampire bats,4
+ihsan,1
+ocotea foetens,1
+gannett inc,1
+kemira,4
+gre–nal,2
+farm bureau mutual,1
+pete fox,1
+let him have it,3
+backwoods home magazine,6
+te reo maori remixes,1
+hussain andaryas,1
+bagun sumbrai,1
+the westin paris – vendôme,4
+xochiquetzal,4
+players tour championship 2013/2014,1
+picnic,7
+josh elliott,5
+ernak,3
+gracias,1
+k280ff,1
+bandaranaike–chelvanayakam pact,1
+patrick baert,1
+nausicaä of the valley of the wind,33
+al jurisich,1
+twitter,230
+window,38
+the power hour,1
+duplex worm,1
+sonam bajwa,16
+baljit singh deo,1
+indian jews,1
+outline of madagascar,1
+outback 8,1
+dye fig,1
+british columbia recall and initiative referendum 1991,1
+felipe suau,1
+north perry ohio,1
+gilbeys gin,1
+philippe cavoret,1
+luděk pachman,1
+the it girl,1
+dragonnades,1
+rick debruhl,2
+xpath 20,2
+sean mcnulty,1
+william moser,1
+international centre for the settlement of investment disputes,1
+mendes napoli,2
+canadian rugby championship,1
+battle of maidstone,2
+boulevard theatre,2
+snow sheep,3
+penalty corner,1
+michael ricketts,5
+crocodile,2
+job safety analysis,5
+duffy antigen,1
+counties of virginia,1
+a place to bury strangers,5
+socialist workers’ party of iran,1
+wlw t,1
+core autosport,1
+west francia,10
+karen kilgariff,2
+pacific tsunami museum,1
+first avenue,1
+troubadour,1
+great podil fire,1
+chilean presidential referendum 1988,1
+pavol schmidt,1
+handguard,1
+crime without passion,1
+dio at donington uk live 1983 & 1987,1
+optic nerves,1
+wake forest school of medicine,1
+new jersey jewish news,2
+luke boden,2
+chris hicky,1
+beforu,2
+verch,1
+st roch,3
+civitas,1
+tmrevolution,3
+jamie spencer,1
+bond beam,1
+megan fox,4
+battle of bayan,1
+japan airlines flight 472,1
+yuen kay san,1
+the friendly ghost,1
+rice,14
+jack dellal,16
+lee ranaldo,9
+the overlanders,1
+earl castle stewart,5
+first down,1
+rheum maximowiczii,1
+washington state republican party,2
+ostwald bas rhin,1
+tennessee open,1
+kenneth kister,1
+ted kennedy,72
+preben elkjaer,1
+india reynolds,2
+santagata de goti,1
+henrietta churchill 2nd duchess of marlborough,1
+creteil,1
+ntt data,3
+zoot allures,4
+theatre of ancient greece,29
+bujinkan,6
+clube ferroviário da huíla,2
+nhn,4
+hp series 80,2
+interstate 15,4
+moszczanka,1
+lawnside school district,1
+virunga mountains,5
+hallway,1
+serb peoples radical party,1
+free dance,1
+mishawaka amphitheatre,1
+deerhead kansas,1
+utopiayile rajavu,1
+john w olver transit center,1
+futa tooro,1
+digoxigenin,5
+thomas schirrmacher,1
+twipra kingdom,1
+pulpwood,6
+think blue linux,1
+raho city taxi,1
+frederic remington art museum,1
+wajdi mouawad,1
+semi automatic firearm,12
+phyllis chase,1
+malden new york,1
+the aetiology of hysteria,2
+my maserati does 185,1
+friedrich wilhelm von jagow,1
+apne rang hazaar,1
+bór greater poland voivodeship,1
+india rubber,2
+bring your daughter to the slaughter,4
+yasser radwan,1
+kuala ketil,1
+notre dame de paris,1
+yuanjiang,1
+fengjuan,1
+tockenham,1
+transnistrian presidential election 1991,1
+gautami,28
+providenciales airport,1
+donald chumley,1
+middle finger,8
+calke abbey,4
+thou shalt not kill,1
+trail,7
+battle of dunkirk,43
+eyre yorke block,3
+mactan,3
+american ninja warrior,2
+nevel papperman,1
+ninja storm power rangers,1
+uss castle rock,1
+turcos,1
+philippine sea frontier,1
+irom chanu sharmila,7
+for the first time,2
+stian ringstad,1
+tréon,1
+hiro fujikake,1
+renewable energy in norway,4
+dedh ishqiya,18
+leucothoe,2
+ecmo,2
+knfm,1
+gangnam gu,1
+oadby town fc,1
+clamperl,2
+mummy cave,2
+kenneth d bailey,2
+peter freuchen,2
+dayanand bandodkar,2
+shawn crahan,16
+barbara trentham,2
+university of virginia school of nursing,1
+vöckla,1
+intuitive surgical inc,1
+cyncoed,4
+john l stevens,1
+daniel farabello,1
+trent harmon,5
+feroze gandhi unchahar thermal power station,1
+samuel powell,1
+pan slavic,1
+swimming at the 1992 summer olympics – womens 4 × 100 metre freestyle relay,1
+human behaviour,2
+siege of port royal,3
+eridug,1
+lafee,1
+north bethesda trail,1
+scheveningen system,1
+special penn thing,1
+pserimos,1
+pravda vítězí,1
+wiki dankowska,1
+transcript,13
+second inauguration of grover cleveland,1
+spent fuel,1
+ertms regional,2
+frederick scherger,1
+nivis,1
+herbert hugo menges,1
+kapitan sino,1
+samson,34
+minae mizumura,2
+gro kvinlog,1
+chasing shadows,2
+d j fontana,1
+massively multiplayer online game,27
+capture of new orleans,8
+meat puppet,1
+american pet products manufacturers association,3
+villardonnel,1
+sessile serrated adenoma,3
+patch products,1
+lodovico altieri,1
+portal,2
+jake maskall,4
+the shops at la cantera,8
+stage struck,5
+elizabeth m tamposi,2
+taylor swift,22
+forum spam,9
+barry cowdrill,3
+patagopteryx,2
+korg ms 2000,1
+hmas dubbo,2
+ss khaplang,2
+kevin kelly,1
+punk goes pop volume 5,3
+spurt,2
+bristol pound,5
+military history of finland during world war ii,10
+laguardia,1
+josé marcó del pont,1
+conditional expectation,18
+the beat goes on,1
+patricia buckley ebrey,1
+ali ibn yusuf,2
+caristii,1
+william l brandon,1
+fomite,5
+barcelona el prat airport,7
+mattequartier,4
+invading the sacred,1
+jefferson station,3
+chibalo,1
+phil voyles,1
+ramen,41
+archbishopric of athens,1
+robert arnot,1
+diethylhydroxylamine,2
+christian vazquez,1
+servage hosting,1
+ufo alien invasion,1
+blackburn railway station,3
+performance metric,19
+pencilings,1
+phosphoenolpyruvate,1
+under lights,2
+diego de la hoya,1
+felipe caicedo,5
+jimmy arguello,1
+cielo dalcamo,1
+jan navrátil,1
+linear pottery culture,9
+wbga,1
+k36dd,1
+die hard 2,22
+companding,8
+this is the modern world,10
+cosmology,26
+craig borten,1
+red pelicans,1
+ac gilbert,2
+fougasse,1
+leonardos robot,4
+john of whithorn,2
+david prescott barrows,2
+http cookie,168
+emilia telese,6
+herăstrău park,2
+lauro villar,1
+earl of lincoln,1
+born again,2
+milan rufus,1
+weper,2
+levitt bernstein,1
+jean de thevenot,1
+jill paton walsh,2
+leudal,1
+kyle mccafferty,1
+pluralistic walkthrough,2
+greetings to the new brunette,3
+angus maccoll,1
+loco live,2
+palm i705,1
+saila laakkonen,1
+ssta,1
+buch,1
+eduardo cunha,7
+marie bouliard,1
+mystic society,2
+chu jus house,1
+boob tube,8
+il mestiere della vita,1
+hadley fraser,7
+marek larwood,2
+imperial knight,2
+adbc,1
+houdini,8
+patrice talon,3
+iodamoeba,1
+long march,26
+nyinba,1
+maurice dunkley,1
+new south wales state election 1874–75,1
+john lee carroll,1
+poya bridge,1
+category talk military units and formations established in 2004,1
+the family values tour 1999,2
+brødrene hartmann,1
+miomelon,1
+john moran bailey,1
+san juan archipelago,1
+come as you are,7
+hypo niederösterreich,1
+saturn vi,2
+cherokee county kansas,1
+maher abu remeleh,1
+file talk jb grace singlejpg,1
+count paris,8
+template talk anime and manga,1
+kntv,4
+ganges river dolphin,4
+jerry pacht,1
+rapid response,1
+crunch bandicoot,1
+big gay love,2
+john mckay,1
+bareq,1
+nikon d2x,1
+intercontinental paris le grand hotel,1
+oakland alternative high school,1
+ekow eshun,1
+jimmy fortune,1
+american gladiator,2
+ella sophia armitage,1
+united we stand what more can i give,5
+maruti suzuki celerio,1
+geraldo rivera/trackback/,1
+dogs tobramycin contain a primary amine,1
+hot coffee mod,11
+shriners,25
+mora missouri,1
+seattle wa,1
+all star baseball 2003,1
+comparison of android e book reader software,7
+calling out loud,2
+initiative 912,1
+charles batchelor,2
+terry spraggan,2
+wallace thurman,2
+stefan smith,2
+george holding,22
+institute of business administration sukkar,1
+staten island new york,4
+valency,1
+chintamani taluk,1
+mahatma gandhi,1
+co orbital,1
+epex spot,1
+theodoric the great,3
+fk novi pazar,1
+zappas olympics,2
+gustav krupp von bohlen und halbach,1
+yasmany tomás,4
+notre temps,1
+cats %,1
+intramolecular vibrational energy redistribution,1
+graduate management admission test,49
+robin fleming,1
+daniel gadzhev,1
+achaean league,7
+the four books,1
+tunica people,1
+murray hurst,1
+hajipur,7
+wolfgang fischer,1
+bethel minnesota,2
+wincdemu,1
+aleksandar luković,5
+zilog,6
+will to live,1
+pgc,1
+captain sky,1
+eprobemide,1
+gunther plüschow,1
+jackson laboratory,3
+ss orontes,2
+bishop morlino,1
+eldorado air force station,2
+tin oxide,1
+john bell,2
+ajay banga,2
+nail polish remover induced contact dermatitis,1
+quinctia,1
+a/n urm 25d signal generator,1
+the art company,3
+seawind 300c,1
+half and half,7
+constantia czirenberg,1
+halifax county north carolina,4
+tunica vaginalis,9
+life & times of michael k,2
+methyl propionate,1
+carla bley band,1
+us secret service,2
+maría elena moyano,2
+lory meagher cup,9
+malay sultanate,1
+third lanark,1
+olivier dacourt,10
+angri,2
+ukrainian catholic eparchy of saints peter and paul,1
+phosphinooxazolines,1
+allied health professions,24
+hydroxybenzoic acid,1
+srinatha,3
+zone melting,5
+miko,1
+robert b downs,1
+resource management,3
+new year tree,1
+agraw imazighen,1
+catmando,8
+python ide,5
+rocky mount wilson roanoke rapids nc combined statistical area,1
+spanish crown,3
+ianis zicu,1
+william c hubbard,2
+islamic marital jurisprudence,5
+the school of night,1
+krdc,4
+el centro imperials,1
+atiq uz zaman,1
+sliba zkha,1
+file no mosquesvg,8
+herzegovinians,1
+paradise lost,1
+the fairly oddparents,6
+civic alliance,1
+anbu,3
+broadcaster,2
+le bon,1
+columbus nebraska,4
+inuit people,1
+the menace,6
+ilya ilyich mechnikov,1
+algonquin college,4
+seat córdoba wrc,1
+european route e30,6
+three lakes florida,1
+k10de,1
+glyphonyx rhopalacanthus,1
+ask rhod gilbert,1
+bolas criollas,1
+county borough of southport,1
+roll on mississippi,1
+pulitzer prize for photography,7
+mark fisher,1
+oakley g kelly,1
+tajikistani presidential election 1999,1
+the relapse,4
+nabil bentaleb,8
+apprentice,1
+dale brown,3
+studebaker packard hawk series,1
+yu gi oh trading card game,14
+paralimni,2
+institut national polytechnique de toulouse,1
+to catch a spy,1
+hammer,4
+mount judi,2
+thomas posey,1
+maxime baca,1
+arthur susskind,1
+elkins constructors,2
+siege of gaeta,1
+pemex,1
+henry o flipper award,1
+mccordsville indiana,1
+carife,1
+prima donna,1
+proton,1
+henry farrell,1
+randall davidson,1
+history of georgia,11
+beef tongue,4
+ted spread,4
+douglas xt 30,3
+heavenly mother,1
+monte santangelo,1
+lothar matthaus,1
+american party,2
+tire kingdom,1
+bastrop state park,3
+james maurice gavin,1
+blue bird all american,4
+time and a word,10
+runny babbit,1
+nordic regional airlines,6
+advanced scientifics,2
+the space traders,2
+mongol invasion of anatolia,1
+abu hayyan al gharnati,1
+lisa geoghan,3
+valentia harbour railway station,1
+silo,10
+jimmy zhingchak,1
+glamma kid,1
+bonneville high school,1
+secant line,5
+the longshots,2
+costa rican general election 1917,1
+an emotion away,1
+rawlins high school,1
+cold inflation pressure,4
+receptionthe,2
+tom payne,8
+tb treatment,1
+hatikvah,8
+ol yellow eyes is back,1
+vincent mroz,1
+travis bickle,1
+qatar stars league 1985–86,1
+electronic document management,1
+orliska,1
+gáspár orbán,1
+sunabeda,1
+donatus magnus,1
+lawrence e spivak,2
+cavalieri,1
+aw kuchler,1
+coat of arms of kuwait,1
+wallis–zieff–goldblatt syndrome,1
+doug heffernan,3
+g3 battlecruiser,3
+imran abbas,1
+plymouth,1
+gould colorado,1
+in japan,1
+delmar watson,1
+skygusty west virginia,1
+vesque sisters,1
+rushton triangular lodge,1
+italic font,3
+warner w hodgdon carolina 500,1
+blackamoors,5
+magna cum laude,14
+follow that horse,1
+jean snella,1
+chris frith,1
+soul power,2
+spare me the details,1
+ymer xhaferi,1
+murano glass,5
+michel magras,1
+rashard and wallace go to white castle,1
+venus figurines of malta,1
+didnt we almost have it all,1
+ew,1
+david h koch institute for integrative cancer research,2
+black coyote,1
+priob,2
+piera coppola,1
+budhism,4
+south african class h1 4 8 2t,1
+dimitris papamichael+dimitris+papamixail,3
+system sensor,1
+farragut class destroyer,1
+no down payment,1
+william rogers,1
+desperate choices to save my child,1
+joe launchbury,7
+queen seondeok of silla,11
+adams county wisconsin,1
+bandhan bank,1
+x ray tubes,1
+sporadic group,1
+lozovaya,1
+mairead maguire,3
+royal challengers bangalore in 2016,1
+janko of czarnków,1
+marosormenyes,1
+the deadly reclaim,1
+rick doblin,1
+gwen jorgensen,6
+shire of halls creek,1
+carlton house,6
+urad bean,1
+baton rouge louisiana,39
+kiel institute for the world economy,3
+the satuc cup,1
+harlem division,1
+argonaut,2
+choi jeongrye,2
+optical disc image,2
+groesbeek canadian war cemetery,2
+rangpur india,1
+android n,72
+tjeld class patrol boat,1
+together for yes,2
+tender dracula,1
+shane nelson,1
+palazzo ducale urbino,1
+angels,4
+double centralizer theorem,1
+homme,4
+world heart federation,1
+patricia ja lee,4
+a date with elvis,1
+saints row,1
+lanzhou lamian,1
+subcompact car,1
+jojo discography,5
+gary,18
+global returnable asset identifier,1
+aloysia weber,2
+emperor nero,2
+heavyweights,6
+hush records,1
+mewa textil service,2
+michigan gubernatorial election 1986,1
+solanine,9
+andré moritz,3
+foreign relations of china,12
+william t anderson,3
+lindquist field,1
+biggersdale hole,1
+manayunk/norristown line,1
+aliti,1
+budhivanta,3
+tm forum,4
+off plan property,1
+wu xin the monster killer,4
+aharon leib shteinman,1
+mark catano,1
+llanfihangel,1
+atp–adp translocase,4
+tótkomlós,1
+nikita magaloff,1
+xo telescope,1
+pseudomonas rhizosphaerae,1
+pccooler,1
+arcion therapeutics inc,8
+oklahoma gubernatorial election 2010,1
+seed treatment,3
+connecticut education network,1
+company85,1
+bryan molloy,1
+roupeiro,1
+wendt beach park,2
+entick v carrington,3
+firemens auxiliary,1
+shotcrete,14
+sepharial,1
+poet laureate of virginia,1
+musth,6
+dragon run state forest,3
+focal point,10
+pacific drilling,1
+intro,2
+priscus,1
+rokurō mochizuki,1
+bofur,2
+tiffany mount,1
+thanasis papazoglou,12
+life is grand,1
+ergersheim bas rhin,1
+medical reserve corps,3
+anthony ashley cooper 2nd earl of shaftesbury,1
+uefa euro 2012 group a,32
+america movil sab de cv,1
+christopher cook,1
+vladimir makanin,1
+file talk first battle of saratogausmaeduhistorygif,1
+dean foods,4
+logical thinking,1
+tychonic system,1
+hand washing,17
+bioresonance therapy,4
+günther burstyn,4
+religion in the united kingdom,35
+bancroft ontario,2
+alberta enterprise group,1
+belizean spanish,1
+minuscule 22,1
+hmga2,3
+sidama people,1
+shigeaki mori,2
+moonstars,1
+hazard,24
+chilis,6
+rango,3
+kenichi itō,1
+isle of rum,1
+shortwood united fc,1
+bronx gangs,1
+heterometaboly,2
+beagling,4
+jurgen pommerenke,1
+rockin,1
+st maria maggiore,1
+philipp reis,1
+timeboxing,12
+template talk tallahassee radio,1
+aarti puri,2
+john paul verree,2
+adam tomkins,1
+knoppers,1
+sven olov eriksson,1
+ruth bowyer,1
+höfðatorg tower 1,1
+citywire,3
+helen bosanquet,1
+ulex europaeus,4
+richard martyn,1
+hana sugisaki,2
+its all over now baby blue,6
+the myths and legends of king arthur and the knights of the round table,2
+dooce,1
+german submarine u 9,1
+george shearing,4
+bishop of winchester,3
+maximilian karl lamoral odonnell,2
+hec edmundson,1
+morgawr,3
+sovereign state,67
+avignon—la mitis—matane—matapédia,1
+duramax v8 engine,12
+villa rustica,2
+carl dorsey,1
+clairol,6
+abruzzo,22
+momsen lung,10
+m23 rebellion,2
+kira oreilly,1
+constitutive relation,2
+bifrontal craniotomy,1
+basilica of st nicholas amsterdam,2
+marinus kraus,1
+moog prodigy,2
+lucy hale,49
+lingiya,1
+idiopathic orbital inflammatory disease,3
+shaanxi youser group,1
+apeirohedron,1
+program of all inclusive care for the elderly,2
+tv3 ghana,3
+arnold schwarzenegger,338
+raquel carriedo tomás,1
+cincinnati playhouse in the park,2
+colobomata,2
+star craft 2,1
+yaaf,1
+fc santa clarita,1
+release me,3
+notts county supporters trust,1
+westchester airport,1
+slowhand at 70 – live at the royal albert hall,1
+bruce gray,2
+only the good die young,1
+sewell thomas stadium,1
+kyle cook,1
+northwest passage,1
+eurex airlines,1
+uss pierre,1
+feitsui dam,1
+sales force,1
+obrien class destroyer,5
+sant longowal institute of engineering and technology,3
+united states presidential election in oklahoma 1952,1
+edyta bartosiewicz,1
+marquess of dorset,1
+whiting wyoming,1
+akanda,1
+jim brewster,1
+mozdok republic of north ossetia alania,1
+maritime gendarmerie,2
+paresh patel,1
+communication art,1
+santa anita handicap,2
+dahlia,44
+qikpad,1
+pudhaiyal,3
+oroshi,1
+ioda,3
+willis j gertsch,1
+scurvy grass,1
+bombing of rotterdam,2
+gagarin russia,1
+dynamic apnea without fins,1
+loess,14
+hans adolf krebs,4
+poręby stare,1
+kismat ki baazi,1
+malcolm slesser,1
+blue crane route local municipality,1
+jean michel basquiat,104
+customs trade partnership against terrorism,3
+lower cove newfoundland and labrador,1
+aashiqui 2,6
+elliott lee,1
+edison electric light company,2
+i rigoberta menchú,1
+battle of tennōji,2
+transport workers union of america,1
+physical review b,1
+way too far,1
+breguet 941,1
+manuel hegen,1
+the blacklist,12
+john dorahy,4
+cinderella sanyu,1
+luis castañeda lossio,1
+headquarters of a military area,1
+jbala people,2
+petrofac emirates,1
+ins garuda,3
+australia national rugby league team,2
+state of emergency 2,3
+mexican sex comedy,2
+baby anikha,1
+notions,1
+android app //orgwikipedia/http/enmwikipediaorg/wiki/elasticity,1
+kissing you,2
+montearagón,1
+grzegorz proksa,3
+shook,1
+may hegglin anomaly,1
+chrysler rb engine,2
+gmcsf,2
+blacksburg,1
+chris hollod,1
+the new guy,1
+thulimbah queensland,1
+sust,1
+knight kadosh,2
+details,4
+nickel mining in new caledonia,3
+easter hotspot,1
+surinamese interior war,1
+field corn,2
+bolesław iii wrymouth,6
+lutwyche queensland,1
+michael campbell,1
+military ranks of turkey,3
+mícheal martin,1
+the architects dream,2
+joel robert,1
+thomas smith,1
+inclusion probability,1
+fucked company,1
+genderfluid,5
+lewisham by election 1891,1
+net promoter,98
+donald stewart,1
+xml base,2
+bhikhu parekh,4
+anthocharis cardamines,1
+vuosaari,1
+demographics of burundi,1
+dst,1
+david ensor,2
+mount pavlof,1
+vince young,5
+st beunos ignatian spirituality centre,4
+ezekiel 48,1
+lewis elliott chaze,1
+template talk croatia squad 2012 mens european water polo championship,1
+the voice of the philippines,4
+whites ferry,1
+cananga odorata,9
+man of steel,2
+john michael talbot,2
+superior oblique myokymia,2
+anisochilus,2
+e421,1
+midnight rider,14
+matrícula consular,1
+first nehru ministry,2
+christopher mcculloch,2
+ems chemie,12
+dominique martin,1
+university club of washington dc,1
+nurse education,5
+theyre coming to take me away ha haaa,1
+bill dauterive,4
+belhar,1
+heel and toe,4
+university of the arctic members,2
+mitava,1
+wjmx fm,1
+father callahan,4
+divine word academy of dagupan,1
+bogs,1
+denny heck,2
+church of st james valletta,1
+field cathedral of the polish army,1
+indian skimmer,1
+history of british airways,3
+international mobile subscriber identity,38
+suzel roche,1
+steven watt,1
+duke ellineton,1
+kirbys avalanche,4
diff --git a/tests/test_asyncio/testdata/will_play_text.csv.bz2 b/tests/test_asyncio/testdata/will_play_text.csv.bz2
new file mode 100755
index 0000000000000000000000000000000000000000..e3bec9de829086914c2f4e35f6ab38b750648b44
GIT binary patch
literal 2069623
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%0DX~4BL-)
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%0AjfCy*2N1KHx?BY
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%0AXkA5RQTc?Kg{x>~m+uP$W&f?^m%iBoI=h8se
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
Ak^lez

literal 0
HcmV?d00001


From 40fdb152641fcdf3be010cebe656331aa5709c2d Mon Sep 17 00:00:00 2001
From: Binbin <binloveplay1314@qq.com>
Date: Thu, 28 Apr 2022 19:17:25 +0800
Subject: [PATCH 0475/1164] Minor cleanups in commands/cluster.py (#2094)

---
 redis/commands/cluster.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index e4628dbaa2..aaddb6aee5 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -189,7 +189,7 @@ def replicaof(self, *args, **kwargs):
 
         For more information see https://redis.io/commands/replicaof
         """
-        raise RedisClusterException("REPLICAOF is not supported in cluster" " mode")
+        raise RedisClusterException("REPLICAOF is not supported in cluster mode")
 
     def swapdb(self, *args, **kwargs):
         """
@@ -197,7 +197,7 @@ def swapdb(self, *args, **kwargs):
 
         For more information see https://redis.io/commands/swapdb
         """
-        raise RedisClusterException("SWAPDB is not supported in cluster" " mode")
+        raise RedisClusterException("SWAPDB is not supported in cluster mode")
 
 
 class ClusterDataAccessCommands(DataAccessCommands):
@@ -310,7 +310,6 @@ class RedisClusterCommands(
     target specific nodes. By default, if target_nodes is not specified, the
     command will be executed on the default cluster node.
 
-
     :param :target_nodes: type can be one of the followings:
         - nodes flag: ALL_NODES, PRIMARIES, REPLICAS, RANDOM
         - 'ClusterNode'
@@ -323,7 +322,7 @@ class RedisClusterCommands(
 
     def cluster_myid(self, target_node):
         """
-        Returns the node’s id.
+        Returns the node's id.
 
         :target_node: 'ClusterNode'
             The node to execute the command on

From eea88da8b78e1c0e3c8403f8ae756a7716a4abc1 Mon Sep 17 00:00:00 2001
From: Jean Lopin <38790380+Ankhas@users.noreply.github.com>
Date: Mon, 2 May 2022 11:03:37 +0200
Subject: [PATCH 0476/1164] Rename 'update_supported_erros' to
 'update_supported_errors' in Retry module (#2144)

---
 redis/connection.py | 4 ++--
 redis/retry.py      | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/redis/connection.py b/redis/connection.py
index 0f97361e6e..ecbd32fc41 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -563,7 +563,7 @@ def __init__(
                 # deep-copy the Retry object as it is mutable
                 self.retry = copy.deepcopy(retry)
             # Update the retry's supported errors with the specified errors
-            self.retry.update_supported_erros(retry_on_error)
+            self.retry.update_supported_errors(retry_on_error)
         else:
             self.retry = Retry(NoBackoff(), 0)
         self.health_check_interval = health_check_interval
@@ -1099,7 +1099,7 @@ def __init__(
                 # deep-copy the Retry object as it is mutable
                 self.retry = copy.deepcopy(retry)
             # Update the retry's supported errors with the specified errors
-            self.retry.update_supported_erros(retry_on_error)
+            self.retry.update_supported_errors(retry_on_error)
         else:
             self.retry = Retry(NoBackoff(), 0)
         self.health_check_interval = health_check_interval
diff --git a/redis/retry.py b/redis/retry.py
index 57be971b4f..606443053e 100644
--- a/redis/retry.py
+++ b/redis/retry.py
@@ -24,7 +24,7 @@ def __init__(
         self._retries = retries
         self._supported_errors = supported_errors
 
-    def update_supported_erros(self, specified_errors: list):
+    def update_supported_errors(self, specified_errors: list):
         """
         Updates the supported errors with the specified error types
         """

From 09a52dba48221353eafa8188d73ab97e8f4ccc49 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 2 May 2022 12:03:56 +0300
Subject: [PATCH 0477/1164] Implemented LATENCY HISTOGRAM by always throwing
 NotImplementedError (#2147)

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/commands/core.py | 9 +++++++++
 tests/test_commands.py | 5 +++++
 2 files changed, 14 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index b52ddfeca4..ac1b6c78e4 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1064,6 +1064,15 @@ def memory_purge(self, **kwargs) -> ResponseT:
         """
         return self.execute_command("MEMORY PURGE", **kwargs)
 
+    def latency_histogram(self, *args):
+        """
+        This function throws a NotImplementedError since it is intentionally
+        not supported.
+        """
+        raise NotImplementedError(
+            "LATENCY HISTOGRAM is intentionally not implemented in the client."
+        )
+
     def ping(self, **kwargs) -> ResponseT:
         """
         Ping the Redis server
diff --git a/tests/test_commands.py b/tests/test_commands.py
index c8edd5774c..11c9939901 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -4458,6 +4458,11 @@ def test_memory_usage(self, r):
         r.set("foo", "bar")
         assert isinstance(r.memory_usage("foo"), int)
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_latency_histogram_not_implemented(self, r: redis.Redis):
+        with pytest.raises(NotImplementedError):
+            r.latency_histogram()
+
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("4.0.0")
     @skip_if_redis_enterprise()

From eca7075e33c48dc387bc8f3247e21a6997dd081d Mon Sep 17 00:00:00 2001
From: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Date: Mon, 2 May 2022 03:08:14 -0600
Subject: [PATCH 0478/1164] Fix incorrect return annotation in asyncio.lock
 (#2155)

NoReturn should be used only when the function never returns. In this case, the awaitable returns None if releasing the lock succeeds, so `Awaitable[None]` is right.

Noticed this while reviewing python/typeshed#7676
---
 redis/asyncio/lock.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/redis/asyncio/lock.py b/redis/asyncio/lock.py
index d4861329a0..fc7df373f1 100644
--- a/redis/asyncio/lock.py
+++ b/redis/asyncio/lock.py
@@ -3,7 +3,7 @@
 import threading
 import uuid
 from types import SimpleNamespace
-from typing import TYPE_CHECKING, Awaitable, NoReturn, Optional, Union
+from typing import TYPE_CHECKING, Awaitable, Optional, Union
 
 from redis.exceptions import LockError, LockNotOwnedError
 
@@ -243,7 +243,7 @@ async def owned(self) -> bool:
             stored_token = encoder.encode(stored_token)
         return self.local.token is not None and stored_token == self.local.token
 
-    def release(self) -> Awaitable[NoReturn]:
+    def release(self) -> Awaitable[None]:
         """Releases the already acquired lock"""
         expected_token = self.local.token
         if expected_token is None:
@@ -251,7 +251,7 @@ def release(self) -> Awaitable[NoReturn]:
         self.local.token = None
         return self.do_release(expected_token)
 
-    async def do_release(self, expected_token: bytes):
+    async def do_release(self, expected_token: bytes) -> None:
         if not bool(
             await self.lua_release(
                 keys=[self.name], args=[expected_token], client=self.redis

From 696d984a74ef6cd3e3968df8d11cf9af80057424 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 2 May 2022 12:17:56 +0300
Subject: [PATCH 0479/1164] Enable DEBUG and MODULE commands in redis 7 docker
 images (#2158)

---
 docker/redis7/master/redis.conf | 4 ++++
 1 file changed, 4 insertions(+)
 create mode 100644 docker/redis7/master/redis.conf

diff --git a/docker/redis7/master/redis.conf b/docker/redis7/master/redis.conf
new file mode 100644
index 0000000000..ef57c1fe99
--- /dev/null
+++ b/docker/redis7/master/redis.conf
@@ -0,0 +1,4 @@
+port 6379
+save ""
+enable-debug-command yes
+enable-module-command yes
\ No newline at end of file

From fdb9075745060e7a3633248fa6f419e895f010b7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Mon, 2 May 2022 09:25:34 +0000
Subject: [PATCH 0480/1164] Async Connection:  Allow `PubSub.run()` without
 previous `subscribe()` (#2148)

---
 redis/asyncio/client.py           | 15 +++++++++++---
 tests/test_asyncio/test_pubsub.py | 33 +++++++++++++++++++++++++++++++
 2 files changed, 45 insertions(+), 3 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 7689e120e3..8dde96e422 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -693,6 +693,15 @@ async def execute_command(self, *args: EncodableT):
         # legitimate message off the stack if the connection is already
         # subscribed to one or more channels
 
+        await self.connect()
+        connection = self.connection
+        kwargs = {"check_health": not self.subscribed}
+        await self._execute(connection, connection.send_command, *args, **kwargs)
+
+    async def connect(self):
+        """
+        Ensure that the PubSub is connected
+        """
         if self.connection is None:
             self.connection = await self.connection_pool.get_connection(
                 "pubsub", self.shard_hint
@@ -700,9 +709,8 @@ async def execute_command(self, *args: EncodableT):
             # register a callback that re-subscribes to any channels we
             # were listening to when we were disconnected
             self.connection.register_connect_callback(self.on_connect)
-        connection = self.connection
-        kwargs = {"check_health": not self.subscribed}
-        await self._execute(connection, connection.send_command, *args, **kwargs)
+        else:
+            await self.connection.connect()
 
     async def _disconnect_raise_connect(self, conn, error):
         """
@@ -962,6 +970,7 @@ async def run(
             if handler is None:
                 raise PubSubError(f"Pattern: '{pattern}' has no handler registered")
 
+        await self.connect()
         while True:
             try:
                 await self.get_message(
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index 9efcd3cf8a..f71ec7e04d 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -2,6 +2,7 @@
 import sys
 from typing import Optional
 
+import async_timeout
 import pytest
 
 if sys.version_info[0:2] == (3, 6):
@@ -658,3 +659,35 @@ def exception_handler_callback(e, pubsub) -> None:
             except asyncio.CancelledError:
                 pass
         assert str(e) == "error"
+
+    async def test_late_subscribe(self, r: redis.Redis):
+        def callback(message):
+            messages.put_nowait(message)
+
+        messages = asyncio.Queue()
+        p = r.pubsub()
+        task = asyncio.get_event_loop().create_task(p.run())
+        # wait until loop gets settled.  Add a subscription
+        await asyncio.sleep(0.1)
+        await p.subscribe(foo=callback)
+        # wait tof the subscribe to finish.  Cannot use _subscribe() because
+        # p.run() is already accepting messages
+        await asyncio.sleep(0.1)
+        await r.publish("foo", "bar")
+        message = None
+        try:
+            async with async_timeout.timeout(0.1):
+                message = await messages.get()
+        except asyncio.TimeoutError:
+            pass
+        task.cancel()
+        # we expect a cancelled error, not the Runtime error
+        # ("did you forget to call subscribe()"")
+        with pytest.raises(asyncio.CancelledError):
+            await task
+        assert message == {
+            "channel": b"foo",
+            "data": b"bar",
+            "pattern": None,
+            "type": "message",
+        }

From e1988c6c04ea53bda32db60441e3475e8e6c8e9a Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 3 May 2022 01:14:06 +0300
Subject: [PATCH 0481/1164] Add support for redis 7 streams features (#2157)

* xadd

* streams redis 7

* linters

* test xinfo stream

* test xinfo stream

* test xclaim
---
 redis/commands/core.py | 10 +++++++-
 tests/test_commands.py | 55 +++++++++++++++++++++++++++++++++++-------
 2 files changed, 55 insertions(+), 10 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index ac1b6c78e4..8bbcda3a69 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3505,6 +3505,7 @@ def xgroup_create(
         groupname: GroupT,
         id: StreamIdT = "$",
         mkstream: bool = False,
+        entries_read: Optional[int] = None,
     ) -> ResponseT:
         """
         Create a new consumer group associated with a stream.
@@ -3517,6 +3518,9 @@ def xgroup_create(
         pieces: list[EncodableT] = ["XGROUP CREATE", name, groupname, id]
         if mkstream:
             pieces.append(b"MKSTREAM")
+        if entries_read is not None:
+            pieces.extend(["ENTRIESREAD", entries_read])
+
         return self.execute_command(*pieces)
 
     def xgroup_delconsumer(
@@ -3572,6 +3576,7 @@ def xgroup_setid(
         name: KeyT,
         groupname: GroupT,
         id: StreamIdT,
+        entries_read: Optional[int] = None,
     ) -> ResponseT:
         """
         Set the consumer group last delivered ID to something else.
@@ -3581,7 +3586,10 @@ def xgroup_setid(
 
         For more information see https://redis.io/commands/xgroup-setid
         """
-        return self.execute_command("XGROUP SETID", name, groupname, id)
+        pieces = [name, groupname, id]
+        if entries_read is not None:
+            pieces.extend(["ENTRIESREAD", entries_read])
+        return self.execute_command("XGROUP SETID", *pieces)
 
     def xinfo_consumers(self, name: KeyT, groupname: GroupT) -> ResponseT:
         """
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 11c9939901..59754123ac 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -3735,6 +3735,13 @@ def test_xadd_minlen_and_limit(self, r):
         r.xadd(stream, {"foo": "bar"})
         assert r.xadd(stream, {"foo": "bar"}, approximate=True, minid=m3)
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_xadd_explicit_ms(self, r: redis.Redis):
+        stream = "stream"
+        message_id = r.xadd(stream, {"foo": "bar"}, "9999999999999999999-*")
+        ms = message_id[: message_id.index(b"-")]
+        assert ms == b"9999999999999999999"
+
     @skip_if_server_version_lt("6.2.0")
     def test_xautoclaim(self, r):
         stream = "stream"
@@ -3820,7 +3827,7 @@ def test_xclaim(self, r):
             == [message_id]
         )
 
-    @skip_if_server_version_lt("5.0.0")
+    @skip_if_server_version_lt("7.0.0")
     def test_xclaim_trimmed(self, r):
         # xclaim should not raise an exception if the item is not there
         stream = "stream"
@@ -3841,9 +3848,8 @@ def test_xclaim_trimmed(self, r):
         # xclaim them from consumer2
         # the item that is still in the stream should be returned
         item = r.xclaim(stream, group, "consumer2", 0, [sid1, sid2])
-        assert len(item) == 2
-        assert item[0] == (None, None)
-        assert item[1][0] == sid2
+        assert len(item) == 1
+        assert item[0][0] == sid2
 
     @skip_if_server_version_lt("5.0.0")
     def test_xdel(self, r):
@@ -3860,7 +3866,7 @@ def test_xdel(self, r):
         assert r.xdel(stream, m1) == 1
         assert r.xdel(stream, m2, m3) == 2
 
-    @skip_if_server_version_lt("5.0.0")
+    @skip_if_server_version_lt("7.0.0")
     def test_xgroup_create(self, r):
         # tests xgroup_create and xinfo_groups
         stream = "stream"
@@ -3877,11 +3883,13 @@ def test_xgroup_create(self, r):
                 "consumers": 0,
                 "pending": 0,
                 "last-delivered-id": b"0-0",
+                "entries-read": None,
+                "lag": 1,
             }
         ]
         assert r.xinfo_groups(stream) == expected
 
-    @skip_if_server_version_lt("5.0.0")
+    @skip_if_server_version_lt("7.0.0")
     def test_xgroup_create_mkstream(self, r):
         # tests xgroup_create and xinfo_groups
         stream = "stream"
@@ -3901,6 +3909,30 @@ def test_xgroup_create_mkstream(self, r):
                 "consumers": 0,
                 "pending": 0,
                 "last-delivered-id": b"0-0",
+                "entries-read": None,
+                "lag": 0,
+            }
+        ]
+        assert r.xinfo_groups(stream) == expected
+
+    @skip_if_server_version_lt("7.0.0")
+    def test_xgroup_create_entriesread(self, r: redis.Redis):
+        stream = "stream"
+        group = "group"
+        r.xadd(stream, {"foo": "bar"})
+
+        # no group is setup yet, no info to obtain
+        assert r.xinfo_groups(stream) == []
+
+        assert r.xgroup_create(stream, group, 0, entries_read=7)
+        expected = [
+            {
+                "name": group.encode(),
+                "consumers": 0,
+                "pending": 0,
+                "last-delivered-id": b"0-0",
+                "entries-read": 7,
+                "lag": -6,
             }
         ]
         assert r.xinfo_groups(stream) == expected
@@ -3951,7 +3983,7 @@ def test_xgroup_destroy(self, r):
         r.xgroup_create(stream, group, 0)
         assert r.xgroup_destroy(stream, group)
 
-    @skip_if_server_version_lt("5.0.0")
+    @skip_if_server_version_lt("7.0.0")
     def test_xgroup_setid(self, r):
         stream = "stream"
         group = "group"
@@ -3959,13 +3991,15 @@ def test_xgroup_setid(self, r):
 
         r.xgroup_create(stream, group, 0)
         # advance the last_delivered_id to the message_id
-        r.xgroup_setid(stream, group, message_id)
+        r.xgroup_setid(stream, group, message_id, entries_read=2)
         expected = [
             {
                 "name": group.encode(),
                 "consumers": 0,
                 "pending": 0,
                 "last-delivered-id": message_id,
+                "entries-read": 2,
+                "lag": -1,
             }
         ]
         assert r.xinfo_groups(stream) == expected
@@ -3995,7 +4029,7 @@ def test_xinfo_consumers(self, r):
         assert isinstance(info[1].pop("idle"), int)
         assert info == expected
 
-    @skip_if_server_version_lt("5.0.0")
+    @skip_if_server_version_lt("7.0.0")
     def test_xinfo_stream(self, r):
         stream = "stream"
         m1 = r.xadd(stream, {"foo": "bar"})
@@ -4005,6 +4039,9 @@ def test_xinfo_stream(self, r):
         assert info["length"] == 2
         assert info["first-entry"] == get_stream_message(r, stream, m1)
         assert info["last-entry"] == get_stream_message(r, stream, m2)
+        assert info["max-deleted-entry-id"] == b"0-0"
+        assert info["entries-added"] == 2
+        assert info["recorded-first-entry-id"] == m1
 
     @skip_if_server_version_lt("6.0.0")
     def test_xinfo_stream_full(self, r):

From 25cb4cb802bd10e4aca121a0b6a044e4eada096e Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 3 May 2022 01:22:30 +0300
Subject: [PATCH 0482/1164] adding caching, and removing 3.11 alpha (#2160)

Given that the CI runs of 3.11 cannot be exluded from the PR request list, it is effectively useless.

Once this issue https://github.com/actions/toolkit/issues/399 is resolved, we can re-enable.
---
 .github/workflows/integration.yaml | 15 +++------------
 1 file changed, 3 insertions(+), 12 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 53e6777082..59f6c7d322 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -25,6 +25,7 @@ jobs:
          uses: actions/setup-python@v3
          with:
            python-version: 3.9
+           cache: 'pip'
        - name: run code linters
          run: |
            pip install -r dev_requirements.txt
@@ -32,7 +33,6 @@ jobs:
 
    run-tests:
      runs-on: ubuntu-latest
-     continue-on-error: ${{ matrix.experimental }}
      timeout-minutes: 30
      strategy:
        max-parallel: 15
@@ -40,12 +40,6 @@ jobs:
          python-version: ['3.6', '3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
          test-type: ['standalone', 'cluster']
          connection-type: ['hiredis', 'plain']
-         experimental: [false]
-         include:
-           - python-version: 3.11.0-alpha.6
-             experimental: true
-             test-type: standalone
-             connection-type: plain
      env:
        ACTIONS_ALLOW_UNSECURE_COMMANDS: true
      name: Python ${{ matrix.python-version }} ${{matrix.test-type}}-${{matrix.connection-type}} tests
@@ -55,6 +49,7 @@ jobs:
          uses: actions/setup-python@v3
          with:
            python-version: ${{ matrix.python-version }}
+           cache: 'pip'
        - name: run tests
          run: |
            pip install -U setuptools wheel
@@ -83,22 +78,18 @@ jobs:
           bash .github/workflows/install_and_test.sh ${{ matrix.extension }}
 
    install_package_from_commit:
-    continue-on-error: ${{ matrix.experimental }}
     name: Install package from commit hash
     runs-on: ubuntu-latest
     strategy:
       matrix:
         python-version: ['3.6', '3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
-        experimental: [false]
-        include:
-          - python-version: 3.11.0-alpha.5
-          - experimental: true
     steps:
       - uses: actions/checkout@v2
       - name: install python ${{ matrix.python-version }}
         uses: actions/setup-python@v3
         with:
           python-version: ${{ matrix.python-version }}
+          cache: 'pip'
       - name: install from pip
         run: |
           pip install --quiet git+${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}.git@${GITHUB_SHA}

From fa7b3f6213625f248764b134ed2c82fcdba95d62 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 3 May 2022 10:55:57 +0300
Subject: [PATCH 0483/1164] skip graph.config test (#2163)

---
 tests/test_graph.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/tests/test_graph.py b/tests/test_graph.py
index 3a430ed4ab..76f8794c18 100644
--- a/tests/test_graph.py
+++ b/tests/test_graph.py
@@ -3,6 +3,7 @@
 from redis.commands.graph import Edge, Node, Path
 from redis.commands.graph.execution_plan import Operation
 from redis.exceptions import ResponseError
+from tests.conftest import skip_if_redis_enterprise
 
 
 @pytest.fixture
@@ -311,6 +312,7 @@ def test_profile(client):
 
 
 @pytest.mark.redismod
+@skip_if_redis_enterprise()
 def test_config(client):
     config_name = "RESULTSET_SIZE"
     config_value = 3

From 5c99e27459a047cd1334e1b87fb0623ac2c881db Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 3 May 2022 14:04:14 +0300
Subject: [PATCH 0484/1164] ACL SETUSER - add selectors and key based
 permissions (#2161)

* acl setuser

* async tests

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/client.py                     | 13 ++++++++++
 redis/commands/core.py              | 32 +++++++++++++++++++++---
 tests/test_asyncio/test_commands.py |  2 ++
 tests/test_commands.py              | 38 ++++++++++++++++++++++++++---
 4 files changed, 77 insertions(+), 8 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index e44f5abeb2..87c79913d3 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -580,6 +580,19 @@ def parse_acl_getuser(response, **options):
     data["flags"] = list(map(str_if_bytes, data["flags"]))
     data["passwords"] = list(map(str_if_bytes, data["passwords"]))
     data["commands"] = str_if_bytes(data["commands"])
+    if isinstance(data["keys"], str) or isinstance(data["keys"], bytes):
+        data["keys"] = list(str_if_bytes(data["keys"]).split(" "))
+    if data["keys"] == [""]:
+        data["keys"] = []
+    if "channels" in data:
+        if isinstance(data["channels"], str) or isinstance(data["channels"], bytes):
+            data["channels"] = list(str_if_bytes(data["channels"]).split(" "))
+        if data["channels"] == [""]:
+            data["channels"] = []
+    if "selectors" in data:
+        data["selectors"] = [
+            list(map(str_if_bytes, selector)) for selector in data["selectors"]
+        ]
 
     # split 'commands' into separate 'categories' and 'commands' lists
     commands, categories = [], []
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 8bbcda3a69..6526ef167a 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -186,9 +186,11 @@ def acl_setuser(
         nopass: bool = False,
         passwords: Union[str, Iterable[str], None] = None,
         hashed_passwords: Union[str, Iterable[str], None] = None,
-        categories: Union[Iterable[str], None] = None,
-        commands: Union[Iterable[str], None] = None,
-        keys: Union[Iterable[KeyT], None] = None,
+        categories: Optional[Iterable[str]] = None,
+        commands: Optional[Iterable[str]] = None,
+        keys: Optional[Iterable[KeyT]] = None,
+        channels: Optional[Iterable[ChannelT]] = None,
+        selectors: Optional[Iterable[Tuple[str, KeyT]]] = None,
         reset: bool = False,
         reset_keys: bool = False,
         reset_passwords: bool = False,
@@ -342,7 +344,29 @@ def acl_setuser(
         if keys:
             for key in keys:
                 key = encoder.encode(key)
-                pieces.append(b"~%s" % key)
+                if not key.startswith(b"%") and not key.startswith(b"~"):
+                    key = b"~%s" % key
+                pieces.append(key)
+
+        if channels:
+            for channel in channels:
+                channel = encoder.encode(channel)
+                pieces.append(b"&%s" % channel)
+
+        if selectors:
+            for cmd, key in selectors:
+                cmd = encoder.encode(cmd)
+                if not cmd.startswith(b"+") and not cmd.startswith(b"-"):
+                    raise DataError(
+                        f'Command "{encoder.decode(cmd, force=True)}" '
+                        'must be prefixed with "+" or "-"'
+                    )
+
+                key = encoder.encode(key)
+                if not key.startswith(b"%") and not key.startswith(b"~"):
+                    key = b"~%s" % key
+
+                pieces.append(b"(%s %s)" % (cmd, key))
 
         return self.execute_command("ACL SETUSER", *pieces, **kwargs)
 
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 78220406eb..dee8755a17 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -109,6 +109,7 @@ async def test_acl_genpass(self, r: redis.Redis):
         assert isinstance(password, str)
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_gte("7.0.0")
     async def test_acl_getuser_setuser(self, r: redis.Redis, request, event_loop):
         username = "redis-py-user"
 
@@ -224,6 +225,7 @@ def teardown():
         assert len((await r.acl_getuser(username))["passwords"]) == 1
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
+    @skip_if_server_version_gte("7.0.0")
     async def test_acl_list(self, r: redis.Redis, request, event_loop):
         username = "redis-py-user"
 
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 59754123ac..b7287b4fea 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -120,8 +120,14 @@ def test_acl_cat_with_category(self, r):
 
     @skip_if_server_version_lt("7.0.0")
     @skip_if_redis_enterprise()
-    def test_acl_dryrun(self, r):
+    def test_acl_dryrun(self, r, request):
         username = "redis-py-user"
+
+        def teardown():
+            r.acl_deluser(username)
+
+        request.addfinalizer(teardown)
+
         r.acl_setuser(
             username,
             keys=["*"],
@@ -171,7 +177,7 @@ def test_acl_genpass(self, r):
         r.acl_genpass(555)
         assert isinstance(password, str)
 
-    @skip_if_server_version_lt("6.0.0")
+    @skip_if_server_version_lt("7.0.0")
     @skip_if_redis_enterprise()
     def test_acl_getuser_setuser(self, r, request):
         username = "redis-py-user"
@@ -217,7 +223,7 @@ def teardown():
         assert set(acl["commands"]) == {"+get", "+mget", "-hset"}
         assert acl["enabled"] is True
         assert "on" in acl["flags"]
-        assert set(acl["keys"]) == {b"cache:*", b"objects:*"}
+        assert set(acl["keys"]) == {"~cache:*", "~objects:*"}
         assert len(acl["passwords"]) == 2
 
         # test reset=False keeps existing ACL and applies new ACL on top
@@ -243,7 +249,7 @@ def teardown():
         assert set(acl["commands"]) == {"+get", "+mget"}
         assert acl["enabled"] is True
         assert "on" in acl["flags"]
-        assert set(acl["keys"]) == {b"cache:*", b"objects:*"}
+        assert set(acl["keys"]) == {"~cache:*", "~objects:*"}
         assert len(acl["passwords"]) == 2
 
         # test removal of passwords
@@ -278,6 +284,30 @@ def teardown():
         )
         assert len(r.acl_getuser(username)["passwords"]) == 1
 
+        # test selectors
+        assert r.acl_setuser(
+            username,
+            enabled=True,
+            reset=True,
+            passwords=["+pass1", "+pass2"],
+            categories=["+set", "+@hash", "-geo"],
+            commands=["+get", "+mget", "-hset"],
+            keys=["cache:*", "objects:*"],
+            channels=["message:*"],
+            selectors=[("+set", "%W~app*")],
+        )
+        acl = r.acl_getuser(username)
+        assert set(acl["categories"]) == {"-@all", "+@set", "+@hash"}
+        assert set(acl["commands"]) == {"+get", "+mget", "-hset"}
+        assert acl["enabled"] is True
+        assert "on" in acl["flags"]
+        assert set(acl["keys"]) == {"~cache:*", "~objects:*"}
+        assert len(acl["passwords"]) == 2
+        assert set(acl["channels"]) == {"&message:*"}
+        assert acl["selectors"] == [
+            ["commands", "-@all +set", "keys", "%W~app*", "channels", ""]
+        ]
+
     @skip_if_server_version_lt("6.0.0")
     def test_acl_help(self, r):
         res = r.acl_help()

From 963843b4379eced5ab20d0682f24438962e9eb0f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Sun, 8 May 2022 11:55:55 +0000
Subject: [PATCH 0485/1164] Add unittest for PubSub.connect() (#2167)

* Add unittest for PubSub reconnect

* fix linting
---
 tests/test_asyncio/test_pubsub.py | 82 +++++++++++++++++++++++++++++++
 1 file changed, 82 insertions(+)

diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index f71ec7e04d..4037040f7c 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -1,4 +1,5 @@
 import asyncio
+import functools
 import sys
 from typing import Optional
 
@@ -20,6 +21,18 @@
 pytestmark = pytest.mark.asyncio(forbid_global_loop=True)
 
 
+def with_timeout(t):
+    def wrapper(corofunc):
+        @functools.wraps(corofunc)
+        async def run(*args, **kwargs):
+            async with async_timeout.timeout(t):
+                return await corofunc(*args, **kwargs)
+
+        return run
+
+    return wrapper
+
+
 async def wait_for_message(pubsub, timeout=0.1, ignore_subscribe_messages=False):
     now = asyncio.get_event_loop().time()
     timeout = now + timeout
@@ -603,6 +616,75 @@ async def test_get_message_with_timeout_returns_none(self, r: redis.Redis):
         assert await p.get_message(timeout=0.01) is None
 
 
+@pytest.mark.onlynoncluster
+class TestPubSubReconnect:
+    # @pytest.mark.xfail
+    @with_timeout(2)
+    async def test_reconnect_listen(self, r: redis.Redis):
+        """
+        Test that a loop processing PubSub messages can survive
+        a disconnect, by issuing a connect() call.
+        """
+        messages = asyncio.Queue()
+        pubsub = r.pubsub()
+        interrupt = False
+
+        async def loop():
+            # must make sure the task exits
+            async with async_timeout.timeout(2):
+                nonlocal interrupt
+                await pubsub.subscribe("foo")
+                while True:
+                    # print("loop")
+                    try:
+                        try:
+                            await pubsub.connect()
+                            await loop_step()
+                            # print("succ")
+                        except redis.ConnectionError:
+                            await asyncio.sleep(0.1)
+                    except asyncio.CancelledError:
+                        # we use a cancel to interrupt the "listen"
+                        # when we perform a disconnect
+                        # print("cancel", interrupt)
+                        if interrupt:
+                            interrupt = False
+                        else:
+                            raise
+
+        async def loop_step():
+            # get a single message via listen()
+            async for message in pubsub.listen():
+                await messages.put(message)
+                break
+
+        task = asyncio.get_event_loop().create_task(loop())
+        # get the initial connect message
+        async with async_timeout.timeout(1):
+            message = await messages.get()
+        assert message == {
+            "channel": b"foo",
+            "data": 1,
+            "pattern": None,
+            "type": "subscribe",
+        }
+        # now, disconnect the connection.
+        await pubsub.connection.disconnect()
+        interrupt = True
+        task.cancel()  # interrupt the listen call
+        # await another auto-connect message
+        message = await messages.get()
+        assert message == {
+            "channel": b"foo",
+            "data": 1,
+            "pattern": None,
+            "type": "subscribe",
+        }
+        task.cancel()
+        with pytest.raises(asyncio.CancelledError):
+            await task
+
+
 @pytest.mark.onlynoncluster
 class TestPubSubRun:
     async def _subscribe(self, p, *args, **kwargs):

From c25be04d6468163d31908774ed358d3fd6bc0a39 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Sun, 8 May 2022 12:03:52 +0000
Subject: [PATCH 0486/1164] Replace OSError exceptions from `can_read` with
 `redis.ConnectionError` (#2140)

* Replace OSError exceptions from `can_read` with `redis.ConnectionError`

* Fix formatting

* Revert unintended formatting change
---
 redis/asyncio/connection.py | 8 +++++++-
 redis/connection.py         | 8 +++++++-
 2 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index f0e6d3da4f..91961ba674 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -911,7 +911,13 @@ async def can_read(self, timeout: float = 0):
         """Poll the socket to see if there's data that can be read."""
         if not self.is_connected:
             await self.connect()
-        return await self._parser.can_read(timeout)
+        try:
+            return await self._parser.can_read(timeout)
+        except OSError as e:
+            await self.disconnect()
+            raise ConnectionError(
+                f"Error while reading from {self.host}:{self.port}: {e.args}"
+            )
 
     async def read_response(self, disable_decoding: bool = False):
         """Read the response from a previously sent command"""
diff --git a/redis/connection.py b/redis/connection.py
index ecbd32fc41..e0dcfc6323 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -808,7 +808,13 @@ def can_read(self, timeout=0):
         sock = self._sock
         if not sock:
             self.connect()
-        return self._parser.can_read(timeout)
+        try:
+            return self._parser.can_read(timeout)
+        except OSError as e:
+            self.disconnect()
+            raise ConnectionError(
+                f"Error while reading from {self.host}:{self.port}: {e.args}"
+            )
 
     def read_response(self, disable_decoding=False):
         """Read the response from a previously sent command"""

From 061d97abe21d3a8ce9738330cabf771dd05c8dc1 Mon Sep 17 00:00:00 2001
From: Utkarsh Gupta <utkarshgupta137@gmail.com>
Date: Sun, 8 May 2022 17:34:20 +0530
Subject: [PATCH 0487/1164] Add Async RedisCluster (#2099)

* Copy Cluster Client, Commands, Commands Parser, Tests for asyncio

* Async Cluster Tests: Async/Await

* Add Async RedisCluster

* cluster: use ERRORS_ALLOW_RETRY from self.__class__

* async_cluster: rework redis_connection, initialize, & close

- move redis_connection from NodesManager to ClusterNode & handle all related logic in ClusterNode class
- use Locks while initializing or closing
- in case of error, close connections instead of instantly reinitializing
- create ResourceWarning instead of manually deleting client object
- use asyncio.gather to run commands/initialize/close in parallel

- inline single use functions
- fix test_acl_log for py3.6

* async_cluster: add types

* async_cluster: add docs

* docs: update sphinx & add sphinx_autodoc_typehints

* async_cluster: move TargetNodesT to cluster module

* async_cluster/commands: inherit commands from sync class if possible

* async_cluster: add benchmark script with aredis & aioredis-cluster

* async_cluster: remove logging

* async_cluster: inline functions

* async_cluster: manage Connection instead of Redis Client

* async_cluster/commands: optimize parser

* async_cluster: use ensure_future & generators for gather

* async_conn: optimize

* async_cluster: optimize determine_slot

* async_cluster: optimize determine_nodes

* async_cluster/parser: optimize _get_moveable_keys

* async_cluster: inlined check_slots_coverage

* async_cluster: update docstrings

* async_cluster: add concurrent test & use read_response/_update_moved_slots without lock

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 benchmarks/cluster_async.py                |  263 +++
 docs/conf.py                               |    9 +-
 docs/connections.rst                       |   74 +-
 docs/requirements.txt                      |    3 +-
 redis/asyncio/__init__.py                  |    4 +
 redis/asyncio/client.py                    |   12 +-
 redis/asyncio/cluster.py                   | 1113 ++++++++++
 redis/asyncio/connection.py                |  140 +-
 redis/asyncio/parser.py                    |   95 +
 redis/client.py                            |   17 +-
 redis/cluster.py                           |  200 +-
 redis/commands/__init__.py                 |    3 +-
 redis/commands/cluster.py                  |  567 +++--
 redis/commands/parser.py                   |    1 -
 redis/crc.py                               |    4 +-
 redis/typing.py                            |   12 +-
 tests/conftest.py                          |   11 +-
 tests/test_asyncio/conftest.py             |   66 +-
 tests/test_asyncio/test_cluster.py         | 2232 ++++++++++++++++++++
 tests/test_asyncio/test_commands.py        |  141 +-
 tests/test_asyncio/test_connection.py      |    2 -
 tests/test_asyncio/test_connection_pool.py |   79 +-
 tests/test_asyncio/test_lock.py            |    2 +-
 tests/test_asyncio/test_retry.py           |    2 -
 tests/test_cluster.py                      |    6 +-
 tox.ini                                    |    5 +-
 whitelist.py                               |    2 +
 27 files changed, 4541 insertions(+), 524 deletions(-)
 create mode 100644 benchmarks/cluster_async.py
 create mode 100644 redis/asyncio/cluster.py
 create mode 100644 redis/asyncio/parser.py
 create mode 100644 tests/test_asyncio/test_cluster.py

diff --git a/benchmarks/cluster_async.py b/benchmarks/cluster_async.py
new file mode 100644
index 0000000000..aec3f1c403
--- /dev/null
+++ b/benchmarks/cluster_async.py
@@ -0,0 +1,263 @@
+import asyncio
+import functools
+import time
+
+import aioredis_cluster
+import aredis
+import uvloop
+
+import redis.asyncio as redispy
+
+
+def timer(func):
+    @functools.wraps(func)
+    async def wrapper(*args, **kwargs):
+        tic = time.perf_counter()
+        await func(*args, **kwargs)
+        toc = time.perf_counter()
+        return f"{toc - tic:.4f}"
+
+    return wrapper
+
+
+@timer
+async def set_str(client, gather, data):
+    if gather:
+        for _ in range(count // 100):
+            await asyncio.gather(
+                *(
+                    asyncio.create_task(client.set(f"bench:str_{i}", data))
+                    for i in range(100)
+                )
+            )
+    else:
+        for i in range(count):
+            await client.set(f"bench:str_{i}", data)
+
+
+@timer
+async def set_int(client, gather, data):
+    if gather:
+        for _ in range(count // 100):
+            await asyncio.gather(
+                *(
+                    asyncio.create_task(client.set(f"bench:int_{i}", data))
+                    for i in range(100)
+                )
+            )
+    else:
+        for i in range(count):
+            await client.set(f"bench:int_{i}", data)
+
+
+@timer
+async def get_str(client, gather):
+    if gather:
+        for _ in range(count // 100):
+            await asyncio.gather(
+                *(asyncio.create_task(client.get(f"bench:str_{i}")) for i in range(100))
+            )
+    else:
+        for i in range(count):
+            await client.get(f"bench:str_{i}")
+
+
+@timer
+async def get_int(client, gather):
+    if gather:
+        for _ in range(count // 100):
+            await asyncio.gather(
+                *(asyncio.create_task(client.get(f"bench:int_{i}")) for i in range(100))
+            )
+    else:
+        for i in range(count):
+            await client.get(f"bench:int_{i}")
+
+
+@timer
+async def hset(client, gather, data):
+    if gather:
+        for _ in range(count // 100):
+            await asyncio.gather(
+                *(
+                    asyncio.create_task(client.hset("bench:hset", str(i), data))
+                    for i in range(100)
+                )
+            )
+    else:
+        for i in range(count):
+            await client.hset("bench:hset", str(i), data)
+
+
+@timer
+async def hget(client, gather):
+    if gather:
+        for _ in range(count // 100):
+            await asyncio.gather(
+                *(
+                    asyncio.create_task(client.hget("bench:hset", str(i)))
+                    for i in range(100)
+                )
+            )
+    else:
+        for i in range(count):
+            await client.hget("bench:hset", str(i))
+
+
+@timer
+async def incr(client, gather):
+    if gather:
+        for _ in range(count // 100):
+            await asyncio.gather(
+                *(asyncio.create_task(client.incr("bench:incr")) for i in range(100))
+            )
+    else:
+        for i in range(count):
+            await client.incr("bench:incr")
+
+
+@timer
+async def lpush(client, gather, data):
+    if gather:
+        for _ in range(count // 100):
+            await asyncio.gather(
+                *(
+                    asyncio.create_task(client.lpush("bench:lpush", data))
+                    for i in range(100)
+                )
+            )
+    else:
+        for i in range(count):
+            await client.lpush("bench:lpush", data)
+
+
+@timer
+async def lrange_300(client, gather):
+    if gather:
+        for _ in range(count // 100):
+            await asyncio.gather(
+                *(
+                    asyncio.create_task(client.lrange("bench:lpush", i, i + 300))
+                    for i in range(100)
+                )
+            )
+    else:
+        for i in range(count):
+            await client.lrange("bench:lpush", i, i + 300)
+
+
+@timer
+async def lpop(client, gather):
+    if gather:
+        for _ in range(count // 100):
+            await asyncio.gather(
+                *(asyncio.create_task(client.lpop("bench:lpush")) for i in range(100))
+            )
+    else:
+        for i in range(count):
+            await client.lpop("bench:lpush")
+
+
+@timer
+async def warmup(client):
+    await asyncio.gather(
+        *(asyncio.create_task(client.exists(f"bench:warmup_{i}")) for i in range(100))
+    )
+
+
+@timer
+async def run(client, gather):
+    data_str = "a" * size
+    data_int = int("1" * size)
+
+    if gather is False:
+        for ret in await asyncio.gather(
+            asyncio.create_task(set_str(client, gather, data_str)),
+            asyncio.create_task(set_int(client, gather, data_int)),
+            asyncio.create_task(hset(client, gather, data_str)),
+            asyncio.create_task(incr(client, gather)),
+            asyncio.create_task(lpush(client, gather, data_int)),
+        ):
+            print(ret)
+        for ret in await asyncio.gather(
+            asyncio.create_task(get_str(client, gather)),
+            asyncio.create_task(get_int(client, gather)),
+            asyncio.create_task(hget(client, gather)),
+            asyncio.create_task(lrange_300(client, gather)),
+            asyncio.create_task(lpop(client, gather)),
+        ):
+            print(ret)
+    else:
+        print(await set_str(client, gather, data_str))
+        print(await set_int(client, gather, data_int))
+        print(await hset(client, gather, data_str))
+        print(await incr(client, gather))
+        print(await lpush(client, gather, data_int))
+
+        print(await get_str(client, gather))
+        print(await get_int(client, gather))
+        print(await hget(client, gather))
+        print(await lrange_300(client, gather))
+        print(await lpop(client, gather))
+
+
+async def main(loop, gather=None):
+    arc = aredis.StrictRedisCluster(
+        host=host,
+        port=port,
+        password=password,
+        max_connections=2 ** 31,
+        max_connections_per_node=2 ** 31,
+        readonly=False,
+        reinitialize_steps=count,
+        skip_full_coverage_check=True,
+        decode_responses=False,
+        max_idle_time=count,
+        idle_check_interval=count,
+    )
+    print(f"{loop} {gather} {await warmup(arc)} aredis")
+    print(await run(arc, gather=gather))
+    arc.connection_pool.disconnect()
+
+    aiorc = await aioredis_cluster.create_redis_cluster(
+        [(host, port)],
+        password=password,
+        state_reload_interval=count,
+        idle_connection_timeout=count,
+        pool_maxsize=2 ** 31,
+    )
+    print(f"{loop} {gather} {await warmup(aiorc)} aioredis-cluster")
+    print(await run(aiorc, gather=gather))
+    aiorc.close()
+    await aiorc.wait_closed()
+
+    async with redispy.RedisCluster(
+        host=host,
+        port=port,
+        password=password,
+        reinitialize_steps=count,
+        read_from_replicas=False,
+        decode_responses=False,
+        max_connections=2 ** 31,
+    ) as rca:
+        print(f"{loop} {gather} {await warmup(rca)} redispy")
+        print(await run(rca, gather=gather))
+
+
+if __name__ == "__main__":
+    host = "localhost"
+    port = 16379
+    password = None
+
+    count = 1000
+    size = 16
+
+    asyncio.run(main("asyncio"))
+    asyncio.run(main("asyncio", gather=False))
+    asyncio.run(main("asyncio", gather=True))
+
+    uvloop.install()
+
+    asyncio.run(main("uvloop"))
+    asyncio.run(main("uvloop", gather=False))
+    asyncio.run(main("uvloop", gather=True))
diff --git a/docs/conf.py b/docs/conf.py
index b99e46c879..618d95aea1 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -30,6 +30,7 @@
     "nbsphinx",
     "sphinx_gallery.load_style",
     "sphinx.ext.autodoc",
+    "sphinx_autodoc_typehints",
     "sphinx.ext.doctest",
     "sphinx.ext.viewcode",
     "sphinx.ext.autosectionlabel",
@@ -41,6 +42,10 @@
 autosectionlabel_prefix_document = True
 autosectionlabel_maxdepth = 2
 
+# AutodocTypehints settings.
+always_document_param_types = True
+typehints_defaults = "comma"
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
 
@@ -210,7 +215,7 @@
 # (source start file, target name, title, author, documentclass
 # [howto/manual]).
 latex_documents = [
-    ("index", "redis-py.tex", "redis-py Documentation", "Redis Inc", "manual"),
+    ("index", "redis-py.tex", "redis-py Documentation", "Redis Inc", "manual")
 ]
 
 # The name of an image file (relative to this directory) to place at the top of
@@ -258,7 +263,7 @@
         "redis-py",
         "One line description of project.",
         "Miscellaneous",
-    ),
+    )
 ]
 
 # Documents to append as an appendix to all manuals.
diff --git a/docs/connections.rst b/docs/connections.rst
index 9804a15bf1..e4b82cdc50 100644
--- a/docs/connections.rst
+++ b/docs/connections.rst
@@ -1,20 +1,22 @@
 Connecting to Redis
-#####################
+###################
+
 
 Generic Client
 **************
 
-This is the client used to connect directly to a standard redis node.
+This is the client used to connect directly to a standard Redis node.
 
 .. autoclass:: redis.Redis
    :members:
 
+
 Sentinel Client
 ***************
 
-Redis `Sentinel <https://redis.io/topics/sentinel>`_ provides high availability for Redis. There are commands that can only be executed against a redis node running in sentinel mode. Connecting to those nodes, and executing commands against them requires a Sentinel connection.
+Redis `Sentinel <https://redis.io/topics/sentinel>`_ provides high availability for Redis. There are commands that can only be executed against a Redis node running in sentinel mode. Connecting to those nodes, and executing commands against them requires a Sentinel connection.
 
-Connection example (assumes redis redis on the ports listed below):
+Connection example (assumes Redis exists on the ports listed below):
 
    >>> from redis import Sentinel
    >>> sentinel = Sentinel([('localhost', 26379)], socket_timeout=0.1)
@@ -23,33 +25,85 @@ Connection example (assumes redis redis on the ports listed below):
    >>> sentinel.discover_slaves('mymaster')
    [('127.0.0.1', 6380)]
 
+Sentinel
+========
 .. autoclass:: redis.sentinel.Sentinel
     :members:
 
+SentinelConnectionPool
+======================
 .. autoclass:: redis.sentinel.SentinelConnectionPool
     :members:
 
+
 Cluster Client
 **************
 
-This client is used for connecting to a redis cluser.
+This client is used for connecting to a Redis Cluster.
 
+RedisCluster
+============
 .. autoclass:: redis.cluster.RedisCluster
     :members:
 
-Connection Pools
-*****************
-.. autoclass:: redis.connection.ConnectionPool
+ClusterNode
+===========
+.. autoclass:: redis.cluster.ClusterNode
     :members:
 
-More connection examples can be found `here <examples/connection_examples.html>`_.
 
 Async Client
 ************
 
+See complete example: `here <examples/asyncio_examples.html>`_
+
 This client is used for communicating with Redis, asynchronously.
 
+.. autoclass:: redis.asyncio.client.Redis
+    :members:
+
+
+Async Cluster Client
+********************
+
+RedisCluster (Async)
+====================
+.. autoclass:: redis.asyncio.cluster.RedisCluster
+    :members:
+
+ClusterNode (Async)
+===================
+.. autoclass:: redis.asyncio.cluster.ClusterNode
+    :members:
+
+
+Connection
+**********
+
+See complete example: `here <examples/connection_examples.html>`_
+
+Connection
+==========
+.. autoclass:: redis.connection.Connection
+    :members:
+
+Connection (Async)
+==================
 .. autoclass:: redis.asyncio.connection.Connection
     :members:
 
-More connection examples can be found `here <examples/asyncio_examples.html>`_
\ No newline at end of file
+
+Connection Pools
+****************
+
+See complete example: `here <examples/connection_examples.html>`_
+
+ConnectionPool
+==============
+.. autoclass:: redis.connection.ConnectionPool
+    :members:
+
+ConnectionPool (Async)
+======================
+.. autoclass:: redis.asyncio.connection.ConnectionPool
+    :members:
diff --git a/docs/requirements.txt b/docs/requirements.txt
index bbb7dc6149..23ddc948f4 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,6 +1,7 @@
-sphinx<2
+sphinx<5
 docutils<0.18
 sphinx-rtd-theme
 nbsphinx
 sphinx_gallery
 ipython
+sphinx-autodoc-typehints
diff --git a/redis/asyncio/__init__.py b/redis/asyncio/__init__.py
index c655c7da4b..598791ac15 100644
--- a/redis/asyncio/__init__.py
+++ b/redis/asyncio/__init__.py
@@ -1,4 +1,5 @@
 from redis.asyncio.client import Redis, StrictRedis
+from redis.asyncio.cluster import RedisCluster
 from redis.asyncio.connection import (
     BlockingConnectionPool,
     Connection,
@@ -6,6 +7,7 @@
     SSLConnection,
     UnixDomainSocketConnection,
 )
+from redis.asyncio.parser import CommandsParser
 from redis.asyncio.sentinel import (
     Sentinel,
     SentinelConnectionPool,
@@ -35,6 +37,7 @@
     "BlockingConnectionPool",
     "BusyLoadingError",
     "ChildDeadlockedError",
+    "CommandsParser",
     "Connection",
     "ConnectionError",
     "ConnectionPool",
@@ -44,6 +47,7 @@
     "PubSubError",
     "ReadOnlyError",
     "Redis",
+    "RedisCluster",
     "RedisError",
     "ResponseError",
     "Sentinel",
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 8dde96e422..6db54895f4 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -172,6 +172,7 @@ def __init__(
         username: Optional[str] = None,
         retry: Optional[Retry] = None,
         auto_close_connection_pool: bool = True,
+        redis_connect_func=None,
     ):
         """
         Initialize a new Redis client.
@@ -200,6 +201,7 @@ def __init__(
                 "max_connections": max_connections,
                 "health_check_interval": health_check_interval,
                 "client_name": client_name,
+                "redis_connect_func": redis_connect_func,
             }
             # based on input, setup appropriate connection args
             if unix_socket_path is not None:
@@ -263,11 +265,7 @@ def get_connection_kwargs(self):
         """Get the connection's key-word arguments"""
         return self.connection_pool.connection_kwargs
 
-    def load_external_module(
-        self,
-        funcname,
-        func,
-    ):
+    def load_external_module(self, funcname, func):
         """
         This function can be used to add externally defined redis modules,
         and their namespaces to the redis client.
@@ -426,9 +424,7 @@ async def __aexit__(self, exc_type, exc_value, traceback):
     def __del__(self, _warnings: Any = warnings) -> None:
         if self.connection is not None:
             _warnings.warn(
-                f"Unclosed client session {self!r}",
-                ResourceWarning,
-                source=self,
+                f"Unclosed client session {self!r}", ResourceWarning, source=self
             )
             context = {"client": self, "message": self._DEL_MESSAGE}
             asyncio.get_event_loop().call_exception_handler(context)
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
new file mode 100644
index 0000000000..10a5675e82
--- /dev/null
+++ b/redis/asyncio/cluster.py
@@ -0,0 +1,1113 @@
+import asyncio
+import collections
+import random
+import socket
+import warnings
+from typing import Any, Callable, Dict, List, Optional, Type, TypeVar, Union
+
+from redis.asyncio.client import EMPTY_RESPONSE, NEVER_DECODE, AbstractRedis
+from redis.asyncio.connection import Connection, DefaultParser, Encoder, parse_url
+from redis.asyncio.parser import CommandsParser
+from redis.cluster import (
+    PRIMARY,
+    READ_COMMANDS,
+    REPLICA,
+    SLOT_ID,
+    AbstractRedisCluster,
+    LoadBalancer,
+    cleanup_kwargs,
+    get_node_name,
+    parse_cluster_slots,
+)
+from redis.commands import AsyncRedisClusterCommands
+from redis.crc import REDIS_CLUSTER_HASH_SLOTS, key_slot
+from redis.exceptions import (
+    AskError,
+    BusyLoadingError,
+    ClusterCrossSlotError,
+    ClusterDownError,
+    ClusterError,
+    ConnectionError,
+    DataError,
+    MasterDownError,
+    MovedError,
+    RedisClusterException,
+    ResponseError,
+    SlotNotCoveredError,
+    TimeoutError,
+    TryAgainError,
+)
+from redis.typing import EncodableT, KeyT
+from redis.utils import dict_merge, str_if_bytes
+
+TargetNodesT = TypeVar(
+    "TargetNodesT", "ClusterNode", List["ClusterNode"], Dict[Any, "ClusterNode"]
+)
+
+
+class ClusterParser(DefaultParser):
+    EXCEPTION_CLASSES = dict_merge(
+        DefaultParser.EXCEPTION_CLASSES,
+        {
+            "ASK": AskError,
+            "TRYAGAIN": TryAgainError,
+            "MOVED": MovedError,
+            "CLUSTERDOWN": ClusterDownError,
+            "CROSSSLOT": ClusterCrossSlotError,
+            "MASTERDOWN": MasterDownError,
+        },
+    )
+
+
+class RedisCluster(AbstractRedis, AbstractRedisCluster, AsyncRedisClusterCommands):
+    """
+    Create a new RedisCluster client.
+
+    Pass one of parameters:
+
+      - `url`
+      - `host` & `port`
+      - `startup_nodes`
+
+    | Use ``await`` :meth:`initialize` to find cluster nodes & create connections.
+    | Use ``await`` :meth:`close` to disconnect connections & close client.
+
+    Many commands support the target_nodes kwarg. It can be one of the
+    :attr:`NODE_FLAGS`:
+
+      - :attr:`PRIMARIES`
+      - :attr:`REPLICAS`
+      - :attr:`ALL_NODES`
+      - :attr:`RANDOM`
+      - :attr:`DEFAULT_NODE`
+
+    Note: This client is not thread/process/fork safe.
+
+    :param host:
+        | Can be used to point to a startup node
+    :param port:
+        | Port used if **host** is provided
+    :param startup_nodes:
+        | :class:`~.ClusterNode` to used as a startup node
+    :param cluster_error_retry_attempts:
+        | Retry command execution attempts when encountering :class:`~.ClusterDownError`
+          or :class:`~.ConnectionError`
+    :param require_full_coverage:
+        | When set to ``False``: the client will not require a full coverage of the
+          slots. However, if not all slots are covered, and at least one node has
+          ``cluster-require-full-coverage`` set to ``yes``, the server will throw a
+          :class:`~.ClusterDownError` for some key-based commands.
+        | When set to ``True``: all slots must be covered to construct the cluster
+          client. If not all slots are covered, :class:`~.RedisClusterException` will be
+          thrown.
+        | See:
+          https://redis.io/docs/manual/scaling/#redis-cluster-configuration-parameters
+    :param reinitialize_steps:
+        | Specifies the number of MOVED errors that need to occur before reinitializing
+          the whole cluster topology. If a MOVED error occurs and the cluster does not
+          need to be reinitialized on this current error handling, only the MOVED slot
+          will be patched with the redirected node.
+          To reinitialize the cluster on every MOVED error, set reinitialize_steps to 1.
+          To avoid reinitializing the cluster on moved errors, set reinitialize_steps to
+          0.
+    :param read_from_replicas:
+        | Enable read from replicas in READONLY mode. You can read possibly stale data.
+          When set to true, read commands will be assigned between the primary and
+          its replications in a Round-Robin manner.
+    :param url:
+        | See :meth:`.from_url`
+    :param kwargs:
+        | Extra arguments that will be passed to the
+          :class:`~redis.asyncio.connection.Connection` instances when created
+
+    :raises RedisClusterException:
+        if any arguments are invalid. Eg:
+
+        - db kwarg
+        - db != 0 in url
+        - unix socket connection
+        - none of host & url & startup_nodes were provided
+
+    """
+
+    @classmethod
+    def from_url(cls, url: str, **kwargs) -> "RedisCluster":
+        """
+        Return a Redis client object configured from the given URL.
+
+        For example::
+
+            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 TCP socket connection. See more at:
+          <https://www.iana.org/assignments/uri-schemes/prov/redis>
+        - `rediss://` creates a SSL wrapped TCP socket connection. See more at:
+          <https://www.iana.org/assignments/uri-schemes/prov/rediss>
+        - ``unix://``: creates a Unix Domain Socket connection.
+
+        The username, password, hostname, path and all querystring values
+        are passed through urllib.parse.unquote in order to replace any
+        percent-encoded values with their corresponding characters.
+
+        There are several ways to specify a database number. The first value
+        found will be used:
+
+            1. A ``db`` querystring option, e.g. redis://localhost?db=0
+            2. If using the redis:// or rediss:// schemes, the path argument
+               of the url, e.g. redis://localhost/0
+            3. A ``db`` keyword argument to this function.
+
+        If none of these options are specified, the default db=0 is used.
+
+        All querystring options are cast to their appropriate Python types.
+        Boolean arguments can be specified with string values "True"/"False"
+        or "Yes"/"No". Values that cannot be properly cast cause a
+        ``ValueError`` to be raised. Once parsed, the querystring arguments and
+        keyword arguments are passed to :class:`~redis.asyncio.connection.Connection`
+        when created. In the case of conflicting arguments, querystring
+        arguments always win.
+
+        """
+        return cls(url=url, **kwargs)
+
+    __slots__ = (
+        "_initialize",
+        "_lock",
+        "cluster_error_retry_attempts",
+        "command_flags",
+        "commands_parser",
+        "connection_kwargs",
+        "encoder",
+        "node_flags",
+        "nodes_manager",
+        "read_from_replicas",
+        "reinitialize_counter",
+        "reinitialize_steps",
+        "response_callbacks",
+        "result_callbacks",
+    )
+
+    def __init__(
+        self,
+        host: Optional[str] = None,
+        port: int = 6379,
+        startup_nodes: Optional[List["ClusterNode"]] = None,
+        require_full_coverage: bool = False,
+        read_from_replicas: bool = False,
+        cluster_error_retry_attempts: int = 3,
+        reinitialize_steps: int = 10,
+        url: Optional[str] = None,
+        **kwargs,
+    ) -> None:
+        if not startup_nodes:
+            startup_nodes = []
+
+        if "db" in kwargs:
+            # Argument 'db' is not possible to use in cluster mode
+            raise RedisClusterException(
+                "Argument 'db' is not possible to use in cluster mode"
+            )
+
+        # Get the startup node/s
+        if url:
+            url_options = parse_url(url)
+            if "path" in url_options:
+                raise RedisClusterException(
+                    "RedisCluster does not currently support Unix Domain "
+                    "Socket connections"
+                )
+            if "db" in url_options and url_options["db"] != 0:
+                # Argument 'db' is not possible to use in cluster mode
+                raise RedisClusterException(
+                    "A ``db`` querystring option can only be 0 in cluster mode"
+                )
+            kwargs.update(url_options)
+            host = kwargs.get("host")
+            port = kwargs.get("port", port)
+        elif (not host or not port) and not startup_nodes:
+            # No startup node was provided
+            raise RedisClusterException(
+                "RedisCluster requires at least one node to discover the "
+                "cluster. Please provide one of the followings:\n"
+                "1. host and port, for example:\n"
+                " RedisCluster(host='localhost', port=6379)\n"
+                "2. list of startup nodes, for example:\n"
+                " RedisCluster(startup_nodes=[ClusterNode('localhost', 6379),"
+                " ClusterNode('localhost', 6378)])"
+            )
+
+        # Update the connection arguments
+        # Whenever a new connection is established, RedisCluster's on_connect
+        # method should be run
+        kwargs["redis_connect_func"] = self.on_connect
+        self.connection_kwargs = kwargs = cleanup_kwargs(**kwargs)
+        self.response_callbacks = kwargs[
+            "response_callbacks"
+        ] = self.__class__.RESPONSE_CALLBACKS
+        if host and port:
+            startup_nodes.append(ClusterNode(host, port, **self.connection_kwargs))
+
+        self.encoder = Encoder(
+            kwargs.get("encoding", "utf-8"),
+            kwargs.get("encoding_errors", "strict"),
+            kwargs.get("decode_responses", False),
+        )
+        self.cluster_error_retry_attempts = cluster_error_retry_attempts
+        self.command_flags = self.__class__.COMMAND_FLAGS.copy()
+        self.node_flags = self.__class__.NODE_FLAGS.copy()
+        self.read_from_replicas = read_from_replicas
+        self.reinitialize_counter = 0
+        self.reinitialize_steps = reinitialize_steps
+        self.nodes_manager = NodesManager(
+            startup_nodes=startup_nodes,
+            require_full_coverage=require_full_coverage,
+            **self.connection_kwargs,
+        )
+
+        self.result_callbacks = self.__class__.RESULT_CALLBACKS
+        self.result_callbacks[
+            "CLUSTER SLOTS"
+        ] = lambda cmd, res, **kwargs: parse_cluster_slots(
+            list(res.values())[0], **kwargs
+        )
+        self.commands_parser = CommandsParser()
+        self._initialize = True
+        self._lock = asyncio.Lock()
+
+    async def initialize(self) -> "RedisCluster":
+        """Get all nodes from startup nodes & creates connections if not initialized."""
+        if self._initialize:
+            async with self._lock:
+                if self._initialize:
+                    self._initialize = False
+                    try:
+                        await self.nodes_manager.initialize()
+                        await self.commands_parser.initialize(
+                            self.nodes_manager.default_node
+                        )
+                    except BaseException:
+                        self._initialize = True
+                        await self.nodes_manager.close()
+                        await self.nodes_manager.close("startup_nodes")
+                        raise
+        return self
+
+    async def close(self) -> None:
+        """Close all connections & client if initialized."""
+        if not self._initialize:
+            async with self._lock:
+                if not self._initialize:
+                    self._initialize = True
+                    await self.nodes_manager.close()
+
+    async def __aenter__(self) -> "RedisCluster":
+        return await self.initialize()
+
+    async def __aexit__(self, exc_type: None, exc_value: None, traceback: None) -> None:
+        await self.close()
+
+    def __await__(self):
+        return self.initialize().__await__()
+
+    _DEL_MESSAGE = "Unclosed RedisCluster client"
+
+    def __del__(self, _warnings=warnings):
+        if hasattr(self, "_initialize") and not self._initialize:
+            _warnings.warn(
+                f"{self._DEL_MESSAGE} {self!r}", ResourceWarning, source=self
+            )
+            try:
+                context = {"client": self, "message": self._DEL_MESSAGE}
+                # TODO: Change to get_running_loop() when dropping support for py3.6
+                asyncio.get_event_loop().call_exception_handler(context)
+            except RuntimeError:
+                ...
+
+    async def on_connect(self, connection: Connection) -> None:
+        connection.set_parser(ClusterParser)
+        await connection.on_connect()
+
+        if self.read_from_replicas:
+            # Sending READONLY command to server to configure connection as
+            # readonly. Since each cluster node may change its server type due
+            # to a failover, we should establish a READONLY connection
+            # regardless of the server type. If this is a primary connection,
+            # READONLY would not affect executing write commands.
+            await connection.send_command("READONLY")
+            if str_if_bytes(await connection.read_response_without_lock()) != "OK":
+                raise ConnectionError("READONLY command failed")
+
+    def get_node(
+        self,
+        host: Optional[str] = None,
+        port: Optional[int] = None,
+        node_name: Optional[str] = None,
+    ) -> Optional["ClusterNode"]:
+        """Get node by (host, port) or node_name."""
+        return self.nodes_manager.get_node(host, port, node_name)
+
+    def get_primaries(self) -> List["ClusterNode"]:
+        """Get the primary nodes of the cluster."""
+        return self.nodes_manager.get_nodes_by_server_type(PRIMARY)
+
+    def get_replicas(self) -> List["ClusterNode"]:
+        """Get the replica nodes of the cluster."""
+        return self.nodes_manager.get_nodes_by_server_type(REPLICA)
+
+    def get_random_node(self) -> "ClusterNode":
+        """Get a random node of the cluster."""
+        return random.choice(list(self.nodes_manager.nodes_cache.values()))
+
+    def get_nodes(self) -> List["ClusterNode"]:
+        """Get all nodes of the cluster."""
+        return list(self.nodes_manager.nodes_cache.values())
+
+    def get_node_from_key(
+        self, key: str, replica: bool = False
+    ) -> Optional["ClusterNode"]:
+        """
+        Get the cluster node corresponding to the provided key.
+
+        :param key:
+        :param replica:
+            | Indicates if a replica should be returned
+              None will returned if no replica holds this key
+
+        :raises SlotNotCoveredError: if the key is not covered by any slot.
+        """
+        slot = self.keyslot(key)
+        slot_cache = self.nodes_manager.slots_cache.get(slot)
+        if not slot_cache:
+            raise SlotNotCoveredError(f'Slot "{slot}" is not covered by the cluster.')
+        if replica and len(self.nodes_manager.slots_cache[slot]) < 2:
+            return None
+        elif replica:
+            node_idx = 1
+        else:
+            # primary
+            node_idx = 0
+
+        return slot_cache[node_idx]
+
+    def get_default_node(self) -> "ClusterNode":
+        """Get the default node of the client."""
+        return self.nodes_manager.default_node
+
+    def set_default_node(self, node: "ClusterNode") -> None:
+        """
+        Set the default node of the client.
+
+        :raises DataError: if None is passed or node does not exist in cluster.
+        """
+        if not node or not self.get_node(node_name=node.name):
+            raise DataError("The requested node does not exist in the cluster.")
+
+        self.nodes_manager.default_node = node
+
+    def set_response_callback(self, command: KeyT, callback: Callable) -> None:
+        """Set a custom response callback."""
+        self.response_callbacks[command] = callback
+
+    def get_encoder(self) -> Encoder:
+        """Get the encoder object of the client."""
+        return self.encoder
+
+    def get_connection_kwargs(self) -> Dict[str, Optional[Any]]:
+        """Get the kwargs passed to :class:`~redis.asyncio.connection.Connection`."""
+        return self.connection_kwargs
+
+    def keyslot(self, key: EncodableT) -> int:
+        """
+        Find the keyslot for a given key.
+
+        See: https://redis.io/docs/manual/scaling/#redis-cluster-data-sharding
+        """
+        k = self.encoder.encode(key)
+        return key_slot(k)
+
+    async def _determine_nodes(
+        self, *args, node_flag: Optional[str] = None
+    ) -> List["ClusterNode"]:
+        command = args[0]
+        if not node_flag:
+            # get the nodes group for this command if it was predefined
+            node_flag = self.command_flags.get(command)
+
+        if node_flag in self.node_flags:
+            if node_flag == self.__class__.DEFAULT_NODE:
+                # return the cluster's default node
+                return [self.nodes_manager.default_node]
+            if node_flag == self.__class__.PRIMARIES:
+                # return all primaries
+                return self.nodes_manager.get_nodes_by_server_type(PRIMARY)
+            if node_flag == self.__class__.REPLICAS:
+                # return all replicas
+                return self.nodes_manager.get_nodes_by_server_type(REPLICA)
+            if node_flag == self.__class__.ALL_NODES:
+                # return all nodes
+                return list(self.nodes_manager.nodes_cache.values())
+            if node_flag == self.__class__.RANDOM:
+                # return a random node
+                return [random.choice(list(self.nodes_manager.nodes_cache.values()))]
+
+        # get the node that holds the key's slot
+        return [
+            self.nodes_manager.get_node_from_slot(
+                await self._determine_slot(*args),
+                self.read_from_replicas and command in READ_COMMANDS,
+            )
+        ]
+
+    async def _determine_slot(self, *args) -> int:
+        command = args[0]
+        if self.command_flags.get(command) == SLOT_ID:
+            # The command contains the slot ID
+            return args[1]
+
+        # Get the keys in the command
+
+        # EVAL and EVALSHA are common enough that it's wasteful to go to the
+        # redis server to parse the keys. Besides, there is a bug in redis<7.0
+        # where `self._get_command_keys()` fails anyway. So, we special case
+        # EVAL/EVALSHA.
+        # - issue: https://github.com/redis/redis/issues/9493
+        # - fix: https://github.com/redis/redis/pull/9733
+        if command in ("EVAL", "EVALSHA"):
+            # command syntax: EVAL "script body" num_keys ...
+            if len(args) <= 2:
+                raise RedisClusterException(f"Invalid args in command: {args}")
+            num_actual_keys = args[2]
+            eval_keys = args[3 : 3 + num_actual_keys]
+            # if there are 0 keys, that means the script can be run on any node
+            # so we can just return a random slot
+            if not eval_keys:
+                return random.randrange(0, REDIS_CLUSTER_HASH_SLOTS)
+            keys = eval_keys
+        else:
+            keys = await self.commands_parser.get_keys(
+                self.nodes_manager.default_node, *args
+            )
+            if not keys:
+                # FCALL can call a function with 0 keys, that means the function
+                #  can be run on any node so we can just return a random slot
+                if command in ("FCALL", "FCALL_RO"):
+                    return random.randrange(0, REDIS_CLUSTER_HASH_SLOTS)
+                raise RedisClusterException(
+                    "No way to dispatch this command to Redis Cluster. "
+                    "Missing key.\nYou can execute the command by specifying "
+                    f"target nodes.\nCommand: {args}"
+                )
+
+        # single key command
+        if len(keys) == 1:
+            return self.keyslot(keys[0])
+
+        # multi-key command; we need to make sure all keys are mapped to
+        # the same slot
+        slots = {self.keyslot(key) for key in keys}
+        if len(slots) != 1:
+            raise RedisClusterException(
+                f"{command} - all keys must map to the same key slot"
+            )
+
+        return slots.pop()
+
+    def _is_node_flag(
+        self, target_nodes: Union[List["ClusterNode"], "ClusterNode", str]
+    ) -> bool:
+        return isinstance(target_nodes, str) and target_nodes in self.node_flags
+
+    def _parse_target_nodes(
+        self, target_nodes: Union[List["ClusterNode"], "ClusterNode"]
+    ) -> List["ClusterNode"]:
+        if isinstance(target_nodes, list):
+            nodes = target_nodes
+        elif isinstance(target_nodes, ClusterNode):
+            # Supports passing a single ClusterNode as a variable
+            nodes = [target_nodes]
+        elif isinstance(target_nodes, dict):
+            # Supports dictionaries of the format {node_name: node}.
+            # It enables to execute commands with multi nodes as follows:
+            # rc.cluster_save_config(rc.get_primaries())
+            nodes = target_nodes.values()
+        else:
+            raise TypeError(
+                "target_nodes type can be one of the following: "
+                "node_flag (PRIMARIES, REPLICAS, RANDOM, ALL_NODES),"
+                "ClusterNode, list<ClusterNode>, or dict<any, ClusterNode>. "
+                f"The passed type is {type(target_nodes)}"
+            )
+        return nodes
+
+    async def execute_command(self, *args: Union[KeyT, EncodableT], **kwargs) -> Any:
+        """
+        Execute a raw command on the appropriate cluster node or target_nodes.
+
+        It will retry the command as specified by :attr:`cluster_error_retry_attempts` &
+        then raise an exception.
+
+        :param args:
+            | Raw command args
+        :param kwargs:
+
+            - target_nodes: :attr:`NODE_FLAGS` or :class:`~.ClusterNode`
+              or List[:class:`~.ClusterNode`] or Dict[Any, :class:`~.ClusterNode`]
+            - Rest of the kwargs are passed to the Redis connection
+
+        :raises RedisClusterException: if target_nodes is not provided & the command
+            can't be mapped to a slot
+        """
+        command = args[0]
+        target_nodes_specified = target_nodes = exception = None
+        retry_attempts = self.cluster_error_retry_attempts
+
+        passed_targets = kwargs.pop("target_nodes", None)
+        if passed_targets and not self._is_node_flag(passed_targets):
+            target_nodes = self._parse_target_nodes(passed_targets)
+            target_nodes_specified = True
+            retry_attempts = 1
+
+        for _ in range(0, retry_attempts):
+            if self._initialize:
+                await self.initialize()
+            try:
+                if not target_nodes_specified:
+                    # Determine the nodes to execute the command on
+                    target_nodes = await self._determine_nodes(
+                        *args, node_flag=passed_targets
+                    )
+                    if not target_nodes:
+                        raise RedisClusterException(
+                            f"No targets were found to execute {args} command on"
+                        )
+
+                if len(target_nodes) == 1:
+                    # Return the processed result
+                    ret = await self._execute_command(target_nodes[0], *args, **kwargs)
+                    if command in self.result_callbacks:
+                        return self.result_callbacks[command](
+                            command, {target_nodes[0].name: ret}, **kwargs
+                        )
+                    return ret
+                else:
+                    keys = [node.name for node in target_nodes]
+                    values = await asyncio.gather(
+                        *(
+                            asyncio.ensure_future(
+                                self._execute_command(node, *args, **kwargs)
+                            )
+                            for node in target_nodes
+                        )
+                    )
+                    if command in self.result_callbacks:
+                        return self.result_callbacks[command](
+                            command, dict(zip(keys, values)), **kwargs
+                        )
+                    return dict(zip(keys, values))
+            except BaseException as e:
+                if type(e) in self.__class__.ERRORS_ALLOW_RETRY:
+                    # The nodes and slots cache were reinitialized.
+                    # Try again with the new cluster setup.
+                    exception = e
+                else:
+                    # All other errors should be raised.
+                    raise e
+
+        # If it fails the configured number of times then raise exception back
+        # to caller of this method
+        raise exception
+
+    async def _execute_command(
+        self, target_node: "ClusterNode", *args: Union[KeyT, EncodableT], **kwargs
+    ) -> Any:
+        redirect_addr = asking = moved = None
+        ttl = self.RedisClusterRequestTTL
+        connection_error_retry_counter = 0
+
+        while ttl > 0:
+            ttl -= 1
+            try:
+                if asking:
+                    target_node = self.get_node(node_name=redirect_addr)
+                    await target_node.execute_command("ASKING")
+                    asking = False
+                elif moved:
+                    # MOVED occurred and the slots cache was updated,
+                    # refresh the target node
+                    slot = await self._determine_slot(*args)
+                    target_node = self.nodes_manager.get_node_from_slot(
+                        slot, self.read_from_replicas and args[0] in READ_COMMANDS
+                    )
+                    moved = False
+
+                return await target_node.execute_command(*args, **kwargs)
+            except BusyLoadingError:
+                raise
+            except (ConnectionError, TimeoutError):
+                # Give the node 0.25 seconds to get back up and retry again
+                # with same node and configuration. After 5 attempts then try
+                # to reinitialize the cluster and see if the nodes
+                # configuration has changed or not
+                connection_error_retry_counter += 1
+                if connection_error_retry_counter < 5:
+                    await asyncio.sleep(0.25)
+                else:
+                    # Hard force of reinitialize of the node/slots setup
+                    # and try again with the new setup
+                    await self.close()
+                    raise
+            except MovedError as e:
+                # First, we will try to patch the slots/nodes cache with the
+                # redirected node output and try again. If MovedError exceeds
+                # 'reinitialize_steps' number of times, we will force
+                # reinitializing the tables, and then try again.
+                # 'reinitialize_steps' counter will increase faster when
+                # the same client object is shared between multiple threads. To
+                # reduce the frequency you can set this variable in the
+                # RedisCluster constructor.
+                self.reinitialize_counter += 1
+                if (
+                    self.reinitialize_steps
+                    and self.reinitialize_counter % self.reinitialize_steps == 0
+                ):
+                    await self.close()
+                    # Reset the counter
+                    self.reinitialize_counter = 0
+                else:
+                    self.nodes_manager._moved_exception = e
+                moved = True
+            except TryAgainError:
+                if ttl < self.RedisClusterRequestTTL / 2:
+                    await asyncio.sleep(0.05)
+            except AskError as e:
+                redirect_addr = get_node_name(host=e.host, port=e.port)
+                asking = True
+            except ClusterDownError:
+                # ClusterDownError can occur during a failover and to get
+                # self-healed, we will try to reinitialize the cluster layout
+                # and retry executing the command
+                await asyncio.sleep(0.25)
+                await self.close()
+                raise
+
+        raise ClusterError("TTL exhausted.")
+
+
+class ClusterNode:
+    """
+    Create a new ClusterNode.
+
+    Each ClusterNode manages multiple :class:`~redis.asyncio.connection.Connection`
+    objects for the (host, port).
+    """
+
+    __slots__ = (
+        "_connections",
+        "_free",
+        "connection_class",
+        "connection_kwargs",
+        "host",
+        "max_connections",
+        "name",
+        "port",
+        "response_callbacks",
+        "server_type",
+    )
+
+    def __init__(
+        self,
+        host: str,
+        port: int,
+        server_type: Optional[str] = None,
+        max_connections: int = 2 ** 31,
+        connection_class: Type[Connection] = Connection,
+        response_callbacks: Dict = None,
+        **connection_kwargs,
+    ) -> None:
+        if host == "localhost":
+            host = socket.gethostbyname(host)
+
+        connection_kwargs["host"] = host
+        connection_kwargs["port"] = port
+        self.host = host
+        self.port = port
+        self.name = get_node_name(host, port)
+        self.server_type = server_type
+
+        self.max_connections = max_connections
+        self.connection_class = connection_class
+        self.connection_kwargs = connection_kwargs
+        self.response_callbacks = response_callbacks
+
+        self._connections = []
+        self._free = collections.deque(maxlen=self.max_connections)
+
+    def __repr__(self) -> str:
+        return (
+            f"[host={self.host}, port={self.port}, "
+            f"name={self.name}, server_type={self.server_type}]"
+        )
+
+    def __eq__(self, obj: "ClusterNode") -> bool:
+        return isinstance(obj, ClusterNode) and obj.name == self.name
+
+    _DEL_MESSAGE = "Unclosed ClusterNode object"
+
+    def __del__(self, _warnings=warnings):
+        for connection in self._connections:
+            if connection.is_connected:
+                _warnings.warn(
+                    f"{self._DEL_MESSAGE} {self!r}", ResourceWarning, source=self
+                )
+                try:
+                    context = {"client": self, "message": self._DEL_MESSAGE}
+                    # TODO: Change to get_running_loop() when dropping support for py3.6
+                    asyncio.get_event_loop().call_exception_handler(context)
+                except RuntimeError:
+                    ...
+                break
+
+    async def disconnect(self) -> None:
+        ret = await asyncio.gather(
+            *(
+                asyncio.ensure_future(connection.disconnect())
+                for connection in self._connections
+            ),
+            return_exceptions=True,
+        )
+        exc = next((res for res in ret if isinstance(res, Exception)), None)
+        if exc:
+            raise exc
+
+    async def execute_command(self, *args, **kwargs) -> Any:
+        # Acquire connection
+        connection = None
+        if self._free:
+            for _ in range(len(self._free)):
+                connection = self._free.popleft()
+                if connection.is_connected:
+                    break
+                self._free.append(connection)
+            else:
+                connection = self._free.popleft()
+        else:
+            if len(self._connections) < self.max_connections:
+                connection = self.connection_class(**self.connection_kwargs)
+                self._connections.append(connection)
+            else:
+                raise ConnectionError("Too many connections")
+
+        # Execute command
+        command = connection.pack_command(*args)
+        await connection.send_packed_command(command, False)
+        try:
+            if NEVER_DECODE in kwargs:
+                response = await connection.read_response_without_lock(
+                    disable_decoding=True
+                )
+            else:
+                response = await connection.read_response_without_lock()
+        except ResponseError:
+            if EMPTY_RESPONSE in kwargs:
+                return kwargs[EMPTY_RESPONSE]
+            raise
+        finally:
+            # Release connection
+            self._free.append(connection)
+
+        # Return response
+        try:
+            return self.response_callbacks[args[0]](response, **kwargs)
+        except KeyError:
+            return response
+
+
+class NodesManager:
+    __slots__ = (
+        "_moved_exception",
+        "_require_full_coverage",
+        "connection_kwargs",
+        "default_node",
+        "nodes_cache",
+        "read_load_balancer",
+        "slots_cache",
+        "startup_nodes",
+    )
+
+    def __init__(
+        self,
+        startup_nodes: List["ClusterNode"],
+        require_full_coverage: bool = False,
+        **kwargs,
+    ) -> None:
+        self.nodes_cache = {}
+        self.slots_cache = {}
+        self.startup_nodes = {node.name: node for node in startup_nodes}
+        self.default_node = None
+        self._require_full_coverage = require_full_coverage
+        self._moved_exception = None
+        self.connection_kwargs = kwargs
+        self.read_load_balancer = LoadBalancer()
+
+    def get_node(
+        self,
+        host: Optional[str] = None,
+        port: Optional[int] = None,
+        node_name: Optional[str] = None,
+    ) -> "ClusterNode":
+        if host and port:
+            # the user passed host and port
+            if host == "localhost":
+                host = socket.gethostbyname(host)
+            return self.nodes_cache.get(get_node_name(host=host, port=port))
+        elif node_name:
+            return self.nodes_cache.get(node_name)
+        else:
+            raise DataError(
+                "get_node requires one of the following: "
+                "1. node name "
+                "2. host and port"
+            )
+
+    def set_nodes(
+        self,
+        old: Dict[str, "ClusterNode"],
+        new: Dict[str, "ClusterNode"],
+        remove_old=False,
+    ) -> None:
+        tasks = []
+        if remove_old:
+            tasks = [
+                asyncio.ensure_future(node.disconnect())
+                for name, node in old.items()
+                if name not in new
+            ]
+        for name, node in new.items():
+            if name in old:
+                if old[name] is node:
+                    continue
+                tasks.append(asyncio.ensure_future(old[name].disconnect()))
+            old[name] = node
+
+    def _update_moved_slots(self) -> None:
+        e = self._moved_exception
+        redirected_node = self.get_node(host=e.host, port=e.port)
+        if redirected_node:
+            # The node already exists
+            if redirected_node.server_type != PRIMARY:
+                # Update the node's server type
+                redirected_node.server_type = PRIMARY
+        else:
+            # This is a new node, we will add it to the nodes cache
+            redirected_node = ClusterNode(
+                e.host, e.port, PRIMARY, **self.connection_kwargs
+            )
+            self.set_nodes(self.nodes_cache, {redirected_node.name: redirected_node})
+        if redirected_node in self.slots_cache[e.slot_id]:
+            # The MOVED error resulted from a failover, and the new slot owner
+            # had previously been a replica.
+            old_primary = self.slots_cache[e.slot_id][0]
+            # Update the old primary to be a replica and add it to the end of
+            # the slot's node list
+            old_primary.server_type = REPLICA
+            self.slots_cache[e.slot_id].append(old_primary)
+            # Remove the old replica, which is now a primary, from the slot's
+            # node list
+            self.slots_cache[e.slot_id].remove(redirected_node)
+            # Override the old primary with the new one
+            self.slots_cache[e.slot_id][0] = redirected_node
+            if self.default_node == old_primary:
+                # Update the default node with the new primary
+                self.default_node = redirected_node
+        else:
+            # The new slot owner is a new server, or a server from a different
+            # shard. We need to remove all current nodes from the slot's list
+            # (including replications) and add just the new node.
+            self.slots_cache[e.slot_id] = [redirected_node]
+        # Reset moved_exception
+        self._moved_exception = None
+
+    def get_node_from_slot(
+        self, slot: int, read_from_replicas: bool = False
+    ) -> "ClusterNode":
+        if self._moved_exception:
+            self._update_moved_slots()
+
+        try:
+            if read_from_replicas:
+                # get the server index in a Round-Robin manner
+                primary_name = self.slots_cache[slot][0].name
+                node_idx = self.read_load_balancer.get_server_index(
+                    primary_name, len(self.slots_cache[slot])
+                )
+                return self.slots_cache[slot][node_idx]
+            return self.slots_cache[slot][0]
+        except (IndexError, TypeError):
+            raise SlotNotCoveredError(
+                f'Slot "{slot}" not covered by the cluster. '
+                f'"require_full_coverage={self._require_full_coverage}"'
+            )
+
+    def get_nodes_by_server_type(self, server_type: str) -> List["ClusterNode"]:
+        return [
+            node
+            for node in self.nodes_cache.values()
+            if node.server_type == server_type
+        ]
+
+    async def initialize(self) -> None:
+        self.read_load_balancer.reset()
+        tmp_nodes_cache = {}
+        tmp_slots = {}
+        disagreements = []
+        startup_nodes_reachable = False
+        fully_covered = False
+        for startup_node in self.startup_nodes.values():
+            try:
+                # Make sure cluster mode is enabled on this node
+                if not (await startup_node.execute_command("INFO")).get(
+                    "cluster_enabled"
+                ):
+                    raise RedisClusterException(
+                        "Cluster mode is not enabled on this node"
+                    )
+                cluster_slots = str_if_bytes(
+                    await startup_node.execute_command("CLUSTER SLOTS")
+                )
+                startup_nodes_reachable = True
+            except (ConnectionError, TimeoutError):
+                continue
+            except ResponseError as e:
+                # Isn't a cluster connection, so it won't parse these
+                # exceptions automatically
+                message = e.__str__()
+                if "CLUSTERDOWN" in message or "MASTERDOWN" in message:
+                    continue
+                else:
+                    raise RedisClusterException(
+                        'ERROR sending "cluster slots" command to redis '
+                        f"server: {startup_node}. error: {message}"
+                    )
+            except Exception as e:
+                message = e.__str__()
+                raise RedisClusterException(
+                    'ERROR sending "cluster slots" command to redis '
+                    f"server {startup_node.name}. error: {message}"
+                )
+
+            # CLUSTER SLOTS command results in the following output:
+            # [[slot_section[from_slot,to_slot,master,replica1,...,replicaN]]]
+            # where each node contains the following list: [IP, port, node_id]
+            # Therefore, cluster_slots[0][2][0] will be the IP address of the
+            # primary node of the first slot section.
+            # If there's only one server in the cluster, its ``host`` is ''
+            # Fix it to the host in startup_nodes
+            if (
+                len(cluster_slots) == 1
+                and not cluster_slots[0][2][0]
+                and len(self.startup_nodes) == 1
+            ):
+                cluster_slots[0][2][0] = startup_node.host
+
+            for slot in cluster_slots:
+                for i in range(2, len(slot)):
+                    slot[i] = [str_if_bytes(val) for val in slot[i]]
+                primary_node = slot[2]
+                host = primary_node[0]
+                if host == "":
+                    host = startup_node.host
+                port = int(primary_node[1])
+
+                target_node = tmp_nodes_cache.get(get_node_name(host, port))
+                if not target_node:
+                    target_node = ClusterNode(
+                        host, port, PRIMARY, **self.connection_kwargs
+                    )
+                # add this node to the nodes cache
+                tmp_nodes_cache[target_node.name] = target_node
+
+                for i in range(int(slot[0]), int(slot[1]) + 1):
+                    if i not in tmp_slots:
+                        tmp_slots[i] = []
+                        tmp_slots[i].append(target_node)
+                        replica_nodes = [slot[j] for j in range(3, len(slot))]
+
+                        for replica_node in replica_nodes:
+                            host = replica_node[0]
+                            port = replica_node[1]
+
+                            target_replica_node = tmp_nodes_cache.get(
+                                get_node_name(host, port)
+                            )
+                            if not target_replica_node:
+                                target_replica_node = ClusterNode(
+                                    host, port, REPLICA, **self.connection_kwargs
+                                )
+                            tmp_slots[i].append(target_replica_node)
+                            # add this node to the nodes cache
+                            tmp_nodes_cache[
+                                target_replica_node.name
+                            ] = target_replica_node
+                    else:
+                        # Validate that 2 nodes want to use the same slot cache
+                        # setup
+                        tmp_slot = tmp_slots[i][0]
+                        if tmp_slot.name != target_node.name:
+                            disagreements.append(
+                                f"{tmp_slot.name} vs {target_node.name} on slot: {i}"
+                            )
+
+                            if len(disagreements) > 5:
+                                raise RedisClusterException(
+                                    f"startup_nodes could not agree on a valid "
+                                    f'slots cache: {", ".join(disagreements)}'
+                                )
+
+            # Validate if all slots are covered or if we should try next startup node
+            fully_covered = True
+            for i in range(0, REDIS_CLUSTER_HASH_SLOTS):
+                if i not in tmp_slots:
+                    fully_covered = False
+                    break
+            if fully_covered:
+                break
+
+        if not startup_nodes_reachable:
+            raise RedisClusterException(
+                "Redis Cluster cannot be connected. Please provide at least "
+                "one reachable node. "
+            )
+
+        # Check if the slots are not fully covered
+        if not fully_covered and self._require_full_coverage:
+            # Despite the requirement that the slots be covered, there
+            # isn't a full coverage
+            raise RedisClusterException(
+                f"All slots are not covered after query all startup_nodes. "
+                f"{len(tmp_slots)} of {REDIS_CLUSTER_HASH_SLOTS} "
+                f"covered..."
+            )
+
+        # Set the tmp variables to the real variables
+        self.slots_cache = tmp_slots
+        self.set_nodes(self.nodes_cache, tmp_nodes_cache, remove_old=True)
+        # Populate the startup nodes with all discovered nodes
+        self.set_nodes(self.startup_nodes, self.nodes_cache, remove_old=True)
+
+        # Set the default node
+        self.default_node = self.get_nodes_by_server_type(PRIMARY)[0]
+        # If initialize was called after a MovedError, clear it
+        self._moved_exception = None
+
+    async def close(self, attr: str = "nodes_cache") -> None:
+        self.default_node = None
+        await asyncio.gather(
+            *(
+                asyncio.ensure_future(node.disconnect())
+                for node in getattr(self, attr).values()
+            )
+        )
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 91961ba674..9de2d46b7e 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -24,7 +24,6 @@
     Type,
     TypeVar,
     Union,
-    cast,
 )
 from urllib.parse import ParseResult, parse_qs, unquote, urlparse
 
@@ -110,32 +109,32 @@ def __init__(self, encoding: str, encoding_errors: str, decode_responses: bool):
 
     def encode(self, value: EncodableT) -> EncodedT:
         """Return a bytestring or bytes-like representation of the value"""
+        if isinstance(value, str):
+            return value.encode(self.encoding, self.encoding_errors)
         if isinstance(value, (bytes, memoryview)):
             return value
-        if isinstance(value, bool):
-            # special case bool since it is a subclass of int
-            raise DataError(
-                "Invalid input of type: 'bool'. "
-                "Convert to a bytes, string, int or float first."
-            )
         if isinstance(value, (int, float)):
+            if isinstance(value, bool):
+                # special case bool since it is a subclass of int
+                raise DataError(
+                    "Invalid input of type: 'bool'. "
+                    "Convert to a bytes, string, int or float first."
+                )
             return repr(value).encode()
-        if not isinstance(value, str):
-            # a value we don't know how to deal with. throw an error
-            typename = value.__class__.__name__  # type: ignore[unreachable]
-            raise DataError(
-                f"Invalid input of type: {typename!r}. "
-                "Convert to a bytes, string, int or float first."
-            )
-        return value.encode(self.encoding, self.encoding_errors)
+        # a value we don't know how to deal with. throw an error
+        typename = value.__class__.__name__
+        raise DataError(
+            f"Invalid input of type: {typename!r}. "
+            "Convert to a bytes, string, int or float first."
+        )
 
     def decode(self, value: EncodableT, force=False) -> EncodableT:
         """Return a unicode string from the bytes-like representation"""
         if self.decode_responses or force:
-            if isinstance(value, memoryview):
-                return value.tobytes().decode(self.encoding, self.encoding_errors)
             if isinstance(value, bytes):
                 return value.decode(self.encoding, self.encoding_errors)
+            if isinstance(value, memoryview):
+                return value.tobytes().decode(self.encoding, self.encoding_errors)
         return value
 
 
@@ -336,7 +335,7 @@ def purge(self):
     def close(self):
         try:
             self.purge()
-            self._buffer.close()  # type: ignore[union-attr]
+            self._buffer.close()
         except Exception:
             # issue #633 suggests the purge/close somehow raised a
             # BadFileDescriptor error. Perhaps the client ran out of
@@ -466,7 +465,7 @@ def on_disconnect(self):
         self._next_response = False
 
     async def can_read(self, timeout: float):
-        if not self._reader:
+        if not self._stream or not self._reader:
             raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
 
         if self._next_response is False:
@@ -480,14 +479,14 @@ async def read_from_socket(
         timeout: Union[float, None, _Sentinel] = SENTINEL,
         raise_on_timeout: bool = True,
     ):
-        if self._stream is None or self._reader is None:
-            raise RedisError("Parser already closed.")
-
         timeout = self._socket_timeout if timeout is SENTINEL else timeout
         try:
-            async with async_timeout.timeout(timeout):
+            if timeout is None:
                 buffer = await self._stream.read(self._read_size)
-            if not isinstance(buffer, bytes) or len(buffer) == 0:
+            else:
+                async with async_timeout.timeout(timeout):
+                    buffer = await self._stream.read(self._read_size)
+            if not buffer or not isinstance(buffer, bytes):
                 raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR) from None
             self._reader.feed(buffer)
             # data was read from the socket and added to the buffer.
@@ -516,9 +515,6 @@ async def read_response(
             self.on_disconnect()
             raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR) from None
 
-        response: Union[
-            EncodableT, ConnectionError, List[Union[EncodableT, ConnectionError]]
-        ]
         # _next_response might be cached from a can_read() call
         if self._next_response is not False:
             response = self._next_response
@@ -541,8 +537,7 @@ async def read_response(
             and isinstance(response[0], ConnectionError)
         ):
             raise response[0]
-        # cast as there won't be a ConnectionError here.
-        return cast(Union[EncodableT, List[EncodableT]], response)
+        return response
 
 
 DefaultParser: Type[Union[PythonParser, HiredisParser]]
@@ -637,7 +632,7 @@ def __init__(
         self.socket_type = socket_type
         self.retry_on_timeout = retry_on_timeout
         if retry_on_timeout:
-            if retry is None:
+            if not retry:
                 self.retry = Retry(NoBackoff(), 1)
             else:
                 # deep-copy the Retry object as it is mutable
@@ -681,7 +676,7 @@ def __del__(self):
 
     @property
     def is_connected(self):
-        return bool(self._reader and self._writer)
+        return self._reader and self._writer
 
     def register_connect_callback(self, callback):
         self._connect_callbacks.append(weakref.WeakMethod(callback))
@@ -713,7 +708,7 @@ async def connect(self):
             raise ConnectionError(exc) from exc
 
         try:
-            if self.redis_connect_func is None:
+            if not self.redis_connect_func:
                 # Use the default on_connect function
                 await self.on_connect()
             else:
@@ -745,7 +740,7 @@ async def _connect(self):
         self._reader = reader
         self._writer = writer
         sock = writer.transport.get_extra_info("socket")
-        if sock is not None:
+        if sock:
             sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)
             try:
                 # TCP_KEEPALIVE
@@ -856,32 +851,29 @@ async def check_health(self):
             await self.retry.call_with_retry(self._send_ping, self._ping_failed)
 
     async def _send_packed_command(self, command: Iterable[bytes]) -> None:
-        if self._writer is None:
-            raise RedisError("Connection already closed.")
-
         self._writer.writelines(command)
         await self._writer.drain()
 
     async def send_packed_command(
-        self,
-        command: Union[bytes, str, Iterable[bytes]],
-        check_health: bool = True,
-    ):
-        """Send an already packed command to the Redis server"""
-        if not self._writer:
+        self, command: Union[bytes, str, Iterable[bytes]], check_health: bool = True
+    ) -> None:
+        if not self.is_connected:
             await self.connect()
-        # guard against health check recursion
-        if check_health:
+        elif check_health:
             await self.check_health()
+
         try:
             if isinstance(command, str):
                 command = command.encode()
             if isinstance(command, bytes):
                 command = [command]
-            await asyncio.wait_for(
-                self._send_packed_command(command),
-                self.socket_timeout,
-            )
+            if self.socket_timeout:
+                await asyncio.wait_for(
+                    self._send_packed_command(command), self.socket_timeout
+                )
+            else:
+                self._writer.writelines(command)
+                await self._writer.drain()
         except asyncio.TimeoutError:
             await self.disconnect()
             raise TimeoutError("Timeout writing to socket") from None
@@ -901,8 +893,6 @@ async def send_packed_command(
 
     async def send_command(self, *args, **kwargs):
         """Pack and send a command to the Redis server"""
-        if not self.is_connected:
-            await self.connect()
         await self.send_packed_command(
             self.pack_command(*args), check_health=kwargs.get("check_health", True)
         )
@@ -923,10 +913,50 @@ async def read_response(self, disable_decoding: bool = False):
         """Read the response from a previously sent command"""
         try:
             async with self._lock:
+                if self.socket_timeout:
+                    async with async_timeout.timeout(self.socket_timeout):
+                        response = await self._parser.read_response(
+                            disable_decoding=disable_decoding
+                        )
+                else:
+                    response = await self._parser.read_response(
+                        disable_decoding=disable_decoding
+                    )
+        except asyncio.TimeoutError:
+            await self.disconnect()
+            raise TimeoutError(f"Timeout reading from {self.host}:{self.port}")
+        except OSError as e:
+            await self.disconnect()
+            raise ConnectionError(
+                f"Error while reading from {self.host}:{self.port} : {e.args}"
+            )
+        except BaseException:
+            await self.disconnect()
+            raise
+
+        if self.health_check_interval:
+            if sys.version_info[0:2] == (3, 6):
+                func = asyncio.get_event_loop
+            else:
+                func = asyncio.get_running_loop
+            self.next_health_check = func().time() + self.health_check_interval
+
+        if isinstance(response, ResponseError):
+            raise response from None
+        return response
+
+    async def read_response_without_lock(self, disable_decoding: bool = False):
+        """Read the response from a previously sent command"""
+        try:
+            if self.socket_timeout:
                 async with async_timeout.timeout(self.socket_timeout):
                     response = await self._parser.read_response(
                         disable_decoding=disable_decoding
                     )
+            else:
+                response = await self._parser.read_response(
+                    disable_decoding=disable_decoding
+                )
         except asyncio.TimeoutError:
             await self.disconnect()
             raise TimeoutError(f"Timeout reading from {self.host}:{self.port}")
@@ -1182,10 +1212,7 @@ def __init__(
         self._lock = asyncio.Lock()
 
     def repr_pieces(self) -> Iterable[Tuple[str, Union[str, int]]]:
-        pieces = [
-            ("path", self.path),
-            ("db", self.db),
-        ]
+        pieces = [("path", self.path), ("db", self.db)]
         if self.client_name:
             pieces.append(("client_name", self.client_name))
         return pieces
@@ -1254,12 +1281,11 @@ def parse_url(url: str) -> ConnectKwargs:
             parser = URL_QUERY_ARGUMENT_PARSERS.get(name)
             if parser:
                 try:
-                    # We can't type this.
-                    kwargs[name] = parser(value)  # type: ignore[misc]
+                    kwargs[name] = parser(value)
                 except (TypeError, ValueError):
                     raise ValueError(f"Invalid value for `{name}` in connection URL.")
             else:
-                kwargs[name] = value  # type: ignore[misc]
+                kwargs[name] = value
 
     if parsed.username:
         kwargs["username"] = unquote(parsed.username)
diff --git a/redis/asyncio/parser.py b/redis/asyncio/parser.py
new file mode 100644
index 0000000000..273fe0339f
--- /dev/null
+++ b/redis/asyncio/parser.py
@@ -0,0 +1,95 @@
+from typing import TYPE_CHECKING, List, Optional, Union
+
+from redis.exceptions import RedisError, ResponseError
+
+if TYPE_CHECKING:
+    from redis.asyncio.cluster import ClusterNode
+
+
+class CommandsParser:
+    """
+    Parses Redis commands to get command keys.
+
+    COMMAND output is used to determine key locations.
+    Commands that do not have a predefined key location are flagged with 'movablekeys',
+    and these commands' keys are determined by the command 'COMMAND GETKEYS'.
+
+    NOTE: Due to a bug in redis<7.0, this does not work properly
+    for EVAL or EVALSHA when the `numkeys` arg is 0.
+     - issue: https://github.com/redis/redis/issues/9493
+     - fix: https://github.com/redis/redis/pull/9733
+
+    So, don't use this with EVAL or EVALSHA.
+    """
+
+    __slots__ = ("commands",)
+
+    def __init__(self) -> None:
+        self.commands = {}
+
+    async def initialize(self, r: "ClusterNode") -> None:
+        commands = await r.execute_command("COMMAND")
+        for cmd, command in commands.items():
+            if "movablekeys" in command["flags"]:
+                commands[cmd] = -1
+            elif command["first_key_pos"] == 0 and command["last_key_pos"] == 0:
+                commands[cmd] = 0
+            elif command["first_key_pos"] == 1 and command["last_key_pos"] == 1:
+                commands[cmd] = 1
+        self.commands = {cmd.upper(): command for cmd, command in commands.items()}
+
+    # As soon as this PR is merged into Redis, we should reimplement
+    # our logic to use COMMAND INFO changes to determine the key positions
+    # https://github.com/redis/redis/pull/8324
+    async def get_keys(
+        self, redis_conn: "ClusterNode", *args
+    ) -> Optional[Union[List[str], List[bytes]]]:
+        if len(args) < 2:
+            # The command has no keys in it
+            return None
+
+        try:
+            command = self.commands[args[0]]
+        except KeyError:
+            # try to split the command name and to take only the main command
+            # e.g. 'memory' for 'memory usage'
+            args = args[0].split() + list(args[1:])
+            cmd_name = args[0]
+            if cmd_name not in self.commands:
+                # We'll try to reinitialize the commands cache, if the engine
+                # version has changed, the commands may not be current
+                await self.initialize(redis_conn)
+                if cmd_name not in self.commands:
+                    raise RedisError(
+                        f"{cmd_name.upper()} command doesn't exist in Redis commands"
+                    )
+
+            command = self.commands[cmd_name]
+
+        if command == 1:
+            return [args[1]]
+        if command == 0:
+            return None
+        if command == -1:
+            return await self._get_moveable_keys(redis_conn, *args)
+
+        last_key_pos = command["last_key_pos"]
+        if last_key_pos < 0:
+            last_key_pos = len(args) + last_key_pos
+        return args[command["first_key_pos"] : last_key_pos + 1 : command["step_count"]]
+
+    async def _get_moveable_keys(
+        self, redis_conn: "ClusterNode", *args
+    ) -> Optional[List[str]]:
+        try:
+            keys = await redis_conn.execute_command("COMMAND GETKEYS", *args)
+        except ResponseError as e:
+            message = e.__str__()
+            if (
+                "Invalid arguments" in message
+                or "The command has no key arguments" in message
+            ):
+                return None
+            else:
+                raise e
+        return keys
diff --git a/redis/client.py b/redis/client.py
index 87c79913d3..7c83b61d8e 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -410,11 +410,7 @@ def parse_slowlog_get(response, **options):
     space = " " if options.get("decode_responses", False) else b" "
 
     def parse_item(item):
-        result = {
-            "id": item[0],
-            "start_time": int(item[1]),
-            "duration": int(item[2]),
-        }
+        result = {"id": item[0], "start_time": int(item[1]), "duration": int(item[2])}
         # Redis Enterprise injects another entry at index [3], which has
         # the complexity info (i.e. the value N in case the command has
         # an O(N) complexity) instead of the command.
@@ -703,7 +699,7 @@ class AbstractRedis:
         **string_keys_to_dict("SORT", sort_return_tuples),
         **string_keys_to_dict("ZSCORE ZINCRBY GEODIST", float_or_none),
         **string_keys_to_dict(
-            "FLUSHALL FLUSHDB LSET LTRIM MSET PFMERGE READONLY READWRITE "
+            "FLUSHALL FLUSHDB LSET LTRIM MSET PFMERGE ASKING READONLY READWRITE "
             "RENAME SAVE SELECT SHUTDOWN SLAVEOF SWAPDB WATCH UNWATCH ",
             bool_ok,
         ),
@@ -753,17 +749,18 @@ class AbstractRedis:
         "CLUSTER DELSLOTSRANGE": bool_ok,
         "CLUSTER FAILOVER": bool_ok,
         "CLUSTER FORGET": bool_ok,
+        "CLUSTER GETKEYSINSLOT": lambda r: list(map(str_if_bytes, r)),
         "CLUSTER INFO": parse_cluster_info,
         "CLUSTER KEYSLOT": lambda x: int(x),
         "CLUSTER MEET": bool_ok,
         "CLUSTER NODES": parse_cluster_nodes,
+        "CLUSTER REPLICAS": parse_cluster_nodes,
         "CLUSTER REPLICATE": bool_ok,
         "CLUSTER RESET": bool_ok,
         "CLUSTER SAVECONFIG": bool_ok,
         "CLUSTER SET-CONFIG-EPOCH": bool_ok,
         "CLUSTER SETSLOT": bool_ok,
         "CLUSTER SLAVES": parse_cluster_nodes,
-        "CLUSTER REPLICAS": parse_cluster_nodes,
         "COMMAND": parse_command,
         "COMMAND COUNT": int,
         "COMMAND GETKEYS": lambda r: list(map(str_if_bytes, r)),
@@ -1035,11 +1032,7 @@ def set_response_callback(self, command, callback):
         """Set a custom Response Callback"""
         self.response_callbacks[command] = callback
 
-    def load_external_module(
-        self,
-        funcname,
-        func,
-    ):
+    def load_external_module(self, funcname, func):
         """
         This function can be used to add externally defined redis modules,
         and their namespaces to the redis client.
diff --git a/redis/cluster.py b/redis/cluster.py
index bf7ac2049b..d42d49b68a 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -128,10 +128,7 @@ def fix_server(*args):
     "unix_socket_path",
     "username",
 )
-KWARGS_DISABLED_KEYS = (
-    "host",
-    "port",
-)
+KWARGS_DISABLED_KEYS = ("host", "port")
 
 # Not complete, but covers the major ones
 # https://redis.io/commands
@@ -207,7 +204,7 @@ class ClusterParser(DefaultParser):
     )
 
 
-class RedisCluster(RedisClusterCommands):
+class AbstractRedisCluster:
     RedisClusterRequestTTL = 16
 
     PRIMARIES = "primaries"
@@ -308,10 +305,7 @@ class RedisCluster(RedisClusterCommands):
             ],
             PRIMARIES,
         ),
-        list_keys_to_dict(
-            ["FUNCTION DUMP"],
-            RANDOM,
-        ),
+        list_keys_to_dict(["FUNCTION DUMP"], RANDOM),
         list_keys_to_dict(
             [
                 "CLUSTER COUNTKEYSINSLOT",
@@ -360,49 +354,14 @@ class RedisCluster(RedisClusterCommands):
         ],
     )
 
-    CLUSTER_COMMANDS_RESPONSE_CALLBACKS = {
-        "CLUSTER ADDSLOTS": bool,
-        "CLUSTER ADDSLOTSRANGE": bool,
-        "CLUSTER COUNT-FAILURE-REPORTS": int,
-        "CLUSTER COUNTKEYSINSLOT": int,
-        "CLUSTER DELSLOTS": bool,
-        "CLUSTER DELSLOTSRANGE": bool,
-        "CLUSTER FAILOVER": bool,
-        "CLUSTER FORGET": bool,
-        "CLUSTER GETKEYSINSLOT": list,
-        "CLUSTER KEYSLOT": int,
-        "CLUSTER MEET": bool,
-        "CLUSTER REPLICATE": bool,
-        "CLUSTER RESET": bool,
-        "CLUSTER SAVECONFIG": bool,
-        "CLUSTER SET-CONFIG-EPOCH": bool,
-        "CLUSTER SETSLOT": bool,
-        "CLUSTER SLOTS": parse_cluster_slots,
-        "ASKING": bool,
-        "READONLY": bool,
-        "READWRITE": bool,
-    }
+    CLUSTER_COMMANDS_RESPONSE_CALLBACKS = {"CLUSTER SLOTS": parse_cluster_slots}
 
     RESULT_CALLBACKS = dict_merge(
+        list_keys_to_dict(["PUBSUB NUMSUB"], parse_pubsub_numsub),
         list_keys_to_dict(
-            [
-                "PUBSUB NUMSUB",
-            ],
-            parse_pubsub_numsub,
-        ),
-        list_keys_to_dict(
-            [
-                "PUBSUB NUMPAT",
-            ],
-            lambda command, res: sum(list(res.values())),
-        ),
-        list_keys_to_dict(
-            [
-                "KEYS",
-                "PUBSUB CHANNELS",
-            ],
-            merge_result,
+            ["PUBSUB NUMPAT"], lambda command, res: sum(list(res.values()))
         ),
+        list_keys_to_dict(["KEYS", "PUBSUB CHANNELS"], merge_result),
         list_keys_to_dict(
             [
                 "PING",
@@ -420,49 +379,69 @@ class RedisCluster(RedisClusterCommands):
             lambda command, res: all(res.values()) if isinstance(res, dict) else res,
         ),
         list_keys_to_dict(
-            [
-                "DBSIZE",
-                "WAIT",
-            ],
+            ["DBSIZE", "WAIT"],
             lambda command, res: sum(res.values()) if isinstance(res, dict) else res,
         ),
         list_keys_to_dict(
-            [
-                "CLIENT UNBLOCK",
-            ],
-            lambda command, res: 1 if sum(res.values()) > 0 else 0,
-        ),
-        list_keys_to_dict(
-            [
-                "SCAN",
-            ],
-            parse_scan_result,
-        ),
-        list_keys_to_dict(
-            [
-                "SCRIPT LOAD",
-            ],
-            lambda command, res: list(res.values()).pop(),
+            ["CLIENT UNBLOCK"], lambda command, res: 1 if sum(res.values()) > 0 else 0
         ),
+        list_keys_to_dict(["SCAN"], parse_scan_result),
         list_keys_to_dict(
-            [
-                "SCRIPT EXISTS",
-            ],
-            lambda command, res: [all(k) for k in zip(*res.values())],
+            ["SCRIPT LOAD"], lambda command, res: list(res.values()).pop()
         ),
         list_keys_to_dict(
-            [
-                "SCRIPT FLUSH",
-            ],
-            lambda command, res: all(res.values()),
+            ["SCRIPT EXISTS"], lambda command, res: [all(k) for k in zip(*res.values())]
         ),
+        list_keys_to_dict(["SCRIPT FLUSH"], lambda command, res: all(res.values())),
     )
 
-    ERRORS_ALLOW_RETRY = (
-        ConnectionError,
-        TimeoutError,
-        ClusterDownError,
-    )
+    ERRORS_ALLOW_RETRY = (ConnectionError, TimeoutError, ClusterDownError)
+
+
+class RedisCluster(AbstractRedisCluster, RedisClusterCommands):
+    @classmethod
+    def from_url(cls, url, **kwargs):
+        """
+        Return a Redis client object configured from the given URL
+
+        For example::
+
+            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 TCP socket connection. See more at:
+          <https://www.iana.org/assignments/uri-schemes/prov/redis>
+        - `rediss://` creates a SSL wrapped TCP socket connection. See more at:
+          <https://www.iana.org/assignments/uri-schemes/prov/rediss>
+        - ``unix://``: creates a Unix Domain Socket connection.
+
+        The username, password, hostname, path and all querystring values
+        are passed through urllib.parse.unquote in order to replace any
+        percent-encoded values with their corresponding characters.
+
+        There are several ways to specify a database number. The first value
+        found will be used:
+
+            1. A ``db`` querystring option, e.g. redis://localhost?db=0
+            2. If using the redis:// or rediss:// schemes, the path argument
+               of the url, e.g. redis://localhost/0
+            3. A ``db`` keyword argument to this function.
+
+        If none of these options are specified, the default db=0 is used.
+
+        All querystring options are cast to their appropriate Python types.
+        Boolean arguments can be specified with string values "True"/"False"
+        or "Yes"/"No". Values that cannot be properly cast cause a
+        ``ValueError`` to be raised. Once parsed, the querystring arguments
+        and keyword arguments are passed to the ``ConnectionPool``'s
+        class initializer. In the case of conflicting arguments, querystring
+        arguments always win.
+
+        """
+        return cls(url=url, **kwargs)
 
     def __init__(
         self,
@@ -617,50 +596,6 @@ def disconnect_connection_pools(self):
                     # Client was already disconnected. do nothing
                     pass
 
-    @classmethod
-    def from_url(cls, url, **kwargs):
-        """
-        Return a Redis client object configured from the given URL
-
-        For example::
-
-            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 TCP socket connection. See more at:
-          <https://www.iana.org/assignments/uri-schemes/prov/redis>
-        - `rediss://` creates a SSL wrapped TCP socket connection. See more at:
-          <https://www.iana.org/assignments/uri-schemes/prov/rediss>
-        - ``unix://``: creates a Unix Domain Socket connection.
-
-        The username, password, hostname, path and all querystring values
-        are passed through urllib.parse.unquote in order to replace any
-        percent-encoded values with their corresponding characters.
-
-        There are several ways to specify a database number. The first value
-        found will be used:
-
-            1. A ``db`` querystring option, e.g. redis://localhost?db=0
-            2. If using the redis:// or rediss:// schemes, the path argument
-               of the url, e.g. redis://localhost/0
-            3. A ``db`` keyword argument to this function.
-
-        If none of these options are specified, the default db=0 is used.
-
-        All querystring options are cast to their appropriate Python types.
-        Boolean arguments can be specified with string values "True"/"False"
-        or "Yes"/"No". Values that cannot be properly cast cause a
-        ``ValueError`` to be raised. Once parsed, the querystring arguments
-        and keyword arguments are passed to the ``ConnectionPool``'s
-        class initializer. In the case of conflicting arguments, querystring
-        arguments always win.
-
-        """
-        return cls(url=url, **kwargs)
-
     def on_connect(self, connection):
         """
         Initialize the connection, authenticate and select a database and send
@@ -996,9 +931,6 @@ def determine_slot(self, *args):
 
         return slots.pop()
 
-    def reinitialize_caches(self):
-        self.nodes_manager.initialize()
-
     def get_encoder(self):
         """
         Get the connections' encoder
@@ -1085,7 +1017,7 @@ def execute_command(self, *args, **kwargs):
                 # Return the processed result
                 return self._process_result(args[0], res, **kwargs)
             except BaseException as e:
-                if type(e) in RedisCluster.ERRORS_ALLOW_RETRY:
+                if type(e) in self.__class__.ERRORS_ALLOW_RETRY:
                     # The nodes and slots cache were reinitialized.
                     # Try again with the new cluster setup.
                     exception = e
@@ -1246,11 +1178,7 @@ def _process_result(self, command, res, **kwargs):
         else:
             return res
 
-    def load_external_module(
-        self,
-        funcname,
-        func,
-    ):
+    def load_external_module(self, funcname, func):
         """
         This function can be used to add externally defined redis modules,
         and their namespaces to the redis client.
@@ -1464,9 +1392,7 @@ def create_redis_connections(self, nodes):
         for node in nodes:
             if node.redis_connection is None:
                 node.redis_connection = self.create_redis_node(
-                    host=node.host,
-                    port=node.port,
-                    **self.connection_kwargs,
+                    host=node.host, port=node.port, **self.connection_kwargs
                 )
 
     def create_redis_node(self, host, port, **kwargs):
diff --git a/redis/commands/__init__.py b/redis/commands/__init__.py
index de21a9e818..e3383ff722 100644
--- a/redis/commands/__init__.py
+++ b/redis/commands/__init__.py
@@ -1,4 +1,4 @@
-from .cluster import RedisClusterCommands
+from .cluster import AsyncRedisClusterCommands, RedisClusterCommands
 from .core import AsyncCoreCommands, CoreCommands
 from .helpers import list_or_args
 from .parser import CommandsParser
@@ -6,6 +6,7 @@
 from .sentinel import AsyncSentinelCommands, SentinelCommands
 
 __all__ = [
+    "AsyncRedisClusterCommands",
     "RedisClusterCommands",
     "CommandsParser",
     "AsyncCoreCommands",
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index aaddb6aee5..06b702f9f9 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -1,27 +1,57 @@
-from typing import Iterator, Union
+import asyncio
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncIterator,
+    Dict,
+    Iterable,
+    Iterator,
+    List,
+    Mapping,
+    NoReturn,
+    Optional,
+    Union,
+)
 
+from redis.compat import Literal
 from redis.crc import key_slot
 from redis.exceptions import RedisClusterException, RedisError
-from redis.typing import PatternT
+from redis.typing import (
+    AnyKeyT,
+    ClusterCommandsProtocol,
+    EncodableT,
+    KeysT,
+    KeyT,
+    PatternT,
+)
 
 from .core import (
     ACLCommands,
+    AsyncACLCommands,
+    AsyncDataAccessCommands,
+    AsyncFunctionCommands,
+    AsyncManagementCommands,
+    AsyncScriptCommands,
     DataAccessCommands,
     FunctionCommands,
     ManagementCommands,
     PubSubCommands,
+    ResponseT,
     ScriptCommands,
 )
 from .helpers import list_or_args
 from .redismodules import RedisModuleCommands
 
+if TYPE_CHECKING:
+    from redis.asyncio.cluster import TargetNodesT
+
 
-class ClusterMultiKeyCommands:
+class ClusterMultiKeyCommands(ClusterCommandsProtocol):
     """
     A class containing commands that handle more than one key
     """
 
-    def _partition_keys_by_slot(self, keys):
+    def _partition_keys_by_slot(self, keys: Iterable[KeyT]) -> Dict[int, List[KeyT]]:
         """
         Split keys into a dictionary that maps a slot to
         a list of keys.
@@ -34,7 +64,7 @@ def _partition_keys_by_slot(self, keys):
 
         return slots_to_keys
 
-    def mget_nonatomic(self, keys, *args):
+    def mget_nonatomic(self, keys: KeysT, *args) -> List[Optional[Any]]:
         """
         Splits the keys into different slots and then calls MGET
         for the keys of every slot. This operation will not be atomic
@@ -70,7 +100,7 @@ def mget_nonatomic(self, keys, *args):
         vals_in_order = [all_results[key] for key in keys]
         return vals_in_order
 
-    def mset_nonatomic(self, mapping):
+    def mset_nonatomic(self, mapping: Mapping[AnyKeyT, EncodableT]) -> List[bool]:
         """
         Sets key/values based on a mapping. Mapping is a dictionary of
         key/value pairs. Both keys and values should be strings or types that
@@ -99,7 +129,7 @@ def mset_nonatomic(self, mapping):
 
         return res
 
-    def _split_command_across_slots(self, command, *keys):
+    def _split_command_across_slots(self, command: str, *keys: KeyT) -> int:
         """
         Runs the given command once for the keys
         of each slot. Returns the sum of the return values.
@@ -114,7 +144,7 @@ def _split_command_across_slots(self, command, *keys):
 
         return total
 
-    def exists(self, *keys):
+    def exists(self, *keys: KeyT) -> ResponseT:
         """
         Returns the number of ``names`` that exist in the
         whole cluster. The keys are first split up into slots
@@ -124,7 +154,7 @@ def exists(self, *keys):
         """
         return self._split_command_across_slots("EXISTS", *keys)
 
-    def delete(self, *keys):
+    def delete(self, *keys: KeyT) -> ResponseT:
         """
         Deletes the given keys in the cluster.
         The keys are first split up into slots
@@ -137,7 +167,7 @@ def delete(self, *keys):
         """
         return self._split_command_across_slots("DEL", *keys)
 
-    def touch(self, *keys):
+    def touch(self, *keys: KeyT) -> ResponseT:
         """
         Updates the last access time of given keys across the
         cluster.
@@ -152,7 +182,7 @@ def touch(self, *keys):
         """
         return self._split_command_across_slots("TOUCH", *keys)
 
-    def unlink(self, *keys):
+    def unlink(self, *keys: KeyT) -> ResponseT:
         """
         Remove the specified keys in a different thread.
 
@@ -167,160 +197,135 @@ def unlink(self, *keys):
         return self._split_command_across_slots("UNLINK", *keys)
 
 
-class ClusterManagementCommands(ManagementCommands):
+class AsyncClusterMultiKeyCommands(ClusterMultiKeyCommands):
     """
-    A class for Redis Cluster management commands
-
-    The class inherits from Redis's core ManagementCommands class and do the
-    required adjustments to work with cluster mode
+    A class containing commands that handle more than one key
     """
 
-    def slaveof(self, *args, **kwargs):
+    async def mget_nonatomic(self, keys: KeysT, *args) -> List[Optional[Any]]:
         """
-        Make the server a replica of another instance, or promote it as master.
+        Splits the keys into different slots and then calls MGET
+        for the keys of every slot. This operation will not be atomic
+        if keys belong to more than one slot.
 
-        For more information see https://redis.io/commands/slaveof
-        """
-        raise RedisClusterException("SLAVEOF is not supported in cluster mode")
+        Returns a list of values ordered identically to ``keys``
 
-    def replicaof(self, *args, **kwargs):
+        For more information see https://redis.io/commands/mget
         """
-        Make the server a replica of another instance, or promote it as master.
 
-        For more information see https://redis.io/commands/replicaof
-        """
-        raise RedisClusterException("REPLICAOF is not supported in cluster mode")
+        from redis.client import EMPTY_RESPONSE
 
-    def swapdb(self, *args, **kwargs):
-        """
-        Swaps two Redis databases.
+        options = {}
+        if not args:
+            options[EMPTY_RESPONSE] = []
 
-        For more information see https://redis.io/commands/swapdb
-        """
-        raise RedisClusterException("SWAPDB is not supported in cluster mode")
+        # Concatenate all keys into a list
+        keys = list_or_args(keys, args)
+        # Split keys into slots
+        slots_to_keys = self._partition_keys_by_slot(keys)
 
+        # Call MGET for every slot and concatenate
+        # the results
+        # We must make sure that the keys are returned in order
+        all_values = await asyncio.gather(
+            *(
+                asyncio.ensure_future(
+                    self.execute_command("MGET", *slot_keys, **options)
+                )
+                for slot_keys in slots_to_keys.values()
+            )
+        )
 
-class ClusterDataAccessCommands(DataAccessCommands):
-    """
-    A class for Redis Cluster Data Access Commands
+        all_results = {}
+        for slot_keys, slot_values in zip(slots_to_keys.values(), all_values):
+            all_results.update(dict(zip(slot_keys, slot_values)))
 
-    The class inherits from Redis's core DataAccessCommand class and do the
-    required adjustments to work with cluster mode
-    """
+        # Sort the results
+        vals_in_order = [all_results[key] for key in keys]
+        return vals_in_order
 
-    def stralgo(
-        self,
-        algo,
-        value1,
-        value2,
-        specific_argument="strings",
-        len=False,
-        idx=False,
-        minmatchlen=None,
-        withmatchlen=False,
-        **kwargs,
-    ):
+    async def mset_nonatomic(self, mapping: Mapping[AnyKeyT, EncodableT]) -> List[bool]:
         """
-        Implements complex algorithms that operate on strings.
-        Right now the only algorithm implemented is the LCS algorithm
-        (longest common substring). However new algorithms could be
-        implemented in the future.
+        Sets key/values based on a mapping. Mapping is a dictionary of
+        key/value pairs. Both keys and values should be strings or types that
+        can be cast to a string via str().
 
-        ``algo`` Right now must be LCS
-        ``value1`` and ``value2`` Can be two strings or two keys
-        ``specific_argument`` Specifying if the arguments to the algorithm
-        will be keys or strings. strings is the default.
-        ``len`` Returns just the len of the match.
-        ``idx`` Returns the match positions in each string.
-        ``minmatchlen`` Restrict the list of matches to the ones of a given
-        minimal length. Can be provided only when ``idx`` set to True.
-        ``withmatchlen`` Returns the matches with the len of the match.
-        Can be provided only when ``idx`` set to True.
+        Splits the keys into different slots and then calls MSET
+        for the keys of every slot. This operation will not be atomic
+        if keys belong to more than one slot.
 
-        For more information see https://redis.io/commands/stralgo
+        For more information see https://redis.io/commands/mset
         """
-        target_nodes = kwargs.pop("target_nodes", None)
-        if specific_argument == "strings" and target_nodes is None:
-            target_nodes = "default-node"
-        kwargs.update({"target_nodes": target_nodes})
-        return super().stralgo(
-            algo,
-            value1,
-            value2,
-            specific_argument,
-            len,
-            idx,
-            minmatchlen,
-            withmatchlen,
-            **kwargs,
-        )
 
-    def scan_iter(
-        self,
-        match: Union[PatternT, None] = None,
-        count: Union[int, None] = None,
-        _type: Union[str, None] = None,
-        **kwargs,
-    ) -> Iterator:
-        # Do the first query with cursor=0 for all nodes
-        cursors, data = self.scan(match=match, count=count, _type=_type, **kwargs)
-        yield from data
+        # Partition the keys by slot
+        slots_to_pairs = {}
+        for pair in mapping.items():
+            # encode the key
+            k = self.encoder.encode(pair[0])
+            slot = key_slot(k)
+            slots_to_pairs.setdefault(slot, []).extend(pair)
 
-        cursors = {name: cursor for name, cursor in cursors.items() if cursor != 0}
-        if cursors:
-            # Get nodes by name
-            nodes = {name: self.get_node(node_name=name) for name in cursors.keys()}
+        # Call MSET for every slot and concatenate
+        # the results (one result per slot)
+        return await asyncio.gather(
+            *(
+                asyncio.ensure_future(self.execute_command("MSET", *pairs))
+                for pairs in slots_to_pairs.values()
+            )
+        )
 
-            # Iterate over each node till its cursor is 0
-            kwargs.pop("target_nodes", None)
-            while cursors:
-                for name, cursor in cursors.items():
-                    cur, data = self.scan(
-                        cursor=cursor,
-                        match=match,
-                        count=count,
-                        _type=_type,
-                        target_nodes=nodes[name],
-                        **kwargs,
-                    )
-                    yield from data
-                    cursors[name] = cur[name]
+    async def _split_command_across_slots(self, command: str, *keys: KeyT) -> int:
+        """
+        Runs the given command once for the keys
+        of each slot. Returns the sum of the return values.
+        """
+        # Partition the keys by slot
+        slots_to_keys = self._partition_keys_by_slot(keys)
 
-                cursors = {
-                    name: cursor for name, cursor in cursors.items() if cursor != 0
-                }
+        # Sum up the reply from each command
+        return sum(
+            await asyncio.gather(
+                *(
+                    asyncio.ensure_future(self.execute_command(command, *slot_keys))
+                    for slot_keys in slots_to_keys.values()
+                )
+            )
+        )
 
 
-class RedisClusterCommands(
-    ClusterMultiKeyCommands,
-    ClusterManagementCommands,
-    ACLCommands,
-    PubSubCommands,
-    ClusterDataAccessCommands,
-    ScriptCommands,
-    FunctionCommands,
-    RedisModuleCommands,
-):
+class ClusterManagementCommands(ManagementCommands):
     """
-    A class for all Redis Cluster commands
+    A class for Redis Cluster management commands
 
-    For key-based commands, the target node(s) will be internally determined
-    by the keys' hash slot.
-    Non-key-based commands can be executed with the 'target_nodes' argument to
-    target specific nodes. By default, if target_nodes is not specified, the
-    command will be executed on the default cluster node.
+    The class inherits from Redis's core ManagementCommands class and do the
+    required adjustments to work with cluster mode
+    """
 
-    :param :target_nodes: type can be one of the followings:
-        - nodes flag: ALL_NODES, PRIMARIES, REPLICAS, RANDOM
-        - 'ClusterNode'
-        - 'list(ClusterNodes)'
-        - 'dict(any:clusterNodes)'
+    def slaveof(self, *args, **kwargs) -> NoReturn:
+        """
+        Make the server a replica of another instance, or promote it as master.
 
-    for example:
-        r.cluster_info(target_nodes=RedisCluster.ALL_NODES)
-    """
+        For more information see https://redis.io/commands/slaveof
+        """
+        raise RedisClusterException("SLAVEOF is not supported in cluster mode")
 
-    def cluster_myid(self, target_node):
+    def replicaof(self, *args, **kwargs) -> NoReturn:
+        """
+        Make the server a replica of another instance, or promote it as master.
+
+        For more information see https://redis.io/commands/replicaof
+        """
+        raise RedisClusterException("REPLICAOF is not supported in cluster mode")
+
+    def swapdb(self, *args, **kwargs) -> NoReturn:
+        """
+        Swaps two Redis databases.
+
+        For more information see https://redis.io/commands/swapdb
+        """
+        raise RedisClusterException("SWAPDB is not supported in cluster mode")
+
+    def cluster_myid(self, target_node: "TargetNodesT") -> ResponseT:
         """
         Returns the node's id.
 
@@ -331,7 +336,9 @@ def cluster_myid(self, target_node):
         """
         return self.execute_command("CLUSTER MYID", target_nodes=target_node)
 
-    def cluster_addslots(self, target_node, *slots):
+    def cluster_addslots(
+        self, target_node: "TargetNodesT", *slots: EncodableT
+    ) -> ResponseT:
         """
         Assign new hash slots to receiving node. Sends to specified node.
 
@@ -344,7 +351,9 @@ def cluster_addslots(self, target_node, *slots):
             "CLUSTER ADDSLOTS", *slots, target_nodes=target_node
         )
 
-    def cluster_addslotsrange(self, target_node, *slots):
+    def cluster_addslotsrange(
+        self, target_node: "TargetNodesT", *slots: EncodableT
+    ) -> ResponseT:
         """
         Similar to the CLUSTER ADDSLOTS command.
         The difference between the two commands is that ADDSLOTS takes a list of slots
@@ -360,7 +369,7 @@ def cluster_addslotsrange(self, target_node, *slots):
             "CLUSTER ADDSLOTSRANGE", *slots, target_nodes=target_node
         )
 
-    def cluster_countkeysinslot(self, slot_id):
+    def cluster_countkeysinslot(self, slot_id: int) -> ResponseT:
         """
         Return the number of local keys in the specified hash slot
         Send to node based on specified slot_id
@@ -369,7 +378,7 @@ def cluster_countkeysinslot(self, slot_id):
         """
         return self.execute_command("CLUSTER COUNTKEYSINSLOT", slot_id)
 
-    def cluster_count_failure_report(self, node_id):
+    def cluster_count_failure_report(self, node_id: str) -> ResponseT:
         """
         Return the number of failure reports active for a given node
         Sends to a random node
@@ -378,7 +387,7 @@ def cluster_count_failure_report(self, node_id):
         """
         return self.execute_command("CLUSTER COUNT-FAILURE-REPORTS", node_id)
 
-    def cluster_delslots(self, *slots):
+    def cluster_delslots(self, *slots: EncodableT) -> List[bool]:
         """
         Set hash slots as unbound in the cluster.
         It determines by it self what node the slot is in and sends it there
@@ -389,7 +398,7 @@ def cluster_delslots(self, *slots):
         """
         return [self.execute_command("CLUSTER DELSLOTS", slot) for slot in slots]
 
-    def cluster_delslotsrange(self, *slots):
+    def cluster_delslotsrange(self, *slots: EncodableT) -> ResponseT:
         """
         Similar to the CLUSTER DELSLOTS command.
         The difference is that CLUSTER DELSLOTS takes a list of hash slots to remove
@@ -400,7 +409,9 @@ def cluster_delslotsrange(self, *slots):
         """
         return self.execute_command("CLUSTER DELSLOTSRANGE", *slots)
 
-    def cluster_failover(self, target_node, option=None):
+    def cluster_failover(
+        self, target_node: "TargetNodesT", option: Optional[str] = None
+    ) -> ResponseT:
         """
         Forces a slave to perform a manual failover of its master
         Sends to specified node
@@ -422,7 +433,7 @@ def cluster_failover(self, target_node, option=None):
         else:
             return self.execute_command("CLUSTER FAILOVER", target_nodes=target_node)
 
-    def cluster_info(self, target_nodes=None):
+    def cluster_info(self, target_nodes: Optional["TargetNodesT"] = None) -> ResponseT:
         """
         Provides info about Redis Cluster node state.
         The command will be sent to a random node in the cluster if no target
@@ -432,7 +443,7 @@ def cluster_info(self, target_nodes=None):
         """
         return self.execute_command("CLUSTER INFO", target_nodes=target_nodes)
 
-    def cluster_keyslot(self, key):
+    def cluster_keyslot(self, key: str) -> ResponseT:
         """
         Returns the hash slot of the specified key
         Sends to random node in the cluster
@@ -441,7 +452,9 @@ def cluster_keyslot(self, key):
         """
         return self.execute_command("CLUSTER KEYSLOT", key)
 
-    def cluster_meet(self, host, port, target_nodes=None):
+    def cluster_meet(
+        self, host: str, port: int, target_nodes: Optional["TargetNodesT"] = None
+    ) -> ResponseT:
         """
         Force a node cluster to handshake with another node.
         Sends to specified node.
@@ -452,7 +465,7 @@ def cluster_meet(self, host, port, target_nodes=None):
             "CLUSTER MEET", host, port, target_nodes=target_nodes
         )
 
-    def cluster_nodes(self):
+    def cluster_nodes(self) -> ResponseT:
         """
         Get Cluster config for the node.
         Sends to random node in the cluster
@@ -461,7 +474,9 @@ def cluster_nodes(self):
         """
         return self.execute_command("CLUSTER NODES")
 
-    def cluster_replicate(self, target_nodes, node_id):
+    def cluster_replicate(
+        self, target_nodes: "TargetNodesT", node_id: str
+    ) -> ResponseT:
         """
         Reconfigure a node as a slave of the specified master node
 
@@ -471,7 +486,9 @@ def cluster_replicate(self, target_nodes, node_id):
             "CLUSTER REPLICATE", node_id, target_nodes=target_nodes
         )
 
-    def cluster_reset(self, soft=True, target_nodes=None):
+    def cluster_reset(
+        self, soft: bool = True, target_nodes: Optional["TargetNodesT"] = None
+    ) -> ResponseT:
         """
         Reset a Redis Cluster node
 
@@ -484,7 +501,9 @@ def cluster_reset(self, soft=True, target_nodes=None):
             "CLUSTER RESET", b"SOFT" if soft else b"HARD", target_nodes=target_nodes
         )
 
-    def cluster_save_config(self, target_nodes=None):
+    def cluster_save_config(
+        self, target_nodes: Optional["TargetNodesT"] = None
+    ) -> ResponseT:
         """
         Forces the node to save cluster state on disk
 
@@ -492,7 +511,7 @@ def cluster_save_config(self, target_nodes=None):
         """
         return self.execute_command("CLUSTER SAVECONFIG", target_nodes=target_nodes)
 
-    def cluster_get_keys_in_slot(self, slot, num_keys):
+    def cluster_get_keys_in_slot(self, slot: int, num_keys: int) -> ResponseT:
         """
         Returns the number of keys in the specified cluster slot
 
@@ -500,7 +519,9 @@ def cluster_get_keys_in_slot(self, slot, num_keys):
         """
         return self.execute_command("CLUSTER GETKEYSINSLOT", slot, num_keys)
 
-    def cluster_set_config_epoch(self, epoch, target_nodes=None):
+    def cluster_set_config_epoch(
+        self, epoch: int, target_nodes: Optional["TargetNodesT"] = None
+    ) -> ResponseT:
         """
         Set the configuration epoch in a new node
 
@@ -510,7 +531,9 @@ def cluster_set_config_epoch(self, epoch, target_nodes=None):
             "CLUSTER SET-CONFIG-EPOCH", epoch, target_nodes=target_nodes
         )
 
-    def cluster_setslot(self, target_node, node_id, slot_id, state):
+    def cluster_setslot(
+        self, target_node: "TargetNodesT", node_id: str, slot_id: int, state: str
+    ) -> ResponseT:
         """
         Bind an hash slot to a specific node
 
@@ -528,7 +551,7 @@ def cluster_setslot(self, target_node, node_id, slot_id, state):
         else:
             raise RedisError(f"Invalid slot state: {state}")
 
-    def cluster_setslot_stable(self, slot_id):
+    def cluster_setslot_stable(self, slot_id: int) -> ResponseT:
         """
         Clears migrating / importing state from the slot.
         It determines by it self what node the slot is in and sends it there.
@@ -537,7 +560,9 @@ def cluster_setslot_stable(self, slot_id):
         """
         return self.execute_command("CLUSTER SETSLOT", slot_id, "STABLE")
 
-    def cluster_replicas(self, node_id, target_nodes=None):
+    def cluster_replicas(
+        self, node_id: str, target_nodes: Optional["TargetNodesT"] = None
+    ) -> ResponseT:
         """
         Provides a list of replica nodes replicating from the specified primary
         target node.
@@ -548,7 +573,7 @@ def cluster_replicas(self, node_id, target_nodes=None):
             "CLUSTER REPLICAS", node_id, target_nodes=target_nodes
         )
 
-    def cluster_slots(self, target_nodes=None):
+    def cluster_slots(self, target_nodes: Optional["TargetNodesT"] = None) -> ResponseT:
         """
         Get array of Cluster slot to node mappings
 
@@ -556,7 +581,7 @@ def cluster_slots(self, target_nodes=None):
         """
         return self.execute_command("CLUSTER SLOTS", target_nodes=target_nodes)
 
-    def cluster_links(self, target_node):
+    def cluster_links(self, target_node: "TargetNodesT") -> ResponseT:
         """
         Each node in a Redis Cluster maintains a pair of long-lived TCP link with each
         peer in the cluster: One for sending outbound messages towards the peer and one
@@ -568,7 +593,7 @@ def cluster_links(self, target_node):
         """
         return self.execute_command("CLUSTER LINKS", target_nodes=target_node)
 
-    def readonly(self, target_nodes=None):
+    def readonly(self, target_nodes: Optional["TargetNodesT"] = None) -> ResponseT:
         """
         Enables read queries.
         The command will be sent to the default cluster node if target_nodes is
@@ -582,7 +607,7 @@ def readonly(self, target_nodes=None):
             self.read_from_replicas = True
         return self.execute_command("READONLY", target_nodes=target_nodes)
 
-    def readwrite(self, target_nodes=None):
+    def readwrite(self, target_nodes: Optional["TargetNodesT"] = None) -> ResponseT:
         """
         Disables read queries.
         The command will be sent to the default cluster node if target_nodes is
@@ -593,3 +618,227 @@ def readwrite(self, target_nodes=None):
         # Reset read from replicas flag
         self.read_from_replicas = False
         return self.execute_command("READWRITE", target_nodes=target_nodes)
+
+
+class AsyncClusterManagementCommands(
+    ClusterManagementCommands, AsyncManagementCommands
+):
+    """
+    A class for Redis Cluster management commands
+
+    The class inherits from Redis's core ManagementCommands class and do the
+    required adjustments to work with cluster mode
+    """
+
+    async def cluster_delslots(self, *slots: EncodableT) -> List[bool]:
+        """
+        Set hash slots as unbound in the cluster.
+        It determines by it self what node the slot is in and sends it there
+
+        Returns a list of the results for each processed slot.
+
+        For more information see https://redis.io/commands/cluster-delslots
+        """
+        return await asyncio.gather(
+            *(
+                asyncio.ensure_future(self.execute_command("CLUSTER DELSLOTS", slot))
+                for slot in slots
+            )
+        )
+
+
+class ClusterDataAccessCommands(DataAccessCommands):
+    """
+    A class for Redis Cluster Data Access Commands
+
+    The class inherits from Redis's core DataAccessCommand class and do the
+    required adjustments to work with cluster mode
+    """
+
+    def stralgo(
+        self,
+        algo: Literal["LCS"],
+        value1: KeyT,
+        value2: KeyT,
+        specific_argument: Union[Literal["strings"], Literal["keys"]] = "strings",
+        len: bool = False,
+        idx: bool = False,
+        minmatchlen: Optional[int] = None,
+        withmatchlen: bool = False,
+        **kwargs,
+    ) -> ResponseT:
+        """
+        Implements complex algorithms that operate on strings.
+        Right now the only algorithm implemented is the LCS algorithm
+        (longest common substring). However new algorithms could be
+        implemented in the future.
+
+        ``algo`` Right now must be LCS
+        ``value1`` and ``value2`` Can be two strings or two keys
+        ``specific_argument`` Specifying if the arguments to the algorithm
+        will be keys or strings. strings is the default.
+        ``len`` Returns just the len of the match.
+        ``idx`` Returns the match positions in each string.
+        ``minmatchlen`` Restrict the list of matches to the ones of a given
+        minimal length. Can be provided only when ``idx`` set to True.
+        ``withmatchlen`` Returns the matches with the len of the match.
+        Can be provided only when ``idx`` set to True.
+
+        For more information see https://redis.io/commands/stralgo
+        """
+        target_nodes = kwargs.pop("target_nodes", None)
+        if specific_argument == "strings" and target_nodes is None:
+            target_nodes = "default-node"
+        kwargs.update({"target_nodes": target_nodes})
+        return super().stralgo(
+            algo,
+            value1,
+            value2,
+            specific_argument,
+            len,
+            idx,
+            minmatchlen,
+            withmatchlen,
+            **kwargs,
+        )
+
+    def scan_iter(
+        self,
+        match: Optional[PatternT] = None,
+        count: Optional[int] = None,
+        _type: Optional[str] = None,
+        **kwargs,
+    ) -> Iterator:
+        # Do the first query with cursor=0 for all nodes
+        cursors, data = self.scan(match=match, count=count, _type=_type, **kwargs)
+        yield from data
+
+        cursors = {name: cursor for name, cursor in cursors.items() if cursor != 0}
+        if cursors:
+            # Get nodes by name
+            nodes = {name: self.get_node(node_name=name) for name in cursors.keys()}
+
+            # Iterate over each node till its cursor is 0
+            kwargs.pop("target_nodes", None)
+            while cursors:
+                for name, cursor in cursors.items():
+                    cur, data = self.scan(
+                        cursor=cursor,
+                        match=match,
+                        count=count,
+                        _type=_type,
+                        target_nodes=nodes[name],
+                        **kwargs,
+                    )
+                    yield from data
+                    cursors[name] = cur[name]
+
+                cursors = {
+                    name: cursor for name, cursor in cursors.items() if cursor != 0
+                }
+
+
+class AsyncClusterDataAccessCommands(
+    ClusterDataAccessCommands, AsyncDataAccessCommands
+):
+    """
+    A class for Redis Cluster Data Access Commands
+
+    The class inherits from Redis's core DataAccessCommand class and do the
+    required adjustments to work with cluster mode
+    """
+
+    async def scan_iter(
+        self,
+        match: Optional[PatternT] = None,
+        count: Optional[int] = None,
+        _type: Optional[str] = None,
+        **kwargs,
+    ) -> AsyncIterator:
+        # Do the first query with cursor=0 for all nodes
+        cursors, data = await self.scan(match=match, count=count, _type=_type, **kwargs)
+        for value in data:
+            yield value
+
+        cursors = {name: cursor for name, cursor in cursors.items() if cursor != 0}
+        if cursors:
+            # Get nodes by name
+            nodes = {name: self.get_node(node_name=name) for name in cursors.keys()}
+
+            # Iterate over each node till its cursor is 0
+            kwargs.pop("target_nodes", None)
+            while cursors:
+                for name, cursor in cursors.items():
+                    cur, data = await self.scan(
+                        cursor=cursor,
+                        match=match,
+                        count=count,
+                        _type=_type,
+                        target_nodes=nodes[name],
+                        **kwargs,
+                    )
+                    for value in data:
+                        yield value
+                    cursors[name] = cur[name]
+
+                cursors = {
+                    name: cursor for name, cursor in cursors.items() if cursor != 0
+                }
+
+
+class RedisClusterCommands(
+    ClusterMultiKeyCommands,
+    ClusterManagementCommands,
+    ACLCommands,
+    PubSubCommands,
+    ClusterDataAccessCommands,
+    ScriptCommands,
+    FunctionCommands,
+    RedisModuleCommands,
+):
+    """
+    A class for all Redis Cluster commands
+
+    For key-based commands, the target node(s) will be internally determined
+    by the keys' hash slot.
+    Non-key-based commands can be executed with the 'target_nodes' argument to
+    target specific nodes. By default, if target_nodes is not specified, the
+    command will be executed on the default cluster node.
+
+    :param :target_nodes: type can be one of the followings:
+        - nodes flag: ALL_NODES, PRIMARIES, REPLICAS, RANDOM
+        - 'ClusterNode'
+        - 'list(ClusterNodes)'
+        - 'dict(any:clusterNodes)'
+
+    for example:
+        r.cluster_info(target_nodes=RedisCluster.ALL_NODES)
+    """
+
+
+class AsyncRedisClusterCommands(
+    AsyncClusterMultiKeyCommands,
+    AsyncClusterManagementCommands,
+    AsyncACLCommands,
+    AsyncClusterDataAccessCommands,
+    AsyncScriptCommands,
+    AsyncFunctionCommands,
+):
+    """
+    A class for all Redis Cluster commands
+
+    For key-based commands, the target node(s) will be internally determined
+    by the keys' hash slot.
+    Non-key-based commands can be executed with the 'target_nodes' argument to
+    target specific nodes. By default, if target_nodes is not specified, the
+    command will be executed on the default cluster node.
+
+    :param :target_nodes: type can be one of the followings:
+        - nodes flag: ALL_NODES, PRIMARIES, REPLICAS, RANDOM
+        - 'ClusterNode'
+        - 'list(ClusterNodes)'
+        - 'dict(any:clusterNodes)'
+
+    for example:
+        r.cluster_info(target_nodes=RedisCluster.ALL_NODES)
+    """
diff --git a/redis/commands/parser.py b/redis/commands/parser.py
index 89292ab2d3..936f2ec97d 100644
--- a/redis/commands/parser.py
+++ b/redis/commands/parser.py
@@ -12,7 +12,6 @@ class CommandsParser:
     """
 
     def __init__(self, redis_connection):
-        self.initialized = False
         self.commands = {}
         self.initialize(redis_connection)
 
diff --git a/redis/crc.py b/redis/crc.py
index c47e2acede..e261241178 100644
--- a/redis/crc.py
+++ b/redis/crc.py
@@ -1,5 +1,7 @@
 from binascii import crc_hqx
 
+from redis.typing import EncodedT
+
 # Redis Cluster's key space is divided into 16384 slots.
 # For more information see: https://github.com/redis/redis/issues/2576
 REDIS_CLUSTER_HASH_SLOTS = 16384
@@ -7,7 +9,7 @@
 __all__ = ["key_slot", "REDIS_CLUSTER_HASH_SLOTS"]
 
 
-def key_slot(key, bucket=REDIS_CLUSTER_HASH_SLOTS):
+def key_slot(key: EncodedT, bucket: int = REDIS_CLUSTER_HASH_SLOTS) -> int:
     """Calculate key slot for a given key.
     See Keys distribution model in https://redis.io/topics/cluster-spec
     :param key - bytes
diff --git a/redis/typing.py b/redis/typing.py
index 73ae411f4d..6748612ff1 100644
--- a/redis/typing.py
+++ b/redis/typing.py
@@ -1,13 +1,14 @@
 # from __future__ import annotations
 
 from datetime import datetime, timedelta
-from typing import TYPE_CHECKING, Iterable, TypeVar, Union
+from typing import TYPE_CHECKING, Any, Awaitable, Iterable, TypeVar, Union
 
 from redis.compat import Protocol
 
 if TYPE_CHECKING:
     from redis.asyncio.connection import ConnectionPool as AsyncConnectionPool
-    from redis.connection import ConnectionPool
+    from redis.asyncio.connection import Encoder as AsyncEncoder
+    from redis.connection import ConnectionPool, Encoder
 
 
 EncodedT = Union[bytes, memoryview]
@@ -43,3 +44,10 @@ class CommandsProtocol(Protocol):
 
     def execute_command(self, *args, **options):
         ...
+
+
+class ClusterCommandsProtocol(CommandsProtocol):
+    encoder: Union["AsyncEncoder", "Encoder"]
+
+    def execute_command(self, *args, **options) -> Union[Any, Awaitable]:
+        ...
diff --git a/tests/conftest.py b/tests/conftest.py
index 903e961b46..e83c866f77 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -199,20 +199,21 @@ def wait_for_cluster_creation(redis_url, cluster_nodes, timeout=60):
 
 
 def skip_if_server_version_lt(min_version: str) -> _TestDecorator:
-    redis_version = REDIS_INFO["version"]
+    redis_version = REDIS_INFO.get("version", "0")
     check = Version(redis_version) < Version(min_version)
     return pytest.mark.skipif(check, reason=f"Redis version required >= {min_version}")
 
 
 def skip_if_server_version_gte(min_version: str) -> _TestDecorator:
-    redis_version = REDIS_INFO["version"]
+    redis_version = REDIS_INFO.get("version", "0")
     check = Version(redis_version) >= Version(min_version)
     return pytest.mark.skipif(check, reason=f"Redis version required < {min_version}")
 
 
 def skip_unless_arch_bits(arch_bits: int) -> _TestDecorator:
     return pytest.mark.skipif(
-        REDIS_INFO["arch_bits"] != arch_bits, reason=f"server is not {arch_bits}-bit"
+        REDIS_INFO.get("arch_bits", "") != arch_bits,
+        reason=f"server is not {arch_bits}-bit",
     )
 
 
@@ -235,12 +236,12 @@ def skip_ifmodversion_lt(min_version: str, module_name: str):
 
 
 def skip_if_redis_enterprise() -> _TestDecorator:
-    check = REDIS_INFO["enterprise"] is True
+    check = REDIS_INFO.get("enterprise", False) is True
     return pytest.mark.skipif(check, reason="Redis enterprise")
 
 
 def skip_ifnot_redis_enterprise() -> _TestDecorator:
-    check = REDIS_INFO["enterprise"] is False
+    check = REDIS_INFO.get("enterprise", False) is False
     return pytest.mark.skipif(check, reason="Not running in redis enterprise")
 
 
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index 02f2fc577f..b8b5583f32 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -36,12 +36,18 @@ async def _get_info(redis_url):
 
 @pytest_asyncio.fixture(
     params=[
-        (True, PythonParser),
+        pytest.param(
+            (True, PythonParser),
+            marks=pytest.mark.skipif(
+                REDIS_INFO["cluster_enabled"], reason="cluster mode enabled"
+            ),
+        ),
         (False, PythonParser),
         pytest.param(
             (True, HiredisParser),
             marks=pytest.mark.skipif(
-                not HIREDIS_AVAILABLE, reason="hiredis is not installed"
+                not HIREDIS_AVAILABLE or REDIS_INFO["cluster_enabled"],
+                reason="hiredis is not installed or cluster mode enabled",
             ),
         ),
         pytest.param(
@@ -62,29 +68,51 @@ def create_redis(request, event_loop: asyncio.BaseEventLoop):
     """Wrapper around redis.create_redis."""
     single_connection, parser_cls = request.param
 
-    async def f(url: str = request.config.getoption("--redis-url"), **kwargs):
-        single = kwargs.pop("single_connection_client", False) or single_connection
-        parser_class = kwargs.pop("parser_class", None) or parser_cls
-        url_options = parse_url(url)
-        url_options.update(kwargs)
-        pool = redis.ConnectionPool(parser_class=parser_class, **url_options)
-        client: redis.Redis = redis.Redis(connection_pool=pool)
+    async def f(
+        url: str = request.config.getoption("--redis-url"),
+        cls=redis.Redis,
+        flushdb=True,
+        **kwargs,
+    ):
+        cluster_mode = REDIS_INFO["cluster_enabled"]
+        if not cluster_mode:
+            single = kwargs.pop("single_connection_client", False) or single_connection
+            parser_class = kwargs.pop("parser_class", None) or parser_cls
+            url_options = parse_url(url)
+            url_options.update(kwargs)
+            pool = redis.ConnectionPool(parser_class=parser_class, **url_options)
+            client = cls(connection_pool=pool)
+        else:
+            client = redis.RedisCluster.from_url(url, **kwargs)
+            await client.initialize()
+            single = False
         if single:
             client = client.client()
             await client.initialize()
 
         def teardown():
             async def ateardown():
-                if "username" in kwargs:
-                    return
-                try:
-                    await client.flushdb()
-                except redis.ConnectionError:
-                    # handle cases where a test disconnected a client
-                    # just manually retry the flushdb
-                    await client.flushdb()
-                await client.close()
-                await client.connection_pool.disconnect()
+                if not cluster_mode:
+                    if "username" in kwargs:
+                        return
+                    if flushdb:
+                        try:
+                            await client.flushdb()
+                        except redis.ConnectionError:
+                            # handle cases where a test disconnected a client
+                            # just manually retry the flushdb
+                            await client.flushdb()
+                    await client.close()
+                    await client.connection_pool.disconnect()
+                else:
+                    if flushdb:
+                        try:
+                            await client.flushdb(target_nodes="primaries")
+                        except redis.ConnectionError:
+                            # handle cases where a test disconnected a client
+                            # just manually retry the flushdb
+                            await client.flushdb(target_nodes="primaries")
+                    await client.close()
 
             if event_loop.is_running():
                 event_loop.create_task(ateardown())
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
new file mode 100644
index 0000000000..6543e2849c
--- /dev/null
+++ b/tests/test_asyncio/test_cluster.py
@@ -0,0 +1,2232 @@
+import asyncio
+import binascii
+import datetime
+import sys
+import warnings
+
+import pytest
+
+from .compat import mock
+
+if sys.version_info[0:2] == (3, 6):
+    import pytest as pytest_asyncio
+else:
+    import pytest_asyncio
+
+from typing import Callable, Dict, List, Optional, Type, Union
+
+from _pytest.fixtures import FixtureRequest, SubRequest
+
+from redis.asyncio import Connection, RedisCluster
+from redis.asyncio.cluster import (
+    PRIMARY,
+    REDIS_CLUSTER_HASH_SLOTS,
+    REPLICA,
+    ClusterNode,
+    NodesManager,
+    get_node_name,
+)
+from redis.asyncio.parser import CommandsParser
+from redis.crc import key_slot
+from redis.exceptions import (
+    AskError,
+    ClusterDownError,
+    ConnectionError,
+    DataError,
+    MovedError,
+    NoPermissionError,
+    RedisClusterException,
+    RedisError,
+    ResponseError,
+)
+from redis.utils import str_if_bytes
+from tests.conftest import (
+    skip_if_redis_enterprise,
+    skip_if_server_version_lt,
+    skip_unless_arch_bits,
+)
+
+pytestmark = pytest.mark.asyncio
+
+default_host = "127.0.0.1"
+default_port = 7000
+default_cluster_slots = [
+    [0, 8191, ["127.0.0.1", 7000, "node_0"], ["127.0.0.1", 7003, "node_3"]],
+    [8192, 16383, ["127.0.0.1", 7001, "node_1"], ["127.0.0.1", 7002, "node_2"]],
+]
+
+
+@pytest_asyncio.fixture()
+async def slowlog(request: SubRequest, r: RedisCluster) -> None:
+    """
+    Set the slowlog threshold to 0, and the
+    max length to 128. This will force every
+    command into the slowlog and allow us
+    to test it
+    """
+    # Save old values
+    current_config = await r.config_get(target_nodes=r.get_primaries()[0])
+    old_slower_than_value = current_config["slowlog-log-slower-than"]
+    old_max_length_value = current_config["slowlog-max-len"]
+
+    # Set the new values
+    await r.config_set("slowlog-log-slower-than", 0)
+    await r.config_set("slowlog-max-len", 128)
+
+    yield
+
+    await r.config_set("slowlog-log-slower-than", old_slower_than_value)
+    await r.config_set("slowlog-max-len", old_max_length_value)
+
+
+async def get_mocked_redis_client(*args, **kwargs) -> RedisCluster:
+    """
+    Return a stable RedisCluster object that have deterministic
+    nodes and slots setup to remove the problem of different IP addresses
+    on different installations and machines.
+    """
+    cluster_slots = kwargs.pop("cluster_slots", default_cluster_slots)
+    coverage_res = kwargs.pop("coverage_result", "yes")
+    cluster_enabled = kwargs.pop("cluster_enabled", True)
+    with mock.patch.object(ClusterNode, "execute_command") as execute_command_mock:
+
+        async def execute_command(*_args, **_kwargs):
+            if _args[0] == "CLUSTER SLOTS":
+                mock_cluster_slots = cluster_slots
+                return mock_cluster_slots
+            elif _args[0] == "COMMAND":
+                return {"get": [], "set": []}
+            elif _args[0] == "INFO":
+                return {"cluster_enabled": cluster_enabled}
+            elif len(_args) > 1 and _args[1] == "cluster-require-full-coverage":
+                return {"cluster-require-full-coverage": coverage_res}
+            else:
+                return await execute_command_mock(*_args, **_kwargs)
+
+        execute_command_mock.side_effect = execute_command
+
+        with mock.patch.object(
+            CommandsParser, "initialize", autospec=True
+        ) as cmd_parser_initialize:
+
+            def cmd_init_mock(self, r):
+                self.commands = {
+                    "GET": {
+                        "name": "get",
+                        "arity": 2,
+                        "flags": ["readonly", "fast"],
+                        "first_key_pos": 1,
+                        "last_key_pos": 1,
+                        "step_count": 1,
+                    }
+                }
+
+            cmd_parser_initialize.side_effect = cmd_init_mock
+
+            return await RedisCluster(*args, **kwargs)
+
+
+def mock_node_resp(
+    node: ClusterNode,
+    response: Union[
+        List[List[Union[int, List[Union[str, int]]]]], List[bytes], str, int
+    ],
+) -> ClusterNode:
+    connection = mock.AsyncMock()
+    connection.is_connected = True
+    connection.read_response_without_lock.return_value = response
+    while node._free:
+        node._free.pop()
+    node._free.append(connection)
+    return node
+
+
+def mock_all_nodes_resp(
+    rc: RedisCluster,
+    response: Union[
+        List[List[Union[int, List[Union[str, int]]]]], List[bytes], int, str
+    ],
+) -> RedisCluster:
+    for node in rc.get_nodes():
+        mock_node_resp(node, response)
+    return rc
+
+
+async def moved_redirection_helper(
+    request: FixtureRequest, create_redis: Callable, failover: bool = False
+) -> None:
+    """
+    Test that the client handles MOVED response after a failover.
+    Redirection after a failover means that the redirection address is of a
+    replica that was promoted to a primary.
+
+    At first call it should return a MOVED ResponseError that will point
+    the client to the next server it should talk to.
+
+    Verify that:
+    1. it tries to talk to the redirected node
+    2. it updates the slot's primary to the redirected node
+
+    For a failover, also verify:
+    3. the redirected node's server type updated to 'primary'
+    4. the server type of the previous slot owner updated to 'replica'
+    """
+    rc = await create_redis(cls=RedisCluster, flushdb=False)
+    slot = 12182
+    redirect_node = None
+    # Get the current primary that holds this slot
+    prev_primary = rc.nodes_manager.get_node_from_slot(slot)
+    if failover:
+        if len(rc.nodes_manager.slots_cache[slot]) < 2:
+            warnings.warn("Skipping this test since it requires to have a " "replica")
+            return
+        redirect_node = rc.nodes_manager.slots_cache[slot][1]
+    else:
+        # Use one of the primaries to be the redirected node
+        redirect_node = rc.get_primaries()[0]
+    r_host = redirect_node.host
+    r_port = redirect_node.port
+    with mock.patch.object(
+        ClusterNode, "execute_command", autospec=True
+    ) as execute_command:
+
+        def moved_redirect_effect(self, *args, **options):
+            def ok_response(self, *args, **options):
+                assert self.host == r_host
+                assert self.port == r_port
+
+                return "MOCK_OK"
+
+            execute_command.side_effect = ok_response
+            raise MovedError(f"{slot} {r_host}:{r_port}")
+
+        execute_command.side_effect = moved_redirect_effect
+        assert await rc.execute_command("SET", "foo", "bar") == "MOCK_OK"
+        slot_primary = rc.nodes_manager.slots_cache[slot][0]
+        assert slot_primary == redirect_node
+        if failover:
+            assert rc.get_node(host=r_host, port=r_port).server_type == PRIMARY
+            assert prev_primary.server_type == REPLICA
+
+
+@pytest.mark.onlycluster
+class TestRedisClusterObj:
+    """
+    Tests for the RedisCluster class
+    """
+
+    async def test_host_port_startup_node(self) -> None:
+        """
+        Test that it is possible to use host & port arguments as startup node
+        args
+        """
+        cluster = await get_mocked_redis_client(host=default_host, port=default_port)
+        assert cluster.get_node(host=default_host, port=default_port) is not None
+
+        await cluster.close()
+
+    async def test_startup_nodes(self) -> None:
+        """
+        Test that it is possible to use startup_nodes
+        argument to init the cluster
+        """
+        port_1 = 7000
+        port_2 = 7001
+        startup_nodes = [
+            ClusterNode(default_host, port_1),
+            ClusterNode(default_host, port_2),
+        ]
+        cluster = await get_mocked_redis_client(startup_nodes=startup_nodes)
+        assert (
+            cluster.get_node(host=default_host, port=port_1) is not None
+            and cluster.get_node(host=default_host, port=port_2) is not None
+        )
+
+        await cluster.close()
+
+    async def test_empty_startup_nodes(self) -> None:
+        """
+        Test that exception is raised when empty providing empty startup_nodes
+        """
+        with pytest.raises(RedisClusterException) as ex:
+            RedisCluster(startup_nodes=[])
+
+        assert str(ex.value).startswith(
+            "RedisCluster requires at least one node to discover the " "cluster"
+        ), str_if_bytes(ex.value)
+
+    async def test_from_url(self, r: RedisCluster) -> None:
+        redis_url = f"redis://{default_host}:{default_port}/0"
+        with mock.patch.object(RedisCluster, "from_url") as from_url:
+
+            async def from_url_mocked(_url, **_kwargs):
+                return await get_mocked_redis_client(url=_url, **_kwargs)
+
+            from_url.side_effect = from_url_mocked
+            cluster = await RedisCluster.from_url(redis_url)
+        assert cluster.get_node(host=default_host, port=default_port) is not None
+
+        await cluster.close()
+
+    async def test_execute_command_errors(self, r: RedisCluster) -> None:
+        """
+        Test that if no key is provided then exception should be raised.
+        """
+        with pytest.raises(RedisClusterException) as ex:
+            await r.execute_command("GET")
+        assert str(ex.value).startswith(
+            "No way to dispatch this command to " "Redis Cluster. Missing key."
+        )
+
+    async def test_execute_command_node_flag_primaries(self, r: RedisCluster) -> None:
+        """
+        Test command execution with nodes flag PRIMARIES
+        """
+        primaries = r.get_primaries()
+        replicas = r.get_replicas()
+        mock_all_nodes_resp(r, "PONG")
+        assert await r.ping(target_nodes=RedisCluster.PRIMARIES) is True
+        for primary in primaries:
+            conn = primary._free.pop()
+            assert conn.read_response_without_lock.called is True
+        for replica in replicas:
+            conn = replica._free.pop()
+            assert conn.read_response_without_lock.called is not True
+
+    async def test_execute_command_node_flag_replicas(self, r: RedisCluster) -> None:
+        """
+        Test command execution with nodes flag REPLICAS
+        """
+        replicas = r.get_replicas()
+        if not replicas:
+            r = await get_mocked_redis_client(default_host, default_port)
+        primaries = r.get_primaries()
+        mock_all_nodes_resp(r, "PONG")
+        assert await r.ping(target_nodes=RedisCluster.REPLICAS) is True
+        for replica in replicas:
+            conn = replica._free.pop()
+            assert conn.read_response_without_lock.called is True
+        for primary in primaries:
+            conn = primary._free.pop()
+            assert conn.read_response_without_lock.called is not True
+
+        await r.close()
+
+    async def test_execute_command_node_flag_all_nodes(self, r: RedisCluster) -> None:
+        """
+        Test command execution with nodes flag ALL_NODES
+        """
+        mock_all_nodes_resp(r, "PONG")
+        assert await r.ping(target_nodes=RedisCluster.ALL_NODES) is True
+        for node in r.get_nodes():
+            conn = node._free.pop()
+            assert conn.read_response_without_lock.called is True
+
+    async def test_execute_command_node_flag_random(self, r: RedisCluster) -> None:
+        """
+        Test command execution with nodes flag RANDOM
+        """
+        mock_all_nodes_resp(r, "PONG")
+        assert await r.ping(target_nodes=RedisCluster.RANDOM) is True
+        called_count = 0
+        for node in r.get_nodes():
+            conn = node._free.pop()
+            if conn.read_response_without_lock.called is True:
+                called_count += 1
+        assert called_count == 1
+
+    async def test_execute_command_default_node(self, r: RedisCluster) -> None:
+        """
+        Test command execution without node flag is being executed on the
+        default node
+        """
+        def_node = r.get_default_node()
+        mock_node_resp(def_node, "PONG")
+        assert await r.ping() is True
+        conn = def_node._free.pop()
+        assert conn.read_response_without_lock.called
+
+    async def test_ask_redirection(self, r: RedisCluster) -> None:
+        """
+        Test that the server handles ASK response.
+
+        At first call it should return a ASK ResponseError that will point
+        the client to the next server it should talk to.
+
+        Important thing to verify is that it tries to talk to the second node.
+        """
+        redirect_node = r.get_nodes()[0]
+        with mock.patch.object(
+            ClusterNode, "execute_command", autospec=True
+        ) as execute_command:
+
+            def ask_redirect_effect(self, *args, **options):
+                def ok_response(self, *args, **options):
+                    assert self.host == redirect_node.host
+                    assert self.port == redirect_node.port
+
+                    return "MOCK_OK"
+
+                execute_command.side_effect = ok_response
+                raise AskError(f"12182 {redirect_node.host}:{redirect_node.port}")
+
+            execute_command.side_effect = ask_redirect_effect
+
+            assert await r.execute_command("SET", "foo", "bar") == "MOCK_OK"
+
+    async def test_moved_redirection(
+        self, request: FixtureRequest, create_redis: Callable
+    ) -> None:
+        """
+        Test that the client handles MOVED response.
+        """
+        await moved_redirection_helper(request, create_redis, failover=False)
+
+    async def test_moved_redirection_after_failover(
+        self, request: FixtureRequest, create_redis: Callable
+    ) -> None:
+        """
+        Test that the client handles MOVED response after a failover.
+        """
+        await moved_redirection_helper(request, create_redis, failover=True)
+
+    async def test_refresh_using_specific_nodes(
+        self, request: FixtureRequest, create_redis: Callable
+    ) -> None:
+        """
+        Test making calls on specific nodes when the cluster has failed over to
+        another node
+        """
+        node_7006 = ClusterNode(host=default_host, port=7006, server_type=PRIMARY)
+        node_7007 = ClusterNode(host=default_host, port=7007, server_type=PRIMARY)
+        with mock.patch.object(
+            ClusterNode, "execute_command", autospec=True
+        ) as execute_command:
+            with mock.patch.object(
+                NodesManager, "initialize", autospec=True
+            ) as initialize:
+                with mock.patch.multiple(
+                    Connection,
+                    send_packed_command=mock.DEFAULT,
+                    connect=mock.DEFAULT,
+                    can_read=mock.DEFAULT,
+                ) as mocks:
+                    # simulate 7006 as a failed node
+                    def execute_command_mock(self, *args, **options):
+                        if self.port == 7006:
+                            execute_command.failed_calls += 1
+                            raise ClusterDownError(
+                                "CLUSTERDOWN The cluster is "
+                                "down. Use CLUSTER INFO for "
+                                "more information"
+                            )
+                        elif self.port == 7007:
+                            execute_command.successful_calls += 1
+
+                    def initialize_mock(self):
+                        # start with all slots mapped to 7006
+                        self.nodes_cache = {node_7006.name: node_7006}
+                        self.default_node = node_7006
+                        self.slots_cache = {}
+
+                        for i in range(0, 16383):
+                            self.slots_cache[i] = [node_7006]
+
+                        # After the first connection fails, a reinitialize
+                        # should follow the cluster to 7007
+                        def map_7007(self):
+                            self.nodes_cache = {node_7007.name: node_7007}
+                            self.default_node = node_7007
+                            self.slots_cache = {}
+
+                            for i in range(0, 16383):
+                                self.slots_cache[i] = [node_7007]
+
+                        # Change initialize side effect for the second call
+                        initialize.side_effect = map_7007
+
+                    execute_command.side_effect = execute_command_mock
+                    execute_command.successful_calls = 0
+                    execute_command.failed_calls = 0
+                    initialize.side_effect = initialize_mock
+                    mocks["can_read"].return_value = False
+                    mocks["send_packed_command"].return_value = "MOCK_OK"
+                    mocks["connect"].return_value = None
+                    with mock.patch.object(
+                        CommandsParser, "initialize", autospec=True
+                    ) as cmd_parser_initialize:
+
+                        def cmd_init_mock(self, r):
+                            self.commands = {
+                                "GET": {
+                                    "name": "get",
+                                    "arity": 2,
+                                    "flags": ["readonly", "fast"],
+                                    "first_key_pos": 1,
+                                    "last_key_pos": 1,
+                                    "step_count": 1,
+                                }
+                            }
+
+                        cmd_parser_initialize.side_effect = cmd_init_mock
+
+                        rc = await create_redis(cls=RedisCluster, flushdb=False)
+                        assert len(rc.get_nodes()) == 1
+                        assert rc.get_node(node_name=node_7006.name) is not None
+
+                        await rc.get("foo")
+
+                        # Cluster should now point to 7007, and there should be
+                        # one failed and one successful call
+                        assert len(rc.get_nodes()) == 1
+                        assert rc.get_node(node_name=node_7007.name) is not None
+                        assert rc.get_node(node_name=node_7006.name) is None
+                        assert execute_command.failed_calls == 1
+                        assert execute_command.successful_calls == 1
+
+    async def test_reading_from_replicas_in_round_robin(self) -> None:
+        with mock.patch.multiple(
+            Connection,
+            send_command=mock.DEFAULT,
+            read_response_without_lock=mock.DEFAULT,
+            _connect=mock.DEFAULT,
+            can_read=mock.DEFAULT,
+            on_connect=mock.DEFAULT,
+        ) as mocks:
+            with mock.patch.object(
+                ClusterNode, "execute_command", autospec=True
+            ) as execute_command:
+
+                async def execute_command_mock_first(self, *args, **options):
+                    await self.connection_class(**self.connection_kwargs).connect()
+                    # Primary
+                    assert self.port == 7001
+                    execute_command.side_effect = execute_command_mock_second
+                    return "MOCK_OK"
+
+                def execute_command_mock_second(self, *args, **options):
+                    # Replica
+                    assert self.port == 7002
+                    execute_command.side_effect = execute_command_mock_third
+                    return "MOCK_OK"
+
+                def execute_command_mock_third(self, *args, **options):
+                    # Primary
+                    assert self.port == 7001
+                    return "MOCK_OK"
+
+                # We don't need to create a real cluster connection but we
+                # do want RedisCluster.on_connect function to get called,
+                # so we'll mock some of the Connection's functions to allow it
+                execute_command.side_effect = execute_command_mock_first
+                mocks["send_command"].return_value = True
+                mocks["read_response_without_lock"].return_value = "OK"
+                mocks["_connect"].return_value = True
+                mocks["can_read"].return_value = False
+                mocks["on_connect"].return_value = True
+
+                # Create a cluster with reading from replications
+                read_cluster = await get_mocked_redis_client(
+                    host=default_host, port=default_port, read_from_replicas=True
+                )
+                assert read_cluster.read_from_replicas is True
+                # Check that we read from the slot's nodes in a round robin
+                # matter.
+                # 'foo' belongs to slot 12182 and the slot's nodes are:
+                # [(127.0.0.1,7001,primary), (127.0.0.1,7002,replica)]
+                await read_cluster.get("foo")
+                await read_cluster.get("foo")
+                await read_cluster.get("foo")
+                mocks["send_command"].assert_has_calls([mock.call("READONLY")])
+
+                await read_cluster.close()
+
+    async def test_keyslot(self, r: RedisCluster) -> None:
+        """
+        Test that method will compute correct key in all supported cases
+        """
+        assert r.keyslot("foo") == 12182
+        assert r.keyslot("{foo}bar") == 12182
+        assert r.keyslot("{foo}") == 12182
+        assert r.keyslot(1337) == 4314
+
+        assert r.keyslot(125) == r.keyslot(b"125")
+        assert r.keyslot(125) == r.keyslot("\x31\x32\x35")
+        assert r.keyslot("大奖") == r.keyslot(b"\xe5\xa4\xa7\xe5\xa5\x96")
+        assert r.keyslot("大奖") == r.keyslot(b"\xe5\xa4\xa7\xe5\xa5\x96")
+        assert r.keyslot(1337.1234) == r.keyslot("1337.1234")
+        assert r.keyslot(1337) == r.keyslot("1337")
+        assert r.keyslot(b"abc") == r.keyslot("abc")
+
+    async def test_get_node_name(self) -> None:
+        assert (
+            get_node_name(default_host, default_port)
+            == f"{default_host}:{default_port}"
+        )
+
+    async def test_all_nodes(self, r: RedisCluster) -> None:
+        """
+        Set a list of nodes and it should be possible to iterate over all
+        """
+        nodes = [node for node in r.nodes_manager.nodes_cache.values()]
+
+        for i, node in enumerate(r.get_nodes()):
+            assert node in nodes
+
+    async def test_all_nodes_masters(self, r: RedisCluster) -> None:
+        """
+        Set a list of nodes with random primaries/replicas config and it shold
+        be possible to iterate over all of them.
+        """
+        nodes = [
+            node
+            for node in r.nodes_manager.nodes_cache.values()
+            if node.server_type == PRIMARY
+        ]
+
+        for node in r.get_primaries():
+            assert node in nodes
+
+    @pytest.mark.parametrize("error", RedisCluster.ERRORS_ALLOW_RETRY)
+    async def test_cluster_down_overreaches_retry_attempts(
+        self,
+        error: Union[Type[TimeoutError], Type[ClusterDownError], Type[ConnectionError]],
+    ) -> None:
+        """
+        When error that allows retry is thrown, test that we retry executing
+        the command as many times as configured in cluster_error_retry_attempts
+        and then raise the exception
+        """
+        with mock.patch.object(RedisCluster, "_execute_command") as execute_command:
+
+            def raise_error(target_node, *args, **kwargs):
+                execute_command.failed_calls += 1
+                raise error("mocked error")
+
+            execute_command.side_effect = raise_error
+
+            rc = await get_mocked_redis_client(host=default_host, port=default_port)
+
+            with pytest.raises(error):
+                await rc.get("bar")
+                assert execute_command.failed_calls == rc.cluster_error_retry_attempts
+
+            await rc.close()
+
+    async def test_set_default_node_success(self, r: RedisCluster) -> None:
+        """
+        test successful replacement of the default cluster node
+        """
+        default_node = r.get_default_node()
+        # get a different node
+        new_def_node = None
+        for node in r.get_nodes():
+            if node != default_node:
+                new_def_node = node
+                break
+        r.set_default_node(new_def_node)
+        assert r.get_default_node() == new_def_node
+
+    async def test_set_default_node_failure(self, r: RedisCluster) -> None:
+        """
+        test failed replacement of the default cluster node
+        """
+        default_node = r.get_default_node()
+        new_def_node = ClusterNode("1.1.1.1", 1111)
+        with pytest.raises(DataError):
+            r.set_default_node(None)
+        with pytest.raises(DataError):
+            r.set_default_node(new_def_node)
+        assert r.get_default_node() == default_node
+
+    async def test_get_node_from_key(self, r: RedisCluster) -> None:
+        """
+        Test that get_node_from_key function returns the correct node
+        """
+        key = "bar"
+        slot = r.keyslot(key)
+        slot_nodes = r.nodes_manager.slots_cache.get(slot)
+        primary = slot_nodes[0]
+        assert r.get_node_from_key(key, replica=False) == primary
+        replica = r.get_node_from_key(key, replica=True)
+        if replica is not None:
+            assert replica.server_type == REPLICA
+            assert replica in slot_nodes
+
+    @skip_if_redis_enterprise()
+    async def test_not_require_full_coverage_cluster_down_error(
+        self, r: RedisCluster
+    ) -> None:
+        """
+        When require_full_coverage is set to False (default client config) and not
+        all slots are covered, if one of the nodes has 'cluster-require_full_coverage'
+        config set to 'yes' some key-based commands should throw ClusterDownError
+        """
+        node = r.get_node_from_key("foo")
+        missing_slot = r.keyslot("foo")
+        assert await r.set("foo", "bar") is True
+        try:
+            assert all(await r.cluster_delslots(missing_slot))
+            with pytest.raises(ClusterDownError):
+                await r.exists("foo")
+        finally:
+            try:
+                # Add back the missing slot
+                assert await r.cluster_addslots(node, missing_slot) is True
+                # Make sure we are not getting ClusterDownError anymore
+                assert await r.exists("foo") == 1
+            except ResponseError as e:
+                if f"Slot {missing_slot} is already busy" in str(e):
+                    # It can happen if the test failed to delete this slot
+                    pass
+                else:
+                    raise e
+
+    async def test_can_run_concurrent_commands(self, r: RedisCluster) -> None:
+        assert await r.ping(target_nodes=RedisCluster.ALL_NODES) is True
+        assert all(
+            await asyncio.gather(
+                *(r.ping(target_nodes=RedisCluster.ALL_NODES) for _ in range(100))
+            )
+        )
+
+
+@pytest.mark.onlycluster
+class TestClusterRedisCommands:
+    """
+    Tests for RedisCluster unique commands
+    """
+
+    async def test_get_and_set(self, r: RedisCluster) -> None:
+        # get and set can't be tested independently of each other
+        assert await r.get("a") is None
+        byte_string = b"value"
+        integer = 5
+        unicode_string = chr(3456) + "abcd" + chr(3421)
+        assert await r.set("byte_string", byte_string)
+        assert await r.set("integer", 5)
+        assert await r.set("unicode_string", unicode_string)
+        assert await r.get("byte_string") == byte_string
+        assert await r.get("integer") == str(integer).encode()
+        assert (await r.get("unicode_string")).decode("utf-8") == unicode_string
+
+    async def test_mget_nonatomic(self, r: RedisCluster) -> None:
+        assert await r.mget_nonatomic([]) == []
+        assert await r.mget_nonatomic(["a", "b"]) == [None, None]
+        await r.set("a", "1")
+        await r.set("b", "2")
+        await r.set("c", "3")
+
+        assert await r.mget_nonatomic("a", "other", "b", "c") == [
+            b"1",
+            None,
+            b"2",
+            b"3",
+        ]
+
+    async def test_mset_nonatomic(self, r: RedisCluster) -> None:
+        d = {"a": b"1", "b": b"2", "c": b"3", "d": b"4"}
+        assert await r.mset_nonatomic(d)
+        for k, v in d.items():
+            assert await r.get(k) == v
+
+    async def test_config_set(self, r: RedisCluster) -> None:
+        assert await r.config_set("slowlog-log-slower-than", 0)
+
+    async def test_cluster_config_resetstat(self, r: RedisCluster) -> None:
+        await r.ping(target_nodes="all")
+        all_info = await r.info(target_nodes="all")
+        prior_commands_processed = -1
+        for node_info in all_info.values():
+            prior_commands_processed = node_info["total_commands_processed"]
+            assert prior_commands_processed >= 1
+        await r.config_resetstat(target_nodes="all")
+        all_info = await r.info(target_nodes="all")
+        for node_info in all_info.values():
+            reset_commands_processed = node_info["total_commands_processed"]
+            assert reset_commands_processed < prior_commands_processed
+
+    async def test_client_setname(self, r: RedisCluster) -> None:
+        node = r.get_random_node()
+        await r.client_setname("redis_py_test", target_nodes=node)
+        client_name = await r.client_getname(target_nodes=node)
+        assert client_name == "redis_py_test"
+
+    async def test_exists(self, r: RedisCluster) -> None:
+        d = {"a": b"1", "b": b"2", "c": b"3", "d": b"4"}
+        await r.mset_nonatomic(d)
+        assert await r.exists(*d.keys()) == len(d)
+
+    async def test_delete(self, r: RedisCluster) -> None:
+        d = {"a": b"1", "b": b"2", "c": b"3", "d": b"4"}
+        await r.mset_nonatomic(d)
+        assert await r.delete(*d.keys()) == len(d)
+        assert await r.delete(*d.keys()) == 0
+
+    async def test_touch(self, r: RedisCluster) -> None:
+        d = {"a": b"1", "b": b"2", "c": b"3", "d": b"4"}
+        await r.mset_nonatomic(d)
+        assert await r.touch(*d.keys()) == len(d)
+
+    async def test_unlink(self, r: RedisCluster) -> None:
+        d = {"a": b"1", "b": b"2", "c": b"3", "d": b"4"}
+        await r.mset_nonatomic(d)
+        assert await r.unlink(*d.keys()) == len(d)
+        # Unlink is non-blocking so we sleep before
+        # verifying the deletion
+        await asyncio.sleep(0.1)
+        assert await r.unlink(*d.keys()) == 0
+
+    @skip_if_redis_enterprise()
+    async def test_cluster_myid(self, r: RedisCluster) -> None:
+        node = r.get_random_node()
+        myid = await r.cluster_myid(node)
+        assert len(myid) == 40
+
+    @skip_if_redis_enterprise()
+    async def test_cluster_slots(self, r: RedisCluster) -> None:
+        mock_all_nodes_resp(r, default_cluster_slots)
+        cluster_slots = await r.cluster_slots()
+        assert isinstance(cluster_slots, dict)
+        assert len(default_cluster_slots) == len(cluster_slots)
+        assert cluster_slots.get((0, 8191)) is not None
+        assert cluster_slots.get((0, 8191)).get("primary") == ("127.0.0.1", 7000)
+
+    @skip_if_redis_enterprise()
+    async def test_cluster_addslots(self, r: RedisCluster) -> None:
+        node = r.get_random_node()
+        mock_node_resp(node, "OK")
+        assert await r.cluster_addslots(node, 1, 2, 3) is True
+
+    @skip_if_server_version_lt("7.0.0")
+    @skip_if_redis_enterprise()
+    async def test_cluster_addslotsrange(self, r: RedisCluster):
+        node = r.get_random_node()
+        mock_node_resp(node, "OK")
+        assert await r.cluster_addslotsrange(node, 1, 5)
+
+    @skip_if_redis_enterprise()
+    async def test_cluster_countkeysinslot(self, r: RedisCluster) -> None:
+        node = r.nodes_manager.get_node_from_slot(1)
+        mock_node_resp(node, 2)
+        assert await r.cluster_countkeysinslot(1) == 2
+
+    async def test_cluster_count_failure_report(self, r: RedisCluster) -> None:
+        mock_all_nodes_resp(r, 0)
+        assert await r.cluster_count_failure_report("node_0") == 0
+
+    @skip_if_redis_enterprise()
+    async def test_cluster_delslots(self) -> None:
+        cluster_slots = [
+            [0, 8191, ["127.0.0.1", 7000, "node_0"]],
+            [8192, 16383, ["127.0.0.1", 7001, "node_1"]],
+        ]
+        r = await get_mocked_redis_client(
+            host=default_host, port=default_port, cluster_slots=cluster_slots
+        )
+        mock_all_nodes_resp(r, "OK")
+        node0 = r.get_node(default_host, 7000)
+        node1 = r.get_node(default_host, 7001)
+        assert await r.cluster_delslots(0, 8192) == [True, True]
+        assert node0._free.pop().read_response_without_lock.called
+        assert node1._free.pop().read_response_without_lock.called
+
+        await r.close()
+
+    @skip_if_server_version_lt("7.0.0")
+    @skip_if_redis_enterprise()
+    async def test_cluster_delslotsrange(self, r: RedisCluster):
+        node = r.get_random_node()
+        mock_node_resp(node, "OK")
+        await r.cluster_addslots(node, 1, 2, 3, 4, 5)
+        assert await r.cluster_delslotsrange(1, 5)
+
+    @skip_if_redis_enterprise()
+    async def test_cluster_failover(self, r: RedisCluster) -> None:
+        node = r.get_random_node()
+        mock_node_resp(node, "OK")
+        assert await r.cluster_failover(node) is True
+        assert await r.cluster_failover(node, "FORCE") is True
+        assert await r.cluster_failover(node, "TAKEOVER") is True
+        with pytest.raises(RedisError):
+            await r.cluster_failover(node, "FORCT")
+
+    @skip_if_redis_enterprise()
+    async def test_cluster_info(self, r: RedisCluster) -> None:
+        info = await r.cluster_info()
+        assert isinstance(info, dict)
+        assert info["cluster_state"] == "ok"
+
+    @skip_if_redis_enterprise()
+    async def test_cluster_keyslot(self, r: RedisCluster) -> None:
+        mock_all_nodes_resp(r, 12182)
+        assert await r.cluster_keyslot("foo") == 12182
+
+    @skip_if_redis_enterprise()
+    async def test_cluster_meet(self, r: RedisCluster) -> None:
+        node = r.get_default_node()
+        mock_node_resp(node, "OK")
+        assert await r.cluster_meet("127.0.0.1", 6379) is True
+
+    @skip_if_redis_enterprise()
+    async def test_cluster_nodes(self, r: RedisCluster) -> None:
+        response = (
+            "c8253bae761cb1ecb2b61857d85dfe455a0fec8b 172.17.0.7:7006 "
+            "slave aa90da731f673a99617dfe930306549a09f83a6b 0 "
+            "1447836263059 5 connected\n"
+            "9bd595fe4821a0e8d6b99d70faa660638a7612b3 172.17.0.7:7008 "
+            "master - 0 1447836264065 0 connected\n"
+            "aa90da731f673a99617dfe930306549a09f83a6b 172.17.0.7:7003 "
+            "myself,master - 0 0 2 connected 5461-10922\n"
+            "1df047e5a594f945d82fc140be97a1452bcbf93e 172.17.0.7:7007 "
+            "slave 19efe5a631f3296fdf21a5441680f893e8cc96ec 0 "
+            "1447836262556 3 connected\n"
+            "4ad9a12e63e8f0207025eeba2354bcf4c85e5b22 172.17.0.7:7005 "
+            "master - 0 1447836262555 7 connected 0-5460\n"
+            "19efe5a631f3296fdf21a5441680f893e8cc96ec 172.17.0.7:7004 "
+            "master - 0 1447836263562 3 connected 10923-16383\n"
+            "fbb23ed8cfa23f17eaf27ff7d0c410492a1093d6 172.17.0.7:7002 "
+            "master,fail - 1447829446956 1447829444948 1 disconnected\n"
+        )
+        mock_all_nodes_resp(r, response)
+        nodes = await r.cluster_nodes()
+        assert len(nodes) == 7
+        assert nodes.get("172.17.0.7:7006") is not None
+        assert (
+            nodes.get("172.17.0.7:7006").get("node_id")
+            == "c8253bae761cb1ecb2b61857d85dfe455a0fec8b"
+        )
+
+    @skip_if_redis_enterprise()
+    async def test_cluster_nodes_importing_migrating(self, r: RedisCluster) -> None:
+        response = (
+            "488ead2fcce24d8c0f158f9172cb1f4a9e040fe5 127.0.0.1:16381@26381 "
+            "master - 0 1648975557664 3 connected 10923-16383\n"
+            "8ae2e70812db80776f739a72374e57fc4ae6f89d 127.0.0.1:16380@26380 "
+            "master - 0 1648975555000 2 connected 1 5461-10922 ["
+            "2-<-ed8007ccfa2d91a7b76f8e6fba7ba7e257034a16]\n"
+            "ed8007ccfa2d91a7b76f8e6fba7ba7e257034a16 127.0.0.1:16379@26379 "
+            "myself,master - 0 1648975556000 1 connected 0 2-5460 ["
+            "2->-8ae2e70812db80776f739a72374e57fc4ae6f89d]\n"
+        )
+        mock_all_nodes_resp(r, response)
+        nodes = await r.cluster_nodes()
+        assert len(nodes) == 3
+        node_16379 = nodes.get("127.0.0.1:16379")
+        node_16380 = nodes.get("127.0.0.1:16380")
+        node_16381 = nodes.get("127.0.0.1:16381")
+        assert node_16379.get("migrations") == [
+            {
+                "slot": "2",
+                "node_id": "8ae2e70812db80776f739a72374e57fc4ae6f89d",
+                "state": "migrating",
+            }
+        ]
+        assert node_16379.get("slots") == [["0"], ["2", "5460"]]
+        assert node_16380.get("migrations") == [
+            {
+                "slot": "2",
+                "node_id": "ed8007ccfa2d91a7b76f8e6fba7ba7e257034a16",
+                "state": "importing",
+            }
+        ]
+        assert node_16380.get("slots") == [["1"], ["5461", "10922"]]
+        assert node_16381.get("slots") == [["10923", "16383"]]
+        assert node_16381.get("migrations") == []
+
+    @skip_if_redis_enterprise()
+    async def test_cluster_replicate(self, r: RedisCluster) -> None:
+        node = r.get_random_node()
+        all_replicas = r.get_replicas()
+        mock_all_nodes_resp(r, "OK")
+        assert await r.cluster_replicate(node, "c8253bae761cb61857d") is True
+        results = await r.cluster_replicate(all_replicas, "c8253bae761cb61857d")
+        if isinstance(results, dict):
+            for res in results.values():
+                assert res is True
+        else:
+            assert results is True
+
+    @skip_if_redis_enterprise()
+    async def test_cluster_reset(self, r: RedisCluster) -> None:
+        mock_all_nodes_resp(r, "OK")
+        assert await r.cluster_reset() is True
+        assert await r.cluster_reset(False) is True
+        all_results = await r.cluster_reset(False, target_nodes="all")
+        for res in all_results.values():
+            assert res is True
+
+    @skip_if_redis_enterprise()
+    async def test_cluster_save_config(self, r: RedisCluster) -> None:
+        node = r.get_random_node()
+        all_nodes = r.get_nodes()
+        mock_all_nodes_resp(r, "OK")
+        assert await r.cluster_save_config(node) is True
+        all_results = await r.cluster_save_config(all_nodes)
+        for res in all_results.values():
+            assert res is True
+
+    @skip_if_redis_enterprise()
+    async def test_cluster_get_keys_in_slot(self, r: RedisCluster) -> None:
+        response = ["{foo}1", "{foo}2"]
+        node = r.nodes_manager.get_node_from_slot(12182)
+        mock_node_resp(node, response)
+        keys = await r.cluster_get_keys_in_slot(12182, 4)
+        assert keys == response
+
+    @skip_if_redis_enterprise()
+    async def test_cluster_set_config_epoch(self, r: RedisCluster) -> None:
+        mock_all_nodes_resp(r, "OK")
+        assert await r.cluster_set_config_epoch(3) is True
+        all_results = await r.cluster_set_config_epoch(3, target_nodes="all")
+        for res in all_results.values():
+            assert res is True
+
+    @skip_if_redis_enterprise()
+    async def test_cluster_setslot(self, r: RedisCluster) -> None:
+        node = r.get_random_node()
+        mock_node_resp(node, "OK")
+        assert await r.cluster_setslot(node, "node_0", 1218, "IMPORTING") is True
+        assert await r.cluster_setslot(node, "node_0", 1218, "NODE") is True
+        assert await r.cluster_setslot(node, "node_0", 1218, "MIGRATING") is True
+        with pytest.raises(RedisError):
+            await r.cluster_failover(node, "STABLE")
+        with pytest.raises(RedisError):
+            await r.cluster_failover(node, "STATE")
+
+    async def test_cluster_setslot_stable(self, r: RedisCluster) -> None:
+        node = r.nodes_manager.get_node_from_slot(12182)
+        mock_node_resp(node, "OK")
+        assert await r.cluster_setslot_stable(12182) is True
+        assert node._free.pop().read_response_without_lock.called
+
+    @skip_if_redis_enterprise()
+    async def test_cluster_replicas(self, r: RedisCluster) -> None:
+        response = [
+            b"01eca22229cf3c652b6fca0d09ff6941e0d2e3 "
+            b"127.0.0.1:6377@16377 slave "
+            b"52611e796814b78e90ad94be9d769a4f668f9a 0 "
+            b"1634550063436 4 connected",
+            b"r4xfga22229cf3c652b6fca0d09ff69f3e0d4d "
+            b"127.0.0.1:6378@16378 slave "
+            b"52611e796814b78e90ad94be9d769a4f668f9a 0 "
+            b"1634550063436 4 connected",
+        ]
+        mock_all_nodes_resp(r, response)
+        replicas = await r.cluster_replicas("52611e796814b78e90ad94be9d769a4f668f9a")
+        assert replicas.get("127.0.0.1:6377") is not None
+        assert replicas.get("127.0.0.1:6378") is not None
+        assert (
+            replicas.get("127.0.0.1:6378").get("node_id")
+            == "r4xfga22229cf3c652b6fca0d09ff69f3e0d4d"
+        )
+
+    @skip_if_server_version_lt("7.0.0")
+    async def test_cluster_links(self, r: RedisCluster):
+        node = r.get_random_node()
+        res = await r.cluster_links(node)
+        links_to = sum(x.count("to") for x in res)
+        links_for = sum(x.count("from") for x in res)
+        assert links_to == links_for
+        for i in range(0, len(res) - 1, 2):
+            assert res[i][3] == res[i + 1][3]
+
+    @skip_if_redis_enterprise()
+    async def test_readonly(self) -> None:
+        r = await get_mocked_redis_client(host=default_host, port=default_port)
+        mock_all_nodes_resp(r, "OK")
+        assert await r.readonly() is True
+        all_replicas_results = await r.readonly(target_nodes="replicas")
+        for res in all_replicas_results.values():
+            assert res is True
+        for replica in r.get_replicas():
+            assert replica._free.pop().read_response_without_lock.called
+
+        await r.close()
+
+    @skip_if_redis_enterprise()
+    async def test_readwrite(self) -> None:
+        r = await get_mocked_redis_client(host=default_host, port=default_port)
+        mock_all_nodes_resp(r, "OK")
+        assert await r.readwrite() is True
+        all_replicas_results = await r.readwrite(target_nodes="replicas")
+        for res in all_replicas_results.values():
+            assert res is True
+        for replica in r.get_replicas():
+            assert replica._free.pop().read_response_without_lock.called
+
+        await r.close()
+
+    @skip_if_redis_enterprise()
+    async def test_bgsave(self, r: RedisCluster) -> None:
+        assert await r.bgsave()
+        await asyncio.sleep(0.3)
+        assert await r.bgsave(True)
+
+    async def test_info(self, r: RedisCluster) -> None:
+        # Map keys to same slot
+        await r.set("x{1}", 1)
+        await r.set("y{1}", 2)
+        await r.set("z{1}", 3)
+        # Get node that handles the slot
+        slot = r.keyslot("x{1}")
+        node = r.nodes_manager.get_node_from_slot(slot)
+        # Run info on that node
+        info = await r.info(target_nodes=node)
+        assert isinstance(info, dict)
+        assert info["db0"]["keys"] == 3
+
+    async def _init_slowlog_test(self, r: RedisCluster, node: ClusterNode) -> str:
+        slowlog_lim = await r.config_get("slowlog-log-slower-than", target_nodes=node)
+        assert (
+            await r.config_set("slowlog-log-slower-than", 0, target_nodes=node) is True
+        )
+        return slowlog_lim["slowlog-log-slower-than"]
+
+    async def _teardown_slowlog_test(
+        self, r: RedisCluster, node: ClusterNode, prev_limit: str
+    ) -> None:
+        assert (
+            await r.config_set("slowlog-log-slower-than", prev_limit, target_nodes=node)
+            is True
+        )
+
+    async def test_slowlog_get(
+        self, r: RedisCluster, slowlog: Optional[List[Dict[str, Union[int, bytes]]]]
+    ) -> None:
+        unicode_string = chr(3456) + "abcd" + chr(3421)
+        node = r.get_node_from_key(unicode_string)
+        slowlog_limit = await self._init_slowlog_test(r, node)
+        assert await r.slowlog_reset(target_nodes=node)
+        await r.get(unicode_string)
+        slowlog = await r.slowlog_get(target_nodes=node)
+        assert isinstance(slowlog, list)
+        commands = [log["command"] for log in slowlog]
+
+        get_command = b" ".join((b"GET", unicode_string.encode("utf-8")))
+        assert get_command in commands
+        assert b"SLOWLOG RESET" in commands
+
+        # the order should be ['GET <uni string>', 'SLOWLOG RESET'],
+        # but if other clients are executing commands at the same time, there
+        # could be commands, before, between, or after, so just check that
+        # the two we care about are in the appropriate order.
+        assert commands.index(get_command) < commands.index(b"SLOWLOG RESET")
+
+        # make sure other attributes are typed correctly
+        assert isinstance(slowlog[0]["start_time"], int)
+        assert isinstance(slowlog[0]["duration"], int)
+        # rollback the slowlog limit to its original value
+        await self._teardown_slowlog_test(r, node, slowlog_limit)
+
+    async def test_slowlog_get_limit(
+        self, r: RedisCluster, slowlog: Optional[List[Dict[str, Union[int, bytes]]]]
+    ) -> None:
+        assert await r.slowlog_reset()
+        node = r.get_node_from_key("foo")
+        slowlog_limit = await self._init_slowlog_test(r, node)
+        await r.get("foo")
+        slowlog = await r.slowlog_get(1, target_nodes=node)
+        assert isinstance(slowlog, list)
+        # only one command, based on the number we passed to slowlog_get()
+        assert len(slowlog) == 1
+        await self._teardown_slowlog_test(r, node, slowlog_limit)
+
+    async def test_slowlog_length(self, r: RedisCluster, slowlog: None) -> None:
+        await r.get("foo")
+        node = r.nodes_manager.get_node_from_slot(key_slot(b"foo"))
+        slowlog_len = await r.slowlog_len(target_nodes=node)
+        assert isinstance(slowlog_len, int)
+
+    async def test_time(self, r: RedisCluster) -> None:
+        t = await r.time(target_nodes=r.get_primaries()[0])
+        assert len(t) == 2
+        assert isinstance(t[0], int)
+        assert isinstance(t[1], int)
+
+    @skip_if_server_version_lt("4.0.0")
+    async def test_memory_usage(self, r: RedisCluster) -> None:
+        await r.set("foo", "bar")
+        assert isinstance(await r.memory_usage("foo"), int)
+
+    @skip_if_server_version_lt("4.0.0")
+    @skip_if_redis_enterprise()
+    async def test_memory_malloc_stats(self, r: RedisCluster) -> None:
+        assert await r.memory_malloc_stats()
+
+    @skip_if_server_version_lt("4.0.0")
+    @skip_if_redis_enterprise()
+    async def test_memory_stats(self, r: RedisCluster) -> None:
+        # put a key into the current db to make sure that "db.<current-db>"
+        # has data
+        await r.set("foo", "bar")
+        node = r.nodes_manager.get_node_from_slot(key_slot(b"foo"))
+        stats = await r.memory_stats(target_nodes=node)
+        assert isinstance(stats, dict)
+        for key, value in stats.items():
+            if key.startswith("db."):
+                assert isinstance(value, dict)
+
+    @skip_if_server_version_lt("4.0.0")
+    async def test_memory_help(self, r: RedisCluster) -> None:
+        with pytest.raises(NotImplementedError):
+            await r.memory_help()
+
+    @skip_if_server_version_lt("4.0.0")
+    async def test_memory_doctor(self, r: RedisCluster) -> None:
+        with pytest.raises(NotImplementedError):
+            await r.memory_doctor()
+
+    @skip_if_redis_enterprise()
+    async def test_lastsave(self, r: RedisCluster) -> None:
+        node = r.get_primaries()[0]
+        assert isinstance(await r.lastsave(target_nodes=node), datetime.datetime)
+
+    async def test_cluster_echo(self, r: RedisCluster) -> None:
+        node = r.get_primaries()[0]
+        assert await r.echo("foo bar", target_nodes=node) == b"foo bar"
+
+    @skip_if_server_version_lt("1.0.0")
+    async def test_debug_segfault(self, r: RedisCluster) -> None:
+        with pytest.raises(NotImplementedError):
+            await r.debug_segfault()
+
+    async def test_config_resetstat(self, r: RedisCluster) -> None:
+        node = r.get_primaries()[0]
+        await r.ping(target_nodes=node)
+        prior_commands_processed = int(
+            (await r.info(target_nodes=node))["total_commands_processed"]
+        )
+        assert prior_commands_processed >= 1
+        await r.config_resetstat(target_nodes=node)
+        reset_commands_processed = int(
+            (await r.info(target_nodes=node))["total_commands_processed"]
+        )
+        assert reset_commands_processed < prior_commands_processed
+
+    @skip_if_server_version_lt("6.2.0")
+    async def test_client_trackinginfo(self, r: RedisCluster) -> None:
+        node = r.get_primaries()[0]
+        res = await r.client_trackinginfo(target_nodes=node)
+        assert len(res) > 2
+        assert "prefixes" in res
+
+    @skip_if_server_version_lt("2.9.50")
+    async def test_client_pause(self, r: RedisCluster) -> None:
+        node = r.get_primaries()[0]
+        assert await r.client_pause(1, target_nodes=node)
+        assert await r.client_pause(timeout=1, target_nodes=node)
+        with pytest.raises(RedisError):
+            await r.client_pause(timeout="not an integer", target_nodes=node)
+
+    @skip_if_server_version_lt("6.2.0")
+    @skip_if_redis_enterprise()
+    async def test_client_unpause(self, r: RedisCluster) -> None:
+        assert await r.client_unpause()
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_client_id(self, r: RedisCluster) -> None:
+        node = r.get_primaries()[0]
+        assert await r.client_id(target_nodes=node) > 0
+
+    @skip_if_server_version_lt("5.0.0")
+    async def test_client_unblock(self, r: RedisCluster) -> None:
+        node = r.get_primaries()[0]
+        myid = await r.client_id(target_nodes=node)
+        assert not await r.client_unblock(myid, target_nodes=node)
+        assert not await r.client_unblock(myid, error=True, target_nodes=node)
+        assert not await r.client_unblock(myid, error=False, target_nodes=node)
+
+    @skip_if_server_version_lt("6.0.0")
+    async def test_client_getredir(self, r: RedisCluster) -> None:
+        node = r.get_primaries()[0]
+        assert isinstance(await r.client_getredir(target_nodes=node), int)
+        assert await r.client_getredir(target_nodes=node) == -1
+
+    @skip_if_server_version_lt("6.2.0")
+    async def test_client_info(self, r: RedisCluster) -> None:
+        node = r.get_primaries()[0]
+        info = await r.client_info(target_nodes=node)
+        assert isinstance(info, dict)
+        assert "addr" in info
+
+    @skip_if_server_version_lt("2.6.9")
+    async def test_client_kill(self, r: RedisCluster, r2: RedisCluster) -> None:
+        node = r.get_primaries()[0]
+        await r.client_setname("redis-py-c1", target_nodes="all")
+        await r2.client_setname("redis-py-c2", target_nodes="all")
+        clients = [
+            client
+            for client in await r.client_list(target_nodes=node)
+            if client.get("name") in ["redis-py-c1", "redis-py-c2"]
+        ]
+        assert len(clients) == 2
+        clients_by_name = {client.get("name"): client for client in clients}
+
+        client_addr = clients_by_name["redis-py-c2"].get("addr")
+        assert await r.client_kill(client_addr, target_nodes=node) is True
+
+        clients = [
+            client
+            for client in await r.client_list(target_nodes=node)
+            if client.get("name") in ["redis-py-c1", "redis-py-c2"]
+        ]
+        assert len(clients) == 1
+        assert clients[0].get("name") == "redis-py-c1"
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_cluster_bitop_not_empty_string(self, r: RedisCluster) -> None:
+        await r.set("{foo}a", "")
+        await r.bitop("not", "{foo}r", "{foo}a")
+        assert await r.get("{foo}r") is None
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_cluster_bitop_not(self, r: RedisCluster) -> None:
+        test_str = b"\xAA\x00\xFF\x55"
+        correct = ~0xAA00FF55 & 0xFFFFFFFF
+        await r.set("{foo}a", test_str)
+        await r.bitop("not", "{foo}r", "{foo}a")
+        assert int(binascii.hexlify(await r.get("{foo}r")), 16) == correct
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_cluster_bitop_not_in_place(self, r: RedisCluster) -> None:
+        test_str = b"\xAA\x00\xFF\x55"
+        correct = ~0xAA00FF55 & 0xFFFFFFFF
+        await r.set("{foo}a", test_str)
+        await r.bitop("not", "{foo}a", "{foo}a")
+        assert int(binascii.hexlify(await r.get("{foo}a")), 16) == correct
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_cluster_bitop_single_string(self, r: RedisCluster) -> None:
+        test_str = b"\x01\x02\xFF"
+        await r.set("{foo}a", test_str)
+        await r.bitop("and", "{foo}res1", "{foo}a")
+        await r.bitop("or", "{foo}res2", "{foo}a")
+        await r.bitop("xor", "{foo}res3", "{foo}a")
+        assert await r.get("{foo}res1") == test_str
+        assert await r.get("{foo}res2") == test_str
+        assert await r.get("{foo}res3") == test_str
+
+    @skip_if_server_version_lt("2.6.0")
+    async def test_cluster_bitop_string_operands(self, r: RedisCluster) -> None:
+        await r.set("{foo}a", b"\x01\x02\xFF\xFF")
+        await r.set("{foo}b", b"\x01\x02\xFF")
+        await r.bitop("and", "{foo}res1", "{foo}a", "{foo}b")
+        await r.bitop("or", "{foo}res2", "{foo}a", "{foo}b")
+        await r.bitop("xor", "{foo}res3", "{foo}a", "{foo}b")
+        assert int(binascii.hexlify(await r.get("{foo}res1")), 16) == 0x0102FF00
+        assert int(binascii.hexlify(await r.get("{foo}res2")), 16) == 0x0102FFFF
+        assert int(binascii.hexlify(await r.get("{foo}res3")), 16) == 0x000000FF
+
+    @skip_if_server_version_lt("6.2.0")
+    async def test_cluster_copy(self, r: RedisCluster) -> None:
+        assert await r.copy("{foo}a", "{foo}b") == 0
+        await r.set("{foo}a", "bar")
+        assert await r.copy("{foo}a", "{foo}b") == 1
+        assert await r.get("{foo}a") == b"bar"
+        assert await r.get("{foo}b") == b"bar"
+
+    @skip_if_server_version_lt("6.2.0")
+    async def test_cluster_copy_and_replace(self, r: RedisCluster) -> None:
+        await r.set("{foo}a", "foo1")
+        await r.set("{foo}b", "foo2")
+        assert await r.copy("{foo}a", "{foo}b") == 0
+        assert await r.copy("{foo}a", "{foo}b", replace=True) == 1
+
+    @skip_if_server_version_lt("6.2.0")
+    async def test_cluster_lmove(self, r: RedisCluster) -> None:
+        await r.rpush("{foo}a", "one", "two", "three", "four")
+        assert await r.lmove("{foo}a", "{foo}b")
+        assert await r.lmove("{foo}a", "{foo}b", "right", "left")
+
+    @skip_if_server_version_lt("6.2.0")
+    async def test_cluster_blmove(self, r: RedisCluster) -> None:
+        await r.rpush("{foo}a", "one", "two", "three", "four")
+        assert await r.blmove("{foo}a", "{foo}b", 5)
+        assert await r.blmove("{foo}a", "{foo}b", 1, "RIGHT", "LEFT")
+
+    async def test_cluster_msetnx(self, r: RedisCluster) -> None:
+        d = {"{foo}a": b"1", "{foo}b": b"2", "{foo}c": b"3"}
+        assert await r.msetnx(d)
+        d2 = {"{foo}a": b"x", "{foo}d": b"4"}
+        assert not await r.msetnx(d2)
+        for k, v in d.items():
+            assert await r.get(k) == v
+        assert await r.get("{foo}d") is None
+
+    async def test_cluster_rename(self, r: RedisCluster) -> None:
+        await r.set("{foo}a", "1")
+        assert await r.rename("{foo}a", "{foo}b")
+        assert await r.get("{foo}a") is None
+        assert await r.get("{foo}b") == b"1"
+
+    async def test_cluster_renamenx(self, r: RedisCluster) -> None:
+        await r.set("{foo}a", "1")
+        await r.set("{foo}b", "2")
+        assert not await r.renamenx("{foo}a", "{foo}b")
+        assert await r.get("{foo}a") == b"1"
+        assert await r.get("{foo}b") == b"2"
+
+    # LIST COMMANDS
+    async def test_cluster_blpop(self, r: RedisCluster) -> None:
+        await r.rpush("{foo}a", "1", "2")
+        await r.rpush("{foo}b", "3", "4")
+        assert await r.blpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"3")
+        assert await r.blpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"4")
+        assert await r.blpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"1")
+        assert await r.blpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"2")
+        assert await r.blpop(["{foo}b", "{foo}a"], timeout=1) is None
+        await r.rpush("{foo}c", "1")
+        assert await r.blpop("{foo}c", timeout=1) == (b"{foo}c", b"1")
+
+    async def test_cluster_brpop(self, r: RedisCluster) -> None:
+        await r.rpush("{foo}a", "1", "2")
+        await r.rpush("{foo}b", "3", "4")
+        assert await r.brpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"4")
+        assert await r.brpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"3")
+        assert await r.brpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"2")
+        assert await r.brpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"1")
+        assert await r.brpop(["{foo}b", "{foo}a"], timeout=1) is None
+        await r.rpush("{foo}c", "1")
+        assert await r.brpop("{foo}c", timeout=1) == (b"{foo}c", b"1")
+
+    async def test_cluster_brpoplpush(self, r: RedisCluster) -> None:
+        await r.rpush("{foo}a", "1", "2")
+        await r.rpush("{foo}b", "3", "4")
+        assert await r.brpoplpush("{foo}a", "{foo}b") == b"2"
+        assert await r.brpoplpush("{foo}a", "{foo}b") == b"1"
+        assert await r.brpoplpush("{foo}a", "{foo}b", timeout=1) is None
+        assert await r.lrange("{foo}a", 0, -1) == []
+        assert await r.lrange("{foo}b", 0, -1) == [b"1", b"2", b"3", b"4"]
+
+    async def test_cluster_brpoplpush_empty_string(self, r: RedisCluster) -> None:
+        await r.rpush("{foo}a", "")
+        assert await r.brpoplpush("{foo}a", "{foo}b") == b""
+
+    async def test_cluster_rpoplpush(self, r: RedisCluster) -> None:
+        await r.rpush("{foo}a", "a1", "a2", "a3")
+        await r.rpush("{foo}b", "b1", "b2", "b3")
+        assert await r.rpoplpush("{foo}a", "{foo}b") == b"a3"
+        assert await r.lrange("{foo}a", 0, -1) == [b"a1", b"a2"]
+        assert await r.lrange("{foo}b", 0, -1) == [b"a3", b"b1", b"b2", b"b3"]
+
+    async def test_cluster_sdiff(self, r: RedisCluster) -> None:
+        await r.sadd("{foo}a", "1", "2", "3")
+        assert await r.sdiff("{foo}a", "{foo}b") == {b"1", b"2", b"3"}
+        await r.sadd("{foo}b", "2", "3")
+        assert await r.sdiff("{foo}a", "{foo}b") == {b"1"}
+
+    async def test_cluster_sdiffstore(self, r: RedisCluster) -> None:
+        await r.sadd("{foo}a", "1", "2", "3")
+        assert await r.sdiffstore("{foo}c", "{foo}a", "{foo}b") == 3
+        assert await r.smembers("{foo}c") == {b"1", b"2", b"3"}
+        await r.sadd("{foo}b", "2", "3")
+        assert await r.sdiffstore("{foo}c", "{foo}a", "{foo}b") == 1
+        assert await r.smembers("{foo}c") == {b"1"}
+
+    async def test_cluster_sinter(self, r: RedisCluster) -> None:
+        await r.sadd("{foo}a", "1", "2", "3")
+        assert await r.sinter("{foo}a", "{foo}b") == set()
+        await r.sadd("{foo}b", "2", "3")
+        assert await r.sinter("{foo}a", "{foo}b") == {b"2", b"3"}
+
+    async def test_cluster_sinterstore(self, r: RedisCluster) -> None:
+        await r.sadd("{foo}a", "1", "2", "3")
+        assert await r.sinterstore("{foo}c", "{foo}a", "{foo}b") == 0
+        assert await r.smembers("{foo}c") == set()
+        await r.sadd("{foo}b", "2", "3")
+        assert await r.sinterstore("{foo}c", "{foo}a", "{foo}b") == 2
+        assert await r.smembers("{foo}c") == {b"2", b"3"}
+
+    async def test_cluster_smove(self, r: RedisCluster) -> None:
+        await r.sadd("{foo}a", "a1", "a2")
+        await r.sadd("{foo}b", "b1", "b2")
+        assert await r.smove("{foo}a", "{foo}b", "a1")
+        assert await r.smembers("{foo}a") == {b"a2"}
+        assert await r.smembers("{foo}b") == {b"b1", b"b2", b"a1"}
+
+    async def test_cluster_sunion(self, r: RedisCluster) -> None:
+        await r.sadd("{foo}a", "1", "2")
+        await r.sadd("{foo}b", "2", "3")
+        assert await r.sunion("{foo}a", "{foo}b") == {b"1", b"2", b"3"}
+
+    async def test_cluster_sunionstore(self, r: RedisCluster) -> None:
+        await r.sadd("{foo}a", "1", "2")
+        await r.sadd("{foo}b", "2", "3")
+        assert await r.sunionstore("{foo}c", "{foo}a", "{foo}b") == 3
+        assert await r.smembers("{foo}c") == {b"1", b"2", b"3"}
+
+    @skip_if_server_version_lt("6.2.0")
+    async def test_cluster_zdiff(self, r: RedisCluster) -> None:
+        await r.zadd("{foo}a", {"a1": 1, "a2": 2, "a3": 3})
+        await r.zadd("{foo}b", {"a1": 1, "a2": 2})
+        assert await r.zdiff(["{foo}a", "{foo}b"]) == [b"a3"]
+        assert await r.zdiff(["{foo}a", "{foo}b"], withscores=True) == [b"a3", b"3"]
+
+    @skip_if_server_version_lt("6.2.0")
+    async def test_cluster_zdiffstore(self, r: RedisCluster) -> None:
+        await r.zadd("{foo}a", {"a1": 1, "a2": 2, "a3": 3})
+        await r.zadd("{foo}b", {"a1": 1, "a2": 2})
+        assert await r.zdiffstore("{foo}out", ["{foo}a", "{foo}b"])
+        assert await r.zrange("{foo}out", 0, -1) == [b"a3"]
+        assert await r.zrange("{foo}out", 0, -1, withscores=True) == [(b"a3", 3.0)]
+
+    @skip_if_server_version_lt("6.2.0")
+    async def test_cluster_zinter(self, r: RedisCluster) -> None:
+        await r.zadd("{foo}a", {"a1": 1, "a2": 2, "a3": 1})
+        await r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
+        await r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
+        assert await r.zinter(["{foo}a", "{foo}b", "{foo}c"]) == [b"a3", b"a1"]
+        # invalid aggregation
+        with pytest.raises(DataError):
+            await r.zinter(
+                ["{foo}a", "{foo}b", "{foo}c"], aggregate="foo", withscores=True
+            )
+        # aggregate with SUM
+        assert await r.zinter(["{foo}a", "{foo}b", "{foo}c"], withscores=True) == [
+            (b"a3", 8),
+            (b"a1", 9),
+        ]
+        # aggregate with MAX
+        assert await r.zinter(
+            ["{foo}a", "{foo}b", "{foo}c"], aggregate="MAX", withscores=True
+        ) == [(b"a3", 5), (b"a1", 6)]
+        # aggregate with MIN
+        assert await r.zinter(
+            ["{foo}a", "{foo}b", "{foo}c"], aggregate="MIN", withscores=True
+        ) == [(b"a1", 1), (b"a3", 1)]
+        # with weights
+        assert await r.zinter(
+            {"{foo}a": 1, "{foo}b": 2, "{foo}c": 3}, withscores=True
+        ) == [(b"a3", 20), (b"a1", 23)]
+
+    async def test_cluster_zinterstore_sum(self, r: RedisCluster) -> None:
+        await r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
+        await r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
+        await r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
+        assert await r.zinterstore("{foo}d", ["{foo}a", "{foo}b", "{foo}c"]) == 2
+        assert await r.zrange("{foo}d", 0, -1, withscores=True) == [
+            (b"a3", 8),
+            (b"a1", 9),
+        ]
+
+    async def test_cluster_zinterstore_max(self, r: RedisCluster) -> None:
+        await r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
+        await r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
+        await r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
+        assert (
+            await r.zinterstore(
+                "{foo}d", ["{foo}a", "{foo}b", "{foo}c"], aggregate="MAX"
+            )
+            == 2
+        )
+        assert await r.zrange("{foo}d", 0, -1, withscores=True) == [
+            (b"a3", 5),
+            (b"a1", 6),
+        ]
+
+    async def test_cluster_zinterstore_min(self, r: RedisCluster) -> None:
+        await r.zadd("{foo}a", {"a1": 1, "a2": 2, "a3": 3})
+        await r.zadd("{foo}b", {"a1": 2, "a2": 3, "a3": 5})
+        await r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
+        assert (
+            await r.zinterstore(
+                "{foo}d", ["{foo}a", "{foo}b", "{foo}c"], aggregate="MIN"
+            )
+            == 2
+        )
+        assert await r.zrange("{foo}d", 0, -1, withscores=True) == [
+            (b"a1", 1),
+            (b"a3", 3),
+        ]
+
+    async def test_cluster_zinterstore_with_weight(self, r: RedisCluster) -> None:
+        await r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
+        await r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
+        await r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
+        assert (
+            await r.zinterstore("{foo}d", {"{foo}a": 1, "{foo}b": 2, "{foo}c": 3}) == 2
+        )
+        assert await r.zrange("{foo}d", 0, -1, withscores=True) == [
+            (b"a3", 20),
+            (b"a1", 23),
+        ]
+
+    @skip_if_server_version_lt("4.9.0")
+    async def test_cluster_bzpopmax(self, r: RedisCluster) -> None:
+        await r.zadd("{foo}a", {"a1": 1, "a2": 2})
+        await r.zadd("{foo}b", {"b1": 10, "b2": 20})
+        assert await r.bzpopmax(["{foo}b", "{foo}a"], timeout=1) == (
+            b"{foo}b",
+            b"b2",
+            20,
+        )
+        assert await r.bzpopmax(["{foo}b", "{foo}a"], timeout=1) == (
+            b"{foo}b",
+            b"b1",
+            10,
+        )
+        assert await r.bzpopmax(["{foo}b", "{foo}a"], timeout=1) == (
+            b"{foo}a",
+            b"a2",
+            2,
+        )
+        assert await r.bzpopmax(["{foo}b", "{foo}a"], timeout=1) == (
+            b"{foo}a",
+            b"a1",
+            1,
+        )
+        assert await r.bzpopmax(["{foo}b", "{foo}a"], timeout=1) is None
+        await r.zadd("{foo}c", {"c1": 100})
+        assert await r.bzpopmax("{foo}c", timeout=1) == (b"{foo}c", b"c1", 100)
+
+    @skip_if_server_version_lt("4.9.0")
+    async def test_cluster_bzpopmin(self, r: RedisCluster) -> None:
+        await r.zadd("{foo}a", {"a1": 1, "a2": 2})
+        await r.zadd("{foo}b", {"b1": 10, "b2": 20})
+        assert await r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) == (
+            b"{foo}b",
+            b"b1",
+            10,
+        )
+        assert await r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) == (
+            b"{foo}b",
+            b"b2",
+            20,
+        )
+        assert await r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) == (
+            b"{foo}a",
+            b"a1",
+            1,
+        )
+        assert await r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) == (
+            b"{foo}a",
+            b"a2",
+            2,
+        )
+        assert await r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) is None
+        await r.zadd("{foo}c", {"c1": 100})
+        assert await r.bzpopmin("{foo}c", timeout=1) == (b"{foo}c", b"c1", 100)
+
+    @skip_if_server_version_lt("6.2.0")
+    async def test_cluster_zrangestore(self, r: RedisCluster) -> None:
+        await r.zadd("{foo}a", {"a1": 1, "a2": 2, "a3": 3})
+        assert await r.zrangestore("{foo}b", "{foo}a", 0, 1)
+        assert await r.zrange("{foo}b", 0, -1) == [b"a1", b"a2"]
+        assert await r.zrangestore("{foo}b", "{foo}a", 1, 2)
+        assert await r.zrange("{foo}b", 0, -1) == [b"a2", b"a3"]
+        assert await r.zrange("{foo}b", 0, -1, withscores=True) == [
+            (b"a2", 2),
+            (b"a3", 3),
+        ]
+        # reversed order
+        assert await r.zrangestore("{foo}b", "{foo}a", 1, 2, desc=True)
+        assert await r.zrange("{foo}b", 0, -1) == [b"a1", b"a2"]
+        # by score
+        assert await r.zrangestore(
+            "{foo}b", "{foo}a", 2, 1, byscore=True, offset=0, num=1, desc=True
+        )
+        assert await r.zrange("{foo}b", 0, -1) == [b"a2"]
+        # by lex
+        assert await r.zrangestore(
+            "{foo}b", "{foo}a", "[a2", "(a3", bylex=True, offset=0, num=1
+        )
+        assert await r.zrange("{foo}b", 0, -1) == [b"a2"]
+
+    @skip_if_server_version_lt("6.2.0")
+    async def test_cluster_zunion(self, r: RedisCluster) -> None:
+        await r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
+        await r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
+        await r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
+        # sum
+        assert await r.zunion(["{foo}a", "{foo}b", "{foo}c"]) == [
+            b"a2",
+            b"a4",
+            b"a3",
+            b"a1",
+        ]
+        assert await r.zunion(["{foo}a", "{foo}b", "{foo}c"], withscores=True) == [
+            (b"a2", 3),
+            (b"a4", 4),
+            (b"a3", 8),
+            (b"a1", 9),
+        ]
+        # max
+        assert await r.zunion(
+            ["{foo}a", "{foo}b", "{foo}c"], aggregate="MAX", withscores=True
+        ) == [(b"a2", 2), (b"a4", 4), (b"a3", 5), (b"a1", 6)]
+        # min
+        assert await r.zunion(
+            ["{foo}a", "{foo}b", "{foo}c"], aggregate="MIN", withscores=True
+        ) == [(b"a1", 1), (b"a2", 1), (b"a3", 1), (b"a4", 4)]
+        # with weight
+        assert await r.zunion(
+            {"{foo}a": 1, "{foo}b": 2, "{foo}c": 3}, withscores=True
+        ) == [(b"a2", 5), (b"a4", 12), (b"a3", 20), (b"a1", 23)]
+
+    async def test_cluster_zunionstore_sum(self, r: RedisCluster) -> None:
+        await r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
+        await r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
+        await r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
+        assert await r.zunionstore("{foo}d", ["{foo}a", "{foo}b", "{foo}c"]) == 4
+        assert await r.zrange("{foo}d", 0, -1, withscores=True) == [
+            (b"a2", 3),
+            (b"a4", 4),
+            (b"a3", 8),
+            (b"a1", 9),
+        ]
+
+    async def test_cluster_zunionstore_max(self, r: RedisCluster) -> None:
+        await r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
+        await r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
+        await r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
+        assert (
+            await r.zunionstore(
+                "{foo}d", ["{foo}a", "{foo}b", "{foo}c"], aggregate="MAX"
+            )
+            == 4
+        )
+        assert await r.zrange("{foo}d", 0, -1, withscores=True) == [
+            (b"a2", 2),
+            (b"a4", 4),
+            (b"a3", 5),
+            (b"a1", 6),
+        ]
+
+    async def test_cluster_zunionstore_min(self, r: RedisCluster) -> None:
+        await r.zadd("{foo}a", {"a1": 1, "a2": 2, "a3": 3})
+        await r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 4})
+        await r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
+        assert (
+            await r.zunionstore(
+                "{foo}d", ["{foo}a", "{foo}b", "{foo}c"], aggregate="MIN"
+            )
+            == 4
+        )
+        assert await r.zrange("{foo}d", 0, -1, withscores=True) == [
+            (b"a1", 1),
+            (b"a2", 2),
+            (b"a3", 3),
+            (b"a4", 4),
+        ]
+
+    async def test_cluster_zunionstore_with_weight(self, r: RedisCluster) -> None:
+        await r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
+        await r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
+        await r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
+        assert (
+            await r.zunionstore("{foo}d", {"{foo}a": 1, "{foo}b": 2, "{foo}c": 3}) == 4
+        )
+        assert await r.zrange("{foo}d", 0, -1, withscores=True) == [
+            (b"a2", 5),
+            (b"a4", 12),
+            (b"a3", 20),
+            (b"a1", 23),
+        ]
+
+    @skip_if_server_version_lt("2.8.9")
+    async def test_cluster_pfcount(self, r: RedisCluster) -> None:
+        members = {b"1", b"2", b"3"}
+        await r.pfadd("{foo}a", *members)
+        assert await r.pfcount("{foo}a") == len(members)
+        members_b = {b"2", b"3", b"4"}
+        await r.pfadd("{foo}b", *members_b)
+        assert await r.pfcount("{foo}b") == len(members_b)
+        assert await r.pfcount("{foo}a", "{foo}b") == len(members_b.union(members))
+
+    @skip_if_server_version_lt("2.8.9")
+    async def test_cluster_pfmerge(self, r: RedisCluster) -> None:
+        mema = {b"1", b"2", b"3"}
+        memb = {b"2", b"3", b"4"}
+        memc = {b"5", b"6", b"7"}
+        await r.pfadd("{foo}a", *mema)
+        await r.pfadd("{foo}b", *memb)
+        await r.pfadd("{foo}c", *memc)
+        await r.pfmerge("{foo}d", "{foo}c", "{foo}a")
+        assert await r.pfcount("{foo}d") == 6
+        await r.pfmerge("{foo}d", "{foo}b")
+        assert await r.pfcount("{foo}d") == 7
+
+    async def test_cluster_sort_store(self, r: RedisCluster) -> None:
+        await r.rpush("{foo}a", "2", "3", "1")
+        assert await r.sort("{foo}a", store="{foo}sorted_values") == 3
+        assert await r.lrange("{foo}sorted_values", 0, -1) == [b"1", b"2", b"3"]
+
+    # GEO COMMANDS
+    @skip_if_server_version_lt("6.2.0")
+    async def test_cluster_geosearchstore(self, r: RedisCluster) -> None:
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+
+        await r.geoadd("{foo}barcelona", values)
+        await r.geosearchstore(
+            "{foo}places_barcelona",
+            "{foo}barcelona",
+            longitude=2.191,
+            latitude=41.433,
+            radius=1000,
+        )
+        assert await r.zrange("{foo}places_barcelona", 0, -1) == [b"place1"]
+
+    @skip_unless_arch_bits(64)
+    @skip_if_server_version_lt("6.2.0")
+    async def test_geosearchstore_dist(self, r: RedisCluster) -> None:
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+
+        await r.geoadd("{foo}barcelona", values)
+        await r.geosearchstore(
+            "{foo}places_barcelona",
+            "{foo}barcelona",
+            longitude=2.191,
+            latitude=41.433,
+            radius=1000,
+            storedist=True,
+        )
+        # instead of save the geo score, the distance is saved.
+        assert await r.zscore("{foo}places_barcelona", "place1") == 88.05060698409301
+
+    @skip_if_server_version_lt("3.2.0")
+    async def test_cluster_georadius_store(self, r: RedisCluster) -> None:
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+
+        await r.geoadd("{foo}barcelona", values)
+        await r.georadius(
+            "{foo}barcelona", 2.191, 41.433, 1000, store="{foo}places_barcelona"
+        )
+        assert await r.zrange("{foo}places_barcelona", 0, -1) == [b"place1"]
+
+    @skip_unless_arch_bits(64)
+    @skip_if_server_version_lt("3.2.0")
+    async def test_cluster_georadius_store_dist(self, r: RedisCluster) -> None:
+        values = (2.1909389952632, 41.433791470673, "place1") + (
+            2.1873744593677,
+            41.406342043777,
+            "place2",
+        )
+
+        await r.geoadd("{foo}barcelona", values)
+        await r.georadius(
+            "{foo}barcelona", 2.191, 41.433, 1000, store_dist="{foo}places_barcelona"
+        )
+        # instead of save the geo score, the distance is saved.
+        assert await r.zscore("{foo}places_barcelona", "place1") == 88.05060698409301
+
+    async def test_cluster_dbsize(self, r: RedisCluster) -> None:
+        d = {"a": b"1", "b": b"2", "c": b"3", "d": b"4"}
+        assert await r.mset_nonatomic(d)
+        assert await r.dbsize(target_nodes="primaries") == len(d)
+
+    async def test_cluster_keys(self, r: RedisCluster) -> None:
+        assert await r.keys() == []
+        keys_with_underscores = {b"test_a", b"test_b"}
+        keys = keys_with_underscores.union({b"testc"})
+        for key in keys:
+            await r.set(key, 1)
+        assert (
+            set(await r.keys(pattern="test_*", target_nodes="primaries"))
+            == keys_with_underscores
+        )
+        assert set(await r.keys(pattern="test*", target_nodes="primaries")) == keys
+
+    # SCAN COMMANDS
+    @skip_if_server_version_lt("2.8.0")
+    async def test_cluster_scan(self, r: RedisCluster) -> None:
+        await r.set("a", 1)
+        await r.set("b", 2)
+        await r.set("c", 3)
+
+        for target_nodes, nodes in zip(
+            ["primaries", "replicas"], [r.get_primaries(), r.get_replicas()]
+        ):
+            cursors, keys = await r.scan(target_nodes=target_nodes)
+            assert sorted(keys) == [b"a", b"b", b"c"]
+            assert sorted(cursors.keys()) == sorted(node.name for node in nodes)
+            assert all(cursor == 0 for cursor in cursors.values())
+
+            cursors, keys = await r.scan(match="a*", target_nodes=target_nodes)
+            assert sorted(keys) == [b"a"]
+            assert sorted(cursors.keys()) == sorted(node.name for node in nodes)
+            assert all(cursor == 0 for cursor in cursors.values())
+
+    @skip_if_server_version_lt("6.0.0")
+    async def test_cluster_scan_type(self, r: RedisCluster) -> None:
+        await r.sadd("a-set", 1)
+        await r.sadd("b-set", 1)
+        await r.sadd("c-set", 1)
+        await r.hset("a-hash", "foo", 2)
+        await r.lpush("a-list", "aux", 3)
+
+        for target_nodes, nodes in zip(
+            ["primaries", "replicas"], [r.get_primaries(), r.get_replicas()]
+        ):
+            cursors, keys = await r.scan(_type="SET", target_nodes=target_nodes)
+            assert sorted(keys) == [b"a-set", b"b-set", b"c-set"]
+            assert sorted(cursors.keys()) == sorted(node.name for node in nodes)
+            assert all(cursor == 0 for cursor in cursors.values())
+
+            cursors, keys = await r.scan(
+                _type="SET", match="a*", target_nodes=target_nodes
+            )
+            assert sorted(keys) == [b"a-set"]
+            assert sorted(cursors.keys()) == sorted(node.name for node in nodes)
+            assert all(cursor == 0 for cursor in cursors.values())
+
+    @skip_if_server_version_lt("2.8.0")
+    async def test_cluster_scan_iter(self, r: RedisCluster) -> None:
+        keys_all = []
+        keys_1 = []
+        for i in range(100):
+            s = str(i)
+            await r.set(s, 1)
+            keys_all.append(s.encode("utf-8"))
+            if s.startswith("1"):
+                keys_1.append(s.encode("utf-8"))
+        keys_all.sort()
+        keys_1.sort()
+
+        for target_nodes in ["primaries", "replicas"]:
+            keys = [key async for key in r.scan_iter(target_nodes=target_nodes)]
+            assert sorted(keys) == keys_all
+
+            keys = [
+                key async for key in r.scan_iter(match="1*", target_nodes=target_nodes)
+            ]
+            assert sorted(keys) == keys_1
+
+    async def test_cluster_randomkey(self, r: RedisCluster) -> None:
+        node = r.get_node_from_key("{foo}")
+        assert await r.randomkey(target_nodes=node) is None
+        for key in ("{foo}a", "{foo}b", "{foo}c"):
+            await r.set(key, 1)
+        assert await r.randomkey(target_nodes=node) in (b"{foo}a", b"{foo}b", b"{foo}c")
+
+    @skip_if_server_version_lt("6.0.0")
+    @skip_if_redis_enterprise()
+    async def test_acl_log(
+        self, r: RedisCluster, request: FixtureRequest, create_redis: Callable
+    ) -> None:
+        key = "{cache}:"
+        node = r.get_node_from_key(key)
+        username = "redis-py-user"
+
+        await r.acl_setuser(
+            username,
+            enabled=True,
+            reset=True,
+            commands=["+get", "+set", "+select", "+cluster", "+command", "+info"],
+            keys=["{cache}:*"],
+            nopass=True,
+            target_nodes="primaries",
+        )
+        await r.acl_log_reset(target_nodes=node)
+
+        user_client = await create_redis(
+            cls=RedisCluster, flushdb=False, username=username
+        )
+
+        # Valid operation and key
+        assert await user_client.set("{cache}:0", 1)
+        assert await user_client.get("{cache}:0") == b"1"
+
+        # Invalid key
+        with pytest.raises(NoPermissionError):
+            await user_client.get("{cache}violated_cache:0")
+
+        # Invalid operation
+        with pytest.raises(NoPermissionError):
+            await user_client.hset("{cache}:0", "hkey", "hval")
+
+        assert isinstance(await r.acl_log(target_nodes=node), list)
+        assert len(await r.acl_log(target_nodes=node)) == 2
+        assert len(await r.acl_log(count=1, target_nodes=node)) == 1
+        assert isinstance((await r.acl_log(target_nodes=node))[0], dict)
+        assert "client-info" in (await r.acl_log(count=1, target_nodes=node))[0]
+        assert await r.acl_log_reset(target_nodes=node)
+
+        await r.acl_deluser(username, target_nodes="primaries")
+
+        await user_client.close()
+
+
+@pytest.mark.onlycluster
+class TestNodesManager:
+    """
+    Tests for the NodesManager class
+    """
+
+    async def test_load_balancer(self, r: RedisCluster) -> None:
+        n_manager = r.nodes_manager
+        lb = n_manager.read_load_balancer
+        slot_1 = 1257
+        slot_2 = 8975
+        node_1 = ClusterNode(default_host, 6379, PRIMARY)
+        node_2 = ClusterNode(default_host, 6378, REPLICA)
+        node_3 = ClusterNode(default_host, 6377, REPLICA)
+        node_4 = ClusterNode(default_host, 6376, PRIMARY)
+        node_5 = ClusterNode(default_host, 6375, REPLICA)
+        n_manager.slots_cache = {
+            slot_1: [node_1, node_2, node_3],
+            slot_2: [node_4, node_5],
+        }
+        primary1_name = n_manager.slots_cache[slot_1][0].name
+        primary2_name = n_manager.slots_cache[slot_2][0].name
+        list1_size = len(n_manager.slots_cache[slot_1])
+        list2_size = len(n_manager.slots_cache[slot_2])
+        # slot 1
+        assert lb.get_server_index(primary1_name, list1_size) == 0
+        assert lb.get_server_index(primary1_name, list1_size) == 1
+        assert lb.get_server_index(primary1_name, list1_size) == 2
+        assert lb.get_server_index(primary1_name, list1_size) == 0
+        # slot 2
+        assert lb.get_server_index(primary2_name, list2_size) == 0
+        assert lb.get_server_index(primary2_name, list2_size) == 1
+        assert lb.get_server_index(primary2_name, list2_size) == 0
+
+        lb.reset()
+        assert lb.get_server_index(primary1_name, list1_size) == 0
+        assert lb.get_server_index(primary2_name, list2_size) == 0
+
+    async def test_init_slots_cache_not_all_slots_covered(self) -> None:
+        """
+        Test that if not all slots are covered it should raise an exception
+        """
+        # Missing slot 5460
+        cluster_slots = [
+            [0, 5459, ["127.0.0.1", 7000], ["127.0.0.1", 7003]],
+            [5461, 10922, ["127.0.0.1", 7001], ["127.0.0.1", 7004]],
+            [10923, 16383, ["127.0.0.1", 7002], ["127.0.0.1", 7005]],
+        ]
+        with pytest.raises(RedisClusterException) as ex:
+            rc = await get_mocked_redis_client(
+                host=default_host,
+                port=default_port,
+                cluster_slots=cluster_slots,
+                require_full_coverage=True,
+            )
+            await rc.close()
+        assert str(ex.value).startswith(
+            "All slots are not covered after query all startup_nodes."
+        )
+
+    async def test_init_slots_cache_not_require_full_coverage_success(self) -> None:
+        """
+        When require_full_coverage is set to False and not all slots are
+        covered the cluster client initialization should succeed
+        """
+        # Missing slot 5460
+        cluster_slots = [
+            [0, 5459, ["127.0.0.1", 7000], ["127.0.0.1", 7003]],
+            [5461, 10922, ["127.0.0.1", 7001], ["127.0.0.1", 7004]],
+            [10923, 16383, ["127.0.0.1", 7002], ["127.0.0.1", 7005]],
+        ]
+
+        rc = await get_mocked_redis_client(
+            host=default_host,
+            port=default_port,
+            cluster_slots=cluster_slots,
+            require_full_coverage=False,
+        )
+
+        assert 5460 not in rc.nodes_manager.slots_cache
+
+        await rc.close()
+
+    async def test_init_slots_cache(self) -> None:
+        """
+        Test that slots cache can in initialized and all slots are covered
+        """
+        good_slots_resp = [
+            [0, 5460, ["127.0.0.1", 7000], ["127.0.0.2", 7003]],
+            [5461, 10922, ["127.0.0.1", 7001], ["127.0.0.2", 7004]],
+            [10923, 16383, ["127.0.0.1", 7002], ["127.0.0.2", 7005]],
+        ]
+
+        rc = await get_mocked_redis_client(
+            host=default_host, port=default_port, cluster_slots=good_slots_resp
+        )
+        n_manager = rc.nodes_manager
+        assert len(n_manager.slots_cache) == REDIS_CLUSTER_HASH_SLOTS
+        for slot_info in good_slots_resp:
+            all_hosts = ["127.0.0.1", "127.0.0.2"]
+            all_ports = [7000, 7001, 7002, 7003, 7004, 7005]
+            slot_start = slot_info[0]
+            slot_end = slot_info[1]
+            for i in range(slot_start, slot_end + 1):
+                assert len(n_manager.slots_cache[i]) == len(slot_info[2:])
+                assert n_manager.slots_cache[i][0].host in all_hosts
+                assert n_manager.slots_cache[i][1].host in all_hosts
+                assert n_manager.slots_cache[i][0].port in all_ports
+                assert n_manager.slots_cache[i][1].port in all_ports
+
+        assert len(n_manager.nodes_cache) == 6
+
+        await rc.close()
+
+    async def test_init_slots_cache_cluster_mode_disabled(self) -> None:
+        """
+        Test that creating a RedisCluster failes if one of the startup nodes
+        has cluster mode disabled
+        """
+        with pytest.raises(RedisClusterException) as e:
+            rc = await get_mocked_redis_client(
+                host=default_host, port=default_port, cluster_enabled=False
+            )
+            await rc.close()
+        assert "Cluster mode is not enabled on this node" in str(e.value)
+
+    async def test_empty_startup_nodes(self) -> None:
+        """
+        It should not be possible to create a node manager with no nodes
+        specified
+        """
+        with pytest.raises(RedisClusterException):
+            await NodesManager([]).initialize()
+
+    async def test_wrong_startup_nodes_type(self) -> None:
+        """
+        If something other then a list type itteratable is provided it should
+        fail
+        """
+        with pytest.raises(RedisClusterException):
+            await NodesManager({}).initialize()
+
+    async def test_init_slots_cache_slots_collision(
+        self, request: FixtureRequest
+    ) -> None:
+        """
+        Test that if 2 nodes do not agree on the same slots setup it should
+        raise an error. In this test both nodes will say that the first
+        slots block should be bound to different servers.
+        """
+        with mock.patch.object(
+            ClusterNode, "execute_command", autospec=True
+        ) as execute_command:
+
+            async def mocked_execute_command(self, *args, **kwargs):
+                """
+                Helper function to return custom slots cache data from
+                different redis nodes
+                """
+                if self.port == 7000:
+                    result = [
+                        [0, 5460, ["127.0.0.1", 7000], ["127.0.0.1", 7003]],
+                        [5461, 10922, ["127.0.0.1", 7001], ["127.0.0.1", 7004]],
+                    ]
+
+                elif self.port == 7001:
+                    result = [
+                        [0, 5460, ["127.0.0.1", 7001], ["127.0.0.1", 7003]],
+                        [5461, 10922, ["127.0.0.1", 7000], ["127.0.0.1", 7004]],
+                    ]
+                else:
+                    result = []
+
+                if args[0] == "CLUSTER SLOTS":
+                    return result
+                elif args[0] == "INFO":
+                    return {"cluster_enabled": True}
+                elif args[1] == "cluster-require-full-coverage":
+                    return {"cluster-require-full-coverage": "yes"}
+
+            execute_command.side_effect = mocked_execute_command
+
+            with pytest.raises(RedisClusterException) as ex:
+                node_1 = ClusterNode("127.0.0.1", 7000)
+                node_2 = ClusterNode("127.0.0.1", 7001)
+                async with RedisCluster(startup_nodes=[node_1, node_2]):
+                    ...
+            assert str(ex.value).startswith(
+                "startup_nodes could not agree on a valid slots cache"
+            ), str(ex.value)
+
+    async def test_cluster_one_instance(self) -> None:
+        """
+        If the cluster exists of only 1 node then there is some hacks that must
+        be validated they work.
+        """
+        node = ClusterNode(default_host, default_port)
+        cluster_slots = [[0, 16383, ["", default_port]]]
+        rc = await get_mocked_redis_client(
+            startup_nodes=[node], cluster_slots=cluster_slots
+        )
+
+        n = rc.nodes_manager
+        assert len(n.nodes_cache) == 1
+        n_node = rc.get_node(node_name=node.name)
+        assert n_node is not None
+        assert n_node == node
+        assert n_node.server_type == PRIMARY
+        assert len(n.slots_cache) == REDIS_CLUSTER_HASH_SLOTS
+        for i in range(0, REDIS_CLUSTER_HASH_SLOTS):
+            assert n.slots_cache[i] == [n_node]
+
+        await rc.close()
+
+    async def test_init_with_down_node(self) -> None:
+        """
+        If I can't connect to one of the nodes, everything should still work.
+        But if I can't connect to any of the nodes, exception should be thrown.
+        """
+        with mock.patch.object(
+            ClusterNode, "execute_command", autospec=True
+        ) as execute_command:
+
+            async def mocked_execute_command(self, *args, **kwargs):
+                if self.port == 7000:
+                    raise ConnectionError("mock connection error for 7000")
+
+                if args[0] == "CLUSTER SLOTS":
+                    return [
+                        [0, 8191, ["127.0.0.1", 7001, "node_1"]],
+                        [8192, 16383, ["127.0.0.1", 7002, "node_2"]],
+                    ]
+                elif args[0] == "INFO":
+                    return {"cluster_enabled": True}
+                elif args[1] == "cluster-require-full-coverage":
+                    return {"cluster-require-full-coverage": "yes"}
+
+            execute_command.side_effect = mocked_execute_command
+
+            node_1 = ClusterNode("127.0.0.1", 7000)
+            node_2 = ClusterNode("127.0.0.1", 7001)
+
+            # If all startup nodes fail to connect, connection error should be
+            # thrown
+            with pytest.raises(RedisClusterException) as e:
+                async with RedisCluster(startup_nodes=[node_1]):
+                    ...
+            assert "Redis Cluster cannot be connected" in str(e.value)
+
+            with mock.patch.object(
+                CommandsParser, "initialize", autospec=True
+            ) as cmd_parser_initialize:
+
+                def cmd_init_mock(self, r):
+                    self.commands = {
+                        "GET": {
+                            "name": "get",
+                            "arity": 2,
+                            "flags": ["readonly", "fast"],
+                            "first_key_pos": 1,
+                            "last_key_pos": 1,
+                            "step_count": 1,
+                        }
+                    }
+
+                cmd_parser_initialize.side_effect = cmd_init_mock
+                # When at least one startup node is reachable, the cluster
+                # initialization should succeeds
+                async with RedisCluster(startup_nodes=[node_1, node_2]) as rc:
+                    assert rc.get_node(host=default_host, port=7001) is not None
+                    assert rc.get_node(host=default_host, port=7002) is not None
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index dee8755a17..650ce27956 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -4,11 +4,17 @@
 import binascii
 import datetime
 import re
+import sys
 import time
 from string import ascii_letters
 
 import pytest
 
+if sys.version_info[0:2] == (3, 6):
+    import pytest as pytest_asyncio
+else:
+    import pytest_asyncio
+
 import redis
 from redis import exceptions
 from redis.client import parse_info
@@ -21,10 +27,10 @@
 REDIS_6_VERSION = "5.9.0"
 
 
-pytestmark = [pytest.mark.asyncio, pytest.mark.onlynoncluster]
+pytestmark = pytest.mark.asyncio
 
 
-@pytest.fixture()
+@pytest_asyncio.fixture()
 async def slowlog(r: redis.Redis, event_loop):
     current_config = await r.config_get()
     old_slower_than_value = current_config["slowlog-log-slower-than"]
@@ -53,6 +59,7 @@ async def get_stream_message(client: redis.Redis, stream: str, message_id: str):
 
 
 # RESPONSE CALLBACKS
+@pytest.mark.onlynoncluster
 class TestResponseCallbacks:
     """Tests for the response callback system"""
 
@@ -243,6 +250,7 @@ def teardown():
         assert f"user {username} off sanitize-payload &* -@all" in users
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
+    @pytest.mark.onlynoncluster
     async def test_acl_log(self, r: redis.Redis, request, event_loop, create_redis):
         username = "redis-py-user"
 
@@ -350,6 +358,7 @@ async def test_acl_whoami(self, r: redis.Redis):
         username = await r.acl_whoami()
         assert isinstance(username, str)
 
+    @pytest.mark.onlynoncluster
     async def test_client_list(self, r: redis.Redis):
         clients = await r.client_list()
         assert isinstance(clients[0], dict)
@@ -364,10 +373,12 @@ async def test_client_list_type(self, r: redis.Redis):
             assert isinstance(clients, list)
 
     @skip_if_server_version_lt("5.0.0")
+    @pytest.mark.onlynoncluster
     async def test_client_id(self, r: redis.Redis):
         assert await r.client_id() > 0
 
     @skip_if_server_version_lt("5.0.0")
+    @pytest.mark.onlynoncluster
     async def test_client_unblock(self, r: redis.Redis):
         myid = await r.client_id()
         assert not await r.client_unblock(myid)
@@ -375,15 +386,18 @@ async def test_client_unblock(self, r: redis.Redis):
         assert not await r.client_unblock(myid, error=False)
 
     @skip_if_server_version_lt("2.6.9")
+    @pytest.mark.onlynoncluster
     async def test_client_getname(self, r: redis.Redis):
         assert await r.client_getname() is None
 
     @skip_if_server_version_lt("2.6.9")
+    @pytest.mark.onlynoncluster
     async def test_client_setname(self, r: redis.Redis):
         assert await r.client_setname("redis_py_test")
         assert await r.client_getname() == "redis_py_test"
 
     @skip_if_server_version_lt("2.6.9")
+    @pytest.mark.onlynoncluster
     async def test_client_kill(self, r: redis.Redis, r2):
         await r.client_setname("redis-py-c1")
         await r2.client_setname("redis-py-c2")
@@ -422,6 +436,7 @@ async def test_client_kill_filter_invalid_params(self, r: redis.Redis):
             await r.client_kill_filter(_type="caster")  # type: ignore
 
     @skip_if_server_version_lt("2.8.12")
+    @pytest.mark.onlynoncluster
     async def test_client_kill_filter_by_id(self, r: redis.Redis, r2):
         await r.client_setname("redis-py-c1")
         await r2.client_setname("redis-py-c2")
@@ -447,6 +462,7 @@ async def test_client_kill_filter_by_id(self, r: redis.Redis, r2):
         assert clients[0].get("name") == "redis-py-c1"
 
     @skip_if_server_version_lt("2.8.12")
+    @pytest.mark.onlynoncluster
     async def test_client_kill_filter_by_addr(self, r: redis.Redis, r2):
         await r.client_setname("redis-py-c1")
         await r2.client_setname("redis-py-c2")
@@ -479,6 +495,7 @@ async def test_client_list_after_client_setname(self, r: redis.Redis):
         assert "redis_py_test" in [c["name"] for c in clients]
 
     @skip_if_server_version_lt("2.9.50")
+    @pytest.mark.onlynoncluster
     async def test_client_pause(self, r: redis.Redis):
         assert await r.client_pause(1)
         assert await r.client_pause(timeout=1)
@@ -490,6 +507,7 @@ async def test_config_get(self, r: redis.Redis):
         assert "maxmemory" in data
         assert data["maxmemory"].isdigit()
 
+    @pytest.mark.onlynoncluster
     async def test_config_resetstat(self, r: redis.Redis):
         await r.ping()
         prior_commands_processed = int((await r.info())["total_commands_processed"])
@@ -507,14 +525,17 @@ async def test_config_set(self, r: redis.Redis):
         finally:
             assert await r.config_set("dbfilename", rdbname)
 
+    @pytest.mark.onlynoncluster
     async def test_dbsize(self, r: redis.Redis):
         await r.set("a", "foo")
         await r.set("b", "bar")
         assert await r.dbsize() == 2
 
+    @pytest.mark.onlynoncluster
     async def test_echo(self, r: redis.Redis):
         assert await r.echo("foo bar") == b"foo bar"
 
+    @pytest.mark.onlynoncluster
     async def test_info(self, r: redis.Redis):
         await r.set("a", "foo")
         await r.set("b", "bar")
@@ -522,6 +543,7 @@ async def test_info(self, r: redis.Redis):
         assert isinstance(info, dict)
         assert info["db9"]["keys"] == 2
 
+    @pytest.mark.onlynoncluster
     async def test_lastsave(self, r: redis.Redis):
         assert isinstance(await r.lastsave(), datetime.datetime)
 
@@ -535,6 +557,7 @@ async def test_object(self, r: redis.Redis):
     async def test_ping(self, r: redis.Redis):
         assert await r.ping()
 
+    @pytest.mark.onlynoncluster
     async def test_slowlog_get(self, r: redis.Redis, slowlog):
         assert await r.slowlog_reset()
         unicode_string = chr(3456) + "abcd" + chr(3421)
@@ -556,6 +579,7 @@ async def test_slowlog_get(self, r: redis.Redis, slowlog):
         assert isinstance(slowlog[0]["start_time"], int)
         assert isinstance(slowlog[0]["duration"], int)
 
+    @pytest.mark.onlynoncluster
     async def test_slowlog_get_limit(self, r: redis.Redis, slowlog):
         assert await r.slowlog_reset()
         await r.get("foo")
@@ -564,6 +588,7 @@ async def test_slowlog_get_limit(self, r: redis.Redis, slowlog):
         # only one command, based on the number we passed to slowlog_get()
         assert len(slowlog) == 1
 
+    @pytest.mark.onlynoncluster
     async def test_slowlog_length(self, r: redis.Redis, slowlog):
         await r.get("foo")
         assert isinstance(await r.slowlog_len(), int)
@@ -602,12 +627,14 @@ async def test_bitcount(self, r: redis.Redis):
         assert await r.bitcount("a", 1, 1) == 1
 
     @skip_if_server_version_lt("2.6.0")
+    @pytest.mark.onlynoncluster
     async def test_bitop_not_empty_string(self, r: redis.Redis):
         await r.set("a", "")
         await r.bitop("not", "r", "a")
         assert await r.get("r") is None
 
     @skip_if_server_version_lt("2.6.0")
+    @pytest.mark.onlynoncluster
     async def test_bitop_not(self, r: redis.Redis):
         test_str = b"\xAA\x00\xFF\x55"
         correct = ~0xAA00FF55 & 0xFFFFFFFF
@@ -616,6 +643,7 @@ async def test_bitop_not(self, r: redis.Redis):
         assert int(binascii.hexlify(await r.get("r")), 16) == correct
 
     @skip_if_server_version_lt("2.6.0")
+    @pytest.mark.onlynoncluster
     async def test_bitop_not_in_place(self, r: redis.Redis):
         test_str = b"\xAA\x00\xFF\x55"
         correct = ~0xAA00FF55 & 0xFFFFFFFF
@@ -624,6 +652,7 @@ async def test_bitop_not_in_place(self, r: redis.Redis):
         assert int(binascii.hexlify(await r.get("a")), 16) == correct
 
     @skip_if_server_version_lt("2.6.0")
+    @pytest.mark.onlynoncluster
     async def test_bitop_single_string(self, r: redis.Redis):
         test_str = b"\x01\x02\xFF"
         await r.set("a", test_str)
@@ -635,6 +664,7 @@ async def test_bitop_single_string(self, r: redis.Redis):
         assert await r.get("res3") == test_str
 
     @skip_if_server_version_lt("2.6.0")
+    @pytest.mark.onlynoncluster
     async def test_bitop_string_operands(self, r: redis.Redis):
         await r.set("a", b"\x01\x02\xFF\xFF")
         await r.set("b", b"\x01\x02\xFF")
@@ -645,6 +675,7 @@ async def test_bitop_string_operands(self, r: redis.Redis):
         assert int(binascii.hexlify(await r.get("res2")), 16) == 0x0102FFFF
         assert int(binascii.hexlify(await r.get("res3")), 16) == 0x000000FF
 
+    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.8.7")
     async def test_bitpos(self, r: redis.Redis):
         key = "key:bitpos"
@@ -840,6 +871,7 @@ async def test_incrbyfloat(self, r: redis.Redis):
         assert await r.incrbyfloat("a", 1.1) == 2.1
         assert float(await r.get("a")) == float(2.1)
 
+    @pytest.mark.onlynoncluster
     async def test_keys(self, r: redis.Redis):
         assert await r.keys() == []
         keys_with_underscores = {b"test_a", b"test_b"}
@@ -849,6 +881,7 @@ async def test_keys(self, r: redis.Redis):
         assert set(await r.keys(pattern="test_*")) == keys_with_underscores
         assert set(await r.keys(pattern="test*")) == keys
 
+    @pytest.mark.onlynoncluster
     async def test_mget(self, r: redis.Redis):
         assert await r.mget([]) == []
         assert await r.mget(["a", "b"]) == [None, None]
@@ -857,12 +890,14 @@ async def test_mget(self, r: redis.Redis):
         await r.set("c", "3")
         assert await r.mget("a", "other", "b", "c") == [b"1", None, b"2", b"3"]
 
+    @pytest.mark.onlynoncluster
     async def test_mset(self, r: redis.Redis):
         d = {"a": b"1", "b": b"2", "c": b"3"}
         assert await r.mset(d)
         for k, v in d.items():
             assert await r.get(k) == v
 
+    @pytest.mark.onlynoncluster
     async def test_msetnx(self, r: redis.Redis):
         d = {"a": b"1", "b": b"2", "c": b"3"}
         assert await r.msetnx(d)
@@ -928,18 +963,21 @@ async def test_pttl_no_key(self, r: redis.Redis):
         """PTTL on servers 2.8 and after return -2 when the key doesn't exist"""
         assert await r.pttl("a") == -2
 
+    @pytest.mark.onlynoncluster
     async def test_randomkey(self, r: redis.Redis):
         assert await r.randomkey() is None
         for key in ("a", "b", "c"):
             await r.set(key, 1)
         assert await r.randomkey() in (b"a", b"b", b"c")
 
+    @pytest.mark.onlynoncluster
     async def test_rename(self, r: redis.Redis):
         await r.set("a", "1")
         assert await r.rename("a", "b")
         assert await r.get("a") is None
         assert await r.get("b") == b"1"
 
+    @pytest.mark.onlynoncluster
     async def test_renamenx(self, r: redis.Redis):
         await r.set("a", "1")
         await r.set("b", "2")
@@ -1057,6 +1095,7 @@ async def test_type(self, r: redis.Redis):
         assert await r.type("a") == b"zset"
 
     # LIST COMMANDS
+    @pytest.mark.onlynoncluster
     async def test_blpop(self, r: redis.Redis):
         await r.rpush("a", "1", "2")
         await r.rpush("b", "3", "4")
@@ -1068,6 +1107,7 @@ async def test_blpop(self, r: redis.Redis):
         await r.rpush("c", "1")
         assert await r.blpop("c", timeout=1) == (b"c", b"1")
 
+    @pytest.mark.onlynoncluster
     async def test_brpop(self, r: redis.Redis):
         await r.rpush("a", "1", "2")
         await r.rpush("b", "3", "4")
@@ -1079,6 +1119,7 @@ async def test_brpop(self, r: redis.Redis):
         await r.rpush("c", "1")
         assert await r.brpop("c", timeout=1) == (b"c", b"1")
 
+    @pytest.mark.onlynoncluster
     async def test_brpoplpush(self, r: redis.Redis):
         await r.rpush("a", "1", "2")
         await r.rpush("b", "3", "4")
@@ -1088,6 +1129,7 @@ async def test_brpoplpush(self, r: redis.Redis):
         assert await r.lrange("a", 0, -1) == []
         assert await r.lrange("b", 0, -1) == [b"1", b"2", b"3", b"4"]
 
+    @pytest.mark.onlynoncluster
     async def test_brpoplpush_empty_string(self, r: redis.Redis):
         await r.rpush("a", "")
         assert await r.brpoplpush("a", "b") == b""
@@ -1165,6 +1207,7 @@ async def test_rpop(self, r: redis.Redis):
         assert await r.rpop("a") == b"1"
         assert await r.rpop("a") is None
 
+    @pytest.mark.onlynoncluster
     async def test_rpoplpush(self, r: redis.Redis):
         await r.rpush("a", "a1", "a2", "a3")
         await r.rpush("b", "b1", "b2", "b3")
@@ -1219,6 +1262,7 @@ async def test_rpushx(self, r: redis.Redis):
 
     # SCAN COMMANDS
     @skip_if_server_version_lt("2.8.0")
+    @pytest.mark.onlynoncluster
     async def test_scan(self, r: redis.Redis):
         await r.set("a", 1)
         await r.set("b", 2)
@@ -1230,6 +1274,7 @@ async def test_scan(self, r: redis.Redis):
         assert set(keys) == {b"a"}
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
+    @pytest.mark.onlynoncluster
     async def test_scan_type(self, r: redis.Redis):
         await r.sadd("a-set", 1)
         await r.hset("a-hash", "foo", 2)
@@ -1238,6 +1283,7 @@ async def test_scan_type(self, r: redis.Redis):
         assert set(keys) == {b"a-set"}
 
     @skip_if_server_version_lt("2.8.0")
+    @pytest.mark.onlynoncluster
     async def test_scan_iter(self, r: redis.Redis):
         await r.set("a", 1)
         await r.set("b", 2)
@@ -1308,12 +1354,14 @@ async def test_scard(self, r: redis.Redis):
         await r.sadd("a", "1", "2", "3")
         assert await r.scard("a") == 3
 
+    @pytest.mark.onlynoncluster
     async def test_sdiff(self, r: redis.Redis):
         await r.sadd("a", "1", "2", "3")
         assert await r.sdiff("a", "b") == {b"1", b"2", b"3"}
         await r.sadd("b", "2", "3")
         assert await r.sdiff("a", "b") == {b"1"}
 
+    @pytest.mark.onlynoncluster
     async def test_sdiffstore(self, r: redis.Redis):
         await r.sadd("a", "1", "2", "3")
         assert await r.sdiffstore("c", "a", "b") == 3
@@ -1322,12 +1370,14 @@ async def test_sdiffstore(self, r: redis.Redis):
         assert await r.sdiffstore("c", "a", "b") == 1
         assert await r.smembers("c") == {b"1"}
 
+    @pytest.mark.onlynoncluster
     async def test_sinter(self, r: redis.Redis):
         await r.sadd("a", "1", "2", "3")
         assert await r.sinter("a", "b") == set()
         await r.sadd("b", "2", "3")
         assert await r.sinter("a", "b") == {b"2", b"3"}
 
+    @pytest.mark.onlynoncluster
     async def test_sinterstore(self, r: redis.Redis):
         await r.sadd("a", "1", "2", "3")
         assert await r.sinterstore("c", "a", "b") == 0
@@ -1347,6 +1397,7 @@ async def test_smembers(self, r: redis.Redis):
         await r.sadd("a", "1", "2", "3")
         assert await r.smembers("a") == {b"1", b"2", b"3"}
 
+    @pytest.mark.onlynoncluster
     async def test_smove(self, r: redis.Redis):
         await r.sadd("a", "a1", "a2")
         await r.sadd("b", "b1", "b2")
@@ -1392,11 +1443,13 @@ async def test_srem(self, r: redis.Redis):
         assert await r.srem("a", "2", "4") == 2
         assert await r.smembers("a") == {b"1", b"3"}
 
+    @pytest.mark.onlynoncluster
     async def test_sunion(self, r: redis.Redis):
         await r.sadd("a", "1", "2")
         await r.sadd("b", "2", "3")
         assert await r.sunion("a", "b") == {b"1", b"2", b"3"}
 
+    @pytest.mark.onlynoncluster
     async def test_sunionstore(self, r: redis.Redis):
         await r.sadd("a", "1", "2")
         await r.sadd("b", "2", "3")
@@ -1481,6 +1534,7 @@ async def test_zlexcount(self, r: redis.Redis):
         assert await r.zlexcount("a", "-", "+") == 7
         assert await r.zlexcount("a", "[b", "[f") == 5
 
+    @pytest.mark.onlynoncluster
     async def test_zinterstore_sum(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 1, "a3": 1})
         await r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
@@ -1488,6 +1542,7 @@ async def test_zinterstore_sum(self, r: redis.Redis):
         assert await r.zinterstore("d", ["a", "b", "c"]) == 2
         assert await r.zrange("d", 0, -1, withscores=True) == [(b"a3", 8), (b"a1", 9)]
 
+    @pytest.mark.onlynoncluster
     async def test_zinterstore_max(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 1, "a3": 1})
         await r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
@@ -1495,6 +1550,7 @@ async def test_zinterstore_max(self, r: redis.Redis):
         assert await r.zinterstore("d", ["a", "b", "c"], aggregate="MAX") == 2
         assert await r.zrange("d", 0, -1, withscores=True) == [(b"a3", 5), (b"a1", 6)]
 
+    @pytest.mark.onlynoncluster
     async def test_zinterstore_min(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
         await r.zadd("b", {"a1": 2, "a2": 3, "a3": 5})
@@ -1502,6 +1558,7 @@ async def test_zinterstore_min(self, r: redis.Redis):
         assert await r.zinterstore("d", ["a", "b", "c"], aggregate="MIN") == 2
         assert await r.zrange("d", 0, -1, withscores=True) == [(b"a1", 1), (b"a3", 3)]
 
+    @pytest.mark.onlynoncluster
     async def test_zinterstore_with_weight(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 1, "a3": 1})
         await r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
@@ -1526,6 +1583,7 @@ async def test_zpopmin(self, r: redis.Redis):
         assert await r.zpopmin("a", count=2) == [(b"a2", 2), (b"a3", 3)]
 
     @skip_if_server_version_lt("4.9.0")
+    @pytest.mark.onlynoncluster
     async def test_bzpopmax(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 2})
         await r.zadd("b", {"b1": 10, "b2": 20})
@@ -1538,6 +1596,7 @@ async def test_bzpopmax(self, r: redis.Redis):
         assert await r.bzpopmax("c", timeout=1) == (b"c", b"c1", 100)
 
     @skip_if_server_version_lt("4.9.0")
+    @pytest.mark.onlynoncluster
     async def test_bzpopmin(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 2})
         await r.zadd("b", {"b1": 10, "b2": 20})
@@ -1705,6 +1764,7 @@ async def test_zscore(self, r: redis.Redis):
         assert await r.zscore("a", "a2") == 2.0
         assert await r.zscore("a", "a4") is None
 
+    @pytest.mark.onlynoncluster
     async def test_zunionstore_sum(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 1, "a3": 1})
         await r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
@@ -1717,6 +1777,7 @@ async def test_zunionstore_sum(self, r: redis.Redis):
             (b"a1", 9),
         ]
 
+    @pytest.mark.onlynoncluster
     async def test_zunionstore_max(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 1, "a3": 1})
         await r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
@@ -1729,6 +1790,7 @@ async def test_zunionstore_max(self, r: redis.Redis):
             (b"a1", 6),
         ]
 
+    @pytest.mark.onlynoncluster
     async def test_zunionstore_min(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
         await r.zadd("b", {"a1": 2, "a2": 2, "a3": 4})
@@ -1741,6 +1803,7 @@ async def test_zunionstore_min(self, r: redis.Redis):
             (b"a4", 4),
         ]
 
+    @pytest.mark.onlynoncluster
     async def test_zunionstore_with_weight(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 1, "a3": 1})
         await r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
@@ -1762,6 +1825,7 @@ async def test_pfadd(self, r: redis.Redis):
         assert await r.pfcount("a") == len(members)
 
     @skip_if_server_version_lt("2.8.9")
+    @pytest.mark.onlynoncluster
     async def test_pfcount(self, r: redis.Redis):
         members = {b"1", b"2", b"3"}
         await r.pfadd("a", *members)
@@ -1772,6 +1836,7 @@ async def test_pfcount(self, r: redis.Redis):
         assert await r.pfcount("a", "b") == len(members_b.union(members))
 
     @skip_if_server_version_lt("2.8.9")
+    @pytest.mark.onlynoncluster
     async def test_pfmerge(self, r: redis.Redis):
         mema = {b"1", b"2", b"3"}
         memb = {b"2", b"3", b"4"}
@@ -1866,7 +1931,8 @@ async def test_hmget(self, r: redis.Redis):
 
     async def test_hmset(self, r: redis.Redis):
         warning_message = (
-            r"^Redis\.hmset\(\) is deprecated\. " r"Use Redis\.hset\(\) instead\.$"
+            r"^Redis(?:Cluster)*\.hmset\(\) is deprecated\. "
+            r"Use Redis(?:Cluster)*\.hset\(\) instead\.$"
         )
         h = {b"a": b"1", b"b": b"2", b"c": b"3"}
         with pytest.warns(DeprecationWarning, match=warning_message):
@@ -1902,6 +1968,7 @@ async def test_sort_limited(self, r: redis.Redis):
         await r.rpush("a", "3", "2", "1", "4")
         assert await r.sort("a", start=1, num=2) == [b"2", b"3"]
 
+    @pytest.mark.onlynoncluster
     async def test_sort_by(self, r: redis.Redis):
         await r.set("score:1", 8)
         await r.set("score:2", 3)
@@ -1909,6 +1976,7 @@ async def test_sort_by(self, r: redis.Redis):
         await r.rpush("a", "3", "2", "1")
         assert await r.sort("a", by="score:*") == [b"2", b"3", b"1"]
 
+    @pytest.mark.onlynoncluster
     async def test_sort_get(self, r: redis.Redis):
         await r.set("user:1", "u1")
         await r.set("user:2", "u2")
@@ -1916,6 +1984,7 @@ async def test_sort_get(self, r: redis.Redis):
         await r.rpush("a", "2", "3", "1")
         assert await r.sort("a", get="user:*") == [b"u1", b"u2", b"u3"]
 
+    @pytest.mark.onlynoncluster
     async def test_sort_get_multi(self, r: redis.Redis):
         await r.set("user:1", "u1")
         await r.set("user:2", "u2")
@@ -1930,6 +1999,7 @@ async def test_sort_get_multi(self, r: redis.Redis):
             b"3",
         ]
 
+    @pytest.mark.onlynoncluster
     async def test_sort_get_groups_two(self, r: redis.Redis):
         await r.set("user:1", "u1")
         await r.set("user:2", "u2")
@@ -1941,6 +2011,7 @@ async def test_sort_get_groups_two(self, r: redis.Redis):
             (b"u3", b"3"),
         ]
 
+    @pytest.mark.onlynoncluster
     async def test_sort_groups_string_get(self, r: redis.Redis):
         await r.set("user:1", "u1")
         await r.set("user:2", "u2")
@@ -1949,6 +2020,7 @@ async def test_sort_groups_string_get(self, r: redis.Redis):
         with pytest.raises(exceptions.DataError):
             await r.sort("a", get="user:*", groups=True)
 
+    @pytest.mark.onlynoncluster
     async def test_sort_groups_just_one_get(self, r: redis.Redis):
         await r.set("user:1", "u1")
         await r.set("user:2", "u2")
@@ -1965,6 +2037,7 @@ async def test_sort_groups_no_get(self, r: redis.Redis):
         with pytest.raises(exceptions.DataError):
             await r.sort("a", groups=True)
 
+    @pytest.mark.onlynoncluster
     async def test_sort_groups_three_gets(self, r: redis.Redis):
         await r.set("user:1", "u1")
         await r.set("user:2", "u2")
@@ -1987,11 +2060,13 @@ async def test_sort_alpha(self, r: redis.Redis):
         await r.rpush("a", "e", "c", "b", "d", "a")
         assert await r.sort("a", alpha=True) == [b"a", b"b", b"c", b"d", b"e"]
 
+    @pytest.mark.onlynoncluster
     async def test_sort_store(self, r: redis.Redis):
         await r.rpush("a", "2", "3", "1")
         assert await r.sort("a", store="sorted_values") == 3
         assert await r.lrange("sorted_values", 0, -1) == [b"1", b"2", b"3"]
 
+    @pytest.mark.onlynoncluster
     async def test_sort_all_options(self, r: redis.Redis):
         await r.set("user:1:username", "zeus")
         await r.set("user:2:username", "titan")
@@ -2035,70 +2110,88 @@ async def test_sort_issue_924(self, r: redis.Redis):
         await r.execute_command("SADD", "issue#924", 1)
         await r.execute_command("SORT", "issue#924")
 
+    @pytest.mark.onlynoncluster
     async def test_cluster_addslots(self, mock_cluster_resp_ok):
         assert await mock_cluster_resp_ok.cluster("ADDSLOTS", 1) is True
 
+    @pytest.mark.onlynoncluster
     async def test_cluster_count_failure_reports(self, mock_cluster_resp_int):
         assert isinstance(
             await mock_cluster_resp_int.cluster("COUNT-FAILURE-REPORTS", "node"), int
         )
 
+    @pytest.mark.onlynoncluster
     async def test_cluster_countkeysinslot(self, mock_cluster_resp_int):
         assert isinstance(
             await mock_cluster_resp_int.cluster("COUNTKEYSINSLOT", 2), int
         )
 
+    @pytest.mark.onlynoncluster
     async def test_cluster_delslots(self, mock_cluster_resp_ok):
         assert await mock_cluster_resp_ok.cluster("DELSLOTS", 1) is True
 
+    @pytest.mark.onlynoncluster
     async def test_cluster_failover(self, mock_cluster_resp_ok):
         assert await mock_cluster_resp_ok.cluster("FAILOVER", 1) is True
 
+    @pytest.mark.onlynoncluster
     async def test_cluster_forget(self, mock_cluster_resp_ok):
         assert await mock_cluster_resp_ok.cluster("FORGET", 1) is True
 
+    @pytest.mark.onlynoncluster
     async def test_cluster_info(self, mock_cluster_resp_info):
         assert isinstance(await mock_cluster_resp_info.cluster("info"), dict)
 
+    @pytest.mark.onlynoncluster
     async def test_cluster_keyslot(self, mock_cluster_resp_int):
         assert isinstance(await mock_cluster_resp_int.cluster("keyslot", "asdf"), int)
 
+    @pytest.mark.onlynoncluster
     async def test_cluster_meet(self, mock_cluster_resp_ok):
         assert await mock_cluster_resp_ok.cluster("meet", "ip", "port", 1) is True
 
+    @pytest.mark.onlynoncluster
     async def test_cluster_nodes(self, mock_cluster_resp_nodes):
         assert isinstance(await mock_cluster_resp_nodes.cluster("nodes"), dict)
 
+    @pytest.mark.onlynoncluster
     async def test_cluster_replicate(self, mock_cluster_resp_ok):
         assert await mock_cluster_resp_ok.cluster("replicate", "nodeid") is True
 
+    @pytest.mark.onlynoncluster
     async def test_cluster_reset(self, mock_cluster_resp_ok):
         assert await mock_cluster_resp_ok.cluster("reset", "hard") is True
 
+    @pytest.mark.onlynoncluster
     async def test_cluster_saveconfig(self, mock_cluster_resp_ok):
         assert await mock_cluster_resp_ok.cluster("saveconfig") is True
 
+    @pytest.mark.onlynoncluster
     async def test_cluster_setslot(self, mock_cluster_resp_ok):
         assert (
             await mock_cluster_resp_ok.cluster("setslot", 1, "IMPORTING", "nodeid")
             is True
         )
 
+    @pytest.mark.onlynoncluster
     async def test_cluster_slaves(self, mock_cluster_resp_slaves):
         assert isinstance(
             await mock_cluster_resp_slaves.cluster("slaves", "nodeid"), dict
         )
 
     @skip_if_server_version_lt("3.0.0")
+    @pytest.mark.onlynoncluster
     async def test_readwrite(self, r: redis.Redis):
         assert await r.readwrite()
 
     @skip_if_server_version_lt("3.0.0")
+    @pytest.mark.onlynoncluster
     async def test_readonly_invalid_cluster_state(self, r: redis.Redis):
         with pytest.raises(exceptions.RedisError):
             await r.readonly()
 
     @skip_if_server_version_lt("3.0.0")
+    @pytest.mark.onlynoncluster
     async def test_readonly(self, mock_cluster_resp_ok):
         assert await mock_cluster_resp_ok.readonly() is True
 
@@ -2315,6 +2408,7 @@ async def test_georadius_sort(self, r: redis.Redis):
         ]
 
     @skip_if_server_version_lt("3.2.0")
+    @pytest.mark.onlynoncluster
     async def test_georadius_store(self, r: redis.Redis):
         values = (2.1909389952632, 41.433791470673, "place1") + (
             2.1873744593677,
@@ -2328,6 +2422,7 @@ async def test_georadius_store(self, r: redis.Redis):
 
     @skip_unless_arch_bits(64)
     @skip_if_server_version_lt("3.2.0")
+    @pytest.mark.onlynoncluster
     async def test_georadius_store_dist(self, r: redis.Redis):
         values = (2.1909389952632, 41.433791470673, "place1") + (
             2.1873744593677,
@@ -2723,25 +2818,11 @@ async def test_xread(self, r: redis.Redis):
         # xread starting at 0 returns both messages
         assert await r.xread(streams={stream: 0}) == expected
 
-        expected = [
-            [
-                stream.encode(),
-                [
-                    await get_stream_message(r, stream, m1),
-                ],
-            ]
-        ]
+        expected = [[stream.encode(), [await get_stream_message(r, stream, m1)]]]
         # xread starting at 0 and count=1 returns only the first message
         assert await r.xread(streams={stream: 0}, count=1) == expected
 
-        expected = [
-            [
-                stream.encode(),
-                [
-                    await get_stream_message(r, stream, m2),
-                ],
-            ]
-        ]
+        expected = [[stream.encode(), [await get_stream_message(r, stream, m2)]]]
         # xread starting at m1 returns only the second message
         assert await r.xread(streams={stream: m1}) == expected
 
@@ -2772,14 +2853,7 @@ async def test_xreadgroup(self, r: redis.Redis):
         await r.xgroup_destroy(stream, group)
         await r.xgroup_create(stream, group, 0)
 
-        expected = [
-            [
-                stream.encode(),
-                [
-                    await get_stream_message(r, stream, m1),
-                ],
-            ]
-        ]
+        expected = [[stream.encode(), [await get_stream_message(r, stream, m1)]]]
         # xread with count=1 returns only the first message
         assert (
             await r.xreadgroup(group, consumer, streams={stream: ">"}, count=1)
@@ -2817,15 +2891,7 @@ async def test_xreadgroup(self, r: redis.Redis):
         await r.xgroup_destroy(stream, group)
         await r.xgroup_create(stream, group, "0")
         # delete all the messages in the stream
-        expected = [
-            [
-                stream.encode(),
-                [
-                    (m1, {}),
-                    (m2, {}),
-                ],
-            ]
-        ]
+        expected = [[stream.encode(), [(m1, {}), (m2, {})]]]
         await r.xreadgroup(group, consumer, streams={stream: ">"})
         await r.xtrim(stream, 0)
         assert await r.xreadgroup(group, consumer, streams={stream: "0"}) == expected
@@ -2872,6 +2938,7 @@ async def test_xtrim(self, r: redis.Redis):
         # 1 message is trimmed
         assert await r.xtrim(stream, 3, approximate=False) == 1
 
+    @pytest.mark.onlynoncluster
     async def test_bitfield_operations(self, r: redis.Redis):
         # comments show affected bits
         await r.execute_command("SELECT", 10)
@@ -2958,11 +3025,13 @@ async def test_memory_usage(self, r: redis.Redis):
         assert isinstance(await r.memory_usage("foo"), int)
 
     @skip_if_server_version_lt("4.0.0")
+    @pytest.mark.onlynoncluster
     async def test_module_list(self, r: redis.Redis):
         assert isinstance(await r.module_list(), list)
         assert not await r.module_list()
 
 
+@pytest.mark.onlynoncluster
 class TestBinarySave:
     async def test_binary_get_set(self, r: redis.Redis):
         assert await r.set(" foo bar ", "123")
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index 46abec01d6..f6259adbd2 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -51,14 +51,12 @@ def inner():
     # assert mod.get('fookey') == d
 
 
-@pytest.mark.onlynoncluster
 async def test_socket_param_regression(r):
     """A regression test for issue #1060"""
     conn = UnixDomainSocketConnection()
     _ = await conn.disconnect() is True
 
 
-@pytest.mark.onlynoncluster
 async def test_can_run_concurrent_commands(r):
     assert await r.ping() is True
     assert all(await asyncio.gather(*(r.ping() for _ in range(10))))
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
index f9dfefd5cc..6c56558d59 100644
--- a/tests/test_asyncio/test_connection_pool.py
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -20,6 +20,7 @@
 pytestmark = pytest.mark.asyncio
 
 
+@pytest.mark.onlynoncluster
 class TestRedisAutoReleaseConnectionPool:
     @pytest_asyncio.fixture
     async def r(self, create_redis) -> redis.Redis:
@@ -112,7 +113,6 @@ async def can_read(self, timeout: float = 0):
         return False
 
 
-@pytest.mark.onlynoncluster
 class TestConnectionPool:
     def get_pool(
         self,
@@ -189,7 +189,6 @@ def test_repr_contains_db_info_unix(self):
         assert repr(pool) == expected
 
 
-@pytest.mark.onlynoncluster
 class TestBlockingConnectionPool:
     def get_pool(self, connection_kwargs=None, max_connections=10, timeout=20):
         connection_kwargs = connection_kwargs or {}
@@ -296,38 +295,27 @@ def test_repr_contains_db_info_unix(self):
         assert repr(pool) == expected
 
 
-@pytest.mark.onlynoncluster
 class TestConnectionPoolURLParsing:
     def test_hostname(self):
         pool = redis.ConnectionPool.from_url("redis://my.host")
         assert pool.connection_class == redis.Connection
-        assert pool.connection_kwargs == {
-            "host": "my.host",
-        }
+        assert pool.connection_kwargs == {"host": "my.host"}
 
     def test_quoted_hostname(self):
         pool = redis.ConnectionPool.from_url("redis://my %2F host %2B%3D+")
         assert pool.connection_class == redis.Connection
-        assert pool.connection_kwargs == {
-            "host": "my / host +=+",
-        }
+        assert pool.connection_kwargs == {"host": "my / host +=+"}
 
     def test_port(self):
         pool = redis.ConnectionPool.from_url("redis://localhost:6380")
         assert pool.connection_class == redis.Connection
-        assert pool.connection_kwargs == {
-            "host": "localhost",
-            "port": 6380,
-        }
+        assert pool.connection_kwargs == {"host": "localhost", "port": 6380}
 
     @skip_if_server_version_lt("6.0.0")
     def test_username(self):
         pool = redis.ConnectionPool.from_url("redis://myuser:@localhost")
         assert pool.connection_class == redis.Connection
-        assert pool.connection_kwargs == {
-            "host": "localhost",
-            "username": "myuser",
-        }
+        assert pool.connection_kwargs == {"host": "localhost", "username": "myuser"}
 
     @skip_if_server_version_lt("6.0.0")
     def test_quoted_username(self):
@@ -343,10 +331,7 @@ def test_quoted_username(self):
     def test_password(self):
         pool = redis.ConnectionPool.from_url("redis://:mypassword@localhost")
         assert pool.connection_class == redis.Connection
-        assert pool.connection_kwargs == {
-            "host": "localhost",
-            "password": "mypassword",
-        }
+        assert pool.connection_kwargs == {"host": "localhost", "password": "mypassword"}
 
     def test_quoted_password(self):
         pool = redis.ConnectionPool.from_url(
@@ -371,26 +356,17 @@ def test_username_and_password(self):
     def test_db_as_argument(self):
         pool = redis.ConnectionPool.from_url("redis://localhost", db=1)
         assert pool.connection_class == redis.Connection
-        assert pool.connection_kwargs == {
-            "host": "localhost",
-            "db": 1,
-        }
+        assert pool.connection_kwargs == {"host": "localhost", "db": 1}
 
     def test_db_in_path(self):
         pool = redis.ConnectionPool.from_url("redis://localhost/2", db=1)
         assert pool.connection_class == redis.Connection
-        assert pool.connection_kwargs == {
-            "host": "localhost",
-            "db": 2,
-        }
+        assert pool.connection_kwargs == {"host": "localhost", "db": 2}
 
     def test_db_in_querystring(self):
         pool = redis.ConnectionPool.from_url("redis://localhost/2?db=3", db=1)
         assert pool.connection_class == redis.Connection
-        assert pool.connection_kwargs == {
-            "host": "localhost",
-            "db": 3,
-        }
+        assert pool.connection_kwargs == {"host": "localhost", "db": 3}
 
     def test_extra_typed_querystring_options(self):
         pool = redis.ConnectionPool.from_url(
@@ -450,9 +426,7 @@ def test_calling_from_subclass_returns_correct_instance(self):
     def test_client_creates_connection_pool(self):
         r = redis.Redis.from_url("redis://myhost")
         assert r.connection_pool.connection_class == redis.Connection
-        assert r.connection_pool.connection_kwargs == {
-            "host": "myhost",
-        }
+        assert r.connection_pool.connection_kwargs == {"host": "myhost"}
 
     def test_invalid_scheme_raises_error(self):
         with pytest.raises(ValueError) as cm:
@@ -463,23 +437,17 @@ def test_invalid_scheme_raises_error(self):
         )
 
 
-@pytest.mark.onlynoncluster
 class TestConnectionPoolUnixSocketURLParsing:
     def test_defaults(self):
         pool = redis.ConnectionPool.from_url("unix:///socket")
         assert pool.connection_class == redis.UnixDomainSocketConnection
-        assert pool.connection_kwargs == {
-            "path": "/socket",
-        }
+        assert pool.connection_kwargs == {"path": "/socket"}
 
     @skip_if_server_version_lt("6.0.0")
     def test_username(self):
         pool = redis.ConnectionPool.from_url("unix://myuser:@/socket")
         assert pool.connection_class == redis.UnixDomainSocketConnection
-        assert pool.connection_kwargs == {
-            "path": "/socket",
-            "username": "myuser",
-        }
+        assert pool.connection_kwargs == {"path": "/socket", "username": "myuser"}
 
     @skip_if_server_version_lt("6.0.0")
     def test_quoted_username(self):
@@ -495,10 +463,7 @@ def test_quoted_username(self):
     def test_password(self):
         pool = redis.ConnectionPool.from_url("unix://:mypassword@/socket")
         assert pool.connection_class == redis.UnixDomainSocketConnection
-        assert pool.connection_kwargs == {
-            "path": "/socket",
-            "password": "mypassword",
-        }
+        assert pool.connection_kwargs == {"path": "/socket", "password": "mypassword"}
 
     def test_quoted_password(self):
         pool = redis.ConnectionPool.from_url(
@@ -523,18 +488,12 @@ def test_quoted_path(self):
     def test_db_as_argument(self):
         pool = redis.ConnectionPool.from_url("unix:///socket", db=1)
         assert pool.connection_class == redis.UnixDomainSocketConnection
-        assert pool.connection_kwargs == {
-            "path": "/socket",
-            "db": 1,
-        }
+        assert pool.connection_kwargs == {"path": "/socket", "db": 1}
 
     def test_db_in_querystring(self):
         pool = redis.ConnectionPool.from_url("unix:///socket?db=2", db=1)
         assert pool.connection_class == redis.UnixDomainSocketConnection
-        assert pool.connection_kwargs == {
-            "path": "/socket",
-            "db": 2,
-        }
+        assert pool.connection_kwargs == {"path": "/socket", "db": 2}
 
     def test_client_name_in_querystring(self):
         pool = redis.ConnectionPool.from_url("redis://location?client_name=test-client")
@@ -546,14 +505,11 @@ def test_extra_querystring_options(self):
         assert pool.connection_kwargs == {"path": "/socket", "a": "1", "b": "2"}
 
 
-@pytest.mark.onlynoncluster
 class TestSSLConnectionURLParsing:
     def test_host(self):
         pool = redis.ConnectionPool.from_url("rediss://my.host")
         assert pool.connection_class == redis.SSLConnection
-        assert pool.connection_kwargs == {
-            "host": "my.host",
-        }
+        assert pool.connection_kwargs == {"host": "my.host"}
 
     def test_cert_reqs_options(self):
         import ssl
@@ -578,7 +534,6 @@ def get_connection(self, *args, **kwargs):
         assert pool.get_connection("_").check_hostname is True
 
 
-@pytest.mark.onlynoncluster
 class TestConnection:
     async def test_on_connect_error(self):
         """
@@ -709,7 +664,7 @@ async def r(self, create_redis):
 
     def assert_interval_advanced(self, connection):
         diff = connection.next_health_check - asyncio.get_event_loop().time()
-        assert self.interval > diff > (self.interval - 1)
+        assert self.interval >= diff > (self.interval - 1)
 
     async def test_health_check_runs(self, r):
         if r.connection:
diff --git a/tests/test_asyncio/test_lock.py b/tests/test_asyncio/test_lock.py
index c496718a67..8ceb3bc958 100644
--- a/tests/test_asyncio/test_lock.py
+++ b/tests/test_asyncio/test_lock.py
@@ -114,7 +114,7 @@ async def test_blocking_timeout(self, r, event_loop):
         start = event_loop.time()
         assert not await lock2.acquire()
         # The elapsed duration should be less than the total blocking_timeout
-        assert bt > (event_loop.time() - start) > bt - sleep
+        assert bt >= (event_loop.time() - start) > bt - sleep
         await lock1.release()
 
     async def test_context_manager(self, r):
diff --git a/tests/test_asyncio/test_retry.py b/tests/test_asyncio/test_retry.py
index dee83ba664..d696d72d1c 100644
--- a/tests/test_asyncio/test_retry.py
+++ b/tests/test_asyncio/test_retry.py
@@ -19,7 +19,6 @@ def compute(self, failures):
         return 0
 
 
-@pytest.mark.onlynoncluster
 class TestConnectionConstructorWithRetry:
     "Test that the Connection constructors properly handles Retry objects"
 
@@ -41,7 +40,6 @@ def test_retry_on_timeout_retry(self, Class, retries: int):
         assert c.retry._retries == retries
 
 
-@pytest.mark.onlynoncluster
 class TestRetry:
     "Test that Retry calls backoff and retries the expected number of times"
 
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 3794c31891..376e3f8aaf 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -665,8 +665,8 @@ class TestClusterRedisCommands:
 
     def test_case_insensitive_command_names(self, r):
         assert (
-            r.cluster_response_callbacks["cluster addslots"]
-            == r.cluster_response_callbacks["CLUSTER ADDSLOTS"]
+            r.cluster_response_callbacks["cluster slots"]
+            == r.cluster_response_callbacks["CLUSTER SLOTS"]
         )
 
     def test_get_and_set(self, r):
@@ -1038,7 +1038,7 @@ def test_cluster_save_config(self, r):
 
     @skip_if_redis_enterprise()
     def test_cluster_get_keys_in_slot(self, r):
-        response = [b"{foo}1", b"{foo}2"]
+        response = ["{foo}1", "{foo}2"]
         node = r.nodes_manager.get_node_from_slot(12182)
         mock_node_resp(node, response)
         keys = r.cluster_get_keys_in_slot(12182, 4)
diff --git a/tox.ini b/tox.ini
index a880da45a5..0ceb008cf6 100644
--- a/tox.ini
+++ b/tox.ini
@@ -115,7 +115,7 @@ volumes =
 [docker:redismod_cluster]
 name = redismod_cluster
 image = redisfab/redis-py-modcluster:6.2.6
-ports = 
+ports =
     46379:46379/tcp
     46380:46380/tcp
     46381:46381/tcp
@@ -291,7 +291,7 @@ commands =
     standalone: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' {posargs}
     standalone-uvloop: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' --uvloop {posargs}
     cluster: pytest --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={env:CLUSTER_URL:} --redis-unstable-url={env:UNSTABLE_CLUSTER_URL:} {posargs}
-    cluster-uvloop: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' --uvloop {posargs}
+    cluster-uvloop: pytest --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={env:CLUSTER_URL:} --redis-unstable-url={env:UNSTABLE_CLUSTER_URL:} --uvloop {posargs}
 
 [testenv:redis5]
 deps =
@@ -337,7 +337,6 @@ skipsdist = true
 skip_install = true
 deps = -r {toxinidir}/dev_requirements.txt
 docker = {[testenv]docker}
-commands = /usr/bin/echo docker_up
 
 [testenv:linters]
 deps_files = dev_requirements.txt
diff --git a/whitelist.py b/whitelist.py
index 27210284c7..8c9cee3c29 100644
--- a/whitelist.py
+++ b/whitelist.py
@@ -14,4 +14,6 @@
 exc_value  # unused variable (/data/repos/redis/redis-py/redis/asyncio/utils.py:26)
 traceback  # unused variable (/data/repos/redis/redis-py/redis/asyncio/utils.py:26)
 AsyncConnectionPool  # unused import (//data/repos/redis/redis-py/redis/typing.py:9)
+AsyncEncoder  # unused import (//data/repos/redis/redis-py/redis/typing.py:10)
 AsyncRedis  # unused import (//data/repos/redis/redis-py/redis/commands/core.py:49)
+TargetNodesT  # unused import (//data/repos/redis/redis-py/redis/commands/cluster.py:46)

From 3a8802214a05fed4a0828b1f2965ac140e11ee32 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 8 May 2022 15:05:43 +0300
Subject: [PATCH 0488/1164] Add support for COMMAND LIST (#2149)

* Add support for COMMAND LIST

* style change
---
 redis/commands/core.py | 28 ++++++++++++++++++++++++++++
 tests/test_commands.py | 10 ++++++++++
 2 files changed, 38 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 6526ef167a..073161f350 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -769,6 +769,34 @@ def command_info(self, **kwargs) -> None:
     def command_count(self, **kwargs) -> ResponseT:
         return self.execute_command("COMMAND COUNT", **kwargs)
 
+    def command_list(
+        self,
+        module: Optional[str] = None,
+        category: Optional[str] = None,
+        pattern: Optional[str] = None,
+    ) -> ResponseT:
+        """
+        Return an array of the server's command names.
+        You can use one of the following filters:
+        ``module``: get the commands that belong to the module
+        ``category``: get the commands in the ACL category
+        ``pattern``: get the commands that match the given pattern
+
+        For more information see https://redis.io/commands/command-list/
+        """
+        pieces = []
+        if module is not None:
+            pieces.extend(["MODULE", module])
+        if category is not None:
+            pieces.extend(["ACLCAT", category])
+        if pattern is not None:
+            pieces.extend(["PATTERN", pattern])
+
+        if pieces:
+            pieces.insert(0, "FILTERBY")
+
+        return self.execute_command("COMMAND LIST", *pieces)
+
     def command_getkeysandflags(self, *args: List[str]) -> List[Union[str, List[str]]]:
         """
         Returns array of keys from a full Redis command and their usage flags.
diff --git a/tests/test_commands.py b/tests/test_commands.py
index b7287b4fea..00eac17ccf 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -4550,6 +4550,16 @@ def test_command_docs(self, r):
         with pytest.raises(NotImplementedError):
             r.command_docs("set")
 
+    @skip_if_server_version_lt("7.0.0")
+    @skip_if_redis_enterprise()
+    def test_command_list(self, r: redis.Redis):
+        assert len(r.command_list()) > 300
+        assert len(r.command_list(module="fakemod")) == 0
+        assert len(r.command_list(category="list")) > 15
+        assert "lpop" in r.command_list(pattern="l*")
+        with pytest.raises(redis.ResponseError):
+            r.command_list(category="list", pattern="l*")
+
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.8.13")
     @skip_if_redis_enterprise()

From faf55b65ffb7294b1a639cc9adb0231b987b0e32 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 8 May 2022 15:23:00 +0300
Subject: [PATCH 0489/1164] Add support for CLUSTER SHARDS (#2151)

* Add support for CLUSTER SHARDS

* linters

* add docstring

* linters
---
 redis/cluster.py          | 26 +++++++++++++++++++++++++-
 redis/commands/cluster.py |  8 ++++++++
 tests/test_cluster.py     | 23 +++++++++++++++++++++++
 3 files changed, 56 insertions(+), 1 deletion(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index d42d49b68a..e5baee2f2c 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -92,6 +92,26 @@ def fix_server(*args):
     return slots
 
 
+def parse_cluster_shards(resp, **options):
+    """
+    Parse CLUSTER SHARDS response.
+    """
+    shards = []
+    for x in resp:
+        shard = {"slots": [], "nodes": []}
+        for i in range(0, len(x[1]), 2):
+            shard["slots"].append((x[1][i], (x[1][i + 1])))
+        nodes = x[3]
+        for node in nodes:
+            dict_node = {}
+            for i in range(0, len(node), 2):
+                dict_node[node[i]] = node[i + 1]
+            shard["nodes"].append(dict_node)
+        shards.append(shard)
+
+    return shards
+
+
 PRIMARY = "primary"
 REPLICA = "replica"
 SLOT_ID = "slot-id"
@@ -274,6 +294,7 @@ class AbstractRedisCluster:
                 "CLUSTER RESET",
                 "CLUSTER SET-CONFIG-EPOCH",
                 "CLUSTER SLOTS",
+                "CLUSTER SHARDS",
                 "CLUSTER COUNT-FAILURE-REPORTS",
                 "CLUSTER KEYSLOT",
                 "COMMAND",
@@ -354,7 +375,10 @@ class AbstractRedisCluster:
         ],
     )
 
-    CLUSTER_COMMANDS_RESPONSE_CALLBACKS = {"CLUSTER SLOTS": parse_cluster_slots}
+    CLUSTER_COMMANDS_RESPONSE_CALLBACKS = {
+        "CLUSTER SLOTS": parse_cluster_slots,
+        "CLUSTER SHARDS": parse_cluster_shards,
+    }
 
     RESULT_CALLBACKS = dict_merge(
         list_keys_to_dict(["PUBSUB NUMSUB"], parse_pubsub_numsub),
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index 06b702f9f9..b91b65f083 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -581,6 +581,14 @@ def cluster_slots(self, target_nodes: Optional["TargetNodesT"] = None) -> Respon
         """
         return self.execute_command("CLUSTER SLOTS", target_nodes=target_nodes)
 
+    def cluster_shards(self, target_nodes=None):
+        """
+        Returns details about the shards of the cluster.
+
+        For more information see https://redis.io/commands/cluster-shards
+        """
+        return self.execute_command("CLUSTER SHARDS", target_nodes=target_nodes)
+
     def cluster_links(self, target_node: "TargetNodesT") -> ResponseT:
         """
         Each node in a Redis Cluster maintains a pair of long-lived TCP link with each
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 376e3f8aaf..7e64345ad7 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -856,6 +856,29 @@ def test_cluster_slots(self, r):
         assert cluster_slots.get((0, 8191)) is not None
         assert cluster_slots.get((0, 8191)).get("primary") == ("127.0.0.1", 7000)
 
+    @skip_if_server_version_lt("7.0.0")
+    @skip_if_redis_enterprise()
+    def test_cluster_shards(self, r):
+        cluster_shards = r.cluster_shards()
+        assert isinstance(cluster_shards, list)
+        assert isinstance(cluster_shards[0], dict)
+        attributes = [
+            "id",
+            "endpoint",
+            "ip",
+            "hostname",
+            "port",
+            "tls-port",
+            "role",
+            "replication-offset",
+            "health",
+        ]
+        for x in cluster_shards:
+            assert list(x.keys()) == ["slots", "nodes"]
+            for node in x["nodes"]:
+                for attribute in node.keys():
+                    assert attribute in attributes
+
     @skip_if_redis_enterprise()
     def test_cluster_addslots(self, r):
         node = r.get_random_node()

From 883fca7199a7ab7adc583b9ee324a9e44d0909eb Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 8 May 2022 15:23:09 +0300
Subject: [PATCH 0490/1164] Get command keys for subcommands (#2170)

* parse subcommands

* fix tests
---
 redis/client.py          |  4 ++++
 redis/cluster.py         |  1 +
 redis/commands/parser.py | 26 +++++++++++++++++++++++++-
 tests/test_cluster.py    |  1 -
 tests/test_commands.py   |  3 ++-
 5 files changed, 32 insertions(+), 3 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 7c83b61d8e..58668eebf4 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -553,6 +553,10 @@ def parse_command(response, **options):
         cmd_dict["first_key_pos"] = command[3]
         cmd_dict["last_key_pos"] = command[4]
         cmd_dict["step_count"] = command[5]
+        if len(command) > 7:
+            cmd_dict["tips"] = command[7]
+            cmd_dict["key_specifications"] = command[8]
+            cmd_dict["subcommands"] = command[9]
         commands[cmd_name] = cmd_dict
     return commands
 
diff --git a/redis/cluster.py b/redis/cluster.py
index e5baee2f2c..fa1322f103 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -240,6 +240,7 @@ class AbstractRedisCluster:
             [
                 "ACL CAT",
                 "ACL DELUSER",
+                "ACL DRYRUN",
                 "ACL GENPASS",
                 "ACL GETUSER",
                 "ACL HELP",
diff --git a/redis/commands/parser.py b/redis/commands/parser.py
index 936f2ec97d..7560603d75 100644
--- a/redis/commands/parser.py
+++ b/redis/commands/parser.py
@@ -25,6 +25,21 @@ def initialize(self, r):
             commands[cmd.lower()] = commands.pop(cmd)
         self.commands = commands
 
+    def parse_subcommand(self, command, **options):
+        cmd_dict = {}
+        cmd_name = str_if_bytes(command[0])
+        cmd_dict["name"] = cmd_name
+        cmd_dict["arity"] = int(command[1])
+        cmd_dict["flags"] = [str_if_bytes(flag) for flag in command[2]]
+        cmd_dict["first_key_pos"] = command[3]
+        cmd_dict["last_key_pos"] = command[4]
+        cmd_dict["step_count"] = command[5]
+        if len(command) > 7:
+            cmd_dict["tips"] = command[7]
+            cmd_dict["key_specifications"] = command[8]
+            cmd_dict["subcommands"] = command[9]
+        return cmd_dict
+
     # As soon as this PR is merged into Redis, we should reimplement
     # our logic to use COMMAND INFO changes to determine the key positions
     # https://github.com/redis/redis/pull/8324
@@ -72,8 +87,17 @@ def get_keys(self, redis_conn, *args):
                 and command["first_key_pos"] == 0
                 and command["last_key_pos"] == 0
             ):
+                is_subcmd = False
+                if "subcommands" in command:
+                    subcmd_name = f"{cmd_name}|{args[1].lower()}"
+                    for subcmd in command["subcommands"]:
+                        if str_if_bytes(subcmd[0]) == subcmd_name:
+                            command = self.parse_subcommand(subcmd)
+                            is_subcmd = True
+
                 # The command doesn't have keys in it
-                return None
+                if not is_subcmd:
+                    return None
             last_key_pos = command["last_key_pos"]
             if last_key_pos < 0:
                 last_key_pos = len(args) - abs(last_key_pos)
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 7e64345ad7..de41a107dc 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -1121,7 +1121,6 @@ def test_cluster_links(self, r):
         links_to = sum(x.count("to") for x in res)
         links_for = sum(x.count("from") for x in res)
         assert links_to == links_for
-        print(res)
         for i in range(0, len(res) - 1, 2):
             assert res[i][3] == res[i + 1][3]
 
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 00eac17ccf..d5ab4e3694 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1164,7 +1164,7 @@ def test_expire_option_xx(self, r):
         r.set("key", "val")
         assert r.expire("key", 100, xx=True) == 0
         assert r.expire("key", 100)
-        assert r.expire("key", 500, nx=True) == 1
+        assert r.expire("key", 500, xx=True) == 1
 
     @skip_if_server_version_lt("7.0.0")
     def test_expire_option_gt(self, r):
@@ -3012,6 +3012,7 @@ def test_sort_all_options(self, r):
         assert r.lrange("sorted", 0, 10) == [b"vodka", b"milk", b"gin", b"apple juice"]
 
     @skip_if_server_version_lt("7.0.0")
+    @pytest.mark.onlynoncluster
     def test_sort_ro(self, r):
         r["score:1"] = 8
         r["score:2"] = 3

From c51435d92a8bed246f1c9ad9284c8543fca5d1e0 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 8 May 2022 16:21:41 +0300
Subject: [PATCH 0491/1164] v4.3.0 (#2172)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index ebb71f8ef2..9b9627654d 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.2.2",
+    version="4.3.0",
     packages=find_packages(
         include=[
             "redis",

From 42b937fa1f73f3e8251eba5ec8ead2fcbaec7c50 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 9 May 2022 15:55:47 +0300
Subject: [PATCH 0492/1164] fix import (#2175)

---
 redis/commands/search/__init__.py | 3 ++-
 setup.py                          | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/redis/commands/search/__init__.py b/redis/commands/search/__init__.py
index bcad785495..b1c0e8be73 100644
--- a/redis/commands/search/__init__.py
+++ b/redis/commands/search/__init__.py
@@ -1,5 +1,6 @@
 import redis
 
+from ...asyncio.client import Pipeline as AsyncioPipeline
 from .commands import AsyncSearchCommands, SearchCommands
 
 
@@ -174,5 +175,5 @@ class Pipeline(SearchCommands, redis.client.Pipeline):
     """Pipeline for the module."""
 
 
-class AsyncPipeline(AsyncSearchCommands, redis.asyncio.client.Pipeline):
+class AsyncPipeline(AsyncSearchCommands, AsyncioPipeline):
     """AsyncPipeline for the module."""
diff --git a/setup.py b/setup.py
index 9b9627654d..16387990fc 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.3.0",
+    version="4.3.1",
     packages=find_packages(
         include=[
             "redis",

From a53bc0ca01211e5e14a468077a9d1974dbba6054 Mon Sep 17 00:00:00 2001
From: Avital Fine <98389525+Avital-Fine@users.noreply.github.com>
Date: Mon, 16 May 2022 08:55:55 +0300
Subject: [PATCH 0493/1164] fix incorrect test (#2177)

* fix incorrect test

* Fix types
---
 redis/commands/core.py |  8 +++++---
 tests/test_commands.py | 25 +++++++++++++------------
 2 files changed, 18 insertions(+), 15 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 073161f350..3569d20e0a 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3943,8 +3943,8 @@ def zadd(
         xx: bool = False,
         ch: bool = False,
         incr: bool = False,
-        gt: bool = None,
-        lt: bool = None,
+        gt: bool = False,
+        lt: bool = False,
     ) -> ResponseT:
         """
         Set any number of element-name, score pairs to the key ``name``. Pairs
@@ -3983,12 +3983,14 @@ def zadd(
             raise DataError("ZADD requires at least one element/score pair")
         if nx and xx:
             raise DataError("ZADD allows either 'nx' or 'xx', not both")
+        if gt and lt:
+            raise DataError("ZADD allows either 'gt' or 'lt', not both")
         if incr and len(mapping) != 1:
             raise DataError(
                 "ZADD option 'incr' only works when passing a "
                 "single element/score pair"
             )
-        if nx is True and (gt is not None or lt is not None):
+        if nx and (gt or lt):
             raise DataError("Only one of 'nx', 'lt', or 'gr' may be defined.")
 
         pieces: list[EncodableT] = []
diff --git a/tests/test_commands.py b/tests/test_commands.py
index d5ab4e3694..a3972a5f22 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2215,20 +2215,21 @@ def test_zadd_incr_with_xx(self, r):
 
     @skip_if_server_version_lt("6.2.0")
     def test_zadd_gt_lt(self, r):
+        r.zadd("a", {"a": 2})
+        assert r.zadd("a", {"a": 5}, gt=True, ch=True) == 1
+        assert r.zadd("a", {"a": 1}, gt=True, ch=True) == 0
+        assert r.zadd("a", {"a": 5}, lt=True, ch=True) == 0
+        assert r.zadd("a", {"a": 1}, lt=True, ch=True) == 1
 
-        for i in range(1, 20):
-            r.zadd("a", {f"a{i}": i})
-        assert r.zadd("a", {"a20": 5}, gt=3) == 1
-
-        for i in range(1, 20):
-            r.zadd("a", {f"a{i}": i})
-        assert r.zadd("a", {"a2": 5}, lt=1) == 0
-
-        # cannot use both nx and xx options
+        # cannot combine both nx and xx options and gt and lt options
+        with pytest.raises(exceptions.DataError):
+            r.zadd("a", {"a15": 15}, nx=True, lt=True)
+        with pytest.raises(exceptions.DataError):
+            r.zadd("a", {"a15": 15}, nx=True, gt=True)
+        with pytest.raises(exceptions.DataError):
+            r.zadd("a", {"a15": 15}, lt=True, gt=True)
         with pytest.raises(exceptions.DataError):
-            r.zadd("a", {"a15": 155}, nx=True, lt=True)
-            r.zadd("a", {"a15": 155}, nx=True, gt=True)
-            r.zadd("a", {"a15": 155}, lt=True, gt=True)
+            r.zadd("a", {"a15": 15}, nx=True, xx=True)
 
     def test_zcard(self, r):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})

From 428510b5786c70a26a8797b8eb33b89777132884 Mon Sep 17 00:00:00 2001
From: Avital Fine <98389525+Avital-Fine@users.noreply.github.com>
Date: Tue, 17 May 2022 16:44:12 +0300
Subject: [PATCH 0494/1164] Fix modules links to https://redis.io/commands/
 (#2185)

---
 redis/commands/bf/commands.py     | 66 ++++++++++++++---------------
 redis/commands/graph/commands.py  | 15 ++++---
 redis/commands/json/commands.py   | 47 ++++++++++-----------
 redis/commands/redismodules.py    |  2 +-
 redis/commands/search/commands.py | 70 ++++++++++++++-----------------
 5 files changed, 96 insertions(+), 104 deletions(-)

diff --git a/redis/commands/bf/commands.py b/redis/commands/bf/commands.py
index e911efc621..21c7857abe 100644
--- a/redis/commands/bf/commands.py
+++ b/redis/commands/bf/commands.py
@@ -174,7 +174,7 @@ def create(
     ):
         """
         Create a new Cuckoo Filter `key` an initial `capacity` items.
-        For more information see `CF.RESERVE <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfreserve>`_.
+        For more information see `CF.RESERVE <https://redis.io/commands/cf.reserve>`_.
         """  # noqa
         params = [key, capacity]
         self.append_expansion(params, expansion)
@@ -185,7 +185,7 @@ def create(
     def add(self, key, item):
         """
         Add an `item` to a Cuckoo Filter `key`.
-        For more information see `CF.ADD <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfadd>`_.
+        For more information see `CF.ADD <https://redis.io/commands/cf.add>`_.
         """  # noqa
         params = [key, item]
         return self.execute_command(CF_ADD, *params)
@@ -194,7 +194,7 @@ def addnx(self, key, item):
         """
         Add an `item` to a Cuckoo Filter `key` only if item does not yet exist.
         Command might be slower that `add`.
-        For more information see `CF.ADDNX <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfaddnx>`_.
+        For more information see `CF.ADDNX <https://redis.io/commands/cf.addnx>`_.
         """  # noqa
         params = [key, item]
         return self.execute_command(CF_ADDNX, *params)
@@ -204,7 +204,7 @@ def insert(self, key, items, capacity=None, nocreate=None):
         Add multiple `items` to a Cuckoo Filter `key`, allowing the filter
         to be created with a custom `capacity` if it does not yet exist.
         `items` must be provided as a list.
-        For more information see `CF.INSERT <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfinsert>`_.
+        For more information see `CF.INSERT <https://redis.io/commands/cf.insert>`_.
         """  # noqa
         params = [key]
         self.append_capacity(params, capacity)
@@ -217,7 +217,7 @@ def insertnx(self, key, items, capacity=None, nocreate=None):
         Add multiple `items` to a Cuckoo Filter `key` only if they do not exist yet,
         allowing the filter to be created with a custom `capacity` if it does not yet exist.
         `items` must be provided as a list.
-        For more information see `CF.INSERTNX <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfinsertnx>`_.
+        For more information see `CF.INSERTNX <https://redis.io/commands/cf.insertnx>`_.
         """  # noqa
         params = [key]
         self.append_capacity(params, capacity)
@@ -228,7 +228,7 @@ def insertnx(self, key, items, capacity=None, nocreate=None):
     def exists(self, key, item):
         """
         Check whether an `item` exists in Cuckoo Filter `key`.
-        For more information see `CF.EXISTS <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfexists>`_.
+        For more information see `CF.EXISTS <https://redis.io/commands/cf.exists>`_.
         """  # noqa
         params = [key, item]
         return self.execute_command(CF_EXISTS, *params)
@@ -236,7 +236,7 @@ def exists(self, key, item):
     def delete(self, key, item):
         """
         Delete `item` from `key`.
-        For more information see `CF.DEL <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfdel>`_.
+        For more information see `CF.DEL <https://redis.io/commands/cf.del>`_.
         """  # noqa
         params = [key, item]
         return self.execute_command(CF_DEL, *params)
@@ -244,7 +244,7 @@ def delete(self, key, item):
     def count(self, key, item):
         """
         Return the number of times an `item` may be in the `key`.
-        For more information see `CF.COUNT <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfcount>`_.
+        For more information see `CF.COUNT <https://redis.io/commands/cf.count>`_.
         """  # noqa
         params = [key, item]
         return self.execute_command(CF_COUNT, *params)
@@ -258,7 +258,7 @@ def scandump(self, key, iter):
         The first time this command is called, the value of `iter` should be 0.
         This command will return successive (iter, data) pairs until
         (0, NULL) to indicate completion.
-        For more information see `CF.SCANDUMP <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfscandump>`_.
+        For more information see `CF.SCANDUMP <https://redis.io/commands/cf.scandump>`_.
         """  # noqa
         params = [key, iter]
         return self.execute_command(CF_SCANDUMP, *params)
@@ -269,7 +269,7 @@ def loadchunk(self, key, iter, data):
 
         This command will overwrite any Cuckoo filter stored under key.
         Ensure that the Cuckoo filter will not be modified between invocations.
-        For more information see `CF.LOADCHUNK <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfloadchunk>`_.
+        For more information see `CF.LOADCHUNK <https://redis.io/commands/cf.loadchunk>`_.
         """  # noqa
         params = [key, iter, data]
         return self.execute_command(CF_LOADCHUNK, *params)
@@ -278,7 +278,7 @@ def info(self, key):
         """
         Return size, number of buckets, number of filter, number of items inserted,
         number of items deleted, bucket size, expansion rate, and max iteration.
-        For more information see `CF.INFO <https://oss.redis.com/redisbloom/master/Cuckoo_Commands/#cfinfo>`_.
+        For more information see `CF.INFO <https://redis.io/commands/cf.info>`_.
         """  # noqa
         return self.execute_command(CF_INFO, key)
 
@@ -290,7 +290,7 @@ def reserve(self, key, k, width, depth, decay):
         """
         Create a new Top-K Filter `key` with desired probability of false
         positives `errorRate` expected entries to be inserted as `size`.
-        For more information see `TOPK.RESERVE <https://oss.redis.com/redisbloom/master/TopK_Commands/#topkreserve>`_.
+        For more information see `TOPK.RESERVE <https://redis.io/commands/topk.reserve>`_.
         """  # noqa
         params = [key, k, width, depth, decay]
         return self.execute_command(TOPK_RESERVE, *params)
@@ -298,7 +298,7 @@ def reserve(self, key, k, width, depth, decay):
     def add(self, key, *items):
         """
         Add one `item` or more to a Top-K Filter `key`.
-        For more information see `TOPK.ADD <https://oss.redis.com/redisbloom/master/TopK_Commands/#topkadd>`_.
+        For more information see `TOPK.ADD <https://redis.io/commands/topk.add>`_.
         """  # noqa
         params = [key]
         params += items
@@ -308,7 +308,7 @@ def incrby(self, key, items, increments):
         """
         Add/increase `items` to a Top-K Sketch `key` by ''increments''.
         Both `items` and `increments` are lists.
-        For more information see `TOPK.INCRBY <https://oss.redis.com/redisbloom/master/TopK_Commands/#topkincrby>`_.
+        For more information see `TOPK.INCRBY <https://redis.io/commands/topk.incrby>`_.
 
         Example:
 
@@ -321,7 +321,7 @@ def incrby(self, key, items, increments):
     def query(self, key, *items):
         """
         Check whether one `item` or more is a Top-K item at `key`.
-        For more information see `TOPK.QUERY <https://oss.redis.com/redisbloom/master/TopK_Commands/#topkquery>`_.
+        For more information see `TOPK.QUERY <https://redis.io/commands/topk.query>`_.
         """  # noqa
         params = [key]
         params += items
@@ -330,7 +330,7 @@ def query(self, key, *items):
     def count(self, key, *items):
         """
         Return count for one `item` or more from `key`.
-        For more information see `TOPK.COUNT <https://oss.redis.com/redisbloom/master/TopK_Commands/#topkcount>`_.
+        For more information see `TOPK.COUNT <https://redis.io/commands/topk.count>`_.
         """  # noqa
         params = [key]
         params += items
@@ -341,7 +341,7 @@ def list(self, key, withcount=False):
         Return full list of items in Top-K list of `key`.
         If `withcount` set to True, return full list of items
         with probabilistic count in Top-K list of `key`.
-        For more information see `TOPK.LIST <https://oss.redis.com/redisbloom/master/TopK_Commands/#topklist>`_.
+        For more information see `TOPK.LIST <https://redis.io/commands/topk.list>`_.
         """  # noqa
         params = [key]
         if withcount:
@@ -351,7 +351,7 @@ def list(self, key, withcount=False):
     def info(self, key):
         """
         Return k, width, depth and decay values of `key`.
-        For more information see `TOPK.INFO <https://oss.redis.com/redisbloom/master/TopK_Commands/#topkinfo>`_.
+        For more information see `TOPK.INFO <https://redis.io/commands/topk.info>`_.
         """  # noqa
         return self.execute_command(TOPK_INFO, key)
 
@@ -360,7 +360,7 @@ class TDigestCommands:
     def create(self, key, compression):
         """
         Allocate the memory and initialize the t-digest.
-        For more information see `TDIGEST.CREATE <https://oss.redis.com/redisbloom/master/TDigest_Commands/#tdigestcreate>`_.
+        For more information see `TDIGEST.CREATE <https://redis.io/commands/tdigest.create>`_.
         """  # noqa
         params = [key, compression]
         return self.execute_command(TDIGEST_CREATE, *params)
@@ -368,7 +368,7 @@ def create(self, key, compression):
     def reset(self, key):
         """
         Reset the sketch `key` to zero - empty out the sketch and re-initialize it.
-        For more information see `TDIGEST.RESET <https://oss.redis.com/redisbloom/master/TDigest_Commands/#tdigestreset>`_.
+        For more information see `TDIGEST.RESET <https://redis.io/commands/tdigest.reset>`_.
         """  # noqa
         return self.execute_command(TDIGEST_RESET, key)
 
@@ -376,7 +376,7 @@ def add(self, key, values, weights):
         """
         Add one or more samples (value with weight) to a sketch `key`.
         Both `values` and `weights` are lists.
-        For more information see `TDIGEST.ADD <https://oss.redis.com/redisbloom/master/TDigest_Commands/#tdigestadd>`_.
+        For more information see `TDIGEST.ADD <https://redis.io/commands/tdigest.add>`_.
 
         Example:
 
@@ -389,7 +389,7 @@ def add(self, key, values, weights):
     def merge(self, toKey, fromKey):
         """
         Merge all of the values from 'fromKey' to 'toKey' sketch.
-        For more information see `TDIGEST.MERGE <https://oss.redis.com/redisbloom/master/TDigest_Commands/#tdigestmerge>`_.
+        For more information see `TDIGEST.MERGE <https://redis.io/commands/tdigest.merge>`_.
         """  # noqa
         params = [toKey, fromKey]
         return self.execute_command(TDIGEST_MERGE, *params)
@@ -397,14 +397,14 @@ def merge(self, toKey, fromKey):
     def min(self, key):
         """
         Return minimum value from the sketch `key`. Will return DBL_MAX if the sketch is empty.
-        For more information see `TDIGEST.MIN <https://oss.redis.com/redisbloom/master/TDigest_Commands/#tdigestmin>`_.
+        For more information see `TDIGEST.MIN <https://redis.io/commands/tdigest.min>`_.
         """  # noqa
         return self.execute_command(TDIGEST_MIN, key)
 
     def max(self, key):
         """
         Return maximum value from the sketch `key`. Will return DBL_MIN if the sketch is empty.
-        For more information see `TDIGEST.MAX <https://oss.redis.com/redisbloom/master/TDigest_Commands/#tdigestmax>`_.
+        For more information see `TDIGEST.MAX <https://redis.io/commands/tdigest.max>`_.
         """  # noqa
         return self.execute_command(TDIGEST_MAX, key)
 
@@ -412,7 +412,7 @@ def quantile(self, key, quantile):
         """
         Return double value estimate of the cutoff such that a specified fraction of the data
         added to this TDigest would be less than or equal to the cutoff.
-        For more information see `TDIGEST.QUANTILE <https://oss.redis.com/redisbloom/master/TDigest_Commands/#tdigestquantile>`_.
+        For more information see `TDIGEST.QUANTILE <https://redis.io/commands/tdigest.quantile>`_.
         """  # noqa
         params = [key, quantile]
         return self.execute_command(TDIGEST_QUANTILE, *params)
@@ -420,7 +420,7 @@ def quantile(self, key, quantile):
     def cdf(self, key, value):
         """
         Return double fraction of all points added which are <= value.
-        For more information see `TDIGEST.CDF <https://oss.redis.com/redisbloom/master/TDigest_Commands/#tdigestcdf>`_.
+        For more information see `TDIGEST.CDF <https://redis.io/commands/tdigest.cdf>`_.
         """  # noqa
         params = [key, value]
         return self.execute_command(TDIGEST_CDF, *params)
@@ -429,7 +429,7 @@ def info(self, key):
         """
         Return Compression, Capacity, Merged Nodes, Unmerged Nodes, Merged Weight, Unmerged Weight
         and Total Compressions.
-        For more information see `TDIGEST.INFO <https://oss.redis.com/redisbloom/master/TDigest_Commands/#tdigestinfo>`_.
+        For more information see `TDIGEST.INFO <https://redis.io/commands/tdigest.info>`_.
         """  # noqa
         return self.execute_command(TDIGEST_INFO, key)
 
@@ -441,7 +441,7 @@ class CMSCommands:
     def initbydim(self, key, width, depth):
         """
         Initialize a Count-Min Sketch `key` to dimensions (`width`, `depth`) specified by user.
-        For more information see `CMS.INITBYDIM <https://oss.redis.com/redisbloom/master/CountMinSketch_Commands/#cmsinitbydim>`_.
+        For more information see `CMS.INITBYDIM <https://redis.io/commands/cms.initbydim>`_.
         """  # noqa
         params = [key, width, depth]
         return self.execute_command(CMS_INITBYDIM, *params)
@@ -449,7 +449,7 @@ def initbydim(self, key, width, depth):
     def initbyprob(self, key, error, probability):
         """
         Initialize a Count-Min Sketch `key` to characteristics (`error`, `probability`) specified by user.
-        For more information see `CMS.INITBYPROB <https://oss.redis.com/redisbloom/master/CountMinSketch_Commands/#cmsinitbyprob>`_.
+        For more information see `CMS.INITBYPROB <https://redis.io/commands/cms.initbyprob>`_.
         """  # noqa
         params = [key, error, probability]
         return self.execute_command(CMS_INITBYPROB, *params)
@@ -458,7 +458,7 @@ def incrby(self, key, items, increments):
         """
         Add/increase `items` to a Count-Min Sketch `key` by ''increments''.
         Both `items` and `increments` are lists.
-        For more information see `CMS.INCRBY <https://oss.redis.com/redisbloom/master/CountMinSketch_Commands/#cmsincrby>`_.
+        For more information see `CMS.INCRBY <https://redis.io/commands/cms.incrby>`_.
 
         Example:
 
@@ -471,7 +471,7 @@ def incrby(self, key, items, increments):
     def query(self, key, *items):
         """
         Return count for an `item` from `key`. Multiple items can be queried with one call.
-        For more information see `CMS.QUERY <https://oss.redis.com/redisbloom/master/CountMinSketch_Commands/#cmsquery>`_.
+        For more information see `CMS.QUERY <https://redis.io/commands/cms.query>`_.
         """  # noqa
         params = [key]
         params += items
@@ -483,7 +483,7 @@ def merge(self, destKey, numKeys, srcKeys, weights=[]):
         All sketches must have identical width and depth.
         `Weights` can be used to multiply certain sketches. Default weight is 1.
         Both `srcKeys` and `weights` are lists.
-        For more information see `CMS.MERGE <https://oss.redis.com/redisbloom/master/CountMinSketch_Commands/#cmsmerge>`_.
+        For more information see `CMS.MERGE <https://redis.io/commands/cms.merge>`_.
         """  # noqa
         params = [destKey, numKeys]
         params += srcKeys
@@ -493,6 +493,6 @@ def merge(self, destKey, numKeys, srcKeys, weights=[]):
     def info(self, key):
         """
         Return width, depth and total count of the sketch.
-        For more information see `CMS.INFO <https://oss.redis.com/redisbloom/master/CountMinSketch_Commands/#cmsinfo>`_.
+        For more information see `CMS.INFO <https://redis.io/commands/cms.info>`_.
         """  # noqa
         return self.execute_command(CMS_INFO, key)
diff --git a/redis/commands/graph/commands.py b/redis/commands/graph/commands.py
index 2be46cd902..fe4224b5cf 100644
--- a/redis/commands/graph/commands.py
+++ b/redis/commands/graph/commands.py
@@ -12,7 +12,6 @@ class GraphCommands:
     def commit(self):
         """
         Create entire graph.
-        For more information see `CREATE <https://oss.redis.com/redisgraph/master/commands/#create>`_. # noqa
         """
         if len(self.nodes) == 0 and len(self.edges) == 0:
             return None
@@ -32,7 +31,7 @@ def commit(self):
     def query(self, q, params=None, timeout=None, read_only=False, profile=False):
         """
         Executes a query against the graph.
-        For more information see `GRAPH.QUERY <https://oss.redis.com/redisgraph/master/commands/#graphquery>`_. # noqa
+        For more information see `GRAPH.QUERY <https://redis.io/commands/graph.query>`_. # noqa
 
         Args:
 
@@ -95,7 +94,6 @@ def query(self, q, params=None, timeout=None, read_only=False, profile=False):
     def merge(self, pattern):
         """
         Merge pattern.
-        For more information see `MERGE <https://oss.redis.com/redisgraph/master/commands/#merge>`_. # noqa
         """
         query = "MERGE "
         query += str(pattern)
@@ -105,7 +103,7 @@ def merge(self, pattern):
     def delete(self):
         """
         Deletes graph.
-        For more information see `DELETE <https://oss.redis.com/redisgraph/master/commands/#delete>`_. # noqa
+        For more information see `DELETE <https://redis.io/commands/graph.delete>`_. # noqa
         """
         self._clear_schema()
         return self.execute_command("GRAPH.DELETE", self.name)
@@ -132,7 +130,7 @@ def profile(self, query):
         for each operation's execution. Return a string representation of a
         query execution plan, with details on results produced by and time
         spent in each operation.
-        For more information see `GRAPH.PROFILE <https://oss.redis.com/redisgraph/master/commands/#graphprofile>`_. # noqa
+        For more information see `GRAPH.PROFILE <https://redis.io/commands/graph.profile>`_. # noqa
         """
         return self.query(query, profile=True)
 
@@ -140,7 +138,7 @@ def slowlog(self):
         """
         Get a list containing up to 10 of the slowest queries issued
         against the given graph ID.
-        For more information see `GRAPH.SLOWLOG <https://oss.redis.com/redisgraph/master/commands/#graphslowlog>`_. # noqa
+        For more information see `GRAPH.SLOWLOG <https://redis.io/commands/graph.slowlog>`_. # noqa
 
         Each item in the list has the following structure:
         1. A unix timestamp at which the log entry was processed.
@@ -153,7 +151,7 @@ def slowlog(self):
     def config(self, name, value=None, set=False):
         """
         Retrieve or update a RedisGraph configuration.
-        For more information see `GRAPH.CONFIG <https://oss.redis.com/redisgraph/master/commands/#graphconfig>`_. # noqa
+        For more information see `https://redis.io/commands/graph.config-get/>`_. # noqa
 
         Args:
 
@@ -177,7 +175,7 @@ def config(self, name, value=None, set=False):
     def list_keys(self):
         """
         Lists all graph keys in the keyspace.
-        For more information see `GRAPH.LIST <https://oss.redis.com/redisgraph/master/commands/#graphlist>`_. # noqa
+        For more information see `GRAPH.LIST <https://redis.io/commands/graph.list>`_. # noqa
         """
         return self.execute_command("GRAPH.LIST")
 
@@ -202,6 +200,7 @@ def explain(self, query, params=None):
         """
         Get the execution plan for given query,
         GRAPH.EXPLAIN returns ExecutionPlan object.
+        For more information see `GRAPH.EXPLAIN <https://redis.io/commands/graph.explain>`_. # noqa
 
         Args:
             query: the query that will be executed
diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index 6588aca0f2..9391c2a2c1 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -20,7 +20,7 @@ def arrappend(
         """Append the objects ``args`` to the array under the
         ``path` in key ``name``.
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsonarrappend
+        For more information see `JSON.ARRAPPEND <https://redis.io/commands/json.arrappend>`_..
         """  # noqa
         pieces = [name, str(path)]
         for o in args:
@@ -42,7 +42,7 @@ def arrindex(
         The search can be limited using the optional inclusive ``start``
         and exclusive ``stop`` indices.
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsonarrindex
+        For more information see `JSON.ARRINDEX <https://redis.io/commands/json.arrindex>`_.
         """  # noqa
         return self.execute_command(
             "JSON.ARRINDEX", name, str(path), self._encode(scalar), start, stop
@@ -54,7 +54,7 @@ def arrinsert(
         """Insert the objects ``args`` to the array at index ``index``
         under the ``path` in key ``name``.
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsonarrinsert
+        For more information see `JSON.ARRINSERT <https://redis.io/commands/json.arrinsert>`_.
         """  # noqa
         pieces = [name, str(path), index]
         for o in args:
@@ -67,7 +67,7 @@ def arrlen(
         """Return the length of the array JSON value under ``path``
         at key``name``.
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsonarrlen
+        For more information see `JSON.ARRLEN <https://redis.io/commands/json.arrlen>`_.
         """  # noqa
         return self.execute_command("JSON.ARRLEN", name, str(path))
 
@@ -81,7 +81,7 @@ def arrpop(
         """Pop the element at ``index`` in the array JSON value under
         ``path`` at key ``name``.
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsonarrpop
+        For more information see `JSON.ARRPOP <https://redis.io/commands/json.arrpop>`_.
         """  # noqa
         return self.execute_command("JSON.ARRPOP", name, str(path), index)
 
@@ -91,21 +91,21 @@ def arrtrim(
         """Trim the array JSON value under ``path`` at key ``name`` to the
         inclusive range given by ``start`` and ``stop``.
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsonarrtrim
+        For more information see `JSON.ARRTRIM <https://redis.io/commands/json.arrtrim>`_.
         """  # noqa
         return self.execute_command("JSON.ARRTRIM", name, str(path), start, stop)
 
     def type(self, name: str, path: Optional[str] = Path.root_path()) -> List[str]:
         """Get the type of the JSON value under ``path`` from key ``name``.
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsontype
+        For more information see `JSON.TYPE <https://redis.io/commands/json.type>`_.
         """  # noqa
         return self.execute_command("JSON.TYPE", name, str(path))
 
     def resp(self, name: str, path: Optional[str] = Path.root_path()) -> List:
         """Return the JSON value under ``path`` at key ``name``.
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsonresp
+        For more information see `JSON.RESP <https://redis.io/commands/json.resp>`_.
         """  # noqa
         return self.execute_command("JSON.RESP", name, str(path))
 
@@ -115,7 +115,7 @@ def objkeys(
         """Return the key names in the dictionary JSON value under ``path`` at
         key ``name``.
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsonobjkeys
+        For more information see `JSON.OBJKEYS <https://redis.io/commands/json.objkeys>`_.
         """  # noqa
         return self.execute_command("JSON.OBJKEYS", name, str(path))
 
@@ -123,7 +123,7 @@ def objlen(self, name: str, path: Optional[str] = Path.root_path()) -> int:
         """Return the length of the dictionary JSON value under ``path`` at key
         ``name``.
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsonobjlen
+        For more information see `JSON.OBJLEN <https://redis.io/commands/json.objlen>`_.
         """  # noqa
         return self.execute_command("JSON.OBJLEN", name, str(path))
 
@@ -131,7 +131,7 @@ def numincrby(self, name: str, path: str, number: int) -> str:
         """Increment the numeric (integer or floating point) JSON value under
         ``path`` at key ``name`` by the provided ``number``.
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsonnumincrby
+        For more information see `JSON.NUMINCRBY <https://redis.io/commands/json.numincrby>`_.
         """  # noqa
         return self.execute_command(
             "JSON.NUMINCRBY", name, str(path), self._encode(number)
@@ -142,28 +142,27 @@ def nummultby(self, name: str, path: str, number: int) -> str:
         """Multiply the numeric (integer or floating point) JSON value under
         ``path`` at key ``name`` with the provided ``number``.
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsonnummultby
+        For more information see `JSON.NUMMULTBY <https://redis.io/commands/json.nummultby>`_.
         """  # noqa
         return self.execute_command(
             "JSON.NUMMULTBY", name, str(path), self._encode(number)
         )
 
     def clear(self, name: str, path: Optional[str] = Path.root_path()) -> int:
-        """
-        Empty arrays and objects (to have zero slots/keys without deleting the
+        """Empty arrays and objects (to have zero slots/keys without deleting the
         array/object).
 
         Return the count of cleared paths (ignoring non-array and non-objects
         paths).
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsonclear
+        For more information see `JSON.CLEAR <https://redis.io/commands/json.clear>`_.
         """  # noqa
         return self.execute_command("JSON.CLEAR", name, str(path))
 
     def delete(self, key: str, path: Optional[str] = Path.root_path()) -> int:
         """Delete the JSON value stored at key ``key`` under ``path``.
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsondel
+        For more information see `JSON.DEL <https://redis.io/commands/json.del>`_.
         """
         return self.execute_command("JSON.DEL", key, str(path))
 
@@ -180,7 +179,7 @@ def get(
         ```no_escape`` is a boolean flag to add no_escape option to get
         non-ascii characters
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsonget
+        For more information see `JSON.GET <https://redis.io/commands/json.get>`_.
         """  # noqa
         pieces = [name]
         if no_escape:
@@ -205,7 +204,7 @@ def mget(self, keys: List[str], path: str) -> List[JsonType]:
         Get the objects stored as a JSON values under ``path``. ``keys``
         is a list of one or more keys.
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsonmget
+        For more information see `JSON.MGET <https://redis.io/commands/json.mget>`_.
         """  # noqa
         pieces = []
         pieces += keys
@@ -230,9 +229,9 @@ def set(
         with utf-8.
 
         For the purpose of using this within a pipeline, this command is also
-        aliased to jsonset.
+        aliased to JSON.SET.
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsonset
+        For more information see `JSON.SET <https://redis.io/commands/json.set>`_.
         """
         if decode_keys:
             obj = decode_dict_keys(obj)
@@ -318,7 +317,7 @@ def strlen(self, name: str, path: Optional[str] = None) -> List[Union[int, None]
         """Return the length of the string JSON value under ``path`` at key
         ``name``.
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsonstrlen
+        For more information see `JSON.STRLEN <https://redis.io/commands/json.strlen>`_.
         """  # noqa
         pieces = [name]
         if path is not None:
@@ -331,7 +330,7 @@ def toggle(
         """Toggle boolean value under ``path`` at key ``name``.
         returning the new value.
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsontoggle
+        For more information see `JSON.TOGGLE <https://redis.io/commands/json.toggle>`_.
         """  # noqa
         return self.execute_command("JSON.TOGGLE", name, str(path))
 
@@ -342,7 +341,7 @@ def strappend(
         the key name, the path is determined to be the first. If a single
         option is passed, then the root_path (i.e Path.root_path()) is used.
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsonstrappend
+        For more information see `JSON.STRAPPEND <https://redis.io/commands/json.strappend>`_.
         """  # noqa
         pieces = [name, str(path), self._encode(value)]
         return self.execute_command("JSON.STRAPPEND", *pieces)
@@ -356,7 +355,7 @@ def debug(
         """Return the memory usage in bytes of a value under ``path`` from
         key ``name``.
 
-        For more information: https://oss.redis.com/redisjson/commands/#jsondebug
+        For more information see `JSON.DEBUG <https://redis.io/commands/json.debug>`_.
         """  # noqa
         valid_subcommands = ["MEMORY", "HELP"]
         if subcommand not in valid_subcommands:
diff --git a/redis/commands/redismodules.py b/redis/commands/redismodules.py
index c0238d3a39..875f3fca25 100644
--- a/redis/commands/redismodules.py
+++ b/redis/commands/redismodules.py
@@ -3,7 +3,7 @@
 
 class RedisModuleCommands:
     """This class contains the wrapper functions to bring supported redis
-    modules into the command namepsace.
+    modules into the command namespace.
     """
 
     def json(self, encoder=JSONEncoder(), decoder=JSONDecoder()):
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 3413fc11ec..5a9f6fec54 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -104,7 +104,7 @@ def create_index(
         in the index.
         - **skip_initial_scan**: If true, we do not scan and index.
 
-        For more information: https://oss.redis.com/redisearch/Commands/#ftcreate
+        For more information see `FT.CREATE <https://redis.io/commands/ft.create>`_.
         """  # noqa
 
         args = [CREATE_CMD, self.index_name]
@@ -147,7 +147,7 @@ def alter_schema_add(self, fields):
 
         - **fields**: a list of Field objects to add for the index
 
-        For more information: https://oss.redis.com/redisearch/Commands/#ftalter_schema_add
+        For more information see `FT.ALTER <https://redis.io/commands/ft.alter>`_.
         """  # noqa
 
         args = [ALTER_CMD, self.index_name, "SCHEMA", "ADD"]
@@ -167,7 +167,8 @@ def dropindex(self, delete_documents=False):
         ### Parameters:
 
         - **delete_documents**: If `True`, all documents will be deleted.
-        For more information: https://oss.redis.com/redisearch/Commands/#ftdropindex
+        
+        For more information see `FT.DROPINDEX <https://redis.io/commands/ft.dropindex>`_.
         """  # noqa
         keep_str = "" if delete_documents else "KEEPDOCS"
         return self.execute_command(DROP_CMD, self.index_name, keep_str)
@@ -278,8 +279,6 @@ def add_document(
         - **fields** kwargs dictionary of the document fields to be saved
                          and/or indexed.
                      NOTE: Geo points shoule be encoded as strings of "lon,lat"
-
-        For more information: https://oss.redis.com/redisearch/Commands/#ftadd
         """  # noqa
         return self._add_document(
             doc_id,
@@ -312,8 +311,6 @@ def add_document_hash(
         - **replace**: if True, and the document already is in the index, we
                       perform an update and reindex the document
         - **language**: Specify the language used for document tokenization.
-
-        For more information: https://oss.redis.com/redisearch/Commands/#ftaddhash
         """  # noqa
         return self._add_document_hash(
             doc_id,
@@ -332,8 +329,6 @@ def delete_document(self, doc_id, conn=None, delete_actual_document=False):
 
         - **delete_actual_document**: if set to True, RediSearch also delete
                                       the actual document if it is in the index
-
-        For more information: https://oss.redis.com/redisearch/Commands/#ftdel
         """  # noqa
         args = [DEL_CMD, self.index_name, doc_id]
         if delete_actual_document:
@@ -367,7 +362,6 @@ def get(self, *ids):
 
         - **ids**: the ids of the saved documents.
 
-        For more information https://oss.redis.com/redisearch/Commands/#ftget
         """
 
         return self.execute_command(MGET_CMD, self.index_name, *ids)
@@ -377,7 +371,7 @@ def info(self):
         Get info an stats about the the current index, including the number of
         documents, memory consumption, etc
 
-        For more information https://oss.redis.com/redisearch/Commands/#ftinfo
+        For more information see `FT.INFO <https://redis.io/commands/ft.info>`_.
         """
 
         res = self.execute_command(INFO_CMD, self.index_name)
@@ -423,7 +417,7 @@ def search(
                      default parameters, or a Query object for complex queries.
                      See RediSearch's documentation on query format
 
-        For more information: https://oss.redis.com/redisearch/Commands/#ftsearch
+        For more information see `FT.SEARCH <https://redis.io/commands/ft.search>`_.
         """  # noqa
         args, query = self._mk_query_args(query, query_params=query_params)
         st = time.time()
@@ -447,7 +441,7 @@ def explain(
     ):
         """Returns the execution plan for a complex query.
 
-        For more information: https://oss.redis.com/redisearch/Commands/#ftexplain
+        For more information see `FT.EXPLAIN <https://redis.io/commands/ft.explain>`_.
         """  # noqa
         args, query_text = self._mk_query_args(query, query_params=query_params)
         return self.execute_command(EXPLAIN_CMD, *args)
@@ -470,7 +464,7 @@ def aggregate(
         An `AggregateResult` object is returned. You can access the rows from
         its `rows` property, which will always yield the rows of the result.
 
-        For more information: https://oss.redis.com/redisearch/Commands/#ftaggregate
+        For more information see `FT.AGGREGATE <https://redis.io/commands/ft.aggregate>`_.
         """  # noqa
         if isinstance(query, AggregateRequest):
             has_cursor = bool(query._cursor)
@@ -560,7 +554,7 @@ def spellcheck(self, query, distance=None, include=None, exclude=None):
         **include**: specifies an inclusion custom dictionary.
         **exclude**: specifies an exclusion custom dictionary.
 
-        For more information: https://oss.redis.com/redisearch/Commands/#ftspellcheck
+        For more information see `FT.SPELLCHECK <https://redis.io/commands/ft.spellcheck>`_.
         """  # noqa
         cmd = [SPELLCHECK_CMD, self.index_name, query]
         if distance:
@@ -618,7 +612,7 @@ def dict_add(self, name, *terms):
         - **name**: Dictionary name.
         - **terms**: List of items for adding to the dictionary.
 
-        For more information: https://oss.redis.com/redisearch/Commands/#ftdictadd
+        For more information see `FT.DICTADD <https://redis.io/commands/ft.dictadd>`_.
         """  # noqa
         cmd = [DICT_ADD_CMD, name]
         cmd.extend(terms)
@@ -632,7 +626,7 @@ def dict_del(self, name, *terms):
         - **name**: Dictionary name.
         - **terms**: List of items for removing from the dictionary.
 
-        For more information: https://oss.redis.com/redisearch/Commands/#ftdictdel
+        For more information see `FT.DICTDEL <https://redis.io/commands/ft.dictdel>`_.
         """  # noqa
         cmd = [DICT_DEL_CMD, name]
         cmd.extend(terms)
@@ -645,7 +639,7 @@ def dict_dump(self, name):
 
         - **name**: Dictionary name.
 
-        For more information: https://oss.redis.com/redisearch/Commands/#ftdictdump
+        For more information see `FT.DICTDUMP <https://redis.io/commands/ft.dictdump>`_.
         """  # noqa
         cmd = [DICT_DUMP_CMD, name]
         return self.execute_command(*cmd)
@@ -658,7 +652,7 @@ def config_set(self, option, value):
         - **option**: the name of the configuration option.
         - **value**: a value for the configuration option.
 
-        For more information: https://oss.redis.com/redisearch/Commands/#ftconfig
+        For more information see `FT.CONFIG SET <https://redis.io/commands/ft.config-set>`_.
         """  # noqa
         cmd = [CONFIG_CMD, "SET", option, value]
         raw = self.execute_command(*cmd)
@@ -671,7 +665,7 @@ def config_get(self, option):
 
         - **option**: the name of the configuration option.
 
-        For more information: https://oss.redis.com/redisearch/Commands/#ftconfig
+        For more information see `FT.CONFIG GET <https://redis.io/commands/ft.config-get>`_.
         """  # noqa
         cmd = [CONFIG_CMD, "GET", option]
         res = {}
@@ -689,7 +683,7 @@ def tagvals(self, tagfield):
 
         - **tagfield**: Tag field name
 
-        For more information: https://oss.redis.com/redisearch/Commands/#fttagvals
+        For more information see `FT.TAGVALS <https://redis.io/commands/ft.tagvals>`_.
         """  # noqa
 
         return self.execute_command(TAGVALS_CMD, self.index_name, tagfield)
@@ -702,7 +696,7 @@ def aliasadd(self, alias):
 
         - **alias**: Name of the alias to create
 
-        For more information: https://oss.redis.com/redisearch/Commands/#ftaliasadd
+        For more information see `FT.ALIASADD <https://redis.io/commands/ft.aliasadd>`_.
         """  # noqa
 
         return self.execute_command(ALIAS_ADD_CMD, alias, self.index_name)
@@ -715,7 +709,7 @@ def aliasupdate(self, alias):
 
         - **alias**: Name of the alias to create
 
-        For more information: https://oss.redis.com/redisearch/Commands/#ftaliasupdate
+        For more information see `FT.ALIASUPDATE <https://redis.io/commands/ft.aliasupdate>`_.
         """  # noqa
 
         return self.execute_command(ALIAS_UPDATE_CMD, alias, self.index_name)
@@ -728,7 +722,7 @@ def aliasdel(self, alias):
 
         - **alias**: Name of the alias to delete
 
-        For more information: https://oss.redis.com/redisearch/Commands/#ftaliasdel
+        For more information see `FT.ALIASDEL <https://redis.io/commands/ft.aliasdel>`_.
         """  # noqa
         return self.execute_command(ALIAS_DEL_CMD, alias)
 
@@ -739,7 +733,7 @@ def sugadd(self, key, *suggestions, **kwargs):
         If kwargs["increment"] is true and the terms are already in the
         server's dictionary, we increment their scores.
 
-        For more information: https://oss.redis.com/redisearch/master/Commands/#ftsugadd
+        For more information see `FT.SUGADD <https://redis.io/commands/ft.sugadd/>`_.
         """  # noqa
         # If Transaction is not False it will MULTI/EXEC which will error
         pipe = self.pipeline(transaction=False)
@@ -759,7 +753,7 @@ def suglen(self, key):
         """
         Return the number of entries in the AutoCompleter index.
 
-        For more information https://oss.redis.com/redisearch/master/Commands/#ftsuglen
+        For more information see `FT.SUGLEN <https://redis.io/commands/ft.suglen>`_.
         """  # noqa
         return self.execute_command(SUGLEN_COMMAND, key)
 
@@ -768,7 +762,7 @@ def sugdel(self, key, string):
         Delete a string from the AutoCompleter index.
         Returns 1 if the string was found and deleted, 0 otherwise.
 
-        For more information: https://oss.redis.com/redisearch/master/Commands/#ftsugdel
+        For more information see `FT.SUGDEL <https://redis.io/commands/ft.sugdel>`_.
         """  # noqa
         return self.execute_command(SUGDEL_COMMAND, key, string)
 
@@ -804,7 +798,7 @@ def sugget(
              A list of Suggestion objects. If with_scores was False, the
              score of all suggestions is 1.
 
-        For more information: https://oss.redis.com/redisearch/master/Commands/#ftsugget
+        For more information see `FT.SUGGET <https://redis.io/commands/ft.sugget>`_.
         """  # noqa
         args = [SUGGET_COMMAND, key, prefix, "MAX", num]
         if fuzzy:
@@ -838,7 +832,7 @@ def synupdate(self, groupid, skipinitial=False, *terms):
         terms :
             The terms.
 
-        For more information: https://oss.redis.com/redisearch/Commands/#ftsynupdate
+        For more information see `FT.SYNUPDATE <https://redis.io/commands/ft.synupdate>`_.
         """  # noqa
         cmd = [SYNUPDATE_CMD, self.index_name, groupid]
         if skipinitial:
@@ -853,7 +847,7 @@ def syndump(self):
         The command is used to dump the synonyms data structure.
         Returns a list of synonym terms and their synonym group ids.
 
-        For more information: https://oss.redis.com/redisearch/Commands/#ftsyndump
+        For more information see `FT.SYNDUMP <https://redis.io/commands/ft.syndump>`_.
         """  # noqa
         raw = self.execute_command(SYNDUMP_CMD, self.index_name)
         return {raw[i]: raw[i + 1] for i in range(0, len(raw), 2)}
@@ -865,7 +859,7 @@ async def info(self):
         Get info an stats about the the current index, including the number of
         documents, memory consumption, etc
 
-        For more information https://oss.redis.com/redisearch/Commands/#ftinfo
+        For more information see `FT.INFO <https://redis.io/commands/ft.info>`_.
         """
 
         res = await self.execute_command(INFO_CMD, self.index_name)
@@ -886,7 +880,7 @@ async def search(
                      default parameters, or a Query object for complex queries.
                      See RediSearch's documentation on query format
 
-        For more information: https://oss.redis.com/redisearch/Commands/#ftsearch
+        For more information see `FT.SEARCH <https://redis.io/commands/ft.search>`_.
         """  # noqa
         args, query = self._mk_query_args(query, query_params=query_params)
         st = time.time()
@@ -918,7 +912,7 @@ async def aggregate(
         An `AggregateResult` object is returned. You can access the rows from
         its `rows` property, which will always yield the rows of the result.
 
-        For more information: https://oss.redis.com/redisearch/Commands/#ftaggregate
+        For more information see `FT.AGGREGATE <https://redis.io/commands/ft.aggregate>`_.
         """  # noqa
         if isinstance(query, AggregateRequest):
             has_cursor = bool(query._cursor)
@@ -946,7 +940,7 @@ async def spellcheck(self, query, distance=None, include=None, exclude=None):
         **include**: specifies an inclusion custom dictionary.
         **exclude**: specifies an exclusion custom dictionary.
 
-        For more information: https://oss.redis.com/redisearch/Commands/#ftspellcheck
+        For more information see `FT.SPELLCHECK <https://redis.io/commands/ft.spellcheck>`_.
         """  # noqa
         cmd = [SPELLCHECK_CMD, self.index_name, query]
         if distance:
@@ -989,7 +983,7 @@ async def config_set(self, option, value):
         - **option**: the name of the configuration option.
         - **value**: a value for the configuration option.
 
-        For more information: https://oss.redis.com/redisearch/Commands/#ftconfig
+        For more information see `FT.CONFIG SET <https://redis.io/commands/ft.config-set>`_.
         """  # noqa
         cmd = [CONFIG_CMD, "SET", option, value]
         raw = await self.execute_command(*cmd)
@@ -1002,7 +996,7 @@ async def config_get(self, option):
 
         - **option**: the name of the configuration option.
 
-        For more information: https://oss.redis.com/redisearch/Commands/#ftconfig
+        For more information see `FT.CONFIG GET <https://redis.io/commands/ft.config-get>`_.
         """  # noqa
         cmd = [CONFIG_CMD, "GET", option]
         res = {}
@@ -1034,7 +1028,7 @@ async def sugadd(self, key, *suggestions, **kwargs):
         If kwargs["increment"] is true and the terms are already in the
         server's dictionary, we increment their scores.
 
-        For more information: https://oss.redis.com/redisearch/master/Commands/#ftsugadd
+        For more information see `FT.SUGADD <https://redis.io/commands/ft.sugadd>`_.
         """  # noqa
         # If Transaction is not False it will MULTI/EXEC which will error
         pipe = self.pipeline(transaction=False)
@@ -1082,7 +1076,7 @@ async def sugget(
              A list of Suggestion objects. If with_scores was False, the
              score of all suggestions is 1.
 
-        For more information: https://oss.redis.com/redisearch/master/Commands/#ftsugget
+        For more information see `FT.SUGGET <https://redis.io/commands/ft.sugget>`_.
         """  # noqa
         args = [SUGGET_COMMAND, key, prefix, "MAX", num]
         if fuzzy:

From 8a1feb397bce1d76593496fd57bf6d157d1ccbe9 Mon Sep 17 00:00:00 2001
From: Greg Melton <gmelton@gmail.com>
Date: Mon, 23 May 2022 01:51:53 -0700
Subject: [PATCH 0495/1164] Fix Linting and Test Failures (#2191)

* force triggering pr pipeline

* fix lint error

* https://github.com/RedisJSON/RedisJSON/pull/721 no longer clears strings or boolean scalars
---
 redis/commands/search/commands.py | 2 +-
 tests/test_asyncio/test_json.py   | 5 +++--
 tests/test_json.py                | 5 ++---
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 5a9f6fec54..10b57624cd 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -167,7 +167,7 @@ def dropindex(self, delete_documents=False):
         ### Parameters:
 
         - **delete_documents**: If `True`, all documents will be deleted.
-        
+
         For more information see `FT.DROPINDEX <https://redis.io/commands/ft.dropindex>`_.
         """  # noqa
         keep_str = "" if delete_documents else "KEEPDOCS"
diff --git a/tests/test_asyncio/test_json.py b/tests/test_asyncio/test_json.py
index 6bd95810f6..c203c6d15e 100644
--- a/tests/test_asyncio/test_json.py
+++ b/tests/test_asyncio/test_json.py
@@ -899,11 +899,12 @@ async def test_clear_dollar(modclient: redis.Redis):
             "nested3": {"a": {"baz": 50}},
         },
     )
+
     # Test multi
-    assert await modclient.json().clear("doc1", "$..a") == 4
+    assert await modclient.json().clear("doc1", "$..a") == 3
 
     assert await modclient.json().get("doc1", "$") == [
-        {"nested1": {"a": {}}, "a": [], "nested2": {"a": ""}, "nested3": {"a": {}}}
+        {"nested1": {"a": {}}, "a": [], "nested2": {"a": "claro"}, "nested3": {"a": {}}}
     ]
 
     # Test single
diff --git a/tests/test_json.py b/tests/test_json.py
index 3d9b67841f..2b754564bc 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -893,7 +893,6 @@ def test_type_dollar(client):
 
 @pytest.mark.redismod
 def test_clear_dollar(client):
-
     client.json().set(
         "doc1",
         "$",
@@ -905,10 +904,10 @@ def test_clear_dollar(client):
         },
     )
     # Test multi
-    assert client.json().clear("doc1", "$..a") == 4
+    assert client.json().clear("doc1", "$..a") == 3
 
     assert client.json().get("doc1", "$") == [
-        {"nested1": {"a": {}}, "a": [], "nested2": {"a": ""}, "nested3": {"a": {}}}
+        {"nested1": {"a": {}}, "a": [], "nested2": {"a": "claro"}, "nested3": {"a": {}}}
     ]
 
     # Test single

From 9167a0e10d5acd9d76edd887300c75cfeb07a7c3 Mon Sep 17 00:00:00 2001
From: Avital Fine <98389525+Avital-Fine@users.noreply.github.com>
Date: Mon, 23 May 2022 19:25:34 +0300
Subject: [PATCH 0496/1164] Support CF.MEXISTS + Clean bf/commands.py (#2184)

* Support CF.MEXISTS

* Clean bf/commands.py

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/commands/bf/commands.py | 101 ++++++++++++++--------------------
 tests/test_bloom.py           |   1 +
 2 files changed, 41 insertions(+), 61 deletions(-)

diff --git a/redis/commands/bf/commands.py b/redis/commands/bf/commands.py
index 21c7857abe..baf01305d7 100644
--- a/redis/commands/bf/commands.py
+++ b/redis/commands/bf/commands.py
@@ -18,6 +18,7 @@
 CF_INSERT = "CF.INSERT"
 CF_INSERTNX = "CF.INSERTNX"
 CF_EXISTS = "CF.EXISTS"
+CF_MEXISTS = "CF.MEXISTS"
 CF_DEL = "CF.DEL"
 CF_COUNT = "CF.COUNT"
 CF_SCANDUMP = "CF.SCANDUMP"
@@ -59,7 +60,7 @@ def create(self, key, errorRate, capacity, expansion=None, noScale=None):
         Create a new Bloom Filter `key` with desired probability of false positives
         `errorRate` expected entries to be inserted as `capacity`.
         Default expansion value is 2. By default, filter is auto-scaling.
-        For more information see `BF.RESERVE <https://oss.redis.com/redisbloom/master/Bloom_Commands/#bfreserve>`_.
+        For more information see `BF.RESERVE <https://redis.io/commands/bf.reserve>`_.
         """  # noqa
         params = [key, errorRate, capacity]
         self.append_expansion(params, expansion)
@@ -69,19 +70,16 @@ def create(self, key, errorRate, capacity, expansion=None, noScale=None):
     def add(self, key, item):
         """
         Add to a Bloom Filter `key` an `item`.
-        For more information see `BF.ADD <https://oss.redis.com/redisbloom/master/Bloom_Commands/#bfadd>`_.
+        For more information see `BF.ADD <https://redis.io/commands/bf.add>`_.
         """  # noqa
-        params = [key, item]
-        return self.execute_command(BF_ADD, *params)
+        return self.execute_command(BF_ADD, key, item)
 
     def madd(self, key, *items):
         """
         Add to a Bloom Filter `key` multiple `items`.
-        For more information see `BF.MADD <https://oss.redis.com/redisbloom/master/Bloom_Commands/#bfmadd>`_.
+        For more information see `BF.MADD <https://redis.io/commands/bf.madd>`_.
         """  # noqa
-        params = [key]
-        params += items
-        return self.execute_command(BF_MADD, *params)
+        return self.execute_command(BF_MADD, key, *items)
 
     def insert(
         self,
@@ -99,7 +97,7 @@ def insert(
         If `nocreate` remain `None` and `key` does not exist, a new Bloom Filter
         `key` will be created with desired probability of false positives `errorRate`
         and expected entries to be inserted as `size`.
-        For more information see `BF.INSERT <https://oss.redis.com/redisbloom/master/Bloom_Commands/#bfinsert>`_.
+        For more information see `BF.INSERT <https://redis.io/commands/bf.insert>`_.
         """  # noqa
         params = [key]
         self.append_capacity(params, capacity)
@@ -114,19 +112,16 @@ def insert(
     def exists(self, key, item):
         """
         Check whether an `item` exists in Bloom Filter `key`.
-        For more information see `BF.EXISTS <https://oss.redis.com/redisbloom/master/Bloom_Commands/#bfexists>`_.
+        For more information see `BF.EXISTS <https://redis.io/commands/bf.exists>`_.
         """  # noqa
-        params = [key, item]
-        return self.execute_command(BF_EXISTS, *params)
+        return self.execute_command(BF_EXISTS, key, item)
 
     def mexists(self, key, *items):
         """
         Check whether `items` exist in Bloom Filter `key`.
-        For more information see `BF.MEXISTS <https://oss.redis.com/redisbloom/master/Bloom_Commands/#bfmexists>`_.
+        For more information see `BF.MEXISTS <https://redis.io/commands/bf.mexists>`_.
         """  # noqa
-        params = [key]
-        params += items
-        return self.execute_command(BF_MEXISTS, *params)
+        return self.execute_command(BF_MEXISTS, key, *items)
 
     def scandump(self, key, iter):
         """
@@ -135,7 +130,7 @@ def scandump(self, key, iter):
         This is useful for large bloom filters which cannot fit into the normal SAVE and RESTORE model.
         The first time this command is called, the value of `iter` should be 0.
         This command will return successive (iter, data) pairs until (0, NULL) to indicate completion.
-        For more information see `BF.SCANDUMP <https://oss.redis.com/redisbloom/master/Bloom_Commands/#bfscandump>`_.
+        For more information see `BF.SCANDUMP <https://redis.io/commands/bf.scandump>`_.
         """  # noqa
         if HIREDIS_AVAILABLE:
             raise ModuleError("This command cannot be used when hiredis is available.")
@@ -152,15 +147,14 @@ def loadchunk(self, key, iter, data):
         See the SCANDUMP command for example usage.
         This command will overwrite any bloom filter stored under key.
         Ensure that the bloom filter will not be modified between invocations.
-        For more information see `BF.LOADCHUNK <https://oss.redis.com/redisbloom/master/Bloom_Commands/#bfloadchunk>`_.
+        For more information see `BF.LOADCHUNK <https://redis.io/commands/bf.loadchunk>`_.
         """  # noqa
-        params = [key, iter, data]
-        return self.execute_command(BF_LOADCHUNK, *params)
+        return self.execute_command(BF_LOADCHUNK, key, iter, data)
 
     def info(self, key):
         """
         Return capacity, size, number of filters, number of items inserted, and expansion rate.
-        For more information see `BF.INFO <https://oss.redis.com/redisbloom/master/Bloom_Commands/#bfinfo>`_.
+        For more information see `BF.INFO <https://redis.io/commands/bf.info>`_.
         """  # noqa
         return self.execute_command(BF_INFO, key)
 
@@ -187,8 +181,7 @@ def add(self, key, item):
         Add an `item` to a Cuckoo Filter `key`.
         For more information see `CF.ADD <https://redis.io/commands/cf.add>`_.
         """  # noqa
-        params = [key, item]
-        return self.execute_command(CF_ADD, *params)
+        return self.execute_command(CF_ADD, key, item)
 
     def addnx(self, key, item):
         """
@@ -196,8 +189,7 @@ def addnx(self, key, item):
         Command might be slower that `add`.
         For more information see `CF.ADDNX <https://redis.io/commands/cf.addnx>`_.
         """  # noqa
-        params = [key, item]
-        return self.execute_command(CF_ADDNX, *params)
+        return self.execute_command(CF_ADDNX, key, item)
 
     def insert(self, key, items, capacity=None, nocreate=None):
         """
@@ -230,24 +222,28 @@ def exists(self, key, item):
         Check whether an `item` exists in Cuckoo Filter `key`.
         For more information see `CF.EXISTS <https://redis.io/commands/cf.exists>`_.
         """  # noqa
-        params = [key, item]
-        return self.execute_command(CF_EXISTS, *params)
+        return self.execute_command(CF_EXISTS, key, item)
+
+    def mexists(self, key, *items):
+        """
+        Check whether an `items` exist in Cuckoo Filter `key`.
+        For more information see `CF.MEXISTS <https://redis.io/commands/cf.mexists>`_.
+        """  # noqa
+        return self.execute_command(CF_MEXISTS, key, *items)
 
     def delete(self, key, item):
         """
         Delete `item` from `key`.
         For more information see `CF.DEL <https://redis.io/commands/cf.del>`_.
         """  # noqa
-        params = [key, item]
-        return self.execute_command(CF_DEL, *params)
+        return self.execute_command(CF_DEL, key, item)
 
     def count(self, key, item):
         """
         Return the number of times an `item` may be in the `key`.
         For more information see `CF.COUNT <https://redis.io/commands/cf.count>`_.
         """  # noqa
-        params = [key, item]
-        return self.execute_command(CF_COUNT, *params)
+        return self.execute_command(CF_COUNT, key, item)
 
     def scandump(self, key, iter):
         """
@@ -260,8 +256,7 @@ def scandump(self, key, iter):
         (0, NULL) to indicate completion.
         For more information see `CF.SCANDUMP <https://redis.io/commands/cf.scandump>`_.
         """  # noqa
-        params = [key, iter]
-        return self.execute_command(CF_SCANDUMP, *params)
+        return self.execute_command(CF_SCANDUMP, key, iter)
 
     def loadchunk(self, key, iter, data):
         """
@@ -271,8 +266,7 @@ def loadchunk(self, key, iter, data):
         Ensure that the Cuckoo filter will not be modified between invocations.
         For more information see `CF.LOADCHUNK <https://redis.io/commands/cf.loadchunk>`_.
         """  # noqa
-        params = [key, iter, data]
-        return self.execute_command(CF_LOADCHUNK, *params)
+        return self.execute_command(CF_LOADCHUNK, key, iter, data)
 
     def info(self, key):
         """
@@ -292,17 +286,14 @@ def reserve(self, key, k, width, depth, decay):
         positives `errorRate` expected entries to be inserted as `size`.
         For more information see `TOPK.RESERVE <https://redis.io/commands/topk.reserve>`_.
         """  # noqa
-        params = [key, k, width, depth, decay]
-        return self.execute_command(TOPK_RESERVE, *params)
+        return self.execute_command(TOPK_RESERVE, key, k, width, depth, decay)
 
     def add(self, key, *items):
         """
         Add one `item` or more to a Top-K Filter `key`.
         For more information see `TOPK.ADD <https://redis.io/commands/topk.add>`_.
         """  # noqa
-        params = [key]
-        params += items
-        return self.execute_command(TOPK_ADD, *params)
+        return self.execute_command(TOPK_ADD, key, *items)
 
     def incrby(self, key, items, increments):
         """
@@ -323,18 +314,14 @@ def query(self, key, *items):
         Check whether one `item` or more is a Top-K item at `key`.
         For more information see `TOPK.QUERY <https://redis.io/commands/topk.query>`_.
         """  # noqa
-        params = [key]
-        params += items
-        return self.execute_command(TOPK_QUERY, *params)
+        return self.execute_command(TOPK_QUERY, key, *items)
 
     def count(self, key, *items):
         """
         Return count for one `item` or more from `key`.
         For more information see `TOPK.COUNT <https://redis.io/commands/topk.count>`_.
         """  # noqa
-        params = [key]
-        params += items
-        return self.execute_command(TOPK_COUNT, *params)
+        return self.execute_command(TOPK_COUNT, key, *items)
 
     def list(self, key, withcount=False):
         """
@@ -362,8 +349,7 @@ def create(self, key, compression):
         Allocate the memory and initialize the t-digest.
         For more information see `TDIGEST.CREATE <https://redis.io/commands/tdigest.create>`_.
         """  # noqa
-        params = [key, compression]
-        return self.execute_command(TDIGEST_CREATE, *params)
+        return self.execute_command(TDIGEST_CREATE, key, compression)
 
     def reset(self, key):
         """
@@ -391,8 +377,7 @@ def merge(self, toKey, fromKey):
         Merge all of the values from 'fromKey' to 'toKey' sketch.
         For more information see `TDIGEST.MERGE <https://redis.io/commands/tdigest.merge>`_.
         """  # noqa
-        params = [toKey, fromKey]
-        return self.execute_command(TDIGEST_MERGE, *params)
+        return self.execute_command(TDIGEST_MERGE, toKey, fromKey)
 
     def min(self, key):
         """
@@ -414,16 +399,14 @@ def quantile(self, key, quantile):
         added to this TDigest would be less than or equal to the cutoff.
         For more information see `TDIGEST.QUANTILE <https://redis.io/commands/tdigest.quantile>`_.
         """  # noqa
-        params = [key, quantile]
-        return self.execute_command(TDIGEST_QUANTILE, *params)
+        return self.execute_command(TDIGEST_QUANTILE, key, quantile)
 
     def cdf(self, key, value):
         """
         Return double fraction of all points added which are <= value.
         For more information see `TDIGEST.CDF <https://redis.io/commands/tdigest.cdf>`_.
         """  # noqa
-        params = [key, value]
-        return self.execute_command(TDIGEST_CDF, *params)
+        return self.execute_command(TDIGEST_CDF, key, value)
 
     def info(self, key):
         """
@@ -443,16 +426,14 @@ def initbydim(self, key, width, depth):
         Initialize a Count-Min Sketch `key` to dimensions (`width`, `depth`) specified by user.
         For more information see `CMS.INITBYDIM <https://redis.io/commands/cms.initbydim>`_.
         """  # noqa
-        params = [key, width, depth]
-        return self.execute_command(CMS_INITBYDIM, *params)
+        return self.execute_command(CMS_INITBYDIM, key, width, depth)
 
     def initbyprob(self, key, error, probability):
         """
         Initialize a Count-Min Sketch `key` to characteristics (`error`, `probability`) specified by user.
         For more information see `CMS.INITBYPROB <https://redis.io/commands/cms.initbyprob>`_.
         """  # noqa
-        params = [key, error, probability]
-        return self.execute_command(CMS_INITBYPROB, *params)
+        return self.execute_command(CMS_INITBYPROB, key, error, probability)
 
     def incrby(self, key, items, increments):
         """
@@ -473,9 +454,7 @@ def query(self, key, *items):
         Return count for an `item` from `key`. Multiple items can be queried with one call.
         For more information see `CMS.QUERY <https://redis.io/commands/cms.query>`_.
         """  # noqa
-        params = [key]
-        params += items
-        return self.execute_command(CMS_QUERY, *params)
+        return self.execute_command(CMS_QUERY, key, *items)
 
     def merge(self, destKey, numKeys, srcKeys, weights=[]):
         """
diff --git a/tests/test_bloom.py b/tests/test_bloom.py
index 4c6779bbd0..1f8201c565 100644
--- a/tests/test_bloom.py
+++ b/tests/test_bloom.py
@@ -173,6 +173,7 @@ def test_cf_exists_and_del(client):
     assert client.cf().add("cuckoo", "filter")
     assert client.cf().exists("cuckoo", "filter")
     assert not client.cf().exists("cuckoo", "notexist")
+    assert [1, 0] == client.cf().mexists("cuckoo", "filter", "notexist")
     assert 1 == client.cf().count("cuckoo", "filter")
     assert 0 == client.cf().count("cuckoo", "notexist")
     assert client.cf().delete("cuckoo", "filter")

From 0d3da4e1bb3660285694b27c19c8d2498f0d42e7 Mon Sep 17 00:00:00 2001
From: rapidia <rapidia@users.noreply.github.com>
Date: Mon, 30 May 2022 19:19:19 +0900
Subject: [PATCH 0497/1164] set default response_callbacks to
 redis.asyncio.cluster.ClusterNode (#2201)

* set default response_callbacks to redis.asyncio.cluster.ClusterNode

* add test case for ClusterNode class

* fix lint error

* merge test case into `test_startup_nodes`
---
 redis/asyncio/cluster.py           | 2 +-
 tests/test_asyncio/test_cluster.py | 5 +++++
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 10a5675e82..fa918721dc 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -725,7 +725,7 @@ def __init__(
         server_type: Optional[str] = None,
         max_connections: int = 2 ** 31,
         connection_class: Type[Connection] = Connection,
-        response_callbacks: Dict = None,
+        response_callbacks: Dict = RedisCluster.RESPONSE_CALLBACKS,
         **connection_kwargs,
     ) -> None:
         if host == "localhost":
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 6543e2849c..6c28ce35a2 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -244,6 +244,11 @@ async def test_startup_nodes(self) -> None:
 
         await cluster.close()
 
+        startup_nodes = [ClusterNode("127.0.0.1", 16379)]
+        async with RedisCluster(startup_nodes=startup_nodes) as rc:
+            assert await rc.set("A", 1)
+            assert await rc.get("A") == b"1"
+
     async def test_empty_startup_nodes(self) -> None:
         """
         Test that exception is raised when empty providing empty startup_nodes

From 84418d62db0aef3178d5eecec47d5121ce82a1d4 Mon Sep 17 00:00:00 2001
From: Oleg A <t0rr@mail.ru>
Date: Mon, 30 May 2022 13:28:03 +0300
Subject: [PATCH 0498/1164] fix: changed list type to single element type
 (#2203)

---
 redis/commands/core.py | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 3569d20e0a..ad7d7a6a94 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -2593,7 +2593,7 @@ def lpop(self, name: str, count: Optional[int] = None) -> Union[str, List, None]
         else:
             return self.execute_command("LPOP", name)
 
-    def lpush(self, name: str, *values: List) -> Union[Awaitable[int], int]:
+    def lpush(self, name: str, *values: FieldT) -> Union[Awaitable[int], int]:
         """
         Push ``values`` onto the head of the list ``name``
 
@@ -2601,7 +2601,7 @@ def lpush(self, name: str, *values: List) -> Union[Awaitable[int], int]:
         """
         return self.execute_command("LPUSH", name, *values)
 
-    def lpushx(self, name: str, *values: List) -> Union[Awaitable[int], int]:
+    def lpushx(self, name: str, *values: FieldT) -> Union[Awaitable[int], int]:
         """
         Push ``value`` onto the head of the list ``name`` if ``name`` exists
 
@@ -2679,7 +2679,7 @@ def rpoplpush(self, src: str, dst: str) -> Union[Awaitable[str], str]:
         """
         return self.execute_command("RPOPLPUSH", src, dst)
 
-    def rpush(self, name: str, *values: List) -> Union[Awaitable[int], int]:
+    def rpush(self, name: str, *values: FieldT) -> Union[Awaitable[int], int]:
         """
         Push ``values`` onto the tail of the list ``name``
 
@@ -3169,7 +3169,7 @@ class SetCommands(CommandsProtocol):
     see: https://redis.io/topics/data-types#sets
     """
 
-    def sadd(self, name: str, *values: List) -> Union[Awaitable[int], int]:
+    def sadd(self, name: str, *values: FieldT) -> Union[Awaitable[int], int]:
         """
         Add ``value(s)`` to set ``name``
 
@@ -3307,7 +3307,7 @@ def srandmember(
         args = (number is not None) and [number] or []
         return self.execute_command("SRANDMEMBER", name, *args)
 
-    def srem(self, name: str, *values: List) -> Union[Awaitable[int], int]:
+    def srem(self, name: str, *values: FieldT) -> Union[Awaitable[int], int]:
         """
         Remove ``values`` from set ``name``
 
@@ -4586,7 +4586,7 @@ def zrank(self, name: KeyT, value: EncodableT) -> ResponseT:
         """
         return self.execute_command("ZRANK", name, value)
 
-    def zrem(self, name: KeyT, *values: EncodableT) -> ResponseT:
+    def zrem(self, name: KeyT, *values: FieldT) -> ResponseT:
         """
         Remove member ``values`` from sorted set ``name``
 
@@ -4735,7 +4735,7 @@ class HyperlogCommands(CommandsProtocol):
     see: https://redis.io/topics/data-types-intro#hyperloglogs
     """
 
-    def pfadd(self, name: KeyT, *values: EncodableT) -> ResponseT:
+    def pfadd(self, name: KeyT, *values: FieldT) -> ResponseT:
         """
         Adds the specified elements to the specified HyperLogLog.
 

From 48079083a7f6ac1bdd948c03175f9ffd42aa1f6b Mon Sep 17 00:00:00 2001
From: Greg Melton <gmelton@gmail.com>
Date: Mon, 30 May 2022 05:45:42 -0700
Subject: [PATCH 0499/1164] Fix Missing ClusterPipeline Lock (#2190)

* ClusterPipeline needs to initialize self._lock, otherwise a class instance will fail when calling get_redis_connection on the node

* fix bad lint picked up from master

* added change to CHANGES file

* force ci build again

* force ci build again
---
 CHANGES                               | 1 +
 redis/cluster.py                      | 5 +++++
 redis/commands/json/__init__.py       | 1 +
 redis/commands/timeseries/__init__.py | 1 +
 4 files changed, 8 insertions(+)

diff --git a/CHANGES b/CHANGES
index f954a07777..b7e238ebb3 100644
--- a/CHANGES
+++ b/CHANGES
@@ -9,6 +9,7 @@
     * Remove verbose logging when initializing ClusterPubSub, ClusterPipeline or RedisCluster
     * Fix broken connection writer lock-up for asyncio (#2065)
     * Fix auth bug when provided with no username (#2086)
+    * Fix missing ClusterPipeline._lock (#2189)
 
 * 4.1.3 (Feb 8, 2022)
     * Fix flushdb and flushall (#1926)
diff --git a/redis/cluster.py b/redis/cluster.py
index fa1322f103..0b9c543afb 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -754,6 +754,7 @@ def pipeline(self, transaction=None, shard_hint=None):
             cluster_error_retry_attempts=self.cluster_error_retry_attempts,
             read_from_replicas=self.read_from_replicas,
             reinitialize_steps=self.reinitialize_steps,
+            lock=self._lock,
         )
 
     def lock(
@@ -1754,6 +1755,7 @@ def __init__(
         read_from_replicas=False,
         cluster_error_retry_attempts=5,
         reinitialize_steps=10,
+        lock=None,
         **kwargs,
     ):
         """ """
@@ -1776,6 +1778,9 @@ def __init__(
             kwargs.get("encoding_errors", "strict"),
             kwargs.get("decode_responses", False),
         )
+        if lock is None:
+            lock = threading.Lock()
+        self._lock = lock
 
     def __repr__(self):
         """ """
diff --git a/redis/commands/json/__init__.py b/redis/commands/json/__init__.py
index 638e4eb166..39983be9cb 100644
--- a/redis/commands/json/__init__.py
+++ b/redis/commands/json/__init__.py
@@ -113,6 +113,7 @@ def pipeline(self, transaction=True, shard_hint=None):
                 cluster_error_retry_attempts=self.client.cluster_error_retry_attempts,
                 read_from_replicas=self.client.read_from_replicas,
                 reinitialize_steps=self.client.reinitialize_steps,
+                lock=self.client._lock,
             )
 
         else:
diff --git a/redis/commands/timeseries/__init__.py b/redis/commands/timeseries/__init__.py
index 4720a430f8..4a6886f237 100644
--- a/redis/commands/timeseries/__init__.py
+++ b/redis/commands/timeseries/__init__.py
@@ -77,6 +77,7 @@ def pipeline(self, transaction=True, shard_hint=None):
                 cluster_error_retry_attempts=self.client.cluster_error_retry_attempts,
                 read_from_replicas=self.client.read_from_replicas,
                 reinitialize_steps=self.client.reinitialize_steps,
+                lock=self.client._lock,
             )
 
         else:

From f704281cf4c1f735c06a13946fcea42fa939e3a5 Mon Sep 17 00:00:00 2001
From: Utkarsh Gupta <utkarshgupta137@gmail.com>
Date: Mon, 30 May 2022 19:04:06 +0530
Subject: [PATCH 0500/1164] async_cluster: add/update typing (#2195)

* async_cluster: add/update typing

* async_cluster: update cleanup_kwargs with kwargs from async Connection

* async_cluster: properly remove old nodes
---
 redis/asyncio/cluster.py           | 162 ++++++++++++++++-------------
 redis/asyncio/connection.py        |   8 +-
 redis/asyncio/parser.py            |  14 +--
 redis/cluster.py                   |  15 +--
 redis/utils.py                     |   5 +-
 tests/test_asyncio/test_cluster.py |  35 ++-----
 6 files changed, 123 insertions(+), 116 deletions(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index fa918721dc..c4e01d619a 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -3,11 +3,12 @@
 import random
 import socket
 import warnings
-from typing import Any, Callable, Dict, List, Optional, Type, TypeVar, Union
+from typing import Any, Deque, Dict, Generator, List, Optional, Type, TypeVar, Union
 
-from redis.asyncio.client import EMPTY_RESPONSE, NEVER_DECODE, AbstractRedis
+from redis.asyncio.client import ResponseCallbackT
 from redis.asyncio.connection import Connection, DefaultParser, Encoder, parse_url
 from redis.asyncio.parser import CommandsParser
+from redis.client import EMPTY_RESPONSE, NEVER_DECODE, AbstractRedis
 from redis.cluster import (
     PRIMARY,
     READ_COMMANDS,
@@ -15,7 +16,6 @@
     SLOT_ID,
     AbstractRedisCluster,
     LoadBalancer,
-    cleanup_kwargs,
     get_node_name,
     parse_cluster_slots,
 )
@@ -41,9 +41,36 @@
 from redis.utils import dict_merge, str_if_bytes
 
 TargetNodesT = TypeVar(
-    "TargetNodesT", "ClusterNode", List["ClusterNode"], Dict[Any, "ClusterNode"]
+    "TargetNodesT", str, "ClusterNode", List["ClusterNode"], Dict[Any, "ClusterNode"]
 )
 
+CONNECTION_ALLOWED_KEYS = (
+    "client_name",
+    "db",
+    "decode_responses",
+    "encoder_class",
+    "encoding",
+    "encoding_errors",
+    "health_check_interval",
+    "parser_class",
+    "password",
+    "redis_connect_func",
+    "retry",
+    "retry_on_timeout",
+    "socket_connect_timeout",
+    "socket_keepalive",
+    "socket_keepalive_options",
+    "socket_read_size",
+    "socket_timeout",
+    "socket_type",
+    "username",
+)
+
+
+def cleanup_kwargs(**kwargs: Any) -> Dict[str, Any]:
+    """Remove unsupported or disabled keys from kwargs."""
+    return {k: v for k, v in kwargs.items() if k in CONNECTION_ALLOWED_KEYS}
+
 
 class ClusterParser(DefaultParser):
     EXCEPTION_CLASSES = dict_merge(
@@ -131,7 +158,7 @@ class RedisCluster(AbstractRedis, AbstractRedisCluster, AsyncRedisClusterCommand
     """
 
     @classmethod
-    def from_url(cls, url: str, **kwargs) -> "RedisCluster":
+    def from_url(cls, url: str, **kwargs: Any) -> "RedisCluster":
         """
         Return a Redis client object configured from the given URL.
 
@@ -201,7 +228,7 @@ def __init__(
         cluster_error_retry_attempts: int = 3,
         reinitialize_steps: int = 10,
         url: Optional[str] = None,
-        **kwargs,
+        **kwargs: Any,
     ) -> None:
         if not startup_nodes:
             startup_nodes = []
@@ -212,7 +239,7 @@ def __init__(
                 "Argument 'db' is not possible to use in cluster mode"
             )
 
-        # Get the startup node/s
+        # Get the startup node(s)
         if url:
             url_options = parse_url(url)
             if "path" in url_options:
@@ -247,34 +274,34 @@ def __init__(
         self.connection_kwargs = kwargs = cleanup_kwargs(**kwargs)
         self.response_callbacks = kwargs[
             "response_callbacks"
-        ] = self.__class__.RESPONSE_CALLBACKS
+        ] = self.__class__.RESPONSE_CALLBACKS.copy()
         if host and port:
             startup_nodes.append(ClusterNode(host, port, **self.connection_kwargs))
 
+        self.nodes_manager = NodesManager(
+            startup_nodes=startup_nodes,
+            require_full_coverage=require_full_coverage,
+            **self.connection_kwargs,
+        )
         self.encoder = Encoder(
             kwargs.get("encoding", "utf-8"),
             kwargs.get("encoding_errors", "strict"),
             kwargs.get("decode_responses", False),
         )
         self.cluster_error_retry_attempts = cluster_error_retry_attempts
-        self.command_flags = self.__class__.COMMAND_FLAGS.copy()
-        self.node_flags = self.__class__.NODE_FLAGS.copy()
         self.read_from_replicas = read_from_replicas
-        self.reinitialize_counter = 0
         self.reinitialize_steps = reinitialize_steps
-        self.nodes_manager = NodesManager(
-            startup_nodes=startup_nodes,
-            require_full_coverage=require_full_coverage,
-            **self.connection_kwargs,
-        )
 
-        self.result_callbacks = self.__class__.RESULT_CALLBACKS
+        self.reinitialize_counter = 0
+        self.commands_parser = CommandsParser()
+        self.node_flags = self.__class__.NODE_FLAGS.copy()
+        self.command_flags = self.__class__.COMMAND_FLAGS.copy()
+        self.result_callbacks = self.__class__.RESULT_CALLBACKS.copy()
         self.result_callbacks[
             "CLUSTER SLOTS"
         ] = lambda cmd, res, **kwargs: parse_cluster_slots(
             list(res.values())[0], **kwargs
         )
-        self.commands_parser = CommandsParser()
         self._initialize = True
         self._lock = asyncio.Lock()
 
@@ -310,16 +337,14 @@ async def __aenter__(self) -> "RedisCluster":
     async def __aexit__(self, exc_type: None, exc_value: None, traceback: None) -> None:
         await self.close()
 
-    def __await__(self):
+    def __await__(self) -> Generator[Any, None, "RedisCluster"]:
         return self.initialize().__await__()
 
     _DEL_MESSAGE = "Unclosed RedisCluster client"
 
-    def __del__(self, _warnings=warnings):
+    def __del__(self) -> None:
         if hasattr(self, "_initialize") and not self._initialize:
-            _warnings.warn(
-                f"{self._DEL_MESSAGE} {self!r}", ResourceWarning, source=self
-            )
+            warnings.warn(f"{self._DEL_MESSAGE} {self!r}", ResourceWarning, source=self)
             try:
                 context = {"client": self, "message": self._DEL_MESSAGE}
                 # TODO: Change to get_running_loop() when dropping support for py3.6
@@ -408,7 +433,7 @@ def set_default_node(self, node: "ClusterNode") -> None:
 
         self.nodes_manager.default_node = node
 
-    def set_response_callback(self, command: KeyT, callback: Callable) -> None:
+    def set_response_callback(self, command: str, callback: ResponseCallbackT) -> None:
         """Set a custom response callback."""
         self.response_callbacks[command] = callback
 
@@ -430,7 +455,7 @@ def keyslot(self, key: EncodableT) -> int:
         return key_slot(k)
 
     async def _determine_nodes(
-        self, *args, node_flag: Optional[str] = None
+        self, *args: Any, node_flag: Optional[str] = None
     ) -> List["ClusterNode"]:
         command = args[0]
         if not node_flag:
@@ -462,11 +487,11 @@ async def _determine_nodes(
             )
         ]
 
-    async def _determine_slot(self, *args) -> int:
+    async def _determine_slot(self, *args: Any) -> int:
         command = args[0]
         if self.command_flags.get(command) == SLOT_ID:
             # The command contains the slot ID
-            return args[1]
+            return int(args[1])
 
         # Get the keys in the command
 
@@ -516,14 +541,10 @@ async def _determine_slot(self, *args) -> int:
 
         return slots.pop()
 
-    def _is_node_flag(
-        self, target_nodes: Union[List["ClusterNode"], "ClusterNode", str]
-    ) -> bool:
+    def _is_node_flag(self, target_nodes: Any) -> bool:
         return isinstance(target_nodes, str) and target_nodes in self.node_flags
 
-    def _parse_target_nodes(
-        self, target_nodes: Union[List["ClusterNode"], "ClusterNode"]
-    ) -> List["ClusterNode"]:
+    def _parse_target_nodes(self, target_nodes: Any) -> List["ClusterNode"]:
         if isinstance(target_nodes, list):
             nodes = target_nodes
         elif isinstance(target_nodes, ClusterNode):
@@ -533,7 +554,7 @@ def _parse_target_nodes(
             # Supports dictionaries of the format {node_name: node}.
             # It enables to execute commands with multi nodes as follows:
             # rc.cluster_save_config(rc.get_primaries())
-            nodes = target_nodes.values()
+            nodes = list(target_nodes.values())
         else:
             raise TypeError(
                 "target_nodes type can be one of the following: "
@@ -543,7 +564,7 @@ def _parse_target_nodes(
             )
         return nodes
 
-    async def execute_command(self, *args: Union[KeyT, EncodableT], **kwargs) -> Any:
+    async def execute_command(self, *args: EncodableT, **kwargs: Any) -> Any:
         """
         Execute a raw command on the appropriate cluster node or target_nodes.
 
@@ -562,7 +583,8 @@ async def execute_command(self, *args: Union[KeyT, EncodableT], **kwargs) -> Any
             can't be mapped to a slot
         """
         command = args[0]
-        target_nodes_specified = target_nodes = exception = None
+        target_nodes = []
+        target_nodes_specified = False
         retry_attempts = self.cluster_error_retry_attempts
 
         passed_targets = kwargs.pop("target_nodes", None)
@@ -571,7 +593,7 @@ async def execute_command(self, *args: Union[KeyT, EncodableT], **kwargs) -> Any
             target_nodes_specified = True
             retry_attempts = 1
 
-        for _ in range(0, retry_attempts):
+        for _ in range(retry_attempts):
             if self._initialize:
                 await self.initialize()
             try:
@@ -622,9 +644,10 @@ async def execute_command(self, *args: Union[KeyT, EncodableT], **kwargs) -> Any
         raise exception
 
     async def _execute_command(
-        self, target_node: "ClusterNode", *args: Union[KeyT, EncodableT], **kwargs
+        self, target_node: "ClusterNode", *args: Union[KeyT, EncodableT], **kwargs: Any
     ) -> Any:
-        redirect_addr = asking = moved = None
+        asking = moved = False
+        redirect_addr = None
         ttl = self.RedisClusterRequestTTL
         connection_error_retry_counter = 0
 
@@ -725,8 +748,8 @@ def __init__(
         server_type: Optional[str] = None,
         max_connections: int = 2 ** 31,
         connection_class: Type[Connection] = Connection,
-        response_callbacks: Dict = RedisCluster.RESPONSE_CALLBACKS,
-        **connection_kwargs,
+        response_callbacks: Dict[str, Any] = RedisCluster.RESPONSE_CALLBACKS,
+        **connection_kwargs: Any,
     ) -> None:
         if host == "localhost":
             host = socket.gethostbyname(host)
@@ -743,8 +766,8 @@ def __init__(
         self.connection_kwargs = connection_kwargs
         self.response_callbacks = response_callbacks
 
-        self._connections = []
-        self._free = collections.deque(maxlen=self.max_connections)
+        self._connections: List[Connection] = []
+        self._free: Deque[Connection] = collections.deque(maxlen=self.max_connections)
 
     def __repr__(self) -> str:
         return (
@@ -752,15 +775,15 @@ def __repr__(self) -> str:
             f"name={self.name}, server_type={self.server_type}]"
         )
 
-    def __eq__(self, obj: "ClusterNode") -> bool:
+    def __eq__(self, obj: Any) -> bool:
         return isinstance(obj, ClusterNode) and obj.name == self.name
 
     _DEL_MESSAGE = "Unclosed ClusterNode object"
 
-    def __del__(self, _warnings=warnings):
+    def __del__(self) -> None:
         for connection in self._connections:
             if connection.is_connected:
-                _warnings.warn(
+                warnings.warn(
                     f"{self._DEL_MESSAGE} {self!r}", ResourceWarning, source=self
                 )
                 try:
@@ -783,7 +806,7 @@ async def disconnect(self) -> None:
         if exc:
             raise exc
 
-    async def execute_command(self, *args, **kwargs) -> Any:
+    async def execute_command(self, *args: Any, **kwargs: Any) -> Any:
         # Acquire connection
         connection = None
         if self._free:
@@ -829,11 +852,11 @@ async def execute_command(self, *args, **kwargs) -> Any:
 class NodesManager:
     __slots__ = (
         "_moved_exception",
-        "_require_full_coverage",
         "connection_kwargs",
         "default_node",
         "nodes_cache",
         "read_load_balancer",
+        "require_full_coverage",
         "slots_cache",
         "startup_nodes",
     )
@@ -842,23 +865,24 @@ def __init__(
         self,
         startup_nodes: List["ClusterNode"],
         require_full_coverage: bool = False,
-        **kwargs,
+        **kwargs: Any,
     ) -> None:
-        self.nodes_cache = {}
-        self.slots_cache = {}
         self.startup_nodes = {node.name: node for node in startup_nodes}
-        self.default_node = None
-        self._require_full_coverage = require_full_coverage
-        self._moved_exception = None
+        self.require_full_coverage = require_full_coverage
         self.connection_kwargs = kwargs
+
+        self.default_node: "ClusterNode" = None
+        self.nodes_cache: Dict[str, "ClusterNode"] = {}
+        self.slots_cache: Dict[int, List["ClusterNode"]] = {}
         self.read_load_balancer = LoadBalancer()
+        self._moved_exception: MovedError = None
 
     def get_node(
         self,
         host: Optional[str] = None,
         port: Optional[int] = None,
         node_name: Optional[str] = None,
-    ) -> "ClusterNode":
+    ) -> Optional["ClusterNode"]:
         if host and port:
             # the user passed host and port
             if host == "localhost":
@@ -877,20 +901,18 @@ def set_nodes(
         self,
         old: Dict[str, "ClusterNode"],
         new: Dict[str, "ClusterNode"],
-        remove_old=False,
+        remove_old: bool = False,
     ) -> None:
-        tasks = []
         if remove_old:
-            tasks = [
-                asyncio.ensure_future(node.disconnect())
-                for name, node in old.items()
-                if name not in new
-            ]
+            for name in list(old.keys()):
+                if name not in new:
+                    asyncio.ensure_future(old.pop(name).disconnect())
+
         for name, node in new.items():
             if name in old:
                 if old[name] is node:
                     continue
-                tasks.append(asyncio.ensure_future(old[name].disconnect()))
+                asyncio.ensure_future(old[name].disconnect())
             old[name] = node
 
     def _update_moved_slots(self) -> None:
@@ -949,7 +971,7 @@ def get_node_from_slot(
         except (IndexError, TypeError):
             raise SlotNotCoveredError(
                 f'Slot "{slot}" not covered by the cluster. '
-                f'"require_full_coverage={self._require_full_coverage}"'
+                f'"require_full_coverage={self.require_full_coverage}"'
             )
 
     def get_nodes_by_server_type(self, server_type: str) -> List["ClusterNode"]:
@@ -961,8 +983,8 @@ def get_nodes_by_server_type(self, server_type: str) -> List["ClusterNode"]:
 
     async def initialize(self) -> None:
         self.read_load_balancer.reset()
-        tmp_nodes_cache = {}
-        tmp_slots = {}
+        tmp_nodes_cache: Dict[str, "ClusterNode"] = {}
+        tmp_slots: Dict[int, List["ClusterNode"]] = {}
         disagreements = []
         startup_nodes_reachable = False
         fully_covered = False
@@ -975,9 +997,7 @@ async def initialize(self) -> None:
                     raise RedisClusterException(
                         "Cluster mode is not enabled on this node"
                     )
-                cluster_slots = str_if_bytes(
-                    await startup_node.execute_command("CLUSTER SLOTS")
-                )
+                cluster_slots = await startup_node.execute_command("CLUSTER SLOTS")
                 startup_nodes_reachable = True
             except (ConnectionError, TimeoutError):
                 continue
@@ -1069,7 +1089,7 @@ async def initialize(self) -> None:
 
             # Validate if all slots are covered or if we should try next startup node
             fully_covered = True
-            for i in range(0, REDIS_CLUSTER_HASH_SLOTS):
+            for i in range(REDIS_CLUSTER_HASH_SLOTS):
                 if i not in tmp_slots:
                     fully_covered = False
                     break
@@ -1083,7 +1103,7 @@ async def initialize(self) -> None:
             )
 
         # Check if the slots are not fully covered
-        if not fully_covered and self._require_full_coverage:
+        if not fully_covered and self.require_full_coverage:
             # Despite the requirement that the slots be covered, there
             # isn't a full coverage
             raise RedisClusterException(
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 9de2d46b7e..d9b09746ba 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -684,7 +684,7 @@ def register_connect_callback(self, callback):
     def clear_connect_callbacks(self):
         self._connect_callbacks = []
 
-    def set_parser(self, parser_class):
+    def set_parser(self, parser_class: Type[BaseParser]) -> None:
         """
         Creates a new instance of parser_class with socket size:
         _socket_read_size and assigns it to the parser for the connection
@@ -766,7 +766,7 @@ def _error_message(self, exception):
                 f"{exception.args[0]}."
             )
 
-    async def on_connect(self):
+    async def on_connect(self) -> None:
         """Initialize the connection, authenticate and select a database"""
         self._parser.on_connect(self)
 
@@ -807,7 +807,7 @@ async def on_connect(self):
             if str_if_bytes(await self.read_response()) != "OK":
                 raise ConnectionError("Invalid Database")
 
-    async def disconnect(self):
+    async def disconnect(self) -> None:
         """Disconnects from the Redis server"""
         try:
             async with async_timeout.timeout(self.socket_connect_timeout):
@@ -891,7 +891,7 @@ async def send_packed_command(
             await self.disconnect()
             raise
 
-    async def send_command(self, *args, **kwargs):
+    async def send_command(self, *args: Any, **kwargs: Any) -> None:
         """Pack and send a command to the Redis server"""
         await self.send_packed_command(
             self.pack_command(*args), check_health=kwargs.get("check_health", True)
diff --git a/redis/asyncio/parser.py b/redis/asyncio/parser.py
index 273fe0339f..628635132b 100644
--- a/redis/asyncio/parser.py
+++ b/redis/asyncio/parser.py
@@ -1,4 +1,4 @@
-from typing import TYPE_CHECKING, List, Optional, Union
+from typing import TYPE_CHECKING, Any, Dict, Optional, Tuple, Union
 
 from redis.exceptions import RedisError, ResponseError
 
@@ -25,7 +25,7 @@ class CommandsParser:
     __slots__ = ("commands",)
 
     def __init__(self) -> None:
-        self.commands = {}
+        self.commands: Dict[str, Union[int, Dict[str, Any]]] = {}
 
     async def initialize(self, r: "ClusterNode") -> None:
         commands = await r.execute_command("COMMAND")
@@ -42,8 +42,8 @@ async def initialize(self, r: "ClusterNode") -> None:
     # our logic to use COMMAND INFO changes to determine the key positions
     # https://github.com/redis/redis/pull/8324
     async def get_keys(
-        self, redis_conn: "ClusterNode", *args
-    ) -> Optional[Union[List[str], List[bytes]]]:
+        self, redis_conn: "ClusterNode", *args: Any
+    ) -> Optional[Tuple[str, ...]]:
         if len(args) < 2:
             # The command has no keys in it
             return None
@@ -67,7 +67,7 @@ async def get_keys(
             command = self.commands[cmd_name]
 
         if command == 1:
-            return [args[1]]
+            return (args[1],)
         if command == 0:
             return None
         if command == -1:
@@ -79,8 +79,8 @@ async def get_keys(
         return args[command["first_key_pos"] : last_key_pos + 1 : command["step_count"]]
 
     async def _get_moveable_keys(
-        self, redis_conn: "ClusterNode", *args
-    ) -> Optional[List[str]]:
+        self, redis_conn: "ClusterNode", *args: Any
+    ) -> Optional[Tuple[str, ...]]:
         try:
             keys = await redis_conn.execute_command("COMMAND GETKEYS", *args)
         except ResponseError as e:
diff --git a/redis/cluster.py b/redis/cluster.py
index 0b9c543afb..46a96a6a02 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -6,6 +6,7 @@
 import threading
 import time
 from collections import OrderedDict
+from typing import Any, Dict, Tuple
 
 from redis.client import CaseInsensitiveDict, PubSub, Redis, parse_scan
 from redis.commands import CommandsParser, RedisClusterCommands
@@ -40,7 +41,7 @@
 log = logging.getLogger(__name__)
 
 
-def get_node_name(host, port):
+def get_node_name(host: str, port: int) -> str:
     return f"{host}:{port}"
 
 
@@ -74,10 +75,12 @@ def parse_pubsub_numsub(command, res, **options):
     return ret_numsub
 
 
-def parse_cluster_slots(resp, **options):
+def parse_cluster_slots(
+    resp: Any, **options: Any
+) -> Dict[Tuple[int, int], Dict[str, Any]]:
     current_host = options.get("current_host", "")
 
-    def fix_server(*args):
+    def fix_server(*args: Any) -> Tuple[str, Any]:
         return str_if_bytes(args[0]) or current_host, args[1]
 
     slots = {}
@@ -1248,17 +1251,17 @@ class LoadBalancer:
     Round-Robin Load Balancing
     """
 
-    def __init__(self, start_index=0):
+    def __init__(self, start_index: int = 0) -> None:
         self.primary_to_idx = {}
         self.start_index = start_index
 
-    def get_server_index(self, primary, list_size):
+    def get_server_index(self, primary: str, list_size: int) -> int:
         server_index = self.primary_to_idx.setdefault(primary, self.start_index)
         # Update the index
         self.primary_to_idx[primary] = (server_index + 1) % list_size
         return server_index
 
-    def reset(self):
+    def reset(self) -> None:
         self.primary_to_idx.clear()
 
 
diff --git a/redis/utils.py b/redis/utils.py
index 9ab75f2a97..0c34e1eef8 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -1,4 +1,5 @@
 from contextlib import contextmanager
+from typing import Any, Dict, Mapping, Union
 
 try:
     import hiredis  # noqa
@@ -34,7 +35,7 @@ def pipeline(redis_obj):
     p.execute()
 
 
-def str_if_bytes(value):
+def str_if_bytes(value: Union[str, bytes]) -> str:
     return (
         value.decode("utf-8", errors="replace") if isinstance(value, bytes) else value
     )
@@ -44,7 +45,7 @@ def safe_str(value):
     return str(str_if_bytes(value))
 
 
-def dict_merge(*dicts):
+def dict_merge(*dicts: Mapping[str, Any]) -> Dict[str, Any]:
     """
     Merge all provided dicts into 1 dict.
     *dicts : `dict`
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 6c28ce35a2..123adc8549 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -3,6 +3,7 @@
 import datetime
 import sys
 import warnings
+from typing import Any, Callable, Dict, List, Optional, Type, Union
 
 import pytest
 
@@ -13,21 +14,13 @@
 else:
     import pytest_asyncio
 
-from typing import Callable, Dict, List, Optional, Type, Union
-
 from _pytest.fixtures import FixtureRequest, SubRequest
 
 from redis.asyncio import Connection, RedisCluster
-from redis.asyncio.cluster import (
-    PRIMARY,
-    REDIS_CLUSTER_HASH_SLOTS,
-    REPLICA,
-    ClusterNode,
-    NodesManager,
-    get_node_name,
-)
+from redis.asyncio.cluster import ClusterNode, NodesManager
 from redis.asyncio.parser import CommandsParser
-from redis.crc import key_slot
+from redis.cluster import PRIMARY, REPLICA, get_node_name
+from redis.crc import REDIS_CLUSTER_HASH_SLOTS, key_slot
 from redis.exceptions import (
     AskError,
     ClusterDownError,
@@ -109,7 +102,7 @@ async def execute_command(*_args, **_kwargs):
             CommandsParser, "initialize", autospec=True
         ) as cmd_parser_initialize:
 
-            def cmd_init_mock(self, r):
+            def cmd_init_mock(self, r: ClusterNode) -> None:
                 self.commands = {
                     "GET": {
                         "name": "get",
@@ -126,12 +119,7 @@ def cmd_init_mock(self, r):
             return await RedisCluster(*args, **kwargs)
 
 
-def mock_node_resp(
-    node: ClusterNode,
-    response: Union[
-        List[List[Union[int, List[Union[str, int]]]]], List[bytes], str, int
-    ],
-) -> ClusterNode:
+def mock_node_resp(node: ClusterNode, response: Any) -> ClusterNode:
     connection = mock.AsyncMock()
     connection.is_connected = True
     connection.read_response_without_lock.return_value = response
@@ -141,12 +129,7 @@ def mock_node_resp(
     return node
 
 
-def mock_all_nodes_resp(
-    rc: RedisCluster,
-    response: Union[
-        List[List[Union[int, List[Union[str, int]]]]], List[bytes], int, str
-    ],
-) -> RedisCluster:
+def mock_all_nodes_resp(rc: RedisCluster, response: Any) -> RedisCluster:
     for node in rc.get_nodes():
         mock_node_resp(node, response)
     return rc
@@ -461,7 +444,7 @@ def map_7007(self):
                         CommandsParser, "initialize", autospec=True
                     ) as cmd_parser_initialize:
 
-                        def cmd_init_mock(self, r):
+                        def cmd_init_mock(self, r: ClusterNode) -> None:
                             self.commands = {
                                 "GET": {
                                     "name": "get",
@@ -2217,7 +2200,7 @@ async def mocked_execute_command(self, *args, **kwargs):
                 CommandsParser, "initialize", autospec=True
             ) as cmd_parser_initialize:
 
-                def cmd_init_mock(self, r):
+                def cmd_init_mock(self, r: ClusterNode) -> None:
                     self.commands = {
                         "GET": {
                             "name": "get",

From c54dfa49dda6a7b3389dc230726293af3ffc68a3 Mon Sep 17 00:00:00 2001
From: Utkarsh Gupta <utkarshgupta137@gmail.com>
Date: Mon, 30 May 2022 20:05:19 +0530
Subject: [PATCH 0501/1164] update black to 22.3.0 (#2171)

---
 benchmarks/cluster_async.py         |   8 +-
 dev_requirements.txt                |   2 +-
 redis/asyncio/cluster.py            |   2 +-
 redis/asyncio/connection.py         |   2 +-
 redis/backoff.py                    |   6 +-
 redis/commands/core.py              | 131 +++++-----------------------
 redis/commands/json/__init__.py     |   6 +-
 redis/commands/search/__init__.py   |  12 +--
 redis/commands/search/commands.py   |  21 +----
 redis/commands/search/field.py      |  11 +--
 redis/connection.py                 |  19 ++--
 redis/sentinel.py                   |   9 +-
 tests/test_asyncio/test_commands.py |  19 ++--
 tests/test_asyncio/test_encoding.py |  10 +--
 tests/test_asyncio/test_json.py     |  11 +--
 tests/test_asyncio/test_pipeline.py |   5 +-
 tests/test_asyncio/test_pubsub.py   |   4 +-
 tests/test_asyncio/test_search.py   |  45 +++-------
 tests/test_asyncio/test_sentinel.py |   2 +-
 tests/test_cluster.py               |  64 +++-----------
 tests/test_command_parser.py        |   8 +-
 tests/test_commands.py              | 100 ++++++---------------
 tests/test_connection_pool.py       |  70 ++++-----------
 tests/test_encoding.py              |   6 +-
 tests/test_function.py              |   4 +-
 tests/test_json.py                  |  23 ++---
 tests/test_pipeline.py              |   5 +-
 tests/test_search.py                |  74 ++++------------
 tests/test_sentinel.py              |   2 +-
 29 files changed, 156 insertions(+), 525 deletions(-)

diff --git a/benchmarks/cluster_async.py b/benchmarks/cluster_async.py
index aec3f1c403..fd2ab4603f 100644
--- a/benchmarks/cluster_async.py
+++ b/benchmarks/cluster_async.py
@@ -206,8 +206,8 @@ async def main(loop, gather=None):
         host=host,
         port=port,
         password=password,
-        max_connections=2 ** 31,
-        max_connections_per_node=2 ** 31,
+        max_connections=2**31,
+        max_connections_per_node=2**31,
         readonly=False,
         reinitialize_steps=count,
         skip_full_coverage_check=True,
@@ -224,7 +224,7 @@ async def main(loop, gather=None):
         password=password,
         state_reload_interval=count,
         idle_connection_timeout=count,
-        pool_maxsize=2 ** 31,
+        pool_maxsize=2**31,
     )
     print(f"{loop} {gather} {await warmup(aiorc)} aioredis-cluster")
     print(await run(aiorc, gather=gather))
@@ -238,7 +238,7 @@ async def main(loop, gather=None):
         reinitialize_steps=count,
         read_from_replicas=False,
         decode_responses=False,
-        max_connections=2 ** 31,
+        max_connections=2**31,
     ) as rca:
         print(f"{loop} {gather} {await warmup(rca)} redispy")
         print(await run(rca, gather=gather))
diff --git a/dev_requirements.txt b/dev_requirements.txt
index 942edd6d0f..31ae26ebea 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -1,5 +1,5 @@
 click==8.0.4
-black==21.11b1
+black==22.3.0
 flake8==4.0.1
 flynt~=0.69.0
 isort==5.10.1
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index c4e01d619a..39aa536de1 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -746,7 +746,7 @@ def __init__(
         host: str,
         port: int,
         server_type: Optional[str] = None,
-        max_connections: int = 2 ** 31,
+        max_connections: int = 2**31,
         connection_class: Type[Connection] = Connection,
         response_callbacks: Dict[str, Any] = RedisCluster.RESPONSE_CALLBACKS,
         **connection_kwargs: Any,
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index d9b09746ba..38465fc0d7 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -1390,7 +1390,7 @@ def __init__(
         max_connections: Optional[int] = None,
         **connection_kwargs,
     ):
-        max_connections = max_connections or 2 ** 31
+        max_connections = max_connections or 2**31
         if not isinstance(max_connections, int) or max_connections < 0:
             raise ValueError('"max_connections" must be a positive integer')
 
diff --git a/redis/backoff.py b/redis/backoff.py
index cbb4e73779..5ccdb919f3 100644
--- a/redis/backoff.py
+++ b/redis/backoff.py
@@ -49,7 +49,7 @@ def __init__(self, cap, base):
         self._base = base
 
     def compute(self, failures):
-        return min(self._cap, self._base * 2 ** failures)
+        return min(self._cap, self._base * 2**failures)
 
 
 class FullJitterBackoff(AbstractBackoff):
@@ -64,7 +64,7 @@ def __init__(self, cap, base):
         self._base = base
 
     def compute(self, failures):
-        return random.uniform(0, min(self._cap, self._base * 2 ** failures))
+        return random.uniform(0, min(self._cap, self._base * 2**failures))
 
 
 class EqualJitterBackoff(AbstractBackoff):
@@ -79,7 +79,7 @@ def __init__(self, cap, base):
         self._base = base
 
     def compute(self, failures):
-        temp = min(self._cap, self._base * 2 ** failures) / 2
+        temp = min(self._cap, self._base * 2**failures) / 2
         return temp + random.uniform(0, temp)
 
 
diff --git a/redis/commands/core.py b/redis/commands/core.py
index ad7d7a6a94..771fed9e0c 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -502,10 +502,7 @@ def client_info(self, **kwargs) -> ResponseT:
         return self.execute_command("CLIENT INFO", **kwargs)
 
     def client_list(
-        self,
-        _type: Union[str, None] = None,
-        client_id: List[EncodableT] = [],
-        **kwargs,
+        self, _type: Union[str, None] = None, client_id: List[EncodableT] = [], **kwargs
     ) -> ResponseT:
         """
         Returns a list of currently connected clients.
@@ -548,9 +545,7 @@ def client_getredir(self, **kwargs) -> ResponseT:
         return self.execute_command("CLIENT GETREDIR", **kwargs)
 
     def client_reply(
-        self,
-        reply: Union[Literal["ON"], Literal["OFF"], Literal["SKIP"]],
-        **kwargs,
+        self, reply: Union[Literal["ON"], Literal["OFF"], Literal["SKIP"]], **kwargs
     ) -> ResponseT:
         """
         Enable and disable redis server replies.
@@ -696,10 +691,7 @@ def client_setname(self, name: str, **kwargs) -> ResponseT:
         return self.execute_command("CLIENT SETNAME", name, **kwargs)
 
     def client_unblock(
-        self,
-        client_id: int,
-        error: bool = False,
-        **kwargs,
+        self, client_id: int, error: bool = False, **kwargs
     ) -> ResponseT:
         """
         Unblocks a connection by its client id.
@@ -1475,12 +1467,7 @@ def bitfield(
         """
         return BitFieldOperation(self, key, default_overflow=default_overflow)
 
-    def bitop(
-        self,
-        operation: str,
-        dest: KeyT,
-        *keys: KeyT,
-    ) -> ResponseT:
+    def bitop(self, operation: str, dest: KeyT, *keys: KeyT) -> ResponseT:
         """
         Perform a bitwise operation using ``operation`` between ``keys`` and
         store the result in ``dest``.
@@ -1826,11 +1813,7 @@ def keys(self, pattern: PatternT = "*", **kwargs) -> ResponseT:
         return self.execute_command("KEYS", pattern, **kwargs)
 
     def lmove(
-        self,
-        first_list: str,
-        second_list: str,
-        src: str = "LEFT",
-        dest: str = "RIGHT",
+        self, first_list: str, second_list: str, src: str = "LEFT", dest: str = "RIGHT"
     ) -> ResponseT:
         """
         Atomically returns and removes the first/last element of a list,
@@ -1996,12 +1979,7 @@ def pexpiretime(self, key: str) -> int:
         """
         return self.execute_command("PEXPIRETIME", key)
 
-    def psetex(
-        self,
-        name: KeyT,
-        time_ms: ExpiryT,
-        value: EncodableT,
-    ):
+    def psetex(self, name: KeyT, time_ms: ExpiryT, value: EncodableT):
         """
         Set the value of key ``name`` to ``value`` that expires in ``time_ms``
         milliseconds. ``time_ms`` can be represented by an integer or a Python
@@ -2022,10 +2000,7 @@ def pttl(self, name: KeyT) -> ResponseT:
         return self.execute_command("PTTL", name)
 
     def hrandfield(
-        self,
-        key: str,
-        count: int = None,
-        withvalues: bool = False,
+        self, key: str, count: int = None, withvalues: bool = False
     ) -> ResponseT:
         """
         Return a random field from the hash value stored at key.
@@ -2240,12 +2215,7 @@ def setnx(self, name: KeyT, value: EncodableT) -> ResponseT:
         """
         return self.execute_command("SETNX", name, value)
 
-    def setrange(
-        self,
-        name: KeyT,
-        offset: int,
-        value: EncodableT,
-    ) -> ResponseT:
+    def setrange(self, name: KeyT, offset: int, value: EncodableT) -> ResponseT:
         """
         Overwrite bytes in the value of ``name`` starting at ``offset`` with
         ``value``. If ``offset`` plus the length of ``value`` exceeds the
@@ -3259,10 +3229,7 @@ def smembers(self, name: str) -> Union[Awaitable[list], list]:
         return self.execute_command("SMEMBERS", name)
 
     def smismember(
-        self,
-        name: str,
-        values: List,
-        *args: List,
+        self, name: str, values: List, *args: List
     ) -> Union[Awaitable[List[bool]], List[bool]]:
         """
         Return whether each value in ``values`` is a member of the set ``name``
@@ -3291,9 +3258,7 @@ def spop(self, name: str, count: Optional[int] = None) -> Union[str, List, None]
         return self.execute_command("SPOP", name, *args)
 
     def srandmember(
-        self,
-        name: str,
-        number: Optional[int] = None,
+        self, name: str, number: Optional[int] = None
     ) -> Union[str, List, None]:
         """
         If ``number`` is None, returns a random member of set ``name``.
@@ -3346,12 +3311,7 @@ class StreamCommands(CommandsProtocol):
     see: https://redis.io/topics/streams-intro
     """
 
-    def xack(
-        self,
-        name: KeyT,
-        groupname: GroupT,
-        *ids: StreamIdT,
-    ) -> ResponseT:
+    def xack(self, name: KeyT, groupname: GroupT, *ids: StreamIdT) -> ResponseT:
         """
         Acknowledges the successful processing of one or more messages.
         name: name of the stream.
@@ -3576,10 +3536,7 @@ def xgroup_create(
         return self.execute_command(*pieces)
 
     def xgroup_delconsumer(
-        self,
-        name: KeyT,
-        groupname: GroupT,
-        consumername: ConsumerT,
+        self, name: KeyT, groupname: GroupT, consumername: ConsumerT
     ) -> ResponseT:
         """
         Remove a specific consumer from a consumer group.
@@ -3604,10 +3561,7 @@ def xgroup_destroy(self, name: KeyT, groupname: GroupT) -> ResponseT:
         return self.execute_command("XGROUP DESTROY", name, groupname)
 
     def xgroup_createconsumer(
-        self,
-        name: KeyT,
-        groupname: GroupT,
-        consumername: ConsumerT,
+        self, name: KeyT, groupname: GroupT, consumername: ConsumerT
     ) -> ResponseT:
         """
         Consumers in a consumer group are auto-created every time a new
@@ -4052,12 +4006,7 @@ def zdiffstore(self, dest: KeyT, keys: KeysT) -> ResponseT:
         pieces = [len(keys), *keys]
         return self.execute_command("ZDIFFSTORE", dest, *pieces)
 
-    def zincrby(
-        self,
-        name: KeyT,
-        amount: float,
-        value: EncodableT,
-    ) -> ResponseT:
+    def zincrby(self, name: KeyT, amount: float, value: EncodableT) -> ResponseT:
         """
         Increment the score of ``value`` in sorted set ``name`` by ``amount``
 
@@ -4066,10 +4015,7 @@ def zincrby(
         return self.execute_command("ZINCRBY", name, amount, value)
 
     def zinter(
-        self,
-        keys: KeysT,
-        aggregate: Union[str, None] = None,
-        withscores: bool = False,
+        self, keys: KeysT, aggregate: Union[str, None] = None, withscores: bool = False
     ) -> ResponseT:
         """
         Return the intersect of multiple sorted sets specified by ``keys``.
@@ -4127,11 +4073,7 @@ def zlexcount(self, name, min, max):
         """
         return self.execute_command("ZLEXCOUNT", name, min, max)
 
-    def zpopmax(
-        self,
-        name: KeyT,
-        count: Union[int, None] = None,
-    ) -> ResponseT:
+    def zpopmax(self, name: KeyT, count: Union[int, None] = None) -> ResponseT:
         """
         Remove and return up to ``count`` members with the highest scores
         from the sorted set ``name``.
@@ -4142,11 +4084,7 @@ def zpopmax(
         options = {"withscores": True}
         return self.execute_command("ZPOPMAX", name, *args, **options)
 
-    def zpopmin(
-        self,
-        name: KeyT,
-        count: Union[int, None] = None,
-    ) -> ResponseT:
+    def zpopmin(self, name: KeyT, count: Union[int, None] = None) -> ResponseT:
         """
         Remove and return up to ``count`` members with the lowest scores
         from the sorted set ``name``.
@@ -4158,10 +4096,7 @@ def zpopmin(
         return self.execute_command("ZPOPMIN", name, *args, **options)
 
     def zrandmember(
-        self,
-        key: KeyT,
-        count: int = None,
-        withscores: bool = False,
+        self, key: KeyT, count: int = None, withscores: bool = False
     ) -> ResponseT:
         """
         Return a random element from the sorted set value stored at key.
@@ -4675,11 +4610,7 @@ def zunionstore(
         """
         return self._zaggregate("ZUNIONSTORE", dest, keys, aggregate)
 
-    def zmscore(
-        self,
-        key: KeyT,
-        members: List[str],
-    ) -> ResponseT:
+    def zmscore(self, key: KeyT, members: List[str]) -> ResponseT:
         """
         Returns the scores associated with the specified members
         in the sorted set stored at key.
@@ -5264,11 +5195,7 @@ def geoadd(
         return self.execute_command("GEOADD", *pieces)
 
     def geodist(
-        self,
-        name: KeyT,
-        place1: FieldT,
-        place2: FieldT,
-        unit: Union[str, None] = None,
+        self, name: KeyT, place1: FieldT, place2: FieldT, unit: Union[str, None] = None
     ) -> ResponseT:
         """
         Return the distance between ``place1`` and ``place2`` members of the
@@ -5407,10 +5334,7 @@ def georadiusbymember(
         )
 
     def _georadiusgeneric(
-        self,
-        command: str,
-        *args: EncodableT,
-        **kwargs: Union[EncodableT, None],
+        self, command: str, *args: EncodableT, **kwargs: Union[EncodableT, None]
     ) -> ResponseT:
         pieces = list(args)
         if kwargs["unit"] and kwargs["unit"] not in ("m", "km", "mi", "ft"):
@@ -5418,9 +5342,7 @@ def _georadiusgeneric(
         elif kwargs["unit"]:
             pieces.append(kwargs["unit"])
         else:
-            pieces.append(
-                "m",
-            )
+            pieces.append("m")
 
         if kwargs["any"] and kwargs["count"] is None:
             raise DataError("``any`` can't be provided without ``count``")
@@ -5577,10 +5499,7 @@ def geosearchstore(
         )
 
     def _geosearchgeneric(
-        self,
-        command: str,
-        *args: EncodableT,
-        **kwargs: Union[EncodableT, None],
+        self, command: str, *args: EncodableT, **kwargs: Union[EncodableT, None]
     ) -> ResponseT:
         pieces = list(args)
 
@@ -5814,9 +5733,7 @@ class FunctionCommands:
     """
 
     def function_load(
-        self,
-        code: str,
-        replace: Optional[bool] = False,
+        self, code: str, replace: Optional[bool] = False
     ) -> Union[Awaitable[str], str]:
         """
         Load a library to Redis.
diff --git a/redis/commands/json/__init__.py b/redis/commands/json/__init__.py
index 39983be9cb..7d55023e1e 100644
--- a/redis/commands/json/__init__.py
+++ b/redis/commands/json/__init__.py
@@ -19,11 +19,7 @@ class JSON(JSONCommands):
     """
 
     def __init__(
-        self,
-        client,
-        version=None,
-        decoder=JSONDecoder(),
-        encoder=JSONEncoder(),
+        self, client, version=None, decoder=JSONDecoder(), encoder=JSONEncoder()
     ):
         """
         Create a client for talking to json.
diff --git a/redis/commands/search/__init__.py b/redis/commands/search/__init__.py
index b1c0e8be73..923711b8c4 100644
--- a/redis/commands/search/__init__.py
+++ b/redis/commands/search/__init__.py
@@ -59,20 +59,12 @@ def add_document(
             if self.current_chunk >= self.chunk_size:
                 self.commit()
 
-        def add_document_hash(
-            self,
-            doc_id,
-            score=1.0,
-            replace=False,
-        ):
+        def add_document_hash(self, doc_id, score=1.0, replace=False):
             """
             Add a hash to the batch query
             """
             self.client._add_document_hash(
-                doc_id,
-                conn=self._pipeline,
-                score=score,
-                replace=replace,
+                doc_id, conn=self._pipeline, score=score, replace=replace
             )
             self.current_chunk += 1
             self.total += 1
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 10b57624cd..bf6614777e 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -216,12 +216,7 @@ def _add_document(
         return self.execute_command(*args)
 
     def _add_document_hash(
-        self,
-        doc_id,
-        conn=None,
-        score=1.0,
-        language=None,
-        replace=False,
+        self, doc_id, conn=None, score=1.0, language=None, replace=False
     ):
         """
         Internal add_document_hash used for both batch and single doc indexing
@@ -293,13 +288,7 @@ def add_document(
             **fields,
         )
 
-    def add_document_hash(
-        self,
-        doc_id,
-        score=1.0,
-        language=None,
-        replace=False,
-    ):
+    def add_document_hash(self, doc_id, score=1.0, language=None, replace=False):
         """
         Add a hash document to the index.
 
@@ -313,11 +302,7 @@ def add_document_hash(
         - **language**: Specify the language used for document tokenization.
         """  # noqa
         return self._add_document_hash(
-            doc_id,
-            conn=None,
-            score=score,
-            language=language,
-            replace=replace,
+            doc_id, conn=None, score=score, language=language, replace=replace
         )
 
     def delete_document(self, doc_id, conn=None, delete_actual_document=False):
diff --git a/redis/commands/search/field.py b/redis/commands/search/field.py
index 14328e9d3b..89ed97357a 100644
--- a/redis/commands/search/field.py
+++ b/redis/commands/search/field.py
@@ -108,11 +108,7 @@ class TagField(Field):
     CASESENSITIVE = "CASESENSITIVE"
 
     def __init__(
-        self,
-        name: str,
-        separator: str = ",",
-        case_sensitive: bool = False,
-        **kwargs,
+        self, name: str, separator: str = ",", case_sensitive: bool = False, **kwargs
     ):
         args = [Field.TAG, self.SEPARATOR, separator]
         if case_sensitive:
@@ -159,8 +155,5 @@ def __init__(self, name: str, algorithm: str, attributes: dict, **kwargs):
             attr_li.extend([key, value])
 
         Field.__init__(
-            self,
-            name,
-            args=[Field.VECTOR, algorithm, len(attr_li), *attr_li],
-            **kwargs,
+            self, name, args=[Field.VECTOR, algorithm, len(attr_li), *attr_li], **kwargs
         )
diff --git a/redis/connection.py b/redis/connection.py
index e0dcfc6323..1bc2ae1f4e 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -40,9 +40,7 @@
 except ImportError:
     ssl_available = False
 
-NONBLOCKING_EXCEPTION_ERROR_NUMBERS = {
-    BlockingIOError: errno.EWOULDBLOCK,
-}
+NONBLOCKING_EXCEPTION_ERROR_NUMBERS = {BlockingIOError: errno.EWOULDBLOCK}
 
 if ssl_available:
     if hasattr(ssl, "SSLWantReadError"):
@@ -385,10 +383,7 @@ def __del__(self):
     def on_connect(self, connection, **kwargs):
         self._sock = connection._sock
         self._socket_timeout = connection.socket_timeout
-        kwargs = {
-            "protocolError": InvalidResponse,
-            "replyError": self.parse_error,
-        }
+        kwargs = {"protocolError": InvalidResponse, "replyError": self.parse_error}
 
         # hiredis < 0.1.3 doesn't support functions that create exceptions
         if not HIREDIS_SUPPORTS_CALLABLE_ERRORS:
@@ -1035,8 +1030,7 @@ def _connect(self):
                 staple_ctx = self.ssl_ocsp_context
 
             staple_ctx.set_ocsp_client_callback(
-                ocsp_staple_verifier,
-                self.ssl_ocsp_expected_cert,
+                ocsp_staple_verifier, self.ssl_ocsp_expected_cert
             )
 
             #  need another socket
@@ -1119,10 +1113,7 @@ def __init__(
         self._buffer_cutoff = 6000
 
     def repr_pieces(self):
-        pieces = [
-            ("path", self.path),
-            ("db", self.db),
-        ]
+        pieces = [("path", self.path), ("db", self.db)]
         if self.client_name:
             pieces.append(("client_name", self.client_name))
         return pieces
@@ -1288,7 +1279,7 @@ class initializer. In the case of conflicting arguments, querystring
     def __init__(
         self, connection_class=Connection, max_connections=None, **connection_kwargs
     ):
-        max_connections = max_connections or 2 ** 31
+        max_connections = max_connections or 2**31
         if not isinstance(max_connections, int) or max_connections < 0:
             raise ValueError('"max_connections" must be a positive integer')
 
diff --git a/redis/sentinel.py b/redis/sentinel.py
index b3f14907d0..d35abaf514 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -51,10 +51,7 @@ def _connect_retry(self):
             raise SlaveNotFoundError  # Never be here
 
     def connect(self):
-        return self.retry.call_with_retry(
-            self._connect_retry,
-            lambda error: None,
-        )
+        return self.retry.call_with_retry(self._connect_retry, lambda error: None)
 
     def read_response(self, disable_decoding=False):
         try:
@@ -213,9 +210,7 @@ def __repr__(self):
         sentinel_addresses = []
         for sentinel in self.sentinels:
             sentinel_addresses.append(
-                "{host}:{port}".format_map(
-                    sentinel.connection_pool.connection_kwargs,
-                )
+                "{host}:{port}".format_map(sentinel.connection_pool.connection_kwargs)
             )
         return f'{type(self).__name__}<sentinels=[{",".join(sentinel_addresses)}]>'
 
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 650ce27956..6fa702d51c 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -2534,17 +2534,14 @@ async def test_xclaim(self, r: redis.Redis):
 
         # reclaim the message as consumer1, but use the justid argument
         # which only returns message ids
-        assert (
-            await r.xclaim(
-                stream,
-                group,
-                consumer1,
-                min_idle_time=0,
-                message_ids=(message_id,),
-                justid=True,
-            )
-            == [message_id]
-        )
+        assert await r.xclaim(
+            stream,
+            group,
+            consumer1,
+            min_idle_time=0,
+            message_ids=(message_id,),
+            justid=True,
+        ) == [message_id]
 
     @skip_if_server_version_lt("5.0.0")
     async def test_xclaim_trimmed(self, r: redis.Redis):
diff --git a/tests/test_asyncio/test_encoding.py b/tests/test_asyncio/test_encoding.py
index da2983738e..133ea3783c 100644
--- a/tests/test_asyncio/test_encoding.py
+++ b/tests/test_asyncio/test_encoding.py
@@ -68,18 +68,12 @@ async def test_list_encoding(self, r: redis.Redis):
 @pytest.mark.onlynoncluster
 class TestEncodingErrors:
     async def test_ignore(self, create_redis):
-        r = await create_redis(
-            decode_responses=True,
-            encoding_errors="ignore",
-        )
+        r = await create_redis(decode_responses=True, encoding_errors="ignore")
         await r.set("a", b"foo\xff")
         assert await r.get("a") == "foo"
 
     async def test_replace(self, create_redis):
-        r = await create_redis(
-            decode_responses=True,
-            encoding_errors="replace",
-        )
+        r = await create_redis(decode_responses=True, encoding_errors="replace")
         await r.set("a", b"foo\xff")
         assert await r.get("a") == "foo\ufffd"
 
diff --git a/tests/test_asyncio/test_json.py b/tests/test_asyncio/test_json.py
index c203c6d15e..a045dd7c1a 100644
--- a/tests/test_asyncio/test_json.py
+++ b/tests/test_asyncio/test_json.py
@@ -155,16 +155,7 @@ async def test_arrindex(modclient: redis.Redis):
 @pytest.mark.redismod
 async def test_arrinsert(modclient: redis.Redis):
     await modclient.json().set("arr", Path.root_path(), [0, 4])
-    assert 5 - -await modclient.json().arrinsert(
-        "arr",
-        Path.root_path(),
-        1,
-        *[
-            1,
-            2,
-            3,
-        ],
-    )
+    assert 5 - -await modclient.json().arrinsert("arr", Path.root_path(), 1, *[1, 2, 3])
     assert [0, 1, 2, 3, 4] == await modclient.json().get("arr")
 
     # test prepends
diff --git a/tests/test_asyncio/test_pipeline.py b/tests/test_asyncio/test_pipeline.py
index 5bb1a8a4e0..50a1051f4f 100644
--- a/tests/test_asyncio/test_pipeline.py
+++ b/tests/test_asyncio/test_pipeline.py
@@ -37,10 +37,7 @@ async def test_pipeline(self, r):
     async def test_pipeline_memoryview(self, r):
         async with r.pipeline() as pipe:
             (pipe.set("a", memoryview(b"a1")).get("a"))
-            assert await pipe.execute() == [
-                True,
-                b"a1",
-            ]
+            assert await pipe.execute() == [True, b"a1"]
 
     async def test_pipeline_length(self, r):
         async with r.pipeline() as pipe:
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index 4037040f7c..6c76bf334e 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -425,9 +425,7 @@ def message_handler(self, message):
 
     @pytest_asyncio.fixture()
     async def r(self, create_redis):
-        return await create_redis(
-            decode_responses=True,
-        )
+        return await create_redis(decode_responses=True)
 
     async def test_channel_subscribe_unsubscribe(self, r: redis.Redis):
         p = r.pubsub()
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 69ae54d027..5aaa56f159 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -919,18 +919,14 @@ async def test_aggregations_groupby(modclient: redis.Redis):
         random_num=8,
     )
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.count(),
-    )
+    req = aggregations.AggregateRequest("redis").group_by("@parent", reducers.count())
 
     res = (await modclient.ft().aggregate(req)).rows[0]
     assert res[1] == "redis"
     assert res[3] == "3"
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.count_distinct("@title"),
+        "@parent", reducers.count_distinct("@title")
     )
 
     res = (await modclient.ft().aggregate(req)).rows[0]
@@ -938,8 +934,7 @@ async def test_aggregations_groupby(modclient: redis.Redis):
     assert res[3] == "3"
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.count_distinctish("@title"),
+        "@parent", reducers.count_distinctish("@title")
     )
 
     res = (await modclient.ft().aggregate(req)).rows[0]
@@ -947,8 +942,7 @@ async def test_aggregations_groupby(modclient: redis.Redis):
     assert res[3] == "3"
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.sum("@random_num"),
+        "@parent", reducers.sum("@random_num")
     )
 
     res = (await modclient.ft().aggregate(req)).rows[0]
@@ -956,8 +950,7 @@ async def test_aggregations_groupby(modclient: redis.Redis):
     assert res[3] == "21"  # 10+8+3
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.min("@random_num"),
+        "@parent", reducers.min("@random_num")
     )
 
     res = (await modclient.ft().aggregate(req)).rows[0]
@@ -965,8 +958,7 @@ async def test_aggregations_groupby(modclient: redis.Redis):
     assert res[3] == "3"  # min(10,8,3)
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.max("@random_num"),
+        "@parent", reducers.max("@random_num")
     )
 
     res = (await modclient.ft().aggregate(req)).rows[0]
@@ -974,8 +966,7 @@ async def test_aggregations_groupby(modclient: redis.Redis):
     assert res[3] == "10"  # max(10,8,3)
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.avg("@random_num"),
+        "@parent", reducers.avg("@random_num")
     )
 
     res = (await modclient.ft().aggregate(req)).rows[0]
@@ -983,8 +974,7 @@ async def test_aggregations_groupby(modclient: redis.Redis):
     assert res[3] == "7"  # (10+3+8)/3
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.stddev("random_num"),
+        "@parent", reducers.stddev("random_num")
     )
 
     res = (await modclient.ft().aggregate(req)).rows[0]
@@ -992,8 +982,7 @@ async def test_aggregations_groupby(modclient: redis.Redis):
     assert res[3] == "3.60555127546"
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.quantile("@random_num", 0.5),
+        "@parent", reducers.quantile("@random_num", 0.5)
     )
 
     res = (await modclient.ft().aggregate(req)).rows[0]
@@ -1001,8 +990,7 @@ async def test_aggregations_groupby(modclient: redis.Redis):
     assert res[3] == "8"  # median of 3,8,10
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.tolist("@title"),
+        "@parent", reducers.tolist("@title")
     )
 
     res = (await modclient.ft().aggregate(req)).rows[0]
@@ -1010,16 +998,14 @@ async def test_aggregations_groupby(modclient: redis.Redis):
     assert res[3] == ["RediSearch", "RedisAI", "RedisJson"]
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.first_value("@title").alias("first"),
+        "@parent", reducers.first_value("@title").alias("first")
     )
 
     res = (await modclient.ft().aggregate(req)).rows[0]
     assert res == ["parent", "redis", "first", "RediSearch"]
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.random_sample("@title", 2).alias("random"),
+        "@parent", reducers.random_sample("@title", 2).alias("random")
     )
 
     res = (await modclient.ft().aggregate(req)).rows[0]
@@ -1031,12 +1017,7 @@ async def test_aggregations_groupby(modclient: redis.Redis):
 
 @pytest.mark.redismod
 async def test_aggregations_sort_by_and_limit(modclient: redis.Redis):
-    await modclient.ft().create_index(
-        (
-            TextField("t1"),
-            TextField("t2"),
-        )
-    )
+    await modclient.ft().create_index((TextField("t1"), TextField("t2")))
 
     await modclient.ft().client.hset("doc1", mapping={"t1": "a", "t2": "b"})
     await modclient.ft().client.hset("doc2", mapping={"t1": "b", "t2": "a"})
diff --git a/tests/test_asyncio/test_sentinel.py b/tests/test_asyncio/test_sentinel.py
index cd6810c1b5..4130e67400 100644
--- a/tests/test_asyncio/test_sentinel.py
+++ b/tests/test_asyncio/test_sentinel.py
@@ -203,7 +203,7 @@ async def test_master_for(cluster, sentinel, master_ip):
 @pytest.mark.onlynoncluster
 async def test_slave_for(cluster, sentinel):
     cluster.slaves = [
-        {"ip": "127.0.0.1", "port": 6379, "is_odown": False, "is_sdown": False},
+        {"ip": "127.0.0.1", "port": 6379, "is_odown": False, "is_sdown": False}
     ]
     slave = sentinel.slave_for("mymaster", db=9)
     assert await slave.ping()
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index de41a107dc..c74af202d8 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -44,12 +44,7 @@
 default_host = "127.0.0.1"
 default_port = 7000
 default_cluster_slots = [
-    [
-        0,
-        8191,
-        ["127.0.0.1", 7000, "node_0"],
-        ["127.0.0.1", 7003, "node_3"],
-    ],
+    [0, 8191, ["127.0.0.1", 7000, "node_0"], ["127.0.0.1", 7003, "node_3"]],
     [8192, 16383, ["127.0.0.1", 7001, "node_1"], ["127.0.0.1", 7002, "node_2"]],
 ]
 
@@ -905,16 +900,8 @@ def test_cluster_count_failure_report(self, r):
     @skip_if_redis_enterprise()
     def test_cluster_delslots(self):
         cluster_slots = [
-            [
-                0,
-                8191,
-                ["127.0.0.1", 7000, "node_0"],
-            ],
-            [
-                8192,
-                16383,
-                ["127.0.0.1", 7001, "node_1"],
-            ],
+            [0, 8191, ["127.0.0.1", 7000, "node_0"]],
+            [8192, 16383, ["127.0.0.1", 7001, "node_1"]],
         ]
         r = get_mocked_redis_client(
             host=default_host, port=default_port, cluster_slots=cluster_slots
@@ -2123,34 +2110,14 @@ def create_mocked_redis_node(host, port, **kwargs):
                 """
                 if port == 7000:
                     result = [
-                        [
-                            0,
-                            5460,
-                            ["127.0.0.1", 7000],
-                            ["127.0.0.1", 7003],
-                        ],
-                        [
-                            5461,
-                            10922,
-                            ["127.0.0.1", 7001],
-                            ["127.0.0.1", 7004],
-                        ],
+                        [0, 5460, ["127.0.0.1", 7000], ["127.0.0.1", 7003]],
+                        [5461, 10922, ["127.0.0.1", 7001], ["127.0.0.1", 7004]],
                     ]
 
                 elif port == 7001:
                     result = [
-                        [
-                            0,
-                            5460,
-                            ["127.0.0.1", 7001],
-                            ["127.0.0.1", 7003],
-                        ],
-                        [
-                            5461,
-                            10922,
-                            ["127.0.0.1", 7000],
-                            ["127.0.0.1", 7004],
-                        ],
+                        [0, 5460, ["127.0.0.1", 7001], ["127.0.0.1", 7003]],
+                        [5461, 10922, ["127.0.0.1", 7000], ["127.0.0.1", 7004]],
                     ]
                 else:
                     result = []
@@ -2217,16 +2184,8 @@ def create_mocked_redis_node(host, port, **kwargs):
                 def execute_command(*args, **kwargs):
                     if args[0] == "CLUSTER SLOTS":
                         return [
-                            [
-                                0,
-                                8191,
-                                ["127.0.0.1", 7001, "node_1"],
-                            ],
-                            [
-                                8192,
-                                16383,
-                                ["127.0.0.1", 7002, "node_2"],
-                            ],
+                            [0, 8191, ["127.0.0.1", 7001, "node_1"]],
+                            [8192, 16383, ["127.0.0.1", 7002, "node_2"]],
                         ]
                     elif args[0] == "INFO":
                         return {"cluster_enabled": True}
@@ -2673,10 +2632,7 @@ def test_pipeline_readonly(self, r):
 
         with r.pipeline() as readonly_pipe:
             readonly_pipe.get("foo71").zrange("foo88", 0, 5, withscores=True)
-            assert readonly_pipe.execute() == [
-                b"a1",
-                [(b"z1", 1.0), (b"z2", 4)],
-            ]
+            assert readonly_pipe.execute() == [b"a1", [(b"z1", 1.0), (b"z2", 4)]]
 
     def test_moved_redirection_on_slave_with_default(self, r):
         """
diff --git a/tests/test_command_parser.py b/tests/test_command_parser.py
index 1457e27531..134909fdcd 100644
--- a/tests/test_command_parser.py
+++ b/tests/test_command_parser.py
@@ -75,13 +75,7 @@ def test_get_moveable_keys(self, r):
     @skip_if_server_version_lt("7.0.0")
     def test_get_eval_keys_with_0_keys(self, r):
         commands_parser = CommandsParser(r)
-        args = [
-            "EVAL",
-            "return {ARGV[1],ARGV[2]}",
-            0,
-            "key1",
-            "key2",
-        ]
+        args = ["EVAL", "return {ARGV[1],ARGV[2]}", 0, "key1", "key2"]
         assert commands_parser.get_keys(r, *args) == []
 
     def test_get_pubsub_keys(self, r):
diff --git a/tests/test_commands.py b/tests/test_commands.py
index a3972a5f22..d4a564c0ad 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -89,10 +89,7 @@ def teardown():
         request.addfinalizer(teardown)
 
         assert r.acl_setuser(
-            username,
-            enabled=True,
-            passwords=["+strong_password"],
-            commands=["+acl"],
+            username, enabled=True, passwords=["+strong_password"], commands=["+acl"]
         )
 
         assert r.auth(username=username, password="strong_password") is True
@@ -128,11 +125,7 @@ def teardown():
 
         request.addfinalizer(teardown)
 
-        r.acl_setuser(
-            username,
-            keys=["*"],
-            commands=["+set"],
-        )
+        r.acl_setuser(username, keys=["*"], commands=["+set"])
         assert r.acl_dryrun(username, "set", "key", "value") == b"OK"
         assert r.acl_dryrun(username, "get", "key").startswith(
             b"This user has no permissions to run the"
@@ -3360,18 +3353,15 @@ def test_geosearch_with(self, r):
                 (2.19093829393386841, 41.43379028184083523),
             ]
         ]
-        assert (
-            r.geosearch(
-                "barcelona",
-                longitude=2.191,
-                latitude=41.433,
-                radius=1,
-                unit="km",
-                withdist=True,
-                withcoord=True,
-            )
-            == [[b"place1", 0.0881, (2.19093829393386841, 41.43379028184083523)]]
-        )
+        assert r.geosearch(
+            "barcelona",
+            longitude=2.191,
+            latitude=41.433,
+            radius=1,
+            unit="km",
+            withdist=True,
+            withcoord=True,
+        ) == [[b"place1", 0.0881, (2.19093829393386841, 41.43379028184083523)]]
         assert r.geosearch(
             "barcelona",
             longitude=2.191,
@@ -3701,7 +3691,7 @@ def test_xack(self, r):
     def test_xadd(self, r):
         stream = "stream"
         message_id = r.xadd(stream, {"foo": "bar"})
-        assert re.match(br"[0-9]+\-[0-9]+", message_id)
+        assert re.match(rb"[0-9]+\-[0-9]+", message_id)
 
         # explicit message id
         message_id = b"9999999999999999999-0"
@@ -3847,17 +3837,14 @@ def test_xclaim(self, r):
 
         # reclaim the message as consumer1, but use the justid argument
         # which only returns message ids
-        assert (
-            r.xclaim(
-                stream,
-                group,
-                consumer1,
-                min_idle_time=0,
-                message_ids=(message_id,),
-                justid=True,
-            )
-            == [message_id]
-        )
+        assert r.xclaim(
+            stream,
+            group,
+            consumer1,
+            min_idle_time=0,
+            message_ids=(message_id,),
+            justid=True,
+        ) == [message_id]
 
     @skip_if_server_version_lt("7.0.0")
     def test_xclaim_trimmed(self, r):
@@ -4228,34 +4215,17 @@ def test_xread(self, r):
         expected = [
             [
                 stream.encode(),
-                [
-                    get_stream_message(r, stream, m1),
-                    get_stream_message(r, stream, m2),
-                ],
+                [get_stream_message(r, stream, m1), get_stream_message(r, stream, m2)],
             ]
         ]
         # xread starting at 0 returns both messages
         assert r.xread(streams={stream: 0}) == expected
 
-        expected = [
-            [
-                stream.encode(),
-                [
-                    get_stream_message(r, stream, m1),
-                ],
-            ]
-        ]
+        expected = [[stream.encode(), [get_stream_message(r, stream, m1)]]]
         # xread starting at 0 and count=1 returns only the first message
         assert r.xread(streams={stream: 0}, count=1) == expected
 
-        expected = [
-            [
-                stream.encode(),
-                [
-                    get_stream_message(r, stream, m2),
-                ],
-            ]
-        ]
+        expected = [[stream.encode(), [get_stream_message(r, stream, m2)]]]
         # xread starting at m1 returns only the second message
         assert r.xread(streams={stream: m1}) == expected
 
@@ -4274,10 +4244,7 @@ def test_xreadgroup(self, r):
         expected = [
             [
                 stream.encode(),
-                [
-                    get_stream_message(r, stream, m1),
-                    get_stream_message(r, stream, m2),
-                ],
+                [get_stream_message(r, stream, m1), get_stream_message(r, stream, m2)],
             ]
         ]
         # xread starting at 0 returns both messages
@@ -4286,14 +4253,7 @@ def test_xreadgroup(self, r):
         r.xgroup_destroy(stream, group)
         r.xgroup_create(stream, group, 0)
 
-        expected = [
-            [
-                stream.encode(),
-                [
-                    get_stream_message(r, stream, m1),
-                ],
-            ]
-        ]
+        expected = [[stream.encode(), [get_stream_message(r, stream, m1)]]]
         # xread with count=1 returns only the first message
         assert r.xreadgroup(group, consumer, streams={stream: ">"}, count=1) == expected
 
@@ -4320,15 +4280,7 @@ def test_xreadgroup(self, r):
         r.xgroup_destroy(stream, group)
         r.xgroup_create(stream, group, "0")
         # delete all the messages in the stream
-        expected = [
-            [
-                stream.encode(),
-                [
-                    (m1, {}),
-                    (m2, {}),
-                ],
-            ]
-        ]
+        expected = [[stream.encode(), [(m1, {}), (m2, {})]]]
         r.xreadgroup(group, consumer, streams={stream: ">"})
         r.xtrim(stream, 0)
         assert r.xreadgroup(group, consumer, streams={stream: "0"}) == expected
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 3e1fbaed27..a836f5b2c7 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -202,33 +202,23 @@ class TestConnectionPoolURLParsing:
     def test_hostname(self):
         pool = redis.ConnectionPool.from_url("redis://my.host")
         assert pool.connection_class == redis.Connection
-        assert pool.connection_kwargs == {
-            "host": "my.host",
-        }
+        assert pool.connection_kwargs == {"host": "my.host"}
 
     def test_quoted_hostname(self):
         pool = redis.ConnectionPool.from_url("redis://my %2F host %2B%3D+")
         assert pool.connection_class == redis.Connection
-        assert pool.connection_kwargs == {
-            "host": "my / host +=+",
-        }
+        assert pool.connection_kwargs == {"host": "my / host +=+"}
 
     def test_port(self):
         pool = redis.ConnectionPool.from_url("redis://localhost:6380")
         assert pool.connection_class == redis.Connection
-        assert pool.connection_kwargs == {
-            "host": "localhost",
-            "port": 6380,
-        }
+        assert pool.connection_kwargs == {"host": "localhost", "port": 6380}
 
     @skip_if_server_version_lt("6.0.0")
     def test_username(self):
         pool = redis.ConnectionPool.from_url("redis://myuser:@localhost")
         assert pool.connection_class == redis.Connection
-        assert pool.connection_kwargs == {
-            "host": "localhost",
-            "username": "myuser",
-        }
+        assert pool.connection_kwargs == {"host": "localhost", "username": "myuser"}
 
     @skip_if_server_version_lt("6.0.0")
     def test_quoted_username(self):
@@ -244,10 +234,7 @@ def test_quoted_username(self):
     def test_password(self):
         pool = redis.ConnectionPool.from_url("redis://:mypassword@localhost")
         assert pool.connection_class == redis.Connection
-        assert pool.connection_kwargs == {
-            "host": "localhost",
-            "password": "mypassword",
-        }
+        assert pool.connection_kwargs == {"host": "localhost", "password": "mypassword"}
 
     def test_quoted_password(self):
         pool = redis.ConnectionPool.from_url(
@@ -272,26 +259,17 @@ def test_username_and_password(self):
     def test_db_as_argument(self):
         pool = redis.ConnectionPool.from_url("redis://localhost", db=1)
         assert pool.connection_class == redis.Connection
-        assert pool.connection_kwargs == {
-            "host": "localhost",
-            "db": 1,
-        }
+        assert pool.connection_kwargs == {"host": "localhost", "db": 1}
 
     def test_db_in_path(self):
         pool = redis.ConnectionPool.from_url("redis://localhost/2", db=1)
         assert pool.connection_class == redis.Connection
-        assert pool.connection_kwargs == {
-            "host": "localhost",
-            "db": 2,
-        }
+        assert pool.connection_kwargs == {"host": "localhost", "db": 2}
 
     def test_db_in_querystring(self):
         pool = redis.ConnectionPool.from_url("redis://localhost/2?db=3", db=1)
         assert pool.connection_class == redis.Connection
-        assert pool.connection_kwargs == {
-            "host": "localhost",
-            "db": 3,
-        }
+        assert pool.connection_kwargs == {"host": "localhost", "db": 3}
 
     def test_extra_typed_querystring_options(self):
         pool = redis.ConnectionPool.from_url(
@@ -351,9 +329,7 @@ def test_calling_from_subclass_returns_correct_instance(self):
     def test_client_creates_connection_pool(self):
         r = redis.Redis.from_url("redis://myhost")
         assert r.connection_pool.connection_class == redis.Connection
-        assert r.connection_pool.connection_kwargs == {
-            "host": "myhost",
-        }
+        assert r.connection_pool.connection_kwargs == {"host": "myhost"}
 
     def test_invalid_scheme_raises_error(self):
         with pytest.raises(ValueError) as cm:
@@ -368,18 +344,13 @@ class TestConnectionPoolUnixSocketURLParsing:
     def test_defaults(self):
         pool = redis.ConnectionPool.from_url("unix:///socket")
         assert pool.connection_class == redis.UnixDomainSocketConnection
-        assert pool.connection_kwargs == {
-            "path": "/socket",
-        }
+        assert pool.connection_kwargs == {"path": "/socket"}
 
     @skip_if_server_version_lt("6.0.0")
     def test_username(self):
         pool = redis.ConnectionPool.from_url("unix://myuser:@/socket")
         assert pool.connection_class == redis.UnixDomainSocketConnection
-        assert pool.connection_kwargs == {
-            "path": "/socket",
-            "username": "myuser",
-        }
+        assert pool.connection_kwargs == {"path": "/socket", "username": "myuser"}
 
     @skip_if_server_version_lt("6.0.0")
     def test_quoted_username(self):
@@ -395,10 +366,7 @@ def test_quoted_username(self):
     def test_password(self):
         pool = redis.ConnectionPool.from_url("unix://:mypassword@/socket")
         assert pool.connection_class == redis.UnixDomainSocketConnection
-        assert pool.connection_kwargs == {
-            "path": "/socket",
-            "password": "mypassword",
-        }
+        assert pool.connection_kwargs == {"path": "/socket", "password": "mypassword"}
 
     def test_quoted_password(self):
         pool = redis.ConnectionPool.from_url(
@@ -423,18 +391,12 @@ def test_quoted_path(self):
     def test_db_as_argument(self):
         pool = redis.ConnectionPool.from_url("unix:///socket", db=1)
         assert pool.connection_class == redis.UnixDomainSocketConnection
-        assert pool.connection_kwargs == {
-            "path": "/socket",
-            "db": 1,
-        }
+        assert pool.connection_kwargs == {"path": "/socket", "db": 1}
 
     def test_db_in_querystring(self):
         pool = redis.ConnectionPool.from_url("unix:///socket?db=2", db=1)
         assert pool.connection_class == redis.UnixDomainSocketConnection
-        assert pool.connection_kwargs == {
-            "path": "/socket",
-            "db": 2,
-        }
+        assert pool.connection_kwargs == {"path": "/socket", "db": 2}
 
     def test_client_name_in_querystring(self):
         pool = redis.ConnectionPool.from_url("redis://location?client_name=test-client")
@@ -460,9 +422,7 @@ class TestSSLConnectionURLParsing:
     def test_host(self):
         pool = redis.ConnectionPool.from_url("rediss://my.host")
         assert pool.connection_class == redis.SSLConnection
-        assert pool.connection_kwargs == {
-            "host": "my.host",
-        }
+        assert pool.connection_kwargs == {"host": "my.host"}
 
     def test_connection_class_override(self):
         class MyConnection(redis.SSLConnection):
diff --git a/tests/test_encoding.py b/tests/test_encoding.py
index bd0f09fcc0..d7d1fb106d 100644
--- a/tests/test_encoding.py
+++ b/tests/test_encoding.py
@@ -13,11 +13,7 @@ def r(self, request):
 
     @pytest.fixture()
     def r_no_decode(self, request):
-        return _get_client(
-            redis.Redis,
-            request=request,
-            decode_responses=False,
-        )
+        return _get_client(redis.Redis, request=request, decode_responses=False)
 
     def test_simple_encoding(self, r_no_decode):
         unicode_string = chr(3456) + "abcd" + chr(3421)
diff --git a/tests/test_function.py b/tests/test_function.py
index e6c4bcd586..70f6b19869 100644
--- a/tests/test_function.py
+++ b/tests/test_function.py
@@ -63,7 +63,7 @@ def test_function_list(self, r):
                 "LUA",
                 "functions",
                 [["name", "myfunc", "description", None, "flags", ["no-writes"]]],
-            ],
+            ]
         ]
         assert r.function_list() == res
         assert r.function_list(library="*lib") == res
@@ -83,7 +83,7 @@ def test_function_list_on_cluster(self, r):
                 "LUA",
                 "functions",
                 [["name", "myfunc", "description", None, "flags", ["no-writes"]]],
-            ],
+            ]
         ]
         primaries = r.get_primaries()
         res = {}
diff --git a/tests/test_json.py b/tests/test_json.py
index 2b754564bc..1cc448c5f9 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -171,16 +171,7 @@ def test_arrindex(client):
 @pytest.mark.redismod
 def test_arrinsert(client):
     client.json().set("arr", Path.root_path(), [0, 4])
-    assert 5 - -client.json().arrinsert(
-        "arr",
-        Path.root_path(),
-        1,
-        *[
-            1,
-            2,
-            3,
-        ],
-    )
+    assert 5 - -client.json().arrinsert("arr", Path.root_path(), 1, *[1, 2, 3])
     assert [0, 1, 2, 3, 4] == client.json().get("arr")
 
     # test prepends
@@ -1011,10 +1002,8 @@ def test_resp_dollar(client):
                     ],
                     "A1_B3_C3": [1],
                 },
-                "A1_B4": {
-                    "A1_B4_C1": "foo",
-                },
-            },
+                "A1_B4": {"A1_B4_C1": "foo"},
+            }
         },
         "L2": {
             "a": {
@@ -1032,10 +1021,8 @@ def test_resp_dollar(client):
                     ],
                     "A2_B3_C3": [2],
                 },
-                "A2_B4": {
-                    "A2_B4_C1": "bar",
-                },
-            },
+                "A2_B4": {"A2_B4_C1": "bar"},
+            }
         },
     }
     client.json().set("doc1", "$", data)
diff --git a/tests/test_pipeline.py b/tests/test_pipeline.py
index 0518893f07..03377d8350 100644
--- a/tests/test_pipeline.py
+++ b/tests/test_pipeline.py
@@ -33,10 +33,7 @@ def test_pipeline(self, r):
     def test_pipeline_memoryview(self, r):
         with r.pipeline() as pipe:
             (pipe.set("a", memoryview(b"a1")).get("a"))
-            assert pipe.execute() == [
-                True,
-                b"a1",
-            ]
+            assert pipe.execute() == [True, b"a1"]
 
     def test_pipeline_length(self, r):
         with r.pipeline() as pipe:
diff --git a/tests/test_search.py b/tests/test_search.py
index aee37cdd6f..dba914aeaa 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -888,18 +888,14 @@ def test_aggregations_groupby(client):
         random_num=8,
     )
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.count(),
-    )
+    req = aggregations.AggregateRequest("redis").group_by("@parent", reducers.count())
 
     res = client.ft().aggregate(req).rows[0]
     assert res[1] == "redis"
     assert res[3] == "3"
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.count_distinct("@title"),
+        "@parent", reducers.count_distinct("@title")
     )
 
     res = client.ft().aggregate(req).rows[0]
@@ -907,8 +903,7 @@ def test_aggregations_groupby(client):
     assert res[3] == "3"
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.count_distinctish("@title"),
+        "@parent", reducers.count_distinctish("@title")
     )
 
     res = client.ft().aggregate(req).rows[0]
@@ -916,8 +911,7 @@ def test_aggregations_groupby(client):
     assert res[3] == "3"
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.sum("@random_num"),
+        "@parent", reducers.sum("@random_num")
     )
 
     res = client.ft().aggregate(req).rows[0]
@@ -925,8 +919,7 @@ def test_aggregations_groupby(client):
     assert res[3] == "21"  # 10+8+3
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.min("@random_num"),
+        "@parent", reducers.min("@random_num")
     )
 
     res = client.ft().aggregate(req).rows[0]
@@ -934,8 +927,7 @@ def test_aggregations_groupby(client):
     assert res[3] == "3"  # min(10,8,3)
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.max("@random_num"),
+        "@parent", reducers.max("@random_num")
     )
 
     res = client.ft().aggregate(req).rows[0]
@@ -943,8 +935,7 @@ def test_aggregations_groupby(client):
     assert res[3] == "10"  # max(10,8,3)
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.avg("@random_num"),
+        "@parent", reducers.avg("@random_num")
     )
 
     res = client.ft().aggregate(req).rows[0]
@@ -953,8 +944,7 @@ def test_aggregations_groupby(client):
     assert res[index + 1] == "7"  # (10+3+8)/3
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.stddev("random_num"),
+        "@parent", reducers.stddev("random_num")
     )
 
     res = client.ft().aggregate(req).rows[0]
@@ -962,8 +952,7 @@ def test_aggregations_groupby(client):
     assert res[3] == "3.60555127546"
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.quantile("@random_num", 0.5),
+        "@parent", reducers.quantile("@random_num", 0.5)
     )
 
     res = client.ft().aggregate(req).rows[0]
@@ -971,8 +960,7 @@ def test_aggregations_groupby(client):
     assert res[3] == "8"  # median of 3,8,10
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.tolist("@title"),
+        "@parent", reducers.tolist("@title")
     )
 
     res = client.ft().aggregate(req).rows[0]
@@ -980,16 +968,14 @@ def test_aggregations_groupby(client):
     assert res[3] == ["RediSearch", "RedisAI", "RedisJson"]
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.first_value("@title").alias("first"),
+        "@parent", reducers.first_value("@title").alias("first")
     )
 
     res = client.ft().aggregate(req).rows[0]
     assert res == ["parent", "redis", "first", "RediSearch"]
 
     req = aggregations.AggregateRequest("redis").group_by(
-        "@parent",
-        reducers.random_sample("@title", 2).alias("random"),
+        "@parent", reducers.random_sample("@title", 2).alias("random")
     )
 
     res = client.ft().aggregate(req).rows[0]
@@ -1001,12 +987,7 @@ def test_aggregations_groupby(client):
 
 @pytest.mark.redismod
 def test_aggregations_sort_by_and_limit(client):
-    client.ft().create_index(
-        (
-            TextField("t1"),
-            TextField("t2"),
-        )
-    )
+    client.ft().create_index((TextField("t1"), TextField("t2")))
 
     client.ft().client.hset("doc1", mapping={"t1": "a", "t2": "b"})
     client.ft().client.hset("doc2", mapping={"t1": "b", "t2": "a"})
@@ -1039,12 +1020,7 @@ def test_aggregations_sort_by_and_limit(client):
 
 @pytest.mark.redismod
 def test_aggregations_load(client):
-    client.ft().create_index(
-        (
-            TextField("t1"),
-            TextField("t2"),
-        )
-    )
+    client.ft().create_index((TextField("t1"), TextField("t2")))
 
     client.ft().client.hset("doc1", mapping={"t1": "hello", "t2": "world"})
 
@@ -1093,10 +1069,7 @@ def test_aggregations_apply(client):
 @pytest.mark.redismod
 def test_aggregations_filter(client):
     client.ft().create_index(
-        (
-            TextField("name", sortable=True),
-            NumericField("age", sortable=True),
-        )
+        (TextField("name", sortable=True), NumericField("age", sortable=True))
     )
 
     client.ft().client.hset("doc1", mapping={"name": "bar", "age": "25"})
@@ -1341,10 +1314,7 @@ def test_search_return_fields(client):
 
     # create index on
     definition = IndexDefinition(index_type=IndexType.JSON)
-    SCHEMA = (
-        TextField("$.t"),
-        NumericField("$.flt"),
-    )
+    SCHEMA = (TextField("$.t"), NumericField("$.flt"))
     client.ft().create_index(SCHEMA, definition=definition)
     waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
@@ -1363,11 +1333,7 @@ def test_search_return_fields(client):
 def test_synupdate(client):
     definition = IndexDefinition(index_type=IndexType.HASH)
     client.ft().create_index(
-        (
-            TextField("title"),
-            TextField("body"),
-        ),
-        definition=definition,
+        (TextField("title"), TextField("body")), definition=definition
     )
 
     client.ft().synupdate("id1", True, "boy", "child", "offspring")
@@ -1386,11 +1352,7 @@ def test_synupdate(client):
 def test_syndump(client):
     definition = IndexDefinition(index_type=IndexType.HASH)
     client.ft().create_index(
-        (
-            TextField("title"),
-            TextField("body"),
-        ),
-        definition=definition,
+        (TextField("title"), TextField("body")), definition=definition
     )
 
     client.ft().synupdate("id1", False, "boy", "child", "offspring")
diff --git a/tests/test_sentinel.py b/tests/test_sentinel.py
index 0357443a14..8542a0bfc3 100644
--- a/tests/test_sentinel.py
+++ b/tests/test_sentinel.py
@@ -188,7 +188,7 @@ def test_master_for(cluster, sentinel, master_ip):
 @pytest.mark.onlynoncluster
 def test_slave_for(cluster, sentinel):
     cluster.slaves = [
-        {"ip": "127.0.0.1", "port": 6379, "is_odown": False, "is_sdown": False},
+        {"ip": "127.0.0.1", "port": 6379, "is_odown": False, "is_sdown": False}
     ]
     slave = sentinel.slave_for("mymaster", db=9)
     assert slave.ping()

From bac33d4a92892ca7982b461347151bff5a661f0d Mon Sep 17 00:00:00 2001
From: Utkarsh Gupta <utkarshgupta137@gmail.com>
Date: Mon, 30 May 2022 21:45:45 +0530
Subject: [PATCH 0502/1164] async_cluster: add pipeline support (#2199)

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 docs/connections.rst                |   5 +
 redis/asyncio/cluster.py            | 328 ++++++++++++++++++++++++++--
 redis/cluster.py                    | 114 +++++++---
 tests/test_asyncio/test_cluster.py  | 254 ++++++++++++++++++++-
 tests/test_asyncio/test_pipeline.py |   7 +-
 5 files changed, 652 insertions(+), 56 deletions(-)

diff --git a/docs/connections.rst b/docs/connections.rst
index e4b82cdc50..b481689b9b 100644
--- a/docs/connections.rst
+++ b/docs/connections.rst
@@ -76,6 +76,11 @@ ClusterNode (Async)
 .. autoclass:: redis.asyncio.cluster.ClusterNode
     :members:
 
+ClusterPipeline (Async)
+===================
+.. autoclass:: redis.asyncio.cluster.ClusterPipeline
+    :members:
+
 
 Connection
 **********
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 39aa536de1..3405a499c2 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -3,19 +3,32 @@
 import random
 import socket
 import warnings
-from typing import Any, Deque, Dict, Generator, List, Optional, Type, TypeVar, Union
+from typing import (
+    Any,
+    Deque,
+    Dict,
+    Generator,
+    List,
+    Mapping,
+    Optional,
+    Type,
+    TypeVar,
+    Union,
+)
 
 from redis.asyncio.client import ResponseCallbackT
 from redis.asyncio.connection import Connection, DefaultParser, Encoder, parse_url
 from redis.asyncio.parser import CommandsParser
 from redis.client import EMPTY_RESPONSE, NEVER_DECODE, AbstractRedis
 from redis.cluster import (
+    PIPELINE_BLOCKED_COMMANDS,
     PRIMARY,
     READ_COMMANDS,
     REPLICA,
     SLOT_ID,
     AbstractRedisCluster,
     LoadBalancer,
+    block_pipeline_command,
     get_node_name,
     parse_cluster_slots,
 )
@@ -37,8 +50,8 @@
     TimeoutError,
     TryAgainError,
 )
-from redis.typing import EncodableT, KeyT
-from redis.utils import dict_merge, str_if_bytes
+from redis.typing import AnyKeyT, EncodableT, KeyT
+from redis.utils import dict_merge, safe_str, str_if_bytes
 
 TargetNodesT = TypeVar(
     "TargetNodesT", str, "ClusterNode", List["ClusterNode"], Dict[Any, "ClusterNode"]
@@ -719,6 +732,24 @@ async def _execute_command(
 
         raise ClusterError("TTL exhausted.")
 
+    def pipeline(
+        self, transaction: Optional[Any] = None, shard_hint: Optional[Any] = None
+    ) -> "ClusterPipeline":
+        """
+        Create & return a new :class:`~.ClusterPipeline` object.
+
+        Cluster implementation of pipeline does not support transaction or shard_hint.
+
+        :raises RedisClusterException: if transaction or shard_hint are truthy values
+        """
+        if shard_hint:
+            raise RedisClusterException("shard_hint is deprecated in cluster mode")
+
+        if transaction:
+            raise RedisClusterException("transaction is deprecated in cluster mode")
+
+        return ClusterPipeline(self)
+
 
 class ClusterNode:
     """
@@ -729,6 +760,7 @@ class ClusterNode:
     """
 
     __slots__ = (
+        "_command_stack",
         "_connections",
         "_free",
         "connection_class",
@@ -768,6 +800,7 @@ def __init__(
 
         self._connections: List[Connection] = []
         self._free: Deque[Connection] = collections.deque(maxlen=self.max_connections)
+        self._command_stack: List["PipelineCommand"] = []
 
     def __repr__(self) -> str:
         return (
@@ -806,27 +839,26 @@ async def disconnect(self) -> None:
         if exc:
             raise exc
 
-    async def execute_command(self, *args: Any, **kwargs: Any) -> Any:
-        # Acquire connection
-        connection = None
+    def acquire_connection(self) -> Connection:
         if self._free:
             for _ in range(len(self._free)):
                 connection = self._free.popleft()
                 if connection.is_connected:
-                    break
+                    return connection
                 self._free.append(connection)
-            else:
-                connection = self._free.popleft()
+
+            return self._free.popleft()
         else:
             if len(self._connections) < self.max_connections:
                 connection = self.connection_class(**self.connection_kwargs)
                 self._connections.append(connection)
+                return connection
             else:
                 raise ConnectionError("Too many connections")
 
-        # Execute command
-        command = connection.pack_command(*args)
-        await connection.send_packed_command(command, False)
+    async def parse_response(
+        self, connection: Connection, command: str, **kwargs: Any
+    ) -> Any:
         try:
             if NEVER_DECODE in kwargs:
                 response = await connection.read_response_without_lock(
@@ -838,16 +870,49 @@ async def execute_command(self, *args: Any, **kwargs: Any) -> Any:
             if EMPTY_RESPONSE in kwargs:
                 return kwargs[EMPTY_RESPONSE]
             raise
-        finally:
-            # Release connection
-            self._free.append(connection)
 
         # Return response
         try:
-            return self.response_callbacks[args[0]](response, **kwargs)
+            return self.response_callbacks[command](response, **kwargs)
         except KeyError:
             return response
 
+    async def execute_command(self, *args: Any, **kwargs: Any) -> Any:
+        # Acquire connection
+        connection = self.acquire_connection()
+
+        # Execute command
+        await connection.send_packed_command(connection.pack_command(*args), False)
+
+        # Read response
+        try:
+            return await self.parse_response(connection, args[0], **kwargs)
+        finally:
+            # Release connection
+            self._free.append(connection)
+
+    async def execute_pipeline(self) -> None:
+        # Acquire connection
+        connection = self.acquire_connection()
+
+        # Execute command
+        await connection.send_packed_command(
+            connection.pack_commands(cmd.args for cmd in self._command_stack), False
+        )
+
+        # Read responses
+        try:
+            for cmd in self._command_stack:
+                try:
+                    cmd.result = await self.parse_response(
+                        connection, cmd.args[0], **cmd.kwargs
+                    )
+                except Exception as e:
+                    cmd.result = e
+        finally:
+            # Release connection
+            self._free.append(connection)
+
 
 class NodesManager:
     __slots__ = (
@@ -1131,3 +1196,234 @@ async def close(self, attr: str = "nodes_cache") -> None:
                 for node in getattr(self, attr).values()
             )
         )
+
+
+class ClusterPipeline(AbstractRedis, AbstractRedisCluster, AsyncRedisClusterCommands):
+    """
+    Create a new ClusterPipeline object.
+
+    Usage::
+
+        result = await (
+            rc.pipeline()
+            .set("A", 1)
+            .get("A")
+            .hset("K", "F", "V")
+            .hgetall("K")
+            .mset_nonatomic({"A": 2, "B": 3})
+            .get("A")
+            .get("B")
+            .delete("A", "B", "K")
+            .execute()
+        )
+        # result = [True, "1", 1, {"F": "V"}, True, True, "2", "3", 1, 1, 1]
+
+    Note: For commands `DELETE`, `EXISTS`, `TOUCH`, `UNLINK`, `mset_nonatomic`, which
+    are split across multiple nodes, you'll get multiple results for them in the array.
+
+    Retryable errors:
+        - :class:`~.ClusterDownError`
+        - :class:`~.ConnectionError`
+        - :class:`~.TimeoutError`
+
+    Redirection errors:
+        - :class:`~.TryAgainError`
+        - :class:`~.MovedError`
+        - :class:`~.AskError`
+
+    :param client:
+        | Existing :class:`~.RedisCluster` client
+    """
+
+    __slots__ = ("_command_stack", "_client")
+
+    def __init__(self, client: RedisCluster) -> None:
+        self._client = client
+
+        self._command_stack: List["PipelineCommand"] = []
+
+    async def initialize(self) -> "ClusterPipeline":
+        if self._client._initialize:
+            await self._client.initialize()
+        self._command_stack = []
+        return self
+
+    async def __aenter__(self) -> "ClusterPipeline":
+        return await self.initialize()
+
+    async def __aexit__(self, exc_type: None, exc_value: None, traceback: None) -> None:
+        self._command_stack = []
+
+    def __await__(self) -> Generator[Any, None, "ClusterPipeline"]:
+        return self.initialize().__await__()
+
+    def __bool__(self) -> bool:
+        return bool(self._command_stack)
+
+    def __len__(self) -> int:
+        return len(self._command_stack)
+
+    def execute_command(
+        self, *args: Union[KeyT, EncodableT], **kwargs: Any
+    ) -> "ClusterPipeline":
+        """
+        Append a raw command to the pipeline.
+
+        :param args:
+            | Raw command args
+        :param kwargs:
+
+            - target_nodes: :attr:`NODE_FLAGS` or :class:`~.ClusterNode`
+              or List[:class:`~.ClusterNode`] or Dict[Any, :class:`~.ClusterNode`]
+            - Rest of the kwargs are passed to the Redis connection
+        """
+        self._command_stack.append(
+            PipelineCommand(len(self._command_stack), *args, **kwargs)
+        )
+        return self
+
+    async def execute(
+        self, raise_on_error: bool = True, allow_redirections: bool = True
+    ) -> List[Any]:
+        """
+        Execute the pipeline.
+
+        It will retry the commands as specified by :attr:`cluster_error_retry_attempts`
+        & then raise an exception.
+
+        :param raise_on_error:
+            | Raise the first error if there are any errors
+        :param allow_redirections:
+            | Whether to retry each failed command individually in case of redirection
+              errors
+
+        :raises RedisClusterException: if target_nodes is not provided & the command
+            can't be mapped to a slot
+        """
+        if not self._command_stack:
+            return []
+
+        try:
+            for _ in range(self._client.cluster_error_retry_attempts):
+                if self._client._initialize:
+                    await self._client.initialize()
+
+                try:
+                    return await self._execute(
+                        self._command_stack,
+                        raise_on_error=raise_on_error,
+                        allow_redirections=allow_redirections,
+                    )
+                except BaseException as e:
+                    if type(e) in self.__class__.ERRORS_ALLOW_RETRY:
+                        # Try again with the new cluster setup.
+                        exception = e
+                        await self._client.close()
+                        await asyncio.sleep(0.25)
+                    else:
+                        # All other errors should be raised.
+                        raise e
+
+            # If it fails the configured number of times then raise an exception
+            raise exception
+        finally:
+            self._command_stack = []
+
+    async def _execute(
+        self,
+        stack: List["PipelineCommand"],
+        raise_on_error: bool = True,
+        allow_redirections: bool = True,
+    ) -> List[Any]:
+        client = self._client
+        nodes = {}
+        for cmd in stack:
+            if not cmd.result or isinstance(cmd.result, Exception):
+                target_nodes = await client._determine_nodes(*cmd.args)
+                if not target_nodes:
+                    raise RedisClusterException(
+                        f"No targets were found to execute {cmd.args} command on"
+                    )
+                if len(target_nodes) > 1:
+                    raise RedisClusterException(
+                        f"Too many targets for command {cmd.args}"
+                    )
+
+                node = target_nodes[0]
+                if node.name not in nodes:
+                    nodes[node.name] = node
+                    node._command_stack = []
+                node._command_stack.append(cmd)
+
+        await asyncio.gather(
+            *(asyncio.ensure_future(node.execute_pipeline()) for node in nodes.values())
+        )
+
+        if allow_redirections:
+            # send each errored command individually
+            for cmd in stack:
+                if isinstance(cmd.result, (TryAgainError, MovedError, AskError)):
+                    try:
+                        cmd.result = await client.execute_command(
+                            *cmd.args, **cmd.kwargs
+                        )
+                    except Exception as e:
+                        cmd.result = e
+
+        responses = [cmd.result for cmd in stack]
+
+        if raise_on_error:
+            for cmd in stack:
+                result = cmd.result
+                if isinstance(result, Exception):
+                    command = " ".join(map(safe_str, cmd.args))
+                    msg = (
+                        f"Command # {cmd.position + 1} ({command}) of pipeline "
+                        f"caused error: {result.args}"
+                    )
+                    result.args = (msg,) + result.args[1:]
+                    raise result
+
+        return responses
+
+    def _split_command_across_slots(
+        self, command: str, *keys: KeyT
+    ) -> "ClusterPipeline":
+        for slot_keys in self._client._partition_keys_by_slot(keys).values():
+            self.execute_command(command, *slot_keys)
+
+        return self
+
+    def mset_nonatomic(
+        self, mapping: Mapping[AnyKeyT, EncodableT]
+    ) -> "ClusterPipeline":
+        encoder = self._client.encoder
+
+        slots_pairs = {}
+        for pair in mapping.items():
+            slot = key_slot(encoder.encode(pair[0]))
+            slots_pairs.setdefault(slot, []).extend(pair)
+
+        for pairs in slots_pairs.values():
+            self.execute_command("MSET", *pairs)
+
+        return self
+
+
+for command in PIPELINE_BLOCKED_COMMANDS:
+    command = command.replace(" ", "_").lower()
+    if command == "mset_nonatomic":
+        continue
+
+    setattr(ClusterPipeline, command, block_pipeline_command(command))
+
+
+class PipelineCommand:
+    def __init__(self, position: int, *args: Any, **kwargs: Any) -> None:
+        self.args = args
+        self.kwargs = kwargs
+        self.position = position
+        self.result: Union[Any, Exception] = None
+
+    def __repr__(self) -> str:
+        return f"[{self.position}] {self.args} ({self.kwargs})"
diff --git a/redis/cluster.py b/redis/cluster.py
index 46a96a6a02..2e310634d6 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -6,7 +6,7 @@
 import threading
 import time
 from collections import OrderedDict
-from typing import Any, Dict, Tuple
+from typing import Any, Callable, Dict, Tuple
 
 from redis.client import CaseInsensitiveDict, PubSub, Redis, parse_scan
 from redis.commands import CommandsParser, RedisClusterCommands
@@ -2130,7 +2130,7 @@ def delete(self, *names):
         return self.execute_command("DEL", names[0])
 
 
-def block_pipeline_command(func):
+def block_pipeline_command(name: str) -> Callable[..., Any]:
     """
     Prints error because some pipelined commands should
     be blocked when running in cluster-mode
@@ -2138,7 +2138,7 @@ def block_pipeline_command(func):
 
     def inner(*args, **kwargs):
         raise RedisClusterException(
-            f"ERROR: Calling pipelined function {func.__name__} is blocked "
+            f"ERROR: Calling pipelined function {name} is blocked "
             f"when running redis in cluster mode..."
         )
 
@@ -2146,39 +2146,81 @@ def inner(*args, **kwargs):
 
 
 # Blocked pipeline commands
-ClusterPipeline.bitop = block_pipeline_command(RedisCluster.bitop)
-ClusterPipeline.brpoplpush = block_pipeline_command(RedisCluster.brpoplpush)
-ClusterPipeline.client_getname = block_pipeline_command(RedisCluster.client_getname)
-ClusterPipeline.client_list = block_pipeline_command(RedisCluster.client_list)
-ClusterPipeline.client_setname = block_pipeline_command(RedisCluster.client_setname)
-ClusterPipeline.config_set = block_pipeline_command(RedisCluster.config_set)
-ClusterPipeline.dbsize = block_pipeline_command(RedisCluster.dbsize)
-ClusterPipeline.flushall = block_pipeline_command(RedisCluster.flushall)
-ClusterPipeline.flushdb = block_pipeline_command(RedisCluster.flushdb)
-ClusterPipeline.keys = block_pipeline_command(RedisCluster.keys)
-ClusterPipeline.mget = block_pipeline_command(RedisCluster.mget)
-ClusterPipeline.move = block_pipeline_command(RedisCluster.move)
-ClusterPipeline.mset = block_pipeline_command(RedisCluster.mset)
-ClusterPipeline.msetnx = block_pipeline_command(RedisCluster.msetnx)
-ClusterPipeline.pfmerge = block_pipeline_command(RedisCluster.pfmerge)
-ClusterPipeline.pfcount = block_pipeline_command(RedisCluster.pfcount)
-ClusterPipeline.ping = block_pipeline_command(RedisCluster.ping)
-ClusterPipeline.publish = block_pipeline_command(RedisCluster.publish)
-ClusterPipeline.randomkey = block_pipeline_command(RedisCluster.randomkey)
-ClusterPipeline.rename = block_pipeline_command(RedisCluster.rename)
-ClusterPipeline.renamenx = block_pipeline_command(RedisCluster.renamenx)
-ClusterPipeline.rpoplpush = block_pipeline_command(RedisCluster.rpoplpush)
-ClusterPipeline.scan = block_pipeline_command(RedisCluster.scan)
-ClusterPipeline.sdiff = block_pipeline_command(RedisCluster.sdiff)
-ClusterPipeline.sdiffstore = block_pipeline_command(RedisCluster.sdiffstore)
-ClusterPipeline.sinter = block_pipeline_command(RedisCluster.sinter)
-ClusterPipeline.sinterstore = block_pipeline_command(RedisCluster.sinterstore)
-ClusterPipeline.smove = block_pipeline_command(RedisCluster.smove)
-ClusterPipeline.sort = block_pipeline_command(RedisCluster.sort)
-ClusterPipeline.sunion = block_pipeline_command(RedisCluster.sunion)
-ClusterPipeline.sunionstore = block_pipeline_command(RedisCluster.sunionstore)
-ClusterPipeline.readwrite = block_pipeline_command(RedisCluster.readwrite)
-ClusterPipeline.readonly = block_pipeline_command(RedisCluster.readonly)
+PIPELINE_BLOCKED_COMMANDS = (
+    "BGREWRITEAOF",
+    "BGSAVE",
+    "BITOP",
+    "BRPOPLPUSH",
+    "CLIENT GETNAME",
+    "CLIENT KILL",
+    "CLIENT LIST",
+    "CLIENT SETNAME",
+    "CLIENT",
+    "CONFIG GET",
+    "CONFIG RESETSTAT",
+    "CONFIG REWRITE",
+    "CONFIG SET",
+    "CONFIG",
+    "DBSIZE",
+    "ECHO",
+    "EVALSHA",
+    "FLUSHALL",
+    "FLUSHDB",
+    "INFO",
+    "KEYS",
+    "LASTSAVE",
+    "MGET",
+    "MGET NONATOMIC",
+    "MOVE",
+    "MSET",
+    "MSET NONATOMIC",
+    "MSETNX",
+    "PFCOUNT",
+    "PFMERGE",
+    "PING",
+    "PUBLISH",
+    "RANDOMKEY",
+    "READONLY",
+    "READWRITE",
+    "RENAME",
+    "RENAMENX",
+    "RPOPLPUSH",
+    "SAVE",
+    "SCAN",
+    "SCRIPT EXISTS",
+    "SCRIPT FLUSH",
+    "SCRIPT KILL",
+    "SCRIPT LOAD",
+    "SCRIPT",
+    "SDIFF",
+    "SDIFFSTORE",
+    "SENTINEL GET MASTER ADDR BY NAME",
+    "SENTINEL MASTER",
+    "SENTINEL MASTERS",
+    "SENTINEL MONITOR",
+    "SENTINEL REMOVE",
+    "SENTINEL SENTINELS",
+    "SENTINEL SET",
+    "SENTINEL SLAVES",
+    "SENTINEL",
+    "SHUTDOWN",
+    "SINTER",
+    "SINTERSTORE",
+    "SLAVEOF",
+    "SLOWLOG GET",
+    "SLOWLOG LEN",
+    "SLOWLOG RESET",
+    "SLOWLOG",
+    "SMOVE",
+    "SORT",
+    "SUNION",
+    "SUNIONSTORE",
+    "TIME",
+)
+for command in PIPELINE_BLOCKED_COMMANDS:
+    command = command.replace(" ", "_").lower()
+
+    setattr(ClusterPipeline, command, block_pipeline_command(command))
 
 
 class PipelineCommand:
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 123adc8549..0c676cb2d7 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -19,7 +19,7 @@
 from redis.asyncio import Connection, RedisCluster
 from redis.asyncio.cluster import ClusterNode, NodesManager
 from redis.asyncio.parser import CommandsParser
-from redis.cluster import PRIMARY, REPLICA, get_node_name
+from redis.cluster import PIPELINE_BLOCKED_COMMANDS, PRIMARY, REPLICA, get_node_name
 from redis.crc import REDIS_CLUSTER_HASH_SLOTS, key_slot
 from redis.exceptions import (
     AskError,
@@ -129,6 +129,16 @@ def mock_node_resp(node: ClusterNode, response: Any) -> ClusterNode:
     return node
 
 
+def mock_node_resp_exc(node: ClusterNode, exc: Exception) -> ClusterNode:
+    connection = mock.AsyncMock()
+    connection.is_connected = True
+    connection.read_response_without_lock.side_effect = exc
+    while node._free:
+        node._free.pop()
+    node._free.append(connection)
+    return node
+
+
 def mock_all_nodes_resp(rc: RedisCluster, response: Any) -> RedisCluster:
     for node in rc.get_nodes():
         mock_node_resp(node, response)
@@ -2218,3 +2228,245 @@ def cmd_init_mock(self, r: ClusterNode) -> None:
                 async with RedisCluster(startup_nodes=[node_1, node_2]) as rc:
                     assert rc.get_node(host=default_host, port=7001) is not None
                     assert rc.get_node(host=default_host, port=7002) is not None
+
+
+@pytest.mark.onlycluster
+class TestClusterPipeline:
+    """Tests for the ClusterPipeline class."""
+
+    async def test_blocked_arguments(self, r: RedisCluster) -> None:
+        """Test handling for blocked pipeline arguments."""
+        with pytest.raises(RedisClusterException) as ex:
+            r.pipeline(transaction=True)
+
+        assert str(ex.value) == "transaction is deprecated in cluster mode"
+
+        with pytest.raises(RedisClusterException) as ex:
+            r.pipeline(shard_hint=True)
+
+        assert str(ex.value) == "shard_hint is deprecated in cluster mode"
+
+    async def test_blocked_methods(self, r: RedisCluster) -> None:
+        """Test handling for blocked pipeline commands."""
+        pipeline = r.pipeline()
+        for command in PIPELINE_BLOCKED_COMMANDS:
+            command = command.replace(" ", "_").lower()
+            if command == "mset_nonatomic":
+                continue
+
+            with pytest.raises(RedisClusterException) as exc:
+                getattr(pipeline, command)()
+
+            assert str(exc.value) == (
+                f"ERROR: Calling pipelined function {command} is blocked "
+                "when running redis in cluster mode..."
+            )
+
+    async def test_empty_stack(self, r: RedisCluster) -> None:
+        """If a pipeline is executed with no commands it should return a empty list."""
+        p = r.pipeline()
+        result = await p.execute()
+        assert result == []
+
+    async def test_redis_cluster_pipeline(self, r: RedisCluster) -> None:
+        """Test that we can use a pipeline with the RedisCluster class"""
+        result = await (
+            r.pipeline()
+            .set("A", 1)
+            .get("A")
+            .hset("K", "F", "V")
+            .hgetall("K")
+            .mset_nonatomic({"A": 2, "B": 3})
+            .get("A")
+            .get("B")
+            .delete("A", "B", "K")
+            .execute()
+        )
+        assert result == [True, b"1", 1, {b"F": b"V"}, True, True, b"2", b"3", 1, 1, 1]
+
+    async def test_multi_key_operation_with_a_single_slot(
+        self, r: RedisCluster
+    ) -> None:
+        """Test multi key operation with a single slot."""
+        pipe = r.pipeline()
+        pipe.set("a{foo}", 1)
+        pipe.set("b{foo}", 2)
+        pipe.set("c{foo}", 3)
+        pipe.get("a{foo}")
+        pipe.get("b{foo}")
+        pipe.get("c{foo}")
+
+        res = await pipe.execute()
+        assert res == [True, True, True, b"1", b"2", b"3"]
+
+    async def test_multi_key_operation_with_multi_slots(self, r: RedisCluster) -> None:
+        """Test multi key operation with more than one slot."""
+        pipe = r.pipeline()
+        pipe.set("a{foo}", 1)
+        pipe.set("b{foo}", 2)
+        pipe.set("c{foo}", 3)
+        pipe.set("bar", 4)
+        pipe.set("bazz", 5)
+        pipe.get("a{foo}")
+        pipe.get("b{foo}")
+        pipe.get("c{foo}")
+        pipe.get("bar")
+        pipe.get("bazz")
+        res = await pipe.execute()
+        assert res == [True, True, True, True, True, b"1", b"2", b"3", b"4", b"5"]
+
+    async def test_cluster_down_error(self, r: RedisCluster) -> None:
+        """
+        Test that the pipeline retries cluster_error_retry_attempts times before raising
+        an error.
+        """
+        key = "foo"
+        node = r.get_node_from_key(key, False)
+
+        parse_response_orig = node.parse_response
+        with mock.patch.object(
+            ClusterNode, "parse_response", autospec=True
+        ) as parse_response_mock:
+
+            async def parse_response(
+                self, connection: Connection, command: str, **kwargs: Any
+            ) -> Any:
+                if command == "GET":
+                    raise ClusterDownError("error")
+                return await parse_response_orig(connection, command, **kwargs)
+
+            parse_response_mock.side_effect = parse_response
+
+            # For each ClusterDownError, we launch 4 commands: INFO, CLUSTER SLOTS,
+            # COMMAND, GET. Before any errors, the first 3 commands are already run
+            async with r.pipeline() as pipe:
+                with pytest.raises(ClusterDownError):
+                    await pipe.get(key).execute()
+
+                assert (
+                    node.parse_response.await_count
+                    == 4 * r.cluster_error_retry_attempts - 3
+                )
+
+    async def test_connection_error_not_raised(self, r: RedisCluster) -> None:
+        """Test ConnectionError handling with raise_on_error=False."""
+        key = "foo"
+        node = r.get_node_from_key(key, False)
+
+        parse_response_orig = node.parse_response
+        with mock.patch.object(
+            ClusterNode, "parse_response", autospec=True
+        ) as parse_response_mock:
+
+            async def parse_response(
+                self, connection: Connection, command: str, **kwargs: Any
+            ) -> Any:
+                if command == "GET":
+                    raise ConnectionError("error")
+                return await parse_response_orig(connection, command, **kwargs)
+
+            parse_response_mock.side_effect = parse_response
+
+            async with r.pipeline() as pipe:
+                res = await pipe.get(key).get(key).execute(raise_on_error=False)
+                assert node.parse_response.await_count
+                assert isinstance(res[0], ConnectionError)
+
+    async def test_connection_error_raised(self, r: RedisCluster) -> None:
+        """Test ConnectionError handling with raise_on_error=True."""
+        key = "foo"
+        node = r.get_node_from_key(key, False)
+
+        parse_response_orig = node.parse_response
+        with mock.patch.object(
+            ClusterNode, "parse_response", autospec=True
+        ) as parse_response_mock:
+
+            async def parse_response(
+                self, connection: Connection, command: str, **kwargs: Any
+            ) -> Any:
+                if command == "GET":
+                    raise ConnectionError("error")
+                return await parse_response_orig(connection, command, **kwargs)
+
+            parse_response_mock.side_effect = parse_response
+
+            async with r.pipeline() as pipe:
+                with pytest.raises(ConnectionError):
+                    await pipe.get(key).get(key).execute(raise_on_error=True)
+
+    async def test_asking_error(self, r: RedisCluster) -> None:
+        """Test AskError handling."""
+        key = "foo"
+        first_node = r.get_node_from_key(key, False)
+        ask_node = None
+        for node in r.get_nodes():
+            if node != first_node:
+                ask_node = node
+                break
+        ask_msg = f"{r.keyslot(key)} {ask_node.host}:{ask_node.port}"
+
+        async with r.pipeline() as pipe:
+            mock_node_resp_exc(first_node, AskError(ask_msg))
+            mock_node_resp(ask_node, "MOCK_OK")
+            res = await pipe.get(key).execute()
+            assert first_node._free.pop().read_response_without_lock.await_count
+            assert ask_node._free.pop().read_response_without_lock.await_count
+            assert res == ["MOCK_OK"]
+
+    async def test_moved_redirection_on_slave_with_default(
+        self, r: RedisCluster
+    ) -> None:
+        """Test MovedError handling."""
+        key = "foo"
+        await r.set("foo", "bar")
+        # set read_from_replicas to True
+        r.read_from_replicas = True
+        primary = r.get_node_from_key(key, False)
+        moved_error = f"{r.keyslot(key)} {primary.host}:{primary.port}"
+
+        parse_response_orig = primary.parse_response
+        with mock.patch.object(
+            ClusterNode, "parse_response", autospec=True
+        ) as parse_response_mock:
+
+            async def parse_response(
+                self, connection: Connection, command: str, **kwargs: Any
+            ) -> Any:
+                if (
+                    command == "GET"
+                    and self.host != primary.host
+                    and self.port != primary.port
+                ):
+                    raise MovedError(moved_error)
+
+                return await parse_response_orig(connection, command, **kwargs)
+
+            parse_response_mock.side_effect = parse_response
+
+            async with r.pipeline() as readwrite_pipe:
+                assert r.reinitialize_counter == 0
+                readwrite_pipe.get(key).get(key)
+                assert r.reinitialize_counter == 0
+                assert await readwrite_pipe.execute() == [b"bar", b"bar"]
+
+    async def test_readonly_pipeline_from_readonly_client(
+        self, r: RedisCluster
+    ) -> None:
+        """Test that the pipeline uses replicas for read_from_replicas clients."""
+        # Create a cluster with reading from replications
+        r.read_from_replicas = True
+        key = "bar"
+        await r.set(key, "foo")
+
+        async with r.pipeline() as pipe:
+            mock_all_nodes_resp(r, "MOCK_OK")
+            assert await pipe.get(key).get(key).execute() == ["MOCK_OK", "MOCK_OK"]
+            slot_nodes = r.nodes_manager.slots_cache[r.keyslot(key)]
+            executed_on_replica = False
+            for node in slot_nodes:
+                if node.server_type == REPLICA:
+                    if node._free.pop().read_response_without_lock.await_count:
+                        executed_on_replica = True
+                        break
+            assert executed_on_replica
diff --git a/tests/test_asyncio/test_pipeline.py b/tests/test_asyncio/test_pipeline.py
index 50a1051f4f..dfeb66464c 100644
--- a/tests/test_asyncio/test_pipeline.py
+++ b/tests/test_asyncio/test_pipeline.py
@@ -8,8 +8,8 @@
 pytestmark = pytest.mark.asyncio
 
 
-@pytest.mark.onlynoncluster
 class TestPipeline:
+    @pytest.mark.onlynoncluster
     async def test_pipeline_is_true(self, r):
         """Ensure pipeline instances are not false-y"""
         async with r.pipeline() as pipe:
@@ -52,7 +52,6 @@ async def test_pipeline_length(self, r):
             await pipe.execute()
             assert len(pipe) == 0
 
-    @pytest.mark.onlynoncluster
     async def test_pipeline_no_transaction(self, r):
         async with r.pipeline(transaction=False) as pipe:
             pipe.set("a", "a1").set("b", "b1").set("c", "c1")
@@ -61,6 +60,7 @@ async def test_pipeline_no_transaction(self, r):
             assert await r.get("b") == b"b1"
             assert await r.get("c") == b"c1"
 
+    @pytest.mark.onlynoncluster
     async def test_pipeline_no_transaction_watch(self, r):
         await r.set("a", 0)
 
@@ -72,6 +72,7 @@ async def test_pipeline_no_transaction_watch(self, r):
             pipe.set("a", int(a) + 1)
             assert await pipe.execute() == [True]
 
+    @pytest.mark.onlynoncluster
     async def test_pipeline_no_transaction_watch_failure(self, r):
         await r.set("a", 0)
 
@@ -375,7 +376,7 @@ async def test_pipeline_with_bitfield(self, r):
     async def test_pipeline_get(self, r):
         await r.set("a", "a1")
         async with r.pipeline() as pipe:
-            await pipe.get("a")
+            pipe.get("a")
             assert await pipe.execute() == [b"a1"]
 
     @pytest.mark.onlynoncluster

From 4a73d85c78ce0ca36e5100b7ee0047b773cec23f Mon Sep 17 00:00:00 2001
From: mfgnik <31517000+mfgnik@users.noreply.github.com>
Date: Tue, 31 May 2022 13:46:12 +0300
Subject: [PATCH 0503/1164] Add default None for maxlen at xtrim command
 (#2188)

* Add default None for maxlen at xtrim command

* Fix linter

Co-authored-by: Mikhail Fedorov <mfgnik@yandex.team.ru>
Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/commands/core.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 771fed9e0c..ab246a7b81 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3842,7 +3842,7 @@ def xrevrange(
     def xtrim(
         self,
         name: KeyT,
-        maxlen: Union[int, None],
+        maxlen: Union[int, None] = None,
         approximate: bool = True,
         minid: Union[StreamIdT, None] = None,
         limit: Union[int, None] = None,
@@ -3863,6 +3863,9 @@ def xtrim(
         if maxlen is not None and minid is not None:
             raise DataError("Only one of ``maxlen`` or ``minid`` " "may be specified")
 
+        if maxlen is None and minid is None:
+            raise DataError("One of ``maxlen`` or ``minid`` must be specified")
+
         if maxlen is not None:
             pieces.append(b"MAXLEN")
         if minid is not None:

From 04bc576679e9fedb24a0548521d80fe81c91e2ec Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 31 May 2022 15:47:24 +0300
Subject: [PATCH 0504/1164] Fix tests for Redis 7 (#2182)

* fix tests

* async
---
 redis/cluster.py                    |  1 +
 redis/commands/parser.py            |  2 +-
 tests/test_asyncio/test_commands.py | 36 +++++++++++---------
 tests/test_cluster.py               | 37 ++++++++++++++-------
 tests/test_command_parser.py        |  4 ---
 tests/test_commands.py              | 30 +++++++++--------
 tests/test_encoding.py              |  2 +-
 tests/test_function.py              | 51 ++++++++++++++---------------
 tests/test_scripting.py             |  4 +--
 9 files changed, 93 insertions(+), 74 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index 2e310634d6..a88792bc22 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -303,6 +303,7 @@ class AbstractRedisCluster:
                 "CLUSTER KEYSLOT",
                 "COMMAND",
                 "COMMAND COUNT",
+                "COMMAND LIST",
                 "COMMAND GETKEYS",
                 "CONFIG GET",
                 "DEBUG",
diff --git a/redis/commands/parser.py b/redis/commands/parser.py
index 7560603d75..115230a9d2 100644
--- a/redis/commands/parser.py
+++ b/redis/commands/parser.py
@@ -79,7 +79,7 @@ def get_keys(self, redis_conn, *args):
         command = self.commands.get(cmd_name)
         if "movablekeys" in command["flags"]:
             keys = self._get_moveable_keys(redis_conn, *args)
-        elif "pubsub" in command["flags"]:
+        elif "pubsub" in command["flags"] or command["name"] == "pubsub":
             keys = self._get_pubsub_keys(*args)
         else:
             if (
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 6fa702d51c..e128ac40b8 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -517,13 +517,10 @@ async def test_config_resetstat(self, r: redis.Redis):
         assert reset_commands_processed < prior_commands_processed
 
     async def test_config_set(self, r: redis.Redis):
-        data = await r.config_get()
-        rdbname = data["dbfilename"]
-        try:
-            assert await r.config_set("dbfilename", "redis_py_test.rdb")
-            assert (await r.config_get())["dbfilename"] == "redis_py_test.rdb"
-        finally:
-            assert await r.config_set("dbfilename", rdbname)
+        await r.config_set("timeout", 70)
+        assert (await r.config_get())["timeout"] == "70"
+        assert await r.config_set("timeout", 0)
+        assert (await r.config_get())["timeout"] == "0"
 
     @pytest.mark.onlynoncluster
     async def test_dbsize(self, r: redis.Redis):
@@ -541,7 +538,8 @@ async def test_info(self, r: redis.Redis):
         await r.set("b", "bar")
         info = await r.info()
         assert isinstance(info, dict)
-        assert info["db9"]["keys"] == 2
+        assert "arch_bits" in info.keys()
+        assert "redis_version" in info.keys()
 
     @pytest.mark.onlynoncluster
     async def test_lastsave(self, r: redis.Redis):
@@ -2180,6 +2178,7 @@ async def test_cluster_slaves(self, mock_cluster_resp_slaves):
         )
 
     @skip_if_server_version_lt("3.0.0")
+    @skip_if_server_version_gte("7.0.0")
     @pytest.mark.onlynoncluster
     async def test_readwrite(self, r: redis.Redis):
         assert await r.readwrite()
@@ -2543,7 +2542,7 @@ async def test_xclaim(self, r: redis.Redis):
             justid=True,
         ) == [message_id]
 
-    @skip_if_server_version_lt("5.0.0")
+    @skip_if_server_version_lt("7.0.0")
     async def test_xclaim_trimmed(self, r: redis.Redis):
         # xclaim should not raise an exception if the item is not there
         stream = "stream"
@@ -2564,9 +2563,8 @@ async def test_xclaim_trimmed(self, r: redis.Redis):
         # xclaim them from consumer2
         # the item that is still in the stream should be returned
         item = await r.xclaim(stream, group, "consumer2", 0, [sid1, sid2])
-        assert len(item) == 2
-        assert item[0] == (None, None)
-        assert item[1][0] == sid2
+        assert len(item) == 1
+        assert item[0][0] == sid2
 
     @skip_if_server_version_lt("5.0.0")
     async def test_xdel(self, r: redis.Redis):
@@ -2583,7 +2581,7 @@ async def test_xdel(self, r: redis.Redis):
         assert await r.xdel(stream, m1) == 1
         assert await r.xdel(stream, m2, m3) == 2
 
-    @skip_if_server_version_lt("5.0.0")
+    @skip_if_server_version_lt("7.0.0")
     async def test_xgroup_create(self, r: redis.Redis):
         # tests xgroup_create and xinfo_groups
         stream = "stream"
@@ -2600,11 +2598,13 @@ async def test_xgroup_create(self, r: redis.Redis):
                 "consumers": 0,
                 "pending": 0,
                 "last-delivered-id": b"0-0",
+                "entries-read": None,
+                "lag": 1,
             }
         ]
         assert await r.xinfo_groups(stream) == expected
 
-    @skip_if_server_version_lt("5.0.0")
+    @skip_if_server_version_lt("7.0.0")
     async def test_xgroup_create_mkstream(self, r: redis.Redis):
         # tests xgroup_create and xinfo_groups
         stream = "stream"
@@ -2624,6 +2624,8 @@ async def test_xgroup_create_mkstream(self, r: redis.Redis):
                 "consumers": 0,
                 "pending": 0,
                 "last-delivered-id": b"0-0",
+                "entries-read": None,
+                "lag": 0,
             }
         ]
         assert await r.xinfo_groups(stream) == expected
@@ -2658,7 +2660,7 @@ async def test_xgroup_destroy(self, r: redis.Redis):
         await r.xgroup_create(stream, group, 0)
         assert await r.xgroup_destroy(stream, group)
 
-    @skip_if_server_version_lt("5.0.0")
+    @skip_if_server_version_lt("7.0.0")
     async def test_xgroup_setid(self, r: redis.Redis):
         stream = "stream"
         group = "group"
@@ -2666,13 +2668,15 @@ async def test_xgroup_setid(self, r: redis.Redis):
 
         await r.xgroup_create(stream, group, 0)
         # advance the last_delivered_id to the message_id
-        await r.xgroup_setid(stream, group, message_id)
+        await r.xgroup_setid(stream, group, message_id, entries_read=2)
         expected = [
             {
                 "name": group.encode(),
                 "consumers": 0,
                 "pending": 0,
                 "last-delivered-id": message_id,
+                "entries-read": 2,
+                "lag": -1,
             }
         ]
         assert await r.xinfo_groups(stream) == expected
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index c74af202d8..d1568ef4de 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -858,15 +858,15 @@ def test_cluster_shards(self, r):
         assert isinstance(cluster_shards, list)
         assert isinstance(cluster_shards[0], dict)
         attributes = [
-            "id",
-            "endpoint",
-            "ip",
-            "hostname",
-            "port",
-            "tls-port",
-            "role",
-            "replication-offset",
-            "health",
+            b"id",
+            b"endpoint",
+            b"ip",
+            b"hostname",
+            b"port",
+            b"tls-port",
+            b"role",
+            b"replication-offset",
+            b"health",
         ]
         for x in cluster_shards:
             assert list(x.keys()) == ["slots", "nodes"]
@@ -915,9 +915,24 @@ def test_cluster_delslots(self):
 
     @skip_if_server_version_lt("7.0.0")
     @skip_if_redis_enterprise()
-    def test_cluster_delslotsrange(self, r):
+    def test_cluster_delslotsrange(self):
+        cluster_slots = [
+            [
+                0,
+                8191,
+                ["127.0.0.1", 7000, "node_0"],
+            ],
+            [
+                8192,
+                16383,
+                ["127.0.0.1", 7001, "node_1"],
+            ],
+        ]
+        r = get_mocked_redis_client(
+            host=default_host, port=default_port, cluster_slots=cluster_slots
+        )
+        mock_all_nodes_resp(r, "OK")
         node = r.get_random_node()
-        mock_node_resp(node, "OK")
         r.cluster_addslots(node, 1, 2, 3, 4, 5)
         assert r.cluster_delslotsrange(1, 5)
 
diff --git a/tests/test_command_parser.py b/tests/test_command_parser.py
index 134909fdcd..708c069339 100644
--- a/tests/test_command_parser.py
+++ b/tests/test_command_parser.py
@@ -50,8 +50,6 @@ def test_get_moveable_keys(self, r):
             "key3",
         ]
         args7 = ["MIGRATE", "192.168.1.34", 6379, "key1", 0, 5000]
-        args8 = ["STRALGO", "LCS", "STRINGS", "string_a", "string_b"]
-        args9 = ["STRALGO", "LCS", "KEYS", "key1", "key2"]
 
         assert commands_parser.get_keys(r, *args1).sort() == ["key1", "key2"].sort()
         assert (
@@ -68,8 +66,6 @@ def test_get_moveable_keys(self, r):
             == ["key1", "key2", "key3"].sort()
         )
         assert commands_parser.get_keys(r, *args7).sort() == ["key1"].sort()
-        assert commands_parser.get_keys(r, *args8) is None
-        assert commands_parser.get_keys(r, *args9).sort() == ["key1", "key2"].sort()
 
     # A bug in redis<7.0 causes this to fail: https://github.com/redis/redis/issues/9493
     @skip_if_server_version_lt("7.0.0")
diff --git a/tests/test_commands.py b/tests/test_commands.py
index d4a564c0ad..1ae6219a9e 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -670,7 +670,7 @@ def test_client_unpause(self, r):
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("7.0.0")
     def test_client_no_evict(self, r):
-        assert r.client_no_evict("ON") == "OK"
+        assert r.client_no_evict("ON")
         with pytest.raises(TypeError):
             r.client_no_evict()
 
@@ -1089,9 +1089,9 @@ def test_unlink_with_multiple_keys(self, r):
     @skip_if_server_version_lt("7.0.0")
     def test_lcs(self, r):
         r.mset({"foo": "ohmytext", "bar": "mynewtext"})
-        assert r.lcs("foo", "bar") == "mytext"
+        assert r.lcs("foo", "bar") == b"mytext"
         assert r.lcs("foo", "bar", len=True) == 6
-        result = ["matches", [[[4, 7], [5, 8]]], "len", 6]
+        result = [b"matches", [[[4, 7], [5, 8]]], b"len", 6]
         assert r.lcs("foo", "bar", idx=True, minmatchlen=3) == result
         with pytest.raises(redis.ResponseError):
             assert r.lcs("foo", "bar", len=True, idx=True)
@@ -1764,24 +1764,24 @@ def test_brpoplpush_empty_string(self, r):
     @skip_if_server_version_lt("7.0.0")
     def test_blmpop(self, r):
         r.rpush("a", "1", "2", "3", "4", "5")
-        res = ["a", ["1", "2"]]
+        res = [b"a", [b"1", b"2"]]
         assert r.blmpop(1, "2", "b", "a", direction="LEFT", count=2) == res
         with pytest.raises(TypeError):
             r.blmpop(1, "2", "b", "a", count=2)
         r.rpush("b", "6", "7", "8", "9")
-        assert r.blmpop(0, "2", "b", "a", direction="LEFT") == ["b", ["6"]]
+        assert r.blmpop(0, "2", "b", "a", direction="LEFT") == [b"b", [b"6"]]
         assert r.blmpop(1, "2", "foo", "bar", direction="RIGHT") is None
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("7.0.0")
     def test_lmpop(self, r):
         r.rpush("foo", "1", "2", "3", "4", "5")
-        result = ["foo", ["1", "2"]]
+        result = [b"foo", [b"1", b"2"]]
         assert r.lmpop("2", "bar", "foo", direction="LEFT", count=2) == result
         with pytest.raises(redis.ResponseError):
             r.lmpop("2", "bar", "foo", direction="up", count=2)
         r.rpush("bar", "a", "b", "c", "d")
-        assert r.lmpop("2", "bar", "foo", direction="LEFT") == ["bar", ["a"]]
+        assert r.lmpop("2", "bar", "foo", direction="LEFT") == [b"bar", [b"a"]]
 
     def test_lindex(self, r):
         r.rpush("a", "1", "2", "3")
@@ -2393,23 +2393,23 @@ def test_bzpopmin(self, r):
     @skip_if_server_version_lt("7.0.0")
     def test_zmpop(self, r):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
-        res = ["a", [["a1", "1"], ["a2", "2"]]]
+        res = [b"a", [[b"a1", b"1"], [b"a2", b"2"]]]
         assert r.zmpop("2", ["b", "a"], min=True, count=2) == res
         with pytest.raises(redis.DataError):
             r.zmpop("2", ["b", "a"], count=2)
         r.zadd("b", {"b1": 10, "ab": 9, "b3": 8})
-        assert r.zmpop("2", ["b", "a"], max=True) == ["b", [["b1", "10"]]]
+        assert r.zmpop("2", ["b", "a"], max=True) == [b"b", [[b"b1", b"10"]]]
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("7.0.0")
     def test_bzmpop(self, r):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
-        res = ["a", [["a1", "1"], ["a2", "2"]]]
+        res = [b"a", [[b"a1", b"1"], [b"a2", b"2"]]]
         assert r.bzmpop(1, "2", ["b", "a"], min=True, count=2) == res
         with pytest.raises(redis.DataError):
             r.bzmpop(1, "2", ["b", "a"], count=2)
         r.zadd("b", {"b1": 10, "ab": 9, "b3": 8})
-        res = ["b", [["b1", "10"]]]
+        res = [b"b", [[b"b1", b"10"]]]
         assert r.bzmpop(0, "2", ["b", "a"], max=True) == res
         assert r.bzmpop(1, "2", ["foo", "bar"], max=True) is None
 
@@ -3100,6 +3100,7 @@ def test_cluster_slaves(self, mock_cluster_resp_slaves):
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("3.0.0")
+    @skip_if_server_version_gte("7.0.0")
     @skip_if_redis_enterprise()
     def test_readwrite(self, r):
         assert r.readwrite()
@@ -4510,7 +4511,7 @@ def test_command_list(self, r: redis.Redis):
         assert len(r.command_list()) > 300
         assert len(r.command_list(module="fakemod")) == 0
         assert len(r.command_list(category="list")) > 15
-        assert "lpop" in r.command_list(pattern="l*")
+        assert b"lpop" in r.command_list(pattern="l*")
         with pytest.raises(redis.ResponseError):
             r.command_list(category="list", pattern="l*")
 
@@ -4546,7 +4547,10 @@ def test_command(self, r):
     @skip_if_server_version_lt("7.0.0")
     @skip_if_redis_enterprise()
     def test_command_getkeysandflags(self, r: redis.Redis):
-        res = [["mylist1", ["RW", "access", "delete"]], ["mylist2", ["RW", "insert"]]]
+        res = [
+            [b"mylist1", [b"RW", b"access", b"delete"]],
+            [b"mylist2", [b"RW", b"insert"]],
+        ]
         assert res == r.command_getkeysandflags(
             "LMOVE", "mylist1", "mylist2", "left", "left"
         )
diff --git a/tests/test_encoding.py b/tests/test_encoding.py
index d7d1fb106d..2867640742 100644
--- a/tests/test_encoding.py
+++ b/tests/test_encoding.py
@@ -90,7 +90,7 @@ def test_memoryviews_are_not_packed(self):
 class TestCommandsAreNotEncoded:
     @pytest.fixture()
     def r(self, request):
-        return _get_client(redis.Redis, request=request, encoding="utf-16")
+        return _get_client(redis.Redis, request=request, encoding="utf-8")
 
     def test_basic_command(self, r):
         r.set("hello", "world")
diff --git a/tests/test_function.py b/tests/test_function.py
index 70f6b19869..7ce66a38e6 100644
--- a/tests/test_function.py
+++ b/tests/test_function.py
@@ -22,10 +22,10 @@ class TestFunction:
     def reset_functions(self, r):
         r.function_flush()
 
+    @pytest.mark.onlynoncluster
     def test_function_load(self, r):
-        print("!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!")
-        assert lib == r.function_load(f"#!{engine} name={lib} \n {function}")
-        assert lib == r.function_load(
+        assert b"mylib" == r.function_load(f"#!{engine} name={lib} \n {function}")
+        assert b"mylib" == r.function_load(
             f"#!{engine} name={lib} \n {function}", replace=True
         )
         with pytest.raises(ResponseError):
@@ -37,15 +37,14 @@ def test_function_delete(self, r):
         r.function_load(f"#!{engine} name={lib} \n {set_function}")
         with pytest.raises(ResponseError):
             r.function_load(f"#!{engine} name={lib} \n {set_function}")
-        assert r.fcall("set", 1, "foo", "bar") == "OK"
+        assert r.fcall("set", 1, "foo", "bar") == b"OK"
         assert r.function_delete("mylib")
         with pytest.raises(ResponseError):
             r.fcall("set", 1, "foo", "bar")
-        assert lib == r.function_load(f"#!{engine} name={lib} \n {set_function}")
 
     def test_function_flush(self, r):
         r.function_load(f"#!{engine} name={lib} \n {function}")
-        assert r.fcall("myfunc", 0, "hello") == "hello"
+        assert r.fcall("myfunc", 0, "hello") == b"hello"
         assert r.function_flush()
         with pytest.raises(ResponseError):
             r.fcall("myfunc", 0, "hello")
@@ -57,19 +56,19 @@ def test_function_list(self, r):
         r.function_load(f"#!{engine} name={lib} \n {function}")
         res = [
             [
-                "library_name",
-                "mylib",
-                "engine",
-                "LUA",
-                "functions",
-                [["name", "myfunc", "description", None, "flags", ["no-writes"]]],
+                b"library_name",
+                b"mylib",
+                b"engine",
+                b"LUA",
+                b"functions",
+                [[b"name", b"myfunc", b"description", None, b"flags", [b"no-writes"]]],
             ]
         ]
         assert r.function_list() == res
         assert r.function_list(library="*lib") == res
         assert (
             r.function_list(withcode=True)[0][7]
-            == f"#!{engine} name={lib} \n {function}"
+            == f"#!{engine} name={lib} \n {function}".encode()
         )
 
     @pytest.mark.onlycluster
@@ -77,12 +76,12 @@ def test_function_list_on_cluster(self, r):
         r.function_load(f"#!{engine} name={lib} \n {function}")
         function_list = [
             [
-                "library_name",
-                "mylib",
-                "engine",
-                "LUA",
-                "functions",
-                [["name", "myfunc", "description", None, "flags", ["no-writes"]]],
+                b"library_name",
+                b"mylib",
+                b"engine",
+                b"LUA",
+                b"functions",
+                [[b"name", b"myfunc", b"description", None, b"flags", [b"no-writes"]]],
             ]
         ]
         primaries = r.get_primaries()
@@ -94,20 +93,20 @@ def test_function_list_on_cluster(self, r):
         node = primaries[0].name
         assert (
             r.function_list(withcode=True)[node][0][7]
-            == f"#!{engine} name={lib} \n {function}"
+            == f"#!{engine} name={lib} \n {function}".encode()
         )
 
     def test_fcall(self, r):
         r.function_load(f"#!{engine} name={lib} \n {set_function}")
         r.function_load(f"#!{engine} name={lib2} \n {get_function}")
-        assert r.fcall("set", 1, "foo", "bar") == "OK"
-        assert r.fcall("get", 1, "foo") == "bar"
+        assert r.fcall("set", 1, "foo", "bar") == b"OK"
+        assert r.fcall("get", 1, "foo") == b"bar"
         with pytest.raises(ResponseError):
             r.fcall("myfunc", 0, "hello")
 
     def test_fcall_ro(self, r):
         r.function_load(f"#!{engine} name={lib} \n {function}")
-        assert r.fcall_ro("myfunc", 0, "hello") == "hello"
+        assert r.fcall_ro("myfunc", 0, "hello") == b"hello"
         r.function_load(f"#!{engine} name={lib2} \n {set_function}")
         with pytest.raises(ResponseError):
             r.fcall_ro("set", 1, "foo", "bar")
@@ -115,14 +114,14 @@ def test_fcall_ro(self, r):
     def test_function_dump_restore(self, r):
         r.function_load(f"#!{engine} name={lib} \n {set_function}")
         payload = r.function_dump()
-        assert r.fcall("set", 1, "foo", "bar") == "OK"
+        assert r.fcall("set", 1, "foo", "bar") == b"OK"
         r.function_delete("mylib")
         with pytest.raises(ResponseError):
             r.fcall("set", 1, "foo", "bar")
         assert r.function_restore(payload)
-        assert r.fcall("set", 1, "foo", "bar") == "OK"
+        assert r.fcall("set", 1, "foo", "bar") == b"OK"
         r.function_load(f"#!{engine} name={lib2} \n {get_function}")
-        assert r.fcall("get", 1, "foo") == "bar"
+        assert r.fcall("get", 1, "foo") == b"bar"
         r.function_delete("mylib")
         assert r.function_restore(payload, "FLUSH")
         with pytest.raises(ResponseError):
diff --git a/tests/test_scripting.py b/tests/test_scripting.py
index 1ccd99a003..bbe845c0da 100644
--- a/tests/test_scripting.py
+++ b/tests/test_scripting.py
@@ -70,7 +70,7 @@ def test_eval_multiply(self, r):
     @pytest.mark.onlynoncluster
     def test_eval_ro(self, r):
         r.set("a", "b")
-        assert r.eval_ro("return redis.call('GET', KEYS[1])", 1, "a") == "b"
+        assert r.eval_ro("return redis.call('GET', KEYS[1])", 1, "a") == b"b"
         with pytest.raises(redis.ResponseError):
             r.eval_ro("return redis.call('DEL', KEYS[1])", 1, "a")
 
@@ -162,7 +162,7 @@ def test_evalsha_ro(self, r):
         r.set("a", "b")
         get_sha = r.script_load("return redis.call('GET', KEYS[1])")
         del_sha = r.script_load("return redis.call('DEL', KEYS[1])")
-        assert r.evalsha_ro(get_sha, 1, "a") == "b"
+        assert r.evalsha_ro(get_sha, 1, "a") == b"b"
         with pytest.raises(redis.ResponseError):
             r.evalsha_ro(del_sha, 1, "a")
 

From edf10043f4a383ec93a2fb51917075ae1bbfbf48 Mon Sep 17 00:00:00 2001
From: Ryan Russell <ryanrussell@users.noreply.github.com>
Date: Tue, 31 May 2022 23:17:29 -0500
Subject: [PATCH 0505/1164] Improve Readability (#2206)

Signed-off-by: Ryan Russell <git@ryanrussell.org>
---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 0735055820..f5d4ae541a 100644
--- a/README.md
+++ b/README.md
@@ -15,7 +15,7 @@ The Python interface to the Redis key-value store.
 
 ## Python Notice
 
-redis-py 4.2.x will be the last generation of redis-py to support python 3.6 as it has been [End of Life'd](https://www.python.org/dev/peps/pep-0494/#schedule-last-security-only-release).  Async support was introduced in redis-py 4.2.x thanks to [aioredis](https://github.com/aio-libs/aioredis-py), which necessitates this change. We will continue to maintain 3.6 support as long as possible - but the plan is for redis-py version 5+ to offically remove 3.6.
+redis-py 4.2.x will be the last generation of redis-py to support python 3.6 as it has been [End of Life'd](https://www.python.org/dev/peps/pep-0494/#schedule-last-security-only-release).  Async support was introduced in redis-py 4.2.x thanks to [aioredis](https://github.com/aio-libs/aioredis-py), which necessitates this change. We will continue to maintain 3.6 support as long as possible - but the plan is for redis-py version 5+ to officially remove 3.6.
 
 ---------------------------
 
@@ -76,7 +76,7 @@ can specify *decode_responses=True* in
 returns a string type will be decoded with the encoding
 specified.
 
-The default encoding is utf-8, but this can be customized by specifiying the
+The default encoding is utf-8, but this can be customized by specifying the
 encoding argument for the redis.Redis class.
 The encoding will be used to automatically encode any
 strings passed to commands, such as key names and values.

From 7880460b72aca49aa5b9512f0995c0d17d884a7d Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 1 Jun 2022 14:32:45 +0300
Subject: [PATCH 0506/1164] Add `query_params` to FT.PROFILE (#2198)

* ft.profile query_params

* fix pr comments

* type hints
---
 redis/commands/search/commands.py | 30 +++++++++++++++++++-----------
 tests/test_search.py              | 24 ++++++++++++++++++++++++
 2 files changed, 43 insertions(+), 11 deletions(-)

diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index bf6614777e..0121436e15 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -1,6 +1,6 @@
 import itertools
 import time
-from typing import Dict, Union
+from typing import Dict, Optional, Union
 
 from redis.client import Pipeline
 
@@ -363,7 +363,11 @@ def info(self):
         it = map(to_string, res)
         return dict(zip(it, it))
 
-    def get_params_args(self, query_params: Dict[str, Union[str, int, float]]):
+    def get_params_args(
+        self, query_params: Union[Dict[str, Union[str, int, float]], None]
+    ):
+        if query_params is None:
+            return []
         args = []
         if len(query_params) > 0:
             args.append("params")
@@ -383,8 +387,7 @@ def _mk_query_args(self, query, query_params: Dict[str, Union[str, int, float]])
             raise ValueError(f"Bad query type {type(query)}")
 
         args += query.get_args()
-        if query_params is not None:
-            args += self.get_params_args(query_params)
+        args += self.get_params_args(query_params)
 
         return args, query
 
@@ -459,8 +462,7 @@ def aggregate(
             cmd = [CURSOR_CMD, "READ", self.index_name] + query.build_args()
         else:
             raise ValueError("Bad query", query)
-        if query_params is not None:
-            cmd += self.get_params_args(query_params)
+        cmd += self.get_params_args(query_params)
 
         raw = self.execute_command(*cmd)
         return self._get_aggregate_result(raw, query, has_cursor)
@@ -485,16 +487,22 @@ def _get_aggregate_result(self, raw, query, has_cursor):
 
         return AggregateResult(rows, cursor, schema)
 
-    def profile(self, query, limited=False):
+    def profile(
+        self,
+        query: Union[str, Query, AggregateRequest],
+        limited: bool = False,
+        query_params: Optional[Dict[str, Union[str, int, float]]] = None,
+    ):
         """
         Performs a search or aggregate command and collects performance
         information.
 
         ### Parameters
 
-        **query**: This can be either an `AggregateRequest`, `Query` or
-        string.
+        **query**: This can be either an `AggregateRequest`, `Query` or string.
         **limited**: If set to True, removes details of reader iterator.
+        **query_params**: Define one or more value parameters.
+        Each parameter has a name and a value.
 
         """
         st = time.time()
@@ -509,6 +517,7 @@ def profile(self, query, limited=False):
         elif isinstance(query, Query):
             cmd[2] = "SEARCH"
             cmd += query.get_args()
+            cmd += self.get_params_args(query_params)
         else:
             raise ValueError("Must provide AggregateRequest object or " "Query object.")
 
@@ -907,8 +916,7 @@ async def aggregate(
             cmd = [CURSOR_CMD, "READ", self.index_name] + query.build_args()
         else:
             raise ValueError("Bad query", query)
-        if query_params is not None:
-            cmd += self.get_params_args(query_params)
+        cmd += self.get_params_args(query_params)
 
         raw = await self.execute_command(*cmd)
         return self._get_aggregate_result(raw, query, has_cursor)
diff --git a/tests/test_search.py b/tests/test_search.py
index dba914aeaa..f0a1190fcb 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1519,6 +1519,30 @@ def test_profile_limited(client):
     assert len(res.docs) == 3  # check also the search result
 
 
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+def test_profile_query_params(modclient: redis.Redis):
+    modclient.flushdb()
+    modclient.ft().create_index(
+        (
+            VectorField(
+                "v", "HNSW", {"TYPE": "FLOAT32", "DIM": 2, "DISTANCE_METRIC": "L2"}
+            ),
+        )
+    )
+    modclient.hset("a", "v", "aaaaaaaa")
+    modclient.hset("b", "v", "aaaabaaa")
+    modclient.hset("c", "v", "aaaaabaa")
+    query = "*=>[KNN 2 @v $vec]"
+    q = Query(query).return_field("__v_score").sort_by("__v_score", True).dialect(2)
+    res, det = modclient.ft().profile(q, query_params={"vec": "aaaaaaaa"})
+    assert det["Iterators profile"]["Counter"] == 2.0
+    assert det["Iterators profile"]["Type"] == "VECTOR"
+    assert res.total == 2
+    assert "a" == res.docs[0].id
+    assert "0" == res.docs[0].__getattribute__("__v_score")
+
+
 @pytest.mark.redismod
 @skip_ifmodversion_lt("2.4.3", "search")
 def test_vector_field(modclient):

From 05fc203f68c24fbd54c7b338b4610fa62972c326 Mon Sep 17 00:00:00 2001
From: Utkarsh Gupta <utkarshgupta137@gmail.com>
Date: Wed, 1 Jun 2022 17:15:50 +0530
Subject: [PATCH 0507/1164] async_cluster: optimisations (#2205)

- return true from execute_pipeline if there are any errors
- use todo list to speedup retries
- store initialisation node in CommandsParser object
- add sync context manager for pipeline
- use if/else instead of try/except
- make command a function argument in _determine_nodes & _determine_slot

- add async cluster pipeline benchmark script
---
 benchmarks/cluster_async.py          |   4 +-
 benchmarks/cluster_async_pipeline.py | 107 +++++++++++++++++
 redis/asyncio/cluster.py             | 165 ++++++++++++++-------------
 redis/asyncio/parser.py              |  23 ++--
 4 files changed, 206 insertions(+), 93 deletions(-)
 create mode 100644 benchmarks/cluster_async_pipeline.py

diff --git a/benchmarks/cluster_async.py b/benchmarks/cluster_async.py
index fd2ab4603f..17dd52b5df 100644
--- a/benchmarks/cluster_async.py
+++ b/benchmarks/cluster_async.py
@@ -249,8 +249,8 @@ async def main(loop, gather=None):
     port = 16379
     password = None
 
-    count = 1000
-    size = 16
+    count = 10000
+    size = 256
 
     asyncio.run(main("asyncio"))
     asyncio.run(main("asyncio", gather=False))
diff --git a/benchmarks/cluster_async_pipeline.py b/benchmarks/cluster_async_pipeline.py
new file mode 100644
index 0000000000..af45b44511
--- /dev/null
+++ b/benchmarks/cluster_async_pipeline.py
@@ -0,0 +1,107 @@
+import asyncio
+import functools
+import time
+
+import aioredis_cluster
+import aredis
+import uvloop
+
+import redis.asyncio as redispy
+
+
+def timer(func):
+    @functools.wraps(func)
+    async def wrapper(*args, **kwargs):
+        tic = time.perf_counter()
+        await func(*args, **kwargs)
+        toc = time.perf_counter()
+        return f"{toc - tic:.4f}"
+
+    return wrapper
+
+
+@timer
+async def warmup(client):
+    await asyncio.gather(
+        *(asyncio.create_task(client.exists(f"bench:warmup_{i}")) for i in range(100))
+    )
+
+
+@timer
+async def run(client):
+    data_str = "a" * size
+    data_int = int("1" * size)
+
+    for i in range(count):
+        with client.pipeline() as pipe:
+            await (
+                pipe.set(f"bench:str_{i}", data_str)
+                .set(f"bench:int_{i}", data_int)
+                .get(f"bench:str_{i}")
+                .get(f"bench:int_{i}")
+                .hset("bench:hset", str(i), data_str)
+                .hget("bench:hset", str(i))
+                .incr("bench:incr")
+                .lpush("bench:lpush", data_int)
+                .lrange("bench:lpush", 0, 300)
+                .lpop("bench:lpush")
+                .execute()
+            )
+
+
+async def main(loop):
+    arc = aredis.StrictRedisCluster(
+        host=host,
+        port=port,
+        password=password,
+        max_connections=2**31,
+        max_connections_per_node=2**31,
+        readonly=False,
+        reinitialize_steps=count,
+        skip_full_coverage_check=True,
+        decode_responses=False,
+        max_idle_time=count,
+        idle_check_interval=count,
+    )
+    print(f"{loop} {await warmup(arc)} aredis")
+    print(await run(arc))
+    arc.connection_pool.disconnect()
+
+    aiorc = await aioredis_cluster.create_redis_cluster(
+        [(host, port)],
+        password=password,
+        state_reload_interval=count,
+        idle_connection_timeout=count,
+        pool_maxsize=2**31,
+    )
+    print(f"{loop} {await warmup(aiorc)} aioredis-cluster")
+    print(await run(aiorc))
+    aiorc.close()
+    await aiorc.wait_closed()
+
+    async with redispy.RedisCluster(
+        host=host,
+        port=port,
+        password=password,
+        reinitialize_steps=count,
+        read_from_replicas=False,
+        decode_responses=False,
+        max_connections=2**31,
+    ) as rca:
+        print(f"{loop} {await warmup(rca)} redispy")
+        print(await run(rca))
+
+
+if __name__ == "__main__":
+    host = "localhost"
+    port = 16379
+    password = None
+
+    count = 10000
+    size = 256
+
+    asyncio.run(main("asyncio"))
+
+    uvloop.install()
+
+    asyncio.run(main("uvloop"))
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 3405a499c2..b53f8487e2 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -468,9 +468,8 @@ def keyslot(self, key: EncodableT) -> int:
         return key_slot(k)
 
     async def _determine_nodes(
-        self, *args: Any, node_flag: Optional[str] = None
+        self, command: str, *args: Any, node_flag: Optional[str] = None
     ) -> List["ClusterNode"]:
-        command = args[0]
         if not node_flag:
             # get the nodes group for this command if it was predefined
             node_flag = self.command_flags.get(command)
@@ -495,16 +494,15 @@ async def _determine_nodes(
         # get the node that holds the key's slot
         return [
             self.nodes_manager.get_node_from_slot(
-                await self._determine_slot(*args),
+                await self._determine_slot(command, *args),
                 self.read_from_replicas and command in READ_COMMANDS,
             )
         ]
 
-    async def _determine_slot(self, *args: Any) -> int:
-        command = args[0]
+    async def _determine_slot(self, command: str, *args: Any) -> int:
         if self.command_flags.get(command) == SLOT_ID:
             # The command contains the slot ID
-            return int(args[1])
+            return int(args[0])
 
         # Get the keys in the command
 
@@ -516,19 +514,17 @@ async def _determine_slot(self, *args: Any) -> int:
         # - fix: https://github.com/redis/redis/pull/9733
         if command in ("EVAL", "EVALSHA"):
             # command syntax: EVAL "script body" num_keys ...
-            if len(args) <= 2:
-                raise RedisClusterException(f"Invalid args in command: {args}")
-            num_actual_keys = args[2]
-            eval_keys = args[3 : 3 + num_actual_keys]
+            if len(args) < 2:
+                raise RedisClusterException(
+                    f"Invalid args in command: {command, *args}"
+                )
+            keys = args[2 : 2 + args[1]]
             # if there are 0 keys, that means the script can be run on any node
             # so we can just return a random slot
-            if not eval_keys:
+            if not keys:
                 return random.randrange(0, REDIS_CLUSTER_HASH_SLOTS)
-            keys = eval_keys
         else:
-            keys = await self.commands_parser.get_keys(
-                self.nodes_manager.default_node, *args
-            )
+            keys = await self.commands_parser.get_keys(command, *args)
             if not keys:
                 # FCALL can call a function with 0 keys, that means the function
                 #  can be run on any node so we can just return a random slot
@@ -848,13 +844,13 @@ def acquire_connection(self) -> Connection:
                 self._free.append(connection)
 
             return self._free.popleft()
-        else:
-            if len(self._connections) < self.max_connections:
-                connection = self.connection_class(**self.connection_kwargs)
-                self._connections.append(connection)
-                return connection
-            else:
-                raise ConnectionError("Too many connections")
+
+        if len(self._connections) < self.max_connections:
+            connection = self.connection_class(**self.connection_kwargs)
+            self._connections.append(connection)
+            return connection
+
+        raise ConnectionError("Too many connections")
 
     async def parse_response(
         self, connection: Connection, command: str, **kwargs: Any
@@ -872,10 +868,10 @@ async def parse_response(
             raise
 
         # Return response
-        try:
+        if command in self.response_callbacks:
             return self.response_callbacks[command](response, **kwargs)
-        except KeyError:
-            return response
+
+        return response
 
     async def execute_command(self, *args: Any, **kwargs: Any) -> Any:
         # Acquire connection
@@ -891,7 +887,7 @@ async def execute_command(self, *args: Any, **kwargs: Any) -> Any:
             # Release connection
             self._free.append(connection)
 
-    async def execute_pipeline(self) -> None:
+    async def execute_pipeline(self) -> bool:
         # Acquire connection
         connection = self.acquire_connection()
 
@@ -901,17 +897,20 @@ async def execute_pipeline(self) -> None:
         )
 
         # Read responses
-        try:
-            for cmd in self._command_stack:
-                try:
-                    cmd.result = await self.parse_response(
-                        connection, cmd.args[0], **cmd.kwargs
-                    )
-                except Exception as e:
-                    cmd.result = e
-        finally:
-            # Release connection
-            self._free.append(connection)
+        ret = False
+        for cmd in self._command_stack:
+            try:
+                cmd.result = await self.parse_response(
+                    connection, cmd.args[0], **cmd.kwargs
+                )
+            except Exception as e:
+                cmd.result = e
+                ret = True
+
+        # Release connection
+        self._free.append(connection)
+
+        return ret
 
 
 class NodesManager:
@@ -1257,6 +1256,13 @@ async def __aexit__(self, exc_type: None, exc_value: None, traceback: None) -> N
     def __await__(self) -> Generator[Any, None, "ClusterPipeline"]:
         return self.initialize().__await__()
 
+    def __enter__(self) -> "ClusterPipeline":
+        self._command_stack = []
+        return self
+
+    def __exit__(self, exc_type: None, exc_value: None, traceback: None) -> None:
+        self._command_stack = []
+
     def __bool__(self) -> bool:
         return bool(self._command_stack)
 
@@ -1310,6 +1316,7 @@ async def execute(
 
                 try:
                     return await self._execute(
+                        self._client,
                         self._command_stack,
                         raise_on_error=raise_on_error,
                         allow_redirections=allow_redirections,
@@ -1331,60 +1338,60 @@ async def execute(
 
     async def _execute(
         self,
+        client: "RedisCluster",
         stack: List["PipelineCommand"],
         raise_on_error: bool = True,
         allow_redirections: bool = True,
     ) -> List[Any]:
-        client = self._client
+        todo = [
+            cmd for cmd in stack if not cmd.result or isinstance(cmd.result, Exception)
+        ]
+
         nodes = {}
-        for cmd in stack:
-            if not cmd.result or isinstance(cmd.result, Exception):
-                target_nodes = await client._determine_nodes(*cmd.args)
-                if not target_nodes:
-                    raise RedisClusterException(
-                        f"No targets were found to execute {cmd.args} command on"
-                    )
-                if len(target_nodes) > 1:
-                    raise RedisClusterException(
-                        f"Too many targets for command {cmd.args}"
-                    )
+        for cmd in todo:
+            target_nodes = await client._determine_nodes(*cmd.args)
+            if not target_nodes:
+                raise RedisClusterException(
+                    f"No targets were found to execute {cmd.args} command on"
+                )
+            if len(target_nodes) > 1:
+                raise RedisClusterException(f"Too many targets for command {cmd.args}")
 
-                node = target_nodes[0]
-                if node.name not in nodes:
-                    nodes[node.name] = node
-                    node._command_stack = []
-                node._command_stack.append(cmd)
+            node = target_nodes[0]
+            if node.name not in nodes:
+                nodes[node.name] = node
+                node._command_stack = []
+            node._command_stack.append(cmd)
 
-        await asyncio.gather(
+        errors = await asyncio.gather(
             *(asyncio.ensure_future(node.execute_pipeline()) for node in nodes.values())
         )
 
-        if allow_redirections:
-            # send each errored command individually
-            for cmd in stack:
-                if isinstance(cmd.result, (TryAgainError, MovedError, AskError)):
-                    try:
-                        cmd.result = await client.execute_command(
-                            *cmd.args, **cmd.kwargs
+        if any(errors):
+            if allow_redirections:
+                # send each errored command individually
+                for cmd in todo:
+                    if isinstance(cmd.result, (TryAgainError, MovedError, AskError)):
+                        try:
+                            cmd.result = await client.execute_command(
+                                *cmd.args, **cmd.kwargs
+                            )
+                        except Exception as e:
+                            cmd.result = e
+
+            if raise_on_error:
+                for cmd in todo:
+                    result = cmd.result
+                    if isinstance(result, Exception):
+                        command = " ".join(map(safe_str, cmd.args))
+                        msg = (
+                            f"Command # {cmd.position + 1} ({command}) of pipeline "
+                            f"caused error: {result.args}"
                         )
-                    except Exception as e:
-                        cmd.result = e
-
-        responses = [cmd.result for cmd in stack]
-
-        if raise_on_error:
-            for cmd in stack:
-                result = cmd.result
-                if isinstance(result, Exception):
-                    command = " ".join(map(safe_str, cmd.args))
-                    msg = (
-                        f"Command # {cmd.position + 1} ({command}) of pipeline "
-                        f"caused error: {result.args}"
-                    )
-                    result.args = (msg,) + result.args[1:]
-                    raise result
+                        result.args = (msg,) + result.args[1:]
+                        raise result
 
-        return responses
+        return [cmd.result for cmd in stack]
 
     def _split_command_across_slots(
         self, command: str, *keys: KeyT
diff --git a/redis/asyncio/parser.py b/redis/asyncio/parser.py
index 628635132b..9518c3f1a5 100644
--- a/redis/asyncio/parser.py
+++ b/redis/asyncio/parser.py
@@ -22,13 +22,16 @@ class CommandsParser:
     So, don't use this with EVAL or EVALSHA.
     """
 
-    __slots__ = ("commands",)
+    __slots__ = ("commands", "node")
 
     def __init__(self) -> None:
         self.commands: Dict[str, Union[int, Dict[str, Any]]] = {}
 
-    async def initialize(self, r: "ClusterNode") -> None:
-        commands = await r.execute_command("COMMAND")
+    async def initialize(self, node: Optional["ClusterNode"] = None) -> None:
+        if node:
+            self.node = node
+
+        commands = await self.node.execute_command("COMMAND")
         for cmd, command in commands.items():
             if "movablekeys" in command["flags"]:
                 commands[cmd] = -1
@@ -41,9 +44,7 @@ async def initialize(self, r: "ClusterNode") -> None:
     # As soon as this PR is merged into Redis, we should reimplement
     # our logic to use COMMAND INFO changes to determine the key positions
     # https://github.com/redis/redis/pull/8324
-    async def get_keys(
-        self, redis_conn: "ClusterNode", *args: Any
-    ) -> Optional[Tuple[str, ...]]:
+    async def get_keys(self, *args: Any) -> Optional[Tuple[str, ...]]:
         if len(args) < 2:
             # The command has no keys in it
             return None
@@ -58,7 +59,7 @@ async def get_keys(
             if cmd_name not in self.commands:
                 # We'll try to reinitialize the commands cache, if the engine
                 # version has changed, the commands may not be current
-                await self.initialize(redis_conn)
+                await self.initialize()
                 if cmd_name not in self.commands:
                     raise RedisError(
                         f"{cmd_name.upper()} command doesn't exist in Redis commands"
@@ -71,18 +72,16 @@ async def get_keys(
         if command == 0:
             return None
         if command == -1:
-            return await self._get_moveable_keys(redis_conn, *args)
+            return await self._get_moveable_keys(*args)
 
         last_key_pos = command["last_key_pos"]
         if last_key_pos < 0:
             last_key_pos = len(args) + last_key_pos
         return args[command["first_key_pos"] : last_key_pos + 1 : command["step_count"]]
 
-    async def _get_moveable_keys(
-        self, redis_conn: "ClusterNode", *args: Any
-    ) -> Optional[Tuple[str, ...]]:
+    async def _get_moveable_keys(self, *args: Any) -> Optional[Tuple[str, ...]]:
         try:
-            keys = await redis_conn.execute_command("COMMAND GETKEYS", *args)
+            keys = await self.node.execute_command("COMMAND GETKEYS", *args)
         except ResponseError as e:
             message = e.__str__()
             if (

From fa0be7671de6be85f859cbb57a31531b2482c9e1 Mon Sep 17 00:00:00 2001
From: Anas <anas.el.amraoui@live.com>
Date: Wed, 1 Jun 2022 14:59:02 +0300
Subject: [PATCH 0508/1164] Made sync lock consistent and added types to it
 (#2137)

* Made sync lock consistent and added types to it

* Made linters happy

* Fixed cluster client lock signature

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/client.py    |  8 ++++++
 redis/cluster.py   |  8 ++++++
 redis/lock.py      | 68 +++++++++++++++++++++++++++++-----------------
 redis/typing.py    |  1 +
 tests/test_lock.py | 20 ++++++++++++++
 5 files changed, 80 insertions(+), 25 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 58668eebf4..fcc2758dae 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1098,6 +1098,7 @@ def lock(
         name,
         timeout=None,
         sleep=0.1,
+        blocking=True,
         blocking_timeout=None,
         lock_class=None,
         thread_local=True,
@@ -1113,6 +1114,12 @@ def lock(
         when the lock is in blocking mode and another client is currently
         holding the lock.
 
+        ``blocking`` indicates whether calling ``acquire`` should block until
+        the lock has been acquired or to fail immediately, causing ``acquire``
+        to return False and the lock not being acquired. Defaults to True.
+        Note this value can be overridden by passing a ``blocking``
+        argument to ``acquire``.
+
         ``blocking_timeout`` indicates the maximum amount of time in seconds to
         spend trying to acquire the lock. A value of ``None`` indicates
         continue trying forever. ``blocking_timeout`` can be specified as a
@@ -1155,6 +1162,7 @@ def lock(
             name,
             timeout=timeout,
             sleep=sleep,
+            blocking=blocking,
             blocking_timeout=blocking_timeout,
             thread_local=thread_local,
         )
diff --git a/redis/cluster.py b/redis/cluster.py
index a88792bc22..8e4c654c6b 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -766,6 +766,7 @@ def lock(
         name,
         timeout=None,
         sleep=0.1,
+        blocking=True,
         blocking_timeout=None,
         lock_class=None,
         thread_local=True,
@@ -781,6 +782,12 @@ def lock(
         when the lock is in blocking mode and another client is currently
         holding the lock.
 
+        ``blocking`` indicates whether calling ``acquire`` should block until
+        the lock has been acquired or to fail immediately, causing ``acquire``
+        to return False and the lock not being acquired. Defaults to True.
+        Note this value can be overridden by passing a ``blocking``
+        argument to ``acquire``.
+
         ``blocking_timeout`` indicates the maximum amount of time in seconds to
         spend trying to acquire the lock. A value of ``None`` indicates
         continue trying forever. ``blocking_timeout`` can be specified as a
@@ -823,6 +830,7 @@ def lock(
             name,
             timeout=timeout,
             sleep=sleep,
+            blocking=blocking,
             blocking_timeout=blocking_timeout,
             thread_local=thread_local,
         )
diff --git a/redis/lock.py b/redis/lock.py
index 74e769bfea..c509f7d9db 100644
--- a/redis/lock.py
+++ b/redis/lock.py
@@ -1,9 +1,11 @@
 import threading
 import time as mod_time
 import uuid
-from types import SimpleNamespace
+from types import SimpleNamespace, TracebackType
+from typing import Optional, Type
 
 from redis.exceptions import LockError, LockNotOwnedError
+from redis.typing import Number
 
 
 class Lock:
@@ -74,12 +76,13 @@ class Lock:
     def __init__(
         self,
         redis,
-        name,
-        timeout=None,
-        sleep=0.1,
-        blocking=True,
-        blocking_timeout=None,
-        thread_local=True,
+        name: str,
+        *,
+        timeout: Optional[Number] = None,
+        sleep: Number = 0.1,
+        blocking: bool = True,
+        blocking_timeout: Optional[Number] = None,
+        thread_local: bool = True,
     ):
         """
         Create a new Lock instance named ``name`` using the Redis client
@@ -142,7 +145,7 @@ def __init__(
         self.local.token = None
         self.register_scripts()
 
-    def register_scripts(self):
+    def register_scripts(self) -> None:
         cls = self.__class__
         client = self.redis
         if cls.lua_release is None:
@@ -152,15 +155,27 @@ def register_scripts(self):
         if cls.lua_reacquire is None:
             cls.lua_reacquire = client.register_script(cls.LUA_REACQUIRE_SCRIPT)
 
-    def __enter__(self):
+    def __enter__(self) -> "Lock":
         if self.acquire():
             return self
         raise LockError("Unable to acquire lock within the time specified")
 
-    def __exit__(self, exc_type, exc_value, traceback):
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_value: Optional[BaseException],
+        traceback: Optional[TracebackType],
+    ) -> None:
         self.release()
 
-    def acquire(self, blocking=None, blocking_timeout=None, token=None):
+    def acquire(
+        self,
+        *,
+        sleep: Optional[Number] = None,
+        blocking: Optional[bool] = None,
+        blocking_timeout: Optional[Number] = None,
+        token: Optional[str] = None,
+    ):
         """
         Use Redis to hold a shared, distributed lock named ``name``.
         Returns True once the lock is acquired.
@@ -176,7 +191,8 @@ def acquire(self, blocking=None, blocking_timeout=None, token=None):
         object with the default encoding. If a token isn't specified, a UUID
         will be generated.
         """
-        sleep = self.sleep
+        if sleep is None:
+            sleep = self.sleep
         if token is None:
             token = uuid.uuid1().hex.encode()
         else:
@@ -200,7 +216,7 @@ def acquire(self, blocking=None, blocking_timeout=None, token=None):
                 return False
             mod_time.sleep(sleep)
 
-    def do_acquire(self, token):
+    def do_acquire(self, token: str) -> bool:
         if self.timeout:
             # convert to milliseconds
             timeout = int(self.timeout * 1000)
@@ -210,13 +226,13 @@ def do_acquire(self, token):
             return True
         return False
 
-    def locked(self):
+    def locked(self) -> bool:
         """
         Returns True if this key is locked by any process, otherwise False.
         """
         return self.redis.get(self.name) is not None
 
-    def owned(self):
+    def owned(self) -> bool:
         """
         Returns True if this key is locked by this lock, otherwise False.
         """
@@ -228,21 +244,23 @@ def owned(self):
             stored_token = encoder.encode(stored_token)
         return self.local.token is not None and stored_token == self.local.token
 
-    def release(self):
-        "Releases the already acquired lock"
+    def release(self) -> None:
+        """
+        Releases the already acquired lock
+        """
         expected_token = self.local.token
         if expected_token is None:
             raise LockError("Cannot release an unlocked lock")
         self.local.token = None
         self.do_release(expected_token)
 
-    def do_release(self, expected_token):
+    def do_release(self, expected_token: str) -> None:
         if not bool(
             self.lua_release(keys=[self.name], args=[expected_token], client=self.redis)
         ):
             raise LockNotOwnedError("Cannot release a lock" " that's no longer owned")
 
-    def extend(self, additional_time, replace_ttl=False):
+    def extend(self, additional_time: int, replace_ttl: bool = False) -> bool:
         """
         Adds more time to an already acquired lock.
 
@@ -259,19 +277,19 @@ def extend(self, additional_time, replace_ttl=False):
             raise LockError("Cannot extend a lock with no timeout")
         return self.do_extend(additional_time, replace_ttl)
 
-    def do_extend(self, additional_time, replace_ttl):
+    def do_extend(self, additional_time: int, replace_ttl: bool) -> bool:
         additional_time = int(additional_time * 1000)
         if not bool(
             self.lua_extend(
                 keys=[self.name],
-                args=[self.local.token, additional_time, replace_ttl and "1" or "0"],
+                args=[self.local.token, additional_time, "1" if replace_ttl else "0"],
                 client=self.redis,
             )
         ):
-            raise LockNotOwnedError("Cannot extend a lock that's" " no longer owned")
+            raise LockNotOwnedError("Cannot extend a lock that's no longer owned")
         return True
 
-    def reacquire(self):
+    def reacquire(self) -> bool:
         """
         Resets a TTL of an already acquired lock back to a timeout value.
         """
@@ -281,12 +299,12 @@ def reacquire(self):
             raise LockError("Cannot reacquire a lock with no timeout")
         return self.do_reacquire()
 
-    def do_reacquire(self):
+    def do_reacquire(self) -> bool:
         timeout = int(self.timeout * 1000)
         if not bool(
             self.lua_reacquire(
                 keys=[self.name], args=[self.local.token, timeout], client=self.redis
             )
         ):
-            raise LockNotOwnedError("Cannot reacquire a lock that's" " no longer owned")
+            raise LockNotOwnedError("Cannot reacquire a lock that's no longer owned")
         return True
diff --git a/redis/typing.py b/redis/typing.py
index 6748612ff1..b572b0cf1d 100644
--- a/redis/typing.py
+++ b/redis/typing.py
@@ -11,6 +11,7 @@
     from redis.connection import ConnectionPool, Encoder
 
 
+Number = Union[int, float]
 EncodedT = Union[bytes, memoryview]
 DecodedT = Union[str, int, float]
 EncodableT = Union[EncodedT, DecodedT]
diff --git a/tests/test_lock.py b/tests/test_lock.py
index 0a63f1e06c..10ad7e1539 100644
--- a/tests/test_lock.py
+++ b/tests/test_lock.py
@@ -116,6 +116,16 @@ def test_context_manager(self, r):
             assert r.get("foo") == lock.local.token
         assert r.get("foo") is None
 
+    def test_context_manager_blocking_timeout(self, r):
+        with self.get_lock(r, "foo", blocking=False):
+            bt = 0.4
+            sleep = 0.05
+            lock2 = self.get_lock(r, "foo", sleep=sleep, blocking_timeout=bt)
+            start = time.monotonic()
+            assert not lock2.acquire()
+            # The elapsed duration should be less than the total blocking_timeout
+            assert bt > (time.monotonic() - start) > bt - sleep
+
     def test_context_manager_raises_when_locked_not_acquired(self, r):
         r.set("foo", "bar")
         with pytest.raises(LockError):
@@ -221,6 +231,16 @@ def test_reacquiring_lock_no_longer_owned_raises_error(self, r):
         with pytest.raises(LockNotOwnedError):
             lock.reacquire()
 
+    def test_context_manager_reacquiring_lock_with_no_timeout_raises_error(self, r):
+        with self.get_lock(r, "foo", timeout=None, blocking=False) as lock:
+            with pytest.raises(LockError):
+                lock.reacquire()
+
+    def test_context_manager_reacquiring_lock_no_longer_owned_raises_error(self, r):
+        with pytest.raises(LockNotOwnedError):
+            with self.get_lock(r, "foo", timeout=10, blocking=False):
+                r.set("foo", "a")
+
 
 class TestLockClassSelection:
     def test_lock_class_argument(self, r):

From 3081a32b3852276999bb250655e4dfe2c87c654c Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 1 Jun 2022 16:46:21 +0300
Subject: [PATCH 0509/1164] SHUTDOWN - add support for the new NOW, FORCE and
 ABORT modifiers (#2150)

* add support for NOW, FORCE and ABORT modifiers

* linters

* test

* linters

* test params

* fix tests

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/commands/core.py | 43 ++++++++++++++++++++++++++++++++++++------
 tests/test_commands.py | 14 ++++++++++++++
 2 files changed, 51 insertions(+), 6 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index ab246a7b81..a337d4f314 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1153,12 +1153,25 @@ def save(self, **kwargs) -> ResponseT:
         """
         return self.execute_command("SAVE", **kwargs)
 
-    def shutdown(self, save: bool = False, nosave: bool = False, **kwargs) -> None:
+    def shutdown(
+        self,
+        save: bool = False,
+        nosave: bool = False,
+        now: bool = False,
+        force: bool = False,
+        abort: bool = False,
+        **kwargs,
+    ) -> None:
         """Shutdown the Redis server.  If Redis has persistence configured,
-        data will be flushed before shutdown.  If the "save" option is set,
-        a data flush will be attempted even if there is no persistence
-        configured.  If the "nosave" option is set, no data flush will be
-        attempted.  The "save" and "nosave" options cannot both be set.
+        data will be flushed before shutdown.
+        It is possible to specify modifiers to alter the behavior of the command:
+        ``save`` will force a DB saving operation even if no save points are configured.
+        ``nosave`` will prevent a DB saving operation even if one or more save points
+        are configured.
+        ``now`` skips waiting for lagging replicas, i.e. it bypasses the first step in
+        the shutdown sequence.
+        ``force`` ignores any errors that would normally prevent the server from exiting
+        ``abort`` cancels an ongoing shutdown and cannot be combined with other flags.
 
         For more information see https://redis.io/commands/shutdown
         """
@@ -1169,6 +1182,12 @@ def shutdown(self, save: bool = False, nosave: bool = False, **kwargs) -> None:
             args.append("SAVE")
         if nosave:
             args.append("NOSAVE")
+        if now:
+            args.append("NOW")
+        if force:
+            args.append("FORCE")
+        if abort:
+            args.append("ABORT")
         try:
             self.execute_command(*args, **kwargs)
         except ConnectionError:
@@ -1279,7 +1298,13 @@ async def memory_help(self, **kwargs) -> None:
         return super().memory_help(**kwargs)
 
     async def shutdown(
-        self, save: bool = False, nosave: bool = False, **kwargs
+        self,
+        save: bool = False,
+        nosave: bool = False,
+        now: bool = False,
+        force: bool = False,
+        abort: bool = False,
+        **kwargs,
     ) -> None:
         """Shutdown the Redis server.  If Redis has persistence configured,
         data will be flushed before shutdown.  If the "save" option is set,
@@ -1296,6 +1321,12 @@ async def shutdown(
             args.append("SAVE")
         if nosave:
             args.append("NOSAVE")
+        if now:
+            args.append("NOW")
+        if force:
+            args.append("FORCE")
+        if abort:
+            args.append("ABORT")
         try:
             await self.execute_command(*args, **kwargs)
         except ConnectionError:
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 1ae6219a9e..fcd2ed1c0c 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -3,6 +3,7 @@
 import re
 import time
 from string import ascii_letters
+from unittest import mock
 
 import pytest
 
@@ -4631,6 +4632,19 @@ def test_replicaof(self, r):
             assert r.replicaof("NO ONE")
         assert r.replicaof("NO", "ONE")
 
+    def test_shutdown(self, r: redis.Redis):
+        r.execute_command = mock.MagicMock()
+        r.execute_command("SHUTDOWN", "NOSAVE")
+        r.execute_command.assert_called_once_with("SHUTDOWN", "NOSAVE")
+
+    @skip_if_server_version_lt("7.0.0")
+    def test_shutdown_with_params(self, r: redis.Redis):
+        r.execute_command = mock.MagicMock()
+        r.execute_command("SHUTDOWN", "SAVE", "NOW", "FORCE")
+        r.execute_command.assert_called_once_with("SHUTDOWN", "SAVE", "NOW", "FORCE")
+        r.execute_command("SHUTDOWN", "ABORT")
+        r.execute_command.assert_called_with("SHUTDOWN", "ABORT")
+
     @pytest.mark.replica
     @skip_if_server_version_lt("2.8.0")
     @skip_if_redis_enterprise()

From a2365d1582dc59d28c262cd410c0b126a4e5adc6 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 1 Jun 2022 16:46:39 +0300
Subject: [PATCH 0510/1164] 4.3.2 (#2207)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 16387990fc..767d1049d8 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.3.1",
+    version="4.3.2",
     packages=find_packages(
         include=[
             "redis",

From 535a612d6365f64220ec80384dcecd4a8f0095e3 Mon Sep 17 00:00:00 2001
From: Utkarsh Gupta <utkarshgupta137@gmail.com>
Date: Thu, 2 Jun 2022 19:48:16 +0530
Subject: [PATCH 0511/1164] async_cluster: improve docs (#2208)

- move response_callbacks kwarg inside __init__ to hide it from docs
- use :member-order: bysource to group similar commands together
---
 docs/connections.rst     |  7 ++--
 redis/asyncio/cluster.py | 73 ++++++++++++++++++++--------------------
 2 files changed, 42 insertions(+), 38 deletions(-)

diff --git a/docs/connections.rst b/docs/connections.rst
index b481689b9b..1c826a0cf8 100644
--- a/docs/connections.rst
+++ b/docs/connections.rst
@@ -70,16 +70,19 @@ RedisCluster (Async)
 ====================
 .. autoclass:: redis.asyncio.cluster.RedisCluster
     :members:
+    :member-order: bysource
 
 ClusterNode (Async)
 ===================
 .. autoclass:: redis.asyncio.cluster.ClusterNode
     :members:
+    :member-order: bysource
 
 ClusterPipeline (Async)
-===================
+=======================
 .. autoclass:: redis.asyncio.cluster.ClusterPipeline
-    :members:
+    :members: execute_command, execute
+    :member-order: bysource
 
 
 Connection
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index b53f8487e2..89789b7d75 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -379,14 +379,9 @@ async def on_connect(self, connection: Connection) -> None:
             if str_if_bytes(await connection.read_response_without_lock()) != "OK":
                 raise ConnectionError("READONLY command failed")
 
-    def get_node(
-        self,
-        host: Optional[str] = None,
-        port: Optional[int] = None,
-        node_name: Optional[str] = None,
-    ) -> Optional["ClusterNode"]:
-        """Get node by (host, port) or node_name."""
-        return self.nodes_manager.get_node(host, port, node_name)
+    def get_nodes(self) -> List["ClusterNode"]:
+        """Get all nodes of the cluster."""
+        return list(self.nodes_manager.nodes_cache.values())
 
     def get_primaries(self) -> List["ClusterNode"]:
         """Get the primary nodes of the cluster."""
@@ -400,9 +395,29 @@ def get_random_node(self) -> "ClusterNode":
         """Get a random node of the cluster."""
         return random.choice(list(self.nodes_manager.nodes_cache.values()))
 
-    def get_nodes(self) -> List["ClusterNode"]:
-        """Get all nodes of the cluster."""
-        return list(self.nodes_manager.nodes_cache.values())
+    def get_default_node(self) -> "ClusterNode":
+        """Get the default node of the client."""
+        return self.nodes_manager.default_node
+
+    def set_default_node(self, node: "ClusterNode") -> None:
+        """
+        Set the default node of the client.
+
+        :raises DataError: if None is passed or node does not exist in cluster.
+        """
+        if not node or not self.get_node(node_name=node.name):
+            raise DataError("The requested node does not exist in the cluster.")
+
+        self.nodes_manager.default_node = node
+
+    def get_node(
+        self,
+        host: Optional[str] = None,
+        port: Optional[int] = None,
+        node_name: Optional[str] = None,
+    ) -> Optional["ClusterNode"]:
+        """Get node by (host, port) or node_name."""
+        return self.nodes_manager.get_node(host, port, node_name)
 
     def get_node_from_key(
         self, key: str, replica: bool = False
@@ -413,6 +428,7 @@ def get_node_from_key(
         :param key:
         :param replica:
             | Indicates if a replica should be returned
+            |
               None will returned if no replica holds this key
 
         :raises SlotNotCoveredError: if the key is not covered by any slot.
@@ -431,24 +447,13 @@ def get_node_from_key(
 
         return slot_cache[node_idx]
 
-    def get_default_node(self) -> "ClusterNode":
-        """Get the default node of the client."""
-        return self.nodes_manager.default_node
-
-    def set_default_node(self, node: "ClusterNode") -> None:
+    def keyslot(self, key: EncodableT) -> int:
         """
-        Set the default node of the client.
+        Find the keyslot for a given key.
 
-        :raises DataError: if None is passed or node does not exist in cluster.
+        See: https://redis.io/docs/manual/scaling/#redis-cluster-data-sharding
         """
-        if not node or not self.get_node(node_name=node.name):
-            raise DataError("The requested node does not exist in the cluster.")
-
-        self.nodes_manager.default_node = node
-
-    def set_response_callback(self, command: str, callback: ResponseCallbackT) -> None:
-        """Set a custom response callback."""
-        self.response_callbacks[command] = callback
+        return key_slot(self.encoder.encode(key))
 
     def get_encoder(self) -> Encoder:
         """Get the encoder object of the client."""
@@ -458,14 +463,9 @@ def get_connection_kwargs(self) -> Dict[str, Optional[Any]]:
         """Get the kwargs passed to :class:`~redis.asyncio.connection.Connection`."""
         return self.connection_kwargs
 
-    def keyslot(self, key: EncodableT) -> int:
-        """
-        Find the keyslot for a given key.
-
-        See: https://redis.io/docs/manual/scaling/#redis-cluster-data-sharding
-        """
-        k = self.encoder.encode(key)
-        return key_slot(k)
+    def set_response_callback(self, command: str, callback: ResponseCallbackT) -> None:
+        """Set a custom response callback."""
+        self.response_callbacks[command] = callback
 
     async def _determine_nodes(
         self, command: str, *args: Any, node_flag: Optional[str] = None
@@ -776,7 +776,6 @@ def __init__(
         server_type: Optional[str] = None,
         max_connections: int = 2**31,
         connection_class: Type[Connection] = Connection,
-        response_callbacks: Dict[str, Any] = RedisCluster.RESPONSE_CALLBACKS,
         **connection_kwargs: Any,
     ) -> None:
         if host == "localhost":
@@ -792,7 +791,9 @@ def __init__(
         self.max_connections = max_connections
         self.connection_class = connection_class
         self.connection_kwargs = connection_kwargs
-        self.response_callbacks = response_callbacks
+        self.response_callbacks = connection_kwargs.pop(
+            "response_callbacks", RedisCluster.RESPONSE_CALLBACKS
+        )
 
         self._connections: List[Connection] = []
         self._free: Deque[Connection] = collections.deque(maxlen=self.max_connections)

From bedf3c82a55b4b67eed93f686cb17e82f7ab19cd Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 2 Jun 2022 17:41:09 +0300
Subject: [PATCH 0512/1164] Fix Lock crash, and versioning 4.3.3 (#2210)

* fix lock

* v4.3.3
---
 redis/lock.py | 1 -
 setup.py      | 2 +-
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/redis/lock.py b/redis/lock.py
index c509f7d9db..650d0ae56c 100644
--- a/redis/lock.py
+++ b/redis/lock.py
@@ -77,7 +77,6 @@ def __init__(
         self,
         redis,
         name: str,
-        *,
         timeout: Optional[Number] = None,
         sleep: Number = 0.1,
         blocking: bool = True,
diff --git a/setup.py b/setup.py
index 767d1049d8..a7ab3641b6 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.3.2",
+    version="4.3.3",
     packages=find_packages(
         include=[
             "redis",

From 41b537d9195ee8e4ab897951ba6563b367c28b7d Mon Sep 17 00:00:00 2001
From: Falk <falk-h@users.noreply.github.com>
Date: Sun, 19 Jun 2022 03:37:12 +0200
Subject: [PATCH 0513/1164] Uppercase commands in CommandsParser.get_keys
 (#2236)

---
 CHANGES                 | 1 +
 redis/asyncio/parser.py | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/CHANGES b/CHANGES
index b7e238ebb3..2678218041 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,4 +1,5 @@
 
+    * Compare commands case-insensitively in the asyncio command parser
     * Allow negative `retries` for `Retry` class to retry forever
     * Add `items` parameter to `hset` signature
     * Create codeql-analysis.yml (#1988). Thanks @chayim
diff --git a/redis/asyncio/parser.py b/redis/asyncio/parser.py
index 9518c3f1a5..5faf8f8c57 100644
--- a/redis/asyncio/parser.py
+++ b/redis/asyncio/parser.py
@@ -55,14 +55,14 @@ async def get_keys(self, *args: Any) -> Optional[Tuple[str, ...]]:
             # try to split the command name and to take only the main command
             # e.g. 'memory' for 'memory usage'
             args = args[0].split() + list(args[1:])
-            cmd_name = args[0]
+            cmd_name = args[0].upper()
             if cmd_name not in self.commands:
                 # We'll try to reinitialize the commands cache, if the engine
                 # version has changed, the commands may not be current
                 await self.initialize()
                 if cmd_name not in self.commands:
                     raise RedisError(
-                        f"{cmd_name.upper()} command doesn't exist in Redis commands"
+                        f"{cmd_name} command doesn't exist in Redis commands"
                     )
 
             command = self.commands[cmd_name]

From 2ee61f0b5c54df54ebfc382eea2661d709ce9c73 Mon Sep 17 00:00:00 2001
From: earthgecko <96679+earthgecko@users.noreply.github.com>
Date: Sun, 19 Jun 2022 02:39:56 +0100
Subject: [PATCH 0514/1164] Correct retention_msecs value (#2232)

The `retention_msecs` takes a millisecond value not a seconds value, having checked and tested redis/commands/timeseries/commands.py is not adjusting seconds to milliseconds it is passing it through as is, therefore the statement in this doc is incorrect as it creates a time series with a retention period of 5 milliseconds not 5 seconds as stated.
---
 docs/redismodules.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/redismodules.rst b/docs/redismodules.rst
index e4d36b180c..86a323a925 100644
--- a/docs/redismodules.rst
+++ b/docs/redismodules.rst
@@ -134,7 +134,7 @@ These are the commands for interacting with the `RedisTimeSeries module <https:/
 
     import redis
     r = redis.Redis()
-    r.ts().create(2, retension_msecs=5)
+    r.ts().create(2, retension_msecs=5000)
 
 .. automodule:: redis.commands.timeseries.commands
     :members: TimeSeriesCommands

From 33702983b8b0a55d29189babb631ea108ee8404f Mon Sep 17 00:00:00 2001
From: Utkarsh Gupta <utkarshgupta137@gmail.com>
Date: Sun, 19 Jun 2022 07:16:02 +0530
Subject: [PATCH 0515/1164] async_cluster: fix simultaneous initialize (#2231)

- close startup_nodes too during client.close(), in case they are different
---
 redis/asyncio/cluster.py           | 4 ++--
 tests/test_asyncio/test_cluster.py | 8 +++++---
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 89789b7d75..a7bea3029a 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -323,14 +323,13 @@ async def initialize(self) -> "RedisCluster":
         if self._initialize:
             async with self._lock:
                 if self._initialize:
-                    self._initialize = False
                     try:
                         await self.nodes_manager.initialize()
                         await self.commands_parser.initialize(
                             self.nodes_manager.default_node
                         )
+                        self._initialize = False
                     except BaseException:
-                        self._initialize = True
                         await self.nodes_manager.close()
                         await self.nodes_manager.close("startup_nodes")
                         raise
@@ -343,6 +342,7 @@ async def close(self) -> None:
                 if not self._initialize:
                     self._initialize = True
                     await self.nodes_manager.close()
+                    await self.nodes_manager.close("startup_nodes")
 
     async def __aenter__(self) -> "RedisCluster":
         return await self.initialize()
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 0c676cb2d7..e5ec0267ea 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -680,13 +680,15 @@ async def test_not_require_full_coverage_cluster_down_error(
                 else:
                     raise e
 
-    async def test_can_run_concurrent_commands(self, r: RedisCluster) -> None:
-        assert await r.ping(target_nodes=RedisCluster.ALL_NODES) is True
+    async def test_can_run_concurrent_commands(self, request: FixtureRequest) -> None:
+        url = request.config.getoption("--redis-url")
+        rc = RedisCluster.from_url(url)
         assert all(
             await asyncio.gather(
-                *(r.ping(target_nodes=RedisCluster.ALL_NODES) for _ in range(100))
+                *(rc.echo("i", target_nodes=RedisCluster.ALL_NODES) for i in range(100))
             )
         )
+        await rc.close()
 
 
 @pytest.mark.onlycluster

From bea72995fd39b01e2f0a1682b16b6c7690933f36 Mon Sep 17 00:00:00 2001
From: Eric Lemoine <eric.lemoine@getalma.eu>
Date: Sun, 19 Jun 2022 03:56:53 +0200
Subject: [PATCH 0516/1164] Fix retries in async mode (#2180)

* Avoid mutating a global retry_on_error list

* Make retries config consistent in sync and async

* Fix async retries

* Add new TestConnectionConstructorWithRetry tests
---
 redis/asyncio/client.py          | 17 +++++++++++---
 redis/asyncio/connection.py      | 17 ++++++++++++++
 redis/asyncio/retry.py           |  8 +++++++
 redis/client.py                  |  4 +++-
 redis/connection.py              |  8 +++++--
 tests/test_asyncio/test_retry.py | 38 +++++++++++++++++++++++++++++---
 6 files changed, 83 insertions(+), 9 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 6db54895f4..3d59016bb3 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -158,6 +158,7 @@ def __init__(
         encoding_errors: str = "strict",
         decode_responses: bool = False,
         retry_on_timeout: bool = False,
+        retry_on_error: Optional[list] = None,
         ssl: bool = False,
         ssl_keyfile: Optional[str] = None,
         ssl_certfile: Optional[str] = None,
@@ -176,8 +177,10 @@ def __init__(
     ):
         """
         Initialize a new Redis client.
-        To specify a retry policy, first set `retry_on_timeout` to `True`
-        then set `retry` to a valid `Retry` object
+        To specify a retry policy for specific errors, first set
+        `retry_on_error` to a list of the error/s to retry on, then set
+        `retry` to a valid `Retry` object.
+        To retry on TimeoutError, `retry_on_timeout` can also be set to `True`.
         """
         kwargs: Dict[str, Any]
         # auto_close_connection_pool only has an effect if connection_pool is
@@ -188,6 +191,10 @@ def __init__(
             auto_close_connection_pool if connection_pool is None else False
         )
         if not connection_pool:
+            if not retry_on_error:
+                retry_on_error = []
+            if retry_on_timeout is True:
+                retry_on_error.append(TimeoutError)
             kwargs = {
                 "db": db,
                 "username": username,
@@ -197,6 +204,7 @@ def __init__(
                 "encoding_errors": encoding_errors,
                 "decode_responses": decode_responses,
                 "retry_on_timeout": retry_on_timeout,
+                "retry_on_error": retry_on_error,
                 "retry": copy.deepcopy(retry),
                 "max_connections": max_connections,
                 "health_check_interval": health_check_interval,
@@ -461,7 +469,10 @@ async def _disconnect_raise(self, conn: Connection, error: Exception):
         is not a TimeoutError
         """
         await conn.disconnect()
-        if not (conn.retry_on_timeout and isinstance(error, TimeoutError)):
+        if (
+            conn.retry_on_error is None
+            or isinstance(error, tuple(conn.retry_on_error)) is False
+        ):
             raise error
 
     # COMMAND EXECUTION AND PROTOCOL PARSING
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 38465fc0d7..35536fc883 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -578,6 +578,7 @@ class Connection:
         "socket_type",
         "redis_connect_func",
         "retry_on_timeout",
+        "retry_on_error",
         "health_check_interval",
         "next_health_check",
         "last_active_at",
@@ -606,6 +607,7 @@ def __init__(
         socket_keepalive_options: Optional[Mapping[int, Union[int, bytes]]] = None,
         socket_type: int = 0,
         retry_on_timeout: bool = False,
+        retry_on_error: Union[list, _Sentinel] = SENTINEL,
         encoding: str = "utf-8",
         encoding_errors: str = "strict",
         decode_responses: bool = False,
@@ -631,12 +633,19 @@ def __init__(
         self.socket_keepalive_options = socket_keepalive_options or {}
         self.socket_type = socket_type
         self.retry_on_timeout = retry_on_timeout
+        if retry_on_error is SENTINEL:
+            retry_on_error = []
         if retry_on_timeout:
+            retry_on_error.append(TimeoutError)
+        self.retry_on_error = retry_on_error
+        if retry_on_error:
             if not retry:
                 self.retry = Retry(NoBackoff(), 1)
             else:
                 # deep-copy the Retry object as it is mutable
                 self.retry = copy.deepcopy(retry)
+            # Update the retry's supported errors with the specified errors
+            self.retry.update_supported_errors(retry_on_error)
         else:
             self.retry = Retry(NoBackoff(), 0)
         self.health_check_interval = health_check_interval
@@ -1169,6 +1178,7 @@ def __init__(
         encoding_errors: str = "strict",
         decode_responses: bool = False,
         retry_on_timeout: bool = False,
+        retry_on_error: Union[list, _Sentinel] = SENTINEL,
         parser_class: Type[BaseParser] = DefaultParser,
         socket_read_size: int = 65536,
         health_check_interval: float = 0.0,
@@ -1190,12 +1200,19 @@ def __init__(
         self.socket_timeout = socket_timeout
         self.socket_connect_timeout = socket_connect_timeout or socket_timeout or None
         self.retry_on_timeout = retry_on_timeout
+        if retry_on_error is SENTINEL:
+            retry_on_error = []
         if retry_on_timeout:
+            retry_on_error.append(TimeoutError)
+        self.retry_on_error = retry_on_error
+        if retry_on_error:
             if retry is None:
                 self.retry = Retry(NoBackoff(), 1)
             else:
                 # deep-copy the Retry object as it is mutable
                 self.retry = copy.deepcopy(retry)
+            # Update the retry's supported errors with the specified errors
+            self.retry.update_supported_errors(retry_on_error)
         else:
             self.retry = Retry(NoBackoff(), 0)
         self.health_check_interval = health_check_interval
diff --git a/redis/asyncio/retry.py b/redis/asyncio/retry.py
index 0934ad0d9f..7c5e3b0e7d 100644
--- a/redis/asyncio/retry.py
+++ b/redis/asyncio/retry.py
@@ -35,6 +35,14 @@ def __init__(
         self._retries = retries
         self._supported_errors = supported_errors
 
+    def update_supported_errors(self, specified_errors: list):
+        """
+        Updates the supported errors with the specified error types
+        """
+        self._supported_errors = tuple(
+            set(self._supported_errors + tuple(specified_errors))
+        )
+
     async def call_with_retry(
         self, do: Callable[[], Awaitable[T]], fail: Callable[[RedisError], Any]
     ) -> T:
diff --git a/redis/client.py b/redis/client.py
index fcc2758dae..86061d56d5 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -914,7 +914,7 @@ def __init__(
         errors=None,
         decode_responses=False,
         retry_on_timeout=False,
-        retry_on_error=[],
+        retry_on_error=None,
         ssl=False,
         ssl_keyfile=None,
         ssl_certfile=None,
@@ -958,6 +958,8 @@ def __init__(
                     )
                 )
                 encoding_errors = errors
+            if not retry_on_error:
+                retry_on_error = []
             if retry_on_timeout is True:
                 retry_on_error.append(TimeoutError)
             kwargs = {
diff --git a/redis/connection.py b/redis/connection.py
index 1bc2ae1f4e..3438bafe57 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -515,7 +515,7 @@ def __init__(
         socket_keepalive_options=None,
         socket_type=0,
         retry_on_timeout=False,
-        retry_on_error=[],
+        retry_on_error=SENTINEL,
         encoding="utf-8",
         encoding_errors="strict",
         decode_responses=False,
@@ -547,6 +547,8 @@ def __init__(
         self.socket_keepalive_options = socket_keepalive_options or {}
         self.socket_type = socket_type
         self.retry_on_timeout = retry_on_timeout
+        if retry_on_error is SENTINEL:
+            retry_on_error = []
         if retry_on_timeout:
             # Add TimeoutError to the errors list to retry on
             retry_on_error.append(TimeoutError)
@@ -1065,7 +1067,7 @@ def __init__(
         encoding_errors="strict",
         decode_responses=False,
         retry_on_timeout=False,
-        retry_on_error=[],
+        retry_on_error=SENTINEL,
         parser_class=DefaultParser,
         socket_read_size=65536,
         health_check_interval=0,
@@ -1088,6 +1090,8 @@ def __init__(
         self.password = password
         self.socket_timeout = socket_timeout
         self.retry_on_timeout = retry_on_timeout
+        if retry_on_error is SENTINEL:
+            retry_on_error = []
         if retry_on_timeout:
             # Add TimeoutError to the errors list to retry on
             retry_on_error.append(TimeoutError)
diff --git a/tests/test_asyncio/test_retry.py b/tests/test_asyncio/test_retry.py
index d696d72d1c..38e353bc36 100644
--- a/tests/test_asyncio/test_retry.py
+++ b/tests/test_asyncio/test_retry.py
@@ -3,7 +3,7 @@
 from redis.asyncio.connection import Connection, UnixDomainSocketConnection
 from redis.asyncio.retry import Retry
 from redis.backoff import AbstractBackoff, NoBackoff
-from redis.exceptions import ConnectionError
+from redis.exceptions import ConnectionError, TimeoutError
 
 
 class BackoffMock(AbstractBackoff):
@@ -22,9 +22,28 @@ def compute(self, failures):
 class TestConnectionConstructorWithRetry:
     "Test that the Connection constructors properly handles Retry objects"
 
+    @pytest.mark.parametrize("Class", [Connection, UnixDomainSocketConnection])
+    def test_retry_on_error_set(self, Class):
+        class CustomError(Exception):
+            pass
+
+        retry_on_error = [ConnectionError, TimeoutError, CustomError]
+        c = Class(retry_on_error=retry_on_error)
+        assert c.retry_on_error == retry_on_error
+        assert isinstance(c.retry, Retry)
+        assert c.retry._retries == 1
+        assert set(c.retry._supported_errors) == set(retry_on_error)
+
+    @pytest.mark.parametrize("Class", [Connection, UnixDomainSocketConnection])
+    def test_retry_on_error_not_set(self, Class):
+        c = Class()
+        assert c.retry_on_error == []
+        assert isinstance(c.retry, Retry)
+        assert c.retry._retries == 0
+
     @pytest.mark.parametrize("retry_on_timeout", [False, True])
     @pytest.mark.parametrize("Class", [Connection, UnixDomainSocketConnection])
-    def test_retry_on_timeout_boolean(self, Class, retry_on_timeout):
+    def test_retry_on_timeout(self, Class, retry_on_timeout):
         c = Class(retry_on_timeout=retry_on_timeout)
         assert c.retry_on_timeout == retry_on_timeout
         assert isinstance(c.retry, Retry)
@@ -32,13 +51,26 @@ def test_retry_on_timeout_boolean(self, Class, retry_on_timeout):
 
     @pytest.mark.parametrize("retries", range(10))
     @pytest.mark.parametrize("Class", [Connection, UnixDomainSocketConnection])
-    def test_retry_on_timeout_retry(self, Class, retries: int):
+    def test_retry_with_retry_on_timeout(self, Class, retries: int):
         retry_on_timeout = retries > 0
         c = Class(retry_on_timeout=retry_on_timeout, retry=Retry(NoBackoff(), retries))
         assert c.retry_on_timeout == retry_on_timeout
         assert isinstance(c.retry, Retry)
         assert c.retry._retries == retries
 
+    @pytest.mark.parametrize("retries", range(10))
+    @pytest.mark.parametrize("Class", [Connection, UnixDomainSocketConnection])
+    def test_retry_with_retry_on_error(self, Class, retries: int):
+        class CustomError(Exception):
+            pass
+
+        retry_on_error = [ConnectionError, TimeoutError, CustomError]
+        c = Class(retry_on_error=retry_on_error, retry=Retry(NoBackoff(), retries))
+        assert c.retry_on_error == retry_on_error
+        assert isinstance(c.retry, Retry)
+        assert c.retry._retries == retries
+        assert set(c.retry._supported_errors) == set(retry_on_error)
+
 
 class TestRetry:
     "Test that Retry calls backoff and retries the expected number of times"

From 23fd3273ba4dbee35585f53208dc044112dd391f Mon Sep 17 00:00:00 2001
From: Iglesys <g.imbert34@gmail.com>
Date: Thu, 23 Jun 2022 13:33:04 +0200
Subject: [PATCH 0517/1164] DOC add pipeline examples (#2240)

* DOC add pipeline examples

* Add pipeline notebook to the example.rst file

* retrigger checks
---
 docs/examples.rst                     |   3 +-
 docs/examples/pipeline_examples.ipynb | 308 ++++++++++++++++++++++++++
 2 files changed, 310 insertions(+), 1 deletion(-)
 create mode 100644 docs/examples/pipeline_examples.ipynb

diff --git a/docs/examples.rst b/docs/examples.rst
index be577c0696..722fae2d03 100644
--- a/docs/examples.rst
+++ b/docs/examples.rst
@@ -10,4 +10,5 @@ Examples
    examples/asyncio_examples
    examples/search_json_examples
    examples/set_and_get_examples
-   examples/search_vector_similarity_examples
\ No newline at end of file
+   examples/search_vector_similarity_examples
+   examples/pipeline_examples
diff --git a/docs/examples/pipeline_examples.ipynb b/docs/examples/pipeline_examples.ipynb
new file mode 100644
index 0000000000..490d2213a0
--- /dev/null
+++ b/docs/examples/pipeline_examples.ipynb
@@ -0,0 +1,308 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Pipeline examples\n",
+    "\n",
+    "This example show quickly how to use pipelines in `redis-py`."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Checking that Redis is running"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 1,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "import redis \n",
+    "\n",
+    "r = redis.Redis(decode_responses=True)\n",
+    "r.ping()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Simple example"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Creating a pipeline instance"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "pipe = r.pipeline()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Adding commands to the pipeline"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "Pipeline<ConnectionPool<Connection<host=localhost,port=6379,db=0>>>"
+      ]
+     },
+     "execution_count": 3,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "pipe.set(\"a\", \"a value\")\n",
+    "pipe.set(\"b\", \"b value\")\n",
+    "\n",
+    "pipe.get(\"a\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Executing the pipeline"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[True, True, 'a value']"
+      ]
+     },
+     "execution_count": 4,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "pipe.execute()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The responses of the three commands are stored in a list. In the above example, the two first boolean indicates that the the `set` commands were successfull and the last element of the list is the result of the `get(\"a\")` comand."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Chained call\n",
+    "\n",
+    "The same result as above can be obtained in one line of code by chaining the opperations."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[True, True, 'a value']"
+      ]
+     },
+     "execution_count": 5,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "pipe = r.pipeline()\n",
+    "pipe.set(\"a\", \"a value\").set(\"b\", \"b value\").get(\"a\").execute()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Performance comparison\n",
+    "\n",
+    "Using pipelines can improve performance, for more informations, see [Redis documentation about pipelining](https://redis.io/docs/manual/pipelining/). Here is a simple comparison test of performance between basic and pipelined commands (we simply increment a value and measure the time taken by both method)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from datetime import datetime\n",
+    "\n",
+    "incr_value = 100000"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Without pipeline"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "r.set(\"incr_key\", \"0\")\n",
+    "\n",
+    "start = datetime.now()\n",
+    "\n",
+    "for _ in range(incr_value):\n",
+    "    r.incr(\"incr_key\")\n",
+    "res_without_pipeline = r.get(\"incr_key\")\n",
+    "\n",
+    "time_without_pipeline = (datetime.now() - start).total_seconds()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Without pipeline\n",
+      "================\n",
+      "Time taken:  21.759733\n",
+      "Increment value:  100000\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(\"Without pipeline\")\n",
+    "print(\"================\")\n",
+    "print(\"Time taken: \", time_without_pipeline)\n",
+    "print(\"Increment value: \", res_without_pipeline)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### With pipeline"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "r.set(\"incr_key\", \"0\")\n",
+    "\n",
+    "start = datetime.now()\n",
+    "\n",
+    "pipe = r.pipeline()\n",
+    "for _ in range(incr_value):\n",
+    "    pipe.incr(\"incr_key\")\n",
+    "pipe.get(\"incr_key\")\n",
+    "res_with_pipeline = pipe.execute()[-1]\n",
+    "\n",
+    "time_with_pipeline = (datetime.now() - start).total_seconds()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "With pipeline\n",
+      "=============\n",
+      "Time taken:  2.357863\n",
+      "Increment value:  100000\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(\"With pipeline\")\n",
+    "print(\"=============\")\n",
+    "print(\"Time taken: \", time_with_pipeline)\n",
+    "print(\"Increment value: \", res_with_pipeline)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Using pipelines provides the same result in much less time."
+   ]
+  }
+ ],
+ "metadata": {
+  "interpreter": {
+   "hash": "84048e2f8e89effc8610b2fb270e4858ef00e9403d223856d62b05266db287ca"
+  },
+  "kernelspec": {
+   "display_name": "Python 3.9.2 ('.venv': venv)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.9.2"
+  },
+  "orig_nbformat": 4
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

From 6da80865be650344964e9497a9edcb68ff102ee8 Mon Sep 17 00:00:00 2001
From: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Date: Thu, 23 Jun 2022 14:34:08 +0300
Subject: [PATCH 0518/1164] Reuse the old nodes' connections when a cluster
 topology refresh is being done (#2235)

* A fix was made to reuse the old nodes' connections when a cluster topology refresh is being done

* Fixed RedisCluster to immediately raise AuthenticationError

* Updated CHANGES

* Fixed cluster async bgsave test to ignore "bgsave already in progress" error

* Fixed linters
---
 CHANGES                            |  2 ++
 redis/cluster.py                   | 37 +++++++++++++++++++--------
 tests/test_asyncio/test_cluster.py | 10 +++++---
 tests/test_cluster.py              | 40 ++++++++++++++++++++++++++++++
 4 files changed, 75 insertions(+), 14 deletions(-)

diff --git a/CHANGES b/CHANGES
index 2678218041..4afc7bac2d 100644
--- a/CHANGES
+++ b/CHANGES
@@ -11,6 +11,8 @@
     * Fix broken connection writer lock-up for asyncio (#2065)
     * Fix auth bug when provided with no username (#2086)
     * Fix missing ClusterPipeline._lock (#2189)
+    * Fix reusing the old nodes' connections when cluster topology refresh is being done
+    * Fix RedisCluster to immediately raise AuthenticationError without a retry
 
 * 4.1.3 (Feb 8, 2022)
     * Fix flushdb and flushall (#1926)
diff --git a/redis/cluster.py b/redis/cluster.py
index 8e4c654c6b..1737ec75b1 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -14,6 +14,7 @@
 from redis.crc import REDIS_CLUSTER_HASH_SLOTS, key_slot
 from redis.exceptions import (
     AskError,
+    AuthenticationError,
     BusyLoadingError,
     ClusterCrossSlotError,
     ClusterDownError,
@@ -1113,7 +1114,7 @@ def _execute_command(self, target_node, *args, **kwargs):
                     )
                 return response
 
-            except (RedisClusterException, BusyLoadingError) as e:
+            except (RedisClusterException, BusyLoadingError, AuthenticationError) as e:
                 log.exception(type(e))
                 raise
             except (ConnectionError, TimeoutError) as e:
@@ -1134,6 +1135,7 @@ def _execute_command(self, target_node, *args, **kwargs):
                 else:
                     # Hard force of reinitialize of the node/slots setup
                     # and try again with the new setup
+                    target_node.redis_connection = None
                     self.nodes_manager.initialize()
                     raise
             except MovedError as e:
@@ -1443,6 +1445,21 @@ def create_redis_node(self, host, port, **kwargs):
             r = Redis(host=host, port=port, **kwargs)
         return r
 
+    def _get_or_create_cluster_node(self, host, port, role, tmp_nodes_cache):
+        node_name = get_node_name(host, port)
+        # check if we already have this node in the tmp_nodes_cache
+        target_node = tmp_nodes_cache.get(node_name)
+        if target_node is None:
+            # before creating a new cluster node, check if the cluster node already
+            # exists in the current nodes cache and has a valid connection so we can
+            # reuse it
+            target_node = self.nodes_cache.get(node_name)
+            if target_node is None or target_node.redis_connection is None:
+                # create new cluster node for this cluster
+                target_node = ClusterNode(host, port, role)
+
+        return target_node
+
     def initialize(self):
         """
         Initializes the nodes cache, slots cache and redis connections.
@@ -1521,14 +1538,14 @@ def initialize(self):
 
             for slot in cluster_slots:
                 primary_node = slot[2]
-                host = primary_node[0]
+                host = str_if_bytes(primary_node[0])
                 if host == "":
                     host = startup_node.host
                 port = int(primary_node[1])
 
-                target_node = tmp_nodes_cache.get(get_node_name(host, port))
-                if target_node is None:
-                    target_node = ClusterNode(host, port, PRIMARY)
+                target_node = self._get_or_create_cluster_node(
+                    host, port, PRIMARY, tmp_nodes_cache
+                )
                 # add this node to the nodes cache
                 tmp_nodes_cache[target_node.name] = target_node
 
@@ -1539,14 +1556,12 @@ def initialize(self):
                         replica_nodes = [slot[j] for j in range(3, len(slot))]
 
                         for replica_node in replica_nodes:
-                            host = replica_node[0]
+                            host = str_if_bytes(replica_node[0])
                             port = replica_node[1]
 
-                            target_replica_node = tmp_nodes_cache.get(
-                                get_node_name(host, port)
+                            target_replica_node = self._get_or_create_cluster_node(
+                                host, port, REPLICA, tmp_nodes_cache
                             )
-                            if target_replica_node is None:
-                                target_replica_node = ClusterNode(host, port, REPLICA)
                             tmp_slots[i].append(target_replica_node)
                             # add this node to the nodes cache
                             tmp_nodes_cache[
@@ -1598,7 +1613,7 @@ def initialize(self):
         # Set the default node
         self.default_node = self.get_nodes_by_server_type(PRIMARY)[0]
         # Populate the startup nodes with all discovered nodes
-        self.populate_startup_nodes(self.nodes_cache.values())
+        self.startup_nodes = tmp_nodes_cache
         # If initialize was called after a MovedError, clear it
         self._moved_exception = None
 
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index e5ec0267ea..f4ea5cd7ac 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -1059,9 +1059,13 @@ async def test_readwrite(self) -> None:
 
     @skip_if_redis_enterprise()
     async def test_bgsave(self, r: RedisCluster) -> None:
-        assert await r.bgsave()
-        await asyncio.sleep(0.3)
-        assert await r.bgsave(True)
+        try:
+            assert await r.bgsave()
+            await asyncio.sleep(0.3)
+            assert await r.bgsave(True)
+        except ResponseError as e:
+            if "Background save already in progress" not in e.__str__():
+                raise
 
     async def test_info(self, r: RedisCluster) -> None:
         # Map keys to same slot
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index d1568ef4de..438ef73a0e 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -29,6 +29,7 @@
     RedisClusterException,
     RedisError,
     ResponseError,
+    TimeoutError,
 )
 from redis.utils import str_if_bytes
 from tests.test_pubsub import wait_for_message
@@ -651,6 +652,45 @@ def test_not_require_full_coverage_cluster_down_error(self, r):
                 else:
                     raise e
 
+    def test_timeout_error_topology_refresh_reuse_connections(self, r):
+        """
+        By mucking TIMEOUT errors, we'll force the cluster topology to be reinitialized,
+        and then ensure that only the impacted connection is replaced
+        """
+        node = r.get_node_from_key("key")
+        r.set("key", "value")
+        node_conn_origin = {}
+        for n in r.get_nodes():
+            node_conn_origin[n.name] = n.redis_connection
+        real_func = r.get_redis_connection(node).parse_response
+
+        class counter:
+            def __init__(self, val=0):
+                self.val = int(val)
+
+        count = counter(0)
+        with patch.object(Redis, "parse_response") as parse_response:
+
+            def moved_redirect_effect(connection, *args, **options):
+                # raise a timeout for 5 times so we'll need to reinitilize the topology
+                if count.val >= 5:
+                    parse_response.side_effect = real_func
+                count.val += 1
+                raise TimeoutError()
+
+            parse_response.side_effect = moved_redirect_effect
+            assert r.get("key") == b"value"
+            for node_name, conn in node_conn_origin.items():
+                if node_name == node.name:
+                    # The old redis connection of the timed out node should have been
+                    # deleted and replaced
+                    assert conn != r.get_redis_connection(node)
+                else:
+                    # other nodes' redis connection should have been reused during the
+                    # topology refresh
+                    cur_node = r.get_node(node_name=node_name)
+                    assert conn == r.get_redis_connection(cur_node)
+
 
 @pytest.mark.onlycluster
 class TestClusterRedisCommands:

From d3a7a75c7b106e0864b3927c0904058e25c99958 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Srokosz?= <psrok1@gmail.com>
Date: Thu, 23 Jun 2022 18:27:04 +0200
Subject: [PATCH 0519/1164] Docs: Add a note about client_setname and
 client_name difference (#2247)

---
 redis/commands/core.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index a337d4f314..6d67415aab 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -687,6 +687,12 @@ def client_setname(self, name: str, **kwargs) -> ResponseT:
         Sets the current connection name
 
         For more information see https://redis.io/commands/client-setname
+
+        .. note::
+           This method sets client name only for **current** connection.
+
+           If you want to set a common name for all connections managed
+           by this client, use ``client_name`` constructor argument.
         """
         return self.execute_command("CLIENT SETNAME", name, **kwargs)
 

From 63cf7ec5cbaca533b7607196dbf993917a65c0f9 Mon Sep 17 00:00:00 2001
From: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Date: Thu, 23 Jun 2022 19:28:02 +0300
Subject: [PATCH 0520/1164] Added dynamic_startup_nodes configuration to
 RedisCluster. (#2244)

* Added dynamic_startup_nodes configuration to RedisCluster. By default, uses only the initial passed startup nodes to refresh the cluster topology. If set to true, sets the startup nodes to all of the discovered nodes.

* Added RedisCluster specific options to the README file and updated CHANGES

* Fixed timeout_error_topology_refresh test

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 CHANGES               |  2 +-
 README.md             | 50 +++++++++++++++++++++++++++++++++++++++++++
 redis/cluster.py      | 17 +++++++++++++--
 tests/test_cluster.py | 23 +++++++++++++++++++-
 4 files changed, 88 insertions(+), 4 deletions(-)

diff --git a/CHANGES b/CHANGES
index 4afc7bac2d..0af421b4b7 100644
--- a/CHANGES
+++ b/CHANGES
@@ -11,9 +11,9 @@
     * Fix broken connection writer lock-up for asyncio (#2065)
     * Fix auth bug when provided with no username (#2086)
     * Fix missing ClusterPipeline._lock (#2189)
+    * Added dynaminc_startup_nodes configuration to RedisCluster
     * Fix reusing the old nodes' connections when cluster topology refresh is being done
     * Fix RedisCluster to immediately raise AuthenticationError without a retry
-
 * 4.1.3 (Feb 8, 2022)
     * Fix flushdb and flushall (#1926)
     * Add redis5 and redis4 dockers (#1871)
diff --git a/README.md b/README.md
index f5d4ae541a..64c9d2809a 100644
--- a/README.md
+++ b/README.md
@@ -1006,6 +1006,7 @@ a slots cache which maps each of the 16384 slots to the node/s handling them,
 a nodes cache that contains ClusterNode objects (name, host, port, redis connection)
 for all of the cluster's nodes, and a commands cache contains all the server
 supported commands that were retrieved using the Redis 'COMMAND' output.
+See *RedisCluster specific options* below for more.
 
 RedisCluster instance can be directly used to execute Redis commands. When a
 command is being executed through the cluster instance, the target node(s) will
@@ -1245,6 +1246,55 @@ The following commands are not supported:
 
 Using scripting within pipelines in cluster mode is **not supported**.
 
+
+**RedisCluster specific options**
+
+ require_full_coverage: (default=False)
+ 
+    When set to False (default value): the client will not require a
+    full coverage of the slots. However, if not all slots are covered,
+    and at least one node has 'cluster-require-full-coverage' set to
+    'yes,' the server will throw a ClusterDownError for some key-based
+    commands. See -
+    https://redis.io/topics/cluster-tutorial#redis-cluster-configuration-parameters
+    When set to True: all slots must be covered to construct the
+    cluster client. If not all slots are covered, RedisClusterException
+    will be thrown.
+    
+ read_from_replicas: (default=False)
+
+     Enable read from replicas in READONLY mode. You can read possibly
+     stale data.
+     When set to true, read commands will be assigned between the
+     primary and its replications in a Round-Robin manner.
+     
+ dynamic_startup_nodes: (default=False)
+
+     Set the RedisCluster's startup nodes to all of the discovered nodes.
+     If true, the cluster's discovered nodes will be used to determine the
+     cluster nodes-slots mapping in the next topology refresh.
+     It will remove the initial passed startup nodes if their endpoints aren't
+     listed in the CLUSTER SLOTS output.
+     If you use dynamic DNS endpoints for startup nodes but CLUSTER SLOTS lists
+     specific IP addresses, keep it at false.
+     
+ cluster_error_retry_attempts: (default=3)
+
+     Retry command execution attempts when encountering ClusterDownError
+     or ConnectionError
+     
+ reinitialize_steps: (default=10)
+
+    Specifies the number of MOVED errors that need to occur before
+    reinitializing the whole cluster topology. If a MOVED error occurs
+    and the cluster does not need to be reinitialized on this current
+    error handling, only the MOVED slot will be patched with the
+    redirected node.
+    To reinitialize the cluster on every MOVED error, set
+    reinitialize_steps to 1.
+    To avoid reinitializing the cluster on moved errors, set
+    reinitialize_steps to 0.
+
 ### Author
 
 redis-py is developed and maintained by [Redis Inc](https://redis.com). It can be found [here](
diff --git a/redis/cluster.py b/redis/cluster.py
index 1737ec75b1..c5b6c8da89 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -482,6 +482,7 @@ def __init__(
         require_full_coverage=False,
         reinitialize_steps=10,
         read_from_replicas=False,
+        dynamic_startup_nodes=False,
         url=None,
         **kwargs,
     ):
@@ -509,6 +510,14 @@ def __init__(
              stale data.
              When set to true, read commands will be assigned between the
              primary and its replications in a Round-Robin manner.
+         :dynamic_startup_nodes: 'bool'
+             Set the RedisCluster's startup nodes to all of the discovered nodes.
+             If true, the cluster's discovered nodes will be used to determine the
+             cluster nodes-slots mapping in the next topology refresh.
+             It will remove the initial passed startup nodes if their endpoints aren't
+             listed in the CLUSTER SLOTS output.
+             If you use dynamic DNS endpoints for startup nodes but CLUSTER SLOTS lists
+             specific IP addresses, keep it at false.
         :cluster_error_retry_attempts: 'int'
              Retry command execution attempts when encountering ClusterDownError
              or ConnectionError
@@ -598,6 +607,7 @@ def __init__(
             startup_nodes=startup_nodes,
             from_url=from_url,
             require_full_coverage=require_full_coverage,
+            dynamic_startup_nodes=dynamic_startup_nodes,
             **kwargs,
         )
 
@@ -1283,6 +1293,7 @@ def __init__(
         from_url=False,
         require_full_coverage=False,
         lock=None,
+        dynamic_startup_nodes=False,
         **kwargs,
     ):
         self.nodes_cache = {}
@@ -1292,6 +1303,7 @@ def __init__(
         self.populate_startup_nodes(startup_nodes)
         self.from_url = from_url
         self._require_full_coverage = require_full_coverage
+        self._dynamic_startup_nodes = dynamic_startup_nodes
         self._moved_exception = None
         self.connection_kwargs = kwargs
         self.read_load_balancer = LoadBalancer()
@@ -1612,8 +1624,9 @@ def initialize(self):
         self.slots_cache = tmp_slots
         # Set the default node
         self.default_node = self.get_nodes_by_server_type(PRIMARY)[0]
-        # Populate the startup nodes with all discovered nodes
-        self.startup_nodes = tmp_nodes_cache
+        if self._dynamic_startup_nodes:
+            # Populate the startup nodes with all discovered nodes
+            self.startup_nodes = tmp_nodes_cache
         # If initialize was called after a MovedError, clear it
         self._moved_exception = None
 
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 438ef73a0e..03533230fe 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -673,7 +673,7 @@ def __init__(self, val=0):
 
             def moved_redirect_effect(connection, *args, **options):
                 # raise a timeout for 5 times so we'll need to reinitilize the topology
-                if count.val >= 5:
+                if count.val == 4:
                     parse_response.side_effect = real_func
                 count.val += 1
                 raise TimeoutError()
@@ -2285,6 +2285,27 @@ def cmd_init_mock(self, r):
                 assert rc.get_node(host=default_host, port=7001) is not None
                 assert rc.get_node(host=default_host, port=7002) is not None
 
+    @pytest.mark.parametrize("dynamic_startup_nodes", [True, False])
+    def test_init_slots_dynamic_startup_nodes(self, dynamic_startup_nodes):
+        rc = get_mocked_redis_client(
+            host="my@DNS.com",
+            port=7000,
+            cluster_slots=default_cluster_slots,
+            dynamic_startup_nodes=dynamic_startup_nodes,
+        )
+        # Nodes are taken from default_cluster_slots
+        discovered_nodes = [
+            "127.0.0.1:7000",
+            "127.0.0.1:7001",
+            "127.0.0.1:7002",
+            "127.0.0.1:7003",
+        ]
+        startup_nodes = list(rc.nodes_manager.startup_nodes.keys())
+        if dynamic_startup_nodes is True:
+            assert startup_nodes.sort() == discovered_nodes.sort()
+        else:
+            assert startup_nodes == ["my@DNS.com:7000"]
+
 
 @pytest.mark.onlycluster
 class TestClusterPubSubObject:

From 8b18d5b2b63ebf218a1f116367a1a09c3d402192 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Mon, 27 Jun 2022 09:11:13 +0000
Subject: [PATCH 0521/1164] late eval of the skip condition (#2248)

* late eval of the skip condition
at module import time, the REDIS_INFO dict hasn't been initialized.

* Store REDIS_INFO in config object, where it is available from condition strings

* Fix comparson of time
You can't test rounded values for equalness, since they may fall each on a different side of 0.5. It is better
to test their absolute difference for a certain tolerance, in this case 1.0 which is the intent of the original round.
---
 tests/conftest.py                     | 2 ++
 tests/test_asyncio/conftest.py        | 4 ++--
 tests/test_asyncio/test_timeseries.py | 2 +-
 tests/test_timeseries.py              | 3 ++-
 4 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/tests/conftest.py b/tests/conftest.py
index e83c866f77..8a907cc389 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -139,6 +139,8 @@ def pytest_sessionstart(session):
     REDIS_INFO["arch_bits"] = arch_bits
     REDIS_INFO["cluster_enabled"] = cluster_enabled
     REDIS_INFO["enterprise"] = info["enterprise"]
+    # store REDIS_INFO in config so that it is available from "condition strings"
+    session.config.REDIS_INFO = REDIS_INFO
 
     # module info, if the second redis is running
     try:
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index b8b5583f32..52ff26b081 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -39,14 +39,14 @@ async def _get_info(redis_url):
         pytest.param(
             (True, PythonParser),
             marks=pytest.mark.skipif(
-                REDIS_INFO["cluster_enabled"], reason="cluster mode enabled"
+                'config.REDIS_INFO["cluster_enabled"]', reason="cluster mode enabled"
             ),
         ),
         (False, PythonParser),
         pytest.param(
             (True, HiredisParser),
             marks=pytest.mark.skipif(
-                not HIREDIS_AVAILABLE or REDIS_INFO["cluster_enabled"],
+                not HIREDIS_AVAILABLE or 'config.REDIS_INFO["cluster_enabled"]',
                 reason="hiredis is not installed or cluster mode enabled",
             ),
         ),
diff --git a/tests/test_asyncio/test_timeseries.py b/tests/test_asyncio/test_timeseries.py
index 70ca6fdeb6..ac2807fe1d 100644
--- a/tests/test_asyncio/test_timeseries.py
+++ b/tests/test_asyncio/test_timeseries.py
@@ -73,7 +73,7 @@ async def test_add(modclient: redis.Redis):
         4, 4, 2, retention_msecs=10, labels={"Redis": "Labs", "Time": "Series"}
     )
     res = await modclient.ts().add(5, "*", 1)
-    assert round(time.time()) == round(float(res) / 1000)
+    assert abs(time.time() - round(float(res) / 1000)) < 1.0
 
     info = await modclient.ts().info(4)
     assert 10 == info.retention_msecs
diff --git a/tests/test_timeseries.py b/tests/test_timeseries.py
index 421c9d5c04..7d42147a16 100644
--- a/tests/test_timeseries.py
+++ b/tests/test_timeseries.py
@@ -70,7 +70,8 @@ def test_add(client):
     assert 4 == client.ts().add(
         4, 4, 2, retention_msecs=10, labels={"Redis": "Labs", "Time": "Series"}
     )
-    assert round(time.time()) == round(float(client.ts().add(5, "*", 1)) / 1000)
+
+    assert abs(time.time() - float(client.ts().add(5, "*", 1)) / 1000) < 1.0
 
     info = client.ts().info(4)
     assert 10 == info.retention_msecs

From 11cf66afc9b764248f12761138cc28a2b3e1366c Mon Sep 17 00:00:00 2001
From: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Date: Mon, 27 Jun 2022 13:28:09 +0300
Subject: [PATCH 0522/1164] Changed dynamic_startup_nodes default value to
 'True' to prevent breaking backward compatibility (#2251)

---
 README.md        |  4 ++--
 redis/cluster.py | 10 +++++-----
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 64c9d2809a..5a4bb71745 100644
--- a/README.md
+++ b/README.md
@@ -1268,7 +1268,7 @@ Using scripting within pipelines in cluster mode is **not supported**.
      When set to true, read commands will be assigned between the
      primary and its replications in a Round-Robin manner.
      
- dynamic_startup_nodes: (default=False)
+ dynamic_startup_nodes: (default=True)
 
      Set the RedisCluster's startup nodes to all of the discovered nodes.
      If true, the cluster's discovered nodes will be used to determine the
@@ -1276,7 +1276,7 @@ Using scripting within pipelines in cluster mode is **not supported**.
      It will remove the initial passed startup nodes if their endpoints aren't
      listed in the CLUSTER SLOTS output.
      If you use dynamic DNS endpoints for startup nodes but CLUSTER SLOTS lists
-     specific IP addresses, keep it at false.
+     specific IP addresses, it is best to set it to false.
      
  cluster_error_retry_attempts: (default=3)
 
diff --git a/redis/cluster.py b/redis/cluster.py
index c5b6c8da89..b301cdc4e0 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -482,7 +482,7 @@ def __init__(
         require_full_coverage=False,
         reinitialize_steps=10,
         read_from_replicas=False,
-        dynamic_startup_nodes=False,
+        dynamic_startup_nodes=True,
         url=None,
         **kwargs,
     ):
@@ -512,12 +512,12 @@ def __init__(
              primary and its replications in a Round-Robin manner.
          :dynamic_startup_nodes: 'bool'
              Set the RedisCluster's startup nodes to all of the discovered nodes.
-             If true, the cluster's discovered nodes will be used to determine the
-             cluster nodes-slots mapping in the next topology refresh.
+             If true (default value), the cluster's discovered nodes will be used to
+             determine the cluster nodes-slots mapping in the next topology refresh.
              It will remove the initial passed startup nodes if their endpoints aren't
              listed in the CLUSTER SLOTS output.
              If you use dynamic DNS endpoints for startup nodes but CLUSTER SLOTS lists
-             specific IP addresses, keep it at false.
+             specific IP addresses, it is best to set it to false.
         :cluster_error_retry_attempts: 'int'
              Retry command execution attempts when encountering ClusterDownError
              or ConnectionError
@@ -1293,7 +1293,7 @@ def __init__(
         from_url=False,
         require_full_coverage=False,
         lock=None,
-        dynamic_startup_nodes=False,
+        dynamic_startup_nodes=True,
         **kwargs,
     ):
         self.nodes_cache = {}

From d7d433641f3d1ea0dca2794aef064a7d3e28514e Mon Sep 17 00:00:00 2001
From: Utkarsh Gupta <utkarshgupta137@gmail.com>
Date: Mon, 27 Jun 2022 16:10:36 +0530
Subject: [PATCH 0523/1164] commands/cluster: use pipeline to execute split
 commands (#2230)

- allow passing target_nodes to pipeline commands

- move READ_COMMANDS to commands/cluster to avoid import cycle
- add types to list_or_args
---
 redis/asyncio/cluster.py   |  17 ++--
 redis/cluster.py           |  65 +++---------
 redis/commands/__init__.py |  13 +--
 redis/commands/cluster.py  | 204 +++++++++++++++++++++----------------
 redis/commands/helpers.py  |   5 +-
 5 files changed, 151 insertions(+), 153 deletions(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index a7bea3029a..2894004403 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -23,7 +23,6 @@
 from redis.cluster import (
     PIPELINE_BLOCKED_COMMANDS,
     PRIMARY,
-    READ_COMMANDS,
     REPLICA,
     SLOT_ID,
     AbstractRedisCluster,
@@ -32,7 +31,7 @@
     get_node_name,
     parse_cluster_slots,
 )
-from redis.commands import AsyncRedisClusterCommands
+from redis.commands import READ_COMMANDS, AsyncRedisClusterCommands
 from redis.crc import REDIS_CLUSTER_HASH_SLOTS, key_slot
 from redis.exceptions import (
     AskError,
@@ -1350,11 +1349,17 @@ async def _execute(
 
         nodes = {}
         for cmd in todo:
-            target_nodes = await client._determine_nodes(*cmd.args)
-            if not target_nodes:
-                raise RedisClusterException(
-                    f"No targets were found to execute {cmd.args} command on"
+            passed_targets = cmd.kwargs.pop("target_nodes", None)
+            if passed_targets and not client._is_node_flag(passed_targets):
+                target_nodes = client._parse_target_nodes(passed_targets)
+            else:
+                target_nodes = await client._determine_nodes(
+                    *cmd.args, node_flag=passed_targets
                 )
+                if not target_nodes:
+                    raise RedisClusterException(
+                        f"No targets were found to execute {cmd.args} command on"
+                    )
             if len(target_nodes) > 1:
                 raise RedisClusterException(f"Too many targets for command {cmd.args}")
 
diff --git a/redis/cluster.py b/redis/cluster.py
index b301cdc4e0..6034e9606f 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -9,7 +9,7 @@
 from typing import Any, Callable, Dict, Tuple
 
 from redis.client import CaseInsensitiveDict, PubSub, Redis, parse_scan
-from redis.commands import CommandsParser, RedisClusterCommands
+from redis.commands import READ_COMMANDS, CommandsParser, RedisClusterCommands
 from redis.connection import ConnectionPool, DefaultParser, Encoder, parse_url
 from redis.crc import REDIS_CLUSTER_HASH_SLOTS, key_slot
 from redis.exceptions import (
@@ -154,52 +154,6 @@ def parse_cluster_shards(resp, **options):
 )
 KWARGS_DISABLED_KEYS = ("host", "port")
 
-# Not complete, but covers the major ones
-# https://redis.io/commands
-READ_COMMANDS = frozenset(
-    [
-        "BITCOUNT",
-        "BITPOS",
-        "EXISTS",
-        "GEODIST",
-        "GEOHASH",
-        "GEOPOS",
-        "GEORADIUS",
-        "GEORADIUSBYMEMBER",
-        "GET",
-        "GETBIT",
-        "GETRANGE",
-        "HEXISTS",
-        "HGET",
-        "HGETALL",
-        "HKEYS",
-        "HLEN",
-        "HMGET",
-        "HSTRLEN",
-        "HVALS",
-        "KEYS",
-        "LINDEX",
-        "LLEN",
-        "LRANGE",
-        "MGET",
-        "PTTL",
-        "RANDOMKEY",
-        "SCARD",
-        "SDIFF",
-        "SINTER",
-        "SISMEMBER",
-        "SMEMBERS",
-        "SRANDMEMBER",
-        "STRLEN",
-        "SUNION",
-        "TTL",
-        "ZCARD",
-        "ZCOUNT",
-        "ZRANGE",
-        "ZSCORE",
-    ]
-)
-
 
 def cleanup_kwargs(**kwargs):
     """
@@ -1993,14 +1947,25 @@ def _send_cluster_commands(
             # refer to our internal node -> slot table that
             # tells us where a given
             # command should route to.
-            node = self._determine_nodes(*c.args)
+            passed_targets = c.options.pop("target_nodes", None)
+            if passed_targets and not self._is_nodes_flag(passed_targets):
+                target_nodes = self._parse_target_nodes(passed_targets)
+            else:
+                target_nodes = self._determine_nodes(*c.args, node_flag=passed_targets)
+                if not target_nodes:
+                    raise RedisClusterException(
+                        f"No targets were found to execute {c.args} command on"
+                    )
+            if len(target_nodes) > 1:
+                raise RedisClusterException(f"Too many targets for command {c.args}")
 
+            node = target_nodes[0]
             # now that we know the name of the node
             # ( it's just a string in the form of host:port )
             # we can build a list of commands for each node.
-            node_name = node[0].name
+            node_name = node.name
             if node_name not in nodes:
-                redis_node = self.get_redis_connection(node[0])
+                redis_node = self.get_redis_connection(node)
                 connection = get_connection(redis_node, c.args)
                 nodes[node_name] = NodeCommands(
                     redis_node.parse_response, redis_node.connection_pool, connection
diff --git a/redis/commands/__init__.py b/redis/commands/__init__.py
index e3383ff722..f3f08286c8 100644
--- a/redis/commands/__init__.py
+++ b/redis/commands/__init__.py
@@ -1,4 +1,4 @@
-from .cluster import AsyncRedisClusterCommands, RedisClusterCommands
+from .cluster import READ_COMMANDS, AsyncRedisClusterCommands, RedisClusterCommands
 from .core import AsyncCoreCommands, CoreCommands
 from .helpers import list_or_args
 from .parser import CommandsParser
@@ -6,14 +6,15 @@
 from .sentinel import AsyncSentinelCommands, SentinelCommands
 
 __all__ = [
+    "AsyncCoreCommands",
     "AsyncRedisClusterCommands",
-    "RedisClusterCommands",
+    "AsyncRedisModuleCommands",
+    "AsyncSentinelCommands",
     "CommandsParser",
-    "AsyncCoreCommands",
     "CoreCommands",
-    "list_or_args",
-    "AsyncRedisModuleCommands",
+    "READ_COMMANDS",
+    "RedisClusterCommands",
     "RedisModuleCommands",
-    "AsyncSentinelCommands",
     "SentinelCommands",
+    "list_or_args",
 ]
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index b91b65f083..a1060d2cbb 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -46,25 +46,111 @@
     from redis.asyncio.cluster import TargetNodesT
 
 
+# Not complete, but covers the major ones
+# https://redis.io/commands
+READ_COMMANDS = frozenset(
+    [
+        "BITCOUNT",
+        "BITPOS",
+        "EXISTS",
+        "GEODIST",
+        "GEOHASH",
+        "GEOPOS",
+        "GEORADIUS",
+        "GEORADIUSBYMEMBER",
+        "GET",
+        "GETBIT",
+        "GETRANGE",
+        "HEXISTS",
+        "HGET",
+        "HGETALL",
+        "HKEYS",
+        "HLEN",
+        "HMGET",
+        "HSTRLEN",
+        "HVALS",
+        "KEYS",
+        "LINDEX",
+        "LLEN",
+        "LRANGE",
+        "MGET",
+        "PTTL",
+        "RANDOMKEY",
+        "SCARD",
+        "SDIFF",
+        "SINTER",
+        "SISMEMBER",
+        "SMEMBERS",
+        "SRANDMEMBER",
+        "STRLEN",
+        "SUNION",
+        "TTL",
+        "ZCARD",
+        "ZCOUNT",
+        "ZRANGE",
+        "ZSCORE",
+    ]
+)
+
+
 class ClusterMultiKeyCommands(ClusterCommandsProtocol):
     """
     A class containing commands that handle more than one key
     """
 
     def _partition_keys_by_slot(self, keys: Iterable[KeyT]) -> Dict[int, List[KeyT]]:
-        """
-        Split keys into a dictionary that maps a slot to
-        a list of keys.
-        """
+        """Split keys into a dictionary that maps a slot to a list of keys."""
+
         slots_to_keys = {}
         for key in keys:
-            k = self.encoder.encode(key)
-            slot = key_slot(k)
+            slot = key_slot(self.encoder.encode(key))
             slots_to_keys.setdefault(slot, []).append(key)
 
         return slots_to_keys
 
-    def mget_nonatomic(self, keys: KeysT, *args) -> List[Optional[Any]]:
+    def _partition_pairs_by_slot(
+        self, mapping: Mapping[AnyKeyT, EncodableT]
+    ) -> Dict[int, List[EncodableT]]:
+        """Split pairs into a dictionary that maps a slot to a list of pairs."""
+
+        slots_to_pairs = {}
+        for pair in mapping.items():
+            slot = key_slot(self.encoder.encode(pair[0]))
+            slots_to_pairs.setdefault(slot, []).extend(pair)
+
+        return slots_to_pairs
+
+    def _execute_pipeline_by_slot(
+        self, command: str, slots_to_args: Mapping[int, Iterable[EncodableT]]
+    ) -> List[Any]:
+        read_from_replicas = self.read_from_replicas and command in READ_COMMANDS
+        pipe = self.pipeline()
+        [
+            pipe.execute_command(
+                command,
+                *slot_args,
+                target_nodes=[
+                    self.nodes_manager.get_node_from_slot(slot, read_from_replicas)
+                ],
+            )
+            for slot, slot_args in slots_to_args.items()
+        ]
+        return pipe.execute()
+
+    def _reorder_keys_by_command(
+        self,
+        keys: Iterable[KeyT],
+        slots_to_args: Mapping[int, Iterable[EncodableT]],
+        responses: Iterable[Any],
+    ) -> List[Any]:
+        results = {
+            k: v
+            for slot_values, response in zip(slots_to_args.values(), responses)
+            for k, v in zip(slot_values, response)
+        }
+        return [results[key] for key in keys]
+
+    def mget_nonatomic(self, keys: KeysT, *args: KeyT) -> List[Optional[Any]]:
         """
         Splits the keys into different slots and then calls MGET
         for the keys of every slot. This operation will not be atomic
@@ -75,30 +161,17 @@ def mget_nonatomic(self, keys: KeysT, *args) -> List[Optional[Any]]:
         For more information see https://redis.io/commands/mget
         """
 
-        from redis.client import EMPTY_RESPONSE
-
-        options = {}
-        if not args:
-            options[EMPTY_RESPONSE] = []
-
         # Concatenate all keys into a list
         keys = list_or_args(keys, args)
+
         # Split keys into slots
         slots_to_keys = self._partition_keys_by_slot(keys)
 
-        # Call MGET for every slot and concatenate
-        # the results
-        # We must make sure that the keys are returned in order
-        all_results = {}
-        for slot_keys in slots_to_keys.values():
-            slot_values = self.execute_command("MGET", *slot_keys, **options)
+        # Execute commands using a pipeline
+        res = self._execute_pipeline_by_slot("MGET", slots_to_keys)
 
-            slot_results = dict(zip(slot_keys, slot_values))
-            all_results.update(slot_results)
-
-        # Sort the results
-        vals_in_order = [all_results[key] for key in keys]
-        return vals_in_order
+        # Reorder keys in the order the user provided & return
+        return self._reorder_keys_by_command(keys, slots_to_keys, res)
 
     def mset_nonatomic(self, mapping: Mapping[AnyKeyT, EncodableT]) -> List[bool]:
         """
@@ -114,35 +187,22 @@ def mset_nonatomic(self, mapping: Mapping[AnyKeyT, EncodableT]) -> List[bool]:
         """
 
         # Partition the keys by slot
-        slots_to_pairs = {}
-        for pair in mapping.items():
-            # encode the key
-            k = self.encoder.encode(pair[0])
-            slot = key_slot(k)
-            slots_to_pairs.setdefault(slot, []).extend(pair)
-
-        # Call MSET for every slot and concatenate
-        # the results (one result per slot)
-        res = []
-        for pairs in slots_to_pairs.values():
-            res.append(self.execute_command("MSET", *pairs))
+        slots_to_pairs = self._partition_pairs_by_slot(mapping)
 
-        return res
+        # Execute commands using a pipeline & return list of replies
+        return self._execute_pipeline_by_slot("MSET", slots_to_pairs)
 
     def _split_command_across_slots(self, command: str, *keys: KeyT) -> int:
         """
         Runs the given command once for the keys
         of each slot. Returns the sum of the return values.
         """
+
         # Partition the keys by slot
         slots_to_keys = self._partition_keys_by_slot(keys)
 
         # Sum up the reply from each command
-        total = 0
-        for slot_keys in slots_to_keys.values():
-            total += self.execute_command(command, *slot_keys)
-
-        return total
+        return sum(self._execute_pipeline_by_slot(command, slots_to_keys))
 
     def exists(self, *keys: KeyT) -> ResponseT:
         """
@@ -202,7 +262,7 @@ class AsyncClusterMultiKeyCommands(ClusterMultiKeyCommands):
     A class containing commands that handle more than one key
     """
 
-    async def mget_nonatomic(self, keys: KeysT, *args) -> List[Optional[Any]]:
+    async def mget_nonatomic(self, keys: KeysT, *args: KeyT) -> List[Optional[Any]]:
         """
         Splits the keys into different slots and then calls MGET
         for the keys of every slot. This operation will not be atomic
@@ -213,36 +273,17 @@ async def mget_nonatomic(self, keys: KeysT, *args) -> List[Optional[Any]]:
         For more information see https://redis.io/commands/mget
         """
 
-        from redis.client import EMPTY_RESPONSE
-
-        options = {}
-        if not args:
-            options[EMPTY_RESPONSE] = []
-
         # Concatenate all keys into a list
         keys = list_or_args(keys, args)
+
         # Split keys into slots
         slots_to_keys = self._partition_keys_by_slot(keys)
 
-        # Call MGET for every slot and concatenate
-        # the results
-        # We must make sure that the keys are returned in order
-        all_values = await asyncio.gather(
-            *(
-                asyncio.ensure_future(
-                    self.execute_command("MGET", *slot_keys, **options)
-                )
-                for slot_keys in slots_to_keys.values()
-            )
-        )
+        # Execute commands using a pipeline
+        res = await self._execute_pipeline_by_slot("MGET", slots_to_keys)
 
-        all_results = {}
-        for slot_keys, slot_values in zip(slots_to_keys.values(), all_values):
-            all_results.update(dict(zip(slot_keys, slot_values)))
-
-        # Sort the results
-        vals_in_order = [all_results[key] for key in keys]
-        return vals_in_order
+        # Reorder keys in the order the user provided & return
+        return self._reorder_keys_by_command(keys, slots_to_keys, res)
 
     async def mset_nonatomic(self, mapping: Mapping[AnyKeyT, EncodableT]) -> List[bool]:
         """
@@ -258,39 +299,22 @@ async def mset_nonatomic(self, mapping: Mapping[AnyKeyT, EncodableT]) -> List[bo
         """
 
         # Partition the keys by slot
-        slots_to_pairs = {}
-        for pair in mapping.items():
-            # encode the key
-            k = self.encoder.encode(pair[0])
-            slot = key_slot(k)
-            slots_to_pairs.setdefault(slot, []).extend(pair)
+        slots_to_pairs = self._partition_pairs_by_slot(mapping)
 
-        # Call MSET for every slot and concatenate
-        # the results (one result per slot)
-        return await asyncio.gather(
-            *(
-                asyncio.ensure_future(self.execute_command("MSET", *pairs))
-                for pairs in slots_to_pairs.values()
-            )
-        )
+        # Execute commands using a pipeline & return list of replies
+        return await self._execute_pipeline_by_slot("MSET", slots_to_pairs)
 
     async def _split_command_across_slots(self, command: str, *keys: KeyT) -> int:
         """
         Runs the given command once for the keys
         of each slot. Returns the sum of the return values.
         """
+
         # Partition the keys by slot
         slots_to_keys = self._partition_keys_by_slot(keys)
 
         # Sum up the reply from each command
-        return sum(
-            await asyncio.gather(
-                *(
-                    asyncio.ensure_future(self.execute_command(command, *slot_keys))
-                    for slot_keys in slots_to_keys.values()
-                )
-            )
-        )
+        return sum(await self._execute_pipeline_by_slot(command, slots_to_keys))
 
 
 class ClusterManagementCommands(ManagementCommands):
diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
index 2b873e3385..6989ab59fa 100644
--- a/redis/commands/helpers.py
+++ b/redis/commands/helpers.py
@@ -1,9 +1,12 @@
 import copy
 import random
 import string
+from typing import List, Tuple
 
+from redis.typing import KeysT, KeyT
 
-def list_or_args(keys, args):
+
+def list_or_args(keys: KeysT, args: Tuple[KeyT, ...]) -> List[KeyT]:
     # returns a single new list combining keys and args
     try:
         iter(keys)

From e5df832640fa581293c57c4d613406b9f2c40238 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Mon, 27 Jun 2022 11:20:03 +0000
Subject: [PATCH 0524/1164] Split incorrect mark into two separate marks
 (#2253)

---
 tests/test_asyncio/conftest.py | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index 52ff26b081..8166588d8e 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -45,10 +45,15 @@ async def _get_info(redis_url):
         (False, PythonParser),
         pytest.param(
             (True, HiredisParser),
-            marks=pytest.mark.skipif(
-                not HIREDIS_AVAILABLE or 'config.REDIS_INFO["cluster_enabled"]',
-                reason="hiredis is not installed or cluster mode enabled",
-            ),
+            marks=[
+                pytest.mark.skipif(
+                    'config.REDIS_INFO["cluster_enabled"]',
+                    reason="cluster mode enabled",
+                ),
+                pytest.mark.skipif(
+                    not HIREDIS_AVAILABLE, reason="hiredis is not installed"
+                ),
+            ],
         ),
         pytest.param(
             (False, HiredisParser),

From e85fe3b8e39de4d568a11f146162a4f7d944130c Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 27 Jun 2022 15:05:05 +0300
Subject: [PATCH 0525/1164] Fix `XAUTOCLAIM` to return the full response
 (#2252)

* fix parse_xautoclaim

* linters
---
 redis/client.py        | 3 ++-
 tests/test_commands.py | 4 ++--
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 86061d56d5..c63fb13326 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -310,7 +310,8 @@ def parse_xclaim(response, **options):
 def parse_xautoclaim(response, **options):
     if options.get("parse_justid", False):
         return response[1]
-    return parse_stream_list(response[1])
+    response[1] = parse_stream_list(response[1])
+    return response
 
 
 def parse_xinfo_stream(response, **options):
diff --git a/tests/test_commands.py b/tests/test_commands.py
index fcd2ed1c0c..715d18c951 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -3781,14 +3781,14 @@ def test_xautoclaim(self, r):
         # trying to claim a message that isn't already pending doesn't
         # do anything
         response = r.xautoclaim(stream, group, consumer2, min_idle_time=0)
-        assert response == []
+        assert response == [b"0-0", []]
 
         # read the group as consumer1 to initially claim the messages
         r.xreadgroup(group, consumer1, streams={stream: ">"})
 
         # claim one message as consumer2
         response = r.xautoclaim(stream, group, consumer2, min_idle_time=0, count=1)
-        assert response == [message]
+        assert response[1] == [message]
 
         # reclaim the messages as consumer1, but use the justid argument
         # which only returns message ids

From e9c2852c039573c0b1106274af5087ad9472ea4b Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 27 Jun 2022 15:32:16 +0300
Subject: [PATCH 0526/1164] Fix backwards compatibility from 4.3.2 (#2254)

---
 redis/lock.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/redis/lock.py b/redis/lock.py
index 650d0ae56c..912ff57819 100644
--- a/redis/lock.py
+++ b/redis/lock.py
@@ -169,7 +169,6 @@ def __exit__(
 
     def acquire(
         self,
-        *,
         sleep: Optional[Number] = None,
         blocking: Optional[bool] = None,
         blocking_timeout: Optional[Number] = None,

From e6cd4fdf3b159d7f118f154e28e884069da89d7e Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 27 Jun 2022 15:47:52 +0300
Subject: [PATCH 0527/1164] v4.3.4 (#2255)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index a7ab3641b6..87649c596f 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.3.3",
+    version="4.3.4",
     packages=find_packages(
         include=[
             "redis",

From c705df136f0cca3a301ba6ca0a0b6e6bed25a1db Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 5 Jul 2022 17:00:39 +0300
Subject: [PATCH 0528/1164] Adding link to the OM client (#2262)

* docs cleanup, adding om link

* adding link to om client
---
 README.md | 127 +++++-------------------------------------------------
 1 file changed, 11 insertions(+), 116 deletions(-)

diff --git a/README.md b/README.md
index 5a4bb71745..4241da47dd 100644
--- a/README.md
+++ b/README.md
@@ -9,51 +9,31 @@ The Python interface to the Redis key-value store.
 [![codecov](https://codecov.io/gh/redis/redis-py/branch/master/graph/badge.svg?token=yenl5fzxxr)](https://codecov.io/gh/redis/redis-py)
 [![Total alerts](https://img.shields.io/lgtm/alerts/g/redis/redis-py.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/redis/redis-py/alerts/)
 
-[Installation](#installation) | [Contributing](#contributing) |  [Getting Started](#getting-started) | [Connecting To Redis](#connecting-to-redis)
+[Installation](#installation) | [Contributing](#contributing) |  [Getting Started](#getting-started) | [Connecting To Redis](#connecting-to-redis) | [Contributing](https://github.com/redis/redis-py/blob/master/CONTRIBUTING.md)
 
 ---------------------------------------------
 
 ## Python Notice
 
-redis-py 4.2.x will be the last generation of redis-py to support python 3.6 as it has been [End of Life'd](https://www.python.org/dev/peps/pep-0494/#schedule-last-security-only-release).  Async support was introduced in redis-py 4.2.x thanks to [aioredis](https://github.com/aio-libs/aioredis-py), which necessitates this change. We will continue to maintain 3.6 support as long as possible - but the plan is for redis-py version 5+ to officially remove 3.6.
+redis-py 4.3.x will be the last generation of redis-py to support python 3.6 as it has been [End of Life'd](https://www.python.org/dev/peps/pep-0494/#schedule-last-security-only-release).  Async support was introduced in redis-py 4.2.x thanks to [aioredis](https://github.com/aio-libs/aioredis-py), which necessitates this change. We will continue to maintain 3.6 support as long as possible - but the plan is for redis-py version 4.4+ to officially remove 3.6.
 
 ---------------------------
 
 ## Installation
 
-redis-py requires a running Redis server. See [Redis's
-quickstart](https://redis.io/topics/quickstart) for installation
-instructions.
-
-redis-py can be installed using pip similar to other
-Python packages. Do not use sudo with pip.
-It is usually good to work in a
-[virtualenv](https://virtualenv.pypa.io/en/latest/) or
-[venv](https://docs.python.org/3/library/venv.html) to avoid conflicts
-with other package managers and Python projects. For a quick
-introduction see [Python Virtual Environments in Five
-Minutes](https://bit.ly/py-env).
-
 To install redis-py, simply:
 
 ``` bash
 $ pip install redis
 ```
 
-or from source:
+Looking for a high-level library to handle object mapping? See [redis-om-python](https://github.com/redis/redis-om-python)!
 
-``` bash
-$ python setup.py install
+redis-py requires a running Redis server.  Assuming you have docker
+```bash
+docker run -p 6379:6379 -it redis/redis-stack-server:latest
 ```
 
-View the current documentation [here](https://readthedocs.org/projects/redis/).
-
-## Contributing
-
-Want to contribute a feature, bug fix, or report an issue? Check out
-our [guide to
-contributing](https://github.com/redis/redis-py/blob/master/CONTRIBUTING.md).
-
 ## Getting Started
 
 redis-py supports Python 3.7+.
@@ -81,91 +61,6 @@ encoding argument for the redis.Redis class.
 The encoding will be used to automatically encode any
 strings passed to commands, such as key names and values.
 
-
---------------------
-
-### MSET, MSETNX and ZADD
-
-These commands all accept a mapping of key/value pairs. In redis-py 2.X
-this mapping could be specified as **args* or as `**kwargs`. Both of
-these styles caused issues when Redis introduced optional flags to ZADD.
-Relying on `*args` caused issues with the optional argument order,
-especially in Python 2.7. Relying on `**kwargs` caused potential
-collision issues of user keys with the argument names in the method
-signature.
-
-To resolve this, redis-py 3.0 has changed these three commands to all
-accept a single positional argument named mapping that is expected to be
-a dict. For MSET and MSETNX, the dict is a mapping of key-names -\>
-values. For ZADD, the dict is a mapping of element-names -\> score.
-
-MSET, MSETNX and ZADD now look like:
-
-``` pycon
-def mset(self, mapping):
-def msetnx(self, mapping):
-def zadd(self, name, mapping, nx=False, xx=False, ch=False, incr=False):
-```
-
-All 2.X users that use these commands must modify their code to supply
-keys and values as a dict to these commands.
-
-### ZINCRBY
-
-redis-py 2.X accidentally modified the argument order of ZINCRBY,
-swapping the order of value and amount. ZINCRBY now looks like:
-
-``` python
-def zincrby(self, name, amount, value):
-```
-
-All 2.X users that rely on ZINCRBY must swap the order of amount and
-value for the command to continue to work as intended.
-
-### Encoding of User Input
-
-redis-py 3.0 only accepts user data as bytes, strings or numbers (ints,
-longs and floats). Attempting to specify a key or a value as any other
-type will raise a DataError exception.
-
-redis-py 2.X attempted to coerce any type of input into a string. While
-occasionally convenient, this caused all sorts of hidden errors when
-users passed boolean values (which were coerced to \'True\' or
-\'False\'), a None value (which was coerced to \'None\') or other
-values, such as user defined types.
-
-All 2.X users should make sure that the keys and values they pass into
-redis-py are either bytes, strings or numbers.
-
-### Locks
-
-redis-py 3.0 drops support for the pipeline-based Lock and now only
-supports the Lua-based lock. In doing so, LuaLock has been renamed to
-Lock. This also means that redis-py Lock objects require Redis server
-2.6 or greater.
-
-2.X users that were explicitly referring to *LuaLock* will have to now
-refer to *Lock* instead.
-
-### Locks as Context Managers
-
-redis-py 3.0 now raises a LockError when using a lock as a context
-manager and the lock cannot be acquired within the specified timeout.
-This is more of a bug fix than a backwards incompatible change. However,
-given an error is now raised where none was before, this might alarm
-some users.
-
-2.X users should make sure they're wrapping their lock code in a
-try/catch like this:
-
-``` python
-try:
-    with r.lock('my-lock-key', blocking_timeout=5) as lock:
-        # code you want executed only after the lock has been acquired
-except LockError:
-    # the lock wasn't acquired
-```
-
 ## API Reference
 
 The [official Redis command documentation](https://redis.io/commands)
@@ -1250,7 +1145,7 @@ Using scripting within pipelines in cluster mode is **not supported**.
 **RedisCluster specific options**
 
  require_full_coverage: (default=False)
- 
+
     When set to False (default value): the client will not require a
     full coverage of the slots. However, if not all slots are covered,
     and at least one node has 'cluster-require-full-coverage' set to
@@ -1260,14 +1155,14 @@ Using scripting within pipelines in cluster mode is **not supported**.
     When set to True: all slots must be covered to construct the
     cluster client. If not all slots are covered, RedisClusterException
     will be thrown.
-    
+
  read_from_replicas: (default=False)
 
      Enable read from replicas in READONLY mode. You can read possibly
      stale data.
      When set to true, read commands will be assigned between the
      primary and its replications in a Round-Robin manner.
-     
+
  dynamic_startup_nodes: (default=True)
 
      Set the RedisCluster's startup nodes to all of the discovered nodes.
@@ -1277,12 +1172,12 @@ Using scripting within pipelines in cluster mode is **not supported**.
      listed in the CLUSTER SLOTS output.
      If you use dynamic DNS endpoints for startup nodes but CLUSTER SLOTS lists
      specific IP addresses, it is best to set it to false.
-     
+
  cluster_error_retry_attempts: (default=3)
 
      Retry command execution attempts when encountering ClusterDownError
      or ConnectionError
-     
+
  reinitialize_steps: (default=10)
 
     Specifies the number of MOVED errors that need to occur before

From ae83d40384665e2533d2f181981f991a45f58555 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 5 Jul 2022 17:40:48 +0300
Subject: [PATCH 0529/1164] run integration tests nightly (#2263)

---
 .github/workflows/integration.yaml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 59f6c7d322..1174277501 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -13,6 +13,8 @@ on:
     branches:
       - master
       - '[0-9].[0-9]'
+  schedule:
+    - cron: '0 1 * * *' # nightly build
 
 jobs:
 

From 4b0543d567aef36ac467ce495d831a24575d8d5b Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 7 Jul 2022 16:21:41 +0300
Subject: [PATCH 0530/1164] attempting to add pypy 3.8 (#2266)

---
 .github/workflows/integration.yaml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 1174277501..1cce9f3659 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -24,7 +24,7 @@ jobs:
      steps:
        - uses: actions/checkout@v2
        - name: install python
-         uses: actions/setup-python@v3
+         uses: actions/setup-python@v4
          with:
            python-version: 3.9
            cache: 'pip'
@@ -39,7 +39,7 @@ jobs:
      strategy:
        max-parallel: 15
        matrix:
-         python-version: ['3.6', '3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
+         python-version: ['3.6', '3.7', '3.8', '3.9', '3.10', 'pypy-3.7', 'pypy-3.8']
          test-type: ['standalone', 'cluster']
          connection-type: ['hiredis', 'plain']
      env:
@@ -48,7 +48,7 @@ jobs:
      steps:
        - uses: actions/checkout@v2
        - name: install python
-         uses: actions/setup-python@v3
+         uses: actions/setup-python@v4
          with:
            python-version: ${{ matrix.python-version }}
            cache: 'pip'

From 6a78773dee65c236e49b3edcda41be7d57649a23 Mon Sep 17 00:00:00 2001
From: szumka <106675199+szumka@users.noreply.github.com>
Date: Thu, 21 Jul 2022 14:13:42 +0200
Subject: [PATCH 0531/1164] Use retry mechanism in async version of Connection
 objects (#2271)

---
 CHANGES                                       |  1 +
 redis/asyncio/connection.py                   |  6 ++-
 redis/asyncio/sentinel.py                     |  8 ++-
 tests/test_asyncio/test_connection.py         | 53 ++++++++++++++++++-
 .../test_sentinel_managed_connection.py       | 37 +++++++++++++
 5 files changed, 101 insertions(+), 4 deletions(-)
 create mode 100644 tests/test_asyncio/test_sentinel_managed_connection.py

diff --git a/CHANGES b/CHANGES
index 0af421b4b7..b4841ddb2b 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,4 +1,5 @@
 
+    * Add retry mechanism to async version of Connection
     * Compare commands case-insensitively in the asyncio command parser
     * Allow negative `retries` for `Retry` class to retry forever
     * Add `items` parameter to `hset` signature
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 35536fc883..5bf2a0fd74 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -637,6 +637,8 @@ def __init__(
             retry_on_error = []
         if retry_on_timeout:
             retry_on_error.append(TimeoutError)
+            retry_on_error.append(socket.timeout)
+            retry_on_error.append(asyncio.TimeoutError)
         self.retry_on_error = retry_on_error
         if retry_on_error:
             if not retry:
@@ -706,7 +708,9 @@ async def connect(self):
         if self.is_connected:
             return
         try:
-            await self._connect()
+            await self.retry.call_with_retry(
+                lambda: self._connect(), lambda error: self.disconnect()
+            )
         except asyncio.CancelledError:
             raise
         except (socket.timeout, asyncio.TimeoutError):
diff --git a/redis/asyncio/sentinel.py b/redis/asyncio/sentinel.py
index 5aefd09ebd..99c5074950 100644
--- a/redis/asyncio/sentinel.py
+++ b/redis/asyncio/sentinel.py
@@ -44,7 +44,7 @@ async def connect_to(self, address):
             if str_if_bytes(await self.read_response()) != "PONG":
                 raise ConnectionError("PING failed")
 
-    async def connect(self):
+    async def _connect_retry(self):
         if self._reader:
             return  # already connected
         if self.connection_pool.is_master:
@@ -57,6 +57,12 @@ async def connect(self):
                     continue
             raise SlaveNotFoundError  # Never be here
 
+    async def connect(self):
+        return await self.retry.call_with_retry(
+            self._connect_retry,
+            lambda error: asyncio.sleep(0),
+        )
+
     async def read_response(self, disable_decoding: bool = False):
         try:
             return await super().read_response(disable_decoding=disable_decoding)
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index f6259adbd2..78a3efd2a0 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -1,10 +1,18 @@
 import asyncio
+import socket
 import types
+from unittest.mock import patch
 
 import pytest
 
-from redis.asyncio.connection import PythonParser, UnixDomainSocketConnection
-from redis.exceptions import InvalidResponse
+from redis.asyncio.connection import (
+    Connection,
+    PythonParser,
+    UnixDomainSocketConnection,
+)
+from redis.asyncio.retry import Retry
+from redis.backoff import NoBackoff
+from redis.exceptions import ConnectionError, InvalidResponse, TimeoutError
 from redis.utils import HIREDIS_AVAILABLE
 from tests.conftest import skip_if_server_version_lt
 
@@ -60,3 +68,44 @@ async def test_socket_param_regression(r):
 async def test_can_run_concurrent_commands(r):
     assert await r.ping() is True
     assert all(await asyncio.gather(*(r.ping() for _ in range(10))))
+
+
+async def test_connect_retry_on_timeout_error():
+    """Test that the _connect function is retried in case of a timeout"""
+    conn = Connection(retry_on_timeout=True, retry=Retry(NoBackoff(), 3))
+    origin_connect = conn._connect
+    conn._connect = mock.AsyncMock()
+
+    async def mock_connect():
+        # connect only on the last retry
+        if conn._connect.call_count <= 2:
+            raise socket.timeout
+        else:
+            return await origin_connect()
+
+    conn._connect.side_effect = mock_connect
+    await conn.connect()
+    assert conn._connect.call_count == 3
+
+
+async def test_connect_without_retry_on_os_error():
+    """Test that the _connect function is not being retried in case of a OSError"""
+    with patch.object(Connection, "_connect") as _connect:
+        _connect.side_effect = OSError("")
+        conn = Connection(retry_on_timeout=True, retry=Retry(NoBackoff(), 2))
+        with pytest.raises(ConnectionError):
+            await conn.connect()
+        assert _connect.call_count == 1
+
+
+async def test_connect_timeout_error_without_retry():
+    """Test that the _connect function is not being retried if retry_on_timeout is
+    set to False"""
+    conn = Connection(retry_on_timeout=False)
+    conn._connect = mock.AsyncMock()
+    conn._connect.side_effect = socket.timeout
+
+    with pytest.raises(TimeoutError) as e:
+        await conn.connect()
+    assert conn._connect.call_count == 1
+    assert str(e.value) == "Timeout connecting to server"
diff --git a/tests/test_asyncio/test_sentinel_managed_connection.py b/tests/test_asyncio/test_sentinel_managed_connection.py
new file mode 100644
index 0000000000..a6e9f37a63
--- /dev/null
+++ b/tests/test_asyncio/test_sentinel_managed_connection.py
@@ -0,0 +1,37 @@
+import socket
+
+import pytest
+
+from redis.asyncio.retry import Retry
+from redis.asyncio.sentinel import SentinelManagedConnection
+from redis.backoff import NoBackoff
+
+from .compat import mock
+
+pytestmark = pytest.mark.asyncio
+
+
+async def test_connect_retry_on_timeout_error():
+    """Test that the _connect function is retried in case of a timeout"""
+    connection_pool = mock.AsyncMock()
+    connection_pool.get_master_address = mock.AsyncMock(
+        return_value=("localhost", 6379)
+    )
+    conn = SentinelManagedConnection(
+        retry_on_timeout=True,
+        retry=Retry(NoBackoff(), 3),
+        connection_pool=connection_pool,
+    )
+    origin_connect = conn._connect
+    conn._connect = mock.AsyncMock()
+
+    async def mock_connect():
+        # connect only on the last retry
+        if conn._connect.call_count <= 2:
+            raise socket.timeout
+        else:
+            return await origin_connect()
+
+    conn._connect.side_effect = mock_connect
+    await conn.connect()
+    assert conn._connect.call_count == 3

From b2bcbc8bf1ae5622567acbc20e30e9c2e977e5c0 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 21 Jul 2022 15:17:14 +0300
Subject: [PATCH 0532/1164] fix is_connected (#2278)

---
 redis/asyncio/connection.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 5bf2a0fd74..a528abce04 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -687,7 +687,7 @@ def __del__(self):
 
     @property
     def is_connected(self):
-        return self._reader and self._writer
+        return self._reader is not None and self._writer is not None
 
     def register_connect_callback(self, callback):
         self._connect_callbacks.append(weakref.WeakMethod(callback))

From d08fdc3f202caedb3def39fc442216c915642258 Mon Sep 17 00:00:00 2001
From: Mehdi ABAAKOUK <sileht@sileht.net>
Date: Sun, 24 Jul 2022 14:33:10 +0200
Subject: [PATCH 0533/1164] fix: workaround asyncio bug on connection reset by
 peer (#2259)

Fixes #2237
---
 redis/asyncio/connection.py | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index a528abce04..4c75d2f1df 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -771,7 +771,16 @@ async def _connect(self):
     def _error_message(self, exception):
         # args for socket.error can either be (errno, "message")
         # or just "message"
-        if len(exception.args) == 1:
+        if not exception.args:
+            # asyncio has a bug where on Connection reset by peer, the
+            # exception is not instanciated, so args is empty. This is the
+            # workaround.
+            # See: https://github.com/redis/redis-py/issues/2237
+            # See: https://github.com/python/cpython/issues/94061
+            return (
+                f"Error connecting to {self.host}:{self.port}. Connection reset by peer"
+            )
+        elif len(exception.args) == 1:
             return f"Error connecting to {self.host}:{self.port}. {exception.args[0]}."
         else:
             return (

From 1d82cb2f6a4bcda86ff78dd76d62580c5a40ca08 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 24 Jul 2022 15:33:43 +0300
Subject: [PATCH 0534/1164] Fix crash: key expire while search (#2270)

* fix expire while search

* sleep
---
 redis/commands/search/result.py |  2 +-
 tests/test_search.py            | 14 ++++++++++++++
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/redis/commands/search/result.py b/redis/commands/search/result.py
index 5f4aca6411..451bf89bb7 100644
--- a/redis/commands/search/result.py
+++ b/redis/commands/search/result.py
@@ -38,7 +38,7 @@ def __init__(
             score = float(res[i + 1]) if with_scores else None
 
             fields = {}
-            if hascontent:
+            if hascontent and res[i + fields_offset] is not None:
                 fields = (
                     dict(
                         dict(
diff --git a/tests/test_search.py b/tests/test_search.py
index f0a1190fcb..642418ecdf 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1698,3 +1698,17 @@ def test_dialect(modclient: redis.Redis):
     with pytest.raises(redis.ResponseError) as err:
         modclient.ft().explain(Query("@title:(@num:[0 10])").dialect(2))
     assert "Syntax error" in str(err)
+
+
+@pytest.mark.redismod
+def test_expire_while_search(modclient: redis.Redis):
+    modclient.ft().create_index((TextField("txt"),))
+    modclient.hset("hset:1", "txt", "a")
+    modclient.hset("hset:2", "txt", "b")
+    modclient.hset("hset:3", "txt", "c")
+    assert 3 == modclient.ft().search(Query("*")).total
+    modclient.pexpire("hset:2", 300)
+    for _ in range(500):
+        modclient.ft().search(Query("*")).docs[1]
+    time.sleep(1)
+    assert 2 == modclient.ft().search(Query("*")).total

From a304953ed57c81a008a0217df375239a85ad7a04 Mon Sep 17 00:00:00 2001
From: Tim Gates <tim.gates@iress.com>
Date: Sun, 24 Jul 2022 22:34:26 +1000
Subject: [PATCH 0535/1164] docs: Fix a few typos (#2274)

* docs: Fix a few typos

There are small typos in:
- redis/cluster.py
- redis/commands/core.py
- redis/ocsp.py
- tests/test_cluster.py

Fixes:
- Should read `validity` rather than `valididy`.
- Should read `reinitialize` rather than `reinitilize`.
- Should read `farthest` rather than `farest`.
- Should read `commands` rather than `comamnds`.

* Update core.py
---
 redis/cluster.py       | 2 +-
 redis/commands/core.py | 2 +-
 redis/ocsp.py          | 2 +-
 tests/test_cluster.py  | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index 6034e9606f..9e773b2190 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -2025,7 +2025,7 @@ def _send_cluster_commands(
         )
         if attempt and allow_redirections:
             # RETRY MAGIC HAPPENS HERE!
-            # send these remaing comamnds one at a time using `execute_command`
+            # send these remaing commands one at a time using `execute_command`
             # in the main client. This keeps our retry logic
             # in one place mostly,
             # and allows us to be more confident in correctness of behavior.
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 6d67415aab..027d3dbc7c 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -5459,7 +5459,7 @@ def geosearch(
         `m` for meters (the default value), `km` for kilometers,
         `mi` for miles and `ft` for feet.
         ``sort`` indicates to return the places in a sorted way,
-        ASC for nearest to farest and DESC for farest to nearest.
+        ASC for nearest to furthest and DESC for furthest to nearest.
         ``count`` limit the results to the first count matching items.
         ``any`` is set to True, the command will return as soon as
         enough matches are found. Can't be provided without ``count``
diff --git a/redis/ocsp.py b/redis/ocsp.py
index 4753434fba..0d2c0fc453 100644
--- a/redis/ocsp.py
+++ b/redis/ocsp.py
@@ -292,7 +292,7 @@ def is_valid(self):
         This first retrieves for validate the certificate, issuer_url,
         and ocsp_server for certificate validate. Then retrieves the
         issuer certificate from the issuer_url, and finally checks
-        the valididy of OCSP revocation status.
+        the validity of OCSP revocation status.
         """
 
         # validate the certificate
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 03533230fe..5652673af9 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -672,7 +672,7 @@ def __init__(self, val=0):
         with patch.object(Redis, "parse_response") as parse_response:
 
             def moved_redirect_effect(connection, *args, **options):
-                # raise a timeout for 5 times so we'll need to reinitilize the topology
+                # raise a timeout for 5 times so we'll need to reinitialize the topology
                 if count.val == 4:
                     parse_response.side_effect = real_func
                 count.val += 1

From ae171d16e173c367256b1da42f66947fd3c6d1ea Mon Sep 17 00:00:00 2001
From: Utkarsh Gupta <utkarshgupta137@gmail.com>
Date: Sun, 24 Jul 2022 18:05:01 +0530
Subject: [PATCH 0536/1164] async_cluster: fix concurrent pipeline (#2280)

- each pipeline should create separate stacks for each node
---
 redis/asyncio/cluster.py           | 18 +++++++++---------
 tests/test_asyncio/test_cluster.py |  8 ++++++++
 2 files changed, 17 insertions(+), 9 deletions(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 2894004403..3fe3ebc47e 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -755,7 +755,6 @@ class ClusterNode:
     """
 
     __slots__ = (
-        "_command_stack",
         "_connections",
         "_free",
         "connection_class",
@@ -796,7 +795,6 @@ def __init__(
 
         self._connections: List[Connection] = []
         self._free: Deque[Connection] = collections.deque(maxlen=self.max_connections)
-        self._command_stack: List["PipelineCommand"] = []
 
     def __repr__(self) -> str:
         return (
@@ -887,18 +885,18 @@ async def execute_command(self, *args: Any, **kwargs: Any) -> Any:
             # Release connection
             self._free.append(connection)
 
-    async def execute_pipeline(self) -> bool:
+    async def execute_pipeline(self, commands: List["PipelineCommand"]) -> bool:
         # Acquire connection
         connection = self.acquire_connection()
 
         # Execute command
         await connection.send_packed_command(
-            connection.pack_commands(cmd.args for cmd in self._command_stack), False
+            connection.pack_commands(cmd.args for cmd in commands), False
         )
 
         # Read responses
         ret = False
-        for cmd in self._command_stack:
+        for cmd in commands:
             try:
                 cmd.result = await self.parse_response(
                     connection, cmd.args[0], **cmd.kwargs
@@ -1365,12 +1363,14 @@ async def _execute(
 
             node = target_nodes[0]
             if node.name not in nodes:
-                nodes[node.name] = node
-                node._command_stack = []
-            node._command_stack.append(cmd)
+                nodes[node.name] = (node, [])
+            nodes[node.name][1].append(cmd)
 
         errors = await asyncio.gather(
-            *(asyncio.ensure_future(node.execute_pipeline()) for node in nodes.values())
+            *(
+                asyncio.ensure_future(node[0].execute_pipeline(node[1]))
+                for node in nodes.values()
+            )
         )
 
         if any(errors):
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index f4ea5cd7ac..0d0ea33db2 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -2476,3 +2476,11 @@ async def test_readonly_pipeline_from_readonly_client(
                         executed_on_replica = True
                         break
             assert executed_on_replica
+
+    async def test_can_run_concurrent_pipelines(self, r: RedisCluster) -> None:
+        """Test that the pipeline can be used concurrently."""
+        await asyncio.gather(
+            *(self.test_redis_cluster_pipeline(r) for i in range(100)),
+            *(self.test_multi_key_operation_with_a_single_slot(r) for i in range(100)),
+            *(self.test_multi_key_operation_with_multi_slots(r) for i in range(100)),
+        )

From 912acccb610b182fa69420e2c79bb5bc06d94703 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 24 Jul 2022 15:39:02 +0300
Subject: [PATCH 0537/1164] Add support for TIMESERIES 1.8 (#2296)

* Add support for timeseries 1.8

* fix info

* linters

* linters

* fix info test

* type hints

* linters
---
 redis/commands/timeseries/commands.py | 668 +++++++++++++++-----------
 redis/commands/timeseries/info.py     |  18 +-
 tests/test_timeseries.py              | 243 +++++++++-
 3 files changed, 648 insertions(+), 281 deletions(-)

diff --git a/redis/commands/timeseries/commands.py b/redis/commands/timeseries/commands.py
index 3a30c246d5..13e3cdf498 100644
--- a/redis/commands/timeseries/commands.py
+++ b/redis/commands/timeseries/commands.py
@@ -1,4 +1,7 @@
+from typing import Dict, List, Optional, Tuple, Union
+
 from redis.exceptions import DataError
+from redis.typing import KeyT, Number
 
 ADD_CMD = "TS.ADD"
 ALTER_CMD = "TS.ALTER"
@@ -22,7 +25,15 @@
 class TimeSeriesCommands:
     """RedisTimeSeries Commands."""
 
-    def create(self, key, **kwargs):
+    def create(
+        self,
+        key: KeyT,
+        retention_msecs: Optional[int] = None,
+        uncompressed: Optional[bool] = False,
+        labels: Optional[Dict[str, str]] = None,
+        chunk_size: Optional[int] = None,
+        duplicate_policy: Optional[str] = None,
+    ):
         """
         Create a new time-series.
 
@@ -31,40 +42,26 @@ def create(self, key, **kwargs):
         key:
             time-series key
         retention_msecs:
-            Maximum age for samples compared to last event time (in milliseconds).
+            Maximum age for samples compared to highest reported timestamp (in milliseconds).
             If None or 0 is passed then  the series is not trimmed at all.
         uncompressed:
-            Since RedisTimeSeries v1.2, both timestamps and values are
-            compressed by default.
-            Adding this flag will keep data in an uncompressed form.
-            Compression not only saves
-            memory but usually improve performance due to lower number
-            of memory accesses.
+            Changes data storage from compressed (by default) to uncompressed
         labels:
             Set of label-value pairs that represent metadata labels of the key.
         chunk_size:
-            Each time-serie uses chunks of memory of fixed size for
-            time series samples.
-            You can alter the default TSDB chunk size by passing the
-            chunk_size argument (in Bytes).
+            Memory size, in bytes, allocated for each data chunk.
+            Must be a multiple of 8 in the range [128 .. 1048576].
         duplicate_policy:
-            Since RedisTimeSeries v1.4 you can specify the duplicate sample policy
-            ( Configure what to do on duplicate sample. )
+            Policy for handling multiple samples with identical timestamps.
             Can be one of:
             - 'block': an error will occur for any out of order sample.
             - 'first': ignore the new value.
             - 'last': override with latest value.
             - 'min': only override if the value is lower than the existing value.
             - 'max': only override if the value is higher than the existing value.
-            When this is not set, the server-wide default will be used.
 
-        For more information: https://oss.redis.com/redistimeseries/commands/#tscreate
+        For more information: https://redis.io/commands/ts.create/
         """  # noqa
-        retention_msecs = kwargs.get("retention_msecs", None)
-        uncompressed = kwargs.get("uncompressed", False)
-        labels = kwargs.get("labels", {})
-        chunk_size = kwargs.get("chunk_size", None)
-        duplicate_policy = kwargs.get("duplicate_policy", None)
         params = [key]
         self._append_retention(params, retention_msecs)
         self._append_uncompressed(params, uncompressed)
@@ -74,29 +71,62 @@ def create(self, key, **kwargs):
 
         return self.execute_command(CREATE_CMD, *params)
 
-    def alter(self, key, **kwargs):
+    def alter(
+        self,
+        key: KeyT,
+        retention_msecs: Optional[int] = None,
+        labels: Optional[Dict[str, str]] = None,
+        chunk_size: Optional[int] = None,
+        duplicate_policy: Optional[str] = None,
+    ):
         """
-        Update the retention, labels of an existing key.
-        For more information see
+        Update the retention, chunk size, duplicate policy, and labels of an existing
+        time series.
+
+        Args:
 
-        The parameters are the same as TS.CREATE.
+        key:
+            time-series key
+        retention_msecs:
+            Maximum retention period, compared to maximal existing timestamp (in milliseconds).
+            If None or 0 is passed then  the series is not trimmed at all.
+        labels:
+            Set of label-value pairs that represent metadata labels of the key.
+        chunk_size:
+            Memory size, in bytes, allocated for each data chunk.
+            Must be a multiple of 8 in the range [128 .. 1048576].
+        duplicate_policy:
+            Policy for handling multiple samples with identical timestamps.
+            Can be one of:
+            - 'block': an error will occur for any out of order sample.
+            - 'first': ignore the new value.
+            - 'last': override with latest value.
+            - 'min': only override if the value is lower than the existing value.
+            - 'max': only override if the value is higher than the existing value.
 
-        For more information: https://oss.redis.com/redistimeseries/commands/#tsalter
+        For more information: https://redis.io/commands/ts.alter/
         """  # noqa
-        retention_msecs = kwargs.get("retention_msecs", None)
-        labels = kwargs.get("labels", {})
-        duplicate_policy = kwargs.get("duplicate_policy", None)
         params = [key]
         self._append_retention(params, retention_msecs)
+        self._append_chunk_size(params, chunk_size)
         self._append_duplicate_policy(params, ALTER_CMD, duplicate_policy)
         self._append_labels(params, labels)
 
         return self.execute_command(ALTER_CMD, *params)
 
-    def add(self, key, timestamp, value, **kwargs):
+    def add(
+        self,
+        key: KeyT,
+        timestamp: Union[int, str],
+        value: Number,
+        retention_msecs: Optional[int] = None,
+        uncompressed: Optional[bool] = False,
+        labels: Optional[Dict[str, str]] = None,
+        chunk_size: Optional[int] = None,
+        duplicate_policy: Optional[str] = None,
+    ):
         """
-        Append (or create and append) a new sample to the series.
-        For more information see
+        Append (or create and append) a new sample to a time series.
 
         Args:
 
@@ -107,35 +137,26 @@ def add(self, key, timestamp, value, **kwargs):
         value:
             Numeric data value of the sample
         retention_msecs:
-            Maximum age for samples compared to last event time (in milliseconds).
+            Maximum retention period, compared to maximal existing timestamp (in milliseconds).
             If None or 0 is passed then  the series is not trimmed at all.
         uncompressed:
-            Since RedisTimeSeries v1.2, both timestamps and values are compressed by default.
-            Adding this flag will keep data in an uncompressed form. Compression not only saves
-            memory but usually improve performance due to lower number of memory accesses.
+            Changes data storage from compressed (by default) to uncompressed
         labels:
             Set of label-value pairs that represent metadata labels of the key.
         chunk_size:
-            Each time-serie uses chunks of memory of fixed size for time series samples.
-            You can alter the default TSDB chunk size by passing the chunk_size argument (in Bytes).
+            Memory size, in bytes, allocated for each data chunk.
+            Must be a multiple of 8 in the range [128 .. 1048576].
         duplicate_policy:
-            Since RedisTimeSeries v1.4 you can specify the duplicate sample policy
-            (Configure what to do on duplicate sample).
+            Policy for handling multiple samples with identical timestamps.
             Can be one of:
             - 'block': an error will occur for any out of order sample.
             - 'first': ignore the new value.
             - 'last': override with latest value.
             - 'min': only override if the value is lower than the existing value.
             - 'max': only override if the value is higher than the existing value.
-            When this is not set, the server-wide default will be used.
 
-        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsadd
+        For more information: https://redis.io/commands/ts.add/
         """  # noqa
-        retention_msecs = kwargs.get("retention_msecs", None)
-        uncompressed = kwargs.get("uncompressed", False)
-        labels = kwargs.get("labels", {})
-        chunk_size = kwargs.get("chunk_size", None)
-        duplicate_policy = kwargs.get("duplicate_policy", None)
         params = [key, timestamp, value]
         self._append_retention(params, retention_msecs)
         self._append_uncompressed(params, uncompressed)
@@ -145,28 +166,34 @@ def add(self, key, timestamp, value, **kwargs):
 
         return self.execute_command(ADD_CMD, *params)
 
-    def madd(self, ktv_tuples):
+    def madd(self, ktv_tuples: List[Tuple[KeyT, Union[int, str], Number]]):
         """
         Append (or create and append) a new `value` to series
         `key` with `timestamp`.
         Expects a list of `tuples` as (`key`,`timestamp`, `value`).
         Return value is an array with timestamps of insertions.
 
-        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsmadd
+        For more information: https://redis.io/commands/ts.madd/
         """  # noqa
         params = []
         for ktv in ktv_tuples:
-            for item in ktv:
-                params.append(item)
+            params.extend(ktv)
 
         return self.execute_command(MADD_CMD, *params)
 
-    def incrby(self, key, value, **kwargs):
+    def incrby(
+        self,
+        key: KeyT,
+        value: Number,
+        timestamp: Optional[Union[int, str]] = None,
+        retention_msecs: Optional[int] = None,
+        uncompressed: Optional[bool] = False,
+        labels: Optional[Dict[str, str]] = None,
+        chunk_size: Optional[int] = None,
+    ):
         """
-        Increment (or create an time-series and increment) the latest
-        sample's of a series.
-        This command can be used as a counter or gauge that automatically gets
-        history as a time series.
+        Increment (or create an time-series and increment) the latest sample's of a series.
+        This command can be used as a counter or gauge that automatically gets history as a time series.
 
         Args:
 
@@ -175,27 +202,19 @@ def incrby(self, key, value, **kwargs):
         value:
             Numeric data value of the sample
         timestamp:
-            Timestamp of the sample. None can be used for automatic timestamp (using the system clock).
+            Timestamp of the sample. * can be used for automatic timestamp (using the system clock).
         retention_msecs:
             Maximum age for samples compared to last event time (in milliseconds).
             If None or 0 is passed then  the series is not trimmed at all.
         uncompressed:
-            Since RedisTimeSeries v1.2, both timestamps and values are compressed by default.
-            Adding this flag will keep data in an uncompressed form. Compression not only saves
-            memory but usually improve performance due to lower number of memory accesses.
+            Changes data storage from compressed (by default) to uncompressed
         labels:
             Set of label-value pairs that represent metadata labels of the key.
         chunk_size:
-            Each time-series uses chunks of memory of fixed size for time series samples.
-            You can alter the default TSDB chunk size by passing the chunk_size argument (in Bytes).
+            Memory size, in bytes, allocated for each data chunk.
 
-        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsincrbytsdecrby
+        For more information: https://redis.io/commands/ts.incrby/
         """  # noqa
-        timestamp = kwargs.get("timestamp", None)
-        retention_msecs = kwargs.get("retention_msecs", None)
-        uncompressed = kwargs.get("uncompressed", False)
-        labels = kwargs.get("labels", {})
-        chunk_size = kwargs.get("chunk_size", None)
         params = [key, value]
         self._append_timestamp(params, timestamp)
         self._append_retention(params, retention_msecs)
@@ -205,12 +224,19 @@ def incrby(self, key, value, **kwargs):
 
         return self.execute_command(INCRBY_CMD, *params)
 
-    def decrby(self, key, value, **kwargs):
+    def decrby(
+        self,
+        key: KeyT,
+        value: Number,
+        timestamp: Optional[Union[int, str]] = None,
+        retention_msecs: Optional[int] = None,
+        uncompressed: Optional[bool] = False,
+        labels: Optional[Dict[str, str]] = None,
+        chunk_size: Optional[int] = None,
+    ):
         """
-        Decrement (or create an time-series and decrement) the
-        latest sample's of a series.
-        This command can be used as a counter or gauge that
-        automatically gets history as a time series.
+        Decrement (or create an time-series and decrement) the latest sample's of a series.
+        This command can be used as a counter or gauge that automatically gets history as a time series.
 
         Args:
 
@@ -219,31 +245,19 @@ def decrby(self, key, value, **kwargs):
         value:
             Numeric data value of the sample
         timestamp:
-            Timestamp of the sample. None can be used for automatic
-            timestamp (using the system clock).
+            Timestamp of the sample. * can be used for automatic timestamp (using the system clock).
         retention_msecs:
             Maximum age for samples compared to last event time (in milliseconds).
             If None or 0 is passed then  the series is not trimmed at all.
         uncompressed:
-            Since RedisTimeSeries v1.2, both timestamps and values are
-            compressed by default.
-            Adding this flag will keep data in an uncompressed form.
-            Compression not only saves
-            memory but usually improve performance due to lower number
-            of memory accesses.
+            Changes data storage from compressed (by default) to uncompressed
         labels:
             Set of label-value pairs that represent metadata labels of the key.
         chunk_size:
-            Each time-series uses chunks of memory of fixed size for time series samples.
-            You can alter the default TSDB chunk size by passing the chunk_size argument (in Bytes).
+            Memory size, in bytes, allocated for each data chunk.
 
-        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsincrbytsdecrby
+        For more information: https://redis.io/commands/ts.decrby/
         """  # noqa
-        timestamp = kwargs.get("timestamp", None)
-        retention_msecs = kwargs.get("retention_msecs", None)
-        uncompressed = kwargs.get("uncompressed", False)
-        labels = kwargs.get("labels", {})
-        chunk_size = kwargs.get("chunk_size", None)
         params = [key, value]
         self._append_timestamp(params, timestamp)
         self._append_retention(params, retention_msecs)
@@ -253,14 +267,9 @@ def decrby(self, key, value, **kwargs):
 
         return self.execute_command(DECRBY_CMD, *params)
 
-    def delete(self, key, from_time, to_time):
+    def delete(self, key: KeyT, from_time: int, to_time: int):
         """
-        Delete data points for a given timeseries and interval range
-        in the form of start and end delete timestamps.
-        The given timestamp interval is closed (inclusive), meaning start
-        and end data points will also be deleted.
-        Return the count for deleted items.
-        For more information see
+        Delete all samples between two timestamps for a given time series.
 
         Args:
 
@@ -271,68 +280,98 @@ def delete(self, key, from_time, to_time):
         to_time:
             End timestamp for the range deletion.
 
-        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsdel
+        For more information: https://redis.io/commands/ts.del/
         """  # noqa
         return self.execute_command(DEL_CMD, key, from_time, to_time)
 
-    def createrule(self, source_key, dest_key, aggregation_type, bucket_size_msec):
+    def createrule(
+        self,
+        source_key: KeyT,
+        dest_key: KeyT,
+        aggregation_type: str,
+        bucket_size_msec: int,
+        align_timestamp: Optional[int] = None,
+    ):
         """
         Create a compaction rule from values added to `source_key` into `dest_key`.
-        Aggregating for `bucket_size_msec` where an `aggregation_type` can be
-        [`avg`, `sum`, `min`, `max`, `range`, `count`, `first`, `last`,
-        `std.p`, `std.s`, `var.p`, `var.s`]
 
-        For more information: https://oss.redis.com/redistimeseries/master/commands/#tscreaterule
+        Args:
+
+        source_key:
+            Key name for source time series
+        dest_key:
+            Key name for destination (compacted) time series
+        aggregation_type:
+            Aggregation type: One of the following:
+            [`avg`, `sum`, `min`, `max`, `range`, `count`, `first`, `last`, `std.p`,
+            `std.s`, `var.p`, `var.s`, `twa`]
+        bucket_size_msec:
+            Duration of each bucket, in milliseconds
+        align_timestamp:
+            Assure that there is a bucket that starts at exactly align_timestamp and
+            align all other buckets accordingly.
+
+        For more information: https://redis.io/commands/ts.createrule/
         """  # noqa
         params = [source_key, dest_key]
         self._append_aggregation(params, aggregation_type, bucket_size_msec)
+        if align_timestamp is not None:
+            params.append(align_timestamp)
 
         return self.execute_command(CREATERULE_CMD, *params)
 
-    def deleterule(self, source_key, dest_key):
+    def deleterule(self, source_key: KeyT, dest_key: KeyT):
         """
-        Delete a compaction rule.
-        For more information see
+        Delete a compaction rule from `source_key` to `dest_key`..
 
-        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsdeleterule
+        For more information: https://redis.io/commands/ts.deleterule/
         """  # noqa
         return self.execute_command(DELETERULE_CMD, source_key, dest_key)
 
     def __range_params(
         self,
-        key,
-        from_time,
-        to_time,
-        count,
-        aggregation_type,
-        bucket_size_msec,
-        filter_by_ts,
-        filter_by_min_value,
-        filter_by_max_value,
-        align,
+        key: KeyT,
+        from_time: Union[int, str],
+        to_time: Union[int, str],
+        count: Optional[int],
+        aggregation_type: Optional[str],
+        bucket_size_msec: Optional[int],
+        filter_by_ts: Optional[List[int]],
+        filter_by_min_value: Optional[int],
+        filter_by_max_value: Optional[int],
+        align: Optional[Union[int, str]],
+        latest: Optional[bool],
+        bucket_timestamp: Optional[str],
+        empty: Optional[bool],
     ):
         """Create TS.RANGE and TS.REVRANGE arguments."""
         params = [key, from_time, to_time]
+        self._append_latest(params, latest)
         self._append_filer_by_ts(params, filter_by_ts)
         self._append_filer_by_value(params, filter_by_min_value, filter_by_max_value)
         self._append_count(params, count)
         self._append_align(params, align)
         self._append_aggregation(params, aggregation_type, bucket_size_msec)
+        self._append_bucket_timestamp(params, bucket_timestamp)
+        self._append_empty(params, empty)
 
         return params
 
     def range(
         self,
-        key,
-        from_time,
-        to_time,
-        count=None,
-        aggregation_type=None,
-        bucket_size_msec=0,
-        filter_by_ts=None,
-        filter_by_min_value=None,
-        filter_by_max_value=None,
-        align=None,
+        key: KeyT,
+        from_time: Union[int, str],
+        to_time: Union[int, str],
+        count: Optional[int] = None,
+        aggregation_type: Optional[str] = None,
+        bucket_size_msec: Optional[int] = 0,
+        filter_by_ts: Optional[List[int]] = None,
+        filter_by_min_value: Optional[int] = None,
+        filter_by_max_value: Optional[int] = None,
+        align: Optional[Union[int, str]] = None,
+        latest: Optional[bool] = False,
+        bucket_timestamp: Optional[str] = None,
+        empty: Optional[bool] = False,
     ):
         """
         Query a range in forward direction for a specific time-serie.
@@ -342,31 +381,34 @@ def range(
         key:
             Key name for timeseries.
         from_time:
-            Start timestamp for the range query. - can be used to express
-            the minimum possible timestamp (0).
+            Start timestamp for the range query. - can be used to express the minimum possible timestamp (0).
         to_time:
-            End timestamp for range query, + can be used to express the
-            maximum possible timestamp.
+            End timestamp for range query, + can be used to express the maximum possible timestamp.
         count:
-            Optional maximum number of returned results.
+            Limits the number of returned samples.
         aggregation_type:
-            Optional aggregation type. Can be one of
-            [`avg`, `sum`, `min`, `max`, `range`, `count`,
-            `first`, `last`, `std.p`, `std.s`, `var.p`, `var.s`]
+            Optional aggregation type. Can be one of [`avg`, `sum`, `min`, `max`,
+            `range`, `count`, `first`, `last`, `std.p`, `std.s`, `var.p`, `var.s`, `twa`]
         bucket_size_msec:
             Time bucket for aggregation in milliseconds.
         filter_by_ts:
             List of timestamps to filter the result by specific timestamps.
         filter_by_min_value:
-            Filter result by minimum value (must mention also filter
-            by_max_value).
+            Filter result by minimum value (must mention also filter by_max_value).
         filter_by_max_value:
-            Filter result by maximum value (must mention also filter
-            by_min_value).
+            Filter result by maximum value (must mention also filter by_min_value).
         align:
             Timestamp for alignment control for aggregation.
-
-        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsrangetsrevrange
+        latest:
+            Used when a time series is a compaction, reports the compacted value of the
+            latest possibly partial bucket
+        bucket_timestamp:
+            Controls how bucket timestamps are reported. Can be one of [`-`, `low`, `+`,
+            `high`, `~`, `mid`].
+        empty:
+            Reports aggregations for empty buckets.
+
+        For more information: https://redis.io/commands/ts.range/
         """  # noqa
         params = self.__range_params(
             key,
@@ -379,21 +421,27 @@ def range(
             filter_by_min_value,
             filter_by_max_value,
             align,
+            latest,
+            bucket_timestamp,
+            empty,
         )
         return self.execute_command(RANGE_CMD, *params)
 
     def revrange(
         self,
-        key,
-        from_time,
-        to_time,
-        count=None,
-        aggregation_type=None,
-        bucket_size_msec=0,
-        filter_by_ts=None,
-        filter_by_min_value=None,
-        filter_by_max_value=None,
-        align=None,
+        key: KeyT,
+        from_time: Union[int, str],
+        to_time: Union[int, str],
+        count: Optional[int] = None,
+        aggregation_type: Optional[str] = None,
+        bucket_size_msec: Optional[int] = 0,
+        filter_by_ts: Optional[List[int]] = None,
+        filter_by_min_value: Optional[int] = None,
+        filter_by_max_value: Optional[int] = None,
+        align: Optional[Union[int, str]] = None,
+        latest: Optional[bool] = False,
+        bucket_timestamp: Optional[str] = None,
+        empty: Optional[bool] = False,
     ):
         """
         Query a range in reverse direction for a specific time-series.
@@ -409,10 +457,10 @@ def revrange(
         to_time:
             End timestamp for range query, + can be used to express the maximum possible timestamp.
         count:
-            Optional maximum number of returned results.
+            Limits the number of returned samples.
         aggregation_type:
-            Optional aggregation type. Can be one of [`avg`, `sum`, `min`, `max`, `range`, `count`,
-            `first`, `last`, `std.p`, `std.s`, `var.p`, `var.s`]
+            Optional aggregation type. Can be one of [`avg`, `sum`, `min`, `max`,
+            `range`, `count`, `first`, `last`, `std.p`, `std.s`, `var.p`, `var.s`, `twa`]
         bucket_size_msec:
             Time bucket for aggregation in milliseconds.
         filter_by_ts:
@@ -423,8 +471,16 @@ def revrange(
             Filter result by maximum value (must mention also filter_by_min_value).
         align:
             Timestamp for alignment control for aggregation.
-
-        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsrangetsrevrange
+        latest:
+            Used when a time series is a compaction, reports the compacted value of the
+            latest possibly partial bucket
+        bucket_timestamp:
+            Controls how bucket timestamps are reported. Can be one of [`-`, `low`, `+`,
+            `high`, `~`, `mid`].
+        empty:
+            Reports aggregations for empty buckets.
+
+        For more information: https://redis.io/commands/ts.revrange/
         """  # noqa
         params = self.__range_params(
             key,
@@ -437,34 +493,43 @@ def revrange(
             filter_by_min_value,
             filter_by_max_value,
             align,
+            latest,
+            bucket_timestamp,
+            empty,
         )
         return self.execute_command(REVRANGE_CMD, *params)
 
     def __mrange_params(
         self,
-        aggregation_type,
-        bucket_size_msec,
-        count,
-        filters,
-        from_time,
-        to_time,
-        with_labels,
-        filter_by_ts,
-        filter_by_min_value,
-        filter_by_max_value,
-        groupby,
-        reduce,
-        select_labels,
-        align,
+        aggregation_type: Optional[str],
+        bucket_size_msec: Optional[int],
+        count: Optional[int],
+        filters: List[str],
+        from_time: Union[int, str],
+        to_time: Union[int, str],
+        with_labels: Optional[bool],
+        filter_by_ts: Optional[List[int]],
+        filter_by_min_value: Optional[int],
+        filter_by_max_value: Optional[int],
+        groupby: Optional[str],
+        reduce: Optional[str],
+        select_labels: Optional[List[str]],
+        align: Optional[Union[int, str]],
+        latest: Optional[bool],
+        bucket_timestamp: Optional[str],
+        empty: Optional[bool],
     ):
         """Create TS.MRANGE and TS.MREVRANGE arguments."""
         params = [from_time, to_time]
+        self._append_latest(params, latest)
         self._append_filer_by_ts(params, filter_by_ts)
         self._append_filer_by_value(params, filter_by_min_value, filter_by_max_value)
+        self._append_with_labels(params, with_labels, select_labels)
         self._append_count(params, count)
         self._append_align(params, align)
         self._append_aggregation(params, aggregation_type, bucket_size_msec)
-        self._append_with_labels(params, with_labels, select_labels)
+        self._append_bucket_timestamp(params, bucket_timestamp)
+        self._append_empty(params, empty)
         params.extend(["FILTER"])
         params += filters
         self._append_groupby_reduce(params, groupby, reduce)
@@ -472,20 +537,23 @@ def __mrange_params(
 
     def mrange(
         self,
-        from_time,
-        to_time,
-        filters,
-        count=None,
-        aggregation_type=None,
-        bucket_size_msec=0,
-        with_labels=False,
-        filter_by_ts=None,
-        filter_by_min_value=None,
-        filter_by_max_value=None,
-        groupby=None,
-        reduce=None,
-        select_labels=None,
-        align=None,
+        from_time: Union[int, str],
+        to_time: Union[int, str],
+        filters: List[str],
+        count: Optional[int] = None,
+        aggregation_type: Optional[str] = None,
+        bucket_size_msec: Optional[int] = 0,
+        with_labels: Optional[bool] = False,
+        filter_by_ts: Optional[List[int]] = None,
+        filter_by_min_value: Optional[int] = None,
+        filter_by_max_value: Optional[int] = None,
+        groupby: Optional[str] = None,
+        reduce: Optional[str] = None,
+        select_labels: Optional[List[str]] = None,
+        align: Optional[Union[int, str]] = None,
+        latest: Optional[bool] = False,
+        bucket_timestamp: Optional[str] = None,
+        empty: Optional[bool] = False,
     ):
         """
         Query a range across multiple time-series by filters in forward direction.
@@ -493,46 +561,45 @@ def mrange(
         Args:
 
         from_time:
-            Start timestamp for the range query. `-` can be used to
-            express the minimum possible timestamp (0).
+            Start timestamp for the range query. `-` can be used to express the minimum possible timestamp (0).
         to_time:
-            End timestamp for range query, `+` can be used to express
-            the maximum possible timestamp.
+            End timestamp for range query, `+` can be used to express the maximum possible timestamp.
         filters:
             filter to match the time-series labels.
         count:
-            Optional maximum number of returned results.
+            Limits the number of returned samples.
         aggregation_type:
-            Optional aggregation type. Can be one of
-            [`avg`, `sum`, `min`, `max`, `range`, `count`,
-            `first`, `last`, `std.p`, `std.s`, `var.p`, `var.s`]
+            Optional aggregation type. Can be one of [`avg`, `sum`, `min`, `max`,
+            `range`, `count`, `first`, `last`, `std.p`, `std.s`, `var.p`, `var.s`, `twa`]
         bucket_size_msec:
             Time bucket for aggregation in milliseconds.
         with_labels:
-            Include in the reply the label-value pairs that represent metadata
-            labels of the time-series.
-            If this argument is not set, by default, an empty Array will be
-            replied on the labels array position.
+            Include in the reply all label-value pairs representing metadata labels of the time series.
         filter_by_ts:
             List of timestamps to filter the result by specific timestamps.
         filter_by_min_value:
-            Filter result by minimum value (must mention also
-            filter_by_max_value).
+            Filter result by minimum value (must mention also filter_by_max_value).
         filter_by_max_value:
-            Filter result by maximum value (must mention also
-            filter_by_min_value).
+            Filter result by maximum value (must mention also filter_by_min_value).
         groupby:
             Grouping by fields the results (must mention also reduce).
         reduce:
-            Applying reducer functions on each group. Can be one
-            of [`sum`, `min`, `max`].
+            Applying reducer functions on each group. Can be one of [`avg` `sum`, `min`,
+            `max`, `range`, `count`, `std.p`, `std.s`, `var.p`, `var.s`].
         select_labels:
-            Include in the reply only a subset of the key-value
-            pair labels of a series.
+            Include in the reply only a subset of the key-value pair labels of a series.
         align:
             Timestamp for alignment control for aggregation.
-
-        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsmrangetsmrevrange
+        latest:
+            Used when a time series is a compaction, reports the compacted
+            value of the latest possibly partial bucket
+        bucket_timestamp:
+            Controls how bucket timestamps are reported. Can be one of [`-`, `low`, `+`,
+            `high`, `~`, `mid`].
+        empty:
+            Reports aggregations for empty buckets.
+
+        For more information: https://redis.io/commands/ts.mrange/
         """  # noqa
         params = self.__mrange_params(
             aggregation_type,
@@ -549,26 +616,32 @@ def mrange(
             reduce,
             select_labels,
             align,
+            latest,
+            bucket_timestamp,
+            empty,
         )
 
         return self.execute_command(MRANGE_CMD, *params)
 
     def mrevrange(
         self,
-        from_time,
-        to_time,
-        filters,
-        count=None,
-        aggregation_type=None,
-        bucket_size_msec=0,
-        with_labels=False,
-        filter_by_ts=None,
-        filter_by_min_value=None,
-        filter_by_max_value=None,
-        groupby=None,
-        reduce=None,
-        select_labels=None,
-        align=None,
+        from_time: Union[int, str],
+        to_time: Union[int, str],
+        filters: List[str],
+        count: Optional[int] = None,
+        aggregation_type: Optional[str] = None,
+        bucket_size_msec: Optional[int] = 0,
+        with_labels: Optional[bool] = False,
+        filter_by_ts: Optional[List[int]] = None,
+        filter_by_min_value: Optional[int] = None,
+        filter_by_max_value: Optional[int] = None,
+        groupby: Optional[str] = None,
+        reduce: Optional[str] = None,
+        select_labels: Optional[List[str]] = None,
+        align: Optional[Union[int, str]] = None,
+        latest: Optional[bool] = False,
+        bucket_timestamp: Optional[str] = None,
+        empty: Optional[bool] = False,
     ):
         """
         Query a range across multiple time-series by filters in reverse direction.
@@ -576,48 +649,45 @@ def mrevrange(
         Args:
 
         from_time:
-            Start timestamp for the range query. - can be used to express
-            the minimum possible timestamp (0).
+            Start timestamp for the range query. - can be used to express the minimum possible timestamp (0).
         to_time:
-            End timestamp for range query, + can be used to express
-            the maximum possible timestamp.
+            End timestamp for range query, + can be used to express the maximum possible timestamp.
         filters:
             Filter to match the time-series labels.
         count:
-            Optional maximum number of returned results.
+            Limits the number of returned samples.
         aggregation_type:
-            Optional aggregation type. Can be one of
-            [`avg`, `sum`, `min`, `max`, `range`, `count`,
-            `first`, `last`, `std.p`, `std.s`, `var.p`, `var.s`]
+            Optional aggregation type. Can be one of [`avg`, `sum`, `min`, `max`,
+            `range`, `count`, `first`, `last`, `std.p`, `std.s`, `var.p`, `var.s`, `twa`]
         bucket_size_msec:
             Time bucket for aggregation in milliseconds.
         with_labels:
-            Include in the reply the label-value pairs that represent
-            metadata labels
-            of the time-series.
-            If this argument is not set, by default, an empty Array
-            will be replied
-            on the labels array position.
+            Include in the reply all label-value pairs representing metadata labels of the time series.
         filter_by_ts:
             List of timestamps to filter the result by specific timestamps.
         filter_by_min_value:
-            Filter result by minimum value (must mention also filter
-            by_max_value).
+            Filter result by minimum value (must mention also filter_by_max_value).
         filter_by_max_value:
-            Filter result by maximum value (must mention also filter
-            by_min_value).
+            Filter result by maximum value (must mention also filter_by_min_value).
         groupby:
             Grouping by fields the results (must mention also reduce).
         reduce:
-            Applying reducer functions on each group. Can be one
-            of [`sum`, `min`, `max`].
+            Applying reducer functions on each group. Can be one of [`avg` `sum`, `min`,
+            `max`, `range`, `count`, `std.p`, `std.s`, `var.p`, `var.s`].
         select_labels:
-            Include in the reply only a subset of the key-value pair
-            labels of a series.
+            Include in the reply only a subset of the key-value pair labels of a series.
         align:
             Timestamp for alignment control for aggregation.
-
-        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsmrangetsmrevrange
+        latest:
+            Used when a time series is a compaction, reports the compacted
+            value of the latest possibly partial bucket
+        bucket_timestamp:
+            Controls how bucket timestamps are reported. Can be one of [`-`, `low`, `+`,
+            `high`, `~`, `mid`].
+        empty:
+            Reports aggregations for empty buckets.
+
+        For more information: https://redis.io/commands/ts.mrevrange/
         """  # noqa
         params = self.__mrange_params(
             aggregation_type,
@@ -634,54 +704,85 @@ def mrevrange(
             reduce,
             select_labels,
             align,
+            latest,
+            bucket_timestamp,
+            empty,
         )
 
         return self.execute_command(MREVRANGE_CMD, *params)
 
-    def get(self, key):
+    def get(self, key: KeyT, latest: Optional[bool] = False):
         """# noqa
         Get the last sample of `key`.
+        `latest` used when a time series is a compaction, reports the compacted
+        value of the latest (possibly partial) bucket
 
-        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsget
+        For more information: https://redis.io/commands/ts.get/
         """  # noqa
-        return self.execute_command(GET_CMD, key)
+        params = [key]
+        self._append_latest(params, latest)
+        return self.execute_command(GET_CMD, *params)
 
-    def mget(self, filters, with_labels=False):
+    def mget(
+        self,
+        filters: List[str],
+        with_labels: Optional[bool] = False,
+        select_labels: Optional[List[str]] = None,
+        latest: Optional[bool] = False,
+    ):
         """# noqa
         Get the last samples matching the specific `filter`.
 
-        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsmget
+        Args:
+
+        filters:
+            Filter to match the time-series labels.
+        with_labels:
+            Include in the reply all label-value pairs representing metadata
+            labels of the time series.
+        select_labels:
+            Include in the reply only a subset of the key-value pair labels of a series.
+        latest:
+            Used when a time series is a compaction, reports the compacted
+            value of the latest possibly partial bucket
+
+        For more information: https://redis.io/commands/ts.mget/
         """  # noqa
         params = []
-        self._append_with_labels(params, with_labels)
+        self._append_latest(params, latest)
+        self._append_with_labels(params, with_labels, select_labels)
         params.extend(["FILTER"])
         params += filters
         return self.execute_command(MGET_CMD, *params)
 
-    def info(self, key):
+    def info(self, key: KeyT):
         """# noqa
         Get information of `key`.
 
-        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsinfo
+        For more information: https://redis.io/commands/ts.info/
         """  # noqa
         return self.execute_command(INFO_CMD, key)
 
-    def queryindex(self, filters):
+    def queryindex(self, filters: List[str]):
         """# noqa
-        Get all the keys matching the `filter` list.
+        Get all time series keys matching the `filter` list.
 
-        For more information: https://oss.redis.com/redistimeseries/master/commands/#tsqueryindex
+        For more information: https://redis.io/commands/ts.queryindex/
         """  # noq
         return self.execute_command(QUERYINDEX_CMD, *filters)
 
     @staticmethod
-    def _append_uncompressed(params, uncompressed):
+    def _append_uncompressed(params: List[str], uncompressed: Optional[bool]):
         """Append UNCOMPRESSED tag to params."""
         if uncompressed:
             params.extend(["UNCOMPRESSED"])
 
     @staticmethod
-    def _append_with_labels(params, with_labels, select_labels=None):
+    def _append_with_labels(
+        params: List[str],
+        with_labels: Optional[bool],
+        select_labels: Optional[List[str]],
+    ):
         """Append labels behavior to params."""
         if with_labels and select_labels:
             raise DataError(
@@ -694,19 +795,21 @@ def _append_with_labels(params, with_labels, select_labels=None):
             params.extend(["SELECTED_LABELS", *select_labels])
 
     @staticmethod
-    def _append_groupby_reduce(params, groupby, reduce):
+    def _append_groupby_reduce(
+        params: List[str], groupby: Optional[str], reduce: Optional[str]
+    ):
         """Append GROUPBY REDUCE property to params."""
         if groupby is not None and reduce is not None:
             params.extend(["GROUPBY", groupby, "REDUCE", reduce.upper()])
 
     @staticmethod
-    def _append_retention(params, retention):
+    def _append_retention(params: List[str], retention: Optional[int]):
         """Append RETENTION property to params."""
         if retention is not None:
             params.extend(["RETENTION", retention])
 
     @staticmethod
-    def _append_labels(params, labels):
+    def _append_labels(params: List[str], labels: Optional[List[str]]):
         """Append LABELS property to params."""
         if labels:
             params.append("LABELS")
@@ -714,38 +817,43 @@ def _append_labels(params, labels):
                 params.extend([k, v])
 
     @staticmethod
-    def _append_count(params, count):
+    def _append_count(params: List[str], count: Optional[int]):
         """Append COUNT property to params."""
         if count is not None:
             params.extend(["COUNT", count])
 
     @staticmethod
-    def _append_timestamp(params, timestamp):
+    def _append_timestamp(params: List[str], timestamp: Optional[int]):
         """Append TIMESTAMP property to params."""
         if timestamp is not None:
             params.extend(["TIMESTAMP", timestamp])
 
     @staticmethod
-    def _append_align(params, align):
+    def _append_align(params: List[str], align: Optional[Union[int, str]]):
         """Append ALIGN property to params."""
         if align is not None:
             params.extend(["ALIGN", align])
 
     @staticmethod
-    def _append_aggregation(params, aggregation_type, bucket_size_msec):
+    def _append_aggregation(
+        params: List[str],
+        aggregation_type: Optional[str],
+        bucket_size_msec: Optional[int],
+    ):
         """Append AGGREGATION property to params."""
         if aggregation_type is not None:
-            params.append("AGGREGATION")
-            params.extend([aggregation_type, bucket_size_msec])
+            params.extend(["AGGREGATION", aggregation_type, bucket_size_msec])
 
     @staticmethod
-    def _append_chunk_size(params, chunk_size):
+    def _append_chunk_size(params: List[str], chunk_size: Optional[int]):
         """Append CHUNK_SIZE property to params."""
         if chunk_size is not None:
             params.extend(["CHUNK_SIZE", chunk_size])
 
     @staticmethod
-    def _append_duplicate_policy(params, command, duplicate_policy):
+    def _append_duplicate_policy(
+        params: List[str], command: Optional[str], duplicate_policy: Optional[str]
+    ):
         """Append DUPLICATE_POLICY property to params on CREATE
         and ON_DUPLICATE on ADD.
         """
@@ -756,13 +864,33 @@ def _append_duplicate_policy(params, command, duplicate_policy):
                 params.extend(["DUPLICATE_POLICY", duplicate_policy])
 
     @staticmethod
-    def _append_filer_by_ts(params, ts_list):
+    def _append_filer_by_ts(params: List[str], ts_list: Optional[List[int]]):
         """Append FILTER_BY_TS property to params."""
         if ts_list is not None:
             params.extend(["FILTER_BY_TS", *ts_list])
 
     @staticmethod
-    def _append_filer_by_value(params, min_value, max_value):
+    def _append_filer_by_value(
+        params: List[str], min_value: Optional[int], max_value: Optional[int]
+    ):
         """Append FILTER_BY_VALUE property to params."""
         if min_value is not None and max_value is not None:
             params.extend(["FILTER_BY_VALUE", min_value, max_value])
+
+    @staticmethod
+    def _append_latest(params: List[str], latest: Optional[bool]):
+        """Append LATEST property to params."""
+        if latest:
+            params.append("LATEST")
+
+    @staticmethod
+    def _append_bucket_timestamp(params: List[str], bucket_timestamp: Optional[str]):
+        """Append BUCKET_TIMESTAMP property to params."""
+        if bucket_timestamp is not None:
+            params.extend(["BUCKETTIMESTAMP", bucket_timestamp])
+
+    @staticmethod
+    def _append_empty(params: List[str], empty: Optional[bool]):
+        """Append EMPTY property to params."""
+        if empty:
+            params.append("EMPTY")
diff --git a/redis/commands/timeseries/info.py b/redis/commands/timeseries/info.py
index fba7f093b1..65f3baacd0 100644
--- a/redis/commands/timeseries/info.py
+++ b/redis/commands/timeseries/info.py
@@ -60,15 +60,15 @@ def __init__(self, args):
         https://oss.redis.com/redistimeseries/configuration/#duplicate_policy
         """
         response = dict(zip(map(nativestr, args[::2]), args[1::2]))
-        self.rules = response["rules"]
-        self.source_key = response["sourceKey"]
-        self.chunk_count = response["chunkCount"]
-        self.memory_usage = response["memoryUsage"]
-        self.total_samples = response["totalSamples"]
-        self.labels = list_to_dict(response["labels"])
-        self.retention_msecs = response["retentionTime"]
-        self.lastTimeStamp = response["lastTimestamp"]
-        self.first_time_stamp = response["firstTimestamp"]
+        self.rules = response.get("rules")
+        self.source_key = response.get("sourceKey")
+        self.chunk_count = response.get("chunkCount")
+        self.memory_usage = response.get("memoryUsage")
+        self.total_samples = response.get("totalSamples")
+        self.labels = list_to_dict(response.get("labels"))
+        self.retention_msecs = response.get("retentionTime")
+        self.last_timestamp = response.get("lastTimestamp")
+        self.first_timestamp = response.get("firstTimestamp")
         if "maxSamplesPerChunk" in response:
             self.max_samples_per_chunk = response["maxSamplesPerChunk"]
             self.chunk_size = (
diff --git a/tests/test_timeseries.py b/tests/test_timeseries.py
index 7d42147a16..b4b85e1715 100644
--- a/tests/test_timeseries.py
+++ b/tests/test_timeseries.py
@@ -1,8 +1,11 @@
+import math
 import time
 from time import sleep
 
 import pytest
 
+import redis
+
 from .conftest import skip_ifmodversion_lt
 
 
@@ -230,6 +233,84 @@ def test_range_advanced(client):
     assert [(0, 5.0), (5, 6.0)] == client.ts().range(
         1, 0, 10, aggregation_type="count", bucket_size_msec=10, align=5
     )
+    assert [(0, 2.5500000000000003), (10, 3.95)] == client.ts().range(
+        1, 0, 10, aggregation_type="twa", bucket_size_msec=10
+    )
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("1.8.0", "timeseries")
+def test_range_latest(client: redis.Redis):
+    timeseries = client.ts()
+    timeseries.create("t1")
+    timeseries.create("t2")
+    timeseries.createrule("t1", "t2", aggregation_type="sum", bucket_size_msec=10)
+    timeseries.add("t1", 1, 1)
+    timeseries.add("t1", 2, 3)
+    timeseries.add("t1", 11, 7)
+    timeseries.add("t1", 13, 1)
+    res = timeseries.range("t1", 0, 20)
+    assert res == [(1, 1.0), (2, 3.0), (11, 7.0), (13, 1.0)]
+    res = timeseries.range("t2", 0, 10)
+    assert res == [(0, 4.0)]
+    res = timeseries.range("t2", 0, 10, latest=True)
+    assert res == [(0, 4.0), (10, 8.0)]
+    res = timeseries.range("t2", 0, 9, latest=True)
+    assert res == [(0, 4.0)]
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("1.8.0", "timeseries")
+def test_range_bucket_timestamp(client: redis.Redis):
+    timeseries = client.ts()
+    timeseries.create("t1")
+    timeseries.add("t1", 15, 1)
+    timeseries.add("t1", 17, 4)
+    timeseries.add("t1", 51, 3)
+    timeseries.add("t1", 73, 5)
+    timeseries.add("t1", 75, 3)
+    assert [(10, 4.0), (50, 3.0), (70, 5.0)] == timeseries.range(
+        "t1", 0, 100, align=0, aggregation_type="max", bucket_size_msec=10
+    )
+    assert [(20, 4.0), (60, 3.0), (80, 5.0)] == timeseries.range(
+        "t1",
+        0,
+        100,
+        align=0,
+        aggregation_type="max",
+        bucket_size_msec=10,
+        bucket_timestamp="+",
+    )
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("1.8.0", "timeseries")
+def test_range_empty(client: redis.Redis):
+    timeseries = client.ts()
+    timeseries.create("t1")
+    timeseries.add("t1", 15, 1)
+    timeseries.add("t1", 17, 4)
+    timeseries.add("t1", 51, 3)
+    timeseries.add("t1", 73, 5)
+    timeseries.add("t1", 75, 3)
+    assert [(10, 4.0), (50, 3.0), (70, 5.0)] == timeseries.range(
+        "t1", 0, 100, align=0, aggregation_type="max", bucket_size_msec=10
+    )
+    res = timeseries.range(
+        "t1", 0, 100, align=0, aggregation_type="max", bucket_size_msec=10, empty=True
+    )
+    for i in range(len(res)):
+        if math.isnan(res[i][1]):
+            res[i] = (res[i][0], None)
+    assert [
+        (10, 4.0),
+        (20, None),
+        (30, None),
+        (40, None),
+        (50, 3.0),
+        (60, None),
+        (70, 5.0),
+    ] == res
 
 
 @pytest.mark.redismod
@@ -262,11 +343,87 @@ def test_rev_range(client):
     assert [(1, 10.0), (0, 1.0)] == client.ts().revrange(
         1, 0, 10, aggregation_type="count", bucket_size_msec=10, align=1
     )
+    assert [(10, 3.0), (0, 2.5500000000000003)] == client.ts().revrange(
+        1, 0, 10, aggregation_type="twa", bucket_size_msec=10
+    )
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("1.8.0", "timeseries")
+def test_revrange_latest(client: redis.Redis):
+    timeseries = client.ts()
+    timeseries.create("t1")
+    timeseries.create("t2")
+    timeseries.createrule("t1", "t2", aggregation_type="sum", bucket_size_msec=10)
+    timeseries.add("t1", 1, 1)
+    timeseries.add("t1", 2, 3)
+    timeseries.add("t1", 11, 7)
+    timeseries.add("t1", 13, 1)
+    res = timeseries.revrange("t2", 0, 10)
+    assert res == [(0, 4.0)]
+    res = timeseries.revrange("t2", 0, 10, latest=True)
+    assert res == [(10, 8.0), (0, 4.0)]
+    res = timeseries.revrange("t2", 0, 9, latest=True)
+    assert res == [(0, 4.0)]
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("1.8.0", "timeseries")
+def test_revrange_bucket_timestamp(client: redis.Redis):
+    timeseries = client.ts()
+    timeseries.create("t1")
+    timeseries.add("t1", 15, 1)
+    timeseries.add("t1", 17, 4)
+    timeseries.add("t1", 51, 3)
+    timeseries.add("t1", 73, 5)
+    timeseries.add("t1", 75, 3)
+    assert [(70, 5.0), (50, 3.0), (10, 4.0)] == timeseries.revrange(
+        "t1", 0, 100, align=0, aggregation_type="max", bucket_size_msec=10
+    )
+    assert [(20, 4.0), (60, 3.0), (80, 5.0)] == timeseries.range(
+        "t1",
+        0,
+        100,
+        align=0,
+        aggregation_type="max",
+        bucket_size_msec=10,
+        bucket_timestamp="+",
+    )
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("1.8.0", "timeseries")
+def test_revrange_empty(client: redis.Redis):
+    timeseries = client.ts()
+    timeseries.create("t1")
+    timeseries.add("t1", 15, 1)
+    timeseries.add("t1", 17, 4)
+    timeseries.add("t1", 51, 3)
+    timeseries.add("t1", 73, 5)
+    timeseries.add("t1", 75, 3)
+    assert [(70, 5.0), (50, 3.0), (10, 4.0)] == timeseries.revrange(
+        "t1", 0, 100, align=0, aggregation_type="max", bucket_size_msec=10
+    )
+    res = timeseries.revrange(
+        "t1", 0, 100, align=0, aggregation_type="max", bucket_size_msec=10, empty=True
+    )
+    for i in range(len(res)):
+        if math.isnan(res[i][1]):
+            res[i] = (res[i][0], None)
+    assert [
+        (70, 5.0),
+        (60, None),
+        (50, 3.0),
+        (40, None),
+        (30, None),
+        (20, None),
+        (10, 4.0),
+    ] == res
 
 
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
-def testMultiRange(client):
+def test_mrange(client):
     client.ts().create(1, labels={"Test": "This", "team": "ny"})
     client.ts().create(2, labels={"Test": "This", "Taste": "That", "team": "sf"})
     for i in range(100):
@@ -351,6 +508,31 @@ def test_multi_range_advanced(client):
     assert [(0, 5.0), (5, 6.0)] == res[0]["1"][1]
 
 
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+@skip_ifmodversion_lt("1.8.0", "timeseries")
+def test_mrange_latest(client: redis.Redis):
+    timeseries = client.ts()
+    timeseries.create("t1")
+    timeseries.create("t2", labels={"is_compaction": "true"})
+    timeseries.create("t3")
+    timeseries.create("t4", labels={"is_compaction": "true"})
+    timeseries.createrule("t1", "t2", aggregation_type="sum", bucket_size_msec=10)
+    timeseries.createrule("t3", "t4", aggregation_type="sum", bucket_size_msec=10)
+    timeseries.add("t1", 1, 1)
+    timeseries.add("t1", 2, 3)
+    timeseries.add("t1", 11, 7)
+    timeseries.add("t1", 13, 1)
+    timeseries.add("t3", 1, 1)
+    timeseries.add("t3", 2, 3)
+    timeseries.add("t3", 11, 7)
+    timeseries.add("t3", 13, 1)
+    assert client.ts().mrange(0, 10, filters=["is_compaction=true"], latest=True) == [
+        {"t2": [{}, [(0, 4.0), (10, 8.0)]]},
+        {"t4": [{}, [(0, 4.0), (10, 8.0)]]},
+    ]
+
+
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("99.99.99", "timeseries")
@@ -434,6 +616,30 @@ def test_multi_reverse_range(client):
     assert [(1, 10.0), (0, 1.0)] == res[0]["1"][1]
 
 
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+@skip_ifmodversion_lt("1.8.0", "timeseries")
+def test_mrevrange_latest(client: redis.Redis):
+    timeseries = client.ts()
+    timeseries.create("t1")
+    timeseries.create("t2", labels={"is_compaction": "true"})
+    timeseries.create("t3")
+    timeseries.create("t4", labels={"is_compaction": "true"})
+    timeseries.createrule("t1", "t2", aggregation_type="sum", bucket_size_msec=10)
+    timeseries.createrule("t3", "t4", aggregation_type="sum", bucket_size_msec=10)
+    timeseries.add("t1", 1, 1)
+    timeseries.add("t1", 2, 3)
+    timeseries.add("t1", 11, 7)
+    timeseries.add("t1", 13, 1)
+    timeseries.add("t3", 1, 1)
+    timeseries.add("t3", 2, 3)
+    timeseries.add("t3", 11, 7)
+    timeseries.add("t3", 13, 1)
+    assert client.ts().mrevrange(
+        0, 10, filters=["is_compaction=true"], latest=True
+    ) == [{"t2": [{}, [(10, 8.0), (0, 4.0)]]}, {"t4": [{}, [(10, 8.0), (0, 4.0)]]}]
+
+
 @pytest.mark.redismod
 def test_get(client):
     name = "test"
@@ -445,6 +651,21 @@ def test_get(client):
     assert 4 == client.ts().get(name)[1]
 
 
+@pytest.mark.redismod
+@skip_ifmodversion_lt("1.8.0", "timeseries")
+def test_get_latest(client: redis.Redis):
+    timeseries = client.ts()
+    timeseries.create("t1")
+    timeseries.create("t2")
+    timeseries.createrule("t1", "t2", aggregation_type="sum", bucket_size_msec=10)
+    timeseries.add("t1", 1, 1)
+    timeseries.add("t1", 2, 3)
+    timeseries.add("t1", 11, 7)
+    timeseries.add("t1", 13, 1)
+    assert (0, 4.0) == timeseries.get("t2")
+    assert (10, 8.0) == timeseries.get("t2", latest=True)
+
+
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
 def test_mget(client):
@@ -467,6 +688,24 @@ def test_mget(client):
     assert {"Taste": "That", "Test": "This"} == res[0]["2"][0]
 
 
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+@skip_ifmodversion_lt("1.8.0", "timeseries")
+def test_mget_latest(client: redis.Redis):
+    timeseries = client.ts()
+    timeseries.create("t1")
+    timeseries.create("t2", labels={"is_compaction": "true"})
+    timeseries.createrule("t1", "t2", aggregation_type="sum", bucket_size_msec=10)
+    timeseries.add("t1", 1, 1)
+    timeseries.add("t1", 2, 3)
+    timeseries.add("t1", 11, 7)
+    timeseries.add("t1", 13, 1)
+    assert timeseries.mget(filters=["is_compaction=true"]) == [{"t2": [{}, 0, 4.0]}]
+    assert [{"t2": [{}, 10, 8.0]}] == timeseries.mget(
+        filters=["is_compaction=true"], latest=True
+    )
+
+
 @pytest.mark.redismod
 def test_info(client):
     client.ts().create(1, retention_msecs=5, labels={"currentLabel": "currentData"})
@@ -506,7 +745,7 @@ def test_pipeline(client):
     pipeline.execute()
 
     info = client.ts().info("with_pipeline")
-    assert info.lastTimeStamp == 99
+    assert info.last_timestamp == 99
     assert info.total_samples == 100
     assert client.ts().get("with_pipeline")[1] == 99 * 1.1
 

From c70845d9783d66e48074fa3ebb7157bb52f11704 Mon Sep 17 00:00:00 2001
From: Nial Daly <34862917+nialdaly@users.noreply.github.com>
Date: Sun, 24 Jul 2022 14:31:23 +0100
Subject: [PATCH 0538/1164] Remove verbose logging from
 `redis-py/redis/cluster.py` (#2238)

* removed the logging module and its corresponding methods

* updated CHANGES

* except block for RedisClusterException and BusyLoadingError removed

* removed unused import (redis.exceptions.BusyLoadingError)

* empty commit to re-trigger Actions workflow

* replaced BaseException with Exception

* empty commit to re-trigger Actions workflow

* empty commit to re-trigger Actions workflow

* redundant logic removed

* re-trigger pipeline

* reverted changes

* re-trigger pipeline

* except logic changed
---
 CHANGES          |  2 +-
 redis/cluster.py | 63 ++++++------------------------------------------
 2 files changed, 8 insertions(+), 57 deletions(-)

diff --git a/CHANGES b/CHANGES
index b4841ddb2b..6a890ef122 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,4 +1,4 @@
-
+    * Remove verbose logging from cluster.py
     * Add retry mechanism to async version of Connection
     * Compare commands case-insensitively in the asyncio command parser
     * Allow negative `retries` for `Retry` class to retry forever
diff --git a/redis/cluster.py b/redis/cluster.py
index 9e773b2190..b2d4f3b044 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -1,5 +1,4 @@
 import copy
-import logging
 import random
 import socket
 import sys
@@ -15,7 +14,6 @@
 from redis.exceptions import (
     AskError,
     AuthenticationError,
-    BusyLoadingError,
     ClusterCrossSlotError,
     ClusterDownError,
     ClusterError,
@@ -39,8 +37,6 @@
     str_if_bytes,
 )
 
-log = logging.getLogger(__name__)
-
 
 def get_node_name(host: str, port: int) -> str:
     return f"{host}:{port}"
@@ -535,7 +531,6 @@ def __init__(
                 " RedisCluster(startup_nodes=[ClusterNode('localhost', 6379),"
                 " ClusterNode('localhost', 6378)])"
             )
-        log.debug(f"startup_nodes : {startup_nodes}")
         # Update the connection arguments
         # Whenever a new connection is established, RedisCluster's on_connect
         # method should be run
@@ -666,13 +661,8 @@ def set_default_node(self, node):
         :return True if the default node was set, else False
         """
         if node is None or self.get_node(node_name=node.name) is None:
-            log.info(
-                "The requested node does not exist in the cluster, so "
-                "the default node was not changed."
-            )
             return False
         self.nodes_manager.default_node = node
-        log.info(f"Changed the default cluster node to {node}")
         return True
 
     def monitor(self, target_node=None):
@@ -816,8 +806,6 @@ def _determine_nodes(self, *args, **kwargs):
         else:
             # get the nodes group for this command if it was predefined
             command_flag = self.command_flags.get(command)
-        if command_flag:
-            log.debug(f"Target node/s for {command}: {command_flag}")
         if command_flag == self.__class__.RANDOM:
             # return a random node
             return [self.get_random_node()]
@@ -841,7 +829,6 @@ def _determine_nodes(self, *args, **kwargs):
             node = self.nodes_manager.get_node_from_slot(
                 slot, self.read_from_replicas and command in READ_COMMANDS
             )
-            log.debug(f"Target for {args}: slot {slot}")
             return [node]
 
     def _should_reinitialized(self):
@@ -1019,7 +1006,7 @@ def execute_command(self, *args, **kwargs):
                     res[node.name] = self._execute_command(node, *args, **kwargs)
                 # Return the processed result
                 return self._process_result(args[0], res, **kwargs)
-            except BaseException as e:
+            except Exception as e:
                 if type(e) in self.__class__.ERRORS_ALLOW_RETRY:
                     # The nodes and slots cache were reinitialized.
                     # Try again with the new cluster setup.
@@ -1059,10 +1046,6 @@ def _execute_command(self, target_node, *args, **kwargs):
                     )
                     moved = False
 
-                log.debug(
-                    f"Executing command {command} on target node: "
-                    f"{target_node.server_type} {target_node.name}"
-                )
                 redis_node = self.get_redis_connection(target_node)
                 connection = get_connection(redis_node, *args, **kwargs)
                 if asking:
@@ -1077,12 +1060,9 @@ def _execute_command(self, target_node, *args, **kwargs):
                         response, **kwargs
                     )
                 return response
-
-            except (RedisClusterException, BusyLoadingError, AuthenticationError) as e:
-                log.exception(type(e))
+            except AuthenticationError:
                 raise
             except (ConnectionError, TimeoutError) as e:
-                log.exception(type(e))
                 # ConnectionError can also be raised if we couldn't get a
                 # connection from the pool before timing out, so check that
                 # this is an actual connection before attempting to disconnect.
@@ -1101,7 +1081,7 @@ def _execute_command(self, target_node, *args, **kwargs):
                     # and try again with the new setup
                     target_node.redis_connection = None
                     self.nodes_manager.initialize()
-                    raise
+                    raise e
             except MovedError as e:
                 # First, we will try to patch the slots/nodes cache with the
                 # redirected node output and try again. If MovedError exceeds
@@ -1111,7 +1091,6 @@ def _execute_command(self, target_node, *args, **kwargs):
                 # the same client object is shared between multiple threads. To
                 # reduce the frequency you can set this variable in the
                 # RedisCluster constructor.
-                log.exception("MovedError")
                 self.reinitialize_counter += 1
                 if self._should_reinitialized():
                     self.nodes_manager.initialize()
@@ -1121,29 +1100,21 @@ def _execute_command(self, target_node, *args, **kwargs):
                     self.nodes_manager.update_moved_exception(e)
                 moved = True
             except TryAgainError:
-                log.exception("TryAgainError")
-
                 if ttl < self.RedisClusterRequestTTL / 2:
                     time.sleep(0.05)
             except AskError as e:
-                log.exception("AskError")
-
                 redirect_addr = get_node_name(host=e.host, port=e.port)
                 asking = True
             except ClusterDownError as e:
-                log.exception("ClusterDownError")
                 # ClusterDownError can occur during a failover and to get
                 # self-healed, we will try to reinitialize the cluster layout
                 # and retry executing the command
                 time.sleep(0.25)
                 self.nodes_manager.initialize()
                 raise e
-            except ResponseError as e:
-                message = e.__str__()
-                log.exception(f"ResponseError: {message}")
-                raise e
-            except BaseException as e:
-                log.exception("BaseException")
+            except ResponseError:
+                raise
+            except Exception as e:
                 if connection:
                     connection.disconnect()
                 raise e
@@ -1280,11 +1251,6 @@ def get_node(self, host=None, port=None, node_name=None):
         elif node_name:
             return self.nodes_cache.get(node_name)
         else:
-            log.error(
-                "get_node requires one of the following: "
-                "1. node name "
-                "2. host and port"
-            )
             return None
 
     def update_moved_exception(self, exception):
@@ -1432,7 +1398,6 @@ def initialize(self):
         :startup_nodes:
             Responsible for discovering other nodes in the cluster
         """
-        log.debug("Initializing the nodes' topology of the cluster")
         self.reset()
         tmp_nodes_cache = {}
         tmp_slots = {}
@@ -1460,17 +1425,9 @@ def initialize(self):
                     )
                 cluster_slots = str_if_bytes(r.execute_command("CLUSTER SLOTS"))
                 startup_nodes_reachable = True
-            except (ConnectionError, TimeoutError) as e:
-                msg = e.__str__
-                log.exception(
-                    "An exception occurred while trying to"
-                    " initialize the cluster using the seed node"
-                    f" {startup_node.name}:\n{msg}"
-                )
+            except (ConnectionError, TimeoutError):
                 continue
             except ResponseError as e:
-                log.exception('ReseponseError sending "cluster slots" to redis server')
-
                 # Isn't a cluster connection, so it won't parse these
                 # exceptions automatically
                 message = e.__str__()
@@ -2042,12 +1999,6 @@ def _send_cluster_commands(
             # If a lot of commands have failed, we'll be setting the
             # flag to rebuild the slots table from scratch.
             # So MOVED errors should correct themselves fairly quickly.
-            log.exception(
-                f"An exception occurred during pipeline execution. "
-                f"args: {attempt[-1].args}, "
-                f"error: {type(attempt[-1].result).__name__} "
-                f"{str(attempt[-1].result)}"
-            )
             self.reinitialize_counter += 1
             if self._should_reinitialized():
                 self.nodes_manager.initialize()

From a8c8227b0cddab6ae77fecbd935f327b30628b32 Mon Sep 17 00:00:00 2001
From: pedrofrazao <603718+pedrofrazao@users.noreply.github.com>
Date: Sun, 24 Jul 2022 14:32:11 +0100
Subject: [PATCH 0539/1164] redis stream example (#2269)

* redis stream example

* redis stream example on docs/examples.rst

Co-authored-by: pedro.frazao <perl.pf@netcf.org>
---
 docs/examples.rst                        |   1 +
 docs/examples/redis-stream-example.ipynb | 754 +++++++++++++++++++++++
 2 files changed, 755 insertions(+)
 create mode 100644 docs/examples/redis-stream-example.ipynb

diff --git a/docs/examples.rst b/docs/examples.rst
index 722fae2d03..08526ff614 100644
--- a/docs/examples.rst
+++ b/docs/examples.rst
@@ -12,3 +12,4 @@ Examples
    examples/set_and_get_examples
    examples/search_vector_similarity_examples
    examples/pipeline_examples
+   examples/redis-stream-example.ipynb
diff --git a/docs/examples/redis-stream-example.ipynb b/docs/examples/redis-stream-example.ipynb
new file mode 100644
index 0000000000..9303b527ca
--- /dev/null
+++ b/docs/examples/redis-stream-example.ipynb
@@ -0,0 +1,754 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Redis Stream Examples"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## basic config"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "redis_host = \"redis\"\n",
+    "stream_key = \"skey\"\n",
+    "stream2_key = \"s2key\"\n",
+    "group1 = \"grp1\"\n",
+    "group2 = \"grp2\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## connection"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 2,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "import redis\n",
+    "from time import time\n",
+    "from redis.exceptions import ConnectionError, DataError, NoScriptError, RedisError, ResponseError\n",
+    "\n",
+    "r = redis.Redis( redis_host )\n",
+    "r.ping()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## xadd and xread"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### add some data to the stream"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "stream length: 10\n"
+     ]
+    }
+   ],
+   "source": [
+    "for i in range(0,10):\n",
+    "    r.xadd( stream_key, { 'ts': time(), 'v': i } )\n",
+    "print( f\"stream length: {r.xlen( stream_key )}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### read some data from the stream"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[[b'skey', [(b'1657571033115-0', {b'ts': b'1657571033.1128936', b'v': b'0'}), (b'1657571033117-0', {b'ts': b'1657571033.1176307', b'v': b'1'})]]]\n"
+     ]
+    }
+   ],
+   "source": [
+    "## read 2 entries from stream_key\n",
+    "l = r.xread( count=2, streams={stream_key:0} )\n",
+    "print(l)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### extract data from the returned structure"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "got data from stream: b'skey'\n",
+      "id: b'1657571033115-0' value: b'0'\n",
+      "id: b'1657571033117-0' value: b'1'\n"
+     ]
+    }
+   ],
+   "source": [
+    "first_stream = l[0]\n",
+    "print( f\"got data from stream: {first_stream[0]}\")\n",
+    "fs_data = first_stream[1]\n",
+    "for id, value in fs_data:\n",
+    "    print( f\"id: {id} value: {value[b'v']}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### read more data from the stream\n",
+    "if we call the `xread` with the same arguments we will get the same data"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "id: b'1657571033115-0' value: b'0'\n",
+      "id: b'1657571033117-0' value: b'1'\n"
+     ]
+    }
+   ],
+   "source": [
+    "l = r.xread( count=2, streams={stream_key:0} )\n",
+    "for id, value in l[0][1]:\n",
+    "    print( f\"id: {id} value: {value[b'v']}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "to get new data we need to change the key passed to the call"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "id: b'1657571033118-0' value: b'2'\n",
+      "id: b'1657571033119-0' value: b'3'\n"
+     ]
+    }
+   ],
+   "source": [
+    "last_id_returned = l[0][1][-1][0]\n",
+    "l = r.xread( count=2, streams={stream_key: last_id_returned} )\n",
+    "for id, value in l[0][1]:\n",
+    "    print( f\"id: {id} value: {value[b'v']}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "id: b'1657571033119-1' value: b'4'\n",
+      "id: b'1657571033121-0' value: b'5'\n"
+     ]
+    }
+   ],
+   "source": [
+    "last_id_returned = l[0][1][-1][0]\n",
+    "l = r.xread( count=2, streams={stream_key: last_id_returned} )\n",
+    "for id, value in l[0][1]:\n",
+    "    print( f\"id: {id} value: {value[b'v']}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "to get only newer entries"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "stream length: 10\n",
+      "after 5s block, got an empty list [], no *new* messages on the stream\n",
+      "stream length: 10\n"
+     ]
+    }
+   ],
+   "source": [
+    "print( f\"stream length: {r.xlen( stream_key )}\")\n",
+    "# wait for 5s for new messages\n",
+    "l = r.xread( count=1, block=5000, streams={stream_key: '$'} )\n",
+    "print( f\"after 5s block, got an empty list {l}, no *new* messages on the stream\")\n",
+    "print( f\"stream length: {r.xlen( stream_key )}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### 2nd stream\n",
+    "Add some messages to a 2nd stream"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "stream length: 10\n"
+     ]
+    }
+   ],
+   "source": [
+    "for i in range(1000,1010):\n",
+    "    r.xadd( stream2_key, { 'v': i } )\n",
+    "print( f\"stream length: {r.xlen( stream2_key )}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "get messages from the 2 streams"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "got from b'skey' the entry [(b'1657571033115-0', {b'ts': b'1657571033.1128936', b'v': b'0'})]\n",
+      "got from b's2key' the entry [(b'1657571042111-0', {b'v': b'1000'})]\n"
+     ]
+    }
+   ],
+   "source": [
+    "l = r.xread( count=1, streams={stream_key:0,stream2_key:0} )\n",
+    "for k,d in l:\n",
+    "    print(f\"got from {k} the entry {d}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# stream groups\n",
+    "With the groups is possible track, for many consumers, and at the Redis side, which message have been already consumed.\n",
+    "## add some data to streams\n",
+    "Creating 2 streams with 10 messages each."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "stream 'skey' length: 20\n",
+      "stream 's2key' length: 20\n"
+     ]
+    }
+   ],
+   "source": [
+    "def add_some_data_to_stream( sname, key_range ):\n",
+    "    for i in key_range:\n",
+    "        r.xadd( sname, { 'ts': time(), 'v': i } )\n",
+    "    print( f\"stream '{sname}' length: {r.xlen( stream_key )}\")\n",
+    "\n",
+    "add_some_data_to_stream( stream_key, range(0,10) )\n",
+    "add_some_data_to_stream( stream2_key, range(1000,1010) )"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## use a group to read from the stream\n",
+    "* create a group `grp1` with the stream `skey`, and\n",
+    "* create a group `grp2` with the streams `skey` and `s2key`\n",
+    "\n",
+    "Use the `xinfo_group` to verify the result of the group creation."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "skey -> group name: b'grp1' with 0 consumers and b'0-0' as last read id\n",
+      "skey -> group name: b'grp2' with 0 consumers and b'0-0' as last read id\n",
+      "s2key -> group name: b'grp2' with 0 consumers and b'0-0' as last read id\n"
+     ]
+    }
+   ],
+   "source": [
+    "## create the group\n",
+    "def create_group( skey, gname ):\n",
+    "    try:\n",
+    "        r.xgroup_create( name=skey, groupname=gname, id=0 )\n",
+    "    except ResponseError as e:\n",
+    "        print(f\"raised: {e}\")\n",
+    "\n",
+    "# group1 read the stream 'skey'\n",
+    "create_group( stream_key, group1 )\n",
+    "# group2 read the streams 'skey' and 's2key'\n",
+    "create_group( stream_key, group2 )\n",
+    "create_group( stream2_key, group2 )\n",
+    "\n",
+    "def group_info( skey ):\n",
+    "    res = r.xinfo_groups( name=skey )\n",
+    "    for i in res:\n",
+    "        print( f\"{skey} -> group name: {i['name']} with {i['consumers']} consumers and {i['last-delivered-id']}\"\n",
+    "              + f\" as last read id\")\n",
+    "    \n",
+    "group_info( stream_key )\n",
+    "group_info( stream2_key )"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## group read\n",
+    "The `xreadgroup` method permit to read from a stream group."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def print_xreadgroup_reply( reply, group = None, run = None):\n",
+    "    for d_stream in reply:\n",
+    "        for element in d_stream[1]:\n",
+    "            print(  f\"got element {element[0]}\"\n",
+    "                  + f\"from stream {d_stream[0]}\" )\n",
+    "            if run is not None:\n",
+    "                run( d_stream[0], group, element[0] )"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "got element b'1657571033115-0'from stream b'skey'\n",
+      "got element b'1657571033117-0'from stream b'skey'\n"
+     ]
+    }
+   ],
+   "source": [
+    "# read some messages on group1 with consumer 'c' \n",
+    "d = r.xreadgroup( groupname=group1, consumername='c', block=10,\n",
+    "                  count=2, streams={stream_key:'>'})\n",
+    "print_xreadgroup_reply( d )"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "A **2nd consumer** for the same stream group will get not delivered messages."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "got element b'1657571033118-0'from stream b'skey'\n",
+      "got element b'1657571033119-0'from stream b'skey'\n"
+     ]
+    }
+   ],
+   "source": [
+    "# read some messages on group1 with consumer 'c' \n",
+    "d = r.xreadgroup( groupname=group1, consumername='c2', block=10,\n",
+    "                  count=2, streams={stream_key:'>'})\n",
+    "print_xreadgroup_reply( d )"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "But a **2nd stream group** can read the already delivered messages again.\n",
+    "\n",
+    "Note that the 2nd stream group include also the 2nd stream.\n",
+    "That can be identified in the reply (1st element of the reply list)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "got element b'1657571033115-0'from stream b'skey'\n",
+      "got element b'1657571033117-0'from stream b'skey'\n",
+      "got element b'1657571042111-0'from stream b's2key'\n",
+      "got element b'1657571042113-0'from stream b's2key'\n"
+     ]
+    }
+   ],
+   "source": [
+    "d2 = r.xreadgroup( groupname=group2, consumername='c', block=10,\n",
+    "                   count=2, streams={stream_key:'>',stream2_key:'>'})\n",
+    "print_xreadgroup_reply( d2 )"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "To check for pending messages (delivered messages without acknowledgment) we can use the `xpending`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 19,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "4 pending messages on 'skey' for group 'grp1'\n",
+      "2 pending messages on 'skey' for group 'grp2'\n",
+      "2 pending messages on 's2key' for group 'grp2'\n"
+     ]
+    }
+   ],
+   "source": [
+    "# check pending status (read messages without a ack)\n",
+    "def print_pending_info( key_group ):\n",
+    "    for s,k in key_group:\n",
+    "        pr = r.xpending( name=s, groupname=k )\n",
+    "        print( f\"{pr.get('pending')} pending messages on '{s}' for group '{k}'\" )\n",
+    "    \n",
+    "print_pending_info( ((stream_key,group1),(stream_key,group2),(stream2_key,group2)) )"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## ack\n",
+    "Acknowledge some messages with `xack`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "got element b'1657571033118-0'from stream b'skey'\n",
+      "got element b'1657571033119-0'from stream b'skey'\n"
+     ]
+    }
+   ],
+   "source": [
+    "# do acknowledges for group1\n",
+    "toack = lambda k,g,e: r.xack( k,g, e )\n",
+    "print_xreadgroup_reply( d, group=group1, run=toack )"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 21,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "2 pending messages on 'skey' for group 'grp1'\n",
+      "2 pending messages on 'skey' for group 'grp2'\n",
+      "2 pending messages on 's2key' for group 'grp2'\n"
+     ]
+    }
+   ],
+   "source": [
+    "# check pending again\n",
+    "print_pending_info( ((stream_key,group1),(stream_key,group2),(stream2_key,group2)) )"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "ack all messages on the `group1`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 22,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "got element b'1657571033119-1'from stream b'skey'\n",
+      "got element b'1657571033121-0'from stream b'skey'\n",
+      "got element b'1657571033121-1'from stream b'skey'\n",
+      "got element b'1657571033121-2'from stream b'skey'\n",
+      "got element b'1657571033122-0'from stream b'skey'\n",
+      "got element b'1657571033122-1'from stream b'skey'\n",
+      "got element b'1657571049557-0'from stream b'skey'\n",
+      "got element b'1657571049557-1'from stream b'skey'\n",
+      "got element b'1657571049558-0'from stream b'skey'\n",
+      "got element b'1657571049559-0'from stream b'skey'\n",
+      "got element b'1657571049559-1'from stream b'skey'\n",
+      "got element b'1657571049559-2'from stream b'skey'\n",
+      "got element b'1657571049560-0'from stream b'skey'\n",
+      "got element b'1657571049562-0'from stream b'skey'\n",
+      "got element b'1657571049563-0'from stream b'skey'\n",
+      "got element b'1657571049563-1'from stream b'skey'\n",
+      "2 pending messages on 'skey' for group 'grp1'\n"
+     ]
+    }
+   ],
+   "source": [
+    "d = r.xreadgroup( groupname=group1, consumername='c', block=10,\n",
+    "                      count=100, streams={stream_key:'>'})\n",
+    "print_xreadgroup_reply( d, group=group1, run=toack)\n",
+    "print_pending_info( ((stream_key,group1),) )"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "But stream length will be the same after the `xack` of all messages on the `group1`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 24,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "20"
+      ]
+     },
+     "execution_count": 24,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "r.xlen(stream_key)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## delete all\n",
+    "To remove the messages with need to remote them explicitly with `xdel`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 25,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "s1 = r.xread( streams={stream_key:0} )\n",
+    "for streams in s1:\n",
+    "    stream_name, messages = streams\n",
+    "    # del all ids from the message list\n",
+    "    [ r.xdel( stream_name, i[0] ) for i in messages ]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "stream length"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 26,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "0"
+      ]
+     },
+     "execution_count": 26,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "r.xlen(stream_key)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "But with the `xdel` the 2nd group can read any not processed message from the `skey`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 27,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "got element b'1657571042113-1'from stream b's2key'\n",
+      "got element b'1657571042114-0'from stream b's2key'\n"
+     ]
+    }
+   ],
+   "source": [
+    "d2 = r.xreadgroup( groupname=group2, consumername='c', block=10,\n",
+    "                   count=2, streams={stream_key:'>',stream2_key:'>'})\n",
+    "print_xreadgroup_reply( d2 )"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.8.10"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}

From 99b4df4af565bbf05f8aafbdf4d65d768416c250 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=90=D0=BD=D1=82=D0=BE=D0=BD=20=D0=91=D0=B5=D0=B7=D0=B4?=
 =?UTF-8?q?=D0=B5=D0=BD=D0=B5=D0=B6=D0=BD=D1=8B=D1=85?= <gamer392@yandex.ru>
Date: Sun, 24 Jul 2022 20:40:50 +0500
Subject: [PATCH 0540/1164] Fix: `start_id` type for `XAUTOCLAIM` (#2257)

* Changed start_id type for xautoclaim

* Added to changes

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 CHANGES                | 1 +
 redis/commands/core.py | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/CHANGES b/CHANGES
index 6a890ef122..2abf62766f 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Fix start_id type for XAUTOCLAIM
     * Remove verbose logging from cluster.py
     * Add retry mechanism to async version of Connection
     * Compare commands case-insensitively in the asyncio command parser
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 027d3dbc7c..455c3f46cb 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3420,7 +3420,7 @@ def xautoclaim(
         groupname: GroupT,
         consumername: ConsumerT,
         min_idle_time: int,
-        start_id: int = 0,
+        start_id: StreamIdT = "0-0",
         count: Union[int, None] = None,
         justid: bool = False,
     ) -> ResponseT:

From 1df1d32bb6845d2ccbbc340199babe9fe0ef29d6 Mon Sep 17 00:00:00 2001
From: Iglesys <g.imbert34@gmail.com>
Date: Mon, 25 Jul 2022 13:13:39 +0200
Subject: [PATCH 0541/1164] Doc add timeseries example (#2267)

* DOC add timeseries example

* DOC add timeseries examples

* Apply suggestions

* Fix typo

Detention period => Retention period

Co-authored-by: Gauthier Imbert <gauthier@PC17>
---
 docs/examples.rst                       |   1 +
 docs/examples/timeseries_examples.ipynb | 631 ++++++++++++++++++++++++
 2 files changed, 632 insertions(+)
 create mode 100644 docs/examples/timeseries_examples.ipynb

diff --git a/docs/examples.rst b/docs/examples.rst
index 08526ff614..3fed8b4195 100644
--- a/docs/examples.rst
+++ b/docs/examples.rst
@@ -12,4 +12,5 @@ Examples
    examples/set_and_get_examples
    examples/search_vector_similarity_examples
    examples/pipeline_examples
+   examples/timeseries_examples
    examples/redis-stream-example.ipynb
diff --git a/docs/examples/timeseries_examples.ipynb b/docs/examples/timeseries_examples.ipynb
new file mode 100644
index 0000000000..fefc0c8f37
--- /dev/null
+++ b/docs/examples/timeseries_examples.ipynb
@@ -0,0 +1,631 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Timeseries\n",
+    "\n",
+    "`redis-py` supports [RedisTimeSeries](https://github.com/RedisTimeSeries/RedisTimeSeries/) which is a time-series-database module for Redis.\n",
+    "\n",
+    "This example shows how to handle timeseries data with `redis-py`."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Health check"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 1,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "import redis \n",
+    "\n",
+    "r = redis.Redis(decode_responses=True)\n",
+    "ts = r.ts()\n",
+    "\n",
+    "r.ping()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Simple example"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Create a timeseries"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 2,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "ts.create(\"ts_key\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Add samples to the timeseries\n",
+    "\n",
+    "We can either set the timestamp with an UNIX timestamp in milliseconds or use * to set the timestamp based en server's clock."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "1657272304448"
+      ]
+     },
+     "execution_count": 3,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "ts.add(\"ts_key\", 1657265437756, 1)\n",
+    "ts.add(\"ts_key\", \"1657265437757\", 2)\n",
+    "ts.add(\"ts_key\", \"*\", 3)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Get the last sample"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "(1657272304448, 3.0)"
+      ]
+     },
+     "execution_count": 4,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "ts.get(\"ts_key\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Get samples between two timestamps\n",
+    "\n",
+    "The minimum and maximum possible timestamps can be expressed with respectfully - and +."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[(1657265437756, 1.0), (1657265437757, 2.0), (1657272304448, 3.0)]"
+      ]
+     },
+     "execution_count": 5,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "ts.range(\"ts_key\", \"-\", \"+\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[(1657265437756, 1.0), (1657265437757, 2.0)]"
+      ]
+     },
+     "execution_count": 6,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "ts.range(\"ts_key\", 1657265437756, 1657265437757)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Delete samples between two timestamps"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Before deletion:  [(1657265437756, 1.0), (1657265437757, 2.0), (1657272304448, 3.0)]\n",
+      "After deletion:   [(1657272304448, 3.0)]\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(\"Before deletion: \", ts.range(\"ts_key\", \"-\", \"+\"))\n",
+    "ts.delete(\"ts_key\", 1657265437756, 1657265437757)\n",
+    "print(\"After deletion:  \", ts.range(\"ts_key\", \"-\", \"+\"))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Multiple timeseries with labels"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 8,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "ts.create(\"ts_key1\")\n",
+    "ts.create(\"ts_key2\", labels={\"label1\": 1, \"label2\": 2})"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Add samples to multiple timeseries"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[1657272306147, 1657272306147]"
+      ]
+     },
+     "execution_count": 9,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "ts.madd([(\"ts_key1\", \"*\", 1), (\"ts_key2\", \"*\", 2)])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Add samples with labels"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "1657272306457"
+      ]
+     },
+     "execution_count": 10,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "ts.add(\"ts_key2\", \"*\", 2,  labels={\"label1\": 1, \"label2\": 2})\n",
+    "ts.add(\"ts_key2\", \"*\", 2,  labels={\"label1\": 3, \"label2\": 4})"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Get the last sample matching specific label\n",
+    "\n",
+    "Get the last sample that matches \"label1=1\", see [Redis documentation](https://redis.io/commands/ts.mget/) to see the posible filter values."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[{'ts_key2': [{}, 1657272306457, 2.0]}]"
+      ]
+     },
+     "execution_count": 11,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "ts.mget([\"label1=1\"])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Get also the label-value pairs of the sample:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[{'ts_key2': [{'label1': '1', 'label2': '2'}, 1657272306457, 2.0]}]"
+      ]
+     },
+     "execution_count": 12,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "ts.mget([\"label1=1\"], with_labels=True)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Retention period\n",
+    "\n",
+    "You can specify a retention period when creating timeseries objects or when adding a sample timeseries object. Once the retention period has elapsed, the sample is removed from the timeseries."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 13,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "retention_time = 1000\n",
+    "ts.create(\"ts_key_ret\", retention_msecs=retention_time)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Base timeseries:                      [(1657272307670, 1.0)]\n",
+      "Timeseries after 1000 milliseconds:   [(1657272307670, 1.0)]\n"
+     ]
+    }
+   ],
+   "source": [
+    "import time\n",
+    "# this will be deleted in 1000 milliseconds\n",
+    "ts.add(\"ts_key_ret\", \"*\", 1, retention_msecs=retention_time)\n",
+    "print(\"Base timeseries:                     \", ts.range(\"ts_key_ret\", \"-\", \"+\"))\n",
+    "# sleeping for 1000 milliseconds (1 second)\n",
+    "time.sleep(1)\n",
+    "print(\"Timeseries after 1000 milliseconds:  \", ts.range(\"ts_key_ret\", \"-\", \"+\"))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The two lists are the same, this is because the oldest values are deleted when a new sample is added."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "1657272308849"
+      ]
+     },
+     "execution_count": 15,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "ts.add(\"ts_key_ret\", \"*\", 10)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[(1657272308849, 10.0)]"
+      ]
+     },
+     "execution_count": 16,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "ts.range(\"ts_key_ret\", \"-\", \"+\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Here the first sample has been deleted."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Specify duplicate policies\n",
+    "\n",
+    "By default, the policy for duplicates timestamp keys is set to \"BLOCK\", we cannot create two samples with the same timestamp:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "TSDB: Error at upsert, update is not supported when DUPLICATE_POLICY is set to BLOCK mode\n"
+     ]
+    }
+   ],
+   "source": [
+    "ts.add(\"ts_key\", 123456789, 1)\n",
+    "try:\n",
+    "    ts.add(\"ts_key\", 123456789, 2)\n",
+    "except Exception as err:\n",
+    "    print(err)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "You can change this default behaviour using `duplicate_policy` parameter, for instance:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[(123456789, 2.0), (1657272304448, 3.0)]"
+      ]
+     },
+     "execution_count": 18,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# using policy \"LAST\", we keep the last added sample\n",
+    "ts.add(\"ts_key\", 123456789, 2, duplicate_policy=\"LAST\")\n",
+    "ts.range(\"ts_key\", \"-\", \"+\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "For more informations about duplicate policies, see [Redis documentation](https://redis.io/commands/ts.add/)."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Using Redis TSDB to keep track of a value"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 19,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "1657272310241"
+      ]
+     },
+     "execution_count": 19,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "ts.add(\"ts_key_incr\", \"*\", 0)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Increment the value:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "for _ in range(10):\n",
+    "    ts.incrby(\"ts_key_incr\", 1)\n",
+    "    # sleeping a bit so the timestamp are not duplicates\n",
+    "    time.sleep(0.01)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 21,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[(1657272310241, 0.0),\n",
+       " (1657272310533, 1.0),\n",
+       " (1657272310545, 2.0),\n",
+       " (1657272310556, 3.0),\n",
+       " (1657272310567, 4.0),\n",
+       " (1657272310578, 5.0),\n",
+       " (1657272310589, 6.0),\n",
+       " (1657272310600, 7.0),\n",
+       " (1657272310611, 8.0),\n",
+       " (1657272310622, 9.0),\n",
+       " (1657272310632, 10.0)]"
+      ]
+     },
+     "execution_count": 21,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "ts.range(\"ts_key_incr\", \"-\", \"+\")"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3.9.2 64-bit",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.9.2"
+  },
+  "orig_nbformat": 4,
+  "vscode": {
+   "interpreter": {
+    "hash": "916dbcbb3f70747c44a77c7bcd40155683ae19c65e1c03b4aa3499c5328201f1"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

From 6f208212ed9114921840404591aecca9acd38f08 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Tue, 26 Jul 2022 12:25:23 +0000
Subject: [PATCH 0542/1164] Fix warnings and resource usage problems in asyncio
 unittests (#2258)

* Use pytest-asyncio in auto mode
Remove overly genereric `pytestmark=pytest.mark.asyncio` causing lots of warning noise

* Use "Factories as Fixtures" test pattern for the `create_redis` fixture
this fixture is now async, avoiding teardown problems with missing event loops.

* Fix sporadic error on fast event loops, such as `--uvloop`

* Close connection, even if "username" was in kwargs
This fixes a resource usage warning in the async unittests.

* Do async cleanup of acl passwords via a fixture

* Remove unused import, fix whitespace

* Fix test with missing "await"

* Close pubsub objects after use in unittest
Use a simple fixture where possible, otherwise manually call pubsub.close()

* re-introduce `pytestmark=pytest.mark.asyncio` for python 3.6

* Use context manager to clean up connections in connection pool for unit tests

* Provide asynccontextmanager for python 3.6

* make `test_late_subscribe()` more robuste

* Catch a couple of additional leaked resources
---
 tests/test_asyncio/conftest.py             | 124 ++++++++++------
 tests/test_asyncio/test_bloom.py           |   9 +-
 tests/test_asyncio/test_cluster.py         |   4 +-
 tests/test_asyncio/test_commands.py        | 110 ++++----------
 tests/test_asyncio/test_connection.py      |   4 +-
 tests/test_asyncio/test_connection_pool.py | 160 +++++++++++----------
 tests/test_asyncio/test_encoding.py        |   4 +-
 tests/test_asyncio/test_json.py            |   2 -
 tests/test_asyncio/test_lock.py            |   4 +-
 tests/test_asyncio/test_monitor.py         |   5 +-
 tests/test_asyncio/test_pipeline.py        |   5 +-
 tests/test_asyncio/test_pubsub.py          | 144 +++++++++++--------
 tests/test_asyncio/test_scripting.py       |   2 +
 tests/test_asyncio/test_search.py          |   4 +-
 tests/test_asyncio/test_sentinel.py        |   4 +-
 tests/test_asyncio/test_timeseries.py      |   4 +-
 tests/test_json.py                         |   3 +-
 tests/test_ssl.py                          |   4 +-
 tox.ini                                    |   1 +
 19 files changed, 319 insertions(+), 278 deletions(-)

diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index 8166588d8e..04fbf62cf7 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -1,14 +1,9 @@
-import asyncio
+import functools
 import random
 import sys
 from typing import Union
 from urllib.parse import urlparse
 
-if sys.version_info[0:2] == (3, 6):
-    import pytest as pytest_asyncio
-else:
-    import pytest_asyncio
-
 import pytest
 from packaging.version import Version
 
@@ -26,6 +21,13 @@
 
 from .compat import mock
 
+if sys.version_info[0:2] == (3, 6):
+    import pytest as pytest_asyncio
+
+    pytestmark = pytest.mark.asyncio
+else:
+    import pytest_asyncio
+
 
 async def _get_info(redis_url):
     client = redis.Redis.from_url(redis_url)
@@ -69,11 +71,13 @@ async def _get_info(redis_url):
         "pool-hiredis",
     ],
 )
-def create_redis(request, event_loop: asyncio.BaseEventLoop):
+async def create_redis(request):
     """Wrapper around redis.create_redis."""
     single_connection, parser_cls = request.param
 
-    async def f(
+    teardown_clients = []
+
+    async def client_factory(
         url: str = request.config.getoption("--redis-url"),
         cls=redis.Redis,
         flushdb=True,
@@ -95,56 +99,50 @@ async def f(
             client = client.client()
             await client.initialize()
 
-        def teardown():
-            async def ateardown():
-                if not cluster_mode:
-                    if "username" in kwargs:
-                        return
-                    if flushdb:
-                        try:
-                            await client.flushdb()
-                        except redis.ConnectionError:
-                            # handle cases where a test disconnected a client
-                            # just manually retry the flushdb
-                            await client.flushdb()
-                    await client.close()
-                    await client.connection_pool.disconnect()
-                else:
-                    if flushdb:
-                        try:
-                            await client.flushdb(target_nodes="primaries")
-                        except redis.ConnectionError:
-                            # handle cases where a test disconnected a client
-                            # just manually retry the flushdb
-                            await client.flushdb(target_nodes="primaries")
-                    await client.close()
-
-            if event_loop.is_running():
-                event_loop.create_task(ateardown())
+        async def teardown():
+            if not cluster_mode:
+                if flushdb and "username" not in kwargs:
+                    try:
+                        await client.flushdb()
+                    except redis.ConnectionError:
+                        # handle cases where a test disconnected a client
+                        # just manually retry the flushdb
+                        await client.flushdb()
+                await client.close()
+                await client.connection_pool.disconnect()
             else:
-                event_loop.run_until_complete(ateardown())
-
-        request.addfinalizer(teardown)
-
+                if flushdb:
+                    try:
+                        await client.flushdb(target_nodes="primaries")
+                    except redis.ConnectionError:
+                        # handle cases where a test disconnected a client
+                        # just manually retry the flushdb
+                        await client.flushdb(target_nodes="primaries")
+                await client.close()
+
+        teardown_clients.append(teardown)
         return client
 
-    return f
+    yield client_factory
+
+    for teardown in teardown_clients:
+        await teardown()
 
 
 @pytest_asyncio.fixture()
-async def r(request, create_redis):
-    yield await create_redis()
+async def r(create_redis):
+    return await create_redis()
 
 
 @pytest_asyncio.fixture()
 async def r2(create_redis):
     """A second client for tests that need multiple"""
-    yield await create_redis()
+    return await create_redis()
 
 
 @pytest_asyncio.fixture()
 async def modclient(request, create_redis):
-    yield await create_redis(
+    return await create_redis(
         url=request.config.getoption("--redismod-url"), decode_responses=True
     )
 
@@ -222,7 +220,7 @@ async def mock_cluster_resp_slaves(create_redis, **kwargs):
 def master_host(request):
     url = request.config.getoption("--redis-url")
     parts = urlparse(url)
-    yield parts.hostname
+    return parts.hostname
 
 
 async def wait_for_command(
@@ -246,3 +244,41 @@ async def wait_for_command(
             return monitor_response
         if key in monitor_response["command"]:
             return None
+
+
+# python 3.6 doesn't have the asynccontextmanager decorator.  Provide it here.
+class AsyncContextManager:
+    def __init__(self, async_generator):
+        self.gen = async_generator
+
+    async def __aenter__(self):
+        try:
+            return await self.gen.__anext__()
+        except StopAsyncIteration as err:
+            raise RuntimeError("Pickles") from err
+
+    async def __aexit__(self, exc_type, exc_inst, tb):
+        if exc_type:
+            await self.gen.athrow(exc_type, exc_inst, tb)
+            return True
+        try:
+            await self.gen.__anext__()
+        except StopAsyncIteration:
+            return
+        raise RuntimeError("More pickles")
+
+
+if sys.version_info[0:2] == (3, 6):
+
+    def asynccontextmanager(func):
+        @functools.wraps(func)
+        def wrapper(*args, **kwargs):
+            return AsyncContextManager(func(*args, **kwargs))
+
+        return wrapper
+
+else:
+    from contextlib import asynccontextmanager as _asynccontextmanager
+
+    def asynccontextmanager(func):
+        return _asynccontextmanager(func)
diff --git a/tests/test_asyncio/test_bloom.py b/tests/test_asyncio/test_bloom.py
index feb98cc41e..2bf4e030e6 100644
--- a/tests/test_asyncio/test_bloom.py
+++ b/tests/test_asyncio/test_bloom.py
@@ -1,10 +1,13 @@
+import sys
+
 import pytest
 
 import redis.asyncio as redis
 from redis.exceptions import ModuleError, RedisError
 from redis.utils import HIREDIS_AVAILABLE
 
-pytestmark = pytest.mark.asyncio
+if sys.version_info[0:2] == (3, 6):
+    pytestmark = pytest.mark.asyncio
 
 
 def intlist(obj):
@@ -91,7 +94,7 @@ async def do_verify():
             res += rv == x
         assert res < 5
 
-    do_verify()
+    await do_verify()
     cmds = []
     if HIREDIS_AVAILABLE:
         with pytest.raises(ModuleError):
@@ -120,7 +123,7 @@ async def do_verify():
 
     cur_info = await modclient.bf().execute_command("bf.debug", "myBloom")
     assert prev_info == cur_info
-    do_verify()
+    await do_verify()
 
     await modclient.bf().client.delete("myBloom")
     await modclient.bf().create("myBloom", "0.0001", "10000000")
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 0d0ea33db2..8766cbf09b 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -11,6 +11,8 @@
 
 if sys.version_info[0:2] == (3, 6):
     import pytest as pytest_asyncio
+
+    pytestmark = pytest.mark.asyncio
 else:
     import pytest_asyncio
 
@@ -39,8 +41,6 @@
     skip_unless_arch_bits,
 )
 
-pytestmark = pytest.mark.asyncio
-
 default_host = "127.0.0.1"
 default_port = 7000
 default_cluster_slots = [
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index e128ac40b8..913f05b3fe 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -12,6 +12,8 @@
 
 if sys.version_info[0:2] == (3, 6):
     import pytest as pytest_asyncio
+
+    pytestmark = pytest.mark.asyncio
 else:
     import pytest_asyncio
 
@@ -27,11 +29,24 @@
 REDIS_6_VERSION = "5.9.0"
 
 
-pytestmark = pytest.mark.asyncio
+@pytest_asyncio.fixture()
+async def r_teardown(r: redis.Redis):
+    """
+    A special fixture which removes the provided names from the database after use
+    """
+    usernames = []
+
+    def factory(username):
+        usernames.append(username)
+        return r
+
+    yield factory
+    for username in usernames:
+        await r.acl_deluser(username)
 
 
 @pytest_asyncio.fixture()
-async def slowlog(r: redis.Redis, event_loop):
+async def slowlog(r: redis.Redis):
     current_config = await r.config_get()
     old_slower_than_value = current_config["slowlog-log-slower-than"]
     old_max_legnth_value = current_config["slowlog-max-len"]
@@ -94,17 +109,9 @@ async def test_acl_cat_with_category(self, r: redis.Redis):
         assert "get" in commands
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
-    async def test_acl_deluser(self, r: redis.Redis, request, event_loop):
+    async def test_acl_deluser(self, r_teardown):
         username = "redis-py-user"
-
-        def teardown():
-            coro = r.acl_deluser(username)
-            if event_loop.is_running():
-                event_loop.create_task(coro)
-            else:
-                event_loop.run_until_complete(coro)
-
-        request.addfinalizer(teardown)
+        r = r_teardown(username)
 
         assert await r.acl_deluser(username) == 0
         assert await r.acl_setuser(username, enabled=False, reset=True)
@@ -117,18 +124,9 @@ async def test_acl_genpass(self, r: redis.Redis):
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
     @skip_if_server_version_gte("7.0.0")
-    async def test_acl_getuser_setuser(self, r: redis.Redis, request, event_loop):
+    async def test_acl_getuser_setuser(self, r_teardown):
         username = "redis-py-user"
-
-        def teardown():
-            coro = r.acl_deluser(username)
-            if event_loop.is_running():
-                event_loop.create_task(coro)
-            else:
-                event_loop.run_until_complete(coro)
-
-        request.addfinalizer(teardown)
-
+        r = r_teardown(username)
         # test enabled=False
         assert await r.acl_setuser(username, enabled=False, reset=True)
         assert await r.acl_getuser(username) == {
@@ -233,17 +231,9 @@ def teardown():
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
     @skip_if_server_version_gte("7.0.0")
-    async def test_acl_list(self, r: redis.Redis, request, event_loop):
+    async def test_acl_list(self, r_teardown):
         username = "redis-py-user"
-
-        def teardown():
-            coro = r.acl_deluser(username)
-            if event_loop.is_running():
-                event_loop.create_task(coro)
-            else:
-                event_loop.run_until_complete(coro)
-
-        request.addfinalizer(teardown)
+        r = r_teardown(username)
 
         assert await r.acl_setuser(username, enabled=False, reset=True)
         users = await r.acl_list()
@@ -251,17 +241,9 @@ def teardown():
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
     @pytest.mark.onlynoncluster
-    async def test_acl_log(self, r: redis.Redis, request, event_loop, create_redis):
+    async def test_acl_log(self, r_teardown, create_redis):
         username = "redis-py-user"
-
-        def teardown():
-            coro = r.acl_deluser(username)
-            if event_loop.is_running():
-                event_loop.create_task(coro)
-            else:
-                event_loop.run_until_complete(coro)
-
-        request.addfinalizer(teardown)
+        r = r_teardown(username)
         await r.acl_setuser(
             username,
             enabled=True,
@@ -294,55 +276,25 @@ def teardown():
         assert await r.acl_log_reset()
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
-    async def test_acl_setuser_categories_without_prefix_fails(
-        self, r: redis.Redis, request, event_loop
-    ):
+    async def test_acl_setuser_categories_without_prefix_fails(self, r_teardown):
         username = "redis-py-user"
-
-        def teardown():
-            coro = r.acl_deluser(username)
-            if event_loop.is_running():
-                event_loop.create_task(coro)
-            else:
-                event_loop.run_until_complete(coro)
-
-        request.addfinalizer(teardown)
+        r = r_teardown(username)
 
         with pytest.raises(exceptions.DataError):
             await r.acl_setuser(username, categories=["list"])
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
-    async def test_acl_setuser_commands_without_prefix_fails(
-        self, r: redis.Redis, request, event_loop
-    ):
+    async def test_acl_setuser_commands_without_prefix_fails(self, r_teardown):
         username = "redis-py-user"
-
-        def teardown():
-            coro = r.acl_deluser(username)
-            if event_loop.is_running():
-                event_loop.create_task(coro)
-            else:
-                event_loop.run_until_complete(coro)
-
-        request.addfinalizer(teardown)
+        r = r_teardown(username)
 
         with pytest.raises(exceptions.DataError):
             await r.acl_setuser(username, commands=["get"])
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
-    async def test_acl_setuser_add_passwords_and_nopass_fails(
-        self, r: redis.Redis, request, event_loop
-    ):
+    async def test_acl_setuser_add_passwords_and_nopass_fails(self, r_teardown):
         username = "redis-py-user"
-
-        def teardown():
-            coro = r.acl_deluser(username)
-            if event_loop.is_running():
-                event_loop.create_task(coro)
-            else:
-                event_loop.run_until_complete(coro)
-
-        request.addfinalizer(teardown)
+        r = r_teardown(username)
 
         with pytest.raises(exceptions.DataError):
             await r.acl_setuser(username, passwords="+mypass", nopass=True)
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index 78a3efd2a0..8030f7e628 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -1,5 +1,6 @@
 import asyncio
 import socket
+import sys
 import types
 from unittest.mock import patch
 
@@ -18,7 +19,8 @@
 
 from .compat import mock
 
-pytestmark = pytest.mark.asyncio
+if sys.version_info[0:2] == (3, 6):
+    pytestmark = pytest.mark.asyncio
 
 
 @pytest.mark.onlynoncluster
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
index 6c56558d59..c8eb918e28 100644
--- a/tests/test_asyncio/test_connection_pool.py
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -7,6 +7,8 @@
 
 if sys.version_info[0:2] == (3, 6):
     import pytest as pytest_asyncio
+
+    pytestmark = pytest.mark.asyncio
 else:
     import pytest_asyncio
 
@@ -15,10 +17,9 @@
 from tests.conftest import skip_if_redis_enterprise, skip_if_server_version_lt
 
 from .compat import mock
+from .conftest import asynccontextmanager
 from .test_pubsub import wait_for_message
 
-pytestmark = pytest.mark.asyncio
-
 
 @pytest.mark.onlynoncluster
 class TestRedisAutoReleaseConnectionPool:
@@ -114,7 +115,8 @@ async def can_read(self, timeout: float = 0):
 
 
 class TestConnectionPool:
-    def get_pool(
+    @asynccontextmanager
+    async def get_pool(
         self,
         connection_kwargs=None,
         max_connections=None,
@@ -126,71 +128,77 @@ def get_pool(
             max_connections=max_connections,
             **connection_kwargs,
         )
-        return pool
+        try:
+            yield pool
+        finally:
+            await pool.disconnect(inuse_connections=True)
 
     async def test_connection_creation(self):
         connection_kwargs = {"foo": "bar", "biz": "baz"}
-        pool = self.get_pool(
+        async with self.get_pool(
             connection_kwargs=connection_kwargs, connection_class=DummyConnection
-        )
-        connection = await pool.get_connection("_")
-        assert isinstance(connection, DummyConnection)
-        assert connection.kwargs == connection_kwargs
+        ) as pool:
+            connection = await pool.get_connection("_")
+            assert isinstance(connection, DummyConnection)
+            assert connection.kwargs == connection_kwargs
 
     async def test_multiple_connections(self, master_host):
         connection_kwargs = {"host": master_host}
-        pool = self.get_pool(connection_kwargs=connection_kwargs)
-        c1 = await pool.get_connection("_")
-        c2 = await pool.get_connection("_")
-        assert c1 != c2
+        async with self.get_pool(connection_kwargs=connection_kwargs) as pool:
+            c1 = await pool.get_connection("_")
+            c2 = await pool.get_connection("_")
+            assert c1 != c2
 
     async def test_max_connections(self, master_host):
         connection_kwargs = {"host": master_host}
-        pool = self.get_pool(max_connections=2, connection_kwargs=connection_kwargs)
-        await pool.get_connection("_")
-        await pool.get_connection("_")
-        with pytest.raises(redis.ConnectionError):
+        async with self.get_pool(
+            max_connections=2, connection_kwargs=connection_kwargs
+        ) as pool:
+            await pool.get_connection("_")
             await pool.get_connection("_")
+            with pytest.raises(redis.ConnectionError):
+                await pool.get_connection("_")
 
     async def test_reuse_previously_released_connection(self, master_host):
         connection_kwargs = {"host": master_host}
-        pool = self.get_pool(connection_kwargs=connection_kwargs)
-        c1 = await pool.get_connection("_")
-        await pool.release(c1)
-        c2 = await pool.get_connection("_")
-        assert c1 == c2
+        async with self.get_pool(connection_kwargs=connection_kwargs) as pool:
+            c1 = await pool.get_connection("_")
+            await pool.release(c1)
+            c2 = await pool.get_connection("_")
+            assert c1 == c2
 
-    def test_repr_contains_db_info_tcp(self):
+    async def test_repr_contains_db_info_tcp(self):
         connection_kwargs = {
             "host": "localhost",
             "port": 6379,
             "db": 1,
             "client_name": "test-client",
         }
-        pool = self.get_pool(
+        async with self.get_pool(
             connection_kwargs=connection_kwargs, connection_class=redis.Connection
-        )
-        expected = (
-            "ConnectionPool<Connection<"
-            "host=localhost,port=6379,db=1,client_name=test-client>>"
-        )
-        assert repr(pool) == expected
+        ) as pool:
+            expected = (
+                "ConnectionPool<Connection<"
+                "host=localhost,port=6379,db=1,client_name=test-client>>"
+            )
+            assert repr(pool) == expected
 
-    def test_repr_contains_db_info_unix(self):
+    async def test_repr_contains_db_info_unix(self):
         connection_kwargs = {"path": "/abc", "db": 1, "client_name": "test-client"}
-        pool = self.get_pool(
+        async with self.get_pool(
             connection_kwargs=connection_kwargs,
             connection_class=redis.UnixDomainSocketConnection,
-        )
-        expected = (
-            "ConnectionPool<UnixDomainSocketConnection<"
-            "path=/abc,db=1,client_name=test-client>>"
-        )
-        assert repr(pool) == expected
+        ) as pool:
+            expected = (
+                "ConnectionPool<UnixDomainSocketConnection<"
+                "path=/abc,db=1,client_name=test-client>>"
+            )
+            assert repr(pool) == expected
 
 
 class TestBlockingConnectionPool:
-    def get_pool(self, connection_kwargs=None, max_connections=10, timeout=20):
+    @asynccontextmanager
+    async def get_pool(self, connection_kwargs=None, max_connections=10, timeout=20):
         connection_kwargs = connection_kwargs or {}
         pool = redis.BlockingConnectionPool(
             connection_class=DummyConnection,
@@ -198,7 +206,10 @@ def get_pool(self, connection_kwargs=None, max_connections=10, timeout=20):
             timeout=timeout,
             **connection_kwargs,
         )
-        return pool
+        try:
+            yield pool
+        finally:
+            await pool.disconnect(inuse_connections=True)
 
     async def test_connection_creation(self, master_host):
         connection_kwargs = {
@@ -207,10 +218,10 @@ async def test_connection_creation(self, master_host):
             "host": master_host[0],
             "port": master_host[1],
         }
-        pool = self.get_pool(connection_kwargs=connection_kwargs)
-        connection = await pool.get_connection("_")
-        assert isinstance(connection, DummyConnection)
-        assert connection.kwargs == connection_kwargs
+        async with self.get_pool(connection_kwargs=connection_kwargs) as pool:
+            connection = await pool.get_connection("_")
+            assert isinstance(connection, DummyConnection)
+            assert connection.kwargs == connection_kwargs
 
     async def test_disconnect(self, master_host):
         """A regression test for #1047"""
@@ -220,30 +231,31 @@ async def test_disconnect(self, master_host):
             "host": master_host[0],
             "port": master_host[1],
         }
-        pool = self.get_pool(connection_kwargs=connection_kwargs)
-        await pool.get_connection("_")
-        await pool.disconnect()
+        async with self.get_pool(connection_kwargs=connection_kwargs) as pool:
+            await pool.get_connection("_")
+            await pool.disconnect()
 
     async def test_multiple_connections(self, master_host):
         connection_kwargs = {"host": master_host[0], "port": master_host[1]}
-        pool = self.get_pool(connection_kwargs=connection_kwargs)
-        c1 = await pool.get_connection("_")
-        c2 = await pool.get_connection("_")
-        assert c1 != c2
+        async with self.get_pool(connection_kwargs=connection_kwargs) as pool:
+            c1 = await pool.get_connection("_")
+            c2 = await pool.get_connection("_")
+            assert c1 != c2
 
     async def test_connection_pool_blocks_until_timeout(self, master_host):
         """When out of connections, block for timeout seconds, then raise"""
         connection_kwargs = {"host": master_host}
-        pool = self.get_pool(
+        async with self.get_pool(
             max_connections=1, timeout=0.1, connection_kwargs=connection_kwargs
-        )
-        await pool.get_connection("_")
+        ) as pool:
+            c1 = await pool.get_connection("_")
 
-        start = asyncio.get_event_loop().time()
-        with pytest.raises(redis.ConnectionError):
-            await pool.get_connection("_")
-        # we should have waited at least 0.1 seconds
-        assert asyncio.get_event_loop().time() - start >= 0.1
+            start = asyncio.get_event_loop().time()
+            with pytest.raises(redis.ConnectionError):
+                await pool.get_connection("_")
+            # we should have waited at least 0.1 seconds
+            assert asyncio.get_event_loop().time() - start >= 0.1
+            await c1.disconnect()
 
     async def test_connection_pool_blocks_until_conn_available(self, master_host):
         """
@@ -251,26 +263,26 @@ async def test_connection_pool_blocks_until_conn_available(self, master_host):
         to the pool
         """
         connection_kwargs = {"host": master_host[0], "port": master_host[1]}
-        pool = self.get_pool(
+        async with self.get_pool(
             max_connections=1, timeout=2, connection_kwargs=connection_kwargs
-        )
-        c1 = await pool.get_connection("_")
+        ) as pool:
+            c1 = await pool.get_connection("_")
 
-        async def target():
-            await asyncio.sleep(0.1)
-            await pool.release(c1)
+            async def target():
+                await asyncio.sleep(0.1)
+                await pool.release(c1)
 
-        start = asyncio.get_event_loop().time()
-        await asyncio.gather(target(), pool.get_connection("_"))
-        assert asyncio.get_event_loop().time() - start >= 0.1
+            start = asyncio.get_event_loop().time()
+            await asyncio.gather(target(), pool.get_connection("_"))
+            assert asyncio.get_event_loop().time() - start >= 0.1
 
     async def test_reuse_previously_released_connection(self, master_host):
         connection_kwargs = {"host": master_host}
-        pool = self.get_pool(connection_kwargs=connection_kwargs)
-        c1 = await pool.get_connection("_")
-        await pool.release(c1)
-        c2 = await pool.get_connection("_")
-        assert c1 == c2
+        async with self.get_pool(connection_kwargs=connection_kwargs) as pool:
+            c1 = await pool.get_connection("_")
+            await pool.release(c1)
+            c2 = await pool.get_connection("_")
+            assert c1 == c2
 
     def test_repr_contains_db_info_tcp(self):
         pool = redis.ConnectionPool(
@@ -689,6 +701,8 @@ async def test_arbitrary_command_advances_next_health_check(self, r):
         if r.connection:
             await r.get("foo")
             next_health_check = r.connection.next_health_check
+            # ensure that the event loop's `time()` advances a bit
+            await asyncio.sleep(0.001)
             await r.get("foo")
             assert next_health_check < r.connection.next_health_check
 
diff --git a/tests/test_asyncio/test_encoding.py b/tests/test_asyncio/test_encoding.py
index 133ea3783c..5db7187c84 100644
--- a/tests/test_asyncio/test_encoding.py
+++ b/tests/test_asyncio/test_encoding.py
@@ -4,14 +4,14 @@
 
 if sys.version_info[0:2] == (3, 6):
     import pytest as pytest_asyncio
+
+    pytestmark = pytest.mark.asyncio
 else:
     import pytest_asyncio
 
 import redis.asyncio as redis
 from redis.exceptions import DataError
 
-pytestmark = pytest.mark.asyncio
-
 
 @pytest.mark.onlynoncluster
 class TestEncoding:
diff --git a/tests/test_asyncio/test_json.py b/tests/test_asyncio/test_json.py
index a045dd7c1a..416a9f4a21 100644
--- a/tests/test_asyncio/test_json.py
+++ b/tests/test_asyncio/test_json.py
@@ -5,8 +5,6 @@
 from redis.commands.json.path import Path
 from tests.conftest import skip_ifmodversion_lt
 
-pytestmark = pytest.mark.asyncio
-
 
 @pytest.mark.redismod
 async def test_json_setbinarykey(modclient: redis.Redis):
diff --git a/tests/test_asyncio/test_lock.py b/tests/test_asyncio/test_lock.py
index 8ceb3bc958..86a8d62f71 100644
--- a/tests/test_asyncio/test_lock.py
+++ b/tests/test_asyncio/test_lock.py
@@ -5,14 +5,14 @@
 
 if sys.version_info[0:2] == (3, 6):
     import pytest as pytest_asyncio
+
+    pytestmark = pytest.mark.asyncio
 else:
     import pytest_asyncio
 
 from redis.asyncio.lock import Lock
 from redis.exceptions import LockError, LockNotOwnedError
 
-pytestmark = pytest.mark.asyncio
-
 
 @pytest.mark.onlynoncluster
 class TestLock:
diff --git a/tests/test_asyncio/test_monitor.py b/tests/test_asyncio/test_monitor.py
index 783ba262b0..9185bcd2ee 100644
--- a/tests/test_asyncio/test_monitor.py
+++ b/tests/test_asyncio/test_monitor.py
@@ -1,10 +1,13 @@
+import sys
+
 import pytest
 
 from tests.conftest import skip_if_redis_enterprise, skip_ifnot_redis_enterprise
 
 from .conftest import wait_for_command
 
-pytestmark = pytest.mark.asyncio
+if sys.version_info[0:2] == (3, 6):
+    pytestmark = pytest.mark.asyncio
 
 
 @pytest.mark.onlynoncluster
diff --git a/tests/test_asyncio/test_pipeline.py b/tests/test_asyncio/test_pipeline.py
index dfeb66464c..33391d019d 100644
--- a/tests/test_asyncio/test_pipeline.py
+++ b/tests/test_asyncio/test_pipeline.py
@@ -1,3 +1,5 @@
+import sys
+
 import pytest
 
 import redis
@@ -5,7 +7,8 @@
 
 from .conftest import wait_for_command
 
-pytestmark = pytest.mark.asyncio
+if sys.version_info[0:2] == (3, 6):
+    pytestmark = pytest.mark.asyncio
 
 
 class TestPipeline:
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index 6c76bf334e..d6a817a61b 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -8,6 +8,8 @@
 
 if sys.version_info[0:2] == (3, 6):
     import pytest as pytest_asyncio
+
+    pytestmark = pytest.mark.asyncio(forbid_global_loop=True)
 else:
     import pytest_asyncio
 
@@ -18,8 +20,6 @@
 
 from .compat import mock
 
-pytestmark = pytest.mark.asyncio(forbid_global_loop=True)
-
 
 def with_timeout(t):
     def wrapper(corofunc):
@@ -80,6 +80,13 @@ def make_subscribe_test_data(pubsub, type):
     assert False, f"invalid subscribe type: {type}"
 
 
+@pytest_asyncio.fixture()
+async def pubsub(r: redis.Redis):
+    p = r.pubsub()
+    yield p
+    await p.close()
+
+
 @pytest.mark.onlynoncluster
 class TestPubSubSubscribeUnsubscribe:
     async def _test_subscribe_unsubscribe(
@@ -101,12 +108,12 @@ async def _test_subscribe_unsubscribe(
             i = len(keys) - 1 - i
             assert await wait_for_message(p) == make_message(unsub_type, key, i)
 
-    async def test_channel_subscribe_unsubscribe(self, r: redis.Redis):
-        kwargs = make_subscribe_test_data(r.pubsub(), "channel")
+    async def test_channel_subscribe_unsubscribe(self, pubsub):
+        kwargs = make_subscribe_test_data(pubsub, "channel")
         await self._test_subscribe_unsubscribe(**kwargs)
 
-    async def test_pattern_subscribe_unsubscribe(self, r: redis.Redis):
-        kwargs = make_subscribe_test_data(r.pubsub(), "pattern")
+    async def test_pattern_subscribe_unsubscribe(self, pubsub):
+        kwargs = make_subscribe_test_data(pubsub, "pattern")
         await self._test_subscribe_unsubscribe(**kwargs)
 
     @pytest.mark.onlynoncluster
@@ -144,12 +151,12 @@ async def _test_resubscribe_on_reconnection(
         for channel in unique_channels:
             assert channel in keys
 
-    async def test_resubscribe_to_channels_on_reconnection(self, r: redis.Redis):
-        kwargs = make_subscribe_test_data(r.pubsub(), "channel")
+    async def test_resubscribe_to_channels_on_reconnection(self, pubsub):
+        kwargs = make_subscribe_test_data(pubsub, "channel")
         await self._test_resubscribe_on_reconnection(**kwargs)
 
-    async def test_resubscribe_to_patterns_on_reconnection(self, r: redis.Redis):
-        kwargs = make_subscribe_test_data(r.pubsub(), "pattern")
+    async def test_resubscribe_to_patterns_on_reconnection(self, pubsub):
+        kwargs = make_subscribe_test_data(pubsub, "pattern")
         await self._test_resubscribe_on_reconnection(**kwargs)
 
     async def _test_subscribed_property(
@@ -199,13 +206,13 @@ async def _test_subscribed_property(
         # now we're finally unsubscribed
         assert p.subscribed is False
 
-    async def test_subscribe_property_with_channels(self, r: redis.Redis):
-        kwargs = make_subscribe_test_data(r.pubsub(), "channel")
+    async def test_subscribe_property_with_channels(self, pubsub):
+        kwargs = make_subscribe_test_data(pubsub, "channel")
         await self._test_subscribed_property(**kwargs)
 
     @pytest.mark.onlynoncluster
-    async def test_subscribe_property_with_patterns(self, r: redis.Redis):
-        kwargs = make_subscribe_test_data(r.pubsub(), "pattern")
+    async def test_subscribe_property_with_patterns(self, pubsub):
+        kwargs = make_subscribe_test_data(pubsub, "pattern")
         await self._test_subscribed_property(**kwargs)
 
     async def test_ignore_all_subscribe_messages(self, r: redis.Redis):
@@ -224,9 +231,10 @@ async def test_ignore_all_subscribe_messages(self, r: redis.Redis):
             assert p.subscribed is True
             assert await wait_for_message(p) is None
         assert p.subscribed is False
+        await p.close()
 
-    async def test_ignore_individual_subscribe_messages(self, r: redis.Redis):
-        p = r.pubsub()
+    async def test_ignore_individual_subscribe_messages(self, pubsub):
+        p = pubsub
 
         checks = (
             (p.subscribe, "foo"),
@@ -243,13 +251,13 @@ async def test_ignore_individual_subscribe_messages(self, r: redis.Redis):
             assert message is None
         assert p.subscribed is False
 
-    async def test_sub_unsub_resub_channels(self, r: redis.Redis):
-        kwargs = make_subscribe_test_data(r.pubsub(), "channel")
+    async def test_sub_unsub_resub_channels(self, pubsub):
+        kwargs = make_subscribe_test_data(pubsub, "channel")
         await self._test_sub_unsub_resub(**kwargs)
 
     @pytest.mark.onlynoncluster
-    async def test_sub_unsub_resub_patterns(self, r: redis.Redis):
-        kwargs = make_subscribe_test_data(r.pubsub(), "pattern")
+    async def test_sub_unsub_resub_patterns(self, pubsub):
+        kwargs = make_subscribe_test_data(pubsub, "pattern")
         await self._test_sub_unsub_resub(**kwargs)
 
     async def _test_sub_unsub_resub(
@@ -266,12 +274,12 @@ async def _test_sub_unsub_resub(
         assert await wait_for_message(p) == make_message(sub_type, key, 1)
         assert p.subscribed is True
 
-    async def test_sub_unsub_all_resub_channels(self, r: redis.Redis):
-        kwargs = make_subscribe_test_data(r.pubsub(), "channel")
+    async def test_sub_unsub_all_resub_channels(self, pubsub):
+        kwargs = make_subscribe_test_data(pubsub, "channel")
         await self._test_sub_unsub_all_resub(**kwargs)
 
-    async def test_sub_unsub_all_resub_patterns(self, r: redis.Redis):
-        kwargs = make_subscribe_test_data(r.pubsub(), "pattern")
+    async def test_sub_unsub_all_resub_patterns(self, pubsub):
+        kwargs = make_subscribe_test_data(pubsub, "pattern")
         await self._test_sub_unsub_all_resub(**kwargs)
 
     async def _test_sub_unsub_all_resub(
@@ -300,8 +308,8 @@ def message_handler(self, message):
     async def async_message_handler(self, message):
         self.async_message = message
 
-    async def test_published_message_to_channel(self, r: redis.Redis):
-        p = r.pubsub()
+    async def test_published_message_to_channel(self, r: redis.Redis, pubsub):
+        p = pubsub
         await p.subscribe("foo")
         assert await wait_for_message(p) == make_message("subscribe", "foo", 1)
         assert await r.publish("foo", "test message") == 1
@@ -310,8 +318,8 @@ async def test_published_message_to_channel(self, r: redis.Redis):
         assert isinstance(message, dict)
         assert message == make_message("message", "foo", "test message")
 
-    async def test_published_message_to_pattern(self, r: redis.Redis):
-        p = r.pubsub()
+    async def test_published_message_to_pattern(self, r: redis.Redis, pubsub):
+        p = pubsub
         await p.subscribe("foo")
         await p.psubscribe("f*")
         assert await wait_for_message(p) == make_message("subscribe", "foo", 1)
@@ -340,6 +348,7 @@ async def test_channel_message_handler(self, r: redis.Redis):
         assert await r.publish("foo", "test message") == 1
         assert await wait_for_message(p) is None
         assert self.message == make_message("message", "foo", "test message")
+        await p.close()
 
     async def test_channel_async_message_handler(self, r):
         p = r.pubsub(ignore_subscribe_messages=True)
@@ -348,6 +357,7 @@ async def test_channel_async_message_handler(self, r):
         assert await r.publish("foo", "test message") == 1
         assert await wait_for_message(p) is None
         assert self.async_message == make_message("message", "foo", "test message")
+        await p.close()
 
     async def test_channel_sync_async_message_handler(self, r):
         p = r.pubsub(ignore_subscribe_messages=True)
@@ -359,6 +369,7 @@ async def test_channel_sync_async_message_handler(self, r):
         assert await wait_for_message(p) is None
         assert self.message == make_message("message", "foo", "test message")
         assert self.async_message == make_message("message", "bar", "test message 2")
+        await p.close()
 
     @pytest.mark.onlynoncluster
     async def test_pattern_message_handler(self, r: redis.Redis):
@@ -370,6 +381,7 @@ async def test_pattern_message_handler(self, r: redis.Redis):
         assert self.message == make_message(
             "pmessage", "foo", "test message", pattern="f*"
         )
+        await p.close()
 
     async def test_unicode_channel_message_handler(self, r: redis.Redis):
         p = r.pubsub(ignore_subscribe_messages=True)
@@ -380,6 +392,7 @@ async def test_unicode_channel_message_handler(self, r: redis.Redis):
         assert await r.publish(channel, "test message") == 1
         assert await wait_for_message(p) is None
         assert self.message == make_message("message", channel, "test message")
+        await p.close()
 
     @pytest.mark.onlynoncluster
     # see: https://redis-py-cluster.readthedocs.io/en/stable/pubsub.html
@@ -395,9 +408,10 @@ async def test_unicode_pattern_message_handler(self, r: redis.Redis):
         assert self.message == make_message(
             "pmessage", channel, "test message", pattern=pattern
         )
+        await p.close()
 
-    async def test_get_message_without_subscribe(self, r: redis.Redis):
-        p = r.pubsub()
+    async def test_get_message_without_subscribe(self, r: redis.Redis, pubsub):
+        p = pubsub
         with pytest.raises(RuntimeError) as info:
             await p.get_message()
         expect = (
@@ -427,8 +441,8 @@ def message_handler(self, message):
     async def r(self, create_redis):
         return await create_redis(decode_responses=True)
 
-    async def test_channel_subscribe_unsubscribe(self, r: redis.Redis):
-        p = r.pubsub()
+    async def test_channel_subscribe_unsubscribe(self, pubsub):
+        p = pubsub
         await p.subscribe(self.channel)
         assert await wait_for_message(p) == self.make_message(
             "subscribe", self.channel, 1
@@ -439,8 +453,8 @@ async def test_channel_subscribe_unsubscribe(self, r: redis.Redis):
             "unsubscribe", self.channel, 0
         )
 
-    async def test_pattern_subscribe_unsubscribe(self, r: redis.Redis):
-        p = r.pubsub()
+    async def test_pattern_subscribe_unsubscribe(self, pubsub):
+        p = pubsub
         await p.psubscribe(self.pattern)
         assert await wait_for_message(p) == self.make_message(
             "psubscribe", self.pattern, 1
@@ -451,8 +465,8 @@ async def test_pattern_subscribe_unsubscribe(self, r: redis.Redis):
             "punsubscribe", self.pattern, 0
         )
 
-    async def test_channel_publish(self, r: redis.Redis):
-        p = r.pubsub()
+    async def test_channel_publish(self, r: redis.Redis, pubsub):
+        p = pubsub
         await p.subscribe(self.channel)
         assert await wait_for_message(p) == self.make_message(
             "subscribe", self.channel, 1
@@ -463,8 +477,8 @@ async def test_channel_publish(self, r: redis.Redis):
         )
 
     @pytest.mark.onlynoncluster
-    async def test_pattern_publish(self, r: redis.Redis):
-        p = r.pubsub()
+    async def test_pattern_publish(self, r: redis.Redis, pubsub):
+        p = pubsub
         await p.psubscribe(self.pattern)
         assert await wait_for_message(p) == self.make_message(
             "psubscribe", self.pattern, 1
@@ -490,6 +504,7 @@ async def test_channel_message_handler(self, r: redis.Redis):
         await r.publish(self.channel, new_data)
         assert await wait_for_message(p) is None
         assert self.message == self.make_message("message", self.channel, new_data)
+        await p.close()
 
     async def test_pattern_message_handler(self, r: redis.Redis):
         p = r.pubsub(ignore_subscribe_messages=True)
@@ -511,6 +526,7 @@ async def test_pattern_message_handler(self, r: redis.Redis):
         assert self.message == self.make_message(
             "pmessage", self.channel, new_data, pattern=self.pattern
         )
+        await p.close()
 
     async def test_context_manager(self, r: redis.Redis):
         async with r.pubsub() as pubsub:
@@ -520,6 +536,7 @@ async def test_context_manager(self, r: redis.Redis):
         assert pubsub.connection is None
         assert pubsub.channels == {}
         assert pubsub.patterns == {}
+        await pubsub.close()
 
 
 @pytest.mark.onlynoncluster
@@ -535,8 +552,8 @@ async def test_channel_subscribe(self, r: redis.Redis):
 class TestPubSubSubcommands:
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.8.0")
-    async def test_pubsub_channels(self, r: redis.Redis):
-        p = r.pubsub()
+    async def test_pubsub_channels(self, r: redis.Redis, pubsub):
+        p = pubsub
         await p.subscribe("foo", "bar", "baz", "quux")
         for i in range(4):
             assert (await wait_for_message(p))["type"] == "subscribe"
@@ -560,6 +577,9 @@ async def test_pubsub_numsub(self, r: redis.Redis):
 
         channels = [(b"foo", 1), (b"bar", 2), (b"baz", 3)]
         assert await r.pubsub_numsub("foo", "bar", "baz") == channels
+        await p1.close()
+        await p2.close()
+        await p3.close()
 
     @skip_if_server_version_lt("2.8.0")
     async def test_pubsub_numpat(self, r: redis.Redis):
@@ -568,6 +588,7 @@ async def test_pubsub_numpat(self, r: redis.Redis):
         for i in range(3):
             assert (await wait_for_message(p))["type"] == "psubscribe"
         assert await r.pubsub_numpat() == 3
+        await p.close()
 
 
 @pytest.mark.onlynoncluster
@@ -580,6 +601,7 @@ async def test_send_pubsub_ping(self, r: redis.Redis):
         assert await wait_for_message(p) == make_message(
             type="pong", channel=None, data="", pattern=None
         )
+        await p.close()
 
     @skip_if_server_version_lt("3.0.0")
     async def test_send_pubsub_ping_message(self, r: redis.Redis):
@@ -589,13 +611,16 @@ async def test_send_pubsub_ping_message(self, r: redis.Redis):
         assert await wait_for_message(p) == make_message(
             type="pong", channel=None, data="hello world", pattern=None
         )
+        await p.close()
 
 
 @pytest.mark.onlynoncluster
 class TestPubSubConnectionKilled:
     @skip_if_server_version_lt("3.0.0")
-    async def test_connection_error_raised_when_connection_dies(self, r: redis.Redis):
-        p = r.pubsub()
+    async def test_connection_error_raised_when_connection_dies(
+        self, r: redis.Redis, pubsub
+    ):
+        p = pubsub
         await p.subscribe("foo")
         assert await wait_for_message(p) == make_message("subscribe", "foo", 1)
         for client in await r.client_list():
@@ -607,8 +632,8 @@ async def test_connection_error_raised_when_connection_dies(self, r: redis.Redis
 
 @pytest.mark.onlynoncluster
 class TestPubSubTimeouts:
-    async def test_get_message_with_timeout_returns_none(self, r: redis.Redis):
-        p = r.pubsub()
+    async def test_get_message_with_timeout_returns_none(self, pubsub):
+        p = pubsub
         await p.subscribe("foo")
         assert await wait_for_message(p) == make_message("subscribe", "foo", 1)
         assert await p.get_message(timeout=0.01) is None
@@ -616,15 +641,13 @@ async def test_get_message_with_timeout_returns_none(self, r: redis.Redis):
 
 @pytest.mark.onlynoncluster
 class TestPubSubReconnect:
-    # @pytest.mark.xfail
     @with_timeout(2)
-    async def test_reconnect_listen(self, r: redis.Redis):
+    async def test_reconnect_listen(self, r: redis.Redis, pubsub):
         """
         Test that a loop processing PubSub messages can survive
         a disconnect, by issuing a connect() call.
         """
         messages = asyncio.Queue()
-        pubsub = r.pubsub()
         interrupt = False
 
         async def loop():
@@ -698,12 +721,12 @@ async def _subscribe(self, p, *args, **kwargs):
             ):
                 return
 
-    async def test_callbacks(self, r: redis.Redis):
+    async def test_callbacks(self, r: redis.Redis, pubsub):
         def callback(message):
             messages.put_nowait(message)
 
         messages = asyncio.Queue()
-        p = r.pubsub()
+        p = pubsub
         await self._subscribe(p, foo=callback)
         task = asyncio.get_event_loop().create_task(p.run())
         await r.publish("foo", "bar")
@@ -720,13 +743,13 @@ def callback(message):
             "type": "message",
         }
 
-    async def test_exception_handler(self, r: redis.Redis):
+    async def test_exception_handler(self, r: redis.Redis, pubsub):
         def exception_handler_callback(e, pubsub) -> None:
             assert pubsub == p
             exceptions.put_nowait(e)
 
         exceptions = asyncio.Queue()
-        p = r.pubsub()
+        p = pubsub
         await self._subscribe(p, foo=lambda x: None)
         with mock.patch.object(p, "get_message", side_effect=Exception("error")):
             task = asyncio.get_event_loop().create_task(
@@ -740,26 +763,25 @@ def exception_handler_callback(e, pubsub) -> None:
                 pass
         assert str(e) == "error"
 
-    async def test_late_subscribe(self, r: redis.Redis):
+    async def test_late_subscribe(self, r: redis.Redis, pubsub):
         def callback(message):
             messages.put_nowait(message)
 
         messages = asyncio.Queue()
-        p = r.pubsub()
+        p = pubsub
         task = asyncio.get_event_loop().create_task(p.run())
         # wait until loop gets settled.  Add a subscription
         await asyncio.sleep(0.1)
         await p.subscribe(foo=callback)
         # wait tof the subscribe to finish.  Cannot use _subscribe() because
         # p.run() is already accepting messages
-        await asyncio.sleep(0.1)
-        await r.publish("foo", "bar")
-        message = None
-        try:
-            async with async_timeout.timeout(0.1):
-                message = await messages.get()
-        except asyncio.TimeoutError:
-            pass
+        while True:
+            n = await r.publish("foo", "bar")
+            if n == 1:
+                break
+            await asyncio.sleep(0.1)
+        async with async_timeout.timeout(0.1):
+            message = await messages.get()
         task.cancel()
         # we expect a cancelled error, not the Runtime error
         # ("did you forget to call subscribe()"")
diff --git a/tests/test_asyncio/test_scripting.py b/tests/test_asyncio/test_scripting.py
index 764525fb4a..406ab208e2 100644
--- a/tests/test_asyncio/test_scripting.py
+++ b/tests/test_asyncio/test_scripting.py
@@ -4,6 +4,8 @@
 
 if sys.version_info[0:2] == (3, 6):
     import pytest as pytest_asyncio
+
+    pytestmark = pytest.mark.asyncio
 else:
     import pytest_asyncio
 
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 5aaa56f159..bc3a212ac9 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -1,6 +1,7 @@
 import bz2
 import csv
 import os
+import sys
 import time
 from io import TextIOWrapper
 
@@ -18,7 +19,8 @@
 from redis.commands.search.suggestion import Suggestion
 from tests.conftest import skip_ifmodversion_lt
 
-pytestmark = pytest.mark.asyncio
+if sys.version_info[0:2] == (3, 6):
+    pytestmark = pytest.mark.asyncio
 
 
 WILL_PLAY_TEXT = os.path.abspath(
diff --git a/tests/test_asyncio/test_sentinel.py b/tests/test_asyncio/test_sentinel.py
index 4130e67400..e77e07f98e 100644
--- a/tests/test_asyncio/test_sentinel.py
+++ b/tests/test_asyncio/test_sentinel.py
@@ -5,6 +5,8 @@
 
 if sys.version_info[0:2] == (3, 6):
     import pytest as pytest_asyncio
+
+    pytestmark = pytest.mark.asyncio
 else:
     import pytest_asyncio
 
@@ -17,8 +19,6 @@
     SlaveNotFoundError,
 )
 
-pytestmark = pytest.mark.asyncio
-
 
 @pytest_asyncio.fixture(scope="module")
 def master_ip(master_host):
diff --git a/tests/test_asyncio/test_timeseries.py b/tests/test_asyncio/test_timeseries.py
index ac2807fe1d..0e57c4f049 100644
--- a/tests/test_asyncio/test_timeseries.py
+++ b/tests/test_asyncio/test_timeseries.py
@@ -1,3 +1,4 @@
+import sys
 import time
 from time import sleep
 
@@ -6,7 +7,8 @@
 import redis.asyncio as redis
 from tests.conftest import skip_ifmodversion_lt
 
-pytestmark = pytest.mark.asyncio
+if sys.version_info[0:2] == (3, 6):
+    pytestmark = pytest.mark.asyncio
 
 
 @pytest.mark.redismod
diff --git a/tests/test_json.py b/tests/test_json.py
index 1cc448c5f9..0965a93d88 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -1411,7 +1411,8 @@ def test_set_path(client):
 
     with open(jsonfile, "w+") as fp:
         fp.write(json.dumps({"hello": "world"}))
-    open(nojsonfile, "a+").write("hello")
+    with open(nojsonfile, "a+") as fp:
+        fp.write("hello")
 
     result = {jsonfile: True, nojsonfile: False}
     assert client.json().set_path(Path.root_path(), root) == result
diff --git a/tests/test_ssl.py b/tests/test_ssl.py
index d029b80dcb..ed38a3166b 100644
--- a/tests/test_ssl.py
+++ b/tests/test_ssl.py
@@ -68,8 +68,8 @@ def test_validating_self_signed_certificate(self, request):
         assert r.ping()
 
     def test_validating_self_signed_string_certificate(self, request):
-        f = open(self.SERVER_CERT)
-        cert_data = f.read()
+        with open(self.SERVER_CERT) as f:
+            cert_data = f.read()
         ssl_url = request.config.option.redis_ssl_url
         p = urlparse(ssl_url)[1].split(":")
         r = redis.Redis(
diff --git a/tox.ini b/tox.ini
index 0ceb008cf6..d1aeb02ade 100644
--- a/tox.ini
+++ b/tox.ini
@@ -9,6 +9,7 @@ markers =
     asyncio: marker for async tests
     replica: replica tests
     experimental: run only experimental tests
+asyncio_mode = auto
 
 [tox]
 minversion = 3.2.0

From a246f4042cd048c572ed0d60bd82aaa9547aa4a8 Mon Sep 17 00:00:00 2001
From: DvirDukhan <dvir@redis.com>
Date: Tue, 26 Jul 2022 20:14:17 +0300
Subject: [PATCH 0543/1164] Graph - add counters for removed labels and
 properties (#2292)

* grpah - add counters for removed labels and properties

* added mock graph result set statistics

* docstrings for graph result set statistics

* format

* isort

* moved docstrings into functions
---
 redis/commands/graph/query_result.py | 24 ++++++++++++++
 tests/test_graph.py                  | 47 ++++++++++++++++++++++++++++
 2 files changed, 71 insertions(+)

diff --git a/redis/commands/graph/query_result.py b/redis/commands/graph/query_result.py
index 644ac5a3db..3ffa664791 100644
--- a/redis/commands/graph/query_result.py
+++ b/redis/commands/graph/query_result.py
@@ -9,10 +9,12 @@
 from .path import Path
 
 LABELS_ADDED = "Labels added"
+LABELS_REMOVED = "Labels removed"
 NODES_CREATED = "Nodes created"
 NODES_DELETED = "Nodes deleted"
 RELATIONSHIPS_DELETED = "Relationships deleted"
 PROPERTIES_SET = "Properties set"
+PROPERTIES_REMOVED = "Properties removed"
 RELATIONSHIPS_CREATED = "Relationships created"
 INDICES_CREATED = "Indices created"
 INDICES_DELETED = "Indices deleted"
@@ -21,8 +23,10 @@
 
 STATS = [
     LABELS_ADDED,
+    LABELS_REMOVED,
     NODES_CREATED,
     PROPERTIES_SET,
+    PROPERTIES_REMOVED,
     RELATIONSHIPS_CREATED,
     NODES_DELETED,
     RELATIONSHIPS_DELETED,
@@ -323,40 +327,60 @@ def _get_stat(self, stat):
 
     @property
     def labels_added(self):
+        """Returns the number of labels added in the query"""
         return self._get_stat(LABELS_ADDED)
 
+    @property
+    def labels_removed(self):
+        """Returns the number of labels removed in the query"""
+        return self._get_stat(LABELS_REMOVED)
+
     @property
     def nodes_created(self):
+        """Returns the number of nodes created in the query"""
         return self._get_stat(NODES_CREATED)
 
     @property
     def nodes_deleted(self):
+        """Returns the number of nodes deleted in the query"""
         return self._get_stat(NODES_DELETED)
 
     @property
     def properties_set(self):
+        """Returns the number of properties set in the query"""
         return self._get_stat(PROPERTIES_SET)
 
+    @property
+    def properties_removed(self):
+        """Returns the number of properties removed in the query"""
+        return self._get_stat(PROPERTIES_REMOVED)
+
     @property
     def relationships_created(self):
+        """Returns the number of relationships created in the query"""
         return self._get_stat(RELATIONSHIPS_CREATED)
 
     @property
     def relationships_deleted(self):
+        """Returns the number of relationships deleted in the query"""
         return self._get_stat(RELATIONSHIPS_DELETED)
 
     @property
     def indices_created(self):
+        """Returns the number of indices created in the query"""
         return self._get_stat(INDICES_CREATED)
 
     @property
     def indices_deleted(self):
+        """Returns the number of indices deleted in the query"""
         return self._get_stat(INDICES_DELETED)
 
     @property
     def cached_execution(self):
+        """Returns whether or not the query execution plan was cached"""
         return self._get_stat(CACHED_EXECUTION) == 1
 
     @property
     def run_time_ms(self):
+        """Returns the server execution time of the query"""
         return self._get_stat(INTERNAL_EXECUTION_TIME)
diff --git a/tests/test_graph.py b/tests/test_graph.py
index 76f8794c18..526308c672 100644
--- a/tests/test_graph.py
+++ b/tests/test_graph.py
@@ -1,7 +1,24 @@
+from unittest.mock import patch
+
 import pytest
 
 from redis.commands.graph import Edge, Node, Path
 from redis.commands.graph.execution_plan import Operation
+from redis.commands.graph.query_result import (
+    CACHED_EXECUTION,
+    INDICES_CREATED,
+    INDICES_DELETED,
+    INTERNAL_EXECUTION_TIME,
+    LABELS_ADDED,
+    LABELS_REMOVED,
+    NODES_CREATED,
+    NODES_DELETED,
+    PROPERTIES_REMOVED,
+    PROPERTIES_SET,
+    RELATIONSHIPS_CREATED,
+    RELATIONSHIPS_DELETED,
+    QueryResult,
+)
 from redis.exceptions import ResponseError
 from tests.conftest import skip_if_redis_enterprise
 
@@ -575,3 +592,33 @@ def test_explain(client):
     assert result.structured_plan == expected
 
     redis_graph.delete()
+
+
+@pytest.mark.redismod
+def test_resultset_statistics(client):
+    with patch.object(target=QueryResult, attribute="_get_stat") as mock_get_stats:
+        result = client.graph().query("RETURN 1")
+        result.labels_added
+        mock_get_stats.assert_called_with(LABELS_ADDED)
+        result.labels_removed
+        mock_get_stats.assert_called_with(LABELS_REMOVED)
+        result.nodes_created
+        mock_get_stats.assert_called_with(NODES_CREATED)
+        result.nodes_deleted
+        mock_get_stats.assert_called_with(NODES_DELETED)
+        result.properties_set
+        mock_get_stats.assert_called_with(PROPERTIES_SET)
+        result.properties_removed
+        mock_get_stats.assert_called_with(PROPERTIES_REMOVED)
+        result.relationships_created
+        mock_get_stats.assert_called_with(RELATIONSHIPS_CREATED)
+        result.relationships_deleted
+        mock_get_stats.assert_called_with(RELATIONSHIPS_DELETED)
+        result.indices_created
+        mock_get_stats.assert_called_with(INDICES_CREATED)
+        result.indices_deleted
+        mock_get_stats.assert_called_with(INDICES_DELETED)
+        result.cached_execution
+        mock_get_stats.assert_called_with(CACHED_EXECUTION)
+        result.run_time_ms
+        mock_get_stats.assert_called_with(INTERNAL_EXECUTION_TIME)

From 3c4d96bcfa1758a2ffd7b1d913166f6f7ca107a5 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 27 Jul 2022 14:05:20 +0300
Subject: [PATCH 0544/1164] cleaning up the readme and moving docs into
 readthedocs (#2291)

* cleaning up the readme and moving docs into readthedocs

* examples at the end as per pr comments
---
 README.md                  | 1144 ++----------------------------------
 docs/advanced_features.rst |  436 ++++++++++++++
 docs/clustering.rst        |  242 ++++++++
 docs/index.rst             |    3 +
 docs/lua_scripting.rst     |  110 ++++
 redis/client.py            |    2 +
 6 files changed, 828 insertions(+), 1109 deletions(-)
 create mode 100644 docs/advanced_features.rst
 create mode 100644 docs/clustering.rst
 create mode 100644 docs/lua_scripting.rst

diff --git a/README.md b/README.md
index 4241da47dd..d4f324209a 100644
--- a/README.md
+++ b/README.md
@@ -27,18 +27,19 @@ To install redis-py, simply:
 $ pip install redis
 ```
 
-Looking for a high-level library to handle object mapping? See [redis-om-python](https://github.com/redis/redis-om-python)!
+For faster performance, install redis with hiredis support, this provides a compiled response parser, and *for most cases* requires zero code changes. By default, if hiredis is available, redis-py will attempt to use it for response parsing.
 
-redis-py requires a running Redis server.  Assuming you have docker
-```bash
-docker run -p 6379:6379 -it redis/redis-stack-server:latest
+``` bash
+$ pip install redis[hiredis]
 ```
 
-## Getting Started
+Looking for a high-level library to handle object mapping? See [redis-om-python](https://github.com/redis/redis-om-python)!
 
-redis-py supports Python 3.7+.
+## Usage
 
-``` pycon
+### Basic Example
+
+``` python
 >>> import redis
 >>> r = redis.Redis(host='localhost', port=6379, db=0)
 >>> r.set('foo', 'bar')
@@ -47,34 +48,34 @@ True
 b'bar'
 ```
 
-By default, all responses are returned as bytes in Python
-3.
+The above code connects to localhost on port 6379, sets a value in Redis, and retrieves it. All responses are returned as bytes in Python, to receive decoded strings, set *decode_responses=True*.  For this, and more connection options, see [these examples](https://redis.readthedocs.io/en/stable/examples.html)
 
-If **all** string responses from a client should be decoded, the user
-can specify *decode_responses=True* in
-```Redis.__init__```. In this case, any Redis command that
-returns a string type will be decoded with the encoding
-specified.
+### Connection Pools
 
-The default encoding is utf-8, but this can be customized by specifying the
-encoding argument for the redis.Redis class.
-The encoding will be used to automatically encode any
-strings passed to commands, such as key names and values.
+By default, redis-py uses a connection pool to manage connections. Each instance of of a Redis class receives its own connection pool. You can however define your own [redis.ConnectionPool](https://redis.readthedocs.io/en/stable/connections.html#connection-pools)
+
+``` python
+>>> pool = redis.ConnectionPool(host='localhost', port=6379, db=0)
+>>> r = redis.Redis(connection_pool=pool)
+```
 
-## API Reference
+Alternatively, you might want to look at [Async connections](https://redis.readthedocs.io/en/stable/examples/asyncio_examples.html), or [Cluster connections](https://redis.readthedocs.io/en/stable/connections.html#cluster-client), or even [Async Cluster connections](https://redis.readthedocs.io/en/stable/connections.html#async-cluster-client)
+
+### Redis Commands
+
+There is built-in support for all of the [out-of-the-box Redis commands](https://redis.io/commands). They are exposed using the raw Redis command names (`HSET`, `HGETALL`, etc.) except where a work (i.e del) is reserved by the language. The complete set of commands can be found [here](https://github.com/redis/redis-py/tree/master/redis/commands), or [the documentation](https://redis.readthedocs.io/en/stable/commands.html).
+
+## Advanced Topics
 
 The [official Redis command documentation](https://redis.io/commands)
 does a great job of explaining each command in detail. redis-py attempts
 to adhere to the official command syntax. There are a few exceptions:
 
--   **SELECT**: Not implemented. See the explanation in the Thread
-    Safety section below.
--   **DEL**: *del* is a reserved keyword in the Python syntax.
-    Therefore redis-py uses *delete* instead.
 -   **MULTI/EXEC**: These are implemented as part of the Pipeline class.
     The pipeline is wrapped with the MULTI and EXEC statements by
     default when it is executed, which can be disabled by specifying
     transaction=False. See more about Pipelines below.
+
 -   **SUBSCRIBE/LISTEN**: Similar to pipelines, PubSub is implemented as
     a separate class as it places the underlying connection in a state
     where it can\'t execute non-pubsub commands. Calling the pubsub
@@ -83,1112 +84,37 @@ to adhere to the official command syntax. There are a few exceptions:
     PUBLISH from the Redis client (see [this comment on issue
     #151](https://github.com/redis/redis-py/issues/151#issuecomment-1545015)
     for details).
--   **SCAN/SSCAN/HSCAN/ZSCAN**: The *SCAN commands are implemented as
-    they exist in the Redis documentation. In addition, each command has
-    an equivalent iterator method. These are purely for convenience so
-    the user doesn't have to keep track of the cursor while iterating.
-    Use the scan_iter/sscan_iter/hscan_iter/zscan_iter methods for this
-    behavior.
-
-## Connecting to Redis
-
-### Client Classes: Redis and StrictRedis
-
-redis-py 3.0 drops support for the legacy *Redis* client class.
-*StrictRedis* has been renamed to *Redis* and an alias named
-*StrictRedis* is provided so that users previously using
-*StrictRedis* can continue to run unchanged.
-
-The 2.X *Redis* class provided alternative implementations of a few
-commands. This confused users (rightfully so) and caused a number of
-support issues. To make things easier going forward, it was decided to
-drop support for these alternate implementations and instead focus on a
-single client class.
-
-2.X users that are already using StrictRedis don\'t have to change the
-class name. StrictRedis will continue to work for the foreseeable
-future.
-
-2.X users that are using the Redis class will have to make changes if
-they use any of the following commands:
-
--   SETEX: The argument order has changed. The new order is (name, time,
-    value).
--   LREM: The argument order has changed. The new order is (name, num,
-    value).
--   TTL and PTTL: The return value is now always an int and matches the
-    official Redis command (>0 indicates the timeout, -1 indicates that
-    the key exists but that it has no expire time set, -2 indicates that
-    the key does not exist)
-
-
-### Connection Pools
-
-Behind the scenes, redis-py uses a connection pool to manage connections
-to a Redis server. By default, each Redis instance you create will in
-turn create its own connection pool. You can override this behavior and
-use an existing connection pool by passing an already created connection
-pool instance to the connection_pool argument of the Redis class. You
-may choose to do this in order to implement client side sharding or have
-fine-grain control of how connections are managed.
-
-``` pycon
->>> pool = redis.ConnectionPool(host='localhost', port=6379, db=0)
->>> r = redis.Redis(connection_pool=pool)
-```
-
-### Connections
-
-ConnectionPools manage a set of Connection instances. redis-py ships
-with two types of Connections. The default, Connection, is a normal TCP
-socket based connection. The UnixDomainSocketConnection allows for
-clients running on the same device as the server to connect via a unix
-domain socket. To use a UnixDomainSocketConnection connection, simply
-pass the unix_socket_path argument, which is a string to the unix domain
-socket file. Additionally, make sure the unixsocket parameter is defined
-in your redis.conf file. It\'s commented out by default.
-
-``` pycon
->>> r = redis.Redis(unix_socket_path='/tmp/redis.sock')
-```
-
-You can create your own Connection subclasses as well. This may be
-useful if you want to control the socket behavior within an async
-framework. To instantiate a client class using your own connection, you
-need to create a connection pool, passing your class to the
-connection_class argument. Other keyword parameters you pass to the pool
-will be passed to the class specified during initialization.
-
-``` pycon
->>> pool = redis.ConnectionPool(connection_class=YourConnectionClass,
-                                your_arg='...', ...)
-```
-
-Connections maintain an open socket to the Redis server. Sometimes these
-sockets are interrupted or disconnected for a variety of reasons. For
-example, network appliances, load balancers and other services that sit
-between clients and servers are often configured to kill connections
-that remain idle for a given threshold.
-
-When a connection becomes disconnected, the next command issued on that
-connection will fail and redis-py will raise a ConnectionError to the
-caller. This allows each application that uses redis-py to handle errors
-in a way that\'s fitting for that specific application. However,
-constant error handling can be verbose and cumbersome, especially when
-socket disconnections happen frequently in many production environments.
-
-To combat this, redis-py can issue regular health checks to assess the
-liveliness of a connection just before issuing a command. Users can pass
-`health_check_interval=N` to the Redis or ConnectionPool classes or as a
-query argument within a Redis URL. The value of `health_check_interval`
-must be an integer. A value of `0`, the default, disables health checks.
-Any positive integer will enable health checks. Health checks are
-performed just before a command is executed if the underlying connection
-has been idle for more than `health_check_interval` seconds. For
-example, `health_check_interval=30` will ensure that a health check is
-run on any connection that has been idle for 30 or more seconds just
-before a command is executed on that connection.
-
-If your application is running in an environment that disconnects idle
-connections after 30 seconds you should set the `health_check_interval`
-option to a value less than 30.
-
-This option also works on any PubSub connection that is created from a
-client with `health_check_interval` enabled. PubSub users need to ensure
-that *get_message()* or `listen()` are called more frequently than
-`health_check_interval` seconds. It is assumed that most workloads
-already do this.
-
-If your PubSub use case doesn\'t call `get_message()` or `listen()`
-frequently, you should call `pubsub.check_health()` explicitly on a
-regularly basis.
-
-### SSL Connections
-
-redis-py 3.0 changes the default value of the
-ssl_cert_reqs option from None to
-\'required\'. See [Issue
-1016](https://github.com/redis/redis-py/issues/1016). This change
-enforces hostname validation when accepting a cert from a remote SSL
-terminator. If the terminator doesn\'t properly set the hostname on the
-cert this will cause redis-py 3.0 to raise a ConnectionError.
-
-This check can be disabled by setting ssl_cert_reqs to
-None. Note that doing so removes the security check. Do so
-at your own risk.
-
-Example with hostname verification using a local certificate bundle
-(linux):
-
-``` pycon
->>> import redis
->>> r = redis.Redis(host='xxxxxx.cache.amazonaws.com', port=6379, db=0,
-                    ssl=True,
-                    ssl_ca_certs='/etc/ssl/certs/ca-certificates.crt')
->>> r.set('foo', 'bar')
-True
->>> r.get('foo')
-b'bar'
-```
-
-Example with hostname verification using
-[certifi](https://pypi.org/project/certifi/):
-
-``` pycon
->>> import redis, certifi
->>> r = redis.Redis(host='xxxxxx.cache.amazonaws.com', port=6379, db=0,
-                    ssl=True, ssl_ca_certs=certifi.where())
->>> r.set('foo', 'bar')
-True
->>> r.get('foo')
-b'bar'
-```
-
-Example turning off hostname verification (not recommended):
-
-``` pycon
->>> import redis
->>> r = redis.Redis(host='xxxxxx.cache.amazonaws.com', port=6379, db=0,
-                    ssl=True, ssl_cert_reqs=None)
->>> r.set('foo', 'bar')
-True
->>> r.get('foo')
-b'bar'
-```
-
-### Sentinel support
 
-redis-py can be used together with [Redis
-Sentinel](https://redis.io/topics/sentinel) to discover Redis nodes. You
-need to have at least one Sentinel daemon running in order to use
-redis-py's Sentinel support.
-
-Connecting redis-py to the Sentinel instance(s) is easy. You can use a
-Sentinel connection to discover the master and slaves network addresses:
-
-``` pycon
->>> from redis import Sentinel
->>> sentinel = Sentinel([('localhost', 26379)], socket_timeout=0.1)
->>> sentinel.discover_master('mymaster')
-('127.0.0.1', 6379)
->>> sentinel.discover_slaves('mymaster')
-[('127.0.0.1', 6380)]
-```
-
-To connect to a sentinel which uses SSL ([see SSL
-connections](#ssl-connections) for more examples of SSL configurations):
-
-``` pycon
->>> from redis import Sentinel
->>> sentinel = Sentinel([('localhost', 26379)],
-                        ssl=True,
-                        ssl_ca_certs='/etc/ssl/certs/ca-certificates.crt')
->>> sentinel.discover_master('mymaster')
-('127.0.0.1', 6379)
-```
-
-You can also create Redis client connections from a Sentinel instance.
-You can connect to either the master (for write operations) or a slave
-(for read-only operations).
-
-``` pycon
->>> master = sentinel.master_for('mymaster', socket_timeout=0.1)
->>> slave = sentinel.slave_for('mymaster', socket_timeout=0.1)
->>> master.set('foo', 'bar')
->>> slave.get('foo')
-b'bar'
-```
-
-The master and slave objects are normal Redis instances with their
-connection pool bound to the Sentinel instance. When a Sentinel backed
-client attempts to establish a connection, it first queries the Sentinel
-servers to determine an appropriate host to connect to. If no server is
-found, a MasterNotFoundError or SlaveNotFoundError is raised. Both
-exceptions are subclasses of ConnectionError.
-
-When trying to connect to a slave client, the Sentinel connection pool
-will iterate over the list of slaves until it finds one that can be
-connected to. If no slaves can be connected to, a connection will be
-established with the master.
-
-See [Guidelines for Redis clients with support for Redis
-Sentinel](https://redis.io/topics/sentinel-clients) to learn more about
-Redis Sentinel.
-
---------------------------
-
-### Parsers
-
-Parser classes provide a way to control how responses from the Redis
-server are parsed. redis-py ships with two parser classes, the
-PythonParser and the HiredisParser. By default, redis-py will attempt to
-use the HiredisParser if you have the hiredis module installed and will
-fallback to the PythonParser otherwise.
-
-Hiredis is a C library maintained by the core Redis team. Pieter
-Noordhuis was kind enough to create Python bindings. Using Hiredis can
-provide up to a 10x speed improvement in parsing responses from the
-Redis server. The performance increase is most noticeable when
-retrieving many pieces of data, such as from LRANGE or SMEMBERS
-operations.
-
-Hiredis is available on PyPI, and can be installed via pip just like
-redis-py.
-
-``` bash
-$ pip install hiredis
-```
-
-### Response Callbacks
-
-The client class uses a set of callbacks to cast Redis responses to the
-appropriate Python type. There are a number of these callbacks defined
-on the Redis client class in a dictionary called RESPONSE_CALLBACKS.
-
-Custom callbacks can be added on a per-instance basis using the
-set_response_callback method. This method accepts two arguments: a
-command name and the callback. Callbacks added in this manner are only
-valid on the instance the callback is added to. If you want to define or
-override a callback globally, you should make a subclass of the Redis
-client and add your callback to its RESPONSE_CALLBACKS class dictionary.
-
-Response callbacks take at least one parameter: the response from the
-Redis server. Keyword arguments may also be accepted in order to further
-control how to interpret the response. These keyword arguments are
-specified during the command\'s call to execute_command. The ZRANGE
-implementation demonstrates the use of response callback keyword
-arguments with its \"withscores\" argument.
-
-### Thread Safety
-
-Redis client instances can safely be shared between threads. Internally,
-connection instances are only retrieved from the connection pool during
-command execution, and returned to the pool directly after. Command
-execution never modifies state on the client instance.
-
-However, there is one caveat: the Redis SELECT command. The SELECT
-command allows you to switch the database currently in use by the
-connection. That database remains selected until another is selected or
-until the connection is closed. This creates an issue in that
-connections could be returned to the pool that are connected to a
-different database.
-
-As a result, redis-py does not implement the SELECT command on client
-instances. If you use multiple Redis databases within the same
-application, you should create a separate client instance (and possibly
-a separate connection pool) for each database.
-
-It is not safe to pass PubSub or Pipeline objects between threads.
+For more details, please see the documentation on [advanced topics page](https://redis.readthedocs.io/en/stable/advanced_features.html).
 
 ### Pipelines
 
-Pipelines are a subclass of the base Redis class that provide support
-for buffering multiple commands to the server in a single request. They
-can be used to dramatically increase the performance of groups of
-commands by reducing the number of back-and-forth TCP packets between
-the client and server.
+The following is a basic example of a [Redis pipeline](https://redis.io/docs/manual/pipelining/), a method to optimize round-trip calls, by batching Redis commands, and receiving their results as a list.
 
-Pipelines are quite simple to use:
 
-``` pycon
->>> r = redis.Redis(...)
->>> r.set('bing', 'baz')
->>> # Use the pipeline() method to create a pipeline instance
+``` python
 >>> pipe = r.pipeline()
->>> # The following SET commands are buffered
->>> pipe.set('foo', 'bar')
->>> pipe.get('bing')
->>> # the EXECUTE call sends all buffered commands to the server, returning
->>> # a list of responses, one for each command.
+>>> pipe.set('foo', 5)
+>>> pipe.set('bar', 18.5)
+>>> pipe.set('blee', "hello world!")
 >>> pipe.execute()
-[True, b'baz']
-```
-
-For ease of use, all commands being buffered into the pipeline return
-the pipeline object itself. Therefore calls can be chained like:
-
-``` pycon
->>> pipe.set('foo', 'bar').sadd('faz', 'baz').incr('auto_number').execute()
-[True, True, 6]
-```
-
-In addition, pipelines can also ensure the buffered commands are
-executed atomically as a group. This happens by default. If you want to
-disable the atomic nature of a pipeline but still want to buffer
-commands, you can turn off transactions.
-
-``` pycon
->>> pipe = r.pipeline(transaction=False)
-```
-
-A common issue occurs when requiring atomic transactions but needing to
-retrieve values in Redis prior for use within the transaction. For
-instance, let\'s assume that the INCR command didn\'t exist and we need
-to build an atomic version of INCR in Python.
-
-The completely naive implementation could GET the value, increment it in
-Python, and SET the new value back. However, this is not atomic because
-multiple clients could be doing this at the same time, each getting the
-same value from GET.
-
-Enter the WATCH command. WATCH provides the ability to monitor one or
-more keys prior to starting a transaction. If any of those keys change
-prior the execution of that transaction, the entire transaction will be
-canceled and a WatchError will be raised. To implement our own
-client-side INCR command, we could do something like this:
-
-``` pycon
->>> with r.pipeline() as pipe:
-...     while True:
-...         try:
-...             # put a WATCH on the key that holds our sequence value
-...             pipe.watch('OUR-SEQUENCE-KEY')
-...             # after WATCHing, the pipeline is put into immediate execution
-...             # mode until we tell it to start buffering commands again.
-...             # this allows us to get the current value of our sequence
-...             current_value = pipe.get('OUR-SEQUENCE-KEY')
-...             next_value = int(current_value) + 1
-...             # now we can put the pipeline back into buffered mode with MULTI
-...             pipe.multi()
-...             pipe.set('OUR-SEQUENCE-KEY', next_value)
-...             # and finally, execute the pipeline (the set command)
-...             pipe.execute()
-...             # if a WatchError wasn't raised during execution, everything
-...             # we just did happened atomically.
-...             break
-...        except WatchError:
-...             # another client must have changed 'OUR-SEQUENCE-KEY' between
-...             # the time we started WATCHing it and the pipeline's execution.
-...             # our best bet is to just retry.
-...             continue
-```
-
-Note that, because the Pipeline must bind to a single connection for the
-duration of a WATCH, care must be taken to ensure that the connection is
-returned to the connection pool by calling the reset() method. If the
-Pipeline is used as a context manager (as in the example above) reset()
-will be called automatically. Of course you can do this the manual way
-by explicitly calling reset():
-
-``` pycon
->>> pipe = r.pipeline()
->>> while True:
-...     try:
-...         pipe.watch('OUR-SEQUENCE-KEY')
-...         ...
-...         pipe.execute()
-...         break
-...     except WatchError:
-...         continue
-...     finally:
-...         pipe.reset()
-```
-
-A convenience method named \"transaction\" exists for handling all the
-boilerplate of handling and retrying watch errors. It takes a callable
-that should expect a single parameter, a pipeline object, and any number
-of keys to be WATCHed. Our client-side INCR command above can be written
-like this, which is much easier to read:
-
-``` pycon
->>> def client_side_incr(pipe):
-...     current_value = pipe.get('OUR-SEQUENCE-KEY')
-...     next_value = int(current_value) + 1
-...     pipe.multi()
-...     pipe.set('OUR-SEQUENCE-KEY', next_value)
->>>
->>> r.transaction(client_side_incr, 'OUR-SEQUENCE-KEY')
-[True]
+[True, True, True]
 ```
 
-Be sure to call pipe.multi() in the callable passed to
-Redis.transaction prior to any write commands.
+### PubSub
 
-### Publish / Subscribe
+The following example shows how to utilize [Redis Pub/Sub](https://redis.io/docs/manual/pubsub/) to subscribe to specific channels.
 
-redis-py includes a PubSub object that subscribes to
-channels and listens for new messages. Creating a PubSub
-object is easy.
-
-``` pycon
+``` python
 >>> r = redis.Redis(...)
 >>> p = r.pubsub()
-```
-
-Once a PubSub instance is created, channels and patterns
-can be subscribed to.
-
-``` pycon
 >>> p.subscribe('my-first-channel', 'my-second-channel', ...)
->>> p.psubscribe('my-*', ...)
-```
-
-The PubSub instance is now subscribed to those
-channels/patterns. The subscription confirmations can be seen by reading
-messages from the PubSub instance.
-
-``` pycon
 >>> p.get_message()
 {'pattern': None, 'type': 'subscribe', 'channel': b'my-second-channel', 'data': 1}
->>> p.get_message()
-{'pattern': None, 'type': 'subscribe', 'channel': b'my-first-channel', 'data': 2}
->>> p.get_message()
-{'pattern': None, 'type': 'psubscribe', 'channel': b'my-*', 'data': 3}
 ```
 
-Every message read from a PubSub instance will be a
-dictionary with the following keys.
 
--   **type**: One of the following: \'subscribe\', \'unsubscribe\',
-    \'psubscribe\', \'punsubscribe\', \'message\', \'pmessage\'
--   **channel**: The channel \[un\]subscribed to or the channel a
-    message was published to
--   **pattern**: The pattern that matched a published message\'s
-    channel. Will be None in all cases except for
-    \'pmessage\' types.
--   **data**: The message data. With \[un\]subscribe messages, this
-    value will be the number of channels and patterns the connection is
-    currently subscribed to. With \[p\]message messages, this value will
-    be the actual published message.
-
-Let\'s send a message now.
-
-``` pycon
-# the publish method returns the number matching channel and pattern
-# subscriptions. 'my-first-channel' matches both the 'my-first-channel'
-# subscription and the 'my-*' pattern subscription, so this message will
-# be delivered to 2 channels/patterns
->>> r.publish('my-first-channel', 'some data')
-2
->>> p.get_message()
-{'channel': b'my-first-channel', 'data': b'some data', 'pattern': None, 'type': 'message'}
->>> p.get_message()
-{'channel': b'my-first-channel', 'data': b'some data', 'pattern': b'my-*', 'type': 'pmessage'}
-```
-
-Unsubscribing works just like subscribing. If no arguments are passed to
-\[p\]unsubscribe, all channels or patterns will be unsubscribed from.
-
-``` pycon
->>> p.unsubscribe()
->>> p.punsubscribe('my-*')
->>> p.get_message()
-{'channel': b'my-second-channel', 'data': 2, 'pattern': None, 'type': 'unsubscribe'}
->>> p.get_message()
-{'channel': b'my-first-channel', 'data': 1, 'pattern': None, 'type': 'unsubscribe'}
->>> p.get_message()
-{'channel': b'my-*', 'data': 0, 'pattern': None, 'type': 'punsubscribe'}
-```
-
-redis-py also allows you to register callback functions to handle
-published messages. Message handlers take a single argument, the
-message, which is a dictionary just like the examples above. To
-subscribe to a channel or pattern with a message handler, pass the
-channel or pattern name as a keyword argument with its value being the
-callback function.
-
-When a message is read on a channel or pattern with a message handler,
-the message dictionary is created and passed to the message handler. In
-this case, a None value is returned from get_message()
-since the message was already handled.
-
-``` pycon
->>> def my_handler(message):
-...     print('MY HANDLER: ', message['data'])
->>> p.subscribe(**{'my-channel': my_handler})
-# read the subscribe confirmation message
->>> p.get_message()
-{'pattern': None, 'type': 'subscribe', 'channel': b'my-channel', 'data': 1}
->>> r.publish('my-channel', 'awesome data')
-1
-# for the message handler to work, we need tell the instance to read data.
-# this can be done in several ways (read more below). we'll just use
-# the familiar get_message() function for now
->>> message = p.get_message()
-MY HANDLER:  awesome data
-# note here that the my_handler callback printed the string above.
-# `message` is None because the message was handled by our handler.
->>> print(message)
-None
-```
-
-If your application is not interested in the (sometimes noisy)
-subscribe/unsubscribe confirmation messages, you can ignore them by
-passing ignore_subscribe_messages=True to
-r.pubsub(). This will cause all subscribe/unsubscribe
-messages to be read, but they won\'t bubble up to your application.
-
-``` pycon
->>> p = r.pubsub(ignore_subscribe_messages=True)
->>> p.subscribe('my-channel')
->>> p.get_message()  # hides the subscribe message and returns None
->>> r.publish('my-channel', 'my data')
-1
->>> p.get_message()
-{'channel': b'my-channel', 'data': b'my data', 'pattern': None, 'type': 'message'}
-```
-
-There are three different strategies for reading messages.
-
-The examples above have been using pubsub.get_message().
-Behind the scenes, get_message() uses the system\'s
-\'select\' module to quickly poll the connection\'s socket. If there\'s
-data available to be read, get_message() will read it,
-format the message and return it or pass it to a message handler. If
-there\'s no data to be read, get_message() will
-immediately return None. This makes it trivial to integrate into an
-existing event loop inside your application.
-
-``` pycon
->>> while True:
->>>     message = p.get_message()
->>>     if message:
->>>         # do something with the message
->>>     time.sleep(0.001)  # be nice to the system :)
-```
-
-Older versions of redis-py only read messages with
-pubsub.listen(). listen() is a generator that blocks until
-a message is available. If your application doesn\'t need to do anything
-else but receive and act on messages received from redis, listen() is an
-easy way to get up an running.
-
-``` pycon
->>> for message in p.listen():
-...     # do something with the message
-```
-
-The third option runs an event loop in a separate thread.
-pubsub.run_in_thread() creates a new thread and starts the
-event loop. The thread object is returned to the caller of
-[un_in_thread(). The caller can use the
-thread.stop() method to shut down the event loop and
-thread. Behind the scenes, this is simply a wrapper around
-get_message() that runs in a separate thread, essentially
-creating a tiny non-blocking event loop for you.
-run_in_thread() takes an optional sleep_time
-argument. If specified, the event loop will call
-time.sleep() with the value in each iteration of the loop.
-
-Note: Since we\'re running in a separate thread, there\'s no way to
-handle messages that aren\'t automatically handled with registered
-message handlers. Therefore, redis-py prevents you from calling
-run_in_thread() if you\'re subscribed to patterns or
-channels that don\'t have message handlers attached.
-
-``` pycon
->>> p.subscribe(**{'my-channel': my_handler})
->>> thread = p.run_in_thread(sleep_time=0.001)
-# the event loop is now running in the background processing messages
-# when it's time to shut it down...
->>> thread.stop()
-```
-
-run_in_thread also supports an optional exception handler,
-which lets you catch exceptions that occur within the worker thread and
-handle them appropriately. The exception handler will take as arguments
-the exception itself, the pubsub object, and the worker thread returned
-by run_in_thread.
-
-``` pycon
->>> p.subscribe(**{'my-channel': my_handler})
->>> def exception_handler(ex, pubsub, thread):
->>>     print(ex)
->>>     thread.stop()
->>>     thread.join(timeout=1.0)
->>>     pubsub.close()
->>> thread = p.run_in_thread(exception_handler=exception_handler)
-```
-
-A PubSub object adheres to the same encoding semantics as the client
-instance it was created from. Any channel or pattern that\'s unicode
-will be encoded using the charset specified on the client
-before being sent to Redis. If the client\'s
-decode_responses flag is set the False (the default), the
-\'channel\', \'pattern\' and \'data\' values in message dictionaries
-will be byte strings (str on Python 2, bytes on Python 3). If the
-client\'s decode_responses is True, then the \'channel\',
-\'pattern\' and \'data\' values will be automatically decoded to unicode
-strings using the client\'s charset.
-
-PubSub objects remember what channels and patterns they are subscribed
-to. In the event of a disconnection such as a network error or timeout,
-the PubSub object will re-subscribe to all prior channels and patterns
-when reconnecting. Messages that were published while the client was
-disconnected cannot be delivered. When you\'re finished with a PubSub
-object, call its .close() method to shutdown the
-connection.
-
-``` pycon
->>> p = r.pubsub()
->>> ...
->>> p.close()
-```
-
-The PUBSUB set of subcommands CHANNELS, NUMSUB and NUMPAT are also
-supported:
-
-``` pycon
->>> r.pubsub_channels()
-[b'foo', b'bar']
->>> r.pubsub_numsub('foo', 'bar')
-[(b'foo', 9001), (b'bar', 42)]
->>> r.pubsub_numsub('baz')
-[(b'baz', 0)]
->>> r.pubsub_numpat()
-1204
-```
-
-### Monitor
-
-redis-py includes a Monitor object that streams every
-command processed by the Redis server. Use listen() on the
-Monitor object to block until a command is received.
-
-``` pycon
->>> r = redis.Redis(...)
->>> with r.monitor() as m:
->>>     for command in m.listen():
->>>         print(command)
-```
-
-### Lua Scripting
-
-redis-py supports the EVAL, EVALSHA, and SCRIPT commands. However, there
-are a number of edge cases that make these commands tedious to use in
-real world scenarios. Therefore, redis-py exposes a Script object that
-makes scripting much easier to use. (RedisClusters have limited support for
-scripting.)
-
-To create a Script instance, use the register_script
-function on a client instance passing the Lua code as the first
-argument. register_script returns a Script instance that
-you can use throughout your code.
-
-The following trivial Lua script accepts two parameters: the name of a
-key and a multiplier value. The script fetches the value stored in the
-key, multiplies it with the multiplier value and returns the result.
-
-``` pycon
->>> r = redis.Redis()
->>> lua = """
-... local value = redis.call('GET', KEYS[1])
-... value = tonumber(value)
-... return value * ARGV[1]"""
->>> multiply = r.register_script(lua)
-```
-
-multiply is now a Script instance that is invoked by
-calling it like a function. Script instances accept the following
-optional arguments:
-
--   **keys**: A list of key names that the script will access. This
-    becomes the KEYS list in Lua.
--   **args**: A list of argument values. This becomes the ARGV list in
-    Lua.
--   **client**: A redis-py Client or Pipeline instance that will invoke
-    the script. If client isn\'t specified, the client that initially
-    created the Script instance (the one that
-    register_script was invoked from) will be used.
-
-Continuing the example from above:
-
-``` pycon
->>> r.set('foo', 2)
->>> multiply(keys=['foo'], args=[5])
-10
-```
-
-The value of key \'foo\' is set to 2. When multiply is invoked, the
-\'foo\' key is passed to the script along with the multiplier value of
-5. Lua executes the script and returns the result, 10.
-
-Script instances can be executed using a different client instance, even
-one that points to a completely different Redis server.
-
-``` pycon
->>> r2 = redis.Redis('redis2.example.com')
->>> r2.set('foo', 3)
->>> multiply(keys=['foo'], args=[5], client=r2)
-15
-```
-
-The Script object ensures that the Lua script is loaded into Redis\'s
-script cache. In the event of a NOSCRIPT error, it will load the script
-and retry executing it.
-
-Script objects can also be used in pipelines. The pipeline instance
-should be passed as the client argument when calling the script. Care is
-taken to ensure that the script is registered in Redis\'s script cache
-just prior to pipeline execution.
-
-``` pycon
->>> pipe = r.pipeline()
->>> pipe.set('foo', 5)
->>> multiply(keys=['foo'], args=[5], client=pipe)
->>> pipe.execute()
-[True, 25]
-```
-
-
-### Scan Iterators
-
-The \*SCAN commands introduced in Redis 2.8 can be cumbersome to use.
-While these commands are fully supported, redis-py also exposes the
-following methods that return Python iterators for convenience:
-scan_iter, hscan_iter,
-sscan_iter and zscan_iter.
-
-``` pycon
->>> for key, value in (('A', '1'), ('B', '2'), ('C', '3')):
-...     r.set(key, value)
->>> for key in r.scan_iter():
-...     print(key, r.get(key))
-A 1
-B 2
-C 3
-```
-
-### Cluster Mode
-
-redis-py now supports cluster mode and provides a client for
-[Redis Cluster](<https://redis.io/topics/cluster-tutorial>).
-
-The cluster client is based on Grokzen's
-[redis-py-cluster](https://github.com/Grokzen/redis-py-cluster), has added bug
-fixes, and now supersedes that library. Support for these changes is thanks to
-his contributions.
-
-To learn more about Redis Cluster, see
-[Redis Cluster specifications](https://redis.io/topics/cluster-spec).
-
-**Create RedisCluster:**
-
-Connecting redis-py to a Redis Cluster instance(s) requires at a minimum a
-single node for cluster discovery. There are multiple ways in which a cluster
-instance can be created:
-
-- Using 'host' and 'port' arguments:
-
-``` pycon
->>> from redis.cluster import RedisCluster as Redis
->>> rc = Redis(host='localhost', port=6379)
->>> print(rc.get_nodes())
-    [[host=127.0.0.1,port=6379,name=127.0.0.1:6379,server_type=primary,redis_connection=Redis<ConnectionPool<Connection<host=127.0.0.1,port=6379,db=0>>>], [host=127.0.0.1,port=6378,name=127.0.0.1:6378,server_type=primary,redis_connection=Redis<ConnectionPool<Connection<host=127.0.0.1,port=6378,db=0>>>], [host=127.0.0.1,port=6377,name=127.0.0.1:6377,server_type=replica,redis_connection=Redis<ConnectionPool<Connection<host=127.0.0.1,port=6377,db=0>>>]]
-```
-- Using the Redis URL specification:
-
-``` pycon
->>> from redis.cluster import RedisCluster as Redis
->>> rc = Redis.from_url("redis://localhost:6379/0")
-```
-
-- Directly, via the ClusterNode class:
-
-``` pycon
->>> from redis.cluster import RedisCluster as Redis
->>> from redis.cluster import ClusterNode
->>> nodes = [ClusterNode('localhost', 6379), ClusterNode('localhost', 6378)]
->>> rc = Redis(startup_nodes=nodes)
-```
-
-When a RedisCluster instance is being created it first attempts to establish a
-connection to one of the provided startup nodes. If none of the startup nodes
-are reachable, a 'RedisClusterException' will be thrown.
-After a connection to the one of the cluster's nodes is established, the
-RedisCluster instance will be initialized with 3 caches:
-a slots cache which maps each of the 16384 slots to the node/s handling them,
-a nodes cache that contains ClusterNode objects (name, host, port, redis connection)
-for all of the cluster's nodes, and a commands cache contains all the server
-supported commands that were retrieved using the Redis 'COMMAND' output.
-See *RedisCluster specific options* below for more.
-
-RedisCluster instance can be directly used to execute Redis commands. When a
-command is being executed through the cluster instance, the target node(s) will
-be internally determined. When using a key-based command, the target node will
-be the node that holds the key's slot.
-Cluster management commands and other commands that are not key-based have a
-parameter called 'target_nodes' where you can specify which nodes to execute
-the command on. In the absence of target_nodes, the command will be executed
-on the default cluster node. As part of cluster instance initialization, the
-cluster's default node is randomly selected from the cluster's primaries, and
-will be updated upon reinitialization. Using r.get_default_node(), you can
-get the cluster's default node, or you can change it using the
-'set_default_node' method.
-
-The 'target_nodes' parameter is explained in the following section,
-'Specifying Target Nodes'.
-
-``` pycon
->>> # target-nodes: the node that holds 'foo1's key slot
->>> rc.set('foo1', 'bar1')
->>> # target-nodes: the node that holds 'foo2's key slot
->>> rc.set('foo2', 'bar2')
->>> # target-nodes: the node that holds 'foo1's key slot
->>> print(rc.get('foo1'))
-b'bar'
->>> # target-node: default-node
->>> print(rc.keys())
-[b'foo1']
->>> # target-node: default-node
->>> rc.ping()
-```
-
-**Specifying Target Nodes:**
-
-As mentioned above, all non key-based RedisCluster commands accept the kwarg
-parameter 'target_nodes' that specifies the node/nodes that the command should
-be executed on.
-The best practice is to specify target nodes using RedisCluster class's node
-flags: PRIMARIES, REPLICAS, ALL_NODES, RANDOM. When a nodes flag is passed
-along with a command, it will be internally resolved to the relevant node/s.
-If the nodes topology of the cluster changes during the execution of a command,
-the client will be able to resolve the nodes flag again with the new topology
-and attempt to retry executing the command.
-
-``` pycon
->>> from redis.cluster import RedisCluster as Redis
->>> # run cluster-meet command on all of the cluster's nodes
->>> rc.cluster_meet('127.0.0.1', 6379, target_nodes=Redis.ALL_NODES)
->>> # ping all replicas
->>> rc.ping(target_nodes=Redis.REPLICAS)
->>> # ping a random node
->>> rc.ping(target_nodes=Redis.RANDOM)
->>> # get the keys from all cluster nodes
->>> rc.keys(target_nodes=Redis.ALL_NODES)
-[b'foo1', b'foo2']
->>> # execute bgsave in all primaries
->>> rc.bgsave(Redis.PRIMARIES)
-```
-
-You could also pass ClusterNodes directly if you want to execute a command on a
-specific node / node group that isn't addressed by the nodes flag. However, if
-the command execution fails due to cluster topology changes, a retry attempt
-will not be made, since the passed target node/s may no longer be valid, and
-the relevant cluster or connection error will be returned.
-
-``` pycon
->>> node = rc.get_node('localhost', 6379)
->>> # Get the keys only for that specific node
->>> rc.keys(target_nodes=node)
->>> # get Redis info from a subset of primaries
->>> subset_primaries = [node for node in rc.get_primaries() if node.port > 6378]
->>> rc.info(target_nodes=subset_primaries)
-```
-
-In addition, the RedisCluster instance can query the Redis instance of a
-specific node and execute commands on that node directly. The Redis client,
-however, does not handle cluster failures and retries.
-
-``` pycon
->>> cluster_node = rc.get_node(host='localhost', port=6379)
->>> print(cluster_node)
-[host=127.0.0.1,port=6379,name=127.0.0.1:6379,server_type=primary,redis_connection=Redis<ConnectionPool<Connection<host=127.0.0.1,port=6379,db=0>>>]
->>> r = cluster_node.redis_connection
->>> r.client_list()
-[{'id': '276', 'addr': '127.0.0.1:64108', 'fd': '16', 'name': '', 'age': '0', 'idle': '0', 'flags': 'N', 'db': '0', 'sub': '0', 'psub': '0', 'multi': '-1', 'qbuf': '26', 'qbuf-free': '32742', 'argv-mem': '10', 'obl': '0', 'oll': '0', 'omem': '0', 'tot-mem': '54298', 'events': 'r', 'cmd': 'client', 'user': 'default'}]
->>> # Get the keys only for that specific node
->>> r.keys()
-[b'foo1']
-```
-
-**Multi-key commands:**
-
-Redis supports multi-key commands in Cluster Mode, such as Set type unions or
-intersections, mset and mget, as long as the keys all hash to the same slot.
-By using RedisCluster client, you can use the known functions (e.g. mget, mset)
-to perform an atomic multi-key operation. However, you must ensure all keys are
-mapped to the same slot, otherwise a RedisClusterException will be thrown.
-Redis Cluster implements a concept called hash tags that can be used in order
-to force certain keys to be stored in the same hash slot, see
-[Keys hash tag](https://redis.io/topics/cluster-spec#keys-hash-tags).
-You can also use nonatomic for some of the multikey operations, and pass keys
-that aren't mapped to the same slot. The client will then map the keys to the
-relevant slots, sending the commands to the slots' node owners. Non-atomic
-operations batch the keys according to their hash value, and then each batch is
-sent separately to the slot's owner.
-
-``` pycon
-# Atomic operations can be used when all keys are mapped to the same slot
->>> rc.mset({'{foo}1': 'bar1', '{foo}2': 'bar2'})
->>> rc.mget('{foo}1', '{foo}2')
-[b'bar1', b'bar2']
-# Non-atomic multi-key operations splits the keys into different slots
->>> rc.mset_nonatomic({'foo': 'value1', 'bar': 'value2', 'zzz': 'value3')
->>> rc.mget_nonatomic('foo', 'bar', 'zzz')
-[b'value1', b'value2', b'value3']
-```
-
-**Cluster PubSub:**
-
-When a ClusterPubSub instance is created without specifying a node, a single
-node will be transparently chosen for the pubsub connection on the
-first command execution. The node will be determined by:
- 1. Hashing the channel name in the request to find its keyslot
- 2. Selecting a node that handles the keyslot: If read_from_replicas is
-    set to true, a replica can be selected.
-
-*Known limitations with pubsub:*
-
-Pattern subscribe and publish do not currently work properly due to key slots.
-If we hash a pattern like fo* we will receive a keyslot for that string but
-there are endless possibilities for channel names based on this pattern -
-unknowable in advance. This feature is not disabled but the commands are not
-currently recommended for use.
-See [redis-py-cluster documentation](https://redis-py-cluster.readthedocs.io/en/stable/pubsub.html)
- for more.
-
-``` pycon
->>> p1 = rc.pubsub()
-# p1 connection will be set to the node that holds 'foo' keyslot
->>> p1.subscribe('foo')
-# p2 connection will be set to node 'localhost:6379'
->>> p2 = rc.pubsub(rc.get_node('localhost', 6379))
-```
-
-**Read Only Mode**
-
-By default, Redis Cluster always returns MOVE redirection response on accessing
-a replica node. You can overcome this limitation and scale read commands by
-triggering READONLY mode.
-
-To enable READONLY mode pass read_from_replicas=True to RedisCluster
-constructor. When set to true, read commands will be assigned between the
-primary and its replications in a Round-Robin manner.
-
-READONLY mode can be set at runtime by calling the readonly() method with
-target_nodes='replicas', and read-write access can be restored by calling the
-readwrite() method.
-
-``` pycon
->>> from cluster import RedisCluster as Redis
-# Use 'debug' log level to print the node that the command is executed on
->>> rc_readonly = Redis(startup_nodes=startup_nodes,
-...                     read_from_replicas=True)
->>> rc_readonly.set('{foo}1', 'bar1')
->>> for i in range(0, 4):
-...     # Assigns read command to the slot's hosts in a Round-Robin manner
-...     rc_readonly.get('{foo}1')
-# set command would be directed only to the slot's primary node
->>> rc_readonly.set('{foo}2', 'bar2')
-# reset READONLY flag
->>> rc_readonly.readwrite(target_nodes='replicas')
-# now the get command would be directed only to the slot's primary node
->>> rc_readonly.get('{foo}1')
-```
-
-**Cluster Pipeline**
-
-ClusterPipeline is a subclass of RedisCluster that provides support for Redis
-pipelines in cluster mode.
-When calling the execute() command, all the commands are grouped by the node
-on which they will be executed, and are then executed by the respective nodes
-in parallel. The pipeline instance will wait for all the nodes to respond
-before returning the result to the caller. Command responses are returned as a
-list sorted in the same order in which they were sent.
-Pipelines can be used to dramatically increase the throughput of Redis Cluster
-by significantly reducing the the number of network round trips between the
-client and the server.
-
-``` pycon
->>> with rc.pipeline() as pipe:
-...     pipe.set('foo', 'value1')
-...     pipe.set('bar', 'value2')
-...     pipe.get('foo')
-...     pipe.get('bar')
-...     print(pipe.execute())
-[True, True, b'value1', b'value2']
-...     pipe.set('foo1', 'bar1').get('foo1').execute()
-[True, b'bar1']
-```
-
-Please note:
-- RedisCluster pipelines currently only support key-based commands.
-- The pipeline gets its 'read_from_replicas' value from the cluster's parameter.
-Thus, if read from replications is enabled in the cluster instance, the pipeline
-will also direct read commands to replicas.
-- The 'transaction' option is NOT supported in cluster-mode. In non-cluster mode,
-the 'transaction' option is available when executing pipelines. This wraps the
-pipeline commands with MULTI/EXEC commands, and effectively turns the pipeline
-commands into a single transaction block. This means that all commands are
-executed sequentially without any interruptions from other clients. However,
-in cluster-mode this is not possible, because commands are partitioned
-according to their respective destination nodes. This means that we can not
-turn the pipeline commands into one transaction block, because in most cases
-they are split up into several smaller pipelines.
-
-**Lua Scripting in Cluster Mode**
-
-Cluster mode has limited support for lua scripting.
-
-The following commands are supported, with caveats:
-- `EVAL` and `EVALSHA`: The command is sent to the relevant node, depending on
-the keys (i.e., in `EVAL "<script>" num_keys key_1 ... key_n ...`). The keys
-_must_ all be on the same node. If the script requires 0 keys, _the command is
-sent to a random (primary) node_.
-- `SCRIPT EXISTS`: The command is sent to all primaries. The result is a list
-of booleans corresponding to the input SHA hashes. Each boolean is an AND of
-"does the script exist on each node?". In other words, each boolean is True iff
-the script exists on all nodes.
-- `SCRIPT FLUSH`: The command is sent to all primaries. The result is a bool
-AND over all nodes' responses.
-- `SCRIPT LOAD`: The command is sent to all primaries. The result is the SHA1
-digest.
-
-The following commands are not supported:
-- `EVAL_RO`
-- `EVALSHA_RO`
-
-Using scripting within pipelines in cluster mode is **not supported**.
-
-
-**RedisCluster specific options**
-
- require_full_coverage: (default=False)
-
-    When set to False (default value): the client will not require a
-    full coverage of the slots. However, if not all slots are covered,
-    and at least one node has 'cluster-require-full-coverage' set to
-    'yes,' the server will throw a ClusterDownError for some key-based
-    commands. See -
-    https://redis.io/topics/cluster-tutorial#redis-cluster-configuration-parameters
-    When set to True: all slots must be covered to construct the
-    cluster client. If not all slots are covered, RedisClusterException
-    will be thrown.
-
- read_from_replicas: (default=False)
-
-     Enable read from replicas in READONLY mode. You can read possibly
-     stale data.
-     When set to true, read commands will be assigned between the
-     primary and its replications in a Round-Robin manner.
-
- dynamic_startup_nodes: (default=True)
-
-     Set the RedisCluster's startup nodes to all of the discovered nodes.
-     If true, the cluster's discovered nodes will be used to determine the
-     cluster nodes-slots mapping in the next topology refresh.
-     It will remove the initial passed startup nodes if their endpoints aren't
-     listed in the CLUSTER SLOTS output.
-     If you use dynamic DNS endpoints for startup nodes but CLUSTER SLOTS lists
-     specific IP addresses, it is best to set it to false.
-
- cluster_error_retry_attempts: (default=3)
-
-     Retry command execution attempts when encountering ClusterDownError
-     or ConnectionError
-
- reinitialize_steps: (default=10)
-
-    Specifies the number of MOVED errors that need to occur before
-    reinitializing the whole cluster topology. If a MOVED error occurs
-    and the cluster does not need to be reinitialized on this current
-    error handling, only the MOVED slot will be patched with the
-    redirected node.
-    To reinitialize the cluster on every MOVED error, set
-    reinitialize_steps to 1.
-    To avoid reinitializing the cluster on moved errors, set
-    reinitialize_steps to 0.
+--------------------------
 
 ### Author
 
diff --git a/docs/advanced_features.rst b/docs/advanced_features.rst
new file mode 100644
index 0000000000..4ad922fe72
--- /dev/null
+++ b/docs/advanced_features.rst
@@ -0,0 +1,436 @@
+Advanced Features
+=================
+
+A note about threading
+----------------------
+
+Redis client instances can safely be shared between threads. Internally,
+connection instances are only retrieved from the connection pool during
+command execution, and returned to the pool directly after. Command
+execution never modifies state on the client instance.
+
+However, there is one caveat: the Redis SELECT command. The SELECT
+command allows you to switch the database currently in use by the
+connection. That database remains selected until another is selected or
+until the connection is closed. This creates an issue in that
+connections could be returned to the pool that are connected to a
+different database.
+
+As a result, redis-py does not implement the SELECT command on client
+instances. If you use multiple Redis databases within the same
+application, you should create a separate client instance (and possibly
+a separate connection pool) for each database.
+
+It is not safe to pass PubSub or Pipeline objects between threads.
+
+Pipelines
+---------
+
+Default pipelines
+~~~~~~~~~~~~~~~~~
+
+Pipelines are a subclass of the base Redis class that provide support
+for buffering multiple commands to the server in a single request. They
+can be used to dramatically increase the performance of groups of
+commands by reducing the number of back-and-forth TCP packets between
+the client and server.
+
+Pipelines are quite simple to use:
+
+.. code:: pycon
+
+   >>> r = redis.Redis(...)
+   >>> r.set('bing', 'baz')
+   >>> # Use the pipeline() method to create a pipeline instance
+   >>> pipe = r.pipeline()
+   >>> # The following SET commands are buffered
+   >>> pipe.set('foo', 'bar')
+   >>> pipe.get('bing')
+   >>> # the EXECUTE call sends all buffered commands to the server, returning
+   >>> # a list of responses, one for each command.
+   >>> pipe.execute()
+   [True, b'baz']
+
+For ease of use, all commands being buffered into the pipeline return
+the pipeline object itself. Therefore calls can be chained like:
+
+.. code:: pycon
+
+   >>> pipe.set('foo', 'bar').sadd('faz', 'baz').incr('auto_number').execute()
+   [True, True, 6]
+
+In addition, pipelines can also ensure the buffered commands are
+executed atomically as a group. This happens by default. If you want to
+disable the atomic nature of a pipeline but still want to buffer
+commands, you can turn off transactions.
+
+.. code:: pycon
+
+   >>> pipe = r.pipeline(transaction=False)
+
+A common issue occurs when requiring atomic transactions but needing to
+retrieve values in Redis prior for use within the transaction. For
+instance, let's assume that the INCR command didn't exist and we need to
+build an atomic version of INCR in Python.
+
+The completely naive implementation could GET the value, increment it in
+Python, and SET the new value back. However, this is not atomic because
+multiple clients could be doing this at the same time, each getting the
+same value from GET.
+
+Enter the WATCH command. WATCH provides the ability to monitor one or
+more keys prior to starting a transaction. If any of those keys change
+prior the execution of that transaction, the entire transaction will be
+canceled and a WatchError will be raised. To implement our own
+client-side INCR command, we could do something like this:
+
+.. code:: pycon
+
+   >>> with r.pipeline() as pipe:
+   ...     while True:
+   ...         try:
+   ...             # put a WATCH on the key that holds our sequence value
+   ...             pipe.watch('OUR-SEQUENCE-KEY')
+   ...             # after WATCHing, the pipeline is put into immediate execution
+   ...             # mode until we tell it to start buffering commands again.
+   ...             # this allows us to get the current value of our sequence
+   ...             current_value = pipe.get('OUR-SEQUENCE-KEY')
+   ...             next_value = int(current_value) + 1
+   ...             # now we can put the pipeline back into buffered mode with MULTI
+   ...             pipe.multi()
+   ...             pipe.set('OUR-SEQUENCE-KEY', next_value)
+   ...             # and finally, execute the pipeline (the set command)
+   ...             pipe.execute()
+   ...             # if a WatchError wasn't raised during execution, everything
+   ...             # we just did happened atomically.
+   ...             break
+   ...        except WatchError:
+   ...             # another client must have changed 'OUR-SEQUENCE-KEY' between
+   ...             # the time we started WATCHing it and the pipeline's execution.
+   ...             # our best bet is to just retry.
+   ...             continue
+
+Note that, because the Pipeline must bind to a single connection for the
+duration of a WATCH, care must be taken to ensure that the connection is
+returned to the connection pool by calling the reset() method. If the
+Pipeline is used as a context manager (as in the example above) reset()
+will be called automatically. Of course you can do this the manual way
+by explicitly calling reset():
+
+.. code:: pycon
+
+   >>> pipe = r.pipeline()
+   >>> while True:
+   ...     try:
+   ...         pipe.watch('OUR-SEQUENCE-KEY')
+   ...         ...
+   ...         pipe.execute()
+   ...         break
+   ...     except WatchError:
+   ...         continue
+   ...     finally:
+   ...         pipe.reset()
+
+A convenience method named "transaction" exists for handling all the
+boilerplate of handling and retrying watch errors. It takes a callable
+that should expect a single parameter, a pipeline object, and any number
+of keys to be WATCHed. Our client-side INCR command above can be written
+like this, which is much easier to read:
+
+.. code:: pycon
+
+   >>> def client_side_incr(pipe):
+   ...     current_value = pipe.get('OUR-SEQUENCE-KEY')
+   ...     next_value = int(current_value) + 1
+   ...     pipe.multi()
+   ...     pipe.set('OUR-SEQUENCE-KEY', next_value)
+   >>>
+   >>> r.transaction(client_side_incr, 'OUR-SEQUENCE-KEY')
+   [True]
+
+Be sure to call pipe.multi() in the callable passed to Redis.transaction
+prior to any write commands.
+
+Pipelines in clusters
+~~~~~~~~~~~~~~~~~~~~~
+
+ClusterPipeline is a subclass of RedisCluster that provides support for
+Redis pipelines in cluster mode. When calling the execute() command, all
+the commands are grouped by the node on which they will be executed, and
+are then executed by the respective nodes in parallel. The pipeline
+instance will wait for all the nodes to respond before returning the
+result to the caller. Command responses are returned as a list sorted in
+the same order in which they were sent. Pipelines can be used to
+dramatically increase the throughput of Redis Cluster by significantly
+reducing the the number of network round trips between the client and
+the server.
+
+.. code:: pycon
+
+   >>> with rc.pipeline() as pipe:
+   ...     pipe.set('foo', 'value1')
+   ...     pipe.set('bar', 'value2')
+   ...     pipe.get('foo')
+   ...     pipe.get('bar')
+   ...     print(pipe.execute())
+   [True, True, b'value1', b'value2']
+   ...     pipe.set('foo1', 'bar1').get('foo1').execute()
+   [True, b'bar1']
+
+Please note: - RedisCluster pipelines currently only support key-based
+commands. - The pipeline gets its ‘read_from_replicas’ value from the
+cluster’s parameter. Thus, if read from replications is enabled in the
+cluster instance, the pipeline will also direct read commands to
+replicas. - The ‘transaction’ option is NOT supported in cluster-mode.
+In non-cluster mode, the ‘transaction’ option is available when
+executing pipelines. This wraps the pipeline commands with MULTI/EXEC
+commands, and effectively turns the pipeline commands into a single
+transaction block. This means that all commands are executed
+sequentially without any interruptions from other clients. However, in
+cluster-mode this is not possible, because commands are partitioned
+according to their respective destination nodes. This means that we can
+not turn the pipeline commands into one transaction block, because in
+most cases they are split up into several smaller pipelines.
+
+Publish / Subscribe
+-------------------
+
+redis-py includes a PubSub object that subscribes to channels and
+listens for new messages. Creating a PubSub object is easy.
+
+.. code:: pycon
+
+   >>> r = redis.Redis(...)
+   >>> p = r.pubsub()
+
+Once a PubSub instance is created, channels and patterns can be
+subscribed to.
+
+.. code:: pycon
+
+   >>> p.subscribe('my-first-channel', 'my-second-channel', ...)
+   >>> p.psubscribe('my-*', ...)
+
+The PubSub instance is now subscribed to those channels/patterns. The
+subscription confirmations can be seen by reading messages from the
+PubSub instance.
+
+.. code:: pycon
+
+   >>> p.get_message()
+   {'pattern': None, 'type': 'subscribe', 'channel': b'my-second-channel', 'data': 1}
+   >>> p.get_message()
+   {'pattern': None, 'type': 'subscribe', 'channel': b'my-first-channel', 'data': 2}
+   >>> p.get_message()
+   {'pattern': None, 'type': 'psubscribe', 'channel': b'my-*', 'data': 3}
+
+Every message read from a PubSub instance will be a dictionary with the
+following keys.
+
+-  **type**: One of the following: 'subscribe', 'unsubscribe',
+   'psubscribe', 'punsubscribe', 'message', 'pmessage'
+-  **channel**: The channel [un]subscribed to or the channel a message
+   was published to
+-  **pattern**: The pattern that matched a published message's channel.
+   Will be None in all cases except for 'pmessage' types.
+-  **data**: The message data. With [un]subscribe messages, this value
+   will be the number of channels and patterns the connection is
+   currently subscribed to. With [p]message messages, this value will be
+   the actual published message.
+
+Let's send a message now.
+
+.. code:: pycon
+
+   # the publish method returns the number matching channel and pattern
+   # subscriptions. 'my-first-channel' matches both the 'my-first-channel'
+   # subscription and the 'my-*' pattern subscription, so this message will
+   # be delivered to 2 channels/patterns
+   >>> r.publish('my-first-channel', 'some data')
+   2
+   >>> p.get_message()
+   {'channel': b'my-first-channel', 'data': b'some data', 'pattern': None, 'type': 'message'}
+   >>> p.get_message()
+   {'channel': b'my-first-channel', 'data': b'some data', 'pattern': b'my-*', 'type': 'pmessage'}
+
+Unsubscribing works just like subscribing. If no arguments are passed to
+[p]unsubscribe, all channels or patterns will be unsubscribed from.
+
+.. code:: pycon
+
+   >>> p.unsubscribe()
+   >>> p.punsubscribe('my-*')
+   >>> p.get_message()
+   {'channel': b'my-second-channel', 'data': 2, 'pattern': None, 'type': 'unsubscribe'}
+   >>> p.get_message()
+   {'channel': b'my-first-channel', 'data': 1, 'pattern': None, 'type': 'unsubscribe'}
+   >>> p.get_message()
+   {'channel': b'my-*', 'data': 0, 'pattern': None, 'type': 'punsubscribe'}
+
+redis-py also allows you to register callback functions to handle
+published messages. Message handlers take a single argument, the
+message, which is a dictionary just like the examples above. To
+subscribe to a channel or pattern with a message handler, pass the
+channel or pattern name as a keyword argument with its value being the
+callback function.
+
+When a message is read on a channel or pattern with a message handler,
+the message dictionary is created and passed to the message handler. In
+this case, a None value is returned from get_message() since the message
+was already handled.
+
+.. code:: pycon
+
+   >>> def my_handler(message):
+   ...     print('MY HANDLER: ', message['data'])
+   >>> p.subscribe(**{'my-channel': my_handler})
+   # read the subscribe confirmation message
+   >>> p.get_message()
+   {'pattern': None, 'type': 'subscribe', 'channel': b'my-channel', 'data': 1}
+   >>> r.publish('my-channel', 'awesome data')
+   1
+   # for the message handler to work, we need tell the instance to read data.
+   # this can be done in several ways (read more below). we'll just use
+   # the familiar get_message() function for now
+   >>> message = p.get_message()
+   MY HANDLER:  awesome data
+   # note here that the my_handler callback printed the string above.
+   # `message` is None because the message was handled by our handler.
+   >>> print(message)
+   None
+
+If your application is not interested in the (sometimes noisy)
+subscribe/unsubscribe confirmation messages, you can ignore them by
+passing ignore_subscribe_messages=True to r.pubsub(). This will cause
+all subscribe/unsubscribe messages to be read, but they won't bubble up
+to your application.
+
+.. code:: pycon
+
+   >>> p = r.pubsub(ignore_subscribe_messages=True)
+   >>> p.subscribe('my-channel')
+   >>> p.get_message()  # hides the subscribe message and returns None
+   >>> r.publish('my-channel', 'my data')
+   1
+   >>> p.get_message()
+   {'channel': b'my-channel', 'data': b'my data', 'pattern': None, 'type': 'message'}
+
+There are three different strategies for reading messages.
+
+The examples above have been using pubsub.get_message(). Behind the
+scenes, get_message() uses the system's 'select' module to quickly poll
+the connection's socket. If there's data available to be read,
+get_message() will read it, format the message and return it or pass it
+to a message handler. If there's no data to be read, get_message() will
+immediately return None. This makes it trivial to integrate into an
+existing event loop inside your application.
+
+.. code:: pycon
+
+   >>> while True:
+   >>>     message = p.get_message()
+   >>>     if message:
+   >>>         # do something with the message
+   >>>     time.sleep(0.001)  # be nice to the system :)
+
+Older versions of redis-py only read messages with pubsub.listen().
+listen() is a generator that blocks until a message is available. If
+your application doesn't need to do anything else but receive and act on
+messages received from redis, listen() is an easy way to get up an
+running.
+
+.. code:: pycon
+
+   >>> for message in p.listen():
+   ...     # do something with the message
+
+The third option runs an event loop in a separate thread.
+pubsub.run_in_thread() creates a new thread and starts the event loop.
+The thread object is returned to the caller of [un_in_thread(). The
+caller can use the thread.stop() method to shut down the event loop and
+thread. Behind the scenes, this is simply a wrapper around get_message()
+that runs in a separate thread, essentially creating a tiny non-blocking
+event loop for you. run_in_thread() takes an optional sleep_time
+argument. If specified, the event loop will call time.sleep() with the
+value in each iteration of the loop.
+
+Note: Since we're running in a separate thread, there's no way to handle
+messages that aren't automatically handled with registered message
+handlers. Therefore, redis-py prevents you from calling run_in_thread()
+if you're subscribed to patterns or channels that don't have message
+handlers attached.
+
+.. code:: pycon
+
+   >>> p.subscribe(**{'my-channel': my_handler})
+   >>> thread = p.run_in_thread(sleep_time=0.001)
+   # the event loop is now running in the background processing messages
+   # when it's time to shut it down...
+   >>> thread.stop()
+
+run_in_thread also supports an optional exception handler, which lets
+you catch exceptions that occur within the worker thread and handle them
+appropriately. The exception handler will take as arguments the
+exception itself, the pubsub object, and the worker thread returned by
+run_in_thread.
+
+.. code:: pycon
+
+   >>> p.subscribe(**{'my-channel': my_handler})
+   >>> def exception_handler(ex, pubsub, thread):
+   >>>     print(ex)
+   >>>     thread.stop()
+   >>>     thread.join(timeout=1.0)
+   >>>     pubsub.close()
+   >>> thread = p.run_in_thread(exception_handler=exception_handler)
+
+A PubSub object adheres to the same encoding semantics as the client
+instance it was created from. Any channel or pattern that's unicode will
+be encoded using the charset specified on the client before being sent
+to Redis. If the client's decode_responses flag is set the False (the
+default), the 'channel', 'pattern' and 'data' values in message
+dictionaries will be byte strings (str on Python 2, bytes on Python 3).
+If the client's decode_responses is True, then the 'channel', 'pattern'
+and 'data' values will be automatically decoded to unicode strings using
+the client's charset.
+
+PubSub objects remember what channels and patterns they are subscribed
+to. In the event of a disconnection such as a network error or timeout,
+the PubSub object will re-subscribe to all prior channels and patterns
+when reconnecting. Messages that were published while the client was
+disconnected cannot be delivered. When you're finished with a PubSub
+object, call its .close() method to shutdown the connection.
+
+.. code:: pycon
+
+   >>> p = r.pubsub()
+   >>> ...
+   >>> p.close()
+
+The PUBSUB set of subcommands CHANNELS, NUMSUB and NUMPAT are also
+supported:
+
+.. code:: pycon
+
+   >>> r.pubsub_channels()
+   [b'foo', b'bar']
+   >>> r.pubsub_numsub('foo', 'bar')
+   [(b'foo', 9001), (b'bar', 42)]
+   >>> r.pubsub_numsub('baz')
+   [(b'baz', 0)]
+   >>> r.pubsub_numpat()
+   1204
+
+Monitor
+~~~~~~~
+
+redis-py includes a Monitor object that streams every command processed
+by the Redis server. Use listen() on the Monitor object to block until a
+command is received.
+
+.. code:: pycon
+
+   >>> r = redis.Redis(...)
+   >>> with r.monitor() as m:
+   >>>     for command in m.listen():
+   >>>         print(command)
diff --git a/docs/clustering.rst b/docs/clustering.rst
new file mode 100644
index 0000000000..34cb7f1f69
--- /dev/null
+++ b/docs/clustering.rst
@@ -0,0 +1,242 @@
+Clustering
+==========
+
+redis-py now supports cluster mode and provides a client for `Redis
+Cluster <https://redis.io/topics/cluster-tutorial>`__.
+
+The cluster client is based on Grokzen’s
+`redis-py-cluster <https://github.com/Grokzen/redis-py-cluster>`__, has
+added bug fixes, and now supersedes that library. Support for these
+changes is thanks to his contributions.
+
+To learn more about Redis Cluster, see `Redis Cluster
+specifications <https://redis.io/topics/cluster-spec>`__.
+
+`Creating clusters <#creating-clusters>`__ \| `Specifying Target
+Nodes <#specifying-target-nodes>`__ \| `Multi-key
+Commands <#multi-key-commands>`__ \| `Known PubSub
+Limitations <#known-pubsub-limitations>`__
+
+Creating clusters
+-----------------
+
+Connecting redis-py to a Redis Cluster instance(s) requires at a minimum
+a single node for cluster discovery. There are multiple ways in which a
+cluster instance can be created:
+
+-  Using ‘host’ and ‘port’ arguments:
+
+.. code:: pycon
+
+   >>> from redis.cluster import RedisCluster as Redis
+   >>> rc = Redis(host='localhost', port=6379)
+   >>> print(rc.get_nodes())
+       [[host=127.0.0.1,port=6379,name=127.0.0.1:6379,server_type=primary,redis_connection=Redis<ConnectionPool<Connection<host=127.0.0.1,port=6379,db=0>>>], [host=127.0.0.1,port=6378,name=127.0.0.1:6378,server_type=primary,redis_connection=Redis<ConnectionPool<Connection<host=127.0.0.1,port=6378,db=0>>>], [host=127.0.0.1,port=6377,name=127.0.0.1:6377,server_type=replica,redis_connection=Redis<ConnectionPool<Connection<host=127.0.0.1,port=6377,db=0>>>]]
+
+-  Using the Redis URL specification:
+
+.. code:: pycon
+
+   >>> from redis.cluster import RedisCluster as Redis
+   >>> rc = Redis.from_url("redis://localhost:6379/0")
+
+-  Directly, via the ClusterNode class:
+
+.. code:: pycon
+
+   >>> from redis.cluster import RedisCluster as Redis
+   >>> from redis.cluster import ClusterNode
+   >>> nodes = [ClusterNode('localhost', 6379), ClusterNode('localhost', 6378)]
+   >>> rc = Redis(startup_nodes=nodes)
+
+When a RedisCluster instance is being created it first attempts to
+establish a connection to one of the provided startup nodes. If none of
+the startup nodes are reachable, a ‘RedisClusterException’ will be
+thrown. After a connection to the one of the cluster’s nodes is
+established, the RedisCluster instance will be initialized with 3
+caches: a slots cache which maps each of the 16384 slots to the node/s
+handling them, a nodes cache that contains ClusterNode objects (name,
+host, port, redis connection) for all of the cluster’s nodes, and a
+commands cache contains all the server supported commands that were
+retrieved using the Redis ‘COMMAND’ output. See *RedisCluster specific
+options* below for more.
+
+RedisCluster instance can be directly used to execute Redis commands.
+When a command is being executed through the cluster instance, the
+target node(s) will be internally determined. When using a key-based
+command, the target node will be the node that holds the key’s slot.
+Cluster management commands and other commands that are not key-based
+have a parameter called ‘target_nodes’ where you can specify which nodes
+to execute the command on. In the absence of target_nodes, the command
+will be executed on the default cluster node. As part of cluster
+instance initialization, the cluster’s default node is randomly selected
+from the cluster’s primaries, and will be updated upon reinitialization.
+Using r.get_default_node(), you can get the cluster’s default node, or
+you can change it using the ‘set_default_node’ method.
+
+The ‘target_nodes’ parameter is explained in the following section,
+‘Specifying Target Nodes’.
+
+.. code:: pycon
+
+   >>> # target-nodes: the node that holds 'foo1's key slot
+   >>> rc.set('foo1', 'bar1')
+   >>> # target-nodes: the node that holds 'foo2's key slot
+   >>> rc.set('foo2', 'bar2')
+   >>> # target-nodes: the node that holds 'foo1's key slot
+   >>> print(rc.get('foo1'))
+   b'bar'
+   >>> # target-node: default-node
+   >>> print(rc.keys())
+   [b'foo1']
+   >>> # target-node: default-node
+   >>> rc.ping()
+
+Specfiying Target Nodes
+-----------------------
+
+As mentioned above, all non key-based RedisCluster commands accept the
+kwarg parameter ‘target_nodes’ that specifies the node/nodes that the
+command should be executed on. The best practice is to specify target
+nodes using RedisCluster class’s node flags: PRIMARIES, REPLICAS,
+ALL_NODES, RANDOM. When a nodes flag is passed along with a command, it
+will be internally resolved to the relevant node/s. If the nodes
+topology of the cluster changes during the execution of a command, the
+client will be able to resolve the nodes flag again with the new
+topology and attempt to retry executing the command.
+
+.. code:: pycon
+
+   >>> from redis.cluster import RedisCluster as Redis
+   >>> # run cluster-meet command on all of the cluster's nodes
+   >>> rc.cluster_meet('127.0.0.1', 6379, target_nodes=Redis.ALL_NODES)
+   >>> # ping all replicas
+   >>> rc.ping(target_nodes=Redis.REPLICAS)
+   >>> # ping a random node
+   >>> rc.ping(target_nodes=Redis.RANDOM)
+   >>> # get the keys from all cluster nodes
+   >>> rc.keys(target_nodes=Redis.ALL_NODES)
+   [b'foo1', b'foo2']
+   >>> # execute bgsave in all primaries
+   >>> rc.bgsave(Redis.PRIMARIES)
+
+You could also pass ClusterNodes directly if you want to execute a
+command on a specific node / node group that isn’t addressed by the
+nodes flag. However, if the command execution fails due to cluster
+topology changes, a retry attempt will not be made, since the passed
+target node/s may no longer be valid, and the relevant cluster or
+connection error will be returned.
+
+.. code:: pycon
+
+   >>> node = rc.get_node('localhost', 6379)
+   >>> # Get the keys only for that specific node
+   >>> rc.keys(target_nodes=node)
+   >>> # get Redis info from a subset of primaries
+   >>> subset_primaries = [node for node in rc.get_primaries() if node.port > 6378]
+   >>> rc.info(target_nodes=subset_primaries)
+
+In addition, the RedisCluster instance can query the Redis instance of a
+specific node and execute commands on that node directly. The Redis
+client, however, does not handle cluster failures and retries.
+
+.. code:: pycon
+
+   >>> cluster_node = rc.get_node(host='localhost', port=6379)
+   >>> print(cluster_node)
+   [host=127.0.0.1,port=6379,name=127.0.0.1:6379,server_type=primary,redis_connection=Redis<ConnectionPool<Connection<host=127.0.0.1,port=6379,db=0>>>]
+   >>> r = cluster_node.redis_connection
+   >>> r.client_list()
+   [{'id': '276', 'addr': '127.0.0.1:64108', 'fd': '16', 'name': '', 'age': '0', 'idle': '0', 'flags': 'N', 'db': '0', 'sub': '0', 'psub': '0', 'multi': '-1', 'qbuf': '26', 'qbuf-free': '32742', 'argv-mem': '10', 'obl': '0', 'oll': '0', 'omem': '0', 'tot-mem': '54298', 'events': 'r', 'cmd': 'client', 'user': 'default'}]
+   >>> # Get the keys only for that specific node
+   >>> r.keys()
+   [b'foo1']
+
+Multi-key Commands
+------------------
+
+Redis supports multi-key commands in Cluster Mode, such as Set type
+unions or intersections, mset and mget, as long as the keys all hash to
+the same slot. By using RedisCluster client, you can use the known
+functions (e.g. mget, mset) to perform an atomic multi-key operation.
+However, you must ensure all keys are mapped to the same slot, otherwise
+a RedisClusterException will be thrown. Redis Cluster implements a
+concept called hash tags that can be used in order to force certain keys
+to be stored in the same hash slot, see `Keys hash
+tag <https://redis.io/topics/cluster-spec#keys-hash-tags>`__. You can
+also use nonatomic for some of the multikey operations, and pass keys
+that aren’t mapped to the same slot. The client will then map the keys
+to the relevant slots, sending the commands to the slots’ node owners.
+Non-atomic operations batch the keys according to their hash value, and
+then each batch is sent separately to the slot’s owner.
+
+.. code:: pycon
+
+   # Atomic operations can be used when all keys are mapped to the same slot
+   >>> rc.mset({'{foo}1': 'bar1', '{foo}2': 'bar2'})
+   >>> rc.mget('{foo}1', '{foo}2')
+   [b'bar1', b'bar2']
+   # Non-atomic multi-key operations splits the keys into different slots
+   >>> rc.mset_nonatomic({'foo': 'value1', 'bar': 'value2', 'zzz': 'value3')
+   >>> rc.mget_nonatomic('foo', 'bar', 'zzz')
+   [b'value1', b'value2', b'value3']
+
+**Cluster PubSub:**
+
+When a ClusterPubSub instance is created without specifying a node, a
+single node will be transparently chosen for the pubsub connection on
+the first command execution. The node will be determined by: 1. Hashing
+the channel name in the request to find its keyslot 2. Selecting a node
+that handles the keyslot: If read_from_replicas is set to true, a
+replica can be selected.
+
+Known PubSub Limitations
+------------------------
+
+Pattern subscribe and publish do not currently work properly due to key
+slots. If we hash a pattern like fo\* we will receive a keyslot for that
+string but there are endless possibilities for channel names based on
+this pattern - unknowable in advance. This feature is not disabled but
+the commands are not currently recommended for use. See
+`redis-py-cluster
+documentation <https://redis-py-cluster.readthedocs.io/en/stable/pubsub.html>`__
+for more.
+
+.. code:: pycon
+
+   >>> p1 = rc.pubsub()
+   # p1 connection will be set to the node that holds 'foo' keyslot
+   >>> p1.subscribe('foo')
+   # p2 connection will be set to node 'localhost:6379'
+   >>> p2 = rc.pubsub(rc.get_node('localhost', 6379))
+
+**Read Only Mode**
+
+By default, Redis Cluster always returns MOVE redirection response on
+accessing a replica node. You can overcome this limitation and scale
+read commands by triggering READONLY mode.
+
+To enable READONLY mode pass read_from_replicas=True to RedisCluster
+constructor. When set to true, read commands will be assigned between
+the primary and its replications in a Round-Robin manner.
+
+READONLY mode can be set at runtime by calling the readonly() method
+with target_nodes=‘replicas’, and read-write access can be restored by
+calling the readwrite() method.
+
+.. code:: pycon
+
+   >>> from cluster import RedisCluster as Redis
+   # Use 'debug' log level to print the node that the command is executed on
+   >>> rc_readonly = Redis(startup_nodes=startup_nodes,
+   ...                     read_from_replicas=True)
+   >>> rc_readonly.set('{foo}1', 'bar1')
+   >>> for i in range(0, 4):
+   ...     # Assigns read command to the slot's hosts in a Round-Robin manner
+   ...     rc_readonly.get('{foo}1')
+   # set command would be directed only to the slot's primary node
+   >>> rc_readonly.set('{foo}2', 'bar2')
+   # reset READONLY flag
+   >>> rc_readonly.readwrite(target_nodes='replicas')
+   # now the get command would be directed only to the slot's primary node
+   >>> rc_readonly.get('{foo}1')
diff --git a/docs/index.rst b/docs/index.rst
index 630bad4f55..7bcef53466 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -69,6 +69,9 @@ Module Documentation
    exceptions
    lock
    retry
+   advanced_features
+   clustering
+   lua_scripting
    examples
 
 Contributing
diff --git a/docs/lua_scripting.rst b/docs/lua_scripting.rst
new file mode 100644
index 0000000000..8276dad051
--- /dev/null
+++ b/docs/lua_scripting.rst
@@ -0,0 +1,110 @@
+Lua Scripting
+===
+
+`Lua Scripting <#lua-scripting-in-default-connections>`__ \|
+`Pipelines <#pipelines>`__ \| `Cluster mode <#cluster-mode>`__
+
+--------------
+
+Lua Scripting in default connections
+------------------------------------
+
+redis-py supports the EVAL, EVALSHA, and SCRIPT commands. However, there
+are a number of edge cases that make these commands tedious to use in
+real world scenarios. Therefore, redis-py exposes a Script object that
+makes scripting much easier to use. (RedisClusters have limited support
+for scripting.)
+
+To create a Script instance, use the register_script function on a
+client instance passing the Lua code as the first argument.
+register_script returns a Script instance that you can use throughout
+your code.
+
+The following trivial Lua script accepts two parameters: the name of a
+key and a multiplier value. The script fetches the value stored in the
+key, multiplies it with the multiplier value and returns the result.
+
+.. code:: pycon
+
+   >>> r = redis.Redis()
+   >>> lua = """
+   ... local value = redis.call('GET', KEYS[1])
+   ... value = tonumber(value)
+   ... return value * ARGV[1]"""
+   >>> multiply = r.register_script(lua)
+
+multiply is now a Script instance that is invoked by calling it like a
+function. Script instances accept the following optional arguments:
+
+-  **keys**: A list of key names that the script will access. This
+   becomes the KEYS list in Lua.
+-  **args**: A list of argument values. This becomes the ARGV list in
+   Lua.
+-  **client**: A redis-py Client or Pipeline instance that will invoke
+   the script. If client isn't specified, the client that initially
+   created the Script instance (the one that register_script was invoked
+   from) will be used.
+
+Continuing the example from above:
+
+.. code:: pycon
+
+   >>> r.set('foo', 2)
+   >>> multiply(keys=['foo'], args=[5])
+   10
+
+The value of key 'foo' is set to 2. When multiply is invoked, the 'foo'
+key is passed to the script along with the multiplier value of 5. Lua
+executes the script and returns the result, 10.
+
+Script instances can be executed using a different client instance, even
+one that points to a completely different Redis server.
+
+.. code:: pycon
+
+   >>> r2 = redis.Redis('redis2.example.com')
+   >>> r2.set('foo', 3)
+   >>> multiply(keys=['foo'], args=[5], client=r2)
+   15
+
+The Script object ensures that the Lua script is loaded into Redis's
+script cache. In the event of a NOSCRIPT error, it will load the script
+and retry executing it.
+
+Pipelines
+---------
+
+Script objects can also be used in pipelines. The pipeline instance
+should be passed as the client argument when calling the script. Care is
+taken to ensure that the script is registered in Redis's script cache
+just prior to pipeline execution.
+
+.. code:: pycon
+
+   >>> pipe = r.pipeline()
+   >>> pipe.set('foo', 5)
+   >>> multiply(keys=['foo'], args=[5], client=pipe)
+   >>> pipe.execute()
+   [True, 25]
+
+Cluster Mode
+------------
+
+Cluster mode has limited support for lua scripting.
+
+The following commands are supported, with caveats: - ``EVAL`` and
+``EVALSHA``: The command is sent to the relevant node, depending on the
+keys (i.e., in ``EVAL "<script>" num_keys key_1 ... key_n ...``). The
+keys *must* all be on the same node. If the script requires 0 keys, *the
+command is sent to a random (primary) node*. - ``SCRIPT EXISTS``: The
+command is sent to all primaries. The result is a list of booleans
+corresponding to the input SHA hashes. Each boolean is an AND of “does
+the script exist on each node?”. In other words, each boolean is True
+iff the script exists on all nodes. - ``SCRIPT FLUSH``: The command is
+sent to all primaries. The result is a bool AND over all nodes’
+responses. - ``SCRIPT LOAD``: The command is sent to all primaries. The
+result is the SHA1 digest.
+
+The following commands are not supported: - ``EVAL_RO`` - ``EVALSHA_RO``
+
+Using scripting within pipelines in cluster mode is **not supported**.
diff --git a/redis/client.py b/redis/client.py
index c63fb13326..035edb16be 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -850,6 +850,8 @@ class Redis(AbstractRedis, RedisModuleCommands, CoreCommands, SentinelCommands):
     the commands are sent and received to the Redis server. Based on
     configuration, an instance will either use a ConnectionPool, or
     Connection object to talk to redis.
+
+    It is not safe to pass PubSub or Pipeline objects between threads.
     """
 
     @classmethod

From f665bd306dc843cec3e8fa01d6f4061385d1812e Mon Sep 17 00:00:00 2001
From: Utkarsh Gupta <utkarshgupta137@gmail.com>
Date: Wed, 27 Jul 2022 16:35:35 +0530
Subject: [PATCH 0545/1164] async_cluster: fix max_connections/ssl & improve
 args (#2217)

* async_cluster: fix max_connections/ssl & improve args

- set proper connection_class if ssl = True
- pass max_connections/connection_class to ClusterNode
- recreate startup_nodes to properly initialize
- pass parser_class to Connection instead of changing it in on_connect
- only pass redis_connect_func if read_from_replicas = True
- add connection_error_retry_attempts parameter
- skip is_connected check in acquire_connection as it is already checked in send_packed_command

BREAKING:
- RedisCluster args except host & port are kw-only now
- RedisCluster will no longer accept unknown arguments
- RedisCluster will no longer accept url as an argument. Use RedisCluster.from_url
- RedisCluster.require_full_coverage defaults to True
- ClusterNode args except host, port, & server_type are kw-only now

* async_cluster: remove kw-only requirement from client

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/asyncio/cluster.py           | 377 +++++++++++++++--------------
 redis/cluster.py                   |   4 +-
 redis/exceptions.py                |   4 +
 tests/test_asyncio/test_cluster.py | 210 +++++++++++++---
 4 files changed, 380 insertions(+), 215 deletions(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 3fe3ebc47e..df0c17d49c 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -17,7 +17,13 @@
 )
 
 from redis.asyncio.client import ResponseCallbackT
-from redis.asyncio.connection import Connection, DefaultParser, Encoder, parse_url
+from redis.asyncio.connection import (
+    Connection,
+    DefaultParser,
+    Encoder,
+    SSLConnection,
+    parse_url,
+)
 from redis.asyncio.parser import CommandsParser
 from redis.client import EMPTY_RESPONSE, NEVER_DECODE, AbstractRedis
 from redis.cluster import (
@@ -42,6 +48,7 @@
     ConnectionError,
     DataError,
     MasterDownError,
+    MaxConnectionsError,
     MovedError,
     RedisClusterException,
     ResponseError,
@@ -56,44 +63,17 @@
     "TargetNodesT", str, "ClusterNode", List["ClusterNode"], Dict[Any, "ClusterNode"]
 )
 
-CONNECTION_ALLOWED_KEYS = (
-    "client_name",
-    "db",
-    "decode_responses",
-    "encoder_class",
-    "encoding",
-    "encoding_errors",
-    "health_check_interval",
-    "parser_class",
-    "password",
-    "redis_connect_func",
-    "retry",
-    "retry_on_timeout",
-    "socket_connect_timeout",
-    "socket_keepalive",
-    "socket_keepalive_options",
-    "socket_read_size",
-    "socket_timeout",
-    "socket_type",
-    "username",
-)
-
-
-def cleanup_kwargs(**kwargs: Any) -> Dict[str, Any]:
-    """Remove unsupported or disabled keys from kwargs."""
-    return {k: v for k, v in kwargs.items() if k in CONNECTION_ALLOWED_KEYS}
-
 
 class ClusterParser(DefaultParser):
     EXCEPTION_CLASSES = dict_merge(
         DefaultParser.EXCEPTION_CLASSES,
         {
             "ASK": AskError,
-            "TRYAGAIN": TryAgainError,
-            "MOVED": MovedError,
             "CLUSTERDOWN": ClusterDownError,
             "CROSSSLOT": ClusterCrossSlotError,
             "MASTERDOWN": MasterDownError,
+            "MOVED": MovedError,
+            "TRYAGAIN": TryAgainError,
         },
     )
 
@@ -104,7 +84,6 @@ class RedisCluster(AbstractRedis, AbstractRedisCluster, AsyncRedisClusterCommand
 
     Pass one of parameters:
 
-      - `url`
       - `host` & `port`
       - `startup_nodes`
 
@@ -128,9 +107,6 @@ class RedisCluster(AbstractRedis, AbstractRedisCluster, AsyncRedisClusterCommand
         | Port used if **host** is provided
     :param startup_nodes:
         | :class:`~.ClusterNode` to used as a startup node
-    :param cluster_error_retry_attempts:
-        | Retry command execution attempts when encountering :class:`~.ClusterDownError`
-          or :class:`~.ConnectionError`
     :param require_full_coverage:
         | When set to ``False``: the client will not require a full coverage of the
           slots. However, if not all slots are covered, and at least one node has
@@ -141,6 +117,10 @@ class RedisCluster(AbstractRedis, AbstractRedisCluster, AsyncRedisClusterCommand
           thrown.
         | See:
           https://redis.io/docs/manual/scaling/#redis-cluster-configuration-parameters
+    :param read_from_replicas:
+        | Enable read from replicas in READONLY mode. You can read possibly stale data.
+          When set to true, read commands will be assigned between the primary and
+          its replications in a Round-Robin manner.
     :param reinitialize_steps:
         | Specifies the number of MOVED errors that need to occur before reinitializing
           the whole cluster topology. If a MOVED error occurs and the cluster does not
@@ -149,23 +129,27 @@ class RedisCluster(AbstractRedis, AbstractRedisCluster, AsyncRedisClusterCommand
           To reinitialize the cluster on every MOVED error, set reinitialize_steps to 1.
           To avoid reinitializing the cluster on moved errors, set reinitialize_steps to
           0.
-    :param read_from_replicas:
-        | Enable read from replicas in READONLY mode. You can read possibly stale data.
-          When set to true, read commands will be assigned between the primary and
-          its replications in a Round-Robin manner.
-    :param url:
-        | See :meth:`.from_url`
-    :param kwargs:
-        | Extra arguments that will be passed to the
-          :class:`~redis.asyncio.connection.Connection` instances when created
+    :param cluster_error_retry_attempts:
+        | Number of times to retry before raising an error when :class:`~.TimeoutError`
+          or :class:`~.ConnectionError` or :class:`~.ClusterDownError` are encountered
+    :param connection_error_retry_attempts:
+        | Number of times to retry before reinitializing when :class:`~.TimeoutError`
+          or :class:`~.ConnectionError` are encountered
+    :param max_connections:
+        | Maximum number of connections per node. If there are no free connections & the
+          maximum number of connections are already created, a
+          :class:`~.MaxConnectionsError` is raised. This error may be retried as defined
+          by :attr:`connection_error_retry_attempts`
+
+    | Rest of the arguments will be passed to the
+      :class:`~redis.asyncio.connection.Connection` instances when created
 
     :raises RedisClusterException:
-        if any arguments are invalid. Eg:
+        if any arguments are invalid or unknown. Eg:
 
-        - db kwarg
-        - db != 0 in url
-        - unix socket connection
-        - none of host & url & startup_nodes were provided
+        - `db` != 0 or None
+        - `path` argument for unix socket connection
+        - none of the `host`/`port` & `startup_nodes` were provided
 
     """
 
@@ -178,7 +162,6 @@ def from_url(cls, url: str, **kwargs: Any) -> "RedisCluster":
 
             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:
 
@@ -186,32 +169,22 @@ def from_url(cls, url: str, **kwargs: Any) -> "RedisCluster":
           <https://www.iana.org/assignments/uri-schemes/prov/redis>
         - `rediss://` creates a SSL wrapped TCP socket connection. See more at:
           <https://www.iana.org/assignments/uri-schemes/prov/rediss>
-        - ``unix://``: creates a Unix Domain Socket connection.
-
-        The username, password, hostname, path and all querystring values
-        are passed through urllib.parse.unquote in order to replace any
-        percent-encoded values with their corresponding characters.
 
-        There are several ways to specify a database number. The first value
-        found will be used:
-
-            1. A ``db`` querystring option, e.g. redis://localhost?db=0
-            2. If using the redis:// or rediss:// schemes, the path argument
-               of the url, e.g. redis://localhost/0
-            3. A ``db`` keyword argument to this function.
-
-        If none of these options are specified, the default db=0 is used.
-
-        All querystring options are cast to their appropriate Python types.
-        Boolean arguments can be specified with string values "True"/"False"
-        or "Yes"/"No". Values that cannot be properly cast cause a
-        ``ValueError`` to be raised. Once parsed, the querystring arguments and
-        keyword arguments are passed to :class:`~redis.asyncio.connection.Connection`
-        when created. In the case of conflicting arguments, querystring
-        arguments always win.
+        The username, password, hostname, path and all querystring values are passed
+        through ``urllib.parse.unquote`` in order to replace any percent-encoded values
+        with their corresponding characters.
 
+        All querystring options are cast to their appropriate Python types. Boolean
+        arguments can be specified with string values "True"/"False" or "Yes"/"No".
+        Values that cannot be properly cast cause a ``ValueError`` to be raised. Once
+        parsed, the querystring arguments and keyword arguments are passed to
+        :class:`~redis.asyncio.connection.Connection` when created.
+        In the case of conflicting arguments, querystring arguments are used.
         """
-        return cls(url=url, **kwargs)
+        kwargs.update(parse_url(url))
+        if kwargs.pop("connection_class", None) is SSLConnection:
+            kwargs["ssl"] = True
+        return cls(**kwargs)
 
     __slots__ = (
         "_initialize",
@@ -219,6 +192,7 @@ def from_url(cls, url: str, **kwargs: Any) -> "RedisCluster":
         "cluster_error_retry_attempts",
         "command_flags",
         "commands_parser",
+        "connection_error_retry_attempts",
         "connection_kwargs",
         "encoder",
         "node_flags",
@@ -233,87 +207,131 @@ def from_url(cls, url: str, **kwargs: Any) -> "RedisCluster":
     def __init__(
         self,
         host: Optional[str] = None,
-        port: int = 6379,
+        port: Union[str, int] = 6379,
+        # Cluster related kwargs
         startup_nodes: Optional[List["ClusterNode"]] = None,
-        require_full_coverage: bool = False,
+        require_full_coverage: bool = True,
         read_from_replicas: bool = False,
-        cluster_error_retry_attempts: int = 3,
         reinitialize_steps: int = 10,
-        url: Optional[str] = None,
-        **kwargs: Any,
+        cluster_error_retry_attempts: int = 3,
+        connection_error_retry_attempts: int = 5,
+        max_connections: int = 2**31,
+        # Client related kwargs
+        db: Union[str, int] = 0,
+        path: Optional[str] = None,
+        username: Optional[str] = None,
+        password: Optional[str] = None,
+        client_name: Optional[str] = None,
+        # Encoding related kwargs
+        encoding: str = "utf-8",
+        encoding_errors: str = "strict",
+        decode_responses: bool = False,
+        # Connection related kwargs
+        health_check_interval: float = 0,
+        socket_connect_timeout: Optional[float] = None,
+        socket_keepalive: bool = False,
+        socket_keepalive_options: Optional[Mapping[int, Union[int, bytes]]] = None,
+        socket_timeout: Optional[float] = None,
+        # SSL related kwargs
+        ssl: bool = False,
+        ssl_ca_certs: Optional[str] = None,
+        ssl_ca_data: Optional[str] = None,
+        ssl_cert_reqs: str = "required",
+        ssl_certfile: Optional[str] = None,
+        ssl_check_hostname: bool = False,
+        ssl_keyfile: Optional[str] = None,
     ) -> None:
-        if not startup_nodes:
-            startup_nodes = []
+        if db:
+            raise RedisClusterException(
+                "Argument 'db' must be 0 or None in cluster mode"
+            )
 
-        if "db" in kwargs:
-            # Argument 'db' is not possible to use in cluster mode
+        if path:
             raise RedisClusterException(
-                "Argument 'db' is not possible to use in cluster mode"
+                "Unix domain socket is not supported in cluster mode"
             )
 
-        # Get the startup node(s)
-        if url:
-            url_options = parse_url(url)
-            if "path" in url_options:
-                raise RedisClusterException(
-                    "RedisCluster does not currently support Unix Domain "
-                    "Socket connections"
-                )
-            if "db" in url_options and url_options["db"] != 0:
-                # Argument 'db' is not possible to use in cluster mode
-                raise RedisClusterException(
-                    "A ``db`` querystring option can only be 0 in cluster mode"
-                )
-            kwargs.update(url_options)
-            host = kwargs.get("host")
-            port = kwargs.get("port", port)
-        elif (not host or not port) and not startup_nodes:
-            # No startup node was provided
+        if (not host or not port) and not startup_nodes:
             raise RedisClusterException(
-                "RedisCluster requires at least one node to discover the "
-                "cluster. Please provide one of the followings:\n"
-                "1. host and port, for example:\n"
-                " RedisCluster(host='localhost', port=6379)\n"
-                "2. list of startup nodes, for example:\n"
-                " RedisCluster(startup_nodes=[ClusterNode('localhost', 6379),"
-                " ClusterNode('localhost', 6378)])"
+                "RedisCluster requires at least one node to discover the cluster.\n"
+                "Please provide one of the following or use RedisCluster.from_url:\n"
+                '   - host and port: RedisCluster(host="localhost", port=6379)\n'
+                "   - startup_nodes: RedisCluster(startup_nodes=["
+                'ClusterNode("localhost", 6379), ClusterNode("localhost", 6380)])'
+            )
+
+        kwargs: Dict[str, Any] = {
+            "max_connections": max_connections,
+            "connection_class": Connection,
+            "parser_class": ClusterParser,
+            # Client related kwargs
+            "username": username,
+            "password": password,
+            "client_name": client_name,
+            # Encoding related kwargs
+            "encoding": encoding,
+            "encoding_errors": encoding_errors,
+            "decode_responses": decode_responses,
+            # Connection related kwargs
+            "health_check_interval": health_check_interval,
+            "socket_connect_timeout": socket_connect_timeout,
+            "socket_keepalive": socket_keepalive,
+            "socket_keepalive_options": socket_keepalive_options,
+            "socket_timeout": socket_timeout,
+        }
+
+        if ssl:
+            # SSL related kwargs
+            kwargs.update(
+                {
+                    "connection_class": SSLConnection,
+                    "ssl_ca_certs": ssl_ca_certs,
+                    "ssl_ca_data": ssl_ca_data,
+                    "ssl_cert_reqs": ssl_cert_reqs,
+                    "ssl_certfile": ssl_certfile,
+                    "ssl_check_hostname": ssl_check_hostname,
+                    "ssl_keyfile": ssl_keyfile,
+                }
             )
 
-        # Update the connection arguments
-        # Whenever a new connection is established, RedisCluster's on_connect
-        # method should be run
-        kwargs["redis_connect_func"] = self.on_connect
-        self.connection_kwargs = kwargs = cleanup_kwargs(**kwargs)
-        self.response_callbacks = kwargs[
-            "response_callbacks"
-        ] = self.__class__.RESPONSE_CALLBACKS.copy()
+        if read_from_replicas:
+            # Call our on_connect function to configure READONLY mode
+            kwargs["redis_connect_func"] = self.on_connect
+
+        kwargs["response_callbacks"] = self.__class__.RESPONSE_CALLBACKS.copy()
+        self.connection_kwargs = kwargs
+
+        if startup_nodes:
+            passed_nodes = []
+            for node in startup_nodes:
+                passed_nodes.append(
+                    ClusterNode(node.host, node.port, **self.connection_kwargs)
+                )
+            startup_nodes = passed_nodes
+        else:
+            startup_nodes = []
         if host and port:
             startup_nodes.append(ClusterNode(host, port, **self.connection_kwargs))
 
-        self.nodes_manager = NodesManager(
-            startup_nodes=startup_nodes,
-            require_full_coverage=require_full_coverage,
-            **self.connection_kwargs,
-        )
-        self.encoder = Encoder(
-            kwargs.get("encoding", "utf-8"),
-            kwargs.get("encoding_errors", "strict"),
-            kwargs.get("decode_responses", False),
-        )
-        self.cluster_error_retry_attempts = cluster_error_retry_attempts
+        self.nodes_manager = NodesManager(startup_nodes, require_full_coverage, kwargs)
+        self.encoder = Encoder(encoding, encoding_errors, decode_responses)
         self.read_from_replicas = read_from_replicas
         self.reinitialize_steps = reinitialize_steps
+        self.cluster_error_retry_attempts = cluster_error_retry_attempts
+        self.connection_error_retry_attempts = connection_error_retry_attempts
 
         self.reinitialize_counter = 0
         self.commands_parser = CommandsParser()
         self.node_flags = self.__class__.NODE_FLAGS.copy()
         self.command_flags = self.__class__.COMMAND_FLAGS.copy()
+        self.response_callbacks = kwargs["response_callbacks"]
         self.result_callbacks = self.__class__.RESULT_CALLBACKS.copy()
         self.result_callbacks[
             "CLUSTER SLOTS"
         ] = lambda cmd, res, **kwargs: parse_cluster_slots(
             list(res.values())[0], **kwargs
         )
+
         self._initialize = True
         self._lock = asyncio.Lock()
 
@@ -365,18 +383,16 @@ def __del__(self) -> None:
                 ...
 
     async def on_connect(self, connection: Connection) -> None:
-        connection.set_parser(ClusterParser)
         await connection.on_connect()
 
-        if self.read_from_replicas:
-            # Sending READONLY command to server to configure connection as
-            # readonly. Since each cluster node may change its server type due
-            # to a failover, we should establish a READONLY connection
-            # regardless of the server type. If this is a primary connection,
-            # READONLY would not affect executing write commands.
-            await connection.send_command("READONLY")
-            if str_if_bytes(await connection.read_response_without_lock()) != "OK":
-                raise ConnectionError("READONLY command failed")
+        # Sending READONLY command to server to configure connection as
+        # readonly. Since each cluster node may change its server type due
+        # to a failover, we should establish a READONLY connection
+        # regardless of the server type. If this is a primary connection,
+        # READONLY would not affect executing write commands.
+        await connection.send_command("READONLY")
+        if str_if_bytes(await connection.read_response_without_lock()) != "OK":
+            raise ConnectionError("READONLY command failed")
 
     def get_nodes(self) -> List["ClusterNode"]:
         """Get all nodes of the cluster."""
@@ -436,12 +452,12 @@ def get_node_from_key(
         slot_cache = self.nodes_manager.slots_cache.get(slot)
         if not slot_cache:
             raise SlotNotCoveredError(f'Slot "{slot}" is not covered by the cluster.')
-        if replica and len(self.nodes_manager.slots_cache[slot]) < 2:
-            return None
-        elif replica:
+
+        if replica:
+            if len(self.nodes_manager.slots_cache[slot]) < 2:
+                return None
             node_idx = 1
         else:
-            # primary
             node_idx = 0
 
         return slot_cache[node_idx]
@@ -638,14 +654,14 @@ async def execute_command(self, *args: EncodableT, **kwargs: Any) -> Any:
                             command, dict(zip(keys, values)), **kwargs
                         )
                     return dict(zip(keys, values))
-            except BaseException as e:
+            except Exception as e:
                 if type(e) in self.__class__.ERRORS_ALLOW_RETRY:
                     # The nodes and slots cache were reinitialized.
                     # Try again with the new cluster setup.
                     exception = e
                 else:
                     # All other errors should be raised.
-                    raise e
+                    raise
 
         # If it fails the configured number of times then raise exception back
         # to caller of this method
@@ -678,19 +694,30 @@ async def _execute_command(
                 return await target_node.execute_command(*args, **kwargs)
             except BusyLoadingError:
                 raise
-            except (ConnectionError, TimeoutError):
-                # Give the node 0.25 seconds to get back up and retry again
-                # with same node and configuration. After 5 attempts then try
-                # to reinitialize the cluster and see if the nodes
-                # configuration has changed or not
+            except (ConnectionError, TimeoutError) as e:
+                # Give the node 0.25 seconds to get back up and retry again with the
+                # same node and configuration. After the defined number of attempts, try
+                # to reinitialize the cluster and try again.
                 connection_error_retry_counter += 1
-                if connection_error_retry_counter < 5:
+                if (
+                    connection_error_retry_counter
+                    < self.connection_error_retry_attempts
+                ):
                     await asyncio.sleep(0.25)
                 else:
+                    if isinstance(e, MaxConnectionsError):
+                        raise
                     # Hard force of reinitialize of the node/slots setup
                     # and try again with the new setup
                     await self.close()
                     raise
+            except ClusterDownError:
+                # ClusterDownError can occur during a failover and to get
+                # self-healed, we will try to reinitialize the cluster layout
+                # and retry executing the command
+                await self.close()
+                await asyncio.sleep(0.25)
+                raise
             except MovedError as e:
                 # First, we will try to patch the slots/nodes cache with the
                 # redirected node output and try again. If MovedError exceeds
@@ -711,19 +738,12 @@ async def _execute_command(
                 else:
                     self.nodes_manager._moved_exception = e
                 moved = True
-            except TryAgainError:
-                if ttl < self.RedisClusterRequestTTL / 2:
-                    await asyncio.sleep(0.05)
             except AskError as e:
                 redirect_addr = get_node_name(host=e.host, port=e.port)
                 asking = True
-            except ClusterDownError:
-                # ClusterDownError can occur during a failover and to get
-                # self-healed, we will try to reinitialize the cluster layout
-                # and retry executing the command
-                await asyncio.sleep(0.25)
-                await self.close()
-                raise
+            except TryAgainError:
+                if ttl < self.RedisClusterRequestTTL / 2:
+                    await asyncio.sleep(0.05)
 
         raise ClusterError("TTL exhausted.")
 
@@ -770,8 +790,9 @@ class ClusterNode:
     def __init__(
         self,
         host: str,
-        port: int,
+        port: Union[str, int],
         server_type: Optional[str] = None,
+        *,
         max_connections: int = 2**31,
         connection_class: Type[Connection] = Connection,
         **connection_kwargs: Any,
@@ -789,9 +810,7 @@ def __init__(
         self.max_connections = max_connections
         self.connection_class = connection_class
         self.connection_kwargs = connection_kwargs
-        self.response_callbacks = connection_kwargs.pop(
-            "response_callbacks", RedisCluster.RESPONSE_CALLBACKS
-        )
+        self.response_callbacks = connection_kwargs.pop("response_callbacks", {})
 
         self._connections: List[Connection] = []
         self._free: Deque[Connection] = collections.deque(maxlen=self.max_connections)
@@ -834,21 +853,15 @@ async def disconnect(self) -> None:
             raise exc
 
     def acquire_connection(self) -> Connection:
-        if self._free:
-            for _ in range(len(self._free)):
-                connection = self._free.popleft()
-                if connection.is_connected:
-                    return connection
-                self._free.append(connection)
-
+        try:
             return self._free.popleft()
+        except IndexError:
+            if len(self._connections) < self.max_connections:
+                connection = self.connection_class(**self.connection_kwargs)
+                self._connections.append(connection)
+                return connection
 
-        if len(self._connections) < self.max_connections:
-            connection = self.connection_class(**self.connection_kwargs)
-            self._connections.append(connection)
-            return connection
-
-        raise ConnectionError("Too many connections")
+            raise MaxConnectionsError()
 
     async def parse_response(
         self, connection: Connection, command: str, **kwargs: Any
@@ -926,12 +939,12 @@ class NodesManager:
     def __init__(
         self,
         startup_nodes: List["ClusterNode"],
-        require_full_coverage: bool = False,
-        **kwargs: Any,
+        require_full_coverage: bool,
+        connection_kwargs: Dict[str, Any],
     ) -> None:
         self.startup_nodes = {node.name: node for node in startup_nodes}
         self.require_full_coverage = require_full_coverage
-        self.connection_kwargs = kwargs
+        self.connection_kwargs = connection_kwargs
 
         self.default_node: "ClusterNode" = None
         self.nodes_cache: Dict[str, "ClusterNode"] = {}
@@ -1050,6 +1063,7 @@ async def initialize(self) -> None:
         disagreements = []
         startup_nodes_reachable = False
         fully_covered = False
+        exception = None
         for startup_node in self.startup_nodes.values():
             try:
                 # Make sure cluster mode is enabled on this node
@@ -1061,7 +1075,8 @@ async def initialize(self) -> None:
                     )
                 cluster_slots = await startup_node.execute_command("CLUSTER SLOTS")
                 startup_nodes_reachable = True
-            except (ConnectionError, TimeoutError):
+            except (ConnectionError, TimeoutError) as e:
+                exception = e
                 continue
             except ResponseError as e:
                 # Isn't a cluster connection, so it won't parse these
@@ -1162,7 +1177,7 @@ async def initialize(self) -> None:
             raise RedisClusterException(
                 "Redis Cluster cannot be connected. Please provide at least "
                 "one reachable node. "
-            )
+            ) from exception
 
         # Check if the slots are not fully covered
         if not fully_covered and self.require_full_coverage:
@@ -1327,7 +1342,7 @@ async def execute(
                         await asyncio.sleep(0.25)
                     else:
                         # All other errors should be raised.
-                        raise e
+                        raise
 
             # If it fails the configured number of times then raise an exception
             raise exception
diff --git a/redis/cluster.py b/redis/cluster.py
index b2d4f3b044..b05cf307db 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -5,7 +5,7 @@
 import threading
 import time
 from collections import OrderedDict
-from typing import Any, Callable, Dict, Tuple
+from typing import Any, Callable, Dict, Tuple, Union
 
 from redis.client import CaseInsensitiveDict, PubSub, Redis, parse_scan
 from redis.commands import READ_COMMANDS, CommandsParser, RedisClusterCommands
@@ -38,7 +38,7 @@
 )
 
 
-def get_node_name(host: str, port: int) -> str:
+def get_node_name(host: str, port: Union[str, int]) -> str:
     return f"{host}:{port}"
 
 
diff --git a/redis/exceptions.py b/redis/exceptions.py
index d18b354454..8a8bf423eb 100644
--- a/redis/exceptions.py
+++ b/redis/exceptions.py
@@ -199,3 +199,7 @@ class SlotNotCoveredError(RedisClusterException):
     """
 
     pass
+
+
+class MaxConnectionsError(ConnectionError):
+    ...
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 8766cbf09b..1365e4daff 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -1,9 +1,11 @@
 import asyncio
 import binascii
 import datetime
+import os
 import sys
 import warnings
-from typing import Any, Callable, Dict, List, Optional, Type, Union
+from typing import Any, Awaitable, Callable, Dict, List, Optional, Type, Union
+from urllib.parse import urlparse
 
 import pytest
 
@@ -16,10 +18,10 @@
 else:
     import pytest_asyncio
 
-from _pytest.fixtures import FixtureRequest, SubRequest
+from _pytest.fixtures import FixtureRequest
 
-from redis.asyncio import Connection, RedisCluster
-from redis.asyncio.cluster import ClusterNode, NodesManager
+from redis.asyncio.cluster import ClusterNode, NodesManager, RedisCluster
+from redis.asyncio.connection import Connection, SSLConnection
 from redis.asyncio.parser import CommandsParser
 from redis.cluster import PIPELINE_BLOCKED_COMMANDS, PRIMARY, REPLICA, get_node_name
 from redis.crc import REDIS_CLUSTER_HASH_SLOTS, key_slot
@@ -28,6 +30,7 @@
     ClusterDownError,
     ConnectionError,
     DataError,
+    MaxConnectionsError,
     MovedError,
     NoPermissionError,
     RedisClusterException,
@@ -41,6 +44,9 @@
     skip_unless_arch_bits,
 )
 
+pytestmark = pytest.mark.onlycluster
+
+
 default_host = "127.0.0.1"
 default_port = 7000
 default_cluster_slots = [
@@ -50,7 +56,7 @@
 
 
 @pytest_asyncio.fixture()
-async def slowlog(request: SubRequest, r: RedisCluster) -> None:
+async def slowlog(r: RedisCluster) -> None:
     """
     Set the slowlog threshold to 0, and the
     max length to 128. This will force every
@@ -146,7 +152,7 @@ def mock_all_nodes_resp(rc: RedisCluster, response: Any) -> RedisCluster:
 
 
 async def moved_redirection_helper(
-    request: FixtureRequest, create_redis: Callable, failover: bool = False
+    create_redis: Callable[..., RedisCluster], failover: bool = False
 ) -> None:
     """
     Test that the client handles MOVED response after a failover.
@@ -202,7 +208,6 @@ def ok_response(self, *args, **options):
             assert prev_primary.server_type == REPLICA
 
 
-@pytest.mark.onlycluster
 class TestRedisClusterObj:
     """
     Tests for the RedisCluster class
@@ -237,10 +242,18 @@ async def test_startup_nodes(self) -> None:
 
         await cluster.close()
 
-        startup_nodes = [ClusterNode("127.0.0.1", 16379)]
-        async with RedisCluster(startup_nodes=startup_nodes) as rc:
+        startup_node = ClusterNode("127.0.0.1", 16379)
+        async with RedisCluster(startup_nodes=[startup_node], client_name="test") as rc:
             assert await rc.set("A", 1)
             assert await rc.get("A") == b"1"
+            assert all(
+                [
+                    name == "test"
+                    for name in (
+                        await rc.client_getname(target_nodes=rc.ALL_NODES)
+                    ).values()
+                ]
+            )
 
     async def test_empty_startup_nodes(self) -> None:
         """
@@ -253,18 +266,43 @@ async def test_empty_startup_nodes(self) -> None:
             "RedisCluster requires at least one node to discover the " "cluster"
         ), str_if_bytes(ex.value)
 
-    async def test_from_url(self, r: RedisCluster) -> None:
-        redis_url = f"redis://{default_host}:{default_port}/0"
-        with mock.patch.object(RedisCluster, "from_url") as from_url:
+    async def test_from_url(self, request: FixtureRequest) -> None:
+        url = request.config.getoption("--redis-url")
 
-            async def from_url_mocked(_url, **_kwargs):
-                return await get_mocked_redis_client(url=_url, **_kwargs)
+        async with RedisCluster.from_url(url) as rc:
+            await rc.set("a", 1)
+            await rc.get("a") == 1
 
-            from_url.side_effect = from_url_mocked
-            cluster = await RedisCluster.from_url(redis_url)
-        assert cluster.get_node(host=default_host, port=default_port) is not None
+        rc = RedisCluster.from_url("rediss://localhost:16379")
+        assert rc.connection_kwargs["connection_class"] is SSLConnection
 
-        await cluster.close()
+    async def test_max_connections(
+        self, create_redis: Callable[..., RedisCluster]
+    ) -> None:
+        rc = await create_redis(cls=RedisCluster, max_connections=10)
+        for node in rc.get_nodes():
+            assert node.max_connections == 10
+
+        with mock.patch.object(
+            Connection, "read_response_without_lock"
+        ) as read_response_without_lock:
+
+            async def read_response_without_lock_mocked(
+                *args: Any, **kwargs: Any
+            ) -> None:
+                await asyncio.sleep(10)
+
+            read_response_without_lock.side_effect = read_response_without_lock_mocked
+
+            with pytest.raises(MaxConnectionsError):
+                await asyncio.gather(
+                    *(
+                        rc.ping(target_nodes=RedisCluster.DEFAULT_NODE)
+                        for _ in range(11)
+                    )
+                )
+
+        await rc.close()
 
     async def test_execute_command_errors(self, r: RedisCluster) -> None:
         """
@@ -373,23 +411,23 @@ def ok_response(self, *args, **options):
             assert await r.execute_command("SET", "foo", "bar") == "MOCK_OK"
 
     async def test_moved_redirection(
-        self, request: FixtureRequest, create_redis: Callable
+        self, create_redis: Callable[..., RedisCluster]
     ) -> None:
         """
         Test that the client handles MOVED response.
         """
-        await moved_redirection_helper(request, create_redis, failover=False)
+        await moved_redirection_helper(create_redis, failover=False)
 
     async def test_moved_redirection_after_failover(
-        self, request: FixtureRequest, create_redis: Callable
+        self, create_redis: Callable[..., RedisCluster]
     ) -> None:
         """
         Test that the client handles MOVED response after a failover.
         """
-        await moved_redirection_helper(request, create_redis, failover=True)
+        await moved_redirection_helper(create_redis, failover=True)
 
     async def test_refresh_using_specific_nodes(
-        self, request: FixtureRequest, create_redis: Callable
+        self, create_redis: Callable[..., RedisCluster]
     ) -> None:
         """
         Test making calls on specific nodes when the cluster has failed over to
@@ -691,7 +729,6 @@ async def test_can_run_concurrent_commands(self, request: FixtureRequest) -> Non
         await rc.close()
 
 
-@pytest.mark.onlycluster
 class TestClusterRedisCommands:
     """
     Tests for RedisCluster unique commands
@@ -1918,7 +1955,7 @@ async def test_cluster_randomkey(self, r: RedisCluster) -> None:
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise()
     async def test_acl_log(
-        self, r: RedisCluster, request: FixtureRequest, create_redis: Callable
+        self, r: RedisCluster, create_redis: Callable[..., RedisCluster]
     ) -> None:
         key = "{cache}:"
         node = r.get_node_from_key(key)
@@ -1963,7 +2000,6 @@ async def test_acl_log(
         await user_client.close()
 
 
-@pytest.mark.onlycluster
 class TestNodesManager:
     """
     Tests for the NodesManager class
@@ -2095,7 +2131,7 @@ async def test_empty_startup_nodes(self) -> None:
         specified
         """
         with pytest.raises(RedisClusterException):
-            await NodesManager([]).initialize()
+            await NodesManager([], False, {}).initialize()
 
     async def test_wrong_startup_nodes_type(self) -> None:
         """
@@ -2103,11 +2139,9 @@ async def test_wrong_startup_nodes_type(self) -> None:
         fail
         """
         with pytest.raises(RedisClusterException):
-            await NodesManager({}).initialize()
+            await NodesManager({}, False, {}).initialize()
 
-    async def test_init_slots_cache_slots_collision(
-        self, request: FixtureRequest
-    ) -> None:
+    async def test_init_slots_cache_slots_collision(self) -> None:
         """
         Test that if 2 nodes do not agree on the same slots setup it should
         raise an error. In this test both nodes will say that the first
@@ -2236,7 +2270,6 @@ def cmd_init_mock(self, r: ClusterNode) -> None:
                     assert rc.get_node(host=default_host, port=7002) is not None
 
 
-@pytest.mark.onlycluster
 class TestClusterPipeline:
     """Tests for the ClusterPipeline class."""
 
@@ -2484,3 +2517,116 @@ async def test_can_run_concurrent_pipelines(self, r: RedisCluster) -> None:
             *(self.test_multi_key_operation_with_a_single_slot(r) for i in range(100)),
             *(self.test_multi_key_operation_with_multi_slots(r) for i in range(100)),
         )
+
+
+@pytest.mark.ssl
+class TestSSL:
+    """
+    Tests for SSL connections.
+
+    This relies on the --redis-ssl-url for building the client and connecting to the
+    appropriate port.
+    """
+
+    ROOT = os.path.join(os.path.dirname(__file__), "../..")
+    CERT_DIR = os.path.abspath(os.path.join(ROOT, "docker", "stunnel", "keys"))
+    if not os.path.isdir(CERT_DIR):  # github actions package validation case
+        CERT_DIR = os.path.abspath(
+            os.path.join(ROOT, "..", "docker", "stunnel", "keys")
+        )
+        if not os.path.isdir(CERT_DIR):
+            raise IOError(f"No SSL certificates found. They should be in {CERT_DIR}")
+
+    SERVER_CERT = os.path.join(CERT_DIR, "server-cert.pem")
+    SERVER_KEY = os.path.join(CERT_DIR, "server-key.pem")
+
+    @pytest_asyncio.fixture()
+    def create_client(self, request: FixtureRequest) -> Callable[..., RedisCluster]:
+        ssl_url = request.config.option.redis_ssl_url
+        ssl_host, ssl_port = urlparse(ssl_url)[1].split(":")
+
+        async def _create_client(mocked: bool = True, **kwargs: Any) -> RedisCluster:
+            if mocked:
+                with mock.patch.object(
+                    ClusterNode, "execute_command", autospec=True
+                ) as execute_command_mock:
+
+                    async def execute_command(self, *args, **kwargs):
+                        if args[0] == "INFO":
+                            return {"cluster_enabled": True}
+                        if args[0] == "CLUSTER SLOTS":
+                            return [[0, 16383, [ssl_host, ssl_port, "ssl_node"]]]
+                        if args[0] == "COMMAND":
+                            return {
+                                "ping": {
+                                    "name": "ping",
+                                    "arity": -1,
+                                    "flags": ["stale", "fast"],
+                                    "first_key_pos": 0,
+                                    "last_key_pos": 0,
+                                    "step_count": 0,
+                                }
+                            }
+                        raise NotImplementedError()
+
+                    execute_command_mock.side_effect = execute_command
+
+                    rc = await RedisCluster(host=ssl_host, port=ssl_port, **kwargs)
+
+                assert len(rc.get_nodes()) == 1
+                node = rc.get_default_node()
+                assert node.port == int(ssl_port)
+                return rc
+
+            return await RedisCluster(host=ssl_host, port=ssl_port, **kwargs)
+
+        return _create_client
+
+    async def test_ssl_connection_without_ssl(
+        self, create_client: Callable[..., Awaitable[RedisCluster]]
+    ) -> None:
+        with pytest.raises(RedisClusterException) as e:
+            await create_client(mocked=False, ssl=False)
+        e = e.value.__cause__
+        assert "Connection closed by server" in str(e)
+
+    async def test_ssl_with_invalid_cert(
+        self, create_client: Callable[..., Awaitable[RedisCluster]]
+    ) -> None:
+        with pytest.raises(RedisClusterException) as e:
+            await create_client(mocked=False, ssl=True)
+        e = e.value.__cause__.__context__
+        assert "SSL: CERTIFICATE_VERIFY_FAILED" in str(e)
+
+    async def test_ssl_connection(
+        self, create_client: Callable[..., Awaitable[RedisCluster]]
+    ) -> None:
+        async with await create_client(ssl=True, ssl_cert_reqs="none") as rc:
+            assert await rc.ping()
+
+    async def test_validating_self_signed_certificate(
+        self, create_client: Callable[..., Awaitable[RedisCluster]]
+    ) -> None:
+        async with await create_client(
+            ssl=True,
+            ssl_ca_certs=self.SERVER_CERT,
+            ssl_cert_reqs="required",
+            ssl_certfile=self.SERVER_CERT,
+            ssl_keyfile=self.SERVER_KEY,
+        ) as rc:
+            assert await rc.ping()
+
+    async def test_validating_self_signed_string_certificate(
+        self, create_client: Callable[..., Awaitable[RedisCluster]]
+    ) -> None:
+        with open(self.SERVER_CERT) as f:
+            cert_data = f.read()
+
+        async with await create_client(
+            ssl=True,
+            ssl_ca_data=cert_data,
+            ssl_cert_reqs="required",
+            ssl_certfile=self.SERVER_CERT,
+            ssl_keyfile=self.SERVER_KEY,
+        ) as rc:
+            assert await rc.ping()

From 607a59ad6ff0cabc7b0af7480f42043aebc2a33b Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 27 Jul 2022 16:18:41 +0300
Subject: [PATCH 0546/1164] Drop python 3.6 support (#2306)

---
 .github/workflows/integration.yaml         |  4 ++--
 CONTRIBUTING.md                            |  2 +-
 redis/asyncio/cluster.py                   |  6 ++---
 redis/asyncio/connection.py                | 25 +++++++-------------
 redis/asyncio/lock.py                      | 10 ++------
 setup.py                                   |  3 +--
 tests/test_asyncio/conftest.py             | 27 ++++------------------
 tests/test_asyncio/test_bloom.py           |  5 ----
 tests/test_asyncio/test_cluster.py         | 14 +++--------
 tests/test_asyncio/test_commands.py        |  9 +-------
 tests/test_asyncio/test_connection.py      |  4 ----
 tests/test_asyncio/test_connection_pool.py |  9 +-------
 tests/test_asyncio/test_encoding.py        | 10 +-------
 tests/test_asyncio/test_lock.py            |  9 +-------
 tests/test_asyncio/test_monitor.py         |  5 ----
 tests/test_asyncio/test_pipeline.py        |  5 ----
 tests/test_asyncio/test_pubsub.py          |  9 +-------
 tests/test_asyncio/test_scripting.py       | 10 +-------
 tests/test_asyncio/test_search.py          |  5 ----
 tests/test_asyncio/test_sentinel.py        |  9 +-------
 tests/test_asyncio/test_timeseries.py      |  4 ----
 tox.ini                                    |  4 ++--
 22 files changed, 32 insertions(+), 156 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 1cce9f3659..5876c08738 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -39,7 +39,7 @@ jobs:
      strategy:
        max-parallel: 15
        matrix:
-         python-version: ['3.6', '3.7', '3.8', '3.9', '3.10', 'pypy-3.7', 'pypy-3.8']
+         python-version: ['3.7', '3.8', '3.9', '3.10', 'pypy-3.7', 'pypy-3.8']
          test-type: ['standalone', 'cluster']
          connection-type: ['hiredis', 'plain']
      env:
@@ -84,7 +84,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.6', '3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
+        python-version: ['3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
     steps:
       - uses: actions/checkout@v2
       - name: install python ${{ matrix.python-version }}
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 827a25f9c4..e31ec3491e 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -126,7 +126,7 @@ this, instead of using make test, you need to pass
 Our test suite uses `pytest`. You can run a specific test suite against
 a specific Python version like this:
 
-`$ docker-compose run test tox -e py36 -- --redis-url=redis://master:6379/9 tests/test_commands.py`
+`$ docker-compose run test tox -e py37 -- --redis-url=redis://master:6379/9 tests/test_commands.py`
 
 ### Troubleshooting
 
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index df0c17d49c..1a33563781 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -377,8 +377,7 @@ def __del__(self) -> None:
             warnings.warn(f"{self._DEL_MESSAGE} {self!r}", ResourceWarning, source=self)
             try:
                 context = {"client": self, "message": self._DEL_MESSAGE}
-                # TODO: Change to get_running_loop() when dropping support for py3.6
-                asyncio.get_event_loop().call_exception_handler(context)
+                asyncio.get_running_loop().call_exception_handler(context)
             except RuntimeError:
                 ...
 
@@ -834,8 +833,7 @@ def __del__(self) -> None:
                 )
                 try:
                     context = {"client": self, "message": self._DEL_MESSAGE}
-                    # TODO: Change to get_running_loop() when dropping support for py3.6
-                    asyncio.get_event_loop().call_exception_handler(context)
+                    asyncio.get_running_loop().call_exception_handler(context)
                 except RuntimeError:
                     ...
                 break
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 4c75d2f1df..6823dcb853 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -7,7 +7,6 @@
 import os
 import socket
 import ssl
-import sys
 import threading
 import weakref
 from itertools import chain
@@ -864,12 +863,10 @@ async def _ping_failed(self, error):
 
     async def check_health(self):
         """Check the health of the connection with a PING/PONG"""
-        if sys.version_info[0:2] == (3, 6):
-            func = asyncio.get_event_loop
-        else:
-            func = asyncio.get_running_loop
-
-        if self.health_check_interval and func().time() > self.next_health_check:
+        if (
+            self.health_check_interval
+            and asyncio.get_running_loop().time() > self.next_health_check
+        ):
             await self.retry.call_with_retry(self._send_ping, self._ping_failed)
 
     async def _send_packed_command(self, command: Iterable[bytes]) -> None:
@@ -957,11 +954,8 @@ async def read_response(self, disable_decoding: bool = False):
             raise
 
         if self.health_check_interval:
-            if sys.version_info[0:2] == (3, 6):
-                func = asyncio.get_event_loop
-            else:
-                func = asyncio.get_running_loop
-            self.next_health_check = func().time() + self.health_check_interval
+            next_time = asyncio.get_running_loop().time() + self.health_check_interval
+            self.next_health_check = next_time
 
         if isinstance(response, ResponseError):
             raise response from None
@@ -992,11 +986,8 @@ async def read_response_without_lock(self, disable_decoding: bool = False):
             raise
 
         if self.health_check_interval:
-            if sys.version_info[0:2] == (3, 6):
-                func = asyncio.get_event_loop
-            else:
-                func = asyncio.get_running_loop
-            self.next_health_check = func().time() + self.health_check_interval
+            next_time = asyncio.get_running_loop().time() + self.health_check_interval
+            self.next_health_check = next_time
 
         if isinstance(response, ResponseError):
             raise response from None
diff --git a/redis/asyncio/lock.py b/redis/asyncio/lock.py
index fc7df373f1..8ede59b146 100644
--- a/redis/asyncio/lock.py
+++ b/redis/asyncio/lock.py
@@ -1,5 +1,4 @@
 import asyncio
-import sys
 import threading
 import uuid
 from types import SimpleNamespace
@@ -186,11 +185,6 @@ async def acquire(
         object with the default encoding. If a token isn't specified, a UUID
         will be generated.
         """
-        if sys.version_info[0:2] != (3, 6):
-            loop = asyncio.get_running_loop()
-        else:
-            loop = asyncio.get_event_loop()
-
         sleep = self.sleep
         if token is None:
             token = uuid.uuid1().hex.encode()
@@ -203,14 +197,14 @@ async def acquire(
             blocking_timeout = self.blocking_timeout
         stop_trying_at = None
         if blocking_timeout is not None:
-            stop_trying_at = loop.time() + blocking_timeout
+            stop_trying_at = asyncio.get_event_loop().time() + blocking_timeout
         while True:
             if await self.do_acquire(token):
                 self.local.token = token
                 return True
             if not blocking:
                 return False
-            next_try_at = loop.time() + sleep
+            next_try_at = asyncio.get_event_loop().time() + sleep
             if stop_trying_at is not None and next_try_at > stop_trying_at:
                 return False
             await asyncio.sleep(sleep)
diff --git a/setup.py b/setup.py
index 87649c596f..c513b40ce4 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     },
     author="Redis Inc.",
     author_email="oss@redis.com",
-    python_requires=">=3.6",
+    python_requires=">=3.7",
     install_requires=[
         "deprecated>=1.2.3",
         "packaging>=20.4",
@@ -47,7 +47,6 @@
         "Programming Language :: Python",
         "Programming Language :: Python :: 3",
         "Programming Language :: Python :: 3 :: Only",
-        "Programming Language :: Python :: 3.6",
         "Programming Language :: Python :: 3.7",
         "Programming Language :: Python :: 3.8",
         "Programming Language :: Python :: 3.9",
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index 04fbf62cf7..6982cc840a 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -1,10 +1,10 @@
-import functools
 import random
-import sys
+from contextlib import asynccontextmanager as _asynccontextmanager
 from typing import Union
 from urllib.parse import urlparse
 
 import pytest
+import pytest_asyncio
 from packaging.version import Version
 
 import redis.asyncio as redis
@@ -21,13 +21,6 @@
 
 from .compat import mock
 
-if sys.version_info[0:2] == (3, 6):
-    import pytest as pytest_asyncio
-
-    pytestmark = pytest.mark.asyncio
-else:
-    import pytest_asyncio
-
 
 async def _get_info(redis_url):
     client = redis.Redis.from_url(redis_url)
@@ -268,17 +261,5 @@ async def __aexit__(self, exc_type, exc_inst, tb):
         raise RuntimeError("More pickles")
 
 
-if sys.version_info[0:2] == (3, 6):
-
-    def asynccontextmanager(func):
-        @functools.wraps(func)
-        def wrapper(*args, **kwargs):
-            return AsyncContextManager(func(*args, **kwargs))
-
-        return wrapper
-
-else:
-    from contextlib import asynccontextmanager as _asynccontextmanager
-
-    def asynccontextmanager(func):
-        return _asynccontextmanager(func)
+def asynccontextmanager(func):
+    return _asynccontextmanager(func)
diff --git a/tests/test_asyncio/test_bloom.py b/tests/test_asyncio/test_bloom.py
index 2bf4e030e6..2c3617f9ab 100644
--- a/tests/test_asyncio/test_bloom.py
+++ b/tests/test_asyncio/test_bloom.py
@@ -1,14 +1,9 @@
-import sys
-
 import pytest
 
 import redis.asyncio as redis
 from redis.exceptions import ModuleError, RedisError
 from redis.utils import HIREDIS_AVAILABLE
 
-if sys.version_info[0:2] == (3, 6):
-    pytestmark = pytest.mark.asyncio
-
 
 def intlist(obj):
     return [int(v) for v in obj]
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 1365e4daff..e299395554 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -2,22 +2,12 @@
 import binascii
 import datetime
 import os
-import sys
 import warnings
 from typing import Any, Awaitable, Callable, Dict, List, Optional, Type, Union
 from urllib.parse import urlparse
 
 import pytest
-
-from .compat import mock
-
-if sys.version_info[0:2] == (3, 6):
-    import pytest as pytest_asyncio
-
-    pytestmark = pytest.mark.asyncio
-else:
-    import pytest_asyncio
-
+import pytest_asyncio
 from _pytest.fixtures import FixtureRequest
 
 from redis.asyncio.cluster import ClusterNode, NodesManager, RedisCluster
@@ -44,6 +34,8 @@
     skip_unless_arch_bits,
 )
 
+from .compat import mock
+
 pytestmark = pytest.mark.onlycluster
 
 
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 913f05b3fe..eaae185f31 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -4,18 +4,11 @@
 import binascii
 import datetime
 import re
-import sys
 import time
 from string import ascii_letters
 
 import pytest
-
-if sys.version_info[0:2] == (3, 6):
-    import pytest as pytest_asyncio
-
-    pytestmark = pytest.mark.asyncio
-else:
-    import pytest_asyncio
+import pytest_asyncio
 
 import redis
 from redis import exceptions
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index 8030f7e628..419c8a7642 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -1,6 +1,5 @@
 import asyncio
 import socket
-import sys
 import types
 from unittest.mock import patch
 
@@ -19,9 +18,6 @@
 
 from .compat import mock
 
-if sys.version_info[0:2] == (3, 6):
-    pytestmark = pytest.mark.asyncio
-
 
 @pytest.mark.onlynoncluster
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
index c8eb918e28..d281608e51 100644
--- a/tests/test_asyncio/test_connection_pool.py
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -1,16 +1,9 @@
 import asyncio
 import os
 import re
-import sys
 
 import pytest
-
-if sys.version_info[0:2] == (3, 6):
-    import pytest as pytest_asyncio
-
-    pytestmark = pytest.mark.asyncio
-else:
-    import pytest_asyncio
+import pytest_asyncio
 
 import redis.asyncio as redis
 from redis.asyncio.connection import Connection, to_bool
diff --git a/tests/test_asyncio/test_encoding.py b/tests/test_asyncio/test_encoding.py
index 5db7187c84..3efcf69e5b 100644
--- a/tests/test_asyncio/test_encoding.py
+++ b/tests/test_asyncio/test_encoding.py
@@ -1,13 +1,5 @@
-import sys
-
 import pytest
-
-if sys.version_info[0:2] == (3, 6):
-    import pytest as pytest_asyncio
-
-    pytestmark = pytest.mark.asyncio
-else:
-    import pytest_asyncio
+import pytest_asyncio
 
 import redis.asyncio as redis
 from redis.exceptions import DataError
diff --git a/tests/test_asyncio/test_lock.py b/tests/test_asyncio/test_lock.py
index 86a8d62f71..09aec75194 100644
--- a/tests/test_asyncio/test_lock.py
+++ b/tests/test_asyncio/test_lock.py
@@ -1,14 +1,7 @@
 import asyncio
-import sys
 
 import pytest
-
-if sys.version_info[0:2] == (3, 6):
-    import pytest as pytest_asyncio
-
-    pytestmark = pytest.mark.asyncio
-else:
-    import pytest_asyncio
+import pytest_asyncio
 
 from redis.asyncio.lock import Lock
 from redis.exceptions import LockError, LockNotOwnedError
diff --git a/tests/test_asyncio/test_monitor.py b/tests/test_asyncio/test_monitor.py
index 9185bcd2ee..3551579ec0 100644
--- a/tests/test_asyncio/test_monitor.py
+++ b/tests/test_asyncio/test_monitor.py
@@ -1,14 +1,9 @@
-import sys
-
 import pytest
 
 from tests.conftest import skip_if_redis_enterprise, skip_ifnot_redis_enterprise
 
 from .conftest import wait_for_command
 
-if sys.version_info[0:2] == (3, 6):
-    pytestmark = pytest.mark.asyncio
-
 
 @pytest.mark.onlynoncluster
 class TestMonitor:
diff --git a/tests/test_asyncio/test_pipeline.py b/tests/test_asyncio/test_pipeline.py
index 33391d019d..d613f490a5 100644
--- a/tests/test_asyncio/test_pipeline.py
+++ b/tests/test_asyncio/test_pipeline.py
@@ -1,5 +1,3 @@
-import sys
-
 import pytest
 
 import redis
@@ -7,9 +5,6 @@
 
 from .conftest import wait_for_command
 
-if sys.version_info[0:2] == (3, 6):
-    pytestmark = pytest.mark.asyncio
-
 
 class TestPipeline:
     @pytest.mark.onlynoncluster
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index d6a817a61b..0c6026715e 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -1,17 +1,10 @@
 import asyncio
 import functools
-import sys
 from typing import Optional
 
 import async_timeout
 import pytest
-
-if sys.version_info[0:2] == (3, 6):
-    import pytest as pytest_asyncio
-
-    pytestmark = pytest.mark.asyncio(forbid_global_loop=True)
-else:
-    import pytest_asyncio
+import pytest_asyncio
 
 import redis.asyncio as redis
 from redis.exceptions import ConnectionError
diff --git a/tests/test_asyncio/test_scripting.py b/tests/test_asyncio/test_scripting.py
index 406ab208e2..3776d12cb7 100644
--- a/tests/test_asyncio/test_scripting.py
+++ b/tests/test_asyncio/test_scripting.py
@@ -1,13 +1,5 @@
-import sys
-
 import pytest
-
-if sys.version_info[0:2] == (3, 6):
-    import pytest as pytest_asyncio
-
-    pytestmark = pytest.mark.asyncio
-else:
-    import pytest_asyncio
+import pytest_asyncio
 
 from redis import exceptions
 from tests.conftest import skip_if_server_version_lt
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index bc3a212ac9..aa52602588 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -1,7 +1,6 @@
 import bz2
 import csv
 import os
-import sys
 import time
 from io import TextIOWrapper
 
@@ -19,10 +18,6 @@
 from redis.commands.search.suggestion import Suggestion
 from tests.conftest import skip_ifmodversion_lt
 
-if sys.version_info[0:2] == (3, 6):
-    pytestmark = pytest.mark.asyncio
-
-
 WILL_PLAY_TEXT = os.path.abspath(
     os.path.join(os.path.dirname(__file__), "testdata", "will_play_text.csv.bz2")
 )
diff --git a/tests/test_asyncio/test_sentinel.py b/tests/test_asyncio/test_sentinel.py
index e77e07f98e..5a0533ba05 100644
--- a/tests/test_asyncio/test_sentinel.py
+++ b/tests/test_asyncio/test_sentinel.py
@@ -1,14 +1,7 @@
 import socket
-import sys
 
 import pytest
-
-if sys.version_info[0:2] == (3, 6):
-    import pytest as pytest_asyncio
-
-    pytestmark = pytest.mark.asyncio
-else:
-    import pytest_asyncio
+import pytest_asyncio
 
 import redis.asyncio.sentinel
 from redis import exceptions
diff --git a/tests/test_asyncio/test_timeseries.py b/tests/test_asyncio/test_timeseries.py
index 0e57c4f049..182f6b5f3f 100644
--- a/tests/test_asyncio/test_timeseries.py
+++ b/tests/test_asyncio/test_timeseries.py
@@ -1,4 +1,3 @@
-import sys
 import time
 from time import sleep
 
@@ -7,9 +6,6 @@
 import redis.asyncio as redis
 from tests.conftest import skip_ifmodversion_lt
 
-if sys.version_info[0:2] == (3, 6):
-    pytestmark = pytest.mark.asyncio
-
 
 @pytest.mark.redismod
 async def test_create(modclient: redis.Redis):
diff --git a/tox.ini b/tox.ini
index d1aeb02ade..2642aeaecb 100644
--- a/tox.ini
+++ b/tox.ini
@@ -14,7 +14,7 @@ asyncio_mode = auto
 [tox]
 minversion = 3.2.0
 requires = tox-docker
-envlist = {standalone,cluster}-{plain,hiredis,ocsp}-{uvloop,asyncio}-{py36,py37,py38,py39,pypy3},linters,docs
+envlist = {standalone,cluster}-{plain,hiredis,ocsp}-{uvloop,asyncio}-{py37,py38,py39,pypy3},linters,docs
 
 [docker:master]
 name = master
@@ -344,7 +344,7 @@ deps_files = dev_requirements.txt
 docker =
 commands =
     flake8
-    black --target-version py36 --check --diff .
+    black --target-version py37 --check --diff .
     isort --check-only --diff .
     vulture redis whitelist.py --min-confidence 80
     flynt --fail-on-change --dry-run .

From 48f5aca5bb2ed389819b1730f116150f1f0b476d Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 27 Jul 2022 16:20:55 +0300
Subject: [PATCH 0547/1164] Drop redisnod_cluster (#2307)

---
 tox.ini | 1 -
 1 file changed, 1 deletion(-)

diff --git a/tox.ini b/tox.ini
index 2642aeaecb..37603fe8e1 100644
--- a/tox.ini
+++ b/tox.ini
@@ -280,7 +280,6 @@ docker =
     sentinel_3
     redis_cluster
     redismod
-    redismod_cluster
     stunnel
 extras =
     hiredis: hiredis

From f9f9d06c9951f8536bf9321dcebc96759eae03e0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Wed, 27 Jul 2022 16:21:25 +0000
Subject: [PATCH 0548/1164] automatically reconnect pubsub when reading
 messages in blocking mode (#2281)

* optimistic default info on test sessionstart.
Makes test discovery work, even without a redis connection.

* Add unittests verifying that (non-async) PubSub will automatically reconnect

* Add tests for asyncio pubsub subsciription auto-reconnect

* automatically connect for blocking reads (asyncio)

* fix automatic connect on blocking pubsub read (non-async)

* lint & format

* Perform `connect()` call in PubSub code rather than `read_response`.
---
 redis/asyncio/client.py           |  12 ++-
 redis/client.py                   |  12 ++-
 tests/conftest.py                 |  20 +++--
 tests/test_asyncio/compat.py      |   9 +++
 tests/test_asyncio/test_pubsub.py | 130 +++++++++++++++++++++++++++++-
 tests/test_pubsub.py              | 127 +++++++++++++++++++++++++++++
 6 files changed, 298 insertions(+), 12 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 3d59016bb3..9c8caae0f9 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -754,9 +754,15 @@ async def parse_response(self, block: bool = True, timeout: float = 0):
 
         await self.check_health()
 
-        if not block and not await self._execute(conn, conn.can_read, timeout=timeout):
-            return None
-        response = await self._execute(conn, conn.read_response)
+        async def try_read():
+            if not block:
+                if not await conn.can_read(timeout=timeout):
+                    return None
+            else:
+                await conn.connect()
+            return await conn.read_response()
+
+        response = await self._execute(conn, try_read)
 
         if conn.health_check_interval and response == self.health_check_response:
             # ignore the health check message as user might not expect it
diff --git a/redis/client.py b/redis/client.py
index 035edb16be..39fbcdea7a 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1497,9 +1497,15 @@ def parse_response(self, block=True, timeout=0):
 
         self.check_health()
 
-        if not block and not self._execute(conn, conn.can_read, timeout=timeout):
-            return None
-        response = self._execute(conn, conn.read_response)
+        def try_read():
+            if not block:
+                if not conn.can_read(timeout=timeout):
+                    return None
+            else:
+                conn.connect()
+            return conn.read_response()
+
+        response = self._execute(conn, try_read)
 
         if self.is_health_check_response(response):
             # ignore the health check message as user might not expect it
diff --git a/tests/conftest.py b/tests/conftest.py
index 8a907cc389..3d40375052 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -130,15 +130,25 @@ def _get_info(redis_url):
 
 
 def pytest_sessionstart(session):
+    # during test discovery, e.g. with VS Code, we may not
+    # have a server running.
     redis_url = session.config.getoption("--redis-url")
-    info = _get_info(redis_url)
-    version = info["redis_version"]
-    arch_bits = info["arch_bits"]
-    cluster_enabled = info["cluster_enabled"]
+    try:
+        info = _get_info(redis_url)
+        version = info["redis_version"]
+        arch_bits = info["arch_bits"]
+        cluster_enabled = info["cluster_enabled"]
+        enterprise = info["enterprise"]
+    except redis.ConnectionError:
+        # provide optimistic defaults
+        version = "10.0.0"
+        arch_bits = 64
+        cluster_enabled = False
+        enterprise = False
     REDIS_INFO["version"] = version
     REDIS_INFO["arch_bits"] = arch_bits
     REDIS_INFO["cluster_enabled"] = cluster_enabled
-    REDIS_INFO["enterprise"] = info["enterprise"]
+    REDIS_INFO["enterprise"] = enterprise
     # store REDIS_INFO in config so that it is available from "condition strings"
     session.config.REDIS_INFO = REDIS_INFO
 
diff --git a/tests/test_asyncio/compat.py b/tests/test_asyncio/compat.py
index ced4974196..ed5c680411 100644
--- a/tests/test_asyncio/compat.py
+++ b/tests/test_asyncio/compat.py
@@ -1,6 +1,15 @@
+import asyncio
+import sys
 from unittest import mock
 
 try:
     mock.AsyncMock
 except AttributeError:
     import mock
+
+
+def create_task(coroutine):
+    if sys.version_info[:2] >= (3, 7):
+        return asyncio.create_task(coroutine)
+    else:
+        return asyncio.ensure_future(coroutine)
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index 0c6026715e..2ff0c726c6 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -1,5 +1,6 @@
 import asyncio
 import functools
+import socket
 from typing import Optional
 
 import async_timeout
@@ -11,7 +12,7 @@
 from redis.typing import EncodableT
 from tests.conftest import skip_if_server_version_lt
 
-from .compat import mock
+from .compat import create_task, mock
 
 
 def with_timeout(t):
@@ -786,3 +787,130 @@ def callback(message):
             "pattern": None,
             "type": "message",
         }
+
+
+# @pytest.mark.xfail
+@pytest.mark.parametrize("method", ["get_message", "listen"])
+@pytest.mark.onlynoncluster
+class TestPubSubAutoReconnect:
+    timeout = 2
+
+    async def mysetup(self, r, method):
+        self.messages = asyncio.Queue()
+        self.pubsub = r.pubsub()
+        # State: 0 = initial state , 1 = after disconnect, 2 = ConnectionError is seen,
+        # 3=successfully reconnected 4 = exit
+        self.state = 0
+        self.cond = asyncio.Condition()
+        if method == "get_message":
+            self.get_message = self.loop_step_get_message
+        else:
+            self.get_message = self.loop_step_listen
+
+        self.task = create_task(self.loop())
+        # get the initial connect message
+        message = await self.messages.get()
+        assert message == {
+            "channel": b"foo",
+            "data": 1,
+            "pattern": None,
+            "type": "subscribe",
+        }
+
+    async def mycleanup(self):
+        message = await self.messages.get()
+        assert message == {
+            "channel": b"foo",
+            "data": 1,
+            "pattern": None,
+            "type": "subscribe",
+        }
+        # kill thread
+        async with self.cond:
+            self.state = 4  # quit
+        await self.task
+
+    async def test_reconnect_socket_error(self, r: redis.Redis, method):
+        """
+        Test that a socket error will cause reconnect
+        """
+        async with async_timeout.timeout(self.timeout):
+            await self.mysetup(r, method)
+            # now, disconnect the connection, and wait for it to be re-established
+            async with self.cond:
+                assert self.state == 0
+                self.state = 1
+                with mock.patch.object(self.pubsub.connection, "_parser") as mockobj:
+                    mockobj.read_response.side_effect = socket.error
+                    mockobj.can_read.side_effect = socket.error
+                    # wait until task noticies the disconnect until we undo the patch
+                    await self.cond.wait_for(lambda: self.state >= 2)
+                    assert not self.pubsub.connection.is_connected
+                    # it is in a disconnecte state
+                # wait for reconnect
+                await self.cond.wait_for(lambda: self.pubsub.connection.is_connected)
+                assert self.state == 3
+
+            await self.mycleanup()
+
+    async def test_reconnect_disconnect(self, r: redis.Redis, method):
+        """
+        Test that a manual disconnect() will cause reconnect
+        """
+        async with async_timeout.timeout(self.timeout):
+            await self.mysetup(r, method)
+            # now, disconnect the connection, and wait for it to be re-established
+            async with self.cond:
+                self.state = 1
+                await self.pubsub.connection.disconnect()
+                assert not self.pubsub.connection.is_connected
+                # wait for reconnect
+                await self.cond.wait_for(lambda: self.pubsub.connection.is_connected)
+                assert self.state == 3
+
+            await self.mycleanup()
+
+    async def loop(self):
+        # reader loop, performing state transitions as it
+        # discovers disconnects and reconnects
+        await self.pubsub.subscribe("foo")
+        while True:
+            await asyncio.sleep(0.01)  # give main thread chance to get lock
+            async with self.cond:
+                old_state = self.state
+                try:
+                    if self.state == 4:
+                        break
+                    # print("state a ", self.state)
+                    got_msg = await self.get_message()
+                    assert got_msg
+                    if self.state in (1, 2):
+                        self.state = 3  # successful reconnect
+                except redis.ConnectionError:
+                    assert self.state in (1, 2)
+                    self.state = 2  # signal that we noticed the disconnect
+                finally:
+                    self.cond.notify()
+                # make sure that we did notice the connection error
+                # or reconnected without any error
+                if old_state == 1:
+                    assert self.state in (2, 3)
+
+    async def loop_step_get_message(self):
+        # get a single message via get_message
+        message = await self.pubsub.get_message(timeout=0.1)
+        # print(message)
+        if message is not None:
+            await self.messages.put(message)
+            return True
+        return False
+
+    async def loop_step_listen(self):
+        # get a single message via listen()
+        try:
+            async with async_timeout.timeout(0.1):
+                async for message in self.pubsub.listen():
+                    await self.messages.put(message)
+                    return True
+        except asyncio.TimeoutError:
+            return False
diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index 6456370c26..26df598bd8 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -1,4 +1,6 @@
 import platform
+import queue
+import socket
 import threading
 import time
 from unittest import mock
@@ -608,3 +610,128 @@ def test_pubsub_deadlock(self, master_host):
             p = r.pubsub()
             p.subscribe("my-channel-1", "my-channel-2")
             pool.reset()
+
+
+@pytest.mark.timeout(5, method="thread")
+@pytest.mark.parametrize("method", ["get_message", "listen"])
+@pytest.mark.onlynoncluster
+class TestPubSubAutoReconnect:
+    def mysetup(self, r, method):
+        self.messages = queue.Queue()
+        self.pubsub = r.pubsub()
+        self.state = 0
+        self.cond = threading.Condition()
+        if method == "get_message":
+            self.get_message = self.loop_step_get_message
+        else:
+            self.get_message = self.loop_step_listen
+
+        self.thread = threading.Thread(target=self.loop)
+        self.thread.daemon = True
+        self.thread.start()
+        # get the initial connect message
+        message = self.messages.get(timeout=1)
+        assert message == {
+            "channel": b"foo",
+            "data": 1,
+            "pattern": None,
+            "type": "subscribe",
+        }
+
+    def wait_for_reconnect(self):
+        self.cond.wait_for(lambda: self.pubsub.connection._sock is not None, timeout=2)
+        assert self.pubsub.connection._sock is not None  # we didn't time out
+        assert self.state == 3
+
+        message = self.messages.get(timeout=1)
+        assert message == {
+            "channel": b"foo",
+            "data": 1,
+            "pattern": None,
+            "type": "subscribe",
+        }
+
+    def mycleanup(self):
+        # kill thread
+        with self.cond:
+            self.state = 4  # quit
+            self.cond.notify()
+        self.thread.join()
+
+    def test_reconnect_socket_error(self, r: redis.Redis, method):
+        """
+        Test that a socket error will cause reconnect
+        """
+        self.mysetup(r, method)
+        try:
+            # now, disconnect the connection, and wait for it to be re-established
+            with self.cond:
+                self.state = 1
+                with mock.patch.object(self.pubsub.connection, "_parser") as mockobj:
+                    mockobj.read_response.side_effect = socket.error
+                    mockobj.can_read.side_effect = socket.error
+                    # wait until thread notices the disconnect until we undo the patch
+                    self.cond.wait_for(lambda: self.state >= 2)
+                    assert (
+                        self.pubsub.connection._sock is None
+                    )  # it is in a disconnected state
+                self.wait_for_reconnect()
+
+        finally:
+            self.mycleanup()
+
+    def test_reconnect_disconnect(self, r: redis.Redis, method):
+        """
+        Test that a manual disconnect() will cause reconnect
+        """
+        self.mysetup(r, method)
+        try:
+            # now, disconnect the connection, and wait for it to be re-established
+            with self.cond:
+                self.state = 1
+                self.pubsub.connection.disconnect()
+                assert self.pubsub.connection._sock is None
+                # wait for reconnect
+                self.wait_for_reconnect()
+        finally:
+            self.mycleanup()
+
+    def loop(self):
+        # reader loop, performing state transitions as it
+        # discovers disconnects and reconnects
+        self.pubsub.subscribe("foo")
+        while True:
+            time.sleep(0.01)  # give main thread chance to get lock
+            with self.cond:
+                old_state = self.state
+                try:
+                    if self.state == 4:
+                        break
+                    # print ('state, %s, sock %s' % (state, pubsub.connection._sock))
+                    got_msg = self.get_message()
+                    assert got_msg
+                    if self.state in (1, 2):
+                        self.state = 3  # successful reconnect
+                except redis.ConnectionError:
+                    assert self.state in (1, 2)
+                    self.state = 2
+                finally:
+                    self.cond.notify()
+                # assert that we noticed a connect error, or automatically
+                # reconnected without error
+                if old_state == 1:
+                    assert self.state in (2, 3)
+
+    def loop_step_get_message(self):
+        # get a single message via listen()
+        message = self.pubsub.get_message(timeout=0.1)
+        if message is not None:
+            self.messages.put(message)
+            return True
+        return False
+
+    def loop_step_listen(self):
+        # get a single message via listen()
+        for message in self.pubsub.listen():
+            self.messages.put(message)
+            return True

From c94821c11e74d360ae3ccdcf9581cfe24e120a07 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 28 Jul 2022 14:24:17 +0300
Subject: [PATCH 0549/1164] Add support for async GRAPH module (#2273)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Add support for async graph

* linters

* fix docstring

* Use retry mechanism in async version of Connection objects (#2271)

* fix is_connected (#2278)

* fix: workaround asyncio bug on connection reset by peer (#2259)

Fixes #2237

* Fix crash: key expire while search (#2270)

* fix expire while search

* sleep

* docs: Fix a few typos (#2274)

* docs: Fix a few typos

There are small typos in:
- redis/cluster.py
- redis/commands/core.py
- redis/ocsp.py
- tests/test_cluster.py

Fixes:
- Should read `validity` rather than `valididy`.
- Should read `reinitialize` rather than `reinitilize`.
- Should read `farthest` rather than `farest`.
- Should read `commands` rather than `comamnds`.

* Update core.py

* async_cluster: fix concurrent pipeline (#2280)

- each pipeline should create separate stacks for each node

* Add support for TIMESERIES 1.8 (#2296)

* Add support for timeseries 1.8

* fix info

* linters

* linters

* fix info test

* type hints

* linters

* Remove verbose logging from `redis-py/redis/cluster.py` (#2238)

* removed the logging module and its corresponding methods

* updated CHANGES

* except block for RedisClusterException and BusyLoadingError removed

* removed unused import (redis.exceptions.BusyLoadingError)

* empty commit to re-trigger Actions workflow

* replaced BaseException with Exception

* empty commit to re-trigger Actions workflow

* empty commit to re-trigger Actions workflow

* redundant logic removed

* re-trigger pipeline

* reverted changes

* re-trigger pipeline

* except logic changed

* redis stream example (#2269)

* redis stream example

* redis stream example on docs/examples.rst

Co-authored-by: pedro.frazao <perl.pf@netcf.org>

* Fix: `start_id` type for `XAUTOCLAIM` (#2257)

* Changed start_id type for xautoclaim

* Added to changes

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* Doc add timeseries example (#2267)

* DOC add timeseries example

* DOC add timeseries examples

* Apply suggestions

* Fix typo

Detention period => Retention period

Co-authored-by: Gauthier Imbert <gauthier@PC17>

* Fix warnings and resource usage problems in asyncio unittests (#2258)

* Use pytest-asyncio in auto mode
Remove overly genereric `pytestmark=pytest.mark.asyncio` causing lots of warning noise

* Use "Factories as Fixtures" test pattern for the `create_redis` fixture
this fixture is now async, avoiding teardown problems with missing event loops.

* Fix sporadic error on fast event loops, such as `--uvloop`

* Close connection, even if "username" was in kwargs
This fixes a resource usage warning in the async unittests.

* Do async cleanup of acl passwords via a fixture

* Remove unused import, fix whitespace

* Fix test with missing "await"

* Close pubsub objects after use in unittest
Use a simple fixture where possible, otherwise manually call pubsub.close()

* re-introduce `pytestmark=pytest.mark.asyncio` for python 3.6

* Use context manager to clean up connections in connection pool for unit tests

* Provide asynccontextmanager for python 3.6

* make `test_late_subscribe()` more robuste

* Catch a couple of additional leaked resources

* Graph - add counters for removed labels and properties (#2292)

* grpah - add counters for removed labels and properties

* added mock graph result set statistics

* docstrings for graph result set statistics

* format

* isort

* moved docstrings into functions

* cleaning up the readme and moving docs into readthedocs (#2291)

* cleaning up the readme and moving docs into readthedocs

* examples at the end as per pr comments

* async_cluster: fix max_connections/ssl & improve args (#2217)

* async_cluster: fix max_connections/ssl & improve args

- set proper connection_class if ssl = True
- pass max_connections/connection_class to ClusterNode
- recreate startup_nodes to properly initialize
- pass parser_class to Connection instead of changing it in on_connect
- only pass redis_connect_func if read_from_replicas = True
- add connection_error_retry_attempts parameter
- skip is_connected check in acquire_connection as it is already checked in send_packed_command

BREAKING:
- RedisCluster args except host & port are kw-only now
- RedisCluster will no longer accept unknown arguments
- RedisCluster will no longer accept url as an argument. Use RedisCluster.from_url
- RedisCluster.require_full_coverage defaults to True
- ClusterNode args except host, port, & server_type are kw-only now

* async_cluster: remove kw-only requirement from client

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* fix review comments

* fix

* fix review comments

* fix review comments

Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: szumka <106675199+szumka@users.noreply.github.com>
Co-authored-by: Mehdi ABAAKOUK <sileht@sileht.net>
Co-authored-by: Tim Gates <tim.gates@iress.com>
Co-authored-by: Utkarsh Gupta <utkarshgupta137@gmail.com>
Co-authored-by: Nial Daly <34862917+nialdaly@users.noreply.github.com>
Co-authored-by: pedrofrazao <603718+pedrofrazao@users.noreply.github.com>
Co-authored-by: pedro.frazao <perl.pf@netcf.org>
Co-authored-by: Антон Безденежных <gamer392@yandex.ru>
Co-authored-by: Iglesys <g.imbert34@gmail.com>
Co-authored-by: Gauthier Imbert <gauthier@PC17>
Co-authored-by: Kristján Valur Jónsson <sweskman@gmail.com>
Co-authored-by: DvirDukhan <dvir@redis.com>
---
 redis/commands/graph/__init__.py     | 129 ++++++-
 redis/commands/graph/commands.py     | 146 ++++++--
 redis/commands/graph/query_result.py | 371 +++++++++++++++-----
 redis/commands/redismodules.py       |  14 +-
 tests/test_asyncio/test_graph.py     | 503 +++++++++++++++++++++++++++
 5 files changed, 1028 insertions(+), 135 deletions(-)
 create mode 100644 tests/test_asyncio/test_graph.py

diff --git a/redis/commands/graph/__init__.py b/redis/commands/graph/__init__.py
index 3736195007..a882dd514d 100644
--- a/redis/commands/graph/__init__.py
+++ b/redis/commands/graph/__init__.py
@@ -1,9 +1,13 @@
 from ..helpers import quote_string, random_string, stringify_param_value
-from .commands import GraphCommands
+from .commands import AsyncGraphCommands, GraphCommands
 from .edge import Edge  # noqa
 from .node import Node  # noqa
 from .path import Path  # noqa
 
+DB_LABELS = "DB.LABELS"
+DB_RAELATIONSHIPTYPES = "DB.RELATIONSHIPTYPES"
+DB_PROPERTYKEYS = "DB.PROPERTYKEYS"
+
 
 class Graph(GraphCommands):
     """
@@ -44,25 +48,19 @@ def _refresh_labels(self):
         lbls = self.labels()
 
         # Unpack data.
-        self._labels = [None] * len(lbls)
-        for i, l in enumerate(lbls):
-            self._labels[i] = l[0]
+        self._labels = [l[0] for _, l in enumerate(lbls)]
 
     def _refresh_relations(self):
         rels = self.relationship_types()
 
         # Unpack data.
-        self._relationship_types = [None] * len(rels)
-        for i, r in enumerate(rels):
-            self._relationship_types[i] = r[0]
+        self._relationship_types = [r[0] for _, r in enumerate(rels)]
 
     def _refresh_attributes(self):
         props = self.property_keys()
 
         # Unpack data.
-        self._properties = [None] * len(props)
-        for i, p in enumerate(props):
-            self._properties[i] = p[0]
+        self._properties = [p[0] for _, p in enumerate(props)]
 
     def get_label(self, idx):
         """
@@ -108,12 +106,12 @@ def get_property(self, idx):
             The index of the property
         """
         try:
-            propertie = self._properties[idx]
+            p = self._properties[idx]
         except IndexError:
             # Refresh properties.
             self._refresh_attributes()
-            propertie = self._properties[idx]
-        return propertie
+            p = self._properties[idx]
+        return p
 
     def add_node(self, node):
         """
@@ -133,6 +131,8 @@ def add_edge(self, edge):
         self.edges.append(edge)
 
     def _build_params_header(self, params):
+        if params is None:
+            return ""
         if not isinstance(params, dict):
             raise TypeError("'params' must be a dict")
         # Header starts with "CYPHER"
@@ -147,16 +147,109 @@ def call_procedure(self, procedure, *args, read_only=False, **kwagrs):
         q = f"CALL {procedure}({','.join(args)})"
 
         y = kwagrs.get("y", None)
-        if y:
-            q += f" YIELD {','.join(y)}"
+        if y is not None:
+            q += f"YIELD {','.join(y)}"
 
         return self.query(q, read_only=read_only)
 
     def labels(self):
-        return self.call_procedure("db.labels", read_only=True).result_set
+        return self.call_procedure(DB_LABELS, read_only=True).result_set
 
     def relationship_types(self):
-        return self.call_procedure("db.relationshipTypes", read_only=True).result_set
+        return self.call_procedure(DB_RAELATIONSHIPTYPES, read_only=True).result_set
 
     def property_keys(self):
-        return self.call_procedure("db.propertyKeys", read_only=True).result_set
+        return self.call_procedure(DB_PROPERTYKEYS, read_only=True).result_set
+
+
+class AsyncGraph(Graph, AsyncGraphCommands):
+    """Async version for Graph"""
+
+    async def _refresh_labels(self):
+        lbls = await self.labels()
+
+        # Unpack data.
+        self._labels = [l[0] for _, l in enumerate(lbls)]
+
+    async def _refresh_attributes(self):
+        props = await self.property_keys()
+
+        # Unpack data.
+        self._properties = [p[0] for _, p in enumerate(props)]
+
+    async def _refresh_relations(self):
+        rels = await self.relationship_types()
+
+        # Unpack data.
+        self._relationship_types = [r[0] for _, r in enumerate(rels)]
+
+    async def get_label(self, idx):
+        """
+        Returns a label by it's index
+
+        Args:
+
+        idx:
+            The index of the label
+        """
+        try:
+            label = self._labels[idx]
+        except IndexError:
+            # Refresh labels.
+            await self._refresh_labels()
+            label = self._labels[idx]
+        return label
+
+    async def get_property(self, idx):
+        """
+        Returns a property by it's index
+
+        Args:
+
+        idx:
+            The index of the property
+        """
+        try:
+            p = self._properties[idx]
+        except IndexError:
+            # Refresh properties.
+            await self._refresh_attributes()
+            p = self._properties[idx]
+        return p
+
+    async def get_relation(self, idx):
+        """
+        Returns a relationship type by it's index
+
+        Args:
+
+        idx:
+            The index of the relation
+        """
+        try:
+            relationship_type = self._relationship_types[idx]
+        except IndexError:
+            # Refresh relationship types.
+            await self._refresh_relations()
+            relationship_type = self._relationship_types[idx]
+        return relationship_type
+
+    async def call_procedure(self, procedure, *args, read_only=False, **kwagrs):
+        args = [quote_string(arg) for arg in args]
+        q = f"CALL {procedure}({','.join(args)})"
+
+        y = kwagrs.get("y", None)
+        if y is not None:
+            f"YIELD {','.join(y)}"
+        return await self.query(q, read_only=read_only)
+
+    async def labels(self):
+        return ((await self.call_procedure(DB_LABELS, read_only=True))).result_set
+
+    async def property_keys(self):
+        return (await self.call_procedure(DB_PROPERTYKEYS, read_only=True)).result_set
+
+    async def relationship_types(self):
+        return (
+            await self.call_procedure(DB_RAELATIONSHIPTYPES, read_only=True)
+        ).result_set
diff --git a/redis/commands/graph/commands.py b/redis/commands/graph/commands.py
index fe4224b5cf..762ab42e16 100644
--- a/redis/commands/graph/commands.py
+++ b/redis/commands/graph/commands.py
@@ -3,7 +3,16 @@
 
 from .exceptions import VersionMismatchException
 from .execution_plan import ExecutionPlan
-from .query_result import QueryResult
+from .query_result import AsyncQueryResult, QueryResult
+
+PROFILE_CMD = "GRAPH.PROFILE"
+RO_QUERY_CMD = "GRAPH.RO_QUERY"
+QUERY_CMD = "GRAPH.QUERY"
+DELETE_CMD = "GRAPH.DELETE"
+SLOWLOG_CMD = "GRAPH.SLOWLOG"
+CONFIG_CMD = "GRAPH.CONFIG"
+LIST_CMD = "GRAPH.LIST"
+EXPLAIN_CMD = "GRAPH.EXPLAIN"
 
 
 class GraphCommands:
@@ -52,33 +61,28 @@ def query(self, q, params=None, timeout=None, read_only=False, profile=False):
         query = q
 
         # handle query parameters
-        if params is not None:
-            query = self._build_params_header(params) + query
+        query = self._build_params_header(params) + query
 
         # construct query command
         # ask for compact result-set format
         # specify known graph version
         if profile:
-            cmd = "GRAPH.PROFILE"
+            cmd = PROFILE_CMD
         else:
-            cmd = "GRAPH.RO_QUERY" if read_only else "GRAPH.QUERY"
+            cmd = RO_QUERY_CMD if read_only else QUERY_CMD
         command = [cmd, self.name, query, "--compact"]
 
         # include timeout is specified
-        if timeout:
-            if not isinstance(timeout, int):
-                raise Exception("Timeout argument must be a positive integer")
-            command += ["timeout", timeout]
+        if isinstance(timeout, int):
+            command.extend(["timeout", timeout])
+        elif timeout is not None:
+            raise Exception("Timeout argument must be a positive integer")
 
         # issue query
         try:
             response = self.execute_command(*command)
             return QueryResult(self, response, profile)
         except ResponseError as e:
-            if "wrong number of arguments" in str(e):
-                print(
-                    "Note: RedisGraph Python requires server version 2.2.8 or above"
-                )  # noqa
             if "unknown command" in str(e) and read_only:
                 # `GRAPH.RO_QUERY` is unavailable in older versions.
                 return self.query(q, params, timeout, read_only=False)
@@ -106,7 +110,7 @@ def delete(self):
         For more information see `DELETE <https://redis.io/commands/graph.delete>`_. # noqa
         """
         self._clear_schema()
-        return self.execute_command("GRAPH.DELETE", self.name)
+        return self.execute_command(DELETE_CMD, self.name)
 
     # declared here, to override the built in redis.db.flush()
     def flush(self):
@@ -146,7 +150,7 @@ def slowlog(self):
         3. The issued query.
         4. The amount of time needed for its execution, in milliseconds.
         """
-        return self.execute_command("GRAPH.SLOWLOG", self.name)
+        return self.execute_command(SLOWLOG_CMD, self.name)
 
     def config(self, name, value=None, set=False):
         """
@@ -170,14 +174,14 @@ def config(self, name, value=None, set=False):
                 raise DataError(
                     "``value`` can be provided only when ``set`` is True"
                 )  # noqa
-        return self.execute_command("GRAPH.CONFIG", *params)
+        return self.execute_command(CONFIG_CMD, *params)
 
     def list_keys(self):
         """
         Lists all graph keys in the keyspace.
         For more information see `GRAPH.LIST <https://redis.io/commands/graph.list>`_. # noqa
         """
-        return self.execute_command("GRAPH.LIST")
+        return self.execute_command(LIST_CMD)
 
     def execution_plan(self, query, params=None):
         """
@@ -188,10 +192,9 @@ def execution_plan(self, query, params=None):
             query: the query that will be executed
             params: query parameters
         """
-        if params is not None:
-            query = self._build_params_header(params) + query
+        query = self._build_params_header(params) + query
 
-        plan = self.execute_command("GRAPH.EXPLAIN", self.name, query)
+        plan = self.execute_command(EXPLAIN_CMD, self.name, query)
         if isinstance(plan[0], bytes):
             plan = [b.decode() for b in plan]
         return "\n".join(plan)
@@ -206,8 +209,105 @@ def explain(self, query, params=None):
             query: the query that will be executed
             params: query parameters
         """
-        if params is not None:
-            query = self._build_params_header(params) + query
+        query = self._build_params_header(params) + query
+
+        plan = self.execute_command(EXPLAIN_CMD, self.name, query)
+        return ExecutionPlan(plan)
+
+
+class AsyncGraphCommands(GraphCommands):
+    async def query(self, q, params=None, timeout=None, read_only=False, profile=False):
+        """
+        Executes a query against the graph.
+        For more information see `GRAPH.QUERY <https://oss.redis.com/redisgraph/master/commands/#graphquery>`_. # noqa
+
+        Args:
+
+        q : str
+            The query.
+        params : dict
+            Query parameters.
+        timeout : int
+            Maximum runtime for read queries in milliseconds.
+        read_only : bool
+            Executes a readonly query if set to True.
+        profile : bool
+            Return details on results produced by and time
+            spent in each operation.
+        """
+
+        # maintain original 'q'
+        query = q
+
+        # handle query parameters
+        query = self._build_params_header(params) + query
+
+        # construct query command
+        # ask for compact result-set format
+        # specify known graph version
+        if profile:
+            cmd = PROFILE_CMD
+        else:
+            cmd = RO_QUERY_CMD if read_only else QUERY_CMD
+        command = [cmd, self.name, query, "--compact"]
+
+        # include timeout is specified
+        if isinstance(timeout, int):
+            command.extend(["timeout", timeout])
+        elif timeout is not None:
+            raise Exception("Timeout argument must be a positive integer")
+
+        # issue query
+        try:
+            response = await self.execute_command(*command)
+            return await AsyncQueryResult().initialize(self, response, profile)
+        except ResponseError as e:
+            if "unknown command" in str(e) and read_only:
+                # `GRAPH.RO_QUERY` is unavailable in older versions.
+                return await self.query(q, params, timeout, read_only=False)
+            raise e
+        except VersionMismatchException as e:
+            # client view over the graph schema is out of sync
+            # set client version and refresh local schema
+            self.version = e.version
+            self._refresh_schema()
+            # re-issue query
+            return await self.query(q, params, timeout, read_only)
+
+    async def execution_plan(self, query, params=None):
+        """
+        Get the execution plan for given query,
+        GRAPH.EXPLAIN returns an array of operations.
+
+        Args:
+            query: the query that will be executed
+            params: query parameters
+        """
+        query = self._build_params_header(params) + query
 
-        plan = self.execute_command("GRAPH.EXPLAIN", self.name, query)
+        plan = await self.execute_command(EXPLAIN_CMD, self.name, query)
+        if isinstance(plan[0], bytes):
+            plan = [b.decode() for b in plan]
+        return "\n".join(plan)
+
+    async def explain(self, query, params=None):
+        """
+        Get the execution plan for given query,
+        GRAPH.EXPLAIN returns ExecutionPlan object.
+
+        Args:
+            query: the query that will be executed
+            params: query parameters
+        """
+        query = self._build_params_header(params) + query
+
+        plan = await self.execute_command(EXPLAIN_CMD, self.name, query)
         return ExecutionPlan(plan)
+
+    async def flush(self):
+        """
+        Commit the graph and reset the edges and the nodes to zero length.
+        """
+        await self.commit()
+        self.nodes = {}
+        self.edges = []
diff --git a/redis/commands/graph/query_result.py b/redis/commands/graph/query_result.py
index 3ffa664791..b88b4b656c 100644
--- a/redis/commands/graph/query_result.py
+++ b/redis/commands/graph/query_result.py
@@ -1,4 +1,6 @@
+import sys
 from collections import OrderedDict
+from distutils.util import strtobool
 
 # from prettytable import PrettyTable
 from redis import ResponseError
@@ -90,6 +92,9 @@ def __init__(self, graph, response, profile=False):
             self.parse_results(response)
 
     def _check_for_errors(self, response):
+        """
+        Check if the response contains an error.
+        """
         if isinstance(response[0], ResponseError):
             error = response[0]
             if str(error) == "version mismatch":
@@ -103,6 +108,9 @@ def _check_for_errors(self, response):
             raise response[-1]
 
     def parse_results(self, raw_result_set):
+        """
+        Parse the query execution result returned from the server.
+        """
         self.header = self.parse_header(raw_result_set)
 
         # Empty header.
@@ -112,6 +120,9 @@ def parse_results(self, raw_result_set):
         self.result_set = self.parse_records(raw_result_set)
 
     def parse_statistics(self, raw_statistics):
+        """
+        Parse the statistics returned in the response.
+        """
         self.statistics = {}
 
         # decode statistics
@@ -125,31 +136,31 @@ def parse_statistics(self, raw_statistics):
                 self.statistics[s] = v
 
     def parse_header(self, raw_result_set):
+        """
+        Parse the header of the result.
+        """
         # An array of column name/column type pairs.
         header = raw_result_set[0]
         return header
 
     def parse_records(self, raw_result_set):
-        records = []
-        result_set = raw_result_set[1]
-        for row in result_set:
-            record = []
-            for idx, cell in enumerate(row):
-                if self.header[idx][0] == ResultSetColumnTypes.COLUMN_SCALAR:  # noqa
-                    record.append(self.parse_scalar(cell))
-                elif self.header[idx][0] == ResultSetColumnTypes.COLUMN_NODE:  # noqa
-                    record.append(self.parse_node(cell))
-                elif (
-                    self.header[idx][0] == ResultSetColumnTypes.COLUMN_RELATION
-                ):  # noqa
-                    record.append(self.parse_edge(cell))
-                else:
-                    print("Unknown column type.\n")
-            records.append(record)
+        """
+        Parses the result set and returns a list of records.
+        """
+        records = [
+            [
+                self.parse_record_types[self.header[idx][0]](cell)
+                for idx, cell in enumerate(row)
+            ]
+            for row in raw_result_set[1]
+        ]
 
         return records
 
     def parse_entity_properties(self, props):
+        """
+        Parse node / edge properties.
+        """
         # [[name, value type, value] X N]
         properties = {}
         for prop in props:
@@ -160,6 +171,9 @@ def parse_entity_properties(self, props):
         return properties
 
     def parse_string(self, cell):
+        """
+        Parse the cell as a string.
+        """
         if isinstance(cell, bytes):
             return cell.decode()
         elif not isinstance(cell, str):
@@ -168,6 +182,9 @@ def parse_string(self, cell):
             return cell
 
     def parse_node(self, cell):
+        """
+        Parse the cell to a node.
+        """
         # Node ID (integer),
         # [label string offset (integer)],
         # [[name, value type, value] X N]
@@ -182,6 +199,9 @@ def parse_node(self, cell):
         return Node(node_id=node_id, label=labels, properties=properties)
 
     def parse_edge(self, cell):
+        """
+        Parse the cell to an edge.
+        """
         # Edge ID (integer),
         # reltype string offset (integer),
         # src node ID offset (integer),
@@ -198,11 +218,17 @@ def parse_edge(self, cell):
         )
 
     def parse_path(self, cell):
+        """
+        Parse the cell to a path.
+        """
         nodes = self.parse_scalar(cell[0])
         edges = self.parse_scalar(cell[1])
         return Path(nodes, edges)
 
     def parse_map(self, cell):
+        """
+        Parse the cell as a map.
+        """
         m = OrderedDict()
         n_entries = len(cell)
 
@@ -216,6 +242,9 @@ def parse_map(self, cell):
         return m
 
     def parse_point(self, cell):
+        """
+        Parse the cell to point.
+        """
         p = {}
         # A point is received an array of the form: [latitude, longitude]
         # It is returned as a map of the form: {"latitude": latitude, "longitude": longitude} # noqa
@@ -223,94 +252,63 @@ def parse_point(self, cell):
         p["longitude"] = float(cell[1])
         return p
 
-    def parse_scalar(self, cell):
-        scalar_type = int(cell[0])
-        value = cell[1]
-        scalar = None
-
-        if scalar_type == ResultSetScalarTypes.VALUE_NULL:
-            scalar = None
-
-        elif scalar_type == ResultSetScalarTypes.VALUE_STRING:
-            scalar = self.parse_string(value)
-
-        elif scalar_type == ResultSetScalarTypes.VALUE_INTEGER:
-            scalar = int(value)
-
-        elif scalar_type == ResultSetScalarTypes.VALUE_BOOLEAN:
-            value = value.decode() if isinstance(value, bytes) else value
-            if value == "true":
-                scalar = True
-            elif value == "false":
-                scalar = False
-            else:
-                print("Unknown boolean type\n")
-
-        elif scalar_type == ResultSetScalarTypes.VALUE_DOUBLE:
-            scalar = float(value)
-
-        elif scalar_type == ResultSetScalarTypes.VALUE_ARRAY:
-            # array variable is introduced only for readability
-            scalar = array = value
-            for i in range(len(array)):
-                scalar[i] = self.parse_scalar(array[i])
+    def parse_null(self, cell):
+        """
+        Parse a null value.
+        """
+        return None
 
-        elif scalar_type == ResultSetScalarTypes.VALUE_NODE:
-            scalar = self.parse_node(value)
+    def parse_integer(self, cell):
+        """
+        Parse the integer value from the cell.
+        """
+        return int(cell)
 
-        elif scalar_type == ResultSetScalarTypes.VALUE_EDGE:
-            scalar = self.parse_edge(value)
+    def parse_boolean(self, value):
+        """
+        Parse the cell value as a boolean.
+        """
+        value = value.decode() if isinstance(value, bytes) else value
+        try:
+            scalar = strtobool(value)
+        except ValueError:
+            sys.stderr.write("unknown boolean type\n")
+            scalar = None
+        return scalar
 
-        elif scalar_type == ResultSetScalarTypes.VALUE_PATH:
-            scalar = self.parse_path(value)
+    def parse_double(self, cell):
+        """
+        Parse the cell as a double.
+        """
+        return float(cell)
 
-        elif scalar_type == ResultSetScalarTypes.VALUE_MAP:
-            scalar = self.parse_map(value)
+    def parse_array(self, value):
+        """
+        Parse an array of values.
+        """
+        scalar = [self.parse_scalar(value[i]) for i in range(len(value))]
+        return scalar
 
-        elif scalar_type == ResultSetScalarTypes.VALUE_POINT:
-            scalar = self.parse_point(value)
+    def parse_unknown(self, cell):
+        """
+        Parse a cell of unknown type.
+        """
+        sys.stderr.write("Unknown type\n")
+        return None
 
-        elif scalar_type == ResultSetScalarTypes.VALUE_UNKNOWN:
-            print("Unknown scalar type\n")
+    def parse_scalar(self, cell):
+        """
+        Parse a scalar value from a cell in the result set.
+        """
+        scalar_type = int(cell[0])
+        value = cell[1]
+        scalar = self.parse_scalar_types[scalar_type](value)
 
         return scalar
 
     def parse_profile(self, response):
         self.result_set = [x[0 : x.index(",")].strip() for x in response]
 
-    # """Prints the data from the query response:
-    #    1. First row result_set contains the columns names.
-    #       Thus the first row in PrettyTable will contain the
-    #       columns.
-    #    2. The row after that will contain the data returned,
-    #       or 'No Data returned' if there is none.
-    #    3. Prints the statistics of the query.
-    # """
-
-    # def pretty_print(self):
-    #     if not self.is_empty():
-    #         header = [col[1] for col in self.header]
-    #         tbl = PrettyTable(header)
-
-    #         for row in self.result_set:
-    #             record = []
-    #             for idx, cell in enumerate(row):
-    #                 if type(cell) is Node:
-    #                     record.append(cell.to_string())
-    #                 elif type(cell) is Edge:
-    #                     record.append(cell.to_string())
-    #                 else:
-    #                     record.append(cell)
-    #             tbl.add_row(record)
-
-    #         if len(self.result_set) == 0:
-    #             tbl.add_row(['No data returned.'])
-
-    #         print(str(tbl) + '\n')
-
-    #     for stat in self.statistics:
-    #         print("%s %s" % (stat, self.statistics[stat]))
-
     def is_empty(self):
         return len(self.result_set) == 0
 
@@ -384,3 +382,192 @@ def cached_execution(self):
     def run_time_ms(self):
         """Returns the server execution time of the query"""
         return self._get_stat(INTERNAL_EXECUTION_TIME)
+
+    @property
+    def parse_scalar_types(self):
+        return {
+            ResultSetScalarTypes.VALUE_NULL: self.parse_null,
+            ResultSetScalarTypes.VALUE_STRING: self.parse_string,
+            ResultSetScalarTypes.VALUE_INTEGER: self.parse_integer,
+            ResultSetScalarTypes.VALUE_BOOLEAN: self.parse_boolean,
+            ResultSetScalarTypes.VALUE_DOUBLE: self.parse_double,
+            ResultSetScalarTypes.VALUE_ARRAY: self.parse_array,
+            ResultSetScalarTypes.VALUE_NODE: self.parse_node,
+            ResultSetScalarTypes.VALUE_EDGE: self.parse_edge,
+            ResultSetScalarTypes.VALUE_PATH: self.parse_path,
+            ResultSetScalarTypes.VALUE_MAP: self.parse_map,
+            ResultSetScalarTypes.VALUE_POINT: self.parse_point,
+            ResultSetScalarTypes.VALUE_UNKNOWN: self.parse_unknown,
+        }
+
+    @property
+    def parse_record_types(self):
+        return {
+            ResultSetColumnTypes.COLUMN_SCALAR: self.parse_scalar,
+            ResultSetColumnTypes.COLUMN_NODE: self.parse_node,
+            ResultSetColumnTypes.COLUMN_RELATION: self.parse_edge,
+            ResultSetColumnTypes.COLUMN_UNKNOWN: self.parse_unknown,
+        }
+
+
+class AsyncQueryResult(QueryResult):
+    """
+    Async version for the QueryResult class - a class that
+    represents a result of the query operation.
+    """
+
+    def __init__(self):
+        """
+        To init the class you must call self.initialize()
+        """
+        pass
+
+    async def initialize(self, graph, response, profile=False):
+        """
+        Initializes the class.
+        Args:
+
+        graph:
+            The graph on which the query was executed.
+        response:
+            The response from the server.
+        profile:
+            A boolean indicating if the query command was "GRAPH.PROFILE"
+        """
+        self.graph = graph
+        self.header = []
+        self.result_set = []
+
+        # in case of an error an exception will be raised
+        self._check_for_errors(response)
+
+        if len(response) == 1:
+            self.parse_statistics(response[0])
+        elif profile:
+            self.parse_profile(response)
+        else:
+            # start by parsing statistics, matches the one we have
+            self.parse_statistics(response[-1])  # Last element.
+            await self.parse_results(response)
+
+        return self
+
+    async def parse_node(self, cell):
+        """
+        Parses a node from the cell.
+        """
+        # Node ID (integer),
+        # [label string offset (integer)],
+        # [[name, value type, value] X N]
+
+        labels = None
+        if len(cell[1]) > 0:
+            labels = []
+            for inner_label in cell[1]:
+                labels.append(await self.graph.get_label(inner_label))
+        properties = await self.parse_entity_properties(cell[2])
+        node_id = int(cell[0])
+        return Node(node_id=node_id, label=labels, properties=properties)
+
+    async def parse_scalar(self, cell):
+        """
+        Parses a scalar value from the server response.
+        """
+        scalar_type = int(cell[0])
+        value = cell[1]
+        try:
+            scalar = await self.parse_scalar_types[scalar_type](value)
+        except TypeError:
+            # Not all of the functions are async
+            scalar = self.parse_scalar_types[scalar_type](value)
+
+        return scalar
+
+    async def parse_records(self, raw_result_set):
+        """
+        Parses the result set and returns a list of records.
+        """
+        records = []
+        for row in raw_result_set[1]:
+            record = [
+                await self.parse_record_types[self.header[idx][0]](cell)
+                for idx, cell in enumerate(row)
+            ]
+            records.append(record)
+
+        return records
+
+    async def parse_results(self, raw_result_set):
+        """
+        Parse the query execution result returned from the server.
+        """
+        self.header = self.parse_header(raw_result_set)
+
+        # Empty header.
+        if len(self.header) == 0:
+            return
+
+        self.result_set = await self.parse_records(raw_result_set)
+
+    async def parse_entity_properties(self, props):
+        """
+        Parse node / edge properties.
+        """
+        # [[name, value type, value] X N]
+        properties = {}
+        for prop in props:
+            prop_name = await self.graph.get_property(prop[0])
+            prop_value = await self.parse_scalar(prop[1:])
+            properties[prop_name] = prop_value
+
+        return properties
+
+    async def parse_edge(self, cell):
+        """
+        Parse the cell to an edge.
+        """
+        # Edge ID (integer),
+        # reltype string offset (integer),
+        # src node ID offset (integer),
+        # dest node ID offset (integer),
+        # [[name, value, value type] X N]
+
+        edge_id = int(cell[0])
+        relation = await self.graph.get_relation(cell[1])
+        src_node_id = int(cell[2])
+        dest_node_id = int(cell[3])
+        properties = await self.parse_entity_properties(cell[4])
+        return Edge(
+            src_node_id, relation, dest_node_id, edge_id=edge_id, properties=properties
+        )
+
+    async def parse_path(self, cell):
+        """
+        Parse the cell to a path.
+        """
+        nodes = await self.parse_scalar(cell[0])
+        edges = await self.parse_scalar(cell[1])
+        return Path(nodes, edges)
+
+    async def parse_map(self, cell):
+        """
+        Parse the cell to a map.
+        """
+        m = OrderedDict()
+        n_entries = len(cell)
+
+        # A map is an array of key value pairs.
+        # 1. key (string)
+        # 2. array: (value type, value)
+        for i in range(0, n_entries, 2):
+            key = self.parse_string(cell[i])
+            m[key] = await self.parse_scalar(cell[i + 1])
+
+        return m
+
+    async def parse_array(self, value):
+        """
+        Parse array value.
+        """
+        scalar = [await self.parse_scalar(value[i]) for i in range(len(value))]
+        return scalar
diff --git a/redis/commands/redismodules.py b/redis/commands/redismodules.py
index 875f3fca25..7e2045a722 100644
--- a/redis/commands/redismodules.py
+++ b/redis/commands/redismodules.py
@@ -73,8 +73,8 @@ def tdigest(self):
         return tdigest
 
     def graph(self, index_name="idx"):
-        """Access the timeseries namespace, providing support for
-        redis timeseries data.
+        """Access the graph namespace, providing support for
+        redis graph data.
         """
 
         from .graph import Graph
@@ -91,3 +91,13 @@ def ft(self, index_name="idx"):
 
         s = AsyncSearch(client=self, index_name=index_name)
         return s
+
+    def graph(self, index_name="idx"):
+        """Access the graph namespace, providing support for
+        redis graph data.
+        """
+
+        from .graph import AsyncGraph
+
+        g = AsyncGraph(client=self, name=index_name)
+        return g
diff --git a/tests/test_asyncio/test_graph.py b/tests/test_asyncio/test_graph.py
new file mode 100644
index 0000000000..8a8f9cf953
--- /dev/null
+++ b/tests/test_asyncio/test_graph.py
@@ -0,0 +1,503 @@
+import pytest
+
+import redis.asyncio as redis
+from redis.commands.graph import Edge, Node, Path
+from redis.commands.graph.execution_plan import Operation
+from redis.exceptions import ResponseError
+from tests.conftest import skip_if_redis_enterprise
+
+
+@pytest.mark.redismod
+async def test_bulk(modclient):
+    with pytest.raises(NotImplementedError):
+        await modclient.graph().bulk()
+        await modclient.graph().bulk(foo="bar!")
+
+
+@pytest.mark.redismod
+async def test_graph_creation(modclient: redis.Redis):
+    graph = modclient.graph()
+
+    john = Node(
+        label="person",
+        properties={
+            "name": "John Doe",
+            "age": 33,
+            "gender": "male",
+            "status": "single",
+        },
+    )
+    graph.add_node(john)
+    japan = Node(label="country", properties={"name": "Japan"})
+
+    graph.add_node(japan)
+    edge = Edge(john, "visited", japan, properties={"purpose": "pleasure"})
+    graph.add_edge(edge)
+
+    await graph.commit()
+
+    query = (
+        'MATCH (p:person)-[v:visited {purpose:"pleasure"}]->(c:country) '
+        "RETURN p, v, c"
+    )
+
+    result = await graph.query(query)
+
+    person = result.result_set[0][0]
+    visit = result.result_set[0][1]
+    country = result.result_set[0][2]
+
+    assert person == john
+    assert visit.properties == edge.properties
+    assert country == japan
+
+    query = """RETURN [1, 2.3, "4", true, false, null]"""
+    result = await graph.query(query)
+    assert [1, 2.3, "4", True, False, None] == result.result_set[0][0]
+
+    # All done, remove graph.
+    await graph.delete()
+
+
+@pytest.mark.redismod
+async def test_array_functions(modclient: redis.Redis):
+    graph = modclient.graph()
+
+    query = """CREATE (p:person{name:'a',age:32, array:[0,1,2]})"""
+    await graph.query(query)
+
+    query = """WITH [0,1,2] as x return x"""
+    result = await graph.query(query)
+    assert [0, 1, 2] == result.result_set[0][0]
+
+    query = """MATCH(n) return collect(n)"""
+    result = await graph.query(query)
+
+    a = Node(
+        node_id=0,
+        label="person",
+        properties={"name": "a", "age": 32, "array": [0, 1, 2]},
+    )
+
+    assert [a] == result.result_set[0][0]
+
+
+@pytest.mark.redismod
+async def test_path(modclient: redis.Redis):
+    node0 = Node(node_id=0, label="L1")
+    node1 = Node(node_id=1, label="L1")
+    edge01 = Edge(node0, "R1", node1, edge_id=0, properties={"value": 1})
+
+    graph = modclient.graph()
+    graph.add_node(node0)
+    graph.add_node(node1)
+    graph.add_edge(edge01)
+    await graph.flush()
+
+    path01 = Path.new_empty_path().add_node(node0).add_edge(edge01).add_node(node1)
+    expected_results = [[path01]]
+
+    query = "MATCH p=(:L1)-[:R1]->(:L1) RETURN p ORDER BY p"
+    result = await graph.query(query)
+    assert expected_results == result.result_set
+
+
+@pytest.mark.redismod
+async def test_param(modclient: redis.Redis):
+    params = [1, 2.3, "str", True, False, None, [0, 1, 2]]
+    query = "RETURN $param"
+    for param in params:
+        result = await modclient.graph().query(query, {"param": param})
+        expected_results = [[param]]
+        assert expected_results == result.result_set
+
+
+@pytest.mark.redismod
+async def test_map(modclient: redis.Redis):
+    query = "RETURN {a:1, b:'str', c:NULL, d:[1,2,3], e:True, f:{x:1, y:2}}"
+
+    actual = (await modclient.graph().query(query)).result_set[0][0]
+    expected = {
+        "a": 1,
+        "b": "str",
+        "c": None,
+        "d": [1, 2, 3],
+        "e": True,
+        "f": {"x": 1, "y": 2},
+    }
+
+    assert actual == expected
+
+
+@pytest.mark.redismod
+async def test_point(modclient: redis.Redis):
+    query = "RETURN point({latitude: 32.070794860, longitude: 34.820751118})"
+    expected_lat = 32.070794860
+    expected_lon = 34.820751118
+    actual = (await modclient.graph().query(query)).result_set[0][0]
+    assert abs(actual["latitude"] - expected_lat) < 0.001
+    assert abs(actual["longitude"] - expected_lon) < 0.001
+
+    query = "RETURN point({latitude: 32, longitude: 34.0})"
+    expected_lat = 32
+    expected_lon = 34
+    actual = (await modclient.graph().query(query)).result_set[0][0]
+    assert abs(actual["latitude"] - expected_lat) < 0.001
+    assert abs(actual["longitude"] - expected_lon) < 0.001
+
+
+@pytest.mark.redismod
+async def test_index_response(modclient: redis.Redis):
+    result_set = await modclient.graph().query("CREATE INDEX ON :person(age)")
+    assert 1 == result_set.indices_created
+
+    result_set = await modclient.graph().query("CREATE INDEX ON :person(age)")
+    assert 0 == result_set.indices_created
+
+    result_set = await modclient.graph().query("DROP INDEX ON :person(age)")
+    assert 1 == result_set.indices_deleted
+
+    with pytest.raises(ResponseError):
+        await modclient.graph().query("DROP INDEX ON :person(age)")
+
+
+@pytest.mark.redismod
+async def test_stringify_query_result(modclient: redis.Redis):
+    graph = modclient.graph()
+
+    john = Node(
+        alias="a",
+        label="person",
+        properties={
+            "name": "John Doe",
+            "age": 33,
+            "gender": "male",
+            "status": "single",
+        },
+    )
+    graph.add_node(john)
+
+    japan = Node(alias="b", label="country", properties={"name": "Japan"})
+    graph.add_node(japan)
+
+    edge = Edge(john, "visited", japan, properties={"purpose": "pleasure"})
+    graph.add_edge(edge)
+
+    assert (
+        str(john)
+        == """(a:person{age:33,gender:"male",name:"John Doe",status:"single"})"""  # noqa
+    )
+    assert (
+        str(edge)
+        == """(a:person{age:33,gender:"male",name:"John Doe",status:"single"})"""  # noqa
+        + """-[:visited{purpose:"pleasure"}]->"""
+        + """(b:country{name:"Japan"})"""
+    )
+    assert str(japan) == """(b:country{name:"Japan"})"""
+
+    await graph.commit()
+
+    query = """MATCH (p:person)-[v:visited {purpose:"pleasure"}]->(c:country)
+            RETURN p, v, c"""
+
+    result = await graph.query(query)
+    person = result.result_set[0][0]
+    visit = result.result_set[0][1]
+    country = result.result_set[0][2]
+
+    assert (
+        str(person)
+        == """(:person{age:33,gender:"male",name:"John Doe",status:"single"})"""  # noqa
+    )
+    assert str(visit) == """()-[:visited{purpose:"pleasure"}]->()"""
+    assert str(country) == """(:country{name:"Japan"})"""
+
+    await graph.delete()
+
+
+@pytest.mark.redismod
+async def test_optional_match(modclient: redis.Redis):
+    # Build a graph of form (a)-[R]->(b)
+    node0 = Node(node_id=0, label="L1", properties={"value": "a"})
+    node1 = Node(node_id=1, label="L1", properties={"value": "b"})
+
+    edge01 = Edge(node0, "R", node1, edge_id=0)
+
+    graph = modclient.graph()
+    graph.add_node(node0)
+    graph.add_node(node1)
+    graph.add_edge(edge01)
+    await graph.flush()
+
+    # Issue a query that collects all outgoing edges from both nodes
+    # (the second has none)
+    query = """MATCH (a) OPTIONAL MATCH (a)-[e]->(b) RETURN a, e, b ORDER BY a.value"""  # noqa
+    expected_results = [[node0, edge01, node1], [node1, None, None]]
+
+    result = await graph.query(query)
+    assert expected_results == result.result_set
+
+    await graph.delete()
+
+
+@pytest.mark.redismod
+async def test_cached_execution(modclient: redis.Redis):
+    await modclient.graph().query("CREATE ()")
+
+    uncached_result = await modclient.graph().query(
+        "MATCH (n) RETURN n, $param", {"param": [0]}
+    )
+    assert uncached_result.cached_execution is False
+
+    # loop to make sure the query is cached on each thread on server
+    for x in range(0, 64):
+        cached_result = await modclient.graph().query(
+            "MATCH (n) RETURN n, $param", {"param": [0]}
+        )
+        assert uncached_result.result_set == cached_result.result_set
+
+    # should be cached on all threads by now
+    assert cached_result.cached_execution
+
+
+@pytest.mark.redismod
+async def test_slowlog(modclient: redis.Redis):
+    create_query = """CREATE (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
+    (:Rider {name:'Dani Pedrosa'})-[:rides]->(:Team {name:'Honda'}),
+    (:Rider {name:'Andrea Dovizioso'})-[:rides]->(:Team {name:'Ducati'})"""
+    await modclient.graph().query(create_query)
+
+    results = await modclient.graph().slowlog()
+    assert results[0][1] == "GRAPH.QUERY"
+    assert results[0][2] == create_query
+
+
+@pytest.mark.redismod
+async def test_query_timeout(modclient: redis.Redis):
+    # Build a sample graph with 1000 nodes.
+    await modclient.graph().query("UNWIND range(0,1000) as val CREATE ({v: val})")
+    # Issue a long-running query with a 1-millisecond timeout.
+    with pytest.raises(ResponseError):
+        await modclient.graph().query("MATCH (a), (b), (c), (d) RETURN *", timeout=1)
+        assert False is False
+
+    with pytest.raises(Exception):
+        await modclient.graph().query("RETURN 1", timeout="str")
+        assert False is False
+
+
+@pytest.mark.redismod
+async def test_read_only_query(modclient: redis.Redis):
+    with pytest.raises(Exception):
+        # Issue a write query, specifying read-only true,
+        # this call should fail.
+        await modclient.graph().query("CREATE (p:person {name:'a'})", read_only=True)
+        assert False is False
+
+
+@pytest.mark.redismod
+async def test_profile(modclient: redis.Redis):
+    q = """UNWIND range(1, 3) AS x CREATE (p:Person {v:x})"""
+    profile = (await modclient.graph().profile(q)).result_set
+    assert "Create | Records produced: 3" in profile
+    assert "Unwind | Records produced: 3" in profile
+
+    q = "MATCH (p:Person) WHERE p.v > 1 RETURN p"
+    profile = (await modclient.graph().profile(q)).result_set
+    assert "Results | Records produced: 2" in profile
+    assert "Project | Records produced: 2" in profile
+    assert "Filter | Records produced: 2" in profile
+    assert "Node By Label Scan | (p:Person) | Records produced: 3" in profile
+
+
+@pytest.mark.redismod
+@skip_if_redis_enterprise()
+async def test_config(modclient: redis.Redis):
+    config_name = "RESULTSET_SIZE"
+    config_value = 3
+
+    # Set configuration
+    response = await modclient.graph().config(config_name, config_value, set=True)
+    assert response == "OK"
+
+    # Make sure config been updated.
+    response = await modclient.graph().config(config_name, set=False)
+    expected_response = [config_name, config_value]
+    assert response == expected_response
+
+    config_name = "QUERY_MEM_CAPACITY"
+    config_value = 1 << 20  # 1MB
+
+    # Set configuration
+    response = await modclient.graph().config(config_name, config_value, set=True)
+    assert response == "OK"
+
+    # Make sure config been updated.
+    response = await modclient.graph().config(config_name, set=False)
+    expected_response = [config_name, config_value]
+    assert response == expected_response
+
+    # reset to default
+    await modclient.graph().config("QUERY_MEM_CAPACITY", 0, set=True)
+    await modclient.graph().config("RESULTSET_SIZE", -100, set=True)
+
+
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+async def test_list_keys(modclient: redis.Redis):
+    result = await modclient.graph().list_keys()
+    assert result == []
+
+    await modclient.execute_command("GRAPH.EXPLAIN", "G", "RETURN 1")
+    result = await modclient.graph().list_keys()
+    assert result == ["G"]
+
+    await modclient.execute_command("GRAPH.EXPLAIN", "X", "RETURN 1")
+    result = await modclient.graph().list_keys()
+    assert result == ["G", "X"]
+
+    await modclient.delete("G")
+    await modclient.rename("X", "Z")
+    result = await modclient.graph().list_keys()
+    assert result == ["Z"]
+
+    await modclient.delete("Z")
+    result = await modclient.graph().list_keys()
+    assert result == []
+
+
+@pytest.mark.redismod
+async def test_multi_label(modclient: redis.Redis):
+    redis_graph = modclient.graph("g")
+
+    node = Node(label=["l", "ll"])
+    redis_graph.add_node(node)
+    await redis_graph.commit()
+
+    query = "MATCH (n) RETURN n"
+    result = await redis_graph.query(query)
+    result_node = result.result_set[0][0]
+    assert result_node == node
+
+    try:
+        Node(label=1)
+        assert False
+    except AssertionError:
+        assert True
+
+    try:
+        Node(label=["l", 1])
+        assert False
+    except AssertionError:
+        assert True
+
+
+@pytest.mark.redismod
+async def test_execution_plan(modclient: redis.Redis):
+    redis_graph = modclient.graph("execution_plan")
+    create_query = """CREATE (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
+    (:Rider {name:'Dani Pedrosa'})-[:rides]->(:Team {name:'Honda'}),
+    (:Rider {name:'Andrea Dovizioso'})-[:rides]->(:Team {name:'Ducati'})"""
+    await redis_graph.query(create_query)
+
+    result = await redis_graph.execution_plan(
+        "MATCH (r:Rider)-[:rides]->(t:Team) WHERE t.name = $name RETURN r.name, t.name, $params",  # noqa
+        {"name": "Yehuda"},
+    )
+    expected = "Results\n    Project\n        Conditional Traverse | (t:Team)->(r:Rider)\n            Filter\n                Node By Label Scan | (t:Team)"  # noqa
+    assert result == expected
+
+    await redis_graph.delete()
+
+
+@pytest.mark.redismod
+async def test_explain(modclient: redis.Redis):
+    redis_graph = modclient.graph("execution_plan")
+    # graph creation / population
+    create_query = """CREATE
+(:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
+(:Rider {name:'Dani Pedrosa'})-[:rides]->(:Team {name:'Honda'}),
+(:Rider {name:'Andrea Dovizioso'})-[:rides]->(:Team {name:'Ducati'})"""
+    await redis_graph.query(create_query)
+
+    result = await redis_graph.explain(
+        """MATCH (r:Rider)-[:rides]->(t:Team)
+WHERE t.name = $name
+RETURN r.name, t.name
+UNION
+MATCH (r:Rider)-[:rides]->(t:Team)
+WHERE t.name = $name
+RETURN r.name, t.name""",
+        {"name": "Yamaha"},
+    )
+    expected = """\
+Results
+Distinct
+    Join
+        Project
+            Conditional Traverse | (t:Team)->(r:Rider)
+                Filter
+                    Node By Label Scan | (t:Team)
+        Project
+            Conditional Traverse | (t:Team)->(r:Rider)
+                Filter
+                    Node By Label Scan | (t:Team)"""
+    assert str(result).replace(" ", "").replace("\n", "") == expected.replace(
+        " ", ""
+    ).replace("\n", "")
+
+    expected = Operation("Results").append_child(
+        Operation("Distinct").append_child(
+            Operation("Join")
+            .append_child(
+                Operation("Project").append_child(
+                    Operation(
+                        "Conditional Traverse", "(t:Team)->(r:Rider)"
+                    ).append_child(
+                        Operation("Filter").append_child(
+                            Operation("Node By Label Scan", "(t:Team)")
+                        )
+                    )
+                )
+            )
+            .append_child(
+                Operation("Project").append_child(
+                    Operation(
+                        "Conditional Traverse", "(t:Team)->(r:Rider)"
+                    ).append_child(
+                        Operation("Filter").append_child(
+                            Operation("Node By Label Scan", "(t:Team)")
+                        )
+                    )
+                )
+            )
+        )
+    )
+
+    assert result.structured_plan == expected
+
+    result = await redis_graph.explain(
+        """MATCH (r:Rider), (t:Team)
+                                    RETURN r.name, t.name"""
+    )
+    expected = """\
+Results
+Project
+    Cartesian Product
+        Node By Label Scan | (r:Rider)
+        Node By Label Scan | (t:Team)"""
+    assert str(result).replace(" ", "").replace("\n", "") == expected.replace(
+        " ", ""
+    ).replace("\n", "")
+
+    expected = Operation("Results").append_child(
+        Operation("Project").append_child(
+            Operation("Cartesian Product")
+            .append_child(Operation("Node By Label Scan"))
+            .append_child(Operation("Node By Label Scan"))
+        )
+    )
+
+    assert result.structured_plan == expected
+
+    await redis_graph.delete()

From fee83ae749cbb77700899545270c514a198c14da Mon Sep 17 00:00:00 2001
From: Agustin Marquez <agusdmb@gmail.com>
Date: Sun, 31 Jul 2022 12:27:16 +0200
Subject: [PATCH 0550/1164] Fix typing on smembers command (#2312)

---
 redis/commands/core.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 455c3f46cb..4243679626 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -17,6 +17,7 @@
     Mapping,
     Optional,
     Sequence,
+    Set,
     Tuple,
     Union,
 )
@@ -3257,7 +3258,7 @@ def sismember(self, name: str, value: str) -> Union[Awaitable[bool], bool]:
         """
         return self.execute_command("SISMEMBER", name, value)
 
-    def smembers(self, name: str) -> Union[Awaitable[list], list]:
+    def smembers(self, name: str) -> Union[Awaitable[Set], Set]:
         """
         Return all members of the set ``name``
 

From 01cc2b2b0251c21937da00d9e76fa08067922c4a Mon Sep 17 00:00:00 2001
From: Nikita Sobolev <mail@sobolevn.me>
Date: Sun, 31 Jul 2022 13:27:31 +0300
Subject: [PATCH 0551/1164] Remove python2-only `__nonzero__` method from
 `cluster.py` (#2313)

---
 redis/cluster.py | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index b05cf307db..f5844fd62a 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -1755,10 +1755,6 @@ def __len__(self):
         """ """
         return len(self.command_stack)
 
-    def __nonzero__(self):
-        "Pipeline instances should  always evaluate to True on Python 2.7"
-        return True
-
     def __bool__(self):
         "Pipeline instances should  always evaluate to True on Python 3+"
         return True

From da9d903249d6a5ed1ef8bf66d9e9408a1ab7cd31 Mon Sep 17 00:00:00 2001
From: Andrei Andrukhovich <aaandrukhovich@yandex.ru>
Date: Sun, 31 Jul 2022 13:27:53 +0300
Subject: [PATCH 0552/1164] Fix typo (double "of" word) (#2314)

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index d4f324209a..80e2cc2e7c 100644
--- a/README.md
+++ b/README.md
@@ -52,7 +52,7 @@ The above code connects to localhost on port 6379, sets a value in Redis, and re
 
 ### Connection Pools
 
-By default, redis-py uses a connection pool to manage connections. Each instance of of a Redis class receives its own connection pool. You can however define your own [redis.ConnectionPool](https://redis.readthedocs.io/en/stable/connections.html#connection-pools)
+By default, redis-py uses a connection pool to manage connections. Each instance of a Redis class receives its own connection pool. You can however define your own [redis.ConnectionPool](https://redis.readthedocs.io/en/stable/connections.html#connection-pools)
 
 ``` python
 >>> pool = redis.ConnectionPool(host='localhost', port=6379, db=0)

From fd9fea6bc07bf0970a5a42c5ec1788272446910c Mon Sep 17 00:00:00 2001
From: Greg Melton <gmelton@gmail.com>
Date: Tue, 2 Aug 2022 01:08:40 -0700
Subject: [PATCH 0553/1164] ClusterPipeline Doesn't Handle ConnectionError for
 Dead Hosts (#2225)

* adds a retry that forces the nodes_manager to reinitialize if cluster pipleline connect to the one of the mapped nodes

* fix line length error

* add trailing comma

* move appending cmd

* updates changes

* trigger build

* fix linting errors
---
 CHANGES          |  2 ++
 redis/cluster.py | 69 ++++++++++++++++++++++++++++++------------------
 2 files changed, 46 insertions(+), 25 deletions(-)

diff --git a/CHANGES b/CHANGES
index 2abf62766f..d2033ca085 100644
--- a/CHANGES
+++ b/CHANGES
@@ -16,6 +16,8 @@
     * Added dynaminc_startup_nodes configuration to RedisCluster
     * Fix reusing the old nodes' connections when cluster topology refresh is being done
     * Fix RedisCluster to immediately raise AuthenticationError without a retry
+    * ClusterPipeline Doesn't Handle ConnectionError for Dead Hosts (#2225)
+
 * 4.1.3 (Feb 8, 2022)
     * Fix flushdb and flushall (#1926)
     * Add redis5 and redis4 dockers (#1871)
diff --git a/redis/cluster.py b/redis/cluster.py
index f5844fd62a..cee578b075 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -1897,34 +1897,53 @@ def _send_cluster_commands(
         # we figure out the slot number that command maps to, then from
         # the slot determine the node.
         for c in attempt:
-            # refer to our internal node -> slot table that
-            # tells us where a given
-            # command should route to.
-            passed_targets = c.options.pop("target_nodes", None)
-            if passed_targets and not self._is_nodes_flag(passed_targets):
-                target_nodes = self._parse_target_nodes(passed_targets)
-            else:
-                target_nodes = self._determine_nodes(*c.args, node_flag=passed_targets)
-                if not target_nodes:
+            connection_error_retry_counter = 0
+            while True:
+                # refer to our internal node -> slot table that
+                # tells us where a given command should route to.
+                # (it might be possible we have a cached node that no longer
+                # exists in the cluster, which is why we do this in a loop)
+                passed_targets = c.options.pop("target_nodes", None)
+                if passed_targets and not self._is_nodes_flag(passed_targets):
+                    target_nodes = self._parse_target_nodes(passed_targets)
+                else:
+                    target_nodes = self._determine_nodes(
+                        *c.args, node_flag=passed_targets
+                    )
+                    if not target_nodes:
+                        raise RedisClusterException(
+                            f"No targets were found to execute {c.args} command on"
+                        )
+                if len(target_nodes) > 1:
                     raise RedisClusterException(
-                        f"No targets were found to execute {c.args} command on"
+                        f"Too many targets for command {c.args}"
                     )
-            if len(target_nodes) > 1:
-                raise RedisClusterException(f"Too many targets for command {c.args}")
-
-            node = target_nodes[0]
-            # now that we know the name of the node
-            # ( it's just a string in the form of host:port )
-            # we can build a list of commands for each node.
-            node_name = node.name
-            if node_name not in nodes:
-                redis_node = self.get_redis_connection(node)
-                connection = get_connection(redis_node, c.args)
-                nodes[node_name] = NodeCommands(
-                    redis_node.parse_response, redis_node.connection_pool, connection
-                )
 
-            nodes[node_name].append(c)
+                node = target_nodes[0]
+
+                # now that we know the name of the node
+                # ( it's just a string in the form of host:port )
+                # we can build a list of commands for each node.
+                node_name = node.name
+                if node_name not in nodes:
+                    redis_node = self.get_redis_connection(node)
+                    try:
+                        connection = get_connection(redis_node, c.args)
+                    except ConnectionError:
+                        connection_error_retry_counter += 1
+                        if connection_error_retry_counter < 5:
+                            # reinitialize the node -> slot table
+                            self.nodes_manager.initialize()
+                            continue
+                        else:
+                            raise
+                    nodes[node_name] = NodeCommands(
+                        redis_node.parse_response,
+                        redis_node.connection_pool,
+                        connection,
+                    )
+                nodes[node_name].append(c)
+                break
 
         # send the commands in sequence.
         # we  write to all the open sockets for each node first,

From 4ed8aba8441ae841e2c8e698b84ebda1da8208f9 Mon Sep 17 00:00:00 2001
From: joe <32424163+joekohlsdorf@users.noreply.github.com>
Date: Tue, 2 Aug 2022 06:53:50 -0400
Subject: [PATCH 0554/1164] Fix timezone handling for datetime to unixtime
 conversions (#2213)

* Fix timezone handling for datetime to unixtime conversions

datetime objects are supported to set expire, these can have timezones.
mktime was used to convert these to unixtime. mktime in Python however is not timezone aware, it expects the input to be UTC and redis-py did not convert the datetime timestamps to UTC before calling mktime.

This can lead to:
1) Setting incorrect expire times because the input datetime object has a timezone but is passed to mktime without converting to UTC first.
2) When the datetime timestamp is within DST, mktime fails with "OverflowError: mktime argument out of range" because UTC doesn't have DST. This depends on libc versions.

* linters

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 CHANGES                             |  1 +
 redis/commands/core.py              | 18 ++++++------------
 tests/test_asyncio/test_commands.py |  7 +++----
 tests/test_commands.py              |  6 +++---
 4 files changed, 13 insertions(+), 19 deletions(-)

diff --git a/CHANGES b/CHANGES
index d2033ca085..1a15a85698 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Fix timezone handling for datetime to unixtime conversions
     * Fix start_id type for XAUTOCLAIM
     * Remove verbose logging from cluster.py
     * Add retry mechanism to async version of Connection
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 4243679626..6cf04577fc 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -2,7 +2,6 @@
 
 import datetime
 import hashlib
-import time
 import warnings
 from typing import (
     TYPE_CHECKING,
@@ -1674,7 +1673,7 @@ def expireat(
         For more information see https://redis.io/commands/expireat
         """
         if isinstance(when, datetime.datetime):
-            when = int(time.mktime(when.timetuple()))
+            when = int(when.timestamp())
 
         exp_option = list()
         if nx:
@@ -1769,14 +1768,12 @@ def getex(
         if exat is not None:
             pieces.append("EXAT")
             if isinstance(exat, datetime.datetime):
-                s = int(exat.microsecond / 1000000)
-                exat = int(time.mktime(exat.timetuple())) + s
+                exat = int(exat.timestamp())
             pieces.append(exat)
         if pxat is not None:
             pieces.append("PXAT")
             if isinstance(pxat, datetime.datetime):
-                ms = int(pxat.microsecond / 1000)
-                pxat = int(time.mktime(pxat.timetuple())) * 1000 + ms
+                pxat = int(pxat.timestamp() * 1000)
             pieces.append(pxat)
         if persist:
             pieces.append("PERSIST")
@@ -1995,8 +1992,7 @@ def pexpireat(
         For more information see https://redis.io/commands/pexpireat
         """
         if isinstance(when, datetime.datetime):
-            ms = int(when.microsecond / 1000)
-            when = int(time.mktime(when.timetuple())) * 1000 + ms
+            when = int(when.timestamp() * 1000)
         exp_option = list()
         if nx:
             exp_option.append("NX")
@@ -2197,14 +2193,12 @@ def set(
         if exat is not None:
             pieces.append("EXAT")
             if isinstance(exat, datetime.datetime):
-                s = int(exat.microsecond / 1000000)
-                exat = int(time.mktime(exat.timetuple())) + s
+                exat = int(exat.timestamp())
             pieces.append(exat)
         if pxat is not None:
             pieces.append("PXAT")
             if isinstance(pxat, datetime.datetime):
-                ms = int(pxat.microsecond / 1000)
-                pxat = int(time.mktime(pxat.timetuple())) * 1000 + ms
+                pxat = int(pxat.timestamp() * 1000)
             pieces.append(pxat)
         if keepttl:
             pieces.append("KEEPTTL")
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index eaae185f31..4c25277616 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -4,7 +4,6 @@
 import binascii
 import datetime
 import re
-import time
 from string import ascii_letters
 
 import pytest
@@ -750,7 +749,7 @@ async def test_expireat_no_key(self, r: redis.Redis):
     async def test_expireat_unixtime(self, r: redis.Redis):
         expire_at = await redis_server_time(r) + datetime.timedelta(minutes=1)
         await r.set("a", "foo")
-        expire_at_seconds = int(time.mktime(expire_at.timetuple()))
+        expire_at_seconds = int(expire_at.timestamp())
         assert await r.expireat("a", expire_at_seconds)
         assert 0 < await r.ttl("a") <= 61
 
@@ -875,8 +874,8 @@ async def test_pexpireat_no_key(self, r: redis.Redis):
     async def test_pexpireat_unixtime(self, r: redis.Redis):
         expire_at = await redis_server_time(r) + datetime.timedelta(minutes=1)
         await r.set("a", "foo")
-        expire_at_seconds = int(time.mktime(expire_at.timetuple())) * 1000
-        assert await r.pexpireat("a", expire_at_seconds)
+        expire_at_milliseconds = int(expire_at.timestamp() * 1000)
+        assert await r.pexpireat("a", expire_at_milliseconds)
         assert 0 < await r.pttl("a") <= 61000
 
     @skip_if_server_version_lt("2.6.0")
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 715d18c951..f9134d858b 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1185,7 +1185,7 @@ def test_expireat_no_key(self, r):
     def test_expireat_unixtime(self, r):
         expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
         r["a"] = "foo"
-        expire_at_seconds = int(time.mktime(expire_at.timetuple()))
+        expire_at_seconds = int(expire_at.timestamp())
         assert r.expireat("a", expire_at_seconds) is True
         assert 0 < r.ttl("a") <= 61
 
@@ -1428,8 +1428,8 @@ def test_pexpireat_no_key(self, r):
     def test_pexpireat_unixtime(self, r):
         expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
         r["a"] = "foo"
-        expire_at_seconds = int(time.mktime(expire_at.timetuple())) * 1000
-        assert r.pexpireat("a", expire_at_seconds) is True
+        expire_at_milliseconds = int(expire_at.timestamp() * 1000)
+        assert r.pexpireat("a", expire_at_milliseconds) is True
         assert 0 < r.pttl("a") <= 61000
 
     @skip_if_server_version_lt("7.0.0")

From 9901c7963ff5c5f68ff7e651142c51c2d715c5eb Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 2 Aug 2022 15:56:49 +0300
Subject: [PATCH 0555/1164] Add support for `TDIGEST.QUANTILE` extensions
 (#2317)

* Add support for TDIGEST.QUANTILE extensions

* linters

* linters & utils

* Update test_bloom.py
---
 redis/commands/bf/__init__.py    |  3 ++-
 redis/commands/bf/commands.py    |  9 +++++----
 redis/commands/bf/utils.py       |  3 +++
 tests/test_asyncio/test_bloom.py | 28 +++++++++++++++++++---------
 tests/test_bloom.py              | 20 +++++++++++++++-----
 5 files changed, 44 insertions(+), 19 deletions(-)
 create mode 100644 redis/commands/bf/utils.py

diff --git a/redis/commands/bf/__init__.py b/redis/commands/bf/__init__.py
index d62d8a0d83..3169ba22b0 100644
--- a/redis/commands/bf/__init__.py
+++ b/redis/commands/bf/__init__.py
@@ -3,6 +3,7 @@
 from ..helpers import parse_to_list
 from .commands import *  # noqa
 from .info import BFInfo, CFInfo, CMSInfo, TDigestInfo, TopKInfo
+from .utils import parse_tdigest_quantile
 
 
 class AbstractBloom(object):
@@ -166,7 +167,7 @@ def __init__(self, client, **kwargs):
             # TDIGEST_ADD: spaceHolder,
             # TDIGEST_MERGE: spaceHolder,
             TDIGEST_CDF: float,
-            TDIGEST_QUANTILE: float,
+            TDIGEST_QUANTILE: parse_tdigest_quantile,
             TDIGEST_MIN: float,
             TDIGEST_MAX: float,
             TDIGEST_INFO: TDigestInfo,
diff --git a/redis/commands/bf/commands.py b/redis/commands/bf/commands.py
index baf01305d7..7d36b936b3 100644
--- a/redis/commands/bf/commands.py
+++ b/redis/commands/bf/commands.py
@@ -393,13 +393,14 @@ def max(self, key):
         """  # noqa
         return self.execute_command(TDIGEST_MAX, key)
 
-    def quantile(self, key, quantile):
+    def quantile(self, key, quantile, *quantiles):
         """
-        Return double value estimate of the cutoff such that a specified fraction of the data
-        added to this TDigest would be less than or equal to the cutoff.
+        Returns estimates of one or more cutoffs such that a specified fraction of the
+        observations added to this t-digest would be less than or equal to each of the
+        specified cutoffs. (Multiple quantiles can be returned with one call)
         For more information see `TDIGEST.QUANTILE <https://redis.io/commands/tdigest.quantile>`_.
         """  # noqa
-        return self.execute_command(TDIGEST_QUANTILE, key, quantile)
+        return self.execute_command(TDIGEST_QUANTILE, key, quantile, *quantiles)
 
     def cdf(self, key, value):
         """
diff --git a/redis/commands/bf/utils.py b/redis/commands/bf/utils.py
new file mode 100644
index 0000000000..21dcfa77a2
--- /dev/null
+++ b/redis/commands/bf/utils.py
@@ -0,0 +1,3 @@
+def parse_tdigest_quantile(response):
+    """Parse TDIGEST.QUANTILE response."""
+    return [float(x) for x in response]
diff --git a/tests/test_asyncio/test_bloom.py b/tests/test_asyncio/test_bloom.py
index 2c3617f9ab..fe3bd76d71 100644
--- a/tests/test_asyncio/test_bloom.py
+++ b/tests/test_asyncio/test_bloom.py
@@ -3,6 +3,7 @@
 import redis.asyncio as redis
 from redis.exceptions import ModuleError, RedisError
 from redis.utils import HIREDIS_AVAILABLE
+from tests.conftest import skip_ifmodversion_lt
 
 
 def intlist(obj):
@@ -355,6 +356,7 @@ async def test_tdigest_min_and_max(modclient: redis.Redis):
 
 @pytest.mark.redismod
 @pytest.mark.experimental
+@skip_ifmodversion_lt("2.4.0", "bf")
 async def test_tdigest_quantile(modclient: redis.Redis):
     assert await modclient.tdigest().create("tDigest", 500)
     # insert data-points into sketch
@@ -362,15 +364,23 @@ async def test_tdigest_quantile(modclient: redis.Redis):
         "tDigest", list([x * 0.01 for x in range(1, 10000)]), [1.0] * 10000
     )
     # assert min min/max have same result as quantile 0 and 1
-    assert await modclient.tdigest().max(
-        "tDigest"
-    ) == await modclient.tdigest().quantile("tDigest", 1.0)
-    assert await modclient.tdigest().min(
-        "tDigest"
-    ) == await modclient.tdigest().quantile("tDigest", 0.0)
-
-    assert 1.0 == round(await modclient.tdigest().quantile("tDigest", 0.01), 2)
-    assert 99.0 == round(await modclient.tdigest().quantile("tDigest", 0.99), 2)
+    assert (
+        await modclient.tdigest().max("tDigest")
+        == (await modclient.tdigest().quantile("tDigest", 1.0))[1]
+    )
+    assert (
+        await modclient.tdigest().min("tDigest")
+        == (await modclient.tdigest().quantile("tDigest", 0.0))[1]
+    )
+
+    assert 1.0 == round((await modclient.tdigest().quantile("tDigest", 0.01))[1], 2)
+    assert 99.0 == round((await modclient.tdigest().quantile("tDigest", 0.99))[1], 2)
+
+    # test multiple quantiles
+    assert await modclient.tdigest().create("t-digest", 100)
+    assert await modclient.tdigest().add("t-digest", [1, 2, 3, 4, 5], [1.0] * 5)
+    res = await modclient.tdigest().quantile("t-digest", 0.5, 0.8)
+    assert [0.5, 3.0, 0.8, 5.0] == res
 
 
 @pytest.mark.redismod
diff --git a/tests/test_bloom.py b/tests/test_bloom.py
index 1f8201c565..340e48e1ce 100644
--- a/tests/test_bloom.py
+++ b/tests/test_bloom.py
@@ -4,6 +4,8 @@
 from redis.exceptions import ModuleError, RedisError
 from redis.utils import HIREDIS_AVAILABLE
 
+from .conftest import skip_ifmodversion_lt
+
 
 def intlist(obj):
     return [int(v) for v in obj]
@@ -354,6 +356,7 @@ def test_tdigest_min_and_max(client):
 
 @pytest.mark.redismod
 @pytest.mark.experimental
+@skip_ifmodversion_lt("2.4.0", "bf")
 def test_tdigest_quantile(client):
     assert client.tdigest().create("tDigest", 500)
     # insert data-points into sketch
@@ -361,11 +364,18 @@ def test_tdigest_quantile(client):
         "tDigest", list([x * 0.01 for x in range(1, 10000)]), [1.0] * 10000
     )
     # assert min min/max have same result as quantile 0 and 1
-    assert client.tdigest().max("tDigest") == client.tdigest().quantile("tDigest", 1.0)
-    assert client.tdigest().min("tDigest") == client.tdigest().quantile("tDigest", 0.0)
-
-    assert 1.0 == round(client.tdigest().quantile("tDigest", 0.01), 2)
-    assert 99.0 == round(client.tdigest().quantile("tDigest", 0.99), 2)
+    res = client.tdigest().quantile("tDigest", 1.0)
+    assert client.tdigest().max("tDigest") == res[1]
+    res = client.tdigest().quantile("tDigest", 0.0)
+    assert client.tdigest().min("tDigest") == res[1]
+
+    assert 1.0 == round(client.tdigest().quantile("tDigest", 0.01)[1], 2)
+    assert 99.0 == round(client.tdigest().quantile("tDigest", 0.99)[1], 2)
+
+    # test multiple quantiles
+    assert client.tdigest().create("t-digest", 100)
+    assert client.tdigest().add("t-digest", [1, 2, 3, 4, 5], [1.0] * 5)
+    assert [0.5, 3.0, 0.8, 5.0] == client.tdigest().quantile("t-digest", 0.5, 0.8)
 
 
 @pytest.mark.redismod

From e601aa7138da88d8afee34cf94b52e21f1351268 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 2 Aug 2022 17:44:46 +0300
Subject: [PATCH 0556/1164] Replace `ensure_future` with `create_task` (#2311)

* Replace `ensure_future` with `create_task`

* linters
---
 redis/asyncio/cluster.py     | 12 ++++++------
 redis/commands/cluster.py    |  2 +-
 tests/test_asyncio/compat.py |  6 +-----
 3 files changed, 8 insertions(+), 12 deletions(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 1a33563781..78dcd05039 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -642,7 +642,7 @@ async def execute_command(self, *args: EncodableT, **kwargs: Any) -> Any:
                     keys = [node.name for node in target_nodes]
                     values = await asyncio.gather(
                         *(
-                            asyncio.ensure_future(
+                            asyncio.create_task(
                                 self._execute_command(node, *args, **kwargs)
                             )
                             for node in target_nodes
@@ -841,7 +841,7 @@ def __del__(self) -> None:
     async def disconnect(self) -> None:
         ret = await asyncio.gather(
             *(
-                asyncio.ensure_future(connection.disconnect())
+                asyncio.create_task(connection.disconnect())
                 for connection in self._connections
             ),
             return_exceptions=True,
@@ -979,13 +979,13 @@ def set_nodes(
         if remove_old:
             for name in list(old.keys()):
                 if name not in new:
-                    asyncio.ensure_future(old.pop(name).disconnect())
+                    asyncio.create_task(old.pop(name).disconnect())
 
         for name, node in new.items():
             if name in old:
                 if old[name] is node:
                     continue
-                asyncio.ensure_future(old[name].disconnect())
+                asyncio.create_task(old[name].disconnect())
             old[name] = node
 
     def _update_moved_slots(self) -> None:
@@ -1202,7 +1202,7 @@ async def close(self, attr: str = "nodes_cache") -> None:
         self.default_node = None
         await asyncio.gather(
             *(
-                asyncio.ensure_future(node.disconnect())
+                asyncio.create_task(node.disconnect())
                 for node in getattr(self, attr).values()
             )
         )
@@ -1381,7 +1381,7 @@ async def _execute(
 
         errors = await asyncio.gather(
             *(
-                asyncio.ensure_future(node[0].execute_pipeline(node[1]))
+                asyncio.create_task(node[0].execute_pipeline(node[1]))
                 for node in nodes.values()
             )
         )
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index a1060d2cbb..8e4c8ef1d0 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -673,7 +673,7 @@ async def cluster_delslots(self, *slots: EncodableT) -> List[bool]:
         """
         return await asyncio.gather(
             *(
-                asyncio.ensure_future(self.execute_command("CLUSTER DELSLOTS", slot))
+                asyncio.create_task(self.execute_command("CLUSTER DELSLOTS", slot))
                 for slot in slots
             )
         )
diff --git a/tests/test_asyncio/compat.py b/tests/test_asyncio/compat.py
index ed5c680411..5edcd4ae54 100644
--- a/tests/test_asyncio/compat.py
+++ b/tests/test_asyncio/compat.py
@@ -1,5 +1,4 @@
 import asyncio
-import sys
 from unittest import mock
 
 try:
@@ -9,7 +8,4 @@
 
 
 def create_task(coroutine):
-    if sys.version_info[:2] >= (3, 7):
-        return asyncio.create_task(coroutine)
-    else:
-        return asyncio.ensure_future(coroutine)
+    return asyncio.create_task(coroutine)

From 47b5dd081fcea2f14faa6d4ca520f614cc385589 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 2 Aug 2022 17:44:57 +0300
Subject: [PATCH 0557/1164] change drop to dropindex (#2315)

---
 redis/commands/search/commands.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 0121436e15..ba9d9bc1b7 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -20,6 +20,7 @@
 ADD_CMD = "FT.ADD"
 ADDHASH_CMD = "FT.ADDHASH"
 DROP_CMD = "FT.DROP"
+DROPINDEX_CMD = "FT.DROPINDEX"
 EXPLAIN_CMD = "FT.EXPLAIN"
 EXPLAINCLI_CMD = "FT.EXPLAINCLI"
 DEL_CMD = "FT.DEL"
@@ -170,8 +171,8 @@ def dropindex(self, delete_documents=False):
 
         For more information see `FT.DROPINDEX <https://redis.io/commands/ft.dropindex>`_.
         """  # noqa
-        keep_str = "" if delete_documents else "KEEPDOCS"
-        return self.execute_command(DROP_CMD, self.index_name, keep_str)
+        delete_str = "DD" if delete_documents else ""
+        return self.execute_command(DROPINDEX_CMD, self.index_name, delete_str)
 
     def _add_document(
         self,

From 19cedab73a9b7d8e6af2753a1206e79c50ee2d37 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 2 Aug 2022 17:45:07 +0300
Subject: [PATCH 0558/1164] Fix async SEARCH pipeline (#2316)

* fix search async pipeline

* newline
---
 redis/commands/search/__init__.py |  2 +-
 tests/test_asyncio/test_search.py | 21 ++++++++++++++++++++-
 2 files changed, 21 insertions(+), 2 deletions(-)

diff --git a/redis/commands/search/__init__.py b/redis/commands/search/__init__.py
index 923711b8c4..70e9c279e5 100644
--- a/redis/commands/search/__init__.py
+++ b/redis/commands/search/__init__.py
@@ -167,5 +167,5 @@ class Pipeline(SearchCommands, redis.client.Pipeline):
     """Pipeline for the module."""
 
 
-class AsyncPipeline(AsyncSearchCommands, AsyncioPipeline):
+class AsyncPipeline(AsyncSearchCommands, AsyncioPipeline, Pipeline):
     """AsyncPipeline for the module."""
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index aa52602588..ec83e565e5 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -16,7 +16,7 @@
 from redis.commands.search.query import GeoFilter, NumericFilter, Query
 from redis.commands.search.result import Result
 from redis.commands.search.suggestion import Suggestion
-from tests.conftest import skip_ifmodversion_lt
+from tests.conftest import skip_if_redis_enterprise, skip_ifmodversion_lt
 
 WILL_PLAY_TEXT = os.path.abspath(
     os.path.join(os.path.dirname(__file__), "testdata", "will_play_text.csv.bz2")
@@ -1043,3 +1043,22 @@ async def test_aggregations_sort_by_and_limit(modclient: redis.Redis):
     res = await modclient.ft().aggregate(req)
     assert len(res.rows) == 1
     assert res.rows[0] == ["t1", "b"]
+
+
+@pytest.mark.redismod
+@skip_if_redis_enterprise()
+async def test_search_commands_in_pipeline(modclient: redis.Redis):
+    p = await modclient.ft().pipeline()
+    p.create_index((TextField("txt"),))
+    p.add_document("doc1", payload="foo baz", txt="foo bar")
+    p.add_document("doc2", txt="foo bar")
+    q = Query("foo bar").with_payloads()
+    await p.search(q)
+    res = await p.execute()
+    assert res[:3] == ["OK", "OK", "OK"]
+    assert 2 == res[3][0]
+    assert "doc1" == res[3][1]
+    assert "doc2" == res[3][4]
+    assert "foo baz" == res[3][2]
+    assert res[3][5] is None
+    assert res[3][3] == res[3][6] == ["txt", "foo bar"]

From fcc0c4114a7142ba58daed0cdafbbbaefe1680a6 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 2 Aug 2022 17:45:14 +0300
Subject: [PATCH 0559/1164] Support TDIGEST.MERGESTORE and make compression
 optional on TDIGEST.CREATE (#2319)

* support 2.4

* async test

* skip tests

* linters
---
 redis/commands/bf/commands.py    | 16 +++++++++++++++-
 tests/test_asyncio/test_bloom.py | 13 +++++++++++++
 tests/test_bloom.py              | 13 +++++++++++++
 3 files changed, 41 insertions(+), 1 deletion(-)

diff --git a/redis/commands/bf/commands.py b/redis/commands/bf/commands.py
index 7d36b936b3..84a6b5fbcb 100644
--- a/redis/commands/bf/commands.py
+++ b/redis/commands/bf/commands.py
@@ -49,6 +49,7 @@
 TDIGEST_MIN = "TDIGEST.MIN"
 TDIGEST_MAX = "TDIGEST.MAX"
 TDIGEST_INFO = "TDIGEST.INFO"
+TDIGEST_MERGESTORE = "TDIGEST.MERGESTORE"
 
 
 class BFCommands:
@@ -344,7 +345,7 @@ def info(self, key):
 
 
 class TDigestCommands:
-    def create(self, key, compression):
+    def create(self, key, compression=100):
         """
         Allocate the memory and initialize the t-digest.
         For more information see `TDIGEST.CREATE <https://redis.io/commands/tdigest.create>`_.
@@ -417,6 +418,19 @@ def info(self, key):
         """  # noqa
         return self.execute_command(TDIGEST_INFO, key)
 
+    def mergestore(self, dest_key, numkeys, *sourcekeys, compression=False):
+        """
+        Merges all of the values from `sourcekeys` keys to `dest_key` sketch.
+        If destination already exists, it is overwritten.
+
+
+        For more information see `TDIGEST.MERGESTORE <https://redis.io/commands/tdigest.mergestore>`_.
+        """  # noqa
+        params = [dest_key, numkeys, *sourcekeys]
+        if compression:
+            params.extend(["COMPRESSION", compression])
+        return self.execute_command(TDIGEST_MERGESTORE, *params)
+
 
 class CMSCommands:
     """Count-Min Sketch Commands"""
diff --git a/tests/test_asyncio/test_bloom.py b/tests/test_asyncio/test_bloom.py
index fe3bd76d71..15b22b33f8 100644
--- a/tests/test_asyncio/test_bloom.py
+++ b/tests/test_asyncio/test_bloom.py
@@ -393,6 +393,19 @@ async def test_tdigest_cdf(modclient: redis.Redis):
     assert 0.9 == round(await modclient.tdigest().cdf("tDigest", 9.0), 1)
 
 
+@pytest.mark.redismod
+@pytest.mark.experimental
+@skip_ifmodversion_lt("2.4.0", "bf")
+async def test_tdigest_mergestore(modclient: redis.Redis):
+    assert await modclient.tdigest().create("sourcekey1", 100)
+    assert await modclient.tdigest().create("sourcekey2", 100)
+    assert await modclient.tdigest().add("sourcekey1", [10], [1.0])
+    assert await modclient.tdigest().add("sourcekey2", [50], [1.0])
+    assert await modclient.tdigest().mergestore("dest", 2, "sourcekey1", "sourcekey2")
+    assert await modclient.tdigest().max("dest") == 50
+    assert await modclient.tdigest().min("dest") == 10
+
+
 # @pytest.mark.redismod
 # async def test_pipeline(modclient: redis.Redis):
 #     pipeline = await modclient.bf().pipeline()
diff --git a/tests/test_bloom.py b/tests/test_bloom.py
index 340e48e1ce..1191542fca 100644
--- a/tests/test_bloom.py
+++ b/tests/test_bloom.py
@@ -388,6 +388,19 @@ def test_tdigest_cdf(client):
     assert 0.9 == round(client.tdigest().cdf("tDigest", 9.0), 1)
 
 
+@pytest.mark.redismod
+@pytest.mark.experimental
+@skip_ifmodversion_lt("2.4.0", "bf")
+def test_tdigest_mergestore(client):
+    assert client.tdigest().create("sourcekey1", 100)
+    assert client.tdigest().create("sourcekey2", 100)
+    assert client.tdigest().add("sourcekey1", [10], [1.0])
+    assert client.tdigest().add("sourcekey2", [50], [1.0])
+    assert client.tdigest().mergestore("destkey", 2, "sourcekey1", "sourcekey2")
+    assert client.tdigest().max("destkey") == 50
+    assert client.tdigest().min("destkey") == 10
+
+
 # @pytest.mark.redismod
 # def test_pipeline(client):
 #     pipeline = client.bf().pipeline()

From 85825b8728ec65394433bcbbd1fef36937517e8d Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 4 Aug 2022 13:53:51 +0300
Subject: [PATCH 0560/1164] Search test - Ignore order of the items in the
 response (#2322)

* fix test

* async test
---
 tests/test_asyncio/test_search.py | 2 +-
 tests/test_search.py              | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index ec83e565e5..4824e49624 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -992,7 +992,7 @@ async def test_aggregations_groupby(modclient: redis.Redis):
 
     res = (await modclient.ft().aggregate(req)).rows[0]
     assert res[1] == "redis"
-    assert res[3] == ["RediSearch", "RedisAI", "RedisJson"]
+    assert set(res[3]) == {"RediSearch", "RedisAI", "RedisJson"}
 
     req = aggregations.AggregateRequest("redis").group_by(
         "@parent", reducers.first_value("@title").alias("first")
diff --git a/tests/test_search.py b/tests/test_search.py
index 642418ecdf..ee4fa55f68 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -965,7 +965,7 @@ def test_aggregations_groupby(client):
 
     res = client.ft().aggregate(req).rows[0]
     assert res[1] == "redis"
-    assert res[3] == ["RediSearch", "RedisAI", "RedisJson"]
+    assert set(res[3]) == {"RediSearch", "RedisAI", "RedisJson"}
 
     req = aggregations.AggregateRequest("redis").group_by(
         "@parent", reducers.first_value("@title").alias("first")

From ab5272cd520954debebe623cd31c28e535e8b8e5 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 4 Aug 2022 14:00:45 +0300
Subject: [PATCH 0561/1164] 4.4.0rc1 (#2321)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index c513b40ce4..fb6d32a31d 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.3.4",
+    version="4.4.0rc1",
     packages=find_packages(
         include=[
             "redis",

From aca005084a95110796cfd59b20c87ce7baaf94c0 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 4 Aug 2022 16:00:24 +0300
Subject: [PATCH 0562/1164] Adding experimental features, as a release option
 (#2323)

---
 .github/release-drafter-config.yml | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/.github/release-drafter-config.yml b/.github/release-drafter-config.yml
index aab645f9e4..de4fea741a 100644
--- a/.github/release-drafter-config.yml
+++ b/.github/release-drafter-config.yml
@@ -1,5 +1,5 @@
-name-template: 'Version $NEXT_PATCH_VERSION'
-tag-template: 'v$NEXT_PATCH_VERSION'
+name-template: '$NEXT_MAJOR_VERSION'
+tag-template: 'v$NEXT_MAJOR_VERSION'
 autolabeler:
   - label: 'maintenance'
     files:
@@ -15,9 +15,13 @@ autolabeler:
     branch:
       - '/feature-.+'
 categories:
-  - title: '🔥 Breaking Changes'
+  - title: 'Breaking Changes'
     labels:
       - 'breakingchange'
+
+  - title: '🧪 Experimental Features'
+    labels:
+      - 'experimental'
   - title: '🚀 New Features'
     labels:
       - 'feature'
@@ -27,6 +31,7 @@ categories:
       - 'fix'
       - 'bugfix'
       - 'bug'
+      - 'BUG'
   - title: '🧰 Maintenance'
     label: 'maintenance'
 change-template: '- $TITLE (#$NUMBER)'

From 34f07a716f1029a38cc000177c931a7ea8bd712e Mon Sep 17 00:00:00 2001
From: Alibi <aliby.bbb@gmail.com>
Date: Thu, 4 Aug 2022 19:00:51 +0600
Subject: [PATCH 0563/1164] Add TDIGEST.TRIMMED_MEAN (#2300)

* Add tdigest trimmed mean command with test

* Add skip version for test

* add to module callbacks

Co-authored-by: Alibi Shalgymbay <a.shalgymbay@mycar.kz>
Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
Co-authored-by: dvora-h <dvora.heller@redis.com>
---
 redis/commands/bf/__init__.py |  1 +
 redis/commands/bf/commands.py | 11 +++++++++++
 tests/test_bloom.py           | 11 +++++++++++
 3 files changed, 23 insertions(+)

diff --git a/redis/commands/bf/__init__.py b/redis/commands/bf/__init__.py
index 3169ba22b0..e41354b29f 100644
--- a/redis/commands/bf/__init__.py
+++ b/redis/commands/bf/__init__.py
@@ -170,6 +170,7 @@ def __init__(self, client, **kwargs):
             TDIGEST_QUANTILE: parse_tdigest_quantile,
             TDIGEST_MIN: float,
             TDIGEST_MAX: float,
+            TDIGEST_TRIMMED_MEAN: float,
             TDIGEST_INFO: TDigestInfo,
         }
 
diff --git a/redis/commands/bf/commands.py b/redis/commands/bf/commands.py
index 84a6b5fbcb..0fe065d708 100644
--- a/redis/commands/bf/commands.py
+++ b/redis/commands/bf/commands.py
@@ -49,6 +49,7 @@
 TDIGEST_MIN = "TDIGEST.MIN"
 TDIGEST_MAX = "TDIGEST.MAX"
 TDIGEST_INFO = "TDIGEST.INFO"
+TDIGEST_TRIMMED_MEAN = "TDIGEST.TRIMMED_MEAN"
 TDIGEST_MERGESTORE = "TDIGEST.MERGESTORE"
 
 
@@ -418,6 +419,16 @@ def info(self, key):
         """  # noqa
         return self.execute_command(TDIGEST_INFO, key)
 
+    def trimmed_mean(self, key, low_cut_quantile, high_cut_quantile):
+        """
+        Return mean value from the sketch, excluding observation values outside
+        the low and high cutoff quantiles.
+        For more information see `TDIGEST.TRIMMED_MEAN <https://redis.io/commands/tdigest.trimmed_mean>`_.
+        """  # noqa
+        return self.execute_command(
+            TDIGEST_TRIMMED_MEAN, key, low_cut_quantile, high_cut_quantile
+        )
+
     def mergestore(self, dest_key, numkeys, *sourcekeys, compression=False):
         """
         Merges all of the values from `sourcekeys` keys to `dest_key` sketch.
diff --git a/tests/test_bloom.py b/tests/test_bloom.py
index 1191542fca..12a4839922 100644
--- a/tests/test_bloom.py
+++ b/tests/test_bloom.py
@@ -388,6 +388,17 @@ def test_tdigest_cdf(client):
     assert 0.9 == round(client.tdigest().cdf("tDigest", 9.0), 1)
 
 
+@pytest.mark.redismod
+@pytest.mark.experimental
+@skip_ifmodversion_lt("2.4.0", "bf")
+def test_tdigest_trimmed_mean(client):
+    assert client.tdigest().create("tDigest", 100)
+    # insert data-points into sketch
+    assert client.tdigest().add("tDigest", list(range(1, 10)), [1.0] * 10)
+    assert 5 == client.tdigest().trimmed_mean("tDigest", 0.1, 0.9)
+    assert 4.5 == client.tdigest().trimmed_mean("tDigest", 0.4, 0.5)
+
+
 @pytest.mark.redismod
 @pytest.mark.experimental
 @skip_ifmodversion_lt("2.4.0", "bf")

From 2cea637b2e936265d2001043d2b2d4e62559dc17 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 4 Aug 2022 16:46:28 +0300
Subject: [PATCH 0564/1164] Add support for WITHSUFFIXTRIE to FT.CREATE (#2324)

* withsuffixtrie

* Update test_search.py

* fix
---
 redis/commands/search/field.py    | 12 +++++++++++-
 tests/test_asyncio/test_search.py | 24 ++++++++++++++++++++++++
 tests/test_search.py              | 24 ++++++++++++++++++++++++
 3 files changed, 59 insertions(+), 1 deletion(-)

diff --git a/redis/commands/search/field.py b/redis/commands/search/field.py
index 89ed97357a..6f31ce1fc2 100644
--- a/redis/commands/search/field.py
+++ b/redis/commands/search/field.py
@@ -64,6 +64,7 @@ def __init__(
         weight: float = 1.0,
         no_stem: bool = False,
         phonetic_matcher: str = None,
+        withsuffixtrie: bool = False,
         **kwargs,
     ):
         Field.__init__(self, name, args=[Field.TEXT, Field.WEIGHT, weight], **kwargs)
@@ -78,6 +79,8 @@ def __init__(
         ]:
             Field.append_arg(self, self.PHONETIC)
             Field.append_arg(self, phonetic_matcher)
+        if withsuffixtrie:
+            Field.append_arg(self, "WITHSUFFIXTRIE")
 
 
 class NumericField(Field):
@@ -108,11 +111,18 @@ class TagField(Field):
     CASESENSITIVE = "CASESENSITIVE"
 
     def __init__(
-        self, name: str, separator: str = ",", case_sensitive: bool = False, **kwargs
+        self,
+        name: str,
+        separator: str = ",",
+        case_sensitive: bool = False,
+        withsuffixtrie: bool = False,
+        **kwargs,
     ):
         args = [Field.TAG, self.SEPARATOR, separator]
         if case_sensitive:
             args.append(self.CASESENSITIVE)
+        if withsuffixtrie:
+            args.append("WITHSUFFIXTRIE")
 
         Field.__init__(self, name, args=args, **kwargs)
 
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 4824e49624..862c21b1c3 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -1045,6 +1045,30 @@ async def test_aggregations_sort_by_and_limit(modclient: redis.Redis):
     assert res.rows[0] == ["t1", "b"]
 
 
+@pytest.mark.redismod
+@pytest.mark.experimental
+async def test_withsuffixtrie(modclient: redis.Redis):
+    # create index
+    assert await modclient.ft().create_index((TextField("txt"),))
+    await waitForIndex(modclient, getattr(modclient.ft(), "index_name", "idx"))
+    info = await modclient.ft().info()
+    assert "WITHSUFFIXTRIE" not in info["attributes"][0]
+    assert await modclient.ft().dropindex("idx")
+
+    # create withsuffixtrie index (text field)
+    assert await modclient.ft().create_index((TextField("t", withsuffixtrie=True)))
+    await waitForIndex(modclient, getattr(modclient.ft(), "index_name", "idx"))
+    info = await modclient.ft().info()
+    assert "WITHSUFFIXTRIE" in info["attributes"][0]
+    assert await modclient.ft().dropindex("idx")
+
+    # create withsuffixtrie index (tag field)
+    assert await modclient.ft().create_index((TagField("t", withsuffixtrie=True)))
+    await waitForIndex(modclient, getattr(modclient.ft(), "index_name", "idx"))
+    info = await modclient.ft().info()
+    assert "WITHSUFFIXTRIE" in info["attributes"][0]
+
+
 @pytest.mark.redismod
 @skip_if_redis_enterprise()
 async def test_search_commands_in_pipeline(modclient: redis.Redis):
diff --git a/tests/test_search.py b/tests/test_search.py
index ee4fa55f68..5fe5ab17fc 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1712,3 +1712,27 @@ def test_expire_while_search(modclient: redis.Redis):
         modclient.ft().search(Query("*")).docs[1]
     time.sleep(1)
     assert 2 == modclient.ft().search(Query("*")).total
+
+
+@pytest.mark.redismod
+@pytest.mark.experimental
+def test_withsuffixtrie(modclient: redis.Redis):
+    # create index
+    assert modclient.ft().create_index((TextField("txt"),))
+    waitForIndex(modclient, getattr(modclient.ft(), "index_name", "idx"))
+    info = modclient.ft().info()
+    assert "WITHSUFFIXTRIE" not in info["attributes"][0]
+    assert modclient.ft().dropindex("idx")
+
+    # create withsuffixtrie index (text fiels)
+    assert modclient.ft().create_index((TextField("t", withsuffixtrie=True)))
+    waitForIndex(modclient, getattr(modclient.ft(), "index_name", "idx"))
+    info = modclient.ft().info()
+    assert "WITHSUFFIXTRIE" in info["attributes"][0]
+    assert modclient.ft().dropindex("idx")
+
+    # create withsuffixtrie index (tag field)
+    assert modclient.ft().create_index((TagField("t", withsuffixtrie=True)))
+    waitForIndex(modclient, getattr(modclient.ft(), "index_name", "idx"))
+    info = modclient.ft().info()
+    assert "WITHSUFFIXTRIE" in info["attributes"][0]

From 29f80a5e9e6c3e55aeaba91399d5c21dde8acb14 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 14 Aug 2022 12:49:02 +0300
Subject: [PATCH 0565/1164] Fix GRAPH.LIST & TDIGEST.QUANTILE tests (#2335)

* fix graph list_keys test

* async test

* fix tdigest.quantile

* fix
---
 tests/test_asyncio/test_bloom.py | 10 +++++-----
 tests/test_asyncio/test_graph.py |  4 ++--
 tests/test_bloom.py              | 10 +++++-----
 tests/test_graph.py              |  4 ++--
 4 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/tests/test_asyncio/test_bloom.py b/tests/test_asyncio/test_bloom.py
index 15b22b33f8..8e642d2fbd 100644
--- a/tests/test_asyncio/test_bloom.py
+++ b/tests/test_asyncio/test_bloom.py
@@ -366,21 +366,21 @@ async def test_tdigest_quantile(modclient: redis.Redis):
     # assert min min/max have same result as quantile 0 and 1
     assert (
         await modclient.tdigest().max("tDigest")
-        == (await modclient.tdigest().quantile("tDigest", 1.0))[1]
+        == (await modclient.tdigest().quantile("tDigest", 1.0))[0]
     )
     assert (
         await modclient.tdigest().min("tDigest")
-        == (await modclient.tdigest().quantile("tDigest", 0.0))[1]
+        == (await modclient.tdigest().quantile("tDigest", 0.0))[0]
     )
 
-    assert 1.0 == round((await modclient.tdigest().quantile("tDigest", 0.01))[1], 2)
-    assert 99.0 == round((await modclient.tdigest().quantile("tDigest", 0.99))[1], 2)
+    assert 1.0 == round((await modclient.tdigest().quantile("tDigest", 0.01))[0], 2)
+    assert 99.0 == round((await modclient.tdigest().quantile("tDigest", 0.99))[0], 2)
 
     # test multiple quantiles
     assert await modclient.tdigest().create("t-digest", 100)
     assert await modclient.tdigest().add("t-digest", [1, 2, 3, 4, 5], [1.0] * 5)
     res = await modclient.tdigest().quantile("t-digest", 0.5, 0.8)
-    assert [0.5, 3.0, 0.8, 5.0] == res
+    assert [3.0, 5.0] == res
 
 
 @pytest.mark.redismod
diff --git a/tests/test_asyncio/test_graph.py b/tests/test_asyncio/test_graph.py
index 8a8f9cf953..0c011bd91a 100644
--- a/tests/test_asyncio/test_graph.py
+++ b/tests/test_asyncio/test_graph.py
@@ -348,11 +348,11 @@ async def test_list_keys(modclient: redis.Redis):
     result = await modclient.graph().list_keys()
     assert result == []
 
-    await modclient.execute_command("GRAPH.EXPLAIN", "G", "RETURN 1")
+    await modclient.graph("G").query("CREATE (n)")
     result = await modclient.graph().list_keys()
     assert result == ["G"]
 
-    await modclient.execute_command("GRAPH.EXPLAIN", "X", "RETURN 1")
+    await modclient.graph("X").query("CREATE (m)")
     result = await modclient.graph().list_keys()
     assert result == ["G", "X"]
 
diff --git a/tests/test_bloom.py b/tests/test_bloom.py
index 12a4839922..9a3e4a48c1 100644
--- a/tests/test_bloom.py
+++ b/tests/test_bloom.py
@@ -365,17 +365,17 @@ def test_tdigest_quantile(client):
     )
     # assert min min/max have same result as quantile 0 and 1
     res = client.tdigest().quantile("tDigest", 1.0)
-    assert client.tdigest().max("tDigest") == res[1]
+    assert client.tdigest().max("tDigest") == res[0]
     res = client.tdigest().quantile("tDigest", 0.0)
-    assert client.tdigest().min("tDigest") == res[1]
+    assert client.tdigest().min("tDigest") == res[0]
 
-    assert 1.0 == round(client.tdigest().quantile("tDigest", 0.01)[1], 2)
-    assert 99.0 == round(client.tdigest().quantile("tDigest", 0.99)[1], 2)
+    assert 1.0 == round(client.tdigest().quantile("tDigest", 0.01)[0], 2)
+    assert 99.0 == round(client.tdigest().quantile("tDigest", 0.99)[0], 2)
 
     # test multiple quantiles
     assert client.tdigest().create("t-digest", 100)
     assert client.tdigest().add("t-digest", [1, 2, 3, 4, 5], [1.0] * 5)
-    assert [0.5, 3.0, 0.8, 5.0] == client.tdigest().quantile("t-digest", 0.5, 0.8)
+    assert [3.0, 5.0] == client.tdigest().quantile("t-digest", 0.5, 0.8)
 
 
 @pytest.mark.redismod
diff --git a/tests/test_graph.py b/tests/test_graph.py
index 526308c672..a46c336dad 100644
--- a/tests/test_graph.py
+++ b/tests/test_graph.py
@@ -366,11 +366,11 @@ def test_list_keys(client):
     result = client.graph().list_keys()
     assert result == []
 
-    client.execute_command("GRAPH.EXPLAIN", "G", "RETURN 1")
+    client.graph("G").query("CREATE (n)")
     result = client.graph().list_keys()
     assert result == ["G"]
 
-    client.execute_command("GRAPH.EXPLAIN", "X", "RETURN 1")
+    client.graph("X").query("CREATE (m)")
     result = client.graph().list_keys()
     assert result == ["G", "X"]
 

From 771109e74feb3b8f630c047bf4f93da2800ec22e Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 14 Aug 2022 13:43:50 +0300
Subject: [PATCH 0566/1164] Adding dependency vulnerability scanning to the CI
 process (#2332)

* Adding dependency auditing to CI

* fixing pathing

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 .github/workflows/integration.yaml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 5876c08738..56dc286bc3 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -18,6 +18,15 @@ on:
 
 jobs:
 
+   dependency-audit:
+     name: Dependency audit
+     runs-on: ubuntu-latest
+     steps:
+       - uses: actions/checkout@v3
+       - uses: trailofbits/gh-action-pip-audit@v1.0.0
+         with:
+           inputs: requirements.txt dev_requirements.txt
+
    lint:
      name: Code linters
      runs-on: ubuntu-latest

From e95b05a8df4d45d0c8186ac37f57d9edd9235820 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 21 Aug 2022 11:54:08 +0300
Subject: [PATCH 0567/1164] fix tdigest.create (#2348)

---
 redis/commands/bf/commands.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/commands/bf/commands.py b/redis/commands/bf/commands.py
index 0fe065d708..2b16139315 100644
--- a/redis/commands/bf/commands.py
+++ b/redis/commands/bf/commands.py
@@ -351,7 +351,7 @@ def create(self, key, compression=100):
         Allocate the memory and initialize the t-digest.
         For more information see `TDIGEST.CREATE <https://redis.io/commands/tdigest.create>`_.
         """  # noqa
-        return self.execute_command(TDIGEST_CREATE, key, compression)
+        return self.execute_command(TDIGEST_CREATE, key, "COMPRESSION", compression)
 
     def reset(self, key):
         """

From 031b2087b57713d29b98140fb1f0b9f7b4fc7a21 Mon Sep 17 00:00:00 2001
From: Alibi <aliby.bbb@gmail.com>
Date: Sun, 21 Aug 2022 15:18:02 +0600
Subject: [PATCH 0568/1164] Add BITFIELD_RO (#2340)

---
 redis/commands/core.py              | 23 +++++++++++++++++++++++
 tests/test_asyncio/test_commands.py | 13 +++++++++++++
 tests/test_commands.py              | 13 +++++++++++++
 3 files changed, 49 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 6cf04577fc..51f30d2ef0 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1504,6 +1504,29 @@ def bitfield(
         """
         return BitFieldOperation(self, key, default_overflow=default_overflow)
 
+    def bitfield_ro(
+        self: Union["Redis", "AsyncRedis"],
+        key: KeyT,
+        encoding: str,
+        offset: BitfieldOffsetT,
+        items: Optional[list] = None,
+    ) -> ResponseT:
+        """
+        Return an array of the specified bitfield values
+        where the first value is found using ``encoding`` and ``offset``
+        parameters and remaining values are result of corresponding
+        encoding/offset pairs in optional list ``items``
+        Read-only variant of the BITFIELD command.
+
+        For more information see https://redis.io/commands/bitfield_ro
+        """
+        params = [key, "GET", encoding, offset]
+
+        items = items or []
+        for encoding, offset in items:
+            params.extend(["GET", encoding, offset])
+        return self.execute_command("BITFIELD_RO", *params)
+
     def bitop(self, operation: str, dest: KeyT, *keys: KeyT) -> ResponseT:
         """
         Perform a bitwise operation using ``operation`` between ``keys`` and
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 4c25277616..422328a043 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -2953,6 +2953,19 @@ async def test_bitfield_operations(self, r: redis.Redis):
         )
         assert resp == [0, None, 255]
 
+    @skip_if_server_version_lt("6.0.0")
+    async def test_bitfield_ro(self, r: redis.Redis):
+        bf = r.bitfield("a")
+        resp = await bf.set("u8", 8, 255).execute()
+        assert resp == [0]
+
+        resp = await r.bitfield_ro("a", "u8", 0)
+        assert resp == [0]
+
+        items = [("u4", 8), ("u4", 12), ("u4", 13)]
+        resp = await r.bitfield_ro("a", "u8", 0, items)
+        assert resp == [0, 15, 15, 14]
+
     @skip_if_server_version_lt("4.0.0")
     async def test_memory_stats(self, r: redis.Redis):
         # put a key into the current db to make sure that "db.<current-db>"
diff --git a/tests/test_commands.py b/tests/test_commands.py
index f9134d858b..de8020cf07 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -4438,6 +4438,19 @@ def test_bitfield_operations(self, r):
         )
         assert resp == [0, None, 255]
 
+    @skip_if_server_version_lt("6.0.0")
+    def test_bitfield_ro(self, r: redis.Redis):
+        bf = r.bitfield("a")
+        resp = bf.set("u8", 8, 255).execute()
+        assert resp == [0]
+
+        resp = r.bitfield_ro("a", "u8", 0)
+        assert resp == [0]
+
+        items = [("u4", 8), ("u4", 12), ("u4", 13)]
+        resp = r.bitfield_ro("a", "u8", 0, items)
+        assert resp == [0, 15, 15, 14]
+
     @skip_if_server_version_lt("4.0.0")
     def test_memory_help(self, r):
         with pytest.raises(NotImplementedError):

From fde03fbd45981c204908fe2a82999acf8e95bbc4 Mon Sep 17 00:00:00 2001
From: Nathaniel Blakely <vanish172@gmail.com>
Date: Sun, 21 Aug 2022 03:04:23 -0700
Subject: [PATCH 0569/1164] Fix typo work -> word (#2341)

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 80e2cc2e7c..f5ad9a4191 100644
--- a/README.md
+++ b/README.md
@@ -63,7 +63,7 @@ Alternatively, you might want to look at [Async connections](https://redis.readt
 
 ### Redis Commands
 
-There is built-in support for all of the [out-of-the-box Redis commands](https://redis.io/commands). They are exposed using the raw Redis command names (`HSET`, `HGETALL`, etc.) except where a work (i.e del) is reserved by the language. The complete set of commands can be found [here](https://github.com/redis/redis-py/tree/master/redis/commands), or [the documentation](https://redis.readthedocs.io/en/stable/commands.html).
+There is built-in support for all of the [out-of-the-box Redis commands](https://redis.io/commands). They are exposed using the raw Redis command names (`HSET`, `HGETALL`, etc.) except where a word (i.e del) is reserved by the language. The complete set of commands can be found [here](https://github.com/redis/redis-py/tree/master/redis/commands), or [the documentation](https://redis.readthedocs.io/en/stable/commands.html).
 
 ## Advanced Topics
 

From b5ebada842c715e9ee74ea638a7e6d11afcddae1 Mon Sep 17 00:00:00 2001
From: Klaas van Schelven <klaas@vanschelven.com>
Date: Sun, 21 Aug 2022 12:46:31 +0200
Subject: [PATCH 0570/1164] Be more strict about url scheme parsing (#2343)

The error message implied that urls had to start with `scheme://`.
However, if the double slash was left out, the url parsed just fine
and the part that was ostensibly intended to be the hostname ended
up as part of the path, whereas the default (localhost) would be
used for the hostname. This commit makes the check as strict as the
error message implies by including a check for the double slash.

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/connection.py           | 17 +++++++++++------
 tests/test_connection_pool.py |  8 ++++++++
 2 files changed, 19 insertions(+), 6 deletions(-)

diff --git a/redis/connection.py b/redis/connection.py
index 3438bafe57..96645ba355 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1166,6 +1166,16 @@ def to_bool(value):
 
 
 def parse_url(url):
+    if not (
+        url.startswith("redis://")
+        or url.startswith("rediss://")
+        or url.startswith("unix://")
+    ):
+        raise ValueError(
+            "Redis URL must specify one of the following "
+            "schemes (redis://, rediss://, unix://)"
+        )
+
     url = urlparse(url)
     kwargs = {}
 
@@ -1192,7 +1202,7 @@ def parse_url(url):
             kwargs["path"] = unquote(url.path)
         kwargs["connection_class"] = UnixDomainSocketConnection
 
-    elif url.scheme in ("redis", "rediss"):
+    else:  # implied:  url.scheme in ("redis", "rediss"):
         if url.hostname:
             kwargs["host"] = unquote(url.hostname)
         if url.port:
@@ -1208,11 +1218,6 @@ def parse_url(url):
 
         if url.scheme == "rediss":
             kwargs["connection_class"] = SSLConnection
-    else:
-        raise ValueError(
-            "Redis URL must specify one of the following "
-            "schemes (redis://, rediss://, unix://)"
-        )
 
     return kwargs
 
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index a836f5b2c7..636b04efad 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -339,6 +339,14 @@ def test_invalid_scheme_raises_error(self):
             "(redis://, rediss://, unix://)"
         )
 
+    def test_invalid_scheme_raises_error_when_double_slash_missing(self):
+        with pytest.raises(ValueError) as cm:
+            redis.ConnectionPool.from_url("redis:foo.bar.com:12345")
+        assert str(cm.value) == (
+            "Redis URL must specify one of the following schemes "
+            "(redis://, rediss://, unix://)"
+        )
+
 
 class TestConnectionPoolUnixSocketURLParsing:
     def test_defaults(self):

From ab5d407a03192bd8ab63a1bfc891db9c04330265 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 25 Aug 2022 16:34:10 +0300
Subject: [PATCH 0571/1164] fix test (#2358)

---
 tests/test_asyncio/test_timeseries.py | 3 +++
 tests/test_timeseries.py              | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/tests/test_asyncio/test_timeseries.py b/tests/test_asyncio/test_timeseries.py
index 182f6b5f3f..ef582269c1 100644
--- a/tests/test_asyncio/test_timeseries.py
+++ b/tests/test_asyncio/test_timeseries.py
@@ -240,6 +240,9 @@ async def test_range_advanced(modclient: redis.Redis):
     assert [(0, 5.0), (5, 6.0)] == await modclient.ts().range(
         1, 0, 10, aggregation_type="count", bucket_size_msec=10, align=5
     )
+    assert [(0, 2.5500000000000003), (10, 3.0)] == await modclient.ts().range(
+        1, 0, 10, aggregation_type="twa", bucket_size_msec=10
+    )
 
 
 @pytest.mark.redismod
diff --git a/tests/test_timeseries.py b/tests/test_timeseries.py
index b4b85e1715..cb27a7523f 100644
--- a/tests/test_timeseries.py
+++ b/tests/test_timeseries.py
@@ -233,7 +233,7 @@ def test_range_advanced(client):
     assert [(0, 5.0), (5, 6.0)] == client.ts().range(
         1, 0, 10, aggregation_type="count", bucket_size_msec=10, align=5
     )
-    assert [(0, 2.5500000000000003), (10, 3.95)] == client.ts().range(
+    assert [(0, 2.5500000000000003), (10, 3.0)] == client.ts().range(
         1, 0, 10, aggregation_type="twa", bucket_size_msec=10
     )
 

From 2a0405d07e20ac7f695ff67415ad6c8368fd6066 Mon Sep 17 00:00:00 2001
From: Guy Korland <gkorland@gmail.com>
Date: Tue, 30 Aug 2022 01:50:30 +0300
Subject: [PATCH 0572/1164] Update LICENSE (#2362)

---
 LICENSE | 37 ++++++++++++++++++-------------------
 1 file changed, 18 insertions(+), 19 deletions(-)

diff --git a/LICENSE b/LICENSE
index 29a3fe3845..00aee10d6a 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,22 +1,21 @@
-Copyright (c) 2012 Andy McCurdy
+MIT License
 
- Permission is hereby granted, free of charge, to any person
- obtaining a copy of this software and associated documentation
- files (the "Software"), to deal in the Software without
- restriction, including without limitation the rights to use,
- copy, modify, merge, publish, distribute, sublicense, and/or sell
- copies of the Software, and to permit persons to whom the
- Software is furnished to do so, subject to the following
- conditions:
+Copyright (c) 2022, Redis, inc.
 
- The above copyright notice and this permission notice shall be
- included in all copies or substantial portions of the Software.
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
- OTHER DEALINGS IN THE SOFTWARE.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

From fb54bddae9d460e227bfff77724e066b4a0ca522 Mon Sep 17 00:00:00 2001
From: Lee <leven.cn@gmail.com>
Date: Tue, 30 Aug 2022 07:06:37 +0800
Subject: [PATCH 0573/1164] Fix type hint annotations of expire time (#2361)

* fix typehint annotations of expire time.

`ExpiryT` includes `float` type, but params of expiry-time (`ex`, `px`) for methods such as `set`, `expire`, `setnx`, etc. , should be `int`, not `float`.

* add `IntExpiryT` annotation.

* minor fix.

* minor fix.
---
 redis/typing.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/typing.py b/redis/typing.py
index b572b0cf1d..8504c7de0c 100644
--- a/redis/typing.py
+++ b/redis/typing.py
@@ -16,7 +16,7 @@
 DecodedT = Union[str, int, float]
 EncodableT = Union[EncodedT, DecodedT]
 AbsExpiryT = Union[int, datetime]
-ExpiryT = Union[float, timedelta]
+ExpiryT = Union[int, timedelta]
 ZScoreBoundT = Union[float, str]  # str allows for the [ or ( prefix
 BitfieldOffsetT = Union[int, str]  # str allows for #x syntax
 _StringLikeT = Union[bytes, str, memoryview]

From bd0e8f26d8af5722a8b040bed6a75831bade81df Mon Sep 17 00:00:00 2001
From: Luca Cillario <luca.cillario.95@gmail.com>
Date: Tue, 30 Aug 2022 01:07:28 +0200
Subject: [PATCH 0574/1164] Handle auth errors for newer versions of Redis.
 (#2325) (#2329)

---
 redis/asyncio/connection.py   | 11 +++++++++++
 redis/connection.py           | 12 +++++++++++-
 tests/test_commands.py        | 26 ++++++++++++++++++++++----
 tests/test_connection_pool.py | 28 +++++++++++++++++++++++-----
 4 files changed, 67 insertions(+), 10 deletions(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 6823dcb853..db8c2408e2 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -87,6 +87,15 @@ class _Sentinel(enum.Enum):
     "exports one or more module-side data "
     "types, can't unload"
 )
+# user send an AUTH cmd to a server without authorization configured
+NO_AUTH_SET_ERROR = {
+    # Redis >= 6.0
+    "AUTH <password> called without any password "
+    "configured for the default user. Are you sure "
+    "your configuration is correct?": AuthenticationError,
+    # Redis < 6.0
+    "Client sent AUTH, but no password is set": AuthenticationError,
+}
 
 
 class _HiredisReaderArgs(TypedDict, total=False):
@@ -160,7 +169,9 @@ class BaseParser:
             MODULE_EXPORTS_DATA_TYPES_ERROR: ModuleError,
             NO_SUCH_MODULE_ERROR: ModuleError,
             MODULE_UNLOAD_NOT_POSSIBLE_ERROR: ModuleError,
+            **NO_AUTH_SET_ERROR,
         },
+        "WRONGPASS": AuthenticationError,
         "EXECABORT": ExecAbortError,
         "LOADING": BusyLoadingError,
         "NOSCRIPT": NoScriptError,
diff --git a/redis/connection.py b/redis/connection.py
index 96645ba355..3281b14d80 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -80,6 +80,15 @@
     "exports one or more module-side data "
     "types, can't unload"
 )
+# user send an AUTH cmd to a server without authorization configured
+NO_AUTH_SET_ERROR = {
+    # Redis >= 6.0
+    "AUTH <password> called without any password "
+    "configured for the default user. Are you sure "
+    "your configuration is correct?": AuthenticationError,
+    # Redis < 6.0
+    "Client sent AUTH, but no password is set": AuthenticationError,
+}
 
 
 class Encoder:
@@ -127,7 +136,6 @@ class BaseParser:
     EXCEPTION_CLASSES = {
         "ERR": {
             "max number of clients reached": ConnectionError,
-            "Client sent AUTH, but no password is set": AuthenticationError,
             "invalid password": AuthenticationError,
             # some Redis server versions report invalid command syntax
             # in lowercase
@@ -141,7 +149,9 @@ class BaseParser:
             MODULE_EXPORTS_DATA_TYPES_ERROR: ModuleError,
             NO_SUCH_MODULE_ERROR: ModuleError,
             MODULE_UNLOAD_NOT_POSSIBLE_ERROR: ModuleError,
+            **NO_AUTH_SET_ERROR,
         },
+        "WRONGPASS": AuthenticationError,
         "EXECABORT": ExecAbortError,
         "LOADING": BusyLoadingError,
         "NOSCRIPT": NoScriptError,
diff --git a/tests/test_commands.py b/tests/test_commands.py
index de8020cf07..1c9a5c27eb 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -68,6 +68,14 @@ def test_case_insensitive_command_names(self, r):
 class TestRedisCommands:
     @skip_if_redis_enterprise()
     def test_auth(self, r, request):
+        # sending an AUTH command before setting a user/password on the
+        # server should return an AuthenticationError
+        with pytest.raises(exceptions.AuthenticationError):
+            r.auth("some_password")
+
+        with pytest.raises(exceptions.AuthenticationError):
+            r.auth("some_password", "some_user")
+
         # first, test for default user (`username` is supposed to be optional)
         default_username = "default"
         temp_pass = "temp_pass"
@@ -81,9 +89,19 @@ def test_auth(self, r, request):
 
         def teardown():
             try:
-                r.auth(temp_pass)
-            except exceptions.ResponseError:
-                r.auth("default", "")
+                # this is needed because after an AuthenticationError the connection
+                # is closed, and if we send an AUTH command a new connection is
+                # created, but in this case we'd get an "Authentication required"
+                # error when switching to the db 9 because we're not authenticated yet
+                # setting the password on the connection itself triggers the
+                # authentication in the connection's `on_connect` method
+                r.connection.password = temp_pass
+            except AttributeError:
+                # connection field is not set in Redis Cluster, but that's ok
+                # because the problem discussed above does not apply to Redis Cluster
+                pass
+
+            r.auth(temp_pass)
             r.config_set("requirepass", "")
             r.acl_deluser(username)
 
@@ -95,7 +113,7 @@ def teardown():
 
         assert r.auth(username=username, password="strong_password") is True
 
-        with pytest.raises(exceptions.ResponseError):
+        with pytest.raises(exceptions.AuthenticationError):
             r.auth(username=username, password="wrong_password")
 
     def test_command_on_invalid_key_type(self, r):
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 636b04efad..73eb6e198f 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -553,22 +553,40 @@ def test_connect_from_url_unix(self):
         )
 
     @skip_if_redis_enterprise()
-    def test_connect_no_auth_supplied_when_required(self, r):
+    def test_connect_no_auth_configured(self, r):
         """
-        AuthenticationError should be raised when the server requires a
-        password but one isn't supplied.
+        AuthenticationError should be raised when the server is not configured with auth
+        but credentials are supplied by the user.
         """
+        # Redis < 6
         with pytest.raises(redis.AuthenticationError):
             r.execute_command(
                 "DEBUG", "ERROR", "ERR Client sent AUTH, but no password is set"
             )
 
+        # Redis >= 6
+        with pytest.raises(redis.AuthenticationError):
+            r.execute_command(
+                "DEBUG",
+                "ERROR",
+                "ERR AUTH <password> called without any password "
+                "configured for the default user. Are you sure "
+                "your configuration is correct?",
+            )
+
     @skip_if_redis_enterprise()
-    def test_connect_invalid_password_supplied(self, r):
-        "AuthenticationError should be raised when sending the wrong password"
+    def test_connect_invalid_auth_credentials_supplied(self, r):
+        """
+        AuthenticationError should be raised when sending invalid username/password
+        """
+        # Redis < 6
         with pytest.raises(redis.AuthenticationError):
             r.execute_command("DEBUG", "ERROR", "ERR invalid password")
 
+        # Redis >= 6
+        with pytest.raises(redis.AuthenticationError):
+            r.execute_command("DEBUG", "ERROR", "WRONGPASS")
+
 
 @pytest.mark.onlynoncluster
 class TestMultiConnectionClient:

From a6d473b9e5f09902426042057b0dff9e420d9b98 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 30 Aug 2022 02:38:02 +0300
Subject: [PATCH 0575/1164] Adding reserve as an alias for create, so that we
 have BF.RESERVE and CF.RESERVE accuratenly supported (#2331)

* Adding reserve as an alias for create, so that we have BF.RESERVE accuratenly supported

* add reserve to cf commands

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/commands/bf/commands.py |  4 ++++
 tests/test_bloom.py           | 15 +++++++++++++++
 2 files changed, 19 insertions(+)

diff --git a/redis/commands/bf/commands.py b/redis/commands/bf/commands.py
index 2b16139315..9c3c97c099 100644
--- a/redis/commands/bf/commands.py
+++ b/redis/commands/bf/commands.py
@@ -69,6 +69,8 @@ def create(self, key, errorRate, capacity, expansion=None, noScale=None):
         self.append_no_scale(params, noScale)
         return self.execute_command(BF_RESERVE, *params)
 
+    reserve = create
+
     def add(self, key, item):
         """
         Add to a Bloom Filter `key` an `item`.
@@ -178,6 +180,8 @@ def create(
         self.append_max_iterations(params, max_iterations)
         return self.execute_command(CF_RESERVE, *params)
 
+    reserve = create
+
     def add(self, key, item):
         """
         Add an `item` to a Cuckoo Filter `key`.
diff --git a/tests/test_bloom.py b/tests/test_bloom.py
index 9a3e4a48c1..2ff2ea7983 100644
--- a/tests/test_bloom.py
+++ b/tests/test_bloom.py
@@ -38,6 +38,21 @@ def test_create(client):
     assert client.topk().reserve("topk", 5, 100, 5, 0.9)
 
 
+@pytest.mark.redismod
+def test_bf_reserve(client):
+    """Testing BF.RESERVE"""
+    assert client.bf().reserve("bloom", 0.01, 1000)
+    assert client.bf().reserve("bloom_e", 0.01, 1000, expansion=1)
+    assert client.bf().reserve("bloom_ns", 0.01, 1000, noScale=True)
+    assert client.cf().reserve("cuckoo", 1000)
+    assert client.cf().reserve("cuckoo_e", 1000, expansion=1)
+    assert client.cf().reserve("cuckoo_bs", 1000, bucket_size=4)
+    assert client.cf().reserve("cuckoo_mi", 1000, max_iterations=10)
+    assert client.cms().initbydim("cmsDim", 100, 5)
+    assert client.cms().initbyprob("cmsProb", 0.01, 0.01)
+    assert client.topk().reserve("topk", 5, 100, 5, 0.9)
+
+
 @pytest.mark.redismod
 @pytest.mark.experimental
 def test_tdigest_create(client):

From 0b27e3ebdfd7e7dd67222bcb043fcdfcc907bd42 Mon Sep 17 00:00:00 2001
From: Povilas Balciunas <balciunas90@gmail.com>
Date: Tue, 30 Aug 2022 01:39:36 +0200
Subject: [PATCH 0576/1164] Document Redis(single_connection_client) (#2327)

---
 redis/client.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/redis/client.py b/redis/client.py
index 39fbcdea7a..0662a99ea1 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -945,6 +945,12 @@ def __init__(
         `retry_on_error` to a list of the error/s to retry on, then set
         `retry` to a valid `Retry` object.
         To retry on TimeoutError, `retry_on_timeout` can also be set to `True`.
+
+        Args:
+
+        single_connection_client:
+            if `True`, connection pool is not used. In that case `Redis`
+            instance use is not thread safe.
         """
         if not connection_pool:
             if charset is not None:

From 37344582ec8689035d9106a2141409e78be2606d Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 4 Sep 2022 10:53:01 +0300
Subject: [PATCH 0577/1164] change return type of parse_bollean to bool (#2364)

---
 redis/commands/graph/query_result.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/commands/graph/query_result.py b/redis/commands/graph/query_result.py
index b88b4b656c..7c7f58b99f 100644
--- a/redis/commands/graph/query_result.py
+++ b/redis/commands/graph/query_result.py
@@ -270,7 +270,7 @@ def parse_boolean(self, value):
         """
         value = value.decode() if isinstance(value, bytes) else value
         try:
-            scalar = strtobool(value)
+            scalar = True if strtobool(value) else False
         except ValueError:
             sys.stderr.write("unknown boolean type\n")
             scalar = None

From 744cb09055e464ceb233d80d2c4efa6ec2119aad Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 4 Sep 2022 10:53:22 +0300
Subject: [PATCH 0578/1164] Mark `TOPK.COUNT` as deprecated (#2363)

* deprecate

* linters
---
 redis/commands/bf/commands.py    |  3 +++
 tests/test_asyncio/test_bloom.py | 14 ++++++++------
 tests/test_bloom.py              | 14 ++++++++------
 3 files changed, 19 insertions(+), 12 deletions(-)

diff --git a/redis/commands/bf/commands.py b/redis/commands/bf/commands.py
index 9c3c97c099..3d085e6d0e 100644
--- a/redis/commands/bf/commands.py
+++ b/redis/commands/bf/commands.py
@@ -1,3 +1,5 @@
+from deprecated import deprecated
+
 from redis.client import NEVER_DECODE
 from redis.exceptions import ModuleError
 from redis.utils import HIREDIS_AVAILABLE
@@ -322,6 +324,7 @@ def query(self, key, *items):
         """  # noqa
         return self.execute_command(TOPK_QUERY, key, *items)
 
+    @deprecated(version="4.4.0", reason="deprecated since redisbloom 2.4.0")
     def count(self, key, *items):
         """
         Return count for one `item` or more from `key`.
diff --git a/tests/test_asyncio/test_bloom.py b/tests/test_asyncio/test_bloom.py
index 8e642d2fbd..162a442454 100644
--- a/tests/test_asyncio/test_bloom.py
+++ b/tests/test_asyncio/test_bloom.py
@@ -263,9 +263,10 @@ async def test_topk(modclient: redis.Redis):
     assert [1, 1, 0, 0, 1, 0, 0] == await modclient.topk().query(
         "topk", "A", "B", "C", "D", "E", "F", "G"
     )
-    assert [4, 3, 2, 3, 3, 0, 1] == await modclient.topk().count(
-        "topk", "A", "B", "C", "D", "E", "F", "G"
-    )
+    with pytest.deprecated_call():
+        assert [4, 3, 2, 3, 3, 0, 1] == await modclient.topk().count(
+            "topk", "A", "B", "C", "D", "E", "F", "G"
+        )
 
     # test full list
     assert await modclient.topk().reserve("topklist", 3, 50, 3, 0.9)
@@ -307,9 +308,10 @@ async def test_topk_incrby(modclient: redis.Redis):
     )
     res = await modclient.topk().incrby("topk", ["42", "xyzzy"], [8, 4])
     assert [None, "bar"] == res
-    assert [3, 6, 10, 4, 0] == await modclient.topk().count(
-        "topk", "bar", "baz", "42", "xyzzy", 4
-    )
+    with pytest.deprecated_call():
+        assert [3, 6, 10, 4, 0] == await modclient.topk().count(
+            "topk", "bar", "baz", "42", "xyzzy", 4
+        )
 
 
 # region Test T-Digest
diff --git a/tests/test_bloom.py b/tests/test_bloom.py
index 2ff2ea7983..54fcd69a08 100644
--- a/tests/test_bloom.py
+++ b/tests/test_bloom.py
@@ -280,9 +280,10 @@ def test_topk(client):
     assert [1, 1, 0, 0, 1, 0, 0] == client.topk().query(
         "topk", "A", "B", "C", "D", "E", "F", "G"
     )
-    assert [4, 3, 2, 3, 3, 0, 1] == client.topk().count(
-        "topk", "A", "B", "C", "D", "E", "F", "G"
-    )
+    with pytest.deprecated_call():
+        assert [4, 3, 2, 3, 3, 0, 1] == client.topk().count(
+            "topk", "A", "B", "C", "D", "E", "F", "G"
+        )
 
     # test full list
     assert client.topk().reserve("topklist", 3, 50, 3, 0.9)
@@ -322,9 +323,10 @@ def test_topk_incrby(client):
         "topk", ["bar", "baz", "42"], [3, 6, 2]
     )
     assert [None, "bar"] == client.topk().incrby("topk", ["42", "xyzzy"], [8, 4])
-    assert [3, 6, 10, 4, 0] == client.topk().count(
-        "topk", "bar", "baz", "42", "xyzzy", 4
-    )
+    with pytest.deprecated_call():
+        assert [3, 6, 10, 4, 0] == client.topk().count(
+            "topk", "bar", "baz", "42", "xyzzy", 4
+        )
 
 
 # region Test T-Digest

From cdba4ff001f96e3deae8ac94969f11dde5253d94 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 7 Sep 2022 13:16:28 +0300
Subject: [PATCH 0579/1164] fixing async test for module list (#2367)

---
 tests/test_asyncio/test_commands.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 422328a043..1242e04679 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -2986,7 +2986,8 @@ async def test_memory_usage(self, r: redis.Redis):
     @pytest.mark.onlynoncluster
     async def test_module_list(self, r: redis.Redis):
         assert isinstance(await r.module_list(), list)
-        assert not await r.module_list()
+        for x in await r.module_list():
+            assert isinstance(x, dict)
 
 
 @pytest.mark.onlynoncluster

From 510d8fe089addaea65055aae1e9606d0f40829d4 Mon Sep 17 00:00:00 2001
From: Graeme Clements <graeme44@users.noreply.github.com>
Date: Wed, 7 Sep 2022 12:22:34 +0200
Subject: [PATCH 0580/1164] Fix/readme links (#2368)

* Updated broken README.md links

* Updated CHANGES
---
 CHANGES   | 1 +
 README.md | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/CHANGES b/CHANGES
index 1a15a85698..47600cf0d0 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Update README.md links
     * Fix timezone handling for datetime to unixtime conversions
     * Fix start_id type for XAUTOCLAIM
     * Remove verbose logging from cluster.py
diff --git a/README.md b/README.md
index f5ad9a4191..c7b839d032 100644
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@ The Python interface to the Redis key-value store.
 [![codecov](https://codecov.io/gh/redis/redis-py/branch/master/graph/badge.svg?token=yenl5fzxxr)](https://codecov.io/gh/redis/redis-py)
 [![Total alerts](https://img.shields.io/lgtm/alerts/g/redis/redis-py.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/redis/redis-py/alerts/)
 
-[Installation](#installation) | [Contributing](#contributing) |  [Getting Started](#getting-started) | [Connecting To Redis](#connecting-to-redis) | [Contributing](https://github.com/redis/redis-py/blob/master/CONTRIBUTING.md)
+[Installation](#installation) |  [Usage](#usage) | [Advanced Topics](#advanced-topics) | [Contributing](https://github.com/redis/redis-py/blob/master/CONTRIBUTING.md)
 
 ---------------------------------------------
 

From 67fdd9a294206bb7f8eea38fd1489d8ec86b4cfb Mon Sep 17 00:00:00 2001
From: William Woodruff <william@yossarian.net>
Date: Tue, 13 Sep 2022 18:47:18 -0400
Subject: [PATCH 0581/1164] workflows/integration:
 trailofbits/gh-action-pip-audit is now pypa/gh-action-pip-audit (#2380)

Signed-off-by: William Woodruff <william@trailofbits.com>

Signed-off-by: William Woodruff <william@trailofbits.com>
---
 .github/workflows/integration.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 56dc286bc3..58bde68e93 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -23,7 +23,7 @@ jobs:
      runs-on: ubuntu-latest
      steps:
        - uses: actions/checkout@v3
-       - uses: trailofbits/gh-action-pip-audit@v1.0.0
+       - uses: pypa/gh-action-pip-audit@v1.0.0
          with:
            inputs: requirements.txt dev_requirements.txt
 

From 66c4e600646f37918943dcda4ae9f65cf14781f0 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 15 Sep 2022 18:32:19 +0300
Subject: [PATCH 0582/1164] Adding support for readable test results (#2381)

* test result xml share

* trying to limit to failed

* pathing upload

* syntax

* syntax

* renaming test results

* name fix
---
 .github/workflows/integration.yaml | 15 +++++++++++++++
 tox.ini                            |  8 ++++----
 2 files changed, 19 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 58bde68e93..c1110b1f68 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -66,6 +66,21 @@ jobs:
            pip install -U setuptools wheel
            pip install -r dev_requirements.txt
            tox -e ${{matrix.test-type}}-${{matrix.connection-type}}
+       - uses: actions/upload-artifact@v2
+         if: success() || failure()
+         with:
+           name: pytest-results-${{matrix.test-type}}
+           path: '${{matrix.test-type}}*results.xml'
+       - name: View Test Results
+         uses: dorny/test-reporter@v1
+         if: success() || failure()
+         with:
+           name: Test Results ${{matrix.python-version}} ${{matrix.test-type}}-${{matrix.connection-type}}
+           path: '${{matrix.test-type}}*results.xml'
+           reporter: java-junit
+           list-suites: failed
+           list-tests: failed
+           max-annotations: 10
        - name: Upload codecov coverage
          uses: codecov/codecov-action@v2
          with:
diff --git a/tox.ini b/tox.ini
index 37603fe8e1..6afafc2962 100644
--- a/tox.ini
+++ b/tox.ini
@@ -288,10 +288,10 @@ setenv =
     CLUSTER_URL = "redis://localhost:16379/0"
     UNSTABLE_CLUSTER_URL = "redis://localhost:6372/0"
 commands =
-    standalone: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' {posargs}
-    standalone-uvloop: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' --uvloop {posargs}
-    cluster: pytest --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={env:CLUSTER_URL:} --redis-unstable-url={env:UNSTABLE_CLUSTER_URL:} {posargs}
-    cluster-uvloop: pytest --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={env:CLUSTER_URL:} --redis-unstable-url={env:UNSTABLE_CLUSTER_URL:} --uvloop {posargs}
+    standalone: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' --junit-xml=standalone-results.xml {posargs}
+    standalone-uvloop: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' --junit-xml=standalone-uvloop-results.xml --uvloop {posargs}
+    cluster: pytest --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={env:CLUSTER_URL:} --redis-unstable-url={env:UNSTABLE_CLUSTER_URL:} --junit-xml=cluster-results.xml {posargs}
+    cluster-uvloop: pytest --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={env:CLUSTER_URL:} --redis-unstable-url={env:UNSTABLE_CLUSTER_URL:} --junit-xml=cluster-uvloop-results.xml --uvloop {posargs}
 
 [testenv:redis5]
 deps =

From 027b452316534d7ba868f3d58cfebc8cf1a9a804 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 21 Sep 2022 11:53:16 +0300
Subject: [PATCH 0583/1164] Add support for new TDIGEST features and changes
 (#2392)

* Add support to TDIGEST

* linters

* linters

* linters

* disable View Test Results in CI
---
 .github/workflows/integration.yaml | 30 ++++-----
 redis/commands/bf/__init__.py      |  9 ++-
 redis/commands/bf/commands.py      | 62 ++++++++++++++-----
 redis/commands/bf/info.py          | 24 +++++---
 redis/commands/bf/utils.py         |  3 -
 tests/test_asyncio/test_bloom.py   | 99 +++++++++++++++++++++++-------
 tests/test_bloom.py                | 90 ++++++++++++++++++++-------
 7 files changed, 229 insertions(+), 88 deletions(-)
 delete mode 100644 redis/commands/bf/utils.py

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index c1110b1f68..4812f8a125 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -71,21 +71,21 @@ jobs:
          with:
            name: pytest-results-${{matrix.test-type}}
            path: '${{matrix.test-type}}*results.xml'
-       - name: View Test Results
-         uses: dorny/test-reporter@v1
-         if: success() || failure()
-         with:
-           name: Test Results ${{matrix.python-version}} ${{matrix.test-type}}-${{matrix.connection-type}}
-           path: '${{matrix.test-type}}*results.xml'
-           reporter: java-junit
-           list-suites: failed
-           list-tests: failed
-           max-annotations: 10
-       - name: Upload codecov coverage
-         uses: codecov/codecov-action@v2
-         with:
-           fail_ci_if_error: false
-           token: ${{ secrets.CODECOV_TOKEN }}
+      #  - name: View Test Results
+      #    uses: dorny/test-reporter@v1
+      #    if: success() || failure()
+      #    with:
+      #      name: Test Results ${{matrix.python-version}} ${{matrix.test-type}}-${{matrix.connection-type}}
+      #      path: '${{matrix.test-type}}*results.xml'
+      #      reporter: java-junit
+      #      list-suites: failed
+      #      list-tests: failed
+      #      max-annotations: 10
+      #  - name: Upload codecov coverage
+      #    uses: codecov/codecov-action@v2
+      #    with:
+      #      fail_ci_if_error: false
+      #      token: ${{ secrets.CODECOV_TOKEN }}
 
    build_and_test_package:
     name: Validate building and installing the package
diff --git a/redis/commands/bf/__init__.py b/redis/commands/bf/__init__.py
index e41354b29f..a448def46d 100644
--- a/redis/commands/bf/__init__.py
+++ b/redis/commands/bf/__init__.py
@@ -3,7 +3,6 @@
 from ..helpers import parse_to_list
 from .commands import *  # noqa
 from .info import BFInfo, CFInfo, CMSInfo, TDigestInfo, TopKInfo
-from .utils import parse_tdigest_quantile
 
 
 class AbstractBloom(object):
@@ -166,12 +165,16 @@ def __init__(self, client, **kwargs):
             # TDIGEST_RESET: bool_ok,
             # TDIGEST_ADD: spaceHolder,
             # TDIGEST_MERGE: spaceHolder,
-            TDIGEST_CDF: float,
-            TDIGEST_QUANTILE: parse_tdigest_quantile,
+            TDIGEST_CDF: parse_to_list,
+            TDIGEST_QUANTILE: parse_to_list,
             TDIGEST_MIN: float,
             TDIGEST_MAX: float,
             TDIGEST_TRIMMED_MEAN: float,
             TDIGEST_INFO: TDigestInfo,
+            TDIGEST_RANK: parse_to_list,
+            TDIGEST_REVRANK: parse_to_list,
+            TDIGEST_BYRANK: parse_to_list,
+            TDIGEST_BYREVRANK: parse_to_list,
         }
 
         self.client = client
diff --git a/redis/commands/bf/commands.py b/redis/commands/bf/commands.py
index 3d085e6d0e..71c9c8a593 100644
--- a/redis/commands/bf/commands.py
+++ b/redis/commands/bf/commands.py
@@ -52,7 +52,10 @@
 TDIGEST_MAX = "TDIGEST.MAX"
 TDIGEST_INFO = "TDIGEST.INFO"
 TDIGEST_TRIMMED_MEAN = "TDIGEST.TRIMMED_MEAN"
-TDIGEST_MERGESTORE = "TDIGEST.MERGESTORE"
+TDIGEST_RANK = "TDIGEST.RANK"
+TDIGEST_REVRANK = "TDIGEST.REVRANK"
+TDIGEST_BYRANK = "TDIGEST.BYRANK"
+TDIGEST_BYREVRANK = "TDIGEST.BYREVRANK"
 
 
 class BFCommands:
@@ -381,12 +384,22 @@ def add(self, key, values, weights):
         self.append_values_and_weights(params, values, weights)
         return self.execute_command(TDIGEST_ADD, *params)
 
-    def merge(self, toKey, fromKey):
+    def merge(self, destination_key, num_keys, *keys, compression=None, override=False):
         """
-        Merge all of the values from 'fromKey' to 'toKey' sketch.
+        Merges all of the values from `keys` to 'destination-key' sketch.
+        It is mandatory to provide the `num_keys` before passing the input keys and
+        the other (optional) arguments.
+        If `destination_key` already exists its values are merged with the input keys.
+        If you wish to override the destination key contents use the `OVERRIDE` parameter.
+
         For more information see `TDIGEST.MERGE <https://redis.io/commands/tdigest.merge>`_.
         """  # noqa
-        return self.execute_command(TDIGEST_MERGE, toKey, fromKey)
+        params = [destination_key, num_keys, *keys]
+        if compression is not None:
+            params.extend(["COMPRESSION", compression])
+        if override:
+            params.append("OVERRIDE")
+        return self.execute_command(TDIGEST_MERGE, *params)
 
     def min(self, key):
         """
@@ -411,12 +424,12 @@ def quantile(self, key, quantile, *quantiles):
         """  # noqa
         return self.execute_command(TDIGEST_QUANTILE, key, quantile, *quantiles)
 
-    def cdf(self, key, value):
+    def cdf(self, key, value, *values):
         """
         Return double fraction of all points added which are <= value.
         For more information see `TDIGEST.CDF <https://redis.io/commands/tdigest.cdf>`_.
         """  # noqa
-        return self.execute_command(TDIGEST_CDF, key, value)
+        return self.execute_command(TDIGEST_CDF, key, value, *values)
 
     def info(self, key):
         """
@@ -436,18 +449,39 @@ def trimmed_mean(self, key, low_cut_quantile, high_cut_quantile):
             TDIGEST_TRIMMED_MEAN, key, low_cut_quantile, high_cut_quantile
         )
 
-    def mergestore(self, dest_key, numkeys, *sourcekeys, compression=False):
+    def rank(self, key, value, *values):
         """
-        Merges all of the values from `sourcekeys` keys to `dest_key` sketch.
-        If destination already exists, it is overwritten.
+        Retrieve the estimated rank of value (the number of observations in the sketch
+        that are smaller than value + half the number of observations that are equal to value).
 
+        For more information see `TDIGEST.RANK <https://redis.io/commands/tdigest.rank>`_.
+        """  # noqa
+        return self.execute_command(TDIGEST_RANK, key, value, *values)
 
-        For more information see `TDIGEST.MERGESTORE <https://redis.io/commands/tdigest.mergestore>`_.
+    def revrank(self, key, value, *values):
+        """
+        Retrieve the estimated rank of value (the number of observations in the sketch
+        that are larger than value + half the number of observations that are equal to value).
+
+        For more information see `TDIGEST.REVRANK <https://redis.io/commands/tdigest.revrank>`_.
         """  # noqa
-        params = [dest_key, numkeys, *sourcekeys]
-        if compression:
-            params.extend(["COMPRESSION", compression])
-        return self.execute_command(TDIGEST_MERGESTORE, *params)
+        return self.execute_command(TDIGEST_REVRANK, key, value, *values)
+
+    def byrank(self, key, rank, *ranks):
+        """
+        Retrieve an estimation of the value with the given rank.
+
+        For more information see `TDIGEST.BY_RANK <https://redis.io/commands/tdigest.by_rank>`_.
+        """  # noqa
+        return self.execute_command(TDIGEST_BYRANK, key, rank, *ranks)
+
+    def byrevrank(self, key, rank, *ranks):
+        """
+        Retrieve an estimation of the value with the given reverse rank.
+
+        For more information see `TDIGEST.BY_REVRANK <https://redis.io/commands/tdigest.by_revrank>`_.
+        """  # noqa
+        return self.execute_command(TDIGEST_BYREVRANK, key, rank, *ranks)
 
 
 class CMSCommands:
diff --git a/redis/commands/bf/info.py b/redis/commands/bf/info.py
index 24c5419bb7..c4d3e5814b 100644
--- a/redis/commands/bf/info.py
+++ b/redis/commands/bf/info.py
@@ -68,18 +68,22 @@ def __init__(self, args):
 class TDigestInfo(object):
     compression = None
     capacity = None
-    mergedNodes = None
-    unmergedNodes = None
-    mergedWeight = None
-    unmergedWeight = None
-    totalCompressions = None
+    merged_nodes = None
+    unmerged_nodes = None
+    merged_weight = None
+    unmerged_weight = None
+    total_compressions = None
+    sum_weights = None
+    memory_usage = None
 
     def __init__(self, args):
         response = dict(zip(map(nativestr, args[::2]), args[1::2]))
         self.compression = response["Compression"]
         self.capacity = response["Capacity"]
-        self.mergedNodes = response["Merged nodes"]
-        self.unmergedNodes = response["Unmerged nodes"]
-        self.mergedWeight = response["Merged weight"]
-        self.unmergedWeight = response["Unmerged weight"]
-        self.totalCompressions = response["Total compressions"]
+        self.merged_nodes = response["Merged nodes"]
+        self.unmerged_nodes = response["Unmerged nodes"]
+        self.merged_weight = response["Merged weight"]
+        self.unmerged_weight = response["Unmerged weight"]
+        self.total_compressions = response["Total compressions"]
+        self.sum_weights = response["Sum weights"]
+        self.memory_usage = response["Memory usage"]
diff --git a/redis/commands/bf/utils.py b/redis/commands/bf/utils.py
deleted file mode 100644
index 21dcfa77a2..0000000000
--- a/redis/commands/bf/utils.py
+++ /dev/null
@@ -1,3 +0,0 @@
-def parse_tdigest_quantile(response):
-    """Parse TDIGEST.QUANTILE response."""
-    return [float(x) for x in response]
diff --git a/tests/test_asyncio/test_bloom.py b/tests/test_asyncio/test_bloom.py
index 162a442454..326924c9c5 100644
--- a/tests/test_asyncio/test_bloom.py
+++ b/tests/test_asyncio/test_bloom.py
@@ -1,3 +1,5 @@
+from math import inf
+
 import pytest
 
 import redis.asyncio as redis
@@ -322,11 +324,11 @@ async def test_tdigest_reset(modclient: redis.Redis):
     # reset on empty histogram
     assert await modclient.tdigest().reset("tDigest")
     # insert data-points into sketch
-    assert await modclient.tdigest().add("tDigest", list(range(10)), [1.0] * 10)
+    assert await modclient.tdigest().add("tDigest", list(range(10)), [1] * 10)
 
     assert await modclient.tdigest().reset("tDigest")
     # assert we have 0 unmerged nodes
-    assert 0 == (await modclient.tdigest().info("tDigest")).unmergedNodes
+    assert 0 == (await modclient.tdigest().info("tDigest")).unmerged_nodes
 
 
 @pytest.mark.redismod
@@ -335,14 +337,24 @@ async def test_tdigest_merge(modclient: redis.Redis):
     assert await modclient.tdigest().create("to-tDigest", 10)
     assert await modclient.tdigest().create("from-tDigest", 10)
     # insert data-points into sketch
-    assert await modclient.tdigest().add("from-tDigest", [1.0] * 10, [1.0] * 10)
-    assert await modclient.tdigest().add("to-tDigest", [2.0] * 10, [10.0] * 10)
+    assert await modclient.tdigest().add("from-tDigest", [1.0] * 10, [1] * 10)
+    assert await modclient.tdigest().add("to-tDigest", [2.0] * 10, [10] * 10)
     # merge from-tdigest into to-tdigest
-    assert await modclient.tdigest().merge("to-tDigest", "from-tDigest")
+    assert await modclient.tdigest().merge("to-tDigest", 1, "from-tDigest")
     # we should now have 110 weight on to-histogram
     info = await modclient.tdigest().info("to-tDigest")
-    total_weight_to = float(info.mergedWeight) + float(info.unmergedWeight)
+    total_weight_to = float(info.merged_weight) + float(info.unmerged_weight)
     assert 110 == total_weight_to
+    # test override
+    assert await modclient.tdigest().create("from-override", 10)
+    assert await modclient.tdigest().create("from-override-2", 10)
+    assert await modclient.tdigest().add("from-override", [3.0] * 10, [10] * 10)
+    assert await modclient.tdigest().add("from-override-2", [4.0] * 10, [10] * 10)
+    assert await modclient.tdigest().merge(
+        "to-tDigest", 2, "from-override", "from-override-2", override=True
+    )
+    assert 3.0 == await modclient.tdigest().min("to-tDigest")
+    assert 4.0 == await modclient.tdigest().max("to-tDigest")
 
 
 @pytest.mark.redismod
@@ -350,7 +362,7 @@ async def test_tdigest_merge(modclient: redis.Redis):
 async def test_tdigest_min_and_max(modclient: redis.Redis):
     assert await modclient.tdigest().create("tDigest", 100)
     # insert data-points into sketch
-    assert await modclient.tdigest().add("tDigest", [1, 2, 3], [1.0] * 3)
+    assert await modclient.tdigest().add("tDigest", [1, 2, 3], [1] * 3)
     # min/max
     assert 3 == await modclient.tdigest().max("tDigest")
     assert 1 == await modclient.tdigest().min("tDigest")
@@ -363,12 +375,12 @@ async def test_tdigest_quantile(modclient: redis.Redis):
     assert await modclient.tdigest().create("tDigest", 500)
     # insert data-points into sketch
     assert await modclient.tdigest().add(
-        "tDigest", list([x * 0.01 for x in range(1, 10000)]), [1.0] * 10000
+        "tDigest", list([x * 0.01 for x in range(1, 10000)]), [1] * 10000
     )
     # assert min min/max have same result as quantile 0 and 1
     assert (
         await modclient.tdigest().max("tDigest")
-        == (await modclient.tdigest().quantile("tDigest", 1.0))[0]
+        == (await modclient.tdigest().quantile("tDigest", 1))[0]
     )
     assert (
         await modclient.tdigest().min("tDigest")
@@ -380,7 +392,7 @@ async def test_tdigest_quantile(modclient: redis.Redis):
 
     # test multiple quantiles
     assert await modclient.tdigest().create("t-digest", 100)
-    assert await modclient.tdigest().add("t-digest", [1, 2, 3, 4, 5], [1.0] * 5)
+    assert await modclient.tdigest().add("t-digest", [1, 2, 3, 4, 5], [1] * 5)
     res = await modclient.tdigest().quantile("t-digest", 0.5, 0.8)
     assert [3.0, 5.0] == res
 
@@ -390,22 +402,67 @@ async def test_tdigest_quantile(modclient: redis.Redis):
 async def test_tdigest_cdf(modclient: redis.Redis):
     assert await modclient.tdigest().create("tDigest", 100)
     # insert data-points into sketch
-    assert await modclient.tdigest().add("tDigest", list(range(1, 10)), [1.0] * 10)
-    assert 0.1 == round(await modclient.tdigest().cdf("tDigest", 1.0), 1)
-    assert 0.9 == round(await modclient.tdigest().cdf("tDigest", 9.0), 1)
+    assert await modclient.tdigest().add("tDigest", list(range(1, 10)), [1] * 10)
+    assert 0.1 == round((await modclient.tdigest().cdf("tDigest", 1.0))[0], 1)
+    assert 0.9 == round((await modclient.tdigest().cdf("tDigest", 9.0))[0], 1)
+    res = await modclient.tdigest().cdf("tDigest", 1.0, 9.0)
+    assert [0.1, 0.9] == [round(x, 1) for x in res]
 
 
 @pytest.mark.redismod
 @pytest.mark.experimental
 @skip_ifmodversion_lt("2.4.0", "bf")
-async def test_tdigest_mergestore(modclient: redis.Redis):
-    assert await modclient.tdigest().create("sourcekey1", 100)
-    assert await modclient.tdigest().create("sourcekey2", 100)
-    assert await modclient.tdigest().add("sourcekey1", [10], [1.0])
-    assert await modclient.tdigest().add("sourcekey2", [50], [1.0])
-    assert await modclient.tdigest().mergestore("dest", 2, "sourcekey1", "sourcekey2")
-    assert await modclient.tdigest().max("dest") == 50
-    assert await modclient.tdigest().min("dest") == 10
+async def test_tdigest_trimmed_mean(modclient: redis.Redis):
+    assert await modclient.tdigest().create("tDigest", 100)
+    # insert data-points into sketch
+    assert await modclient.tdigest().add("tDigest", list(range(1, 10)), [1] * 10)
+    assert 5 == await modclient.tdigest().trimmed_mean("tDigest", 0.1, 0.9)
+    assert 4.5 == await modclient.tdigest().trimmed_mean("tDigest", 0.4, 0.5)
+
+
+@pytest.mark.redismod
+@pytest.mark.experimental
+async def test_tdigest_rank(modclient: redis.Redis):
+    assert await modclient.tdigest().create("t-digest", 500)
+    assert await modclient.tdigest().add("t-digest", list(range(0, 20)), [1] * 20)
+    assert -1 == (await modclient.tdigest().rank("t-digest", -1))[0]
+    assert 1 == (await modclient.tdigest().rank("t-digest", 0))[0]
+    assert 11 == (await modclient.tdigest().rank("t-digest", 10))[0]
+    assert [-1, 20, 10] == await modclient.tdigest().rank("t-digest", -20, 20, 9)
+
+
+@pytest.mark.redismod
+@pytest.mark.experimental
+async def test_tdigest_revrank(modclient: redis.Redis):
+    assert await modclient.tdigest().create("t-digest", 500)
+    assert await modclient.tdigest().add("t-digest", list(range(0, 20)), [1] * 20)
+    assert -1 == (await modclient.tdigest().revrank("t-digest", 20))[0]
+    assert 20 == (await modclient.tdigest().revrank("t-digest", 0))[0]
+    assert [-1, 20, 10] == await modclient.tdigest().revrank("t-digest", 21, 0, 10)
+
+
+@pytest.mark.redismod
+@pytest.mark.experimental
+async def test_tdigest_byrank(modclient: redis.Redis):
+    assert await modclient.tdigest().create("t-digest", 500)
+    assert await modclient.tdigest().add("t-digest", list(range(1, 11)), [1] * 20)
+    assert 1 == (await modclient.tdigest().byrank("t-digest", 0))[0]
+    assert 10 == (await modclient.tdigest().byrank("t-digest", 9))[0]
+    assert (await modclient.tdigest().byrank("t-digest", 100))[0] == inf
+    with pytest.raises(redis.ResponseError):
+        (await modclient.tdigest().byrank("t-digest", -1))[0]
+
+
+@pytest.mark.redismod
+@pytest.mark.experimental
+async def test_tdigest_byrevrank(modclient: redis.Redis):
+    assert await modclient.tdigest().create("t-digest", 500)
+    assert await modclient.tdigest().add("t-digest", list(range(1, 11)), [1] * 20)
+    assert 10 == (await modclient.tdigest().byrevrank("t-digest", 0))[0]
+    assert 2 == (await modclient.tdigest().byrevrank("t-digest", 9))[0]
+    assert (await modclient.tdigest().byrevrank("t-digest", 100))[0] == -inf
+    with pytest.raises(redis.ResponseError):
+        (await modclient.tdigest().byrevrank("t-digest", -1))[0]
 
 
 # @pytest.mark.redismod
diff --git a/tests/test_bloom.py b/tests/test_bloom.py
index 54fcd69a08..1194140241 100644
--- a/tests/test_bloom.py
+++ b/tests/test_bloom.py
@@ -1,3 +1,5 @@
+from math import inf
+
 import pytest
 
 import redis.commands.bf
@@ -337,11 +339,11 @@ def test_tdigest_reset(client):
     # reset on empty histogram
     assert client.tdigest().reset("tDigest")
     # insert data-points into sketch
-    assert client.tdigest().add("tDigest", list(range(10)), [1.0] * 10)
+    assert client.tdigest().add("tDigest", list(range(10)), [1] * 10)
 
     assert client.tdigest().reset("tDigest")
     # assert we have 0 unmerged nodes
-    assert 0 == client.tdigest().info("tDigest").unmergedNodes
+    assert 0 == client.tdigest().info("tDigest").unmerged_nodes
 
 
 @pytest.mark.redismod
@@ -350,14 +352,24 @@ def test_tdigest_merge(client):
     assert client.tdigest().create("to-tDigest", 10)
     assert client.tdigest().create("from-tDigest", 10)
     # insert data-points into sketch
-    assert client.tdigest().add("from-tDigest", [1.0] * 10, [1.0] * 10)
-    assert client.tdigest().add("to-tDigest", [2.0] * 10, [10.0] * 10)
+    assert client.tdigest().add("from-tDigest", [1.0] * 10, [1] * 10)
+    assert client.tdigest().add("to-tDigest", [2.0] * 10, [10] * 10)
     # merge from-tdigest into to-tdigest
-    assert client.tdigest().merge("to-tDigest", "from-tDigest")
+    assert client.tdigest().merge("to-tDigest", 1, "from-tDigest")
     # we should now have 110 weight on to-histogram
     info = client.tdigest().info("to-tDigest")
-    total_weight_to = float(info.mergedWeight) + float(info.unmergedWeight)
+    total_weight_to = float(info.merged_weight) + float(info.unmerged_weight)
     assert 110 == total_weight_to
+    # test override
+    assert client.tdigest().create("from-override", 10)
+    assert client.tdigest().create("from-override-2", 10)
+    assert client.tdigest().add("from-override", [3.0] * 10, [10] * 10)
+    assert client.tdigest().add("from-override-2", [4.0] * 10, [10] * 10)
+    assert client.tdigest().merge(
+        "to-tDigest", 2, "from-override", "from-override-2", override=True
+    )
+    assert 3.0 == client.tdigest().min("to-tDigest")
+    assert 4.0 == client.tdigest().max("to-tDigest")
 
 
 @pytest.mark.redismod
@@ -365,7 +377,7 @@ def test_tdigest_merge(client):
 def test_tdigest_min_and_max(client):
     assert client.tdigest().create("tDigest", 100)
     # insert data-points into sketch
-    assert client.tdigest().add("tDigest", [1, 2, 3], [1.0] * 3)
+    assert client.tdigest().add("tDigest", [1, 2, 3], [1] * 3)
     # min/max
     assert 3 == client.tdigest().max("tDigest")
     assert 1 == client.tdigest().min("tDigest")
@@ -378,7 +390,7 @@ def test_tdigest_quantile(client):
     assert client.tdigest().create("tDigest", 500)
     # insert data-points into sketch
     assert client.tdigest().add(
-        "tDigest", list([x * 0.01 for x in range(1, 10000)]), [1.0] * 10000
+        "tDigest", list([x * 0.01 for x in range(1, 10000)]), [1] * 10000
     )
     # assert min min/max have same result as quantile 0 and 1
     res = client.tdigest().quantile("tDigest", 1.0)
@@ -391,7 +403,7 @@ def test_tdigest_quantile(client):
 
     # test multiple quantiles
     assert client.tdigest().create("t-digest", 100)
-    assert client.tdigest().add("t-digest", [1, 2, 3, 4, 5], [1.0] * 5)
+    assert client.tdigest().add("t-digest", [1, 2, 3, 4, 5], [1] * 5)
     assert [3.0, 5.0] == client.tdigest().quantile("t-digest", 0.5, 0.8)
 
 
@@ -400,9 +412,11 @@ def test_tdigest_quantile(client):
 def test_tdigest_cdf(client):
     assert client.tdigest().create("tDigest", 100)
     # insert data-points into sketch
-    assert client.tdigest().add("tDigest", list(range(1, 10)), [1.0] * 10)
-    assert 0.1 == round(client.tdigest().cdf("tDigest", 1.0), 1)
-    assert 0.9 == round(client.tdigest().cdf("tDigest", 9.0), 1)
+    assert client.tdigest().add("tDigest", list(range(1, 10)), [1] * 10)
+    assert 0.1 == round(client.tdigest().cdf("tDigest", 1.0)[0], 1)
+    assert 0.9 == round(client.tdigest().cdf("tDigest", 9.0)[0], 1)
+    res = client.tdigest().cdf("tDigest", 1.0, 9.0)
+    assert [0.1, 0.9] == [round(x, 1) for x in res]
 
 
 @pytest.mark.redismod
@@ -411,22 +425,54 @@ def test_tdigest_cdf(client):
 def test_tdigest_trimmed_mean(client):
     assert client.tdigest().create("tDigest", 100)
     # insert data-points into sketch
-    assert client.tdigest().add("tDigest", list(range(1, 10)), [1.0] * 10)
+    assert client.tdigest().add("tDigest", list(range(1, 10)), [1] * 10)
     assert 5 == client.tdigest().trimmed_mean("tDigest", 0.1, 0.9)
     assert 4.5 == client.tdigest().trimmed_mean("tDigest", 0.4, 0.5)
 
 
 @pytest.mark.redismod
 @pytest.mark.experimental
-@skip_ifmodversion_lt("2.4.0", "bf")
-def test_tdigest_mergestore(client):
-    assert client.tdigest().create("sourcekey1", 100)
-    assert client.tdigest().create("sourcekey2", 100)
-    assert client.tdigest().add("sourcekey1", [10], [1.0])
-    assert client.tdigest().add("sourcekey2", [50], [1.0])
-    assert client.tdigest().mergestore("destkey", 2, "sourcekey1", "sourcekey2")
-    assert client.tdigest().max("destkey") == 50
-    assert client.tdigest().min("destkey") == 10
+def test_tdigest_rank(client):
+    assert client.tdigest().create("t-digest", 500)
+    assert client.tdigest().add("t-digest", list(range(0, 20)), [1] * 20)
+    assert -1 == client.tdigest().rank("t-digest", -1)[0]
+    assert 1 == client.tdigest().rank("t-digest", 0)[0]
+    assert 11 == client.tdigest().rank("t-digest", 10)[0]
+    assert [-1, 20, 10] == client.tdigest().rank("t-digest", -20, 20, 9)
+
+
+@pytest.mark.redismod
+@pytest.mark.experimental
+def test_tdigest_revrank(client):
+    assert client.tdigest().create("t-digest", 500)
+    assert client.tdigest().add("t-digest", list(range(0, 20)), [1] * 20)
+    assert -1 == client.tdigest().revrank("t-digest", 20)[0]
+    assert 20 == client.tdigest().revrank("t-digest", 0)[0]
+    assert [-1, 20, 10] == client.tdigest().revrank("t-digest", 21, 0, 10)
+
+
+@pytest.mark.redismod
+@pytest.mark.experimental
+def test_tdigest_byrank(client):
+    assert client.tdigest().create("t-digest", 500)
+    assert client.tdigest().add("t-digest", list(range(1, 11)), [1] * 20)
+    assert 1 == client.tdigest().byrank("t-digest", 0)[0]
+    assert 10 == client.tdigest().byrank("t-digest", 9)[0]
+    assert client.tdigest().byrank("t-digest", 100)[0] == inf
+    with pytest.raises(redis.ResponseError):
+        client.tdigest().byrank("t-digest", -1)[0]
+
+
+@pytest.mark.redismod
+@pytest.mark.experimental
+def test_tdigest_byrevrank(client):
+    assert client.tdigest().create("t-digest", 500)
+    assert client.tdigest().add("t-digest", list(range(1, 11)), [1] * 20)
+    assert 10 == client.tdigest().byrevrank("t-digest", 0)[0]
+    assert 2 == client.tdigest().byrevrank("t-digest", 9)[0]
+    assert client.tdigest().byrevrank("t-digest", 100)[0] == -inf
+    with pytest.raises(redis.ResponseError):
+        client.tdigest().byrevrank("t-digest", -1)[0]
 
 
 # @pytest.mark.redismod

From 947b8e8595e3aff4aeb3eb3ebbe56b86fb5e76fb Mon Sep 17 00:00:00 2001
From: Aarni Koskela <akx@iki.fi>
Date: Wed, 21 Sep 2022 16:16:44 +0300
Subject: [PATCH 0584/1164] Reinstate codecov in CI (removed in #2392) (#2394)

Since this is a public project, the token shouldn't be necessary
---
 .github/workflows/integration.yaml | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 4812f8a125..1089b27608 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -71,6 +71,10 @@ jobs:
          with:
            name: pytest-results-${{matrix.test-type}}
            path: '${{matrix.test-type}}*results.xml'
+       - name: Upload codecov coverage
+         uses: codecov/codecov-action@v3
+         with:
+           fail_ci_if_error: false
       #  - name: View Test Results
       #    uses: dorny/test-reporter@v1
       #    if: success() || failure()
@@ -81,11 +85,6 @@ jobs:
       #      list-suites: failed
       #      list-tests: failed
       #      max-annotations: 10
-      #  - name: Upload codecov coverage
-      #    uses: codecov/codecov-action@v2
-      #    with:
-      #      fail_ci_if_error: false
-      #      token: ${{ secrets.CODECOV_TOKEN }}
 
    build_and_test_package:
     name: Validate building and installing the package

From 027abe524acd0aec24e92ea7eef328f983d5278c Mon Sep 17 00:00:00 2001
From: Aarni Koskela <akx@iki.fi>
Date: Wed, 28 Sep 2022 14:09:32 +0300
Subject: [PATCH 0585/1164] Support Hiredis >= 1.x only (remove `packaging`
 dependency) (#2385)

* Only set HIREDIS_AVAILABLE if Hiredis is not 0.x

* Remove compatibility code for old Hiredis versions

* Move packaging dependency to dev only
---
 CHANGES              |  1 +
 README.md            |  3 ++-
 dev_requirements.txt |  1 +
 redis/connection.py  | 54 ++++++++------------------------------------
 redis/utils.py       |  3 ++-
 requirements.txt     |  1 -
 setup.py             |  1 -
 7 files changed, 16 insertions(+), 48 deletions(-)

diff --git a/CHANGES b/CHANGES
index 47600cf0d0..75fa83cbe2 100644
--- a/CHANGES
+++ b/CHANGES
@@ -19,6 +19,7 @@
     * Fix reusing the old nodes' connections when cluster topology refresh is being done
     * Fix RedisCluster to immediately raise AuthenticationError without a retry
     * ClusterPipeline Doesn't Handle ConnectionError for Dead Hosts (#2225)
+    * Remove compatibility code for old versions of Hiredis, drop Packaging dependency
 
 * 4.1.3 (Feb 8, 2022)
     * Fix flushdb and flushall (#1926)
diff --git a/README.md b/README.md
index c7b839d032..8b7333e157 100644
--- a/README.md
+++ b/README.md
@@ -27,7 +27,8 @@ To install redis-py, simply:
 $ pip install redis
 ```
 
-For faster performance, install redis with hiredis support, this provides a compiled response parser, and *for most cases* requires zero code changes. By default, if hiredis is available, redis-py will attempt to use it for response parsing.
+For faster performance, install redis with hiredis support, this provides a compiled response parser, and *for most cases* requires zero code changes.
+By default, if hiredis >= 1.0 is available, redis-py will attempt to use it for response parsing.
 
 ``` bash
 $ pip install redis[hiredis]
diff --git a/dev_requirements.txt b/dev_requirements.txt
index 31ae26ebea..66be6d1d64 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -4,6 +4,7 @@ flake8==4.0.1
 flynt~=0.69.0
 isort==5.10.1
 mock==4.0.3
+packaging>=20.4
 pytest==6.2.5
 pytest-timeout==2.0.1
 pytest-asyncio>=0.16.0
diff --git a/redis/connection.py b/redis/connection.py
index 3281b14d80..491df8e027 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -10,8 +10,6 @@
 from time import time
 from urllib.parse import parse_qs, unquote, urlparse
 
-from packaging.version import Version
-
 from redis.backoff import NoBackoff
 from redis.exceptions import (
     AuthenticationError,
@@ -54,16 +52,6 @@
 if HIREDIS_AVAILABLE:
     import hiredis
 
-    hiredis_version = Version(hiredis.__version__)
-    HIREDIS_SUPPORTS_CALLABLE_ERRORS = hiredis_version >= Version("0.1.3")
-    HIREDIS_SUPPORTS_BYTE_BUFFER = hiredis_version >= Version("0.1.4")
-    HIREDIS_SUPPORTS_ENCODING_ERRORS = hiredis_version >= Version("1.0.0")
-
-    HIREDIS_USE_BYTE_BUFFER = True
-    # only use byte buffer if hiredis supports it
-    if not HIREDIS_SUPPORTS_BYTE_BUFFER:
-        HIREDIS_USE_BYTE_BUFFER = False
-
 SYM_STAR = b"*"
 SYM_DOLLAR = b"$"
 SYM_CRLF = b"\r\n"
@@ -380,9 +368,7 @@ def __init__(self, socket_read_size):
         if not HIREDIS_AVAILABLE:
             raise RedisError("Hiredis is not installed")
         self.socket_read_size = socket_read_size
-
-        if HIREDIS_USE_BYTE_BUFFER:
-            self._buffer = bytearray(socket_read_size)
+        self._buffer = bytearray(socket_read_size)
 
     def __del__(self):
         try:
@@ -393,16 +379,14 @@ def __del__(self):
     def on_connect(self, connection, **kwargs):
         self._sock = connection._sock
         self._socket_timeout = connection.socket_timeout
-        kwargs = {"protocolError": InvalidResponse, "replyError": self.parse_error}
-
-        # hiredis < 0.1.3 doesn't support functions that create exceptions
-        if not HIREDIS_SUPPORTS_CALLABLE_ERRORS:
-            kwargs["replyError"] = ResponseError
+        kwargs = {
+            "protocolError": InvalidResponse,
+            "replyError": self.parse_error,
+            "errors": connection.encoder.encoding_errors,
+        }
 
         if connection.encoder.decode_responses:
             kwargs["encoding"] = connection.encoder.encoding
-        if HIREDIS_SUPPORTS_ENCODING_ERRORS:
-            kwargs["errors"] = connection.encoder.encoding_errors
         self._reader = hiredis.Reader(**kwargs)
         self._next_response = False
 
@@ -427,17 +411,10 @@ def read_from_socket(self, timeout=SENTINEL, raise_on_timeout=True):
         try:
             if custom_timeout:
                 sock.settimeout(timeout)
-            if HIREDIS_USE_BYTE_BUFFER:
-                bufflen = self._sock.recv_into(self._buffer)
-                if bufflen == 0:
-                    raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
-                self._reader.feed(self._buffer, 0, bufflen)
-            else:
-                buffer = self._sock.recv(self.socket_read_size)
-                # an empty string indicates the server shutdown the socket
-                if not isinstance(buffer, bytes) or len(buffer) == 0:
-                    raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
-                self._reader.feed(buffer)
+            bufflen = self._sock.recv_into(self._buffer)
+            if bufflen == 0:
+                raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
+            self._reader.feed(self._buffer, 0, bufflen)
             # data was read from the socket and added to the buffer.
             # return True to indicate that data was read.
             return True
@@ -479,17 +456,6 @@ def read_response(self, disable_decoding=False):
                 response = self._reader.gets(False)
             else:
                 response = self._reader.gets()
-        # if an older version of hiredis is installed, we need to attempt
-        # to convert ResponseErrors to their appropriate types.
-        if not HIREDIS_SUPPORTS_CALLABLE_ERRORS:
-            if isinstance(response, ResponseError):
-                response = self.parse_error(response.args[0])
-            elif (
-                isinstance(response, list)
-                and response
-                and isinstance(response[0], ResponseError)
-            ):
-                response[0] = self.parse_error(response[0].args[0])
         # if the response is a ConnectionError or the response is a list and
         # the first item is a ConnectionError, raise it as something bad
         # happened
diff --git a/redis/utils.py b/redis/utils.py
index 0c34e1eef8..25d2491dfe 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -4,7 +4,8 @@
 try:
     import hiredis  # noqa
 
-    HIREDIS_AVAILABLE = True
+    # Only support Hiredis >= 1.0:
+    HIREDIS_AVAILABLE = not hiredis.__version__.startswith("0.")
 except ImportError:
     HIREDIS_AVAILABLE = False
 
diff --git a/requirements.txt b/requirements.txt
index c40eca70e0..b764668e7a 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,4 +1,3 @@
 async-timeout>=4.0.2
 deprecated>=1.2.3
-packaging>=20.4
 typing-extensions; python_version<"3.8"
diff --git a/setup.py b/setup.py
index fb6d32a31d..e08251f1ac 100644
--- a/setup.py
+++ b/setup.py
@@ -33,7 +33,6 @@
     python_requires=">=3.7",
     install_requires=[
         "deprecated>=1.2.3",
-        "packaging>=20.4",
         'importlib-metadata >= 1.0; python_version < "3.8"',
         'typing-extensions; python_version<"3.8"',
         "async-timeout>=4.0.2",

From 7c6a8128660d713f11d34ed4b5652ccbd9548e52 Mon Sep 17 00:00:00 2001
From: Aarni Koskela <akx@iki.fi>
Date: Wed, 28 Sep 2022 14:13:49 +0300
Subject: [PATCH 0586/1164] Update GitHub Actions versions (#2389)

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 .github/workflows/codeql-analysis.yml |  8 ++++----
 .github/workflows/integration.yaml    | 20 ++++++++------------
 .github/workflows/pypi-publish.yaml   |  4 ++--
 3 files changed, 14 insertions(+), 18 deletions(-)

diff --git a/.github/workflows/codeql-analysis.yml b/.github/workflows/codeql-analysis.yml
index b92c52f88d..e82e7e1530 100644
--- a/.github/workflows/codeql-analysis.yml
+++ b/.github/workflows/codeql-analysis.yml
@@ -36,11 +36,11 @@ jobs:
 
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v2
+      uses: actions/checkout@v3
 
     # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL
-      uses: github/codeql-action/init@v1
+      uses: github/codeql-action/init@v2
       with:
         languages: ${{ matrix.language }}
         # If you wish to specify custom queries, you can do so here or in a config file.
@@ -51,7 +51,7 @@ jobs:
     # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
     # If this step fails, then you should remove it and run the build manually (see below)
     - name: Autobuild
-      uses: github/codeql-action/autobuild@v1
+      uses: github/codeql-action/autobuild@v2
 
     # ℹ️ Command-line programs to run using the OS shell.
     # 📚 https://git.io/JvXDl
@@ -65,4 +65,4 @@ jobs:
     #   make release
 
     - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@v1
+      uses: github/codeql-action/analyze@v2
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 1089b27608..00039300a2 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -31,9 +31,8 @@ jobs:
      name: Code linters
      runs-on: ubuntu-latest
      steps:
-       - uses: actions/checkout@v2
-       - name: install python
-         uses: actions/setup-python@v4
+       - uses: actions/checkout@v3
+       - uses: actions/setup-python@v4
          with:
            python-version: 3.9
            cache: 'pip'
@@ -55,9 +54,8 @@ jobs:
        ACTIONS_ALLOW_UNSECURE_COMMANDS: true
      name: Python ${{ matrix.python-version }} ${{matrix.test-type}}-${{matrix.connection-type}} tests
      steps:
-       - uses: actions/checkout@v2
-       - name: install python
-         uses: actions/setup-python@v4
+       - uses: actions/checkout@v3
+       - uses: actions/setup-python@v4
          with:
            python-version: ${{ matrix.python-version }}
            cache: 'pip'
@@ -93,9 +91,8 @@ jobs:
       matrix:
         extension: ['tar.gz', 'whl']
     steps:
-      - uses: actions/checkout@v2
-      - name: install python
-        uses: actions/setup-python@v3
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
         with:
           python-version: 3.9
       - name: Run installed unit tests
@@ -109,9 +106,8 @@ jobs:
       matrix:
         python-version: ['3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
     steps:
-      - uses: actions/checkout@v2
-      - name: install python ${{ matrix.python-version }}
-        uses: actions/setup-python@v3
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
         with:
           python-version: ${{ matrix.python-version }}
           cache: 'pip'
diff --git a/.github/workflows/pypi-publish.yaml b/.github/workflows/pypi-publish.yaml
index 0d100dd12d..3e7f80136c 100644
--- a/.github/workflows/pypi-publish.yaml
+++ b/.github/workflows/pypi-publish.yaml
@@ -9,9 +9,9 @@ jobs:
   build_and_package:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
       - name: install python
-        uses: actions/setup-python@v3
+        uses: actions/setup-python@v4
         with:
           python-version: 3.9
       - name: Install dev tools

From 6b3e0b491c4a348ca2e7a332e6f3b23a5da3c461 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Wed, 28 Sep 2022 13:21:19 +0000
Subject: [PATCH 0587/1164] Dev/no lock (#2308)

* Remove async lock in asyncio.Connection.read_response

* Skip concurrent-commands test on non-pooled connections
---
 redis/asyncio/cluster.py              |  8 ++---
 redis/asyncio/connection.py           | 35 -------------------
 tests/test_asyncio/test_cluster.py    | 48 ++++++++++++---------------
 tests/test_asyncio/test_connection.py |  4 +++
 4 files changed, 29 insertions(+), 66 deletions(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 78dcd05039..8d34b9ad21 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -390,7 +390,7 @@ async def on_connect(self, connection: Connection) -> None:
         # regardless of the server type. If this is a primary connection,
         # READONLY would not affect executing write commands.
         await connection.send_command("READONLY")
-        if str_if_bytes(await connection.read_response_without_lock()) != "OK":
+        if str_if_bytes(await connection.read_response()) != "OK":
             raise ConnectionError("READONLY command failed")
 
     def get_nodes(self) -> List["ClusterNode"]:
@@ -866,11 +866,9 @@ async def parse_response(
     ) -> Any:
         try:
             if NEVER_DECODE in kwargs:
-                response = await connection.read_response_without_lock(
-                    disable_decoding=True
-                )
+                response = await connection.read_response(disable_decoding=True)
             else:
-                response = await connection.read_response_without_lock()
+                response = await connection.read_response()
         except ResponseError:
             if EMPTY_RESPONSE in kwargs:
                 return kwargs[EMPTY_RESPONSE]
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index db8c2408e2..16f33e2a37 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -671,7 +671,6 @@ def __init__(
         self.set_parser(parser_class)
         self._connect_callbacks: List[weakref.WeakMethod[ConnectCallbackT]] = []
         self._buffer_cutoff = 6000
-        self._lock = asyncio.Lock()
 
     def __repr__(self):
         repr_args = ",".join((f"{k}={v}" for k, v in self.repr_pieces()))
@@ -940,39 +939,6 @@ async def can_read(self, timeout: float = 0):
             )
 
     async def read_response(self, disable_decoding: bool = False):
-        """Read the response from a previously sent command"""
-        try:
-            async with self._lock:
-                if self.socket_timeout:
-                    async with async_timeout.timeout(self.socket_timeout):
-                        response = await self._parser.read_response(
-                            disable_decoding=disable_decoding
-                        )
-                else:
-                    response = await self._parser.read_response(
-                        disable_decoding=disable_decoding
-                    )
-        except asyncio.TimeoutError:
-            await self.disconnect()
-            raise TimeoutError(f"Timeout reading from {self.host}:{self.port}")
-        except OSError as e:
-            await self.disconnect()
-            raise ConnectionError(
-                f"Error while reading from {self.host}:{self.port} : {e.args}"
-            )
-        except BaseException:
-            await self.disconnect()
-            raise
-
-        if self.health_check_interval:
-            next_time = asyncio.get_running_loop().time() + self.health_check_interval
-            self.next_health_check = next_time
-
-        if isinstance(response, ResponseError):
-            raise response from None
-        return response
-
-    async def read_response_without_lock(self, disable_decoding: bool = False):
         """Read the response from a previously sent command"""
         try:
             if self.socket_timeout:
@@ -1241,7 +1207,6 @@ def __init__(
         self.set_parser(parser_class)
         self._connect_callbacks = []
         self._buffer_cutoff = 6000
-        self._lock = asyncio.Lock()
 
     def repr_pieces(self) -> Iterable[Tuple[str, Union[str, int]]]:
         pieces = [("path", self.path), ("db", self.db)]
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index e299395554..88cfb1fcdf 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -120,7 +120,7 @@ def cmd_init_mock(self, r: ClusterNode) -> None:
 def mock_node_resp(node: ClusterNode, response: Any) -> ClusterNode:
     connection = mock.AsyncMock()
     connection.is_connected = True
-    connection.read_response_without_lock.return_value = response
+    connection.read_response.return_value = response
     while node._free:
         node._free.pop()
     node._free.append(connection)
@@ -130,7 +130,7 @@ def mock_node_resp(node: ClusterNode, response: Any) -> ClusterNode:
 def mock_node_resp_exc(node: ClusterNode, exc: Exception) -> ClusterNode:
     connection = mock.AsyncMock()
     connection.is_connected = True
-    connection.read_response_without_lock.side_effect = exc
+    connection.read_response.side_effect = exc
     while node._free:
         node._free.pop()
     node._free.append(connection)
@@ -275,16 +275,12 @@ async def test_max_connections(
         for node in rc.get_nodes():
             assert node.max_connections == 10
 
-        with mock.patch.object(
-            Connection, "read_response_without_lock"
-        ) as read_response_without_lock:
+        with mock.patch.object(Connection, "read_response") as read_response:
 
-            async def read_response_without_lock_mocked(
-                *args: Any, **kwargs: Any
-            ) -> None:
+            async def read_response_mocked(*args: Any, **kwargs: Any) -> None:
                 await asyncio.sleep(10)
 
-            read_response_without_lock.side_effect = read_response_without_lock_mocked
+            read_response.side_effect = read_response_mocked
 
             with pytest.raises(MaxConnectionsError):
                 await asyncio.gather(
@@ -316,10 +312,10 @@ async def test_execute_command_node_flag_primaries(self, r: RedisCluster) -> Non
         assert await r.ping(target_nodes=RedisCluster.PRIMARIES) is True
         for primary in primaries:
             conn = primary._free.pop()
-            assert conn.read_response_without_lock.called is True
+            assert conn.read_response.called is True
         for replica in replicas:
             conn = replica._free.pop()
-            assert conn.read_response_without_lock.called is not True
+            assert conn.read_response.called is not True
 
     async def test_execute_command_node_flag_replicas(self, r: RedisCluster) -> None:
         """
@@ -333,10 +329,10 @@ async def test_execute_command_node_flag_replicas(self, r: RedisCluster) -> None
         assert await r.ping(target_nodes=RedisCluster.REPLICAS) is True
         for replica in replicas:
             conn = replica._free.pop()
-            assert conn.read_response_without_lock.called is True
+            assert conn.read_response.called is True
         for primary in primaries:
             conn = primary._free.pop()
-            assert conn.read_response_without_lock.called is not True
+            assert conn.read_response.called is not True
 
         await r.close()
 
@@ -348,7 +344,7 @@ async def test_execute_command_node_flag_all_nodes(self, r: RedisCluster) -> Non
         assert await r.ping(target_nodes=RedisCluster.ALL_NODES) is True
         for node in r.get_nodes():
             conn = node._free.pop()
-            assert conn.read_response_without_lock.called is True
+            assert conn.read_response.called is True
 
     async def test_execute_command_node_flag_random(self, r: RedisCluster) -> None:
         """
@@ -359,7 +355,7 @@ async def test_execute_command_node_flag_random(self, r: RedisCluster) -> None:
         called_count = 0
         for node in r.get_nodes():
             conn = node._free.pop()
-            if conn.read_response_without_lock.called is True:
+            if conn.read_response.called is True:
                 called_count += 1
         assert called_count == 1
 
@@ -372,7 +368,7 @@ async def test_execute_command_default_node(self, r: RedisCluster) -> None:
         mock_node_resp(def_node, "PONG")
         assert await r.ping() is True
         conn = def_node._free.pop()
-        assert conn.read_response_without_lock.called
+        assert conn.read_response.called
 
     async def test_ask_redirection(self, r: RedisCluster) -> None:
         """
@@ -516,7 +512,7 @@ async def test_reading_from_replicas_in_round_robin(self) -> None:
         with mock.patch.multiple(
             Connection,
             send_command=mock.DEFAULT,
-            read_response_without_lock=mock.DEFAULT,
+            read_response=mock.DEFAULT,
             _connect=mock.DEFAULT,
             can_read=mock.DEFAULT,
             on_connect=mock.DEFAULT,
@@ -548,7 +544,7 @@ def execute_command_mock_third(self, *args, **options):
                 # so we'll mock some of the Connection's functions to allow it
                 execute_command.side_effect = execute_command_mock_first
                 mocks["send_command"].return_value = True
-                mocks["read_response_without_lock"].return_value = "OK"
+                mocks["read_response"].return_value = "OK"
                 mocks["_connect"].return_value = True
                 mocks["can_read"].return_value = False
                 mocks["on_connect"].return_value = True
@@ -857,8 +853,8 @@ async def test_cluster_delslots(self) -> None:
         node0 = r.get_node(default_host, 7000)
         node1 = r.get_node(default_host, 7001)
         assert await r.cluster_delslots(0, 8192) == [True, True]
-        assert node0._free.pop().read_response_without_lock.called
-        assert node1._free.pop().read_response_without_lock.called
+        assert node0._free.pop().read_response.called
+        assert node1._free.pop().read_response.called
 
         await r.close()
 
@@ -1027,7 +1023,7 @@ async def test_cluster_setslot_stable(self, r: RedisCluster) -> None:
         node = r.nodes_manager.get_node_from_slot(12182)
         mock_node_resp(node, "OK")
         assert await r.cluster_setslot_stable(12182) is True
-        assert node._free.pop().read_response_without_lock.called
+        assert node._free.pop().read_response.called
 
     @skip_if_redis_enterprise()
     async def test_cluster_replicas(self, r: RedisCluster) -> None:
@@ -1069,7 +1065,7 @@ async def test_readonly(self) -> None:
         for res in all_replicas_results.values():
             assert res is True
         for replica in r.get_replicas():
-            assert replica._free.pop().read_response_without_lock.called
+            assert replica._free.pop().read_response.called
 
         await r.close()
 
@@ -1082,7 +1078,7 @@ async def test_readwrite(self) -> None:
         for res in all_replicas_results.values():
             assert res is True
         for replica in r.get_replicas():
-            assert replica._free.pop().read_response_without_lock.called
+            assert replica._free.pop().read_response.called
 
         await r.close()
 
@@ -2441,8 +2437,8 @@ async def test_asking_error(self, r: RedisCluster) -> None:
             mock_node_resp_exc(first_node, AskError(ask_msg))
             mock_node_resp(ask_node, "MOCK_OK")
             res = await pipe.get(key).execute()
-            assert first_node._free.pop().read_response_without_lock.await_count
-            assert ask_node._free.pop().read_response_without_lock.await_count
+            assert first_node._free.pop().read_response.await_count
+            assert ask_node._free.pop().read_response.await_count
             assert res == ["MOCK_OK"]
 
     async def test_moved_redirection_on_slave_with_default(
@@ -2497,7 +2493,7 @@ async def test_readonly_pipeline_from_readonly_client(
             executed_on_replica = False
             for node in slot_nodes:
                 if node.server_type == REPLICA:
-                    if node._free.pop().read_response_without_lock.await_count:
+                    if node._free.pop().read_response.await_count:
                         executed_on_replica = True
                         break
             assert executed_on_replica
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index 419c8a7642..674a1b9980 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -64,6 +64,10 @@ async def test_socket_param_regression(r):
 
 
 async def test_can_run_concurrent_commands(r):
+    if getattr(r, "connection", None) is not None:
+        # Concurrent commands are only supported on pooled or cluster connections
+        # since there is no synchronization on a single connection.
+        pytest.skip("pool only")
     assert await r.ping() is True
     assert all(await asyncio.gather(*(r.ping() for _ in range(10))))
 

From 7ee76a8db657019f7c856bee927fd79d8debebc7 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 28 Sep 2022 23:21:58 +0300
Subject: [PATCH 0588/1164] vecsim docs fix (#2402)

---
 docs/examples/search_vector_similarity_examples.ipynb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/examples/search_vector_similarity_examples.ipynb b/docs/examples/search_vector_similarity_examples.ipynb
index 42c03f0c21..2b0261097c 100644
--- a/docs/examples/search_vector_similarity_examples.ipynb
+++ b/docs/examples/search_vector_similarity_examples.ipynb
@@ -74,7 +74,7 @@
     "r.hset(\"b\", \"v\", \"aaaabaaa\")\n",
     "r.hset(\"c\", \"v\", \"aaaaabaa\")\n",
     "\n",
-    "q = Query(\"*=>[KNN 2 @v $vec]\").return_field(\"__v_score\")\n",
+    "q = Query(\"*=>[KNN 2 @v $vec]\").return_field(\"__v_score\").dialect(2)\n",
     "r.ft().search(q, query_params={\"vec\": \"aaaaaaaa\"})"
    ]
   }

From fbf68dd217b4bf7d91a0e07ca73c8a39dfbc1066 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 29 Sep 2022 13:51:37 +0300
Subject: [PATCH 0589/1164] Fix - aggregation request arguments for LIMIT
 (#2393)

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/commands/search/aggregation.py | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/redis/commands/search/aggregation.py b/redis/commands/search/aggregation.py
index 061e69c235..a171fa13e8 100644
--- a/redis/commands/search/aggregation.py
+++ b/redis/commands/search/aggregation.py
@@ -104,7 +104,6 @@ def __init__(self, query="*"):
         self._aggregateplan = []
         self._loadfields = []
         self._loadall = False
-        self._limit = Limit()
         self._max = 0
         self._with_schema = False
         self._verbatim = False
@@ -211,7 +210,8 @@ def limit(self, offset, num):
         `sort_by()` instead.
 
         """
-        self._limit = Limit(offset, num)
+        _limit = Limit(offset, num)
+        self._aggregateplan.extend(_limit.build_args())
         return self
 
     def sort_by(self, *fields, **kwargs):
@@ -323,8 +323,6 @@ def build_args(self):
 
         ret.extend(self._aggregateplan)
 
-        ret += self._limit.build_args()
-
         return ret
 
 

From 9fe836698ca5930e39633b86839b6c1bae07237e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Thu, 29 Sep 2022 11:03:54 +0000
Subject: [PATCH 0590/1164] Catch `Exception` and not `BaseException` in the
 `Connection` (#2104)

* Add failing unittests for passing BaseException through

* Resolve failing unittest

* Remove redundant checks for asyncio.CancelledError
---
 redis/asyncio/connection.py       |  8 ++--
 redis/connection.py               |  4 +-
 tests/test_asyncio/test_pubsub.py | 74 +++++++++++++++++++++++++++++++
 tests/test_pubsub.py              | 42 ++++++++++++++++++
 4 files changed, 121 insertions(+), 7 deletions(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 16f33e2a37..a470b6f70f 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -502,8 +502,6 @@ async def read_from_socket(
             # data was read from the socket and added to the buffer.
             # return True to indicate that data was read.
             return True
-        except asyncio.CancelledError:
-            raise
         except (socket.timeout, asyncio.TimeoutError):
             if raise_on_timeout:
                 raise TimeoutError("Timeout reading from socket") from None
@@ -721,7 +719,7 @@ async def connect(self):
                 lambda: self._connect(), lambda error: self.disconnect()
             )
         except asyncio.CancelledError:
-            raise
+            raise  # in 3.7 and earlier, this is an Exception, not BaseException
         except (socket.timeout, asyncio.TimeoutError):
             raise TimeoutError("Timeout connecting to server")
         except OSError as e:
@@ -916,7 +914,7 @@ async def send_packed_command(
             raise ConnectionError(
                 f"Error {err_no} while writing to socket. {errmsg}."
             ) from e
-        except BaseException:
+        except Exception:
             await self.disconnect()
             raise
 
@@ -958,7 +956,7 @@ async def read_response(self, disable_decoding: bool = False):
             raise ConnectionError(
                 f"Error while reading from {self.host}:{self.port} : {e.args}"
             )
-        except BaseException:
+        except Exception:
             await self.disconnect()
             raise
 
diff --git a/redis/connection.py b/redis/connection.py
index 491df8e027..2e33e31d2f 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -766,7 +766,7 @@ def send_packed_command(self, command, check_health=True):
                 errno = e.args[0]
                 errmsg = e.args[1]
             raise ConnectionError(f"Error {errno} while writing to socket. {errmsg}.")
-        except BaseException:
+        except Exception:
             self.disconnect()
             raise
 
@@ -804,7 +804,7 @@ def read_response(self, disable_decoding=False):
         except OSError as e:
             self.disconnect()
             raise ConnectionError(f"Error while reading from {hosterr}" f" : {e.args}")
-        except BaseException:
+        except Exception:
             self.disconnect()
             raise
 
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index 2ff0c726c6..555cfdbc77 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -1,7 +1,9 @@
 import asyncio
 import functools
 import socket
+import sys
 from typing import Optional
+from unittest.mock import patch
 
 import async_timeout
 import pytest
@@ -914,3 +916,75 @@ async def loop_step_listen(self):
                     return True
         except asyncio.TimeoutError:
             return False
+
+
+@pytest.mark.onlynoncluster
+class TestBaseException:
+    @pytest.mark.skipif(
+        sys.version_info < (3, 8), reason="requires python 3.8 or higher"
+    )
+    async def test_outer_timeout(self, r: redis.Redis):
+        """
+        Using asyncio_timeout manually outside the inner method timeouts works.
+        This works on Python versions 3.8 and greater, at which time asyncio.
+        CancelledError became a BaseException instead of an Exception before.
+        """
+        pubsub = r.pubsub()
+        await pubsub.subscribe("foo")
+        assert pubsub.connection.is_connected
+
+        async def get_msg_or_timeout(timeout=0.1):
+            async with async_timeout.timeout(timeout):
+                # blocking method to return messages
+                while True:
+                    response = await pubsub.parse_response(block=True)
+                    message = await pubsub.handle_message(
+                        response, ignore_subscribe_messages=False
+                    )
+                    if message is not None:
+                        return message
+
+        # get subscribe message
+        msg = await get_msg_or_timeout(10)
+        assert msg is not None
+        # timeout waiting for another message which never arrives
+        assert pubsub.connection.is_connected
+        with pytest.raises(asyncio.TimeoutError):
+            await get_msg_or_timeout()
+        # the timeout on the read should not cause disconnect
+        assert pubsub.connection.is_connected
+
+    async def test_base_exception(self, r: redis.Redis):
+        """
+        Manually trigger a BaseException inside the parser's .read_response method
+        and verify that it isn't caught
+        """
+        pubsub = r.pubsub()
+        await pubsub.subscribe("foo")
+        assert pubsub.connection.is_connected
+
+        async def get_msg():
+            # blocking method to return messages
+            while True:
+                response = await pubsub.parse_response(block=True)
+                message = await pubsub.handle_message(
+                    response, ignore_subscribe_messages=False
+                )
+                if message is not None:
+                    return message
+
+        # get subscribe message
+        msg = await get_msg()
+        assert msg is not None
+        # timeout waiting for another message which never arrives
+        assert pubsub.connection.is_connected
+        with patch("redis.asyncio.connection.PythonParser.read_response") as mock1:
+            mock1.side_effect = BaseException("boom")
+            with patch("redis.asyncio.connection.HiredisParser.read_response") as mock2:
+                mock2.side_effect = BaseException("boom")
+
+                with pytest.raises(BaseException):
+                    await get_msg()
+
+        # the timeout on the read should not cause disconnect
+        assert pubsub.connection.is_connected
diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index 26df598bd8..5d86934de6 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -735,3 +735,45 @@ def loop_step_listen(self):
         for message in self.pubsub.listen():
             self.messages.put(message)
             return True
+
+
+@pytest.mark.onlynoncluster
+class TestBaseException:
+    def test_base_exception(self, r: redis.Redis):
+        """
+        Manually trigger a BaseException inside the parser's .read_response method
+        and verify that it isn't caught
+        """
+        pubsub = r.pubsub()
+        pubsub.subscribe("foo")
+
+        def is_connected():
+            return pubsub.connection._sock is not None
+
+        assert is_connected()
+
+        def get_msg():
+            # blocking method to return messages
+            while True:
+                response = pubsub.parse_response(block=True)
+                message = pubsub.handle_message(
+                    response, ignore_subscribe_messages=False
+                )
+                if message is not None:
+                    return message
+
+        # get subscribe message
+        msg = get_msg()
+        assert msg is not None
+        # timeout waiting for another message which never arrives
+        assert is_connected()
+        with patch("redis.connection.PythonParser.read_response") as mock1:
+            mock1.side_effect = BaseException("boom")
+            with patch("redis.connection.HiredisParser.read_response") as mock2:
+                mock2.side_effect = BaseException("boom")
+
+                with pytest.raises(BaseException):
+                    get_msg()
+
+        # the timeout on the read should not cause disconnect
+        assert is_connected()

From 652ca790b0bbaefa78278ddf57074316a3fb21bd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Thu, 29 Sep 2022 11:23:07 +0000
Subject: [PATCH 0591/1164] Add `nowait` flag to
 `asyncio.Connection.disconnect()` (#2356)

* Don't wait for disconnect() when handling errors.
This can result in other errors such as timeouts.

* add CHANGES

* Update redis/asyncio/connection.py

Co-authored-by: Aarni Koskela <akx@iki.fi>

* await a task to try to diagnose unittest failures in CI

Co-authored-by: Aarni Koskela <akx@iki.fi>
---
 CHANGES                           |  1 +
 redis/asyncio/connection.py       | 21 ++++-----
 tests/test_asyncio/test_pubsub.py | 73 ++++++++++++++++++-------------
 3 files changed, 55 insertions(+), 40 deletions(-)

diff --git a/CHANGES b/CHANGES
index 75fa83cbe2..a5b5029681 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * add `nowait` flag to `asyncio.Connection.disconnect()`
     * Update README.md links
     * Fix timezone handling for datetime to unixtime conversions
     * Fix start_id type for XAUTOCLAIM
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index a470b6f70f..64848f4f5f 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -836,7 +836,7 @@ async def on_connect(self) -> None:
             if str_if_bytes(await self.read_response()) != "OK":
                 raise ConnectionError("Invalid Database")
 
-    async def disconnect(self) -> None:
+    async def disconnect(self, nowait: bool = False) -> None:
         """Disconnects from the Redis server"""
         try:
             async with async_timeout.timeout(self.socket_connect_timeout):
@@ -846,8 +846,9 @@ async def disconnect(self) -> None:
                 try:
                     if os.getpid() == self.pid:
                         self._writer.close()  # type: ignore[union-attr]
-                        # py3.6 doesn't have this method
-                        if hasattr(self._writer, "wait_closed"):
+                        # wait for close to finish, except when handling errors and
+                        # forcefully disconnecting.
+                        if not nowait:
                             await self._writer.wait_closed()  # type: ignore[union-attr]
                 except OSError:
                     pass
@@ -902,10 +903,10 @@ async def send_packed_command(
                 self._writer.writelines(command)
                 await self._writer.drain()
         except asyncio.TimeoutError:
-            await self.disconnect()
+            await self.disconnect(nowait=True)
             raise TimeoutError("Timeout writing to socket") from None
         except OSError as e:
-            await self.disconnect()
+            await self.disconnect(nowait=True)
             if len(e.args) == 1:
                 err_no, errmsg = "UNKNOWN", e.args[0]
             else:
@@ -915,7 +916,7 @@ async def send_packed_command(
                 f"Error {err_no} while writing to socket. {errmsg}."
             ) from e
         except Exception:
-            await self.disconnect()
+            await self.disconnect(nowait=True)
             raise
 
     async def send_command(self, *args: Any, **kwargs: Any) -> None:
@@ -931,7 +932,7 @@ async def can_read(self, timeout: float = 0):
         try:
             return await self._parser.can_read(timeout)
         except OSError as e:
-            await self.disconnect()
+            await self.disconnect(nowait=True)
             raise ConnectionError(
                 f"Error while reading from {self.host}:{self.port}: {e.args}"
             )
@@ -949,15 +950,15 @@ async def read_response(self, disable_decoding: bool = False):
                     disable_decoding=disable_decoding
                 )
         except asyncio.TimeoutError:
-            await self.disconnect()
+            await self.disconnect(nowait=True)
             raise TimeoutError(f"Timeout reading from {self.host}:{self.port}")
         except OSError as e:
-            await self.disconnect()
+            await self.disconnect(nowait=True)
             raise ConnectionError(
                 f"Error while reading from {self.host}:{self.port} : {e.args}"
             )
         except Exception:
-            await self.disconnect()
+            await self.disconnect(nowait=True)
             raise
 
         if self.health_check_interval:
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index 555cfdbc77..32268fe5e3 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -819,7 +819,7 @@ async def mysetup(self, r, method):
             "type": "subscribe",
         }
 
-    async def mycleanup(self):
+    async def myfinish(self):
         message = await self.messages.get()
         assert message == {
             "channel": b"foo",
@@ -827,6 +827,8 @@ async def mycleanup(self):
             "pattern": None,
             "type": "subscribe",
         }
+
+    async def mykill(self):
         # kill thread
         async with self.cond:
             self.state = 4  # quit
@@ -836,41 +838,52 @@ async def test_reconnect_socket_error(self, r: redis.Redis, method):
         """
         Test that a socket error will cause reconnect
         """
-        async with async_timeout.timeout(self.timeout):
-            await self.mysetup(r, method)
-            # now, disconnect the connection, and wait for it to be re-established
-            async with self.cond:
-                assert self.state == 0
-                self.state = 1
-                with mock.patch.object(self.pubsub.connection, "_parser") as mockobj:
-                    mockobj.read_response.side_effect = socket.error
-                    mockobj.can_read.side_effect = socket.error
-                    # wait until task noticies the disconnect until we undo the patch
-                    await self.cond.wait_for(lambda: self.state >= 2)
-                    assert not self.pubsub.connection.is_connected
-                    # it is in a disconnecte state
-                # wait for reconnect
-                await self.cond.wait_for(lambda: self.pubsub.connection.is_connected)
-                assert self.state == 3
+        try:
+            async with async_timeout.timeout(self.timeout):
+                await self.mysetup(r, method)
+                # now, disconnect the connection, and wait for it to be re-established
+                async with self.cond:
+                    assert self.state == 0
+                    self.state = 1
+                    with mock.patch.object(self.pubsub.connection, "_parser") as m:
+                        m.read_response.side_effect = socket.error
+                        m.can_read.side_effect = socket.error
+                        # wait until task noticies the disconnect until we
+                        # undo the patch
+                        await self.cond.wait_for(lambda: self.state >= 2)
+                        assert not self.pubsub.connection.is_connected
+                        # it is in a disconnecte state
+                    # wait for reconnect
+                    await self.cond.wait_for(
+                        lambda: self.pubsub.connection.is_connected
+                    )
+                    assert self.state == 3
 
-            await self.mycleanup()
+                await self.myfinish()
+        finally:
+            await self.mykill()
 
     async def test_reconnect_disconnect(self, r: redis.Redis, method):
         """
         Test that a manual disconnect() will cause reconnect
         """
-        async with async_timeout.timeout(self.timeout):
-            await self.mysetup(r, method)
-            # now, disconnect the connection, and wait for it to be re-established
-            async with self.cond:
-                self.state = 1
-                await self.pubsub.connection.disconnect()
-                assert not self.pubsub.connection.is_connected
-                # wait for reconnect
-                await self.cond.wait_for(lambda: self.pubsub.connection.is_connected)
-                assert self.state == 3
-
-            await self.mycleanup()
+        try:
+            async with async_timeout.timeout(self.timeout):
+                await self.mysetup(r, method)
+                # now, disconnect the connection, and wait for it to be re-established
+                async with self.cond:
+                    self.state = 1
+                    await self.pubsub.connection.disconnect()
+                    assert not self.pubsub.connection.is_connected
+                    # wait for reconnect
+                    await self.cond.wait_for(
+                        lambda: self.pubsub.connection.is_connected
+                    )
+                    assert self.state == 3
+
+                await self.myfinish()
+        finally:
+            await self.mykill()
 
     async def loop(self):
         # reader loop, performing state transitions as it

From f014dc3a5d76935914c6e2975e66da44f2e6263b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Thu, 29 Sep 2022 11:56:50 +0000
Subject: [PATCH 0592/1164] Dev/no can read (#2360)

* make can_read() destructive for simplicity, and rename the method.
Remove timeout argument, always timeout immediately.

* don't use can_read in pubsub

* connection.connect() now has its own retry, don't need it inside a retry loop
---
 redis/asyncio/client.py                    | 22 +++++++---
 redis/asyncio/connection.py                | 51 +++++++++-------------
 tests/test_asyncio/test_cluster.py         |  8 ++--
 tests/test_asyncio/test_connection_pool.py |  2 +-
 tests/test_asyncio/test_pubsub.py          |  2 +-
 5 files changed, 41 insertions(+), 44 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 9c8caae0f9..c13054b227 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -24,6 +24,8 @@
     cast,
 )
 
+import async_timeout
+
 from redis.asyncio.connection import (
     Connection,
     ConnectionPool,
@@ -754,15 +756,21 @@ async def parse_response(self, block: bool = True, timeout: float = 0):
 
         await self.check_health()
 
-        async def try_read():
-            if not block:
-                if not await conn.can_read(timeout=timeout):
+        if not conn.is_connected:
+            await conn.connect()
+
+        if not block:
+
+            async def read_with_timeout():
+                try:
+                    async with async_timeout.timeout(timeout):
+                        return await conn.read_response()
+                except asyncio.TimeoutError:
                     return None
-            else:
-                await conn.connect()
-            return await conn.read_response()
 
-        response = await self._execute(conn, try_read)
+            response = await self._execute(conn, read_with_timeout)
+        else:
+            response = await self._execute(conn, conn.read_response)
 
         if conn.health_check_interval and response == self.health_check_response:
             # ignore the health check message as user might not expect it
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 64848f4f5f..53b41af7f8 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -208,7 +208,7 @@ def on_disconnect(self):
     def on_connect(self, connection: "Connection"):
         raise NotImplementedError()
 
-    async def can_read(self, timeout: float) -> bool:
+    async def can_read_destructive(self) -> bool:
         raise NotImplementedError()
 
     async def read_response(
@@ -286,9 +286,9 @@ async def _read_from_socket(
                 return False
             raise ConnectionError(f"Error while reading from socket: {ex.args}")
 
-    async def can_read(self, timeout: float) -> bool:
+    async def can_read_destructive(self) -> bool:
         return bool(self.length) or await self._read_from_socket(
-            timeout=timeout, raise_on_timeout=False
+            timeout=0, raise_on_timeout=False
         )
 
     async def read(self, length: int) -> bytes:
@@ -386,8 +386,8 @@ def on_disconnect(self):
             self._buffer = None
         self.encoder = None
 
-    async def can_read(self, timeout: float):
-        return self._buffer and bool(await self._buffer.can_read(timeout))
+    async def can_read_destructive(self):
+        return self._buffer and bool(await self._buffer.can_read_destructive())
 
     async def read_response(
         self, disable_decoding: bool = False
@@ -444,9 +444,7 @@ async def read_response(
 class HiredisParser(BaseParser):
     """Parser class for connections using Hiredis"""
 
-    __slots__ = BaseParser.__slots__ + ("_next_response", "_reader", "_socket_timeout")
-
-    _next_response: bool
+    __slots__ = BaseParser.__slots__ + ("_reader", "_socket_timeout")
 
     def __init__(self, socket_read_size: int):
         if not HIREDIS_AVAILABLE:
@@ -466,23 +464,18 @@ def on_connect(self, connection: "Connection"):
             kwargs["errors"] = connection.encoder.encoding_errors
 
         self._reader = hiredis.Reader(**kwargs)
-        self._next_response = False
         self._socket_timeout = connection.socket_timeout
 
     def on_disconnect(self):
         self._stream = None
         self._reader = None
-        self._next_response = False
 
-    async def can_read(self, timeout: float):
+    async def can_read_destructive(self):
         if not self._stream or not self._reader:
             raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
-
-        if self._next_response is False:
-            self._next_response = self._reader.gets()
-        if self._next_response is False:
-            return await self.read_from_socket(timeout=timeout, raise_on_timeout=False)
-        return True
+        if self._reader.gets():
+            return True
+        return await self.read_from_socket(timeout=0, raise_on_timeout=False)
 
     async def read_from_socket(
         self,
@@ -523,12 +516,6 @@ async def read_response(
             self.on_disconnect()
             raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR) from None
 
-        # _next_response might be cached from a can_read() call
-        if self._next_response is not False:
-            response = self._next_response
-            self._next_response = False
-            return response
-
         response = self._reader.gets()
         while response is False:
             await self.read_from_socket()
@@ -925,12 +912,10 @@ async def send_command(self, *args: Any, **kwargs: Any) -> None:
             self.pack_command(*args), check_health=kwargs.get("check_health", True)
         )
 
-    async def can_read(self, timeout: float = 0):
+    async def can_read_destructive(self):
         """Poll the socket to see if there's data that can be read."""
-        if not self.is_connected:
-            await self.connect()
         try:
-            return await self._parser.can_read(timeout)
+            return await self._parser.can_read_destructive()
         except OSError as e:
             await self.disconnect(nowait=True)
             raise ConnectionError(
@@ -957,6 +942,10 @@ async def read_response(self, disable_decoding: bool = False):
             raise ConnectionError(
                 f"Error while reading from {self.host}:{self.port} : {e.args}"
             )
+        except asyncio.CancelledError:
+            # need this check for 3.7, where CancelledError
+            # is subclass of Exception, not BaseException
+            raise
         except Exception:
             await self.disconnect(nowait=True)
             raise
@@ -1498,12 +1487,12 @@ async def get_connection(self, command_name, *keys, **options):
             # pool before all data has been read or the socket has been
             # closed. either way, reconnect and verify everything is good.
             try:
-                if await connection.can_read():
+                if await connection.can_read_destructive():
                     raise ConnectionError("Connection has data") from None
             except ConnectionError:
                 await connection.disconnect()
                 await connection.connect()
-                if await connection.can_read():
+                if await connection.can_read_destructive():
                     raise ConnectionError("Connection not ready") from None
         except BaseException:
             # release the connection back to the pool so that we don't
@@ -1699,12 +1688,12 @@ async def get_connection(self, command_name, *keys, **options):
             # pool before all data has been read or the socket has been
             # closed. either way, reconnect and verify everything is good.
             try:
-                if await connection.can_read():
+                if await connection.can_read_destructive():
                     raise ConnectionError("Connection has data") from None
             except ConnectionError:
                 await connection.disconnect()
                 await connection.connect()
-                if await connection.can_read():
+                if await connection.can_read_destructive():
                     raise ConnectionError("Connection not ready") from None
         except BaseException:
             # release the connection back to the pool so that we don't leak it
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 88cfb1fcdf..f1bbe42267 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -433,7 +433,7 @@ async def test_refresh_using_specific_nodes(
                     Connection,
                     send_packed_command=mock.DEFAULT,
                     connect=mock.DEFAULT,
-                    can_read=mock.DEFAULT,
+                    can_read_destructive=mock.DEFAULT,
                 ) as mocks:
                     # simulate 7006 as a failed node
                     def execute_command_mock(self, *args, **options):
@@ -473,7 +473,7 @@ def map_7007(self):
                     execute_command.successful_calls = 0
                     execute_command.failed_calls = 0
                     initialize.side_effect = initialize_mock
-                    mocks["can_read"].return_value = False
+                    mocks["can_read_destructive"].return_value = False
                     mocks["send_packed_command"].return_value = "MOCK_OK"
                     mocks["connect"].return_value = None
                     with mock.patch.object(
@@ -514,7 +514,7 @@ async def test_reading_from_replicas_in_round_robin(self) -> None:
             send_command=mock.DEFAULT,
             read_response=mock.DEFAULT,
             _connect=mock.DEFAULT,
-            can_read=mock.DEFAULT,
+            can_read_destructive=mock.DEFAULT,
             on_connect=mock.DEFAULT,
         ) as mocks:
             with mock.patch.object(
@@ -546,7 +546,7 @@ def execute_command_mock_third(self, *args, **options):
                 mocks["send_command"].return_value = True
                 mocks["read_response"].return_value = "OK"
                 mocks["_connect"].return_value = True
-                mocks["can_read"].return_value = False
+                mocks["can_read_destructive"].return_value = False
                 mocks["on_connect"].return_value = True
 
                 # Create a cluster with reading from replications
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
index d281608e51..35f23f44cc 100644
--- a/tests/test_asyncio/test_connection_pool.py
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -103,7 +103,7 @@ async def connect(self):
     async def disconnect(self):
         pass
 
-    async def can_read(self, timeout: float = 0):
+    async def can_read_destructive(self, timeout: float = 0):
         return False
 
 
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index 32268fe5e3..86584e4715 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -847,7 +847,7 @@ async def test_reconnect_socket_error(self, r: redis.Redis, method):
                     self.state = 1
                     with mock.patch.object(self.pubsub.connection, "_parser") as m:
                         m.read_response.side_effect = socket.error
-                        m.can_read.side_effect = socket.error
+                        m.can_read_destructive.side_effect = socket.error
                         # wait until task noticies the disconnect until we
                         # undo the patch
                         await self.cond.wait_for(lambda: self.state >= 2)

From cdbc662adcd303d2525f3ace70531aa37a755652 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 29 Sep 2022 15:44:18 +0300
Subject: [PATCH 0593/1164] 4.4.0rc2 (#2403)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index e08251f1ac..db2db93b79 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.4.0rc1",
+    version="4.4.0rc2",
     packages=find_packages(
         include=[
             "redis",

From b0883b791f95a595fae70bcedf3ad0f73c00e258 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Thu, 29 Sep 2022 13:37:55 +0000
Subject: [PATCH 0594/1164] Simplify async timeouts and  allowing
 `timeout=None` in `PubSub.get_message()` to wait forever (#2295)

* Avoid an extra "can_read" call and use timeout directly.

* Remove low-level read timeouts from the Parser, now handled in the Connection

* Allow pubsub.get_message(time=None) to block.

* update Changes

* increase test timeout for robustness

* expand with statement to avoid invoking null context managers.

remove nullcontext

* Remove unused import
---
 CHANGES                           |   1 +
 redis/asyncio/client.py           |  22 ++---
 redis/asyncio/connection.py       | 138 ++++++++++--------------------
 redis/client.py                   |   6 +-
 tests/test_asyncio/test_pubsub.py |   2 +-
 5 files changed, 57 insertions(+), 112 deletions(-)

diff --git a/CHANGES b/CHANGES
index a5b5029681..2ced3d8f96 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Allow `timeout=None` in `PubSub.get_message()` to wait forever
     * add `nowait` flag to `asyncio.Connection.disconnect()`
     * Update README.md links
     * Fix timezone handling for datetime to unixtime conversions
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index c13054b227..0e40ed70f8 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -24,8 +24,6 @@
     cast,
 )
 
-import async_timeout
-
 from redis.asyncio.connection import (
     Connection,
     ConnectionPool,
@@ -759,18 +757,8 @@ async def parse_response(self, block: bool = True, timeout: float = 0):
         if not conn.is_connected:
             await conn.connect()
 
-        if not block:
-
-            async def read_with_timeout():
-                try:
-                    async with async_timeout.timeout(timeout):
-                        return await conn.read_response()
-                except asyncio.TimeoutError:
-                    return None
-
-            response = await self._execute(conn, read_with_timeout)
-        else:
-            response = await self._execute(conn, conn.read_response)
+        read_timeout = None if block else timeout
+        response = await self._execute(conn, conn.read_response, timeout=read_timeout)
 
         if conn.health_check_interval and response == self.health_check_response:
             # ignore the health check message as user might not expect it
@@ -882,16 +870,16 @@ async def listen(self) -> AsyncIterator:
                 yield response
 
     async def get_message(
-        self, ignore_subscribe_messages: bool = False, timeout: float = 0.0
+        self, ignore_subscribe_messages: bool = False, timeout: Optional[float] = 0.0
     ):
         """
         Get the next message if one is available, otherwise None.
 
         If timeout is specified, the system will wait for `timeout` seconds
         before returning. Timeout should be specified as a floating point
-        number.
+        number or None to wait indefinitely.
         """
-        response = await self.parse_response(block=False, timeout=timeout)
+        response = await self.parse_response(block=(timeout is None), timeout=timeout)
         if response:
             return await self.handle_message(response, ignore_subscribe_messages)
         return None
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 53b41af7f8..c8834c9286 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -1,7 +1,6 @@
 import asyncio
 import copy
 import enum
-import errno
 import inspect
 import io
 import os
@@ -55,16 +54,6 @@
 if HIREDIS_AVAILABLE:
     import hiredis
 
-NONBLOCKING_EXCEPTION_ERROR_NUMBERS = {
-    BlockingIOError: errno.EWOULDBLOCK,
-    ssl.SSLWantReadError: 2,
-    ssl.SSLWantWriteError: 2,
-    ssl.SSLError: 2,
-}
-
-NONBLOCKING_EXCEPTIONS = tuple(NONBLOCKING_EXCEPTION_ERROR_NUMBERS.keys())
-
-
 SYM_STAR = b"*"
 SYM_DOLLAR = b"$"
 SYM_CRLF = b"\r\n"
@@ -229,11 +218,9 @@ def __init__(
         self,
         stream_reader: asyncio.StreamReader,
         socket_read_size: int,
-        socket_timeout: Optional[float],
     ):
         self._stream: Optional[asyncio.StreamReader] = stream_reader
         self.socket_read_size = socket_read_size
-        self.socket_timeout = socket_timeout
         self._buffer: Optional[io.BytesIO] = io.BytesIO()
         # number of bytes written to the buffer from the socket
         self.bytes_written = 0
@@ -244,52 +231,35 @@ def __init__(
     def length(self):
         return self.bytes_written - self.bytes_read
 
-    async def _read_from_socket(
-        self,
-        length: Optional[int] = None,
-        timeout: Union[float, None, _Sentinel] = SENTINEL,
-        raise_on_timeout: bool = True,
-    ) -> bool:
+    async def _read_from_socket(self, length: Optional[int] = None) -> bool:
         buf = self._buffer
         if buf is None or self._stream is None:
             raise RedisError("Buffer is closed.")
         buf.seek(self.bytes_written)
         marker = 0
-        timeout = timeout if timeout is not SENTINEL else self.socket_timeout
 
-        try:
-            while True:
-                async with async_timeout.timeout(timeout):
-                    data = await self._stream.read(self.socket_read_size)
-                # an empty string indicates the server shutdown the socket
-                if isinstance(data, bytes) and len(data) == 0:
-                    raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
-                buf.write(data)
-                data_length = len(data)
-                self.bytes_written += data_length
-                marker += data_length
-
-                if length is not None and length > marker:
-                    continue
-                return True
-        except (socket.timeout, asyncio.TimeoutError):
-            if raise_on_timeout:
-                raise TimeoutError("Timeout reading from socket")
-            return False
-        except NONBLOCKING_EXCEPTIONS as ex:
-            # if we're in nonblocking mode and the recv raises a
-            # blocking error, simply return False indicating that
-            # there's no data to be read. otherwise raise the
-            # original exception.
-            allowed = NONBLOCKING_EXCEPTION_ERROR_NUMBERS.get(ex.__class__, -1)
-            if not raise_on_timeout and ex.errno == allowed:
-                return False
-            raise ConnectionError(f"Error while reading from socket: {ex.args}")
+        while True:
+            data = await self._stream.read(self.socket_read_size)
+            # an empty string indicates the server shutdown the socket
+            if isinstance(data, bytes) and len(data) == 0:
+                raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
+            buf.write(data)
+            data_length = len(data)
+            self.bytes_written += data_length
+            marker += data_length
+
+            if length is not None and length > marker:
+                continue
+            return True
 
     async def can_read_destructive(self) -> bool:
-        return bool(self.length) or await self._read_from_socket(
-            timeout=0, raise_on_timeout=False
-        )
+        if self.length:
+            return True
+        try:
+            async with async_timeout.timeout(0):
+                return await self._read_from_socket()
+        except asyncio.TimeoutError:
+            return False
 
     async def read(self, length: int) -> bytes:
         length = length + 2  # make sure to read the \r\n terminator
@@ -372,9 +342,7 @@ def on_connect(self, connection: "Connection"):
         if self._stream is None:
             raise RedisError("Buffer is closed.")
 
-        self._buffer = SocketBuffer(
-            self._stream, self._read_size, connection.socket_timeout
-        )
+        self._buffer = SocketBuffer(self._stream, self._read_size)
         self.encoder = connection.encoder
 
     def on_disconnect(self):
@@ -444,14 +412,13 @@ async def read_response(
 class HiredisParser(BaseParser):
     """Parser class for connections using Hiredis"""
 
-    __slots__ = BaseParser.__slots__ + ("_reader", "_socket_timeout")
+    __slots__ = BaseParser.__slots__ + ("_reader",)
 
     def __init__(self, socket_read_size: int):
         if not HIREDIS_AVAILABLE:
             raise RedisError("Hiredis is not available.")
         super().__init__(socket_read_size=socket_read_size)
         self._reader: Optional[hiredis.Reader] = None
-        self._socket_timeout: Optional[float] = None
 
     def on_connect(self, connection: "Connection"):
         self._stream = connection._reader
@@ -464,7 +431,6 @@ def on_connect(self, connection: "Connection"):
             kwargs["errors"] = connection.encoder.encoding_errors
 
         self._reader = hiredis.Reader(**kwargs)
-        self._socket_timeout = connection.socket_timeout
 
     def on_disconnect(self):
         self._stream = None
@@ -475,39 +441,20 @@ async def can_read_destructive(self):
             raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
         if self._reader.gets():
             return True
-        return await self.read_from_socket(timeout=0, raise_on_timeout=False)
-
-    async def read_from_socket(
-        self,
-        timeout: Union[float, None, _Sentinel] = SENTINEL,
-        raise_on_timeout: bool = True,
-    ):
-        timeout = self._socket_timeout if timeout is SENTINEL else timeout
         try:
-            if timeout is None:
-                buffer = await self._stream.read(self._read_size)
-            else:
-                async with async_timeout.timeout(timeout):
-                    buffer = await self._stream.read(self._read_size)
-            if not buffer or not isinstance(buffer, bytes):
-                raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR) from None
-            self._reader.feed(buffer)
-            # data was read from the socket and added to the buffer.
-            # return True to indicate that data was read.
-            return True
-        except (socket.timeout, asyncio.TimeoutError):
-            if raise_on_timeout:
-                raise TimeoutError("Timeout reading from socket") from None
+            async with async_timeout.timeout(0):
+                return await self.read_from_socket()
+        except asyncio.TimeoutError:
             return False
-        except NONBLOCKING_EXCEPTIONS as ex:
-            # if we're in nonblocking mode and the recv raises a
-            # blocking error, simply return False indicating that
-            # there's no data to be read. otherwise raise the
-            # original exception.
-            allowed = NONBLOCKING_EXCEPTION_ERROR_NUMBERS.get(ex.__class__, -1)
-            if not raise_on_timeout and ex.errno == allowed:
-                return False
-            raise ConnectionError(f"Error while reading from socket: {ex.args}")
+
+    async def read_from_socket(self):
+        buffer = await self._stream.read(self._read_size)
+        if not buffer or not isinstance(buffer, bytes):
+            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR) from None
+        self._reader.feed(buffer)
+        # data was read from the socket and added to the buffer.
+        # return True to indicate that data was read.
+        return True
 
     async def read_response(
         self, disable_decoding: bool = False
@@ -922,11 +869,16 @@ async def can_read_destructive(self):
                 f"Error while reading from {self.host}:{self.port}: {e.args}"
             )
 
-    async def read_response(self, disable_decoding: bool = False):
+    async def read_response(
+        self,
+        disable_decoding: bool = False,
+        timeout: Optional[float] = None,
+    ):
         """Read the response from a previously sent command"""
+        read_timeout = timeout if timeout is not None else self.socket_timeout
         try:
-            if self.socket_timeout:
-                async with async_timeout.timeout(self.socket_timeout):
+            if read_timeout is not None:
+                async with async_timeout.timeout(read_timeout):
                     response = await self._parser.read_response(
                         disable_decoding=disable_decoding
                     )
@@ -935,6 +887,10 @@ async def read_response(self, disable_decoding: bool = False):
                     disable_decoding=disable_decoding
                 )
         except asyncio.TimeoutError:
+            if timeout is not None:
+                # user requested timeout, return None
+                return None
+            # it was a self.socket_timeout error.
             await self.disconnect(nowait=True)
             raise TimeoutError(f"Timeout reading from {self.host}:{self.port}")
         except OSError as e:
diff --git a/redis/client.py b/redis/client.py
index 0662a99ea1..75a0dac226 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1637,13 +1637,13 @@ def listen(self):
             if response is not None:
                 yield response
 
-    def get_message(self, ignore_subscribe_messages=False, timeout=0):
+    def get_message(self, ignore_subscribe_messages=False, timeout=0.0):
         """
         Get the next message if one is available, otherwise None.
 
         If timeout is specified, the system will wait for `timeout` seconds
         before returning. Timeout should be specified as a floating point
-        number.
+        number, or None, to wait indefinitely.
         """
         if not self.subscribed:
             # Wait for subscription
@@ -1659,7 +1659,7 @@ def get_message(self, ignore_subscribe_messages=False, timeout=0):
                 # so no messages are available
                 return None
 
-        response = self.parse_response(block=False, timeout=timeout)
+        response = self.parse_response(block=(timeout is None), timeout=timeout)
         if response:
             return self.handle_message(response, ignore_subscribe_messages)
         return None
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index 86584e4715..6dedca9ab5 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -29,7 +29,7 @@ async def run(*args, **kwargs):
     return wrapper
 
 
-async def wait_for_message(pubsub, timeout=0.1, ignore_subscribe_messages=False):
+async def wait_for_message(pubsub, timeout=0.2, ignore_subscribe_messages=False):
     now = asyncio.get_event_loop().time()
     timeout = now + timeout
     while now < timeout:

From 936d49f4c1dd6cf0c2e3ad80de29f25eef81d8a9 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 6 Oct 2022 12:12:13 +0300
Subject: [PATCH 0595/1164] remove tdigest.add weights (#2408)

---
 redis/commands/bf/commands.py    | 14 ++++--------
 redis/commands/bf/info.py        |  2 --
 tests/test_asyncio/test_bloom.py | 36 +++++++++++++++---------------
 tests/test_bloom.py              | 38 +++++++++++++++-----------------
 4 files changed, 40 insertions(+), 50 deletions(-)

diff --git a/redis/commands/bf/commands.py b/redis/commands/bf/commands.py
index 71c9c8a593..60409fd232 100644
--- a/redis/commands/bf/commands.py
+++ b/redis/commands/bf/commands.py
@@ -370,19 +370,13 @@ def reset(self, key):
         """  # noqa
         return self.execute_command(TDIGEST_RESET, key)
 
-    def add(self, key, values, weights):
+    def add(self, key, values):
         """
-        Add one or more samples (value with weight) to a sketch `key`.
-        Both `values` and `weights` are lists.
-        For more information see `TDIGEST.ADD <https://redis.io/commands/tdigest.add>`_.
-
-        Example:
+        Adds one or more observations to a t-digest sketch `key`.
 
-        >>> tdigestadd('A', [1500.0], [1.0])
+        For more information see `TDIGEST.ADD <https://redis.io/commands/tdigest.add>`_.
         """  # noqa
-        params = [key]
-        self.append_values_and_weights(params, values, weights)
-        return self.execute_command(TDIGEST_ADD, *params)
+        return self.execute_command(TDIGEST_ADD, key, *values)
 
     def merge(self, destination_key, num_keys, *keys, compression=None, override=False):
         """
diff --git a/redis/commands/bf/info.py b/redis/commands/bf/info.py
index c4d3e5814b..c526e6ca4c 100644
--- a/redis/commands/bf/info.py
+++ b/redis/commands/bf/info.py
@@ -73,7 +73,6 @@ class TDigestInfo(object):
     merged_weight = None
     unmerged_weight = None
     total_compressions = None
-    sum_weights = None
     memory_usage = None
 
     def __init__(self, args):
@@ -85,5 +84,4 @@ def __init__(self, args):
         self.merged_weight = response["Merged weight"]
         self.unmerged_weight = response["Unmerged weight"]
         self.total_compressions = response["Total compressions"]
-        self.sum_weights = response["Sum weights"]
         self.memory_usage = response["Memory usage"]
diff --git a/tests/test_asyncio/test_bloom.py b/tests/test_asyncio/test_bloom.py
index 326924c9c5..fd9e94903b 100644
--- a/tests/test_asyncio/test_bloom.py
+++ b/tests/test_asyncio/test_bloom.py
@@ -324,7 +324,7 @@ async def test_tdigest_reset(modclient: redis.Redis):
     # reset on empty histogram
     assert await modclient.tdigest().reset("tDigest")
     # insert data-points into sketch
-    assert await modclient.tdigest().add("tDigest", list(range(10)), [1] * 10)
+    assert await modclient.tdigest().add("tDigest", list(range(10)))
 
     assert await modclient.tdigest().reset("tDigest")
     # assert we have 0 unmerged nodes
@@ -337,19 +337,19 @@ async def test_tdigest_merge(modclient: redis.Redis):
     assert await modclient.tdigest().create("to-tDigest", 10)
     assert await modclient.tdigest().create("from-tDigest", 10)
     # insert data-points into sketch
-    assert await modclient.tdigest().add("from-tDigest", [1.0] * 10, [1] * 10)
-    assert await modclient.tdigest().add("to-tDigest", [2.0] * 10, [10] * 10)
+    assert await modclient.tdigest().add("from-tDigest", [1.0] * 10)
+    assert await modclient.tdigest().add("to-tDigest", [2.0] * 10)
     # merge from-tdigest into to-tdigest
     assert await modclient.tdigest().merge("to-tDigest", 1, "from-tDigest")
     # we should now have 110 weight on to-histogram
     info = await modclient.tdigest().info("to-tDigest")
     total_weight_to = float(info.merged_weight) + float(info.unmerged_weight)
-    assert 110 == total_weight_to
+    assert 20.0 == total_weight_to
     # test override
     assert await modclient.tdigest().create("from-override", 10)
     assert await modclient.tdigest().create("from-override-2", 10)
-    assert await modclient.tdigest().add("from-override", [3.0] * 10, [10] * 10)
-    assert await modclient.tdigest().add("from-override-2", [4.0] * 10, [10] * 10)
+    assert await modclient.tdigest().add("from-override", [3.0] * 10)
+    assert await modclient.tdigest().add("from-override-2", [4.0] * 10)
     assert await modclient.tdigest().merge(
         "to-tDigest", 2, "from-override", "from-override-2", override=True
     )
@@ -362,7 +362,7 @@ async def test_tdigest_merge(modclient: redis.Redis):
 async def test_tdigest_min_and_max(modclient: redis.Redis):
     assert await modclient.tdigest().create("tDigest", 100)
     # insert data-points into sketch
-    assert await modclient.tdigest().add("tDigest", [1, 2, 3], [1] * 3)
+    assert await modclient.tdigest().add("tDigest", [1, 2, 3])
     # min/max
     assert 3 == await modclient.tdigest().max("tDigest")
     assert 1 == await modclient.tdigest().min("tDigest")
@@ -375,7 +375,7 @@ async def test_tdigest_quantile(modclient: redis.Redis):
     assert await modclient.tdigest().create("tDigest", 500)
     # insert data-points into sketch
     assert await modclient.tdigest().add(
-        "tDigest", list([x * 0.01 for x in range(1, 10000)]), [1] * 10000
+        "tDigest", list([x * 0.01 for x in range(1, 10000)])
     )
     # assert min min/max have same result as quantile 0 and 1
     assert (
@@ -392,7 +392,7 @@ async def test_tdigest_quantile(modclient: redis.Redis):
 
     # test multiple quantiles
     assert await modclient.tdigest().create("t-digest", 100)
-    assert await modclient.tdigest().add("t-digest", [1, 2, 3, 4, 5], [1] * 5)
+    assert await modclient.tdigest().add("t-digest", [1, 2, 3, 4, 5])
     res = await modclient.tdigest().quantile("t-digest", 0.5, 0.8)
     assert [3.0, 5.0] == res
 
@@ -402,7 +402,7 @@ async def test_tdigest_quantile(modclient: redis.Redis):
 async def test_tdigest_cdf(modclient: redis.Redis):
     assert await modclient.tdigest().create("tDigest", 100)
     # insert data-points into sketch
-    assert await modclient.tdigest().add("tDigest", list(range(1, 10)), [1] * 10)
+    assert await modclient.tdigest().add("tDigest", list(range(1, 10)))
     assert 0.1 == round((await modclient.tdigest().cdf("tDigest", 1.0))[0], 1)
     assert 0.9 == round((await modclient.tdigest().cdf("tDigest", 9.0))[0], 1)
     res = await modclient.tdigest().cdf("tDigest", 1.0, 9.0)
@@ -415,7 +415,7 @@ async def test_tdigest_cdf(modclient: redis.Redis):
 async def test_tdigest_trimmed_mean(modclient: redis.Redis):
     assert await modclient.tdigest().create("tDigest", 100)
     # insert data-points into sketch
-    assert await modclient.tdigest().add("tDigest", list(range(1, 10)), [1] * 10)
+    assert await modclient.tdigest().add("tDigest", list(range(1, 10)))
     assert 5 == await modclient.tdigest().trimmed_mean("tDigest", 0.1, 0.9)
     assert 4.5 == await modclient.tdigest().trimmed_mean("tDigest", 0.4, 0.5)
 
@@ -424,7 +424,7 @@ async def test_tdigest_trimmed_mean(modclient: redis.Redis):
 @pytest.mark.experimental
 async def test_tdigest_rank(modclient: redis.Redis):
     assert await modclient.tdigest().create("t-digest", 500)
-    assert await modclient.tdigest().add("t-digest", list(range(0, 20)), [1] * 20)
+    assert await modclient.tdigest().add("t-digest", list(range(0, 20)))
     assert -1 == (await modclient.tdigest().rank("t-digest", -1))[0]
     assert 1 == (await modclient.tdigest().rank("t-digest", 0))[0]
     assert 11 == (await modclient.tdigest().rank("t-digest", 10))[0]
@@ -435,17 +435,17 @@ async def test_tdigest_rank(modclient: redis.Redis):
 @pytest.mark.experimental
 async def test_tdigest_revrank(modclient: redis.Redis):
     assert await modclient.tdigest().create("t-digest", 500)
-    assert await modclient.tdigest().add("t-digest", list(range(0, 20)), [1] * 20)
+    assert await modclient.tdigest().add("t-digest", list(range(0, 20)))
     assert -1 == (await modclient.tdigest().revrank("t-digest", 20))[0]
-    assert 20 == (await modclient.tdigest().revrank("t-digest", 0))[0]
-    assert [-1, 20, 10] == await modclient.tdigest().revrank("t-digest", 21, 0, 10)
+    assert 19 == (await modclient.tdigest().revrank("t-digest", 0))[0]
+    assert [-1, 19, 9] == await modclient.tdigest().revrank("t-digest", 21, 0, 10)
 
 
 @pytest.mark.redismod
 @pytest.mark.experimental
 async def test_tdigest_byrank(modclient: redis.Redis):
     assert await modclient.tdigest().create("t-digest", 500)
-    assert await modclient.tdigest().add("t-digest", list(range(1, 11)), [1] * 20)
+    assert await modclient.tdigest().add("t-digest", list(range(1, 11)))
     assert 1 == (await modclient.tdigest().byrank("t-digest", 0))[0]
     assert 10 == (await modclient.tdigest().byrank("t-digest", 9))[0]
     assert (await modclient.tdigest().byrank("t-digest", 100))[0] == inf
@@ -457,9 +457,9 @@ async def test_tdigest_byrank(modclient: redis.Redis):
 @pytest.mark.experimental
 async def test_tdigest_byrevrank(modclient: redis.Redis):
     assert await modclient.tdigest().create("t-digest", 500)
-    assert await modclient.tdigest().add("t-digest", list(range(1, 11)), [1] * 20)
+    assert await modclient.tdigest().add("t-digest", list(range(1, 11)))
     assert 10 == (await modclient.tdigest().byrevrank("t-digest", 0))[0]
-    assert 2 == (await modclient.tdigest().byrevrank("t-digest", 9))[0]
+    assert 1 == (await modclient.tdigest().byrevrank("t-digest", 9))[0]
     assert (await modclient.tdigest().byrevrank("t-digest", 100))[0] == -inf
     with pytest.raises(redis.ResponseError):
         (await modclient.tdigest().byrevrank("t-digest", -1))[0]
diff --git a/tests/test_bloom.py b/tests/test_bloom.py
index 1194140241..45b898efbf 100644
--- a/tests/test_bloom.py
+++ b/tests/test_bloom.py
@@ -339,7 +339,7 @@ def test_tdigest_reset(client):
     # reset on empty histogram
     assert client.tdigest().reset("tDigest")
     # insert data-points into sketch
-    assert client.tdigest().add("tDigest", list(range(10)), [1] * 10)
+    assert client.tdigest().add("tDigest", list(range(10)))
 
     assert client.tdigest().reset("tDigest")
     # assert we have 0 unmerged nodes
@@ -352,19 +352,19 @@ def test_tdigest_merge(client):
     assert client.tdigest().create("to-tDigest", 10)
     assert client.tdigest().create("from-tDigest", 10)
     # insert data-points into sketch
-    assert client.tdigest().add("from-tDigest", [1.0] * 10, [1] * 10)
-    assert client.tdigest().add("to-tDigest", [2.0] * 10, [10] * 10)
+    assert client.tdigest().add("from-tDigest", [1.0] * 10)
+    assert client.tdigest().add("to-tDigest", [2.0] * 10)
     # merge from-tdigest into to-tdigest
     assert client.tdigest().merge("to-tDigest", 1, "from-tDigest")
     # we should now have 110 weight on to-histogram
     info = client.tdigest().info("to-tDigest")
     total_weight_to = float(info.merged_weight) + float(info.unmerged_weight)
-    assert 110 == total_weight_to
+    assert 20 == total_weight_to
     # test override
     assert client.tdigest().create("from-override", 10)
     assert client.tdigest().create("from-override-2", 10)
-    assert client.tdigest().add("from-override", [3.0] * 10, [10] * 10)
-    assert client.tdigest().add("from-override-2", [4.0] * 10, [10] * 10)
+    assert client.tdigest().add("from-override", [3.0] * 10)
+    assert client.tdigest().add("from-override-2", [4.0] * 10)
     assert client.tdigest().merge(
         "to-tDigest", 2, "from-override", "from-override-2", override=True
     )
@@ -377,7 +377,7 @@ def test_tdigest_merge(client):
 def test_tdigest_min_and_max(client):
     assert client.tdigest().create("tDigest", 100)
     # insert data-points into sketch
-    assert client.tdigest().add("tDigest", [1, 2, 3], [1] * 3)
+    assert client.tdigest().add("tDigest", [1, 2, 3])
     # min/max
     assert 3 == client.tdigest().max("tDigest")
     assert 1 == client.tdigest().min("tDigest")
@@ -389,9 +389,7 @@ def test_tdigest_min_and_max(client):
 def test_tdigest_quantile(client):
     assert client.tdigest().create("tDigest", 500)
     # insert data-points into sketch
-    assert client.tdigest().add(
-        "tDigest", list([x * 0.01 for x in range(1, 10000)]), [1] * 10000
-    )
+    assert client.tdigest().add("tDigest", list([x * 0.01 for x in range(1, 10000)]))
     # assert min min/max have same result as quantile 0 and 1
     res = client.tdigest().quantile("tDigest", 1.0)
     assert client.tdigest().max("tDigest") == res[0]
@@ -403,7 +401,7 @@ def test_tdigest_quantile(client):
 
     # test multiple quantiles
     assert client.tdigest().create("t-digest", 100)
-    assert client.tdigest().add("t-digest", [1, 2, 3, 4, 5], [1] * 5)
+    assert client.tdigest().add("t-digest", [1, 2, 3, 4, 5])
     assert [3.0, 5.0] == client.tdigest().quantile("t-digest", 0.5, 0.8)
 
 
@@ -412,7 +410,7 @@ def test_tdigest_quantile(client):
 def test_tdigest_cdf(client):
     assert client.tdigest().create("tDigest", 100)
     # insert data-points into sketch
-    assert client.tdigest().add("tDigest", list(range(1, 10)), [1] * 10)
+    assert client.tdigest().add("tDigest", list(range(1, 10)))
     assert 0.1 == round(client.tdigest().cdf("tDigest", 1.0)[0], 1)
     assert 0.9 == round(client.tdigest().cdf("tDigest", 9.0)[0], 1)
     res = client.tdigest().cdf("tDigest", 1.0, 9.0)
@@ -425,7 +423,7 @@ def test_tdigest_cdf(client):
 def test_tdigest_trimmed_mean(client):
     assert client.tdigest().create("tDigest", 100)
     # insert data-points into sketch
-    assert client.tdigest().add("tDigest", list(range(1, 10)), [1] * 10)
+    assert client.tdigest().add("tDigest", list(range(1, 10)))
     assert 5 == client.tdigest().trimmed_mean("tDigest", 0.1, 0.9)
     assert 4.5 == client.tdigest().trimmed_mean("tDigest", 0.4, 0.5)
 
@@ -434,7 +432,7 @@ def test_tdigest_trimmed_mean(client):
 @pytest.mark.experimental
 def test_tdigest_rank(client):
     assert client.tdigest().create("t-digest", 500)
-    assert client.tdigest().add("t-digest", list(range(0, 20)), [1] * 20)
+    assert client.tdigest().add("t-digest", list(range(0, 20)))
     assert -1 == client.tdigest().rank("t-digest", -1)[0]
     assert 1 == client.tdigest().rank("t-digest", 0)[0]
     assert 11 == client.tdigest().rank("t-digest", 10)[0]
@@ -445,17 +443,17 @@ def test_tdigest_rank(client):
 @pytest.mark.experimental
 def test_tdigest_revrank(client):
     assert client.tdigest().create("t-digest", 500)
-    assert client.tdigest().add("t-digest", list(range(0, 20)), [1] * 20)
+    assert client.tdigest().add("t-digest", list(range(0, 20)))
     assert -1 == client.tdigest().revrank("t-digest", 20)[0]
-    assert 20 == client.tdigest().revrank("t-digest", 0)[0]
-    assert [-1, 20, 10] == client.tdigest().revrank("t-digest", 21, 0, 10)
+    assert 19 == client.tdigest().revrank("t-digest", 0)[0]
+    assert [-1, 19, 9] == client.tdigest().revrank("t-digest", 21, 0, 10)
 
 
 @pytest.mark.redismod
 @pytest.mark.experimental
 def test_tdigest_byrank(client):
     assert client.tdigest().create("t-digest", 500)
-    assert client.tdigest().add("t-digest", list(range(1, 11)), [1] * 20)
+    assert client.tdigest().add("t-digest", list(range(1, 11)))
     assert 1 == client.tdigest().byrank("t-digest", 0)[0]
     assert 10 == client.tdigest().byrank("t-digest", 9)[0]
     assert client.tdigest().byrank("t-digest", 100)[0] == inf
@@ -467,9 +465,9 @@ def test_tdigest_byrank(client):
 @pytest.mark.experimental
 def test_tdigest_byrevrank(client):
     assert client.tdigest().create("t-digest", 500)
-    assert client.tdigest().add("t-digest", list(range(1, 11)), [1] * 20)
+    assert client.tdigest().add("t-digest", list(range(1, 11)))
     assert 10 == client.tdigest().byrevrank("t-digest", 0)[0]
-    assert 2 == client.tdigest().byrevrank("t-digest", 9)[0]
+    assert 1 == client.tdigest().byrevrank("t-digest", 9)[0]
     assert client.tdigest().byrevrank("t-digest", 100)[0] == -inf
     with pytest.raises(redis.ResponseError):
         client.tdigest().byrevrank("t-digest", -1)[0]

From 12f95deb0f01ce5710b249f2f04798eb302baac2 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 18 Oct 2022 13:30:26 +0300
Subject: [PATCH 0596/1164] Update dockers tags (#2409)

---
 tox.ini | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/tox.ini b/tox.ini
index 6afafc2962..595fc80008 100644
--- a/tox.ini
+++ b/tox.ini
@@ -18,7 +18,7 @@ envlist = {standalone,cluster}-{plain,hiredis,ocsp}-{uvloop,asyncio}-{py37,py38,
 
 [docker:master]
 name = master
-image = redisfab/redis-py:6.2.6-buster
+image = redisfab/redis-py:6.2.6
 ports =
     6379:6379/tcp
 healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',6379)) else False"
@@ -27,7 +27,7 @@ volumes =
 
 [docker:replica]
 name = replica
-image = redisfab/redis-py:6.2.6-buster
+image = redisfab/redis-py:6.2.6
 links =
     master:master
 ports =
@@ -38,7 +38,7 @@ volumes =
 
 [docker:unstable]
 name = unstable
-image = redisfab/redis-py:unstable-bionic
+image = redisfab/redis-py:unstable
 ports =
     6378:6378/tcp
 healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',6378)) else False"
@@ -47,7 +47,7 @@ volumes =
 
 [docker:unstable_cluster]
 name = unstable_cluster
-image = redisfab/redis-py-cluster:unstable-bionic
+image = redisfab/redis-py-cluster:unstable
 ports =
     6372:6372/tcp
     6373:6373/tcp
@@ -61,7 +61,7 @@ volumes =
 
 [docker:sentinel_1]
 name = sentinel_1
-image = redisfab/redis-py-sentinel:6.2.6-buster
+image = redisfab/redis-py-sentinel:6.2.6
 links =
     master:master
 ports =
@@ -72,7 +72,7 @@ volumes =
 
 [docker:sentinel_2]
 name = sentinel_2
-image = redisfab/redis-py-sentinel:6.2.6-buster
+image = redisfab/redis-py-sentinel:6.2.6
 links =
     master:master
 ports =
@@ -83,7 +83,7 @@ volumes =
 
 [docker:sentinel_3]
 name = sentinel_3
-image = redisfab/redis-py-sentinel:6.2.6-buster
+image = redisfab/redis-py-sentinel:6.2.6
 links =
     master:master
 ports =
@@ -101,7 +101,7 @@ healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(sock
 
 [docker:redis_cluster]
 name = redis_cluster
-image = redisfab/redis-py-cluster:6.2.6-buster
+image = redisfab/redis-py-cluster:6.2.6
 ports =
     16379:16379/tcp
     16380:16380/tcp

From e867f9eec740fde0b749b1ca35b8b9772c5ada92 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 23 Oct 2022 12:56:01 +0300
Subject: [PATCH 0597/1164] Fixing invalid vulnerability report (#2424)

* Fixing vuln report

* Fixed comment
---
 .github/workflows/integration.yaml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 00039300a2..26e4c06040 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -26,6 +26,8 @@ jobs:
        - uses: pypa/gh-action-pip-audit@v1.0.0
          with:
            inputs: requirements.txt dev_requirements.txt
+           ignore-vulns: |
+             GHSA-w596-4wvx-j9j6  # subversion related git pull, dependency for pytest. There is no impact here.
 
    lint:
      name: Code linters

From aa0ae6897828009342338e435773a5d0b90a21ea Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 23 Oct 2022 16:53:57 +0300
Subject: [PATCH 0598/1164] Fix `TIMESERIES` (round floats) and `JSON` tests 
 (#2421)

* Fix timeseries tests (round floats)

* fix json tests
---
 tests/test_asyncio/test_json.py       |  2 +-
 tests/test_asyncio/test_timeseries.py |  2 +-
 tests/test_json.py                    |  2 +-
 tests/test_search.py                  | 11 ++---------
 tests/test_timeseries.py              |  4 ++--
 5 files changed, 7 insertions(+), 14 deletions(-)

diff --git a/tests/test_asyncio/test_json.py b/tests/test_asyncio/test_json.py
index 416a9f4a21..b8854d20cd 100644
--- a/tests/test_asyncio/test_json.py
+++ b/tests/test_asyncio/test_json.py
@@ -817,7 +817,7 @@ async def test_objlen_dollar(modclient: redis.Redis):
         },
     )
     # Test multi
-    assert await modclient.json().objlen("doc1", "$..a") == [2, None, 1]
+    assert await modclient.json().objlen("doc1", "$..a") == [None, 2, 1]
     # Test single
     assert await modclient.json().objlen("doc1", "$.nested1.a") == [2]
 
diff --git a/tests/test_asyncio/test_timeseries.py b/tests/test_asyncio/test_timeseries.py
index ef582269c1..a7109938f2 100644
--- a/tests/test_asyncio/test_timeseries.py
+++ b/tests/test_asyncio/test_timeseries.py
@@ -240,7 +240,7 @@ async def test_range_advanced(modclient: redis.Redis):
     assert [(0, 5.0), (5, 6.0)] == await modclient.ts().range(
         1, 0, 10, aggregation_type="count", bucket_size_msec=10, align=5
     )
-    assert [(0, 2.5500000000000003), (10, 3.0)] == await modclient.ts().range(
+    assert [(0, 2.55), (10, 3.0)] == await modclient.ts().range(
         1, 0, 10, aggregation_type="twa", bucket_size_msec=10
     )
 
diff --git a/tests/test_json.py b/tests/test_json.py
index 0965a93d88..676683d9f7 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -824,7 +824,7 @@ def test_objlen_dollar(client):
         },
     )
     # Test multi
-    assert client.json().objlen("doc1", "$..a") == [2, None, 1]
+    assert client.json().objlen("doc1", "$..a") == [None, 2, 1]
     # Test single
     assert client.json().objlen("doc1", "$.nested1.a") == [2]
 
diff --git a/tests/test_search.py b/tests/test_search.py
index 5fe5ab17fc..abaa90817c 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1448,9 +1448,9 @@ def test_json_with_jsonpath(client):
     assert res.docs[0].id == "doc:1"
     assert res.docs[0].json == '{"prod:name":"RediSearch"}'
 
-    # query for an unsupported field fails
+    # query for an unsupported field
     res = client.ft().search("@name_unsupported:RediSearch")
-    assert res.total == 0
+    assert res.total == 1
 
     # return of a supported field succeeds
     res = client.ft().search(Query("@name:RediSearch").return_field("name"))
@@ -1458,13 +1458,6 @@ def test_json_with_jsonpath(client):
     assert res.docs[0].id == "doc:1"
     assert res.docs[0].name == "RediSearch"
 
-    # return of an unsupported field fails
-    res = client.ft().search(Query("@name:RediSearch").return_field("name_unsupported"))
-    assert res.total == 1
-    assert res.docs[0].id == "doc:1"
-    with pytest.raises(Exception):
-        res.docs[0].name_unsupported
-
 
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
diff --git a/tests/test_timeseries.py b/tests/test_timeseries.py
index cb27a7523f..6ced5359f7 100644
--- a/tests/test_timeseries.py
+++ b/tests/test_timeseries.py
@@ -233,7 +233,7 @@ def test_range_advanced(client):
     assert [(0, 5.0), (5, 6.0)] == client.ts().range(
         1, 0, 10, aggregation_type="count", bucket_size_msec=10, align=5
     )
-    assert [(0, 2.5500000000000003), (10, 3.0)] == client.ts().range(
+    assert [(0, 2.55), (10, 3.0)] == client.ts().range(
         1, 0, 10, aggregation_type="twa", bucket_size_msec=10
     )
 
@@ -343,7 +343,7 @@ def test_rev_range(client):
     assert [(1, 10.0), (0, 1.0)] == client.ts().revrange(
         1, 0, 10, aggregation_type="count", bucket_size_msec=10, align=1
     )
-    assert [(10, 3.0), (0, 2.5500000000000003)] == client.ts().revrange(
+    assert [(10, 3.0), (0, 2.55)] == client.ts().revrange(
         1, 0, 10, aggregation_type="twa", bucket_size_msec=10
     )
 

From 19a32a90f706cf055c0062e36cadce999f3c2f8e Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Mon, 24 Oct 2022 14:07:31 +0300
Subject: [PATCH 0599/1164] Updating release drafter title hashes (#2422)

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 .github/release-drafter-config.yml | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/.github/release-drafter-config.yml b/.github/release-drafter-config.yml
index de4fea741a..9ccb28aca4 100644
--- a/.github/release-drafter-config.yml
+++ b/.github/release-drafter-config.yml
@@ -1,5 +1,5 @@
-name-template: '$NEXT_MAJOR_VERSION'
-tag-template: 'v$NEXT_MAJOR_VERSION'
+name-template: '$NEXT_MINOR_VERSION'
+tag-template: 'v$NEXT_MINOR_VERSION'
 autolabeler:
   - label: 'maintenance'
     files:
@@ -18,7 +18,6 @@ categories:
   - title: 'Breaking Changes'
     labels:
       - 'breakingchange'
-
   - title: '🧪 Experimental Features'
     labels:
       - 'experimental'
@@ -38,7 +37,7 @@ change-template: '- $TITLE (#$NUMBER)'
 exclude-labels:
   - 'skip-changelog'
 template: |
-  ## Changes
+  # Changes
 
   $CHANGES
 

From d95e004328666948753985620f636dc33ee21022 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Mon, 24 Oct 2022 14:57:48 +0300
Subject: [PATCH 0600/1164] Updating the docker image for the module cluster
 (#2426)

---
 tox.ini | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tox.ini b/tox.ini
index 595fc80008..85b3242857 100644
--- a/tox.ini
+++ b/tox.ini
@@ -115,7 +115,7 @@ volumes =
 
 [docker:redismod_cluster]
 name = redismod_cluster
-image = redisfab/redis-py-modcluster:6.2.6
+image = redisfab/redis-py-modcluster:edge
 ports =
     46379:46379/tcp
     46380:46380/tcp

From 9a460c8e4f5e22f3ba92bf77b016aaad0b5621fb Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 24 Oct 2022 17:44:13 +0300
Subject: [PATCH 0601/1164] Deprecate `add_doccument` (FT.ADD) (#2425)

* deprecate add_doccuments

* linters

* linters

* async tests
---
 redis/commands/search/commands.py |   8 +
 tests/test_asyncio/test_search.py | 241 ++++++++----------------
 tests/test_search.py              | 298 +++++++++---------------------
 3 files changed, 178 insertions(+), 369 deletions(-)

diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index ba9d9bc1b7..ceca20f51d 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -2,6 +2,8 @@
 import time
 from typing import Dict, Optional, Union
 
+from deprecated import deprecated
+
 from redis.client import Pipeline
 
 from ..helpers import parse_to_dict
@@ -236,6 +238,9 @@ def _add_document_hash(
 
         return self.execute_command(*args)
 
+    @deprecated(
+        version="2.0.0", reason="deprecated since redisearch 2.0, call hset instead"
+    )
     def add_document(
         self,
         doc_id,
@@ -289,6 +294,9 @@ def add_document(
             **fields,
         )
 
+    @deprecated(
+        version="2.0.0", reason="deprecated since redisearch 2.0, call hset instead"
+    )
     def add_document_hash(self, doc_id, score=1.0, language=None, replace=False):
         """
         Add a hash document to the index.
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 862c21b1c3..88c80d301b 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -85,7 +85,7 @@ async def createIndex(modclient, num_docs=100, definition=None):
     assert 50 == indexer.chunk_size
 
     for key, doc in chapters.items():
-        await indexer.add_document(key, **doc)
+        await indexer.client.client.hset(key, mapping=doc)
     await indexer.commit()
 
 
@@ -189,7 +189,7 @@ async def test_client(modclient: redis.Redis):
     assert 167 == (await modclient.ft().search(Query("henry king").slop(100))).total
 
     # test delete document
-    await modclient.ft().add_document("doc-5ghs2", play="Death of a Salesman")
+    await modclient.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
     res = await modclient.ft().search(Query("death of a salesman"))
     assert 1 == res.total
 
@@ -198,36 +198,19 @@ async def test_client(modclient: redis.Redis):
     assert 0 == res.total
     assert 0 == await modclient.ft().delete_document("doc-5ghs2")
 
-    await modclient.ft().add_document("doc-5ghs2", play="Death of a Salesman")
+    await modclient.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
     res = await modclient.ft().search(Query("death of a salesman"))
     assert 1 == res.total
     await modclient.ft().delete_document("doc-5ghs2")
 
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.2.0", "search")
-async def test_payloads(modclient: redis.Redis):
-    await modclient.ft().create_index((TextField("txt"),))
-
-    await modclient.ft().add_document("doc1", payload="foo baz", txt="foo bar")
-    await modclient.ft().add_document("doc2", txt="foo bar")
-
-    q = Query("foo bar").with_payloads()
-    res = await modclient.ft().search(q)
-    assert 2 == res.total
-    assert "doc1" == res.docs[0].id
-    assert "doc2" == res.docs[1].id
-    assert "foo baz" == res.docs[0].payload
-    assert res.docs[1].payload is None
-
-
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
 async def test_scores(modclient: redis.Redis):
     await modclient.ft().create_index((TextField("txt"),))
 
-    await modclient.ft().add_document("doc1", txt="foo baz")
-    await modclient.ft().add_document("doc2", txt="foo bar")
+    await modclient.hset("doc1", mapping={"txt": "foo baz"})
+    await modclient.hset("doc2", mapping={"txt": "foo bar"})
 
     q = Query("foo ~bar").with_scores()
     res = await modclient.ft().search(q)
@@ -239,35 +222,12 @@ async def test_scores(modclient: redis.Redis):
     # self.assertEqual(0.2, res.docs[1].score)
 
 
-@pytest.mark.redismod
-async def test_replace(modclient: redis.Redis):
-    await modclient.ft().create_index((TextField("txt"),))
-
-    await modclient.ft().add_document("doc1", txt="foo bar")
-    await modclient.ft().add_document("doc2", txt="foo bar")
-    await waitForIndex(modclient, "idx")
-
-    res = await modclient.ft().search("foo bar")
-    assert 2 == res.total
-    await (
-        modclient.ft().add_document("doc1", replace=True, txt="this is a replaced doc")
-    )
-
-    res = await modclient.ft().search("foo bar")
-    assert 1 == res.total
-    assert "doc2" == res.docs[0].id
-
-    res = await modclient.ft().search("replaced doc")
-    assert 1 == res.total
-    assert "doc1" == res.docs[0].id
-
-
 @pytest.mark.redismod
 async def test_stopwords(modclient: redis.Redis):
     stopwords = ["foo", "bar", "baz"]
     await modclient.ft().create_index((TextField("txt"),), stopwords=stopwords)
-    await modclient.ft().add_document("doc1", txt="foo bar")
-    await modclient.ft().add_document("doc2", txt="hello world")
+    await modclient.hset("doc1", mapping={"txt": "foo bar"})
+    await modclient.hset("doc2", mapping={"txt": "hello world"})
     await waitForIndex(modclient, "idx")
 
     q1 = Query("foo bar").no_content()
@@ -285,11 +245,13 @@ async def test_filters(modclient: redis.Redis):
         )
     )
     await (
-        modclient.ft().add_document(
-            "doc1", txt="foo bar", num=3.141, loc="-0.441,51.458"
+        modclient.hset(
+            "doc1", mapping={"txt": "foo bar", "num": 3.141, "loc": "-0.441,51.458"}
         )
     )
-    await modclient.ft().add_document("doc2", txt="foo baz", num=2, loc="-0.1,51.2")
+    await (
+        modclient.hset("doc2", mapping={"txt": "foo baz", "num": 2, "loc": "-0.1,51.2"})
+    )
 
     await waitForIndex(modclient, "idx")
     # Test numerical filter
@@ -321,17 +283,6 @@ async def test_filters(modclient: redis.Redis):
     assert ["doc1", "doc2"] == res
 
 
-@pytest.mark.redismod
-async def test_payloads_with_no_content(modclient: redis.Redis):
-    await modclient.ft().create_index((TextField("txt"),))
-    await modclient.ft().add_document("doc1", payload="foo baz", txt="foo bar")
-    await modclient.ft().add_document("doc2", payload="foo baz2", txt="foo bar")
-
-    q = Query("foo bar").with_payloads().no_content()
-    res = await modclient.ft().search(q)
-    assert 2 == len(res.docs)
-
-
 @pytest.mark.redismod
 async def test_sort_by(modclient: redis.Redis):
     await (
@@ -339,9 +290,9 @@ async def test_sort_by(modclient: redis.Redis):
             (TextField("txt"), NumericField("num", sortable=True))
         )
     )
-    await modclient.ft().add_document("doc1", txt="foo bar", num=1)
-    await modclient.ft().add_document("doc2", txt="foo baz", num=2)
-    await modclient.ft().add_document("doc3", txt="foo qux", num=3)
+    await modclient.hset("doc1", mapping={"txt": "foo bar", "num": 1})
+    await modclient.hset("doc2", mapping={"txt": "foo baz", "num": 2})
+    await modclient.hset("doc3", mapping={"txt": "foo qux", "num": 3})
 
     # Test sort
     q1 = Query("foo").sort_by("num", asc=True).no_content()
@@ -385,10 +336,12 @@ async def test_example(modclient: redis.Redis):
     )
 
     # Indexing a document
-    await modclient.ft().add_document(
+    await modclient.hset(
         "doc1",
-        title="RediSearch",
-        body="Redisearch impements a search engine on top of redis",
+        mapping={
+            "title": "RediSearch",
+            "body": "Redisearch impements a search engine on top of redis",
+        },
     )
 
     # Searching with complex parameters:
@@ -461,11 +414,13 @@ async def test_no_index(modclient: redis.Redis):
         )
     )
 
-    await modclient.ft().add_document(
-        "doc1", field="aaa", text="1", numeric="1", geo="1,1", tag="1"
+    await modclient.hset(
+        "doc1",
+        mapping={"field": "aaa", "text": "1", "numeric": "1", "geo": "1,1", "tag": "1"},
     )
-    await modclient.ft().add_document(
-        "doc2", field="aab", text="2", numeric="2", geo="2,2", tag="2"
+    await modclient.hset(
+        "doc2",
+        mapping={"field": "aab", "text": "2", "numeric": "2", "geo": "2,2", "tag": "2"},
     )
     await waitForIndex(modclient, "idx")
 
@@ -502,53 +457,6 @@ async def test_no_index(modclient: redis.Redis):
         TagField("name", no_index=True, sortable=False)
 
 
-@pytest.mark.redismod
-async def test_partial(modclient: redis.Redis):
-    await (
-        modclient.ft().create_index((TextField("f1"), TextField("f2"), TextField("f3")))
-    )
-    await modclient.ft().add_document("doc1", f1="f1_val", f2="f2_val")
-    await modclient.ft().add_document("doc2", f1="f1_val", f2="f2_val")
-    await modclient.ft().add_document("doc1", f3="f3_val", partial=True)
-    await modclient.ft().add_document("doc2", f3="f3_val", replace=True)
-    await waitForIndex(modclient, "idx")
-
-    # Search for f3 value. All documents should have it
-    res = await modclient.ft().search("@f3:f3_val")
-    assert 2 == res.total
-
-    # Only the document updated with PARTIAL should still have f1 and f2 values
-    res = await modclient.ft().search("@f3:f3_val @f2:f2_val @f1:f1_val")
-    assert 1 == res.total
-
-
-@pytest.mark.redismod
-async def test_no_create(modclient: redis.Redis):
-    await (
-        modclient.ft().create_index((TextField("f1"), TextField("f2"), TextField("f3")))
-    )
-    await modclient.ft().add_document("doc1", f1="f1_val", f2="f2_val")
-    await modclient.ft().add_document("doc2", f1="f1_val", f2="f2_val")
-    await modclient.ft().add_document("doc1", f3="f3_val", no_create=True)
-    await modclient.ft().add_document("doc2", f3="f3_val", no_create=True, partial=True)
-    await waitForIndex(modclient, "idx")
-
-    # Search for f3 value. All documents should have it
-    res = await modclient.ft().search("@f3:f3_val")
-    assert 2 == res.total
-
-    # Only the document updated with PARTIAL should still have f1 and f2 values
-    res = await modclient.ft().search("@f3:f3_val @f2:f2_val @f1:f1_val")
-    assert 1 == res.total
-
-    with pytest.raises(redis.ResponseError):
-        await (
-            modclient.ft().add_document(
-                "doc3", f2="f2_val", f3="f3_val", no_create=True
-            )
-        )
-
-
 @pytest.mark.redismod
 async def test_explain(modclient: redis.Redis):
     await (
@@ -640,11 +548,11 @@ async def test_alias_basic(modclient: redis.Redis):
     index1 = getClient(modclient).ft("testAlias")
 
     await index1.create_index((TextField("txt"),))
-    await index1.add_document("doc1", txt="text goes here")
+    await index1.client.hset("doc1", mapping={"txt": "text goes here"})
 
     index2 = getClient(modclient).ft("testAlias2")
     await index2.create_index((TextField("txt"),))
-    await index2.add_document("doc2", txt="text goes here")
+    await index2.client.hset("doc2", mapping={"txt": "text goes here"})
 
     # add the actual alias and check
     await index1.aliasadd("myalias")
@@ -674,8 +582,8 @@ async def test_tags(modclient: redis.Redis):
     tags = "foo,foo bar,hello;world"
     tags2 = "soba,ramen"
 
-    await modclient.ft().add_document("doc1", txt="fooz barz", tags=tags)
-    await modclient.ft().add_document("doc2", txt="noodles", tags=tags2)
+    await modclient.hset("doc1", mapping={"txt": "fooz barz", "tags": tags})
+    await modclient.hset("doc2", mapping={"txt": "noodles", "tags": tags2})
     await waitForIndex(modclient, "idx")
 
     q = Query("@tags:{foo}")
@@ -718,8 +626,8 @@ async def test_alter_schema_add(modclient: redis.Redis):
     await modclient.ft().alter_schema_add(TextField("body"))
 
     # Indexing a document
-    await modclient.ft().add_document(
-        "doc1", title="MyTitle", body="Some content only in the body"
+    await modclient.hset(
+        "doc1", mapping={"title": "MyTitle", "body": "Some content only in the body"}
     )
 
     # Searching with parameter only in the body (the added field)
@@ -735,11 +643,11 @@ async def test_spell_check(modclient: redis.Redis):
     await modclient.ft().create_index((TextField("f1"), TextField("f2")))
 
     await (
-        modclient.ft().add_document(
-            "doc1", f1="some valid content", f2="this is sample text"
+        modclient.hset(
+            "doc1", mapping={"f1": "some valid content", "f2": "this is sample text"}
         )
     )
-    await modclient.ft().add_document("doc2", f1="very important", f2="lorem ipsum")
+    await modclient.hset("doc2", mapping={"f1": "very important", "f2": "lorem ipsum"})
     await waitForIndex(modclient, "idx")
 
     # test spellcheck
@@ -793,8 +701,8 @@ async def test_dict_operations(modclient: redis.Redis):
 @pytest.mark.redismod
 async def test_phonetic_matcher(modclient: redis.Redis):
     await modclient.ft().create_index((TextField("name"),))
-    await modclient.ft().add_document("doc1", name="Jon")
-    await modclient.ft().add_document("doc2", name="John")
+    await modclient.hset("doc1", mapping={"name": "Jon"})
+    await modclient.hset("doc2", mapping={"name": "John"})
 
     res = await modclient.ft().search(Query("Jon"))
     assert 1 == len(res.docs)
@@ -804,8 +712,8 @@ async def test_phonetic_matcher(modclient: redis.Redis):
     await modclient.flushdb()
 
     await modclient.ft().create_index((TextField("name", phonetic_matcher="dm:en"),))
-    await modclient.ft().add_document("doc1", name="Jon")
-    await modclient.ft().add_document("doc2", name="John")
+    await modclient.hset("doc1", mapping={"name": "Jon"})
+    await modclient.hset("doc2", mapping={"name": "John"})
 
     res = await modclient.ft().search(Query("Jon"))
     assert 2 == len(res.docs)
@@ -817,12 +725,14 @@ async def test_phonetic_matcher(modclient: redis.Redis):
 async def test_scorer(modclient: redis.Redis):
     await modclient.ft().create_index((TextField("description"),))
 
-    await modclient.ft().add_document(
-        "doc1", description="The quick brown fox jumps over the lazy dog"
+    await modclient.hset(
+        "doc1", mapping={"description": "The quick brown fox jumps over the lazy dog"}
     )
-    await modclient.ft().add_document(
+    await modclient.hset(
         "doc2",
-        description="Quick alice was beginning to get very tired of sitting by her quick sister on the bank, and of having nothing to do.",  # noqa
+        mapping={
+            "description": "Quick alice was beginning to get very tired of sitting by her quick sister on the bank, and of having nothing to do."  # noqa
+        },
     )
 
     # default scorer is TFIDF
@@ -851,19 +761,19 @@ async def test_get(modclient: redis.Redis):
     assert [None] == await modclient.ft().get("doc1")
     assert [None, None] == await modclient.ft().get("doc2", "doc1")
 
-    await modclient.ft().add_document(
-        "doc1", f1="some valid content dd1", f2="this is sample text ff1"
+    await modclient.hset(
+        "doc1", mapping={"f1": "some valid content dd1", "f2": "this is sample text f1"}
     )
-    await modclient.ft().add_document(
-        "doc2", f1="some valid content dd2", f2="this is sample text ff2"
+    await modclient.hset(
+        "doc2", mapping={"f1": "some valid content dd2", "f2": "this is sample text f2"}
     )
 
     assert [
-        ["f1", "some valid content dd2", "f2", "this is sample text ff2"]
+        ["f1", "some valid content dd2", "f2", "this is sample text f2"]
     ] == await modclient.ft().get("doc2")
     assert [
-        ["f1", "some valid content dd1", "f2", "this is sample text ff1"],
-        ["f1", "some valid content dd2", "f2", "this is sample text ff2"],
+        ["f1", "some valid content dd1", "f2", "this is sample text f1"],
+        ["f1", "some valid content dd2", "f2", "this is sample text f2"],
     ] == await modclient.ft().get("doc1", "doc2")
 
 
@@ -894,26 +804,32 @@ async def test_aggregations_groupby(modclient: redis.Redis):
     )
 
     # Indexing a document
-    await modclient.ft().add_document(
+    await modclient.hset(
         "search",
-        title="RediSearch",
-        body="Redisearch impements a search engine on top of redis",
-        parent="redis",
-        random_num=10,
-    )
-    await modclient.ft().add_document(
+        mapping={
+            "title": "RediSearch",
+            "body": "Redisearch impements a search engine on top of redis",
+            "parent": "redis",
+            "random_num": 10,
+        },
+    )
+    await modclient.hset(
         "ai",
-        title="RedisAI",
-        body="RedisAI executes Deep Learning/Machine Learning models and managing their data.",  # noqa
-        parent="redis",
-        random_num=3,
-    )
-    await modclient.ft().add_document(
+        mapping={
+            "title": "RedisAI",
+            "body": "RedisAI executes Deep Learning/Machine Learning models and managing their data.",  # noqa
+            "parent": "redis",
+            "random_num": 3,
+        },
+    )
+    await modclient.hset(
         "json",
-        title="RedisJson",
-        body="RedisJSON implements ECMA-404 The JSON Data Interchange Standard as a native data type.",  # noqa
-        parent="redis",
-        random_num=8,
+        mapping={
+            "title": "RedisJson",
+            "body": "RedisJSON implements ECMA-404 The JSON Data Interchange Standard as a native data type.",  # noqa
+            "parent": "redis",
+            "random_num": 8,
+        },
     )
 
     req = aggregations.AggregateRequest("redis").group_by("@parent", reducers.count())
@@ -1074,15 +990,14 @@ async def test_withsuffixtrie(modclient: redis.Redis):
 async def test_search_commands_in_pipeline(modclient: redis.Redis):
     p = await modclient.ft().pipeline()
     p.create_index((TextField("txt"),))
-    p.add_document("doc1", payload="foo baz", txt="foo bar")
-    p.add_document("doc2", txt="foo bar")
+    p.hset("doc1", mapping={"txt": "foo bar"})
+    p.hset("doc2", mapping={"txt": "foo bar"})
     q = Query("foo bar").with_payloads()
     await p.search(q)
     res = await p.execute()
-    assert res[:3] == ["OK", "OK", "OK"]
+    assert res[:3] == ["OK", True, True]
     assert 2 == res[3][0]
     assert "doc1" == res[3][1]
     assert "doc2" == res[3][4]
-    assert "foo baz" == res[3][2]
     assert res[3][5] is None
     assert res[3][3] == res[3][6] == ["txt", "foo bar"]
diff --git a/tests/test_search.py b/tests/test_search.py
index abaa90817c..08c76f7e08 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -93,7 +93,7 @@ def createIndex(client, num_docs=100, definition=None):
     assert 50 == indexer.chunk_size
 
     for key, doc in chapters.items():
-        indexer.add_document(key, **doc)
+        indexer.client.client.hset(key, mapping=doc)
     indexer.commit()
 
 
@@ -196,7 +196,7 @@ def test_client(client):
     assert 167 == client.ft().search(Query("henry king").slop(100)).total
 
     # test delete document
-    client.ft().add_document("doc-5ghs2", play="Death of a Salesman")
+    client.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
     res = client.ft().search(Query("death of a salesman"))
     assert 1 == res.total
 
@@ -205,36 +205,19 @@ def test_client(client):
     assert 0 == res.total
     assert 0 == client.ft().delete_document("doc-5ghs2")
 
-    client.ft().add_document("doc-5ghs2", play="Death of a Salesman")
+    client.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
     res = client.ft().search(Query("death of a salesman"))
     assert 1 == res.total
     client.ft().delete_document("doc-5ghs2")
 
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.2.0", "search")
-def test_payloads(client):
-    client.ft().create_index((TextField("txt"),))
-
-    client.ft().add_document("doc1", payload="foo baz", txt="foo bar")
-    client.ft().add_document("doc2", txt="foo bar")
-
-    q = Query("foo bar").with_payloads()
-    res = client.ft().search(q)
-    assert 2 == res.total
-    assert "doc1" == res.docs[0].id
-    assert "doc2" == res.docs[1].id
-    assert "foo baz" == res.docs[0].payload
-    assert res.docs[1].payload is None
-
-
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
 def test_scores(client):
     client.ft().create_index((TextField("txt"),))
 
-    client.ft().add_document("doc1", txt="foo baz")
-    client.ft().add_document("doc2", txt="foo bar")
+    client.hset("doc1", mapping={"txt": "foo baz"})
+    client.hset("doc2", mapping={"txt": "foo bar"})
 
     q = Query("foo ~bar").with_scores()
     res = client.ft().search(q)
@@ -246,32 +229,11 @@ def test_scores(client):
     # self.assertEqual(0.2, res.docs[1].score)
 
 
-@pytest.mark.redismod
-def test_replace(client):
-    client.ft().create_index((TextField("txt"),))
-
-    client.ft().add_document("doc1", txt="foo bar")
-    client.ft().add_document("doc2", txt="foo bar")
-    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
-
-    res = client.ft().search("foo bar")
-    assert 2 == res.total
-    client.ft().add_document("doc1", replace=True, txt="this is a replaced doc")
-
-    res = client.ft().search("foo bar")
-    assert 1 == res.total
-    assert "doc2" == res.docs[0].id
-
-    res = client.ft().search("replaced doc")
-    assert 1 == res.total
-    assert "doc1" == res.docs[0].id
-
-
 @pytest.mark.redismod
 def test_stopwords(client):
     client.ft().create_index((TextField("txt"),), stopwords=["foo", "bar", "baz"])
-    client.ft().add_document("doc1", txt="foo bar")
-    client.ft().add_document("doc2", txt="hello world")
+    client.hset("doc1", mapping={"txt": "foo bar"})
+    client.hset("doc2", mapping={"txt": "hello world"})
     waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
     q1 = Query("foo bar").no_content()
@@ -284,8 +246,10 @@ def test_stopwords(client):
 @pytest.mark.redismod
 def test_filters(client):
     client.ft().create_index((TextField("txt"), NumericField("num"), GeoField("loc")))
-    client.ft().add_document("doc1", txt="foo bar", num=3.141, loc="-0.441,51.458")
-    client.ft().add_document("doc2", txt="foo baz", num=2, loc="-0.1,51.2")
+    client.hset(
+        "doc1", mapping={"txt": "foo bar", "num": 3.141, "loc": "-0.441,51.458"}
+    )
+    client.hset("doc2", mapping={"txt": "foo baz", "num": 2, "loc": "-0.1,51.2"})
 
     waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
     # Test numerical filter
@@ -317,23 +281,12 @@ def test_filters(client):
     assert ["doc1", "doc2"] == res
 
 
-@pytest.mark.redismod
-def test_payloads_with_no_content(client):
-    client.ft().create_index((TextField("txt"),))
-    client.ft().add_document("doc1", payload="foo baz", txt="foo bar")
-    client.ft().add_document("doc2", payload="foo baz2", txt="foo bar")
-
-    q = Query("foo bar").with_payloads().no_content()
-    res = client.ft().search(q)
-    assert 2 == len(res.docs)
-
-
 @pytest.mark.redismod
 def test_sort_by(client):
     client.ft().create_index((TextField("txt"), NumericField("num", sortable=True)))
-    client.ft().add_document("doc1", txt="foo bar", num=1)
-    client.ft().add_document("doc2", txt="foo baz", num=2)
-    client.ft().add_document("doc3", txt="foo qux", num=3)
+    client.hset("doc1", mapping={"txt": "foo bar", "num": 1})
+    client.hset("doc2", mapping={"txt": "foo baz", "num": 2})
+    client.hset("doc3", mapping={"txt": "foo qux", "num": 3})
 
     # Test sort
     q1 = Query("foo").sort_by("num", asc=True).no_content()
@@ -375,10 +328,12 @@ def test_example(client):
     client.ft().create_index((TextField("title", weight=5.0), TextField("body")))
 
     # Indexing a document
-    client.ft().add_document(
+    client.hset(
         "doc1",
-        title="RediSearch",
-        body="Redisearch impements a search engine on top of redis",
+        mapping={
+            "title": "RediSearch",
+            "body": "Redisearch impements a search engine on top of redis",
+        },
     )
 
     # Searching with complex parameters:
@@ -450,11 +405,13 @@ def test_no_index(client):
         )
     )
 
-    client.ft().add_document(
-        "doc1", field="aaa", text="1", numeric="1", geo="1,1", tag="1"
+    client.hset(
+        "doc1",
+        mapping={"field": "aaa", "text": "1", "numeric": "1", "geo": "1,1", "tag": "1"},
     )
-    client.ft().add_document(
-        "doc2", field="aab", text="2", numeric="2", geo="2,2", tag="2"
+    client.hset(
+        "doc2",
+        mapping={"field": "aab", "text": "2", "numeric": "2", "geo": "2,2", "tag": "2"},
     )
     waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
@@ -491,45 +448,6 @@ def test_no_index(client):
         TagField("name", no_index=True, sortable=False)
 
 
-@pytest.mark.redismod
-def test_partial(client):
-    client.ft().create_index((TextField("f1"), TextField("f2"), TextField("f3")))
-    client.ft().add_document("doc1", f1="f1_val", f2="f2_val")
-    client.ft().add_document("doc2", f1="f1_val", f2="f2_val")
-    client.ft().add_document("doc1", f3="f3_val", partial=True)
-    client.ft().add_document("doc2", f3="f3_val", replace=True)
-    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
-
-    # Search for f3 value. All documents should have it
-    res = client.ft().search("@f3:f3_val")
-    assert 2 == res.total
-
-    # Only the document updated with PARTIAL should still have f1 and f2 values
-    res = client.ft().search("@f3:f3_val @f2:f2_val @f1:f1_val")
-    assert 1 == res.total
-
-
-@pytest.mark.redismod
-def test_no_create(client):
-    client.ft().create_index((TextField("f1"), TextField("f2"), TextField("f3")))
-    client.ft().add_document("doc1", f1="f1_val", f2="f2_val")
-    client.ft().add_document("doc2", f1="f1_val", f2="f2_val")
-    client.ft().add_document("doc1", f3="f3_val", no_create=True)
-    client.ft().add_document("doc2", f3="f3_val", no_create=True, partial=True)
-    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
-
-    # Search for f3 value. All documents should have it
-    res = client.ft().search("@f3:f3_val")
-    assert 2 == res.total
-
-    # Only the document updated with PARTIAL should still have f1 and f2 values
-    res = client.ft().search("@f3:f3_val @f2:f2_val @f1:f1_val")
-    assert 1 == res.total
-
-    with pytest.raises(redis.ResponseError):
-        client.ft().add_document("doc3", f2="f2_val", f3="f3_val", no_create=True)
-
-
 @pytest.mark.redismod
 def test_explain(client):
     client.ft().create_index((TextField("f1"), TextField("f2"), TextField("f3")))
@@ -618,11 +536,11 @@ def test_alias_basic(client):
     index1 = getClient(client).ft("testAlias")
 
     index1.create_index((TextField("txt"),))
-    index1.add_document("doc1", txt="text goes here")
+    index1.client.hset("doc1", mapping={"txt": "text goes here"})
 
     index2 = getClient(client).ft("testAlias2")
     index2.create_index((TextField("txt"),))
-    index2.add_document("doc2", txt="text goes here")
+    index2.client.hset("doc2", mapping={"txt": "text goes here"})
 
     # add the actual alias and check
     index1.aliasadd("myalias")
@@ -646,36 +564,6 @@ def test_alias_basic(client):
         _ = alias_client2.search("*").docs[0]
 
 
-@pytest.mark.redismod
-def test_tags(client):
-    client.ft().create_index((TextField("txt"), TagField("tags")))
-    tags = "foo,foo bar,hello;world"
-    tags2 = "soba,ramen"
-
-    client.ft().add_document("doc1", txt="fooz barz", tags=tags)
-    client.ft().add_document("doc2", txt="noodles", tags=tags2)
-    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
-
-    q = Query("@tags:{foo}")
-    res = client.ft().search(q)
-    assert 1 == res.total
-
-    q = Query("@tags:{foo bar}")
-    res = client.ft().search(q)
-    assert 1 == res.total
-
-    q = Query("@tags:{foo\\ bar}")
-    res = client.ft().search(q)
-    assert 1 == res.total
-
-    q = Query("@tags:{hello\\;world}")
-    res = client.ft().search(q)
-    assert 1 == res.total
-
-    q2 = client.ft().tagvals("tags")
-    assert (tags.split(",") + tags2.split(",")).sort() == q2.sort()
-
-
 @pytest.mark.redismod
 def test_textfield_sortable_nostem(client):
     # Creating the index definition with sortable and no_stem
@@ -696,8 +584,8 @@ def test_alter_schema_add(client):
     client.ft().alter_schema_add(TextField("body"))
 
     # Indexing a document
-    client.ft().add_document(
-        "doc1", title="MyTitle", body="Some content only in the body"
+    client.hset(
+        "doc1", mapping={"title": "MyTitle", "body": "Some content only in the body"}
     )
 
     # Searching with parameter only in the body (the added field)
@@ -712,8 +600,10 @@ def test_alter_schema_add(client):
 def test_spell_check(client):
     client.ft().create_index((TextField("f1"), TextField("f2")))
 
-    client.ft().add_document("doc1", f1="some valid content", f2="this is sample text")
-    client.ft().add_document("doc2", f1="very important", f2="lorem ipsum")
+    client.hset(
+        "doc1", mapping={"f1": "some valid content", "f2": "this is sample text"}
+    )
+    client.hset("doc2", mapping={"f1": "very important", "f2": "lorem ipsum"})
     waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
     # test spellcheck
@@ -767,8 +657,8 @@ def test_dict_operations(client):
 @pytest.mark.redismod
 def test_phonetic_matcher(client):
     client.ft().create_index((TextField("name"),))
-    client.ft().add_document("doc1", name="Jon")
-    client.ft().add_document("doc2", name="John")
+    client.hset("doc1", mapping={"name": "Jon"})
+    client.hset("doc2", mapping={"name": "John"})
 
     res = client.ft().search(Query("Jon"))
     assert 1 == len(res.docs)
@@ -778,8 +668,8 @@ def test_phonetic_matcher(client):
     client.flushdb()
 
     client.ft().create_index((TextField("name", phonetic_matcher="dm:en"),))
-    client.ft().add_document("doc1", name="Jon")
-    client.ft().add_document("doc2", name="John")
+    client.hset("doc1", mapping={"name": "Jon"})
+    client.hset("doc2", mapping={"name": "John"})
 
     res = client.ft().search(Query("Jon"))
     assert 2 == len(res.docs)
@@ -791,12 +681,14 @@ def test_phonetic_matcher(client):
 def test_scorer(client):
     client.ft().create_index((TextField("description"),))
 
-    client.ft().add_document(
-        "doc1", description="The quick brown fox jumps over the lazy dog"
+    client.hset(
+        "doc1", mapping={"description": "The quick brown fox jumps over the lazy dog"}
     )
-    client.ft().add_document(
+    client.hset(
         "doc2",
-        description="Quick alice was beginning to get very tired of sitting by her quick sister on the bank, and of having nothing to do.",  # noqa
+        mapping={
+            "description": "Quick alice was beginning to get very tired of sitting by her quick sister on the bank, and of having nothing to do."  # noqa
+        },
     )
 
     # default scorer is TFIDF
@@ -823,19 +715,19 @@ def test_get(client):
     assert [None] == client.ft().get("doc1")
     assert [None, None] == client.ft().get("doc2", "doc1")
 
-    client.ft().add_document(
-        "doc1", f1="some valid content dd1", f2="this is sample text ff1"
+    client.hset(
+        "doc1", mapping={"f1": "some valid content dd1", "f2": "this is sample text f1"}
     )
-    client.ft().add_document(
-        "doc2", f1="some valid content dd2", f2="this is sample text ff2"
+    client.hset(
+        "doc2", mapping={"f1": "some valid content dd2", "f2": "this is sample text f2"}
     )
 
     assert [
-        ["f1", "some valid content dd2", "f2", "this is sample text ff2"]
+        ["f1", "some valid content dd2", "f2", "this is sample text f2"]
     ] == client.ft().get("doc2")
     assert [
-        ["f1", "some valid content dd1", "f2", "this is sample text ff1"],
-        ["f1", "some valid content dd2", "f2", "this is sample text ff2"],
+        ["f1", "some valid content dd1", "f2", "this is sample text f1"],
+        ["f1", "some valid content dd2", "f2", "this is sample text f2"],
     ] == client.ft().get("doc1", "doc2")
 
 
@@ -866,26 +758,32 @@ def test_aggregations_groupby(client):
     )
 
     # Indexing a document
-    client.ft().add_document(
+    client.hset(
         "search",
-        title="RediSearch",
-        body="Redisearch impements a search engine on top of redis",
-        parent="redis",
-        random_num=10,
+        mapping={
+            "title": "RediSearch",
+            "body": "Redisearch impements a search engine on top of redis",
+            "parent": "redis",
+            "random_num": 10,
+        },
     )
-    client.ft().add_document(
+    client.hset(
         "ai",
-        title="RedisAI",
-        body="RedisAI executes Deep Learning/Machine Learning models and managing their data.",  # noqa
-        parent="redis",
-        random_num=3,
+        mapping={
+            "title": "RedisAI",
+            "body": "RedisAI executes Deep Learning/Machine Learning models and managing their data.",  # noqa
+            "parent": "redis",
+            "random_num": 3,
+        },
     )
-    client.ft().add_document(
+    client.hset(
         "json",
-        title="RedisJson",
-        body="RedisJSON implements ECMA-404 The JSON Data Interchange Standard as a native data type.",  # noqa
-        parent="redis",
-        random_num=8,
+        mapping={
+            "title": "RedisJson",
+            "body": "RedisJSON implements ECMA-404 The JSON Data Interchange Standard as a native data type.",  # noqa
+            "parent": "redis",
+            "random_num": 8,
+        },
     )
 
     req = aggregations.AggregateRequest("redis").group_by("@parent", reducers.count())
@@ -1134,7 +1032,7 @@ def test_index_definition(client):
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
 @skip_if_redis_enterprise()
-def testExpire(client):
+def test_expire(client):
     client.ft().create_index((TextField("txt", sortable=True),), temporary=4)
     ttl = client.execute_command("ft.debug", "TTL", "idx")
     assert ttl > 2
@@ -1143,20 +1041,9 @@ def testExpire(client):
         ttl = client.execute_command("ft.debug", "TTL", "idx")
         time.sleep(0.01)
 
-    # add document - should reset the ttl
-    client.ft().add_document("doc", txt="foo bar", text="this is a simple test")
-    ttl = client.execute_command("ft.debug", "TTL", "idx")
-    assert ttl > 2
-    try:
-        while True:
-            ttl = client.execute_command("ft.debug", "TTL", "idx")
-            time.sleep(0.5)
-    except redis.exceptions.ResponseError:
-        assert ttl == 0
-
 
 @pytest.mark.redismod
-def testSkipInitialScan(client):
+def test_skip_initial_scan(client):
     client.hset("doc1", "foo", "bar")
     q = Query("@foo:bar")
 
@@ -1165,23 +1052,23 @@ def testSkipInitialScan(client):
 
 
 @pytest.mark.redismod
-def testSummarizeDisabled_nooffset(client):
+def test_summarize_disabled_nooffset(client):
     client.ft().create_index((TextField("txt"),), no_term_offsets=True)
-    client.ft().add_document("doc1", txt="foo bar")
+    client.hset("doc1", mapping={"txt": "foo bar"})
     with pytest.raises(Exception):
         client.ft().search(Query("foo").summarize(fields=["txt"]))
 
 
 @pytest.mark.redismod
-def testSummarizeDisabled_nohl(client):
+def test_summarize_disabled_nohl(client):
     client.ft().create_index((TextField("txt"),), no_highlight=True)
-    client.ft().add_document("doc1", txt="foo bar")
+    client.hset("doc1", mapping={"txt": "foo bar"})
     with pytest.raises(Exception):
         client.ft().search(Query("foo").summarize(fields=["txt"]))
 
 
 @pytest.mark.redismod
-def testMaxTextFields(client):
+def test_max_text_fields(client):
     # Creating the index definition
     client.ft().create_index((TextField("f0"),))
     for x in range(1, 32):
@@ -1337,10 +1224,10 @@ def test_synupdate(client):
     )
 
     client.ft().synupdate("id1", True, "boy", "child", "offspring")
-    client.ft().add_document("doc1", title="he is a baby", body="this is a test")
+    client.hset("doc1", mapping={"title": "he is a baby", "body": "this is a test"})
 
     client.ft().synupdate("id1", True, "baby")
-    client.ft().add_document("doc2", title="he is another baby", body="another test")
+    client.hset("doc2", mapping={"title": "he is another baby", "body": "another test"})
 
     res = client.ft().search(Query("child").expander("SYNONYM"))
     assert res.docs[0].id == "doc2"
@@ -1579,9 +1466,9 @@ def test_text_params(modclient):
     modclient.flushdb()
     modclient.ft().create_index((TextField("name"),))
 
-    modclient.ft().add_document("doc1", name="Alice")
-    modclient.ft().add_document("doc2", name="Bob")
-    modclient.ft().add_document("doc3", name="Carol")
+    modclient.hset("doc1", mapping={"name": "Alice"})
+    modclient.hset("doc2", mapping={"name": "Bob"})
+    modclient.hset("doc3", mapping={"name": "Carol"})
 
     params_dict = {"name1": "Alice", "name2": "Bob"}
     q = Query("@name:($name1 | $name2 )").dialect(2)
@@ -1597,9 +1484,9 @@ def test_numeric_params(modclient):
     modclient.flushdb()
     modclient.ft().create_index((NumericField("numval"),))
 
-    modclient.ft().add_document("doc1", numval=101)
-    modclient.ft().add_document("doc2", numval=102)
-    modclient.ft().add_document("doc3", numval=103)
+    modclient.hset("doc1", mapping={"numval": 101})
+    modclient.hset("doc2", mapping={"numval": 102})
+    modclient.hset("doc3", mapping={"numval": 103})
 
     params_dict = {"min": 101, "max": 102}
     q = Query("@numval:[$min $max]").dialect(2)
@@ -1616,9 +1503,9 @@ def test_geo_params(modclient):
 
     modclient.flushdb()
     modclient.ft().create_index((GeoField("g")))
-    modclient.ft().add_document("doc1", g="29.69465, 34.95126")
-    modclient.ft().add_document("doc2", g="29.69350, 34.94737")
-    modclient.ft().add_document("doc3", g="29.68746, 34.94882")
+    modclient.hset("doc1", mapping={"g": "29.69465, 34.95126"})
+    modclient.hset("doc2", mapping={"g": "29.69350, 34.94737"})
+    modclient.hset("doc3", mapping={"g": "29.68746, 34.94882"})
 
     params_dict = {"lat": "34.95126", "lon": "29.69465", "radius": 1000, "units": "km"}
     q = Query("@g:[$lon $lat $radius $units]").dialect(2)
@@ -1634,16 +1521,15 @@ def test_geo_params(modclient):
 def test_search_commands_in_pipeline(client):
     p = client.ft().pipeline()
     p.create_index((TextField("txt"),))
-    p.add_document("doc1", payload="foo baz", txt="foo bar")
-    p.add_document("doc2", txt="foo bar")
+    p.hset("doc1", mapping={"txt": "foo bar"})
+    p.hset("doc2", mapping={"txt": "foo bar"})
     q = Query("foo bar").with_payloads()
     p.search(q)
     res = p.execute()
-    assert res[:3] == ["OK", "OK", "OK"]
+    assert res[:3] == ["OK", True, True]
     assert 2 == res[3][0]
     assert "doc1" == res[3][1]
     assert "doc2" == res[3][4]
-    assert "foo baz" == res[3][2]
     assert res[3][5] is None
     assert res[3][3] == res[3][6] == ["txt", "foo bar"]
 

From 4200d54c748b8de7ae01ea9c0a45b149f32b5c19 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 25 Oct 2022 17:16:39 +0300
Subject: [PATCH 0602/1164] Fixing bloom tests (#2430)

---
 tests/test_asyncio/test_bloom.py | 6 +++---
 tests/test_bloom.py              | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/tests/test_asyncio/test_bloom.py b/tests/test_asyncio/test_bloom.py
index fd9e94903b..cac989f913 100644
--- a/tests/test_asyncio/test_bloom.py
+++ b/tests/test_asyncio/test_bloom.py
@@ -426,9 +426,9 @@ async def test_tdigest_rank(modclient: redis.Redis):
     assert await modclient.tdigest().create("t-digest", 500)
     assert await modclient.tdigest().add("t-digest", list(range(0, 20)))
     assert -1 == (await modclient.tdigest().rank("t-digest", -1))[0]
-    assert 1 == (await modclient.tdigest().rank("t-digest", 0))[0]
-    assert 11 == (await modclient.tdigest().rank("t-digest", 10))[0]
-    assert [-1, 20, 10] == await modclient.tdigest().rank("t-digest", -20, 20, 9)
+    assert 0 == (await modclient.tdigest().rank("t-digest", 0))[0]
+    assert 10 == (await modclient.tdigest().rank("t-digest", 10))[0]
+    assert [-1, 20, 9] == await modclient.tdigest().rank("t-digest", -20, 20, 9)
 
 
 @pytest.mark.redismod
diff --git a/tests/test_bloom.py b/tests/test_bloom.py
index 45b898efbf..13921bfbd1 100644
--- a/tests/test_bloom.py
+++ b/tests/test_bloom.py
@@ -434,9 +434,9 @@ def test_tdigest_rank(client):
     assert client.tdigest().create("t-digest", 500)
     assert client.tdigest().add("t-digest", list(range(0, 20)))
     assert -1 == client.tdigest().rank("t-digest", -1)[0]
-    assert 1 == client.tdigest().rank("t-digest", 0)[0]
-    assert 11 == client.tdigest().rank("t-digest", 10)[0]
-    assert [-1, 20, 10] == client.tdigest().rank("t-digest", -20, 20, 9)
+    assert 0 == client.tdigest().rank("t-digest", 0)[0]
+    assert 10 == client.tdigest().rank("t-digest", 10)[0]
+    assert [-1, 20, 9] == client.tdigest().rank("t-digest", -20, 20, 9)
 
 
 @pytest.mark.redismod

From 0f2cc69ec2558f8a30d2d41b74a70d97d987f3d1 Mon Sep 17 00:00:00 2001
From: Anne Yang <evangeline-lun@foxmail.com>
Date: Tue, 25 Oct 2022 23:11:46 +0800
Subject: [PATCH 0603/1164] Add to_string method for GeoValue (#2404)

* Add to_string method for GeoValue

* fix code style

* simplify code

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/commands/search/querystring.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/redis/commands/search/querystring.py b/redis/commands/search/querystring.py
index 1da0387eb8..3ff1320972 100644
--- a/redis/commands/search/querystring.py
+++ b/redis/commands/search/querystring.py
@@ -132,6 +132,9 @@ def __init__(self, lon, lat, radius, unit="km"):
         self.radius = radius
         self.unit = unit
 
+    def to_string(self):
+        return f"[{self.lon} {self.lat} {self.radius} {self.unit}]"
+
 
 class Node:
     def __init__(self, *children, **kwparams):

From 1c2461d82b2987aca583a59a42b4568da2648b17 Mon Sep 17 00:00:00 2001
From: Nikita Sobolev <mail@sobolevn.me>
Date: Tue, 25 Oct 2022 18:13:53 +0300
Subject: [PATCH 0604/1164] Test `test_get_moveable_keys` was broken (#2411)

* Test `test_get_moveable_keys` was broken

* Update test_command_parser.py

* Do not sort constant lists

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 tests/test_command_parser.py | 22 +++++++---------------
 1 file changed, 7 insertions(+), 15 deletions(-)

diff --git a/tests/test_command_parser.py b/tests/test_command_parser.py
index 708c069339..6c3ede9cdf 100644
--- a/tests/test_command_parser.py
+++ b/tests/test_command_parser.py
@@ -51,21 +51,13 @@ def test_get_moveable_keys(self, r):
         ]
         args7 = ["MIGRATE", "192.168.1.34", 6379, "key1", 0, 5000]
 
-        assert commands_parser.get_keys(r, *args1).sort() == ["key1", "key2"].sort()
-        assert (
-            commands_parser.get_keys(r, *args2).sort() == ["mystream", "writers"].sort()
-        )
-        assert (
-            commands_parser.get_keys(r, *args3).sort()
-            == ["out", "zset1", "zset2"].sort()
-        )
-        assert commands_parser.get_keys(r, *args4).sort() == ["Sicily", "out"].sort()
-        assert commands_parser.get_keys(r, *args5).sort() == ["foo"].sort()
-        assert (
-            commands_parser.get_keys(r, *args6).sort()
-            == ["key1", "key2", "key3"].sort()
-        )
-        assert commands_parser.get_keys(r, *args7).sort() == ["key1"].sort()
+        assert sorted(commands_parser.get_keys(r, *args1)) == ["key1", "key2"]
+        assert sorted(commands_parser.get_keys(r, *args2)) == ["mystream", "writers"]
+        assert sorted(commands_parser.get_keys(r, *args3)) == ["out", "zset1", "zset2"]
+        assert sorted(commands_parser.get_keys(r, *args4)) == ["Sicily", "out"]
+        assert sorted(commands_parser.get_keys(r, *args5)) == ["foo"]
+        assert sorted(commands_parser.get_keys(r, *args6)) == ["key1", "key2", "key3"]
+        assert sorted(commands_parser.get_keys(r, *args7)) == ["key1"]
 
     # A bug in redis<7.0 causes this to fail: https://github.com/redis/redis/issues/9493
     @skip_if_server_version_lt("7.0.0")

From 9d70719840d9831ea40904a36038fcd0e3fdff65 Mon Sep 17 00:00:00 2001
From: Ashik Shezan <ashikshezan@gmail.com>
Date: Tue, 25 Oct 2022 21:14:06 +0600
Subject: [PATCH 0605/1164] doc: redismodules.rst fix (#2429)

Parentheses were not closed

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 docs/redismodules.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/redismodules.rst b/docs/redismodules.rst
index 86a323a925..cf31b2973b 100644
--- a/docs/redismodules.rst
+++ b/docs/redismodules.rst
@@ -91,7 +91,7 @@ These are the commands for interacting with the `RedisJSON module <https://redis
 
     import redis
     r = redis.Redis()
-    r.json().set("mykey", ".", {"hello": "world", "i am": ["a", "json", "object!"]}
+    r.json().set("mykey", ".", {"hello": "world", "i am": ["a", "json", "object!"]})
 
 Examples of how to combine search and json can be found `here <examples/search_json_examples.html>`_.
 

From bea00b16c8043397c6bb6f3df45d48bceefa685f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EC=86=A1=ED=98=95=EA=B7=BC=28Hyeongguen=20Song=29/DnU?=
 <87850472+hyeongguen-song@users.noreply.github.com>
Date: Wed, 26 Oct 2022 00:14:37 +0900
Subject: [PATCH 0606/1164] fix: catch OSError on asyncio (#2412)

---
 redis/asyncio/connection.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index c8834c9286..bc0362e782 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -1445,7 +1445,7 @@ async def get_connection(self, command_name, *keys, **options):
             try:
                 if await connection.can_read_destructive():
                     raise ConnectionError("Connection has data") from None
-            except ConnectionError:
+            except (ConnectionError, OSError):
                 await connection.disconnect()
                 await connection.connect()
                 if await connection.can_read_destructive():
@@ -1646,7 +1646,7 @@ async def get_connection(self, command_name, *keys, **options):
             try:
                 if await connection.can_read_destructive():
                     raise ConnectionError("Connection has data") from None
-            except ConnectionError:
+            except (ConnectionError, OSError):
                 await connection.disconnect()
                 await connection.connect()
                 if await connection.can_read_destructive():

From 8a5c47059fe126e22a79c63cfb168d035754049b Mon Sep 17 00:00:00 2001
From: Sam Bull <aa6bs0@sambull.org>
Date: Sun, 30 Oct 2022 00:49:54 +0100
Subject: [PATCH 0607/1164] Tidy up asyncio examples. (#2431)

---
 docs/examples/asyncio_examples.ipynb | 68 +++++++++++-----------------
 1 file changed, 27 insertions(+), 41 deletions(-)

diff --git a/docs/examples/asyncio_examples.ipynb b/docs/examples/asyncio_examples.ipynb
index 66d435835b..dab7a96ae9 100644
--- a/docs/examples/asyncio_examples.ipynb
+++ b/docs/examples/asyncio_examples.ipynb
@@ -140,8 +140,6 @@
    "source": [
     "import asyncio\n",
     "\n",
-    "import async_timeout\n",
-    "\n",
     "import redis.asyncio as redis\n",
     "\n",
     "STOPWORD = \"STOP\"\n",
@@ -149,29 +147,24 @@
     "\n",
     "async def reader(channel: redis.client.PubSub):\n",
     "    while True:\n",
-    "        try:\n",
-    "            async with async_timeout.timeout(1):\n",
-    "                message = await channel.get_message(ignore_subscribe_messages=True)\n",
-    "                if message is not None:\n",
-    "                    print(f\"(Reader) Message Received: {message}\")\n",
-    "                    if message[\"data\"].decode() == STOPWORD:\n",
-    "                        print(\"(Reader) STOP\")\n",
-    "                        break\n",
-    "                await asyncio.sleep(0.01)\n",
-    "        except asyncio.TimeoutError:\n",
-    "            pass\n",
+    "        message = await channel.get_message(ignore_subscribe_messages=True)\n",
+    "        if message is not None:\n",
+    "            print(f\"(Reader) Message Received: {message}\")\n",
+    "            if message[\"data\"].decode() == STOPWORD:\n",
+    "                print(\"(Reader) STOP\")\n",
+    "                break\n",
     "\n",
     "r = redis.from_url(\"redis://localhost\")\n",
-    "pubsub = r.pubsub()\n",
-    "await pubsub.subscribe(\"channel:1\", \"channel:2\")\n",
+    "async with r.pubsub() as pubsub:\n",
+    "    await pubsub.subscribe(\"channel:1\", \"channel:2\")\n",
     "\n",
-    "future = asyncio.create_task(reader(pubsub))\n",
+    "    future = asyncio.create_task(reader(pubsub))\n",
     "\n",
-    "await r.publish(\"channel:1\", \"Hello\")\n",
-    "await r.publish(\"channel:2\", \"World\")\n",
-    "await r.publish(\"channel:1\", STOPWORD)\n",
+    "    await r.publish(\"channel:1\", \"Hello\")\n",
+    "    await r.publish(\"channel:2\", \"World\")\n",
+    "    await r.publish(\"channel:1\", STOPWORD)\n",
     "\n",
-    "await future"
+    "    await future"
    ]
   },
   {
@@ -204,8 +197,6 @@
    "source": [
     "import asyncio\n",
     "\n",
-    "import async_timeout\n",
-    "\n",
     "import redis.asyncio as redis\n",
     "\n",
     "STOPWORD = \"STOP\"\n",
@@ -213,30 +204,25 @@
     "\n",
     "async def reader(channel: redis.client.PubSub):\n",
     "    while True:\n",
-    "        try:\n",
-    "            async with async_timeout.timeout(1):\n",
-    "                message = await channel.get_message(ignore_subscribe_messages=True)\n",
-    "                if message is not None:\n",
-    "                    print(f\"(Reader) Message Received: {message}\")\n",
-    "                    if message[\"data\"].decode() == STOPWORD:\n",
-    "                        print(\"(Reader) STOP\")\n",
-    "                        break\n",
-    "                await asyncio.sleep(0.01)\n",
-    "        except asyncio.TimeoutError:\n",
-    "            pass\n",
+    "        message = await channel.get_message(ignore_subscribe_messages=True)\n",
+    "        if message is not None:\n",
+    "            print(f\"(Reader) Message Received: {message}\")\n",
+    "            if message[\"data\"].decode() == STOPWORD:\n",
+    "                print(\"(Reader) STOP\")\n",
+    "                break\n",
     "\n",
     "\n",
     "r = await redis.from_url(\"redis://localhost\")\n",
-    "pubsub = r.pubsub()\n",
-    "await pubsub.psubscribe(\"channel:*\")\n",
+    "async with r.pubsub() as pubsub:\n",
+    "    await pubsub.psubscribe(\"channel:*\")\n",
     "\n",
-    "future = asyncio.create_task(reader(pubsub))\n",
+    "    future = asyncio.create_task(reader(pubsub))\n",
     "\n",
-    "await r.publish(\"channel:1\", \"Hello\")\n",
-    "await r.publish(\"channel:2\", \"World\")\n",
-    "await r.publish(\"channel:1\", STOPWORD)\n",
+    "    await r.publish(\"channel:1\", \"Hello\")\n",
+    "    await r.publish(\"channel:2\", \"World\")\n",
+    "    await r.publish(\"channel:1\", STOPWORD)\n",
     "\n",
-    "await future"
+    "    await future"
    ]
   },
   {
@@ -298,4 +284,4 @@
  },
  "nbformat": 4,
  "nbformat_minor": 1
-}
\ No newline at end of file
+}

From a5646c3b7f38184cc5a152ebc186718c2d880c26 Mon Sep 17 00:00:00 2001
From: Andrei Andrukhovich <aaandrukhovich@yandex.ru>
Date: Sun, 30 Oct 2022 02:50:36 +0300
Subject: [PATCH 0608/1164] Add missing dots in README.md (#2435)

---
 README.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 8b7333e157..1cb429618b 100644
--- a/README.md
+++ b/README.md
@@ -49,22 +49,22 @@ True
 b'bar'
 ```
 
-The above code connects to localhost on port 6379, sets a value in Redis, and retrieves it. All responses are returned as bytes in Python, to receive decoded strings, set *decode_responses=True*.  For this, and more connection options, see [these examples](https://redis.readthedocs.io/en/stable/examples.html)
+The above code connects to localhost on port 6379, sets a value in Redis, and retrieves it. All responses are returned as bytes in Python, to receive decoded strings, set *decode_responses=True*.  For this, and more connection options, see [these examples](https://redis.readthedocs.io/en/stable/examples.html).
 
 ### Connection Pools
 
-By default, redis-py uses a connection pool to manage connections. Each instance of a Redis class receives its own connection pool. You can however define your own [redis.ConnectionPool](https://redis.readthedocs.io/en/stable/connections.html#connection-pools)
+By default, redis-py uses a connection pool to manage connections. Each instance of a Redis class receives its own connection pool. You can however define your own [redis.ConnectionPool](https://redis.readthedocs.io/en/stable/connections.html#connection-pools).
 
 ``` python
 >>> pool = redis.ConnectionPool(host='localhost', port=6379, db=0)
 >>> r = redis.Redis(connection_pool=pool)
 ```
 
-Alternatively, you might want to look at [Async connections](https://redis.readthedocs.io/en/stable/examples/asyncio_examples.html), or [Cluster connections](https://redis.readthedocs.io/en/stable/connections.html#cluster-client), or even [Async Cluster connections](https://redis.readthedocs.io/en/stable/connections.html#async-cluster-client)
+Alternatively, you might want to look at [Async connections](https://redis.readthedocs.io/en/stable/examples/asyncio_examples.html), or [Cluster connections](https://redis.readthedocs.io/en/stable/connections.html#cluster-client), or even [Async Cluster connections](https://redis.readthedocs.io/en/stable/connections.html#async-cluster-client).
 
 ### Redis Commands
 
-There is built-in support for all of the [out-of-the-box Redis commands](https://redis.io/commands). They are exposed using the raw Redis command names (`HSET`, `HGETALL`, etc.) except where a word (i.e del) is reserved by the language. The complete set of commands can be found [here](https://github.com/redis/redis-py/tree/master/redis/commands), or [the documentation](https://redis.readthedocs.io/en/stable/commands.html).
+There is built-in support for all of the [out-of-the-box Redis commands](https://redis.io/commands). They are exposed using the raw Redis command names (`HSET`, `HGETALL`, etc.) except where a word (i.e. del) is reserved by the language. The complete set of commands can be found [here](https://github.com/redis/redis-py/tree/master/redis/commands), or [the documentation](https://redis.readthedocs.io/en/stable/commands.html).
 
 ## Advanced Topics
 

From 51797765d6c9cf72776eaa031b0ebb1e6a5ed77a Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 30 Oct 2022 01:50:56 +0200
Subject: [PATCH 0609/1164] Adding python 3.11 to CI (#2428)

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 .github/workflows/integration.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 26e4c06040..c2b84a6074 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -49,7 +49,7 @@ jobs:
      strategy:
        max-parallel: 15
        matrix:
-         python-version: ['3.7', '3.8', '3.9', '3.10', 'pypy-3.7', 'pypy-3.8']
+         python-version: ['3.7', '3.8', '3.9', '3.10', '3.11', 'pypy-3.7', 'pypy-3.8']
          test-type: ['standalone', 'cluster']
          connection-type: ['hiredis', 'plain']
      env:
@@ -106,7 +106,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.7', '3.8', '3.9', '3.10', 'pypy-3.7']
+        python-version: ['3.7', '3.8', '3.9', '3.10', '3.11', 'pypy-3.7']
     steps:
       - uses: actions/checkout@v3
       - uses: actions/setup-python@v4

From 9f3791fa781f979664edc0869eb2c02562abc4bb Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 30 Oct 2022 09:14:00 +0200
Subject: [PATCH 0610/1164] Fix KeyError in async cluster - initialize before
 execute multi key commands (#2439)

* Fix KeyError in async cluster

* link to issue

* typo
---
 redis/commands/cluster.py          | 19 +++++++++++++++++++
 tests/test_asyncio/test_cluster.py |  9 +++++++++
 2 files changed, 28 insertions(+)

diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index 8e4c8ef1d0..f0eaaf75c5 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -316,6 +316,25 @@ async def _split_command_across_slots(self, command: str, *keys: KeyT) -> int:
         # Sum up the reply from each command
         return sum(await self._execute_pipeline_by_slot(command, slots_to_keys))
 
+    async def _execute_pipeline_by_slot(
+        self, command: str, slots_to_args: Mapping[int, Iterable[EncodableT]]
+    ) -> List[Any]:
+        if self._initialize:
+            await self.initialize()
+        read_from_replicas = self.read_from_replicas and command in READ_COMMANDS
+        pipe = self.pipeline()
+        [
+            pipe.execute_command(
+                command,
+                *slot_args,
+                target_nodes=[
+                    self.nodes_manager.get_node_from_slot(slot, read_from_replicas)
+                ],
+            )
+            for slot, slot_args in slots_to_args.items()
+        ]
+        return await pipe.execute()
+
 
 class ClusterManagementCommands(ManagementCommands):
     """
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index f1bbe42267..27f11900c4 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -802,6 +802,15 @@ async def test_unlink(self, r: RedisCluster) -> None:
         await asyncio.sleep(0.1)
         assert await r.unlink(*d.keys()) == 0
 
+    async def test_initialize_before_execute_multi_key_command(
+        self, request: FixtureRequest
+    ) -> None:
+        # Test for issue https://github.com/redis/redis-py/issues/2437
+        url = request.config.getoption("--redis-url")
+        r = RedisCluster.from_url(url)
+        assert 0 == await r.exists("a", "b", "c")
+        await r.close()
+
     @skip_if_redis_enterprise()
     async def test_cluster_myid(self, r: RedisCluster) -> None:
         node = r.get_random_node()

From bbc91af86cb26a25a025db0b3d63a4633798683c Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 30 Oct 2022 09:48:51 +0200
Subject: [PATCH 0611/1164] Remove default None value from LMPOP (#2438)

---
 redis/commands/core.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 51f30d2ef0..c245a7a8e2 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -2553,7 +2553,7 @@ def lmpop(
         self,
         num_keys: int,
         *args: List[str],
-        direction: str = None,
+        direction: str,
         count: Optional[int] = 1,
     ) -> Union[Awaitable[list], list]:
         """

From 9cf8e028863c79904d9536465e5844184109d209 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 30 Oct 2022 10:35:47 +0200
Subject: [PATCH 0612/1164] Link to the latest pre-release (#2440)

---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index 1cb429618b..7e44cfa62a 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,7 @@ The Python interface to the Redis key-value store.
 [![docs](https://readthedocs.org/projects/redis/badge/?version=stable&style=flat)](https://redis-py.readthedocs.io/en/stable/)
 [![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 [![pypi](https://badge.fury.io/py/redis.svg)](https://pypi.org/project/redis/)
+[![pre-release](https://img.shields.io/github/v/release/redis/redis-py?include_prereleases&label=latest-prerelease)](https://github.com/redis/redis-py/releases)
 [![codecov](https://codecov.io/gh/redis/redis-py/branch/master/graph/badge.svg?token=yenl5fzxxr)](https://codecov.io/gh/redis/redis-py)
 [![Total alerts](https://img.shields.io/lgtm/alerts/g/redis/redis-py.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/redis/redis-py/alerts/)
 

From 842634e7fddeb32ba20aab0dacf557a958a4b00b Mon Sep 17 00:00:00 2001
From: Aarni Koskela <akx@iki.fi>
Date: Sun, 30 Oct 2022 13:31:03 +0200
Subject: [PATCH 0613/1164] Remove `deprecated` dependency (#2386)

No need for an external library just for 5 annotations.
---
 CHANGES                           |  1 +
 redis/commands/bf/commands.py     |  6 ++----
 redis/commands/json/commands.py   | 11 +++++------
 redis/commands/search/commands.py |  7 +++----
 redis/utils.py                    | 28 ++++++++++++++++++++++++++++
 requirements.txt                  |  1 -
 setup.py                          |  1 -
 7 files changed, 39 insertions(+), 16 deletions(-)

diff --git a/CHANGES b/CHANGES
index 2ced3d8f96..f5c267bdda 100644
--- a/CHANGES
+++ b/CHANGES
@@ -22,6 +22,7 @@
     * Fix RedisCluster to immediately raise AuthenticationError without a retry
     * ClusterPipeline Doesn't Handle ConnectionError for Dead Hosts (#2225)
     * Remove compatibility code for old versions of Hiredis, drop Packaging dependency
+    * The `deprecated` library is no longer a dependency
 
 * 4.1.3 (Feb 8, 2022)
     * Fix flushdb and flushall (#1926)
diff --git a/redis/commands/bf/commands.py b/redis/commands/bf/commands.py
index 60409fd232..f6bf281639 100644
--- a/redis/commands/bf/commands.py
+++ b/redis/commands/bf/commands.py
@@ -1,8 +1,6 @@
-from deprecated import deprecated
-
 from redis.client import NEVER_DECODE
 from redis.exceptions import ModuleError
-from redis.utils import HIREDIS_AVAILABLE
+from redis.utils import HIREDIS_AVAILABLE, deprecated_function
 
 BF_RESERVE = "BF.RESERVE"
 BF_ADD = "BF.ADD"
@@ -327,7 +325,7 @@ def query(self, key, *items):
         """  # noqa
         return self.execute_command(TOPK_QUERY, key, *items)
 
-    @deprecated(version="4.4.0", reason="deprecated since redisbloom 2.4.0")
+    @deprecated_function(version="4.4.0", reason="deprecated since redisbloom 2.4.0")
     def count(self, key, *items):
         """
         Return count for one `item` or more from `key`.
diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index 9391c2a2c1..7fd4039203 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -2,9 +2,8 @@
 from json import JSONDecodeError, loads
 from typing import Dict, List, Optional, Union
 
-from deprecated import deprecated
-
 from redis.exceptions import DataError
+from redis.utils import deprecated_function
 
 from ._util import JsonType
 from .decoders import decode_dict_keys
@@ -137,7 +136,7 @@ def numincrby(self, name: str, path: str, number: int) -> str:
             "JSON.NUMINCRBY", name, str(path), self._encode(number)
         )
 
-    @deprecated(version="4.0.0", reason="deprecated since redisjson 1.0.0")
+    @deprecated_function(version="4.0.0", reason="deprecated since redisjson 1.0.0")
     def nummultby(self, name: str, path: str, number: int) -> str:
         """Multiply the numeric (integer or floating point) JSON value under
         ``path`` at key ``name`` with the provided ``number``.
@@ -368,19 +367,19 @@ def debug(
             pieces.append(str(path))
         return self.execute_command("JSON.DEBUG", *pieces)
 
-    @deprecated(
+    @deprecated_function(
         version="4.0.0", reason="redisjson-py supported this, call get directly."
     )
     def jsonget(self, *args, **kwargs):
         return self.get(*args, **kwargs)
 
-    @deprecated(
+    @deprecated_function(
         version="4.0.0", reason="redisjson-py supported this, call get directly."
     )
     def jsonmget(self, *args, **kwargs):
         return self.mget(*args, **kwargs)
 
-    @deprecated(
+    @deprecated_function(
         version="4.0.0", reason="redisjson-py supported this, call get directly."
     )
     def jsonset(self, *args, **kwargs):
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index ceca20f51d..f02805ee2b 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -2,9 +2,8 @@
 import time
 from typing import Dict, Optional, Union
 
-from deprecated import deprecated
-
 from redis.client import Pipeline
+from redis.utils import deprecated_function
 
 from ..helpers import parse_to_dict
 from ._util import to_string
@@ -238,7 +237,7 @@ def _add_document_hash(
 
         return self.execute_command(*args)
 
-    @deprecated(
+    @deprecated_function(
         version="2.0.0", reason="deprecated since redisearch 2.0, call hset instead"
     )
     def add_document(
@@ -294,7 +293,7 @@ def add_document(
             **fields,
         )
 
-    @deprecated(
+    @deprecated_function(
         version="2.0.0", reason="deprecated since redisearch 2.0, call hset instead"
     )
     def add_document_hash(self, doc_id, score=1.0, language=None, replace=False):
diff --git a/redis/utils.py b/redis/utils.py
index 25d2491dfe..693d4e64b5 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -1,4 +1,5 @@
 from contextlib import contextmanager
+from functools import wraps
 from typing import Any, Dict, Mapping, Union
 
 try:
@@ -80,3 +81,30 @@ def merge_result(command, res):
             result.add(value)
 
     return list(result)
+
+
+def warn_deprecated(name, reason="", version="", stacklevel=2):
+    import warnings
+
+    msg = f"Call to deprecated {name}."
+    if reason:
+        msg += f" ({reason})"
+    if version:
+        msg += f" -- Deprecated since version {version}."
+    warnings.warn(msg, category=DeprecationWarning, stacklevel=stacklevel)
+
+
+def deprecated_function(reason="", version="", name=None):
+    """
+    Decorator to mark a function as deprecated.
+    """
+
+    def decorator(func):
+        @wraps(func)
+        def wrapper(*args, **kwargs):
+            warn_deprecated(name or func.__name__, reason, version, stacklevel=3)
+            return func(*args, **kwargs)
+
+        return wrapper
+
+    return decorator
diff --git a/requirements.txt b/requirements.txt
index b764668e7a..82c46c92c6 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,3 +1,2 @@
 async-timeout>=4.0.2
-deprecated>=1.2.3
 typing-extensions; python_version<"3.8"
diff --git a/setup.py b/setup.py
index db2db93b79..befa9dc131 100644
--- a/setup.py
+++ b/setup.py
@@ -32,7 +32,6 @@
     author_email="oss@redis.com",
     python_requires=">=3.7",
     install_requires=[
-        "deprecated>=1.2.3",
         'importlib-metadata >= 1.0; python_version < "3.8"',
         'typing-extensions; python_version<"3.8"',
         "async-timeout>=4.0.2",

From 16270e4bb5fcaebe8a8992fc2b2ccbd9d57b8c3e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Sun, 30 Oct 2022 11:39:41 +0000
Subject: [PATCH 0614/1164] Remove the superflous SocketBuffer from asyncio
 PythonParser (#2418)

* Remove buffering from asyncio SocketBuffer and rely on on the underlying StreamReader

* Skip the use of SocketBuffer in PythonParser

* Remove SocketBuffer altogether

* Code cleanup

* Fix unittest mocking when SocketBuffer is gone
---
 redis/asyncio/connection.py           | 170 ++++++--------------------
 tests/test_asyncio/test_connection.py |   9 +-
 2 files changed, 42 insertions(+), 137 deletions(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index bc0362e782..b64bd125eb 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -2,7 +2,6 @@
 import copy
 import enum
 import inspect
-import io
 import os
 import socket
 import ssl
@@ -141,7 +140,7 @@ def decode(self, value: EncodableT, force=False) -> EncodableT:
 class BaseParser:
     """Plain Python parsing class"""
 
-    __slots__ = "_stream", "_buffer", "_read_size"
+    __slots__ = "_stream", "_read_size"
 
     EXCEPTION_CLASSES: ExceptionMappingT = {
         "ERR": {
@@ -171,7 +170,6 @@ class BaseParser:
 
     def __init__(self, socket_read_size: int):
         self._stream: Optional[asyncio.StreamReader] = None
-        self._buffer: Optional[SocketBuffer] = None
         self._read_size = socket_read_size
 
     def __del__(self):
@@ -206,127 +204,6 @@ async def read_response(
         raise NotImplementedError()
 
 
-class SocketBuffer:
-    """Async-friendly re-impl of redis-py's SocketBuffer.
-
-    TODO: We're currently passing through two buffers,
-        the asyncio.StreamReader and this. I imagine we can reduce the layers here
-        while maintaining compliance with prior art.
-    """
-
-    def __init__(
-        self,
-        stream_reader: asyncio.StreamReader,
-        socket_read_size: int,
-    ):
-        self._stream: Optional[asyncio.StreamReader] = stream_reader
-        self.socket_read_size = socket_read_size
-        self._buffer: Optional[io.BytesIO] = io.BytesIO()
-        # number of bytes written to the buffer from the socket
-        self.bytes_written = 0
-        # number of bytes read from the buffer
-        self.bytes_read = 0
-
-    @property
-    def length(self):
-        return self.bytes_written - self.bytes_read
-
-    async def _read_from_socket(self, length: Optional[int] = None) -> bool:
-        buf = self._buffer
-        if buf is None or self._stream is None:
-            raise RedisError("Buffer is closed.")
-        buf.seek(self.bytes_written)
-        marker = 0
-
-        while True:
-            data = await self._stream.read(self.socket_read_size)
-            # an empty string indicates the server shutdown the socket
-            if isinstance(data, bytes) and len(data) == 0:
-                raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
-            buf.write(data)
-            data_length = len(data)
-            self.bytes_written += data_length
-            marker += data_length
-
-            if length is not None and length > marker:
-                continue
-            return True
-
-    async def can_read_destructive(self) -> bool:
-        if self.length:
-            return True
-        try:
-            async with async_timeout.timeout(0):
-                return await self._read_from_socket()
-        except asyncio.TimeoutError:
-            return False
-
-    async def read(self, length: int) -> bytes:
-        length = length + 2  # make sure to read the \r\n terminator
-        # make sure we've read enough data from the socket
-        if length > self.length:
-            await self._read_from_socket(length - self.length)
-
-        if self._buffer is None:
-            raise RedisError("Buffer is closed.")
-
-        self._buffer.seek(self.bytes_read)
-        data = self._buffer.read(length)
-        self.bytes_read += len(data)
-
-        # purge the buffer when we've consumed it all so it doesn't
-        # grow forever
-        if self.bytes_read == self.bytes_written:
-            self.purge()
-
-        return data[:-2]
-
-    async def readline(self) -> bytes:
-        buf = self._buffer
-        if buf is None:
-            raise RedisError("Buffer is closed.")
-
-        buf.seek(self.bytes_read)
-        data = buf.readline()
-        while not data.endswith(SYM_CRLF):
-            # there's more data in the socket that we need
-            await self._read_from_socket()
-            buf.seek(self.bytes_read)
-            data = buf.readline()
-
-        self.bytes_read += len(data)
-
-        # purge the buffer when we've consumed it all so it doesn't
-        # grow forever
-        if self.bytes_read == self.bytes_written:
-            self.purge()
-
-        return data[:-2]
-
-    def purge(self):
-        if self._buffer is None:
-            raise RedisError("Buffer is closed.")
-
-        self._buffer.seek(0)
-        self._buffer.truncate()
-        self.bytes_written = 0
-        self.bytes_read = 0
-
-    def close(self):
-        try:
-            self.purge()
-            self._buffer.close()
-        except Exception:
-            # issue #633 suggests the purge/close somehow raised a
-            # BadFileDescriptor error. Perhaps the client ran out of
-            # memory or something else? It's probably OK to ignore
-            # any error being raised from purge/close since we're
-            # removing the reference to the instance below.
-            pass
-        self._buffer = None
-        self._stream = None
-
-
 class PythonParser(BaseParser):
     """Plain Python parsing class"""
 
@@ -342,27 +219,29 @@ def on_connect(self, connection: "Connection"):
         if self._stream is None:
             raise RedisError("Buffer is closed.")
 
-        self._buffer = SocketBuffer(self._stream, self._read_size)
         self.encoder = connection.encoder
 
     def on_disconnect(self):
         """Called when the stream disconnects"""
         if self._stream is not None:
             self._stream = None
-        if self._buffer is not None:
-            self._buffer.close()
-            self._buffer = None
         self.encoder = None
 
-    async def can_read_destructive(self):
-        return self._buffer and bool(await self._buffer.can_read_destructive())
+    async def can_read_destructive(self) -> bool:
+        if self._stream is None:
+            raise RedisError("Buffer is closed.")
+        try:
+            async with async_timeout.timeout(0):
+                return await self._stream.read(1)
+        except asyncio.TimeoutError:
+            return False
 
     async def read_response(
         self, disable_decoding: bool = False
     ) -> Union[EncodableT, ResponseError, None]:
-        if not self._buffer or not self.encoder:
+        if not self._stream or not self.encoder:
             raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
-        raw = await self._buffer.readline()
+        raw = await self._readline()
         if not raw:
             raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
         response: Any
@@ -395,7 +274,7 @@ async def read_response(
             length = int(response)
             if length == -1:
                 return None
-            response = await self._buffer.read(length)
+            response = await self._read(length)
         # multi-bulk response
         elif byte == b"*":
             length = int(response)
@@ -408,6 +287,31 @@ async def read_response(
             response = self.encoder.decode(response)
         return response
 
+    async def _read(self, length: int) -> bytes:
+        """
+        Read `length` bytes of data.  These are assumed to be followed
+        by a '\r\n' terminator which is subsequently discarded.
+        """
+        if self._stream is None:
+            raise RedisError("Buffer is closed.")
+        try:
+            data = await self._stream.readexactly(length + 2)
+        except asyncio.IncompleteReadError as error:
+            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR) from error
+        return data[:-2]
+
+    async def _readline(self) -> bytes:
+        """
+        read an unknown number of bytes up to the next '\r\n'
+        line separator, which is discarded.
+        """
+        if self._stream is None:
+            raise RedisError("Buffer is closed.")
+        data = await self._stream.readline()
+        if not data.endswith(b"\r\n"):
+            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
+        return data[:-2]
+
 
 class HiredisParser(BaseParser):
     """Parser class for connections using Hiredis"""
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index 674a1b9980..6bf0034146 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -13,22 +13,23 @@
 from redis.asyncio.retry import Retry
 from redis.backoff import NoBackoff
 from redis.exceptions import ConnectionError, InvalidResponse, TimeoutError
-from redis.utils import HIREDIS_AVAILABLE
 from tests.conftest import skip_if_server_version_lt
 
 from .compat import mock
 
 
 @pytest.mark.onlynoncluster
-@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 async def test_invalid_response(create_redis):
     r = await create_redis(single_connection_client=True)
 
     raw = b"x"
-    readline_mock = mock.AsyncMock(return_value=raw)
 
     parser: "PythonParser" = r.connection._parser
-    with mock.patch.object(parser._buffer, "readline", readline_mock):
+    if not isinstance(parser, PythonParser):
+        pytest.skip("PythonParser only")
+    stream_mock = mock.Mock(parser._stream)
+    stream_mock.readline.return_value = raw + b"\r\n"
+    with mock.patch.object(parser, "_stream", stream_mock):
         with pytest.raises(InvalidResponse) as cm:
             await parser.read_response()
     assert str(cm.value) == f"Protocol Error: {raw!r}"

From ab922dbf3c7544fab4fe6247e1f3d57958ffd767 Mon Sep 17 00:00:00 2001
From: Robert Hofer <1058012+hofrob@users.noreply.github.com>
Date: Mon, 7 Nov 2022 08:20:54 +0100
Subject: [PATCH 0615/1164] fix docs for password protected socket access
 (#2378)

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 CHANGES                     | 1 +
 redis/asyncio/client.py     | 2 +-
 redis/asyncio/connection.py | 2 +-
 redis/client.py             | 2 +-
 redis/cluster.py            | 2 +-
 redis/connection.py         | 2 +-
 6 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/CHANGES b/CHANGES
index f5c267bdda..80423cc126 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Documentation fix: password protected socket connection (#2374)
     * Allow `timeout=None` in `PubSub.get_message()` to wait forever
     * add `nowait` flag to `asyncio.Connection.disconnect()`
     * Update README.md links
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 0e40ed70f8..6e66faa4f9 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -106,7 +106,7 @@ def from_url(cls, url: str, **kwargs):
 
             redis://[[username]:[password]]@localhost:6379/0
             rediss://[[username]:[password]]@localhost:6379/0
-            unix://[[username]:[password]]@/path/to/socket.sock?db=0
+            unix://[username@]/path/to/socket.sock?db=0[&password=password]
 
         Three URL schemes are supported:
 
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index b64bd125eb..1288bb6738 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -1194,7 +1194,7 @@ def from_url(cls: Type[_CP], url: str, **kwargs) -> _CP:
 
             redis://[[username]:[password]]@localhost:6379/0
             rediss://[[username]:[password]]@localhost:6379/0
-            unix://[[username]:[password]]@/path/to/socket.sock?db=0
+            unix://[username@]/path/to/socket.sock?db=0[&password=password]
 
         Three URL schemes are supported:
 
diff --git a/redis/client.py b/redis/client.py
index 75a0dac226..c1fe9cb5fd 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -863,7 +863,7 @@ def from_url(cls, url, **kwargs):
 
             redis://[[username]:[password]]@localhost:6379/0
             rediss://[[username]:[password]]@localhost:6379/0
-            unix://[[username]:[password]]@/path/to/socket.sock?db=0
+            unix://[username@]/path/to/socket.sock?db=0[&password=password]
 
         Three URL schemes are supported:
 
diff --git a/redis/cluster.py b/redis/cluster.py
index cee578b075..cb3b2a6c04 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -388,7 +388,7 @@ def from_url(cls, url, **kwargs):
 
             redis://[[username]:[password]]@localhost:6379/0
             rediss://[[username]:[password]]@localhost:6379/0
-            unix://[[username]:[password]]@/path/to/socket.sock?db=0
+            unix://[username@]/path/to/socket.sock?db=0[&password=password]
 
         Three URL schemes are supported:
 
diff --git a/redis/connection.py b/redis/connection.py
index 2e33e31d2f..fecb06b099 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1221,7 +1221,7 @@ def from_url(cls, url, **kwargs):
 
             redis://[[username]:[password]]@localhost:6379/0
             rediss://[[username]:[password]]@localhost:6379/0
-            unix://[[username]:[password]]@/path/to/socket.sock?db=0
+            unix://[username@]/path/to/socket.sock?db=0[&password=password]
 
         Three URL schemes are supported:
 

From 1cdba6302c694e2d0aaca1e336185217fdc1c136 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 8 Nov 2022 15:24:09 +0200
Subject: [PATCH 0616/1164] 4.4.0-rc3 (#2447)

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index befa9dc131..745d71ba92 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.4.0rc2",
+    version="4.4.0rc3",
     packages=find_packages(
         include=[
             "redis",

From 772079fabd7453edf3788d0c31b9caf21ff5deca Mon Sep 17 00:00:00 2001
From: Milhan <kimmilhan@gmail.com>
Date: Wed, 9 Nov 2022 21:22:05 +0900
Subject: [PATCH 0617/1164] Enable AsyncIO cluster mode lock (#2446)

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 CHANGES                         |  1 +
 redis/asyncio/cluster.py        | 67 +++++++++++++++++++++++++++++++++
 redis/asyncio/lock.py           | 16 ++++++--
 redis/commands/core.py          | 12 +++++-
 tests/test_asyncio/test_lock.py |  1 -
 5 files changed, 90 insertions(+), 7 deletions(-)

diff --git a/CHANGES b/CHANGES
index 80423cc126..7bdfacf9c7 100644
--- a/CHANGES
+++ b/CHANGES
@@ -24,6 +24,7 @@
     * ClusterPipeline Doesn't Handle ConnectionError for Dead Hosts (#2225)
     * Remove compatibility code for old versions of Hiredis, drop Packaging dependency
     * The `deprecated` library is no longer a dependency
+    * Enable Lock for asyncio cluster mode
 
 * 4.1.3 (Feb 8, 2022)
     * Fix flushdb and flushall (#1926)
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 8d34b9ad21..8abb072082 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -24,6 +24,7 @@
     SSLConnection,
     parse_url,
 )
+from redis.asyncio.lock import Lock
 from redis.asyncio.parser import CommandsParser
 from redis.client import EMPTY_RESPONSE, NEVER_DECODE, AbstractRedis
 from redis.cluster import (
@@ -764,6 +765,72 @@ def pipeline(
 
         return ClusterPipeline(self)
 
+    def lock(
+        self,
+        name: KeyT,
+        timeout: Optional[float] = None,
+        sleep: float = 0.1,
+        blocking_timeout: Optional[float] = None,
+        lock_class: Optional[Type[Lock]] = None,
+        thread_local: bool = True,
+    ) -> Lock:
+        """
+        Return a new Lock object using key ``name`` that mimics
+        the behavior of threading.Lock.
+
+        If specified, ``timeout`` indicates a maximum life for the lock.
+        By default, it will remain locked until release() is called.
+
+        ``sleep`` indicates the amount of time to sleep per loop iteration
+        when the lock is in blocking mode and another client is currently
+        holding the lock.
+
+        ``blocking_timeout`` indicates the maximum amount of time in seconds to
+        spend trying to acquire the lock. A value of ``None`` indicates
+        continue trying forever. ``blocking_timeout`` can be specified as a
+        float or integer, both representing the number of seconds to wait.
+
+        ``lock_class`` forces the specified lock implementation. Note that as
+        of redis-py 3.0, the only lock class we implement is ``Lock`` (which is
+        a Lua-based lock). So, it's unlikely you'll need this parameter, unless
+        you have created your own custom lock class.
+
+        ``thread_local`` indicates whether the lock token is placed in
+        thread-local storage. By default, the token is placed in thread local
+        storage so that a thread only sees its token, not a token set by
+        another thread. Consider the following timeline:
+
+            time: 0, thread-1 acquires `my-lock`, with a timeout of 5 seconds.
+                     thread-1 sets the token to "abc"
+            time: 1, thread-2 blocks trying to acquire `my-lock` using the
+                     Lock instance.
+            time: 5, thread-1 has not yet completed. redis expires the lock
+                     key.
+            time: 5, thread-2 acquired `my-lock` now that it's available.
+                     thread-2 sets the token to "xyz"
+            time: 6, thread-1 finishes its work and calls release(). if the
+                     token is *not* stored in thread local storage, then
+                     thread-1 would see the token value as "xyz" and would be
+                     able to successfully release the thread-2's lock.
+
+        In some use cases it's necessary to disable thread local storage. For
+        example, if you have code where one thread acquires a lock and passes
+        that lock instance to a worker thread to release later. If thread
+        local storage isn't disabled in this case, the worker thread won't see
+        the token set by the thread that acquired the lock. Our assumption
+        is that these cases aren't common and as such default to using
+        thread local storage."""
+        if lock_class is None:
+            lock_class = Lock
+        return lock_class(
+            self,
+            name,
+            timeout=timeout,
+            sleep=sleep,
+            blocking_timeout=blocking_timeout,
+            thread_local=thread_local,
+        )
+
 
 class ClusterNode:
     """
diff --git a/redis/asyncio/lock.py b/redis/asyncio/lock.py
index 8ede59b146..7f45c8be66 100644
--- a/redis/asyncio/lock.py
+++ b/redis/asyncio/lock.py
@@ -7,7 +7,7 @@
 from redis.exceptions import LockError, LockNotOwnedError
 
 if TYPE_CHECKING:
-    from redis.asyncio import Redis
+    from redis.asyncio import Redis, RedisCluster
 
 
 class Lock:
@@ -77,7 +77,7 @@ class Lock:
 
     def __init__(
         self,
-        redis: "Redis",
+        redis: Union["Redis", "RedisCluster"],
         name: Union[str, bytes, memoryview],
         timeout: Optional[float] = None,
         sleep: float = 0.1,
@@ -189,7 +189,11 @@ async def acquire(
         if token is None:
             token = uuid.uuid1().hex.encode()
         else:
-            encoder = self.redis.connection_pool.get_encoder()
+            try:
+                encoder = self.redis.connection_pool.get_encoder()
+            except AttributeError:
+                # Cluster
+                encoder = self.redis.get_encoder()
             token = encoder.encode(token)
         if blocking is None:
             blocking = self.blocking
@@ -233,7 +237,11 @@ async def owned(self) -> bool:
         # need to always compare bytes to bytes
         # TODO: this can be simplified when the context manager is finished
         if stored_token and not isinstance(stored_token, bytes):
-            encoder = self.redis.connection_pool.get_encoder()
+            try:
+                encoder = self.redis.connection_pool.get_encoder()
+            except AttributeError:
+                # Cluster
+                encoder = self.redis.get_encoder()
             stored_token = encoder.encode(stored_token)
         return self.local.token is not None and stored_token == self.local.token
 
diff --git a/redis/commands/core.py b/redis/commands/core.py
index c245a7a8e2..3be2823a7a 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -4930,7 +4930,11 @@ def __init__(self, registered_client: "Redis", script: ScriptTextT):
         if isinstance(script, str):
             # We need the encoding from the client in order to generate an
             # accurate byte representation of the script
-            encoder = registered_client.connection_pool.get_encoder()
+            try:
+                encoder = registered_client.connection_pool.get_encoder()
+            except AttributeError:
+                # Cluster
+                encoder = registered_client.get_encoder()
             script = encoder.encode(script)
         self.sha = hashlib.sha1(script).hexdigest()
 
@@ -4975,7 +4979,11 @@ def __init__(self, registered_client: "AsyncRedis", script: ScriptTextT):
         if isinstance(script, str):
             # We need the encoding from the client in order to generate an
             # accurate byte representation of the script
-            encoder = registered_client.connection_pool.get_encoder()
+            try:
+                encoder = registered_client.connection_pool.get_encoder()
+            except AttributeError:
+                # Cluster
+                encoder = registered_client.get_encoder()
             script = encoder.encode(script)
         self.sha = hashlib.sha1(script).hexdigest()
 
diff --git a/tests/test_asyncio/test_lock.py b/tests/test_asyncio/test_lock.py
index 09aec75194..56387fa954 100644
--- a/tests/test_asyncio/test_lock.py
+++ b/tests/test_asyncio/test_lock.py
@@ -7,7 +7,6 @@
 from redis.exceptions import LockError, LockNotOwnedError
 
 
-@pytest.mark.onlynoncluster
 class TestLock:
     @pytest_asyncio.fixture()
     async def r_decoded(self, create_redis):

From fb647430f00cc7bb67c978e75f2dabc661567779 Mon Sep 17 00:00:00 2001
From: Shay Fadida <shayfadida@gmail.com>
Date: Wed, 9 Nov 2022 14:22:27 +0200
Subject: [PATCH 0618/1164] Fix special response parsing options handling
 (#2302)

* Fix special response parsing options handling

When using special response parsing options like `NEVER_DECODE` and
`EMPTY_RESPONSE`, don't pass them to the response callbacks because some
of them are not prepared for receiving named arguments.

Instead, redis-py should use them before calling the callbacks and
then discard them.

* Use kwargs instead of options

* change options to kwargs in asyncio/cluster.py/L878

Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/asyncio/client.py             |  5 +++++
 redis/asyncio/cluster.py            |  4 ++++
 redis/client.py                     |  5 +++++
 tests/test_asyncio/test_commands.py | 12 +++++++++++-
 tests/test_commands.py              | 12 +++++++++++-
 5 files changed, 36 insertions(+), 2 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 6e66faa4f9..619ee1114d 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -501,12 +501,17 @@ async def parse_response(
         try:
             if NEVER_DECODE in options:
                 response = await connection.read_response(disable_decoding=True)
+                options.pop(NEVER_DECODE)
             else:
                 response = await connection.read_response()
         except ResponseError:
             if EMPTY_RESPONSE in options:
                 return options[EMPTY_RESPONSE]
             raise
+
+        if EMPTY_RESPONSE in options:
+            options.pop(EMPTY_RESPONSE)
+
         if command_name in self.response_callbacks:
             # Mypy bug: https://github.com/python/mypy/issues/10977
             command_name = cast(str, command_name)
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 8abb072082..97f41518f4 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -934,6 +934,7 @@ async def parse_response(
         try:
             if NEVER_DECODE in kwargs:
                 response = await connection.read_response(disable_decoding=True)
+                kwargs.pop(NEVER_DECODE)
             else:
                 response = await connection.read_response()
         except ResponseError:
@@ -941,6 +942,9 @@ async def parse_response(
                 return kwargs[EMPTY_RESPONSE]
             raise
 
+        if EMPTY_RESPONSE in kwargs:
+            kwargs.pop(EMPTY_RESPONSE)
+
         # Return response
         if command in self.response_callbacks:
             return self.response_callbacks[command](response, **kwargs)
diff --git a/redis/client.py b/redis/client.py
index c1fe9cb5fd..6a26d28946 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1258,12 +1258,17 @@ def parse_response(self, connection, command_name, **options):
         try:
             if NEVER_DECODE in options:
                 response = connection.read_response(disable_decoding=True)
+                options.pop(NEVER_DECODE)
             else:
                 response = connection.read_response()
         except ResponseError:
             if EMPTY_RESPONSE in options:
                 return options[EMPTY_RESPONSE]
             raise
+
+        if EMPTY_RESPONSE in options:
+            options.pop(EMPTY_RESPONSE)
+
         if command_name in self.response_callbacks:
             return self.response_callbacks[command_name](response, **options)
         return response
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 1242e04679..67471bb4b3 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -11,7 +11,7 @@
 
 import redis
 from redis import exceptions
-from redis.client import parse_info
+from redis.client import EMPTY_RESPONSE, NEVER_DECODE, parse_info
 from tests.conftest import (
     skip_if_server_version_gte,
     skip_if_server_version_lt,
@@ -542,6 +542,16 @@ async def test_time(self, r: redis.Redis):
         assert isinstance(t[0], int)
         assert isinstance(t[1], int)
 
+    async def test_never_decode_option(self, r: redis.Redis):
+        opts = {NEVER_DECODE: []}
+        await r.delete("a")
+        assert await r.execute_command("EXISTS", "a", **opts) == 0
+
+    async def test_empty_response_option(self, r: redis.Redis):
+        opts = {EMPTY_RESPONSE: []}
+        await r.delete("a")
+        assert await r.execute_command("EXISTS", "a", **opts) == 0
+
     # BASIC KEY COMMANDS
     async def test_append(self, r: redis.Redis):
         assert await r.append("a", "a1") == 2
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 1c9a5c27eb..aa6745b34b 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -9,7 +9,7 @@
 
 import redis
 from redis import exceptions
-from redis.client import parse_info
+from redis.client import EMPTY_RESPONSE, NEVER_DECODE, parse_info
 
 from .conftest import (
     _get_client,
@@ -917,6 +917,16 @@ def test_bgsave(self, r):
         time.sleep(0.3)
         assert r.bgsave(True)
 
+    def test_never_decode_option(self, r: redis.Redis):
+        opts = {NEVER_DECODE: []}
+        r.delete("a")
+        assert r.execute_command("EXISTS", "a", **opts) == 0
+
+    def test_empty_response_option(self, r: redis.Redis):
+        opts = {EMPTY_RESPONSE: []}
+        r.delete("a")
+        assert r.execute_command("EXISTS", "a", **opts) == 0
+
     # BASIC KEY COMMANDS
     def test_append(self, r):
         assert r.append("a", "a1") == 2

From bb06ccd52924800ac501d17c8a42038c8e5c5770 Mon Sep 17 00:00:00 2001
From: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Date: Thu, 10 Nov 2022 12:38:47 +0200
Subject: [PATCH 0619/1164] CredentialsProvider class added to support password
 rotation (#2261)

* A CredentialsProvider class has been added to allow the user to add his own provider for password rotation

* Moved CredentialsProvider to a separate file, added type hints

* Changed username and password to properties

* Added: StaticCredentialProvider, examples, tests
Changed: CredentialsProvider to CredentialProvider
Fixed: calling AUTH only with password

* Changed private members' prefix to __

* fixed linters

* fixed auth test

* fixed credential test

* Raise an error if username or password are passed along with credential_provider

* fixing linters

* fixing test

* Changed dundered to single per side underscore

* Changed Connection class members username and password to properties to enable backward compatibility with changing the members value on existing connection.

* Reverting last commit and adding backward compatibility to 'username' and 'password' inside on_connect function

* Refactored CredentialProvider class

* Fixing tuple type to Tuple

* Fixing optional string members in UsernamePasswordCredentialProvider

* Fixed credential test

* Added credential provider support to AsyncRedis

* linters

* linters

* linters

* linters - black

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
Co-authored-by: dvora-h <dvora.heller@redis.com>
---
 CHANGES                                 |   1 +
 docs/examples/asyncio_examples.ipynb    | 129 ++++++-----
 docs/examples/connection_examples.ipynb | 193 +++++++++++++++-
 redis/__init__.py                       |   3 +
 redis/asyncio/client.py                 |   3 +
 redis/asyncio/cluster.py                |   3 +
 redis/asyncio/connection.py             |  41 +++-
 redis/client.py                         |   4 +
 redis/cluster.py                        |   1 +
 redis/connection.py                     |  39 +++-
 redis/credentials.py                    |  26 +++
 tests/test_asyncio/test_credentials.py  | 284 ++++++++++++++++++++++++
 tests/test_credentials.py               | 245 ++++++++++++++++++++
 13 files changed, 898 insertions(+), 74 deletions(-)
 create mode 100644 redis/credentials.py
 create mode 100644 tests/test_asyncio/test_credentials.py
 create mode 100644 tests/test_credentials.py

diff --git a/CHANGES b/CHANGES
index 7bdfacf9c7..4945f61612 100644
--- a/CHANGES
+++ b/CHANGES
@@ -24,6 +24,7 @@
     * ClusterPipeline Doesn't Handle ConnectionError for Dead Hosts (#2225)
     * Remove compatibility code for old versions of Hiredis, drop Packaging dependency
     * The `deprecated` library is no longer a dependency
+    * Added CredentialsProvider class to support password rotation
     * Enable Lock for asyncio cluster mode
 
 * 4.1.3 (Feb 8, 2022)
diff --git a/docs/examples/asyncio_examples.ipynb b/docs/examples/asyncio_examples.ipynb
index dab7a96ae9..855255c88d 100644
--- a/docs/examples/asyncio_examples.ipynb
+++ b/docs/examples/asyncio_examples.ipynb
@@ -21,11 +21,6 @@
   {
    "cell_type": "code",
    "execution_count": 1,
-   "metadata": {
-    "pycharm": {
-     "name": "#%%\n"
-    }
-   },
    "outputs": [
     {
      "name": "stdout",
@@ -41,27 +36,29 @@
     "connection = redis.Redis()\n",
     "print(f\"Ping successful: {await connection.ping()}\")\n",
     "await connection.close()"
-   ]
+   ],
+   "metadata": {
+    "collapsed": false,
+    "pycharm": {
+     "name": "#%%\n"
+    }
+   }
   },
   {
    "cell_type": "markdown",
+   "source": [
+    "If you supply a custom `ConnectionPool` that is supplied to several `Redis` instances, you may want to disconnect the connection pool explicitly. Disconnecting the connection pool simply disconnects all connections hosted in the pool."
+   ],
    "metadata": {
+    "collapsed": false,
     "pycharm": {
      "name": "#%% md\n"
     }
-   },
-   "source": [
-    "If you supply a custom `ConnectionPool` that is supplied to several `Redis` instances, you may want to disconnect the connection pool explicitly. Disconnecting the connection pool simply disconnects all connections hosted in the pool."
-   ]
+   }
   },
   {
    "cell_type": "code",
    "execution_count": 2,
-   "metadata": {
-    "pycharm": {
-     "name": "#%%\n"
-    }
-   },
    "outputs": [],
    "source": [
     "import redis.asyncio as redis\n",
@@ -70,15 +67,16 @@
     "await connection.close()\n",
     "# Or: await connection.close(close_connection_pool=False)\n",
     "await connection.connection_pool.disconnect()"
-   ]
-  },
-  {
-   "cell_type": "markdown",
+   ],
    "metadata": {
+    "collapsed": false,
     "pycharm": {
-     "name": "#%% md\n"
+     "name": "#%%\n"
     }
-   },
+   }
+  },
+  {
+   "cell_type": "markdown",
    "source": [
     "## Transactions (Multi/Exec)\n",
     "\n",
@@ -87,16 +85,17 @@
     "The commands will not be reflected in Redis until execute() is called & awaited.\n",
     "\n",
     "Usually, when performing a bulk operation, taking advantage of a “transaction” (e.g., Multi/Exec) is to be desired, as it will also add a layer of atomicity to your bulk operation."
-   ]
+   ],
+   "metadata": {
+    "collapsed": false,
+    "pycharm": {
+     "name": "#%% md\n"
+    }
+   }
   },
   {
    "cell_type": "code",
    "execution_count": 3,
-   "metadata": {
-    "pycharm": {
-     "name": "#%%\n"
-    }
-   },
    "outputs": [],
    "source": [
     "import redis.asyncio as redis\n",
@@ -106,25 +105,31 @@
     "    ok1, ok2 = await (pipe.set(\"key1\", \"value1\").set(\"key2\", \"value2\").execute())\n",
     "assert ok1\n",
     "assert ok2"
-   ]
+   ],
+   "metadata": {
+    "collapsed": false,
+    "pycharm": {
+     "name": "#%%\n"
+    }
+   }
   },
   {
    "cell_type": "markdown",
-   "metadata": {},
    "source": [
     "## Pub/Sub Mode\n",
     "\n",
     "Subscribing to specific channels:"
-   ]
+   ],
+   "metadata": {
+    "collapsed": false,
+    "pycharm": {
+     "name": "#%% md\n"
+    }
+   }
   },
   {
    "cell_type": "code",
    "execution_count": 4,
-   "metadata": {
-    "pycharm": {
-     "name": "#%%\n"
-    }
-   },
    "outputs": [
     {
      "name": "stdout",
@@ -165,23 +170,29 @@
     "    await r.publish(\"channel:1\", STOPWORD)\n",
     "\n",
     "    await future"
-   ]
+   ],
+   "metadata": {
+    "collapsed": false,
+    "pycharm": {
+     "name": "#%%\n"
+    }
+   }
   },
   {
    "cell_type": "markdown",
-   "metadata": {},
    "source": [
     "Subscribing to channels matching a glob-style pattern:"
-   ]
+   ],
+   "metadata": {
+    "collapsed": false,
+    "pycharm": {
+     "name": "#%% md\n"
+    }
+   }
   },
   {
    "cell_type": "code",
    "execution_count": 5,
-   "metadata": {
-    "pycharm": {
-     "name": "#%%\n"
-    }
-   },
    "outputs": [
     {
      "name": "stdout",
@@ -223,11 +234,16 @@
     "    await r.publish(\"channel:1\", STOPWORD)\n",
     "\n",
     "    await future"
-   ]
+   ],
+   "metadata": {
+    "collapsed": false,
+    "pycharm": {
+     "name": "#%%\n"
+    }
+   }
   },
   {
    "cell_type": "markdown",
-   "metadata": {},
    "source": [
     "## Sentinel Client\n",
     "\n",
@@ -236,16 +252,17 @@
     "Calling aioredis.sentinel.Sentinel.master_for or aioredis.sentinel.Sentinel.slave_for methods will return Redis clients connected to specified services monitored by Sentinel.\n",
     "\n",
     "Sentinel client will detect failover and reconnect Redis clients automatically."
-   ]
+   ],
+   "metadata": {
+    "collapsed": false,
+    "pycharm": {
+     "name": "#%% md\n"
+    }
+   }
   },
   {
    "cell_type": "code",
    "execution_count": null,
-   "metadata": {
-    "pycharm": {
-     "name": "#%%\n"
-    }
-   },
    "outputs": [],
    "source": [
     "import asyncio\n",
@@ -260,7 +277,13 @@
     "assert ok\n",
     "val = await r.get(\"key\")\n",
     "assert val == b\"value\""
-   ]
+   ],
+   "metadata": {
+    "collapsed": false,
+    "pycharm": {
+     "name": "#%%\n"
+    }
+   }
   }
  ],
  "metadata": {
@@ -284,4 +307,4 @@
  },
  "nbformat": 4,
  "nbformat_minor": 1
-}
+}
\ No newline at end of file
diff --git a/docs/examples/connection_examples.ipynb b/docs/examples/connection_examples.ipynb
index b0084ff055..ca8dd443c6 100644
--- a/docs/examples/connection_examples.ipynb
+++ b/docs/examples/connection_examples.ipynb
@@ -97,6 +97,197 @@
     "user_connection.ping()"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "source": [
+    "## Connecting to a redis instance with username and password credential provider"
+   ],
+   "metadata": {}
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "outputs": [],
+   "source": [
+    "import redis\n",
+    "\n",
+    "creds_provider = redis.UsernamePasswordCredentialProvider(\"username\", \"password\")\n",
+    "user_connection = redis.Redis(host=\"localhost\", port=6379, credential_provider=creds_provider)\n",
+    "user_connection.ping()"
+   ],
+   "metadata": {}
+   }
+  },
+  {
+   "cell_type": "markdown",
+   "source": [
+    "## Connecting to a redis instance with standard credential provider"
+   ],
+   "metadata": {}
+   }
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "outputs": [],
+   "source": [
+    "from typing import Tuple\n",
+    "import redis\n",
+    "\n",
+    "creds_map = {\"user_1\": \"pass_1\",\n",
+    "             \"user_2\": \"pass_2\"}\n",
+    "\n",
+    "class UserMapCredentialProvider(redis.CredentialProvider):\n",
+    "    def __init__(self, username: str):\n",
+    "        self.username = username\n",
+    "\n",
+    "    def get_credentials(self) -> Tuple[str, str]:\n",
+    "        return self.username, creds_map.get(self.username)\n",
+    "\n",
+    "# Create a default connection to set the ACL user\n",
+    "default_connection = redis.Redis(host=\"localhost\", port=6379)\n",
+    "default_connection.acl_setuser(\n",
+    "    \"user_1\",\n",
+    "    enabled=True,\n",
+    "    passwords=[\"+\" + \"pass_1\"],\n",
+    "    keys=\"~*\",\n",
+    "    commands=[\"+ping\", \"+command\", \"+info\", \"+select\", \"+flushdb\"],\n",
+    ")\n",
+    "\n",
+    "# Create a UserMapCredentialProvider instance for user_1\n",
+    "creds_provider = UserMapCredentialProvider(\"user_1\")\n",
+    "# Initiate user connection with the credential provider\n",
+    "user_connection = redis.Redis(host=\"localhost\", port=6379,\n",
+    "                              credential_provider=creds_provider)\n",
+    "user_connection.ping()"
+   ],
+   "metadata": {}
+   }
+  },
+  {
+   "cell_type": "markdown",
+   "source": [
+    "## Connecting to a redis instance first with an initial credential set and then calling the credential provider"
+   ],
+   "metadata": {}
+   }
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "outputs": [],
+   "source": [
+    "from typing import Union\n",
+    "import redis\n",
+    "\n",
+    "class InitCredsSetCredentialProvider(redis.CredentialProvider):\n",
+    "    def __init__(self, username, password):\n",
+    "        self.username = username\n",
+    "        self.password = password\n",
+    "        self.call_supplier = False\n",
+    "\n",
+    "    def call_external_supplier(self) -> Union[Tuple[str], Tuple[str, str]]:\n",
+    "        # Call to an external credential supplier\n",
+    "        raise NotImplementedError\n",
+    "\n",
+    "    def get_credentials(self) -> Union[Tuple[str], Tuple[str, str]]:\n",
+    "        if self.call_supplier:\n",
+    "            return self.call_external_supplier()\n",
+    "        # Use the init set only for the first time\n",
+    "        self.call_supplier = True\n",
+    "        return self.username, self.password\n",
+    "\n",
+    "cred_provider = InitCredsSetCredentialProvider(username=\"init_user\", password=\"init_pass\")"
+   ],
+   "metadata": {}
+   }
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "collapsed": false
+   },
+   "source": [
+    "## Connecting to a redis instance with AWS Secrets Manager credential provider."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "collapsed": false,
+    "pycharm": {
+     "name": "#%%\n"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "import redis\n",
+    "import boto3\n",
+    "import json\n",
+    "import cachetools.func\n",
+    "\n",
+    "sm_client = boto3.client('secretsmanager')\n",
+    "  \n",
+    "def sm_auth_provider(self, secret_id, version_id=None, version_stage='AWSCURRENT'):\n",
+    "    @cachetools.func.ttl_cache(maxsize=128, ttl=24 * 60 * 60) #24h\n",
+    "    def get_sm_user_credentials(secret_id, version_id, version_stage):\n",
+    "        secret = sm_client.get_secret_value(secret_id, version_id)\n",
+    "        return json.loads(secret['SecretString'])\n",
+    "    creds = get_sm_user_credentials(secret_id, version_id, version_stage)\n",
+    "    return creds['username'], creds['password']\n",
+    "\n",
+    "secret_id = \"EXAMPLE1-90ab-cdef-fedc-ba987SECRET1\"\n",
+    "creds_provider = redis.CredentialProvider(supplier=sm_auth_provider, secret_id=secret_id)\n",
+    "user_connection = redis.Redis(host=\"localhost\", port=6379, credential_provider=creds_provider)\n",
+    "user_connection.ping()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Connecting to a redis instance with ElastiCache IAM credential provider."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 4,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "import redis\n",
+    "import boto3\n",
+    "import cachetools.func\n",
+    "\n",
+    "ec_client = boto3.client('elasticache')\n",
+    "\n",
+    "def iam_auth_provider(self, user, endpoint, port=6379, region=\"us-east-1\"):\n",
+    "    @cachetools.func.ttl_cache(maxsize=128, ttl=15 * 60) # 15m\n",
+    "    def get_iam_auth_token(user, endpoint, port, region):\n",
+    "        return ec_client.generate_iam_auth_token(user, endpoint, port, region)\n",
+    "    iam_auth_token = get_iam_auth_token(endpoint, port, user, region)\n",
+    "    return iam_auth_token\n",
+    "\n",
+    "username = \"barshaul\"\n",
+    "endpoint = \"test-001.use1.cache.amazonaws.com\"\n",
+    "creds_provider = redis.CredentialProvider(supplier=iam_auth_provider, user=username,\n",
+    "                                           endpoint=endpoint)\n",
+    "user_connection = redis.Redis(host=endpoint, port=6379, credential_provider=creds_provider)\n",
+    "user_connection.ping()"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},
@@ -176,4 +367,4 @@
  },
  "nbformat": 4,
  "nbformat_minor": 2
-}
+}
\ No newline at end of file
diff --git a/redis/__init__.py b/redis/__init__.py
index b7560a6715..5201fe22d4 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -9,6 +9,7 @@
     SSLConnection,
     UnixDomainSocketConnection,
 )
+from redis.credentials import CredentialProvider, UsernamePasswordCredentialProvider
 from redis.exceptions import (
     AuthenticationError,
     AuthenticationWrongNumberOfArgsError,
@@ -62,6 +63,7 @@ def int_or_str(value):
     "Connection",
     "ConnectionError",
     "ConnectionPool",
+    "CredentialProvider",
     "DataError",
     "from_url",
     "InvalidResponse",
@@ -76,6 +78,7 @@ def int_or_str(value):
     "SentinelManagedConnection",
     "SentinelManagedSSLConnection",
     "SSLConnection",
+    "UsernamePasswordCredentialProvider",
     "StrictRedis",
     "TimeoutError",
     "UnixDomainSocketConnection",
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 619ee1114d..c0855717f2 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -46,6 +46,7 @@
     list_or_args,
 )
 from redis.compat import Protocol, TypedDict
+from redis.credentials import CredentialProvider
 from redis.exceptions import (
     ConnectionError,
     ExecAbortError,
@@ -174,6 +175,7 @@ def __init__(
         retry: Optional[Retry] = None,
         auto_close_connection_pool: bool = True,
         redis_connect_func=None,
+        credential_provider: Optional[CredentialProvider] = None,
     ):
         """
         Initialize a new Redis client.
@@ -199,6 +201,7 @@ def __init__(
                 "db": db,
                 "username": username,
                 "password": password,
+                "credential_provider": credential_provider,
                 "socket_timeout": socket_timeout,
                 "encoding": encoding,
                 "encoding_errors": encoding_errors,
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 97f41518f4..57aafbd69f 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -40,6 +40,7 @@
 )
 from redis.commands import READ_COMMANDS, AsyncRedisClusterCommands
 from redis.crc import REDIS_CLUSTER_HASH_SLOTS, key_slot
+from redis.credentials import CredentialProvider
 from redis.exceptions import (
     AskError,
     BusyLoadingError,
@@ -220,6 +221,7 @@ def __init__(
         # Client related kwargs
         db: Union[str, int] = 0,
         path: Optional[str] = None,
+        credential_provider: Optional[CredentialProvider] = None,
         username: Optional[str] = None,
         password: Optional[str] = None,
         client_name: Optional[str] = None,
@@ -266,6 +268,7 @@ def __init__(
             "connection_class": Connection,
             "parser_class": ClusterParser,
             # Client related kwargs
+            "credential_provider": credential_provider,
             "username": username,
             "password": password,
             "client_name": client_name,
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 1288bb6738..df066c4763 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -29,6 +29,7 @@
 from redis.asyncio.retry import Retry
 from redis.backoff import NoBackoff
 from redis.compat import Protocol, TypedDict
+from redis.credentials import CredentialProvider, UsernamePasswordCredentialProvider
 from redis.exceptions import (
     AuthenticationError,
     AuthenticationWrongNumberOfArgsError,
@@ -416,6 +417,7 @@ class Connection:
         "db",
         "username",
         "client_name",
+        "credential_provider",
         "password",
         "socket_timeout",
         "socket_connect_timeout",
@@ -465,14 +467,23 @@ def __init__(
         retry: Optional[Retry] = None,
         redis_connect_func: Optional[ConnectCallbackT] = None,
         encoder_class: Type[Encoder] = Encoder,
+        credential_provider: Optional[CredentialProvider] = None,
     ):
+        if (username or password) and credential_provider is not None:
+            raise DataError(
+                "'username' and 'password' cannot be passed along with 'credential_"
+                "provider'. Please provide only one of the following arguments: \n"
+                "1. 'password' and (optional) 'username'\n"
+                "2. 'credential_provider'"
+            )
         self.pid = os.getpid()
         self.host = host
         self.port = int(port)
         self.db = db
-        self.username = username
         self.client_name = client_name
+        self.credential_provider = credential_provider
         self.password = password
+        self.username = username
         self.socket_timeout = socket_timeout
         self.socket_connect_timeout = socket_connect_timeout or socket_timeout or None
         self.socket_keepalive = socket_keepalive
@@ -637,14 +648,13 @@ async def on_connect(self) -> None:
         """Initialize the connection, authenticate and select a database"""
         self._parser.on_connect(self)
 
-        # if username and/or password are set, authenticate
-        if self.username or self.password:
-            auth_args: Union[Tuple[str], Tuple[str, str]]
-            if self.username:
-                auth_args = (self.username, self.password or "")
-            else:
-                # Mypy bug: https://github.com/python/mypy/issues/10944
-                auth_args = (self.password or "",)
+        # if credential provider or username and/or password are set, authenticate
+        if self.credential_provider or (self.username or self.password):
+            cred_provider = (
+                self.credential_provider
+                or UsernamePasswordCredentialProvider(self.username, self.password)
+            )
+            auth_args = cred_provider.get_credentials()
             # avoid checking health here -- PING will fail if we try
             # to check the health prior to the AUTH
             await self.send_command("AUTH", *auth_args, check_health=False)
@@ -656,7 +666,7 @@ async def on_connect(self) -> None:
                 # server seems to be < 6.0.0 which expects a single password
                 # arg. retry auth with just the password.
                 # https://github.com/andymccurdy/redis-py/issues/1274
-                await self.send_command("AUTH", self.password, check_health=False)
+                await self.send_command("AUTH", auth_args[-1], check_health=False)
                 auth_response = await self.read_response()
 
             if str_if_bytes(auth_response) != "OK":
@@ -1014,18 +1024,27 @@ def __init__(
         client_name: str = None,
         retry: Optional[Retry] = None,
         redis_connect_func=None,
+        credential_provider: Optional[CredentialProvider] = None,
     ):
         """
         Initialize a new UnixDomainSocketConnection.
         To specify a retry policy, first set `retry_on_timeout` to `True`
         then set `retry` to a valid `Retry` object
         """
+        if (username or password) and credential_provider is not None:
+            raise DataError(
+                "'username' and 'password' cannot be passed along with 'credential_"
+                "provider'. Please provide only one of the following arguments: \n"
+                "1. 'password' and (optional) 'username'\n"
+                "2. 'credential_provider'"
+            )
         self.pid = os.getpid()
         self.path = path
         self.db = db
-        self.username = username
         self.client_name = client_name
+        self.credential_provider = credential_provider
         self.password = password
+        self.username = username
         self.socket_timeout = socket_timeout
         self.socket_connect_timeout = socket_connect_timeout or socket_timeout or None
         self.retry_on_timeout = retry_on_timeout
diff --git a/redis/client.py b/redis/client.py
index 6a26d28946..8356ba7d07 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -5,6 +5,7 @@
 import time
 import warnings
 from itertools import chain
+from typing import Optional
 
 from redis.commands import (
     CoreCommands,
@@ -13,6 +14,7 @@
     list_or_args,
 )
 from redis.connection import ConnectionPool, SSLConnection, UnixDomainSocketConnection
+from redis.credentials import CredentialProvider
 from redis.exceptions import (
     ConnectionError,
     ExecAbortError,
@@ -938,6 +940,7 @@ def __init__(
         username=None,
         retry=None,
         redis_connect_func=None,
+        credential_provider: Optional[CredentialProvider] = None,
     ):
         """
         Initialize a new Redis client.
@@ -985,6 +988,7 @@ def __init__(
                 "health_check_interval": health_check_interval,
                 "client_name": client_name,
                 "redis_connect_func": redis_connect_func,
+                "credential_provider": credential_provider,
             }
             # based on input, setup appropriate connection args
             if unix_socket_path is not None:
diff --git a/redis/cluster.py b/redis/cluster.py
index cb3b2a6c04..027fe40747 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -121,6 +121,7 @@ def parse_cluster_shards(resp, **options):
     "connection_class",
     "connection_pool",
     "client_name",
+    "credential_provider",
     "db",
     "decode_responses",
     "encoding",
diff --git a/redis/connection.py b/redis/connection.py
index fecb06b099..a2b007406d 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -8,9 +8,11 @@
 from itertools import chain
 from queue import Empty, Full, LifoQueue
 from time import time
+from typing import Optional
 from urllib.parse import parse_qs, unquote, urlparse
 
 from redis.backoff import NoBackoff
+from redis.credentials import CredentialProvider, UsernamePasswordCredentialProvider
 from redis.exceptions import (
     AuthenticationError,
     AuthenticationWrongNumberOfArgsError,
@@ -502,6 +504,7 @@ def __init__(
         username=None,
         retry=None,
         redis_connect_func=None,
+        credential_provider: Optional[CredentialProvider] = None,
     ):
         """
         Initialize a new Connection.
@@ -510,13 +513,21 @@ def __init__(
         `retry` to a valid `Retry` object.
         To retry on TimeoutError, `retry_on_timeout` can also be set to `True`.
         """
+        if (username or password) and credential_provider is not None:
+            raise DataError(
+                "'username' and 'password' cannot be passed along with 'credential_"
+                "provider'. Please provide only one of the following arguments: \n"
+                "1. 'password' and (optional) 'username'\n"
+                "2. 'credential_provider'"
+            )
         self.pid = os.getpid()
         self.host = host
         self.port = int(port)
         self.db = db
-        self.username = username
         self.client_name = client_name
+        self.credential_provider = credential_provider
         self.password = password
+        self.username = username
         self.socket_timeout = socket_timeout
         self.socket_connect_timeout = socket_connect_timeout or socket_timeout
         self.socket_keepalive = socket_keepalive
@@ -675,12 +686,13 @@ def on_connect(self):
         "Initialize the connection, authenticate and select a database"
         self._parser.on_connect(self)
 
-        # if username and/or password are set, authenticate
-        if self.username or self.password:
-            if self.username:
-                auth_args = (self.username, self.password or "")
-            else:
-                auth_args = (self.password,)
+        # if credential provider or username and/or password are set, authenticate
+        if self.credential_provider or (self.username or self.password):
+            cred_provider = (
+                self.credential_provider
+                or UsernamePasswordCredentialProvider(self.username, self.password)
+            )
+            auth_args = cred_provider.get_credentials()
             # avoid checking health here -- PING will fail if we try
             # to check the health prior to the AUTH
             self.send_command("AUTH", *auth_args, check_health=False)
@@ -692,7 +704,7 @@ def on_connect(self):
                 # server seems to be < 6.0.0 which expects a single password
                 # arg. retry auth with just the password.
                 # https://github.com/andymccurdy/redis-py/issues/1274
-                self.send_command("AUTH", self.password, check_health=False)
+                self.send_command("AUTH", auth_args[-1], check_health=False)
                 auth_response = self.read_response()
 
             if str_if_bytes(auth_response) != "OK":
@@ -1050,6 +1062,7 @@ def __init__(
         client_name=None,
         retry=None,
         redis_connect_func=None,
+        credential_provider: Optional[CredentialProvider] = None,
     ):
         """
         Initialize a new UnixDomainSocketConnection.
@@ -1058,12 +1071,20 @@ def __init__(
         `retry` to a valid `Retry` object.
         To retry on TimeoutError, `retry_on_timeout` can also be set to `True`.
         """
+        if (username or password) and credential_provider is not None:
+            raise DataError(
+                "'username' and 'password' cannot be passed along with 'credential_"
+                "provider'. Please provide only one of the following arguments: \n"
+                "1. 'password' and (optional) 'username'\n"
+                "2. 'credential_provider'"
+            )
         self.pid = os.getpid()
         self.path = path
         self.db = db
-        self.username = username
         self.client_name = client_name
+        self.credential_provider = credential_provider
         self.password = password
+        self.username = username
         self.socket_timeout = socket_timeout
         self.retry_on_timeout = retry_on_timeout
         if retry_on_error is SENTINEL:
diff --git a/redis/credentials.py b/redis/credentials.py
new file mode 100644
index 0000000000..7ba26dcde1
--- /dev/null
+++ b/redis/credentials.py
@@ -0,0 +1,26 @@
+from typing import Optional, Tuple, Union
+
+
+class CredentialProvider:
+    """
+    Credentials Provider.
+    """
+
+    def get_credentials(self) -> Union[Tuple[str], Tuple[str, str]]:
+        raise NotImplementedError("get_credentials must be implemented")
+
+
+class UsernamePasswordCredentialProvider(CredentialProvider):
+    """
+    Simple implementation of CredentialProvider that just wraps static
+    username and password.
+    """
+
+    def __init__(self, username: Optional[str] = None, password: Optional[str] = None):
+        self.username = username or ""
+        self.password = password or ""
+
+    def get_credentials(self):
+        if self.username:
+            return self.username, self.password
+        return (self.password,)
diff --git a/tests/test_asyncio/test_credentials.py b/tests/test_asyncio/test_credentials.py
new file mode 100644
index 0000000000..8e213cdb26
--- /dev/null
+++ b/tests/test_asyncio/test_credentials.py
@@ -0,0 +1,284 @@
+import functools
+import random
+import string
+from typing import Optional, Tuple, Union
+
+import pytest
+import pytest_asyncio
+
+import redis
+from redis import AuthenticationError, DataError, ResponseError
+from redis.credentials import CredentialProvider, UsernamePasswordCredentialProvider
+from redis.utils import str_if_bytes
+from tests.conftest import skip_if_redis_enterprise
+
+
+@pytest_asyncio.fixture()
+async def r_acl_teardown(r: redis.Redis):
+    """
+    A special fixture which removes the provided names from the database after use
+    """
+    usernames = []
+
+    def factory(username):
+        usernames.append(username)
+        return r
+
+    yield factory
+    for username in usernames:
+        await r.acl_deluser(username)
+
+
+@pytest_asyncio.fixture()
+async def r_required_pass_teardown(r: redis.Redis):
+    """
+    A special fixture which removes the provided password from the database after use
+    """
+    passwords = []
+
+    def factory(username):
+        passwords.append(username)
+        return r
+
+    yield factory
+    for password in passwords:
+        try:
+            await r.auth(password)
+        except (ResponseError, AuthenticationError):
+            await r.auth("default", "")
+        await r.config_set("requirepass", "")
+
+
+class NoPassCredProvider(CredentialProvider):
+    def get_credentials(self) -> Union[Tuple[str], Tuple[str, str]]:
+        return "username", ""
+
+
+class AsyncRandomAuthCredProvider(CredentialProvider):
+    def __init__(self, user: Optional[str], endpoint: str):
+        self.user = user
+        self.endpoint = endpoint
+
+    @functools.lru_cache(maxsize=10)
+    def get_credentials(self) -> Union[Tuple[str, str], Tuple[str]]:
+        def get_random_string(length):
+            letters = string.ascii_lowercase
+            result_str = "".join(random.choice(letters) for i in range(length))
+            return result_str
+
+        if self.user:
+            auth_token: str = get_random_string(5) + self.user + "_" + self.endpoint
+            return self.user, auth_token
+        else:
+            auth_token: str = get_random_string(5) + self.endpoint
+            return (auth_token,)
+
+
+async def init_acl_user(r, username, password):
+    # reset the user
+    await r.acl_deluser(username)
+    if password:
+        assert (
+            await r.acl_setuser(
+                username,
+                enabled=True,
+                passwords=["+" + password],
+                keys="~*",
+                commands=[
+                    "+ping",
+                    "+command",
+                    "+info",
+                    "+select",
+                    "+flushdb",
+                    "+cluster",
+                ],
+            )
+            is True
+        )
+    else:
+        assert (
+            await r.acl_setuser(
+                username,
+                enabled=True,
+                keys="~*",
+                commands=[
+                    "+ping",
+                    "+command",
+                    "+info",
+                    "+select",
+                    "+flushdb",
+                    "+cluster",
+                ],
+                nopass=True,
+            )
+            is True
+        )
+
+
+async def init_required_pass(r, password):
+    await r.config_set("requirepass", password)
+
+
+@pytest.mark.asyncio
+class TestCredentialsProvider:
+    @skip_if_redis_enterprise()
+    async def test_only_pass_without_creds_provider(
+        self, r_required_pass_teardown, create_redis
+    ):
+        # test for default user (`username` is supposed to be optional)
+        password = "password"
+        r = r_required_pass_teardown(password)
+        await init_required_pass(r, password)
+        assert await r.auth(password) is True
+
+        r2 = await create_redis(flushdb=False, password=password)
+
+        assert await r2.ping() is True
+
+    @skip_if_redis_enterprise()
+    async def test_user_and_pass_without_creds_provider(
+        self, r_acl_teardown, create_redis
+    ):
+        """
+        Test backward compatibility with username and password
+        """
+        # test for other users
+        username = "username"
+        password = "password"
+        r = r_acl_teardown(username)
+        await init_acl_user(r, username, password)
+        r2 = await create_redis(flushdb=False, username=username, password=password)
+
+        assert await r2.ping() is True
+
+    @pytest.mark.parametrize("username", ["username", None])
+    @skip_if_redis_enterprise()
+    @pytest.mark.onlynoncluster
+    async def test_credential_provider_with_supplier(
+        self, r_acl_teardown, r_required_pass_teardown, create_redis, username
+    ):
+        creds_provider = AsyncRandomAuthCredProvider(
+            user=username,
+            endpoint="localhost",
+        )
+
+        auth_args = creds_provider.get_credentials()
+        password = auth_args[-1]
+
+        if username:
+            r = r_acl_teardown(username)
+            await init_acl_user(r, username, password)
+        else:
+            r = r_required_pass_teardown(password)
+            await init_required_pass(r, password)
+
+        r2 = await create_redis(flushdb=False, credential_provider=creds_provider)
+
+        assert await r2.ping() is True
+
+    async def test_async_credential_provider_no_password_success(
+        self, r_acl_teardown, create_redis
+    ):
+        username = "username"
+        r = r_acl_teardown(username)
+        await init_acl_user(r, username, "")
+        r2 = await create_redis(
+            flushdb=False,
+            credential_provider=NoPassCredProvider(),
+        )
+        assert await r2.ping() is True
+
+    @pytest.mark.onlynoncluster
+    async def test_credential_provider_no_password_error(
+        self, r_acl_teardown, create_redis
+    ):
+        username = "username"
+        r = r_acl_teardown(username)
+        await init_acl_user(r, username, "password")
+        with pytest.raises(AuthenticationError) as e:
+            await create_redis(
+                flushdb=False,
+                credential_provider=NoPassCredProvider(),
+                single_connection_client=True,
+            )
+        assert e.match("invalid username-password")
+        assert await r.acl_deluser(username)
+
+    @pytest.mark.onlynoncluster
+    async def test_password_and_username_together_with_cred_provider_raise_error(
+        self, r_acl_teardown, create_redis
+    ):
+        username = "username"
+        r = r_acl_teardown(username)
+        await init_acl_user(r, username, "password")
+        cred_provider = UsernamePasswordCredentialProvider(
+            username="username", password="password"
+        )
+        with pytest.raises(DataError) as e:
+            await create_redis(
+                flushdb=False,
+                username="username",
+                password="password",
+                credential_provider=cred_provider,
+                single_connection_client=True,
+            )
+        assert e.match(
+            "'username' and 'password' cannot be passed along with "
+            "'credential_provider'."
+        )
+
+    @pytest.mark.onlynoncluster
+    async def test_change_username_password_on_existing_connection(
+        self, r_acl_teardown, create_redis
+    ):
+        username = "origin_username"
+        password = "origin_password"
+        new_username = "new_username"
+        new_password = "new_password"
+        r = r_acl_teardown(username)
+        await init_acl_user(r, username, password)
+        r2 = await create_redis(flushdb=False, username=username, password=password)
+        assert await r2.ping() is True
+        conn = await r2.connection_pool.get_connection("_")
+        await conn.send_command("PING")
+        assert str_if_bytes(await conn.read_response()) == "PONG"
+        assert conn.username == username
+        assert conn.password == password
+        await init_acl_user(r, new_username, new_password)
+        conn.password = new_password
+        conn.username = new_username
+        await conn.send_command("PING")
+        assert str_if_bytes(await conn.read_response()) == "PONG"
+
+
+@pytest.mark.asyncio
+class TestUsernamePasswordCredentialProvider:
+    async def test_user_pass_credential_provider_acl_user_and_pass(
+        self, r_acl_teardown, create_redis
+    ):
+        username = "username"
+        password = "password"
+        r = r_acl_teardown(username)
+        provider = UsernamePasswordCredentialProvider(username, password)
+        assert provider.username == username
+        assert provider.password == password
+        assert provider.get_credentials() == (username, password)
+        await init_acl_user(r, provider.username, provider.password)
+        r2 = await create_redis(flushdb=False, credential_provider=provider)
+        assert await r2.ping() is True
+
+    async def test_user_pass_provider_only_password(
+        self, r_required_pass_teardown, create_redis
+    ):
+        password = "password"
+        provider = UsernamePasswordCredentialProvider(password=password)
+        r = r_required_pass_teardown(password)
+        assert provider.username == ""
+        assert provider.password == password
+        assert provider.get_credentials() == (password,)
+
+        await init_required_pass(r, password)
+
+        r2 = await create_redis(flushdb=False, credential_provider=provider)
+        assert await r2.auth(provider.password) is True
+        assert await r2.ping() is True
diff --git a/tests/test_credentials.py b/tests/test_credentials.py
new file mode 100644
index 0000000000..9aeb1ef1d5
--- /dev/null
+++ b/tests/test_credentials.py
@@ -0,0 +1,245 @@
+import functools
+import random
+import string
+from typing import Optional, Tuple, Union
+
+import pytest
+
+import redis
+from redis import AuthenticationError, DataError, ResponseError
+from redis.credentials import CredentialProvider, UsernamePasswordCredentialProvider
+from redis.utils import str_if_bytes
+from tests.conftest import _get_client, skip_if_redis_enterprise
+
+
+class NoPassCredProvider(CredentialProvider):
+    def get_credentials(self) -> Union[Tuple[str], Tuple[str, str]]:
+        return "username", ""
+
+
+class RandomAuthCredProvider(CredentialProvider):
+    def __init__(self, user: Optional[str], endpoint: str):
+        self.user = user
+        self.endpoint = endpoint
+
+    @functools.lru_cache(maxsize=10)
+    def get_credentials(self) -> Union[Tuple[str, str], Tuple[str]]:
+        def get_random_string(length):
+            letters = string.ascii_lowercase
+            result_str = "".join(random.choice(letters) for i in range(length))
+            return result_str
+
+        if self.user:
+            auth_token: str = get_random_string(5) + self.user + "_" + self.endpoint
+            return self.user, auth_token
+        else:
+            auth_token: str = get_random_string(5) + self.endpoint
+            return (auth_token,)
+
+
+def init_acl_user(r, request, username, password):
+    # reset the user
+    r.acl_deluser(username)
+    if password:
+        assert (
+            r.acl_setuser(
+                username,
+                enabled=True,
+                passwords=["+" + password],
+                keys="~*",
+                commands=[
+                    "+ping",
+                    "+command",
+                    "+info",
+                    "+select",
+                    "+flushdb",
+                    "+cluster",
+                ],
+            )
+            is True
+        )
+    else:
+        assert (
+            r.acl_setuser(
+                username,
+                enabled=True,
+                keys="~*",
+                commands=[
+                    "+ping",
+                    "+command",
+                    "+info",
+                    "+select",
+                    "+flushdb",
+                    "+cluster",
+                ],
+                nopass=True,
+            )
+            is True
+        )
+
+    if request is not None:
+
+        def teardown():
+            r.acl_deluser(username)
+
+        request.addfinalizer(teardown)
+
+
+def init_required_pass(r, request, password):
+    r.config_set("requirepass", password)
+
+    def teardown():
+        try:
+            r.auth(password)
+        except (ResponseError, AuthenticationError):
+            r.auth("default", "")
+        r.config_set("requirepass", "")
+
+    request.addfinalizer(teardown)
+
+
+class TestCredentialsProvider:
+    @skip_if_redis_enterprise()
+    def test_only_pass_without_creds_provider(self, r, request):
+        # test for default user (`username` is supposed to be optional)
+        password = "password"
+        init_required_pass(r, request, password)
+        assert r.auth(password) is True
+
+        r2 = _get_client(redis.Redis, request, flushdb=False, password=password)
+
+        assert r2.ping() is True
+
+    @skip_if_redis_enterprise()
+    def test_user_and_pass_without_creds_provider(self, r, request):
+        """
+        Test backward compatibility with username and password
+        """
+        # test for other users
+        username = "username"
+        password = "password"
+
+        init_acl_user(r, request, username, password)
+        r2 = _get_client(
+            redis.Redis, request, flushdb=False, username=username, password=password
+        )
+
+        assert r2.ping() is True
+
+    @pytest.mark.parametrize("username", ["username", None])
+    @skip_if_redis_enterprise()
+    @pytest.mark.onlynoncluster
+    def test_credential_provider_with_supplier(self, r, request, username):
+        creds_provider = RandomAuthCredProvider(
+            user=username,
+            endpoint="localhost",
+        )
+
+        password = creds_provider.get_credentials()[-1]
+
+        if username:
+            init_acl_user(r, request, username, password)
+        else:
+            init_required_pass(r, request, password)
+
+        r2 = _get_client(
+            redis.Redis, request, flushdb=False, credential_provider=creds_provider
+        )
+
+        assert r2.ping() is True
+
+    def test_credential_provider_no_password_success(self, r, request):
+        init_acl_user(r, request, "username", "")
+        r2 = _get_client(
+            redis.Redis,
+            request,
+            flushdb=False,
+            credential_provider=NoPassCredProvider(),
+        )
+        assert r2.ping() is True
+
+    @pytest.mark.onlynoncluster
+    def test_credential_provider_no_password_error(self, r, request):
+        init_acl_user(r, request, "username", "password")
+        with pytest.raises(AuthenticationError) as e:
+            _get_client(
+                redis.Redis,
+                request,
+                flushdb=False,
+                credential_provider=NoPassCredProvider(),
+            )
+        assert e.match("invalid username-password")
+
+    @pytest.mark.onlynoncluster
+    def test_password_and_username_together_with_cred_provider_raise_error(
+        self, r, request
+    ):
+        init_acl_user(r, request, "username", "password")
+        cred_provider = UsernamePasswordCredentialProvider(
+            username="username", password="password"
+        )
+        with pytest.raises(DataError) as e:
+            _get_client(
+                redis.Redis,
+                request,
+                flushdb=False,
+                username="username",
+                password="password",
+                credential_provider=cred_provider,
+            )
+        assert e.match(
+            "'username' and 'password' cannot be passed along with "
+            "'credential_provider'."
+        )
+
+    @pytest.mark.onlynoncluster
+    def test_change_username_password_on_existing_connection(self, r, request):
+        username = "origin_username"
+        password = "origin_password"
+        new_username = "new_username"
+        new_password = "new_password"
+        init_acl_user(r, request, username, password)
+        r2 = _get_client(
+            redis.Redis, request, flushdb=False, username=username, password=password
+        )
+        assert r2.ping() is True
+        conn = r2.connection_pool.get_connection("_")
+        conn.send_command("PING")
+        assert str_if_bytes(conn.read_response()) == "PONG"
+        assert conn.username == username
+        assert conn.password == password
+        init_acl_user(r, request, new_username, new_password)
+        conn.password = new_password
+        conn.username = new_username
+        conn.send_command("PING")
+        assert str_if_bytes(conn.read_response()) == "PONG"
+
+
+class TestUsernamePasswordCredentialProvider:
+    def test_user_pass_credential_provider_acl_user_and_pass(self, r, request):
+        username = "username"
+        password = "password"
+        provider = UsernamePasswordCredentialProvider(username, password)
+        assert provider.username == username
+        assert provider.password == password
+        assert provider.get_credentials() == (username, password)
+        init_acl_user(r, request, provider.username, provider.password)
+        r2 = _get_client(
+            redis.Redis, request, flushdb=False, credential_provider=provider
+        )
+        assert r2.ping() is True
+
+    def test_user_pass_provider_only_password(self, r, request):
+        password = "password"
+        provider = UsernamePasswordCredentialProvider(password=password)
+        assert provider.username == ""
+        assert provider.password == password
+        assert provider.get_credentials() == (password,)
+
+        init_required_pass(r, request, password)
+
+        r2 = _get_client(
+            redis.Redis, request, flushdb=False, credential_provider=provider
+        )
+        assert r2.auth(provider.password) is True
+        assert r2.ping() is True

From 67214cc3eaa7890c87e45550b8320779f954094b Mon Sep 17 00:00:00 2001
From: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Date: Thu, 10 Nov 2022 13:16:49 +0200
Subject: [PATCH 0620/1164] Failover handling improvements for RedisCluster and
 Async RedisCluster (#2377)

* Cluster&AsyncCluster: Removed handling of timeouts/connection errors within the cluster loop, fixed "cannot pickle '_thread.lock' object" bug, added client's side failover handling improvements

* Fixed linters

* Type fixes

* Added to CHANGES

* Added getter and setter for the client's retry object and added more tests

* Fixed linters

* Fixed test

* Fixed test_client_kill test

* Changed get_default_backoff to default_backoff, removed retry_on_error and connection_error_retry_attempts from RedisCluster, default retry changed to no retries

* Fixing linters

* Reverting deletion of connection_error_retry_attempts to maintain backward compatibility

* Updating retry object for existing and new connections

* Changed the default value of reinitialize_steps from 10 to 5

* fix review comments

Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: dvora-h <dvora.heller@redis.com>
Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 CHANGES                            |   2 +
 redis/__init__.py                  |   2 +
 redis/asyncio/__init__.py          |   2 +
 redis/asyncio/client.py            |   7 ++
 redis/asyncio/cluster.py           | 121 ++++++++++---------
 redis/asyncio/connection.py        |   8 +-
 redis/backoff.py                   |  17 ++-
 redis/client.py                    |   8 ++
 redis/cluster.py                   | 187 ++++++++++++++---------------
 redis/connection.py                |   9 +-
 tests/test_asyncio/test_cluster.py |  78 +++++++++++-
 tests/test_asyncio/test_retry.py   |  22 +++-
 tests/test_cluster.py              | 100 +++++++++++++++
 tests/test_retry.py                |  16 ++-
 14 files changed, 413 insertions(+), 166 deletions(-)

diff --git a/CHANGES b/CHANGES
index 4945f61612..883c548f38 100644
--- a/CHANGES
+++ b/CHANGES
@@ -24,6 +24,8 @@
     * ClusterPipeline Doesn't Handle ConnectionError for Dead Hosts (#2225)
     * Remove compatibility code for old versions of Hiredis, drop Packaging dependency
     * The `deprecated` library is no longer a dependency
+    * Failover handling improvements for RedisCluster and Async RedisCluster (#2377)
+    * Fixed "cannot pickle '_thread.lock' object" bug (#2354, #2297)
     * Added CredentialsProvider class to support password rotation
     * Enable Lock for asyncio cluster mode
 
diff --git a/redis/__init__.py b/redis/__init__.py
index 5201fe22d4..6503ac30b4 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -1,5 +1,6 @@
 import sys
 
+from redis.backoff import default_backoff
 from redis.client import Redis, StrictRedis
 from redis.cluster import RedisCluster
 from redis.connection import (
@@ -66,6 +67,7 @@ def int_or_str(value):
     "CredentialProvider",
     "DataError",
     "from_url",
+    "default_backoff",
     "InvalidResponse",
     "PubSubError",
     "ReadOnlyError",
diff --git a/redis/asyncio/__init__.py b/redis/asyncio/__init__.py
index 598791ac15..bf90dde555 100644
--- a/redis/asyncio/__init__.py
+++ b/redis/asyncio/__init__.py
@@ -15,6 +15,7 @@
     SentinelManagedSSLConnection,
 )
 from redis.asyncio.utils import from_url
+from redis.backoff import default_backoff
 from redis.exceptions import (
     AuthenticationError,
     AuthenticationWrongNumberOfArgsError,
@@ -43,6 +44,7 @@
     "ConnectionPool",
     "DataError",
     "from_url",
+    "default_backoff",
     "InvalidResponse",
     "PubSubError",
     "ReadOnlyError",
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index c0855717f2..e0ed85eb8f 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -276,6 +276,13 @@ def get_connection_kwargs(self):
         """Get the connection's key-word arguments"""
         return self.connection_pool.connection_kwargs
 
+    def get_retry(self) -> Optional["Retry"]:
+        return self.get_connection_kwargs().get("retry")
+
+    def set_retry(self, retry: "Retry") -> None:
+        self.get_connection_kwargs().update({"retry": retry})
+        self.connection_pool.set_retry(retry)
+
     def load_external_module(self, funcname, func):
         """
         This function can be used to add externally defined redis modules,
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 57aafbd69f..d5a38b2878 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -26,6 +26,8 @@
 )
 from redis.asyncio.lock import Lock
 from redis.asyncio.parser import CommandsParser
+from redis.asyncio.retry import Retry
+from redis.backoff import default_backoff
 from redis.client import EMPTY_RESPONSE, NEVER_DECODE, AbstractRedis
 from redis.cluster import (
     PIPELINE_BLOCKED_COMMANDS,
@@ -110,10 +112,10 @@ class RedisCluster(AbstractRedis, AbstractRedisCluster, AsyncRedisClusterCommand
     :param startup_nodes:
         | :class:`~.ClusterNode` to used as a startup node
     :param require_full_coverage:
-        | When set to ``False``: the client will not require a full coverage of the
-          slots. However, if not all slots are covered, and at least one node has
-          ``cluster-require-full-coverage`` set to ``yes``, the server will throw a
-          :class:`~.ClusterDownError` for some key-based commands.
+        | When set to ``False``: the client will not require a full coverage of
+          the slots. However, if not all slots are covered, and at least one node
+          has ``cluster-require-full-coverage`` set to ``yes``, the server will throw
+          a :class:`~.ClusterDownError` for some key-based commands.
         | When set to ``True``: all slots must be covered to construct the cluster
           client. If not all slots are covered, :class:`~.RedisClusterException` will be
           thrown.
@@ -136,7 +138,10 @@ class RedisCluster(AbstractRedis, AbstractRedisCluster, AsyncRedisClusterCommand
           or :class:`~.ConnectionError` or :class:`~.ClusterDownError` are encountered
     :param connection_error_retry_attempts:
         | Number of times to retry before reinitializing when :class:`~.TimeoutError`
-          or :class:`~.ConnectionError` are encountered
+          or :class:`~.ConnectionError` are encountered.
+          The default backoff strategy will be set if Retry object is not passed (see
+          default_backoff in backoff.py). To change it, pass a custom Retry object
+          using the "retry" keyword.
     :param max_connections:
         | Maximum number of connections per node. If there are no free connections & the
           maximum number of connections are already created, a
@@ -214,9 +219,9 @@ def __init__(
         startup_nodes: Optional[List["ClusterNode"]] = None,
         require_full_coverage: bool = True,
         read_from_replicas: bool = False,
-        reinitialize_steps: int = 10,
+        reinitialize_steps: int = 5,
         cluster_error_retry_attempts: int = 3,
-        connection_error_retry_attempts: int = 5,
+        connection_error_retry_attempts: int = 3,
         max_connections: int = 2**31,
         # Client related kwargs
         db: Union[str, int] = 0,
@@ -235,6 +240,8 @@ def __init__(
         socket_keepalive: bool = False,
         socket_keepalive_options: Optional[Mapping[int, Union[int, bytes]]] = None,
         socket_timeout: Optional[float] = None,
+        retry: Optional["Retry"] = None,
+        retry_on_error: Optional[List[Exception]] = None,
         # SSL related kwargs
         ssl: bool = False,
         ssl_ca_certs: Optional[str] = None,
@@ -282,6 +289,7 @@ def __init__(
             "socket_keepalive": socket_keepalive,
             "socket_keepalive_options": socket_keepalive_options,
             "socket_timeout": socket_timeout,
+            "retry": retry,
         }
 
         if ssl:
@@ -302,6 +310,18 @@ def __init__(
             # Call our on_connect function to configure READONLY mode
             kwargs["redis_connect_func"] = self.on_connect
 
+        self.retry = retry
+        if retry or retry_on_error or connection_error_retry_attempts > 0:
+            # Set a retry object for all cluster nodes
+            self.retry = retry or Retry(
+                default_backoff(), connection_error_retry_attempts
+            )
+            if not retry_on_error:
+                # Default errors for retrying
+                retry_on_error = [ConnectionError, TimeoutError]
+            self.retry.update_supported_errors(retry_on_error)
+            kwargs.update({"retry": self.retry})
+
         kwargs["response_callbacks"] = self.__class__.RESPONSE_CALLBACKS.copy()
         self.connection_kwargs = kwargs
 
@@ -323,7 +343,6 @@ def __init__(
         self.reinitialize_steps = reinitialize_steps
         self.cluster_error_retry_attempts = cluster_error_retry_attempts
         self.connection_error_retry_attempts = connection_error_retry_attempts
-
         self.reinitialize_counter = 0
         self.commands_parser = CommandsParser()
         self.node_flags = self.__class__.NODE_FLAGS.copy()
@@ -481,6 +500,16 @@ def get_connection_kwargs(self) -> Dict[str, Optional[Any]]:
         """Get the kwargs passed to :class:`~redis.asyncio.connection.Connection`."""
         return self.connection_kwargs
 
+    def get_retry(self) -> Optional["Retry"]:
+        return self.retry
+
+    def set_retry(self, retry: "Retry") -> None:
+        self.retry = retry
+        for node in self.get_nodes():
+            node.connection_kwargs.update({"retry": retry})
+            for conn in node._connections:
+                conn.retry = retry
+
     def set_response_callback(self, command: str, callback: ResponseCallbackT) -> None:
         """Set a custom response callback."""
         self.response_callbacks[command] = callback
@@ -618,9 +647,11 @@ async def execute_command(self, *args: EncodableT, **kwargs: Any) -> Any:
         if passed_targets and not self._is_node_flag(passed_targets):
             target_nodes = self._parse_target_nodes(passed_targets)
             target_nodes_specified = True
-            retry_attempts = 1
+            retry_attempts = 0
 
-        for _ in range(retry_attempts):
+        # Add one for the first execution
+        execute_attempts = 1 + retry_attempts
+        for _ in range(execute_attempts):
             if self._initialize:
                 await self.initialize()
             try:
@@ -658,17 +689,14 @@ async def execute_command(self, *args: EncodableT, **kwargs: Any) -> Any:
                         )
                     return dict(zip(keys, values))
             except Exception as e:
-                if type(e) in self.__class__.ERRORS_ALLOW_RETRY:
-                    # The nodes and slots cache were reinitialized.
+                if retry_attempts > 0 and type(e) in self.__class__.ERRORS_ALLOW_RETRY:
+                    # The nodes and slots cache were should be reinitialized.
                     # Try again with the new cluster setup.
-                    exception = e
+                    retry_attempts -= 1
+                    continue
                 else:
-                    # All other errors should be raised.
-                    raise
-
-        # If it fails the configured number of times then raise exception back
-        # to caller of this method
-        raise exception
+                    # raise the exception
+                    raise e
 
     async def _execute_command(
         self, target_node: "ClusterNode", *args: Union[KeyT, EncodableT], **kwargs: Any
@@ -676,7 +704,6 @@ async def _execute_command(
         asking = moved = False
         redirect_addr = None
         ttl = self.RedisClusterRequestTTL
-        connection_error_retry_counter = 0
 
         while ttl > 0:
             ttl -= 1
@@ -695,25 +722,18 @@ async def _execute_command(
                     moved = False
 
                 return await target_node.execute_command(*args, **kwargs)
-            except BusyLoadingError:
+            except (BusyLoadingError, MaxConnectionsError):
+                raise
+            except (ConnectionError, TimeoutError):
+                # Connection retries are being handled in the node's
+                # Retry object.
+                # Remove the failed node from the startup nodes before we try
+                # to reinitialize the cluster
+                self.nodes_manager.startup_nodes.pop(target_node.name, None)
+                # Hard force of reinitialize of the node/slots setup
+                # and try again with the new setup
+                await self.close()
                 raise
-            except (ConnectionError, TimeoutError) as e:
-                # Give the node 0.25 seconds to get back up and retry again with the
-                # same node and configuration. After the defined number of attempts, try
-                # to reinitialize the cluster and try again.
-                connection_error_retry_counter += 1
-                if (
-                    connection_error_retry_counter
-                    < self.connection_error_retry_attempts
-                ):
-                    await asyncio.sleep(0.25)
-                else:
-                    if isinstance(e, MaxConnectionsError):
-                        raise
-                    # Hard force of reinitialize of the node/slots setup
-                    # and try again with the new setup
-                    await self.close()
-                    raise
             except ClusterDownError:
                 # ClusterDownError can occur during a failover and to get
                 # self-healed, we will try to reinitialize the cluster layout
@@ -1145,26 +1165,11 @@ async def initialize(self) -> None:
                     )
                 cluster_slots = await startup_node.execute_command("CLUSTER SLOTS")
                 startup_nodes_reachable = True
-            except (ConnectionError, TimeoutError) as e:
+            except Exception as e:
+                # Try the next startup node.
+                # The exception is saved and raised only if we have no more nodes.
                 exception = e
                 continue
-            except ResponseError as e:
-                # Isn't a cluster connection, so it won't parse these
-                # exceptions automatically
-                message = e.__str__()
-                if "CLUSTERDOWN" in message or "MASTERDOWN" in message:
-                    continue
-                else:
-                    raise RedisClusterException(
-                        'ERROR sending "cluster slots" command to redis '
-                        f"server: {startup_node}. error: {message}"
-                    )
-            except Exception as e:
-                message = e.__str__()
-                raise RedisClusterException(
-                    'ERROR sending "cluster slots" command to redis '
-                    f"server {startup_node.name}. error: {message}"
-                )
 
             # CLUSTER SLOTS command results in the following output:
             # [[slot_section[from_slot,to_slot,master,replica1,...,replicaN]]]
@@ -1245,8 +1250,8 @@ async def initialize(self) -> None:
 
         if not startup_nodes_reachable:
             raise RedisClusterException(
-                "Redis Cluster cannot be connected. Please provide at least "
-                "one reachable node. "
+                f"Redis Cluster cannot be connected. Please provide at least "
+                f"one reachable node: {str(exception)}"
             ) from exception
 
         # Check if the slots are not fully covered
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index df066c4763..4f19153318 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -497,7 +497,7 @@ def __init__(
             retry_on_error.append(socket.timeout)
             retry_on_error.append(asyncio.TimeoutError)
         self.retry_on_error = retry_on_error
-        if retry_on_error:
+        if retry or retry_on_error:
             if not retry:
                 self.retry = Retry(NoBackoff(), 1)
             else:
@@ -1445,6 +1445,12 @@ async def disconnect(self, inuse_connections: bool = True):
             if exc:
                 raise exc
 
+    def set_retry(self, retry: "Retry") -> None:
+        for conn in self._available_connections:
+            conn.retry = retry
+        for conn in self._in_use_connections:
+            conn.retry = retry
+
 
 class BlockingConnectionPool(ConnectionPool):
     """
diff --git a/redis/backoff.py b/redis/backoff.py
index 5ccdb919f3..c62e760bdc 100644
--- a/redis/backoff.py
+++ b/redis/backoff.py
@@ -1,6 +1,11 @@
 import random
 from abc import ABC, abstractmethod
 
+# Maximum backoff between each retry in seconds
+DEFAULT_CAP = 0.512
+# Minimum backoff between each retry in seconds
+DEFAULT_BASE = 0.008
+
 
 class AbstractBackoff(ABC):
     """Backoff interface"""
@@ -40,7 +45,7 @@ def __init__(self):
 class ExponentialBackoff(AbstractBackoff):
     """Exponential backoff upon failure"""
 
-    def __init__(self, cap, base):
+    def __init__(self, cap=DEFAULT_CAP, base=DEFAULT_BASE):
         """
         `cap`: maximum backoff time in seconds
         `base`: base backoff time in seconds
@@ -55,7 +60,7 @@ def compute(self, failures):
 class FullJitterBackoff(AbstractBackoff):
     """Full jitter backoff upon failure"""
 
-    def __init__(self, cap, base):
+    def __init__(self, cap=DEFAULT_CAP, base=DEFAULT_BASE):
         """
         `cap`: maximum backoff time in seconds
         `base`: base backoff time in seconds
@@ -70,7 +75,7 @@ def compute(self, failures):
 class EqualJitterBackoff(AbstractBackoff):
     """Equal jitter backoff upon failure"""
 
-    def __init__(self, cap, base):
+    def __init__(self, cap=DEFAULT_CAP, base=DEFAULT_BASE):
         """
         `cap`: maximum backoff time in seconds
         `base`: base backoff time in seconds
@@ -86,7 +91,7 @@ def compute(self, failures):
 class DecorrelatedJitterBackoff(AbstractBackoff):
     """Decorrelated jitter backoff upon failure"""
 
-    def __init__(self, cap, base):
+    def __init__(self, cap=DEFAULT_CAP, base=DEFAULT_BASE):
         """
         `cap`: maximum backoff time in seconds
         `base`: base backoff time in seconds
@@ -103,3 +108,7 @@ def compute(self, failures):
         temp = random.uniform(self._base, max_backoff)
         self._previous_backoff = min(self._cap, temp)
         return self._previous_backoff
+
+
+def default_backoff():
+    return EqualJitterBackoff()
diff --git a/redis/client.py b/redis/client.py
index 8356ba7d07..ed857c8fba 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -26,6 +26,7 @@
     WatchError,
 )
 from redis.lock import Lock
+from redis.retry import Retry
 from redis.utils import safe_str, str_if_bytes
 
 SYM_EMPTY = b""
@@ -1047,6 +1048,13 @@ def get_connection_kwargs(self):
         """Get the connection's key-word arguments"""
         return self.connection_pool.connection_kwargs
 
+    def get_retry(self) -> Optional["Retry"]:
+        return self.get_connection_kwargs().get("retry")
+
+    def set_retry(self, retry: "Retry") -> None:
+        self.get_connection_kwargs().update({"retry": retry})
+        self.connection_pool.set_retry(retry)
+
     def set_response_callback(self, command, callback):
         """Set a custom Response Callback"""
         self.response_callbacks[command] = callback
diff --git a/redis/cluster.py b/redis/cluster.py
index 027fe40747..91deaead59 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -1,12 +1,12 @@
-import copy
 import random
 import socket
 import sys
 import threading
 import time
 from collections import OrderedDict
-from typing import Any, Callable, Dict, Tuple, Union
+from typing import Any, Callable, Dict, List, Optional, Tuple, Union
 
+from redis.backoff import default_backoff
 from redis.client import CaseInsensitiveDict, PubSub, Redis, parse_scan
 from redis.commands import READ_COMMANDS, CommandsParser, RedisClusterCommands
 from redis.connection import ConnectionPool, DefaultParser, Encoder, parse_url
@@ -29,6 +29,7 @@
     TryAgainError,
 )
 from redis.lock import Lock
+from redis.retry import Retry
 from redis.utils import (
     dict_merge,
     list_keys_to_dict,
@@ -426,27 +427,28 @@ class initializer. In the case of conflicting arguments, querystring
 
     def __init__(
         self,
-        host=None,
-        port=6379,
-        startup_nodes=None,
-        cluster_error_retry_attempts=3,
-        require_full_coverage=False,
-        reinitialize_steps=10,
-        read_from_replicas=False,
-        dynamic_startup_nodes=True,
-        url=None,
+        host: Optional[str] = None,
+        port: int = 6379,
+        startup_nodes: Optional[List["ClusterNode"]] = None,
+        cluster_error_retry_attempts: int = 3,
+        retry: Optional["Retry"] = None,
+        require_full_coverage: bool = False,
+        reinitialize_steps: int = 5,
+        read_from_replicas: bool = False,
+        dynamic_startup_nodes: bool = True,
+        url: Optional[str] = None,
         **kwargs,
     ):
         """
          Initialize a new RedisCluster client.
 
-         :startup_nodes: 'list[ClusterNode]'
+         :param startup_nodes:
              List of nodes from which initial bootstrapping can be done
-         :host: 'str'
+         :param host:
              Can be used to point to a startup node
-         :port: 'int'
+         :param port:
              Can be used to point to a startup node
-         :require_full_coverage: 'bool'
+         :param require_full_coverage:
             When set to False (default value): the client will not require a
             full coverage of the slots. However, if not all slots are covered,
             and at least one node has 'cluster-require-full-coverage' set to
@@ -456,12 +458,12 @@ def __init__(
             When set to True: all slots must be covered to construct the
             cluster client. If not all slots are covered, RedisClusterException
             will be thrown.
-        :read_from_replicas: 'bool'
+        :param read_from_replicas:
              Enable read from replicas in READONLY mode. You can read possibly
              stale data.
              When set to true, read commands will be assigned between the
              primary and its replications in a Round-Robin manner.
-         :dynamic_startup_nodes: 'bool'
+         :param dynamic_startup_nodes:
              Set the RedisCluster's startup nodes to all of the discovered nodes.
              If true (default value), the cluster's discovered nodes will be used to
              determine the cluster nodes-slots mapping in the next topology refresh.
@@ -469,10 +471,11 @@ def __init__(
              listed in the CLUSTER SLOTS output.
              If you use dynamic DNS endpoints for startup nodes but CLUSTER SLOTS lists
              specific IP addresses, it is best to set it to false.
-        :cluster_error_retry_attempts: 'int'
-             Retry command execution attempts when encountering ClusterDownError
-             or ConnectionError
-        :reinitialize_steps: 'int'
+        :param cluster_error_retry_attempts:
+             Number of times to retry before raising an error when
+             :class:`~.TimeoutError` or :class:`~.ConnectionError` or
+             :class:`~.ClusterDownError` are encountered
+        :param reinitialize_steps:
             Specifies the number of MOVED errors that need to occur before
             reinitializing the whole cluster topology. If a MOVED error occurs
             and the cluster does not need to be reinitialized on this current
@@ -540,6 +543,11 @@ def __init__(
         self.user_on_connect_func = kwargs.pop("redis_connect_func", None)
         kwargs.update({"redis_connect_func": self.on_connect})
         kwargs = cleanup_kwargs(**kwargs)
+        if retry:
+            self.retry = retry
+            kwargs.update({"retry": self.retry})
+        else:
+            kwargs.update({"retry": Retry(default_backoff(), 0)})
 
         self.encoder = Encoder(
             kwargs.get("encoding", "utf-8"),
@@ -666,6 +674,14 @@ def set_default_node(self, node):
         self.nodes_manager.default_node = node
         return True
 
+    def get_retry(self) -> Optional["Retry"]:
+        return self.retry
+
+    def set_retry(self, retry: "Retry") -> None:
+        self.retry = retry
+        for node in self.get_nodes():
+            node.redis_connection.set_retry(retry)
+
     def monitor(self, target_node=None):
         """
         Returns a Monitor object for the specified target node.
@@ -986,12 +1002,13 @@ def execute_command(self, *args, **kwargs):
         # nodes were passed to this function, we cannot retry the command
         # execution since the nodes may not be valid anymore after the tables
         # were reinitialized. So in case of passed target nodes,
-        # retry_attempts will be set to 1.
+        # retry_attempts will be set to 0.
         retry_attempts = (
-            1 if target_nodes_specified else self.cluster_error_retry_attempts
+            0 if target_nodes_specified else self.cluster_error_retry_attempts
         )
-        exception = None
-        for _ in range(0, retry_attempts):
+        # Add one for the first execution
+        execute_attempts = 1 + retry_attempts
+        for _ in range(execute_attempts):
             try:
                 res = {}
                 if not target_nodes_specified:
@@ -1008,18 +1025,15 @@ def execute_command(self, *args, **kwargs):
                 # Return the processed result
                 return self._process_result(args[0], res, **kwargs)
             except Exception as e:
-                if type(e) in self.__class__.ERRORS_ALLOW_RETRY:
+                if retry_attempts > 0 and type(e) in self.__class__.ERRORS_ALLOW_RETRY:
                     # The nodes and slots cache were reinitialized.
                     # Try again with the new cluster setup.
-                    exception = e
+                    retry_attempts -= 1
+                    continue
                 else:
-                    # All other errors should be raised.
+                    # raise the exception
                     raise e
 
-        # If it fails the configured number of times then raise exception back
-        # to caller of this method
-        raise exception
-
     def _execute_command(self, target_node, *args, **kwargs):
         """
         Send a command to a node in the cluster
@@ -1031,7 +1045,6 @@ def _execute_command(self, target_node, *args, **kwargs):
         asking = False
         moved = False
         ttl = int(self.RedisClusterRequestTTL)
-        connection_error_retry_counter = 0
 
         while ttl > 0:
             ttl -= 1
@@ -1064,25 +1077,21 @@ def _execute_command(self, target_node, *args, **kwargs):
             except AuthenticationError:
                 raise
             except (ConnectionError, TimeoutError) as e:
+                # Connection retries are being handled in the node's
+                # Retry object.
                 # ConnectionError can also be raised if we couldn't get a
                 # connection from the pool before timing out, so check that
                 # this is an actual connection before attempting to disconnect.
                 if connection is not None:
                     connection.disconnect()
-                connection_error_retry_counter += 1
-
-                # Give the node 0.25 seconds to get back up and retry again
-                # with same node and configuration. After 5 attempts then try
-                # to reinitialize the cluster and see if the nodes
-                # configuration has changed or not
-                if connection_error_retry_counter < 5:
-                    time.sleep(0.25)
-                else:
-                    # Hard force of reinitialize of the node/slots setup
-                    # and try again with the new setup
-                    target_node.redis_connection = None
-                    self.nodes_manager.initialize()
-                    raise e
+
+                # Remove the failed node from the startup nodes before we try
+                # to reinitialize the cluster
+                self.nodes_manager.startup_nodes.pop(target_node.name, None)
+                # Reset the cluster node's connection
+                target_node.redis_connection = None
+                self.nodes_manager.initialize()
+                raise e
             except MovedError as e:
                 # First, we will try to patch the slots/nodes cache with the
                 # redirected node output and try again. If MovedError exceeds
@@ -1406,17 +1415,15 @@ def initialize(self):
         startup_nodes_reachable = False
         fully_covered = False
         kwargs = self.connection_kwargs
+        exception = None
         for startup_node in self.startup_nodes.values():
             try:
                 if startup_node.redis_connection:
                     r = startup_node.redis_connection
                 else:
-                    # Create a new Redis connection and let Redis decode the
-                    # responses so we won't need to handle that
-                    copy_kwargs = copy.deepcopy(kwargs)
-                    copy_kwargs.update({"decode_responses": True, "encoding": "utf-8"})
+                    # Create a new Redis connection
                     r = self.create_redis_node(
-                        startup_node.host, startup_node.port, **copy_kwargs
+                        startup_node.host, startup_node.port, **kwargs
                     )
                     self.startup_nodes[startup_node.name].redis_connection = r
                 # Make sure cluster mode is enabled on this node
@@ -1426,25 +1433,11 @@ def initialize(self):
                     )
                 cluster_slots = str_if_bytes(r.execute_command("CLUSTER SLOTS"))
                 startup_nodes_reachable = True
-            except (ConnectionError, TimeoutError):
-                continue
-            except ResponseError as e:
-                # Isn't a cluster connection, so it won't parse these
-                # exceptions automatically
-                message = e.__str__()
-                if "CLUSTERDOWN" in message or "MASTERDOWN" in message:
-                    continue
-                else:
-                    raise RedisClusterException(
-                        'ERROR sending "cluster slots" command to redis '
-                        f"server: {startup_node}. error: {message}"
-                    )
             except Exception as e:
-                message = e.__str__()
-                raise RedisClusterException(
-                    'ERROR sending "cluster slots" command to redis '
-                    f"server {startup_node.name}. error: {message}"
-                )
+                # Try the next startup node.
+                # The exception is saved and raised only if we have no more nodes.
+                exception = e
+                continue
 
             # CLUSTER SLOTS command results in the following output:
             # [[slot_section[from_slot,to_slot,master,replica1,...,replicaN]]]
@@ -1514,9 +1507,9 @@ def initialize(self):
 
         if not startup_nodes_reachable:
             raise RedisClusterException(
-                "Redis Cluster cannot be connected. Please provide at least "
-                "one reachable node. "
-            )
+                f"Redis Cluster cannot be connected. Please provide at least "
+                f"one reachable node: {str(exception)}"
+            ) from exception
 
         # Create Redis connections to all nodes
         self.create_redis_connections(list(tmp_nodes_cache.values()))
@@ -1699,14 +1692,14 @@ class ClusterPipeline(RedisCluster):
 
     def __init__(
         self,
-        nodes_manager,
-        commands_parser,
-        result_callbacks=None,
-        cluster_response_callbacks=None,
-        startup_nodes=None,
-        read_from_replicas=False,
-        cluster_error_retry_attempts=5,
-        reinitialize_steps=10,
+        nodes_manager: "NodesManager",
+        commands_parser: "CommandsParser",
+        result_callbacks: Optional[Dict[str, Callable]] = None,
+        cluster_response_callbacks: Optional[Dict[str, Callable]] = None,
+        startup_nodes: Optional[List["ClusterNode"]] = None,
+        read_from_replicas: bool = False,
+        cluster_error_retry_attempts: int = 3,
+        reinitialize_steps: int = 5,
         lock=None,
         **kwargs,
     ):
@@ -1858,22 +1851,22 @@ def send_cluster_commands(
         """
         if not stack:
             return []
-
-        for _ in range(0, self.cluster_error_retry_attempts):
+        retry_attempts = self.cluster_error_retry_attempts
+        while True:
             try:
                 return self._send_cluster_commands(
                     stack,
                     raise_on_error=raise_on_error,
                     allow_redirections=allow_redirections,
                 )
-            except ClusterDownError:
-                # Try again with the new cluster setup. All other errors
-                # should be raised.
-                pass
-
-        # If it fails the configured number of times then raise
-        # exception back to caller of this method
-        raise ClusterDownError("CLUSTERDOWN error. Unable to rebuild the cluster")
+            except (ClusterDownError, ConnectionError) as e:
+                if retry_attempts > 0:
+                    # Try again with the new cluster setup. All other errors
+                    # should be raised.
+                    retry_attempts -= 1
+                    pass
+                else:
+                    raise e
 
     def _send_cluster_commands(
         self, stack, raise_on_error=True, allow_redirections=True
@@ -1898,7 +1891,6 @@ def _send_cluster_commands(
         # we figure out the slot number that command maps to, then from
         # the slot determine the node.
         for c in attempt:
-            connection_error_retry_counter = 0
             while True:
                 # refer to our internal node -> slot table that
                 # tells us where a given command should route to.
@@ -1931,13 +1923,10 @@ def _send_cluster_commands(
                     try:
                         connection = get_connection(redis_node, c.args)
                     except ConnectionError:
-                        connection_error_retry_counter += 1
-                        if connection_error_retry_counter < 5:
-                            # reinitialize the node -> slot table
-                            self.nodes_manager.initialize()
-                            continue
-                        else:
-                            raise
+                        # Connection retries are being handled in the node's
+                        # Retry object. Reinitialize the node -> slot table.
+                        self.nodes_manager.initialize()
+                        raise
                     nodes[node_name] = NodeCommands(
                         redis_node.parse_response,
                         redis_node.connection_pool,
diff --git a/redis/connection.py b/redis/connection.py
index a2b007406d..9c5b536f89 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -540,7 +540,7 @@ def __init__(
             # Add TimeoutError to the errors list to retry on
             retry_on_error.append(TimeoutError)
         self.retry_on_error = retry_on_error
-        if retry_on_error:
+        if retry or retry_on_error:
             if retry is None:
                 self.retry = Retry(NoBackoff(), 1)
             else:
@@ -1467,6 +1467,13 @@ def disconnect(self, inuse_connections=True):
             for connection in connections:
                 connection.disconnect()
 
+    def set_retry(self, retry: "Retry") -> None:
+        self.connection_kwargs.update({"retry": retry})
+        for conn in self._available_connections:
+            conn.retry = retry
+        for conn in self._in_use_connections:
+            conn.retry = retry
+
 
 class BlockingConnectionPool(ConnectionPool):
     """
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 27f11900c4..38bcaf6c00 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -13,6 +13,8 @@
 from redis.asyncio.cluster import ClusterNode, NodesManager, RedisCluster
 from redis.asyncio.connection import Connection, SSLConnection
 from redis.asyncio.parser import CommandsParser
+from redis.asyncio.retry import Retry
+from redis.backoff import ExponentialBackoff, NoBackoff, default_backoff
 from redis.cluster import PIPELINE_BLOCKED_COMMANDS, PRIMARY, REPLICA, get_node_name
 from redis.crc import REDIS_CLUSTER_HASH_SLOTS, key_slot
 from redis.exceptions import (
@@ -247,6 +249,76 @@ async def test_startup_nodes(self) -> None:
                 ]
             )
 
+    async def test_cluster_set_get_retry_object(self, request: FixtureRequest):
+        retry = Retry(NoBackoff(), 2)
+        url = request.config.getoption("--redis-url")
+        async with RedisCluster.from_url(url, retry=retry) as r:
+            assert r.get_retry()._retries == retry._retries
+            assert isinstance(r.get_retry()._backoff, NoBackoff)
+            for node in r.get_nodes():
+                n_retry = node.connection_kwargs.get("retry")
+                assert n_retry is not None
+                assert n_retry._retries == retry._retries
+                assert isinstance(n_retry._backoff, NoBackoff)
+            rand_cluster_node = r.get_random_node()
+            existing_conn = rand_cluster_node.acquire_connection()
+            # Change retry policy
+            new_retry = Retry(ExponentialBackoff(), 3)
+            r.set_retry(new_retry)
+            assert r.get_retry()._retries == new_retry._retries
+            assert isinstance(r.get_retry()._backoff, ExponentialBackoff)
+            for node in r.get_nodes():
+                n_retry = node.connection_kwargs.get("retry")
+                assert n_retry is not None
+                assert n_retry._retries == new_retry._retries
+                assert isinstance(n_retry._backoff, ExponentialBackoff)
+            assert existing_conn.retry._retries == new_retry._retries
+            new_conn = rand_cluster_node.acquire_connection()
+            assert new_conn.retry._retries == new_retry._retries
+
+    async def test_cluster_retry_object(self, request: FixtureRequest) -> None:
+        url = request.config.getoption("--redis-url")
+        async with RedisCluster.from_url(url) as rc_default:
+            # Test default retry
+            retry = rc_default.connection_kwargs.get("retry")
+            assert isinstance(retry, Retry)
+            assert retry._retries == 3
+            assert isinstance(retry._backoff, type(default_backoff()))
+            assert rc_default.get_node("127.0.0.1", 16379).connection_kwargs.get(
+                "retry"
+            ) == rc_default.get_node("127.0.0.1", 16380).connection_kwargs.get("retry")
+
+        retry = Retry(ExponentialBackoff(10, 5), 5)
+        async with RedisCluster.from_url(url, retry=retry) as rc_custom_retry:
+            # Test custom retry
+            assert (
+                rc_custom_retry.get_node("127.0.0.1", 16379).connection_kwargs.get(
+                    "retry"
+                )
+                == retry
+            )
+
+        async with RedisCluster.from_url(
+            url, connection_error_retry_attempts=0
+        ) as rc_no_retries:
+            # Test no connection retries
+            assert (
+                rc_no_retries.get_node("127.0.0.1", 16379).connection_kwargs.get(
+                    "retry"
+                )
+                is None
+            )
+
+        async with RedisCluster.from_url(
+            url, retry=Retry(NoBackoff(), 0)
+        ) as rc_no_retries:
+            assert (
+                rc_no_retries.get_node("127.0.0.1", 16379)
+                .connection_kwargs.get("retry")
+                ._retries
+                == 0
+            )
+
     async def test_empty_startup_nodes(self) -> None:
         """
         Test that exception is raised when empty providing empty startup_nodes
@@ -1289,8 +1361,11 @@ async def test_client_info(self, r: RedisCluster) -> None:
         assert "addr" in info
 
     @skip_if_server_version_lt("2.6.9")
-    async def test_client_kill(self, r: RedisCluster, r2: RedisCluster) -> None:
+    async def test_client_kill(
+        self, r: RedisCluster, create_redis: Callable[..., RedisCluster]
+    ) -> None:
         node = r.get_primaries()[0]
+        r2 = await create_redis(cls=RedisCluster, flushdb=False)
         await r.client_setname("redis-py-c1", target_nodes="all")
         await r2.client_setname("redis-py-c2", target_nodes="all")
         clients = [
@@ -1311,6 +1386,7 @@ async def test_client_kill(self, r: RedisCluster, r2: RedisCluster) -> None:
         ]
         assert len(clients) == 1
         assert clients[0].get("name") == "redis-py-c1"
+        await r2.close()
 
     @skip_if_server_version_lt("2.6.0")
     async def test_cluster_bitop_not_empty_string(self, r: RedisCluster) -> None:
diff --git a/tests/test_asyncio/test_retry.py b/tests/test_asyncio/test_retry.py
index 38e353bc36..86e6ddfa0d 100644
--- a/tests/test_asyncio/test_retry.py
+++ b/tests/test_asyncio/test_retry.py
@@ -1,8 +1,9 @@
 import pytest
 
+from redis.asyncio import Redis
 from redis.asyncio.connection import Connection, UnixDomainSocketConnection
 from redis.asyncio.retry import Retry
-from redis.backoff import AbstractBackoff, NoBackoff
+from redis.backoff import AbstractBackoff, ExponentialBackoff, NoBackoff
 from redis.exceptions import ConnectionError, TimeoutError
 
 
@@ -114,3 +115,22 @@ async def test_infinite_retry(self):
 
         assert self.actual_attempts == 5
         assert self.actual_failures == 5
+
+
+class TestRedisClientRetry:
+    "Test the Redis client behavior with retries"
+
+    async def test_get_set_retry_object(self, request):
+        retry = Retry(NoBackoff(), 2)
+        url = request.config.getoption("--redis-url")
+        r = await Redis.from_url(url, retry_on_timeout=True, retry=retry)
+        assert r.get_retry()._retries == retry._retries
+        assert isinstance(r.get_retry()._backoff, NoBackoff)
+        new_retry_policy = Retry(ExponentialBackoff(), 3)
+        exiting_conn = await r.connection_pool.get_connection("_")
+        r.set_retry(new_retry_policy)
+        assert r.get_retry()._retries == new_retry_policy._retries
+        assert isinstance(r.get_retry()._backoff, ExponentialBackoff)
+        assert exiting_conn.retry._retries == new_retry_policy._retries
+        new_conn = await r.connection_pool.get_connection("_")
+        assert new_conn.retry._retries == new_retry_policy._retries
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 5652673af9..d18fbbbb33 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -7,6 +7,7 @@
 import pytest
 
 from redis import Redis
+from redis.backoff import ExponentialBackoff, NoBackoff, default_backoff
 from redis.cluster import (
     PRIMARY,
     REDIS_CLUSTER_HASH_SLOTS,
@@ -31,6 +32,7 @@
     ResponseError,
     TimeoutError,
 )
+from redis.retry import Retry
 from redis.utils import str_if_bytes
 from tests.test_pubsub import wait_for_message
 
@@ -358,6 +360,60 @@ def ok_response(connection, *args, **options):
 
             assert r.execute_command("SET", "foo", "bar") == "MOCK_OK"
 
+    def test_handling_cluster_failover_to_a_replica(self, r):
+        # Set the key we'll test for
+        key = "key"
+        r.set("key", "value")
+        primary = r.get_node_from_key(key, replica=False)
+        assert str_if_bytes(r.get("key")) == "value"
+        # Get the current output of cluster slots
+        cluster_slots = primary.redis_connection.execute_command("CLUSTER SLOTS")
+        replica_host = ""
+        replica_port = 0
+        # Replace one of the replicas to be the new primary based on the
+        # cluster slots output
+        for slot_range in cluster_slots:
+            primary_port = slot_range[2][1]
+            if primary_port == primary.port:
+                if len(slot_range) <= 3:
+                    # cluster doesn't have a replica, return
+                    return
+                replica_host = str_if_bytes(slot_range[3][0])
+                replica_port = slot_range[3][1]
+                # replace replica and primary in the cluster slots output
+                tmp_node = slot_range[2]
+                slot_range[2] = slot_range[3]
+                slot_range[3] = tmp_node
+                break
+
+        def raise_connection_error():
+            raise ConnectionError("error")
+
+        def mock_execute_command(*_args, **_kwargs):
+            if _args[0] == "CLUSTER SLOTS":
+                return cluster_slots
+            else:
+                raise Exception("Failed to mock cluster slots")
+
+        # Mock connection error for the current primary
+        mock_node_resp_func(primary, raise_connection_error)
+        primary.redis_connection.set_retry(Retry(NoBackoff(), 1))
+
+        # Mock the cluster slots response for all other nodes
+        redis_mock_node = Mock()
+        redis_mock_node.execute_command.side_effect = mock_execute_command
+        # Mock response value for all other commands
+        redis_mock_node.parse_response.return_value = "MOCK_OK"
+        for node in r.get_nodes():
+            if node.port != primary.port:
+                node.redis_connection = redis_mock_node
+
+        assert r.get(key) == "MOCK_OK"
+        new_primary = r.get_node_from_key(key, replica=False)
+        assert new_primary.host == replica_host
+        assert new_primary.port == replica_port
+        assert r.get_node(primary.host, primary.port).server_type == REPLICA
+
     def test_moved_redirection(self, request):
         """
         Test that the client handles MOVED response.
@@ -691,6 +747,50 @@ def moved_redirect_effect(connection, *args, **options):
                     cur_node = r.get_node(node_name=node_name)
                     assert conn == r.get_redis_connection(cur_node)
 
+    def test_cluster_get_set_retry_object(self, request):
+        retry = Retry(NoBackoff(), 2)
+        r = _get_client(RedisCluster, request, retry=retry)
+        assert r.get_retry()._retries == retry._retries
+        assert isinstance(r.get_retry()._backoff, NoBackoff)
+        for node in r.get_nodes():
+            assert node.redis_connection.get_retry()._retries == retry._retries
+            assert isinstance(node.redis_connection.get_retry()._backoff, NoBackoff)
+        rand_node = r.get_random_node()
+        existing_conn = rand_node.redis_connection.connection_pool.get_connection("_")
+        # Change retry policy
+        new_retry = Retry(ExponentialBackoff(), 3)
+        r.set_retry(new_retry)
+        assert r.get_retry()._retries == new_retry._retries
+        assert isinstance(r.get_retry()._backoff, ExponentialBackoff)
+        for node in r.get_nodes():
+            assert node.redis_connection.get_retry()._retries == new_retry._retries
+            assert isinstance(
+                node.redis_connection.get_retry()._backoff, ExponentialBackoff
+            )
+        assert existing_conn.retry._retries == new_retry._retries
+        new_conn = rand_node.redis_connection.connection_pool.get_connection("_")
+        assert new_conn.retry._retries == new_retry._retries
+
+    def test_cluster_retry_object(self, r) -> None:
+        # Test default retry
+        retry = r.get_connection_kwargs().get("retry")
+        assert isinstance(retry, Retry)
+        assert retry._retries == 0
+        assert isinstance(retry._backoff, type(default_backoff()))
+        node1 = r.get_node("127.0.0.1", 16379).redis_connection
+        node2 = r.get_node("127.0.0.1", 16380).redis_connection
+        assert node1.get_retry()._retries == node2.get_retry()._retries
+
+        # Test custom retry
+        retry = Retry(ExponentialBackoff(10, 5), 5)
+        rc_custom_retry = RedisCluster("127.0.0.1", 16379, retry=retry)
+        assert (
+            rc_custom_retry.get_node("127.0.0.1", 16379)
+            .redis_connection.get_retry()
+            ._retries
+            == retry._retries
+        )
+
 
 @pytest.mark.onlycluster
 class TestClusterRedisCommands:
diff --git a/tests/test_retry.py b/tests/test_retry.py
index f844fd0a12..3cfea5c09e 100644
--- a/tests/test_retry.py
+++ b/tests/test_retry.py
@@ -2,7 +2,7 @@
 
 import pytest
 
-from redis.backoff import NoBackoff
+from redis.backoff import ExponentialBackoff, NoBackoff
 from redis.client import Redis
 from redis.connection import Connection, UnixDomainSocketConnection
 from redis.exceptions import (
@@ -203,3 +203,17 @@ def test_client_retry_on_timeout(self, request):
                     r.get("foo")
                 finally:
                     assert parse_response.call_count == retries + 1
+
+    def test_get_set_retry_object(self, request):
+        retry = Retry(NoBackoff(), 2)
+        r = _get_client(Redis, request, retry_on_timeout=True, retry=retry)
+        exist_conn = r.connection_pool.get_connection("_")
+        assert r.get_retry()._retries == retry._retries
+        assert isinstance(r.get_retry()._backoff, NoBackoff)
+        new_retry_policy = Retry(ExponentialBackoff(), 3)
+        r.set_retry(new_retry_policy)
+        assert r.get_retry()._retries == new_retry_policy._retries
+        assert isinstance(r.get_retry()._backoff, ExponentialBackoff)
+        assert exist_conn.retry._retries == new_retry_policy._retries
+        new_conn = r.connection_pool.get_connection("_")
+        assert new_conn.retry._retries == new_retry_policy._retries

From fa45fb13730c6ece6b08184b4f475d841895b4d4 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 10 Nov 2022 16:16:52 +0200
Subject: [PATCH 0621/1164] Version 4.4.0rc4 (#2451)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 745d71ba92..a8928f4158 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.4.0rc3",
+    version="4.4.0rc4",
     packages=find_packages(
         include=[
             "redis",

From af44021f3a595637b4ef2c3a873d628b309905a1 Mon Sep 17 00:00:00 2001
From: Luca Cillario <luca.cillario.95@gmail.com>
Date: Mon, 21 Nov 2022 11:03:19 +0100
Subject: [PATCH 0622/1164] Retry documentation. (#2166) (#2456)

* Retry documentation. (#2166)

* Fixed typo.

* Update docs/retry.rst

Co-authored-by: Nermina Miller <102551568+nermiller@users.noreply.github.com>

* Update docs/retry.rst

Co-authored-by: Nermina Miller <102551568+nermiller@users.noreply.github.com>

* Update docs/retry.rst

Co-authored-by: Nermina Miller <102551568+nermiller@users.noreply.github.com>

* Update docs/retry.rst

Co-authored-by: Nermina Miller <102551568+nermiller@users.noreply.github.com>

* Update docs/retry.rst

Co-authored-by: Nermina Miller <102551568+nermiller@users.noreply.github.com>

* Update docs/retry.rst

Co-authored-by: Nermina Miller <102551568+nermiller@users.noreply.github.com>

* Update docs/retry.rst

Co-authored-by: Nermina Miller <102551568+nermiller@users.noreply.github.com>

* Update docs/retry.rst

Co-authored-by: Nermina Miller <102551568+nermiller@users.noreply.github.com>

Co-authored-by: Nermina Miller <102551568+nermiller@users.noreply.github.com>
---
 docs/backoff.rst    |  2 ++
 docs/exceptions.rst |  2 +-
 docs/retry.rst      | 67 ++++++++++++++++++++++++++++++++++++++++++++-
 3 files changed, 69 insertions(+), 2 deletions(-)

diff --git a/docs/backoff.rst b/docs/backoff.rst
index e640b5682e..c5ab01ab03 100644
--- a/docs/backoff.rst
+++ b/docs/backoff.rst
@@ -1,3 +1,5 @@
+.. _backoff-label:
+
 Backoff
 #############
 
diff --git a/docs/exceptions.rst b/docs/exceptions.rst
index b8aeb33e49..8a9fe457fb 100644
--- a/docs/exceptions.rst
+++ b/docs/exceptions.rst
@@ -1,4 +1,4 @@
-
+.. _exceptions-label:
 
 Exceptions
 ##########
diff --git a/docs/retry.rst b/docs/retry.rst
index 2b4f22c2f6..acf198ec94 100644
--- a/docs/retry.rst
+++ b/docs/retry.rst
@@ -2,4 +2,69 @@ Retry Helpers
 #############
 
 .. automodule:: redis.retry
-    :members: 
\ No newline at end of file
+    :members:
+
+
+Retry in Redis Standalone
+**************************
+
+>>> from redis.backoff import ExponentialBackoff
+>>> from redis.retry import Retry
+>>> from redis.client import Redis
+>>> from redis.exceptions import (
+>>>    BusyLoadingError,
+>>>    ConnectionError,
+>>>    TimeoutError
+>>> )
+>>>
+>>> # Run 3 retries with exponential backoff strategy
+>>> retry = Retry(ExponentialBackoff(), 3)
+>>> # Redis client with retries on custom errors
+>>> r = Redis(host='localhost', port=6379, retry=retry, retry_on_error=[BusyLoadingError, ConnectionError, TimeoutError])
+>>> # Redis client with retries on TimeoutError only
+>>> r_only_timeout = Redis(host='localhost', port=6379, retry=retry, retry_on_timeout=True)
+
+As you can see from the example above, Redis client supports 3 parameters to configure the retry behaviour:
+
+* ``retry``: :class:`~.Retry` instance with a :ref:`backoff-label` strategy and the max number of retries
+* ``retry_on_error``: list of :ref:`exceptions-label` to retry on
+* ``retry_on_timeout``: if ``True``, retry on :class:`~.TimeoutError` only
+
+If either ``retry_on_error`` or ``retry_on_timeout`` are passed and no ``retry`` is given,
+by default it uses a ``Retry(NoBackoff(), 1)`` (meaning 1 retry right after the first failure).
+
+
+Retry in Redis Cluster
+**************************
+
+>>> from redis.backoff import ExponentialBackoff
+>>> from redis.retry import Retry
+>>> from redis.cluster import RedisCluster
+>>>
+>>> # Run 3 retries with exponential backoff strategy
+>>> retry = Retry(ExponentialBackoff(), 3)
+>>> # Redis Cluster client with retries
+>>> rc = RedisCluster(host='localhost', port=6379, retry=retry, cluster_error_retry_attempts=2)
+
+Retry behaviour in Redis Cluster is a little bit different from Standalone:
+
+* ``retry``: :class:`~.Retry` instance with a :ref:`backoff-label` strategy and the max number of retries, default value is ``Retry(NoBackoff(), 0)``
+* ``cluster_error_retry_attempts``: number of times to retry before raising an error when :class:`~.TimeoutError` or :class:`~.ConnectionError` or :class:`~.ClusterDownError` are encountered, default value is ``3``
+
+Let's consider the following example:
+
+>>> from redis.backoff import ExponentialBackoff
+>>> from redis.retry import Retry
+>>> from redis.cluster import RedisCluster
+>>>
+>>> rc = RedisCluster(host='localhost', port=6379, retry=Retry(ExponentialBackoff(), 6), cluster_error_retry_attempts=1)
+>>> rc.set('foo', 'bar')
+
+#. the client library calculates the hash slot for key 'foo'.
+#. given the hash slot, it then determines which node to connect to, in order to execute the command.
+#. during the connection, a :class:`~.ConnectionError` is raised.
+#. because we set ``retry=Retry(ExponentialBackoff(), 6)``, the client tries to reconnect to the node up to 6 times, with an exponential backoff between each attempt.
+#. even after 6 retries, the client is still unable to connect.
+#. because we set ``cluster_error_retry_attempts=1``, before giving up, the client starts a cluster update, removes the failed node from the startup nodes, and re-initializes the cluster.
+#. after the cluster has been re-initialized, it starts a new cycle of retries, up to 6 retries, with an exponential backoff.
+#. if the client can connect, we're good. Otherwise, the exception is finally raised to the caller, because we've run out of attempts.
\ No newline at end of file

From 59c8e7d05a5cf79c933f0c7e0fef0dfee93b0ed4 Mon Sep 17 00:00:00 2001
From: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Date: Mon, 21 Nov 2022 12:03:53 +0200
Subject: [PATCH 0623/1164] Removed bad tokens from connection_examples.ipynb
 to fix the json output (#2455)

---
 docs/examples/connection_examples.ipynb | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/docs/examples/connection_examples.ipynb b/docs/examples/connection_examples.ipynb
index ca8dd443c6..a15b4c6cc0 100644
--- a/docs/examples/connection_examples.ipynb
+++ b/docs/examples/connection_examples.ipynb
@@ -116,7 +116,6 @@
     "user_connection.ping()"
    ],
    "metadata": {}
-   }
   },
   {
    "cell_type": "markdown",
@@ -124,7 +123,6 @@
     "## Connecting to a redis instance with standard credential provider"
    ],
    "metadata": {}
-   }
   },
   {
    "cell_type": "code",
@@ -162,7 +160,6 @@
     "user_connection.ping()"
    ],
    "metadata": {}
-   }
   },
   {
    "cell_type": "markdown",
@@ -170,7 +167,6 @@
     "## Connecting to a redis instance first with an initial credential set and then calling the credential provider"
    ],
    "metadata": {}
-   }
   },
   {
    "cell_type": "code",
@@ -200,7 +196,6 @@
     "cred_provider = InitCredsSetCredentialProvider(username=\"init_user\", password=\"init_pass\")"
    ],
    "metadata": {}
-   }
   },
   {
    "cell_type": "markdown",

From e425674d84a63762f16d5b44b19aa70119fcd814 Mon Sep 17 00:00:00 2001
From: SyedTahaA <62918944+SyedTahaA@users.noreply.github.com>
Date: Mon, 21 Nov 2022 05:57:30 -0500
Subject: [PATCH 0624/1164] Fix Sentinel.execute_command to execute across the
 entire sentinel cluster  (#2459)

* Change sentinel execute command to execute across the entire cluster

* Add change to CHANGES file
---
 CHANGES           | 1 +
 redis/sentinel.py | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/CHANGES b/CHANGES
index 883c548f38..c0b183e8e3 100644
--- a/CHANGES
+++ b/CHANGES
@@ -28,6 +28,7 @@
     * Fixed "cannot pickle '_thread.lock' object" bug (#2354, #2297)
     * Added CredentialsProvider class to support password rotation
     * Enable Lock for asyncio cluster mode
+    * Fix Sentinel.execute_command doesn't execute across the entire sentinel cluster bug (#2458)
 
 * 4.1.3 (Feb 8, 2022)
     * Fix flushdb and flushall (#1926)
diff --git a/redis/sentinel.py b/redis/sentinel.py
index d35abaf514..d70b7142b5 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -200,10 +200,10 @@ def execute_command(self, *args, **kwargs):
             kwargs.pop("once")
 
         if once:
+            random.choice(self.sentinels).execute_command(*args, **kwargs)
+        else:
             for sentinel in self.sentinels:
                 sentinel.execute_command(*args, **kwargs)
-        else:
-            random.choice(self.sentinels).execute_command(*args, **kwargs)
         return True
 
     def __repr__(self):

From e3e223bbd9ac49c8f17d0eec518caa55c55cc92e Mon Sep 17 00:00:00 2001
From: Alex <aleksandrosansan@gmail.com>
Date: Mon, 21 Nov 2022 14:25:29 +0200
Subject: [PATCH 0625/1164] GitHub Workflows security hardening (#2444)

* build: harden pypi-publish.yaml permissions

Signed-off-by: Alex <aleksandrosansan@gmail.com>

* build: harden stale-issues.yml permissions

Signed-off-by: Alex <aleksandrosansan@gmail.com>

* build: harden release-drafter.yml permissions

Signed-off-by: Alex <aleksandrosansan@gmail.com>

* build: harden integration.yaml permissions

Signed-off-by: Alex <aleksandrosansan@gmail.com>

Signed-off-by: Alex <aleksandrosansan@gmail.com>
Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 .github/workflows/integration.yaml    | 3 +++
 .github/workflows/pypi-publish.yaml   | 3 +++
 .github/workflows/release-drafter.yml | 5 +++++
 .github/workflows/stale-issues.yml    | 5 +++++
 4 files changed, 16 insertions(+)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index c2b84a6074..8d38cd45c7 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -16,6 +16,9 @@ on:
   schedule:
     - cron: '0 1 * * *' # nightly build
 
+permissions:
+  contents: read  #  to fetch code (actions/checkout)
+
 jobs:
 
    dependency-audit:
diff --git a/.github/workflows/pypi-publish.yaml b/.github/workflows/pypi-publish.yaml
index 3e7f80136c..50332c1995 100644
--- a/.github/workflows/pypi-publish.yaml
+++ b/.github/workflows/pypi-publish.yaml
@@ -4,6 +4,9 @@ on:
   release:
     types: [published]
 
+permissions:
+  contents: read  #  to fetch code (actions/checkout)
+
 jobs:
 
   build_and_package:
diff --git a/.github/workflows/release-drafter.yml b/.github/workflows/release-drafter.yml
index ec2d88bf6e..eebb3e678b 100644
--- a/.github/workflows/release-drafter.yml
+++ b/.github/workflows/release-drafter.yml
@@ -6,8 +6,13 @@ on:
     branches:
       - master
 
+permissions: {}
 jobs:
   update_release_draft:
+    permissions:
+      pull-requests: write  #  to add label to PR (release-drafter/release-drafter)
+      contents: write  #  to create a github release (release-drafter/release-drafter)
+
     runs-on: ubuntu-latest
     steps:
       # Drafts your next Release notes as Pull Requests are merged into "master"
diff --git a/.github/workflows/stale-issues.yml b/.github/workflows/stale-issues.yml
index 562cd582b1..32fd9e8179 100644
--- a/.github/workflows/stale-issues.yml
+++ b/.github/workflows/stale-issues.yml
@@ -3,8 +3,13 @@ on:
   schedule:
   - cron: "0 0 * * *"
 
+permissions: {}
 jobs:
   stale:
+    permissions:
+      issues: write  #  to close stale issues (actions/stale)
+      pull-requests: write  #  to close stale PRs (actions/stale)
+
     runs-on: ubuntu-latest
     steps:
     - uses: actions/stale@v3

From f492f85af723b277fa1ec99f01e6612e5d567b3f Mon Sep 17 00:00:00 2001
From: Igor Malinovskiy <u.glide@gmail.com>
Date: Mon, 21 Nov 2022 23:24:15 +0100
Subject: [PATCH 0626/1164] Install package deps in readthedocs build (#2465)

Dependencies are required for "automodule" generation.

Co-authored-by: Igor Malinovskiy <igor.malinovskiy@redis.com>
Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 .readthedocs.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.readthedocs.yml b/.readthedocs.yml
index 80b9738d82..800cb14816 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -3,6 +3,7 @@ version: 2
 python:
   install:
     - requirements: ./docs/requirements.txt
+    - requirements: requirements.txt
 
 build:
   os: ubuntu-20.04

From dfe2152b162634c338aa05ae427d6024994ee7b8 Mon Sep 17 00:00:00 2001
From: Nermina Miller <102551568+nermiller@users.noreply.github.com>
Date: Wed, 30 Nov 2022 09:30:28 -0500
Subject: [PATCH 0627/1164] Adding connection step to bloom filter examples
 (#2478)

* Fixes #2415, adds a connect step to bloom commands

* Update redismodules.rst

Apply feedback
---
 docs/redismodules.rst | 24 ++++++++++++++----------
 1 file changed, 14 insertions(+), 10 deletions(-)

diff --git a/docs/redismodules.rst b/docs/redismodules.rst
index cf31b2973b..f764d821fd 100644
--- a/docs/redismodules.rst
+++ b/docs/redismodules.rst
@@ -12,25 +12,28 @@ These are the commands for interacting with the `RedisBloom module <https://redi
 **Create and add to a bloom filter**
 
 .. code-block:: python
-
-    import redis
-    filter = redis.bf().create("bloom", 0.01, 1000)
-    filter.add("bloom", "foo")
+   
+    import redis 
+    r = redis.Redis()
+    r.bf().create("bloom", 0.01, 1000) 
+    r.bf().add("bloom", "foo")
 
 **Create and add to a cuckoo filter**
 
 .. code-block:: python
 
-    import redis
-    filter = redis.cf().create("cuckoo", 1000)
-    filter.add("cuckoo", "filter")
+    import redis 
+    r = redis.Redis()
+    r.cf().create("cuckoo", 1000)
+    r.cf().add("cuckoo", "filter")
 
 **Create Count-Min Sketch and get information**
 
 .. code-block:: python
 
     import redis
-    r = redis.cms().initbydim("dim", 1000, 5)
+    r = redis.Redis()
+    r.cms().initbydim("dim", 1000, 5)
     r.cms().incrby("dim", ["foo"], [5])
     r.cms().info("dim")
 
@@ -39,8 +42,9 @@ These are the commands for interacting with the `RedisBloom module <https://redi
 .. code-block:: python
 
     import redis
-    r = redis.topk().reserve("mytopk", 3, 50, 4, 0.9)
-    info = r.topk().info("mytopk)
+    r = redis.Redis()
+    r.topk().reserve("mytopk", 3, 50, 4, 0.9)
+    r.topk().info("mytopk)
 
 .. automodule:: redis.commands.bf.commands
     :members: BFCommands, CFCommands, CMSCommands, TOPKCommands

From f4d07dddba55a73df6b015b363d2ea7c96716ae5 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 1 Dec 2022 13:16:14 +0200
Subject: [PATCH 0628/1164] Wrong number of arguments for `geosearch` command
 (#2464)

Co-authored-by: Chayim <chayim@users.noreply.github.com>
Fixes https://github.com/redis/redis-py/issues/2462
---
 redis/commands/core.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 3be2823a7a..1625e10d9c 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -5581,7 +5581,7 @@ def _geosearchgeneric(
                     "GEOSEARCH member and longitude or latitude" " cant be set together"
                 )
             pieces.extend([b"FROMMEMBER", kwargs["member"]])
-        if kwargs["longitude"] and kwargs["latitude"]:
+        if kwargs["longitude"] is not None and kwargs["latitude"] is not None:
             pieces.extend([b"FROMLONLAT", kwargs["longitude"], kwargs["latitude"]])
 
         # BYRADIUS or BYBOX

From 2c121552faf0d39267969b62ce0c3276391b37cc Mon Sep 17 00:00:00 2001
From: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Date: Thu, 1 Dec 2022 13:16:26 +0200
Subject: [PATCH 0629/1164] Added a replacement for the default cluster node in
 the event of failure. (#2463)

---
 CHANGES                            |  1 +
 redis/asyncio/cluster.py           | 22 ++++++++++++++-
 redis/cluster.py                   | 45 ++++++++++++++++++++++++++++--
 tests/test_asyncio/test_cluster.py | 40 ++++++++++++++++++++++++++
 tests/test_cluster.py              | 23 +++++++++++++++
 5 files changed, 128 insertions(+), 3 deletions(-)

diff --git a/CHANGES b/CHANGES
index c0b183e8e3..b16fbce464 100644
--- a/CHANGES
+++ b/CHANGES
@@ -29,6 +29,7 @@
     * Added CredentialsProvider class to support password rotation
     * Enable Lock for asyncio cluster mode
     * Fix Sentinel.execute_command doesn't execute across the entire sentinel cluster bug (#2458)
+    * Added a replacement for the default cluster node in the event of failure (#2463)
 
 * 4.1.3 (Feb 8, 2022)
     * Fix flushdb and flushall (#1926)
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index d5a38b2878..e0e77c74ae 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -517,6 +517,8 @@ def set_response_callback(self, command: str, callback: ResponseCallbackT) -> No
     async def _determine_nodes(
         self, command: str, *args: Any, node_flag: Optional[str] = None
     ) -> List["ClusterNode"]:
+        # Determine which nodes should be executed the command on.
+        # Returns a list of target nodes.
         if not node_flag:
             # get the nodes group for this command if it was predefined
             node_flag = self.command_flags.get(command)
@@ -654,6 +656,12 @@ async def execute_command(self, *args: EncodableT, **kwargs: Any) -> Any:
         for _ in range(execute_attempts):
             if self._initialize:
                 await self.initialize()
+                if (
+                    len(target_nodes) == 1
+                    and target_nodes[0] == self.get_default_node()
+                ):
+                    # Replace the default cluster node
+                    self.replace_default_node()
             try:
                 if not target_nodes_specified:
                     # Determine the nodes to execute the command on
@@ -1450,7 +1458,6 @@ async def _execute(
                     )
             if len(target_nodes) > 1:
                 raise RedisClusterException(f"Too many targets for command {cmd.args}")
-
             node = target_nodes[0]
             if node.name not in nodes:
                 nodes[node.name] = (node, [])
@@ -1487,6 +1494,19 @@ async def _execute(
                         result.args = (msg,) + result.args[1:]
                         raise result
 
+            default_node = nodes.get(client.get_default_node().name)
+            if default_node is not None:
+                # This pipeline execution used the default node, check if we need
+                # to replace it.
+                # Note: when the error is raised we'll reset the default node in the
+                # caller function.
+                for cmd in default_node[1]:
+                    # Check if it has a command that failed with a relevant
+                    # exception
+                    if type(cmd.result) in self.__class__.ERRORS_ALLOW_RETRY:
+                        client.replace_default_node()
+                        break
+
         return [cmd.result for cmd in stack]
 
     def _split_command_across_slots(
diff --git a/redis/cluster.py b/redis/cluster.py
index 91deaead59..0b2c4f1387 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -379,6 +379,30 @@ class AbstractRedisCluster:
 
     ERRORS_ALLOW_RETRY = (ConnectionError, TimeoutError, ClusterDownError)
 
+    def replace_default_node(self, target_node: "ClusterNode" = None) -> None:
+        """Replace the default cluster node.
+        A random cluster node will be chosen if target_node isn't passed, and primaries
+        will be prioritized. The default node will not be changed if there are no other
+        nodes in the cluster.
+
+        Args:
+            target_node (ClusterNode, optional): Target node to replace the default
+            node. Defaults to None.
+        """
+        if target_node:
+            self.nodes_manager.default_node = target_node
+        else:
+            curr_node = self.get_default_node()
+            primaries = [node for node in self.get_primaries() if node != curr_node]
+            if primaries:
+                # Choose a primary if the cluster contains different primaries
+                self.nodes_manager.default_node = random.choice(primaries)
+            else:
+                # Otherwise, hoose a primary if the cluster contains different primaries
+                replicas = [node for node in self.get_replicas() if node != curr_node]
+                if replicas:
+                    self.nodes_manager.default_node = random.choice(replicas)
+
 
 class RedisCluster(AbstractRedisCluster, RedisClusterCommands):
     @classmethod
@@ -811,7 +835,9 @@ def set_response_callback(self, command, callback):
         """Set a custom Response Callback"""
         self.cluster_response_callbacks[command] = callback
 
-    def _determine_nodes(self, *args, **kwargs):
+    def _determine_nodes(self, *args, **kwargs) -> List["ClusterNode"]:
+        # Determine which nodes should be executed the command on.
+        # Returns a list of target nodes.
         command = args[0].upper()
         if len(args) >= 2 and f"{args[0]} {args[1]}".upper() in self.command_flags:
             command = f"{args[0]} {args[1]}".upper()
@@ -990,6 +1016,7 @@ def execute_command(self, *args, **kwargs):
             dict<Any, ClusterNode>
         """
         target_nodes_specified = False
+        is_default_node = False
         target_nodes = None
         passed_targets = kwargs.pop("target_nodes", None)
         if passed_targets is not None and not self._is_nodes_flag(passed_targets):
@@ -1020,12 +1047,20 @@ def execute_command(self, *args, **kwargs):
                         raise RedisClusterException(
                             f"No targets were found to execute {args} command on"
                         )
+                    if (
+                        len(target_nodes) == 1
+                        and target_nodes[0] == self.get_default_node()
+                    ):
+                        is_default_node = True
                 for node in target_nodes:
                     res[node.name] = self._execute_command(node, *args, **kwargs)
                 # Return the processed result
                 return self._process_result(args[0], res, **kwargs)
             except Exception as e:
                 if retry_attempts > 0 and type(e) in self.__class__.ERRORS_ALLOW_RETRY:
+                    if is_default_node:
+                        # Replace the default cluster node
+                        self.replace_default_node()
                     # The nodes and slots cache were reinitialized.
                     # Try again with the new cluster setup.
                     retry_attempts -= 1
@@ -1883,7 +1918,7 @@ def _send_cluster_commands(
         # if we have to run through it again, we only retry
         # the commands that failed.
         attempt = sorted(stack, key=lambda x: x.position)
-
+        is_default_node = False
         # build a list of node objects based on node names we need to
         nodes = {}
 
@@ -1913,6 +1948,8 @@ def _send_cluster_commands(
                     )
 
                 node = target_nodes[0]
+                if node == self.get_default_node():
+                    is_default_node = True
 
                 # now that we know the name of the node
                 # ( it's just a string in the form of host:port )
@@ -1926,6 +1963,8 @@ def _send_cluster_commands(
                         # Connection retries are being handled in the node's
                         # Retry object. Reinitialize the node -> slot table.
                         self.nodes_manager.initialize()
+                        if is_default_node:
+                            self.replace_default_node()
                         raise
                     nodes[node_name] = NodeCommands(
                         redis_node.parse_response,
@@ -2007,6 +2046,8 @@ def _send_cluster_commands(
             self.reinitialize_counter += 1
             if self._should_reinitialized():
                 self.nodes_manager.initialize()
+                if is_default_node:
+                    self.replace_default_node()
             for c in attempt:
                 try:
                     # send each command individually like we
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 38bcaf6c00..1997c9520b 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -788,6 +788,27 @@ async def test_can_run_concurrent_commands(self, request: FixtureRequest) -> Non
         )
         await rc.close()
 
+    def test_replace_cluster_node(self, r: RedisCluster) -> None:
+        prev_default_node = r.get_default_node()
+        r.replace_default_node()
+        assert r.get_default_node() != prev_default_node
+        r.replace_default_node(prev_default_node)
+        assert r.get_default_node() == prev_default_node
+
+    async def test_default_node_is_replaced_after_exception(self, r):
+        curr_default_node = r.get_default_node()
+        # CLUSTER NODES command is being executed on the default node
+        nodes = await r.cluster_nodes()
+        assert "myself" in nodes.get(curr_default_node.name).get("flags")
+        # Mock connection error for the default node
+        mock_node_resp_exc(curr_default_node, ConnectionError("error"))
+        # Test that the command succeed from a different node
+        nodes = await r.cluster_nodes()
+        assert "myself" not in nodes.get(curr_default_node.name).get("flags")
+        assert r.get_default_node() != curr_default_node
+        # Rollback to the old default node
+        r.replace_default_node(curr_default_node)
+
 
 class TestClusterRedisCommands:
     """
@@ -2591,6 +2612,25 @@ async def test_can_run_concurrent_pipelines(self, r: RedisCluster) -> None:
             *(self.test_multi_key_operation_with_multi_slots(r) for i in range(100)),
         )
 
+    @pytest.mark.onlycluster
+    async def test_pipeline_with_default_node_error_command(self, create_redis):
+        """
+        Test that the default node is being replaced when it raises a relevant exception
+        """
+        r = await create_redis(cls=RedisCluster, flushdb=False)
+        curr_default_node = r.get_default_node()
+        err = ConnectionError("error")
+        cmd_count = await r.command_count()
+        mock_node_resp_exc(curr_default_node, err)
+        async with r.pipeline(transaction=False) as pipe:
+            pipe.command_count()
+            result = await pipe.execute(raise_on_error=False)
+            assert result[0] == err
+            assert r.get_default_node() != curr_default_node
+            pipe.command_count()
+            result = await pipe.execute(raise_on_error=False)
+            assert result[0] == cmd_count
+
 
 @pytest.mark.ssl
 class TestSSL:
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index d18fbbbb33..43aeb9e045 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -791,6 +791,29 @@ def test_cluster_retry_object(self, r) -> None:
             == retry._retries
         )
 
+    def test_replace_cluster_node(self, r) -> None:
+        prev_default_node = r.get_default_node()
+        r.replace_default_node()
+        assert r.get_default_node() != prev_default_node
+        r.replace_default_node(prev_default_node)
+        assert r.get_default_node() == prev_default_node
+
+    def test_default_node_is_replaced_after_exception(self, r):
+        curr_default_node = r.get_default_node()
+        # CLUSTER NODES command is being executed on the default node
+        nodes = r.cluster_nodes()
+        assert "myself" in nodes.get(curr_default_node.name).get("flags")
+
+        def raise_connection_error():
+            raise ConnectionError("error")
+
+        # Mock connection error for the default node
+        mock_node_resp_func(curr_default_node, raise_connection_error)
+        # Test that the command succeed from a different node
+        nodes = r.cluster_nodes()
+        assert "myself" not in nodes.get(curr_default_node.name).get("flags")
+        assert r.get_default_node() != curr_default_node
+
 
 @pytest.mark.onlycluster
 class TestClusterRedisCommands:

From c48dc8310717344374db6a31000e92cfe1ae35f8 Mon Sep 17 00:00:00 2001
From: Sibuken <zeden123@gmail.com>
Date: Thu, 1 Dec 2022 17:33:47 +0300
Subject: [PATCH 0630/1164] Async: added 'blocking' argument to call lock
 method (#2454)

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/asyncio/client.py         | 8 ++++++++
 redis/asyncio/cluster.py        | 8 ++++++++
 tests/test_asyncio/test_lock.py | 8 ++++++++
 3 files changed, 24 insertions(+)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index e0ed85eb8f..abe7d67463 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -354,6 +354,7 @@ def lock(
         name: KeyT,
         timeout: Optional[float] = None,
         sleep: float = 0.1,
+        blocking: bool = True,
         blocking_timeout: Optional[float] = None,
         lock_class: Optional[Type[Lock]] = None,
         thread_local: bool = True,
@@ -369,6 +370,12 @@ def lock(
         when the lock is in blocking mode and another client is currently
         holding the lock.
 
+        ``blocking`` indicates whether calling ``acquire`` should block until
+        the lock has been acquired or to fail immediately, causing ``acquire``
+        to return False and the lock not being acquired. Defaults to True.
+        Note this value can be overridden by passing a ``blocking``
+        argument to ``acquire``.
+
         ``blocking_timeout`` indicates the maximum amount of time in seconds to
         spend trying to acquire the lock. A value of ``None`` indicates
         continue trying forever. ``blocking_timeout`` can be specified as a
@@ -411,6 +418,7 @@ def lock(
             name,
             timeout=timeout,
             sleep=sleep,
+            blocking=blocking,
             blocking_timeout=blocking_timeout,
             thread_local=thread_local,
         )
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index e0e77c74ae..ac61314262 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -801,6 +801,7 @@ def lock(
         name: KeyT,
         timeout: Optional[float] = None,
         sleep: float = 0.1,
+        blocking: bool = True,
         blocking_timeout: Optional[float] = None,
         lock_class: Optional[Type[Lock]] = None,
         thread_local: bool = True,
@@ -816,6 +817,12 @@ def lock(
         when the lock is in blocking mode and another client is currently
         holding the lock.
 
+        ``blocking`` indicates whether calling ``acquire`` should block until
+        the lock has been acquired or to fail immediately, causing ``acquire``
+        to return False and the lock not being acquired. Defaults to True.
+        Note this value can be overridden by passing a ``blocking``
+        argument to ``acquire``.
+
         ``blocking_timeout`` indicates the maximum amount of time in seconds to
         spend trying to acquire the lock. A value of ``None`` indicates
         continue trying forever. ``blocking_timeout`` can be specified as a
@@ -858,6 +865,7 @@ def lock(
             name,
             timeout=timeout,
             sleep=sleep,
+            blocking=blocking,
             blocking_timeout=blocking_timeout,
             thread_local=thread_local,
         )
diff --git a/tests/test_asyncio/test_lock.py b/tests/test_asyncio/test_lock.py
index 56387fa954..15c3ec5162 100644
--- a/tests/test_asyncio/test_lock.py
+++ b/tests/test_asyncio/test_lock.py
@@ -97,6 +97,14 @@ async def test_float_timeout(self, r):
         assert 8 < (await r.pttl("foo")) <= 9500
         await lock.release()
 
+    async def test_blocking(self, r):
+        blocking = False
+        lock = self.get_lock(r, "foo", blocking=blocking)
+        assert not lock.blocking
+
+        lock_2 = self.get_lock(r, "foo")
+        assert lock_2.blocking
+
     async def test_blocking_timeout(self, r, event_loop):
         lock1 = self.get_lock(r, "foo")
         assert await lock1.acquire(blocking=False)

From a114f26c03aa9127826cf39c60c759340f93653b Mon Sep 17 00:00:00 2001
From: Utkarsh Gupta <utkarshgupta137@gmail.com>
Date: Sun, 4 Dec 2022 13:34:17 +0530
Subject: [PATCH 0631/1164] Async clusters: Support creating locks inside async
 functions (#2471)

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/asyncio/cluster.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index ac61314262..5a2dffdd1d 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -356,11 +356,13 @@ def __init__(
         )
 
         self._initialize = True
-        self._lock = asyncio.Lock()
+        self._lock: Optional[asyncio.Lock] = None
 
     async def initialize(self) -> "RedisCluster":
         """Get all nodes from startup nodes & creates connections if not initialized."""
         if self._initialize:
+            if not self._lock:
+                self._lock = asyncio.Lock()
             async with self._lock:
                 if self._initialize:
                     try:
@@ -378,6 +380,8 @@ async def initialize(self) -> "RedisCluster":
     async def close(self) -> None:
         """Close all connections & client if initialized."""
         if not self._initialize:
+            if not self._lock:
+                self._lock = asyncio.Lock()
             async with self._lock:
                 if not self._initialize:
                     self._initialize = True

From 37b961cedbfa264737e645e4c9343724a412b1bc Mon Sep 17 00:00:00 2001
From: Igor Malinovskiy <u.glide@gmail.com>
Date: Sun, 4 Dec 2022 09:04:53 +0100
Subject: [PATCH 0632/1164] Use explicit index name in RediSearch example
 (#2466)

Co-authored-by: Igor Malinovskiy <igor.malinovskiy@redis.com>
Co-authored-by: Chayim I. Kirshen <c@kirshen.com>
---
 docs/redismodules.rst | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/docs/redismodules.rst b/docs/redismodules.rst
index f764d821fd..2b0b3c6533 100644
--- a/docs/redismodules.rst
+++ b/docs/redismodules.rst
@@ -12,17 +12,17 @@ These are the commands for interacting with the `RedisBloom module <https://redi
 **Create and add to a bloom filter**
 
 .. code-block:: python
-   
-    import redis 
+
+    import redis
     r = redis.Redis()
-    r.bf().create("bloom", 0.01, 1000) 
+    r.bf().create("bloom", 0.01, 1000)
     r.bf().add("bloom", "foo")
 
 **Create and add to a cuckoo filter**
 
 .. code-block:: python
 
-    import redis 
+    import redis
     r = redis.Redis()
     r.cf().create("cuckoo", 1000)
     r.cf().add("cuckoo", "filter")
@@ -107,7 +107,8 @@ Examples of how to combine search and json can be found `here <examples/search_j
 RediSearch Commands
 *******************
 
-These are the commands for interacting with the `RediSearch module <https://redisearch.io>`_. Below is a brief example, as well as documentation on the commands themselves.
+These are the commands for interacting with the `RediSearch module <https://redisearch.io>`_. Below is a brief example, as well as documentation on the commands themselves. In the example
+below, an index named *my_index* is being created. When an index name is not specified, an index named *idx* is created.
 
 **Create a search index, and display its information**
 
@@ -117,8 +118,9 @@ These are the commands for interacting with the `RediSearch module <https://redi
     from redis.commands.search.field import TextField
 
     r = redis.Redis()
-    r.ft().create_index(TextField("play", weight=5.0), TextField("ball"))
-    print(r.ft().info())
+    index_name = "my_index"
+    r.ft(index_name).create_index(TextField("play", weight=5.0), TextField("ball"))
+    print(r.ft(index_name).info())
 
 
 .. automodule:: redis.commands.search.commands

From f32c835e78a4675b3147de5cc3a8337eba3b0ab6 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 4 Dec 2022 10:06:09 +0200
Subject: [PATCH 0633/1164] Removing Deprecated LGTM (#2473)

---
 README.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/README.md b/README.md
index 7e44cfa62a..bfd345cbec 100644
--- a/README.md
+++ b/README.md
@@ -8,7 +8,6 @@ The Python interface to the Redis key-value store.
 [![pypi](https://badge.fury.io/py/redis.svg)](https://pypi.org/project/redis/)
 [![pre-release](https://img.shields.io/github/v/release/redis/redis-py?include_prereleases&label=latest-prerelease)](https://github.com/redis/redis-py/releases)
 [![codecov](https://codecov.io/gh/redis/redis-py/branch/master/graph/badge.svg?token=yenl5fzxxr)](https://codecov.io/gh/redis/redis-py)
-[![Total alerts](https://img.shields.io/lgtm/alerts/g/redis/redis-py.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/redis/redis-py/alerts/)
 
 [Installation](#installation) |  [Usage](#usage) | [Advanced Topics](#advanced-topics) | [Contributing](https://github.com/redis/redis-py/blob/master/CONTRIBUTING.md)
 

From 938ba6d2a5439c4703e3451d2d17e41222716ae6 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 4 Dec 2022 10:25:52 +0200
Subject: [PATCH 0634/1164] Updating dev dependencies (#2475)

---
 dev_requirements.txt             | 12 ++++++------
 redis/ocsp.py                    |  4 ++--
 tests/test_asyncio/test_graph.py |  6 ++++--
 tests/test_graph.py              |  6 ++++--
 4 files changed, 16 insertions(+), 12 deletions(-)

diff --git a/dev_requirements.txt b/dev_requirements.txt
index 66be6d1d64..8285b0456f 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -1,17 +1,17 @@
 click==8.0.4
 black==22.3.0
-flake8==4.0.1
+flake8==5.0.4
 flynt~=0.69.0
 isort==5.10.1
 mock==4.0.3
 packaging>=20.4
-pytest==6.2.5
+pytest==7.2.0
 pytest-timeout==2.0.1
-pytest-asyncio>=0.16.0
-tox==3.24.4
+pytest-asyncio>=0.20.2
+tox==3.27.1
 tox-docker==3.1.0
-invoke==1.6.0
-pytest-cov>=3.0.0
+invoke==1.7.3
+pytest-cov>=4.0.0
 vulture>=2.3.0
 ujson>=4.2.0
 wheel>=0.30.0
diff --git a/redis/ocsp.py b/redis/ocsp.py
index 0d2c0fc453..ab8a35a33d 100644
--- a/redis/ocsp.py
+++ b/redis/ocsp.py
@@ -189,8 +189,8 @@ def _bin2ascii(self, der):
         return cert
 
     def components_from_socket(self):
-        """This function returns the certificate, primary issuer, and primary ocsp server
-        in the chain for a socket already wrapped with ssl.
+        """This function returns the certificate, primary issuer, and primary ocsp
+        server in the chain for a socket already wrapped with ssl.
         """
 
         # convert the binary certifcate to text
diff --git a/tests/test_asyncio/test_graph.py b/tests/test_asyncio/test_graph.py
index 0c011bd91a..78242568fe 100644
--- a/tests/test_asyncio/test_graph.py
+++ b/tests/test_asyncio/test_graph.py
@@ -262,7 +262,8 @@ async def test_cached_execution(modclient: redis.Redis):
 
 @pytest.mark.redismod
 async def test_slowlog(modclient: redis.Redis):
-    create_query = """CREATE (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
+    create_query = """CREATE
+    (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
     (:Rider {name:'Dani Pedrosa'})-[:rides]->(:Team {name:'Honda'}),
     (:Rider {name:'Andrea Dovizioso'})-[:rides]->(:Team {name:'Ducati'})"""
     await modclient.graph().query(create_query)
@@ -395,7 +396,8 @@ async def test_multi_label(modclient: redis.Redis):
 @pytest.mark.redismod
 async def test_execution_plan(modclient: redis.Redis):
     redis_graph = modclient.graph("execution_plan")
-    create_query = """CREATE (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
+    create_query = """CREATE
+    (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
     (:Rider {name:'Dani Pedrosa'})-[:rides]->(:Team {name:'Honda'}),
     (:Rider {name:'Andrea Dovizioso'})-[:rides]->(:Team {name:'Ducati'})"""
     await redis_graph.query(create_query)
diff --git a/tests/test_graph.py b/tests/test_graph.py
index a46c336dad..cc6433ca52 100644
--- a/tests/test_graph.py
+++ b/tests/test_graph.py
@@ -280,7 +280,8 @@ def test_cached_execution(client):
 
 @pytest.mark.redismod
 def test_slowlog(client):
-    create_query = """CREATE (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
+    create_query = """CREATE (:Rider
+    {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
     (:Rider {name:'Dani Pedrosa'})-[:rides]->(:Team {name:'Honda'}),
     (:Rider {name:'Andrea Dovizioso'})-[:rides]->(:Team {name:'Ducati'})"""
     client.graph().query(create_query)
@@ -486,7 +487,8 @@ def test_cache_sync(client):
 @pytest.mark.redismod
 def test_execution_plan(client):
     redis_graph = client.graph("execution_plan")
-    create_query = """CREATE (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
+    create_query = """CREATE
+    (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
     (:Rider {name:'Dani Pedrosa'})-[:rides]->(:Team {name:'Honda'}),
     (:Rider {name:'Andrea Dovizioso'})-[:rides]->(:Team {name:'Ducati'})"""
     redis_graph.query(create_query)

From 6fa6cfc9ada2ec1878484ba44a02fdc3c0c691d5 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 4 Dec 2022 11:34:48 +0200
Subject: [PATCH 0635/1164] Version 4.4.0 (#2485)

---
 setup.py | 2 +-
 tox.ini  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.py b/setup.py
index a8928f4158..9cf0dcff26 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.4.0rc4",
+    version="4.4.0",
     packages=find_packages(
         include=[
             "redis",
diff --git a/tox.ini b/tox.ini
index 85b3242857..4eda45f935 100644
--- a/tox.ini
+++ b/tox.ini
@@ -94,7 +94,7 @@ volumes =
 
 [docker:redismod]
 name = redismod
-image = redislabs/redismod:edge
+image = redis/redis-stack-server:latest
 ports =
     36379:6379/tcp
 healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',36379)) else False"

From 6219574b042a6596b150ca8248441198f01f8c87 Mon Sep 17 00:00:00 2001
From: Raz Monsonego <74051729+raz-mon@users.noreply.github.com>
Date: Tue, 6 Dec 2022 14:52:16 +0200
Subject: [PATCH 0636/1164] Updating graph tests to support new execution plan
 (#2486)

---
 tests/test_asyncio/test_graph.py | 14 +++++---------
 tests/test_graph.py              | 14 +++++---------
 tox.ini                          |  2 +-
 3 files changed, 11 insertions(+), 19 deletions(-)

diff --git a/tests/test_asyncio/test_graph.py b/tests/test_asyncio/test_graph.py
index 78242568fe..7e70baae89 100644
--- a/tests/test_asyncio/test_graph.py
+++ b/tests/test_asyncio/test_graph.py
@@ -406,7 +406,7 @@ async def test_execution_plan(modclient: redis.Redis):
         "MATCH (r:Rider)-[:rides]->(t:Team) WHERE t.name = $name RETURN r.name, t.name, $params",  # noqa
         {"name": "Yehuda"},
     )
-    expected = "Results\n    Project\n        Conditional Traverse | (t:Team)->(r:Rider)\n            Filter\n                Node By Label Scan | (t:Team)"  # noqa
+    expected = "Results\n    Project\n        Conditional Traverse | (t)->(r:Rider)\n            Filter\n                Node By Label Scan | (t:Team)"  # noqa
     assert result == expected
 
     await redis_graph.delete()
@@ -437,11 +437,11 @@ async def test_explain(modclient: redis.Redis):
 Distinct
     Join
         Project
-            Conditional Traverse | (t:Team)->(r:Rider)
+            Conditional Traverse | (t)->(r:Rider)
                 Filter
                     Node By Label Scan | (t:Team)
         Project
-            Conditional Traverse | (t:Team)->(r:Rider)
+            Conditional Traverse | (t)->(r:Rider)
                 Filter
                     Node By Label Scan | (t:Team)"""
     assert str(result).replace(" ", "").replace("\n", "") == expected.replace(
@@ -453,9 +453,7 @@ async def test_explain(modclient: redis.Redis):
             Operation("Join")
             .append_child(
                 Operation("Project").append_child(
-                    Operation(
-                        "Conditional Traverse", "(t:Team)->(r:Rider)"
-                    ).append_child(
+                    Operation("Conditional Traverse", "(t)->(r:Rider)").append_child(
                         Operation("Filter").append_child(
                             Operation("Node By Label Scan", "(t:Team)")
                         )
@@ -464,9 +462,7 @@ async def test_explain(modclient: redis.Redis):
             )
             .append_child(
                 Operation("Project").append_child(
-                    Operation(
-                        "Conditional Traverse", "(t:Team)->(r:Rider)"
-                    ).append_child(
+                    Operation("Conditional Traverse", "(t)->(r:Rider)").append_child(
                         Operation("Filter").append_child(
                             Operation("Node By Label Scan", "(t:Team)")
                         )
diff --git a/tests/test_graph.py b/tests/test_graph.py
index cc6433ca52..d71df48688 100644
--- a/tests/test_graph.py
+++ b/tests/test_graph.py
@@ -497,7 +497,7 @@ def test_execution_plan(client):
         "MATCH (r:Rider)-[:rides]->(t:Team) WHERE t.name = $name RETURN r.name, t.name, $params",  # noqa
         {"name": "Yehuda"},
     )
-    expected = "Results\n    Project\n        Conditional Traverse | (t:Team)->(r:Rider)\n            Filter\n                Node By Label Scan | (t:Team)"  # noqa
+    expected = "Results\n    Project\n        Conditional Traverse | (t)->(r:Rider)\n            Filter\n                Node By Label Scan | (t:Team)"  # noqa
     assert result == expected
 
     redis_graph.delete()
@@ -528,11 +528,11 @@ def test_explain(client):
 Distinct
     Join
         Project
-            Conditional Traverse | (t:Team)->(r:Rider)
+            Conditional Traverse | (t)->(r:Rider)
                 Filter
                     Node By Label Scan | (t:Team)
         Project
-            Conditional Traverse | (t:Team)->(r:Rider)
+            Conditional Traverse | (t)->(r:Rider)
                 Filter
                     Node By Label Scan | (t:Team)"""
     assert str(result).replace(" ", "").replace("\n", "") == expected.replace(
@@ -544,9 +544,7 @@ def test_explain(client):
             Operation("Join")
             .append_child(
                 Operation("Project").append_child(
-                    Operation(
-                        "Conditional Traverse", "(t:Team)->(r:Rider)"
-                    ).append_child(
+                    Operation("Conditional Traverse", "(t)->(r:Rider)").append_child(
                         Operation("Filter").append_child(
                             Operation("Node By Label Scan", "(t:Team)")
                         )
@@ -555,9 +553,7 @@ def test_explain(client):
             )
             .append_child(
                 Operation("Project").append_child(
-                    Operation(
-                        "Conditional Traverse", "(t:Team)->(r:Rider)"
-                    ).append_child(
+                    Operation("Conditional Traverse", "(t)->(r:Rider)").append_child(
                         Operation("Filter").append_child(
                             Operation("Node By Label Scan", "(t:Team)")
                         )
diff --git a/tox.ini b/tox.ini
index 4eda45f935..85b3242857 100644
--- a/tox.ini
+++ b/tox.ini
@@ -94,7 +94,7 @@ volumes =
 
 [docker:redismod]
 name = redismod
-image = redis/redis-stack-server:latest
+image = redislabs/redismod:edge
 ports =
     36379:6379/tcp
 healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',36379)) else False"

From 3a121bef7bbc5bb5f07b119b0eef2f7527a38eda Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Mon, 12 Dec 2022 10:18:10 +0200
Subject: [PATCH 0637/1164] Intentional NotImplementedError for LATENCY
 commands that should not be in client (#2501)

---
 redis/commands/core.py | 28 ++++++++++++++++++++++++++++
 tests/test_commands.py | 10 ++++++++++
 2 files changed, 38 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 1625e10d9c..2ebd35fcba 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -980,6 +980,34 @@ def lastsave(self, **kwargs) -> ResponseT:
         """
         return self.execute_command("LASTSAVE", **kwargs)
 
+    def latency_doctor(self):
+        """Raise a NotImplementedError, as the client will not support LATENCY DOCTOR.
+        This funcion is best used within the redis-cli.
+
+        For more information see https://redis.io/commands/latency-doctor
+        """
+        raise NotImplementedError(
+            """
+            LATENCY DOCTOR is intentionally not implemented in the client.
+
+            For more information see https://redis.io/commands/latency-doctor
+            """
+        )
+
+    def latency_graph(self):
+        """Raise a NotImplementedError, as the client will not support LATENCY GRAPH.
+        This funcion is best used within the redis-cli.
+
+        For more information see https://redis.io/commands/latency-graph.
+        """
+        raise NotImplementedError(
+            """
+            LATENCY GRAPH is intentionally not implemented in the client.
+
+            For more information see https://redis.io/commands/latency-graph
+            """
+        )
+
     def lolwut(self, *version_numbers: Union[str, float], **kwargs) -> ResponseT:
         """
         Get the Redis version and a piece of generative computer art
diff --git a/tests/test_commands.py b/tests/test_commands.py
index aa6745b34b..77e2e72327 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -4527,6 +4527,16 @@ def test_latency_histogram_not_implemented(self, r: redis.Redis):
         with pytest.raises(NotImplementedError):
             r.latency_histogram()
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_latency_graph_not_implemented(self, r: redis.Redis):
+        with pytest.raises(NotImplementedError):
+            r.latency_graph()
+
+    @skip_if_server_version_lt("7.0.0")
+    def test_latency_doctor_not_implemented(self, r: redis.Redis):
+        with pytest.raises(NotImplementedError):
+            r.latency_doctor()
+
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("4.0.0")
     @skip_if_redis_enterprise()

From 6487f9555ba2d08083a081df9b65b642427361fa Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 14 Dec 2022 11:17:51 +0200
Subject: [PATCH 0638/1164] Add support for certain LATENCY commands (#2503)

* add latency commands

* fix tests in cluster
---
 redis/cluster.py       |  3 +++
 redis/commands/core.py | 24 ++++++++++++++++++++++++
 tests/test_commands.py | 11 +++++++++--
 3 files changed, 36 insertions(+), 2 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index 0b2c4f1387..cd559b6774 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -265,6 +265,9 @@ class AbstractRedisCluster:
                 "READWRITE",
                 "TIME",
                 "GRAPH.CONFIG",
+                "LATENCY HISTORY",
+                "LATENCY LATEST",
+                "LATENCY RESET",
             ],
             DEFAULT_NODE,
         ),
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 2ebd35fcba..eaedffb569 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1151,6 +1151,30 @@ def latency_histogram(self, *args):
             "LATENCY HISTOGRAM is intentionally not implemented in the client."
         )
 
+    def latency_history(self, event: str) -> ResponseT:
+        """
+        Returns the raw data of the ``event``'s latency spikes time series.
+
+        For more information see https://redis.io/commands/latency-history
+        """
+        return self.execute_command("LATENCY HISTORY", event)
+
+    def latency_latest(self) -> ResponseT:
+        """
+        Reports the latest latency events logged.
+
+        For more information see https://redis.io/commands/latency-latest
+        """
+        return self.execute_command("LATENCY LATEST")
+
+    def latency_reset(self, *events: str) -> ResponseT:
+        """
+        Resets the latency spikes time series of all, or only some, events.
+
+        For more information see https://redis.io/commands/latency-reset
+        """
+        return self.execute_command("LATENCY RESET", *events)
+
     def ping(self, **kwargs) -> ResponseT:
         """
         Ping the Redis server
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 77e2e72327..12ffcfe875 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -4527,16 +4527,23 @@ def test_latency_histogram_not_implemented(self, r: redis.Redis):
         with pytest.raises(NotImplementedError):
             r.latency_histogram()
 
-    @skip_if_server_version_lt("7.0.0")
     def test_latency_graph_not_implemented(self, r: redis.Redis):
         with pytest.raises(NotImplementedError):
             r.latency_graph()
 
-    @skip_if_server_version_lt("7.0.0")
     def test_latency_doctor_not_implemented(self, r: redis.Redis):
         with pytest.raises(NotImplementedError):
             r.latency_doctor()
 
+    def test_latency_history(self, r: redis.Redis):
+        assert r.latency_history("command") == []
+
+    def test_latency_latest(self, r: redis.Redis):
+        assert r.latency_latest() == []
+
+    def test_latency_reset(self, r: redis.Redis):
+        assert r.latency_reset() == 0
+
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("4.0.0")
     @skip_if_redis_enterprise()

From 3fb65de645bf4dd1beb8e893bdaa2c4766bbd1fa Mon Sep 17 00:00:00 2001
From: David Gilman <dgilman@aidentified.com>
Date: Wed, 14 Dec 2022 04:18:41 -0500
Subject: [PATCH 0639/1164] Combine auto-concatenated strings (#2482)

---
 benchmarks/basic_operations.py             |  2 +-
 redis/asyncio/client.py                    |  6 ++--
 redis/asyncio/lock.py                      |  6 ++--
 redis/client.py                            |  8 ++---
 redis/cluster.py                           |  4 +--
 redis/commands/core.py                     | 42 ++++++++++------------
 redis/commands/graph/node.py               |  2 +-
 redis/commands/search/commands.py          |  2 +-
 redis/connection.py                        |  4 +--
 redis/lock.py                              |  2 +-
 tests/conftest.py                          |  4 +--
 tests/test_asyncio/test_cluster.py         |  6 ++--
 tests/test_asyncio/test_commands.py        |  2 +-
 tests/test_asyncio/test_connection_pool.py |  2 +-
 tests/test_asyncio/test_pipeline.py        |  8 ++---
 tests/test_asyncio/test_pubsub.py          |  2 +-
 tests/test_cluster.py                      |  8 ++---
 tests/test_commands.py                     |  2 +-
 tests/test_connection_pool.py              |  2 +-
 tests/test_pipeline.py                     |  8 ++---
 20 files changed, 58 insertions(+), 64 deletions(-)

diff --git a/benchmarks/basic_operations.py b/benchmarks/basic_operations.py
index 1dc4a87cc8..c9f5853652 100644
--- a/benchmarks/basic_operations.py
+++ b/benchmarks/basic_operations.py
@@ -13,7 +13,7 @@ def parse_args():
     parser.add_argument(
         "-P",
         type=int,
-        help=("Pipeline <numreq> requests." " Default 1 (no pipeline)."),
+        help=("Pipeline <numreq> requests. Default 1 (no pipeline)."),
         default=1,
     )
     parser.add_argument(
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index abe7d67463..5a2c496661 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -1132,7 +1132,7 @@ def multi(self):
             raise RedisError("Cannot issue nested calls to MULTI")
         if self.command_stack:
             raise RedisError(
-                "Commands without an initial WATCH have already " "been issued"
+                "Commands without an initial WATCH have already been issued"
             )
         self.explicit_transaction = True
 
@@ -1157,7 +1157,7 @@ async def _disconnect_reset_raise(self, conn, error):
         if self.watching:
             await self.reset()
             raise WatchError(
-                "A ConnectionError occurred on while " "watching one or more keys"
+                "A ConnectionError occurred on while watching one or more keys"
             )
         # if retry_on_timeout is not set, or the error is not
         # a TimeoutError, raise it
@@ -1345,7 +1345,7 @@ async def _disconnect_raise_reset(self, conn: Connection, error: Exception):
         # indicates the user should retry this transaction.
         if self.watching:
             raise WatchError(
-                "A ConnectionError occurred on while " "watching one or more keys"
+                "A ConnectionError occurred on while watching one or more keys"
             )
         # if retry_on_timeout is not set, or the error is not
         # a TimeoutError, raise it
diff --git a/redis/asyncio/lock.py b/redis/asyncio/lock.py
index 7f45c8be66..2f78d69aee 100644
--- a/redis/asyncio/lock.py
+++ b/redis/asyncio/lock.py
@@ -259,7 +259,7 @@ async def do_release(self, expected_token: bytes) -> None:
                 keys=[self.name], args=[expected_token], client=self.redis
             )
         ):
-            raise LockNotOwnedError("Cannot release a lock" " that's no longer owned")
+            raise LockNotOwnedError("Cannot release a lock that's no longer owned")
 
     def extend(
         self, additional_time: float, replace_ttl: bool = False
@@ -289,7 +289,7 @@ async def do_extend(self, additional_time, replace_ttl) -> bool:
                 client=self.redis,
             )
         ):
-            raise LockNotOwnedError("Cannot extend a lock that's" " no longer owned")
+            raise LockNotOwnedError("Cannot extend a lock that's no longer owned")
         return True
 
     def reacquire(self) -> Awaitable[bool]:
@@ -309,5 +309,5 @@ async def do_reacquire(self) -> bool:
                 keys=[self.name], args=[self.local.token, timeout], client=self.redis
             )
         ):
-            raise LockNotOwnedError("Cannot reacquire a lock that's" " no longer owned")
+            raise LockNotOwnedError("Cannot reacquire a lock that's no longer owned")
         return True
diff --git a/redis/client.py b/redis/client.py
index ed857c8fba..1a9b96b83d 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1881,7 +1881,7 @@ def multi(self):
             raise RedisError("Cannot issue nested calls to MULTI")
         if self.command_stack:
             raise RedisError(
-                "Commands without an initial WATCH have already " "been issued"
+                "Commands without an initial WATCH have already been issued"
             )
         self.explicit_transaction = True
 
@@ -1904,7 +1904,7 @@ def _disconnect_reset_raise(self, conn, error):
         if self.watching:
             self.reset()
             raise WatchError(
-                "A ConnectionError occurred on while " "watching one or more keys"
+                "A ConnectionError occurred on while watching one or more keys"
             )
         # if retry_on_timeout is not set, or the error is not
         # a TimeoutError, raise it
@@ -1997,7 +1997,7 @@ def _execute_transaction(self, connection, commands, raise_on_error):
         if len(response) != len(commands):
             self.connection.disconnect()
             raise ResponseError(
-                "Wrong number of response items from " "pipeline execution"
+                "Wrong number of response items from pipeline execution"
             )
 
         # find any errors in the response and raise if necessary
@@ -2078,7 +2078,7 @@ def _disconnect_raise_reset(self, conn, error):
         # indicates the user should retry this transaction.
         if self.watching:
             raise WatchError(
-                "A ConnectionError occurred on while " "watching one or more keys"
+                "A ConnectionError occurred on while watching one or more keys"
             )
         # if retry_on_timeout is not set, or the error is not
         # a TimeoutError, raise it
diff --git a/redis/cluster.py b/redis/cluster.py
index cd559b6774..f1150073a9 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -1648,7 +1648,7 @@ def set_pubsub_node(self, cluster, node=None, host=None, port=None):
             pubsub_node = node
         elif any([host, port]) is True:
             # only 'host' or 'port' passed
-            raise DataError("Passing a host requires passing a port, " "and vice versa")
+            raise DataError("Passing a host requires passing a port, and vice versa")
         else:
             # nothing passed by the user. set node to None
             pubsub_node = None
@@ -2126,7 +2126,7 @@ def delete(self, *names):
         """
         if len(names) != 1:
             raise RedisClusterException(
-                "deleting multiple keys is not " "implemented in pipeline command"
+                "deleting multiple keys is not implemented in pipeline command"
             )
 
         return self.execute_command("DEL", names[0])
diff --git a/redis/commands/core.py b/redis/commands/core.py
index eaedffb569..4cd0a9f73b 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -101,7 +101,7 @@ def acl_genpass(self, bits: Union[int, None] = None, **kwargs) -> ResponseT:
                     raise ValueError
             except ValueError:
                 raise DataError(
-                    "genpass optionally accepts a bits argument, " "between 0 and 4096."
+                    "genpass optionally accepts a bits argument, between 0 and 4096."
                 )
         return self.execute_command("ACL GENPASS", *pieces, **kwargs)
 
@@ -142,7 +142,7 @@ def acl_log(self, count: Union[int, None] = None, **kwargs) -> ResponseT:
         args = []
         if count is not None:
             if not isinstance(count, int):
-                raise DataError("ACL LOG count must be an " "integer")
+                raise DataError("ACL LOG count must be an integer")
             args.append(count)
 
         return self.execute_command("ACL LOG", *args, **kwargs)
@@ -276,7 +276,7 @@ def acl_setuser(
 
         if (passwords or hashed_passwords) and nopass:
             raise DataError(
-                "Cannot set 'nopass' and supply " "'passwords' or 'hashed_passwords'"
+                "Cannot set 'nopass' and supply 'passwords' or 'hashed_passwords'"
             )
 
         if passwords:
@@ -1613,7 +1613,7 @@ def bitpos(
         if start is not None and end is not None:
             params.append(end)
         elif start is None and end is not None:
-            raise DataError("start argument is not set, " "when end is specified")
+            raise DataError("start argument is not set, when end is specified")
 
         if mode is not None:
             params.append(mode)
@@ -3457,9 +3457,7 @@ def xadd(
         """
         pieces: list[EncodableT] = []
         if maxlen is not None and minid is not None:
-            raise DataError(
-                "Only one of ```maxlen``` or ```minid``` " "may be specified"
-            )
+            raise DataError("Only one of ```maxlen``` or ```minid``` may be specified")
 
         if maxlen is not None:
             if not isinstance(maxlen, int) or maxlen < 1:
@@ -3515,7 +3513,7 @@ def xautoclaim(
         try:
             if int(min_idle_time) < 0:
                 raise DataError(
-                    "XAUTOCLAIM min_idle_time must be a non" "negative integer"
+                    "XAUTOCLAIM min_idle_time must be a nonnegative integer"
                 )
         except TypeError:
             pass
@@ -3573,7 +3571,7 @@ def xclaim(
          For more information see https://redis.io/commands/xclaim
         """
         if not isinstance(min_idle_time, int) or min_idle_time < 0:
-            raise DataError("XCLAIM min_idle_time must be a non negative " "integer")
+            raise DataError("XCLAIM min_idle_time must be a non negative integer")
         if not isinstance(message_ids, (list, tuple)) or not message_ids:
             raise DataError(
                 "XCLAIM message_ids must be a non empty list or "
@@ -3906,7 +3904,7 @@ def xreadgroup(
             pieces.append(str(count))
         if block is not None:
             if not isinstance(block, int) or block < 0:
-                raise DataError("XREADGROUP block must be a non-negative " "integer")
+                raise DataError("XREADGROUP block must be a non-negative integer")
             pieces.append(b"BLOCK")
             pieces.append(str(block))
         if noack:
@@ -3968,7 +3966,7 @@ def xtrim(
         """
         pieces: list[EncodableT] = []
         if maxlen is not None and minid is not None:
-            raise DataError("Only one of ``maxlen`` or ``minid`` " "may be specified")
+            raise DataError("Only one of ``maxlen`` or ``minid`` may be specified")
 
         if maxlen is None and minid is None:
             raise DataError("One of ``maxlen`` or ``minid`` must be specified")
@@ -4342,14 +4340,12 @@ def _zrange(
         num: Union[int, None] = None,
     ) -> ResponseT:
         if byscore and bylex:
-            raise DataError(
-                "``byscore`` and ``bylex`` can not be " "specified together."
-            )
+            raise DataError("``byscore`` and ``bylex`` can not be specified together.")
         if (offset is not None and num is None) or (num is not None and offset is None):
             raise DataError("``offset`` and ``num`` must both be specified.")
         if bylex and withscores:
             raise DataError(
-                "``withscores`` not supported in combination " "with ``bylex``."
+                "``withscores`` not supported in combination with ``bylex``."
             )
         pieces = [command]
         if dest:
@@ -5301,7 +5297,7 @@ def geoadd(
         if nx and xx:
             raise DataError("GEOADD allows either 'nx' or 'xx', not both")
         if len(values) % 3 != 0:
-            raise DataError("GEOADD requires places with lon, lat and name" " values")
+            raise DataError("GEOADD requires places with lon, lat and name values")
         pieces = [name]
         if nx:
             pieces.append("NX")
@@ -5487,7 +5483,7 @@ def _georadiusgeneric(
                 raise DataError("GEORADIUS invalid sort")
 
         if kwargs["store"] and kwargs["store_dist"]:
-            raise DataError("GEORADIUS store and store_dist cant be set" " together")
+            raise DataError("GEORADIUS store and store_dist cant be set together")
 
         if kwargs["store"]:
             pieces.extend([b"STORE", kwargs["store"]])
@@ -5624,13 +5620,11 @@ def _geosearchgeneric(
         # FROMMEMBER or FROMLONLAT
         if kwargs["member"] is None:
             if kwargs["longitude"] is None or kwargs["latitude"] is None:
-                raise DataError(
-                    "GEOSEARCH must have member or" " longitude and latitude"
-                )
+                raise DataError("GEOSEARCH must have member or longitude and latitude")
         if kwargs["member"]:
             if kwargs["longitude"] or kwargs["latitude"]:
                 raise DataError(
-                    "GEOSEARCH member and longitude or latitude" " cant be set together"
+                    "GEOSEARCH member and longitude or latitude cant be set together"
                 )
             pieces.extend([b"FROMMEMBER", kwargs["member"]])
         if kwargs["longitude"] is not None and kwargs["latitude"] is not None:
@@ -5639,7 +5633,7 @@ def _geosearchgeneric(
         # BYRADIUS or BYBOX
         if kwargs["radius"] is None:
             if kwargs["width"] is None or kwargs["height"] is None:
-                raise DataError("GEOSEARCH must have radius or" " width and height")
+                raise DataError("GEOSEARCH must have radius or width and height")
         if kwargs["unit"] is None:
             raise DataError("GEOSEARCH must have unit")
         if kwargs["unit"].lower() not in ("m", "km", "mi", "ft"):
@@ -5647,7 +5641,7 @@ def _geosearchgeneric(
         if kwargs["radius"]:
             if kwargs["width"] or kwargs["height"]:
                 raise DataError(
-                    "GEOSEARCH radius and width or height" " cant be set together"
+                    "GEOSEARCH radius and width or height cant be set together"
                 )
             pieces.extend([b"BYRADIUS", kwargs["radius"], kwargs["unit"]])
         if kwargs["width"] and kwargs["height"]:
@@ -5668,7 +5662,7 @@ def _geosearchgeneric(
             if kwargs["any"]:
                 pieces.append(b"ANY")
         elif kwargs["any"]:
-            raise DataError("GEOSEARCH ``any`` can't be provided " "without count")
+            raise DataError("GEOSEARCH ``any`` can't be provided without count")
 
         # other properties
         for arg_name, byte_repr in (
diff --git a/redis/commands/graph/node.py b/redis/commands/graph/node.py
index c5f842906b..0ebe510ada 100644
--- a/redis/commands/graph/node.py
+++ b/redis/commands/graph/node.py
@@ -32,7 +32,7 @@ def __init__(self, node_id=None, alias=None, label=None, properties=None):
             self.labels = label
         else:
             raise AssertionError(
-                "label should be either None, " "string or a list of strings"
+                "label should be either None, string or a list of strings"
             )
 
         self.properties = properties or {}
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index f02805ee2b..3bd7d47aa8 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -527,7 +527,7 @@ def profile(
             cmd += query.get_args()
             cmd += self.get_params_args(query_params)
         else:
-            raise ValueError("Must provide AggregateRequest object or " "Query object.")
+            raise ValueError("Must provide AggregateRequest object or Query object.")
 
         res = self.execute_command(*cmd)
 
diff --git a/redis/connection.py b/redis/connection.py
index 9c5b536f89..dce0735450 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -62,9 +62,9 @@
 SERVER_CLOSED_CONNECTION_ERROR = "Connection closed by server."
 
 SENTINEL = object()
-MODULE_LOAD_ERROR = "Error loading the extension. " "Please check the server logs."
+MODULE_LOAD_ERROR = "Error loading the extension. Please check the server logs."
 NO_SUCH_MODULE_ERROR = "Error unloading module: no such module with that name"
-MODULE_UNLOAD_NOT_POSSIBLE_ERROR = "Error unloading module: operation not " "possible."
+MODULE_UNLOAD_NOT_POSSIBLE_ERROR = "Error unloading module: operation not possible."
 MODULE_EXPORTS_DATA_TYPES_ERROR = (
     "Error unloading module: the module "
     "exports one or more module-side data "
diff --git a/redis/lock.py b/redis/lock.py
index 912ff57819..4cca102d10 100644
--- a/redis/lock.py
+++ b/redis/lock.py
@@ -256,7 +256,7 @@ def do_release(self, expected_token: str) -> None:
         if not bool(
             self.lua_release(keys=[self.name], args=[expected_token], client=self.redis)
         ):
-            raise LockNotOwnedError("Cannot release a lock" " that's no longer owned")
+            raise LockNotOwnedError("Cannot release a lock that's no longer owned")
 
     def extend(self, additional_time: int, replace_ttl: bool = False) -> bool:
         """
diff --git a/tests/conftest.py b/tests/conftest.py
index 3d40375052..27dcc741a7 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -77,7 +77,7 @@ def pytest_addoption(parser):
         "--redis-url",
         default=default_redis_url,
         action="store",
-        help="Redis connection string," " defaults to `%(default)s`",
+        help="Redis connection string, defaults to `%(default)s`",
     )
 
     parser.addoption(
@@ -93,7 +93,7 @@ def pytest_addoption(parser):
         "--redis-ssl-url",
         default=default_redis_ssl_url,
         action="store",
-        help="Redis SSL connection string," " defaults to `%(default)s`",
+        help="Redis SSL connection string, defaults to `%(default)s`",
     )
 
     parser.addoption(
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 1997c9520b..13e5e26ae3 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -171,7 +171,7 @@ async def moved_redirection_helper(
     prev_primary = rc.nodes_manager.get_node_from_slot(slot)
     if failover:
         if len(rc.nodes_manager.slots_cache[slot]) < 2:
-            warnings.warn("Skipping this test since it requires to have a " "replica")
+            warnings.warn("Skipping this test since it requires to have a replica")
             return
         redirect_node = rc.nodes_manager.slots_cache[slot][1]
     else:
@@ -327,7 +327,7 @@ async def test_empty_startup_nodes(self) -> None:
             RedisCluster(startup_nodes=[])
 
         assert str(ex.value).startswith(
-            "RedisCluster requires at least one node to discover the " "cluster"
+            "RedisCluster requires at least one node to discover the cluster"
         ), str_if_bytes(ex.value)
 
     async def test_from_url(self, request: FixtureRequest) -> None:
@@ -371,7 +371,7 @@ async def test_execute_command_errors(self, r: RedisCluster) -> None:
         with pytest.raises(RedisClusterException) as ex:
             await r.execute_command("GET")
         assert str(ex.value).startswith(
-            "No way to dispatch this command to " "Redis Cluster. Missing key."
+            "No way to dispatch this command to Redis Cluster. Missing key."
         )
 
     async def test_execute_command_node_flag_primaries(self, r: RedisCluster) -> None:
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 67471bb4b3..7c6fd45ab9 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -199,7 +199,7 @@ async def test_acl_getuser_setuser(self, r_teardown):
 
         # Resets and tests that hashed passwords are set properly.
         hashed_password = (
-            "5e884898da28047151d0e56f8dc629" "2773603d0d6aabbdd62a11ef721d1542d8"
+            "5e884898da28047151d0e56f8dc6292773603d0d6aabbdd62a11ef721d1542d8"
         )
         assert await r.acl_setuser(
             username, enabled=True, reset=True, hashed_passwords=["+" + hashed_password]
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
index 35f23f44cc..5de25f265b 100644
--- a/tests/test_asyncio/test_connection_pool.py
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -416,7 +416,7 @@ def test_client_name_in_querystring(self):
     def test_invalid_extra_typed_querystring_options(self):
         with pytest.raises(ValueError):
             redis.ConnectionPool.from_url(
-                "redis://localhost/2?socket_timeout=_&" "socket_connect_timeout=abc"
+                "redis://localhost/2?socket_timeout=_&socket_connect_timeout=abc"
             )
 
     def test_extra_querystring_options(self):
diff --git a/tests/test_asyncio/test_pipeline.py b/tests/test_asyncio/test_pipeline.py
index d613f490a5..3df57eb90f 100644
--- a/tests/test_asyncio/test_pipeline.py
+++ b/tests/test_asyncio/test_pipeline.py
@@ -124,7 +124,7 @@ async def test_exec_error_raised(self, r):
             with pytest.raises(redis.ResponseError) as ex:
                 await pipe.execute()
             assert str(ex.value).startswith(
-                "Command # 3 (LPUSH c 3) of " "pipeline caused error: "
+                "Command # 3 (LPUSH c 3) of pipeline caused error: "
             )
 
             # make sure the pipe was restored to a working state
@@ -169,7 +169,7 @@ async def test_parse_error_raised(self, r):
                 await pipe.execute()
 
             assert str(ex.value).startswith(
-                "Command # 2 (ZREM b) of " "pipeline caused error: "
+                "Command # 2 (ZREM b) of pipeline caused error: "
             )
 
             # make sure the pipe was restored to a working state
@@ -186,7 +186,7 @@ async def test_parse_error_raised_transaction(self, r):
                 await pipe.execute()
 
             assert str(ex.value).startswith(
-                "Command # 2 (ZREM b) of " "pipeline caused error: "
+                "Command # 2 (ZREM b) of pipeline caused error: "
             )
 
             # make sure the pipe was restored to a working state
@@ -333,7 +333,7 @@ async def test_exec_error_in_no_transaction_pipeline(self, r):
                 await pipe.execute()
 
             assert str(ex.value).startswith(
-                "Command # 1 (LLEN a) of " "pipeline caused error: "
+                "Command # 1 (LLEN a) of pipeline caused error: "
             )
 
         assert await r.get("a") == b"1"
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index 6dedca9ab5..37b7206720 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -411,7 +411,7 @@ async def test_get_message_without_subscribe(self, r: redis.Redis, pubsub):
         with pytest.raises(RuntimeError) as info:
             await p.get_message()
         expect = (
-            "connection not set: " "did you forget to call subscribe() or psubscribe()?"
+            "connection not set: did you forget to call subscribe() or psubscribe()?"
         )
         assert expect in info.exconly()
 
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 43aeb9e045..e45780d119 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -176,7 +176,7 @@ def moved_redirection_helper(request, failover=False):
     prev_primary = rc.nodes_manager.get_node_from_slot(slot)
     if failover:
         if len(rc.nodes_manager.slots_cache[slot]) < 2:
-            warnings.warn("Skipping this test since it requires to have a " "replica")
+            warnings.warn("Skipping this test since it requires to have a replica")
             return
         redirect_node = rc.nodes_manager.slots_cache[slot][1]
     else:
@@ -244,7 +244,7 @@ def test_empty_startup_nodes(self):
             RedisCluster(startup_nodes=[])
 
         assert str(ex.value).startswith(
-            "RedisCluster requires at least one node to discover the " "cluster"
+            "RedisCluster requires at least one node to discover the cluster"
         ), str_if_bytes(ex.value)
 
     def test_from_url(self, r):
@@ -265,7 +265,7 @@ def test_execute_command_errors(self, r):
         with pytest.raises(RedisClusterException) as ex:
             r.execute_command("GET")
         assert str(ex.value).startswith(
-            "No way to dispatch this command to " "Redis Cluster. Missing key."
+            "No way to dispatch this command to Redis Cluster. Missing key."
         )
 
     def test_execute_command_node_flag_primaries(self, r):
@@ -2789,7 +2789,7 @@ def test_asking_error(self, r):
                 ask_node = node
                 break
         if ask_node is None:
-            warnings.warn("skipping this test since the cluster has only one " "node")
+            warnings.warn("skipping this test since the cluster has only one node")
             return
         ask_msg = f"{r.keyslot(key)} {ask_node.host}:{ask_node.port}"
 
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 12ffcfe875..36d004c98f 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -274,7 +274,7 @@ def teardown():
 
         # Resets and tests that hashed passwords are set properly.
         hashed_password = (
-            "5e884898da28047151d0e56f8dc629" "2773603d0d6aabbdd62a11ef721d1542d8"
+            "5e884898da28047151d0e56f8dc6292773603d0d6aabbdd62a11ef721d1542d8"
         )
         assert r.acl_setuser(
             username, enabled=True, reset=True, hashed_passwords=["+" + hashed_password]
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 73eb6e198f..e8a42692a1 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -314,7 +314,7 @@ def test_client_name_in_querystring(self):
     def test_invalid_extra_typed_querystring_options(self):
         with pytest.raises(ValueError):
             redis.ConnectionPool.from_url(
-                "redis://localhost/2?socket_timeout=_&" "socket_connect_timeout=abc"
+                "redis://localhost/2?socket_timeout=_&socket_connect_timeout=abc"
             )
 
     def test_extra_querystring_options(self):
diff --git a/tests/test_pipeline.py b/tests/test_pipeline.py
index 03377d8350..716cd0fbf6 100644
--- a/tests/test_pipeline.py
+++ b/tests/test_pipeline.py
@@ -122,7 +122,7 @@ def test_exec_error_raised(self, r):
             with pytest.raises(redis.ResponseError) as ex:
                 pipe.execute()
             assert str(ex.value).startswith(
-                "Command # 3 (LPUSH c 3) of " "pipeline caused error: "
+                "Command # 3 (LPUSH c 3) of pipeline caused error: "
             )
 
             # make sure the pipe was restored to a working state
@@ -167,7 +167,7 @@ def test_parse_error_raised(self, r):
                 pipe.execute()
 
             assert str(ex.value).startswith(
-                "Command # 2 (ZREM b) of " "pipeline caused error: "
+                "Command # 2 (ZREM b) of pipeline caused error: "
             )
 
             # make sure the pipe was restored to a working state
@@ -184,7 +184,7 @@ def test_parse_error_raised_transaction(self, r):
                 pipe.execute()
 
             assert str(ex.value).startswith(
-                "Command # 2 (ZREM b) of " "pipeline caused error: "
+                "Command # 2 (ZREM b) of pipeline caused error: "
             )
 
             # make sure the pipe was restored to a working state
@@ -331,7 +331,7 @@ def test_exec_error_in_no_transaction_pipeline(self, r):
                 pipe.execute()
 
             assert str(ex.value).startswith(
-                "Command # 1 (LLEN a) of " "pipeline caused error: "
+                "Command # 1 (LLEN a) of pipeline caused error: "
             )
 
         assert r["a"] == b"1"

From b556440949799dca2110cd3a17738dc6a5e1516a Mon Sep 17 00:00:00 2001
From: Igor Malinovskiy <u.glide@gmail.com>
Date: Wed, 14 Dec 2022 12:14:02 +0100
Subject: [PATCH 0640/1164] Switch docs to furo theme (#2492)

* Switch to docs to Furo theme

* Add logo and year

Co-authored-by: Igor Malinovskiy <igor.malinovskiy@redis.com>
---
 docs/_static/redis-cube-red-white-rgb.svg | 30 ++++++++++++++++++++++
 docs/conf.py                              | 31 +++++++++++++++--------
 docs/index.rst                            |  2 +-
 docs/requirements.txt                     |  4 +--
 4 files changed, 53 insertions(+), 14 deletions(-)
 create mode 100644 docs/_static/redis-cube-red-white-rgb.svg

diff --git a/docs/_static/redis-cube-red-white-rgb.svg b/docs/_static/redis-cube-red-white-rgb.svg
new file mode 100644
index 0000000000..936eb231b9
--- /dev/null
+++ b/docs/_static/redis-cube-red-white-rgb.svg
@@ -0,0 +1,30 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd">
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" id="body_1" width="70" height="52">
+
+<defs>
+                <clipPath  id="1">
+
+                    <path clip-rule="evenodd" transform="matrix(1 0 0 1 0.01 0.01)"  d="M0 0L146.42 0L146.42 125.48L0 125.48z" />                </clipPath>
+</defs>
+
+<g transform="matrix(0.41404575 0 0 0.41404575 4.689784 -0)">
+	<g>
+		<g>
+			<g clip-path="url(#1)" >
+                <path transform="matrix(1 0 0 1 0.01 0.01)"  d="M140.66 96.74C 132.86 100.82 92.380005 117.47 83.66 122.03999C 74.94 126.609985 70.270004 126.479996 63.450005 123.21999C 56.630005 119.95999 13.7 102.5 5.92 98.78C 2 96.94 0 95.37 0 93.9L0 93.9L0 79.09C 0 79.09 56.08 66.92 65.13 63.64C 74.17999 60.36 77.31 60.28 85 63.1C 92.69 65.92 138.79 74.24 146.4 77L146.4 77L146.4 91.6C 146.4 93.119995 144.65 94.6 140.65999 96.729996L140.65999 96.729996L140.66 96.74z" stroke="none" fill="#A32422" fill-rule="nonzero" />
+                <path transform="matrix(1 0 0 1 0.01 0.01)"  d="M140.66 82C 132.86 86.06 92.380005 102.71 83.66 107.2C 74.94 111.689995 70.270004 111.649994 63.450005 108.399994C 56.630005 105.149994 13.7 87.69 5.92 84C -1.8599997 80.31 -2.0099998 77.73 5.62 74.75C 13.25 71.77 56.08 55 65.13 51.7C 74.17999 48.4 77.31 48.33 85 51.16C 92.69 53.989998 133 70 140.57 72.79C 148.14001 75.58 148.49 77.87 140.66 81.92L140.66 81.92L140.66 82z" stroke="none" fill="#DC382C" fill-rule="nonzero" />
+                <path transform="matrix(1 0 0 1 0.01 0.01)"  d="M140.66 72.62C 132.86 76.69 92.380005 93.33 83.66 97.82001C 74.94 102.31001 70.31 102.27 63.49 99C 56.670006 95.73 13.7 78.37 5.92 74.66C 2 72.8 0 71.24 0 69.76L0 69.76L0 55C 0 55 56.08 42.79 65.13 39.51C 74.17999 36.229996 77.31 36.14 85 39C 92.69 41.86 138.79 50.1 146.4 52.88L146.4 52.88L146.4 67.48C 146.4 69 144.65 70.52 140.66 72.62z" stroke="none" fill="#A32422" fill-rule="nonzero" />
+                <path transform="matrix(1 0 0 1 0.01 0.01)"  d="M140.66 57.81C 132.86 61.89 92.380005 78.53 83.66 83.020004C 74.94 87.51001 70.270004 87.48 63.450005 84.22C 56.630005 80.96 13.7 63.57 5.92 59.85C -1.8599997 56.129997 -2 53.6 5.62 50.62C 13.24 47.64 56.079998 30.829998 65.13 27.619999C 74.17999 24.41 77.31 24.21 85 27C 92.69 29.79 133 45.94 140.57 48.65C 148.14001 51.360004 148.49 53.74 140.66 57.780003L140.66 57.780003L140.66 57.81z" stroke="none" fill="#DC382C" fill-rule="nonzero" />
+                <path transform="matrix(1 0 0 1 0.01 0.01)"  d="M140.66 47.59C 132.86 51.67 92.380005 68.32 83.66 72.8C 74.94 77.28001 70.31 77.25 63.49 74C 56.670006 70.75 13.7 53.34 5.92 49.63C 2 47.79 0 46.22 0 44.74L0 44.74L0 29.93C 0 29.93 56.08 17.76 65.13 14.49C 74.17999 11.219999 77.31 11.12 85 13.94C 92.69 16.759998 138.77 25.08 146.38 27.86L146.38 27.86L146.38 42.46C 146.4 44 144.65 45.5 140.66 47.59z" stroke="none" fill="#A32422" fill-rule="nonzero" />
+                <path transform="matrix(1 0 0 1 0.01 0.01)"  d="M140.66 32.8C 132.86 36.8 92.380005 53.55 83.66 58C 74.94 62.45 70.270004 62.44 63.450005 59.2C 56.630005 55.960003 13.7 38.53 5.92 34.83C -1.8599997 31.130005 -2.0099998 28.560001 5.62 25.580002C 13.25 22.600002 56.08 5.8 65.13 2.54C 74.17999 -0.72000027 77.31 -0.82 85 2C 92.69 4.8199997 133 20.85 140.57 23.63C 148.14001 26.409998 148.49 28.72 140.66 32.77L140.66 32.77L140.66 32.8z" stroke="none" fill="#DC382C" fill-rule="nonzero" />
+			</g>
+            <path d="M75.51 11.78L85.17 8.61L82.55 14.87L92.38 18.55L79.71 19.87L76.86 26.71L72.28 19.08L57.63 17.76L68.57 13.82L65.28 7.76L75.51 11.78L75.51 11.78L75.51 11.78L75.51 11.78" stroke="none" fill="#FFFFFF" fill-rule="nonzero" />
+            <path d="M76.12 51.71L52.44 41.88L86.36 36.67L76.12 51.71L76.12 51.71L76.12 51.71L76.12 51.71" stroke="none" fill="#FFFFFF" fill-rule="nonzero" />
+            <path transform="matrix(1 0 0 1 0.01 0.01)"  d="M43.28 22.34C 53.28 22.34 61.409996 25.49 61.409996 29.34C 61.409996 33.190002 53.259995 36.34 43.28 36.34C 33.300003 36.34 25.14 33.19 25.14 29.34C 25.14 25.490002 33.27 22.34 43.28 22.34z" stroke="none" fill="#FFFFFF" fill-rule="nonzero" />
+            <path d="M107.39 20.42L127.46 28.35L107.41 36.28L107.39 20.42L107.39 20.42L107.39 20.42L107.39 20.42" stroke="none" fill="#741113" fill-rule="nonzero" />
+            <path d="M107.39 20.42L107.41 36.28L105.23 37.13L85.17 29.2L107.39 20.42L107.39 20.42L107.39 20.42L107.39 20.42" stroke="none" fill="#AC2724" fill-rule="nonzero" />
+		</g>
+	</g>
+</g>
+</svg>
\ No newline at end of file
diff --git a/docs/conf.py b/docs/conf.py
index 618d95aea1..a265e5cc2f 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -60,7 +60,7 @@
 
 # General information about the project.
 project = "redis-py"
-copyright = "2021, Redis Inc"
+copyright = "2022, Redis Inc"
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
@@ -104,7 +104,7 @@
 # show_authors = False
 
 # The name of the Pygments (syntax highlighting) style to use.
-pygments_style = "sphinx"
+pygments_style = "tango"
 
 # A list of ignored prefixes for module index sorting.
 # modindex_common_prefix = []
@@ -116,19 +116,28 @@
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = "sphinx_rtd_theme"
+html_theme = "furo"
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
 html_theme_options = {
     "display_version": True,
-    "prev_next_buttons_location": "bottom",
-    "style_external_links": False,
-    # Toc options
-    "collapse_navigation": True,
-    "sticky_navigation": True,
-    "navigation_depth": 4,
+    "footer_icons": [
+        {
+            "name": "GitHub",
+            "url": "https://github.com/redis/redis-py",
+            "html": """
+            <svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 16 16">
+                <path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0 0 16 8c0-4.42-3.58-8-8-8z"></path>
+            </svg>
+        """,
+            "class": "",
+        },
+    ],
+    "source_repository": "https://github.com/redis/redis-py/",
+    "source_branch": "master",
+    "source_directory": "docs/",
 }
 
 # Add any paths that contain custom themes here, relative to this directory.
@@ -143,7 +152,7 @@
 
 # The name of an image file (relative to this directory) to place at the top
 # of the sidebar.
-# html_logo = None
+html_logo = "_static/redis-cube-red-white-rgb.svg"
 
 # The name of an image file (within the static path) to use as favicon of the
 # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
@@ -278,4 +287,4 @@
 epub_title = "redis-py"
 epub_author = "Redis Inc"
 epub_publisher = "Redis Inc"
-epub_copyright = "2021, Redis Inc"
+epub_copyright = "2022, Redis Inc"
diff --git a/docs/index.rst b/docs/index.rst
index 7bcef53466..6dd537948e 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -3,7 +3,7 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Welcome to redis-py's documentation!
+redis-py - Python Client for Redis
 ====================================
 
 Getting Started
diff --git a/docs/requirements.txt b/docs/requirements.txt
index 23ddc948f4..edecdffe4b 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,7 +1,7 @@
-sphinx<5
+sphinx>=5.0,<7.0
 docutils<0.18
-sphinx-rtd-theme
 nbsphinx
 sphinx_gallery
 ipython
 sphinx-autodoc-typehints
+furo

From 022a3e8314daa59b31fdce1d32e0e74d77f564cc Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 14 Dec 2022 14:04:57 +0200
Subject: [PATCH 0641/1164] Raising NotImplementedError for certain CLUSTER
 commands (#2504)

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/commands/cluster.py | 10 ++++++++++
 tests/test_cluster.py     |  8 ++++++++
 2 files changed, 18 insertions(+)

diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index f0eaaf75c5..f434f365a1 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -644,6 +644,16 @@ def cluster_links(self, target_node: "TargetNodesT") -> ResponseT:
         """
         return self.execute_command("CLUSTER LINKS", target_nodes=target_node)
 
+    def cluster_flushslots(self, target_nodes: Optional["TargetNodesT"] = None) -> None:
+        raise NotImplementedError(
+            "CLUSTER FLUSHSLOTS is intentionally not implemented in the client."
+        )
+
+    def cluster_bumpepoch(self, target_nodes: Optional["TargetNodesT"] = None) -> None:
+        raise NotImplementedError(
+            "CLUSTER BUMPEPOCH is intentionally not implemented in the client."
+        )
+
     def readonly(self, target_nodes: Optional["TargetNodesT"] = None) -> ResponseT:
         """
         Enables read queries.
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index e45780d119..9866cfcb08 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -1289,6 +1289,14 @@ def test_cluster_links(self, r):
         for i in range(0, len(res) - 1, 2):
             assert res[i][3] == res[i + 1][3]
 
+    def test_cluster_flshslots_not_implemented(self, r):
+        with pytest.raises(NotImplementedError):
+            r.cluster_flushslots()
+
+    def test_cluster_bumpepoch_not_implemented(self, r):
+        with pytest.raises(NotImplementedError):
+            r.cluster_bumpepoch()
+
     @skip_if_redis_enterprise()
     def test_readonly(self):
         r = get_mocked_redis_client(host=default_host, port=default_port)

From 74c251a19d211b3dcf555adc4a68bdc6f097f763 Mon Sep 17 00:00:00 2001
From: Vladimir Mihailenco <vladimir.webdev@gmail.com>
Date: Wed, 14 Dec 2022 14:41:33 +0200
Subject: [PATCH 0642/1164] Add OpenTelemetry example with Uptrace backend
 (#2452)

* chore: add opentelemetry example

* chore: add opentelemetry API Jupyter notebook

* chore: use a shorter title

* chore: cleanup

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 docs/conf.py                                  |   2 +-
 docs/examples.rst                             |   3 +-
 docs/examples/opentelemetry/README.md         |  47 ++
 .../opentelemetry/config/alertmanager.yml     |  53 +++
 .../opentelemetry/config/otel-collector.yaml  |  68 +++
 .../examples/opentelemetry/config/vector.toml |  39 ++
 .../examples/opentelemetry/docker-compose.yml |  81 ++++
 .../opentelemetry/image/redis-py-trace.png    | Bin 0 -> 18252 bytes
 docs/examples/opentelemetry/main.py           |  56 +++
 docs/examples/opentelemetry/requirements.txt  |   3 +
 docs/examples/opentelemetry/uptrace.yml       | 297 ++++++++++++
 .../examples/opentelemetry_api_examples.ipynb | 423 ++++++++++++++++++
 .../opentelemetry/distributed-tracing.png     | Bin 0 -> 8175 bytes
 docs/images/opentelemetry/redis-metrics.png   | Bin 0 -> 32347 bytes
 docs/images/opentelemetry/redis-py-trace.png  | Bin 0 -> 18252 bytes
 docs/images/opentelemetry/tree-of-spans.png   | Bin 0 -> 6401 bytes
 docs/index.rst                                |   1 +
 docs/opentelemetry.rst                        | 177 ++++++++
 18 files changed, 1248 insertions(+), 2 deletions(-)
 create mode 100644 docs/examples/opentelemetry/README.md
 create mode 100644 docs/examples/opentelemetry/config/alertmanager.yml
 create mode 100644 docs/examples/opentelemetry/config/otel-collector.yaml
 create mode 100644 docs/examples/opentelemetry/config/vector.toml
 create mode 100644 docs/examples/opentelemetry/docker-compose.yml
 create mode 100644 docs/examples/opentelemetry/image/redis-py-trace.png
 create mode 100755 docs/examples/opentelemetry/main.py
 create mode 100644 docs/examples/opentelemetry/requirements.txt
 create mode 100644 docs/examples/opentelemetry/uptrace.yml
 create mode 100644 docs/examples/opentelemetry_api_examples.ipynb
 create mode 100644 docs/images/opentelemetry/distributed-tracing.png
 create mode 100644 docs/images/opentelemetry/redis-metrics.png
 create mode 100644 docs/images/opentelemetry/redis-py-trace.png
 create mode 100644 docs/images/opentelemetry/tree-of-spans.png
 create mode 100644 docs/opentelemetry.rst

diff --git a/docs/conf.py b/docs/conf.py
index a265e5cc2f..cdbeb02c9a 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -162,7 +162,7 @@
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ["_static"]
+html_static_path = ["_static", "images"]
 
 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
 # using the given strftime format.
diff --git a/docs/examples.rst b/docs/examples.rst
index 3fed8b4195..47fdbdf41d 100644
--- a/docs/examples.rst
+++ b/docs/examples.rst
@@ -13,4 +13,5 @@ Examples
    examples/search_vector_similarity_examples
    examples/pipeline_examples
    examples/timeseries_examples
-   examples/redis-stream-example.ipynb
+   examples/redis-stream-example
+   examples/opentelemetry_api_examples
diff --git a/docs/examples/opentelemetry/README.md b/docs/examples/opentelemetry/README.md
new file mode 100644
index 0000000000..a1d1c04eda
--- /dev/null
+++ b/docs/examples/opentelemetry/README.md
@@ -0,0 +1,47 @@
+# Example for redis-py OpenTelemetry instrumentation
+
+This example demonstrates how to monitor Redis using [OpenTelemetry](https://opentelemetry.io/) and
+[Uptrace](https://github.com/uptrace/uptrace). It requires Docker to start Redis Server and Uptrace.
+
+See
+[Monitoring redis-py performance with OpenTelemetry](https://redis-py.readthedocs.io/en/latest/opentelemetry.html)
+for details.
+
+**Step 1**. Download the example using Git:
+
+```shell
+git clone https://github.com/redis/redis-py.git
+cd example/opentelemetry
+```
+
+**Step 2**. Optionally, create a virtualenv:
+
+```shell
+python3 -m venv .venv
+source .venv/bin/active
+```
+
+**Step 3**. Install dependencies:
+
+```shell
+pip install -r requirements.txt
+```
+
+**Step 4**. Start the services using Docker and make sure Uptrace is running:
+
+```shell
+docker-compose up -d
+docker-compose logs uptrace
+```
+
+**Step 5**. Run the Redis client example and follow the link from the CLI to view the trace:
+
+```shell
+python3 main.py
+trace: http://localhost:14318/traces/ee029d8782242c8ed38b16d961093b35
+```
+
+![Redis trace](./image/redis-py-trace.png)
+
+You can also open Uptrace UI at [http://localhost:14318](http://localhost:14318) to view available
+spans, logs, and metrics.
diff --git a/docs/examples/opentelemetry/config/alertmanager.yml b/docs/examples/opentelemetry/config/alertmanager.yml
new file mode 100644
index 0000000000..ac3e340d96
--- /dev/null
+++ b/docs/examples/opentelemetry/config/alertmanager.yml
@@ -0,0 +1,53 @@
+# See https://prometheus.io/docs/alerting/latest/configuration/ for details.
+
+global:
+  # The smarthost and SMTP sender used for mail notifications.
+  smtp_smarthost: "mailhog:1025"
+  smtp_from: "alertmanager@example.com"
+  smtp_require_tls: false
+
+receivers:
+  - name: "team-X"
+    email_configs:
+      - to: "some-receiver@example.com"
+        send_resolved: true
+
+# The root route on which each incoming alert enters.
+route:
+  # The labels by which incoming alerts are grouped together. For example,
+  # multiple alerts coming in for cluster=A and alertname=LatencyHigh would
+  # be batched into a single group.
+  group_by: ["alertname", "cluster", "service"]
+
+  # When a new group of alerts is created by an incoming alert, wait at
+  # least 'group_wait' to send the initial notification.
+  # This way ensures that you get multiple alerts for the same group that start
+  # firing shortly after another are batched together on the first
+  # notification.
+  group_wait: 30s
+
+  # When the first notification was sent, wait 'group_interval' to send a batch
+  # of new alerts that started firing for that group.
+  group_interval: 5m
+
+  # If an alert has successfully been sent, wait 'repeat_interval' to
+  # resend them.
+  repeat_interval: 3h
+
+  # A default receiver
+  receiver: team-X
+
+  # All the above attributes are inherited by all child routes and can
+  # overwritten on each.
+
+  # The child route trees.
+  routes:
+    # This route matches error alerts created from spans or logs.
+    - matchers:
+        - alert_kind="error"
+      group_interval: 24h
+      receiver: team-X
+
+# The directory from which notification templates are read.
+templates:
+  - "/etc/alertmanager/template/*.tmpl"
diff --git a/docs/examples/opentelemetry/config/otel-collector.yaml b/docs/examples/opentelemetry/config/otel-collector.yaml
new file mode 100644
index 0000000000..b44dd1fcf1
--- /dev/null
+++ b/docs/examples/opentelemetry/config/otel-collector.yaml
@@ -0,0 +1,68 @@
+extensions:
+  health_check:
+  pprof:
+    endpoint: 0.0.0.0:1777
+  zpages:
+    endpoint: 0.0.0.0:55679
+
+receivers:
+  otlp:
+    protocols:
+      grpc:
+      http:
+  hostmetrics:
+    collection_interval: 10s
+    scrapers:
+      cpu:
+      disk:
+      load:
+      filesystem:
+      memory:
+      network:
+      paging:
+  redis:
+    endpoint: "redis-server:6379"
+    collection_interval: 10s
+  jaeger:
+    protocols:
+      grpc:
+
+processors:
+  resourcedetection:
+    detectors: ["system"]
+  batch:
+    send_batch_size: 10000
+    timeout: 10s
+
+exporters:
+  logging:
+    logLevel: debug
+  otlp:
+    endpoint: uptrace:14317
+    tls:
+      insecure: true
+    headers: { "uptrace-dsn": "http://project2_secret_token@localhost:14317/2" }
+
+service:
+  # telemetry:
+  #   logs:
+  #     level: DEBUG
+  pipelines:
+    traces:
+      receivers: [otlp, jaeger]
+      processors: [batch]
+      exporters: [otlp, logging]
+    metrics:
+      receivers: [otlp]
+      processors: [batch]
+      exporters: [otlp]
+    metrics/hostmetrics:
+      receivers: [hostmetrics, redis]
+      processors: [batch, resourcedetection]
+      exporters: [otlp]
+    logs:
+      receivers: [otlp]
+      processors: [batch]
+      exporters: [otlp]
+
+  extensions: [health_check, pprof, zpages]
diff --git a/docs/examples/opentelemetry/config/vector.toml b/docs/examples/opentelemetry/config/vector.toml
new file mode 100644
index 0000000000..10db91dd28
--- /dev/null
+++ b/docs/examples/opentelemetry/config/vector.toml
@@ -0,0 +1,39 @@
+[sources.syslog_logs]
+type = "demo_logs"
+format = "syslog"
+interval = 0.1
+
+[sources.apache_common_logs]
+type = "demo_logs"
+format = "apache_common"
+interval = 0.1
+
+[sources.apache_error_logs]
+type = "demo_logs"
+format = "apache_error"
+interval = 0.1
+
+[sources.json_logs]
+type = "demo_logs"
+format = "json"
+interval = 0.1
+
+# Parse Syslog logs
+# See the Vector Remap Language reference for more info: https://vrl.dev
+[transforms.parse_logs]
+type = "remap"
+inputs = ["syslog_logs"]
+source = '''
+. = parse_syslog!(string!(.message))
+'''
+
+# Export data to Uptrace.
+[sinks.uptrace]
+type = "http"
+inputs = ["parse_logs", "apache_common_logs", "apache_error_logs", "json_logs"]
+encoding.codec = "json"
+framing.method = "newline_delimited"
+compression = "gzip"
+uri = "http://uptrace:14318/api/v1/vector/logs"
+#uri = "https://api.uptrace.dev/api/v1/vector/logs"
+headers.uptrace-dsn = "http://project2_secret_token@localhost:14317/2"
diff --git a/docs/examples/opentelemetry/docker-compose.yml b/docs/examples/opentelemetry/docker-compose.yml
new file mode 100644
index 0000000000..ea1d6dca4c
--- /dev/null
+++ b/docs/examples/opentelemetry/docker-compose.yml
@@ -0,0 +1,81 @@
+version: "3"
+
+services:
+  clickhouse:
+    image: clickhouse/clickhouse-server:22.7
+    restart: on-failure
+    environment:
+      CLICKHOUSE_DB: uptrace
+    healthcheck:
+      test: ["CMD", "wget", "--spider", "-q", "localhost:8123/ping"]
+      interval: 1s
+      timeout: 1s
+      retries: 30
+    volumes:
+      - ch_data:/var/lib/clickhouse
+    ports:
+      - "8123:8123"
+      - "9000:9000"
+
+  uptrace:
+    image: "uptrace/uptrace:1.2.0"
+    #image: 'uptrace/uptrace-dev:latest'
+    restart: on-failure
+    volumes:
+      - uptrace_data:/var/lib/uptrace
+      - ./uptrace.yml:/etc/uptrace/uptrace.yml
+    #environment:
+    #  - DEBUG=2
+    ports:
+      - "14317:14317"
+      - "14318:14318"
+    depends_on:
+      clickhouse:
+        condition: service_healthy
+
+  otel-collector:
+    image: otel/opentelemetry-collector-contrib:0.58.0
+    restart: on-failure
+    volumes:
+      - ./config/otel-collector.yaml:/etc/otelcol-contrib/config.yaml
+    ports:
+      - "4317:4317"
+      - "4318:4318"
+
+  vector:
+    image: timberio/vector:0.24.X-alpine
+    volumes:
+      - ./config/vector.toml:/etc/vector/vector.toml:ro
+
+  alertmanager:
+    image: prom/alertmanager:v0.24.0
+    restart: on-failure
+    volumes:
+      - ./config/alertmanager.yml:/etc/alertmanager/config.yml
+      - alertmanager_data:/alertmanager
+    ports:
+      - 9093:9093
+    command:
+      - "--config.file=/etc/alertmanager/config.yml"
+      - "--storage.path=/alertmanager"
+
+  mailhog:
+    image: mailhog/mailhog:v1.0.1
+    restart: on-failure
+    ports:
+      - "8025:8025"
+
+  redis-server:
+    image: redis
+    ports:
+      - "6379:6379"
+  redis-cli:
+    image: redis
+
+volumes:
+  uptrace_data:
+    driver: local
+  ch_data:
+    driver: local
+  alertmanager_data:
+    driver: local
diff --git a/docs/examples/opentelemetry/image/redis-py-trace.png b/docs/examples/opentelemetry/image/redis-py-trace.png
new file mode 100644
index 0000000000000000000000000000000000000000..e443238ab7a7b77f6cc39817fda78fcba81e060d
GIT binary patch
literal 18252
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
E0B@7zAOHXW

literal 0
HcmV?d00001

diff --git a/docs/examples/opentelemetry/main.py b/docs/examples/opentelemetry/main.py
new file mode 100755
index 0000000000..b140dd0148
--- /dev/null
+++ b/docs/examples/opentelemetry/main.py
@@ -0,0 +1,56 @@
+#!/usr/bin/env python3
+
+import time
+
+import uptrace
+from opentelemetry import trace
+from opentelemetry.instrumentation.redis import RedisInstrumentor
+
+import redis
+
+tracer = trace.get_tracer("app_or_package_name", "1.0.0")
+
+
+def main():
+    uptrace.configure_opentelemetry(
+        dsn="http://project2_secret_token@localhost:14317/2",
+        service_name="myservice",
+        service_version="1.0.0",
+    )
+    RedisInstrumentor().instrument()
+
+    client = redis.StrictRedis(host="localhost", port=6379)
+
+    span = handle_request(client)
+    print("trace:", uptrace.trace_url(span))
+
+    for i in range(10000):
+        handle_request(client)
+        time.sleep(1)
+
+
+def handle_request(client):
+    with tracer.start_as_current_span(
+        "handle-request", kind=trace.SpanKind.CLIENT
+    ) as span:
+        client.get("my-key")
+        client.set("hello", "world")
+        client.mset(
+            {
+                "employee_name": "Adam Adams",
+                "employee_age": 30,
+                "position": "Software Engineer",
+            }
+        )
+
+        pipe = client.pipeline()
+        pipe.set("foo", 5)
+        pipe.set("bar", 18.5)
+        pipe.set("blee", "hello world!")
+        pipe.execute()
+
+        return span
+
+
+if __name__ == "__main__":
+    main()
diff --git a/docs/examples/opentelemetry/requirements.txt b/docs/examples/opentelemetry/requirements.txt
new file mode 100644
index 0000000000..213280140c
--- /dev/null
+++ b/docs/examples/opentelemetry/requirements.txt
@@ -0,0 +1,3 @@
+redis==4.3.4
+uptrace==1.14.0
+opentelemetry-instrumentation-redis==0.35b0
diff --git a/docs/examples/opentelemetry/uptrace.yml b/docs/examples/opentelemetry/uptrace.yml
new file mode 100644
index 0000000000..4cb39f8fc8
--- /dev/null
+++ b/docs/examples/opentelemetry/uptrace.yml
@@ -0,0 +1,297 @@
+##
+## Uptrace configuration file.
+## See https://uptrace.dev/get/config.html for details.
+##
+## You can use environment variables anywhere in this file, for example:
+##
+##   foo: $FOO
+##   bar: ${BAR}
+##   baz: ${BAZ:default}
+##
+## To escape `$`, use `$$`, for example:
+##
+##   foo: $$FOO_BAR
+##
+
+##
+## ClickHouse database credentials.
+##
+ch:
+  # Connection string for ClickHouse database. For example:
+  # clickhouse://<user>:<password>@<host>:<port>/<database>?sslmode=disable
+  #
+  # See https://clickhouse.uptrace.dev/guide/golang-clickhouse.html#options
+  dsn: "clickhouse://default:@clickhouse:9000/uptrace?sslmode=disable"
+
+##
+## A list of pre-configured projects. Each project is fully isolated.
+##
+projects:
+  # Conventionally, the first project is used to monitor Uptrace itself.
+  - id: 1
+    name: Uptrace
+    # Token grants write access to the project. Keep a secret.
+    token: project1_secret_token
+    pinned_attrs:
+      - service.name
+      - host.name
+      - deployment.environment
+    # Group spans by deployment.environment attribute.
+    group_by_env: false
+    # Group funcs spans by service.name attribute.
+    group_funcs_by_service: false
+
+  # Other projects can be used to monitor your applications.
+  # To monitor micro-services or multiple related services, use a single project.
+  - id: 2
+    name: My project
+    token: project2_secret_token
+    pinned_attrs:
+      - service.name
+      - host.name
+      - deployment.environment
+    # Group spans by deployment.environment attribute.
+    group_by_env: false
+    # Group funcs spans by service.name attribute.
+    group_funcs_by_service: false
+
+##
+## Create metrics from spans and events.
+##
+metrics_from_spans:
+  - name: uptrace.tracing.spans_duration
+    description: Spans duration (excluding events)
+    instrument: histogram
+    unit: microseconds
+    value: span.duration / 1000
+    attrs:
+      - span.system as system
+      - service.name as service
+      - host.name as host
+      - span.status_code as status
+    where: not span.is_event
+
+  - name: uptrace.tracing.spans
+    description: Spans count (excluding events)
+    instrument: counter
+    unit: 1
+    value: span.count
+    attrs:
+      - span.system as system
+      - service.name as service
+      - host.name as host
+      - span.status_code as status
+    where: not span.is_event
+
+  - name: uptrace.tracing.events
+    description: Events count (excluding spans)
+    instrument: counter
+    unit: 1
+    value: span.count
+    attrs:
+      - span.system as system
+      - service.name as service
+      - host.name as host
+    where: span.is_event
+
+##
+## To require authentication, uncomment the following section.
+##
+auth:
+  # users:
+  #   - username: uptrace
+  #     password: uptrace
+  #   - username: admin
+  #     password: admin
+
+  # # Cloudflare user provider: uses Cloudflare Zero Trust Access (Identity)
+  # # See https://developers.cloudflare.com/cloudflare-one/identity/ for more info.
+  # cloudflare:
+  #   # The base URL of the Cloudflare Zero Trust team.
+  #   - team_url: https://myteam.cloudflareaccess.com
+  #     # The Application Audience (AUD) Tag for this application.
+  #     # You can retrieve this from the Cloudflare Zero Trust 'Access' Dashboard.
+  #     audience: bea6df23b944e4a0cd178609ba1bb64dc98dfe1f66ae7b918e563f6cf28b37e0
+
+  # # OpenID Connect (Single Sign-On)
+  # oidc:
+  #   # The ID is used in API endpoints, for example, in redirect URL
+  #   # `http://<uptrace-host>/api/v1/sso/<oidc-id>/callback`.
+  #   - id: keycloak
+  #     # Display name for the button in the login form.
+  #     # Default to 'OpenID Connect'
+  #     display_name: Keycloak
+  #     # The base URL for the OIDC provider.
+  #     issuer_url: http://localhost:8080/realms/uptrace
+  #     # The OAuth 2.0 Client ID
+  #     client_id: uptrace
+  #     # The OAuth 2.0 Client Secret
+  #     client_secret: ogbhd8Q0X0e5AZFGSG3m9oirPvnetqkA
+  #     # Additional OAuth 2.0 scopes to request from the OIDC provider.
+  #     # Defaults to 'profile'. 'openid' is requested by default and need not be specified.
+  #     scopes:
+  #       - profile
+  #     # The OIDC UserInfo claim to use as the user's username.
+  #     # Defaults to 'preferred_username'.
+  #     claim: preferred_username
+
+##
+## Alerting rules for monitoring metrics.
+##
+## See https://uptrace.dev/get/alerting.html for details.
+##
+alerting:
+  rules:
+    - name: Network errors
+      metrics:
+        - system.network.errors as $net_errors
+      query:
+        - $net_errors > 0 group by host.name
+      # for the last 5 minutes
+      for: 5m
+      annotations:
+        summary: "{{ $labels.host_name }} has high number of net errors: {{ $values.net_errors }}"
+
+    - name: Filesystem usage >= 90%
+      metrics:
+        - system.filesystem.usage as $fs_usage
+      query:
+        - group by host.name
+        - group by device
+        - where device !~ "loop"
+        - $fs_usage{state="used"} / $fs_usage >= 0.9
+      for: 5m
+      annotations:
+        summary: "{{ $labels.host_name }} has high FS usage: {{ $values.fs_usage }}"
+
+    - name: Uptrace is dropping spans
+      metrics:
+        - uptrace.projects.spans as $spans
+      query:
+        - $spans{type=dropped} > 0
+      for: 1m
+      annotations:
+        summary: "Uptrace has dropped {{ $values.spans }} spans"
+
+    - name: Always firing (for fun and testing)
+      metrics:
+        - process.runtime.go.goroutines as $goroutines
+      query:
+        - $goroutines >= 0 group by host.name
+      for: 1m
+      annotations:
+        summary: "{{ $labels.host_name }} has high number of goroutines: {{ $values.goroutines }}"
+
+  # Create alerts from error logs and span events.
+  create_alerts_from_spans:
+    enabled: true
+    labels:
+      alert_kind: error
+
+##
+## AlertManager client configuration.
+## See https://uptrace.dev/get/alerting.html for details.
+##
+## Note that this is NOT an AlertManager config and you need to configure AlertManager separately.
+## See https://prometheus.io/docs/alerting/latest/configuration/ for details.
+##
+alertmanager_client:
+  # AlertManager API endpoints that Uptrace uses to manage alerts.
+  urls:
+    - "http://alertmanager:9093/api/v2/alerts"
+
+##
+## Various options to tweak ClickHouse schema.
+## For changes to take effect, you need reset the ClickHouse database with `ch reset`.
+##
+ch_schema:
+  # Compression codec, for example, LZ4, ZSTD(3), or Default.
+  compression: ZSTD(3)
+
+  # Whether to use ReplicatedMergeTree instead of MergeTree.
+  replicated: false
+
+  # Cluster name for Distributed tables and ON CLUSTER clause.
+  #cluster: uptrace1
+
+  spans:
+    storage_policy: "default"
+    # Delete spans data after 30 days.
+    ttl_delete: 30 DAY
+
+  metrics:
+    storage_policy: "default"
+    # Delete metrics data after 90 days.
+    ttl_delete: 90 DAY
+
+##
+## Addresses on which Uptrace receives gRPC and HTTP requests.
+##
+listen:
+  # OTLP/gRPC API.
+  grpc:
+    addr: ":14317"
+    # tls:
+    #   cert_file: config/tls/uptrace.crt
+    #   key_file: config/tls/uptrace.key
+
+  # OTLP/HTTP API and Uptrace API with UI.
+  http:
+    addr: ":14318"
+    # tls:
+    #   cert_file: config/tls/uptrace.crt
+    #   key_file: config/tls/uptrace.key
+
+##
+## Various options for Uptrace UI.
+##
+site:
+  # Overrides public URL for Vue-powered UI in case you put Uptrace behind a proxy.
+  #addr: 'https://uptrace.mydomain.com'
+
+##
+## Spans processing options.
+##
+spans:
+  # The size of the Go chan used to buffer incoming spans.
+  # If the buffer is full, Uptrace starts to drop spans.
+  #buffer_size: 100000
+
+  # The number of spans to insert in a single query.
+  #batch_size: 10000
+
+##
+## Metrics processing options.
+##
+metrics:
+  # List of attributes to drop for being noisy.
+  drop_attrs:
+    - telemetry.sdk.language
+    - telemetry.sdk.name
+    - telemetry.sdk.version
+
+  # The size of the Go chan used to buffer incoming measures.
+  # If the buffer is full, Uptrace starts to drop measures.
+  #buffer_size: 100000
+
+  # The number of measures to insert in a single query.
+  #batch_size: 10000
+
+##
+## SQLite/PostgreSQL db that is used to store metadata such us metric names, dashboards, alerts,
+## and so on.
+##
+db:
+  # Either sqlite or postgres.
+  driver: sqlite
+  # Database connection string.
+  #
+  # Uptrace automatically creates SQLite database file in the current working directory.
+  # Make sure the directory is writable by Uptrace process.
+  dsn: "file:uptrace.sqlite3?_pragma=foreign_keys(1)&_pragma=busy_timeout(1000)"
+
+# Secret key that is used to sign JWT tokens etc.
+secret_key: 102c1a557c314fc28198acd017960843
+
+# Enable to log HTTP requests and database queries.
+debug: false
diff --git a/docs/examples/opentelemetry_api_examples.ipynb b/docs/examples/opentelemetry_api_examples.ipynb
new file mode 100644
index 0000000000..28fe758619
--- /dev/null
+++ b/docs/examples/opentelemetry_api_examples.ipynb
@@ -0,0 +1,423 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "7b02ea52",
+   "metadata": {},
+   "source": [
+    "# OpenTelemetry Python API"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "56520927",
+   "metadata": {},
+   "source": [
+    "## Install OpenTelemetry"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "c0ed8440",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Defaulting to user installation because normal site-packages is not writeable\n",
+      "Requirement already satisfied: opentelemetry-api in /home/vmihailenco/.local/lib/python3.10/site-packages (1.14.0)\n",
+      "Requirement already satisfied: opentelemetry-sdk in /home/vmihailenco/.local/lib/python3.10/site-packages (1.14.0)\n",
+      "Requirement already satisfied: setuptools>=16.0 in /usr/lib/python3/dist-packages (from opentelemetry-api) (59.6.0)\n",
+      "Requirement already satisfied: deprecated>=1.2.6 in /home/vmihailenco/.local/lib/python3.10/site-packages (from opentelemetry-api) (1.2.13)\n",
+      "Requirement already satisfied: opentelemetry-semantic-conventions==0.35b0 in /home/vmihailenco/.local/lib/python3.10/site-packages (from opentelemetry-sdk) (0.35b0)\n",
+      "Requirement already satisfied: typing-extensions>=3.7.4 in /home/vmihailenco/.local/lib/python3.10/site-packages (from opentelemetry-sdk) (4.4.0)\n",
+      "Requirement already satisfied: wrapt<2,>=1.10 in /home/vmihailenco/.local/lib/python3.10/site-packages (from deprecated>=1.2.6->opentelemetry-api) (1.14.1)\n",
+      "Note: you may need to restart the kernel to use updated packages.\n"
+     ]
+    }
+   ],
+   "source": [
+    "pip install opentelemetry-api opentelemetry-sdk"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "861fa9cb",
+   "metadata": {},
+   "source": [
+    "### Configure OpenTelemetry with console exporter"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "c061b6cb",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from opentelemetry import trace\n",
+    "from opentelemetry.sdk.trace import TracerProvider\n",
+    "from opentelemetry.sdk.trace.export import BatchSpanProcessor, ConsoleSpanExporter\n",
+    "\n",
+    "trace.set_tracer_provider(TracerProvider())\n",
+    "trace.get_tracer_provider().add_span_processor(\n",
+    "    BatchSpanProcessor(ConsoleSpanExporter())\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ae4a626c",
+   "metadata": {},
+   "source": [
+    "### Create a span using the tracer"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "f918501b",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{\n",
+      "    \"name\": \"operation-name\",\n",
+      "    \"context\": {\n",
+      "        \"trace_id\": \"0xff14cec5f33afeca0d04ced2c2185b39\",\n",
+      "        \"span_id\": \"0xd06e73b03bd55b4a\",\n",
+      "        \"trace_state\": \"[]\"\n",
+      "    },\n",
+      "    \"kind\": \"SpanKind.INTERNAL\",\n",
+      "    \"parent_id\": null,\n",
+      "    \"start_time\": \"2022-12-07T13:46:11.050878Z\",\n",
+      "    \"end_time\": \"2022-12-07T13:46:12.051944Z\",\n",
+      "    \"status\": {\n",
+      "        \"status_code\": \"UNSET\"\n",
+      "    },\n",
+      "    \"attributes\": {},\n",
+      "    \"events\": [],\n",
+      "    \"links\": [],\n",
+      "    \"resource\": {\n",
+      "        \"attributes\": {\n",
+      "            \"telemetry.sdk.language\": \"python\",\n",
+      "            \"telemetry.sdk.name\": \"opentelemetry\",\n",
+      "            \"telemetry.sdk.version\": \"1.14.0\",\n",
+      "            \"service.name\": \"unknown_service\"\n",
+      "        },\n",
+      "        \"schema_url\": \"\"\n",
+      "    }\n",
+      "}\n"
+     ]
+    }
+   ],
+   "source": [
+    "import time\n",
+    "\n",
+    "tracer = trace.get_tracer(\"app_or_package_name\", \"1.0.0\")\n",
+    "\n",
+    "# measure the timing of the operation\n",
+    "with tracer.start_as_current_span(\"operation-name\") as span:\n",
+    "    time.sleep(1)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ec4267aa",
+   "metadata": {},
+   "source": [
+    "### Record attributes"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "id": "fa9d265f",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{\n",
+      "    \"name\": \"operation-name\",\n",
+      "    \"context\": {\n",
+      "        \"trace_id\": \"0xfc11f0cc7afeefd79134eea639f5c78b\",\n",
+      "        \"span_id\": \"0xee791bf3cab65079\",\n",
+      "        \"trace_state\": \"[]\"\n",
+      "    },\n",
+      "    \"kind\": \"SpanKind.INTERNAL\",\n",
+      "    \"parent_id\": null,\n",
+      "    \"start_time\": \"2022-12-07T13:46:30.886188Z\",\n",
+      "    \"end_time\": \"2022-12-07T13:46:31.887323Z\",\n",
+      "    \"status\": {\n",
+      "        \"status_code\": \"UNSET\"\n",
+      "    },\n",
+      "    \"attributes\": {\n",
+      "        \"enduser.id\": \"jupyter\",\n",
+      "        \"enduser.email\": \"jupyter@redis-py\"\n",
+      "    },\n",
+      "    \"events\": [],\n",
+      "    \"links\": [],\n",
+      "    \"resource\": {\n",
+      "        \"attributes\": {\n",
+      "            \"telemetry.sdk.language\": \"python\",\n",
+      "            \"telemetry.sdk.name\": \"opentelemetry\",\n",
+      "            \"telemetry.sdk.version\": \"1.14.0\",\n",
+      "            \"service.name\": \"unknown_service\"\n",
+      "        },\n",
+      "        \"schema_url\": \"\"\n",
+      "    }\n",
+      "}\n"
+     ]
+    }
+   ],
+   "source": [
+    "with tracer.start_as_current_span(\"operation-name\") as span:\n",
+    "    if span.is_recording():\n",
+    "        span.set_attribute(\"enduser.id\", \"jupyter\")\n",
+    "        span.set_attribute(\"enduser.email\", \"jupyter@redis-py\")\n",
+    "    time.sleep(1)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e40655de",
+   "metadata": {},
+   "source": [
+    "### Change the span kind"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "id": "af2980ac",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{\n",
+      "    \"name\": \"operation-name\",\n",
+      "    \"context\": {\n",
+      "        \"trace_id\": \"0x2b4d1ba36423e6c17067079f044b5b62\",\n",
+      "        \"span_id\": \"0x323d6107cfe594bd\",\n",
+      "        \"trace_state\": \"[]\"\n",
+      "    },\n",
+      "    \"kind\": \"SpanKind.SERVER\",\n",
+      "    \"parent_id\": null,\n",
+      "    \"start_time\": \"2022-12-07T13:53:20.538393Z\",\n",
+      "    \"end_time\": \"2022-12-07T13:53:20.638595Z\",\n",
+      "    \"status\": {\n",
+      "        \"status_code\": \"UNSET\"\n",
+      "    },\n",
+      "    \"attributes\": {},\n",
+      "    \"events\": [],\n",
+      "    \"links\": [],\n",
+      "    \"resource\": {\n",
+      "        \"attributes\": {\n",
+      "            \"telemetry.sdk.language\": \"python\",\n",
+      "            \"telemetry.sdk.name\": \"opentelemetry\",\n",
+      "            \"telemetry.sdk.version\": \"1.14.0\",\n",
+      "            \"service.name\": \"unknown_service\"\n",
+      "        },\n",
+      "        \"schema_url\": \"\"\n",
+      "    }\n",
+      "}\n"
+     ]
+    }
+   ],
+   "source": [
+    "with tracer.start_as_current_span(\"operation-name\", kind=trace.SpanKind.SERVER) as span:\n",
+    "    time.sleep(0.1)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "2a9f1d99",
+   "metadata": {},
+   "source": [
+    "### Exceptions are automatically recorded"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "id": "1b453d66",
+   "metadata": {},
+   "outputs": [
+    {
+     "ename": "ValueError",
+     "evalue": "",
+     "output_type": "error",
+     "traceback": [
+      "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m",
+      "\u001b[0;31mValueError\u001b[0m                                Traceback (most recent call last)",
+      "Cell \u001b[0;32mIn[6], line 3\u001b[0m\n\u001b[1;32m      1\u001b[0m \u001b[38;5;28;01mwith\u001b[39;00m tracer\u001b[38;5;241m.\u001b[39mstart_as_current_span(\u001b[38;5;124m\"\u001b[39m\u001b[38;5;124moperation-name\u001b[39m\u001b[38;5;124m\"\u001b[39m, kind\u001b[38;5;241m=\u001b[39mtrace\u001b[38;5;241m.\u001b[39mSpanKind\u001b[38;5;241m.\u001b[39mSERVER) \u001b[38;5;28;01mas\u001b[39;00m span:\n\u001b[1;32m      2\u001b[0m     time\u001b[38;5;241m.\u001b[39msleep(\u001b[38;5;241m0.1\u001b[39m)\n\u001b[0;32m----> 3\u001b[0m     \u001b[38;5;28;01mraise\u001b[39;00m \u001b[38;5;167;01mValueError\u001b[39;00m\n",
+      "\u001b[0;31mValueError\u001b[0m: "
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{\n",
+      "    \"name\": \"operation-name\",\n",
+      "    \"context\": {\n",
+      "        \"trace_id\": \"0x20457d98d4456b99810163027c7899de\",\n",
+      "        \"span_id\": \"0xf16e4c1620091c72\",\n",
+      "        \"trace_state\": \"[]\"\n",
+      "    },\n",
+      "    \"kind\": \"SpanKind.SERVER\",\n",
+      "    \"parent_id\": null,\n",
+      "    \"start_time\": \"2022-12-07T13:55:24.108227Z\",\n",
+      "    \"end_time\": \"2022-12-07T13:55:24.208771Z\",\n",
+      "    \"status\": {\n",
+      "        \"status_code\": \"ERROR\",\n",
+      "        \"description\": \"ValueError: \"\n",
+      "    },\n",
+      "    \"attributes\": {},\n",
+      "    \"events\": [\n",
+      "        {\n",
+      "            \"name\": \"exception\",\n",
+      "            \"timestamp\": \"2022-12-07T13:55:24.208730Z\",\n",
+      "            \"attributes\": {\n",
+      "                \"exception.type\": \"ValueError\",\n",
+      "                \"exception.message\": \"\",\n",
+      "                \"exception.stacktrace\": \"Traceback (most recent call last):\\n  File \\\"/home/vmihailenco/.local/lib/python3.10/site-packages/opentelemetry/trace/__init__.py\\\", line 573, in use_span\\n    yield span\\n  File \\\"/home/vmihailenco/.local/lib/python3.10/site-packages/opentelemetry/sdk/trace/__init__.py\\\", line 1033, in start_as_current_span\\n    yield span_context\\n  File \\\"/tmp/ipykernel_241440/2787006841.py\\\", line 3, in <module>\\n    raise ValueError\\nValueError\\n\",\n",
+      "                \"exception.escaped\": \"False\"\n",
+      "            }\n",
+      "        }\n",
+      "    ],\n",
+      "    \"links\": [],\n",
+      "    \"resource\": {\n",
+      "        \"attributes\": {\n",
+      "            \"telemetry.sdk.language\": \"python\",\n",
+      "            \"telemetry.sdk.name\": \"opentelemetry\",\n",
+      "            \"telemetry.sdk.version\": \"1.14.0\",\n",
+      "            \"service.name\": \"unknown_service\"\n",
+      "        },\n",
+      "        \"schema_url\": \"\"\n",
+      "    }\n",
+      "}\n"
+     ]
+    }
+   ],
+   "source": [
+    "with tracer.start_as_current_span(\"operation-name\", kind=trace.SpanKind.SERVER) as span:\n",
+    "    time.sleep(0.1)\n",
+    "    raise ValueError"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "23708329",
+   "metadata": {},
+   "source": [
+    "### Use nested blocks to create child spans"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "9eb261d7",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{\n",
+      "    \"name\": \"child-span\",\n",
+      "    \"context\": {\n",
+      "        \"trace_id\": \"0x5625fbd0a1be15b49cda0d2bb236d158\",\n",
+      "        \"span_id\": \"0xc13b2c102566ffaf\",\n",
+      "        \"trace_state\": \"[]\"\n",
+      "    },\n",
+      "    \"kind\": \"SpanKind.INTERNAL\",\n",
+      "    \"parent_id\": \"0xa5f1a9afdf26173c\",\n",
+      "    \"start_time\": \"2022-12-07T13:57:14.011221Z\",\n",
+      "    \"end_time\": \"2022-12-07T13:57:14.011279Z\",\n",
+      "    \"status\": {\n",
+      "        \"status_code\": \"UNSET\"\n",
+      "    },\n",
+      "    \"attributes\": {\n",
+      "        \"foo\": \"bar\"\n",
+      "    },\n",
+      "    \"events\": [],\n",
+      "    \"links\": [],\n",
+      "    \"resource\": {\n",
+      "        \"attributes\": {\n",
+      "            \"telemetry.sdk.language\": \"python\",\n",
+      "            \"telemetry.sdk.name\": \"opentelemetry\",\n",
+      "            \"telemetry.sdk.version\": \"1.14.0\",\n",
+      "            \"service.name\": \"unknown_service\"\n",
+      "        },\n",
+      "        \"schema_url\": \"\"\n",
+      "    }\n",
+      "}\n",
+      "{\n",
+      "    \"name\": \"operation-name\",\n",
+      "    \"context\": {\n",
+      "        \"trace_id\": \"0x5625fbd0a1be15b49cda0d2bb236d158\",\n",
+      "        \"span_id\": \"0xa5f1a9afdf26173c\",\n",
+      "        \"trace_state\": \"[]\"\n",
+      "    },\n",
+      "    \"kind\": \"SpanKind.INTERNAL\",\n",
+      "    \"parent_id\": null,\n",
+      "    \"start_time\": \"2022-12-07T13:57:13.910849Z\",\n",
+      "    \"end_time\": \"2022-12-07T13:57:14.011320Z\",\n",
+      "    \"status\": {\n",
+      "        \"status_code\": \"UNSET\"\n",
+      "    },\n",
+      "    \"attributes\": {},\n",
+      "    \"events\": [],\n",
+      "    \"links\": [],\n",
+      "    \"resource\": {\n",
+      "        \"attributes\": {\n",
+      "            \"telemetry.sdk.language\": \"python\",\n",
+      "            \"telemetry.sdk.name\": \"opentelemetry\",\n",
+      "            \"telemetry.sdk.version\": \"1.14.0\",\n",
+      "            \"service.name\": \"unknown_service\"\n",
+      "        },\n",
+      "        \"schema_url\": \"\"\n",
+      "    }\n",
+      "}\n"
+     ]
+    }
+   ],
+   "source": [
+    "with tracer.start_as_current_span(\"operation-name\") as span:\n",
+    "    time.sleep(0.1)\n",
+    "    with tracer.start_as_current_span(\"child-span\") as span:\n",
+    "        span.set_attribute(\"foo\", \"bar\")"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.6"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/docs/images/opentelemetry/distributed-tracing.png b/docs/images/opentelemetry/distributed-tracing.png
new file mode 100644
index 0000000000000000000000000000000000000000..a011697f4ae39c98485c836167c6e211b571ab0c
GIT binary patch
literal 8175
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
DvlD=m

literal 0
HcmV?d00001

diff --git a/docs/images/opentelemetry/redis-metrics.png b/docs/images/opentelemetry/redis-metrics.png
new file mode 100644
index 0000000000000000000000000000000000000000..7c2beb4d6444a954184d6847bebd586339683f3d
GIT binary patch
literal 32347
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
ABme*a

literal 0
HcmV?d00001

diff --git a/docs/images/opentelemetry/redis-py-trace.png b/docs/images/opentelemetry/redis-py-trace.png
new file mode 100644
index 0000000000000000000000000000000000000000..e443238ab7a7b77f6cc39817fda78fcba81e060d
GIT binary patch
literal 18252
zcmb@ucUV(R(>M&MV4>K6TcijGN*6RBT}42;v_R-30U?AQkdC4ty>|f>sX3tp0)&oA
zZ&DI^QJN5%K<MQQ-p~E~e((1_*Z01EeAl&m=9=9(v$L~1vwL<Y34N}qOm~sxA_WBn
zoyxPPIusOV0CFxqe}-Ig;({9{gR{1eH6Bw?lty1Vv^+<~Dcy9GpHLL_ur87j$>-{N
ziX;*#Cm;1TH1bPp$Mp1c&Ex?OFYgc1@yW>vXVT^(yY&mW<4O6MIZ4n{CFQWTSL<UT
zoIZo@WyDJd+KChtw<uJeKGu6Vx||Unl`eJpk*N4*gCs$olatb+`!lvr#O*xG(!mSQ
zObwqzP;%Hf40uRVHkvnm;h}g0K26Ybf2Y5(|F42w1>bRVwXL>`>x@OKtIf)Wp3wkB
z)}88PjxUPPbGtGJo*ZW&lrfAH5c9i44>|LyODFttD*^^TvSLZTlNBNlzs()~Uf2sQ
z$*5ezeYVu-*X*=-=?Dm~w2wNx<I~_6d0x9FAWCv|U%>6iiywVVkvm(u)~+S+ghiRo
z<VdIO;M<2W!UKj8wa77xU~qwcIl|5s4<-yor*7ru%^vETPQK9>Nw1NpT~d8}z}VZ%
zb`<6$QD%}bn0!(Nn8UtTw(bAAwUWDZ!KZ0%du96<LAKD$jx?i;8>#668+^G1pYVEN
zUY4RDI)TSG%hC!|Vv1^5+fgc->@-{}GFEGDk=F3m{bf5wwDBken>c=4R{2rx%B)K^
ztPAON6OyCk2{r9J=Tcz)`#twBp7u_?hQwaMf#fM+lqWkxo)Z<HJLcrWU-+wnPp9zA
z3a6<-H85leTDwXg*MS_@kWc17%snFLaRbake*U!&B{~ZeU$jQ+DiV`CzzEnwn_&>f
zTgaoR^Pr7ots~89Fs-$U;7!bw^!Bc+cBxn7W2=0F<+=Y+4(HnrDVO~Q4b?O{c?OQW
zgp+gezFa{?8W>)yhlgrOA|?jpg@|+SMK65I>6G-e#PdPSg6C3T)y}ip!b_M$E(xJk
zvFm-%x~&c2Y8)aqXYeUpx9|a2$=?j${8pOI5~FO}I_tlu5{jc+(;(pE2I@CQuN7m4
zq)cW-B{p+HNsM&qsBvNQ_`bhdjf_I)EUv1|4)Z7qB8*^&Kf1#+rk7TRXheOjId^wN
zj-BKO)kxc_O55}yCcgQhlFMv^KJe*YAqk?W^n={pT@}~|Vcm;5Jz@kE@B-lu2doS*
zo0Pcd8e0q%I+trGmTy?0oV?wy9ER*IKd^;Oh>JSJfKJj@WZP}7btRQ?5z)8z(v7vX
z>Pr_J6N}#WD2}0zT<tLP#~X*u+5|Jbg049!@rATq1{m_-uZRtvt}kzXXOBbGKUQDe
zoG{sOS*ZO9KU<Q{?*&s;5H-86Z5#Q79uIaf$4TH!vIMQ>$B2bsyBPh|`gmhwDBa$0
z97Enmf4|NIns0g?caM-Fq>H#w|NKs$_NDF5nE5$=4Y080rC1^w7{$e0`eC3ElD(f_
znJ>K1;vy9TD$G8(4X?63;D)IAYDr*%zbc0cZ%JELhV=jV$dS`z4Mhv^MhF#$gjX7?
zq*+Rtz|zK4`8LHkEOs?VJ{@SqVw0cqyTnlYcz%E<V@)qOd8%IRdElEMl0L9%YTQ@D
z*GsA><DiOvtIa2H-4FZMO)6Cyj8Rp5hDju0R3D)L0V`ZXxLMl>Bo4zD(f$ZEX;ih9
zWHmuvp3+1uXi6XKq6yXT*i%%N|Ao{7+v0L$KdCy^2^UXPCt^)T?sbkv8wZ~RTaPog
z7oq4K5kq5jiiFZD!I`_WZX<9rsKjzFRF-c3y<k2Y!%Ua8h{CG3WR@{2qA(*3$V=nw
zjLuwh1gWelVujFGL;S!E)is!kB8z)@+nh7Yi>-sRXzfl_r<JRhbQ_L5l697wmvb(R
zcZ}}P!9(*&1-=4s%|wK|AkC%;p`K2nYS3x)s=Zr&-hzV4Ma_U9U}Lx=uPm9~TdoG%
zoL>_QdNE%XW$nGWVF+%<O3y9G5ntGhNXSM2;@i`(@iq4eTRauEmt|kbV+Fz@^!B@S
znSU&>(K+{mU3?t+MR&DY17k)FIgu9dN=CD;m{hX1*>9<`wy{J#flHqdp6D($q}{Wg
zVUsR`WntHrU0GOv-XcoLcz2owHzeW<KdESI1|5V??`6+CcxWgPM?WNIQ!%$bkn|wS
zEXGz<SpO}7r4|QBy2Q2_DG&7D)Ay+CweNhubUk;j6zDNFn7@me-}S%Govf+V;eD@2
z|B`wi9PGgcnR^eudFkX!n~^8ZBrmfvgOEN>GJ{SG4)D<tgp@I6`#ocOcj>lUGYI@}
zH*TX4n;5L`tSPPlk)uqgjtl-))>h~yUe8>nJZ8b4Gi+dzh#wnv>H!nWetHDjO&FU?
zy|knKN+(RZG;miZMN{kkb~z!WeUg4jOKYd2ULPDPoAl+ZhD}InX*yZ%AXNFvG2wAu
zxqLizYh9%I*?6<oU;X+o)U~!CrhZZ;8Z20<H4<b<{N&`09|5scXmnQ4j}R2d<oZD}
zQ@;S?D1p)RBMc-06?2+d*zMG@I|E3UG3D$g68pD_omQ-DS*J43aaDc)K7g>TOXD*o
zL9~L7VOQvL9gVWE*B8P9?ZgVA*w+-KY`<m_AJTHAkCL6KU(TRRTM)Oz()y&Xg!i_0
zs6(KN|E4E5Ji|7z&iW?ZWT!VoE(se+O~ZE01kUW%0rfk~pv)yUNDN(6@AJAz*VFkS
zyQy#EwQqpV{z~8UQUU!pdW`==7GKYcdUWx7$=Za0y#~Zh<)F$XlTaK?jm&bt#JM|P
z#INyX(a~adLHc)IBf`}S17_4Iqi^i|L_ea-`=%?(>fkZ+eHJ%kf#$XsB`E8LO|>hc
zwhjF;KrxKL)4(YW71UvqIH8F!gf-sgXigqY$QUDc=V+@I`_(03v|&x{3K%3&TLd~=
zp5ErYNv)efKY(zN_x@|ea~?7@Q1a9M-O)@z`b(*aDC#`ROytYh9s`^Z`yoLF?$VL_
zga$HpxHNY-Uh~!OfnlDSG9=FnytmsRirE%IW+IJJ`F}6_bSV->!&T7HBWCMxHr9!s
zA&jXZm42f=7?S~#4C-e1?*c{>;Q-V2oZIQPiM)1Gsw>(1)s`1Z_TuwJMsZSQWAhN>
zKMUH?*3b2*pHj5BXs6xkALi{D$y{ch5tYZr5?XcHXV;l9OT^$GZvcul5h5!36+qE;
zF%US-6y$WmG_|f3TXd-VnZlgnq)npH+*;tokD7w@58WTqQ!;XDyZCqd8~bks&PM*^
ztq>)K>XrZnIbo>&PJd(nbHV=)^o_=yEbo`+4n@`$7)*9|!zXddHMJ}Subp*w)*jI>
z%h%S*`*}@gC4ee-%sCIix|_m+ds^GRd!_R@LEOc?R*i`UMR3E}wIqfj`&;N&BFUtZ
zZa=}vPaF&Hw&OAL_W6wRuQ&JG_8)-*MUwF*-9OJUzpr=<k-4lTpVY=X74z0SDKk#B
zjRYp3?*A~yt{R2JrH3f<Eit$ANApWs)Q8~&I5R>`Ugfx7Sw4e~*_n)G{F(=&BZL7>
zA{*&~M_(TdJA7~BZ_j@SU+MqpILTz@1b5b*07(qR8=3hnbHRUM=7XqFkIaPkzhMM$
zzwp)R_s_@(z%K-jPBSCkfF8;nT9F-@W4666ERm6qMDlCr#4x?Gmu1?a!yL1~=sY-Q
z!weCxO=;KAX>Y*003f&ZU^uBq9$)_CrbWNQ%NS(ehm8&OawP&Rzeevx>EoYsB#f{D
zW|RV%jP-D+QwHzGQSvU#|Jr&3bn37GIZgh!P@o}cdV=98I1wcHMPdhn#Hq((-9N-K
z)~kY7rs(<>Lv!(;e(QMK7HXK<XCZO&hWl}H@K8YK{<X!M{T8xzQ!q5+ExKT`lFo=(
zyJH^b(&$QvzyGuuxu<nLjT-(2d%=*6-G7f_z!EBie2E2kkZtm_v&r?2jNdt3&}~nk
zZ$;wugB=%sZ8<O56gb`U>VCUf9ra}iK>Ls6y45%IvN*il$D0z4spB(Wuvx_2VDWon
zsx@&-z}E=;G8|RodrjV@s})2EJqmXmV0efT91a84>x(>;lg=5(GR81MV*ez{Q~2lc
z2me#f-jSwrd}SNyQq$Y8l3Mkxwr|DqH%4P!)af{@&P`i~QHkn>S+h=J!LO5mmE4+Z
zkKSBq(Oy{1yw7m`)d$yK?(am~Uk6P%m(nUK;rbMz5P8|H=LErUdL(|j+;Gf(Eb8iL
zE;Jxa?$)m$ZKoyrq1Gp3AJEKU!V_847%t*T0^pyd0qq_w)?Qs`8e05ZzViu*9rfwE
z1=fd!<^YrIQn%oJI)kDRg-WAf2*JcQA<iLSneynthnU*y%jm{?`RE`GUsH`bgw`2I
zRw8K7pzO`UB^1rj4;b+yPmRQEMu=NgYLs={Gp?)*#K2;G=Ej&9=>faL$j`hxck&Lr
zM$MANK9?FkeU`rIEg7AuEZ}Owc<=_es%Ly#A0iY(7~=};%8H08Ok_@6);bY_YFxb%
z-9Fmc<N9D2oD;!|TGdTR#mEn|9EgwYPnHiFiz{m}Vv4%h3aC%QfSDF;rr<4A2u*_k
z9At4mydd>DM$lC2_eV|U9pVrD@!E*2+%Q3oLz#^0nxo7O!Qm@j==U_A3++Xga))hQ
z!IC{betJ=^SgZ5;Dg6@}Y}e7B-VF1qR40NGU7r&MHK|yx!ccs@noC9b-WYk@+wt<a
zx*j#7_@rk-@cd2il{Vqnvg0_Q)%GL}z?ZN=6i6b1xz)87ZQ;=NBBq@nMqqR4$h)@7
zcvY-Nr_fsVLoTO74{?t5<)XK?M6(<>Ty`EGD`|`MhK2?al^ce07+!erkp?&=3LM=C
zR~Z(7$))0UtoraLc$!siCWCu`cTd_7ro!v$JH^qrfNpR&ARn*4glMt@8Pa3Gk*L1M
zRB5#VG{hD&qbuqJ=X>RY_RjJZNRdJqtbYO&GQJ$=4=wH}ctT*)T&efBsX*u2Cf7$e
z;C^MXF(K02Ph1ymKkY@hOBW|^{<3Q$@IuhTw<#;inRV@nO&Rgn)ok{|J}!8Kwz0h{
zqeb7OE(ZfY{2hy4B^N4s(Gcz|j7=CEjqMT_LJDA%(9WGL3usRWJc@PnCvIE`?8DNw
zuM5FWGF1bb#&>_-T}|L5?95KzxtEQ;)w7%JKXgwo*9yCR*V5r4%(TCJJaZs_(Kavd
zmmLZTG35h2z|U>5-ZRu3%T=K*3~}2jnY9aXoEPf!+ST(04Tqt%`PxJ|1ZlQ^{D5Pa
z_!s&a_6jD6IRz5QmJ=5f%kg}q_t^45F+rA)o_U~ip9t<@VdnHSrK>Pb+H2MCQ3dT@
zfS~yy)xe~gDM*Q3%7iY7(c#PwXQ7e~7NRsHc}U8k^yNczJs*7aO0i1982!GDTC)Dq
z@IaF5cC~@usDp!6j~3%AeC-UTBPXfAz8G|F#8xt(ZAt9wK|IDAB`OZdjxLOD=~zrD
zwxu*r1BxoCX^`qHVIjUcU;#zrpw37@jNR3V&XIE5sA2Y%`yEsY-~ySP^zKP93PMvr
zk3IrNh7OofY(+o)&NYlZH@y1-4=l75hCZh#<T3j8VL=%W+)!l@K3*#QP!TNckeoE7
zPF&<vIW&}Ul~^kQgm>P0msa;;t`v({U0{%KwN2Rl*)oR&*BsiTC78~X&1JX$e34dM
zwxl4L5l@<zLYa3IG6)ux*<32Er|C@uFj>{oOiQ?)eSS#xZQ%tNz7QIZeIEnD*CLbj
z<CQ8!PzHAvO!_612flL~C+lYoVIJEheyHfY?~mIf)doottDg1ylnP<CFPkz9mBl8q
ztG87{=;(2sg(0S{mmmzm?Kqa@-dVuA6k0?*gwH$csz87`YNE?!GgWh|Udo~6oQzG%
zxpoSA!eu$L5GK9S!z?nwna%-Roo#7fmTF%CZTmCSxg`!3m>N?8OZCskzjLW`OKBIY
zfFgA|byueph3^@F>lIxZj?Rks&VwVhbNg?5J`2Gf-%K%qKP3+6G3_DXA4k)MI=v1D
zvE0!PpO|YR0HJ`VVCd0XH3_EaTr~;T)Q_F~tvkQfB!rsPXav6Sqx4}u4cV|;HSwTr
zdwU|}!9=AU>Pn@MT_u+-Y16~2P-_4qS_l$BbW0Bh@s-nSRfmF?HG0yb9H=3dpPkm_
zH-tF_ZV6zx1Ta*mk3Y$RXxnqSDhwFjkKiPO|HaPgf7*EIffue)_`W}I=^46jVkPJv
zD1TWA6*kqGcD49w<J5N~BHLKDOYQ8sfnhT^1VwQYj7AmH&CF5ms)Z7ZfC~`HW4+O8
z5rJa*#;igb?tg9F$YTG`JGnz%t;oUO<M%jdr2_$HljN5L%eCkH^9NP<EPdvP26NS$
z!3%Lj4{JWJvG(f%K2H8&VuA0<F5D7`ShV_vfCQmp?<dY;rd&y=Qk?5=;aRCr;Wun-
z*@uoDDLS%|zus8d$1-mDRhft*ggz!n-Fc~7aXc4^twEuN(}JE_87$3*t0B1pq+PJb
zxrsR{pU~e1X1@)IZisUV=w0E3h@kQfQN@m3M)8S_e@Q^=G%@}YwONt|ve_&~alkL?
zO6?=C{y9%(or$~mi5iKC-uE!a0mk-SMP@(y-|I}pvnsFY-d)uspnhXNbc;dYGDXBe
z`x1^-*owLR=R%{G2zQ9_+>m0%ZKxvQ#7WraGXy;4IN7<6{VE7YOXV5e5Ox%TqepYu
zbqBVz7Dk#ZIQ5N^mNZhI(<y<uh_BiTCDvRC*0K7kd^4s!qcgvr4BhS{OgtsH6rM;y
z6~Vj0wse|qU=7n9qo5r(LbdAkZu=!^g0UqE$)C#(sdObQ9>lUHJI0Vzv|A4{6i#e8
zA_6|>rjaC(pG&JqLIHiPBVC1L`@CB!BjjVl_Sg`l^WzS5L5esJ8WA$?9x}c;<oc5z
z^JGRoT{b1Ey?P*M@dGd>oAT?-D_}j+b*HT3#||{xX<Zvq$#CrnALdJg&(eQ7-+Tmy
zp8MDNry@9zdDo+kOQ5l#@i?%De7rdXJ;I^Mu-<5W=zaycVyp_R8{kM(f#|k<jPy(v
zI8W!SLm;jiq#t4c&M46bh>V$Q?G$%(38=*-GhtNx$HxwOwZAkV98WeRAKrK@buUG*
zQBE_&m5{cs<sh3?#v2ZZzDws*UT|}r9J(P4vl40yGIG8dHc@8=9&#h3SZP`n9V*6x
zM0FS%&p`AI=!zESF#FB7yyS$TiH2&RzorioNc$kaZWZrRARe^=yC{L_*g2q13!$u!
z#mm%HfOCmzuoaCadj!&r6SdRBDbOhFxL;VpZd@#qfNyWcFPl1N5423dK*P3$O%zjk
zfW*|S7bZ58U7cbr9!aXJ;l@xM_9c*9ODm?gH+dloQ6Uu0CIlX*IOOWf^AyS^@kZ+!
z7IpP^Y!Pe>i;m}=d0};S^!^4=eA>MUI?AX{?{tjW6eC2L`0|;jLSR-d;1mJ$r-rTu
zQ?xo0jn;2+qda6j*Kjr#B#?+_&`pHv>SQuqjQ@1M#^0}S<N|Bq0EM$ALE4~ri;jBN
z#{nx+_YlK7RahP2czzw)v2O(NJHIlpK*pR^3B(LkaUwoa79&>8*%;49MBPl;uM$3`
z9D=P#3S{4;Vr5>5kHvq>A-7seZgmpxsR&k*IQx*BICloKAKOPq>CX-GQ-;Fa$&!={
zUpW=_M6)A}sbMV+xzu@<B1DH!9)&(t0U5E?Av`#$RRI$_pEB?UW@9`Q<zvd0N`$v8
zs9wIS!FB9!w@FpBsgmnj`G`ZXAHPDl1Y}bv=-Z?!MHY+88nhI_-uEb%^MF39!kWT-
zp+<jxOn=Y?3v=*&yp{ctZU4XUR<U?|K|y@+VkCyDv572qTpF6mG-Kj1IIw}2$g{1K
zBUxKt%`zUW;>P*RJMGE337Ycddkn8<-HBHzAg-Ra{p$PL3(}V4*<JQL?6i=vIX{Xn
zUR+fxXYnggDsj&xgV9177MUK4uLFbGc)RCHJC`uwbu`z=!?+EtllqN4!3U71-_kuh
zUijczu2GvRd8FzR^tlU;DgyM!k~{c!t8PHZbD%^3&RAX`rDe_rL8g?8RzV1vWyi^N
zZhfxT@l<z3BJJjFZ01hnw_PbXLPdGLJ=Lw-QTHs=)qna*i1m>rj<b<FVe55GO)%)_
z0FB9Q{Y*Zl7`t3xpLCN-Fc{EOJSNVbEE1(*8qq4@B41@tv{H7bRqgvu4$sR<3m_U9
zKPp>+vZB(DG8CC_fD@R;z$0gIZ~+?>Nw#HmFpB8|?A*i4j^`l^<ZpYKOOO+7a=9tz
z->XJ#n0Nmrxp%+`#iJ)kwG*}{V6_XBw<FBIv44V{3yggHuZxoZ%WwR*dlNQ)o$W_!
zo<U~=zjhQx#@5YkIL1&o8$$G%jlrFoXo`?%$V^m+oy0SWhvk5%O=QjExNM3LCkPFk
za(Y+@K1p|#B5D#dKXHq4`q$qmz2ND=M5EIuTxJa8^v#D^#bk-k-6dbP#F?${`A!-T
ze1{@`ca2lX%&<Ta+X<j4q_u-BT{Gpn34xf2$*plrI8VeW(_5r|FIp8KR*4VyVW<S%
zq_VU`&Z5WA78e^dyDqN3`3_{7oj0m<fPgBq&dAU~iu2%p@-M$8F&a?%$6zHvKAmZq
z*B@I_$Z)>_9uqd}F&!^TWX8V_R8a|X&Zy-vzXpTvQTm?0VJ`Ld1Nn=So&ysGkRFru
z>Z?we-%|Zf-ZF4-1p`;hPkS-U36H}{y_nDh<A}jIO%$CNvoc_)4hBksU7?VF3y>vC
zZ!fGp{AhR1kQNdT;2#rnF&@AyjiK1>V4(XF8J)1$uBP1OgQ6LXDp@VW(j4zKMq>!n
z=yc5q=S|7Rt6skCcpCK0jzZQkTMEG|t;uNyHbxQ&_!<7jt9iAzpZKC_jUY{D*GFQ=
zf{@*R?;9W+Nc<zP5`mXq1oXG?uPu+_o}!U|$^&KU2WzjEJKjaz7bF{a*TeeR!XUy5
zRKEq|f5CzeT1UTPkN94l0gQ9dtUo2x`WF;r*-bceHi!dZ6fe~qZvRY7C6kkkB$+nO
z$k0RbX4FJq==*dO2D24XOluM>Ro-+SP1`6#=33nLn<%0c2&WA?YY{y#M%k=d>StcE
zVxnZHbH!gwIA<nO@&+nGLih-rFD7)s6owZez412q9L5kj3>E8hLORctKb@(~IF4=d
zx?5E+mUR(ADR&toUO52h-#=a190$Aid6LV8ru4kV>Kre#T5v+^Qf<%|jVk@xB%-;_
zy}XVw(~2)h=LHoVv=<8cOi&26jYjxQ=XwjB<cbOi2{fJwR;HF1&{uDMObo^t^~Q5i
z%)eh<jYiQKNjO3lsn3iLs6Qd_YGDcF;cNjM_Rg>0h1N}KVN`z^v6egDfnQFHETCX-
z9~~cezAqg9Vmmg`3mn+0t^k%u{eoNNB^&6ImgKbI-x=dv24ymTK`19XyOZ?3J~>{O
zAa_y-T9?W6i#(g2bHd%y9^?<?ljmI&4{=c#%toMD<3Wi9_gMsbwR!hw6iBN}7{UqE
zXJleXQaz>B?Y{6`9}&o0)Xg+-pfvA{8jfL^+T1f9s{jt9A#-aOc3yKV3BznmTLj)@
za>R{D*wi5)Co~lDrOAK|OPNsz<+Sp$CI%cueL&~UV*J@9<;<S`9fcyt)Ry2)pxQn&
zG42sqbAABh5f(QMZNsm{B>sWsLjO8tY@E7<>i-SV*l5d@>4Zl1*}sG&KdWxOb2~1e
z`K`nkgHfLb@8f53CF!fftK};foj5wO(&OW%G&c=+S>KtZKa-*Y$$aYwE*^~W=xe8?
z`K0qnn6-7ORkGI=sUv1O(jI|J%j$;BJt}n5_dm(a2WLg3$*^?o^`A-AkJT$u)Q2Xa
zaB)m{d<GP6cC+{kB!oE`^Zm`vesW^yXO)SVw^B!{#~p?_gG($Q^~OIa;}SNdlGWSa
zxa^O=*HhPPO`9I#P!2fzbzwe0y~mN%9znyUJZI`_O?oxHU@sRV+DE!`f8KubO#9O7
zGq_&-FB1tB_oH@owfo?zxKj~K$Rf->HjNBT7$l3J-={YAHav_@<S~QLQra<$ZIOus
z61}W`_ZbhvWBuG^O)At3hn<FkQt*`CZ{nx1kd1};&reeG%byt~nuyKmB4wxwF8zQy
zs8`A7#l_#~RYA>$3O|fVH=(-|&v5&Wk-L~e(YDX6#n;VJWhRNYk77L9$qM4PYnNB0
zpREXclWfAS=$SIHV1JT6hq~$!gIBUt7<v?P$uvPf%{b8<Z1YHJ#2u@%7}~7E<NMga
zsK`z9;Pq0W8-Iho`@!>L6UK|&tl_Sv_1Ta2T~MG<{bvgTC9Zy;#omHh=*FvW@v-44
zTQh_m)-^ZKb}llDJYwo@AguE_*;cQj;PS)MA&kJWV7PgoJKrkfkL%E9oUjz{)Q{&c
z;LArzw=ZD;$MZ}4&=sfO7eZ4$O11H*OXsPLQWP+8(w4?ohB<O9$qz+cv5))m#%b)I
zSO5_DDoVwbjaIgfv)a9{%oidoc|-O>qP2cmPf;Yq7RTRy1N7O{RV>~_!{-)+xV7Z?
zMbJREQ;!QCAZA@O-=o(4s;lr_*qo7`;yf-*z)r<<q7H_YnzQojEVOcdfMeP*Pcjk5
zf(si|JB$lI!4ija*Ub3j7ZuP&Q$Ip<+fun74C!NmfipKg6_R9IYfQQ?FjoToZtrK8
zN@#SDMWcghbLDC`%M(zJS9#E~F*N$Osp}Yph=`*3W%v1Cn3fcLGjj%1C>k;#Bxj9G
zDt_Oa{w?X;?SW1tz><5<hAvAQ-BSQVHd{`9rv7Z1_}&BJ4q|^M_N|bL+`FYhYXYai
zfozP!&Xb~!zZ_oN3bz8^e-pOohE)H`#MTCc&AJK|aFv;KCzj_It;(`Ed{JYyDCD49
zEe02Hz;(S?k+8&foZ5#V=}?G(QjlVVTvzxx3jylqZa42my-J9ru90!P(W<RK^{n-=
zzCk?7<@TdyC7~Qssqze0?9>@P4iiLC3w5E*gO^=+LAz63J`)}a>zfue(9e=RheV1%
zV3~OOO+buR_kM4h<L^?Js~Xfgy!YMS>c;bT4}V4#pBnwrg6GUa3zfP-XIMdd0=F2;
z`_b4!FM|86{_?$tk$GXcym>g51>^b63;`{hF1$>yQ8{D3jDc<i_<dIlst!=3an)7)
z>=EHqW#Eb}uV3RKDs=?djZT=SqXL{5N0uKMlDEb@|J-u?ufClrmT#lDJSn1rjFR-p
zUlg%W{Z33j1NB24k(Us#!?}k5YA4$AD>(4$)~huKy|Q;njf~Tm3wvgL*Y8u5NN<AU
zZLUunvlwG2C?J&NM2-~sJN?1_=YoIer;8I3LwwKpwkp(*$eo$K-2E$h%=V#pF4e<#
zMXQS~dJbGP&a9b;y>}>zR;<44l^YZu^d_;4(`sJ`Fi1OFpaLl<mK>z=w+R1;0SP!)
zjWzZ0ilaeakav?tFGq;Roe{4MUb}1kAaQPeuD0Ysqg}dr&gF(m!GL67h`8tLSO~4l
zmo`8fF4fis-`?V@f-fR!uN~a6FpnW^JO{&Tll8QI=nEcAVh%MhnNRh9=m``3D1Dfp
zVl(K!bPTlwpJZ5S4;?%Y5Hq&L5X3v|zakBw|DyIOir3v(X;y}OW&YT9$Wyf_B9}jG
zX4Qvfz6J%Mhes-Kv}gluu$_M5GgRWDwC+07F>S;e)=X8!+-M4d`?L?{8>slPG?JX<
zq=DM3{7k!6pHci%F8RHR5V108P9zR{1Ddh*#*e7*`y6BjrHZLALp@L8Dy1(n!vM+P
z^zk;S><s#hoZF}*$5IdK?8$K&%?Nf=s{)k^c8fO)ZXxb+vNfpB-5Ij-yfBfwuH5mx
z%_(B4M}JR=uqM=Lew*m^#aXHUXr-p90$(shobgfZIKFze0z%lWUp;6N{eFS%ZjSZm
zY$=6r`?0~u{&LlV)aTy9i80qdBvaj2*xP&V_`|s4trHz=xbS!^+UO5cVK}X_55&!3
zNvBw)s_h)E_+qKD!vQ5PA_u15;u9Y>YJUUyrI36b9*POJI?n^mnc_Ae5QwFRzGKa(
zlBl_b{U0I!Fl#UX9|U-;Dpn%cE`7*<Ch976_Us@zWXkQCYQ?}jev-E|0~`3jzYX`-
zfbr+g&?ka^L`lN1b+Pq^pE_bsnn@$1KkC)b$%KUwzFd)T5O24K#CA43OS^TKWN3Yz
zIK071e7V1uN^;J&_EIio4><G>wi`{V)k<!{(K##yV8*C@!m;IkE7iwW;SQt9AVMo%
zXICw$$ry0iN>g$=g7$kI?(6RTuB9!?%gf4wI3Wesj?U`JbGW#?<}2nV@C8fkm<Q+E
zNjE(}!-3o-k2aRhY4LA7k^0W+fbgX6@rB$@Lu*PCqkKLz(e6+Qm??0%8{c{%_xD!W
zePVaioT*v$p386ff(o_!n^osa%&Xh|oTQ5e$}={abJDBpXjUYWTbgn1-rTHZ{yl^H
zyN6v;MTuG@cSLUF)H|dMsWT^?r{O`_<dWg!jEEvD!`krhbuZZDVa_|u=bh*&Q~EW(
zqv{_Dv);bzO$|R1*TXkWjgr^ugGdGv<H5+I?EqCy@MVEp;L9k($3WnpOj-Kckg}92
zfJ4Ap-z<Vevrcoo^W)n^t8=AcjNkal)bI3xTi{3J{D<(hVKcd|h!Z^R9m@Fa;=4bY
zOvLzyEt&Nx<)i<?`wxGsw`(_u4;ZIAH3p1JHDOW|=E6F@vV>3iRabLrnTUF|3eG(2
z0jb7!;1*S*IHb2E82tsrR$0%AQoLs}G<Yh=e-fL__Alb^1!o!7?X{U7D=i8R&b}`s
zT09sgEqBulIigz6Zw`A$@JIWg^XyxL7=#EMt)*=1ik;Il;-<%keKRr+1HblgA>h@o
znIh}@rE(@M-iJ7l)F^8=d-FvDsWPRMqsi^HXZySB7FTEuM9YqSU;cF`X;jdA93_iD
zx*T8F?N7yyv5#PmkTxLf7i1UEdh`st_alX|XeR|Je{l0YykXJdp2<wtzO|a`U=5FV
zeUG<$24j(}&5CCQ95_m!vUp7l{eNlizv%jOEKU_&uM5b_M^v(XyEr9EP@WF^TlIg2
zh^(3asCg>#D4u5WNdBLZB5BRe*42sg$=}x`xfE@8?%X6M*moDxuFHgz(q=~!ldZbr
zcYZlqcY~CR1_XM2%!}LK>qHo)Mc{YBv4g`3y~s@a9uV($$)6eQZZC8lm!vmZhi%3M
zKqT~ThxRJ>Wy|^D?)g2};U()Z$;#Xcusyf9Pvt5f0Y~>DL8`fJ-Y8eRcV2EHmucSQ
zC#t!60=1H!{YfAcOQ(b&ei|r=G(5<F=C2A7+{3WF>4+!|q&=}fY$sZ==7z!)@AR;F
z>zT46621#K^4RiXuV5!WP;y8EUaz{_X#5t+9q`}glB4#!fegbk_$=o)d+XmP&ioaF
zVHo2hj3=r39agnk6Z~w1a@2(g&jz}@FWo1O+Y;m)m`f}AE>0Fnhau%}%0y=O9iur8
zBe*{?!PA7JAkE&9rI{g!XzWB7GR|;~pRghYm%qu%*rLPVyJG#_F-LBKu(;t+Vpx2S
z;5RHx=4T~bJ*f{I5a^vwZQ;j3Gg<$;BBh#*cdq`imH%W^{|xl$Sp98L|2NgEH5THJ
zti6M*Uo&qE<;(DOxRZX#cclA9Y~4qdkQ?NAKu)Dxr&cP@NANOj?#O7B5+OA&EX8$T
z{2>7G@Yrz3!DepKT7!d`7(aBZ2yAk60mW~Gz>b21jpc5J42XFImVj)xgKT_kc~h0E
zV45_Tgi(`aO{(rv8;2ML!c2{Vy+R|+!jX|2;;l~}qC-rGS1Vft)J*-`hiSs#(a563
z2g!uJ#ja7g?*j=l18if0@F)iV1SZcN!|YEWr?G{cB4og4L_+cdAvF=7F!3a#iY$=G
zN12;MBP)(8<~%?7kEXm*8Ll{dyQx*K?uIyNS*jonRfrV#0KYe62{7T<?Uyk0%2Z7>
z2|IU1f*D@ugI+Km>#7D~!4aP2xURklOht>m&&zK{`wDi^SW=ZN2H_rtMC`y1Af+R$
z@*?sa@TE<=!H23E2>NAxMQ62i6*r%HSvKQ^QiM1BhHn~Vj96(vxZ5yp0obib*NJUs
zBZeL}RP2dmnN=j!nNv<Ji@kK(N(LJn>V_jUd7g9)oCk4DG!(D=NEsm%1dEqx9&jHh
z`2Z^)QykQM?#}Ja!PfZ*y9DqTyU5Uz73!ob#M+8s0uCKARzC81rw0%sRM%mIJ~%nw
zF!@yfvN$g-yTLAuQOn3|;&8EZU+$q2SHXgk*1bs800fe?OvwVVSiNOfxw^ENg55Su
zl3U#Vu%o;kxy?Mc@<ZIX_5FUPp<5&g!H2l<eks#b8fVOK&?P1Bw*AYGJkxu$bLO_K
zGIY~5t?w9(0uZABMCI`0Ub$9fU5|fR`A#i^3%dw0o2_PW7~3MMiCCc8zwu77uF_S!
z3b}8LnsL5k6?x-60WI<^O;>fZp0)>ZaNM?5+7iIod|kG3qtnMqXa)LwOW!DUF=pc(
zNM!6=4M$nh;k+o^j)UlDGhue)q^DDZy(}roCS6oH1>Gb>KvW|L<GJ4lx<*^`R^uJg
zAqSL)qjyGLcGq5)olpYMgefE0ZUE%bv&RZ&SShEC($K-ZL;8GPZY><!8H`Gq#|2ol
z=<IhJww~+va3AZXZsnFGm<{haIIi|KAQyR)YJC7NADHx+Bu7!g=wt`GrFqvj&k7Sf
zDtpA$?6?Bwf%~gx;GvMUD_eFSRn{H!q&m=0{3@#pSUEeuN7%M2V7`+=IC58vMg~CT
zo60lmMX*D4ErX+);Edkz!)7NrU!u8$Ai7i+Ko7_gwzqqXQ)l|z09e4+nf!+CZdrni
z*{CLM+oFwCM*kX(&_UOz%_nio%%U$cb?yUNnweG;9DH^CgIWfw$&UN54>{)4s+}8P
za?pThP?n@khH~gk3UaiE1yR~F;9p&E$V6Oxud|9YYcaCwE9>&EPBoObY1%FtVCv0_
zPlf=!-$pfe@$7a)S7~}Q+?;;r41OURLQIibxcV_^dnw#-#s<>NPiTn3n@`BBEg}j2
zQL@T_CE(S+=in@5Uac|%_02MOGv7B64m!}Lw_+sP)(#k5Bj%B}49!a?_f~2SS8#^S
z-agplBdsl$C;wXM_q2|82G6YROjfR}ppV_pT1k@^ol|c_eun7-R&(^$LT-HZj_Yc`
zln4QF#=LTyhv0NWpz;}Dr3hFt3Rp3c`4>JarQ%TiuiFjs-sJC9>_50i64*-i@czlK
zJNvgd2@H<N-sLPs2CJhFU}c*V=P>GjHGb+v3DJ?r)P=ddZZ}2&Pgde#z;=%!4q-y`
z;r1&vADa7zC%ttPciUB$3~qW=y7Z(<#gPJel3OW$xO;B($-G=?_Y&T(@>5!L%?HqI
zJa8<r=`YoFdW@<Q*ViXtx}M{|m;}htAB8kF1k~R(X^Ibrinlu}Ja!WDV2F9h*!@bF
z-x5RbWc{akV=bFHj|-%(_>WG7dBanyorUZ|(C*7fXo7BM{88RWdr<do+eIf{_#%jD
zr5eb7i})CGuv|RS!jIbZYR-AFS=(3CF{;?Qt{kcNu&{NVv|fO-QLxrfl9Nbu{vMrJ
zgNe!o(F0eW@MM?&xC768kEzBKiDJHx4|t7}YWayV&mvZpH8_+_p?K%<@sfMbJ+ynW
z4rG5jzxr7fpM}&pxsd~;-BFOhFQk-?F``qg<a;FLmESM)h*c>!-PGnn8+FGsLyi>d
zQ9urQ;`OfJ_1ljK89;SAOIuzSOT1CHkleeZAX7rh?0lJ&l{uS1=d`_Uy?Vy)+iF&+
zBG=P!&f1qNb$fm7OTVtR^ZP(xv7i~eA&L)v{o53lHi{|$f&hPJ7JNirrt$2^Rfl_t
z0+=45RhyK>kR&;)%kBN3%=*bLKo`vM29zehgj`;x&jIF}m(w7MXjzAQrrp56mQa~e
z((05RL8pTs{#id@*LcvFO}pbRE=dyAdwVQWlBftSex(4}8G%hyM$7iCN@+@TOb<9$
zLN#?m4xqZ=MfgwI=J$9kJbE7RnuhhTWaNAteGoLp(hx8vNu+_GGyT9te!L^mAlkzR
z5I;dduv`LO{s*Zxy{sqHKJ;?U6?g8kU}Np9qKRoKShtbK5M9)TjUdPMcaH1B)lJA?
z#DU{_o5hqVK`;ouD-{pyGtHTcoj@T+y2iIzp20uW@}Y_v?rLv@vm;fqT_dlL6?N{<
zI?1gQgAHJ0r@0JGd?BYzO@6_eYcRXB=9qdw15&wWyWs;CdE@uM%Wr$pXXs}2)7UVe
zfd^hhGy@B5I-T(^1R6xcw!k!-htI%^D{p|_P9vy))ToyTD!_;wbRd`bs(42{EMogP
z_!!^4*3Qp8cHy`57<mEtMa@mTAMvr0x9%J{xa}lYY*#XdF(&cEf~ANGbBwNFzaIPQ
z?4S69KT)6S$m3TFkHO@78^zPdIWjnX5UgSPFE8C&m)O-h$!!Cm;19Ia|El_%^3Mx_
zS?B*9Qo!}^D1*~j(SOcO$PuG|WB;uH<L?I13UPV<w1xQ=G2GM?B(3gE0riVT>6V?*
zeLz8utoRdV@#o-$2#2k39qs?<j$xd9MCe!IaFwfMPuW%>zb3~zO2kFkS`{g;L>-^u
zHkMW;*bfDXewj9Iw^t~~B_d`|eCu|z4a|>sFvnU9T|i;m#VHd4-{%qBh*`%({R|Aj
z)b8sp{nk`W6R*3!`1yZn^iu|ed%C1*0ME8Q6lrND0hxhxp80%GwmS3^EMlDFlQtPu
z%?W2_%lvN2GlcP4M3=70frcDj0Jtx|$MwEEmItqPNTm@TmMEQ1jQELt?cN=)3pOBt
zl)$?cFlVAr&<F?;^6sXg&N)-4(APsq2F))?Fg6*9x+5XPiE73T!AN}2ZQtBSj%exJ
zJCQ6ED7<=wT<g}v#~0n#$#Elll0RiUlbU2NPQDY{h`l3%*$=-(Jb;L8s&~Hm$z5Jq
znFv~4?YH1>NN76Ngo5CRSZvE<wO2%^=+u=;B}`;a3r?bQn$Mi~dAI6AwV#ik+-DZP
z_>(DAqN|fIBnyFwpad~CwJdNDEb?`V*zQXHS0&*GE$<ENV1t#3cr}AD7WIZ6NL_*{
zOLI7|C&{Zzw8=E_afuy5qX6Q@D<IEt<WO5{vP?Pwlg3;Iw_(I?mo&M9$}|TmyI3IA
z+{A;#tgBxEtgjwN$np1-4}0^^&g_e0m?Wp1?!5&TU2t3|+S1MStN=mygV+D|1#X_<
zZ-{f{y$&4Rkj=)<_aG@X{}GM*Rp{Tbq@%kSJ%3BPhXUNN$nH$2=b3|=&a^q=8OUY|
zMm%My>V;u-b4_3G7(wj@pw*s+D?<DqhtS(fGckQ-V!9L=M5G<to|ukpiXlzJU}@Po
zppjitMtpOAV(@ZU_Wg3-UT+P;3--_eB~uo447=6pXYaSQhzYSmNZ;>WAF!zZ#AW&z
z5R1Af+d&FMma<m+hOcmDfR&PC=eMmez@@X#YRnI*TRC#%a35hT0a^1!mi4{^lVfj3
zt&G66U1ReAj~HB=V`@#8TK>+~kiz))oUsd#AMd)n$tPr^bWttNdap`%EiswqyaFdn
z)bs*DWz!i`Wl3@yH`#9Z-6fmVVcoa)q$z)u(|DBl(3_ZJp;MnAs$ru@U>@^+{xtZ(
zsjdEF&b4U)tFOtC;^aHZe`3sg+Y2e=lMgWUvpnqpMMBfxmH#GKzxKbm4E}Go!>0xR
z@%H$o8$?+o8OG+PXTJ4x;Zvn@@<?atj-Qv}%FgOw3k+YsAs4VmJ-GiaoUlhtg{fB}
zNVTFEhDTBRUz7LbtwfI3h4x?E?rg%Sa%i<1?ZeiRp-204w7Q`Z{mIx%+{_SjZsN21
zMo@w}J)#OozP<A_^PyB(8e-<C2tXPhNQ=SEY|8BFKuW@=yp!a1zrZ4|n9o)NW?aU<
zuh`WY{6>;KE{0V~62hIfCw{2A;12_TSa#~L3GboifBbHmmR6I&=5r94{8Uonmgd_1
zUDRF#fQs9)drUMcz?(t5MZ7&JE=S;>DWgL}VzR%eU9B^25^GCfwxMdCkWKG2QP)@!
z2t)YGxu2)gLhVXXyHQAf^z1y+#f|w}??$QFr`_;U$I^CXxRRtYX<UicFA+h1hh5hG
zX+VCjxSEp7(UUfweOHsi-;bvhyLLvNXB5x#%;#74=&22T??}EfM5r<ocvk)Jl6Rja
z%|zh5;A0Wyim4ku%n+JW<=lox+$#g7p;H!d444)V&wSW?f#mHx9qtxy!Yip27jDc|
zcP%S8+d=9_flpp9RQg;k4mz&-p<lR}JA|K4%P7YA_?IL!*F#(hfGi@ihBX^^|0kT>
z%`h`z!jA7SUuJUhSOIx{74rxA`R->aQuazA?CvGj0WiDEwvo*I=>0)f;(g}cSL|OU
z8H(b<L09H~*cmL7_c6%Gdc7uQONDnovG!B#)jju=)2(KC6pb=nm>~=B#lJM@t0^0T
zhE0Yp9lZ2Rg_5JZ%>{_>4{(5@>k_^=v59B&OJ<E@1QOD^59BGUjlnz;E4!r570TTh
z?8OjP8s~hnG3`tE`E7fTSmd6SiZ~>>iUW#l8a?Ft6?1c4;)Mv&-<H~{Ckzlt!rzG(
zf^~OPnk6EO63kooi^3vC2W&r8Y}tgb#Z0^{rWz5{-N6*~*)jrqiG5&dkybz9pb3rc
zb_W(rLeYi_fq#tlkSOsyIeemH8j&Y>Bhm35rrwZnSg(U=*FkzfD&D);-Gg<`4H!C&
zG>?#Mee+v-hPg*>UY%%J<$vBu{aqQ7{0q+bzM}l3(o<N~e&*5j#6hDGV^jRe32uy`
zo#7sBdP-NyxN+jED@hJlIjZqo)jIKbmv2kTJF%dPrK(mNVppPFJWH59YR5>;&_S(a
zebK&=%<*iF3(Zmj7Jec?R0PdA<E^`P&`;8a2VdH{>sAFg%8Ps>sw#zD1qH+|J*wZ}
zEDu5o)@-?I(+(s%7Cz{SbL4`5!<KegsY&>avjGL=u*LbxsX!h6x0@?zapuAY=B)Ki
zXAP$=5S`wQKAvfch&12t|B0P!9GMz@O+l1Sq+dlMYP6`}reU4(stx<p7Y(lJ#eN7^
zCX5&9neH`9l=Mb&{-P>*a`~(w=lOpC75F?AaQQ6dDF|eIO(Agh@jrlc$6iX~PUO3>
z>r{Y~4bsAcW$UuVIl##ZbWd9JsX`!Q3HfDmZoEkOciuNMl+=ohiVpZ5b(3))Y#4G7
z&$@<EDW&^a*l#uwQt#vuFm^a9x83jvnt07pmX%gwiNRoLTLEHaumkQ_Zc4NE^zo6g
z!tb=tA%fU<M|t1-l^xXVq)nYAKDAW>Qvu1>K#o@|yIenstLn&IB<vMP6b9&MqYkQe
z`2pLUrg_TL?khcu_V{IPQfS4j%E_xY;hzlb%W`vj5dl9$Ebv##-8MPPvm?b|YYsKc
z>AHz*17a3+Iu;rQXo%Ik^YfA^2LpS@C(N%vBXUC(`sOP(*^;!+jeF|#i{?<*HQsg(
zH;s;8#`=x0)C`x-_d^fPNzG3D9IRZMPZF2Q``TZQR3p?YdM23;w6Nl79tLA==JMZh
zNy3iWx69tG<P?9L^cQ_I26c>Xv8Xtc)wJYCdc>BGZ;z>zA5G;gjgMup(Fi2zREeK7
zc^KaSutFuSlI<$X(TyGLtm^U3o^kgMbT-X5e4E(Y)4P(&ch%V4c@E+orD8F^T9Yey
zHjU^M!tmV>)&O;8!>`;(7lXu{#Xo|)!OtvSr{D|rKGeIDqoWJ4_XymsOs3Q3vQD1m
z1Nw$&D)QnZtun$}7Ye?rdNVb8OB#~oG#wqDh8h@N8ghHF&s|borsg^n=7>&k4Z&7p
z&v_<`cly;_i)^+`&tWha0MRi?%Y7$0=DzhQS>dp_sucPovnjmB-Yng*OS{r|cIvCt
zjmR*VRv?IH)h1HzNU+(GRF2&Z&H7@`?P2Kk3STWMRKkzep&*hh(2jVkox%hV9oSza
zfjT7M<F&_`#nlIU)ZplMUe=4(*}4VoT|lN5LO>Ii$J5<SLU*kKD;7yLAOkppzqXuq
znZ#(A+AN@g)A-3(_%#u-^bSZA3xHT$m5Ksf;sUYY&rQr4L5v^UXjhV0+z9T=pIpxw
zl0y6k$G;kRl;}Kss9znF_{Q*r{Y`Lsf#=w8KiY2H+Hhw+-@Iu*T2Wen&8|_m+I<qz
zP1O^9xi#V&X2yPCSY#fM!5_WHi`k}KY@Vh@v2h2Iyi4p`k`CoG#HBA453n#8yw=z4
zlVMeIE9ZkPiqn}{BB$+p_3YBAiPr~r9Z>0ZpPNv<i*x|{`<;@>l<fMe5R|OvrAo7X
zIz!pdMj%6P&~7G1q_Bx8D`y012t`wK)75hU_)F^E4c?Oi`waZ6+AlvocxaLYG(N3M
zgL25w!wcMsCFg$JV=qY?;!9mybOzBGcANA?sKI9<$w8x>_Pg)5t0ddXFBx7`|0?cf
z8?}F#z*e<e&AHWZ`_9;}<HaYCbQlE%b?WK=0_3Epyx-2bc>wP3?(dee#qQl5!e{ff
zenB}HnADsq>ZN3JM7iKLFqV@(ncz8}U)*T)SILts2BPPId!8h1w|V~=6Cj4{eH!;|
zz@VXS^f5cIYcBEKlUV!?*gNT3rxe)Q`Qj}~c19(~k>!~WxK?$~m(-^c;+4K3yl)&G
zJpbdGEZ*K~yh!#^WEW;ZqCWpRlPC%_-2015;4CLyFuCf~yZy_p8Bz+IJ&HVaaOA>2
zfLuUkf9mJ{1^(^s7+?R*_7AxHcO$3Z)K&fi&H({N3qDOx0vY#5fY)TNXZlwEJGsGA
z7f7Z%l_`*s3iwX*H7)GHM=#;-Z`ikC4Tfo~9#^H`9P-)i#LZ6@yRJDI81ME;mSwnT
z0;WFKitp6nK8-7vvk&f%IW1ZYr*FdQwv){Fr2kS@$xIEPA#{=X)-!;a3KdoE{+uVO
zoRkC6^q=H>oIS5;%YW9pnpvldE<64mJAbESJ}NUajrxv>`?vk+FxTv=Pm}_6bc7A#
z63w%Ql*BO$jaPI|YyETdy&L%huE$(GQCBr<a`Q@b-s5}j(<dFyhB1jxaX>g43$v72
zR!CYoHVqm{&j$;Ph<Z=W_0?~}Qh5;_EY=_`3LuaKHC$1`KYK}mn)~QgBnv^q`>QQ;
z-YM6Xzd}B)9cIgvoj|<b(u2{Ke37CztKl%|3k2D*?m$O`EpGQkX@p>R_uQXLPX+3i
z*%x)*c|C{QR&`=z3cb|#DywmH1Nz8So4j@6Jr_6PFC>=u^6?e0;U$6IG|}f|{RWZ-
zA5^_ymsY-8^Hx7EspCya?nf^#+Lu<~#c@^5Oa2nE`XRzBZy=kHIexpW>hR3CrN$wp
zuIQo{*B~=ov|up*ZJ%SdtiO(YmH6~m#x1d|X$O>2R`4V@5%i~Mj|A9Zj_fO>*j0p1
zVFZ8hCl}p;3w{OoFYFGCma^Y2cYj_UT_X=krV(Awn5$;BT2L8wG5+^2Tjn}8AASd(
zoSa5IM=q3Nnb^>;)QY}=OX~eflmd(Iu@OUSMK8|4H!K+m_6tMWI6;?@9$W64q_lgU
zhO!l{#{EiH*{V6L(Z`m3-j*tvUsNdtLPZOm#-8LG)YF1tU{QU;^j6*CWKr@eyxFcM
zadGnQ!gw#_XjT7N%Z$;L9yLUzipag314-0z$%dnJU}EYEKAJU!#pAGTH^MkAfkN@q
zJvM{o1-KMv)ED>0Q7!#_lbZbUoqj0`lCl>MMl*6mKqYOx0!!Vcn0o~Rdck}>g@U-~
z22RUjPGSGTvLl~UL!~>}RHy*|;(Z+=D;^csr@Gg~h?oa%8rFe<1pJ(?RpZjz#RnGX
z&Sw6|PgxA93pvPFAQ~W{Aq-#vZR#QB`IBg`X|Y4vFRIGfW;pcNBky!UD2W9n-W~_E
zVCCL^3y7p3EELf8v3GxHyJA;Tr$=sC;1T92AxJ<<Ge|Z*O4Dw#k!2{0p8WgCPm6Bc
zJK8L@ec5ek>B%8zdXu^>Vu|;0O#!v>(Zv!ff-X0z=SQv0fB|UD0{i7EiRv2pe;$?-
zxs?SBe#TP!yy>hw$7|W4Y*!Lx*c?`d=Wnh^BO6ZCC3Ub8f9dzJB__f$C@+XAo>aMJ
z{=JqdMG9b{i;q-yKTo7LX^}|z;FS9RZ1b{9d-$Z|Z68@j)Sgt!moryg@bAhshgZK$
z7oVMDx+|pDDDsl*8q;YdixjqmHNRh<!TdV!<+1AZw(M)R=_r3qc)4u7*jA3;8%u(x
zT|1^<tGTF%ZOw&p(HRSzZ5OOF+$YV$c+LAjm;NVEdkb8+0NY?|6M&gO-c|db9<VqA
z6=2v)t{2q_M<>~{#4?A~II=gbW7OW~#||m(z@=M+;tQ<}L9cgb-+LWs{co+pfnSFc
z&ekM9WQtgL{;{6fd!JhS^Jlls3-4aDl_~7S<f$sZ>$aZRCs;epAnaG;hFf8u&g!`5
zp7zxfE<T;;Y&BIavG_(k`<e^xY+?87cinpSd9z!DaY4e->)RGT{~-KVbA#2aG|Q;7
zCtB5}-OBa2TReq1!MuxM&4uM%OYBwp*KA9#Ik3vnOg8Q4eTLPJH!dd>$=!^Zap%$n
zTX*X<rK^A??gO72I?5VvIB&)(SglD@n|LXF!#{TZhD@!BgUKg>C*Ux6y85}Sb4q9e
E0B@7zAOHXW

literal 0
HcmV?d00001

diff --git a/docs/images/opentelemetry/tree-of-spans.png b/docs/images/opentelemetry/tree-of-spans.png
new file mode 100644
index 0000000000000000000000000000000000000000..399c8a0ddadad3633629e757cfd965667f88f711
GIT binary patch
literal 6401
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

literal 0
HcmV?d00001

diff --git a/docs/index.rst b/docs/index.rst
index 6dd537948e..a6ee05e917 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -72,6 +72,7 @@ Module Documentation
    advanced_features
    clustering
    lua_scripting
+   opentelemetry
    examples
 
 Contributing
diff --git a/docs/opentelemetry.rst b/docs/opentelemetry.rst
new file mode 100644
index 0000000000..96781028e3
--- /dev/null
+++ b/docs/opentelemetry.rst
@@ -0,0 +1,177 @@
+Integrating OpenTelemetry
+=========================
+
+What is OpenTelemetry?
+----------------------
+
+`OpenTelemetry <https://opentelemetry.io>`_ is an open-source observability framework for traces, metrics, and logs.
+
+OpenTelemetry allows developers to collect and export telemetry data in a vendor agnostic way. With OpenTelemetry, you can instrument your application once and then add or change vendors without changing the instrumentation, for example, here is a list of `popular DataDog competitors <https://uptrace.dev/get/compare/datadog-competitors.html>`_ that support OpenTelemetry.
+
+What is tracing?
+----------------
+
+`OpenTelemetry tracing <https://uptrace.dev/opentelemetry/distributed-tracing.html>`_ allows you to see how a request progresses through different services and systems, timings of each operation, any logs and errors as they occur.
+
+In a distributed environment, tracing also helps you understand relationships and interactions between microservices. Distributed tracing gives an insight into how a particular microservice is performing and how that service affects other microservices.
+
+.. image:: images/opentelemetry/distributed-tracing.png
+  :alt: Trace
+
+Using tracing, you can break down requests into spans. **Span** is an operation (unit of work) your app performs handling a request, for example, a database query or a network call.
+
+**Trace** is a tree of spans that shows the path that a request makes through an app. Root span is the first span in a trace.
+
+.. image:: images/opentelemetry/tree-of-spans.png
+  :alt: Trace
+
+To learn more about tracing, see `Distributed Tracing using OpenTelemetry <https://uptrace.dev/opentelemetry/distributed-tracing.html>`_.
+
+OpenTelemetry instrumentation
+-----------------------------
+
+Instrumentations are plugins for popular frameworks and libraries that use OpenTelemetry API to record important operations, for example, HTTP requests, DB queries, logs, errors, and more.
+
+To install OpenTelemetry `instrumentation <https://opentelemetry-python-contrib.readthedocs.io/en/latest/instrumentation/redis/redis.html>`_ for redis-py:
+
+.. code-block:: shell
+
+   pip install opentelemetry-instrumentation-redis
+
+You can then use it to instrument code like this:
+
+.. code-block:: python
+
+   from opentelemetry.instrumentation.redis import RedisInstrumentor
+
+   RedisInstrumentor().instrument()
+
+Once the code is patched, you can use redis-py as usually:
+
+.. code-block:: python
+
+   # Sync client
+   client = redis.Redis()
+   client.get("my-key")
+
+   # Async client
+   client = redis.asyncio.Redis()
+   await client.get("my-key")
+
+OpenTelemetry API
+-----------------
+
+`OpenTelemetry <https://uptrace.dev/opentelemetry/>`_ API is a programming interface that you can use to instrument code and collect telemetry data such as traces, metrics, and logs.
+
+You can use OpenTelemetry API to measure important operations:
+
+.. code-block:: python
+
+   from opentelemetry import trace
+
+   tracer = trace.get_tracer("app_or_package_name", "1.0.0")
+
+   # Create a span with name "operation-name" and kind="server".
+   with tracer.start_as_current_span("operation-name", kind=trace.SpanKind.CLIENT) as span:
+       do_some_work()
+
+Record contextual information using attributes:
+
+.. code-block:: python
+
+   if span.is_recording():
+       span.set_attribute("http.method", "GET")
+       span.set_attribute("http.route", "/projects/:id")
+
+And monitor exceptions:
+
+.. code-block:: python
+
+   except ValueError as exc:
+       # Record the exception and update the span status.
+       span.record_exception(exc)
+       span.set_status(trace.Status(trace.StatusCode.ERROR, str(exc)))
+
+See `OpenTelemetry Python Tracing API <https://uptrace.dev/opentelemetry/python-tracing.html>`_ for details.
+
+Uptrace
+-------
+
+Uptrace is an `open-source APM <https://uptrace.dev/get/open-source-apm.html>`_ that supports distributed tracing, metrics, and logs. You can use it to monitor applications and set up automatic alerts to receive notifications via email, Slack, Telegram, and more.
+
+You can use Uptrace to monitor redis-py using this `GitHub example <https://github.com/redis/redis-py/tree/master/docs/examples/opentelemetry>`_ as a starting point.
+
+.. image:: images/opentelemetry/redis-py-trace.png
+  :alt: Redis-py trace
+
+You can `install Uptrace <https://uptrace.dev/get/install.html>`_ by downloading a DEB/RPM package or a pre-compiled binary.
+
+Monitoring Redis Server performance
+-----------------------------------
+
+In addition to monitoring redis-py client, you can also monitor Redis Server performance using OpenTelemetry Collector Agent.
+
+OpenTelemetry Collector is a proxy/middleman between your application and a `distributed tracing tool <https://uptrace.dev/get/compare/distributed-tracing-tools.html>`_ such as Uptrace or Jaeger. Collector receives telemetry data, processes it, and then exports the data to APM tools that can store it permanently.
+
+For example, you can use the Redis receiver provided by Otel Collector to `monitor Redis performance <https://uptrace.dev/opentelemetry/redis-monitoring.html>`_:
+
+.. image:: images/opentelemetry/redis-metrics.png
+  :alt: Redis metrics
+
+See introduction to `OpenTelemetry Collector <https://uptrace.dev/opentelemetry/collector.html>`_ for details.
+
+Alerting and notifications
+--------------------------
+
+Uptrace also allows you to monitor `OpenTelemetry metrics <https://uptrace.dev/opentelemetry/metrics.html>`_ using alerting rules. For example, the following rule uses the group by node expression to create an alert whenever an individual Redis shard is down:
+
+.. code-block:: python
+
+   # /etc/uptrace/uptrace.yml
+
+   alerting:
+     rules:
+       - name: Redis shard is down
+         metrics:
+           - redis_up as $redis_up
+         query:
+           - group by cluster # monitor each cluster,
+           - group by bdb # each database,
+           - group by node # and each shard
+           - $redis_up == 0
+         # shard should be down for 5 minutes to trigger an alert
+         for: 5m
+
+You can also create queries with more complex expressions. For example, the following rule creates an alert when the keyspace hit rate is lower than 75%:
+
+.. code-block:: python
+
+   # /etc/uptrace/uptrace.yml
+
+   alerting:
+     rules:
+       - name: Redis read hit rate < 75%
+         metrics:
+           - redis_keyspace_read_hits as $hits
+           - redis_keyspace_read_misses as $misses
+         query:
+           - group by cluster
+           - group by bdb
+           - group by node
+           - $hits / ($hits + $misses) < 0.75
+         for: 5m
+
+See `Alerting and Notifications <https://uptrace.dev/get/alerting.html>`_ for details.
+
+What's next?
+------------
+
+Next, you can learn how to configure `uptrace-python <https://uptrace.dev/get/uptrace-python.html>`_ to export spans, metrics, and logs to Uptrace.
+
+You may also be interested in the following guides:
+
+- `OpenTelemetry Django <https://uptrace.dev/opentelemetry/instrumentations/python-django.html>`_
+- `OpenTelemetry Flask <https://uptrace.dev/opentelemetry/instrumentations/python-flask.html>`_
+- `OpenTelemetry FastAPI <https://uptrace.dev/opentelemetry/instrumentations/python-fastapi.html>`_
+- `OpenTelemetry SQLAlchemy <https://uptrace.dev/opentelemetry/instrumentations/python-sqlalchemy.html>`_
+- `OpenTelemetry instrumentations <https://uptrace.dev/opentelemetry/instrumentations/>`_

From f28a9f589371e8967871998b7972c3755bb622b1 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 21 Dec 2022 13:19:47 +0200
Subject: [PATCH 0643/1164] Fix `JSON.ARRINDEX` test (#2527)

* Fix test json.arrindex

* linters

* linters
---
 tests/test_json.py | 15 ++++-----------
 1 file changed, 4 insertions(+), 11 deletions(-)

diff --git a/tests/test_json.py b/tests/test_json.py
index 676683d9f7..a776e9e736 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -1326,17 +1326,10 @@ def test_arrindex_dollar(client):
         [],
     ]
 
-    # Fail with none-scalar value
-    with pytest.raises(exceptions.ResponseError):
-        client.json().arrindex("test_None", "$..nested42_empty_arr.arr", {"arr": []})
-
-    # Do not fail with none-scalar value in legacy mode
-    assert (
-        client.json().arrindex(
-            "test_None", ".[4][1].nested42_empty_arr.arr", '{"arr":[]}'
-        )
-        == -1
-    )
+    # Test with none-scalar value
+    assert client.json().arrindex(
+        "test_None", "$..nested42_empty_arr.arr", {"arr": []}
+    ) == [-1]
 
     # Test legacy (path begins with dot)
     # Test index of int scalar in single value

From f06f3db647c81bc24fa9bdad33822ca6175c32eb Mon Sep 17 00:00:00 2001
From: shacharPash <93581407+shacharPash@users.noreply.github.com>
Date: Wed, 21 Dec 2022 15:11:33 +0200
Subject: [PATCH 0644/1164] Add TIMEOUT to query class (#2519)

* add timeout to query class

* Add test_timeout

* fix lines

* fix format

* add test & fixes

* merge tests

* change timeout to not_a_number

* change q1 to q2

* Fix async method
---
 redis/commands/search/query.py    | 8 ++++++++
 tests/test_asyncio/test_search.py | 9 +++++++++
 tests/test_search.py              | 9 +++++++++
 3 files changed, 26 insertions(+)

diff --git a/redis/commands/search/query.py b/redis/commands/search/query.py
index e51918f500..5071cfabf2 100644
--- a/redis/commands/search/query.py
+++ b/redis/commands/search/query.py
@@ -28,6 +28,7 @@ def __init__(self, query_string):
         self._filters = list()
         self._ids = None
         self._slop = -1
+        self._timeout = None
         self._in_order = False
         self._sortby = None
         self._return_fields = []
@@ -131,6 +132,11 @@ def slop(self, slop):
         self._slop = slop
         return self
 
+    def timeout(self, timeout):
+        """overrides the timeout parameter of the module"""
+        self._timeout = timeout
+        return self
+
     def in_order(self):
         """
         Match only documents where the query terms appear in
@@ -188,6 +194,8 @@ def _get_args_tags(self):
             args += self._ids
         if self._slop >= 0:
             args += ["SLOP", self._slop]
+        if self._timeout:
+            args += ["TIMEOUT", self._timeout]
         if self._in_order:
             args.append("INORDER")
         if self._return_fields:
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 88c80d301b..12313b65e3 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -1001,3 +1001,12 @@ async def test_search_commands_in_pipeline(modclient: redis.Redis):
     assert "doc2" == res[3][4]
     assert res[3][5] is None
     assert res[3][3] == res[3][6] == ["txt", "foo bar"]
+
+
+@pytest.mark.redismod
+async def test_query_timeout(modclient: redis.Redis):
+    q1 = Query("foo").timeout(5000)
+    assert q1.get_args() == ["foo", "TIMEOUT", 5000, "LIMIT", 0, 10]
+    q2 = Query("foo").timeout("not_a_number")
+    with pytest.raises(redis.ResponseError):
+        await modclient.ft().search(q2)
diff --git a/tests/test_search.py b/tests/test_search.py
index 08c76f7e08..12876f6262 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1615,3 +1615,12 @@ def test_withsuffixtrie(modclient: redis.Redis):
     waitForIndex(modclient, getattr(modclient.ft(), "index_name", "idx"))
     info = modclient.ft().info()
     assert "WITHSUFFIXTRIE" in info["attributes"][0]
+
+
+@pytest.mark.redismod
+def test_query_timeout(modclient: redis.Redis):
+    q1 = Query("foo").timeout(5000)
+    assert q1.get_args() == ["foo", "TIMEOUT", 5000, "LIMIT", 0, 10]
+    q2 = Query("foo").timeout("not_a_number")
+    with pytest.raises(redis.ResponseError):
+        modclient.ft().search(q2)

From 1000a2b3c04570e6d011a6dcad2ec5299ff00563 Mon Sep 17 00:00:00 2001
From: Guillaume Tassery <tassery.guillaume@gmail.com>
Date: Sun, 25 Dec 2022 14:25:59 +0100
Subject: [PATCH 0645/1164] Add `timeout` parameter for
 SentinelManagedConnection (#2495)

---
 CHANGES                   |  1 +
 redis/asyncio/sentinel.py | 13 ++++++++++---
 2 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/CHANGES b/CHANGES
index b16fbce464..72b896b1b5 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Add `timeout=None` in `SentinelConnectionManager.read_response`
     * Documentation fix: password protected socket connection (#2374)
     * Allow `timeout=None` in `PubSub.get_message()` to wait forever
     * add `nowait` flag to `asyncio.Connection.disconnect()`
diff --git a/redis/asyncio/sentinel.py b/redis/asyncio/sentinel.py
index 99c5074950..ec17886fc6 100644
--- a/redis/asyncio/sentinel.py
+++ b/redis/asyncio/sentinel.py
@@ -1,7 +1,7 @@
 import asyncio
 import random
 import weakref
-from typing import AsyncIterator, Iterable, Mapping, Sequence, Tuple, Type
+from typing import AsyncIterator, Iterable, Mapping, Optional, Sequence, Tuple, Type
 
 from redis.asyncio.client import Redis
 from redis.asyncio.connection import (
@@ -63,9 +63,16 @@ async def connect(self):
             lambda error: asyncio.sleep(0),
         )
 
-    async def read_response(self, disable_decoding: bool = False):
+    async def read_response(
+        self,
+        disable_decoding: bool = False,
+        timeout: Optional[float] = None,
+    ):
         try:
-            return await super().read_response(disable_decoding=disable_decoding)
+            return await super().read_response(
+                disable_decoding=disable_decoding,
+                timeout=timeout,
+            )
         except ReadOnlyError:
             if self.connection_pool.is_master:
                 # When talking to a master, a ReadOnlyError when likely

From 55298e49caa5d76a7371568d2773e8e245b388a1 Mon Sep 17 00:00:00 2001
From: Jason Joy Atsu Winmorre <78548837+winmorre@users.noreply.github.com>
Date: Sun, 25 Dec 2022 13:28:53 +0000
Subject: [PATCH 0646/1164] Fix for Unhandled exception related to self.host
 with unix socket (#2520)

* Fix for Unhandled exception related to self.host with unix socket

* Added change to the CHANGES file

* fix linter error

* Reformatted connection.py file
---
 CHANGES             |  1 +
 redis/connection.py | 34 +++++++++++++++++++++++-----------
 2 files changed, 24 insertions(+), 11 deletions(-)

diff --git a/CHANGES b/CHANGES
index 72b896b1b5..228910f9b8 100644
--- a/CHANGES
+++ b/CHANGES
@@ -31,6 +31,7 @@
     * Enable Lock for asyncio cluster mode
     * Fix Sentinel.execute_command doesn't execute across the entire sentinel cluster bug (#2458)
     * Added a replacement for the default cluster node in the event of failure (#2463)
+    * Fix for Unhandled exception related to self.host with unix socket (#2496)
 
 * 4.1.3 (Feb 8, 2022)
     * Fix flushdb and flushall (#1926)
diff --git a/redis/connection.py b/redis/connection.py
index dce0735450..b810fc5714 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -664,12 +664,23 @@ def _connect(self):
             raise err
         raise OSError("socket.getaddrinfo returned an empty list")
 
+    def _host_error(self):
+        try:
+            host_error = f"{self.host}:{self.port}"
+        except AttributeError:
+            host_error = "connection"
+
+        return host_error
+
     def _error_message(self, exception):
         # args for socket.error can either be (errno, "message")
         # or just "message"
+
+        host_error = self._host_error()
+
         if len(exception.args) == 1:
             try:
-                return f"Error connecting to {self.host}:{self.port}. \
+                return f"Error connecting to {host_error}. \
                         {exception.args[0]}."
             except AttributeError:
                 return f"Connection Error: {exception.args[0]}"
@@ -677,7 +688,7 @@ def _error_message(self, exception):
             try:
                 return (
                     f"Error {exception.args[0]} connecting to "
-                    f"{self.host}:{self.port}. {exception.args[1]}."
+                    f"{host_error}. {exception.args[1]}."
                 )
             except AttributeError:
                 return f"Connection Error: {exception.args[0]}"
@@ -793,29 +804,30 @@ def can_read(self, timeout=0):
         sock = self._sock
         if not sock:
             self.connect()
+
+        host_error = self._host_error()
+
         try:
             return self._parser.can_read(timeout)
         except OSError as e:
             self.disconnect()
-            raise ConnectionError(
-                f"Error while reading from {self.host}:{self.port}: {e.args}"
-            )
+            raise ConnectionError(f"Error while reading from {host_error}: {e.args}")
 
     def read_response(self, disable_decoding=False):
         """Read the response from a previously sent command"""
-        try:
-            hosterr = f"{self.host}:{self.port}"
-        except AttributeError:
-            hosterr = "connection"
+
+        host_error = self._host_error()
 
         try:
             response = self._parser.read_response(disable_decoding=disable_decoding)
         except socket.timeout:
             self.disconnect()
-            raise TimeoutError(f"Timeout reading from {hosterr}")
+            raise TimeoutError(f"Timeout reading from {host_error}")
         except OSError as e:
             self.disconnect()
-            raise ConnectionError(f"Error while reading from {hosterr}" f" : {e.args}")
+            raise ConnectionError(
+                f"Error while reading from {host_error}" f" : {e.args}"
+            )
         except Exception:
             self.disconnect()
             raise

From d693221e9ac4bdf09cf3538ea38e7d7d2799059b Mon Sep 17 00:00:00 2001
From: Dongkeun Lee <3315213+zakaf@users.noreply.github.com>
Date: Sun, 25 Dec 2022 23:18:24 +0900
Subject: [PATCH 0647/1164] Allow EVAL_RO and EVALSHA_RO to be routed to read
 replica (#2494)

* fix typo (Lue -> Lua)

* run eval_ro, evalsha_ro test on redis cluster

* Add eval_ro, evalsha_ro to read only commands

* assert that commands are run in a round robin manner

Co-authored-by: zach.lee <zach.lee@sendbird.com>
Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/commands/cluster.py |  2 ++
 redis/commands/core.py    |  2 +-
 tests/test_cluster.py     | 10 +++++++++-
 tests/test_scripting.py   |  2 --
 4 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index f434f365a1..a23a94a3d3 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -52,6 +52,8 @@
     [
         "BITCOUNT",
         "BITPOS",
+        "EVAL_RO",
+        "EVALSHA_RO",
         "EXISTS",
         "GEODIST",
         "GEOHASH",
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 4cd0a9f73b..10eb0483cc 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -5139,7 +5139,7 @@ def eval_ro(
         """
         The read-only variant of the EVAL command
 
-        Execute the read-only Lue ``script`` specifying the ``numkeys`` the script
+        Execute the read-only Lua ``script`` specifying the ``numkeys`` the script
         will touch and the key names and argument values in ``keys_and_args``.
         Returns the result of the script.
 
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 9866cfcb08..27cfee1c6f 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -561,7 +561,15 @@ def parse_response_mock_third(connection, *args, **options):
                 read_cluster.get("foo")
                 read_cluster.get("foo")
                 read_cluster.get("foo")
-                mocks["send_command"].assert_has_calls([call("READONLY")])
+                mocks["send_command"].assert_has_calls(
+                    [
+                        call("READONLY"),
+                        call("GET", "foo"),
+                        call("READONLY"),
+                        call("GET", "foo"),
+                        call("GET", "foo"),
+                    ]
+                )
 
     def test_keyslot(self, r):
         """
diff --git a/tests/test_scripting.py b/tests/test_scripting.py
index bbe845c0da..b6b5f9fb70 100644
--- a/tests/test_scripting.py
+++ b/tests/test_scripting.py
@@ -67,7 +67,6 @@ def test_eval_multiply(self, r):
 
     @skip_if_server_version_lt("7.0.0")
     @skip_if_redis_enterprise()
-    @pytest.mark.onlynoncluster
     def test_eval_ro(self, r):
         r.set("a", "b")
         assert r.eval_ro("return redis.call('GET', KEYS[1])", 1, "a") == b"b"
@@ -157,7 +156,6 @@ def test_evalsha(self, r):
 
     @skip_if_server_version_lt("7.0.0")
     @skip_if_redis_enterprise()
-    @pytest.mark.onlynoncluster
     def test_evalsha_ro(self, r):
         r.set("a", "b")
         get_sha = r.script_load("return redis.call('GET', KEYS[1])")

From f10c81ac2406fc9cacea0f2e9938910db1c751e5 Mon Sep 17 00:00:00 2001
From: stitch <111570933+stitchWzc@users.noreply.github.com>
Date: Mon, 26 Dec 2022 16:56:16 +0800
Subject: [PATCH 0648/1164] Support for resetchannels since Redis 6.2.0 (#2514)

---
 redis/commands/core.py | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 10eb0483cc..e3a758d5fd 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -193,6 +193,7 @@ def acl_setuser(
         selectors: Optional[Iterable[Tuple[str, KeyT]]] = None,
         reset: bool = False,
         reset_keys: bool = False,
+        reset_channels: bool = False,
         reset_passwords: bool = False,
         **kwargs,
     ) -> ResponseT:
@@ -248,6 +249,12 @@ def acl_setuser(
         key permissions will be kept and any new specified key permissions
         will be applied on top.
 
+        ``reset_channels`` is a boolean indicating whether the user's channel
+        permissions should be reset prior to applying any new channel permissions
+        specified in ``channels``.If this is False, the user's existing
+        channel permissions will be kept and any new specified channel permissions
+        will be applied on top.
+
         ``reset_passwords`` is a boolean indicating whether to remove all
         existing passwords and the 'nopass' flag from the user prior to
         applying any new passwords specified in 'passwords' or
@@ -266,6 +273,9 @@ def acl_setuser(
         if reset_keys:
             pieces.append(b"resetkeys")
 
+        if reset_channels:
+            pieces.append(b"resetchannels")
+
         if reset_passwords:
             pieces.append(b"resetpass")
 

From ed38e77050241a84c0108e47254d1804e8640531 Mon Sep 17 00:00:00 2001
From: DvirDukhan <dvir@redis.com>
Date: Mon, 2 Jan 2023 16:28:53 +0200
Subject: [PATCH 0649/1164] Add dialect to ft aggregate (#2537)

* add dialect to aggregate request

* added test

* format

* async test
---
 redis/commands/search/aggregation.py |  13 +++
 tests/test_asyncio/test_search.py    | 169 ++++++++++++++++-----------
 tests/test_search.py                 |  30 +++--
 3 files changed, 131 insertions(+), 81 deletions(-)

diff --git a/redis/commands/search/aggregation.py b/redis/commands/search/aggregation.py
index a171fa13e8..93a3d9273b 100644
--- a/redis/commands/search/aggregation.py
+++ b/redis/commands/search/aggregation.py
@@ -108,6 +108,7 @@ def __init__(self, query="*"):
         self._with_schema = False
         self._verbatim = False
         self._cursor = []
+        self._dialect = None
 
     def load(self, *fields):
         """
@@ -321,10 +322,22 @@ def build_args(self):
             ret.append(str(len(self._loadfields)))
             ret.extend(self._loadfields)
 
+        if self._dialect:
+            ret.extend(["DIALECT", self._dialect])
+
         ret.extend(self._aggregateplan)
 
         return ret
 
+    def dialect(self, dialect):
+        """
+        Add a dialect field to the aggregate command.
+
+        - **dialect** - dialect version to execute the query under
+        """
+        self._dialect = dialect
+        return self
+
 
 class Cursor:
     def __init__(self, cid):
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 12313b65e3..8707cdf61b 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -832,100 +832,127 @@ async def test_aggregations_groupby(modclient: redis.Redis):
         },
     )
 
-    req = aggregations.AggregateRequest("redis").group_by("@parent", reducers.count())
+    for dialect in [1, 2]:
+        req = (
+            aggregations.AggregateRequest("redis")
+            .group_by("@parent", reducers.count())
+            .dialect(dialect)
+        )
 
-    res = (await modclient.ft().aggregate(req)).rows[0]
-    assert res[1] == "redis"
-    assert res[3] == "3"
+        res = (await modclient.ft().aggregate(req)).rows[0]
+        assert res[1] == "redis"
+        assert res[3] == "3"
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.count_distinct("@title")
-    )
+        req = (
+            aggregations.AggregateRequest("redis")
+            .group_by("@parent", reducers.count_distinct("@title"))
+            .dialect(dialect)
+        )
 
-    res = (await modclient.ft().aggregate(req)).rows[0]
-    assert res[1] == "redis"
-    assert res[3] == "3"
+        res = (await modclient.ft().aggregate(req)).rows[0]
+        assert res[1] == "redis"
+        assert res[3] == "3"
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.count_distinctish("@title")
-    )
+        req = (
+            aggregations.AggregateRequest("redis")
+            .group_by("@parent", reducers.count_distinctish("@title"))
+            .dialect(dialect)
+        )
 
-    res = (await modclient.ft().aggregate(req)).rows[0]
-    assert res[1] == "redis"
-    assert res[3] == "3"
+        res = (await modclient.ft().aggregate(req)).rows[0]
+        assert res[1] == "redis"
+        assert res[3] == "3"
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.sum("@random_num")
-    )
+        req = (
+            aggregations.AggregateRequest("redis")
+            .group_by("@parent", reducers.sum("@random_num"))
+            .dialect(dialect)
+        )
 
-    res = (await modclient.ft().aggregate(req)).rows[0]
-    assert res[1] == "redis"
-    assert res[3] == "21"  # 10+8+3
+        res = (await modclient.ft().aggregate(req)).rows[0]
+        assert res[1] == "redis"
+        assert res[3] == "21"  # 10+8+3
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.min("@random_num")
-    )
+        req = (
+            aggregations.AggregateRequest("redis")
+            .group_by("@parent", reducers.min("@random_num"))
+            .dialect(dialect)
+        )
 
-    res = (await modclient.ft().aggregate(req)).rows[0]
-    assert res[1] == "redis"
-    assert res[3] == "3"  # min(10,8,3)
+        res = (await modclient.ft().aggregate(req)).rows[0]
+        assert res[1] == "redis"
+        assert res[3] == "3"  # min(10,8,3)
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.max("@random_num")
-    )
+        req = (
+            aggregations.AggregateRequest("redis")
+            .group_by("@parent", reducers.max("@random_num"))
+            .dialect(dialect)
+        )
 
-    res = (await modclient.ft().aggregate(req)).rows[0]
-    assert res[1] == "redis"
-    assert res[3] == "10"  # max(10,8,3)
+        res = (await modclient.ft().aggregate(req)).rows[0]
+        assert res[1] == "redis"
+        assert res[3] == "10"  # max(10,8,3)
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.avg("@random_num")
-    )
+        req = (
+            aggregations.AggregateRequest("redis")
+            .group_by("@parent", reducers.avg("@random_num"))
+            .dialect(dialect)
+        )
 
-    res = (await modclient.ft().aggregate(req)).rows[0]
-    assert res[1] == "redis"
-    assert res[3] == "7"  # (10+3+8)/3
+        res = (await modclient.ft().aggregate(req)).rows[0]
+        assert res[1] == "redis"
+        assert res[3] == "7"  # (10+3+8)/3
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.stddev("random_num")
-    )
+        req = (
+            aggregations.AggregateRequest("redis")
+            .group_by("@parent", reducers.stddev("random_num"))
+            .dialect(dialect)
+        )
 
-    res = (await modclient.ft().aggregate(req)).rows[0]
-    assert res[1] == "redis"
-    assert res[3] == "3.60555127546"
+        res = (await modclient.ft().aggregate(req)).rows[0]
+        assert res[1] == "redis"
+        assert res[3] == "3.60555127546"
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.quantile("@random_num", 0.5)
-    )
+        req = (
+            aggregations.AggregateRequest("redis")
+            .group_by("@parent", reducers.quantile("@random_num", 0.5))
+            .dialect(dialect)
+        )
 
-    res = (await modclient.ft().aggregate(req)).rows[0]
-    assert res[1] == "redis"
-    assert res[3] == "8"  # median of 3,8,10
+        res = (await modclient.ft().aggregate(req)).rows[0]
+        assert res[1] == "redis"
+        assert res[3] == "8"  # median of 3,8,10
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.tolist("@title")
-    )
+        req = (
+            aggregations.AggregateRequest("redis")
+            .group_by("@parent", reducers.tolist("@title"))
+            .dialect(dialect)
+        )
 
-    res = (await modclient.ft().aggregate(req)).rows[0]
-    assert res[1] == "redis"
-    assert set(res[3]) == {"RediSearch", "RedisAI", "RedisJson"}
+        res = (await modclient.ft().aggregate(req)).rows[0]
+        assert res[1] == "redis"
+        assert set(res[3]) == {"RediSearch", "RedisAI", "RedisJson"}
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.first_value("@title").alias("first")
-    )
+        req = (
+            aggregations.AggregateRequest("redis")
+            .group_by("@parent", reducers.first_value("@title").alias("first"))
+            .dialect(dialect)
+        )
 
-    res = (await modclient.ft().aggregate(req)).rows[0]
-    assert res == ["parent", "redis", "first", "RediSearch"]
+        res = (await modclient.ft().aggregate(req)).rows[0]
+        assert res == ["parent", "redis", "first", "RediSearch"]
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.random_sample("@title", 2).alias("random")
-    )
+        req = (
+            aggregations.AggregateRequest("redis")
+            .group_by("@parent", reducers.random_sample("@title", 2).alias("random"))
+            .dialect(dialect)
+        )
 
-    res = (await modclient.ft().aggregate(req)).rows[0]
-    assert res[1] == "redis"
-    assert res[2] == "random"
-    assert len(res[3]) == 2
-    assert res[3][0] in ["RediSearch", "RedisAI", "RedisJson"]
+        res = (await modclient.ft().aggregate(req)).rows[0]
+        assert res[1] == "redis"
+        assert res[2] == "random"
+        assert len(res[3]) == 2
+        assert res[3][0] in ["RediSearch", "RedisAI", "RedisJson"]
 
 
 @pytest.mark.redismod
diff --git a/tests/test_search.py b/tests/test_search.py
index 12876f6262..57d4338ead 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -973,16 +973,26 @@ def test_aggregations_filter(client):
     client.ft().client.hset("doc1", mapping={"name": "bar", "age": "25"})
     client.ft().client.hset("doc2", mapping={"name": "foo", "age": "19"})
 
-    req = aggregations.AggregateRequest("*").filter("@name=='foo' && @age < 20")
-    res = client.ft().aggregate(req)
-    assert len(res.rows) == 1
-    assert res.rows[0] == ["name", "foo", "age", "19"]
-
-    req = aggregations.AggregateRequest("*").filter("@age > 15").sort_by("@age")
-    res = client.ft().aggregate(req)
-    assert len(res.rows) == 2
-    assert res.rows[0] == ["age", "19"]
-    assert res.rows[1] == ["age", "25"]
+    for dialect in [1, 2]:
+        req = (
+            aggregations.AggregateRequest("*")
+            .filter("@name=='foo' && @age < 20")
+            .dialect(dialect)
+        )
+        res = client.ft().aggregate(req)
+        assert len(res.rows) == 1
+        assert res.rows[0] == ["name", "foo", "age", "19"]
+
+        req = (
+            aggregations.AggregateRequest("*")
+            .filter("@age > 15")
+            .sort_by("@age")
+            .dialect(dialect)
+        )
+        res = client.ft().aggregate(req)
+        assert len(res.rows) == 2
+        assert res.rows[0] == ["age", "19"]
+        assert res.rows[1] == ["age", "25"]
 
 
 @pytest.mark.redismod

From 3a43190c59da94ac71b58f05c8d57a951602c5f1 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 4 Jan 2023 11:15:59 +0200
Subject: [PATCH 0650/1164] Including startup instructions via redis-stack
 docker (#2535)

---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.md b/README.md
index bfd345cbec..c02483fe93 100644
--- a/README.md
+++ b/README.md
@@ -21,6 +21,12 @@ redis-py 4.3.x will be the last generation of redis-py to support python 3.6 as
 
 ## Installation
 
+Start a redis via docker:
+
+``` bash
+docker run -p 6379:6379 -it redis/redis-stack:latest
+```
+
 To install redis-py, simply:
 
 ``` bash

From f14ed1fc822a88a21bbfc64e36bf8b09e5c9386c Mon Sep 17 00:00:00 2001
From: SessionIssue <118734962+SessionIssue@users.noreply.github.com>
Date: Thu, 5 Jan 2023 13:31:45 +0100
Subject: [PATCH 0651/1164] Update __init__ for issue 2215 (#2539)

Fallback for issue https://github.com/redis/redis-py/issues/2215
---
 redis/__init__.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/redis/__init__.py b/redis/__init__.py
index 6503ac30b4..df4271ce36 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -53,7 +53,10 @@ def int_or_str(value):
     __version__ = "99.99.99"
 
 
-VERSION = tuple(map(int_or_str, __version__.split(".")))
+try:
+    VERSION = tuple(map(int_or_str, __version__.split(".")))
+except ValueError:
+    VERSION = tuple(99, 99, 99)
 
 __all__ = [
     "AuthenticationError",

From e67d15c490585de3f350b91ee9a4e12d3ba134b7 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 5 Jan 2023 14:33:10 +0200
Subject: [PATCH 0652/1164] replase get_event_loop wite get_running_loop
 (#2530)

---
 redis/asyncio/client.py                    |  4 ++--
 redis/asyncio/connection.py                |  2 +-
 redis/asyncio/lock.py                      |  4 ++--
 tests/test_asyncio/test_connection_pool.py | 14 +++++++-------
 tests/test_asyncio/test_lock.py            |  4 ++--
 tests/test_asyncio/test_pubsub.py          | 12 ++++++------
 6 files changed, 20 insertions(+), 20 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 5a2c496661..8fd9cd2161 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -453,7 +453,7 @@ def __del__(self, _warnings: Any = warnings) -> None:
                 f"Unclosed client session {self!r}", ResourceWarning, source=self
             )
             context = {"client": self, "message": self._DEL_MESSAGE}
-            asyncio.get_event_loop().call_exception_handler(context)
+            asyncio.get_running_loop().call_exception_handler(context)
 
     async def close(self, close_connection_pool: Optional[bool] = None) -> None:
         """
@@ -798,7 +798,7 @@ async def check_health(self):
 
         if (
             conn.health_check_interval
-            and asyncio.get_event_loop().time() > conn.next_health_check
+            and asyncio.get_running_loop().time() > conn.next_health_check
         ):
             await conn.send_command(
                 "PING", self.HEALTH_CHECK_MESSAGE, check_health=False
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 4f19153318..d031f41803 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -532,7 +532,7 @@ def repr_pieces(self):
     def __del__(self):
         try:
             if self.is_connected:
-                loop = asyncio.get_event_loop()
+                loop = asyncio.get_running_loop()
                 coro = self.disconnect()
                 if loop.is_running():
                     loop.create_task(coro)
diff --git a/redis/asyncio/lock.py b/redis/asyncio/lock.py
index 2f78d69aee..e1d11a882d 100644
--- a/redis/asyncio/lock.py
+++ b/redis/asyncio/lock.py
@@ -201,14 +201,14 @@ async def acquire(
             blocking_timeout = self.blocking_timeout
         stop_trying_at = None
         if blocking_timeout is not None:
-            stop_trying_at = asyncio.get_event_loop().time() + blocking_timeout
+            stop_trying_at = asyncio.get_running_loop().time() + blocking_timeout
         while True:
             if await self.do_acquire(token):
                 self.local.token = token
                 return True
             if not blocking:
                 return False
-            next_try_at = asyncio.get_event_loop().time() + sleep
+            next_try_at = asyncio.get_running_loop().time() + sleep
             if stop_trying_at is not None and next_try_at > stop_trying_at:
                 return False
             await asyncio.sleep(sleep)
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
index 5de25f265b..d1e52bd2a3 100644
--- a/tests/test_asyncio/test_connection_pool.py
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -243,11 +243,11 @@ async def test_connection_pool_blocks_until_timeout(self, master_host):
         ) as pool:
             c1 = await pool.get_connection("_")
 
-            start = asyncio.get_event_loop().time()
+            start = asyncio.get_running_loop().time()
             with pytest.raises(redis.ConnectionError):
                 await pool.get_connection("_")
             # we should have waited at least 0.1 seconds
-            assert asyncio.get_event_loop().time() - start >= 0.1
+            assert asyncio.get_running_loop().time() - start >= 0.1
             await c1.disconnect()
 
     async def test_connection_pool_blocks_until_conn_available(self, master_host):
@@ -265,9 +265,9 @@ async def target():
                 await asyncio.sleep(0.1)
                 await pool.release(c1)
 
-            start = asyncio.get_event_loop().time()
+            start = asyncio.get_running_loop().time()
             await asyncio.gather(target(), pool.get_connection("_"))
-            assert asyncio.get_event_loop().time() - start >= 0.1
+            assert asyncio.get_running_loop().time() - start >= 0.1
 
     async def test_reuse_previously_released_connection(self, master_host):
         connection_kwargs = {"host": master_host}
@@ -668,12 +668,12 @@ async def r(self, create_redis):
         await redis.flushall()
 
     def assert_interval_advanced(self, connection):
-        diff = connection.next_health_check - asyncio.get_event_loop().time()
+        diff = connection.next_health_check - asyncio.get_running_loop().time()
         assert self.interval >= diff > (self.interval - 1)
 
     async def test_health_check_runs(self, r):
         if r.connection:
-            r.connection.next_health_check = asyncio.get_event_loop().time() - 1
+            r.connection.next_health_check = asyncio.get_running_loop().time() - 1
             await r.connection.check_health()
             self.assert_interval_advanced(r.connection)
 
@@ -681,7 +681,7 @@ async def test_arbitrary_command_invokes_health_check(self, r):
         # invoke a command to make sure the connection is entirely setup
         if r.connection:
             await r.get("foo")
-            r.connection.next_health_check = asyncio.get_event_loop().time()
+            r.connection.next_health_check = asyncio.get_running_loop().time()
             with mock.patch.object(
                 r.connection, "send_command", wraps=r.connection.send_command
             ) as m:
diff --git a/tests/test_asyncio/test_lock.py b/tests/test_asyncio/test_lock.py
index 15c3ec5162..d78f74164d 100644
--- a/tests/test_asyncio/test_lock.py
+++ b/tests/test_asyncio/test_lock.py
@@ -136,11 +136,11 @@ async def test_high_sleep_small_blocking_timeout(self, r):
         sleep = 60
         bt = 1
         lock2 = self.get_lock(r, "foo", sleep=sleep, blocking_timeout=bt)
-        start = asyncio.get_event_loop().time()
+        start = asyncio.get_running_loop().time()
         assert not await lock2.acquire()
         # the elapsed timed is less than the blocking_timeout as the lock is
         # unattainable given the sleep/blocking_timeout configuration
-        assert bt > (asyncio.get_event_loop().time() - start)
+        assert bt > (asyncio.get_running_loop().time() - start)
         await lock1.release()
 
     async def test_releasing_unlocked_lock_raises_error(self, r):
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index 37b7206720..c2a9130e83 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -30,7 +30,7 @@ async def run(*args, **kwargs):
 
 
 async def wait_for_message(pubsub, timeout=0.2, ignore_subscribe_messages=False):
-    now = asyncio.get_event_loop().time()
+    now = asyncio.get_running_loop().time()
     timeout = now + timeout
     while now < timeout:
         message = await pubsub.get_message(
@@ -39,7 +39,7 @@ async def wait_for_message(pubsub, timeout=0.2, ignore_subscribe_messages=False)
         if message is not None:
             return message
         await asyncio.sleep(0.01)
-        now = asyncio.get_event_loop().time()
+        now = asyncio.get_running_loop().time()
     return None
 
 
@@ -675,7 +675,7 @@ async def loop_step():
                 await messages.put(message)
                 break
 
-        task = asyncio.get_event_loop().create_task(loop())
+        task = asyncio.get_running_loop().create_task(loop())
         # get the initial connect message
         async with async_timeout.timeout(1):
             message = await messages.get()
@@ -724,7 +724,7 @@ def callback(message):
         messages = asyncio.Queue()
         p = pubsub
         await self._subscribe(p, foo=callback)
-        task = asyncio.get_event_loop().create_task(p.run())
+        task = asyncio.get_running_loop().create_task(p.run())
         await r.publish("foo", "bar")
         message = await messages.get()
         task.cancel()
@@ -748,7 +748,7 @@ def exception_handler_callback(e, pubsub) -> None:
         p = pubsub
         await self._subscribe(p, foo=lambda x: None)
         with mock.patch.object(p, "get_message", side_effect=Exception("error")):
-            task = asyncio.get_event_loop().create_task(
+            task = asyncio.get_running_loop().create_task(
                 p.run(exception_handler=exception_handler_callback)
             )
             e = await exceptions.get()
@@ -765,7 +765,7 @@ def callback(message):
 
         messages = asyncio.Queue()
         p = pubsub
-        task = asyncio.get_event_loop().create_task(p.run())
+        task = asyncio.get_running_loop().create_task(p.run())
         # wait until loop gets settled.  Add a subscription
         await asyncio.sleep(0.1)
         await p.subscribe(foo=callback)

From 8401da88d8614d38f2546e46964da6785851cded Mon Sep 17 00:00:00 2001
From: shacharPash <93581407+shacharPash@users.noreply.github.com>
Date: Thu, 5 Jan 2023 14:33:29 +0200
Subject: [PATCH 0653/1164] add str support for set ex parameter (#2529)

---
 redis/commands/core.py | 2 ++
 tests/test_commands.py | 7 +++++++
 2 files changed, 9 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index e3a758d5fd..3278c571f9 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -2265,6 +2265,8 @@ def set(
                 pieces.append(int(ex.total_seconds()))
             elif isinstance(ex, int):
                 pieces.append(ex)
+            elif isinstance(ex, str) and ex.isdigit():
+                pieces.append(int(ex))
             else:
                 raise DataError("ex must be datetime.timedelta or int")
         if px is not None:
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 36d004c98f..94249e9419 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1600,6 +1600,13 @@ def test_set_ex(self, r):
         with pytest.raises(exceptions.DataError):
             assert r.set("a", "1", ex=10.0)
 
+    @skip_if_server_version_lt("2.6.0")
+    def test_set_ex_str(self, r):
+        assert r.set("a", "1", ex="10")
+        assert 0 < r.ttl("a") <= 10
+        with pytest.raises(exceptions.DataError):
+            assert r.set("a", "1", ex="10.5")
+
     @skip_if_server_version_lt("2.6.0")
     def test_set_ex_timedelta(self, r):
         expire_at = datetime.timedelta(seconds=60)

From a94772848db87bfc2c3cee20d8ca8b257fc37466 Mon Sep 17 00:00:00 2001
From: Mohsin Haider <13412236+mohsinhaider@users.noreply.github.com>
Date: Thu, 5 Jan 2023 06:40:13 -0600
Subject: [PATCH 0654/1164] Fix incorrect _disconnect_raise docstring (#2534)

---
 redis/asyncio/client.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 8fd9cd2161..e56fd022fc 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -483,8 +483,8 @@ async def _send_command_parse_response(self, conn, command_name, *args, **option
     async def _disconnect_raise(self, conn: Connection, error: Exception):
         """
         Close the connection and raise an exception
-        if retry_on_timeout is not set or the error
-        is not a TimeoutError
+        if retry_on_error is not set or the error
+        is not one of the specified error types
         """
         await conn.disconnect()
         if (

From a9ef0c5d0080bd14e2f189d7f31d83e758346a8d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Thu, 5 Jan 2023 12:42:37 +0000
Subject: [PATCH 0655/1164] Make PythonParser resumable (#2510)

* PythonParser is now resumable if _stream IO is interrupted

* Add test for parse resumability

* Clear PythonParser state when connection or parsing errors occur.

* disable test for cluster mode.

* Perform "closed" check in a single place.

* Update tests

* Simplify code.

* Remove reduntant test, EOF is detected inside _readline()

* Make syncronous PythonParser restartable on error, same as HiredisParser

Fix sync PythonParser

* Add CHANGES

* isort

* Move MockStream and MockSocket into their own files
---
 CHANGES                               |  1 +
 redis/asyncio/connection.py           | 69 ++++++++++++++++++++-------
 redis/connection.py                   | 58 +++++++++++++++-------
 tests/mocks.py                        | 41 ++++++++++++++++
 tests/test_asyncio/mocks.py           | 51 ++++++++++++++++++++
 tests/test_asyncio/test_connection.py | 48 ++++++++++++++++---
 tests/test_connection.py              | 43 ++++++++++++++++-
 7 files changed, 269 insertions(+), 42 deletions(-)
 create mode 100644 tests/mocks.py
 create mode 100644 tests/test_asyncio/mocks.py

diff --git a/CHANGES b/CHANGES
index 228910f9b8..fca8d3168e 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Make PythonParser resumable in case of error (#2510)
     * Add `timeout=None` in `SentinelConnectionManager.read_response`
     * Documentation fix: password protected socket connection (#2374)
     * Allow `timeout=None` in `PubSub.get_message()` to wait forever
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index d031f41803..2c75d4fcf1 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -208,11 +208,18 @@ async def read_response(
 class PythonParser(BaseParser):
     """Plain Python parsing class"""
 
-    __slots__ = BaseParser.__slots__ + ("encoder",)
+    __slots__ = BaseParser.__slots__ + ("encoder", "_buffer", "_pos", "_chunks")
 
     def __init__(self, socket_read_size: int):
         super().__init__(socket_read_size)
         self.encoder: Optional[Encoder] = None
+        self._buffer = b""
+        self._chunks = []
+        self._pos = 0
+
+    def _clear(self):
+        self._buffer = b""
+        self._chunks.clear()
 
     def on_connect(self, connection: "Connection"):
         """Called when the stream connects"""
@@ -227,8 +234,11 @@ def on_disconnect(self):
         if self._stream is not None:
             self._stream = None
         self.encoder = None
+        self._clear()
 
     async def can_read_destructive(self) -> bool:
+        if self._buffer:
+            return True
         if self._stream is None:
             raise RedisError("Buffer is closed.")
         try:
@@ -237,14 +247,23 @@ async def can_read_destructive(self) -> bool:
         except asyncio.TimeoutError:
             return False
 
-    async def read_response(
+    async def read_response(self, disable_decoding: bool = False):
+        if self._chunks:
+            # augment parsing buffer with previously read data
+            self._buffer += b"".join(self._chunks)
+            self._chunks.clear()
+        self._pos = 0
+        response = await self._read_response(disable_decoding=disable_decoding)
+        # Successfully parsing a response allows us to clear our parsing buffer
+        self._clear()
+        return response
+
+    async def _read_response(
         self, disable_decoding: bool = False
     ) -> Union[EncodableT, ResponseError, None]:
         if not self._stream or not self.encoder:
             raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
         raw = await self._readline()
-        if not raw:
-            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
         response: Any
         byte, response = raw[:1], raw[1:]
 
@@ -258,6 +277,7 @@ async def read_response(
             # if the error is a ConnectionError, raise immediately so the user
             # is notified
             if isinstance(error, ConnectionError):
+                self._clear()  # Successful parse
                 raise error
             # otherwise, we're dealing with a ResponseError that might belong
             # inside a pipeline response. the connection's read_response()
@@ -282,7 +302,7 @@ async def read_response(
             if length == -1:
                 return None
             response = [
-                (await self.read_response(disable_decoding)) for _ in range(length)
+                (await self._read_response(disable_decoding)) for _ in range(length)
             ]
         if isinstance(response, bytes) and disable_decoding is False:
             response = self.encoder.decode(response)
@@ -293,25 +313,38 @@ async def _read(self, length: int) -> bytes:
         Read `length` bytes of data.  These are assumed to be followed
         by a '\r\n' terminator which is subsequently discarded.
         """
-        if self._stream is None:
-            raise RedisError("Buffer is closed.")
-        try:
-            data = await self._stream.readexactly(length + 2)
-        except asyncio.IncompleteReadError as error:
-            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR) from error
-        return data[:-2]
+        want = length + 2
+        end = self._pos + want
+        if len(self._buffer) >= end:
+            result = self._buffer[self._pos : end - 2]
+        else:
+            tail = self._buffer[self._pos :]
+            try:
+                data = await self._stream.readexactly(want - len(tail))
+            except asyncio.IncompleteReadError as error:
+                raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR) from error
+            result = (tail + data)[:-2]
+            self._chunks.append(data)
+        self._pos += want
+        return result
 
     async def _readline(self) -> bytes:
         """
         read an unknown number of bytes up to the next '\r\n'
         line separator, which is discarded.
         """
-        if self._stream is None:
-            raise RedisError("Buffer is closed.")
-        data = await self._stream.readline()
-        if not data.endswith(b"\r\n"):
-            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
-        return data[:-2]
+        found = self._buffer.find(b"\r\n", self._pos)
+        if found >= 0:
+            result = self._buffer[self._pos : found]
+        else:
+            tail = self._buffer[self._pos :]
+            data = await self._stream.readline()
+            if not data.endswith(b"\r\n"):
+                raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
+            result = (tail + data)[:-2]
+            self._chunks.append(data)
+        self._pos += len(result) + 2
+        return result
 
 
 class HiredisParser(BaseParser):
diff --git a/redis/connection.py b/redis/connection.py
index b810fc5714..126ea5db32 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -232,12 +232,6 @@ def read(self, length):
         self._buffer.seek(self.bytes_read)
         data = self._buffer.read(length)
         self.bytes_read += len(data)
-
-        # purge the buffer when we've consumed it all so it doesn't
-        # grow forever
-        if self.bytes_read == self.bytes_written:
-            self.purge()
-
         return data[:-2]
 
     def readline(self):
@@ -251,23 +245,44 @@ def readline(self):
             data = buf.readline()
 
         self.bytes_read += len(data)
+        return data[:-2]
 
-        # purge the buffer when we've consumed it all so it doesn't
-        # grow forever
-        if self.bytes_read == self.bytes_written:
-            self.purge()
+    def get_pos(self):
+        """
+        Get current read position
+        """
+        return self.bytes_read
 
-        return data[:-2]
+    def rewind(self, pos):
+        """
+        Rewind the buffer to a specific position, to re-start reading
+        """
+        self.bytes_read = pos
 
     def purge(self):
-        self._buffer.seek(0)
-        self._buffer.truncate()
-        self.bytes_written = 0
+        """
+        After a successful read, purge the read part of buffer
+        """
+        unread = self.bytes_written - self.bytes_read
+
+        # Only if we have read all of the buffer do we truncate, to
+        # reduce the amount of memory thrashing.  This heuristic
+        # can be changed or removed later.
+        if unread > 0:
+            return
+
+        if unread > 0:
+            # move unread data to the front
+            view = self._buffer.getbuffer()
+            view[:unread] = view[-unread:]
+        self._buffer.truncate(unread)
+        self.bytes_written = unread
         self.bytes_read = 0
+        self._buffer.seek(0)
 
     def close(self):
         try:
-            self.purge()
+            self.bytes_written = self.bytes_read = 0
             self._buffer.close()
         except Exception:
             # issue #633 suggests the purge/close somehow raised a
@@ -315,6 +330,17 @@ def can_read(self, timeout):
         return self._buffer and self._buffer.can_read(timeout)
 
     def read_response(self, disable_decoding=False):
+        pos = self._buffer.get_pos()
+        try:
+            result = self._read_response(disable_decoding=disable_decoding)
+        except BaseException:
+            self._buffer.rewind(pos)
+            raise
+        else:
+            self._buffer.purge()
+            return result
+
+    def _read_response(self, disable_decoding=False):
         raw = self._buffer.readline()
         if not raw:
             raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
@@ -355,7 +381,7 @@ def read_response(self, disable_decoding=False):
             if length == -1:
                 return None
             response = [
-                self.read_response(disable_decoding=disable_decoding)
+                self._read_response(disable_decoding=disable_decoding)
                 for i in range(length)
             ]
         if isinstance(response, bytes) and disable_decoding is False:
diff --git a/tests/mocks.py b/tests/mocks.py
new file mode 100644
index 0000000000..d7d450ee86
--- /dev/null
+++ b/tests/mocks.py
@@ -0,0 +1,41 @@
+# Various mocks for testing
+
+
+class MockSocket:
+    """
+    A class simulating an readable socket, optionally raising a
+    special exception every other read.
+    """
+
+    class TestError(BaseException):
+        pass
+
+    def __init__(self, data, interrupt_every=0):
+        self.data = data
+        self.counter = 0
+        self.pos = 0
+        self.interrupt_every = interrupt_every
+
+    def tick(self):
+        self.counter += 1
+        if not self.interrupt_every:
+            return
+        if (self.counter % self.interrupt_every) == 0:
+            raise self.TestError()
+
+    def recv(self, bufsize):
+        self.tick()
+        bufsize = min(5, bufsize)  # truncate the read size
+        result = self.data[self.pos : self.pos + bufsize]
+        self.pos += len(result)
+        return result
+
+    def recv_into(self, buffer, nbytes=0, flags=0):
+        self.tick()
+        if nbytes == 0:
+            nbytes = len(buffer)
+        nbytes = min(5, nbytes)  # truncate the read size
+        result = self.data[self.pos : self.pos + nbytes]
+        self.pos += len(result)
+        buffer[: len(result)] = result
+        return len(result)
diff --git a/tests/test_asyncio/mocks.py b/tests/test_asyncio/mocks.py
new file mode 100644
index 0000000000..89bd9c0ac4
--- /dev/null
+++ b/tests/test_asyncio/mocks.py
@@ -0,0 +1,51 @@
+import asyncio
+
+# Helper Mocking classes for the tests.
+
+
+class MockStream:
+    """
+    A class simulating an asyncio input buffer, optionally raising a
+    special exception every other read.
+    """
+
+    class TestError(BaseException):
+        pass
+
+    def __init__(self, data, interrupt_every=0):
+        self.data = data
+        self.counter = 0
+        self.pos = 0
+        self.interrupt_every = interrupt_every
+
+    def tick(self):
+        self.counter += 1
+        if not self.interrupt_every:
+            return
+        if (self.counter % self.interrupt_every) == 0:
+            raise self.TestError()
+
+    async def read(self, want):
+        self.tick()
+        want = 5
+        result = self.data[self.pos : self.pos + want]
+        self.pos += len(result)
+        return result
+
+    async def readline(self):
+        self.tick()
+        find = self.data.find(b"\n", self.pos)
+        if find >= 0:
+            result = self.data[self.pos : find + 1]
+        else:
+            result = self.data[self.pos :]
+        self.pos += len(result)
+        return result
+
+    async def readexactly(self, length):
+        self.tick()
+        result = self.data[self.pos : self.pos + length]
+        if len(result) < length:
+            raise asyncio.IncompleteReadError(result, None)
+        self.pos += len(result)
+        return result
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index 6bf0034146..bf59dbe6b0 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -5,7 +5,9 @@
 
 import pytest
 
+import redis
 from redis.asyncio.connection import (
+    BaseParser,
     Connection,
     PythonParser,
     UnixDomainSocketConnection,
@@ -16,6 +18,7 @@
 from tests.conftest import skip_if_server_version_lt
 
 from .compat import mock
+from .mocks import MockStream
 
 
 @pytest.mark.onlynoncluster
@@ -23,16 +26,19 @@ async def test_invalid_response(create_redis):
     r = await create_redis(single_connection_client=True)
 
     raw = b"x"
+    fake_stream = MockStream(raw + b"\r\n")
 
-    parser: "PythonParser" = r.connection._parser
-    if not isinstance(parser, PythonParser):
-        pytest.skip("PythonParser only")
-    stream_mock = mock.Mock(parser._stream)
-    stream_mock.readline.return_value = raw + b"\r\n"
-    with mock.patch.object(parser, "_stream", stream_mock):
+    parser: BaseParser = r.connection._parser
+    with mock.patch.object(parser, "_stream", fake_stream):
         with pytest.raises(InvalidResponse) as cm:
             await parser.read_response()
-    assert str(cm.value) == f"Protocol Error: {raw!r}"
+    if isinstance(parser, PythonParser):
+        assert str(cm.value) == f"Protocol Error: {raw!r}"
+    else:
+        assert (
+            str(cm.value) == f'Protocol error, got "{raw.decode()}" as reply type byte'
+        )
+    await r.connection.disconnect()
 
 
 @skip_if_server_version_lt("4.0.0")
@@ -112,3 +118,31 @@ async def test_connect_timeout_error_without_retry():
         await conn.connect()
     assert conn._connect.call_count == 1
     assert str(e.value) == "Timeout connecting to server"
+
+
+@pytest.mark.onlynoncluster
+async def test_connection_parse_response_resume(r: redis.Redis):
+    """
+    This test verifies that the Connection parser,
+    be that PythonParser or HiredisParser,
+    can be interrupted at IO time and then resume parsing.
+    """
+    conn = Connection(**r.connection_pool.connection_kwargs)
+    await conn.connect()
+    message = (
+        b"*3\r\n$7\r\nmessage\r\n$8\r\nchannel1\r\n"
+        b"$25\r\nhi\r\nthere\r\n+how\r\nare\r\nyou\r\n"
+    )
+
+    conn._parser._stream = MockStream(message, interrupt_every=2)
+    for i in range(100):
+        try:
+            response = await conn.read_response()
+            break
+        except MockStream.TestError:
+            pass
+
+    else:
+        pytest.fail("didn't receive a response")
+    assert response
+    assert i > 0
diff --git a/tests/test_connection.py b/tests/test_connection.py
index d9251c31dc..e0b53cdf37 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -5,13 +5,15 @@
 
 import pytest
 
+import redis
 from redis.backoff import NoBackoff
-from redis.connection import Connection
+from redis.connection import Connection, HiredisParser, PythonParser
 from redis.exceptions import ConnectionError, InvalidResponse, TimeoutError
 from redis.retry import Retry
 from redis.utils import HIREDIS_AVAILABLE
 
 from .conftest import skip_if_server_version_lt
+from .mocks import MockSocket
 
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
@@ -122,3 +124,42 @@ def test_connect_timeout_error_without_retry(self):
         assert conn._connect.call_count == 1
         assert str(e.value) == "Timeout connecting to server"
         self.clear(conn)
+
+
+@pytest.mark.onlynoncluster
+@pytest.mark.parametrize(
+    "parser_class", [PythonParser, HiredisParser], ids=["PythonParser", "HiredisParser"]
+)
+def test_connection_parse_response_resume(r: redis.Redis, parser_class):
+    """
+    This test verifies that the Connection parser,
+    be that PythonParser or HiredisParser,
+    can be interrupted at IO time and then resume parsing.
+    """
+    if parser_class is HiredisParser and not HIREDIS_AVAILABLE:
+        pytest.skip("Hiredis not available)")
+    args = dict(r.connection_pool.connection_kwargs)
+    args["parser_class"] = parser_class
+    conn = Connection(**args)
+    conn.connect()
+    message = (
+        b"*3\r\n$7\r\nmessage\r\n$8\r\nchannel1\r\n"
+        b"$25\r\nhi\r\nthere\r\n+how\r\nare\r\nyou\r\n"
+    )
+    mock_socket = MockSocket(message, interrupt_every=2)
+
+    if isinstance(conn._parser, PythonParser):
+        conn._parser._buffer._sock = mock_socket
+    else:
+        conn._parser._sock = mock_socket
+    for i in range(100):
+        try:
+            response = conn.read_response()
+            break
+        except MockSocket.TestError:
+            pass
+
+    else:
+        pytest.fail("didn't receive a response")
+    assert response
+    assert i > 0

From decd1f6ae5434b111c5b125263549d8743275e51 Mon Sep 17 00:00:00 2001
From: SessionIssue <118734962+SessionIssue@users.noreply.github.com>
Date: Sun, 8 Jan 2023 09:41:58 +0100
Subject: [PATCH 0656/1164] ValueError must be AttributeError in __init__.py
 (#2542)

* Revert "Update __init__ for issue 2215 (#2539)"

This reverts commit f14ed1fc822a88a21bbfc64e36bf8b09e5c9386c.

* Update __init__.py

ValueError must be AttributeError ofc.
---
 redis/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/__init__.py b/redis/__init__.py
index df4271ce36..3ab697065e 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -55,7 +55,7 @@ def int_or_str(value):
 
 try:
     VERSION = tuple(map(int_or_str, __version__.split(".")))
-except ValueError:
+except AttributeError:
     VERSION = tuple(99, 99, 99)
 
 __all__ = [

From c7600b4c7e558d3c05485f76cfcdd3e807c6b13e Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 8 Jan 2023 10:42:19 +0200
Subject: [PATCH 0657/1164] add type checking for graph __eq__ (#2531)

---
 redis/commands/graph/edge.py | 4 ++++
 redis/commands/graph/node.py | 4 ++++
 redis/commands/graph/path.py | 4 ++++
 3 files changed, 12 insertions(+)

diff --git a/redis/commands/graph/edge.py b/redis/commands/graph/edge.py
index b0141d9452..6ee195f1f5 100644
--- a/redis/commands/graph/edge.py
+++ b/redis/commands/graph/edge.py
@@ -61,6 +61,10 @@ def __str__(self):
         return res
 
     def __eq__(self, rhs):
+        # Type checking
+        if not isinstance(rhs, Edge):
+            return False
+
         # Quick positive check, if both IDs are set.
         if self.id is not None and rhs.id is not None and self.id == rhs.id:
             return True
diff --git a/redis/commands/graph/node.py b/redis/commands/graph/node.py
index 0ebe510ada..4546a393b1 100644
--- a/redis/commands/graph/node.py
+++ b/redis/commands/graph/node.py
@@ -65,6 +65,10 @@ def __str__(self):
         return res
 
     def __eq__(self, rhs):
+        # Type checking
+        if not isinstance(rhs, Node):
+            return False
+
         # Quick positive check, if both IDs are set.
         if self.id is not None and rhs.id is not None and self.id != rhs.id:
             return False
diff --git a/redis/commands/graph/path.py b/redis/commands/graph/path.py
index 6f2214a3b5..ee22dc8c6b 100644
--- a/redis/commands/graph/path.py
+++ b/redis/commands/graph/path.py
@@ -54,6 +54,10 @@ def add_edge(self, edge):
         return self
 
     def __eq__(self, other):
+        # Type checking
+        if not isinstance(other, Path):
+            return False
+
         return self.nodes() == other.nodes() and self.edges() == other.edges()
 
     def __str__(self):

From f46d7f3ef7ce64f90acd4a3dcc14375ab9ae9c9d Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 8 Jan 2023 11:41:31 +0200
Subject: [PATCH 0658/1164] Version 4.4.1 (#2544)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 9cf0dcff26..a702c9afb4 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.4.0",
+    version="4.4.1",
     packages=find_packages(
         include=[
             "redis",

From 4a825bc76b668951923c57aaff1020c3892f8de2 Mon Sep 17 00:00:00 2001
From: Jan <59206115+Threated@users.noreply.github.com>
Date: Wed, 11 Jan 2023 10:19:29 +0100
Subject: [PATCH 0659/1164] String cleanse (#2548)

* Fixed string escape and added tests

* Add Change

* Name change
---
 CHANGES                   | 1 +
 redis/commands/helpers.py | 1 +
 tests/test_graph.py       | 2 +-
 tests/test_helpers.py     | 6 ++++++
 4 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/CHANGES b/CHANGES
index fca8d3168e..02daf5ee4c 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Fix string cleanse in Redis Graph
     * Make PythonParser resumable in case of error (#2510)
     * Add `timeout=None` in `SentinelConnectionManager.read_response`
     * Documentation fix: password protected socket connection (#2374)
diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
index 6989ab59fa..b65cd1a933 100644
--- a/redis/commands/helpers.py
+++ b/redis/commands/helpers.py
@@ -115,6 +115,7 @@ def quote_string(v):
     if len(v) == 0:
         return '""'
 
+    v = v.replace("\\", "\\\\")
     v = v.replace('"', '\\"')
 
     return f'"{v}"'
diff --git a/tests/test_graph.py b/tests/test_graph.py
index d71df48688..4721b2f4e2 100644
--- a/tests/test_graph.py
+++ b/tests/test_graph.py
@@ -124,7 +124,7 @@ def test_path(client):
 
 @pytest.mark.redismod
 def test_param(client):
-    params = [1, 2.3, "str", True, False, None, [0, 1, 2]]
+    params = [1, 2.3, "str", True, False, None, [0, 1, 2], r"\" RETURN 1337 //"]
     query = "RETURN $param"
     for param in params:
         result = client.graph().query(query, {"param": param})
diff --git a/tests/test_helpers.py b/tests/test_helpers.py
index 359582909f..57a94d2f45 100644
--- a/tests/test_helpers.py
+++ b/tests/test_helpers.py
@@ -80,3 +80,9 @@ def test_quote_string():
     assert quote_string("hello world!") == '"hello world!"'
     assert quote_string("") == '""'
     assert quote_string("hello world!") == '"hello world!"'
+    assert quote_string("abc") == '"abc"'
+    assert quote_string("") == '""'
+    assert quote_string('"') == r'"\""'
+    assert quote_string(r"foo \ bar") == r'"foo \\ bar"'
+    assert quote_string(r"foo \" bar") == r'"foo \\\" bar"'
+    assert quote_string('a"a') == r'"a\"a"'

From bae6385c1b0097a1d85c7825604170477d193481 Mon Sep 17 00:00:00 2001
From: Dongkeun Lee <3315213+zakaf@users.noreply.github.com>
Date: Wed, 11 Jan 2023 18:29:11 +0900
Subject: [PATCH 0660/1164] allow replica to master promotion in nodes_cache
 (#2549)

Co-authored-by: zach.lee <zach.lee@sendbird.com>
---
 redis/cluster.py      |  2 ++
 tests/test_cluster.py | 51 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 53 insertions(+)

diff --git a/redis/cluster.py b/redis/cluster.py
index f1150073a9..235d8f2dc3 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -1437,6 +1437,8 @@ def _get_or_create_cluster_node(self, host, port, role, tmp_nodes_cache):
             if target_node is None or target_node.redis_connection is None:
                 # create new cluster node for this cluster
                 target_node = ClusterNode(host, port, role)
+            if target_node.server_type != role:
+                target_node.server_type = role
 
         return target_node
 
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 27cfee1c6f..55b660c7c5 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -2262,6 +2262,57 @@ def test_init_slots_cache(self):
 
         assert len(n_manager.nodes_cache) == 6
 
+    def test_init_promote_server_type_for_node_in_cache(self):
+        """
+        When replica is promoted to master, nodes_cache must change the server type
+        accordingly
+        """
+        cluster_slots_before_promotion = [
+            [0, 16383, ["127.0.0.1", 7000], ["127.0.0.1", 7003]]
+        ]
+        cluster_slots_after_promotion = [
+            [0, 16383, ["127.0.0.1", 7003], ["127.0.0.1", 7004]]
+        ]
+
+        cluster_slots_results = [
+            cluster_slots_before_promotion,
+            cluster_slots_after_promotion,
+        ]
+
+        with patch.object(Redis, "execute_command") as execute_command_mock:
+
+            def execute_command(*_args, **_kwargs):
+                if _args[0] == "CLUSTER SLOTS":
+                    mock_cluster_slots = cluster_slots_results.pop(0)
+                    return mock_cluster_slots
+                elif _args[0] == "COMMAND":
+                    return {"get": [], "set": []}
+                elif _args[0] == "INFO":
+                    return {"cluster_enabled": True}
+                elif len(_args) > 1 and _args[1] == "cluster-require-full-coverage":
+                    return {"cluster-require-full-coverage": False}
+                else:
+                    return execute_command_mock(*_args, **_kwargs)
+
+            execute_command_mock.side_effect = execute_command
+
+            nm = NodesManager(
+                startup_nodes=[ClusterNode(host=default_host, port=default_port)],
+                from_url=False,
+                require_full_coverage=False,
+                dynamic_startup_nodes=True,
+            )
+
+            assert nm.default_node.host == "127.0.0.1"
+            assert nm.default_node.port == 7000
+            assert nm.default_node.server_type == PRIMARY
+
+            nm.initialize()
+
+            assert nm.default_node.host == "127.0.0.1"
+            assert nm.default_node.port == 7003
+            assert nm.default_node.server_type == PRIMARY
+
     def test_init_slots_cache_cluster_mode_disabled(self):
         """
         Test that creating a RedisCluster failes if one of the startup nodes

From 7dd73a306add608807c372a98d833b7cb3394681 Mon Sep 17 00:00:00 2001
From: Dongkeun Lee <3315213+zakaf@users.noreply.github.com>
Date: Wed, 11 Jan 2023 18:55:45 +0900
Subject: [PATCH 0661/1164] add support for custom connection pool class in
 NodesManager (#2547)

Co-authored-by: zach.lee <zach.lee@sendbird.com>
---
 redis/cluster.py      |  5 ++++-
 tests/test_cluster.py | 17 ++++++++++++++++-
 2 files changed, 20 insertions(+), 2 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index 235d8f2dc3..5f730a8596 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -121,6 +121,7 @@ def parse_cluster_shards(resp, **options):
     "charset",
     "connection_class",
     "connection_pool",
+    "connection_pool_class",
     "client_name",
     "credential_provider",
     "db",
@@ -1267,6 +1268,7 @@ def __init__(
         require_full_coverage=False,
         lock=None,
         dynamic_startup_nodes=True,
+        connection_pool_class=ConnectionPool,
         **kwargs,
     ):
         self.nodes_cache = {}
@@ -1277,6 +1279,7 @@ def __init__(
         self.from_url = from_url
         self._require_full_coverage = require_full_coverage
         self._dynamic_startup_nodes = dynamic_startup_nodes
+        self.connection_pool_class = connection_pool_class
         self._moved_exception = None
         self.connection_kwargs = kwargs
         self.read_load_balancer = LoadBalancer()
@@ -1420,7 +1423,7 @@ def create_redis_node(self, host, port, **kwargs):
             # Create a redis node with a costumed connection pool
             kwargs.update({"host": host})
             kwargs.update({"port": port})
-            r = Redis(connection_pool=ConnectionPool(**kwargs))
+            r = Redis(connection_pool=self.connection_pool_class(**kwargs))
         else:
             r = Redis(host=host, port=port, **kwargs)
         return r
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 55b660c7c5..da6a8e4bf7 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -18,7 +18,7 @@
     get_node_name,
 )
 from redis.commands import CommandsParser
-from redis.connection import Connection
+from redis.connection import BlockingConnectionPool, Connection, ConnectionPool
 from redis.crc import key_slot
 from redis.exceptions import (
     AskError,
@@ -2496,6 +2496,21 @@ def test_init_slots_dynamic_startup_nodes(self, dynamic_startup_nodes):
         else:
             assert startup_nodes == ["my@DNS.com:7000"]
 
+    @pytest.mark.parametrize(
+        "connection_pool_class", [ConnectionPool, BlockingConnectionPool]
+    )
+    def test_connection_pool_class(self, connection_pool_class):
+        rc = get_mocked_redis_client(
+            url="redis://my@DNS.com:7000",
+            cluster_slots=default_cluster_slots,
+            connection_pool_class=connection_pool_class,
+        )
+
+        for node in rc.nodes_manager.nodes_cache.values():
+            assert isinstance(
+                node.redis_connection.connection_pool, connection_pool_class
+            )
+
 
 @pytest.mark.onlycluster
 class TestClusterPubSubObject:

From be84b930266932bc81fd5390e6963621ef0b97da Mon Sep 17 00:00:00 2001
From: shacharPash <93581407+shacharPash@users.noreply.github.com>
Date: Wed, 11 Jan 2023 12:57:56 +0200
Subject: [PATCH 0662/1164] Add support to BF.CARD (#2545)

* Add support to BF.CARD

* Add Async test

* change to with pytest.raises
---
 redis/commands/bf/__init__.py    |  1 +
 redis/commands/bf/commands.py    |  9 +++++++++
 tests/test_asyncio/test_bloom.py | 15 +++++++++++++++
 tests/test_bloom.py              | 15 +++++++++++++++
 4 files changed, 40 insertions(+)

diff --git a/redis/commands/bf/__init__.py b/redis/commands/bf/__init__.py
index a448def46d..4da060e995 100644
--- a/redis/commands/bf/__init__.py
+++ b/redis/commands/bf/__init__.py
@@ -198,6 +198,7 @@ def __init__(self, client, **kwargs):
             # BF_MEXISTS: spaceHolder,
             # BF_SCANDUMP: spaceHolder,
             # BF_LOADCHUNK: spaceHolder,
+            # BF_CARD: spaceHolder,
             BF_INFO: BFInfo,
         }
 
diff --git a/redis/commands/bf/commands.py b/redis/commands/bf/commands.py
index f6bf281639..c45523c99b 100644
--- a/redis/commands/bf/commands.py
+++ b/redis/commands/bf/commands.py
@@ -11,6 +11,7 @@
 BF_SCANDUMP = "BF.SCANDUMP"
 BF_LOADCHUNK = "BF.LOADCHUNK"
 BF_INFO = "BF.INFO"
+BF_CARD = "BF.CARD"
 
 CF_RESERVE = "CF.RESERVE"
 CF_ADD = "CF.ADD"
@@ -165,6 +166,14 @@ def info(self, key):
         """  # noqa
         return self.execute_command(BF_INFO, key)
 
+    def card(self, key):
+        """
+        Returns the cardinality of a Bloom filter - number of items that were added to a Bloom filter and detected as unique
+        (items that caused at least one bit to be set in at least one sub-filter).
+        For more information see `BF.CARD <https://redis.io/commands/bf.card>`_.
+        """  # noqa
+        return self.execute_command(BF_CARD, key)
+
 
 class CFCommands:
     """Cuckoo Filter commands."""
diff --git a/tests/test_asyncio/test_bloom.py b/tests/test_asyncio/test_bloom.py
index cac989f913..9f4a805c4c 100644
--- a/tests/test_asyncio/test_bloom.py
+++ b/tests/test_asyncio/test_bloom.py
@@ -149,6 +149,21 @@ async def test_bf_info(modclient: redis.Redis):
         assert True
 
 
+@pytest.mark.redismod
+async def test_bf_card(modclient: redis.Redis):
+    # return 0 if the key does not exist
+    assert await modclient.bf().card("not_exist") == 0
+
+    # Store a filter
+    assert await modclient.bf().add("bf1", "item_foo") == 1
+    assert await modclient.bf().card("bf1") == 1
+
+    # Error when key is of a type other than Bloom filter.
+    with pytest.raises(redis.ResponseError):
+        await modclient.set("setKey", "value")
+        await modclient.bf().card("setKey")
+
+
 # region Test Cuckoo Filter
 @pytest.mark.redismod
 async def test_cf_add_and_insert(modclient: redis.Redis):
diff --git a/tests/test_bloom.py b/tests/test_bloom.py
index 13921bfbd1..30d3219404 100644
--- a/tests/test_bloom.py
+++ b/tests/test_bloom.py
@@ -165,6 +165,21 @@ def test_bf_info(client):
         assert True
 
 
+@pytest.mark.redismod
+def test_bf_card(client):
+    # return 0 if the key does not exist
+    assert client.bf().card("not_exist") == 0
+
+    # Store a filter
+    assert client.bf().add("bf1", "item_foo") == 1
+    assert client.bf().card("bf1") == 1
+
+    # Error when key is of a type other than Bloom filter.
+    with pytest.raises(redis.ResponseError):
+        client.set("setKey", "value")
+        client.bf().card("setKey")
+
+
 # region Test Cuckoo Filter
 @pytest.mark.redismod
 def test_cf_add_and_insert(client):

From 8592cacf9e5069f8f6d392a2bc02aeade87c9d69 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 11 Jan 2023 13:59:17 +0200
Subject: [PATCH 0663/1164] version 4.4.2 (#2550)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index a702c9afb4..16a9156641 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.4.1",
+    version="4.4.2",
     packages=find_packages(
         include=[
             "redis",

From 18560b43ed759f4ace7ac16f4a3dd53ab2841969 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 19 Jan 2023 14:12:17 +0200
Subject: [PATCH 0664/1164] Change redismod docker to redis-stack-server
 (#2556)

* Change redismod docker to redis-stack-server

* redis-stack-server

* syntax

* Update tox.ini

* fetching docker from redis repo

Co-authored-by: Chayim I. Kirshen <c@kirshen.com>
---
 tox.ini | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/tox.ini b/tox.ini
index 85b3242857..553c77b3c6 100644
--- a/tox.ini
+++ b/tox.ini
@@ -92,9 +92,9 @@ healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(sock
 volumes =
     bind:rw:{toxinidir}/docker/redis6.2/sentinel/sentinel_3.conf:/sentinel.conf
 
-[docker:redismod]
-name = redismod
-image = redislabs/redismod:edge
+[docker:redis_stack]
+name = redis_stack
+image = redis/redis-stack-server:edge
 ports =
     36379:6379/tcp
 healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',36379)) else False"
@@ -279,7 +279,7 @@ docker =
     sentinel_2
     sentinel_3
     redis_cluster
-    redismod
+    redis_stack
     stunnel
 extras =
     hiredis: hiredis

From 5e258a107e4d44522a9222b4c7e8938dbe4bc43e Mon Sep 17 00:00:00 2001
From: David Pacsuta <34983281+ant1fact@users.noreply.github.com>
Date: Sun, 22 Jan 2023 19:41:38 +0100
Subject: [PATCH 0665/1164] Add missing `Union` type in method
 `StreamCommands.xclaim()` (#2553)

`Union` was missing in front of `[List[StreamIdT], Tuple[StreamIdT]]` and VSCode was producing an error because of it.
After adding `Union` the type annotation is correctly identified by VSCode.
---
 redis/commands/core.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 3278c571f9..b07f12d854 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3551,7 +3551,7 @@ def xclaim(
         groupname: GroupT,
         consumername: ConsumerT,
         min_idle_time: int,
-        message_ids: [List[StreamIdT], Tuple[StreamIdT]],
+        message_ids: Union[List[StreamIdT], Tuple[StreamIdT]],
         idle: Union[int, None] = None,
         time: Union[int, None] = None,
         retrycount: Union[int, None] = None,

From e39c7babdd80ecdd930bed9d201e8fb9187309ac Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Sun, 22 Jan 2023 18:49:12 +0000
Subject: [PATCH 0666/1164] Simplify the sync SocketBuffer, add type hints
 (#2543)

---
 CHANGES             |  1 +
 redis/connection.py | 83 ++++++++++++++++++++++++---------------------
 2 files changed, 45 insertions(+), 39 deletions(-)

diff --git a/CHANGES b/CHANGES
index 02daf5ee4c..d89079ba6f 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Simplify synchronous SocketBuffer state management
     * Fix string cleanse in Redis Graph
     * Make PythonParser resumable in case of error (#2510)
     * Add `timeout=None` in `SentinelConnectionManager.read_response`
diff --git a/redis/connection.py b/redis/connection.py
index 126ea5db32..57f0a3a81e 100755
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -5,10 +5,11 @@
 import socket
 import threading
 import weakref
+from io import SEEK_END
 from itertools import chain
 from queue import Empty, Full, LifoQueue
 from time import time
-from typing import Optional
+from typing import Optional, Union
 from urllib.parse import parse_qs, unquote, urlparse
 
 from redis.backoff import NoBackoff
@@ -163,31 +164,40 @@ def parse_error(self, response):
 
 
 class SocketBuffer:
-    def __init__(self, socket, socket_read_size, socket_timeout):
+    def __init__(
+        self, socket: socket.socket, socket_read_size: int, socket_timeout: float
+    ):
         self._sock = socket
         self.socket_read_size = socket_read_size
         self.socket_timeout = socket_timeout
         self._buffer = io.BytesIO()
-        # number of bytes written to the buffer from the socket
-        self.bytes_written = 0
-        # number of bytes read from the buffer
-        self.bytes_read = 0
 
-    @property
-    def length(self):
-        return self.bytes_written - self.bytes_read
+    def unread_bytes(self) -> int:
+        """
+        Remaining unread length of buffer
+        """
+        pos = self._buffer.tell()
+        end = self._buffer.seek(0, SEEK_END)
+        self._buffer.seek(pos)
+        return end - pos
 
-    def _read_from_socket(self, length=None, timeout=SENTINEL, raise_on_timeout=True):
+    def _read_from_socket(
+        self,
+        length: Optional[int] = None,
+        timeout: Union[float, object] = SENTINEL,
+        raise_on_timeout: Optional[bool] = True,
+    ) -> bool:
         sock = self._sock
         socket_read_size = self.socket_read_size
-        buf = self._buffer
-        buf.seek(self.bytes_written)
         marker = 0
         custom_timeout = timeout is not SENTINEL
 
+        buf = self._buffer
+        current_pos = buf.tell()
+        buf.seek(0, SEEK_END)
+        if custom_timeout:
+            sock.settimeout(timeout)
         try:
-            if custom_timeout:
-                sock.settimeout(timeout)
             while True:
                 data = self._sock.recv(socket_read_size)
                 # an empty string indicates the server shutdown the socket
@@ -195,7 +205,6 @@ def _read_from_socket(self, length=None, timeout=SENTINEL, raise_on_timeout=True
                     raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
                 buf.write(data)
                 data_length = len(data)
-                self.bytes_written += data_length
                 marker += data_length
 
                 if length is not None and length > marker:
@@ -215,55 +224,53 @@ def _read_from_socket(self, length=None, timeout=SENTINEL, raise_on_timeout=True
                 return False
             raise ConnectionError(f"Error while reading from socket: {ex.args}")
         finally:
+            buf.seek(current_pos)
             if custom_timeout:
                 sock.settimeout(self.socket_timeout)
 
-    def can_read(self, timeout):
-        return bool(self.length) or self._read_from_socket(
+    def can_read(self, timeout: float) -> bool:
+        return bool(self.unread_bytes()) or self._read_from_socket(
             timeout=timeout, raise_on_timeout=False
         )
 
-    def read(self, length):
+    def read(self, length: int) -> bytes:
         length = length + 2  # make sure to read the \r\n terminator
-        # make sure we've read enough data from the socket
-        if length > self.length:
-            self._read_from_socket(length - self.length)
-
-        self._buffer.seek(self.bytes_read)
+        # BufferIO will return less than requested if buffer is short
         data = self._buffer.read(length)
-        self.bytes_read += len(data)
+        missing = length - len(data)
+        if missing:
+            # fill up the buffer and read the remainder
+            self._read_from_socket(missing)
+            data += self._buffer.read(missing)
         return data[:-2]
 
-    def readline(self):
+    def readline(self) -> bytes:
         buf = self._buffer
-        buf.seek(self.bytes_read)
         data = buf.readline()
         while not data.endswith(SYM_CRLF):
             # there's more data in the socket that we need
             self._read_from_socket()
-            buf.seek(self.bytes_read)
-            data = buf.readline()
+            data += buf.readline()
 
-        self.bytes_read += len(data)
         return data[:-2]
 
-    def get_pos(self):
+    def get_pos(self) -> int:
         """
         Get current read position
         """
-        return self.bytes_read
+        return self._buffer.tell()
 
-    def rewind(self, pos):
+    def rewind(self, pos: int) -> None:
         """
         Rewind the buffer to a specific position, to re-start reading
         """
-        self.bytes_read = pos
+        self._buffer.seek(pos)
 
-    def purge(self):
+    def purge(self) -> None:
         """
         After a successful read, purge the read part of buffer
         """
-        unread = self.bytes_written - self.bytes_read
+        unread = self.unread_bytes()
 
         # Only if we have read all of the buffer do we truncate, to
         # reduce the amount of memory thrashing.  This heuristic
@@ -276,13 +283,10 @@ def purge(self):
             view = self._buffer.getbuffer()
             view[:unread] = view[-unread:]
         self._buffer.truncate(unread)
-        self.bytes_written = unread
-        self.bytes_read = 0
         self._buffer.seek(0)
 
-    def close(self):
+    def close(self) -> None:
         try:
-            self.bytes_written = self.bytes_read = 0
             self._buffer.close()
         except Exception:
             # issue #633 suggests the purge/close somehow raised a
@@ -498,6 +502,7 @@ def read_response(self, disable_decoding=False):
         return response
 
 
+DefaultParser: BaseParser
 if HIREDIS_AVAILABLE:
     DefaultParser = HiredisParser
 else:

From 42604b68c906a156fd64a001a83e0e84a0fa63fa Mon Sep 17 00:00:00 2001
From: Rich Bowen <rbowen@rcbowen.com>
Date: Sun, 29 Jan 2023 08:30:43 -0500
Subject: [PATCH 0667/1164] trivial typo fix (#2566)

* trivial typo fix

* trivial typo fix
---
 docs/advanced_features.rst            | 2 +-
 docs/examples/pipeline_examples.ipynb | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/advanced_features.rst b/docs/advanced_features.rst
index 4ad922fe72..5fd20c2ba2 100644
--- a/docs/advanced_features.rst
+++ b/docs/advanced_features.rst
@@ -162,7 +162,7 @@ instance will wait for all the nodes to respond before returning the
 result to the caller. Command responses are returned as a list sorted in
 the same order in which they were sent. Pipelines can be used to
 dramatically increase the throughput of Redis Cluster by significantly
-reducing the the number of network round trips between the client and
+reducing the number of network round trips between the client and
 the server.
 
 .. code:: pycon
diff --git a/docs/examples/pipeline_examples.ipynb b/docs/examples/pipeline_examples.ipynb
index 490d2213a0..4e20375bfa 100644
--- a/docs/examples/pipeline_examples.ipynb
+++ b/docs/examples/pipeline_examples.ipynb
@@ -123,7 +123,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "The responses of the three commands are stored in a list. In the above example, the two first boolean indicates that the the `set` commands were successfull and the last element of the list is the result of the `get(\"a\")` comand."
+    "The responses of the three commands are stored in a list. In the above example, the two first boolean indicates that the `set` commands were successfull and the last element of the list is the result of the `get(\"a\")` comand."
    ]
   },
   {

From 9e6a9b52e5aab021d239ca56e27f06bca871cbf0 Mon Sep 17 00:00:00 2001
From: gmbnomis <gmbnomis@users.noreply.github.com>
Date: Sun, 29 Jan 2023 14:46:42 +0100
Subject: [PATCH 0668/1164] Fix unlink in cluster pipeline (#2562)

Implement unlink() like delete() to make it work when
used in a cluster pipeline.
---
 CHANGES               |  1 +
 redis/cluster.py      | 11 +++++++++++
 tests/test_cluster.py | 19 +++++++++++++++++++
 3 files changed, 31 insertions(+)

diff --git a/CHANGES b/CHANGES
index d89079ba6f..9d82341a76 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Support `.unlink()` in ClusterPipeline
     * Simplify synchronous SocketBuffer state management
     * Fix string cleanse in Redis Graph
     * Make PythonParser resumable in case of error (#2510)
diff --git a/redis/cluster.py b/redis/cluster.py
index 5f730a8596..d6dc02d493 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -2136,6 +2136,17 @@ def delete(self, *names):
 
         return self.execute_command("DEL", names[0])
 
+    def unlink(self, *names):
+        """
+        "Unlink a key specified by ``names``"
+        """
+        if len(names) != 1:
+            raise RedisClusterException(
+                "unlinking multiple keys is not implemented in pipeline command"
+            )
+
+        return self.execute_command("UNLINK", names[0])
+
 
 def block_pipeline_command(name: str) -> Callable[..., Any]:
     """
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index da6a8e4bf7..1bf57a357c 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -2703,6 +2703,25 @@ def test_multi_delete_unsupported(self, r):
             with pytest.raises(RedisClusterException):
                 pipe.delete("a", "b")
 
+    def test_unlink_single(self, r):
+        """
+        Test a single unlink operation
+        """
+        r["a"] = 1
+        with r.pipeline(transaction=False) as pipe:
+            pipe.unlink("a")
+            assert pipe.execute() == [1]
+
+    def test_multi_unlink_unsupported(self, r):
+        """
+        Test that multi unlink operation is unsupported
+        """
+        with r.pipeline(transaction=False) as pipe:
+            r["a"] = 1
+            r["b"] = 2
+            with pytest.raises(RedisClusterException):
+                pipe.unlink("a", "b")
+
     def test_brpoplpush_disabled(self, r):
         """
         Test that brpoplpush is disabled for ClusterPipeline

From 428d60940f386d3680a413aa327889308f82c5de Mon Sep 17 00:00:00 2001
From: Vivanov98 <66319645+Vivanov98@users.noreply.github.com>
Date: Sun, 29 Jan 2023 13:48:50 +0000
Subject: [PATCH 0669/1164] Fix issue 2540: Synchronise concurrent command
 calls to single-client mode. (#2568)

Co-authored-by: Viktor Ivanov <viktor@infogrid.io>
---
 redis/asyncio/client.py               | 15 +++++++--
 tests/test_asyncio/test_connection.py | 45 +++++++++++++++++++++++++++
 2 files changed, 58 insertions(+), 2 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index e56fd022fc..3fc7fad83e 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -253,6 +253,11 @@ def __init__(
 
         self.response_callbacks = CaseInsensitiveDict(self.__class__.RESPONSE_CALLBACKS)
 
+        # If using a single connection client, we need to lock creation-of and use-of
+        # the client in order to avoid race conditions such as using asyncio.gather
+        # on a set of redis commands
+        self._single_conn_lock = asyncio.Lock()
+
     def __repr__(self):
         return f"{self.__class__.__name__}<{self.connection_pool!r}>"
 
@@ -260,8 +265,10 @@ def __await__(self):
         return self.initialize().__await__()
 
     async def initialize(self: _RedisT) -> _RedisT:
-        if self.single_connection_client and self.connection is None:
-            self.connection = await self.connection_pool.get_connection("_")
+        if self.single_connection_client:
+            async with self._single_conn_lock:
+                if self.connection is None:
+                    self.connection = await self.connection_pool.get_connection("_")
         return self
 
     def set_response_callback(self, command: str, callback: ResponseCallbackT):
@@ -501,6 +508,8 @@ async def execute_command(self, *args, **options):
         command_name = args[0]
         conn = self.connection or await pool.get_connection(command_name, **options)
 
+        if self.single_connection_client:
+            await self._single_conn_lock.acquire()
         try:
             return await conn.retry.call_with_retry(
                 lambda: self._send_command_parse_response(
@@ -509,6 +518,8 @@ async def execute_command(self, *args, **options):
                 lambda error: self._disconnect_raise(conn, error),
             )
         finally:
+            if self.single_connection_client:
+                self._single_conn_lock.release()
             if not self.connection:
                 await pool.release(conn)
 
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index bf59dbe6b0..8e4fdac309 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -6,6 +6,7 @@
 import pytest
 
 import redis
+from redis.asyncio import Redis
 from redis.asyncio.connection import (
     BaseParser,
     Connection,
@@ -41,6 +42,50 @@ async def test_invalid_response(create_redis):
     await r.connection.disconnect()
 
 
+@pytest.mark.onlynoncluster
+async def test_single_connection():
+    """Test that concurrent requests on a single client are synchronised."""
+    r = Redis(single_connection_client=True)
+
+    init_call_count = 0
+    command_call_count = 0
+    in_use = False
+
+    class Retry_:
+        async def call_with_retry(self, _, __):
+            # If we remove the single-client lock, this error gets raised as two
+            # coroutines will be vying for the `in_use` flag due to the two
+            # asymmetric sleep calls
+            nonlocal command_call_count
+            nonlocal in_use
+            if in_use is True:
+                raise ValueError("Commands should be executed one at a time.")
+            in_use = True
+            await asyncio.sleep(0.01)
+            command_call_count += 1
+            await asyncio.sleep(0.03)
+            in_use = False
+            return "foo"
+
+    mock_conn = mock.MagicMock()
+    mock_conn.retry = Retry_()
+
+    async def get_conn(_):
+        # Validate only one client is created in single-client mode when
+        # concurrent requests are made
+        nonlocal init_call_count
+        await asyncio.sleep(0.01)
+        init_call_count += 1
+        return mock_conn
+
+    with mock.patch.object(r.connection_pool, "get_connection", get_conn):
+        with mock.patch.object(r.connection_pool, "release"):
+            await asyncio.gather(r.set("a", "b"), r.set("c", "d"))
+
+    assert init_call_count == 1
+    assert command_call_count == 2
+
+
 @skip_if_server_version_lt("4.0.0")
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster

From 31a1c0b7908e157f80e39a00597defa4d76c5ca1 Mon Sep 17 00:00:00 2001
From: Kosuke <kosuke.zhang@gmail.com>
Date: Mon, 6 Feb 2023 19:20:07 +0800
Subject: [PATCH 0670/1164] Fix: tuple function cannot be passed more than one
 argument (#2573)

---
 redis/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/__init__.py b/redis/__init__.py
index 3ab697065e..b8850add15 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -56,7 +56,7 @@ def int_or_str(value):
 try:
     VERSION = tuple(map(int_or_str, __version__.split(".")))
 except AttributeError:
-    VERSION = tuple(99, 99, 99)
+    VERSION = tuple([99, 99, 99])
 
 __all__ = [
     "AuthenticationError",

From ffbe879549c8a212ba70e25ee9a0367187753669 Mon Sep 17 00:00:00 2001
From: Sergey Prokazov <prokazov@users.noreply.github.com>
Date: Mon, 6 Feb 2023 05:46:45 -0600
Subject: [PATCH 0671/1164] Use hiredis::pack_command to serialized the
 commands. (#2570)

* Implemented pack command and pack bytes

* 1) refactored the command packer construction process
2) now hiredis.pack_bytes is the default choice. Though it's still possible to run redisrs-py (fix the flag in utils.py) or hiredis.pack_command (flag in connection.py)

* Switch to hiredis.pack_command

* Remove the rust extension module.

* 1) Introduce HIREDIS_PACK_AVAILABLE environment variable.
2) Extract serialization functionality out of Connection class.

* 1) Fix typo.
2) Add change log entry.
3) Revert the benchmark changes

* Ditch the hiredis version check for pack_command.

* Fix linter errors

* Revert version changes

* Fix linter issues

* Looks like the current redis-py version is 4.4.1

---------

Co-authored-by: Sergey Prokazov <sergey.prokazov@redis.com>
---
 CHANGES                |   1 +
 redis/connection.py    | 135 +++++++++++++++++++++++++++--------------
 redis/utils.py         |   2 +
 tests/test_encoding.py |   5 ++
 4 files changed, 98 insertions(+), 45 deletions(-)
 mode change 100755 => 100644 redis/connection.py

diff --git a/CHANGES b/CHANGES
index 9d82341a76..09babb706f 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Use hiredis-py pack_command if available.
     * Support `.unlink()` in ClusterPipeline
     * Simplify synchronous SocketBuffer state management
     * Fix string cleanse in Redis Graph
diff --git a/redis/connection.py b/redis/connection.py
old mode 100755
new mode 100644
index 57f0a3a81e..114221d8e9
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -3,6 +3,7 @@
 import io
 import os
 import socket
+import sys
 import threading
 import weakref
 from io import SEEK_END
@@ -32,7 +33,12 @@
     TimeoutError,
 )
 from redis.retry import Retry
-from redis.utils import CRYPTOGRAPHY_AVAILABLE, HIREDIS_AVAILABLE, str_if_bytes
+from redis.utils import (
+    CRYPTOGRAPHY_AVAILABLE,
+    HIREDIS_AVAILABLE,
+    HIREDIS_PACK_AVAILABLE,
+    str_if_bytes,
+)
 
 try:
     import ssl
@@ -509,6 +515,75 @@ def read_response(self, disable_decoding=False):
     DefaultParser = PythonParser
 
 
+class HiredisRespSerializer:
+    def pack(self, *args):
+        """Pack a series of arguments into the Redis protocol"""
+        output = []
+
+        if isinstance(args[0], str):
+            args = tuple(args[0].encode().split()) + args[1:]
+        elif b" " in args[0]:
+            args = tuple(args[0].split()) + args[1:]
+        try:
+            output.append(hiredis.pack_command(args))
+        except TypeError:
+            _, value, traceback = sys.exc_info()
+            raise DataError(value).with_traceback(traceback)
+
+        return output
+
+
+class PythonRespSerializer:
+    def __init__(self, buffer_cutoff, encode) -> None:
+        self._buffer_cutoff = buffer_cutoff
+        self.encode = encode
+
+    def pack(self, *args):
+        """Pack a series of arguments into the Redis protocol"""
+        output = []
+        # the client might have included 1 or more literal arguments in
+        # the command name, e.g., 'CONFIG GET'. The Redis server expects these
+        # arguments to be sent separately, so split the first argument
+        # manually. These arguments should be bytestrings so that they are
+        # not encoded.
+        if isinstance(args[0], str):
+            args = tuple(args[0].encode().split()) + args[1:]
+        elif b" " in args[0]:
+            args = tuple(args[0].split()) + args[1:]
+
+        buff = SYM_EMPTY.join((SYM_STAR, str(len(args)).encode(), SYM_CRLF))
+
+        buffer_cutoff = self._buffer_cutoff
+        for arg in map(self.encode, args):
+            # to avoid large string mallocs, chunk the command into the
+            # output list if we're sending large values or memoryviews
+            arg_length = len(arg)
+            if (
+                len(buff) > buffer_cutoff
+                or arg_length > buffer_cutoff
+                or isinstance(arg, memoryview)
+            ):
+                buff = SYM_EMPTY.join(
+                    (buff, SYM_DOLLAR, str(arg_length).encode(), SYM_CRLF)
+                )
+                output.append(buff)
+                output.append(arg)
+                buff = SYM_CRLF
+            else:
+                buff = SYM_EMPTY.join(
+                    (
+                        buff,
+                        SYM_DOLLAR,
+                        str(arg_length).encode(),
+                        SYM_CRLF,
+                        arg,
+                        SYM_CRLF,
+                    )
+                )
+        output.append(buff)
+        return output
+
+
 class Connection:
     "Manages TCP communication to and from a Redis server"
 
@@ -536,6 +611,7 @@ def __init__(
         retry=None,
         redis_connect_func=None,
         credential_provider: Optional[CredentialProvider] = None,
+        command_packer=None,
     ):
         """
         Initialize a new Connection.
@@ -590,6 +666,7 @@ def __init__(
         self.set_parser(parser_class)
         self._connect_callbacks = []
         self._buffer_cutoff = 6000
+        self._command_packer = self._construct_command_packer(command_packer)
 
     def __repr__(self):
         repr_args = ",".join([f"{k}={v}" for k, v in self.repr_pieces()])
@@ -607,6 +684,14 @@ def __del__(self):
         except Exception:
             pass
 
+    def _construct_command_packer(self, packer):
+        if packer is not None:
+            return packer
+        elif HIREDIS_PACK_AVAILABLE:
+            return HiredisRespSerializer()
+        else:
+            return PythonRespSerializer(self._buffer_cutoff, self.encoder.encode)
+
     def register_connect_callback(self, callback):
         self._connect_callbacks.append(weakref.WeakMethod(callback))
 
@@ -827,7 +912,8 @@ def send_packed_command(self, command, check_health=True):
     def send_command(self, *args, **kwargs):
         """Pack and send a command to the Redis server"""
         self.send_packed_command(
-            self.pack_command(*args), check_health=kwargs.get("check_health", True)
+            self._command_packer.pack(*args),
+            check_health=kwargs.get("check_health", True),
         )
 
     def can_read(self, timeout=0):
@@ -872,48 +958,7 @@ def read_response(self, disable_decoding=False):
 
     def pack_command(self, *args):
         """Pack a series of arguments into the Redis protocol"""
-        output = []
-        # the client might have included 1 or more literal arguments in
-        # the command name, e.g., 'CONFIG GET'. The Redis server expects these
-        # arguments to be sent separately, so split the first argument
-        # manually. These arguments should be bytestrings so that they are
-        # not encoded.
-        if isinstance(args[0], str):
-            args = tuple(args[0].encode().split()) + args[1:]
-        elif b" " in args[0]:
-            args = tuple(args[0].split()) + args[1:]
-
-        buff = SYM_EMPTY.join((SYM_STAR, str(len(args)).encode(), SYM_CRLF))
-
-        buffer_cutoff = self._buffer_cutoff
-        for arg in map(self.encoder.encode, args):
-            # to avoid large string mallocs, chunk the command into the
-            # output list if we're sending large values or memoryviews
-            arg_length = len(arg)
-            if (
-                len(buff) > buffer_cutoff
-                or arg_length > buffer_cutoff
-                or isinstance(arg, memoryview)
-            ):
-                buff = SYM_EMPTY.join(
-                    (buff, SYM_DOLLAR, str(arg_length).encode(), SYM_CRLF)
-                )
-                output.append(buff)
-                output.append(arg)
-                buff = SYM_CRLF
-            else:
-                buff = SYM_EMPTY.join(
-                    (
-                        buff,
-                        SYM_DOLLAR,
-                        str(arg_length).encode(),
-                        SYM_CRLF,
-                        arg,
-                        SYM_CRLF,
-                    )
-                )
-        output.append(buff)
-        return output
+        return self._command_packer.pack(*args)
 
     def pack_commands(self, commands):
         """Pack multiple commands into the Redis protocol"""
@@ -923,7 +968,7 @@ def pack_commands(self, commands):
         buffer_cutoff = self._buffer_cutoff
 
         for cmd in commands:
-            for chunk in self.pack_command(*cmd):
+            for chunk in self._command_packer.pack(*cmd):
                 chunklen = len(chunk)
                 if (
                     buffer_length > buffer_cutoff
diff --git a/redis/utils.py b/redis/utils.py
index 693d4e64b5..d95e62c042 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -7,8 +7,10 @@
 
     # Only support Hiredis >= 1.0:
     HIREDIS_AVAILABLE = not hiredis.__version__.startswith("0.")
+    HIREDIS_PACK_AVAILABLE = hasattr(hiredis, "pack_command")
 except ImportError:
     HIREDIS_AVAILABLE = False
+    HIREDIS_PACK_AVAILABLE = False
 
 try:
     import cryptography  # noqa
diff --git a/tests/test_encoding.py b/tests/test_encoding.py
index 2867640742..cb9c4e20be 100644
--- a/tests/test_encoding.py
+++ b/tests/test_encoding.py
@@ -2,6 +2,7 @@
 
 import redis
 from redis.connection import Connection
+from redis.utils import HIREDIS_PACK_AVAILABLE
 
 from .conftest import _get_client
 
@@ -75,6 +76,10 @@ def test_replace(self, request):
         assert r.get("a") == "foo\ufffd"
 
 
+@pytest.mark.skipif(
+    HIREDIS_PACK_AVAILABLE,
+    reason="Packing via hiredis does not preserve memoryviews",
+)
 class TestMemoryviewsAreNotPacked:
     def test_memoryviews_are_not_packed(self):
         c = Connection()

From 9e00b91e1b181af666c58acaf2fcd3b1b8194889 Mon Sep 17 00:00:00 2001
From: Anurag Bandyopadhyay <angbpy@gmail.com>
Date: Mon, 6 Feb 2023 18:09:43 +0530
Subject: [PATCH 0672/1164] Fix issue 2567: NoneType check before raising
 exception (#2569)

Co-authored-by: Anuragkillswitch <70265851+Anuragkillswitch@users.noreply.github.com>
---
 redis/connection.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/redis/connection.py b/redis/connection.py
index 114221d8e9..b2f34293a5 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -340,11 +340,12 @@ def can_read(self, timeout):
         return self._buffer and self._buffer.can_read(timeout)
 
     def read_response(self, disable_decoding=False):
-        pos = self._buffer.get_pos()
+        pos = self._buffer.get_pos() if self._buffer else None
         try:
             result = self._read_response(disable_decoding=disable_decoding)
         except BaseException:
-            self._buffer.rewind(pos)
+            if self._buffer:
+                self._buffer.rewind(pos)
             raise
         else:
             self._buffer.purge()

From e7306aae64b728fc6d894faed046960de76710c4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Mon, 6 Feb 2023 19:25:10 +0000
Subject: [PATCH 0673/1164] Fix issue 2349: Let async HiredisParser finish
 parsing after a Connection.disconnect() (#2557)

* A failing unittest

* Do not clear the redis-reader's state when we disconnect so that it can finish reading the final message

* Test that reading a message of two chunks after a disconnect() works.

* Add Changes

* fix typos
---
 CHANGES                               |  1 +
 redis/asyncio/connection.py           | 15 +++--
 tests/test_asyncio/test_connection.py | 82 +++++++++++++++++++++++++++
 3 files changed, 92 insertions(+), 6 deletions(-)

diff --git a/CHANGES b/CHANGES
index 09babb706f..e83660d6ac 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Add test and fix async HiredisParser when reading during a disconnect() (#2349)
     * Use hiredis-py pack_command if available.
     * Support `.unlink()` in ClusterPipeline
     * Simplify synchronous SocketBuffer state management
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 2c75d4fcf1..862f6f096b 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -350,13 +350,14 @@ async def _readline(self) -> bytes:
 class HiredisParser(BaseParser):
     """Parser class for connections using Hiredis"""
 
-    __slots__ = BaseParser.__slots__ + ("_reader",)
+    __slots__ = BaseParser.__slots__ + ("_reader", "_connected")
 
     def __init__(self, socket_read_size: int):
         if not HIREDIS_AVAILABLE:
             raise RedisError("Hiredis is not available.")
         super().__init__(socket_read_size=socket_read_size)
         self._reader: Optional[hiredis.Reader] = None
+        self._connected: bool = False
 
     def on_connect(self, connection: "Connection"):
         self._stream = connection._reader
@@ -369,13 +370,13 @@ def on_connect(self, connection: "Connection"):
             kwargs["errors"] = connection.encoder.encoding_errors
 
         self._reader = hiredis.Reader(**kwargs)
+        self._connected = True
 
     def on_disconnect(self):
-        self._stream = None
-        self._reader = None
+        self._connected = False
 
     async def can_read_destructive(self):
-        if not self._stream or not self._reader:
+        if not self._connected:
             raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
         if self._reader.gets():
             return True
@@ -397,8 +398,10 @@ async def read_from_socket(self):
     async def read_response(
         self, disable_decoding: bool = False
     ) -> Union[EncodableT, List[EncodableT]]:
-        if not self._stream or not self._reader:
-            self.on_disconnect()
+        # If `on_disconnect()` has been called, prohibit any more reads
+        # even if they could happen because data might be present.
+        # We still allow reads in progress to finish
+        if not self._connected:
             raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR) from None
 
         response = self._reader.gets()
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index 8e4fdac309..1851ca9a76 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -10,12 +10,14 @@
 from redis.asyncio.connection import (
     BaseParser,
     Connection,
+    HiredisParser,
     PythonParser,
     UnixDomainSocketConnection,
 )
 from redis.asyncio.retry import Retry
 from redis.backoff import NoBackoff
 from redis.exceptions import ConnectionError, InvalidResponse, TimeoutError
+from redis.utils import HIREDIS_AVAILABLE
 from tests.conftest import skip_if_server_version_lt
 
 from .compat import mock
@@ -191,3 +193,83 @@ async def test_connection_parse_response_resume(r: redis.Redis):
         pytest.fail("didn't receive a response")
     assert response
     assert i > 0
+
+
+@pytest.mark.onlynoncluster
+@pytest.mark.parametrize(
+    "parser_class", [PythonParser, HiredisParser], ids=["PythonParser", "HiredisParser"]
+)
+async def test_connection_disconect_race(parser_class):
+    """
+    This test reproduces the case in issue #2349
+    where a connection is closed while the parser is reading to feed the
+    internal buffer.The stream `read()` will succeed, but when it returns,
+    another task has already called `disconnect()` and is waiting for
+    close to finish.  When we attempts to feed the buffer, we will fail
+    since the buffer is no longer there.
+
+    This test verifies that a read in progress can finish even
+    if the `disconnect()` method is called.
+    """
+    if parser_class == PythonParser:
+        pytest.xfail("doesn't work yet with PythonParser")
+    if parser_class == HiredisParser and not HIREDIS_AVAILABLE:
+        pytest.skip("Hiredis not available")
+
+    args = {}
+    args["parser_class"] = parser_class
+
+    conn = Connection(**args)
+
+    cond = asyncio.Condition()
+    # 0 == initial
+    # 1 == reader is reading
+    # 2 == closer has closed and is waiting for close to finish
+    state = 0
+
+    # Mock read function, which wait for a close to happen before returning
+    # Can either be invoked as two `read()` calls (HiredisParser)
+    # or as a `readline()` followed by `readexact()` (PythonParser)
+    chunks = [b"$13\r\n", b"Hello, World!\r\n"]
+
+    async def read(_=None):
+        nonlocal state
+        async with cond:
+            if state == 0:
+                state = 1  # we are reading
+                cond.notify()
+                # wait until the closing task has done
+                await cond.wait_for(lambda: state == 2)
+        return chunks.pop(0)
+
+    # function closes the connection while reader is still blocked reading
+    async def do_close():
+        nonlocal state
+        async with cond:
+            await cond.wait_for(lambda: state == 1)
+            state = 2
+            cond.notify()
+        await conn.disconnect()
+
+    async def do_read():
+        return await conn.read_response()
+
+    reader = mock.AsyncMock()
+    writer = mock.AsyncMock()
+    writer.transport = mock.Mock()
+    writer.transport.get_extra_info.side_effect = None
+
+    # for HiredisParser
+    reader.read.side_effect = read
+    # for PythonParser
+    reader.readline.side_effect = read
+    reader.readexactly.side_effect = read
+
+    async def open_connection(*args, **kwargs):
+        return reader, writer
+
+    with patch.object(asyncio, "open_connection", open_connection):
+        await conn.connect()
+
+    vals = await asyncio.gather(do_read(), do_close())
+    assert vals == [b"Hello, World!", None]

From fcd8f98509c5c7c14ee5a3201b56b8bf755a4b7c Mon Sep 17 00:00:00 2001
From: Igor Malinovskiy <u.glide@gmail.com>
Date: Tue, 7 Feb 2023 12:06:35 +0200
Subject: [PATCH 0674/1164] Add TS.MGET example for OS Redis Cluster (#2507)

---
 docs/examples/timeseries_examples.ipynb | 41 +++++++++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/docs/examples/timeseries_examples.ipynb b/docs/examples/timeseries_examples.ipynb
index fefc0c8f37..691e13350a 100644
--- a/docs/examples/timeseries_examples.ipynb
+++ b/docs/examples/timeseries_examples.ipynb
@@ -599,6 +599,47 @@
    "source": [
     "ts.range(\"ts_key_incr\", \"-\", \"+\")"
    ]
+  },
+  {
+   "cell_type": "markdown",
+   "source": [
+    "## How to execute multi-key commands on Open Source Redis Cluster"
+   ],
+   "metadata": {
+    "collapsed": false
+   }
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "outputs": [
+    {
+     "data": {
+      "text/plain": "[{'ts_key1': [{}, 1670927124746, 2.0]}, {'ts_key2': [{}, 1670927124748, 10.0]}]"
+     },
+     "execution_count": 4,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "import redis\n",
+    "\n",
+    "r = redis.RedisCluster(host=\"localhost\", port=46379)\n",
+    "\n",
+    "# This command should be executed on all cluster nodes after creation and any re-sharding\n",
+    "# Please note that this command is internal and will be deprecated in the future\n",
+    "r.execute_command(\"timeseries.REFRESHCLUSTER\", target_nodes=\"primaries\")\n",
+    "\n",
+    "# Now multi-key commands can be executed\n",
+    "ts = r.ts()\n",
+    "ts.add(\"ts_key1\", \"*\", 2,  labels={\"label1\": 1, \"label2\": 2})\n",
+    "ts.add(\"ts_key2\", \"*\", 10,  labels={\"label1\": 1, \"label2\": 2})\n",
+    "ts.mget([\"label1=1\"])"
+   ],
+   "metadata": {
+    "collapsed": false
+   }
   }
  ],
  "metadata": {

From f517287a118a372d47956f5ba831927018d1ad3e Mon Sep 17 00:00:00 2001
From: jmcbailey <jmcbailey@gmail.com>
Date: Tue, 7 Feb 2023 10:43:36 +0000
Subject: [PATCH 0675/1164] Fix issue with `pack_commands` returning an empty
 byte sequence (#2416)

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/asyncio/connection.py | 3 ++-
 redis/connection.py         | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 862f6f096b..e77fba30da 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -925,7 +925,8 @@ def pack_commands(self, commands: Iterable[Iterable[EncodableT]]) -> List[bytes]
                     or chunklen > buffer_cutoff
                     or isinstance(chunk, memoryview)
                 ):
-                    output.append(SYM_EMPTY.join(pieces))
+                    if pieces:
+                        output.append(SYM_EMPTY.join(pieces))
                     buffer_length = 0
                     pieces = []
 
diff --git a/redis/connection.py b/redis/connection.py
index b2f34293a5..24614824c5 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -976,7 +976,8 @@ def pack_commands(self, commands):
                     or chunklen > buffer_cutoff
                     or isinstance(chunk, memoryview)
                 ):
-                    output.append(SYM_EMPTY.join(pieces))
+                    if pieces:
+                        output.append(SYM_EMPTY.join(pieces))
                     buffer_length = 0
                     pieces = []
 

From 5cb5712d283fa8fb300abc9d71a61c1a81de5643 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 7 Feb 2023 13:49:14 +0200
Subject: [PATCH 0676/1164] Version 4.5.0 (#2580)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 16a9156641..022a27ebc7 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.4.2",
+    version="4.5.0",
     packages=find_packages(
         include=[
             "redis",

From 2b470cb76534eca04e181e1877a0674032f7e82a Mon Sep 17 00:00:00 2001
From: Sergey Prokazov <prokazov@users.noreply.github.com>
Date: Wed, 8 Feb 2023 06:18:49 -0600
Subject: [PATCH 0677/1164] Fix #2581 UnixDomainSocketConnection' object has no
 attribute '_command_packer' (#2583)

* Fix #2581 UnixDomainSocketConnection' object has no attribute '_command_packer' .
Apparently there is no end-to-end tests for Unix sockets
 so automation didn't catch it.  I assume that setting up
domain sockets reliably  in dockerized environment is not
very trivial.
Added test for pack_command specifically.

* Figuring out why CI fails.
Locally:
" congratulations :)"

* Fix the test.
hiredis doesn't treat memoryviews differently.
---
 redis/connection.py      |  2 ++
 tests/test_connection.py | 44 +++++++++++++++++++++++++++++++++++++++-
 2 files changed, 45 insertions(+), 1 deletion(-)

diff --git a/redis/connection.py b/redis/connection.py
index 24614824c5..d35980c167 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1153,6 +1153,7 @@ def __init__(
         retry=None,
         redis_connect_func=None,
         credential_provider: Optional[CredentialProvider] = None,
+        command_packer=None,
     ):
         """
         Initialize a new UnixDomainSocketConnection.
@@ -1202,6 +1203,7 @@ def __init__(
         self.set_parser(parser_class)
         self._connect_callbacks = []
         self._buffer_cutoff = 6000
+        self._command_packer = self._construct_command_packer(command_packer)
 
     def repr_pieces(self):
         pieces = [("path", self.path), ("db", self.db)]
diff --git a/tests/test_connection.py b/tests/test_connection.py
index e0b53cdf37..25b4118b2c 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -7,7 +7,13 @@
 
 import redis
 from redis.backoff import NoBackoff
-from redis.connection import Connection, HiredisParser, PythonParser
+from redis.connection import (
+    Connection,
+    HiredisParser,
+    PythonParser,
+    SSLConnection,
+    UnixDomainSocketConnection,
+)
 from redis.exceptions import ConnectionError, InvalidResponse, TimeoutError
 from redis.retry import Retry
 from redis.utils import HIREDIS_AVAILABLE
@@ -163,3 +169,39 @@ def test_connection_parse_response_resume(r: redis.Redis, parser_class):
         pytest.fail("didn't receive a response")
     assert response
     assert i > 0
+
+
+@pytest.mark.onlynoncluster
+@pytest.mark.parametrize(
+    "Class",
+    [
+        Connection,
+        SSLConnection,
+        UnixDomainSocketConnection,
+    ],
+)
+def test_pack_command(Class):
+    """
+    This test verifies that the pack_command works
+    on all supported connections. #2581
+    """
+    cmd = (
+        "HSET",
+        "foo",
+        "key",
+        "value1",
+        b"key_b",
+        b"bytes str",
+        b"key_i",
+        67,
+        "key_f",
+        3.14159265359,
+    )
+    expected = (
+        b"*10\r\n$4\r\nHSET\r\n$3\r\nfoo\r\n$3\r\nkey\r\n$6\r\nvalue1\r\n"
+        b"$5\r\nkey_b\r\n$9\r\nbytes str\r\n$5\r\nkey_i\r\n$2\r\n67\r\n$5"
+        b"\r\nkey_f\r\n$13\r\n3.14159265359\r\n"
+    )
+
+    actual = Class().pack_command(*cmd)[0]
+    assert actual == expected, f"actual = {actual}, expected = {expected}"

From fd7a79dca3d10af88a2ef79f81471a63376c081f Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 8 Feb 2023 15:20:55 +0200
Subject: [PATCH 0678/1164] Version 4.5.1 (#2586)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 022a27ebc7..060e9da7b0 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.5.0",
+    version="4.5.1",
     packages=find_packages(
         include=[
             "redis",

From e9ad2a3ec0f403373fe2c01d2ab3a71c69ec884c Mon Sep 17 00:00:00 2001
From: Galtozzy <14139502+Galtozzy@users.noreply.github.com>
Date: Wed, 15 Feb 2023 16:05:47 +0300
Subject: [PATCH 0679/1164] Fix for `lpop` and `rpop` return typing (#2590)

Right now there is an annoying warning that these methods can't be awaited when using `redis.asyncio`, even tho it does work with no problems.
---
 redis/commands/core.py | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index b07f12d854..28dab81f8b 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -2667,7 +2667,11 @@ def llen(self, name: str) -> Union[Awaitable[int], int]:
         """
         return self.execute_command("LLEN", name)
 
-    def lpop(self, name: str, count: Optional[int] = None) -> Union[str, List, None]:
+    def lpop(
+        self,
+        name: str,
+        count: Optional[int] = None,
+    ) -> Union[Awaitable[Union[str, List, None]], Union[str, List, None]]:
         """
         Removes and returns the first elements of the list ``name``.
 
@@ -2744,7 +2748,11 @@ def ltrim(self, name: str, start: int, end: int) -> Union[Awaitable[str], str]:
         """
         return self.execute_command("LTRIM", name, start, end)
 
-    def rpop(self, name: str, count: Optional[int] = None) -> Union[str, List, None]:
+    def rpop(
+        self,
+        name: str,
+        count: Optional[int] = None,
+    ) -> Union[Awaitable[Union[str, List, None]], Union[str, List, None]]:
         """
         Removes and returns the last elements of the list ``name``.
 

From 6c708c2e0511364c2c3f21fa1259de05e590632d Mon Sep 17 00:00:00 2001
From: Igor Malinovskiy <u.glide@gmail.com>
Date: Sun, 19 Feb 2023 09:51:36 +0100
Subject: [PATCH 0680/1164] Update README to make pip install copy-pastable on
 zsh (#2584)

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index c02483fe93..6b53b42f78 100644
--- a/README.md
+++ b/README.md
@@ -37,7 +37,7 @@ For faster performance, install redis with hiredis support, this provides a comp
 By default, if hiredis >= 1.0 is available, redis-py will attempt to use it for response parsing.
 
 ``` bash
-$ pip install redis[hiredis]
+$ pip install "redis[hiredis]"
 ```
 
 Looking for a high-level library to handle object mapping? See [redis-om-python](https://github.com/redis/redis-om-python)!

From b546a9a81c374b054835a5eeda9b580344d78dfd Mon Sep 17 00:00:00 2001
From: Alex Schmitz <alex.schmitz@gmail.com>
Date: Wed, 15 Mar 2023 04:33:38 -0500
Subject: [PATCH 0681/1164] update json().arrindex() default values (#2611)

* update json().arrindex() default values

* add unit test

* fix falsy checks

* more unit tests

* add asyncio tests

* fix lint line length

---------

Co-authored-by: Alex Schmitz <aschmitz@box.com>
---
 redis/commands/json/commands.py | 14 +++++++++-----
 tests/test_asyncio/test_json.py | 12 +++++++++---
 tests/test_json.py              |  5 +++++
 3 files changed, 23 insertions(+), 8 deletions(-)

diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index 7fd4039203..c02c47ad86 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -31,8 +31,8 @@ def arrindex(
         name: str,
         path: str,
         scalar: int,
-        start: Optional[int] = 0,
-        stop: Optional[int] = -1,
+        start: Optional[int] = None,
+        stop: Optional[int] = None,
     ) -> List[Union[int, None]]:
         """
         Return the index of ``scalar`` in the JSON array under ``path`` at key
@@ -43,9 +43,13 @@ def arrindex(
 
         For more information see `JSON.ARRINDEX <https://redis.io/commands/json.arrindex>`_.
         """  # noqa
-        return self.execute_command(
-            "JSON.ARRINDEX", name, str(path), self._encode(scalar), start, stop
-        )
+        pieces = [name, str(path), self._encode(scalar)]
+        if start is not None:
+            pieces.append(start)
+            if stop is not None:
+                pieces.append(stop)
+
+        return self.execute_command("JSON.ARRINDEX", *pieces)
 
     def arrinsert(
         self, name: str, path: str, index: int, *args: List[JsonType]
diff --git a/tests/test_asyncio/test_json.py b/tests/test_asyncio/test_json.py
index b8854d20cd..fc530c63c1 100644
--- a/tests/test_asyncio/test_json.py
+++ b/tests/test_asyncio/test_json.py
@@ -145,9 +145,15 @@ async def test_arrappend(modclient: redis.Redis):
 
 @pytest.mark.redismod
 async def test_arrindex(modclient: redis.Redis):
-    await modclient.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
-    assert 1 == await modclient.json().arrindex("arr", Path.root_path(), 1)
-    assert -1 == await modclient.json().arrindex("arr", Path.root_path(), 1, 2)
+    r_path = Path.root_path()
+    await modclient.json().set("arr", r_path, [0, 1, 2, 3, 4])
+    assert 1 == await modclient.json().arrindex("arr", r_path, 1)
+    assert -1 == await modclient.json().arrindex("arr", r_path, 1, 2)
+    assert 4 == await modclient.json().arrindex("arr", r_path, 4)
+    assert 4 == await modclient.json().arrindex("arr", r_path, 4, start=0)
+    assert 4 == await modclient.json().arrindex("arr", r_path, 4, start=0, stop=5000)
+    assert -1 == await modclient.json().arrindex("arr", r_path, 4, start=0, stop=-1)
+    assert -1 == await modclient.json().arrindex("arr", r_path, 4, start=1, stop=3)
 
 
 @pytest.mark.redismod
diff --git a/tests/test_json.py b/tests/test_json.py
index a776e9e736..8e8da05609 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -166,6 +166,11 @@ def test_arrindex(client):
     client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
     assert 1 == client.json().arrindex("arr", Path.root_path(), 1)
     assert -1 == client.json().arrindex("arr", Path.root_path(), 1, 2)
+    assert 4 == client.json().arrindex("arr", Path.root_path(), 4)
+    assert 4 == client.json().arrindex("arr", Path.root_path(), 4, start=0)
+    assert 4 == client.json().arrindex("arr", Path.root_path(), 4, start=0, stop=5000)
+    assert -1 == client.json().arrindex("arr", Path.root_path(), 4, start=0, stop=-1)
+    assert -1 == client.json().arrindex("arr", Path.root_path(), 4, start=1, stop=3)
 
 
 @pytest.mark.redismod

From 5588ae08b3138c700726a9bf145ac34bc812ebcc Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 15 Mar 2023 11:35:20 +0200
Subject: [PATCH 0682/1164] Speeding up the protocol parsing (#2596)

* speeding up the protocol parser

* linting

* changes to ease
---
 redis/asyncio/connection.py | 25 ++++++++++++-------------
 redis/connection.py         | 24 +++++++++++-------------
 2 files changed, 23 insertions(+), 26 deletions(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index e77fba30da..056998e9e0 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -267,9 +267,6 @@ async def _read_response(
         response: Any
         byte, response = raw[:1], raw[1:]
 
-        if byte not in (b"-", b"+", b":", b"$", b"*"):
-            raise InvalidResponse(f"Protocol Error: {raw!r}")
-
         # server returned an error
         if byte == b"-":
             response = response.decode("utf-8", errors="replace")
@@ -289,22 +286,24 @@ async def _read_response(
             pass
         # int value
         elif byte == b":":
-            response = int(response)
+            return int(response)
         # bulk response
+        elif byte == b"$" and response == b"-1":
+            return None
         elif byte == b"$":
-            length = int(response)
-            if length == -1:
-                return None
-            response = await self._read(length)
+            response = await self._read(int(response))
         # multi-bulk response
+        elif byte == b"*" and response == b"-1":
+            return None
         elif byte == b"*":
-            length = int(response)
-            if length == -1:
-                return None
             response = [
-                (await self._read_response(disable_decoding)) for _ in range(length)
+                (await self._read_response(disable_decoding))
+                for _ in range(int(response))  # noqa
             ]
-        if isinstance(response, bytes) and disable_decoding is False:
+        else:
+            raise InvalidResponse(f"Protocol Error: {raw!r}")
+
+        if disable_decoding is False:
             response = self.encoder.decode(response)
         return response
 
diff --git a/redis/connection.py b/redis/connection.py
index d35980c167..c4a9685f6a 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -358,9 +358,6 @@ def _read_response(self, disable_decoding=False):
 
         byte, response = raw[:1], raw[1:]
 
-        if byte not in (b"-", b"+", b":", b"$", b"*"):
-            raise InvalidResponse(f"Protocol Error: {raw!r}")
-
         # server returned an error
         if byte == b"-":
             response = response.decode("utf-8", errors="replace")
@@ -379,23 +376,24 @@ def _read_response(self, disable_decoding=False):
             pass
         # int value
         elif byte == b":":
-            response = int(response)
+            return int(response)
         # bulk response
+        elif byte == b"$" and response == b"-1":
+            return None
         elif byte == b"$":
-            length = int(response)
-            if length == -1:
-                return None
-            response = self._buffer.read(length)
+            response = self._buffer.read(int(response))
         # multi-bulk response
+        elif byte == b"*" and response == b"-1":
+            return None
         elif byte == b"*":
-            length = int(response)
-            if length == -1:
-                return None
             response = [
                 self._read_response(disable_decoding=disable_decoding)
-                for i in range(length)
+                for i in range(int(response))
             ]
-        if isinstance(response, bytes) and disable_decoding is False:
+        else:
+            raise InvalidResponse(f"Protocol Error: {raw!r}")
+
+        if disable_decoding is False:
             response = self.encoder.decode(response)
         return response
 

From 3edd49bea4d88dbe565a920fdd12be28ff4f513e Mon Sep 17 00:00:00 2001
From: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Date: Wed, 15 Mar 2023 11:35:50 +0200
Subject: [PATCH 0683/1164] Fixed CredentialsProvider examples (#2587)

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 docs/examples/connection_examples.ipynb | 50 +++++++++++++++----------
 1 file changed, 30 insertions(+), 20 deletions(-)

diff --git a/docs/examples/connection_examples.ipynb b/docs/examples/connection_examples.ipynb
index a15b4c6cc0..7f5ac53e89 100644
--- a/docs/examples/connection_examples.ipynb
+++ b/docs/examples/connection_examples.ipynb
@@ -222,18 +222,23 @@
     "import json\n",
     "import cachetools.func\n",
     "\n",
-    "sm_client = boto3.client('secretsmanager')\n",
-    "  \n",
-    "def sm_auth_provider(self, secret_id, version_id=None, version_stage='AWSCURRENT'):\n",
-    "    @cachetools.func.ttl_cache(maxsize=128, ttl=24 * 60 * 60) #24h\n",
-    "    def get_sm_user_credentials(secret_id, version_id, version_stage):\n",
-    "        secret = sm_client.get_secret_value(secret_id, version_id)\n",
-    "        return json.loads(secret['SecretString'])\n",
-    "    creds = get_sm_user_credentials(secret_id, version_id, version_stage)\n",
-    "    return creds['username'], creds['password']\n",
+    "class SecretsManagerProvider(redis.CredentialProvider):\n",
+    "    def __init__(self, secret_id, version_id=None, version_stage='AWSCURRENT'):\n",
+    "        self.sm_client = boto3.client('secretsmanager')\n",
+    "        self.secret_id = secret_id\n",
+    "        self.version_id = version_id\n",
+    "        self.version_stage = version_stage\n",
     "\n",
-    "secret_id = \"EXAMPLE1-90ab-cdef-fedc-ba987SECRET1\"\n",
-    "creds_provider = redis.CredentialProvider(supplier=sm_auth_provider, secret_id=secret_id)\n",
+    "    def get_credentials(self) -> Union[Tuple[str], Tuple[str, str]]:\n",
+    "        @cachetools.func.ttl_cache(maxsize=128, ttl=24 * 60 * 60) #24h\n",
+    "        def get_sm_user_credentials(secret_id, version_id, version_stage):\n",
+    "            secret = self.sm_client.get_secret_value(secret_id, version_id)\n",
+    "            return json.loads(secret['SecretString'])\n",
+    "        creds = get_sm_user_credentials(self.secret_id, self.version_id, self.version_stage)\n",
+    "        return creds['username'], creds['password']\n",
+    "\n",
+    "my_secret_id = \"EXAMPLE1-90ab-cdef-fedc-ba987SECRET1\"\n",
+    "creds_provider = SecretsManagerProvider(secret_id=my_secret_id)\n",
     "user_connection = redis.Redis(host=\"localhost\", port=6379, credential_provider=creds_provider)\n",
     "user_connection.ping()"
    ]
@@ -266,19 +271,24 @@
     "import boto3\n",
     "import cachetools.func\n",
     "\n",
-    "ec_client = boto3.client('elasticache')\n",
+    "class ElastiCacheIAMProvider(redis.CredentialProvider):\n",
+    "    def __init__(self, user, endpoint, port=6379, region=\"us-east-1\"):\n",
+    "        self.ec_client = boto3.client('elasticache')\n",
+    "        self.user = user\n",
+    "        self.endpoint = endpoint\n",
+    "        self.port = port\n",
+    "        self.region = region\n",
     "\n",
-    "def iam_auth_provider(self, user, endpoint, port=6379, region=\"us-east-1\"):\n",
-    "    @cachetools.func.ttl_cache(maxsize=128, ttl=15 * 60) # 15m\n",
-    "    def get_iam_auth_token(user, endpoint, port, region):\n",
-    "        return ec_client.generate_iam_auth_token(user, endpoint, port, region)\n",
-    "    iam_auth_token = get_iam_auth_token(endpoint, port, user, region)\n",
-    "    return iam_auth_token\n",
+    "    def get_credentials(self) -> Union[Tuple[str], Tuple[str, str]]:\n",
+    "        @cachetools.func.ttl_cache(maxsize=128, ttl=15 * 60) # 15m\n",
+    "        def get_iam_auth_token(user, endpoint, port, region):\n",
+    "            return self.ec_client.generate_iam_auth_token(user, endpoint, port, region)\n",
+    "        iam_auth_token = get_iam_auth_token(self.endpoint, self.port, self.user, self.region)\n",
+    "        return iam_auth_token\n",
     "\n",
     "username = \"barshaul\"\n",
     "endpoint = \"test-001.use1.cache.amazonaws.com\"\n",
-    "creds_provider = redis.CredentialProvider(supplier=iam_auth_provider, user=username,\n",
-    "                                           endpoint=endpoint)\n",
+    "creds_provider = ElastiCacheIAMProvider(user=username, endpoint=endpoint)\n",
     "user_connection = redis.Redis(host=endpoint, port=6379, credential_provider=creds_provider)\n",
     "user_connection.ping()"
    ]

From 6d1061f50a6fe4cfa0a39f6a6852ed1a3a6da0bd Mon Sep 17 00:00:00 2001
From: CrimsonGlory <CrimsonGlory@users.noreply.github.com>
Date: Wed, 15 Mar 2023 06:37:12 -0300
Subject: [PATCH 0684/1164] ConnectionPool SSL example (#2605)

---
 docs/examples/ssl_connection_examples.ipynb | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/docs/examples/ssl_connection_examples.ipynb b/docs/examples/ssl_connection_examples.ipynb
index 386e4af452..ab3b4415ae 100644
--- a/docs/examples/ssl_connection_examples.ipynb
+++ b/docs/examples/ssl_connection_examples.ipynb
@@ -55,6 +55,27 @@
     "url_connection.ping()"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "04e70233",
+   "metadata": {},
+   "source": [
+    "## Connecting to a Redis instance using ConnectionPool"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "2903de26",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import redis\n",
+    "redis_pool = redis.ConnectionPool(host=\"localhost\", port=6666, connection_class=redis.SSLConnection)\n",
+    "ssl_connection = redis.StrictRedis(connection_pool=redis_pool) \n",
+    "ssl_connection.ping()"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},

From a372ba4f28f874ebff008a3bb4f5ce06104fd29b Mon Sep 17 00:00:00 2001
From: Raymond Yin <raymond@tryevergreen.com>
Date: Wed, 15 Mar 2023 03:27:42 -0700
Subject: [PATCH 0685/1164] [types] update return type of smismember to
 list[int] (#2617)

* update return type of smismember

* use Literal instead of int
---
 redis/commands/core.py | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 28dab81f8b..e2cabb85fa 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3357,10 +3357,15 @@ def smembers(self, name: str) -> Union[Awaitable[Set], Set]:
 
     def smismember(
         self, name: str, values: List, *args: List
-    ) -> Union[Awaitable[List[bool]], List[bool]]:
+    ) -> Union[
+        Awaitable[List[Union[Literal[0], Literal[1]]]],
+        List[Union[Literal[0], Literal[1]]],
+    ]:
         """
         Return whether each value in ``values`` is a member of the set ``name``
-        as a list of ``bool`` in the order of ``values``
+        as a list of ``int`` in the order of ``values``:
+        - 1 if the value is a member of the set.
+        - 0 if the value is not a member of the set or if key does not exist.
 
         For more information see https://redis.io/commands/smismember
         """

From 8bfd492240fd33489a86cd3d353e3ece1fc94c10 Mon Sep 17 00:00:00 2001
From: Abhishek Kumar Sinha <aksinha334@gmail.com>
Date: Thu, 16 Mar 2023 01:19:02 +0530
Subject: [PATCH 0686/1164] Making search document subscriptable (#2615)

* Fixed issue #2598 - make Document class subscriptable

* Last time added older file, fixed it

* retrigger checks

* update json().arrindex() default values (#2611)

* update json().arrindex() default values

* add unit test

* fix falsy checks

* more unit tests

* add asyncio tests

* fix lint line length

---------

Co-authored-by: Alex Schmitz <aschmitz@box.com>

* Speeding up the protocol parsing (#2596)

* speeding up the protocol parser

* linting

* changes to ease

* Fixed CredentialsProvider examples (#2587)

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* ConnectionPool SSL example (#2605)

* [types] update return type of smismember to list[int] (#2617)

* update return type of smismember

* use Literal instead of int

* retrigger checks

* Added test for document subscriptable in tests/test_search.py

* Fixed linter issue

* retrigger checks

---------

Co-authored-by: Alex Schmitz <alex.schmitz@gmail.com>
Co-authored-by: Alex Schmitz <aschmitz@box.com>
Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: Bar Shaul <88437685+barshaul@users.noreply.github.com>
Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
Co-authored-by: CrimsonGlory <CrimsonGlory@users.noreply.github.com>
Co-authored-by: Raymond Yin <raymond@tryevergreen.com>
---
 redis/commands/search/document.py | 4 ++++
 tests/test_search.py              | 2 ++
 2 files changed, 6 insertions(+)

diff --git a/redis/commands/search/document.py b/redis/commands/search/document.py
index 5b3050545a..47534ec248 100644
--- a/redis/commands/search/document.py
+++ b/redis/commands/search/document.py
@@ -11,3 +11,7 @@ def __init__(self, id, payload=None, **fields):
 
     def __repr__(self):
         return f"Document {self.__dict__}"
+
+    def __getitem__(self, item):
+        value = getattr(self, item)
+        return value
diff --git a/tests/test_search.py b/tests/test_search.py
index 57d4338ead..7a2428151e 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -140,7 +140,9 @@ def test_client(client):
 
     for doc in res.docs:
         assert doc.id
+        assert doc["id"]
         assert doc.play == "Henry IV"
+        assert doc["play"] == "Henry IV"
         assert len(doc.txt) > 0
 
     # test no content

From 91ab12a0f1bdf0e433131e1a51578e9fa2f89718 Mon Sep 17 00:00:00 2001
From: "Eom Taegyung \"Iggy" <iggy.eom@sendbird.com>
Date: Thu, 16 Mar 2023 20:19:34 +0900
Subject: [PATCH 0687/1164] Remove redundant assignment. (#2620)

---
 redis/cluster.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index d6dc02d493..fbda234137 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -588,7 +588,6 @@ def __init__(
         self.read_from_replicas = read_from_replicas
         self.reinitialize_counter = 0
         self.reinitialize_steps = reinitialize_steps
-        self.nodes_manager = None
         self.nodes_manager = NodesManager(
             startup_nodes=startup_nodes,
             from_url=from_url,

From 25e85e51e57b7aae9eb8fc77cfb0a45a07a501a7 Mon Sep 17 00:00:00 2001
From: Mehdi ABAAKOUK <sileht@sileht.net>
Date: Thu, 16 Mar 2023 12:51:19 +0100
Subject: [PATCH 0688/1164] fix: replace async_timeout by asyncio.timeout
 (#2602)

async_timeout does not support python 3.11
https://github.com/aio-libs/async-timeout/pull/295

And have two years old annoying bugs:
https://github.com/aio-libs/async-timeout/issues/229
https://github.com/redis/redis-py/issues/2551

Since asyncio.timeout has been shipped in python 3.11, we should start
using it.

Partially fixes 2551
---
 CHANGES                           |  1 +
 redis/asyncio/connection.py       | 21 +++++++++++++--------
 setup.py                          |  2 +-
 tests/test_asyncio/test_pubsub.py | 22 +++++++++++++---------
 4 files changed, 28 insertions(+), 18 deletions(-)

diff --git a/CHANGES b/CHANGES
index e83660d6ac..3e4eba44be 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Use asyncio.timeout() instead of async_timeout.timeout() for python >= 3.11 (#2602)
     * Add test and fix async HiredisParser when reading during a disconnect() (#2349)
     * Use hiredis-py pack_command if available.
     * Support `.unlink()` in ClusterPipeline
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 056998e9e0..93db37e46d 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -5,6 +5,7 @@
 import os
 import socket
 import ssl
+import sys
 import threading
 import weakref
 from itertools import chain
@@ -24,7 +25,11 @@
 )
 from urllib.parse import ParseResult, parse_qs, unquote, urlparse
 
-import async_timeout
+if sys.version_info.major >= 3 and sys.version_info.minor >= 11:
+    from asyncio import timeout as async_timeout
+else:
+    from async_timeout import timeout as async_timeout
+
 
 from redis.asyncio.retry import Retry
 from redis.backoff import NoBackoff
@@ -242,7 +247,7 @@ async def can_read_destructive(self) -> bool:
         if self._stream is None:
             raise RedisError("Buffer is closed.")
         try:
-            async with async_timeout.timeout(0):
+            async with async_timeout(0):
                 return await self._stream.read(1)
         except asyncio.TimeoutError:
             return False
@@ -380,7 +385,7 @@ async def can_read_destructive(self):
         if self._reader.gets():
             return True
         try:
-            async with async_timeout.timeout(0):
+            async with async_timeout(0):
                 return await self.read_from_socket()
         except asyncio.TimeoutError:
             return False
@@ -635,7 +640,7 @@ async def connect(self):
 
     async def _connect(self):
         """Create a TCP socket connection"""
-        async with async_timeout.timeout(self.socket_connect_timeout):
+        async with async_timeout(self.socket_connect_timeout):
             reader, writer = await asyncio.open_connection(
                 host=self.host,
                 port=self.port,
@@ -722,7 +727,7 @@ async def on_connect(self) -> None:
     async def disconnect(self, nowait: bool = False) -> None:
         """Disconnects from the Redis server"""
         try:
-            async with async_timeout.timeout(self.socket_connect_timeout):
+            async with async_timeout(self.socket_connect_timeout):
                 self._parser.on_disconnect()
                 if not self.is_connected:
                     return
@@ -827,7 +832,7 @@ async def read_response(
         read_timeout = timeout if timeout is not None else self.socket_timeout
         try:
             if read_timeout is not None:
-                async with async_timeout.timeout(read_timeout):
+                async with async_timeout(read_timeout):
                     response = await self._parser.read_response(
                         disable_decoding=disable_decoding
                     )
@@ -1118,7 +1123,7 @@ def repr_pieces(self) -> Iterable[Tuple[str, Union[str, int]]]:
         return pieces
 
     async def _connect(self):
-        async with async_timeout.timeout(self.socket_connect_timeout):
+        async with async_timeout(self.socket_connect_timeout):
             reader, writer = await asyncio.open_unix_connection(path=self.path)
         self._reader = reader
         self._writer = writer
@@ -1589,7 +1594,7 @@ async def get_connection(self, command_name, *keys, **options):
         # self.timeout then raise a ``ConnectionError``.
         connection = None
         try:
-            async with async_timeout.timeout(self.timeout):
+            async with async_timeout(self.timeout):
                 connection = await self.pool.get()
         except (asyncio.QueueEmpty, asyncio.TimeoutError):
             # Note that this is not caught by the redis client and will be
diff --git a/setup.py b/setup.py
index 060e9da7b0..ceeeb81699 100644
--- a/setup.py
+++ b/setup.py
@@ -34,7 +34,7 @@
     install_requires=[
         'importlib-metadata >= 1.0; python_version < "3.8"',
         'typing-extensions; python_version<"3.8"',
-        "async-timeout>=4.0.2",
+        'async-timeout>=4.0.2; python_version<"3.11"',
     ],
     classifiers=[
         "Development Status :: 5 - Production/Stable",
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index c2a9130e83..0df7847e66 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -5,7 +5,11 @@
 from typing import Optional
 from unittest.mock import patch
 
-import async_timeout
+if sys.version_info.major >= 3 and sys.version_info.minor >= 11:
+    from asyncio import timeout as async_timeout
+else:
+    from async_timeout import timeout as async_timeout
+
 import pytest
 import pytest_asyncio
 
@@ -21,7 +25,7 @@ def with_timeout(t):
     def wrapper(corofunc):
         @functools.wraps(corofunc)
         async def run(*args, **kwargs):
-            async with async_timeout.timeout(t):
+            async with async_timeout(t):
                 return await corofunc(*args, **kwargs)
 
         return run
@@ -648,7 +652,7 @@ async def test_reconnect_listen(self, r: redis.Redis, pubsub):
 
         async def loop():
             # must make sure the task exits
-            async with async_timeout.timeout(2):
+            async with async_timeout(2):
                 nonlocal interrupt
                 await pubsub.subscribe("foo")
                 while True:
@@ -677,7 +681,7 @@ async def loop_step():
 
         task = asyncio.get_running_loop().create_task(loop())
         # get the initial connect message
-        async with async_timeout.timeout(1):
+        async with async_timeout(1):
             message = await messages.get()
         assert message == {
             "channel": b"foo",
@@ -776,7 +780,7 @@ def callback(message):
             if n == 1:
                 break
             await asyncio.sleep(0.1)
-        async with async_timeout.timeout(0.1):
+        async with async_timeout(0.1):
             message = await messages.get()
         task.cancel()
         # we expect a cancelled error, not the Runtime error
@@ -839,7 +843,7 @@ async def test_reconnect_socket_error(self, r: redis.Redis, method):
         Test that a socket error will cause reconnect
         """
         try:
-            async with async_timeout.timeout(self.timeout):
+            async with async_timeout(self.timeout):
                 await self.mysetup(r, method)
                 # now, disconnect the connection, and wait for it to be re-established
                 async with self.cond:
@@ -868,7 +872,7 @@ async def test_reconnect_disconnect(self, r: redis.Redis, method):
         Test that a manual disconnect() will cause reconnect
         """
         try:
-            async with async_timeout.timeout(self.timeout):
+            async with async_timeout(self.timeout):
                 await self.mysetup(r, method)
                 # now, disconnect the connection, and wait for it to be re-established
                 async with self.cond:
@@ -923,7 +927,7 @@ async def loop_step_get_message(self):
     async def loop_step_listen(self):
         # get a single message via listen()
         try:
-            async with async_timeout.timeout(0.1):
+            async with async_timeout(0.1):
                 async for message in self.pubsub.listen():
                     await self.messages.put(message)
                     return True
@@ -947,7 +951,7 @@ async def test_outer_timeout(self, r: redis.Redis):
         assert pubsub.connection.is_connected
 
         async def get_msg_or_timeout(timeout=0.1):
-            async with async_timeout.timeout(timeout):
+            async with async_timeout(timeout):
                 # blocking method to return messages
                 while True:
                     response = await pubsub.parse_response(block=True)

From c61eeb2e3b5dff1f01eb1e665f424c7e75354f56 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 16 Mar 2023 14:13:43 +0200
Subject: [PATCH 0689/1164] Adding supported redis/library details (#2621)

---
 README.md | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 6b53b42f78..e97119a888 100644
--- a/README.md
+++ b/README.md
@@ -13,12 +13,6 @@ The Python interface to the Redis key-value store.
 
 ---------------------------------------------
 
-## Python Notice
-
-redis-py 4.3.x will be the last generation of redis-py to support python 3.6 as it has been [End of Life'd](https://www.python.org/dev/peps/pep-0494/#schedule-last-security-only-release).  Async support was introduced in redis-py 4.2.x thanks to [aioredis](https://github.com/aio-libs/aioredis-py), which necessitates this change. We will continue to maintain 3.6 support as long as possible - but the plan is for redis-py version 4.4+ to officially remove 3.6.
-
----------------------------
-
 ## Installation
 
 Start a redis via docker:
@@ -42,6 +36,18 @@ $ pip install "redis[hiredis]"
 
 Looking for a high-level library to handle object mapping? See [redis-om-python](https://github.com/redis/redis-om-python)!
 
+## Supported Redis Versions
+
+The most recent version of this library supports redis version [5.0](https://github.com/redis/redis/blob/5.0/00-RELEASENOTES), [6.0](https://github.com/redis/redis/blob/6.0/00-RELEASENOTES), [6.2](https://github.com/redis/redis/blob/6.2/00-RELEASENOTES), and [7.0](https://github.com/redis/redis/blob/7.0/00-RELEASENOTES).
+
+The table below higlights version compatibility of the most-recent library versions and redis versions.
+
+| Library version | Supported redis versions |
+|-----------------|-------------------|
+| 3.5.3 | <= 6.2 Family of releases |
+| >= 4.1.0 | Version 5.0 to current |
+
+
 ## Usage
 
 ### Basic Example

From d63313bf6080acaf18d61e072c78303adc0d4166 Mon Sep 17 00:00:00 2001
From: Dongkeun Lee <3315213+zakaf@users.noreply.github.com>
Date: Thu, 16 Mar 2023 22:05:28 +0900
Subject: [PATCH 0690/1164] add queue_class to REDIS_ALLOWED_KEYS (#2577)

* add queue_class to REDIS_ALLOWED_KEYS

* fix lint

* fix lint

---------

Co-authored-by: zach.lee <zach.lee@sendbird.com>
Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/cluster.py      |  1 +
 tests/test_cluster.py | 13 +++++++++++++
 2 files changed, 14 insertions(+)

diff --git a/redis/cluster.py b/redis/cluster.py
index fbda234137..5e6e7da546 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -135,6 +135,7 @@ def parse_cluster_shards(resp, **options):
     "redis_connect_func",
     "password",
     "port",
+    "queue_class",
     "retry",
     "retry_on_timeout",
     "socket_connect_timeout",
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 1bf57a357c..58f9b77d7d 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -1,6 +1,7 @@
 import binascii
 import datetime
 import warnings
+from queue import LifoQueue, Queue
 from time import sleep
 from unittest.mock import DEFAULT, Mock, call, patch
 
@@ -2511,6 +2512,18 @@ def test_connection_pool_class(self, connection_pool_class):
                 node.redis_connection.connection_pool, connection_pool_class
             )
 
+    @pytest.mark.parametrize("queue_class", [Queue, LifoQueue])
+    def test_allow_custom_queue_class(self, queue_class):
+        rc = get_mocked_redis_client(
+            url="redis://my@DNS.com:7000",
+            cluster_slots=default_cluster_slots,
+            connection_pool_class=BlockingConnectionPool,
+            queue_class=queue_class,
+        )
+
+        for node in rc.nodes_manager.nodes_cache.values():
+            assert node.redis_connection.connection_pool.queue_class == queue_class
+
 
 @pytest.mark.onlycluster
 class TestClusterPubSubObject:

From c87172347584301f453c601c483126e4800257b7 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 16 Mar 2023 15:06:07 +0200
Subject: [PATCH 0691/1164] pypy-3.9 CI (#2608)

---
 .github/workflows/integration.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 8d38cd45c7..0f9db8fb1a 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -52,7 +52,7 @@ jobs:
      strategy:
        max-parallel: 15
        matrix:
-         python-version: ['3.7', '3.8', '3.9', '3.10', '3.11', 'pypy-3.7', 'pypy-3.8']
+         python-version: ['3.7', '3.8', '3.9', '3.10', '3.11', 'pypy-3.7', 'pypy-3.8', 'pypy-3.9']
          test-type: ['standalone', 'cluster']
          connection-type: ['hiredis', 'plain']
      env:
@@ -109,7 +109,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.7', '3.8', '3.9', '3.10', '3.11', 'pypy-3.7']
+        python-version: ['3.7', '3.8', '3.9', '3.10', '3.11', 'pypy-3.7', 'pypy-3.8', 'pypy-3.9']
     steps:
       - uses: actions/checkout@v3
       - uses: actions/setup-python@v4

From 7d474f90453c7b90bd06c94e0250b618120a599d Mon Sep 17 00:00:00 2001
From: woutdenolf <wout.de_nolf@esrf.eu>
Date: Thu, 16 Mar 2023 14:08:27 +0100
Subject: [PATCH 0692/1164] introduce AbstractConnection so that
 UnixDomainSocketConnection can call super().__init__ (#2588)

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/connection.py | 278 +++++++++++++++++++-------------------------
 1 file changed, 120 insertions(+), 158 deletions(-)

diff --git a/redis/connection.py b/redis/connection.py
index c4a9685f6a..faea7683f7 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -6,6 +6,7 @@
 import sys
 import threading
 import weakref
+from abc import abstractmethod
 from io import SEEK_END
 from itertools import chain
 from queue import Empty, Full, LifoQueue
@@ -583,20 +584,13 @@ def pack(self, *args):
         return output
 
 
-class Connection:
-    "Manages TCP communication to and from a Redis server"
+class AbstractConnection:
+    "Manages communication to and from a Redis server"
 
     def __init__(
         self,
-        host="localhost",
-        port=6379,
         db=0,
         password=None,
-        socket_timeout=None,
-        socket_connect_timeout=None,
-        socket_keepalive=False,
-        socket_keepalive_options=None,
-        socket_type=0,
         retry_on_timeout=False,
         retry_on_error=SENTINEL,
         encoding="utf-8",
@@ -627,18 +621,11 @@ def __init__(
                 "2. 'credential_provider'"
             )
         self.pid = os.getpid()
-        self.host = host
-        self.port = int(port)
         self.db = db
         self.client_name = client_name
         self.credential_provider = credential_provider
         self.password = password
         self.username = username
-        self.socket_timeout = socket_timeout
-        self.socket_connect_timeout = socket_connect_timeout or socket_timeout
-        self.socket_keepalive = socket_keepalive
-        self.socket_keepalive_options = socket_keepalive_options or {}
-        self.socket_type = socket_type
         self.retry_on_timeout = retry_on_timeout
         if retry_on_error is SENTINEL:
             retry_on_error = []
@@ -671,11 +658,9 @@ def __repr__(self):
         repr_args = ",".join([f"{k}={v}" for k, v in self.repr_pieces()])
         return f"{self.__class__.__name__}<{repr_args}>"
 
+    @abstractmethod
     def repr_pieces(self):
-        pieces = [("host", self.host), ("port", self.port), ("db", self.db)]
-        if self.client_name:
-            pieces.append(("client_name", self.client_name))
-        return pieces
+        pass
 
     def __del__(self):
         try:
@@ -738,75 +723,17 @@ def connect(self):
             if callback:
                 callback(self)
 
+    @abstractmethod
     def _connect(self):
-        "Create a TCP socket connection"
-        # we want to mimic what socket.create_connection does to support
-        # ipv4/ipv6, but we want to set options prior to calling
-        # socket.connect()
-        err = None
-        for res in socket.getaddrinfo(
-            self.host, self.port, self.socket_type, socket.SOCK_STREAM
-        ):
-            family, socktype, proto, canonname, socket_address = res
-            sock = None
-            try:
-                sock = socket.socket(family, socktype, proto)
-                # TCP_NODELAY
-                sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)
-
-                # TCP_KEEPALIVE
-                if self.socket_keepalive:
-                    sock.setsockopt(socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1)
-                    for k, v in self.socket_keepalive_options.items():
-                        sock.setsockopt(socket.IPPROTO_TCP, k, v)
-
-                # set the socket_connect_timeout before we connect
-                sock.settimeout(self.socket_connect_timeout)
-
-                # connect
-                sock.connect(socket_address)
-
-                # set the socket_timeout now that we're connected
-                sock.settimeout(self.socket_timeout)
-                return sock
-
-            except OSError as _:
-                err = _
-                if sock is not None:
-                    sock.close()
-
-        if err is not None:
-            raise err
-        raise OSError("socket.getaddrinfo returned an empty list")
+        pass
 
+    @abstractmethod
     def _host_error(self):
-        try:
-            host_error = f"{self.host}:{self.port}"
-        except AttributeError:
-            host_error = "connection"
-
-        return host_error
+        pass
 
+    @abstractmethod
     def _error_message(self, exception):
-        # args for socket.error can either be (errno, "message")
-        # or just "message"
-
-        host_error = self._host_error()
-
-        if len(exception.args) == 1:
-            try:
-                return f"Error connecting to {host_error}. \
-                        {exception.args[0]}."
-            except AttributeError:
-                return f"Connection Error: {exception.args[0]}"
-        else:
-            try:
-                return (
-                    f"Error {exception.args[0]} connecting to "
-                    f"{host_error}. {exception.args[1]}."
-                )
-            except AttributeError:
-                return f"Connection Error: {exception.args[0]}"
+        pass
 
     def on_connect(self):
         "Initialize the connection, authenticate and select a database"
@@ -990,6 +917,101 @@ def pack_commands(self, commands):
         return output
 
 
+class Connection(AbstractConnection):
+    "Manages TCP communication to and from a Redis server"
+
+    def __init__(
+        self,
+        host="localhost",
+        port=6379,
+        socket_timeout=None,
+        socket_connect_timeout=None,
+        socket_keepalive=False,
+        socket_keepalive_options=None,
+        socket_type=0,
+        **kwargs,
+    ):
+        self.host = host
+        self.port = int(port)
+        self.socket_timeout = socket_timeout
+        self.socket_connect_timeout = socket_connect_timeout or socket_timeout
+        self.socket_keepalive = socket_keepalive
+        self.socket_keepalive_options = socket_keepalive_options or {}
+        self.socket_type = socket_type
+        super().__init__(**kwargs)
+
+    def repr_pieces(self):
+        pieces = [("host", self.host), ("port", self.port), ("db", self.db)]
+        if self.client_name:
+            pieces.append(("client_name", self.client_name))
+        return pieces
+
+    def _connect(self):
+        "Create a TCP socket connection"
+        # we want to mimic what socket.create_connection does to support
+        # ipv4/ipv6, but we want to set options prior to calling
+        # socket.connect()
+        err = None
+        for res in socket.getaddrinfo(
+            self.host, self.port, self.socket_type, socket.SOCK_STREAM
+        ):
+            family, socktype, proto, canonname, socket_address = res
+            sock = None
+            try:
+                sock = socket.socket(family, socktype, proto)
+                # TCP_NODELAY
+                sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)
+
+                # TCP_KEEPALIVE
+                if self.socket_keepalive:
+                    sock.setsockopt(socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1)
+                    for k, v in self.socket_keepalive_options.items():
+                        sock.setsockopt(socket.IPPROTO_TCP, k, v)
+
+                # set the socket_connect_timeout before we connect
+                sock.settimeout(self.socket_connect_timeout)
+
+                # connect
+                sock.connect(socket_address)
+
+                # set the socket_timeout now that we're connected
+                sock.settimeout(self.socket_timeout)
+                return sock
+
+            except OSError as _:
+                err = _
+                if sock is not None:
+                    sock.close()
+
+        if err is not None:
+            raise err
+        raise OSError("socket.getaddrinfo returned an empty list")
+
+    def _host_error(self):
+        return f"{self.host}:{self.port}"
+
+    def _error_message(self, exception):
+        # args for socket.error can either be (errno, "message")
+        # or just "message"
+
+        host_error = self._host_error()
+
+        if len(exception.args) == 1:
+            try:
+                return f"Error connecting to {host_error}. \
+                        {exception.args[0]}."
+            except AttributeError:
+                return f"Connection Error: {exception.args[0]}"
+        else:
+            try:
+                return (
+                    f"Error {exception.args[0]} connecting to "
+                    f"{host_error}. {exception.args[1]}."
+                )
+            except AttributeError:
+                return f"Connection Error: {exception.args[0]}"
+
+
 class SSLConnection(Connection):
     """Manages SSL connections to and from the Redis server(s).
     This class extends the Connection class, adding SSL functionality, and making
@@ -1035,8 +1057,6 @@ def __init__(
         if not ssl_available:
             raise RedisError("Python wasn't built with SSL support")
 
-        super().__init__(**kwargs)
-
         self.keyfile = ssl_keyfile
         self.certfile = ssl_certfile
         if ssl_cert_reqs is None:
@@ -1062,6 +1082,7 @@ def __init__(
         self.ssl_validate_ocsp_stapled = ssl_validate_ocsp_stapled
         self.ssl_ocsp_context = ssl_ocsp_context
         self.ssl_ocsp_expected_cert = ssl_ocsp_expected_cert
+        super().__init__(**kwargs)
 
     def _connect(self):
         "Wrap the socket with SSL support"
@@ -1131,77 +1152,12 @@ def _connect(self):
         return sslsock
 
 
-class UnixDomainSocketConnection(Connection):
-    def __init__(
-        self,
-        path="",
-        db=0,
-        username=None,
-        password=None,
-        socket_timeout=None,
-        encoding="utf-8",
-        encoding_errors="strict",
-        decode_responses=False,
-        retry_on_timeout=False,
-        retry_on_error=SENTINEL,
-        parser_class=DefaultParser,
-        socket_read_size=65536,
-        health_check_interval=0,
-        client_name=None,
-        retry=None,
-        redis_connect_func=None,
-        credential_provider: Optional[CredentialProvider] = None,
-        command_packer=None,
-    ):
-        """
-        Initialize a new UnixDomainSocketConnection.
-        To specify a retry policy for specific errors, first set
-        `retry_on_error` to a list of the error/s to retry on, then set
-        `retry` to a valid `Retry` object.
-        To retry on TimeoutError, `retry_on_timeout` can also be set to `True`.
-        """
-        if (username or password) and credential_provider is not None:
-            raise DataError(
-                "'username' and 'password' cannot be passed along with 'credential_"
-                "provider'. Please provide only one of the following arguments: \n"
-                "1. 'password' and (optional) 'username'\n"
-                "2. 'credential_provider'"
-            )
-        self.pid = os.getpid()
+class UnixDomainSocketConnection(AbstractConnection):
+    "Manages UDS communication to and from a Redis server"
+
+    def __init__(self, path="", **kwargs):
         self.path = path
-        self.db = db
-        self.client_name = client_name
-        self.credential_provider = credential_provider
-        self.password = password
-        self.username = username
-        self.socket_timeout = socket_timeout
-        self.retry_on_timeout = retry_on_timeout
-        if retry_on_error is SENTINEL:
-            retry_on_error = []
-        if retry_on_timeout:
-            # Add TimeoutError to the errors list to retry on
-            retry_on_error.append(TimeoutError)
-        self.retry_on_error = retry_on_error
-        if self.retry_on_error:
-            if retry is None:
-                self.retry = Retry(NoBackoff(), 1)
-            else:
-                # deep-copy the Retry object as it is mutable
-                self.retry = copy.deepcopy(retry)
-            # Update the retry's supported errors with the specified errors
-            self.retry.update_supported_errors(retry_on_error)
-        else:
-            self.retry = Retry(NoBackoff(), 0)
-        self.health_check_interval = health_check_interval
-        self.next_health_check = 0
-        self.redis_connect_func = redis_connect_func
-        self.encoder = Encoder(encoding, encoding_errors, decode_responses)
-        self._sock = None
-        self._socket_read_size = socket_read_size
-        self.set_parser(parser_class)
-        self._connect_callbacks = []
-        self._buffer_cutoff = 6000
-        self._command_packer = self._construct_command_packer(command_packer)
+        super().__init__(**kwargs)
 
     def repr_pieces(self):
         pieces = [("path", self.path), ("db", self.db)]
@@ -1216,15 +1172,21 @@ def _connect(self):
         sock.connect(self.path)
         return sock
 
+    def _host_error(self):
+        return self.path
+
     def _error_message(self, exception):
         # args for socket.error can either be (errno, "message")
         # or just "message"
+        host_error = self._host_error()
         if len(exception.args) == 1:
-            return f"Error connecting to unix socket: {self.path}. {exception.args[0]}."
+            return (
+                f"Error connecting to unix socket: {host_error}. {exception.args[0]}."
+            )
         else:
             return (
                 f"Error {exception.args[0]} connecting to unix socket: "
-                f"{self.path}. {exception.args[1]}."
+                f"{host_error}. {exception.args[1]}."
             )
 
 

From 1b2f408259405d412d7530291902f9e0c8bd34b3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Thu, 16 Mar 2023 14:23:40 +0000
Subject: [PATCH 0693/1164] Fix behaviour of async PythonParser to match
 RedisParser as for issue #2349 (#2582)

* Allow data to drain from PythonParser after connection close.

* Add Changes
---
 CHANGES                               |  1 +
 redis/asyncio/connection.py           | 24 +++++++++++-------------
 tests/test_asyncio/test_connection.py |  2 --
 3 files changed, 12 insertions(+), 15 deletions(-)

diff --git a/CHANGES b/CHANGES
index 3e4eba44be..b0744c6038 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Allow data to drain from async PythonParser when reading during a disconnect()
     * Use asyncio.timeout() instead of async_timeout.timeout() for python >= 3.11 (#2602)
     * Add test and fix async HiredisParser when reading during a disconnect() (#2349)
     * Use hiredis-py pack_command if available.
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 93db37e46d..057067a83e 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -146,7 +146,7 @@ def decode(self, value: EncodableT, force=False) -> EncodableT:
 class BaseParser:
     """Plain Python parsing class"""
 
-    __slots__ = "_stream", "_read_size"
+    __slots__ = "_stream", "_read_size", "_connected"
 
     EXCEPTION_CLASSES: ExceptionMappingT = {
         "ERR": {
@@ -177,6 +177,7 @@ class BaseParser:
     def __init__(self, socket_read_size: int):
         self._stream: Optional[asyncio.StreamReader] = None
         self._read_size = socket_read_size
+        self._connected = False
 
     def __del__(self):
         try:
@@ -213,7 +214,7 @@ async def read_response(
 class PythonParser(BaseParser):
     """Plain Python parsing class"""
 
-    __slots__ = BaseParser.__slots__ + ("encoder", "_buffer", "_pos", "_chunks")
+    __slots__ = ("encoder", "_buffer", "_pos", "_chunks")
 
     def __init__(self, socket_read_size: int):
         super().__init__(socket_read_size)
@@ -231,21 +232,19 @@ def on_connect(self, connection: "Connection"):
         self._stream = connection._reader
         if self._stream is None:
             raise RedisError("Buffer is closed.")
-
         self.encoder = connection.encoder
+        self._clear()
+        self._connected = True
 
     def on_disconnect(self):
         """Called when the stream disconnects"""
-        if self._stream is not None:
-            self._stream = None
-        self.encoder = None
-        self._clear()
+        self._connected = False
 
     async def can_read_destructive(self) -> bool:
+        if not self._connected:
+            raise RedisError("Buffer is closed.")
         if self._buffer:
             return True
-        if self._stream is None:
-            raise RedisError("Buffer is closed.")
         try:
             async with async_timeout(0):
                 return await self._stream.read(1)
@@ -253,6 +252,8 @@ async def can_read_destructive(self) -> bool:
             return False
 
     async def read_response(self, disable_decoding: bool = False):
+        if not self._connected:
+            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
         if self._chunks:
             # augment parsing buffer with previously read data
             self._buffer += b"".join(self._chunks)
@@ -266,8 +267,6 @@ async def read_response(self, disable_decoding: bool = False):
     async def _read_response(
         self, disable_decoding: bool = False
     ) -> Union[EncodableT, ResponseError, None]:
-        if not self._stream or not self.encoder:
-            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
         raw = await self._readline()
         response: Any
         byte, response = raw[:1], raw[1:]
@@ -354,14 +353,13 @@ async def _readline(self) -> bytes:
 class HiredisParser(BaseParser):
     """Parser class for connections using Hiredis"""
 
-    __slots__ = BaseParser.__slots__ + ("_reader", "_connected")
+    __slots__ = ("_reader",)
 
     def __init__(self, socket_read_size: int):
         if not HIREDIS_AVAILABLE:
             raise RedisError("Hiredis is not available.")
         super().__init__(socket_read_size=socket_read_size)
         self._reader: Optional[hiredis.Reader] = None
-        self._connected: bool = False
 
     def on_connect(self, connection: "Connection"):
         self._stream = connection._reader
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index 1851ca9a76..e2d77fc1c3 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -211,8 +211,6 @@ async def test_connection_disconect_race(parser_class):
     This test verifies that a read in progress can finish even
     if the `disconnect()` method is called.
     """
-    if parser_class == PythonParser:
-        pytest.xfail("doesn't work yet with PythonParser")
     if parser_class == HiredisParser and not HIREDIS_AVAILABLE:
         pytest.skip("Hiredis not available")
 

From 318b114f4da9846a2a7c150e1fb702e9bebd9fdf Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 20 Mar 2023 10:59:18 +0200
Subject: [PATCH 0694/1164] Version 4.5.2 (#2627)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index ceeeb81699..a0710d3b73 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.5.1",
+    version="4.5.2",
     packages=find_packages(
         include=[
             "redis",

From 66a4d6b2a493dd3a20cc299ab5fef3c14baad965 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 22 Mar 2023 18:03:50 +0200
Subject: [PATCH 0695/1164] AsyncIO Race Condition Fix (#2641)

---
 redis/asyncio/client.py               |  12 +-
 redis/asyncio/cluster.py              |  12 +-
 setup.py                              |   2 +-
 tests/asynctests                      | 285 +++++++++++++++++
 tests/synctests                       | 421 ++++++++++++++++++++++++++
 tests/test_asyncio/test_cluster.py    |  17 ++
 tests/test_asyncio/test_connection.py |  21 ++
 7 files changed, 764 insertions(+), 6 deletions(-)
 create mode 100644 tests/asynctests
 create mode 100644 tests/synctests

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 3fc7fad83e..9e16ee08de 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -1385,10 +1385,16 @@ async def execute(self, raise_on_error: bool = True):
         conn = cast(Connection, conn)
 
         try:
-            return await conn.retry.call_with_retry(
-                lambda: execute(conn, stack, raise_on_error),
-                lambda error: self._disconnect_raise_reset(conn, error),
+            return await asyncio.shield(
+                conn.retry.call_with_retry(
+                    lambda: execute(conn, stack, raise_on_error),
+                    lambda error: self._disconnect_raise_reset(conn, error),
+                )
             )
+        except asyncio.CancelledError:
+            # not supposed to be possible, yet here we are
+            await conn.disconnect(nowait=True)
+            raise
         finally:
             await self.reset()
 
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 5a2dffdd1d..569a0765f8 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -1002,10 +1002,18 @@ async def execute_command(self, *args: Any, **kwargs: Any) -> Any:
         await connection.send_packed_command(connection.pack_command(*args), False)
 
         # Read response
+        return await asyncio.shield(
+            self._parse_and_release(connection, args[0], **kwargs)
+        )
+
+    async def _parse_and_release(self, connection, *args, **kwargs):
         try:
-            return await self.parse_response(connection, args[0], **kwargs)
+            return await self.parse_response(connection, *args, **kwargs)
+        except asyncio.CancelledError:
+            # should not be possible
+            await connection.disconnect(nowait=True)
+            raise
         finally:
-            # Release connection
             self._free.append(connection)
 
     async def execute_pipeline(self, commands: List["PipelineCommand"]) -> bool:
diff --git a/setup.py b/setup.py
index a0710d3b73..3003c59420 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.5.2",
+    version="4.5.3",
     packages=find_packages(
         include=[
             "redis",
diff --git a/tests/asynctests b/tests/asynctests
new file mode 100644
index 0000000000..4f0fea9223
--- /dev/null
+++ b/tests/asynctests
@@ -0,0 +1,285 @@
+test_response_callbacks
+test_case_insensitive_command_names
+test_command_on_invalid_key_type
+test_acl_cat_no_category
+test_acl_cat_with_category
+test_acl_deluser
+test_acl_genpass
+test_acl_getuser_setuser
+test_acl_list
+test_acl_log
+test_acl_setuser_categories_without_prefix_fails
+test_acl_setuser_commands_without_prefix_fails
+test_acl_setuser_add_passwords_and_nopass_fails
+test_acl_users
+test_acl_whoami
+test_client_list
+test_client_list_type
+test_client_id
+test_client_unblock
+test_client_getname
+test_client_setname
+test_client_kill
+test_client_kill_filter_invalid_params
+test_client_kill_filter_by_id
+test_client_kill_filter_by_addr
+test_client_list_after_client_setname
+test_client_pause
+test_config_get
+test_config_resetstat
+test_config_set
+test_dbsize
+test_echo
+test_info
+test_lastsave
+test_object
+test_ping
+test_slowlog_get
+test_slowlog_get_limit
+test_slowlog_length
+test_time
+test_never_decode_option
+test_empty_response_option
+test_append
+test_bitcount
+test_bitop_not_empty_string
+test_bitop_not
+test_bitop_not_in_place
+test_bitop_single_string
+test_bitop_string_operands
+test_bitpos
+test_bitpos_wrong_arguments
+test_decr
+test_decrby
+test_delete
+test_delete_with_multiple_keys
+test_delitem
+test_unlink
+test_unlink_with_multiple_keys
+test_dump_and_restore
+test_dump_and_restore_and_replace
+test_dump_and_restore_absttl
+test_exists
+test_exists_contains
+test_expire
+test_expireat_datetime
+test_expireat_no_key
+test_expireat_unixtime
+test_get_and_set
+test_get_set_bit
+test_getrange
+test_getset
+test_incr
+test_incrby
+test_incrbyfloat
+test_keys
+test_mget
+test_mset
+test_msetnx
+test_pexpire
+test_pexpireat_datetime
+test_pexpireat_no_key
+test_pexpireat_unixtime
+test_psetex
+test_psetex_timedelta
+test_pttl
+test_pttl_no_key
+test_randomkey
+test_rename
+test_renamenx
+test_set_nx
+test_set_xx
+test_set_px
+test_set_px_timedelta
+test_set_ex
+test_set_ex_timedelta
+test_set_multipleoptions
+test_set_keepttl
+test_setex
+test_setnx
+test_setrange
+test_strlen
+test_substr
+test_ttl
+test_ttl_nokey
+test_type
+test_blpop
+test_brpop
+test_brpoplpush
+test_brpoplpush_empty_string
+test_lindex
+test_linsert
+test_llen
+test_lpop
+test_lpush
+test_lpushx
+test_lrange
+test_lrem
+test_lset
+test_ltrim
+test_rpop
+test_rpoplpush
+test_rpush
+test_lpos
+test_rpushx
+test_scan
+test_scan_type
+test_scan_iter
+test_sscan
+test_sscan_iter
+test_hscan
+test_hscan_iter
+test_zscan
+test_zscan_iter
+test_sadd
+test_scard
+test_sdiff
+test_sdiffstore
+test_sinter
+test_sinterstore
+test_sismember
+test_smembers
+test_smove
+test_spop
+test_spop_multi_value
+test_srandmember
+test_srandmember_multi_value
+test_srem
+test_sunion
+test_sunionstore
+test_zadd
+test_zadd_nx
+test_zadd_xx
+test_zadd_ch
+test_zadd_incr
+test_zadd_incr_with_xx
+test_zcard
+test_zcount
+test_zincrby
+test_zlexcount
+test_zinterstore_sum
+test_zinterstore_max
+test_zinterstore_min
+test_zinterstore_with_weight
+test_zpopmax
+test_zpopmin
+test_bzpopmax
+test_bzpopmin
+test_zrange
+test_zrangebylex
+test_zrevrangebylex
+test_zrangebyscore
+test_zrank
+test_zrem
+test_zrem_multiple_keys
+test_zremrangebylex
+test_zremrangebyrank
+test_zremrangebyscore
+test_zrevrange
+test_zrevrangebyscore
+test_zrevrank
+test_zscore
+test_zunionstore_sum
+test_zunionstore_max
+test_zunionstore_min
+test_zunionstore_with_weight
+test_pfadd
+test_pfcount
+test_pfmerge
+test_hget_and_hset
+test_hset_with_multi_key_values
+test_hset_without_data
+test_hdel
+test_hexists
+test_hgetall
+test_hincrby
+test_hincrbyfloat
+test_hkeys
+test_hlen
+test_hmget
+test_hmset
+test_hsetnx
+test_hvals
+test_hstrlen
+test_sort_basic
+test_sort_limited
+test_sort_by
+test_sort_get
+test_sort_get_multi
+test_sort_get_groups_two
+test_sort_groups_string_get
+test_sort_groups_just_one_get
+test_sort_groups_no_get
+test_sort_groups_three_gets
+test_sort_desc
+test_sort_alpha
+test_sort_store
+test_sort_all_options
+test_sort_issue_924
+test_cluster_addslots
+test_cluster_count_failure_reports
+test_cluster_countkeysinslot
+test_cluster_delslots
+test_cluster_failover
+test_cluster_forget
+test_cluster_info
+test_cluster_keyslot
+test_cluster_meet
+test_cluster_nodes
+test_cluster_replicate
+test_cluster_reset
+test_cluster_saveconfig
+test_cluster_setslot
+test_cluster_slaves
+test_readwrite
+test_readonly_invalid_cluster_state
+test_readonly
+test_geoadd
+test_geoadd_invalid_params
+test_geodist
+test_geodist_units
+test_geodist_missing_one_member
+test_geodist_invalid_units
+test_geohash
+test_geopos
+test_geopos_no_value
+test_old_geopos_no_value
+test_georadius
+test_georadius_no_values
+test_georadius_units
+test_georadius_with
+test_georadius_count
+test_georadius_sort
+test_georadius_store
+test_georadius_store_dist
+test_georadiusmember
+test_xack
+test_xadd
+test_xclaim
+test_xclaim_trimmed
+test_xdel
+test_xgroup_create
+test_xgroup_create_mkstream
+test_xgroup_delconsumer
+test_xgroup_destroy
+test_xgroup_setid
+test_xinfo_consumers
+test_xinfo_stream
+test_xlen
+test_xpending
+test_xpending_range
+test_xrange
+test_xread
+test_xreadgroup
+test_xrevrange
+test_xtrim
+test_bitfield_operations
+test_bitfield_ro
+test_memory_stats
+test_memory_usage
+test_module_list
+test_binary_get_set
+test_binary_lists
+test_22_info
+test_large_responses
+test_floating_point_encoding
diff --git a/tests/synctests b/tests/synctests
new file mode 100644
index 0000000000..b0de2d1ba9
--- /dev/null
+++ b/tests/synctests
@@ -0,0 +1,421 @@
+test_response_callbacks
+test_case_insensitive_command_names
+test_auth
+test_command_on_invalid_key_type
+test_acl_cat_no_category
+test_acl_cat_with_category
+test_acl_dryrun
+test_acl_deluser
+test_acl_genpass
+test_acl_getuser_setuser
+test_acl_help
+test_acl_list
+test_acl_log
+test_acl_setuser_categories_without_prefix_fails
+test_acl_setuser_commands_without_prefix_fails
+test_acl_setuser_add_passwords_and_nopass_fails
+test_acl_users
+test_acl_whoami
+test_client_list
+test_client_info
+test_client_list_types_not_replica
+test_client_list_replica
+test_client_list_client_id
+test_client_id
+test_client_trackinginfo
+test_client_tracking
+test_client_unblock
+test_client_getname
+test_client_setname
+test_client_kill
+test_client_kill_filter_invalid_params
+test_client_kill_filter_by_id
+test_client_kill_filter_by_addr
+test_client_list_after_client_setname
+test_client_kill_filter_by_laddr
+test_client_kill_filter_by_user
+test_client_pause
+test_client_pause_all
+test_client_unpause
+test_client_no_evict
+test_client_reply
+test_client_getredir
+test_hello_notI_implemented
+test_config_get
+test_config_get_multi_params
+test_config_resetstat
+test_config_set
+test_config_set_multi_params
+test_failover
+test_dbsize
+test_echo
+test_info
+test_info_multi_sections
+test_lastsave
+test_lolwut
+test_reset
+test_object
+test_ping
+test_quit
+test_role
+test_select
+test_slowlog_get
+test_slowlog_get_limit
+test_slowlog_length
+test_time
+test_bgsave
+test_never_decode_option
+test_empty_response_option
+test_append
+test_bitcount
+test_bitcount_mode
+test_bitop_not_empty_string
+test_bitop_not
+test_bitop_not_in_place
+test_bitop_single_string
+test_bitop_string_operands
+test_bitpos
+test_bitpos_wrong_arguments
+test_bitpos_mode
+test_copy
+test_copy_and_replace
+test_copy_to_another_database
+test_decr
+test_decrby
+test_delete
+test_delete_with_multiple_keys
+test_delitem
+test_unlink
+test_unlink_with_multiple_keys
+test_lcs
+test_dump_and_restore
+test_dump_and_restore_and_replace
+test_dump_and_restore_absttl
+test_exists
+test_exists_contains
+test_expire
+test_expire_option_nx
+test_expire_option_xx
+test_expire_option_gt
+test_expire_option_lt
+test_expireat_datetime
+test_expireat_no_key
+test_expireat_unixtime
+test_expiretime
+test_expireat_option_nx
+test_expireat_option_xx
+test_expireat_option_gt
+test_expireat_option_lt
+test_get_and_set
+test_getdel
+test_getex
+test_getitem_and_setitem
+test_getitem_raises_keyerror_for_missing_key
+test_getitem_does_not_raise_keyerror_for_empty_string
+test_get_set_bit
+test_getrange
+test_getset
+test_incr
+test_incrby
+test_incrbyfloat
+test_keys
+test_mget
+test_lmove
+test_blmove
+test_mset
+test_msetnx
+test_pexpire
+test_pexpire_option_nx
+test_pexpire_option_xx
+test_pexpire_option_gt
+test_pexpire_option_lt
+test_pexpireat_datetime
+test_pexpireat_no_key
+test_pexpireat_unixtime
+test_pexpireat_option_nx
+test_pexpireat_option_xx
+test_pexpireat_option_gt
+test_pexpireat_option_lt
+test_pexpiretime
+test_psetex
+test_psetex_timedelta
+test_pttl
+test_pttl_no_key
+test_hrandfield
+test_randomkey
+test_rename
+test_renamenx
+test_set_nx
+test_set_xx
+test_set_px
+test_set_px_timedelta
+test_set_ex
+test_set_ex_str
+test_set_ex_timedelta
+test_set_exat_timedelta
+test_set_pxat_timedelta
+test_set_multipleoptions
+test_set_keepttl
+test_set_get
+test_setex
+test_setnx
+test_setrange
+test_stralgo_lcs
+test_stralgo_negative
+test_strlen
+test_substr
+test_ttl
+test_ttl_nokey
+test_type
+test_blpop
+test_brpop
+test_brpoplpush
+test_brpoplpush_empty_string
+test_blmpop
+test_lmpop
+test_lindex
+test_linsert
+test_llen
+test_lpop
+test_lpop_count
+test_lpush
+test_lpushx
+test_lpushx_with_list
+test_lrange
+test_lrem
+test_lset
+test_ltrim
+test_rpop
+test_rpop_count
+test_rpoplpush
+test_rpush
+test_lpos
+test_rpushx
+test_scan
+test_scan_type
+test_scan_iter
+test_sscan
+test_sscan_iter
+test_hscan
+test_hscan_iter
+test_zscan
+test_zscan_iter
+test_sadd
+test_scard
+test_sdiff
+test_sdiffstore
+test_sinter
+test_sintercard
+test_sinterstore
+test_sismember
+test_smembers
+test_smismember
+test_smove
+test_spop
+test_spop_multi_value
+test_srandmember
+test_srandmember_multi_value
+test_srem
+test_sunion
+test_sunionstore
+test_debug_segfault
+test_script_debug
+test_zadd
+test_zadd_nx
+test_zadd_xx
+test_zadd_ch
+test_zadd_incr
+test_zadd_incr_with_xx
+test_zadd_gt_lt
+test_zcard
+test_zcount
+test_zdiff
+test_zdiffstore
+test_zincrby
+test_zlexcount
+test_zinter
+test_zintercard
+test_zinterstore_sum
+test_zinterstore_max
+test_zinterstore_min
+test_zinterstore_with_weight
+test_zpopmax
+test_zpopmin
+test_zrandemember
+test_bzpopmax
+test_bzpopmin
+test_zmpop
+test_bzmpop
+test_zrange
+test_zrange_errors
+test_zrange_params
+test_zrangestore
+test_zrangebylex
+test_zrevrangebylex
+test_zrangebyscore
+test_zrank
+test_zrem
+test_zrem_multiple_keys
+test_zremrangebylex
+test_zremrangebyrank
+test_zremrangebyscore
+test_zrevrange
+test_zrevrangebyscore
+test_zrevrank
+test_zscore
+test_zunion
+test_zunionstore_sum
+test_zunionstore_max
+test_zunionstore_min
+test_zunionstore_with_weight
+test_zmscore
+test_pfadd
+test_pfcount
+test_pfmerge
+test_hget_and_hset
+test_hset_with_multi_key_values
+test_hset_with_key_values_passed_as_list
+test_hset_without_data
+test_hdel
+test_hexists
+test_hgetall
+test_hincrby
+test_hincrbyfloat
+test_hkeys
+test_hlen
+test_hmget
+test_hmset
+test_hsetnx
+test_hvals
+test_hstrlen
+test_sort_basic
+test_sort_limited
+test_sort_by
+test_sort_get
+test_sort_get_multi
+test_sort_get_groups_two
+test_sort_groups_string_get
+test_sort_groups_just_one_get
+test_sort_groups_no_get
+test_sort_groups_three_gets
+test_sort_desc
+test_sort_alpha
+test_sort_store
+test_sort_all_options
+test_sort_ro
+test_sort_issue_924
+test_cluster_addslots
+test_cluster_count_failure_reports
+test_cluster_countkeysinslot
+test_cluster_delslots
+test_cluster_failover
+test_cluster_forget
+test_cluster_info
+test_cluster_keyslot
+test_cluster_meet
+test_cluster_nodes
+test_cluster_replicate
+test_cluster_reset
+test_cluster_saveconfig
+test_cluster_setslot
+test_cluster_slaves
+test_readwrite
+test_readonly_invalid_cluster_state
+test_readonly
+test_geoadd
+test_geoadd_nx
+test_geoadd_xx
+test_geoadd_ch
+test_geoadd_invalid_params
+test_geodist
+test_geodist_units
+test_geodist_missing_one_member
+test_geodist_invalid_units
+test_geohash
+test_geopos
+test_geopos_no_value
+test_old_geopos_no_value
+test_geosearch
+test_geosearch_member
+test_geosearch_sort
+test_geosearch_with
+test_geosearch_negative
+test_geosearchstore
+test_geosearchstore_dist
+test_georadius
+test_georadius_no_values
+test_georadius_units
+test_georadius_with
+test_georadius_count
+test_georadius_sort
+test_georadius_store
+test_georadius_store_dist
+test_georadiusmember
+test_georadiusmember_count
+test_xack
+test_xadd
+test_xadd_nomkstream
+test_xadd_minlen_and_limit
+test_xadd_explicit_ms
+test_xautoclaim
+test_xautoclaim_negative
+test_xclaim
+test_xclaim_trimmed
+test_xdel
+test_xgroup_create
+test_xgroup_create_mkstream
+test_xgroup_create_entriesread
+test_xgroup_delconsumer
+test_xgroup_createconsumer
+test_xgroup_destroy
+test_xgroup_setid
+test_xinfo_consumers
+test_xinfo_stream
+test_xinfo_stream_full
+test_xlen
+test_xpending
+test_xpending_range
+test_xpending_range_idle
+test_xpending_range_negative
+test_xrange
+test_xread
+test_xreadgroup
+test_xrevrange
+test_xtrim
+test_xtrim_minlen_and_length_args
+test_bitfield_operations
+test
+test_bitfield_ro
+test_memory_help
+test_memory_doctor
+test_memory_malloc_stats
+test_memory_stats
+test_memory_usage
+test_latency_histogram_not_implemented
+test_latency_graph_not_implemented
+test_latency_doctor_not_implemented
+test_latency_history
+test_latency_latest
+test_latency_reset
+test_module_list
+test_command_count
+test_command_docs
+test_command_list
+test_command_getkeys
+test_command
+test_command_getkeysandflags
+test_module
+test_module_loadex
+test_restore
+test_restore_idletime
+test_restore_frequency
+test_replicaof
+test_shutdown
+test_shutdown_with_params
+test_sync
+test_psync
+test_binary_get_set
+test_binary_lists
+test_22_info
+test_large_responses
+test_floating_point_encoding
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 13e5e26ae3..0857c056c2 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -340,6 +340,23 @@ async def test_from_url(self, request: FixtureRequest) -> None:
         rc = RedisCluster.from_url("rediss://localhost:16379")
         assert rc.connection_kwargs["connection_class"] is SSLConnection
 
+    async def test_asynckills(self, r) -> None:
+
+        await r.set("foo", "foo")
+        await r.set("bar", "bar")
+
+        t = asyncio.create_task(r.get("foo"))
+        await asyncio.sleep(1)
+        t.cancel()
+        try:
+            await t
+        except asyncio.CancelledError:
+            pytest.fail("connection is left open with unread response")
+
+        assert await r.get("bar") == b"bar"
+        assert await r.ping()
+        assert await r.get("foo") == b"foo"
+
     async def test_max_connections(
         self, create_redis: Callable[..., RedisCluster]
     ) -> None:
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index e2d77fc1c3..d3b6285cfb 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -44,6 +44,27 @@ async def test_invalid_response(create_redis):
     await r.connection.disconnect()
 
 
+async def test_asynckills():
+
+    for b in [True, False]:
+        r = Redis(single_connection_client=b)
+
+        await r.set("foo", "foo")
+        await r.set("bar", "bar")
+
+        t = asyncio.create_task(r.get("foo"))
+        await asyncio.sleep(1)
+        t.cancel()
+        try:
+            await t
+        except asyncio.CancelledError:
+            pytest.fail("connection left open with unread response")
+
+        assert await r.get("bar") == b"bar"
+        assert await r.ping()
+        assert await r.get("foo") == b"foo"
+
+
 @pytest.mark.onlynoncluster
 async def test_single_connection():
     """Test that concurrent requests on a single client are synchronised."""

From 480253037afe4c12e38a0f98cadd3019a3724254 Mon Sep 17 00:00:00 2001
From: Thiago Bellini Ribeiro <hackedbellini@gmail.com>
Date: Mon, 27 Mar 2023 18:32:44 -0300
Subject: [PATCH 0696/1164] fix: do not use asyncio's timeout lib before 3.11.2
 (#2659)

There's an issue in asyncio's timeout lib before 3.11.3 that causes
async calls to raise `CancelledError`.

This is a cpython issue that was fixed in this commit [1] and
cherry-picked to previous versions, meaning 3.11.3 will work correctly.

Check [2] for more info.

[1] https://github.com/python/cpython/commit/04adf2df395ded81922c71360a5d66b597471e49
[2] https://github.com/redis/redis-py/issues/2633
---
 redis/asyncio/connection.py       | 4 +++-
 setup.py                          | 2 +-
 tests/test_asyncio/test_pubsub.py | 4 +++-
 3 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 057067a83e..58dcd66efb 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -25,7 +25,9 @@
 )
 from urllib.parse import ParseResult, parse_qs, unquote, urlparse
 
-if sys.version_info.major >= 3 and sys.version_info.minor >= 11:
+# the functionality is available in 3.11.x but has a major issue before
+# 3.11.3. See https://github.com/redis/redis-py/issues/2633
+if sys.version_info >= (3, 11, 3):
     from asyncio import timeout as async_timeout
 else:
     from async_timeout import timeout as async_timeout
diff --git a/setup.py b/setup.py
index 3003c59420..3b7347da03 100644
--- a/setup.py
+++ b/setup.py
@@ -34,7 +34,7 @@
     install_requires=[
         'importlib-metadata >= 1.0; python_version < "3.8"',
         'typing-extensions; python_version<"3.8"',
-        'async-timeout>=4.0.2; python_version<"3.11"',
+        'async-timeout>=4.0.2; python_version<="3.11.2"',
     ],
     classifiers=[
         "Development Status :: 5 - Production/Stable",
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index 0df7847e66..8f3817a569 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -5,7 +5,9 @@
 from typing import Optional
 from unittest.mock import patch
 
-if sys.version_info.major >= 3 and sys.version_info.minor >= 11:
+# the functionality is available in 3.11.x but has a major issue before
+# 3.11.3. See https://github.com/redis/redis-py/issues/2633
+if sys.version_info >= (3, 11, 3):
     from asyncio import timeout as async_timeout
 else:
     from async_timeout import timeout as async_timeout

From 4856813169f84faa871557dc4e1a98958f5fca6d Mon Sep 17 00:00:00 2001
From: woutdenolf <woutdenolf@users.sf.net>
Date: Mon, 27 Mar 2023 23:40:46 +0200
Subject: [PATCH 0697/1164] UnixDomainSocketConnection missing constructor
 argument (#2630)

---
 redis/connection.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/redis/connection.py b/redis/connection.py
index faea7683f7..162a4c3215 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1155,8 +1155,9 @@ def _connect(self):
 class UnixDomainSocketConnection(AbstractConnection):
     "Manages UDS communication to and from a Redis server"
 
-    def __init__(self, path="", **kwargs):
+    def __init__(self, path="", socket_timeout=None, **kwargs):
         self.path = path
+        self.socket_timeout = socket_timeout
         super().__init__(**kwargs)
 
     def repr_pieces(self):

From 326bb1cf156279919101cc88a696d6cfcd9f3fe9 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 28 Mar 2023 01:06:56 +0300
Subject: [PATCH 0698/1164] removing useless files (#2642)

---
 tests/asynctests | 285 --------------------------------
 tests/synctests  | 421 -----------------------------------------------
 2 files changed, 706 deletions(-)
 delete mode 100644 tests/asynctests
 delete mode 100644 tests/synctests

diff --git a/tests/asynctests b/tests/asynctests
deleted file mode 100644
index 4f0fea9223..0000000000
--- a/tests/asynctests
+++ /dev/null
@@ -1,285 +0,0 @@
-test_response_callbacks
-test_case_insensitive_command_names
-test_command_on_invalid_key_type
-test_acl_cat_no_category
-test_acl_cat_with_category
-test_acl_deluser
-test_acl_genpass
-test_acl_getuser_setuser
-test_acl_list
-test_acl_log
-test_acl_setuser_categories_without_prefix_fails
-test_acl_setuser_commands_without_prefix_fails
-test_acl_setuser_add_passwords_and_nopass_fails
-test_acl_users
-test_acl_whoami
-test_client_list
-test_client_list_type
-test_client_id
-test_client_unblock
-test_client_getname
-test_client_setname
-test_client_kill
-test_client_kill_filter_invalid_params
-test_client_kill_filter_by_id
-test_client_kill_filter_by_addr
-test_client_list_after_client_setname
-test_client_pause
-test_config_get
-test_config_resetstat
-test_config_set
-test_dbsize
-test_echo
-test_info
-test_lastsave
-test_object
-test_ping
-test_slowlog_get
-test_slowlog_get_limit
-test_slowlog_length
-test_time
-test_never_decode_option
-test_empty_response_option
-test_append
-test_bitcount
-test_bitop_not_empty_string
-test_bitop_not
-test_bitop_not_in_place
-test_bitop_single_string
-test_bitop_string_operands
-test_bitpos
-test_bitpos_wrong_arguments
-test_decr
-test_decrby
-test_delete
-test_delete_with_multiple_keys
-test_delitem
-test_unlink
-test_unlink_with_multiple_keys
-test_dump_and_restore
-test_dump_and_restore_and_replace
-test_dump_and_restore_absttl
-test_exists
-test_exists_contains
-test_expire
-test_expireat_datetime
-test_expireat_no_key
-test_expireat_unixtime
-test_get_and_set
-test_get_set_bit
-test_getrange
-test_getset
-test_incr
-test_incrby
-test_incrbyfloat
-test_keys
-test_mget
-test_mset
-test_msetnx
-test_pexpire
-test_pexpireat_datetime
-test_pexpireat_no_key
-test_pexpireat_unixtime
-test_psetex
-test_psetex_timedelta
-test_pttl
-test_pttl_no_key
-test_randomkey
-test_rename
-test_renamenx
-test_set_nx
-test_set_xx
-test_set_px
-test_set_px_timedelta
-test_set_ex
-test_set_ex_timedelta
-test_set_multipleoptions
-test_set_keepttl
-test_setex
-test_setnx
-test_setrange
-test_strlen
-test_substr
-test_ttl
-test_ttl_nokey
-test_type
-test_blpop
-test_brpop
-test_brpoplpush
-test_brpoplpush_empty_string
-test_lindex
-test_linsert
-test_llen
-test_lpop
-test_lpush
-test_lpushx
-test_lrange
-test_lrem
-test_lset
-test_ltrim
-test_rpop
-test_rpoplpush
-test_rpush
-test_lpos
-test_rpushx
-test_scan
-test_scan_type
-test_scan_iter
-test_sscan
-test_sscan_iter
-test_hscan
-test_hscan_iter
-test_zscan
-test_zscan_iter
-test_sadd
-test_scard
-test_sdiff
-test_sdiffstore
-test_sinter
-test_sinterstore
-test_sismember
-test_smembers
-test_smove
-test_spop
-test_spop_multi_value
-test_srandmember
-test_srandmember_multi_value
-test_srem
-test_sunion
-test_sunionstore
-test_zadd
-test_zadd_nx
-test_zadd_xx
-test_zadd_ch
-test_zadd_incr
-test_zadd_incr_with_xx
-test_zcard
-test_zcount
-test_zincrby
-test_zlexcount
-test_zinterstore_sum
-test_zinterstore_max
-test_zinterstore_min
-test_zinterstore_with_weight
-test_zpopmax
-test_zpopmin
-test_bzpopmax
-test_bzpopmin
-test_zrange
-test_zrangebylex
-test_zrevrangebylex
-test_zrangebyscore
-test_zrank
-test_zrem
-test_zrem_multiple_keys
-test_zremrangebylex
-test_zremrangebyrank
-test_zremrangebyscore
-test_zrevrange
-test_zrevrangebyscore
-test_zrevrank
-test_zscore
-test_zunionstore_sum
-test_zunionstore_max
-test_zunionstore_min
-test_zunionstore_with_weight
-test_pfadd
-test_pfcount
-test_pfmerge
-test_hget_and_hset
-test_hset_with_multi_key_values
-test_hset_without_data
-test_hdel
-test_hexists
-test_hgetall
-test_hincrby
-test_hincrbyfloat
-test_hkeys
-test_hlen
-test_hmget
-test_hmset
-test_hsetnx
-test_hvals
-test_hstrlen
-test_sort_basic
-test_sort_limited
-test_sort_by
-test_sort_get
-test_sort_get_multi
-test_sort_get_groups_two
-test_sort_groups_string_get
-test_sort_groups_just_one_get
-test_sort_groups_no_get
-test_sort_groups_three_gets
-test_sort_desc
-test_sort_alpha
-test_sort_store
-test_sort_all_options
-test_sort_issue_924
-test_cluster_addslots
-test_cluster_count_failure_reports
-test_cluster_countkeysinslot
-test_cluster_delslots
-test_cluster_failover
-test_cluster_forget
-test_cluster_info
-test_cluster_keyslot
-test_cluster_meet
-test_cluster_nodes
-test_cluster_replicate
-test_cluster_reset
-test_cluster_saveconfig
-test_cluster_setslot
-test_cluster_slaves
-test_readwrite
-test_readonly_invalid_cluster_state
-test_readonly
-test_geoadd
-test_geoadd_invalid_params
-test_geodist
-test_geodist_units
-test_geodist_missing_one_member
-test_geodist_invalid_units
-test_geohash
-test_geopos
-test_geopos_no_value
-test_old_geopos_no_value
-test_georadius
-test_georadius_no_values
-test_georadius_units
-test_georadius_with
-test_georadius_count
-test_georadius_sort
-test_georadius_store
-test_georadius_store_dist
-test_georadiusmember
-test_xack
-test_xadd
-test_xclaim
-test_xclaim_trimmed
-test_xdel
-test_xgroup_create
-test_xgroup_create_mkstream
-test_xgroup_delconsumer
-test_xgroup_destroy
-test_xgroup_setid
-test_xinfo_consumers
-test_xinfo_stream
-test_xlen
-test_xpending
-test_xpending_range
-test_xrange
-test_xread
-test_xreadgroup
-test_xrevrange
-test_xtrim
-test_bitfield_operations
-test_bitfield_ro
-test_memory_stats
-test_memory_usage
-test_module_list
-test_binary_get_set
-test_binary_lists
-test_22_info
-test_large_responses
-test_floating_point_encoding
diff --git a/tests/synctests b/tests/synctests
deleted file mode 100644
index b0de2d1ba9..0000000000
--- a/tests/synctests
+++ /dev/null
@@ -1,421 +0,0 @@
-test_response_callbacks
-test_case_insensitive_command_names
-test_auth
-test_command_on_invalid_key_type
-test_acl_cat_no_category
-test_acl_cat_with_category
-test_acl_dryrun
-test_acl_deluser
-test_acl_genpass
-test_acl_getuser_setuser
-test_acl_help
-test_acl_list
-test_acl_log
-test_acl_setuser_categories_without_prefix_fails
-test_acl_setuser_commands_without_prefix_fails
-test_acl_setuser_add_passwords_and_nopass_fails
-test_acl_users
-test_acl_whoami
-test_client_list
-test_client_info
-test_client_list_types_not_replica
-test_client_list_replica
-test_client_list_client_id
-test_client_id
-test_client_trackinginfo
-test_client_tracking
-test_client_unblock
-test_client_getname
-test_client_setname
-test_client_kill
-test_client_kill_filter_invalid_params
-test_client_kill_filter_by_id
-test_client_kill_filter_by_addr
-test_client_list_after_client_setname
-test_client_kill_filter_by_laddr
-test_client_kill_filter_by_user
-test_client_pause
-test_client_pause_all
-test_client_unpause
-test_client_no_evict
-test_client_reply
-test_client_getredir
-test_hello_notI_implemented
-test_config_get
-test_config_get_multi_params
-test_config_resetstat
-test_config_set
-test_config_set_multi_params
-test_failover
-test_dbsize
-test_echo
-test_info
-test_info_multi_sections
-test_lastsave
-test_lolwut
-test_reset
-test_object
-test_ping
-test_quit
-test_role
-test_select
-test_slowlog_get
-test_slowlog_get_limit
-test_slowlog_length
-test_time
-test_bgsave
-test_never_decode_option
-test_empty_response_option
-test_append
-test_bitcount
-test_bitcount_mode
-test_bitop_not_empty_string
-test_bitop_not
-test_bitop_not_in_place
-test_bitop_single_string
-test_bitop_string_operands
-test_bitpos
-test_bitpos_wrong_arguments
-test_bitpos_mode
-test_copy
-test_copy_and_replace
-test_copy_to_another_database
-test_decr
-test_decrby
-test_delete
-test_delete_with_multiple_keys
-test_delitem
-test_unlink
-test_unlink_with_multiple_keys
-test_lcs
-test_dump_and_restore
-test_dump_and_restore_and_replace
-test_dump_and_restore_absttl
-test_exists
-test_exists_contains
-test_expire
-test_expire_option_nx
-test_expire_option_xx
-test_expire_option_gt
-test_expire_option_lt
-test_expireat_datetime
-test_expireat_no_key
-test_expireat_unixtime
-test_expiretime
-test_expireat_option_nx
-test_expireat_option_xx
-test_expireat_option_gt
-test_expireat_option_lt
-test_get_and_set
-test_getdel
-test_getex
-test_getitem_and_setitem
-test_getitem_raises_keyerror_for_missing_key
-test_getitem_does_not_raise_keyerror_for_empty_string
-test_get_set_bit
-test_getrange
-test_getset
-test_incr
-test_incrby
-test_incrbyfloat
-test_keys
-test_mget
-test_lmove
-test_blmove
-test_mset
-test_msetnx
-test_pexpire
-test_pexpire_option_nx
-test_pexpire_option_xx
-test_pexpire_option_gt
-test_pexpire_option_lt
-test_pexpireat_datetime
-test_pexpireat_no_key
-test_pexpireat_unixtime
-test_pexpireat_option_nx
-test_pexpireat_option_xx
-test_pexpireat_option_gt
-test_pexpireat_option_lt
-test_pexpiretime
-test_psetex
-test_psetex_timedelta
-test_pttl
-test_pttl_no_key
-test_hrandfield
-test_randomkey
-test_rename
-test_renamenx
-test_set_nx
-test_set_xx
-test_set_px
-test_set_px_timedelta
-test_set_ex
-test_set_ex_str
-test_set_ex_timedelta
-test_set_exat_timedelta
-test_set_pxat_timedelta
-test_set_multipleoptions
-test_set_keepttl
-test_set_get
-test_setex
-test_setnx
-test_setrange
-test_stralgo_lcs
-test_stralgo_negative
-test_strlen
-test_substr
-test_ttl
-test_ttl_nokey
-test_type
-test_blpop
-test_brpop
-test_brpoplpush
-test_brpoplpush_empty_string
-test_blmpop
-test_lmpop
-test_lindex
-test_linsert
-test_llen
-test_lpop
-test_lpop_count
-test_lpush
-test_lpushx
-test_lpushx_with_list
-test_lrange
-test_lrem
-test_lset
-test_ltrim
-test_rpop
-test_rpop_count
-test_rpoplpush
-test_rpush
-test_lpos
-test_rpushx
-test_scan
-test_scan_type
-test_scan_iter
-test_sscan
-test_sscan_iter
-test_hscan
-test_hscan_iter
-test_zscan
-test_zscan_iter
-test_sadd
-test_scard
-test_sdiff
-test_sdiffstore
-test_sinter
-test_sintercard
-test_sinterstore
-test_sismember
-test_smembers
-test_smismember
-test_smove
-test_spop
-test_spop_multi_value
-test_srandmember
-test_srandmember_multi_value
-test_srem
-test_sunion
-test_sunionstore
-test_debug_segfault
-test_script_debug
-test_zadd
-test_zadd_nx
-test_zadd_xx
-test_zadd_ch
-test_zadd_incr
-test_zadd_incr_with_xx
-test_zadd_gt_lt
-test_zcard
-test_zcount
-test_zdiff
-test_zdiffstore
-test_zincrby
-test_zlexcount
-test_zinter
-test_zintercard
-test_zinterstore_sum
-test_zinterstore_max
-test_zinterstore_min
-test_zinterstore_with_weight
-test_zpopmax
-test_zpopmin
-test_zrandemember
-test_bzpopmax
-test_bzpopmin
-test_zmpop
-test_bzmpop
-test_zrange
-test_zrange_errors
-test_zrange_params
-test_zrangestore
-test_zrangebylex
-test_zrevrangebylex
-test_zrangebyscore
-test_zrank
-test_zrem
-test_zrem_multiple_keys
-test_zremrangebylex
-test_zremrangebyrank
-test_zremrangebyscore
-test_zrevrange
-test_zrevrangebyscore
-test_zrevrank
-test_zscore
-test_zunion
-test_zunionstore_sum
-test_zunionstore_max
-test_zunionstore_min
-test_zunionstore_with_weight
-test_zmscore
-test_pfadd
-test_pfcount
-test_pfmerge
-test_hget_and_hset
-test_hset_with_multi_key_values
-test_hset_with_key_values_passed_as_list
-test_hset_without_data
-test_hdel
-test_hexists
-test_hgetall
-test_hincrby
-test_hincrbyfloat
-test_hkeys
-test_hlen
-test_hmget
-test_hmset
-test_hsetnx
-test_hvals
-test_hstrlen
-test_sort_basic
-test_sort_limited
-test_sort_by
-test_sort_get
-test_sort_get_multi
-test_sort_get_groups_two
-test_sort_groups_string_get
-test_sort_groups_just_one_get
-test_sort_groups_no_get
-test_sort_groups_three_gets
-test_sort_desc
-test_sort_alpha
-test_sort_store
-test_sort_all_options
-test_sort_ro
-test_sort_issue_924
-test_cluster_addslots
-test_cluster_count_failure_reports
-test_cluster_countkeysinslot
-test_cluster_delslots
-test_cluster_failover
-test_cluster_forget
-test_cluster_info
-test_cluster_keyslot
-test_cluster_meet
-test_cluster_nodes
-test_cluster_replicate
-test_cluster_reset
-test_cluster_saveconfig
-test_cluster_setslot
-test_cluster_slaves
-test_readwrite
-test_readonly_invalid_cluster_state
-test_readonly
-test_geoadd
-test_geoadd_nx
-test_geoadd_xx
-test_geoadd_ch
-test_geoadd_invalid_params
-test_geodist
-test_geodist_units
-test_geodist_missing_one_member
-test_geodist_invalid_units
-test_geohash
-test_geopos
-test_geopos_no_value
-test_old_geopos_no_value
-test_geosearch
-test_geosearch_member
-test_geosearch_sort
-test_geosearch_with
-test_geosearch_negative
-test_geosearchstore
-test_geosearchstore_dist
-test_georadius
-test_georadius_no_values
-test_georadius_units
-test_georadius_with
-test_georadius_count
-test_georadius_sort
-test_georadius_store
-test_georadius_store_dist
-test_georadiusmember
-test_georadiusmember_count
-test_xack
-test_xadd
-test_xadd_nomkstream
-test_xadd_minlen_and_limit
-test_xadd_explicit_ms
-test_xautoclaim
-test_xautoclaim_negative
-test_xclaim
-test_xclaim_trimmed
-test_xdel
-test_xgroup_create
-test_xgroup_create_mkstream
-test_xgroup_create_entriesread
-test_xgroup_delconsumer
-test_xgroup_createconsumer
-test_xgroup_destroy
-test_xgroup_setid
-test_xinfo_consumers
-test_xinfo_stream
-test_xinfo_stream_full
-test_xlen
-test_xpending
-test_xpending_range
-test_xpending_range_idle
-test_xpending_range_negative
-test_xrange
-test_xread
-test_xreadgroup
-test_xrevrange
-test_xtrim
-test_xtrim_minlen_and_length_args
-test_bitfield_operations
-test
-test_bitfield_ro
-test_memory_help
-test_memory_doctor
-test_memory_malloc_stats
-test_memory_stats
-test_memory_usage
-test_latency_histogram_not_implemented
-test_latency_graph_not_implemented
-test_latency_doctor_not_implemented
-test_latency_history
-test_latency_latest
-test_latency_reset
-test_module_list
-test_command_count
-test_command_docs
-test_command_list
-test_command_getkeys
-test_command
-test_command_getkeysandflags
-test_module
-test_module_loadex
-test_restore
-test_restore_idletime
-test_restore_frequency
-test_replicaof
-test_shutdown
-test_shutdown_with_params
-test_sync
-test_psync
-test_binary_get_set
-test_binary_lists
-test_22_info
-test_large_responses
-test_floating_point_encoding

From 6d886d7c7b405c0fe5d59ca192c87b438bf080f5 Mon Sep 17 00:00:00 2001
From: shacharPash <93581407+shacharPash@users.noreply.github.com>
Date: Tue, 28 Mar 2023 16:10:25 +0300
Subject: [PATCH 0699/1164] Fix issue 2660: PytestUnraisableExceptionWarning
 from asycio client (#2669)

---
 redis/asyncio/client.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 9e16ee08de..5de2ff960c 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -702,6 +702,11 @@ async def reset(self):
             self.pending_unsubscribe_patterns = set()
 
     def close(self) -> Awaitable[NoReturn]:
+        # In case a connection property does not yet exist
+        # (due to a crash earlier in the Redis() constructor), return
+        # immediately as there is nothing to clean-up.
+        if not hasattr(self, "connection"):
+            return
         return self.reset()
 
     async def on_connect(self, connection: Connection):

From 5acbde355058ab7d9c2f95bcef3993ab4134e342 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 29 Mar 2023 12:01:45 +0300
Subject: [PATCH 0700/1164] Fixing cancelled async futures (#2666)

Co-authored-by: James R T <jamestiotio@gmail.com>
Co-authored-by: dvora-h <dvora.heller@redis.com>
---
 .github/workflows/integration.yaml    |   2 +
 redis/asyncio/client.py               |  99 +++++++++++------
 redis/asyncio/cluster.py              |  21 ++--
 tests/test_asyncio/test_cluster.py    |  17 ---
 tests/test_asyncio/test_connection.py |  21 ----
 tests/test_asyncio/test_cwe_404.py    | 146 ++++++++++++++++++++++++++
 tests/test_asyncio/test_pubsub.py     |   3 +
 7 files changed, 234 insertions(+), 75 deletions(-)
 create mode 100644 tests/test_asyncio/test_cwe_404.py

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 0f9db8fb1a..f49a4fcd46 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -51,6 +51,7 @@ jobs:
      timeout-minutes: 30
      strategy:
        max-parallel: 15
+       fail-fast: false
        matrix:
          python-version: ['3.7', '3.8', '3.9', '3.10', '3.11', 'pypy-3.7', 'pypy-3.8', 'pypy-3.9']
          test-type: ['standalone', 'cluster']
@@ -108,6 +109,7 @@ jobs:
     name: Install package from commit hash
     runs-on: ubuntu-latest
     strategy:
+      fail-fast: false
       matrix:
         python-version: ['3.7', '3.8', '3.9', '3.10', '3.11', 'pypy-3.7', 'pypy-3.8', 'pypy-3.9']
     steps:
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 5de2ff960c..7986b11cbd 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -500,28 +500,37 @@ async def _disconnect_raise(self, conn: Connection, error: Exception):
         ):
             raise error
 
-    # COMMAND EXECUTION AND PROTOCOL PARSING
-    async def execute_command(self, *args, **options):
-        """Execute a command and return a parsed response"""
-        await self.initialize()
-        pool = self.connection_pool
-        command_name = args[0]
-        conn = self.connection or await pool.get_connection(command_name, **options)
-
-        if self.single_connection_client:
-            await self._single_conn_lock.acquire()
+    async def _try_send_command_parse_response(self, conn, *args, **options):
         try:
             return await conn.retry.call_with_retry(
                 lambda: self._send_command_parse_response(
-                    conn, command_name, *args, **options
+                    conn, args[0], *args, **options
                 ),
                 lambda error: self._disconnect_raise(conn, error),
             )
+        except asyncio.CancelledError:
+            await conn.disconnect(nowait=True)
+            raise
         finally:
             if self.single_connection_client:
                 self._single_conn_lock.release()
             if not self.connection:
-                await pool.release(conn)
+                await self.connection_pool.release(conn)
+
+    # COMMAND EXECUTION AND PROTOCOL PARSING
+    async def execute_command(self, *args, **options):
+        """Execute a command and return a parsed response"""
+        await self.initialize()
+        pool = self.connection_pool
+        command_name = args[0]
+        conn = self.connection or await pool.get_connection(command_name, **options)
+
+        if self.single_connection_client:
+            await self._single_conn_lock.acquire()
+
+        return await asyncio.shield(
+            self._try_send_command_parse_response(conn, *args, **options)
+        )
 
     async def parse_response(
         self, connection: Connection, command_name: Union[str, bytes], **options
@@ -765,10 +774,18 @@ async def _disconnect_raise_connect(self, conn, error):
         is not a TimeoutError. Otherwise, try to reconnect
         """
         await conn.disconnect()
+
         if not (conn.retry_on_timeout and isinstance(error, TimeoutError)):
             raise error
         await conn.connect()
 
+    async def _try_execute(self, conn, command, *arg, **kwargs):
+        try:
+            return await command(*arg, **kwargs)
+        except asyncio.CancelledError:
+            await conn.disconnect()
+            raise
+
     async def _execute(self, conn, command, *args, **kwargs):
         """
         Connect manually upon disconnection. If the Redis server is down,
@@ -777,9 +794,11 @@ async def _execute(self, conn, command, *args, **kwargs):
         called by the # connection to resubscribe us to any channels and
         patterns we were previously listening to
         """
-        return await conn.retry.call_with_retry(
-            lambda: command(*args, **kwargs),
-            lambda error: self._disconnect_raise_connect(conn, error),
+        return await asyncio.shield(
+            conn.retry.call_with_retry(
+                lambda: self._try_execute(conn, command, *args, **kwargs),
+                lambda error: self._disconnect_raise_connect(conn, error),
+            )
         )
 
     async def parse_response(self, block: bool = True, timeout: float = 0):
@@ -1181,6 +1200,18 @@ async def _disconnect_reset_raise(self, conn, error):
             await self.reset()
             raise
 
+    async def _try_send_command_parse_response(self, conn, *args, **options):
+        try:
+            return await conn.retry.call_with_retry(
+                lambda: self._send_command_parse_response(
+                    conn, args[0], *args, **options
+                ),
+                lambda error: self._disconnect_reset_raise(conn, error),
+            )
+        except asyncio.CancelledError:
+            await conn.disconnect()
+            raise
+
     async def immediate_execute_command(self, *args, **options):
         """
         Execute a command immediately, but don't auto-retry on a
@@ -1196,13 +1227,13 @@ async def immediate_execute_command(self, *args, **options):
                 command_name, self.shard_hint
             )
             self.connection = conn
-
-        return await conn.retry.call_with_retry(
-            lambda: self._send_command_parse_response(
-                conn, command_name, *args, **options
-            ),
-            lambda error: self._disconnect_reset_raise(conn, error),
-        )
+        try:
+            return await asyncio.shield(
+                self._try_send_command_parse_response(conn, *args, **options)
+            )
+        except asyncio.CancelledError:
+            await conn.disconnect()
+            raise
 
     def pipeline_execute_command(self, *args, **options):
         """
@@ -1369,6 +1400,19 @@ async def _disconnect_raise_reset(self, conn: Connection, error: Exception):
             await self.reset()
             raise
 
+    async def _try_execute(self, conn, execute, stack, raise_on_error):
+        try:
+            return await conn.retry.call_with_retry(
+                lambda: execute(conn, stack, raise_on_error),
+                lambda error: self._disconnect_raise_reset(conn, error),
+            )
+        except asyncio.CancelledError:
+            # not supposed to be possible, yet here we are
+            await conn.disconnect(nowait=True)
+            raise
+        finally:
+            await self.reset()
+
     async def execute(self, raise_on_error: bool = True):
         """Execute all the commands in the current pipeline"""
         stack = self.command_stack
@@ -1391,15 +1435,10 @@ async def execute(self, raise_on_error: bool = True):
 
         try:
             return await asyncio.shield(
-                conn.retry.call_with_retry(
-                    lambda: execute(conn, stack, raise_on_error),
-                    lambda error: self._disconnect_raise_reset(conn, error),
-                )
+                self._try_execute(conn, execute, stack, raise_on_error)
             )
-        except asyncio.CancelledError:
-            # not supposed to be possible, yet here we are
-            await conn.disconnect(nowait=True)
-            raise
+        except RuntimeError:
+            await self.reset()
         finally:
             await self.reset()
 
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 569a0765f8..a4a9561cf1 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -1016,6 +1016,19 @@ async def _parse_and_release(self, connection, *args, **kwargs):
         finally:
             self._free.append(connection)
 
+    async def _try_parse_response(self, cmd, connection, ret):
+        try:
+            cmd.result = await asyncio.shield(
+                self.parse_response(connection, cmd.args[0], **cmd.kwargs)
+            )
+        except asyncio.CancelledError:
+            await connection.disconnect(nowait=True)
+            raise
+        except Exception as e:
+            cmd.result = e
+            ret = True
+        return ret
+
     async def execute_pipeline(self, commands: List["PipelineCommand"]) -> bool:
         # Acquire connection
         connection = self.acquire_connection()
@@ -1028,13 +1041,7 @@ async def execute_pipeline(self, commands: List["PipelineCommand"]) -> bool:
         # Read responses
         ret = False
         for cmd in commands:
-            try:
-                cmd.result = await self.parse_response(
-                    connection, cmd.args[0], **cmd.kwargs
-                )
-            except Exception as e:
-                cmd.result = e
-                ret = True
+            ret = await asyncio.shield(self._try_parse_response(cmd, connection, ret))
 
         # Release connection
         self._free.append(connection)
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 0857c056c2..13e5e26ae3 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -340,23 +340,6 @@ async def test_from_url(self, request: FixtureRequest) -> None:
         rc = RedisCluster.from_url("rediss://localhost:16379")
         assert rc.connection_kwargs["connection_class"] is SSLConnection
 
-    async def test_asynckills(self, r) -> None:
-
-        await r.set("foo", "foo")
-        await r.set("bar", "bar")
-
-        t = asyncio.create_task(r.get("foo"))
-        await asyncio.sleep(1)
-        t.cancel()
-        try:
-            await t
-        except asyncio.CancelledError:
-            pytest.fail("connection is left open with unread response")
-
-        assert await r.get("bar") == b"bar"
-        assert await r.ping()
-        assert await r.get("foo") == b"foo"
-
     async def test_max_connections(
         self, create_redis: Callable[..., RedisCluster]
     ) -> None:
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index d3b6285cfb..e2d77fc1c3 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -44,27 +44,6 @@ async def test_invalid_response(create_redis):
     await r.connection.disconnect()
 
 
-async def test_asynckills():
-
-    for b in [True, False]:
-        r = Redis(single_connection_client=b)
-
-        await r.set("foo", "foo")
-        await r.set("bar", "bar")
-
-        t = asyncio.create_task(r.get("foo"))
-        await asyncio.sleep(1)
-        t.cancel()
-        try:
-            await t
-        except asyncio.CancelledError:
-            pytest.fail("connection left open with unread response")
-
-        assert await r.get("bar") == b"bar"
-        assert await r.ping()
-        assert await r.get("foo") == b"foo"
-
-
 @pytest.mark.onlynoncluster
 async def test_single_connection():
     """Test that concurrent requests on a single client are synchronised."""
diff --git a/tests/test_asyncio/test_cwe_404.py b/tests/test_asyncio/test_cwe_404.py
new file mode 100644
index 0000000000..668344042d
--- /dev/null
+++ b/tests/test_asyncio/test_cwe_404.py
@@ -0,0 +1,146 @@
+import asyncio
+import sys
+
+import pytest
+
+from redis.asyncio import Redis
+from redis.asyncio.cluster import RedisCluster
+
+
+async def pipe(
+    reader: asyncio.StreamReader, writer: asyncio.StreamWriter, delay: float, name=""
+):
+    while True:
+        data = await reader.read(1000)
+        if not data:
+            break
+        await asyncio.sleep(delay)
+        writer.write(data)
+        await writer.drain()
+
+
+class DelayProxy:
+    def __init__(self, addr, redis_addr, delay: float):
+        self.addr = addr
+        self.redis_addr = redis_addr
+        self.delay = delay
+
+    async def start(self):
+        self.server = await asyncio.start_server(self.handle, *self.addr)
+        self.ROUTINE = asyncio.create_task(self.server.serve_forever())
+
+    async def handle(self, reader, writer):
+        # establish connection to redis
+        redis_reader, redis_writer = await asyncio.open_connection(*self.redis_addr)
+        pipe1 = asyncio.create_task(pipe(reader, redis_writer, self.delay, "to redis:"))
+        pipe2 = asyncio.create_task(
+            pipe(redis_reader, writer, self.delay, "from redis:")
+        )
+        await asyncio.gather(pipe1, pipe2)
+
+    async def stop(self):
+        # clean up enough so that we can reuse the looper
+        self.ROUTINE.cancel()
+        loop = self.server.get_loop()
+        await loop.shutdown_asyncgens()
+
+
+@pytest.mark.onlynoncluster
+@pytest.mark.parametrize("delay", argvalues=[0.05, 0.5, 1, 2])
+async def test_standalone(delay):
+
+    # create a tcp socket proxy that relays data to Redis and back,
+    # inserting 0.1 seconds of delay
+    dp = DelayProxy(
+        addr=("localhost", 5380), redis_addr=("localhost", 6379), delay=delay * 2
+    )
+    await dp.start()
+
+    for b in [True, False]:
+        # note that we connect to proxy, rather than to Redis directly
+        async with Redis(host="localhost", port=5380, single_connection_client=b) as r:
+
+            await r.set("foo", "foo")
+            await r.set("bar", "bar")
+
+            t = asyncio.create_task(r.get("foo"))
+            await asyncio.sleep(delay)
+            t.cancel()
+            try:
+                await t
+                sys.stderr.write("try again, we did not cancel the task in time\n")
+            except asyncio.CancelledError:
+                sys.stderr.write(
+                    "canceled task, connection is left open with unread response\n"
+                )
+
+            assert await r.get("bar") == b"bar"
+            assert await r.ping()
+            assert await r.get("foo") == b"foo"
+
+    await dp.stop()
+
+
+@pytest.mark.onlynoncluster
+@pytest.mark.parametrize("delay", argvalues=[0.05, 0.5, 1, 2])
+async def test_standalone_pipeline(delay):
+    dp = DelayProxy(
+        addr=("localhost", 5380), redis_addr=("localhost", 6379), delay=delay * 2
+    )
+    await dp.start()
+    async with Redis(host="localhost", port=5380) as r:
+        await r.set("foo", "foo")
+        await r.set("bar", "bar")
+
+        pipe = r.pipeline()
+
+        pipe2 = r.pipeline()
+        pipe2.get("bar")
+        pipe2.ping()
+        pipe2.get("foo")
+
+        t = asyncio.create_task(pipe.get("foo").execute())
+        await asyncio.sleep(delay)
+        t.cancel()
+
+        pipe.get("bar")
+        pipe.ping()
+        pipe.get("foo")
+        pipe.reset()
+
+        assert await pipe.execute() is None
+
+        # validating that the pipeline can be used as it could previously
+        pipe.get("bar")
+        pipe.ping()
+        pipe.get("foo")
+        assert await pipe.execute() == [b"bar", True, b"foo"]
+        assert await pipe2.execute() == [b"bar", True, b"foo"]
+
+    await dp.stop()
+
+
+@pytest.mark.onlycluster
+async def test_cluster(request):
+
+    dp = DelayProxy(addr=("localhost", 5381), redis_addr=("localhost", 6372), delay=0.1)
+    await dp.start()
+
+    r = RedisCluster.from_url("redis://localhost:5381")
+    await r.initialize()
+    await r.set("foo", "foo")
+    await r.set("bar", "bar")
+
+    t = asyncio.create_task(r.get("foo"))
+    await asyncio.sleep(0.050)
+    t.cancel()
+    try:
+        await t
+    except asyncio.CancelledError:
+        pytest.fail("connection is left open with unread response")
+
+    assert await r.get("bar") == b"bar"
+    assert await r.ping()
+    assert await r.get("foo") == b"foo"
+
+    await dp.stop()
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index 8f3817a569..ba70782e42 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -973,6 +973,9 @@ async def get_msg_or_timeout(timeout=0.1):
         # the timeout on the read should not cause disconnect
         assert pubsub.connection.is_connected
 
+    @pytest.mark.skipif(
+        sys.version_info < (3, 8), reason="requires python 3.8 or higher"
+    )
     async def test_base_exception(self, r: redis.Redis):
         """
         Manually trigger a BaseException inside the parser's .read_response method

From ef3f086ba95d597b815b41fa382283f62a08b509 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 29 Mar 2023 14:39:07 +0300
Subject: [PATCH 0701/1164] Fix async (#2673)

---
 redis/asyncio/client.py            | 10 ++-----
 tests/test_asyncio/test_cwe_404.py | 45 +++++++++++++++---------------
 2 files changed, 26 insertions(+), 29 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 7986b11cbd..3e6626aedf 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -1227,13 +1227,9 @@ async def immediate_execute_command(self, *args, **options):
                 command_name, self.shard_hint
             )
             self.connection = conn
-        try:
-            return await asyncio.shield(
-                self._try_send_command_parse_response(conn, *args, **options)
-            )
-        except asyncio.CancelledError:
-            await conn.disconnect()
-            raise
+        return await asyncio.shield(
+            self._try_send_command_parse_response(conn, *args, **options)
+        )
 
     def pipeline_execute_command(self, *args, **options):
         """
diff --git a/tests/test_asyncio/test_cwe_404.py b/tests/test_asyncio/test_cwe_404.py
index 668344042d..dc62df65f4 100644
--- a/tests/test_asyncio/test_cwe_404.py
+++ b/tests/test_asyncio/test_cwe_404.py
@@ -88,34 +88,35 @@ async def test_standalone_pipeline(delay):
         addr=("localhost", 5380), redis_addr=("localhost", 6379), delay=delay * 2
     )
     await dp.start()
-    async with Redis(host="localhost", port=5380) as r:
-        await r.set("foo", "foo")
-        await r.set("bar", "bar")
+    for b in [True, False]:
+        async with Redis(host="localhost", port=5380, single_connection_client=b) as r:
+            await r.set("foo", "foo")
+            await r.set("bar", "bar")
 
-        pipe = r.pipeline()
+            pipe = r.pipeline()
 
-        pipe2 = r.pipeline()
-        pipe2.get("bar")
-        pipe2.ping()
-        pipe2.get("foo")
+            pipe2 = r.pipeline()
+            pipe2.get("bar")
+            pipe2.ping()
+            pipe2.get("foo")
 
-        t = asyncio.create_task(pipe.get("foo").execute())
-        await asyncio.sleep(delay)
-        t.cancel()
+            t = asyncio.create_task(pipe.get("foo").execute())
+            await asyncio.sleep(delay)
+            t.cancel()
 
-        pipe.get("bar")
-        pipe.ping()
-        pipe.get("foo")
-        pipe.reset()
+            pipe.get("bar")
+            pipe.ping()
+            pipe.get("foo")
+            pipe.reset()
 
-        assert await pipe.execute() is None
+            assert await pipe.execute() is None
 
-        # validating that the pipeline can be used as it could previously
-        pipe.get("bar")
-        pipe.ping()
-        pipe.get("foo")
-        assert await pipe.execute() == [b"bar", True, b"foo"]
-        assert await pipe2.execute() == [b"bar", True, b"foo"]
+            # validating that the pipeline can be used as it could previously
+            pipe.get("bar")
+            pipe.ping()
+            pipe.get("foo")
+            assert await pipe.execute() == [b"bar", True, b"foo"]
+            assert await pipe2.execute() == [b"bar", True, b"foo"]
 
     await dp.stop()
 

From e1017fd77afd2f56dca90f986fc82e398e518a26 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 29 Mar 2023 16:10:55 +0300
Subject: [PATCH 0702/1164] Version 4.5.4 (#2674)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 3b7347da03..c23038cba7 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.5.3",
+    version="4.5.4",
     packages=find_packages(
         include=[
             "redis",

From 7ae8464798f4b3d2eda290c6f49ced14ef7e0029 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mirek=20D=C5=82ugosz?= <miniopl+github@gmail.com>
Date: Thu, 13 Apr 2023 13:56:38 +0200
Subject: [PATCH 0703/1164] Really do not use asyncio's timeout lib before
 3.11.2 (#2699)

480253037afe4c12e38a0f98cadd3019a3724254 made async-timeout required
only on Python 3.11.2 and earlier. However, according to PEP-508,
python_version marker is compared to first two numbers of Python version
tuple - so it will evaluate to True also on 3.11.3, and install a
package as a dependency.
---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index c23038cba7..f2935b21ce 100644
--- a/setup.py
+++ b/setup.py
@@ -34,7 +34,7 @@
     install_requires=[
         'importlib-metadata >= 1.0; python_version < "3.8"',
         'typing-extensions; python_version<"3.8"',
-        'async-timeout>=4.0.2; python_version<="3.11.2"',
+        'async-timeout>=4.0.2; python_full_version<="3.11.2"',
     ],
     classifiers=[
         "Development Status :: 5 - Production/Stable",

From 6a4240b205d7d63e1aa4803f8430248bebac071b Mon Sep 17 00:00:00 2001
From: Oran Avraham <252748+oranav@users.noreply.github.com>
Date: Thu, 13 Apr 2023 14:57:50 +0300
Subject: [PATCH 0704/1164] asyncio: Fix memory leak caused by hiredis (#2693)
 (#2694)

---
 CHANGES                     | 1 +
 redis/asyncio/connection.py | 7 ++++---
 redis/connection.py         | 7 ++++---
 3 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/CHANGES b/CHANGES
index b0744c6038..429045f9a5 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * asyncio: Fix memory leak caused by hiredis (#2693)
     * Allow data to drain from async PythonParser when reading during a disconnect()
     * Use asyncio.timeout() instead of async_timeout.timeout() for python >= 3.11 (#2602)
     * Add test and fix async HiredisParser when reading during a disconnect() (#2349)
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 58dcd66efb..59f75aa229 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -187,12 +187,13 @@ def __del__(self):
         except Exception:
             pass
 
-    def parse_error(self, response: str) -> ResponseError:
+    @classmethod
+    def parse_error(cls, response: str) -> ResponseError:
         """Parse an error response"""
         error_code = response.split(" ")[0]
-        if error_code in self.EXCEPTION_CLASSES:
+        if error_code in cls.EXCEPTION_CLASSES:
             response = response[len(error_code) + 1 :]
-            exception_class = self.EXCEPTION_CLASSES[error_code]
+            exception_class = cls.EXCEPTION_CLASSES[error_code]
             if isinstance(exception_class, dict):
                 exception_class = exception_class.get(response, ResponseError)
             return exception_class(response)
diff --git a/redis/connection.py b/redis/connection.py
index 162a4c3215..eefdd96523 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -158,12 +158,13 @@ class BaseParser:
         "NOPERM": NoPermissionError,
     }
 
-    def parse_error(self, response):
+    @classmethod
+    def parse_error(cls, response):
         "Parse an error response"
         error_code = response.split(" ")[0]
-        if error_code in self.EXCEPTION_CLASSES:
+        if error_code in cls.EXCEPTION_CLASSES:
             response = response[len(error_code) + 1 :]
-            exception_class = self.EXCEPTION_CLASSES[error_code]
+            exception_class = cls.EXCEPTION_CLASSES[error_code]
             if isinstance(exception_class, dict):
                 exception_class = exception_class.get(response, ResponseError)
             return exception_class(response)

From db9a85cd3e60a7746854108c42026c582b6ba527 Mon Sep 17 00:00:00 2001
From: mzdehbashi-github <85902780+mzdehbashi-github@users.noreply.github.com>
Date: Thu, 13 Apr 2023 14:48:28 +0200
Subject: [PATCH 0705/1164] Update example of Redisearch creating index (#2703)

When creating index, fields should be passed inside an iterable (e.g. list or tuple)
---
 docs/redismodules.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/docs/redismodules.rst b/docs/redismodules.rst
index 2b0b3c6533..a133f03cb5 100644
--- a/docs/redismodules.rst
+++ b/docs/redismodules.rst
@@ -119,7 +119,11 @@ below, an index named *my_index* is being created. When an index name is not spe
 
     r = redis.Redis()
     index_name = "my_index"
-    r.ft(index_name).create_index(TextField("play", weight=5.0), TextField("ball"))
+    schema = (
+        TextField("play", weight=5.0),
+        TextField("ball"),
+    )
+    r.ft(index_name).create_index(schema)
     print(r.ft(index_name).info())
 
 

From 7fc4c76c778163c21d396f99dcc710d99942895f Mon Sep 17 00:00:00 2001
From: Tyler Hutcherson <tyler.hutcherson@redis.com>
Date: Thu, 13 Apr 2023 16:59:43 -0400
Subject: [PATCH 0706/1164] Improving Vector Similarity Search Example (#2661)

* update vss docs

* add embeddings creation and storage examples

* update based on feedback

* fix version and link

* include more realistic search examples and clean up indices

* completely remove initial cap reference

---------

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 .../search_vector_similarity_examples.ipynb   | 610 +++++++++++++++++-
 1 file changed, 586 insertions(+), 24 deletions(-)

diff --git a/docs/examples/search_vector_similarity_examples.ipynb b/docs/examples/search_vector_similarity_examples.ipynb
index 2b0261097c..bd1df3c1ef 100644
--- a/docs/examples/search_vector_similarity_examples.ipynb
+++ b/docs/examples/search_vector_similarity_examples.ipynb
@@ -1,81 +1,643 @@
 {
  "cells": [
   {
+   "attachments": {},
    "cell_type": "markdown",
    "metadata": {},
    "source": [
     "# Vector Similarity\n",
-    "## Adding Vector Fields"
+    "**Vectors** (also called \"Embeddings\"), represent an AI model's impression (or understanding) of a piece of unstructured data like text, images, audio, videos, etc. Vector Similarity Search (VSS) is the process of finding vectors in the vector database that are similar to a given query vector. Popular VSS uses include recommendation systems, image and video search, document retrieval, and question answering.\n",
+    "\n",
+    "## Index Creation\n",
+    "Before doing vector search, first define the schema and create an index."
    ]
   },
   {
    "cell_type": "code",
    "execution_count": 1,
    "metadata": {},
+   "outputs": [],
+   "source": [
+    "import redis\n",
+    "from redis.commands.search.field import TagField, VectorField\n",
+    "from redis.commands.search.indexDefinition import IndexDefinition, IndexType\n",
+    "from redis.commands.search.query import Query\n",
+    "\n",
+    "r = redis.Redis(host=\"localhost\", port=6379)\n",
+    "\n",
+    "INDEX_NAME = \"index\"                              # Vector Index Name\n",
+    "DOC_PREFIX = \"doc:\"                               # RediSearch Key Prefix for the Index\n",
+    "\n",
+    "def create_index(vector_dimensions: int):\n",
+    "    try:\n",
+    "        # check to see if index exists\n",
+    "        r.ft(INDEX_NAME).info()\n",
+    "        print(\"Index already exists!\")\n",
+    "    except:\n",
+    "        # schema\n",
+    "        schema = (\n",
+    "            TagField(\"tag\"),                       # Tag Field Name\n",
+    "            VectorField(\"vector\",                  # Vector Field Name\n",
+    "                \"FLAT\", {                          # Vector Index Type: FLAT or HNSW\n",
+    "                    \"TYPE\": \"FLOAT32\",             # FLOAT32 or FLOAT64\n",
+    "                    \"DIM\": vector_dimensions,      # Number of Vector Dimensions\n",
+    "                    \"DISTANCE_METRIC\": \"COSINE\",   # Vector Search Distance Metric\n",
+    "                }\n",
+    "            ),\n",
+    "        )\n",
+    "\n",
+    "        # index Definition\n",
+    "        definition = IndexDefinition(prefix=[DOC_PREFIX], index_type=IndexType.HASH)\n",
+    "\n",
+    "        # create Index\n",
+    "        r.ft(INDEX_NAME).create_index(fields=schema, definition=definition)"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We'll start by working with vectors that have 1536 dimensions."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# define vector dimensions\n",
+    "VECTOR_DIMENSIONS = 1536\n",
+    "\n",
+    "# create the index\n",
+    "create_index(vector_dimensions=VECTOR_DIMENSIONS)"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Adding Vectors to Redis\n",
+    "\n",
+    "Next, we add vectors (dummy data) to Redis using `hset`. The search index listens to keyspace notifications and will include any written HASH objects prefixed by `DOC_PREFIX`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "%pip install numpy"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import numpy as np"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# instantiate a redis pipeline\n",
+    "pipe = r.pipeline()\n",
+    "\n",
+    "# define some dummy data\n",
+    "objects = [\n",
+    "    {\"name\": \"a\", \"tag\": \"foo\"},\n",
+    "    {\"name\": \"b\", \"tag\": \"foo\"},\n",
+    "    {\"name\": \"c\", \"tag\": \"bar\"},\n",
+    "]\n",
+    "\n",
+    "# write data\n",
+    "for obj in objects:\n",
+    "    # define key\n",
+    "    key = f\"doc:{obj['name']}\"\n",
+    "    # create a random \"dummy\" vector\n",
+    "    obj[\"vector\"] = np.random.rand(VECTOR_DIMENSIONS).astype(np.float32).tobytes()\n",
+    "    # HSET\n",
+    "    pipe.hset(key, mapping=obj)\n",
+    "\n",
+    "res = pipe.execute()"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Searching\n",
+    "You can use VSS queries with the `.ft(...).search(...)` query command. To use a VSS query, you must specify the option `.dialect(2)`.\n",
+    "\n",
+    "There are two supported types of vector queries in Redis: `KNN` and `Range`. `Hybrid` queries can work in both settings and combine elements of traditional search and VSS."
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### KNN Queries\n",
+    "KNN queries are for finding the topK most similar vectors given a query vector."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {
+    "pycharm": {
+     "name": "#%%\n"
+    }
+   },
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "b'OK'"
+       "[Document {'id': 'doc:b', 'payload': None, 'score': '0.2376562953'},\n",
+       " Document {'id': 'doc:c', 'payload': None, 'score': '0.240063905716'}]"
       ]
      },
-     "execution_count": 1,
+     "execution_count": 5,
      "metadata": {},
      "output_type": "execute_result"
     }
    ],
    "source": [
-    "import redis\n",
-    "from redis.commands.search.field import VectorField\n",
-    "from redis.commands.search.query import Query\n",
+    "query = (\n",
+    "    Query(\"*=>[KNN 2 @vector $vec as score]\")\n",
+    "     .sort_by(\"score\")\n",
+    "     .return_fields(\"id\", \"score\")\n",
+    "     .paging(0, 2)\n",
+    "     .dialect(2)\n",
+    ")\n",
     "\n",
-    "r = redis.Redis(host='localhost', port=36379)\n",
+    "query_params = {\n",
+    "    \"vec\": np.random.rand(VECTOR_DIMENSIONS).astype(np.float32).tobytes()\n",
+    "}\n",
+    "r.ft(INDEX_NAME).search(query, query_params).docs"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Range Queries\n",
+    "Range queries provide a way to filter results by the distance between a vector field in Redis and a query vector based on some pre-defined threshold (radius)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[Document {'id': 'doc:a', 'payload': None, 'score': '0.243115246296'},\n",
+       " Document {'id': 'doc:c', 'payload': None, 'score': '0.24981123209'},\n",
+       " Document {'id': 'doc:b', 'payload': None, 'score': '0.251443207264'}]"
+      ]
+     },
+     "execution_count": 6,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "query = (\n",
+    "    Query(\"@vector:[VECTOR_RANGE $radius $vec]=>{$YIELD_DISTANCE_AS: score}\")\n",
+    "     .sort_by(\"score\")\n",
+    "     .return_fields(\"id\", \"score\")\n",
+    "     .paging(0, 3)\n",
+    "     .dialect(2)\n",
+    ")\n",
     "\n",
-    "schema = (VectorField(\"v\", \"HNSW\", {\"TYPE\": \"FLOAT32\", \"DIM\": 2, \"DISTANCE_METRIC\": \"L2\"}),)\n",
-    "r.ft().create_index(schema)"
+    "# Find all vectors within 0.8 of the query vector\n",
+    "query_params = {\n",
+    "    \"radius\": 0.8,\n",
+    "    \"vec\": np.random.rand(VECTOR_DIMENSIONS).astype(np.float32).tobytes()\n",
+    "}\n",
+    "r.ft(INDEX_NAME).search(query, query_params).docs"
    ]
   },
   {
+   "attachments": {},
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## Searching"
+    "See additional Range Query examples in [this Jupyter notebook](https://github.com/RediSearch/RediSearch/blob/master/docs/docs/vecsim-range_queries_examples.ipynb)."
    ]
   },
   {
+   "attachments": {},
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "### Querying vector fields"
+    "### Hybrid Queries\n",
+    "Hybrid queries contain both traditional filters (numeric, tags, text) and VSS in one single Redis command."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 2,
-   "metadata": {
-    "pycharm": {
-     "name": "#%%\n"
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[Document {'id': 'doc:b', 'payload': None, 'score': '0.24422544241', 'tag': 'foo'},\n",
+       " Document {'id': 'doc:a', 'payload': None, 'score': '0.259926855564', 'tag': 'foo'}]"
+      ]
+     },
+     "execution_count": 7,
+     "metadata": {},
+     "output_type": "execute_result"
     }
-   },
+   ],
+   "source": [
+    "query = (\n",
+    "    Query(\"(@tag:{ foo })=>[KNN 2 @vector $vec as score]\")\n",
+    "     .sort_by(\"score\")\n",
+    "     .return_fields(\"id\", \"tag\", \"score\")\n",
+    "     .paging(0, 2)\n",
+    "     .dialect(2)\n",
+    ")\n",
+    "\n",
+    "query_params = {\n",
+    "    \"vec\": np.random.rand(VECTOR_DIMENSIONS).astype(np.float32).tobytes()\n",
+    "}\n",
+    "r.ft(INDEX_NAME).search(query, query_params).docs"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "See additional Hybrid Query examples in [this Jupyter notebook](https://github.com/RediSearch/RediSearch/blob/master/docs/docs/vecsim-hybrid_queries_examples.ipynb)."
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Vector Creation and Storage Examples\n",
+    "The above examples use dummy data as vectors. However, in reality, most use cases leverage production-grade AI models for creating embeddings. Below we will take some sample text data, pass it to the OpenAI and Cohere API's respectively, and then write them to Redis."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "texts = [\n",
+    "    \"Today is a really great day!\",\n",
+    "    \"The dog next door barks really loudly.\",\n",
+    "    \"My cat escaped and got out before I could close the door.\",\n",
+    "    \"It's supposed to rain and thunder tomorrow.\"\n",
+    "]"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### OpenAI Embeddings\n",
+    "Before working with OpenAI Embeddings, we clean up our existing search index and create a new one."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# delete index\n",
+    "r.ft(INDEX_NAME).dropindex(delete_documents=True)\n",
+    "\n",
+    "# make a new one\n",
+    "create_index(vector_dimensions=VECTOR_DIMENSIONS)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "%pip install openai"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import openai\n",
+    "\n",
+    "# set your OpenAI API key - get one at https://platform.openai.com\n",
+    "openai.api_key = \"YOUR OPENAI API KEY\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create Embeddings with OpenAI text-embedding-ada-002\n",
+    "# https://openai.com/blog/new-and-improved-embedding-model\n",
+    "response = openai.Embedding.create(input=texts, engine=\"text-embedding-ada-002\")\n",
+    "embeddings = np.array([r[\"embedding\"] for r in response[\"data\"]], dtype=np.float32)\n",
+    "\n",
+    "# Write to Redis\n",
+    "pipe = r.pipeline()\n",
+    "for i, embedding in enumerate(embeddings):\n",
+    "    pipe.hset(f\"doc:{i}\", mapping = {\n",
+    "        \"vector\": embedding.tobytes(),\n",
+    "        \"content\": texts[i],\n",
+    "        \"tag\": \"openai\"\n",
+    "    })\n",
+    "res = pipe.execute()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "array([[ 0.00509819,  0.0010873 , -0.00228475, ..., -0.00457579,\n",
+       "         0.01329307, -0.03167175],\n",
+       "       [-0.00357223, -0.00550784, -0.01314328, ..., -0.02915693,\n",
+       "         0.01470436, -0.01367203],\n",
+       "       [-0.01284631,  0.0034875 , -0.01719686, ..., -0.01537451,\n",
+       "         0.01953256, -0.05048691],\n",
+       "       [-0.01145045, -0.00785481,  0.00206323, ..., -0.02070181,\n",
+       "        -0.01629098, -0.00300795]], dtype=float32)"
+      ]
+     },
+     "execution_count": 12,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "embeddings"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Search with OpenAI Embeddings\n",
+    "\n",
+    "Now that we've created embeddings with OpenAI, we can also perform a search to find relevant documents to some input text.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "array([ 0.00062901, -0.0070723 , -0.00148926, ..., -0.01904645,\n",
+       "       -0.00436092, -0.01117944], dtype=float32)"
+      ]
+     },
+     "execution_count": 13,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "text = \"animals\"\n",
+    "\n",
+    "# create query embedding\n",
+    "response = openai.Embedding.create(input=[text], engine=\"text-embedding-ada-002\")\n",
+    "query_embedding = np.array([r[\"embedding\"] for r in response[\"data\"]], dtype=np.float32)[0]\n",
+    "\n",
+    "query_embedding"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "metadata": {},
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "Result{2 total, docs: [Document {'id': 'a', 'payload': None, '__v_score': '0'}, Document {'id': 'b', 'payload': None, '__v_score': '3.09485009821e+26'}]}"
+       "[Document {'id': 'doc:1', 'payload': None, 'score': '0.214349985123', 'content': 'The dog next door barks really loudly.', 'tag': 'openai'},\n",
+       " Document {'id': 'doc:2', 'payload': None, 'score': '0.237052619457', 'content': 'My cat escaped and got out before I could close the door.', 'tag': 'openai'}]"
       ]
      },
-     "execution_count": 2,
+     "execution_count": 14,
      "metadata": {},
      "output_type": "execute_result"
     }
    ],
    "source": [
-    "r.hset(\"a\", \"v\", \"aaaaaaaa\")\n",
-    "r.hset(\"b\", \"v\", \"aaaabaaa\")\n",
-    "r.hset(\"c\", \"v\", \"aaaaabaa\")\n",
+    "# query for similar documents that have the openai tag\n",
+    "query = (\n",
+    "    Query(\"(@tag:{ openai })=>[KNN 2 @vector $vec as score]\")\n",
+    "     .sort_by(\"score\")\n",
+    "     .return_fields(\"content\", \"tag\", \"score\")\n",
+    "     .paging(0, 2)\n",
+    "     .dialect(2)\n",
+    ")\n",
+    "\n",
+    "query_params = {\"vec\": query_embedding.tobytes()}\n",
+    "r.ft(INDEX_NAME).search(query, query_params).docs\n",
     "\n",
-    "q = Query(\"*=>[KNN 2 @v $vec]\").return_field(\"__v_score\").dialect(2)\n",
-    "r.ft().search(q, query_params={\"vec\": \"aaaaaaaa\"})"
+    "# the two pieces of content related to animals are returned"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Cohere Embeddings\n",
+    "Before working with Cohere Embeddings, we clean up our existing search index and create a new one."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# delete index\n",
+    "r.ft(INDEX_NAME).dropindex(delete_documents=True)\n",
+    "\n",
+    "# make a new one for cohere embeddings (1024 dimensions)\n",
+    "VECTOR_DIMENSIONS = 1024\n",
+    "create_index(vector_dimensions=VECTOR_DIMENSIONS)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "%pip install cohere"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cohere\n",
+    "\n",
+    "co = cohere.Client(\"YOUR COHERE API KEY\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create Embeddings with Cohere\n",
+    "# https://docs.cohere.ai/docs/embeddings\n",
+    "response = co.embed(texts=texts, model=\"small\")\n",
+    "embeddings = np.array(response.embeddings, dtype=np.float32)\n",
+    "\n",
+    "# Write to Redis\n",
+    "for i, embedding in enumerate(embeddings):\n",
+    "    r.hset(f\"doc:{i}\", mapping = {\n",
+    "        \"vector\": embedding.tobytes(),\n",
+    "        \"content\": texts[i],\n",
+    "        \"tag\": \"cohere\"\n",
+    "    })"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "array([[-0.3034668 , -0.71533203, -0.2836914 , ...,  0.81152344,\n",
+       "         1.0253906 , -0.8095703 ],\n",
+       "       [-0.02560425, -1.4912109 ,  0.24267578, ..., -0.89746094,\n",
+       "         0.15625   , -3.203125  ],\n",
+       "       [ 0.10125732,  0.7246094 , -0.29516602, ..., -1.9638672 ,\n",
+       "         1.6630859 , -0.23291016],\n",
+       "       [-2.09375   ,  0.8588867 , -0.23352051, ..., -0.01541138,\n",
+       "         0.17053223, -3.4042969 ]], dtype=float32)"
+      ]
+     },
+     "execution_count": 18,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "embeddings"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Search with Cohere Embeddings\n",
+    "\n",
+    "Now that we've created embeddings with Cohere, we can also perform a search to find relevant documents to some input text."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 19,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "array([-0.49682617,  1.7070312 ,  0.3466797 , ...,  0.58984375,\n",
+       "        0.1060791 , -2.9023438 ], dtype=float32)"
+      ]
+     },
+     "execution_count": 19,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "text = \"animals\"\n",
+    "\n",
+    "# create query embedding\n",
+    "response = co.embed(texts=[text], model=\"small\")\n",
+    "query_embedding = np.array(response.embeddings[0], dtype=np.float32)\n",
+    "\n",
+    "query_embedding"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[Document {'id': 'doc:1', 'payload': None, 'score': '0.658673524857', 'content': 'The dog next door barks really loudly.', 'tag': 'cohere'},\n",
+       " Document {'id': 'doc:2', 'payload': None, 'score': '0.662699103355', 'content': 'My cat escaped and got out before I could close the door.', 'tag': 'cohere'}]"
+      ]
+     },
+     "execution_count": 20,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# query for similar documents that have the cohere tag\n",
+    "query = (\n",
+    "    Query(\"(@tag:{ cohere })=>[KNN 2 @vector $vec as score]\")\n",
+    "     .sort_by(\"score\")\n",
+    "     .return_fields(\"content\", \"tag\", \"score\")\n",
+    "     .paging(0, 2)\n",
+    "     .dialect(2)\n",
+    ")\n",
+    "\n",
+    "query_params = {\"vec\": query_embedding.tobytes()}\n",
+    "r.ft(INDEX_NAME).search(query, query_params).docs\n",
+    "\n",
+    "# the two pieces of content related to animals are returned"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Find more example apps, tutorials, and projects using Redis Vector Similarity Search [in this GitHub organization](https://github.com/RedisVentures)."
    ]
   }
  ],
@@ -98,7 +660,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.9.2"
+   "version": "3.9.12"
   },
   "orig_nbformat": 4
  },

From d6bb4573618672d525c84877ec69827ff975299f Mon Sep 17 00:00:00 2001
From: Felipe Machado <462154+felipou@users.noreply.github.com>
Date: Thu, 27 Apr 2023 11:17:17 -0300
Subject: [PATCH 0707/1164] Fix incorrect usage of once flag in async Sentinel
 (#2718)

In the execute_command of the async Sentinel, the once flag was being
used incorrectly, with its meaning inverted. To fix we just needed to invert
the if and else bodies. This isn't being caught by the tests currently
because the tests of commands that use this flag do not check their
results/effects (for example the "test_ckquorum" test).
---
 CHANGES                   | 1 +
 redis/asyncio/sentinel.py | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/CHANGES b/CHANGES
index 429045f9a5..d1e4b2aa75 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Fix incorrect usage of once flag in async Sentinel
     * asyncio: Fix memory leak caused by hiredis (#2693)
     * Allow data to drain from async PythonParser when reading during a disconnect()
     * Use asyncio.timeout() instead of async_timeout.timeout() for python >= 3.11 (#2602)
diff --git a/redis/asyncio/sentinel.py b/redis/asyncio/sentinel.py
index ec17886fc6..c3c0f91545 100644
--- a/redis/asyncio/sentinel.py
+++ b/redis/asyncio/sentinel.py
@@ -220,13 +220,13 @@ async def execute_command(self, *args, **kwargs):
             kwargs.pop("once")
 
         if once:
+            await random.choice(self.sentinels).execute_command(*args, **kwargs)
+        else:
             tasks = [
                 asyncio.Task(sentinel.execute_command(*args, **kwargs))
                 for sentinel in self.sentinels
             ]
             await asyncio.gather(*tasks)
-        else:
-            await random.choice(self.sentinels).execute_command(*args, **kwargs)
         return True
 
     def __repr__(self):

From fddd3d6b306724988249d117cd9e405ac78ffecc Mon Sep 17 00:00:00 2001
From: AYMEN Mohammed <53928879+AYMENJD@users.noreply.github.com>
Date: Thu, 27 Apr 2023 17:17:27 +0300
Subject: [PATCH 0708/1164] Fix topk list example. (#2724)

---
 docs/redismodules.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/redismodules.rst b/docs/redismodules.rst
index a133f03cb5..2ac46510be 100644
--- a/docs/redismodules.rst
+++ b/docs/redismodules.rst
@@ -44,7 +44,7 @@ These are the commands for interacting with the `RedisBloom module <https://redi
     import redis
     r = redis.Redis()
     r.topk().reserve("mytopk", 3, 50, 4, 0.9)
-    r.topk().info("mytopk)
+    r.topk().info("mytopk")
 
 .. automodule:: redis.commands.bf.commands
     :members: BFCommands, CFCommands, CMSCommands, TOPKCommands

From 8e0b84d8a25c90070817c911af266cd5cabe1604 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marc=20Sch=C3=B6chlin?= <ms-github@256bit.org>
Date: Thu, 27 Apr 2023 16:18:09 +0200
Subject: [PATCH 0709/1164] Improve error output for master discovery (#2720)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Make MasterNotFoundError exception more precise in the case of
ConnectionError and TimeoutError to help the user to identify
configuration errors

Co-authored-by: Marc Schöchlin <marc.schoechlin@flipapp.de>
---
 CHANGES                   |  1 +
 redis/asyncio/sentinel.py | 10 ++++++++--
 redis/sentinel.py         | 10 ++++++++--
 3 files changed, 17 insertions(+), 4 deletions(-)

diff --git a/CHANGES b/CHANGES
index d1e4b2aa75..8c6100d59d 100644
--- a/CHANGES
+++ b/CHANGES
@@ -42,6 +42,7 @@
     * Fix Sentinel.execute_command doesn't execute across the entire sentinel cluster bug (#2458)
     * Added a replacement for the default cluster node in the event of failure (#2463)
     * Fix for Unhandled exception related to self.host with unix socket (#2496)
+    * Improve error output for master discovery 
 
 * 4.1.3 (Feb 8, 2022)
     * Fix flushdb and flushall (#1926)
diff --git a/redis/asyncio/sentinel.py b/redis/asyncio/sentinel.py
index c3c0f91545..9147ed83d1 100644
--- a/redis/asyncio/sentinel.py
+++ b/redis/asyncio/sentinel.py
@@ -254,10 +254,12 @@ async def discover_master(self, service_name: str):
         Returns a pair (address, port) or raises MasterNotFoundError if no
         master is found.
         """
+        collected_errors = list()
         for sentinel_no, sentinel in enumerate(self.sentinels):
             try:
                 masters = await sentinel.sentinel_masters()
-            except (ConnectionError, TimeoutError):
+            except (ConnectionError, TimeoutError) as e:
+                collected_errors.append(f"{sentinel} - {e!r}")
                 continue
             state = masters.get(service_name)
             if state and self.check_master_state(state, service_name):
@@ -267,7 +269,11 @@ async def discover_master(self, service_name: str):
                     self.sentinels[0],
                 )
                 return state["ip"], state["port"]
-        raise MasterNotFoundError(f"No master found for {service_name!r}")
+
+        error_info = ""
+        if len(collected_errors) > 0:
+            error_info = f" : {', '.join(collected_errors)}"
+        raise MasterNotFoundError(f"No master found for {service_name!r}{error_info}")
 
     def filter_slaves(
         self, slaves: Iterable[Mapping]
diff --git a/redis/sentinel.py b/redis/sentinel.py
index d70b7142b5..ac6921aa01 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -230,10 +230,12 @@ def discover_master(self, service_name):
         Returns a pair (address, port) or raises MasterNotFoundError if no
         master is found.
         """
+        collected_errors = list()
         for sentinel_no, sentinel in enumerate(self.sentinels):
             try:
                 masters = sentinel.sentinel_masters()
-            except (ConnectionError, TimeoutError):
+            except (ConnectionError, TimeoutError) as e:
+                collected_errors.append(f"{sentinel} - {e!r}")
                 continue
             state = masters.get(service_name)
             if state and self.check_master_state(state, service_name):
@@ -243,7 +245,11 @@ def discover_master(self, service_name):
                     self.sentinels[0],
                 )
                 return state["ip"], state["port"]
-        raise MasterNotFoundError(f"No master found for {service_name!r}")
+
+        error_info = ""
+        if len(collected_errors) > 0:
+            error_info = f" : {', '.join(collected_errors)}"
+        raise MasterNotFoundError(f"No master found for {service_name!r}{error_info}")
 
     def filter_slaves(self, slaves):
         "Remove slaves that are in an ODOWN or SDOWN state"

From 8b58ebb73e03970fade4d3f9e2c961831713c228 Mon Sep 17 00:00:00 2001
From: shacharPash <93581407+shacharPash@users.noreply.github.com>
Date: Sun, 30 Apr 2023 04:13:54 +0300
Subject: [PATCH 0710/1164] return response in case of KeyError (#2628)

* return response in case of KeyError

* fix code linters error

* fix linters 2

* fix linters 3
---
 redis/client.py        | 11 +++++++----
 tests/test_commands.py |  6 ++++++
 2 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 1a9b96b83d..79a7bff2a2 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -518,10 +518,13 @@ def parse_geosearch_generic(response, **options):
     Parse the response of 'GEOSEARCH', GEORADIUS' and 'GEORADIUSBYMEMBER'
     commands according to 'withdist', 'withhash' and 'withcoord' labels.
     """
-    if options["store"] or options["store_dist"]:
-        # `store` and `store_dist` cant be combined
-        # with other command arguments.
-        # relevant to 'GEORADIUS' and 'GEORADIUSBYMEMBER'
+    try:
+        if options["store"] or options["store_dist"]:
+            # `store` and `store_dist` cant be combined
+            # with other command arguments.
+            # relevant to 'GEORADIUS' and 'GEORADIUSBYMEMBER'
+            return response
+    except KeyError:  # it means the command was sent via execute_command
         return response
 
     if type(response) != list:
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 94249e9419..a44dac42af 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -3508,6 +3508,12 @@ def test_geosearchstore_dist(self, r):
         # instead of save the geo score, the distance is saved.
         assert r.zscore("places_barcelona", "place1") == 88.05060698409301
 
+    @skip_if_server_version_lt("3.2.0")
+    def test_georadius_Issue2609(self, r):
+        # test for issue #2609 (Geo search functions don't work with execute_command)
+        r.geoadd(name="my-key", values=[1, 2, "data"])
+        assert r.execute_command("GEORADIUS", "my-key", 1, 2, 400, "m") == [b"data"]
+
     @skip_if_server_version_lt("3.2.0")
     def test_georadius(self, r):
         values = (2.1909389952632, 41.433791470673, "place1") + (

From bf528fc7f776ce8e926b2e9abfa4e2460d73baa4 Mon Sep 17 00:00:00 2001
From: shacharPash <93581407+shacharPash@users.noreply.github.com>
Date: Sun, 30 Apr 2023 14:57:27 +0300
Subject: [PATCH 0711/1164] Add WITHSCORES to ZREVRANK Command (#2725)

* add withscores to zrevrank

* change 0 -> 2

* fix errors

* split test
---
 redis/commands/core.py              | 13 +++++++++++--
 tests/test_asyncio/test_commands.py |  9 +++++++++
 tests/test_commands.py              |  9 +++++++++
 3 files changed, 29 insertions(+), 2 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index e2cabb85fa..d67291b314 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -4693,13 +4693,22 @@ def zremrangebyscore(
         """
         return self.execute_command("ZREMRANGEBYSCORE", name, min, max)
 
-    def zrevrank(self, name: KeyT, value: EncodableT) -> ResponseT:
+    def zrevrank(
+        self,
+        name: KeyT,
+        value: EncodableT,
+        withscore: bool = False,
+    ) -> ResponseT:
         """
         Returns a 0-based value indicating the descending rank of
-        ``value`` in sorted set ``name``
+        ``value`` in sorted set ``name``.
+        The optional ``withscore`` argument supplements the command's
+        reply with the score of the element returned.
 
         For more information see https://redis.io/commands/zrevrank
         """
+        if withscore:
+            return self.execute_command("ZREVRANK", name, value, "WITHSCORE")
         return self.execute_command("ZREVRANK", name, value)
 
     def zscore(self, name: KeyT, value: EncodableT) -> ResponseT:
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 7c6fd45ab9..409934c9a3 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -1710,6 +1710,15 @@ async def test_zrevrank(self, r: redis.Redis):
         assert await r.zrevrank("a", "a2") == 3
         assert await r.zrevrank("a", "a6") is None
 
+    @skip_if_server_version_lt("7.2.0")
+    async def test_zrevrank_withscore(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
+        assert await r.zrevrank("a", "a1") == 4
+        assert await r.zrevrank("a", "a2") == 3
+        assert await r.zrevrank("a", "a6") is None
+        assert await r.zrevrank("a", "a3", withscore=True) == [2, "3"]
+        assert await r.zrevrank("a", "a6", withscore=True) is None
+
     async def test_zscore(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
         assert await r.zscore("a", "a1") == 1.0
diff --git a/tests/test_commands.py b/tests/test_commands.py
index a44dac42af..2b769be34d 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2641,6 +2641,15 @@ def test_zrevrank(self, r):
         assert r.zrevrank("a", "a2") == 3
         assert r.zrevrank("a", "a6") is None
 
+    @skip_if_server_version_lt("7.2.0")
+    def test_zrevrank_withscore(self, r):
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
+        assert r.zrevrank("a", "a1") == 4
+        assert r.zrevrank("a", "a2") == 3
+        assert r.zrevrank("a", "a6") is None
+        assert r.zrevrank("a", "a3", withscore=True) == [2, "3"]
+        assert r.zrevrank("a", "a6", withscore=True) is None
+
     def test_zscore(self, r):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
         assert r.zscore("a", "a1") == 1.0

From 1ca223a9d0df046075dddd4b572791915d657ae7 Mon Sep 17 00:00:00 2001
From: Avasam <samuel.06@hotmail.com>
Date: Mon, 1 May 2023 02:48:19 -0400
Subject: [PATCH 0712/1164] Fix `ClusterCommandProtocol` not itself being
 marked as a protocol (#2729)

* Fix `ClusterCommandProtocol` not itself being marked as a protocol

* Update CHANGES
---
 CHANGES         | 1 +
 redis/typing.py | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/CHANGES b/CHANGES
index 8c6100d59d..8f2017218a 100644
--- a/CHANGES
+++ b/CHANGES
@@ -43,6 +43,7 @@
     * Added a replacement for the default cluster node in the event of failure (#2463)
     * Fix for Unhandled exception related to self.host with unix socket (#2496)
     * Improve error output for master discovery 
+    * Make `ClusterCommandsProtocol` an actual Protocol
 
 * 4.1.3 (Feb 8, 2022)
     * Fix flushdb and flushall (#1926)
diff --git a/redis/typing.py b/redis/typing.py
index 8504c7de0c..47a255652a 100644
--- a/redis/typing.py
+++ b/redis/typing.py
@@ -47,7 +47,7 @@ def execute_command(self, *args, **options):
         ...
 
 
-class ClusterCommandsProtocol(CommandsProtocol):
+class ClusterCommandsProtocol(CommandsProtocol, Protocol):
     encoder: Union["AsyncEncoder", "Encoder"]
 
     def execute_command(self, *args, **options) -> Union[Any, Awaitable]:

From ac15d529edf2832af4c95349f6c0e9af2418448d Mon Sep 17 00:00:00 2001
From: Markus Gerstel <2102431+Anthchirp@users.noreply.github.com>
Date: Mon, 1 May 2023 09:21:18 +0100
Subject: [PATCH 0713/1164] Fix potential race condition during disconnection
 (#2719)

When the disconnect() function is called twice in parallel it is possible that
one thread deletes the self._sock reference, while the other thread will
attempt to call .close() on it, leading to an AttributeError.

This situation can routinely be encountered by closing the connection in a
PubSubWorkerThread error handler in a blocking thread (ie. with
sleep_time==None), and then calling .close() on the PubSub object.
The main thread will then run into the disconnect() function, and the listener
thread is woken up by the closure and will race into the disconnect()
function, too.

This can be fixed easily by copying the object reference before doing the
None-check, similar to what we do in the redis.client.close() function.
---
 redis/connection.py | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/redis/connection.py b/redis/connection.py
index eefdd96523..8b2389c6db 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -779,20 +779,22 @@ def on_connect(self):
     def disconnect(self, *args):
         "Disconnects from the Redis server"
         self._parser.on_disconnect()
-        if self._sock is None:
+
+        conn_sock = self._sock
+        self._sock = None
+        if conn_sock is None:
             return
 
         if os.getpid() == self.pid:
             try:
-                self._sock.shutdown(socket.SHUT_RDWR)
+                conn_sock.shutdown(socket.SHUT_RDWR)
             except OSError:
                 pass
 
         try:
-            self._sock.close()
+            conn_sock.close()
         except OSError:
             pass
-        self._sock = None
 
     def _send_ping(self):
         """Send PING, expect PONG in return"""

From a7857e106bad02f4fc01c6ae69573d53d9018950 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Tue, 2 May 2023 15:06:29 +0000
Subject: [PATCH 0714/1164] add "address_remap" feature to RedisCluster (#2726)

* add cluster "host_port_remap" feature for asyncio.RedisCluster

* Add a unittest for asyncio.RedisCluster

* Add host_port_remap to _sync_ RedisCluster

* add synchronous tests

* rename arg to `address_remap` and take and return an address tuple.

* Add class documentation

* Add CHANGES
---
 CHANGES                            |   1 +
 redis/asyncio/cluster.py           |  31 ++++++-
 redis/cluster.py                   |  22 +++++
 tests/test_asyncio/test_cluster.py | 110 +++++++++++++++++++++++-
 tests/test_cluster.py              | 129 +++++++++++++++++++++++++++++
 5 files changed, 291 insertions(+), 2 deletions(-)

diff --git a/CHANGES b/CHANGES
index 8f2017218a..3865ed1067 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Add `address_remap` parameter to `RedisCluster`
     * Fix incorrect usage of once flag in async Sentinel
     * asyncio: Fix memory leak caused by hiredis (#2693)
     * Allow data to drain from async PythonParser when reading during a disconnect()
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index a4a9561cf1..eb5f4db061 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -5,12 +5,14 @@
 import warnings
 from typing import (
     Any,
+    Callable,
     Deque,
     Dict,
     Generator,
     List,
     Mapping,
     Optional,
+    Tuple,
     Type,
     TypeVar,
     Union,
@@ -147,6 +149,12 @@ class RedisCluster(AbstractRedis, AbstractRedisCluster, AsyncRedisClusterCommand
           maximum number of connections are already created, a
           :class:`~.MaxConnectionsError` is raised. This error may be retried as defined
           by :attr:`connection_error_retry_attempts`
+    :param address_remap:
+        | An optional callable which, when provided with an internal network
+          address of a node, e.g. a `(host, port)` tuple, will return the address
+          where the node is reachable.  This can be used to map the addresses at
+          which the nodes _think_ they are, to addresses at which a client may
+          reach them, such as when they sit behind a proxy.
 
     | Rest of the arguments will be passed to the
       :class:`~redis.asyncio.connection.Connection` instances when created
@@ -250,6 +258,7 @@ def __init__(
         ssl_certfile: Optional[str] = None,
         ssl_check_hostname: bool = False,
         ssl_keyfile: Optional[str] = None,
+        address_remap: Optional[Callable[[str, int], Tuple[str, int]]] = None,
     ) -> None:
         if db:
             raise RedisClusterException(
@@ -337,7 +346,12 @@ def __init__(
         if host and port:
             startup_nodes.append(ClusterNode(host, port, **self.connection_kwargs))
 
-        self.nodes_manager = NodesManager(startup_nodes, require_full_coverage, kwargs)
+        self.nodes_manager = NodesManager(
+            startup_nodes,
+            require_full_coverage,
+            kwargs,
+            address_remap=address_remap,
+        )
         self.encoder = Encoder(encoding, encoding_errors, decode_responses)
         self.read_from_replicas = read_from_replicas
         self.reinitialize_steps = reinitialize_steps
@@ -1059,6 +1073,7 @@ class NodesManager:
         "require_full_coverage",
         "slots_cache",
         "startup_nodes",
+        "address_remap",
     )
 
     def __init__(
@@ -1066,10 +1081,12 @@ def __init__(
         startup_nodes: List["ClusterNode"],
         require_full_coverage: bool,
         connection_kwargs: Dict[str, Any],
+        address_remap: Optional[Callable[[str, int], Tuple[str, int]]] = None,
     ) -> None:
         self.startup_nodes = {node.name: node for node in startup_nodes}
         self.require_full_coverage = require_full_coverage
         self.connection_kwargs = connection_kwargs
+        self.address_remap = address_remap
 
         self.default_node: "ClusterNode" = None
         self.nodes_cache: Dict[str, "ClusterNode"] = {}
@@ -1228,6 +1245,7 @@ async def initialize(self) -> None:
                 if host == "":
                     host = startup_node.host
                 port = int(primary_node[1])
+                host, port = self.remap_host_port(host, port)
 
                 target_node = tmp_nodes_cache.get(get_node_name(host, port))
                 if not target_node:
@@ -1246,6 +1264,7 @@ async def initialize(self) -> None:
                         for replica_node in replica_nodes:
                             host = replica_node[0]
                             port = replica_node[1]
+                            host, port = self.remap_host_port(host, port)
 
                             target_replica_node = tmp_nodes_cache.get(
                                 get_node_name(host, port)
@@ -1319,6 +1338,16 @@ async def close(self, attr: str = "nodes_cache") -> None:
             )
         )
 
+    def remap_host_port(self, host: str, port: int) -> Tuple[str, int]:
+        """
+        Remap the host and port returned from the cluster to a different
+        internal value.  Useful if the client is not connecting directly
+        to the cluster.
+        """
+        if self.address_remap:
+            return self.address_remap((host, port))
+        return host, port
+
 
 class ClusterPipeline(AbstractRedis, AbstractRedisCluster, AsyncRedisClusterCommands):
     """
diff --git a/redis/cluster.py b/redis/cluster.py
index 5e6e7da546..3ecc2dab56 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -466,6 +466,7 @@ def __init__(
         read_from_replicas: bool = False,
         dynamic_startup_nodes: bool = True,
         url: Optional[str] = None,
+        address_remap: Optional[Callable[[str, int], Tuple[str, int]]] = None,
         **kwargs,
     ):
         """
@@ -514,6 +515,12 @@ def __init__(
             reinitialize_steps to 1.
             To avoid reinitializing the cluster on moved errors, set
             reinitialize_steps to 0.
+        :param address_remap:
+            An optional callable which, when provided with an internal network
+            address of a node, e.g. a `(host, port)` tuple, will return the address
+            where the node is reachable.  This can be used to map the addresses at
+            which the nodes _think_ they are, to addresses at which a client may
+            reach them, such as when they sit behind a proxy.
 
          :**kwargs:
              Extra arguments that will be sent into Redis instance when created
@@ -594,6 +601,7 @@ def __init__(
             from_url=from_url,
             require_full_coverage=require_full_coverage,
             dynamic_startup_nodes=dynamic_startup_nodes,
+            address_remap=address_remap,
             **kwargs,
         )
 
@@ -1269,6 +1277,7 @@ def __init__(
         lock=None,
         dynamic_startup_nodes=True,
         connection_pool_class=ConnectionPool,
+        address_remap: Optional[Callable[[str, int], Tuple[str, int]]] = None,
         **kwargs,
     ):
         self.nodes_cache = {}
@@ -1280,6 +1289,7 @@ def __init__(
         self._require_full_coverage = require_full_coverage
         self._dynamic_startup_nodes = dynamic_startup_nodes
         self.connection_pool_class = connection_pool_class
+        self.address_remap = address_remap
         self._moved_exception = None
         self.connection_kwargs = kwargs
         self.read_load_balancer = LoadBalancer()
@@ -1502,6 +1512,7 @@ def initialize(self):
                 if host == "":
                     host = startup_node.host
                 port = int(primary_node[1])
+                host, port = self.remap_host_port(host, port)
 
                 target_node = self._get_or_create_cluster_node(
                     host, port, PRIMARY, tmp_nodes_cache
@@ -1518,6 +1529,7 @@ def initialize(self):
                         for replica_node in replica_nodes:
                             host = str_if_bytes(replica_node[0])
                             port = replica_node[1]
+                            host, port = self.remap_host_port(host, port)
 
                             target_replica_node = self._get_or_create_cluster_node(
                                 host, port, REPLICA, tmp_nodes_cache
@@ -1591,6 +1603,16 @@ def reset(self):
             # The read_load_balancer is None, do nothing
             pass
 
+    def remap_host_port(self, host: str, port: int) -> Tuple[str, int]:
+        """
+        Remap the host and port returned from the cluster to a different
+        internal value.  Useful if the client is not connecting directly
+        to the cluster.
+        """
+        if self.address_remap:
+            return self.address_remap((host, port))
+        return host, port
+
 
 class ClusterPubSub(PubSub):
     """
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 13e5e26ae3..6d0aba73fb 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -11,7 +11,7 @@
 from _pytest.fixtures import FixtureRequest
 
 from redis.asyncio.cluster import ClusterNode, NodesManager, RedisCluster
-from redis.asyncio.connection import Connection, SSLConnection
+from redis.asyncio.connection import Connection, SSLConnection, async_timeout
 from redis.asyncio.parser import CommandsParser
 from redis.asyncio.retry import Retry
 from redis.backoff import ExponentialBackoff, NoBackoff, default_backoff
@@ -49,6 +49,71 @@
 ]
 
 
+class NodeProxy:
+    """A class to proxy a node connection to a different port"""
+
+    def __init__(self, addr, redis_addr):
+        self.addr = addr
+        self.redis_addr = redis_addr
+        self.send_event = asyncio.Event()
+        self.server = None
+        self.task = None
+        self.n_connections = 0
+
+    async def start(self):
+        # test that we can connect to redis
+        async with async_timeout(2):
+            _, redis_writer = await asyncio.open_connection(*self.redis_addr)
+        redis_writer.close()
+        self.server = await asyncio.start_server(
+            self.handle, *self.addr, reuse_address=True
+        )
+        self.task = asyncio.create_task(self.server.serve_forever())
+
+    async def handle(self, reader, writer):
+        # establish connection to redis
+        redis_reader, redis_writer = await asyncio.open_connection(*self.redis_addr)
+        try:
+            self.n_connections += 1
+            pipe1 = asyncio.create_task(self.pipe(reader, redis_writer))
+            pipe2 = asyncio.create_task(self.pipe(redis_reader, writer))
+            await asyncio.gather(pipe1, pipe2)
+        finally:
+            redis_writer.close()
+
+    async def aclose(self):
+        self.task.cancel()
+        try:
+            await self.task
+        except asyncio.CancelledError:
+            pass
+        await self.server.wait_closed()
+
+    async def pipe(
+        self,
+        reader: asyncio.StreamReader,
+        writer: asyncio.StreamWriter,
+    ):
+        while True:
+            data = await reader.read(1000)
+            if not data:
+                break
+            writer.write(data)
+            await writer.drain()
+
+
+@pytest.fixture
+def redis_addr(request):
+    redis_url = request.config.getoption("--redis-url")
+    scheme, netloc = urlparse(redis_url)[:2]
+    assert scheme == "redis"
+    if ":" in netloc:
+        host, port = netloc.split(":")
+        return host, int(port)
+    else:
+        return netloc, 6379
+
+
 @pytest_asyncio.fixture()
 async def slowlog(r: RedisCluster) -> None:
     """
@@ -809,6 +874,49 @@ async def test_default_node_is_replaced_after_exception(self, r):
         # Rollback to the old default node
         r.replace_default_node(curr_default_node)
 
+    async def test_address_remap(self, create_redis, redis_addr):
+        """Test that we can create a rediscluster object with
+        a host-port remapper and map connections through proxy objects
+        """
+
+        # we remap the first n nodes
+        offset = 1000
+        n = 6
+        ports = [redis_addr[1] + i for i in range(n)]
+
+        def address_remap(address):
+            # remap first three nodes to our local proxy
+            # old = host, port
+            host, port = address
+            if int(port) in ports:
+                host, port = "127.0.0.1", int(port) + offset
+            # print(f"{old} {host, port}")
+            return host, port
+
+        # create the proxies
+        proxies = [
+            NodeProxy(("127.0.0.1", port + offset), (redis_addr[0], port))
+            for port in ports
+        ]
+        await asyncio.gather(*[p.start() for p in proxies])
+        try:
+            # create cluster:
+            r = await create_redis(
+                cls=RedisCluster, flushdb=False, address_remap=address_remap
+            )
+            try:
+                assert await r.ping() is True
+                assert await r.set("byte_string", b"giraffe")
+                assert await r.get("byte_string") == b"giraffe"
+            finally:
+                await r.close()
+        finally:
+            await asyncio.gather(*[p.aclose() for p in proxies])
+
+        # verify that the proxies were indeed used
+        n_used = sum((1 if p.n_connections else 0) for p in proxies)
+        assert n_used > 1
+
 
 class TestClusterRedisCommands:
     """
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 58f9b77d7d..1f037c9edf 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -1,9 +1,14 @@
 import binascii
 import datetime
+import select
+import socket
+import socketserver
+import threading
 import warnings
 from queue import LifoQueue, Queue
 from time import sleep
 from unittest.mock import DEFAULT, Mock, call, patch
+from urllib.parse import urlparse
 
 import pytest
 
@@ -53,6 +58,85 @@
 ]
 
 
+class ProxyRequestHandler(socketserver.BaseRequestHandler):
+    def recv(self, sock):
+        """A recv with a timeout"""
+        r = select.select([sock], [], [], 0.01)
+        if not r[0]:
+            return None
+        return sock.recv(1000)
+
+    def handle(self):
+        self.server.proxy.n_connections += 1
+        conn = socket.create_connection(self.server.proxy.redis_addr)
+        stop = False
+
+        def from_server():
+            # read from server and pass to client
+            while not stop:
+                data = self.recv(conn)
+                if data is None:
+                    continue
+                if not data:
+                    self.request.shutdown(socket.SHUT_WR)
+                    return
+                self.request.sendall(data)
+
+        thread = threading.Thread(target=from_server)
+        thread.start()
+        try:
+            while True:
+                # read from client and send to server
+                data = self.request.recv(1000)
+                if not data:
+                    return
+                conn.sendall(data)
+        finally:
+            conn.shutdown(socket.SHUT_WR)
+            stop = True  # for safety
+            thread.join()
+            conn.close()
+
+
+class NodeProxy:
+    """A class to proxy a node connection to a different port"""
+
+    def __init__(self, addr, redis_addr):
+        self.addr = addr
+        self.redis_addr = redis_addr
+        self.server = socketserver.ThreadingTCPServer(self.addr, ProxyRequestHandler)
+        self.server.proxy = self
+        self.server.socket_reuse_address = True
+        self.thread = None
+        self.n_connections = 0
+
+    def start(self):
+        # test that we can connect to redis
+        s = socket.create_connection(self.redis_addr, timeout=2)
+        s.close()
+        # Start a thread with the server -- that thread will then start one
+        # more thread for each request
+        self.thread = threading.Thread(target=self.server.serve_forever)
+        # Exit the server thread when the main thread terminates
+        self.thread.daemon = True
+        self.thread.start()
+
+    def close(self):
+        self.server.shutdown()
+
+
+@pytest.fixture
+def redis_addr(request):
+    redis_url = request.config.getoption("--redis-url")
+    scheme, netloc = urlparse(redis_url)[:2]
+    assert scheme == "redis"
+    if ":" in netloc:
+        host, port = netloc.split(":")
+        return host, int(port)
+    else:
+        return netloc, 6379
+
+
 @pytest.fixture()
 def slowlog(request, r):
     """
@@ -823,6 +907,51 @@ def raise_connection_error():
         assert "myself" not in nodes.get(curr_default_node.name).get("flags")
         assert r.get_default_node() != curr_default_node
 
+    def test_address_remap(self, request, redis_addr):
+        """Test that we can create a rediscluster object with
+        a host-port remapper and map connections through proxy objects
+        """
+
+        # we remap the first n nodes
+        offset = 1000
+        n = 6
+        ports = [redis_addr[1] + i for i in range(n)]
+
+        def address_remap(address):
+            # remap first three nodes to our local proxy
+            # old = host, port
+            host, port = address
+            if int(port) in ports:
+                host, port = "127.0.0.1", int(port) + offset
+            # print(f"{old} {host, port}")
+            return host, port
+
+        # create the proxies
+        proxies = [
+            NodeProxy(("127.0.0.1", port + offset), (redis_addr[0], port))
+            for port in ports
+        ]
+        for p in proxies:
+            p.start()
+        try:
+            # create cluster:
+            r = _get_client(
+                RedisCluster, request, flushdb=False, address_remap=address_remap
+            )
+            try:
+                assert r.ping() is True
+                assert r.set("byte_string", b"giraffe")
+                assert r.get("byte_string") == b"giraffe"
+            finally:
+                r.close()
+        finally:
+            for p in proxies:
+                p.close()
+
+        # verify that the proxies were indeed used
+        n_used = sum((1 if p.n_connections else 0) for p in proxies)
+        assert n_used > 1
+
 
 @pytest.mark.onlycluster
 class TestClusterRedisCommands:

From e52fd672868f8085e45ae38454c4c920e78f44de Mon Sep 17 00:00:00 2001
From: shacharPash <93581407+shacharPash@users.noreply.github.com>
Date: Tue, 2 May 2023 18:06:47 +0300
Subject: [PATCH 0715/1164] nermina changes from NRedisStack (#2736)

---
 CONTRIBUTING.md | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index e31ec3491e..8518547518 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -2,15 +2,15 @@
 
 ## Introduction
 
-First off, thank you for considering contributing to redis-py. We value
-community contributions!
+We appreciate your interest in considering contributing to redis-py.
+Community contributions mean a lot to us.
 
-## Contributions We Need
+## Contributions we need
 
-You may already know what you want to contribute \-- a fix for a bug you
+You may already know how you'd like to contribute, whether it's a fix for a bug you
 encountered, or a new feature your team wants to use.
 
-If you don't know what to contribute, keep an open mind! Improving
+If you don't know where to start, consider improving
 documentation, bug triaging, and writing tutorials are all examples of
 helpful contributions that mean less work for you.
 
@@ -166,19 +166,19 @@ When filing an issue, make sure to answer these five questions:
 4.  What did you expect to see?
 5.  What did you see instead?
 
-## How to Suggest a Feature or Enhancement
+## Suggest a feature or enhancement
 
 If you'd like to contribute a new feature, make sure you check our
 issue list to see if someone has already proposed it. Work may already
-be under way on the feature you want -- or we may have rejected a
+be underway on the feature you want or we may have rejected a
 feature like it already.
 
 If you don't see anything, open a new issue that describes the feature
 you would like and how it should work.
 
-## Code Review Process
+## Code review process
 
-The core team looks at Pull Requests on a regular basis. We will give
-feedback as as soon as possible. After feedback, we expect a response
+The core team regularly looks at pull requests. We will provide
+feedback as as soon as possible. After receiving our feedback, please respond
 within two weeks. After that time, we may close your PR if it isn't
 showing any activity.

From 6d32503a58d841a41556cebcf188add324c6ce86 Mon Sep 17 00:00:00 2001
From: Nick Gerow <Nick.G.123@hotmail.com>
Date: Wed, 3 May 2023 09:27:32 -0400
Subject: [PATCH 0716/1164] Updated AWS Elasticache IAM Connection Example
 (#2702)

Co-authored-by: Nick Gerow <nick.gerow@enlightedinc.com>
---
 docs/examples/connection_examples.ipynb | 56 +++++++++++++++++++------
 1 file changed, 44 insertions(+), 12 deletions(-)

diff --git a/docs/examples/connection_examples.ipynb b/docs/examples/connection_examples.ipynb
index 7f5ac53e89..d15d964af7 100644
--- a/docs/examples/connection_examples.ipynb
+++ b/docs/examples/connection_examples.ipynb
@@ -267,28 +267,60 @@
     }
    ],
    "source": [
+    "from typing import Tuple, Union\n",
+    "from urllib.parse import ParseResult, urlencode, urlunparse\n",
+    "\n",
+    "import botocore.session\n",
     "import redis\n",
-    "import boto3\n",
-    "import cachetools.func\n",
+    "from botocore.model import ServiceId\n",
+    "from botocore.signers import RequestSigner\n",
+    "from cachetools import TTLCache, cached\n",
     "\n",
     "class ElastiCacheIAMProvider(redis.CredentialProvider):\n",
-    "    def __init__(self, user, endpoint, port=6379, region=\"us-east-1\"):\n",
-    "        self.ec_client = boto3.client('elasticache')\n",
+    "    def __init__(self, user, cluster_name, region=\"us-east-1\"):\n",
     "        self.user = user\n",
-    "        self.endpoint = endpoint\n",
-    "        self.port = port\n",
+    "        self.cluster_name = cluster_name\n",
     "        self.region = region\n",
     "\n",
+    "        session = botocore.session.get_session()\n",
+    "        self.request_signer = RequestSigner(\n",
+    "            ServiceId(\"elasticache\"),\n",
+    "            self.region,\n",
+    "            \"elasticache\",\n",
+    "            \"v4\",\n",
+    "            session.get_credentials(),\n",
+    "            session.get_component(\"event_emitter\"),\n",
+    "        )\n",
+    "\n",
+    "    # Generated IAM tokens are valid for 15 minutes\n",
+    "    @cached(cache=TTLCache(maxsize=128, ttl=900))\n",
     "    def get_credentials(self) -> Union[Tuple[str], Tuple[str, str]]:\n",
-    "        @cachetools.func.ttl_cache(maxsize=128, ttl=15 * 60) # 15m\n",
-    "        def get_iam_auth_token(user, endpoint, port, region):\n",
-    "            return self.ec_client.generate_iam_auth_token(user, endpoint, port, region)\n",
-    "        iam_auth_token = get_iam_auth_token(self.endpoint, self.port, self.user, self.region)\n",
-    "        return iam_auth_token\n",
+    "        query_params = {\"Action\": \"connect\", \"User\": self.user}\n",
+    "        url = urlunparse(\n",
+    "            ParseResult(\n",
+    "                scheme=\"https\",\n",
+    "                netloc=self.cluster_name,\n",
+    "                path=\"/\",\n",
+    "                query=urlencode(query_params),\n",
+    "                params=\"\",\n",
+    "                fragment=\"\",\n",
+    "            )\n",
+    "        )\n",
+    "        signed_url = self.request_signer.generate_presigned_url(\n",
+    "            {\"method\": \"GET\", \"url\": url, \"body\": {}, \"headers\": {}, \"context\": {}},\n",
+    "            operation_name=\"connect\",\n",
+    "            expires_in=900,\n",
+    "            region_name=self.region,\n",
+    "        )\n",
+    "        # RequestSigner only seems to work if the URL has a protocol, but\n",
+    "        # Elasticache only accepts the URL without a protocol\n",
+    "        # So strip it off the signed URL before returning\n",
+    "        return (self.user, signed_url.removeprefix(\"https://\"))\n",
     "\n",
     "username = \"barshaul\"\n",
+    "cluster_name = \"test-001\"\n",
     "endpoint = \"test-001.use1.cache.amazonaws.com\"\n",
-    "creds_provider = ElastiCacheIAMProvider(user=username, endpoint=endpoint)\n",
+    "creds_provider = ElastiCacheIAMProvider(user=username, cluster_name=cluster_name)\n",
     "user_connection = redis.Redis(host=endpoint, port=6379, credential_provider=creds_provider)\n",
     "user_connection.ping()"
    ]

From ffb2b83468123c314d2742d1b1e68e6ce9eeb244 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 7 May 2023 20:17:23 +0300
Subject: [PATCH 0717/1164] pinning urllib3 to fix CI (#2748)

---
 dev_requirements.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev_requirements.txt b/dev_requirements.txt
index 8285b0456f..8ffb1e944f 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -15,4 +15,5 @@ pytest-cov>=4.0.0
 vulture>=2.3.0
 ujson>=4.2.0
 wheel>=0.30.0
+urllib3<2
 uvloop

From 3748a8b36d5c765f5d21c6d20b041fa1876021ae Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Sun, 7 May 2023 19:33:14 +0000
Subject: [PATCH 0718/1164] Add RedisCluster.remap_host_port, Update tests for
 CWE 404 (#2706)

* Use provided redis address. Bind to IPv4

* Add missing "await" and perform the correct test for pipe eimpty

* Wait for a send event, rather than rely on sleep time. Excpect cancel errors.

* set delay to 0 except for operation we want to cancel
This speeds up the unit tests considerably by eliminating unnecessary delay.

* Release resources in test

* Fix cluster test to use address_remap and multiple proxies.

* Use context manager to manage DelayProxy

* Mark failing pipeline tests

* lint

* Use a common "master_host" test fixture
---
 tests/conftest.py                          |   2 +-
 tests/test_asyncio/conftest.py             |   8 -
 tests/test_asyncio/test_cluster.py         |  20 +-
 tests/test_asyncio/test_connection_pool.py |  10 +-
 tests/test_asyncio/test_cwe_404.py         | 319 ++++++++++++++-------
 tests/test_asyncio/test_sentinel.py        |   2 +-
 tests/test_cluster.py                      |  21 +-
 7 files changed, 227 insertions(+), 155 deletions(-)

diff --git a/tests/conftest.py b/tests/conftest.py
index 27dcc741a7..4cd4c3c160 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -441,7 +441,7 @@ def mock_cluster_resp_slaves(request, **kwargs):
 def master_host(request):
     url = request.config.getoption("--redis-url")
     parts = urlparse(url)
-    yield parts.hostname, parts.port
+    return parts.hostname, (parts.port or 6379)
 
 
 @pytest.fixture()
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index 6982cc840a..121a13b41b 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -1,7 +1,6 @@
 import random
 from contextlib import asynccontextmanager as _asynccontextmanager
 from typing import Union
-from urllib.parse import urlparse
 
 import pytest
 import pytest_asyncio
@@ -209,13 +208,6 @@ async def mock_cluster_resp_slaves(create_redis, **kwargs):
     return _gen_cluster_mock_resp(r, response)
 
 
-@pytest_asyncio.fixture(scope="session")
-def master_host(request):
-    url = request.config.getoption("--redis-url")
-    parts = urlparse(url)
-    return parts.hostname
-
-
 async def wait_for_command(
     client: redis.Redis, monitor: Monitor, command: str, key: Union[str, None] = None
 ):
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 6d0aba73fb..2d6099f6a9 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -102,18 +102,6 @@ async def pipe(
             await writer.drain()
 
 
-@pytest.fixture
-def redis_addr(request):
-    redis_url = request.config.getoption("--redis-url")
-    scheme, netloc = urlparse(redis_url)[:2]
-    assert scheme == "redis"
-    if ":" in netloc:
-        host, port = netloc.split(":")
-        return host, int(port)
-    else:
-        return netloc, 6379
-
-
 @pytest_asyncio.fixture()
 async def slowlog(r: RedisCluster) -> None:
     """
@@ -874,7 +862,7 @@ async def test_default_node_is_replaced_after_exception(self, r):
         # Rollback to the old default node
         r.replace_default_node(curr_default_node)
 
-    async def test_address_remap(self, create_redis, redis_addr):
+    async def test_address_remap(self, create_redis, master_host):
         """Test that we can create a rediscluster object with
         a host-port remapper and map connections through proxy objects
         """
@@ -882,7 +870,8 @@ async def test_address_remap(self, create_redis, redis_addr):
         # we remap the first n nodes
         offset = 1000
         n = 6
-        ports = [redis_addr[1] + i for i in range(n)]
+        hostname, master_port = master_host
+        ports = [master_port + i for i in range(n)]
 
         def address_remap(address):
             # remap first three nodes to our local proxy
@@ -895,8 +884,7 @@ def address_remap(address):
 
         # create the proxies
         proxies = [
-            NodeProxy(("127.0.0.1", port + offset), (redis_addr[0], port))
-            for port in ports
+            NodeProxy(("127.0.0.1", port + offset), (hostname, port)) for port in ports
         ]
         await asyncio.gather(*[p.start() for p in proxies])
         try:
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
index d1e52bd2a3..92499e2c4a 100644
--- a/tests/test_asyncio/test_connection_pool.py
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -136,14 +136,14 @@ async def test_connection_creation(self):
             assert connection.kwargs == connection_kwargs
 
     async def test_multiple_connections(self, master_host):
-        connection_kwargs = {"host": master_host}
+        connection_kwargs = {"host": master_host[0]}
         async with self.get_pool(connection_kwargs=connection_kwargs) as pool:
             c1 = await pool.get_connection("_")
             c2 = await pool.get_connection("_")
             assert c1 != c2
 
     async def test_max_connections(self, master_host):
-        connection_kwargs = {"host": master_host}
+        connection_kwargs = {"host": master_host[0]}
         async with self.get_pool(
             max_connections=2, connection_kwargs=connection_kwargs
         ) as pool:
@@ -153,7 +153,7 @@ async def test_max_connections(self, master_host):
                 await pool.get_connection("_")
 
     async def test_reuse_previously_released_connection(self, master_host):
-        connection_kwargs = {"host": master_host}
+        connection_kwargs = {"host": master_host[0]}
         async with self.get_pool(connection_kwargs=connection_kwargs) as pool:
             c1 = await pool.get_connection("_")
             await pool.release(c1)
@@ -237,7 +237,7 @@ async def test_multiple_connections(self, master_host):
 
     async def test_connection_pool_blocks_until_timeout(self, master_host):
         """When out of connections, block for timeout seconds, then raise"""
-        connection_kwargs = {"host": master_host}
+        connection_kwargs = {"host": master_host[0]}
         async with self.get_pool(
             max_connections=1, timeout=0.1, connection_kwargs=connection_kwargs
         ) as pool:
@@ -270,7 +270,7 @@ async def target():
             assert asyncio.get_running_loop().time() - start >= 0.1
 
     async def test_reuse_previously_released_connection(self, master_host):
-        connection_kwargs = {"host": master_host}
+        connection_kwargs = {"host": master_host[0]}
         async with self.get_pool(connection_kwargs=connection_kwargs) as pool:
             c1 = await pool.get_connection("_")
             await pool.release(c1)
diff --git a/tests/test_asyncio/test_cwe_404.py b/tests/test_asyncio/test_cwe_404.py
index dc62df65f4..d3a0666262 100644
--- a/tests/test_asyncio/test_cwe_404.py
+++ b/tests/test_asyncio/test_cwe_404.py
@@ -1,147 +1,252 @@
 import asyncio
-import sys
+import contextlib
 
 import pytest
 
 from redis.asyncio import Redis
 from redis.asyncio.cluster import RedisCluster
-
-
-async def pipe(
-    reader: asyncio.StreamReader, writer: asyncio.StreamWriter, delay: float, name=""
-):
-    while True:
-        data = await reader.read(1000)
-        if not data:
-            break
-        await asyncio.sleep(delay)
-        writer.write(data)
-        await writer.drain()
+from redis.asyncio.connection import async_timeout
 
 
 class DelayProxy:
-    def __init__(self, addr, redis_addr, delay: float):
+    def __init__(self, addr, redis_addr, delay: float = 0.0):
         self.addr = addr
         self.redis_addr = redis_addr
         self.delay = delay
+        self.send_event = asyncio.Event()
+        self.server = None
+        self.task = None
+
+    async def __aenter__(self):
+        await self.start()
+        return self
+
+    async def __aexit__(self, *args):
+        await self.stop()
 
     async def start(self):
-        self.server = await asyncio.start_server(self.handle, *self.addr)
-        self.ROUTINE = asyncio.create_task(self.server.serve_forever())
+        # test that we can connect to redis
+        async with async_timeout(2):
+            _, redis_writer = await asyncio.open_connection(*self.redis_addr)
+        redis_writer.close()
+        self.server = await asyncio.start_server(
+            self.handle, *self.addr, reuse_address=True
+        )
+        self.task = asyncio.create_task(self.server.serve_forever())
+
+    @contextlib.contextmanager
+    def set_delay(self, delay: float = 0.0):
+        """
+        Allow to override the delay for parts of tests which aren't time dependent,
+        to speed up execution.
+        """
+        old_delay = self.delay
+        self.delay = delay
+        try:
+            yield
+        finally:
+            self.delay = old_delay
 
     async def handle(self, reader, writer):
         # establish connection to redis
         redis_reader, redis_writer = await asyncio.open_connection(*self.redis_addr)
-        pipe1 = asyncio.create_task(pipe(reader, redis_writer, self.delay, "to redis:"))
-        pipe2 = asyncio.create_task(
-            pipe(redis_reader, writer, self.delay, "from redis:")
-        )
-        await asyncio.gather(pipe1, pipe2)
+        try:
+            pipe1 = asyncio.create_task(
+                self.pipe(reader, redis_writer, "to redis:", self.send_event)
+            )
+            pipe2 = asyncio.create_task(self.pipe(redis_reader, writer, "from redis:"))
+            await asyncio.gather(pipe1, pipe2)
+        finally:
+            redis_writer.close()
 
     async def stop(self):
         # clean up enough so that we can reuse the looper
-        self.ROUTINE.cancel()
+        self.task.cancel()
+        try:
+            await self.task
+        except asyncio.CancelledError:
+            pass
         loop = self.server.get_loop()
         await loop.shutdown_asyncgens()
 
+    async def pipe(
+        self,
+        reader: asyncio.StreamReader,
+        writer: asyncio.StreamWriter,
+        name="",
+        event: asyncio.Event = None,
+    ):
+        while True:
+            data = await reader.read(1000)
+            if not data:
+                break
+            # print(f"{name} read {len(data)} delay {self.delay}")
+            if event:
+                event.set()
+            await asyncio.sleep(self.delay)
+            writer.write(data)
+            await writer.drain()
+
 
 @pytest.mark.onlynoncluster
 @pytest.mark.parametrize("delay", argvalues=[0.05, 0.5, 1, 2])
-async def test_standalone(delay):
+async def test_standalone(delay, master_host):
 
     # create a tcp socket proxy that relays data to Redis and back,
     # inserting 0.1 seconds of delay
-    dp = DelayProxy(
-        addr=("localhost", 5380), redis_addr=("localhost", 6379), delay=delay * 2
-    )
-    await dp.start()
-
-    for b in [True, False]:
-        # note that we connect to proxy, rather than to Redis directly
-        async with Redis(host="localhost", port=5380, single_connection_client=b) as r:
-
-            await r.set("foo", "foo")
-            await r.set("bar", "bar")
-
-            t = asyncio.create_task(r.get("foo"))
-            await asyncio.sleep(delay)
-            t.cancel()
-            try:
-                await t
-                sys.stderr.write("try again, we did not cancel the task in time\n")
-            except asyncio.CancelledError:
-                sys.stderr.write(
-                    "canceled task, connection is left open with unread response\n"
-                )
-
-            assert await r.get("bar") == b"bar"
-            assert await r.ping()
-            assert await r.get("foo") == b"foo"
-
-    await dp.stop()
-
-
+    async with DelayProxy(addr=("127.0.0.1", 5380), redis_addr=master_host) as dp:
+
+        for b in [True, False]:
+            # note that we connect to proxy, rather than to Redis directly
+            async with Redis(
+                host="127.0.0.1", port=5380, single_connection_client=b
+            ) as r:
+
+                await r.set("foo", "foo")
+                await r.set("bar", "bar")
+
+                async def op(r):
+                    with dp.set_delay(delay * 2):
+                        return await r.get(
+                            "foo"
+                        )  # <-- this is the operation we want to cancel
+
+                dp.send_event.clear()
+                t = asyncio.create_task(op(r))
+                # Wait until the task has sent, and then some, to make sure it has
+                # settled on the read.
+                await dp.send_event.wait()
+                await asyncio.sleep(0.01)  # a little extra time for prudence
+                t.cancel()
+                with pytest.raises(asyncio.CancelledError):
+                    await t
+
+                # make sure that our previous request, cancelled while waiting for
+                # a repsponse, didn't leave the connection open andin a bad state
+                assert await r.get("bar") == b"bar"
+                assert await r.ping()
+                assert await r.get("foo") == b"foo"
+
+
+@pytest.mark.xfail(reason="cancel does not cause disconnect")
 @pytest.mark.onlynoncluster
 @pytest.mark.parametrize("delay", argvalues=[0.05, 0.5, 1, 2])
-async def test_standalone_pipeline(delay):
-    dp = DelayProxy(
-        addr=("localhost", 5380), redis_addr=("localhost", 6379), delay=delay * 2
-    )
-    await dp.start()
-    for b in [True, False]:
-        async with Redis(host="localhost", port=5380, single_connection_client=b) as r:
-            await r.set("foo", "foo")
-            await r.set("bar", "bar")
-
-            pipe = r.pipeline()
-
-            pipe2 = r.pipeline()
-            pipe2.get("bar")
-            pipe2.ping()
-            pipe2.get("foo")
-
-            t = asyncio.create_task(pipe.get("foo").execute())
-            await asyncio.sleep(delay)
-            t.cancel()
-
-            pipe.get("bar")
-            pipe.ping()
-            pipe.get("foo")
-            pipe.reset()
-
-            assert await pipe.execute() is None
-
-            # validating that the pipeline can be used as it could previously
-            pipe.get("bar")
-            pipe.ping()
-            pipe.get("foo")
-            assert await pipe.execute() == [b"bar", True, b"foo"]
-            assert await pipe2.execute() == [b"bar", True, b"foo"]
-
-    await dp.stop()
+async def test_standalone_pipeline(delay, master_host):
+    async with DelayProxy(addr=("127.0.0.1", 5380), redis_addr=master_host) as dp:
+        for b in [True, False]:
+            async with Redis(
+                host="127.0.0.1", port=5380, single_connection_client=b
+            ) as r:
+                await r.set("foo", "foo")
+                await r.set("bar", "bar")
+
+                pipe = r.pipeline()
+
+                pipe2 = r.pipeline()
+                pipe2.get("bar")
+                pipe2.ping()
+                pipe2.get("foo")
+
+                async def op(pipe):
+                    with dp.set_delay(delay * 2):
+                        return await pipe.get(
+                            "foo"
+                        ).execute()  # <-- this is the operation we want to cancel
+
+                dp.send_event.clear()
+                t = asyncio.create_task(op(pipe))
+                # wait until task has settled on the read
+                await dp.send_event.wait()
+                await asyncio.sleep(0.01)
+                t.cancel()
+                with pytest.raises(asyncio.CancelledError):
+                    await t
+
+                # we have now cancelled the pieline in the middle of a request,
+                # make sure that the connection is still usable
+                pipe.get("bar")
+                pipe.ping()
+                pipe.get("foo")
+                await pipe.reset()
+
+                # check that the pipeline is empty after reset
+                assert await pipe.execute() == []
+
+                # validating that the pipeline can be used as it could previously
+                pipe.get("bar")
+                pipe.ping()
+                pipe.get("foo")
+                assert await pipe.execute() == [b"bar", True, b"foo"]
+                assert await pipe2.execute() == [b"bar", True, b"foo"]
 
 
 @pytest.mark.onlycluster
-async def test_cluster(request):
+async def test_cluster(master_host):
+
+    delay = 0.1
+    cluster_port = 6372
+    remap_base = 7372
+    n_nodes = 6
+    hostname, _ = master_host
+
+    def remap(address):
+        host, port = address
+        return host, remap_base + port - cluster_port
+
+    proxies = []
+    for i in range(n_nodes):
+        port = cluster_port + i
+        remapped = remap_base + i
+        forward_addr = hostname, port
+        proxy = DelayProxy(addr=("127.0.0.1", remapped), redis_addr=forward_addr)
+        proxies.append(proxy)
+
+    def all_clear():
+        for p in proxies:
+            p.send_event.clear()
+
+    async def wait_for_send():
+        asyncio.wait(
+            [p.send_event.wait() for p in proxies], return_when=asyncio.FIRST_COMPLETED
+        )
 
-    dp = DelayProxy(addr=("localhost", 5381), redis_addr=("localhost", 6372), delay=0.1)
-    await dp.start()
+    @contextlib.contextmanager
+    def set_delay(delay: float):
+        with contextlib.ExitStack() as stack:
+            for p in proxies:
+                stack.enter_context(p.set_delay(delay))
+            yield
+
+    async with contextlib.AsyncExitStack() as stack:
+        for p in proxies:
+            await stack.enter_async_context(p)
+
+        with contextlib.closing(
+            RedisCluster.from_url(
+                f"redis://127.0.0.1:{remap_base}", address_remap=remap
+            )
+        ) as r:
+            await r.initialize()
+            await r.set("foo", "foo")
+            await r.set("bar", "bar")
 
-    r = RedisCluster.from_url("redis://localhost:5381")
-    await r.initialize()
-    await r.set("foo", "foo")
-    await r.set("bar", "bar")
+            async def op(r):
+                with set_delay(delay):
+                    return await r.get("foo")
 
-    t = asyncio.create_task(r.get("foo"))
-    await asyncio.sleep(0.050)
-    t.cancel()
-    try:
-        await t
-    except asyncio.CancelledError:
-        pytest.fail("connection is left open with unread response")
+            all_clear()
+            t = asyncio.create_task(op(r))
+            # Wait for whichever DelayProxy gets the request first
+            await wait_for_send()
+            await asyncio.sleep(0.01)
+            t.cancel()
+            with pytest.raises(asyncio.CancelledError):
+                await t
 
-    assert await r.get("bar") == b"bar"
-    assert await r.ping()
-    assert await r.get("foo") == b"foo"
+            # try a number of requests to excercise all the connections
+            async def doit():
+                assert await r.get("bar") == b"bar"
+                assert await r.ping()
+                assert await r.get("foo") == b"foo"
 
-    await dp.stop()
+            await asyncio.gather(*[doit() for _ in range(10)])
diff --git a/tests/test_asyncio/test_sentinel.py b/tests/test_asyncio/test_sentinel.py
index 5a0533ba05..7866056374 100644
--- a/tests/test_asyncio/test_sentinel.py
+++ b/tests/test_asyncio/test_sentinel.py
@@ -15,7 +15,7 @@
 
 @pytest_asyncio.fixture(scope="module")
 def master_ip(master_host):
-    yield socket.gethostbyname(master_host)
+    yield socket.gethostbyname(master_host[0])
 
 
 class SentinelTestClient:
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 1f037c9edf..8371cc577f 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -8,7 +8,6 @@
 from queue import LifoQueue, Queue
 from time import sleep
 from unittest.mock import DEFAULT, Mock, call, patch
-from urllib.parse import urlparse
 
 import pytest
 
@@ -125,18 +124,6 @@ def close(self):
         self.server.shutdown()
 
 
-@pytest.fixture
-def redis_addr(request):
-    redis_url = request.config.getoption("--redis-url")
-    scheme, netloc = urlparse(redis_url)[:2]
-    assert scheme == "redis"
-    if ":" in netloc:
-        host, port = netloc.split(":")
-        return host, int(port)
-    else:
-        return netloc, 6379
-
-
 @pytest.fixture()
 def slowlog(request, r):
     """
@@ -907,7 +894,7 @@ def raise_connection_error():
         assert "myself" not in nodes.get(curr_default_node.name).get("flags")
         assert r.get_default_node() != curr_default_node
 
-    def test_address_remap(self, request, redis_addr):
+    def test_address_remap(self, request, master_host):
         """Test that we can create a rediscluster object with
         a host-port remapper and map connections through proxy objects
         """
@@ -915,7 +902,8 @@ def test_address_remap(self, request, redis_addr):
         # we remap the first n nodes
         offset = 1000
         n = 6
-        ports = [redis_addr[1] + i for i in range(n)]
+        hostname, master_port = master_host
+        ports = [master_port + i for i in range(n)]
 
         def address_remap(address):
             # remap first three nodes to our local proxy
@@ -928,8 +916,7 @@ def address_remap(address):
 
         # create the proxies
         proxies = [
-            NodeProxy(("127.0.0.1", port + offset), (redis_addr[0], port))
-            for port in ports
+            NodeProxy(("127.0.0.1", port + offset), (hostname, port)) for port in ports
         ]
         for p in proxies:
             p.start()

From 906e41349d8751f721c452494cdcdb5455258719 Mon Sep 17 00:00:00 2001
From: Cristian Matache <cristianmatache@hotmail.com>
Date: Mon, 8 May 2023 08:04:18 +0100
Subject: [PATCH 0719/1164] Update redismodules.rst (#2747)

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 docs/redismodules.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/redismodules.rst b/docs/redismodules.rst
index 2ac46510be..27757cb692 100644
--- a/docs/redismodules.rst
+++ b/docs/redismodules.rst
@@ -144,7 +144,7 @@ These are the commands for interacting with the `RedisTimeSeries module <https:/
 
     import redis
     r = redis.Redis()
-    r.ts().create(2, retension_msecs=5000)
+    r.ts().create(2, retention_msecs=5000)
 
 .. automodule:: redis.commands.timeseries.commands
     :members: TimeSeriesCommands

From cfdcfd87acdc10bedba6230b0cbe7dcf44b4652a Mon Sep 17 00:00:00 2001
From: Anurag Bandyopadhyay <angbpy@gmail.com>
Date: Mon, 8 May 2023 13:31:57 +0530
Subject: [PATCH 0720/1164] Add support for cluster myshardid (#2704)

* feat: adding support for cluster myshardid

* lint fix

* fix: comment fix and async test

* fix: adding version check

* fix lint:

* linters

---------

Co-authored-by: Anuragkillswitch <70265851+Anuragkillswitch@users.noreply.github.com>
Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
Co-authored-by: dvora-h <dvora.heller@redis.com>
---
 redis/cluster.py                   | 8 ++++++++
 redis/commands/cluster.py          | 9 ++++++++-
 tests/test_asyncio/test_cluster.py | 7 +++++++
 tests/test_cluster.py              | 7 +++++++
 4 files changed, 30 insertions(+), 1 deletion(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index 3ecc2dab56..2ab173ded9 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -113,6 +113,13 @@ def parse_cluster_shards(resp, **options):
     return shards
 
 
+def parse_cluster_myshardid(resp, **options):
+    """
+    Parse CLUSTER MYSHARDID response.
+    """
+    return resp.decode("utf-8")
+
+
 PRIMARY = "primary"
 REPLICA = "replica"
 SLOT_ID = "slot-id"
@@ -341,6 +348,7 @@ class AbstractRedisCluster:
     CLUSTER_COMMANDS_RESPONSE_CALLBACKS = {
         "CLUSTER SLOTS": parse_cluster_slots,
         "CLUSTER SHARDS": parse_cluster_shards,
+        "CLUSTER MYSHARDID": parse_cluster_myshardid,
     }
 
     RESULT_CALLBACKS = dict_merge(
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index a23a94a3d3..cd93a85aba 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -45,7 +45,6 @@
 if TYPE_CHECKING:
     from redis.asyncio.cluster import TargetNodesT
 
-
 # Not complete, but covers the major ones
 # https://redis.io/commands
 READ_COMMANDS = frozenset(
@@ -634,6 +633,14 @@ def cluster_shards(self, target_nodes=None):
         """
         return self.execute_command("CLUSTER SHARDS", target_nodes=target_nodes)
 
+    def cluster_myshardid(self, target_nodes=None):
+        """
+        Returns the shard ID of the node.
+
+        For more information see https://redis.io/commands/cluster-myshardid/
+        """
+        return self.execute_command("CLUSTER MYSHARDID", target_nodes=target_nodes)
+
     def cluster_links(self, target_node: "TargetNodesT") -> ResponseT:
         """
         Each node in a Redis Cluster maintains a pair of long-lived TCP link with each
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 2d6099f6a9..17aa879b0f 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -1006,6 +1006,13 @@ async def test_cluster_myid(self, r: RedisCluster) -> None:
         myid = await r.cluster_myid(node)
         assert len(myid) == 40
 
+    @skip_if_server_version_lt("7.2.0")
+    @skip_if_redis_enterprise()
+    async def test_cluster_myshardid(self, r: RedisCluster) -> None:
+        node = r.get_random_node()
+        myshardid = await r.cluster_myshardid(node)
+        assert len(myshardid) == 40
+
     @skip_if_redis_enterprise()
     async def test_cluster_slots(self, r: RedisCluster) -> None:
         mock_all_nodes_resp(r, default_cluster_slots)
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 8371cc577f..705e753bd6 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -1162,6 +1162,13 @@ def test_cluster_shards(self, r):
                 for attribute in node.keys():
                     assert attribute in attributes
 
+    @skip_if_server_version_lt("7.2.0")
+    @skip_if_redis_enterprise()
+    def test_cluster_myshardid(self, r):
+        myshardid = r.cluster_myshardid()
+        assert isinstance(myshardid, str)
+        assert len(myshardid) > 0
+
     @skip_if_redis_enterprise()
     def test_cluster_addslots(self, r):
         node = r.get_random_node()

From 9370711ba3ad341193089f04fdf325fd37956edf Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 8 May 2023 13:09:17 +0300
Subject: [PATCH 0721/1164] clean warnings (#2731)

---
 redis/asyncio/client.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 3e6626aedf..5fb94b3353 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -455,7 +455,7 @@ async def __aexit__(self, exc_type, exc_value, traceback):
     _DEL_MESSAGE = "Unclosed Redis client"
 
     def __del__(self, _warnings: Any = warnings) -> None:
-        if self.connection is not None:
+        if hasattr(self, "connection") and (self.connection is not None):
             _warnings.warn(
                 f"Unclosed client session {self!r}", ResourceWarning, source=self
             )

From 093232d8b4cecaac5d8b15c908bd0f8f73927238 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 8 May 2023 13:09:28 +0300
Subject: [PATCH 0722/1164] fix parse_slowlog_get (#2732)

---
 redis/client.py        | 4 ++++
 tests/test_commands.py | 2 ++
 2 files changed, 6 insertions(+)

diff --git a/redis/client.py b/redis/client.py
index 79a7bff2a2..c43a388358 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -420,9 +420,13 @@ def parse_item(item):
         # an O(N) complexity) instead of the command.
         if isinstance(item[3], list):
             result["command"] = space.join(item[3])
+            result["client_address"] = item[4]
+            result["client_name"] = item[5]
         else:
             result["complexity"] = item[3]
             result["command"] = space.join(item[4])
+            result["client_address"] = item[5]
+            result["client_name"] = item[6]
         return result
 
     return [parse_item(item) for item in response]
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 2b769be34d..4020f5e8a8 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -861,6 +861,8 @@ def test_slowlog_get(self, r, slowlog):
         # make sure other attributes are typed correctly
         assert isinstance(slowlog[0]["start_time"], int)
         assert isinstance(slowlog[0]["duration"], int)
+        assert isinstance(slowlog[0]["client_address"], bytes)
+        assert isinstance(slowlog[0]["client_name"], bytes)
 
         # Mock result if we didn't get slowlog complexity info.
         if "complexity" not in slowlog[0]:

From c0833f60a1d9ec85c589004aba6b6739e6298248 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Mon, 8 May 2023 10:11:43 +0000
Subject: [PATCH 0723/1164] Optionally disable disconnects in read_response
 (#2695)

* Add regression tests and fixes for issue #1128

* Fix tests for resumable read_response to use "disconnect_on_error"

* undo prevision fix attempts in async client and cluster

* re-enable cluster test

* Suggestions from code review

* Add CHANGES
---
 CHANGES                               |  1 +
 redis/asyncio/client.py               | 93 ++++++++-------------------
 redis/asyncio/cluster.py              | 33 +++-------
 redis/asyncio/connection.py           | 28 +++++---
 redis/client.py                       |  2 +-
 redis/connection.py                   | 24 +++++--
 tests/test_asyncio/test_commands.py   | 38 +++++++++++
 tests/test_asyncio/test_connection.py |  2 +-
 tests/test_asyncio/test_cwe_404.py    |  1 -
 tests/test_commands.py                | 35 ++++++++++
 tests/test_connection.py              |  2 +-
 11 files changed, 149 insertions(+), 110 deletions(-)

diff --git a/CHANGES b/CHANGES
index 3865ed1067..ea171f6bb5 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Revert #2104, #2673, add `disconnect_on_error` option to `read_response()` (issues #2506, #2624)
     * Add `address_remap` parameter to `RedisCluster`
     * Fix incorrect usage of once flag in async Sentinel
     * asyncio: Fix memory leak caused by hiredis (#2693)
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 5fb94b3353..a7b888eee4 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -500,23 +500,6 @@ async def _disconnect_raise(self, conn: Connection, error: Exception):
         ):
             raise error
 
-    async def _try_send_command_parse_response(self, conn, *args, **options):
-        try:
-            return await conn.retry.call_with_retry(
-                lambda: self._send_command_parse_response(
-                    conn, args[0], *args, **options
-                ),
-                lambda error: self._disconnect_raise(conn, error),
-            )
-        except asyncio.CancelledError:
-            await conn.disconnect(nowait=True)
-            raise
-        finally:
-            if self.single_connection_client:
-                self._single_conn_lock.release()
-            if not self.connection:
-                await self.connection_pool.release(conn)
-
     # COMMAND EXECUTION AND PROTOCOL PARSING
     async def execute_command(self, *args, **options):
         """Execute a command and return a parsed response"""
@@ -527,10 +510,18 @@ async def execute_command(self, *args, **options):
 
         if self.single_connection_client:
             await self._single_conn_lock.acquire()
-
-        return await asyncio.shield(
-            self._try_send_command_parse_response(conn, *args, **options)
-        )
+        try:
+            return await conn.retry.call_with_retry(
+                lambda: self._send_command_parse_response(
+                    conn, command_name, *args, **options
+                ),
+                lambda error: self._disconnect_raise(conn, error),
+            )
+        finally:
+            if self.single_connection_client:
+                self._single_conn_lock.release()
+            if not self.connection:
+                await pool.release(conn)
 
     async def parse_response(
         self, connection: Connection, command_name: Union[str, bytes], **options
@@ -774,18 +765,10 @@ async def _disconnect_raise_connect(self, conn, error):
         is not a TimeoutError. Otherwise, try to reconnect
         """
         await conn.disconnect()
-
         if not (conn.retry_on_timeout and isinstance(error, TimeoutError)):
             raise error
         await conn.connect()
 
-    async def _try_execute(self, conn, command, *arg, **kwargs):
-        try:
-            return await command(*arg, **kwargs)
-        except asyncio.CancelledError:
-            await conn.disconnect()
-            raise
-
     async def _execute(self, conn, command, *args, **kwargs):
         """
         Connect manually upon disconnection. If the Redis server is down,
@@ -794,11 +777,9 @@ async def _execute(self, conn, command, *args, **kwargs):
         called by the # connection to resubscribe us to any channels and
         patterns we were previously listening to
         """
-        return await asyncio.shield(
-            conn.retry.call_with_retry(
-                lambda: self._try_execute(conn, command, *args, **kwargs),
-                lambda error: self._disconnect_raise_connect(conn, error),
-            )
+        return await conn.retry.call_with_retry(
+            lambda: command(*args, **kwargs),
+            lambda error: self._disconnect_raise_connect(conn, error),
         )
 
     async def parse_response(self, block: bool = True, timeout: float = 0):
@@ -816,7 +797,9 @@ async def parse_response(self, block: bool = True, timeout: float = 0):
             await conn.connect()
 
         read_timeout = None if block else timeout
-        response = await self._execute(conn, conn.read_response, timeout=read_timeout)
+        response = await self._execute(
+            conn, conn.read_response, timeout=read_timeout, disconnect_on_error=False
+        )
 
         if conn.health_check_interval and response == self.health_check_response:
             # ignore the health check message as user might not expect it
@@ -1200,18 +1183,6 @@ async def _disconnect_reset_raise(self, conn, error):
             await self.reset()
             raise
 
-    async def _try_send_command_parse_response(self, conn, *args, **options):
-        try:
-            return await conn.retry.call_with_retry(
-                lambda: self._send_command_parse_response(
-                    conn, args[0], *args, **options
-                ),
-                lambda error: self._disconnect_reset_raise(conn, error),
-            )
-        except asyncio.CancelledError:
-            await conn.disconnect()
-            raise
-
     async def immediate_execute_command(self, *args, **options):
         """
         Execute a command immediately, but don't auto-retry on a
@@ -1227,8 +1198,12 @@ async def immediate_execute_command(self, *args, **options):
                 command_name, self.shard_hint
             )
             self.connection = conn
-        return await asyncio.shield(
-            self._try_send_command_parse_response(conn, *args, **options)
+
+        return await conn.retry.call_with_retry(
+            lambda: self._send_command_parse_response(
+                conn, command_name, *args, **options
+            ),
+            lambda error: self._disconnect_reset_raise(conn, error),
         )
 
     def pipeline_execute_command(self, *args, **options):
@@ -1396,19 +1371,6 @@ async def _disconnect_raise_reset(self, conn: Connection, error: Exception):
             await self.reset()
             raise
 
-    async def _try_execute(self, conn, execute, stack, raise_on_error):
-        try:
-            return await conn.retry.call_with_retry(
-                lambda: execute(conn, stack, raise_on_error),
-                lambda error: self._disconnect_raise_reset(conn, error),
-            )
-        except asyncio.CancelledError:
-            # not supposed to be possible, yet here we are
-            await conn.disconnect(nowait=True)
-            raise
-        finally:
-            await self.reset()
-
     async def execute(self, raise_on_error: bool = True):
         """Execute all the commands in the current pipeline"""
         stack = self.command_stack
@@ -1430,11 +1392,10 @@ async def execute(self, raise_on_error: bool = True):
         conn = cast(Connection, conn)
 
         try:
-            return await asyncio.shield(
-                self._try_execute(conn, execute, stack, raise_on_error)
+            return await conn.retry.call_with_retry(
+                lambda: execute(conn, stack, raise_on_error),
+                lambda error: self._disconnect_raise_reset(conn, error),
             )
-        except RuntimeError:
-            await self.reset()
         finally:
             await self.reset()
 
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index eb5f4db061..929d3e47c7 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -1016,33 +1016,12 @@ async def execute_command(self, *args: Any, **kwargs: Any) -> Any:
         await connection.send_packed_command(connection.pack_command(*args), False)
 
         # Read response
-        return await asyncio.shield(
-            self._parse_and_release(connection, args[0], **kwargs)
-        )
-
-    async def _parse_and_release(self, connection, *args, **kwargs):
         try:
-            return await self.parse_response(connection, *args, **kwargs)
-        except asyncio.CancelledError:
-            # should not be possible
-            await connection.disconnect(nowait=True)
-            raise
+            return await self.parse_response(connection, args[0], **kwargs)
         finally:
+            # Release connection
             self._free.append(connection)
 
-    async def _try_parse_response(self, cmd, connection, ret):
-        try:
-            cmd.result = await asyncio.shield(
-                self.parse_response(connection, cmd.args[0], **cmd.kwargs)
-            )
-        except asyncio.CancelledError:
-            await connection.disconnect(nowait=True)
-            raise
-        except Exception as e:
-            cmd.result = e
-            ret = True
-        return ret
-
     async def execute_pipeline(self, commands: List["PipelineCommand"]) -> bool:
         # Acquire connection
         connection = self.acquire_connection()
@@ -1055,7 +1034,13 @@ async def execute_pipeline(self, commands: List["PipelineCommand"]) -> bool:
         # Read responses
         ret = False
         for cmd in commands:
-            ret = await asyncio.shield(self._try_parse_response(cmd, connection, ret))
+            try:
+                cmd.result = await self.parse_response(
+                    connection, cmd.args[0], **cmd.kwargs
+                )
+            except Exception as e:
+                cmd.result = e
+                ret = True
 
         # Release connection
         self._free.append(connection)
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 59f75aa229..462673f2ed 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -804,7 +804,11 @@ async def send_packed_command(
             raise ConnectionError(
                 f"Error {err_no} while writing to socket. {errmsg}."
             ) from e
-        except Exception:
+        except BaseException:
+            # BaseExceptions can be raised when a socket send operation is not
+            # finished, e.g. due to a timeout.  Ideally, a caller could then re-try
+            # to send un-sent data. However, the send_packed_command() API
+            # does not support it so there is no point in keeping the connection open.
             await self.disconnect(nowait=True)
             raise
 
@@ -828,6 +832,8 @@ async def read_response(
         self,
         disable_decoding: bool = False,
         timeout: Optional[float] = None,
+        *,
+        disconnect_on_error: bool = True,
     ):
         """Read the response from a previously sent command"""
         read_timeout = timeout if timeout is not None else self.socket_timeout
@@ -843,22 +849,24 @@ async def read_response(
                 )
         except asyncio.TimeoutError:
             if timeout is not None:
-                # user requested timeout, return None
+                # user requested timeout, return None. Operation can be retried
                 return None
             # it was a self.socket_timeout error.
-            await self.disconnect(nowait=True)
+            if disconnect_on_error:
+                await self.disconnect(nowait=True)
             raise TimeoutError(f"Timeout reading from {self.host}:{self.port}")
         except OSError as e:
-            await self.disconnect(nowait=True)
+            if disconnect_on_error:
+                await self.disconnect(nowait=True)
             raise ConnectionError(
                 f"Error while reading from {self.host}:{self.port} : {e.args}"
             )
-        except asyncio.CancelledError:
-            # need this check for 3.7, where CancelledError
-            # is subclass of Exception, not BaseException
-            raise
-        except Exception:
-            await self.disconnect(nowait=True)
+        except BaseException:
+            # Also by default close in case of BaseException.  A lot of code
+            # relies on this behaviour when doing Command/Response pairs.
+            # See #1128.
+            if disconnect_on_error:
+                await self.disconnect(nowait=True)
             raise
 
         if self.health_check_interval:
diff --git a/redis/client.py b/redis/client.py
index c43a388358..65d0cec9a9 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1533,7 +1533,7 @@ def try_read():
                     return None
             else:
                 conn.connect()
-            return conn.read_response()
+            return conn.read_response(disconnect_on_error=False)
 
         response = self._execute(conn, try_read)
 
diff --git a/redis/connection.py b/redis/connection.py
index 8b2389c6db..5af8928a5d 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -834,7 +834,11 @@ def send_packed_command(self, command, check_health=True):
                 errno = e.args[0]
                 errmsg = e.args[1]
             raise ConnectionError(f"Error {errno} while writing to socket. {errmsg}.")
-        except Exception:
+        except BaseException:
+            # BaseExceptions can be raised when a socket send operation is not
+            # finished, e.g. due to a timeout.  Ideally, a caller could then re-try
+            # to send un-sent data. However, the send_packed_command() API
+            # does not support it so there is no point in keeping the connection open.
             self.disconnect()
             raise
 
@@ -859,7 +863,9 @@ def can_read(self, timeout=0):
             self.disconnect()
             raise ConnectionError(f"Error while reading from {host_error}: {e.args}")
 
-    def read_response(self, disable_decoding=False):
+    def read_response(
+        self, disable_decoding=False, *, disconnect_on_error: bool = True
+    ):
         """Read the response from a previously sent command"""
 
         host_error = self._host_error()
@@ -867,15 +873,21 @@ def read_response(self, disable_decoding=False):
         try:
             response = self._parser.read_response(disable_decoding=disable_decoding)
         except socket.timeout:
-            self.disconnect()
+            if disconnect_on_error:
+                self.disconnect()
             raise TimeoutError(f"Timeout reading from {host_error}")
         except OSError as e:
-            self.disconnect()
+            if disconnect_on_error:
+                self.disconnect()
             raise ConnectionError(
                 f"Error while reading from {host_error}" f" : {e.args}"
             )
-        except Exception:
-            self.disconnect()
+        except BaseException:
+            # Also by default close in case of BaseException.  A lot of code
+            # relies on this behaviour when doing Command/Response pairs.
+            # See #1128.
+            if disconnect_on_error:
+                self.disconnect()
             raise
 
         if self.health_check_interval:
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 409934c9a3..ac3537db52 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -1,9 +1,11 @@
 """
 Tests async overrides of commands from their mixins
 """
+import asyncio
 import binascii
 import datetime
 import re
+import sys
 from string import ascii_letters
 
 import pytest
@@ -18,6 +20,11 @@
     skip_unless_arch_bits,
 )
 
+if sys.version_info >= (3, 11, 3):
+    from asyncio import timeout as async_timeout
+else:
+    from async_timeout import timeout as async_timeout
+
 REDIS_6_VERSION = "5.9.0"
 
 
@@ -3008,6 +3015,37 @@ async def test_module_list(self, r: redis.Redis):
         for x in await r.module_list():
             assert isinstance(x, dict)
 
+    @pytest.mark.onlynoncluster
+    async def test_interrupted_command(self, r: redis.Redis):
+        """
+        Regression test for issue #1128:  An Un-handled BaseException
+        will leave the socket with un-read response to a previous
+        command.
+        """
+        ready = asyncio.Event()
+
+        async def helper():
+            with pytest.raises(asyncio.CancelledError):
+                # blocking pop
+                ready.set()
+                await r.brpop(["nonexist"])
+            # If the following is not done, further Timout operations will fail,
+            # because the timeout won't catch its Cancelled Error if the task
+            # has a pending cancel.  Python documentation probably should reflect this.
+            if sys.version_info >= (3, 11):
+                asyncio.current_task().uncancel()
+            # if all is well, we can continue.  The following should not hang.
+            await r.set("status", "down")
+
+        task = asyncio.create_task(helper())
+        await ready.wait()
+        await asyncio.sleep(0.01)
+        # the task is now sleeping, lets send it an exception
+        task.cancel()
+        # If all is well, the task should finish right away, otherwise fail with Timeout
+        async with async_timeout(0.1):
+            await task
+
 
 @pytest.mark.onlynoncluster
 class TestBinarySave:
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index e2d77fc1c3..e49dd42204 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -184,7 +184,7 @@ async def test_connection_parse_response_resume(r: redis.Redis):
     conn._parser._stream = MockStream(message, interrupt_every=2)
     for i in range(100):
         try:
-            response = await conn.read_response()
+            response = await conn.read_response(disconnect_on_error=False)
             break
         except MockStream.TestError:
             pass
diff --git a/tests/test_asyncio/test_cwe_404.py b/tests/test_asyncio/test_cwe_404.py
index d3a0666262..21f2ddde2a 100644
--- a/tests/test_asyncio/test_cwe_404.py
+++ b/tests/test_asyncio/test_cwe_404.py
@@ -128,7 +128,6 @@ async def op(r):
                 assert await r.get("foo") == b"foo"
 
 
-@pytest.mark.xfail(reason="cancel does not cause disconnect")
 @pytest.mark.onlynoncluster
 @pytest.mark.parametrize("delay", argvalues=[0.05, 0.5, 1, 2])
 async def test_standalone_pipeline(delay, master_host):
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 4020f5e8a8..cb8966907f 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1,9 +1,12 @@
 import binascii
 import datetime
 import re
+import threading
 import time
+from asyncio import CancelledError
 from string import ascii_letters
 from unittest import mock
+from unittest.mock import patch
 
 import pytest
 
@@ -4743,6 +4746,38 @@ def test_psync(self, r):
         res = r2.psync(r2.client_id(), 1)
         assert b"FULLRESYNC" in res
 
+    @pytest.mark.onlynoncluster
+    def test_interrupted_command(self, r: redis.Redis):
+        """
+        Regression test for issue #1128:  An Un-handled BaseException
+        will leave the socket with un-read response to a previous
+        command.
+        """
+
+        ok = False
+
+        def helper():
+            with pytest.raises(CancelledError):
+                # blocking pop
+                with patch.object(
+                    r.connection._parser, "read_response", side_effect=CancelledError
+                ):
+                    r.brpop(["nonexist"])
+            # if all is well, we can continue.
+            r.set("status", "down")  # should not hang
+            nonlocal ok
+            ok = True
+
+        thread = threading.Thread(target=helper)
+        thread.start()
+        thread.join(0.1)
+        try:
+            assert not thread.is_alive()
+            assert ok
+        finally:
+            # disconnect here so that fixture cleanup can proceed
+            r.connection.disconnect()
+
 
 @pytest.mark.onlynoncluster
 class TestBinarySave:
diff --git a/tests/test_connection.py b/tests/test_connection.py
index 25b4118b2c..75ba738047 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -160,7 +160,7 @@ def test_connection_parse_response_resume(r: redis.Redis, parser_class):
         conn._parser._sock = mock_socket
     for i in range(100):
         try:
-            response = conn.read_response()
+            response = conn.read_response(disconnect_on_error=False)
             break
         except MockSocket.TestError:
             pass

From 8c06d67f574bef941f7e19b1b2b36e767ed42b6d Mon Sep 17 00:00:00 2001
From: Seongchuel Ahn <aciddust20@gmail.com>
Date: Mon, 8 May 2023 19:55:23 +0900
Subject: [PATCH 0724/1164] Add client no-touch (#2745)

* Add client no-touch

* Update redis/commands/core.py

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* Update test_commands.py

Improve test_client_no_touch

* Update test_commands.py

Add async version test case

* Chore remove whitespace

Oops

---------

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/commands/core.py              | 11 +++++++++++
 tests/test_asyncio/test_commands.py |  8 ++++++++
 tests/test_commands.py              |  8 ++++++++
 3 files changed, 27 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index d67291b314..1a4acb28e8 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -761,6 +761,17 @@ def client_no_evict(self, mode: str) -> Union[Awaitable[str], str]:
         """
         return self.execute_command("CLIENT NO-EVICT", mode)
 
+    def client_no_touch(self, mode: str) -> Union[Awaitable[str], str]:
+        """
+        # The command controls whether commands sent by the client will alter
+        # the LRU/LFU of the keys they access.
+        # When turned on, the current client will not change LFU/LRU stats,
+        # unless it sends the TOUCH command.
+
+        For more information see https://redis.io/commands/client-no-touch
+        """
+        return self.execute_command("CLIENT NO-TOUCH", mode)
+
     def command(self, **kwargs):
         """
         Returns dict reply of details about all Redis commands.
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index ac3537db52..955b9d42bc 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -453,6 +453,14 @@ async def test_client_pause(self, r: redis.Redis):
         with pytest.raises(exceptions.RedisError):
             await r.client_pause(timeout="not an integer")
 
+    @skip_if_server_version_lt("7.2.0")
+    @pytest.mark.onlynoncluster
+    async def test_client_no_touch(self, r: redis.Redis):
+        assert await r.client_no_touch("ON") == b"OK"
+        assert await r.client_no_touch("OFF") == b"OK"
+        with pytest.raises(TypeError):
+            await r.client_no_touch()
+
     async def test_config_get(self, r: redis.Redis):
         data = await r.config_get()
         assert "maxmemory" in data
diff --git a/tests/test_commands.py b/tests/test_commands.py
index cb8966907f..c71e347fab 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -696,6 +696,14 @@ def test_client_no_evict(self, r):
         with pytest.raises(TypeError):
             r.client_no_evict()
 
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("7.2.0")
+    def test_client_no_touch(self, r):
+        assert r.client_no_touch("ON") == b"OK"
+        assert r.client_no_touch("OFF") == b"OK"
+        with pytest.raises(TypeError):
+            r.client_no_touch()
+
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("3.2.0")
     def test_client_reply(self, r, r_timeout):

From 984b733d52b44ec75e2c9ff53689a7b6fa86d719 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 8 May 2023 14:15:39 +0300
Subject: [PATCH 0725/1164] fix create single_connection_client from url
 (#2752)

---
 redis/asyncio/client.py               | 6 +++++-
 redis/client.py                       | 6 +++++-
 tests/test_asyncio/test_connection.py | 6 ++++++
 tests/test_connection.py              | 8 ++++++++
 4 files changed, 24 insertions(+), 2 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index a7b888eee4..7479b742b6 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -139,8 +139,12 @@ class initializer. In the case of conflicting arguments, querystring
         arguments always win.
 
         """
+        single_connection_client = kwargs.pop("single_connection_client", False)
         connection_pool = ConnectionPool.from_url(url, **kwargs)
-        return cls(connection_pool=connection_pool)
+        return cls(
+            connection_pool=connection_pool,
+            single_connection_client=single_connection_client,
+        )
 
     def __init__(
         self,
diff --git a/redis/client.py b/redis/client.py
index 65d0cec9a9..9fd5b7ca9e 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -906,8 +906,12 @@ class initializer. In the case of conflicting arguments, querystring
         arguments always win.
 
         """
+        single_connection_client = kwargs.pop("single_connection_client", False)
         connection_pool = ConnectionPool.from_url(url, **kwargs)
-        return cls(connection_pool=connection_pool)
+        return cls(
+            connection_pool=connection_pool,
+            single_connection_client=single_connection_client,
+        )
 
     def __init__(
         self,
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index e49dd42204..158b8545e2 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -271,3 +271,9 @@ async def open_connection(*args, **kwargs):
 
     vals = await asyncio.gather(do_read(), do_close())
     assert vals == [b"Hello, World!", None]
+
+
+@pytest.mark.onlynoncluster
+def test_create_single_connection_client_from_url():
+    client = Redis.from_url("redis://localhost:6379/0?", single_connection_client=True)
+    assert client.single_connection_client is True
diff --git a/tests/test_connection.py b/tests/test_connection.py
index 75ba738047..31268a9e8b 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -205,3 +205,11 @@ def test_pack_command(Class):
 
     actual = Class().pack_command(*cmd)[0]
     assert actual == expected, f"actual = {actual}, expected = {expected}"
+
+
+@pytest.mark.onlynoncluster
+def test_create_single_connection_client_from_url():
+    client = redis.Redis.from_url(
+        "redis://localhost:6379/0?", single_connection_client=True
+    )
+    assert client.connection is not None

From 4a4566b59a07289ebe6e18bf351ad666fa419a00 Mon Sep 17 00:00:00 2001
From: Seongchuel Ahn <aciddust20@gmail.com>
Date: Mon, 8 May 2023 20:16:26 +0900
Subject: [PATCH 0726/1164] Fix `xadd` allow non negative maxlen (#2739)

* Fix xadd allow non negative maxlen

* Update change log

---------

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 CHANGES                | 1 +
 redis/commands/core.py | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/CHANGES b/CHANGES
index ea171f6bb5..4917980126 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Fix `xadd` command to accept non-negative `maxlen` including 0
     * Revert #2104, #2673, add `disconnect_on_error` option to `read_response()` (issues #2506, #2624)
     * Add `address_remap` parameter to `RedisCluster`
     * Fix incorrect usage of once flag in async Sentinel
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 1a4acb28e8..f2d7bf2eb4 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3496,8 +3496,8 @@ def xadd(
             raise DataError("Only one of ```maxlen``` or ```minid``` may be specified")
 
         if maxlen is not None:
-            if not isinstance(maxlen, int) or maxlen < 1:
-                raise DataError("XADD maxlen must be a positive integer")
+            if not isinstance(maxlen, int) or maxlen < 0:
+                raise DataError("XADD maxlen must be non-negative integer")
             pieces.append(b"MAXLEN")
             if approximate:
                 pieces.append(b"~")

From f056118224e851915922de02ec40f2d16c9e4dd7 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 8 May 2023 14:38:12 +0300
Subject: [PATCH 0727/1164] Version 4.5.5 (#2753)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index f2935b21ce..a6e9422b12 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.5.4",
+    version="4.5.5",
     packages=find_packages(
         include=[
             "redis",

From 35b7e09a57a1b7e2931d90e4b13858b68cee97cf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Wed, 10 May 2023 10:25:41 +0000
Subject: [PATCH 0728/1164] Kristjan/issue #2754: Add missing argument to
 SentinelManagedConnection.read_response() (#2756)

* Increase timeout for a test which would hang completely if failing.
Timeouts in virtualized CI backends can occasionally fail if too short.

* add "disconnect_on_error" argument to SentinelManagedConnection

* update Changes

* lint
---
 CHANGES                             |  1 +
 redis/asyncio/sentinel.py           |  3 +++
 redis/sentinel.py                   | 10 ++++++++--
 tests/test_asyncio/test_commands.py |  2 +-
 4 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/CHANGES b/CHANGES
index 4917980126..1e03453cc3 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Fix #2754, adding a missing argument to SentinelManagedConnection
     * Fix `xadd` command to accept non-negative `maxlen` including 0
     * Revert #2104, #2673, add `disconnect_on_error` option to `read_response()` (issues #2506, #2624)
     * Add `address_remap` parameter to `RedisCluster`
diff --git a/redis/asyncio/sentinel.py b/redis/asyncio/sentinel.py
index 9147ed83d1..501e234c3c 100644
--- a/redis/asyncio/sentinel.py
+++ b/redis/asyncio/sentinel.py
@@ -67,11 +67,14 @@ async def read_response(
         self,
         disable_decoding: bool = False,
         timeout: Optional[float] = None,
+        *,
+        disconnect_on_error: Optional[float] = True,
     ):
         try:
             return await super().read_response(
                 disable_decoding=disable_decoding,
                 timeout=timeout,
+                disconnect_on_error=disconnect_on_error,
             )
         except ReadOnlyError:
             if self.connection_pool.is_master:
diff --git a/redis/sentinel.py b/redis/sentinel.py
index ac6921aa01..f9f8f1c3ce 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -1,5 +1,6 @@
 import random
 import weakref
+from typing import Optional
 
 from redis.client import Redis
 from redis.commands import SentinelCommands
@@ -53,9 +54,14 @@ def _connect_retry(self):
     def connect(self):
         return self.retry.call_with_retry(self._connect_retry, lambda error: None)
 
-    def read_response(self, disable_decoding=False):
+    def read_response(
+        self, disable_decoding=False, *, disconnect_on_error: Optional[bool] = False
+    ):
         try:
-            return super().read_response(disable_decoding=disable_decoding)
+            return super().read_response(
+                disable_decoding=disable_decoding,
+                disconnect_on_error=disconnect_on_error,
+            )
         except ReadOnlyError:
             if self.connection_pool.is_master:
                 # When talking to a master, a ReadOnlyError when likely
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 955b9d42bc..5cde286a9e 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -3051,7 +3051,7 @@ async def helper():
         # the task is now sleeping, lets send it an exception
         task.cancel()
         # If all is well, the task should finish right away, otherwise fail with Timeout
-        async with async_timeout(0.1):
+        async with async_timeout(1.0):
             await task
 
 

From 2d9b5ac6fe03fdc572b8ca47f7134082bae2a5e2 Mon Sep 17 00:00:00 2001
From: shacharPash <93581407+shacharPash@users.noreply.github.com>
Date: Tue, 16 May 2023 13:52:09 +0300
Subject: [PATCH 0729/1164] support JSON.MERGE Command (#2761)

* support JSON.MERGE Command

* linters

* try with abc instead person

* change @skip_ifmodversion_lt to latest ReJSON 2.4.7

* change version

* fix test

* linters

* add async test
---
 redis/commands/json/__init__.py |  1 +
 redis/commands/json/commands.py | 22 +++++++++++++++++++++
 tests/test_asyncio/test_json.py | 35 +++++++++++++++++++++++++++++++++
 tests/test_json.py              | 33 +++++++++++++++++++++++++++++++
 4 files changed, 91 insertions(+)

diff --git a/redis/commands/json/__init__.py b/redis/commands/json/__init__.py
index 7d55023e1e..77fb21c39f 100644
--- a/redis/commands/json/__init__.py
+++ b/redis/commands/json/__init__.py
@@ -38,6 +38,7 @@ def __init__(
             "JSON.GET": self._decode,
             "JSON.MGET": bulk_of_jsons(self._decode),
             "JSON.SET": lambda r: r and nativestr(r) == "OK",
+            "JSON.MERGE": lambda r: r and nativestr(r) == "OK",
             "JSON.NUMINCRBY": self._decode,
             "JSON.NUMMULTBY": self._decode,
             "JSON.TOGGLE": self._decode,
diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index c02c47ad86..5da9245a95 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -253,6 +253,28 @@ def set(
             pieces.append("XX")
         return self.execute_command("JSON.SET", *pieces)
 
+    def merge(
+        self,
+        name: str,
+        path: str,
+        obj: JsonType,
+        decode_keys: Optional[bool] = False,
+    ) -> Optional[str]:
+        """
+        Sets or updates the JSON value at a path..
+
+        ``decode_keys`` If set to True, the keys of ``obj`` will be decoded
+        with utf-8.
+
+        For more information see `JSON.MERGE <https://redis.io/commands/json.merge>`_.
+        """
+        if decode_keys:
+            obj = decode_dict_keys(obj)
+
+        pieces = [name, str(path), self._encode(obj)]
+
+        return self.execute_command("JSON.MERGE", *pieces)
+
     def set_file(
         self,
         name: str,
diff --git a/tests/test_asyncio/test_json.py b/tests/test_asyncio/test_json.py
index fc530c63c1..7334399df4 100644
--- a/tests/test_asyncio/test_json.py
+++ b/tests/test_asyncio/test_json.py
@@ -39,6 +39,41 @@ async def test_json_get_jset(modclient: redis.Redis):
     assert await modclient.exists("foo") == 0
 
 
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.6.0", "ReJSON")  # todo: update after the release
+async def test_json_merge(modclient: redis.Redis):
+    # Test with root path $
+    assert await modclient.json().set(
+        "person_data",
+        "$",
+        {"person1": {"personal_data": {"name": "John"}}},
+    )
+    assert await modclient.json().merge(
+        "person_data", "$", {"person1": {"personal_data": {"hobbies": "reading"}}}
+    )
+    assert await modclient.json().get("person_data") == {
+        "person1": {"personal_data": {"name": "John", "hobbies": "reading"}}
+    }
+
+    # Test with root path path $.person1.personal_data
+    assert await modclient.json().merge(
+        "person_data", "$.person1.personal_data", {"country": "Israel"}
+    )
+    assert await modclient.json().get("person_data") == {
+        "person1": {
+            "personal_data": {"name": "John", "hobbies": "reading", "country": "Israel"}
+        }
+    }
+
+    # Test with null value to delete a value
+    assert await modclient.json().merge(
+        "person_data", "$.person1.personal_data", {"name": None}
+    )
+    assert await modclient.json().get("person_data") == {
+        "person1": {"personal_data": {"country": "Israel", "hobbies": "reading"}}
+    }
+
+
 @pytest.mark.redismod
 async def test_nonascii_setgetdelete(modclient: redis.Redis):
     assert await modclient.json().set("notascii", Path.root_path(), "hyvää-élève")
diff --git a/tests/test_json.py b/tests/test_json.py
index 8e8da05609..0a85998205 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -47,6 +47,39 @@ def test_json_get_jset(client):
     assert client.exists("foo") == 0
 
 
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.6.0", "ReJSON")  # todo: update after the release
+def test_json_merge(client):
+    # Test with root path $
+    assert client.json().set(
+        "person_data",
+        "$",
+        {"person1": {"personal_data": {"name": "John"}}},
+    )
+    assert client.json().merge(
+        "person_data", "$", {"person1": {"personal_data": {"hobbies": "reading"}}}
+    )
+    assert client.json().get("person_data") == {
+        "person1": {"personal_data": {"name": "John", "hobbies": "reading"}}
+    }
+
+    # Test with root path path $.person1.personal_data
+    assert client.json().merge(
+        "person_data", "$.person1.personal_data", {"country": "Israel"}
+    )
+    assert client.json().get("person_data") == {
+        "person1": {
+            "personal_data": {"name": "John", "hobbies": "reading", "country": "Israel"}
+        }
+    }
+
+    # Test with null value to delete a value
+    assert client.json().merge("person_data", "$.person1.personal_data", {"name": None})
+    assert client.json().get("person_data") == {
+        "person1": {"personal_data": {"country": "Israel", "hobbies": "reading"}}
+    }
+
+
 @pytest.mark.redismod
 def test_nonascii_setgetdelete(client):
     assert client.json().set("notascii", Path.root_path(), "hyvää-élève")

From db7b9dd999f4590020125d4d517d0db7f2b47932 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Sun, 28 May 2023 02:09:42 +0000
Subject: [PATCH 0730/1164] Issue #2749: Remove unnecessary __del__ handlers
 (#2755)

* Remove unnecessary __del__ handlers
There normally should be no logic attached to del.  Cleanly disconnecting network resources is not needed at that time.

* add CHANGES
---
 CHANGES                     |  1 +
 redis/asyncio/connection.py | 18 ------------------
 2 files changed, 1 insertion(+), 18 deletions(-)

diff --git a/CHANGES b/CHANGES
index 1e03453cc3..7fd510bd12 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Fix #2749, remove unnecessary __del__ logic to close connections.
     * Fix #2754, adding a missing argument to SentinelManagedConnection
     * Fix `xadd` command to accept non-negative `maxlen` including 0
     * Revert #2104, #2673, add `disconnect_on_error` option to `read_response()` (issues #2506, #2624)
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 462673f2ed..4ba177ef26 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -181,12 +181,6 @@ def __init__(self, socket_read_size: int):
         self._read_size = socket_read_size
         self._connected = False
 
-    def __del__(self):
-        try:
-            self.on_disconnect()
-        except Exception:
-            pass
-
     @classmethod
     def parse_error(cls, response: str) -> ResponseError:
         """Parse an error response"""
@@ -570,18 +564,6 @@ def repr_pieces(self):
             pieces.append(("client_name", self.client_name))
         return pieces
 
-    def __del__(self):
-        try:
-            if self.is_connected:
-                loop = asyncio.get_running_loop()
-                coro = self.disconnect()
-                if loop.is_running():
-                    loop.create_task(coro)
-                else:
-                    loop.run_until_complete(coro)
-        except Exception:
-            pass
-
     @property
     def is_connected(self):
         return self._reader is not None and self._writer is not None

From d95d8a24ed2af3eae80b7b0f14cbccc9dbe86e96 Mon Sep 17 00:00:00 2001
From: Alibi <aliby.bbb@gmail.com>
Date: Sun, 28 May 2023 08:13:10 +0600
Subject: [PATCH 0731/1164] Add WITHSCORE to ZRANK (#2758)

* add withscore to zrank with tests

* fix test
---
 redis/commands/core.py              | 13 +++++++++++--
 tests/test_asyncio/test_commands.py |  9 +++++++++
 tests/test_commands.py              |  9 +++++++++
 3 files changed, 29 insertions(+), 2 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index f2d7bf2eb4..af5384e9ef 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -4654,13 +4654,22 @@ def zrevrangebyscore(
         options = {"withscores": withscores, "score_cast_func": score_cast_func}
         return self.execute_command(*pieces, **options)
 
-    def zrank(self, name: KeyT, value: EncodableT) -> ResponseT:
+    def zrank(
+        self,
+        name: KeyT,
+        value: EncodableT,
+        withscore: bool = False,
+    ) -> ResponseT:
         """
         Returns a 0-based value indicating the rank of ``value`` in sorted set
-        ``name``
+        ``name``.
+        The optional WITHSCORE argument supplements the command's
+        reply with the score of the element returned.
 
         For more information see https://redis.io/commands/zrank
         """
+        if withscore:
+            return self.execute_command("ZRANK", name, value, "WITHSCORE")
         return self.execute_command("ZRANK", name, value)
 
     def zrem(self, name: KeyT, *values: FieldT) -> ResponseT:
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 5cde286a9e..89a8525887 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -1645,6 +1645,15 @@ async def test_zrank(self, r: redis.Redis):
         assert await r.zrank("a", "a2") == 1
         assert await r.zrank("a", "a6") is None
 
+    @skip_if_server_version_lt("7.2.0")
+    async def test_zrank_withscore(self, r: redis.Redis):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
+        assert await r.zrank("a", "a1") == 0
+        assert await r.rank("a", "a2") == 1
+        assert await r.zrank("a", "a6") is None
+        assert await r.zrank("a", "a3", withscore=True) == [2, "3"]
+        assert await r.zrank("a", "a6", withscore=True) is None
+
     async def test_zrem(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
         assert await r.zrem("a", "a2") == 1
diff --git a/tests/test_commands.py b/tests/test_commands.py
index c71e347fab..4e2ac5b041 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2581,6 +2581,15 @@ def test_zrank(self, r):
         assert r.zrank("a", "a2") == 1
         assert r.zrank("a", "a6") is None
 
+    @skip_if_server_version_lt("7.2.0")
+    def test_zrank_withscore(self, r: redis.Redis):
+        r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
+        assert r.zrank("a", "a1") == 0
+        assert r.rank("a", "a2") == 1
+        assert r.zrank("a", "a6") is None
+        assert r.zrank("a", "a3", withscore=True) == [2, "3"]
+        assert r.zrank("a", "a6", withscore=True) is None
+
     def test_zrem(self, r):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
         assert r.zrem("a", "a2") == 1

From 4d396f864f850b65cff669a084c678224db991bd Mon Sep 17 00:00:00 2001
From: shacharPash <93581407+shacharPash@users.noreply.github.com>
Date: Sun, 18 Jun 2023 01:02:00 +0300
Subject: [PATCH 0732/1164] Fix JSON.MERGE Summary (#2786)

* Fix JSON.MERGE Summary

* linters
---
 redis/commands/json/commands.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index 5da9245a95..f91ef9185c 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -261,7 +261,8 @@ def merge(
         decode_keys: Optional[bool] = False,
     ) -> Optional[str]:
         """
-        Sets or updates the JSON value at a path..
+        Merges a given JSON value into matching paths. Consequently, JSON values
+        at matching paths are updated, deleted, or expanded with new children
 
         ``decode_keys`` If set to True, the keys of ``obj`` will be decoded
         with utf-8.

From 3cdecc15d63fdbe7ca0ab088dd247d9a02cc1e43 Mon Sep 17 00:00:00 2001
From: Smit Parmar <smitraj333@gmail.com>
Date: Mon, 19 Jun 2023 15:08:55 +0530
Subject: [PATCH 0733/1164] Fixed key error in parse_xinfo_stream (#2788)

---
 CHANGES         | 1 +
 redis/client.py | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/CHANGES b/CHANGES
index 7fd510bd12..76b3393aa2 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Fix #2768, Fix KeyError: 'first-entry' in parse_xinfo_stream.
     * Fix #2749, remove unnecessary __del__ logic to close connections.
     * Fix #2754, adding a missing argument to SentinelManagedConnection
     * Fix `xadd` command to accept non-negative `maxlen` including 0
diff --git a/redis/client.py b/redis/client.py
index 9fd5b7ca9e..ab626ccdf4 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -320,7 +320,7 @@ def parse_xautoclaim(response, **options):
 def parse_xinfo_stream(response, **options):
     data = pairs_to_dict(response, decode_keys=True)
     if not options.get("full", False):
-        first = data["first-entry"]
+        first = data.get("first-entry")
         if first is not None:
             data["first-entry"] = (first[0], pairs_to_dict(first[1]))
         last = data["last-entry"]

From 29dfbb2ebf46dcced5f001257195a623cbd0d4ba Mon Sep 17 00:00:00 2001
From: Brad MacPhee <macphee@gmail.com>
Date: Tue, 20 Jun 2023 08:41:31 -0300
Subject: [PATCH 0734/1164] insert newline to prevent sphinx from assuming code
 block (#2796)

---
 redis/exceptions.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/redis/exceptions.py b/redis/exceptions.py
index 8a8bf423eb..7c705d3c15 100644
--- a/redis/exceptions.py
+++ b/redis/exceptions.py
@@ -131,6 +131,7 @@ class AskError(ResponseError):
     pertain to this hash slot, but only if the key in question exists,
     otherwise the query is forwarded using a -ASK redirection to the node that
     is target of the migration.
+
     src node: MIGRATING to dst node
         get > ASK error
         ask dst node > ASKING command

From 2bb7f102f6b6724f5d5d9f2cdb187226ab5d2167 Mon Sep 17 00:00:00 2001
From: Brad MacPhee <macphee@gmail.com>
Date: Tue, 20 Jun 2023 08:41:53 -0300
Subject: [PATCH 0735/1164] Introduce OutOfMemoryError exception for Redis
 write command rejections due to OOM errors (#2778)

* expose OutOfMemoryError as explicit exception type

- handle "OOM" error code string by raising explicit
  exception type instance
- enables callers to avoid string matching after
  catching ResponseError

* add OutOfMemoryError exception class docstring

* Provide more info in the exception docstring

* Fix formatting

* Again

* linters

---------

Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: Igor Malinovskiy <u.glide@gmail.com>
Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/__init__.py                          |  2 ++
 redis/asyncio/__init__.py                  |  2 ++
 redis/asyncio/connection.py                |  2 ++
 redis/connection.py                        |  2 ++
 redis/exceptions.py                        | 12 ++++++++++++
 tests/test_asyncio/test_connection_pool.py | 10 +++++++++-
 tests/test_connection_pool.py              |  9 ++++++++-
 7 files changed, 37 insertions(+), 2 deletions(-)

diff --git a/redis/__init__.py b/redis/__init__.py
index b8850add15..d7b74edf41 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -19,6 +19,7 @@
     ConnectionError,
     DataError,
     InvalidResponse,
+    OutOfMemoryError,
     PubSubError,
     ReadOnlyError,
     RedisError,
@@ -72,6 +73,7 @@ def int_or_str(value):
     "from_url",
     "default_backoff",
     "InvalidResponse",
+    "OutOfMemoryError",
     "PubSubError",
     "ReadOnlyError",
     "Redis",
diff --git a/redis/asyncio/__init__.py b/redis/asyncio/__init__.py
index bf90dde555..2a82df251e 100644
--- a/redis/asyncio/__init__.py
+++ b/redis/asyncio/__init__.py
@@ -24,6 +24,7 @@
     ConnectionError,
     DataError,
     InvalidResponse,
+    OutOfMemoryError,
     PubSubError,
     ReadOnlyError,
     RedisError,
@@ -47,6 +48,7 @@
     "default_backoff",
     "InvalidResponse",
     "PubSubError",
+    "OutOfMemoryError",
     "ReadOnlyError",
     "Redis",
     "RedisCluster",
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 4ba177ef26..efe3a3e1b0 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -49,6 +49,7 @@
     ModuleError,
     NoPermissionError,
     NoScriptError,
+    OutOfMemoryError,
     ReadOnlyError,
     RedisError,
     ResponseError,
@@ -174,6 +175,7 @@ class BaseParser:
         "READONLY": ReadOnlyError,
         "NOAUTH": AuthenticationError,
         "NOPERM": NoPermissionError,
+        "OOM": OutOfMemoryError,
     }
 
     def __init__(self, socket_read_size: int):
diff --git a/redis/connection.py b/redis/connection.py
index 5af8928a5d..bf0d6dea80 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -28,6 +28,7 @@
     ModuleError,
     NoPermissionError,
     NoScriptError,
+    OutOfMemoryError,
     ReadOnlyError,
     RedisError,
     ResponseError,
@@ -149,6 +150,7 @@ class BaseParser:
             MODULE_UNLOAD_NOT_POSSIBLE_ERROR: ModuleError,
             **NO_AUTH_SET_ERROR,
         },
+        "OOM": OutOfMemoryError,
         "WRONGPASS": AuthenticationError,
         "EXECABORT": ExecAbortError,
         "LOADING": BusyLoadingError,
diff --git a/redis/exceptions.py b/redis/exceptions.py
index 7c705d3c15..7cf15a7d07 100644
--- a/redis/exceptions.py
+++ b/redis/exceptions.py
@@ -49,6 +49,18 @@ class NoScriptError(ResponseError):
     pass
 
 
+class OutOfMemoryError(ResponseError):
+    """
+    Indicates the database is full. Can only occur when either:
+      * Redis maxmemory-policy=noeviction
+      * Redis maxmemory-policy=volatile* and there are no evictable keys
+
+    For more information see `Memory optimization in Redis <https://redis.io/docs/management/optimization/memory-optimization/#memory-allocation>`_. # noqa
+    """
+
+    pass
+
+
 class ExecAbortError(ResponseError):
     pass
 
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
index 92499e2c4a..24d9902142 100644
--- a/tests/test_asyncio/test_connection_pool.py
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -606,10 +606,18 @@ async def test_busy_loading_from_pipeline(self, r):
     @skip_if_server_version_lt("2.8.8")
     @skip_if_redis_enterprise()
     async def test_read_only_error(self, r):
-        """READONLY errors get turned in ReadOnlyError exceptions"""
+        """READONLY errors get turned into ReadOnlyError exceptions"""
         with pytest.raises(redis.ReadOnlyError):
             await r.execute_command("DEBUG", "ERROR", "READONLY blah blah")
 
+    @skip_if_redis_enterprise()
+    async def test_oom_error(self, r):
+        """OOM errors get turned into OutOfMemoryError exceptions"""
+        with pytest.raises(redis.OutOfMemoryError):
+            # note: don't use the DEBUG OOM command since it's not the same
+            # as the db being full
+            await r.execute_command("DEBUG", "ERROR", "OOM blah blah")
+
     def test_connect_from_url_tcp(self):
         connection = redis.Redis.from_url("redis://localhost")
         pool = connection.connection_pool
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index e8a42692a1..155bffe56a 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -528,10 +528,17 @@ def test_busy_loading_from_pipeline(self, r):
     @skip_if_server_version_lt("2.8.8")
     @skip_if_redis_enterprise()
     def test_read_only_error(self, r):
-        "READONLY errors get turned in ReadOnlyError exceptions"
+        "READONLY errors get turned into ReadOnlyError exceptions"
         with pytest.raises(redis.ReadOnlyError):
             r.execute_command("DEBUG", "ERROR", "READONLY blah blah")
 
+    def test_oom_error(self, r):
+        "OOM errors get turned into OutOfMemoryError exceptions"
+        with pytest.raises(redis.OutOfMemoryError):
+            # note: don't use the DEBUG OOM command since it's not the same
+            # as the db being full
+            r.execute_command("DEBUG", "ERROR", "OOM blah blah")
+
     def test_connect_from_url_tcp(self):
         connection = redis.Redis.from_url("redis://localhost")
         pool = connection.connection_pool

From 53bed279cda7c31943ef54694527d525021d019f Mon Sep 17 00:00:00 2001
From: woutdenolf <woutdenolf@users.sf.net>
Date: Fri, 23 Jun 2023 15:33:51 +0200
Subject: [PATCH 0736/1164] Add unit tests for the `connect` method of all
 Redis connection classes (#2631)

* tests: move certificate discovery to a separate module

* tests: add 'connect' tests for all Redis connection classes

---------

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 tests/ssl_utils.py                 |  14 +++
 tests/test_asyncio/test_cluster.py |  15 +--
 tests/test_asyncio/test_connect.py | 145 ++++++++++++++++++++++
 tests/test_connect.py              | 185 +++++++++++++++++++++++++++++
 tests/test_ssl.py                  |  15 +--
 5 files changed, 350 insertions(+), 24 deletions(-)
 create mode 100644 tests/ssl_utils.py
 create mode 100644 tests/test_asyncio/test_connect.py
 create mode 100644 tests/test_connect.py

diff --git a/tests/ssl_utils.py b/tests/ssl_utils.py
new file mode 100644
index 0000000000..50937638a7
--- /dev/null
+++ b/tests/ssl_utils.py
@@ -0,0 +1,14 @@
+import os
+
+
+def get_ssl_filename(name):
+    root = os.path.join(os.path.dirname(__file__), "..")
+    cert_dir = os.path.abspath(os.path.join(root, "docker", "stunnel", "keys"))
+    if not os.path.isdir(cert_dir):  # github actions package validation case
+        cert_dir = os.path.abspath(
+            os.path.join(root, "..", "docker", "stunnel", "keys")
+        )
+        if not os.path.isdir(cert_dir):
+            raise IOError(f"No SSL certificates found. They should be in {cert_dir}")
+
+    return os.path.join(cert_dir, name)
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 17aa879b0f..c41d4a2168 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -1,7 +1,6 @@
 import asyncio
 import binascii
 import datetime
-import os
 import warnings
 from typing import Any, Awaitable, Callable, Dict, List, Optional, Type, Union
 from urllib.parse import urlparse
@@ -36,6 +35,7 @@
     skip_unless_arch_bits,
 )
 
+from ..ssl_utils import get_ssl_filename
 from .compat import mock
 
 pytestmark = pytest.mark.onlycluster
@@ -2744,17 +2744,8 @@ class TestSSL:
     appropriate port.
     """
 
-    ROOT = os.path.join(os.path.dirname(__file__), "../..")
-    CERT_DIR = os.path.abspath(os.path.join(ROOT, "docker", "stunnel", "keys"))
-    if not os.path.isdir(CERT_DIR):  # github actions package validation case
-        CERT_DIR = os.path.abspath(
-            os.path.join(ROOT, "..", "docker", "stunnel", "keys")
-        )
-        if not os.path.isdir(CERT_DIR):
-            raise IOError(f"No SSL certificates found. They should be in {CERT_DIR}")
-
-    SERVER_CERT = os.path.join(CERT_DIR, "server-cert.pem")
-    SERVER_KEY = os.path.join(CERT_DIR, "server-key.pem")
+    SERVER_CERT = get_ssl_filename("server-cert.pem")
+    SERVER_KEY = get_ssl_filename("server-key.pem")
 
     @pytest_asyncio.fixture()
     def create_client(self, request: FixtureRequest) -> Callable[..., RedisCluster]:
diff --git a/tests/test_asyncio/test_connect.py b/tests/test_asyncio/test_connect.py
new file mode 100644
index 0000000000..8e3209fdc6
--- /dev/null
+++ b/tests/test_asyncio/test_connect.py
@@ -0,0 +1,145 @@
+import asyncio
+import logging
+import re
+import socket
+import ssl
+
+import pytest
+
+from redis.asyncio.connection import (
+    Connection,
+    SSLConnection,
+    UnixDomainSocketConnection,
+)
+
+from ..ssl_utils import get_ssl_filename
+
+_logger = logging.getLogger(__name__)
+
+
+_CLIENT_NAME = "test-suite-client"
+_CMD_SEP = b"\r\n"
+_SUCCESS_RESP = b"+OK" + _CMD_SEP
+_ERROR_RESP = b"-ERR" + _CMD_SEP
+_SUPPORTED_CMDS = {f"CLIENT SETNAME {_CLIENT_NAME}": _SUCCESS_RESP}
+
+
+@pytest.fixture
+def tcp_address():
+    with socket.socket() as sock:
+        sock.bind(("127.0.0.1", 0))
+        return sock.getsockname()
+
+
+@pytest.fixture
+def uds_address(tmpdir):
+    return tmpdir / "uds.sock"
+
+
+async def test_tcp_connect(tcp_address):
+    host, port = tcp_address
+    conn = Connection(host=host, port=port, client_name=_CLIENT_NAME, socket_timeout=10)
+    await _assert_connect(conn, tcp_address)
+
+
+async def test_uds_connect(uds_address):
+    path = str(uds_address)
+    conn = UnixDomainSocketConnection(
+        path=path, client_name=_CLIENT_NAME, socket_timeout=10
+    )
+    await _assert_connect(conn, path)
+
+
+@pytest.mark.ssl
+async def test_tcp_ssl_connect(tcp_address):
+    host, port = tcp_address
+    certfile = get_ssl_filename("server-cert.pem")
+    keyfile = get_ssl_filename("server-key.pem")
+    conn = SSLConnection(
+        host=host,
+        port=port,
+        client_name=_CLIENT_NAME,
+        ssl_ca_certs=certfile,
+        socket_timeout=10,
+    )
+    await _assert_connect(conn, tcp_address, certfile=certfile, keyfile=keyfile)
+
+
+async def _assert_connect(conn, server_address, certfile=None, keyfile=None):
+    stop_event = asyncio.Event()
+    finished = asyncio.Event()
+
+    async def _handler(reader, writer):
+        try:
+            return await _redis_request_handler(reader, writer, stop_event)
+        finally:
+            finished.set()
+
+    if isinstance(server_address, str):
+        server = await asyncio.start_unix_server(_handler, path=server_address)
+    elif certfile:
+        host, port = server_address
+        context = ssl.create_default_context(ssl.Purpose.CLIENT_AUTH)
+        context.minimum_version = ssl.TLSVersion.TLSv1_2
+        context.load_cert_chain(certfile=certfile, keyfile=keyfile)
+        server = await asyncio.start_server(_handler, host=host, port=port, ssl=context)
+    else:
+        host, port = server_address
+        server = await asyncio.start_server(_handler, host=host, port=port)
+
+    async with server as aserver:
+        await aserver.start_serving()
+        try:
+            await conn.connect()
+            await conn.disconnect()
+        finally:
+            stop_event.set()
+            aserver.close()
+            await aserver.wait_closed()
+            await finished.wait()
+
+
+async def _redis_request_handler(reader, writer, stop_event):
+    buffer = b""
+    command = None
+    command_ptr = None
+    fragment_length = None
+    while not stop_event.is_set() or buffer:
+        _logger.info(str(stop_event.is_set()))
+        try:
+            buffer += await asyncio.wait_for(reader.read(1024), timeout=0.5)
+        except TimeoutError:
+            continue
+        if not buffer:
+            continue
+        parts = re.split(_CMD_SEP, buffer)
+        buffer = parts[-1]
+        for fragment in parts[:-1]:
+            fragment = fragment.decode()
+            _logger.info("Command fragment: %s", fragment)
+
+            if fragment.startswith("*") and command is None:
+                command = [None for _ in range(int(fragment[1:]))]
+                command_ptr = 0
+                fragment_length = None
+                continue
+
+            if fragment.startswith("$") and command[command_ptr] is None:
+                fragment_length = int(fragment[1:])
+                continue
+
+            assert len(fragment) == fragment_length
+            command[command_ptr] = fragment
+            command_ptr += 1
+
+            if command_ptr < len(command):
+                continue
+
+            command = " ".join(command)
+            _logger.info("Command %s", command)
+            resp = _SUPPORTED_CMDS.get(command, _ERROR_RESP)
+            _logger.info("Response from %s", resp)
+            writer.write(resp)
+            await writer.drain()
+            command = None
+    _logger.info("Exit handler")
diff --git a/tests/test_connect.py b/tests/test_connect.py
new file mode 100644
index 0000000000..b4ec7020e1
--- /dev/null
+++ b/tests/test_connect.py
@@ -0,0 +1,185 @@
+import logging
+import re
+import socket
+import socketserver
+import ssl
+import threading
+
+import pytest
+
+from redis.connection import Connection, SSLConnection, UnixDomainSocketConnection
+
+from .ssl_utils import get_ssl_filename
+
+_logger = logging.getLogger(__name__)
+
+
+_CLIENT_NAME = "test-suite-client"
+_CMD_SEP = b"\r\n"
+_SUCCESS_RESP = b"+OK" + _CMD_SEP
+_ERROR_RESP = b"-ERR" + _CMD_SEP
+_SUPPORTED_CMDS = {f"CLIENT SETNAME {_CLIENT_NAME}": _SUCCESS_RESP}
+
+
+@pytest.fixture
+def tcp_address():
+    with socket.socket() as sock:
+        sock.bind(("127.0.0.1", 0))
+        return sock.getsockname()
+
+
+@pytest.fixture
+def uds_address(tmpdir):
+    return tmpdir / "uds.sock"
+
+
+def test_tcp_connect(tcp_address):
+    host, port = tcp_address
+    conn = Connection(host=host, port=port, client_name=_CLIENT_NAME, socket_timeout=10)
+    _assert_connect(conn, tcp_address)
+
+
+def test_uds_connect(uds_address):
+    path = str(uds_address)
+    conn = UnixDomainSocketConnection(path, client_name=_CLIENT_NAME, socket_timeout=10)
+    _assert_connect(conn, path)
+
+
+@pytest.mark.ssl
+def test_tcp_ssl_connect(tcp_address):
+    host, port = tcp_address
+    certfile = get_ssl_filename("server-cert.pem")
+    keyfile = get_ssl_filename("server-key.pem")
+    conn = SSLConnection(
+        host=host,
+        port=port,
+        client_name=_CLIENT_NAME,
+        ssl_ca_certs=certfile,
+        socket_timeout=10,
+    )
+    _assert_connect(conn, tcp_address, certfile=certfile, keyfile=keyfile)
+
+
+def _assert_connect(conn, server_address, certfile=None, keyfile=None):
+    if isinstance(server_address, str):
+        server = _RedisUDSServer(server_address, _RedisRequestHandler)
+    else:
+        server = _RedisTCPServer(
+            server_address, _RedisRequestHandler, certfile=certfile, keyfile=keyfile
+        )
+    with server as aserver:
+        t = threading.Thread(target=aserver.serve_forever)
+        t.start()
+        try:
+            aserver.wait_online()
+            conn.connect()
+            conn.disconnect()
+        finally:
+            aserver.stop()
+            t.join(timeout=5)
+
+
+class _RedisTCPServer(socketserver.TCPServer):
+    def __init__(self, *args, certfile=None, keyfile=None, **kw) -> None:
+        self._ready_event = threading.Event()
+        self._stop_requested = False
+        self._certfile = certfile
+        self._keyfile = keyfile
+        super().__init__(*args, **kw)
+
+    def service_actions(self):
+        self._ready_event.set()
+
+    def wait_online(self):
+        self._ready_event.wait()
+
+    def stop(self):
+        self._stop_requested = True
+        self.shutdown()
+
+    def is_serving(self):
+        return not self._stop_requested
+
+    def get_request(self):
+        if self._certfile is None:
+            return super().get_request()
+        newsocket, fromaddr = self.socket.accept()
+        connstream = ssl.wrap_socket(
+            newsocket,
+            server_side=True,
+            certfile=self._certfile,
+            keyfile=self._keyfile,
+            ssl_version=ssl.PROTOCOL_TLSv1_2,
+        )
+        return connstream, fromaddr
+
+
+class _RedisUDSServer(socketserver.UnixStreamServer):
+    def __init__(self, *args, **kw) -> None:
+        self._ready_event = threading.Event()
+        self._stop_requested = False
+        super().__init__(*args, **kw)
+
+    def service_actions(self):
+        self._ready_event.set()
+
+    def wait_online(self):
+        self._ready_event.wait()
+
+    def stop(self):
+        self._stop_requested = True
+        self.shutdown()
+
+    def is_serving(self):
+        return not self._stop_requested
+
+
+class _RedisRequestHandler(socketserver.StreamRequestHandler):
+    def setup(self):
+        _logger.info("%s connected", self.client_address)
+
+    def finish(self):
+        _logger.info("%s disconnected", self.client_address)
+
+    def handle(self):
+        buffer = b""
+        command = None
+        command_ptr = None
+        fragment_length = None
+        while self.server.is_serving() or buffer:
+            try:
+                buffer += self.request.recv(1024)
+            except socket.timeout:
+                continue
+            if not buffer:
+                continue
+            parts = re.split(_CMD_SEP, buffer)
+            buffer = parts[-1]
+            for fragment in parts[:-1]:
+                fragment = fragment.decode()
+                _logger.info("Command fragment: %s", fragment)
+
+                if fragment.startswith("*") and command is None:
+                    command = [None for _ in range(int(fragment[1:]))]
+                    command_ptr = 0
+                    fragment_length = None
+                    continue
+
+                if fragment.startswith("$") and command[command_ptr] is None:
+                    fragment_length = int(fragment[1:])
+                    continue
+
+                assert len(fragment) == fragment_length
+                command[command_ptr] = fragment
+                command_ptr += 1
+
+                if command_ptr < len(command):
+                    continue
+
+                command = " ".join(command)
+                _logger.info("Command %s", command)
+                resp = _SUPPORTED_CMDS.get(command, _ERROR_RESP)
+                _logger.info("Response %s", resp)
+                self.request.sendall(resp)
+                command = None
+        _logger.info("Exit handler")
diff --git a/tests/test_ssl.py b/tests/test_ssl.py
index ed38a3166b..c1a981d310 100644
--- a/tests/test_ssl.py
+++ b/tests/test_ssl.py
@@ -1,4 +1,3 @@
-import os
 import socket
 import ssl
 from urllib.parse import urlparse
@@ -9,6 +8,7 @@
 from redis.exceptions import ConnectionError, RedisError
 
 from .conftest import skip_if_cryptography, skip_if_nocryptography
+from .ssl_utils import get_ssl_filename
 
 
 @pytest.mark.ssl
@@ -19,17 +19,8 @@ class TestSSL:
     and connecting to the appropriate port.
     """
 
-    ROOT = os.path.join(os.path.dirname(__file__), "..")
-    CERT_DIR = os.path.abspath(os.path.join(ROOT, "docker", "stunnel", "keys"))
-    if not os.path.isdir(CERT_DIR):  # github actions package validation case
-        CERT_DIR = os.path.abspath(
-            os.path.join(ROOT, "..", "docker", "stunnel", "keys")
-        )
-        if not os.path.isdir(CERT_DIR):
-            raise IOError(f"No SSL certificates found. They should be in {CERT_DIR}")
-
-    SERVER_CERT = os.path.join(CERT_DIR, "server-cert.pem")
-    SERVER_KEY = os.path.join(CERT_DIR, "server-key.pem")
+    SERVER_CERT = get_ssl_filename("server-cert.pem")
+    SERVER_KEY = get_ssl_filename("server-key.pem")
 
     def test_ssl_with_invalid_cert(self, request):
         ssl_url = request.config.option.redis_ssl_url

From 4f466d6b6d2908d5e6026f5f2c1ce8529c8ad451 Mon Sep 17 00:00:00 2001
From: Shahar Lev <shahar_lev@hotmail.com>
Date: Fri, 23 Jun 2023 16:35:12 +0300
Subject: [PATCH 0737/1164] Fix dead weakref in sentinel connection causing
 ReferenceError (#2767) (#2771)

* Fix dead weakref in sentinel conn (#2767)

* Update CHANGES

---------

Co-authored-by: Igor Malinovskiy <u.glide@gmail.com>
Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 CHANGES                |  1 +
 redis/sentinel.py      | 88 ++++++++++++++++++++++++++++++------------
 tests/test_sentinel.py |  9 +++++
 3 files changed, 73 insertions(+), 25 deletions(-)

diff --git a/CHANGES b/CHANGES
index 76b3393aa2..040e445228 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Fix dead weakref in sentinel connection causing ReferenceError (#2767)
     * Fix #2768, Fix KeyError: 'first-entry' in parse_xinfo_stream.
     * Fix #2749, remove unnecessary __del__ logic to close connections.
     * Fix #2754, adding a missing argument to SentinelManagedConnection
diff --git a/redis/sentinel.py b/redis/sentinel.py
index f9f8f1c3ce..0ba179b9ca 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -78,6 +78,54 @@ class SentinelManagedSSLConnection(SentinelManagedConnection, SSLConnection):
     pass
 
 
+class SentinelConnectionPoolProxy:
+    def __init__(
+        self,
+        connection_pool,
+        is_master,
+        check_connection,
+        service_name,
+        sentinel_manager,
+    ):
+        self.connection_pool_ref = weakref.ref(connection_pool)
+        self.is_master = is_master
+        self.check_connection = check_connection
+        self.service_name = service_name
+        self.sentinel_manager = sentinel_manager
+        self.reset()
+
+    def reset(self):
+        self.master_address = None
+        self.slave_rr_counter = None
+
+    def get_master_address(self):
+        master_address = self.sentinel_manager.discover_master(self.service_name)
+        if self.is_master and self.master_address != master_address:
+            self.master_address = master_address
+            # disconnect any idle connections so that they reconnect
+            # to the new master the next time that they are used.
+            connection_pool = self.connection_pool_ref()
+            if connection_pool is not None:
+                connection_pool.disconnect(inuse_connections=False)
+        return master_address
+
+    def rotate_slaves(self):
+        slaves = self.sentinel_manager.discover_slaves(self.service_name)
+        if slaves:
+            if self.slave_rr_counter is None:
+                self.slave_rr_counter = random.randint(0, len(slaves) - 1)
+            for _ in range(len(slaves)):
+                self.slave_rr_counter = (self.slave_rr_counter + 1) % len(slaves)
+                slave = slaves[self.slave_rr_counter]
+                yield slave
+        # Fallback to the master connection
+        try:
+            yield self.get_master_address()
+        except MasterNotFoundError:
+            pass
+        raise SlaveNotFoundError(f"No slave found for {self.service_name!r}")
+
+
 class SentinelConnectionPool(ConnectionPool):
     """
     Sentinel backed connection pool.
@@ -95,8 +143,15 @@ def __init__(self, service_name, sentinel_manager, **kwargs):
         )
         self.is_master = kwargs.pop("is_master", True)
         self.check_connection = kwargs.pop("check_connection", False)
+        self.proxy = SentinelConnectionPoolProxy(
+            connection_pool=self,
+            is_master=self.is_master,
+            check_connection=self.check_connection,
+            service_name=service_name,
+            sentinel_manager=sentinel_manager,
+        )
         super().__init__(**kwargs)
-        self.connection_kwargs["connection_pool"] = weakref.proxy(self)
+        self.connection_kwargs["connection_pool"] = self.proxy
         self.service_name = service_name
         self.sentinel_manager = sentinel_manager
 
@@ -106,8 +161,11 @@ def __repr__(self):
 
     def reset(self):
         super().reset()
-        self.master_address = None
-        self.slave_rr_counter = None
+        self.proxy.reset()
+
+    @property
+    def master_address(self):
+        return self.proxy.master_address
 
     def owns_connection(self, connection):
         check = not self.is_master or (
@@ -117,31 +175,11 @@ def owns_connection(self, connection):
         return check and parent.owns_connection(connection)
 
     def get_master_address(self):
-        master_address = self.sentinel_manager.discover_master(self.service_name)
-        if self.is_master:
-            if self.master_address != master_address:
-                self.master_address = master_address
-                # disconnect any idle connections so that they reconnect
-                # to the new master the next time that they are used.
-                self.disconnect(inuse_connections=False)
-        return master_address
+        return self.proxy.get_master_address()
 
     def rotate_slaves(self):
         "Round-robin slave balancer"
-        slaves = self.sentinel_manager.discover_slaves(self.service_name)
-        if slaves:
-            if self.slave_rr_counter is None:
-                self.slave_rr_counter = random.randint(0, len(slaves) - 1)
-            for _ in range(len(slaves)):
-                self.slave_rr_counter = (self.slave_rr_counter + 1) % len(slaves)
-                slave = slaves[self.slave_rr_counter]
-                yield slave
-        # Fallback to the master connection
-        try:
-            yield self.get_master_address()
-        except MasterNotFoundError:
-            pass
-        raise SlaveNotFoundError(f"No slave found for {self.service_name!r}")
+        return self.proxy.rotate_slaves()
 
 
 class Sentinel(SentinelCommands):
diff --git a/tests/test_sentinel.py b/tests/test_sentinel.py
index 8542a0bfc3..e5e3d26fa7 100644
--- a/tests/test_sentinel.py
+++ b/tests/test_sentinel.py
@@ -98,6 +98,15 @@ def test_discover_master_error(sentinel):
         sentinel.discover_master("xxx")
 
 
+@pytest.mark.onlynoncluster
+def test_dead_pool(sentinel):
+    master = sentinel.master_for("mymaster", db=9)
+    conn = master.connection_pool.get_connection("_")
+    conn.disconnect()
+    del master
+    conn.connect()
+
+
 @pytest.mark.onlynoncluster
 def test_discover_master_sentinel_down(cluster, sentinel, master_ip):
     # Put first sentinel 'foo' down

From abc04b547a8034a723f634e2556729983bc38221 Mon Sep 17 00:00:00 2001
From: Vladimir Mihailenco <vladimir.webdev@gmail.com>
Date: Fri, 23 Jun 2023 16:35:44 +0300
Subject: [PATCH 0738/1164] chore(documentation): fix redirects and some small
 cleanups (#2801)

---
 docs/opentelemetry.rst | 73 ++++++++++++++++++++----------------------
 1 file changed, 34 insertions(+), 39 deletions(-)

diff --git a/docs/opentelemetry.rst b/docs/opentelemetry.rst
index 96781028e3..d006a60461 100644
--- a/docs/opentelemetry.rst
+++ b/docs/opentelemetry.rst
@@ -4,7 +4,7 @@ Integrating OpenTelemetry
 What is OpenTelemetry?
 ----------------------
 
-`OpenTelemetry <https://opentelemetry.io>`_ is an open-source observability framework for traces, metrics, and logs.
+`OpenTelemetry <https://opentelemetry.io>`_ is an open-source observability framework for traces, metrics, and logs. It is a merger of OpenCensus and OpenTracing projects hosted by Cloud Native Computing Foundation.
 
 OpenTelemetry allows developers to collect and export telemetry data in a vendor agnostic way. With OpenTelemetry, you can instrument your application once and then add or change vendors without changing the instrumentation, for example, here is a list of `popular DataDog competitors <https://uptrace.dev/get/compare/datadog-competitors.html>`_ that support OpenTelemetry.
 
@@ -97,7 +97,7 @@ See `OpenTelemetry Python Tracing API <https://uptrace.dev/opentelemetry/python-
 Uptrace
 -------
 
-Uptrace is an `open-source APM <https://uptrace.dev/get/open-source-apm.html>`_ that supports distributed tracing, metrics, and logs. You can use it to monitor applications and set up automatic alerts to receive notifications via email, Slack, Telegram, and more.
+Uptrace is an `open source APM <https://uptrace.dev/get/open-source-apm.html>`_ that supports distributed tracing, metrics, and logs. You can use it to monitor applications and set up automatic alerts to receive notifications via email, Slack, Telegram, and more.
 
 You can use Uptrace to monitor redis-py using this `GitHub example <https://github.com/redis/redis-py/tree/master/docs/examples/opentelemetry>`_ as a starting point.
 
@@ -111,9 +111,9 @@ Monitoring Redis Server performance
 
 In addition to monitoring redis-py client, you can also monitor Redis Server performance using OpenTelemetry Collector Agent.
 
-OpenTelemetry Collector is a proxy/middleman between your application and a `distributed tracing tool <https://uptrace.dev/get/compare/distributed-tracing-tools.html>`_ such as Uptrace or Jaeger. Collector receives telemetry data, processes it, and then exports the data to APM tools that can store it permanently.
+OpenTelemetry Collector is a proxy/middleman between your application and a `distributed tracing tool <https://uptrace.dev/blog/distributed-tracing-tools.html>`_ such as Uptrace or Jaeger. Collector receives telemetry data, processes it, and then exports the data to APM tools that can store it permanently.
 
-For example, you can use the Redis receiver provided by Otel Collector to `monitor Redis performance <https://uptrace.dev/opentelemetry/redis-monitoring.html>`_:
+For example, you can use the `OpenTelemetry Redis receiver <https://uptrace.dev/get/monitor/opentelemetry-redis.html>` provided by Otel Collector to monitor Redis performance:
 
 .. image:: images/opentelemetry/redis-metrics.png
   :alt: Redis metrics
@@ -123,55 +123,50 @@ See introduction to `OpenTelemetry Collector <https://uptrace.dev/opentelemetry/
 Alerting and notifications
 --------------------------
 
-Uptrace also allows you to monitor `OpenTelemetry metrics <https://uptrace.dev/opentelemetry/metrics.html>`_ using alerting rules. For example, the following rule uses the group by node expression to create an alert whenever an individual Redis shard is down:
+Uptrace also allows you to monitor `OpenTelemetry metrics <https://uptrace.dev/opentelemetry/metrics.html>`_ using alerting rules. For example, the following monitor uses the group by node expression to create an alert whenever an individual Redis shard is down:
 
 .. code-block:: python
 
-   # /etc/uptrace/uptrace.yml
-
-   alerting:
-     rules:
-       - name: Redis shard is down
-         metrics:
-           - redis_up as $redis_up
-         query:
-           - group by cluster # monitor each cluster,
-           - group by bdb # each database,
-           - group by node # and each shard
-           - $redis_up == 0
-         # shard should be down for 5 minutes to trigger an alert
-         for: 5m
+   monitors:
+     - name: Redis shard is down
+       metrics:
+         - redis_up as $redis_up
+       query:
+         - group by cluster # monitor each cluster,
+         - group by bdb # each database,
+         - group by node # and each shard
+         - $redis_up
+       min_allowed_value: 1
+       # shard should be down for 5 minutes to trigger an alert
+       for_duration: 5m
 
 You can also create queries with more complex expressions. For example, the following rule creates an alert when the keyspace hit rate is lower than 75%:
 
 .. code-block:: python
 
-   # /etc/uptrace/uptrace.yml
-
-   alerting:
-     rules:
-       - name: Redis read hit rate < 75%
-         metrics:
-           - redis_keyspace_read_hits as $hits
-           - redis_keyspace_read_misses as $misses
-         query:
-           - group by cluster
-           - group by bdb
-           - group by node
-           - $hits / ($hits + $misses) < 0.75
-         for: 5m
+   monitors:
+     - name: Redis read hit rate < 75%
+       metrics:
+         - redis_keyspace_read_hits as $hits
+         - redis_keyspace_read_misses as $misses
+       query:
+         - group by cluster
+         - group by bdb
+         - group by node
+         - $hits / ($hits + $misses) as hit_rate
+       min_allowed_value: 0.75
+       for_duration: 5m
 
 See `Alerting and Notifications <https://uptrace.dev/get/alerting.html>`_ for details.
 
 What's next?
 ------------
 
-Next, you can learn how to configure `uptrace-python <https://uptrace.dev/get/uptrace-python.html>`_ to export spans, metrics, and logs to Uptrace.
+Next, you can learn how to configure `uptrace-python <https://uptrace.dev/get/opentelemetry-python.html>`_ to export spans, metrics, and logs to Uptrace.
 
 You may also be interested in the following guides:
 
-- `OpenTelemetry Django <https://uptrace.dev/opentelemetry/instrumentations/python-django.html>`_
-- `OpenTelemetry Flask <https://uptrace.dev/opentelemetry/instrumentations/python-flask.html>`_
-- `OpenTelemetry FastAPI <https://uptrace.dev/opentelemetry/instrumentations/python-fastapi.html>`_
-- `OpenTelemetry SQLAlchemy <https://uptrace.dev/opentelemetry/instrumentations/python-sqlalchemy.html>`_
-- `OpenTelemetry instrumentations <https://uptrace.dev/opentelemetry/instrumentations/>`_
+- `OpenTelemetry Django <https://uptrace.dev/get/instrument/opentelemetry-django.html>`_
+- `OpenTelemetry Flask <https://uptrace.dev/get/instrument/instrument/opentelemetry-flask.html>`_
+- `OpenTelemetry FastAPI <https://uptrace.dev/get/instrument/opentelemetry-fastapi.html>`_
+- `OpenTelemetry SQLAlchemy <https://uptrace.dev/get/instrument/opentelemetry-sqlalchemy.html>`_

From cecf78b356cfe3562898187b75b8c9d2537ff6da Mon Sep 17 00:00:00 2001
From: Seongchuel Ahn <aciddust20@gmail.com>
Date: Fri, 23 Jun 2023 22:52:43 +0900
Subject: [PATCH 0739/1164] Add waitaof (#2760)

* Add waitaof

* Update test_commands.py

add test_waitaof

* Update test_commands.py

Add test_waitaof

* Fix doc string

---------

Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: Igor Malinovskiy <u.glide@gmail.com>
---
 redis/cluster.py                    |  1 +
 redis/commands/core.py              | 15 +++++++++++++++
 tests/test_asyncio/test_commands.py | 14 ++++++++++++++
 tests/test_commands.py              | 14 ++++++++++++++
 4 files changed, 44 insertions(+)

diff --git a/redis/cluster.py b/redis/cluster.py
index 2ab173ded9..be8e4623a7 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -237,6 +237,7 @@ class AbstractRedisCluster:
                 "SLOWLOG LEN",
                 "SLOWLOG RESET",
                 "WAIT",
+                "WAITAOF",
                 "SAVE",
                 "MEMORY PURGE",
                 "MEMORY MALLOC-STATS",
diff --git a/redis/commands/core.py b/redis/commands/core.py
index af5384e9ef..392ddb542c 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1341,6 +1341,21 @@ def wait(self, num_replicas: int, timeout: int, **kwargs) -> ResponseT:
         """
         return self.execute_command("WAIT", num_replicas, timeout, **kwargs)
 
+    def waitaof(
+        self, num_local: int, num_replicas: int, timeout: int, **kwargs
+    ) -> ResponseT:
+        """
+        This command blocks the current client until all previous write
+        commands by that client are acknowledged as having been fsynced
+        to the AOF of the local Redis and/or at least the specified number
+        of replicas.
+
+        For more information see https://redis.io/commands/waitaof
+        """
+        return self.execute_command(
+            "WAITAOF", num_local, num_replicas, timeout, **kwargs
+        )
+
     def hello(self):
         """
         This function throws a NotImplementedError since it is intentionally
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 89a8525887..c0259680c0 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -461,6 +461,20 @@ async def test_client_no_touch(self, r: redis.Redis):
         with pytest.raises(TypeError):
             await r.client_no_touch()
 
+    @skip_if_server_version_lt("7.2.0")
+    @pytest.mark.onlycluster
+    async def test_waitaof(self, r):
+        # must return a list of 2 elements
+        assert len(await r.waitaof(0, 0, 0)) == 2
+        assert len(await r.waitaof(1, 0, 0)) == 2
+        assert len(await r.waitaof(1, 0, 1000)) == 2
+
+        # value is out of range, value must between 0 and 1
+        with pytest.raises(exceptions.ResponseError):
+            await r.waitaof(2, 0, 0)
+        with pytest.raises(exceptions.ResponseError):
+            await r.waitaof(-1, 0, 0)
+
     async def test_config_get(self, r: redis.Redis):
         data = await r.config_get()
         assert "maxmemory" in data
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 4e2ac5b041..2213e81f72 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -704,6 +704,20 @@ def test_client_no_touch(self, r):
         with pytest.raises(TypeError):
             r.client_no_touch()
 
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("7.2.0")
+    def test_waitaof(self, r):
+        # must return a list of 2 elements
+        assert len(r.waitaof(0, 0, 0)) == 2
+        assert len(r.waitaof(1, 0, 0)) == 2
+        assert len(r.waitaof(1, 0, 1000)) == 2
+
+        # value is out of range, value must between 0 and 1
+        with pytest.raises(exceptions.ResponseError):
+            r.waitaof(2, 0, 0)
+        with pytest.raises(exceptions.ResponseError):
+            r.waitaof(-1, 0, 0)
+
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("3.2.0")
     def test_client_reply(self, r, r_timeout):

From 40a769ec377c0698c94acdedff21d969142499ae Mon Sep 17 00:00:00 2001
From: woutdenolf <woutdenolf@users.sf.net>
Date: Fri, 23 Jun 2023 15:52:52 +0200
Subject: [PATCH 0740/1164] Extract abstract async connection class (#2734)

* make 'socket_timeout' and 'socket_connect_timeout' equivalent for TCP and UDS connections

* abstract asynio connection in analogy with the synchronous connection

---------

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/asyncio/connection.py | 300 +++++++++++++++++-------------------
 redis/connection.py         |  16 +-
 2 files changed, 148 insertions(+), 168 deletions(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index efe3a3e1b0..1bc3aa38a6 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -8,6 +8,7 @@
 import sys
 import threading
 import weakref
+from abc import abstractmethod
 from itertools import chain
 from types import MappingProxyType
 from typing import (
@@ -198,7 +199,7 @@ def parse_error(cls, response: str) -> ResponseError:
     def on_disconnect(self):
         raise NotImplementedError()
 
-    def on_connect(self, connection: "Connection"):
+    def on_connect(self, connection: "AbstractConnection"):
         raise NotImplementedError()
 
     async def can_read_destructive(self) -> bool:
@@ -226,7 +227,7 @@ def _clear(self):
         self._buffer = b""
         self._chunks.clear()
 
-    def on_connect(self, connection: "Connection"):
+    def on_connect(self, connection: "AbstractConnection"):
         """Called when the stream connects"""
         self._stream = connection._reader
         if self._stream is None:
@@ -360,7 +361,7 @@ def __init__(self, socket_read_size: int):
         super().__init__(socket_read_size=socket_read_size)
         self._reader: Optional[hiredis.Reader] = None
 
-    def on_connect(self, connection: "Connection"):
+    def on_connect(self, connection: "AbstractConnection"):
         self._stream = connection._reader
         kwargs: _HiredisReaderArgs = {
             "protocolError": InvalidResponse,
@@ -432,25 +433,23 @@ async def read_response(
 
 
 class ConnectCallbackProtocol(Protocol):
-    def __call__(self, connection: "Connection"):
+    def __call__(self, connection: "AbstractConnection"):
         ...
 
 
 class AsyncConnectCallbackProtocol(Protocol):
-    async def __call__(self, connection: "Connection"):
+    async def __call__(self, connection: "AbstractConnection"):
         ...
 
 
 ConnectCallbackT = Union[ConnectCallbackProtocol, AsyncConnectCallbackProtocol]
 
 
-class Connection:
-    """Manages TCP communication to and from a Redis server"""
+class AbstractConnection:
+    """Manages communication to and from a Redis server"""
 
     __slots__ = (
         "pid",
-        "host",
-        "port",
         "db",
         "username",
         "client_name",
@@ -458,9 +457,6 @@ class Connection:
         "password",
         "socket_timeout",
         "socket_connect_timeout",
-        "socket_keepalive",
-        "socket_keepalive_options",
-        "socket_type",
         "redis_connect_func",
         "retry_on_timeout",
         "retry_on_error",
@@ -482,15 +478,10 @@ class Connection:
     def __init__(
         self,
         *,
-        host: str = "localhost",
-        port: Union[str, int] = 6379,
         db: Union[str, int] = 0,
         password: Optional[str] = None,
         socket_timeout: Optional[float] = None,
         socket_connect_timeout: Optional[float] = None,
-        socket_keepalive: bool = False,
-        socket_keepalive_options: Optional[Mapping[int, Union[int, bytes]]] = None,
-        socket_type: int = 0,
         retry_on_timeout: bool = False,
         retry_on_error: Union[list, _Sentinel] = SENTINEL,
         encoding: str = "utf-8",
@@ -514,18 +505,15 @@ def __init__(
                 "2. 'credential_provider'"
             )
         self.pid = os.getpid()
-        self.host = host
-        self.port = int(port)
         self.db = db
         self.client_name = client_name
         self.credential_provider = credential_provider
         self.password = password
         self.username = username
         self.socket_timeout = socket_timeout
-        self.socket_connect_timeout = socket_connect_timeout or socket_timeout or None
-        self.socket_keepalive = socket_keepalive
-        self.socket_keepalive_options = socket_keepalive_options or {}
-        self.socket_type = socket_type
+        if socket_connect_timeout is None:
+            socket_connect_timeout = socket_timeout
+        self.socket_connect_timeout = socket_connect_timeout
         self.retry_on_timeout = retry_on_timeout
         if retry_on_error is SENTINEL:
             retry_on_error = []
@@ -546,7 +534,6 @@ def __init__(
             self.retry = Retry(NoBackoff(), 0)
         self.health_check_interval = health_check_interval
         self.next_health_check: float = -1
-        self.ssl_context: Optional[RedisSSLContext] = None
         self.encoder = encoder_class(encoding, encoding_errors, decode_responses)
         self.redis_connect_func = redis_connect_func
         self._reader: Optional[asyncio.StreamReader] = None
@@ -560,11 +547,9 @@ def __repr__(self):
         repr_args = ",".join((f"{k}={v}" for k, v in self.repr_pieces()))
         return f"{self.__class__.__name__}<{repr_args}>"
 
+    @abstractmethod
     def repr_pieces(self):
-        pieces = [("host", self.host), ("port", self.port), ("db", self.db)]
-        if self.client_name:
-            pieces.append(("client_name", self.client_name))
-        return pieces
+        pass
 
     @property
     def is_connected(self):
@@ -623,51 +608,17 @@ async def connect(self):
             if task and inspect.isawaitable(task):
                 await task
 
+    @abstractmethod
     async def _connect(self):
-        """Create a TCP socket connection"""
-        async with async_timeout(self.socket_connect_timeout):
-            reader, writer = await asyncio.open_connection(
-                host=self.host,
-                port=self.port,
-                ssl=self.ssl_context.get() if self.ssl_context else None,
-            )
-        self._reader = reader
-        self._writer = writer
-        sock = writer.transport.get_extra_info("socket")
-        if sock:
-            sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)
-            try:
-                # TCP_KEEPALIVE
-                if self.socket_keepalive:
-                    sock.setsockopt(socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1)
-                    for k, v in self.socket_keepalive_options.items():
-                        sock.setsockopt(socket.SOL_TCP, k, v)
+        pass
 
-            except (OSError, TypeError):
-                # `socket_keepalive_options` might contain invalid options
-                # causing an error. Do not leave the connection open.
-                writer.close()
-                raise
+    @abstractmethod
+    def _host_error(self) -> str:
+        pass
 
-    def _error_message(self, exception):
-        # args for socket.error can either be (errno, "message")
-        # or just "message"
-        if not exception.args:
-            # asyncio has a bug where on Connection reset by peer, the
-            # exception is not instanciated, so args is empty. This is the
-            # workaround.
-            # See: https://github.com/redis/redis-py/issues/2237
-            # See: https://github.com/python/cpython/issues/94061
-            return (
-                f"Error connecting to {self.host}:{self.port}. Connection reset by peer"
-            )
-        elif len(exception.args) == 1:
-            return f"Error connecting to {self.host}:{self.port}. {exception.args[0]}."
-        else:
-            return (
-                f"Error {exception.args[0]} connecting to {self.host}:{self.port}. "
-                f"{exception.args[0]}."
-            )
+    @abstractmethod
+    def _error_message(self, exception: BaseException) -> str:
+        pass
 
     async def on_connect(self) -> None:
         """Initialize the connection, authenticate and select a database"""
@@ -808,9 +759,8 @@ async def can_read_destructive(self):
             return await self._parser.can_read_destructive()
         except OSError as e:
             await self.disconnect(nowait=True)
-            raise ConnectionError(
-                f"Error while reading from {self.host}:{self.port}: {e.args}"
-            )
+            host_error = self._host_error()
+            raise ConnectionError(f"Error while reading from {host_error}: {e.args}")
 
     async def read_response(
         self,
@@ -821,6 +771,7 @@ async def read_response(
     ):
         """Read the response from a previously sent command"""
         read_timeout = timeout if timeout is not None else self.socket_timeout
+        host_error = self._host_error()
         try:
             if read_timeout is not None:
                 async with async_timeout(read_timeout):
@@ -838,13 +789,11 @@ async def read_response(
             # it was a self.socket_timeout error.
             if disconnect_on_error:
                 await self.disconnect(nowait=True)
-            raise TimeoutError(f"Timeout reading from {self.host}:{self.port}")
+            raise TimeoutError(f"Timeout reading from {host_error}")
         except OSError as e:
             if disconnect_on_error:
                 await self.disconnect(nowait=True)
-            raise ConnectionError(
-                f"Error while reading from {self.host}:{self.port} : {e.args}"
-            )
+            raise ConnectionError(f"Error while reading from {host_error} : {e.args}")
         except BaseException:
             # Also by default close in case of BaseException.  A lot of code
             # relies on this behaviour when doing Command/Response pairs.
@@ -938,7 +887,90 @@ def pack_commands(self, commands: Iterable[Iterable[EncodableT]]) -> List[bytes]
         return output
 
 
+class Connection(AbstractConnection):
+    "Manages TCP communication to and from a Redis server"
+
+    def __init__(
+        self,
+        *,
+        host: str = "localhost",
+        port: Union[str, int] = 6379,
+        socket_keepalive: bool = False,
+        socket_keepalive_options: Optional[Mapping[int, Union[int, bytes]]] = None,
+        socket_type: int = 0,
+        **kwargs,
+    ):
+        self.host = host
+        self.port = int(port)
+        self.socket_keepalive = socket_keepalive
+        self.socket_keepalive_options = socket_keepalive_options or {}
+        self.socket_type = socket_type
+        super().__init__(**kwargs)
+
+    def repr_pieces(self):
+        pieces = [("host", self.host), ("port", self.port), ("db", self.db)]
+        if self.client_name:
+            pieces.append(("client_name", self.client_name))
+        return pieces
+
+    def _connection_arguments(self) -> Mapping:
+        return {"host": self.host, "port": self.port}
+
+    async def _connect(self):
+        """Create a TCP socket connection"""
+        async with async_timeout(self.socket_connect_timeout):
+            reader, writer = await asyncio.open_connection(
+                **self._connection_arguments()
+            )
+        self._reader = reader
+        self._writer = writer
+        sock = writer.transport.get_extra_info("socket")
+        if sock:
+            sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)
+            try:
+                # TCP_KEEPALIVE
+                if self.socket_keepalive:
+                    sock.setsockopt(socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1)
+                    for k, v in self.socket_keepalive_options.items():
+                        sock.setsockopt(socket.SOL_TCP, k, v)
+
+            except (OSError, TypeError):
+                # `socket_keepalive_options` might contain invalid options
+                # causing an error. Do not leave the connection open.
+                writer.close()
+                raise
+
+    def _host_error(self) -> str:
+        return f"{self.host}:{self.port}"
+
+    def _error_message(self, exception: BaseException) -> str:
+        # args for socket.error can either be (errno, "message")
+        # or just "message"
+
+        host_error = self._host_error()
+
+        if not exception.args:
+            # asyncio has a bug where on Connection reset by peer, the
+            # exception is not instanciated, so args is empty. This is the
+            # workaround.
+            # See: https://github.com/redis/redis-py/issues/2237
+            # See: https://github.com/python/cpython/issues/94061
+            return f"Error connecting to {host_error}. Connection reset by peer"
+        elif len(exception.args) == 1:
+            return f"Error connecting to {host_error}. {exception.args[0]}."
+        else:
+            return (
+                f"Error {exception.args[0]} connecting to {host_error}. "
+                f"{exception.args[0]}."
+            )
+
+
 class SSLConnection(Connection):
+    """Manages SSL connections to and from the Redis server(s).
+    This class extends the Connection class, adding SSL functionality, and making
+    use of ssl.SSLContext (https://docs.python.org/3/library/ssl.html#ssl.SSLContext)
+    """
+
     def __init__(
         self,
         ssl_keyfile: Optional[str] = None,
@@ -949,7 +981,6 @@ def __init__(
         ssl_check_hostname: bool = False,
         **kwargs,
     ):
-        super().__init__(**kwargs)
         self.ssl_context: RedisSSLContext = RedisSSLContext(
             keyfile=ssl_keyfile,
             certfile=ssl_certfile,
@@ -958,6 +989,12 @@ def __init__(
             ca_data=ssl_ca_data,
             check_hostname=ssl_check_hostname,
         )
+        super().__init__(**kwargs)
+
+    def _connection_arguments(self) -> Mapping:
+        kwargs = super()._connection_arguments()
+        kwargs["ssl"] = self.ssl_context.get()
+        return kwargs
 
     @property
     def keyfile(self):
@@ -1037,77 +1074,12 @@ def get(self) -> ssl.SSLContext:
         return self.context
 
 
-class UnixDomainSocketConnection(Connection):  # lgtm [py/missing-call-to-init]
-    def __init__(
-        self,
-        *,
-        path: str = "",
-        db: Union[str, int] = 0,
-        username: Optional[str] = None,
-        password: Optional[str] = None,
-        socket_timeout: Optional[float] = None,
-        socket_connect_timeout: Optional[float] = None,
-        encoding: str = "utf-8",
-        encoding_errors: str = "strict",
-        decode_responses: bool = False,
-        retry_on_timeout: bool = False,
-        retry_on_error: Union[list, _Sentinel] = SENTINEL,
-        parser_class: Type[BaseParser] = DefaultParser,
-        socket_read_size: int = 65536,
-        health_check_interval: float = 0.0,
-        client_name: str = None,
-        retry: Optional[Retry] = None,
-        redis_connect_func=None,
-        credential_provider: Optional[CredentialProvider] = None,
-    ):
-        """
-        Initialize a new UnixDomainSocketConnection.
-        To specify a retry policy, first set `retry_on_timeout` to `True`
-        then set `retry` to a valid `Retry` object
-        """
-        if (username or password) and credential_provider is not None:
-            raise DataError(
-                "'username' and 'password' cannot be passed along with 'credential_"
-                "provider'. Please provide only one of the following arguments: \n"
-                "1. 'password' and (optional) 'username'\n"
-                "2. 'credential_provider'"
-            )
-        self.pid = os.getpid()
+class UnixDomainSocketConnection(AbstractConnection):
+    "Manages UDS communication to and from a Redis server"
+
+    def __init__(self, *, path: str = "", **kwargs):
         self.path = path
-        self.db = db
-        self.client_name = client_name
-        self.credential_provider = credential_provider
-        self.password = password
-        self.username = username
-        self.socket_timeout = socket_timeout
-        self.socket_connect_timeout = socket_connect_timeout or socket_timeout or None
-        self.retry_on_timeout = retry_on_timeout
-        if retry_on_error is SENTINEL:
-            retry_on_error = []
-        if retry_on_timeout:
-            retry_on_error.append(TimeoutError)
-        self.retry_on_error = retry_on_error
-        if retry_on_error:
-            if retry is None:
-                self.retry = Retry(NoBackoff(), 1)
-            else:
-                # deep-copy the Retry object as it is mutable
-                self.retry = copy.deepcopy(retry)
-            # Update the retry's supported errors with the specified errors
-            self.retry.update_supported_errors(retry_on_error)
-        else:
-            self.retry = Retry(NoBackoff(), 0)
-        self.health_check_interval = health_check_interval
-        self.next_health_check = -1
-        self.redis_connect_func = redis_connect_func
-        self.encoder = Encoder(encoding, encoding_errors, decode_responses)
-        self._sock = None
-        self._reader = None
-        self._writer = None
-        self._socket_read_size = socket_read_size
-        self.set_parser(parser_class)
-        self._connect_callbacks = []
-        self._buffer_cutoff = 6000
+        super().__init__(**kwargs)
 
     def repr_pieces(self) -> Iterable[Tuple[str, Union[str, int]]]:
         pieces = [("path", self.path), ("db", self.db)]
@@ -1122,15 +1094,21 @@ async def _connect(self):
         self._writer = writer
         await self.on_connect()
 
-    def _error_message(self, exception):
+    def _host_error(self) -> str:
+        return self.host
+
+    def _error_message(self, exception: BaseException) -> str:
         # args for socket.error can either be (errno, "message")
         # or just "message"
+        host_error = self._host_error()
         if len(exception.args) == 1:
-            return f"Error connecting to unix socket: {self.path}. {exception.args[0]}."
+            return (
+                f"Error connecting to unix socket: {host_error}. {exception.args[0]}."
+            )
         else:
             return (
                 f"Error {exception.args[0]} connecting to unix socket: "
-                f"{self.path}. {exception.args[1]}."
+                f"{host_error}. {exception.args[1]}."
             )
 
 
@@ -1162,7 +1140,7 @@ def to_bool(value) -> Optional[bool]:
 class ConnectKwargs(TypedDict, total=False):
     username: str
     password: str
-    connection_class: Type[Connection]
+    connection_class: Type[AbstractConnection]
     host: str
     port: int
     db: int
@@ -1284,7 +1262,7 @@ class initializer. In the case of conflicting arguments, querystring
 
     def __init__(
         self,
-        connection_class: Type[Connection] = Connection,
+        connection_class: Type[AbstractConnection] = Connection,
         max_connections: Optional[int] = None,
         **connection_kwargs,
     ):
@@ -1307,8 +1285,8 @@ def __init__(
         self._fork_lock = threading.Lock()
         self._lock = asyncio.Lock()
         self._created_connections: int
-        self._available_connections: List[Connection]
-        self._in_use_connections: Set[Connection]
+        self._available_connections: List[AbstractConnection]
+        self._in_use_connections: Set[AbstractConnection]
         self.reset()  # lgtm [py/init-calls-subclass]
         self.encoder_class = self.connection_kwargs.get("encoder_class", Encoder)
 
@@ -1431,7 +1409,7 @@ def make_connection(self):
         self._created_connections += 1
         return self.connection_class(**self.connection_kwargs)
 
-    async def release(self, connection: Connection):
+    async def release(self, connection: AbstractConnection):
         """Releases the connection back to the pool"""
         self._checkpid()
         async with self._lock:
@@ -1452,7 +1430,7 @@ async def release(self, connection: Connection):
                 await connection.disconnect()
                 return
 
-    def owns_connection(self, connection: Connection):
+    def owns_connection(self, connection: AbstractConnection):
         return connection.pid == self.pid
 
     async def disconnect(self, inuse_connections: bool = True):
@@ -1466,7 +1444,7 @@ async def disconnect(self, inuse_connections: bool = True):
         self._checkpid()
         async with self._lock:
             if inuse_connections:
-                connections: Iterable[Connection] = chain(
+                connections: Iterable[AbstractConnection] = chain(
                     self._available_connections, self._in_use_connections
                 )
             else:
@@ -1524,14 +1502,14 @@ def __init__(
         self,
         max_connections: int = 50,
         timeout: Optional[int] = 20,
-        connection_class: Type[Connection] = Connection,
+        connection_class: Type[AbstractConnection] = Connection,
         queue_class: Type[asyncio.Queue] = asyncio.LifoQueue,
         **connection_kwargs,
     ):
 
         self.queue_class = queue_class
         self.timeout = timeout
-        self._connections: List[Connection]
+        self._connections: List[AbstractConnection]
         super().__init__(
             connection_class=connection_class,
             max_connections=max_connections,
@@ -1621,7 +1599,7 @@ async def get_connection(self, command_name, *keys, **options):
 
         return connection
 
-    async def release(self, connection: Connection):
+    async def release(self, connection: AbstractConnection):
         """Releases the connection back to the pool."""
         # Make sure we haven't changed process.
         self._checkpid()
diff --git a/redis/connection.py b/redis/connection.py
index bf0d6dea80..bec456c9ce 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -594,6 +594,8 @@ def __init__(
         self,
         db=0,
         password=None,
+        socket_timeout=None,
+        socket_connect_timeout=None,
         retry_on_timeout=False,
         retry_on_error=SENTINEL,
         encoding="utf-8",
@@ -629,6 +631,10 @@ def __init__(
         self.credential_provider = credential_provider
         self.password = password
         self.username = username
+        self.socket_timeout = socket_timeout
+        if socket_connect_timeout is None:
+            socket_connect_timeout = socket_timeout
+        self.socket_connect_timeout = socket_connect_timeout
         self.retry_on_timeout = retry_on_timeout
         if retry_on_error is SENTINEL:
             retry_on_error = []
@@ -941,8 +947,6 @@ def __init__(
         self,
         host="localhost",
         port=6379,
-        socket_timeout=None,
-        socket_connect_timeout=None,
         socket_keepalive=False,
         socket_keepalive_options=None,
         socket_type=0,
@@ -950,8 +954,6 @@ def __init__(
     ):
         self.host = host
         self.port = int(port)
-        self.socket_timeout = socket_timeout
-        self.socket_connect_timeout = socket_connect_timeout or socket_timeout
         self.socket_keepalive = socket_keepalive
         self.socket_keepalive_options = socket_keepalive_options or {}
         self.socket_type = socket_type
@@ -1172,9 +1174,8 @@ def _connect(self):
 class UnixDomainSocketConnection(AbstractConnection):
     "Manages UDS communication to and from a Redis server"
 
-    def __init__(self, path="", socket_timeout=None, **kwargs):
+    def __init__(self, path="", **kwargs):
         self.path = path
-        self.socket_timeout = socket_timeout
         super().__init__(**kwargs)
 
     def repr_pieces(self):
@@ -1186,8 +1187,9 @@ def repr_pieces(self):
     def _connect(self):
         "Create a Unix domain socket connection"
         sock = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
-        sock.settimeout(self.socket_timeout)
+        sock.settimeout(self.socket_connect_timeout)
         sock.connect(self.path)
+        sock.settimeout(self.socket_timeout)
         return sock
 
     def _host_error(self):

From d25a96b3f688e54cee8f76ba96ad0ae776342696 Mon Sep 17 00:00:00 2001
From: Kevin James <KevinJames@thekev.in>
Date: Fri, 23 Jun 2023 15:58:43 +0100
Subject: [PATCH 0741/1164] Fix type hint for retry_on_error in async cluster
 (#2804)

* fix(asyncio.cluster): fixup retry_on_error type hint

This parameter accepts a list of _classes of Exceptions_, not a list of instantiated Exceptions. Fixup the type hint accordingly.

* chore: update changelog

---------

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 CHANGES                  | 1 +
 redis/asyncio/cluster.py | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/CHANGES b/CHANGES
index 040e445228..49f87cd35d 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Fix incorrect redis.asyncio.Cluster type hint for `retry_on_error`
     * Fix dead weakref in sentinel connection causing ReferenceError (#2767)
     * Fix #2768, Fix KeyError: 'first-entry' in parse_xinfo_stream.
     * Fix #2749, remove unnecessary __del__ logic to close connections.
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 929d3e47c7..989c6ccda8 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -249,7 +249,7 @@ def __init__(
         socket_keepalive_options: Optional[Mapping[int, Union[int, bytes]]] = None,
         socket_timeout: Optional[float] = None,
         retry: Optional["Retry"] = None,
-        retry_on_error: Optional[List[Exception]] = None,
+        retry_on_error: Optional[List[Type[Exception]]] = None,
         # SSL related kwargs
         ssl: bool = False,
         ssl_ca_certs: Optional[str] = None,

From 04aadd7a0e05ca65c8bc9ba3e51014d12dc622be Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 25 Jun 2023 11:24:18 +0300
Subject: [PATCH 0742/1164] Fix CI (#2809)

---
 redis/asyncio/connection.py      | 2 +-
 tests/test_asyncio/test_graph.py | 1 +
 tests/test_graph.py              | 1 +
 3 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 1bc3aa38a6..d6195e1801 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -1095,7 +1095,7 @@ async def _connect(self):
         await self.on_connect()
 
     def _host_error(self) -> str:
-        return self.host
+        return self.path
 
     def _error_message(self, exception: BaseException) -> str:
         # args for socket.error can either be (errno, "message")
diff --git a/tests/test_asyncio/test_graph.py b/tests/test_asyncio/test_graph.py
index 7e70baae89..e7a772fc0f 100644
--- a/tests/test_asyncio/test_graph.py
+++ b/tests/test_asyncio/test_graph.py
@@ -274,6 +274,7 @@ async def test_slowlog(modclient: redis.Redis):
 
 
 @pytest.mark.redismod
+@pytest.mark.xfail(strict=False)
 async def test_query_timeout(modclient: redis.Redis):
     # Build a sample graph with 1000 nodes.
     await modclient.graph().query("UNWIND range(0,1000) as val CREATE ({v: val})")
diff --git a/tests/test_graph.py b/tests/test_graph.py
index 4721b2f4e2..37e5ca43aa 100644
--- a/tests/test_graph.py
+++ b/tests/test_graph.py
@@ -292,6 +292,7 @@ def test_slowlog(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.xfail(strict=False)
 def test_query_timeout(client):
     # Build a sample graph with 1000 nodes.
     client.graph().query("UNWIND range(0,1000) as val CREATE ({v: val})")

From ab617a1844d758ccd4a17a083a2f711eef4084ee Mon Sep 17 00:00:00 2001
From: shacharPash <93581407+shacharPash@users.noreply.github.com>
Date: Sun, 25 Jun 2023 14:25:24 +0300
Subject: [PATCH 0743/1164] Support JSON.MSET Command (#2766)

* support JSON.MERGE Command

* linters

* try with abc instead person

* change @skip_ifmodversion_lt to latest ReJSON 2.4.7

* change version

* fix test

* linters

* add async test

* Support JSON.MSET command

* trying to run CI

* linters

* add async test

* reminder do delete the integration changes

* delete the line from integration

* fix the interface

* change docstring

---------

Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: dvora-h <dvora.heller@redis.com>
---
 redis/commands/json/__init__.py |  1 +
 redis/commands/json/commands.py | 19 ++++++++++++++++++-
 tests/test_asyncio/test_json.py | 11 +++++++++++
 tests/test_json.py              |  9 +++++++++
 4 files changed, 39 insertions(+), 1 deletion(-)

diff --git a/redis/commands/json/__init__.py b/redis/commands/json/__init__.py
index 77fb21c39f..4f2a0c5ffc 100644
--- a/redis/commands/json/__init__.py
+++ b/redis/commands/json/__init__.py
@@ -38,6 +38,7 @@ def __init__(
             "JSON.GET": self._decode,
             "JSON.MGET": bulk_of_jsons(self._decode),
             "JSON.SET": lambda r: r and nativestr(r) == "OK",
+            "JSON.MSET": lambda r: r and nativestr(r) == "OK",
             "JSON.MERGE": lambda r: r and nativestr(r) == "OK",
             "JSON.NUMINCRBY": self._decode,
             "JSON.NUMMULTBY": self._decode,
diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index f91ef9185c..3abe155796 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -1,6 +1,6 @@
 import os
 from json import JSONDecodeError, loads
-from typing import Dict, List, Optional, Union
+from typing import Dict, List, Optional, Tuple, Union
 
 from redis.exceptions import DataError
 from redis.utils import deprecated_function
@@ -253,6 +253,23 @@ def set(
             pieces.append("XX")
         return self.execute_command("JSON.SET", *pieces)
 
+    def mset(self, triplets: List[Tuple[str, str, JsonType]]) -> Optional[str]:
+        """
+        Set the JSON value at key ``name`` under the ``path`` to ``obj``
+        for one or more keys.
+
+        ``triplets`` is a list of one or more triplets of key, path, value.
+
+        For the purpose of using this within a pipeline, this command is also
+        aliased to JSON.MSET.
+
+        For more information see `JSON.MSET <https://redis.io/commands/json.mset>`_.
+        """
+        pieces = []
+        for triplet in triplets:
+            pieces.extend([triplet[0], str(triplet[1]), self._encode(triplet[2])])
+        return self.execute_command("JSON.MSET", *pieces)
+
     def merge(
         self,
         name: str,
diff --git a/tests/test_asyncio/test_json.py b/tests/test_asyncio/test_json.py
index 7334399df4..12bdacdb9a 100644
--- a/tests/test_asyncio/test_json.py
+++ b/tests/test_asyncio/test_json.py
@@ -109,6 +109,17 @@ async def test_mgetshouldsucceed(modclient: redis.Redis):
     assert await modclient.json().mget([1, 2], Path.root_path()) == [1, 2]
 
 
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.6.0", "ReJSON")  # todo: update after the release
+async def test_mset(modclient: redis.Redis):
+    await modclient.json().mset(
+        [("1", Path.root_path(), 1), ("2", Path.root_path(), 2)]
+    )
+
+    assert await modclient.json().mget(["1"], Path.root_path()) == [1]
+    assert await modclient.json().mget(["1", "2"], Path.root_path()) == [1, 2]
+
+
 @pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
 async def test_clear(modclient: redis.Redis):
diff --git a/tests/test_json.py b/tests/test_json.py
index 0a85998205..c41ad5e2e1 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -115,6 +115,15 @@ def test_mgetshouldsucceed(client):
     assert client.json().mget([1, 2], Path.root_path()) == [1, 2]
 
 
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.6.0", "ReJSON")  # todo: update after the release
+def test_mset(client):
+    client.json().mset([("1", Path.root_path(), 1), ("2", Path.root_path(), 2)])
+
+    assert client.json().mget(["1"], Path.root_path()) == [1]
+    assert client.json().mget(["1", "2"], Path.root_path()) == [1, 2]
+
+
 @pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
 def test_clear(client):

From 9f503578d1ffed20d63e8023bcd8a7dccd15ecc5 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 25 Jun 2023 15:52:42 +0300
Subject: [PATCH 0744/1164] Version 4.6.0 (#2810)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index a6e9422b12..65122b647b 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.5.5",
+    version="4.6.0",
     packages=find_packages(
         include=[
             "redis",

From 2732a8553e58d9e77f16566b9132fc7205614a53 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 16 Jul 2023 15:13:06 +0300
Subject: [PATCH 0745/1164] Merge 5.0 to master (#2849)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Reorganizing the parsers code, and add support for RESP3 (#2574)

* Reorganizing the parsers code

* fix build package

* fix imports

* fix flake8

* add resp to Connection class

* core commands

* python resp3 parser

* pipeline

* async resp3 parser

* some asymc tests

* resp3 parser for async cluster

* async commands tests

* linters

* linters

* linters

* fix ModuleNotFoundError

* fix tests

* fix assert_resp_response_in

* fix command_getkeys in cluster

* fail-fast false

* version

---------

Co-authored-by: Chayim I. Kirshen <c@kirshen.com>

* Fix async client with resp3 (#2657)

* Add support for PubSub with RESP3 parser (#2721)

* add resp3 pubsub

* linters

* _set_info_logger func

* async pubsun

* docstring

* 5.0.0b2 (#2723)

* Fix `COMMAND` response in resp3 (redis 7+) (#2740)

* Fix protocol version checking (#2737)

* bumping beta version to 5.0.0b3 (#2743)

* Fix parse resp3 dict response: don't use dict comprehension (#2757)

* Fix parse respp3 dict response

* linters

* pin urlib version

* Sharded pubsub (#2762)

* sharded pubsub

* sharded pubsub

Co-authored-by: Leibale Eidelman <me@leibale.com>

* Shrded Pubsub TestPubSubSubscribeUnsubscribe

* fix TestPubSubSubscribeUnsubscribe

* more tests

* linters

* TestPubSubSubcommands

* fix @leibale comments

* linters

* fix @chayim comments

---------

Co-authored-by: Leibale Eidelman <me@leibale.com>

* 5.0.0b4 (#2781)

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* RESP3 tests (#2780)

* fix command response in resp3

* linters

* acl_log & acl_getuser

* client_info

* test_commands and test_asyncio/test_commands

* fix test_command_parser

* fix asyncio/test_connection/test_invalid_response

* linters

* all the tests

* push handler sharded pubsub

* Use assert_resp_response wherever possible

* fix test_xreadgroup

* fix cluster_zdiffstore and cluster_zinter

* fix review comments

* fix review comments

* linters

* Fixing asyncio import (#2759)

* asyncio import fix

* pinning urllib3 to fix CI (#2748)

* noqa

* fixint linters

* fix (#2799)

* RESP3 response callbacks (#2798)

* start cleaning

* clean sone callbacks

* response callbacks

* revert redismod-url change

* fix async tests

* linters

* async cluster

---------

Co-authored-by: Chayim <chayim@users.noreply.github.com>

* RESP3 modules support (#2803)

* start cleaning

* clean sone callbacks

* response callbacks

* modules

* tests

* finish sync search tests

* linters

* async modules

* linters

* revert redismod-url change

* RESP3 fix async tests (#2806)

* fix tests

* add stralgo callback in resp2

* add callback to acl list in resp2

* Adding RESP3 tests support (#2793)

* start cleaning

* clean sone callbacks

* first phase

* tox wrap back

* changing cancel format

* syntax

* lint

* docker

* contain the docker

* tox dev reqs

* back to testing

* response callbacks

* protocol into async conftest

* fix for 3.11 invoke

* docker changes

* fix tests

* linters

* adding

* resp3 tox, until killed

* remove tox

* tests

* requirements.txt

* restoring requirements.txt

* adding a sleep, hopefully enough time for the cluster dockers to settle

* fix search tests

* search test, disable uvloop for pypy due to bug

* syn

* reg

* dialect test improvement

* sleep+, xfail

* tests

* resp

* flaky search test too

* timing

* timing for async test

* test changes

* fix assert_interval_advanced

* revert

* mark async health_check tests with xfail

* change strict to false

* fix github actions package validation

---------

Co-authored-by: dvora-h <dvora.heller@redis.com>

* change sismember return type (#2813)

* Version 5.0.0rc1 (#2815)

* Merge master to 5.0 (#2827)

* fix: do not use asyncio's timeout lib before 3.11.2 (#2659)

There's an issue in asyncio's timeout lib before 3.11.3 that causes
async calls to raise `CancelledError`.

This is a cpython issue that was fixed in this commit [1] and
cherry-picked to previous versions, meaning 3.11.3 will work correctly.

Check [2] for more info.

[1] https://github.com/python/cpython/commit/04adf2df395ded81922c71360a5d66b597471e49
[2] https://github.com/redis/redis-py/issues/2633

* UnixDomainSocketConnection missing constructor argument (#2630)

* removing useless files (#2642)

* Fix issue 2660: PytestUnraisableExceptionWarning from asycio client (#2669)

* Fixing cancelled async futures (#2666)

Co-authored-by: James R T <jamestiotio@gmail.com>
Co-authored-by: dvora-h <dvora.heller@redis.com>

* Fix async (#2673)

* Version 4.5.4 (#2674)

* Really do not use asyncio's timeout lib before 3.11.2 (#2699)

480253037afe4c12e38a0f98cadd3019a3724254 made async-timeout required
only on Python 3.11.2 and earlier. However, according to PEP-508,
python_version marker is compared to first two numbers of Python version
tuple - so it will evaluate to True also on 3.11.3, and install a
package as a dependency.

* asyncio: Fix memory leak caused by hiredis (#2693) (#2694)

* Update example of Redisearch creating index (#2703)

When creating index, fields should be passed inside an iterable (e.g. list or tuple)

* Improving Vector Similarity Search Example (#2661)

* update vss docs

* add embeddings creation and storage examples

* update based on feedback

* fix version and link

* include more realistic search examples and clean up indices

* completely remove initial cap reference

---------

Co-authored-by: Chayim <chayim@users.noreply.github.com>

* Fix incorrect usage of once flag in async Sentinel (#2718)

In the execute_command of the async Sentinel, the once flag was being
used incorrectly, with its meaning inverted. To fix we just needed to invert
the if and else bodies. This isn't being caught by the tests currently
because the tests of commands that use this flag do not check their
results/effects (for example the "test_ckquorum" test).

* Fix topk list example. (#2724)

* Improve error output for master discovery (#2720)

Make MasterNotFoundError exception more precise in the case of
ConnectionError and TimeoutError to help the user to identify
configuration errors

Co-authored-by: Marc Schöchlin <marc.schoechlin@flipapp.de>

* return response in case of KeyError (#2628)

* return response in case of KeyError

* fix code linters error

* fix linters 2

* fix linters 3

* Add WITHSCORES to ZREVRANK Command (#2725)

* add withscores to zrevrank

* change 0 -> 2

* fix errors

* split test

* Fix `ClusterCommandProtocol` not itself being marked as a protocol (#2729)

* Fix `ClusterCommandProtocol` not itself being marked as a protocol

* Update CHANGES

* Fix potential race condition during disconnection (#2719)

When the disconnect() function is called twice in parallel it is possible that
one thread deletes the self._sock reference, while the other thread will
attempt to call .close() on it, leading to an AttributeError.

This situation can routinely be encountered by closing the connection in a
PubSubWorkerThread error handler in a blocking thread (ie. with
sleep_time==None), and then calling .close() on the PubSub object.
The main thread will then run into the disconnect() function, and the listener
thread is woken up by the closure and will race into the disconnect()
function, too.

This can be fixed easily by copying the object reference before doing the
None-check, similar to what we do in the redis.client.close() function.

* add "address_remap" feature to RedisCluster (#2726)

* add cluster "host_port_remap" feature for asyncio.RedisCluster

* Add a unittest for asyncio.RedisCluster

* Add host_port_remap to _sync_ RedisCluster

* add synchronous tests

* rename arg to `address_remap` and take and return an address tuple.

* Add class documentation

* Add CHANGES

* nermina changes from NRedisStack (#2736)

* Updated AWS Elasticache IAM Connection Example (#2702)

Co-authored-by: Nick Gerow <nick.gerow@enlightedinc.com>

* pinning urllib3 to fix CI (#2748)

* Add RedisCluster.remap_host_port, Update tests for CWE 404 (#2706)

* Use provided redis address. Bind to IPv4

* Add missing "await" and perform the correct test for pipe eimpty

* Wait for a send event, rather than rely on sleep time. Excpect cancel errors.

* set delay to 0 except for operation we want to cancel
This speeds up the unit tests considerably by eliminating unnecessary delay.

* Release resources in test

* Fix cluster test to use address_remap and multiple proxies.

* Use context manager to manage DelayProxy

* Mark failing pipeline tests

* lint

* Use a common "master_host" test fixture

* Update redismodules.rst (#2747)

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* Add support for cluster myshardid (#2704)

* feat: adding support for cluster myshardid

* lint fix

* fix: comment fix and async test

* fix: adding version check

* fix lint:

* linters

---------

Co-authored-by: Anuragkillswitch <70265851+Anuragkillswitch@users.noreply.github.com>
Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
Co-authored-by: dvora-h <dvora.heller@redis.com>

* clean warnings (#2731)

* fix parse_slowlog_get (#2732)

* Optionally disable disconnects in read_response (#2695)

* Add regression tests and fixes for issue #1128

* Fix tests for resumable read_response to use "disconnect_on_error"

* undo prevision fix attempts in async client and cluster

* re-enable cluster test

* Suggestions from code review

* Add CHANGES

* Add client no-touch (#2745)

* Add client no-touch

* Update redis/commands/core.py

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* Update test_commands.py

Improve test_client_no_touch

* Update test_commands.py

Add async version test case

* Chore remove whitespace

Oops

---------

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* fix create single_connection_client from url (#2752)

* Fix `xadd` allow non negative maxlen (#2739)

* Fix xadd allow non negative maxlen

* Update change log

---------

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* Version 4.5.5 (#2753)

* Kristjan/issue #2754: Add missing argument to SentinelManagedConnection.read_response() (#2756)

* Increase timeout for a test which would hang completely if failing.
Timeouts in virtualized CI backends can occasionally fail if too short.

* add "disconnect_on_error" argument to SentinelManagedConnection

* update Changes

* lint

* support JSON.MERGE Command (#2761)

* support JSON.MERGE Command

* linters

* try with abc instead person

* change @skip_ifmodversion_lt to latest ReJSON 2.4.7

* change version

* fix test

* linters

* add async test

* Issue #2749: Remove unnecessary __del__ handlers (#2755)

* Remove unnecessary __del__ handlers
There normally should be no logic attached to del.  Cleanly disconnecting network resources is not needed at that time.

* add CHANGES

* Add WITHSCORE to ZRANK (#2758)

* add withscore to zrank with tests

* fix test

* Fix JSON.MERGE Summary (#2786)

* Fix JSON.MERGE Summary

* linters

* Fixed key error in parse_xinfo_stream (#2788)

* insert newline to prevent sphinx from assuming code block (#2796)

* Introduce OutOfMemoryError exception for Redis write command rejections due to OOM errors (#2778)

* expose OutOfMemoryError as explicit exception type

- handle "OOM" error code string by raising explicit
  exception type instance
- enables callers to avoid string matching after
  catching ResponseError

* add OutOfMemoryError exception class docstring

* Provide more info in the exception docstring

* Fix formatting

* Again

* linters

---------

Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: Igor Malinovskiy <u.glide@gmail.com>
Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* Add unit tests for the `connect` method of all Redis connection classes (#2631)

* tests: move certificate discovery to a separate module

* tests: add 'connect' tests for all Redis connection classes

---------

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* Fix dead weakref in sentinel connection causing ReferenceError (#2767) (#2771)

* Fix dead weakref in sentinel conn (#2767)

* Update CHANGES

---------

Co-authored-by: Igor Malinovskiy <u.glide@gmail.com>
Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* chore(documentation): fix redirects and some small cleanups (#2801)

* Add waitaof (#2760)

* Add waitaof

* Update test_commands.py

add test_waitaof

* Update test_commands.py

Add test_waitaof

* Fix doc string

---------

Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: Igor Malinovskiy <u.glide@gmail.com>

* Extract abstract async connection class (#2734)

* make 'socket_timeout' and 'socket_connect_timeout' equivalent for TCP and UDS connections

* abstract asynio connection in analogy with the synchronous connection

---------

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* Fix type hint for retry_on_error in async cluster (#2804)

* fix(asyncio.cluster): fixup retry_on_error type hint

This parameter accepts a list of _classes of Exceptions_, not a list of instantiated Exceptions. Fixup the type hint accordingly.

* chore: update changelog

---------

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* Fix CI (#2809)

* Support JSON.MSET Command (#2766)

* support JSON.MERGE Command

* linters

* try with abc instead person

* change @skip_ifmodversion_lt to latest ReJSON 2.4.7

* change version

* fix test

* linters

* add async test

* Support JSON.MSET command

* trying to run CI

* linters

* add async test

* reminder do delete the integration changes

* delete the line from integration

* fix the interface

* change docstring

---------

Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: dvora-h <dvora.heller@redis.com>

* Version 4.6.0 (#2810)

* master changes

* linters

* fix test_cwe_404 cluster test

---------

Co-authored-by: Thiago Bellini Ribeiro <hackedbellini@gmail.com>
Co-authored-by: woutdenolf <woutdenolf@users.sf.net>
Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: shacharPash <93581407+shacharPash@users.noreply.github.com>
Co-authored-by: James R T <jamestiotio@gmail.com>
Co-authored-by: Mirek Długosz <miniopl+github@gmail.com>
Co-authored-by: Oran Avraham <252748+oranav@users.noreply.github.com>
Co-authored-by: mzdehbashi-github <85902780+mzdehbashi-github@users.noreply.github.com>
Co-authored-by: Tyler Hutcherson <tyler.hutcherson@redis.com>
Co-authored-by: Felipe Machado <462154+felipou@users.noreply.github.com>
Co-authored-by: AYMEN Mohammed <53928879+AYMENJD@users.noreply.github.com>
Co-authored-by: Marc Schöchlin <ms-github@256bit.org>
Co-authored-by: Marc Schöchlin <marc.schoechlin@flipapp.de>
Co-authored-by: Avasam <samuel.06@hotmail.com>
Co-authored-by: Markus Gerstel <2102431+Anthchirp@users.noreply.github.com>
Co-authored-by: Kristján Valur Jónsson <sweskman@gmail.com>
Co-authored-by: Nick Gerow <Nick.G.123@hotmail.com>
Co-authored-by: Nick Gerow <nick.gerow@enlightedinc.com>
Co-authored-by: Cristian Matache <cristianmatache@hotmail.com>
Co-authored-by: Anurag Bandyopadhyay <angbpy@gmail.com>
Co-authored-by: Anuragkillswitch <70265851+Anuragkillswitch@users.noreply.github.com>
Co-authored-by: Seongchuel Ahn <aciddust20@gmail.com>
Co-authored-by: Alibi <aliby.bbb@gmail.com>
Co-authored-by: Smit Parmar <smitraj333@gmail.com>
Co-authored-by: Brad MacPhee <macphee@gmail.com>
Co-authored-by: Igor Malinovskiy <u.glide@gmail.com>
Co-authored-by: Shahar Lev <shahar_lev@hotmail.com>
Co-authored-by: Vladimir Mihailenco <vladimir.webdev@gmail.com>
Co-authored-by: Kevin James <KevinJames@thekev.in>

* RESP3 response-callbacks cleanup (#2841)

* cluenup

* sentinel callbacks

* move callbacks

* fix async cluster tests

* _parsers and import fix in tests

* linters

* make modules callbacks private

* fix async search

* fix

---------

Co-authored-by: Chayim I. Kirshen <c@kirshen.com>

* Version 5.0.0rc2 (#2843)

* linters

---------

Co-authored-by: Chayim I. Kirshen <c@kirshen.com>
Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: Leibale Eidelman <me@leibale.com>
Co-authored-by: Thiago Bellini Ribeiro <hackedbellini@gmail.com>
Co-authored-by: woutdenolf <woutdenolf@users.sf.net>
Co-authored-by: shacharPash <93581407+shacharPash@users.noreply.github.com>
Co-authored-by: James R T <jamestiotio@gmail.com>
Co-authored-by: Mirek Długosz <miniopl+github@gmail.com>
Co-authored-by: Oran Avraham <252748+oranav@users.noreply.github.com>
Co-authored-by: mzdehbashi-github <85902780+mzdehbashi-github@users.noreply.github.com>
Co-authored-by: Tyler Hutcherson <tyler.hutcherson@redis.com>
Co-authored-by: Felipe Machado <462154+felipou@users.noreply.github.com>
Co-authored-by: AYMEN Mohammed <53928879+AYMENJD@users.noreply.github.com>
Co-authored-by: Marc Schöchlin <ms-github@256bit.org>
Co-authored-by: Marc Schöchlin <marc.schoechlin@flipapp.de>
Co-authored-by: Avasam <samuel.06@hotmail.com>
Co-authored-by: Markus Gerstel <2102431+Anthchirp@users.noreply.github.com>
Co-authored-by: Kristján Valur Jónsson <sweskman@gmail.com>
Co-authored-by: Nick Gerow <Nick.G.123@hotmail.com>
Co-authored-by: Nick Gerow <nick.gerow@enlightedinc.com>
Co-authored-by: Cristian Matache <cristianmatache@hotmail.com>
Co-authored-by: Anurag Bandyopadhyay <angbpy@gmail.com>
Co-authored-by: Anuragkillswitch <70265851+Anuragkillswitch@users.noreply.github.com>
Co-authored-by: Seongchuel Ahn <aciddust20@gmail.com>
Co-authored-by: Alibi <aliby.bbb@gmail.com>
Co-authored-by: Smit Parmar <smitraj333@gmail.com>
Co-authored-by: Brad MacPhee <macphee@gmail.com>
Co-authored-by: Igor Malinovskiy <u.glide@gmail.com>
Co-authored-by: Shahar Lev <shahar_lev@hotmail.com>
Co-authored-by: Vladimir Mihailenco <vladimir.webdev@gmail.com>
Co-authored-by: Kevin James <KevinJames@thekev.in>
---
 .flake8                                       |   21 +
 .github/workflows/integration.yaml            |   75 +-
 .isort.cfg                                    |    5 +
 CONTRIBUTING.md                               |    4 +-
 benchmarks/socket_read_size.py                |    4 +-
 dev_requirements.txt                          |    5 +-
 docker-compose.yml                            |  109 ++
 docker/base/Dockerfile                        |    4 -
 docker/base/Dockerfile.cluster                |   11 -
 docker/base/Dockerfile.cluster4               |    9 -
 docker/base/Dockerfile.cluster5               |    9 -
 docker/base/Dockerfile.redis4                 |    4 -
 docker/base/Dockerfile.redis5                 |    4 -
 docker/base/Dockerfile.redismod_cluster       |   12 -
 docker/base/Dockerfile.sentinel               |    4 -
 docker/base/Dockerfile.sentinel4              |    4 -
 docker/base/Dockerfile.sentinel5              |    4 -
 docker/base/Dockerfile.stunnel                |   11 -
 docker/base/Dockerfile.unstable               |   18 -
 docker/base/Dockerfile.unstable_cluster       |   11 -
 docker/base/Dockerfile.unstable_sentinel      |   17 -
 docker/base/README.md                         |    1 -
 docker/base/create_cluster4.sh                |   26 -
 docker/base/create_cluster5.sh                |   26 -
 docker/base/create_redismod_cluster.sh        |   46 -
 docker/cluster/redis.conf                     |    3 -
 docker/redis4/master/redis.conf               |    2 -
 docker/redis4/sentinel/sentinel_1.conf        |    6 -
 docker/redis4/sentinel/sentinel_2.conf        |    6 -
 docker/redis4/sentinel/sentinel_3.conf        |    6 -
 docker/redis5/master/redis.conf               |    2 -
 docker/redis5/replica/redis.conf              |    3 -
 docker/redis5/sentinel/sentinel_1.conf        |    6 -
 docker/redis5/sentinel/sentinel_2.conf        |    6 -
 docker/redis5/sentinel/sentinel_3.conf        |    6 -
 docker/redis6.2/master/redis.conf             |    2 -
 docker/redis6.2/replica/redis.conf            |    3 -
 docker/redis6.2/sentinel/sentinel_2.conf      |    6 -
 docker/redis6.2/sentinel/sentinel_3.conf      |    6 -
 docker/redis7/master/redis.conf               |    4 -
 docker/redismod_cluster/redis.conf            |    8 -
 docker/unstable/redis.conf                    |    3 -
 docker/unstable_cluster/redis.conf            |    4 -
 dockers/Dockerfile.cluster                    |    7 +
 dockers/cluster.redis.conf                    |    6 +
 {docker/base => dockers}/create_cluster.sh    |    7 +-
 .../sentinel_1.conf => dockers/sentinel.conf  |    4 +-
 {docker => dockers}/stunnel/README            |    0
 {docker => dockers}/stunnel/conf/redis.conf   |    2 +-
 {docker => dockers}/stunnel/create_certs.sh   |    0
 {docker => dockers}/stunnel/keys/ca-cert.pem  |    0
 {docker => dockers}/stunnel/keys/ca-key.pem   |    0
 .../stunnel/keys/client-cert.pem              |    0
 .../stunnel/keys/client-key.pem               |    0
 .../stunnel/keys/client-req.pem               |    0
 .../stunnel/keys/server-cert.pem              |    0
 .../stunnel/keys/server-key.pem               |    0
 .../stunnel/keys/server-req.pem               |    0
 docs/examples/opentelemetry/main.py           |    3 +-
 pytest.ini                                    |   13 +
 redis/__init__.py                             |    1 +
 redis/_parsers/__init__.py                    |   20 +
 redis/_parsers/base.py                        |  232 +++
 .../parser.py => _parsers/commands.py}        |  104 +-
 redis/_parsers/encoders.py                    |   44 +
 redis/_parsers/helpers.py                     |  851 +++++++++
 redis/_parsers/hiredis.py                     |  217 +++
 redis/_parsers/resp2.py                       |  132 ++
 redis/_parsers/resp3.py                       |  261 +++
 redis/_parsers/socket.py                      |  162 ++
 redis/asyncio/__init__.py                     |    2 -
 redis/asyncio/client.py                       |   46 +-
 redis/asyncio/cluster.py                      |   25 +-
 redis/asyncio/connection.py                   |  441 +----
 redis/asyncio/parser.py                       |   94 -
 redis/client.py                               |  903 +--------
 redis/cluster.py                              |  135 +-
 redis/commands/__init__.py                    |    2 -
 redis/commands/bf/__init__.py                 |   83 +-
 redis/commands/bf/commands.py                 |    3 -
 redis/commands/bf/info.py                     |   33 +
 redis/commands/core.py                        |   34 +-
 redis/commands/json/__init__.py               |   51 +-
 redis/commands/search/__init__.py             |   27 +-
 redis/commands/search/commands.py             |  211 +-
 redis/commands/timeseries/__init__.py         |   36 +-
 redis/commands/timeseries/info.py             |    9 +
 redis/compat.py                               |    7 +-
 redis/connection.py                           |  556 +-----
 redis/ocsp.py                                 |    1 -
 redis/typing.py                               |   19 +-
 redis/utils.py                                |   21 +
 setup.py                                      |    4 +-
 tasks.py                                      |   66 +-
 tests/conftest.py                             |   88 +-
 tests/ssl_utils.py                            |    4 +-
 tests/test_asyncio/conftest.py                |   32 +-
 tests/test_asyncio/test_bloom.py              |  512 ++---
 tests/test_asyncio/test_cluster.py            |  348 ++--
 tests/test_asyncio/test_commands.py           |  573 ++++--
 tests/test_asyncio/test_connect.py            |    1 -
 tests/test_asyncio/test_connection.py         |   37 +-
 tests/test_asyncio/test_connection_pool.py    |   10 +-
 tests/test_asyncio/test_credentials.py        |    1 -
 tests/test_asyncio/test_cwe_404.py            |    3 +-
 tests/test_asyncio/test_encoding.py           |    2 +-
 tests/test_asyncio/test_graph.py              |  131 +-
 tests/test_asyncio/test_json.py               |  743 ++++----
 tests/test_asyncio/test_lock.py               |    1 -
 tests/test_asyncio/test_monitor.py            |    1 -
 tests/test_asyncio/test_pipeline.py           |    3 -
 tests/test_asyncio/test_pubsub.py             |   39 +-
 tests/test_asyncio/test_retry.py              |    1 -
 tests/test_asyncio/test_scripting.py          |    1 -
 tests/test_asyncio/test_search.py             | 1562 ++++++++++-----
 tests/test_asyncio/test_sentinel.py           |    1 -
 .../test_sentinel_managed_connection.py       |    1 -
 tests/test_asyncio/test_timeseries.py         |  870 +++++----
 tests/test_bloom.py                           |  102 +-
 tests/test_cluster.py                         |  327 +++-
 tests/test_command_parser.py                  |   50 +-
 tests/test_commands.py                        |  759 +++++---
 tests/test_connect.py                         |    1 -
 tests/test_connection.py                      |   30 +-
 tests/test_connection_pool.py                 |    6 +-
 tests/test_credentials.py                     |    7 +-
 tests/test_encoding.py                        |    1 -
 tests/test_function.py                        |   23 +-
 tests/test_graph.py                           |   11 +-
 tests/test_graph_utils/test_edge.py           |    1 -
 tests/test_graph_utils/test_node.py           |    1 -
 tests/test_graph_utils/test_path.py           |    1 -
 tests/test_json.py                            |  311 ++-
 tests/test_lock.py                            |    1 -
 tests/test_multiprocessing.py                 |    1 -
 tests/test_pipeline.py                        |    3 -
 tests/test_pubsub.py                          |  424 +++-
 tests/test_retry.py                           |    1 -
 tests/test_scripting.py                       |    1 -
 tests/test_search.py                          | 1697 +++++++++++------
 tests/test_sentinel.py                        |    1 -
 tests/test_ssl.py                             |    1 -
 tests/test_timeseries.py                      |  592 ++++--
 tox.ini                                       |  379 ----
 whitelist.py                                  |    1 -
 145 files changed, 9187 insertions(+), 5912 deletions(-)
 create mode 100644 .flake8
 create mode 100644 .isort.cfg
 create mode 100644 docker-compose.yml
 delete mode 100644 docker/base/Dockerfile
 delete mode 100644 docker/base/Dockerfile.cluster
 delete mode 100644 docker/base/Dockerfile.cluster4
 delete mode 100644 docker/base/Dockerfile.cluster5
 delete mode 100644 docker/base/Dockerfile.redis4
 delete mode 100644 docker/base/Dockerfile.redis5
 delete mode 100644 docker/base/Dockerfile.redismod_cluster
 delete mode 100644 docker/base/Dockerfile.sentinel
 delete mode 100644 docker/base/Dockerfile.sentinel4
 delete mode 100644 docker/base/Dockerfile.sentinel5
 delete mode 100644 docker/base/Dockerfile.stunnel
 delete mode 100644 docker/base/Dockerfile.unstable
 delete mode 100644 docker/base/Dockerfile.unstable_cluster
 delete mode 100644 docker/base/Dockerfile.unstable_sentinel
 delete mode 100644 docker/base/README.md
 delete mode 100755 docker/base/create_cluster4.sh
 delete mode 100755 docker/base/create_cluster5.sh
 delete mode 100755 docker/base/create_redismod_cluster.sh
 delete mode 100644 docker/cluster/redis.conf
 delete mode 100644 docker/redis4/master/redis.conf
 delete mode 100644 docker/redis4/sentinel/sentinel_1.conf
 delete mode 100644 docker/redis4/sentinel/sentinel_2.conf
 delete mode 100644 docker/redis4/sentinel/sentinel_3.conf
 delete mode 100644 docker/redis5/master/redis.conf
 delete mode 100644 docker/redis5/replica/redis.conf
 delete mode 100644 docker/redis5/sentinel/sentinel_1.conf
 delete mode 100644 docker/redis5/sentinel/sentinel_2.conf
 delete mode 100644 docker/redis5/sentinel/sentinel_3.conf
 delete mode 100644 docker/redis6.2/master/redis.conf
 delete mode 100644 docker/redis6.2/replica/redis.conf
 delete mode 100644 docker/redis6.2/sentinel/sentinel_2.conf
 delete mode 100644 docker/redis6.2/sentinel/sentinel_3.conf
 delete mode 100644 docker/redis7/master/redis.conf
 delete mode 100644 docker/redismod_cluster/redis.conf
 delete mode 100644 docker/unstable/redis.conf
 delete mode 100644 docker/unstable_cluster/redis.conf
 create mode 100644 dockers/Dockerfile.cluster
 create mode 100644 dockers/cluster.redis.conf
 rename {docker/base => dockers}/create_cluster.sh (75%)
 mode change 100755 => 100644
 rename docker/redis6.2/sentinel/sentinel_1.conf => dockers/sentinel.conf (73%)
 rename {docker => dockers}/stunnel/README (100%)
 rename {docker => dockers}/stunnel/conf/redis.conf (83%)
 rename {docker => dockers}/stunnel/create_certs.sh (100%)
 rename {docker => dockers}/stunnel/keys/ca-cert.pem (100%)
 rename {docker => dockers}/stunnel/keys/ca-key.pem (100%)
 rename {docker => dockers}/stunnel/keys/client-cert.pem (100%)
 rename {docker => dockers}/stunnel/keys/client-key.pem (100%)
 rename {docker => dockers}/stunnel/keys/client-req.pem (100%)
 rename {docker => dockers}/stunnel/keys/server-cert.pem (100%)
 rename {docker => dockers}/stunnel/keys/server-key.pem (100%)
 rename {docker => dockers}/stunnel/keys/server-req.pem (100%)
 create mode 100644 pytest.ini
 create mode 100644 redis/_parsers/__init__.py
 create mode 100644 redis/_parsers/base.py
 rename redis/{commands/parser.py => _parsers/commands.py} (62%)
 create mode 100644 redis/_parsers/encoders.py
 create mode 100644 redis/_parsers/helpers.py
 create mode 100644 redis/_parsers/hiredis.py
 create mode 100644 redis/_parsers/resp2.py
 create mode 100644 redis/_parsers/resp3.py
 create mode 100644 redis/_parsers/socket.py
 delete mode 100644 redis/asyncio/parser.py
 delete mode 100644 tox.ini

diff --git a/.flake8 b/.flake8
new file mode 100644
index 0000000000..0e0ace6a4a
--- /dev/null
+++ b/.flake8
@@ -0,0 +1,21 @@
+[flake8]
+max-line-length = 88
+exclude =
+    *.egg-info,
+    *.pyc,
+    .git,
+    .tox,
+    .venv*,
+    build,
+    docs/*,
+    dist,
+    docker,
+    venv*,
+    .venv*,
+    whitelist.py,
+    tasks.py
+ignore =
+    F405
+    W503
+    E203
+    E126
\ No newline at end of file
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index f49a4fcd46..1bab506c32 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -16,6 +16,10 @@ on:
   schedule:
     - cron: '0 1 * * *' # nightly build
 
+concurrency:
+  group: ${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
 permissions:
   contents: read  #  to fetch code (actions/checkout)
 
@@ -48,7 +52,7 @@ jobs:
 
    run-tests:
      runs-on: ubuntu-latest
-     timeout-minutes: 30
+     timeout-minutes: 60
      strategy:
        max-parallel: 15
        fail-fast: false
@@ -68,32 +72,77 @@ jobs:
        - name: run tests
          run: |
            pip install -U setuptools wheel
+           pip install -r requirements.txt
            pip install -r dev_requirements.txt
-           tox -e ${{matrix.test-type}}-${{matrix.connection-type}}
+           if [ "${{matrix.connection-type}}" == "hiredis" ]; then
+            pip install hiredis
+           fi
+           invoke devenv
+           sleep 5 # time to settle
+           invoke ${{matrix.test-type}}-tests
+
        - uses: actions/upload-artifact@v2
          if: success() || failure()
          with:
-           name: pytest-results-${{matrix.test-type}}
+           name: pytest-results-${{matrix.test-type}}-${{matrix.connection-type}}-${{matrix.python-version}}
            path: '${{matrix.test-type}}*results.xml'
+
        - name: Upload codecov coverage
          uses: codecov/codecov-action@v3
+         if: ${{matrix.python-version == '3.11'}}
          with:
            fail_ci_if_error: false
-      #  - name: View Test Results
-      #    uses: dorny/test-reporter@v1
-      #    if: success() || failure()
-      #    with:
-      #      name: Test Results ${{matrix.python-version}} ${{matrix.test-type}}-${{matrix.connection-type}}
-      #      path: '${{matrix.test-type}}*results.xml'
-      #      reporter: java-junit
-      #      list-suites: failed
-      #      list-tests: failed
-      #      max-annotations: 10
+
+       - name: View Test Results
+         uses: dorny/test-reporter@v1
+         if: success() || failure()
+         continue-on-error: true
+         with:
+           name: Test Results ${{matrix.python-version}} ${{matrix.test-type}}-${{matrix.connection-type}}
+           path: '*.xml'
+           reporter: java-junit
+           list-suites: all
+           list-tests: all
+           max-annotations: 10
+           fail-on-error: 'false'
+
+   resp3_tests:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ['3.7', '3.11']
+        test-type: ['standalone', 'cluster']
+        connection-type: ['hiredis', 'plain']
+        protocol: ['3']
+    env:
+       ACTIONS_ALLOW_UNSECURE_COMMANDS: true
+    name: RESP3 [${{ matrix.python-version }} ${{matrix.test-type}}-${{matrix.connection-type}}]
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: 'pip'
+      - name: run tests
+        run: |
+          pip install -U setuptools wheel
+          pip install -r requirements.txt
+          pip install -r dev_requirements.txt
+          if [ "${{matrix.connection-type}}" == "hiredis" ]; then
+            pip install hiredis
+          fi
+          invoke devenv
+          sleep 5 # time to settle
+          invoke ${{matrix.test-type}}-tests
+          invoke ${{matrix.test-type}}-tests --uvloop
 
    build_and_test_package:
     name: Validate building and installing the package
     runs-on: ubuntu-latest
+    needs: [run-tests]
     strategy:
+      fail-fast: false
       matrix:
         extension: ['tar.gz', 'whl']
     steps:
diff --git a/.isort.cfg b/.isort.cfg
new file mode 100644
index 0000000000..039f0337a2
--- /dev/null
+++ b/.isort.cfg
@@ -0,0 +1,5 @@
+[settings]
+profile=black
+multi_line_output=3
+src_paths = ["redis", "tests"]
+skip_glob=benchmarks/*
\ No newline at end of file
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 8518547518..90a538be46 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -38,8 +38,9 @@ Here's how to get started with your code contribution:
         a.  python -m venv .venv
         b.  source .venv/bin/activate
         c.  pip install -r dev_requirements.txt
+        c.  pip install -r requirements.txt
 
-4.  If you need a development environment, run `invoke devenv`
+4.  If you need a development environment, run `invoke devenv`. Note: this relies on docker-compose to build environments, and assumes that you have a version supporting [docker profiles](https://docs.docker.com/compose/profiles/).
 5.  While developing, make sure the tests pass by running `invoke tests`
 6.  If you like the change and think the project could use it, send a
     pull request
@@ -59,7 +60,6 @@ can execute docker and its various commands.
 -   Three sentinel Redis nodes
 -   A redis cluster
 -   An stunnel docker, fronting the master Redis node
--   A Redis node, running unstable - the latest redis
 
 The replica node, is a replica of the master node, using the
 [leader-follower replication](https://redis.io/topics/replication)
diff --git a/benchmarks/socket_read_size.py b/benchmarks/socket_read_size.py
index 3427956ced..544c733178 100644
--- a/benchmarks/socket_read_size.py
+++ b/benchmarks/socket_read_size.py
@@ -1,12 +1,12 @@
 from base import Benchmark
 
-from redis.connection import HiredisParser, PythonParser
+from redis.connection import PythonParser, _HiredisParser
 
 
 class SocketReadBenchmark(Benchmark):
 
     ARGUMENTS = (
-        {"name": "parser", "values": [PythonParser, HiredisParser]},
+        {"name": "parser", "values": [PythonParser, _HiredisParser]},
         {
             "name": "value_size",
             "values": [10, 100, 1000, 10000, 100000, 1000000, 10000000, 100000000],
diff --git a/dev_requirements.txt b/dev_requirements.txt
index 8ffb1e944f..cdb3774ab6 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -1,15 +1,14 @@
 click==8.0.4
 black==22.3.0
 flake8==5.0.4
+flake8-isort==6.0.0
 flynt~=0.69.0
-isort==5.10.1
 mock==4.0.3
 packaging>=20.4
 pytest==7.2.0
-pytest-timeout==2.0.1
+pytest-timeout==2.1.0
 pytest-asyncio>=0.20.2
 tox==3.27.1
-tox-docker==3.1.0
 invoke==1.7.3
 pytest-cov>=4.0.0
 vulture>=2.3.0
diff --git a/docker-compose.yml b/docker-compose.yml
new file mode 100644
index 0000000000..17d4b23977
--- /dev/null
+++ b/docker-compose.yml
@@ -0,0 +1,109 @@
+---
+
+version: "3.8"
+
+services:
+
+  redis:
+    image: redis/redis-stack-server:edge
+    container_name: redis-standalone
+    ports:
+      - 6379:6379
+    environment:
+      - "REDIS_ARGS=--enable-debug-command yes --enable-module-command yes"
+    profiles:
+      - standalone
+      - sentinel
+      - replica
+      - all
+
+  replica:
+    image: redis/redis-stack-server:edge
+    container_name: redis-replica
+    depends_on:
+      - redis
+    environment:
+      - "REDIS_ARGS=--replicaof redis 6379"
+    ports:
+      - 6380:6379
+    profiles:
+      - replica
+      - all
+
+  cluster:
+    container_name: redis-cluster
+    build:
+      context: .
+      dockerfile: dockers/Dockerfile.cluster
+    ports:
+      - 16379:16379
+      - 16380:16380
+      - 16381:16381
+      - 16382:16382
+      - 16383:16383
+      - 16384:16384
+    volumes:
+      - "./dockers/cluster.redis.conf:/redis.conf:ro"
+    profiles:
+      - cluster
+      - all
+
+  stunnel:
+    image: redisfab/stunnel:latest
+    depends_on:
+      - redis
+    ports:
+      - 6666:6666
+    profiles:
+      - all
+      - standalone
+      - ssl
+    volumes:
+      - "./dockers/stunnel/conf:/etc/stunnel/conf.d:ro"
+      - "./dockers/stunnel/keys:/etc/stunnel/keys:ro"
+
+  sentinel:
+    image: redis/redis-stack-server:edge
+    container_name: redis-sentinel
+    depends_on:
+      - redis
+    environment:
+      - "REDIS_ARGS=--port 26379"
+    entrypoint: "/opt/redis-stack/bin/redis-sentinel /redis.conf --port 26379"
+    ports:
+      - 26379:26379
+    volumes:
+      - "./dockers/sentinel.conf:/redis.conf"
+    profiles:
+      - sentinel
+      - all
+
+  sentinel2:
+    image: redis/redis-stack-server:edge
+    container_name: redis-sentinel2
+    depends_on:
+      - redis
+    environment:
+      - "REDIS_ARGS=--port 26380"
+    entrypoint: "/opt/redis-stack/bin/redis-sentinel /redis.conf --port 26380"
+    ports:
+      - 26380:26380
+    volumes:
+      - "./dockers/sentinel.conf:/redis.conf"
+    profiles:
+      - sentinel
+      - all
+
+  sentinel3:
+    image: redis/redis-stack-server:edge
+    container_name: redis-sentinel3
+    depends_on:
+      - redis
+    entrypoint: "/opt/redis-stack/bin/redis-sentinel /redis.conf --port 26381"
+    ports:
+      - 26381:26381
+    volumes:
+      - "./dockers/sentinel.conf:/redis.conf"
+    profiles:
+      - sentinel
+      - all
diff --git a/docker/base/Dockerfile b/docker/base/Dockerfile
deleted file mode 100644
index c76d15db36..0000000000
--- a/docker/base/Dockerfile
+++ /dev/null
@@ -1,4 +0,0 @@
-# produces redisfab/redis-py:6.2.6
-FROM redis:6.2.6-buster
-
-CMD ["redis-server", "/redis.conf"]
diff --git a/docker/base/Dockerfile.cluster b/docker/base/Dockerfile.cluster
deleted file mode 100644
index 5c246dcf28..0000000000
--- a/docker/base/Dockerfile.cluster
+++ /dev/null
@@ -1,11 +0,0 @@
-# produces redisfab/redis-py-cluster:6.2.6
-FROM redis:6.2.6-buster
-
-COPY create_cluster.sh /create_cluster.sh
-RUN chmod +x /create_cluster.sh
-
-EXPOSE 16379 16380 16381 16382 16383 16384
-
-ENV START_PORT=16379
-ENV END_PORT=16384
-CMD /create_cluster.sh
diff --git a/docker/base/Dockerfile.cluster4 b/docker/base/Dockerfile.cluster4
deleted file mode 100644
index 3158d6edd4..0000000000
--- a/docker/base/Dockerfile.cluster4
+++ /dev/null
@@ -1,9 +0,0 @@
-# produces redisfab/redis-py-cluster:4.0
-FROM redis:4.0-buster
-
-COPY create_cluster4.sh /create_cluster4.sh
-RUN chmod +x /create_cluster4.sh
-
-EXPOSE 16391 16392 16393 16394 16395 16396
-
-CMD [ "/create_cluster4.sh"]
\ No newline at end of file
diff --git a/docker/base/Dockerfile.cluster5 b/docker/base/Dockerfile.cluster5
deleted file mode 100644
index 3becfc853a..0000000000
--- a/docker/base/Dockerfile.cluster5
+++ /dev/null
@@ -1,9 +0,0 @@
-# produces redisfab/redis-py-cluster:5.0
-FROM redis:5.0-buster
-
-COPY create_cluster5.sh /create_cluster5.sh
-RUN chmod +x /create_cluster5.sh
-
-EXPOSE 16385 16386 16387 16388 16389 16390
-
-CMD [ "/create_cluster5.sh"]
\ No newline at end of file
diff --git a/docker/base/Dockerfile.redis4 b/docker/base/Dockerfile.redis4
deleted file mode 100644
index 7528ac1631..0000000000
--- a/docker/base/Dockerfile.redis4
+++ /dev/null
@@ -1,4 +0,0 @@
-# produces redisfab/redis-py:4.0
-FROM redis:4.0-buster
-
-CMD ["redis-server", "/redis.conf"]
\ No newline at end of file
diff --git a/docker/base/Dockerfile.redis5 b/docker/base/Dockerfile.redis5
deleted file mode 100644
index 6bcbe20bfc..0000000000
--- a/docker/base/Dockerfile.redis5
+++ /dev/null
@@ -1,4 +0,0 @@
-# produces redisfab/redis-py:5.0
-FROM redis:5.0-buster
-
-CMD ["redis-server", "/redis.conf"]
\ No newline at end of file
diff --git a/docker/base/Dockerfile.redismod_cluster b/docker/base/Dockerfile.redismod_cluster
deleted file mode 100644
index 5b80e495fb..0000000000
--- a/docker/base/Dockerfile.redismod_cluster
+++ /dev/null
@@ -1,12 +0,0 @@
-# produces redisfab/redis-py-modcluster:6.2.6
-FROM redislabs/redismod:edge
-
-COPY create_redismod_cluster.sh /create_redismod_cluster.sh
-RUN chmod +x /create_redismod_cluster.sh
-
-EXPOSE 46379 46380 46381 46382 46383 46384
-
-ENV START_PORT=46379
-ENV END_PORT=46384
-ENTRYPOINT []
-CMD /create_redismod_cluster.sh
diff --git a/docker/base/Dockerfile.sentinel b/docker/base/Dockerfile.sentinel
deleted file mode 100644
index ef659e3004..0000000000
--- a/docker/base/Dockerfile.sentinel
+++ /dev/null
@@ -1,4 +0,0 @@
-# produces redisfab/redis-py-sentinel:6.2.6
-FROM redis:6.2.6-buster
-
-CMD ["redis-sentinel", "/sentinel.conf"]
diff --git a/docker/base/Dockerfile.sentinel4 b/docker/base/Dockerfile.sentinel4
deleted file mode 100644
index 45bb03e88e..0000000000
--- a/docker/base/Dockerfile.sentinel4
+++ /dev/null
@@ -1,4 +0,0 @@
-# produces redisfab/redis-py-sentinel:4.0
-FROM redis:4.0-buster
-
-CMD ["redis-sentinel", "/sentinel.conf"]
\ No newline at end of file
diff --git a/docker/base/Dockerfile.sentinel5 b/docker/base/Dockerfile.sentinel5
deleted file mode 100644
index 6958154e46..0000000000
--- a/docker/base/Dockerfile.sentinel5
+++ /dev/null
@@ -1,4 +0,0 @@
-# produces redisfab/redis-py-sentinel:5.0
-FROM redis:5.0-buster
-
-CMD ["redis-sentinel", "/sentinel.conf"]
\ No newline at end of file
diff --git a/docker/base/Dockerfile.stunnel b/docker/base/Dockerfile.stunnel
deleted file mode 100644
index bf4510907c..0000000000
--- a/docker/base/Dockerfile.stunnel
+++ /dev/null
@@ -1,11 +0,0 @@
-# produces redisfab/stunnel:latest
-FROM ubuntu:18.04
-
-RUN apt-get update -qq --fix-missing
-RUN apt-get upgrade -qqy
-RUN apt install -qqy stunnel
-RUN mkdir -p /etc/stunnel/conf.d
-RUN echo "foreground = yes\ninclude = /etc/stunnel/conf.d" > /etc/stunnel/stunnel.conf
-RUN chown -R root:root /etc/stunnel/
-
-CMD ["/usr/bin/stunnel"]
diff --git a/docker/base/Dockerfile.unstable b/docker/base/Dockerfile.unstable
deleted file mode 100644
index ab5b7fc6fb..0000000000
--- a/docker/base/Dockerfile.unstable
+++ /dev/null
@@ -1,18 +0,0 @@
-# produces redisfab/redis-py:unstable
-FROM ubuntu:bionic as builder
-RUN apt-get update
-RUN apt-get upgrade -y
-RUN apt-get install -y build-essential git
-RUN mkdir /build
-WORKDIR /build
-RUN git clone https://github.com/redis/redis
-WORKDIR /build/redis
-RUN make
-
-FROM ubuntu:bionic as runner
-COPY --from=builder /build/redis/src/redis-server /usr/bin/redis-server
-COPY --from=builder /build/redis/src/redis-cli /usr/bin/redis-cli
-COPY --from=builder /build/redis/src/redis-sentinel /usr/bin/redis-sentinel
-
-EXPOSE 6379
-CMD ["redis-server", "/redis.conf"]
diff --git a/docker/base/Dockerfile.unstable_cluster b/docker/base/Dockerfile.unstable_cluster
deleted file mode 100644
index 2e3ed55371..0000000000
--- a/docker/base/Dockerfile.unstable_cluster
+++ /dev/null
@@ -1,11 +0,0 @@
-# produces redisfab/redis-py-cluster:6.2.6
-FROM redisfab/redis-py:unstable-bionic
-
-COPY create_cluster.sh /create_cluster.sh
-RUN chmod +x /create_cluster.sh
-
-EXPOSE 6372 6373 6374 6375 6376 6377
-
-ENV START_PORT=6372
-ENV END_PORT=6377
-CMD ["/create_cluster.sh"]
diff --git a/docker/base/Dockerfile.unstable_sentinel b/docker/base/Dockerfile.unstable_sentinel
deleted file mode 100644
index fe6d062de8..0000000000
--- a/docker/base/Dockerfile.unstable_sentinel
+++ /dev/null
@@ -1,17 +0,0 @@
-# produces redisfab/redis-py-sentinel:unstable
-FROM ubuntu:bionic as builder
-RUN apt-get update
-RUN apt-get upgrade -y
-RUN apt-get install -y build-essential git
-RUN mkdir /build
-WORKDIR /build
-RUN git clone https://github.com/redis/redis
-WORKDIR /build/redis
-RUN make
-
-FROM ubuntu:bionic as runner
-COPY --from=builder /build/redis/src/redis-server /usr/bin/redis-server
-COPY --from=builder /build/redis/src/redis-cli /usr/bin/redis-cli
-COPY --from=builder /build/redis/src/redis-sentinel /usr/bin/redis-sentinel
-
-CMD ["redis-sentinel", "/sentinel.conf"]
diff --git a/docker/base/README.md b/docker/base/README.md
deleted file mode 100644
index a2f26a8106..0000000000
--- a/docker/base/README.md
+++ /dev/null
@@ -1 +0,0 @@
-Dockers in this folder are built, and uploaded to the redisfab dockerhub store.
diff --git a/docker/base/create_cluster4.sh b/docker/base/create_cluster4.sh
deleted file mode 100755
index a39da58784..0000000000
--- a/docker/base/create_cluster4.sh
+++ /dev/null
@@ -1,26 +0,0 @@
-#! /bin/bash
-mkdir -p /nodes
-touch /nodes/nodemap
-for PORT in $(seq 16391 16396); do
-  mkdir -p /nodes/$PORT
-  if [[ -e /redis.conf ]]; then
-    cp /redis.conf /nodes/$PORT/redis.conf
-  else
-    touch /nodes/$PORT/redis.conf
-  fi
-  cat << EOF >> /nodes/$PORT/redis.conf
-port ${PORT}
-cluster-enabled yes
-daemonize yes
-logfile /redis.log
-dir /nodes/$PORT
-EOF
-  redis-server /nodes/$PORT/redis.conf
-  if [ $? -ne 0 ]; then
-    echo "Redis failed to start, exiting."
-    exit 3
-  fi
-  echo 127.0.0.1:$PORT >> /nodes/nodemap
-done
-echo yes | redis-cli --cluster create $(seq -f 127.0.0.1:%g 16391 16396) --cluster-replicas 1
-tail -f /redis.log
\ No newline at end of file
diff --git a/docker/base/create_cluster5.sh b/docker/base/create_cluster5.sh
deleted file mode 100755
index 0c63d8e910..0000000000
--- a/docker/base/create_cluster5.sh
+++ /dev/null
@@ -1,26 +0,0 @@
-#! /bin/bash
-mkdir -p /nodes
-touch /nodes/nodemap
-for PORT in $(seq 16385 16390); do
-  mkdir -p /nodes/$PORT
-  if [[ -e /redis.conf ]]; then
-    cp /redis.conf /nodes/$PORT/redis.conf
-  else
-    touch /nodes/$PORT/redis.conf
-  fi
-  cat << EOF >> /nodes/$PORT/redis.conf
-port ${PORT}
-cluster-enabled yes
-daemonize yes
-logfile /redis.log
-dir /nodes/$PORT
-EOF
-  redis-server /nodes/$PORT/redis.conf
-  if [ $? -ne 0 ]; then
-    echo "Redis failed to start, exiting."
-    exit 3
-  fi
-  echo 127.0.0.1:$PORT >> /nodes/nodemap
-done
-echo yes | redis-cli --cluster create $(seq -f 127.0.0.1:%g 16385 16390) --cluster-replicas 1
-tail -f /redis.log
\ No newline at end of file
diff --git a/docker/base/create_redismod_cluster.sh b/docker/base/create_redismod_cluster.sh
deleted file mode 100755
index 20443a4c42..0000000000
--- a/docker/base/create_redismod_cluster.sh
+++ /dev/null
@@ -1,46 +0,0 @@
-#! /bin/bash
-
-mkdir -p /nodes
-touch /nodes/nodemap
-if [ -z ${START_PORT} ]; then
-    START_PORT=46379
-fi
-if [ -z ${END_PORT} ]; then
-    END_PORT=46384
-fi
-if [ ! -z "$3" ]; then
-    START_PORT=$2
-    START_PORT=$3
-fi
-echo "STARTING: ${START_PORT}"
-echo "ENDING: ${END_PORT}"
-
-for PORT in `seq ${START_PORT} ${END_PORT}`; do
-  mkdir -p /nodes/$PORT
-  if [[ -e /redis.conf ]]; then
-    cp /redis.conf /nodes/$PORT/redis.conf
-  else
-    touch /nodes/$PORT/redis.conf
-  fi
-  cat << EOF >> /nodes/$PORT/redis.conf
-port ${PORT}
-cluster-enabled yes
-daemonize yes
-logfile /redis.log
-dir /nodes/$PORT
-EOF
-
-  set -x
-  redis-server /nodes/$PORT/redis.conf
-  if [ $? -ne 0 ]; then
-    echo "Redis failed to start, exiting."
-    continue
-  fi
-  echo 127.0.0.1:$PORT >> /nodes/nodemap
-done
-if [ -z "${REDIS_PASSWORD}" ]; then
-    echo yes | redis-cli --cluster create `seq -f 127.0.0.1:%g ${START_PORT} ${END_PORT}` --cluster-replicas 1
-else
-    echo yes | redis-cli -a ${REDIS_PASSWORD} --cluster create `seq -f 127.0.0.1:%g ${START_PORT} ${END_PORT}` --cluster-replicas 1
-fi
-tail -f /redis.log
diff --git a/docker/cluster/redis.conf b/docker/cluster/redis.conf
deleted file mode 100644
index dff658c79b..0000000000
--- a/docker/cluster/redis.conf
+++ /dev/null
@@ -1,3 +0,0 @@
-# Redis Cluster config file will be shared across all nodes.
-# Do not change the following configurations that are already set:
-# port, cluster-enabled, daemonize, logfile, dir
diff --git a/docker/redis4/master/redis.conf b/docker/redis4/master/redis.conf
deleted file mode 100644
index b7ed0ebf00..0000000000
--- a/docker/redis4/master/redis.conf
+++ /dev/null
@@ -1,2 +0,0 @@
-port 6381
-save ""
diff --git a/docker/redis4/sentinel/sentinel_1.conf b/docker/redis4/sentinel/sentinel_1.conf
deleted file mode 100644
index cfee17c051..0000000000
--- a/docker/redis4/sentinel/sentinel_1.conf
+++ /dev/null
@@ -1,6 +0,0 @@
-port 26385
-
-sentinel monitor redis-py-test 127.0.0.1 6381 2
-sentinel down-after-milliseconds redis-py-test 5000
-sentinel failover-timeout redis-py-test 60000
-sentinel parallel-syncs redis-py-test 1
diff --git a/docker/redis4/sentinel/sentinel_2.conf b/docker/redis4/sentinel/sentinel_2.conf
deleted file mode 100644
index 68d930aea8..0000000000
--- a/docker/redis4/sentinel/sentinel_2.conf
+++ /dev/null
@@ -1,6 +0,0 @@
-port 26386
-
-sentinel monitor redis-py-test 127.0.0.1 6381 2
-sentinel down-after-milliseconds redis-py-test 5000
-sentinel failover-timeout redis-py-test 60000
-sentinel parallel-syncs redis-py-test 1
\ No newline at end of file
diff --git a/docker/redis4/sentinel/sentinel_3.conf b/docker/redis4/sentinel/sentinel_3.conf
deleted file mode 100644
index 60abf65c9b..0000000000
--- a/docker/redis4/sentinel/sentinel_3.conf
+++ /dev/null
@@ -1,6 +0,0 @@
-port 26387
-
-sentinel monitor redis-py-test 127.0.0.1 6381 2
-sentinel down-after-milliseconds redis-py-test 5000
-sentinel failover-timeout redis-py-test 60000
-sentinel parallel-syncs redis-py-test 1
\ No newline at end of file
diff --git a/docker/redis5/master/redis.conf b/docker/redis5/master/redis.conf
deleted file mode 100644
index e479c48b28..0000000000
--- a/docker/redis5/master/redis.conf
+++ /dev/null
@@ -1,2 +0,0 @@
-port 6382
-save ""
diff --git a/docker/redis5/replica/redis.conf b/docker/redis5/replica/redis.conf
deleted file mode 100644
index a2dc9e0945..0000000000
--- a/docker/redis5/replica/redis.conf
+++ /dev/null
@@ -1,3 +0,0 @@
-port 6383
-save ""
-replicaof master 6382
diff --git a/docker/redis5/sentinel/sentinel_1.conf b/docker/redis5/sentinel/sentinel_1.conf
deleted file mode 100644
index c748a0ba72..0000000000
--- a/docker/redis5/sentinel/sentinel_1.conf
+++ /dev/null
@@ -1,6 +0,0 @@
-port 26382
-
-sentinel monitor redis-py-test 127.0.0.1 6382 2
-sentinel down-after-milliseconds redis-py-test 5000
-sentinel failover-timeout redis-py-test 60000
-sentinel parallel-syncs redis-py-test 1
diff --git a/docker/redis5/sentinel/sentinel_2.conf b/docker/redis5/sentinel/sentinel_2.conf
deleted file mode 100644
index 0a50c9a623..0000000000
--- a/docker/redis5/sentinel/sentinel_2.conf
+++ /dev/null
@@ -1,6 +0,0 @@
-port 26383
-
-sentinel monitor redis-py-test 127.0.0.1 6382 2
-sentinel down-after-milliseconds redis-py-test 5000
-sentinel failover-timeout redis-py-test 60000
-sentinel parallel-syncs redis-py-test 1
\ No newline at end of file
diff --git a/docker/redis5/sentinel/sentinel_3.conf b/docker/redis5/sentinel/sentinel_3.conf
deleted file mode 100644
index a0e350ba0f..0000000000
--- a/docker/redis5/sentinel/sentinel_3.conf
+++ /dev/null
@@ -1,6 +0,0 @@
-port 26384
-
-sentinel monitor redis-py-test 127.0.0.1 6383 2
-sentinel down-after-milliseconds redis-py-test 5000
-sentinel failover-timeout redis-py-test 60000
-sentinel parallel-syncs redis-py-test 1
\ No newline at end of file
diff --git a/docker/redis6.2/master/redis.conf b/docker/redis6.2/master/redis.conf
deleted file mode 100644
index 15a31b5a38..0000000000
--- a/docker/redis6.2/master/redis.conf
+++ /dev/null
@@ -1,2 +0,0 @@
-port 6379
-save ""
diff --git a/docker/redis6.2/replica/redis.conf b/docker/redis6.2/replica/redis.conf
deleted file mode 100644
index a76d402c5e..0000000000
--- a/docker/redis6.2/replica/redis.conf
+++ /dev/null
@@ -1,3 +0,0 @@
-port 6380
-save ""
-replicaof master 6379
diff --git a/docker/redis6.2/sentinel/sentinel_2.conf b/docker/redis6.2/sentinel/sentinel_2.conf
deleted file mode 100644
index 955621b872..0000000000
--- a/docker/redis6.2/sentinel/sentinel_2.conf
+++ /dev/null
@@ -1,6 +0,0 @@
-port 26380
-
-sentinel monitor redis-py-test 127.0.0.1 6379 2
-sentinel down-after-milliseconds redis-py-test 5000
-sentinel failover-timeout redis-py-test 60000
-sentinel parallel-syncs redis-py-test 1
diff --git a/docker/redis6.2/sentinel/sentinel_3.conf b/docker/redis6.2/sentinel/sentinel_3.conf
deleted file mode 100644
index 62c40512f1..0000000000
--- a/docker/redis6.2/sentinel/sentinel_3.conf
+++ /dev/null
@@ -1,6 +0,0 @@
-port 26381
-
-sentinel monitor redis-py-test 127.0.0.1 6379 2
-sentinel down-after-milliseconds redis-py-test 5000
-sentinel failover-timeout redis-py-test 60000
-sentinel parallel-syncs redis-py-test 1
diff --git a/docker/redis7/master/redis.conf b/docker/redis7/master/redis.conf
deleted file mode 100644
index ef57c1fe99..0000000000
--- a/docker/redis7/master/redis.conf
+++ /dev/null
@@ -1,4 +0,0 @@
-port 6379
-save ""
-enable-debug-command yes
-enable-module-command yes
\ No newline at end of file
diff --git a/docker/redismod_cluster/redis.conf b/docker/redismod_cluster/redis.conf
deleted file mode 100644
index 48f06668a8..0000000000
--- a/docker/redismod_cluster/redis.conf
+++ /dev/null
@@ -1,8 +0,0 @@
-loadmodule /usr/lib/redis/modules/redisai.so
-loadmodule /usr/lib/redis/modules/redisearch.so
-loadmodule /usr/lib/redis/modules/redisgraph.so
-loadmodule /usr/lib/redis/modules/redistimeseries.so
-loadmodule /usr/lib/redis/modules/rejson.so
-loadmodule /usr/lib/redis/modules/redisbloom.so
-loadmodule /var/opt/redislabs/lib/modules/redisgears.so Plugin /var/opt/redislabs/modules/rg/plugin/gears_python.so Plugin /var/opt/redislabs/modules/rg/plugin/gears_jvm.so JvmOptions -Djava.class.path=/var/opt/redislabs/modules/rg/gear_runtime-jar-with-dependencies.jar JvmPath /var/opt/redislabs/modules/rg/OpenJDK/jdk-11.0.9.1+1/
-
diff --git a/docker/unstable/redis.conf b/docker/unstable/redis.conf
deleted file mode 100644
index 93a55cf3b3..0000000000
--- a/docker/unstable/redis.conf
+++ /dev/null
@@ -1,3 +0,0 @@
-port 6378
-protected-mode no
-save ""
diff --git a/docker/unstable_cluster/redis.conf b/docker/unstable_cluster/redis.conf
deleted file mode 100644
index f307a63757..0000000000
--- a/docker/unstable_cluster/redis.conf
+++ /dev/null
@@ -1,4 +0,0 @@
-# Redis Cluster config file will be shared across all nodes.
-# Do not change the following configurations that are already set:
-# port, cluster-enabled, daemonize, logfile, dir
-protected-mode no
diff --git a/dockers/Dockerfile.cluster b/dockers/Dockerfile.cluster
new file mode 100644
index 0000000000..204232a665
--- /dev/null
+++ b/dockers/Dockerfile.cluster
@@ -0,0 +1,7 @@
+FROM redis/redis-stack-server:latest as rss
+
+COPY dockers/create_cluster.sh /create_cluster.sh
+RUN ls -R /opt/redis-stack
+RUN chmod a+x /create_cluster.sh
+
+ENTRYPOINT [ "/create_cluster.sh"]
diff --git a/dockers/cluster.redis.conf b/dockers/cluster.redis.conf
new file mode 100644
index 0000000000..26da33567a
--- /dev/null
+++ b/dockers/cluster.redis.conf
@@ -0,0 +1,6 @@
+protected-mode no
+loadmodule /opt/redis-stack/lib/redisearch.so
+loadmodule /opt/redis-stack/lib/redisgraph.so
+loadmodule /opt/redis-stack/lib/redistimeseries.so
+loadmodule /opt/redis-stack/lib/rejson.so
+loadmodule /opt/redis-stack/lib/redisbloom.so
diff --git a/docker/base/create_cluster.sh b/dockers/create_cluster.sh
old mode 100755
new mode 100644
similarity index 75%
rename from docker/base/create_cluster.sh
rename to dockers/create_cluster.sh
index fcb1b1cd8d..da9a0cb606
--- a/docker/base/create_cluster.sh
+++ b/dockers/create_cluster.sh
@@ -31,7 +31,8 @@ dir /nodes/$PORT
 EOF
 
   set -x
-  redis-server /nodes/$PORT/redis.conf
+  /opt/redis-stack/bin/redis-server /nodes/$PORT/redis.conf
+  sleep 1
   if [ $? -ne 0 ]; then
     echo "Redis failed to start, exiting."
     continue
@@ -39,8 +40,8 @@ EOF
   echo 127.0.0.1:$PORT >> /nodes/nodemap
 done
 if [ -z "${REDIS_PASSWORD}" ]; then
-    echo yes | redis-cli --cluster create `seq -f 127.0.0.1:%g ${START_PORT} ${END_PORT}` --cluster-replicas 1
+    echo yes | /opt/redis-stack/bin/redis-cli --cluster create `seq -f 127.0.0.1:%g ${START_PORT} ${END_PORT}` --cluster-replicas 1
 else
-    echo yes | redis-cli -a ${REDIS_PASSWORD} --cluster create `seq -f 127.0.0.1:%g ${START_PORT} ${END_PORT}` --cluster-replicas 1
+    echo yes | opt/redis-stack/bin/redis-cli -a ${REDIS_PASSWORD} --cluster create `seq -f 127.0.0.1:%g ${START_PORT} ${END_PORT}` --cluster-replicas 1
 fi
 tail -f /redis.log
diff --git a/docker/redis6.2/sentinel/sentinel_1.conf b/dockers/sentinel.conf
similarity index 73%
rename from docker/redis6.2/sentinel/sentinel_1.conf
rename to dockers/sentinel.conf
index bd2d830af3..1a33f53344 100644
--- a/docker/redis6.2/sentinel/sentinel_1.conf
+++ b/dockers/sentinel.conf
@@ -1,6 +1,4 @@
-port 26379
-
 sentinel monitor redis-py-test 127.0.0.1 6379 2
 sentinel down-after-milliseconds redis-py-test 5000
 sentinel failover-timeout redis-py-test 60000
-sentinel parallel-syncs redis-py-test 1
+sentinel parallel-syncs redis-py-test 1
\ No newline at end of file
diff --git a/docker/stunnel/README b/dockers/stunnel/README
similarity index 100%
rename from docker/stunnel/README
rename to dockers/stunnel/README
diff --git a/docker/stunnel/conf/redis.conf b/dockers/stunnel/conf/redis.conf
similarity index 83%
rename from docker/stunnel/conf/redis.conf
rename to dockers/stunnel/conf/redis.conf
index 84f6d40133..a150d8b011 100644
--- a/docker/stunnel/conf/redis.conf
+++ b/dockers/stunnel/conf/redis.conf
@@ -1,6 +1,6 @@
 [redis]
 accept = 6666
-connect = master:6379
+connect = redis:6379
 cert = /etc/stunnel/keys/server-cert.pem
 key = /etc/stunnel/keys/server-key.pem
 verify = 0
diff --git a/docker/stunnel/create_certs.sh b/dockers/stunnel/create_certs.sh
similarity index 100%
rename from docker/stunnel/create_certs.sh
rename to dockers/stunnel/create_certs.sh
diff --git a/docker/stunnel/keys/ca-cert.pem b/dockers/stunnel/keys/ca-cert.pem
similarity index 100%
rename from docker/stunnel/keys/ca-cert.pem
rename to dockers/stunnel/keys/ca-cert.pem
diff --git a/docker/stunnel/keys/ca-key.pem b/dockers/stunnel/keys/ca-key.pem
similarity index 100%
rename from docker/stunnel/keys/ca-key.pem
rename to dockers/stunnel/keys/ca-key.pem
diff --git a/docker/stunnel/keys/client-cert.pem b/dockers/stunnel/keys/client-cert.pem
similarity index 100%
rename from docker/stunnel/keys/client-cert.pem
rename to dockers/stunnel/keys/client-cert.pem
diff --git a/docker/stunnel/keys/client-key.pem b/dockers/stunnel/keys/client-key.pem
similarity index 100%
rename from docker/stunnel/keys/client-key.pem
rename to dockers/stunnel/keys/client-key.pem
diff --git a/docker/stunnel/keys/client-req.pem b/dockers/stunnel/keys/client-req.pem
similarity index 100%
rename from docker/stunnel/keys/client-req.pem
rename to dockers/stunnel/keys/client-req.pem
diff --git a/docker/stunnel/keys/server-cert.pem b/dockers/stunnel/keys/server-cert.pem
similarity index 100%
rename from docker/stunnel/keys/server-cert.pem
rename to dockers/stunnel/keys/server-cert.pem
diff --git a/docker/stunnel/keys/server-key.pem b/dockers/stunnel/keys/server-key.pem
similarity index 100%
rename from docker/stunnel/keys/server-key.pem
rename to dockers/stunnel/keys/server-key.pem
diff --git a/docker/stunnel/keys/server-req.pem b/dockers/stunnel/keys/server-req.pem
similarity index 100%
rename from docker/stunnel/keys/server-req.pem
rename to dockers/stunnel/keys/server-req.pem
diff --git a/docs/examples/opentelemetry/main.py b/docs/examples/opentelemetry/main.py
index b140dd0148..9ef6723305 100755
--- a/docs/examples/opentelemetry/main.py
+++ b/docs/examples/opentelemetry/main.py
@@ -2,12 +2,11 @@
 
 import time
 
+import redis
 import uptrace
 from opentelemetry import trace
 from opentelemetry.instrumentation.redis import RedisInstrumentor
 
-import redis
-
 tracer = trace.get_tracer("app_or_package_name", "1.0.0")
 
 
diff --git a/pytest.ini b/pytest.ini
new file mode 100644
index 0000000000..f1b716ae96
--- /dev/null
+++ b/pytest.ini
@@ -0,0 +1,13 @@
+[pytest]
+addopts = -s
+markers =
+    redismod: run only the redis module tests
+    pipeline: pipeline tests
+    onlycluster: marks tests to be run only with cluster mode redis
+    onlynoncluster: marks tests to be run only with standalone redis
+    ssl: marker for only the ssl tests
+    asyncio: marker for async tests
+    replica: replica tests
+    experimental: run only experimental tests
+asyncio_mode = auto
+timeout = 30
diff --git a/redis/__init__.py b/redis/__init__.py
index d7b74edf41..495d2d99bb 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -1,5 +1,6 @@
 import sys
 
+from redis import asyncio  # noqa
 from redis.backoff import default_backoff
 from redis.client import Redis, StrictRedis
 from redis.cluster import RedisCluster
diff --git a/redis/_parsers/__init__.py b/redis/_parsers/__init__.py
new file mode 100644
index 0000000000..6cc32e3cae
--- /dev/null
+++ b/redis/_parsers/__init__.py
@@ -0,0 +1,20 @@
+from .base import BaseParser, _AsyncRESPBase
+from .commands import AsyncCommandsParser, CommandsParser
+from .encoders import Encoder
+from .hiredis import _AsyncHiredisParser, _HiredisParser
+from .resp2 import _AsyncRESP2Parser, _RESP2Parser
+from .resp3 import _AsyncRESP3Parser, _RESP3Parser
+
+__all__ = [
+    "AsyncCommandsParser",
+    "_AsyncHiredisParser",
+    "_AsyncRESPBase",
+    "_AsyncRESP2Parser",
+    "_AsyncRESP3Parser",
+    "CommandsParser",
+    "Encoder",
+    "BaseParser",
+    "_HiredisParser",
+    "_RESP2Parser",
+    "_RESP3Parser",
+]
diff --git a/redis/_parsers/base.py b/redis/_parsers/base.py
new file mode 100644
index 0000000000..f77296df6a
--- /dev/null
+++ b/redis/_parsers/base.py
@@ -0,0 +1,232 @@
+import sys
+from abc import ABC
+from asyncio import IncompleteReadError, StreamReader, TimeoutError
+from typing import List, Optional, Union
+
+if sys.version_info.major >= 3 and sys.version_info.minor >= 11:
+    from asyncio import timeout as async_timeout
+else:
+    from async_timeout import timeout as async_timeout
+
+from ..exceptions import (
+    AuthenticationError,
+    AuthenticationWrongNumberOfArgsError,
+    BusyLoadingError,
+    ConnectionError,
+    ExecAbortError,
+    ModuleError,
+    NoPermissionError,
+    NoScriptError,
+    OutOfMemoryError,
+    ReadOnlyError,
+    RedisError,
+    ResponseError,
+)
+from ..typing import EncodableT
+from .encoders import Encoder
+from .socket import SERVER_CLOSED_CONNECTION_ERROR, SocketBuffer
+
+MODULE_LOAD_ERROR = "Error loading the extension. " "Please check the server logs."
+NO_SUCH_MODULE_ERROR = "Error unloading module: no such module with that name"
+MODULE_UNLOAD_NOT_POSSIBLE_ERROR = "Error unloading module: operation not " "possible."
+MODULE_EXPORTS_DATA_TYPES_ERROR = (
+    "Error unloading module: the module "
+    "exports one or more module-side data "
+    "types, can't unload"
+)
+# user send an AUTH cmd to a server without authorization configured
+NO_AUTH_SET_ERROR = {
+    # Redis >= 6.0
+    "AUTH <password> called without any password "
+    "configured for the default user. Are you sure "
+    "your configuration is correct?": AuthenticationError,
+    # Redis < 6.0
+    "Client sent AUTH, but no password is set": AuthenticationError,
+}
+
+
+class BaseParser(ABC):
+
+    EXCEPTION_CLASSES = {
+        "ERR": {
+            "max number of clients reached": ConnectionError,
+            "invalid password": AuthenticationError,
+            # some Redis server versions report invalid command syntax
+            # in lowercase
+            "wrong number of arguments "
+            "for 'auth' command": AuthenticationWrongNumberOfArgsError,
+            # some Redis server versions report invalid command syntax
+            # in uppercase
+            "wrong number of arguments "
+            "for 'AUTH' command": AuthenticationWrongNumberOfArgsError,
+            MODULE_LOAD_ERROR: ModuleError,
+            MODULE_EXPORTS_DATA_TYPES_ERROR: ModuleError,
+            NO_SUCH_MODULE_ERROR: ModuleError,
+            MODULE_UNLOAD_NOT_POSSIBLE_ERROR: ModuleError,
+            **NO_AUTH_SET_ERROR,
+        },
+        "OOM": OutOfMemoryError,
+        "WRONGPASS": AuthenticationError,
+        "EXECABORT": ExecAbortError,
+        "LOADING": BusyLoadingError,
+        "NOSCRIPT": NoScriptError,
+        "READONLY": ReadOnlyError,
+        "NOAUTH": AuthenticationError,
+        "NOPERM": NoPermissionError,
+    }
+
+    @classmethod
+    def parse_error(cls, response):
+        "Parse an error response"
+        error_code = response.split(" ")[0]
+        if error_code in cls.EXCEPTION_CLASSES:
+            response = response[len(error_code) + 1 :]
+            exception_class = cls.EXCEPTION_CLASSES[error_code]
+            if isinstance(exception_class, dict):
+                exception_class = exception_class.get(response, ResponseError)
+            return exception_class(response)
+        return ResponseError(response)
+
+    def on_disconnect(self):
+        raise NotImplementedError()
+
+    def on_connect(self, connection):
+        raise NotImplementedError()
+
+
+class _RESPBase(BaseParser):
+    """Base class for sync-based resp parsing"""
+
+    def __init__(self, socket_read_size):
+        self.socket_read_size = socket_read_size
+        self.encoder = None
+        self._sock = None
+        self._buffer = None
+
+    def __del__(self):
+        try:
+            self.on_disconnect()
+        except Exception:
+            pass
+
+    def on_connect(self, connection):
+        "Called when the socket connects"
+        self._sock = connection._sock
+        self._buffer = SocketBuffer(
+            self._sock, self.socket_read_size, connection.socket_timeout
+        )
+        self.encoder = connection.encoder
+
+    def on_disconnect(self):
+        "Called when the socket disconnects"
+        self._sock = None
+        if self._buffer is not None:
+            self._buffer.close()
+            self._buffer = None
+        self.encoder = None
+
+    def can_read(self, timeout):
+        return self._buffer and self._buffer.can_read(timeout)
+
+
+class AsyncBaseParser(BaseParser):
+    """Base parsing class for the python-backed async parser"""
+
+    __slots__ = "_stream", "_read_size"
+
+    def __init__(self, socket_read_size: int):
+        self._stream: Optional[StreamReader] = None
+        self._read_size = socket_read_size
+
+    def __del__(self):
+        try:
+            self.on_disconnect()
+        except Exception:
+            pass
+
+    async def can_read_destructive(self) -> bool:
+        raise NotImplementedError()
+
+    async def read_response(
+        self, disable_decoding: bool = False
+    ) -> Union[EncodableT, ResponseError, None, List[EncodableT]]:
+        raise NotImplementedError()
+
+
+class _AsyncRESPBase(AsyncBaseParser):
+    """Base class for async resp parsing"""
+
+    __slots__ = AsyncBaseParser.__slots__ + ("encoder", "_buffer", "_pos", "_chunks")
+
+    def __init__(self, socket_read_size: int):
+        super().__init__(socket_read_size)
+        self.encoder: Optional[Encoder] = None
+        self._buffer = b""
+        self._chunks = []
+        self._pos = 0
+
+    def _clear(self):
+        self._buffer = b""
+        self._chunks.clear()
+
+    def on_connect(self, connection):
+        """Called when the stream connects"""
+        self._stream = connection._reader
+        if self._stream is None:
+            raise RedisError("Buffer is closed.")
+        self.encoder = connection.encoder
+        self._clear()
+        self._connected = True
+
+    def on_disconnect(self):
+        """Called when the stream disconnects"""
+        self._connected = False
+
+    async def can_read_destructive(self) -> bool:
+        if not self._connected:
+            raise RedisError("Buffer is closed.")
+        if self._buffer:
+            return True
+        try:
+            async with async_timeout(0):
+                return await self._stream.read(1)
+        except TimeoutError:
+            return False
+
+    async def _read(self, length: int) -> bytes:
+        """
+        Read `length` bytes of data.  These are assumed to be followed
+        by a '\r\n' terminator which is subsequently discarded.
+        """
+        want = length + 2
+        end = self._pos + want
+        if len(self._buffer) >= end:
+            result = self._buffer[self._pos : end - 2]
+        else:
+            tail = self._buffer[self._pos :]
+            try:
+                data = await self._stream.readexactly(want - len(tail))
+            except IncompleteReadError as error:
+                raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR) from error
+            result = (tail + data)[:-2]
+            self._chunks.append(data)
+        self._pos += want
+        return result
+
+    async def _readline(self) -> bytes:
+        """
+        read an unknown number of bytes up to the next '\r\n'
+        line separator, which is discarded.
+        """
+        found = self._buffer.find(b"\r\n", self._pos)
+        if found >= 0:
+            result = self._buffer[self._pos : found]
+        else:
+            tail = self._buffer[self._pos :]
+            data = await self._stream.readline()
+            if not data.endswith(b"\r\n"):
+                raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
+            result = (tail + data)[:-2]
+            self._chunks.append(data)
+        self._pos += len(result) + 2
+        return result
diff --git a/redis/commands/parser.py b/redis/_parsers/commands.py
similarity index 62%
rename from redis/commands/parser.py
rename to redis/_parsers/commands.py
index 115230a9d2..d3b4a99ed3 100644
--- a/redis/commands/parser.py
+++ b/redis/_parsers/commands.py
@@ -1,6 +1,11 @@
+from typing import TYPE_CHECKING, Any, Dict, Optional, Tuple, Union
+
 from redis.exceptions import RedisError, ResponseError
 from redis.utils import str_if_bytes
 
+if TYPE_CHECKING:
+    from redis.asyncio.cluster import ClusterNode
+
 
 class CommandsParser:
     """
@@ -16,7 +21,7 @@ def __init__(self, redis_connection):
         self.initialize(redis_connection)
 
     def initialize(self, r):
-        commands = r.execute_command("COMMAND")
+        commands = r.command()
         uppercase_commands = []
         for cmd in commands:
             if any(x.isupper() for x in cmd):
@@ -117,12 +122,9 @@ def _get_moveable_keys(self, redis_conn, *args):
 
         So, don't use this function with EVAL or EVALSHA.
         """
-        pieces = []
-        cmd_name = args[0]
         # The command name should be splitted into separate arguments,
         # e.g. 'MEMORY USAGE' will be splitted into ['MEMORY', 'USAGE']
-        pieces = pieces + cmd_name.split()
-        pieces = pieces + list(args[1:])
+        pieces = args[0].split() + list(args[1:])
         try:
             keys = redis_conn.execute_command("COMMAND GETKEYS", *pieces)
         except ResponseError as e:
@@ -153,14 +155,102 @@ def _get_pubsub_keys(self, *args):
             # the second argument is a part of the command name, e.g.
             # ['PUBSUB', 'NUMSUB', 'foo'].
             pubsub_type = args[1].upper()
-            if pubsub_type in ["CHANNELS", "NUMSUB"]:
+            if pubsub_type in ["CHANNELS", "NUMSUB", "SHARDCHANNELS", "SHARDNUMSUB"]:
                 keys = args[2:]
         elif command in ["SUBSCRIBE", "PSUBSCRIBE", "UNSUBSCRIBE", "PUNSUBSCRIBE"]:
             # format example:
             # SUBSCRIBE channel [channel ...]
             keys = list(args[1:])
-        elif command == "PUBLISH":
+        elif command in ["PUBLISH", "SPUBLISH"]:
             # format example:
             # PUBLISH channel message
             keys = [args[1]]
         return keys
+
+
+class AsyncCommandsParser:
+    """
+    Parses Redis commands to get command keys.
+
+    COMMAND output is used to determine key locations.
+    Commands that do not have a predefined key location are flagged with 'movablekeys',
+    and these commands' keys are determined by the command 'COMMAND GETKEYS'.
+
+    NOTE: Due to a bug in redis<7.0, this does not work properly
+    for EVAL or EVALSHA when the `numkeys` arg is 0.
+     - issue: https://github.com/redis/redis/issues/9493
+     - fix: https://github.com/redis/redis/pull/9733
+
+    So, don't use this with EVAL or EVALSHA.
+    """
+
+    __slots__ = ("commands", "node")
+
+    def __init__(self) -> None:
+        self.commands: Dict[str, Union[int, Dict[str, Any]]] = {}
+
+    async def initialize(self, node: Optional["ClusterNode"] = None) -> None:
+        if node:
+            self.node = node
+
+        commands = await self.node.execute_command("COMMAND")
+        for cmd, command in commands.items():
+            if "movablekeys" in command["flags"]:
+                commands[cmd] = -1
+            elif command["first_key_pos"] == 0 and command["last_key_pos"] == 0:
+                commands[cmd] = 0
+            elif command["first_key_pos"] == 1 and command["last_key_pos"] == 1:
+                commands[cmd] = 1
+        self.commands = {cmd.upper(): command for cmd, command in commands.items()}
+
+    # As soon as this PR is merged into Redis, we should reimplement
+    # our logic to use COMMAND INFO changes to determine the key positions
+    # https://github.com/redis/redis/pull/8324
+    async def get_keys(self, *args: Any) -> Optional[Tuple[str, ...]]:
+        if len(args) < 2:
+            # The command has no keys in it
+            return None
+
+        try:
+            command = self.commands[args[0]]
+        except KeyError:
+            # try to split the command name and to take only the main command
+            # e.g. 'memory' for 'memory usage'
+            args = args[0].split() + list(args[1:])
+            cmd_name = args[0].upper()
+            if cmd_name not in self.commands:
+                # We'll try to reinitialize the commands cache, if the engine
+                # version has changed, the commands may not be current
+                await self.initialize()
+                if cmd_name not in self.commands:
+                    raise RedisError(
+                        f"{cmd_name} command doesn't exist in Redis commands"
+                    )
+
+            command = self.commands[cmd_name]
+
+        if command == 1:
+            return (args[1],)
+        if command == 0:
+            return None
+        if command == -1:
+            return await self._get_moveable_keys(*args)
+
+        last_key_pos = command["last_key_pos"]
+        if last_key_pos < 0:
+            last_key_pos = len(args) + last_key_pos
+        return args[command["first_key_pos"] : last_key_pos + 1 : command["step_count"]]
+
+    async def _get_moveable_keys(self, *args: Any) -> Optional[Tuple[str, ...]]:
+        try:
+            keys = await self.node.execute_command("COMMAND GETKEYS", *args)
+        except ResponseError as e:
+            message = e.__str__()
+            if (
+                "Invalid arguments" in message
+                or "The command has no key arguments" in message
+            ):
+                return None
+            else:
+                raise e
+        return keys
diff --git a/redis/_parsers/encoders.py b/redis/_parsers/encoders.py
new file mode 100644
index 0000000000..6fdf0ad882
--- /dev/null
+++ b/redis/_parsers/encoders.py
@@ -0,0 +1,44 @@
+from ..exceptions import DataError
+
+
+class Encoder:
+    "Encode strings to bytes-like and decode bytes-like to strings"
+
+    __slots__ = "encoding", "encoding_errors", "decode_responses"
+
+    def __init__(self, encoding, encoding_errors, decode_responses):
+        self.encoding = encoding
+        self.encoding_errors = encoding_errors
+        self.decode_responses = decode_responses
+
+    def encode(self, value):
+        "Return a bytestring or bytes-like representation of the value"
+        if isinstance(value, (bytes, memoryview)):
+            return value
+        elif isinstance(value, bool):
+            # special case bool since it is a subclass of int
+            raise DataError(
+                "Invalid input of type: 'bool'. Convert to a "
+                "bytes, string, int or float first."
+            )
+        elif isinstance(value, (int, float)):
+            value = repr(value).encode()
+        elif not isinstance(value, str):
+            # a value we don't know how to deal with. throw an error
+            typename = type(value).__name__
+            raise DataError(
+                f"Invalid input of type: '{typename}'. "
+                f"Convert to a bytes, string, int or float first."
+            )
+        if isinstance(value, str):
+            value = value.encode(self.encoding, self.encoding_errors)
+        return value
+
+    def decode(self, value, force=False):
+        "Return a unicode string from the bytes-like representation"
+        if self.decode_responses or force:
+            if isinstance(value, memoryview):
+                value = value.tobytes()
+            if isinstance(value, bytes):
+                value = value.decode(self.encoding, self.encoding_errors)
+        return value
diff --git a/redis/_parsers/helpers.py b/redis/_parsers/helpers.py
new file mode 100644
index 0000000000..f27e3b12c0
--- /dev/null
+++ b/redis/_parsers/helpers.py
@@ -0,0 +1,851 @@
+import datetime
+
+from redis.utils import str_if_bytes
+
+
+def timestamp_to_datetime(response):
+    "Converts a unix timestamp to a Python datetime object"
+    if not response:
+        return None
+    try:
+        response = int(response)
+    except ValueError:
+        return None
+    return datetime.datetime.fromtimestamp(response)
+
+
+def parse_debug_object(response):
+    "Parse the results of Redis's DEBUG OBJECT command into a Python dict"
+    # The 'type' of the object is the first item in the response, but isn't
+    # prefixed with a name
+    response = str_if_bytes(response)
+    response = "type:" + response
+    response = dict(kv.split(":") for kv in response.split())
+
+    # parse some expected int values from the string response
+    # note: this cmd isn't spec'd so these may not appear in all redis versions
+    int_fields = ("refcount", "serializedlength", "lru", "lru_seconds_idle")
+    for field in int_fields:
+        if field in response:
+            response[field] = int(response[field])
+
+    return response
+
+
+def parse_info(response):
+    """Parse the result of Redis's INFO command into a Python dict"""
+    info = {}
+    response = str_if_bytes(response)
+
+    def get_value(value):
+        if "," not in value or "=" not in value:
+            try:
+                if "." in value:
+                    return float(value)
+                else:
+                    return int(value)
+            except ValueError:
+                return value
+        else:
+            sub_dict = {}
+            for item in value.split(","):
+                k, v = item.rsplit("=", 1)
+                sub_dict[k] = get_value(v)
+            return sub_dict
+
+    for line in response.splitlines():
+        if line and not line.startswith("#"):
+            if line.find(":") != -1:
+                # Split, the info fields keys and values.
+                # Note that the value may contain ':'. but the 'host:'
+                # pseudo-command is the only case where the key contains ':'
+                key, value = line.split(":", 1)
+                if key == "cmdstat_host":
+                    key, value = line.rsplit(":", 1)
+
+                if key == "module":
+                    # Hardcode a list for key 'modules' since there could be
+                    # multiple lines that started with 'module'
+                    info.setdefault("modules", []).append(get_value(value))
+                else:
+                    info[key] = get_value(value)
+            else:
+                # if the line isn't splittable, append it to the "__raw__" key
+                info.setdefault("__raw__", []).append(line)
+
+    return info
+
+
+def parse_memory_stats(response, **kwargs):
+    """Parse the results of MEMORY STATS"""
+    stats = pairs_to_dict(response, decode_keys=True, decode_string_values=True)
+    for key, value in stats.items():
+        if key.startswith("db."):
+            stats[key] = pairs_to_dict(
+                value, decode_keys=True, decode_string_values=True
+            )
+    return stats
+
+
+SENTINEL_STATE_TYPES = {
+    "can-failover-its-master": int,
+    "config-epoch": int,
+    "down-after-milliseconds": int,
+    "failover-timeout": int,
+    "info-refresh": int,
+    "last-hello-message": int,
+    "last-ok-ping-reply": int,
+    "last-ping-reply": int,
+    "last-ping-sent": int,
+    "master-link-down-time": int,
+    "master-port": int,
+    "num-other-sentinels": int,
+    "num-slaves": int,
+    "o-down-time": int,
+    "pending-commands": int,
+    "parallel-syncs": int,
+    "port": int,
+    "quorum": int,
+    "role-reported-time": int,
+    "s-down-time": int,
+    "slave-priority": int,
+    "slave-repl-offset": int,
+    "voted-leader-epoch": int,
+}
+
+
+def parse_sentinel_state(item):
+    result = pairs_to_dict_typed(item, SENTINEL_STATE_TYPES)
+    flags = set(result["flags"].split(","))
+    for name, flag in (
+        ("is_master", "master"),
+        ("is_slave", "slave"),
+        ("is_sdown", "s_down"),
+        ("is_odown", "o_down"),
+        ("is_sentinel", "sentinel"),
+        ("is_disconnected", "disconnected"),
+        ("is_master_down", "master_down"),
+    ):
+        result[name] = flag in flags
+    return result
+
+
+def parse_sentinel_master(response):
+    return parse_sentinel_state(map(str_if_bytes, response))
+
+
+def parse_sentinel_state_resp3(response):
+    result = {}
+    for key in response:
+        try:
+            value = SENTINEL_STATE_TYPES[key](str_if_bytes(response[key]))
+            result[str_if_bytes(key)] = value
+        except Exception:
+            result[str_if_bytes(key)] = response[str_if_bytes(key)]
+    flags = set(result["flags"].split(","))
+    result["flags"] = flags
+    return result
+
+
+def parse_sentinel_masters(response):
+    result = {}
+    for item in response:
+        state = parse_sentinel_state(map(str_if_bytes, item))
+        result[state["name"]] = state
+    return result
+
+
+def parse_sentinel_masters_resp3(response):
+    return [parse_sentinel_state(master) for master in response]
+
+
+def parse_sentinel_slaves_and_sentinels(response):
+    return [parse_sentinel_state(map(str_if_bytes, item)) for item in response]
+
+
+def parse_sentinel_slaves_and_sentinels_resp3(response):
+    return [parse_sentinel_state_resp3(item) for item in response]
+
+
+def parse_sentinel_get_master(response):
+    return response and (response[0], int(response[1])) or None
+
+
+def pairs_to_dict(response, decode_keys=False, decode_string_values=False):
+    """Create a dict given a list of key/value pairs"""
+    if response is None:
+        return {}
+    if decode_keys or decode_string_values:
+        # the iter form is faster, but I don't know how to make that work
+        # with a str_if_bytes() map
+        keys = response[::2]
+        if decode_keys:
+            keys = map(str_if_bytes, keys)
+        values = response[1::2]
+        if decode_string_values:
+            values = map(str_if_bytes, values)
+        return dict(zip(keys, values))
+    else:
+        it = iter(response)
+        return dict(zip(it, it))
+
+
+def pairs_to_dict_typed(response, type_info):
+    it = iter(response)
+    result = {}
+    for key, value in zip(it, it):
+        if key in type_info:
+            try:
+                value = type_info[key](value)
+            except Exception:
+                # if for some reason the value can't be coerced, just use
+                # the string value
+                pass
+        result[key] = value
+    return result
+
+
+def zset_score_pairs(response, **options):
+    """
+    If ``withscores`` is specified in the options, return the response as
+    a list of (value, score) pairs
+    """
+    if not response or not options.get("withscores"):
+        return response
+    score_cast_func = options.get("score_cast_func", float)
+    it = iter(response)
+    return list(zip(it, map(score_cast_func, it)))
+
+
+def sort_return_tuples(response, **options):
+    """
+    If ``groups`` is specified, return the response as a list of
+    n-element tuples with n being the value found in options['groups']
+    """
+    if not response or not options.get("groups"):
+        return response
+    n = options["groups"]
+    return list(zip(*[response[i::n] for i in range(n)]))
+
+
+def parse_stream_list(response):
+    if response is None:
+        return None
+    data = []
+    for r in response:
+        if r is not None:
+            data.append((r[0], pairs_to_dict(r[1])))
+        else:
+            data.append((None, None))
+    return data
+
+
+def pairs_to_dict_with_str_keys(response):
+    return pairs_to_dict(response, decode_keys=True)
+
+
+def parse_list_of_dicts(response):
+    return list(map(pairs_to_dict_with_str_keys, response))
+
+
+def parse_xclaim(response, **options):
+    if options.get("parse_justid", False):
+        return response
+    return parse_stream_list(response)
+
+
+def parse_xautoclaim(response, **options):
+    if options.get("parse_justid", False):
+        return response[1]
+    response[1] = parse_stream_list(response[1])
+    return response
+
+
+def parse_xinfo_stream(response, **options):
+    if isinstance(response, list):
+        data = pairs_to_dict(response, decode_keys=True)
+    else:
+        data = {str_if_bytes(k): v for k, v in response.items()}
+    if not options.get("full", False):
+        first = data.get("first-entry")
+        if first is not None:
+            data["first-entry"] = (first[0], pairs_to_dict(first[1]))
+        last = data["last-entry"]
+        if last is not None:
+            data["last-entry"] = (last[0], pairs_to_dict(last[1]))
+    else:
+        data["entries"] = {_id: pairs_to_dict(entry) for _id, entry in data["entries"]}
+        if isinstance(data["groups"][0], list):
+            data["groups"] = [
+                pairs_to_dict(group, decode_keys=True) for group in data["groups"]
+            ]
+        else:
+            data["groups"] = [
+                {str_if_bytes(k): v for k, v in group.items()}
+                for group in data["groups"]
+            ]
+    return data
+
+
+def parse_xread(response):
+    if response is None:
+        return []
+    return [[r[0], parse_stream_list(r[1])] for r in response]
+
+
+def parse_xread_resp3(response):
+    if response is None:
+        return {}
+    return {key: [parse_stream_list(value)] for key, value in response.items()}
+
+
+def parse_xpending(response, **options):
+    if options.get("parse_detail", False):
+        return parse_xpending_range(response)
+    consumers = [{"name": n, "pending": int(p)} for n, p in response[3] or []]
+    return {
+        "pending": response[0],
+        "min": response[1],
+        "max": response[2],
+        "consumers": consumers,
+    }
+
+
+def parse_xpending_range(response):
+    k = ("message_id", "consumer", "time_since_delivered", "times_delivered")
+    return [dict(zip(k, r)) for r in response]
+
+
+def float_or_none(response):
+    if response is None:
+        return None
+    return float(response)
+
+
+def bool_ok(response):
+    return str_if_bytes(response) == "OK"
+
+
+def parse_zadd(response, **options):
+    if response is None:
+        return None
+    if options.get("as_score"):
+        return float(response)
+    return int(response)
+
+
+def parse_client_list(response, **options):
+    clients = []
+    for c in str_if_bytes(response).splitlines():
+        # Values might contain '='
+        clients.append(dict(pair.split("=", 1) for pair in c.split(" ")))
+    return clients
+
+
+def parse_config_get(response, **options):
+    response = [str_if_bytes(i) if i is not None else None for i in response]
+    return response and pairs_to_dict(response) or {}
+
+
+def parse_scan(response, **options):
+    cursor, r = response
+    return int(cursor), r
+
+
+def parse_hscan(response, **options):
+    cursor, r = response
+    return int(cursor), r and pairs_to_dict(r) or {}
+
+
+def parse_zscan(response, **options):
+    score_cast_func = options.get("score_cast_func", float)
+    cursor, r = response
+    it = iter(r)
+    return int(cursor), list(zip(it, map(score_cast_func, it)))
+
+
+def parse_zmscore(response, **options):
+    # zmscore: list of scores (double precision floating point number) or nil
+    return [float(score) if score is not None else None for score in response]
+
+
+def parse_slowlog_get(response, **options):
+    space = " " if options.get("decode_responses", False) else b" "
+
+    def parse_item(item):
+        result = {"id": item[0], "start_time": int(item[1]), "duration": int(item[2])}
+        # Redis Enterprise injects another entry at index [3], which has
+        # the complexity info (i.e. the value N in case the command has
+        # an O(N) complexity) instead of the command.
+        if isinstance(item[3], list):
+            result["command"] = space.join(item[3])
+            result["client_address"] = item[4]
+            result["client_name"] = item[5]
+        else:
+            result["complexity"] = item[3]
+            result["command"] = space.join(item[4])
+            result["client_address"] = item[5]
+            result["client_name"] = item[6]
+        return result
+
+    return [parse_item(item) for item in response]
+
+
+def parse_stralgo(response, **options):
+    """
+    Parse the response from `STRALGO` command.
+    Without modifiers the returned value is string.
+    When LEN is given the command returns the length of the result
+    (i.e integer).
+    When IDX is given the command returns a dictionary with the LCS
+    length and all the ranges in both the strings, start and end
+    offset for each string, where there are matches.
+    When WITHMATCHLEN is given, each array representing a match will
+    also have the length of the match at the beginning of the array.
+    """
+    if options.get("len", False):
+        return int(response)
+    if options.get("idx", False):
+        if options.get("withmatchlen", False):
+            matches = [
+                [(int(match[-1]))] + list(map(tuple, match[:-1]))
+                for match in response[1]
+            ]
+        else:
+            matches = [list(map(tuple, match)) for match in response[1]]
+        return {
+            str_if_bytes(response[0]): matches,
+            str_if_bytes(response[2]): int(response[3]),
+        }
+    return str_if_bytes(response)
+
+
+def parse_cluster_info(response, **options):
+    response = str_if_bytes(response)
+    return dict(line.split(":") for line in response.splitlines() if line)
+
+
+def _parse_node_line(line):
+    line_items = line.split(" ")
+    node_id, addr, flags, master_id, ping, pong, epoch, connected = line.split(" ")[:8]
+    addr = addr.split("@")[0]
+    node_dict = {
+        "node_id": node_id,
+        "flags": flags,
+        "master_id": master_id,
+        "last_ping_sent": ping,
+        "last_pong_rcvd": pong,
+        "epoch": epoch,
+        "slots": [],
+        "migrations": [],
+        "connected": True if connected == "connected" else False,
+    }
+    if len(line_items) >= 9:
+        slots, migrations = _parse_slots(line_items[8:])
+        node_dict["slots"], node_dict["migrations"] = slots, migrations
+    return addr, node_dict
+
+
+def _parse_slots(slot_ranges):
+    slots, migrations = [], []
+    for s_range in slot_ranges:
+        if "->-" in s_range:
+            slot_id, dst_node_id = s_range[1:-1].split("->-", 1)
+            migrations.append(
+                {"slot": slot_id, "node_id": dst_node_id, "state": "migrating"}
+            )
+        elif "-<-" in s_range:
+            slot_id, src_node_id = s_range[1:-1].split("-<-", 1)
+            migrations.append(
+                {"slot": slot_id, "node_id": src_node_id, "state": "importing"}
+            )
+        else:
+            s_range = [sl for sl in s_range.split("-")]
+            slots.append(s_range)
+
+    return slots, migrations
+
+
+def parse_cluster_nodes(response, **options):
+    """
+    @see: https://redis.io/commands/cluster-nodes  # string / bytes
+    @see: https://redis.io/commands/cluster-replicas # list of string / bytes
+    """
+    if isinstance(response, (str, bytes)):
+        response = response.splitlines()
+    return dict(_parse_node_line(str_if_bytes(node)) for node in response)
+
+
+def parse_geosearch_generic(response, **options):
+    """
+    Parse the response of 'GEOSEARCH', GEORADIUS' and 'GEORADIUSBYMEMBER'
+    commands according to 'withdist', 'withhash' and 'withcoord' labels.
+    """
+    try:
+        if options["store"] or options["store_dist"]:
+            # `store` and `store_dist` cant be combined
+            # with other command arguments.
+            # relevant to 'GEORADIUS' and 'GEORADIUSBYMEMBER'
+            return response
+    except KeyError:  # it means the command was sent via execute_command
+        return response
+
+    if type(response) != list:
+        response_list = [response]
+    else:
+        response_list = response
+
+    if not options["withdist"] and not options["withcoord"] and not options["withhash"]:
+        # just a bunch of places
+        return response_list
+
+    cast = {
+        "withdist": float,
+        "withcoord": lambda ll: (float(ll[0]), float(ll[1])),
+        "withhash": int,
+    }
+
+    # zip all output results with each casting function to get
+    # the properly native Python value.
+    f = [lambda x: x]
+    f += [cast[o] for o in ["withdist", "withhash", "withcoord"] if options[o]]
+    return [list(map(lambda fv: fv[0](fv[1]), zip(f, r))) for r in response_list]
+
+
+def parse_command(response, **options):
+    commands = {}
+    for command in response:
+        cmd_dict = {}
+        cmd_name = str_if_bytes(command[0])
+        cmd_dict["name"] = cmd_name
+        cmd_dict["arity"] = int(command[1])
+        cmd_dict["flags"] = [str_if_bytes(flag) for flag in command[2]]
+        cmd_dict["first_key_pos"] = command[3]
+        cmd_dict["last_key_pos"] = command[4]
+        cmd_dict["step_count"] = command[5]
+        if len(command) > 7:
+            cmd_dict["tips"] = command[7]
+            cmd_dict["key_specifications"] = command[8]
+            cmd_dict["subcommands"] = command[9]
+        commands[cmd_name] = cmd_dict
+    return commands
+
+
+def parse_command_resp3(response, **options):
+    commands = {}
+    for command in response:
+        cmd_dict = {}
+        cmd_name = str_if_bytes(command[0])
+        cmd_dict["name"] = cmd_name
+        cmd_dict["arity"] = command[1]
+        cmd_dict["flags"] = {str_if_bytes(flag) for flag in command[2]}
+        cmd_dict["first_key_pos"] = command[3]
+        cmd_dict["last_key_pos"] = command[4]
+        cmd_dict["step_count"] = command[5]
+        cmd_dict["acl_categories"] = command[6]
+        if len(command) > 7:
+            cmd_dict["tips"] = command[7]
+            cmd_dict["key_specifications"] = command[8]
+            cmd_dict["subcommands"] = command[9]
+
+        commands[cmd_name] = cmd_dict
+    return commands
+
+
+def parse_pubsub_numsub(response, **options):
+    return list(zip(response[0::2], response[1::2]))
+
+
+def parse_client_kill(response, **options):
+    if isinstance(response, int):
+        return response
+    return str_if_bytes(response) == "OK"
+
+
+def parse_acl_getuser(response, **options):
+    if response is None:
+        return None
+    if isinstance(response, list):
+        data = pairs_to_dict(response, decode_keys=True)
+    else:
+        data = {str_if_bytes(key): value for key, value in response.items()}
+
+    # convert everything but user-defined data in 'keys' to native strings
+    data["flags"] = list(map(str_if_bytes, data["flags"]))
+    data["passwords"] = list(map(str_if_bytes, data["passwords"]))
+    data["commands"] = str_if_bytes(data["commands"])
+    if isinstance(data["keys"], str) or isinstance(data["keys"], bytes):
+        data["keys"] = list(str_if_bytes(data["keys"]).split(" "))
+    if data["keys"] == [""]:
+        data["keys"] = []
+    if "channels" in data:
+        if isinstance(data["channels"], str) or isinstance(data["channels"], bytes):
+            data["channels"] = list(str_if_bytes(data["channels"]).split(" "))
+        if data["channels"] == [""]:
+            data["channels"] = []
+    if "selectors" in data:
+        if data["selectors"] != [] and isinstance(data["selectors"][0], list):
+            data["selectors"] = [
+                list(map(str_if_bytes, selector)) for selector in data["selectors"]
+            ]
+        elif data["selectors"] != []:
+            data["selectors"] = [
+                {str_if_bytes(k): str_if_bytes(v) for k, v in selector.items()}
+                for selector in data["selectors"]
+            ]
+
+    # split 'commands' into separate 'categories' and 'commands' lists
+    commands, categories = [], []
+    for command in data["commands"].split(" "):
+        categories.append(command) if "@" in command else commands.append(command)
+
+    data["commands"] = commands
+    data["categories"] = categories
+    data["enabled"] = "on" in data["flags"]
+    return data
+
+
+def parse_acl_log(response, **options):
+    if response is None:
+        return None
+    if isinstance(response, list):
+        data = []
+        for log in response:
+            log_data = pairs_to_dict(log, True, True)
+            client_info = log_data.get("client-info", "")
+            log_data["client-info"] = parse_client_info(client_info)
+
+            # float() is lossy comparing to the "double" in C
+            log_data["age-seconds"] = float(log_data["age-seconds"])
+            data.append(log_data)
+    else:
+        data = bool_ok(response)
+    return data
+
+
+def parse_client_info(value):
+    """
+    Parsing client-info in ACL Log in following format.
+    "key1=value1 key2=value2 key3=value3"
+    """
+    client_info = {}
+    infos = str_if_bytes(value).split(" ")
+    for info in infos:
+        key, value = info.split("=")
+        client_info[key] = value
+
+    # Those fields are defined as int in networking.c
+    for int_key in {
+        "id",
+        "age",
+        "idle",
+        "db",
+        "sub",
+        "psub",
+        "multi",
+        "qbuf",
+        "qbuf-free",
+        "obl",
+        "argv-mem",
+        "oll",
+        "omem",
+        "tot-mem",
+    }:
+        client_info[int_key] = int(client_info[int_key])
+    return client_info
+
+
+def parse_set_result(response, **options):
+    """
+    Handle SET result since GET argument is available since Redis 6.2.
+    Parsing SET result into:
+    - BOOL
+    - String when GET argument is used
+    """
+    if options.get("get"):
+        # Redis will return a getCommand result.
+        # See `setGenericCommand` in t_string.c
+        return response
+    return response and str_if_bytes(response) == "OK"
+
+
+def string_keys_to_dict(key_string, callback):
+    return dict.fromkeys(key_string.split(), callback)
+
+
+_RedisCallbacks = {
+    **string_keys_to_dict(
+        "AUTH COPY EXPIRE EXPIREAT HEXISTS HMSET MOVE MSETNX PERSIST PSETEX "
+        "PEXPIRE PEXPIREAT RENAMENX SETEX SETNX SMOVE",
+        bool,
+    ),
+    **string_keys_to_dict("HINCRBYFLOAT INCRBYFLOAT", float),
+    **string_keys_to_dict(
+        "ASKING FLUSHALL FLUSHDB LSET LTRIM MSET PFMERGE READONLY READWRITE "
+        "RENAME SAVE SELECT SHUTDOWN SLAVEOF SWAPDB WATCH UNWATCH",
+        bool_ok,
+    ),
+    **string_keys_to_dict("XREAD XREADGROUP", parse_xread),
+    **string_keys_to_dict(
+        "GEORADIUS GEORADIUSBYMEMBER GEOSEARCH",
+        parse_geosearch_generic,
+    ),
+    **string_keys_to_dict("XRANGE XREVRANGE", parse_stream_list),
+    "ACL GETUSER": parse_acl_getuser,
+    "ACL LOAD": bool_ok,
+    "ACL LOG": parse_acl_log,
+    "ACL SETUSER": bool_ok,
+    "ACL SAVE": bool_ok,
+    "CLIENT INFO": parse_client_info,
+    "CLIENT KILL": parse_client_kill,
+    "CLIENT LIST": parse_client_list,
+    "CLIENT PAUSE": bool_ok,
+    "CLIENT SETNAME": bool_ok,
+    "CLIENT UNBLOCK": bool,
+    "CLUSTER ADDSLOTS": bool_ok,
+    "CLUSTER ADDSLOTSRANGE": bool_ok,
+    "CLUSTER DELSLOTS": bool_ok,
+    "CLUSTER DELSLOTSRANGE": bool_ok,
+    "CLUSTER FAILOVER": bool_ok,
+    "CLUSTER FORGET": bool_ok,
+    "CLUSTER INFO": parse_cluster_info,
+    "CLUSTER MEET": bool_ok,
+    "CLUSTER NODES": parse_cluster_nodes,
+    "CLUSTER REPLICAS": parse_cluster_nodes,
+    "CLUSTER REPLICATE": bool_ok,
+    "CLUSTER RESET": bool_ok,
+    "CLUSTER SAVECONFIG": bool_ok,
+    "CLUSTER SET-CONFIG-EPOCH": bool_ok,
+    "CLUSTER SETSLOT": bool_ok,
+    "CLUSTER SLAVES": parse_cluster_nodes,
+    "COMMAND": parse_command,
+    "CONFIG RESETSTAT": bool_ok,
+    "CONFIG SET": bool_ok,
+    "FUNCTION DELETE": bool_ok,
+    "FUNCTION FLUSH": bool_ok,
+    "FUNCTION RESTORE": bool_ok,
+    "GEODIST": float_or_none,
+    "HSCAN": parse_hscan,
+    "INFO": parse_info,
+    "LASTSAVE": timestamp_to_datetime,
+    "MEMORY PURGE": bool_ok,
+    "MODULE LOAD": bool,
+    "MODULE UNLOAD": bool,
+    "PING": lambda r: str_if_bytes(r) == "PONG",
+    "PUBSUB NUMSUB": parse_pubsub_numsub,
+    "QUIT": bool_ok,
+    "SET": parse_set_result,
+    "SCAN": parse_scan,
+    "SCRIPT EXISTS": lambda r: list(map(bool, r)),
+    "SCRIPT FLUSH": bool_ok,
+    "SCRIPT KILL": bool_ok,
+    "SCRIPT LOAD": str_if_bytes,
+    "SENTINEL CKQUORUM": bool_ok,
+    "SENTINEL FAILOVER": bool_ok,
+    "SENTINEL FLUSHCONFIG": bool_ok,
+    "SENTINEL GET-MASTER-ADDR-BY-NAME": parse_sentinel_get_master,
+    "SENTINEL MONITOR": bool_ok,
+    "SENTINEL RESET": bool_ok,
+    "SENTINEL REMOVE": bool_ok,
+    "SENTINEL SET": bool_ok,
+    "SLOWLOG GET": parse_slowlog_get,
+    "SLOWLOG RESET": bool_ok,
+    "SORT": sort_return_tuples,
+    "SSCAN": parse_scan,
+    "TIME": lambda x: (int(x[0]), int(x[1])),
+    "XAUTOCLAIM": parse_xautoclaim,
+    "XCLAIM": parse_xclaim,
+    "XGROUP CREATE": bool_ok,
+    "XGROUP DESTROY": bool,
+    "XGROUP SETID": bool_ok,
+    "XINFO STREAM": parse_xinfo_stream,
+    "XPENDING": parse_xpending,
+    "ZSCAN": parse_zscan,
+}
+
+
+_RedisCallbacksRESP2 = {
+    **string_keys_to_dict(
+        "SDIFF SINTER SMEMBERS SUNION", lambda r: r and set(r) or set()
+    ),
+    **string_keys_to_dict(
+        "ZDIFF ZINTER ZPOPMAX ZPOPMIN ZRANGE ZRANGEBYSCORE ZRANK ZREVRANGE "
+        "ZREVRANGEBYSCORE ZREVRANK ZUNION",
+        zset_score_pairs,
+    ),
+    **string_keys_to_dict("ZINCRBY ZSCORE", float_or_none),
+    **string_keys_to_dict("BGREWRITEAOF BGSAVE", lambda r: True),
+    **string_keys_to_dict("BLPOP BRPOP", lambda r: r and tuple(r) or None),
+    **string_keys_to_dict(
+        "BZPOPMAX BZPOPMIN", lambda r: r and (r[0], r[1], float(r[2])) or None
+    ),
+    "ACL CAT": lambda r: list(map(str_if_bytes, r)),
+    "ACL GENPASS": str_if_bytes,
+    "ACL HELP": lambda r: list(map(str_if_bytes, r)),
+    "ACL LIST": lambda r: list(map(str_if_bytes, r)),
+    "ACL USERS": lambda r: list(map(str_if_bytes, r)),
+    "ACL WHOAMI": str_if_bytes,
+    "CLIENT GETNAME": str_if_bytes,
+    "CLIENT TRACKINGINFO": lambda r: list(map(str_if_bytes, r)),
+    "CLUSTER GETKEYSINSLOT": lambda r: list(map(str_if_bytes, r)),
+    "COMMAND GETKEYS": lambda r: list(map(str_if_bytes, r)),
+    "CONFIG GET": parse_config_get,
+    "DEBUG OBJECT": parse_debug_object,
+    "GEOHASH": lambda r: list(map(str_if_bytes, r)),
+    "GEOPOS": lambda r: list(
+        map(lambda ll: (float(ll[0]), float(ll[1])) if ll is not None else None, r)
+    ),
+    "HGETALL": lambda r: r and pairs_to_dict(r) or {},
+    "MEMORY STATS": parse_memory_stats,
+    "MODULE LIST": lambda r: [pairs_to_dict(m) for m in r],
+    "RESET": str_if_bytes,
+    "SENTINEL MASTER": parse_sentinel_master,
+    "SENTINEL MASTERS": parse_sentinel_masters,
+    "SENTINEL SENTINELS": parse_sentinel_slaves_and_sentinels,
+    "SENTINEL SLAVES": parse_sentinel_slaves_and_sentinels,
+    "STRALGO": parse_stralgo,
+    "XINFO CONSUMERS": parse_list_of_dicts,
+    "XINFO GROUPS": parse_list_of_dicts,
+    "ZADD": parse_zadd,
+    "ZMSCORE": parse_zmscore,
+}
+
+
+_RedisCallbacksRESP3 = {
+    **string_keys_to_dict(
+        "ZRANGE ZINTER ZPOPMAX ZPOPMIN ZRANGEBYSCORE ZREVRANGE ZREVRANGEBYSCORE "
+        "ZUNION HGETALL XREADGROUP",
+        lambda r, **kwargs: r,
+    ),
+    **string_keys_to_dict("XREAD XREADGROUP", parse_xread_resp3),
+    "ACL LOG": lambda r: [
+        {str_if_bytes(key): str_if_bytes(value) for key, value in x.items()} for x in r
+    ]
+    if isinstance(r, list)
+    else bool_ok(r),
+    "COMMAND": parse_command_resp3,
+    "CONFIG GET": lambda r: {
+        str_if_bytes(key)
+        if key is not None
+        else None: str_if_bytes(value)
+        if value is not None
+        else None
+        for key, value in r.items()
+    },
+    "MEMORY STATS": lambda r: {str_if_bytes(key): value for key, value in r.items()},
+    "SENTINEL MASTER": parse_sentinel_state_resp3,
+    "SENTINEL MASTERS": parse_sentinel_masters_resp3,
+    "SENTINEL SENTINELS": parse_sentinel_slaves_and_sentinels_resp3,
+    "SENTINEL SLAVES": parse_sentinel_slaves_and_sentinels_resp3,
+    "STRALGO": lambda r, **options: {
+        str_if_bytes(key): str_if_bytes(value) for key, value in r.items()
+    }
+    if isinstance(r, dict)
+    else str_if_bytes(r),
+    "XINFO CONSUMERS": lambda r: [
+        {str_if_bytes(key): value for key, value in x.items()} for x in r
+    ],
+    "XINFO GROUPS": lambda r: [
+        {str_if_bytes(key): value for key, value in d.items()} for d in r
+    ],
+}
diff --git a/redis/_parsers/hiredis.py b/redis/_parsers/hiredis.py
new file mode 100644
index 0000000000..b3247b71ec
--- /dev/null
+++ b/redis/_parsers/hiredis.py
@@ -0,0 +1,217 @@
+import asyncio
+import socket
+import sys
+from typing import Callable, List, Optional, Union
+
+if sys.version_info.major >= 3 and sys.version_info.minor >= 11:
+    from asyncio import timeout as async_timeout
+else:
+    from async_timeout import timeout as async_timeout
+
+from redis.compat import TypedDict
+
+from ..exceptions import ConnectionError, InvalidResponse, RedisError
+from ..typing import EncodableT
+from ..utils import HIREDIS_AVAILABLE
+from .base import AsyncBaseParser, BaseParser
+from .socket import (
+    NONBLOCKING_EXCEPTION_ERROR_NUMBERS,
+    NONBLOCKING_EXCEPTIONS,
+    SENTINEL,
+    SERVER_CLOSED_CONNECTION_ERROR,
+)
+
+
+class _HiredisReaderArgs(TypedDict, total=False):
+    protocolError: Callable[[str], Exception]
+    replyError: Callable[[str], Exception]
+    encoding: Optional[str]
+    errors: Optional[str]
+
+
+class _HiredisParser(BaseParser):
+    "Parser class for connections using Hiredis"
+
+    def __init__(self, socket_read_size):
+        if not HIREDIS_AVAILABLE:
+            raise RedisError("Hiredis is not installed")
+        self.socket_read_size = socket_read_size
+        self._buffer = bytearray(socket_read_size)
+
+    def __del__(self):
+        try:
+            self.on_disconnect()
+        except Exception:
+            pass
+
+    def on_connect(self, connection, **kwargs):
+        import hiredis
+
+        self._sock = connection._sock
+        self._socket_timeout = connection.socket_timeout
+        kwargs = {
+            "protocolError": InvalidResponse,
+            "replyError": self.parse_error,
+            "errors": connection.encoder.encoding_errors,
+        }
+
+        if connection.encoder.decode_responses:
+            kwargs["encoding"] = connection.encoder.encoding
+        self._reader = hiredis.Reader(**kwargs)
+        self._next_response = False
+
+    def on_disconnect(self):
+        self._sock = None
+        self._reader = None
+        self._next_response = False
+
+    def can_read(self, timeout):
+        if not self._reader:
+            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
+
+        if self._next_response is False:
+            self._next_response = self._reader.gets()
+            if self._next_response is False:
+                return self.read_from_socket(timeout=timeout, raise_on_timeout=False)
+        return True
+
+    def read_from_socket(self, timeout=SENTINEL, raise_on_timeout=True):
+        sock = self._sock
+        custom_timeout = timeout is not SENTINEL
+        try:
+            if custom_timeout:
+                sock.settimeout(timeout)
+            bufflen = self._sock.recv_into(self._buffer)
+            if bufflen == 0:
+                raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
+            self._reader.feed(self._buffer, 0, bufflen)
+            # data was read from the socket and added to the buffer.
+            # return True to indicate that data was read.
+            return True
+        except socket.timeout:
+            if raise_on_timeout:
+                raise TimeoutError("Timeout reading from socket")
+            return False
+        except NONBLOCKING_EXCEPTIONS as ex:
+            # if we're in nonblocking mode and the recv raises a
+            # blocking error, simply return False indicating that
+            # there's no data to be read. otherwise raise the
+            # original exception.
+            allowed = NONBLOCKING_EXCEPTION_ERROR_NUMBERS.get(ex.__class__, -1)
+            if not raise_on_timeout and ex.errno == allowed:
+                return False
+            raise ConnectionError(f"Error while reading from socket: {ex.args}")
+        finally:
+            if custom_timeout:
+                sock.settimeout(self._socket_timeout)
+
+    def read_response(self, disable_decoding=False):
+        if not self._reader:
+            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
+
+        # _next_response might be cached from a can_read() call
+        if self._next_response is not False:
+            response = self._next_response
+            self._next_response = False
+            return response
+
+        if disable_decoding:
+            response = self._reader.gets(False)
+        else:
+            response = self._reader.gets()
+
+        while response is False:
+            self.read_from_socket()
+            if disable_decoding:
+                response = self._reader.gets(False)
+            else:
+                response = self._reader.gets()
+        # if the response is a ConnectionError or the response is a list and
+        # the first item is a ConnectionError, raise it as something bad
+        # happened
+        if isinstance(response, ConnectionError):
+            raise response
+        elif (
+            isinstance(response, list)
+            and response
+            and isinstance(response[0], ConnectionError)
+        ):
+            raise response[0]
+        return response
+
+
+class _AsyncHiredisParser(AsyncBaseParser):
+    """Async implementation of parser class for connections using Hiredis"""
+
+    __slots__ = ("_reader",)
+
+    def __init__(self, socket_read_size: int):
+        if not HIREDIS_AVAILABLE:
+            raise RedisError("Hiredis is not available.")
+        super().__init__(socket_read_size=socket_read_size)
+        self._reader = None
+
+    def on_connect(self, connection):
+        import hiredis
+
+        self._stream = connection._reader
+        kwargs: _HiredisReaderArgs = {
+            "protocolError": InvalidResponse,
+            "replyError": self.parse_error,
+        }
+        if connection.encoder.decode_responses:
+            kwargs["encoding"] = connection.encoder.encoding
+            kwargs["errors"] = connection.encoder.encoding_errors
+
+        self._reader = hiredis.Reader(**kwargs)
+        self._connected = True
+
+    def on_disconnect(self):
+        self._connected = False
+
+    async def can_read_destructive(self):
+        if not self._connected:
+            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
+        if self._reader.gets():
+            return True
+        try:
+            async with async_timeout(0):
+                return await self.read_from_socket()
+        except asyncio.TimeoutError:
+            return False
+
+    async def read_from_socket(self):
+        buffer = await self._stream.read(self._read_size)
+        if not buffer or not isinstance(buffer, bytes):
+            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR) from None
+        self._reader.feed(buffer)
+        # data was read from the socket and added to the buffer.
+        # return True to indicate that data was read.
+        return True
+
+    async def read_response(
+        self, disable_decoding: bool = False
+    ) -> Union[EncodableT, List[EncodableT]]:
+        # If `on_disconnect()` has been called, prohibit any more reads
+        # even if they could happen because data might be present.
+        # We still allow reads in progress to finish
+        if not self._connected:
+            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR) from None
+
+        response = self._reader.gets()
+        while response is False:
+            await self.read_from_socket()
+            response = self._reader.gets()
+
+        # if the response is a ConnectionError or the response is a list and
+        # the first item is a ConnectionError, raise it as something bad
+        # happened
+        if isinstance(response, ConnectionError):
+            raise response
+        elif (
+            isinstance(response, list)
+            and response
+            and isinstance(response[0], ConnectionError)
+        ):
+            raise response[0]
+        return response
diff --git a/redis/_parsers/resp2.py b/redis/_parsers/resp2.py
new file mode 100644
index 0000000000..d5adc1a898
--- /dev/null
+++ b/redis/_parsers/resp2.py
@@ -0,0 +1,132 @@
+from typing import Any, Union
+
+from ..exceptions import ConnectionError, InvalidResponse, ResponseError
+from ..typing import EncodableT
+from .base import _AsyncRESPBase, _RESPBase
+from .socket import SERVER_CLOSED_CONNECTION_ERROR
+
+
+class _RESP2Parser(_RESPBase):
+    """RESP2 protocol implementation"""
+
+    def read_response(self, disable_decoding=False):
+        pos = self._buffer.get_pos() if self._buffer else None
+        try:
+            result = self._read_response(disable_decoding=disable_decoding)
+        except BaseException:
+            if self._buffer:
+                self._buffer.rewind(pos)
+            raise
+        else:
+            self._buffer.purge()
+            return result
+
+    def _read_response(self, disable_decoding=False):
+        raw = self._buffer.readline()
+        if not raw:
+            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
+
+        byte, response = raw[:1], raw[1:]
+
+        # server returned an error
+        if byte == b"-":
+            response = response.decode("utf-8", errors="replace")
+            error = self.parse_error(response)
+            # if the error is a ConnectionError, raise immediately so the user
+            # is notified
+            if isinstance(error, ConnectionError):
+                raise error
+            # otherwise, we're dealing with a ResponseError that might belong
+            # inside a pipeline response. the connection's read_response()
+            # and/or the pipeline's execute() will raise this error if
+            # necessary, so just return the exception instance here.
+            return error
+        # single value
+        elif byte == b"+":
+            pass
+        # int value
+        elif byte == b":":
+            return int(response)
+        # bulk response
+        elif byte == b"$" and response == b"-1":
+            return None
+        elif byte == b"$":
+            response = self._buffer.read(int(response))
+        # multi-bulk response
+        elif byte == b"*" and response == b"-1":
+            return None
+        elif byte == b"*":
+            response = [
+                self._read_response(disable_decoding=disable_decoding)
+                for i in range(int(response))
+            ]
+        else:
+            raise InvalidResponse(f"Protocol Error: {raw!r}")
+
+        if disable_decoding is False:
+            response = self.encoder.decode(response)
+        return response
+
+
+class _AsyncRESP2Parser(_AsyncRESPBase):
+    """Async class for the RESP2 protocol"""
+
+    async def read_response(self, disable_decoding: bool = False):
+        if not self._connected:
+            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
+        if self._chunks:
+            # augment parsing buffer with previously read data
+            self._buffer += b"".join(self._chunks)
+            self._chunks.clear()
+        self._pos = 0
+        response = await self._read_response(disable_decoding=disable_decoding)
+        # Successfully parsing a response allows us to clear our parsing buffer
+        self._clear()
+        return response
+
+    async def _read_response(
+        self, disable_decoding: bool = False
+    ) -> Union[EncodableT, ResponseError, None]:
+        raw = await self._readline()
+        response: Any
+        byte, response = raw[:1], raw[1:]
+
+        # server returned an error
+        if byte == b"-":
+            response = response.decode("utf-8", errors="replace")
+            error = self.parse_error(response)
+            # if the error is a ConnectionError, raise immediately so the user
+            # is notified
+            if isinstance(error, ConnectionError):
+                self._clear()  # Successful parse
+                raise error
+            # otherwise, we're dealing with a ResponseError that might belong
+            # inside a pipeline response. the connection's read_response()
+            # and/or the pipeline's execute() will raise this error if
+            # necessary, so just return the exception instance here.
+            return error
+        # single value
+        elif byte == b"+":
+            pass
+        # int value
+        elif byte == b":":
+            return int(response)
+        # bulk response
+        elif byte == b"$" and response == b"-1":
+            return None
+        elif byte == b"$":
+            response = await self._read(int(response))
+        # multi-bulk response
+        elif byte == b"*" and response == b"-1":
+            return None
+        elif byte == b"*":
+            response = [
+                (await self._read_response(disable_decoding))
+                for _ in range(int(response))  # noqa
+            ]
+        else:
+            raise InvalidResponse(f"Protocol Error: {raw!r}")
+
+        if disable_decoding is False:
+            response = self.encoder.decode(response)
+        return response
diff --git a/redis/_parsers/resp3.py b/redis/_parsers/resp3.py
new file mode 100644
index 0000000000..1275686710
--- /dev/null
+++ b/redis/_parsers/resp3.py
@@ -0,0 +1,261 @@
+from logging import getLogger
+from typing import Any, Union
+
+from ..exceptions import ConnectionError, InvalidResponse, ResponseError
+from ..typing import EncodableT
+from .base import _AsyncRESPBase, _RESPBase
+from .socket import SERVER_CLOSED_CONNECTION_ERROR
+
+
+class _RESP3Parser(_RESPBase):
+    """RESP3 protocol implementation"""
+
+    def __init__(self, socket_read_size):
+        super().__init__(socket_read_size)
+        self.push_handler_func = self.handle_push_response
+
+    def handle_push_response(self, response):
+        logger = getLogger("push_response")
+        logger.info("Push response: " + str(response))
+        return response
+
+    def read_response(self, disable_decoding=False, push_request=False):
+        pos = self._buffer.get_pos() if self._buffer else None
+        try:
+            result = self._read_response(
+                disable_decoding=disable_decoding, push_request=push_request
+            )
+        except BaseException:
+            if self._buffer:
+                self._buffer.rewind(pos)
+            raise
+        else:
+            self._buffer.purge()
+            return result
+
+    def _read_response(self, disable_decoding=False, push_request=False):
+        raw = self._buffer.readline()
+        if not raw:
+            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
+
+        byte, response = raw[:1], raw[1:]
+
+        # server returned an error
+        if byte in (b"-", b"!"):
+            if byte == b"!":
+                response = self._buffer.read(int(response))
+            response = response.decode("utf-8", errors="replace")
+            error = self.parse_error(response)
+            # if the error is a ConnectionError, raise immediately so the user
+            # is notified
+            if isinstance(error, ConnectionError):
+                raise error
+            # otherwise, we're dealing with a ResponseError that might belong
+            # inside a pipeline response. the connection's read_response()
+            # and/or the pipeline's execute() will raise this error if
+            # necessary, so just return the exception instance here.
+            return error
+        # single value
+        elif byte == b"+":
+            pass
+        # null value
+        elif byte == b"_":
+            return None
+        # int and big int values
+        elif byte in (b":", b"("):
+            return int(response)
+        # double value
+        elif byte == b",":
+            return float(response)
+        # bool value
+        elif byte == b"#":
+            return response == b"t"
+        # bulk response
+        elif byte == b"$":
+            response = self._buffer.read(int(response))
+        # verbatim string response
+        elif byte == b"=":
+            response = self._buffer.read(int(response))[4:]
+        # array response
+        elif byte == b"*":
+            response = [
+                self._read_response(disable_decoding=disable_decoding)
+                for _ in range(int(response))
+            ]
+        # set response
+        elif byte == b"~":
+            # redis can return unhashable types (like dict) in a set,
+            # so we need to first convert to a list, and then try to convert it to a set
+            response = [
+                self._read_response(disable_decoding=disable_decoding)
+                for _ in range(int(response))
+            ]
+            try:
+                response = set(response)
+            except TypeError:
+                pass
+        # map response
+        elif byte == b"%":
+            # we use this approach and not dict comprehension here
+            # because this dict comprehension fails in python 3.7
+            resp_dict = {}
+            for _ in range(int(response)):
+                key = self._read_response(disable_decoding=disable_decoding)
+                resp_dict[key] = self._read_response(
+                    disable_decoding=disable_decoding, push_request=push_request
+                )
+            response = resp_dict
+        # push response
+        elif byte == b">":
+            response = [
+                self._read_response(
+                    disable_decoding=disable_decoding, push_request=push_request
+                )
+                for _ in range(int(response))
+            ]
+            res = self.push_handler_func(response)
+            if not push_request:
+                return self._read_response(
+                    disable_decoding=disable_decoding, push_request=push_request
+                )
+            else:
+                return res
+        else:
+            raise InvalidResponse(f"Protocol Error: {raw!r}")
+
+        if isinstance(response, bytes) and disable_decoding is False:
+            response = self.encoder.decode(response)
+        return response
+
+    def set_push_handler(self, push_handler_func):
+        self.push_handler_func = push_handler_func
+
+
+class _AsyncRESP3Parser(_AsyncRESPBase):
+    def __init__(self, socket_read_size):
+        super().__init__(socket_read_size)
+        self.push_handler_func = self.handle_push_response
+
+    def handle_push_response(self, response):
+        logger = getLogger("push_response")
+        logger.info("Push response: " + str(response))
+        return response
+
+    async def read_response(
+        self, disable_decoding: bool = False, push_request: bool = False
+    ):
+        if self._chunks:
+            # augment parsing buffer with previously read data
+            self._buffer += b"".join(self._chunks)
+            self._chunks.clear()
+        self._pos = 0
+        response = await self._read_response(
+            disable_decoding=disable_decoding, push_request=push_request
+        )
+        # Successfully parsing a response allows us to clear our parsing buffer
+        self._clear()
+        return response
+
+    async def _read_response(
+        self, disable_decoding: bool = False, push_request: bool = False
+    ) -> Union[EncodableT, ResponseError, None]:
+        if not self._stream or not self.encoder:
+            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
+        raw = await self._readline()
+        response: Any
+        byte, response = raw[:1], raw[1:]
+
+        # if byte not in (b"-", b"+", b":", b"$", b"*"):
+        #     raise InvalidResponse(f"Protocol Error: {raw!r}")
+
+        # server returned an error
+        if byte in (b"-", b"!"):
+            if byte == b"!":
+                response = await self._read(int(response))
+            response = response.decode("utf-8", errors="replace")
+            error = self.parse_error(response)
+            # if the error is a ConnectionError, raise immediately so the user
+            # is notified
+            if isinstance(error, ConnectionError):
+                self._clear()  # Successful parse
+                raise error
+            # otherwise, we're dealing with a ResponseError that might belong
+            # inside a pipeline response. the connection's read_response()
+            # and/or the pipeline's execute() will raise this error if
+            # necessary, so just return the exception instance here.
+            return error
+        # single value
+        elif byte == b"+":
+            pass
+        # null value
+        elif byte == b"_":
+            return None
+        # int and big int values
+        elif byte in (b":", b"("):
+            return int(response)
+        # double value
+        elif byte == b",":
+            return float(response)
+        # bool value
+        elif byte == b"#":
+            return response == b"t"
+        # bulk response
+        elif byte == b"$":
+            response = await self._read(int(response))
+        # verbatim string response
+        elif byte == b"=":
+            response = (await self._read(int(response)))[4:]
+        # array response
+        elif byte == b"*":
+            response = [
+                (await self._read_response(disable_decoding=disable_decoding))
+                for _ in range(int(response))
+            ]
+        # set response
+        elif byte == b"~":
+            # redis can return unhashable types (like dict) in a set,
+            # so we need to first convert to a list, and then try to convert it to a set
+            response = [
+                (await self._read_response(disable_decoding=disable_decoding))
+                for _ in range(int(response))
+            ]
+            try:
+                response = set(response)
+            except TypeError:
+                pass
+        # map response
+        elif byte == b"%":
+            response = {
+                (await self._read_response(disable_decoding=disable_decoding)): (
+                    await self._read_response(disable_decoding=disable_decoding)
+                )
+                for _ in range(int(response))
+            }
+        # push response
+        elif byte == b">":
+            response = [
+                (
+                    await self._read_response(
+                        disable_decoding=disable_decoding, push_request=push_request
+                    )
+                )
+                for _ in range(int(response))
+            ]
+            res = self.push_handler_func(response)
+            if not push_request:
+                return await (
+                    self._read_response(
+                        disable_decoding=disable_decoding, push_request=push_request
+                    )
+                )
+            else:
+                return res
+        else:
+            raise InvalidResponse(f"Protocol Error: {raw!r}")
+
+        if isinstance(response, bytes) and disable_decoding is False:
+            response = self.encoder.decode(response)
+        return response
+
+    def set_push_handler(self, push_handler_func):
+        self.push_handler_func = push_handler_func
diff --git a/redis/_parsers/socket.py b/redis/_parsers/socket.py
new file mode 100644
index 0000000000..8147243bba
--- /dev/null
+++ b/redis/_parsers/socket.py
@@ -0,0 +1,162 @@
+import errno
+import io
+import socket
+from io import SEEK_END
+from typing import Optional, Union
+
+from ..exceptions import ConnectionError, TimeoutError
+from ..utils import SSL_AVAILABLE
+
+NONBLOCKING_EXCEPTION_ERROR_NUMBERS = {BlockingIOError: errno.EWOULDBLOCK}
+
+if SSL_AVAILABLE:
+    import ssl
+
+    if hasattr(ssl, "SSLWantReadError"):
+        NONBLOCKING_EXCEPTION_ERROR_NUMBERS[ssl.SSLWantReadError] = 2
+        NONBLOCKING_EXCEPTION_ERROR_NUMBERS[ssl.SSLWantWriteError] = 2
+    else:
+        NONBLOCKING_EXCEPTION_ERROR_NUMBERS[ssl.SSLError] = 2
+
+NONBLOCKING_EXCEPTIONS = tuple(NONBLOCKING_EXCEPTION_ERROR_NUMBERS.keys())
+
+SERVER_CLOSED_CONNECTION_ERROR = "Connection closed by server."
+SENTINEL = object()
+
+SYM_CRLF = b"\r\n"
+
+
+class SocketBuffer:
+    def __init__(
+        self, socket: socket.socket, socket_read_size: int, socket_timeout: float
+    ):
+        self._sock = socket
+        self.socket_read_size = socket_read_size
+        self.socket_timeout = socket_timeout
+        self._buffer = io.BytesIO()
+
+    def unread_bytes(self) -> int:
+        """
+        Remaining unread length of buffer
+        """
+        pos = self._buffer.tell()
+        end = self._buffer.seek(0, SEEK_END)
+        self._buffer.seek(pos)
+        return end - pos
+
+    def _read_from_socket(
+        self,
+        length: Optional[int] = None,
+        timeout: Union[float, object] = SENTINEL,
+        raise_on_timeout: Optional[bool] = True,
+    ) -> bool:
+        sock = self._sock
+        socket_read_size = self.socket_read_size
+        marker = 0
+        custom_timeout = timeout is not SENTINEL
+
+        buf = self._buffer
+        current_pos = buf.tell()
+        buf.seek(0, SEEK_END)
+        if custom_timeout:
+            sock.settimeout(timeout)
+        try:
+            while True:
+                data = self._sock.recv(socket_read_size)
+                # an empty string indicates the server shutdown the socket
+                if isinstance(data, bytes) and len(data) == 0:
+                    raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
+                buf.write(data)
+                data_length = len(data)
+                marker += data_length
+
+                if length is not None and length > marker:
+                    continue
+                return True
+        except socket.timeout:
+            if raise_on_timeout:
+                raise TimeoutError("Timeout reading from socket")
+            return False
+        except NONBLOCKING_EXCEPTIONS as ex:
+            # if we're in nonblocking mode and the recv raises a
+            # blocking error, simply return False indicating that
+            # there's no data to be read. otherwise raise the
+            # original exception.
+            allowed = NONBLOCKING_EXCEPTION_ERROR_NUMBERS.get(ex.__class__, -1)
+            if not raise_on_timeout and ex.errno == allowed:
+                return False
+            raise ConnectionError(f"Error while reading from socket: {ex.args}")
+        finally:
+            buf.seek(current_pos)
+            if custom_timeout:
+                sock.settimeout(self.socket_timeout)
+
+    def can_read(self, timeout: float) -> bool:
+        return bool(self.unread_bytes()) or self._read_from_socket(
+            timeout=timeout, raise_on_timeout=False
+        )
+
+    def read(self, length: int) -> bytes:
+        length = length + 2  # make sure to read the \r\n terminator
+        # BufferIO will return less than requested if buffer is short
+        data = self._buffer.read(length)
+        missing = length - len(data)
+        if missing:
+            # fill up the buffer and read the remainder
+            self._read_from_socket(missing)
+            data += self._buffer.read(missing)
+        return data[:-2]
+
+    def readline(self) -> bytes:
+        buf = self._buffer
+        data = buf.readline()
+        while not data.endswith(SYM_CRLF):
+            # there's more data in the socket that we need
+            self._read_from_socket()
+            data += buf.readline()
+
+        return data[:-2]
+
+    def get_pos(self) -> int:
+        """
+        Get current read position
+        """
+        return self._buffer.tell()
+
+    def rewind(self, pos: int) -> None:
+        """
+        Rewind the buffer to a specific position, to re-start reading
+        """
+        self._buffer.seek(pos)
+
+    def purge(self) -> None:
+        """
+        After a successful read, purge the read part of buffer
+        """
+        unread = self.unread_bytes()
+
+        # Only if we have read all of the buffer do we truncate, to
+        # reduce the amount of memory thrashing.  This heuristic
+        # can be changed or removed later.
+        if unread > 0:
+            return
+
+        if unread > 0:
+            # move unread data to the front
+            view = self._buffer.getbuffer()
+            view[:unread] = view[-unread:]
+        self._buffer.truncate(unread)
+        self._buffer.seek(0)
+
+    def close(self) -> None:
+        try:
+            self._buffer.close()
+        except Exception:
+            # issue #633 suggests the purge/close somehow raised a
+            # BadFileDescriptor error. Perhaps the client ran out of
+            # memory or something else? It's probably OK to ignore
+            # any error being raised from purge/close since we're
+            # removing the reference to the instance below.
+            pass
+        self._buffer = None
+        self._sock = None
diff --git a/redis/asyncio/__init__.py b/redis/asyncio/__init__.py
index 2a82df251e..3545ab44c2 100644
--- a/redis/asyncio/__init__.py
+++ b/redis/asyncio/__init__.py
@@ -7,7 +7,6 @@
     SSLConnection,
     UnixDomainSocketConnection,
 )
-from redis.asyncio.parser import CommandsParser
 from redis.asyncio.sentinel import (
     Sentinel,
     SentinelConnectionPool,
@@ -39,7 +38,6 @@
     "BlockingConnectionPool",
     "BusyLoadingError",
     "ChildDeadlockedError",
-    "CommandsParser",
     "Connection",
     "ConnectionError",
     "ConnectionPool",
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 7479b742b6..111df24185 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -24,6 +24,12 @@
     cast,
 )
 
+from redis._parsers.helpers import (
+    _RedisCallbacks,
+    _RedisCallbacksRESP2,
+    _RedisCallbacksRESP3,
+    bool_ok,
+)
 from redis.asyncio.connection import (
     Connection,
     ConnectionPool,
@@ -37,7 +43,6 @@
     NEVER_DECODE,
     AbstractRedis,
     CaseInsensitiveDict,
-    bool_ok,
 )
 from redis.commands import (
     AsyncCoreCommands,
@@ -57,7 +62,7 @@
     WatchError,
 )
 from redis.typing import ChannelT, EncodableT, KeyT
-from redis.utils import safe_str, str_if_bytes
+from redis.utils import HIREDIS_AVAILABLE, _set_info_logger, safe_str, str_if_bytes
 
 PubSubHandler = Callable[[Dict[str, str]], Awaitable[None]]
 _KeyT = TypeVar("_KeyT", bound=KeyT)
@@ -180,6 +185,7 @@ def __init__(
         auto_close_connection_pool: bool = True,
         redis_connect_func=None,
         credential_provider: Optional[CredentialProvider] = None,
+        protocol: Optional[int] = 2,
     ):
         """
         Initialize a new Redis client.
@@ -217,6 +223,7 @@ def __init__(
                 "health_check_interval": health_check_interval,
                 "client_name": client_name,
                 "redis_connect_func": redis_connect_func,
+                "protocol": protocol,
             }
             # based on input, setup appropriate connection args
             if unix_socket_path is not None:
@@ -255,7 +262,12 @@ def __init__(
         self.single_connection_client = single_connection_client
         self.connection: Optional[Connection] = None
 
-        self.response_callbacks = CaseInsensitiveDict(self.__class__.RESPONSE_CALLBACKS)
+        self.response_callbacks = CaseInsensitiveDict(_RedisCallbacks)
+
+        if self.connection_pool.connection_kwargs.get("protocol") in ["3", 3]:
+            self.response_callbacks.update(_RedisCallbacksRESP3)
+        else:
+            self.response_callbacks.update(_RedisCallbacksRESP2)
 
         # If using a single connection client, we need to lock creation-of and use-of
         # the client in order to avoid race conditions such as using asyncio.gather
@@ -657,6 +669,7 @@ def __init__(
         shard_hint: Optional[str] = None,
         ignore_subscribe_messages: bool = False,
         encoder=None,
+        push_handler_func: Optional[Callable] = None,
     ):
         self.connection_pool = connection_pool
         self.shard_hint = shard_hint
@@ -665,18 +678,21 @@ def __init__(
         # we need to know the encoding options for this connection in order
         # to lookup channel and pattern names for callback handlers.
         self.encoder = encoder
+        self.push_handler_func = push_handler_func
         if self.encoder is None:
             self.encoder = self.connection_pool.get_encoder()
         if self.encoder.decode_responses:
-            self.health_check_response: Iterable[Union[str, bytes]] = [
-                "pong",
+            self.health_check_response = [
+                ["pong", self.HEALTH_CHECK_MESSAGE],
                 self.HEALTH_CHECK_MESSAGE,
             ]
         else:
             self.health_check_response = [
-                b"pong",
+                [b"pong", self.encoder.encode(self.HEALTH_CHECK_MESSAGE)],
                 self.encoder.encode(self.HEALTH_CHECK_MESSAGE),
             ]
+        if self.push_handler_func is None:
+            _set_info_logger()
         self.channels = {}
         self.pending_unsubscribe_channels = set()
         self.patterns = {}
@@ -761,6 +777,8 @@ async def connect(self):
             self.connection.register_connect_callback(self.on_connect)
         else:
             await self.connection.connect()
+        if self.push_handler_func is not None and not HIREDIS_AVAILABLE:
+            self.connection._parser.set_push_handler(self.push_handler_func)
 
     async def _disconnect_raise_connect(self, conn, error):
         """
@@ -802,10 +820,14 @@ async def parse_response(self, block: bool = True, timeout: float = 0):
 
         read_timeout = None if block else timeout
         response = await self._execute(
-            conn, conn.read_response, timeout=read_timeout, disconnect_on_error=False
+            conn,
+            conn.read_response,
+            timeout=read_timeout,
+            disconnect_on_error=False,
+            push_request=True,
         )
 
-        if conn.health_check_interval and response == self.health_check_response:
+        if conn.health_check_interval and response in self.health_check_response:
             # ignore the health check message as user might not expect it
             return None
         return response
@@ -933,8 +955,8 @@ def ping(self, message=None) -> Awaitable:
         """
         Ping the Redis server
         """
-        message = "" if message is None else message
-        return self.execute_command("PING", message)
+        args = ["PING", message] if message is not None else ["PING"]
+        return self.execute_command(*args)
 
     async def handle_message(self, response, ignore_subscribe_messages=False):
         """
@@ -942,6 +964,10 @@ async def handle_message(self, response, ignore_subscribe_messages=False):
         with a message handler, the handler is invoked instead of a parsed
         message being returned.
         """
+        if response is None:
+            return None
+        if isinstance(response, bytes):
+            response = [b"pong", response] if response != b"PONG" else [b"pong", b""]
         message_type = str_if_bytes(response[0])
         if message_type == "pmessage":
             message = {
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 989c6ccda8..9e2a40ce1b 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -18,16 +18,15 @@
     Union,
 )
 
-from redis.asyncio.client import ResponseCallbackT
-from redis.asyncio.connection import (
-    Connection,
-    DefaultParser,
-    Encoder,
-    SSLConnection,
-    parse_url,
+from redis._parsers import AsyncCommandsParser, Encoder
+from redis._parsers.helpers import (
+    _RedisCallbacks,
+    _RedisCallbacksRESP2,
+    _RedisCallbacksRESP3,
 )
+from redis.asyncio.client import ResponseCallbackT
+from redis.asyncio.connection import Connection, DefaultParser, SSLConnection, parse_url
 from redis.asyncio.lock import Lock
-from redis.asyncio.parser import CommandsParser
 from redis.asyncio.retry import Retry
 from redis.backoff import default_backoff
 from redis.client import EMPTY_RESPONSE, NEVER_DECODE, AbstractRedis
@@ -258,6 +257,7 @@ def __init__(
         ssl_certfile: Optional[str] = None,
         ssl_check_hostname: bool = False,
         ssl_keyfile: Optional[str] = None,
+        protocol: Optional[int] = 2,
         address_remap: Optional[Callable[[str, int], Tuple[str, int]]] = None,
     ) -> None:
         if db:
@@ -299,6 +299,7 @@ def __init__(
             "socket_keepalive_options": socket_keepalive_options,
             "socket_timeout": socket_timeout,
             "retry": retry,
+            "protocol": protocol,
         }
 
         if ssl:
@@ -331,7 +332,11 @@ def __init__(
             self.retry.update_supported_errors(retry_on_error)
             kwargs.update({"retry": self.retry})
 
-        kwargs["response_callbacks"] = self.__class__.RESPONSE_CALLBACKS.copy()
+        kwargs["response_callbacks"] = _RedisCallbacks.copy()
+        if kwargs.get("protocol") in ["3", 3]:
+            kwargs["response_callbacks"].update(_RedisCallbacksRESP3)
+        else:
+            kwargs["response_callbacks"].update(_RedisCallbacksRESP2)
         self.connection_kwargs = kwargs
 
         if startup_nodes:
@@ -358,7 +363,7 @@ def __init__(
         self.cluster_error_retry_attempts = cluster_error_retry_attempts
         self.connection_error_retry_attempts = connection_error_retry_attempts
         self.reinitialize_counter = 0
-        self.commands_parser = CommandsParser()
+        self.commands_parser = AsyncCommandsParser()
         self.node_flags = self.__class__.NODE_FLAGS.copy()
         self.command_flags = self.__class__.COMMAND_FLAGS.copy()
         self.response_callbacks = kwargs["response_callbacks"]
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index d6195e1801..22c5030e6c 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -33,35 +33,31 @@
 else:
     from async_timeout import timeout as async_timeout
 
-
 from redis.asyncio.retry import Retry
 from redis.backoff import NoBackoff
 from redis.compat import Protocol, TypedDict
+from redis.connection import DEFAULT_RESP_VERSION
 from redis.credentials import CredentialProvider, UsernamePasswordCredentialProvider
 from redis.exceptions import (
     AuthenticationError,
     AuthenticationWrongNumberOfArgsError,
-    BusyLoadingError,
     ChildDeadlockedError,
     ConnectionError,
     DataError,
-    ExecAbortError,
-    InvalidResponse,
-    ModuleError,
-    NoPermissionError,
-    NoScriptError,
-    OutOfMemoryError,
-    ReadOnlyError,
     RedisError,
     ResponseError,
     TimeoutError,
 )
-from redis.typing import EncodableT, EncodedT
+from redis.typing import EncodableT
 from redis.utils import HIREDIS_AVAILABLE, str_if_bytes
 
-hiredis = None
-if HIREDIS_AVAILABLE:
-    import hiredis
+from .._parsers import (
+    BaseParser,
+    Encoder,
+    _AsyncHiredisParser,
+    _AsyncRESP2Parser,
+    _AsyncRESP3Parser,
+)
 
 SYM_STAR = b"*"
 SYM_DOLLAR = b"$"
@@ -69,367 +65,19 @@
 SYM_LF = b"\n"
 SYM_EMPTY = b""
 
-SERVER_CLOSED_CONNECTION_ERROR = "Connection closed by server."
-
 
 class _Sentinel(enum.Enum):
     sentinel = object()
 
 
 SENTINEL = _Sentinel.sentinel
-MODULE_LOAD_ERROR = "Error loading the extension. Please check the server logs."
-NO_SUCH_MODULE_ERROR = "Error unloading module: no such module with that name"
-MODULE_UNLOAD_NOT_POSSIBLE_ERROR = "Error unloading module: operation not possible."
-MODULE_EXPORTS_DATA_TYPES_ERROR = (
-    "Error unloading module: the module "
-    "exports one or more module-side data "
-    "types, can't unload"
-)
-# user send an AUTH cmd to a server without authorization configured
-NO_AUTH_SET_ERROR = {
-    # Redis >= 6.0
-    "AUTH <password> called without any password "
-    "configured for the default user. Are you sure "
-    "your configuration is correct?": AuthenticationError,
-    # Redis < 6.0
-    "Client sent AUTH, but no password is set": AuthenticationError,
-}
-
-
-class _HiredisReaderArgs(TypedDict, total=False):
-    protocolError: Callable[[str], Exception]
-    replyError: Callable[[str], Exception]
-    encoding: Optional[str]
-    errors: Optional[str]
-
-
-class Encoder:
-    """Encode strings to bytes-like and decode bytes-like to strings"""
-
-    __slots__ = "encoding", "encoding_errors", "decode_responses"
-
-    def __init__(self, encoding: str, encoding_errors: str, decode_responses: bool):
-        self.encoding = encoding
-        self.encoding_errors = encoding_errors
-        self.decode_responses = decode_responses
-
-    def encode(self, value: EncodableT) -> EncodedT:
-        """Return a bytestring or bytes-like representation of the value"""
-        if isinstance(value, str):
-            return value.encode(self.encoding, self.encoding_errors)
-        if isinstance(value, (bytes, memoryview)):
-            return value
-        if isinstance(value, (int, float)):
-            if isinstance(value, bool):
-                # special case bool since it is a subclass of int
-                raise DataError(
-                    "Invalid input of type: 'bool'. "
-                    "Convert to a bytes, string, int or float first."
-                )
-            return repr(value).encode()
-        # a value we don't know how to deal with. throw an error
-        typename = value.__class__.__name__
-        raise DataError(
-            f"Invalid input of type: {typename!r}. "
-            "Convert to a bytes, string, int or float first."
-        )
-
-    def decode(self, value: EncodableT, force=False) -> EncodableT:
-        """Return a unicode string from the bytes-like representation"""
-        if self.decode_responses or force:
-            if isinstance(value, bytes):
-                return value.decode(self.encoding, self.encoding_errors)
-            if isinstance(value, memoryview):
-                return value.tobytes().decode(self.encoding, self.encoding_errors)
-        return value
-
-
-ExceptionMappingT = Mapping[str, Union[Type[Exception], Mapping[str, Type[Exception]]]]
-
-
-class BaseParser:
-    """Plain Python parsing class"""
-
-    __slots__ = "_stream", "_read_size", "_connected"
-
-    EXCEPTION_CLASSES: ExceptionMappingT = {
-        "ERR": {
-            "max number of clients reached": ConnectionError,
-            "Client sent AUTH, but no password is set": AuthenticationError,
-            "invalid password": AuthenticationError,
-            # some Redis server versions report invalid command syntax
-            # in lowercase
-            "wrong number of arguments for 'auth' command": AuthenticationWrongNumberOfArgsError,  # noqa: E501
-            # some Redis server versions report invalid command syntax
-            # in uppercase
-            "wrong number of arguments for 'AUTH' command": AuthenticationWrongNumberOfArgsError,  # noqa: E501
-            MODULE_LOAD_ERROR: ModuleError,
-            MODULE_EXPORTS_DATA_TYPES_ERROR: ModuleError,
-            NO_SUCH_MODULE_ERROR: ModuleError,
-            MODULE_UNLOAD_NOT_POSSIBLE_ERROR: ModuleError,
-            **NO_AUTH_SET_ERROR,
-        },
-        "WRONGPASS": AuthenticationError,
-        "EXECABORT": ExecAbortError,
-        "LOADING": BusyLoadingError,
-        "NOSCRIPT": NoScriptError,
-        "READONLY": ReadOnlyError,
-        "NOAUTH": AuthenticationError,
-        "NOPERM": NoPermissionError,
-        "OOM": OutOfMemoryError,
-    }
-
-    def __init__(self, socket_read_size: int):
-        self._stream: Optional[asyncio.StreamReader] = None
-        self._read_size = socket_read_size
-        self._connected = False
-
-    @classmethod
-    def parse_error(cls, response: str) -> ResponseError:
-        """Parse an error response"""
-        error_code = response.split(" ")[0]
-        if error_code in cls.EXCEPTION_CLASSES:
-            response = response[len(error_code) + 1 :]
-            exception_class = cls.EXCEPTION_CLASSES[error_code]
-            if isinstance(exception_class, dict):
-                exception_class = exception_class.get(response, ResponseError)
-            return exception_class(response)
-        return ResponseError(response)
-
-    def on_disconnect(self):
-        raise NotImplementedError()
-
-    def on_connect(self, connection: "AbstractConnection"):
-        raise NotImplementedError()
-
-    async def can_read_destructive(self) -> bool:
-        raise NotImplementedError()
-
-    async def read_response(
-        self, disable_decoding: bool = False
-    ) -> Union[EncodableT, ResponseError, None, List[EncodableT]]:
-        raise NotImplementedError()
-
-
-class PythonParser(BaseParser):
-    """Plain Python parsing class"""
-
-    __slots__ = ("encoder", "_buffer", "_pos", "_chunks")
-
-    def __init__(self, socket_read_size: int):
-        super().__init__(socket_read_size)
-        self.encoder: Optional[Encoder] = None
-        self._buffer = b""
-        self._chunks = []
-        self._pos = 0
-
-    def _clear(self):
-        self._buffer = b""
-        self._chunks.clear()
-
-    def on_connect(self, connection: "AbstractConnection"):
-        """Called when the stream connects"""
-        self._stream = connection._reader
-        if self._stream is None:
-            raise RedisError("Buffer is closed.")
-        self.encoder = connection.encoder
-        self._clear()
-        self._connected = True
-
-    def on_disconnect(self):
-        """Called when the stream disconnects"""
-        self._connected = False
-
-    async def can_read_destructive(self) -> bool:
-        if not self._connected:
-            raise RedisError("Buffer is closed.")
-        if self._buffer:
-            return True
-        try:
-            async with async_timeout(0):
-                return await self._stream.read(1)
-        except asyncio.TimeoutError:
-            return False
-
-    async def read_response(self, disable_decoding: bool = False):
-        if not self._connected:
-            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
-        if self._chunks:
-            # augment parsing buffer with previously read data
-            self._buffer += b"".join(self._chunks)
-            self._chunks.clear()
-        self._pos = 0
-        response = await self._read_response(disable_decoding=disable_decoding)
-        # Successfully parsing a response allows us to clear our parsing buffer
-        self._clear()
-        return response
-
-    async def _read_response(
-        self, disable_decoding: bool = False
-    ) -> Union[EncodableT, ResponseError, None]:
-        raw = await self._readline()
-        response: Any
-        byte, response = raw[:1], raw[1:]
-
-        # server returned an error
-        if byte == b"-":
-            response = response.decode("utf-8", errors="replace")
-            error = self.parse_error(response)
-            # if the error is a ConnectionError, raise immediately so the user
-            # is notified
-            if isinstance(error, ConnectionError):
-                self._clear()  # Successful parse
-                raise error
-            # otherwise, we're dealing with a ResponseError that might belong
-            # inside a pipeline response. the connection's read_response()
-            # and/or the pipeline's execute() will raise this error if
-            # necessary, so just return the exception instance here.
-            return error
-        # single value
-        elif byte == b"+":
-            pass
-        # int value
-        elif byte == b":":
-            return int(response)
-        # bulk response
-        elif byte == b"$" and response == b"-1":
-            return None
-        elif byte == b"$":
-            response = await self._read(int(response))
-        # multi-bulk response
-        elif byte == b"*" and response == b"-1":
-            return None
-        elif byte == b"*":
-            response = [
-                (await self._read_response(disable_decoding))
-                for _ in range(int(response))  # noqa
-            ]
-        else:
-            raise InvalidResponse(f"Protocol Error: {raw!r}")
-
-        if disable_decoding is False:
-            response = self.encoder.decode(response)
-        return response
-
-    async def _read(self, length: int) -> bytes:
-        """
-        Read `length` bytes of data.  These are assumed to be followed
-        by a '\r\n' terminator which is subsequently discarded.
-        """
-        want = length + 2
-        end = self._pos + want
-        if len(self._buffer) >= end:
-            result = self._buffer[self._pos : end - 2]
-        else:
-            tail = self._buffer[self._pos :]
-            try:
-                data = await self._stream.readexactly(want - len(tail))
-            except asyncio.IncompleteReadError as error:
-                raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR) from error
-            result = (tail + data)[:-2]
-            self._chunks.append(data)
-        self._pos += want
-        return result
-
-    async def _readline(self) -> bytes:
-        """
-        read an unknown number of bytes up to the next '\r\n'
-        line separator, which is discarded.
-        """
-        found = self._buffer.find(b"\r\n", self._pos)
-        if found >= 0:
-            result = self._buffer[self._pos : found]
-        else:
-            tail = self._buffer[self._pos :]
-            data = await self._stream.readline()
-            if not data.endswith(b"\r\n"):
-                raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
-            result = (tail + data)[:-2]
-            self._chunks.append(data)
-        self._pos += len(result) + 2
-        return result
-
-
-class HiredisParser(BaseParser):
-    """Parser class for connections using Hiredis"""
-
-    __slots__ = ("_reader",)
-
-    def __init__(self, socket_read_size: int):
-        if not HIREDIS_AVAILABLE:
-            raise RedisError("Hiredis is not available.")
-        super().__init__(socket_read_size=socket_read_size)
-        self._reader: Optional[hiredis.Reader] = None
-
-    def on_connect(self, connection: "AbstractConnection"):
-        self._stream = connection._reader
-        kwargs: _HiredisReaderArgs = {
-            "protocolError": InvalidResponse,
-            "replyError": self.parse_error,
-        }
-        if connection.encoder.decode_responses:
-            kwargs["encoding"] = connection.encoder.encoding
-            kwargs["errors"] = connection.encoder.encoding_errors
-
-        self._reader = hiredis.Reader(**kwargs)
-        self._connected = True
-
-    def on_disconnect(self):
-        self._connected = False
-
-    async def can_read_destructive(self):
-        if not self._connected:
-            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
-        if self._reader.gets():
-            return True
-        try:
-            async with async_timeout(0):
-                return await self.read_from_socket()
-        except asyncio.TimeoutError:
-            return False
-
-    async def read_from_socket(self):
-        buffer = await self._stream.read(self._read_size)
-        if not buffer or not isinstance(buffer, bytes):
-            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR) from None
-        self._reader.feed(buffer)
-        # data was read from the socket and added to the buffer.
-        # return True to indicate that data was read.
-        return True
-
-    async def read_response(
-        self, disable_decoding: bool = False
-    ) -> Union[EncodableT, List[EncodableT]]:
-        # If `on_disconnect()` has been called, prohibit any more reads
-        # even if they could happen because data might be present.
-        # We still allow reads in progress to finish
-        if not self._connected:
-            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR) from None
-
-        response = self._reader.gets()
-        while response is False:
-            await self.read_from_socket()
-            response = self._reader.gets()
-
-        # if the response is a ConnectionError or the response is a list and
-        # the first item is a ConnectionError, raise it as something bad
-        # happened
-        if isinstance(response, ConnectionError):
-            raise response
-        elif (
-            isinstance(response, list)
-            and response
-            and isinstance(response[0], ConnectionError)
-        ):
-            raise response[0]
-        return response
 
 
-DefaultParser: Type[Union[PythonParser, HiredisParser]]
+DefaultParser: Type[Union[_AsyncRESP2Parser, _AsyncRESP3Parser, _AsyncHiredisParser]]
 if HIREDIS_AVAILABLE:
-    DefaultParser = HiredisParser
+    DefaultParser = _AsyncHiredisParser
 else:
-    DefaultParser = PythonParser
+    DefaultParser = _AsyncRESP2Parser
 
 
 class ConnectCallbackProtocol(Protocol):
@@ -465,6 +113,7 @@ class AbstractConnection:
         "last_active_at",
         "encoder",
         "ssl_context",
+        "protocol",
         "_reader",
         "_writer",
         "_parser",
@@ -496,6 +145,7 @@ def __init__(
         redis_connect_func: Optional[ConnectCallbackT] = None,
         encoder_class: Type[Encoder] = Encoder,
         credential_provider: Optional[CredentialProvider] = None,
+        protocol: Optional[int] = 2,
     ):
         if (username or password) and credential_provider is not None:
             raise DataError(
@@ -542,6 +192,16 @@ def __init__(
         self.set_parser(parser_class)
         self._connect_callbacks: List[weakref.WeakMethod[ConnectCallbackT]] = []
         self._buffer_cutoff = 6000
+        try:
+            p = int(protocol)
+        except TypeError:
+            p = DEFAULT_RESP_VERSION
+        except ValueError:
+            raise ConnectionError("protocol must be an integer")
+        finally:
+            if p < 2 or p > 3:
+                raise ConnectionError("protocol must be either 2 or 3")
+            self.protocol = protocol
 
     def __repr__(self):
         repr_args = ",".join((f"{k}={v}" for k, v in self.repr_pieces()))
@@ -623,7 +283,9 @@ def _error_message(self, exception: BaseException) -> str:
     async def on_connect(self) -> None:
         """Initialize the connection, authenticate and select a database"""
         self._parser.on_connect(self)
+        parser = self._parser
 
+        auth_args = None
         # if credential provider or username and/or password are set, authenticate
         if self.credential_provider or (self.username or self.password):
             cred_provider = (
@@ -631,8 +293,25 @@ async def on_connect(self) -> None:
                 or UsernamePasswordCredentialProvider(self.username, self.password)
             )
             auth_args = cred_provider.get_credentials()
-            # avoid checking health here -- PING will fail if we try
-            # to check the health prior to the AUTH
+            # if resp version is specified and we have auth args,
+            # we need to send them via HELLO
+        if auth_args and self.protocol not in [2, "2"]:
+            if isinstance(self._parser, _AsyncRESP2Parser):
+                self.set_parser(_AsyncRESP3Parser)
+                # update cluster exception classes
+                self._parser.EXCEPTION_CLASSES = parser.EXCEPTION_CLASSES
+                self._parser.on_connect(self)
+            if len(auth_args) == 1:
+                auth_args = ["default", auth_args[0]]
+            await self.send_command("HELLO", self.protocol, "AUTH", *auth_args)
+            response = await self.read_response()
+            if response.get(b"proto") != int(self.protocol) and response.get(
+                "proto"
+            ) != int(self.protocol):
+                raise ConnectionError("Invalid RESP version")
+        # avoid checking health here -- PING will fail if we try
+        # to check the health prior to the AUTH
+        elif auth_args:
             await self.send_command("AUTH", *auth_args, check_health=False)
 
             try:
@@ -648,6 +327,20 @@ async def on_connect(self) -> None:
             if str_if_bytes(auth_response) != "OK":
                 raise AuthenticationError("Invalid Username or Password")
 
+        # if resp version is specified, switch to it
+        elif self.protocol not in [2, "2"]:
+            if isinstance(self._parser, _AsyncRESP2Parser):
+                self.set_parser(_AsyncRESP3Parser)
+                # update cluster exception classes
+                self._parser.EXCEPTION_CLASSES = parser.EXCEPTION_CLASSES
+                self._parser.on_connect(self)
+            await self.send_command("HELLO", self.protocol)
+            response = await self.read_response()
+            # if response.get(b"proto") != self.protocol and response.get(
+            #     "proto"
+            # ) != self.protocol:
+            #     raise ConnectionError("Invalid RESP version")
+
         # if a client_name is given, set it
         if self.client_name:
             await self.send_command("CLIENT", "SETNAME", self.client_name)
@@ -768,16 +461,30 @@ async def read_response(
         timeout: Optional[float] = None,
         *,
         disconnect_on_error: bool = True,
+        push_request: Optional[bool] = False,
     ):
         """Read the response from a previously sent command"""
         read_timeout = timeout if timeout is not None else self.socket_timeout
         host_error = self._host_error()
         try:
-            if read_timeout is not None:
+            if (
+                read_timeout is not None
+                and self.protocol in ["3", 3]
+                and not HIREDIS_AVAILABLE
+            ):
+                async with async_timeout(read_timeout):
+                    response = await self._parser.read_response(
+                        disable_decoding=disable_decoding, push_request=push_request
+                    )
+            elif read_timeout is not None:
                 async with async_timeout(read_timeout):
                     response = await self._parser.read_response(
                         disable_decoding=disable_decoding
                     )
+            elif self.protocol in ["3", 3] and not HIREDIS_AVAILABLE:
+                response = await self._parser.read_response(
+                    disable_decoding=disable_decoding, push_request=push_request
+                )
             else:
                 response = await self._parser.read_response(
                     disable_decoding=disable_decoding
diff --git a/redis/asyncio/parser.py b/redis/asyncio/parser.py
deleted file mode 100644
index 5faf8f8c57..0000000000
--- a/redis/asyncio/parser.py
+++ /dev/null
@@ -1,94 +0,0 @@
-from typing import TYPE_CHECKING, Any, Dict, Optional, Tuple, Union
-
-from redis.exceptions import RedisError, ResponseError
-
-if TYPE_CHECKING:
-    from redis.asyncio.cluster import ClusterNode
-
-
-class CommandsParser:
-    """
-    Parses Redis commands to get command keys.
-
-    COMMAND output is used to determine key locations.
-    Commands that do not have a predefined key location are flagged with 'movablekeys',
-    and these commands' keys are determined by the command 'COMMAND GETKEYS'.
-
-    NOTE: Due to a bug in redis<7.0, this does not work properly
-    for EVAL or EVALSHA when the `numkeys` arg is 0.
-     - issue: https://github.com/redis/redis/issues/9493
-     - fix: https://github.com/redis/redis/pull/9733
-
-    So, don't use this with EVAL or EVALSHA.
-    """
-
-    __slots__ = ("commands", "node")
-
-    def __init__(self) -> None:
-        self.commands: Dict[str, Union[int, Dict[str, Any]]] = {}
-
-    async def initialize(self, node: Optional["ClusterNode"] = None) -> None:
-        if node:
-            self.node = node
-
-        commands = await self.node.execute_command("COMMAND")
-        for cmd, command in commands.items():
-            if "movablekeys" in command["flags"]:
-                commands[cmd] = -1
-            elif command["first_key_pos"] == 0 and command["last_key_pos"] == 0:
-                commands[cmd] = 0
-            elif command["first_key_pos"] == 1 and command["last_key_pos"] == 1:
-                commands[cmd] = 1
-        self.commands = {cmd.upper(): command for cmd, command in commands.items()}
-
-    # As soon as this PR is merged into Redis, we should reimplement
-    # our logic to use COMMAND INFO changes to determine the key positions
-    # https://github.com/redis/redis/pull/8324
-    async def get_keys(self, *args: Any) -> Optional[Tuple[str, ...]]:
-        if len(args) < 2:
-            # The command has no keys in it
-            return None
-
-        try:
-            command = self.commands[args[0]]
-        except KeyError:
-            # try to split the command name and to take only the main command
-            # e.g. 'memory' for 'memory usage'
-            args = args[0].split() + list(args[1:])
-            cmd_name = args[0].upper()
-            if cmd_name not in self.commands:
-                # We'll try to reinitialize the commands cache, if the engine
-                # version has changed, the commands may not be current
-                await self.initialize()
-                if cmd_name not in self.commands:
-                    raise RedisError(
-                        f"{cmd_name} command doesn't exist in Redis commands"
-                    )
-
-            command = self.commands[cmd_name]
-
-        if command == 1:
-            return (args[1],)
-        if command == 0:
-            return None
-        if command == -1:
-            return await self._get_moveable_keys(*args)
-
-        last_key_pos = command["last_key_pos"]
-        if last_key_pos < 0:
-            last_key_pos = len(args) + last_key_pos
-        return args[command["first_key_pos"] : last_key_pos + 1 : command["step_count"]]
-
-    async def _get_moveable_keys(self, *args: Any) -> Optional[Tuple[str, ...]]:
-        try:
-            keys = await self.node.execute_command("COMMAND GETKEYS", *args)
-        except ResponseError as e:
-            message = e.__str__()
-            if (
-                "Invalid arguments" in message
-                or "The command has no key arguments" in message
-            ):
-                return None
-            else:
-                raise e
-        return keys
diff --git a/redis/client.py b/redis/client.py
index ab626ccdf4..66e2c7b84f 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1,5 +1,4 @@
 import copy
-import datetime
 import re
 import threading
 import time
@@ -7,6 +6,12 @@
 from itertools import chain
 from typing import Optional
 
+from redis._parsers.helpers import (
+    _RedisCallbacks,
+    _RedisCallbacksRESP2,
+    _RedisCallbacksRESP3,
+    bool_ok,
+)
 from redis.commands import (
     CoreCommands,
     RedisModuleCommands,
@@ -18,7 +23,6 @@
 from redis.exceptions import (
     ConnectionError,
     ExecAbortError,
-    ModuleError,
     PubSubError,
     RedisError,
     ResponseError,
@@ -27,7 +31,7 @@
 )
 from redis.lock import Lock
 from redis.retry import Retry
-from redis.utils import safe_str, str_if_bytes
+from redis.utils import HIREDIS_AVAILABLE, _set_info_logger, safe_str, str_if_bytes
 
 SYM_EMPTY = b""
 EMPTY_RESPONSE = "EMPTY_RESPONSE"
@@ -36,21 +40,6 @@
 NEVER_DECODE = "NEVER_DECODE"
 
 
-def timestamp_to_datetime(response):
-    "Converts a unix timestamp to a Python datetime object"
-    if not response:
-        return None
-    try:
-        response = int(response)
-    except ValueError:
-        return None
-    return datetime.datetime.fromtimestamp(response)
-
-
-def string_keys_to_dict(key_string, callback):
-    return dict.fromkeys(key_string.split(), callback)
-
-
 class CaseInsensitiveDict(dict):
     "Case insensitive dict implementation. Assumes string keys only."
 
@@ -78,778 +67,11 @@ def update(self, data):
         super().update(data)
 
 
-def parse_debug_object(response):
-    "Parse the results of Redis's DEBUG OBJECT command into a Python dict"
-    # The 'type' of the object is the first item in the response, but isn't
-    # prefixed with a name
-    response = str_if_bytes(response)
-    response = "type:" + response
-    response = dict(kv.split(":") for kv in response.split())
-
-    # parse some expected int values from the string response
-    # note: this cmd isn't spec'd so these may not appear in all redis versions
-    int_fields = ("refcount", "serializedlength", "lru", "lru_seconds_idle")
-    for field in int_fields:
-        if field in response:
-            response[field] = int(response[field])
-
-    return response
-
-
-def parse_object(response, infotype):
-    """Parse the results of an OBJECT command"""
-    if infotype in ("idletime", "refcount"):
-        return int_or_none(response)
-    return response
-
-
-def parse_info(response):
-    """Parse the result of Redis's INFO command into a Python dict"""
-    info = {}
-    response = str_if_bytes(response)
-
-    def get_value(value):
-        if "," not in value or "=" not in value:
-            try:
-                if "." in value:
-                    return float(value)
-                else:
-                    return int(value)
-            except ValueError:
-                return value
-        else:
-            sub_dict = {}
-            for item in value.split(","):
-                k, v = item.rsplit("=", 1)
-                sub_dict[k] = get_value(v)
-            return sub_dict
-
-    for line in response.splitlines():
-        if line and not line.startswith("#"):
-            if line.find(":") != -1:
-                # Split, the info fields keys and values.
-                # Note that the value may contain ':'. but the 'host:'
-                # pseudo-command is the only case where the key contains ':'
-                key, value = line.split(":", 1)
-                if key == "cmdstat_host":
-                    key, value = line.rsplit(":", 1)
-
-                if key == "module":
-                    # Hardcode a list for key 'modules' since there could be
-                    # multiple lines that started with 'module'
-                    info.setdefault("modules", []).append(get_value(value))
-                else:
-                    info[key] = get_value(value)
-            else:
-                # if the line isn't splittable, append it to the "__raw__" key
-                info.setdefault("__raw__", []).append(line)
-
-    return info
-
-
-def parse_memory_stats(response, **kwargs):
-    """Parse the results of MEMORY STATS"""
-    stats = pairs_to_dict(response, decode_keys=True, decode_string_values=True)
-    for key, value in stats.items():
-        if key.startswith("db."):
-            stats[key] = pairs_to_dict(
-                value, decode_keys=True, decode_string_values=True
-            )
-    return stats
-
-
-SENTINEL_STATE_TYPES = {
-    "can-failover-its-master": int,
-    "config-epoch": int,
-    "down-after-milliseconds": int,
-    "failover-timeout": int,
-    "info-refresh": int,
-    "last-hello-message": int,
-    "last-ok-ping-reply": int,
-    "last-ping-reply": int,
-    "last-ping-sent": int,
-    "master-link-down-time": int,
-    "master-port": int,
-    "num-other-sentinels": int,
-    "num-slaves": int,
-    "o-down-time": int,
-    "pending-commands": int,
-    "parallel-syncs": int,
-    "port": int,
-    "quorum": int,
-    "role-reported-time": int,
-    "s-down-time": int,
-    "slave-priority": int,
-    "slave-repl-offset": int,
-    "voted-leader-epoch": int,
-}
-
-
-def parse_sentinel_state(item):
-    result = pairs_to_dict_typed(item, SENTINEL_STATE_TYPES)
-    flags = set(result["flags"].split(","))
-    for name, flag in (
-        ("is_master", "master"),
-        ("is_slave", "slave"),
-        ("is_sdown", "s_down"),
-        ("is_odown", "o_down"),
-        ("is_sentinel", "sentinel"),
-        ("is_disconnected", "disconnected"),
-        ("is_master_down", "master_down"),
-    ):
-        result[name] = flag in flags
-    return result
-
-
-def parse_sentinel_master(response):
-    return parse_sentinel_state(map(str_if_bytes, response))
-
-
-def parse_sentinel_masters(response):
-    result = {}
-    for item in response:
-        state = parse_sentinel_state(map(str_if_bytes, item))
-        result[state["name"]] = state
-    return result
-
-
-def parse_sentinel_slaves_and_sentinels(response):
-    return [parse_sentinel_state(map(str_if_bytes, item)) for item in response]
-
-
-def parse_sentinel_get_master(response):
-    return response and (response[0], int(response[1])) or None
-
-
-def pairs_to_dict(response, decode_keys=False, decode_string_values=False):
-    """Create a dict given a list of key/value pairs"""
-    if response is None:
-        return {}
-    if decode_keys or decode_string_values:
-        # the iter form is faster, but I don't know how to make that work
-        # with a str_if_bytes() map
-        keys = response[::2]
-        if decode_keys:
-            keys = map(str_if_bytes, keys)
-        values = response[1::2]
-        if decode_string_values:
-            values = map(str_if_bytes, values)
-        return dict(zip(keys, values))
-    else:
-        it = iter(response)
-        return dict(zip(it, it))
-
-
-def pairs_to_dict_typed(response, type_info):
-    it = iter(response)
-    result = {}
-    for key, value in zip(it, it):
-        if key in type_info:
-            try:
-                value = type_info[key](value)
-            except Exception:
-                # if for some reason the value can't be coerced, just use
-                # the string value
-                pass
-        result[key] = value
-    return result
-
-
-def zset_score_pairs(response, **options):
-    """
-    If ``withscores`` is specified in the options, return the response as
-    a list of (value, score) pairs
-    """
-    if not response or not options.get("withscores"):
-        return response
-    score_cast_func = options.get("score_cast_func", float)
-    it = iter(response)
-    return list(zip(it, map(score_cast_func, it)))
-
-
-def sort_return_tuples(response, **options):
-    """
-    If ``groups`` is specified, return the response as a list of
-    n-element tuples with n being the value found in options['groups']
-    """
-    if not response or not options.get("groups"):
-        return response
-    n = options["groups"]
-    return list(zip(*[response[i::n] for i in range(n)]))
-
-
-def int_or_none(response):
-    if response is None:
-        return None
-    return int(response)
-
-
-def parse_stream_list(response):
-    if response is None:
-        return None
-    data = []
-    for r in response:
-        if r is not None:
-            data.append((r[0], pairs_to_dict(r[1])))
-        else:
-            data.append((None, None))
-    return data
-
-
-def pairs_to_dict_with_str_keys(response):
-    return pairs_to_dict(response, decode_keys=True)
-
-
-def parse_list_of_dicts(response):
-    return list(map(pairs_to_dict_with_str_keys, response))
-
-
-def parse_xclaim(response, **options):
-    if options.get("parse_justid", False):
-        return response
-    return parse_stream_list(response)
-
-
-def parse_xautoclaim(response, **options):
-    if options.get("parse_justid", False):
-        return response[1]
-    response[1] = parse_stream_list(response[1])
-    return response
-
-
-def parse_xinfo_stream(response, **options):
-    data = pairs_to_dict(response, decode_keys=True)
-    if not options.get("full", False):
-        first = data.get("first-entry")
-        if first is not None:
-            data["first-entry"] = (first[0], pairs_to_dict(first[1]))
-        last = data["last-entry"]
-        if last is not None:
-            data["last-entry"] = (last[0], pairs_to_dict(last[1]))
-    else:
-        data["entries"] = {_id: pairs_to_dict(entry) for _id, entry in data["entries"]}
-        data["groups"] = [
-            pairs_to_dict(group, decode_keys=True) for group in data["groups"]
-        ]
-    return data
-
-
-def parse_xread(response):
-    if response is None:
-        return []
-    return [[r[0], parse_stream_list(r[1])] for r in response]
-
-
-def parse_xpending(response, **options):
-    if options.get("parse_detail", False):
-        return parse_xpending_range(response)
-    consumers = [{"name": n, "pending": int(p)} for n, p in response[3] or []]
-    return {
-        "pending": response[0],
-        "min": response[1],
-        "max": response[2],
-        "consumers": consumers,
-    }
-
-
-def parse_xpending_range(response):
-    k = ("message_id", "consumer", "time_since_delivered", "times_delivered")
-    return [dict(zip(k, r)) for r in response]
-
-
-def float_or_none(response):
-    if response is None:
-        return None
-    return float(response)
-
-
-def bool_ok(response):
-    return str_if_bytes(response) == "OK"
-
-
-def parse_zadd(response, **options):
-    if response is None:
-        return None
-    if options.get("as_score"):
-        return float(response)
-    return int(response)
-
-
-def parse_client_list(response, **options):
-    clients = []
-    for c in str_if_bytes(response).splitlines():
-        # Values might contain '='
-        clients.append(dict(pair.split("=", 1) for pair in c.split(" ")))
-    return clients
-
-
-def parse_config_get(response, **options):
-    response = [str_if_bytes(i) if i is not None else None for i in response]
-    return response and pairs_to_dict(response) or {}
-
-
-def parse_scan(response, **options):
-    cursor, r = response
-    return int(cursor), r
-
-
-def parse_hscan(response, **options):
-    cursor, r = response
-    return int(cursor), r and pairs_to_dict(r) or {}
-
-
-def parse_zscan(response, **options):
-    score_cast_func = options.get("score_cast_func", float)
-    cursor, r = response
-    it = iter(r)
-    return int(cursor), list(zip(it, map(score_cast_func, it)))
-
-
-def parse_zmscore(response, **options):
-    # zmscore: list of scores (double precision floating point number) or nil
-    return [float(score) if score is not None else None for score in response]
-
-
-def parse_slowlog_get(response, **options):
-    space = " " if options.get("decode_responses", False) else b" "
-
-    def parse_item(item):
-        result = {"id": item[0], "start_time": int(item[1]), "duration": int(item[2])}
-        # Redis Enterprise injects another entry at index [3], which has
-        # the complexity info (i.e. the value N in case the command has
-        # an O(N) complexity) instead of the command.
-        if isinstance(item[3], list):
-            result["command"] = space.join(item[3])
-            result["client_address"] = item[4]
-            result["client_name"] = item[5]
-        else:
-            result["complexity"] = item[3]
-            result["command"] = space.join(item[4])
-            result["client_address"] = item[5]
-            result["client_name"] = item[6]
-        return result
-
-    return [parse_item(item) for item in response]
-
-
-def parse_stralgo(response, **options):
-    """
-    Parse the response from `STRALGO` command.
-    Without modifiers the returned value is string.
-    When LEN is given the command returns the length of the result
-    (i.e integer).
-    When IDX is given the command returns a dictionary with the LCS
-    length and all the ranges in both the strings, start and end
-    offset for each string, where there are matches.
-    When WITHMATCHLEN is given, each array representing a match will
-    also have the length of the match at the beginning of the array.
-    """
-    if options.get("len", False):
-        return int(response)
-    if options.get("idx", False):
-        if options.get("withmatchlen", False):
-            matches = [
-                [(int(match[-1]))] + list(map(tuple, match[:-1]))
-                for match in response[1]
-            ]
-        else:
-            matches = [list(map(tuple, match)) for match in response[1]]
-        return {
-            str_if_bytes(response[0]): matches,
-            str_if_bytes(response[2]): int(response[3]),
-        }
-    return str_if_bytes(response)
-
-
-def parse_cluster_info(response, **options):
-    response = str_if_bytes(response)
-    return dict(line.split(":") for line in response.splitlines() if line)
-
-
-def _parse_node_line(line):
-    line_items = line.split(" ")
-    node_id, addr, flags, master_id, ping, pong, epoch, connected = line.split(" ")[:8]
-    addr = addr.split("@")[0]
-    node_dict = {
-        "node_id": node_id,
-        "flags": flags,
-        "master_id": master_id,
-        "last_ping_sent": ping,
-        "last_pong_rcvd": pong,
-        "epoch": epoch,
-        "slots": [],
-        "migrations": [],
-        "connected": True if connected == "connected" else False,
-    }
-    if len(line_items) >= 9:
-        slots, migrations = _parse_slots(line_items[8:])
-        node_dict["slots"], node_dict["migrations"] = slots, migrations
-    return addr, node_dict
-
-
-def _parse_slots(slot_ranges):
-    slots, migrations = [], []
-    for s_range in slot_ranges:
-        if "->-" in s_range:
-            slot_id, dst_node_id = s_range[1:-1].split("->-", 1)
-            migrations.append(
-                {"slot": slot_id, "node_id": dst_node_id, "state": "migrating"}
-            )
-        elif "-<-" in s_range:
-            slot_id, src_node_id = s_range[1:-1].split("-<-", 1)
-            migrations.append(
-                {"slot": slot_id, "node_id": src_node_id, "state": "importing"}
-            )
-        else:
-            s_range = [sl for sl in s_range.split("-")]
-            slots.append(s_range)
-
-    return slots, migrations
-
-
-def parse_cluster_nodes(response, **options):
-    """
-    @see: https://redis.io/commands/cluster-nodes  # string / bytes
-    @see: https://redis.io/commands/cluster-replicas # list of string / bytes
-    """
-    if isinstance(response, (str, bytes)):
-        response = response.splitlines()
-    return dict(_parse_node_line(str_if_bytes(node)) for node in response)
-
-
-def parse_geosearch_generic(response, **options):
-    """
-    Parse the response of 'GEOSEARCH', GEORADIUS' and 'GEORADIUSBYMEMBER'
-    commands according to 'withdist', 'withhash' and 'withcoord' labels.
-    """
-    try:
-        if options["store"] or options["store_dist"]:
-            # `store` and `store_dist` cant be combined
-            # with other command arguments.
-            # relevant to 'GEORADIUS' and 'GEORADIUSBYMEMBER'
-            return response
-    except KeyError:  # it means the command was sent via execute_command
-        return response
-
-    if type(response) != list:
-        response_list = [response]
-    else:
-        response_list = response
-
-    if not options["withdist"] and not options["withcoord"] and not options["withhash"]:
-        # just a bunch of places
-        return response_list
-
-    cast = {
-        "withdist": float,
-        "withcoord": lambda ll: (float(ll[0]), float(ll[1])),
-        "withhash": int,
-    }
-
-    # zip all output results with each casting function to get
-    # the properly native Python value.
-    f = [lambda x: x]
-    f += [cast[o] for o in ["withdist", "withhash", "withcoord"] if options[o]]
-    return [list(map(lambda fv: fv[0](fv[1]), zip(f, r))) for r in response_list]
-
-
-def parse_command(response, **options):
-    commands = {}
-    for command in response:
-        cmd_dict = {}
-        cmd_name = str_if_bytes(command[0])
-        cmd_dict["name"] = cmd_name
-        cmd_dict["arity"] = int(command[1])
-        cmd_dict["flags"] = [str_if_bytes(flag) for flag in command[2]]
-        cmd_dict["first_key_pos"] = command[3]
-        cmd_dict["last_key_pos"] = command[4]
-        cmd_dict["step_count"] = command[5]
-        if len(command) > 7:
-            cmd_dict["tips"] = command[7]
-            cmd_dict["key_specifications"] = command[8]
-            cmd_dict["subcommands"] = command[9]
-        commands[cmd_name] = cmd_dict
-    return commands
-
-
-def parse_pubsub_numsub(response, **options):
-    return list(zip(response[0::2], response[1::2]))
-
-
-def parse_client_kill(response, **options):
-    if isinstance(response, int):
-        return response
-    return str_if_bytes(response) == "OK"
-
-
-def parse_acl_getuser(response, **options):
-    if response is None:
-        return None
-    data = pairs_to_dict(response, decode_keys=True)
-
-    # convert everything but user-defined data in 'keys' to native strings
-    data["flags"] = list(map(str_if_bytes, data["flags"]))
-    data["passwords"] = list(map(str_if_bytes, data["passwords"]))
-    data["commands"] = str_if_bytes(data["commands"])
-    if isinstance(data["keys"], str) or isinstance(data["keys"], bytes):
-        data["keys"] = list(str_if_bytes(data["keys"]).split(" "))
-    if data["keys"] == [""]:
-        data["keys"] = []
-    if "channels" in data:
-        if isinstance(data["channels"], str) or isinstance(data["channels"], bytes):
-            data["channels"] = list(str_if_bytes(data["channels"]).split(" "))
-        if data["channels"] == [""]:
-            data["channels"] = []
-    if "selectors" in data:
-        data["selectors"] = [
-            list(map(str_if_bytes, selector)) for selector in data["selectors"]
-        ]
-
-    # split 'commands' into separate 'categories' and 'commands' lists
-    commands, categories = [], []
-    for command in data["commands"].split(" "):
-        if "@" in command:
-            categories.append(command)
-        else:
-            commands.append(command)
-
-    data["commands"] = commands
-    data["categories"] = categories
-    data["enabled"] = "on" in data["flags"]
-    return data
-
-
-def parse_acl_log(response, **options):
-    if response is None:
-        return None
-    if isinstance(response, list):
-        data = []
-        for log in response:
-            log_data = pairs_to_dict(log, True, True)
-            client_info = log_data.get("client-info", "")
-            log_data["client-info"] = parse_client_info(client_info)
-
-            # float() is lossy comparing to the "double" in C
-            log_data["age-seconds"] = float(log_data["age-seconds"])
-            data.append(log_data)
-    else:
-        data = bool_ok(response)
-    return data
-
-
-def parse_client_info(value):
-    """
-    Parsing client-info in ACL Log in following format.
-    "key1=value1 key2=value2 key3=value3"
-    """
-    client_info = {}
-    infos = str_if_bytes(value).split(" ")
-    for info in infos:
-        key, value = info.split("=")
-        client_info[key] = value
-
-    # Those fields are defined as int in networking.c
-    for int_key in {
-        "id",
-        "age",
-        "idle",
-        "db",
-        "sub",
-        "psub",
-        "multi",
-        "qbuf",
-        "qbuf-free",
-        "obl",
-        "argv-mem",
-        "oll",
-        "omem",
-        "tot-mem",
-    }:
-        client_info[int_key] = int(client_info[int_key])
-    return client_info
-
-
-def parse_module_result(response):
-    if isinstance(response, ModuleError):
-        raise response
-    return True
-
-
-def parse_set_result(response, **options):
-    """
-    Handle SET result since GET argument is available since Redis 6.2.
-    Parsing SET result into:
-    - BOOL
-    - String when GET argument is used
-    """
-    if options.get("get"):
-        # Redis will return a getCommand result.
-        # See `setGenericCommand` in t_string.c
-        return response
-    return response and str_if_bytes(response) == "OK"
+class AbstractRedis:
+    pass
 
 
-class AbstractRedis:
-    RESPONSE_CALLBACKS = {
-        **string_keys_to_dict(
-            "AUTH COPY EXPIRE EXPIREAT PEXPIRE PEXPIREAT "
-            "HEXISTS HMSET MOVE MSETNX PERSIST "
-            "PSETEX RENAMENX SISMEMBER SMOVE SETEX SETNX",
-            bool,
-        ),
-        **string_keys_to_dict(
-            "BITCOUNT BITPOS DECRBY DEL EXISTS GEOADD GETBIT HDEL HLEN "
-            "HSTRLEN INCRBY LINSERT LLEN LPUSHX PFADD PFCOUNT RPUSHX SADD "
-            "SCARD SDIFFSTORE SETBIT SETRANGE SINTERSTORE SREM STRLEN "
-            "SUNIONSTORE UNLINK XACK XDEL XLEN XTRIM ZCARD ZLEXCOUNT ZREM "
-            "ZREMRANGEBYLEX ZREMRANGEBYRANK ZREMRANGEBYSCORE",
-            int,
-        ),
-        **string_keys_to_dict("INCRBYFLOAT HINCRBYFLOAT", float),
-        **string_keys_to_dict(
-            # these return OK, or int if redis-server is >=1.3.4
-            "LPUSH RPUSH",
-            lambda r: isinstance(r, int) and r or str_if_bytes(r) == "OK",
-        ),
-        **string_keys_to_dict("SORT", sort_return_tuples),
-        **string_keys_to_dict("ZSCORE ZINCRBY GEODIST", float_or_none),
-        **string_keys_to_dict(
-            "FLUSHALL FLUSHDB LSET LTRIM MSET PFMERGE ASKING READONLY READWRITE "
-            "RENAME SAVE SELECT SHUTDOWN SLAVEOF SWAPDB WATCH UNWATCH ",
-            bool_ok,
-        ),
-        **string_keys_to_dict("BLPOP BRPOP", lambda r: r and tuple(r) or None),
-        **string_keys_to_dict(
-            "SDIFF SINTER SMEMBERS SUNION", lambda r: r and set(r) or set()
-        ),
-        **string_keys_to_dict(
-            "ZPOPMAX ZPOPMIN ZINTER ZDIFF ZUNION ZRANGE ZRANGEBYSCORE "
-            "ZREVRANGE ZREVRANGEBYSCORE",
-            zset_score_pairs,
-        ),
-        **string_keys_to_dict(
-            "BZPOPMIN BZPOPMAX", lambda r: r and (r[0], r[1], float(r[2])) or None
-        ),
-        **string_keys_to_dict("ZRANK ZREVRANK", int_or_none),
-        **string_keys_to_dict("XREVRANGE XRANGE", parse_stream_list),
-        **string_keys_to_dict("XREAD XREADGROUP", parse_xread),
-        **string_keys_to_dict("BGREWRITEAOF BGSAVE", lambda r: True),
-        "ACL CAT": lambda r: list(map(str_if_bytes, r)),
-        "ACL DELUSER": int,
-        "ACL GENPASS": str_if_bytes,
-        "ACL GETUSER": parse_acl_getuser,
-        "ACL HELP": lambda r: list(map(str_if_bytes, r)),
-        "ACL LIST": lambda r: list(map(str_if_bytes, r)),
-        "ACL LOAD": bool_ok,
-        "ACL LOG": parse_acl_log,
-        "ACL SAVE": bool_ok,
-        "ACL SETUSER": bool_ok,
-        "ACL USERS": lambda r: list(map(str_if_bytes, r)),
-        "ACL WHOAMI": str_if_bytes,
-        "CLIENT GETNAME": str_if_bytes,
-        "CLIENT ID": int,
-        "CLIENT KILL": parse_client_kill,
-        "CLIENT LIST": parse_client_list,
-        "CLIENT INFO": parse_client_info,
-        "CLIENT SETNAME": bool_ok,
-        "CLIENT UNBLOCK": lambda r: r and int(r) == 1 or False,
-        "CLIENT PAUSE": bool_ok,
-        "CLIENT GETREDIR": int,
-        "CLIENT TRACKINGINFO": lambda r: list(map(str_if_bytes, r)),
-        "CLUSTER ADDSLOTS": bool_ok,
-        "CLUSTER ADDSLOTSRANGE": bool_ok,
-        "CLUSTER COUNT-FAILURE-REPORTS": lambda x: int(x),
-        "CLUSTER COUNTKEYSINSLOT": lambda x: int(x),
-        "CLUSTER DELSLOTS": bool_ok,
-        "CLUSTER DELSLOTSRANGE": bool_ok,
-        "CLUSTER FAILOVER": bool_ok,
-        "CLUSTER FORGET": bool_ok,
-        "CLUSTER GETKEYSINSLOT": lambda r: list(map(str_if_bytes, r)),
-        "CLUSTER INFO": parse_cluster_info,
-        "CLUSTER KEYSLOT": lambda x: int(x),
-        "CLUSTER MEET": bool_ok,
-        "CLUSTER NODES": parse_cluster_nodes,
-        "CLUSTER REPLICAS": parse_cluster_nodes,
-        "CLUSTER REPLICATE": bool_ok,
-        "CLUSTER RESET": bool_ok,
-        "CLUSTER SAVECONFIG": bool_ok,
-        "CLUSTER SET-CONFIG-EPOCH": bool_ok,
-        "CLUSTER SETSLOT": bool_ok,
-        "CLUSTER SLAVES": parse_cluster_nodes,
-        "COMMAND": parse_command,
-        "COMMAND COUNT": int,
-        "COMMAND GETKEYS": lambda r: list(map(str_if_bytes, r)),
-        "CONFIG GET": parse_config_get,
-        "CONFIG RESETSTAT": bool_ok,
-        "CONFIG SET": bool_ok,
-        "DEBUG OBJECT": parse_debug_object,
-        "FUNCTION DELETE": bool_ok,
-        "FUNCTION FLUSH": bool_ok,
-        "FUNCTION RESTORE": bool_ok,
-        "GEOHASH": lambda r: list(map(str_if_bytes, r)),
-        "GEOPOS": lambda r: list(
-            map(lambda ll: (float(ll[0]), float(ll[1])) if ll is not None else None, r)
-        ),
-        "GEOSEARCH": parse_geosearch_generic,
-        "GEORADIUS": parse_geosearch_generic,
-        "GEORADIUSBYMEMBER": parse_geosearch_generic,
-        "HGETALL": lambda r: r and pairs_to_dict(r) or {},
-        "HSCAN": parse_hscan,
-        "INFO": parse_info,
-        "LASTSAVE": timestamp_to_datetime,
-        "MEMORY PURGE": bool_ok,
-        "MEMORY STATS": parse_memory_stats,
-        "MEMORY USAGE": int_or_none,
-        "MODULE LOAD": parse_module_result,
-        "MODULE UNLOAD": parse_module_result,
-        "MODULE LIST": lambda r: [pairs_to_dict(m) for m in r],
-        "OBJECT": parse_object,
-        "PING": lambda r: str_if_bytes(r) == "PONG",
-        "QUIT": bool_ok,
-        "STRALGO": parse_stralgo,
-        "PUBSUB NUMSUB": parse_pubsub_numsub,
-        "RANDOMKEY": lambda r: r and r or None,
-        "RESET": str_if_bytes,
-        "SCAN": parse_scan,
-        "SCRIPT EXISTS": lambda r: list(map(bool, r)),
-        "SCRIPT FLUSH": bool_ok,
-        "SCRIPT KILL": bool_ok,
-        "SCRIPT LOAD": str_if_bytes,
-        "SENTINEL CKQUORUM": bool_ok,
-        "SENTINEL FAILOVER": bool_ok,
-        "SENTINEL FLUSHCONFIG": bool_ok,
-        "SENTINEL GET-MASTER-ADDR-BY-NAME": parse_sentinel_get_master,
-        "SENTINEL MASTER": parse_sentinel_master,
-        "SENTINEL MASTERS": parse_sentinel_masters,
-        "SENTINEL MONITOR": bool_ok,
-        "SENTINEL RESET": bool_ok,
-        "SENTINEL REMOVE": bool_ok,
-        "SENTINEL SENTINELS": parse_sentinel_slaves_and_sentinels,
-        "SENTINEL SET": bool_ok,
-        "SENTINEL SLAVES": parse_sentinel_slaves_and_sentinels,
-        "SET": parse_set_result,
-        "SLOWLOG GET": parse_slowlog_get,
-        "SLOWLOG LEN": int,
-        "SLOWLOG RESET": bool_ok,
-        "SSCAN": parse_scan,
-        "TIME": lambda x: (int(x[0]), int(x[1])),
-        "XCLAIM": parse_xclaim,
-        "XAUTOCLAIM": parse_xautoclaim,
-        "XGROUP CREATE": bool_ok,
-        "XGROUP DELCONSUMER": int,
-        "XGROUP DESTROY": bool,
-        "XGROUP SETID": bool_ok,
-        "XINFO CONSUMERS": parse_list_of_dicts,
-        "XINFO GROUPS": parse_list_of_dicts,
-        "XINFO STREAM": parse_xinfo_stream,
-        "XPENDING": parse_xpending,
-        "ZADD": parse_zadd,
-        "ZSCAN": parse_zscan,
-        "ZMSCORE": parse_zmscore,
-    }
-
-
-class Redis(AbstractRedis, RedisModuleCommands, CoreCommands, SentinelCommands):
+class Redis(RedisModuleCommands, CoreCommands, SentinelCommands):
     """
     Implementation of the Redis protocol.
 
@@ -953,6 +175,7 @@ def __init__(
         retry=None,
         redis_connect_func=None,
         credential_provider: Optional[CredentialProvider] = None,
+        protocol: Optional[int] = 2,
     ):
         """
         Initialize a new Redis client.
@@ -1001,6 +224,7 @@ def __init__(
                 "client_name": client_name,
                 "redis_connect_func": redis_connect_func,
                 "credential_provider": credential_provider,
+                "protocol": protocol,
             }
             # based on input, setup appropriate connection args
             if unix_socket_path is not None:
@@ -1046,7 +270,12 @@ def __init__(
         if single_connection_client:
             self.connection = self.connection_pool.get_connection("_")
 
-        self.response_callbacks = CaseInsensitiveDict(self.__class__.RESPONSE_CALLBACKS)
+        self.response_callbacks = CaseInsensitiveDict(_RedisCallbacks)
+
+        if self.connection_pool.connection_kwargs.get("protocol") in ["3", 3]:
+            self.response_callbacks.update(_RedisCallbacksRESP3)
+        else:
+            self.response_callbacks.update(_RedisCallbacksRESP2)
 
     def __repr__(self):
         return f"{type(self).__name__}<{repr(self.connection_pool)}>"
@@ -1376,8 +605,8 @@ class PubSub:
     will be returned and it's safe to start listening again.
     """
 
-    PUBLISH_MESSAGE_TYPES = ("message", "pmessage")
-    UNSUBSCRIBE_MESSAGE_TYPES = ("unsubscribe", "punsubscribe")
+    PUBLISH_MESSAGE_TYPES = ("message", "pmessage", "smessage")
+    UNSUBSCRIBE_MESSAGE_TYPES = ("unsubscribe", "punsubscribe", "sunsubscribe")
     HEALTH_CHECK_MESSAGE = "redis-py-health-check"
 
     def __init__(
@@ -1386,6 +615,7 @@ def __init__(
         shard_hint=None,
         ignore_subscribe_messages=False,
         encoder=None,
+        push_handler_func=None,
     ):
         self.connection_pool = connection_pool
         self.shard_hint = shard_hint
@@ -1395,6 +625,7 @@ def __init__(
         # we need to know the encoding options for this connection in order
         # to lookup channel and pattern names for callback handlers.
         self.encoder = encoder
+        self.push_handler_func = push_handler_func
         if self.encoder is None:
             self.encoder = self.connection_pool.get_encoder()
         self.health_check_response_b = self.encoder.encode(self.HEALTH_CHECK_MESSAGE)
@@ -1402,6 +633,8 @@ def __init__(
             self.health_check_response = ["pong", self.HEALTH_CHECK_MESSAGE]
         else:
             self.health_check_response = [b"pong", self.health_check_response_b]
+        if self.push_handler_func is None:
+            _set_info_logger()
         self.reset()
 
     def __enter__(self):
@@ -1425,9 +658,11 @@ def reset(self):
             self.connection.clear_connect_callbacks()
             self.connection_pool.release(self.connection)
             self.connection = None
-        self.channels = {}
         self.health_check_response_counter = 0
+        self.channels = {}
         self.pending_unsubscribe_channels = set()
+        self.shard_channels = {}
+        self.pending_unsubscribe_shard_channels = set()
         self.patterns = {}
         self.pending_unsubscribe_patterns = set()
         self.subscribed_event.clear()
@@ -1442,16 +677,23 @@ def on_connect(self, connection):
         # before passing them to [p]subscribe.
         self.pending_unsubscribe_channels.clear()
         self.pending_unsubscribe_patterns.clear()
+        self.pending_unsubscribe_shard_channels.clear()
         if self.channels:
-            channels = {}
-            for k, v in self.channels.items():
-                channels[self.encoder.decode(k, force=True)] = v
+            channels = {
+                self.encoder.decode(k, force=True): v for k, v in self.channels.items()
+            }
             self.subscribe(**channels)
         if self.patterns:
-            patterns = {}
-            for k, v in self.patterns.items():
-                patterns[self.encoder.decode(k, force=True)] = v
+            patterns = {
+                self.encoder.decode(k, force=True): v for k, v in self.patterns.items()
+            }
             self.psubscribe(**patterns)
+        if self.shard_channels:
+            shard_channels = {
+                self.encoder.decode(k, force=True): v
+                for k, v in self.shard_channels.items()
+            }
+            self.ssubscribe(**shard_channels)
 
     @property
     def subscribed(self):
@@ -1472,6 +714,8 @@ def execute_command(self, *args):
             # register a callback that re-subscribes to any channels we
             # were listening to when we were disconnected
             self.connection.register_connect_callback(self.on_connect)
+            if self.push_handler_func is not None and not HIREDIS_AVAILABLE:
+                self.connection._parser.set_push_handler(self.push_handler_func)
         connection = self.connection
         kwargs = {"check_health": not self.subscribed}
         if not self.subscribed:
@@ -1537,7 +781,7 @@ def try_read():
                     return None
             else:
                 conn.connect()
-            return conn.read_response(disconnect_on_error=False)
+            return conn.read_response(disconnect_on_error=False, push_request=True)
 
         response = self._execute(conn, try_read)
 
@@ -1658,6 +902,45 @@ def unsubscribe(self, *args):
         self.pending_unsubscribe_channels.update(channels)
         return self.execute_command("UNSUBSCRIBE", *args)
 
+    def ssubscribe(self, *args, target_node=None, **kwargs):
+        """
+        Subscribes the client to the specified shard channels.
+        Channels supplied as keyword arguments expect a channel name as the key
+        and a callable as the value. A channel's callable will be invoked automatically
+        when a message is received on that channel rather than producing a message via
+        ``listen()`` or ``get_sharded_message()``.
+        """
+        if args:
+            args = list_or_args(args[0], args[1:])
+        new_s_channels = dict.fromkeys(args)
+        new_s_channels.update(kwargs)
+        ret_val = self.execute_command("SSUBSCRIBE", *new_s_channels.keys())
+        # update the s_channels dict AFTER we send the command. we don't want to
+        # subscribe twice to these channels, once for the command and again
+        # for the reconnection.
+        new_s_channels = self._normalize_keys(new_s_channels)
+        self.shard_channels.update(new_s_channels)
+        if not self.subscribed:
+            # Set the subscribed_event flag to True
+            self.subscribed_event.set()
+            # Clear the health check counter
+            self.health_check_response_counter = 0
+        self.pending_unsubscribe_shard_channels.difference_update(new_s_channels)
+        return ret_val
+
+    def sunsubscribe(self, *args, target_node=None):
+        """
+        Unsubscribe from the supplied shard_channels. If empty, unsubscribe from
+        all shard_channels
+        """
+        if args:
+            args = list_or_args(args[0], args[1:])
+            s_channels = self._normalize_keys(dict.fromkeys(args))
+        else:
+            s_channels = self.shard_channels
+        self.pending_unsubscribe_shard_channels.update(s_channels)
+        return self.execute_command("SUNSUBSCRIBE", *args)
+
     def listen(self):
         "Listen for messages on channels this client has been subscribed to"
         while self.subscribed:
@@ -1692,12 +975,14 @@ def get_message(self, ignore_subscribe_messages=False, timeout=0.0):
             return self.handle_message(response, ignore_subscribe_messages)
         return None
 
+    get_sharded_message = get_message
+
     def ping(self, message=None):
         """
         Ping the Redis server
         """
-        message = "" if message is None else message
-        return self.execute_command("PING", message)
+        args = ["PING", message] if message is not None else ["PING"]
+        return self.execute_command(*args)
 
     def handle_message(self, response, ignore_subscribe_messages=False):
         """
@@ -1707,6 +992,8 @@ def handle_message(self, response, ignore_subscribe_messages=False):
         """
         if response is None:
             return None
+        if isinstance(response, bytes):
+            response = [b"pong", response] if response != b"PONG" else [b"pong", b""]
         message_type = str_if_bytes(response[0])
         if message_type == "pmessage":
             message = {
@@ -1737,12 +1024,17 @@ def handle_message(self, response, ignore_subscribe_messages=False):
                 if pattern in self.pending_unsubscribe_patterns:
                     self.pending_unsubscribe_patterns.remove(pattern)
                     self.patterns.pop(pattern, None)
+            elif message_type == "sunsubscribe":
+                s_channel = response[1]
+                if s_channel in self.pending_unsubscribe_shard_channels:
+                    self.pending_unsubscribe_shard_channels.remove(s_channel)
+                    self.shard_channels.pop(s_channel, None)
             else:
                 channel = response[1]
                 if channel in self.pending_unsubscribe_channels:
                     self.pending_unsubscribe_channels.remove(channel)
                     self.channels.pop(channel, None)
-            if not self.channels and not self.patterns:
+            if not self.channels and not self.patterns and not self.shard_channels:
                 # There are no subscriptions anymore, set subscribed_event flag
                 # to false
                 self.subscribed_event.clear()
@@ -1751,6 +1043,8 @@ def handle_message(self, response, ignore_subscribe_messages=False):
             # if there's a message handler, invoke it
             if message_type == "pmessage":
                 handler = self.patterns.get(message["pattern"], None)
+            elif message_type == "smessage":
+                handler = self.shard_channels.get(message["channel"], None)
             else:
                 handler = self.channels.get(message["channel"], None)
             if handler:
@@ -1771,6 +1065,11 @@ def run_in_thread(self, sleep_time=0, daemon=False, exception_handler=None):
         for pattern, handler in self.patterns.items():
             if handler is None:
                 raise PubSubError(f"Pattern: '{pattern}' has no handler registered")
+        for s_channel, handler in self.shard_channels.items():
+            if handler is None:
+                raise PubSubError(
+                    f"Shard Channel: '{s_channel}' has no handler registered"
+                )
 
         thread = PubSubWorkerThread(
             self, sleep_time, daemon=daemon, exception_handler=exception_handler
diff --git a/redis/cluster.py b/redis/cluster.py
index be8e4623a7..c179511b0c 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -6,10 +6,13 @@
 from collections import OrderedDict
 from typing import Any, Callable, Dict, List, Optional, Tuple, Union
 
+from redis._parsers import CommandsParser, Encoder
+from redis._parsers.helpers import parse_scan
 from redis.backoff import default_backoff
-from redis.client import CaseInsensitiveDict, PubSub, Redis, parse_scan
-from redis.commands import READ_COMMANDS, CommandsParser, RedisClusterCommands
-from redis.connection import ConnectionPool, DefaultParser, Encoder, parse_url
+from redis.client import CaseInsensitiveDict, PubSub, Redis
+from redis.commands import READ_COMMANDS, RedisClusterCommands
+from redis.commands.helpers import list_or_args
+from redis.connection import ConnectionPool, DefaultParser, parse_url
 from redis.crc import REDIS_CLUSTER_HASH_SLOTS, key_slot
 from redis.exceptions import (
     AskError,
@@ -31,6 +34,7 @@
 from redis.lock import Lock
 from redis.retry import Retry
 from redis.utils import (
+    HIREDIS_AVAILABLE,
     dict_merge,
     list_keys_to_dict,
     merge_result,
@@ -145,6 +149,7 @@ def parse_cluster_myshardid(resp, **options):
     "queue_class",
     "retry",
     "retry_on_timeout",
+    "protocol",
     "socket_connect_timeout",
     "socket_keepalive",
     "socket_keepalive_options",
@@ -227,6 +232,8 @@ class AbstractRedisCluster:
                 "PUBSUB CHANNELS",
                 "PUBSUB NUMPAT",
                 "PUBSUB NUMSUB",
+                "PUBSUB SHARDCHANNELS",
+                "PUBSUB SHARDNUMSUB",
                 "PING",
                 "INFO",
                 "SHUTDOWN",
@@ -253,7 +260,6 @@ class AbstractRedisCluster:
                 "CLIENT INFO",
                 "CLIENT KILL",
                 "READONLY",
-                "READWRITE",
                 "CLUSTER INFO",
                 "CLUSTER MEET",
                 "CLUSTER NODES",
@@ -353,11 +359,13 @@ class AbstractRedisCluster:
     }
 
     RESULT_CALLBACKS = dict_merge(
-        list_keys_to_dict(["PUBSUB NUMSUB"], parse_pubsub_numsub),
+        list_keys_to_dict(["PUBSUB NUMSUB", "PUBSUB SHARDNUMSUB"], parse_pubsub_numsub),
         list_keys_to_dict(
             ["PUBSUB NUMPAT"], lambda command, res: sum(list(res.values()))
         ),
-        list_keys_to_dict(["KEYS", "PUBSUB CHANNELS"], merge_result),
+        list_keys_to_dict(
+            ["KEYS", "PUBSUB CHANNELS", "PUBSUB SHARDCHANNELS"], merge_result
+        ),
         list_keys_to_dict(
             [
                 "PING",
@@ -1632,7 +1640,15 @@ class ClusterPubSub(PubSub):
     https://redis-py-cluster.readthedocs.io/en/stable/pubsub.html
     """
 
-    def __init__(self, redis_cluster, node=None, host=None, port=None, **kwargs):
+    def __init__(
+        self,
+        redis_cluster,
+        node=None,
+        host=None,
+        port=None,
+        push_handler_func=None,
+        **kwargs,
+    ):
         """
         When a pubsub instance is created without specifying a node, a single
         node will be transparently chosen for the pubsub connection on the
@@ -1654,8 +1670,13 @@ def __init__(self, redis_cluster, node=None, host=None, port=None, **kwargs):
             else redis_cluster.get_redis_connection(self.node).connection_pool
         )
         self.cluster = redis_cluster
+        self.node_pubsub_mapping = {}
+        self._pubsubs_generator = self._pubsubs_generator()
         super().__init__(
-            **kwargs, connection_pool=connection_pool, encoder=redis_cluster.encoder
+            connection_pool=connection_pool,
+            encoder=redis_cluster.encoder,
+            push_handler_func=push_handler_func,
+            **kwargs,
         )
 
     def set_pubsub_node(self, cluster, node=None, host=None, port=None):
@@ -1707,9 +1728,9 @@ def _raise_on_invalid_node(self, redis_cluster, node, host, port):
                 f"Node {host}:{port} doesn't exist in the cluster"
             )
 
-    def execute_command(self, *args, **kwargs):
+    def execute_command(self, *args):
         """
-        Execute a publish/subscribe command.
+        Execute a subscribe/unsubscribe command.
 
         Taken code from redis-py and tweak to make it work within a cluster.
         """
@@ -1739,9 +1760,94 @@ def execute_command(self, *args, **kwargs):
             # register a callback that re-subscribes to any channels we
             # were listening to when we were disconnected
             self.connection.register_connect_callback(self.on_connect)
+            if self.push_handler_func is not None and not HIREDIS_AVAILABLE:
+                self.connection._parser.set_push_handler(self.push_handler_func)
         connection = self.connection
         self._execute(connection, connection.send_command, *args)
 
+    def _get_node_pubsub(self, node):
+        try:
+            return self.node_pubsub_mapping[node.name]
+        except KeyError:
+            pubsub = node.redis_connection.pubsub(
+                push_handler_func=self.push_handler_func
+            )
+            self.node_pubsub_mapping[node.name] = pubsub
+            return pubsub
+
+    def _sharded_message_generator(self):
+        for _ in range(len(self.node_pubsub_mapping)):
+            pubsub = next(self._pubsubs_generator)
+            message = pubsub.get_message()
+            if message is not None:
+                return message
+        return None
+
+    def _pubsubs_generator(self):
+        while True:
+            for pubsub in self.node_pubsub_mapping.values():
+                yield pubsub
+
+    def get_sharded_message(
+        self, ignore_subscribe_messages=False, timeout=0.0, target_node=None
+    ):
+        if target_node:
+            message = self.node_pubsub_mapping[target_node.name].get_message(
+                ignore_subscribe_messages=ignore_subscribe_messages, timeout=timeout
+            )
+        else:
+            message = self._sharded_message_generator()
+        if message is None:
+            return None
+        elif str_if_bytes(message["type"]) == "sunsubscribe":
+            if message["channel"] in self.pending_unsubscribe_shard_channels:
+                self.pending_unsubscribe_shard_channels.remove(message["channel"])
+                self.shard_channels.pop(message["channel"], None)
+                node = self.cluster.get_node_from_key(message["channel"])
+                if self.node_pubsub_mapping[node.name].subscribed is False:
+                    self.node_pubsub_mapping.pop(node.name)
+        if not self.channels and not self.patterns and not self.shard_channels:
+            # There are no subscriptions anymore, set subscribed_event flag
+            # to false
+            self.subscribed_event.clear()
+        if self.ignore_subscribe_messages or ignore_subscribe_messages:
+            return None
+        return message
+
+    def ssubscribe(self, *args, **kwargs):
+        if args:
+            args = list_or_args(args[0], args[1:])
+        s_channels = dict.fromkeys(args)
+        s_channels.update(kwargs)
+        for s_channel, handler in s_channels.items():
+            node = self.cluster.get_node_from_key(s_channel)
+            pubsub = self._get_node_pubsub(node)
+            if handler:
+                pubsub.ssubscribe(**{s_channel: handler})
+            else:
+                pubsub.ssubscribe(s_channel)
+            self.shard_channels.update(pubsub.shard_channels)
+            self.pending_unsubscribe_shard_channels.difference_update(
+                self._normalize_keys({s_channel: None})
+            )
+            if pubsub.subscribed and not self.subscribed:
+                self.subscribed_event.set()
+                self.health_check_response_counter = 0
+
+    def sunsubscribe(self, *args):
+        if args:
+            args = list_or_args(args[0], args[1:])
+        else:
+            args = self.shard_channels
+
+        for s_channel in args:
+            node = self.cluster.get_node_from_key(s_channel)
+            p = self._get_node_pubsub(node)
+            p.sunsubscribe(s_channel)
+            self.pending_unsubscribe_shard_channels.update(
+                p.pending_unsubscribe_shard_channels
+            )
+
     def get_redis_connection(self):
         """
         Get the Redis connection of the pubsub connected node.
@@ -1749,6 +1855,15 @@ def get_redis_connection(self):
         if self.node is not None:
             return self.node.redis_connection
 
+    def disconnect(self):
+        """
+        Disconnect the pubsub connection.
+        """
+        if self.connection:
+            self.connection.disconnect()
+        for pubsub in self.node_pubsub_mapping.values():
+            pubsub.connection.disconnect()
+
 
 class ClusterPipeline(RedisCluster):
     """
diff --git a/redis/commands/__init__.py b/redis/commands/__init__.py
index f3f08286c8..a94d9764a6 100644
--- a/redis/commands/__init__.py
+++ b/redis/commands/__init__.py
@@ -1,7 +1,6 @@
 from .cluster import READ_COMMANDS, AsyncRedisClusterCommands, RedisClusterCommands
 from .core import AsyncCoreCommands, CoreCommands
 from .helpers import list_or_args
-from .parser import CommandsParser
 from .redismodules import AsyncRedisModuleCommands, RedisModuleCommands
 from .sentinel import AsyncSentinelCommands, SentinelCommands
 
@@ -10,7 +9,6 @@
     "AsyncRedisClusterCommands",
     "AsyncRedisModuleCommands",
     "AsyncSentinelCommands",
-    "CommandsParser",
     "CoreCommands",
     "READ_COMMANDS",
     "RedisClusterCommands",
diff --git a/redis/commands/bf/__init__.py b/redis/commands/bf/__init__.py
index 4da060e995..bfa9456879 100644
--- a/redis/commands/bf/__init__.py
+++ b/redis/commands/bf/__init__.py
@@ -1,4 +1,4 @@
-from redis.client import bool_ok
+from redis._parsers.helpers import bool_ok
 
 from ..helpers import parse_to_list
 from .commands import *  # noqa
@@ -91,20 +91,29 @@ class CMSBloom(CMSCommands, AbstractBloom):
     def __init__(self, client, **kwargs):
         """Create a new RedisBloom client."""
         # Set the module commands' callbacks
-        MODULE_CALLBACKS = {
+        _MODULE_CALLBACKS = {
             CMS_INITBYDIM: bool_ok,
             CMS_INITBYPROB: bool_ok,
             # CMS_INCRBY: spaceHolder,
             # CMS_QUERY: spaceHolder,
             CMS_MERGE: bool_ok,
+        }
+
+        _RESP2_MODULE_CALLBACKS = {
             CMS_INFO: CMSInfo,
         }
+        _RESP3_MODULE_CALLBACKS = {}
 
         self.client = client
         self.commandmixin = CMSCommands
         self.execute_command = client.execute_command
 
-        for k, v in MODULE_CALLBACKS.items():
+        if self.client.connection_pool.connection_kwargs.get("protocol") in ["3", 3]:
+            _MODULE_CALLBACKS.update(_RESP3_MODULE_CALLBACKS)
+        else:
+            _MODULE_CALLBACKS.update(_RESP2_MODULE_CALLBACKS)
+
+        for k, v in _MODULE_CALLBACKS.items():
             self.client.set_response_callback(k, v)
 
 
@@ -112,21 +121,30 @@ class TOPKBloom(TOPKCommands, AbstractBloom):
     def __init__(self, client, **kwargs):
         """Create a new RedisBloom client."""
         # Set the module commands' callbacks
-        MODULE_CALLBACKS = {
+        _MODULE_CALLBACKS = {
             TOPK_RESERVE: bool_ok,
-            TOPK_ADD: parse_to_list,
-            TOPK_INCRBY: parse_to_list,
             # TOPK_QUERY: spaceHolder,
             # TOPK_COUNT: spaceHolder,
-            TOPK_LIST: parse_to_list,
+        }
+
+        _RESP2_MODULE_CALLBACKS = {
+            TOPK_ADD: parse_to_list,
+            TOPK_INCRBY: parse_to_list,
             TOPK_INFO: TopKInfo,
+            TOPK_LIST: parse_to_list,
         }
+        _RESP3_MODULE_CALLBACKS = {}
 
         self.client = client
         self.commandmixin = TOPKCommands
         self.execute_command = client.execute_command
 
-        for k, v in MODULE_CALLBACKS.items():
+        if self.client.connection_pool.connection_kwargs.get("protocol") in ["3", 3]:
+            _MODULE_CALLBACKS.update(_RESP3_MODULE_CALLBACKS)
+        else:
+            _MODULE_CALLBACKS.update(_RESP2_MODULE_CALLBACKS)
+
+        for k, v in _MODULE_CALLBACKS.items():
             self.client.set_response_callback(k, v)
 
 
@@ -134,7 +152,7 @@ class CFBloom(CFCommands, AbstractBloom):
     def __init__(self, client, **kwargs):
         """Create a new RedisBloom client."""
         # Set the module commands' callbacks
-        MODULE_CALLBACKS = {
+        _MODULE_CALLBACKS = {
             CF_RESERVE: bool_ok,
             # CF_ADD: spaceHolder,
             # CF_ADDNX: spaceHolder,
@@ -145,14 +163,23 @@ def __init__(self, client, **kwargs):
             # CF_COUNT: spaceHolder,
             # CF_SCANDUMP: spaceHolder,
             # CF_LOADCHUNK: spaceHolder,
+        }
+
+        _RESP2_MODULE_CALLBACKS = {
             CF_INFO: CFInfo,
         }
+        _RESP3_MODULE_CALLBACKS = {}
 
         self.client = client
         self.commandmixin = CFCommands
         self.execute_command = client.execute_command
 
-        for k, v in MODULE_CALLBACKS.items():
+        if self.client.connection_pool.connection_kwargs.get("protocol") in ["3", 3]:
+            _MODULE_CALLBACKS.update(_RESP3_MODULE_CALLBACKS)
+        else:
+            _MODULE_CALLBACKS.update(_RESP2_MODULE_CALLBACKS)
+
+        for k, v in _MODULE_CALLBACKS.items():
             self.client.set_response_callback(k, v)
 
 
@@ -160,28 +187,35 @@ class TDigestBloom(TDigestCommands, AbstractBloom):
     def __init__(self, client, **kwargs):
         """Create a new RedisBloom client."""
         # Set the module commands' callbacks
-        MODULE_CALLBACKS = {
+        _MODULE_CALLBACKS = {
             TDIGEST_CREATE: bool_ok,
             # TDIGEST_RESET: bool_ok,
             # TDIGEST_ADD: spaceHolder,
             # TDIGEST_MERGE: spaceHolder,
+        }
+
+        _RESP2_MODULE_CALLBACKS = {
+            TDIGEST_BYRANK: parse_to_list,
+            TDIGEST_BYREVRANK: parse_to_list,
             TDIGEST_CDF: parse_to_list,
-            TDIGEST_QUANTILE: parse_to_list,
+            TDIGEST_INFO: TDigestInfo,
             TDIGEST_MIN: float,
             TDIGEST_MAX: float,
             TDIGEST_TRIMMED_MEAN: float,
-            TDIGEST_INFO: TDigestInfo,
-            TDIGEST_RANK: parse_to_list,
-            TDIGEST_REVRANK: parse_to_list,
-            TDIGEST_BYRANK: parse_to_list,
-            TDIGEST_BYREVRANK: parse_to_list,
+            TDIGEST_QUANTILE: parse_to_list,
         }
+        _RESP3_MODULE_CALLBACKS = {}
 
         self.client = client
         self.commandmixin = TDigestCommands
         self.execute_command = client.execute_command
 
-        for k, v in MODULE_CALLBACKS.items():
+        if self.client.connection_pool.connection_kwargs.get("protocol") in ["3", 3]:
+            _MODULE_CALLBACKS.update(_RESP3_MODULE_CALLBACKS)
+        else:
+            _MODULE_CALLBACKS.update(_RESP2_MODULE_CALLBACKS)
+
+        for k, v in _MODULE_CALLBACKS.items():
             self.client.set_response_callback(k, v)
 
 
@@ -189,7 +223,7 @@ class BFBloom(BFCommands, AbstractBloom):
     def __init__(self, client, **kwargs):
         """Create a new RedisBloom client."""
         # Set the module commands' callbacks
-        MODULE_CALLBACKS = {
+        _MODULE_CALLBACKS = {
             BF_RESERVE: bool_ok,
             # BF_ADD: spaceHolder,
             # BF_MADD: spaceHolder,
@@ -199,12 +233,21 @@ def __init__(self, client, **kwargs):
             # BF_SCANDUMP: spaceHolder,
             # BF_LOADCHUNK: spaceHolder,
             # BF_CARD: spaceHolder,
+        }
+
+        _RESP2_MODULE_CALLBACKS = {
             BF_INFO: BFInfo,
         }
+        _RESP3_MODULE_CALLBACKS = {}
 
         self.client = client
         self.commandmixin = BFCommands
         self.execute_command = client.execute_command
 
-        for k, v in MODULE_CALLBACKS.items():
+        if self.client.connection_pool.connection_kwargs.get("protocol") in ["3", 3]:
+            _MODULE_CALLBACKS.update(_RESP3_MODULE_CALLBACKS)
+        else:
+            _MODULE_CALLBACKS.update(_RESP2_MODULE_CALLBACKS)
+
+        for k, v in _MODULE_CALLBACKS.items():
             self.client.set_response_callback(k, v)
diff --git a/redis/commands/bf/commands.py b/redis/commands/bf/commands.py
index c45523c99b..447f844508 100644
--- a/redis/commands/bf/commands.py
+++ b/redis/commands/bf/commands.py
@@ -60,7 +60,6 @@
 class BFCommands:
     """Bloom Filter commands."""
 
-    # region Bloom Filter Functions
     def create(self, key, errorRate, capacity, expansion=None, noScale=None):
         """
         Create a new Bloom Filter `key` with desired probability of false positives
@@ -178,7 +177,6 @@ def card(self, key):
 class CFCommands:
     """Cuckoo Filter commands."""
 
-    # region Cuckoo Filter Functions
     def create(
         self, key, capacity, expansion=None, bucket_size=None, max_iterations=None
     ):
@@ -488,7 +486,6 @@ def byrevrank(self, key, rank, *ranks):
 class CMSCommands:
     """Count-Min Sketch Commands"""
 
-    # region Count-Min Sketch Functions
     def initbydim(self, key, width, depth):
         """
         Initialize a Count-Min Sketch `key` to dimensions (`width`, `depth`) specified by user.
diff --git a/redis/commands/bf/info.py b/redis/commands/bf/info.py
index c526e6ca4c..e1f0208609 100644
--- a/redis/commands/bf/info.py
+++ b/redis/commands/bf/info.py
@@ -16,6 +16,15 @@ def __init__(self, args):
         self.insertedNum = response["Number of items inserted"]
         self.expansionRate = response["Expansion rate"]
 
+    def get(self, item):
+        try:
+            return self.__getitem__(item)
+        except AttributeError:
+            return None
+
+    def __getitem__(self, item):
+        return getattr(self, item)
+
 
 class CFInfo(object):
     size = None
@@ -38,6 +47,15 @@ def __init__(self, args):
         self.expansionRate = response["Expansion rate"]
         self.maxIteration = response["Max iterations"]
 
+    def get(self, item):
+        try:
+            return self.__getitem__(item)
+        except AttributeError:
+            return None
+
+    def __getitem__(self, item):
+        return getattr(self, item)
+
 
 class CMSInfo(object):
     width = None
@@ -50,6 +68,9 @@ def __init__(self, args):
         self.depth = response["depth"]
         self.count = response["count"]
 
+    def __getitem__(self, item):
+        return getattr(self, item)
+
 
 class TopKInfo(object):
     k = None
@@ -64,6 +85,9 @@ def __init__(self, args):
         self.depth = response["depth"]
         self.decay = response["decay"]
 
+    def __getitem__(self, item):
+        return getattr(self, item)
+
 
 class TDigestInfo(object):
     compression = None
@@ -85,3 +109,12 @@ def __init__(self, args):
         self.unmerged_weight = response["Unmerged weight"]
         self.total_compressions = response["Total compressions"]
         self.memory_usage = response["Memory usage"]
+
+    def get(self, item):
+        try:
+            return self.__getitem__(item)
+        except AttributeError:
+            return None
+
+    def __getitem__(self, item):
+        return getattr(self, item)
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 392ddb542c..6abcd5a2ec 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3365,9 +3365,13 @@ def sinterstore(
         args = list_or_args(keys, args)
         return self.execute_command("SINTERSTORE", dest, *args)
 
-    def sismember(self, name: str, value: str) -> Union[Awaitable[bool], bool]:
+    def sismember(
+        self, name: str, value: str
+    ) -> Union[Awaitable[Union[Literal[0], Literal[1]]], Union[Literal[0], Literal[1]]]:
         """
-        Return a boolean indicating if ``value`` is a member of set ``name``
+        Return whether ``value`` is a member of set ``name``:
+        - 1 if the value is a member of the set.
+        - 0 if the value is not a member of the set or if key does not exist.
 
         For more information see https://redis.io/commands/sismember
         """
@@ -5147,6 +5151,15 @@ def publish(self, channel: ChannelT, message: EncodableT, **kwargs) -> ResponseT
         """
         return self.execute_command("PUBLISH", channel, message, **kwargs)
 
+    def spublish(self, shard_channel: ChannelT, message: EncodableT) -> ResponseT:
+        """
+        Posts a message to the given shard channel.
+        Returns the number of clients that received the message
+
+        For more information see https://redis.io/commands/spublish
+        """
+        return self.execute_command("SPUBLISH", shard_channel, message)
+
     def pubsub_channels(self, pattern: PatternT = "*", **kwargs) -> ResponseT:
         """
         Return a list of channels that have at least one subscriber
@@ -5155,6 +5168,14 @@ def pubsub_channels(self, pattern: PatternT = "*", **kwargs) -> ResponseT:
         """
         return self.execute_command("PUBSUB CHANNELS", pattern, **kwargs)
 
+    def pubsub_shardchannels(self, pattern: PatternT = "*", **kwargs) -> ResponseT:
+        """
+        Return a list of shard_channels that have at least one subscriber
+
+        For more information see https://redis.io/commands/pubsub-shardchannels
+        """
+        return self.execute_command("PUBSUB SHARDCHANNELS", pattern, **kwargs)
+
     def pubsub_numpat(self, **kwargs) -> ResponseT:
         """
         Returns the number of subscriptions to patterns
@@ -5172,6 +5193,15 @@ def pubsub_numsub(self, *args: ChannelT, **kwargs) -> ResponseT:
         """
         return self.execute_command("PUBSUB NUMSUB", *args, **kwargs)
 
+    def pubsub_shardnumsub(self, *args: ChannelT, **kwargs) -> ResponseT:
+        """
+        Return a list of (shard_channel, number of subscribers) tuples
+        for each channel given in ``*args``
+
+        For more information see https://redis.io/commands/pubsub-shardnumsub
+        """
+        return self.execute_command("PUBSUB SHARDNUMSUB", *args, **kwargs)
+
 
 AsyncPubSubCommands = PubSubCommands
 
diff --git a/redis/commands/json/__init__.py b/redis/commands/json/__init__.py
index 4f2a0c5ffc..e895e6a2ba 100644
--- a/redis/commands/json/__init__.py
+++ b/redis/commands/json/__init__.py
@@ -31,37 +31,54 @@ def __init__(
         :type json.JSONEncoder: An instance of json.JSONEncoder
         """
         # Set the module commands' callbacks
-        self.MODULE_CALLBACKS = {
-            "JSON.CLEAR": int,
-            "JSON.DEL": int,
-            "JSON.FORGET": int,
-            "JSON.GET": self._decode,
+        self._MODULE_CALLBACKS = {
+            "JSON.ARRPOP": self._decode,
+            "JSON.DEBUG": self._decode,
+            "JSON.MERGE": lambda r: r and nativestr(r) == "OK",
             "JSON.MGET": bulk_of_jsons(self._decode),
-            "JSON.SET": lambda r: r and nativestr(r) == "OK",
             "JSON.MSET": lambda r: r and nativestr(r) == "OK",
-            "JSON.MERGE": lambda r: r and nativestr(r) == "OK",
-            "JSON.NUMINCRBY": self._decode,
-            "JSON.NUMMULTBY": self._decode,
+            "JSON.RESP": self._decode,
+            "JSON.SET": lambda r: r and nativestr(r) == "OK",
             "JSON.TOGGLE": self._decode,
-            "JSON.STRAPPEND": self._decode,
-            "JSON.STRLEN": self._decode,
+        }
+
+        _RESP2_MODULE_CALLBACKS = {
             "JSON.ARRAPPEND": self._decode,
             "JSON.ARRINDEX": self._decode,
             "JSON.ARRINSERT": self._decode,
             "JSON.ARRLEN": self._decode,
-            "JSON.ARRPOP": self._decode,
             "JSON.ARRTRIM": self._decode,
-            "JSON.OBJLEN": self._decode,
+            "JSON.CLEAR": int,
+            "JSON.DEL": int,
+            "JSON.FORGET": int,
+            "JSON.GET": self._decode,
+            "JSON.NUMINCRBY": self._decode,
+            "JSON.NUMMULTBY": self._decode,
             "JSON.OBJKEYS": self._decode,
-            "JSON.RESP": self._decode,
-            "JSON.DEBUG": self._decode,
+            "JSON.STRAPPEND": self._decode,
+            "JSON.OBJLEN": self._decode,
+            "JSON.STRLEN": self._decode,
+            "JSON.TOGGLE": self._decode,
+        }
+
+        _RESP3_MODULE_CALLBACKS = {
+            "JSON.GET": lambda response: [
+                [self._decode(r) for r in res] for res in response
+            ]
+            if response
+            else response
         }
 
         self.client = client
         self.execute_command = client.execute_command
         self.MODULE_VERSION = version
 
-        for key, value in self.MODULE_CALLBACKS.items():
+        if self.client.connection_pool.connection_kwargs.get("protocol") in ["3", 3]:
+            self._MODULE_CALLBACKS.update(_RESP3_MODULE_CALLBACKS)
+        else:
+            self._MODULE_CALLBACKS.update(_RESP2_MODULE_CALLBACKS)
+
+        for key, value in self._MODULE_CALLBACKS.items():
             self.client.set_response_callback(key, value)
 
         self.__encoder__ = encoder
@@ -117,7 +134,7 @@ def pipeline(self, transaction=True, shard_hint=None):
         else:
             p = Pipeline(
                 connection_pool=self.client.connection_pool,
-                response_callbacks=self.MODULE_CALLBACKS,
+                response_callbacks=self._MODULE_CALLBACKS,
                 transaction=transaction,
                 shard_hint=shard_hint,
             )
diff --git a/redis/commands/search/__init__.py b/redis/commands/search/__init__.py
index 70e9c279e5..e635f91e99 100644
--- a/redis/commands/search/__init__.py
+++ b/redis/commands/search/__init__.py
@@ -1,7 +1,17 @@
 import redis
 
 from ...asyncio.client import Pipeline as AsyncioPipeline
-from .commands import AsyncSearchCommands, SearchCommands
+from .commands import (
+    AGGREGATE_CMD,
+    CONFIG_CMD,
+    INFO_CMD,
+    PROFILE_CMD,
+    SEARCH_CMD,
+    SPELLCHECK_CMD,
+    SYNDUMP_CMD,
+    AsyncSearchCommands,
+    SearchCommands,
+)
 
 
 class Search(SearchCommands):
@@ -85,11 +95,20 @@ def __init__(self, client, index_name="idx"):
 
         If conn is not None, we employ an already existing redis connection
         """
-        self.MODULE_CALLBACKS = {}
+        self._MODULE_CALLBACKS = {}
         self.client = client
         self.index_name = index_name
         self.execute_command = client.execute_command
         self._pipeline = client.pipeline
+        self._RESP2_MODULE_CALLBACKS = {
+            INFO_CMD: self._parse_info,
+            SEARCH_CMD: self._parse_search,
+            AGGREGATE_CMD: self._parse_aggregate,
+            PROFILE_CMD: self._parse_profile,
+            SPELLCHECK_CMD: self._parse_spellcheck,
+            CONFIG_CMD: self._parse_config_get,
+            SYNDUMP_CMD: self._parse_syndump,
+        }
 
     def pipeline(self, transaction=True, shard_hint=None):
         """Creates a pipeline for the SEARCH module, that can be used for executing
@@ -97,7 +116,7 @@ def pipeline(self, transaction=True, shard_hint=None):
         """
         p = Pipeline(
             connection_pool=self.client.connection_pool,
-            response_callbacks=self.MODULE_CALLBACKS,
+            response_callbacks=self._MODULE_CALLBACKS,
             transaction=transaction,
             shard_hint=shard_hint,
         )
@@ -155,7 +174,7 @@ def pipeline(self, transaction=True, shard_hint=None):
         """
         p = AsyncPipeline(
             connection_pool=self.client.connection_pool,
-            response_callbacks=self.MODULE_CALLBACKS,
+            response_callbacks=self._MODULE_CALLBACKS,
             transaction=transaction,
             shard_hint=shard_hint,
         )
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 3bd7d47aa8..742474523f 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -63,6 +63,86 @@
 class SearchCommands:
     """Search commands."""
 
+    def _parse_results(self, cmd, res, **kwargs):
+        if self.client.connection_pool.connection_kwargs.get("protocol") in ["3", 3]:
+            return res
+        else:
+            return self._RESP2_MODULE_CALLBACKS[cmd](res, **kwargs)
+
+    def _parse_info(self, res, **kwargs):
+        it = map(to_string, res)
+        return dict(zip(it, it))
+
+    def _parse_search(self, res, **kwargs):
+        return Result(
+            res,
+            not kwargs["query"]._no_content,
+            duration=kwargs["duration"],
+            has_payload=kwargs["query"]._with_payloads,
+            with_scores=kwargs["query"]._with_scores,
+        )
+
+    def _parse_aggregate(self, res, **kwargs):
+        return self._get_aggregate_result(res, kwargs["query"], kwargs["has_cursor"])
+
+    def _parse_profile(self, res, **kwargs):
+        query = kwargs["query"]
+        if isinstance(query, AggregateRequest):
+            result = self._get_aggregate_result(res[0], query, query._cursor)
+        else:
+            result = Result(
+                res[0],
+                not query._no_content,
+                duration=kwargs["duration"],
+                has_payload=query._with_payloads,
+                with_scores=query._with_scores,
+            )
+
+        return result, parse_to_dict(res[1])
+
+    def _parse_spellcheck(self, res, **kwargs):
+        corrections = {}
+        if res == 0:
+            return corrections
+
+        for _correction in res:
+            if isinstance(_correction, int) and _correction == 0:
+                continue
+
+            if len(_correction) != 3:
+                continue
+            if not _correction[2]:
+                continue
+            if not _correction[2][0]:
+                continue
+
+            # For spellcheck output
+            # 1)  1) "TERM"
+            #     2) "{term1}"
+            #     3)  1)  1)  "{score1}"
+            #             2)  "{suggestion1}"
+            #         2)  1)  "{score2}"
+            #             2)  "{suggestion2}"
+            #
+            # Following dictionary will be made
+            # corrections = {
+            #     '{term1}': [
+            #         {'score': '{score1}', 'suggestion': '{suggestion1}'},
+            #         {'score': '{score2}', 'suggestion': '{suggestion2}'}
+            #     ]
+            # }
+            corrections[_correction[1]] = [
+                {"score": _item[0], "suggestion": _item[1]} for _item in _correction[2]
+            ]
+
+        return corrections
+
+    def _parse_config_get(self, res, **kwargs):
+        return {kvs[0]: kvs[1] for kvs in res} if res else {}
+
+    def _parse_syndump(self, res, **kwargs):
+        return {res[i]: res[i + 1] for i in range(0, len(res), 2)}
+
     def batch_indexer(self, chunk_size=100):
         """
         Create a new batch indexer from the client with a given chunk size
@@ -368,8 +448,7 @@ def info(self):
         """
 
         res = self.execute_command(INFO_CMD, self.index_name)
-        it = map(to_string, res)
-        return dict(zip(it, it))
+        return self._parse_results(INFO_CMD, res)
 
     def get_params_args(
         self, query_params: Union[Dict[str, Union[str, int, float]], None]
@@ -422,12 +501,8 @@ def search(
         if isinstance(res, Pipeline):
             return res
 
-        return Result(
-            res,
-            not query._no_content,
-            duration=(time.time() - st) * 1000.0,
-            has_payload=query._with_payloads,
-            with_scores=query._with_scores,
+        return self._parse_results(
+            SEARCH_CMD, res, query=query, duration=(time.time() - st) * 1000.0
         )
 
     def explain(
@@ -473,7 +548,9 @@ def aggregate(
         cmd += self.get_params_args(query_params)
 
         raw = self.execute_command(*cmd)
-        return self._get_aggregate_result(raw, query, has_cursor)
+        return self._parse_results(
+            AGGREGATE_CMD, raw, query=query, has_cursor=has_cursor
+        )
 
     def _get_aggregate_result(self, raw, query, has_cursor):
         if has_cursor:
@@ -531,18 +608,9 @@ def profile(
 
         res = self.execute_command(*cmd)
 
-        if isinstance(query, AggregateRequest):
-            result = self._get_aggregate_result(res[0], query, query._cursor)
-        else:
-            result = Result(
-                res[0],
-                not query._no_content,
-                duration=(time.time() - st) * 1000.0,
-                has_payload=query._with_payloads,
-                with_scores=query._with_scores,
-            )
-
-        return result, parse_to_dict(res[1])
+        return self._parse_results(
+            PROFILE_CMD, res, query=query, duration=(time.time() - st) * 1000.0
+        )
 
     def spellcheck(self, query, distance=None, include=None, exclude=None):
         """
@@ -568,43 +636,9 @@ def spellcheck(self, query, distance=None, include=None, exclude=None):
         if exclude:
             cmd.extend(["TERMS", "EXCLUDE", exclude])
 
-        raw = self.execute_command(*cmd)
-
-        corrections = {}
-        if raw == 0:
-            return corrections
-
-        for _correction in raw:
-            if isinstance(_correction, int) and _correction == 0:
-                continue
-
-            if len(_correction) != 3:
-                continue
-            if not _correction[2]:
-                continue
-            if not _correction[2][0]:
-                continue
-
-            # For spellcheck output
-            # 1)  1) "TERM"
-            #     2) "{term1}"
-            #     3)  1)  1)  "{score1}"
-            #             2)  "{suggestion1}"
-            #         2)  1)  "{score2}"
-            #             2)  "{suggestion2}"
-            #
-            # Following dictionary will be made
-            # corrections = {
-            #     '{term1}': [
-            #         {'score': '{score1}', 'suggestion': '{suggestion1}'},
-            #         {'score': '{score2}', 'suggestion': '{suggestion2}'}
-            #     ]
-            # }
-            corrections[_correction[1]] = [
-                {"score": _item[0], "suggestion": _item[1]} for _item in _correction[2]
-            ]
+        res = self.execute_command(*cmd)
 
-        return corrections
+        return self._parse_results(SPELLCHECK_CMD, res)
 
     def dict_add(self, name, *terms):
         """Adds terms to a dictionary.
@@ -670,12 +704,8 @@ def config_get(self, option):
         For more information see `FT.CONFIG GET <https://redis.io/commands/ft.config-get>`_.
         """  # noqa
         cmd = [CONFIG_CMD, "GET", option]
-        res = {}
-        raw = self.execute_command(*cmd)
-        if raw:
-            for kvs in raw:
-                res[kvs[0]] = kvs[1]
-        return res
+        res = self.execute_command(*cmd)
+        return self._parse_results(CONFIG_CMD, res)
 
     def tagvals(self, tagfield):
         """
@@ -810,12 +840,12 @@ def sugget(
         if with_payloads:
             args.append(WITHPAYLOADS)
 
-        ret = self.execute_command(*args)
+        res = self.execute_command(*args)
         results = []
-        if not ret:
+        if not res:
             return results
 
-        parser = SuggestionParser(with_scores, with_payloads, ret)
+        parser = SuggestionParser(with_scores, with_payloads, res)
         return [s for s in parser]
 
     def synupdate(self, groupid, skipinitial=False, *terms):
@@ -851,8 +881,8 @@ def syndump(self):
 
         For more information see `FT.SYNDUMP <https://redis.io/commands/ft.syndump>`_.
         """  # noqa
-        raw = self.execute_command(SYNDUMP_CMD, self.index_name)
-        return {raw[i]: raw[i + 1] for i in range(0, len(raw), 2)}
+        res = self.execute_command(SYNDUMP_CMD, self.index_name)
+        return self._parse_results(SYNDUMP_CMD, res)
 
 
 class AsyncSearchCommands(SearchCommands):
@@ -865,8 +895,7 @@ async def info(self):
         """
 
         res = await self.execute_command(INFO_CMD, self.index_name)
-        it = map(to_string, res)
-        return dict(zip(it, it))
+        return self._parse_results(INFO_CMD, res)
 
     async def search(
         self,
@@ -891,12 +920,8 @@ async def search(
         if isinstance(res, Pipeline):
             return res
 
-        return Result(
-            res,
-            not query._no_content,
-            duration=(time.time() - st) * 1000.0,
-            has_payload=query._with_payloads,
-            with_scores=query._with_scores,
+        return self._parse_results(
+            SEARCH_CMD, res, query=query, duration=(time.time() - st) * 1000.0
         )
 
     async def aggregate(
@@ -927,7 +952,9 @@ async def aggregate(
         cmd += self.get_params_args(query_params)
 
         raw = await self.execute_command(*cmd)
-        return self._get_aggregate_result(raw, query, has_cursor)
+        return self._parse_results(
+            AGGREGATE_CMD, raw, query=query, has_cursor=has_cursor
+        )
 
     async def spellcheck(self, query, distance=None, include=None, exclude=None):
         """
@@ -953,28 +980,9 @@ async def spellcheck(self, query, distance=None, include=None, exclude=None):
         if exclude:
             cmd.extend(["TERMS", "EXCLUDE", exclude])
 
-        raw = await self.execute_command(*cmd)
+        res = await self.execute_command(*cmd)
 
-        corrections = {}
-        if raw == 0:
-            return corrections
-
-        for _correction in raw:
-            if isinstance(_correction, int) and _correction == 0:
-                continue
-
-            if len(_correction) != 3:
-                continue
-            if not _correction[2]:
-                continue
-            if not _correction[2][0]:
-                continue
-
-            corrections[_correction[1]] = [
-                {"score": _item[0], "suggestion": _item[1]} for _item in _correction[2]
-            ]
-
-        return corrections
+        return self._parse_results(SPELLCHECK_CMD, res)
 
     async def config_set(self, option, value):
         """Set runtime configuration option.
@@ -1001,11 +1009,8 @@ async def config_get(self, option):
         """  # noqa
         cmd = [CONFIG_CMD, "GET", option]
         res = {}
-        raw = await self.execute_command(*cmd)
-        if raw:
-            for kvs in raw:
-                res[kvs[0]] = kvs[1]
-        return res
+        res = await self.execute_command(*cmd)
+        return self._parse_results(CONFIG_CMD, res)
 
     async def load_document(self, id):
         """
diff --git a/redis/commands/timeseries/__init__.py b/redis/commands/timeseries/__init__.py
index 4a6886f237..498f5118f1 100644
--- a/redis/commands/timeseries/__init__.py
+++ b/redis/commands/timeseries/__init__.py
@@ -1,4 +1,5 @@
 import redis
+from redis._parsers.helpers import bool_ok
 
 from ..helpers import parse_to_list
 from .commands import (
@@ -32,27 +33,36 @@ class TimeSeries(TimeSeriesCommands):
     def __init__(self, client=None, **kwargs):
         """Create a new RedisTimeSeries client."""
         # Set the module commands' callbacks
-        self.MODULE_CALLBACKS = {
-            CREATE_CMD: redis.client.bool_ok,
-            ALTER_CMD: redis.client.bool_ok,
-            CREATERULE_CMD: redis.client.bool_ok,
+        self._MODULE_CALLBACKS = {
+            ALTER_CMD: bool_ok,
+            CREATE_CMD: bool_ok,
+            CREATERULE_CMD: bool_ok,
+            DELETERULE_CMD: bool_ok,
+        }
+
+        _RESP2_MODULE_CALLBACKS = {
             DEL_CMD: int,
-            DELETERULE_CMD: redis.client.bool_ok,
-            RANGE_CMD: parse_range,
-            REVRANGE_CMD: parse_range,
-            MRANGE_CMD: parse_m_range,
-            MREVRANGE_CMD: parse_m_range,
             GET_CMD: parse_get,
-            MGET_CMD: parse_m_get,
             INFO_CMD: TSInfo,
+            MGET_CMD: parse_m_get,
+            MRANGE_CMD: parse_m_range,
+            MREVRANGE_CMD: parse_m_range,
+            RANGE_CMD: parse_range,
+            REVRANGE_CMD: parse_range,
             QUERYINDEX_CMD: parse_to_list,
         }
+        _RESP3_MODULE_CALLBACKS = {}
 
         self.client = client
         self.execute_command = client.execute_command
 
-        for key, value in self.MODULE_CALLBACKS.items():
-            self.client.set_response_callback(key, value)
+        if self.client.connection_pool.connection_kwargs.get("protocol") in ["3", 3]:
+            self._MODULE_CALLBACKS.update(_RESP3_MODULE_CALLBACKS)
+        else:
+            self._MODULE_CALLBACKS.update(_RESP2_MODULE_CALLBACKS)
+
+        for k, v in self._MODULE_CALLBACKS.items():
+            self.client.set_response_callback(k, v)
 
     def pipeline(self, transaction=True, shard_hint=None):
         """Creates a pipeline for the TimeSeries module, that can be used
@@ -83,7 +93,7 @@ def pipeline(self, transaction=True, shard_hint=None):
         else:
             p = Pipeline(
                 connection_pool=self.client.connection_pool,
-                response_callbacks=self.MODULE_CALLBACKS,
+                response_callbacks=self._MODULE_CALLBACKS,
                 transaction=transaction,
                 shard_hint=shard_hint,
             )
diff --git a/redis/commands/timeseries/info.py b/redis/commands/timeseries/info.py
index 65f3baacd0..3a384dc049 100644
--- a/redis/commands/timeseries/info.py
+++ b/redis/commands/timeseries/info.py
@@ -80,3 +80,12 @@ def __init__(self, args):
             self.duplicate_policy = response["duplicatePolicy"]
             if type(self.duplicate_policy) == bytes:
                 self.duplicate_policy = self.duplicate_policy.decode()
+
+    def get(self, item):
+        try:
+            return self.__getitem__(item)
+        except AttributeError:
+            return None
+
+    def __getitem__(self, item):
+        return getattr(self, item)
diff --git a/redis/compat.py b/redis/compat.py
index 738687f645..e478493467 100644
--- a/redis/compat.py
+++ b/redis/compat.py
@@ -2,8 +2,5 @@
 try:
     from typing import Literal, Protocol, TypedDict  # lgtm [py/unused-import]
 except ImportError:
-    from typing_extensions import (  # lgtm [py/unused-import]
-        Literal,
-        Protocol,
-        TypedDict,
-    )
+    from typing_extensions import Literal  # lgtm [py/unused-import]
+    from typing_extensions import Protocol, TypedDict
diff --git a/redis/connection.py b/redis/connection.py
index bec456c9ce..66debed2ea 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1,65 +1,39 @@
 import copy
-import errno
-import io
 import os
 import socket
+import ssl
 import sys
 import threading
 import weakref
 from abc import abstractmethod
-from io import SEEK_END
 from itertools import chain
 from queue import Empty, Full, LifoQueue
 from time import time
-from typing import Optional, Union
+from typing import Optional, Type, Union
 from urllib.parse import parse_qs, unquote, urlparse
 
-from redis.backoff import NoBackoff
-from redis.credentials import CredentialProvider, UsernamePasswordCredentialProvider
-from redis.exceptions import (
+from ._parsers import Encoder, _HiredisParser, _RESP2Parser, _RESP3Parser
+from .backoff import NoBackoff
+from .credentials import CredentialProvider, UsernamePasswordCredentialProvider
+from .exceptions import (
     AuthenticationError,
     AuthenticationWrongNumberOfArgsError,
-    BusyLoadingError,
     ChildDeadlockedError,
     ConnectionError,
     DataError,
-    ExecAbortError,
-    InvalidResponse,
-    ModuleError,
-    NoPermissionError,
-    NoScriptError,
-    OutOfMemoryError,
-    ReadOnlyError,
     RedisError,
     ResponseError,
     TimeoutError,
 )
-from redis.retry import Retry
-from redis.utils import (
+from .retry import Retry
+from .utils import (
     CRYPTOGRAPHY_AVAILABLE,
     HIREDIS_AVAILABLE,
     HIREDIS_PACK_AVAILABLE,
+    SSL_AVAILABLE,
     str_if_bytes,
 )
 
-try:
-    import ssl
-
-    ssl_available = True
-except ImportError:
-    ssl_available = False
-
-NONBLOCKING_EXCEPTION_ERROR_NUMBERS = {BlockingIOError: errno.EWOULDBLOCK}
-
-if ssl_available:
-    if hasattr(ssl, "SSLWantReadError"):
-        NONBLOCKING_EXCEPTION_ERROR_NUMBERS[ssl.SSLWantReadError] = 2
-        NONBLOCKING_EXCEPTION_ERROR_NUMBERS[ssl.SSLWantWriteError] = 2
-    else:
-        NONBLOCKING_EXCEPTION_ERROR_NUMBERS[ssl.SSLError] = 2
-
-NONBLOCKING_EXCEPTIONS = tuple(NONBLOCKING_EXCEPTION_ERROR_NUMBERS.keys())
-
 if HIREDIS_AVAILABLE:
     import hiredis
 
@@ -68,454 +42,15 @@
 SYM_CRLF = b"\r\n"
 SYM_EMPTY = b""
 
-SERVER_CLOSED_CONNECTION_ERROR = "Connection closed by server."
+DEFAULT_RESP_VERSION = 2
 
 SENTINEL = object()
-MODULE_LOAD_ERROR = "Error loading the extension. Please check the server logs."
-NO_SUCH_MODULE_ERROR = "Error unloading module: no such module with that name"
-MODULE_UNLOAD_NOT_POSSIBLE_ERROR = "Error unloading module: operation not possible."
-MODULE_EXPORTS_DATA_TYPES_ERROR = (
-    "Error unloading module: the module "
-    "exports one or more module-side data "
-    "types, can't unload"
-)
-# user send an AUTH cmd to a server without authorization configured
-NO_AUTH_SET_ERROR = {
-    # Redis >= 6.0
-    "AUTH <password> called without any password "
-    "configured for the default user. Are you sure "
-    "your configuration is correct?": AuthenticationError,
-    # Redis < 6.0
-    "Client sent AUTH, but no password is set": AuthenticationError,
-}
-
-
-class Encoder:
-    "Encode strings to bytes-like and decode bytes-like to strings"
-
-    def __init__(self, encoding, encoding_errors, decode_responses):
-        self.encoding = encoding
-        self.encoding_errors = encoding_errors
-        self.decode_responses = decode_responses
-
-    def encode(self, value):
-        "Return a bytestring or bytes-like representation of the value"
-        if isinstance(value, (bytes, memoryview)):
-            return value
-        elif isinstance(value, bool):
-            # special case bool since it is a subclass of int
-            raise DataError(
-                "Invalid input of type: 'bool'. Convert to a "
-                "bytes, string, int or float first."
-            )
-        elif isinstance(value, (int, float)):
-            value = repr(value).encode()
-        elif not isinstance(value, str):
-            # a value we don't know how to deal with. throw an error
-            typename = type(value).__name__
-            raise DataError(
-                f"Invalid input of type: '{typename}'. "
-                f"Convert to a bytes, string, int or float first."
-            )
-        if isinstance(value, str):
-            value = value.encode(self.encoding, self.encoding_errors)
-        return value
-
-    def decode(self, value, force=False):
-        "Return a unicode string from the bytes-like representation"
-        if self.decode_responses or force:
-            if isinstance(value, memoryview):
-                value = value.tobytes()
-            if isinstance(value, bytes):
-                value = value.decode(self.encoding, self.encoding_errors)
-        return value
-
-
-class BaseParser:
-    EXCEPTION_CLASSES = {
-        "ERR": {
-            "max number of clients reached": ConnectionError,
-            "invalid password": AuthenticationError,
-            # some Redis server versions report invalid command syntax
-            # in lowercase
-            "wrong number of arguments "
-            "for 'auth' command": AuthenticationWrongNumberOfArgsError,
-            # some Redis server versions report invalid command syntax
-            # in uppercase
-            "wrong number of arguments "
-            "for 'AUTH' command": AuthenticationWrongNumberOfArgsError,
-            MODULE_LOAD_ERROR: ModuleError,
-            MODULE_EXPORTS_DATA_TYPES_ERROR: ModuleError,
-            NO_SUCH_MODULE_ERROR: ModuleError,
-            MODULE_UNLOAD_NOT_POSSIBLE_ERROR: ModuleError,
-            **NO_AUTH_SET_ERROR,
-        },
-        "OOM": OutOfMemoryError,
-        "WRONGPASS": AuthenticationError,
-        "EXECABORT": ExecAbortError,
-        "LOADING": BusyLoadingError,
-        "NOSCRIPT": NoScriptError,
-        "READONLY": ReadOnlyError,
-        "NOAUTH": AuthenticationError,
-        "NOPERM": NoPermissionError,
-    }
-
-    @classmethod
-    def parse_error(cls, response):
-        "Parse an error response"
-        error_code = response.split(" ")[0]
-        if error_code in cls.EXCEPTION_CLASSES:
-            response = response[len(error_code) + 1 :]
-            exception_class = cls.EXCEPTION_CLASSES[error_code]
-            if isinstance(exception_class, dict):
-                exception_class = exception_class.get(response, ResponseError)
-            return exception_class(response)
-        return ResponseError(response)
-
-
-class SocketBuffer:
-    def __init__(
-        self, socket: socket.socket, socket_read_size: int, socket_timeout: float
-    ):
-        self._sock = socket
-        self.socket_read_size = socket_read_size
-        self.socket_timeout = socket_timeout
-        self._buffer = io.BytesIO()
-
-    def unread_bytes(self) -> int:
-        """
-        Remaining unread length of buffer
-        """
-        pos = self._buffer.tell()
-        end = self._buffer.seek(0, SEEK_END)
-        self._buffer.seek(pos)
-        return end - pos
-
-    def _read_from_socket(
-        self,
-        length: Optional[int] = None,
-        timeout: Union[float, object] = SENTINEL,
-        raise_on_timeout: Optional[bool] = True,
-    ) -> bool:
-        sock = self._sock
-        socket_read_size = self.socket_read_size
-        marker = 0
-        custom_timeout = timeout is not SENTINEL
-
-        buf = self._buffer
-        current_pos = buf.tell()
-        buf.seek(0, SEEK_END)
-        if custom_timeout:
-            sock.settimeout(timeout)
-        try:
-            while True:
-                data = self._sock.recv(socket_read_size)
-                # an empty string indicates the server shutdown the socket
-                if isinstance(data, bytes) and len(data) == 0:
-                    raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
-                buf.write(data)
-                data_length = len(data)
-                marker += data_length
-
-                if length is not None and length > marker:
-                    continue
-                return True
-        except socket.timeout:
-            if raise_on_timeout:
-                raise TimeoutError("Timeout reading from socket")
-            return False
-        except NONBLOCKING_EXCEPTIONS as ex:
-            # if we're in nonblocking mode and the recv raises a
-            # blocking error, simply return False indicating that
-            # there's no data to be read. otherwise raise the
-            # original exception.
-            allowed = NONBLOCKING_EXCEPTION_ERROR_NUMBERS.get(ex.__class__, -1)
-            if not raise_on_timeout and ex.errno == allowed:
-                return False
-            raise ConnectionError(f"Error while reading from socket: {ex.args}")
-        finally:
-            buf.seek(current_pos)
-            if custom_timeout:
-                sock.settimeout(self.socket_timeout)
-
-    def can_read(self, timeout: float) -> bool:
-        return bool(self.unread_bytes()) or self._read_from_socket(
-            timeout=timeout, raise_on_timeout=False
-        )
-
-    def read(self, length: int) -> bytes:
-        length = length + 2  # make sure to read the \r\n terminator
-        # BufferIO will return less than requested if buffer is short
-        data = self._buffer.read(length)
-        missing = length - len(data)
-        if missing:
-            # fill up the buffer and read the remainder
-            self._read_from_socket(missing)
-            data += self._buffer.read(missing)
-        return data[:-2]
-
-    def readline(self) -> bytes:
-        buf = self._buffer
-        data = buf.readline()
-        while not data.endswith(SYM_CRLF):
-            # there's more data in the socket that we need
-            self._read_from_socket()
-            data += buf.readline()
-
-        return data[:-2]
-
-    def get_pos(self) -> int:
-        """
-        Get current read position
-        """
-        return self._buffer.tell()
-
-    def rewind(self, pos: int) -> None:
-        """
-        Rewind the buffer to a specific position, to re-start reading
-        """
-        self._buffer.seek(pos)
-
-    def purge(self) -> None:
-        """
-        After a successful read, purge the read part of buffer
-        """
-        unread = self.unread_bytes()
-
-        # Only if we have read all of the buffer do we truncate, to
-        # reduce the amount of memory thrashing.  This heuristic
-        # can be changed or removed later.
-        if unread > 0:
-            return
-
-        if unread > 0:
-            # move unread data to the front
-            view = self._buffer.getbuffer()
-            view[:unread] = view[-unread:]
-        self._buffer.truncate(unread)
-        self._buffer.seek(0)
-
-    def close(self) -> None:
-        try:
-            self._buffer.close()
-        except Exception:
-            # issue #633 suggests the purge/close somehow raised a
-            # BadFileDescriptor error. Perhaps the client ran out of
-            # memory or something else? It's probably OK to ignore
-            # any error being raised from purge/close since we're
-            # removing the reference to the instance below.
-            pass
-        self._buffer = None
-        self._sock = None
-
-
-class PythonParser(BaseParser):
-    "Plain Python parsing class"
-
-    def __init__(self, socket_read_size):
-        self.socket_read_size = socket_read_size
-        self.encoder = None
-        self._sock = None
-        self._buffer = None
-
-    def __del__(self):
-        try:
-            self.on_disconnect()
-        except Exception:
-            pass
-
-    def on_connect(self, connection):
-        "Called when the socket connects"
-        self._sock = connection._sock
-        self._buffer = SocketBuffer(
-            self._sock, self.socket_read_size, connection.socket_timeout
-        )
-        self.encoder = connection.encoder
-
-    def on_disconnect(self):
-        "Called when the socket disconnects"
-        self._sock = None
-        if self._buffer is not None:
-            self._buffer.close()
-            self._buffer = None
-        self.encoder = None
-
-    def can_read(self, timeout):
-        return self._buffer and self._buffer.can_read(timeout)
-
-    def read_response(self, disable_decoding=False):
-        pos = self._buffer.get_pos() if self._buffer else None
-        try:
-            result = self._read_response(disable_decoding=disable_decoding)
-        except BaseException:
-            if self._buffer:
-                self._buffer.rewind(pos)
-            raise
-        else:
-            self._buffer.purge()
-            return result
-
-    def _read_response(self, disable_decoding=False):
-        raw = self._buffer.readline()
-        if not raw:
-            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
-
-        byte, response = raw[:1], raw[1:]
-
-        # server returned an error
-        if byte == b"-":
-            response = response.decode("utf-8", errors="replace")
-            error = self.parse_error(response)
-            # if the error is a ConnectionError, raise immediately so the user
-            # is notified
-            if isinstance(error, ConnectionError):
-                raise error
-            # otherwise, we're dealing with a ResponseError that might belong
-            # inside a pipeline response. the connection's read_response()
-            # and/or the pipeline's execute() will raise this error if
-            # necessary, so just return the exception instance here.
-            return error
-        # single value
-        elif byte == b"+":
-            pass
-        # int value
-        elif byte == b":":
-            return int(response)
-        # bulk response
-        elif byte == b"$" and response == b"-1":
-            return None
-        elif byte == b"$":
-            response = self._buffer.read(int(response))
-        # multi-bulk response
-        elif byte == b"*" and response == b"-1":
-            return None
-        elif byte == b"*":
-            response = [
-                self._read_response(disable_decoding=disable_decoding)
-                for i in range(int(response))
-            ]
-        else:
-            raise InvalidResponse(f"Protocol Error: {raw!r}")
-
-        if disable_decoding is False:
-            response = self.encoder.decode(response)
-        return response
-
-
-class HiredisParser(BaseParser):
-    "Parser class for connections using Hiredis"
-
-    def __init__(self, socket_read_size):
-        if not HIREDIS_AVAILABLE:
-            raise RedisError("Hiredis is not installed")
-        self.socket_read_size = socket_read_size
-        self._buffer = bytearray(socket_read_size)
-
-    def __del__(self):
-        try:
-            self.on_disconnect()
-        except Exception:
-            pass
-
-    def on_connect(self, connection, **kwargs):
-        self._sock = connection._sock
-        self._socket_timeout = connection.socket_timeout
-        kwargs = {
-            "protocolError": InvalidResponse,
-            "replyError": self.parse_error,
-            "errors": connection.encoder.encoding_errors,
-        }
-
-        if connection.encoder.decode_responses:
-            kwargs["encoding"] = connection.encoder.encoding
-        self._reader = hiredis.Reader(**kwargs)
-        self._next_response = False
-
-    def on_disconnect(self):
-        self._sock = None
-        self._reader = None
-        self._next_response = False
-
-    def can_read(self, timeout):
-        if not self._reader:
-            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
 
-        if self._next_response is False:
-            self._next_response = self._reader.gets()
-            if self._next_response is False:
-                return self.read_from_socket(timeout=timeout, raise_on_timeout=False)
-        return True
-
-    def read_from_socket(self, timeout=SENTINEL, raise_on_timeout=True):
-        sock = self._sock
-        custom_timeout = timeout is not SENTINEL
-        try:
-            if custom_timeout:
-                sock.settimeout(timeout)
-            bufflen = self._sock.recv_into(self._buffer)
-            if bufflen == 0:
-                raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
-            self._reader.feed(self._buffer, 0, bufflen)
-            # data was read from the socket and added to the buffer.
-            # return True to indicate that data was read.
-            return True
-        except socket.timeout:
-            if raise_on_timeout:
-                raise TimeoutError("Timeout reading from socket")
-            return False
-        except NONBLOCKING_EXCEPTIONS as ex:
-            # if we're in nonblocking mode and the recv raises a
-            # blocking error, simply return False indicating that
-            # there's no data to be read. otherwise raise the
-            # original exception.
-            allowed = NONBLOCKING_EXCEPTION_ERROR_NUMBERS.get(ex.__class__, -1)
-            if not raise_on_timeout and ex.errno == allowed:
-                return False
-            raise ConnectionError(f"Error while reading from socket: {ex.args}")
-        finally:
-            if custom_timeout:
-                sock.settimeout(self._socket_timeout)
-
-    def read_response(self, disable_decoding=False):
-        if not self._reader:
-            raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
-
-        # _next_response might be cached from a can_read() call
-        if self._next_response is not False:
-            response = self._next_response
-            self._next_response = False
-            return response
-
-        if disable_decoding:
-            response = self._reader.gets(False)
-        else:
-            response = self._reader.gets()
-
-        while response is False:
-            self.read_from_socket()
-            if disable_decoding:
-                response = self._reader.gets(False)
-            else:
-                response = self._reader.gets()
-        # if the response is a ConnectionError or the response is a list and
-        # the first item is a ConnectionError, raise it as something bad
-        # happened
-        if isinstance(response, ConnectionError):
-            raise response
-        elif (
-            isinstance(response, list)
-            and response
-            and isinstance(response[0], ConnectionError)
-        ):
-            raise response[0]
-        return response
-
-
-DefaultParser: BaseParser
+DefaultParser: Type[Union[_RESP2Parser, _RESP3Parser, _HiredisParser]]
 if HIREDIS_AVAILABLE:
-    DefaultParser = HiredisParser
+    DefaultParser = _HiredisParser
 else:
-    DefaultParser = PythonParser
+    DefaultParser = _RESP2Parser
 
 
 class HiredisRespSerializer:
@@ -609,6 +144,7 @@ def __init__(
         retry=None,
         redis_connect_func=None,
         credential_provider: Optional[CredentialProvider] = None,
+        protocol: Optional[int] = 2,
         command_packer=None,
     ):
         """
@@ -661,6 +197,17 @@ def __init__(
         self.set_parser(parser_class)
         self._connect_callbacks = []
         self._buffer_cutoff = 6000
+        try:
+            p = int(protocol)
+        except TypeError:
+            p = DEFAULT_RESP_VERSION
+        except ValueError:
+            raise ConnectionError("protocol must be an integer")
+        finally:
+            if p < 2 or p > 3:
+                raise ConnectionError("protocol must be either 2 or 3")
+                # p = DEFAULT_RESP_VERSION
+            self.protocol = p
         self._command_packer = self._construct_command_packer(command_packer)
 
     def __repr__(self):
@@ -747,7 +294,9 @@ def _error_message(self, exception):
     def on_connect(self):
         "Initialize the connection, authenticate and select a database"
         self._parser.on_connect(self)
+        parser = self._parser
 
+        auth_args = None
         # if credential provider or username and/or password are set, authenticate
         if self.credential_provider or (self.username or self.password):
             cred_provider = (
@@ -755,6 +304,24 @@ def on_connect(self):
                 or UsernamePasswordCredentialProvider(self.username, self.password)
             )
             auth_args = cred_provider.get_credentials()
+
+        # if resp version is specified and we have auth args,
+        # we need to send them via HELLO
+        if auth_args and self.protocol not in [2, "2"]:
+            if isinstance(self._parser, _RESP2Parser):
+                self.set_parser(_RESP3Parser)
+                # update cluster exception classes
+                self._parser.EXCEPTION_CLASSES = parser.EXCEPTION_CLASSES
+                self._parser.on_connect(self)
+            if len(auth_args) == 1:
+                auth_args = ["default", auth_args[0]]
+            self.send_command("HELLO", self.protocol, "AUTH", *auth_args)
+            response = self.read_response()
+            # if response.get(b"proto") != self.protocol and response.get(
+            #     "proto"
+            # ) != self.protocol:
+            #     raise ConnectionError("Invalid RESP version")
+        elif auth_args:
             # avoid checking health here -- PING will fail if we try
             # to check the health prior to the AUTH
             self.send_command("AUTH", *auth_args, check_health=False)
@@ -772,6 +339,21 @@ def on_connect(self):
             if str_if_bytes(auth_response) != "OK":
                 raise AuthenticationError("Invalid Username or Password")
 
+        # if resp version is specified, switch to it
+        elif self.protocol not in [2, "2"]:
+            if isinstance(self._parser, _RESP2Parser):
+                self.set_parser(_RESP3Parser)
+                # update cluster exception classes
+                self._parser.EXCEPTION_CLASSES = parser.EXCEPTION_CLASSES
+                self._parser.on_connect(self)
+            self.send_command("HELLO", self.protocol)
+            response = self.read_response()
+            if (
+                response.get(b"proto") != self.protocol
+                and response.get("proto") != self.protocol
+            ):
+                raise ConnectionError("Invalid RESP version")
+
         # if a client_name is given, set it
         if self.client_name:
             self.send_command("CLIENT", "SETNAME", self.client_name)
@@ -872,14 +454,23 @@ def can_read(self, timeout=0):
             raise ConnectionError(f"Error while reading from {host_error}: {e.args}")
 
     def read_response(
-        self, disable_decoding=False, *, disconnect_on_error: bool = True
+        self,
+        disable_decoding=False,
+        *,
+        disconnect_on_error=True,
+        push_request=False,
     ):
         """Read the response from a previously sent command"""
 
         host_error = self._host_error()
 
         try:
-            response = self._parser.read_response(disable_decoding=disable_decoding)
+            if self.protocol in ["3", 3] and not HIREDIS_AVAILABLE:
+                response = self._parser.read_response(
+                    disable_decoding=disable_decoding, push_request=push_request
+                )
+            else:
+                response = self._parser.read_response(disable_decoding=disable_decoding)
         except socket.timeout:
             if disconnect_on_error:
                 self.disconnect()
@@ -1073,7 +664,7 @@ def __init__(
         Raises:
             RedisError
         """  # noqa
-        if not ssl_available:
+        if not SSL_AVAILABLE:
             raise RedisError("Python wasn't built with SSL support")
 
         self.keyfile = ssl_keyfile
@@ -1174,8 +765,9 @@ def _connect(self):
 class UnixDomainSocketConnection(AbstractConnection):
     "Manages UDS communication to and from a Redis server"
 
-    def __init__(self, path="", **kwargs):
+    def __init__(self, path="", socket_timeout=None, **kwargs):
         self.path = path
+        self.socket_timeout = socket_timeout
         super().__init__(**kwargs)
 
     def repr_pieces(self):
diff --git a/redis/ocsp.py b/redis/ocsp.py
index ab8a35a33d..b0420b4711 100644
--- a/redis/ocsp.py
+++ b/redis/ocsp.py
@@ -15,7 +15,6 @@
 from cryptography.hazmat.primitives.hashes import SHA1, Hash
 from cryptography.hazmat.primitives.serialization import Encoding, PublicFormat
 from cryptography.x509 import ocsp
-
 from redis.exceptions import AuthorizationError, ConnectionError
 
 
diff --git a/redis/typing.py b/redis/typing.py
index 47a255652a..56a1e99ba7 100644
--- a/redis/typing.py
+++ b/redis/typing.py
@@ -1,14 +1,23 @@
 # from __future__ import annotations
 
 from datetime import datetime, timedelta
-from typing import TYPE_CHECKING, Any, Awaitable, Iterable, TypeVar, Union
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Awaitable,
+    Iterable,
+    Mapping,
+    Type,
+    TypeVar,
+    Union,
+)
 
 from redis.compat import Protocol
 
 if TYPE_CHECKING:
+    from redis._parsers import Encoder
     from redis.asyncio.connection import ConnectionPool as AsyncConnectionPool
-    from redis.asyncio.connection import Encoder as AsyncEncoder
-    from redis.connection import ConnectionPool, Encoder
+    from redis.connection import ConnectionPool
 
 
 Number = Union[int, float]
@@ -39,6 +48,8 @@
 AnyFieldT = TypeVar("AnyFieldT", bytes, str, memoryview)
 AnyChannelT = TypeVar("AnyChannelT", bytes, str, memoryview)
 
+ExceptionMappingT = Mapping[str, Union[Type[Exception], Mapping[str, Type[Exception]]]]
+
 
 class CommandsProtocol(Protocol):
     connection_pool: Union["AsyncConnectionPool", "ConnectionPool"]
@@ -48,7 +59,7 @@ def execute_command(self, *args, **options):
 
 
 class ClusterCommandsProtocol(CommandsProtocol, Protocol):
-    encoder: Union["AsyncEncoder", "Encoder"]
+    encoder: "Encoder"
 
     def execute_command(self, *args, **options) -> Union[Any, Awaitable]:
         ...
diff --git a/redis/utils.py b/redis/utils.py
index d95e62c042..148d15246b 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -1,3 +1,4 @@
+import logging
 from contextlib import contextmanager
 from functools import wraps
 from typing import Any, Dict, Mapping, Union
@@ -12,6 +13,13 @@
     HIREDIS_AVAILABLE = False
     HIREDIS_PACK_AVAILABLE = False
 
+try:
+    import ssl  # noqa
+
+    SSL_AVAILABLE = True
+except ImportError:
+    SSL_AVAILABLE = False
+
 try:
     import cryptography  # noqa
 
@@ -110,3 +118,16 @@ def wrapper(*args, **kwargs):
         return wrapper
 
     return decorator
+
+
+def _set_info_logger():
+    """
+    Set up a logger that log info logs to stdout.
+    (This is used by the default push response handler)
+    """
+    if "push_response" not in logging.root.manager.loggerDict.keys():
+        logger = logging.getLogger("push_response")
+        logger.setLevel(logging.INFO)
+        handler = logging.StreamHandler()
+        handler.setLevel(logging.INFO)
+        logger.addHandler(handler)
diff --git a/setup.py b/setup.py
index 65122b647b..3a752d44d3 100644
--- a/setup.py
+++ b/setup.py
@@ -8,10 +8,11 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="4.6.0",
+    version="5.0.0rc2",
     packages=find_packages(
         include=[
             "redis",
+            "redis._parsers",
             "redis.asyncio",
             "redis.commands",
             "redis.commands.bf",
@@ -19,6 +20,7 @@
             "redis.commands.search",
             "redis.commands.timeseries",
             "redis.commands.graph",
+            "redis.parsers",
         ]
     ),
     url="https://github.com/redis/redis-py",
diff --git a/tasks.py b/tasks.py
index 64b3aef80f..5162566183 100644
--- a/tasks.py
+++ b/tasks.py
@@ -1,69 +1,81 @@
+# https://github.com/pyinvoke/invoke/issues/833
+import inspect
 import os
 import shutil
 
 from invoke import run, task
 
-with open("tox.ini") as fp:
-    lines = fp.read().split("\n")
-    dockers = [line.split("=")[1].strip() for line in lines if line.find("name") != -1]
+if not hasattr(inspect, "getargspec"):
+    inspect.getargspec = inspect.getfullargspec
 
 
 @task
 def devenv(c):
-    """Builds a development environment: downloads, and starts all dockers
-    specified in the tox.ini file.
-    """
+    """Brings up the test environment, by wrapping docker compose."""
     clean(c)
-    cmd = "tox -e devenv"
-    for d in dockers:
-        cmd += f" --docker-dont-stop={d}"
+    cmd = "docker-compose --profile all up -d"
     run(cmd)
 
 
 @task
 def build_docs(c):
     """Generates the sphinx documentation."""
-    run("tox -e docs")
+    run("pip install -r docs/requirements.txt")
+    run("make html")
 
 
 @task
 def linters(c):
     """Run code linters"""
-    run("tox -e linters")
+    run("flake8 tests redis")
+    run("black --target-version py37 --check --diff tests redis")
+    run("isort --check-only --diff tests redis")
+    run("vulture redis whitelist.py --min-confidence 80")
+    run("flynt --fail-on-change --dry-run tests redis")
 
 
 @task
 def all_tests(c):
-    """Run all linters, and tests in redis-py. This assumes you have all
-    the python versions specified in the tox.ini file.
-    """
+    """Run all linters, and tests in redis-py."""
     linters(c)
     tests(c)
 
 
 @task
-def tests(c):
+def tests(c, uvloop=False, protocol=2):
     """Run the redis-py test suite against the current python,
     with and without hiredis.
     """
     print("Starting Redis tests")
-    run("tox -e '{standalone,cluster}'-'{plain,hiredis}'")
+    standalone_tests(c, uvloop=uvloop, protocol=protocol)
+    cluster_tests(c, uvloop=uvloop, protocol=protocol)
 
 
 @task
-def standalone_tests(c):
-    """Run all Redis tests against the current python,
-    with and without hiredis."""
-    print("Starting Redis tests")
-    run("tox -e standalone-'{plain,hiredis,ocsp}'")
+def standalone_tests(c, uvloop=False, protocol=2):
+    """Run tests against a standalone redis instance"""
+    if uvloop:
+        run(
+            f"pytest --protocol={protocol} --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' --uvloop --junit-xml=standalone-uvloop-results.xml"
+        )
+    else:
+        run(
+            f"pytest --protocol={protocol} --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' --junit-xml=standalone-results.xml"
+        )
 
 
 @task
-def cluster_tests(c):
-    """Run all Redis Cluster tests against the current python,
-    with and without hiredis."""
-    print("Starting RedisCluster tests")
-    run("tox -e cluster-'{plain,hiredis}'")
+def cluster_tests(c, uvloop=False, protocol=2):
+    """Run tests against a redis cluster"""
+    cluster_url = "redis://localhost:16379/0"
+    if uvloop:
+        run(
+            f"pytest --protocol={protocol} --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --junit-xml=cluster-uvloop-results.xml --uvloop"
+        )
+    else:
+        run(
+            f"pytest --protocol={protocol} --cov=./ --cov-report=xml:coverage_clusteclient.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --junit-xml=cluster-results.xml"
+        )
 
 
 @task
@@ -73,7 +85,7 @@ def clean(c):
         shutil.rmtree("build")
     if os.path.isdir("dist"):
         shutil.rmtree("dist")
-    run(f"docker rm -f {' '.join(dockers)}")
+    run("docker-compose --profile all rm -s -f")
 
 
 @task
diff --git a/tests/conftest.py b/tests/conftest.py
index 4cd4c3c160..b3c410e51b 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -6,18 +6,17 @@
 from urllib.parse import urlparse
 
 import pytest
-from packaging.version import Version
-
 import redis
+from packaging.version import Version
 from redis.backoff import NoBackoff
 from redis.connection import parse_url
 from redis.exceptions import RedisClusterException
 from redis.retry import Retry
 
 REDIS_INFO = {}
-default_redis_url = "redis://localhost:6379/9"
-default_redismod_url = "redis://localhost:36379"
-default_redis_unstable_url = "redis://localhost:6378"
+default_redis_url = "redis://localhost:6379/0"
+default_protocol = "2"
+default_redismod_url = "redis://localhost:6379"
 
 # default ssl client ignores verification for the purpose of testing
 default_redis_ssl_url = "rediss://localhost:6666"
@@ -73,6 +72,7 @@ def format_usage(self):
 
 
 def pytest_addoption(parser):
+
     parser.addoption(
         "--redis-url",
         default=default_redis_url,
@@ -81,14 +81,11 @@ def pytest_addoption(parser):
     )
 
     parser.addoption(
-        "--redismod-url",
-        default=default_redismod_url,
+        "--protocol",
+        default=default_protocol,
         action="store",
-        help="Connection string to redis server"
-        " with loaded modules,"
-        " defaults to `%(default)s`",
+        help="Protocol version, defaults to `%(default)s`",
     )
-
     parser.addoption(
         "--redis-ssl-url",
         default=default_redis_ssl_url,
@@ -105,13 +102,6 @@ def pytest_addoption(parser):
         " defaults to `%(default)s`",
     )
 
-    parser.addoption(
-        "--redis-unstable-url",
-        default=default_redis_unstable_url,
-        action="store",
-        help="Redis unstable (latest version) connection string "
-        "defaults to %(default)s`",
-    )
     parser.addoption(
         "--uvloop", action=BooleanOptionalAction, help="Run tests with uvloop"
     )
@@ -152,10 +142,8 @@ def pytest_sessionstart(session):
     # store REDIS_INFO in config so that it is available from "condition strings"
     session.config.REDIS_INFO = REDIS_INFO
 
-    # module info, if the second redis is running
+    # module info
     try:
-        redismod_url = session.config.getoption("--redismod-url")
-        info = _get_info(redismod_url)
         REDIS_INFO["modules"] = info["modules"]
     except redis.exceptions.ConnectionError:
         pass
@@ -289,6 +277,9 @@ def _get_client(
         redis_url = request.config.getoption("--redis-url")
     else:
         redis_url = from_url
+    if "protocol" not in redis_url:
+        kwargs["protocol"] = request.config.getoption("--protocol")
+
     cluster_mode = REDIS_INFO["cluster_enabled"]
     if not cluster_mode:
         url_options = parse_url(redis_url)
@@ -332,20 +323,15 @@ def cluster_teardown(client, flushdb):
     client.disconnect_connection_pools()
 
 
-# specifically set to the zero database, because creating
-# an index on db != 0 raises a ResponseError in redis
 @pytest.fixture()
-def modclient(request, **kwargs):
-    rmurl = request.config.getoption("--redismod-url")
-    with _get_client(
-        redis.Redis, request, from_url=rmurl, decode_responses=True, **kwargs
-    ) as client:
+def r(request):
+    with _get_client(redis.Redis, request) as client:
         yield client
 
 
 @pytest.fixture()
-def r(request):
-    with _get_client(redis.Redis, request) as client:
+def decoded_r(request):
+    with _get_client(redis.Redis, request, decode_responses=True) as client:
         yield client
 
 
@@ -385,7 +371,7 @@ def mock_cluster_resp_ok(request, **kwargs):
 @pytest.fixture()
 def mock_cluster_resp_int(request, **kwargs):
     r = _get_client(redis.Redis, request, **kwargs)
-    return _gen_cluster_mock_resp(r, "2")
+    return _gen_cluster_mock_resp(r, 2)
 
 
 @pytest.fixture()
@@ -444,15 +430,6 @@ def master_host(request):
     return parts.hostname, (parts.port or 6379)
 
 
-@pytest.fixture()
-def unstable_r(request):
-    url = request.config.getoption("--redis-unstable-url")
-    with _get_client(
-        redis.Redis, request, from_url=url, decode_responses=True
-    ) as client:
-        yield client
-
-
 def wait_for_command(client, monitor, command, key=None):
     # issue a command with a key name that's local to this process.
     # if we find a command with our key before the command we're waiting
@@ -472,3 +449,34 @@ def wait_for_command(client, monitor, command, key=None):
             return monitor_response
         if key in monitor_response["command"]:
             return None
+
+
+def is_resp2_connection(r):
+    if isinstance(r, redis.Redis) or isinstance(r, redis.asyncio.Redis):
+        protocol = r.connection_pool.connection_kwargs.get("protocol")
+    elif isinstance(r, redis.cluster.AbstractRedisCluster):
+        protocol = r.nodes_manager.connection_kwargs.get("protocol")
+    return protocol in ["2", 2, None]
+
+
+def get_protocol_version(r):
+    if isinstance(r, redis.Redis) or isinstance(r, redis.asyncio.Redis):
+        return r.connection_pool.connection_kwargs.get("protocol")
+    elif isinstance(r, redis.cluster.AbstractRedisCluster):
+        return r.nodes_manager.connection_kwargs.get("protocol")
+
+
+def assert_resp_response(r, response, resp2_expected, resp3_expected):
+    protocol = get_protocol_version(r)
+    if protocol in [2, "2", None]:
+        assert response == resp2_expected
+    else:
+        assert response == resp3_expected
+
+
+def assert_resp_response_in(r, response, resp2_expected, resp3_expected):
+    protocol = get_protocol_version(r)
+    if protocol in [2, "2", None]:
+        assert response in resp2_expected
+    else:
+        assert response in resp3_expected
diff --git a/tests/ssl_utils.py b/tests/ssl_utils.py
index 50937638a7..ab9c2e8944 100644
--- a/tests/ssl_utils.py
+++ b/tests/ssl_utils.py
@@ -3,10 +3,10 @@
 
 def get_ssl_filename(name):
     root = os.path.join(os.path.dirname(__file__), "..")
-    cert_dir = os.path.abspath(os.path.join(root, "docker", "stunnel", "keys"))
+    cert_dir = os.path.abspath(os.path.join(root, "dockers", "stunnel", "keys"))
     if not os.path.isdir(cert_dir):  # github actions package validation case
         cert_dir = os.path.abspath(
-            os.path.join(root, "..", "docker", "stunnel", "keys")
+            os.path.join(root, "..", "dockers", "stunnel", "keys")
         )
         if not os.path.isdir(cert_dir):
             raise IOError(f"No SSL certificates found. They should be in {cert_dir}")
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index 121a13b41b..e5da3f8f46 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -4,18 +4,14 @@
 
 import pytest
 import pytest_asyncio
-from packaging.version import Version
-
 import redis.asyncio as redis
+from packaging.version import Version
+from redis._parsers import _AsyncHiredisParser, _AsyncRESP2Parser
 from redis.asyncio.client import Monitor
-from redis.asyncio.connection import (
-    HIREDIS_AVAILABLE,
-    HiredisParser,
-    PythonParser,
-    parse_url,
-)
+from redis.asyncio.connection import parse_url
 from redis.asyncio.retry import Retry
 from redis.backoff import NoBackoff
+from redis.utils import HIREDIS_AVAILABLE
 from tests.conftest import REDIS_INFO
 
 from .compat import mock
@@ -31,14 +27,14 @@ async def _get_info(redis_url):
 @pytest_asyncio.fixture(
     params=[
         pytest.param(
-            (True, PythonParser),
+            (True, _AsyncRESP2Parser),
             marks=pytest.mark.skipif(
                 'config.REDIS_INFO["cluster_enabled"]', reason="cluster mode enabled"
             ),
         ),
-        (False, PythonParser),
+        (False, _AsyncRESP2Parser),
         pytest.param(
-            (True, HiredisParser),
+            (True, _AsyncHiredisParser),
             marks=[
                 pytest.mark.skipif(
                     'config.REDIS_INFO["cluster_enabled"]',
@@ -50,7 +46,7 @@ async def _get_info(redis_url):
             ],
         ),
         pytest.param(
-            (False, HiredisParser),
+            (False, _AsyncHiredisParser),
             marks=pytest.mark.skipif(
                 not HIREDIS_AVAILABLE, reason="hiredis is not installed"
             ),
@@ -73,8 +69,12 @@ async def client_factory(
         url: str = request.config.getoption("--redis-url"),
         cls=redis.Redis,
         flushdb=True,
+        protocol=request.config.getoption("--protocol"),
         **kwargs,
     ):
+        if "protocol" not in url:
+            kwargs["protocol"] = request.config.getoption("--protocol")
+
         cluster_mode = REDIS_INFO["cluster_enabled"]
         if not cluster_mode:
             single = kwargs.pop("single_connection_client", False) or single_connection
@@ -133,10 +133,8 @@ async def r2(create_redis):
 
 
 @pytest_asyncio.fixture()
-async def modclient(request, create_redis):
-    return await create_redis(
-        url=request.config.getoption("--redismod-url"), decode_responses=True
-    )
+async def decoded_r(create_redis):
+    return await create_redis(decode_responses=True)
 
 
 def _gen_cluster_mock_resp(r, response):
@@ -156,7 +154,7 @@ async def mock_cluster_resp_ok(create_redis, **kwargs):
 @pytest_asyncio.fixture()
 async def mock_cluster_resp_int(create_redis, **kwargs):
     r = await create_redis(**kwargs)
-    return _gen_cluster_mock_resp(r, "2")
+    return _gen_cluster_mock_resp(r, 2)
 
 
 @pytest_asyncio.fixture()
diff --git a/tests/test_asyncio/test_bloom.py b/tests/test_asyncio/test_bloom.py
index 9f4a805c4c..0535ddfe02 100644
--- a/tests/test_asyncio/test_bloom.py
+++ b/tests/test_asyncio/test_bloom.py
@@ -1,94 +1,99 @@
 from math import inf
 
 import pytest
-
 import redis.asyncio as redis
 from redis.exceptions import ModuleError, RedisError
 from redis.utils import HIREDIS_AVAILABLE
-from tests.conftest import skip_ifmodversion_lt
+from tests.conftest import (
+    assert_resp_response,
+    is_resp2_connection,
+    skip_ifmodversion_lt,
+)
 
 
 def intlist(obj):
     return [int(v) for v in obj]
 
 
-# @pytest.fixture
-# async def client(modclient):
-#     assert isinstance(modawait modclient.bf(), redis.commands.bf.BFBloom)
-#     assert isinstance(modawait modclient.cf(), redis.commands.bf.CFBloom)
-#     assert isinstance(modawait modclient.cms(), redis.commands.bf.CMSBloom)
-#     assert isinstance(modawait modclient.tdigest(), redis.commands.bf.TDigestBloom)
-#     assert isinstance(modawait modclient.topk(), redis.commands.bf.TOPKBloom)
-
-#     modawait modclient.flushdb()
-#     return modclient
-
-
 @pytest.mark.redismod
-async def test_create(modclient: redis.Redis):
+async def test_create(decoded_r: redis.Redis):
     """Test CREATE/RESERVE calls"""
-    assert await modclient.bf().create("bloom", 0.01, 1000)
-    assert await modclient.bf().create("bloom_e", 0.01, 1000, expansion=1)
-    assert await modclient.bf().create("bloom_ns", 0.01, 1000, noScale=True)
-    assert await modclient.cf().create("cuckoo", 1000)
-    assert await modclient.cf().create("cuckoo_e", 1000, expansion=1)
-    assert await modclient.cf().create("cuckoo_bs", 1000, bucket_size=4)
-    assert await modclient.cf().create("cuckoo_mi", 1000, max_iterations=10)
-    assert await modclient.cms().initbydim("cmsDim", 100, 5)
-    assert await modclient.cms().initbyprob("cmsProb", 0.01, 0.01)
-    assert await modclient.topk().reserve("topk", 5, 100, 5, 0.9)
+    assert await decoded_r.bf().create("bloom", 0.01, 1000)
+    assert await decoded_r.bf().create("bloom_e", 0.01, 1000, expansion=1)
+    assert await decoded_r.bf().create("bloom_ns", 0.01, 1000, noScale=True)
+    assert await decoded_r.cf().create("cuckoo", 1000)
+    assert await decoded_r.cf().create("cuckoo_e", 1000, expansion=1)
+    assert await decoded_r.cf().create("cuckoo_bs", 1000, bucket_size=4)
+    assert await decoded_r.cf().create("cuckoo_mi", 1000, max_iterations=10)
+    assert await decoded_r.cms().initbydim("cmsDim", 100, 5)
+    assert await decoded_r.cms().initbyprob("cmsProb", 0.01, 0.01)
+    assert await decoded_r.topk().reserve("topk", 5, 100, 5, 0.9)
 
 
 @pytest.mark.redismod
 @pytest.mark.experimental
-async def test_tdigest_create(modclient: redis.Redis):
-    assert await modclient.tdigest().create("tDigest", 100)
+async def test_tdigest_create(decoded_r: redis.Redis):
+    assert await decoded_r.tdigest().create("tDigest", 100)
 
 
-# region Test Bloom Filter
 @pytest.mark.redismod
-async def test_bf_add(modclient: redis.Redis):
-    assert await modclient.bf().create("bloom", 0.01, 1000)
-    assert 1 == await modclient.bf().add("bloom", "foo")
-    assert 0 == await modclient.bf().add("bloom", "foo")
-    assert [0] == intlist(await modclient.bf().madd("bloom", "foo"))
-    assert [0, 1] == await modclient.bf().madd("bloom", "foo", "bar")
-    assert [0, 0, 1] == await modclient.bf().madd("bloom", "foo", "bar", "baz")
-    assert 1 == await modclient.bf().exists("bloom", "foo")
-    assert 0 == await modclient.bf().exists("bloom", "noexist")
-    assert [1, 0] == intlist(await modclient.bf().mexists("bloom", "foo", "noexist"))
+async def test_bf_add(decoded_r: redis.Redis):
+    assert await decoded_r.bf().create("bloom", 0.01, 1000)
+    assert 1 == await decoded_r.bf().add("bloom", "foo")
+    assert 0 == await decoded_r.bf().add("bloom", "foo")
+    assert [0] == intlist(await decoded_r.bf().madd("bloom", "foo"))
+    assert [0, 1] == await decoded_r.bf().madd("bloom", "foo", "bar")
+    assert [0, 0, 1] == await decoded_r.bf().madd("bloom", "foo", "bar", "baz")
+    assert 1 == await decoded_r.bf().exists("bloom", "foo")
+    assert 0 == await decoded_r.bf().exists("bloom", "noexist")
+    assert [1, 0] == intlist(await decoded_r.bf().mexists("bloom", "foo", "noexist"))
 
 
 @pytest.mark.redismod
-async def test_bf_insert(modclient: redis.Redis):
-    assert await modclient.bf().create("bloom", 0.01, 1000)
-    assert [1] == intlist(await modclient.bf().insert("bloom", ["foo"]))
-    assert [0, 1] == intlist(await modclient.bf().insert("bloom", ["foo", "bar"]))
-    assert [1] == intlist(await modclient.bf().insert("captest", ["foo"], capacity=10))
-    assert [1] == intlist(await modclient.bf().insert("errtest", ["foo"], error=0.01))
-    assert 1 == await modclient.bf().exists("bloom", "foo")
-    assert 0 == await modclient.bf().exists("bloom", "noexist")
-    assert [1, 0] == intlist(await modclient.bf().mexists("bloom", "foo", "noexist"))
-    info = await modclient.bf().info("bloom")
-    assert 2 == info.insertedNum
-    assert 1000 == info.capacity
-    assert 1 == info.filterNum
+async def test_bf_insert(decoded_r: redis.Redis):
+    assert await decoded_r.bf().create("bloom", 0.01, 1000)
+    assert [1] == intlist(await decoded_r.bf().insert("bloom", ["foo"]))
+    assert [0, 1] == intlist(await decoded_r.bf().insert("bloom", ["foo", "bar"]))
+    assert [1] == intlist(await decoded_r.bf().insert("captest", ["foo"], capacity=10))
+    assert [1] == intlist(await decoded_r.bf().insert("errtest", ["foo"], error=0.01))
+    assert 1 == await decoded_r.bf().exists("bloom", "foo")
+    assert 0 == await decoded_r.bf().exists("bloom", "noexist")
+    assert [1, 0] == intlist(await decoded_r.bf().mexists("bloom", "foo", "noexist"))
+    info = await decoded_r.bf().info("bloom")
+    assert_resp_response(
+        decoded_r,
+        2,
+        info.get("insertedNum"),
+        info.get("Number of items inserted"),
+    )
+    assert_resp_response(
+        decoded_r,
+        1000,
+        info.get("capacity"),
+        info.get("Capacity"),
+    )
+    assert_resp_response(
+        decoded_r,
+        1,
+        info.get("filterNum"),
+        info.get("Number of filters"),
+    )
 
 
 @pytest.mark.redismod
-async def test_bf_scandump_and_loadchunk(modclient: redis.Redis):
+async def test_bf_scandump_and_loadchunk(decoded_r: redis.Redis):
     # Store a filter
-    await modclient.bf().create("myBloom", "0.0001", "1000")
+    await decoded_r.bf().create("myBloom", "0.0001", "1000")
 
     # test is probabilistic and might fail. It is OK to change variables if
     # certain to not break anything
     async def do_verify():
         res = 0
         for x in range(1000):
-            await modclient.bf().add("myBloom", x)
-            rv = await modclient.bf().exists("myBloom", x)
+            await decoded_r.bf().add("myBloom", x)
+            rv = await decoded_r.bf().exists("myBloom", x)
             assert rv
-            rv = await modclient.bf().exists("myBloom", f"nonexist_{x}")
+            rv = await decoded_r.bf().exists("myBloom", f"nonexist_{x}")
             res += rv == x
         assert res < 5
 
@@ -96,52 +101,62 @@ async def do_verify():
     cmds = []
     if HIREDIS_AVAILABLE:
         with pytest.raises(ModuleError):
-            cur = await modclient.bf().scandump("myBloom", 0)
+            cur = await decoded_r.bf().scandump("myBloom", 0)
         return
 
-    cur = await modclient.bf().scandump("myBloom", 0)
+    cur = await decoded_r.bf().scandump("myBloom", 0)
     first = cur[0]
     cmds.append(cur)
 
     while True:
-        cur = await modclient.bf().scandump("myBloom", first)
+        cur = await decoded_r.bf().scandump("myBloom", first)
         first = cur[0]
         if first == 0:
             break
         else:
             cmds.append(cur)
-    prev_info = await modclient.bf().execute_command("bf.debug", "myBloom")
+    prev_info = await decoded_r.bf().execute_command("bf.debug", "myBloom")
 
     # Remove the filter
-    await modclient.bf().client.delete("myBloom")
+    await decoded_r.bf().client.delete("myBloom")
 
     # Now, load all the commands:
     for cmd in cmds:
-        await modclient.bf().loadchunk("myBloom", *cmd)
+        await decoded_r.bf().loadchunk("myBloom", *cmd)
 
-    cur_info = await modclient.bf().execute_command("bf.debug", "myBloom")
+    cur_info = await decoded_r.bf().execute_command("bf.debug", "myBloom")
     assert prev_info == cur_info
     await do_verify()
 
-    await modclient.bf().client.delete("myBloom")
-    await modclient.bf().create("myBloom", "0.0001", "10000000")
+    await decoded_r.bf().client.delete("myBloom")
+    await decoded_r.bf().create("myBloom", "0.0001", "10000000")
 
 
 @pytest.mark.redismod
-async def test_bf_info(modclient: redis.Redis):
+async def test_bf_info(decoded_r: redis.Redis):
     expansion = 4
     # Store a filter
-    await modclient.bf().create("nonscaling", "0.0001", "1000", noScale=True)
-    info = await modclient.bf().info("nonscaling")
-    assert info.expansionRate is None
+    await decoded_r.bf().create("nonscaling", "0.0001", "1000", noScale=True)
+    info = await decoded_r.bf().info("nonscaling")
+    assert_resp_response(
+        decoded_r,
+        None,
+        info.get("expansionRate"),
+        info.get("Expansion rate"),
+    )
 
-    await modclient.bf().create("expanding", "0.0001", "1000", expansion=expansion)
-    info = await modclient.bf().info("expanding")
-    assert info.expansionRate == 4
+    await decoded_r.bf().create("expanding", "0.0001", "1000", expansion=expansion)
+    info = await decoded_r.bf().info("expanding")
+    assert_resp_response(
+        decoded_r,
+        4,
+        info.get("expansionRate"),
+        info.get("Expansion rate"),
+    )
 
     try:
         # noScale mean no expansion
-        await modclient.bf().create(
+        await decoded_r.bf().create(
             "myBloom", "0.0001", "1000", expansion=expansion, noScale=True
         )
         assert False
@@ -150,95 +165,96 @@ async def test_bf_info(modclient: redis.Redis):
 
 
 @pytest.mark.redismod
-async def test_bf_card(modclient: redis.Redis):
+async def test_bf_card(decoded_r: redis.Redis):
     # return 0 if the key does not exist
-    assert await modclient.bf().card("not_exist") == 0
+    assert await decoded_r.bf().card("not_exist") == 0
 
     # Store a filter
-    assert await modclient.bf().add("bf1", "item_foo") == 1
-    assert await modclient.bf().card("bf1") == 1
+    assert await decoded_r.bf().add("bf1", "item_foo") == 1
+    assert await decoded_r.bf().card("bf1") == 1
 
-    # Error when key is of a type other than Bloom filter.
+    # Error when key is of a type other than Bloom filtedecoded_r.
     with pytest.raises(redis.ResponseError):
-        await modclient.set("setKey", "value")
-        await modclient.bf().card("setKey")
+        await decoded_r.set("setKey", "value")
+        await decoded_r.bf().card("setKey")
 
 
-# region Test Cuckoo Filter
 @pytest.mark.redismod
-async def test_cf_add_and_insert(modclient: redis.Redis):
-    assert await modclient.cf().create("cuckoo", 1000)
-    assert await modclient.cf().add("cuckoo", "filter")
-    assert not await modclient.cf().addnx("cuckoo", "filter")
-    assert 1 == await modclient.cf().addnx("cuckoo", "newItem")
-    assert [1] == await modclient.cf().insert("captest", ["foo"])
-    assert [1] == await modclient.cf().insert("captest", ["foo"], capacity=1000)
-    assert [1] == await modclient.cf().insertnx("captest", ["bar"])
-    assert [1] == await modclient.cf().insertnx("captest", ["food"], nocreate="1")
-    assert [0, 0, 1] == await modclient.cf().insertnx("captest", ["foo", "bar", "baz"])
-    assert [0] == await modclient.cf().insertnx("captest", ["bar"], capacity=1000)
-    assert [1] == await modclient.cf().insert("empty1", ["foo"], capacity=1000)
-    assert [1] == await modclient.cf().insertnx("empty2", ["bar"], capacity=1000)
-    info = await modclient.cf().info("captest")
-    assert 5 == info.insertedNum
-    assert 0 == info.deletedNum
-    assert 1 == info.filterNum
+async def test_cf_add_and_insert(decoded_r: redis.Redis):
+    assert await decoded_r.cf().create("cuckoo", 1000)
+    assert await decoded_r.cf().add("cuckoo", "filter")
+    assert not await decoded_r.cf().addnx("cuckoo", "filter")
+    assert 1 == await decoded_r.cf().addnx("cuckoo", "newItem")
+    assert [1] == await decoded_r.cf().insert("captest", ["foo"])
+    assert [1] == await decoded_r.cf().insert("captest", ["foo"], capacity=1000)
+    assert [1] == await decoded_r.cf().insertnx("captest", ["bar"])
+    assert [1] == await decoded_r.cf().insertnx("captest", ["food"], nocreate="1")
+    assert [0, 0, 1] == await decoded_r.cf().insertnx("captest", ["foo", "bar", "baz"])
+    assert [0] == await decoded_r.cf().insertnx("captest", ["bar"], capacity=1000)
+    assert [1] == await decoded_r.cf().insert("empty1", ["foo"], capacity=1000)
+    assert [1] == await decoded_r.cf().insertnx("empty2", ["bar"], capacity=1000)
+    info = await decoded_r.cf().info("captest")
+    assert_resp_response(
+        decoded_r, 5, info.get("insertedNum"), info.get("Number of items inserted")
+    )
+    assert_resp_response(
+        decoded_r, 0, info.get("deletedNum"), info.get("Number of items deleted")
+    )
+    assert_resp_response(
+        decoded_r, 1, info.get("filterNum"), info.get("Number of filters")
+    )
 
 
 @pytest.mark.redismod
-async def test_cf_exists_and_del(modclient: redis.Redis):
-    assert await modclient.cf().create("cuckoo", 1000)
-    assert await modclient.cf().add("cuckoo", "filter")
-    assert await modclient.cf().exists("cuckoo", "filter")
-    assert not await modclient.cf().exists("cuckoo", "notexist")
-    assert 1 == await modclient.cf().count("cuckoo", "filter")
-    assert 0 == await modclient.cf().count("cuckoo", "notexist")
-    assert await modclient.cf().delete("cuckoo", "filter")
-    assert 0 == await modclient.cf().count("cuckoo", "filter")
-
-
-# region Test Count-Min Sketch
+async def test_cf_exists_and_del(decoded_r: redis.Redis):
+    assert await decoded_r.cf().create("cuckoo", 1000)
+    assert await decoded_r.cf().add("cuckoo", "filter")
+    assert await decoded_r.cf().exists("cuckoo", "filter")
+    assert not await decoded_r.cf().exists("cuckoo", "notexist")
+    assert 1 == await decoded_r.cf().count("cuckoo", "filter")
+    assert 0 == await decoded_r.cf().count("cuckoo", "notexist")
+    assert await decoded_r.cf().delete("cuckoo", "filter")
+    assert 0 == await decoded_r.cf().count("cuckoo", "filter")
+
+
 @pytest.mark.redismod
-async def test_cms(modclient: redis.Redis):
-    assert await modclient.cms().initbydim("dim", 1000, 5)
-    assert await modclient.cms().initbyprob("prob", 0.01, 0.01)
-    assert await modclient.cms().incrby("dim", ["foo"], [5])
-    assert [0] == await modclient.cms().query("dim", "notexist")
-    assert [5] == await modclient.cms().query("dim", "foo")
-    assert [10, 15] == await modclient.cms().incrby("dim", ["foo", "bar"], [5, 15])
-    assert [10, 15] == await modclient.cms().query("dim", "foo", "bar")
-    info = await modclient.cms().info("dim")
-    assert 1000 == info.width
-    assert 5 == info.depth
-    assert 25 == info.count
+async def test_cms(decoded_r: redis.Redis):
+    assert await decoded_r.cms().initbydim("dim", 1000, 5)
+    assert await decoded_r.cms().initbyprob("prob", 0.01, 0.01)
+    assert await decoded_r.cms().incrby("dim", ["foo"], [5])
+    assert [0] == await decoded_r.cms().query("dim", "notexist")
+    assert [5] == await decoded_r.cms().query("dim", "foo")
+    assert [10, 15] == await decoded_r.cms().incrby("dim", ["foo", "bar"], [5, 15])
+    assert [10, 15] == await decoded_r.cms().query("dim", "foo", "bar")
+    info = await decoded_r.cms().info("dim")
+    assert info["width"]
+    assert 1000 == info["width"]
+    assert 5 == info["depth"]
+    assert 25 == info["count"]
 
 
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
-async def test_cms_merge(modclient: redis.Redis):
-    assert await modclient.cms().initbydim("A", 1000, 5)
-    assert await modclient.cms().initbydim("B", 1000, 5)
-    assert await modclient.cms().initbydim("C", 1000, 5)
-    assert await modclient.cms().incrby("A", ["foo", "bar", "baz"], [5, 3, 9])
-    assert await modclient.cms().incrby("B", ["foo", "bar", "baz"], [2, 3, 1])
-    assert [5, 3, 9] == await modclient.cms().query("A", "foo", "bar", "baz")
-    assert [2, 3, 1] == await modclient.cms().query("B", "foo", "bar", "baz")
-    assert await modclient.cms().merge("C", 2, ["A", "B"])
-    assert [7, 6, 10] == await modclient.cms().query("C", "foo", "bar", "baz")
-    assert await modclient.cms().merge("C", 2, ["A", "B"], ["1", "2"])
-    assert [9, 9, 11] == await modclient.cms().query("C", "foo", "bar", "baz")
-    assert await modclient.cms().merge("C", 2, ["A", "B"], ["2", "3"])
-    assert [16, 15, 21] == await modclient.cms().query("C", "foo", "bar", "baz")
-
-
-# endregion
-
-
-# region Test Top-K
+async def test_cms_merge(decoded_r: redis.Redis):
+    assert await decoded_r.cms().initbydim("A", 1000, 5)
+    assert await decoded_r.cms().initbydim("B", 1000, 5)
+    assert await decoded_r.cms().initbydim("C", 1000, 5)
+    assert await decoded_r.cms().incrby("A", ["foo", "bar", "baz"], [5, 3, 9])
+    assert await decoded_r.cms().incrby("B", ["foo", "bar", "baz"], [2, 3, 1])
+    assert [5, 3, 9] == await decoded_r.cms().query("A", "foo", "bar", "baz")
+    assert [2, 3, 1] == await decoded_r.cms().query("B", "foo", "bar", "baz")
+    assert await decoded_r.cms().merge("C", 2, ["A", "B"])
+    assert [7, 6, 10] == await decoded_r.cms().query("C", "foo", "bar", "baz")
+    assert await decoded_r.cms().merge("C", 2, ["A", "B"], ["1", "2"])
+    assert [9, 9, 11] == await decoded_r.cms().query("C", "foo", "bar", "baz")
+    assert await decoded_r.cms().merge("C", 2, ["A", "B"], ["2", "3"])
+    assert [16, 15, 21] == await decoded_r.cms().query("C", "foo", "bar", "baz")
+
+
 @pytest.mark.redismod
-async def test_topk(modclient: redis.Redis):
+async def test_topk(decoded_r: redis.Redis):
     # test list with empty buckets
-    assert await modclient.topk().reserve("topk", 3, 50, 4, 0.9)
+    assert await decoded_r.topk().reserve("topk", 3, 50, 4, 0.9)
     assert [
         None,
         None,
@@ -257,7 +273,7 @@ async def test_topk(modclient: redis.Redis):
         None,
         "D",
         None,
-    ] == await modclient.topk().add(
+    ] == await decoded_r.topk().add(
         "topk",
         "A",
         "B",
@@ -277,17 +293,17 @@ async def test_topk(modclient: redis.Redis):
         "E",
         1,
     )
-    assert [1, 1, 0, 0, 1, 0, 0] == await modclient.topk().query(
+    assert [1, 1, 0, 0, 1, 0, 0] == await decoded_r.topk().query(
         "topk", "A", "B", "C", "D", "E", "F", "G"
     )
     with pytest.deprecated_call():
-        assert [4, 3, 2, 3, 3, 0, 1] == await modclient.topk().count(
+        assert [4, 3, 2, 3, 3, 0, 1] == await decoded_r.topk().count(
             "topk", "A", "B", "C", "D", "E", "F", "G"
         )
 
     # test full list
-    assert await modclient.topk().reserve("topklist", 3, 50, 3, 0.9)
-    assert await modclient.topk().add(
+    assert await decoded_r.topk().reserve("topklist", 3, 50, 3, 0.9)
+    assert await decoded_r.topk().add(
         "topklist",
         "A",
         "B",
@@ -306,192 +322,196 @@ async def test_topk(modclient: redis.Redis):
         "E",
         "E",
     )
-    assert ["A", "B", "E"] == await modclient.topk().list("topklist")
-    res = await modclient.topk().list("topklist", withcount=True)
+    assert ["A", "B", "E"] == await decoded_r.topk().list("topklist")
+    res = await decoded_r.topk().list("topklist", withcount=True)
     assert ["A", 4, "B", 3, "E", 3] == res
-    info = await modclient.topk().info("topklist")
-    assert 3 == info.k
-    assert 50 == info.width
-    assert 3 == info.depth
-    assert 0.9 == round(float(info.decay), 1)
+    info = await decoded_r.topk().info("topklist")
+    assert 3 == info["k"]
+    assert 50 == info["width"]
+    assert 3 == info["depth"]
+    assert 0.9 == round(float(info["decay"]), 1)
 
 
 @pytest.mark.redismod
-async def test_topk_incrby(modclient: redis.Redis):
-    await modclient.flushdb()
-    assert await modclient.topk().reserve("topk", 3, 10, 3, 1)
-    assert [None, None, None] == await modclient.topk().incrby(
+async def test_topk_incrby(decoded_r: redis.Redis):
+    await decoded_r.flushdb()
+    assert await decoded_r.topk().reserve("topk", 3, 10, 3, 1)
+    assert [None, None, None] == await decoded_r.topk().incrby(
         "topk", ["bar", "baz", "42"], [3, 6, 2]
     )
-    res = await modclient.topk().incrby("topk", ["42", "xyzzy"], [8, 4])
+    res = await decoded_r.topk().incrby("topk", ["42", "xyzzy"], [8, 4])
     assert [None, "bar"] == res
     with pytest.deprecated_call():
-        assert [3, 6, 10, 4, 0] == await modclient.topk().count(
+        assert [3, 6, 10, 4, 0] == await decoded_r.topk().count(
             "topk", "bar", "baz", "42", "xyzzy", 4
         )
 
 
-# region Test T-Digest
 @pytest.mark.redismod
 @pytest.mark.experimental
-async def test_tdigest_reset(modclient: redis.Redis):
-    assert await modclient.tdigest().create("tDigest", 10)
+async def test_tdigest_reset(decoded_r: redis.Redis):
+    assert await decoded_r.tdigest().create("tDigest", 10)
     # reset on empty histogram
-    assert await modclient.tdigest().reset("tDigest")
+    assert await decoded_r.tdigest().reset("tDigest")
     # insert data-points into sketch
-    assert await modclient.tdigest().add("tDigest", list(range(10)))
+    assert await decoded_r.tdigest().add("tDigest", list(range(10)))
 
-    assert await modclient.tdigest().reset("tDigest")
+    assert await decoded_r.tdigest().reset("tDigest")
     # assert we have 0 unmerged nodes
-    assert 0 == (await modclient.tdigest().info("tDigest")).unmerged_nodes
+    info = await decoded_r.tdigest().info("tDigest")
+    assert_resp_response(
+        decoded_r, 0, info.get("unmerged_nodes"), info.get("Unmerged nodes")
+    )
 
 
 @pytest.mark.redismod
 @pytest.mark.experimental
-async def test_tdigest_merge(modclient: redis.Redis):
-    assert await modclient.tdigest().create("to-tDigest", 10)
-    assert await modclient.tdigest().create("from-tDigest", 10)
+async def test_tdigest_merge(decoded_r: redis.Redis):
+    assert await decoded_r.tdigest().create("to-tDigest", 10)
+    assert await decoded_r.tdigest().create("from-tDigest", 10)
     # insert data-points into sketch
-    assert await modclient.tdigest().add("from-tDigest", [1.0] * 10)
-    assert await modclient.tdigest().add("to-tDigest", [2.0] * 10)
+    assert await decoded_r.tdigest().add("from-tDigest", [1.0] * 10)
+    assert await decoded_r.tdigest().add("to-tDigest", [2.0] * 10)
     # merge from-tdigest into to-tdigest
-    assert await modclient.tdigest().merge("to-tDigest", 1, "from-tDigest")
+    assert await decoded_r.tdigest().merge("to-tDigest", 1, "from-tDigest")
     # we should now have 110 weight on to-histogram
-    info = await modclient.tdigest().info("to-tDigest")
-    total_weight_to = float(info.merged_weight) + float(info.unmerged_weight)
-    assert 20.0 == total_weight_to
+    info = await decoded_r.tdigest().info("to-tDigest")
+    if is_resp2_connection(decoded_r):
+        assert 20 == float(info["merged_weight"]) + float(info["unmerged_weight"])
+    else:
+        assert 20 == float(info["Merged weight"]) + float(info["Unmerged weight"])
     # test override
-    assert await modclient.tdigest().create("from-override", 10)
-    assert await modclient.tdigest().create("from-override-2", 10)
-    assert await modclient.tdigest().add("from-override", [3.0] * 10)
-    assert await modclient.tdigest().add("from-override-2", [4.0] * 10)
-    assert await modclient.tdigest().merge(
+    assert await decoded_r.tdigest().create("from-override", 10)
+    assert await decoded_r.tdigest().create("from-override-2", 10)
+    assert await decoded_r.tdigest().add("from-override", [3.0] * 10)
+    assert await decoded_r.tdigest().add("from-override-2", [4.0] * 10)
+    assert await decoded_r.tdigest().merge(
         "to-tDigest", 2, "from-override", "from-override-2", override=True
     )
-    assert 3.0 == await modclient.tdigest().min("to-tDigest")
-    assert 4.0 == await modclient.tdigest().max("to-tDigest")
+    assert 3.0 == await decoded_r.tdigest().min("to-tDigest")
+    assert 4.0 == await decoded_r.tdigest().max("to-tDigest")
 
 
 @pytest.mark.redismod
 @pytest.mark.experimental
-async def test_tdigest_min_and_max(modclient: redis.Redis):
-    assert await modclient.tdigest().create("tDigest", 100)
+async def test_tdigest_min_and_max(decoded_r: redis.Redis):
+    assert await decoded_r.tdigest().create("tDigest", 100)
     # insert data-points into sketch
-    assert await modclient.tdigest().add("tDigest", [1, 2, 3])
+    assert await decoded_r.tdigest().add("tDigest", [1, 2, 3])
     # min/max
-    assert 3 == await modclient.tdigest().max("tDigest")
-    assert 1 == await modclient.tdigest().min("tDigest")
+    assert 3 == await decoded_r.tdigest().max("tDigest")
+    assert 1 == await decoded_r.tdigest().min("tDigest")
 
 
 @pytest.mark.redismod
 @pytest.mark.experimental
 @skip_ifmodversion_lt("2.4.0", "bf")
-async def test_tdigest_quantile(modclient: redis.Redis):
-    assert await modclient.tdigest().create("tDigest", 500)
+async def test_tdigest_quantile(decoded_r: redis.Redis):
+    assert await decoded_r.tdigest().create("tDigest", 500)
     # insert data-points into sketch
-    assert await modclient.tdigest().add(
+    assert await decoded_r.tdigest().add(
         "tDigest", list([x * 0.01 for x in range(1, 10000)])
     )
     # assert min min/max have same result as quantile 0 and 1
     assert (
-        await modclient.tdigest().max("tDigest")
-        == (await modclient.tdigest().quantile("tDigest", 1))[0]
+        await decoded_r.tdigest().max("tDigest")
+        == (await decoded_r.tdigest().quantile("tDigest", 1))[0]
     )
     assert (
-        await modclient.tdigest().min("tDigest")
-        == (await modclient.tdigest().quantile("tDigest", 0.0))[0]
+        await decoded_r.tdigest().min("tDigest")
+        == (await decoded_r.tdigest().quantile("tDigest", 0.0))[0]
     )
 
-    assert 1.0 == round((await modclient.tdigest().quantile("tDigest", 0.01))[0], 2)
-    assert 99.0 == round((await modclient.tdigest().quantile("tDigest", 0.99))[0], 2)
+    assert 1.0 == round((await decoded_r.tdigest().quantile("tDigest", 0.01))[0], 2)
+    assert 99.0 == round((await decoded_r.tdigest().quantile("tDigest", 0.99))[0], 2)
 
     # test multiple quantiles
-    assert await modclient.tdigest().create("t-digest", 100)
-    assert await modclient.tdigest().add("t-digest", [1, 2, 3, 4, 5])
-    res = await modclient.tdigest().quantile("t-digest", 0.5, 0.8)
+    assert await decoded_r.tdigest().create("t-digest", 100)
+    assert await decoded_r.tdigest().add("t-digest", [1, 2, 3, 4, 5])
+    res = await decoded_r.tdigest().quantile("t-digest", 0.5, 0.8)
     assert [3.0, 5.0] == res
 
 
 @pytest.mark.redismod
 @pytest.mark.experimental
-async def test_tdigest_cdf(modclient: redis.Redis):
-    assert await modclient.tdigest().create("tDigest", 100)
+async def test_tdigest_cdf(decoded_r: redis.Redis):
+    assert await decoded_r.tdigest().create("tDigest", 100)
     # insert data-points into sketch
-    assert await modclient.tdigest().add("tDigest", list(range(1, 10)))
-    assert 0.1 == round((await modclient.tdigest().cdf("tDigest", 1.0))[0], 1)
-    assert 0.9 == round((await modclient.tdigest().cdf("tDigest", 9.0))[0], 1)
-    res = await modclient.tdigest().cdf("tDigest", 1.0, 9.0)
+    assert await decoded_r.tdigest().add("tDigest", list(range(1, 10)))
+    assert 0.1 == round((await decoded_r.tdigest().cdf("tDigest", 1.0))[0], 1)
+    assert 0.9 == round((await decoded_r.tdigest().cdf("tDigest", 9.0))[0], 1)
+    res = await decoded_r.tdigest().cdf("tDigest", 1.0, 9.0)
     assert [0.1, 0.9] == [round(x, 1) for x in res]
 
 
 @pytest.mark.redismod
 @pytest.mark.experimental
 @skip_ifmodversion_lt("2.4.0", "bf")
-async def test_tdigest_trimmed_mean(modclient: redis.Redis):
-    assert await modclient.tdigest().create("tDigest", 100)
+async def test_tdigest_trimmed_mean(decoded_r: redis.Redis):
+    assert await decoded_r.tdigest().create("tDigest", 100)
     # insert data-points into sketch
-    assert await modclient.tdigest().add("tDigest", list(range(1, 10)))
-    assert 5 == await modclient.tdigest().trimmed_mean("tDigest", 0.1, 0.9)
-    assert 4.5 == await modclient.tdigest().trimmed_mean("tDigest", 0.4, 0.5)
+    assert await decoded_r.tdigest().add("tDigest", list(range(1, 10)))
+    assert 5 == await decoded_r.tdigest().trimmed_mean("tDigest", 0.1, 0.9)
+    assert 4.5 == await decoded_r.tdigest().trimmed_mean("tDigest", 0.4, 0.5)
 
 
 @pytest.mark.redismod
 @pytest.mark.experimental
-async def test_tdigest_rank(modclient: redis.Redis):
-    assert await modclient.tdigest().create("t-digest", 500)
-    assert await modclient.tdigest().add("t-digest", list(range(0, 20)))
-    assert -1 == (await modclient.tdigest().rank("t-digest", -1))[0]
-    assert 0 == (await modclient.tdigest().rank("t-digest", 0))[0]
-    assert 10 == (await modclient.tdigest().rank("t-digest", 10))[0]
-    assert [-1, 20, 9] == await modclient.tdigest().rank("t-digest", -20, 20, 9)
+async def test_tdigest_rank(decoded_r: redis.Redis):
+    assert await decoded_r.tdigest().create("t-digest", 500)
+    assert await decoded_r.tdigest().add("t-digest", list(range(0, 20)))
+    assert -1 == (await decoded_r.tdigest().rank("t-digest", -1))[0]
+    assert 0 == (await decoded_r.tdigest().rank("t-digest", 0))[0]
+    assert 10 == (await decoded_r.tdigest().rank("t-digest", 10))[0]
+    assert [-1, 20, 9] == await decoded_r.tdigest().rank("t-digest", -20, 20, 9)
 
 
 @pytest.mark.redismod
 @pytest.mark.experimental
-async def test_tdigest_revrank(modclient: redis.Redis):
-    assert await modclient.tdigest().create("t-digest", 500)
-    assert await modclient.tdigest().add("t-digest", list(range(0, 20)))
-    assert -1 == (await modclient.tdigest().revrank("t-digest", 20))[0]
-    assert 19 == (await modclient.tdigest().revrank("t-digest", 0))[0]
-    assert [-1, 19, 9] == await modclient.tdigest().revrank("t-digest", 21, 0, 10)
+async def test_tdigest_revrank(decoded_r: redis.Redis):
+    assert await decoded_r.tdigest().create("t-digest", 500)
+    assert await decoded_r.tdigest().add("t-digest", list(range(0, 20)))
+    assert -1 == (await decoded_r.tdigest().revrank("t-digest", 20))[0]
+    assert 19 == (await decoded_r.tdigest().revrank("t-digest", 0))[0]
+    assert [-1, 19, 9] == await decoded_r.tdigest().revrank("t-digest", 21, 0, 10)
 
 
 @pytest.mark.redismod
 @pytest.mark.experimental
-async def test_tdigest_byrank(modclient: redis.Redis):
-    assert await modclient.tdigest().create("t-digest", 500)
-    assert await modclient.tdigest().add("t-digest", list(range(1, 11)))
-    assert 1 == (await modclient.tdigest().byrank("t-digest", 0))[0]
-    assert 10 == (await modclient.tdigest().byrank("t-digest", 9))[0]
-    assert (await modclient.tdigest().byrank("t-digest", 100))[0] == inf
+async def test_tdigest_byrank(decoded_r: redis.Redis):
+    assert await decoded_r.tdigest().create("t-digest", 500)
+    assert await decoded_r.tdigest().add("t-digest", list(range(1, 11)))
+    assert 1 == (await decoded_r.tdigest().byrank("t-digest", 0))[0]
+    assert 10 == (await decoded_r.tdigest().byrank("t-digest", 9))[0]
+    assert (await decoded_r.tdigest().byrank("t-digest", 100))[0] == inf
     with pytest.raises(redis.ResponseError):
-        (await modclient.tdigest().byrank("t-digest", -1))[0]
+        (await decoded_r.tdigest().byrank("t-digest", -1))[0]
 
 
 @pytest.mark.redismod
 @pytest.mark.experimental
-async def test_tdigest_byrevrank(modclient: redis.Redis):
-    assert await modclient.tdigest().create("t-digest", 500)
-    assert await modclient.tdigest().add("t-digest", list(range(1, 11)))
-    assert 10 == (await modclient.tdigest().byrevrank("t-digest", 0))[0]
-    assert 1 == (await modclient.tdigest().byrevrank("t-digest", 9))[0]
-    assert (await modclient.tdigest().byrevrank("t-digest", 100))[0] == -inf
+async def test_tdigest_byrevrank(decoded_r: redis.Redis):
+    assert await decoded_r.tdigest().create("t-digest", 500)
+    assert await decoded_r.tdigest().add("t-digest", list(range(1, 11)))
+    assert 10 == (await decoded_r.tdigest().byrevrank("t-digest", 0))[0]
+    assert 1 == (await decoded_r.tdigest().byrevrank("t-digest", 9))[0]
+    assert (await decoded_r.tdigest().byrevrank("t-digest", 100))[0] == -inf
     with pytest.raises(redis.ResponseError):
-        (await modclient.tdigest().byrevrank("t-digest", -1))[0]
+        (await decoded_r.tdigest().byrevrank("t-digest", -1))[0]
 
 
 # @pytest.mark.redismod
-# async def test_pipeline(modclient: redis.Redis):
-#     pipeline = await modclient.bf().pipeline()
-#     assert not await modclient.bf().execute_command("get pipeline")
+# async def test_pipeline(decoded_r: redis.Redis):
+#     pipeline = await decoded_r.bf().pipeline()
+#     assert not await decoded_r.bf().execute_command("get pipeline")
 #
-#     assert await modclient.bf().create("pipeline", 0.01, 1000)
+#     assert await decoded_r.bf().create("pipeline", 0.01, 1000)
 #     for i in range(100):
 #         pipeline.add("pipeline", i)
 #     for i in range(100):
-#         assert not (await modclient.bf().exists("pipeline", i))
+#         assert not (await decoded_r.bf().exists("pipeline", i))
 #
 #     pipeline.execute()
 #
 #     for i in range(100):
-#         assert await modclient.bf().exists("pipeline", i)
+#         assert await decoded_r.bf().exists("pipeline", i)
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index c41d4a2168..ee498e71f7 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -8,10 +8,9 @@
 import pytest
 import pytest_asyncio
 from _pytest.fixtures import FixtureRequest
-
+from redis._parsers import AsyncCommandsParser
 from redis.asyncio.cluster import ClusterNode, NodesManager, RedisCluster
 from redis.asyncio.connection import Connection, SSLConnection, async_timeout
-from redis.asyncio.parser import CommandsParser
 from redis.asyncio.retry import Retry
 from redis.backoff import ExponentialBackoff, NoBackoff, default_backoff
 from redis.cluster import PIPELINE_BLOCKED_COMMANDS, PRIMARY, REPLICA, get_node_name
@@ -30,6 +29,7 @@
 )
 from redis.utils import str_if_bytes
 from tests.conftest import (
+    assert_resp_response,
     skip_if_redis_enterprise,
     skip_if_server_version_lt,
     skip_unless_arch_bits,
@@ -152,7 +152,7 @@ async def execute_command(*_args, **_kwargs):
         execute_command_mock.side_effect = execute_command
 
         with mock.patch.object(
-            CommandsParser, "initialize", autospec=True
+            AsyncCommandsParser, "initialize", autospec=True
         ) as cmd_parser_initialize:
 
             def cmd_init_mock(self, r: ClusterNode) -> None:
@@ -602,7 +602,7 @@ def map_7007(self):
                     mocks["send_packed_command"].return_value = "MOCK_OK"
                     mocks["connect"].return_value = None
                     with mock.patch.object(
-                        CommandsParser, "initialize", autospec=True
+                        AsyncCommandsParser, "initialize", autospec=True
                     ) as cmd_parser_initialize:
 
                         def cmd_init_mock(self, r: ClusterNode) -> None:
@@ -964,7 +964,7 @@ async def test_client_setname(self, r: RedisCluster) -> None:
         node = r.get_random_node()
         await r.client_setname("redis_py_test", target_nodes=node)
         client_name = await r.client_getname(target_nodes=node)
-        assert client_name == "redis_py_test"
+        assert_resp_response(r, client_name, "redis_py_test", b"redis_py_test")
 
     async def test_exists(self, r: RedisCluster) -> None:
         d = {"a": b"1", "b": b"2", "c": b"3", "d": b"4"}
@@ -1443,7 +1443,7 @@ async def test_client_trackinginfo(self, r: RedisCluster) -> None:
         node = r.get_primaries()[0]
         res = await r.client_trackinginfo(target_nodes=node)
         assert len(res) > 2
-        assert "prefixes" in res
+        assert "prefixes" in res or b"prefixes" in res
 
     @skip_if_server_version_lt("2.9.50")
     async def test_client_pause(self, r: RedisCluster) -> None:
@@ -1609,24 +1609,68 @@ async def test_cluster_renamenx(self, r: RedisCluster) -> None:
     async def test_cluster_blpop(self, r: RedisCluster) -> None:
         await r.rpush("{foo}a", "1", "2")
         await r.rpush("{foo}b", "3", "4")
-        assert await r.blpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"3")
-        assert await r.blpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"4")
-        assert await r.blpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"1")
-        assert await r.blpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"2")
+        assert_resp_response(
+            r,
+            await r.blpop(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}b", b"3"),
+            [b"{foo}b", b"3"],
+        )
+        assert_resp_response(
+            r,
+            await r.blpop(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}b", b"4"),
+            [b"{foo}b", b"4"],
+        )
+        assert_resp_response(
+            r,
+            await r.blpop(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}a", b"1"),
+            [b"{foo}a", b"1"],
+        )
+        assert_resp_response(
+            r,
+            await r.blpop(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}a", b"2"),
+            [b"{foo}a", b"2"],
+        )
         assert await r.blpop(["{foo}b", "{foo}a"], timeout=1) is None
         await r.rpush("{foo}c", "1")
-        assert await r.blpop("{foo}c", timeout=1) == (b"{foo}c", b"1")
+        assert_resp_response(
+            r, await r.blpop("{foo}c", timeout=1), (b"{foo}c", b"1"), [b"{foo}c", b"1"]
+        )
 
     async def test_cluster_brpop(self, r: RedisCluster) -> None:
         await r.rpush("{foo}a", "1", "2")
         await r.rpush("{foo}b", "3", "4")
-        assert await r.brpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"4")
-        assert await r.brpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"3")
-        assert await r.brpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"2")
-        assert await r.brpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"1")
+        assert_resp_response(
+            r,
+            await r.brpop(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}b", b"4"),
+            [b"{foo}b", b"4"],
+        )
+        assert_resp_response(
+            r,
+            await r.brpop(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}b", b"3"),
+            [b"{foo}b", b"3"],
+        )
+        assert_resp_response(
+            r,
+            await r.brpop(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}a", b"2"),
+            [b"{foo}a", b"2"],
+        )
+        assert_resp_response(
+            r,
+            await r.brpop(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}a", b"1"),
+            [b"{foo}a", b"1"],
+        )
         assert await r.brpop(["{foo}b", "{foo}a"], timeout=1) is None
         await r.rpush("{foo}c", "1")
-        assert await r.brpop("{foo}c", timeout=1) == (b"{foo}c", b"1")
+        assert_resp_response(
+            r, await r.brpop("{foo}c", timeout=1), (b"{foo}c", b"1"), [b"{foo}c", b"1"]
+        )
 
     async def test_cluster_brpoplpush(self, r: RedisCluster) -> None:
         await r.rpush("{foo}a", "1", "2")
@@ -1699,7 +1743,8 @@ async def test_cluster_zdiff(self, r: RedisCluster) -> None:
         await r.zadd("{foo}a", {"a1": 1, "a2": 2, "a3": 3})
         await r.zadd("{foo}b", {"a1": 1, "a2": 2})
         assert await r.zdiff(["{foo}a", "{foo}b"]) == [b"a3"]
-        assert await r.zdiff(["{foo}a", "{foo}b"], withscores=True) == [b"a3", b"3"]
+        response = await r.zdiff(["{foo}a", "{foo}b"], withscores=True)
+        assert_resp_response(r, response, [b"a3", b"3"], [[b"a3", 3.0]])
 
     @skip_if_server_version_lt("6.2.0")
     async def test_cluster_zdiffstore(self, r: RedisCluster) -> None:
@@ -1707,7 +1752,8 @@ async def test_cluster_zdiffstore(self, r: RedisCluster) -> None:
         await r.zadd("{foo}b", {"a1": 1, "a2": 2})
         assert await r.zdiffstore("{foo}out", ["{foo}a", "{foo}b"])
         assert await r.zrange("{foo}out", 0, -1) == [b"a3"]
-        assert await r.zrange("{foo}out", 0, -1, withscores=True) == [(b"a3", 3.0)]
+        response = await r.zrange("{foo}out", 0, -1, withscores=True)
+        assert_resp_response(r, response, [(b"a3", 3.0)], [[b"a3", 3.0]])
 
     @skip_if_server_version_lt("6.2.0")
     async def test_cluster_zinter(self, r: RedisCluster) -> None:
@@ -1721,32 +1767,41 @@ async def test_cluster_zinter(self, r: RedisCluster) -> None:
                 ["{foo}a", "{foo}b", "{foo}c"], aggregate="foo", withscores=True
             )
         # aggregate with SUM
-        assert await r.zinter(["{foo}a", "{foo}b", "{foo}c"], withscores=True) == [
-            (b"a3", 8),
-            (b"a1", 9),
-        ]
+        response = await r.zinter(["{foo}a", "{foo}b", "{foo}c"], withscores=True)
+        assert_resp_response(
+            r, response, [(b"a3", 8), (b"a1", 9)], [[b"a3", 8], [b"a1", 9]]
+        )
         # aggregate with MAX
-        assert await r.zinter(
+        response = await r.zinter(
             ["{foo}a", "{foo}b", "{foo}c"], aggregate="MAX", withscores=True
-        ) == [(b"a3", 5), (b"a1", 6)]
+        )
+        assert_resp_response(
+            r, response, [(b"a3", 5), (b"a1", 6)], [[b"a3", 5], [b"a1", 6]]
+        )
         # aggregate with MIN
-        assert await r.zinter(
+        response = await r.zinter(
             ["{foo}a", "{foo}b", "{foo}c"], aggregate="MIN", withscores=True
-        ) == [(b"a1", 1), (b"a3", 1)]
+        )
+        assert_resp_response(
+            r, response, [(b"a1", 1), (b"a3", 1)], [[b"a1", 1], [b"a3", 1]]
+        )
         # with weights
-        assert await r.zinter(
-            {"{foo}a": 1, "{foo}b": 2, "{foo}c": 3}, withscores=True
-        ) == [(b"a3", 20), (b"a1", 23)]
+        res = await r.zinter({"{foo}a": 1, "{foo}b": 2, "{foo}c": 3}, withscores=True)
+        assert_resp_response(
+            r, res, [(b"a3", 20), (b"a1", 23)], [[b"a3", 20], [b"a1", 23]]
+        )
 
     async def test_cluster_zinterstore_sum(self, r: RedisCluster) -> None:
         await r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
         await r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
         await r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
         assert await r.zinterstore("{foo}d", ["{foo}a", "{foo}b", "{foo}c"]) == 2
-        assert await r.zrange("{foo}d", 0, -1, withscores=True) == [
-            (b"a3", 8),
-            (b"a1", 9),
-        ]
+        assert_resp_response(
+            r,
+            await r.zrange("{foo}d", 0, -1, withscores=True),
+            [(b"a3", 8), (b"a1", 9)],
+            [[b"a3", 8.0], [b"a1", 9.0]],
+        )
 
     async def test_cluster_zinterstore_max(self, r: RedisCluster) -> None:
         await r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
@@ -1758,10 +1813,12 @@ async def test_cluster_zinterstore_max(self, r: RedisCluster) -> None:
             )
             == 2
         )
-        assert await r.zrange("{foo}d", 0, -1, withscores=True) == [
-            (b"a3", 5),
-            (b"a1", 6),
-        ]
+        assert_resp_response(
+            r,
+            await r.zrange("{foo}d", 0, -1, withscores=True),
+            [(b"a3", 5), (b"a1", 6)],
+            [[b"a3", 5.0], [b"a1", 6.0]],
+        )
 
     async def test_cluster_zinterstore_min(self, r: RedisCluster) -> None:
         await r.zadd("{foo}a", {"a1": 1, "a2": 2, "a3": 3})
@@ -1773,10 +1830,12 @@ async def test_cluster_zinterstore_min(self, r: RedisCluster) -> None:
             )
             == 2
         )
-        assert await r.zrange("{foo}d", 0, -1, withscores=True) == [
-            (b"a1", 1),
-            (b"a3", 3),
-        ]
+        assert_resp_response(
+            r,
+            await r.zrange("{foo}d", 0, -1, withscores=True),
+            [(b"a1", 1), (b"a3", 3)],
+            [[b"a1", 1.0], [b"a3", 3.0]],
+        )
 
     async def test_cluster_zinterstore_with_weight(self, r: RedisCluster) -> None:
         await r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
@@ -1785,66 +1844,86 @@ async def test_cluster_zinterstore_with_weight(self, r: RedisCluster) -> None:
         assert (
             await r.zinterstore("{foo}d", {"{foo}a": 1, "{foo}b": 2, "{foo}c": 3}) == 2
         )
-        assert await r.zrange("{foo}d", 0, -1, withscores=True) == [
-            (b"a3", 20),
-            (b"a1", 23),
-        ]
+        assert_resp_response(
+            r,
+            await r.zrange("{foo}d", 0, -1, withscores=True),
+            [(b"a3", 20), (b"a1", 23)],
+            [[b"a3", 20.0], [b"a1", 23.0]],
+        )
 
     @skip_if_server_version_lt("4.9.0")
     async def test_cluster_bzpopmax(self, r: RedisCluster) -> None:
         await r.zadd("{foo}a", {"a1": 1, "a2": 2})
         await r.zadd("{foo}b", {"b1": 10, "b2": 20})
-        assert await r.bzpopmax(["{foo}b", "{foo}a"], timeout=1) == (
-            b"{foo}b",
-            b"b2",
-            20,
-        )
-        assert await r.bzpopmax(["{foo}b", "{foo}a"], timeout=1) == (
-            b"{foo}b",
-            b"b1",
-            10,
-        )
-        assert await r.bzpopmax(["{foo}b", "{foo}a"], timeout=1) == (
-            b"{foo}a",
-            b"a2",
-            2,
+        assert_resp_response(
+            r,
+            await r.bzpopmax(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}b", b"b2", 20),
+            [b"{foo}b", b"b2", 20],
         )
-        assert await r.bzpopmax(["{foo}b", "{foo}a"], timeout=1) == (
-            b"{foo}a",
-            b"a1",
-            1,
+        assert_resp_response(
+            r,
+            await r.bzpopmax(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}b", b"b1", 10),
+            [b"{foo}b", b"b1", 10],
+        )
+        assert_resp_response(
+            r,
+            await r.bzpopmax(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}a", b"a2", 2),
+            [b"{foo}a", b"a2", 2],
+        )
+        assert_resp_response(
+            r,
+            await r.bzpopmax(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}a", b"a1", 1),
+            [b"{foo}a", b"a1", 1],
         )
         assert await r.bzpopmax(["{foo}b", "{foo}a"], timeout=1) is None
         await r.zadd("{foo}c", {"c1": 100})
-        assert await r.bzpopmax("{foo}c", timeout=1) == (b"{foo}c", b"c1", 100)
+        assert_resp_response(
+            r,
+            await r.bzpopmax("{foo}c", timeout=1),
+            (b"{foo}c", b"c1", 100),
+            [b"{foo}c", b"c1", 100],
+        )
 
     @skip_if_server_version_lt("4.9.0")
     async def test_cluster_bzpopmin(self, r: RedisCluster) -> None:
         await r.zadd("{foo}a", {"a1": 1, "a2": 2})
         await r.zadd("{foo}b", {"b1": 10, "b2": 20})
-        assert await r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) == (
-            b"{foo}b",
-            b"b1",
-            10,
-        )
-        assert await r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) == (
-            b"{foo}b",
-            b"b2",
-            20,
-        )
-        assert await r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) == (
-            b"{foo}a",
-            b"a1",
-            1,
+        assert_resp_response(
+            r,
+            await r.bzpopmin(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}b", b"b1", 10),
+            [b"b", b"b1", 10],
         )
-        assert await r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) == (
-            b"{foo}a",
-            b"a2",
-            2,
+        assert_resp_response(
+            r,
+            await r.bzpopmin(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}b", b"b2", 20),
+            [b"b", b"b2", 20],
+        )
+        assert_resp_response(
+            r,
+            await r.bzpopmin(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}a", b"a1", 1),
+            [b"a", b"a1", 1],
+        )
+        assert_resp_response(
+            r,
+            await r.bzpopmin(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}a", b"a2", 2),
+            [b"a", b"a2", 2],
         )
         assert await r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) is None
         await r.zadd("{foo}c", {"c1": 100})
-        assert await r.bzpopmin("{foo}c", timeout=1) == (b"{foo}c", b"c1", 100)
+        assert_resp_response(
+            r,
+            await r.bzpopmin("{foo}c", timeout=1),
+            (b"{foo}c", b"c1", 100),
+            [b"{foo}c", b"c1", 100],
+        )
 
     @skip_if_server_version_lt("6.2.0")
     async def test_cluster_zrangestore(self, r: RedisCluster) -> None:
@@ -1853,10 +1932,12 @@ async def test_cluster_zrangestore(self, r: RedisCluster) -> None:
         assert await r.zrange("{foo}b", 0, -1) == [b"a1", b"a2"]
         assert await r.zrangestore("{foo}b", "{foo}a", 1, 2)
         assert await r.zrange("{foo}b", 0, -1) == [b"a2", b"a3"]
-        assert await r.zrange("{foo}b", 0, -1, withscores=True) == [
-            (b"a2", 2),
-            (b"a3", 3),
-        ]
+        assert_resp_response(
+            r,
+            await r.zrange("{foo}b", 0, -1, withscores=True),
+            [(b"a2", 2), (b"a3", 3)],
+            [[b"a2", 2.0], [b"a3", 3.0]],
+        )
         # reversed order
         assert await r.zrangestore("{foo}b", "{foo}a", 1, 2, desc=True)
         assert await r.zrange("{foo}b", 0, -1) == [b"a1", b"a2"]
@@ -1883,36 +1964,49 @@ async def test_cluster_zunion(self, r: RedisCluster) -> None:
             b"a3",
             b"a1",
         ]
-        assert await r.zunion(["{foo}a", "{foo}b", "{foo}c"], withscores=True) == [
-            (b"a2", 3),
-            (b"a4", 4),
-            (b"a3", 8),
-            (b"a1", 9),
-        ]
+        assert_resp_response(
+            r,
+            await r.zunion(["{foo}a", "{foo}b", "{foo}c"], withscores=True),
+            [(b"a2", 3), (b"a4", 4), (b"a3", 8), (b"a1", 9)],
+            [[b"a2", 3.0], [b"a4", 4.0], [b"a3", 8.0], [b"a1", 9.0]],
+        )
         # max
-        assert await r.zunion(
-            ["{foo}a", "{foo}b", "{foo}c"], aggregate="MAX", withscores=True
-        ) == [(b"a2", 2), (b"a4", 4), (b"a3", 5), (b"a1", 6)]
+        assert_resp_response(
+            r,
+            await r.zunion(
+                ["{foo}a", "{foo}b", "{foo}c"], aggregate="MAX", withscores=True
+            ),
+            [(b"a2", 2), (b"a4", 4), (b"a3", 5), (b"a1", 6)],
+            [[b"a2", 2.0], [b"a4", 4.0], [b"a3", 5.0], [b"a1", 6.0]],
+        )
         # min
-        assert await r.zunion(
-            ["{foo}a", "{foo}b", "{foo}c"], aggregate="MIN", withscores=True
-        ) == [(b"a1", 1), (b"a2", 1), (b"a3", 1), (b"a4", 4)]
+        assert_resp_response(
+            r,
+            await r.zunion(
+                ["{foo}a", "{foo}b", "{foo}c"], aggregate="MIN", withscores=True
+            ),
+            [(b"a1", 1), (b"a2", 1), (b"a3", 1), (b"a4", 4)],
+            [[b"a1", 1.0], [b"a2", 1.0], [b"a3", 1.0], [b"a4", 4.0]],
+        )
         # with weight
-        assert await r.zunion(
-            {"{foo}a": 1, "{foo}b": 2, "{foo}c": 3}, withscores=True
-        ) == [(b"a2", 5), (b"a4", 12), (b"a3", 20), (b"a1", 23)]
+        assert_resp_response(
+            r,
+            await r.zunion({"{foo}a": 1, "{foo}b": 2, "{foo}c": 3}, withscores=True),
+            [(b"a2", 5), (b"a4", 12), (b"a3", 20), (b"a1", 23)],
+            [[b"a2", 5.0], [b"a4", 12.0], [b"a3", 20.0], [b"a1", 23.0]],
+        )
 
     async def test_cluster_zunionstore_sum(self, r: RedisCluster) -> None:
         await r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
         await r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
         await r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
         assert await r.zunionstore("{foo}d", ["{foo}a", "{foo}b", "{foo}c"]) == 4
-        assert await r.zrange("{foo}d", 0, -1, withscores=True) == [
-            (b"a2", 3),
-            (b"a4", 4),
-            (b"a3", 8),
-            (b"a1", 9),
-        ]
+        assert_resp_response(
+            r,
+            await r.zrange("{foo}d", 0, -1, withscores=True),
+            [(b"a2", 3), (b"a4", 4), (b"a3", 8), (b"a1", 9)],
+            [[b"a2", 3.0], [b"a4", 4.0], [b"a3", 8.0], [b"a1", 9.0]],
+        )
 
     async def test_cluster_zunionstore_max(self, r: RedisCluster) -> None:
         await r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
@@ -1924,12 +2018,12 @@ async def test_cluster_zunionstore_max(self, r: RedisCluster) -> None:
             )
             == 4
         )
-        assert await r.zrange("{foo}d", 0, -1, withscores=True) == [
-            (b"a2", 2),
-            (b"a4", 4),
-            (b"a3", 5),
-            (b"a1", 6),
-        ]
+        assert_resp_response(
+            r,
+            await r.zrange("{foo}d", 0, -1, withscores=True),
+            [(b"a2", 2), (b"a4", 4), (b"a3", 5), (b"a1", 6)],
+            [[b"a2", 2.0], [b"a4", 4.0], [b"a3", 5.0], [b"a1", 6.0]],
+        )
 
     async def test_cluster_zunionstore_min(self, r: RedisCluster) -> None:
         await r.zadd("{foo}a", {"a1": 1, "a2": 2, "a3": 3})
@@ -1941,12 +2035,12 @@ async def test_cluster_zunionstore_min(self, r: RedisCluster) -> None:
             )
             == 4
         )
-        assert await r.zrange("{foo}d", 0, -1, withscores=True) == [
-            (b"a1", 1),
-            (b"a2", 2),
-            (b"a3", 3),
-            (b"a4", 4),
-        ]
+        assert_resp_response(
+            r,
+            await r.zrange("{foo}d", 0, -1, withscores=True),
+            [(b"a1", 1), (b"a2", 2), (b"a3", 3), (b"a4", 4)],
+            [[b"a1", 1.0], [b"a2", 2.0], [b"a3", 3.0], [b"a4", 4.0]],
+        )
 
     async def test_cluster_zunionstore_with_weight(self, r: RedisCluster) -> None:
         await r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
@@ -1955,12 +2049,12 @@ async def test_cluster_zunionstore_with_weight(self, r: RedisCluster) -> None:
         assert (
             await r.zunionstore("{foo}d", {"{foo}a": 1, "{foo}b": 2, "{foo}c": 3}) == 4
         )
-        assert await r.zrange("{foo}d", 0, -1, withscores=True) == [
-            (b"a2", 5),
-            (b"a4", 12),
-            (b"a3", 20),
-            (b"a1", 23),
-        ]
+        assert_resp_response(
+            r,
+            await r.zrange("{foo}d", 0, -1, withscores=True),
+            [(b"a2", 5), (b"a4", 12), (b"a3", 20), (b"a1", 23)],
+            [[b"a2", 5.0], [b"a4", 12.0], [b"a3", 20.0], [b"a1", 23.0]],
+        )
 
     @skip_if_server_version_lt("2.8.9")
     async def test_cluster_pfcount(self, r: RedisCluster) -> None:
@@ -2444,7 +2538,7 @@ async def mocked_execute_command(self, *args, **kwargs):
             assert "Redis Cluster cannot be connected" in str(e.value)
 
             with mock.patch.object(
-                CommandsParser, "initialize", autospec=True
+                AsyncCommandsParser, "initialize", autospec=True
             ) as cmd_parser_initialize:
 
                 def cmd_init_mock(self, r: ClusterNode) -> None:
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index c0259680c0..08e66b050f 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -10,11 +10,19 @@
 
 import pytest
 import pytest_asyncio
-
 import redis
 from redis import exceptions
-from redis.client import EMPTY_RESPONSE, NEVER_DECODE, parse_info
+from redis._parsers.helpers import (
+    _RedisCallbacks,
+    _RedisCallbacksRESP2,
+    _RedisCallbacksRESP3,
+    parse_info,
+)
+from redis.client import EMPTY_RESPONSE, NEVER_DECODE
 from tests.conftest import (
+    assert_resp_response,
+    assert_resp_response_in,
+    is_resp2_connection,
     skip_if_server_version_gte,
     skip_if_server_version_lt,
     skip_unless_arch_bits,
@@ -78,14 +86,19 @@ class TestResponseCallbacks:
     """Tests for the response callback system"""
 
     async def test_response_callbacks(self, r: redis.Redis):
-        assert r.response_callbacks == redis.Redis.RESPONSE_CALLBACKS
-        assert id(r.response_callbacks) != id(redis.Redis.RESPONSE_CALLBACKS)
+        callbacks = _RedisCallbacks
+        if is_resp2_connection(r):
+            callbacks.update(_RedisCallbacksRESP2)
+        else:
+            callbacks.update(_RedisCallbacksRESP3)
+        assert r.response_callbacks == callbacks
+        assert id(r.response_callbacks) != id(_RedisCallbacks)
         r.set_response_callback("GET", lambda x: "static")
         await r.set("a", "foo")
         assert await r.get("a") == "static"
 
     async def test_case_insensitive_command_names(self, r: redis.Redis):
-        assert r.response_callbacks["del"] == r.response_callbacks["DEL"]
+        assert r.response_callbacks["ping"] == r.response_callbacks["PING"]
 
 
 class TestRedisCommands:
@@ -99,13 +112,13 @@ async def test_command_on_invalid_key_type(self, r: redis.Redis):
     async def test_acl_cat_no_category(self, r: redis.Redis):
         categories = await r.acl_cat()
         assert isinstance(categories, list)
-        assert "read" in categories
+        assert "read" in categories or b"read" in categories
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
     async def test_acl_cat_with_category(self, r: redis.Redis):
         commands = await r.acl_cat("read")
         assert isinstance(commands, list)
-        assert "get" in commands
+        assert "get" in commands or b"get" in commands
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
     async def test_acl_deluser(self, r_teardown):
@@ -119,36 +132,32 @@ async def test_acl_deluser(self, r_teardown):
     @skip_if_server_version_lt(REDIS_6_VERSION)
     async def test_acl_genpass(self, r: redis.Redis):
         password = await r.acl_genpass()
-        assert isinstance(password, str)
+        assert isinstance(password, (str, bytes))
 
-    @skip_if_server_version_lt(REDIS_6_VERSION)
-    @skip_if_server_version_gte("7.0.0")
+    @skip_if_server_version_lt("7.0.0")
     async def test_acl_getuser_setuser(self, r_teardown):
         username = "redis-py-user"
         r = r_teardown(username)
         # test enabled=False
         assert await r.acl_setuser(username, enabled=False, reset=True)
-        assert await r.acl_getuser(username) == {
-            "categories": ["-@all"],
-            "commands": [],
-            "channels": [b"*"],
-            "enabled": False,
-            "flags": ["off", "allchannels", "sanitize-payload"],
-            "keys": [],
-            "passwords": [],
-        }
+        acl = await r.acl_getuser(username)
+        assert acl["categories"] == ["-@all"]
+        assert acl["commands"] == []
+        assert acl["keys"] == []
+        assert acl["passwords"] == []
+        assert "off" in acl["flags"]
+        assert acl["enabled"] is False
 
         # test nopass=True
         assert await r.acl_setuser(username, enabled=True, reset=True, nopass=True)
-        assert await r.acl_getuser(username) == {
-            "categories": ["-@all"],
-            "commands": [],
-            "channels": [b"*"],
-            "enabled": True,
-            "flags": ["on", "allchannels", "nopass", "sanitize-payload"],
-            "keys": [],
-            "passwords": [],
-        }
+        acl = await r.acl_getuser(username)
+        assert acl["categories"] == ["-@all"]
+        assert acl["commands"] == []
+        assert acl["keys"] == []
+        assert acl["passwords"] == []
+        assert "on" in acl["flags"]
+        assert "nopass" in acl["flags"]
+        assert acl["enabled"] is True
 
         # test all args
         assert await r.acl_setuser(
@@ -161,12 +170,11 @@ async def test_acl_getuser_setuser(self, r_teardown):
             keys=["cache:*", "objects:*"],
         )
         acl = await r.acl_getuser(username)
-        assert set(acl["categories"]) == {"-@all", "+@set", "+@hash"}
+        assert set(acl["categories"]) == {"-@all", "+@set", "+@hash", "-@geo"}
         assert set(acl["commands"]) == {"+get", "+mget", "-hset"}
         assert acl["enabled"] is True
-        assert acl["channels"] == [b"*"]
-        assert acl["flags"] == ["on", "allchannels", "sanitize-payload"]
-        assert set(acl["keys"]) == {b"cache:*", b"objects:*"}
+        assert "on" in acl["flags"]
+        assert set(acl["keys"]) == {"~cache:*", "~objects:*"}
         assert len(acl["passwords"]) == 2
 
         # test reset=False keeps existing ACL and applies new ACL on top
@@ -188,12 +196,10 @@ async def test_acl_getuser_setuser(self, r_teardown):
             keys=["objects:*"],
         )
         acl = await r.acl_getuser(username)
-        assert set(acl["categories"]) == {"-@all", "+@set", "+@hash"}
         assert set(acl["commands"]) == {"+get", "+mget"}
         assert acl["enabled"] is True
-        assert acl["channels"] == [b"*"]
-        assert acl["flags"] == ["on", "allchannels", "sanitize-payload"]
-        assert set(acl["keys"]) == {b"cache:*", b"objects:*"}
+        assert "on" in acl["flags"]
+        assert set(acl["keys"]) == {"~cache:*", "~objects:*"}
         assert len(acl["passwords"]) == 2
 
         # test removal of passwords
@@ -229,14 +235,13 @@ async def test_acl_getuser_setuser(self, r_teardown):
         assert len((await r.acl_getuser(username))["passwords"]) == 1
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
-    @skip_if_server_version_gte("7.0.0")
     async def test_acl_list(self, r_teardown):
         username = "redis-py-user"
         r = r_teardown(username)
-
+        start = await r.acl_list()
         assert await r.acl_setuser(username, enabled=False, reset=True)
         users = await r.acl_list()
-        assert f"user {username} off sanitize-payload &* -@all" in users
+        assert len(users) == len(start) + 1
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
     @pytest.mark.onlynoncluster
@@ -271,7 +276,8 @@ async def test_acl_log(self, r_teardown, create_redis):
         assert len(await r.acl_log()) == 2
         assert len(await r.acl_log(count=1)) == 1
         assert isinstance((await r.acl_log())[0], dict)
-        assert "client-info" in (await r.acl_log(count=1))[0]
+        expected = (await r.acl_log(count=1))[0]
+        assert_resp_response_in(r, "client-info", expected, expected.keys())
         assert await r.acl_log_reset()
 
     @skip_if_server_version_lt(REDIS_6_VERSION)
@@ -307,7 +313,7 @@ async def test_acl_users(self, r: redis.Redis):
     @skip_if_server_version_lt(REDIS_6_VERSION)
     async def test_acl_whoami(self, r: redis.Redis):
         username = await r.acl_whoami()
-        assert isinstance(username, str)
+        assert isinstance(username, (str, bytes))
 
     @pytest.mark.onlynoncluster
     async def test_client_list(self, r: redis.Redis):
@@ -345,7 +351,9 @@ async def test_client_getname(self, r: redis.Redis):
     @pytest.mark.onlynoncluster
     async def test_client_setname(self, r: redis.Redis):
         assert await r.client_setname("redis_py_test")
-        assert await r.client_getname() == "redis_py_test"
+        assert_resp_response(
+            r, await r.client_getname(), "redis_py_test", b"redis_py_test"
+        )
 
     @skip_if_server_version_lt("2.6.9")
     @pytest.mark.onlynoncluster
@@ -944,6 +952,19 @@ async def test_pttl_no_key(self, r: redis.Redis):
         """PTTL on servers 2.8 and after return -2 when the key doesn't exist"""
         assert await r.pttl("a") == -2
 
+    @skip_if_server_version_lt("6.2.0")
+    async def test_hrandfield(self, r):
+        assert await r.hrandfield("key") is None
+        await r.hset("key", mapping={"a": 1, "b": 2, "c": 3, "d": 4, "e": 5})
+        assert await r.hrandfield("key") is not None
+        assert len(await r.hrandfield("key", 2)) == 2
+        # with values
+        assert_resp_response(r, len(await r.hrandfield("key", 2, True)), 4, 2)
+        # without duplications
+        assert len(await r.hrandfield("key", 10)) == 5
+        # with duplications
+        assert len(await r.hrandfield("key", -10)) == 10
+
     @pytest.mark.onlynoncluster
     async def test_randomkey(self, r: redis.Redis):
         assert await r.randomkey() is None
@@ -1080,25 +1101,45 @@ async def test_type(self, r: redis.Redis):
     async def test_blpop(self, r: redis.Redis):
         await r.rpush("a", "1", "2")
         await r.rpush("b", "3", "4")
-        assert await r.blpop(["b", "a"], timeout=1) == (b"b", b"3")
-        assert await r.blpop(["b", "a"], timeout=1) == (b"b", b"4")
-        assert await r.blpop(["b", "a"], timeout=1) == (b"a", b"1")
-        assert await r.blpop(["b", "a"], timeout=1) == (b"a", b"2")
+        assert_resp_response(
+            r, await r.blpop(["b", "a"], timeout=1), (b"b", b"3"), [b"b", b"3"]
+        )
+        assert_resp_response(
+            r, await r.blpop(["b", "a"], timeout=1), (b"b", b"4"), [b"b", b"4"]
+        )
+        assert_resp_response(
+            r, await r.blpop(["b", "a"], timeout=1), (b"a", b"1"), [b"a", b"1"]
+        )
+        assert_resp_response(
+            r, await r.blpop(["b", "a"], timeout=1), (b"a", b"2"), [b"a", b"2"]
+        )
         assert await r.blpop(["b", "a"], timeout=1) is None
         await r.rpush("c", "1")
-        assert await r.blpop("c", timeout=1) == (b"c", b"1")
+        assert_resp_response(
+            r, await r.blpop("c", timeout=1), (b"c", b"1"), [b"c", b"1"]
+        )
 
     @pytest.mark.onlynoncluster
     async def test_brpop(self, r: redis.Redis):
         await r.rpush("a", "1", "2")
         await r.rpush("b", "3", "4")
-        assert await r.brpop(["b", "a"], timeout=1) == (b"b", b"4")
-        assert await r.brpop(["b", "a"], timeout=1) == (b"b", b"3")
-        assert await r.brpop(["b", "a"], timeout=1) == (b"a", b"2")
-        assert await r.brpop(["b", "a"], timeout=1) == (b"a", b"1")
+        assert_resp_response(
+            r, await r.brpop(["b", "a"], timeout=1), (b"b", b"4"), [b"b", b"4"]
+        )
+        assert_resp_response(
+            r, await r.brpop(["b", "a"], timeout=1), (b"b", b"3"), [b"b", b"3"]
+        )
+        assert_resp_response(
+            r, await r.brpop(["b", "a"], timeout=1), (b"a", b"2"), [b"a", b"2"]
+        )
+        assert_resp_response(
+            r, await r.brpop(["b", "a"], timeout=1), (b"a", b"1"), [b"a", b"1"]
+        )
         assert await r.brpop(["b", "a"], timeout=1) is None
         await r.rpush("c", "1")
-        assert await r.brpop("c", timeout=1) == (b"c", b"1")
+        assert_resp_response(
+            r, await r.brpop("c", timeout=1), (b"c", b"1"), [b"c", b"1"]
+        )
 
     @pytest.mark.onlynoncluster
     async def test_brpoplpush(self, r: redis.Redis):
@@ -1403,7 +1444,10 @@ async def test_spop_multi_value(self, r: redis.Redis):
         for value in values:
             assert value in s
 
-        assert await r.spop("a", 1) == list(set(s) - set(values))
+        response = await r.spop("a", 1)
+        assert_resp_response(
+            r, response, list(set(s) - set(values)), set(s) - set(values)
+        )
 
     async def test_srandmember(self, r: redis.Redis):
         s = [b"1", b"2", b"3"]
@@ -1441,11 +1485,13 @@ async def test_sunionstore(self, r: redis.Redis):
     async def test_zadd(self, r: redis.Redis):
         mapping = {"a1": 1.0, "a2": 2.0, "a3": 3.0}
         await r.zadd("a", mapping)
-        assert await r.zrange("a", 0, -1, withscores=True) == [
-            (b"a1", 1.0),
-            (b"a2", 2.0),
-            (b"a3", 3.0),
-        ]
+        response = await r.zrange("a", 0, -1, withscores=True)
+        assert_resp_response(
+            r,
+            response,
+            [(b"a1", 1.0), (b"a2", 2.0), (b"a3", 3.0)],
+            [[b"a1", 1.0], [b"a2", 2.0], [b"a3", 3.0]],
+        )
 
         # error cases
         with pytest.raises(exceptions.DataError):
@@ -1462,23 +1508,24 @@ async def test_zadd(self, r: redis.Redis):
     async def test_zadd_nx(self, r: redis.Redis):
         assert await r.zadd("a", {"a1": 1}) == 1
         assert await r.zadd("a", {"a1": 99, "a2": 2}, nx=True) == 1
-        assert await r.zrange("a", 0, -1, withscores=True) == [
-            (b"a1", 1.0),
-            (b"a2", 2.0),
-        ]
+        response = await r.zrange("a", 0, -1, withscores=True)
+        assert_resp_response(
+            r, response, [(b"a1", 1.0), (b"a2", 2.0)], [[b"a1", 1.0], [b"a2", 2.0]]
+        )
 
     async def test_zadd_xx(self, r: redis.Redis):
         assert await r.zadd("a", {"a1": 1}) == 1
         assert await r.zadd("a", {"a1": 99, "a2": 2}, xx=True) == 0
-        assert await r.zrange("a", 0, -1, withscores=True) == [(b"a1", 99.0)]
+        response = await r.zrange("a", 0, -1, withscores=True)
+        assert_resp_response(r, response, [(b"a1", 99.0)], [[b"a1", 99.0]])
 
     async def test_zadd_ch(self, r: redis.Redis):
         assert await r.zadd("a", {"a1": 1}) == 1
         assert await r.zadd("a", {"a1": 99, "a2": 2}, ch=True) == 2
-        assert await r.zrange("a", 0, -1, withscores=True) == [
-            (b"a2", 2.0),
-            (b"a1", 99.0),
-        ]
+        response = await r.zrange("a", 0, -1, withscores=True)
+        assert_resp_response(
+            r, response, [(b"a2", 2.0), (b"a1", 99.0)], [[b"a2", 2.0], [b"a1", 99.0]]
+        )
 
     async def test_zadd_incr(self, r: redis.Redis):
         assert await r.zadd("a", {"a1": 1}) == 1
@@ -1502,6 +1549,25 @@ async def test_zcount(self, r: redis.Redis):
         assert await r.zcount("a", 1, "(" + str(2)) == 1
         assert await r.zcount("a", 10, 20) == 0
 
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("6.2.0")
+    async def test_zdiff(self, r):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        await r.zadd("b", {"a1": 1, "a2": 2})
+        assert await r.zdiff(["a", "b"]) == [b"a3"]
+        response = await r.zdiff(["a", "b"], withscores=True)
+        assert_resp_response(r, response, [b"a3", b"3"], [[b"a3", 3.0]])
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("6.2.0")
+    async def test_zdiffstore(self, r):
+        await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
+        await r.zadd("b", {"a1": 1, "a2": 2})
+        assert await r.zdiffstore("out", ["a", "b"])
+        assert await r.zrange("out", 0, -1) == [b"a3"]
+        response = await r.zrange("out", 0, -1, withscores=True)
+        assert_resp_response(r, response, [(b"a3", 3.0)], [[b"a3", 3.0]])
+
     async def test_zincrby(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
         assert await r.zincrby("a", 1, "a2") == 3.0
@@ -1521,7 +1587,10 @@ async def test_zinterstore_sum(self, r: redis.Redis):
         await r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
         await r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
         assert await r.zinterstore("d", ["a", "b", "c"]) == 2
-        assert await r.zrange("d", 0, -1, withscores=True) == [(b"a3", 8), (b"a1", 9)]
+        response = await r.zrange("d", 0, -1, withscores=True)
+        assert_resp_response(
+            r, response, [(b"a3", 8), (b"a1", 9)], [[b"a3", 8.0], [b"a1", 9.0]]
+        )
 
     @pytest.mark.onlynoncluster
     async def test_zinterstore_max(self, r: redis.Redis):
@@ -1529,7 +1598,10 @@ async def test_zinterstore_max(self, r: redis.Redis):
         await r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
         await r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
         assert await r.zinterstore("d", ["a", "b", "c"], aggregate="MAX") == 2
-        assert await r.zrange("d", 0, -1, withscores=True) == [(b"a3", 5), (b"a1", 6)]
+        response = await r.zrange("d", 0, -1, withscores=True)
+        assert_resp_response(
+            r, response, [(b"a3", 5), (b"a1", 6)], [[b"a3", 5], [b"a1", 6]]
+        )
 
     @pytest.mark.onlynoncluster
     async def test_zinterstore_min(self, r: redis.Redis):
@@ -1537,7 +1609,10 @@ async def test_zinterstore_min(self, r: redis.Redis):
         await r.zadd("b", {"a1": 2, "a2": 3, "a3": 5})
         await r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
         assert await r.zinterstore("d", ["a", "b", "c"], aggregate="MIN") == 2
-        assert await r.zrange("d", 0, -1, withscores=True) == [(b"a1", 1), (b"a3", 3)]
+        response = await r.zrange("d", 0, -1, withscores=True)
+        assert_resp_response(
+            r, response, [(b"a1", 1), (b"a3", 3)], [[b"a1", 1], [b"a3", 3]]
+        )
 
     @pytest.mark.onlynoncluster
     async def test_zinterstore_with_weight(self, r: redis.Redis):
@@ -1545,49 +1620,104 @@ async def test_zinterstore_with_weight(self, r: redis.Redis):
         await r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
         await r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
         assert await r.zinterstore("d", {"a": 1, "b": 2, "c": 3}) == 2
-        assert await r.zrange("d", 0, -1, withscores=True) == [(b"a3", 20), (b"a1", 23)]
+        response = await r.zrange("d", 0, -1, withscores=True)
+        assert_resp_response(
+            r, response, [(b"a3", 20), (b"a1", 23)], [[b"a3", 20], [b"a1", 23]]
+        )
 
     @skip_if_server_version_lt("4.9.0")
     async def test_zpopmax(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
-        assert await r.zpopmax("a") == [(b"a3", 3)]
+        response = await r.zpopmax("a")
+        assert_resp_response(r, response, [(b"a3", 3)], [b"a3", 3.0])
 
         # with count
-        assert await r.zpopmax("a", count=2) == [(b"a2", 2), (b"a1", 1)]
+        response = await r.zpopmax("a", count=2)
+        assert_resp_response(
+            r, response, [(b"a2", 2), (b"a1", 1)], [[b"a2", 2], [b"a1", 1]]
+        )
 
     @skip_if_server_version_lt("4.9.0")
     async def test_zpopmin(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
-        assert await r.zpopmin("a") == [(b"a1", 1)]
+        response = await r.zpopmin("a")
+        assert_resp_response(r, response, [(b"a1", 1)], [b"a1", 1.0])
 
         # with count
-        assert await r.zpopmin("a", count=2) == [(b"a2", 2), (b"a3", 3)]
+        response = await r.zpopmin("a", count=2)
+        assert_resp_response(
+            r, response, [(b"a2", 2), (b"a3", 3)], [[b"a2", 2], [b"a3", 3]]
+        )
 
     @skip_if_server_version_lt("4.9.0")
     @pytest.mark.onlynoncluster
     async def test_bzpopmax(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 2})
         await r.zadd("b", {"b1": 10, "b2": 20})
-        assert await r.bzpopmax(["b", "a"], timeout=1) == (b"b", b"b2", 20)
-        assert await r.bzpopmax(["b", "a"], timeout=1) == (b"b", b"b1", 10)
-        assert await r.bzpopmax(["b", "a"], timeout=1) == (b"a", b"a2", 2)
-        assert await r.bzpopmax(["b", "a"], timeout=1) == (b"a", b"a1", 1)
+        assert_resp_response(
+            r,
+            await r.bzpopmax(["b", "a"], timeout=1),
+            (b"b", b"b2", 20),
+            [b"b", b"b2", 20],
+        )
+        assert_resp_response(
+            r,
+            await r.bzpopmax(["b", "a"], timeout=1),
+            (b"b", b"b1", 10),
+            [b"b", b"b1", 10],
+        )
+        assert_resp_response(
+            r,
+            await r.bzpopmax(["b", "a"], timeout=1),
+            (b"a", b"a2", 2),
+            [b"a", b"a2", 2],
+        )
+        assert_resp_response(
+            r,
+            await r.bzpopmax(["b", "a"], timeout=1),
+            (b"a", b"a1", 1),
+            [b"a", b"a1", 1],
+        )
         assert await r.bzpopmax(["b", "a"], timeout=1) is None
         await r.zadd("c", {"c1": 100})
-        assert await r.bzpopmax("c", timeout=1) == (b"c", b"c1", 100)
+        assert_resp_response(
+            r, await r.bzpopmax("c", timeout=1), (b"c", b"c1", 100), [b"c", b"c1", 100]
+        )
 
     @skip_if_server_version_lt("4.9.0")
     @pytest.mark.onlynoncluster
     async def test_bzpopmin(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 2})
         await r.zadd("b", {"b1": 10, "b2": 20})
-        assert await r.bzpopmin(["b", "a"], timeout=1) == (b"b", b"b1", 10)
-        assert await r.bzpopmin(["b", "a"], timeout=1) == (b"b", b"b2", 20)
-        assert await r.bzpopmin(["b", "a"], timeout=1) == (b"a", b"a1", 1)
-        assert await r.bzpopmin(["b", "a"], timeout=1) == (b"a", b"a2", 2)
+        assert_resp_response(
+            r,
+            await r.bzpopmin(["b", "a"], timeout=1),
+            (b"b", b"b1", 10),
+            [b"b", b"b1", 10],
+        )
+        assert_resp_response(
+            r,
+            await r.bzpopmin(["b", "a"], timeout=1),
+            (b"b", b"b2", 20),
+            [b"b", b"b2", 20],
+        )
+        assert_resp_response(
+            r,
+            await r.bzpopmin(["b", "a"], timeout=1),
+            (b"a", b"a1", 1),
+            [b"a", b"a1", 1],
+        )
+        assert_resp_response(
+            r,
+            await r.bzpopmin(["b", "a"], timeout=1),
+            (b"a", b"a2", 2),
+            [b"a", b"a2", 2],
+        )
         assert await r.bzpopmin(["b", "a"], timeout=1) is None
         await r.zadd("c", {"c1": 100})
-        assert await r.bzpopmin("c", timeout=1) == (b"c", b"c1", 100)
+        assert_resp_response(
+            r, await r.bzpopmin("c", timeout=1), (b"c", b"c1", 100), [b"c", b"c1", 100]
+        )
 
     async def test_zrange(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
@@ -1595,20 +1725,20 @@ async def test_zrange(self, r: redis.Redis):
         assert await r.zrange("a", 1, 2) == [b"a2", b"a3"]
 
         # withscores
-        assert await r.zrange("a", 0, 1, withscores=True) == [
-            (b"a1", 1.0),
-            (b"a2", 2.0),
-        ]
-        assert await r.zrange("a", 1, 2, withscores=True) == [
-            (b"a2", 2.0),
-            (b"a3", 3.0),
-        ]
+        response = await r.zrange("a", 0, 1, withscores=True)
+        assert_resp_response(
+            r, response, [(b"a1", 1.0), (b"a2", 2.0)], [[b"a1", 1.0], [b"a2", 2.0]]
+        )
+        response = await r.zrange("a", 1, 2, withscores=True)
+        assert_resp_response(
+            r, response, [(b"a2", 2.0), (b"a3", 3.0)], [[b"a2", 2.0], [b"a3", 3.0]]
+        )
 
         # custom score function
-        assert await r.zrange("a", 0, 1, withscores=True, score_cast_func=int) == [
-            (b"a1", 1),
-            (b"a2", 2),
-        ]
+        # assert await r.zrange("a", 0, 1, withscores=True, score_cast_func=int) == [
+        #     (b"a1", 1),
+        #     (b"a2", 2),
+        # ]
 
     @skip_if_server_version_lt("2.8.9")
     async def test_zrangebylex(self, r: redis.Redis):
@@ -1642,16 +1772,24 @@ async def test_zrangebyscore(self, r: redis.Redis):
         assert await r.zrangebyscore("a", 2, 4, start=1, num=2) == [b"a3", b"a4"]
 
         # withscores
-        assert await r.zrangebyscore("a", 2, 4, withscores=True) == [
-            (b"a2", 2.0),
-            (b"a3", 3.0),
-            (b"a4", 4.0),
-        ]
+        response = await r.zrangebyscore("a", 2, 4, withscores=True)
+        assert_resp_response(
+            r,
+            response,
+            [(b"a2", 2.0), (b"a3", 3.0), (b"a4", 4.0)],
+            [[b"a2", 2.0], [b"a3", 3.0], [b"a4", 4.0]],
+        )
 
         # custom score function
-        assert await r.zrangebyscore(
+        response = await r.zrangebyscore(
             "a", 2, 4, withscores=True, score_cast_func=int
-        ) == [(b"a2", 2), (b"a3", 3), (b"a4", 4)]
+        )
+        assert_resp_response(
+            r,
+            response,
+            [(b"a2", 2), (b"a3", 3), (b"a4", 4)],
+            [[b"a2", 2], [b"a3", 3], [b"a4", 4]],
+        )
 
     async def test_zrank(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
@@ -1708,20 +1846,20 @@ async def test_zrevrange(self, r: redis.Redis):
         assert await r.zrevrange("a", 1, 2) == [b"a2", b"a1"]
 
         # withscores
-        assert await r.zrevrange("a", 0, 1, withscores=True) == [
-            (b"a3", 3.0),
-            (b"a2", 2.0),
-        ]
-        assert await r.zrevrange("a", 1, 2, withscores=True) == [
-            (b"a2", 2.0),
-            (b"a1", 1.0),
-        ]
+        response = await r.zrevrange("a", 0, 1, withscores=True)
+        assert_resp_response(
+            r, response, [(b"a3", 3.0), (b"a2", 2.0)], [[b"a3", 3.0], [b"a2", 2.0]]
+        )
+        response = await r.zrevrange("a", 1, 2, withscores=True)
+        assert_resp_response(
+            r, response, [(b"a2", 2.0), (b"a1", 1.0)], [[b"a2", 2.0], [b"a1", 1.0]]
+        )
 
         # custom score function
-        assert await r.zrevrange("a", 0, 1, withscores=True, score_cast_func=int) == [
-            (b"a3", 3.0),
-            (b"a2", 2.0),
-        ]
+        response = await r.zrevrange("a", 0, 1, withscores=True, score_cast_func=int)
+        assert_resp_response(
+            r, response, [(b"a3", 3), (b"a2", 2)], [[b"a3", 3], [b"a2", 2]]
+        )
 
     async def test_zrevrangebyscore(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
@@ -1731,16 +1869,24 @@ async def test_zrevrangebyscore(self, r: redis.Redis):
         assert await r.zrevrangebyscore("a", 4, 2, start=1, num=2) == [b"a3", b"a2"]
 
         # withscores
-        assert await r.zrevrangebyscore("a", 4, 2, withscores=True) == [
-            (b"a4", 4.0),
-            (b"a3", 3.0),
-            (b"a2", 2.0),
-        ]
+        response = await r.zrevrangebyscore("a", 4, 2, withscores=True)
+        assert_resp_response(
+            r,
+            response,
+            [(b"a4", 4.0), (b"a3", 3.0), (b"a2", 2.0)],
+            [[b"a4", 4.0], [b"a3", 3.0], [b"a2", 2.0]],
+        )
 
         # custom score function
-        assert await r.zrevrangebyscore(
+        response = await r.zrevrangebyscore(
             "a", 4, 2, withscores=True, score_cast_func=int
-        ) == [(b"a4", 4), (b"a3", 3), (b"a2", 2)]
+        )
+        assert_resp_response(
+            r,
+            response,
+            [(b"a4", 4), (b"a3", 3), (b"a2", 2)],
+            [[b"a4", 4], [b"a3", 3], [b"a2", 2]],
+        )
 
     async def test_zrevrank(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
@@ -1769,12 +1915,13 @@ async def test_zunionstore_sum(self, r: redis.Redis):
         await r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
         await r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
         assert await r.zunionstore("d", ["a", "b", "c"]) == 4
-        assert await r.zrange("d", 0, -1, withscores=True) == [
-            (b"a2", 3),
-            (b"a4", 4),
-            (b"a3", 8),
-            (b"a1", 9),
-        ]
+        response = await r.zrange("d", 0, -1, withscores=True)
+        assert_resp_response(
+            r,
+            response,
+            [(b"a2", 3.0), (b"a4", 4.0), (b"a3", 8.0), (b"a1", 9.0)],
+            [[b"a2", 3.0], [b"a4", 4.0], [b"a3", 8.0], [b"a1", 9.0]],
+        )
 
     @pytest.mark.onlynoncluster
     async def test_zunionstore_max(self, r: redis.Redis):
@@ -1782,12 +1929,13 @@ async def test_zunionstore_max(self, r: redis.Redis):
         await r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
         await r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
         assert await r.zunionstore("d", ["a", "b", "c"], aggregate="MAX") == 4
-        assert await r.zrange("d", 0, -1, withscores=True) == [
-            (b"a2", 2),
-            (b"a4", 4),
-            (b"a3", 5),
-            (b"a1", 6),
-        ]
+        respponse = await r.zrange("d", 0, -1, withscores=True)
+        assert_resp_response(
+            r,
+            respponse,
+            [(b"a2", 2.0), (b"a4", 4.0), (b"a3", 5.0), (b"a1", 6.0)],
+            [[b"a2", 2.0], [b"a4", 4.0], [b"a3", 5.0], [b"a1", 6.0]],
+        )
 
     @pytest.mark.onlynoncluster
     async def test_zunionstore_min(self, r: redis.Redis):
@@ -1795,12 +1943,13 @@ async def test_zunionstore_min(self, r: redis.Redis):
         await r.zadd("b", {"a1": 2, "a2": 2, "a3": 4})
         await r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
         assert await r.zunionstore("d", ["a", "b", "c"], aggregate="MIN") == 4
-        assert await r.zrange("d", 0, -1, withscores=True) == [
-            (b"a1", 1),
-            (b"a2", 2),
-            (b"a3", 3),
-            (b"a4", 4),
-        ]
+        response = await r.zrange("d", 0, -1, withscores=True)
+        assert_resp_response(
+            r,
+            response,
+            [(b"a1", 1.0), (b"a2", 2.0), (b"a3", 3.0), (b"a4", 4.0)],
+            [[b"a1", 1.0], [b"a2", 2.0], [b"a3", 3.0], [b"a4", 4.0]],
+        )
 
     @pytest.mark.onlynoncluster
     async def test_zunionstore_with_weight(self, r: redis.Redis):
@@ -1808,12 +1957,13 @@ async def test_zunionstore_with_weight(self, r: redis.Redis):
         await r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
         await r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
         assert await r.zunionstore("d", {"a": 1, "b": 2, "c": 3}) == 4
-        assert await r.zrange("d", 0, -1, withscores=True) == [
-            (b"a2", 5),
-            (b"a4", 12),
-            (b"a3", 20),
-            (b"a1", 23),
-        ]
+        response = await r.zrange("d", 0, -1, withscores=True)
+        assert_resp_response(
+            r,
+            response,
+            [(b"a2", 5.0), (b"a4", 12.0), (b"a3", 20.0), (b"a1", 23.0)],
+            [[b"a2", 5.0], [b"a4", 12.0], [b"a3", 20.0], [b"a1", 23.0]],
+        )
 
     # HYPERLOGLOG TESTS
     @skip_if_server_version_lt("2.8.9")
@@ -2254,11 +2404,12 @@ async def test_geohash(self, r: redis.Redis):
         )
 
         await r.geoadd("barcelona", values)
-        assert await r.geohash("barcelona", "place1", "place2", "place3") == [
-            "sp3e9yg3kd0",
-            "sp3e9cbc3t0",
-            None,
-        ]
+        assert_resp_response(
+            r,
+            await r.geohash("barcelona", "place1", "place2", "place3"),
+            ["sp3e9yg3kd0", "sp3e9cbc3t0", None],
+            [b"sp3e9yg3kd0", b"sp3e9cbc3t0", None],
+        )
 
     @skip_if_server_version_lt("3.2.0")
     async def test_geopos(self, r: redis.Redis):
@@ -2270,10 +2421,18 @@ async def test_geopos(self, r: redis.Redis):
 
         await r.geoadd("barcelona", values)
         # redis uses 52 bits precision, hereby small errors may be introduced.
-        assert await r.geopos("barcelona", "place1", "place2") == [
-            (2.19093829393386841, 41.43379028184083523),
-            (2.18737632036209106, 41.40634178640635099),
-        ]
+        assert_resp_response(
+            r,
+            await r.geopos("barcelona", "place1", "place2"),
+            [
+                (2.19093829393386841, 41.43379028184083523),
+                (2.18737632036209106, 41.40634178640635099),
+            ],
+            [
+                [2.19093829393386841, 41.43379028184083523],
+                [2.18737632036209106, 41.40634178640635099],
+            ],
+        )
 
     @skip_if_server_version_lt("4.0.0")
     async def test_geopos_no_value(self, r: redis.Redis):
@@ -2682,7 +2841,7 @@ async def test_xgroup_setid(self, r: redis.Redis):
         ]
         assert await r.xinfo_groups(stream) == expected
 
-    @skip_if_server_version_lt("5.0.0")
+    @skip_if_server_version_lt("7.2.0")
     async def test_xinfo_consumers(self, r: redis.Redis):
         stream = "stream"
         group = "group"
@@ -2698,8 +2857,8 @@ async def test_xinfo_consumers(self, r: redis.Redis):
         info = await r.xinfo_consumers(stream, group)
         assert len(info) == 2
         expected = [
-            {"name": consumer1.encode(), "pending": 1},
-            {"name": consumer2.encode(), "pending": 2},
+            {"name": consumer1.encode(), "pending": 1, "inactive": 2},
+            {"name": consumer2.encode(), "pending": 2, "inactive": 2},
         ]
 
         # we can't determine the idle time, so just make sure it's an int
@@ -2808,28 +2967,30 @@ async def test_xread(self, r: redis.Redis):
         m1 = await r.xadd(stream, {"foo": "bar"})
         m2 = await r.xadd(stream, {"bing": "baz"})
 
-        expected = [
-            [
-                stream.encode(),
-                [
-                    await get_stream_message(r, stream, m1),
-                    await get_stream_message(r, stream, m2),
-                ],
-            ]
+        strem_name = stream.encode()
+        expected_entries = [
+            await get_stream_message(r, stream, m1),
+            await get_stream_message(r, stream, m2),
         ]
         # xread starting at 0 returns both messages
-        assert await r.xread(streams={stream: 0}) == expected
+        res = await r.xread(streams={stream: 0})
+        assert_resp_response(
+            r, res, [[strem_name, expected_entries]], {strem_name: [expected_entries]}
+        )
 
-        expected = [[stream.encode(), [await get_stream_message(r, stream, m1)]]]
+        expected_entries = [await get_stream_message(r, stream, m1)]
         # xread starting at 0 and count=1 returns only the first message
-        assert await r.xread(streams={stream: 0}, count=1) == expected
+        res = await r.xread(streams={stream: 0}, count=1)
+        assert_resp_response(
+            r, res, [[strem_name, expected_entries]], {strem_name: [expected_entries]}
+        )
 
-        expected = [[stream.encode(), [await get_stream_message(r, stream, m2)]]]
+        expected_entries = [await get_stream_message(r, stream, m2)]
         # xread starting at m1 returns only the second message
-        assert await r.xread(streams={stream: m1}) == expected
-
-        # xread starting at the last message returns an empty list
-        assert await r.xread(streams={stream: m2}) == []
+        res = await r.xread(streams={stream: m1})
+        assert_resp_response(
+            r, res, [[strem_name, expected_entries]], {strem_name: [expected_entries]}
+        )
 
     @skip_if_server_version_lt("5.0.0")
     async def test_xreadgroup(self, r: redis.Redis):
@@ -2840,26 +3001,27 @@ async def test_xreadgroup(self, r: redis.Redis):
         m2 = await r.xadd(stream, {"bing": "baz"})
         await r.xgroup_create(stream, group, 0)
 
-        expected = [
-            [
-                stream.encode(),
-                [
-                    await get_stream_message(r, stream, m1),
-                    await get_stream_message(r, stream, m2),
-                ],
-            ]
+        strem_name = stream.encode()
+        expected_entries = [
+            await get_stream_message(r, stream, m1),
+            await get_stream_message(r, stream, m2),
         ]
+
         # xread starting at 0 returns both messages
-        assert await r.xreadgroup(group, consumer, streams={stream: ">"}) == expected
+        res = await r.xreadgroup(group, consumer, streams={stream: ">"})
+        assert_resp_response(
+            r, res, [[strem_name, expected_entries]], {strem_name: [expected_entries]}
+        )
 
         await r.xgroup_destroy(stream, group)
         await r.xgroup_create(stream, group, 0)
 
-        expected = [[stream.encode(), [await get_stream_message(r, stream, m1)]]]
+        expected_entries = [await get_stream_message(r, stream, m1)]
+
         # xread with count=1 returns only the first message
-        assert (
-            await r.xreadgroup(group, consumer, streams={stream: ">"}, count=1)
-            == expected
+        res = await r.xreadgroup(group, consumer, streams={stream: ">"}, count=1)
+        assert_resp_response(
+            r, res, [[strem_name, expected_entries]], {strem_name: [expected_entries]}
         )
 
         await r.xgroup_destroy(stream, group)
@@ -2868,35 +3030,34 @@ async def test_xreadgroup(self, r: redis.Redis):
         # will only find messages added after this
         await r.xgroup_create(stream, group, "$")
 
-        expected = []
         # xread starting after the last message returns an empty message list
-        assert await r.xreadgroup(group, consumer, streams={stream: ">"}) == expected
+        res = await r.xreadgroup(group, consumer, streams={stream: ">"})
+        assert_resp_response(r, res, [], {})
 
         # xreadgroup with noack does not have any items in the PEL
         await r.xgroup_destroy(stream, group)
         await r.xgroup_create(stream, group, "0")
-        assert (
-            len(
-                (
-                    await r.xreadgroup(
-                        group, consumer, streams={stream: ">"}, noack=True
-                    )
-                )[0][1]
-            )
-            == 2
-        )
-        # now there should be nothing pending
-        assert (
-            len((await r.xreadgroup(group, consumer, streams={stream: "0"}))[0][1]) == 0
-        )
+        res = await r.xreadgroup(group, consumer, streams={stream: ">"}, noack=True)
+        empty_res = await r.xreadgroup(group, consumer, streams={stream: "0"})
+        if is_resp2_connection(r):
+            assert len(res[0][1]) == 2
+            # now there should be nothing pending
+            assert len(empty_res[0][1]) == 0
+        else:
+            assert len(res[strem_name][0]) == 2
+            # now there should be nothing pending
+            assert len(empty_res[strem_name][0]) == 0
 
         await r.xgroup_destroy(stream, group)
         await r.xgroup_create(stream, group, "0")
         # delete all the messages in the stream
-        expected = [[stream.encode(), [(m1, {}), (m2, {})]]]
+        expected_entries = [(m1, {}), (m2, {})]
         await r.xreadgroup(group, consumer, streams={stream: ">"})
         await r.xtrim(stream, 0)
-        assert await r.xreadgroup(group, consumer, streams={stream: "0"}) == expected
+        res = await r.xreadgroup(group, consumer, streams={stream: "0"})
+        assert_resp_response(
+            r, res, [[strem_name, expected_entries]], {strem_name: [expected_entries]}
+        )
 
     @skip_if_server_version_lt("5.0.0")
     async def test_xrevrange(self, r: redis.Redis):
diff --git a/tests/test_asyncio/test_connect.py b/tests/test_asyncio/test_connect.py
index 8e3209fdc6..bead7208f5 100644
--- a/tests/test_asyncio/test_connect.py
+++ b/tests/test_asyncio/test_connect.py
@@ -5,7 +5,6 @@
 import ssl
 
 import pytest
-
 from redis.asyncio.connection import (
     Connection,
     SSLConnection,
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index 158b8545e2..09960fd7e2 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -4,16 +4,15 @@
 from unittest.mock import patch
 
 import pytest
-
 import redis
-from redis.asyncio import Redis
-from redis.asyncio.connection import (
-    BaseParser,
-    Connection,
-    HiredisParser,
-    PythonParser,
-    UnixDomainSocketConnection,
+from redis._parsers import (
+    _AsyncHiredisParser,
+    _AsyncRESP2Parser,
+    _AsyncRESP3Parser,
+    _AsyncRESPBase,
 )
+from redis.asyncio import Redis
+from redis.asyncio.connection import Connection, UnixDomainSocketConnection
 from redis.asyncio.retry import Retry
 from redis.backoff import NoBackoff
 from redis.exceptions import ConnectionError, InvalidResponse, TimeoutError
@@ -31,11 +30,11 @@ async def test_invalid_response(create_redis):
     raw = b"x"
     fake_stream = MockStream(raw + b"\r\n")
 
-    parser: BaseParser = r.connection._parser
+    parser: _AsyncRESPBase = r.connection._parser
     with mock.patch.object(parser, "_stream", fake_stream):
         with pytest.raises(InvalidResponse) as cm:
             await parser.read_response()
-    if isinstance(parser, PythonParser):
+    if isinstance(parser, _AsyncRESPBase):
         assert str(cm.value) == f"Protocol Error: {raw!r}"
     else:
         assert (
@@ -91,22 +90,22 @@ async def get_conn(_):
 @skip_if_server_version_lt("4.0.0")
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
-async def test_loading_external_modules(modclient):
+async def test_loading_external_modules(r):
     def inner():
         pass
 
-    modclient.load_external_module("myfuncname", inner)
-    assert getattr(modclient, "myfuncname") == inner
-    assert isinstance(getattr(modclient, "myfuncname"), types.FunctionType)
+    r.load_external_module("myfuncname", inner)
+    assert getattr(r, "myfuncname") == inner
+    assert isinstance(getattr(r, "myfuncname"), types.FunctionType)
 
     # and call it
     from redis.commands import RedisModuleCommands
 
     j = RedisModuleCommands.json
-    modclient.load_external_module("sometestfuncname", j)
+    r.load_external_module("sometestfuncname", j)
 
     # d = {'hello': 'world!'}
-    # mod = j(modclient)
+    # mod = j(r)
     # mod.set("fookey", ".", d)
     # assert mod.get('fookey') == d
 
@@ -197,7 +196,9 @@ async def test_connection_parse_response_resume(r: redis.Redis):
 
 @pytest.mark.onlynoncluster
 @pytest.mark.parametrize(
-    "parser_class", [PythonParser, HiredisParser], ids=["PythonParser", "HiredisParser"]
+    "parser_class",
+    [_AsyncRESP2Parser, _AsyncRESP3Parser, _AsyncHiredisParser],
+    ids=["AsyncRESP2Parser", "AsyncRESP3Parser", "AsyncHiredisParser"],
 )
 async def test_connection_disconect_race(parser_class):
     """
@@ -211,7 +212,7 @@ async def test_connection_disconect_race(parser_class):
     This test verifies that a read in progress can finish even
     if the `disconnect()` method is called.
     """
-    if parser_class == HiredisParser and not HIREDIS_AVAILABLE:
+    if parser_class == _AsyncHiredisParser and not HIREDIS_AVAILABLE:
         pytest.skip("Hiredis not available")
 
     args = {}
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
index 24d9902142..7672dc74b4 100644
--- a/tests/test_asyncio/test_connection_pool.py
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -4,7 +4,6 @@
 
 import pytest
 import pytest_asyncio
-
 import redis.asyncio as redis
 from redis.asyncio.connection import Connection, to_bool
 from tests.conftest import skip_if_redis_enterprise, skip_if_server_version_lt
@@ -246,8 +245,9 @@ async def test_connection_pool_blocks_until_timeout(self, master_host):
             start = asyncio.get_running_loop().time()
             with pytest.raises(redis.ConnectionError):
                 await pool.get_connection("_")
-            # we should have waited at least 0.1 seconds
-            assert asyncio.get_running_loop().time() - start >= 0.1
+
+            # we should have waited at least some period of time
+            assert asyncio.get_running_loop().time() - start >= 0.05
             await c1.disconnect()
 
     async def test_connection_pool_blocks_until_conn_available(self, master_host):
@@ -267,7 +267,8 @@ async def target():
 
             start = asyncio.get_running_loop().time()
             await asyncio.gather(target(), pool.get_connection("_"))
-            assert asyncio.get_running_loop().time() - start >= 0.1
+            stop = asyncio.get_running_loop().time()
+            assert (stop - start) <= 0.2
 
     async def test_reuse_previously_released_connection(self, master_host):
         connection_kwargs = {"host": master_host[0]}
@@ -666,6 +667,7 @@ async def r(self, create_redis, server):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.xfail(strict=False)
 class TestHealthCheck:
     interval = 60
 
diff --git a/tests/test_asyncio/test_credentials.py b/tests/test_asyncio/test_credentials.py
index 8e213cdb26..4429f7453b 100644
--- a/tests/test_asyncio/test_credentials.py
+++ b/tests/test_asyncio/test_credentials.py
@@ -5,7 +5,6 @@
 
 import pytest
 import pytest_asyncio
-
 import redis
 from redis import AuthenticationError, DataError, ResponseError
 from redis.credentials import CredentialProvider, UsernamePasswordCredentialProvider
diff --git a/tests/test_asyncio/test_cwe_404.py b/tests/test_asyncio/test_cwe_404.py
index 21f2ddde2a..ff588861e4 100644
--- a/tests/test_asyncio/test_cwe_404.py
+++ b/tests/test_asyncio/test_cwe_404.py
@@ -2,7 +2,6 @@
 import contextlib
 
 import pytest
-
 from redis.asyncio import Redis
 from redis.asyncio.cluster import RedisCluster
 from redis.asyncio.connection import async_timeout
@@ -183,7 +182,7 @@ async def op(pipe):
 async def test_cluster(master_host):
 
     delay = 0.1
-    cluster_port = 6372
+    cluster_port = 16379
     remap_base = 7372
     n_nodes = 6
     hostname, _ = master_host
diff --git a/tests/test_asyncio/test_encoding.py b/tests/test_asyncio/test_encoding.py
index 3efcf69e5b..162ccb367d 100644
--- a/tests/test_asyncio/test_encoding.py
+++ b/tests/test_asyncio/test_encoding.py
@@ -1,6 +1,5 @@
 import pytest
 import pytest_asyncio
-
 import redis.asyncio as redis
 from redis.exceptions import DataError
 
@@ -90,6 +89,7 @@ async def r(self, create_redis):
         yield redis
         await redis.flushall()
 
+    @pytest.mark.xfail
     async def test_basic_command(self, r: redis.Redis):
         await r.set("hello", "world")
 
diff --git a/tests/test_asyncio/test_graph.py b/tests/test_asyncio/test_graph.py
index e7a772fc0f..22195901e6 100644
--- a/tests/test_asyncio/test_graph.py
+++ b/tests/test_asyncio/test_graph.py
@@ -1,5 +1,4 @@
 import pytest
-
 import redis.asyncio as redis
 from redis.commands.graph import Edge, Node, Path
 from redis.commands.graph.execution_plan import Operation
@@ -8,15 +7,15 @@
 
 
 @pytest.mark.redismod
-async def test_bulk(modclient):
+async def test_bulk(decoded_r):
     with pytest.raises(NotImplementedError):
-        await modclient.graph().bulk()
-        await modclient.graph().bulk(foo="bar!")
+        await decoded_r.graph().bulk()
+        await decoded_r.graph().bulk(foo="bar!")
 
 
 @pytest.mark.redismod
-async def test_graph_creation(modclient: redis.Redis):
-    graph = modclient.graph()
+async def test_graph_creation(decoded_r: redis.Redis):
+    graph = decoded_r.graph()
 
     john = Node(
         label="person",
@@ -60,8 +59,8 @@ async def test_graph_creation(modclient: redis.Redis):
 
 
 @pytest.mark.redismod
-async def test_array_functions(modclient: redis.Redis):
-    graph = modclient.graph()
+async def test_array_functions(decoded_r: redis.Redis):
+    graph = decoded_r.graph()
 
     query = """CREATE (p:person{name:'a',age:32, array:[0,1,2]})"""
     await graph.query(query)
@@ -83,12 +82,12 @@ async def test_array_functions(modclient: redis.Redis):
 
 
 @pytest.mark.redismod
-async def test_path(modclient: redis.Redis):
+async def test_path(decoded_r: redis.Redis):
     node0 = Node(node_id=0, label="L1")
     node1 = Node(node_id=1, label="L1")
     edge01 = Edge(node0, "R1", node1, edge_id=0, properties={"value": 1})
 
-    graph = modclient.graph()
+    graph = decoded_r.graph()
     graph.add_node(node0)
     graph.add_node(node1)
     graph.add_edge(edge01)
@@ -103,20 +102,20 @@ async def test_path(modclient: redis.Redis):
 
 
 @pytest.mark.redismod
-async def test_param(modclient: redis.Redis):
+async def test_param(decoded_r: redis.Redis):
     params = [1, 2.3, "str", True, False, None, [0, 1, 2]]
     query = "RETURN $param"
     for param in params:
-        result = await modclient.graph().query(query, {"param": param})
+        result = await decoded_r.graph().query(query, {"param": param})
         expected_results = [[param]]
         assert expected_results == result.result_set
 
 
 @pytest.mark.redismod
-async def test_map(modclient: redis.Redis):
+async def test_map(decoded_r: redis.Redis):
     query = "RETURN {a:1, b:'str', c:NULL, d:[1,2,3], e:True, f:{x:1, y:2}}"
 
-    actual = (await modclient.graph().query(query)).result_set[0][0]
+    actual = (await decoded_r.graph().query(query)).result_set[0][0]
     expected = {
         "a": 1,
         "b": "str",
@@ -130,40 +129,40 @@ async def test_map(modclient: redis.Redis):
 
 
 @pytest.mark.redismod
-async def test_point(modclient: redis.Redis):
+async def test_point(decoded_r: redis.Redis):
     query = "RETURN point({latitude: 32.070794860, longitude: 34.820751118})"
     expected_lat = 32.070794860
     expected_lon = 34.820751118
-    actual = (await modclient.graph().query(query)).result_set[0][0]
+    actual = (await decoded_r.graph().query(query)).result_set[0][0]
     assert abs(actual["latitude"] - expected_lat) < 0.001
     assert abs(actual["longitude"] - expected_lon) < 0.001
 
     query = "RETURN point({latitude: 32, longitude: 34.0})"
     expected_lat = 32
     expected_lon = 34
-    actual = (await modclient.graph().query(query)).result_set[0][0]
+    actual = (await decoded_r.graph().query(query)).result_set[0][0]
     assert abs(actual["latitude"] - expected_lat) < 0.001
     assert abs(actual["longitude"] - expected_lon) < 0.001
 
 
 @pytest.mark.redismod
-async def test_index_response(modclient: redis.Redis):
-    result_set = await modclient.graph().query("CREATE INDEX ON :person(age)")
+async def test_index_response(decoded_r: redis.Redis):
+    result_set = await decoded_r.graph().query("CREATE INDEX ON :person(age)")
     assert 1 == result_set.indices_created
 
-    result_set = await modclient.graph().query("CREATE INDEX ON :person(age)")
+    result_set = await decoded_r.graph().query("CREATE INDEX ON :person(age)")
     assert 0 == result_set.indices_created
 
-    result_set = await modclient.graph().query("DROP INDEX ON :person(age)")
+    result_set = await decoded_r.graph().query("DROP INDEX ON :person(age)")
     assert 1 == result_set.indices_deleted
 
     with pytest.raises(ResponseError):
-        await modclient.graph().query("DROP INDEX ON :person(age)")
+        await decoded_r.graph().query("DROP INDEX ON :person(age)")
 
 
 @pytest.mark.redismod
-async def test_stringify_query_result(modclient: redis.Redis):
-    graph = modclient.graph()
+async def test_stringify_query_result(decoded_r: redis.Redis):
+    graph = decoded_r.graph()
 
     john = Node(
         alias="a",
@@ -216,14 +215,14 @@ async def test_stringify_query_result(modclient: redis.Redis):
 
 
 @pytest.mark.redismod
-async def test_optional_match(modclient: redis.Redis):
+async def test_optional_match(decoded_r: redis.Redis):
     # Build a graph of form (a)-[R]->(b)
     node0 = Node(node_id=0, label="L1", properties={"value": "a"})
     node1 = Node(node_id=1, label="L1", properties={"value": "b"})
 
     edge01 = Edge(node0, "R", node1, edge_id=0)
 
-    graph = modclient.graph()
+    graph = decoded_r.graph()
     graph.add_node(node0)
     graph.add_node(node1)
     graph.add_edge(edge01)
@@ -241,17 +240,17 @@ async def test_optional_match(modclient: redis.Redis):
 
 
 @pytest.mark.redismod
-async def test_cached_execution(modclient: redis.Redis):
-    await modclient.graph().query("CREATE ()")
+async def test_cached_execution(decoded_r: redis.Redis):
+    await decoded_r.graph().query("CREATE ()")
 
-    uncached_result = await modclient.graph().query(
+    uncached_result = await decoded_r.graph().query(
         "MATCH (n) RETURN n, $param", {"param": [0]}
     )
     assert uncached_result.cached_execution is False
 
     # loop to make sure the query is cached on each thread on server
     for x in range(0, 64):
-        cached_result = await modclient.graph().query(
+        cached_result = await decoded_r.graph().query(
             "MATCH (n) RETURN n, $param", {"param": [0]}
         )
         assert uncached_result.result_set == cached_result.result_set
@@ -261,51 +260,51 @@ async def test_cached_execution(modclient: redis.Redis):
 
 
 @pytest.mark.redismod
-async def test_slowlog(modclient: redis.Redis):
+async def test_slowlog(decoded_r: redis.Redis):
     create_query = """CREATE
     (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
     (:Rider {name:'Dani Pedrosa'})-[:rides]->(:Team {name:'Honda'}),
     (:Rider {name:'Andrea Dovizioso'})-[:rides]->(:Team {name:'Ducati'})"""
-    await modclient.graph().query(create_query)
+    await decoded_r.graph().query(create_query)
 
-    results = await modclient.graph().slowlog()
+    results = await decoded_r.graph().slowlog()
     assert results[0][1] == "GRAPH.QUERY"
     assert results[0][2] == create_query
 
 
 @pytest.mark.redismod
 @pytest.mark.xfail(strict=False)
-async def test_query_timeout(modclient: redis.Redis):
+async def test_query_timeout(decoded_r: redis.Redis):
     # Build a sample graph with 1000 nodes.
-    await modclient.graph().query("UNWIND range(0,1000) as val CREATE ({v: val})")
+    await decoded_r.graph().query("UNWIND range(0,1000) as val CREATE ({v: val})")
     # Issue a long-running query with a 1-millisecond timeout.
     with pytest.raises(ResponseError):
-        await modclient.graph().query("MATCH (a), (b), (c), (d) RETURN *", timeout=1)
+        await decoded_r.graph().query("MATCH (a), (b), (c), (d) RETURN *", timeout=1)
         assert False is False
 
     with pytest.raises(Exception):
-        await modclient.graph().query("RETURN 1", timeout="str")
+        await decoded_r.graph().query("RETURN 1", timeout="str")
         assert False is False
 
 
 @pytest.mark.redismod
-async def test_read_only_query(modclient: redis.Redis):
+async def test_read_only_query(decoded_r: redis.Redis):
     with pytest.raises(Exception):
         # Issue a write query, specifying read-only true,
         # this call should fail.
-        await modclient.graph().query("CREATE (p:person {name:'a'})", read_only=True)
+        await decoded_r.graph().query("CREATE (p:person {name:'a'})", read_only=True)
         assert False is False
 
 
 @pytest.mark.redismod
-async def test_profile(modclient: redis.Redis):
+async def test_profile(decoded_r: redis.Redis):
     q = """UNWIND range(1, 3) AS x CREATE (p:Person {v:x})"""
-    profile = (await modclient.graph().profile(q)).result_set
+    profile = (await decoded_r.graph().profile(q)).result_set
     assert "Create | Records produced: 3" in profile
     assert "Unwind | Records produced: 3" in profile
 
     q = "MATCH (p:Person) WHERE p.v > 1 RETURN p"
-    profile = (await modclient.graph().profile(q)).result_set
+    profile = (await decoded_r.graph().profile(q)).result_set
     assert "Results | Records produced: 2" in profile
     assert "Project | Records produced: 2" in profile
     assert "Filter | Records produced: 2" in profile
@@ -314,16 +313,16 @@ async def test_profile(modclient: redis.Redis):
 
 @pytest.mark.redismod
 @skip_if_redis_enterprise()
-async def test_config(modclient: redis.Redis):
+async def test_config(decoded_r: redis.Redis):
     config_name = "RESULTSET_SIZE"
     config_value = 3
 
     # Set configuration
-    response = await modclient.graph().config(config_name, config_value, set=True)
+    response = await decoded_r.graph().config(config_name, config_value, set=True)
     assert response == "OK"
 
     # Make sure config been updated.
-    response = await modclient.graph().config(config_name, set=False)
+    response = await decoded_r.graph().config(config_name, set=False)
     expected_response = [config_name, config_value]
     assert response == expected_response
 
@@ -331,46 +330,46 @@ async def test_config(modclient: redis.Redis):
     config_value = 1 << 20  # 1MB
 
     # Set configuration
-    response = await modclient.graph().config(config_name, config_value, set=True)
+    response = await decoded_r.graph().config(config_name, config_value, set=True)
     assert response == "OK"
 
     # Make sure config been updated.
-    response = await modclient.graph().config(config_name, set=False)
+    response = await decoded_r.graph().config(config_name, set=False)
     expected_response = [config_name, config_value]
     assert response == expected_response
 
     # reset to default
-    await modclient.graph().config("QUERY_MEM_CAPACITY", 0, set=True)
-    await modclient.graph().config("RESULTSET_SIZE", -100, set=True)
+    await decoded_r.graph().config("QUERY_MEM_CAPACITY", 0, set=True)
+    await decoded_r.graph().config("RESULTSET_SIZE", -100, set=True)
 
 
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
-async def test_list_keys(modclient: redis.Redis):
-    result = await modclient.graph().list_keys()
+async def test_list_keys(decoded_r: redis.Redis):
+    result = await decoded_r.graph().list_keys()
     assert result == []
 
-    await modclient.graph("G").query("CREATE (n)")
-    result = await modclient.graph().list_keys()
+    await decoded_r.graph("G").query("CREATE (n)")
+    result = await decoded_r.graph().list_keys()
     assert result == ["G"]
 
-    await modclient.graph("X").query("CREATE (m)")
-    result = await modclient.graph().list_keys()
+    await decoded_r.graph("X").query("CREATE (m)")
+    result = await decoded_r.graph().list_keys()
     assert result == ["G", "X"]
 
-    await modclient.delete("G")
-    await modclient.rename("X", "Z")
-    result = await modclient.graph().list_keys()
+    await decoded_r.delete("G")
+    await decoded_r.rename("X", "Z")
+    result = await decoded_r.graph().list_keys()
     assert result == ["Z"]
 
-    await modclient.delete("Z")
-    result = await modclient.graph().list_keys()
+    await decoded_r.delete("Z")
+    result = await decoded_r.graph().list_keys()
     assert result == []
 
 
 @pytest.mark.redismod
-async def test_multi_label(modclient: redis.Redis):
-    redis_graph = modclient.graph("g")
+async def test_multi_label(decoded_r: redis.Redis):
+    redis_graph = decoded_r.graph("g")
 
     node = Node(label=["l", "ll"])
     redis_graph.add_node(node)
@@ -395,8 +394,8 @@ async def test_multi_label(modclient: redis.Redis):
 
 
 @pytest.mark.redismod
-async def test_execution_plan(modclient: redis.Redis):
-    redis_graph = modclient.graph("execution_plan")
+async def test_execution_plan(decoded_r: redis.Redis):
+    redis_graph = decoded_r.graph("execution_plan")
     create_query = """CREATE
     (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
     (:Rider {name:'Dani Pedrosa'})-[:rides]->(:Team {name:'Honda'}),
@@ -414,8 +413,8 @@ async def test_execution_plan(modclient: redis.Redis):
 
 
 @pytest.mark.redismod
-async def test_explain(modclient: redis.Redis):
-    redis_graph = modclient.graph("execution_plan")
+async def test_explain(decoded_r: redis.Redis):
+    redis_graph = decoded_r.graph("execution_plan")
     # graph creation / population
     create_query = """CREATE
 (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
diff --git a/tests/test_asyncio/test_json.py b/tests/test_asyncio/test_json.py
index 12bdacdb9a..6f3e8c3251 100644
--- a/tests/test_asyncio/test_json.py
+++ b/tests/test_asyncio/test_json.py
@@ -1,318 +1,338 @@
 import pytest
-
 import redis.asyncio as redis
 from redis import exceptions
 from redis.commands.json.path import Path
-from tests.conftest import skip_ifmodversion_lt
+from tests.conftest import assert_resp_response, skip_ifmodversion_lt
 
 
 @pytest.mark.redismod
-async def test_json_setbinarykey(modclient: redis.Redis):
+async def test_json_setbinarykey(decoded_r: redis.Redis):
     d = {"hello": "world", b"some": "value"}
     with pytest.raises(TypeError):
-        modclient.json().set("somekey", Path.root_path(), d)
-    assert await modclient.json().set("somekey", Path.root_path(), d, decode_keys=True)
+        decoded_r.json().set("somekey", Path.root_path(), d)
+    assert await decoded_r.json().set("somekey", Path.root_path(), d, decode_keys=True)
 
 
 @pytest.mark.redismod
-async def test_json_setgetdeleteforget(modclient: redis.Redis):
-    assert await modclient.json().set("foo", Path.root_path(), "bar")
-    assert await modclient.json().get("foo") == "bar"
-    assert await modclient.json().get("baz") is None
-    assert await modclient.json().delete("foo") == 1
-    assert await modclient.json().forget("foo") == 0  # second delete
-    assert await modclient.exists("foo") == 0
+async def test_json_setgetdeleteforget(decoded_r: redis.Redis):
+    assert await decoded_r.json().set("foo", Path.root_path(), "bar")
+    assert_resp_response(decoded_r, await decoded_r.json().get("foo"), "bar", [["bar"]])
+    assert await decoded_r.json().get("baz") is None
+    assert await decoded_r.json().delete("foo") == 1
+    assert await decoded_r.json().forget("foo") == 0  # second delete
+    assert await decoded_r.exists("foo") == 0
 
 
 @pytest.mark.redismod
-async def test_jsonget(modclient: redis.Redis):
-    await modclient.json().set("foo", Path.root_path(), "bar")
-    assert await modclient.json().get("foo") == "bar"
+async def test_jsonget(decoded_r: redis.Redis):
+    await decoded_r.json().set("foo", Path.root_path(), "bar")
+    assert_resp_response(decoded_r, await decoded_r.json().get("foo"), "bar", [["bar"]])
 
 
 @pytest.mark.redismod
-async def test_json_get_jset(modclient: redis.Redis):
-    assert await modclient.json().set("foo", Path.root_path(), "bar")
-    assert "bar" == await modclient.json().get("foo")
-    assert await modclient.json().get("baz") is None
-    assert 1 == await modclient.json().delete("foo")
-    assert await modclient.exists("foo") == 0
+async def test_json_get_jset(decoded_r: redis.Redis):
+    assert await decoded_r.json().set("foo", Path.root_path(), "bar")
+    assert_resp_response(decoded_r, await decoded_r.json().get("foo"), "bar", [["bar"]])
+    assert await decoded_r.json().get("baz") is None
+    assert 1 == await decoded_r.json().delete("foo")
+    assert await decoded_r.exists("foo") == 0
 
 
 @pytest.mark.redismod
-@skip_ifmodversion_lt("2.6.0", "ReJSON")  # todo: update after the release
-async def test_json_merge(modclient: redis.Redis):
+async def test_nonascii_setgetdelete(decoded_r: redis.Redis):
+    assert await decoded_r.json().set("notascii", Path.root_path(), "hyvää-élève")
+    res = "hyvää-élève"
+    assert_resp_response(
+        decoded_r, await decoded_r.json().get("notascii", no_escape=True), res, [[res]]
+    )
+    assert 1 == await decoded_r.json().delete("notascii")
+    assert await decoded_r.exists("notascii") == 0
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.6.0", "ReJSON")
+async def test_json_merge(decoded_r: redis.Redis):
     # Test with root path $
-    assert await modclient.json().set(
+    assert await decoded_r.json().set(
         "person_data",
         "$",
         {"person1": {"personal_data": {"name": "John"}}},
     )
-    assert await modclient.json().merge(
+    assert await decoded_r.json().merge(
         "person_data", "$", {"person1": {"personal_data": {"hobbies": "reading"}}}
     )
-    assert await modclient.json().get("person_data") == {
+    assert await decoded_r.json().get("person_data") == {
         "person1": {"personal_data": {"name": "John", "hobbies": "reading"}}
     }
 
     # Test with root path path $.person1.personal_data
-    assert await modclient.json().merge(
+    assert await decoded_r.json().merge(
         "person_data", "$.person1.personal_data", {"country": "Israel"}
     )
-    assert await modclient.json().get("person_data") == {
+    assert await decoded_r.json().get("person_data") == {
         "person1": {
             "personal_data": {"name": "John", "hobbies": "reading", "country": "Israel"}
         }
     }
 
     # Test with null value to delete a value
-    assert await modclient.json().merge(
+    assert await decoded_r.json().merge(
         "person_data", "$.person1.personal_data", {"name": None}
     )
-    assert await modclient.json().get("person_data") == {
+    assert await decoded_r.json().get("person_data") == {
         "person1": {"personal_data": {"country": "Israel", "hobbies": "reading"}}
     }
 
 
 @pytest.mark.redismod
-async def test_nonascii_setgetdelete(modclient: redis.Redis):
-    assert await modclient.json().set("notascii", Path.root_path(), "hyvää-élève")
-    assert "hyvää-élève" == await modclient.json().get("notascii", no_escape=True)
-    assert 1 == await modclient.json().delete("notascii")
-    assert await modclient.exists("notascii") == 0
-
-
-@pytest.mark.redismod
-async def test_jsonsetexistentialmodifiersshouldsucceed(modclient: redis.Redis):
+async def test_jsonsetexistentialmodifiersshouldsucceed(decoded_r: redis.Redis):
     obj = {"foo": "bar"}
-    assert await modclient.json().set("obj", Path.root_path(), obj)
+    assert await decoded_r.json().set("obj", Path.root_path(), obj)
 
     # Test that flags prevent updates when conditions are unmet
-    assert await modclient.json().set("obj", Path("foo"), "baz", nx=True) is None
-    assert await modclient.json().set("obj", Path("qaz"), "baz", xx=True) is None
+    assert await decoded_r.json().set("obj", Path("foo"), "baz", nx=True) is None
+    assert await decoded_r.json().set("obj", Path("qaz"), "baz", xx=True) is None
 
     # Test that flags allow updates when conditions are met
-    assert await modclient.json().set("obj", Path("foo"), "baz", xx=True)
-    assert await modclient.json().set("obj", Path("qaz"), "baz", nx=True)
+    assert await decoded_r.json().set("obj", Path("foo"), "baz", xx=True)
+    assert await decoded_r.json().set("obj", Path("qaz"), "baz", nx=True)
 
     # Test that flags are mutually exlusive
     with pytest.raises(Exception):
-        await modclient.json().set("obj", Path("foo"), "baz", nx=True, xx=True)
+        await decoded_r.json().set("obj", Path("foo"), "baz", nx=True, xx=True)
 
 
 @pytest.mark.redismod
-async def test_mgetshouldsucceed(modclient: redis.Redis):
-    await modclient.json().set("1", Path.root_path(), 1)
-    await modclient.json().set("2", Path.root_path(), 2)
-    assert await modclient.json().mget(["1"], Path.root_path()) == [1]
+async def test_mgetshouldsucceed(decoded_r: redis.Redis):
+    await decoded_r.json().set("1", Path.root_path(), 1)
+    await decoded_r.json().set("2", Path.root_path(), 2)
+    assert await decoded_r.json().mget(["1"], Path.root_path()) == [1]
 
-    assert await modclient.json().mget([1, 2], Path.root_path()) == [1, 2]
+    assert await decoded_r.json().mget([1, 2], Path.root_path()) == [1, 2]
 
 
 @pytest.mark.redismod
-@skip_ifmodversion_lt("2.6.0", "ReJSON")  # todo: update after the release
-async def test_mset(modclient: redis.Redis):
-    await modclient.json().mset(
+@skip_ifmodversion_lt("2.6.0", "ReJSON")
+async def test_mset(decoded_r: redis.Redis):
+    await decoded_r.json().mset(
         [("1", Path.root_path(), 1), ("2", Path.root_path(), 2)]
     )
 
-    assert await modclient.json().mget(["1"], Path.root_path()) == [1]
-    assert await modclient.json().mget(["1", "2"], Path.root_path()) == [1, 2]
+    assert await decoded_r.json().mget(["1"], Path.root_path()) == [1]
+    assert await decoded_r.json().mget(["1", "2"], Path.root_path()) == [1, 2]
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
-async def test_clear(modclient: redis.Redis):
-    await modclient.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
-    assert 1 == await modclient.json().clear("arr", Path.root_path())
-    assert [] == await modclient.json().get("arr")
+async def test_clear(decoded_r: redis.Redis):
+    await decoded_r.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 1 == await decoded_r.json().clear("arr", Path.root_path())
+    assert_resp_response(decoded_r, await decoded_r.json().get("arr"), [], [[[]]])
 
 
 @pytest.mark.redismod
-async def test_type(modclient: redis.Redis):
-    await modclient.json().set("1", Path.root_path(), 1)
-    assert "integer" == await modclient.json().type("1", Path.root_path())
-    assert "integer" == await modclient.json().type("1")
+async def test_type(decoded_r: redis.Redis):
+    await decoded_r.json().set("1", Path.root_path(), 1)
+    assert_resp_response(
+        decoded_r,
+        await decoded_r.json().type("1", Path.root_path()),
+        "integer",
+        ["integer"],
+    )
+    assert_resp_response(
+        decoded_r, await decoded_r.json().type("1"), "integer", ["integer"]
+    )
 
 
 @pytest.mark.redismod
-async def test_numincrby(modclient):
-    await modclient.json().set("num", Path.root_path(), 1)
-    assert 2 == await modclient.json().numincrby("num", Path.root_path(), 1)
-    assert 2.5 == await modclient.json().numincrby("num", Path.root_path(), 0.5)
-    assert 1.25 == await modclient.json().numincrby("num", Path.root_path(), -1.25)
+async def test_numincrby(decoded_r):
+    await decoded_r.json().set("num", Path.root_path(), 1)
+    assert_resp_response(
+        decoded_r, await decoded_r.json().numincrby("num", Path.root_path(), 1), 2, [2]
+    )
+    res = await decoded_r.json().numincrby("num", Path.root_path(), 0.5)
+    assert_resp_response(decoded_r, res, 2.5, [2.5])
+    res = await decoded_r.json().numincrby("num", Path.root_path(), -1.25)
+    assert_resp_response(decoded_r, res, 1.25, [1.25])
 
 
 @pytest.mark.redismod
-async def test_nummultby(modclient: redis.Redis):
-    await modclient.json().set("num", Path.root_path(), 1)
+async def test_nummultby(decoded_r: redis.Redis):
+    await decoded_r.json().set("num", Path.root_path(), 1)
 
     with pytest.deprecated_call():
-        assert 2 == await modclient.json().nummultby("num", Path.root_path(), 2)
-        assert 5 == await modclient.json().nummultby("num", Path.root_path(), 2.5)
-        assert 2.5 == await modclient.json().nummultby("num", Path.root_path(), 0.5)
+        res = await decoded_r.json().nummultby("num", Path.root_path(), 2)
+        assert_resp_response(decoded_r, res, 2, [2])
+        res = await decoded_r.json().nummultby("num", Path.root_path(), 2.5)
+        assert_resp_response(decoded_r, res, 5, [5])
+        res = await decoded_r.json().nummultby("num", Path.root_path(), 0.5)
+        assert_resp_response(decoded_r, res, 2.5, [2.5])
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
-async def test_toggle(modclient: redis.Redis):
-    await modclient.json().set("bool", Path.root_path(), False)
-    assert await modclient.json().toggle("bool", Path.root_path())
-    assert await modclient.json().toggle("bool", Path.root_path()) is False
+async def test_toggle(decoded_r: redis.Redis):
+    await decoded_r.json().set("bool", Path.root_path(), False)
+    assert await decoded_r.json().toggle("bool", Path.root_path())
+    assert await decoded_r.json().toggle("bool", Path.root_path()) is False
     # check non-boolean value
-    await modclient.json().set("num", Path.root_path(), 1)
+    await decoded_r.json().set("num", Path.root_path(), 1)
     with pytest.raises(exceptions.ResponseError):
-        await modclient.json().toggle("num", Path.root_path())
+        await decoded_r.json().toggle("num", Path.root_path())
 
 
 @pytest.mark.redismod
-async def test_strappend(modclient: redis.Redis):
-    await modclient.json().set("jsonkey", Path.root_path(), "foo")
-    assert 6 == await modclient.json().strappend("jsonkey", "bar")
-    assert "foobar" == await modclient.json().get("jsonkey", Path.root_path())
+async def test_strappend(decoded_r: redis.Redis):
+    await decoded_r.json().set("jsonkey", Path.root_path(), "foo")
+    assert 6 == await decoded_r.json().strappend("jsonkey", "bar")
+    res = await decoded_r.json().get("jsonkey", Path.root_path())
+    assert_resp_response(decoded_r, res, "foobar", [["foobar"]])
 
 
 @pytest.mark.redismod
-async def test_strlen(modclient: redis.Redis):
-    await modclient.json().set("str", Path.root_path(), "foo")
-    assert 3 == await modclient.json().strlen("str", Path.root_path())
-    await modclient.json().strappend("str", "bar", Path.root_path())
-    assert 6 == await modclient.json().strlen("str", Path.root_path())
-    assert 6 == await modclient.json().strlen("str")
+async def test_strlen(decoded_r: redis.Redis):
+    await decoded_r.json().set("str", Path.root_path(), "foo")
+    assert 3 == await decoded_r.json().strlen("str", Path.root_path())
+    await decoded_r.json().strappend("str", "bar", Path.root_path())
+    assert 6 == await decoded_r.json().strlen("str", Path.root_path())
+    assert 6 == await decoded_r.json().strlen("str")
 
 
 @pytest.mark.redismod
-async def test_arrappend(modclient: redis.Redis):
-    await modclient.json().set("arr", Path.root_path(), [1])
-    assert 2 == await modclient.json().arrappend("arr", Path.root_path(), 2)
-    assert 4 == await modclient.json().arrappend("arr", Path.root_path(), 3, 4)
-    assert 7 == await modclient.json().arrappend("arr", Path.root_path(), *[5, 6, 7])
+async def test_arrappend(decoded_r: redis.Redis):
+    await decoded_r.json().set("arr", Path.root_path(), [1])
+    assert 2 == await decoded_r.json().arrappend("arr", Path.root_path(), 2)
+    assert 4 == await decoded_r.json().arrappend("arr", Path.root_path(), 3, 4)
+    assert 7 == await decoded_r.json().arrappend("arr", Path.root_path(), *[5, 6, 7])
 
 
 @pytest.mark.redismod
-async def test_arrindex(modclient: redis.Redis):
+async def test_arrindex(decoded_r: redis.Redis):
     r_path = Path.root_path()
-    await modclient.json().set("arr", r_path, [0, 1, 2, 3, 4])
-    assert 1 == await modclient.json().arrindex("arr", r_path, 1)
-    assert -1 == await modclient.json().arrindex("arr", r_path, 1, 2)
-    assert 4 == await modclient.json().arrindex("arr", r_path, 4)
-    assert 4 == await modclient.json().arrindex("arr", r_path, 4, start=0)
-    assert 4 == await modclient.json().arrindex("arr", r_path, 4, start=0, stop=5000)
-    assert -1 == await modclient.json().arrindex("arr", r_path, 4, start=0, stop=-1)
-    assert -1 == await modclient.json().arrindex("arr", r_path, 4, start=1, stop=3)
+    await decoded_r.json().set("arr", r_path, [0, 1, 2, 3, 4])
+    assert 1 == await decoded_r.json().arrindex("arr", r_path, 1)
+    assert -1 == await decoded_r.json().arrindex("arr", r_path, 1, 2)
+    assert 4 == await decoded_r.json().arrindex("arr", r_path, 4)
+    assert 4 == await decoded_r.json().arrindex("arr", r_path, 4, start=0)
+    assert 4 == await decoded_r.json().arrindex("arr", r_path, 4, start=0, stop=5000)
+    assert -1 == await decoded_r.json().arrindex("arr", r_path, 4, start=0, stop=-1)
+    assert -1 == await decoded_r.json().arrindex("arr", r_path, 4, start=1, stop=3)
 
 
 @pytest.mark.redismod
-async def test_arrinsert(modclient: redis.Redis):
-    await modclient.json().set("arr", Path.root_path(), [0, 4])
-    assert 5 - -await modclient.json().arrinsert("arr", Path.root_path(), 1, *[1, 2, 3])
-    assert [0, 1, 2, 3, 4] == await modclient.json().get("arr")
+async def test_arrinsert(decoded_r: redis.Redis):
+    await decoded_r.json().set("arr", Path.root_path(), [0, 4])
+    assert 5 == await decoded_r.json().arrinsert("arr", Path.root_path(), 1, *[1, 2, 3])
+    res = [0, 1, 2, 3, 4]
+    assert_resp_response(decoded_r, await decoded_r.json().get("arr"), res, [[res]])
 
     # test prepends
-    await modclient.json().set("val2", Path.root_path(), [5, 6, 7, 8, 9])
-    await modclient.json().arrinsert("val2", Path.root_path(), 0, ["some", "thing"])
-    assert await modclient.json().get("val2") == [["some", "thing"], 5, 6, 7, 8, 9]
+    await decoded_r.json().set("val2", Path.root_path(), [5, 6, 7, 8, 9])
+    await decoded_r.json().arrinsert("val2", Path.root_path(), 0, ["some", "thing"])
+    res = [["some", "thing"], 5, 6, 7, 8, 9]
+    assert_resp_response(decoded_r, await decoded_r.json().get("val2"), res, [[res]])
 
 
 @pytest.mark.redismod
-async def test_arrlen(modclient: redis.Redis):
-    await modclient.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
-    assert 5 == await modclient.json().arrlen("arr", Path.root_path())
-    assert 5 == await modclient.json().arrlen("arr")
-    assert await modclient.json().arrlen("fakekey") is None
+async def test_arrlen(decoded_r: redis.Redis):
+    await decoded_r.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 5 == await decoded_r.json().arrlen("arr", Path.root_path())
+    assert 5 == await decoded_r.json().arrlen("arr")
+    assert await decoded_r.json().arrlen("fakekey") is None
 
 
 @pytest.mark.redismod
-async def test_arrpop(modclient: redis.Redis):
-    await modclient.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
-    assert 4 == await modclient.json().arrpop("arr", Path.root_path(), 4)
-    assert 3 == await modclient.json().arrpop("arr", Path.root_path(), -1)
-    assert 2 == await modclient.json().arrpop("arr", Path.root_path())
-    assert 0 == await modclient.json().arrpop("arr", Path.root_path(), 0)
-    assert [1] == await modclient.json().get("arr")
+async def test_arrpop(decoded_r: redis.Redis):
+    await decoded_r.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 4 == await decoded_r.json().arrpop("arr", Path.root_path(), 4)
+    assert 3 == await decoded_r.json().arrpop("arr", Path.root_path(), -1)
+    assert 2 == await decoded_r.json().arrpop("arr", Path.root_path())
+    assert 0 == await decoded_r.json().arrpop("arr", Path.root_path(), 0)
+    assert_resp_response(decoded_r, await decoded_r.json().get("arr"), [1], [[[1]]])
 
     # test out of bounds
-    await modclient.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
-    assert 4 == await modclient.json().arrpop("arr", Path.root_path(), 99)
+    await decoded_r.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 4 == await decoded_r.json().arrpop("arr", Path.root_path(), 99)
 
     # none test
-    await modclient.json().set("arr", Path.root_path(), [])
-    assert await modclient.json().arrpop("arr") is None
+    await decoded_r.json().set("arr", Path.root_path(), [])
+    assert await decoded_r.json().arrpop("arr") is None
 
 
 @pytest.mark.redismod
-async def test_arrtrim(modclient: redis.Redis):
-    await modclient.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
-    assert 3 == await modclient.json().arrtrim("arr", Path.root_path(), 1, 3)
-    assert [1, 2, 3] == await modclient.json().get("arr")
+async def test_arrtrim(decoded_r: redis.Redis):
+    await decoded_r.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 3 == await decoded_r.json().arrtrim("arr", Path.root_path(), 1, 3)
+    res = await decoded_r.json().get("arr")
+    assert_resp_response(decoded_r, res, [1, 2, 3], [[[1, 2, 3]]])
 
     # <0 test, should be 0 equivalent
-    await modclient.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
-    assert 0 == await modclient.json().arrtrim("arr", Path.root_path(), -1, 3)
+    await decoded_r.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 0 == await decoded_r.json().arrtrim("arr", Path.root_path(), -1, 3)
 
     # testing stop > end
-    await modclient.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
-    assert 2 == await modclient.json().arrtrim("arr", Path.root_path(), 3, 99)
+    await decoded_r.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 2 == await decoded_r.json().arrtrim("arr", Path.root_path(), 3, 99)
 
     # start > array size and stop
-    await modclient.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
-    assert 0 == await modclient.json().arrtrim("arr", Path.root_path(), 9, 1)
+    await decoded_r.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 0 == await decoded_r.json().arrtrim("arr", Path.root_path(), 9, 1)
 
     # all larger
-    await modclient.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
-    assert 0 == await modclient.json().arrtrim("arr", Path.root_path(), 9, 11)
+    await decoded_r.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
+    assert 0 == await decoded_r.json().arrtrim("arr", Path.root_path(), 9, 11)
 
 
 @pytest.mark.redismod
-async def test_resp(modclient: redis.Redis):
+async def test_resp(decoded_r: redis.Redis):
     obj = {"foo": "bar", "baz": 1, "qaz": True}
-    await modclient.json().set("obj", Path.root_path(), obj)
-    assert "bar" == await modclient.json().resp("obj", Path("foo"))
-    assert 1 == await modclient.json().resp("obj", Path("baz"))
-    assert await modclient.json().resp("obj", Path("qaz"))
-    assert isinstance(await modclient.json().resp("obj"), list)
+    await decoded_r.json().set("obj", Path.root_path(), obj)
+    assert "bar" == await decoded_r.json().resp("obj", Path("foo"))
+    assert 1 == await decoded_r.json().resp("obj", Path("baz"))
+    assert await decoded_r.json().resp("obj", Path("qaz"))
+    assert isinstance(await decoded_r.json().resp("obj"), list)
 
 
 @pytest.mark.redismod
-async def test_objkeys(modclient: redis.Redis):
+async def test_objkeys(decoded_r: redis.Redis):
     obj = {"foo": "bar", "baz": "qaz"}
-    await modclient.json().set("obj", Path.root_path(), obj)
-    keys = await modclient.json().objkeys("obj", Path.root_path())
+    await decoded_r.json().set("obj", Path.root_path(), obj)
+    keys = await decoded_r.json().objkeys("obj", Path.root_path())
     keys.sort()
     exp = list(obj.keys())
     exp.sort()
     assert exp == keys
 
-    await modclient.json().set("obj", Path.root_path(), obj)
-    keys = await modclient.json().objkeys("obj")
+    await decoded_r.json().set("obj", Path.root_path(), obj)
+    keys = await decoded_r.json().objkeys("obj")
     assert keys == list(obj.keys())
 
-    assert await modclient.json().objkeys("fakekey") is None
+    assert await decoded_r.json().objkeys("fakekey") is None
 
 
 @pytest.mark.redismod
-async def test_objlen(modclient: redis.Redis):
+async def test_objlen(decoded_r: redis.Redis):
     obj = {"foo": "bar", "baz": "qaz"}
-    await modclient.json().set("obj", Path.root_path(), obj)
-    assert len(obj) == await modclient.json().objlen("obj", Path.root_path())
+    await decoded_r.json().set("obj", Path.root_path(), obj)
+    assert len(obj) == await decoded_r.json().objlen("obj", Path.root_path())
 
-    await modclient.json().set("obj", Path.root_path(), obj)
-    assert len(obj) == await modclient.json().objlen("obj")
+    await decoded_r.json().set("obj", Path.root_path(), obj)
+    assert len(obj) == await decoded_r.json().objlen("obj")
 
 
 # @pytest.mark.redismod
-# async def test_json_commands_in_pipeline(modclient: redis.Redis):
-#     async with modclient.json().pipeline() as p:
+# async def test_json_commands_in_pipeline(decoded_r: redis.Redis):
+#     async with decoded_r.json().pipeline() as p:
 #         p.set("foo", Path.root_path(), "bar")
 #         p.get("foo")
 #         p.delete("foo")
 #         assert [True, "bar", 1] == await p.execute()
-#     assert await modclient.keys() == []
-#     assert await modclient.get("foo") is None
+#     assert await decoded_r.keys() == []
+#     assert await decoded_r.get("foo") is None
 
 #     # now with a true, json object
-#     await modclient.flushdb()
-#     p = await modclient.json().pipeline()
+#     await decoded_r.flushdb()
+#     p = await decoded_r.json().pipeline()
 #     d = {"hello": "world", "oh": "snap"}
 #     with pytest.deprecated_call():
 #         p.jsonset("foo", Path.root_path(), d)
@@ -320,23 +340,24 @@ async def test_objlen(modclient: redis.Redis):
 #     p.exists("notarealkey")
 #     p.delete("foo")
 #     assert [True, d, 0, 1] == p.execute()
-#     assert await modclient.keys() == []
-#     assert await modclient.get("foo") is None
+#     assert await decoded_r.keys() == []
+#     assert await decoded_r.get("foo") is None
 
 
 @pytest.mark.redismod
-async def test_json_delete_with_dollar(modclient: redis.Redis):
+async def test_json_delete_with_dollar(decoded_r: redis.Redis):
     doc1 = {"a": 1, "nested": {"a": 2, "b": 3}}
-    assert await modclient.json().set("doc1", "$", doc1)
-    assert await modclient.json().delete("doc1", "$..a") == 2
-    r = await modclient.json().get("doc1", "$")
-    assert r == [{"nested": {"b": 3}}]
+    assert await decoded_r.json().set("doc1", "$", doc1)
+    assert await decoded_r.json().delete("doc1", "$..a") == 2
+    res = [{"nested": {"b": 3}}]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
 
     doc2 = {"a": {"a": 2, "b": 3}, "b": ["a", "b"], "nested": {"b": [True, "a", "b"]}}
-    assert await modclient.json().set("doc2", "$", doc2)
-    assert await modclient.json().delete("doc2", "$..a") == 1
-    res = await modclient.json().get("doc2", "$")
-    assert res == [{"nested": {"b": [True, "a", "b"]}, "b": ["a", "b"]}]
+    assert await decoded_r.json().set("doc2", "$", doc2)
+    assert await decoded_r.json().delete("doc2", "$..a") == 1
+    res = await decoded_r.json().get("doc2", "$")
+    res = [{"nested": {"b": [True, "a", "b"]}, "b": ["a", "b"]}]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc2", "$"), res, [res])
 
     doc3 = [
         {
@@ -350,8 +371,8 @@ async def test_json_delete_with_dollar(modclient: redis.Redis):
             ],
         }
     ]
-    assert await modclient.json().set("doc3", "$", doc3)
-    assert await modclient.json().delete("doc3", '$.[0]["nested"]..ciao') == 3
+    assert await decoded_r.json().set("doc3", "$", doc3)
+    assert await decoded_r.json().delete("doc3", '$.[0]["nested"]..ciao') == 3
 
     doc3val = [
         [
@@ -367,29 +388,29 @@ async def test_json_delete_with_dollar(modclient: redis.Redis):
             }
         ]
     ]
-    res = await modclient.json().get("doc3", "$")
-    assert res == doc3val
+    res = await decoded_r.json().get("doc3", "$")
+    assert_resp_response(decoded_r, res, doc3val, [doc3val])
 
     # Test async default path
-    assert await modclient.json().delete("doc3") == 1
-    assert await modclient.json().get("doc3", "$") is None
+    assert await decoded_r.json().delete("doc3") == 1
+    assert await decoded_r.json().get("doc3", "$") is None
 
-    await modclient.json().delete("not_a_document", "..a")
+    await decoded_r.json().delete("not_a_document", "..a")
 
 
 @pytest.mark.redismod
-async def test_json_forget_with_dollar(modclient: redis.Redis):
+async def test_json_forget_with_dollar(decoded_r: redis.Redis):
     doc1 = {"a": 1, "nested": {"a": 2, "b": 3}}
-    assert await modclient.json().set("doc1", "$", doc1)
-    assert await modclient.json().forget("doc1", "$..a") == 2
-    r = await modclient.json().get("doc1", "$")
-    assert r == [{"nested": {"b": 3}}]
+    assert await decoded_r.json().set("doc1", "$", doc1)
+    assert await decoded_r.json().forget("doc1", "$..a") == 2
+    res = [{"nested": {"b": 3}}]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
 
     doc2 = {"a": {"a": 2, "b": 3}, "b": ["a", "b"], "nested": {"b": [True, "a", "b"]}}
-    assert await modclient.json().set("doc2", "$", doc2)
-    assert await modclient.json().forget("doc2", "$..a") == 1
-    res = await modclient.json().get("doc2", "$")
-    assert res == [{"nested": {"b": [True, "a", "b"]}, "b": ["a", "b"]}]
+    assert await decoded_r.json().set("doc2", "$", doc2)
+    assert await decoded_r.json().forget("doc2", "$..a") == 1
+    res = [{"nested": {"b": [True, "a", "b"]}, "b": ["a", "b"]}]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc2", "$"), res, [res])
 
     doc3 = [
         {
@@ -403,8 +424,8 @@ async def test_json_forget_with_dollar(modclient: redis.Redis):
             ],
         }
     ]
-    assert await modclient.json().set("doc3", "$", doc3)
-    assert await modclient.json().forget("doc3", '$.[0]["nested"]..ciao') == 3
+    assert await decoded_r.json().set("doc3", "$", doc3)
+    assert await decoded_r.json().forget("doc3", '$.[0]["nested"]..ciao') == 3
 
     doc3val = [
         [
@@ -420,161 +441,165 @@ async def test_json_forget_with_dollar(modclient: redis.Redis):
             }
         ]
     ]
-    res = await modclient.json().get("doc3", "$")
-    assert res == doc3val
+    res = await decoded_r.json().get("doc3", "$")
+    assert_resp_response(decoded_r, res, doc3val, [doc3val])
 
     # Test async default path
-    assert await modclient.json().forget("doc3") == 1
-    assert await modclient.json().get("doc3", "$") is None
+    assert await decoded_r.json().forget("doc3") == 1
+    assert await decoded_r.json().get("doc3", "$") is None
 
-    await modclient.json().forget("not_a_document", "..a")
+    await decoded_r.json().forget("not_a_document", "..a")
 
 
 @pytest.mark.redismod
-async def test_json_mget_dollar(modclient: redis.Redis):
+async def test_json_mget_dollar(decoded_r: redis.Redis):
     # Test mget with multi paths
-    await modclient.json().set(
+    await decoded_r.json().set(
         "doc1",
         "$",
         {"a": 1, "b": 2, "nested": {"a": 3}, "c": None, "nested2": {"a": None}},
     )
-    await modclient.json().set(
+    await decoded_r.json().set(
         "doc2",
         "$",
         {"a": 4, "b": 5, "nested": {"a": 6}, "c": None, "nested2": {"a": [None]}},
     )
     # Compare also to single JSON.GET
-    assert await modclient.json().get("doc1", "$..a") == [1, 3, None]
-    assert await modclient.json().get("doc2", "$..a") == [4, 6, [None]]
+    res = [1, 3, None]
+    assert_resp_response(
+        decoded_r, await decoded_r.json().get("doc1", "$..a"), res, [res]
+    )
+    res = [4, 6, [None]]
+    assert_resp_response(
+        decoded_r, await decoded_r.json().get("doc2", "$..a"), res, [res]
+    )
 
     # Test mget with single path
-    await modclient.json().mget("doc1", "$..a") == [1, 3, None]
+    await decoded_r.json().mget("doc1", "$..a") == [1, 3, None]
     # Test mget with multi path
-    res = await modclient.json().mget(["doc1", "doc2"], "$..a")
+    res = await decoded_r.json().mget(["doc1", "doc2"], "$..a")
     assert res == [[1, 3, None], [4, 6, [None]]]
 
     # Test missing key
-    res = await modclient.json().mget(["doc1", "missing_doc"], "$..a")
+    res = await decoded_r.json().mget(["doc1", "missing_doc"], "$..a")
     assert res == [[1, 3, None], None]
-    res = await modclient.json().mget(["missing_doc1", "missing_doc2"], "$..a")
+    res = await decoded_r.json().mget(["missing_doc1", "missing_doc2"], "$..a")
     assert res == [None, None]
 
 
 @pytest.mark.redismod
-async def test_numby_commands_dollar(modclient: redis.Redis):
+async def test_numby_commands_dollar(decoded_r: redis.Redis):
 
     # Test NUMINCRBY
-    await modclient.json().set(
+    await decoded_r.json().set(
         "doc1", "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]}
     )
     # Test multi
-    assert await modclient.json().numincrby("doc1", "$..a", 2) == [None, 4, 7.0, None]
+    assert await decoded_r.json().numincrby("doc1", "$..a", 2) == [None, 4, 7.0, None]
 
-    res = await modclient.json().numincrby("doc1", "$..a", 2.5)
+    res = await decoded_r.json().numincrby("doc1", "$..a", 2.5)
     assert res == [None, 6.5, 9.5, None]
     # Test single
-    assert await modclient.json().numincrby("doc1", "$.b[1].a", 2) == [11.5]
+    assert await decoded_r.json().numincrby("doc1", "$.b[1].a", 2) == [11.5]
 
-    assert await modclient.json().numincrby("doc1", "$.b[2].a", 2) == [None]
-    assert await modclient.json().numincrby("doc1", "$.b[1].a", 3.5) == [15.0]
+    assert await decoded_r.json().numincrby("doc1", "$.b[2].a", 2) == [None]
+    assert await decoded_r.json().numincrby("doc1", "$.b[1].a", 3.5) == [15.0]
 
     # Test NUMMULTBY
-    await modclient.json().set(
+    await decoded_r.json().set(
         "doc1", "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]}
     )
 
     # test list
     with pytest.deprecated_call():
-        res = await modclient.json().nummultby("doc1", "$..a", 2)
+        res = await decoded_r.json().nummultby("doc1", "$..a", 2)
         assert res == [None, 4, 10, None]
-        res = await modclient.json().nummultby("doc1", "$..a", 2.5)
+        res = await decoded_r.json().nummultby("doc1", "$..a", 2.5)
         assert res == [None, 10.0, 25.0, None]
 
     # Test single
     with pytest.deprecated_call():
-        assert await modclient.json().nummultby("doc1", "$.b[1].a", 2) == [50.0]
-        assert await modclient.json().nummultby("doc1", "$.b[2].a", 2) == [None]
-        assert await modclient.json().nummultby("doc1", "$.b[1].a", 3) == [150.0]
+        assert await decoded_r.json().nummultby("doc1", "$.b[1].a", 2) == [50.0]
+        assert await decoded_r.json().nummultby("doc1", "$.b[2].a", 2) == [None]
+        assert await decoded_r.json().nummultby("doc1", "$.b[1].a", 3) == [150.0]
 
     # test missing keys
     with pytest.raises(exceptions.ResponseError):
-        await modclient.json().numincrby("non_existing_doc", "$..a", 2)
-        await modclient.json().nummultby("non_existing_doc", "$..a", 2)
+        await decoded_r.json().numincrby("non_existing_doc", "$..a", 2)
+        await decoded_r.json().nummultby("non_existing_doc", "$..a", 2)
 
     # Test legacy NUMINCRBY
-    await modclient.json().set(
+    await decoded_r.json().set(
         "doc1", "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]}
     )
-    await modclient.json().numincrby("doc1", ".b[0].a", 3) == 5
+    await decoded_r.json().numincrby("doc1", ".b[0].a", 3) == 5
 
     # Test legacy NUMMULTBY
-    await modclient.json().set(
+    await decoded_r.json().set(
         "doc1", "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]}
     )
 
     with pytest.deprecated_call():
-        await modclient.json().nummultby("doc1", ".b[0].a", 3) == 6
+        await decoded_r.json().nummultby("doc1", ".b[0].a", 3) == 6
 
 
 @pytest.mark.redismod
-async def test_strappend_dollar(modclient: redis.Redis):
+async def test_strappend_dollar(decoded_r: redis.Redis):
 
-    await modclient.json().set(
+    await decoded_r.json().set(
         "doc1", "$", {"a": "foo", "nested1": {"a": "hello"}, "nested2": {"a": 31}}
     )
     # Test multi
-    await modclient.json().strappend("doc1", "bar", "$..a") == [6, 8, None]
+    await decoded_r.json().strappend("doc1", "bar", "$..a") == [6, 8, None]
+
+    res = [{"a": "foobar", "nested1": {"a": "hellobar"}, "nested2": {"a": 31}}]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
 
-    await modclient.json().get("doc1", "$") == [
-        {"a": "foobar", "nested1": {"a": "hellobar"}, "nested2": {"a": 31}}
-    ]
     # Test single
-    await modclient.json().strappend("doc1", "baz", "$.nested1.a") == [11]
+    await decoded_r.json().strappend("doc1", "baz", "$.nested1.a") == [11]
 
-    await modclient.json().get("doc1", "$") == [
-        {"a": "foobar", "nested1": {"a": "hellobarbaz"}, "nested2": {"a": 31}}
-    ]
+    res = [{"a": "foobar", "nested1": {"a": "hellobarbaz"}, "nested2": {"a": 31}}]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
-        await modclient.json().strappend("non_existing_doc", "$..a", "err")
+        await decoded_r.json().strappend("non_existing_doc", "$..a", "err")
 
     # Test multi
-    await modclient.json().strappend("doc1", "bar", ".*.a") == 8
-    await modclient.json().get("doc1", "$") == [
-        {"a": "foo", "nested1": {"a": "hellobar"}, "nested2": {"a": 31}}
-    ]
+    await decoded_r.json().strappend("doc1", "bar", ".*.a") == 8
+    res = [{"a": "foobar", "nested1": {"a": "hellobarbazbar"}, "nested2": {"a": 31}}]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
 
     # Test missing path
     with pytest.raises(exceptions.ResponseError):
-        await modclient.json().strappend("doc1", "piu")
+        await decoded_r.json().strappend("doc1", "piu")
 
 
 @pytest.mark.redismod
-async def test_strlen_dollar(modclient: redis.Redis):
+async def test_strlen_dollar(decoded_r: redis.Redis):
 
     # Test multi
-    await modclient.json().set(
+    await decoded_r.json().set(
         "doc1", "$", {"a": "foo", "nested1": {"a": "hello"}, "nested2": {"a": 31}}
     )
-    assert await modclient.json().strlen("doc1", "$..a") == [3, 5, None]
+    assert await decoded_r.json().strlen("doc1", "$..a") == [3, 5, None]
 
-    res2 = await modclient.json().strappend("doc1", "bar", "$..a")
-    res1 = await modclient.json().strlen("doc1", "$..a")
+    res2 = await decoded_r.json().strappend("doc1", "bar", "$..a")
+    res1 = await decoded_r.json().strlen("doc1", "$..a")
     assert res1 == res2
 
     # Test single
-    await modclient.json().strlen("doc1", "$.nested1.a") == [8]
-    await modclient.json().strlen("doc1", "$.nested2.a") == [None]
+    await decoded_r.json().strlen("doc1", "$.nested1.a") == [8]
+    await decoded_r.json().strlen("doc1", "$.nested2.a") == [None]
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
-        await modclient.json().strlen("non_existing_doc", "$..a")
+        await decoded_r.json().strlen("non_existing_doc", "$..a")
 
 
 @pytest.mark.redismod
-async def test_arrappend_dollar(modclient: redis.Redis):
-    await modclient.json().set(
+async def test_arrappend_dollar(decoded_r: redis.Redis):
+    await decoded_r.json().set(
         "doc1",
         "$",
         {
@@ -584,31 +609,33 @@ async def test_arrappend_dollar(modclient: redis.Redis):
         },
     )
     # Test multi
-    await modclient.json().arrappend("doc1", "$..a", "bar", "racuda") == [3, 5, None]
-    assert await modclient.json().get("doc1", "$") == [
+    await decoded_r.json().arrappend("doc1", "$..a", "bar", "racuda") == [3, 5, None]
+    res = [
         {
             "a": ["foo", "bar", "racuda"],
             "nested1": {"a": ["hello", None, "world", "bar", "racuda"]},
             "nested2": {"a": 31},
         }
     ]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
 
     # Test single
-    assert await modclient.json().arrappend("doc1", "$.nested1.a", "baz") == [6]
-    assert await modclient.json().get("doc1", "$") == [
+    assert await decoded_r.json().arrappend("doc1", "$.nested1.a", "baz") == [6]
+    res = [
         {
             "a": ["foo", "bar", "racuda"],
             "nested1": {"a": ["hello", None, "world", "bar", "racuda", "baz"]},
             "nested2": {"a": 31},
         }
     ]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
-        await modclient.json().arrappend("non_existing_doc", "$..a")
+        await decoded_r.json().arrappend("non_existing_doc", "$..a")
 
     # Test legacy
-    await modclient.json().set(
+    await decoded_r.json().set(
         "doc1",
         "$",
         {
@@ -618,33 +645,35 @@ async def test_arrappend_dollar(modclient: redis.Redis):
         },
     )
     # Test multi (all paths are updated, but return result of last path)
-    assert await modclient.json().arrappend("doc1", "..a", "bar", "racuda") == 5
+    assert await decoded_r.json().arrappend("doc1", "..a", "bar", "racuda") == 5
 
-    assert await modclient.json().get("doc1", "$") == [
+    res = [
         {
             "a": ["foo", "bar", "racuda"],
             "nested1": {"a": ["hello", None, "world", "bar", "racuda"]},
             "nested2": {"a": 31},
         }
     ]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
     # Test single
-    assert await modclient.json().arrappend("doc1", ".nested1.a", "baz") == 6
-    assert await modclient.json().get("doc1", "$") == [
+    assert await decoded_r.json().arrappend("doc1", ".nested1.a", "baz") == 6
+    res = [
         {
             "a": ["foo", "bar", "racuda"],
             "nested1": {"a": ["hello", None, "world", "bar", "racuda", "baz"]},
             "nested2": {"a": 31},
         }
     ]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
-        await modclient.json().arrappend("non_existing_doc", "$..a")
+        await decoded_r.json().arrappend("non_existing_doc", "$..a")
 
 
 @pytest.mark.redismod
-async def test_arrinsert_dollar(modclient: redis.Redis):
-    await modclient.json().set(
+async def test_arrinsert_dollar(decoded_r: redis.Redis):
+    await decoded_r.json().set(
         "doc1",
         "$",
         {
@@ -654,35 +683,37 @@ async def test_arrinsert_dollar(modclient: redis.Redis):
         },
     )
     # Test multi
-    res = await modclient.json().arrinsert("doc1", "$..a", "1", "bar", "racuda")
+    res = await decoded_r.json().arrinsert("doc1", "$..a", "1", "bar", "racuda")
     assert res == [3, 5, None]
 
-    assert await modclient.json().get("doc1", "$") == [
+    res = [
         {
             "a": ["foo", "bar", "racuda"],
             "nested1": {"a": ["hello", "bar", "racuda", None, "world"]},
             "nested2": {"a": 31},
         }
     ]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
     # Test single
-    assert await modclient.json().arrinsert("doc1", "$.nested1.a", -2, "baz") == [6]
-    assert await modclient.json().get("doc1", "$") == [
+    assert await decoded_r.json().arrinsert("doc1", "$.nested1.a", -2, "baz") == [6]
+    res = [
         {
             "a": ["foo", "bar", "racuda"],
             "nested1": {"a": ["hello", "bar", "racuda", "baz", None, "world"]},
             "nested2": {"a": 31},
         }
     ]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
-        await modclient.json().arrappend("non_existing_doc", "$..a")
+        await decoded_r.json().arrappend("non_existing_doc", "$..a")
 
 
 @pytest.mark.redismod
-async def test_arrlen_dollar(modclient: redis.Redis):
+async def test_arrlen_dollar(decoded_r: redis.Redis):
 
-    await modclient.json().set(
+    await decoded_r.json().set(
         "doc1",
         "$",
         {
@@ -693,20 +724,20 @@ async def test_arrlen_dollar(modclient: redis.Redis):
     )
 
     # Test multi
-    assert await modclient.json().arrlen("doc1", "$..a") == [1, 3, None]
-    res = await modclient.json().arrappend("doc1", "$..a", "non", "abba", "stanza")
+    assert await decoded_r.json().arrlen("doc1", "$..a") == [1, 3, None]
+    res = await decoded_r.json().arrappend("doc1", "$..a", "non", "abba", "stanza")
     assert res == [4, 6, None]
 
-    await modclient.json().clear("doc1", "$.a")
-    assert await modclient.json().arrlen("doc1", "$..a") == [0, 6, None]
+    await decoded_r.json().clear("doc1", "$.a")
+    assert await decoded_r.json().arrlen("doc1", "$..a") == [0, 6, None]
     # Test single
-    assert await modclient.json().arrlen("doc1", "$.nested1.a") == [6]
+    assert await decoded_r.json().arrlen("doc1", "$.nested1.a") == [6]
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
-        await modclient.json().arrappend("non_existing_doc", "$..a")
+        await decoded_r.json().arrappend("non_existing_doc", "$..a")
 
-    await modclient.json().set(
+    await decoded_r.json().set(
         "doc1",
         "$",
         {
@@ -716,19 +747,19 @@ async def test_arrlen_dollar(modclient: redis.Redis):
         },
     )
     # Test multi (return result of last path)
-    assert await modclient.json().arrlen("doc1", "$..a") == [1, 3, None]
-    assert await modclient.json().arrappend("doc1", "..a", "non", "abba", "stanza") == 6
+    assert await decoded_r.json().arrlen("doc1", "$..a") == [1, 3, None]
+    assert await decoded_r.json().arrappend("doc1", "..a", "non", "abba", "stanza") == 6
 
     # Test single
-    assert await modclient.json().arrlen("doc1", ".nested1.a") == 6
+    assert await decoded_r.json().arrlen("doc1", ".nested1.a") == 6
 
     # Test missing key
-    assert await modclient.json().arrlen("non_existing_doc", "..a") is None
+    assert await decoded_r.json().arrlen("non_existing_doc", "..a") is None
 
 
 @pytest.mark.redismod
-async def test_arrpop_dollar(modclient: redis.Redis):
-    await modclient.json().set(
+async def test_arrpop_dollar(decoded_r: redis.Redis):
+    await decoded_r.json().set(
         "doc1",
         "$",
         {
@@ -738,19 +769,18 @@ async def test_arrpop_dollar(modclient: redis.Redis):
         },
     )
 
-    # # # Test multi
-    assert await modclient.json().arrpop("doc1", "$..a", 1) == ['"foo"', None, None]
+    # Test multi
+    assert await decoded_r.json().arrpop("doc1", "$..a", 1) == ['"foo"', None, None]
 
-    assert await modclient.json().get("doc1", "$") == [
-        {"a": [], "nested1": {"a": ["hello", "world"]}, "nested2": {"a": 31}}
-    ]
+    res = [{"a": [], "nested1": {"a": ["hello", "world"]}, "nested2": {"a": 31}}]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
-        await modclient.json().arrpop("non_existing_doc", "..a")
+        await decoded_r.json().arrpop("non_existing_doc", "..a")
 
     # # Test legacy
-    await modclient.json().set(
+    await decoded_r.json().set(
         "doc1",
         "$",
         {
@@ -760,20 +790,19 @@ async def test_arrpop_dollar(modclient: redis.Redis):
         },
     )
     # Test multi (all paths are updated, but return result of last path)
-    await modclient.json().arrpop("doc1", "..a", "1") is None
-    assert await modclient.json().get("doc1", "$") == [
-        {"a": [], "nested1": {"a": ["hello", "world"]}, "nested2": {"a": 31}}
-    ]
+    await decoded_r.json().arrpop("doc1", "..a", "1") is None
+    res = [{"a": [], "nested1": {"a": ["hello", "world"]}, "nested2": {"a": 31}}]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
 
     # # Test missing key
     with pytest.raises(exceptions.ResponseError):
-        await modclient.json().arrpop("non_existing_doc", "..a")
+        await decoded_r.json().arrpop("non_existing_doc", "..a")
 
 
 @pytest.mark.redismod
-async def test_arrtrim_dollar(modclient: redis.Redis):
+async def test_arrtrim_dollar(decoded_r: redis.Redis):
 
-    await modclient.json().set(
+    await decoded_r.json().set(
         "doc1",
         "$",
         {
@@ -783,27 +812,24 @@ async def test_arrtrim_dollar(modclient: redis.Redis):
         },
     )
     # Test multi
-    assert await modclient.json().arrtrim("doc1", "$..a", "1", -1) == [0, 2, None]
-    assert await modclient.json().get("doc1", "$") == [
-        {"a": [], "nested1": {"a": [None, "world"]}, "nested2": {"a": 31}}
-    ]
+    assert await decoded_r.json().arrtrim("doc1", "$..a", "1", -1) == [0, 2, None]
+    res = [{"a": [], "nested1": {"a": [None, "world"]}, "nested2": {"a": 31}}]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
 
-    assert await modclient.json().arrtrim("doc1", "$..a", "1", "1") == [0, 1, None]
-    assert await modclient.json().get("doc1", "$") == [
-        {"a": [], "nested1": {"a": ["world"]}, "nested2": {"a": 31}}
-    ]
+    assert await decoded_r.json().arrtrim("doc1", "$..a", "1", "1") == [0, 1, None]
+    res = [{"a": [], "nested1": {"a": ["world"]}, "nested2": {"a": 31}}]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
     # Test single
-    assert await modclient.json().arrtrim("doc1", "$.nested1.a", 1, 0) == [0]
-    assert await modclient.json().get("doc1", "$") == [
-        {"a": [], "nested1": {"a": []}, "nested2": {"a": 31}}
-    ]
+    assert await decoded_r.json().arrtrim("doc1", "$.nested1.a", 1, 0) == [0]
+    res = [{"a": [], "nested1": {"a": []}, "nested2": {"a": 31}}]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
-        await modclient.json().arrtrim("non_existing_doc", "..a", "0", 1)
+        await decoded_r.json().arrtrim("non_existing_doc", "..a", "0", 1)
 
     # Test legacy
-    await modclient.json().set(
+    await decoded_r.json().set(
         "doc1",
         "$",
         {
@@ -814,22 +840,21 @@ async def test_arrtrim_dollar(modclient: redis.Redis):
     )
 
     # Test multi (all paths are updated, but return result of last path)
-    assert await modclient.json().arrtrim("doc1", "..a", "1", "-1") == 2
+    assert await decoded_r.json().arrtrim("doc1", "..a", "1", "-1") == 2
 
     # Test single
-    assert await modclient.json().arrtrim("doc1", ".nested1.a", "1", "1") == 1
-    assert await modclient.json().get("doc1", "$") == [
-        {"a": [], "nested1": {"a": ["world"]}, "nested2": {"a": 31}}
-    ]
+    assert await decoded_r.json().arrtrim("doc1", ".nested1.a", "1", "1") == 1
+    res = [{"a": [], "nested1": {"a": ["world"]}, "nested2": {"a": 31}}]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
-        await modclient.json().arrtrim("non_existing_doc", "..a", 1, 1)
+        await decoded_r.json().arrtrim("non_existing_doc", "..a", 1, 1)
 
 
 @pytest.mark.redismod
-async def test_objkeys_dollar(modclient: redis.Redis):
-    await modclient.json().set(
+async def test_objkeys_dollar(decoded_r: redis.Redis):
+    await decoded_r.json().set(
         "doc1",
         "$",
         {
@@ -840,26 +865,26 @@ async def test_objkeys_dollar(modclient: redis.Redis):
     )
 
     # Test single
-    assert await modclient.json().objkeys("doc1", "$.nested1.a") == [["foo", "bar"]]
+    assert await decoded_r.json().objkeys("doc1", "$.nested1.a") == [["foo", "bar"]]
 
     # Test legacy
-    assert await modclient.json().objkeys("doc1", ".*.a") == ["foo", "bar"]
+    assert await decoded_r.json().objkeys("doc1", ".*.a") == ["foo", "bar"]
     # Test single
-    assert await modclient.json().objkeys("doc1", ".nested2.a") == ["baz"]
+    assert await decoded_r.json().objkeys("doc1", ".nested2.a") == ["baz"]
 
     # Test missing key
-    assert await modclient.json().objkeys("non_existing_doc", "..a") is None
+    assert await decoded_r.json().objkeys("non_existing_doc", "..a") is None
 
     # Test non existing doc
     with pytest.raises(exceptions.ResponseError):
-        assert await modclient.json().objkeys("non_existing_doc", "$..a") == []
+        assert await decoded_r.json().objkeys("non_existing_doc", "$..a") == []
 
-    assert await modclient.json().objkeys("doc1", "$..nowhere") == []
+    assert await decoded_r.json().objkeys("doc1", "$..nowhere") == []
 
 
 @pytest.mark.redismod
-async def test_objlen_dollar(modclient: redis.Redis):
-    await modclient.json().set(
+async def test_objlen_dollar(decoded_r: redis.Redis):
+    await decoded_r.json().set(
         "doc1",
         "$",
         {
@@ -869,28 +894,28 @@ async def test_objlen_dollar(modclient: redis.Redis):
         },
     )
     # Test multi
-    assert await modclient.json().objlen("doc1", "$..a") == [None, 2, 1]
+    assert await decoded_r.json().objlen("doc1", "$..a") == [None, 2, 1]
     # Test single
-    assert await modclient.json().objlen("doc1", "$.nested1.a") == [2]
+    assert await decoded_r.json().objlen("doc1", "$.nested1.a") == [2]
 
     # Test missing key, and path
     with pytest.raises(exceptions.ResponseError):
-        await modclient.json().objlen("non_existing_doc", "$..a")
+        await decoded_r.json().objlen("non_existing_doc", "$..a")
 
-    assert await modclient.json().objlen("doc1", "$.nowhere") == []
+    assert await decoded_r.json().objlen("doc1", "$.nowhere") == []
 
     # Test legacy
-    assert await modclient.json().objlen("doc1", ".*.a") == 2
+    assert await decoded_r.json().objlen("doc1", ".*.a") == 2
 
     # Test single
-    assert await modclient.json().objlen("doc1", ".nested2.a") == 1
+    assert await decoded_r.json().objlen("doc1", ".nested2.a") == 1
 
     # Test missing key
-    assert await modclient.json().objlen("non_existing_doc", "..a") is None
+    assert await decoded_r.json().objlen("non_existing_doc", "..a") is None
 
     # Test missing path
     # with pytest.raises(exceptions.ResponseError):
-    await modclient.json().objlen("doc1", ".nowhere")
+    await decoded_r.json().objlen("doc1", ".nowhere")
 
 
 @pytest.mark.redismod
@@ -914,23 +939,28 @@ def load_types_data(nested_key_name):
 
 
 @pytest.mark.redismod
-async def test_type_dollar(modclient: redis.Redis):
+async def test_type_dollar(decoded_r: redis.Redis):
     jdata, jtypes = load_types_data("a")
-    await modclient.json().set("doc1", "$", jdata)
+    await decoded_r.json().set("doc1", "$", jdata)
     # Test multi
-    assert await modclient.json().type("doc1", "$..a") == jtypes
+    assert_resp_response(
+        decoded_r, await decoded_r.json().type("doc1", "$..a"), jtypes, [jtypes]
+    )
 
     # Test single
-    assert await modclient.json().type("doc1", "$.nested2.a") == [jtypes[1]]
+    res = await decoded_r.json().type("doc1", "$.nested2.a")
+    assert_resp_response(decoded_r, res, [jtypes[1]], [[jtypes[1]]])
 
     # Test missing key
-    assert await modclient.json().type("non_existing_doc", "..a") is None
+    assert_resp_response(
+        decoded_r, await decoded_r.json().type("non_existing_doc", "..a"), None, [None]
+    )
 
 
 @pytest.mark.redismod
-async def test_clear_dollar(modclient: redis.Redis):
+async def test_clear_dollar(decoded_r: redis.Redis):
 
-    await modclient.json().set(
+    await decoded_r.json().set(
         "doc1",
         "$",
         {
@@ -942,14 +972,15 @@ async def test_clear_dollar(modclient: redis.Redis):
     )
 
     # Test multi
-    assert await modclient.json().clear("doc1", "$..a") == 3
+    assert await decoded_r.json().clear("doc1", "$..a") == 3
 
-    assert await modclient.json().get("doc1", "$") == [
+    res = [
         {"nested1": {"a": {}}, "a": [], "nested2": {"a": "claro"}, "nested3": {"a": {}}}
     ]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
 
     # Test single
-    await modclient.json().set(
+    await decoded_r.json().set(
         "doc1",
         "$",
         {
@@ -959,8 +990,8 @@ async def test_clear_dollar(modclient: redis.Redis):
             "nested3": {"a": {"baz": 50}},
         },
     )
-    assert await modclient.json().clear("doc1", "$.nested1.a") == 1
-    assert await modclient.json().get("doc1", "$") == [
+    assert await decoded_r.json().clear("doc1", "$.nested1.a") == 1
+    res = [
         {
             "nested1": {"a": {}},
             "a": ["foo"],
@@ -968,19 +999,22 @@ async def test_clear_dollar(modclient: redis.Redis):
             "nested3": {"a": {"baz": 50}},
         }
     ]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
 
     # Test missing path (async defaults to root)
-    assert await modclient.json().clear("doc1") == 1
-    assert await modclient.json().get("doc1", "$") == [{}]
+    assert await decoded_r.json().clear("doc1") == 1
+    assert_resp_response(
+        decoded_r, await decoded_r.json().get("doc1", "$"), [{}], [[{}]]
+    )
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
-        await modclient.json().clear("non_existing_doc", "$..a")
+        await decoded_r.json().clear("non_existing_doc", "$..a")
 
 
 @pytest.mark.redismod
-async def test_toggle_dollar(modclient: redis.Redis):
-    await modclient.json().set(
+async def test_toggle_dollar(decoded_r: redis.Redis):
+    await decoded_r.json().set(
         "doc1",
         "$",
         {
@@ -991,8 +1025,8 @@ async def test_toggle_dollar(modclient: redis.Redis):
         },
     )
     # Test multi
-    assert await modclient.json().toggle("doc1", "$..a") == [None, 1, None, 0]
-    assert await modclient.json().get("doc1", "$") == [
+    assert await decoded_r.json().toggle("doc1", "$..a") == [None, 1, None, 0]
+    res = [
         {
             "a": ["foo"],
             "nested1": {"a": True},
@@ -1000,7 +1034,8 @@ async def test_toggle_dollar(modclient: redis.Redis):
             "nested3": {"a": False},
         }
     ]
+    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
-        await modclient.json().toggle("non_existing_doc", "$..a")
+        await decoded_r.json().toggle("non_existing_doc", "$..a")
diff --git a/tests/test_asyncio/test_lock.py b/tests/test_asyncio/test_lock.py
index d78f74164d..75484a2791 100644
--- a/tests/test_asyncio/test_lock.py
+++ b/tests/test_asyncio/test_lock.py
@@ -2,7 +2,6 @@
 
 import pytest
 import pytest_asyncio
-
 from redis.asyncio.lock import Lock
 from redis.exceptions import LockError, LockNotOwnedError
 
diff --git a/tests/test_asyncio/test_monitor.py b/tests/test_asyncio/test_monitor.py
index 3551579ec0..73ee3cf811 100644
--- a/tests/test_asyncio/test_monitor.py
+++ b/tests/test_asyncio/test_monitor.py
@@ -1,5 +1,4 @@
 import pytest
-
 from tests.conftest import skip_if_redis_enterprise, skip_ifnot_redis_enterprise
 
 from .conftest import wait_for_command
diff --git a/tests/test_asyncio/test_pipeline.py b/tests/test_asyncio/test_pipeline.py
index 3df57eb90f..edd2f6d147 100644
--- a/tests/test_asyncio/test_pipeline.py
+++ b/tests/test_asyncio/test_pipeline.py
@@ -1,5 +1,4 @@
 import pytest
-
 import redis
 from tests.conftest import skip_if_server_version_lt
 
@@ -21,7 +20,6 @@ async def test_pipeline(self, r):
                 .zadd("z", {"z1": 1})
                 .zadd("z", {"z2": 4})
                 .zincrby("z", 1, "z1")
-                .zrange("z", 0, 5, withscores=True)
             )
             assert await pipe.execute() == [
                 True,
@@ -29,7 +27,6 @@ async def test_pipeline(self, r):
                 True,
                 True,
                 2.0,
-                [(b"z1", 2.0), (b"z2", 4)],
             ]
 
     async def test_pipeline_memoryview(self, r):
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index ba70782e42..858576584f 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -14,11 +14,11 @@
 
 import pytest
 import pytest_asyncio
-
 import redis.asyncio as redis
 from redis.exceptions import ConnectionError
 from redis.typing import EncodableT
-from tests.conftest import skip_if_server_version_lt
+from redis.utils import HIREDIS_AVAILABLE
+from tests.conftest import get_protocol_version, skip_if_server_version_lt
 
 from .compat import create_task, mock
 
@@ -422,6 +422,24 @@ async def test_get_message_without_subscribe(self, r: redis.Redis, pubsub):
         assert expect in info.exconly()
 
 
+@pytest.mark.onlynoncluster
+class TestPubSubRESP3Handler:
+    def my_handler(self, message):
+        self.message = ["my handler", message]
+
+    @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+    async def test_push_handler(self, r):
+        if get_protocol_version(r) in [2, "2", None]:
+            return
+        p = r.pubsub(push_handler_func=self.my_handler)
+        await p.subscribe("foo")
+        assert await wait_for_message(p) is None
+        assert self.message == ["my handler", [b"subscribe", b"foo", 1]]
+        assert await r.publish("foo", "test message") == 1
+        assert await wait_for_message(p) is None
+        assert self.message == ["my handler", [b"message", b"foo", b"test message"]]
+
+
 @pytest.mark.onlynoncluster
 class TestPubSubAutoDecoding:
     """These tests only validate that we get unicode values back"""
@@ -658,18 +676,15 @@ async def loop():
                 nonlocal interrupt
                 await pubsub.subscribe("foo")
                 while True:
-                    # print("loop")
                     try:
                         try:
                             await pubsub.connect()
                             await loop_step()
-                            # print("succ")
                         except redis.ConnectionError:
                             await asyncio.sleep(0.1)
                     except asyncio.CancelledError:
                         # we use a cancel to interrupt the "listen"
                         # when we perform a disconnect
-                        # print("cancel", interrupt)
                         if interrupt:
                             interrupt = False
                         else:
@@ -902,7 +917,6 @@ async def loop(self):
                 try:
                     if self.state == 4:
                         break
-                    # print("state a ", self.state)
                     got_msg = await self.get_message()
                     assert got_msg
                     if self.state in (1, 2):
@@ -920,7 +934,6 @@ async def loop(self):
     async def loop_step_get_message(self):
         # get a single message via get_message
         message = await self.pubsub.get_message(timeout=0.1)
-        # print(message)
         if message is not None:
             await self.messages.put(message)
             return True
@@ -1000,13 +1013,15 @@ async def get_msg():
         assert msg is not None
         # timeout waiting for another message which never arrives
         assert pubsub.connection.is_connected
-        with patch("redis.asyncio.connection.PythonParser.read_response") as mock1:
+        with patch("redis._parsers._AsyncRESP2Parser.read_response") as mock1, patch(
+            "redis._parsers._AsyncHiredisParser.read_response"
+        ) as mock2, patch("redis._parsers._AsyncRESP3Parser.read_response") as mock3:
             mock1.side_effect = BaseException("boom")
-            with patch("redis.asyncio.connection.HiredisParser.read_response") as mock2:
-                mock2.side_effect = BaseException("boom")
+            mock2.side_effect = BaseException("boom")
+            mock3.side_effect = BaseException("boom")
 
-                with pytest.raises(BaseException):
-                    await get_msg()
+            with pytest.raises(BaseException):
+                await get_msg()
 
         # the timeout on the read should not cause disconnect
         assert pubsub.connection.is_connected
diff --git a/tests/test_asyncio/test_retry.py b/tests/test_asyncio/test_retry.py
index 86e6ddfa0d..2912ca786c 100644
--- a/tests/test_asyncio/test_retry.py
+++ b/tests/test_asyncio/test_retry.py
@@ -1,5 +1,4 @@
 import pytest
-
 from redis.asyncio import Redis
 from redis.asyncio.connection import Connection, UnixDomainSocketConnection
 from redis.asyncio.retry import Retry
diff --git a/tests/test_asyncio/test_scripting.py b/tests/test_asyncio/test_scripting.py
index 3776d12cb7..8375ecd787 100644
--- a/tests/test_asyncio/test_scripting.py
+++ b/tests/test_asyncio/test_scripting.py
@@ -1,6 +1,5 @@
 import pytest
 import pytest_asyncio
-
 from redis import exceptions
 from tests.conftest import skip_if_server_version_lt
 
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 8707cdf61b..149b26d958 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -5,7 +5,6 @@
 from io import TextIOWrapper
 
 import pytest
-
 import redis.asyncio as redis
 import redis.commands.search
 import redis.commands.search.aggregation as aggregations
@@ -16,7 +15,12 @@
 from redis.commands.search.query import GeoFilter, NumericFilter, Query
 from redis.commands.search.result import Result
 from redis.commands.search.suggestion import Suggestion
-from tests.conftest import skip_if_redis_enterprise, skip_ifmodversion_lt
+from tests.conftest import (
+    assert_resp_response,
+    is_resp2_connection,
+    skip_if_redis_enterprise,
+    skip_ifmodversion_lt,
+)
 
 WILL_PLAY_TEXT = os.path.abspath(
     os.path.join(os.path.dirname(__file__), "testdata", "will_play_text.csv.bz2")
@@ -32,12 +36,16 @@ async def waitForIndex(env, idx, timeout=None):
     while True:
         res = await env.execute_command("FT.INFO", idx)
         try:
-            res.index("indexing")
+            if int(res[res.index("indexing") + 1]) == 0:
+                break
         except ValueError:
             break
-
-        if int(res[res.index("indexing") + 1]) == 0:
-            break
+        except AttributeError:
+            try:
+                if int(res["indexing"]) == 0:
+                    break
+            except ValueError:
+                break
 
         time.sleep(delay)
         if timeout is not None:
@@ -46,23 +54,23 @@ async def waitForIndex(env, idx, timeout=None):
                 break
 
 
-def getClient(modclient: redis.Redis):
+def getClient(decoded_r: redis.Redis):
     """
     Gets a client client attached to an index name which is ready to be
     created
     """
-    return modclient
+    return decoded_r
 
 
-async def createIndex(modclient, num_docs=100, definition=None):
+async def createIndex(decoded_r, num_docs=100, definition=None):
     try:
-        await modclient.create_index(
+        await decoded_r.create_index(
             (TextField("play", weight=5.0), TextField("txt"), NumericField("chapter")),
             definition=definition,
         )
     except redis.ResponseError:
-        await modclient.dropindex(delete_documents=True)
-        return createIndex(modclient, num_docs=num_docs, definition=definition)
+        await decoded_r.dropindex(delete_documents=True)
+        return createIndex(decoded_r, num_docs=num_docs, definition=definition)
 
     chapters = {}
     bzfp = TextIOWrapper(bz2.BZ2File(WILL_PLAY_TEXT), encoding="utf8")
@@ -80,7 +88,7 @@ async def createIndex(modclient, num_docs=100, definition=None):
         if len(chapters) == num_docs:
             break
 
-    indexer = modclient.batch_indexer(chunk_size=50)
+    indexer = decoded_r.batch_indexer(chunk_size=50)
     assert isinstance(indexer, AsyncSearch.BatchIndexer)
     assert 50 == indexer.chunk_size
 
@@ -90,12 +98,12 @@ async def createIndex(modclient, num_docs=100, definition=None):
 
 
 @pytest.mark.redismod
-async def test_client(modclient: redis.Redis):
+async def test_client(decoded_r: redis.Redis):
     num_docs = 500
-    await createIndex(modclient.ft(), num_docs=num_docs)
-    await waitForIndex(modclient, "idx")
+    await createIndex(decoded_r.ft(), num_docs=num_docs)
+    await waitForIndex(decoded_r, "idx")
     # verify info
-    info = await modclient.ft().info()
+    info = await decoded_r.ft().info()
     for k in [
         "index_name",
         "index_options",
@@ -115,145 +123,268 @@ async def test_client(modclient: redis.Redis):
     ]:
         assert k in info
 
-    assert modclient.ft().index_name == info["index_name"]
+    assert decoded_r.ft().index_name == info["index_name"]
     assert num_docs == int(info["num_docs"])
 
-    res = await modclient.ft().search("henry iv")
-    assert isinstance(res, Result)
-    assert 225 == res.total
-    assert 10 == len(res.docs)
-    assert res.duration > 0
-
-    for doc in res.docs:
-        assert doc.id
-        assert doc.play == "Henry IV"
+    res = await decoded_r.ft().search("henry iv")
+    if is_resp2_connection(decoded_r):
+        assert isinstance(res, Result)
+        assert 225 == res.total
+        assert 10 == len(res.docs)
+        assert res.duration > 0
+
+        for doc in res.docs:
+            assert doc.id
+            assert doc.play == "Henry IV"
+            assert len(doc.txt) > 0
+
+        # test no content
+        res = await decoded_r.ft().search(Query("king").no_content())
+        assert 194 == res.total
+        assert 10 == len(res.docs)
+        for doc in res.docs:
+            assert "txt" not in doc.__dict__
+            assert "play" not in doc.__dict__
+
+        # test verbatim vs no verbatim
+        total = (await decoded_r.ft().search(Query("kings").no_content())).total
+        vtotal = (
+            await decoded_r.ft().search(Query("kings").no_content().verbatim())
+        ).total
+        assert total > vtotal
+
+        # test in fields
+        txt_total = (
+            await decoded_r.ft().search(Query("henry").no_content().limit_fields("txt"))
+        ).total
+        play_total = (
+            await decoded_r.ft().search(
+                Query("henry").no_content().limit_fields("play")
+            )
+        ).total
+        both_total = (
+            await (
+                decoded_r.ft().search(
+                    Query("henry").no_content().limit_fields("play", "txt")
+                )
+            )
+        ).total
+        assert 129 == txt_total
+        assert 494 == play_total
+        assert 494 == both_total
+
+        # test load_document
+        doc = await decoded_r.ft().load_document("henry vi part 3:62")
+        assert doc is not None
+        assert "henry vi part 3:62" == doc.id
+        assert doc.play == "Henry VI Part 3"
         assert len(doc.txt) > 0
 
-    # test no content
-    res = await modclient.ft().search(Query("king").no_content())
-    assert 194 == res.total
-    assert 10 == len(res.docs)
-    for doc in res.docs:
-        assert "txt" not in doc.__dict__
-        assert "play" not in doc.__dict__
-
-    # test verbatim vs no verbatim
-    total = (await modclient.ft().search(Query("kings").no_content())).total
-    vtotal = (await modclient.ft().search(Query("kings").no_content().verbatim())).total
-    assert total > vtotal
-
-    # test in fields
-    txt_total = (
-        await modclient.ft().search(Query("henry").no_content().limit_fields("txt"))
-    ).total
-    play_total = (
-        await modclient.ft().search(Query("henry").no_content().limit_fields("play"))
-    ).total
-    both_total = (
-        await (
-            modclient.ft().search(
+        # test in-keys
+        ids = [x.id for x in (await decoded_r.ft().search(Query("henry"))).docs]
+        assert 10 == len(ids)
+        subset = ids[:5]
+        docs = await decoded_r.ft().search(Query("henry").limit_ids(*subset))
+        assert len(subset) == docs.total
+        ids = [x.id for x in docs.docs]
+        assert set(ids) == set(subset)
+
+        # test slop and in order
+        assert 193 == (await decoded_r.ft().search(Query("henry king"))).total
+        assert (
+            3
+            == (
+                await decoded_r.ft().search(Query("henry king").slop(0).in_order())
+            ).total
+        )
+        assert (
+            52
+            == (
+                await decoded_r.ft().search(Query("king henry").slop(0).in_order())
+            ).total
+        )
+        assert 53 == (await decoded_r.ft().search(Query("henry king").slop(0))).total
+        assert 167 == (await decoded_r.ft().search(Query("henry king").slop(100))).total
+
+        # test delete document
+        await decoded_r.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
+        res = await decoded_r.ft().search(Query("death of a salesman"))
+        assert 1 == res.total
+
+        assert 1 == await decoded_r.ft().delete_document("doc-5ghs2")
+        res = await decoded_r.ft().search(Query("death of a salesman"))
+        assert 0 == res.total
+        assert 0 == await decoded_r.ft().delete_document("doc-5ghs2")
+
+        await decoded_r.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
+        res = await decoded_r.ft().search(Query("death of a salesman"))
+        assert 1 == res.total
+        await decoded_r.ft().delete_document("doc-5ghs2")
+    else:
+        assert isinstance(res, dict)
+        assert 225 == res["total_results"]
+        assert 10 == len(res["results"])
+
+        for doc in res["results"]:
+            assert doc["id"]
+            assert doc["extra_attributes"]["play"] == "Henry IV"
+            assert len(doc["extra_attributes"]["txt"]) > 0
+
+        # test no content
+        res = await decoded_r.ft().search(Query("king").no_content())
+        assert 194 == res["total_results"]
+        assert 10 == len(res["results"])
+        for doc in res["results"]:
+            assert "extra_attributes" not in doc.keys()
+
+        # test verbatim vs no verbatim
+        total = (await decoded_r.ft().search(Query("kings").no_content()))[
+            "total_results"
+        ]
+        vtotal = (await decoded_r.ft().search(Query("kings").no_content().verbatim()))[
+            "total_results"
+        ]
+        assert total > vtotal
+
+        # test in fields
+        txt_total = (
+            await decoded_r.ft().search(Query("henry").no_content().limit_fields("txt"))
+        )["total_results"]
+        play_total = (
+            await decoded_r.ft().search(
+                Query("henry").no_content().limit_fields("play")
+            )
+        )["total_results"]
+        both_total = (
+            await decoded_r.ft().search(
                 Query("henry").no_content().limit_fields("play", "txt")
             )
+        )["total_results"]
+        assert 129 == txt_total
+        assert 494 == play_total
+        assert 494 == both_total
+
+        # test load_document
+        doc = await decoded_r.ft().load_document("henry vi part 3:62")
+        assert doc is not None
+        assert "henry vi part 3:62" == doc.id
+        assert doc.play == "Henry VI Part 3"
+        assert len(doc.txt) > 0
+
+        # test in-keys
+        ids = [
+            x["id"] for x in (await decoded_r.ft().search(Query("henry")))["results"]
+        ]
+        assert 10 == len(ids)
+        subset = ids[:5]
+        docs = await decoded_r.ft().search(Query("henry").limit_ids(*subset))
+        assert len(subset) == docs["total_results"]
+        ids = [x["id"] for x in docs["results"]]
+        assert set(ids) == set(subset)
+
+        # test slop and in order
+        assert (
+            193 == (await decoded_r.ft().search(Query("henry king")))["total_results"]
+        )
+        assert (
+            3
+            == (await decoded_r.ft().search(Query("henry king").slop(0).in_order()))[
+                "total_results"
+            ]
+        )
+        assert (
+            52
+            == (await decoded_r.ft().search(Query("king henry").slop(0).in_order()))[
+                "total_results"
+            ]
+        )
+        assert (
+            53
+            == (await decoded_r.ft().search(Query("henry king").slop(0)))[
+                "total_results"
+            ]
+        )
+        assert (
+            167
+            == (await decoded_r.ft().search(Query("henry king").slop(100)))[
+                "total_results"
+            ]
         )
-    ).total
-    assert 129 == txt_total
-    assert 494 == play_total
-    assert 494 == both_total
-
-    # test load_document
-    doc = await modclient.ft().load_document("henry vi part 3:62")
-    assert doc is not None
-    assert "henry vi part 3:62" == doc.id
-    assert doc.play == "Henry VI Part 3"
-    assert len(doc.txt) > 0
-
-    # test in-keys
-    ids = [x.id for x in (await modclient.ft().search(Query("henry"))).docs]
-    assert 10 == len(ids)
-    subset = ids[:5]
-    docs = await modclient.ft().search(Query("henry").limit_ids(*subset))
-    assert len(subset) == docs.total
-    ids = [x.id for x in docs.docs]
-    assert set(ids) == set(subset)
-
-    # test slop and in order
-    assert 193 == (await modclient.ft().search(Query("henry king"))).total
-    assert (
-        3 == (await modclient.ft().search(Query("henry king").slop(0).in_order())).total
-    )
-    assert (
-        52
-        == (await modclient.ft().search(Query("king henry").slop(0).in_order())).total
-    )
-    assert 53 == (await modclient.ft().search(Query("henry king").slop(0))).total
-    assert 167 == (await modclient.ft().search(Query("henry king").slop(100))).total
 
-    # test delete document
-    await modclient.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
-    res = await modclient.ft().search(Query("death of a salesman"))
-    assert 1 == res.total
+        # test delete document
+        await decoded_r.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
+        res = await decoded_r.ft().search(Query("death of a salesman"))
+        assert 1 == res["total_results"]
 
-    assert 1 == await modclient.ft().delete_document("doc-5ghs2")
-    res = await modclient.ft().search(Query("death of a salesman"))
-    assert 0 == res.total
-    assert 0 == await modclient.ft().delete_document("doc-5ghs2")
+        assert 1 == await decoded_r.ft().delete_document("doc-5ghs2")
+        res = await decoded_r.ft().search(Query("death of a salesman"))
+        assert 0 == res["total_results"]
+        assert 0 == await decoded_r.ft().delete_document("doc-5ghs2")
 
-    await modclient.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
-    res = await modclient.ft().search(Query("death of a salesman"))
-    assert 1 == res.total
-    await modclient.ft().delete_document("doc-5ghs2")
+        await decoded_r.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
+        res = await decoded_r.ft().search(Query("death of a salesman"))
+        assert 1 == res["total_results"]
+        await decoded_r.ft().delete_document("doc-5ghs2")
 
 
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
-async def test_scores(modclient: redis.Redis):
-    await modclient.ft().create_index((TextField("txt"),))
+async def test_scores(decoded_r: redis.Redis):
+    await decoded_r.ft().create_index((TextField("txt"),))
 
-    await modclient.hset("doc1", mapping={"txt": "foo baz"})
-    await modclient.hset("doc2", mapping={"txt": "foo bar"})
+    await decoded_r.hset("doc1", mapping={"txt": "foo baz"})
+    await decoded_r.hset("doc2", mapping={"txt": "foo bar"})
 
     q = Query("foo ~bar").with_scores()
-    res = await modclient.ft().search(q)
-    assert 2 == res.total
-    assert "doc2" == res.docs[0].id
-    assert 3.0 == res.docs[0].score
-    assert "doc1" == res.docs[1].id
-    # todo: enable once new RS version is tagged
-    # self.assertEqual(0.2, res.docs[1].score)
+    res = await decoded_r.ft().search(q)
+    if is_resp2_connection(decoded_r):
+        assert 2 == res.total
+        assert "doc2" == res.docs[0].id
+        assert 3.0 == res.docs[0].score
+        assert "doc1" == res.docs[1].id
+    else:
+        assert 2 == res["total_results"]
+        assert "doc2" == res["results"][0]["id"]
+        assert 3.0 == res["results"][0]["score"]
+        assert "doc1" == res["results"][1]["id"]
 
 
 @pytest.mark.redismod
-async def test_stopwords(modclient: redis.Redis):
+async def test_stopwords(decoded_r: redis.Redis):
     stopwords = ["foo", "bar", "baz"]
-    await modclient.ft().create_index((TextField("txt"),), stopwords=stopwords)
-    await modclient.hset("doc1", mapping={"txt": "foo bar"})
-    await modclient.hset("doc2", mapping={"txt": "hello world"})
-    await waitForIndex(modclient, "idx")
+    await decoded_r.ft().create_index((TextField("txt"),), stopwords=stopwords)
+    await decoded_r.hset("doc1", mapping={"txt": "foo bar"})
+    await decoded_r.hset("doc2", mapping={"txt": "hello world"})
+    await waitForIndex(decoded_r, "idx")
 
     q1 = Query("foo bar").no_content()
     q2 = Query("foo bar hello world").no_content()
-    res1, res2 = await modclient.ft().search(q1), await modclient.ft().search(q2)
-    assert 0 == res1.total
-    assert 1 == res2.total
+    res1, res2 = await decoded_r.ft().search(q1), await decoded_r.ft().search(q2)
+    if is_resp2_connection(decoded_r):
+        assert 0 == res1.total
+        assert 1 == res2.total
+    else:
+        assert 0 == res1["total_results"]
+        assert 1 == res2["total_results"]
 
 
 @pytest.mark.redismod
-async def test_filters(modclient: redis.Redis):
+async def test_filters(decoded_r: redis.Redis):
     await (
-        modclient.ft().create_index(
+        decoded_r.ft().create_index(
             (TextField("txt"), NumericField("num"), GeoField("loc"))
         )
     )
     await (
-        modclient.hset(
+        decoded_r.hset(
             "doc1", mapping={"txt": "foo bar", "num": 3.141, "loc": "-0.441,51.458"}
         )
     )
     await (
-        modclient.hset("doc2", mapping={"txt": "foo baz", "num": 2, "loc": "-0.1,51.2"})
+        decoded_r.hset("doc2", mapping={"txt": "foo baz", "num": 2, "loc": "-0.1,51.2"})
     )
 
-    await waitForIndex(modclient, "idx")
+    await waitForIndex(decoded_r, "idx")
     # Test numerical filter
     q1 = Query("foo").add_filter(NumericFilter("num", 0, 2)).no_content()
     q2 = (
@@ -261,64 +392,90 @@ async def test_filters(modclient: redis.Redis):
         .add_filter(NumericFilter("num", 2, NumericFilter.INF, minExclusive=True))
         .no_content()
     )
-    res1, res2 = await modclient.ft().search(q1), await modclient.ft().search(q2)
-
-    assert 1 == res1.total
-    assert 1 == res2.total
-    assert "doc2" == res1.docs[0].id
-    assert "doc1" == res2.docs[0].id
+    res1, res2 = await decoded_r.ft().search(q1), await decoded_r.ft().search(q2)
+
+    if is_resp2_connection(decoded_r):
+        assert 1 == res1.total
+        assert 1 == res2.total
+        assert "doc2" == res1.docs[0].id
+        assert "doc1" == res2.docs[0].id
+    else:
+        assert 1 == res1["total_results"]
+        assert 1 == res2["total_results"]
+        assert "doc2" == res1["results"][0]["id"]
+        assert "doc1" == res2["results"][0]["id"]
 
     # Test geo filter
     q1 = Query("foo").add_filter(GeoFilter("loc", -0.44, 51.45, 10)).no_content()
     q2 = Query("foo").add_filter(GeoFilter("loc", -0.44, 51.45, 100)).no_content()
-    res1, res2 = await modclient.ft().search(q1), await modclient.ft().search(q2)
+    res1, res2 = await decoded_r.ft().search(q1), await decoded_r.ft().search(q2)
+
+    if is_resp2_connection(decoded_r):
+        assert 1 == res1.total
+        assert 2 == res2.total
+        assert "doc1" == res1.docs[0].id
 
-    assert 1 == res1.total
-    assert 2 == res2.total
-    assert "doc1" == res1.docs[0].id
+        # Sort results, after RDB reload order may change
+        res = [res2.docs[0].id, res2.docs[1].id]
+        res.sort()
+        assert ["doc1", "doc2"] == res
+    else:
+        assert 1 == res1["total_results"]
+        assert 2 == res2["total_results"]
+        assert "doc1" == res1["results"][0]["id"]
 
-    # Sort results, after RDB reload order may change
-    res = [res2.docs[0].id, res2.docs[1].id]
-    res.sort()
-    assert ["doc1", "doc2"] == res
+        # Sort results, after RDB reload order may change
+        res = [res2["results"][0]["id"], res2["results"][1]["id"]]
+        res.sort()
+        assert ["doc1", "doc2"] == res
 
 
 @pytest.mark.redismod
-async def test_sort_by(modclient: redis.Redis):
+async def test_sort_by(decoded_r: redis.Redis):
     await (
-        modclient.ft().create_index(
+        decoded_r.ft().create_index(
             (TextField("txt"), NumericField("num", sortable=True))
         )
     )
-    await modclient.hset("doc1", mapping={"txt": "foo bar", "num": 1})
-    await modclient.hset("doc2", mapping={"txt": "foo baz", "num": 2})
-    await modclient.hset("doc3", mapping={"txt": "foo qux", "num": 3})
+    await decoded_r.hset("doc1", mapping={"txt": "foo bar", "num": 1})
+    await decoded_r.hset("doc2", mapping={"txt": "foo baz", "num": 2})
+    await decoded_r.hset("doc3", mapping={"txt": "foo qux", "num": 3})
 
     # Test sort
     q1 = Query("foo").sort_by("num", asc=True).no_content()
     q2 = Query("foo").sort_by("num", asc=False).no_content()
-    res1, res2 = await modclient.ft().search(q1), await modclient.ft().search(q2)
-
-    assert 3 == res1.total
-    assert "doc1" == res1.docs[0].id
-    assert "doc2" == res1.docs[1].id
-    assert "doc3" == res1.docs[2].id
-    assert 3 == res2.total
-    assert "doc1" == res2.docs[2].id
-    assert "doc2" == res2.docs[1].id
-    assert "doc3" == res2.docs[0].id
+    res1, res2 = await decoded_r.ft().search(q1), await decoded_r.ft().search(q2)
+
+    if is_resp2_connection(decoded_r):
+        assert 3 == res1.total
+        assert "doc1" == res1.docs[0].id
+        assert "doc2" == res1.docs[1].id
+        assert "doc3" == res1.docs[2].id
+        assert 3 == res2.total
+        assert "doc1" == res2.docs[2].id
+        assert "doc2" == res2.docs[1].id
+        assert "doc3" == res2.docs[0].id
+    else:
+        assert 3 == res1["total_results"]
+        assert "doc1" == res1["results"][0]["id"]
+        assert "doc2" == res1["results"][1]["id"]
+        assert "doc3" == res1["results"][2]["id"]
+        assert 3 == res2["total_results"]
+        assert "doc1" == res2["results"][2]["id"]
+        assert "doc2" == res2["results"][1]["id"]
+        assert "doc3" == res2["results"][0]["id"]
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("2.0.0", "search")
-async def test_drop_index(modclient: redis.Redis):
+async def test_drop_index(decoded_r: redis.Redis):
     """
     Ensure the index gets dropped by data remains by default
     """
     for x in range(20):
         for keep_docs in [[True, {}], [False, {"name": "haveit"}]]:
             idx = "HaveIt"
-            index = getClient(modclient)
+            index = getClient(decoded_r)
             await index.hset("index:haveit", mapping={"name": "haveit"})
             idef = IndexDefinition(prefix=["index:"])
             await index.ft(idx).create_index((TextField("name"),), definition=idef)
@@ -329,14 +486,14 @@ async def test_drop_index(modclient: redis.Redis):
 
 
 @pytest.mark.redismod
-async def test_example(modclient: redis.Redis):
+async def test_example(decoded_r: redis.Redis):
     # Creating the index definition and schema
     await (
-        modclient.ft().create_index((TextField("title", weight=5.0), TextField("body")))
+        decoded_r.ft().create_index((TextField("title", weight=5.0), TextField("body")))
     )
 
     # Indexing a document
-    await modclient.hset(
+    await decoded_r.hset(
         "doc1",
         mapping={
             "title": "RediSearch",
@@ -347,12 +504,12 @@ async def test_example(modclient: redis.Redis):
     # Searching with complex parameters:
     q = Query("search engine").verbatim().no_content().paging(0, 5)
 
-    res = await modclient.ft().search(q)
+    res = await decoded_r.ft().search(q)
     assert res is not None
 
 
 @pytest.mark.redismod
-async def test_auto_complete(modclient: redis.Redis):
+async def test_auto_complete(decoded_r: redis.Redis):
     n = 0
     with open(TITLES_CSV) as f:
         cr = csv.reader(f)
@@ -360,10 +517,10 @@ async def test_auto_complete(modclient: redis.Redis):
         for row in cr:
             n += 1
             term, score = row[0], float(row[1])
-            assert n == await modclient.ft().sugadd("ac", Suggestion(term, score=score))
+            assert n == await decoded_r.ft().sugadd("ac", Suggestion(term, score=score))
 
-    assert n == await modclient.ft().suglen("ac")
-    ret = await modclient.ft().sugget("ac", "bad", with_scores=True)
+    assert n == await decoded_r.ft().suglen("ac")
+    ret = await decoded_r.ft().sugget("ac", "bad", with_scores=True)
     assert 2 == len(ret)
     assert "badger" == ret[0].string
     assert isinstance(ret[0].score, float)
@@ -372,29 +529,29 @@ async def test_auto_complete(modclient: redis.Redis):
     assert isinstance(ret[1].score, float)
     assert 1.0 != ret[1].score
 
-    ret = await modclient.ft().sugget("ac", "bad", fuzzy=True, num=10)
+    ret = await decoded_r.ft().sugget("ac", "bad", fuzzy=True, num=10)
     assert 10 == len(ret)
     assert 1.0 == ret[0].score
     strs = {x.string for x in ret}
 
     for sug in strs:
-        assert 1 == await modclient.ft().sugdel("ac", sug)
+        assert 1 == await decoded_r.ft().sugdel("ac", sug)
     # make sure a second delete returns 0
     for sug in strs:
-        assert 0 == await modclient.ft().sugdel("ac", sug)
+        assert 0 == await decoded_r.ft().sugdel("ac", sug)
 
     # make sure they were actually deleted
-    ret2 = await modclient.ft().sugget("ac", "bad", fuzzy=True, num=10)
+    ret2 = await decoded_r.ft().sugget("ac", "bad", fuzzy=True, num=10)
     for sug in ret2:
         assert sug.string not in strs
 
     # Test with payload
-    await modclient.ft().sugadd("ac", Suggestion("pay1", payload="pl1"))
-    await modclient.ft().sugadd("ac", Suggestion("pay2", payload="pl2"))
-    await modclient.ft().sugadd("ac", Suggestion("pay3", payload="pl3"))
+    await decoded_r.ft().sugadd("ac", Suggestion("pay1", payload="pl1"))
+    await decoded_r.ft().sugadd("ac", Suggestion("pay2", payload="pl2"))
+    await decoded_r.ft().sugadd("ac", Suggestion("pay3", payload="pl3"))
 
     sugs = await (
-        modclient.ft().sugget("ac", "pay", with_payloads=True, with_scores=True)
+        decoded_r.ft().sugget("ac", "pay", with_payloads=True, with_scores=True)
     )
     assert 3 == len(sugs)
     for sug in sugs:
@@ -403,8 +560,8 @@ async def test_auto_complete(modclient: redis.Redis):
 
 
 @pytest.mark.redismod
-async def test_no_index(modclient: redis.Redis):
-    await modclient.ft().create_index(
+async def test_no_index(decoded_r: redis.Redis):
+    await decoded_r.ft().create_index(
         (
             TextField("field"),
             TextField("text", no_index=True, sortable=True),
@@ -414,37 +571,60 @@ async def test_no_index(modclient: redis.Redis):
         )
     )
 
-    await modclient.hset(
+    await decoded_r.hset(
         "doc1",
         mapping={"field": "aaa", "text": "1", "numeric": "1", "geo": "1,1", "tag": "1"},
     )
-    await modclient.hset(
+    await decoded_r.hset(
         "doc2",
         mapping={"field": "aab", "text": "2", "numeric": "2", "geo": "2,2", "tag": "2"},
     )
-    await waitForIndex(modclient, "idx")
+    await waitForIndex(decoded_r, "idx")
+
+    if is_resp2_connection(decoded_r):
+        res = await decoded_r.ft().search(Query("@text:aa*"))
+        assert 0 == res.total
 
-    res = await modclient.ft().search(Query("@text:aa*"))
-    assert 0 == res.total
+        res = await decoded_r.ft().search(Query("@field:aa*"))
+        assert 2 == res.total
 
-    res = await modclient.ft().search(Query("@field:aa*"))
-    assert 2 == res.total
+        res = await decoded_r.ft().search(Query("*").sort_by("text", asc=False))
+        assert 2 == res.total
+        assert "doc2" == res.docs[0].id
 
-    res = await modclient.ft().search(Query("*").sort_by("text", asc=False))
-    assert 2 == res.total
-    assert "doc2" == res.docs[0].id
+        res = await decoded_r.ft().search(Query("*").sort_by("text", asc=True))
+        assert "doc1" == res.docs[0].id
 
-    res = await modclient.ft().search(Query("*").sort_by("text", asc=True))
-    assert "doc1" == res.docs[0].id
+        res = await decoded_r.ft().search(Query("*").sort_by("numeric", asc=True))
+        assert "doc1" == res.docs[0].id
 
-    res = await modclient.ft().search(Query("*").sort_by("numeric", asc=True))
-    assert "doc1" == res.docs[0].id
+        res = await decoded_r.ft().search(Query("*").sort_by("geo", asc=True))
+        assert "doc1" == res.docs[0].id
 
-    res = await modclient.ft().search(Query("*").sort_by("geo", asc=True))
-    assert "doc1" == res.docs[0].id
+        res = await decoded_r.ft().search(Query("*").sort_by("tag", asc=True))
+        assert "doc1" == res.docs[0].id
+    else:
+        res = await decoded_r.ft().search(Query("@text:aa*"))
+        assert 0 == res["total_results"]
 
-    res = await modclient.ft().search(Query("*").sort_by("tag", asc=True))
-    assert "doc1" == res.docs[0].id
+        res = await decoded_r.ft().search(Query("@field:aa*"))
+        assert 2 == res["total_results"]
+
+        res = await decoded_r.ft().search(Query("*").sort_by("text", asc=False))
+        assert 2 == res["total_results"]
+        assert "doc2" == res["results"][0]["id"]
+
+        res = await decoded_r.ft().search(Query("*").sort_by("text", asc=True))
+        assert "doc1" == res["results"][0]["id"]
+
+        res = await decoded_r.ft().search(Query("*").sort_by("numeric", asc=True))
+        assert "doc1" == res["results"][0]["id"]
+
+        res = await decoded_r.ft().search(Query("*").sort_by("geo", asc=True))
+        assert "doc1" == res["results"][0]["id"]
+
+        res = await decoded_r.ft().search(Query("*").sort_by("tag", asc=True))
+        assert "doc1" == res["results"][0]["id"]
 
     # Ensure exception is raised for non-indexable, non-sortable fields
     with pytest.raises(Exception):
@@ -458,51 +638,68 @@ async def test_no_index(modclient: redis.Redis):
 
 
 @pytest.mark.redismod
-async def test_explain(modclient: redis.Redis):
+async def test_explain(decoded_r: redis.Redis):
     await (
-        modclient.ft().create_index((TextField("f1"), TextField("f2"), TextField("f3")))
+        decoded_r.ft().create_index((TextField("f1"), TextField("f2"), TextField("f3")))
     )
-    res = await modclient.ft().explain("@f3:f3_val @f2:f2_val @f1:f1_val")
+    res = await decoded_r.ft().explain("@f3:f3_val @f2:f2_val @f1:f1_val")
     assert res
 
 
 @pytest.mark.redismod
-async def test_explaincli(modclient: redis.Redis):
+async def test_explaincli(decoded_r: redis.Redis):
     with pytest.raises(NotImplementedError):
-        await modclient.ft().explain_cli("foo")
+        await decoded_r.ft().explain_cli("foo")
 
 
 @pytest.mark.redismod
-async def test_summarize(modclient: redis.Redis):
-    await createIndex(modclient.ft())
-    await waitForIndex(modclient, "idx")
+async def test_summarize(decoded_r: redis.Redis):
+    await createIndex(decoded_r.ft())
+    await waitForIndex(decoded_r, "idx")
 
     q = Query("king henry").paging(0, 1)
     q.highlight(fields=("play", "txt"), tags=("<b>", "</b>"))
     q.summarize("txt")
 
-    doc = sorted((await modclient.ft().search(q)).docs)[0]
-    assert "<b>Henry</b> IV" == doc.play
-    assert (
-        "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
-        == doc.txt
-    )
+    if is_resp2_connection(decoded_r):
+        doc = sorted((await decoded_r.ft().search(q)).docs)[0]
+        assert "<b>Henry</b> IV" == doc.play
+        assert (
+            "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+            == doc.txt
+        )
 
-    q = Query("king henry").paging(0, 1).summarize().highlight()
+        q = Query("king henry").paging(0, 1).summarize().highlight()
 
-    doc = sorted((await modclient.ft().search(q)).docs)[0]
-    assert "<b>Henry</b> ... " == doc.play
-    assert (
-        "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
-        == doc.txt
-    )
+        doc = sorted((await decoded_r.ft().search(q)).docs)[0]
+        assert "<b>Henry</b> ... " == doc.play
+        assert (
+            "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+            == doc.txt
+        )
+    else:
+        doc = sorted((await decoded_r.ft().search(q))["results"])[0]
+        assert "<b>Henry</b> IV" == doc["extra_attributes"]["play"]
+        assert (
+            "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+            == doc["extra_attributes"]["txt"]
+        )
+
+        q = Query("king henry").paging(0, 1).summarize().highlight()
+
+        doc = sorted((await decoded_r.ft().search(q))["results"])[0]
+        assert "<b>Henry</b> ... " == doc["extra_attributes"]["play"]
+        assert (
+            "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+            == doc["extra_attributes"]["txt"]
+        )
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("2.0.0", "search")
-async def test_alias(modclient: redis.Redis):
-    index1 = getClient(modclient)
-    index2 = getClient(modclient)
+async def test_alias(decoded_r: redis.Redis):
+    index1 = getClient(decoded_r)
+    index2 = getClient(decoded_r)
 
     def1 = IndexDefinition(prefix=["index1:"])
     def2 = IndexDefinition(prefix=["index2:"])
@@ -515,25 +712,46 @@ async def test_alias(modclient: redis.Redis):
     await index1.hset("index1:lonestar", mapping={"name": "lonestar"})
     await index2.hset("index2:yogurt", mapping={"name": "yogurt"})
 
-    res = (await ftindex1.search("*")).docs[0]
-    assert "index1:lonestar" == res.id
+    if is_resp2_connection(decoded_r):
+        res = (await ftindex1.search("*")).docs[0]
+        assert "index1:lonestar" == res.id
 
-    # create alias and check for results
-    await ftindex1.aliasadd("spaceballs")
-    alias_client = getClient(modclient).ft("spaceballs")
-    res = (await alias_client.search("*")).docs[0]
-    assert "index1:lonestar" == res.id
+        # create alias and check for results
+        await ftindex1.aliasadd("spaceballs")
+        alias_client = getClient(decoded_r).ft("spaceballs")
+        res = (await alias_client.search("*")).docs[0]
+        assert "index1:lonestar" == res.id
 
-    # Throw an exception when trying to add an alias that already exists
-    with pytest.raises(Exception):
-        await ftindex2.aliasadd("spaceballs")
+        # Throw an exception when trying to add an alias that already exists
+        with pytest.raises(Exception):
+            await ftindex2.aliasadd("spaceballs")
+
+        # update alias and ensure new results
+        await ftindex2.aliasupdate("spaceballs")
+        alias_client2 = getClient(decoded_r).ft("spaceballs")
+
+        res = (await alias_client2.search("*")).docs[0]
+        assert "index2:yogurt" == res.id
+    else:
+        res = (await ftindex1.search("*"))["results"][0]
+        assert "index1:lonestar" == res["id"]
 
-    # update alias and ensure new results
-    await ftindex2.aliasupdate("spaceballs")
-    alias_client2 = getClient(modclient).ft("spaceballs")
+        # create alias and check for results
+        await ftindex1.aliasadd("spaceballs")
+        alias_client = getClient(await decoded_r).ft("spaceballs")
+        res = (await alias_client.search("*"))["results"][0]
+        assert "index1:lonestar" == res["id"]
 
-    res = (await alias_client2.search("*")).docs[0]
-    assert "index2:yogurt" == res.id
+        # Throw an exception when trying to add an alias that already exists
+        with pytest.raises(Exception):
+            await ftindex2.aliasadd("spaceballs")
+
+        # update alias and ensure new results
+        await ftindex2.aliasupdate("spaceballs")
+        alias_client2 = getClient(await decoded_r).ft("spaceballs")
+
+        res = (await alias_client2.search("*"))["results"][0]
+        assert "index2:yogurt" == res["id"]
 
     await ftindex2.aliasdel("spaceballs")
     with pytest.raises(Exception):
@@ -541,34 +759,51 @@ async def test_alias(modclient: redis.Redis):
 
 
 @pytest.mark.redismod
-async def test_alias_basic(modclient: redis.Redis):
+@pytest.mark.xfail(strict=False)
+async def test_alias_basic(decoded_r: redis.Redis):
     # Creating a client with one index
-    client = getClient(modclient)
+    client = getClient(decoded_r)
     await client.flushdb()
-    index1 = getClient(modclient).ft("testAlias")
+    index1 = getClient(decoded_r).ft("testAlias")
 
     await index1.create_index((TextField("txt"),))
     await index1.client.hset("doc1", mapping={"txt": "text goes here"})
 
-    index2 = getClient(modclient).ft("testAlias2")
+    index2 = getClient(decoded_r).ft("testAlias2")
     await index2.create_index((TextField("txt"),))
     await index2.client.hset("doc2", mapping={"txt": "text goes here"})
 
     # add the actual alias and check
     await index1.aliasadd("myalias")
-    alias_client = getClient(modclient).ft("myalias")
-    res = sorted((await alias_client.search("*")).docs, key=lambda x: x.id)
-    assert "doc1" == res[0].id
-
-    # Throw an exception when trying to add an alias that already exists
-    with pytest.raises(Exception):
-        await index2.aliasadd("myalias")
-
-    # update the alias and ensure we get doc2
-    await index2.aliasupdate("myalias")
-    alias_client2 = getClient(modclient).ft("myalias")
-    res = sorted((await alias_client2.search("*")).docs, key=lambda x: x.id)
-    assert "doc1" == res[0].id
+    alias_client = getClient(decoded_r).ft("myalias")
+    if is_resp2_connection(decoded_r):
+        res = sorted((await alias_client.search("*")).docs, key=lambda x: x.id)
+        assert "doc1" == res[0].id
+
+        # Throw an exception when trying to add an alias that already exists
+        with pytest.raises(Exception):
+            await index2.aliasadd("myalias")
+
+        # update the alias and ensure we get doc2
+        await index2.aliasupdate("myalias")
+        alias_client2 = getClient(decoded_r).ft("myalias")
+        res = sorted((await alias_client2.search("*")).docs, key=lambda x: x.id)
+        assert "doc1" == res[0].id
+    else:
+        res = sorted((await alias_client.search("*"))["results"], key=lambda x: x["id"])
+        assert "doc1" == res[0]["id"]
+
+        # Throw an exception when trying to add an alias that already exists
+        with pytest.raises(Exception):
+            await index2.aliasadd("myalias")
+
+        # update the alias and ensure we get doc2
+        await index2.aliasupdate("myalias")
+        alias_client2 = getClient(client).ft("myalias")
+        res = sorted(
+            (await alias_client2.search("*"))["results"], key=lambda x: x["id"]
+        )
+        assert "doc1" == res[0]["id"]
 
     # delete the alias and expect an error if we try to query again
     await index2.aliasdel("myalias")
@@ -577,56 +812,79 @@ async def test_alias_basic(modclient: redis.Redis):
 
 
 @pytest.mark.redismod
-async def test_tags(modclient: redis.Redis):
-    await modclient.ft().create_index((TextField("txt"), TagField("tags")))
+async def test_tags(decoded_r: redis.Redis):
+    await decoded_r.ft().create_index((TextField("txt"), TagField("tags")))
     tags = "foo,foo bar,hello;world"
     tags2 = "soba,ramen"
 
-    await modclient.hset("doc1", mapping={"txt": "fooz barz", "tags": tags})
-    await modclient.hset("doc2", mapping={"txt": "noodles", "tags": tags2})
-    await waitForIndex(modclient, "idx")
+    await decoded_r.hset("doc1", mapping={"txt": "fooz barz", "tags": tags})
+    await decoded_r.hset("doc2", mapping={"txt": "noodles", "tags": tags2})
+    await waitForIndex(decoded_r, "idx")
 
     q = Query("@tags:{foo}")
-    res = await modclient.ft().search(q)
-    assert 1 == res.total
+    if is_resp2_connection(decoded_r):
+        res = await decoded_r.ft().search(q)
+        assert 1 == res.total
+
+        q = Query("@tags:{foo bar}")
+        res = await decoded_r.ft().search(q)
+        assert 1 == res.total
+
+        q = Query("@tags:{foo\\ bar}")
+        res = await decoded_r.ft().search(q)
+        assert 1 == res.total
 
-    q = Query("@tags:{foo bar}")
-    res = await modclient.ft().search(q)
-    assert 1 == res.total
+        q = Query("@tags:{hello\\;world}")
+        res = await decoded_r.ft().search(q)
+        assert 1 == res.total
 
-    q = Query("@tags:{foo\\ bar}")
-    res = await modclient.ft().search(q)
-    assert 1 == res.total
+        q2 = await decoded_r.ft().tagvals("tags")
+        assert (tags.split(",") + tags2.split(",")).sort() == q2.sort()
+    else:
+        res = await decoded_r.ft().search(q)
+        assert 1 == res["total_results"]
 
-    q = Query("@tags:{hello\\;world}")
-    res = await modclient.ft().search(q)
-    assert 1 == res.total
+        q = Query("@tags:{foo bar}")
+        res = await decoded_r.ft().search(q)
+        assert 1 == res["total_results"]
 
-    q2 = await modclient.ft().tagvals("tags")
-    assert (tags.split(",") + tags2.split(",")).sort() == q2.sort()
+        q = Query("@tags:{foo\\ bar}")
+        res = await decoded_r.ft().search(q)
+        assert 1 == res["total_results"]
+
+        q = Query("@tags:{hello\\;world}")
+        res = await decoded_r.ft().search(q)
+        assert 1 == res["total_results"]
+
+        q2 = await decoded_r.ft().tagvals("tags")
+        assert set(tags.split(",") + tags2.split(",")) == q2
 
 
 @pytest.mark.redismod
-async def test_textfield_sortable_nostem(modclient: redis.Redis):
+async def test_textfield_sortable_nostem(decoded_r: redis.Redis):
     # Creating the index definition with sortable and no_stem
-    await modclient.ft().create_index((TextField("txt", sortable=True, no_stem=True),))
+    await decoded_r.ft().create_index((TextField("txt", sortable=True, no_stem=True),))
 
     # Now get the index info to confirm its contents
-    response = await modclient.ft().info()
-    assert "SORTABLE" in response["attributes"][0]
-    assert "NOSTEM" in response["attributes"][0]
+    response = await decoded_r.ft().info()
+    if is_resp2_connection(decoded_r):
+        assert "SORTABLE" in response["attributes"][0]
+        assert "NOSTEM" in response["attributes"][0]
+    else:
+        assert "SORTABLE" in response["attributes"][0]["flags"]
+        assert "NOSTEM" in response["attributes"][0]["flags"]
 
 
 @pytest.mark.redismod
-async def test_alter_schema_add(modclient: redis.Redis):
+async def test_alter_schema_add(decoded_r: redis.Redis):
     # Creating the index definition and schema
-    await modclient.ft().create_index(TextField("title"))
+    await decoded_r.ft().create_index(TextField("title"))
 
     # Using alter to add a field
-    await modclient.ft().alter_schema_add(TextField("body"))
+    await decoded_r.ft().alter_schema_add(TextField("body"))
 
     # Indexing a document
-    await modclient.hset(
+    await decoded_r.hset(
         "doc1", mapping={"title": "MyTitle", "body": "Some content only in the body"}
     )
 
@@ -634,167 +892,236 @@ async def test_alter_schema_add(modclient: redis.Redis):
     q = Query("only in the body")
 
     # Ensure we find the result searching on the added body field
-    res = await modclient.ft().search(q)
-    assert 1 == res.total
+    res = await decoded_r.ft().search(q)
+    if is_resp2_connection(decoded_r):
+        assert 1 == res.total
+    else:
+        assert 1 == res["total_results"]
 
 
 @pytest.mark.redismod
-async def test_spell_check(modclient: redis.Redis):
-    await modclient.ft().create_index((TextField("f1"), TextField("f2")))
+async def test_spell_check(decoded_r: redis.Redis):
+    await decoded_r.ft().create_index((TextField("f1"), TextField("f2")))
 
     await (
-        modclient.hset(
+        decoded_r.hset(
             "doc1", mapping={"f1": "some valid content", "f2": "this is sample text"}
         )
     )
-    await modclient.hset("doc2", mapping={"f1": "very important", "f2": "lorem ipsum"})
-    await waitForIndex(modclient, "idx")
-
-    # test spellcheck
-    res = await modclient.ft().spellcheck("impornant")
-    assert "important" == res["impornant"][0]["suggestion"]
-
-    res = await modclient.ft().spellcheck("contnt")
-    assert "content" == res["contnt"][0]["suggestion"]
-
-    # test spellcheck with Levenshtein distance
-    res = await modclient.ft().spellcheck("vlis")
-    assert res == {}
-    res = await modclient.ft().spellcheck("vlis", distance=2)
-    assert "valid" == res["vlis"][0]["suggestion"]
-
-    # test spellcheck include
-    await modclient.ft().dict_add("dict", "lore", "lorem", "lorm")
-    res = await modclient.ft().spellcheck("lorm", include="dict")
-    assert len(res["lorm"]) == 3
-    assert (
-        res["lorm"][0]["suggestion"],
-        res["lorm"][1]["suggestion"],
-        res["lorm"][2]["suggestion"],
-    ) == ("lorem", "lore", "lorm")
-    assert (res["lorm"][0]["score"], res["lorm"][1]["score"]) == ("0.5", "0")
-
-    # test spellcheck exclude
-    res = await modclient.ft().spellcheck("lorm", exclude="dict")
-    assert res == {}
+    await decoded_r.hset("doc2", mapping={"f1": "very important", "f2": "lorem ipsum"})
+    await waitForIndex(decoded_r, "idx")
+
+    if is_resp2_connection(decoded_r):
+        # test spellcheck
+        res = await decoded_r.ft().spellcheck("impornant")
+        assert "important" == res["impornant"][0]["suggestion"]
+
+        res = await decoded_r.ft().spellcheck("contnt")
+        assert "content" == res["contnt"][0]["suggestion"]
+
+        # test spellcheck with Levenshtein distance
+        res = await decoded_r.ft().spellcheck("vlis")
+        assert res == {}
+        res = await decoded_r.ft().spellcheck("vlis", distance=2)
+        assert "valid" == res["vlis"][0]["suggestion"]
+
+        # test spellcheck include
+        await decoded_r.ft().dict_add("dict", "lore", "lorem", "lorm")
+        res = await decoded_r.ft().spellcheck("lorm", include="dict")
+        assert len(res["lorm"]) == 3
+        assert (
+            res["lorm"][0]["suggestion"],
+            res["lorm"][1]["suggestion"],
+            res["lorm"][2]["suggestion"],
+        ) == ("lorem", "lore", "lorm")
+        assert (res["lorm"][0]["score"], res["lorm"][1]["score"]) == ("0.5", "0")
+
+        # test spellcheck exclude
+        res = await decoded_r.ft().spellcheck("lorm", exclude="dict")
+        assert res == {}
+    else:
+        # test spellcheck
+        res = await decoded_r.ft().spellcheck("impornant")
+        assert "important" in res["results"]["impornant"][0].keys()
+
+        res = await decoded_r.ft().spellcheck("contnt")
+        assert "content" in res["results"]["contnt"][0].keys()
+
+        # test spellcheck with Levenshtein distance
+        res = await decoded_r.ft().spellcheck("vlis")
+        assert res == {"results": {"vlis": []}}
+        res = await decoded_r.ft().spellcheck("vlis", distance=2)
+        assert "valid" in res["results"]["vlis"][0].keys()
+
+        # test spellcheck include
+        await decoded_r.ft().dict_add("dict", "lore", "lorem", "lorm")
+        res = await decoded_r.ft().spellcheck("lorm", include="dict")
+        assert len(res["results"]["lorm"]) == 3
+        assert "lorem" in res["results"]["lorm"][0].keys()
+        assert "lore" in res["results"]["lorm"][1].keys()
+        assert "lorm" in res["results"]["lorm"][2].keys()
+        assert (
+            res["results"]["lorm"][0]["lorem"],
+            res["results"]["lorm"][1]["lore"],
+        ) == (0.5, 0)
+
+        # test spellcheck exclude
+        res = await decoded_r.ft().spellcheck("lorm", exclude="dict")
+        assert res == {"results": {}}
 
 
 @pytest.mark.redismod
-async def test_dict_operations(modclient: redis.Redis):
-    await modclient.ft().create_index((TextField("f1"), TextField("f2")))
+async def test_dict_operations(decoded_r: redis.Redis):
+    await decoded_r.ft().create_index((TextField("f1"), TextField("f2")))
     # Add three items
-    res = await modclient.ft().dict_add("custom_dict", "item1", "item2", "item3")
+    res = await decoded_r.ft().dict_add("custom_dict", "item1", "item2", "item3")
     assert 3 == res
 
     # Remove one item
-    res = await modclient.ft().dict_del("custom_dict", "item2")
+    res = await decoded_r.ft().dict_del("custom_dict", "item2")
     assert 1 == res
 
     # Dump dict and inspect content
-    res = await modclient.ft().dict_dump("custom_dict")
-    assert ["item1", "item3"] == res
+    res = await decoded_r.ft().dict_dump("custom_dict")
+    assert_resp_response(decoded_r, res, ["item1", "item3"], {"item1", "item3"})
 
     # Remove rest of the items before reload
-    await modclient.ft().dict_del("custom_dict", *res)
+    await decoded_r.ft().dict_del("custom_dict", *res)
 
 
 @pytest.mark.redismod
-async def test_phonetic_matcher(modclient: redis.Redis):
-    await modclient.ft().create_index((TextField("name"),))
-    await modclient.hset("doc1", mapping={"name": "Jon"})
-    await modclient.hset("doc2", mapping={"name": "John"})
-
-    res = await modclient.ft().search(Query("Jon"))
-    assert 1 == len(res.docs)
-    assert "Jon" == res.docs[0].name
+async def test_phonetic_matcher(decoded_r: redis.Redis):
+    await decoded_r.ft().create_index((TextField("name"),))
+    await decoded_r.hset("doc1", mapping={"name": "Jon"})
+    await decoded_r.hset("doc2", mapping={"name": "John"})
+
+    res = await decoded_r.ft().search(Query("Jon"))
+    if is_resp2_connection(decoded_r):
+        assert 1 == len(res.docs)
+        assert "Jon" == res.docs[0].name
+    else:
+        assert 1 == res["total_results"]
+        assert "Jon" == res["results"][0]["extra_attributes"]["name"]
 
     # Drop and create index with phonetic matcher
-    await modclient.flushdb()
-
-    await modclient.ft().create_index((TextField("name", phonetic_matcher="dm:en"),))
-    await modclient.hset("doc1", mapping={"name": "Jon"})
-    await modclient.hset("doc2", mapping={"name": "John"})
-
-    res = await modclient.ft().search(Query("Jon"))
-    assert 2 == len(res.docs)
-    assert ["John", "Jon"] == sorted(d.name for d in res.docs)
+    await decoded_r.flushdb()
+
+    await decoded_r.ft().create_index((TextField("name", phonetic_matcher="dm:en"),))
+    await decoded_r.hset("doc1", mapping={"name": "Jon"})
+    await decoded_r.hset("doc2", mapping={"name": "John"})
+
+    res = await decoded_r.ft().search(Query("Jon"))
+    if is_resp2_connection(decoded_r):
+        assert 2 == len(res.docs)
+        assert ["John", "Jon"] == sorted(d.name for d in res.docs)
+    else:
+        assert 2 == res["total_results"]
+        assert ["John", "Jon"] == sorted(
+            d["extra_attributes"]["name"] for d in res["results"]
+        )
 
 
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
-async def test_scorer(modclient: redis.Redis):
-    await modclient.ft().create_index((TextField("description"),))
+async def test_scorer(decoded_r: redis.Redis):
+    await decoded_r.ft().create_index((TextField("description"),))
 
-    await modclient.hset(
+    await decoded_r.hset(
         "doc1", mapping={"description": "The quick brown fox jumps over the lazy dog"}
     )
-    await modclient.hset(
+    await decoded_r.hset(
         "doc2",
         mapping={
             "description": "Quick alice was beginning to get very tired of sitting by her quick sister on the bank, and of having nothing to do."  # noqa
         },
     )
 
-    # default scorer is TFIDF
-    res = await modclient.ft().search(Query("quick").with_scores())
-    assert 1.0 == res.docs[0].score
-    res = await modclient.ft().search(Query("quick").scorer("TFIDF").with_scores())
-    assert 1.0 == res.docs[0].score
-    res = await (
-        modclient.ft().search(Query("quick").scorer("TFIDF.DOCNORM").with_scores())
-    )
-    assert 0.1111111111111111 == res.docs[0].score
-    res = await modclient.ft().search(Query("quick").scorer("BM25").with_scores())
-    assert 0.17699114465425977 == res.docs[0].score
-    res = await modclient.ft().search(Query("quick").scorer("DISMAX").with_scores())
-    assert 2.0 == res.docs[0].score
-    res = await modclient.ft().search(Query("quick").scorer("DOCSCORE").with_scores())
-    assert 1.0 == res.docs[0].score
-    res = await modclient.ft().search(Query("quick").scorer("HAMMING").with_scores())
-    assert 0.0 == res.docs[0].score
+    if is_resp2_connection(decoded_r):
+        # default scorer is TFIDF
+        res = await decoded_r.ft().search(Query("quick").with_scores())
+        assert 1.0 == res.docs[0].score
+        res = await decoded_r.ft().search(Query("quick").scorer("TFIDF").with_scores())
+        assert 1.0 == res.docs[0].score
+        res = await (
+            decoded_r.ft().search(Query("quick").scorer("TFIDF.DOCNORM").with_scores())
+        )
+        assert 0.1111111111111111 == res.docs[0].score
+        res = await decoded_r.ft().search(Query("quick").scorer("BM25").with_scores())
+        assert 0.17699114465425977 == res.docs[0].score
+        res = await decoded_r.ft().search(Query("quick").scorer("DISMAX").with_scores())
+        assert 2.0 == res.docs[0].score
+        res = await decoded_r.ft().search(
+            Query("quick").scorer("DOCSCORE").with_scores()
+        )
+        assert 1.0 == res.docs[0].score
+        res = await decoded_r.ft().search(
+            Query("quick").scorer("HAMMING").with_scores()
+        )
+        assert 0.0 == res.docs[0].score
+    else:
+        res = await decoded_r.ft().search(Query("quick").with_scores())
+        assert 1.0 == res["results"][0]["score"]
+        res = await decoded_r.ft().search(Query("quick").scorer("TFIDF").with_scores())
+        assert 1.0 == res["results"][0]["score"]
+        res = await decoded_r.ft().search(
+            Query("quick").scorer("TFIDF.DOCNORM").with_scores()
+        )
+        assert 0.1111111111111111 == res["results"][0]["score"]
+        res = await decoded_r.ft().search(Query("quick").scorer("BM25").with_scores())
+        assert 0.17699114465425977 == res["results"][0]["score"]
+        res = await decoded_r.ft().search(Query("quick").scorer("DISMAX").with_scores())
+        assert 2.0 == res["results"][0]["score"]
+        res = await decoded_r.ft().search(
+            Query("quick").scorer("DOCSCORE").with_scores()
+        )
+        assert 1.0 == res["results"][0]["score"]
+        res = await decoded_r.ft().search(
+            Query("quick").scorer("HAMMING").with_scores()
+        )
+        assert 0.0 == res["results"][0]["score"]
 
 
 @pytest.mark.redismod
-async def test_get(modclient: redis.Redis):
-    await modclient.ft().create_index((TextField("f1"), TextField("f2")))
+async def test_get(decoded_r: redis.Redis):
+    await decoded_r.ft().create_index((TextField("f1"), TextField("f2")))
 
-    assert [None] == await modclient.ft().get("doc1")
-    assert [None, None] == await modclient.ft().get("doc2", "doc1")
+    assert [None] == await decoded_r.ft().get("doc1")
+    assert [None, None] == await decoded_r.ft().get("doc2", "doc1")
 
-    await modclient.hset(
+    await decoded_r.hset(
         "doc1", mapping={"f1": "some valid content dd1", "f2": "this is sample text f1"}
     )
-    await modclient.hset(
+    await decoded_r.hset(
         "doc2", mapping={"f1": "some valid content dd2", "f2": "this is sample text f2"}
     )
 
     assert [
         ["f1", "some valid content dd2", "f2", "this is sample text f2"]
-    ] == await modclient.ft().get("doc2")
+    ] == await decoded_r.ft().get("doc2")
     assert [
         ["f1", "some valid content dd1", "f2", "this is sample text f1"],
         ["f1", "some valid content dd2", "f2", "this is sample text f2"],
-    ] == await modclient.ft().get("doc1", "doc2")
+    ] == await decoded_r.ft().get("doc1", "doc2")
 
 
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("2.2.0", "search")
-async def test_config(modclient: redis.Redis):
-    assert await modclient.ft().config_set("TIMEOUT", "100")
+async def test_config(decoded_r: redis.Redis):
+    assert await decoded_r.ft().config_set("TIMEOUT", "100")
     with pytest.raises(redis.ResponseError):
-        await modclient.ft().config_set("TIMEOUT", "null")
-    res = await modclient.ft().config_get("*")
+        await decoded_r.ft().config_set("TIMEOUT", "null")
+    res = await decoded_r.ft().config_get("*")
     assert "100" == res["TIMEOUT"]
-    res = await modclient.ft().config_get("TIMEOUT")
+    res = await decoded_r.ft().config_get("TIMEOUT")
     assert "100" == res["TIMEOUT"]
 
 
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
-async def test_aggregations_groupby(modclient: redis.Redis):
+async def test_aggregations_groupby(decoded_r: redis.Redis):
     # Creating the index definition and schema
-    await modclient.ft().create_index(
+    await decoded_r.ft().create_index(
         (
             NumericField("random_num"),
             TextField("title"),
@@ -804,7 +1131,7 @@ async def test_aggregations_groupby(modclient: redis.Redis):
     )
 
     # Indexing a document
-    await modclient.hset(
+    await decoded_r.hset(
         "search",
         mapping={
             "title": "RediSearch",
@@ -813,7 +1140,7 @@ async def test_aggregations_groupby(modclient: redis.Redis):
             "random_num": 10,
         },
     )
-    await modclient.hset(
+    await decoded_r.hset(
         "ai",
         mapping={
             "title": "RedisAI",
@@ -822,7 +1149,7 @@ async def test_aggregations_groupby(modclient: redis.Redis):
             "random_num": 3,
         },
     )
-    await modclient.hset(
+    await decoded_r.hset(
         "json",
         mapping={
             "title": "RedisJson",
@@ -833,207 +1160,408 @@ async def test_aggregations_groupby(modclient: redis.Redis):
     )
 
     for dialect in [1, 2]:
-        req = (
-            aggregations.AggregateRequest("redis")
-            .group_by("@parent", reducers.count())
-            .dialect(dialect)
-        )
+        if is_resp2_connection(decoded_r):
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.count())
+                .dialect(dialect)
+            )
 
-        res = (await modclient.ft().aggregate(req)).rows[0]
-        assert res[1] == "redis"
-        assert res[3] == "3"
+            res = (await decoded_r.ft().aggregate(req)).rows[0]
+            assert res[1] == "redis"
+            assert res[3] == "3"
 
-        req = (
-            aggregations.AggregateRequest("redis")
-            .group_by("@parent", reducers.count_distinct("@title"))
-            .dialect(dialect)
-        )
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.count_distinct("@title"))
+                .dialect(dialect)
+            )
 
-        res = (await modclient.ft().aggregate(req)).rows[0]
-        assert res[1] == "redis"
-        assert res[3] == "3"
+            res = (await decoded_r.ft().aggregate(req)).rows[0]
+            assert res[1] == "redis"
+            assert res[3] == "3"
 
-        req = (
-            aggregations.AggregateRequest("redis")
-            .group_by("@parent", reducers.count_distinctish("@title"))
-            .dialect(dialect)
-        )
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.count_distinctish("@title"))
+                .dialect(dialect)
+            )
 
-        res = (await modclient.ft().aggregate(req)).rows[0]
-        assert res[1] == "redis"
-        assert res[3] == "3"
+            res = (await decoded_r.ft().aggregate(req)).rows[0]
+            assert res[1] == "redis"
+            assert res[3] == "3"
 
-        req = (
-            aggregations.AggregateRequest("redis")
-            .group_by("@parent", reducers.sum("@random_num"))
-            .dialect(dialect)
-        )
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.sum("@random_num"))
+                .dialect(dialect)
+            )
 
-        res = (await modclient.ft().aggregate(req)).rows[0]
-        assert res[1] == "redis"
-        assert res[3] == "21"  # 10+8+3
+            res = (await decoded_r.ft().aggregate(req)).rows[0]
+            assert res[1] == "redis"
+            assert res[3] == "21"  # 10+8+3
 
-        req = (
-            aggregations.AggregateRequest("redis")
-            .group_by("@parent", reducers.min("@random_num"))
-            .dialect(dialect)
-        )
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.min("@random_num"))
+                .dialect(dialect)
+            )
 
-        res = (await modclient.ft().aggregate(req)).rows[0]
-        assert res[1] == "redis"
-        assert res[3] == "3"  # min(10,8,3)
+            res = (await decoded_r.ft().aggregate(req)).rows[0]
+            assert res[1] == "redis"
+            assert res[3] == "3"  # min(10,8,3)
 
-        req = (
-            aggregations.AggregateRequest("redis")
-            .group_by("@parent", reducers.max("@random_num"))
-            .dialect(dialect)
-        )
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.max("@random_num"))
+                .dialect(dialect)
+            )
 
-        res = (await modclient.ft().aggregate(req)).rows[0]
-        assert res[1] == "redis"
-        assert res[3] == "10"  # max(10,8,3)
+            res = (await decoded_r.ft().aggregate(req)).rows[0]
+            assert res[1] == "redis"
+            assert res[3] == "10"  # max(10,8,3)
 
-        req = (
-            aggregations.AggregateRequest("redis")
-            .group_by("@parent", reducers.avg("@random_num"))
-            .dialect(dialect)
-        )
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.avg("@random_num"))
+                .dialect(dialect)
+            )
 
-        res = (await modclient.ft().aggregate(req)).rows[0]
-        assert res[1] == "redis"
-        assert res[3] == "7"  # (10+3+8)/3
+            res = (await decoded_r.ft().aggregate(req)).rows[0]
+            assert res[1] == "redis"
+            assert res[3] == "7"  # (10+3+8)/3
 
-        req = (
-            aggregations.AggregateRequest("redis")
-            .group_by("@parent", reducers.stddev("random_num"))
-            .dialect(dialect)
-        )
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.stddev("random_num"))
+                .dialect(dialect)
+            )
 
-        res = (await modclient.ft().aggregate(req)).rows[0]
-        assert res[1] == "redis"
-        assert res[3] == "3.60555127546"
+            res = (await decoded_r.ft().aggregate(req)).rows[0]
+            assert res[1] == "redis"
+            assert res[3] == "3.60555127546"
 
-        req = (
-            aggregations.AggregateRequest("redis")
-            .group_by("@parent", reducers.quantile("@random_num", 0.5))
-            .dialect(dialect)
-        )
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.quantile("@random_num", 0.5))
+                .dialect(dialect)
+            )
 
-        res = (await modclient.ft().aggregate(req)).rows[0]
-        assert res[1] == "redis"
-        assert res[3] == "8"  # median of 3,8,10
+            res = (await decoded_r.ft().aggregate(req)).rows[0]
+            assert res[1] == "redis"
+            assert res[3] == "8"  # median of 3,8,10
 
-        req = (
-            aggregations.AggregateRequest("redis")
-            .group_by("@parent", reducers.tolist("@title"))
-            .dialect(dialect)
-        )
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.tolist("@title"))
+                .dialect(dialect)
+            )
 
-        res = (await modclient.ft().aggregate(req)).rows[0]
-        assert res[1] == "redis"
-        assert set(res[3]) == {"RediSearch", "RedisAI", "RedisJson"}
+            res = (await decoded_r.ft().aggregate(req)).rows[0]
+            assert res[1] == "redis"
+            assert set(res[3]) == {"RediSearch", "RedisAI", "RedisJson"}
 
-        req = (
-            aggregations.AggregateRequest("redis")
-            .group_by("@parent", reducers.first_value("@title").alias("first"))
-            .dialect(dialect)
-        )
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.first_value("@title").alias("first"))
+                .dialect(dialect)
+            )
 
-        res = (await modclient.ft().aggregate(req)).rows[0]
-        assert res == ["parent", "redis", "first", "RediSearch"]
+            res = (await decoded_r.ft().aggregate(req)).rows[0]
+            assert res == ["parent", "redis", "first", "RediSearch"]
 
-        req = (
-            aggregations.AggregateRequest("redis")
-            .group_by("@parent", reducers.random_sample("@title", 2).alias("random"))
-            .dialect(dialect)
-        )
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by(
+                    "@parent", reducers.random_sample("@title", 2).alias("random")
+                )
+                .dialect(dialect)
+            )
+
+            res = (await decoded_r.ft().aggregate(req)).rows[0]
+            assert res[1] == "redis"
+            assert res[2] == "random"
+            assert len(res[3]) == 2
+            assert res[3][0] in ["RediSearch", "RedisAI", "RedisJson"]
+        else:
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.count())
+                .dialect(dialect)
+            )
+
+            res = (await decoded_r.ft().aggregate(req))["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert res["extra_attributes"]["__generated_aliascount"] == "3"
 
-        res = (await modclient.ft().aggregate(req)).rows[0]
-        assert res[1] == "redis"
-        assert res[2] == "random"
-        assert len(res[3]) == 2
-        assert res[3][0] in ["RediSearch", "RedisAI", "RedisJson"]
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.count_distinct("@title"))
+                .dialect(dialect)
+            )
+
+            res = (await decoded_r.ft().aggregate(req))["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert (
+                res["extra_attributes"]["__generated_aliascount_distincttitle"] == "3"
+            )
+
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.count_distinctish("@title"))
+                .dialect(dialect)
+            )
+
+            res = (await decoded_r.ft().aggregate(req))["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert (
+                res["extra_attributes"]["__generated_aliascount_distinctishtitle"]
+                == "3"
+            )
+
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.sum("@random_num"))
+                .dialect(dialect)
+            )
+
+            res = (await decoded_r.ft().aggregate(req))["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert res["extra_attributes"]["__generated_aliassumrandom_num"] == "21"
+
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.min("@random_num"))
+                .dialect(dialect)
+            )
+
+            res = (await decoded_r.ft().aggregate(req))["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert res["extra_attributes"]["__generated_aliasminrandom_num"] == "3"
+
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.max("@random_num"))
+                .dialect(dialect)
+            )
+
+            res = (await decoded_r.ft().aggregate(req))["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert res["extra_attributes"]["__generated_aliasmaxrandom_num"] == "10"
+
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.avg("@random_num"))
+                .dialect(dialect)
+            )
+
+            res = (await decoded_r.ft().aggregate(req))["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert res["extra_attributes"]["__generated_aliasavgrandom_num"] == "7"
+
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.stddev("random_num"))
+                .dialect(dialect)
+            )
+
+            res = (await decoded_r.ft().aggregate(req))["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert (
+                res["extra_attributes"]["__generated_aliasstddevrandom_num"]
+                == "3.60555127546"
+            )
+
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.quantile("@random_num", 0.5))
+                .dialect(dialect)
+            )
+
+            res = (await decoded_r.ft().aggregate(req))["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert (
+                res["extra_attributes"]["__generated_aliasquantilerandom_num,0.5"]
+                == "8"
+            )
+
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.tolist("@title"))
+                .dialect(dialect)
+            )
+
+            res = (await decoded_r.ft().aggregate(req))["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert set(res["extra_attributes"]["__generated_aliastolisttitle"]) == {
+                "RediSearch",
+                "RedisAI",
+                "RedisJson",
+            }
+
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by("@parent", reducers.first_value("@title").alias("first"))
+                .dialect(dialect)
+            )
+
+            res = (await decoded_r.ft().aggregate(req))["results"][0]
+            assert res["extra_attributes"] == {"parent": "redis", "first": "RediSearch"}
+
+            req = (
+                aggregations.AggregateRequest("redis")
+                .group_by(
+                    "@parent", reducers.random_sample("@title", 2).alias("random")
+                )
+                .dialect(dialect)
+            )
+
+            res = (await decoded_r.ft().aggregate(req))["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert "random" in res["extra_attributes"].keys()
+            assert len(res["extra_attributes"]["random"]) == 2
+            assert res["extra_attributes"]["random"][0] in [
+                "RediSearch",
+                "RedisAI",
+                "RedisJson",
+            ]
 
 
 @pytest.mark.redismod
-async def test_aggregations_sort_by_and_limit(modclient: redis.Redis):
-    await modclient.ft().create_index((TextField("t1"), TextField("t2")))
+async def test_aggregations_sort_by_and_limit(decoded_r: redis.Redis):
+    await decoded_r.ft().create_index((TextField("t1"), TextField("t2")))
 
-    await modclient.ft().client.hset("doc1", mapping={"t1": "a", "t2": "b"})
-    await modclient.ft().client.hset("doc2", mapping={"t1": "b", "t2": "a"})
+    await decoded_r.ft().client.hset("doc1", mapping={"t1": "a", "t2": "b"})
+    await decoded_r.ft().client.hset("doc2", mapping={"t1": "b", "t2": "a"})
 
-    # test sort_by using SortDirection
-    req = aggregations.AggregateRequest("*").sort_by(
-        aggregations.Asc("@t2"), aggregations.Desc("@t1")
-    )
-    res = await modclient.ft().aggregate(req)
-    assert res.rows[0] == ["t2", "a", "t1", "b"]
-    assert res.rows[1] == ["t2", "b", "t1", "a"]
+    if is_resp2_connection(decoded_r):
+        # test sort_by using SortDirection
+        req = aggregations.AggregateRequest("*").sort_by(
+            aggregations.Asc("@t2"), aggregations.Desc("@t1")
+        )
+        res = await decoded_r.ft().aggregate(req)
+        assert res.rows[0] == ["t2", "a", "t1", "b"]
+        assert res.rows[1] == ["t2", "b", "t1", "a"]
+
+        # test sort_by without SortDirection
+        req = aggregations.AggregateRequest("*").sort_by("@t1")
+        res = await decoded_r.ft().aggregate(req)
+        assert res.rows[0] == ["t1", "a"]
+        assert res.rows[1] == ["t1", "b"]
+
+        # test sort_by with max
+        req = aggregations.AggregateRequest("*").sort_by("@t1", max=1)
+        res = await decoded_r.ft().aggregate(req)
+        assert len(res.rows) == 1
+
+        # test limit
+        req = aggregations.AggregateRequest("*").sort_by("@t1").limit(1, 1)
+        res = await decoded_r.ft().aggregate(req)
+        assert len(res.rows) == 1
+        assert res.rows[0] == ["t1", "b"]
+    else:
+        # test sort_by using SortDirection
+        req = aggregations.AggregateRequest("*").sort_by(
+            aggregations.Asc("@t2"), aggregations.Desc("@t1")
+        )
+        res = (await decoded_r.ft().aggregate(req))["results"]
+        assert res[0]["extra_attributes"] == {"t2": "a", "t1": "b"}
+        assert res[1]["extra_attributes"] == {"t2": "b", "t1": "a"}
 
-    # test sort_by without SortDirection
-    req = aggregations.AggregateRequest("*").sort_by("@t1")
-    res = await modclient.ft().aggregate(req)
-    assert res.rows[0] == ["t1", "a"]
-    assert res.rows[1] == ["t1", "b"]
+        # test sort_by without SortDirection
+        req = aggregations.AggregateRequest("*").sort_by("@t1")
+        res = (await decoded_r.ft().aggregate(req))["results"]
+        assert res[0]["extra_attributes"] == {"t1": "a"}
+        assert res[1]["extra_attributes"] == {"t1": "b"}
 
-    # test sort_by with max
-    req = aggregations.AggregateRequest("*").sort_by("@t1", max=1)
-    res = await modclient.ft().aggregate(req)
-    assert len(res.rows) == 1
+        # test sort_by with max
+        req = aggregations.AggregateRequest("*").sort_by("@t1", max=1)
+        res = await decoded_r.ft().aggregate(req)
+        assert len(res["results"]) == 1
 
-    # test limit
-    req = aggregations.AggregateRequest("*").sort_by("@t1").limit(1, 1)
-    res = await modclient.ft().aggregate(req)
-    assert len(res.rows) == 1
-    assert res.rows[0] == ["t1", "b"]
+        # test limit
+        req = aggregations.AggregateRequest("*").sort_by("@t1").limit(1, 1)
+        res = await decoded_r.ft().aggregate(req)
+        assert len(res["results"]) == 1
+        assert res["results"][0]["extra_attributes"] == {"t1": "b"}
 
 
 @pytest.mark.redismod
 @pytest.mark.experimental
-async def test_withsuffixtrie(modclient: redis.Redis):
+async def test_withsuffixtrie(decoded_r: redis.Redis):
     # create index
-    assert await modclient.ft().create_index((TextField("txt"),))
-    await waitForIndex(modclient, getattr(modclient.ft(), "index_name", "idx"))
-    info = await modclient.ft().info()
-    assert "WITHSUFFIXTRIE" not in info["attributes"][0]
-    assert await modclient.ft().dropindex("idx")
-
-    # create withsuffixtrie index (text field)
-    assert await modclient.ft().create_index((TextField("t", withsuffixtrie=True)))
-    await waitForIndex(modclient, getattr(modclient.ft(), "index_name", "idx"))
-    info = await modclient.ft().info()
-    assert "WITHSUFFIXTRIE" in info["attributes"][0]
-    assert await modclient.ft().dropindex("idx")
-
-    # create withsuffixtrie index (tag field)
-    assert await modclient.ft().create_index((TagField("t", withsuffixtrie=True)))
-    await waitForIndex(modclient, getattr(modclient.ft(), "index_name", "idx"))
-    info = await modclient.ft().info()
-    assert "WITHSUFFIXTRIE" in info["attributes"][0]
+    assert await decoded_r.ft().create_index((TextField("txt"),))
+    await waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
+    if is_resp2_connection(decoded_r):
+        info = await decoded_r.ft().info()
+        assert "WITHSUFFIXTRIE" not in info["attributes"][0]
+        assert await decoded_r.ft().dropindex("idx")
+
+        # create withsuffixtrie index (text field)
+        assert await decoded_r.ft().create_index((TextField("t", withsuffixtrie=True)))
+        await waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
+        info = await decoded_r.ft().info()
+        assert "WITHSUFFIXTRIE" in info["attributes"][0]
+        assert await decoded_r.ft().dropindex("idx")
+
+        # create withsuffixtrie index (tag field)
+        assert await decoded_r.ft().create_index((TagField("t", withsuffixtrie=True)))
+        await waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
+        info = await decoded_r.ft().info()
+        assert "WITHSUFFIXTRIE" in info["attributes"][0]
+    else:
+        info = await decoded_r.ft().info()
+        assert "WITHSUFFIXTRIE" not in info["attributes"][0]["flags"]
+        assert await decoded_r.ft().dropindex("idx")
+
+        # create withsuffixtrie index (text fiels)
+        assert await decoded_r.ft().create_index((TextField("t", withsuffixtrie=True)))
+        waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
+        info = await decoded_r.ft().info()
+        assert "WITHSUFFIXTRIE" in info["attributes"][0]["flags"]
+        assert await decoded_r.ft().dropindex("idx")
+
+        # create withsuffixtrie index (tag field)
+        assert await decoded_r.ft().create_index((TagField("t", withsuffixtrie=True)))
+        waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
+        info = await decoded_r.ft().info()
+        assert "WITHSUFFIXTRIE" in info["attributes"][0]["flags"]
 
 
 @pytest.mark.redismod
 @skip_if_redis_enterprise()
-async def test_search_commands_in_pipeline(modclient: redis.Redis):
-    p = await modclient.ft().pipeline()
+async def test_search_commands_in_pipeline(decoded_r: redis.Redis):
+    p = await decoded_r.ft().pipeline()
     p.create_index((TextField("txt"),))
     p.hset("doc1", mapping={"txt": "foo bar"})
     p.hset("doc2", mapping={"txt": "foo bar"})
     q = Query("foo bar").with_payloads()
     await p.search(q)
     res = await p.execute()
-    assert res[:3] == ["OK", True, True]
-    assert 2 == res[3][0]
-    assert "doc1" == res[3][1]
-    assert "doc2" == res[3][4]
-    assert res[3][5] is None
-    assert res[3][3] == res[3][6] == ["txt", "foo bar"]
+    if is_resp2_connection(decoded_r):
+        assert res[:3] == ["OK", True, True]
+        assert 2 == res[3][0]
+        assert "doc1" == res[3][1]
+        assert "doc2" == res[3][4]
+        assert res[3][5] is None
+        assert res[3][3] == res[3][6] == ["txt", "foo bar"]
+    else:
+        assert res[:3] == ["OK", True, True]
+        assert 2 == res[3]["total_results"]
+        assert "doc1" == res[3]["results"][0]["id"]
+        assert "doc2" == res[3]["results"][1]["id"]
+        assert res[3]["results"][0]["payload"] is None
+        assert (
+            res[3]["results"][0]["extra_attributes"]
+            == res[3]["results"][1]["extra_attributes"]
+            == {"txt": "foo bar"}
+        )
 
 
 @pytest.mark.redismod
-async def test_query_timeout(modclient: redis.Redis):
+async def test_query_timeout(decoded_r: redis.Redis):
     q1 = Query("foo").timeout(5000)
     assert q1.get_args() == ["foo", "TIMEOUT", 5000, "LIMIT", 0, 10]
     q2 = Query("foo").timeout("not_a_number")
     with pytest.raises(redis.ResponseError):
-        await modclient.ft().search(q2)
+        await decoded_r.ft().search(q2)
diff --git a/tests/test_asyncio/test_sentinel.py b/tests/test_asyncio/test_sentinel.py
index 7866056374..2091f2cb87 100644
--- a/tests/test_asyncio/test_sentinel.py
+++ b/tests/test_asyncio/test_sentinel.py
@@ -2,7 +2,6 @@
 
 import pytest
 import pytest_asyncio
-
 import redis.asyncio.sentinel
 from redis import exceptions
 from redis.asyncio.sentinel import (
diff --git a/tests/test_asyncio/test_sentinel_managed_connection.py b/tests/test_asyncio/test_sentinel_managed_connection.py
index a6e9f37a63..e784690c77 100644
--- a/tests/test_asyncio/test_sentinel_managed_connection.py
+++ b/tests/test_asyncio/test_sentinel_managed_connection.py
@@ -1,7 +1,6 @@
 import socket
 
 import pytest
-
 from redis.asyncio.retry import Retry
 from redis.asyncio.sentinel import SentinelManagedConnection
 from redis.backoff import NoBackoff
diff --git a/tests/test_asyncio/test_timeseries.py b/tests/test_asyncio/test_timeseries.py
index a7109938f2..48ffdfd889 100644
--- a/tests/test_asyncio/test_timeseries.py
+++ b/tests/test_asyncio/test_timeseries.py
@@ -2,230 +2,253 @@
 from time import sleep
 
 import pytest
-
 import redis.asyncio as redis
-from tests.conftest import skip_ifmodversion_lt
+from tests.conftest import (
+    assert_resp_response,
+    is_resp2_connection,
+    skip_ifmodversion_lt,
+)
 
 
 @pytest.mark.redismod
-async def test_create(modclient: redis.Redis):
-    assert await modclient.ts().create(1)
-    assert await modclient.ts().create(2, retention_msecs=5)
-    assert await modclient.ts().create(3, labels={"Redis": "Labs"})
-    assert await modclient.ts().create(4, retention_msecs=20, labels={"Time": "Series"})
-    info = await modclient.ts().info(4)
-    assert 20 == info.retention_msecs
-    assert "Series" == info.labels["Time"]
+async def test_create(decoded_r: redis.Redis):
+    assert await decoded_r.ts().create(1)
+    assert await decoded_r.ts().create(2, retention_msecs=5)
+    assert await decoded_r.ts().create(3, labels={"Redis": "Labs"})
+    assert await decoded_r.ts().create(4, retention_msecs=20, labels={"Time": "Series"})
+    info = await decoded_r.ts().info(4)
+    assert_resp_response(
+        decoded_r, 20, info.get("retention_msecs"), info.get("retentionTime")
+    )
+    assert "Series" == info["labels"]["Time"]
 
     # Test for a chunk size of 128 Bytes
-    assert await modclient.ts().create("time-serie-1", chunk_size=128)
-    info = await modclient.ts().info("time-serie-1")
-    assert 128, info.chunk_size
+    assert await decoded_r.ts().create("time-serie-1", chunk_size=128)
+    info = await decoded_r.ts().info("time-serie-1")
+    assert_resp_response(decoded_r, 128, info.get("chunk_size"), info.get("chunkSize"))
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
-async def test_create_duplicate_policy(modclient: redis.Redis):
+async def test_create_duplicate_policy(decoded_r: redis.Redis):
     # Test for duplicate policy
     for duplicate_policy in ["block", "last", "first", "min", "max"]:
         ts_name = f"time-serie-ooo-{duplicate_policy}"
-        assert await modclient.ts().create(ts_name, duplicate_policy=duplicate_policy)
-        info = await modclient.ts().info(ts_name)
-        assert duplicate_policy == info.duplicate_policy
+        assert await decoded_r.ts().create(ts_name, duplicate_policy=duplicate_policy)
+        info = await decoded_r.ts().info(ts_name)
+        assert_resp_response(
+            decoded_r,
+            duplicate_policy,
+            info.get("duplicate_policy"),
+            info.get("duplicatePolicy"),
+        )
 
 
 @pytest.mark.redismod
-async def test_alter(modclient: redis.Redis):
-    assert await modclient.ts().create(1)
-    res = await modclient.ts().info(1)
-    assert 0 == res.retention_msecs
-    assert await modclient.ts().alter(1, retention_msecs=10)
-    res = await modclient.ts().info(1)
-    assert {} == res.labels
-    res = await modclient.ts().info(1)
-    assert 10 == res.retention_msecs
-    assert await modclient.ts().alter(1, labels={"Time": "Series"})
-    res = await modclient.ts().info(1)
-    assert "Series" == res.labels["Time"]
-    res = await modclient.ts().info(1)
-    assert 10 == res.retention_msecs
+async def test_alter(decoded_r: redis.Redis):
+    assert await decoded_r.ts().create(1)
+    res = await decoded_r.ts().info(1)
+    assert_resp_response(
+        decoded_r, 0, res.get("retention_msecs"), res.get("retentionTime")
+    )
+    assert await decoded_r.ts().alter(1, retention_msecs=10)
+    res = await decoded_r.ts().info(1)
+    assert {} == (await decoded_r.ts().info(1))["labels"]
+    info = await decoded_r.ts().info(1)
+    assert_resp_response(
+        decoded_r, 10, info.get("retention_msecs"), info.get("retentionTime")
+    )
+    assert await decoded_r.ts().alter(1, labels={"Time": "Series"})
+    res = await decoded_r.ts().info(1)
+    assert "Series" == (await decoded_r.ts().info(1))["labels"]["Time"]
+    info = await decoded_r.ts().info(1)
+    assert_resp_response(
+        decoded_r, 10, info.get("retention_msecs"), info.get("retentionTime")
+    )
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
-async def test_alter_diplicate_policy(modclient: redis.Redis):
-    assert await modclient.ts().create(1)
-    info = await modclient.ts().info(1)
-    assert info.duplicate_policy is None
-    assert await modclient.ts().alter(1, duplicate_policy="min")
-    info = await modclient.ts().info(1)
-    assert "min" == info.duplicate_policy
+async def test_alter_diplicate_policy(decoded_r: redis.Redis):
+    assert await decoded_r.ts().create(1)
+    info = await decoded_r.ts().info(1)
+    assert_resp_response(
+        decoded_r, None, info.get("duplicate_policy"), info.get("duplicatePolicy")
+    )
+    assert await decoded_r.ts().alter(1, duplicate_policy="min")
+    info = await decoded_r.ts().info(1)
+    assert_resp_response(
+        decoded_r, "min", info.get("duplicate_policy"), info.get("duplicatePolicy")
+    )
 
 
 @pytest.mark.redismod
-async def test_add(modclient: redis.Redis):
-    assert 1 == await modclient.ts().add(1, 1, 1)
-    assert 2 == await modclient.ts().add(2, 2, 3, retention_msecs=10)
-    assert 3 == await modclient.ts().add(3, 3, 2, labels={"Redis": "Labs"})
-    assert 4 == await modclient.ts().add(
+async def test_add(decoded_r: redis.Redis):
+    assert 1 == await decoded_r.ts().add(1, 1, 1)
+    assert 2 == await decoded_r.ts().add(2, 2, 3, retention_msecs=10)
+    assert 3 == await decoded_r.ts().add(3, 3, 2, labels={"Redis": "Labs"})
+    assert 4 == await decoded_r.ts().add(
         4, 4, 2, retention_msecs=10, labels={"Redis": "Labs", "Time": "Series"}
     )
-    res = await modclient.ts().add(5, "*", 1)
+    res = await decoded_r.ts().add(5, "*", 1)
     assert abs(time.time() - round(float(res) / 1000)) < 1.0
 
-    info = await modclient.ts().info(4)
-    assert 10 == info.retention_msecs
-    assert "Labs" == info.labels["Redis"]
+    info = await decoded_r.ts().info(4)
+    assert_resp_response(
+        decoded_r, 10, info.get("retention_msecs"), info.get("retentionTime")
+    )
+    assert "Labs" == info["labels"]["Redis"]
 
     # Test for a chunk size of 128 Bytes on TS.ADD
-    assert await modclient.ts().add("time-serie-1", 1, 10.0, chunk_size=128)
-    info = await modclient.ts().info("time-serie-1")
-    assert 128 == info.chunk_size
+    assert await decoded_r.ts().add("time-serie-1", 1, 10.0, chunk_size=128)
+    info = await decoded_r.ts().info("time-serie-1")
+    assert_resp_response(decoded_r, 128, info.get("chunk_size"), info.get("chunkSize"))
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
-async def test_add_duplicate_policy(modclient: redis.Redis):
+async def test_add_duplicate_policy(r: redis.Redis):
 
     # Test for duplicate policy BLOCK
-    assert 1 == await modclient.ts().add("time-serie-add-ooo-block", 1, 5.0)
+    assert 1 == await r.ts().add("time-serie-add-ooo-block", 1, 5.0)
     with pytest.raises(Exception):
-        await modclient.ts().add(
-            "time-serie-add-ooo-block", 1, 5.0, duplicate_policy="block"
-        )
+        await r.ts().add("time-serie-add-ooo-block", 1, 5.0, duplicate_policy="block")
 
     # Test for duplicate policy LAST
-    assert 1 == await modclient.ts().add("time-serie-add-ooo-last", 1, 5.0)
-    assert 1 == await modclient.ts().add(
+    assert 1 == await r.ts().add("time-serie-add-ooo-last", 1, 5.0)
+    assert 1 == await r.ts().add(
         "time-serie-add-ooo-last", 1, 10.0, duplicate_policy="last"
     )
-    res = await modclient.ts().get("time-serie-add-ooo-last")
+    res = await r.ts().get("time-serie-add-ooo-last")
     assert 10.0 == res[1]
 
     # Test for duplicate policy FIRST
-    assert 1 == await modclient.ts().add("time-serie-add-ooo-first", 1, 5.0)
-    assert 1 == await modclient.ts().add(
+    assert 1 == await r.ts().add("time-serie-add-ooo-first", 1, 5.0)
+    assert 1 == await r.ts().add(
         "time-serie-add-ooo-first", 1, 10.0, duplicate_policy="first"
     )
-    res = await modclient.ts().get("time-serie-add-ooo-first")
+    res = await r.ts().get("time-serie-add-ooo-first")
     assert 5.0 == res[1]
 
     # Test for duplicate policy MAX
-    assert 1 == await modclient.ts().add("time-serie-add-ooo-max", 1, 5.0)
-    assert 1 == await modclient.ts().add(
+    assert 1 == await r.ts().add("time-serie-add-ooo-max", 1, 5.0)
+    assert 1 == await r.ts().add(
         "time-serie-add-ooo-max", 1, 10.0, duplicate_policy="max"
     )
-    res = await modclient.ts().get("time-serie-add-ooo-max")
+    res = await r.ts().get("time-serie-add-ooo-max")
     assert 10.0 == res[1]
 
     # Test for duplicate policy MIN
-    assert 1 == await modclient.ts().add("time-serie-add-ooo-min", 1, 5.0)
-    assert 1 == await modclient.ts().add(
+    assert 1 == await r.ts().add("time-serie-add-ooo-min", 1, 5.0)
+    assert 1 == await r.ts().add(
         "time-serie-add-ooo-min", 1, 10.0, duplicate_policy="min"
     )
-    res = await modclient.ts().get("time-serie-add-ooo-min")
+    res = await r.ts().get("time-serie-add-ooo-min")
     assert 5.0 == res[1]
 
 
 @pytest.mark.redismod
-async def test_madd(modclient: redis.Redis):
-    await modclient.ts().create("a")
-    assert [1, 2, 3] == await modclient.ts().madd(
+async def test_madd(decoded_r: redis.Redis):
+    await decoded_r.ts().create("a")
+    assert [1, 2, 3] == await decoded_r.ts().madd(
         [("a", 1, 5), ("a", 2, 10), ("a", 3, 15)]
     )
 
 
 @pytest.mark.redismod
-async def test_incrby_decrby(modclient: redis.Redis):
+async def test_incrby_decrby(decoded_r: redis.Redis):
     for _ in range(100):
-        assert await modclient.ts().incrby(1, 1)
+        assert await decoded_r.ts().incrby(1, 1)
         sleep(0.001)
-    assert 100 == (await modclient.ts().get(1))[1]
+    assert 100 == (await decoded_r.ts().get(1))[1]
     for _ in range(100):
-        assert await modclient.ts().decrby(1, 1)
+        assert await decoded_r.ts().decrby(1, 1)
         sleep(0.001)
-    assert 0 == (await modclient.ts().get(1))[1]
+    assert 0 == (await decoded_r.ts().get(1))[1]
 
-    assert await modclient.ts().incrby(2, 1.5, timestamp=5)
-    assert (5, 1.5) == await modclient.ts().get(2)
-    assert await modclient.ts().incrby(2, 2.25, timestamp=7)
-    assert (7, 3.75) == await modclient.ts().get(2)
-    assert await modclient.ts().decrby(2, 1.5, timestamp=15)
-    assert (15, 2.25) == await modclient.ts().get(2)
+    assert await decoded_r.ts().incrby(2, 1.5, timestamp=5)
+    assert_resp_response(decoded_r, await decoded_r.ts().get(2), (5, 1.5), [5, 1.5])
+    assert await decoded_r.ts().incrby(2, 2.25, timestamp=7)
+    assert_resp_response(decoded_r, await decoded_r.ts().get(2), (7, 3.75), [7, 3.75])
+    assert await decoded_r.ts().decrby(2, 1.5, timestamp=15)
+    assert_resp_response(decoded_r, await decoded_r.ts().get(2), (15, 2.25), [15, 2.25])
 
     # Test for a chunk size of 128 Bytes on TS.INCRBY
-    assert await modclient.ts().incrby("time-serie-1", 10, chunk_size=128)
-    info = await modclient.ts().info("time-serie-1")
-    assert 128 == info.chunk_size
+    assert await decoded_r.ts().incrby("time-serie-1", 10, chunk_size=128)
+    info = await decoded_r.ts().info("time-serie-1")
+    assert_resp_response(decoded_r, 128, info.get("chunk_size"), info.get("chunkSize"))
 
     # Test for a chunk size of 128 Bytes on TS.DECRBY
-    assert await modclient.ts().decrby("time-serie-2", 10, chunk_size=128)
-    info = await modclient.ts().info("time-serie-2")
-    assert 128 == info.chunk_size
+    assert await decoded_r.ts().decrby("time-serie-2", 10, chunk_size=128)
+    info = await decoded_r.ts().info("time-serie-2")
+    assert_resp_response(decoded_r, 128, info.get("chunk_size"), info.get("chunkSize"))
 
 
 @pytest.mark.redismod
-async def test_create_and_delete_rule(modclient: redis.Redis):
+async def test_create_and_delete_rule(decoded_r: redis.Redis):
     # test rule creation
     time = 100
-    await modclient.ts().create(1)
-    await modclient.ts().create(2)
-    await modclient.ts().createrule(1, 2, "avg", 100)
+    await decoded_r.ts().create(1)
+    await decoded_r.ts().create(2)
+    await decoded_r.ts().createrule(1, 2, "avg", 100)
     for i in range(50):
-        await modclient.ts().add(1, time + i * 2, 1)
-        await modclient.ts().add(1, time + i * 2 + 1, 2)
-    await modclient.ts().add(1, time * 2, 1.5)
-    assert round((await modclient.ts().get(2))[1], 5) == 1.5
-    info = await modclient.ts().info(1)
-    assert info.rules[0][1] == 100
+        await decoded_r.ts().add(1, time + i * 2, 1)
+        await decoded_r.ts().add(1, time + i * 2 + 1, 2)
+    await decoded_r.ts().add(1, time * 2, 1.5)
+    assert round((await decoded_r.ts().get(2))[1], 5) == 1.5
+    info = await decoded_r.ts().info(1)
+    if is_resp2_connection(decoded_r):
+        assert info.rules[0][1] == 100
+    else:
+        assert info["rules"]["2"][0] == 100
 
     # test rule deletion
-    await modclient.ts().deleterule(1, 2)
-    info = await modclient.ts().info(1)
-    assert not info.rules
+    await decoded_r.ts().deleterule(1, 2)
+    info = await decoded_r.ts().info(1)
+    assert not info["rules"]
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
-async def test_del_range(modclient: redis.Redis):
+async def test_del_range(decoded_r: redis.Redis):
     try:
-        await modclient.ts().delete("test", 0, 100)
+        await decoded_r.ts().delete("test", 0, 100)
     except Exception as e:
         assert e.__str__() != ""
 
     for i in range(100):
-        await modclient.ts().add(1, i, i % 7)
-    assert 22 == await modclient.ts().delete(1, 0, 21)
-    assert [] == await modclient.ts().range(1, 0, 21)
-    assert [(22, 1.0)] == await modclient.ts().range(1, 22, 22)
+        await decoded_r.ts().add(1, i, i % 7)
+    assert 22 == await decoded_r.ts().delete(1, 0, 21)
+    assert [] == await decoded_r.ts().range(1, 0, 21)
+    assert_resp_response(
+        decoded_r, await decoded_r.ts().range(1, 22, 22), [(22, 1.0)], [[22, 1.0]]
+    )
 
 
 @pytest.mark.redismod
-async def test_range(modclient: redis.Redis):
+async def test_range(r: redis.Redis):
     for i in range(100):
-        await modclient.ts().add(1, i, i % 7)
-    assert 100 == len(await modclient.ts().range(1, 0, 200))
+        await r.ts().add(1, i, i % 7)
+    assert 100 == len(await r.ts().range(1, 0, 200))
     for i in range(100):
-        await modclient.ts().add(1, i + 200, i % 7)
-    assert 200 == len(await modclient.ts().range(1, 0, 500))
+        await r.ts().add(1, i + 200, i % 7)
+    assert 200 == len(await r.ts().range(1, 0, 500))
     # last sample isn't returned
     assert 20 == len(
-        await modclient.ts().range(
-            1, 0, 500, aggregation_type="avg", bucket_size_msec=10
-        )
+        await r.ts().range(1, 0, 500, aggregation_type="avg", bucket_size_msec=10)
     )
-    assert 10 == len(await modclient.ts().range(1, 0, 500, count=10))
+    assert 10 == len(await r.ts().range(1, 0, 500, count=10))
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
-async def test_range_advanced(modclient: redis.Redis):
+async def test_range_advanced(decoded_r: redis.Redis):
     for i in range(100):
-        await modclient.ts().add(1, i, i % 7)
-        await modclient.ts().add(1, i + 200, i % 7)
+        await decoded_r.ts().add(1, i, i % 7)
+        await decoded_r.ts().add(1, i + 200, i % 7)
 
     assert 2 == len(
-        await modclient.ts().range(
+        await decoded_r.ts().range(
             1,
             0,
             500,
@@ -234,35 +257,38 @@ async def test_range_advanced(modclient: redis.Redis):
             filter_by_max_value=2,
         )
     )
-    assert [(0, 10.0), (10, 1.0)] == await modclient.ts().range(
+    res = await decoded_r.ts().range(
         1, 0, 10, aggregation_type="count", bucket_size_msec=10, align="+"
     )
-    assert [(0, 5.0), (5, 6.0)] == await modclient.ts().range(
+    assert_resp_response(decoded_r, res, [(0, 10.0), (10, 1.0)], [[0, 10.0], [10, 1.0]])
+    res = await decoded_r.ts().range(
         1, 0, 10, aggregation_type="count", bucket_size_msec=10, align=5
     )
-    assert [(0, 2.55), (10, 3.0)] == await modclient.ts().range(
+    assert_resp_response(decoded_r, res, [(0, 5.0), (5, 6.0)], [[0, 5.0], [5, 6.0]])
+    res = await decoded_r.ts().range(
         1, 0, 10, aggregation_type="twa", bucket_size_msec=10
     )
+    assert_resp_response(decoded_r, res, [(0, 2.55), (10, 3.0)], [[0, 2.55], [10, 3.0]])
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
-async def test_rev_range(modclient: redis.Redis):
+async def test_rev_range(decoded_r: redis.Redis):
     for i in range(100):
-        await modclient.ts().add(1, i, i % 7)
-    assert 100 == len(await modclient.ts().range(1, 0, 200))
+        await decoded_r.ts().add(1, i, i % 7)
+    assert 100 == len(await decoded_r.ts().range(1, 0, 200))
     for i in range(100):
-        await modclient.ts().add(1, i + 200, i % 7)
-    assert 200 == len(await modclient.ts().range(1, 0, 500))
+        await decoded_r.ts().add(1, i + 200, i % 7)
+    assert 200 == len(await decoded_r.ts().range(1, 0, 500))
     # first sample isn't returned
     assert 20 == len(
-        await modclient.ts().revrange(
+        await decoded_r.ts().revrange(
             1, 0, 500, aggregation_type="avg", bucket_size_msec=10
         )
     )
-    assert 10 == len(await modclient.ts().revrange(1, 0, 500, count=10))
+    assert 10 == len(await decoded_r.ts().revrange(1, 0, 500, count=10))
     assert 2 == len(
-        await modclient.ts().revrange(
+        await decoded_r.ts().revrange(
             1,
             0,
             500,
@@ -271,287 +297,471 @@ async def test_rev_range(modclient: redis.Redis):
             filter_by_max_value=2,
         )
     )
-    assert [(10, 1.0), (0, 10.0)] == await modclient.ts().revrange(
-        1, 0, 10, aggregation_type="count", bucket_size_msec=10, align="+"
+    assert_resp_response(
+        decoded_r,
+        await decoded_r.ts().revrange(
+            1, 0, 10, aggregation_type="count", bucket_size_msec=10, align="+"
+        ),
+        [(10, 1.0), (0, 10.0)],
+        [[10, 1.0], [0, 10.0]],
     )
-    assert [(1, 10.0), (0, 1.0)] == await modclient.ts().revrange(
-        1, 0, 10, aggregation_type="count", bucket_size_msec=10, align=1
+    assert_resp_response(
+        decoded_r,
+        await decoded_r.ts().revrange(
+            1, 0, 10, aggregation_type="count", bucket_size_msec=10, align=1
+        ),
+        [(1, 10.0), (0, 1.0)],
+        [[1, 10.0], [0, 1.0]],
     )
 
 
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
-async def testMultiRange(modclient: redis.Redis):
-    await modclient.ts().create(1, labels={"Test": "This", "team": "ny"})
-    await modclient.ts().create(
+async def test_multi_range(decoded_r: redis.Redis):
+    await decoded_r.ts().create(1, labels={"Test": "This", "team": "ny"})
+    await decoded_r.ts().create(
         2, labels={"Test": "This", "Taste": "That", "team": "sf"}
     )
     for i in range(100):
-        await modclient.ts().add(1, i, i % 7)
-        await modclient.ts().add(2, i, i % 11)
+        await decoded_r.ts().add(1, i, i % 7)
+        await decoded_r.ts().add(2, i, i % 11)
 
-    res = await modclient.ts().mrange(0, 200, filters=["Test=This"])
+    res = await decoded_r.ts().mrange(0, 200, filters=["Test=This"])
     assert 2 == len(res)
-    assert 100 == len(res[0]["1"][1])
+    if is_resp2_connection(decoded_r):
+        assert 100 == len(res[0]["1"][1])
 
-    res = await modclient.ts().mrange(0, 200, filters=["Test=This"], count=10)
-    assert 10 == len(res[0]["1"][1])
+        res = await decoded_r.ts().mrange(0, 200, filters=["Test=This"], count=10)
+        assert 10 == len(res[0]["1"][1])
 
-    for i in range(100):
-        await modclient.ts().add(1, i + 200, i % 7)
-    res = await modclient.ts().mrange(
-        0, 500, filters=["Test=This"], aggregation_type="avg", bucket_size_msec=10
-    )
-    assert 2 == len(res)
-    assert 20 == len(res[0]["1"][1])
+        for i in range(100):
+            await decoded_r.ts().add(1, i + 200, i % 7)
+        res = await decoded_r.ts().mrange(
+            0, 500, filters=["Test=This"], aggregation_type="avg", bucket_size_msec=10
+        )
+        assert 2 == len(res)
+        assert 20 == len(res[0]["1"][1])
+
+        # test withlabels
+        assert {} == res[0]["1"][0]
+        res = await decoded_r.ts().mrange(
+            0, 200, filters=["Test=This"], with_labels=True
+        )
+        assert {"Test": "This", "team": "ny"} == res[0]["1"][0]
+    else:
+        assert 100 == len(res["1"][2])
+
+        res = await decoded_r.ts().mrange(0, 200, filters=["Test=This"], count=10)
+        assert 10 == len(res["1"][2])
 
-    # test withlabels
-    assert {} == res[0]["1"][0]
-    res = await modclient.ts().mrange(0, 200, filters=["Test=This"], with_labels=True)
-    assert {"Test": "This", "team": "ny"} == res[0]["1"][0]
+        for i in range(100):
+            await decoded_r.ts().add(1, i + 200, i % 7)
+        res = await decoded_r.ts().mrange(
+            0, 500, filters=["Test=This"], aggregation_type="avg", bucket_size_msec=10
+        )
+        assert 2 == len(res)
+        assert 20 == len(res["1"][2])
+
+        # test withlabels
+        assert {} == res["1"][0]
+        res = await decoded_r.ts().mrange(
+            0, 200, filters=["Test=This"], with_labels=True
+        )
+        assert {"Test": "This", "team": "ny"} == res["1"][0]
 
 
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("99.99.99", "timeseries")
-async def test_multi_range_advanced(modclient: redis.Redis):
-    await modclient.ts().create(1, labels={"Test": "This", "team": "ny"})
-    await modclient.ts().create(
+async def test_multi_range_advanced(decoded_r: redis.Redis):
+    await decoded_r.ts().create(1, labels={"Test": "This", "team": "ny"})
+    await decoded_r.ts().create(
         2, labels={"Test": "This", "Taste": "That", "team": "sf"}
     )
     for i in range(100):
-        await modclient.ts().add(1, i, i % 7)
-        await modclient.ts().add(2, i, i % 11)
+        await decoded_r.ts().add(1, i, i % 7)
+        await decoded_r.ts().add(2, i, i % 11)
 
     # test with selected labels
-    res = await modclient.ts().mrange(
+    res = await decoded_r.ts().mrange(
         0, 200, filters=["Test=This"], select_labels=["team"]
     )
-    assert {"team": "ny"} == res[0]["1"][0]
-    assert {"team": "sf"} == res[1]["2"][0]
+    if is_resp2_connection(decoded_r):
+        assert {"team": "ny"} == res[0]["1"][0]
+        assert {"team": "sf"} == res[1]["2"][0]
 
-    # test with filterby
-    res = await modclient.ts().mrange(
-        0,
-        200,
-        filters=["Test=This"],
-        filter_by_ts=[i for i in range(10, 20)],
-        filter_by_min_value=1,
-        filter_by_max_value=2,
-    )
-    assert [(15, 1.0), (16, 2.0)] == res[0]["1"][1]
+        # test with filterby
+        res = await decoded_r.ts().mrange(
+            0,
+            200,
+            filters=["Test=This"],
+            filter_by_ts=[i for i in range(10, 20)],
+            filter_by_min_value=1,
+            filter_by_max_value=2,
+        )
+        assert [(15, 1.0), (16, 2.0)] == res[0]["1"][1]
 
-    # test groupby
-    res = await modclient.ts().mrange(
-        0, 3, filters=["Test=This"], groupby="Test", reduce="sum"
-    )
-    assert [(0, 0.0), (1, 2.0), (2, 4.0), (3, 6.0)] == res[0]["Test=This"][1]
-    res = await modclient.ts().mrange(
-        0, 3, filters=["Test=This"], groupby="Test", reduce="max"
-    )
-    assert [(0, 0.0), (1, 1.0), (2, 2.0), (3, 3.0)] == res[0]["Test=This"][1]
-    res = await modclient.ts().mrange(
-        0, 3, filters=["Test=This"], groupby="team", reduce="min"
-    )
-    assert 2 == len(res)
-    assert [(0, 0.0), (1, 1.0), (2, 2.0), (3, 3.0)] == res[0]["team=ny"][1]
-    assert [(0, 0.0), (1, 1.0), (2, 2.0), (3, 3.0)] == res[1]["team=sf"][1]
-
-    # test align
-    res = await modclient.ts().mrange(
-        0,
-        10,
-        filters=["team=ny"],
-        aggregation_type="count",
-        bucket_size_msec=10,
-        align="-",
-    )
-    assert [(0, 10.0), (10, 1.0)] == res[0]["1"][1]
-    res = await modclient.ts().mrange(
-        0,
-        10,
-        filters=["team=ny"],
-        aggregation_type="count",
-        bucket_size_msec=10,
-        align=5,
-    )
-    assert [(0, 5.0), (5, 6.0)] == res[0]["1"][1]
+        # test groupby
+        res = await decoded_r.ts().mrange(
+            0, 3, filters=["Test=This"], groupby="Test", reduce="sum"
+        )
+        assert [(0, 0.0), (1, 2.0), (2, 4.0), (3, 6.0)] == res[0]["Test=This"][1]
+        res = await decoded_r.ts().mrange(
+            0, 3, filters=["Test=This"], groupby="Test", reduce="max"
+        )
+        assert [(0, 0.0), (1, 1.0), (2, 2.0), (3, 3.0)] == res[0]["Test=This"][1]
+        res = await decoded_r.ts().mrange(
+            0, 3, filters=["Test=This"], groupby="team", reduce="min"
+        )
+        assert 2 == len(res)
+        assert [(0, 0.0), (1, 1.0), (2, 2.0), (3, 3.0)] == res[0]["team=ny"][1]
+        assert [(0, 0.0), (1, 1.0), (2, 2.0), (3, 3.0)] == res[1]["team=sf"][1]
+
+        # test align
+        res = await decoded_r.ts().mrange(
+            0,
+            10,
+            filters=["team=ny"],
+            aggregation_type="count",
+            bucket_size_msec=10,
+            align="-",
+        )
+        assert [(0, 10.0), (10, 1.0)] == res[0]["1"][1]
+        res = await decoded_r.ts().mrange(
+            0,
+            10,
+            filters=["team=ny"],
+            aggregation_type="count",
+            bucket_size_msec=10,
+            align=5,
+        )
+        assert [(0, 5.0), (5, 6.0)] == res[0]["1"][1]
+    else:
+        assert {"team": "ny"} == res["1"][0]
+        assert {"team": "sf"} == res["2"][0]
+
+        # test with filterby
+        res = await decoded_r.ts().mrange(
+            0,
+            200,
+            filters=["Test=This"],
+            filter_by_ts=[i for i in range(10, 20)],
+            filter_by_min_value=1,
+            filter_by_max_value=2,
+        )
+        assert [[15, 1.0], [16, 2.0]] == res["1"][2]
+
+        # test groupby
+        res = await decoded_r.ts().mrange(
+            0, 3, filters=["Test=This"], groupby="Test", reduce="sum"
+        )
+        assert [[0, 0.0], [1, 2.0], [2, 4.0], [3, 6.0]] == res["Test=This"][3]
+        res = await decoded_r.ts().mrange(
+            0, 3, filters=["Test=This"], groupby="Test", reduce="max"
+        )
+        assert [[0, 0.0], [1, 1.0], [2, 2.0], [3, 3.0]] == res["Test=This"][3]
+        res = await decoded_r.ts().mrange(
+            0, 3, filters=["Test=This"], groupby="team", reduce="min"
+        )
+        assert 2 == len(res)
+        assert [[0, 0.0], [1, 1.0], [2, 2.0], [3, 3.0]] == res["team=ny"][3]
+        assert [[0, 0.0], [1, 1.0], [2, 2.0], [3, 3.0]] == res["team=sf"][3]
+
+        # test align
+        res = await decoded_r.ts().mrange(
+            0,
+            10,
+            filters=["team=ny"],
+            aggregation_type="count",
+            bucket_size_msec=10,
+            align="-",
+        )
+        assert [[0, 10.0], [10, 1.0]] == res["1"][2]
+        res = await decoded_r.ts().mrange(
+            0,
+            10,
+            filters=["team=ny"],
+            aggregation_type="count",
+            bucket_size_msec=10,
+            align=5,
+        )
+        assert [[0, 5.0], [5, 6.0]] == res["1"][2]
 
 
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("99.99.99", "timeseries")
-async def test_multi_reverse_range(modclient: redis.Redis):
-    await modclient.ts().create(1, labels={"Test": "This", "team": "ny"})
-    await modclient.ts().create(
+async def test_multi_reverse_range(decoded_r: redis.Redis):
+    await decoded_r.ts().create(1, labels={"Test": "This", "team": "ny"})
+    await decoded_r.ts().create(
         2, labels={"Test": "This", "Taste": "That", "team": "sf"}
     )
     for i in range(100):
-        await modclient.ts().add(1, i, i % 7)
-        await modclient.ts().add(2, i, i % 11)
+        await decoded_r.ts().add(1, i, i % 7)
+        await decoded_r.ts().add(2, i, i % 11)
 
-    res = await modclient.ts().mrange(0, 200, filters=["Test=This"])
+    res = await decoded_r.ts().mrange(0, 200, filters=["Test=This"])
     assert 2 == len(res)
-    assert 100 == len(res[0]["1"][1])
+    if is_resp2_connection(decoded_r):
+        assert 100 == len(res[0]["1"][1])
 
-    res = await modclient.ts().mrange(0, 200, filters=["Test=This"], count=10)
-    assert 10 == len(res[0]["1"][1])
+        res = await decoded_r.ts().mrange(0, 200, filters=["Test=This"], count=10)
+        assert 10 == len(res[0]["1"][1])
 
-    for i in range(100):
-        await modclient.ts().add(1, i + 200, i % 7)
-    res = await modclient.ts().mrevrange(
-        0, 500, filters=["Test=This"], aggregation_type="avg", bucket_size_msec=10
-    )
-    assert 2 == len(res)
-    assert 20 == len(res[0]["1"][1])
-    assert {} == res[0]["1"][0]
+        for i in range(100):
+            await decoded_r.ts().add(1, i + 200, i % 7)
+        res = await decoded_r.ts().mrevrange(
+            0, 500, filters=["Test=This"], aggregation_type="avg", bucket_size_msec=10
+        )
+        assert 2 == len(res)
+        assert 20 == len(res[0]["1"][1])
+        assert {} == res[0]["1"][0]
 
-    # test withlabels
-    res = await modclient.ts().mrevrange(
-        0, 200, filters=["Test=This"], with_labels=True
-    )
-    assert {"Test": "This", "team": "ny"} == res[0]["1"][0]
+        # test withlabels
+        res = await decoded_r.ts().mrevrange(
+            0, 200, filters=["Test=This"], with_labels=True
+        )
+        assert {"Test": "This", "team": "ny"} == res[0]["1"][0]
 
-    # test with selected labels
-    res = await modclient.ts().mrevrange(
-        0, 200, filters=["Test=This"], select_labels=["team"]
-    )
-    assert {"team": "ny"} == res[0]["1"][0]
-    assert {"team": "sf"} == res[1]["2"][0]
+        # test with selected labels
+        res = await decoded_r.ts().mrevrange(
+            0, 200, filters=["Test=This"], select_labels=["team"]
+        )
+        assert {"team": "ny"} == res[0]["1"][0]
+        assert {"team": "sf"} == res[1]["2"][0]
 
-    # test filterby
-    res = await modclient.ts().mrevrange(
-        0,
-        200,
-        filters=["Test=This"],
-        filter_by_ts=[i for i in range(10, 20)],
-        filter_by_min_value=1,
-        filter_by_max_value=2,
-    )
-    assert [(16, 2.0), (15, 1.0)] == res[0]["1"][1]
+        # test filterby
+        res = await decoded_r.ts().mrevrange(
+            0,
+            200,
+            filters=["Test=This"],
+            filter_by_ts=[i for i in range(10, 20)],
+            filter_by_min_value=1,
+            filter_by_max_value=2,
+        )
+        assert [(16, 2.0), (15, 1.0)] == res[0]["1"][1]
 
-    # test groupby
-    res = await modclient.ts().mrevrange(
-        0, 3, filters=["Test=This"], groupby="Test", reduce="sum"
-    )
-    assert [(3, 6.0), (2, 4.0), (1, 2.0), (0, 0.0)] == res[0]["Test=This"][1]
-    res = await modclient.ts().mrevrange(
-        0, 3, filters=["Test=This"], groupby="Test", reduce="max"
-    )
-    assert [(3, 3.0), (2, 2.0), (1, 1.0), (0, 0.0)] == res[0]["Test=This"][1]
-    res = await modclient.ts().mrevrange(
-        0, 3, filters=["Test=This"], groupby="team", reduce="min"
-    )
-    assert 2 == len(res)
-    assert [(3, 3.0), (2, 2.0), (1, 1.0), (0, 0.0)] == res[0]["team=ny"][1]
-    assert [(3, 3.0), (2, 2.0), (1, 1.0), (0, 0.0)] == res[1]["team=sf"][1]
-
-    # test align
-    res = await modclient.ts().mrevrange(
-        0,
-        10,
-        filters=["team=ny"],
-        aggregation_type="count",
-        bucket_size_msec=10,
-        align="-",
-    )
-    assert [(10, 1.0), (0, 10.0)] == res[0]["1"][1]
-    res = await modclient.ts().mrevrange(
-        0,
-        10,
-        filters=["team=ny"],
-        aggregation_type="count",
-        bucket_size_msec=10,
-        align=1,
-    )
-    assert [(1, 10.0), (0, 1.0)] == res[0]["1"][1]
+        # test groupby
+        res = await decoded_r.ts().mrevrange(
+            0, 3, filters=["Test=This"], groupby="Test", reduce="sum"
+        )
+        assert [(3, 6.0), (2, 4.0), (1, 2.0), (0, 0.0)] == res[0]["Test=This"][1]
+        res = await decoded_r.ts().mrevrange(
+            0, 3, filters=["Test=This"], groupby="Test", reduce="max"
+        )
+        assert [(3, 3.0), (2, 2.0), (1, 1.0), (0, 0.0)] == res[0]["Test=This"][1]
+        res = await decoded_r.ts().mrevrange(
+            0, 3, filters=["Test=This"], groupby="team", reduce="min"
+        )
+        assert 2 == len(res)
+        assert [(3, 3.0), (2, 2.0), (1, 1.0), (0, 0.0)] == res[0]["team=ny"][1]
+        assert [(3, 3.0), (2, 2.0), (1, 1.0), (0, 0.0)] == res[1]["team=sf"][1]
+
+        # test align
+        res = await decoded_r.ts().mrevrange(
+            0,
+            10,
+            filters=["team=ny"],
+            aggregation_type="count",
+            bucket_size_msec=10,
+            align="-",
+        )
+        assert [(10, 1.0), (0, 10.0)] == res[0]["1"][1]
+        res = await decoded_r.ts().mrevrange(
+            0,
+            10,
+            filters=["team=ny"],
+            aggregation_type="count",
+            bucket_size_msec=10,
+            align=1,
+        )
+        assert [(1, 10.0), (0, 1.0)] == res[0]["1"][1]
+    else:
+        assert 100 == len(res["1"][2])
+
+        res = await decoded_r.ts().mrange(0, 200, filters=["Test=This"], count=10)
+        assert 10 == len(res["1"][2])
+
+        for i in range(100):
+            await decoded_r.ts().add(1, i + 200, i % 7)
+        res = await decoded_r.ts().mrevrange(
+            0, 500, filters=["Test=This"], aggregation_type="avg", bucket_size_msec=10
+        )
+        assert 2 == len(res)
+        assert 20 == len(res["1"][2])
+        assert {} == res["1"][0]
+
+        # test withlabels
+        res = await decoded_r.ts().mrevrange(
+            0, 200, filters=["Test=This"], with_labels=True
+        )
+        assert {"Test": "This", "team": "ny"} == res["1"][0]
+
+        # test with selected labels
+        res = await decoded_r.ts().mrevrange(
+            0, 200, filters=["Test=This"], select_labels=["team"]
+        )
+        assert {"team": "ny"} == res["1"][0]
+        assert {"team": "sf"} == res["2"][0]
+
+        # test filterby
+        res = await decoded_r.ts().mrevrange(
+            0,
+            200,
+            filters=["Test=This"],
+            filter_by_ts=[i for i in range(10, 20)],
+            filter_by_min_value=1,
+            filter_by_max_value=2,
+        )
+        assert [[16, 2.0], [15, 1.0]] == res["1"][2]
+
+        # test groupby
+        res = await decoded_r.ts().mrevrange(
+            0, 3, filters=["Test=This"], groupby="Test", reduce="sum"
+        )
+        assert [[3, 6.0], [2, 4.0], [1, 2.0], [0, 0.0]] == res["Test=This"][3]
+        res = await decoded_r.ts().mrevrange(
+            0, 3, filters=["Test=This"], groupby="Test", reduce="max"
+        )
+        assert [[3, 3.0], [2, 2.0], [1, 1.0], [0, 0.0]] == res["Test=This"][3]
+        res = await decoded_r.ts().mrevrange(
+            0, 3, filters=["Test=This"], groupby="team", reduce="min"
+        )
+        assert 2 == len(res)
+        assert [[3, 3.0], [2, 2.0], [1, 1.0], [0, 0.0]] == res["team=ny"][3]
+        assert [[3, 3.0], [2, 2.0], [1, 1.0], [0, 0.0]] == res["team=sf"][3]
+
+        # test align
+        res = await decoded_r.ts().mrevrange(
+            0,
+            10,
+            filters=["team=ny"],
+            aggregation_type="count",
+            bucket_size_msec=10,
+            align="-",
+        )
+        assert [[10, 1.0], [0, 10.0]] == res["1"][2]
+        res = await decoded_r.ts().mrevrange(
+            0,
+            10,
+            filters=["team=ny"],
+            aggregation_type="count",
+            bucket_size_msec=10,
+            align=1,
+        )
+        assert [[1, 10.0], [0, 1.0]] == res["1"][2]
 
 
 @pytest.mark.redismod
-async def test_get(modclient: redis.Redis):
+async def test_get(decoded_r: redis.Redis):
     name = "test"
-    await modclient.ts().create(name)
-    assert await modclient.ts().get(name) is None
-    await modclient.ts().add(name, 2, 3)
-    assert 2 == (await modclient.ts().get(name))[0]
-    await modclient.ts().add(name, 3, 4)
-    assert 4 == (await modclient.ts().get(name))[1]
+    await decoded_r.ts().create(name)
+    assert not await decoded_r.ts().get(name)
+    await decoded_r.ts().add(name, 2, 3)
+    assert 2 == (await decoded_r.ts().get(name))[0]
+    await decoded_r.ts().add(name, 3, 4)
+    assert 4 == (await decoded_r.ts().get(name))[1]
 
 
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
-async def test_mget(modclient: redis.Redis):
-    await modclient.ts().create(1, labels={"Test": "This"})
-    await modclient.ts().create(2, labels={"Test": "This", "Taste": "That"})
-    act_res = await modclient.ts().mget(["Test=This"])
+async def test_mget(decoded_r: redis.Redis):
+    await decoded_r.ts().create(1, labels={"Test": "This"})
+    await decoded_r.ts().create(2, labels={"Test": "This", "Taste": "That"})
+    act_res = await decoded_r.ts().mget(["Test=This"])
     exp_res = [{"1": [{}, None, None]}, {"2": [{}, None, None]}]
-    assert act_res == exp_res
-    await modclient.ts().add(1, "*", 15)
-    await modclient.ts().add(2, "*", 25)
-    res = await modclient.ts().mget(["Test=This"])
-    assert 15 == res[0]["1"][2]
-    assert 25 == res[1]["2"][2]
-    res = await modclient.ts().mget(["Taste=That"])
-    assert 25 == res[0]["2"][2]
+    exp_res_resp3 = {"1": [{}, []], "2": [{}, []]}
+    assert_resp_response(decoded_r, act_res, exp_res, exp_res_resp3)
+    await decoded_r.ts().add(1, "*", 15)
+    await decoded_r.ts().add(2, "*", 25)
+    res = await decoded_r.ts().mget(["Test=This"])
+    if is_resp2_connection(decoded_r):
+        assert 15 == res[0]["1"][2]
+        assert 25 == res[1]["2"][2]
+    else:
+        assert 15 == res["1"][1][1]
+        assert 25 == res["2"][1][1]
+    res = await decoded_r.ts().mget(["Taste=That"])
+    if is_resp2_connection(decoded_r):
+        assert 25 == res[0]["2"][2]
+    else:
+        assert 25 == res["2"][1][1]
 
     # test with_labels
-    assert {} == res[0]["2"][0]
-    res = await modclient.ts().mget(["Taste=That"], with_labels=True)
-    assert {"Taste": "That", "Test": "This"} == res[0]["2"][0]
+    if is_resp2_connection(decoded_r):
+        assert {} == res[0]["2"][0]
+    else:
+        assert {} == res["2"][0]
+    res = await decoded_r.ts().mget(["Taste=That"], with_labels=True)
+    if is_resp2_connection(decoded_r):
+        assert {"Taste": "That", "Test": "This"} == res[0]["2"][0]
+    else:
+        assert {"Taste": "That", "Test": "This"} == res["2"][0]
 
 
 @pytest.mark.redismod
-async def test_info(modclient: redis.Redis):
-    await modclient.ts().create(
+async def test_info(decoded_r: redis.Redis):
+    await decoded_r.ts().create(
         1, retention_msecs=5, labels={"currentLabel": "currentData"}
     )
-    info = await modclient.ts().info(1)
-    assert 5 == info.retention_msecs
-    assert info.labels["currentLabel"] == "currentData"
+    info = await decoded_r.ts().info(1)
+    assert_resp_response(
+        decoded_r, 5, info.get("retention_msecs"), info.get("retentionTime")
+    )
+    assert info["labels"]["currentLabel"] == "currentData"
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
-async def testInfoDuplicatePolicy(modclient: redis.Redis):
-    await modclient.ts().create(
+async def testInfoDuplicatePolicy(decoded_r: redis.Redis):
+    await decoded_r.ts().create(
         1, retention_msecs=5, labels={"currentLabel": "currentData"}
     )
-    info = await modclient.ts().info(1)
-    assert info.duplicate_policy is None
+    info = await decoded_r.ts().info(1)
+    assert_resp_response(
+        decoded_r, None, info.get("duplicate_policy"), info.get("duplicatePolicy")
+    )
 
-    await modclient.ts().create("time-serie-2", duplicate_policy="min")
-    info = await modclient.ts().info("time-serie-2")
-    assert "min" == info.duplicate_policy
+    await decoded_r.ts().create("time-serie-2", duplicate_policy="min")
+    info = await decoded_r.ts().info("time-serie-2")
+    assert_resp_response(
+        decoded_r, "min", info.get("duplicate_policy"), info.get("duplicatePolicy")
+    )
 
 
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
-async def test_query_index(modclient: redis.Redis):
-    await modclient.ts().create(1, labels={"Test": "This"})
-    await modclient.ts().create(2, labels={"Test": "This", "Taste": "That"})
-    assert 2 == len(await modclient.ts().queryindex(["Test=This"]))
-    assert 1 == len(await modclient.ts().queryindex(["Taste=That"]))
-    assert [2] == await modclient.ts().queryindex(["Taste=That"])
+async def test_query_index(decoded_r: redis.Redis):
+    await decoded_r.ts().create(1, labels={"Test": "This"})
+    await decoded_r.ts().create(2, labels={"Test": "This", "Taste": "That"})
+    assert 2 == len(await decoded_r.ts().queryindex(["Test=This"]))
+    assert 1 == len(await decoded_r.ts().queryindex(["Taste=That"]))
+    assert_resp_response(
+        decoded_r, await decoded_r.ts().queryindex(["Taste=That"]), [2], {"2"}
+    )
 
 
 # @pytest.mark.redismod
-# async def test_pipeline(modclient: redis.Redis):
-#     pipeline = await modclient.ts().pipeline()
+# async def test_pipeline(r: redis.Redis):
+#     pipeline = await r.ts().pipeline()
 #     pipeline.create("with_pipeline")
 #     for i in range(100):
 #         pipeline.add("with_pipeline", i, 1.1 * i)
 #     pipeline.execute()
 
-#     info = await modclient.ts().info("with_pipeline")
+#     info = await r.ts().info("with_pipeline")
 #     assert info.lastTimeStamp == 99
 #     assert info.total_samples == 100
-#     assert await modclient.ts().get("with_pipeline")[1] == 99 * 1.1
+#     assert await r.ts().get("with_pipeline")[1] == 99 * 1.1
 
 
 @pytest.mark.redismod
-async def test_uncompressed(modclient: redis.Redis):
-    await modclient.ts().create("compressed")
-    await modclient.ts().create("uncompressed", uncompressed=True)
-    compressed_info = await modclient.ts().info("compressed")
-    uncompressed_info = await modclient.ts().info("uncompressed")
-    assert compressed_info.memory_usage != uncompressed_info.memory_usage
+async def test_uncompressed(decoded_r: redis.Redis):
+    await decoded_r.ts().create("compressed")
+    await decoded_r.ts().create("uncompressed", uncompressed=True)
+    compressed_info = await decoded_r.ts().info("compressed")
+    uncompressed_info = await decoded_r.ts().info("uncompressed")
+    if is_resp2_connection(decoded_r):
+        assert compressed_info.memory_usage != uncompressed_info.memory_usage
+    else:
+        assert compressed_info["memoryUsage"] != uncompressed_info["memoryUsage"]
diff --git a/tests/test_bloom.py b/tests/test_bloom.py
index 30d3219404..a82fece470 100644
--- a/tests/test_bloom.py
+++ b/tests/test_bloom.py
@@ -1,12 +1,11 @@
 from math import inf
 
 import pytest
-
 import redis.commands.bf
 from redis.exceptions import ModuleError, RedisError
 from redis.utils import HIREDIS_AVAILABLE
 
-from .conftest import skip_ifmodversion_lt
+from .conftest import assert_resp_response, is_resp2_connection, skip_ifmodversion_lt
 
 
 def intlist(obj):
@@ -14,15 +13,15 @@ def intlist(obj):
 
 
 @pytest.fixture
-def client(modclient):
-    assert isinstance(modclient.bf(), redis.commands.bf.BFBloom)
-    assert isinstance(modclient.cf(), redis.commands.bf.CFBloom)
-    assert isinstance(modclient.cms(), redis.commands.bf.CMSBloom)
-    assert isinstance(modclient.tdigest(), redis.commands.bf.TDigestBloom)
-    assert isinstance(modclient.topk(), redis.commands.bf.TOPKBloom)
+def client(decoded_r):
+    assert isinstance(decoded_r.bf(), redis.commands.bf.BFBloom)
+    assert isinstance(decoded_r.cf(), redis.commands.bf.CFBloom)
+    assert isinstance(decoded_r.cms(), redis.commands.bf.CMSBloom)
+    assert isinstance(decoded_r.tdigest(), redis.commands.bf.TDigestBloom)
+    assert isinstance(decoded_r.topk(), redis.commands.bf.TOPKBloom)
 
-    modclient.flushdb()
-    return modclient
+    decoded_r.flushdb()
+    return decoded_r
 
 
 @pytest.mark.redismod
@@ -61,7 +60,6 @@ def test_tdigest_create(client):
     assert client.tdigest().create("tDigest", 100)
 
 
-# region Test Bloom Filter
 @pytest.mark.redismod
 def test_bf_add(client):
     assert client.bf().create("bloom", 0.01, 1000)
@@ -86,9 +84,24 @@ def test_bf_insert(client):
     assert 0 == client.bf().exists("bloom", "noexist")
     assert [1, 0] == intlist(client.bf().mexists("bloom", "foo", "noexist"))
     info = client.bf().info("bloom")
-    assert 2 == info.insertedNum
-    assert 1000 == info.capacity
-    assert 1 == info.filterNum
+    assert_resp_response(
+        client,
+        2,
+        info.get("insertedNum"),
+        info.get("Number of items inserted"),
+    )
+    assert_resp_response(
+        client,
+        1000,
+        info.get("capacity"),
+        info.get("Capacity"),
+    )
+    assert_resp_response(
+        client,
+        1,
+        info.get("filterNum"),
+        info.get("Number of filters"),
+    )
 
 
 @pytest.mark.redismod
@@ -149,11 +162,21 @@ def test_bf_info(client):
     # Store a filter
     client.bf().create("nonscaling", "0.0001", "1000", noScale=True)
     info = client.bf().info("nonscaling")
-    assert info.expansionRate is None
+    assert_resp_response(
+        client,
+        None,
+        info.get("expansionRate"),
+        info.get("Expansion rate"),
+    )
 
     client.bf().create("expanding", "0.0001", "1000", expansion=expansion)
     info = client.bf().info("expanding")
-    assert info.expansionRate == 4
+    assert_resp_response(
+        client,
+        4,
+        info.get("expansionRate"),
+        info.get("Expansion rate"),
+    )
 
     try:
         # noScale mean no expansion
@@ -180,7 +203,6 @@ def test_bf_card(client):
         client.bf().card("setKey")
 
 
-# region Test Cuckoo Filter
 @pytest.mark.redismod
 def test_cf_add_and_insert(client):
     assert client.cf().create("cuckoo", 1000)
@@ -196,9 +218,15 @@ def test_cf_add_and_insert(client):
     assert [1] == client.cf().insert("empty1", ["foo"], capacity=1000)
     assert [1] == client.cf().insertnx("empty2", ["bar"], capacity=1000)
     info = client.cf().info("captest")
-    assert 5 == info.insertedNum
-    assert 0 == info.deletedNum
-    assert 1 == info.filterNum
+    assert_resp_response(
+        client, 5, info.get("insertedNum"), info.get("Number of items inserted")
+    )
+    assert_resp_response(
+        client, 0, info.get("deletedNum"), info.get("Number of items deleted")
+    )
+    assert_resp_response(
+        client, 1, info.get("filterNum"), info.get("Number of filters")
+    )
 
 
 @pytest.mark.redismod
@@ -214,7 +242,6 @@ def test_cf_exists_and_del(client):
     assert 0 == client.cf().count("cuckoo", "filter")
 
 
-# region Test Count-Min Sketch
 @pytest.mark.redismod
 def test_cms(client):
     assert client.cms().initbydim("dim", 1000, 5)
@@ -225,9 +252,10 @@ def test_cms(client):
     assert [10, 15] == client.cms().incrby("dim", ["foo", "bar"], [5, 15])
     assert [10, 15] == client.cms().query("dim", "foo", "bar")
     info = client.cms().info("dim")
-    assert 1000 == info.width
-    assert 5 == info.depth
-    assert 25 == info.count
+    assert info["width"]
+    assert 1000 == info["width"]
+    assert 5 == info["depth"]
+    assert 25 == info["count"]
 
 
 @pytest.mark.redismod
@@ -248,10 +276,6 @@ def test_cms_merge(client):
     assert [16, 15, 21] == client.cms().query("C", "foo", "bar", "baz")
 
 
-# endregion
-
-
-# region Test Top-K
 @pytest.mark.redismod
 def test_topk(client):
     # test list with empty buckets
@@ -326,10 +350,10 @@ def test_topk(client):
     assert ["A", "B", "E"] == client.topk().list("topklist")
     assert ["A", 4, "B", 3, "E", 3] == client.topk().list("topklist", withcount=True)
     info = client.topk().info("topklist")
-    assert 3 == info.k
-    assert 50 == info.width
-    assert 3 == info.depth
-    assert 0.9 == round(float(info.decay), 1)
+    assert 3 == info["k"]
+    assert 50 == info["width"]
+    assert 3 == info["depth"]
+    assert 0.9 == round(float(info["decay"]), 1)
 
 
 @pytest.mark.redismod
@@ -346,7 +370,6 @@ def test_topk_incrby(client):
         )
 
 
-# region Test T-Digest
 @pytest.mark.redismod
 @pytest.mark.experimental
 def test_tdigest_reset(client):
@@ -357,8 +380,11 @@ def test_tdigest_reset(client):
     assert client.tdigest().add("tDigest", list(range(10)))
 
     assert client.tdigest().reset("tDigest")
-    # assert we have 0 unmerged nodes
-    assert 0 == client.tdigest().info("tDigest").unmerged_nodes
+    # assert we have 0 unmerged
+    info = client.tdigest().info("tDigest")
+    assert_resp_response(
+        client, 0, info.get("unmerged_nodes"), info.get("Unmerged nodes")
+    )
 
 
 @pytest.mark.redismod
@@ -373,8 +399,10 @@ def test_tdigest_merge(client):
     assert client.tdigest().merge("to-tDigest", 1, "from-tDigest")
     # we should now have 110 weight on to-histogram
     info = client.tdigest().info("to-tDigest")
-    total_weight_to = float(info.merged_weight) + float(info.unmerged_weight)
-    assert 20 == total_weight_to
+    if is_resp2_connection(client):
+        assert 20 == float(info["merged_weight"]) + float(info["unmerged_weight"])
+    else:
+        assert 20 == float(info["Merged weight"]) + float(info["Unmerged weight"])
     # test override
     assert client.tdigest().create("from-override", 10)
     assert client.tdigest().create("from-override-2", 10)
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 705e753bd6..31c31026be 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -10,8 +10,8 @@
 from unittest.mock import DEFAULT, Mock, call, patch
 
 import pytest
-
 from redis import Redis
+from redis._parsers import CommandsParser
 from redis.backoff import ExponentialBackoff, NoBackoff, default_backoff
 from redis.cluster import (
     PRIMARY,
@@ -22,7 +22,6 @@
     RedisCluster,
     get_node_name,
 )
-from redis.commands import CommandsParser
 from redis.connection import BlockingConnectionPool, Connection, ConnectionPool
 from redis.crc import key_slot
 from redis.exceptions import (
@@ -43,6 +42,7 @@
 
 from .conftest import (
     _get_client,
+    assert_resp_response,
     skip_if_redis_enterprise,
     skip_if_server_version_lt,
     skip_unless_arch_bits,
@@ -1000,7 +1000,7 @@ def test_client_setname(self, r):
         node = r.get_random_node()
         r.client_setname("redis_py_test", target_nodes=node)
         client_name = r.client_getname(target_nodes=node)
-        assert client_name == "redis_py_test"
+        assert_resp_response(r, client_name, "redis_py_test", b"redis_py_test")
 
     def test_exists(self, r):
         d = {"a": b"1", "b": b"2", "c": b"3", "d": b"4"}
@@ -1595,7 +1595,7 @@ def test_client_trackinginfo(self, r):
         node = r.get_primaries()[0]
         res = r.client_trackinginfo(target_nodes=node)
         assert len(res) > 2
-        assert "prefixes" in res
+        assert "prefixes" in res or b"prefixes" in res
 
     @skip_if_server_version_lt("2.9.50")
     def test_client_pause(self, r):
@@ -1757,24 +1757,68 @@ def test_cluster_renamenx(self, r):
     def test_cluster_blpop(self, r):
         r.rpush("{foo}a", "1", "2")
         r.rpush("{foo}b", "3", "4")
-        assert r.blpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"3")
-        assert r.blpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"4")
-        assert r.blpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"1")
-        assert r.blpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"2")
+        assert_resp_response(
+            r,
+            r.blpop(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}b", b"3"),
+            [b"{foo}b", b"3"],
+        )
+        assert_resp_response(
+            r,
+            r.blpop(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}b", b"4"),
+            [b"{foo}b", b"4"],
+        )
+        assert_resp_response(
+            r,
+            r.blpop(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}a", b"1"),
+            [b"{foo}a", b"1"],
+        )
+        assert_resp_response(
+            r,
+            r.blpop(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}a", b"2"),
+            [b"{foo}a", b"2"],
+        )
         assert r.blpop(["{foo}b", "{foo}a"], timeout=1) is None
         r.rpush("{foo}c", "1")
-        assert r.blpop("{foo}c", timeout=1) == (b"{foo}c", b"1")
+        assert_resp_response(
+            r, r.blpop("{foo}c", timeout=1), (b"{foo}c", b"1"), [b"{foo}c", b"1"]
+        )
 
     def test_cluster_brpop(self, r):
         r.rpush("{foo}a", "1", "2")
         r.rpush("{foo}b", "3", "4")
-        assert r.brpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"4")
-        assert r.brpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"3")
-        assert r.brpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"2")
-        assert r.brpop(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"1")
+        assert_resp_response(
+            r,
+            r.brpop(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}b", b"4"),
+            [b"{foo}b", b"4"],
+        )
+        assert_resp_response(
+            r,
+            r.brpop(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}b", b"3"),
+            [b"{foo}b", b"3"],
+        )
+        assert_resp_response(
+            r,
+            r.brpop(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}a", b"2"),
+            [b"{foo}a", b"2"],
+        )
+        assert_resp_response(
+            r,
+            r.brpop(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}a", b"1"),
+            [b"{foo}a", b"1"],
+        )
         assert r.brpop(["{foo}b", "{foo}a"], timeout=1) is None
         r.rpush("{foo}c", "1")
-        assert r.brpop("{foo}c", timeout=1) == (b"{foo}c", b"1")
+        assert_resp_response(
+            r, r.brpop("{foo}c", timeout=1), (b"{foo}c", b"1"), [b"{foo}c", b"1"]
+        )
 
     def test_cluster_brpoplpush(self, r):
         r.rpush("{foo}a", "1", "2")
@@ -1847,7 +1891,13 @@ def test_cluster_zdiff(self, r):
         r.zadd("{foo}a", {"a1": 1, "a2": 2, "a3": 3})
         r.zadd("{foo}b", {"a1": 1, "a2": 2})
         assert r.zdiff(["{foo}a", "{foo}b"]) == [b"a3"]
-        assert r.zdiff(["{foo}a", "{foo}b"], withscores=True) == [b"a3", b"3"]
+        response = r.zdiff(["{foo}a", "{foo}b"], withscores=True)
+        assert_resp_response(
+            r,
+            response,
+            [b"a3", b"3"],
+            [[b"a3", 3.0]],
+        )
 
     @skip_if_server_version_lt("6.2.0")
     def test_cluster_zdiffstore(self, r):
@@ -1855,7 +1905,8 @@ def test_cluster_zdiffstore(self, r):
         r.zadd("{foo}b", {"a1": 1, "a2": 2})
         assert r.zdiffstore("{foo}out", ["{foo}a", "{foo}b"])
         assert r.zrange("{foo}out", 0, -1) == [b"a3"]
-        assert r.zrange("{foo}out", 0, -1, withscores=True) == [(b"a3", 3.0)]
+        response = r.zrange("{foo}out", 0, -1, withscores=True)
+        assert_resp_response(r, response, [(b"a3", 3.0)], [[b"a3", 3.0]])
 
     @skip_if_server_version_lt("6.2.0")
     def test_cluster_zinter(self, r):
@@ -1866,31 +1917,42 @@ def test_cluster_zinter(self, r):
         # invalid aggregation
         with pytest.raises(DataError):
             r.zinter(["{foo}a", "{foo}b", "{foo}c"], aggregate="foo", withscores=True)
-        # aggregate with SUM
-        assert r.zinter(["{foo}a", "{foo}b", "{foo}c"], withscores=True) == [
-            (b"a3", 8),
-            (b"a1", 9),
-        ]
-        # aggregate with MAX
-        assert r.zinter(
-            ["{foo}a", "{foo}b", "{foo}c"], aggregate="MAX", withscores=True
-        ) == [(b"a3", 5), (b"a1", 6)]
-        # aggregate with MIN
-        assert r.zinter(
-            ["{foo}a", "{foo}b", "{foo}c"], aggregate="MIN", withscores=True
-        ) == [(b"a1", 1), (b"a3", 1)]
-        # with weights
-        assert r.zinter({"{foo}a": 1, "{foo}b": 2, "{foo}c": 3}, withscores=True) == [
-            (b"a3", 20),
-            (b"a1", 23),
-        ]
+        assert_resp_response(
+            r,
+            r.zinter(["{foo}a", "{foo}b", "{foo}c"], withscores=True),
+            [(b"a3", 8), (b"a1", 9)],
+            [[b"a3", 8], [b"a1", 9]],
+        )
+        assert_resp_response(
+            r,
+            r.zinter(["{foo}a", "{foo}b", "{foo}c"], withscores=True, aggregate="MAX"),
+            [(b"a3", 5), (b"a1", 6)],
+            [[b"a3", 5], [b"a1", 6]],
+        )
+        assert_resp_response(
+            r,
+            r.zinter(["{foo}a", "{foo}b", "{foo}c"], withscores=True, aggregate="MIN"),
+            [(b"a1", 1), (b"a3", 1)],
+            [[b"a1", 1], [b"a3", 1]],
+        )
+        assert_resp_response(
+            r,
+            r.zinter({"{foo}a": 1, "{foo}b": 2, "{foo}c": 3}, withscores=True),
+            [(b"a3", 20.0), (b"a1", 23.0)],
+            [[b"a3", 20.0], [b"a1", 23.0]],
+        )
 
     def test_cluster_zinterstore_sum(self, r):
         r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
         r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
         r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
         assert r.zinterstore("{foo}d", ["{foo}a", "{foo}b", "{foo}c"]) == 2
-        assert r.zrange("{foo}d", 0, -1, withscores=True) == [(b"a3", 8), (b"a1", 9)]
+        assert_resp_response(
+            r,
+            r.zrange("{foo}d", 0, -1, withscores=True),
+            [(b"a3", 8), (b"a1", 9)],
+            [[b"a3", 8.0], [b"a1", 9.0]],
+        )
 
     def test_cluster_zinterstore_max(self, r):
         r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
@@ -1900,7 +1962,12 @@ def test_cluster_zinterstore_max(self, r):
             r.zinterstore("{foo}d", ["{foo}a", "{foo}b", "{foo}c"], aggregate="MAX")
             == 2
         )
-        assert r.zrange("{foo}d", 0, -1, withscores=True) == [(b"a3", 5), (b"a1", 6)]
+        assert_resp_response(
+            r,
+            r.zrange("{foo}d", 0, -1, withscores=True),
+            [(b"a3", 5), (b"a1", 6)],
+            [[b"a3", 5.0], [b"a1", 6.0]],
+        )
 
     def test_cluster_zinterstore_min(self, r):
         r.zadd("{foo}a", {"a1": 1, "a2": 2, "a3": 3})
@@ -1910,38 +1977,98 @@ def test_cluster_zinterstore_min(self, r):
             r.zinterstore("{foo}d", ["{foo}a", "{foo}b", "{foo}c"], aggregate="MIN")
             == 2
         )
-        assert r.zrange("{foo}d", 0, -1, withscores=True) == [(b"a1", 1), (b"a3", 3)]
+        assert_resp_response(
+            r,
+            r.zrange("{foo}d", 0, -1, withscores=True),
+            [(b"a1", 1), (b"a3", 3)],
+            [[b"a1", 1.0], [b"a3", 3.0]],
+        )
 
     def test_cluster_zinterstore_with_weight(self, r):
         r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
         r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
         r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
         assert r.zinterstore("{foo}d", {"{foo}a": 1, "{foo}b": 2, "{foo}c": 3}) == 2
-        assert r.zrange("{foo}d", 0, -1, withscores=True) == [(b"a3", 20), (b"a1", 23)]
+        assert_resp_response(
+            r,
+            r.zrange("{foo}d", 0, -1, withscores=True),
+            [(b"a3", 20), (b"a1", 23)],
+            [[b"a3", 20.0], [b"a1", 23.0]],
+        )
 
     @skip_if_server_version_lt("4.9.0")
     def test_cluster_bzpopmax(self, r):
         r.zadd("{foo}a", {"a1": 1, "a2": 2})
         r.zadd("{foo}b", {"b1": 10, "b2": 20})
-        assert r.bzpopmax(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"b2", 20)
-        assert r.bzpopmax(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"b1", 10)
-        assert r.bzpopmax(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"a2", 2)
-        assert r.bzpopmax(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"a1", 1)
+        assert_resp_response(
+            r,
+            r.bzpopmax(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}b", b"b2", 20),
+            [b"{foo}b", b"b2", 20],
+        )
+        assert_resp_response(
+            r,
+            r.bzpopmax(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}b", b"b1", 10),
+            [b"{foo}b", b"b1", 10],
+        )
+        assert_resp_response(
+            r,
+            r.bzpopmax(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}a", b"a2", 2),
+            [b"{foo}a", b"a2", 2],
+        )
+        assert_resp_response(
+            r,
+            r.bzpopmax(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}a", b"a1", 1),
+            [b"{foo}a", b"a1", 1],
+        )
         assert r.bzpopmax(["{foo}b", "{foo}a"], timeout=1) is None
         r.zadd("{foo}c", {"c1": 100})
-        assert r.bzpopmax("{foo}c", timeout=1) == (b"{foo}c", b"c1", 100)
+        assert_resp_response(
+            r,
+            r.bzpopmax("{foo}c", timeout=1),
+            (b"{foo}c", b"c1", 100),
+            [b"{foo}c", b"c1", 100],
+        )
 
     @skip_if_server_version_lt("4.9.0")
     def test_cluster_bzpopmin(self, r):
         r.zadd("{foo}a", {"a1": 1, "a2": 2})
         r.zadd("{foo}b", {"b1": 10, "b2": 20})
-        assert r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"b1", 10)
-        assert r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}b", b"b2", 20)
-        assert r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"a1", 1)
-        assert r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) == (b"{foo}a", b"a2", 2)
+        assert_resp_response(
+            r,
+            r.bzpopmin(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}b", b"b1", 10),
+            [b"b", b"b1", 10],
+        )
+        assert_resp_response(
+            r,
+            r.bzpopmin(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}b", b"b2", 20),
+            [b"b", b"b2", 20],
+        )
+        assert_resp_response(
+            r,
+            r.bzpopmin(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}a", b"a1", 1),
+            [b"a", b"a1", 1],
+        )
+        assert_resp_response(
+            r,
+            r.bzpopmin(["{foo}b", "{foo}a"], timeout=1),
+            (b"{foo}a", b"a2", 2),
+            [b"a", b"a2", 2],
+        )
         assert r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) is None
         r.zadd("{foo}c", {"c1": 100})
-        assert r.bzpopmin("{foo}c", timeout=1) == (b"{foo}c", b"c1", 100)
+        assert_resp_response(
+            r,
+            r.bzpopmin("{foo}c", timeout=1),
+            (b"{foo}c", b"c1", 100),
+            [b"{foo}c", b"c1", 100],
+        )
 
     @skip_if_server_version_lt("6.2.0")
     def test_cluster_zrangestore(self, r):
@@ -1950,7 +2077,12 @@ def test_cluster_zrangestore(self, r):
         assert r.zrange("{foo}b", 0, -1) == [b"a1", b"a2"]
         assert r.zrangestore("{foo}b", "{foo}a", 1, 2)
         assert r.zrange("{foo}b", 0, -1) == [b"a2", b"a3"]
-        assert r.zrange("{foo}b", 0, -1, withscores=True) == [(b"a2", 2), (b"a3", 3)]
+        assert_resp_response(
+            r,
+            r.zrange("{foo}b", 0, 1, withscores=True),
+            [(b"a2", 2), (b"a3", 3)],
+            [[b"a2", 2.0], [b"a3", 3.0]],
+        )
         # reversed order
         assert r.zrangestore("{foo}b", "{foo}a", 1, 2, desc=True)
         assert r.zrange("{foo}b", 0, -1) == [b"a1", b"a2"]
@@ -1972,39 +2104,45 @@ def test_cluster_zunion(self, r):
         r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
         # sum
         assert r.zunion(["{foo}a", "{foo}b", "{foo}c"]) == [b"a2", b"a4", b"a3", b"a1"]
-        assert r.zunion(["{foo}a", "{foo}b", "{foo}c"], withscores=True) == [
-            (b"a2", 3),
-            (b"a4", 4),
-            (b"a3", 8),
-            (b"a1", 9),
-        ]
+        assert_resp_response(
+            r,
+            r.zunion(["{foo}a", "{foo}b", "{foo}c"], withscores=True),
+            [(b"a2", 3), (b"a4", 4), (b"a3", 8), (b"a1", 9)],
+            [[b"a2", 3.0], [b"a4", 4.0], [b"a3", 8.0], [b"a1", 9.0]],
+        )
         # max
-        assert r.zunion(
-            ["{foo}a", "{foo}b", "{foo}c"], aggregate="MAX", withscores=True
-        ) == [(b"a2", 2), (b"a4", 4), (b"a3", 5), (b"a1", 6)]
+        assert_resp_response(
+            r,
+            r.zunion(["{foo}a", "{foo}b", "{foo}c"], aggregate="MAX", withscores=True),
+            [(b"a2", 2), (b"a4", 4), (b"a3", 5), (b"a1", 6)],
+            [[b"a2", 2.0], [b"a4", 4.0], [b"a3", 5.0], [b"a1", 6.0]],
+        )
         # min
-        assert r.zunion(
-            ["{foo}a", "{foo}b", "{foo}c"], aggregate="MIN", withscores=True
-        ) == [(b"a1", 1), (b"a2", 1), (b"a3", 1), (b"a4", 4)]
+        assert_resp_response(
+            r,
+            r.zunion(["{foo}a", "{foo}b", "{foo}c"], aggregate="MIN", withscores=True),
+            [(b"a1", 1), (b"a2", 1), (b"a3", 1), (b"a4", 4)],
+            [[b"a1", 1.0], [b"a2", 1.0], [b"a3", 1.0], [b"a4", 4.0]],
+        )
         # with weight
-        assert r.zunion({"{foo}a": 1, "{foo}b": 2, "{foo}c": 3}, withscores=True) == [
-            (b"a2", 5),
-            (b"a4", 12),
-            (b"a3", 20),
-            (b"a1", 23),
-        ]
+        assert_resp_response(
+            r,
+            r.zunion({"{foo}a": 1, "{foo}b": 2, "{foo}c": 3}, withscores=True),
+            [(b"a2", 5), (b"a4", 12), (b"a3", 20), (b"a1", 23)],
+            [[b"a2", 5.0], [b"a4", 12.0], [b"a3", 20.0], [b"a1", 23.0]],
+        )
 
     def test_cluster_zunionstore_sum(self, r):
         r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
         r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
         r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
         assert r.zunionstore("{foo}d", ["{foo}a", "{foo}b", "{foo}c"]) == 4
-        assert r.zrange("{foo}d", 0, -1, withscores=True) == [
-            (b"a2", 3),
-            (b"a4", 4),
-            (b"a3", 8),
-            (b"a1", 9),
-        ]
+        assert_resp_response(
+            r,
+            r.zrange("{foo}d", 0, -1, withscores=True),
+            [(b"a2", 3), (b"a4", 4), (b"a3", 8), (b"a1", 9)],
+            [[b"a2", 3.0], [b"a4", 4.0], [b"a3", 8.0], [b"a1", 9.0]],
+        )
 
     def test_cluster_zunionstore_max(self, r):
         r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
@@ -2014,12 +2152,12 @@ def test_cluster_zunionstore_max(self, r):
             r.zunionstore("{foo}d", ["{foo}a", "{foo}b", "{foo}c"], aggregate="MAX")
             == 4
         )
-        assert r.zrange("{foo}d", 0, -1, withscores=True) == [
-            (b"a2", 2),
-            (b"a4", 4),
-            (b"a3", 5),
-            (b"a1", 6),
-        ]
+        assert_resp_response(
+            r,
+            r.zrange("{foo}d", 0, -1, withscores=True),
+            [(b"a2", 2), (b"a4", 4), (b"a3", 5), (b"a1", 6)],
+            [[b"a2", 2.0], [b"a4", 4.0], [b"a3", 5.0], [b"a1", 6.0]],
+        )
 
     def test_cluster_zunionstore_min(self, r):
         r.zadd("{foo}a", {"a1": 1, "a2": 2, "a3": 3})
@@ -2029,24 +2167,24 @@ def test_cluster_zunionstore_min(self, r):
             r.zunionstore("{foo}d", ["{foo}a", "{foo}b", "{foo}c"], aggregate="MIN")
             == 4
         )
-        assert r.zrange("{foo}d", 0, -1, withscores=True) == [
-            (b"a1", 1),
-            (b"a2", 2),
-            (b"a3", 3),
-            (b"a4", 4),
-        ]
+        assert_resp_response(
+            r,
+            r.zrange("{foo}d", 0, -1, withscores=True),
+            [(b"a1", 1), (b"a2", 2), (b"a3", 3), (b"a4", 4)],
+            [[b"a1", 1.0], [b"a2", 2.0], [b"a3", 3.0], [b"a4", 4.0]],
+        )
 
     def test_cluster_zunionstore_with_weight(self, r):
         r.zadd("{foo}a", {"a1": 1, "a2": 1, "a3": 1})
         r.zadd("{foo}b", {"a1": 2, "a2": 2, "a3": 2})
         r.zadd("{foo}c", {"a1": 6, "a3": 5, "a4": 4})
         assert r.zunionstore("{foo}d", {"{foo}a": 1, "{foo}b": 2, "{foo}c": 3}) == 4
-        assert r.zrange("{foo}d", 0, -1, withscores=True) == [
-            (b"a2", 5),
-            (b"a4", 12),
-            (b"a3", 20),
-            (b"a1", 23),
-        ]
+        assert_resp_response(
+            r,
+            r.zrange("{foo}d", 0, -1, withscores=True),
+            [(b"a2", 5), (b"a4", 12), (b"a3", 20), (b"a1", 23)],
+            [[b"a2", 5.0], [b"a4", 12.0], [b"a3", 20.0], [b"a1", 23.0]],
+        )
 
     @skip_if_server_version_lt("2.8.9")
     def test_cluster_pfcount(self, r):
@@ -3068,7 +3206,12 @@ def test_pipeline_readonly(self, r):
 
         with r.pipeline() as readonly_pipe:
             readonly_pipe.get("foo71").zrange("foo88", 0, 5, withscores=True)
-            assert readonly_pipe.execute() == [b"a1", [(b"z1", 1.0), (b"z2", 4)]]
+            assert_resp_response(
+                r,
+                readonly_pipe.execute(),
+                [b"a1", [(b"z1", 1.0), (b"z2", 4)]],
+                [b"a1", [[b"z1", 1.0], [b"z2", 4.0]]],
+            )
 
     def test_moved_redirection_on_slave_with_default(self, r):
         """
diff --git a/tests/test_command_parser.py b/tests/test_command_parser.py
index 6c3ede9cdf..e3b44a147f 100644
--- a/tests/test_command_parser.py
+++ b/tests/test_command_parser.py
@@ -1,8 +1,11 @@
 import pytest
+from redis._parsers import CommandsParser
 
-from redis.commands import CommandsParser
-
-from .conftest import skip_if_redis_enterprise, skip_if_server_version_lt
+from .conftest import (
+    assert_resp_response,
+    skip_if_redis_enterprise,
+    skip_if_server_version_lt,
+)
 
 
 class TestCommandsParser:
@@ -51,13 +54,40 @@ def test_get_moveable_keys(self, r):
         ]
         args7 = ["MIGRATE", "192.168.1.34", 6379, "key1", 0, 5000]
 
-        assert sorted(commands_parser.get_keys(r, *args1)) == ["key1", "key2"]
-        assert sorted(commands_parser.get_keys(r, *args2)) == ["mystream", "writers"]
-        assert sorted(commands_parser.get_keys(r, *args3)) == ["out", "zset1", "zset2"]
-        assert sorted(commands_parser.get_keys(r, *args4)) == ["Sicily", "out"]
-        assert sorted(commands_parser.get_keys(r, *args5)) == ["foo"]
-        assert sorted(commands_parser.get_keys(r, *args6)) == ["key1", "key2", "key3"]
-        assert sorted(commands_parser.get_keys(r, *args7)) == ["key1"]
+        assert_resp_response(
+            r,
+            sorted(commands_parser.get_keys(r, *args1)),
+            ["key1", "key2"],
+            [b"key1", b"key2"],
+        )
+        assert_resp_response(
+            r,
+            sorted(commands_parser.get_keys(r, *args2)),
+            ["mystream", "writers"],
+            [b"mystream", b"writers"],
+        )
+        assert_resp_response(
+            r,
+            sorted(commands_parser.get_keys(r, *args3)),
+            ["out", "zset1", "zset2"],
+            [b"out", b"zset1", b"zset2"],
+        )
+        assert_resp_response(
+            r,
+            sorted(commands_parser.get_keys(r, *args4)),
+            ["Sicily", "out"],
+            [b"Sicily", b"out"],
+        )
+        assert sorted(commands_parser.get_keys(r, *args5)) in [["foo"], [b"foo"]]
+        assert_resp_response(
+            r,
+            sorted(commands_parser.get_keys(r, *args6)),
+            ["key1", "key2", "key3"],
+            [b"key1", b"key2", b"key3"],
+        )
+        assert_resp_response(
+            r, sorted(commands_parser.get_keys(r, *args7)), ["key1"], [b"key1"]
+        )
 
     # A bug in redis<7.0 causes this to fail: https://github.com/redis/redis/issues/9493
     @skip_if_server_version_lt("7.0.0")
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 2213e81f72..fdf41dc5fa 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -9,13 +9,21 @@
 from unittest.mock import patch
 
 import pytest
-
 import redis
 from redis import exceptions
-from redis.client import EMPTY_RESPONSE, NEVER_DECODE, parse_info
+from redis._parsers.helpers import (
+    _RedisCallbacks,
+    _RedisCallbacksRESP2,
+    _RedisCallbacksRESP3,
+    parse_info,
+)
+from redis.client import EMPTY_RESPONSE, NEVER_DECODE
 
 from .conftest import (
     _get_client,
+    assert_resp_response,
+    assert_resp_response_in,
+    is_resp2_connection,
     skip_if_redis_enterprise,
     skip_if_server_version_gte,
     skip_if_server_version_lt,
@@ -58,17 +66,23 @@ class TestResponseCallbacks:
     "Tests for the response callback system"
 
     def test_response_callbacks(self, r):
-        assert r.response_callbacks == redis.Redis.RESPONSE_CALLBACKS
-        assert id(r.response_callbacks) != id(redis.Redis.RESPONSE_CALLBACKS)
+        callbacks = _RedisCallbacks
+        if is_resp2_connection(r):
+            callbacks.update(_RedisCallbacksRESP2)
+        else:
+            callbacks.update(_RedisCallbacksRESP3)
+        assert r.response_callbacks == callbacks
+        assert id(r.response_callbacks) != id(_RedisCallbacks)
         r.set_response_callback("GET", lambda x: "static")
         r["a"] = "foo"
         assert r["a"] == "static"
 
     def test_case_insensitive_command_names(self, r):
-        assert r.response_callbacks["del"] == r.response_callbacks["DEL"]
+        assert r.response_callbacks["ping"] == r.response_callbacks["PING"]
 
 
 class TestRedisCommands:
+    @pytest.mark.onlynoncluster
     @skip_if_redis_enterprise()
     def test_auth(self, r, request):
         # sending an AUTH command before setting a user/password on the
@@ -103,7 +117,6 @@ def teardown():
                 # connection field is not set in Redis Cluster, but that's ok
                 # because the problem discussed above does not apply to Redis Cluster
                 pass
-
             r.auth(temp_pass)
             r.config_set("requirepass", "")
             r.acl_deluser(username)
@@ -129,13 +142,13 @@ def test_command_on_invalid_key_type(self, r):
     def test_acl_cat_no_category(self, r):
         categories = r.acl_cat()
         assert isinstance(categories, list)
-        assert "read" in categories
+        assert "read" in categories or b"read" in categories
 
     @skip_if_server_version_lt("6.0.0")
     def test_acl_cat_with_category(self, r):
         commands = r.acl_cat("read")
         assert isinstance(commands, list)
-        assert "get" in commands
+        assert "get" in commands or b"get" in commands
 
     @skip_if_server_version_lt("7.0.0")
     @skip_if_redis_enterprise()
@@ -149,9 +162,8 @@ def teardown():
 
         r.acl_setuser(username, keys=["*"], commands=["+set"])
         assert r.acl_dryrun(username, "set", "key", "value") == b"OK"
-        assert r.acl_dryrun(username, "get", "key").startswith(
-            b"This user has no permissions to run the"
-        )
+        no_permissions_message = b"user has no permissions to run the"
+        assert no_permissions_message in r.acl_dryrun(username, "get", "key")
 
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise()
@@ -182,7 +194,7 @@ def teardown():
     @skip_if_redis_enterprise()
     def test_acl_genpass(self, r):
         password = r.acl_genpass()
-        assert isinstance(password, str)
+        assert isinstance(password, (str, bytes))
 
         with pytest.raises(exceptions.DataError):
             r.acl_genpass("value")
@@ -190,11 +202,12 @@ def test_acl_genpass(self, r):
             r.acl_genpass(5555)
 
         r.acl_genpass(555)
-        assert isinstance(password, str)
+        assert isinstance(password, (str, bytes))
 
     @skip_if_server_version_lt("7.0.0")
     @skip_if_redis_enterprise()
     def test_acl_getuser_setuser(self, r, request):
+        r.flushall()
         username = "redis-py-user"
 
         def teardown():
@@ -229,19 +242,19 @@ def teardown():
             enabled=True,
             reset=True,
             passwords=["+pass1", "+pass2"],
-            categories=["+set", "+@hash", "-geo"],
+            categories=["+set", "+@hash", "-@geo"],
             commands=["+get", "+mget", "-hset"],
             keys=["cache:*", "objects:*"],
         )
         acl = r.acl_getuser(username)
-        assert set(acl["categories"]) == {"-@all", "+@set", "+@hash"}
+        assert set(acl["categories"]) == {"+@hash", "+@set", "-@all", "-@geo"}
         assert set(acl["commands"]) == {"+get", "+mget", "-hset"}
         assert acl["enabled"] is True
         assert "on" in acl["flags"]
         assert set(acl["keys"]) == {"~cache:*", "~objects:*"}
         assert len(acl["passwords"]) == 2
 
-        # test reset=False keeps existing ACL and applies new ACL on top
+        # # test reset=False keeps existing ACL and applies new ACL on top
         assert r.acl_setuser(
             username,
             enabled=True,
@@ -260,14 +273,13 @@ def teardown():
             keys=["objects:*"],
         )
         acl = r.acl_getuser(username)
-        assert set(acl["categories"]) == {"-@all", "+@set", "+@hash"}
         assert set(acl["commands"]) == {"+get", "+mget"}
         assert acl["enabled"] is True
         assert "on" in acl["flags"]
         assert set(acl["keys"]) == {"~cache:*", "~objects:*"}
         assert len(acl["passwords"]) == 2
 
-        # test removal of passwords
+        # # test removal of passwords
         assert r.acl_setuser(
             username, enabled=True, reset=True, passwords=["+pass1", "+pass2"]
         )
@@ -275,7 +287,7 @@ def teardown():
         assert r.acl_setuser(username, enabled=True, passwords=["-pass2"])
         assert len(r.acl_getuser(username)["passwords"]) == 1
 
-        # Resets and tests that hashed passwords are set properly.
+        # # Resets and tests that hashed passwords are set properly.
         hashed_password = (
             "5e884898da28047151d0e56f8dc6292773603d0d6aabbdd62a11ef721d1542d8"
         )
@@ -299,7 +311,7 @@ def teardown():
         )
         assert len(r.acl_getuser(username)["passwords"]) == 1
 
-        # test selectors
+        # # test selectors
         assert r.acl_setuser(
             username,
             enabled=True,
@@ -312,16 +324,19 @@ def teardown():
             selectors=[("+set", "%W~app*")],
         )
         acl = r.acl_getuser(username)
-        assert set(acl["categories"]) == {"-@all", "+@set", "+@hash"}
+        assert set(acl["categories"]) == {"+@hash", "+@set", "-@all", "-@geo"}
         assert set(acl["commands"]) == {"+get", "+mget", "-hset"}
         assert acl["enabled"] is True
         assert "on" in acl["flags"]
         assert set(acl["keys"]) == {"~cache:*", "~objects:*"}
         assert len(acl["passwords"]) == 2
         assert set(acl["channels"]) == {"&message:*"}
-        assert acl["selectors"] == [
-            ["commands", "-@all +set", "keys", "%W~app*", "channels", ""]
-        ]
+        assert_resp_response(
+            r,
+            acl["selectors"],
+            [["commands", "-@all +set", "keys", "%W~app*", "channels", ""]],
+            [{"commands": "-@all +set", "keys": "%W~app*", "channels": ""}],
+        )
 
     @skip_if_server_version_lt("6.0.0")
     def test_acl_help(self, r):
@@ -333,6 +348,7 @@ def test_acl_help(self, r):
     @skip_if_redis_enterprise()
     def test_acl_list(self, r, request):
         username = "redis-py-user"
+        start = r.acl_list()
 
         def teardown():
             r.acl_deluser(username)
@@ -341,7 +357,7 @@ def teardown():
 
         assert r.acl_setuser(username, enabled=False, reset=True)
         users = r.acl_list()
-        assert len(users) == 2
+        assert len(users) == len(start) + 1
 
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise()
@@ -383,8 +399,13 @@ def teardown():
         assert len(r.acl_log()) == 2
         assert len(r.acl_log(count=1)) == 1
         assert isinstance(r.acl_log()[0], dict)
-        assert "client-info" in r.acl_log(count=1)[0]
-        assert r.acl_log_reset()
+        expected = r.acl_log(count=1)[0]
+        assert_resp_response_in(
+            r,
+            "client-info",
+            expected,
+            expected.keys(),
+        )
 
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise()
@@ -434,7 +455,7 @@ def test_acl_users(self, r):
     @skip_if_server_version_lt("6.0.0")
     def test_acl_whoami(self, r):
         username = r.acl_whoami()
-        assert isinstance(username, str)
+        assert isinstance(username, (str, bytes))
 
     @pytest.mark.onlynoncluster
     def test_client_list(self, r):
@@ -489,7 +510,7 @@ def test_client_id(self, r):
     def test_client_trackinginfo(self, r):
         res = r.client_trackinginfo()
         assert len(res) > 2
-        assert "prefixes" in res
+        assert "prefixes" in res or b"prefixes" in res
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.0.0")
@@ -531,7 +552,7 @@ def test_client_getname(self, r):
     @skip_if_server_version_lt("2.6.9")
     def test_client_setname(self, r):
         assert r.client_setname("redis_py_test")
-        assert r.client_getname() == "redis_py_test"
+        assert_resp_response(r, r.client_getname(), "redis_py_test", b"redis_py_test")
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.6.9")
@@ -722,7 +743,7 @@ def test_waitaof(self, r):
     @skip_if_server_version_lt("3.2.0")
     def test_client_reply(self, r, r_timeout):
         assert r_timeout.client_reply("ON") == b"OK"
-        with pytest.raises(exceptions.TimeoutError):
+        with pytest.raises(exceptions.RedisError):
             r_timeout.client_reply("OFF")
 
             r_timeout.client_reply("SKIP")
@@ -834,7 +855,7 @@ def test_lolwut(self, r):
     @skip_if_server_version_lt("6.2.0")
     @skip_if_redis_enterprise()
     def test_reset(self, r):
-        assert r.reset() == "RESET"
+        assert_resp_response(r, r.reset(), "RESET", b"RESET")
 
     def test_object(self, r):
         r["a"] = "foo"
@@ -1147,8 +1168,12 @@ def test_lcs(self, r):
         r.mset({"foo": "ohmytext", "bar": "mynewtext"})
         assert r.lcs("foo", "bar") == b"mytext"
         assert r.lcs("foo", "bar", len=True) == 6
-        result = [b"matches", [[[4, 7], [5, 8]]], b"len", 6]
-        assert r.lcs("foo", "bar", idx=True, minmatchlen=3) == result
+        assert_resp_response(
+            r,
+            r.lcs("foo", "bar", idx=True, minmatchlen=3),
+            [b"matches", [[[4, 7], [5, 8]]], b"len", 6],
+            {b"matches": [[[4, 7], [5, 8]]], b"len": 6},
+        )
         with pytest.raises(redis.ResponseError):
             assert r.lcs("foo", "bar", len=True, idx=True)
 
@@ -1562,7 +1587,7 @@ def test_hrandfield(self, r):
         assert r.hrandfield("key") is not None
         assert len(r.hrandfield("key", 2)) == 2
         # with values
-        assert len(r.hrandfield("key", 2, True)) == 4
+        assert_resp_response(r, len(r.hrandfield("key", 2, withvalues=True)), 4, 2)
         # without duplications
         assert len(r.hrandfield("key", 10)) == 5
         # with duplications
@@ -1715,17 +1740,26 @@ def test_stralgo_lcs(self, r):
         assert r.stralgo("LCS", key1, key2, specific_argument="keys") == res
         # test other labels
         assert r.stralgo("LCS", value1, value2, len=True) == len(res)
-        assert r.stralgo("LCS", value1, value2, idx=True) == {
-            "len": len(res),
-            "matches": [[(4, 7), (5, 8)], [(2, 3), (0, 1)]],
-        }
-        assert r.stralgo("LCS", value1, value2, idx=True, withmatchlen=True) == {
-            "len": len(res),
-            "matches": [[4, (4, 7), (5, 8)], [2, (2, 3), (0, 1)]],
-        }
-        assert r.stralgo(
-            "LCS", value1, value2, idx=True, minmatchlen=4, withmatchlen=True
-        ) == {"len": len(res), "matches": [[4, (4, 7), (5, 8)]]}
+        assert_resp_response(
+            r,
+            r.stralgo("LCS", value1, value2, idx=True),
+            {"len": len(res), "matches": [[(4, 7), (5, 8)], [(2, 3), (0, 1)]]},
+            {"len": len(res), "matches": [[[4, 7], [5, 8]], [[2, 3], [0, 1]]]},
+        )
+        assert_resp_response(
+            r,
+            r.stralgo("LCS", value1, value2, idx=True, withmatchlen=True),
+            {"len": len(res), "matches": [[4, (4, 7), (5, 8)], [2, (2, 3), (0, 1)]]},
+            {"len": len(res), "matches": [[[4, 7], [5, 8], 4], [[2, 3], [0, 1], 2]]},
+        )
+        assert_resp_response(
+            r,
+            r.stralgo(
+                "LCS", value1, value2, idx=True, withmatchlen=True, minmatchlen=4
+            ),
+            {"len": len(res), "matches": [[4, (4, 7), (5, 8)]]},
+            {"len": len(res), "matches": [[[4, 7], [5, 8], 4]]},
+        )
 
     @skip_if_server_version_lt("6.0.0")
     @skip_if_server_version_gte("7.0.0")
@@ -1788,25 +1822,41 @@ def test_type(self, r):
     def test_blpop(self, r):
         r.rpush("a", "1", "2")
         r.rpush("b", "3", "4")
-        assert r.blpop(["b", "a"], timeout=1) == (b"b", b"3")
-        assert r.blpop(["b", "a"], timeout=1) == (b"b", b"4")
-        assert r.blpop(["b", "a"], timeout=1) == (b"a", b"1")
-        assert r.blpop(["b", "a"], timeout=1) == (b"a", b"2")
+        assert_resp_response(
+            r, r.blpop(["b", "a"], timeout=1), (b"b", b"3"), [b"b", b"3"]
+        )
+        assert_resp_response(
+            r, r.blpop(["b", "a"], timeout=1), (b"b", b"4"), [b"b", b"4"]
+        )
+        assert_resp_response(
+            r, r.blpop(["b", "a"], timeout=1), (b"a", b"1"), [b"a", b"1"]
+        )
+        assert_resp_response(
+            r, r.blpop(["b", "a"], timeout=1), (b"a", b"2"), [b"a", b"2"]
+        )
         assert r.blpop(["b", "a"], timeout=1) is None
         r.rpush("c", "1")
-        assert r.blpop("c", timeout=1) == (b"c", b"1")
+        assert_resp_response(r, r.blpop("c", timeout=1), (b"c", b"1"), [b"c", b"1"])
 
     @pytest.mark.onlynoncluster
     def test_brpop(self, r):
         r.rpush("a", "1", "2")
         r.rpush("b", "3", "4")
-        assert r.brpop(["b", "a"], timeout=1) == (b"b", b"4")
-        assert r.brpop(["b", "a"], timeout=1) == (b"b", b"3")
-        assert r.brpop(["b", "a"], timeout=1) == (b"a", b"2")
-        assert r.brpop(["b", "a"], timeout=1) == (b"a", b"1")
+        assert_resp_response(
+            r, r.brpop(["b", "a"], timeout=1), (b"b", b"4"), [b"b", b"4"]
+        )
+        assert_resp_response(
+            r, r.brpop(["b", "a"], timeout=1), (b"b", b"3"), [b"b", b"3"]
+        )
+        assert_resp_response(
+            r, r.brpop(["b", "a"], timeout=1), (b"a", b"2"), [b"a", b"2"]
+        )
+        assert_resp_response(
+            r, r.brpop(["b", "a"], timeout=1), (b"a", b"1"), [b"a", b"1"]
+        )
         assert r.brpop(["b", "a"], timeout=1) is None
         r.rpush("c", "1")
-        assert r.brpop("c", timeout=1) == (b"c", b"1")
+        assert_resp_response(r, r.brpop("c", timeout=1), (b"c", b"1"), [b"c", b"1"])
 
     @pytest.mark.onlynoncluster
     def test_brpoplpush(self, r):
@@ -2174,8 +2224,12 @@ def test_spop_multi_value(self, r):
 
         for value in values:
             assert value in s
-
-        assert r.spop("a", 1) == list(set(s) - set(values))
+        assert_resp_response(
+            r,
+            r.spop("a", 1),
+            list(set(s) - set(values)),
+            set(s) - set(values),
+        )
 
     def test_srandmember(self, r):
         s = [b"1", b"2", b"3"]
@@ -2226,11 +2280,12 @@ def test_script_debug(self, r):
     def test_zadd(self, r):
         mapping = {"a1": 1.0, "a2": 2.0, "a3": 3.0}
         r.zadd("a", mapping)
-        assert r.zrange("a", 0, -1, withscores=True) == [
-            (b"a1", 1.0),
-            (b"a2", 2.0),
-            (b"a3", 3.0),
-        ]
+        assert_resp_response(
+            r,
+            r.zrange("a", 0, -1, withscores=True),
+            [(b"a1", 1.0), (b"a2", 2.0), (b"a3", 3.0)],
+            [[b"a1", 1.0], [b"a2", 2.0], [b"a3", 3.0]],
+        )
 
         # error cases
         with pytest.raises(exceptions.DataError):
@@ -2247,17 +2302,32 @@ def test_zadd(self, r):
     def test_zadd_nx(self, r):
         assert r.zadd("a", {"a1": 1}) == 1
         assert r.zadd("a", {"a1": 99, "a2": 2}, nx=True) == 1
-        assert r.zrange("a", 0, -1, withscores=True) == [(b"a1", 1.0), (b"a2", 2.0)]
+        assert_resp_response(
+            r,
+            r.zrange("a", 0, -1, withscores=True),
+            [(b"a1", 1.0), (b"a2", 2.0)],
+            [[b"a1", 1.0], [b"a2", 2.0]],
+        )
 
     def test_zadd_xx(self, r):
         assert r.zadd("a", {"a1": 1}) == 1
         assert r.zadd("a", {"a1": 99, "a2": 2}, xx=True) == 0
-        assert r.zrange("a", 0, -1, withscores=True) == [(b"a1", 99.0)]
+        assert_resp_response(
+            r,
+            r.zrange("a", 0, -1, withscores=True),
+            [(b"a1", 99.0)],
+            [[b"a1", 99.0]],
+        )
 
     def test_zadd_ch(self, r):
         assert r.zadd("a", {"a1": 1}) == 1
         assert r.zadd("a", {"a1": 99, "a2": 2}, ch=True) == 2
-        assert r.zrange("a", 0, -1, withscores=True) == [(b"a2", 2.0), (b"a1", 99.0)]
+        assert_resp_response(
+            r,
+            r.zrange("a", 0, -1, withscores=True),
+            [(b"a2", 2.0), (b"a1", 99.0)],
+            [[b"a2", 2.0], [b"a1", 99.0]],
+        )
 
     def test_zadd_incr(self, r):
         assert r.zadd("a", {"a1": 1}) == 1
@@ -2305,7 +2375,12 @@ def test_zdiff(self, r):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
         r.zadd("b", {"a1": 1, "a2": 2})
         assert r.zdiff(["a", "b"]) == [b"a3"]
-        assert r.zdiff(["a", "b"], withscores=True) == [b"a3", b"3"]
+        assert_resp_response(
+            r,
+            r.zdiff(["a", "b"], withscores=True),
+            [b"a3", b"3"],
+            [[b"a3", 3.0]],
+        )
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.2.0")
@@ -2314,7 +2389,12 @@ def test_zdiffstore(self, r):
         r.zadd("b", {"a1": 1, "a2": 2})
         assert r.zdiffstore("out", ["a", "b"])
         assert r.zrange("out", 0, -1) == [b"a3"]
-        assert r.zrange("out", 0, -1, withscores=True) == [(b"a3", 3.0)]
+        assert_resp_response(
+            r,
+            r.zrange("out", 0, -1, withscores=True),
+            [(b"a3", 3.0)],
+            [[b"a3", 3.0]],
+        )
 
     def test_zincrby(self, r):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
@@ -2340,22 +2420,33 @@ def test_zinter(self, r):
         with pytest.raises(exceptions.DataError):
             r.zinter(["a", "b", "c"], aggregate="foo", withscores=True)
         # aggregate with SUM
-        assert r.zinter(["a", "b", "c"], withscores=True) == [(b"a3", 8), (b"a1", 9)]
+        assert_resp_response(
+            r,
+            r.zinter(["a", "b", "c"], withscores=True),
+            [(b"a3", 8), (b"a1", 9)],
+            [[b"a3", 8], [b"a1", 9]],
+        )
         # aggregate with MAX
-        assert r.zinter(["a", "b", "c"], aggregate="MAX", withscores=True) == [
-            (b"a3", 5),
-            (b"a1", 6),
-        ]
+        assert_resp_response(
+            r,
+            r.zinter(["a", "b", "c"], aggregate="MAX", withscores=True),
+            [(b"a3", 5), (b"a1", 6)],
+            [[b"a3", 5], [b"a1", 6]],
+        )
         # aggregate with MIN
-        assert r.zinter(["a", "b", "c"], aggregate="MIN", withscores=True) == [
-            (b"a1", 1),
-            (b"a3", 1),
-        ]
+        assert_resp_response(
+            r,
+            r.zinter(["a", "b", "c"], aggregate="MIN", withscores=True),
+            [(b"a1", 1), (b"a3", 1)],
+            [[b"a1", 1], [b"a3", 1]],
+        )
         # with weights
-        assert r.zinter({"a": 1, "b": 2, "c": 3}, withscores=True) == [
-            (b"a3", 20),
-            (b"a1", 23),
-        ]
+        assert_resp_response(
+            r,
+            r.zinter({"a": 1, "b": 2, "c": 3}, withscores=True),
+            [(b"a3", 20), (b"a1", 23)],
+            [[b"a3", 20], [b"a1", 23]],
+        )
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("7.0.0")
@@ -2372,7 +2463,12 @@ def test_zinterstore_sum(self, r):
         r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
         r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
         assert r.zinterstore("d", ["a", "b", "c"]) == 2
-        assert r.zrange("d", 0, -1, withscores=True) == [(b"a3", 8), (b"a1", 9)]
+        assert_resp_response(
+            r,
+            r.zrange("d", 0, -1, withscores=True),
+            [(b"a3", 8), (b"a1", 9)],
+            [[b"a3", 8], [b"a1", 9]],
+        )
 
     @pytest.mark.onlynoncluster
     def test_zinterstore_max(self, r):
@@ -2380,7 +2476,12 @@ def test_zinterstore_max(self, r):
         r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
         r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
         assert r.zinterstore("d", ["a", "b", "c"], aggregate="MAX") == 2
-        assert r.zrange("d", 0, -1, withscores=True) == [(b"a3", 5), (b"a1", 6)]
+        assert_resp_response(
+            r,
+            r.zrange("d", 0, -1, withscores=True),
+            [(b"a3", 5), (b"a1", 6)],
+            [[b"a3", 5], [b"a1", 6]],
+        )
 
     @pytest.mark.onlynoncluster
     def test_zinterstore_min(self, r):
@@ -2388,7 +2489,12 @@ def test_zinterstore_min(self, r):
         r.zadd("b", {"a1": 2, "a2": 3, "a3": 5})
         r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
         assert r.zinterstore("d", ["a", "b", "c"], aggregate="MIN") == 2
-        assert r.zrange("d", 0, -1, withscores=True) == [(b"a1", 1), (b"a3", 3)]
+        assert_resp_response(
+            r,
+            r.zrange("d", 0, -1, withscores=True),
+            [(b"a1", 1), (b"a3", 3)],
+            [[b"a1", 1], [b"a3", 3]],
+        )
 
     @pytest.mark.onlynoncluster
     def test_zinterstore_with_weight(self, r):
@@ -2396,23 +2502,36 @@ def test_zinterstore_with_weight(self, r):
         r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
         r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
         assert r.zinterstore("d", {"a": 1, "b": 2, "c": 3}) == 2
-        assert r.zrange("d", 0, -1, withscores=True) == [(b"a3", 20), (b"a1", 23)]
+        assert_resp_response(
+            r,
+            r.zrange("d", 0, -1, withscores=True),
+            [(b"a3", 20), (b"a1", 23)],
+            [[b"a3", 20], [b"a1", 23]],
+        )
 
     @skip_if_server_version_lt("4.9.0")
     def test_zpopmax(self, r):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
-        assert r.zpopmax("a") == [(b"a3", 3)]
-
+        assert_resp_response(r, r.zpopmax("a"), [(b"a3", 3)], [b"a3", 3.0])
         # with count
-        assert r.zpopmax("a", count=2) == [(b"a2", 2), (b"a1", 1)]
+        assert_resp_response(
+            r,
+            r.zpopmax("a", count=2),
+            [(b"a2", 2), (b"a1", 1)],
+            [[b"a2", 2], [b"a1", 1]],
+        )
 
     @skip_if_server_version_lt("4.9.0")
     def test_zpopmin(self, r):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
-        assert r.zpopmin("a") == [(b"a1", 1)]
-
+        assert_resp_response(r, r.zpopmin("a"), [(b"a1", 1)], [b"a1", 1.0])
         # with count
-        assert r.zpopmin("a", count=2) == [(b"a2", 2), (b"a3", 3)]
+        assert_resp_response(
+            r,
+            r.zpopmin("a", count=2),
+            [(b"a2", 2), (b"a3", 3)],
+            [[b"a2", 2], [b"a3", 3]],
+        )
 
     @skip_if_server_version_lt("6.2.0")
     def test_zrandemember(self, r):
@@ -2420,7 +2539,12 @@ def test_zrandemember(self, r):
         assert r.zrandmember("a") is not None
         assert len(r.zrandmember("a", 2)) == 2
         # with scores
-        assert len(r.zrandmember("a", 2, True)) == 4
+        assert_resp_response(
+            r,
+            len(r.zrandmember("a", 2, withscores=True)),
+            4,
+            2,
+        )
         # without duplications
         assert len(r.zrandmember("a", 10)) == 5
         # with duplications
@@ -2431,49 +2555,86 @@ def test_zrandemember(self, r):
     def test_bzpopmax(self, r):
         r.zadd("a", {"a1": 1, "a2": 2})
         r.zadd("b", {"b1": 10, "b2": 20})
-        assert r.bzpopmax(["b", "a"], timeout=1) == (b"b", b"b2", 20)
-        assert r.bzpopmax(["b", "a"], timeout=1) == (b"b", b"b1", 10)
-        assert r.bzpopmax(["b", "a"], timeout=1) == (b"a", b"a2", 2)
-        assert r.bzpopmax(["b", "a"], timeout=1) == (b"a", b"a1", 1)
+        assert_resp_response(
+            r, r.bzpopmax(["b", "a"], timeout=1), (b"b", b"b2", 20), [b"b", b"b2", 20]
+        )
+        assert_resp_response(
+            r, r.bzpopmax(["b", "a"], timeout=1), (b"b", b"b1", 10), [b"b", b"b1", 10]
+        )
+        assert_resp_response(
+            r, r.bzpopmax(["b", "a"], timeout=1), (b"a", b"a2", 2), [b"a", b"a2", 2]
+        )
+        assert_resp_response(
+            r, r.bzpopmax(["b", "a"], timeout=1), (b"a", b"a1", 1), [b"a", b"a1", 1]
+        )
         assert r.bzpopmax(["b", "a"], timeout=1) is None
         r.zadd("c", {"c1": 100})
-        assert r.bzpopmax("c", timeout=1) == (b"c", b"c1", 100)
+        assert_resp_response(
+            r, r.bzpopmax("c", timeout=1), (b"c", b"c1", 100), [b"c", b"c1", 100]
+        )
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("4.9.0")
     def test_bzpopmin(self, r):
         r.zadd("a", {"a1": 1, "a2": 2})
         r.zadd("b", {"b1": 10, "b2": 20})
-        assert r.bzpopmin(["b", "a"], timeout=1) == (b"b", b"b1", 10)
-        assert r.bzpopmin(["b", "a"], timeout=1) == (b"b", b"b2", 20)
-        assert r.bzpopmin(["b", "a"], timeout=1) == (b"a", b"a1", 1)
-        assert r.bzpopmin(["b", "a"], timeout=1) == (b"a", b"a2", 2)
+        assert_resp_response(
+            r, r.bzpopmin(["b", "a"], timeout=1), (b"b", b"b1", 10), [b"b", b"b1", 10]
+        )
+        assert_resp_response(
+            r, r.bzpopmin(["b", "a"], timeout=1), (b"b", b"b2", 20), [b"b", b"b2", 20]
+        )
+        assert_resp_response(
+            r, r.bzpopmin(["b", "a"], timeout=1), (b"a", b"a1", 1), [b"a", b"a1", 1]
+        )
+        assert_resp_response(
+            r, r.bzpopmin(["b", "a"], timeout=1), (b"a", b"a2", 2), [b"a", b"a2", 2]
+        )
         assert r.bzpopmin(["b", "a"], timeout=1) is None
         r.zadd("c", {"c1": 100})
-        assert r.bzpopmin("c", timeout=1) == (b"c", b"c1", 100)
+        assert_resp_response(
+            r, r.bzpopmin("c", timeout=1), (b"c", b"c1", 100), [b"c", b"c1", 100]
+        )
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("7.0.0")
     def test_zmpop(self, r):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
-        res = [b"a", [[b"a1", b"1"], [b"a2", b"2"]]]
-        assert r.zmpop("2", ["b", "a"], min=True, count=2) == res
+        assert_resp_response(
+            r,
+            r.zmpop("2", ["b", "a"], min=True, count=2),
+            [b"a", [[b"a1", b"1"], [b"a2", b"2"]]],
+            [b"a", [[b"a1", 1.0], [b"a2", 2.0]]],
+        )
         with pytest.raises(redis.DataError):
             r.zmpop("2", ["b", "a"], count=2)
         r.zadd("b", {"b1": 10, "ab": 9, "b3": 8})
-        assert r.zmpop("2", ["b", "a"], max=True) == [b"b", [[b"b1", b"10"]]]
+        assert_resp_response(
+            r,
+            r.zmpop("2", ["b", "a"], max=True),
+            [b"b", [[b"b1", b"10"]]],
+            [b"b", [[b"b1", 10.0]]],
+        )
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("7.0.0")
     def test_bzmpop(self, r):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
-        res = [b"a", [[b"a1", b"1"], [b"a2", b"2"]]]
-        assert r.bzmpop(1, "2", ["b", "a"], min=True, count=2) == res
+        assert_resp_response(
+            r,
+            r.bzmpop(1, "2", ["b", "a"], min=True, count=2),
+            [b"a", [[b"a1", b"1"], [b"a2", b"2"]]],
+            [b"a", [[b"a1", 1.0], [b"a2", 2.0]]],
+        )
         with pytest.raises(redis.DataError):
             r.bzmpop(1, "2", ["b", "a"], count=2)
         r.zadd("b", {"b1": 10, "ab": 9, "b3": 8})
-        res = [b"b", [[b"b1", b"10"]]]
-        assert r.bzmpop(0, "2", ["b", "a"], max=True) == res
+        assert_resp_response(
+            r,
+            r.bzmpop(0, "2", ["b", "a"], max=True),
+            [b"b", [[b"b1", b"10"]]],
+            [b"b", [[b"b1", 10.0]]],
+        )
         assert r.bzmpop(1, "2", ["foo", "bar"], max=True) is None
 
     def test_zrange(self, r):
@@ -2484,14 +2645,24 @@ def test_zrange(self, r):
         assert r.zrange("a", 0, 2, desc=True) == [b"a3", b"a2", b"a1"]
 
         # withscores
-        assert r.zrange("a", 0, 1, withscores=True) == [(b"a1", 1.0), (b"a2", 2.0)]
-        assert r.zrange("a", 1, 2, withscores=True) == [(b"a2", 2.0), (b"a3", 3.0)]
+        assert_resp_response(
+            r,
+            r.zrange("a", 0, 1, withscores=True),
+            [(b"a1", 1.0), (b"a2", 2.0)],
+            [[b"a1", 1.0], [b"a2", 2.0]],
+        )
+        assert_resp_response(
+            r,
+            r.zrange("a", 1, 2, withscores=True),
+            [(b"a2", 2.0), (b"a3", 3.0)],
+            [[b"a2", 2.0], [b"a3", 3.0]],
+        )
 
-        # custom score function
-        assert r.zrange("a", 0, 1, withscores=True, score_cast_func=int) == [
-            (b"a1", 1),
-            (b"a2", 2),
-        ]
+        # # custom score function
+        # assert r.zrange("a", 0, 1, withscores=True, score_cast_func=int) == [
+        #     (b"a1", 1),
+        #     (b"a2", 2),
+        # ]
 
     def test_zrange_errors(self, r):
         with pytest.raises(exceptions.DataError):
@@ -2523,14 +2694,20 @@ def test_zrange_params(self, r):
             b"a3",
             b"a2",
         ]
-        assert r.zrange("a", 2, 4, byscore=True, withscores=True) == [
-            (b"a2", 2.0),
-            (b"a3", 3.0),
-            (b"a4", 4.0),
-        ]
-        assert r.zrange(
-            "a", 4, 2, desc=True, byscore=True, withscores=True, score_cast_func=int
-        ) == [(b"a4", 4), (b"a3", 3), (b"a2", 2)]
+        assert_resp_response(
+            r,
+            r.zrange("a", 2, 4, byscore=True, withscores=True),
+            [(b"a2", 2.0), (b"a3", 3.0), (b"a4", 4.0)],
+            [[b"a2", 2.0], [b"a3", 3.0], [b"a4", 4.0]],
+        )
+        assert_resp_response(
+            r,
+            r.zrange(
+                "a", 4, 2, desc=True, byscore=True, withscores=True, score_cast_func=int
+            ),
+            [(b"a4", 4), (b"a3", 3), (b"a2", 2)],
+            [[b"a4", 4], [b"a3", 3], [b"a2", 2]],
+        )
 
         # rev
         assert r.zrange("a", 0, 1, desc=True) == [b"a5", b"a4"]
@@ -2543,7 +2720,12 @@ def test_zrangestore(self, r):
         assert r.zrange("b", 0, -1) == [b"a1", b"a2"]
         assert r.zrangestore("b", "a", 1, 2)
         assert r.zrange("b", 0, -1) == [b"a2", b"a3"]
-        assert r.zrange("b", 0, -1, withscores=True) == [(b"a2", 2), (b"a3", 3)]
+        assert_resp_response(
+            r,
+            r.zrange("b", 0, -1, withscores=True),
+            [(b"a2", 2), (b"a3", 3)],
+            [[b"a2", 2], [b"a3", 3]],
+        )
         # reversed order
         assert r.zrangestore("b", "a", 1, 2, desc=True)
         assert r.zrange("b", 0, -1) == [b"a1", b"a2"]
@@ -2578,16 +2760,18 @@ def test_zrangebyscore(self, r):
         # slicing with start/num
         assert r.zrangebyscore("a", 2, 4, start=1, num=2) == [b"a3", b"a4"]
         # withscores
-        assert r.zrangebyscore("a", 2, 4, withscores=True) == [
-            (b"a2", 2.0),
-            (b"a3", 3.0),
-            (b"a4", 4.0),
-        ]
-        assert r.zrangebyscore("a", 2, 4, withscores=True, score_cast_func=int) == [
-            (b"a2", 2),
-            (b"a3", 3),
-            (b"a4", 4),
-        ]
+        assert_resp_response(
+            r,
+            r.zrangebyscore("a", 2, 4, withscores=True),
+            [(b"a2", 2.0), (b"a3", 3.0), (b"a4", 4.0)],
+            [[b"a2", 2.0], [b"a3", 3.0], [b"a4", 4.0]],
+        )
+        assert_resp_response(
+            r,
+            r.zrangebyscore("a", 2, 4, withscores=True, score_cast_func=int),
+            [(b"a2", 2), (b"a3", 3), (b"a4", 4)],
+            [[b"a2", 2], [b"a3", 3], [b"a4", 4]],
+        )
 
     def test_zrank(self, r):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
@@ -2644,32 +2828,45 @@ def test_zrevrange(self, r):
         assert r.zrevrange("a", 1, 2) == [b"a2", b"a1"]
 
         # withscores
-        assert r.zrevrange("a", 0, 1, withscores=True) == [(b"a3", 3.0), (b"a2", 2.0)]
-        assert r.zrevrange("a", 1, 2, withscores=True) == [(b"a2", 2.0), (b"a1", 1.0)]
+        assert_resp_response(
+            r,
+            r.zrevrange("a", 0, 1, withscores=True),
+            [(b"a3", 3.0), (b"a2", 2.0)],
+            [[b"a3", 3.0], [b"a2", 2.0]],
+        )
+        assert_resp_response(
+            r,
+            r.zrevrange("a", 1, 2, withscores=True),
+            [(b"a2", 2.0), (b"a1", 1.0)],
+            [[b"a2", 2.0], [b"a1", 1.0]],
+        )
 
-        # custom score function
-        assert r.zrevrange("a", 0, 1, withscores=True, score_cast_func=int) == [
-            (b"a3", 3.0),
-            (b"a2", 2.0),
-        ]
+        # # custom score function
+        # assert r.zrevrange("a", 0, 1, withscores=True, score_cast_func=int) == [
+        #     (b"a3", 3.0),
+        #     (b"a2", 2.0),
+        # ]
 
     def test_zrevrangebyscore(self, r):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
         assert r.zrevrangebyscore("a", 4, 2) == [b"a4", b"a3", b"a2"]
         # slicing with start/num
         assert r.zrevrangebyscore("a", 4, 2, start=1, num=2) == [b"a3", b"a2"]
+
         # withscores
-        assert r.zrevrangebyscore("a", 4, 2, withscores=True) == [
-            (b"a4", 4.0),
-            (b"a3", 3.0),
-            (b"a2", 2.0),
-        ]
+        assert_resp_response(
+            r,
+            r.zrevrangebyscore("a", 4, 2, withscores=True),
+            [(b"a4", 4.0), (b"a3", 3.0), (b"a2", 2.0)],
+            [[b"a4", 4.0], [b"a3", 3.0], [b"a2", 2.0]],
+        )
         # custom score function
-        assert r.zrevrangebyscore("a", 4, 2, withscores=True, score_cast_func=int) == [
-            (b"a4", 4),
-            (b"a3", 3),
-            (b"a2", 2),
-        ]
+        assert_resp_response(
+            r,
+            r.zrevrangebyscore("a", 4, 2, withscores=True, score_cast_func=int),
+            [(b"a4", 4.0), (b"a3", 3.0), (b"a2", 2.0)],
+            [[b"a4", 4.0], [b"a3", 3.0], [b"a2", 2.0]],
+        )
 
     def test_zrevrank(self, r):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
@@ -2700,33 +2897,33 @@ def test_zunion(self, r):
         r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
         # sum
         assert r.zunion(["a", "b", "c"]) == [b"a2", b"a4", b"a3", b"a1"]
-        assert r.zunion(["a", "b", "c"], withscores=True) == [
-            (b"a2", 3),
-            (b"a4", 4),
-            (b"a3", 8),
-            (b"a1", 9),
-        ]
+        assert_resp_response(
+            r,
+            r.zunion(["a", "b", "c"], withscores=True),
+            [(b"a2", 3), (b"a4", 4), (b"a3", 8), (b"a1", 9)],
+            [[b"a2", 3], [b"a4", 4], [b"a3", 8], [b"a1", 9]],
+        )
         # max
-        assert r.zunion(["a", "b", "c"], aggregate="MAX", withscores=True) == [
-            (b"a2", 2),
-            (b"a4", 4),
-            (b"a3", 5),
-            (b"a1", 6),
-        ]
+        assert_resp_response(
+            r,
+            r.zunion(["a", "b", "c"], aggregate="MAX", withscores=True),
+            [(b"a2", 2), (b"a4", 4), (b"a3", 5), (b"a1", 6)],
+            [[b"a2", 2], [b"a4", 4], [b"a3", 5], [b"a1", 6]],
+        )
         # min
-        assert r.zunion(["a", "b", "c"], aggregate="MIN", withscores=True) == [
-            (b"a1", 1),
-            (b"a2", 1),
-            (b"a3", 1),
-            (b"a4", 4),
-        ]
+        assert_resp_response(
+            r,
+            r.zunion(["a", "b", "c"], aggregate="MIN", withscores=True),
+            [(b"a1", 1), (b"a2", 1), (b"a3", 1), (b"a4", 4)],
+            [[b"a1", 1], [b"a2", 1], [b"a3", 1], [b"a4", 4]],
+        )
         # with weight
-        assert r.zunion({"a": 1, "b": 2, "c": 3}, withscores=True) == [
-            (b"a2", 5),
-            (b"a4", 12),
-            (b"a3", 20),
-            (b"a1", 23),
-        ]
+        assert_resp_response(
+            r,
+            r.zunion({"a": 1, "b": 2, "c": 3}, withscores=True),
+            [(b"a2", 5), (b"a4", 12), (b"a3", 20), (b"a1", 23)],
+            [[b"a2", 5], [b"a4", 12], [b"a3", 20], [b"a1", 23]],
+        )
 
     @pytest.mark.onlynoncluster
     def test_zunionstore_sum(self, r):
@@ -2734,12 +2931,12 @@ def test_zunionstore_sum(self, r):
         r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
         r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
         assert r.zunionstore("d", ["a", "b", "c"]) == 4
-        assert r.zrange("d", 0, -1, withscores=True) == [
-            (b"a2", 3),
-            (b"a4", 4),
-            (b"a3", 8),
-            (b"a1", 9),
-        ]
+        assert_resp_response(
+            r,
+            r.zrange("d", 0, -1, withscores=True),
+            [(b"a2", 3), (b"a4", 4), (b"a3", 8), (b"a1", 9)],
+            [[b"a2", 3], [b"a4", 4], [b"a3", 8], [b"a1", 9]],
+        )
 
     @pytest.mark.onlynoncluster
     def test_zunionstore_max(self, r):
@@ -2747,12 +2944,12 @@ def test_zunionstore_max(self, r):
         r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
         r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
         assert r.zunionstore("d", ["a", "b", "c"], aggregate="MAX") == 4
-        assert r.zrange("d", 0, -1, withscores=True) == [
-            (b"a2", 2),
-            (b"a4", 4),
-            (b"a3", 5),
-            (b"a1", 6),
-        ]
+        assert_resp_response(
+            r,
+            r.zrange("d", 0, -1, withscores=True),
+            [(b"a2", 2), (b"a4", 4), (b"a3", 5), (b"a1", 6)],
+            [[b"a2", 2], [b"a4", 4], [b"a3", 5], [b"a1", 6]],
+        )
 
     @pytest.mark.onlynoncluster
     def test_zunionstore_min(self, r):
@@ -2760,12 +2957,12 @@ def test_zunionstore_min(self, r):
         r.zadd("b", {"a1": 2, "a2": 2, "a3": 4})
         r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
         assert r.zunionstore("d", ["a", "b", "c"], aggregate="MIN") == 4
-        assert r.zrange("d", 0, -1, withscores=True) == [
-            (b"a1", 1),
-            (b"a2", 2),
-            (b"a3", 3),
-            (b"a4", 4),
-        ]
+        assert_resp_response(
+            r,
+            r.zrange("d", 0, -1, withscores=True),
+            [(b"a1", 1), (b"a2", 2), (b"a3", 3), (b"a4", 4)],
+            [[b"a1", 1], [b"a2", 2], [b"a3", 3], [b"a4", 4]],
+        )
 
     @pytest.mark.onlynoncluster
     def test_zunionstore_with_weight(self, r):
@@ -2773,12 +2970,12 @@ def test_zunionstore_with_weight(self, r):
         r.zadd("b", {"a1": 2, "a2": 2, "a3": 2})
         r.zadd("c", {"a1": 6, "a3": 5, "a4": 4})
         assert r.zunionstore("d", {"a": 1, "b": 2, "c": 3}) == 4
-        assert r.zrange("d", 0, -1, withscores=True) == [
-            (b"a2", 5),
-            (b"a4", 12),
-            (b"a3", 20),
-            (b"a1", 23),
-        ]
+        assert_resp_response(
+            r,
+            r.zrange("d", 0, -1, withscores=True),
+            [(b"a2", 5), (b"a4", 12), (b"a3", 20), (b"a1", 23)],
+            [[b"a2", 5], [b"a4", 12], [b"a3", 20], [b"a1", 23]],
+        )
 
     @skip_if_server_version_lt("6.1.240")
     def test_zmscore(self, r):
@@ -3293,11 +3490,12 @@ def test_geohash(self, r):
             "place2",
         )
         r.geoadd("barcelona", values)
-        assert r.geohash("barcelona", "place1", "place2", "place3") == [
-            "sp3e9yg3kd0",
-            "sp3e9cbc3t0",
-            None,
-        ]
+        assert_resp_response(
+            r,
+            r.geohash("barcelona", "place1", "place2", "place3"),
+            ["sp3e9yg3kd0", "sp3e9cbc3t0", None],
+            [b"sp3e9yg3kd0", b"sp3e9cbc3t0", None],
+        )
 
     @skip_unless_arch_bits(64)
     @skip_if_server_version_lt("3.2.0")
@@ -3309,10 +3507,18 @@ def test_geopos(self, r):
         )
         r.geoadd("barcelona", values)
         # redis uses 52 bits precision, hereby small errors may be introduced.
-        assert r.geopos("barcelona", "place1", "place2") == [
-            (2.19093829393386841, 41.43379028184083523),
-            (2.18737632036209106, 41.40634178640635099),
-        ]
+        assert_resp_response(
+            r,
+            r.geopos("barcelona", "place1", "place2"),
+            [
+                (2.19093829393386841, 41.43379028184083523),
+                (2.18737632036209106, 41.40634178640635099),
+            ],
+            [
+                [2.19093829393386841, 41.43379028184083523],
+                [2.18737632036209106, 41.40634178640635099],
+            ],
+        )
 
     @skip_if_server_version_lt("4.0.0")
     def test_geopos_no_value(self, r):
@@ -3852,7 +4058,7 @@ def test_xadd_explicit_ms(self, r: redis.Redis):
         ms = message_id[: message_id.index(b"-")]
         assert ms == b"9999999999999999999"
 
-    @skip_if_server_version_lt("6.2.0")
+    @skip_if_server_version_lt("7.0.0")
     def test_xautoclaim(self, r):
         stream = "stream"
         group = "group"
@@ -3867,7 +4073,7 @@ def test_xautoclaim(self, r):
         # trying to claim a message that isn't already pending doesn't
         # do anything
         response = r.xautoclaim(stream, group, consumer2, min_idle_time=0)
-        assert response == [b"0-0", []]
+        assert response == [b"0-0", [], []]
 
         # read the group as consumer1 to initially claim the messages
         r.xreadgroup(group, consumer1, streams={stream: ">"})
@@ -4111,7 +4317,7 @@ def test_xgroup_setid(self, r):
         ]
         assert r.xinfo_groups(stream) == expected
 
-    @skip_if_server_version_lt("5.0.0")
+    @skip_if_server_version_lt("7.2.0")
     def test_xinfo_consumers(self, r):
         stream = "stream"
         group = "group"
@@ -4127,8 +4333,8 @@ def test_xinfo_consumers(self, r):
         info = r.xinfo_consumers(stream, group)
         assert len(info) == 2
         expected = [
-            {"name": consumer1.encode(), "pending": 1},
-            {"name": consumer2.encode(), "pending": 2},
+            {"name": consumer1.encode(), "pending": 1, "inactive": 2},
+            {"name": consumer2.encode(), "pending": 2, "inactive": 2},
         ]
 
         # we can't determine the idle time, so just make sure it's an int
@@ -4159,7 +4365,12 @@ def test_xinfo_stream_full(self, r):
         info = r.xinfo_stream(stream, full=True)
 
         assert info["length"] == 1
-        assert m1 in info["entries"]
+        assert_resp_response_in(
+            r,
+            m1,
+            info["entries"],
+            info["entries"].keys(),
+        )
         assert len(info["groups"]) == 1
 
     @skip_if_server_version_lt("5.0.0")
@@ -4300,25 +4511,39 @@ def test_xread(self, r):
         m1 = r.xadd(stream, {"foo": "bar"})
         m2 = r.xadd(stream, {"bing": "baz"})
 
-        expected = [
-            [
-                stream.encode(),
-                [get_stream_message(r, stream, m1), get_stream_message(r, stream, m2)],
-            ]
+        stream_name = stream.encode()
+        expected_entries = [
+            get_stream_message(r, stream, m1),
+            get_stream_message(r, stream, m2),
         ]
         # xread starting at 0 returns both messages
-        assert r.xread(streams={stream: 0}) == expected
+        assert_resp_response(
+            r,
+            r.xread(streams={stream: 0}),
+            [[stream_name, expected_entries]],
+            {stream_name: [expected_entries]},
+        )
 
-        expected = [[stream.encode(), [get_stream_message(r, stream, m1)]]]
+        expected_entries = [get_stream_message(r, stream, m1)]
         # xread starting at 0 and count=1 returns only the first message
-        assert r.xread(streams={stream: 0}, count=1) == expected
+        assert_resp_response(
+            r,
+            r.xread(streams={stream: 0}, count=1),
+            [[stream_name, expected_entries]],
+            {stream_name: [expected_entries]},
+        )
 
-        expected = [[stream.encode(), [get_stream_message(r, stream, m2)]]]
+        expected_entries = [get_stream_message(r, stream, m2)]
         # xread starting at m1 returns only the second message
-        assert r.xread(streams={stream: m1}) == expected
+        assert_resp_response(
+            r,
+            r.xread(streams={stream: m1}),
+            [[stream_name, expected_entries]],
+            {stream_name: [expected_entries]},
+        )
 
         # xread starting at the last message returns an empty list
-        assert r.xread(streams={stream: m2}) == []
+        assert_resp_response(r, r.xread(streams={stream: m2}), [], {})
 
     @skip_if_server_version_lt("5.0.0")
     def test_xreadgroup(self, r):
@@ -4329,21 +4554,32 @@ def test_xreadgroup(self, r):
         m2 = r.xadd(stream, {"bing": "baz"})
         r.xgroup_create(stream, group, 0)
 
-        expected = [
-            [
-                stream.encode(),
-                [get_stream_message(r, stream, m1), get_stream_message(r, stream, m2)],
-            ]
+        stream_name = stream.encode()
+        expected_entries = [
+            get_stream_message(r, stream, m1),
+            get_stream_message(r, stream, m2),
         ]
+
         # xread starting at 0 returns both messages
-        assert r.xreadgroup(group, consumer, streams={stream: ">"}) == expected
+        assert_resp_response(
+            r,
+            r.xreadgroup(group, consumer, streams={stream: ">"}),
+            [[stream_name, expected_entries]],
+            {stream_name: [expected_entries]},
+        )
 
         r.xgroup_destroy(stream, group)
         r.xgroup_create(stream, group, 0)
 
-        expected = [[stream.encode(), [get_stream_message(r, stream, m1)]]]
+        expected_entries = [get_stream_message(r, stream, m1)]
+
         # xread with count=1 returns only the first message
-        assert r.xreadgroup(group, consumer, streams={stream: ">"}, count=1) == expected
+        assert_resp_response(
+            r,
+            r.xreadgroup(group, consumer, streams={stream: ">"}, count=1),
+            [[stream_name, expected_entries]],
+            {stream_name: [expected_entries]},
+        )
 
         r.xgroup_destroy(stream, group)
 
@@ -4351,27 +4587,37 @@ def test_xreadgroup(self, r):
         # will only find messages added after this
         r.xgroup_create(stream, group, "$")
 
-        expected = []
         # xread starting after the last message returns an empty message list
-        assert r.xreadgroup(group, consumer, streams={stream: ">"}) == expected
+        assert_resp_response(
+            r, r.xreadgroup(group, consumer, streams={stream: ">"}), [], {}
+        )
 
         # xreadgroup with noack does not have any items in the PEL
         r.xgroup_destroy(stream, group)
         r.xgroup_create(stream, group, "0")
-        assert (
-            len(r.xreadgroup(group, consumer, streams={stream: ">"}, noack=True)[0][1])
-            == 2
-        )
-        # now there should be nothing pending
-        assert len(r.xreadgroup(group, consumer, streams={stream: "0"})[0][1]) == 0
+        res = r.xreadgroup(group, consumer, streams={stream: ">"}, noack=True)
+        empty_res = r.xreadgroup(group, consumer, streams={stream: "0"})
+        if is_resp2_connection(r):
+            assert len(res[0][1]) == 2
+            # now there should be nothing pending
+            assert len(empty_res[0][1]) == 0
+        else:
+            assert len(res[stream_name][0]) == 2
+            # now there should be nothing pending
+            assert len(empty_res[stream_name][0]) == 0
 
         r.xgroup_destroy(stream, group)
         r.xgroup_create(stream, group, "0")
         # delete all the messages in the stream
-        expected = [[stream.encode(), [(m1, {}), (m2, {})]]]
+        expected_entries = [(m1, {}), (m2, {})]
         r.xreadgroup(group, consumer, streams={stream: ">"})
         r.xtrim(stream, 0)
-        assert r.xreadgroup(group, consumer, streams={stream: "0"}) == expected
+        assert_resp_response(
+            r,
+            r.xreadgroup(group, consumer, streams={stream: "0"}),
+            [[stream_name, expected_entries]],
+            {stream_name: [expected_entries]},
+        )
 
     @skip_if_server_version_lt("5.0.0")
     def test_xrevrange(self, r):
@@ -4637,7 +4883,7 @@ def test_command_list(self, r: redis.Redis):
     @skip_if_redis_enterprise()
     def test_command_getkeys(self, r):
         res = r.command_getkeys("MSET", "a", "b", "c", "d", "e", "f")
-        assert res == ["a", "c", "e"]
+        assert_resp_response(r, res, ["a", "c", "e"], [b"a", b"c", b"e"])
         res = r.command_getkeys(
             "EVAL",
             '"not consulted"',
@@ -4650,7 +4896,9 @@ def test_command_getkeys(self, r):
             "arg3",
             "argN",
         )
-        assert res == ["key1", "key2", "key3"]
+        assert_resp_response(
+            r, res, ["key1", "key2", "key3"], [b"key1", b"key2", b"key3"]
+        )
 
     @skip_if_server_version_lt("2.8.13")
     def test_command(self, r):
@@ -4664,12 +4912,17 @@ def test_command(self, r):
     @skip_if_server_version_lt("7.0.0")
     @skip_if_redis_enterprise()
     def test_command_getkeysandflags(self, r: redis.Redis):
-        res = [
-            [b"mylist1", [b"RW", b"access", b"delete"]],
-            [b"mylist2", [b"RW", b"insert"]],
-        ]
-        assert res == r.command_getkeysandflags(
-            "LMOVE", "mylist1", "mylist2", "left", "left"
+        assert_resp_response(
+            r,
+            r.command_getkeysandflags("LMOVE", "mylist1", "mylist2", "left", "left"),
+            [
+                [b"mylist1", [b"RW", b"access", b"delete"]],
+                [b"mylist2", [b"RW", b"insert"]],
+            ],
+            [
+                [b"mylist1", {b"RW", b"access", b"delete"}],
+                [b"mylist2", {b"RW", b"insert"}],
+            ],
         )
 
     @pytest.mark.onlynoncluster
@@ -4765,6 +5018,8 @@ def test_shutdown_with_params(self, r: redis.Redis):
     @skip_if_server_version_lt("2.8.0")
     @skip_if_redis_enterprise()
     def test_sync(self, r):
+        r.flushdb()
+        time.sleep(1)
         r2 = redis.Redis(port=6380, decode_responses=False)
         res = r2.sync()
         assert b"REDIS" in res
diff --git a/tests/test_connect.py b/tests/test_connect.py
index b4ec7020e1..b233c67e83 100644
--- a/tests/test_connect.py
+++ b/tests/test_connect.py
@@ -6,7 +6,6 @@
 import threading
 
 import pytest
-
 from redis.connection import Connection, SSLConnection, UnixDomainSocketConnection
 
 from .ssl_utils import get_ssl_filename
diff --git a/tests/test_connection.py b/tests/test_connection.py
index 31268a9e8b..760b23c9c1 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -4,16 +4,10 @@
 from unittest.mock import patch
 
 import pytest
-
 import redis
+from redis._parsers import _HiredisParser, _RESP2Parser, _RESP3Parser
 from redis.backoff import NoBackoff
-from redis.connection import (
-    Connection,
-    HiredisParser,
-    PythonParser,
-    SSLConnection,
-    UnixDomainSocketConnection,
-)
+from redis.connection import Connection, SSLConnection, UnixDomainSocketConnection
 from redis.exceptions import ConnectionError, InvalidResponse, TimeoutError
 from redis.retry import Retry
 from redis.utils import HIREDIS_AVAILABLE
@@ -35,22 +29,22 @@ def test_invalid_response(r):
 
 @skip_if_server_version_lt("4.0.0")
 @pytest.mark.redismod
-def test_loading_external_modules(modclient):
+def test_loading_external_modules(r):
     def inner():
         pass
 
-    modclient.load_external_module("myfuncname", inner)
-    assert getattr(modclient, "myfuncname") == inner
-    assert isinstance(getattr(modclient, "myfuncname"), types.FunctionType)
+    r.load_external_module("myfuncname", inner)
+    assert getattr(r, "myfuncname") == inner
+    assert isinstance(getattr(r, "myfuncname"), types.FunctionType)
 
     # and call it
     from redis.commands import RedisModuleCommands
 
     j = RedisModuleCommands.json
-    modclient.load_external_module("sometestfuncname", j)
+    r.load_external_module("sometestfuncname", j)
 
     # d = {'hello': 'world!'}
-    # mod = j(modclient)
+    # mod = j(r)
     # mod.set("fookey", ".", d)
     # assert mod.get('fookey') == d
 
@@ -134,7 +128,9 @@ def test_connect_timeout_error_without_retry(self):
 
 @pytest.mark.onlynoncluster
 @pytest.mark.parametrize(
-    "parser_class", [PythonParser, HiredisParser], ids=["PythonParser", "HiredisParser"]
+    "parser_class",
+    [_RESP2Parser, _RESP3Parser, _HiredisParser],
+    ids=["RESP2Parser", "RESP3Parser", "HiredisParser"],
 )
 def test_connection_parse_response_resume(r: redis.Redis, parser_class):
     """
@@ -142,7 +138,7 @@ def test_connection_parse_response_resume(r: redis.Redis, parser_class):
     be that PythonParser or HiredisParser,
     can be interrupted at IO time and then resume parsing.
     """
-    if parser_class is HiredisParser and not HIREDIS_AVAILABLE:
+    if parser_class is _HiredisParser and not HIREDIS_AVAILABLE:
         pytest.skip("Hiredis not available)")
     args = dict(r.connection_pool.connection_kwargs)
     args["parser_class"] = parser_class
@@ -154,7 +150,7 @@ def test_connection_parse_response_resume(r: redis.Redis, parser_class):
     )
     mock_socket = MockSocket(message, interrupt_every=2)
 
-    if isinstance(conn._parser, PythonParser):
+    if isinstance(conn._parser, _RESP2Parser) or isinstance(conn._parser, _RESP3Parser):
         conn._parser._buffer._sock = mock_socket
     else:
         conn._parser._sock = mock_socket
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 155bffe56a..ab0fc6be98 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -5,9 +5,9 @@
 from unittest import mock
 
 import pytest
-
 import redis
-from redis.connection import ssl_available, to_bool
+from redis.connection import to_bool
+from redis.utils import SSL_AVAILABLE
 
 from .conftest import _get_client, skip_if_redis_enterprise, skip_if_server_version_lt
 from .test_pubsub import wait_for_message
@@ -425,7 +425,7 @@ class MyConnection(redis.UnixDomainSocketConnection):
         assert pool.connection_class == MyConnection
 
 
-@pytest.mark.skipif(not ssl_available, reason="SSL not installed")
+@pytest.mark.skipif(not SSL_AVAILABLE, reason="SSL not installed")
 class TestSSLConnectionURLParsing:
     def test_host(self):
         pool = redis.ConnectionPool.from_url("rediss://my.host")
diff --git a/tests/test_credentials.py b/tests/test_credentials.py
index 9aeb1ef1d5..aade04e082 100644
--- a/tests/test_credentials.py
+++ b/tests/test_credentials.py
@@ -4,7 +4,6 @@
 from typing import Optional, Tuple, Union
 
 import pytest
-
 import redis
 from redis import AuthenticationError, DataError, ResponseError
 from redis.credentials import CredentialProvider, UsernamePasswordCredentialProvider
@@ -198,6 +197,12 @@ def test_change_username_password_on_existing_connection(self, r, request):
         password = "origin_password"
         new_username = "new_username"
         new_password = "new_password"
+
+        def teardown():
+            r.acl_deluser(new_username)
+
+        request.addfinalizer(teardown)
+
         init_acl_user(r, request, username, password)
         r2 = _get_client(
             redis.Redis, request, flushdb=False, username=username, password=password
diff --git a/tests/test_encoding.py b/tests/test_encoding.py
index cb9c4e20be..331cd5108c 100644
--- a/tests/test_encoding.py
+++ b/tests/test_encoding.py
@@ -1,5 +1,4 @@
 import pytest
-
 import redis
 from redis.connection import Connection
 from redis.utils import HIREDIS_PACK_AVAILABLE
diff --git a/tests/test_function.py b/tests/test_function.py
index 7ce66a38e6..22db904273 100644
--- a/tests/test_function.py
+++ b/tests/test_function.py
@@ -1,8 +1,7 @@
 import pytest
-
 from redis.exceptions import ResponseError
 
-from .conftest import skip_if_server_version_lt
+from .conftest import assert_resp_response, skip_if_server_version_lt
 
 engine = "lua"
 lib = "mylib"
@@ -64,12 +63,22 @@ def test_function_list(self, r):
                 [[b"name", b"myfunc", b"description", None, b"flags", [b"no-writes"]]],
             ]
         ]
-        assert r.function_list() == res
-        assert r.function_list(library="*lib") == res
-        assert (
-            r.function_list(withcode=True)[0][7]
-            == f"#!{engine} name={lib} \n {function}".encode()
+        resp3_res = [
+            {
+                b"library_name": b"mylib",
+                b"engine": b"LUA",
+                b"functions": [
+                    {b"name": b"myfunc", b"description": None, b"flags": {b"no-writes"}}
+                ],
+            }
+        ]
+        assert_resp_response(r, r.function_list(), res, resp3_res)
+        assert_resp_response(r, r.function_list(library="*lib"), res, resp3_res)
+        res[0].extend(
+            [b"library_code", f"#!{engine} name={lib} \n {function}".encode()]
         )
+        resp3_res[0][b"library_code"] = f"#!{engine} name={lib} \n {function}".encode()
+        assert_resp_response(r, r.function_list(withcode=True), res, resp3_res)
 
     @pytest.mark.onlycluster
     def test_function_list_on_cluster(self, r):
diff --git a/tests/test_graph.py b/tests/test_graph.py
index 37e5ca43aa..42f1d9e5df 100644
--- a/tests/test_graph.py
+++ b/tests/test_graph.py
@@ -1,7 +1,7 @@
 from unittest.mock import patch
 
 import pytest
-
+from redis import Redis
 from redis.commands.graph import Edge, Node, Path
 from redis.commands.graph.execution_plan import Operation
 from redis.commands.graph.query_result import (
@@ -20,13 +20,14 @@
     QueryResult,
 )
 from redis.exceptions import ResponseError
-from tests.conftest import skip_if_redis_enterprise
+from tests.conftest import _get_client, skip_if_redis_enterprise
 
 
 @pytest.fixture
-def client(modclient):
-    modclient.flushdb()
-    return modclient
+def client(request):
+    r = _get_client(Redis, request, decode_responses=True)
+    r.flushdb()
+    return r
 
 
 @pytest.mark.redismod
diff --git a/tests/test_graph_utils/test_edge.py b/tests/test_graph_utils/test_edge.py
index b5b7362389..581ebfab5d 100644
--- a/tests/test_graph_utils/test_edge.py
+++ b/tests/test_graph_utils/test_edge.py
@@ -1,5 +1,4 @@
 import pytest
-
 from redis.commands.graph import edge, node
 
 
diff --git a/tests/test_graph_utils/test_node.py b/tests/test_graph_utils/test_node.py
index cd4e936719..c3b34ac6ff 100644
--- a/tests/test_graph_utils/test_node.py
+++ b/tests/test_graph_utils/test_node.py
@@ -1,5 +1,4 @@
 import pytest
-
 from redis.commands.graph import node
 
 
diff --git a/tests/test_graph_utils/test_path.py b/tests/test_graph_utils/test_path.py
index d581269307..1bd38efab4 100644
--- a/tests/test_graph_utils/test_path.py
+++ b/tests/test_graph_utils/test_path.py
@@ -1,5 +1,4 @@
 import pytest
-
 from redis.commands.graph import edge, node, path
 
 
diff --git a/tests/test_json.py b/tests/test_json.py
index c41ad5e2e1..fb608ff425 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -1,17 +1,17 @@
 import pytest
-
 import redis
-from redis import exceptions
+from redis import Redis, exceptions
 from redis.commands.json.decoders import decode_list, unstring
 from redis.commands.json.path import Path
 
-from .conftest import skip_ifmodversion_lt
+from .conftest import _get_client, assert_resp_response, skip_ifmodversion_lt
 
 
 @pytest.fixture
-def client(modclient):
-    modclient.flushdb()
-    return modclient
+def client(request):
+    r = _get_client(Redis, request, decode_responses=True)
+    r.flushdb()
+    return r
 
 
 @pytest.mark.redismod
@@ -25,7 +25,7 @@ def test_json_setbinarykey(client):
 @pytest.mark.redismod
 def test_json_setgetdeleteforget(client):
     assert client.json().set("foo", Path.root_path(), "bar")
-    assert client.json().get("foo") == "bar"
+    assert_resp_response(client, client.json().get("foo"), "bar", [["bar"]])
     assert client.json().get("baz") is None
     assert client.json().delete("foo") == 1
     assert client.json().forget("foo") == 0  # second delete
@@ -35,13 +35,13 @@ def test_json_setgetdeleteforget(client):
 @pytest.mark.redismod
 def test_jsonget(client):
     client.json().set("foo", Path.root_path(), "bar")
-    assert client.json().get("foo") == "bar"
+    assert_resp_response(client, client.json().get("foo"), "bar", [["bar"]])
 
 
 @pytest.mark.redismod
 def test_json_get_jset(client):
     assert client.json().set("foo", Path.root_path(), "bar")
-    assert "bar" == client.json().get("foo")
+    assert_resp_response(client, client.json().get("foo"), "bar", [["bar"]])
     assert client.json().get("baz") is None
     assert 1 == client.json().delete("foo")
     assert client.exists("foo") == 0
@@ -83,7 +83,10 @@ def test_json_merge(client):
 @pytest.mark.redismod
 def test_nonascii_setgetdelete(client):
     assert client.json().set("notascii", Path.root_path(), "hyvää-élève")
-    assert "hyvää-élève" == client.json().get("notascii", no_escape=True)
+    res = "hyvää-élève"
+    assert_resp_response(
+        client, client.json().get("notascii", no_escape=True), res, [[res]]
+    )
     assert 1 == client.json().delete("notascii")
     assert client.exists("notascii") == 0
 
@@ -129,22 +132,30 @@ def test_mset(client):
 def test_clear(client):
     client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
     assert 1 == client.json().clear("arr", Path.root_path())
-    assert [] == client.json().get("arr")
+    assert_resp_response(client, client.json().get("arr"), [], [[[]]])
 
 
 @pytest.mark.redismod
 def test_type(client):
     client.json().set("1", Path.root_path(), 1)
-    assert "integer" == client.json().type("1", Path.root_path())
-    assert "integer" == client.json().type("1")
+    assert_resp_response(
+        client, client.json().type("1", Path.root_path()), "integer", ["integer"]
+    )
+    assert_resp_response(client, client.json().type("1"), "integer", ["integer"])
 
 
 @pytest.mark.redismod
 def test_numincrby(client):
     client.json().set("num", Path.root_path(), 1)
-    assert 2 == client.json().numincrby("num", Path.root_path(), 1)
-    assert 2.5 == client.json().numincrby("num", Path.root_path(), 0.5)
-    assert 1.25 == client.json().numincrby("num", Path.root_path(), -1.25)
+    assert_resp_response(
+        client, client.json().numincrby("num", Path.root_path(), 1), 2, [2]
+    )
+    assert_resp_response(
+        client, client.json().numincrby("num", Path.root_path(), 0.5), 2.5, [2.5]
+    )
+    assert_resp_response(
+        client, client.json().numincrby("num", Path.root_path(), -1.25), 1.25, [1.25]
+    )
 
 
 @pytest.mark.redismod
@@ -152,9 +163,15 @@ def test_nummultby(client):
     client.json().set("num", Path.root_path(), 1)
 
     with pytest.deprecated_call():
-        assert 2 == client.json().nummultby("num", Path.root_path(), 2)
-        assert 5 == client.json().nummultby("num", Path.root_path(), 2.5)
-        assert 2.5 == client.json().nummultby("num", Path.root_path(), 0.5)
+        assert_resp_response(
+            client, client.json().nummultby("num", Path.root_path(), 2), 2, [2]
+        )
+        assert_resp_response(
+            client, client.json().nummultby("num", Path.root_path(), 2.5), 5, [5]
+        )
+        assert_resp_response(
+            client, client.json().nummultby("num", Path.root_path(), 0.5), 2.5, [2.5]
+        )
 
 
 @pytest.mark.redismod
@@ -173,7 +190,9 @@ def test_toggle(client):
 def test_strappend(client):
     client.json().set("jsonkey", Path.root_path(), "foo")
     assert 6 == client.json().strappend("jsonkey", "bar")
-    assert "foobar" == client.json().get("jsonkey", Path.root_path())
+    assert_resp_response(
+        client, client.json().get("jsonkey", Path.root_path()), "foobar", [["foobar"]]
+    )
 
 
 # @pytest.mark.redismod
@@ -219,12 +238,14 @@ def test_arrindex(client):
 def test_arrinsert(client):
     client.json().set("arr", Path.root_path(), [0, 4])
     assert 5 - -client.json().arrinsert("arr", Path.root_path(), 1, *[1, 2, 3])
-    assert [0, 1, 2, 3, 4] == client.json().get("arr")
+    res = [0, 1, 2, 3, 4]
+    assert_resp_response(client, client.json().get("arr"), res, [[res]])
 
     # test prepends
     client.json().set("val2", Path.root_path(), [5, 6, 7, 8, 9])
     client.json().arrinsert("val2", Path.root_path(), 0, ["some", "thing"])
-    assert client.json().get("val2") == [["some", "thing"], 5, 6, 7, 8, 9]
+    res = [["some", "thing"], 5, 6, 7, 8, 9]
+    assert_resp_response(client, client.json().get("val2"), res, [[res]])
 
 
 @pytest.mark.redismod
@@ -242,7 +263,7 @@ def test_arrpop(client):
     assert 3 == client.json().arrpop("arr", Path.root_path(), -1)
     assert 2 == client.json().arrpop("arr", Path.root_path())
     assert 0 == client.json().arrpop("arr", Path.root_path(), 0)
-    assert [1] == client.json().get("arr")
+    assert_resp_response(client, client.json().get("arr"), [1], [[[1]]])
 
     # test out of bounds
     client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
@@ -257,7 +278,7 @@ def test_arrpop(client):
 def test_arrtrim(client):
     client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
     assert 3 == client.json().arrtrim("arr", Path.root_path(), 1, 3)
-    assert [1, 2, 3] == client.json().get("arr")
+    assert_resp_response(client, client.json().get("arr"), [1, 2, 3], [[[1, 2, 3]]])
 
     # <0 test, should be 0 equivalent
     client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
@@ -319,7 +340,7 @@ def test_json_commands_in_pipeline(client):
     p.set("foo", Path.root_path(), "bar")
     p.get("foo")
     p.delete("foo")
-    assert [True, "bar", 1] == p.execute()
+    assert_resp_response(client, p.execute(), [True, "bar", 1], [True, [["bar"]], 1])
     assert client.keys() == []
     assert client.get("foo") is None
 
@@ -332,7 +353,7 @@ def test_json_commands_in_pipeline(client):
         p.jsonget("foo")
     p.exists("notarealkey")
     p.delete("foo")
-    assert [True, d, 0, 1] == p.execute()
+    assert_resp_response(client, p.execute(), [True, d, 0, 1], [True, [[d]], 0, 1])
     assert client.keys() == []
     assert client.get("foo") is None
 
@@ -342,14 +363,14 @@ def test_json_delete_with_dollar(client):
     doc1 = {"a": 1, "nested": {"a": 2, "b": 3}}
     assert client.json().set("doc1", "$", doc1)
     assert client.json().delete("doc1", "$..a") == 2
-    r = client.json().get("doc1", "$")
-    assert r == [{"nested": {"b": 3}}]
+    res = [{"nested": {"b": 3}}]
+    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
 
     doc2 = {"a": {"a": 2, "b": 3}, "b": ["a", "b"], "nested": {"b": [True, "a", "b"]}}
     assert client.json().set("doc2", "$", doc2)
     assert client.json().delete("doc2", "$..a") == 1
-    res = client.json().get("doc2", "$")
-    assert res == [{"nested": {"b": [True, "a", "b"]}, "b": ["a", "b"]}]
+    res = [{"nested": {"b": [True, "a", "b"]}, "b": ["a", "b"]}]
+    assert_resp_response(client, client.json().get("doc2", "$"), res, [res])
 
     doc3 = [
         {
@@ -380,8 +401,7 @@ def test_json_delete_with_dollar(client):
             }
         ]
     ]
-    res = client.json().get("doc3", "$")
-    assert res == doc3val
+    assert_resp_response(client, client.json().get("doc3", "$"), doc3val, [doc3val])
 
     # Test default path
     assert client.json().delete("doc3") == 1
@@ -395,14 +415,14 @@ def test_json_forget_with_dollar(client):
     doc1 = {"a": 1, "nested": {"a": 2, "b": 3}}
     assert client.json().set("doc1", "$", doc1)
     assert client.json().forget("doc1", "$..a") == 2
-    r = client.json().get("doc1", "$")
-    assert r == [{"nested": {"b": 3}}]
+    res = [{"nested": {"b": 3}}]
+    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
 
     doc2 = {"a": {"a": 2, "b": 3}, "b": ["a", "b"], "nested": {"b": [True, "a", "b"]}}
     assert client.json().set("doc2", "$", doc2)
     assert client.json().forget("doc2", "$..a") == 1
-    res = client.json().get("doc2", "$")
-    assert res == [{"nested": {"b": [True, "a", "b"]}, "b": ["a", "b"]}]
+    res = [{"nested": {"b": [True, "a", "b"]}, "b": ["a", "b"]}]
+    assert_resp_response(client, client.json().get("doc2", "$"), res, [res])
 
     doc3 = [
         {
@@ -433,8 +453,7 @@ def test_json_forget_with_dollar(client):
             }
         ]
     ]
-    res = client.json().get("doc3", "$")
-    assert res == doc3val
+    assert_resp_response(client, client.json().get("doc3", "$"), doc3val, [doc3val])
 
     # Test default path
     assert client.json().forget("doc3") == 1
@@ -457,8 +476,10 @@ def test_json_mget_dollar(client):
         {"a": 4, "b": 5, "nested": {"a": 6}, "c": None, "nested2": {"a": [None]}},
     )
     # Compare also to single JSON.GET
-    assert client.json().get("doc1", "$..a") == [1, 3, None]
-    assert client.json().get("doc2", "$..a") == [4, 6, [None]]
+    res = [1, 3, None]
+    assert_resp_response(client, client.json().get("doc1", "$..a"), res, [res])
+    res = [4, 6, [None]]
+    assert_resp_response(client, client.json().get("doc2", "$..a"), res, [res])
 
     # Test mget with single path
     client.json().mget("doc1", "$..a") == [1, 3, None]
@@ -525,15 +546,14 @@ def test_strappend_dollar(client):
     # Test multi
     client.json().strappend("doc1", "bar", "$..a") == [6, 8, None]
 
-    client.json().get("doc1", "$") == [
-        {"a": "foobar", "nested1": {"a": "hellobar"}, "nested2": {"a": 31}}
-    ]
+    # res = [{"a": "foobar", "nested1": {"a": "hellobar"}, "nested2": {"a": 31}}]
+    # assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+
     # Test single
     client.json().strappend("doc1", "baz", "$.nested1.a") == [11]
 
-    client.json().get("doc1", "$") == [
-        {"a": "foobar", "nested1": {"a": "hellobarbaz"}, "nested2": {"a": 31}}
-    ]
+    # res = [{"a": "foobar", "nested1": {"a": "hellobarbaz"}, "nested2": {"a": 31}}]
+    # assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -541,9 +561,8 @@ def test_strappend_dollar(client):
 
     # Test multi
     client.json().strappend("doc1", "bar", ".*.a") == 8
-    client.json().get("doc1", "$") == [
-        {"a": "foo", "nested1": {"a": "hellobar"}, "nested2": {"a": 31}}
-    ]
+    # res = [{"a": "foo", "nested1": {"a": "hellobar"}, "nested2": {"a": 31}}]
+    # assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
 
     # Test missing path
     with pytest.raises(exceptions.ResponseError):
@@ -585,23 +604,25 @@ def test_arrappend_dollar(client):
     )
     # Test multi
     client.json().arrappend("doc1", "$..a", "bar", "racuda") == [3, 5, None]
-    assert client.json().get("doc1", "$") == [
+    res = [
         {
             "a": ["foo", "bar", "racuda"],
             "nested1": {"a": ["hello", None, "world", "bar", "racuda"]},
             "nested2": {"a": 31},
         }
     ]
+    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
 
     # Test single
     assert client.json().arrappend("doc1", "$.nested1.a", "baz") == [6]
-    assert client.json().get("doc1", "$") == [
+    res = [
         {
             "a": ["foo", "bar", "racuda"],
             "nested1": {"a": ["hello", None, "world", "bar", "racuda", "baz"]},
             "nested2": {"a": 31},
         }
     ]
+    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -620,22 +641,25 @@ def test_arrappend_dollar(client):
     # Test multi (all paths are updated, but return result of last path)
     assert client.json().arrappend("doc1", "..a", "bar", "racuda") == 5
 
-    assert client.json().get("doc1", "$") == [
+    res = [
         {
             "a": ["foo", "bar", "racuda"],
             "nested1": {"a": ["hello", None, "world", "bar", "racuda"]},
             "nested2": {"a": 31},
         }
     ]
+    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+
     # Test single
     assert client.json().arrappend("doc1", ".nested1.a", "baz") == 6
-    assert client.json().get("doc1", "$") == [
+    res = [
         {
             "a": ["foo", "bar", "racuda"],
             "nested1": {"a": ["hello", None, "world", "bar", "racuda", "baz"]},
             "nested2": {"a": 31},
         }
     ]
+    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -656,22 +680,25 @@ def test_arrinsert_dollar(client):
     # Test multi
     assert client.json().arrinsert("doc1", "$..a", "1", "bar", "racuda") == [3, 5, None]
 
-    assert client.json().get("doc1", "$") == [
+    res = [
         {
             "a": ["foo", "bar", "racuda"],
             "nested1": {"a": ["hello", "bar", "racuda", None, "world"]},
             "nested2": {"a": 31},
         }
     ]
+    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+
     # Test single
     assert client.json().arrinsert("doc1", "$.nested1.a", -2, "baz") == [6]
-    assert client.json().get("doc1", "$") == [
+    res = [
         {
             "a": ["foo", "bar", "racuda"],
             "nested1": {"a": ["hello", "bar", "racuda", "baz", None, "world"]},
             "nested2": {"a": 31},
         }
     ]
+    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -743,9 +770,8 @@ def test_arrpop_dollar(client):
     # # # Test multi
     assert client.json().arrpop("doc1", "$..a", 1) == ['"foo"', None, None]
 
-    assert client.json().get("doc1", "$") == [
-        {"a": [], "nested1": {"a": ["hello", "world"]}, "nested2": {"a": 31}}
-    ]
+    res = [{"a": [], "nested1": {"a": ["hello", "world"]}, "nested2": {"a": 31}}]
+    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -763,9 +789,8 @@ def test_arrpop_dollar(client):
     )
     # Test multi (all paths are updated, but return result of last path)
     client.json().arrpop("doc1", "..a", "1") is None
-    assert client.json().get("doc1", "$") == [
-        {"a": [], "nested1": {"a": ["hello", "world"]}, "nested2": {"a": 31}}
-    ]
+    res = [{"a": [], "nested1": {"a": ["hello", "world"]}, "nested2": {"a": 31}}]
+    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
 
     # # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -786,19 +811,17 @@ def test_arrtrim_dollar(client):
     )
     # Test multi
     assert client.json().arrtrim("doc1", "$..a", "1", -1) == [0, 2, None]
-    assert client.json().get("doc1", "$") == [
-        {"a": [], "nested1": {"a": [None, "world"]}, "nested2": {"a": 31}}
-    ]
+    res = [{"a": [], "nested1": {"a": [None, "world"]}, "nested2": {"a": 31}}]
+    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
 
     assert client.json().arrtrim("doc1", "$..a", "1", "1") == [0, 1, None]
-    assert client.json().get("doc1", "$") == [
-        {"a": [], "nested1": {"a": ["world"]}, "nested2": {"a": 31}}
-    ]
+    res = [{"a": [], "nested1": {"a": ["world"]}, "nested2": {"a": 31}}]
+    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+
     # Test single
     assert client.json().arrtrim("doc1", "$.nested1.a", 1, 0) == [0]
-    assert client.json().get("doc1", "$") == [
-        {"a": [], "nested1": {"a": []}, "nested2": {"a": 31}}
-    ]
+    res = [{"a": [], "nested1": {"a": []}, "nested2": {"a": 31}}]
+    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -820,9 +843,8 @@ def test_arrtrim_dollar(client):
 
     # Test single
     assert client.json().arrtrim("doc1", ".nested1.a", "1", "1") == 1
-    assert client.json().get("doc1", "$") == [
-        {"a": [], "nested1": {"a": ["world"]}, "nested2": {"a": 31}}
-    ]
+    res = [{"a": [], "nested1": {"a": ["world"]}, "nested2": {"a": 31}}]
+    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -920,13 +942,17 @@ def test_type_dollar(client):
     jdata, jtypes = load_types_data("a")
     client.json().set("doc1", "$", jdata)
     # Test multi
-    assert client.json().type("doc1", "$..a") == jtypes
+    assert_resp_response(client, client.json().type("doc1", "$..a"), jtypes, [jtypes])
 
     # Test single
-    assert client.json().type("doc1", "$.nested2.a") == [jtypes[1]]
+    assert_resp_response(
+        client, client.json().type("doc1", "$.nested2.a"), [jtypes[1]], [[jtypes[1]]]
+    )
 
     # Test missing key
-    assert client.json().type("non_existing_doc", "..a") is None
+    assert_resp_response(
+        client, client.json().type("non_existing_doc", "..a"), None, [None]
+    )
 
 
 @pytest.mark.redismod
@@ -944,9 +970,10 @@ def test_clear_dollar(client):
     # Test multi
     assert client.json().clear("doc1", "$..a") == 3
 
-    assert client.json().get("doc1", "$") == [
+    res = [
         {"nested1": {"a": {}}, "a": [], "nested2": {"a": "claro"}, "nested3": {"a": {}}}
     ]
+    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
 
     # Test single
     client.json().set(
@@ -960,7 +987,7 @@ def test_clear_dollar(client):
         },
     )
     assert client.json().clear("doc1", "$.nested1.a") == 1
-    assert client.json().get("doc1", "$") == [
+    res = [
         {
             "nested1": {"a": {}},
             "a": ["foo"],
@@ -968,10 +995,11 @@ def test_clear_dollar(client):
             "nested3": {"a": {"baz": 50}},
         }
     ]
+    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
 
     # Test missing path (defaults to root)
     assert client.json().clear("doc1") == 1
-    assert client.json().get("doc1", "$") == [{}]
+    assert_resp_response(client, client.json().get("doc1", "$"), [{}], [[{}]])
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -992,7 +1020,7 @@ def test_toggle_dollar(client):
     )
     # Test multi
     assert client.json().toggle("doc1", "$..a") == [None, 1, None, 0]
-    assert client.json().get("doc1", "$") == [
+    res = [
         {
             "a": ["foo"],
             "nested1": {"a": True},
@@ -1000,6 +1028,7 @@ def test_toggle_dollar(client):
             "nested3": {"a": False},
         }
     ]
+    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -1075,7 +1104,7 @@ def test_resp_dollar(client):
     client.json().set("doc1", "$", data)
     # Test multi
     res = client.json().resp("doc1", "$..a")
-    assert res == [
+    resp2 = [
         [
             "{",
             "A1_B1",
@@ -1131,10 +1160,67 @@ def test_resp_dollar(client):
             ["{", "A2_B4_C1", "bar"],
         ],
     ]
+    resp3 = [
+        [
+            "{",
+            "A1_B1",
+            10,
+            "A1_B2",
+            "false",
+            "A1_B3",
+            [
+                "{",
+                "A1_B3_C1",
+                None,
+                "A1_B3_C2",
+                [
+                    "[",
+                    "A1_B3_C2_D1_1",
+                    "A1_B3_C2_D1_2",
+                    -19.5,
+                    "A1_B3_C2_D1_4",
+                    "A1_B3_C2_D1_5",
+                    ["{", "A1_B3_C2_D1_6_E1", "true"],
+                ],
+                "A1_B3_C3",
+                ["[", 1],
+            ],
+            "A1_B4",
+            ["{", "A1_B4_C1", "foo"],
+        ],
+        [
+            "{",
+            "A2_B1",
+            20,
+            "A2_B2",
+            "false",
+            "A2_B3",
+            [
+                "{",
+                "A2_B3_C1",
+                None,
+                "A2_B3_C2",
+                [
+                    "[",
+                    "A2_B3_C2_D1_1",
+                    "A2_B3_C2_D1_2",
+                    -37.5,
+                    "A2_B3_C2_D1_4",
+                    "A2_B3_C2_D1_5",
+                    ["{", "A2_B3_C2_D1_6_E1", "false"],
+                ],
+                "A2_B3_C3",
+                ["[", 2],
+            ],
+            "A2_B4",
+            ["{", "A2_B4_C1", "bar"],
+        ],
+    ]
+    assert_resp_response(client, res, resp2, resp3)
 
     # Test single
-    resSingle = client.json().resp("doc1", "$.L1.a")
-    assert resSingle == [
+    res = client.json().resp("doc1", "$.L1.a")
+    resp2 = [
         [
             "{",
             "A1_B1",
@@ -1163,6 +1249,36 @@ def test_resp_dollar(client):
             ["{", "A1_B4_C1", "foo"],
         ]
     ]
+    resp3 = [
+        [
+            "{",
+            "A1_B1",
+            10,
+            "A1_B2",
+            "false",
+            "A1_B3",
+            [
+                "{",
+                "A1_B3_C1",
+                None,
+                "A1_B3_C2",
+                [
+                    "[",
+                    "A1_B3_C2_D1_1",
+                    "A1_B3_C2_D1_2",
+                    -19.5,
+                    "A1_B3_C2_D1_4",
+                    "A1_B3_C2_D1_5",
+                    ["{", "A1_B3_C2_D1_6_E1", "true"],
+                ],
+                "A1_B3_C3",
+                ["[", 1],
+            ],
+            "A1_B4",
+            ["{", "A1_B4_C1", "foo"],
+        ]
+    ]
+    assert_resp_response(client, res, resp2, resp3)
 
     # Test missing path
     client.json().resp("doc1", "$.nowhere")
@@ -1217,10 +1333,13 @@ def test_arrindex_dollar(client):
         },
     )
 
-    assert client.json().get("store", "$.store.book[?(@.price<10)].size") == [
-        [10, 20, 30, 40],
-        [5, 10, 20, 30],
-    ]
+    assert_resp_response(
+        client,
+        client.json().get("store", "$.store.book[?(@.price<10)].size"),
+        [[10, 20, 30, 40], [5, 10, 20, 30]],
+        [[[10, 20, 30, 40], [5, 10, 20, 30]]],
+    )
+
     assert client.json().arrindex(
         "store", "$.store.book[?(@.price<10)].size", "20"
     ) == [-1, -1]
@@ -1241,13 +1360,14 @@ def test_arrindex_dollar(client):
         ],
     )
 
-    assert client.json().get("test_num", "$..arr") == [
+    res = [
         [0, 1, 3.0, 3, 2, 1, 0, 3],
         [5, 4, 3, 2, 1, 0, 1, 2, 3.0, 2, 4, 5],
         [2, 4, 6],
         "3",
         [],
     ]
+    assert_resp_response(client, client.json().get("test_num", "$..arr"), res, [res])
 
     assert client.json().arrindex("test_num", "$..arr", 3) == [3, 2, -1, None, -1]
 
@@ -1273,13 +1393,14 @@ def test_arrindex_dollar(client):
             ],
         ],
     )
-    assert client.json().get("test_string", "$..arr") == [
+    res = [
         ["bazzz", "bar", 2, "baz", 2, "ba", "baz", 3],
         [None, "baz2", "buzz", 2, 1, 0, 1, "2", "baz", 2, 4, 5],
         ["baz2", 4, 6],
         "3",
         [],
     ]
+    assert_resp_response(client, client.json().get("test_string", "$..arr"), res, [res])
 
     assert client.json().arrindex("test_string", "$..arr", "baz") == [
         3,
@@ -1365,13 +1486,14 @@ def test_arrindex_dollar(client):
             ],
         ],
     )
-    assert client.json().get("test_None", "$..arr") == [
+    res = [
         ["bazzz", "None", 2, None, 2, "ba", "baz", 3],
         ["zaz", "baz2", "buzz", 2, 1, 0, 1, "2", None, 2, 4, 5],
         ["None", 4, 6],
         None,
         [],
     ]
+    assert_resp_response(client, client.json().get("test_None", "$..arr"), res, [res])
 
     # Test with none-scalar value
     assert client.json().arrindex(
@@ -1412,7 +1534,7 @@ def test_custom_decoder(client):
 
     cj = client.json(encoder=ujson, decoder=ujson)
     assert cj.set("foo", Path.root_path(), "bar")
-    assert "bar" == cj.get("foo")
+    assert_resp_response(client, cj.get("foo"), "bar", [["bar"]])
     assert cj.get("baz") is None
     assert 1 == cj.delete("foo")
     assert client.exists("foo") == 0
@@ -1434,7 +1556,7 @@ def test_set_file(client):
     nojsonfile.write(b"Hello World")
 
     assert client.json().set_file("test", Path.root_path(), jsonfile.name)
-    assert client.json().get("test") == obj
+    assert_resp_response(client, client.json().get("test"), obj, [[obj]])
     with pytest.raises(json.JSONDecodeError):
         client.json().set_file("test2", Path.root_path(), nojsonfile.name)
 
@@ -1456,4 +1578,7 @@ def test_set_path(client):
 
     result = {jsonfile: True, nojsonfile: False}
     assert client.json().set_path(Path.root_path(), root) == result
-    assert client.json().get(jsonfile.rsplit(".")[0]) == {"hello": "world"}
+    res = {"hello": "world"}
+    assert_resp_response(
+        client, client.json().get(jsonfile.rsplit(".")[0]), res, [[res]]
+    )
diff --git a/tests/test_lock.py b/tests/test_lock.py
index 10ad7e1539..b4b9b32917 100644
--- a/tests/test_lock.py
+++ b/tests/test_lock.py
@@ -1,7 +1,6 @@
 import time
 
 import pytest
-
 from redis.client import Redis
 from redis.exceptions import LockError, LockNotOwnedError
 from redis.lock import Lock
diff --git a/tests/test_multiprocessing.py b/tests/test_multiprocessing.py
index 32f5e23d53..5cda3190a6 100644
--- a/tests/test_multiprocessing.py
+++ b/tests/test_multiprocessing.py
@@ -2,7 +2,6 @@
 import multiprocessing
 
 import pytest
-
 import redis
 from redis.connection import Connection, ConnectionPool
 from redis.exceptions import ConnectionError
diff --git a/tests/test_pipeline.py b/tests/test_pipeline.py
index 716cd0fbf6..7b048eec01 100644
--- a/tests/test_pipeline.py
+++ b/tests/test_pipeline.py
@@ -1,5 +1,4 @@
 import pytest
-
 import redis
 
 from .conftest import skip_if_server_version_lt, wait_for_command
@@ -19,7 +18,6 @@ def test_pipeline(self, r):
                 .zadd("z", {"z1": 1})
                 .zadd("z", {"z2": 4})
                 .zincrby("z", 1, "z1")
-                .zrange("z", 0, 5, withscores=True)
             )
             assert pipe.execute() == [
                 True,
@@ -27,7 +25,6 @@ def test_pipeline(self, r):
                 True,
                 True,
                 2.0,
-                [(b"z1", 2.0), (b"z2", 4)],
             ]
 
     def test_pipeline_memoryview(self, r):
diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index 5d86934de6..ba097e3194 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -3,24 +3,39 @@
 import socket
 import threading
 import time
+from collections import defaultdict
 from unittest import mock
 from unittest.mock import patch
 
 import pytest
-
 import redis
 from redis.exceptions import ConnectionError
+from redis.utils import HIREDIS_AVAILABLE
 
-from .conftest import _get_client, skip_if_redis_enterprise, skip_if_server_version_lt
+from .conftest import (
+    _get_client,
+    is_resp2_connection,
+    skip_if_redis_enterprise,
+    skip_if_server_version_lt,
+)
 
 
-def wait_for_message(pubsub, timeout=0.5, ignore_subscribe_messages=False):
+def wait_for_message(
+    pubsub, timeout=0.5, ignore_subscribe_messages=False, node=None, func=None
+):
     now = time.time()
     timeout = now + timeout
     while now < timeout:
-        message = pubsub.get_message(
-            ignore_subscribe_messages=ignore_subscribe_messages
-        )
+        if node:
+            message = pubsub.get_sharded_message(
+                ignore_subscribe_messages=ignore_subscribe_messages, target_node=node
+            )
+        elif func:
+            message = func(ignore_subscribe_messages=ignore_subscribe_messages)
+        else:
+            message = pubsub.get_message(
+                ignore_subscribe_messages=ignore_subscribe_messages
+            )
         if message is not None:
             return message
         time.sleep(0.01)
@@ -47,6 +62,15 @@ def make_subscribe_test_data(pubsub, type):
             "unsub_func": pubsub.unsubscribe,
             "keys": ["foo", "bar", "uni" + chr(4456) + "code"],
         }
+    elif type == "shard_channel":
+        return {
+            "p": pubsub,
+            "sub_type": "ssubscribe",
+            "unsub_type": "sunsubscribe",
+            "sub_func": pubsub.ssubscribe,
+            "unsub_func": pubsub.sunsubscribe,
+            "keys": ["foo", "bar", "uni" + chr(4456) + "code"],
+        }
     elif type == "pattern":
         return {
             "p": pubsub,
@@ -87,6 +111,44 @@ def test_pattern_subscribe_unsubscribe(self, r):
         kwargs = make_subscribe_test_data(r.pubsub(), "pattern")
         self._test_subscribe_unsubscribe(**kwargs)
 
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("7.0.0")
+    def test_shard_channel_subscribe_unsubscribe(self, r):
+        kwargs = make_subscribe_test_data(r.pubsub(), "shard_channel")
+        self._test_subscribe_unsubscribe(**kwargs)
+
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("7.0.0")
+    def test_shard_channel_subscribe_unsubscribe_cluster(self, r):
+        node_channels = defaultdict(int)
+        p = r.pubsub()
+        keys = {
+            "foo": r.get_node_from_key("foo"),
+            "bar": r.get_node_from_key("bar"),
+            "uni" + chr(4456) + "code": r.get_node_from_key("uni" + chr(4456) + "code"),
+        }
+
+        for key, node in keys.items():
+            assert p.ssubscribe(key) is None
+
+        # should be a message for each shard_channel we just subscribed to
+        for key, node in keys.items():
+            node_channels[node.name] += 1
+            assert wait_for_message(p, node=node) == make_message(
+                "ssubscribe", key, node_channels[node.name]
+            )
+
+        for key in keys.keys():
+            assert p.sunsubscribe(key) is None
+
+        # should be a message for each shard_channel we just unsubscribed
+        # from
+        for key, node in keys.items():
+            node_channels[node.name] -= 1
+            assert wait_for_message(p, node=node) == make_message(
+                "sunsubscribe", key, node_channels[node.name]
+            )
+
     def _test_resubscribe_on_reconnection(
         self, p, sub_type, unsub_type, sub_func, unsub_func, keys
     ):
@@ -130,6 +192,12 @@ def test_resubscribe_to_patterns_on_reconnection(self, r):
         kwargs = make_subscribe_test_data(r.pubsub(), "pattern")
         self._test_resubscribe_on_reconnection(**kwargs)
 
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("7.0.0")
+    def test_resubscribe_to_shard_channels_on_reconnection(self, r):
+        kwargs = make_subscribe_test_data(r.pubsub(), "shard_channel")
+        self._test_resubscribe_on_reconnection(**kwargs)
+
     def _test_subscribed_property(
         self, p, sub_type, unsub_type, sub_func, unsub_func, keys
     ):
@@ -186,38 +254,111 @@ def test_subscribe_property_with_patterns(self, r):
         kwargs = make_subscribe_test_data(r.pubsub(), "pattern")
         self._test_subscribed_property(**kwargs)
 
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("7.0.0")
+    def test_subscribe_property_with_shard_channels(self, r):
+        kwargs = make_subscribe_test_data(r.pubsub(), "shard_channel")
+        self._test_subscribed_property(**kwargs)
+
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("7.0.0")
+    def test_subscribe_property_with_shard_channels_cluster(self, r):
+        p = r.pubsub()
+        keys = ["foo", "bar", "uni" + chr(4456) + "code"]
+        nodes = [r.get_node_from_key(key) for key in keys]
+        assert p.subscribed is False
+        p.ssubscribe(keys[0])
+        # we're now subscribed even though we haven't processed the
+        # reply from the server just yet
+        assert p.subscribed is True
+        assert wait_for_message(p, node=nodes[0]) == make_message(
+            "ssubscribe", keys[0], 1
+        )
+        # we're still subscribed
+        assert p.subscribed is True
+
+        # unsubscribe from all shard_channels
+        p.sunsubscribe()
+        # we're still technically subscribed until we process the
+        # response messages from the server
+        assert p.subscribed is True
+        assert wait_for_message(p, node=nodes[0]) == make_message(
+            "sunsubscribe", keys[0], 0
+        )
+        # now we're no longer subscribed as no more messages can be delivered
+        # to any channels we were listening to
+        assert p.subscribed is False
+
+        # subscribing again flips the flag back
+        p.ssubscribe(keys[0])
+        assert p.subscribed is True
+        assert wait_for_message(p, node=nodes[0]) == make_message(
+            "ssubscribe", keys[0], 1
+        )
+
+        # unsubscribe again
+        p.sunsubscribe()
+        assert p.subscribed is True
+        # subscribe to another shard_channel before reading the unsubscribe response
+        p.ssubscribe(keys[1])
+        assert p.subscribed is True
+        # read the unsubscribe for key1
+        assert wait_for_message(p, node=nodes[0]) == make_message(
+            "sunsubscribe", keys[0], 0
+        )
+        # we're still subscribed to key2, so subscribed should still be True
+        assert p.subscribed is True
+        # read the key2 subscribe message
+        assert wait_for_message(p, node=nodes[1]) == make_message(
+            "ssubscribe", keys[1], 1
+        )
+        p.sunsubscribe()
+        # haven't read the message yet, so we're still subscribed
+        assert p.subscribed is True
+        assert wait_for_message(p, node=nodes[1]) == make_message(
+            "sunsubscribe", keys[1], 0
+        )
+        # now we're finally unsubscribed
+        assert p.subscribed is False
+
+    @skip_if_server_version_lt("7.0.0")
     def test_ignore_all_subscribe_messages(self, r):
         p = r.pubsub(ignore_subscribe_messages=True)
 
         checks = (
-            (p.subscribe, "foo"),
-            (p.unsubscribe, "foo"),
-            (p.psubscribe, "f*"),
-            (p.punsubscribe, "f*"),
+            (p.subscribe, "foo", p.get_message),
+            (p.unsubscribe, "foo", p.get_message),
+            (p.psubscribe, "f*", p.get_message),
+            (p.punsubscribe, "f*", p.get_message),
+            (p.ssubscribe, "foo", p.get_sharded_message),
+            (p.sunsubscribe, "foo", p.get_sharded_message),
         )
 
         assert p.subscribed is False
-        for func, channel in checks:
+        for func, channel, get_func in checks:
             assert func(channel) is None
             assert p.subscribed is True
-            assert wait_for_message(p) is None
+            assert wait_for_message(p, func=get_func) is None
         assert p.subscribed is False
 
+    @skip_if_server_version_lt("7.0.0")
     def test_ignore_individual_subscribe_messages(self, r):
         p = r.pubsub()
 
         checks = (
-            (p.subscribe, "foo"),
-            (p.unsubscribe, "foo"),
-            (p.psubscribe, "f*"),
-            (p.punsubscribe, "f*"),
+            (p.subscribe, "foo", p.get_message),
+            (p.unsubscribe, "foo", p.get_message),
+            (p.psubscribe, "f*", p.get_message),
+            (p.punsubscribe, "f*", p.get_message),
+            (p.ssubscribe, "foo", p.get_sharded_message),
+            (p.sunsubscribe, "foo", p.get_sharded_message),
         )
 
         assert p.subscribed is False
-        for func, channel in checks:
+        for func, channel, get_func in checks:
             assert func(channel) is None
             assert p.subscribed is True
-            message = wait_for_message(p, ignore_subscribe_messages=True)
+            message = wait_for_message(p, ignore_subscribe_messages=True, func=get_func)
             assert message is None
         assert p.subscribed is False
 
@@ -230,6 +371,12 @@ def test_sub_unsub_resub_patterns(self, r):
         kwargs = make_subscribe_test_data(r.pubsub(), "pattern")
         self._test_sub_unsub_resub(**kwargs)
 
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("7.0.0")
+    def test_sub_unsub_resub_shard_channels(self, r):
+        kwargs = make_subscribe_test_data(r.pubsub(), "shard_channel")
+        self._test_sub_unsub_resub(**kwargs)
+
     def _test_sub_unsub_resub(
         self, p, sub_type, unsub_type, sub_func, unsub_func, keys
     ):
@@ -244,6 +391,26 @@ def _test_sub_unsub_resub(
         assert wait_for_message(p) == make_message(sub_type, key, 1)
         assert p.subscribed is True
 
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("7.0.0")
+    def test_sub_unsub_resub_shard_channels_cluster(self, r):
+        p = r.pubsub()
+        key = "foo"
+        p.ssubscribe(key)
+        p.sunsubscribe(key)
+        p.ssubscribe(key)
+        assert p.subscribed is True
+        assert wait_for_message(p, func=p.get_sharded_message) == make_message(
+            "ssubscribe", key, 1
+        )
+        assert wait_for_message(p, func=p.get_sharded_message) == make_message(
+            "sunsubscribe", key, 0
+        )
+        assert wait_for_message(p, func=p.get_sharded_message) == make_message(
+            "ssubscribe", key, 1
+        )
+        assert p.subscribed is True
+
     def test_sub_unsub_all_resub_channels(self, r):
         kwargs = make_subscribe_test_data(r.pubsub(), "channel")
         self._test_sub_unsub_all_resub(**kwargs)
@@ -252,6 +419,12 @@ def test_sub_unsub_all_resub_patterns(self, r):
         kwargs = make_subscribe_test_data(r.pubsub(), "pattern")
         self._test_sub_unsub_all_resub(**kwargs)
 
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("7.0.0")
+    def test_sub_unsub_all_resub_shard_channels(self, r):
+        kwargs = make_subscribe_test_data(r.pubsub(), "shard_channel")
+        self._test_sub_unsub_all_resub(**kwargs)
+
     def _test_sub_unsub_all_resub(
         self, p, sub_type, unsub_type, sub_func, unsub_func, keys
     ):
@@ -266,6 +439,26 @@ def _test_sub_unsub_all_resub(
         assert wait_for_message(p) == make_message(sub_type, key, 1)
         assert p.subscribed is True
 
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("7.0.0")
+    def test_sub_unsub_all_resub_shard_channels_cluster(self, r):
+        p = r.pubsub()
+        key = "foo"
+        p.ssubscribe(key)
+        p.sunsubscribe()
+        p.ssubscribe(key)
+        assert p.subscribed is True
+        assert wait_for_message(p, func=p.get_sharded_message) == make_message(
+            "ssubscribe", key, 1
+        )
+        assert wait_for_message(p, func=p.get_sharded_message) == make_message(
+            "sunsubscribe", key, 0
+        )
+        assert wait_for_message(p, func=p.get_sharded_message) == make_message(
+            "ssubscribe", key, 1
+        )
+        assert p.subscribed is True
+
 
 class TestPubSubMessages:
     def setup_method(self, method):
@@ -284,6 +477,32 @@ def test_published_message_to_channel(self, r):
         assert isinstance(message, dict)
         assert message == make_message("message", "foo", "test message")
 
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("7.0.0")
+    def test_published_message_to_shard_channel(self, r):
+        p = r.pubsub()
+        p.ssubscribe("foo")
+        assert wait_for_message(p) == make_message("ssubscribe", "foo", 1)
+        assert r.spublish("foo", "test message") == 1
+
+        message = wait_for_message(p)
+        assert isinstance(message, dict)
+        assert message == make_message("smessage", "foo", "test message")
+
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("7.0.0")
+    def test_published_message_to_shard_channel_cluster(self, r):
+        p = r.pubsub()
+        p.ssubscribe("foo")
+        assert wait_for_message(p, func=p.get_sharded_message) == make_message(
+            "ssubscribe", "foo", 1
+        )
+        assert r.spublish("foo", "test message") == 1
+
+        message = wait_for_message(p, func=p.get_sharded_message)
+        assert isinstance(message, dict)
+        assert message == make_message("smessage", "foo", "test message")
+
     def test_published_message_to_pattern(self, r):
         p = r.pubsub()
         p.subscribe("foo")
@@ -315,6 +534,15 @@ def test_channel_message_handler(self, r):
         assert wait_for_message(p) is None
         assert self.message == make_message("message", "foo", "test message")
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_shard_channel_message_handler(self, r):
+        p = r.pubsub(ignore_subscribe_messages=True)
+        p.ssubscribe(foo=self.message_handler)
+        assert wait_for_message(p, func=p.get_sharded_message) is None
+        assert r.spublish("foo", "test message") == 1
+        assert wait_for_message(p, func=p.get_sharded_message) is None
+        assert self.message == make_message("smessage", "foo", "test message")
+
     @pytest.mark.onlynoncluster
     def test_pattern_message_handler(self, r):
         p = r.pubsub(ignore_subscribe_messages=True)
@@ -336,6 +564,17 @@ def test_unicode_channel_message_handler(self, r):
         assert wait_for_message(p) is None
         assert self.message == make_message("message", channel, "test message")
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_unicode_shard_channel_message_handler(self, r):
+        p = r.pubsub(ignore_subscribe_messages=True)
+        channel = "uni" + chr(4456) + "code"
+        channels = {channel: self.message_handler}
+        p.ssubscribe(**channels)
+        assert wait_for_message(p, func=p.get_sharded_message) is None
+        assert r.spublish(channel, "test message") == 1
+        assert wait_for_message(p, func=p.get_sharded_message) is None
+        assert self.message == make_message("smessage", channel, "test message")
+
     @pytest.mark.onlynoncluster
     # see: https://redis-py-cluster.readthedocs.io/en/stable/pubsub.html
     # #known-limitations-with-pubsub
@@ -352,6 +591,36 @@ def test_unicode_pattern_message_handler(self, r):
         )
 
 
+class TestPubSubRESP3Handler:
+    def my_handler(self, message):
+        self.message = ["my handler", message]
+
+    @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+    def test_push_handler(self, r):
+        if is_resp2_connection(r):
+            return
+        p = r.pubsub(push_handler_func=self.my_handler)
+        p.subscribe("foo")
+        assert wait_for_message(p) is None
+        assert self.message == ["my handler", [b"subscribe", b"foo", 1]]
+        assert r.publish("foo", "test message") == 1
+        assert wait_for_message(p) is None
+        assert self.message == ["my handler", [b"message", b"foo", b"test message"]]
+
+    @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+    @skip_if_server_version_lt("7.0.0")
+    def test_push_handler_sharded_pubsub(self, r):
+        if is_resp2_connection(r):
+            return
+        p = r.pubsub(push_handler_func=self.my_handler)
+        p.ssubscribe("foo")
+        assert wait_for_message(p, func=p.get_sharded_message) is None
+        assert self.message == ["my handler", [b"ssubscribe", b"foo", 1]]
+        assert r.spublish("foo", "test message") == 1
+        assert wait_for_message(p, func=p.get_sharded_message) is None
+        assert self.message == ["my handler", [b"smessage", b"foo", b"test message"]]
+
+
 class TestPubSubAutoDecoding:
     "These tests only validate that we get unicode values back"
 
@@ -388,6 +657,19 @@ def test_pattern_subscribe_unsubscribe(self, r):
         p.punsubscribe(self.pattern)
         assert wait_for_message(p) == self.make_message("punsubscribe", self.pattern, 0)
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_shard_channel_subscribe_unsubscribe(self, r):
+        p = r.pubsub()
+        p.ssubscribe(self.channel)
+        assert wait_for_message(p, func=p.get_sharded_message) == self.make_message(
+            "ssubscribe", self.channel, 1
+        )
+
+        p.sunsubscribe(self.channel)
+        assert wait_for_message(p, func=p.get_sharded_message) == self.make_message(
+            "sunsubscribe", self.channel, 0
+        )
+
     def test_channel_publish(self, r):
         p = r.pubsub()
         p.subscribe(self.channel)
@@ -407,6 +689,18 @@ def test_pattern_publish(self, r):
             "pmessage", self.channel, self.data, pattern=self.pattern
         )
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_shard_channel_publish(self, r):
+        p = r.pubsub()
+        p.ssubscribe(self.channel)
+        assert wait_for_message(p, func=p.get_sharded_message) == self.make_message(
+            "ssubscribe", self.channel, 1
+        )
+        r.spublish(self.channel, self.data)
+        assert wait_for_message(p, func=p.get_sharded_message) == self.make_message(
+            "smessage", self.channel, self.data
+        )
+
     def test_channel_message_handler(self, r):
         p = r.pubsub(ignore_subscribe_messages=True)
         p.subscribe(**{self.channel: self.message_handler})
@@ -445,6 +739,30 @@ def test_pattern_message_handler(self, r):
             "pmessage", self.channel, new_data, pattern=self.pattern
         )
 
+    @skip_if_server_version_lt("7.0.0")
+    def test_shard_channel_message_handler(self, r):
+        p = r.pubsub(ignore_subscribe_messages=True)
+        p.ssubscribe(**{self.channel: self.message_handler})
+        assert wait_for_message(p, func=p.get_sharded_message) is None
+        r.spublish(self.channel, self.data)
+        assert wait_for_message(p, func=p.get_sharded_message) is None
+        assert self.message == self.make_message("smessage", self.channel, self.data)
+
+        # test that we reconnected to the correct channel
+        self.message = None
+        try:
+            # cluster mode
+            p.disconnect()
+        except AttributeError:
+            # standalone mode
+            p.connection.disconnect()
+        # should reconnect
+        assert wait_for_message(p, func=p.get_sharded_message) is None
+        new_data = self.data + "new data"
+        r.spublish(self.channel, new_data)
+        assert wait_for_message(p, func=p.get_sharded_message) is None
+        assert self.message == self.make_message("smessage", self.channel, new_data)
+
     def test_context_manager(self, r):
         with r.pubsub() as pubsub:
             pubsub.subscribe("foo")
@@ -474,6 +792,38 @@ def test_pubsub_channels(self, r):
         expected = [b"bar", b"baz", b"foo", b"quux"]
         assert all([channel in r.pubsub_channels() for channel in expected])
 
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("7.0.0")
+    def test_pubsub_shardchannels(self, r):
+        p = r.pubsub()
+        p.ssubscribe("foo", "bar", "baz", "quux")
+        for i in range(4):
+            assert wait_for_message(p)["type"] == "ssubscribe"
+        expected = [b"bar", b"baz", b"foo", b"quux"]
+        assert all([channel in r.pubsub_shardchannels() for channel in expected])
+
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("7.0.0")
+    def test_pubsub_shardchannels_cluster(self, r):
+        channels = {
+            b"foo": r.get_node_from_key("foo"),
+            b"bar": r.get_node_from_key("bar"),
+            b"baz": r.get_node_from_key("baz"),
+            b"quux": r.get_node_from_key("quux"),
+        }
+        p = r.pubsub()
+        p.ssubscribe("foo", "bar", "baz", "quux")
+        for node in channels.values():
+            assert wait_for_message(p, node=node)["type"] == "ssubscribe"
+        for channel, node in channels.items():
+            assert channel in r.pubsub_shardchannels(target_nodes=node)
+        assert all(
+            [
+                channel in r.pubsub_shardchannels(target_nodes="all")
+                for channel in channels.keys()
+            ]
+        )
+
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.8.0")
     def test_pubsub_numsub(self, r):
@@ -500,6 +850,32 @@ def test_pubsub_numpat(self, r):
             assert wait_for_message(p)["type"] == "psubscribe"
         assert r.pubsub_numpat() == 3
 
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("7.0.0")
+    def test_pubsub_shardnumsub(self, r):
+        channels = {
+            b"foo": r.get_node_from_key("foo"),
+            b"bar": r.get_node_from_key("bar"),
+            b"baz": r.get_node_from_key("baz"),
+        }
+        p1 = r.pubsub()
+        p1.ssubscribe(*channels.keys())
+        for node in channels.values():
+            assert wait_for_message(p1, node=node)["type"] == "ssubscribe"
+        p2 = r.pubsub()
+        p2.ssubscribe("bar", "baz")
+        for i in range(2):
+            assert (
+                wait_for_message(p2, func=p2.get_sharded_message)["type"]
+                == "ssubscribe"
+            )
+        p3 = r.pubsub()
+        p3.ssubscribe("baz")
+        assert wait_for_message(p3, node=channels[b"baz"])["type"] == "ssubscribe"
+
+        channels = [(b"foo", 1), (b"bar", 2), (b"baz", 3)]
+        assert r.pubsub_shardnumsub("foo", "bar", "baz", target_nodes="all") == channels
+
 
 class TestPubSubPings:
     @skip_if_server_version_lt("3.0.0")
@@ -767,13 +1143,15 @@ def get_msg():
         assert msg is not None
         # timeout waiting for another message which never arrives
         assert is_connected()
-        with patch("redis.connection.PythonParser.read_response") as mock1:
+        with patch("redis._parsers._RESP2Parser.read_response") as mock1, patch(
+            "redis._parsers._HiredisParser.read_response"
+        ) as mock2, patch("redis._parsers._RESP3Parser.read_response") as mock3:
             mock1.side_effect = BaseException("boom")
-            with patch("redis.connection.HiredisParser.read_response") as mock2:
-                mock2.side_effect = BaseException("boom")
+            mock2.side_effect = BaseException("boom")
+            mock3.side_effect = BaseException("boom")
 
-                with pytest.raises(BaseException):
-                    get_msg()
+            with pytest.raises(BaseException):
+                get_msg()
 
         # the timeout on the read should not cause disconnect
         assert is_connected()
diff --git a/tests/test_retry.py b/tests/test_retry.py
index 3cfea5c09e..e9d3015897 100644
--- a/tests/test_retry.py
+++ b/tests/test_retry.py
@@ -1,7 +1,6 @@
 from unittest.mock import patch
 
 import pytest
-
 from redis.backoff import ExponentialBackoff, NoBackoff
 from redis.client import Redis
 from redis.connection import Connection, UnixDomainSocketConnection
diff --git a/tests/test_scripting.py b/tests/test_scripting.py
index b6b5f9fb70..899dc69482 100644
--- a/tests/test_scripting.py
+++ b/tests/test_scripting.py
@@ -1,5 +1,4 @@
 import pytest
-
 import redis
 from redis import exceptions
 from redis.commands.core import Script
diff --git a/tests/test_search.py b/tests/test_search.py
index 7a2428151e..2e42aaba57 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -5,7 +5,6 @@
 from io import TextIOWrapper
 
 import pytest
-
 import redis
 import redis.commands.search
 import redis.commands.search.aggregation as aggregations
@@ -24,7 +23,13 @@
 from redis.commands.search.result import Result
 from redis.commands.search.suggestion import Suggestion
 
-from .conftest import skip_if_redis_enterprise, skip_ifmodversion_lt
+from .conftest import (
+    _get_client,
+    assert_resp_response,
+    is_resp2_connection,
+    skip_if_redis_enterprise,
+    skip_ifmodversion_lt,
+)
 
 WILL_PLAY_TEXT = os.path.abspath(
     os.path.join(os.path.dirname(__file__), "testdata", "will_play_text.csv.bz2")
@@ -40,12 +45,16 @@ def waitForIndex(env, idx, timeout=None):
     while True:
         res = env.execute_command("FT.INFO", idx)
         try:
-            res.index("indexing")
+            if int(res[res.index("indexing") + 1]) == 0:
+                break
         except ValueError:
             break
-
-        if int(res[res.index("indexing") + 1]) == 0:
-            break
+        except AttributeError:
+            try:
+                if int(res["indexing"]) == 0:
+                    break
+            except ValueError:
+                break
 
         time.sleep(delay)
         if timeout is not None:
@@ -98,9 +107,10 @@ def createIndex(client, num_docs=100, definition=None):
 
 
 @pytest.fixture
-def client(modclient):
-    modclient.flushdb()
-    return modclient
+def client(request):
+    r = _get_client(redis.Redis, request, decode_responses=True)
+    r.flushdb()
+    return r
 
 
 @pytest.mark.redismod
@@ -133,84 +143,170 @@ def test_client(client):
     assert num_docs == int(info["num_docs"])
 
     res = client.ft().search("henry iv")
-    assert isinstance(res, Result)
-    assert 225 == res.total
-    assert 10 == len(res.docs)
-    assert res.duration > 0
-
-    for doc in res.docs:
-        assert doc.id
-        assert doc["id"]
-        assert doc.play == "Henry IV"
-        assert doc["play"] == "Henry IV"
+    if is_resp2_connection(client):
+        assert isinstance(res, Result)
+        assert 225 == res.total
+        assert 10 == len(res.docs)
+        assert res.duration > 0
+
+        for doc in res.docs:
+            assert doc.id
+            assert doc["id"]
+            assert doc.play == "Henry IV"
+            assert doc["play"] == "Henry IV"
+            assert len(doc.txt) > 0
+
+        # test no content
+        res = client.ft().search(Query("king").no_content())
+        assert 194 == res.total
+        assert 10 == len(res.docs)
+        for doc in res.docs:
+            assert "txt" not in doc.__dict__
+            assert "play" not in doc.__dict__
+
+        # test verbatim vs no verbatim
+        total = client.ft().search(Query("kings").no_content()).total
+        vtotal = client.ft().search(Query("kings").no_content().verbatim()).total
+        assert total > vtotal
+
+        # test in fields
+        txt_total = (
+            client.ft().search(Query("henry").no_content().limit_fields("txt")).total
+        )
+        play_total = (
+            client.ft().search(Query("henry").no_content().limit_fields("play")).total
+        )
+        both_total = (
+            client.ft()
+            .search(Query("henry").no_content().limit_fields("play", "txt"))
+            .total
+        )
+        assert 129 == txt_total
+        assert 494 == play_total
+        assert 494 == both_total
+
+        # test load_document
+        doc = client.ft().load_document("henry vi part 3:62")
+        assert doc is not None
+        assert "henry vi part 3:62" == doc.id
+        assert doc.play == "Henry VI Part 3"
         assert len(doc.txt) > 0
 
-    # test no content
-    res = client.ft().search(Query("king").no_content())
-    assert 194 == res.total
-    assert 10 == len(res.docs)
-    for doc in res.docs:
-        assert "txt" not in doc.__dict__
-        assert "play" not in doc.__dict__
-
-    # test verbatim vs no verbatim
-    total = client.ft().search(Query("kings").no_content()).total
-    vtotal = client.ft().search(Query("kings").no_content().verbatim()).total
-    assert total > vtotal
-
-    # test in fields
-    txt_total = (
-        client.ft().search(Query("henry").no_content().limit_fields("txt")).total
-    )
-    play_total = (
-        client.ft().search(Query("henry").no_content().limit_fields("play")).total
-    )
-    both_total = (
-        client.ft()
-        .search(Query("henry").no_content().limit_fields("play", "txt"))
-        .total
-    )
-    assert 129 == txt_total
-    assert 494 == play_total
-    assert 494 == both_total
-
-    # test load_document
-    doc = client.ft().load_document("henry vi part 3:62")
-    assert doc is not None
-    assert "henry vi part 3:62" == doc.id
-    assert doc.play == "Henry VI Part 3"
-    assert len(doc.txt) > 0
-
-    # test in-keys
-    ids = [x.id for x in client.ft().search(Query("henry")).docs]
-    assert 10 == len(ids)
-    subset = ids[:5]
-    docs = client.ft().search(Query("henry").limit_ids(*subset))
-    assert len(subset) == docs.total
-    ids = [x.id for x in docs.docs]
-    assert set(ids) == set(subset)
-
-    # test slop and in order
-    assert 193 == client.ft().search(Query("henry king")).total
-    assert 3 == client.ft().search(Query("henry king").slop(0).in_order()).total
-    assert 52 == client.ft().search(Query("king henry").slop(0).in_order()).total
-    assert 53 == client.ft().search(Query("henry king").slop(0)).total
-    assert 167 == client.ft().search(Query("henry king").slop(100)).total
-
-    # test delete document
-    client.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
-    res = client.ft().search(Query("death of a salesman"))
-    assert 1 == res.total
-
-    assert 1 == client.ft().delete_document("doc-5ghs2")
-    res = client.ft().search(Query("death of a salesman"))
-    assert 0 == res.total
-    assert 0 == client.ft().delete_document("doc-5ghs2")
-
-    client.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
-    res = client.ft().search(Query("death of a salesman"))
-    assert 1 == res.total
-    client.ft().delete_document("doc-5ghs2")
+        # test in-keys
+        ids = [x.id for x in client.ft().search(Query("henry")).docs]
+        assert 10 == len(ids)
+        subset = ids[:5]
+        docs = client.ft().search(Query("henry").limit_ids(*subset))
+        assert len(subset) == docs.total
+        ids = [x.id for x in docs.docs]
+        assert set(ids) == set(subset)
+
+        # test slop and in order
+        assert 193 == client.ft().search(Query("henry king")).total
+        assert 3 == client.ft().search(Query("henry king").slop(0).in_order()).total
+        assert 52 == client.ft().search(Query("king henry").slop(0).in_order()).total
+        assert 53 == client.ft().search(Query("henry king").slop(0)).total
+        assert 167 == client.ft().search(Query("henry king").slop(100)).total
+
+        # test delete document
+        client.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
+        res = client.ft().search(Query("death of a salesman"))
+        assert 1 == res.total
+
+        assert 1 == client.ft().delete_document("doc-5ghs2")
+        res = client.ft().search(Query("death of a salesman"))
+        assert 0 == res.total
+        assert 0 == client.ft().delete_document("doc-5ghs2")
+
+        client.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
+        res = client.ft().search(Query("death of a salesman"))
+        assert 1 == res.total
+        client.ft().delete_document("doc-5ghs2")
+    else:
+        assert isinstance(res, dict)
+        assert 225 == res["total_results"]
+        assert 10 == len(res["results"])
+
+        for doc in res["results"]:
+            assert doc["id"]
+            assert doc["extra_attributes"]["play"] == "Henry IV"
+            assert len(doc["extra_attributes"]["txt"]) > 0
+
+        # test no content
+        res = client.ft().search(Query("king").no_content())
+        assert 194 == res["total_results"]
+        assert 10 == len(res["results"])
+        for doc in res["results"]:
+            assert "extra_attributes" not in doc.keys()
+
+        # test verbatim vs no verbatim
+        total = client.ft().search(Query("kings").no_content())["total_results"]
+        vtotal = client.ft().search(Query("kings").no_content().verbatim())[
+            "total_results"
+        ]
+        assert total > vtotal
+
+        # test in fields
+        txt_total = client.ft().search(Query("henry").no_content().limit_fields("txt"))[
+            "total_results"
+        ]
+        play_total = client.ft().search(
+            Query("henry").no_content().limit_fields("play")
+        )["total_results"]
+        both_total = client.ft().search(
+            Query("henry").no_content().limit_fields("play", "txt")
+        )["total_results"]
+        assert 129 == txt_total
+        assert 494 == play_total
+        assert 494 == both_total
+
+        # test load_document
+        doc = client.ft().load_document("henry vi part 3:62")
+        assert doc is not None
+        assert "henry vi part 3:62" == doc.id
+        assert doc.play == "Henry VI Part 3"
+        assert len(doc.txt) > 0
+
+        # test in-keys
+        ids = [x["id"] for x in client.ft().search(Query("henry"))["results"]]
+        assert 10 == len(ids)
+        subset = ids[:5]
+        docs = client.ft().search(Query("henry").limit_ids(*subset))
+        assert len(subset) == docs["total_results"]
+        ids = [x["id"] for x in docs["results"]]
+        assert set(ids) == set(subset)
+
+        # test slop and in order
+        assert 193 == client.ft().search(Query("henry king"))["total_results"]
+        assert (
+            3
+            == client.ft().search(Query("henry king").slop(0).in_order())[
+                "total_results"
+            ]
+        )
+        assert (
+            52
+            == client.ft().search(Query("king henry").slop(0).in_order())[
+                "total_results"
+            ]
+        )
+        assert 53 == client.ft().search(Query("henry king").slop(0))["total_results"]
+        assert 167 == client.ft().search(Query("henry king").slop(100))["total_results"]
+
+        # test delete document
+        client.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
+        res = client.ft().search(Query("death of a salesman"))
+        assert 1 == res["total_results"]
+
+        assert 1 == client.ft().delete_document("doc-5ghs2")
+        res = client.ft().search(Query("death of a salesman"))
+        assert 0 == res["total_results"]
+        assert 0 == client.ft().delete_document("doc-5ghs2")
+
+        client.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
+        res = client.ft().search(Query("death of a salesman"))
+        assert 1 == res["total_results"]
+        client.ft().delete_document("doc-5ghs2")
 
 
 @pytest.mark.redismod
@@ -223,12 +319,16 @@ def test_scores(client):
 
     q = Query("foo ~bar").with_scores()
     res = client.ft().search(q)
-    assert 2 == res.total
-    assert "doc2" == res.docs[0].id
-    assert 3.0 == res.docs[0].score
-    assert "doc1" == res.docs[1].id
-    # todo: enable once new RS version is tagged
-    # self.assertEqual(0.2, res.docs[1].score)
+    if is_resp2_connection(client):
+        assert 2 == res.total
+        assert "doc2" == res.docs[0].id
+        assert 3.0 == res.docs[0].score
+        assert "doc1" == res.docs[1].id
+    else:
+        assert 2 == res["total_results"]
+        assert "doc2" == res["results"][0]["id"]
+        assert 3.0 == res["results"][0]["score"]
+        assert "doc1" == res["results"][1]["id"]
 
 
 @pytest.mark.redismod
@@ -241,8 +341,12 @@ def test_stopwords(client):
     q1 = Query("foo bar").no_content()
     q2 = Query("foo bar hello world").no_content()
     res1, res2 = client.ft().search(q1), client.ft().search(q2)
-    assert 0 == res1.total
-    assert 1 == res2.total
+    if is_resp2_connection(client):
+        assert 0 == res1.total
+        assert 1 == res2.total
+    else:
+        assert 0 == res1["total_results"]
+        assert 1 == res2["total_results"]
 
 
 @pytest.mark.redismod
@@ -262,25 +366,40 @@ def test_filters(client):
         .no_content()
     )
     res1, res2 = client.ft().search(q1), client.ft().search(q2)
-
-    assert 1 == res1.total
-    assert 1 == res2.total
-    assert "doc2" == res1.docs[0].id
-    assert "doc1" == res2.docs[0].id
+    if is_resp2_connection(client):
+        assert 1 == res1.total
+        assert 1 == res2.total
+        assert "doc2" == res1.docs[0].id
+        assert "doc1" == res2.docs[0].id
+    else:
+        assert 1 == res1["total_results"]
+        assert 1 == res2["total_results"]
+        assert "doc2" == res1["results"][0]["id"]
+        assert "doc1" == res2["results"][0]["id"]
 
     # Test geo filter
     q1 = Query("foo").add_filter(GeoFilter("loc", -0.44, 51.45, 10)).no_content()
     q2 = Query("foo").add_filter(GeoFilter("loc", -0.44, 51.45, 100)).no_content()
     res1, res2 = client.ft().search(q1), client.ft().search(q2)
 
-    assert 1 == res1.total
-    assert 2 == res2.total
-    assert "doc1" == res1.docs[0].id
+    if is_resp2_connection(client):
+        assert 1 == res1.total
+        assert 2 == res2.total
+        assert "doc1" == res1.docs[0].id
 
-    # Sort results, after RDB reload order may change
-    res = [res2.docs[0].id, res2.docs[1].id]
-    res.sort()
-    assert ["doc1", "doc2"] == res
+        # Sort results, after RDB reload order may change
+        res = [res2.docs[0].id, res2.docs[1].id]
+        res.sort()
+        assert ["doc1", "doc2"] == res
+    else:
+        assert 1 == res1["total_results"]
+        assert 2 == res2["total_results"]
+        assert "doc1" == res1["results"][0]["id"]
+
+        # Sort results, after RDB reload order may change
+        res = [res2["results"][0]["id"], res2["results"][1]["id"]]
+        res.sort()
+        assert ["doc1", "doc2"] == res
 
 
 @pytest.mark.redismod
@@ -295,14 +414,24 @@ def test_sort_by(client):
     q2 = Query("foo").sort_by("num", asc=False).no_content()
     res1, res2 = client.ft().search(q1), client.ft().search(q2)
 
-    assert 3 == res1.total
-    assert "doc1" == res1.docs[0].id
-    assert "doc2" == res1.docs[1].id
-    assert "doc3" == res1.docs[2].id
-    assert 3 == res2.total
-    assert "doc1" == res2.docs[2].id
-    assert "doc2" == res2.docs[1].id
-    assert "doc3" == res2.docs[0].id
+    if is_resp2_connection(client):
+        assert 3 == res1.total
+        assert "doc1" == res1.docs[0].id
+        assert "doc2" == res1.docs[1].id
+        assert "doc3" == res1.docs[2].id
+        assert 3 == res2.total
+        assert "doc1" == res2.docs[2].id
+        assert "doc2" == res2.docs[1].id
+        assert "doc3" == res2.docs[0].id
+    else:
+        assert 3 == res1["total_results"]
+        assert "doc1" == res1["results"][0]["id"]
+        assert "doc2" == res1["results"][1]["id"]
+        assert "doc3" == res1["results"][2]["id"]
+        assert 3 == res2["total_results"]
+        assert "doc1" == res2["results"][2]["id"]
+        assert "doc2" == res2["results"][1]["id"]
+        assert "doc3" == res2["results"][0]["id"]
 
 
 @pytest.mark.redismod
@@ -417,27 +546,50 @@ def test_no_index(client):
     )
     waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
-    res = client.ft().search(Query("@text:aa*"))
-    assert 0 == res.total
+    if is_resp2_connection(client):
+        res = client.ft().search(Query("@text:aa*"))
+        assert 0 == res.total
+
+        res = client.ft().search(Query("@field:aa*"))
+        assert 2 == res.total
 
-    res = client.ft().search(Query("@field:aa*"))
-    assert 2 == res.total
+        res = client.ft().search(Query("*").sort_by("text", asc=False))
+        assert 2 == res.total
+        assert "doc2" == res.docs[0].id
 
-    res = client.ft().search(Query("*").sort_by("text", asc=False))
-    assert 2 == res.total
-    assert "doc2" == res.docs[0].id
+        res = client.ft().search(Query("*").sort_by("text", asc=True))
+        assert "doc1" == res.docs[0].id
 
-    res = client.ft().search(Query("*").sort_by("text", asc=True))
-    assert "doc1" == res.docs[0].id
+        res = client.ft().search(Query("*").sort_by("numeric", asc=True))
+        assert "doc1" == res.docs[0].id
 
-    res = client.ft().search(Query("*").sort_by("numeric", asc=True))
-    assert "doc1" == res.docs[0].id
+        res = client.ft().search(Query("*").sort_by("geo", asc=True))
+        assert "doc1" == res.docs[0].id
 
-    res = client.ft().search(Query("*").sort_by("geo", asc=True))
-    assert "doc1" == res.docs[0].id
+        res = client.ft().search(Query("*").sort_by("tag", asc=True))
+        assert "doc1" == res.docs[0].id
+    else:
+        res = client.ft().search(Query("@text:aa*"))
+        assert 0 == res["total_results"]
 
-    res = client.ft().search(Query("*").sort_by("tag", asc=True))
-    assert "doc1" == res.docs[0].id
+        res = client.ft().search(Query("@field:aa*"))
+        assert 2 == res["total_results"]
+
+        res = client.ft().search(Query("*").sort_by("text", asc=False))
+        assert 2 == res["total_results"]
+        assert "doc2" == res["results"][0]["id"]
+
+        res = client.ft().search(Query("*").sort_by("text", asc=True))
+        assert "doc1" == res["results"][0]["id"]
+
+        res = client.ft().search(Query("*").sort_by("numeric", asc=True))
+        assert "doc1" == res["results"][0]["id"]
+
+        res = client.ft().search(Query("*").sort_by("geo", asc=True))
+        assert "doc1" == res["results"][0]["id"]
+
+        res = client.ft().search(Query("*").sort_by("tag", asc=True))
+        assert "doc1" == res["results"][0]["id"]
 
     # Ensure exception is raised for non-indexable, non-sortable fields
     with pytest.raises(Exception):
@@ -472,21 +624,38 @@ def test_summarize(client):
     q.highlight(fields=("play", "txt"), tags=("<b>", "</b>"))
     q.summarize("txt")
 
-    doc = sorted(client.ft().search(q).docs)[0]
-    assert "<b>Henry</b> IV" == doc.play
-    assert (
-        "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
-        == doc.txt
-    )
+    if is_resp2_connection(client):
+        doc = sorted(client.ft().search(q).docs)[0]
+        assert "<b>Henry</b> IV" == doc.play
+        assert (
+            "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+            == doc.txt
+        )
 
-    q = Query("king henry").paging(0, 1).summarize().highlight()
+        q = Query("king henry").paging(0, 1).summarize().highlight()
 
-    doc = sorted(client.ft().search(q).docs)[0]
-    assert "<b>Henry</b> ... " == doc.play
-    assert (
-        "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
-        == doc.txt
-    )
+        doc = sorted(client.ft().search(q).docs)[0]
+        assert "<b>Henry</b> ... " == doc.play
+        assert (
+            "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+            == doc.txt
+        )
+    else:
+        doc = sorted(client.ft().search(q)["results"])[0]
+        assert "<b>Henry</b> IV" == doc["extra_attributes"]["play"]
+        assert (
+            "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+            == doc["extra_attributes"]["txt"]
+        )
+
+        q = Query("king henry").paging(0, 1).summarize().highlight()
+
+        doc = sorted(client.ft().search(q)["results"])[0]
+        assert "<b>Henry</b> ... " == doc["extra_attributes"]["play"]
+        assert (
+            "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+            == doc["extra_attributes"]["txt"]
+        )
 
 
 @pytest.mark.redismod
@@ -506,25 +675,46 @@ def test_alias(client):
     index1.hset("index1:lonestar", mapping={"name": "lonestar"})
     index2.hset("index2:yogurt", mapping={"name": "yogurt"})
 
-    res = ftindex1.search("*").docs[0]
-    assert "index1:lonestar" == res.id
+    if is_resp2_connection(client):
+        res = ftindex1.search("*").docs[0]
+        assert "index1:lonestar" == res.id
 
-    # create alias and check for results
-    ftindex1.aliasadd("spaceballs")
-    alias_client = getClient(client).ft("spaceballs")
-    res = alias_client.search("*").docs[0]
-    assert "index1:lonestar" == res.id
+        # create alias and check for results
+        ftindex1.aliasadd("spaceballs")
+        alias_client = getClient(client).ft("spaceballs")
+        res = alias_client.search("*").docs[0]
+        assert "index1:lonestar" == res.id
 
-    # Throw an exception when trying to add an alias that already exists
-    with pytest.raises(Exception):
-        ftindex2.aliasadd("spaceballs")
+        # Throw an exception when trying to add an alias that already exists
+        with pytest.raises(Exception):
+            ftindex2.aliasadd("spaceballs")
+
+        # update alias and ensure new results
+        ftindex2.aliasupdate("spaceballs")
+        alias_client2 = getClient(client).ft("spaceballs")
+
+        res = alias_client2.search("*").docs[0]
+        assert "index2:yogurt" == res.id
+    else:
+        res = ftindex1.search("*")["results"][0]
+        assert "index1:lonestar" == res["id"]
 
-    # update alias and ensure new results
-    ftindex2.aliasupdate("spaceballs")
-    alias_client2 = getClient(client).ft("spaceballs")
+        # create alias and check for results
+        ftindex1.aliasadd("spaceballs")
+        alias_client = getClient(client).ft("spaceballs")
+        res = alias_client.search("*")["results"][0]
+        assert "index1:lonestar" == res["id"]
 
-    res = alias_client2.search("*").docs[0]
-    assert "index2:yogurt" == res.id
+        # Throw an exception when trying to add an alias that already exists
+        with pytest.raises(Exception):
+            ftindex2.aliasadd("spaceballs")
+
+        # update alias and ensure new results
+        ftindex2.aliasupdate("spaceballs")
+        alias_client2 = getClient(client).ft("spaceballs")
+
+        res = alias_client2.search("*")["results"][0]
+        assert "index2:yogurt" == res["id"]
 
     ftindex2.aliasdel("spaceballs")
     with pytest.raises(Exception):
@@ -532,9 +722,9 @@ def test_alias(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.xfail(strict=False)
 def test_alias_basic(client):
     # Creating a client with one index
-    getClient(client).flushdb()
     index1 = getClient(client).ft("testAlias")
 
     index1.create_index((TextField("txt"),))
@@ -547,18 +737,32 @@ def test_alias_basic(client):
     # add the actual alias and check
     index1.aliasadd("myalias")
     alias_client = getClient(client).ft("myalias")
-    res = sorted(alias_client.search("*").docs, key=lambda x: x.id)
-    assert "doc1" == res[0].id
-
-    # Throw an exception when trying to add an alias that already exists
-    with pytest.raises(Exception):
-        index2.aliasadd("myalias")
-
-    # update the alias and ensure we get doc2
-    index2.aliasupdate("myalias")
-    alias_client2 = getClient(client).ft("myalias")
-    res = sorted(alias_client2.search("*").docs, key=lambda x: x.id)
-    assert "doc1" == res[0].id
+    if is_resp2_connection(client):
+        res = sorted(alias_client.search("*").docs, key=lambda x: x.id)
+        assert "doc1" == res[0].id
+
+        # Throw an exception when trying to add an alias that already exists
+        with pytest.raises(Exception):
+            index2.aliasadd("myalias")
+
+        # update the alias and ensure we get doc2
+        index2.aliasupdate("myalias")
+        alias_client2 = getClient(client).ft("myalias")
+        res = sorted(alias_client2.search("*").docs, key=lambda x: x.id)
+        assert "doc1" == res[0].id
+    else:
+        res = sorted(alias_client.search("*")["results"], key=lambda x: x["id"])
+        assert "doc1" == res[0]["id"]
+
+        # Throw an exception when trying to add an alias that already exists
+        with pytest.raises(Exception):
+            index2.aliasadd("myalias")
+
+        # update the alias and ensure we get doc2
+        index2.aliasupdate("myalias")
+        alias_client2 = getClient(client).ft("myalias")
+        res = sorted(alias_client2.search("*")["results"], key=lambda x: x["id"])
+        assert "doc1" == res[0]["id"]
 
     # delete the alias and expect an error if we try to query again
     index2.aliasdel("myalias")
@@ -573,8 +777,12 @@ def test_textfield_sortable_nostem(client):
 
     # Now get the index info to confirm its contents
     response = client.ft().info()
-    assert "SORTABLE" in response["attributes"][0]
-    assert "NOSTEM" in response["attributes"][0]
+    if is_resp2_connection(client):
+        assert "SORTABLE" in response["attributes"][0]
+        assert "NOSTEM" in response["attributes"][0]
+    else:
+        assert "SORTABLE" in response["attributes"][0]["flags"]
+        assert "NOSTEM" in response["attributes"][0]["flags"]
 
 
 @pytest.mark.redismod
@@ -595,7 +803,10 @@ def test_alter_schema_add(client):
 
     # Ensure we find the result searching on the added body field
     res = client.ft().search(q)
-    assert 1 == res.total
+    if is_resp2_connection(client):
+        assert 1 == res.total
+    else:
+        assert 1 == res["total_results"]
 
 
 @pytest.mark.redismod
@@ -608,33 +819,64 @@ def test_spell_check(client):
     client.hset("doc2", mapping={"f1": "very important", "f2": "lorem ipsum"})
     waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
-    # test spellcheck
-    res = client.ft().spellcheck("impornant")
-    assert "important" == res["impornant"][0]["suggestion"]
-
-    res = client.ft().spellcheck("contnt")
-    assert "content" == res["contnt"][0]["suggestion"]
-
-    # test spellcheck with Levenshtein distance
-    res = client.ft().spellcheck("vlis")
-    assert res == {}
-    res = client.ft().spellcheck("vlis", distance=2)
-    assert "valid" == res["vlis"][0]["suggestion"]
-
-    # test spellcheck include
-    client.ft().dict_add("dict", "lore", "lorem", "lorm")
-    res = client.ft().spellcheck("lorm", include="dict")
-    assert len(res["lorm"]) == 3
-    assert (
-        res["lorm"][0]["suggestion"],
-        res["lorm"][1]["suggestion"],
-        res["lorm"][2]["suggestion"],
-    ) == ("lorem", "lore", "lorm")
-    assert (res["lorm"][0]["score"], res["lorm"][1]["score"]) == ("0.5", "0")
-
-    # test spellcheck exclude
-    res = client.ft().spellcheck("lorm", exclude="dict")
-    assert res == {}
+    if is_resp2_connection(client):
+
+        # test spellcheck
+        res = client.ft().spellcheck("impornant")
+        assert "important" == res["impornant"][0]["suggestion"]
+
+        res = client.ft().spellcheck("contnt")
+        assert "content" == res["contnt"][0]["suggestion"]
+
+        # test spellcheck with Levenshtein distance
+        res = client.ft().spellcheck("vlis")
+        assert res == {}
+        res = client.ft().spellcheck("vlis", distance=2)
+        assert "valid" == res["vlis"][0]["suggestion"]
+
+        # test spellcheck include
+        client.ft().dict_add("dict", "lore", "lorem", "lorm")
+        res = client.ft().spellcheck("lorm", include="dict")
+        assert len(res["lorm"]) == 3
+        assert (
+            res["lorm"][0]["suggestion"],
+            res["lorm"][1]["suggestion"],
+            res["lorm"][2]["suggestion"],
+        ) == ("lorem", "lore", "lorm")
+        assert (res["lorm"][0]["score"], res["lorm"][1]["score"]) == ("0.5", "0")
+
+        # test spellcheck exclude
+        res = client.ft().spellcheck("lorm", exclude="dict")
+        assert res == {}
+    else:
+        # test spellcheck
+        res = client.ft().spellcheck("impornant")
+        assert "important" in res["results"]["impornant"][0].keys()
+
+        res = client.ft().spellcheck("contnt")
+        assert "content" in res["results"]["contnt"][0].keys()
+
+        # test spellcheck with Levenshtein distance
+        res = client.ft().spellcheck("vlis")
+        assert res == {"results": {"vlis": []}}
+        res = client.ft().spellcheck("vlis", distance=2)
+        assert "valid" in res["results"]["vlis"][0].keys()
+
+        # test spellcheck include
+        client.ft().dict_add("dict", "lore", "lorem", "lorm")
+        res = client.ft().spellcheck("lorm", include="dict")
+        assert len(res["results"]["lorm"]) == 3
+        assert "lorem" in res["results"]["lorm"][0].keys()
+        assert "lore" in res["results"]["lorm"][1].keys()
+        assert "lorm" in res["results"]["lorm"][2].keys()
+        assert (
+            res["results"]["lorm"][0]["lorem"],
+            res["results"]["lorm"][1]["lore"],
+        ) == (0.5, 0)
+
+        # test spellcheck exclude
+        res = client.ft().spellcheck("lorm", exclude="dict")
+        assert res == {"results": {}}
 
 
 @pytest.mark.redismod
@@ -650,7 +892,7 @@ def test_dict_operations(client):
 
     # Dump dict and inspect content
     res = client.ft().dict_dump("custom_dict")
-    assert ["item1", "item3"] == res
+    assert_resp_response(client, res, ["item1", "item3"], {"item1", "item3"})
 
     # Remove rest of the items before reload
     client.ft().dict_del("custom_dict", *res)
@@ -663,8 +905,12 @@ def test_phonetic_matcher(client):
     client.hset("doc2", mapping={"name": "John"})
 
     res = client.ft().search(Query("Jon"))
-    assert 1 == len(res.docs)
-    assert "Jon" == res.docs[0].name
+    if is_resp2_connection(client):
+        assert 1 == len(res.docs)
+        assert "Jon" == res.docs[0].name
+    else:
+        assert 1 == res["total_results"]
+        assert "Jon" == res["results"][0]["extra_attributes"]["name"]
 
     # Drop and create index with phonetic matcher
     client.flushdb()
@@ -674,8 +920,14 @@ def test_phonetic_matcher(client):
     client.hset("doc2", mapping={"name": "John"})
 
     res = client.ft().search(Query("Jon"))
-    assert 2 == len(res.docs)
-    assert ["John", "Jon"] == sorted(d.name for d in res.docs)
+    if is_resp2_connection(client):
+        assert 2 == len(res.docs)
+        assert ["John", "Jon"] == sorted(d.name for d in res.docs)
+    else:
+        assert 2 == res["total_results"]
+        assert ["John", "Jon"] == sorted(
+            d["extra_attributes"]["name"] for d in res["results"]
+        )
 
 
 @pytest.mark.redismod
@@ -694,20 +946,36 @@ def test_scorer(client):
     )
 
     # default scorer is TFIDF
-    res = client.ft().search(Query("quick").with_scores())
-    assert 1.0 == res.docs[0].score
-    res = client.ft().search(Query("quick").scorer("TFIDF").with_scores())
-    assert 1.0 == res.docs[0].score
-    res = client.ft().search(Query("quick").scorer("TFIDF.DOCNORM").with_scores())
-    assert 0.1111111111111111 == res.docs[0].score
-    res = client.ft().search(Query("quick").scorer("BM25").with_scores())
-    assert 0.17699114465425977 == res.docs[0].score
-    res = client.ft().search(Query("quick").scorer("DISMAX").with_scores())
-    assert 2.0 == res.docs[0].score
-    res = client.ft().search(Query("quick").scorer("DOCSCORE").with_scores())
-    assert 1.0 == res.docs[0].score
-    res = client.ft().search(Query("quick").scorer("HAMMING").with_scores())
-    assert 0.0 == res.docs[0].score
+    if is_resp2_connection(client):
+        res = client.ft().search(Query("quick").with_scores())
+        assert 1.0 == res.docs[0].score
+        res = client.ft().search(Query("quick").scorer("TFIDF").with_scores())
+        assert 1.0 == res.docs[0].score
+        res = client.ft().search(Query("quick").scorer("TFIDF.DOCNORM").with_scores())
+        assert 0.1111111111111111 == res.docs[0].score
+        res = client.ft().search(Query("quick").scorer("BM25").with_scores())
+        assert 0.17699114465425977 == res.docs[0].score
+        res = client.ft().search(Query("quick").scorer("DISMAX").with_scores())
+        assert 2.0 == res.docs[0].score
+        res = client.ft().search(Query("quick").scorer("DOCSCORE").with_scores())
+        assert 1.0 == res.docs[0].score
+        res = client.ft().search(Query("quick").scorer("HAMMING").with_scores())
+        assert 0.0 == res.docs[0].score
+    else:
+        res = client.ft().search(Query("quick").with_scores())
+        assert 1.0 == res["results"][0]["score"]
+        res = client.ft().search(Query("quick").scorer("TFIDF").with_scores())
+        assert 1.0 == res["results"][0]["score"]
+        res = client.ft().search(Query("quick").scorer("TFIDF.DOCNORM").with_scores())
+        assert 0.1111111111111111 == res["results"][0]["score"]
+        res = client.ft().search(Query("quick").scorer("BM25").with_scores())
+        assert 0.17699114465425977 == res["results"][0]["score"]
+        res = client.ft().search(Query("quick").scorer("DISMAX").with_scores())
+        assert 2.0 == res["results"][0]["score"]
+        res = client.ft().search(Query("quick").scorer("DOCSCORE").with_scores())
+        assert 1.0 == res["results"][0]["score"]
+        res = client.ft().search(Query("quick").scorer("HAMMING").with_scores())
+        assert 0.0 == res["results"][0]["score"]
 
 
 @pytest.mark.redismod
@@ -788,101 +1056,212 @@ def test_aggregations_groupby(client):
         },
     )
 
-    req = aggregations.AggregateRequest("redis").group_by("@parent", reducers.count())
+    if is_resp2_connection(client):
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.count()
+        )
 
-    res = client.ft().aggregate(req).rows[0]
-    assert res[1] == "redis"
-    assert res[3] == "3"
+        res = client.ft().aggregate(req).rows[0]
+        assert res[1] == "redis"
+        assert res[3] == "3"
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.count_distinct("@title")
-    )
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.count_distinct("@title")
+        )
 
-    res = client.ft().aggregate(req).rows[0]
-    assert res[1] == "redis"
-    assert res[3] == "3"
+        res = client.ft().aggregate(req).rows[0]
+        assert res[1] == "redis"
+        assert res[3] == "3"
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.count_distinctish("@title")
-    )
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.count_distinctish("@title")
+        )
 
-    res = client.ft().aggregate(req).rows[0]
-    assert res[1] == "redis"
-    assert res[3] == "3"
+        res = client.ft().aggregate(req).rows[0]
+        assert res[1] == "redis"
+        assert res[3] == "3"
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.sum("@random_num")
-    )
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.sum("@random_num")
+        )
 
-    res = client.ft().aggregate(req).rows[0]
-    assert res[1] == "redis"
-    assert res[3] == "21"  # 10+8+3
+        res = client.ft().aggregate(req).rows[0]
+        assert res[1] == "redis"
+        assert res[3] == "21"  # 10+8+3
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.min("@random_num")
-    )
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.min("@random_num")
+        )
 
-    res = client.ft().aggregate(req).rows[0]
-    assert res[1] == "redis"
-    assert res[3] == "3"  # min(10,8,3)
+        res = client.ft().aggregate(req).rows[0]
+        assert res[1] == "redis"
+        assert res[3] == "3"  # min(10,8,3)
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.max("@random_num")
-    )
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.max("@random_num")
+        )
 
-    res = client.ft().aggregate(req).rows[0]
-    assert res[1] == "redis"
-    assert res[3] == "10"  # max(10,8,3)
+        res = client.ft().aggregate(req).rows[0]
+        assert res[1] == "redis"
+        assert res[3] == "10"  # max(10,8,3)
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.avg("@random_num")
-    )
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.avg("@random_num")
+        )
 
-    res = client.ft().aggregate(req).rows[0]
-    assert res[1] == "redis"
-    index = res.index("__generated_aliasavgrandom_num")
-    assert res[index + 1] == "7"  # (10+3+8)/3
+        res = client.ft().aggregate(req).rows[0]
+        assert res[1] == "redis"
+        index = res.index("__generated_aliasavgrandom_num")
+        assert res[index + 1] == "7"  # (10+3+8)/3
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.stddev("random_num")
-    )
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.stddev("random_num")
+        )
 
-    res = client.ft().aggregate(req).rows[0]
-    assert res[1] == "redis"
-    assert res[3] == "3.60555127546"
+        res = client.ft().aggregate(req).rows[0]
+        assert res[1] == "redis"
+        assert res[3] == "3.60555127546"
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.quantile("@random_num", 0.5)
-    )
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.quantile("@random_num", 0.5)
+        )
 
-    res = client.ft().aggregate(req).rows[0]
-    assert res[1] == "redis"
-    assert res[3] == "8"  # median of 3,8,10
+        res = client.ft().aggregate(req).rows[0]
+        assert res[1] == "redis"
+        assert res[3] == "8"  # median of 3,8,10
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.tolist("@title")
-    )
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.tolist("@title")
+        )
 
-    res = client.ft().aggregate(req).rows[0]
-    assert res[1] == "redis"
-    assert set(res[3]) == {"RediSearch", "RedisAI", "RedisJson"}
+        res = client.ft().aggregate(req).rows[0]
+        assert res[1] == "redis"
+        assert set(res[3]) == {"RediSearch", "RedisAI", "RedisJson"}
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.first_value("@title").alias("first")
-    )
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.first_value("@title").alias("first")
+        )
 
-    res = client.ft().aggregate(req).rows[0]
-    assert res == ["parent", "redis", "first", "RediSearch"]
+        res = client.ft().aggregate(req).rows[0]
+        assert res == ["parent", "redis", "first", "RediSearch"]
 
-    req = aggregations.AggregateRequest("redis").group_by(
-        "@parent", reducers.random_sample("@title", 2).alias("random")
-    )
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.random_sample("@title", 2).alias("random")
+        )
+
+        res = client.ft().aggregate(req).rows[0]
+        assert res[1] == "redis"
+        assert res[2] == "random"
+        assert len(res[3]) == 2
+        assert res[3][0] in ["RediSearch", "RedisAI", "RedisJson"]
+    else:
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.count()
+        )
+
+        res = client.ft().aggregate(req)["results"][0]
+        assert res["extra_attributes"]["parent"] == "redis"
+        assert res["extra_attributes"]["__generated_aliascount"] == "3"
+
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.count_distinct("@title")
+        )
+
+        res = client.ft().aggregate(req)["results"][0]
+        assert res["extra_attributes"]["parent"] == "redis"
+        assert res["extra_attributes"]["__generated_aliascount_distincttitle"] == "3"
+
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.count_distinctish("@title")
+        )
+
+        res = client.ft().aggregate(req)["results"][0]
+        assert res["extra_attributes"]["parent"] == "redis"
+        assert res["extra_attributes"]["__generated_aliascount_distinctishtitle"] == "3"
+
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.sum("@random_num")
+        )
+
+        res = client.ft().aggregate(req)["results"][0]
+        assert res["extra_attributes"]["parent"] == "redis"
+        assert res["extra_attributes"]["__generated_aliassumrandom_num"] == "21"
+
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.min("@random_num")
+        )
+
+        res = client.ft().aggregate(req)["results"][0]
+        assert res["extra_attributes"]["parent"] == "redis"
+        assert res["extra_attributes"]["__generated_aliasminrandom_num"] == "3"
 
-    res = client.ft().aggregate(req).rows[0]
-    assert res[1] == "redis"
-    assert res[2] == "random"
-    assert len(res[3]) == 2
-    assert res[3][0] in ["RediSearch", "RedisAI", "RedisJson"]
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.max("@random_num")
+        )
+
+        res = client.ft().aggregate(req)["results"][0]
+        assert res["extra_attributes"]["parent"] == "redis"
+        assert res["extra_attributes"]["__generated_aliasmaxrandom_num"] == "10"
+
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.avg("@random_num")
+        )
+
+        res = client.ft().aggregate(req)["results"][0]
+        assert res["extra_attributes"]["parent"] == "redis"
+        assert res["extra_attributes"]["__generated_aliasavgrandom_num"] == "7"
+
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.stddev("random_num")
+        )
+
+        res = client.ft().aggregate(req)["results"][0]
+        assert res["extra_attributes"]["parent"] == "redis"
+        assert (
+            res["extra_attributes"]["__generated_aliasstddevrandom_num"]
+            == "3.60555127546"
+        )
+
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.quantile("@random_num", 0.5)
+        )
+
+        res = client.ft().aggregate(req)["results"][0]
+        assert res["extra_attributes"]["parent"] == "redis"
+        assert res["extra_attributes"]["__generated_aliasquantilerandom_num,0.5"] == "8"
+
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.tolist("@title")
+        )
+
+        res = client.ft().aggregate(req)["results"][0]
+        assert res["extra_attributes"]["parent"] == "redis"
+        assert set(res["extra_attributes"]["__generated_aliastolisttitle"]) == {
+            "RediSearch",
+            "RedisAI",
+            "RedisJson",
+        }
+
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.first_value("@title").alias("first")
+        )
+
+        res = client.ft().aggregate(req)["results"][0]
+        assert res["extra_attributes"] == {"parent": "redis", "first": "RediSearch"}
+
+        req = aggregations.AggregateRequest("redis").group_by(
+            "@parent", reducers.random_sample("@title", 2).alias("random")
+        )
+
+        res = client.ft().aggregate(req)["results"][0]
+        assert res["extra_attributes"]["parent"] == "redis"
+        assert "random" in res["extra_attributes"].keys()
+        assert len(res["extra_attributes"]["random"]) == 2
+        assert res["extra_attributes"]["random"][0] in [
+            "RediSearch",
+            "RedisAI",
+            "RedisJson",
+        ]
 
 
 @pytest.mark.redismod
@@ -892,30 +1271,56 @@ def test_aggregations_sort_by_and_limit(client):
     client.ft().client.hset("doc1", mapping={"t1": "a", "t2": "b"})
     client.ft().client.hset("doc2", mapping={"t1": "b", "t2": "a"})
 
-    # test sort_by using SortDirection
-    req = aggregations.AggregateRequest("*").sort_by(
-        aggregations.Asc("@t2"), aggregations.Desc("@t1")
-    )
-    res = client.ft().aggregate(req)
-    assert res.rows[0] == ["t2", "a", "t1", "b"]
-    assert res.rows[1] == ["t2", "b", "t1", "a"]
+    if is_resp2_connection(client):
+        # test sort_by using SortDirection
+        req = aggregations.AggregateRequest("*").sort_by(
+            aggregations.Asc("@t2"), aggregations.Desc("@t1")
+        )
+        res = client.ft().aggregate(req)
+        assert res.rows[0] == ["t2", "a", "t1", "b"]
+        assert res.rows[1] == ["t2", "b", "t1", "a"]
 
-    # test sort_by without SortDirection
-    req = aggregations.AggregateRequest("*").sort_by("@t1")
-    res = client.ft().aggregate(req)
-    assert res.rows[0] == ["t1", "a"]
-    assert res.rows[1] == ["t1", "b"]
+        # test sort_by without SortDirection
+        req = aggregations.AggregateRequest("*").sort_by("@t1")
+        res = client.ft().aggregate(req)
+        assert res.rows[0] == ["t1", "a"]
+        assert res.rows[1] == ["t1", "b"]
 
-    # test sort_by with max
-    req = aggregations.AggregateRequest("*").sort_by("@t1", max=1)
-    res = client.ft().aggregate(req)
-    assert len(res.rows) == 1
+        # test sort_by with max
+        req = aggregations.AggregateRequest("*").sort_by("@t1", max=1)
+        res = client.ft().aggregate(req)
+        assert len(res.rows) == 1
 
-    # test limit
-    req = aggregations.AggregateRequest("*").sort_by("@t1").limit(1, 1)
-    res = client.ft().aggregate(req)
-    assert len(res.rows) == 1
-    assert res.rows[0] == ["t1", "b"]
+        # test limit
+        req = aggregations.AggregateRequest("*").sort_by("@t1").limit(1, 1)
+        res = client.ft().aggregate(req)
+        assert len(res.rows) == 1
+        assert res.rows[0] == ["t1", "b"]
+    else:
+        # test sort_by using SortDirection
+        req = aggregations.AggregateRequest("*").sort_by(
+            aggregations.Asc("@t2"), aggregations.Desc("@t1")
+        )
+        res = client.ft().aggregate(req)["results"]
+        assert res[0]["extra_attributes"] == {"t2": "a", "t1": "b"}
+        assert res[1]["extra_attributes"] == {"t2": "b", "t1": "a"}
+
+        # test sort_by without SortDirection
+        req = aggregations.AggregateRequest("*").sort_by("@t1")
+        res = client.ft().aggregate(req)["results"]
+        assert res[0]["extra_attributes"] == {"t1": "a"}
+        assert res[1]["extra_attributes"] == {"t1": "b"}
+
+        # test sort_by with max
+        req = aggregations.AggregateRequest("*").sort_by("@t1", max=1)
+        res = client.ft().aggregate(req)
+        assert len(res["results"]) == 1
+
+        # test limit
+        req = aggregations.AggregateRequest("*").sort_by("@t1").limit(1, 1)
+        res = client.ft().aggregate(req)
+        assert len(res["results"]) == 1
+        assert res["results"][0]["extra_attributes"] == {"t1": "b"}
 
 
 @pytest.mark.redismod
@@ -924,20 +1329,36 @@ def test_aggregations_load(client):
 
     client.ft().client.hset("doc1", mapping={"t1": "hello", "t2": "world"})
 
-    # load t1
-    req = aggregations.AggregateRequest("*").load("t1")
-    res = client.ft().aggregate(req)
-    assert res.rows[0] == ["t1", "hello"]
+    if is_resp2_connection(client):
+        # load t1
+        req = aggregations.AggregateRequest("*").load("t1")
+        res = client.ft().aggregate(req)
+        assert res.rows[0] == ["t1", "hello"]
 
-    # load t2
-    req = aggregations.AggregateRequest("*").load("t2")
-    res = client.ft().aggregate(req)
-    assert res.rows[0] == ["t2", "world"]
+        # load t2
+        req = aggregations.AggregateRequest("*").load("t2")
+        res = client.ft().aggregate(req)
+        assert res.rows[0] == ["t2", "world"]
 
-    # load all
-    req = aggregations.AggregateRequest("*").load()
-    res = client.ft().aggregate(req)
-    assert res.rows[0] == ["t1", "hello", "t2", "world"]
+        # load all
+        req = aggregations.AggregateRequest("*").load()
+        res = client.ft().aggregate(req)
+        assert res.rows[0] == ["t1", "hello", "t2", "world"]
+    else:
+        # load t1
+        req = aggregations.AggregateRequest("*").load("t1")
+        res = client.ft().aggregate(req)
+        assert res["results"][0]["extra_attributes"] == {"t1": "hello"}
+
+        # load t2
+        req = aggregations.AggregateRequest("*").load("t2")
+        res = client.ft().aggregate(req)
+        assert res["results"][0]["extra_attributes"] == {"t2": "world"}
+
+        # load all
+        req = aggregations.AggregateRequest("*").load()
+        res = client.ft().aggregate(req)
+        assert res["results"][0]["extra_attributes"] == {"t1": "hello", "t2": "world"}
 
 
 @pytest.mark.redismod
@@ -962,8 +1383,17 @@ def test_aggregations_apply(client):
         CreatedDateTimeUTC="@CreatedDateTimeUTC * 10"
     )
     res = client.ft().aggregate(req)
-    res_set = set([res.rows[0][1], res.rows[1][1]])
-    assert res_set == set(["6373878785249699840", "6373878758592700416"])
+    if is_resp2_connection(client):
+        res_set = set([res.rows[0][1], res.rows[1][1]])
+        assert res_set == set(["6373878785249699840", "6373878758592700416"])
+    else:
+        res_set = set(
+            [
+                res["results"][0]["extra_attributes"]["CreatedDateTimeUTC"],
+                res["results"][1]["extra_attributes"]["CreatedDateTimeUTC"],
+            ],
+        )
+        assert res_set == set(["6373878785249699840", "6373878758592700416"])
 
 
 @pytest.mark.redismod
@@ -982,19 +1412,34 @@ def test_aggregations_filter(client):
             .dialect(dialect)
         )
         res = client.ft().aggregate(req)
-        assert len(res.rows) == 1
-        assert res.rows[0] == ["name", "foo", "age", "19"]
-
-        req = (
-            aggregations.AggregateRequest("*")
-            .filter("@age > 15")
-            .sort_by("@age")
-            .dialect(dialect)
-        )
-        res = client.ft().aggregate(req)
-        assert len(res.rows) == 2
-        assert res.rows[0] == ["age", "19"]
-        assert res.rows[1] == ["age", "25"]
+        if is_resp2_connection(client):
+            assert len(res.rows) == 1
+            assert res.rows[0] == ["name", "foo", "age", "19"]
+
+            req = (
+                aggregations.AggregateRequest("*")
+                .filter("@age > 15")
+                .sort_by("@age")
+                .dialect(dialect)
+            )
+            res = client.ft().aggregate(req)
+            assert len(res.rows) == 2
+            assert res.rows[0] == ["age", "19"]
+            assert res.rows[1] == ["age", "25"]
+        else:
+            assert len(res["results"]) == 1
+            assert res["results"][0]["extra_attributes"] == {"name": "foo", "age": "19"}
+
+            req = (
+                aggregations.AggregateRequest("*")
+                .filter("@age > 15")
+                .sort_by("@age")
+                .dialect(dialect)
+            )
+            res = client.ft().aggregate(req)
+            assert len(res["results"]) == 2
+            assert res["results"][0]["extra_attributes"] == {"age": "19"}
+            assert res["results"][1]["extra_attributes"] == {"age": "25"}
 
 
 @pytest.mark.redismod
@@ -1060,7 +1505,11 @@ def test_skip_initial_scan(client):
     q = Query("@foo:bar")
 
     client.ft().create_index((TextField("foo"),), skip_initial_scan=True)
-    assert 0 == client.ft().search(q).total
+    res = client.ft().search(q)
+    if is_resp2_connection(client):
+        assert res.total == 0
+    else:
+        assert res["total_results"] == 0
 
 
 @pytest.mark.redismod
@@ -1148,10 +1597,15 @@ def test_create_client_definition_json(client):
     client.json().set("king:2", Path.root_path(), {"name": "james"})
 
     res = client.ft().search("henry")
-    assert res.docs[0].id == "king:1"
-    assert res.docs[0].payload is None
-    assert res.docs[0].json == '{"name":"henry"}'
-    assert res.total == 1
+    if is_resp2_connection(client):
+        assert res.docs[0].id == "king:1"
+        assert res.docs[0].payload is None
+        assert res.docs[0].json == '{"name":"henry"}'
+        assert res.total == 1
+    else:
+        assert res["results"][0]["id"] == "king:1"
+        assert res["results"][0]["extra_attributes"]["$"] == '{"name":"henry"}'
+        assert res["total_results"] == 1
 
 
 @pytest.mark.redismod
@@ -1169,11 +1623,17 @@ def test_fields_as_name(client):
     res = client.json().set("doc:1", Path.root_path(), {"name": "Jon", "age": 25})
     assert res
 
-    total = client.ft().search(Query("Jon").return_fields("name", "just_a_number")).docs
-    assert 1 == len(total)
-    assert "doc:1" == total[0].id
-    assert "Jon" == total[0].name
-    assert "25" == total[0].just_a_number
+    res = client.ft().search(Query("Jon").return_fields("name", "just_a_number"))
+    if is_resp2_connection(client):
+        assert 1 == len(res.docs)
+        assert "doc:1" == res.docs[0].id
+        assert "Jon" == res.docs[0].name
+        assert "25" == res.docs[0].just_a_number
+    else:
+        assert 1 == len(res["results"])
+        assert "doc:1" == res["results"][0]["id"]
+        assert "Jon" == res["results"][0]["extra_attributes"]["name"]
+        assert "25" == res["results"][0]["extra_attributes"]["just_a_number"]
 
 
 @pytest.mark.redismod
@@ -1184,11 +1644,16 @@ def test_casesensitive(client):
     client.ft().client.hset("1", "t", "HELLO")
     client.ft().client.hset("2", "t", "hello")
 
-    res = client.ft().search("@t:{HELLO}").docs
+    res = client.ft().search("@t:{HELLO}")
 
-    assert 2 == len(res)
-    assert "1" == res[0].id
-    assert "2" == res[1].id
+    if is_resp2_connection(client):
+        assert 2 == len(res.docs)
+        assert "1" == res.docs[0].id
+        assert "2" == res.docs[1].id
+    else:
+        assert 2 == len(res["results"])
+        assert "1" == res["results"][0]["id"]
+        assert "2" == res["results"][1]["id"]
 
     # create casesensitive index
     client.ft().dropindex()
@@ -1196,9 +1661,13 @@ def test_casesensitive(client):
     client.ft().create_index(SCHEMA)
     waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
-    res = client.ft().search("@t:{HELLO}").docs
-    assert 1 == len(res)
-    assert "1" == res[0].id
+    res = client.ft().search("@t:{HELLO}")
+    if is_resp2_connection(client):
+        assert 1 == len(res.docs)
+        assert "1" == res.docs[0].id
+    else:
+        assert 1 == len(res["results"])
+        assert "1" == res["results"][0]["id"]
 
 
 @pytest.mark.redismod
@@ -1217,15 +1686,26 @@ def test_search_return_fields(client):
     client.ft().create_index(SCHEMA, definition=definition)
     waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
-    total = client.ft().search(Query("*").return_field("$.t", as_field="txt")).docs
-    assert 1 == len(total)
-    assert "doc:1" == total[0].id
-    assert "riceratops" == total[0].txt
+    if is_resp2_connection(client):
+        total = client.ft().search(Query("*").return_field("$.t", as_field="txt")).docs
+        assert 1 == len(total)
+        assert "doc:1" == total[0].id
+        assert "riceratops" == total[0].txt
 
-    total = client.ft().search(Query("*").return_field("$.t2", as_field="txt")).docs
-    assert 1 == len(total)
-    assert "doc:1" == total[0].id
-    assert "telmatosaurus" == total[0].txt
+        total = client.ft().search(Query("*").return_field("$.t2", as_field="txt")).docs
+        assert 1 == len(total)
+        assert "doc:1" == total[0].id
+        assert "telmatosaurus" == total[0].txt
+    else:
+        total = client.ft().search(Query("*").return_field("$.t", as_field="txt"))
+        assert 1 == len(total["results"])
+        assert "doc:1" == total["results"][0]["id"]
+        assert "riceratops" == total["results"][0]["extra_attributes"]["txt"]
+
+        total = client.ft().search(Query("*").return_field("$.t2", as_field="txt"))
+        assert 1 == len(total["results"])
+        assert "doc:1" == total["results"][0]["id"]
+        assert "telmatosaurus" == total["results"][0]["extra_attributes"]["txt"]
 
 
 @pytest.mark.redismod
@@ -1242,9 +1722,14 @@ def test_synupdate(client):
     client.hset("doc2", mapping={"title": "he is another baby", "body": "another test"})
 
     res = client.ft().search(Query("child").expander("SYNONYM"))
-    assert res.docs[0].id == "doc2"
-    assert res.docs[0].title == "he is another baby"
-    assert res.docs[0].body == "another test"
+    if is_resp2_connection(client):
+        assert res.docs[0].id == "doc2"
+        assert res.docs[0].title == "he is another baby"
+        assert res.docs[0].body == "another test"
+    else:
+        assert res["results"][0]["id"] == "doc2"
+        assert res["results"][0]["extra_attributes"]["title"] == "he is another baby"
+        assert res["results"][0]["extra_attributes"]["body"] == "another test"
 
 
 @pytest.mark.redismod
@@ -1284,15 +1769,28 @@ def test_create_json_with_alias(client):
     client.json().set("king:1", Path.root_path(), {"name": "henry", "num": 42})
     client.json().set("king:2", Path.root_path(), {"name": "james", "num": 3.14})
 
-    res = client.ft().search("@name:henry")
-    assert res.docs[0].id == "king:1"
-    assert res.docs[0].json == '{"name":"henry","num":42}'
-    assert res.total == 1
-
-    res = client.ft().search("@num:[0 10]")
-    assert res.docs[0].id == "king:2"
-    assert res.docs[0].json == '{"name":"james","num":3.14}'
-    assert res.total == 1
+    if is_resp2_connection(client):
+        res = client.ft().search("@name:henry")
+        assert res.docs[0].id == "king:1"
+        assert res.docs[0].json == '{"name":"henry","num":42}'
+        assert res.total == 1
+
+        res = client.ft().search("@num:[0 10]")
+        assert res.docs[0].id == "king:2"
+        assert res.docs[0].json == '{"name":"james","num":3.14}'
+        assert res.total == 1
+    else:
+        res = client.ft().search("@name:henry")
+        assert res["results"][0]["id"] == "king:1"
+        assert res["results"][0]["extra_attributes"]["$"] == '{"name":"henry","num":42}'
+        assert res["total_results"] == 1
+
+        res = client.ft().search("@num:[0 10]")
+        assert res["results"][0]["id"] == "king:2"
+        assert (
+            res["results"][0]["extra_attributes"]["$"] == '{"name":"james","num":3.14}'
+        )
+        assert res["total_results"] == 1
 
     # Tests returns an error if path contain special characters (user should
     # use an alias)
@@ -1316,15 +1814,32 @@ def test_json_with_multipath(client):
         "king:1", Path.root_path(), {"name": "henry", "country": {"name": "england"}}
     )
 
-    res = client.ft().search("@name:{henry}")
-    assert res.docs[0].id == "king:1"
-    assert res.docs[0].json == '{"name":"henry","country":{"name":"england"}}'
-    assert res.total == 1
+    if is_resp2_connection(client):
+        res = client.ft().search("@name:{henry}")
+        assert res.docs[0].id == "king:1"
+        assert res.docs[0].json == '{"name":"henry","country":{"name":"england"}}'
+        assert res.total == 1
+
+        res = client.ft().search("@name:{england}")
+        assert res.docs[0].id == "king:1"
+        assert res.docs[0].json == '{"name":"henry","country":{"name":"england"}}'
+        assert res.total == 1
+    else:
+        res = client.ft().search("@name:{henry}")
+        assert res["results"][0]["id"] == "king:1"
+        assert (
+            res["results"][0]["extra_attributes"]["$"]
+            == '{"name":"henry","country":{"name":"england"}}'
+        )
+        assert res["total_results"] == 1
 
-    res = client.ft().search("@name:{england}")
-    assert res.docs[0].id == "king:1"
-    assert res.docs[0].json == '{"name":"henry","country":{"name":"england"}}'
-    assert res.total == 1
+        res = client.ft().search("@name:{england}")
+        assert res["results"][0]["id"] == "king:1"
+        assert (
+            res["results"][0]["extra_attributes"]["$"]
+            == '{"name":"henry","country":{"name":"england"}}'
+        )
+        assert res["total_results"] == 1
 
 
 @pytest.mark.redismod
@@ -1341,21 +1856,40 @@ def test_json_with_jsonpath(client):
 
     client.json().set("doc:1", Path.root_path(), {"prod:name": "RediSearch"})
 
-    # query for a supported field succeeds
-    res = client.ft().search(Query("@name:RediSearch"))
-    assert res.total == 1
-    assert res.docs[0].id == "doc:1"
-    assert res.docs[0].json == '{"prod:name":"RediSearch"}'
+    if is_resp2_connection(client):
+        # query for a supported field succeeds
+        res = client.ft().search(Query("@name:RediSearch"))
+        assert res.total == 1
+        assert res.docs[0].id == "doc:1"
+        assert res.docs[0].json == '{"prod:name":"RediSearch"}'
+
+        # query for an unsupported field
+        res = client.ft().search("@name_unsupported:RediSearch")
+        assert res.total == 1
+
+        # return of a supported field succeeds
+        res = client.ft().search(Query("@name:RediSearch").return_field("name"))
+        assert res.total == 1
+        assert res.docs[0].id == "doc:1"
+        assert res.docs[0].name == "RediSearch"
+    else:
+        # query for a supported field succeeds
+        res = client.ft().search(Query("@name:RediSearch"))
+        assert res["total_results"] == 1
+        assert res["results"][0]["id"] == "doc:1"
+        assert (
+            res["results"][0]["extra_attributes"]["$"] == '{"prod:name":"RediSearch"}'
+        )
 
-    # query for an unsupported field
-    res = client.ft().search("@name_unsupported:RediSearch")
-    assert res.total == 1
+        # query for an unsupported field
+        res = client.ft().search("@name_unsupported:RediSearch")
+        assert res["total_results"] == 1
 
-    # return of a supported field succeeds
-    res = client.ft().search(Query("@name:RediSearch").return_field("name"))
-    assert res.total == 1
-    assert res.docs[0].id == "doc:1"
-    assert res.docs[0].name == "RediSearch"
+        # return of a supported field succeeds
+        res = client.ft().search(Query("@name:RediSearch").return_field("name"))
+        assert res["total_results"] == 1
+        assert res["results"][0]["id"] == "doc:1"
+        assert res["results"][0]["extra_attributes"]["name"] == "RediSearch"
 
 
 @pytest.mark.redismod
@@ -1368,24 +1902,43 @@ def test_profile(client):
 
     # check using Query
     q = Query("hello|world").no_content()
-    res, det = client.ft().profile(q)
-    assert det["Iterators profile"]["Counter"] == 2.0
-    assert len(det["Iterators profile"]["Child iterators"]) == 2
-    assert det["Iterators profile"]["Type"] == "UNION"
-    assert det["Parsing time"] < 0.5
-    assert len(res.docs) == 2  # check also the search result
-
-    # check using AggregateRequest
-    req = (
-        aggregations.AggregateRequest("*")
-        .load("t")
-        .apply(prefix="startswith(@t, 'hel')")
-    )
-    res, det = client.ft().profile(req)
-    assert det["Iterators profile"]["Counter"] == 2.0
-    assert det["Iterators profile"]["Type"] == "WILDCARD"
-    assert isinstance(det["Parsing time"], float)
-    assert len(res.rows) == 2  # check also the search result
+    if is_resp2_connection(client):
+        res, det = client.ft().profile(q)
+        assert det["Iterators profile"]["Counter"] == 2.0
+        assert len(det["Iterators profile"]["Child iterators"]) == 2
+        assert det["Iterators profile"]["Type"] == "UNION"
+        assert det["Parsing time"] < 0.5
+        assert len(res.docs) == 2  # check also the search result
+
+        # check using AggregateRequest
+        req = (
+            aggregations.AggregateRequest("*")
+            .load("t")
+            .apply(prefix="startswith(@t, 'hel')")
+        )
+        res, det = client.ft().profile(req)
+        assert det["Iterators profile"]["Counter"] == 2
+        assert det["Iterators profile"]["Type"] == "WILDCARD"
+        assert isinstance(det["Parsing time"], float)
+        assert len(res.rows) == 2  # check also the search result
+    else:
+        res = client.ft().profile(q)
+        assert res["profile"]["Iterators profile"][0]["Counter"] == 2.0
+        assert res["profile"]["Iterators profile"][0]["Type"] == "UNION"
+        assert res["profile"]["Parsing time"] < 0.5
+        assert len(res["results"]) == 2  # check also the search result
+
+        # check using AggregateRequest
+        req = (
+            aggregations.AggregateRequest("*")
+            .load("t")
+            .apply(prefix="startswith(@t, 'hel')")
+        )
+        res = client.ft().profile(req)
+        assert res["profile"]["Iterators profile"][0]["Counter"] == 2
+        assert res["profile"]["Iterators profile"][0]["Type"] == "WILDCARD"
+        assert isinstance(res["profile"]["Parsing time"], float)
+        assert len(res["results"]) == 2  # check also the search result
 
 
 @pytest.mark.redismod
@@ -1398,134 +1951,174 @@ def test_profile_limited(client):
     client.ft().client.hset("4", "t", "helowa")
 
     q = Query("%hell% hel*")
-    res, det = client.ft().profile(q, limited=True)
-    assert (
-        det["Iterators profile"]["Child iterators"][0]["Child iterators"]
-        == "The number of iterators in the union is 3"
-    )
-    assert (
-        det["Iterators profile"]["Child iterators"][1]["Child iterators"]
-        == "The number of iterators in the union is 4"
-    )
-    assert det["Iterators profile"]["Type"] == "INTERSECT"
-    assert len(res.docs) == 3  # check also the search result
+    if is_resp2_connection(client):
+        res, det = client.ft().profile(q, limited=True)
+        assert (
+            det["Iterators profile"]["Child iterators"][0]["Child iterators"]
+            == "The number of iterators in the union is 3"
+        )
+        assert (
+            det["Iterators profile"]["Child iterators"][1]["Child iterators"]
+            == "The number of iterators in the union is 4"
+        )
+        assert det["Iterators profile"]["Type"] == "INTERSECT"
+        assert len(res.docs) == 3  # check also the search result
+    else:
+        res = client.ft().profile(q, limited=True)
+        iterators_profile = res["profile"]["Iterators profile"]
+        assert (
+            iterators_profile[0]["Child iterators"][0]["Child iterators"]
+            == "The number of iterators in the union is 3"
+        )
+        assert (
+            iterators_profile[0]["Child iterators"][1]["Child iterators"]
+            == "The number of iterators in the union is 4"
+        )
+        assert iterators_profile[0]["Type"] == "INTERSECT"
+        assert len(res["results"]) == 3  # check also the search result
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("2.4.3", "search")
-def test_profile_query_params(modclient: redis.Redis):
-    modclient.flushdb()
-    modclient.ft().create_index(
+def test_profile_query_params(client):
+    client.ft().create_index(
         (
             VectorField(
                 "v", "HNSW", {"TYPE": "FLOAT32", "DIM": 2, "DISTANCE_METRIC": "L2"}
             ),
         )
     )
-    modclient.hset("a", "v", "aaaaaaaa")
-    modclient.hset("b", "v", "aaaabaaa")
-    modclient.hset("c", "v", "aaaaabaa")
+    client.hset("a", "v", "aaaaaaaa")
+    client.hset("b", "v", "aaaabaaa")
+    client.hset("c", "v", "aaaaabaa")
     query = "*=>[KNN 2 @v $vec]"
     q = Query(query).return_field("__v_score").sort_by("__v_score", True).dialect(2)
-    res, det = modclient.ft().profile(q, query_params={"vec": "aaaaaaaa"})
-    assert det["Iterators profile"]["Counter"] == 2.0
-    assert det["Iterators profile"]["Type"] == "VECTOR"
-    assert res.total == 2
-    assert "a" == res.docs[0].id
-    assert "0" == res.docs[0].__getattribute__("__v_score")
+    if is_resp2_connection(client):
+        res, det = client.ft().profile(q, query_params={"vec": "aaaaaaaa"})
+        assert det["Iterators profile"]["Counter"] == 2.0
+        assert det["Iterators profile"]["Type"] == "VECTOR"
+        assert res.total == 2
+        assert "a" == res.docs[0].id
+        assert "0" == res.docs[0].__getattribute__("__v_score")
+    else:
+        res = client.ft().profile(q, query_params={"vec": "aaaaaaaa"})
+        assert res["profile"]["Iterators profile"][0]["Counter"] == 2
+        assert res["profile"]["Iterators profile"][0]["Type"] == "VECTOR"
+        assert res["total_results"] == 2
+        assert "a" == res["results"][0]["id"]
+        assert "0" == res["results"][0]["extra_attributes"]["__v_score"]
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("2.4.3", "search")
-def test_vector_field(modclient):
-    modclient.flushdb()
-    modclient.ft().create_index(
+def test_vector_field(client):
+    client.flushdb()
+    client.ft().create_index(
         (
             VectorField(
                 "v", "HNSW", {"TYPE": "FLOAT32", "DIM": 2, "DISTANCE_METRIC": "L2"}
             ),
         )
     )
-    modclient.hset("a", "v", "aaaaaaaa")
-    modclient.hset("b", "v", "aaaabaaa")
-    modclient.hset("c", "v", "aaaaabaa")
+    client.hset("a", "v", "aaaaaaaa")
+    client.hset("b", "v", "aaaabaaa")
+    client.hset("c", "v", "aaaaabaa")
 
     query = "*=>[KNN 2 @v $vec]"
     q = Query(query).return_field("__v_score").sort_by("__v_score", True).dialect(2)
-    res = modclient.ft().search(q, query_params={"vec": "aaaaaaaa"})
+    res = client.ft().search(q, query_params={"vec": "aaaaaaaa"})
 
-    assert "a" == res.docs[0].id
-    assert "0" == res.docs[0].__getattribute__("__v_score")
+    if is_resp2_connection(client):
+        assert "a" == res.docs[0].id
+        assert "0" == res.docs[0].__getattribute__("__v_score")
+    else:
+        assert "a" == res["results"][0]["id"]
+        assert "0" == res["results"][0]["extra_attributes"]["__v_score"]
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("2.4.3", "search")
-def test_vector_field_error(modclient):
-    modclient.flushdb()
+def test_vector_field_error(r):
+    r.flushdb()
 
     # sortable tag
     with pytest.raises(Exception):
-        modclient.ft().create_index((VectorField("v", "HNSW", {}, sortable=True),))
+        r.ft().create_index((VectorField("v", "HNSW", {}, sortable=True),))
 
     # not supported algorithm
     with pytest.raises(Exception):
-        modclient.ft().create_index((VectorField("v", "SORT", {}),))
+        r.ft().create_index((VectorField("v", "SORT", {}),))
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("2.4.3", "search")
-def test_text_params(modclient):
-    modclient.flushdb()
-    modclient.ft().create_index((TextField("name"),))
+def test_text_params(client):
+    client.flushdb()
+    client.ft().create_index((TextField("name"),))
 
-    modclient.hset("doc1", mapping={"name": "Alice"})
-    modclient.hset("doc2", mapping={"name": "Bob"})
-    modclient.hset("doc3", mapping={"name": "Carol"})
+    client.hset("doc1", mapping={"name": "Alice"})
+    client.hset("doc2", mapping={"name": "Bob"})
+    client.hset("doc3", mapping={"name": "Carol"})
 
     params_dict = {"name1": "Alice", "name2": "Bob"}
     q = Query("@name:($name1 | $name2 )").dialect(2)
-    res = modclient.ft().search(q, query_params=params_dict)
-    assert 2 == res.total
-    assert "doc1" == res.docs[0].id
-    assert "doc2" == res.docs[1].id
+    res = client.ft().search(q, query_params=params_dict)
+    if is_resp2_connection(client):
+        assert 2 == res.total
+        assert "doc1" == res.docs[0].id
+        assert "doc2" == res.docs[1].id
+    else:
+        assert 2 == res["total_results"]
+        assert "doc1" == res["results"][0]["id"]
+        assert "doc2" == res["results"][1]["id"]
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("2.4.3", "search")
-def test_numeric_params(modclient):
-    modclient.flushdb()
-    modclient.ft().create_index((NumericField("numval"),))
+def test_numeric_params(client):
+    client.flushdb()
+    client.ft().create_index((NumericField("numval"),))
 
-    modclient.hset("doc1", mapping={"numval": 101})
-    modclient.hset("doc2", mapping={"numval": 102})
-    modclient.hset("doc3", mapping={"numval": 103})
+    client.hset("doc1", mapping={"numval": 101})
+    client.hset("doc2", mapping={"numval": 102})
+    client.hset("doc3", mapping={"numval": 103})
 
     params_dict = {"min": 101, "max": 102}
     q = Query("@numval:[$min $max]").dialect(2)
-    res = modclient.ft().search(q, query_params=params_dict)
+    res = client.ft().search(q, query_params=params_dict)
 
-    assert 2 == res.total
-    assert "doc1" == res.docs[0].id
-    assert "doc2" == res.docs[1].id
+    if is_resp2_connection(client):
+        assert 2 == res.total
+        assert "doc1" == res.docs[0].id
+        assert "doc2" == res.docs[1].id
+    else:
+        assert 2 == res["total_results"]
+        assert "doc1" == res["results"][0]["id"]
+        assert "doc2" == res["results"][1]["id"]
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("2.4.3", "search")
-def test_geo_params(modclient):
+def test_geo_params(client):
 
-    modclient.flushdb()
-    modclient.ft().create_index((GeoField("g")))
-    modclient.hset("doc1", mapping={"g": "29.69465, 34.95126"})
-    modclient.hset("doc2", mapping={"g": "29.69350, 34.94737"})
-    modclient.hset("doc3", mapping={"g": "29.68746, 34.94882"})
+    client.ft().create_index((GeoField("g")))
+    client.hset("doc1", mapping={"g": "29.69465, 34.95126"})
+    client.hset("doc2", mapping={"g": "29.69350, 34.94737"})
+    client.hset("doc3", mapping={"g": "29.68746, 34.94882"})
 
     params_dict = {"lat": "34.95126", "lon": "29.69465", "radius": 1000, "units": "km"}
     q = Query("@g:[$lon $lat $radius $units]").dialect(2)
-    res = modclient.ft().search(q, query_params=params_dict)
-    assert 3 == res.total
-    assert "doc1" == res.docs[0].id
-    assert "doc2" == res.docs[1].id
-    assert "doc3" == res.docs[2].id
+    res = client.ft().search(q, query_params=params_dict)
+    if is_resp2_connection(client):
+        assert 3 == res.total
+        assert "doc1" == res.docs[0].id
+        assert "doc2" == res.docs[1].id
+        assert "doc3" == res.docs[2].id
+    else:
+        assert 3 == res["total_results"]
+        assert "doc1" == res["results"][0]["id"]
+        assert "doc2" == res["results"][1]["id"]
+        assert "doc3" == res["results"][2]["id"]
 
 
 @pytest.mark.redismod
@@ -1538,29 +2131,41 @@ def test_search_commands_in_pipeline(client):
     q = Query("foo bar").with_payloads()
     p.search(q)
     res = p.execute()
-    assert res[:3] == ["OK", True, True]
-    assert 2 == res[3][0]
-    assert "doc1" == res[3][1]
-    assert "doc2" == res[3][4]
-    assert res[3][5] is None
-    assert res[3][3] == res[3][6] == ["txt", "foo bar"]
+    if is_resp2_connection(client):
+        assert res[:3] == ["OK", True, True]
+        assert 2 == res[3][0]
+        assert "doc1" == res[3][1]
+        assert "doc2" == res[3][4]
+        assert res[3][5] is None
+        assert res[3][3] == res[3][6] == ["txt", "foo bar"]
+    else:
+        assert res[:3] == ["OK", True, True]
+        assert 2 == res[3]["total_results"]
+        assert "doc1" == res[3]["results"][0]["id"]
+        assert "doc2" == res[3]["results"][1]["id"]
+        assert res[3]["results"][0]["payload"] is None
+        assert (
+            res[3]["results"][0]["extra_attributes"]
+            == res[3]["results"][1]["extra_attributes"]
+            == {"txt": "foo bar"}
+        )
 
 
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("2.4.3", "search")
-def test_dialect_config(modclient: redis.Redis):
-    assert modclient.ft().config_get("DEFAULT_DIALECT") == {"DEFAULT_DIALECT": "1"}
-    assert modclient.ft().config_set("DEFAULT_DIALECT", 2)
-    assert modclient.ft().config_get("DEFAULT_DIALECT") == {"DEFAULT_DIALECT": "2"}
+def test_dialect_config(client):
+    assert client.ft().config_get("DEFAULT_DIALECT")
+    client.ft().config_set("DEFAULT_DIALECT", 2)
+    assert client.ft().config_get("DEFAULT_DIALECT") == {"DEFAULT_DIALECT": "2"}
     with pytest.raises(redis.ResponseError):
-        modclient.ft().config_set("DEFAULT_DIALECT", 0)
+        client.ft().config_set("DEFAULT_DIALECT", 0)
 
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("2.4.3", "search")
-def test_dialect(modclient: redis.Redis):
-    modclient.ft().create_index(
+def test_dialect(client):
+    client.ft().create_index(
         (
             TagField("title"),
             TextField("t1"),
@@ -1571,68 +2176,94 @@ def test_dialect(modclient: redis.Redis):
             ),
         )
     )
-    modclient.hset("h", "t1", "hello")
+    client.hset("h", "t1", "hello")
     with pytest.raises(redis.ResponseError) as err:
-        modclient.ft().explain(Query("(*)").dialect(1))
+        client.ft().explain(Query("(*)").dialect(1))
     assert "Syntax error" in str(err)
-    assert "WILDCARD" in modclient.ft().explain(Query("(*)").dialect(2))
+    assert "WILDCARD" in client.ft().explain(Query("(*)").dialect(2))
 
     with pytest.raises(redis.ResponseError) as err:
-        modclient.ft().explain(Query("$hello").dialect(1))
+        client.ft().explain(Query("$hello").dialect(1))
     assert "Syntax error" in str(err)
     q = Query("$hello").dialect(2)
     expected = "UNION {\n  hello\n  +hello(expanded)\n}\n"
-    assert expected in modclient.ft().explain(q, query_params={"hello": "hello"})
+    assert expected in client.ft().explain(q, query_params={"hello": "hello"})
 
     expected = "NUMERIC {0.000000 <= @num <= 10.000000}\n"
-    assert expected in modclient.ft().explain(Query("@title:(@num:[0 10])").dialect(1))
+    assert expected in client.ft().explain(Query("@title:(@num:[0 10])").dialect(1))
     with pytest.raises(redis.ResponseError) as err:
-        modclient.ft().explain(Query("@title:(@num:[0 10])").dialect(2))
+        client.ft().explain(Query("@title:(@num:[0 10])").dialect(2))
     assert "Syntax error" in str(err)
 
 
 @pytest.mark.redismod
-def test_expire_while_search(modclient: redis.Redis):
-    modclient.ft().create_index((TextField("txt"),))
-    modclient.hset("hset:1", "txt", "a")
-    modclient.hset("hset:2", "txt", "b")
-    modclient.hset("hset:3", "txt", "c")
-    assert 3 == modclient.ft().search(Query("*")).total
-    modclient.pexpire("hset:2", 300)
-    for _ in range(500):
-        modclient.ft().search(Query("*")).docs[1]
-    time.sleep(1)
-    assert 2 == modclient.ft().search(Query("*")).total
+def test_expire_while_search(client: redis.Redis):
+    client.ft().create_index((TextField("txt"),))
+    client.hset("hset:1", "txt", "a")
+    client.hset("hset:2", "txt", "b")
+    client.hset("hset:3", "txt", "c")
+    if is_resp2_connection(client):
+        assert 3 == client.ft().search(Query("*")).total
+        client.pexpire("hset:2", 300)
+        for _ in range(500):
+            client.ft().search(Query("*")).docs[1]
+        time.sleep(1)
+        assert 2 == client.ft().search(Query("*")).total
+    else:
+        assert 3 == client.ft().search(Query("*"))["total_results"]
+        client.pexpire("hset:2", 300)
+        for _ in range(500):
+            client.ft().search(Query("*"))["results"][1]
+        time.sleep(1)
+        assert 2 == client.ft().search(Query("*"))["total_results"]
 
 
 @pytest.mark.redismod
 @pytest.mark.experimental
-def test_withsuffixtrie(modclient: redis.Redis):
+def test_withsuffixtrie(client: redis.Redis):
     # create index
-    assert modclient.ft().create_index((TextField("txt"),))
-    waitForIndex(modclient, getattr(modclient.ft(), "index_name", "idx"))
-    info = modclient.ft().info()
-    assert "WITHSUFFIXTRIE" not in info["attributes"][0]
-    assert modclient.ft().dropindex("idx")
-
-    # create withsuffixtrie index (text fiels)
-    assert modclient.ft().create_index((TextField("t", withsuffixtrie=True)))
-    waitForIndex(modclient, getattr(modclient.ft(), "index_name", "idx"))
-    info = modclient.ft().info()
-    assert "WITHSUFFIXTRIE" in info["attributes"][0]
-    assert modclient.ft().dropindex("idx")
-
-    # create withsuffixtrie index (tag field)
-    assert modclient.ft().create_index((TagField("t", withsuffixtrie=True)))
-    waitForIndex(modclient, getattr(modclient.ft(), "index_name", "idx"))
-    info = modclient.ft().info()
-    assert "WITHSUFFIXTRIE" in info["attributes"][0]
+    assert client.ft().create_index((TextField("txt"),))
+    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
+    if is_resp2_connection(client):
+        info = client.ft().info()
+        assert "WITHSUFFIXTRIE" not in info["attributes"][0]
+        assert client.ft().dropindex("idx")
+
+        # create withsuffixtrie index (text fiels)
+        assert client.ft().create_index((TextField("t", withsuffixtrie=True)))
+        waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
+        info = client.ft().info()
+        assert "WITHSUFFIXTRIE" in info["attributes"][0]
+        assert client.ft().dropindex("idx")
+
+        # create withsuffixtrie index (tag field)
+        assert client.ft().create_index((TagField("t", withsuffixtrie=True)))
+        waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
+        info = client.ft().info()
+        assert "WITHSUFFIXTRIE" in info["attributes"][0]
+    else:
+        info = client.ft().info()
+        assert "WITHSUFFIXTRIE" not in info["attributes"][0]["flags"]
+        assert client.ft().dropindex("idx")
+
+        # create withsuffixtrie index (text fiels)
+        assert client.ft().create_index((TextField("t", withsuffixtrie=True)))
+        waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
+        info = client.ft().info()
+        assert "WITHSUFFIXTRIE" in info["attributes"][0]["flags"]
+        assert client.ft().dropindex("idx")
+
+        # create withsuffixtrie index (tag field)
+        assert client.ft().create_index((TagField("t", withsuffixtrie=True)))
+        waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
+        info = client.ft().info()
+        assert "WITHSUFFIXTRIE" in info["attributes"][0]["flags"]
 
 
 @pytest.mark.redismod
-def test_query_timeout(modclient: redis.Redis):
+def test_query_timeout(r: redis.Redis):
     q1 = Query("foo").timeout(5000)
     assert q1.get_args() == ["foo", "TIMEOUT", 5000, "LIMIT", 0, 10]
     q2 = Query("foo").timeout("not_a_number")
     with pytest.raises(redis.ResponseError):
-        modclient.ft().search(q2)
+        r.ft().search(q2)
diff --git a/tests/test_sentinel.py b/tests/test_sentinel.py
index e5e3d26fa7..b7bcc27de2 100644
--- a/tests/test_sentinel.py
+++ b/tests/test_sentinel.py
@@ -1,7 +1,6 @@
 import socket
 
 import pytest
-
 import redis.sentinel
 from redis import exceptions
 from redis.sentinel import (
diff --git a/tests/test_ssl.py b/tests/test_ssl.py
index c1a981d310..465fdabb89 100644
--- a/tests/test_ssl.py
+++ b/tests/test_ssl.py
@@ -3,7 +3,6 @@
 from urllib.parse import urlparse
 
 import pytest
-
 import redis
 from redis.exceptions import ConnectionError, RedisError
 
diff --git a/tests/test_timeseries.py b/tests/test_timeseries.py
index 6ced5359f7..80490af4ef 100644
--- a/tests/test_timeseries.py
+++ b/tests/test_timeseries.py
@@ -3,16 +3,15 @@
 from time import sleep
 
 import pytest
-
 import redis
 
-from .conftest import skip_ifmodversion_lt
+from .conftest import assert_resp_response, is_resp2_connection, skip_ifmodversion_lt
 
 
 @pytest.fixture
-def client(modclient):
-    modclient.flushdb()
-    return modclient
+def client(decoded_r):
+    decoded_r.flushdb()
+    return decoded_r
 
 
 @pytest.mark.redismod
@@ -22,13 +21,15 @@ def test_create(client):
     assert client.ts().create(3, labels={"Redis": "Labs"})
     assert client.ts().create(4, retention_msecs=20, labels={"Time": "Series"})
     info = client.ts().info(4)
-    assert 20 == info.retention_msecs
-    assert "Series" == info.labels["Time"]
+    assert_resp_response(
+        client, 20, info.get("retention_msecs"), info.get("retentionTime")
+    )
+    assert "Series" == info["labels"]["Time"]
 
     # Test for a chunk size of 128 Bytes
     assert client.ts().create("time-serie-1", chunk_size=128)
     info = client.ts().info("time-serie-1")
-    assert 128, info.chunk_size
+    assert_resp_response(client, 128, info.get("chunk_size"), info.get("chunkSize"))
 
 
 @pytest.mark.redismod
@@ -39,19 +40,33 @@ def test_create_duplicate_policy(client):
         ts_name = f"time-serie-ooo-{duplicate_policy}"
         assert client.ts().create(ts_name, duplicate_policy=duplicate_policy)
         info = client.ts().info(ts_name)
-        assert duplicate_policy == info.duplicate_policy
+        assert_resp_response(
+            client,
+            duplicate_policy,
+            info.get("duplicate_policy"),
+            info.get("duplicatePolicy"),
+        )
 
 
 @pytest.mark.redismod
 def test_alter(client):
     assert client.ts().create(1)
-    assert 0 == client.ts().info(1).retention_msecs
+    info = client.ts().info(1)
+    assert_resp_response(
+        client, 0, info.get("retention_msecs"), info.get("retentionTime")
+    )
     assert client.ts().alter(1, retention_msecs=10)
-    assert {} == client.ts().info(1).labels
-    assert 10, client.ts().info(1).retention_msecs
+    assert {} == client.ts().info(1)["labels"]
+    info = client.ts().info(1)
+    assert_resp_response(
+        client, 10, info.get("retention_msecs"), info.get("retentionTime")
+    )
     assert client.ts().alter(1, labels={"Time": "Series"})
-    assert "Series" == client.ts().info(1).labels["Time"]
-    assert 10 == client.ts().info(1).retention_msecs
+    assert "Series" == client.ts().info(1)["labels"]["Time"]
+    info = client.ts().info(1)
+    assert_resp_response(
+        client, 10, info.get("retention_msecs"), info.get("retentionTime")
+    )
 
 
 @pytest.mark.redismod
@@ -59,10 +74,14 @@ def test_alter(client):
 def test_alter_diplicate_policy(client):
     assert client.ts().create(1)
     info = client.ts().info(1)
-    assert info.duplicate_policy is None
+    assert_resp_response(
+        client, None, info.get("duplicate_policy"), info.get("duplicatePolicy")
+    )
     assert client.ts().alter(1, duplicate_policy="min")
     info = client.ts().info(1)
-    assert "min" == info.duplicate_policy
+    assert_resp_response(
+        client, "min", info.get("duplicate_policy"), info.get("duplicatePolicy")
+    )
 
 
 @pytest.mark.redismod
@@ -77,13 +96,15 @@ def test_add(client):
     assert abs(time.time() - float(client.ts().add(5, "*", 1)) / 1000) < 1.0
 
     info = client.ts().info(4)
-    assert 10 == info.retention_msecs
-    assert "Labs" == info.labels["Redis"]
+    assert_resp_response(
+        client, 10, info.get("retention_msecs"), info.get("retentionTime")
+    )
+    assert "Labs" == info["labels"]["Redis"]
 
     # Test for a chunk size of 128 Bytes on TS.ADD
     assert client.ts().add("time-serie-1", 1, 10.0, chunk_size=128)
     info = client.ts().info("time-serie-1")
-    assert 128 == info.chunk_size
+    assert_resp_response(client, 128, info.get("chunk_size"), info.get("chunkSize"))
 
 
 @pytest.mark.redismod
@@ -142,21 +163,21 @@ def test_incrby_decrby(client):
     assert 0 == client.ts().get(1)[1]
 
     assert client.ts().incrby(2, 1.5, timestamp=5)
-    assert (5, 1.5) == client.ts().get(2)
+    assert_resp_response(client, client.ts().get(2), (5, 1.5), [5, 1.5])
     assert client.ts().incrby(2, 2.25, timestamp=7)
-    assert (7, 3.75) == client.ts().get(2)
+    assert_resp_response(client, client.ts().get(2), (7, 3.75), [7, 3.75])
     assert client.ts().decrby(2, 1.5, timestamp=15)
-    assert (15, 2.25) == client.ts().get(2)
+    assert_resp_response(client, client.ts().get(2), (15, 2.25), [15, 2.25])
 
     # Test for a chunk size of 128 Bytes on TS.INCRBY
     assert client.ts().incrby("time-serie-1", 10, chunk_size=128)
     info = client.ts().info("time-serie-1")
-    assert 128 == info.chunk_size
+    assert_resp_response(client, 128, info.get("chunk_size"), info.get("chunkSize"))
 
     # Test for a chunk size of 128 Bytes on TS.DECRBY
     assert client.ts().decrby("time-serie-2", 10, chunk_size=128)
     info = client.ts().info("time-serie-2")
-    assert 128 == info.chunk_size
+    assert_resp_response(client, 128, info.get("chunk_size"), info.get("chunkSize"))
 
 
 @pytest.mark.redismod
@@ -172,12 +193,15 @@ def test_create_and_delete_rule(client):
     client.ts().add(1, time * 2, 1.5)
     assert round(client.ts().get(2)[1], 5) == 1.5
     info = client.ts().info(1)
-    assert info.rules[0][1] == 100
+    if is_resp2_connection(client):
+        assert info.rules[0][1] == 100
+    else:
+        assert info["rules"]["2"][0] == 100
 
     # test rule deletion
     client.ts().deleterule(1, 2)
     info = client.ts().info(1)
-    assert not info.rules
+    assert not info["rules"]
 
 
 @pytest.mark.redismod
@@ -192,7 +216,7 @@ def test_del_range(client):
         client.ts().add(1, i, i % 7)
     assert 22 == client.ts().delete(1, 0, 21)
     assert [] == client.ts().range(1, 0, 21)
-    assert [(22, 1.0)] == client.ts().range(1, 22, 22)
+    assert_resp_response(client, client.ts().range(1, 22, 22), [(22, 1.0)], [[22, 1.0]])
 
 
 @pytest.mark.redismod
@@ -227,15 +251,16 @@ def test_range_advanced(client):
             filter_by_max_value=2,
         )
     )
-    assert [(0, 10.0), (10, 1.0)] == client.ts().range(
+    res = client.ts().range(
         1, 0, 10, aggregation_type="count", bucket_size_msec=10, align="+"
     )
-    assert [(0, 5.0), (5, 6.0)] == client.ts().range(
+    assert_resp_response(client, res, [(0, 10.0), (10, 1.0)], [[0, 10.0], [10, 1.0]])
+    res = client.ts().range(
         1, 0, 10, aggregation_type="count", bucket_size_msec=10, align=5
     )
-    assert [(0, 2.55), (10, 3.0)] == client.ts().range(
-        1, 0, 10, aggregation_type="twa", bucket_size_msec=10
-    )
+    assert_resp_response(client, res, [(0, 5.0), (5, 6.0)], [[0, 5.0], [5, 6.0]])
+    res = client.ts().range(1, 0, 10, aggregation_type="twa", bucket_size_msec=10)
+    assert_resp_response(client, res, [(0, 2.55), (10, 3.0)], [[0, 2.55], [10, 3.0]])
 
 
 @pytest.mark.redismod
@@ -249,14 +274,18 @@ def test_range_latest(client: redis.Redis):
     timeseries.add("t1", 2, 3)
     timeseries.add("t1", 11, 7)
     timeseries.add("t1", 13, 1)
-    res = timeseries.range("t1", 0, 20)
-    assert res == [(1, 1.0), (2, 3.0), (11, 7.0), (13, 1.0)]
-    res = timeseries.range("t2", 0, 10)
-    assert res == [(0, 4.0)]
+    assert_resp_response(
+        client,
+        timeseries.range("t1", 0, 20),
+        [(1, 1.0), (2, 3.0), (11, 7.0), (13, 1.0)],
+        [[1, 1.0], [2, 3.0], [11, 7.0], [13, 1.0]],
+    )
+    assert_resp_response(client, timeseries.range("t2", 0, 10), [(0, 4.0)], [[0, 4.0]])
     res = timeseries.range("t2", 0, 10, latest=True)
-    assert res == [(0, 4.0), (10, 8.0)]
-    res = timeseries.range("t2", 0, 9, latest=True)
-    assert res == [(0, 4.0)]
+    assert_resp_response(client, res, [(0, 4.0), (10, 8.0)], [[0, 4.0], [10, 8.0]])
+    assert_resp_response(
+        client, timeseries.range("t2", 0, 9, latest=True), [(0, 4.0)], [[0, 4.0]]
+    )
 
 
 @pytest.mark.redismod
@@ -269,17 +298,27 @@ def test_range_bucket_timestamp(client: redis.Redis):
     timeseries.add("t1", 51, 3)
     timeseries.add("t1", 73, 5)
     timeseries.add("t1", 75, 3)
-    assert [(10, 4.0), (50, 3.0), (70, 5.0)] == timeseries.range(
-        "t1", 0, 100, align=0, aggregation_type="max", bucket_size_msec=10
-    )
-    assert [(20, 4.0), (60, 3.0), (80, 5.0)] == timeseries.range(
-        "t1",
-        0,
-        100,
-        align=0,
-        aggregation_type="max",
-        bucket_size_msec=10,
-        bucket_timestamp="+",
+    assert_resp_response(
+        client,
+        timeseries.range(
+            "t1", 0, 100, align=0, aggregation_type="max", bucket_size_msec=10
+        ),
+        [(10, 4.0), (50, 3.0), (70, 5.0)],
+        [[10, 4.0], [50, 3.0], [70, 5.0]],
+    )
+    assert_resp_response(
+        client,
+        timeseries.range(
+            "t1",
+            0,
+            100,
+            align=0,
+            aggregation_type="max",
+            bucket_size_msec=10,
+            bucket_timestamp="+",
+        ),
+        [(20, 4.0), (60, 3.0), (80, 5.0)],
+        [[20, 4.0], [60, 3.0], [80, 5.0]],
     )
 
 
@@ -293,8 +332,13 @@ def test_range_empty(client: redis.Redis):
     timeseries.add("t1", 51, 3)
     timeseries.add("t1", 73, 5)
     timeseries.add("t1", 75, 3)
-    assert [(10, 4.0), (50, 3.0), (70, 5.0)] == timeseries.range(
-        "t1", 0, 100, align=0, aggregation_type="max", bucket_size_msec=10
+    assert_resp_response(
+        client,
+        timeseries.range(
+            "t1", 0, 100, align=0, aggregation_type="max", bucket_size_msec=10
+        ),
+        [(10, 4.0), (50, 3.0), (70, 5.0)],
+        [[10, 4.0], [50, 3.0], [70, 5.0]],
     )
     res = timeseries.range(
         "t1", 0, 100, align=0, aggregation_type="max", bucket_size_msec=10, empty=True
@@ -302,7 +346,7 @@ def test_range_empty(client: redis.Redis):
     for i in range(len(res)):
         if math.isnan(res[i][1]):
             res[i] = (res[i][0], None)
-    assert [
+    resp2_expected = [
         (10, 4.0),
         (20, None),
         (30, None),
@@ -310,7 +354,17 @@ def test_range_empty(client: redis.Redis):
         (50, 3.0),
         (60, None),
         (70, 5.0),
-    ] == res
+    ]
+    resp3_expected = [
+        [10, 4.0],
+        (20, None),
+        (30, None),
+        (40, None),
+        [50, 3.0],
+        (60, None),
+        [70, 5.0],
+    ]
+    assert_resp_response(client, res, resp2_expected, resp3_expected)
 
 
 @pytest.mark.redismod
@@ -337,14 +391,27 @@ def test_rev_range(client):
             filter_by_max_value=2,
         )
     )
-    assert [(10, 1.0), (0, 10.0)] == client.ts().revrange(
-        1, 0, 10, aggregation_type="count", bucket_size_msec=10, align="+"
+    assert_resp_response(
+        client,
+        client.ts().revrange(
+            1, 0, 10, aggregation_type="count", bucket_size_msec=10, align="+"
+        ),
+        [(10, 1.0), (0, 10.0)],
+        [[10, 1.0], [0, 10.0]],
     )
-    assert [(1, 10.0), (0, 1.0)] == client.ts().revrange(
-        1, 0, 10, aggregation_type="count", bucket_size_msec=10, align=1
+    assert_resp_response(
+        client,
+        client.ts().revrange(
+            1, 0, 10, aggregation_type="count", bucket_size_msec=10, align=1
+        ),
+        [(1, 10.0), (0, 1.0)],
+        [[1, 10.0], [0, 1.0]],
     )
-    assert [(10, 3.0), (0, 2.55)] == client.ts().revrange(
-        1, 0, 10, aggregation_type="twa", bucket_size_msec=10
+    assert_resp_response(
+        client,
+        client.ts().revrange(1, 0, 10, aggregation_type="twa", bucket_size_msec=10),
+        [(10, 3.0), (0, 2.55)],
+        [[10, 3.0], [0, 2.55]],
     )
 
 
@@ -360,11 +427,11 @@ def test_revrange_latest(client: redis.Redis):
     timeseries.add("t1", 11, 7)
     timeseries.add("t1", 13, 1)
     res = timeseries.revrange("t2", 0, 10)
-    assert res == [(0, 4.0)]
+    assert_resp_response(client, res, [(0, 4.0)], [[0, 4.0]])
     res = timeseries.revrange("t2", 0, 10, latest=True)
-    assert res == [(10, 8.0), (0, 4.0)]
+    assert_resp_response(client, res, [(10, 8.0), (0, 4.0)], [[10, 8.0], [0, 4.0]])
     res = timeseries.revrange("t2", 0, 9, latest=True)
-    assert res == [(0, 4.0)]
+    assert_resp_response(client, res, [(0, 4.0)], [[0, 4.0]])
 
 
 @pytest.mark.redismod
@@ -377,17 +444,27 @@ def test_revrange_bucket_timestamp(client: redis.Redis):
     timeseries.add("t1", 51, 3)
     timeseries.add("t1", 73, 5)
     timeseries.add("t1", 75, 3)
-    assert [(70, 5.0), (50, 3.0), (10, 4.0)] == timeseries.revrange(
-        "t1", 0, 100, align=0, aggregation_type="max", bucket_size_msec=10
-    )
-    assert [(20, 4.0), (60, 3.0), (80, 5.0)] == timeseries.range(
-        "t1",
-        0,
-        100,
-        align=0,
-        aggregation_type="max",
-        bucket_size_msec=10,
-        bucket_timestamp="+",
+    assert_resp_response(
+        client,
+        timeseries.revrange(
+            "t1", 0, 100, align=0, aggregation_type="max", bucket_size_msec=10
+        ),
+        [(70, 5.0), (50, 3.0), (10, 4.0)],
+        [[70, 5.0], [50, 3.0], [10, 4.0]],
+    )
+    assert_resp_response(
+        client,
+        timeseries.range(
+            "t1",
+            0,
+            100,
+            align=0,
+            aggregation_type="max",
+            bucket_size_msec=10,
+            bucket_timestamp="+",
+        ),
+        [(20, 4.0), (60, 3.0), (80, 5.0)],
+        [[20, 4.0], [60, 3.0], [80, 5.0]],
     )
 
 
@@ -401,8 +478,13 @@ def test_revrange_empty(client: redis.Redis):
     timeseries.add("t1", 51, 3)
     timeseries.add("t1", 73, 5)
     timeseries.add("t1", 75, 3)
-    assert [(70, 5.0), (50, 3.0), (10, 4.0)] == timeseries.revrange(
-        "t1", 0, 100, align=0, aggregation_type="max", bucket_size_msec=10
+    assert_resp_response(
+        client,
+        timeseries.revrange(
+            "t1", 0, 100, align=0, aggregation_type="max", bucket_size_msec=10
+        ),
+        [(70, 5.0), (50, 3.0), (10, 4.0)],
+        [[70, 5.0], [50, 3.0], [10, 4.0]],
     )
     res = timeseries.revrange(
         "t1", 0, 100, align=0, aggregation_type="max", bucket_size_msec=10, empty=True
@@ -410,7 +492,7 @@ def test_revrange_empty(client: redis.Redis):
     for i in range(len(res)):
         if math.isnan(res[i][1]):
             res[i] = (res[i][0], None)
-    assert [
+    resp2_expected = [
         (70, 5.0),
         (60, None),
         (50, 3.0),
@@ -418,7 +500,17 @@ def test_revrange_empty(client: redis.Redis):
         (30, None),
         (20, None),
         (10, 4.0),
-    ] == res
+    ]
+    resp3_expected = [
+        [70, 5.0],
+        (60, None),
+        [50, 3.0],
+        (40, None),
+        (30, None),
+        (20, None),
+        [10, 4.0],
+    ]
+    assert_resp_response(client, res, resp2_expected, resp3_expected)
 
 
 @pytest.mark.redismod
@@ -432,23 +524,42 @@ def test_mrange(client):
 
     res = client.ts().mrange(0, 200, filters=["Test=This"])
     assert 2 == len(res)
-    assert 100 == len(res[0]["1"][1])
+    if is_resp2_connection(client):
+        assert 100 == len(res[0]["1"][1])
 
-    res = client.ts().mrange(0, 200, filters=["Test=This"], count=10)
-    assert 10 == len(res[0]["1"][1])
+        res = client.ts().mrange(0, 200, filters=["Test=This"], count=10)
+        assert 10 == len(res[0]["1"][1])
 
-    for i in range(100):
-        client.ts().add(1, i + 200, i % 7)
-    res = client.ts().mrange(
-        0, 500, filters=["Test=This"], aggregation_type="avg", bucket_size_msec=10
-    )
-    assert 2 == len(res)
-    assert 20 == len(res[0]["1"][1])
+        for i in range(100):
+            client.ts().add(1, i + 200, i % 7)
+        res = client.ts().mrange(
+            0, 500, filters=["Test=This"], aggregation_type="avg", bucket_size_msec=10
+        )
+        assert 2 == len(res)
+        assert 20 == len(res[0]["1"][1])
+
+        # test withlabels
+        assert {} == res[0]["1"][0]
+        res = client.ts().mrange(0, 200, filters=["Test=This"], with_labels=True)
+        assert {"Test": "This", "team": "ny"} == res[0]["1"][0]
+    else:
+        assert 100 == len(res["1"][2])
+
+        res = client.ts().mrange(0, 200, filters=["Test=This"], count=10)
+        assert 10 == len(res["1"][2])
+
+        for i in range(100):
+            client.ts().add(1, i + 200, i % 7)
+        res = client.ts().mrange(
+            0, 500, filters=["Test=This"], aggregation_type="avg", bucket_size_msec=10
+        )
+        assert 2 == len(res)
+        assert 20 == len(res["1"][2])
 
-    # test withlabels
-    assert {} == res[0]["1"][0]
-    res = client.ts().mrange(0, 200, filters=["Test=This"], with_labels=True)
-    assert {"Test": "This", "team": "ny"} == res[0]["1"][0]
+        # test withlabels
+        assert {} == res["1"][0]
+        res = client.ts().mrange(0, 200, filters=["Test=This"], with_labels=True)
+        assert {"Test": "This", "team": "ny"} == res["1"][0]
 
 
 @pytest.mark.redismod
@@ -463,49 +574,106 @@ def test_multi_range_advanced(client):
 
     # test with selected labels
     res = client.ts().mrange(0, 200, filters=["Test=This"], select_labels=["team"])
-    assert {"team": "ny"} == res[0]["1"][0]
-    assert {"team": "sf"} == res[1]["2"][0]
+    if is_resp2_connection(client):
+        assert {"team": "ny"} == res[0]["1"][0]
+        assert {"team": "sf"} == res[1]["2"][0]
 
-    # test with filterby
-    res = client.ts().mrange(
-        0,
-        200,
-        filters=["Test=This"],
-        filter_by_ts=[i for i in range(10, 20)],
-        filter_by_min_value=1,
-        filter_by_max_value=2,
-    )
-    assert [(15, 1.0), (16, 2.0)] == res[0]["1"][1]
+        # test with filterby
+        res = client.ts().mrange(
+            0,
+            200,
+            filters=["Test=This"],
+            filter_by_ts=[i for i in range(10, 20)],
+            filter_by_min_value=1,
+            filter_by_max_value=2,
+        )
+        assert [(15, 1.0), (16, 2.0)] == res[0]["1"][1]
 
-    # test groupby
-    res = client.ts().mrange(0, 3, filters=["Test=This"], groupby="Test", reduce="sum")
-    assert [(0, 0.0), (1, 2.0), (2, 4.0), (3, 6.0)] == res[0]["Test=This"][1]
-    res = client.ts().mrange(0, 3, filters=["Test=This"], groupby="Test", reduce="max")
-    assert [(0, 0.0), (1, 1.0), (2, 2.0), (3, 3.0)] == res[0]["Test=This"][1]
-    res = client.ts().mrange(0, 3, filters=["Test=This"], groupby="team", reduce="min")
-    assert 2 == len(res)
-    assert [(0, 0.0), (1, 1.0), (2, 2.0), (3, 3.0)] == res[0]["team=ny"][1]
-    assert [(0, 0.0), (1, 1.0), (2, 2.0), (3, 3.0)] == res[1]["team=sf"][1]
+        # test groupby
+        res = client.ts().mrange(
+            0, 3, filters=["Test=This"], groupby="Test", reduce="sum"
+        )
+        assert [(0, 0.0), (1, 2.0), (2, 4.0), (3, 6.0)] == res[0]["Test=This"][1]
+        res = client.ts().mrange(
+            0, 3, filters=["Test=This"], groupby="Test", reduce="max"
+        )
+        assert [(0, 0.0), (1, 1.0), (2, 2.0), (3, 3.0)] == res[0]["Test=This"][1]
+        res = client.ts().mrange(
+            0, 3, filters=["Test=This"], groupby="team", reduce="min"
+        )
+        assert 2 == len(res)
+        assert [(0, 0.0), (1, 1.0), (2, 2.0), (3, 3.0)] == res[0]["team=ny"][1]
+        assert [(0, 0.0), (1, 1.0), (2, 2.0), (3, 3.0)] == res[1]["team=sf"][1]
 
-    # test align
-    res = client.ts().mrange(
-        0,
-        10,
-        filters=["team=ny"],
-        aggregation_type="count",
-        bucket_size_msec=10,
-        align="-",
-    )
-    assert [(0, 10.0), (10, 1.0)] == res[0]["1"][1]
-    res = client.ts().mrange(
-        0,
-        10,
-        filters=["team=ny"],
-        aggregation_type="count",
-        bucket_size_msec=10,
-        align=5,
-    )
-    assert [(0, 5.0), (5, 6.0)] == res[0]["1"][1]
+        # test align
+        res = client.ts().mrange(
+            0,
+            10,
+            filters=["team=ny"],
+            aggregation_type="count",
+            bucket_size_msec=10,
+            align="-",
+        )
+        assert [(0, 10.0), (10, 1.0)] == res[0]["1"][1]
+        res = client.ts().mrange(
+            0,
+            10,
+            filters=["team=ny"],
+            aggregation_type="count",
+            bucket_size_msec=10,
+            align=5,
+        )
+        assert [(0, 5.0), (5, 6.0)] == res[0]["1"][1]
+    else:
+        assert {"team": "ny"} == res["1"][0]
+        assert {"team": "sf"} == res["2"][0]
+
+        # test with filterby
+        res = client.ts().mrange(
+            0,
+            200,
+            filters=["Test=This"],
+            filter_by_ts=[i for i in range(10, 20)],
+            filter_by_min_value=1,
+            filter_by_max_value=2,
+        )
+        assert [[15, 1.0], [16, 2.0]] == res["1"][2]
+
+        # test groupby
+        res = client.ts().mrange(
+            0, 3, filters=["Test=This"], groupby="Test", reduce="sum"
+        )
+        assert [[0, 0.0], [1, 2.0], [2, 4.0], [3, 6.0]] == res["Test=This"][3]
+        res = client.ts().mrange(
+            0, 3, filters=["Test=This"], groupby="Test", reduce="max"
+        )
+        assert [[0, 0.0], [1, 1.0], [2, 2.0], [3, 3.0]] == res["Test=This"][3]
+        res = client.ts().mrange(
+            0, 3, filters=["Test=This"], groupby="team", reduce="min"
+        )
+        assert 2 == len(res)
+        assert [[0, 0.0], [1, 1.0], [2, 2.0], [3, 3.0]] == res["team=ny"][3]
+        assert [[0, 0.0], [1, 1.0], [2, 2.0], [3, 3.0]] == res["team=sf"][3]
+
+        # test align
+        res = client.ts().mrange(
+            0,
+            10,
+            filters=["team=ny"],
+            aggregation_type="count",
+            bucket_size_msec=10,
+            align="-",
+        )
+        assert [[0, 10.0], [10, 1.0]] == res["1"][2]
+        res = client.ts().mrange(
+            0,
+            10,
+            filters=["team=ny"],
+            aggregation_type="count",
+            bucket_size_msec=10,
+            align=5,
+        )
+        assert [[0, 5.0], [5, 6.0]] == res["1"][2]
 
 
 @pytest.mark.redismod
@@ -527,10 +695,15 @@ def test_mrange_latest(client: redis.Redis):
     timeseries.add("t3", 2, 3)
     timeseries.add("t3", 11, 7)
     timeseries.add("t3", 13, 1)
-    assert client.ts().mrange(0, 10, filters=["is_compaction=true"], latest=True) == [
-        {"t2": [{}, [(0, 4.0), (10, 8.0)]]},
-        {"t4": [{}, [(0, 4.0), (10, 8.0)]]},
-    ]
+    assert_resp_response(
+        client,
+        client.ts().mrange(0, 10, filters=["is_compaction=true"], latest=True),
+        [{"t2": [{}, [(0, 4.0), (10, 8.0)]]}, {"t4": [{}, [(0, 4.0), (10, 8.0)]]}],
+        {
+            "t2": [{}, {"aggregators": []}, [[0, 4.0], [10, 8.0]]],
+            "t4": [{}, {"aggregators": []}, [[0, 4.0], [10, 8.0]]],
+        },
+    )
 
 
 @pytest.mark.redismod
@@ -545,10 +718,16 @@ def test_multi_reverse_range(client):
 
     res = client.ts().mrange(0, 200, filters=["Test=This"])
     assert 2 == len(res)
-    assert 100 == len(res[0]["1"][1])
+    if is_resp2_connection(client):
+        assert 100 == len(res[0]["1"][1])
+    else:
+        assert 100 == len(res["1"][2])
 
     res = client.ts().mrange(0, 200, filters=["Test=This"], count=10)
-    assert 10 == len(res[0]["1"][1])
+    if is_resp2_connection(client):
+        assert 10 == len(res[0]["1"][1])
+    else:
+        assert 10 == len(res["1"][2])
 
     for i in range(100):
         client.ts().add(1, i + 200, i % 7)
@@ -556,17 +735,28 @@ def test_multi_reverse_range(client):
         0, 500, filters=["Test=This"], aggregation_type="avg", bucket_size_msec=10
     )
     assert 2 == len(res)
-    assert 20 == len(res[0]["1"][1])
-    assert {} == res[0]["1"][0]
+    if is_resp2_connection(client):
+        assert 20 == len(res[0]["1"][1])
+        assert {} == res[0]["1"][0]
+    else:
+        assert 20 == len(res["1"][2])
+        assert {} == res["1"][0]
 
     # test withlabels
     res = client.ts().mrevrange(0, 200, filters=["Test=This"], with_labels=True)
-    assert {"Test": "This", "team": "ny"} == res[0]["1"][0]
+    if is_resp2_connection(client):
+        assert {"Test": "This", "team": "ny"} == res[0]["1"][0]
+    else:
+        assert {"Test": "This", "team": "ny"} == res["1"][0]
 
     # test with selected labels
     res = client.ts().mrevrange(0, 200, filters=["Test=This"], select_labels=["team"])
-    assert {"team": "ny"} == res[0]["1"][0]
-    assert {"team": "sf"} == res[1]["2"][0]
+    if is_resp2_connection(client):
+        assert {"team": "ny"} == res[0]["1"][0]
+        assert {"team": "sf"} == res[1]["2"][0]
+    else:
+        assert {"team": "ny"} == res["1"][0]
+        assert {"team": "sf"} == res["2"][0]
 
     # test filterby
     res = client.ts().mrevrange(
@@ -577,23 +767,36 @@ def test_multi_reverse_range(client):
         filter_by_min_value=1,
         filter_by_max_value=2,
     )
-    assert [(16, 2.0), (15, 1.0)] == res[0]["1"][1]
+    if is_resp2_connection(client):
+        assert [(16, 2.0), (15, 1.0)] == res[0]["1"][1]
+    else:
+        assert [[16, 2.0], [15, 1.0]] == res["1"][2]
 
     # test groupby
     res = client.ts().mrevrange(
         0, 3, filters=["Test=This"], groupby="Test", reduce="sum"
     )
-    assert [(3, 6.0), (2, 4.0), (1, 2.0), (0, 0.0)] == res[0]["Test=This"][1]
+    if is_resp2_connection(client):
+        assert [(3, 6.0), (2, 4.0), (1, 2.0), (0, 0.0)] == res[0]["Test=This"][1]
+    else:
+        assert [[3, 6.0], [2, 4.0], [1, 2.0], [0, 0.0]] == res["Test=This"][3]
     res = client.ts().mrevrange(
         0, 3, filters=["Test=This"], groupby="Test", reduce="max"
     )
-    assert [(3, 3.0), (2, 2.0), (1, 1.0), (0, 0.0)] == res[0]["Test=This"][1]
+    if is_resp2_connection(client):
+        assert [(3, 3.0), (2, 2.0), (1, 1.0), (0, 0.0)] == res[0]["Test=This"][1]
+    else:
+        assert [[3, 3.0], [2, 2.0], [1, 1.0], [0, 0.0]] == res["Test=This"][3]
     res = client.ts().mrevrange(
         0, 3, filters=["Test=This"], groupby="team", reduce="min"
     )
     assert 2 == len(res)
-    assert [(3, 3.0), (2, 2.0), (1, 1.0), (0, 0.0)] == res[0]["team=ny"][1]
-    assert [(3, 3.0), (2, 2.0), (1, 1.0), (0, 0.0)] == res[1]["team=sf"][1]
+    if is_resp2_connection(client):
+        assert [(3, 3.0), (2, 2.0), (1, 1.0), (0, 0.0)] == res[0]["team=ny"][1]
+        assert [(3, 3.0), (2, 2.0), (1, 1.0), (0, 0.0)] == res[1]["team=sf"][1]
+    else:
+        assert [[3, 3.0], [2, 2.0], [1, 1.0], [0, 0.0]] == res["team=ny"][3]
+        assert [[3, 3.0], [2, 2.0], [1, 1.0], [0, 0.0]] == res["team=sf"][3]
 
     # test align
     res = client.ts().mrevrange(
@@ -604,7 +807,10 @@ def test_multi_reverse_range(client):
         bucket_size_msec=10,
         align="-",
     )
-    assert [(10, 1.0), (0, 10.0)] == res[0]["1"][1]
+    if is_resp2_connection(client):
+        assert [(10, 1.0), (0, 10.0)] == res[0]["1"][1]
+    else:
+        assert [[10, 1.0], [0, 10.0]] == res["1"][2]
     res = client.ts().mrevrange(
         0,
         10,
@@ -613,7 +819,10 @@ def test_multi_reverse_range(client):
         bucket_size_msec=10,
         align=1,
     )
-    assert [(1, 10.0), (0, 1.0)] == res[0]["1"][1]
+    if is_resp2_connection(client):
+        assert [(1, 10.0), (0, 1.0)] == res[0]["1"][1]
+    else:
+        assert [[1, 10.0], [0, 1.0]] == res["1"][2]
 
 
 @pytest.mark.redismod
@@ -635,16 +844,22 @@ def test_mrevrange_latest(client: redis.Redis):
     timeseries.add("t3", 2, 3)
     timeseries.add("t3", 11, 7)
     timeseries.add("t3", 13, 1)
-    assert client.ts().mrevrange(
-        0, 10, filters=["is_compaction=true"], latest=True
-    ) == [{"t2": [{}, [(10, 8.0), (0, 4.0)]]}, {"t4": [{}, [(10, 8.0), (0, 4.0)]]}]
+    assert_resp_response(
+        client,
+        client.ts().mrevrange(0, 10, filters=["is_compaction=true"], latest=True),
+        [{"t2": [{}, [(10, 8.0), (0, 4.0)]]}, {"t4": [{}, [(10, 8.0), (0, 4.0)]]}],
+        {
+            "t2": [{}, {"aggregators": []}, [[10, 8.0], [0, 4.0]]],
+            "t4": [{}, {"aggregators": []}, [[10, 8.0], [0, 4.0]]],
+        },
+    )
 
 
 @pytest.mark.redismod
 def test_get(client):
     name = "test"
     client.ts().create(name)
-    assert client.ts().get(name) is None
+    assert not client.ts().get(name)
     client.ts().add(name, 2, 3)
     assert 2 == client.ts().get(name)[0]
     client.ts().add(name, 3, 4)
@@ -662,8 +877,10 @@ def test_get_latest(client: redis.Redis):
     timeseries.add("t1", 2, 3)
     timeseries.add("t1", 11, 7)
     timeseries.add("t1", 13, 1)
-    assert (0, 4.0) == timeseries.get("t2")
-    assert (10, 8.0) == timeseries.get("t2", latest=True)
+    assert_resp_response(client, timeseries.get("t2"), (0, 4.0), [0, 4.0])
+    assert_resp_response(
+        client, timeseries.get("t2", latest=True), (10, 8.0), [10, 8.0]
+    )
 
 
 @pytest.mark.redismod
@@ -673,19 +890,33 @@ def test_mget(client):
     client.ts().create(2, labels={"Test": "This", "Taste": "That"})
     act_res = client.ts().mget(["Test=This"])
     exp_res = [{"1": [{}, None, None]}, {"2": [{}, None, None]}]
-    assert act_res == exp_res
+    exp_res_resp3 = {"1": [{}, []], "2": [{}, []]}
+    assert_resp_response(client, act_res, exp_res, exp_res_resp3)
     client.ts().add(1, "*", 15)
     client.ts().add(2, "*", 25)
     res = client.ts().mget(["Test=This"])
-    assert 15 == res[0]["1"][2]
-    assert 25 == res[1]["2"][2]
+    if is_resp2_connection(client):
+        assert 15 == res[0]["1"][2]
+        assert 25 == res[1]["2"][2]
+    else:
+        assert 15 == res["1"][1][1]
+        assert 25 == res["2"][1][1]
     res = client.ts().mget(["Taste=That"])
-    assert 25 == res[0]["2"][2]
+    if is_resp2_connection(client):
+        assert 25 == res[0]["2"][2]
+    else:
+        assert 25 == res["2"][1][1]
 
     # test with_labels
-    assert {} == res[0]["2"][0]
+    if is_resp2_connection(client):
+        assert {} == res[0]["2"][0]
+    else:
+        assert {} == res["2"][0]
     res = client.ts().mget(["Taste=That"], with_labels=True)
-    assert {"Taste": "That", "Test": "This"} == res[0]["2"][0]
+    if is_resp2_connection(client):
+        assert {"Taste": "That", "Test": "This"} == res[0]["2"][0]
+    else:
+        assert {"Taste": "That", "Test": "This"} == res["2"][0]
 
 
 @pytest.mark.redismod
@@ -700,18 +931,20 @@ def test_mget_latest(client: redis.Redis):
     timeseries.add("t1", 2, 3)
     timeseries.add("t1", 11, 7)
     timeseries.add("t1", 13, 1)
-    assert timeseries.mget(filters=["is_compaction=true"]) == [{"t2": [{}, 0, 4.0]}]
-    assert [{"t2": [{}, 10, 8.0]}] == timeseries.mget(
-        filters=["is_compaction=true"], latest=True
-    )
+    res = timeseries.mget(filters=["is_compaction=true"])
+    assert_resp_response(client, res, [{"t2": [{}, 0, 4.0]}], {"t2": [{}, [0, 4.0]]})
+    res = timeseries.mget(filters=["is_compaction=true"], latest=True)
+    assert_resp_response(client, res, [{"t2": [{}, 10, 8.0]}], {"t2": [{}, [10, 8.0]]})
 
 
 @pytest.mark.redismod
 def test_info(client):
     client.ts().create(1, retention_msecs=5, labels={"currentLabel": "currentData"})
     info = client.ts().info(1)
-    assert 5 == info.retention_msecs
-    assert info.labels["currentLabel"] == "currentData"
+    assert_resp_response(
+        client, 5, info.get("retention_msecs"), info.get("retentionTime")
+    )
+    assert info["labels"]["currentLabel"] == "currentData"
 
 
 @pytest.mark.redismod
@@ -719,11 +952,15 @@ def test_info(client):
 def testInfoDuplicatePolicy(client):
     client.ts().create(1, retention_msecs=5, labels={"currentLabel": "currentData"})
     info = client.ts().info(1)
-    assert info.duplicate_policy is None
+    assert_resp_response(
+        client, None, info.get("duplicate_policy"), info.get("duplicatePolicy")
+    )
 
     client.ts().create("time-serie-2", duplicate_policy="min")
     info = client.ts().info("time-serie-2")
-    assert "min" == info.duplicate_policy
+    assert_resp_response(
+        client, "min", info.get("duplicate_policy"), info.get("duplicatePolicy")
+    )
 
 
 @pytest.mark.redismod
@@ -733,7 +970,7 @@ def test_query_index(client):
     client.ts().create(2, labels={"Test": "This", "Taste": "That"})
     assert 2 == len(client.ts().queryindex(["Test=This"]))
     assert 1 == len(client.ts().queryindex(["Taste=That"]))
-    assert [2] == client.ts().queryindex(["Taste=That"])
+    assert_resp_response(client, client.ts().queryindex(["Taste=That"]), [2], {"2"})
 
 
 @pytest.mark.redismod
@@ -745,8 +982,12 @@ def test_pipeline(client):
     pipeline.execute()
 
     info = client.ts().info("with_pipeline")
-    assert info.last_timestamp == 99
-    assert info.total_samples == 100
+    assert_resp_response(
+        client, 99, info.get("last_timestamp"), info.get("lastTimestamp")
+    )
+    assert_resp_response(
+        client, 100, info.get("total_samples"), info.get("totalSamples")
+    )
     assert client.ts().get("with_pipeline")[1] == 99 * 1.1
 
 
@@ -756,4 +997,7 @@ def test_uncompressed(client):
     client.ts().create("uncompressed", uncompressed=True)
     compressed_info = client.ts().info("compressed")
     uncompressed_info = client.ts().info("uncompressed")
-    assert compressed_info.memory_usage != uncompressed_info.memory_usage
+    if is_resp2_connection(client):
+        assert compressed_info.memory_usage != uncompressed_info.memory_usage
+    else:
+        assert compressed_info["memoryUsage"] != uncompressed_info["memoryUsage"]
diff --git a/tox.ini b/tox.ini
deleted file mode 100644
index 553c77b3c6..0000000000
--- a/tox.ini
+++ /dev/null
@@ -1,379 +0,0 @@
-[pytest]
-addopts = -s
-markers =
-    redismod: run only the redis module tests
-    pipeline: pipeline tests
-    onlycluster: marks tests to be run only with cluster mode redis
-    onlynoncluster: marks tests to be run only with standalone redis
-    ssl: marker for only the ssl tests
-    asyncio: marker for async tests
-    replica: replica tests
-    experimental: run only experimental tests
-asyncio_mode = auto
-
-[tox]
-minversion = 3.2.0
-requires = tox-docker
-envlist = {standalone,cluster}-{plain,hiredis,ocsp}-{uvloop,asyncio}-{py37,py38,py39,pypy3},linters,docs
-
-[docker:master]
-name = master
-image = redisfab/redis-py:6.2.6
-ports =
-    6379:6379/tcp
-healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',6379)) else False"
-volumes =
-    bind:rw:{toxinidir}/docker/redis6.2/master/redis.conf:/redis.conf
-
-[docker:replica]
-name = replica
-image = redisfab/redis-py:6.2.6
-links =
-    master:master
-ports =
-    6380:6380/tcp
-healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',6380)) else False"
-volumes =
-    bind:rw:{toxinidir}/docker/redis6.2/replica/redis.conf:/redis.conf
-
-[docker:unstable]
-name = unstable
-image = redisfab/redis-py:unstable
-ports =
-    6378:6378/tcp
-healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',6378)) else False"
-volumes =
-    bind:rw:{toxinidir}/docker/unstable/redis.conf:/redis.conf
-
-[docker:unstable_cluster]
-name = unstable_cluster
-image = redisfab/redis-py-cluster:unstable
-ports =
-    6372:6372/tcp
-    6373:6373/tcp
-    6374:6374/tcp
-    6375:6375/tcp
-    6376:6376/tcp
-    6377:6377/tcp
-healtcheck_cmd = python -c "import socket;print(True) if all([0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',port)) for port in range(6372,6377)]) else False"
-volumes =
-    bind:rw:{toxinidir}/docker/unstable_cluster/redis.conf:/redis.conf
-
-[docker:sentinel_1]
-name = sentinel_1
-image = redisfab/redis-py-sentinel:6.2.6
-links =
-    master:master
-ports =
-    26379:26379/tcp
-healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26379)) else False"
-volumes =
-    bind:rw:{toxinidir}/docker/redis6.2/sentinel/sentinel_1.conf:/sentinel.conf
-
-[docker:sentinel_2]
-name = sentinel_2
-image = redisfab/redis-py-sentinel:6.2.6
-links =
-    master:master
-ports =
-    26380:26380/tcp
-healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26380)) else False"
-volumes =
-    bind:rw:{toxinidir}/docker/redis6.2/sentinel/sentinel_2.conf:/sentinel.conf
-
-[docker:sentinel_3]
-name = sentinel_3
-image = redisfab/redis-py-sentinel:6.2.6
-links =
-    master:master
-ports =
-    26381:26381/tcp
-healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26381)) else False"
-volumes =
-    bind:rw:{toxinidir}/docker/redis6.2/sentinel/sentinel_3.conf:/sentinel.conf
-
-[docker:redis_stack]
-name = redis_stack
-image = redis/redis-stack-server:edge
-ports =
-    36379:6379/tcp
-healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',36379)) else False"
-
-[docker:redis_cluster]
-name = redis_cluster
-image = redisfab/redis-py-cluster:6.2.6
-ports =
-    16379:16379/tcp
-    16380:16380/tcp
-    16381:16381/tcp
-    16382:16382/tcp
-    16383:16383/tcp
-    16384:16384/tcp
-healtcheck_cmd = python -c "import socket;print(True) if all([0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',port)) for port in range(16379,16384)]) else False"
-volumes =
-    bind:rw:{toxinidir}/docker/cluster/redis.conf:/redis.conf
-
-[docker:redismod_cluster]
-name = redismod_cluster
-image = redisfab/redis-py-modcluster:edge
-ports =
-    46379:46379/tcp
-    46380:46380/tcp
-    46381:46381/tcp
-    46382:46382/tcp
-    46383:46383/tcp
-    46384:46384/tcp
-healtcheck_cmd = python -c "import socket;print(True) if all([0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',port)) for port in range(46379,46384)]) else False"
-volumes =
-    bind:rw:{toxinidir}/docker/redismod_cluster/redis.conf:/redis.conf
-
-[docker:stunnel]
-name = stunnel
-image = redisfab/stunnel:latest
-healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',6666)) else False"
-links =
-    master:master
-ports =
-    6666:6666/tcp
-volumes =
-    bind:ro:{toxinidir}/docker/stunnel/conf:/etc/stunnel/conf.d
-    bind:ro:{toxinidir}/docker/stunnel/keys:/etc/stunnel/keys
-
-[docker:redis5_master]
-name = redis5_master
-image = redisfab/redis-py:5.0-buster
-ports =
-    6382:6382/tcp
-healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',6382)) else False"
-volumes =
-    bind:rw:{toxinidir}/docker/redis5/master/redis.conf:/redis.conf
-
-[docker:redis5_replica]
-name = redis5_replica
-image = redisfab/redis-py:5.0-buster
-links =
-    redis5_master:redis5_master
-ports =
-    6383:6383/tcp
-healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',6383)) else False"
-volumes =
-    bind:rw:{toxinidir}/docker/redis5/replica/redis.conf:/redis.conf
-
-[docker:redis5_sentinel_1]
-name = redis5_sentinel_1
-image = redisfab/redis-py-sentinel:5.0-buster
-links =
-    redis5_master:redis5_master
-ports =
-    26382:26382/tcp
-healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26382)) else False"
-volumes =
-    bind:rw:{toxinidir}/docker/redis5/sentinel/sentinel_1.conf:/sentinel.conf
-
-[docker:redis5_sentinel_2]
-name = redis5_sentinel_2
-image = redisfab/redis-py-sentinel:5.0-buster
-links =
-    redis5_master:redis5_master
-ports =
-    26383:26383/tcp
-healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26383)) else False"
-volumes =
-    bind:rw:{toxinidir}/docker/redis5/sentinel/sentinel_2.conf:/sentinel.conf
-
-[docker:redis5_sentinel_3]
-name = redis5_sentinel_3
-image = redisfab/redis-py-sentinel:5.0-buster
-links =
-    redis5_master:redis5_master
-ports =
-    26384:26384/tcp
-healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26384)) else False"
-volumes =
-    bind:rw:{toxinidir}/docker/redis5/sentinel/sentinel_3.conf:/sentinel.conf
-
-[docker:redis5_cluster]
-name = redis5_cluster
-image = redisfab/redis-py-cluster:5.0-buster
-ports =
-    16385:16385/tcp
-    16386:16386/tcp
-    16387:16387/tcp
-    16388:16388/tcp
-    16389:16389/tcp
-    16390:16390/tcp
-healtcheck_cmd = python -c "import socket;print(True) if all([0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',port)) for port in range(16385,16390)]) else False"
-volumes =
-    bind:rw:{toxinidir}/docker/cluster/redis.conf:/redis.conf
-
-[docker:redis4_master]
-name = redis4_master
-image = redisfab/redis-py:4.0-buster
-ports =
-    6381:6381/tcp
-healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',6381)) else False"
-volumes =
-    bind:rw:{toxinidir}/docker/redis4/master/redis.conf:/redis.conf
-
-[docker:redis4_sentinel_1]
-name = redis4_sentinel_1
-image = redisfab/redis-py-sentinel:4.0-buster
-links =
-    redis4_master:redis4_master
-ports =
-    26385:26385/tcp
-healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26385)) else False"
-volumes =
-    bind:rw:{toxinidir}/docker/redis4/sentinel/sentinel_1.conf:/sentinel.conf
-
-[docker:redis4_sentinel_2]
-name = redis4_sentinel_2
-image = redisfab/redis-py-sentinel:4.0-buster
-links =
-    redis4_master:redis4_master
-ports =
-    26386:26386/tcp
-healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26386)) else False"
-volumes =
-    bind:rw:{toxinidir}/docker/redis4/sentinel/sentinel_2.conf:/sentinel.conf
-
-[docker:redis4_sentinel_3]
-name = redis4_sentinel_3
-image = redisfab/redis-py-sentinel:4.0-buster
-links =
-    redis4_master:redis4_master
-ports =
-    26387:26387/tcp
-healtcheck_cmd = python -c "import socket;print(True) if 0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',26387)) else False"
-volumes =
-    bind:rw:{toxinidir}/docker/redis4/sentinel/sentinel_3.conf:/sentinel.conf
-
-[docker:redis4_cluster]
-name = redis4_cluster
-image = redisfab/redis-py-cluster:4.0-buster
-ports =
-    16391:16391/tcp
-    16392:16392/tcp
-    16393:16393/tcp
-    16394:16394/tcp
-    16395:16395/tcp
-    16396:16396/tcp
-healtcheck_cmd = python -c "import socket;print(True) if all([0 == socket.socket(socket.AF_INET, socket.SOCK_STREAM).connect_ex(('127.0.0.1',port)) for port in range(16391,16396)]) else False"
-volumes =
-    bind:rw:{toxinidir}/docker/cluster/redis.conf:/redis.conf
-
-[isort]
-profile = black
-multi_line_output = 3
-
-[testenv]
-deps =
-    -r {toxinidir}/requirements.txt
-    -r {toxinidir}/dev_requirements.txt
-docker =
-    unstable
-    unstable_cluster
-    master
-    replica
-    sentinel_1
-    sentinel_2
-    sentinel_3
-    redis_cluster
-    redis_stack
-    stunnel
-extras =
-    hiredis: hiredis
-    ocsp: cryptography, pyopenssl, requests
-setenv =
-    CLUSTER_URL = "redis://localhost:16379/0"
-    UNSTABLE_CLUSTER_URL = "redis://localhost:6372/0"
-commands =
-    standalone: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' --junit-xml=standalone-results.xml {posargs}
-    standalone-uvloop: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' --junit-xml=standalone-uvloop-results.xml --uvloop {posargs}
-    cluster: pytest --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={env:CLUSTER_URL:} --redis-unstable-url={env:UNSTABLE_CLUSTER_URL:} --junit-xml=cluster-results.xml {posargs}
-    cluster-uvloop: pytest --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={env:CLUSTER_URL:} --redis-unstable-url={env:UNSTABLE_CLUSTER_URL:} --junit-xml=cluster-uvloop-results.xml --uvloop {posargs}
-
-[testenv:redis5]
-deps =
-    -r {toxinidir}/requirements.txt
-    -r {toxinidir}/dev_requirements.txt
-docker =
-    redis5_master
-    redis5_replica
-    redis5_sentinel_1
-    redis5_sentinel_2
-    redis5_sentinel_3
-    redis5_cluster
-extras =
-    hiredis: hiredis
-    cryptography: cryptography, requests
-setenv =
-    CLUSTER_URL = "redis://localhost:16385/0"
-commands =
-    standalone: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster and not redismod' {posargs}
-    cluster: pytest --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={env:CLUSTER_URL:} {posargs}
-
-[testenv:redis4]
-deps =
-    -r {toxinidir}/requirements.txt
-    -r {toxinidir}/dev_requirements.txt
-docker =
-    redis4_master
-    redis4_sentinel_1
-    redis4_sentinel_2
-    redis4_sentinel_3
-    redis4_cluster
-extras =
-    hiredis: hiredis
-    cryptography: cryptography, requests
-setenv =
-    CLUSTER_URL = "redis://localhost:16391/0"
-commands =
-    standalone: pytest --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster and not redismod' {posargs}
-    cluster: pytest --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={env:CLUSTER_URL:} {posargs}
-
-[testenv:devenv]
-skipsdist = true
-skip_install = true
-deps = -r {toxinidir}/dev_requirements.txt
-docker = {[testenv]docker}
-
-[testenv:linters]
-deps_files = dev_requirements.txt
-docker =
-commands =
-    flake8
-    black --target-version py37 --check --diff .
-    isort --check-only --diff .
-    vulture redis whitelist.py --min-confidence 80
-    flynt --fail-on-change --dry-run .
-skipsdist = true
-skip_install = true
-
-[testenv:docs]
-deps = -r docs/requirements.txt
-docker =
-changedir = {toxinidir}/docs
-allowlist_externals = make
-commands = make html
-
-[flake8]
-max-line-length = 88
-exclude =
-    *.egg-info,
-    *.pyc,
-    .git,
-    .tox,
-    .venv*,
-    build,
-    docs/*,
-    dist,
-    docker,
-    venv*,
-    .venv*,
-    whitelist.py
-ignore =
-    F405
-    W503
-    E203
-    E126
diff --git a/whitelist.py b/whitelist.py
index 8c9cee3c29..29cd529e4d 100644
--- a/whitelist.py
+++ b/whitelist.py
@@ -14,6 +14,5 @@
 exc_value  # unused variable (/data/repos/redis/redis-py/redis/asyncio/utils.py:26)
 traceback  # unused variable (/data/repos/redis/redis-py/redis/asyncio/utils.py:26)
 AsyncConnectionPool  # unused import (//data/repos/redis/redis-py/redis/typing.py:9)
-AsyncEncoder  # unused import (//data/repos/redis/redis-py/redis/typing.py:10)
 AsyncRedis  # unused import (//data/repos/redis/redis-py/redis/commands/core.py:49)
 TargetNodesT  # unused import (//data/repos/redis/redis-py/redis/commands/cluster.py:46)

From 2c2860dd30d2598b20c84e30d5580126ed46986b Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 26 Jul 2023 11:59:53 +0300
Subject: [PATCH 0746/1164] Change cluster docker to edge and enable debug
 command (#2853)

* debug in cluster docker, replace for master

* sleep time for cluster to settle...

* fix test_cluster_delslotsrange

* fix tests

---------

Co-authored-by: dvora-h <dvora.heller@redis.com>
---
 .github/workflows/integration.yaml |   2 +-
 dockers/Dockerfile.cluster         |   2 +-
 dockers/cluster.redis.conf         |   1 +
 redis/_parsers/commands.py         | 171 +++++++++++++++++------------
 redis/_parsers/helpers.py          |   1 +
 redis/cluster.py                   |   2 +
 tests/test_asyncio/test_cluster.py |  41 ++++---
 tests/test_cluster.py              |  39 +++++--
 tests/test_function.py             |  23 +++-
 9 files changed, 177 insertions(+), 105 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 1bab506c32..c4dd30812b 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -78,7 +78,7 @@ jobs:
             pip install hiredis
            fi
            invoke devenv
-           sleep 5 # time to settle
+           sleep 10 # time to settle
            invoke ${{matrix.test-type}}-tests
 
        - uses: actions/upload-artifact@v2
diff --git a/dockers/Dockerfile.cluster b/dockers/Dockerfile.cluster
index 204232a665..3a0d73415e 100644
--- a/dockers/Dockerfile.cluster
+++ b/dockers/Dockerfile.cluster
@@ -1,4 +1,4 @@
-FROM redis/redis-stack-server:latest as rss
+FROM redis/redis-stack-server:edge as rss
 
 COPY dockers/create_cluster.sh /create_cluster.sh
 RUN ls -R /opt/redis-stack
diff --git a/dockers/cluster.redis.conf b/dockers/cluster.redis.conf
index 26da33567a..cd5c08b7b8 100644
--- a/dockers/cluster.redis.conf
+++ b/dockers/cluster.redis.conf
@@ -1,4 +1,5 @@
 protected-mode no
+enable-debug-command yes
 loadmodule /opt/redis-stack/lib/redisearch.so
 loadmodule /opt/redis-stack/lib/redisgraph.so
 loadmodule /opt/redis-stack/lib/redistimeseries.so
diff --git a/redis/_parsers/commands.py b/redis/_parsers/commands.py
index d3b4a99ed3..b5109252ae 100644
--- a/redis/_parsers/commands.py
+++ b/redis/_parsers/commands.py
@@ -7,7 +7,53 @@
     from redis.asyncio.cluster import ClusterNode
 
 
-class CommandsParser:
+class AbstractCommandsParser:
+    def _get_pubsub_keys(self, *args):
+        """
+        Get the keys from pubsub command.
+        Although PubSub commands have predetermined key locations, they are not
+        supported in the 'COMMAND's output, so the key positions are hardcoded
+        in this method
+        """
+        if len(args) < 2:
+            # The command has no keys in it
+            return None
+        args = [str_if_bytes(arg) for arg in args]
+        command = args[0].upper()
+        keys = None
+        if command == "PUBSUB":
+            # the second argument is a part of the command name, e.g.
+            # ['PUBSUB', 'NUMSUB', 'foo'].
+            pubsub_type = args[1].upper()
+            if pubsub_type in ["CHANNELS", "NUMSUB", "SHARDCHANNELS", "SHARDNUMSUB"]:
+                keys = args[2:]
+        elif command in ["SUBSCRIBE", "PSUBSCRIBE", "UNSUBSCRIBE", "PUNSUBSCRIBE"]:
+            # format example:
+            # SUBSCRIBE channel [channel ...]
+            keys = list(args[1:])
+        elif command in ["PUBLISH", "SPUBLISH"]:
+            # format example:
+            # PUBLISH channel message
+            keys = [args[1]]
+        return keys
+
+    def parse_subcommand(self, command, **options):
+        cmd_dict = {}
+        cmd_name = str_if_bytes(command[0])
+        cmd_dict["name"] = cmd_name
+        cmd_dict["arity"] = int(command[1])
+        cmd_dict["flags"] = [str_if_bytes(flag) for flag in command[2]]
+        cmd_dict["first_key_pos"] = command[3]
+        cmd_dict["last_key_pos"] = command[4]
+        cmd_dict["step_count"] = command[5]
+        if len(command) > 7:
+            cmd_dict["tips"] = command[7]
+            cmd_dict["key_specifications"] = command[8]
+            cmd_dict["subcommands"] = command[9]
+        return cmd_dict
+
+
+class CommandsParser(AbstractCommandsParser):
     """
     Parses Redis commands to get command keys.
     COMMAND output is used to determine key locations.
@@ -30,21 +76,6 @@ def initialize(self, r):
             commands[cmd.lower()] = commands.pop(cmd)
         self.commands = commands
 
-    def parse_subcommand(self, command, **options):
-        cmd_dict = {}
-        cmd_name = str_if_bytes(command[0])
-        cmd_dict["name"] = cmd_name
-        cmd_dict["arity"] = int(command[1])
-        cmd_dict["flags"] = [str_if_bytes(flag) for flag in command[2]]
-        cmd_dict["first_key_pos"] = command[3]
-        cmd_dict["last_key_pos"] = command[4]
-        cmd_dict["step_count"] = command[5]
-        if len(command) > 7:
-            cmd_dict["tips"] = command[7]
-            cmd_dict["key_specifications"] = command[8]
-            cmd_dict["subcommands"] = command[9]
-        return cmd_dict
-
     # As soon as this PR is merged into Redis, we should reimplement
     # our logic to use COMMAND INFO changes to determine the key positions
     # https://github.com/redis/redis/pull/8324
@@ -138,37 +169,8 @@ def _get_moveable_keys(self, redis_conn, *args):
                 raise e
         return keys
 
-    def _get_pubsub_keys(self, *args):
-        """
-        Get the keys from pubsub command.
-        Although PubSub commands have predetermined key locations, they are not
-        supported in the 'COMMAND's output, so the key positions are hardcoded
-        in this method
-        """
-        if len(args) < 2:
-            # The command has no keys in it
-            return None
-        args = [str_if_bytes(arg) for arg in args]
-        command = args[0].upper()
-        keys = None
-        if command == "PUBSUB":
-            # the second argument is a part of the command name, e.g.
-            # ['PUBSUB', 'NUMSUB', 'foo'].
-            pubsub_type = args[1].upper()
-            if pubsub_type in ["CHANNELS", "NUMSUB", "SHARDCHANNELS", "SHARDNUMSUB"]:
-                keys = args[2:]
-        elif command in ["SUBSCRIBE", "PSUBSCRIBE", "UNSUBSCRIBE", "PUNSUBSCRIBE"]:
-            # format example:
-            # SUBSCRIBE channel [channel ...]
-            keys = list(args[1:])
-        elif command in ["PUBLISH", "SPUBLISH"]:
-            # format example:
-            # PUBLISH channel message
-            keys = [args[1]]
-        return keys
 
-
-class AsyncCommandsParser:
+class AsyncCommandsParser(AbstractCommandsParser):
     """
     Parses Redis commands to get command keys.
 
@@ -194,52 +196,75 @@ async def initialize(self, node: Optional["ClusterNode"] = None) -> None:
             self.node = node
 
         commands = await self.node.execute_command("COMMAND")
-        for cmd, command in commands.items():
-            if "movablekeys" in command["flags"]:
-                commands[cmd] = -1
-            elif command["first_key_pos"] == 0 and command["last_key_pos"] == 0:
-                commands[cmd] = 0
-            elif command["first_key_pos"] == 1 and command["last_key_pos"] == 1:
-                commands[cmd] = 1
-        self.commands = {cmd.upper(): command for cmd, command in commands.items()}
+        self.commands = {cmd.lower(): command for cmd, command in commands.items()}
 
     # As soon as this PR is merged into Redis, we should reimplement
     # our logic to use COMMAND INFO changes to determine the key positions
     # https://github.com/redis/redis/pull/8324
     async def get_keys(self, *args: Any) -> Optional[Tuple[str, ...]]:
+        """
+        Get the keys from the passed command.
+
+        NOTE: Due to a bug in redis<7.0, this function does not work properly
+        for EVAL or EVALSHA when the `numkeys` arg is 0.
+         - issue: https://github.com/redis/redis/issues/9493
+         - fix: https://github.com/redis/redis/pull/9733
+
+        So, don't use this function with EVAL or EVALSHA.
+        """
         if len(args) < 2:
             # The command has no keys in it
             return None
 
-        try:
-            command = self.commands[args[0]]
-        except KeyError:
-            # try to split the command name and to take only the main command
+        cmd_name = args[0].lower()
+        if cmd_name not in self.commands:
+            # try to split the command name and to take only the main command,
             # e.g. 'memory' for 'memory usage'
-            args = args[0].split() + list(args[1:])
-            cmd_name = args[0].upper()
-            if cmd_name not in self.commands:
+            cmd_name_split = cmd_name.split()
+            cmd_name = cmd_name_split[0]
+            if cmd_name in self.commands:
+                # save the splitted command to args
+                args = cmd_name_split + list(args[1:])
+            else:
                 # We'll try to reinitialize the commands cache, if the engine
                 # version has changed, the commands may not be current
                 await self.initialize()
                 if cmd_name not in self.commands:
                     raise RedisError(
-                        f"{cmd_name} command doesn't exist in Redis commands"
+                        f"{cmd_name.upper()} command doesn't exist in Redis commands"
                     )
 
-            command = self.commands[cmd_name]
+        command = self.commands.get(cmd_name)
+        if "movablekeys" in command["flags"]:
+            keys = await self._get_moveable_keys(*args)
+        elif "pubsub" in command["flags"] or command["name"] == "pubsub":
+            keys = self._get_pubsub_keys(*args)
+        else:
+            if (
+                command["step_count"] == 0
+                and command["first_key_pos"] == 0
+                and command["last_key_pos"] == 0
+            ):
+                is_subcmd = False
+                if "subcommands" in command:
+                    subcmd_name = f"{cmd_name}|{args[1].lower()}"
+                    for subcmd in command["subcommands"]:
+                        if str_if_bytes(subcmd[0]) == subcmd_name:
+                            command = self.parse_subcommand(subcmd)
+                            is_subcmd = True
 
-        if command == 1:
-            return (args[1],)
-        if command == 0:
-            return None
-        if command == -1:
-            return await self._get_moveable_keys(*args)
+                # The command doesn't have keys in it
+                if not is_subcmd:
+                    return None
+            last_key_pos = command["last_key_pos"]
+            if last_key_pos < 0:
+                last_key_pos = len(args) - abs(last_key_pos)
+            keys_pos = list(
+                range(command["first_key_pos"], last_key_pos + 1, command["step_count"])
+            )
+            keys = [args[pos] for pos in keys_pos]
 
-        last_key_pos = command["last_key_pos"]
-        if last_key_pos < 0:
-            last_key_pos = len(args) + last_key_pos
-        return args[command["first_key_pos"] : last_key_pos + 1 : command["step_count"]]
+        return keys
 
     async def _get_moveable_keys(self, *args: Any) -> Optional[Tuple[str, ...]]:
         try:
diff --git a/redis/_parsers/helpers.py b/redis/_parsers/helpers.py
index f27e3b12c0..ab4ede1fd0 100644
--- a/redis/_parsers/helpers.py
+++ b/redis/_parsers/helpers.py
@@ -733,6 +733,7 @@ def string_keys_to_dict(key_string, callback):
     "MODULE UNLOAD": bool,
     "PING": lambda r: str_if_bytes(r) == "PONG",
     "PUBSUB NUMSUB": parse_pubsub_numsub,
+    "PUBSUB SHARDNUMSUB": parse_pubsub_numsub,
     "QUIT": bool_ok,
     "SET": parse_set_result,
     "SCAN": parse_scan,
diff --git a/redis/cluster.py b/redis/cluster.py
index c179511b0c..3549ced35d 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -101,6 +101,8 @@ def parse_cluster_shards(resp, **options):
     """
     Parse CLUSTER SHARDS response.
     """
+    if isinstance(resp[0], dict):
+        return resp
     shards = []
     for x in resp:
         shard = {"slots": [], "nodes": []}
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index ee498e71f7..eb7aafdf68 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -30,7 +30,9 @@
 from redis.utils import str_if_bytes
 from tests.conftest import (
     assert_resp_response,
+    is_resp2_connection,
     skip_if_redis_enterprise,
+    skip_if_server_version_gte,
     skip_if_server_version_lt,
     skip_unless_arch_bits,
 )
@@ -157,7 +159,7 @@ async def execute_command(*_args, **_kwargs):
 
             def cmd_init_mock(self, r: ClusterNode) -> None:
                 self.commands = {
-                    "GET": {
+                    "get": {
                         "name": "get",
                         "arity": 2,
                         "flags": ["readonly", "fast"],
@@ -607,7 +609,7 @@ def map_7007(self):
 
                         def cmd_init_mock(self, r: ClusterNode) -> None:
                             self.commands = {
-                                "GET": {
+                                "get": {
                                     "name": "get",
                                     "arity": 2,
                                     "flags": ["readonly", "fast"],
@@ -818,6 +820,8 @@ async def test_not_require_full_coverage_cluster_down_error(
             assert all(await r.cluster_delslots(missing_slot))
             with pytest.raises(ClusterDownError):
                 await r.exists("foo")
+        except ResponseError as e:
+            assert "CLUSTERDOWN" in str(e)
         finally:
             try:
                 # Add back the missing slot
@@ -1065,11 +1069,14 @@ async def test_cluster_delslots(self) -> None:
 
     @skip_if_server_version_lt("7.0.0")
     @skip_if_redis_enterprise()
-    async def test_cluster_delslotsrange(self, r: RedisCluster):
+    async def test_cluster_delslotsrange(self):
+        r = await get_mocked_redis_client(host=default_host, port=default_port)
+        mock_all_nodes_resp(r, "OK")
         node = r.get_random_node()
-        mock_node_resp(node, "OK")
         await r.cluster_addslots(node, 1, 2, 3, 4, 5)
         assert await r.cluster_delslotsrange(1, 5)
+        assert node._free.pop().read_response.called
+        await r.close()
 
     @skip_if_redis_enterprise()
     async def test_cluster_failover(self, r: RedisCluster) -> None:
@@ -1255,11 +1262,18 @@ async def test_cluster_replicas(self, r: RedisCluster) -> None:
     async def test_cluster_links(self, r: RedisCluster):
         node = r.get_random_node()
         res = await r.cluster_links(node)
-        links_to = sum(x.count("to") for x in res)
-        links_for = sum(x.count("from") for x in res)
-        assert links_to == links_for
-        for i in range(0, len(res) - 1, 2):
-            assert res[i][3] == res[i + 1][3]
+        if is_resp2_connection(r):
+            links_to = sum(x.count(b"to") for x in res)
+            links_for = sum(x.count(b"from") for x in res)
+            assert links_to == links_for
+            for i in range(0, len(res) - 1, 2):
+                assert res[i][3] == res[i + 1][3]
+        else:
+            links_to = len(list(filter(lambda x: x[b"direction"] == b"to", res)))
+            links_for = len(list(filter(lambda x: x[b"direction"] == b"from", res)))
+            assert links_to == links_for
+            for i in range(0, len(res) - 1, 2):
+                assert res[i][b"node"] == res[i + 1][b"node"]
 
     @skip_if_redis_enterprise()
     async def test_readonly(self) -> None:
@@ -1896,25 +1910,25 @@ async def test_cluster_bzpopmin(self, r: RedisCluster) -> None:
             r,
             await r.bzpopmin(["{foo}b", "{foo}a"], timeout=1),
             (b"{foo}b", b"b1", 10),
-            [b"b", b"b1", 10],
+            [b"{foo}b", b"b1", 10],
         )
         assert_resp_response(
             r,
             await r.bzpopmin(["{foo}b", "{foo}a"], timeout=1),
             (b"{foo}b", b"b2", 20),
-            [b"b", b"b2", 20],
+            [b"{foo}b", b"b2", 20],
         )
         assert_resp_response(
             r,
             await r.bzpopmin(["{foo}b", "{foo}a"], timeout=1),
             (b"{foo}a", b"a1", 1),
-            [b"a", b"a1", 1],
+            [b"{foo}a", b"a1", 1],
         )
         assert_resp_response(
             r,
             await r.bzpopmin(["{foo}b", "{foo}a"], timeout=1),
             (b"{foo}a", b"a2", 2),
-            [b"a", b"a2", 2],
+            [b"{foo}a", b"a2", 2],
         )
         assert await r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) is None
         await r.zadd("{foo}c", {"c1": 100})
@@ -2744,6 +2758,7 @@ async def test_asking_error(self, r: RedisCluster) -> None:
             assert ask_node._free.pop().read_response.await_count
             assert res == ["MOCK_OK"]
 
+    @skip_if_server_version_gte("7.0.0")
     async def test_moved_redirection_on_slave_with_default(
         self, r: RedisCluster
     ) -> None:
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 31c31026be..84654e70c3 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -43,6 +43,7 @@
 from .conftest import (
     _get_client,
     assert_resp_response,
+    is_resp2_connection,
     skip_if_redis_enterprise,
     skip_if_server_version_lt,
     skip_unless_arch_bits,
@@ -775,6 +776,8 @@ def test_not_require_full_coverage_cluster_down_error(self, r):
             assert all(r.cluster_delslots(missing_slot))
             with pytest.raises(ClusterDownError):
                 r.exists("foo")
+        except ResponseError as e:
+            assert "CLUSTERDOWN" in str(e)
         finally:
             try:
                 # Add back the missing slot
@@ -1157,8 +1160,15 @@ def test_cluster_shards(self, r):
             b"health",
         ]
         for x in cluster_shards:
-            assert list(x.keys()) == ["slots", "nodes"]
-            for node in x["nodes"]:
+            assert_resp_response(
+                r, list(x.keys()), ["slots", "nodes"], [b"slots", b"nodes"]
+            )
+            try:
+                x["nodes"]
+                key = "nodes"
+            except KeyError:
+                key = b"nodes"
+            for node in x[key]:
                 for attribute in node.keys():
                     assert attribute in attributes
 
@@ -1415,11 +1425,18 @@ def test_cluster_replicas(self, r):
     def test_cluster_links(self, r):
         node = r.get_random_node()
         res = r.cluster_links(node)
-        links_to = sum(x.count("to") for x in res)
-        links_for = sum(x.count("from") for x in res)
-        assert links_to == links_for
-        for i in range(0, len(res) - 1, 2):
-            assert res[i][3] == res[i + 1][3]
+        if is_resp2_connection(r):
+            links_to = sum(x.count(b"to") for x in res)
+            links_for = sum(x.count(b"from") for x in res)
+            assert links_to == links_for
+            for i in range(0, len(res) - 1, 2):
+                assert res[i][3] == res[i + 1][3]
+        else:
+            links_to = len(list(filter(lambda x: x[b"direction"] == b"to", res)))
+            links_for = len(list(filter(lambda x: x[b"direction"] == b"from", res)))
+            assert links_to == links_for
+            for i in range(0, len(res) - 1, 2):
+                assert res[i][b"node"] == res[i + 1][b"node"]
 
     def test_cluster_flshslots_not_implemented(self, r):
         with pytest.raises(NotImplementedError):
@@ -2041,25 +2058,25 @@ def test_cluster_bzpopmin(self, r):
             r,
             r.bzpopmin(["{foo}b", "{foo}a"], timeout=1),
             (b"{foo}b", b"b1", 10),
-            [b"b", b"b1", 10],
+            [b"{foo}b", b"b1", 10],
         )
         assert_resp_response(
             r,
             r.bzpopmin(["{foo}b", "{foo}a"], timeout=1),
             (b"{foo}b", b"b2", 20),
-            [b"b", b"b2", 20],
+            [b"{foo}b", b"b2", 20],
         )
         assert_resp_response(
             r,
             r.bzpopmin(["{foo}b", "{foo}a"], timeout=1),
             (b"{foo}a", b"a1", 1),
-            [b"a", b"a1", 1],
+            [b"{foo}a", b"a1", 1],
         )
         assert_resp_response(
             r,
             r.bzpopmin(["{foo}b", "{foo}a"], timeout=1),
             (b"{foo}a", b"a2", 2),
-            [b"a", b"a2", 2],
+            [b"{foo}a", b"a2", 2],
         )
         assert r.bzpopmin(["{foo}b", "{foo}a"], timeout=1) is None
         r.zadd("{foo}c", {"c1": 100})
diff --git a/tests/test_function.py b/tests/test_function.py
index 22db904273..9d6712ecf7 100644
--- a/tests/test_function.py
+++ b/tests/test_function.py
@@ -93,17 +93,28 @@ def test_function_list_on_cluster(self, r):
                 [[b"name", b"myfunc", b"description", None, b"flags", [b"no-writes"]]],
             ]
         ]
+        resp3_function_list = [
+            {
+                b"library_name": b"mylib",
+                b"engine": b"LUA",
+                b"functions": [
+                    {b"name": b"myfunc", b"description": None, b"flags": {b"no-writes"}}
+                ],
+            }
+        ]
         primaries = r.get_primaries()
         res = {}
+        resp3_res = {}
         for node in primaries:
             res[node.name] = function_list
-        assert r.function_list() == res
-        assert r.function_list(library="*lib") == res
+            resp3_res[node.name] = resp3_function_list
+        assert_resp_response(r, r.function_list(), res, resp3_res)
+        assert_resp_response(r, r.function_list(library="*lib"), res, resp3_res)
         node = primaries[0].name
-        assert (
-            r.function_list(withcode=True)[node][0][7]
-            == f"#!{engine} name={lib} \n {function}".encode()
-        )
+        code = f"#!{engine} name={lib} \n {function}".encode()
+        res[node][0].extend([b"library_code", code])
+        resp3_res[node][0][b"library_code"] = code
+        assert_resp_response(r, r.function_list(withcode=True), res, resp3_res)
 
     def test_fcall(self, r):
         r.function_load(f"#!{engine} name={lib} \n {set_function}")

From 8e5d5cea5e1c2b16121fdbfb7337cf1b7634af56 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Mon, 31 Jul 2023 06:51:29 +0000
Subject: [PATCH 0747/1164] Fix socket garbage collection (#2859)

---
 CHANGES                               |  1 +
 redis/asyncio/client.py               | 13 ++++++---
 tests/test_asyncio/test_connection.py | 38 ++++++++++++++++++++++++++-
 tests/test_connect.py                 | 35 ++++++++++++++----------
 4 files changed, 69 insertions(+), 18 deletions(-)

diff --git a/CHANGES b/CHANGES
index 49f87cd35d..363f2b927d 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Fix #2831, add auto_close_connection_pool=True arg to asyncio.Redis.from_url()
     * Fix incorrect redis.asyncio.Cluster type hint for `retry_on_error`
     * Fix dead weakref in sentinel connection causing ReferenceError (#2767)
     * Fix #2768, Fix KeyError: 'first-entry' in parse_xinfo_stream.
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 111df24185..31e27a4462 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -104,7 +104,13 @@ class Redis(
     response_callbacks: MutableMapping[Union[str, bytes], ResponseCallbackT]
 
     @classmethod
-    def from_url(cls, url: str, **kwargs):
+    def from_url(
+        cls,
+        url: str,
+        single_connection_client: bool = False,
+        auto_close_connection_pool: bool = True,
+        **kwargs,
+    ):
         """
         Return a Redis client object configured from the given URL
 
@@ -144,12 +150,13 @@ class initializer. In the case of conflicting arguments, querystring
         arguments always win.
 
         """
-        single_connection_client = kwargs.pop("single_connection_client", False)
         connection_pool = ConnectionPool.from_url(url, **kwargs)
-        return cls(
+        redis = cls(
             connection_pool=connection_pool,
             single_connection_client=single_connection_client,
         )
+        redis.auto_close_connection_pool = auto_close_connection_pool
+        return redis
 
     def __init__(
         self,
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index 09960fd7e2..9a729392b8 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -12,7 +12,7 @@
     _AsyncRESPBase,
 )
 from redis.asyncio import Redis
-from redis.asyncio.connection import Connection, UnixDomainSocketConnection
+from redis.asyncio.connection import Connection, UnixDomainSocketConnection, parse_url
 from redis.asyncio.retry import Retry
 from redis.backoff import NoBackoff
 from redis.exceptions import ConnectionError, InvalidResponse, TimeoutError
@@ -278,3 +278,39 @@ async def open_connection(*args, **kwargs):
 def test_create_single_connection_client_from_url():
     client = Redis.from_url("redis://localhost:6379/0?", single_connection_client=True)
     assert client.single_connection_client is True
+
+
+@pytest.mark.parametrize("from_url", (True, False))
+async def test_pool_auto_close(request, from_url):
+    """Verify that basic Redis instances have auto_close_connection_pool set to True"""
+
+    url: str = request.config.getoption("--redis-url")
+    url_args = parse_url(url)
+
+    async def get_redis_connection():
+        if from_url:
+            return Redis.from_url(url)
+        return Redis(**url_args)
+
+    r1 = await get_redis_connection()
+    assert r1.auto_close_connection_pool is True
+    await r1.close()
+
+
+@pytest.mark.parametrize("from_url", (True, False))
+async def test_pool_auto_close_disable(request, from_url):
+    """Verify that auto_close_connection_pool can be disabled"""
+
+    url: str = request.config.getoption("--redis-url")
+    url_args = parse_url(url)
+
+    async def get_redis_connection():
+        if from_url:
+            return Redis.from_url(url, auto_close_connection_pool=False)
+        url_args["auto_close_connection_pool"] = False
+        return Redis(**url_args)
+
+    r1 = await get_redis_connection()
+    assert r1.auto_close_connection_pool is False
+    await r1.connection_pool.disconnect()
+    await r1.close()
diff --git a/tests/test_connect.py b/tests/test_connect.py
index b233c67e83..f07750dc80 100644
--- a/tests/test_connect.py
+++ b/tests/test_connect.py
@@ -61,6 +61,8 @@ def test_tcp_ssl_connect(tcp_address):
 
 def _assert_connect(conn, server_address, certfile=None, keyfile=None):
     if isinstance(server_address, str):
+        if not _RedisUDSServer:
+            pytest.skip("Unix domain sockets are not supported on this platform")
         server = _RedisUDSServer(server_address, _RedisRequestHandler)
     else:
         server = _RedisTCPServer(
@@ -113,24 +115,29 @@ def get_request(self):
         return connstream, fromaddr
 
 
-class _RedisUDSServer(socketserver.UnixStreamServer):
-    def __init__(self, *args, **kw) -> None:
-        self._ready_event = threading.Event()
-        self._stop_requested = False
-        super().__init__(*args, **kw)
+if hasattr(socket, "UnixStreamServer"):
 
-    def service_actions(self):
-        self._ready_event.set()
+    class _RedisUDSServer(socketserver.UnixStreamServer):
+        def __init__(self, *args, **kw) -> None:
+            self._ready_event = threading.Event()
+            self._stop_requested = False
+            super().__init__(*args, **kw)
 
-    def wait_online(self):
-        self._ready_event.wait()
+        def service_actions(self):
+            self._ready_event.set()
 
-    def stop(self):
-        self._stop_requested = True
-        self.shutdown()
+        def wait_online(self):
+            self._ready_event.wait()
 
-    def is_serving(self):
-        return not self._stop_requested
+        def stop(self):
+            self._stop_requested = True
+            self.shutdown()
+
+        def is_serving(self):
+            return not self._stop_requested
+
+else:
+    _RedisUDSServer = None
 
 
 class _RedisRequestHandler(socketserver.StreamRequestHandler):

From 471f860a63688b950096bd796ce6ff645e817f36 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 2 Aug 2023 14:02:21 +0300
Subject: [PATCH 0748/1164] Fixing doc builds (#2869)

---
 .github/workflows/docs.yaml              | 47 ++++++++++++
 docs/conf.py                             |  4 +-
 docs/examples/redis-stream-example.ipynb |  2 +-
 docs/requirements.txt                    |  1 +
 redis/asyncio/client.py                  |  9 ++-
 redis/asyncio/connection.py              |  9 ++-
 redis/commands/core.py                   | 95 +++++++++++++++++-------
 tasks.py                                 |  2 +-
 8 files changed, 133 insertions(+), 36 deletions(-)
 create mode 100644 .github/workflows/docs.yaml

diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml
new file mode 100644
index 0000000000..61ec76e9f8
--- /dev/null
+++ b/.github/workflows/docs.yaml
@@ -0,0 +1,47 @@
+name: Docs CI
+
+on:
+  push:
+    branches:
+      - master
+      - '[0-9].[0-9]'
+  pull_request:
+    branches:
+      - master
+      - '[0-9].[0-9]'
+  schedule:
+    - cron: '0 1 * * *' # nightly build
+
+concurrency:
+  group: ${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read  #  to fetch code (actions/checkout)
+
+jobs:
+
+   build-docs:
+     name: Build docs
+     runs-on: ubuntu-latest
+     steps:
+       - uses: actions/checkout@v3
+       - uses: actions/setup-python@v4
+         with:
+           python-version: 3.9
+           cache: 'pip'
+       - name: install deps
+         run: |
+           sudo apt-get update -yqq
+           sudo apt-get install -yqq pandoc make
+       - name: run code linters
+         run: |
+           pip install -r requirements.txt -r dev_requirements.txt -r docs/requirements.txt
+           invoke build-docs
+
+       - name: upload docs
+         uses: actions/upload-artifact@v3
+         with:
+           name: redis-py-docs
+           path: |
+             docs/_build/html
diff --git a/docs/conf.py b/docs/conf.py
index cdbeb02c9a..8849752404 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -60,7 +60,7 @@
 
 # General information about the project.
 project = "redis-py"
-copyright = "2022, Redis Inc"
+copyright = "2023, Redis Inc"
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
@@ -287,4 +287,4 @@
 epub_title = "redis-py"
 epub_author = "Redis Inc"
 epub_publisher = "Redis Inc"
-epub_copyright = "2022, Redis Inc"
+epub_copyright = "2023, Redis Inc"
diff --git a/docs/examples/redis-stream-example.ipynb b/docs/examples/redis-stream-example.ipynb
index 9303b527ca..a84bf19cb6 100644
--- a/docs/examples/redis-stream-example.ipynb
+++ b/docs/examples/redis-stream-example.ipynb
@@ -313,7 +313,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# stream groups\n",
+    "# Stream groups\n",
     "With the groups is possible track, for many consumers, and at the Redis side, which message have been already consumed.\n",
     "## add some data to streams\n",
     "Creating 2 streams with 10 messages each."
diff --git a/docs/requirements.txt b/docs/requirements.txt
index edecdffe4b..5b15c09268 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -5,3 +5,4 @@ sphinx_gallery
 ipython
 sphinx-autodoc-typehints
 furo
+pandoc
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 31e27a4462..0e3c879278 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -134,10 +134,13 @@ def from_url(
 
         There are several ways to specify a database number. The first value
         found will be used:
-            1. A ``db`` querystring option, e.g. redis://localhost?db=0
-            2. If using the redis:// or rediss:// schemes, the path argument
+
+        1. A ``db`` querystring option, e.g. redis://localhost?db=0
+
+        2. If using the redis:// or rediss:// schemes, the path argument
                of the url, e.g. redis://localhost/0
-            3. A ``db`` keyword argument to this function.
+
+        3. A ``db`` keyword argument to this function.
 
         If none of these options are specified, the default db=0 is used.
 
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 22c5030e6c..d501989c83 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -948,10 +948,13 @@ def from_url(cls: Type[_CP], url: str, **kwargs) -> _CP:
 
         There are several ways to specify a database number. The first value
         found will be used:
-            1. A ``db`` querystring option, e.g. redis://localhost?db=0
-            2. If using the redis:// or rediss:// schemes, the path argument
+
+        1. A ``db`` querystring option, e.g. redis://localhost?db=0
+
+        2. If using the redis:// or rediss:// schemes, the path argument
                of the url, e.g. redis://localhost/0
-            3. A ``db`` keyword argument to this function.
+
+        3. A ``db`` keyword argument to this function.
 
         If none of these options are specified, the default db=0 is used.
 
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 6abcd5a2ec..8b1b711df9 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -517,6 +517,7 @@ def client_list(
         """
         Returns a list of currently connected clients.
         If type of client specified, only that type will be returned.
+
         :param _type: optional. one of the client types (normal, master,
          replica, pubsub)
         :param client_id: optional. a list of client ids
@@ -559,16 +560,17 @@ def client_reply(
     ) -> ResponseT:
         """
         Enable and disable redis server replies.
+
         ``reply`` Must be ON OFF or SKIP,
-            ON - The default most with server replies to commands
-            OFF - Disable server responses to commands
-            SKIP - Skip the response of the immediately following command.
+        ON - The default most with server replies to commands
+        OFF - Disable server responses to commands
+        SKIP - Skip the response of the immediately following command.
 
         Note: When setting OFF or SKIP replies, you will need a client object
         with a timeout specified in seconds, and will need to catch the
         TimeoutError.
-              The test_client_reply unit test illustrates this, and
-              conftest.py has a client with a timeout.
+        The test_client_reply unit test illustrates this, and
+        conftest.py has a client with a timeout.
 
         See https://redis.io/commands/client-reply
         """
@@ -724,19 +726,21 @@ def client_unblock(
 
     def client_pause(self, timeout: int, all: bool = True, **kwargs) -> ResponseT:
         """
-        Suspend all the Redis clients for the specified amount of time
-        :param timeout: milliseconds to pause clients
+        Suspend all the Redis clients for the specified amount of time.
+
 
         For more information see https://redis.io/commands/client-pause
+
+        :param timeout: milliseconds to pause clients
         :param all: If true (default) all client commands are blocked.
-             otherwise, clients are only blocked if they attempt to execute
-             a write command.
-             For the WRITE mode, some commands have special behavior:
-                 EVAL/EVALSHA: Will block client for all scripts.
-                 PUBLISH: Will block client.
-                 PFCOUNT: Will block client.
-                 WAIT: Acknowledgments will be delayed, so this command will
-                 appear blocked.
+        otherwise, clients are only blocked if they attempt to execute
+        a write command.
+        For the WRITE mode, some commands have special behavior:
+        EVAL/EVALSHA: Will block client for all scripts.
+        PUBLISH: Will block client.
+        PFCOUNT: Will block client.
+        WAIT: Acknowledgments will be delayed, so this command will
+        appear blocked.
         """
         args = ["CLIENT PAUSE", str(timeout)]
         if not isinstance(timeout, int):
@@ -1215,9 +1219,11 @@ def quit(self, **kwargs) -> ResponseT:
     def replicaof(self, *args, **kwargs) -> ResponseT:
         """
         Update the replication settings of a redis replica, on the fly.
+
         Examples of valid arguments include:
-            NO ONE (set no replication)
-            host port (set to the host and port of a redis server)
+
+        NO ONE (set no replication)
+        host port (set to the host and port of a redis server)
 
         For more information see  https://redis.io/commands/replicaof
         """
@@ -3603,27 +3609,37 @@ def xclaim(
     ) -> ResponseT:
         """
         Changes the ownership of a pending message.
+
         name: name of the stream.
+
         groupname: name of the consumer group.
+
         consumername: name of a consumer that claims the message.
+
         min_idle_time: filter messages that were idle less than this amount of
         milliseconds
+
         message_ids: non-empty list or tuple of message IDs to claim
+
         idle: optional. Set the idle time (last time it was delivered) of the
-         message in ms
+        message in ms
+
         time: optional integer. This is the same as idle but instead of a
-         relative amount of milliseconds, it sets the idle time to a specific
-         Unix time (in milliseconds).
+        relative amount of milliseconds, it sets the idle time to a specific
+        Unix time (in milliseconds).
+
         retrycount: optional integer. set the retry counter to the specified
-         value. This counter is incremented every time a message is delivered
-         again.
+        value. This counter is incremented every time a message is delivered
+        again.
+
         force: optional boolean, false by default. Creates the pending message
-         entry in the PEL even if certain specified IDs are not already in the
-         PEL assigned to a different client.
+        entry in the PEL even if certain specified IDs are not already in the
+        PEL assigned to a different client.
+
         justid: optional boolean, false by default. Return just an array of IDs
-         of messages successfully claimed, without returning the actual message
+        of messages successfully claimed, without returning the actual message
 
-         For more information see https://redis.io/commands/xclaim
+        For more information see https://redis.io/commands/xclaim
         """
         if not isinstance(min_idle_time, int) or min_idle_time < 0:
             raise DataError("XCLAIM min_idle_time must be a non negative integer")
@@ -3875,11 +3891,15 @@ def xrange(
     ) -> ResponseT:
         """
         Read stream values within an interval.
+
         name: name of the stream.
+
         start: first stream ID. defaults to '-',
                meaning the earliest available.
+
         finish: last stream ID. defaults to '+',
                 meaning the latest available.
+
         count: if set, only return this many items, beginning with the
                earliest available.
 
@@ -3902,10 +3922,13 @@ def xread(
     ) -> ResponseT:
         """
         Block and monitor multiple streams for new data.
+
         streams: a dict of stream names to stream IDs, where
                    IDs indicate the last ID already seen.
+
         count: if set, only return this many items, beginning with the
                earliest available.
+
         block: number of milliseconds to wait, if nothing already present.
 
         For more information see https://redis.io/commands/xread
@@ -3940,12 +3963,17 @@ def xreadgroup(
     ) -> ResponseT:
         """
         Read from a stream via a consumer group.
+
         groupname: name of the consumer group.
+
         consumername: name of the requesting consumer.
+
         streams: a dict of stream names to stream IDs, where
                IDs indicate the last ID already seen.
+
         count: if set, only return this many items, beginning with the
                earliest available.
+
         block: number of milliseconds to wait, if nothing already present.
         noack: do not add messages to the PEL
 
@@ -3980,11 +4008,15 @@ def xrevrange(
     ) -> ResponseT:
         """
         Read stream values within an interval, in reverse order.
+
         name: name of the stream
+
         start: first stream ID. defaults to '+',
                meaning the latest available.
+
         finish: last stream ID. defaults to '-',
                 meaning the earliest available.
+
         count: if set, only return this many items, beginning with the
                latest available.
 
@@ -5301,8 +5333,10 @@ def script_flush(
         self, sync_type: Union[Literal["SYNC"], Literal["ASYNC"]] = None
     ) -> ResponseT:
         """Flush all scripts from the script cache.
+
         ``sync_type`` is by default SYNC (synchronous) but it can also be
                       ASYNC.
+
         For more information see  https://redis.io/commands/script-flush
         """
 
@@ -5615,11 +5649,14 @@ def geosearch(
         area specified by a given shape. This command extends the
         GEORADIUS command, so in addition to searching within circular
         areas, it supports searching within rectangular areas.
+
         This command should be used in place of the deprecated
         GEORADIUS and GEORADIUSBYMEMBER commands.
+
         ``member`` Use the position of the given existing
          member in the sorted set. Can't be given with ``longitude``
          and ``latitude``.
+
         ``longitude`` and ``latitude`` Use the position given by
         this coordinates. Can't be given with ``member``
         ``radius`` Similar to GEORADIUS, search inside circular
@@ -5628,17 +5665,23 @@ def geosearch(
         ``height`` and ``width`` Search inside an axis-aligned
         rectangle, determined by the given height and width.
         Can't be given with ``radius``
+
         ``unit`` must be one of the following : m, km, mi, ft.
         `m` for meters (the default value), `km` for kilometers,
         `mi` for miles and `ft` for feet.
+
         ``sort`` indicates to return the places in a sorted way,
         ASC for nearest to furthest and DESC for furthest to nearest.
+
         ``count`` limit the results to the first count matching items.
+
         ``any`` is set to True, the command will return as soon as
         enough matches are found. Can't be provided without ``count``
+
         ``withdist`` indicates to return the distances of each place.
         ``withcoord`` indicates to return the latitude and longitude of
         each place.
+
         ``withhash`` indicates to return the geohash string of each place.
 
         For more information see https://redis.io/commands/geosearch
diff --git a/tasks.py b/tasks.py
index 5162566183..c60fa2791e 100644
--- a/tasks.py
+++ b/tasks.py
@@ -21,7 +21,7 @@ def devenv(c):
 def build_docs(c):
     """Generates the sphinx documentation."""
     run("pip install -r docs/requirements.txt")
-    run("make html")
+    run("make -C docs html")
 
 
 @task

From a49e65682c17d338ba4343154bc5e4b23e58068f Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 2 Aug 2023 14:03:30 +0300
Subject: [PATCH 0749/1164] RESP3 connection examples (#2863)

---
 README.md                               |  12 +-
 docs/examples/asyncio_examples.ipynb    | 210 ++++++++++++++++--------
 docs/examples/connection_examples.ipynb |  65 ++++++--
 3 files changed, 203 insertions(+), 84 deletions(-)

diff --git a/README.md b/README.md
index e97119a888..e4e0debe03 100644
--- a/README.md
+++ b/README.md
@@ -45,7 +45,8 @@ The table below higlights version compatibility of the most-recent library versi
 | Library version | Supported redis versions |
 |-----------------|-------------------|
 | 3.5.3 | <= 6.2 Family of releases |
-| >= 4.1.0 | Version 5.0 to current |
+| >= 4.5.0 | Version 5.0 to 7.0 |
+| >= 5.0.0 | Versiond 5.0 to current |
 
 
 ## Usage
@@ -63,6 +64,15 @@ b'bar'
 
 The above code connects to localhost on port 6379, sets a value in Redis, and retrieves it. All responses are returned as bytes in Python, to receive decoded strings, set *decode_responses=True*.  For this, and more connection options, see [these examples](https://redis.readthedocs.io/en/stable/examples.html).
 
+
+#### RESP3 Support
+To enable support for RESP3, ensure you have at least version 5.0 of the client, and change your connection object to include *protocol=3*
+
+``` python
+>>> import redis
+>>> r = redis.Redis(host='localhost', port=6379, db=0, protocol=3)
+```
+
 ### Connection Pools
 
 By default, redis-py uses a connection pool to manage connections. Each instance of a Redis class receives its own connection pool. You can however define your own [redis.ConnectionPool](https://redis.readthedocs.io/en/stable/connections.html#connection-pools).
diff --git a/docs/examples/asyncio_examples.ipynb b/docs/examples/asyncio_examples.ipynb
index 855255c88d..7fdcc36bc5 100644
--- a/docs/examples/asyncio_examples.ipynb
+++ b/docs/examples/asyncio_examples.ipynb
@@ -21,6 +21,12 @@
   {
    "cell_type": "code",
    "execution_count": 1,
+   "metadata": {
+    "collapsed": false,
+    "pycharm": {
+     "name": "#%%\n"
+    }
+   },
    "outputs": [
     {
      "name": "stdout",
@@ -36,29 +42,29 @@
     "connection = redis.Redis()\n",
     "print(f\"Ping successful: {await connection.ping()}\")\n",
     "await connection.close()"
-   ],
-   "metadata": {
-    "collapsed": false,
-    "pycharm": {
-     "name": "#%%\n"
-    }
-   }
+   ]
   },
   {
    "cell_type": "markdown",
-   "source": [
-    "If you supply a custom `ConnectionPool` that is supplied to several `Redis` instances, you may want to disconnect the connection pool explicitly. Disconnecting the connection pool simply disconnects all connections hosted in the pool."
-   ],
    "metadata": {
     "collapsed": false,
     "pycharm": {
      "name": "#%% md\n"
     }
-   }
+   },
+   "source": [
+    "If you supply a custom `ConnectionPool` that is supplied to several `Redis` instances, you may want to disconnect the connection pool explicitly. Disconnecting the connection pool simply disconnects all connections hosted in the pool."
+   ]
   },
   {
    "cell_type": "code",
    "execution_count": 2,
+   "metadata": {
+    "collapsed": false,
+    "pycharm": {
+     "name": "#%%\n"
+    }
+   },
    "outputs": [],
    "source": [
     "import redis.asyncio as redis\n",
@@ -67,16 +73,36 @@
     "await connection.close()\n",
     "# Or: await connection.close(close_connection_pool=False)\n",
     "await connection.connection_pool.disconnect()"
-   ],
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "By default, this library uses version 2 of the RESP protocol. To enable RESP version 3, you will want to set `protocol` to 3"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import redis.asyncio as redis\n",
+    "\n",
+    "connection = redis.Redis(protocol=3)\n",
+    "await connection.close()\n",
+    "await connection.ping()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
    "metadata": {
     "collapsed": false,
     "pycharm": {
-     "name": "#%%\n"
+     "name": "#%% md\n"
     }
-   }
-  },
-  {
-   "cell_type": "markdown",
+   },
    "source": [
     "## Transactions (Multi/Exec)\n",
     "\n",
@@ -85,17 +111,17 @@
     "The commands will not be reflected in Redis until execute() is called & awaited.\n",
     "\n",
     "Usually, when performing a bulk operation, taking advantage of a “transaction” (e.g., Multi/Exec) is to be desired, as it will also add a layer of atomicity to your bulk operation."
-   ],
-   "metadata": {
-    "collapsed": false,
-    "pycharm": {
-     "name": "#%% md\n"
-    }
-   }
+   ]
   },
   {
    "cell_type": "code",
    "execution_count": 3,
+   "metadata": {
+    "collapsed": false,
+    "pycharm": {
+     "name": "#%%\n"
+    }
+   },
    "outputs": [],
    "source": [
     "import redis.asyncio as redis\n",
@@ -105,31 +131,31 @@
     "    ok1, ok2 = await (pipe.set(\"key1\", \"value1\").set(\"key2\", \"value2\").execute())\n",
     "assert ok1\n",
     "assert ok2"
-   ],
-   "metadata": {
-    "collapsed": false,
-    "pycharm": {
-     "name": "#%%\n"
-    }
-   }
+   ]
   },
   {
    "cell_type": "markdown",
-   "source": [
-    "## Pub/Sub Mode\n",
-    "\n",
-    "Subscribing to specific channels:"
-   ],
    "metadata": {
     "collapsed": false,
     "pycharm": {
      "name": "#%% md\n"
     }
-   }
+   },
+   "source": [
+    "## Pub/Sub Mode\n",
+    "\n",
+    "Subscribing to specific channels:"
+   ]
   },
   {
    "cell_type": "code",
    "execution_count": 4,
+   "metadata": {
+    "collapsed": false,
+    "pycharm": {
+     "name": "#%%\n"
+    }
+   },
    "outputs": [
     {
      "name": "stdout",
@@ -170,29 +196,29 @@
     "    await r.publish(\"channel:1\", STOPWORD)\n",
     "\n",
     "    await future"
-   ],
-   "metadata": {
-    "collapsed": false,
-    "pycharm": {
-     "name": "#%%\n"
-    }
-   }
+   ]
   },
   {
    "cell_type": "markdown",
-   "source": [
-    "Subscribing to channels matching a glob-style pattern:"
-   ],
    "metadata": {
     "collapsed": false,
     "pycharm": {
      "name": "#%% md\n"
     }
-   }
+   },
+   "source": [
+    "Subscribing to channels matching a glob-style pattern:"
+   ]
   },
   {
    "cell_type": "code",
    "execution_count": 5,
+   "metadata": {
+    "collapsed": false,
+    "pycharm": {
+     "name": "#%%\n"
+    }
+   },
    "outputs": [
     {
      "name": "stdout",
@@ -234,16 +260,16 @@
     "    await r.publish(\"channel:1\", STOPWORD)\n",
     "\n",
     "    await future"
-   ],
+   ]
+  },
+  {
+   "cell_type": "markdown",
    "metadata": {
     "collapsed": false,
     "pycharm": {
-     "name": "#%%\n"
+     "name": "#%% md\n"
     }
-   }
-  },
-  {
-   "cell_type": "markdown",
+   },
    "source": [
     "## Sentinel Client\n",
     "\n",
@@ -252,17 +278,17 @@
     "Calling aioredis.sentinel.Sentinel.master_for or aioredis.sentinel.Sentinel.slave_for methods will return Redis clients connected to specified services monitored by Sentinel.\n",
     "\n",
     "Sentinel client will detect failover and reconnect Redis clients automatically."
-   ],
-   "metadata": {
-    "collapsed": false,
-    "pycharm": {
-     "name": "#%% md\n"
-    }
-   }
+   ]
   },
   {
    "cell_type": "code",
    "execution_count": null,
+   "metadata": {
+    "collapsed": false,
+    "pycharm": {
+     "name": "#%%\n"
+    }
+   },
    "outputs": [],
    "source": [
     "import asyncio\n",
@@ -277,13 +303,61 @@
     "assert ok\n",
     "val = await r.get(\"key\")\n",
     "assert val == b\"value\""
-   ],
-   "metadata": {
-    "collapsed": false,
-    "pycharm": {
-     "name": "#%%\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Connecting to Redis instances by specifying a URL scheme.\n",
+    "Parameters are passed to the following schems, as parameters to the url scheme.\n",
+    "\n",
+    "Three URL schemes are supported:\n",
+    "\n",
+    "- `redis://` creates a TCP socket connection. <https://www.iana.org/assignments/uri-schemes/prov/redis>\n",
+    "- `rediss://` creates a SSL wrapped TCP socket connection. <https://www.iana.org/assignments/uri-schemes/prov/rediss>\n",
+    "- ``unix://``: creates a Unix Domain Socket connection.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
     }
-   }
+   ],
+   "source": [
+    "import redis.asyncio as redis\n",
+    "url_connection = redis.from_url(\"redis://localhost:6379?decode_responses=True\")\n",
+    "url_connection.ping()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "To enable the RESP 3 protocol, append `protocol=3` to the URL."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import redis.asyncio as redis\n",
+    "\n",
+    "url_connection = redis.from_url(\"redis://localhost:6379?decode_responses=Trueprotocol=3\")\n",
+    "url_connection.ping()"
+   ]
   }
  ],
  "metadata": {
@@ -307,4 +381,4 @@
  },
  "nbformat": 4,
  "nbformat_minor": 1
-}
\ No newline at end of file
+}
diff --git a/docs/examples/connection_examples.ipynb b/docs/examples/connection_examples.ipynb
index d15d964af7..e6d147c920 100644
--- a/docs/examples/connection_examples.ipynb
+++ b/docs/examples/connection_examples.ipynb
@@ -41,7 +41,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "### by default Redis return binary responses, to decode them use decode_responses=True"
+    "### By default Redis return binary responses, to decode them use decode_responses=True"
    ]
   },
   {
@@ -67,6 +67,25 @@
     "decoded_connection.ping()"
    ]
   },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "### by default this library uses the RESP 2 protocol. To eanble RESP3, set protocol=3."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "import redis\n",
+    "\n",
+    "r = redis.Redis(protocol=3)\n",
+    "rcon.ping()"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},
@@ -99,14 +118,15 @@
   },
   {
    "cell_type": "markdown",
+   "metadata": {},
    "source": [
     "## Connecting to a redis instance with username and password credential provider"
-   ],
-   "metadata": {}
+   ]
   },
   {
    "cell_type": "code",
    "execution_count": null,
+   "metadata": {},
    "outputs": [],
    "source": [
     "import redis\n",
@@ -114,19 +134,19 @@
     "creds_provider = redis.UsernamePasswordCredentialProvider(\"username\", \"password\")\n",
     "user_connection = redis.Redis(host=\"localhost\", port=6379, credential_provider=creds_provider)\n",
     "user_connection.ping()"
-   ],
-   "metadata": {}
+   ]
   },
   {
    "cell_type": "markdown",
+   "metadata": {},
    "source": [
     "## Connecting to a redis instance with standard credential provider"
-   ],
-   "metadata": {}
+   ]
   },
   {
    "cell_type": "code",
    "execution_count": null,
+   "metadata": {},
    "outputs": [],
    "source": [
     "from typing import Tuple\n",
@@ -158,19 +178,19 @@
     "user_connection = redis.Redis(host=\"localhost\", port=6379,\n",
     "                              credential_provider=creds_provider)\n",
     "user_connection.ping()"
-   ],
-   "metadata": {}
+   ]
   },
   {
    "cell_type": "markdown",
+   "metadata": {},
    "source": [
     "## Connecting to a redis instance first with an initial credential set and then calling the credential provider"
-   ],
-   "metadata": {}
+   ]
   },
   {
    "cell_type": "code",
    "execution_count": null,
+   "metadata": {},
    "outputs": [],
    "source": [
     "from typing import Union\n",
@@ -194,8 +214,7 @@
     "        return self.username, self.password\n",
     "\n",
     "cred_provider = InitCredsSetCredentialProvider(username=\"init_user\", password=\"init_pass\")"
-   ],
-   "metadata": {}
+   ]
   },
   {
    "cell_type": "markdown",
@@ -357,7 +376,23 @@
    ],
    "source": [
     "url_connection = redis.from_url(\"redis://localhost:6379?decode_responses=True&health_check_interval=2\")\n",
-    "\n",
+    "url_connection.ping()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Connecting to Redis instances by specifying a URL scheme and the RESP3 protocol.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "url_connection = redis.from_url(\"redis://localhost:6379?decode_responses=True&health_check_interval=2&protocol=3\")\n",
     "url_connection.ping()"
    ]
   },
@@ -404,4 +439,4 @@
  },
  "nbformat": 4,
  "nbformat_minor": 2
-}
\ No newline at end of file
+}

From dc62e19231ae4ba4317ede15c3aa9de4f93cd328 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 2 Aug 2023 18:51:49 +0300
Subject: [PATCH 0750/1164] EOL for Python 3.7 (#2852)

---
 README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/README.md b/README.md
index e4e0debe03..67912eb3ef 100644
--- a/README.md
+++ b/README.md
@@ -13,6 +13,10 @@ The Python interface to the Redis key-value store.
 
 ---------------------------------------------
 
+**Note: ** redis-py 5.0 will be the last version of redis-py to support Python 3.7, as it has reached [end of life](https://devguide.python.org/versions/). redis-py 5.1 will support Python 3.8+.
+
+---------------------------------------------
+
 ## Installation
 
 Start a redis via docker:

From 7d70c9123bd54ff42d3080c9596c81126ef7e4bc Mon Sep 17 00:00:00 2001
From: Kurt McKee <contactme@kurtmckee.org>
Date: Wed, 2 Aug 2023 10:52:24 -0500
Subject: [PATCH 0751/1164] Fix a duplicate word in `CONTRIBUTING.md` (#2848)

---
 CONTRIBUTING.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 90a538be46..1081f4cb46 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -179,6 +179,6 @@ you would like and how it should work.
 ## Code review process
 
 The core team regularly looks at pull requests. We will provide
-feedback as as soon as possible. After receiving our feedback, please respond
+feedback as soon as possible. After receiving our feedback, please respond
 within two weeks. After that time, we may close your PR if it isn't
 showing any activity.

From 66bad8eda8a1513e111a0c0bf3c79b8b9536e33e Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 3 Aug 2023 03:36:57 +0300
Subject: [PATCH 0752/1164] Add sync modules (except search) tests to cluster
 CI (#2850)

* Add modules to cluster ci

* remove async tests

* fix protocol checking

* fix tests

* revert cluster docker change

* skip json 2.6.0 tests

* remove breakpoint

* skip test_get_latest

* skip json.mset

* type hint

* revert type hints

* ilnters

---------

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/commands/bf/__init__.py         | 12 +++---
 redis/commands/helpers.py             |  8 ++++
 redis/commands/json/__init__.py       | 13 ++----
 redis/commands/timeseries/__init__.py |  4 +-
 tests/test_asyncio/test_bloom.py      |  2 +-
 tests/test_asyncio/test_json.py       |  1 +
 tests/test_bloom.py                   | 29 +------------
 tests/test_graph.py                   | 22 ----------
 tests/test_json.py                    | 60 +++------------------------
 tests/test_timeseries.py              | 36 ++--------------
 10 files changed, 32 insertions(+), 155 deletions(-)

diff --git a/redis/commands/bf/__init__.py b/redis/commands/bf/__init__.py
index bfa9456879..959358f8e8 100644
--- a/redis/commands/bf/__init__.py
+++ b/redis/commands/bf/__init__.py
@@ -1,6 +1,6 @@
 from redis._parsers.helpers import bool_ok
 
-from ..helpers import parse_to_list
+from ..helpers import get_protocol_version, parse_to_list
 from .commands import *  # noqa
 from .info import BFInfo, CFInfo, CMSInfo, TDigestInfo, TopKInfo
 
@@ -108,7 +108,7 @@ def __init__(self, client, **kwargs):
         self.commandmixin = CMSCommands
         self.execute_command = client.execute_command
 
-        if self.client.connection_pool.connection_kwargs.get("protocol") in ["3", 3]:
+        if get_protocol_version(self.client) in ["3", 3]:
             _MODULE_CALLBACKS.update(_RESP3_MODULE_CALLBACKS)
         else:
             _MODULE_CALLBACKS.update(_RESP2_MODULE_CALLBACKS)
@@ -139,7 +139,7 @@ def __init__(self, client, **kwargs):
         self.commandmixin = TOPKCommands
         self.execute_command = client.execute_command
 
-        if self.client.connection_pool.connection_kwargs.get("protocol") in ["3", 3]:
+        if get_protocol_version(self.client) in ["3", 3]:
             _MODULE_CALLBACKS.update(_RESP3_MODULE_CALLBACKS)
         else:
             _MODULE_CALLBACKS.update(_RESP2_MODULE_CALLBACKS)
@@ -174,7 +174,7 @@ def __init__(self, client, **kwargs):
         self.commandmixin = CFCommands
         self.execute_command = client.execute_command
 
-        if self.client.connection_pool.connection_kwargs.get("protocol") in ["3", 3]:
+        if get_protocol_version(self.client) in ["3", 3]:
             _MODULE_CALLBACKS.update(_RESP3_MODULE_CALLBACKS)
         else:
             _MODULE_CALLBACKS.update(_RESP2_MODULE_CALLBACKS)
@@ -210,7 +210,7 @@ def __init__(self, client, **kwargs):
         self.commandmixin = TDigestCommands
         self.execute_command = client.execute_command
 
-        if self.client.connection_pool.connection_kwargs.get("protocol") in ["3", 3]:
+        if get_protocol_version(self.client) in ["3", 3]:
             _MODULE_CALLBACKS.update(_RESP3_MODULE_CALLBACKS)
         else:
             _MODULE_CALLBACKS.update(_RESP2_MODULE_CALLBACKS)
@@ -244,7 +244,7 @@ def __init__(self, client, **kwargs):
         self.commandmixin = BFCommands
         self.execute_command = client.execute_command
 
-        if self.client.connection_pool.connection_kwargs.get("protocol") in ["3", 3]:
+        if get_protocol_version(self.client) in ["3", 3]:
             _MODULE_CALLBACKS.update(_RESP3_MODULE_CALLBACKS)
         else:
             _MODULE_CALLBACKS.update(_RESP2_MODULE_CALLBACKS)
diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
index b65cd1a933..324d981d66 100644
--- a/redis/commands/helpers.py
+++ b/redis/commands/helpers.py
@@ -3,6 +3,7 @@
 import string
 from typing import List, Tuple
 
+import redis
 from redis.typing import KeysT, KeyT
 
 
@@ -156,3 +157,10 @@ def stringify_param_value(value):
         return f'{{{",".join(f"{k}:{stringify_param_value(v)}" for k, v in value.items())}}}'  # noqa
     else:
         return str(value)
+
+
+def get_protocol_version(client):
+    if isinstance(client, redis.Redis) or isinstance(client, redis.asyncio.Redis):
+        return client.connection_pool.connection_kwargs.get("protocol")
+    elif isinstance(client, redis.cluster.AbstractRedisCluster):
+        return client.nodes_manager.connection_kwargs.get("protocol")
diff --git a/redis/commands/json/__init__.py b/redis/commands/json/__init__.py
index e895e6a2ba..01077e6b88 100644
--- a/redis/commands/json/__init__.py
+++ b/redis/commands/json/__init__.py
@@ -2,7 +2,7 @@
 
 import redis
 
-from ..helpers import nativestr
+from ..helpers import get_protocol_version, nativestr
 from .commands import JSONCommands
 from .decoders import bulk_of_jsons, decode_list
 
@@ -34,6 +34,7 @@ def __init__(
         self._MODULE_CALLBACKS = {
             "JSON.ARRPOP": self._decode,
             "JSON.DEBUG": self._decode,
+            "JSON.GET": self._decode,
             "JSON.MERGE": lambda r: r and nativestr(r) == "OK",
             "JSON.MGET": bulk_of_jsons(self._decode),
             "JSON.MSET": lambda r: r and nativestr(r) == "OK",
@@ -61,19 +62,13 @@ def __init__(
             "JSON.TOGGLE": self._decode,
         }
 
-        _RESP3_MODULE_CALLBACKS = {
-            "JSON.GET": lambda response: [
-                [self._decode(r) for r in res] for res in response
-            ]
-            if response
-            else response
-        }
+        _RESP3_MODULE_CALLBACKS = {}
 
         self.client = client
         self.execute_command = client.execute_command
         self.MODULE_VERSION = version
 
-        if self.client.connection_pool.connection_kwargs.get("protocol") in ["3", 3]:
+        if get_protocol_version(self.client) in ["3", 3]:
             self._MODULE_CALLBACKS.update(_RESP3_MODULE_CALLBACKS)
         else:
             self._MODULE_CALLBACKS.update(_RESP2_MODULE_CALLBACKS)
diff --git a/redis/commands/timeseries/__init__.py b/redis/commands/timeseries/__init__.py
index 498f5118f1..4188b93d70 100644
--- a/redis/commands/timeseries/__init__.py
+++ b/redis/commands/timeseries/__init__.py
@@ -1,7 +1,7 @@
 import redis
 from redis._parsers.helpers import bool_ok
 
-from ..helpers import parse_to_list
+from ..helpers import get_protocol_version, parse_to_list
 from .commands import (
     ALTER_CMD,
     CREATE_CMD,
@@ -56,7 +56,7 @@ def __init__(self, client=None, **kwargs):
         self.client = client
         self.execute_command = client.execute_command
 
-        if self.client.connection_pool.connection_kwargs.get("protocol") in ["3", 3]:
+        if get_protocol_version(self.client) in ["3", 3]:
             self._MODULE_CALLBACKS.update(_RESP3_MODULE_CALLBACKS)
         else:
             self._MODULE_CALLBACKS.update(_RESP2_MODULE_CALLBACKS)
diff --git a/tests/test_asyncio/test_bloom.py b/tests/test_asyncio/test_bloom.py
index 0535ddfe02..d0a25e5625 100644
--- a/tests/test_asyncio/test_bloom.py
+++ b/tests/test_asyncio/test_bloom.py
@@ -365,7 +365,7 @@ async def test_tdigest_reset(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
-@pytest.mark.experimental
+@pytest.mark.onlynoncluster
 async def test_tdigest_merge(decoded_r: redis.Redis):
     assert await decoded_r.tdigest().create("to-tDigest", 10)
     assert await decoded_r.tdigest().create("from-tDigest", 10)
diff --git a/tests/test_asyncio/test_json.py b/tests/test_asyncio/test_json.py
index 6f3e8c3251..ed651cd903 100644
--- a/tests/test_asyncio/test_json.py
+++ b/tests/test_asyncio/test_json.py
@@ -112,6 +112,7 @@ async def test_mgetshouldsucceed(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
+@pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("2.6.0", "ReJSON")
 async def test_mset(decoded_r: redis.Redis):
     await decoded_r.json().mset(
diff --git a/tests/test_bloom.py b/tests/test_bloom.py
index a82fece470..464a946f54 100644
--- a/tests/test_bloom.py
+++ b/tests/test_bloom.py
@@ -24,7 +24,6 @@ def client(decoded_r):
     return decoded_r
 
 
-@pytest.mark.redismod
 def test_create(client):
     """Test CREATE/RESERVE calls"""
     assert client.bf().create("bloom", 0.01, 1000)
@@ -39,7 +38,6 @@ def test_create(client):
     assert client.topk().reserve("topk", 5, 100, 5, 0.9)
 
 
-@pytest.mark.redismod
 def test_bf_reserve(client):
     """Testing BF.RESERVE"""
     assert client.bf().reserve("bloom", 0.01, 1000)
@@ -54,13 +52,11 @@ def test_bf_reserve(client):
     assert client.topk().reserve("topk", 5, 100, 5, 0.9)
 
 
-@pytest.mark.redismod
 @pytest.mark.experimental
 def test_tdigest_create(client):
     assert client.tdigest().create("tDigest", 100)
 
 
-@pytest.mark.redismod
 def test_bf_add(client):
     assert client.bf().create("bloom", 0.01, 1000)
     assert 1 == client.bf().add("bloom", "foo")
@@ -73,7 +69,6 @@ def test_bf_add(client):
     assert [1, 0] == intlist(client.bf().mexists("bloom", "foo", "noexist"))
 
 
-@pytest.mark.redismod
 def test_bf_insert(client):
     assert client.bf().create("bloom", 0.01, 1000)
     assert [1] == intlist(client.bf().insert("bloom", ["foo"]))
@@ -104,7 +99,6 @@ def test_bf_insert(client):
     )
 
 
-@pytest.mark.redismod
 def test_bf_scandump_and_loadchunk(client):
     # Store a filter
     client.bf().create("myBloom", "0.0001", "1000")
@@ -156,7 +150,6 @@ def do_verify():
     client.bf().create("myBloom", "0.0001", "10000000")
 
 
-@pytest.mark.redismod
 def test_bf_info(client):
     expansion = 4
     # Store a filter
@@ -188,7 +181,6 @@ def test_bf_info(client):
         assert True
 
 
-@pytest.mark.redismod
 def test_bf_card(client):
     # return 0 if the key does not exist
     assert client.bf().card("not_exist") == 0
@@ -203,7 +195,6 @@ def test_bf_card(client):
         client.bf().card("setKey")
 
 
-@pytest.mark.redismod
 def test_cf_add_and_insert(client):
     assert client.cf().create("cuckoo", 1000)
     assert client.cf().add("cuckoo", "filter")
@@ -229,7 +220,6 @@ def test_cf_add_and_insert(client):
     )
 
 
-@pytest.mark.redismod
 def test_cf_exists_and_del(client):
     assert client.cf().create("cuckoo", 1000)
     assert client.cf().add("cuckoo", "filter")
@@ -242,7 +232,6 @@ def test_cf_exists_and_del(client):
     assert 0 == client.cf().count("cuckoo", "filter")
 
 
-@pytest.mark.redismod
 def test_cms(client):
     assert client.cms().initbydim("dim", 1000, 5)
     assert client.cms().initbyprob("prob", 0.01, 0.01)
@@ -258,7 +247,6 @@ def test_cms(client):
     assert 25 == info["count"]
 
 
-@pytest.mark.redismod
 @pytest.mark.onlynoncluster
 def test_cms_merge(client):
     assert client.cms().initbydim("A", 1000, 5)
@@ -276,7 +264,6 @@ def test_cms_merge(client):
     assert [16, 15, 21] == client.cms().query("C", "foo", "bar", "baz")
 
 
-@pytest.mark.redismod
 def test_topk(client):
     # test list with empty buckets
     assert client.topk().reserve("topk", 3, 50, 4, 0.9)
@@ -356,7 +343,6 @@ def test_topk(client):
     assert 0.9 == round(float(info["decay"]), 1)
 
 
-@pytest.mark.redismod
 def test_topk_incrby(client):
     client.flushdb()
     assert client.topk().reserve("topk", 3, 10, 3, 1)
@@ -370,7 +356,6 @@ def test_topk_incrby(client):
         )
 
 
-@pytest.mark.redismod
 @pytest.mark.experimental
 def test_tdigest_reset(client):
     assert client.tdigest().create("tDigest", 10)
@@ -387,8 +372,7 @@ def test_tdigest_reset(client):
     )
 
 
-@pytest.mark.redismod
-@pytest.mark.experimental
+@pytest.mark.onlynoncluster
 def test_tdigest_merge(client):
     assert client.tdigest().create("to-tDigest", 10)
     assert client.tdigest().create("from-tDigest", 10)
@@ -415,7 +399,6 @@ def test_tdigest_merge(client):
     assert 4.0 == client.tdigest().max("to-tDigest")
 
 
-@pytest.mark.redismod
 @pytest.mark.experimental
 def test_tdigest_min_and_max(client):
     assert client.tdigest().create("tDigest", 100)
@@ -426,7 +409,6 @@ def test_tdigest_min_and_max(client):
     assert 1 == client.tdigest().min("tDigest")
 
 
-@pytest.mark.redismod
 @pytest.mark.experimental
 @skip_ifmodversion_lt("2.4.0", "bf")
 def test_tdigest_quantile(client):
@@ -448,7 +430,6 @@ def test_tdigest_quantile(client):
     assert [3.0, 5.0] == client.tdigest().quantile("t-digest", 0.5, 0.8)
 
 
-@pytest.mark.redismod
 @pytest.mark.experimental
 def test_tdigest_cdf(client):
     assert client.tdigest().create("tDigest", 100)
@@ -460,7 +441,6 @@ def test_tdigest_cdf(client):
     assert [0.1, 0.9] == [round(x, 1) for x in res]
 
 
-@pytest.mark.redismod
 @pytest.mark.experimental
 @skip_ifmodversion_lt("2.4.0", "bf")
 def test_tdigest_trimmed_mean(client):
@@ -471,7 +451,6 @@ def test_tdigest_trimmed_mean(client):
     assert 4.5 == client.tdigest().trimmed_mean("tDigest", 0.4, 0.5)
 
 
-@pytest.mark.redismod
 @pytest.mark.experimental
 def test_tdigest_rank(client):
     assert client.tdigest().create("t-digest", 500)
@@ -482,7 +461,6 @@ def test_tdigest_rank(client):
     assert [-1, 20, 9] == client.tdigest().rank("t-digest", -20, 20, 9)
 
 
-@pytest.mark.redismod
 @pytest.mark.experimental
 def test_tdigest_revrank(client):
     assert client.tdigest().create("t-digest", 500)
@@ -492,7 +470,6 @@ def test_tdigest_revrank(client):
     assert [-1, 19, 9] == client.tdigest().revrank("t-digest", 21, 0, 10)
 
 
-@pytest.mark.redismod
 @pytest.mark.experimental
 def test_tdigest_byrank(client):
     assert client.tdigest().create("t-digest", 500)
@@ -504,7 +481,6 @@ def test_tdigest_byrank(client):
         client.tdigest().byrank("t-digest", -1)[0]
 
 
-@pytest.mark.redismod
 @pytest.mark.experimental
 def test_tdigest_byrevrank(client):
     assert client.tdigest().create("t-digest", 500)
@@ -516,8 +492,7 @@ def test_tdigest_byrevrank(client):
         client.tdigest().byrevrank("t-digest", -1)[0]
 
 
-# @pytest.mark.redismod
-# def test_pipeline(client):
+# # def test_pipeline(client):
 #     pipeline = client.bf().pipeline()
 #     assert not client.bf().execute_command("get pipeline")
 #
diff --git a/tests/test_graph.py b/tests/test_graph.py
index 42f1d9e5df..6fa9977d98 100644
--- a/tests/test_graph.py
+++ b/tests/test_graph.py
@@ -30,14 +30,12 @@ def client(request):
     return r
 
 
-@pytest.mark.redismod
 def test_bulk(client):
     with pytest.raises(NotImplementedError):
         client.graph().bulk()
         client.graph().bulk(foo="bar!")
 
 
-@pytest.mark.redismod
 def test_graph_creation(client):
     graph = client.graph()
 
@@ -82,7 +80,6 @@ def test_graph_creation(client):
     graph.delete()
 
 
-@pytest.mark.redismod
 def test_array_functions(client):
     query = """CREATE (p:person{name:'a',age:32, array:[0,1,2]})"""
     client.graph().query(query)
@@ -103,7 +100,6 @@ def test_array_functions(client):
     assert [a] == result.result_set[0][0]
 
 
-@pytest.mark.redismod
 def test_path(client):
     node0 = Node(node_id=0, label="L1")
     node1 = Node(node_id=1, label="L1")
@@ -123,7 +119,6 @@ def test_path(client):
     assert expected_results == result.result_set
 
 
-@pytest.mark.redismod
 def test_param(client):
     params = [1, 2.3, "str", True, False, None, [0, 1, 2], r"\" RETURN 1337 //"]
     query = "RETURN $param"
@@ -133,7 +128,6 @@ def test_param(client):
         assert expected_results == result.result_set
 
 
-@pytest.mark.redismod
 def test_map(client):
     query = "RETURN {a:1, b:'str', c:NULL, d:[1,2,3], e:True, f:{x:1, y:2}}"
 
@@ -150,7 +144,6 @@ def test_map(client):
     assert actual == expected
 
 
-@pytest.mark.redismod
 def test_point(client):
     query = "RETURN point({latitude: 32.070794860, longitude: 34.820751118})"
     expected_lat = 32.070794860
@@ -167,7 +160,6 @@ def test_point(client):
     assert abs(actual["longitude"] - expected_lon) < 0.001
 
 
-@pytest.mark.redismod
 def test_index_response(client):
     result_set = client.graph().query("CREATE INDEX ON :person(age)")
     assert 1 == result_set.indices_created
@@ -182,7 +174,6 @@ def test_index_response(client):
         client.graph().query("DROP INDEX ON :person(age)")
 
 
-@pytest.mark.redismod
 def test_stringify_query_result(client):
     graph = client.graph()
 
@@ -236,7 +227,6 @@ def test_stringify_query_result(client):
     graph.delete()
 
 
-@pytest.mark.redismod
 def test_optional_match(client):
     # Build a graph of form (a)-[R]->(b)
     node0 = Node(node_id=0, label="L1", properties={"value": "a"})
@@ -261,7 +251,6 @@ def test_optional_match(client):
     graph.delete()
 
 
-@pytest.mark.redismod
 def test_cached_execution(client):
     client.graph().query("CREATE ()")
 
@@ -279,7 +268,6 @@ def test_cached_execution(client):
     assert cached_result.cached_execution
 
 
-@pytest.mark.redismod
 def test_slowlog(client):
     create_query = """CREATE (:Rider
     {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
@@ -292,7 +280,6 @@ def test_slowlog(client):
     assert results[0][2] == create_query
 
 
-@pytest.mark.redismod
 @pytest.mark.xfail(strict=False)
 def test_query_timeout(client):
     # Build a sample graph with 1000 nodes.
@@ -307,7 +294,6 @@ def test_query_timeout(client):
         assert False is False
 
 
-@pytest.mark.redismod
 def test_read_only_query(client):
     with pytest.raises(Exception):
         # Issue a write query, specifying read-only true,
@@ -316,7 +302,6 @@ def test_read_only_query(client):
         assert False is False
 
 
-@pytest.mark.redismod
 def test_profile(client):
     q = """UNWIND range(1, 3) AS x CREATE (p:Person {v:x})"""
     profile = client.graph().profile(q).result_set
@@ -331,7 +316,6 @@ def test_profile(client):
     assert "Node By Label Scan | (p:Person) | Records produced: 3" in profile
 
 
-@pytest.mark.redismod
 @skip_if_redis_enterprise()
 def test_config(client):
     config_name = "RESULTSET_SIZE"
@@ -363,7 +347,6 @@ def test_config(client):
     client.graph().config("RESULTSET_SIZE", -100, set=True)
 
 
-@pytest.mark.redismod
 @pytest.mark.onlynoncluster
 def test_list_keys(client):
     result = client.graph().list_keys()
@@ -387,7 +370,6 @@ def test_list_keys(client):
     assert result == []
 
 
-@pytest.mark.redismod
 def test_multi_label(client):
     redis_graph = client.graph("g")
 
@@ -413,7 +395,6 @@ def test_multi_label(client):
         assert True
 
 
-@pytest.mark.redismod
 def test_cache_sync(client):
     pass
     return
@@ -486,7 +467,6 @@ def test_cache_sync(client):
     assert A._relationship_types[1] == "R"
 
 
-@pytest.mark.redismod
 def test_execution_plan(client):
     redis_graph = client.graph("execution_plan")
     create_query = """CREATE
@@ -505,7 +485,6 @@ def test_execution_plan(client):
     redis_graph.delete()
 
 
-@pytest.mark.redismod
 def test_explain(client):
     redis_graph = client.graph("execution_plan")
     # graph creation / population
@@ -594,7 +573,6 @@ def test_explain(client):
     redis_graph.delete()
 
 
-@pytest.mark.redismod
 def test_resultset_statistics(client):
     with patch.object(target=QueryResult, attribute="_get_stat") as mock_get_stats:
         result = client.graph().query("RETURN 1")
diff --git a/tests/test_json.py b/tests/test_json.py
index fb608ff425..be347f6677 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -14,7 +14,6 @@ def client(request):
     return r
 
 
-@pytest.mark.redismod
 def test_json_setbinarykey(client):
     d = {"hello": "world", b"some": "value"}
     with pytest.raises(TypeError):
@@ -22,7 +21,6 @@ def test_json_setbinarykey(client):
     assert client.json().set("somekey", Path.root_path(), d, decode_keys=True)
 
 
-@pytest.mark.redismod
 def test_json_setgetdeleteforget(client):
     assert client.json().set("foo", Path.root_path(), "bar")
     assert_resp_response(client, client.json().get("foo"), "bar", [["bar"]])
@@ -32,13 +30,11 @@ def test_json_setgetdeleteforget(client):
     assert client.exists("foo") == 0
 
 
-@pytest.mark.redismod
 def test_jsonget(client):
     client.json().set("foo", Path.root_path(), "bar")
     assert_resp_response(client, client.json().get("foo"), "bar", [["bar"]])
 
 
-@pytest.mark.redismod
 def test_json_get_jset(client):
     assert client.json().set("foo", Path.root_path(), "bar")
     assert_resp_response(client, client.json().get("foo"), "bar", [["bar"]])
@@ -47,8 +43,7 @@ def test_json_get_jset(client):
     assert client.exists("foo") == 0
 
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.6.0", "ReJSON")  # todo: update after the release
+@skip_ifmodversion_lt("2.06.00", "ReJSON")  # todo: update after the release
 def test_json_merge(client):
     # Test with root path $
     assert client.json().set(
@@ -80,7 +75,6 @@ def test_json_merge(client):
     }
 
 
-@pytest.mark.redismod
 def test_nonascii_setgetdelete(client):
     assert client.json().set("notascii", Path.root_path(), "hyvää-élève")
     res = "hyvää-élève"
@@ -91,7 +85,6 @@ def test_nonascii_setgetdelete(client):
     assert client.exists("notascii") == 0
 
 
-@pytest.mark.redismod
 def test_jsonsetexistentialmodifiersshouldsucceed(client):
     obj = {"foo": "bar"}
     assert client.json().set("obj", Path.root_path(), obj)
@@ -109,7 +102,6 @@ def test_jsonsetexistentialmodifiersshouldsucceed(client):
         client.json().set("obj", Path("foo"), "baz", nx=True, xx=True)
 
 
-@pytest.mark.redismod
 def test_mgetshouldsucceed(client):
     client.json().set("1", Path.root_path(), 1)
     client.json().set("2", Path.root_path(), 2)
@@ -118,8 +110,8 @@ def test_mgetshouldsucceed(client):
     assert client.json().mget([1, 2], Path.root_path()) == [1, 2]
 
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.6.0", "ReJSON")  # todo: update after the release
+@pytest.mark.onlynoncluster
+@skip_ifmodversion_lt("2.06.00", "ReJSON")
 def test_mset(client):
     client.json().mset([("1", Path.root_path(), 1), ("2", Path.root_path(), 2)])
 
@@ -127,7 +119,6 @@ def test_mset(client):
     assert client.json().mget(["1", "2"], Path.root_path()) == [1, 2]
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
 def test_clear(client):
     client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
@@ -135,7 +126,6 @@ def test_clear(client):
     assert_resp_response(client, client.json().get("arr"), [], [[[]]])
 
 
-@pytest.mark.redismod
 def test_type(client):
     client.json().set("1", Path.root_path(), 1)
     assert_resp_response(
@@ -144,7 +134,6 @@ def test_type(client):
     assert_resp_response(client, client.json().type("1"), "integer", ["integer"])
 
 
-@pytest.mark.redismod
 def test_numincrby(client):
     client.json().set("num", Path.root_path(), 1)
     assert_resp_response(
@@ -158,7 +147,6 @@ def test_numincrby(client):
     )
 
 
-@pytest.mark.redismod
 def test_nummultby(client):
     client.json().set("num", Path.root_path(), 1)
 
@@ -174,7 +162,6 @@ def test_nummultby(client):
         )
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
 def test_toggle(client):
     client.json().set("bool", Path.root_path(), False)
@@ -186,7 +173,6 @@ def test_toggle(client):
         client.json().toggle("num", Path.root_path())
 
 
-@pytest.mark.redismod
 def test_strappend(client):
     client.json().set("jsonkey", Path.root_path(), "foo")
     assert 6 == client.json().strappend("jsonkey", "bar")
@@ -195,8 +181,7 @@ def test_strappend(client):
     )
 
 
-# @pytest.mark.redismod
-# def test_debug(client):
+# # def test_debug(client):
 #    client.json().set("str", Path.root_path(), "foo")
 #    assert 24 == client.json().debug("MEMORY", "str", Path.root_path())
 #    assert 24 == client.json().debug("MEMORY", "str")
@@ -205,7 +190,6 @@ def test_strappend(client):
 #    assert isinstance(client.json().debug("HELP"), list)
 
 
-@pytest.mark.redismod
 def test_strlen(client):
     client.json().set("str", Path.root_path(), "foo")
     assert 3 == client.json().strlen("str", Path.root_path())
@@ -214,7 +198,6 @@ def test_strlen(client):
     assert 6 == client.json().strlen("str")
 
 
-@pytest.mark.redismod
 def test_arrappend(client):
     client.json().set("arr", Path.root_path(), [1])
     assert 2 == client.json().arrappend("arr", Path.root_path(), 2)
@@ -222,7 +205,6 @@ def test_arrappend(client):
     assert 7 == client.json().arrappend("arr", Path.root_path(), *[5, 6, 7])
 
 
-@pytest.mark.redismod
 def test_arrindex(client):
     client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
     assert 1 == client.json().arrindex("arr", Path.root_path(), 1)
@@ -234,7 +216,6 @@ def test_arrindex(client):
     assert -1 == client.json().arrindex("arr", Path.root_path(), 4, start=1, stop=3)
 
 
-@pytest.mark.redismod
 def test_arrinsert(client):
     client.json().set("arr", Path.root_path(), [0, 4])
     assert 5 - -client.json().arrinsert("arr", Path.root_path(), 1, *[1, 2, 3])
@@ -248,7 +229,6 @@ def test_arrinsert(client):
     assert_resp_response(client, client.json().get("val2"), res, [[res]])
 
 
-@pytest.mark.redismod
 def test_arrlen(client):
     client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
     assert 5 == client.json().arrlen("arr", Path.root_path())
@@ -256,7 +236,6 @@ def test_arrlen(client):
     assert client.json().arrlen("fakekey") is None
 
 
-@pytest.mark.redismod
 def test_arrpop(client):
     client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
     assert 4 == client.json().arrpop("arr", Path.root_path(), 4)
@@ -274,7 +253,6 @@ def test_arrpop(client):
     assert client.json().arrpop("arr") is None
 
 
-@pytest.mark.redismod
 def test_arrtrim(client):
     client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
     assert 3 == client.json().arrtrim("arr", Path.root_path(), 1, 3)
@@ -297,7 +275,6 @@ def test_arrtrim(client):
     assert 0 == client.json().arrtrim("arr", Path.root_path(), 9, 11)
 
 
-@pytest.mark.redismod
 def test_resp(client):
     obj = {"foo": "bar", "baz": 1, "qaz": True}
     client.json().set("obj", Path.root_path(), obj)
@@ -307,7 +284,6 @@ def test_resp(client):
     assert isinstance(client.json().resp("obj"), list)
 
 
-@pytest.mark.redismod
 def test_objkeys(client):
     obj = {"foo": "bar", "baz": "qaz"}
     client.json().set("obj", Path.root_path(), obj)
@@ -324,7 +300,6 @@ def test_objkeys(client):
     assert client.json().objkeys("fakekey") is None
 
 
-@pytest.mark.redismod
 def test_objlen(client):
     obj = {"foo": "bar", "baz": "qaz"}
     client.json().set("obj", Path.root_path(), obj)
@@ -334,7 +309,6 @@ def test_objlen(client):
     assert len(obj) == client.json().objlen("obj")
 
 
-@pytest.mark.redismod
 def test_json_commands_in_pipeline(client):
     p = client.json().pipeline()
     p.set("foo", Path.root_path(), "bar")
@@ -358,7 +332,6 @@ def test_json_commands_in_pipeline(client):
     assert client.get("foo") is None
 
 
-@pytest.mark.redismod
 def test_json_delete_with_dollar(client):
     doc1 = {"a": 1, "nested": {"a": 2, "b": 3}}
     assert client.json().set("doc1", "$", doc1)
@@ -410,7 +383,6 @@ def test_json_delete_with_dollar(client):
     client.json().delete("not_a_document", "..a")
 
 
-@pytest.mark.redismod
 def test_json_forget_with_dollar(client):
     doc1 = {"a": 1, "nested": {"a": 2, "b": 3}}
     assert client.json().set("doc1", "$", doc1)
@@ -462,7 +434,6 @@ def test_json_forget_with_dollar(client):
     client.json().forget("not_a_document", "..a")
 
 
-@pytest.mark.redismod
 def test_json_mget_dollar(client):
     # Test mget with multi paths
     client.json().set(
@@ -492,7 +463,6 @@ def test_json_mget_dollar(client):
     assert res == [None, None]
 
 
-@pytest.mark.redismod
 def test_numby_commands_dollar(client):
 
     # Test NUMINCRBY
@@ -537,7 +507,6 @@ def test_numby_commands_dollar(client):
         client.json().nummultby("doc1", ".b[0].a", 3) == 6
 
 
-@pytest.mark.redismod
 def test_strappend_dollar(client):
 
     client.json().set(
@@ -569,7 +538,6 @@ def test_strappend_dollar(client):
         client.json().strappend("doc1", "piu")
 
 
-@pytest.mark.redismod
 def test_strlen_dollar(client):
 
     # Test multi
@@ -591,7 +559,6 @@ def test_strlen_dollar(client):
         client.json().strlen("non_existing_doc", "$..a")
 
 
-@pytest.mark.redismod
 def test_arrappend_dollar(client):
     client.json().set(
         "doc1",
@@ -666,7 +633,6 @@ def test_arrappend_dollar(client):
         client.json().arrappend("non_existing_doc", "$..a")
 
 
-@pytest.mark.redismod
 def test_arrinsert_dollar(client):
     client.json().set(
         "doc1",
@@ -705,7 +671,6 @@ def test_arrinsert_dollar(client):
         client.json().arrappend("non_existing_doc", "$..a")
 
 
-@pytest.mark.redismod
 def test_arrlen_dollar(client):
 
     client.json().set(
@@ -755,7 +720,6 @@ def test_arrlen_dollar(client):
     assert client.json().arrlen("non_existing_doc", "..a") is None
 
 
-@pytest.mark.redismod
 def test_arrpop_dollar(client):
     client.json().set(
         "doc1",
@@ -797,7 +761,6 @@ def test_arrpop_dollar(client):
         client.json().arrpop("non_existing_doc", "..a")
 
 
-@pytest.mark.redismod
 def test_arrtrim_dollar(client):
 
     client.json().set(
@@ -851,7 +814,6 @@ def test_arrtrim_dollar(client):
         client.json().arrtrim("non_existing_doc", "..a", 1, 1)
 
 
-@pytest.mark.redismod
 def test_objkeys_dollar(client):
     client.json().set(
         "doc1",
@@ -881,7 +843,6 @@ def test_objkeys_dollar(client):
     assert client.json().objkeys("doc1", "$..nowhere") == []
 
 
-@pytest.mark.redismod
 def test_objlen_dollar(client):
     client.json().set(
         "doc1",
@@ -917,7 +878,6 @@ def test_objlen_dollar(client):
     client.json().objlen("doc1", ".nowhere")
 
 
-@pytest.mark.redismod
 def load_types_data(nested_key_name):
     td = {
         "object": {},
@@ -937,7 +897,6 @@ def load_types_data(nested_key_name):
     return jdata, types
 
 
-@pytest.mark.redismod
 def test_type_dollar(client):
     jdata, jtypes = load_types_data("a")
     client.json().set("doc1", "$", jdata)
@@ -955,7 +914,6 @@ def test_type_dollar(client):
     )
 
 
-@pytest.mark.redismod
 def test_clear_dollar(client):
     client.json().set(
         "doc1",
@@ -1006,7 +964,6 @@ def test_clear_dollar(client):
         client.json().clear("non_existing_doc", "$..a")
 
 
-@pytest.mark.redismod
 def test_toggle_dollar(client):
     client.json().set(
         "doc1",
@@ -1035,8 +992,7 @@ def test_toggle_dollar(client):
         client.json().toggle("non_existing_doc", "$..a")
 
 
-# @pytest.mark.redismod
-# def test_debug_dollar(client):
+# # def test_debug_dollar(client):
 #
 #    jdata, jtypes = load_types_data("a")
 #
@@ -1058,7 +1014,6 @@ def test_toggle_dollar(client):
 #    assert client.json().debug("MEMORY", "non_existing_doc", "$..a") == []
 
 
-@pytest.mark.redismod
 def test_resp_dollar(client):
 
     data = {
@@ -1288,7 +1243,6 @@ def test_resp_dollar(client):
     client.json().resp("non_existing_doc", "$..a")
 
 
-@pytest.mark.redismod
 def test_arrindex_dollar(client):
 
     client.json().set(
@@ -1515,7 +1469,6 @@ def test_arrindex_dollar(client):
     assert client.json().arrindex("test_None", "..nested2_not_found.arr", "None") == 0
 
 
-@pytest.mark.redismod
 def test_decoders_and_unstring():
     assert unstring("4") == 4
     assert unstring("45.55") == 45.55
@@ -1526,7 +1479,6 @@ def test_decoders_and_unstring():
     assert decode_list(["hello", b"world"]) == ["hello", "world"]
 
 
-@pytest.mark.redismod
 def test_custom_decoder(client):
     import json
 
@@ -1542,7 +1494,6 @@ def test_custom_decoder(client):
     assert not isinstance(cj.__decoder__, json.JSONDecoder)
 
 
-@pytest.mark.redismod
 def test_set_file(client):
     import json
     import tempfile
@@ -1561,7 +1512,6 @@ def test_set_file(client):
         client.json().set_file("test2", Path.root_path(), nojsonfile.name)
 
 
-@pytest.mark.redismod
 def test_set_path(client):
     import json
     import tempfile
diff --git a/tests/test_timeseries.py b/tests/test_timeseries.py
index 80490af4ef..4ab86cd56e 100644
--- a/tests/test_timeseries.py
+++ b/tests/test_timeseries.py
@@ -14,7 +14,6 @@ def client(decoded_r):
     return decoded_r
 
 
-@pytest.mark.redismod
 def test_create(client):
     assert client.ts().create(1)
     assert client.ts().create(2, retention_msecs=5)
@@ -32,7 +31,6 @@ def test_create(client):
     assert_resp_response(client, 128, info.get("chunk_size"), info.get("chunkSize"))
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
 def test_create_duplicate_policy(client):
     # Test for duplicate policy
@@ -48,7 +46,6 @@ def test_create_duplicate_policy(client):
         )
 
 
-@pytest.mark.redismod
 def test_alter(client):
     assert client.ts().create(1)
     info = client.ts().info(1)
@@ -69,7 +66,6 @@ def test_alter(client):
     )
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
 def test_alter_diplicate_policy(client):
     assert client.ts().create(1)
@@ -84,7 +80,6 @@ def test_alter_diplicate_policy(client):
     )
 
 
-@pytest.mark.redismod
 def test_add(client):
     assert 1 == client.ts().add(1, 1, 1)
     assert 2 == client.ts().add(2, 2, 3, retention_msecs=10)
@@ -107,7 +102,6 @@ def test_add(client):
     assert_resp_response(client, 128, info.get("chunk_size"), info.get("chunkSize"))
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
 def test_add_duplicate_policy(client):
 
@@ -145,13 +139,11 @@ def test_add_duplicate_policy(client):
     assert 5.0 == client.ts().get("time-serie-add-ooo-min")[1]
 
 
-@pytest.mark.redismod
 def test_madd(client):
     client.ts().create("a")
     assert [1, 2, 3] == client.ts().madd([("a", 1, 5), ("a", 2, 10), ("a", 3, 15)])
 
 
-@pytest.mark.redismod
 def test_incrby_decrby(client):
     for _ in range(100):
         assert client.ts().incrby(1, 1)
@@ -180,7 +172,6 @@ def test_incrby_decrby(client):
     assert_resp_response(client, 128, info.get("chunk_size"), info.get("chunkSize"))
 
 
-@pytest.mark.redismod
 def test_create_and_delete_rule(client):
     # test rule creation
     time = 100
@@ -204,7 +195,6 @@ def test_create_and_delete_rule(client):
     assert not info["rules"]
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 def test_del_range(client):
     try:
@@ -219,7 +209,6 @@ def test_del_range(client):
     assert_resp_response(client, client.ts().range(1, 22, 22), [(22, 1.0)], [[22, 1.0]])
 
 
-@pytest.mark.redismod
 def test_range(client):
     for i in range(100):
         client.ts().add(1, i, i % 7)
@@ -234,7 +223,6 @@ def test_range(client):
     assert 10 == len(client.ts().range(1, 0, 500, count=10))
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 def test_range_advanced(client):
     for i in range(100):
@@ -263,7 +251,7 @@ def test_range_advanced(client):
     assert_resp_response(client, res, [(0, 2.55), (10, 3.0)], [[0, 2.55], [10, 3.0]])
 
 
-@pytest.mark.redismod
+@pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("1.8.0", "timeseries")
 def test_range_latest(client: redis.Redis):
     timeseries = client.ts()
@@ -288,7 +276,6 @@ def test_range_latest(client: redis.Redis):
     )
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("1.8.0", "timeseries")
 def test_range_bucket_timestamp(client: redis.Redis):
     timeseries = client.ts()
@@ -322,7 +309,6 @@ def test_range_bucket_timestamp(client: redis.Redis):
     )
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("1.8.0", "timeseries")
 def test_range_empty(client: redis.Redis):
     timeseries = client.ts()
@@ -367,7 +353,6 @@ def test_range_empty(client: redis.Redis):
     assert_resp_response(client, res, resp2_expected, resp3_expected)
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 def test_rev_range(client):
     for i in range(100):
@@ -415,7 +400,7 @@ def test_rev_range(client):
     )
 
 
-@pytest.mark.redismod
+@pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("1.8.0", "timeseries")
 def test_revrange_latest(client: redis.Redis):
     timeseries = client.ts()
@@ -434,7 +419,6 @@ def test_revrange_latest(client: redis.Redis):
     assert_resp_response(client, res, [(0, 4.0)], [[0, 4.0]])
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("1.8.0", "timeseries")
 def test_revrange_bucket_timestamp(client: redis.Redis):
     timeseries = client.ts()
@@ -468,7 +452,6 @@ def test_revrange_bucket_timestamp(client: redis.Redis):
     )
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("1.8.0", "timeseries")
 def test_revrange_empty(client: redis.Redis):
     timeseries = client.ts()
@@ -513,7 +496,6 @@ def test_revrange_empty(client: redis.Redis):
     assert_resp_response(client, res, resp2_expected, resp3_expected)
 
 
-@pytest.mark.redismod
 @pytest.mark.onlynoncluster
 def test_mrange(client):
     client.ts().create(1, labels={"Test": "This", "team": "ny"})
@@ -562,7 +544,6 @@ def test_mrange(client):
         assert {"Test": "This", "team": "ny"} == res["1"][0]
 
 
-@pytest.mark.redismod
 @pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 def test_multi_range_advanced(client):
@@ -676,7 +657,6 @@ def test_multi_range_advanced(client):
         assert [[0, 5.0], [5, 6.0]] == res["1"][2]
 
 
-@pytest.mark.redismod
 @pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("1.8.0", "timeseries")
 def test_mrange_latest(client: redis.Redis):
@@ -706,7 +686,6 @@ def test_mrange_latest(client: redis.Redis):
     )
 
 
-@pytest.mark.redismod
 @pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 def test_multi_reverse_range(client):
@@ -825,7 +804,6 @@ def test_multi_reverse_range(client):
         assert [[1, 10.0], [0, 1.0]] == res["1"][2]
 
 
-@pytest.mark.redismod
 @pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("1.8.0", "timeseries")
 def test_mrevrange_latest(client: redis.Redis):
@@ -855,7 +833,6 @@ def test_mrevrange_latest(client: redis.Redis):
     )
 
 
-@pytest.mark.redismod
 def test_get(client):
     name = "test"
     client.ts().create(name)
@@ -866,7 +843,7 @@ def test_get(client):
     assert 4 == client.ts().get(name)[1]
 
 
-@pytest.mark.redismod
+@pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("1.8.0", "timeseries")
 def test_get_latest(client: redis.Redis):
     timeseries = client.ts()
@@ -883,7 +860,6 @@ def test_get_latest(client: redis.Redis):
     )
 
 
-@pytest.mark.redismod
 @pytest.mark.onlynoncluster
 def test_mget(client):
     client.ts().create(1, labels={"Test": "This"})
@@ -919,7 +895,6 @@ def test_mget(client):
         assert {"Taste": "That", "Test": "This"} == res["2"][0]
 
 
-@pytest.mark.redismod
 @pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("1.8.0", "timeseries")
 def test_mget_latest(client: redis.Redis):
@@ -937,7 +912,6 @@ def test_mget_latest(client: redis.Redis):
     assert_resp_response(client, res, [{"t2": [{}, 10, 8.0]}], {"t2": [{}, [10, 8.0]]})
 
 
-@pytest.mark.redismod
 def test_info(client):
     client.ts().create(1, retention_msecs=5, labels={"currentLabel": "currentData"})
     info = client.ts().info(1)
@@ -947,7 +921,6 @@ def test_info(client):
     assert info["labels"]["currentLabel"] == "currentData"
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
 def testInfoDuplicatePolicy(client):
     client.ts().create(1, retention_msecs=5, labels={"currentLabel": "currentData"})
@@ -963,7 +936,6 @@ def testInfoDuplicatePolicy(client):
     )
 
 
-@pytest.mark.redismod
 @pytest.mark.onlynoncluster
 def test_query_index(client):
     client.ts().create(1, labels={"Test": "This"})
@@ -973,7 +945,6 @@ def test_query_index(client):
     assert_resp_response(client, client.ts().queryindex(["Taste=That"]), [2], {"2"})
 
 
-@pytest.mark.redismod
 def test_pipeline(client):
     pipeline = client.ts().pipeline()
     pipeline.create("with_pipeline")
@@ -991,7 +962,6 @@ def test_pipeline(client):
     assert client.ts().get("with_pipeline")[1] == 99 * 1.1
 
 
-@pytest.mark.redismod
 def test_uncompressed(client):
     client.ts().create("compressed")
     client.ts().create("uncompressed", uncompressed=True)

From da27f4bfb70faaf2c0f2e0d60a7b6d6d76740029 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Juraj=20P=C3=A1ll?= <palljuraj1@gmail.com>
Date: Thu, 3 Aug 2023 02:38:56 +0200
Subject: [PATCH 0753/1164] Fix timeout retrying on Redis pipeline execution
 (#2812)

Achieved by modifying Pipeline._disconnect_raise_reset

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/client.py | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 66e2c7b84f..a856ef84ad 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1379,7 +1379,7 @@ def load_scripts(self):
     def _disconnect_raise_reset(self, conn, error):
         """
         Close the connection, raise an exception if we were watching,
-        and raise an exception if retry_on_timeout is not set,
+        and raise an exception if TimeoutError is not part of retry_on_error,
         or the error is not a TimeoutError
         """
         conn.disconnect()
@@ -1390,11 +1390,13 @@ def _disconnect_raise_reset(self, conn, error):
             raise WatchError(
                 "A ConnectionError occurred on while watching one or more keys"
             )
-        # if retry_on_timeout is not set, or the error is not
-        # a TimeoutError, raise it
-        if not (conn.retry_on_timeout and isinstance(error, TimeoutError)):
+        # if TimeoutError is not part of retry_on_error, or the error
+        # is not a TimeoutError, raise it
+        if not (
+            TimeoutError in conn.retry_on_error and isinstance(error, TimeoutError)
+        ):
             self.reset()
-            raise
+            raise error
 
     def execute(self, raise_on_error=True):
         """Execute all the commands in the current pipeline"""

From 3e50d287f2c22a2cc74984a0cda3c25c3fe29d44 Mon Sep 17 00:00:00 2001
From: Joan Fontanals <jfontanalsmartinez@gmail.com>
Date: Sun, 6 Aug 2023 11:03:37 +0800
Subject: [PATCH 0754/1164] Fix type hints in SearchCommands (#2817)

* fix type hints

* fix lint error

* fix linters

---------

Co-authored-by: dvora-h <dvora.heller@redis.com>
---
 redis/commands/search/commands.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 742474523f..87b572195c 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -451,7 +451,7 @@ def info(self):
         return self._parse_results(INFO_CMD, res)
 
     def get_params_args(
-        self, query_params: Union[Dict[str, Union[str, int, float]], None]
+        self, query_params: Union[Dict[str, Union[str, int, float, bytes]], None]
     ):
         if query_params is None:
             return []
@@ -464,7 +464,9 @@ def get_params_args(
                 args.append(value)
         return args
 
-    def _mk_query_args(self, query, query_params: Dict[str, Union[str, int, float]]):
+    def _mk_query_args(
+        self, query, query_params: Union[Dict[str, Union[str, int, float, bytes]], None]
+    ):
         args = [self.index_name]
 
         if isinstance(query, str):
@@ -481,7 +483,7 @@ def _mk_query_args(self, query, query_params: Dict[str, Union[str, int, float]])
     def search(
         self,
         query: Union[str, Query],
-        query_params: Dict[str, Union[str, int, float]] = None,
+        query_params: Union[Dict[str, Union[str, int, float, bytes]], None] = None,
     ):
         """
         Search the index for a given query, and return a result of documents

From 8370c4ac20835002fd1044e1742986072f19289c Mon Sep 17 00:00:00 2001
From: Kurt McKee <contactme@kurtmckee.org>
Date: Mon, 7 Aug 2023 09:27:30 -0500
Subject: [PATCH 0755/1164] Add a Dependabot config to auto-update GitHub
 action versions (#2847)

---
 .github/dependabot.yml | 6 ++++++
 CHANGES                | 1 +
 2 files changed, 7 insertions(+)
 create mode 100644 .github/dependabot.yml

diff --git a/.github/dependabot.yml b/.github/dependabot.yml
new file mode 100644
index 0000000000..8ac6b8c498
--- /dev/null
+++ b/.github/dependabot.yml
@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "monthly"
diff --git a/CHANGES b/CHANGES
index 363f2b927d..d78ea92fa0 100644
--- a/CHANGES
+++ b/CHANGES
@@ -11,6 +11,7 @@
     * asyncio: Fix memory leak caused by hiredis (#2693)
     * Allow data to drain from async PythonParser when reading during a disconnect()
     * Use asyncio.timeout() instead of async_timeout.timeout() for python >= 3.11 (#2602)
+    * Add a Dependabot configuration to auto-update GitHub action versions.
     * Add test and fix async HiredisParser when reading during a disconnect() (#2349)
     * Use hiredis-py pack_command if available.
     * Support `.unlink()` in ClusterPipeline

From 38c7de617a482c9dd2d40699fbdd7ce44736cae9 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 8 Aug 2023 10:03:54 +0300
Subject: [PATCH 0756/1164] Dependabot label change (#2880)

---
 .github/dependabot.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index 8ac6b8c498..ac71d74297 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -2,5 +2,7 @@ version: 2
 updates:
   - package-ecosystem: "github-actions"
     directory: "/"
+    labels:
+      - "maintenance"
     schedule:
       interval: "monthly"

From 0ed807777cfab129904fd72fbada793f21ea0a9c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 8 Aug 2023 10:04:11 +0300
Subject: [PATCH 0757/1164] Bump pypa/gh-action-pip-audit from 1.0.0 to 1.0.8
 (#2879)

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/integration.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index c4dd30812b..60d04ccd3b 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -30,7 +30,7 @@ jobs:
      runs-on: ubuntu-latest
      steps:
        - uses: actions/checkout@v3
-       - uses: pypa/gh-action-pip-audit@v1.0.0
+       - uses: pypa/gh-action-pip-audit@v1.0.8
          with:
            inputs: requirements.txt dev_requirements.txt
            ignore-vulns: |

From 673617d2cbac265c6c8d43280d5e6898df4572b6 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 8 Aug 2023 10:04:25 +0300
Subject: [PATCH 0758/1164] Bump actions/upload-artifact from 2 to 3 (#2877)

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/integration.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 60d04ccd3b..7e0fea2e41 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -81,7 +81,7 @@ jobs:
            sleep 10 # time to settle
            invoke ${{matrix.test-type}}-tests
 
-       - uses: actions/upload-artifact@v2
+       - uses: actions/upload-artifact@v3
          if: success() || failure()
          with:
            name: pytest-results-${{matrix.test-type}}-${{matrix.connection-type}}-${{matrix.python-version}}

From a532f89adcd5b790e2811588a2d7c34a79b095d5 Mon Sep 17 00:00:00 2001
From: Stanislav Zmiev <zmievsa@gmail.com>
Date: Tue, 8 Aug 2023 10:05:00 +0300
Subject: [PATCH 0759/1164] Add py.typed in accordance with PEP-561 (#2738)

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 CHANGES        | 1068 ++++++++++++++++++++++++------------------------
 redis/py.typed |    0
 setup.py       |    2 +
 3 files changed, 536 insertions(+), 534 deletions(-)
 create mode 100644 redis/py.typed

diff --git a/CHANGES b/CHANGES
index d78ea92fa0..7b3b4c5ac2 100644
--- a/CHANGES
+++ b/CHANGES
@@ -56,321 +56,321 @@
     * Make `ClusterCommandsProtocol` an actual Protocol
 
 * 4.1.3 (Feb 8, 2022)
-    * Fix flushdb and flushall (#1926)
-    * Add redis5 and redis4 dockers (#1871)
-    * Change json.clear test multi to be up to date with redisjson (#1922)
-    * Fixing volume for unstable_cluster docker (#1914)
-    * Update changes file with changes since 4.0.0-beta2 (#1915)
+  * Fix flushdb and flushall (#1926)
+  * Add redis5 and redis4 dockers (#1871)
+  * Change json.clear test multi to be up to date with redisjson (#1922)
+  * Fixing volume for unstable_cluster docker (#1914)
+  * Update changes file with changes since 4.0.0-beta2 (#1915)
 * 4.1.2 (Jan 27, 2022)
-    * Invalid OCSP certificates should raise ConnectionError on failed validation (#1907)
-    * Added retry mechanism on socket timeouts when connecting to the server (#1895)
-    * LMOVE, BLMOVE return incorrect responses (#1906)
-    * Fixing AttributeError in UnixDomainSocketConnection (#1903)
-    * Fixing TypeError in GraphCommands.explain (#1901)
-    * For tests, increasing wait time for the cluster (#1908)
-    * Increased pubsub's wait_for_messages timeout to prevent flaky tests (#1893)
-    * README code snippets formatted to highlight properly (#1888)
-    * Fix link in the main page (#1897)
-    * Documentation fixes: JSON Example, SSL Connection Examples, RTD version (#1887)
-    * Direct link to readthedocs (#1885)
+  * Invalid OCSP certificates should raise ConnectionError on failed validation (#1907)
+  * Added retry mechanism on socket timeouts when connecting to the server (#1895)
+  * LMOVE, BLMOVE return incorrect responses (#1906)
+  * Fixing AttributeError in UnixDomainSocketConnection (#1903)
+  * Fixing TypeError in GraphCommands.explain (#1901)
+  * For tests, increasing wait time for the cluster (#1908)
+  * Increased pubsub's wait_for_messages timeout to prevent flaky tests (#1893)
+  * README code snippets formatted to highlight properly (#1888)
+  * Fix link in the main page (#1897)
+  * Documentation fixes: JSON Example, SSL Connection Examples, RTD version (#1887)
+  * Direct link to readthedocs (#1885)
 * 4.1.1 (Jan 17, 2022)
-    * Add retries to connections in Sentinel Pools (#1879)
-    * OCSP Stapling Support (#1873)
-    * Define incr/decr as aliases of incrby/decrby (#1874)
-    * FT.CREATE - support MAXTEXTFIELDS, TEMPORARY, NOHL, NOFREQS, SKIPINITIALSCAN (#1847)
-    * Timeseries docs fix (#1877)
-    * get_connection: catch OSError too (#1832)
-    * Set keys var otherwise variable not created (#1853)
-    * Clusters should optionally require full slot coverage (#1845)
-    * Triple quote docstrings in client.py PEP 257 (#1876)
-    * syncing requirements (#1870)
-    * Typo and typing in GraphCommands documentation (#1855)
-    * Allowing poetry and redis-py to install together (#1854)
-    * setup.py: Add project_urls for PyPI (#1867)
-    * Support test with redis unstable docker (#1850)
-    * Connection examples (#1835)
-    * Documentation cleanup (#1841)
+  * Add retries to connections in Sentinel Pools (#1879)
+  * OCSP Stapling Support (#1873)
+  * Define incr/decr as aliases of incrby/decrby (#1874)
+  * FT.CREATE - support MAXTEXTFIELDS, TEMPORARY, NOHL, NOFREQS, SKIPINITIALSCAN (#1847)
+  * Timeseries docs fix (#1877)
+  * get_connection: catch OSError too (#1832)
+  * Set keys var otherwise variable not created (#1853)
+  * Clusters should optionally require full slot coverage (#1845)
+  * Triple quote docstrings in client.py PEP 257 (#1876)
+  * syncing requirements (#1870)
+  * Typo and typing in GraphCommands documentation (#1855)
+  * Allowing poetry and redis-py to install together (#1854)
+  * setup.py: Add project_urls for PyPI (#1867)
+  * Support test with redis unstable docker (#1850)
+  * Connection examples (#1835)
+  * Documentation cleanup (#1841)
 * 4.1.0 (Dec 26, 2021)
-    * OCSP stapling support (#1820)
-    * Support for SELECT (#1825)
-    * Support for specifying error types with retry (#1817)
-    * Support for RESET command since Redis 6.2.0 (#1824)
-    * Support CLIENT TRACKING (#1612)
-    * Support WRITE in CLIENT PAUSE (#1549)
-    * JSON set_file and set_path support (#1818)
-    * Allow ssl_ca_path with rediss:// urls (#1814)
-    * Support for password-encrypted SSL private keys (#1782)
-    * Support SYNC and PSYNC (#1741)
-    * Retry on error exception and timeout fixes (#1821)
-    * Fixing read race condition during pubsub (#1737)
-    * Fixing exception in listen (#1823)
-    * Fixed MovedError, and stopped iterating through startup nodes when slots are fully covered (#1819)
-    * Socket not closing after server disconnect (#1797)
-    * Single sourcing the package version (#1791)
-    * Ensure redis_connect_func is set on uds connection (#1794)
-    * SRTALGO - Skip for redis versions greater than 7.0.0 (#1831)
-    * Documentation updates (#1822)
-    * Add CI action to install package from repository commit hash (#1781) (#1790)
-    * Fix link in lmove docstring (#1793)
-    * Disabling JSON.DEBUG tests (#1787)
-    * Migrated targeted nodes to kwargs in Cluster Mode (#1762)
-    * Added support for MONITOR in clusters (#1756)
-    * Adding ROLE Command (#1610)
-    * Integrate RedisBloom support (#1683)
-    * Adding RedisGraph support (#1556)
-    * Allow overriding connection class via keyword arguments (#1752)
-    * Aggregation LOAD * support for RediSearch (#1735)
-    * Adding cluster, bloom, and graph docs (#1779)
-    * Add packaging to setup_requires, and use >= to play nice to setup.py (fixes #1625) (#1780)
-    * Fixing the license link in the readme (#1778)
-    * Removing distutils from tests (#1773)
-    * Fix cluster ACL tests (#1774)
-    * Improved RedisCluster's reinitialize_steps and documentation (#1765)
-    * Added black and isort (#1734)
-    * Link Documents for all module commands (#1711)
-    * Pyupgrade + flynt + f-strings (#1759)
-    * Remove unused aggregation subclasses in RediSearch (#1754)
-    * Adding RedisCluster client to support Redis Cluster Mode (#1660)
-    * Support RediSearch FT.PROFILE command (#1727)
-    * Adding support for non-decodable commands (#1731)
-    * COMMAND GETKEYS support (#1738)
-    * RedisJSON 2.0.4 behaviour support (#1747)
-    * Removing deprecating distutils (PEP 632) (#1730)
-    * Updating PR template (#1745)
-    * Removing duplication of Script class (#1751)
-    * Splitting documentation for read the docs (#1743)
-    * Improve code coverage for aggregation tests (#1713)
-    * Fixing COMMAND GETKEYS tests (#1750)
-    * GitHub release improvements (#1684)
+  * OCSP stapling support (#1820)
+  * Support for SELECT (#1825)
+  * Support for specifying error types with retry (#1817)
+  * Support for RESET command since Redis 6.2.0 (#1824)
+  * Support CLIENT TRACKING (#1612)
+  * Support WRITE in CLIENT PAUSE (#1549)
+  * JSON set_file and set_path support (#1818)
+  * Allow ssl_ca_path with rediss:// urls (#1814)
+  * Support for password-encrypted SSL private keys (#1782)
+  * Support SYNC and PSYNC (#1741)
+  * Retry on error exception and timeout fixes (#1821)
+  * Fixing read race condition during pubsub (#1737)
+  * Fixing exception in listen (#1823)
+  * Fixed MovedError, and stopped iterating through startup nodes when slots are fully covered (#1819)
+  * Socket not closing after server disconnect (#1797)
+  * Single sourcing the package version (#1791)
+  * Ensure redis_connect_func is set on uds connection (#1794)
+  * SRTALGO - Skip for redis versions greater than 7.0.0 (#1831)
+  * Documentation updates (#1822)
+  * Add CI action to install package from repository commit hash (#1781) (#1790)
+  * Fix link in lmove docstring (#1793)
+  * Disabling JSON.DEBUG tests (#1787)
+  * Migrated targeted nodes to kwargs in Cluster Mode (#1762)
+  * Added support for MONITOR in clusters (#1756)
+  * Adding ROLE Command (#1610)
+  * Integrate RedisBloom support (#1683)
+  * Adding RedisGraph support (#1556)
+  * Allow overriding connection class via keyword arguments (#1752)
+  * Aggregation LOAD * support for RediSearch (#1735)
+  * Adding cluster, bloom, and graph docs (#1779)
+  * Add packaging to setup_requires, and use >= to play nice to setup.py (fixes #1625) (#1780)
+  * Fixing the license link in the readme (#1778)
+  * Removing distutils from tests (#1773)
+  * Fix cluster ACL tests (#1774)
+  * Improved RedisCluster's reinitialize_steps and documentation (#1765)
+  * Added black and isort (#1734)
+  * Link Documents for all module commands (#1711)
+  * Pyupgrade + flynt + f-strings (#1759)
+  * Remove unused aggregation subclasses in RediSearch (#1754)
+  * Adding RedisCluster client to support Redis Cluster Mode (#1660)
+  * Support RediSearch FT.PROFILE command (#1727)
+  * Adding support for non-decodable commands (#1731)
+  * COMMAND GETKEYS support (#1738)
+  * RedisJSON 2.0.4 behaviour support (#1747)
+  * Removing deprecating distutils (PEP 632) (#1730)
+  * Updating PR template (#1745)
+  * Removing duplication of Script class (#1751)
+  * Splitting documentation for read the docs (#1743)
+  * Improve code coverage for aggregation tests (#1713)
+  * Fixing COMMAND GETKEYS tests (#1750)
+  * GitHub release improvements (#1684)
 * 4.0.2 (Nov 22, 2021)
-    * Restoring Sentinel commands to redis client (#1723)
-    * Better removal of hiredis warning (#1726)
-    * Adding links to redis documents in function calls (#1719)
+  * Restoring Sentinel commands to redis client (#1723)
+  * Better removal of hiredis warning (#1726)
+  * Adding links to redis documents in function calls (#1719)
 * 4.0.1 (Nov 17, 2021)
-    * Removing command on initial connections (#1722)
-    * Removing hiredis warning when not installed (#1721)
+  * Removing command on initial connections (#1722)
+  * Removing hiredis warning when not installed (#1721)
 * 4.0.0 (Nov 15, 2021)
-    * FT.EXPLAINCLI intentionally raising NotImplementedError
-    * Restoring ZRANGE desc for Redis < 6.2.0 (#1697)
-    * Response parsing occasionally fails to parse floats (#1692)
-    * Re-enabling read-the-docs (#1707)
-    * Call HSET after FT.CREATE to avoid keyspace scan (#1706)
-    * Unit tests fixes for compatibility (#1703)
-    * Improve documentation about Locks (#1701)
-    * Fixes to allow --redis-url to pass through all tests (#1700)
-    * Fix unit tests running against Redis 4.0.0 (#1699)
-    * Search alias test fix (#1695)
-    * Adding RediSearch/RedisJSON tests (#1691)
-    * Updating codecov rules (#1689)
-    * Tests to validate custom JSON decoders (#1681)
-    * Added breaking icon to release drafter (#1702)
-    * Removing dependency on six (#1676)
-    * Re-enable pipeline support for JSON and TimeSeries (#1674)
-    * Export Sentinel, and SSL like other classes (#1671)
-    * Restore zrange functionality for older versions of Redis (#1670)
-    * Fixed garbage collection deadlock (#1578)
-    * Tests to validate built python packages (#1678)
-    * Sleep for flaky search test (#1680)
-    * Test function renames, to match standards (#1679)
-    * Docstring improvements for Redis class (#1675)
-    * Fix georadius tests (#1672)
-    * Improvements to JSON coverage (#1666)
-    * Add python_requires setuptools check for python > 3.6 (#1656)
-    * SMISMEMBER support (#1667)
-    * Exposing the module version in loaded_modules (#1648)
-    * RedisTimeSeries support (#1652)
-    * Support for json multipath ($) (#1663)
-    * Added boolean parsing to PEXPIRE and PEXPIREAT (#1665)
-    * Add python_requires setuptools check for python > 3.6 (#1656)
-    * Adding vulture for static analysis (#1655)
-    * Starting to clean the docs (#1657)
-    * Update README.md (#1654)
-    * Adding description format for package (#1651)
-    * Publish to pypi as releases are generated with the release drafter (#1647)
-    * Restore actions to prs (#1653)
-    * Fixing the package to include commands (#1649)
-    * Re-enabling codecov as part of CI process (#1646)
-    * Adding support for redisearch (#1640) Thanks @chayim
-    * redisjson support (#1636) Thanks @chayim
-    * Sentinel: Add SentinelManagedSSLConnection (#1419) Thanks @AbdealiJK
-    * Enable floating parameters in SET (ex and px) (#1635) Thanks @AvitalFineRedis
-    * Add warning when hiredis not installed. Recommend installation. (#1621) Thanks @adiamzn
-    * Raising NotImplementedError for SCRIPT DEBUG and DEBUG SEGFAULT (#1624) Thanks @chayim
-    * CLIENT REDIR command support (#1623) Thanks @chayim
-    * REPLICAOF command implementation (#1622) Thanks @chayim
-    * Add support to NX XX and CH to GEOADD (#1605) Thanks @AvitalFineRedis
-    * Add support to ZRANGE and ZRANGESTORE parameters (#1603) Thanks @AvitalFineRedis
-    * Pre 6.2 redis should default to None for script flush (#1641) Thanks @chayim
-    * Add FULL option to XINFO SUMMARY (#1638) Thanks @agusdmb
-    * Geosearch test should use any=True (#1594) Thanks @Andrew-Chen-Wang
-    * Removing packaging dependency (#1626) Thanks @chayim
-    * Fix client_kill_filter docs for skimpy (#1596) Thanks @Andrew-Chen-Wang
-    * Normalize minid and maxlen docs (#1593) Thanks @Andrew-Chen-Wang
-    * Update docs for multiple usernames for ACL DELUSER (#1595) Thanks @Andrew-Chen-Wang
-    * Fix grammar of get param in set command (#1588) Thanks @Andrew-Chen-Wang
-    * Fix docs for client_kill_filter (#1584) Thanks @Andrew-Chen-Wang
-    * Convert README & CONTRIBUTING from rst to md (#1633) Thanks @davidylee
-    * Test BYLEX param in zrangestore (#1634) Thanks @AvitalFineRedis
-    * Tox integrations with invoke and docker (#1632) Thanks @chayim
-    * Adding the release drafter to help simplify release notes (#1618). Thanks @chayim
-    * BACKWARDS INCOMPATIBLE: Removed support for end of life Python 2.7. #1318
-    * BACKWARDS INCOMPATIBLE: All values within Redis URLs are unquoted via
+  * FT.EXPLAINCLI intentionally raising NotImplementedError
+  * Restoring ZRANGE desc for Redis < 6.2.0 (#1697)
+  * Response parsing occasionally fails to parse floats (#1692)
+  * Re-enabling read-the-docs (#1707)
+  * Call HSET after FT.CREATE to avoid keyspace scan (#1706)
+  * Unit tests fixes for compatibility (#1703)
+  * Improve documentation about Locks (#1701)
+  * Fixes to allow --redis-url to pass through all tests (#1700)
+  * Fix unit tests running against Redis 4.0.0 (#1699)
+  * Search alias test fix (#1695)
+  * Adding RediSearch/RedisJSON tests (#1691)
+  * Updating codecov rules (#1689)
+  * Tests to validate custom JSON decoders (#1681)
+  * Added breaking icon to release drafter (#1702)
+  * Removing dependency on six (#1676)
+  * Re-enable pipeline support for JSON and TimeSeries (#1674)
+  * Export Sentinel, and SSL like other classes (#1671)
+  * Restore zrange functionality for older versions of Redis (#1670)
+  * Fixed garbage collection deadlock (#1578)
+  * Tests to validate built python packages (#1678)
+  * Sleep for flaky search test (#1680)
+  * Test function renames, to match standards (#1679)
+  * Docstring improvements for Redis class (#1675)
+  * Fix georadius tests (#1672)
+  * Improvements to JSON coverage (#1666)
+  * Add python_requires setuptools check for python > 3.6 (#1656)
+  * SMISMEMBER support (#1667)
+  * Exposing the module version in loaded_modules (#1648)
+  * RedisTimeSeries support (#1652)
+  * Support for json multipath ($) (#1663)
+  * Added boolean parsing to PEXPIRE and PEXPIREAT (#1665)
+  * Add python_requires setuptools check for python > 3.6 (#1656)
+  * Adding vulture for static analysis (#1655)
+  * Starting to clean the docs (#1657)
+  * Update README.md (#1654)
+  * Adding description format for package (#1651)
+  * Publish to pypi as releases are generated with the release drafter (#1647)
+  * Restore actions to prs (#1653)
+  * Fixing the package to include commands (#1649)
+  * Re-enabling codecov as part of CI process (#1646)
+  * Adding support for redisearch (#1640) Thanks @chayim
+  * redisjson support (#1636) Thanks @chayim
+  * Sentinel: Add SentinelManagedSSLConnection (#1419) Thanks @AbdealiJK
+  * Enable floating parameters in SET (ex and px) (#1635) Thanks @AvitalFineRedis
+  * Add warning when hiredis not installed. Recommend installation. (#1621) Thanks @adiamzn
+  * Raising NotImplementedError for SCRIPT DEBUG and DEBUG SEGFAULT (#1624) Thanks @chayim
+  * CLIENT REDIR command support (#1623) Thanks @chayim
+  * REPLICAOF command implementation (#1622) Thanks @chayim
+  * Add support to NX XX and CH to GEOADD (#1605) Thanks @AvitalFineRedis
+  * Add support to ZRANGE and ZRANGESTORE parameters (#1603) Thanks @AvitalFineRedis
+  * Pre 6.2 redis should default to None for script flush (#1641) Thanks @chayim
+  * Add FULL option to XINFO SUMMARY (#1638) Thanks @agusdmb
+  * Geosearch test should use any=True (#1594) Thanks @Andrew-Chen-Wang
+  * Removing packaging dependency (#1626) Thanks @chayim
+  * Fix client_kill_filter docs for skimpy (#1596) Thanks @Andrew-Chen-Wang
+  * Normalize minid and maxlen docs (#1593) Thanks @Andrew-Chen-Wang
+  * Update docs for multiple usernames for ACL DELUSER (#1595) Thanks @Andrew-Chen-Wang
+  * Fix grammar of get param in set command (#1588) Thanks @Andrew-Chen-Wang
+  * Fix docs for client_kill_filter (#1584) Thanks @Andrew-Chen-Wang
+  * Convert README & CONTRIBUTING from rst to md (#1633) Thanks @davidylee
+  * Test BYLEX param in zrangestore (#1634) Thanks @AvitalFineRedis
+  * Tox integrations with invoke and docker (#1632) Thanks @chayim
+  * Adding the release drafter to help simplify release notes (#1618). Thanks @chayim
+  * BACKWARDS INCOMPATIBLE: Removed support for end of life Python 2.7. #1318
+  * BACKWARDS INCOMPATIBLE: All values within Redis URLs are unquoted via
       urllib.parse.unquote. Prior versions of redis-py supported this by
       specifying the ``decode_components`` flag to the ``from_url`` functions.
       This is now done by default and cannot be disabled. #589
-    * POTENTIALLY INCOMPATIBLE: Redis commands were moved into a mixin
+  * POTENTIALLY INCOMPATIBLE: Redis commands were moved into a mixin
       (see commands.py). Anyone importing ``redis.client`` to access commands
       directly should import ``redis.commands``. #1534, #1550
-    * Removed technical debt on REDIS_6_VERSION placeholder. Thanks @chayim #1582.
-    * Various docus fixes. Thanks @Andrew-Chen-Wang #1585, #1586.
-    * Support for LOLWUT command, available since Redis 5.0.0.
+  * Removed technical debt on REDIS_6_VERSION placeholder. Thanks @chayim #1582.
+  * Various docus fixes. Thanks @Andrew-Chen-Wang #1585, #1586.
+  * Support for LOLWUT command, available since Redis 5.0.0.
       Thanks @brainix #1568.
-    * Added support for CLIENT REPLY, available in Redis 3.2.0.
+  * Added support for CLIENT REPLY, available in Redis 3.2.0.
       Thanks @chayim #1581.
-    * Support for Auto-reconnect PubSub on get_message. Thanks @luhn #1574.
-    * Fix RST syntax error in README/ Thanks @JanCBrammer #1451.
-    * IDLETIME and FREQ support for RESTORE. Thanks @chayim #1580.
-    * Supporting args with MODULE LOAD. Thanks @chayim #1579.
-    * Updating RedisLabs with Redis. Thanks @gkorland #1575.
-    * Added support for ASYNC to SCRIPT FLUSH available in Redis 6.2.0.
+  * Support for Auto-reconnect PubSub on get_message. Thanks @luhn #1574.
+  * Fix RST syntax error in README/ Thanks @JanCBrammer #1451.
+  * IDLETIME and FREQ support for RESTORE. Thanks @chayim #1580.
+  * Supporting args with MODULE LOAD. Thanks @chayim #1579.
+  * Updating RedisLabs with Redis. Thanks @gkorland #1575.
+  * Added support for ASYNC to SCRIPT FLUSH available in Redis 6.2.0.
       Thanks @chayim. #1567
-    * Added CLIENT LIST fix to support multiple client ids available in
+  * Added CLIENT LIST fix to support multiple client ids available in
       Redis 2.8.12. Thanks @chayim #1563.
-    * Added DISCARD support for pipelines available in Redis 2.0.0.
+  * Added DISCARD support for pipelines available in Redis 2.0.0.
       Thanks @chayim #1565.
-    * Added ACL DELUSER support for deleting lists of users available in
+  * Added ACL DELUSER support for deleting lists of users available in
       Redis 6.2.0. Thanks @chayim. #1562
-    * Added CLIENT TRACKINFO support available in Redis 6.2.0.
+  * Added CLIENT TRACKINFO support available in Redis 6.2.0.
       Thanks @chayim. #1560
-    * Added GEOSEARCH and GEOSEARCHSTORE support available in Redis 6.2.0.
+  * Added GEOSEARCH and GEOSEARCHSTORE support available in Redis 6.2.0.
       Thanks @AvitalFine Redis. #1526
-    * Added LPUSHX support for lists available in Redis 4.0.0.
+  * Added LPUSHX support for lists available in Redis 4.0.0.
       Thanks @chayim. #1559
-    * Added support for QUIT available in Redis 1.0.0.
+  * Added support for QUIT available in Redis 1.0.0.
       Thanks @chayim. #1558
-    * Added support for COMMAND COUNT available in Redis 2.8.13.
+  * Added support for COMMAND COUNT available in Redis 2.8.13.
       Thanks @chayim. #1554.
-    * Added CREATECONSUMER support for XGROUP available in Redis 6.2.0.
+  * Added CREATECONSUMER support for XGROUP available in Redis 6.2.0.
       Thanks @AvitalFineRedis. #1553
-    * Including slowly complexity in INFO if available.
+  * Including slowly complexity in INFO if available.
       Thanks @ian28223 #1489.
-    * Added support for STRALGO available in Redis 6.0.0.
+  * Added support for STRALGO available in Redis 6.0.0.
       Thanks @AvitalFineRedis. #1528
-    * Addes support for ZMSCORE available in Redis 6.2.0.
+  * Addes support for ZMSCORE available in Redis 6.2.0.
       Thanks @2014BDuck and @jiekun.zhu. #1437
-    * Support MINID and LIMIT on XADD available in Redis 6.2.0.
+  * Support MINID and LIMIT on XADD available in Redis 6.2.0.
       Thanks @AvitalFineRedis. #1548
-    * Added sentinel commands FLUSHCONFIG, CKQUORUM, FAILOVER, and RESET
+  * Added sentinel commands FLUSHCONFIG, CKQUORUM, FAILOVER, and RESET
       available in Redis 2.8.12.
       Thanks @otherpirate. #834
-    * Migrated Version instead of StrictVersion for Python 3.10.
+  * Migrated Version instead of StrictVersion for Python 3.10.
       Thanks @tirkarthi. #1552
-    * Added retry mechanism with backoff. Thanks @nbraun-amazon. #1494
-    * Migrated commands to a mixin. Thanks @chayim. #1534
-    * Added support for ZUNION, available in Redis 6.2.0. Thanks
+  * Added retry mechanism with backoff. Thanks @nbraun-amazon. #1494
+  * Migrated commands to a mixin. Thanks @chayim. #1534
+  * Added support for ZUNION, available in Redis 6.2.0. Thanks
       @AvitalFineRedis. #1522
-    * Added support for CLIENT LIST with ID, available in Redis 6.2.0.
+  * Added support for CLIENT LIST with ID, available in Redis 6.2.0.
       Thanks @chayim. #1505
-    * Added support for MINID and LIMIT with xtrim, available in Reds 6.2.0.
+  * Added support for MINID and LIMIT with xtrim, available in Reds 6.2.0.
       Thanks @chayim. #1508
-    * Implemented LMOVE and BLMOVE commands, available in Redis 6.2.0.
+  * Implemented LMOVE and BLMOVE commands, available in Redis 6.2.0.
       Thanks @chayim. #1504
-    * Added GET argument to SET command, available in Redis 6.2.0.
+  * Added GET argument to SET command, available in Redis 6.2.0.
       Thanks @2014BDuck. #1412
-    * Documentation fixes. Thanks @enjoy-binbin @jonher937. #1496 #1532
-    * Added support for XAUTOCLAIM, available in Redis 6.2.0.
+  * Documentation fixes. Thanks @enjoy-binbin @jonher937. #1496 #1532
+  * Added support for XAUTOCLAIM, available in Redis 6.2.0.
       Thanks @AvitalFineRedis. #1529
-    * Added IDLE support for XPENDING, available in Redis 6.2.0.
+  * Added IDLE support for XPENDING, available in Redis 6.2.0.
       Thanks @AvitalFineRedis. #1523
-    * Add a count parameter to lpop/rpop, available in Redis 6.2.0.
+  * Add a count parameter to lpop/rpop, available in Redis 6.2.0.
       Thanks @wavenator. #1487
-    * Added a (pypy) trove classifier for Python 3.9.
+  * Added a (pypy) trove classifier for Python 3.9.
       Thanks @D3X. #1535
-    * Added ZINTER support, available in Redis 6.2.0.
+  * Added ZINTER support, available in Redis 6.2.0.
       Thanks @AvitalFineRedis. #1520
-    * Added ZINTER support, available in Redis 6.2.0.
+  * Added ZINTER support, available in Redis 6.2.0.
       Thanks @AvitalFineRedis. #1520
-    * Added ZDIFF and ZDIFFSTORE support, available in Redis 6.2.0.
+  * Added ZDIFF and ZDIFFSTORE support, available in Redis 6.2.0.
       Thanks @AvitalFineRedis. #1518
-    * Added ZRANGESTORE support, available in Redis 6.2.0.
+  * Added ZRANGESTORE support, available in Redis 6.2.0.
       Thanks @AvitalFineRedis. #1521
-    * Added LT and GT support for ZADD, available in Redis 6.2.0.
+  * Added LT and GT support for ZADD, available in Redis 6.2.0.
       Thanks @chayim. #1509
-    * Added ZRANDMEMBER support, available in Redis 6.2.0.
+  * Added ZRANDMEMBER support, available in Redis 6.2.0.
       Thanks @AvitalFineRedis. #1519
-    * Added GETDEL support, available in Redis 6.2.0.
+  * Added GETDEL support, available in Redis 6.2.0.
       Thanks @AvitalFineRedis. #1514
-    * Added CLIENT KILL laddr filter, available in Redis 6.2.0.
+  * Added CLIENT KILL laddr filter, available in Redis 6.2.0.
       Thanks @chayim. #1506
-    * Added CLIENT UNPAUSE, available in Redis 6.2.0.
+  * Added CLIENT UNPAUSE, available in Redis 6.2.0.
       Thanks @chayim. #1512
-    * Added NOMKSTREAM support for XADD, available in Redis 6.2.0.
+  * Added NOMKSTREAM support for XADD, available in Redis 6.2.0.
       Thanks @chayim. #1507
-    * Added HRANDFIELD support, available in Redis 6.2.0.
+  * Added HRANDFIELD support, available in Redis 6.2.0.
       Thanks @AvitalFineRedis. #1513
-    * Added CLIENT INFO support, available in Redis 6.2.0.
+  * Added CLIENT INFO support, available in Redis 6.2.0.
       Thanks @AvitalFineRedis. #1517
-    * Added GETEX support, available in Redis 6.2.0.
+  * Added GETEX support, available in Redis 6.2.0.
       Thanks @AvitalFineRedis. #1515
-    * Added support for COPY command, available in Redis 6.2.0.
+  * Added support for COPY command, available in Redis 6.2.0.
       Thanks @malinaa96. #1492
-    * Provide a development and testing environment via docker. Thanks
+  * Provide a development and testing environment via docker. Thanks
       @abrookins. #1365
-    * Added support for the LPOS command available in Redis 6.0.6. Thanks
+  * Added support for the LPOS command available in Redis 6.0.6. Thanks
       @aparcar #1353/#1354
-    * Added support for the ACL LOG command available in Redis 6. Thanks
+  * Added support for the ACL LOG command available in Redis 6. Thanks
       @2014BDuck. #1307
-    * Added support for ABSTTL option of the RESTORE command available in
+  * Added support for ABSTTL option of the RESTORE command available in
       Redis 5.0. Thanks @charettes. #1423
 * 3.5.3 (June 1, 2020)
-    * Restore try/except clauses to __del__ methods. These will be removed
+  * Restore try/except clauses to __del__ methods. These will be removed
       in 4.0 when more explicit resource management if enforced. #1339
-    * Update the master_address when Sentinels promote a new master. #847
-    * Update SentinelConnectionPool to not forcefully disconnect other in-use
+  * Update the master_address when Sentinels promote a new master. #847
+  * Update SentinelConnectionPool to not forcefully disconnect other in-use
       connections which can negatively affect threaded applications. #1345
 * 3.5.2 (May 14, 2020)
-    * Tune the locking in ConnectionPool.get_connection so that the lock is
+  * Tune the locking in ConnectionPool.get_connection so that the lock is
       not held while waiting for the socket to establish and validate the
       TCP connection.
 * 3.5.1 (May 9, 2020)
-    * Fix for HSET argument validation to allow any non-None key. Thanks
+  * Fix for HSET argument validation to allow any non-None key. Thanks
       @AleksMat, #1337, #1341
 * 3.5.0 (April 29, 2020)
-    * Removed exception trapping from __del__ methods. redis-py objects that
+  * Removed exception trapping from __del__ methods. redis-py objects that
       hold various resources implement __del__ cleanup methods to release
       those resources when the object goes out of scope. This provides a
       fallback for when these objects aren't explicitly closed by user code.
       Prior to this change any errors encountered in closing these resources
       would be hidden from the user. Thanks @jdufresne. #1281
-    * Expanded support for connection strings specifying a username connecting
+  * Expanded support for connection strings specifying a username connecting
       to pre-v6 servers. #1274
-    * Optimized Lock's blocking_timeout and sleep. If the lock cannot be
+  * Optimized Lock's blocking_timeout and sleep. If the lock cannot be
       acquired and the sleep value would cause the loop to sleep beyond
       blocking_timeout, fail immediately. Thanks @clslgrnc. #1263
-    * Added support for passing Python memoryviews to Redis command args that
+  * Added support for passing Python memoryviews to Redis command args that
       expect strings or bytes. The memoryview instance is sent directly to
       the socket such that there are zero copies made of the underlying data
       during command packing. Thanks @Cody-G. #1265, #1285
-    * HSET command now can accept multiple pairs. HMSET has been marked as
+  * HSET command now can accept multiple pairs. HMSET has been marked as
       deprecated now. Thanks to @laixintao #1271
-    * Don't manually DISCARD when encountering an ExecAbortError.
+  * Don't manually DISCARD when encountering an ExecAbortError.
       Thanks @nickgaya, #1300/#1301
-    * Reset the watched state of pipelines after calling exec. This saves
+  * Reset the watched state of pipelines after calling exec. This saves
       a roundtrip to the server by not having to call UNWATCH within
       Pipeline.reset(). Thanks @nickgaya, #1299/#1302
-    * Added the KEEPTTL option for the SET command. Thanks
+  * Added the KEEPTTL option for the SET command. Thanks
       @laixintao #1304/#1280
-    * Added the MEMORY STATS command. #1268
-    * Lock.extend() now has a new option, `replace_ttl`. When False (the
+  * Added the MEMORY STATS command. #1268
+  * Lock.extend() now has a new option, `replace_ttl`. When False (the
       default), Lock.extend() adds the `additional_time` to the lock's existing
       TTL. When replace_ttl=True, the lock's existing TTL is replaced with
       the value of `additional_time`.
-    * Add testing and support for PyPy.
+  * Add testing and support for PyPy.
 * 3.4.1
-    * Move the username argument in the Redis and Connection classes to the
+  * Move the username argument in the Redis and Connection classes to the
       end of the argument list. This helps those poor souls that specify all
       their connection options as non-keyword arguments. #1276
-    * Prior to ACL support, redis-py ignored the username component of
+  * Prior to ACL support, redis-py ignored the username component of
       Connection URLs. With ACL support, usernames are no longer ignored and
       are used to authenticate against an ACL rule. Some cloud vendors with
       managed Redis instances (like Heroku) provide connection URLs with a
@@ -378,33 +378,33 @@
       username to Redis servers < 6.0.0 results in an error. Attempt to detect
       this condition and retry the AUTH command with only the password such
       that authentication continues to work for these users. #1274
-    * Removed the __eq__ hooks to Redis and ConnectionPool that were added
+  * Removed the __eq__ hooks to Redis and ConnectionPool that were added
       in 3.4.0. This ended up being a bad idea as two separate connection
       pools be considered equal yet manage a completely separate set of
       connections.
 * 3.4.0
-    * Allow empty pipelines to be executed if there are WATCHed keys.
+  * Allow empty pipelines to be executed if there are WATCHed keys.
       This is a convenient way to test if any of the watched keys changed
       without actually running any other commands. Thanks @brianmaissy.
       #1233, #1234
-    * Removed support for end of life Python 3.4.
-    * Added support for all ACL commands in Redis 6. Thanks @IAmATeaPot418
+  * Removed support for end of life Python 3.4.
+  * Added support for all ACL commands in Redis 6. Thanks @IAmATeaPot418
       for helping.
-    * Pipeline instances now always evaluate to True. Prior to this change,
+  * Pipeline instances now always evaluate to True. Prior to this change,
       pipeline instances relied on __len__ for boolean evaluation which
       meant that pipelines with no commands on the stack would be considered
       False. #994
-    * Client instances and Connection pools now support a 'client_name'
+  * Client instances and Connection pools now support a 'client_name'
       argument. If supplied, all connections created will call CLIENT SETNAME
       as soon as the connection is opened. Thanks to @Habbie for supplying
       the basis of this change. #802
-    * Added the 'ssl_check_hostname' argument to specify whether SSL
+  * Added the 'ssl_check_hostname' argument to specify whether SSL
       connections should require the server hostname to match the hostname
       specified in the SSL cert. By default 'ssl_check_hostname' is False
       for backwards compatibility. #1196
-    * Slightly optimized command packing. Thanks @Deneby67. #1255
-    * Added support for the TYPE argument to SCAN. Thanks @netocp. #1220
-    * Better thread and fork safety in ConnectionPool and
+  * Slightly optimized command packing. Thanks @Deneby67. #1255
+  * Added support for the TYPE argument to SCAN. Thanks @netocp. #1220
+  * Better thread and fork safety in ConnectionPool and
       BlockingConnectionPool. Added better locking to synchronize critical
       sections rather than relying on CPython-specific implementation details
       relating to atomic operations. Adjusted how the pools identify and
@@ -412,636 +412,636 @@
       raised by child processes in the very unlikely chance that a deadlock
       is encountered. Thanks @gmbnomis, @mdellweg, @yht804421715. #1270,
       #1138, #1178, #906, #1262
-    * Added __eq__ hooks to the Redis and ConnectionPool classes.
+  * Added __eq__ hooks to the Redis and ConnectionPool classes.
       Thanks @brainix. #1240
 * 3.3.11
-    * Further fix for the SSLError -> TimeoutError mapping to work
+  * Further fix for the SSLError -> TimeoutError mapping to work
       on obscure releases of Python 2.7.
 * 3.3.10
-    * Fixed a potential error handling bug for the SSLError -> TimeoutError
+  * Fixed a potential error handling bug for the SSLError -> TimeoutError
       mapping introduced in 3.3.9. Thanks @zbristow. #1224
 * 3.3.9
-    * Mapped Python 2.7 SSLError to TimeoutError where appropriate. Timeouts
+  * Mapped Python 2.7 SSLError to TimeoutError where appropriate. Timeouts
       should now consistently raise TimeoutErrors on Python 2.7 for both
       unsecured and secured connections. Thanks @zbristow. #1222
 * 3.3.8
-    * Fixed MONITOR parsing to properly parse IPv6 client addresses, unix
+  * Fixed MONITOR parsing to properly parse IPv6 client addresses, unix
       socket connections and commands issued from Lua. Thanks @kukey. #1201
 * 3.3.7
-    * Fixed a regression introduced in 3.3.0 where socket.error exceptions
+  * Fixed a regression introduced in 3.3.0 where socket.error exceptions
       (or subclasses) could potentially be raised instead of
       redis.exceptions.ConnectionError. #1202
 * 3.3.6
-    * Fixed a regression in 3.3.5 that caused PubSub.get_message() to raise
+  * Fixed a regression in 3.3.5 that caused PubSub.get_message() to raise
       a socket.timeout exception when passing a timeout value. #1200
 * 3.3.5
-    * Fix an issue where socket.timeout errors could be handled by the wrong
+  * Fix an issue where socket.timeout errors could be handled by the wrong
       exception handler in Python 2.7.
 * 3.3.4
-    * More specifically identify nonblocking read errors for both SSL and
+  * More specifically identify nonblocking read errors for both SSL and
       non-SSL connections. 3.3.1, 3.3.2 and 3.3.3 on Python 2.7 could
       potentially mask a ConnectionError. #1197
 * 3.3.3
-    * The SSL module in Python < 2.7.9 handles non-blocking sockets
+  * The SSL module in Python < 2.7.9 handles non-blocking sockets
       differently than 2.7.9+. This patch accommodates older versions. #1197
 * 3.3.2
-    * Further fixed a regression introduced in 3.3.0 involving SSL and
+  * Further fixed a regression introduced in 3.3.0 involving SSL and
       non-blocking sockets. #1197
 * 3.3.1
-    * Fixed a regression introduced in 3.3.0 involving SSL and non-blocking
+  * Fixed a regression introduced in 3.3.0 involving SSL and non-blocking
       sockets. #1197
 * 3.3.0
-    * Resolve a race condition with the PubSubWorkerThread. #1150
-    * Cleanup socket read error messages. Thanks Vic Yu. #1159
-    * Cleanup the Connection's selector correctly. Thanks Bruce Merry. #1153
-    * Added a Monitor object to make working with MONITOR output easy.
+  * Resolve a race condition with the PubSubWorkerThread. #1150
+  * Cleanup socket read error messages. Thanks Vic Yu. #1159
+  * Cleanup the Connection's selector correctly. Thanks Bruce Merry. #1153
+  * Added a Monitor object to make working with MONITOR output easy.
       Thanks Roey Prat #1033
-    * Internal cleanup: Removed the legacy Token class which was necessary
+  * Internal cleanup: Removed the legacy Token class which was necessary
       with older version of Python that are no longer supported. #1066
-    * Response callbacks are now case insensitive. This allows users that
+  * Response callbacks are now case insensitive. This allows users that
       call Redis.execute_command() directly to pass lower-case command
       names and still get reasonable responses. #1168
-    * Added support for hiredis-py 1.0.0 encoding error support. This should
+  * Added support for hiredis-py 1.0.0 encoding error support. This should
       make the PythonParser and the HiredisParser behave identically
       when encountering encoding errors. Thanks Brian Candler. #1161/#1162
-    * All authentication errors now properly raise AuthenticationError.
+  * All authentication errors now properly raise AuthenticationError.
       AuthenticationError is now a subclass of ConnectionError, which will
       cause the connection to be disconnected and cleaned up appropriately.
       #923
-    * Add READONLY and READWRITE commands. Thanks @theodesp. #1114
-    * Remove selectors in favor of nonblocking sockets. Selectors had
+  * Add READONLY and READWRITE commands. Thanks @theodesp. #1114
+  * Remove selectors in favor of nonblocking sockets. Selectors had
       issues in some environments including eventlet and gevent. This should
       resolve those issues with no other side effects.
-    * Fixed an issue with XCLAIM and previously claimed but not removed
+  * Fixed an issue with XCLAIM and previously claimed but not removed
       messages. Thanks @thomdask. #1192/#1191
-    * Allow for single connection client instances. These instances
+  * Allow for single connection client instances. These instances
       are not thread safe but offer other benefits including a subtle
       performance increase.
-    * Added extensive health checks that keep the connections lively.
+  * Added extensive health checks that keep the connections lively.
       Passing the "health_check_interval=N" option to the Redis client class
       or to a ConnectionPool ensures that a round trip PING/PONG is successful
       before any command if the underlying connection has been idle for more
       than N seconds. ConnectionErrors and TimeoutErrors are automatically
       retried once for health checks.
-    * Changed the PubSubWorkerThread to use a threading.Event object rather
+  * Changed the PubSubWorkerThread to use a threading.Event object rather
       than a boolean to control the thread's life cycle. Thanks Timothy
       Rule. #1194/#1195.
-    * Fixed a bug in Pipeline error handling that would incorrectly retry
+  * Fixed a bug in Pipeline error handling that would incorrectly retry
       ConnectionErrors.
 * 3.2.1
-    * Fix SentinelConnectionPool to work in multiprocess/forked environments.
+  * Fix SentinelConnectionPool to work in multiprocess/forked environments.
 * 3.2.0
-    * Added support for `select.poll` to test whether data can be read
+  * Added support for `select.poll` to test whether data can be read
       on a socket. This should allow for significantly more connections to
       be used with pubsub. Fixes #486/#1115
-    * Attempt to guarantee that the ConnectionPool hands out healthy
+  * Attempt to guarantee that the ConnectionPool hands out healthy
       connections. Healthy connections are those that have an established
       socket connection to the Redis server, are ready to accept a command
       and have no data available to read. Fixes #1127/#886
-    * Use the socket.IPPROTO_TCP constant instead of socket.SOL_TCP.
+  * Use the socket.IPPROTO_TCP constant instead of socket.SOL_TCP.
       IPPROTO_TCP is available on more interpreters (Jython for instance).
       Thanks @Junnplus. #1130
-    * Fixed a regression introduced in 3.0 that mishandles exceptions not
+  * Fixed a regression introduced in 3.0 that mishandles exceptions not
       derived from the base Exception class. KeyboardInterrupt and
       gevent.timeout notable. Thanks Christian Fersch. #1128/#1129
-    * Significant improvements to handing connections with forked processes.
+  * Significant improvements to handing connections with forked processes.
       Parent and child processes no longer trample on each others' connections.
       Thanks to Jay Rolette for the patch and highlighting this issue.
       #504/#732/#784/#863
-    * PythonParser no longer closes the associated connection's socket. The
+  * PythonParser no longer closes the associated connection's socket. The
       connection itself will close the socket. #1108/#1085
 * 3.1.0
-    * Connection URLs must have one of the following schemes:
+  * Connection URLs must have one of the following schemes:
       redis://, rediss://, unix://. Thanks @jdupl123. #961/#969
-    * Fixed an issue with retry_on_timeout logic that caused some TimeoutErrors
+  * Fixed an issue with retry_on_timeout logic that caused some TimeoutErrors
       to be retried. Thanks Aaron Yang. #1022/#1023
-    * Added support for SNI for SSL. Thanks @oridistor and Roey Prat. #1087
-    * Fixed ConnectionPool repr for pools with no connections. Thanks
+  * Added support for SNI for SSL. Thanks @oridistor and Roey Prat. #1087
+  * Fixed ConnectionPool repr for pools with no connections. Thanks
       Cody Scott. #1043/#995
-    * Fixed GEOHASH to return a None value when specifying a place that
+  * Fixed GEOHASH to return a None value when specifying a place that
       doesn't exist on the server. Thanks @guybe7. #1126
-    * Fixed XREADGROUP to return an empty dictionary for messages that
+  * Fixed XREADGROUP to return an empty dictionary for messages that
       have been deleted but still exist in the unacknowledged queue. Thanks
       @xeizmendi. #1116
-    * Added an owned method to Lock objects. owned returns a boolean
+  * Added an owned method to Lock objects. owned returns a boolean
       indicating whether the current lock instance still owns the lock.
       Thanks Dave Johansen. #1112
-    * Allow lock.acquire() to accept an optional token argument. If
+  * Allow lock.acquire() to accept an optional token argument. If
       provided, the token argument is used as the unique value used to claim
       the lock. Thankd Dave Johansen. #1112
-    * Added a reacquire method to Lock objects. reacquire attempts to renew
+  * Added a reacquire method to Lock objects. reacquire attempts to renew
       the lock such that the timeout is extended to the same value that the
       lock was initially acquired with. Thanks Ihor Kalnytskyi. #1014
-    * Stream names found within XREAD and XREADGROUP responses now properly
+  * Stream names found within XREAD and XREADGROUP responses now properly
       respect the decode_responses flag.
-    * XPENDING_RANGE now requires the user the specify the min, max and
+  * XPENDING_RANGE now requires the user the specify the min, max and
       count arguments. Newer versions of Redis prevent count from being
       infinite so it's left to the user to specify these values explicitly.
-    * ZADD now returns None when xx=True and incr=True and an element
+  * ZADD now returns None when xx=True and incr=True and an element
       is specified that doesn't exist in the sorted set. This matches
       what the server returns in this case. #1084
-    * Added client_kill_filter that accepts various filters to identify
+  * Added client_kill_filter that accepts various filters to identify
       and kill clients. Thanks Theofanis Despoudis. #1098
-    * Fixed a race condition that occurred when unsubscribing and
+  * Fixed a race condition that occurred when unsubscribing and
       resubscribing to the same channel or pattern in rapid succession.
       Thanks Marcin Raczyński. #764
-    * Added a LockNotOwnedError that is raised when trying to extend or
+  * Added a LockNotOwnedError that is raised when trying to extend or
       release a lock that is no longer owned. This is a subclass of LockError
       so previous code should continue to work as expected. Thanks Joshua
       Harlow. #1095
-    * Fixed a bug in GEORADIUS that forced decoding of places without
+  * Fixed a bug in GEORADIUS that forced decoding of places without
       respecting the decode_responses option. Thanks Bo Bayles. #1082
 * 3.0.1
-    * Fixed regression with UnixDomainSocketConnection caused by 3.0.0.
+  * Fixed regression with UnixDomainSocketConnection caused by 3.0.0.
       Thanks Jyrki Muukkonen
-    * Fixed an issue with the new asynchronous flag on flushdb and flushall.
+  * Fixed an issue with the new asynchronous flag on flushdb and flushall.
       Thanks rogeryen
-    * Updated Lock.locked() method to indicate whether *any* process has
+  * Updated Lock.locked() method to indicate whether *any* process has
       acquired the lock, not just the current one. This is in line with
       the behavior of threading.Lock. Thanks Alan Justino da Silva
 * 3.0.0
   BACKWARDS INCOMPATIBLE CHANGES
-    * When using a Lock as a context manager and the lock fails to be acquired
+  * When using a Lock as a context manager and the lock fails to be acquired
       a LockError is now raised. This prevents the code block inside the
       context manager from being executed if the lock could not be acquired.
-    * Renamed LuaLock to Lock.
-    * Removed the pipeline based Lock implementation in favor of the LuaLock
+  * Renamed LuaLock to Lock.
+  * Removed the pipeline based Lock implementation in favor of the LuaLock
       implementation.
-    * Only bytes, strings and numbers (ints, longs and floats) are acceptable
+  * Only bytes, strings and numbers (ints, longs and floats) are acceptable
       for keys and values. Previously redis-py attempted to cast other types
       to str() and store the result. This caused must confusion and frustration
       when passing boolean values (cast to 'True' and 'False') or None values
       (cast to 'None'). It is now the user's responsibility to cast all
       key names and values to bytes, strings or numbers before passing the
       value to redis-py.
-    * The StrictRedis class has been renamed to Redis. StrictRedis will
+  * The StrictRedis class has been renamed to Redis. StrictRedis will
       continue to exist as an alias of Redis for the foreseeable future.
-    * The legacy Redis client class has been removed. It caused much confusion
+  * The legacy Redis client class has been removed. It caused much confusion
       to users.
-    * ZINCRBY arguments 'value' and 'amount' have swapped order to match the
+  * ZINCRBY arguments 'value' and 'amount' have swapped order to match the
       the Redis server. The new argument order is: keyname, amount, value.
-    * MGET no longer raises an error if zero keys are passed in. Instead an
+  * MGET no longer raises an error if zero keys are passed in. Instead an
       empty list is returned.
-    * MSET and MSETNX now require all keys/values to be specified in a single
+  * MSET and MSETNX now require all keys/values to be specified in a single
       dictionary argument named mapping. This was changed to allow for future
       options to these commands in the future.
-    * ZADD now requires all element names/scores be specified in a single
+  * ZADD now requires all element names/scores be specified in a single
       dictionary argument named mapping. This was required to allow the NX,
       XX, CH and INCR options to be specified.
-    * ssl_cert_reqs now has a default value of 'required' by default. This
+  * ssl_cert_reqs now has a default value of 'required' by default. This
       should make connecting to a remote Redis server over SSL more secure.
       Thanks u2mejc
-    * Removed support for EOL Python 2.6 and 3.3. Thanks jdufresne
+  * Removed support for EOL Python 2.6 and 3.3. Thanks jdufresne
   OTHER CHANGES
-    * Added missing DECRBY command. Thanks derek-dchu
-    * CLUSTER INFO and CLUSTER NODES responses are now properly decoded to
+  * Added missing DECRBY command. Thanks derek-dchu
+  * CLUSTER INFO and CLUSTER NODES responses are now properly decoded to
       strings.
-    * Added a 'locked()' method to Lock objects. This method returns True
+  * Added a 'locked()' method to Lock objects. This method returns True
       if the lock has been acquired and owned by the current process,
       otherwise False.
-    * EXISTS now supports multiple keys. It's return value is now the number
+  * EXISTS now supports multiple keys. It's return value is now the number
       of keys in the list that exist.
-    * Ensure all commands can accept key names as bytes. This fixes issues
+  * Ensure all commands can accept key names as bytes. This fixes issues
       with BLPOP, BRPOP and SORT.
-    * All errors resulting from bad user input are raised as DataError
+  * All errors resulting from bad user input are raised as DataError
       exceptions. DataError is a subclass of RedisError so this should be
       transparent to anyone previously catching these.
-    * Added support for NX, XX, CH and INCR options to ZADD
-    * Added support for the MIGRATE command
-    * Added support for the MEMORY USAGE and MEMORY PURGE commands. Thanks
+  * Added support for NX, XX, CH and INCR options to ZADD
+  * Added support for the MIGRATE command
+  * Added support for the MEMORY USAGE and MEMORY PURGE commands. Thanks
       Itamar Haber
-    * Added support for the 'asynchronous' argument to FLUSHDB and FLUSHALL
+  * Added support for the 'asynchronous' argument to FLUSHDB and FLUSHALL
       commands. Thanks Itamar Haber
-    * Added support for the BITFIELD command. Thanks Charles Leifer and
+  * Added support for the BITFIELD command. Thanks Charles Leifer and
       Itamar Haber
-    * Improved performance on pipeline requests with large chunks of data.
+  * Improved performance on pipeline requests with large chunks of data.
       Thanks tzickel
-    * Fixed test suite to not fail if another client is connected to the
+  * Fixed test suite to not fail if another client is connected to the
       server the tests are running against.
-    * Added support for SWAPDB. Thanks Itamar Haber
-    * Added support for all STREAM commands. Thanks Roey Prat and Itamar Haber
-    * SHUTDOWN now accepts the 'save' and 'nosave' arguments. Thanks
+  * Added support for SWAPDB. Thanks Itamar Haber
+  * Added support for all STREAM commands. Thanks Roey Prat and Itamar Haber
+  * SHUTDOWN now accepts the 'save' and 'nosave' arguments. Thanks
       dwilliams-kenzan
-    * Added support for ZPOPMAX, ZPOPMIN, BZPOPMAX, BZPOPMIN. Thanks
+  * Added support for ZPOPMAX, ZPOPMIN, BZPOPMAX, BZPOPMIN. Thanks
       Itamar Haber
-    * Added support for the 'type' argument in CLIENT LIST. Thanks Roey Prat
-    * Added support for CLIENT PAUSE. Thanks Roey Prat
-    * Added support for CLIENT ID and CLIENT UNBLOCK. Thanks Itamar Haber
-    * GEODIST now returns a None value when referencing a place that does
+  * Added support for the 'type' argument in CLIENT LIST. Thanks Roey Prat
+  * Added support for CLIENT PAUSE. Thanks Roey Prat
+  * Added support for CLIENT ID and CLIENT UNBLOCK. Thanks Itamar Haber
+  * GEODIST now returns a None value when referencing a place that does
       not exist. Thanks qingping209
-    * Added a ping() method to pubsub objects. Thanks krishan-carbon
-    * Fixed a bug with keys in the INFO dict that contained ':' symbols.
+  * Added a ping() method to pubsub objects. Thanks krishan-carbon
+  * Fixed a bug with keys in the INFO dict that contained ':' symbols.
       Thanks mzalimeni
-    * Fixed the select system call retry compatibility with Python 2.x.
+  * Fixed the select system call retry compatibility with Python 2.x.
       Thanks lddubeau
-    * max_connections is now a valid querystring argument for creating
+  * max_connections is now a valid querystring argument for creating
       connection pools from URLs. Thanks mmaslowskicc
-    * Added the UNLINK command. Thanks yozel
-    * Added socket_type option to Connection for configurability.
+  * Added the UNLINK command. Thanks yozel
+  * Added socket_type option to Connection for configurability.
       Thanks garlicnation
-    * Lock.do_acquire now atomically sets acquires the lock and sets the
+  * Lock.do_acquire now atomically sets acquires the lock and sets the
       expire value via set(nx=True, px=timeout). Thanks 23doors
-    * Added 'count' argument to SPOP. Thanks AlirezaSadeghi
-    * Fixed an issue parsing client_list responses that contained an '='.
+  * Added 'count' argument to SPOP. Thanks AlirezaSadeghi
+  * Fixed an issue parsing client_list responses that contained an '='.
       Thanks swilly22
 * 2.10.6
-    * Various performance improvements. Thanks cjsimpson
-    * Fixed a bug with SRANDMEMBER where the behavior for `number=0` did
+  * Various performance improvements. Thanks cjsimpson
+  * Fixed a bug with SRANDMEMBER where the behavior for `number=0` did
       not match the spec. Thanks Alex Wang
-    * Added HSTRLEN command. Thanks Alexander Putilin
-    * Added the TOUCH command. Thanks Anis Jonischkeit
-    * Remove unnecessary calls to the server when registering Lua scripts.
+  * Added HSTRLEN command. Thanks Alexander Putilin
+  * Added the TOUCH command. Thanks Anis Jonischkeit
+  * Remove unnecessary calls to the server when registering Lua scripts.
       Thanks Ben Greenberg
-    * SET's EX and PX arguments now allow values of zero. Thanks huangqiyin
-    * Added PUBSUB {CHANNELS, NUMPAT, NUMSUB} commands. Thanks Angus Pearson
-    * PubSub connections that encounter `InterruptedError`s now
+  * SET's EX and PX arguments now allow values of zero. Thanks huangqiyin
+  * Added PUBSUB {CHANNELS, NUMPAT, NUMSUB} commands. Thanks Angus Pearson
+  * PubSub connections that encounter `InterruptedError`s now
       retry automatically. Thanks Carlton Gibson and Seth M. Larson
-    * LPUSH and RPUSH commands run on PyPy now correctly returns the number
+  * LPUSH and RPUSH commands run on PyPy now correctly returns the number
       of items of the list. Thanks Jeong YunWon
-    * Added support to automatically retry socket EINTR errors. Thanks
+  * Added support to automatically retry socket EINTR errors. Thanks
       Thomas Steinacher
-    * PubSubWorker threads started with `run_in_thread` are now daemonized
+  * PubSubWorker threads started with `run_in_thread` are now daemonized
       so the thread shuts down when the running process goes away. Thanks
       Keith Ainsworth
-    * Added support for GEO commands. Thanks Pau Freixes, Alex DeBrie and
+  * Added support for GEO commands. Thanks Pau Freixes, Alex DeBrie and
       Abraham Toriz
-    * Made client construction from URLs smarter. Thanks Tim Savage
-    * Added support for CLUSTER * commands. Thanks Andy Huang
-    * The RESTORE command now accepts an optional `replace` boolean.
+  * Made client construction from URLs smarter. Thanks Tim Savage
+  * Added support for CLUSTER * commands. Thanks Andy Huang
+  * The RESTORE command now accepts an optional `replace` boolean.
       Thanks Yoshinari Takaoka
-    * Attempt to connect to a new Sentinel if a TimeoutError occurs. Thanks
+  * Attempt to connect to a new Sentinel if a TimeoutError occurs. Thanks
       Bo Lopker
-    * Fixed a bug in the client's `__getitem__` where a KeyError would be
+  * Fixed a bug in the client's `__getitem__` where a KeyError would be
       raised if the value returned by the server is an empty string.
       Thanks Javier Candeira.
-    * Socket timeouts when connecting to a server are now properly raised
+  * Socket timeouts when connecting to a server are now properly raised
       as TimeoutErrors.
 * 2.10.5
-    * Allow URL encoded parameters in Redis URLs. Characters like a "/" can
+  * Allow URL encoded parameters in Redis URLs. Characters like a "/" can
       now be URL encoded and redis-py will correctly decode them. Thanks
       Paul Keene.
-    * Added support for the WAIT command. Thanks https://github.com/eshizhan
-    * Better shutdown support for the PubSub Worker Thread. It now properly
+  * Added support for the WAIT command. Thanks <https://github.com/eshizhan>
+  * Better shutdown support for the PubSub Worker Thread. It now properly
       cleans up the connection, unsubscribes from any channels and patterns
       previously subscribed to and consumes any waiting messages on the socket.
-    * Added the ability to sleep for a brief period in the event of a
+  * Added the ability to sleep for a brief period in the event of a
       WatchError occurring. Thanks Joshua Harlow.
-    * Fixed a bug with pipeline error reporting when dealing with characters
+  * Fixed a bug with pipeline error reporting when dealing with characters
       in error messages that could not be encoded to the connection's
       character set. Thanks Hendrik Muhs.
-    * Fixed a bug in Sentinel connections that would inadvertently connect
+  * Fixed a bug in Sentinel connections that would inadvertently connect
       to the master when the connection pool resets. Thanks
-      https://github.com/df3n5
-    * Better timeout support in Pubsub get_message. Thanks Andy Isaacson.
-    * Fixed a bug with the HiredisParser that would cause the parser to
+      <https://github.com/df3n5>
+  * Better timeout support in Pubsub get_message. Thanks Andy Isaacson.
+  * Fixed a bug with the HiredisParser that would cause the parser to
       get stuck in an endless loop if a specific number of bytes were
       delivered from the socket. This fix also increases performance of
       parsing large responses from the Redis server.
-    * Added support for ZREVRANGEBYLEX.
-    * ConnectionErrors are now raised if Redis refuses a connection due to
+  * Added support for ZREVRANGEBYLEX.
+  * ConnectionErrors are now raised if Redis refuses a connection due to
       the maxclients limit being exceeded. Thanks Roman Karpovich.
-    * max_connections can now be set when instantiating client instances.
+  * max_connections can now be set when instantiating client instances.
       Thanks Ohad Perry.
 * 2.10.4
     (skipped due to a PyPI snafu)
 * 2.10.3
-    * Fixed a bug with the bytearray support introduced in 2.10.2. Thanks
+  * Fixed a bug with the bytearray support introduced in 2.10.2. Thanks
       Josh Owen.
 * 2.10.2
-    * Added support for Hiredis's new bytearray support. Thanks
-      https://github.com/tzickel
-    * POSSIBLE BACKWARDS INCOMPATIBLE CHANGE: Fixed a possible race condition
+  * Added support for Hiredis's new bytearray support. Thanks
+      <https://github.com/tzickel>
+  * POSSIBLE BACKWARDS INCOMPATIBLE CHANGE: Fixed a possible race condition
       when multiple threads share the same Lock instance with a timeout. Lock
       tokens are now stored in thread local storage by default. If you have
       code that acquires a lock in one thread and passes that lock instance to
       another thread to release it, you need to disable thread local storage.
       Refer to the doc strings on the Lock class about the thread_local
       argument information.
-    * Fixed a regression in from_url where "charset" and "errors" weren't
+  * Fixed a regression in from_url where "charset" and "errors" weren't
       valid options. "encoding" and "encoding_errors" are still accepted
       and preferred.
-    * The "charset" and "errors" options have been deprecated. Passing
+  * The "charset" and "errors" options have been deprecated. Passing
       either to StrictRedis.__init__ or from_url will still work but will
       also emit a DeprecationWarning. Instead use the "encoding" and
       "encoding_errors" options.
-    * Fixed a compatibility bug with Python 3 when the server closes a
+  * Fixed a compatibility bug with Python 3 when the server closes a
       connection.
-    * Added BITPOS command. Thanks https://github.com/jettify.
-    * Fixed a bug when attempting to send large values to Redis in a Pipeline.
+  * Added BITPOS command. Thanks <https://github.com/jettify>.
+  * Fixed a bug when attempting to send large values to Redis in a Pipeline.
 * 2.10.1
-    * Fixed a bug where Sentinel connections to a server that's no longer a
+  * Fixed a bug where Sentinel connections to a server that's no longer a
       master and receives a READONLY error will disconnect and reconnect to
       the master.
 * 2.10.0
-    * Discontinued support for Python 2.5. Upgrade. You'll be happier.
-    * The HiRedis parser will now properly raise ConnectionErrors.
-    * Completely refactored PubSub support. Fixes all known PubSub bugs and
+  * Discontinued support for Python 2.5. Upgrade. You'll be happier.
+  * The HiRedis parser will now properly raise ConnectionErrors.
+  * Completely refactored PubSub support. Fixes all known PubSub bugs and
       adds a bunch of new features. Docs can be found in the README under the
       new "Publish / Subscribe" section.
-    * Added the new HyperLogLog commands (PFADD, PFCOUNT, PFMERGE). Thanks
+  * Added the new HyperLogLog commands (PFADD, PFCOUNT, PFMERGE). Thanks
       Pepijn de Vos and Vincent Ohprecio.
-    * Updated TTL and PTTL commands with Redis 2.8+ semantics. Thanks Markus
+  * Updated TTL and PTTL commands with Redis 2.8+ semantics. Thanks Markus
       Kaiserswerth.
-    * *SCAN commands now return a long (int on Python3) cursor value rather
+  * *SCAN commands now return a long (int on Python3) cursor value rather
       than the string representation. This might be slightly backwards
-      incompatible in code using *SCAN commands loops such as
+incompatible in code using*SCAN commands loops such as
       "while cursor != '0':".
-    * Added extra *SCAN commands that return iterators instead of the normal
+  * Added extra *SCAN commands that return iterators instead of the normal
       [cursor, data] type. Use scan_iter, hscan_iter, sscan_iter, and
       zscan_iter for iterators. Thanks Mathieu Longtin.
-    * Added support for SLOWLOG commands. Thanks Rick van Hattem.
-    * Added lexicographical commands ZRANGEBYLEX, ZREMRANGEBYLEX, and ZLEXCOUNT
+  * Added support for SLOWLOG commands. Thanks Rick van Hattem.
+  * Added lexicographical commands ZRANGEBYLEX, ZREMRANGEBYLEX, and ZLEXCOUNT
       for sorted sets.
-    * Connection objects now support an optional argument, socket_read_size,
+  * Connection objects now support an optional argument, socket_read_size,
       indicating how much data to read during each socket.recv() call. After
       benchmarking, increased the default size to 64k, which dramatically
       improves performance when fetching large values, such as many results
       in a pipeline or a large (>1MB) string value.
-    * Improved the pack_command and send_packed_command functions to increase
+  * Improved the pack_command and send_packed_command functions to increase
       performance when sending large (>1MB) values.
-    * Sentinel Connections to master servers now detect when a READONLY error
+  * Sentinel Connections to master servers now detect when a READONLY error
       is encountered and disconnect themselves and all other active connections
       to the same master so that the new master can be discovered.
-    * Fixed Sentinel state parsing on Python 3.
-    * Added support for SENTINEL MONITOR, SENTINEL REMOVE, and SENTINEL SET
+  * Fixed Sentinel state parsing on Python 3.
+  * Added support for SENTINEL MONITOR, SENTINEL REMOVE, and SENTINEL SET
       commands. Thanks Greg Murphy.
-    * INFO output that doesn't follow the "key:value" format will now be
+  * INFO output that doesn't follow the "key:value" format will now be
       appended to a key named "__raw__" in the INFO dictionary. Thanks Pedro
       Larroy.
-    * The "vagrant" directory contains a complete vagrant environment for
+  * The "vagrant" directory contains a complete vagrant environment for
       redis-py developers. The environment runs a Redis master, a Redis slave,
       and 3 Sentinels. Future iterations of the test suite will incorporate
       more integration style tests, ensuring things like failover happen
       correctly.
-    * It's now possible to create connection pool instances from a URL.
+  * It's now possible to create connection pool instances from a URL.
       StrictRedis.from_url() now uses this feature to create a connection pool
       instance and use that when creating a new client instance. Thanks
-      https://github.com/chillipino
-    * When creating client instances or connection pool instances from an URL,
+      <https://github.com/chillipino>
+  * When creating client instances or connection pool instances from an URL,
       it's now possible to pass additional options to the connection pool with
       querystring arguments.
-    * Fixed a bug where some encodings (like utf-16) were unusable on Python 3
+  * Fixed a bug where some encodings (like utf-16) were unusable on Python 3
       as command names and literals would get encoded.
-    * Added an SSLConnection class that allows for secure connections through
+  * Added an SSLConnection class that allows for secure connections through
       stunnel or other means. Construct an SSL connection with the ssl=True
       option on client classes, using the rediss:// scheme from an URL, or
       by passing the SSLConnection class to a connection pool's
-      connection_class argument. Thanks https://github.com/oranagra.
-    * Added a socket_connect_timeout option to control how long to wait while
+      connection_class argument. Thanks <https://github.com/oranagra>.
+  * Added a socket_connect_timeout option to control how long to wait while
       establishing a TCP connection before timing out. This lets the client
       fail fast when attempting to connect to a downed server while keeping
       a more lenient timeout for all other socket operations.
-    * Added TCP Keep-alive support by passing use the socket_keepalive=True
+  * Added TCP Keep-alive support by passing use the socket_keepalive=True
       option. Finer grain control can be achieved using the
       socket_keepalive_options option which expects a dictionary with any of
       the keys (socket.TCP_KEEPIDLE, socket.TCP_KEEPCNT, socket.TCP_KEEPINTVL)
       and integers for values. Thanks Yossi Gottlieb.
-    * Added a `retry_on_timeout` option that controls how socket.timeout errors
+  * Added a `retry_on_timeout` option that controls how socket.timeout errors
       are handled. By default it is set to False and will cause the client to
       raise a TimeoutError anytime a socket.timeout is encountered. If
       `retry_on_timeout` is set to True, the client will retry a command that
       timed out once like other `socket.error`s.
-    * Completely refactored the Lock system. There is now a LuaLock class
+  * Completely refactored the Lock system. There is now a LuaLock class
       that's used when the Redis server is capable of running Lua scripts along
       with a fallback class for Redis servers < 2.6. The new locks fix several
       subtle race consider that the old lock could face. In additional, a
       new method, "extend" is available on lock instances that all a lock
       owner to extend the amount of time they have the lock for. Thanks to
-      Eli Finkelshteyn and https://github.com/chillipino for contributions.
+      Eli Finkelshteyn and <https://github.com/chillipino> for contributions.
 * 2.9.1
-    * IPv6 support. Thanks https://github.com/amashinchi
+  * IPv6 support. Thanks <https://github.com/amashinchi>
 * 2.9.0
-    * Performance improvement for packing commands when using the PythonParser.
+  * Performance improvement for packing commands when using the PythonParser.
       Thanks Guillaume Viot.
-    * Executing an empty pipeline transaction no longer sends MULTI/EXEC to
+  * Executing an empty pipeline transaction no longer sends MULTI/EXEC to
       the server. Thanks EliFinkelshteyn.
-    * Errors when authenticating (incorrect password) and selecting a database
+  * Errors when authenticating (incorrect password) and selecting a database
       now close the socket.
-    * Full Sentinel support thanks to Vitja Makarov. Thanks!
-    * Better repr support for client and connection pool instances. Thanks
+  * Full Sentinel support thanks to Vitja Makarov. Thanks!
+  * Better repr support for client and connection pool instances. Thanks
       Mark Roberts.
-    * Error messages that the server sends to the client are now included
+  * Error messages that the server sends to the client are now included
       in the client error message. Thanks Sangjin Lim.
-    * Added the SCAN, SSCAN, HSCAN, and ZSCAN commands. Thanks Jingchao Hu.
-    * ResponseErrors generated by pipeline execution provide addition context
+  * Added the SCAN, SSCAN, HSCAN, and ZSCAN commands. Thanks Jingchao Hu.
+  * ResponseErrors generated by pipeline execution provide addition context
       including the position of the command in the pipeline and the actual
       command text generated the error.
-    * ConnectionPools now play nicer in threaded environments that fork. Thanks
+  * ConnectionPools now play nicer in threaded environments that fork. Thanks
       Christian Joergensen.
 * 2.8.0
-    * redis-py should play better with gevent when a gevent Timeout is raised.
+  * redis-py should play better with gevent when a gevent Timeout is raised.
       Thanks leifkb.
-    * Added SENTINEL command. Thanks Anna Janackova.
-    * Fixed a bug where pipelines could potentially corrupt a connection
+  * Added SENTINEL command. Thanks Anna Janackova.
+  * Fixed a bug where pipelines could potentially corrupt a connection
       if the MULTI command generated a ResponseError. Thanks EliFinkelshteyn
       for the report.
-    * Connections now call socket.shutdown() prior to socket.close() to
+  * Connections now call socket.shutdown() prior to socket.close() to
       ensure communication ends immediately per the note at
-      https://docs.python.org/2/library/socket.html#socket.socket.close
+      <https://docs.python.org/2/library/socket.html#socket.socket.close>
       Thanks to David Martin for pointing this out.
-    * Lock checks are now based on floats rather than ints. Thanks
+  * Lock checks are now based on floats rather than ints. Thanks
       Vitja Makarov.
 * 2.7.6
-    * Added CONFIG RESETSTAT command. Thanks Yossi Gottlieb.
-    * Fixed a bug introduced in 2.7.3 that caused issues with script objects
+  * Added CONFIG RESETSTAT command. Thanks Yossi Gottlieb.
+  * Fixed a bug introduced in 2.7.3 that caused issues with script objects
       and pipelines. Thanks Carpentier Pierre-Francois.
-    * Converted redis-py's test suite to use the awesome py.test library.
-    * Fixed a bug introduced in 2.7.5 that prevented a ConnectionError from
+  * Converted redis-py's test suite to use the awesome py.test library.
+  * Fixed a bug introduced in 2.7.5 that prevented a ConnectionError from
       being raised when the Redis server is LOADING data.
-    * Added a BusyLoadingError exception that's raised when the Redis server
+  * Added a BusyLoadingError exception that's raised when the Redis server
       is starting up and not accepting commands yet. BusyLoadingError
       subclasses ConnectionError, which this state previously returned.
       Thanks Yossi Gottlieb.
 * 2.7.5
-    * DEL, HDEL and ZREM commands now return the numbers of keys deleted
+  * DEL, HDEL and ZREM commands now return the numbers of keys deleted
       instead of just True/False.
-    * from_url now supports URIs with a port number. Thanks Aaron Westendorf.
+  * from_url now supports URIs with a port number. Thanks Aaron Westendorf.
 * 2.7.4
-    * Added missing INCRBY method. Thanks Krzysztof Dorosz.
-    * SET now accepts the EX, PX, NX and XX options from Redis 2.6.12. These
+  * Added missing INCRBY method. Thanks Krzysztof Dorosz.
+  * SET now accepts the EX, PX, NX and XX options from Redis 2.6.12. These
       options will generate errors if these options are used when connected
       to a Redis server < 2.6.12. Thanks George Yoshida.
 * 2.7.3
-    * Fixed a bug with BRPOPLPUSH and lists with empty strings.
-    * All empty except: clauses have been replaced to only catch Exception
+  * Fixed a bug with BRPOPLPUSH and lists with empty strings.
+  * All empty except: clauses have been replaced to only catch Exception
       subclasses. This prevents a KeyboardInterrupt from triggering exception
       handlers. Thanks Lucian Branescu Mihaila.
-    * All exceptions that are the result of redis server errors now share a
+  * All exceptions that are the result of redis server errors now share a
       command Exception subclass, ServerError. Thanks Matt Robenolt.
-    * Prevent DISCARD from being called if MULTI wasn't also called. Thanks
+  * Prevent DISCARD from being called if MULTI wasn't also called. Thanks
       Pete Aykroyd.
-    * SREM now returns an integer indicating the number of items removed from
-      the set. Thanks https://github.com/ronniekk.
-    * Fixed a bug with BGSAVE and BGREWRITEAOF response callbacks with Python3.
+  * SREM now returns an integer indicating the number of items removed from
+      the set. Thanks <https://github.com/ronniekk>.
+  * Fixed a bug with BGSAVE and BGREWRITEAOF response callbacks with Python3.
       Thanks Nathan Wan.
-    * Added CLIENT GETNAME and CLIENT SETNAME commands.
-      Thanks https://github.com/bitterb.
-    * It's now possible to use len() on a pipeline instance to determine the
+  * Added CLIENT GETNAME and CLIENT SETNAME commands.
+      Thanks <https://github.com/bitterb>.
+  * It's now possible to use len() on a pipeline instance to determine the
       number of commands that will be executed. Thanks Jon Parise.
-    * Fixed a bug in INFO's parse routine with floating point numbers. Thanks
+  * Fixed a bug in INFO's parse routine with floating point numbers. Thanks
       Ali Onur Uyar.
-    * Fixed a bug with BITCOUNT to allow `start` and `end` to both be zero.
+  * Fixed a bug with BITCOUNT to allow `start` and `end` to both be zero.
       Thanks Tim Bart.
-    * The transaction() method now accepts a boolean keyword argument,
+  * The transaction() method now accepts a boolean keyword argument,
       value_from_callable. By default, or if False is passes, the transaction()
       method will return the value of the pipelines execution. Otherwise, it
       will return whatever func() returns.
-    * Python3 compatibility fix ensuring we're not already bytes(). Thanks
+  * Python3 compatibility fix ensuring we're not already bytes(). Thanks
       Salimane Adjao Moustapha.
-    * Added PSETEX. Thanks YAMAMOTO Takashi.
-    * Added a BlockingConnectionPool to limit the number of connections that
+  * Added PSETEX. Thanks YAMAMOTO Takashi.
+  * Added a BlockingConnectionPool to limit the number of connections that
       can be created. Thanks James Arthur.
-    * SORT now accepts a `groups` option that if specified, will return
+  * SORT now accepts a `groups` option that if specified, will return
       tuples of n-length, where n is the number of keys specified in the GET
       argument. This allows for convenient row-based iteration. Thanks
       Ionuț Arțăriși.
 * 2.7.2
-    * Parse errors are now *always* raised on multi/exec pipelines, regardless
+  * Parse errors are now *always* raised on multi/exec pipelines, regardless
       of the `raise_on_error` flag. See
-      https://groups.google.com/forum/?hl=en&fromgroups=#!topic/redis-db/VUiEFT8U8U0
+      <https://groups.google.com/forum/?hl=en&fromgroups=#!topic/redis-db/VUiEFT8U8U0>
       for more info.
 * 2.7.1
-    * Packaged tests with source code
+  * Packaged tests with source code
 * 2.7.0
-    * Added BITOP and BITCOUNT commands. Thanks Mark Tozzi.
-    * Added the TIME command. Thanks Jason Knight.
-    * Added support for LUA scripting. Thanks to Angus Peart, Drew Smathers,
+  * Added BITOP and BITCOUNT commands. Thanks Mark Tozzi.
+  * Added the TIME command. Thanks Jason Knight.
+  * Added support for LUA scripting. Thanks to Angus Peart, Drew Smathers,
       Issac Kelly, Louis-Philippe Perron, Sean Bleier, Jeffrey Kaditz, and
       Dvir Volk for various patches and contributions to this feature.
-    * Changed the default error handling in pipelines. By default, the first
+  * Changed the default error handling in pipelines. By default, the first
       error in a pipeline will now be raised. A new parameter to the
       pipeline's execute, `raise_on_error`, can be set to False to keep the
       old behavior of embeedding the exception instances in the result.
-    * Fixed a bug with pipelines where parse errors won't corrupt the
+  * Fixed a bug with pipelines where parse errors won't corrupt the
       socket.
-    * Added the optional `number` argument to SRANDMEMBER for use with
+  * Added the optional `number` argument to SRANDMEMBER for use with
       Redis 2.6+ servers.
-    * Added PEXPIRE/PEXPIREAT/PTTL commands. Thanks Luper Rouch.
-    * Added INCRBYFLOAT/HINCRBYFLOAT commands. Thanks Nikita Uvarov.
-    * High precision floating point values won't lose their precision when
+  * Added PEXPIRE/PEXPIREAT/PTTL commands. Thanks Luper Rouch.
+  * Added INCRBYFLOAT/HINCRBYFLOAT commands. Thanks Nikita Uvarov.
+  * High precision floating point values won't lose their precision when
       being sent to the Redis server. Thanks Jason Oster and Oleg Pudeyev.
-    * Added CLIENT LIST/CLIENT KILL commands
+  * Added CLIENT LIST/CLIENT KILL commands
 * 2.6.2
-    * `from_url` is now available as a classmethod on client classes. Thanks
+  * `from_url` is now available as a classmethod on client classes. Thanks
       Jon Parise for the patch.
-    * Fixed several encoding errors resulting from the Python 3.x support.
+  * Fixed several encoding errors resulting from the Python 3.x support.
 * 2.6.1
-    * Python 3.x support! Big thanks to Alex Grönholm.
-    * Fixed a bug in the PythonParser's read_response that could hide an error
+  * Python 3.x support! Big thanks to Alex Grönholm.
+  * Fixed a bug in the PythonParser's read_response that could hide an error
       from the client (#251).
 * 2.6.0
-    * Changed (p)subscribe and (p)unsubscribe to no longer return messages
+  * Changed (p)subscribe and (p)unsubscribe to no longer return messages
       indicating the channel was subscribed/unsubscribed to. These messages
       are available in the listen() loop instead. This is to prevent the
       following scenario:
-        * Client A is subscribed to "foo"
-        * Client B publishes message to "foo"
-        * Client A subscribes to channel "bar" at the same time.
+    * Client A is subscribed to "foo"
+    * Client B publishes message to "foo"
+    * Client A subscribes to channel "bar" at the same time.
       Prior to this change, the subscribe() call would return the published
       messages on "foo" rather than the subscription confirmation to "bar".
-    * Added support for GETRANGE, thanks Jean-Philippe Caruana
-    * A new setting "decode_responses" specifies whether return values from
+  * Added support for GETRANGE, thanks Jean-Philippe Caruana
+  * A new setting "decode_responses" specifies whether return values from
       Redis commands get decoded automatically using the client's charset
       value. Thanks to Frankie Dintino for the patch.
 * 2.4.13
-    * redis.from_url() can take an URL representing a Redis connection string
+  * redis.from_url() can take an URL representing a Redis connection string
       and return a client object. Thanks Kenneth Reitz for the patch.
 * 2.4.12
-    * ConnectionPool is now fork-safe. Thanks Josiah Carson for the patch.
+  * ConnectionPool is now fork-safe. Thanks Josiah Carson for the patch.
 * 2.4.11
-    * AuthenticationError will now be correctly raised if an invalid password
+  * AuthenticationError will now be correctly raised if an invalid password
       is supplied.
-    * If Hiredis is unavailable, the HiredisParser will raise a RedisError
+  * If Hiredis is unavailable, the HiredisParser will raise a RedisError
       if selected manually.
-    * Made the INFO command more tolerant of Redis changes formatting. Fix
+  * Made the INFO command more tolerant of Redis changes formatting. Fix
       for #217.
 * 2.4.10
-    * Buffer reads from socket in the PythonParser. Fix for a Windows-specific
+  * Buffer reads from socket in the PythonParser. Fix for a Windows-specific
       bug (#205).
-    * Added the OBJECT and DEBUG OBJECT commands.
-    * Added __del__ methods for classes that hold on to resources that need to
+  * Added the OBJECT and DEBUG OBJECT commands.
+  * Added __del__ methods for classes that hold on to resources that need to
       be cleaned up. This should prevent resource leakage when these objects
       leave scope due to misuse or unhandled exceptions. Thanks David Wolever
       for the suggestion.
-    * Added the ECHO command for completeness.
-    * Fixed a bug where attempting to subscribe to a PubSub channel of a Redis
+  * Added the ECHO command for completeness.
+  * Fixed a bug where attempting to subscribe to a PubSub channel of a Redis
       server that's down would blow out the stack. Fixes #179 and #195. Thanks
       Ovidiu Predescu for the test case.
-    * StrictRedis's TTL command now returns a -1 when querying a key with no
+  * StrictRedis's TTL command now returns a -1 when querying a key with no
       expiration. The Redis class continues to return None.
-    * ZADD and SADD now return integer values indicating the number of items
+  * ZADD and SADD now return integer values indicating the number of items
       added. Thanks Homer Strong.
-    * Renamed the base client class to StrictRedis, replacing ZADD and LREM in
+  * Renamed the base client class to StrictRedis, replacing ZADD and LREM in
       favor of their official argument order. The Redis class is now a subclass
       of StrictRedis, implementing the legacy redis-py implementations of ZADD
       and LREM. Docs have been updated to suggesting the use of StrictRedis.
-    * SETEX in StrictRedis is now compliant with official Redis SETEX command.
+  * SETEX in StrictRedis is now compliant with official Redis SETEX command.
       the name, value, time implementation moved to "Redis" for backwards
       compatibility.
 * 2.4.9
-    * Removed socket retry logic in Connection. This is the responsibility of
+  * Removed socket retry logic in Connection. This is the responsibility of
       the caller to determine if the command is safe and can be retried. Thanks
       David Wolver.
-    * Added some extra guards around various types of exceptions being raised
+  * Added some extra guards around various types of exceptions being raised
       when sending or parsing data. Thanks David Wolver and Denis Bilenko.
 * 2.4.8
-    * Imported with_statement from __future__ for Python 2.5 compatibility.
+  * Imported with_statement from __future__ for Python 2.5 compatibility.
 * 2.4.7
-    * Fixed a bug where some connections were not getting released back to the
+  * Fixed a bug where some connections were not getting released back to the
       connection pool after pipeline execution.
-    * Pipelines can now be used as context managers. This is the preferred way
+  * Pipelines can now be used as context managers. This is the preferred way
       of use to ensure that connections get cleaned up properly. Thanks
       David Wolever.
-    * Added a convenience method called transaction() on the base Redis class.
+  * Added a convenience method called transaction() on the base Redis class.
       This method eliminates much of the boilerplate used when using pipelines
       to watch Redis keys. See the documentation for details on usage.
 * 2.4.6
-    * Variadic arguments for SADD, SREM, ZREN, HDEL, LPUSH, and RPUSH. Thanks
+  * Variadic arguments for SADD, SREM, ZREN, HDEL, LPUSH, and RPUSH. Thanks
       Raphaël Vinot.
-    * (CRITICAL) Fixed an error in the Hiredis parser that occasionally caused
+  * (CRITICAL) Fixed an error in the Hiredis parser that occasionally caused
       the socket connection to become corrupted and unusable. This became
       noticeable once connection pools started to be used.
-    * ZRANGE, ZREVRANGE, ZRANGEBYSCORE, and ZREVRANGEBYSCORE now take an
+  * ZRANGE, ZREVRANGE, ZRANGEBYSCORE, and ZREVRANGEBYSCORE now take an
       additional optional argument, score_cast_func, which is a callable used
       to cast the score value in the return type. The default is float.
-    * Removed the PUBLISH method from the PubSub class. Connections that are
+  * Removed the PUBLISH method from the PubSub class. Connections that are
       [P]SUBSCRIBEd cannot issue PUBLISH commands, so it doesn't make sense
       to have it here.
-    * Pipelines now contain WATCH and UNWATCH. Calling WATCH or UNWATCH from
+  * Pipelines now contain WATCH and UNWATCH. Calling WATCH or UNWATCH from
       the base client class will result in a deprecation warning. After
       WATCHing one or more keys, the pipeline will be placed in immediate
       execution mode until UNWATCH or MULTI are called. Refer to the new
       pipeline docs in the README for more information. Thanks to David Wolever
       and Randall Leeds for greatly helping with this.
 * 2.4.5
-    * The PythonParser now works better when reading zero length strings.
+  * The PythonParser now works better when reading zero length strings.
 * 2.4.4
-    * Fixed a typo introduced in 2.4.3
+  * Fixed a typo introduced in 2.4.3
 * 2.4.3
-    * Fixed a bug in the UnixDomainSocketConnection caused when trying to
+  * Fixed a bug in the UnixDomainSocketConnection caused when trying to
       form an error message after a socket error.
 * 2.4.2
-    * Fixed a bug in pipeline that caused an exception while trying to
+  * Fixed a bug in pipeline that caused an exception while trying to
       reconnect after a connection timeout.
 * 2.4.1
-    * Fixed a bug in the PythonParser if disconnect is called before connect.
+  * Fixed a bug in the PythonParser if disconnect is called before connect.
 * 2.4.0
-    * WARNING: 2.4 contains several backwards incompatible changes.
-    * Completely refactored Connection objects. Moved much of the Redis
+  * WARNING: 2.4 contains several backwards incompatible changes.
+  * Completely refactored Connection objects. Moved much of the Redis
       protocol packing for requests here, and eliminated the nasty dependencies
       it had on the client to do AUTH and SELECT commands on connect.
-    * Connection objects now have a parser attribute. Parsers are responsible
+  * Connection objects now have a parser attribute. Parsers are responsible
       for reading data Redis sends. Two parsers ship with redis-py: a
       PythonParser and the HiRedis parser. redis-py will automatically use the
       HiRedis parser if you have the Python hiredis module installed, otherwise
       it will fall back to the PythonParser. You can force or the other, or even
       an external one by passing the `parser_class` argument to ConnectionPool.
-    * Added a UnixDomainSocketConnection for users wanting to talk to the Redis
+  * Added a UnixDomainSocketConnection for users wanting to talk to the Redis
       instance running on a local machine only. You can use this connection
       by passing it to the `connection_class` argument of the ConnectionPool.
-    * Connections no longer derive from threading.local. See threading.local
+  * Connections no longer derive from threading.local. See threading.local
       note below.
-    * ConnectionPool has been completely refactored. The ConnectionPool now
+  * ConnectionPool has been completely refactored. The ConnectionPool now
       maintains a list of connections. The redis-py client only hangs on to
       a ConnectionPool instance, calling get_connection() anytime it needs to
       send a command. When get_connection() is called, the command name and
@@ -1050,83 +1050,83 @@
       belong to and return a connection to it. ConnectionPool also implements
       disconnect() to force all connections in the pool to disconnect from
       the Redis server.
-    * redis-py no longer support the SELECT command. You can still connect to
+  * redis-py no longer support the SELECT command. You can still connect to
       a specific database by specifying it when instantiating a client instance
       or by creating a connection pool. If you need to talk to multiple
       databases within your application, you should use a separate client
       instance for each database you want to talk to.
-    * Completely refactored Publish/Subscribe support. The subscribe and listen
+  * Completely refactored Publish/Subscribe support. The subscribe and listen
       commands are no longer available on the redis-py Client class. Instead,
       the `pubsub` method returns an instance of the PubSub class which contains
       all publish/subscribe support. Note, you can still PUBLISH from the
       redis-py client class if you desire.
-    * Removed support for all previously deprecated commands or options.
-    * redis-py no longer uses threading.local in any way. Since the Client
+  * Removed support for all previously deprecated commands or options.
+  * redis-py no longer uses threading.local in any way. Since the Client
       class no longer holds on to a connection, it's no longer needed. You can
       now pass client instances between threads, and commands run on those
       threads will retrieve an available connection from the pool, use it and
       release it. It should now be trivial to use redis-py with eventlet or
       greenlet.
-    * ZADD now accepts pairs of value=score keyword arguments. This should help
+  * ZADD now accepts pairs of value=score keyword arguments. This should help
       resolve the long standing #72. The older value and score arguments have
       been deprecated in favor of the keyword argument style.
-    * Client instances now get their own copy of RESPONSE_CALLBACKS. The new
+  * Client instances now get their own copy of RESPONSE_CALLBACKS. The new
       set_response_callback method adds a user defined callback to the instance.
-    * Support Jython, fixing #97. Thanks to Adam Vandenberg for the patch.
-    * Using __getitem__ now properly raises a KeyError when the key is not
+  * Support Jython, fixing #97. Thanks to Adam Vandenberg for the patch.
+  * Using __getitem__ now properly raises a KeyError when the key is not
       found. Thanks Ionuț Arțăriși for the patch.
-    * Newer Redis versions return a LOADING message for some commands while
+  * Newer Redis versions return a LOADING message for some commands while
       the database is loading from disk during server start. This could cause
       problems with SELECT. We now force a socket disconnection prior to
       raising a ResponseError so subsequent connections have to reconnect and
       re-select the appropriate database. Thanks to Benjamin Anderson for
       finding this and fixing.
 * 2.2.4
-    * WARNING: Potential backwards incompatible change - Changed order of
+  * WARNING: Potential backwards incompatible change - Changed order of
       parameters of ZREVRANGEBYSCORE to match those of the actual Redis command.
       This is only backwards-incompatible if you were passing max and min via
       keyword args. If passing by normal args, nothing in user code should have
       to change. Thanks Stéphane Angel for the fix.
-    * Fixed INFO to properly parse the Redis data correctly for both 2.2.x and
+  * Fixed INFO to properly parse the Redis data correctly for both 2.2.x and
       2.3+. Thanks Stéphane Angel for the fix.
-    * Lock objects now store their timeout value as a float. This allows floats
+  * Lock objects now store their timeout value as a float. This allows floats
       to be used as timeout values. No changes to existing code required.
-    * WATCH now supports multiple keys. Thanks Rich Schumacher.
-    * Broke out some code that was Python 2.4 incompatible. redis-py should
+  * WATCH now supports multiple keys. Thanks Rich Schumacher.
+  * Broke out some code that was Python 2.4 incompatible. redis-py should
       now be usable on 2.4, but this hasn't actually been tested. Thanks
       Dan Colish for the patch.
-    * Optimized some code using izip and islice. Should have a pretty good
+  * Optimized some code using izip and islice. Should have a pretty good
       speed up on larger data sets. Thanks Dan Colish.
-    * Better error handling when submitting an empty mapping to HMSET. Thanks
+  * Better error handling when submitting an empty mapping to HMSET. Thanks
       Dan Colish.
-    * Subscription status is now reset after every (re)connection.
+  * Subscription status is now reset after every (re)connection.
 * 2.2.3
-    * Added support for Hiredis. To use, simply "pip install hiredis" or
+  * Added support for Hiredis. To use, simply "pip install hiredis" or
       "easy_install hiredis". Thanks for Pieter Noordhuis for the hiredis-py
       bindings and the patch to redis-py.
-    * The connection class is chosen based on whether hiredis is installed
+  * The connection class is chosen based on whether hiredis is installed
       or not. To force the use of the PythonConnection, simply create
       your own ConnectionPool instance with the connection_class argument
       assigned to to PythonConnection class.
-    * Added missing command ZREVRANGEBYSCORE. Thanks Jay Baird for the patch.
-    * The INFO command should be parsed correctly on 2.2.x server versions
+  * Added missing command ZREVRANGEBYSCORE. Thanks Jay Baird for the patch.
+  * The INFO command should be parsed correctly on 2.2.x server versions
       and is backwards compatible with older versions. Thanks Brett Hoerner.
 * 2.2.2
-    * Fixed a bug in ZREVRANK where retrieving the rank of a value not in
+  * Fixed a bug in ZREVRANK where retrieving the rank of a value not in
       the zset would raise an error.
-    * Fixed a bug in Connection.send where the errno import was getting
+  * Fixed a bug in Connection.send where the errno import was getting
       overwritten by a local variable.
-    * Fixed a bug in SLAVEOF when promoting an existing slave to a master.
-    * Reverted change of download URL back to redis-VERSION.tar.gz. 2.2.1's
+  * Fixed a bug in SLAVEOF when promoting an existing slave to a master.
+  * Reverted change of download URL back to redis-VERSION.tar.gz. 2.2.1's
       change of this actually broke Pypi for Pip installs. Sorry!
 * 2.2.1
-    * Changed archive name to redis-py-VERSION.tar.gz to not conflict
+  * Changed archive name to redis-py-VERSION.tar.gz to not conflict
       with the Redis server archive.
 * 2.2.0
-    * Implemented SLAVEOF
-    * Implemented CONFIG as config_get and config_set
-    * Implemented GETBIT/SETBIT
-    * Implemented BRPOPLPUSH
-    * Implemented STRLEN
-    * Implemented PERSIST
-    * Implemented SETRANGE
+  * Implemented SLAVEOF
+  * Implemented CONFIG as config_get and config_set
+  * Implemented GETBIT/SETBIT
+  * Implemented BRPOPLPUSH
+  * Implemented STRLEN
+  * Implemented PERSIST
+  * Implemented SETRANGE
diff --git a/redis/py.typed b/redis/py.typed
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/setup.py b/setup.py
index 3a752d44d3..1936dc1336 100644
--- a/setup.py
+++ b/setup.py
@@ -23,6 +23,8 @@
             "redis.parsers",
         ]
     ),
+    package_data={"redis": ["py.typed"]},
+    include_package_data=True,
     url="https://github.com/redis/redis-py",
     project_urls={
         "Documentation": "https://redis.readthedocs.io/en/latest/",

From b0abd555770bba42c57881b488b5fe5b188f088e Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 8 Aug 2023 13:48:15 +0300
Subject: [PATCH 0760/1164] RESP 3 feature documentation (#2872)

---
 .github/spellcheck-settings.yml         |  29 +++++
 .github/wordlist.txt                    | 142 ++++++++++++++++++++++++
 .github/workflows/spellcheck.yml        |  14 +++
 README.md                               |   4 +-
 docs/advanced_features.rst              |  74 ++++++++----
 docs/clustering.rst                     |  20 ++--
 docs/examples/asyncio_examples.ipynb    |   2 +-
 docs/examples/connection_examples.ipynb |   4 +-
 docs/index.rst                          |   9 +-
 docs/lua_scripting.rst                  |   8 +-
 docs/resp3_features.rst                 |  69 ++++++++++++
 11 files changed, 331 insertions(+), 44 deletions(-)
 create mode 100644 .github/spellcheck-settings.yml
 create mode 100644 .github/wordlist.txt
 create mode 100644 .github/workflows/spellcheck.yml
 create mode 100644 docs/resp3_features.rst

diff --git a/.github/spellcheck-settings.yml b/.github/spellcheck-settings.yml
new file mode 100644
index 0000000000..96abbe6da8
--- /dev/null
+++ b/.github/spellcheck-settings.yml
@@ -0,0 +1,29 @@
+matrix:
+- name: Markdown
+  expect_match: false
+  apsell:
+    lang: en
+    d: en_US
+    ignore-case: true
+  dictionary:
+    wordlists:
+    - .github/wordlist.txt
+    output: wordlist.dic
+  pipeline:
+  - pyspelling.filters.markdown:
+      markdown_extensions:
+      - markdown.extensions.extra:
+  - pyspelling.filters.html:
+      comments: false
+      attributes:
+      - alt
+      ignores:
+      - ':matches(code, pre)'
+      - code
+      - pre
+      - blockquote
+      - img
+  sources:
+  - '*.md'
+  - 'docs/*.rst'
+  - 'docs/*.ipynb'
diff --git a/.github/wordlist.txt b/.github/wordlist.txt
new file mode 100644
index 0000000000..be16c437ff
--- /dev/null
+++ b/.github/wordlist.txt
@@ -0,0 +1,142 @@
+APM
+ARGV
+BFCommands
+CFCommands
+CMSCommands
+ClusterNode
+ClusterNodes
+ClusterPipeline
+ClusterPubSub
+ConnectionPool
+CoreCommands
+EVAL
+EVALSHA
+GraphCommands
+Grokzen's
+INCR
+IOError
+Instrumentations
+JSONCommands
+Jaeger
+Ludovico
+Magnocavallo
+McCurdy
+NOSCRIPT
+NUMPAT
+NUMPT
+NUMSUB
+OSS
+OpenCensus
+OpenTelemetry
+OpenTracing
+Otel
+PubSub
+READONLY
+RediSearch
+RedisBloom
+RedisCluster
+RedisClusterCommands
+RedisClusterException
+RedisClusters
+RedisGraph
+RedisInstrumentor
+RedisJSON
+RedisTimeSeries
+SHA
+SearchCommands
+SentinelCommands
+SentinelConnectionPool
+Sharded
+Solovyov
+SpanKind
+Specfiying
+StatusCode
+TCP
+TOPKCommands
+TimeSeriesCommands
+Uptrace
+ValueError
+WATCHed
+WatchError
+api
+args
+async
+asyncio
+autoclass
+automodule
+backoff
+bdb
+behaviour
+bool
+boolean
+booleans
+bysource
+charset
+del
+dev
+eg
+exc
+firsttimersonly
+fo
+genindex
+gmail
+hiredis
+http
+idx
+iff
+ini
+json
+keyslot
+keyspace
+kwarg
+linters
+localhost
+lua
+makeapullrequest
+maxdepth
+mget
+microservice
+microservices
+mset
+multikey
+mykey
+nonatomic
+observability
+opentelemetry
+oss
+performant
+pmessage
+png
+pre
+psubscribe
+pubsub
+punsubscribe
+py
+pypi
+quickstart
+readonly
+readwrite
+redis
+redismodules
+reinitialization
+replicaof
+repo
+runtime
+sedrik
+sharded
+ssl
+str
+stunnel
+subcommands
+thevalueofmykey
+timeseries
+toctree
+topk
+tox
+triaging
+txt
+un
+unicode
+url
+virtualenv
+www
diff --git a/.github/workflows/spellcheck.yml b/.github/workflows/spellcheck.yml
new file mode 100644
index 0000000000..e152841553
--- /dev/null
+++ b/.github/workflows/spellcheck.yml
@@ -0,0 +1,14 @@
+name: spellcheck
+on:
+  pull_request:
+jobs:
+  check-spelling:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+      - name: Check Spelling
+        uses: rojopolis/spellcheck-github-actions@0.33.1
+        with:
+          config_path: .github/spellcheck-settings.yml
+          task_name: Markdown
diff --git a/README.md b/README.md
index 67912eb3ef..f8c3a78ae7 100644
--- a/README.md
+++ b/README.md
@@ -44,13 +44,13 @@ Looking for a high-level library to handle object mapping? See [redis-om-python]
 
 The most recent version of this library supports redis version [5.0](https://github.com/redis/redis/blob/5.0/00-RELEASENOTES), [6.0](https://github.com/redis/redis/blob/6.0/00-RELEASENOTES), [6.2](https://github.com/redis/redis/blob/6.2/00-RELEASENOTES), and [7.0](https://github.com/redis/redis/blob/7.0/00-RELEASENOTES).
 
-The table below higlights version compatibility of the most-recent library versions and redis versions.
+The table below highlights version compatibility of the most-recent library versions and redis versions.
 
 | Library version | Supported redis versions |
 |-----------------|-------------------|
 | 3.5.3 | <= 6.2 Family of releases |
 | >= 4.5.0 | Version 5.0 to 7.0 |
-| >= 5.0.0 | Versiond 5.0 to current |
+| >= 5.0.0 | Version 5.0 to current |
 
 
 ## Usage
diff --git a/docs/advanced_features.rst b/docs/advanced_features.rst
index 5fd20c2ba2..fd29d2f684 100644
--- a/docs/advanced_features.rst
+++ b/docs/advanced_features.rst
@@ -37,7 +37,7 @@ the client and server.
 
 Pipelines are quite simple to use:
 
-.. code:: pycon
+.. code:: python
 
    >>> r = redis.Redis(...)
    >>> r.set('bing', 'baz')
@@ -54,7 +54,7 @@ Pipelines are quite simple to use:
 For ease of use, all commands being buffered into the pipeline return
 the pipeline object itself. Therefore calls can be chained like:
 
-.. code:: pycon
+.. code:: python
 
    >>> pipe.set('foo', 'bar').sadd('faz', 'baz').incr('auto_number').execute()
    [True, True, 6]
@@ -64,7 +64,7 @@ executed atomically as a group. This happens by default. If you want to
 disable the atomic nature of a pipeline but still want to buffer
 commands, you can turn off transactions.
 
-.. code:: pycon
+.. code:: python
 
    >>> pipe = r.pipeline(transaction=False)
 
@@ -84,7 +84,7 @@ prior the execution of that transaction, the entire transaction will be
 canceled and a WatchError will be raised. To implement our own
 client-side INCR command, we could do something like this:
 
-.. code:: pycon
+.. code:: python
 
    >>> with r.pipeline() as pipe:
    ...     while True:
@@ -117,7 +117,7 @@ Pipeline is used as a context manager (as in the example above) reset()
 will be called automatically. Of course you can do this the manual way
 by explicitly calling reset():
 
-.. code:: pycon
+.. code:: python
 
    >>> pipe = r.pipeline()
    >>> while True:
@@ -137,7 +137,7 @@ that should expect a single parameter, a pipeline object, and any number
 of keys to be WATCHed. Our client-side INCR command above can be written
 like this, which is much easier to read:
 
-.. code:: pycon
+.. code:: python
 
    >>> def client_side_incr(pipe):
    ...     current_value = pipe.get('OUR-SEQUENCE-KEY')
@@ -165,7 +165,7 @@ dramatically increase the throughput of Redis Cluster by significantly
 reducing the number of network round trips between the client and
 the server.
 
-.. code:: pycon
+.. code:: python
 
    >>> with rc.pipeline() as pipe:
    ...     pipe.set('foo', 'value1')
@@ -198,7 +198,7 @@ Publish / Subscribe
 redis-py includes a PubSub object that subscribes to channels and
 listens for new messages. Creating a PubSub object is easy.
 
-.. code:: pycon
+.. code:: python
 
    >>> r = redis.Redis(...)
    >>> p = r.pubsub()
@@ -206,7 +206,7 @@ listens for new messages. Creating a PubSub object is easy.
 Once a PubSub instance is created, channels and patterns can be
 subscribed to.
 
-.. code:: pycon
+.. code:: python
 
    >>> p.subscribe('my-first-channel', 'my-second-channel', ...)
    >>> p.psubscribe('my-*', ...)
@@ -215,7 +215,7 @@ The PubSub instance is now subscribed to those channels/patterns. The
 subscription confirmations can be seen by reading messages from the
 PubSub instance.
 
-.. code:: pycon
+.. code:: python
 
    >>> p.get_message()
    {'pattern': None, 'type': 'subscribe', 'channel': b'my-second-channel', 'data': 1}
@@ -240,7 +240,7 @@ following keys.
 
 Let's send a message now.
 
-.. code:: pycon
+.. code:: python
 
    # the publish method returns the number matching channel and pattern
    # subscriptions. 'my-first-channel' matches both the 'my-first-channel'
@@ -256,7 +256,7 @@ Let's send a message now.
 Unsubscribing works just like subscribing. If no arguments are passed to
 [p]unsubscribe, all channels or patterns will be unsubscribed from.
 
-.. code:: pycon
+.. code:: python
 
    >>> p.unsubscribe()
    >>> p.punsubscribe('my-*')
@@ -279,7 +279,7 @@ the message dictionary is created and passed to the message handler. In
 this case, a None value is returned from get_message() since the message
 was already handled.
 
-.. code:: pycon
+.. code:: python
 
    >>> def my_handler(message):
    ...     print('MY HANDLER: ', message['data'])
@@ -305,7 +305,7 @@ passing ignore_subscribe_messages=True to r.pubsub(). This will cause
 all subscribe/unsubscribe messages to be read, but they won't bubble up
 to your application.
 
-.. code:: pycon
+.. code:: python
 
    >>> p = r.pubsub(ignore_subscribe_messages=True)
    >>> p.subscribe('my-channel')
@@ -325,7 +325,7 @@ to a message handler. If there's no data to be read, get_message() will
 immediately return None. This makes it trivial to integrate into an
 existing event loop inside your application.
 
-.. code:: pycon
+.. code:: python
 
    >>> while True:
    >>>     message = p.get_message()
@@ -339,7 +339,7 @@ your application doesn't need to do anything else but receive and act on
 messages received from redis, listen() is an easy way to get up an
 running.
 
-.. code:: pycon
+.. code:: python
 
    >>> for message in p.listen():
    ...     # do something with the message
@@ -360,7 +360,7 @@ handlers. Therefore, redis-py prevents you from calling run_in_thread()
 if you're subscribed to patterns or channels that don't have message
 handlers attached.
 
-.. code:: pycon
+.. code:: python
 
    >>> p.subscribe(**{'my-channel': my_handler})
    >>> thread = p.run_in_thread(sleep_time=0.001)
@@ -374,7 +374,7 @@ appropriately. The exception handler will take as arguments the
 exception itself, the pubsub object, and the worker thread returned by
 run_in_thread.
 
-.. code:: pycon
+.. code:: python
 
    >>> p.subscribe(**{'my-channel': my_handler})
    >>> def exception_handler(ex, pubsub, thread):
@@ -401,7 +401,7 @@ when reconnecting. Messages that were published while the client was
 disconnected cannot be delivered. When you're finished with a PubSub
 object, call its .close() method to shutdown the connection.
 
-.. code:: pycon
+.. code:: python
 
    >>> p = r.pubsub()
    >>> ...
@@ -410,7 +410,7 @@ object, call its .close() method to shutdown the connection.
 The PUBSUB set of subcommands CHANNELS, NUMSUB and NUMPAT are also
 supported:
 
-.. code:: pycon
+.. code:: python
 
    >>> r.pubsub_channels()
    [b'foo', b'bar']
@@ -421,6 +421,38 @@ supported:
    >>> r.pubsub_numpat()
    1204
 
+Sharded pubsub
+~~~~~~~~~~~~~~
+
+`Sharded pubsub <https://redis.io/docs/interact/pubsub/#:~:text=Sharded%20Pub%2FSub%20helps%20to,the%20shard%20of%20a%20cluster.>`_ is a feature introduced with Redis 7.0, and fully supported by redis-py as of 5.0. It helps scale the usage of pub/sub in cluster mode, by having the cluster shard messages to nodes that own a slot for a shard channel. Here, the cluster ensures the published shard messages are forwarded to the appropriate nodes. Clients subscribe to a channel by connecting to either the master responsible for the slot, or any of its replicas.
+
+This makes use of the `SSUBSCRIBE <https://redis.io/commands/ssubscribe>`_ and `SPUBLISH <https://redis.io/commands/spublish>`_ commands within Redis.
+
+The following, is a simplified example:
+
+.. code:: python
+
+    >>> from redis.cluster import RedisCluster, ClusterNode
+    >>> r = RedisCluster(startup_nodes=[ClusterNode('localhost', 6379), ClusterNode('localhost', 6380)])
+    >>> p = r.pubsub()
+    >>> p.ssubscribe('foo')
+    >>> # assume someone sends a message along the channel via a publish
+    >>> message = p.get_sharded_message()
+
+Similarly, the same process can be used to acquire sharded pubsub messages, that have already been sent to a specific node, by passing the node to get_sharded_message:
+
+.. code:: python
+
+    >>> from redis.cluster import RedisCluster, ClusterNode
+    >>> first_node = ClusterNode['localhost', 6379]
+    >>> second_node = ClusterNode['localhost', 6380]
+    >>> r = RedisCluster(startup_nodes=[first_node, second_node])
+    >>> p = r.pubsub()
+    >>> p.ssubscribe('foo')
+    >>> # assume someone sends a message along the channel via a publish
+    >>> message = p.get_sharded_message(target_node=second_node)
+
+
 Monitor
 ~~~~~~~
 
@@ -428,7 +460,7 @@ redis-py includes a Monitor object that streams every command processed
 by the Redis server. Use listen() on the Monitor object to block until a
 command is received.
 
-.. code:: pycon
+.. code:: python
 
    >>> r = redis.Redis(...)
    >>> with r.monitor() as m:
diff --git a/docs/clustering.rst b/docs/clustering.rst
index 34cb7f1f69..9b4dee1c9f 100644
--- a/docs/clustering.rst
+++ b/docs/clustering.rst
@@ -26,7 +26,7 @@ cluster instance can be created:
 
 -  Using ‘host’ and ‘port’ arguments:
 
-.. code:: pycon
+.. code:: python
 
    >>> from redis.cluster import RedisCluster as Redis
    >>> rc = Redis(host='localhost', port=6379)
@@ -35,14 +35,14 @@ cluster instance can be created:
 
 -  Using the Redis URL specification:
 
-.. code:: pycon
+.. code:: python
 
    >>> from redis.cluster import RedisCluster as Redis
    >>> rc = Redis.from_url("redis://localhost:6379/0")
 
 -  Directly, via the ClusterNode class:
 
-.. code:: pycon
+.. code:: python
 
    >>> from redis.cluster import RedisCluster as Redis
    >>> from redis.cluster import ClusterNode
@@ -77,7 +77,7 @@ you can change it using the ‘set_default_node’ method.
 The ‘target_nodes’ parameter is explained in the following section,
 ‘Specifying Target Nodes’.
 
-.. code:: pycon
+.. code:: python
 
    >>> # target-nodes: the node that holds 'foo1's key slot
    >>> rc.set('foo1', 'bar1')
@@ -105,7 +105,7 @@ topology of the cluster changes during the execution of a command, the
 client will be able to resolve the nodes flag again with the new
 topology and attempt to retry executing the command.
 
-.. code:: pycon
+.. code:: python
 
    >>> from redis.cluster import RedisCluster as Redis
    >>> # run cluster-meet command on all of the cluster's nodes
@@ -127,7 +127,7 @@ topology changes, a retry attempt will not be made, since the passed
 target node/s may no longer be valid, and the relevant cluster or
 connection error will be returned.
 
-.. code:: pycon
+.. code:: python
 
    >>> node = rc.get_node('localhost', 6379)
    >>> # Get the keys only for that specific node
@@ -140,7 +140,7 @@ In addition, the RedisCluster instance can query the Redis instance of a
 specific node and execute commands on that node directly. The Redis
 client, however, does not handle cluster failures and retries.
 
-.. code:: pycon
+.. code:: python
 
    >>> cluster_node = rc.get_node(host='localhost', port=6379)
    >>> print(cluster_node)
@@ -170,7 +170,7 @@ to the relevant slots, sending the commands to the slots’ node owners.
 Non-atomic operations batch the keys according to their hash value, and
 then each batch is sent separately to the slot’s owner.
 
-.. code:: pycon
+.. code:: python
 
    # Atomic operations can be used when all keys are mapped to the same slot
    >>> rc.mset({'{foo}1': 'bar1', '{foo}2': 'bar2'})
@@ -202,7 +202,7 @@ the commands are not currently recommended for use. See
 documentation <https://redis-py-cluster.readthedocs.io/en/stable/pubsub.html>`__
 for more.
 
-.. code:: pycon
+.. code:: python
 
    >>> p1 = rc.pubsub()
    # p1 connection will be set to the node that holds 'foo' keyslot
@@ -224,7 +224,7 @@ READONLY mode can be set at runtime by calling the readonly() method
 with target_nodes=‘replicas’, and read-write access can be restored by
 calling the readwrite() method.
 
-.. code:: pycon
+.. code:: python
 
    >>> from cluster import RedisCluster as Redis
    # Use 'debug' log level to print the node that the command is executed on
diff --git a/docs/examples/asyncio_examples.ipynb b/docs/examples/asyncio_examples.ipynb
index 7fdcc36bc5..f7e67e2ca7 100644
--- a/docs/examples/asyncio_examples.ipynb
+++ b/docs/examples/asyncio_examples.ipynb
@@ -355,7 +355,7 @@
    "source": [
     "import redis.asyncio as redis\n",
     "\n",
-    "url_connection = redis.from_url(\"redis://localhost:6379?decode_responses=Trueprotocol=3\")\n",
+    "url_connection = redis.from_url(\"redis://localhost:6379?decode_responses=True&protocol=3\")\n",
     "url_connection.ping()"
    ]
   }
diff --git a/docs/examples/connection_examples.ipynb b/docs/examples/connection_examples.ipynb
index e6d147c920..cddded2865 100644
--- a/docs/examples/connection_examples.ipynb
+++ b/docs/examples/connection_examples.ipynb
@@ -68,12 +68,12 @@
    ]
   },
   {
-   "cell_type": "code",
+   "cell_type": "markdown",
    "execution_count": null,
    "metadata": {},
    "outputs": [],
    "source": [
-    "### by default this library uses the RESP 2 protocol. To eanble RESP3, set protocol=3."
+    "### By default this library uses the RESP 2 protocol. To enable RESP3, set protocol=3."
    ]
   },
   {
diff --git a/docs/index.rst b/docs/index.rst
index a6ee05e917..2c0557cbbe 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -64,15 +64,16 @@ Module Documentation
 .. toctree::
    :maxdepth: 1
 
-   backoff
    connections
+   clustering
    exceptions
+   backoff
    lock
    retry
-   advanced_features
-   clustering
    lua_scripting
    opentelemetry
+   resp3_features
+   advanced_features
    examples
 
 Contributing
@@ -86,4 +87,4 @@ Contributing
 License
 *******
 
-This projectis licensed under the `MIT license <https://github.com/redis/redis-py/blob/master/LICENSE>`_.
+This project is licensed under the `MIT license <https://github.com/redis/redis-py/blob/master/LICENSE>`_.
diff --git a/docs/lua_scripting.rst b/docs/lua_scripting.rst
index 8276dad051..0edb6b6723 100644
--- a/docs/lua_scripting.rst
+++ b/docs/lua_scripting.rst
@@ -24,7 +24,7 @@ The following trivial Lua script accepts two parameters: the name of a
 key and a multiplier value. The script fetches the value stored in the
 key, multiplies it with the multiplier value and returns the result.
 
-.. code:: pycon
+.. code:: python
 
    >>> r = redis.Redis()
    >>> lua = """
@@ -47,7 +47,7 @@ function. Script instances accept the following optional arguments:
 
 Continuing the example from above:
 
-.. code:: pycon
+.. code:: python
 
    >>> r.set('foo', 2)
    >>> multiply(keys=['foo'], args=[5])
@@ -60,7 +60,7 @@ executes the script and returns the result, 10.
 Script instances can be executed using a different client instance, even
 one that points to a completely different Redis server.
 
-.. code:: pycon
+.. code:: python
 
    >>> r2 = redis.Redis('redis2.example.com')
    >>> r2.set('foo', 3)
@@ -79,7 +79,7 @@ should be passed as the client argument when calling the script. Care is
 taken to ensure that the script is registered in Redis's script cache
 just prior to pipeline execution.
 
-.. code:: pycon
+.. code:: python
 
    >>> pipe = r.pipeline()
    >>> pipe.set('foo', 5)
diff --git a/docs/resp3_features.rst b/docs/resp3_features.rst
new file mode 100644
index 0000000000..11c01985a0
--- /dev/null
+++ b/docs/resp3_features.rst
@@ -0,0 +1,69 @@
+RESP 3 Features
+===============
+
+As of version 5.0, redis-py supports the `RESP 3 standard <https://github.com/redis/redis-specifications/blob/master/protocol/RESP3.md>`_. Practically, this means that client using RESP 3 will be faster and more performant as fewer type translations occur in the client. It also means new response types like doubles, true simple strings, maps, and booleans are available.
+
+Connecting
+-----------
+
+Enabling RESP3 is no different than other connections in redis-py. In all cases, the connection type must be extending by setting `protocol=3`. The following are some base examples illustrating how to enable a RESP 3 connection.
+
+Connect with a standard connection, but specifying resp 3:
+
+.. code:: python
+
+    >>> import redis
+    >>> r = redis.Redis(host='localhost', port=6379, protocol=3)
+    >>> r.ping()
+
+Or using the URL scheme:
+
+.. code:: python
+
+    >>> import redis
+    >>> r = redis.from_url("redis://localhost:6379?protocol=3")
+    >>> r.ping()
+
+Connect with async, specifying resp 3:
+
+.. code:: python
+
+    >>> import redis.asyncio as redis
+    >>> r = redis.Redis(host='localhost', port=6379, protocol=3)
+    >>> await r.ping()
+
+The URL scheme with the async client
+
+.. code:: python
+
+    >>> import redis.asyncio as Redis
+    >>> r = redis.from_url("redis://localhost:6379?protocol=3")
+    >>> await r.ping()
+
+Connecting to an OSS Redis Cluster with RESP 3
+
+.. code:: python
+
+    >>> from redis.cluster import RedisCluster, ClusterNode
+    >>> r = RedisCluster(startup_nodes=[ClusterNode('localhost', 6379), ClusterNode('localhost', 6380)], protocol=3)
+    >>> r.ping()
+
+Push notifications
+------------------
+
+Push notifications are a way that redis sends out of band data. The RESP 3 protocol includes a `push type <https://github.com/redis/redis-specifications/blob/master/protocol/RESP3.md#push-type>`_ that allows our client to intercept these out of band messages. By default, clients will log simple messages, but redis-py includes the ability to bring your own function processor.
+
+This means that should you want to perform something, on a given push notification, you specify a function during the connection, as per this examples:
+
+.. code:: python
+
+    >> from redis import Redis
+    >>
+    >> def our_func(message):
+    >>    if message.find("This special thing happened"):
+    >>        raise IOError("This was the message: \n" + message)
+    >>
+    >> r = Redis(protocol=3)
+    >> p = r.pubsub(push_handler_func=our_func)
+
+In the example above, upon receipt of a push notification, rather than log the message, in the case where specific text occurs, an IOError is raised. This example, highlights how one could start implementing a customized message handler.

From d5c2d1d42ed9f653d450e6127cb6f673f43fb2d0 Mon Sep 17 00:00:00 2001
From: shacharPash <93581407+shacharPash@users.noreply.github.com>
Date: Tue, 8 Aug 2023 14:06:04 +0300
Subject: [PATCH 0761/1164] Adding support for triggered functions (TFUNCTION)
 (#2861)

Co-authored-by: Chayim I. Kirshen <c@kirshen.com>
Co-authored-by: dvora-h <dvora.heller@redis.com>
Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 dockers/cluster.redis.conf |   1 +
 redis/cluster.py           |   6 ++
 redis/commands/cluster.py  |  10 +++
 redis/commands/core.py     | 127 +++++++++++++++++++++++++++++++++++++
 tests/test_cluster.py      |  51 +++++++++++++++
 tests/test_commands.py     |  51 +++++++++++++++
 6 files changed, 246 insertions(+)

diff --git a/dockers/cluster.redis.conf b/dockers/cluster.redis.conf
index cd5c08b7b8..d4de46fbed 100644
--- a/dockers/cluster.redis.conf
+++ b/dockers/cluster.redis.conf
@@ -5,3 +5,4 @@ loadmodule /opt/redis-stack/lib/redisgraph.so
 loadmodule /opt/redis-stack/lib/redistimeseries.so
 loadmodule /opt/redis-stack/lib/rejson.so
 loadmodule /opt/redis-stack/lib/redisbloom.so
+loadmodule /opt/redis-stack/lib/redisgears.so v8-plugin-path /opt/redis-stack/lib/libredisgears_v8_plugin.so
diff --git a/redis/cluster.py b/redis/cluster.py
index 3549ced35d..0c33fd2c68 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -282,6 +282,11 @@ class AbstractRedisCluster:
                 "READONLY",
                 "READWRITE",
                 "TIME",
+                "TFUNCTION LOAD",
+                "TFUNCTION DELETE",
+                "TFUNCTION LIST",
+                "TFCALL",
+                "TFCALLASYNC",
                 "GRAPH.CONFIG",
                 "LATENCY HISTORY",
                 "LATENCY LATEST",
@@ -298,6 +303,7 @@ class AbstractRedisCluster:
                 "FUNCTION LIST",
                 "FUNCTION LOAD",
                 "FUNCTION RESTORE",
+                "REDISGEARS_2.REFRESHCLUSTER",
                 "SCAN",
                 "SCRIPT EXISTS",
                 "SCRIPT FLUSH",
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index cd93a85aba..691cab3def 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -30,10 +30,12 @@
     AsyncACLCommands,
     AsyncDataAccessCommands,
     AsyncFunctionCommands,
+    AsyncGearsCommands,
     AsyncManagementCommands,
     AsyncScriptCommands,
     DataAccessCommands,
     FunctionCommands,
+    GearsCommands,
     ManagementCommands,
     PubSubCommands,
     ResponseT,
@@ -689,6 +691,12 @@ def readwrite(self, target_nodes: Optional["TargetNodesT"] = None) -> ResponseT:
         self.read_from_replicas = False
         return self.execute_command("READWRITE", target_nodes=target_nodes)
 
+    def gears_refresh_cluster(self, **kwargs) -> ResponseT:
+        """
+        On an OSS cluster, before executing any gears function, you must call this command. # noqa
+        """
+        return self.execute_command("REDISGEARS_2.REFRESHCLUSTER", **kwargs)
+
 
 class AsyncClusterManagementCommands(
     ClusterManagementCommands, AsyncManagementCommands
@@ -864,6 +872,7 @@ class RedisClusterCommands(
     ClusterDataAccessCommands,
     ScriptCommands,
     FunctionCommands,
+    GearsCommands,
     RedisModuleCommands,
 ):
     """
@@ -893,6 +902,7 @@ class AsyncRedisClusterCommands(
     AsyncClusterDataAccessCommands,
     AsyncScriptCommands,
     AsyncFunctionCommands,
+    AsyncGearsCommands,
 ):
     """
     A class for all Redis Cluster commands
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 8b1b711df9..09ec59f47c 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -6105,6 +6105,131 @@ def function_stats(self) -> Union[Awaitable[List], List]:
 AsyncFunctionCommands = FunctionCommands
 
 
+class GearsCommands:
+    def tfunction_load(
+        self, lib_code: str, replace: bool = False, config: Union[str, None] = None
+    ) -> ResponseT:
+        """
+        Load a new library to RedisGears.
+
+        ``lib_code`` - the library code.
+        ``config`` - a string representation of a JSON object
+        that will be provided to the library on load time,
+        for more information refer to
+        https://github.com/RedisGears/RedisGears/blob/master/docs/function_advance_topics.md#library-configuration
+        ``replace`` - an optional argument, instructs RedisGears to replace the
+        function if its already exists
+
+        For more information see https://redis.io/commands/tfunction-load/
+        """
+        pieces = []
+        if replace:
+            pieces.append("REPLACE")
+        if config is not None:
+            pieces.extend(["CONFIG", config])
+        pieces.append(lib_code)
+        return self.execute_command("TFUNCTION LOAD", *pieces)
+
+    def tfunction_delete(self, lib_name: str) -> ResponseT:
+        """
+        Delete a library from RedisGears.
+
+        ``lib_name`` the library name to delete.
+
+        For more information see https://redis.io/commands/tfunction-delete/
+        """
+        return self.execute_command("TFUNCTION DELETE", lib_name)
+
+    def tfunction_list(
+        self,
+        with_code: bool = False,
+        verbose: int = 0,
+        lib_name: Union[str, None] = None,
+    ) -> ResponseT:
+        """
+        List the functions with additional information about each function.
+
+        ``with_code`` Show libraries code.
+        ``verbose`` output verbosity level, higher number will increase verbosity level
+        ``lib_name`` specifying a library name (can be used multiple times to show multiple libraries in a single command) # noqa
+
+        For more information see https://redis.io/commands/tfunction-list/
+        """
+        pieces = []
+        if with_code:
+            pieces.append("WITHCODE")
+        if verbose >= 1 and verbose <= 3:
+            pieces.append("v" * verbose)
+        else:
+            raise DataError("verbose can be 1, 2 or 3")
+        if lib_name is not None:
+            pieces.append("LIBRARY")
+            pieces.append(lib_name)
+
+        return self.execute_command("TFUNCTION LIST", *pieces)
+
+    def _tfcall(
+        self,
+        lib_name: str,
+        func_name: str,
+        keys: KeysT = None,
+        _async: bool = False,
+        *args: List,
+    ) -> ResponseT:
+        pieces = [f"{lib_name}.{func_name}"]
+        if keys is not None:
+            pieces.append(len(keys))
+            pieces.extend(keys)
+        else:
+            pieces.append(0)
+        if args is not None:
+            pieces.extend(args)
+        if _async:
+            return self.execute_command("TFCALLASYNC", *pieces)
+        return self.execute_command("TFCALL", *pieces)
+
+    def tfcall(
+        self,
+        lib_name: str,
+        func_name: str,
+        keys: KeysT = None,
+        *args: List,
+    ) -> ResponseT:
+        """
+        Invoke a function.
+
+        ``lib_name`` - the library name contains the function.
+        ``func_name`` - the function name to run.
+        ``keys`` - the keys that will be touched by the function.
+        ``args`` - Additional argument to pass to the function.
+
+        For more information see https://redis.io/commands/tfcall/
+        """
+        return self._tfcall(lib_name, func_name, keys, False, *args)
+
+    def tfcall_async(
+        self,
+        lib_name: str,
+        func_name: str,
+        keys: KeysT = None,
+        *args: List,
+    ) -> ResponseT:
+        """
+        Invoke an async function (coroutine).
+
+        ``lib_name`` - the library name contains the function.
+        ``func_name`` - the function name to run.
+        ``keys`` - the keys that will be touched by the function.
+        ``args`` - Additional argument to pass to the function.
+
+        For more information see https://redis.io/commands/tfcall/
+        """
+        return self._tfcall(lib_name, func_name, keys, True, *args)
+
+
+AsyncGearsCommands = GearsCommands
+
+
 class DataAccessCommands(
     BasicKeyCommands,
     HyperlogCommands,
@@ -6148,6 +6273,7 @@ class CoreCommands(
     PubSubCommands,
     ScriptCommands,
     FunctionCommands,
+    GearsCommands,
 ):
     """
     A class containing all of the implemented redis commands. This class is
@@ -6164,6 +6290,7 @@ class AsyncCoreCommands(
     AsyncPubSubCommands,
     AsyncScriptCommands,
     AsyncFunctionCommands,
+    AsyncGearsCommands,
 ):
     """
     A class containing all of the implemented redis commands. This class is
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 84654e70c3..239927f484 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -2431,6 +2431,57 @@ def teardown():
         assert "client-info" in r.acl_log(count=1, target_nodes=node)[0]
         assert r.acl_log_reset(target_nodes=node)
 
+    def generate_lib_code(self, lib_name):
+        return f"""#!js api_version=1.0 name={lib_name}\n redis.registerFunction('foo', ()=>{{return 'bar'}})"""  # noqa
+
+    def try_delete_libs(self, r, *lib_names):
+        for lib_name in lib_names:
+            try:
+                r.tfunction_delete(lib_name)
+            except Exception:
+                pass
+
+    @skip_if_server_version_lt("7.1.140")
+    def test_tfunction_load_delete(self, r):
+        r.gears_refresh_cluster()
+        self.try_delete_libs(r, "lib1")
+        lib_code = self.generate_lib_code("lib1")
+        assert r.tfunction_load(lib_code)
+        assert r.tfunction_delete("lib1")
+
+    @skip_if_server_version_lt("7.1.140")
+    def test_tfunction_list(self, r):
+        r.gears_refresh_cluster()
+        self.try_delete_libs(r, "lib1", "lib2", "lib3")
+        assert r.tfunction_load(self.generate_lib_code("lib1"))
+        assert r.tfunction_load(self.generate_lib_code("lib2"))
+        assert r.tfunction_load(self.generate_lib_code("lib3"))
+
+        # test error thrown when verbose > 4
+        with pytest.raises(DataError):
+            assert r.tfunction_list(verbose=8)
+
+        functions = r.tfunction_list(verbose=1)
+        assert len(functions) == 3
+
+        expected_names = [b"lib1", b"lib2", b"lib3"]
+        actual_names = [functions[0][13], functions[1][13], functions[2][13]]
+
+        assert sorted(expected_names) == sorted(actual_names)
+        assert r.tfunction_delete("lib1")
+        assert r.tfunction_delete("lib2")
+        assert r.tfunction_delete("lib3")
+
+    @skip_if_server_version_lt("7.1.140")
+    def test_tfcall(self, r):
+        r.gears_refresh_cluster()
+        self.try_delete_libs(r, "lib1")
+        assert r.tfunction_load(self.generate_lib_code("lib1"))
+        assert r.tfcall("lib1", "foo") == b"bar"
+        assert r.tfcall_async("lib1", "foo") == b"bar"
+
+        assert r.tfunction_delete("lib1")
+
 
 @pytest.mark.onlycluster
 class TestNodesManager:
diff --git a/tests/test_commands.py b/tests/test_commands.py
index fdf41dc5fa..9540f7f20c 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1791,6 +1791,57 @@ def test_substr(self, r):
         assert r.substr("a", 3, 5) == b"345"
         assert r.substr("a", 3, -2) == b"345678"
 
+    def generate_lib_code(self, lib_name):
+        return f"""#!js api_version=1.0 name={lib_name}\n redis.registerFunction('foo', ()=>{{return 'bar'}})"""  # noqa
+
+    def try_delete_libs(self, r, *lib_names):
+        for lib_name in lib_names:
+            try:
+                r.tfunction_delete(lib_name)
+            except Exception:
+                pass
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("7.1.140")
+    def test_tfunction_load_delete(self, r):
+        self.try_delete_libs(r, "lib1")
+        lib_code = self.generate_lib_code("lib1")
+        assert r.tfunction_load(lib_code)
+        assert r.tfunction_delete("lib1")
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("7.1.140")
+    def test_tfunction_list(self, r):
+        self.try_delete_libs(r, "lib1", "lib2", "lib3")
+        assert r.tfunction_load(self.generate_lib_code("lib1"))
+        assert r.tfunction_load(self.generate_lib_code("lib2"))
+        assert r.tfunction_load(self.generate_lib_code("lib3"))
+
+        # test error thrown when verbose > 4
+        with pytest.raises(redis.exceptions.DataError):
+            assert r.tfunction_list(verbose=8)
+
+        functions = r.tfunction_list(verbose=1)
+        assert len(functions) == 3
+
+        expected_names = [b"lib1", b"lib2", b"lib3"]
+        actual_names = [functions[0][13], functions[1][13], functions[2][13]]
+
+        assert sorted(expected_names) == sorted(actual_names)
+        assert r.tfunction_delete("lib1")
+        assert r.tfunction_delete("lib2")
+        assert r.tfunction_delete("lib3")
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("7.1.140")
+    def test_tfcall(self, r):
+        self.try_delete_libs(r, "lib1")
+        assert r.tfunction_load(self.generate_lib_code("lib1"))
+        assert r.tfcall("lib1", "foo") == b"bar"
+        assert r.tfcall_async("lib1", "foo") == b"bar"
+
+        assert r.tfunction_delete("lib1")
+
     def test_ttl(self, r):
         r["a"] = "1"
         assert r.expire("a", 10)

From f121cf29e7d7fb5c85c5915ba5ce10a20826e8c0 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 9 Aug 2023 11:14:54 +0300
Subject: [PATCH 0762/1164] Add support for `CLIENT SETINFO` (#2857)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Kristján Valur Jónsson <sweskman@gmail.com>
Co-authored-by: Chayim <chayim@users.noreply.github.com>
Co-authored-by: Chayim I. Kirshen <c@kirshen.com>
---
 .flake8                               |  9 +++++++--
 redis/_parsers/helpers.py             |  4 ++--
 redis/asyncio/client.py               | 12 +++++++++++-
 redis/asyncio/cluster.py              |  6 +++++-
 redis/asyncio/connection.py           | 24 ++++++++++++++++++++++--
 redis/client.py                       | 12 +++++++++++-
 redis/cluster.py                      |  3 +++
 redis/commands/core.py                |  7 +++++++
 redis/connection.py                   | 20 ++++++++++++++++++++
 redis/utils.py                        | 14 ++++++++++++++
 tests/conftest.py                     |  5 ++---
 tests/test_asyncio/conftest.py        | 12 ++++++++++++
 tests/test_asyncio/test_cluster.py    |  2 +-
 tests/test_asyncio/test_commands.py   | 22 +++++++++++++++++++++-
 tests/test_asyncio/test_connection.py | 23 ++++++++++++++++-------
 tests/test_cluster.py                 |  2 +-
 tests/test_commands.py                | 23 ++++++++++++++++++++++-
 tests/test_lock.py                    |  6 ++++--
 18 files changed, 181 insertions(+), 25 deletions(-)

diff --git a/.flake8 b/.flake8
index 0e0ace6a4a..6c663473e4 100644
--- a/.flake8
+++ b/.flake8
@@ -15,7 +15,12 @@ exclude =
     whitelist.py,
     tasks.py
 ignore =
+    E126
+    E203
     F405
+    N801
+    N802
+    N803
+    N806
+    N815
     W503
-    E203
-    E126
\ No newline at end of file
diff --git a/redis/_parsers/helpers.py b/redis/_parsers/helpers.py
index ab4ede1fd0..fb5da831fe 100644
--- a/redis/_parsers/helpers.py
+++ b/redis/_parsers/helpers.py
@@ -629,8 +629,7 @@ def parse_client_info(value):
     "key1=value1 key2=value2 key3=value3"
     """
     client_info = {}
-    infos = str_if_bytes(value).split(" ")
-    for info in infos:
+    for info in str_if_bytes(value).strip().split():
         key, value = info.split("=")
         client_info[key] = value
 
@@ -700,6 +699,7 @@ def string_keys_to_dict(key_string, callback):
     "CLIENT KILL": parse_client_kill,
     "CLIENT LIST": parse_client_list,
     "CLIENT PAUSE": bool_ok,
+    "CLIENT SETINFO": bool_ok,
     "CLIENT SETNAME": bool_ok,
     "CLIENT UNBLOCK": bool,
     "CLUSTER ADDSLOTS": bool_ok,
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 0e3c879278..f0c1ab7536 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -62,7 +62,13 @@
     WatchError,
 )
 from redis.typing import ChannelT, EncodableT, KeyT
-from redis.utils import HIREDIS_AVAILABLE, _set_info_logger, safe_str, str_if_bytes
+from redis.utils import (
+    HIREDIS_AVAILABLE,
+    _set_info_logger,
+    get_lib_version,
+    safe_str,
+    str_if_bytes,
+)
 
 PubSubHandler = Callable[[Dict[str, str]], Awaitable[None]]
 _KeyT = TypeVar("_KeyT", bound=KeyT)
@@ -190,6 +196,8 @@ def __init__(
         single_connection_client: bool = False,
         health_check_interval: int = 0,
         client_name: Optional[str] = None,
+        lib_name: Optional[str] = "redis-py",
+        lib_version: Optional[str] = get_lib_version(),
         username: Optional[str] = None,
         retry: Optional[Retry] = None,
         auto_close_connection_pool: bool = True,
@@ -232,6 +240,8 @@ def __init__(
                 "max_connections": max_connections,
                 "health_check_interval": health_check_interval,
                 "client_name": client_name,
+                "lib_name": lib_name,
+                "lib_version": lib_version,
                 "redis_connect_func": redis_connect_func,
                 "protocol": protocol,
             }
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 9e2a40ce1b..84407116ed 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -62,7 +62,7 @@
     TryAgainError,
 )
 from redis.typing import AnyKeyT, EncodableT, KeyT
-from redis.utils import dict_merge, safe_str, str_if_bytes
+from redis.utils import dict_merge, get_lib_version, safe_str, str_if_bytes
 
 TargetNodesT = TypeVar(
     "TargetNodesT", str, "ClusterNode", List["ClusterNode"], Dict[Any, "ClusterNode"]
@@ -237,6 +237,8 @@ def __init__(
         username: Optional[str] = None,
         password: Optional[str] = None,
         client_name: Optional[str] = None,
+        lib_name: Optional[str] = "redis-py",
+        lib_version: Optional[str] = get_lib_version(),
         # Encoding related kwargs
         encoding: str = "utf-8",
         encoding_errors: str = "strict",
@@ -288,6 +290,8 @@ def __init__(
             "username": username,
             "password": password,
             "client_name": client_name,
+            "lib_name": lib_name,
+            "lib_version": lib_version,
             # Encoding related kwargs
             "encoding": encoding,
             "encoding_errors": encoding_errors,
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index d501989c83..c1cc1d310c 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -49,7 +49,7 @@
     TimeoutError,
 )
 from redis.typing import EncodableT
-from redis.utils import HIREDIS_AVAILABLE, str_if_bytes
+from redis.utils import HIREDIS_AVAILABLE, get_lib_version, str_if_bytes
 
 from .._parsers import (
     BaseParser,
@@ -101,6 +101,8 @@ class AbstractConnection:
         "db",
         "username",
         "client_name",
+        "lib_name",
+        "lib_version",
         "credential_provider",
         "password",
         "socket_timeout",
@@ -140,6 +142,8 @@ def __init__(
         socket_read_size: int = 65536,
         health_check_interval: float = 0,
         client_name: Optional[str] = None,
+        lib_name: Optional[str] = "redis-py",
+        lib_version: Optional[str] = get_lib_version(),
         username: Optional[str] = None,
         retry: Optional[Retry] = None,
         redis_connect_func: Optional[ConnectCallbackT] = None,
@@ -157,6 +161,8 @@ def __init__(
         self.pid = os.getpid()
         self.db = db
         self.client_name = client_name
+        self.lib_name = lib_name
+        self.lib_version = lib_version
         self.credential_provider = credential_provider
         self.password = password
         self.username = username
@@ -347,9 +353,23 @@ async def on_connect(self) -> None:
             if str_if_bytes(await self.read_response()) != "OK":
                 raise ConnectionError("Error setting client name")
 
-        # if a database is specified, switch to it
+        # set the library name and version, pipeline for lower startup latency
+        if self.lib_name:
+            await self.send_command("CLIENT", "SETINFO", "LIB-NAME", self.lib_name)
+        if self.lib_version:
+            await self.send_command("CLIENT", "SETINFO", "LIB-VER", self.lib_version)
+        # if a database is specified, switch to it. Also pipeline this
         if self.db:
             await self.send_command("SELECT", self.db)
+
+        # read responses from pipeline
+        for _ in (sent for sent in (self.lib_name, self.lib_version) if sent):
+            try:
+                await self.read_response()
+            except ResponseError:
+                pass
+
+        if self.db:
             if str_if_bytes(await self.read_response()) != "OK":
                 raise ConnectionError("Invalid Database")
 
diff --git a/redis/client.py b/redis/client.py
index a856ef84ad..f695cef534 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -31,7 +31,13 @@
 )
 from redis.lock import Lock
 from redis.retry import Retry
-from redis.utils import HIREDIS_AVAILABLE, _set_info_logger, safe_str, str_if_bytes
+from redis.utils import (
+    HIREDIS_AVAILABLE,
+    _set_info_logger,
+    get_lib_version,
+    safe_str,
+    str_if_bytes,
+)
 
 SYM_EMPTY = b""
 EMPTY_RESPONSE = "EMPTY_RESPONSE"
@@ -171,6 +177,8 @@ def __init__(
         single_connection_client=False,
         health_check_interval=0,
         client_name=None,
+        lib_name="redis-py",
+        lib_version=get_lib_version(),
         username=None,
         retry=None,
         redis_connect_func=None,
@@ -222,6 +230,8 @@ def __init__(
                 "max_connections": max_connections,
                 "health_check_interval": health_check_interval,
                 "client_name": client_name,
+                "lib_name": lib_name,
+                "lib_version": lib_version,
                 "redis_connect_func": redis_connect_func,
                 "credential_provider": credential_provider,
                 "protocol": protocol,
diff --git a/redis/cluster.py b/redis/cluster.py
index 0c33fd2c68..1ffa5ff547 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -143,6 +143,8 @@ def parse_cluster_myshardid(resp, **options):
     "encoding_errors",
     "errors",
     "host",
+    "lib_name",
+    "lib_version",
     "max_connections",
     "nodes_flag",
     "redis_connect_func",
@@ -225,6 +227,7 @@ class AbstractRedisCluster:
                 "ACL WHOAMI",
                 "AUTH",
                 "CLIENT LIST",
+                "CLIENT SETINFO",
                 "CLIENT SETNAME",
                 "CLIENT GETNAME",
                 "CONFIG SET",
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 09ec59f47c..031781d75d 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -708,6 +708,13 @@ def client_setname(self, name: str, **kwargs) -> ResponseT:
         """
         return self.execute_command("CLIENT SETNAME", name, **kwargs)
 
+    def client_setinfo(self, attr: str, value: str, **kwargs) -> ResponseT:
+        """
+        Sets the current connection library name or version
+        For mor information see https://redis.io/commands/client-setinfo
+        """
+        return self.execute_command("CLIENT SETINFO", attr, value, **kwargs)
+
     def client_unblock(
         self, client_id: int, error: bool = False, **kwargs
     ) -> ResponseT:
diff --git a/redis/connection.py b/redis/connection.py
index 66debed2ea..00d293a238 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -31,6 +31,7 @@
     HIREDIS_AVAILABLE,
     HIREDIS_PACK_AVAILABLE,
     SSL_AVAILABLE,
+    get_lib_version,
     str_if_bytes,
 )
 
@@ -140,6 +141,8 @@ def __init__(
         socket_read_size=65536,
         health_check_interval=0,
         client_name=None,
+        lib_name="redis-py",
+        lib_version=get_lib_version(),
         username=None,
         retry=None,
         redis_connect_func=None,
@@ -164,6 +167,8 @@ def __init__(
         self.pid = os.getpid()
         self.db = db
         self.client_name = client_name
+        self.lib_name = lib_name
+        self.lib_version = lib_version
         self.credential_provider = credential_provider
         self.password = password
         self.username = username
@@ -360,6 +365,21 @@ def on_connect(self):
             if str_if_bytes(self.read_response()) != "OK":
                 raise ConnectionError("Error setting client name")
 
+        try:
+            # set the library name and version
+            if self.lib_name:
+                self.send_command("CLIENT", "SETINFO", "LIB-NAME", self.lib_name)
+                self.read_response()
+        except ResponseError:
+            pass
+
+        try:
+            if self.lib_version:
+                self.send_command("CLIENT", "SETINFO", "LIB-VER", self.lib_version)
+                self.read_response()
+        except ResponseError:
+            pass
+
         # if a database is specified, switch to it
         if self.db:
             self.send_command("SELECT", self.db)
diff --git a/redis/utils.py b/redis/utils.py
index 148d15246b..01fdfed7a2 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -1,4 +1,5 @@
 import logging
+import sys
 from contextlib import contextmanager
 from functools import wraps
 from typing import Any, Dict, Mapping, Union
@@ -27,6 +28,11 @@
 except ImportError:
     CRYPTOGRAPHY_AVAILABLE = False
 
+if sys.version_info >= (3, 8):
+    from importlib import metadata
+else:
+    import importlib_metadata as metadata
+
 
 def from_url(url, **kwargs):
     """
@@ -131,3 +137,11 @@ def _set_info_logger():
         handler = logging.StreamHandler()
         handler.setLevel(logging.INFO)
         logger.addHandler(handler)
+
+
+def get_lib_version():
+    try:
+        libver = metadata.version("redis")
+    except metadata.PackageNotFoundError:
+        libver = "99.99.99"
+    return libver
diff --git a/tests/conftest.py b/tests/conftest.py
index b3c410e51b..16f3fbb9db 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -131,6 +131,7 @@ def pytest_sessionstart(session):
         enterprise = info["enterprise"]
     except redis.ConnectionError:
         # provide optimistic defaults
+        info = {}
         version = "10.0.0"
         arch_bits = 64
         cluster_enabled = False
@@ -145,9 +146,7 @@ def pytest_sessionstart(session):
     # module info
     try:
         REDIS_INFO["modules"] = info["modules"]
-    except redis.exceptions.ConnectionError:
-        pass
-    except KeyError:
+    except (KeyError, redis.exceptions.ConnectionError):
         pass
 
     if cluster_enabled:
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index e5da3f8f46..c837f284f7 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -253,3 +253,15 @@ async def __aexit__(self, exc_type, exc_inst, tb):
 
 def asynccontextmanager(func):
     return _asynccontextmanager(func)
+
+
+# helpers to get the connection arguments for this run
+@pytest.fixture()
+def redis_url(request):
+    return request.config.getoption("--redis-url")
+
+
+@pytest.fixture()
+def connect_args(request):
+    url = request.config.getoption("--redis-url")
+    return parse_url(url)
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index eb7aafdf68..1cb1fa5195 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -2294,7 +2294,7 @@ async def test_acl_log(
             await user_client.hset("{cache}:0", "hkey", "hval")
 
         assert isinstance(await r.acl_log(target_nodes=node), list)
-        assert len(await r.acl_log(target_nodes=node)) == 2
+        assert len(await r.acl_log(target_nodes=node)) == 3
         assert len(await r.acl_log(count=1, target_nodes=node)) == 1
         assert isinstance((await r.acl_log(target_nodes=node))[0], dict)
         assert "client-info" in (await r.acl_log(count=1, target_nodes=node))[0]
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 08e66b050f..7808d171fa 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -273,7 +273,7 @@ async def test_acl_log(self, r_teardown, create_redis):
             await user_client.hset("cache:0", "hkey", "hval")
 
         assert isinstance(await r.acl_log(), list)
-        assert len(await r.acl_log()) == 2
+        assert len(await r.acl_log()) == 3
         assert len(await r.acl_log(count=1)) == 1
         assert isinstance((await r.acl_log())[0], dict)
         expected = (await r.acl_log(count=1))[0]
@@ -355,6 +355,26 @@ async def test_client_setname(self, r: redis.Redis):
             r, await r.client_getname(), "redis_py_test", b"redis_py_test"
         )
 
+    @skip_if_server_version_lt("7.2.0")
+    async def test_client_setinfo(self, r: redis.Redis):
+        await r.ping()
+        info = await r.client_info()
+        assert info["lib-name"] == "redis-py"
+        assert info["lib-ver"] == redis.__version__
+        assert await r.client_setinfo("lib-name", "test")
+        assert await r.client_setinfo("lib-ver", "123")
+        info = await r.client_info()
+        assert info["lib-name"] == "test"
+        assert info["lib-ver"] == "123"
+        r2 = redis.asyncio.Redis(lib_name="test2", lib_version="1234")
+        info = await r2.client_info()
+        assert info["lib-name"] == "test2"
+        assert info["lib-ver"] == "1234"
+        r3 = redis.asyncio.Redis(lib_name=None, lib_version=None)
+        info = await r3.client_info()
+        assert info["lib-name"] == ""
+        assert info["lib-ver"] == ""
+
     @skip_if_server_version_lt("2.6.9")
     @pytest.mark.onlynoncluster
     async def test_client_kill(self, r: redis.Redis, r2):
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index 9a729392b8..d1aad796e7 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -125,9 +125,11 @@ async def test_can_run_concurrent_commands(r):
     assert all(await asyncio.gather(*(r.ping() for _ in range(10))))
 
 
-async def test_connect_retry_on_timeout_error():
+async def test_connect_retry_on_timeout_error(connect_args):
     """Test that the _connect function is retried in case of a timeout"""
-    conn = Connection(retry_on_timeout=True, retry=Retry(NoBackoff(), 3))
+    conn = Connection(
+        retry_on_timeout=True, retry=Retry(NoBackoff(), 3), **connect_args
+    )
     origin_connect = conn._connect
     conn._connect = mock.AsyncMock()
 
@@ -200,7 +202,7 @@ async def test_connection_parse_response_resume(r: redis.Redis):
     [_AsyncRESP2Parser, _AsyncRESP3Parser, _AsyncHiredisParser],
     ids=["AsyncRESP2Parser", "AsyncRESP3Parser", "AsyncHiredisParser"],
 )
-async def test_connection_disconect_race(parser_class):
+async def test_connection_disconect_race(parser_class, connect_args):
     """
     This test reproduces the case in issue #2349
     where a connection is closed while the parser is reading to feed the
@@ -215,10 +217,9 @@ async def test_connection_disconect_race(parser_class):
     if parser_class == _AsyncHiredisParser and not HIREDIS_AVAILABLE:
         pytest.skip("Hiredis not available")
 
-    args = {}
-    args["parser_class"] = parser_class
+    connect_args["parser_class"] = parser_class
 
-    conn = Connection(**args)
+    conn = Connection(**connect_args)
 
     cond = asyncio.Condition()
     # 0 == initial
@@ -267,8 +268,16 @@ async def do_read():
     async def open_connection(*args, **kwargs):
         return reader, writer
 
+    async def dummy_method(*args, **kwargs):
+        pass
+
+    # get dummy stream objects for the connection
     with patch.object(asyncio, "open_connection", open_connection):
-        await conn.connect()
+        # disable the initial version handshake
+        with patch.multiple(
+            conn, send_command=dummy_method, read_response=dummy_method
+        ):
+            await conn.connect()
 
     vals = await asyncio.gather(do_read(), do_close())
     assert vals == [b"Hello, World!", None]
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 239927f484..ae194db3a2 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -2425,7 +2425,7 @@ def teardown():
             user_client.hset("{cache}:0", "hkey", "hval")
 
         assert isinstance(r.acl_log(target_nodes=node), list)
-        assert len(r.acl_log(target_nodes=node)) == 2
+        assert len(r.acl_log(target_nodes=node)) == 3
         assert len(r.acl_log(count=1, target_nodes=node)) == 1
         assert isinstance(r.acl_log(target_nodes=node)[0], dict)
         assert "client-info" in r.acl_log(count=1, target_nodes=node)[0]
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 9540f7f20c..055aa3bf9f 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -396,7 +396,7 @@ def teardown():
             user_client.hset("cache:0", "hkey", "hval")
 
         assert isinstance(r.acl_log(), list)
-        assert len(r.acl_log()) == 2
+        assert len(r.acl_log()) == 3
         assert len(r.acl_log(count=1)) == 1
         assert isinstance(r.acl_log()[0], dict)
         expected = r.acl_log(count=1)[0]
@@ -554,6 +554,26 @@ def test_client_setname(self, r):
         assert r.client_setname("redis_py_test")
         assert_resp_response(r, r.client_getname(), "redis_py_test", b"redis_py_test")
 
+    @skip_if_server_version_lt("7.2.0")
+    def test_client_setinfo(self, r: redis.Redis):
+        r.ping()
+        info = r.client_info()
+        assert info["lib-name"] == "redis-py"
+        assert info["lib-ver"] == redis.__version__
+        assert r.client_setinfo("lib-name", "test")
+        assert r.client_setinfo("lib-ver", "123")
+        info = r.client_info()
+        assert info["lib-name"] == "test"
+        assert info["lib-ver"] == "123"
+        r2 = redis.Redis(lib_name="test2", lib_version="1234")
+        info = r2.client_info()
+        assert info["lib-name"] == "test2"
+        assert info["lib-ver"] == "1234"
+        r3 = redis.Redis(lib_name=None, lib_version=None)
+        info = r3.client_info()
+        assert info["lib-name"] == ""
+        assert info["lib-ver"] == ""
+
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.6.9")
     def test_client_kill(self, r, r2):
@@ -5066,6 +5086,7 @@ def test_shutdown_with_params(self, r: redis.Redis):
         r.execute_command.assert_called_with("SHUTDOWN", "ABORT")
 
     @pytest.mark.replica
+    @pytest.mark.xfail(strict=False)
     @skip_if_server_version_lt("2.8.0")
     @skip_if_redis_enterprise()
     def test_sync(self, r):
diff --git a/tests/test_lock.py b/tests/test_lock.py
index b4b9b32917..b34f7f0159 100644
--- a/tests/test_lock.py
+++ b/tests/test_lock.py
@@ -101,11 +101,12 @@ def test_blocking_timeout(self, r):
         assert lock1.acquire(blocking=False)
         bt = 0.4
         sleep = 0.05
+        fudge_factor = 0.05
         lock2 = self.get_lock(r, "foo", sleep=sleep, blocking_timeout=bt)
         start = time.monotonic()
         assert not lock2.acquire()
         # The elapsed duration should be less than the total blocking_timeout
-        assert bt > (time.monotonic() - start) > bt - sleep
+        assert (bt + fudge_factor) > (time.monotonic() - start) > bt - sleep
         lock1.release()
 
     def test_context_manager(self, r):
@@ -119,11 +120,12 @@ def test_context_manager_blocking_timeout(self, r):
         with self.get_lock(r, "foo", blocking=False):
             bt = 0.4
             sleep = 0.05
+            fudge_factor = 0.05
             lock2 = self.get_lock(r, "foo", sleep=sleep, blocking_timeout=bt)
             start = time.monotonic()
             assert not lock2.acquire()
             # The elapsed duration should be less than the total blocking_timeout
-            assert bt > (time.monotonic() - start) > bt - sleep
+            assert (bt + fudge_factor) > (time.monotonic() - start) > bt - sleep
 
     def test_context_manager_raises_when_locked_not_acquired(self, r):
         r.set("foo", "bar")

From 2f679261b7ef0e7372868cacd8ba8721406eb495 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 9 Aug 2023 15:25:27 +0300
Subject: [PATCH 0763/1164] Version 5.0.0 (#2874)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 1936dc1336..475e3565fa 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="5.0.0rc2",
+    version="5.0.0",
     packages=find_packages(
         include=[
             "redis",

From 28cc65c18cc4fb37ef14497c963eb181dba8d25d Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 10 Aug 2023 11:44:47 +0300
Subject: [PATCH 0764/1164] Updating all client licenses to clearly be MIT
 (#2884)

---
 LICENSE | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/LICENSE b/LICENSE
index 00aee10d6a..8509ccd678 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2022, Redis, inc.
+Copyright (c) 2022-2023, Redis, inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

From 6968431983c20a6f874a97d92c4d11366721b83b Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 21 Aug 2023 09:36:39 +0300
Subject: [PATCH 0765/1164] Fix redis 7.2.0 tests (#2902)

* Fix redis 7.2.0 tests

* revert

* revert geo

* fix cluster myshardid

* linters
---
 redis/cluster.py                    |  1 +
 tests/test_asyncio/test_commands.py | 32 +++++++++++------------------
 tests/test_commands.py              | 30 +++++++++------------------
 3 files changed, 23 insertions(+), 40 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index 1ffa5ff547..cba62de077 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -267,6 +267,7 @@ class AbstractRedisCluster:
                 "READONLY",
                 "CLUSTER INFO",
                 "CLUSTER MEET",
+                "CLUSTER MYSHARDID",
                 "CLUSTER NODES",
                 "CLUSTER REPLICAS",
                 "CLUSTER RESET",
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 7808d171fa..6a3a2eca59 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -489,20 +489,6 @@ async def test_client_no_touch(self, r: redis.Redis):
         with pytest.raises(TypeError):
             await r.client_no_touch()
 
-    @skip_if_server_version_lt("7.2.0")
-    @pytest.mark.onlycluster
-    async def test_waitaof(self, r):
-        # must return a list of 2 elements
-        assert len(await r.waitaof(0, 0, 0)) == 2
-        assert len(await r.waitaof(1, 0, 0)) == 2
-        assert len(await r.waitaof(1, 0, 1000)) == 2
-
-        # value is out of range, value must between 0 and 1
-        with pytest.raises(exceptions.ResponseError):
-            await r.waitaof(2, 0, 0)
-        with pytest.raises(exceptions.ResponseError):
-            await r.waitaof(-1, 0, 0)
-
     async def test_config_get(self, r: redis.Redis):
         data = await r.config_get()
         assert "maxmemory" in data
@@ -1821,9 +1807,11 @@ async def test_zrank(self, r: redis.Redis):
     async def test_zrank_withscore(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
         assert await r.zrank("a", "a1") == 0
-        assert await r.rank("a", "a2") == 1
+        assert await r.zrank("a", "a2") == 1
         assert await r.zrank("a", "a6") is None
-        assert await r.zrank("a", "a3", withscore=True) == [2, "3"]
+        assert_resp_response(
+            r, await r.zrank("a", "a3", withscore=True), [2, b"3"], [2, 3.0]
+        )
         assert await r.zrank("a", "a6", withscore=True) is None
 
     async def test_zrem(self, r: redis.Redis):
@@ -1920,7 +1908,9 @@ async def test_zrevrank_withscore(self, r: redis.Redis):
         assert await r.zrevrank("a", "a1") == 4
         assert await r.zrevrank("a", "a2") == 3
         assert await r.zrevrank("a", "a6") is None
-        assert await r.zrevrank("a", "a3", withscore=True) == [2, "3"]
+        assert_resp_response(
+            r, await r.zrevrank("a", "a3", withscore=True), [2, b"3"], [2, 3.0]
+        )
         assert await r.zrevrank("a", "a6", withscore=True) is None
 
     async def test_zscore(self, r: redis.Redis):
@@ -2877,13 +2867,15 @@ async def test_xinfo_consumers(self, r: redis.Redis):
         info = await r.xinfo_consumers(stream, group)
         assert len(info) == 2
         expected = [
-            {"name": consumer1.encode(), "pending": 1, "inactive": 2},
-            {"name": consumer2.encode(), "pending": 2, "inactive": 2},
+            {"name": consumer1.encode(), "pending": 1},
+            {"name": consumer2.encode(), "pending": 2},
         ]
 
-        # we can't determine the idle time, so just make sure it's an int
+        # we can't determine the idle and inactive time, so just make sure it's an int
         assert isinstance(info[0].pop("idle"), int)
         assert isinstance(info[1].pop("idle"), int)
+        assert isinstance(info[0].pop("inactive"), int)
+        assert isinstance(info[1].pop("inactive"), int)
         assert info == expected
 
     @skip_if_server_version_lt("5.0.0")
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 055aa3bf9f..114fb6b686 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -745,20 +745,6 @@ def test_client_no_touch(self, r):
         with pytest.raises(TypeError):
             r.client_no_touch()
 
-    @pytest.mark.onlycluster
-    @skip_if_server_version_lt("7.2.0")
-    def test_waitaof(self, r):
-        # must return a list of 2 elements
-        assert len(r.waitaof(0, 0, 0)) == 2
-        assert len(r.waitaof(1, 0, 0)) == 2
-        assert len(r.waitaof(1, 0, 1000)) == 2
-
-        # value is out of range, value must between 0 and 1
-        with pytest.raises(exceptions.ResponseError):
-            r.waitaof(2, 0, 0)
-        with pytest.raises(exceptions.ResponseError):
-            r.waitaof(-1, 0, 0)
-
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("3.2.0")
     def test_client_reply(self, r, r_timeout):
@@ -2854,9 +2840,9 @@ def test_zrank(self, r):
     def test_zrank_withscore(self, r: redis.Redis):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
         assert r.zrank("a", "a1") == 0
-        assert r.rank("a", "a2") == 1
+        assert r.zrank("a", "a2") == 1
         assert r.zrank("a", "a6") is None
-        assert r.zrank("a", "a3", withscore=True) == [2, "3"]
+        assert_resp_response(r, r.zrank("a", "a3", withscore=True), [2, b"3"], [2, 3.0])
         assert r.zrank("a", "a6", withscore=True) is None
 
     def test_zrem(self, r):
@@ -2951,7 +2937,9 @@ def test_zrevrank_withscore(self, r):
         assert r.zrevrank("a", "a1") == 4
         assert r.zrevrank("a", "a2") == 3
         assert r.zrevrank("a", "a6") is None
-        assert r.zrevrank("a", "a3", withscore=True) == [2, "3"]
+        assert_resp_response(
+            r, r.zrevrank("a", "a3", withscore=True), [2, b"3"], [2, 3.0]
+        )
         assert r.zrevrank("a", "a6", withscore=True) is None
 
     def test_zscore(self, r):
@@ -4404,13 +4392,15 @@ def test_xinfo_consumers(self, r):
         info = r.xinfo_consumers(stream, group)
         assert len(info) == 2
         expected = [
-            {"name": consumer1.encode(), "pending": 1, "inactive": 2},
-            {"name": consumer2.encode(), "pending": 2, "inactive": 2},
+            {"name": consumer1.encode(), "pending": 1},
+            {"name": consumer2.encode(), "pending": 2},
         ]
 
-        # we can't determine the idle time, so just make sure it's an int
+        # we can't determine the idle and inactive time, so just make sure it's an int
         assert isinstance(info[0].pop("idle"), int)
         assert isinstance(info[1].pop("idle"), int)
+        assert isinstance(info[0].pop("inactive"), int)
+        assert isinstance(info[1].pop("inactive"), int)
         assert info == expected
 
     @skip_if_server_version_lt("7.0.0")

From 19b55c62389c890a96dd611e28aaaedba7506720 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Thu, 24 Aug 2023 09:50:20 +0000
Subject: [PATCH 0766/1164] Fix: automatically close connection pool for async
 Sentinel (#2900)

* set the `auto_close_connection_pool` flag on Redis instance with its own pool.

* Add tests for the Sentinel connection pool auto-close

* auto_close_connection_pool is ignored if a pool is provided

* linting
---
 redis/asyncio/sentinel.py           | 24 ++++++++++++++++--------
 tests/test_asyncio/test_sentinel.py | 26 ++++++++++++++++++++++++++
 2 files changed, 42 insertions(+), 8 deletions(-)

diff --git a/redis/asyncio/sentinel.py b/redis/asyncio/sentinel.py
index 501e234c3c..5ed924096c 100644
--- a/redis/asyncio/sentinel.py
+++ b/redis/asyncio/sentinel.py
@@ -335,11 +335,15 @@ def master_for(
         kwargs["is_master"] = True
         connection_kwargs = dict(self.connection_kwargs)
         connection_kwargs.update(kwargs)
-        return redis_class(
-            connection_pool=connection_pool_class(
-                service_name, self, **connection_kwargs
-            )
+
+        connection_pool = connection_pool_class(service_name, self, **connection_kwargs)
+        # The Redis object "owns" the pool
+        auto_close_connection_pool = True
+        client = redis_class(
+            connection_pool=connection_pool,
         )
+        client.auto_close_connection_pool = auto_close_connection_pool
+        return client
 
     def slave_for(
         self,
@@ -368,8 +372,12 @@ def slave_for(
         kwargs["is_master"] = False
         connection_kwargs = dict(self.connection_kwargs)
         connection_kwargs.update(kwargs)
-        return redis_class(
-            connection_pool=connection_pool_class(
-                service_name, self, **connection_kwargs
-            )
+
+        connection_pool = connection_pool_class(service_name, self, **connection_kwargs)
+        # The Redis object "owns" the pool
+        auto_close_connection_pool = True
+        client = redis_class(
+            connection_pool=connection_pool,
         )
+        client.auto_close_connection_pool = auto_close_connection_pool
+        return client
diff --git a/tests/test_asyncio/test_sentinel.py b/tests/test_asyncio/test_sentinel.py
index 2091f2cb87..a2d52f17b7 100644
--- a/tests/test_asyncio/test_sentinel.py
+++ b/tests/test_asyncio/test_sentinel.py
@@ -1,4 +1,5 @@
 import socket
+from unittest import mock
 
 import pytest
 import pytest_asyncio
@@ -239,3 +240,28 @@ async def test_flushconfig(cluster, sentinel):
 async def test_reset(cluster, sentinel):
     cluster.master["is_odown"] = True
     assert await sentinel.sentinel_reset("mymaster")
+
+
+@pytest.mark.onlynoncluster
+@pytest.mark.parametrize("method_name", ["master_for", "slave_for"])
+async def test_auto_close_pool(cluster, sentinel, method_name):
+    """
+    Check that the connection pool created by the sentinel client is
+    automatically closed
+    """
+
+    method = getattr(sentinel, method_name)
+    client = method("mymaster", db=9)
+    pool = client.connection_pool
+    assert client.auto_close_connection_pool is True
+    calls = 0
+
+    async def mock_disconnect():
+        nonlocal calls
+        calls += 1
+
+    with mock.patch.object(pool, "disconnect", mock_disconnect):
+        await client.close()
+
+    assert calls == 1
+    await pool.disconnect()

From 3caee4b33f6ebdd4c1b2247c5a8e39aaaec56a25 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 31 Aug 2023 12:26:29 +0300
Subject: [PATCH 0767/1164] fix sentinel read_response (#2894)

---
 redis/sentinel.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/redis/sentinel.py b/redis/sentinel.py
index 0ba179b9ca..836e781e7f 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -55,12 +55,17 @@ def connect(self):
         return self.retry.call_with_retry(self._connect_retry, lambda error: None)
 
     def read_response(
-        self, disable_decoding=False, *, disconnect_on_error: Optional[bool] = False
+        self,
+        disable_decoding=False,
+        *,
+        disconnect_on_error: Optional[bool] = False,
+        push_request: Optional[bool] = False,
     ):
         try:
             return super().read_response(
                 disable_decoding=disable_decoding,
                 disconnect_on_error=disconnect_on_error,
+                push_request=push_request,
             )
         except ReadOnlyError:
             if self.connection_pool.is_master:

From e3de026a90ef2cc35a5b68934029a0ef2a5b2f53 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 31 Aug 2023 12:26:48 +0300
Subject: [PATCH 0768/1164] Fix test_scorer (search) (#2920)

---
 tests/test_asyncio/test_search.py | 8 ++++----
 tests/test_search.py              | 8 ++++----
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 149b26d958..e46de39c70 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -1045,9 +1045,9 @@ async def test_scorer(decoded_r: redis.Redis):
         res = await (
             decoded_r.ft().search(Query("quick").scorer("TFIDF.DOCNORM").with_scores())
         )
-        assert 0.1111111111111111 == res.docs[0].score
+        assert 0.14285714285714285 == res.docs[0].score
         res = await decoded_r.ft().search(Query("quick").scorer("BM25").with_scores())
-        assert 0.17699114465425977 == res.docs[0].score
+        assert 0.22471909420069797 == res.docs[0].score
         res = await decoded_r.ft().search(Query("quick").scorer("DISMAX").with_scores())
         assert 2.0 == res.docs[0].score
         res = await decoded_r.ft().search(
@@ -1066,9 +1066,9 @@ async def test_scorer(decoded_r: redis.Redis):
         res = await decoded_r.ft().search(
             Query("quick").scorer("TFIDF.DOCNORM").with_scores()
         )
-        assert 0.1111111111111111 == res["results"][0]["score"]
+        assert 0.14285714285714285 == res["results"][0]["score"]
         res = await decoded_r.ft().search(Query("quick").scorer("BM25").with_scores())
-        assert 0.17699114465425977 == res["results"][0]["score"]
+        assert 0.22471909420069797 == res["results"][0]["score"]
         res = await decoded_r.ft().search(Query("quick").scorer("DISMAX").with_scores())
         assert 2.0 == res["results"][0]["score"]
         res = await decoded_r.ft().search(
diff --git a/tests/test_search.py b/tests/test_search.py
index 2e42aaba57..f3f9619d92 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -952,9 +952,9 @@ def test_scorer(client):
         res = client.ft().search(Query("quick").scorer("TFIDF").with_scores())
         assert 1.0 == res.docs[0].score
         res = client.ft().search(Query("quick").scorer("TFIDF.DOCNORM").with_scores())
-        assert 0.1111111111111111 == res.docs[0].score
+        assert 0.14285714285714285 == res.docs[0].score
         res = client.ft().search(Query("quick").scorer("BM25").with_scores())
-        assert 0.17699114465425977 == res.docs[0].score
+        assert 0.22471909420069797 == res.docs[0].score
         res = client.ft().search(Query("quick").scorer("DISMAX").with_scores())
         assert 2.0 == res.docs[0].score
         res = client.ft().search(Query("quick").scorer("DOCSCORE").with_scores())
@@ -967,9 +967,9 @@ def test_scorer(client):
         res = client.ft().search(Query("quick").scorer("TFIDF").with_scores())
         assert 1.0 == res["results"][0]["score"]
         res = client.ft().search(Query("quick").scorer("TFIDF.DOCNORM").with_scores())
-        assert 0.1111111111111111 == res["results"][0]["score"]
+        assert 0.14285714285714285 == res["results"][0]["score"]
         res = client.ft().search(Query("quick").scorer("BM25").with_scores())
-        assert 0.17699114465425977 == res["results"][0]["score"]
+        assert 0.22471909420069797 == res["results"][0]["score"]
         res = client.ft().search(Query("quick").scorer("DISMAX").with_scores())
         assert 2.0 == res["results"][0]["score"]
         res = client.ft().search(Query("quick").scorer("DOCSCORE").with_scores())

From 7c4f1671270850187e986367302dd039daa9a997 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 11 Sep 2023 09:32:56 +0300
Subject: [PATCH 0769/1164] Deprecate RedisGraph (#2927)

---
 redis/commands/graph/__init__.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/redis/commands/graph/__init__.py b/redis/commands/graph/__init__.py
index a882dd514d..ffaf1fb4ff 100644
--- a/redis/commands/graph/__init__.py
+++ b/redis/commands/graph/__init__.py
@@ -1,3 +1,5 @@
+import warnings
+
 from ..helpers import quote_string, random_string, stringify_param_value
 from .commands import AsyncGraphCommands, GraphCommands
 from .edge import Edge  # noqa
@@ -18,6 +20,12 @@ def __init__(self, client, name=random_string()):
         """
         Create a new graph.
         """
+        warnings.warn(
+            DeprecationWarning(
+                "RedisGraph support is deprecated as of Redis Stack 7.2 \
+                (https://redis.com/blog/redisgraph-eol/)"
+            )
+        )
         self.NAME = name  # Graph key
         self.client = client
         self.execute_command = client.execute_command

From 317ea3a2b1d2ee6b695862a061f35afed62e3248 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 11 Sep 2023 09:33:15 +0300
Subject: [PATCH 0770/1164] Fix protocol checking for search commands (#2923)

---
 redis/commands/search/commands.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 87b572195c..83dea106d2 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -5,7 +5,7 @@
 from redis.client import Pipeline
 from redis.utils import deprecated_function
 
-from ..helpers import parse_to_dict
+from ..helpers import get_protocol_version, parse_to_dict
 from ._util import to_string
 from .aggregation import AggregateRequest, AggregateResult, Cursor
 from .document import Document
@@ -64,7 +64,7 @@ class SearchCommands:
     """Search commands."""
 
     def _parse_results(self, cmd, res, **kwargs):
-        if self.client.connection_pool.connection_kwargs.get("protocol") in ["3", 3]:
+        if get_protocol_version(self.client) in ["3", 3]:
             return res
         else:
             return self._RESP2_MODULE_CALLBACKS[cmd](res, **kwargs)

From c7dc1751b90a3944907dfc4fdb25e7774a5d1c1e Mon Sep 17 00:00:00 2001
From: Aman <AOrazaev@gmail.com>
Date: Sun, 10 Sep 2023 23:33:42 -0700
Subject: [PATCH 0771/1164] Fix typo in redis-stream-example.ipynb (#2918)

remote -> remove
---
 docs/examples/redis-stream-example.ipynb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/examples/redis-stream-example.ipynb b/docs/examples/redis-stream-example.ipynb
index a84bf19cb6..eb1f2e9a20 100644
--- a/docs/examples/redis-stream-example.ipynb
+++ b/docs/examples/redis-stream-example.ipynb
@@ -652,7 +652,7 @@
    "metadata": {},
    "source": [
     "## delete all\n",
-    "To remove the messages with need to remote them explicitly with `xdel`."
+    "To remove the messages with need to remove them explicitly with `xdel`."
    ]
   },
   {

From 09dcef1034a27ad07f8dd502caa4d062efc2ab5b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Mon, 11 Sep 2023 06:34:24 +0000
Subject: [PATCH 0772/1164] Fix resource warnings in unit tests (#2899)

* Properly close sockets for the cwe_404 proxy

* release connections in tests

fix

* Fix mock signature to prevent resource warning for async method
---
 tests/test_asyncio/test_connect.py    |  1 +
 tests/test_asyncio/test_connection.py |  5 ++-
 tests/test_asyncio/test_cwe_404.py    | 47 ++++++++++++++++-----------
 3 files changed, 31 insertions(+), 22 deletions(-)

diff --git a/tests/test_asyncio/test_connect.py b/tests/test_asyncio/test_connect.py
index bead7208f5..0b2d7c2afa 100644
--- a/tests/test_asyncio/test_connect.py
+++ b/tests/test_asyncio/test_connect.py
@@ -62,6 +62,7 @@ async def test_tcp_ssl_connect(tcp_address):
         socket_timeout=10,
     )
     await _assert_connect(conn, tcp_address, certfile=certfile, keyfile=keyfile)
+    await conn.disconnect()
 
 
 async def _assert_connect(conn, server_address, certfile=None, keyfile=None):
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index d1aad796e7..9ee6db1566 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -254,9 +254,8 @@ async def do_close():
     async def do_read():
         return await conn.read_response()
 
-    reader = mock.AsyncMock()
-    writer = mock.AsyncMock()
-    writer.transport = mock.Mock()
+    reader = mock.Mock(spec=asyncio.StreamReader)
+    writer = mock.Mock(spec=asyncio.StreamWriter)
     writer.transport.get_extra_info.side_effect = None
 
     # for HiredisParser
diff --git a/tests/test_asyncio/test_cwe_404.py b/tests/test_asyncio/test_cwe_404.py
index ff588861e4..35707553f8 100644
--- a/tests/test_asyncio/test_cwe_404.py
+++ b/tests/test_asyncio/test_cwe_404.py
@@ -49,22 +49,22 @@ def set_delay(self, delay: float = 0.0):
     async def handle(self, reader, writer):
         # establish connection to redis
         redis_reader, redis_writer = await asyncio.open_connection(*self.redis_addr)
-        try:
-            pipe1 = asyncio.create_task(
-                self.pipe(reader, redis_writer, "to redis:", self.send_event)
-            )
-            pipe2 = asyncio.create_task(self.pipe(redis_reader, writer, "from redis:"))
-            await asyncio.gather(pipe1, pipe2)
-        finally:
-            redis_writer.close()
+        pipe1 = asyncio.create_task(
+            self.pipe(reader, redis_writer, "to redis:", self.send_event)
+        )
+        pipe2 = asyncio.create_task(self.pipe(redis_reader, writer, "from redis:"))
+        await asyncio.gather(pipe1, pipe2)
 
     async def stop(self):
-        # clean up enough so that we can reuse the looper
+        # shutdown the server
         self.task.cancel()
         try:
             await self.task
         except asyncio.CancelledError:
             pass
+        await self.server.wait_closed()
+        # do we need to close individual connections too?
+        # prudently close all async generators
         loop = self.server.get_loop()
         await loop.shutdown_asyncgens()
 
@@ -75,16 +75,25 @@ async def pipe(
         name="",
         event: asyncio.Event = None,
     ):
-        while True:
-            data = await reader.read(1000)
-            if not data:
-                break
-            # print(f"{name} read {len(data)} delay {self.delay}")
-            if event:
-                event.set()
-            await asyncio.sleep(self.delay)
-            writer.write(data)
-            await writer.drain()
+        try:
+            while True:
+                data = await reader.read(1000)
+                if not data:
+                    break
+                # print(f"{name} read {len(data)} delay {self.delay}")
+                if event:
+                    event.set()
+                await asyncio.sleep(self.delay)
+                writer.write(data)
+                await writer.drain()
+        finally:
+            try:
+                writer.close()
+                await writer.wait_closed()
+            except RuntimeError:
+                # ignore errors on close pertaining to no event loop. Don't want
+                # to clutter the test output with errors if being garbage collected
+                pass
 
 
 @pytest.mark.onlynoncluster

From 53be0b6a9ef2ecf2cbcd31e0f4a88e5038f7705c Mon Sep 17 00:00:00 2001
From: Igor Malinovskiy <u.glide@gmail.com>
Date: Mon, 11 Sep 2023 08:34:42 +0200
Subject: [PATCH 0773/1164] Add 7.2 to supported Redis versions (#2896)

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index f8c3a78ae7..4bd71b4060 100644
--- a/README.md
+++ b/README.md
@@ -42,7 +42,7 @@ Looking for a high-level library to handle object mapping? See [redis-om-python]
 
 ## Supported Redis Versions
 
-The most recent version of this library supports redis version [5.0](https://github.com/redis/redis/blob/5.0/00-RELEASENOTES), [6.0](https://github.com/redis/redis/blob/6.0/00-RELEASENOTES), [6.2](https://github.com/redis/redis/blob/6.2/00-RELEASENOTES), and [7.0](https://github.com/redis/redis/blob/7.0/00-RELEASENOTES).
+The most recent version of this library supports redis version [5.0](https://github.com/redis/redis/blob/5.0/00-RELEASENOTES), [6.0](https://github.com/redis/redis/blob/6.0/00-RELEASENOTES), [6.2](https://github.com/redis/redis/blob/6.2/00-RELEASENOTES), [7.0](https://github.com/redis/redis/blob/7.0/00-RELEASENOTES) and [7.2](https://github.com/redis/redis/blob/7.2/00-RELEASENOTES).
 
 The table below highlights version compatibility of the most-recent library versions and redis versions.
 

From 8c8a529a5f552db62d94f54a0c0e305c82e8514c Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 11 Sep 2023 14:18:39 +0300
Subject: [PATCH 0774/1164] Fix async sentinel (#2922)

---
 redis/asyncio/sentinel.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/redis/asyncio/sentinel.py b/redis/asyncio/sentinel.py
index 5ed924096c..20c0a1fdd5 100644
--- a/redis/asyncio/sentinel.py
+++ b/redis/asyncio/sentinel.py
@@ -69,12 +69,14 @@ async def read_response(
         timeout: Optional[float] = None,
         *,
         disconnect_on_error: Optional[float] = True,
+        push_request: Optional[bool] = False,
     ):
         try:
             return await super().read_response(
                 disable_decoding=disable_decoding,
                 timeout=timeout,
                 disconnect_on_error=disconnect_on_error,
+                push_request=push_request,
             )
         except ReadOnlyError:
             if self.connection_pool.is_master:

From 1596ac6a0bbc1e00e57c6a48e255a8f917498e39 Mon Sep 17 00:00:00 2001
From: Aarni Koskela <akx@iki.fi>
Date: Mon, 11 Sep 2023 14:47:53 +0300
Subject: [PATCH 0775/1164] Remove mentions of Tox (#2929)

It was removed in #2849.

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 .dockerignore                    |  1 -
 .flake8                          |  1 -
 .github/PULL_REQUEST_TEMPLATE.md |  2 +-
 .github/wordlist.txt             |  1 -
 .gitignore                       |  1 -
 CONTRIBUTING.md                  | 30 +-----------------------------
 dev_requirements.txt             |  1 -
 7 files changed, 2 insertions(+), 35 deletions(-)

diff --git a/.dockerignore b/.dockerignore
index 7b9bc9b2df..4dc633c1a6 100644
--- a/.dockerignore
+++ b/.dockerignore
@@ -1,5 +1,4 @@
 **/__pycache__
 **/*.pyc
-.tox
 .coverage
 .coverage.*
diff --git a/.flake8 b/.flake8
index 6c663473e4..73b4a96bb6 100644
--- a/.flake8
+++ b/.flake8
@@ -4,7 +4,6 @@ exclude =
     *.egg-info,
     *.pyc,
     .git,
-    .tox,
     .venv*,
     build,
     docs/*,
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index a3b0b0e4e7..722906b048 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -2,7 +2,7 @@
 
 _Please make sure to review and check all of these items:_
 
-- [ ] Does `$ tox` pass with this change (including linting)?
+- [ ] Do tests and lints pass with this change?
 - [ ] Do the CI tests pass with this change (enable it first in your forked repo and wait for the github action build to finish)?
 - [ ] Is the new or changed code fully tested?
 - [ ] Is a documentation update included (if this change modifies existing APIs, or introduces new ones)?
diff --git a/.github/wordlist.txt b/.github/wordlist.txt
index be16c437ff..22ae767e46 100644
--- a/.github/wordlist.txt
+++ b/.github/wordlist.txt
@@ -132,7 +132,6 @@ thevalueofmykey
 timeseries
 toctree
 topk
-tox
 triaging
 txt
 un
diff --git a/.gitignore b/.gitignore
index b392a2d748..3baa34034f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -3,7 +3,6 @@ redis.egg-info
 build/
 dist/
 dump.rdb
-/.tox
 _build
 vagrant/.vagrant
 .python-version
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 1081f4cb46..4da55c737c 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -78,16 +78,9 @@ It is possible to run only Redis client tests (with cluster mode disabled) by
 using `invoke standalone-tests`; similarly, RedisCluster tests can be run by using
 `invoke cluster-tests`.
 
-Each run of tox starts and stops the various dockers required. Sometimes
+Each run of tests starts and stops the various dockers required. Sometimes
 things get stuck, an `invoke clean` can help.
 
-Continuous Integration uses these same wrappers to run all of these
-tests against multiple versions of python. Feel free to test your
-changes against all the python versions supported, as declared by the
-tox.ini file (eg: tox -e py39). If you have the various python versions
-on your desktop, you can run *tox* by itself, to test all supported
-versions.
-
 ### Docker Tips
 
 Following are a few tips that can help you work with the Docker-based
@@ -97,10 +90,6 @@ To get a bash shell inside of a container:
 
 `$ docker run -it <service> /bin/bash`
 
-**Note**: The term \"service\" refers to the \"services\" defined in the
-`tox.ini` file at the top of the repo: \"master\", \"replicaof\",
-\"sentinel_1\", \"sentinel_2\", \"sentinel_3\".
-
 Containers run a minimal Debian image that probably lacks tools you want
 to use. To install packages, first get a bash session (see previous tip)
 and then run:
@@ -111,23 +100,6 @@ You can see the logging output of a containers like this:
 
 `$ docker logs -f <service>`
 
-The command make test runs all tests in all tested Python
-environments. To run the tests in a single environment, like Python 3.9,
-use a command like this:
-
-`$ docker-compose run test tox -e py39 -- --redis-url=redis://master:6379/9`
-
-Here, the flag `-e py39` runs tests against the Python 3.9 tox
-environment. And note from the example that whenever you run tests like
-this, instead of using make test, you need to pass
-`-- --redis-url=redis://master:6379/9`. This points the tests at the
-\"master\" container.
-
-Our test suite uses `pytest`. You can run a specific test suite against
-a specific Python version like this:
-
-`$ docker-compose run test tox -e py37 -- --redis-url=redis://master:6379/9 tests/test_commands.py`
-
 ### Troubleshooting
 
 If you get any errors when running `make dev` or `make test`, make sure
diff --git a/dev_requirements.txt b/dev_requirements.txt
index cdb3774ab6..3715599af0 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -8,7 +8,6 @@ packaging>=20.4
 pytest==7.2.0
 pytest-timeout==2.1.0
 pytest-asyncio>=0.20.2
-tox==3.27.1
 invoke==1.7.3
 pytest-cov>=4.0.0
 vulture>=2.3.0

From 46b736ef7cb0ad54089d0bd6385472df0ce6f00c Mon Sep 17 00:00:00 2001
From: meiravgri <109056284+meiravgri@users.noreply.github.com>
Date: Thu, 14 Sep 2023 14:34:20 +0300
Subject: [PATCH 0776/1164] Support timeout = 0 in search query (#2934)

* Support query timeout = 0

In RediSearch query timeout = 0 means unlimited timeout.
In the current implementation, the query timeout is only updated `if timeout` which in case of 0, translates to false.
Since the default timeout of the `query` class is None, replacing the condition with `if self._timeout is not None` will also work for 0.
If the parameter is not a positive integer, redis server will raise an exception.

related issue: #2928 https://github.com/redis/redis-py/issues/2839

* added a test to quety.timeout(0)

* raise an exception if query TIMEOUT is a non negative integer

* fixed the query test to catach AttributeError

* Moved validating timeout to timeout()

Raise the exception when the timeout is set instead of when the query is performed

* updates test to catch the exception when query.timeout() is called

* Update redis/commands/search/query.py

Co-authored-by: GuyAv46 <47632673+GuyAv46@users.noreply.github.com>

* Revert "Update redis/commands/search/query.py"

This reverts commit fb2b710ce9d579309bffac75c84041833c70055f.

* Revert "updates test to catch the exception when query.timeout() is called"

This reverts commit 65901308369342d781a42a287734c6d8b02bc062.

* Revert "Moved validating timeout to timeout()"

This reverts commit 7a020bd836f8cd3c5906e129a71584a2959ec70a.

* Revert "fixed the query test to catach AttributeError"

This reverts commit 25d4ddf580f58788f7ff2cff9f4931cb483ae01b.

* Revert "raise an exception if query TIMEOUT is a non negative integer"

This reverts commit 3fb2c683ee0d481d72dc1ffcbb6ab2a5233b5a9d.

---------

Co-authored-by: GuyAv46 <47632673+GuyAv46@users.noreply.github.com>
---
 redis/commands/search/query.py | 2 +-
 tests/test_search.py           | 2 ++
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/redis/commands/search/query.py b/redis/commands/search/query.py
index 5071cfabf2..362dd6c72a 100644
--- a/redis/commands/search/query.py
+++ b/redis/commands/search/query.py
@@ -194,7 +194,7 @@ def _get_args_tags(self):
             args += self._ids
         if self._slop >= 0:
             args += ["SLOP", self._slop]
-        if self._timeout:
+        if self._timeout is not None:
             args += ["TIMEOUT", self._timeout]
         if self._in_order:
             args.append("INORDER")
diff --git a/tests/test_search.py b/tests/test_search.py
index f3f9619d92..7612332470 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -2264,6 +2264,8 @@ def test_withsuffixtrie(client: redis.Redis):
 def test_query_timeout(r: redis.Redis):
     q1 = Query("foo").timeout(5000)
     assert q1.get_args() == ["foo", "TIMEOUT", 5000, "LIMIT", 0, 10]
+    q1 = Query("foo").timeout(0)
+    assert q1.get_args() == ["foo", "TIMEOUT", 0, "LIMIT", 0, 10]
     q2 = Query("foo").timeout("not_a_number")
     with pytest.raises(redis.ResponseError):
         r.ft().search(q2)

From 94ae3e0ac423aa613b198cd2a1006f4504bcadd0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Thu, 14 Sep 2023 11:38:59 +0000
Subject: [PATCH 0777/1164] Fix resource usage and cleanup Mocks in the unit
 tests (#2936)

* Fix resource missing awaits in test_cwe_404

* Unpatch mocked client after use

* Fix sync unix connect test
---
 tests/conftest.py                  | 21 ++++++++++-----------
 tests/test_asyncio/conftest.py     | 23 ++++++++++++++---------
 tests/test_asyncio/test_cluster.py |  4 ++--
 tests/test_asyncio/test_cwe_404.py | 16 +++++++++-------
 tests/test_connect.py              |  2 +-
 5 files changed, 36 insertions(+), 30 deletions(-)

diff --git a/tests/conftest.py b/tests/conftest.py
index 16f3fbb9db..bad9f43e42 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -2,6 +2,7 @@
 import random
 import time
 from typing import Callable, TypeVar
+from unittest import mock
 from unittest.mock import Mock
 from urllib.parse import urlparse
 
@@ -9,7 +10,7 @@
 import redis
 from packaging.version import Version
 from redis.backoff import NoBackoff
-from redis.connection import parse_url
+from redis.connection import Connection, parse_url
 from redis.exceptions import RedisClusterException
 from redis.retry import Retry
 
@@ -39,7 +40,6 @@ def __init__(
         help=None,
         metavar=None,
     ):
-
         _option_strings = []
         for option_string in option_strings:
             _option_strings.append(option_string)
@@ -72,7 +72,6 @@ def format_usage(self):
 
 
 def pytest_addoption(parser):
-
     parser.addoption(
         "--redis-url",
         default=default_redis_url,
@@ -354,23 +353,23 @@ def sslclient(request):
 
 
 def _gen_cluster_mock_resp(r, response):
-    connection = Mock()
+    connection = Mock(spec=Connection)
     connection.retry = Retry(NoBackoff(), 0)
     connection.read_response.return_value = response
-    r.connection = connection
-    return r
+    with mock.patch.object(r, "connection", connection):
+        yield r
 
 
 @pytest.fixture()
 def mock_cluster_resp_ok(request, **kwargs):
     r = _get_client(redis.Redis, request, **kwargs)
-    return _gen_cluster_mock_resp(r, "OK")
+    yield from _gen_cluster_mock_resp(r, "OK")
 
 
 @pytest.fixture()
 def mock_cluster_resp_int(request, **kwargs):
     r = _get_client(redis.Redis, request, **kwargs)
-    return _gen_cluster_mock_resp(r, 2)
+    yield from _gen_cluster_mock_resp(r, 2)
 
 
 @pytest.fixture()
@@ -384,7 +383,7 @@ def mock_cluster_resp_info(request, **kwargs):
         "cluster_my_epoch:2\r\ncluster_stats_messages_sent:170262\r\n"
         "cluster_stats_messages_received:105653\r\n"
     )
-    return _gen_cluster_mock_resp(r, response)
+    yield from _gen_cluster_mock_resp(r, response)
 
 
 @pytest.fixture()
@@ -408,7 +407,7 @@ def mock_cluster_resp_nodes(request, **kwargs):
         "fbb23ed8cfa23f17eaf27ff7d0c410492a1093d6 172.17.0.7:7002 "
         "master,fail - 1447829446956 1447829444948 1 disconnected\n"
     )
-    return _gen_cluster_mock_resp(r, response)
+    yield from _gen_cluster_mock_resp(r, response)
 
 
 @pytest.fixture()
@@ -419,7 +418,7 @@ def mock_cluster_resp_slaves(request, **kwargs):
         "slave 19efe5a631f3296fdf21a5441680f893e8cc96ec 0 "
         "1447836789290 3 connected']"
     )
-    return _gen_cluster_mock_resp(r, response)
+    yield from _gen_cluster_mock_resp(r, response)
 
 
 @pytest.fixture(scope="session")
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index c837f284f7..10ab4732c2 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -8,7 +8,7 @@
 from packaging.version import Version
 from redis._parsers import _AsyncHiredisParser, _AsyncRESP2Parser
 from redis.asyncio.client import Monitor
-from redis.asyncio.connection import parse_url
+from redis.asyncio.connection import Connection, parse_url
 from redis.asyncio.retry import Retry
 from redis.backoff import NoBackoff
 from redis.utils import HIREDIS_AVAILABLE
@@ -138,23 +138,25 @@ async def decoded_r(create_redis):
 
 
 def _gen_cluster_mock_resp(r, response):
-    connection = mock.AsyncMock()
+    connection = mock.AsyncMock(spec=Connection)
     connection.retry = Retry(NoBackoff(), 0)
     connection.read_response.return_value = response
-    r.connection = connection
-    return r
+    with mock.patch.object(r, "connection", connection):
+        yield r
 
 
 @pytest_asyncio.fixture()
 async def mock_cluster_resp_ok(create_redis, **kwargs):
     r = await create_redis(**kwargs)
-    return _gen_cluster_mock_resp(r, "OK")
+    for mocked in _gen_cluster_mock_resp(r, "OK"):
+        yield mocked
 
 
 @pytest_asyncio.fixture()
 async def mock_cluster_resp_int(create_redis, **kwargs):
     r = await create_redis(**kwargs)
-    return _gen_cluster_mock_resp(r, 2)
+    for mocked in _gen_cluster_mock_resp(r, 2):
+        yield mocked
 
 
 @pytest_asyncio.fixture()
@@ -168,7 +170,8 @@ async def mock_cluster_resp_info(create_redis, **kwargs):
         "cluster_my_epoch:2\r\ncluster_stats_messages_sent:170262\r\n"
         "cluster_stats_messages_received:105653\r\n"
     )
-    return _gen_cluster_mock_resp(r, response)
+    for mocked in _gen_cluster_mock_resp(r, response):
+        yield mocked
 
 
 @pytest_asyncio.fixture()
@@ -192,7 +195,8 @@ async def mock_cluster_resp_nodes(create_redis, **kwargs):
         "fbb23ed8cfa23f17eaf27ff7d0c410492a1093d6 172.17.0.7:7002 "
         "master,fail - 1447829446956 1447829444948 1 disconnected\n"
     )
-    return _gen_cluster_mock_resp(r, response)
+    for mocked in _gen_cluster_mock_resp(r, response):
+        yield mocked
 
 
 @pytest_asyncio.fixture()
@@ -203,7 +207,8 @@ async def mock_cluster_resp_slaves(create_redis, **kwargs):
         "slave 19efe5a631f3296fdf21a5441680f893e8cc96ec 0 "
         "1447836789290 3 connected']"
     )
-    return _gen_cluster_mock_resp(r, response)
+    for mocked in _gen_cluster_mock_resp(r, response):
+        yield mocked
 
 
 async def wait_for_command(
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 1cb1fa5195..332101edd5 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -175,7 +175,7 @@ def cmd_init_mock(self, r: ClusterNode) -> None:
 
 
 def mock_node_resp(node: ClusterNode, response: Any) -> ClusterNode:
-    connection = mock.AsyncMock()
+    connection = mock.AsyncMock(spec=Connection)
     connection.is_connected = True
     connection.read_response.return_value = response
     while node._free:
@@ -185,7 +185,7 @@ def mock_node_resp(node: ClusterNode, response: Any) -> ClusterNode:
 
 
 def mock_node_resp_exc(node: ClusterNode, exc: Exception) -> ClusterNode:
-    connection = mock.AsyncMock()
+    connection = mock.AsyncMock(spec=Connection)
     connection.is_connected = True
     connection.read_response.side_effect = exc
     while node._free:
diff --git a/tests/test_asyncio/test_cwe_404.py b/tests/test_asyncio/test_cwe_404.py
index 35707553f8..76ec2bbd26 100644
--- a/tests/test_asyncio/test_cwe_404.py
+++ b/tests/test_asyncio/test_cwe_404.py
@@ -213,8 +213,9 @@ def all_clear():
             p.send_event.clear()
 
     async def wait_for_send():
-        asyncio.wait(
-            [p.send_event.wait() for p in proxies], return_when=asyncio.FIRST_COMPLETED
+        await asyncio.wait(
+            [asyncio.Task(p.send_event.wait()) for p in proxies],
+            return_when=asyncio.FIRST_COMPLETED,
         )
 
     @contextlib.contextmanager
@@ -228,11 +229,10 @@ def set_delay(delay: float):
         for p in proxies:
             await stack.enter_async_context(p)
 
-        with contextlib.closing(
-            RedisCluster.from_url(
-                f"redis://127.0.0.1:{remap_base}", address_remap=remap
-            )
-        ) as r:
+        r = RedisCluster.from_url(
+            f"redis://127.0.0.1:{remap_base}", address_remap=remap
+        )
+        try:
             await r.initialize()
             await r.set("foo", "foo")
             await r.set("bar", "bar")
@@ -257,3 +257,5 @@ async def doit():
                 assert await r.get("foo") == b"foo"
 
             await asyncio.gather(*[doit() for _ in range(10)])
+        finally:
+            await r.close()
diff --git a/tests/test_connect.py b/tests/test_connect.py
index f07750dc80..696e69ceea 100644
--- a/tests/test_connect.py
+++ b/tests/test_connect.py
@@ -115,7 +115,7 @@ def get_request(self):
         return connstream, fromaddr
 
 
-if hasattr(socket, "UnixStreamServer"):
+if hasattr(socketserver, "UnixStreamServer"):
 
     class _RedisUDSServer(socketserver.UnixStreamServer):
         def __init__(self, *args, **kw) -> None:

From ba186d210f4f1e5d16fb27a1ee0afcb930f16a8d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Thu, 14 Sep 2023 11:39:59 +0000
Subject: [PATCH 0778/1164] Remove process-id checks from asyncio.  Asyncio and
 fork() does not mix. (#2911)

* Remove process-id checks from asyncio.  Asyncio and fork() does not mix.

* Remove mention of threads from the async connection code

* Require connections to land in the correct pool

* Remove redundant async locking from the ConnectionPool class

* Simplify `BlockingConnectionPool`

* Ensure connection creation can be subclassed via `make_connection()`

* Fix resource missing awaits in test_cwe_404

* Unpatch mocked client after use
---
 redis/asyncio/connection.py                | 337 +++++----------------
 tests/test_asyncio/test_connection_pool.py |   5 +-
 2 files changed, 75 insertions(+), 267 deletions(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index c1cc1d310c..00865515ab 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -2,11 +2,9 @@
 import copy
 import enum
 import inspect
-import os
 import socket
 import ssl
 import sys
-import threading
 import weakref
 from abc import abstractmethod
 from itertools import chain
@@ -41,7 +39,6 @@
 from redis.exceptions import (
     AuthenticationError,
     AuthenticationWrongNumberOfArgsError,
-    ChildDeadlockedError,
     ConnectionError,
     DataError,
     RedisError,
@@ -97,7 +94,6 @@ class AbstractConnection:
     """Manages communication to and from a Redis server"""
 
     __slots__ = (
-        "pid",
         "db",
         "username",
         "client_name",
@@ -158,7 +154,6 @@ def __init__(
                 "1. 'password' and (optional) 'username'\n"
                 "2. 'credential_provider'"
             )
-        self.pid = os.getpid()
         self.db = db
         self.client_name = client_name
         self.lib_name = lib_name
@@ -381,12 +376,11 @@ async def disconnect(self, nowait: bool = False) -> None:
                 if not self.is_connected:
                     return
                 try:
-                    if os.getpid() == self.pid:
-                        self._writer.close()  # type: ignore[union-attr]
-                        # wait for close to finish, except when handling errors and
-                        # forcefully disconnecting.
-                        if not nowait:
-                            await self._writer.wait_closed()  # type: ignore[union-attr]
+                    self._writer.close()  # type: ignore[union-attr]
+                    # wait for close to finish, except when handling errors and
+                    # forcefully disconnecting.
+                    if not nowait:
+                        await self._writer.wait_closed()  # type: ignore[union-attr]
                 except OSError:
                     pass
                 finally:
@@ -1004,20 +998,8 @@ def __init__(
         self.connection_kwargs = connection_kwargs
         self.max_connections = max_connections
 
-        # a lock to protect the critical section in _checkpid().
-        # this lock is acquired when the process id changes, such as
-        # after a fork. during this time, multiple threads in the child
-        # process could attempt to acquire this lock. the first thread
-        # to acquire the lock will reset the data structures and lock
-        # object of this pool. subsequent threads acquiring this lock
-        # will notice the first thread already did the work and simply
-        # release the lock.
-        self._fork_lock = threading.Lock()
-        self._lock = asyncio.Lock()
-        self._created_connections: int
-        self._available_connections: List[AbstractConnection]
-        self._in_use_connections: Set[AbstractConnection]
-        self.reset()  # lgtm [py/init-calls-subclass]
+        self._available_connections: List[AbstractConnection] = []
+        self._in_use_connections: Set[AbstractConnection] = set()
         self.encoder_class = self.connection_kwargs.get("encoder_class", Encoder)
 
     def __repr__(self):
@@ -1027,97 +1009,29 @@ def __repr__(self):
         )
 
     def reset(self):
-        self._lock = asyncio.Lock()
-        self._created_connections = 0
         self._available_connections = []
         self._in_use_connections = set()
 
-        # this must be the last operation in this method. while reset() is
-        # called when holding _fork_lock, other threads in this process
-        # can call _checkpid() which compares self.pid and os.getpid() without
-        # holding any lock (for performance reasons). keeping this assignment
-        # as the last operation ensures that those other threads will also
-        # notice a pid difference and block waiting for the first thread to
-        # release _fork_lock. when each of these threads eventually acquire
-        # _fork_lock, they will notice that another thread already called
-        # reset() and they will immediately release _fork_lock and continue on.
-        self.pid = os.getpid()
-
-    def _checkpid(self):
-        # _checkpid() attempts to keep ConnectionPool fork-safe on modern
-        # systems. this is called by all ConnectionPool methods that
-        # manipulate the pool's state such as get_connection() and release().
-        #
-        # _checkpid() determines whether the process has forked by comparing
-        # the current process id to the process id saved on the ConnectionPool
-        # instance. if these values are the same, _checkpid() simply returns.
-        #
-        # when the process ids differ, _checkpid() assumes that the process
-        # has forked and that we're now running in the child process. the child
-        # process cannot use the parent's file descriptors (e.g., sockets).
-        # therefore, when _checkpid() sees the process id change, it calls
-        # reset() in order to reinitialize the child's ConnectionPool. this
-        # will cause the child to make all new connection objects.
-        #
-        # _checkpid() is protected by self._fork_lock to ensure that multiple
-        # threads in the child process do not call reset() multiple times.
-        #
-        # there is an extremely small chance this could fail in the following
-        # scenario:
-        #   1. process A calls _checkpid() for the first time and acquires
-        #      self._fork_lock.
-        #   2. while holding self._fork_lock, process A forks (the fork()
-        #      could happen in a different thread owned by process A)
-        #   3. process B (the forked child process) inherits the
-        #      ConnectionPool's state from the parent. that state includes
-        #      a locked _fork_lock. process B will not be notified when
-        #      process A releases the _fork_lock and will thus never be
-        #      able to acquire the _fork_lock.
-        #
-        # to mitigate this possible deadlock, _checkpid() will only wait 5
-        # seconds to acquire _fork_lock. if _fork_lock cannot be acquired in
-        # that time it is assumed that the child is deadlocked and a
-        # redis.ChildDeadlockedError error is raised.
-        if self.pid != os.getpid():
-            acquired = self._fork_lock.acquire(timeout=5)
-            if not acquired:
-                raise ChildDeadlockedError
-            # reset() the instance for the new process if another thread
-            # hasn't already done so
-            try:
-                if self.pid != os.getpid():
-                    self.reset()
-            finally:
-                self._fork_lock.release()
+    def can_get_connection(self) -> bool:
+        """Return True if a connection can be retrieved from the pool."""
+        return (
+            self._available_connections
+            or len(self._in_use_connections) < self.max_connections
+        )
 
     async def get_connection(self, command_name, *keys, **options):
         """Get a connection from the pool"""
-        self._checkpid()
-        async with self._lock:
-            try:
-                connection = self._available_connections.pop()
-            except IndexError:
-                connection = self.make_connection()
-            self._in_use_connections.add(connection)
+        try:
+            connection = self._available_connections.pop()
+        except IndexError:
+            if len(self._in_use_connections) >= self.max_connections:
+                raise ConnectionError("Too many connections") from None
+            connection = self.make_connection()
+        self._in_use_connections.add(connection)
 
         try:
-            # ensure this connection is connected to Redis
-            await connection.connect()
-            # connections that the pool provides should be ready to send
-            # a command. if not, the connection was either returned to the
-            # pool before all data has been read or the socket has been
-            # closed. either way, reconnect and verify everything is good.
-            try:
-                if await connection.can_read_destructive():
-                    raise ConnectionError("Connection has data") from None
-            except (ConnectionError, OSError):
-                await connection.disconnect()
-                await connection.connect()
-                if await connection.can_read_destructive():
-                    raise ConnectionError("Connection not ready") from None
+            await self.ensure_connection(connection)
         except BaseException:
-            # release the connection back to the pool so that we don't
-            # leak it
             await self.release(connection)
             raise
 
@@ -1133,35 +1047,31 @@ def get_encoder(self):
         )
 
     def make_connection(self):
-        """Create a new connection"""
-        if self._created_connections >= self.max_connections:
-            raise ConnectionError("Too many connections")
-        self._created_connections += 1
+        """Create a new connection.  Can be overridden by child classes."""
         return self.connection_class(**self.connection_kwargs)
 
+    async def ensure_connection(self, connection: AbstractConnection):
+        """Ensure that the connection object is connected and valid"""
+        await connection.connect()
+        # connections that the pool provides should be ready to send
+        # a command. if not, the connection was either returned to the
+        # pool before all data has been read or the socket has been
+        # closed. either way, reconnect and verify everything is good.
+        try:
+            if await connection.can_read_destructive():
+                raise ConnectionError("Connection has data") from None
+        except (ConnectionError, OSError):
+            await connection.disconnect()
+            await connection.connect()
+            if await connection.can_read_destructive():
+                raise ConnectionError("Connection not ready") from None
+
     async def release(self, connection: AbstractConnection):
         """Releases the connection back to the pool"""
-        self._checkpid()
-        async with self._lock:
-            try:
-                self._in_use_connections.remove(connection)
-            except KeyError:
-                # Gracefully fail when a connection is returned to this pool
-                # that the pool doesn't actually own
-                pass
-
-            if self.owns_connection(connection):
-                self._available_connections.append(connection)
-            else:
-                # pool doesn't own this connection. do not add it back
-                # to the pool and decrement the count so that another
-                # connection can take its place if needed
-                self._created_connections -= 1
-                await connection.disconnect()
-                return
-
-    def owns_connection(self, connection: AbstractConnection):
-        return connection.pid == self.pid
+        # Connections should always be returned to the correct pool,
+        # not doing so is an error that will cause an exception here.
+        self._in_use_connections.remove(connection)
+        self._available_connections.append(connection)
 
     async def disconnect(self, inuse_connections: bool = True):
         """
@@ -1171,21 +1081,19 @@ async def disconnect(self, inuse_connections: bool = True):
         current in use, potentially by other tasks. Otherwise only disconnect
         connections that are idle in the pool.
         """
-        self._checkpid()
-        async with self._lock:
-            if inuse_connections:
-                connections: Iterable[AbstractConnection] = chain(
-                    self._available_connections, self._in_use_connections
-                )
-            else:
-                connections = self._available_connections
-            resp = await asyncio.gather(
-                *(connection.disconnect() for connection in connections),
-                return_exceptions=True,
+        if inuse_connections:
+            connections: Iterable[AbstractConnection] = chain(
+                self._available_connections, self._in_use_connections
             )
-            exc = next((r for r in resp if isinstance(r, BaseException)), None)
-            if exc:
-                raise exc
+        else:
+            connections = self._available_connections
+        resp = await asyncio.gather(
+            *(connection.disconnect() for connection in connections),
+            return_exceptions=True,
+        )
+        exc = next((r for r in resp if isinstance(r, BaseException)), None)
+        if exc:
+            raise exc
 
     def set_retry(self, retry: "Retry") -> None:
         for conn in self._available_connections:
@@ -1196,21 +1104,21 @@ def set_retry(self, retry: "Retry") -> None:
 
 class BlockingConnectionPool(ConnectionPool):
     """
-    Thread-safe blocking connection pool::
+    A blocking connection pool::
 
-        >>> from redis.client import Redis
+        >>> from redis.asyncio.client import Redis
         >>> client = Redis(connection_pool=BlockingConnectionPool())
 
     It performs the same function as the default
-    :py:class:`~redis.ConnectionPool` implementation, in that,
+    :py:class:`~redis.asyncio.ConnectionPool` implementation, in that,
     it maintains a pool of reusable connections that can be shared by
-    multiple redis clients (safely across threads if required).
+    multiple async redis clients.
 
     The difference is that, in the event that a client tries to get a
     connection from the pool when all of connections are in use, rather than
     raising a :py:class:`~redis.ConnectionError` (as the default
-    :py:class:`~redis.ConnectionPool` implementation does), it
-    makes the client wait ("blocks") for a specified number of seconds until
+    :py:class:`~redis.asyncio.ConnectionPool` implementation does), it
+    makes blocks the current `Task` for a specified number of seconds until
     a connection becomes available.
 
     Use ``max_connections`` to increase / decrease the pool size::
@@ -1233,131 +1141,30 @@ def __init__(
         max_connections: int = 50,
         timeout: Optional[int] = 20,
         connection_class: Type[AbstractConnection] = Connection,
-        queue_class: Type[asyncio.Queue] = asyncio.LifoQueue,
+        queue_class: Type[asyncio.Queue] = asyncio.LifoQueue,  # deprecated
         **connection_kwargs,
     ):
 
-        self.queue_class = queue_class
-        self.timeout = timeout
-        self._connections: List[AbstractConnection]
         super().__init__(
             connection_class=connection_class,
             max_connections=max_connections,
             **connection_kwargs,
         )
-
-    def reset(self):
-        # Create and fill up a thread safe queue with ``None`` values.
-        self.pool = self.queue_class(self.max_connections)
-        while True:
-            try:
-                self.pool.put_nowait(None)
-            except asyncio.QueueFull:
-                break
-
-        # Keep a list of actual connection instances so that we can
-        # disconnect them later.
-        self._connections = []
-
-        # this must be the last operation in this method. while reset() is
-        # called when holding _fork_lock, other threads in this process
-        # can call _checkpid() which compares self.pid and os.getpid() without
-        # holding any lock (for performance reasons). keeping this assignment
-        # as the last operation ensures that those other threads will also
-        # notice a pid difference and block waiting for the first thread to
-        # release _fork_lock. when each of these threads eventually acquire
-        # _fork_lock, they will notice that another thread already called
-        # reset() and they will immediately release _fork_lock and continue on.
-        self.pid = os.getpid()
-
-    def make_connection(self):
-        """Make a fresh connection."""
-        connection = self.connection_class(**self.connection_kwargs)
-        self._connections.append(connection)
-        return connection
+        self._condition = asyncio.Condition()
+        self.timeout = timeout
 
     async def get_connection(self, command_name, *keys, **options):
-        """
-        Get a connection, blocking for ``self.timeout`` until a connection
-        is available from the pool.
-
-        If the connection returned is ``None`` then creates a new connection.
-        Because we use a last-in first-out queue, the existing connections
-        (having been returned to the pool after the initial ``None`` values
-        were added) will be returned before ``None`` values. This means we only
-        create new connections when we need to, i.e.: the actual number of
-        connections will only increase in response to demand.
-        """
-        # Make sure we haven't changed process.
-        self._checkpid()
-
-        # Try and get a connection from the pool. If one isn't available within
-        # self.timeout then raise a ``ConnectionError``.
-        connection = None
+        """Gets a connection from the pool, blocking until one is available"""
         try:
             async with async_timeout(self.timeout):
-                connection = await self.pool.get()
-        except (asyncio.QueueEmpty, asyncio.TimeoutError):
-            # Note that this is not caught by the redis client and will be
-            # raised unless handled by application code. If you want never to
-            raise ConnectionError("No connection available.")
-
-        # If the ``connection`` is actually ``None`` then that's a cue to make
-        # a new connection to add to the pool.
-        if connection is None:
-            connection = self.make_connection()
-
-        try:
-            # ensure this connection is connected to Redis
-            await connection.connect()
-            # connections that the pool provides should be ready to send
-            # a command. if not, the connection was either returned to the
-            # pool before all data has been read or the socket has been
-            # closed. either way, reconnect and verify everything is good.
-            try:
-                if await connection.can_read_destructive():
-                    raise ConnectionError("Connection has data") from None
-            except (ConnectionError, OSError):
-                await connection.disconnect()
-                await connection.connect()
-                if await connection.can_read_destructive():
-                    raise ConnectionError("Connection not ready") from None
-        except BaseException:
-            # release the connection back to the pool so that we don't leak it
-            await self.release(connection)
-            raise
-
-        return connection
+                async with self._condition:
+                    await self._condition.wait_for(self.can_get_connection)
+                    return await super().get_connection(command_name, *keys, **options)
+        except asyncio.TimeoutError as err:
+            raise ConnectionError("No connection available.") from err
 
     async def release(self, connection: AbstractConnection):
         """Releases the connection back to the pool."""
-        # Make sure we haven't changed process.
-        self._checkpid()
-        if not self.owns_connection(connection):
-            # pool doesn't own this connection. do not add it back
-            # to the pool. instead add a None value which is a placeholder
-            # that will cause the pool to recreate the connection if
-            # its needed.
-            await connection.disconnect()
-            self.pool.put_nowait(None)
-            return
-
-        # Put the connection back into the pool.
-        try:
-            self.pool.put_nowait(connection)
-        except asyncio.QueueFull:
-            # perhaps the pool has been reset() after a fork? regardless,
-            # we don't want this connection
-            pass
-
-    async def disconnect(self, inuse_connections: bool = True):
-        """Disconnects all connections in the pool."""
-        self._checkpid()
-        async with self._lock:
-            resp = await asyncio.gather(
-                *(connection.disconnect() for connection in self._connections),
-                return_exceptions=True,
-            )
-            exc = next((r for r in resp if isinstance(r, BaseException)), None)
-            if exc:
-                raise exc
+        async with self._condition:
+            await super().release(connection)
+            self._condition.notify()
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
index 7672dc74b4..999c03376b 100644
--- a/tests/test_asyncio/test_connection_pool.py
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -1,5 +1,4 @@
 import asyncio
-import os
 import re
 
 import pytest
@@ -94,7 +93,9 @@ class DummyConnection(Connection):
 
     def __init__(self, **kwargs):
         self.kwargs = kwargs
-        self.pid = os.getpid()
+
+    def repr_pieces(self):
+        return [("id", id(self)), ("kwargs", self.kwargs)]
 
     async def connect(self):
         pass

From 578fb26d412a704397ea44ecfd8dc728f6981ece Mon Sep 17 00:00:00 2001
From: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
Date: Thu, 14 Sep 2023 06:32:04 -0700
Subject: [PATCH 0779/1164] Avoid creating ref cycles (#2932)

This won't meaningfully affect most users, so I won't feel bad if this
is closed :-)

It's often important for performance to control when garbage collection
runs and to reduce the need to run garbage collection in the first
place.

During AbstractionConnection.on_connect, it's common to raise and catch
ResponseError, since e.g. CLIENT SETINFO is very new. However, because
response is in a local, it creates ref cycles that keep all locals in
all calling stack frames alive.

The use of a local to store the exception is unfortunate, since
exceptions hold references to their tracebacks, which hold references to
the relevant frames, which holds a reference to the local exception.
See https://peps.python.org/pep-0344/#open-issue-garbage-collection
and https://peps.python.org/pep-3110/#rationale

This breaks the cycle by deleting the local when we raise, so frames are
destroyed by the normal reference counting mechanism.
---
 redis/connection.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/redis/connection.py b/redis/connection.py
index 00d293a238..c6a22aae76 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -513,7 +513,10 @@ def read_response(
             self.next_health_check = time() + self.health_check_interval
 
         if isinstance(response, ResponseError):
-            raise response
+            try:
+                raise response
+            finally:
+                del response  # avoid creating ref cycles
         return response
 
     def pack_command(self, *args):

From 509c77c5263188fad239b07c80ecc5b0e8372647 Mon Sep 17 00:00:00 2001
From: Orji Uchechukwu <orjiuchechukwu52@yahoo.com>
Date: Thu, 14 Sep 2023 15:05:28 +0100
Subject: [PATCH 0780/1164] add pagination, sorting and grouping examples to
 search json example (#2890)

---
 docs/examples/search_json_examples.ipynb | 121 ++++++++++++++++++++---
 1 file changed, 110 insertions(+), 11 deletions(-)

diff --git a/docs/examples/search_json_examples.ipynb b/docs/examples/search_json_examples.ipynb
index b66e3361c7..9ce1efc0ec 100644
--- a/docs/examples/search_json_examples.ipynb
+++ b/docs/examples/search_json_examples.ipynb
@@ -34,7 +34,7 @@
     "from redis.commands.search.query import NumericFilter, Query\n",
     "\n",
     "\n",
-    "r = redis.Redis(host='localhost', port=36379)\n",
+    "r = redis.Redis(host='localhost', port=6379)\n",
     "user1 = {\n",
     "    \"user\":{\n",
     "        \"name\": \"Paul John\",\n",
@@ -59,9 +59,19 @@
     "        \"city\": \"Tel Aviv\"\n",
     "    }\n",
     "}\n",
+    "\n",
+    "user4 = {\n",
+    "    \"user\":{\n",
+    "        \"name\": \"Sarah Zamir\",\n",
+    "        \"email\": \"sarah.zamir@example.com\",\n",
+    "        \"age\": 30,\n",
+    "        \"city\": \"Paris\"\n",
+    "    }\n",
+    "}\n",
     "r.json().set(\"user:1\", Path.root_path(), user1)\n",
     "r.json().set(\"user:2\", Path.root_path(), user2)\n",
     "r.json().set(\"user:3\", Path.root_path(), user3)\n",
+    "r.json().set(\"user:4\", Path.root_path(), user4)\n",
     "\n",
     "schema = (TextField(\"$.user.name\", as_name=\"name\"),TagField(\"$.user.city\", as_name=\"city\"), NumericField(\"$.user.age\", as_name=\"age\"))\n",
     "r.ft().create_index(schema, definition=IndexDefinition(prefix=[\"user:\"], index_type=IndexType.JSON))"
@@ -102,6 +112,7 @@
    ]
   },
   {
+   "attachments": {},
    "cell_type": "markdown",
    "metadata": {},
    "source": [
@@ -133,13 +144,72 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "### Projecting using JSON Path expressions "
+    "### Paginating and Ordering search Results"
    ]
   },
   {
    "cell_type": "code",
    "execution_count": 4,
    "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "Result{4 total, docs: [Document {'id': 'user:1', 'payload': None, 'age': '42', 'json': '{\"user\":{\"name\":\"Paul John\",\"email\":\"paul.john@example.com\",\"age\":42,\"city\":\"London\"}}'}, Document {'id': 'user:3', 'payload': None, 'age': '35', 'json': '{\"user\":{\"name\":\"Paul Zamir\",\"email\":\"paul.zamir@example.com\",\"age\":35,\"city\":\"Tel Aviv\"}}'}]}"
+      ]
+     },
+     "execution_count": 4,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Search for all users, returning 2 users at a time and sorting by age in descending order\n",
+    "offset = 0\n",
+    "num = 2\n",
+    "q = Query(\"*\").paging(offset, num).sort_by(\"age\", asc=False) # pass asc=True to sort in ascending order\n",
+    "r.ft().search(q)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Counting the total number of Items"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "4"
+      ]
+     },
+     "execution_count": 5,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "q = Query(\"*\").paging(0, 0)\n",
+    "r.ft().search(q).total"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Projecting using JSON Path expressions "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
    "outputs": [
     {
      "data": {
@@ -148,7 +218,7 @@
        " Document {'id': 'user:3', 'payload': None, 'city': 'Tel Aviv'}]"
       ]
      },
-     "execution_count": 4,
+     "execution_count": 6,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -166,7 +236,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 5,
+   "execution_count": 7,
    "metadata": {},
    "outputs": [
     {
@@ -175,7 +245,7 @@
        "[[b'age', b'35'], [b'age', b'42']]"
       ]
      },
-     "execution_count": 5,
+     "execution_count": 7,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -184,6 +254,36 @@
     "req = aggregations.AggregateRequest(\"Paul\").sort_by(\"@age\")\n",
     "r.ft().aggregate(req).rows"
    ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Count the total number of Items"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[[b'total', b'4']]"
+      ]
+     },
+     "execution_count": 8,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# The group_by expects a string or list of strings to group the results before applying the aggregation function to\n",
+    "# each group. Passing an empty list here acts as `GROUPBY 0` which applies the aggregation function to the whole results\n",
+    "req = aggregations.AggregateRequest(\"*\").group_by([], reducers.count().alias(\"total\"))\n",
+    "r.ft().aggregate(req).rows"
+   ]
   }
  ],
  "metadata": {
@@ -191,9 +291,9 @@
    "hash": "d45c99ba0feda92868abafa8257cbb4709c97f1a0b5dc62bbeebdf89d4fad7fe"
   },
   "kernelspec": {
-   "display_name": "Python 3.8.12 64-bit ('venv': venv)",
+   "display_name": "redis-py",
    "language": "python",
-   "name": "python3"
+   "name": "redis-py"
   },
   "language_info": {
    "codemirror_mode": {
@@ -205,10 +305,9 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.8.12"
-  },
-  "orig_nbformat": 4
+   "version": "3.11.3"
+  }
  },
  "nbformat": 4,
- "nbformat_minor": 2
+ "nbformat_minor": 4
 }

From 086efb2b5e898d9d7e5097935b6506508609df16 Mon Sep 17 00:00:00 2001
From: "bodong.ybd" <bodong.ybd@alibaba-inc.com>
Date: Mon, 18 Sep 2023 18:22:00 +0800
Subject: [PATCH 0781/1164] Cluster determine slot command name need upper
 (#2919)

The judgment of the name is all uppercase, for example:
    L970: if command in ("EVAL", "EVALSHA"):
---
 redis/asyncio/cluster.py | 6 +++---
 redis/cluster.py         | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 84407116ed..65e1bd02ac 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -588,13 +588,13 @@ async def _determine_slot(self, command: str, *args: Any) -> int:
         # EVAL/EVALSHA.
         # - issue: https://github.com/redis/redis/issues/9493
         # - fix: https://github.com/redis/redis/pull/9733
-        if command in ("EVAL", "EVALSHA"):
+        if command.upper() in ("EVAL", "EVALSHA"):
             # command syntax: EVAL "script body" num_keys ...
             if len(args) < 2:
                 raise RedisClusterException(
                     f"Invalid args in command: {command, *args}"
                 )
-            keys = args[2 : 2 + args[1]]
+            keys = args[2 : 2 + int(args[1])]
             # if there are 0 keys, that means the script can be run on any node
             # so we can just return a random slot
             if not keys:
@@ -604,7 +604,7 @@ async def _determine_slot(self, command: str, *args: Any) -> int:
             if not keys:
                 # FCALL can call a function with 0 keys, that means the function
                 #  can be run on any node so we can just return a random slot
-                if command in ("FCALL", "FCALL_RO"):
+                if command.upper() in ("FCALL", "FCALL_RO"):
                     return random.randrange(0, REDIS_CLUSTER_HASH_SLOTS)
                 raise RedisClusterException(
                     "No way to dispatch this command to Redis Cluster. "
diff --git a/redis/cluster.py b/redis/cluster.py
index cba62de077..0347893205 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -967,11 +967,11 @@ def determine_slot(self, *args):
         # redis server to parse the keys. Besides, there is a bug in redis<7.0
         # where `self._get_command_keys()` fails anyway. So, we special case
         # EVAL/EVALSHA.
-        if command in ("EVAL", "EVALSHA"):
+        if command.upper() in ("EVAL", "EVALSHA"):
             # command syntax: EVAL "script body" num_keys ...
             if len(args) <= 2:
                 raise RedisClusterException(f"Invalid args in command: {args}")
-            num_actual_keys = args[2]
+            num_actual_keys = int(args[2])
             eval_keys = args[3 : 3 + num_actual_keys]
             # if there are 0 keys, that means the script can be run on any node
             # so we can just return a random slot
@@ -983,7 +983,7 @@ def determine_slot(self, *args):
             if keys is None or len(keys) == 0:
                 # FCALL can call a function with 0 keys, that means the function
                 #  can be run on any node so we can just return a random slot
-                if command in ("FCALL", "FCALL_RO"):
+                if command.upper() in ("FCALL", "FCALL_RO"):
                     return random.randrange(0, REDIS_CLUSTER_HASH_SLOTS)
                 raise RedisClusterException(
                     "No way to dispatch this command to Redis Cluster. "

From 012f7cf7d2950e8241eb5705e7cdd83b09370ba4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Mon, 18 Sep 2023 23:09:41 +0000
Subject: [PATCH 0782/1164] Add `Redis.from_pool()` class method, for
 explicitly owning and closing a ConnectionPool (#2913)

* Add the `from_pool` argument to asyncio.Redis

* Add tests for the `from_pool` argument

* Add a "from_pool" argument for the sync client too

* Add automatic connection pool close for redis.sentinel

* use from_pool() class method instead

* re-add the auto_close_connection_pool arg to Connection.from_url()

* Deprecate the "auto_close_connection_pool" argument to Redis() and Redis.from_url()
---
 docs/examples/asyncio_examples.ipynb  |  33 ++++++--
 redis/asyncio/client.py               |  65 ++++++++++++---
 redis/asyncio/connection.py           |   4 +-
 redis/asyncio/sentinel.py             |  14 +---
 redis/client.py                       |  29 ++++++-
 redis/sentinel.py                     |  12 +--
 tests/test_asyncio/test_connection.py | 112 ++++++++++++++++++++++++--
 tests/test_connection.py              |  89 +++++++++++++++++++-
 tests/test_sentinel.py                |  26 ++++++
 9 files changed, 334 insertions(+), 50 deletions(-)

diff --git a/docs/examples/asyncio_examples.ipynb b/docs/examples/asyncio_examples.ipynb
index f7e67e2ca7..a8ee8faf8b 100644
--- a/docs/examples/asyncio_examples.ipynb
+++ b/docs/examples/asyncio_examples.ipynb
@@ -44,6 +44,26 @@
     "await connection.close()"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "If you create custom `ConnectionPool` for the `Redis` instance to use alone, use the `from_pool` class method to create it.  This will cause the pool to be disconnected along with the Redis instance. Disconnecting the connection pool simply disconnects all connections hosted in the pool."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import redis.asyncio as redis\n",
+    "\n",
+    "pool = redis.ConnectionPool.from_url(\"redis://localhost\")\n",
+    "connection = redis.Redis.from_pool(pool)\n",
+    "await connection.close()"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {
@@ -53,7 +73,8 @@
     }
    },
    "source": [
-    "If you supply a custom `ConnectionPool` that is supplied to several `Redis` instances, you may want to disconnect the connection pool explicitly. Disconnecting the connection pool simply disconnects all connections hosted in the pool."
+    "\n",
+    "However, If you supply a `ConnectionPool` that is shared several `Redis` instances, you may want to disconnect the connection pool explicitly. use the `connection_pool` argument in that case."
    ]
   },
   {
@@ -69,10 +90,12 @@
    "source": [
     "import redis.asyncio as redis\n",
     "\n",
-    "connection = redis.Redis(auto_close_connection_pool=False)\n",
-    "await connection.close()\n",
-    "# Or: await connection.close(close_connection_pool=False)\n",
-    "await connection.connection_pool.disconnect()"
+    "pool = redis.ConnectionPool.from_url(\"redis://localhost\")\n",
+    "connection1 = redis.Redis(connection_pool=pool)\n",
+    "connection2 = redis.Redis(connection_pool=pool)\n",
+    "await connection1.close()\n",
+    "await connection2.close()\n",
+    "await pool.disconnect()"
    ]
   },
   {
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index f0c1ab7536..cce1b5815d 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -114,7 +114,7 @@ def from_url(
         cls,
         url: str,
         single_connection_client: bool = False,
-        auto_close_connection_pool: bool = True,
+        auto_close_connection_pool: Optional[bool] = None,
         **kwargs,
     ):
         """
@@ -160,12 +160,39 @@ class initializer. In the case of conflicting arguments, querystring
 
         """
         connection_pool = ConnectionPool.from_url(url, **kwargs)
-        redis = cls(
+        client = cls(
             connection_pool=connection_pool,
             single_connection_client=single_connection_client,
         )
-        redis.auto_close_connection_pool = auto_close_connection_pool
-        return redis
+        if auto_close_connection_pool is not None:
+            warnings.warn(
+                DeprecationWarning(
+                    '"auto_close_connection_pool" is deprecated '
+                    "since version 5.0.0. "
+                    "Please create a ConnectionPool explicitly and "
+                    "provide to the Redis() constructor instead."
+                )
+            )
+        else:
+            auto_close_connection_pool = True
+        client.auto_close_connection_pool = auto_close_connection_pool
+        return client
+
+    @classmethod
+    def from_pool(
+        cls: Type["Redis"],
+        connection_pool: ConnectionPool,
+    ) -> "Redis":
+        """
+        Return a Redis client from the given connection pool.
+        The Redis client will take ownership of the connection pool and
+        close it when the Redis client is closed.
+        """
+        client = cls(
+            connection_pool=connection_pool,
+        )
+        client.auto_close_connection_pool = True
+        return client
 
     def __init__(
         self,
@@ -200,7 +227,8 @@ def __init__(
         lib_version: Optional[str] = get_lib_version(),
         username: Optional[str] = None,
         retry: Optional[Retry] = None,
-        auto_close_connection_pool: bool = True,
+        # deprecated. create a pool and use connection_pool instead
+        auto_close_connection_pool: Optional[bool] = None,
         redis_connect_func=None,
         credential_provider: Optional[CredentialProvider] = None,
         protocol: Optional[int] = 2,
@@ -213,14 +241,21 @@ def __init__(
         To retry on TimeoutError, `retry_on_timeout` can also be set to `True`.
         """
         kwargs: Dict[str, Any]
-        # auto_close_connection_pool only has an effect if connection_pool is
-        # None. This is a similar feature to the missing __del__ to resolve #1103,
-        # but it accounts for whether a user wants to manually close the connection
-        # pool, as a similar feature to ConnectionPool's __del__.
-        self.auto_close_connection_pool = (
-            auto_close_connection_pool if connection_pool is None else False
-        )
+
+        if auto_close_connection_pool is not None:
+            warnings.warn(
+                DeprecationWarning(
+                    '"auto_close_connection_pool" is deprecated '
+                    "since version 5.0.0. "
+                    "Please create a ConnectionPool explicitly and "
+                    "provide to the Redis() constructor instead."
+                )
+            )
+        else:
+            auto_close_connection_pool = True
+
         if not connection_pool:
+            # Create internal connection pool, expected to be closed by Redis instance
             if not retry_on_error:
                 retry_on_error = []
             if retry_on_timeout is True:
@@ -277,7 +312,13 @@ def __init__(
                             "ssl_check_hostname": ssl_check_hostname,
                         }
                     )
+            # This arg only used if no pool is passed in
+            self.auto_close_connection_pool = auto_close_connection_pool
             connection_pool = ConnectionPool(**kwargs)
+        else:
+            # If a pool is passed in, do not close it
+            self.auto_close_connection_pool = False
+
         self.connection_pool = connection_pool
         self.single_connection_client = single_connection_client
         self.connection: Optional[Connection] = None
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 00865515ab..4f20e6ec1d 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -1106,8 +1106,8 @@ class BlockingConnectionPool(ConnectionPool):
     """
     A blocking connection pool::
 
-        >>> from redis.asyncio.client import Redis
-        >>> client = Redis(connection_pool=BlockingConnectionPool())
+        >>> from redis.asyncio import Redis, BlockingConnectionPool
+        >>> client = Redis.from_pool(BlockingConnectionPool())
 
     It performs the same function as the default
     :py:class:`~redis.asyncio.ConnectionPool` implementation, in that,
diff --git a/redis/asyncio/sentinel.py b/redis/asyncio/sentinel.py
index 20c0a1fdd5..6834fb194f 100644
--- a/redis/asyncio/sentinel.py
+++ b/redis/asyncio/sentinel.py
@@ -340,12 +340,7 @@ def master_for(
 
         connection_pool = connection_pool_class(service_name, self, **connection_kwargs)
         # The Redis object "owns" the pool
-        auto_close_connection_pool = True
-        client = redis_class(
-            connection_pool=connection_pool,
-        )
-        client.auto_close_connection_pool = auto_close_connection_pool
-        return client
+        return redis_class.from_pool(connection_pool)
 
     def slave_for(
         self,
@@ -377,9 +372,4 @@ def slave_for(
 
         connection_pool = connection_pool_class(service_name, self, **connection_kwargs)
         # The Redis object "owns" the pool
-        auto_close_connection_pool = True
-        client = redis_class(
-            connection_pool=connection_pool,
-        )
-        client.auto_close_connection_pool = auto_close_connection_pool
-        return client
+        return redis_class.from_pool(connection_pool)
diff --git a/redis/client.py b/redis/client.py
index f695cef534..017f8ef11d 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -4,7 +4,7 @@
 import time
 import warnings
 from itertools import chain
-from typing import Optional
+from typing import Optional, Type
 
 from redis._parsers.helpers import (
     _RedisCallbacks,
@@ -136,10 +136,28 @@ class initializer. In the case of conflicting arguments, querystring
         """
         single_connection_client = kwargs.pop("single_connection_client", False)
         connection_pool = ConnectionPool.from_url(url, **kwargs)
-        return cls(
+        client = cls(
             connection_pool=connection_pool,
             single_connection_client=single_connection_client,
         )
+        client.auto_close_connection_pool = True
+        return client
+
+    @classmethod
+    def from_pool(
+        cls: Type["Redis"],
+        connection_pool: ConnectionPool,
+    ) -> "Redis":
+        """
+        Return a Redis client from the given connection pool.
+        The Redis client will take ownership of the connection pool and
+        close it when the Redis client is closed.
+        """
+        client = cls(
+            connection_pool=connection_pool,
+        )
+        client.auto_close_connection_pool = True
+        return client
 
     def __init__(
         self,
@@ -275,6 +293,10 @@ def __init__(
                         }
                     )
             connection_pool = ConnectionPool(**kwargs)
+            self.auto_close_connection_pool = True
+        else:
+            self.auto_close_connection_pool = False
+
         self.connection_pool = connection_pool
         self.connection = None
         if single_connection_client:
@@ -477,6 +499,9 @@ def close(self):
             self.connection = None
             self.connection_pool.release(conn)
 
+        if self.auto_close_connection_pool:
+            self.connection_pool.disconnect()
+
     def _send_command_parse_response(self, conn, command_name, *args, **options):
         """
         Send a command and parse the response
diff --git a/redis/sentinel.py b/redis/sentinel.py
index 836e781e7f..41f308d1ee 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -353,10 +353,8 @@ def master_for(
         kwargs["is_master"] = True
         connection_kwargs = dict(self.connection_kwargs)
         connection_kwargs.update(kwargs)
-        return redis_class(
-            connection_pool=connection_pool_class(
-                service_name, self, **connection_kwargs
-            )
+        return redis_class.from_pool(
+            connection_pool_class(service_name, self, **connection_kwargs)
         )
 
     def slave_for(
@@ -386,8 +384,6 @@ def slave_for(
         kwargs["is_master"] = False
         connection_kwargs = dict(self.connection_kwargs)
         connection_kwargs.update(kwargs)
-        return redis_class(
-            connection_pool=connection_pool_class(
-                service_name, self, **connection_kwargs
-            )
+        return redis_class.from_pool(
+            connection_pool_class(service_name, self, **connection_kwargs)
         )
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index 9ee6db1566..a954a40dbf 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -11,7 +11,7 @@
     _AsyncRESP3Parser,
     _AsyncRESPBase,
 )
-from redis.asyncio import Redis
+from redis.asyncio import ConnectionPool, Redis
 from redis.asyncio.connection import Connection, UnixDomainSocketConnection, parse_url
 from redis.asyncio.retry import Retry
 from redis.backoff import NoBackoff
@@ -288,7 +288,7 @@ def test_create_single_connection_client_from_url():
     assert client.single_connection_client is True
 
 
-@pytest.mark.parametrize("from_url", (True, False))
+@pytest.mark.parametrize("from_url", (True, False), ids=("from_url", "from_args"))
 async def test_pool_auto_close(request, from_url):
     """Verify that basic Redis instances have auto_close_connection_pool set to True"""
 
@@ -305,20 +305,116 @@ async def get_redis_connection():
     await r1.close()
 
 
-@pytest.mark.parametrize("from_url", (True, False))
-async def test_pool_auto_close_disable(request, from_url):
-    """Verify that auto_close_connection_pool can be disabled"""
+async def test_pool_from_url_deprecation(request):
+    url: str = request.config.getoption("--redis-url")
+
+    with pytest.deprecated_call():
+        return Redis.from_url(url, auto_close_connection_pool=False)
+
+
+async def test_pool_auto_close_disable(request):
+    """Verify that auto_close_connection_pool can be disabled (deprecated)"""
 
     url: str = request.config.getoption("--redis-url")
     url_args = parse_url(url)
 
     async def get_redis_connection():
-        if from_url:
-            return Redis.from_url(url, auto_close_connection_pool=False)
         url_args["auto_close_connection_pool"] = False
-        return Redis(**url_args)
+        with pytest.deprecated_call():
+            return Redis(**url_args)
 
     r1 = await get_redis_connection()
     assert r1.auto_close_connection_pool is False
     await r1.connection_pool.disconnect()
     await r1.close()
+
+
+@pytest.mark.parametrize("from_url", (True, False), ids=("from_url", "from_args"))
+async def test_redis_connection_pool(request, from_url):
+    """Verify that basic Redis instances using `connection_pool`
+    have auto_close_connection_pool set to False"""
+
+    url: str = request.config.getoption("--redis-url")
+    url_args = parse_url(url)
+
+    pool = None
+
+    async def get_redis_connection():
+        nonlocal pool
+        if from_url:
+            pool = ConnectionPool.from_url(url)
+        else:
+            pool = ConnectionPool(**url_args)
+        return Redis(connection_pool=pool)
+
+    called = 0
+
+    async def mock_disconnect(_):
+        nonlocal called
+        called += 1
+
+    with patch.object(ConnectionPool, "disconnect", mock_disconnect):
+        async with await get_redis_connection() as r1:
+            assert r1.auto_close_connection_pool is False
+
+    assert called == 0
+    await pool.disconnect()
+
+
+@pytest.mark.parametrize("from_url", (True, False), ids=("from_url", "from_args"))
+async def test_redis_from_pool(request, from_url):
+    """Verify that basic Redis instances created using `from_pool()`
+    have auto_close_connection_pool set to True"""
+
+    url: str = request.config.getoption("--redis-url")
+    url_args = parse_url(url)
+
+    pool = None
+
+    async def get_redis_connection():
+        nonlocal pool
+        if from_url:
+            pool = ConnectionPool.from_url(url)
+        else:
+            pool = ConnectionPool(**url_args)
+        return Redis.from_pool(pool)
+
+    called = 0
+
+    async def mock_disconnect(_):
+        nonlocal called
+        called += 1
+
+    with patch.object(ConnectionPool, "disconnect", mock_disconnect):
+        async with await get_redis_connection() as r1:
+            assert r1.auto_close_connection_pool is True
+
+    assert called == 1
+    await pool.disconnect()
+
+
+@pytest.mark.parametrize("auto_close", (True, False))
+async def test_redis_pool_auto_close_arg(request, auto_close):
+    """test that redis instance where pool is provided have
+    auto_close_connection_pool set to False, regardless of arg"""
+
+    url: str = request.config.getoption("--redis-url")
+    pool = ConnectionPool.from_url(url)
+
+    async def get_redis_connection():
+        with pytest.deprecated_call():
+            client = Redis(connection_pool=pool, auto_close_connection_pool=auto_close)
+        return client
+
+    called = 0
+
+    async def mock_disconnect(_):
+        nonlocal called
+        called += 1
+
+    with patch.object(ConnectionPool, "disconnect", mock_disconnect):
+        async with await get_redis_connection() as r1:
+            assert r1.auto_close_connection_pool is False
+
+    assert called == 0
+    await pool.disconnect()
diff --git a/tests/test_connection.py b/tests/test_connection.py
index 760b23c9c1..bff249559e 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -5,9 +5,15 @@
 
 import pytest
 import redis
+from redis import ConnectionPool, Redis
 from redis._parsers import _HiredisParser, _RESP2Parser, _RESP3Parser
 from redis.backoff import NoBackoff
-from redis.connection import Connection, SSLConnection, UnixDomainSocketConnection
+from redis.connection import (
+    Connection,
+    SSLConnection,
+    UnixDomainSocketConnection,
+    parse_url,
+)
 from redis.exceptions import ConnectionError, InvalidResponse, TimeoutError
 from redis.retry import Retry
 from redis.utils import HIREDIS_AVAILABLE
@@ -209,3 +215,84 @@ def test_create_single_connection_client_from_url():
         "redis://localhost:6379/0?", single_connection_client=True
     )
     assert client.connection is not None
+
+
+@pytest.mark.parametrize("from_url", (True, False), ids=("from_url", "from_args"))
+def test_pool_auto_close(request, from_url):
+    """Verify that basic Redis instances have auto_close_connection_pool set to True"""
+
+    url: str = request.config.getoption("--redis-url")
+    url_args = parse_url(url)
+
+    def get_redis_connection():
+        if from_url:
+            return Redis.from_url(url)
+        return Redis(**url_args)
+
+    r1 = get_redis_connection()
+    assert r1.auto_close_connection_pool is True
+    r1.close()
+
+
+@pytest.mark.parametrize("from_url", (True, False), ids=("from_url", "from_args"))
+def test_redis_connection_pool(request, from_url):
+    """Verify that basic Redis instances using `connection_pool`
+    have auto_close_connection_pool set to False"""
+
+    url: str = request.config.getoption("--redis-url")
+    url_args = parse_url(url)
+
+    pool = None
+
+    def get_redis_connection():
+        nonlocal pool
+        if from_url:
+            pool = ConnectionPool.from_url(url)
+        else:
+            pool = ConnectionPool(**url_args)
+        return Redis(connection_pool=pool)
+
+    called = 0
+
+    def mock_disconnect(_):
+        nonlocal called
+        called += 1
+
+    with patch.object(ConnectionPool, "disconnect", mock_disconnect):
+        with get_redis_connection() as r1:
+            assert r1.auto_close_connection_pool is False
+
+    assert called == 0
+    pool.disconnect()
+
+
+@pytest.mark.parametrize("from_url", (True, False), ids=("from_url", "from_args"))
+def test_redis_from_pool(request, from_url):
+    """Verify that basic Redis instances created using `from_pool()`
+    have auto_close_connection_pool set to True"""
+
+    url: str = request.config.getoption("--redis-url")
+    url_args = parse_url(url)
+
+    pool = None
+
+    def get_redis_connection():
+        nonlocal pool
+        if from_url:
+            pool = ConnectionPool.from_url(url)
+        else:
+            pool = ConnectionPool(**url_args)
+        return Redis.from_pool(pool)
+
+    called = 0
+
+    def mock_disconnect(_):
+        nonlocal called
+        called += 1
+
+    with patch.object(ConnectionPool, "disconnect", mock_disconnect):
+        with get_redis_connection() as r1:
+            assert r1.auto_close_connection_pool is True
+
+    assert called == 1
+    pool.disconnect()
diff --git a/tests/test_sentinel.py b/tests/test_sentinel.py
index b7bcc27de2..54b9647098 100644
--- a/tests/test_sentinel.py
+++ b/tests/test_sentinel.py
@@ -1,4 +1,5 @@
 import socket
+from unittest import mock
 
 import pytest
 import redis.sentinel
@@ -240,3 +241,28 @@ def test_flushconfig(cluster, sentinel):
 def test_reset(cluster, sentinel):
     cluster.master["is_odown"] = True
     assert sentinel.sentinel_reset("mymaster")
+
+
+@pytest.mark.onlynoncluster
+@pytest.mark.parametrize("method_name", ["master_for", "slave_for"])
+def test_auto_close_pool(cluster, sentinel, method_name):
+    """
+    Check that the connection pool created by the sentinel client is
+    automatically closed
+    """
+
+    method = getattr(sentinel, method_name)
+    client = method("mymaster", db=9)
+    pool = client.connection_pool
+    assert client.auto_close_connection_pool is True
+    calls = 0
+
+    def mock_disconnect():
+        nonlocal calls
+        calls += 1
+
+    with mock.patch.object(pool, "disconnect", mock_disconnect):
+        client.close()
+
+    assert calls == 1
+    pool.disconnect()

From 0acd0e7f0f2383a77bdc3a09a51fd95ff6588070 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 19 Sep 2023 14:43:15 +0300
Subject: [PATCH 0783/1164] Add support for multimple values in `RPUSHX`
 (#2949)

---
 redis/commands/core.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 031781d75d..9d81e9772c 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -2823,13 +2823,13 @@ def rpush(self, name: str, *values: FieldT) -> Union[Awaitable[int], int]:
         """
         return self.execute_command("RPUSH", name, *values)
 
-    def rpushx(self, name: str, value: str) -> Union[Awaitable[int], int]:
+    def rpushx(self, name: str, *values: str) -> Union[Awaitable[int], int]:
         """
         Push ``value`` onto the tail of the list ``name`` if ``name`` exists
 
         For more information see https://redis.io/commands/rpushx
         """
-        return self.execute_command("RPUSHX", name, value)
+        return self.execute_command("RPUSHX", name, *values)
 
     def lpos(
         self,

From 2df75ad4d8678cb0d76463c5ad17213618121b9d Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 19 Sep 2023 19:23:20 +0300
Subject: [PATCH 0784/1164] Fix monitor regex bug (#2950)

---
 redis/asyncio/client.py | 2 +-
 redis/client.py         | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index cce1b5815d..122469a194 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -645,7 +645,7 @@ class Monitor:
     listen() method yields commands from monitor.
     """
 
-    monitor_re = re.compile(r"\[(\d+) (.*)\] (.*)")
+    monitor_re = re.compile(r"\[(\d+) (.*?)\] (.*)")
     command_re = re.compile(r'"(.*?)(?<!\\)"')
 
     def __init__(self, connection_pool: ConnectionPool):
diff --git a/redis/client.py b/redis/client.py
index 017f8ef11d..d285e1ca46 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -571,7 +571,7 @@ class Monitor:
     listen() method yields commands from monitor.
     """
 
-    monitor_re = re.compile(r"\[(\d+) (.*)\] (.*)")
+    monitor_re = re.compile(r"\[(\d+) (.*?)\] (.*)")
     command_re = re.compile(r'"(.*?)(?<!\\)"')
 
     def __init__(self, connection_pool):

From 620764198882051ef9e32bfa1fcf31742b2fb095 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 19 Sep 2023 19:23:40 +0300
Subject: [PATCH 0785/1164] Add support for `ModuleCommands` in cluster (#2951)

---
 redis/cluster.py                    | 4 ++++
 redis/commands/cluster.py           | 4 ++++
 tests/test_asyncio/test_commands.py | 1 -
 tests/test_commands.py              | 1 -
 4 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index 0347893205..2ce9c54f85 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -295,6 +295,10 @@ class AbstractRedisCluster:
                 "LATENCY HISTORY",
                 "LATENCY LATEST",
                 "LATENCY RESET",
+                "MODULE LIST",
+                "MODULE LOAD",
+                "MODULE UNLOAD",
+                "MODULE LOADEX",
             ],
             DEFAULT_NODE,
         ),
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index 691cab3def..14b8741443 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -32,11 +32,13 @@
     AsyncFunctionCommands,
     AsyncGearsCommands,
     AsyncManagementCommands,
+    AsyncModuleCommands,
     AsyncScriptCommands,
     DataAccessCommands,
     FunctionCommands,
     GearsCommands,
     ManagementCommands,
+    ModuleCommands,
     PubSubCommands,
     ResponseT,
     ScriptCommands,
@@ -873,6 +875,7 @@ class RedisClusterCommands(
     ScriptCommands,
     FunctionCommands,
     GearsCommands,
+    ModuleCommands,
     RedisModuleCommands,
 ):
     """
@@ -903,6 +906,7 @@ class AsyncRedisClusterCommands(
     AsyncScriptCommands,
     AsyncFunctionCommands,
     AsyncGearsCommands,
+    AsyncModuleCommands,
 ):
     """
     A class for all Redis Cluster commands
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 6a3a2eca59..9b9852e9ef 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -3213,7 +3213,6 @@ async def test_memory_usage(self, r: redis.Redis):
         assert isinstance(await r.memory_usage("foo"), int)
 
     @skip_if_server_version_lt("4.0.0")
-    @pytest.mark.onlynoncluster
     async def test_module_list(self, r: redis.Redis):
         assert isinstance(await r.module_list(), list)
         for x in await r.module_list():
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 114fb6b686..b538dc3038 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -4909,7 +4909,6 @@ def test_latency_latest(self, r: redis.Redis):
     def test_latency_reset(self, r: redis.Redis):
         assert r.latency_reset() == 0
 
-    @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("4.0.0")
     @skip_if_redis_enterprise()
     def test_module_list(self, r):

From c46a28dfdff95bfbe9b8872ee6cc17f41487f11f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Wed, 20 Sep 2023 07:00:58 +0000
Subject: [PATCH 0786/1164] Provide aclose() / close() for classes requiring
 lifetime management (#2898)

* Define `aclose()` methods instead of `close()` for async Redis()

* update examples to use `aclose()`

* Update tests to use Redis.aclose()

* Add aclose() to asyncio.client.PubSub
close() and reset() retained as aliases

* Add aclose method to asyncio.RedisCluster

* Add aclose() to asyncio.client.Pipeline

* add `close()` method to sync Pipeline

* add `aclose()` to asyncio.connection.ConnectionPool

* Add `close()` method to redis.ConnectionPool

* Deprecate older functions.

* changes.txt

* fix unittest

* fix typo

* Update docs
---
 CHANGES                                    |  1 +
 docs/examples/asyncio_examples.ipynb       | 28 ++++----
 redis/asyncio/client.py                    | 46 +++++++++----
 redis/asyncio/cluster.py                   | 35 ++++++----
 redis/asyncio/connection.py                |  4 ++
 redis/client.py                            |  4 ++
 redis/connection.py                        |  4 ++
 tests/test_asyncio/compat.py               | 12 ++++
 tests/test_asyncio/conftest.py             |  4 +-
 tests/test_asyncio/test_cluster.py         | 73 ++++++++++++++------
 tests/test_asyncio/test_connection.py      | 22 +++++-
 tests/test_asyncio/test_connection_pool.py | 22 ++++--
 tests/test_asyncio/test_pipeline.py        | 19 ++++++
 tests/test_asyncio/test_pubsub.py          | 79 ++++++++++++++++------
 tests/test_connection_pool.py              | 11 +++
 tests/test_pipeline.py                     | 21 ++++++
 16 files changed, 294 insertions(+), 91 deletions(-)

diff --git a/CHANGES b/CHANGES
index 7b3b4c5ac2..8cfc47db18 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Add 'aclose()' methods to async classes, deprecate async close().
     * Fix #2831, add auto_close_connection_pool=True arg to asyncio.Redis.from_url()
     * Fix incorrect redis.asyncio.Cluster type hint for `retry_on_error`
     * Fix dead weakref in sentinel connection causing ReferenceError (#2767)
diff --git a/docs/examples/asyncio_examples.ipynb b/docs/examples/asyncio_examples.ipynb
index a8ee8faf8b..5eab4db1f7 100644
--- a/docs/examples/asyncio_examples.ipynb
+++ b/docs/examples/asyncio_examples.ipynb
@@ -15,7 +15,7 @@
     "\n",
     "## Connecting and Disconnecting\n",
     "\n",
-    "Utilizing asyncio Redis requires an explicit disconnect of the connection since there is no asyncio deconstructor magic method. By default, a connection pool is created on `redis.Redis()` and attached to this `Redis` instance. The connection pool closes automatically on the call to `Redis.close` which disconnects all connections."
+    "Utilizing asyncio Redis requires an explicit disconnect of the connection since there is no asyncio deconstructor magic method. By default, a connection pool is created on `redis.Redis()` and attached to this `Redis` instance. The connection pool closes automatically on the call to `Redis.aclose` which disconnects all connections."
    ]
   },
   {
@@ -39,9 +39,9 @@
    "source": [
     "import redis.asyncio as redis\n",
     "\n",
-    "connection = redis.Redis()\n",
-    "print(f\"Ping successful: {await connection.ping()}\")\n",
-    "await connection.close()"
+    "client = redis.Redis()\n",
+    "print(f\"Ping successful: {await client.ping()}\")\n",
+    "await client.aclose()"
    ]
   },
   {
@@ -60,8 +60,8 @@
     "import redis.asyncio as redis\n",
     "\n",
     "pool = redis.ConnectionPool.from_url(\"redis://localhost\")\n",
-    "connection = redis.Redis.from_pool(pool)\n",
-    "await connection.close()"
+    "client = redis.Redis.from_pool(pool)\n",
+    "await client.close()"
    ]
   },
   {
@@ -91,11 +91,11 @@
     "import redis.asyncio as redis\n",
     "\n",
     "pool = redis.ConnectionPool.from_url(\"redis://localhost\")\n",
-    "connection1 = redis.Redis(connection_pool=pool)\n",
-    "connection2 = redis.Redis(connection_pool=pool)\n",
-    "await connection1.close()\n",
-    "await connection2.close()\n",
-    "await pool.disconnect()"
+    "client1 = redis.Redis(connection_pool=pool)\n",
+    "client2 = redis.Redis(connection_pool=pool)\n",
+    "await client1.aclose()\n",
+    "await client2.aclose()\n",
+    "await pool.aclose()"
    ]
   },
   {
@@ -113,9 +113,9 @@
    "source": [
     "import redis.asyncio as redis\n",
     "\n",
-    "connection = redis.Redis(protocol=3)\n",
-    "await connection.close()\n",
-    "await connection.ping()"
+    "client = redis.Redis(protocol=3)\n",
+    "await client.aclose()\n",
+    "await client.ping()"
    ]
   },
   {
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 122469a194..c340d851b1 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -14,7 +14,6 @@
     List,
     Mapping,
     MutableMapping,
-    NoReturn,
     Optional,
     Set,
     Tuple,
@@ -65,6 +64,7 @@
 from redis.utils import (
     HIREDIS_AVAILABLE,
     _set_info_logger,
+    deprecated_function,
     get_lib_version,
     safe_str,
     str_if_bytes,
@@ -527,7 +527,7 @@ async def __aenter__(self: _RedisT) -> _RedisT:
         return await self.initialize()
 
     async def __aexit__(self, exc_type, exc_value, traceback):
-        await self.close()
+        await self.aclose()
 
     _DEL_MESSAGE = "Unclosed Redis client"
 
@@ -539,7 +539,7 @@ def __del__(self, _warnings: Any = warnings) -> None:
             context = {"client": self, "message": self._DEL_MESSAGE}
             asyncio.get_running_loop().call_exception_handler(context)
 
-    async def close(self, close_connection_pool: Optional[bool] = None) -> None:
+    async def aclose(self, close_connection_pool: Optional[bool] = None) -> None:
         """
         Closes Redis client connection
 
@@ -557,6 +557,13 @@ async def close(self, close_connection_pool: Optional[bool] = None) -> None:
         ):
             await self.connection_pool.disconnect()
 
+    @deprecated_function(version="5.0.0", reason="Use aclose() instead", name="close")
+    async def close(self, close_connection_pool: Optional[bool] = None) -> None:
+        """
+        Alias for aclose(), for backwards compatibility
+        """
+        await self.aclose(close_connection_pool)
+
     async def _send_command_parse_response(self, conn, command_name, *args, **options):
         """
         Send a command and parse the response
@@ -764,13 +771,18 @@ async def __aenter__(self):
         return self
 
     async def __aexit__(self, exc_type, exc_value, traceback):
-        await self.reset()
+        await self.aclose()
 
     def __del__(self):
         if self.connection:
             self.connection.clear_connect_callbacks()
 
-    async def reset(self):
+    async def aclose(self):
+        # In case a connection property does not yet exist
+        # (due to a crash earlier in the Redis() constructor), return
+        # immediately as there is nothing to clean-up.
+        if not hasattr(self, "connection"):
+            return
         async with self._lock:
             if self.connection:
                 await self.connection.disconnect()
@@ -782,13 +794,15 @@ async def reset(self):
             self.patterns = {}
             self.pending_unsubscribe_patterns = set()
 
-    def close(self) -> Awaitable[NoReturn]:
-        # In case a connection property does not yet exist
-        # (due to a crash earlier in the Redis() constructor), return
-        # immediately as there is nothing to clean-up.
-        if not hasattr(self, "connection"):
-            return
-        return self.reset()
+    @deprecated_function(version="5.0.0", reason="Use aclose() instead", name="close")
+    async def close(self) -> None:
+        """Alias for aclose(), for backwards compatibility"""
+        await self.aclose()
+
+    @deprecated_function(version="5.0.0", reason="Use aclose() instead", name="reset")
+    async def reset(self) -> None:
+        """Alias for aclose(), for backwards compatibility"""
+        await self.aclose()
 
     async def on_connect(self, connection: Connection):
         """Re-subscribe to any channels and patterns previously subscribed to"""
@@ -1232,6 +1246,10 @@ async def reset(self):
             await self.connection_pool.release(self.connection)
             self.connection = None
 
+    async def aclose(self) -> None:
+        """Alias for reset(), a standard method name for cleanup"""
+        await self.reset()
+
     def multi(self):
         """
         Start a transactional block of the pipeline after WATCH commands
@@ -1264,14 +1282,14 @@ async def _disconnect_reset_raise(self, conn, error):
         # valid since this connection has died. raise a WatchError, which
         # indicates the user should retry this transaction.
         if self.watching:
-            await self.reset()
+            await self.aclose()
             raise WatchError(
                 "A ConnectionError occurred on while watching one or more keys"
             )
         # if retry_on_timeout is not set, or the error is not
         # a TimeoutError, raise it
         if not (conn.retry_on_timeout and isinstance(error, TimeoutError)):
-            await self.reset()
+            await self.aclose()
             raise
 
     async def immediate_execute_command(self, *args, **options):
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 65e1bd02ac..f4f031580d 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -62,7 +62,13 @@
     TryAgainError,
 )
 from redis.typing import AnyKeyT, EncodableT, KeyT
-from redis.utils import dict_merge, get_lib_version, safe_str, str_if_bytes
+from redis.utils import (
+    deprecated_function,
+    dict_merge,
+    get_lib_version,
+    safe_str,
+    str_if_bytes,
+)
 
 TargetNodesT = TypeVar(
     "TargetNodesT", str, "ClusterNode", List["ClusterNode"], Dict[Any, "ClusterNode"]
@@ -395,12 +401,12 @@ async def initialize(self) -> "RedisCluster":
                         )
                         self._initialize = False
                     except BaseException:
-                        await self.nodes_manager.close()
-                        await self.nodes_manager.close("startup_nodes")
+                        await self.nodes_manager.aclose()
+                        await self.nodes_manager.aclose("startup_nodes")
                         raise
         return self
 
-    async def close(self) -> None:
+    async def aclose(self) -> None:
         """Close all connections & client if initialized."""
         if not self._initialize:
             if not self._lock:
@@ -408,14 +414,19 @@ async def close(self) -> None:
             async with self._lock:
                 if not self._initialize:
                     self._initialize = True
-                    await self.nodes_manager.close()
-                    await self.nodes_manager.close("startup_nodes")
+                    await self.nodes_manager.aclose()
+                    await self.nodes_manager.aclose("startup_nodes")
+
+    @deprecated_function(version="5.0.0", reason="Use aclose() instead", name="close")
+    async def close(self) -> None:
+        """alias for aclose() for backwards compatibility"""
+        await self.aclose()
 
     async def __aenter__(self) -> "RedisCluster":
         return await self.initialize()
 
     async def __aexit__(self, exc_type: None, exc_value: None, traceback: None) -> None:
-        await self.close()
+        await self.aclose()
 
     def __await__(self) -> Generator[Any, None, "RedisCluster"]:
         return self.initialize().__await__()
@@ -767,13 +778,13 @@ async def _execute_command(
                 self.nodes_manager.startup_nodes.pop(target_node.name, None)
                 # Hard force of reinitialize of the node/slots setup
                 # and try again with the new setup
-                await self.close()
+                await self.aclose()
                 raise
             except ClusterDownError:
                 # ClusterDownError can occur during a failover and to get
                 # self-healed, we will try to reinitialize the cluster layout
                 # and retry executing the command
-                await self.close()
+                await self.aclose()
                 await asyncio.sleep(0.25)
                 raise
             except MovedError as e:
@@ -790,7 +801,7 @@ async def _execute_command(
                     self.reinitialize_steps
                     and self.reinitialize_counter % self.reinitialize_steps == 0
                 ):
-                    await self.close()
+                    await self.aclose()
                     # Reset the counter
                     self.reinitialize_counter = 0
                 else:
@@ -1323,7 +1334,7 @@ async def initialize(self) -> None:
         # If initialize was called after a MovedError, clear it
         self._moved_exception = None
 
-    async def close(self, attr: str = "nodes_cache") -> None:
+    async def aclose(self, attr: str = "nodes_cache") -> None:
         self.default_node = None
         await asyncio.gather(
             *(
@@ -1471,7 +1482,7 @@ async def execute(
                     if type(e) in self.__class__.ERRORS_ALLOW_RETRY:
                         # Try again with the new cluster setup.
                         exception = e
-                        await self._client.close()
+                        await self._client.aclose()
                         await asyncio.sleep(0.25)
                     else:
                         # All other errors should be raised.
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 4f20e6ec1d..71d0e92002 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -1095,6 +1095,10 @@ async def disconnect(self, inuse_connections: bool = True):
         if exc:
             raise exc
 
+    async def aclose(self) -> None:
+        """Close the pool, disconnecting all connections"""
+        await self.disconnect()
+
     def set_retry(self, retry: "Retry") -> None:
         for conn in self._available_connections:
             conn.retry = retry
diff --git a/redis/client.py b/redis/client.py
index d285e1ca46..1e1ff57605 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1217,6 +1217,10 @@ def reset(self):
             self.connection_pool.release(self.connection)
             self.connection = None
 
+    def close(self):
+        """Close the pipeline"""
+        self.reset()
+
     def multi(self):
         """
         Start a transactional block of the pipeline after WATCH commands
diff --git a/redis/connection.py b/redis/connection.py
index c6a22aae76..45ecd2a370 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1154,6 +1154,10 @@ def disconnect(self, inuse_connections=True):
             for connection in connections:
                 connection.disconnect()
 
+    def close(self) -> None:
+        """Close the pool, disconnecting all connections"""
+        self.disconnect()
+
     def set_retry(self, retry: "Retry") -> None:
         self.connection_kwargs.update({"retry": retry})
         for conn in self._available_connections:
diff --git a/tests/test_asyncio/compat.py b/tests/test_asyncio/compat.py
index 5edcd4ae54..4a9778b70a 100644
--- a/tests/test_asyncio/compat.py
+++ b/tests/test_asyncio/compat.py
@@ -6,6 +6,18 @@
 except AttributeError:
     import mock
 
+try:
+    from contextlib import aclosing
+except ImportError:
+    import contextlib
+
+    @contextlib.asynccontextmanager
+    async def aclosing(thing):
+        try:
+            yield thing
+        finally:
+            await thing.aclose()
+
 
 def create_task(coroutine):
     return asyncio.create_task(coroutine)
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index 10ab4732c2..5d9e0b4f2e 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -100,7 +100,7 @@ async def teardown():
                         # handle cases where a test disconnected a client
                         # just manually retry the flushdb
                         await client.flushdb()
-                await client.close()
+                await client.aclose()
                 await client.connection_pool.disconnect()
             else:
                 if flushdb:
@@ -110,7 +110,7 @@ async def teardown():
                         # handle cases where a test disconnected a client
                         # just manually retry the flushdb
                         await client.flushdb(target_nodes="primaries")
-                await client.close()
+                await client.aclose()
 
         teardown_clients.append(teardown)
         return client
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 332101edd5..e6cf2e4ce7 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -38,7 +38,7 @@
 )
 
 from ..ssl_utils import get_ssl_filename
-from .compat import mock
+from .compat import aclosing, mock
 
 pytestmark = pytest.mark.onlycluster
 
@@ -270,7 +270,38 @@ async def test_host_port_startup_node(self) -> None:
         cluster = await get_mocked_redis_client(host=default_host, port=default_port)
         assert cluster.get_node(host=default_host, port=default_port) is not None
 
-        await cluster.close()
+        await cluster.aclose()
+
+    async def test_aclosing(self) -> None:
+        cluster = await get_mocked_redis_client(host=default_host, port=default_port)
+        called = 0
+
+        async def mock_aclose():
+            nonlocal called
+            called += 1
+
+        with mock.patch.object(cluster, "aclose", mock_aclose):
+            async with aclosing(cluster):
+                pass
+            assert called == 1
+        await cluster.aclose()
+
+    async def test_close_is_aclose(self) -> None:
+        """
+        Test that it is possible to use host & port arguments as startup node
+        args
+        """
+        cluster = await get_mocked_redis_client(host=default_host, port=default_port)
+        called = 0
+
+        async def mock_aclose():
+            nonlocal called
+            called += 1
+
+        with mock.patch.object(cluster, "aclose", mock_aclose):
+            await cluster.close()
+            assert called == 1
+        await cluster.aclose()
 
     async def test_startup_nodes(self) -> None:
         """
@@ -289,7 +320,7 @@ async def test_startup_nodes(self) -> None:
             and cluster.get_node(host=default_host, port=port_2) is not None
         )
 
-        await cluster.close()
+        await cluster.aclose()
 
         startup_node = ClusterNode("127.0.0.1", 16379)
         async with RedisCluster(startup_nodes=[startup_node], client_name="test") as rc:
@@ -417,7 +448,7 @@ async def read_response_mocked(*args: Any, **kwargs: Any) -> None:
                     )
                 )
 
-        await rc.close()
+        await rc.aclose()
 
     async def test_execute_command_errors(self, r: RedisCluster) -> None:
         """
@@ -461,7 +492,7 @@ async def test_execute_command_node_flag_replicas(self, r: RedisCluster) -> None
             conn = primary._free.pop()
             assert conn.read_response.called is not True
 
-        await r.close()
+        await r.aclose()
 
     async def test_execute_command_node_flag_all_nodes(self, r: RedisCluster) -> None:
         """
@@ -690,7 +721,7 @@ def execute_command_mock_third(self, *args, **options):
                 await read_cluster.get("foo")
                 mocks["send_command"].assert_has_calls([mock.call("READONLY")])
 
-                await read_cluster.close()
+                await read_cluster.aclose()
 
     async def test_keyslot(self, r: RedisCluster) -> None:
         """
@@ -762,7 +793,7 @@ def raise_error(target_node, *args, **kwargs):
                 await rc.get("bar")
                 assert execute_command.failed_calls == rc.cluster_error_retry_attempts
 
-            await rc.close()
+            await rc.aclose()
 
     async def test_set_default_node_success(self, r: RedisCluster) -> None:
         """
@@ -843,7 +874,7 @@ async def test_can_run_concurrent_commands(self, request: FixtureRequest) -> Non
                 *(rc.echo("i", target_nodes=RedisCluster.ALL_NODES) for i in range(100))
             )
         )
-        await rc.close()
+        await rc.aclose()
 
     def test_replace_cluster_node(self, r: RedisCluster) -> None:
         prev_default_node = r.get_default_node()
@@ -901,7 +932,7 @@ def address_remap(address):
                 assert await r.set("byte_string", b"giraffe")
                 assert await r.get("byte_string") == b"giraffe"
             finally:
-                await r.close()
+                await r.aclose()
         finally:
             await asyncio.gather(*[p.aclose() for p in proxies])
 
@@ -1002,7 +1033,7 @@ async def test_initialize_before_execute_multi_key_command(
         url = request.config.getoption("--redis-url")
         r = RedisCluster.from_url(url)
         assert 0 == await r.exists("a", "b", "c")
-        await r.close()
+        await r.aclose()
 
     @skip_if_redis_enterprise()
     async def test_cluster_myid(self, r: RedisCluster) -> None:
@@ -1065,7 +1096,7 @@ async def test_cluster_delslots(self) -> None:
         assert node0._free.pop().read_response.called
         assert node1._free.pop().read_response.called
 
-        await r.close()
+        await r.aclose()
 
     @skip_if_server_version_lt("7.0.0")
     @skip_if_redis_enterprise()
@@ -1076,7 +1107,7 @@ async def test_cluster_delslotsrange(self):
         await r.cluster_addslots(node, 1, 2, 3, 4, 5)
         assert await r.cluster_delslotsrange(1, 5)
         assert node._free.pop().read_response.called
-        await r.close()
+        await r.aclose()
 
     @skip_if_redis_enterprise()
     async def test_cluster_failover(self, r: RedisCluster) -> None:
@@ -1286,7 +1317,7 @@ async def test_readonly(self) -> None:
         for replica in r.get_replicas():
             assert replica._free.pop().read_response.called
 
-        await r.close()
+        await r.aclose()
 
     @skip_if_redis_enterprise()
     async def test_readwrite(self) -> None:
@@ -1299,7 +1330,7 @@ async def test_readwrite(self) -> None:
         for replica in r.get_replicas():
             assert replica._free.pop().read_response.called
 
-        await r.close()
+        await r.aclose()
 
     @skip_if_redis_enterprise()
     async def test_bgsave(self, r: RedisCluster) -> None:
@@ -1524,7 +1555,7 @@ async def test_client_kill(
         ]
         assert len(clients) == 1
         assert clients[0].get("name") == "redis-py-c1"
-        await r2.close()
+        await r2.aclose()
 
     @skip_if_server_version_lt("2.6.0")
     async def test_cluster_bitop_not_empty_string(self, r: RedisCluster) -> None:
@@ -2302,7 +2333,7 @@ async def test_acl_log(
 
         await r.acl_deluser(username, target_nodes="primaries")
 
-        await user_client.close()
+        await user_client.aclose()
 
 
 class TestNodesManager:
@@ -2359,7 +2390,7 @@ async def test_init_slots_cache_not_all_slots_covered(self) -> None:
                 cluster_slots=cluster_slots,
                 require_full_coverage=True,
             )
-            await rc.close()
+            await rc.aclose()
         assert str(ex.value).startswith(
             "All slots are not covered after query all startup_nodes."
         )
@@ -2385,7 +2416,7 @@ async def test_init_slots_cache_not_require_full_coverage_success(self) -> None:
 
         assert 5460 not in rc.nodes_manager.slots_cache
 
-        await rc.close()
+        await rc.aclose()
 
     async def test_init_slots_cache(self) -> None:
         """
@@ -2416,7 +2447,7 @@ async def test_init_slots_cache(self) -> None:
 
         assert len(n_manager.nodes_cache) == 6
 
-        await rc.close()
+        await rc.aclose()
 
     async def test_init_slots_cache_cluster_mode_disabled(self) -> None:
         """
@@ -2427,7 +2458,7 @@ async def test_init_slots_cache_cluster_mode_disabled(self) -> None:
             rc = await get_mocked_redis_client(
                 host=default_host, port=default_port, cluster_enabled=False
             )
-            await rc.close()
+            await rc.aclose()
         assert "Cluster mode is not enabled on this node" in str(e.value)
 
     async def test_empty_startup_nodes(self) -> None:
@@ -2514,7 +2545,7 @@ async def test_cluster_one_instance(self) -> None:
         for i in range(0, REDIS_CLUSTER_HASH_SLOTS):
             assert n.slots_cache[i] == [n_node]
 
-        await rc.close()
+        await rc.aclose()
 
     async def test_init_with_down_node(self) -> None:
         """
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index a954a40dbf..28e6b0d9c3 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -302,7 +302,25 @@ async def get_redis_connection():
 
     r1 = await get_redis_connection()
     assert r1.auto_close_connection_pool is True
-    await r1.close()
+    await r1.aclose()
+
+
+async def test_close_is_aclose(request):
+    """Verify close() calls aclose()"""
+    calls = 0
+
+    async def mock_aclose(self):
+        nonlocal calls
+        calls += 1
+
+    url: str = request.config.getoption("--redis-url")
+    r1 = await Redis.from_url(url)
+    with patch.object(r1, "aclose", mock_aclose):
+        await r1.close()
+        assert calls == 1
+
+    with pytest.deprecated_call():
+        await r1.close()
 
 
 async def test_pool_from_url_deprecation(request):
@@ -326,7 +344,7 @@ async def get_redis_connection():
     r1 = await get_redis_connection()
     assert r1.auto_close_connection_pool is False
     await r1.connection_pool.disconnect()
-    await r1.close()
+    await r1.aclose()
 
 
 @pytest.mark.parametrize("from_url", (True, False), ids=("from_url", "from_args"))
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
index 999c03376b..c93fa91a39 100644
--- a/tests/test_asyncio/test_connection_pool.py
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -7,7 +7,7 @@
 from redis.asyncio.connection import Connection, to_bool
 from tests.conftest import skip_if_redis_enterprise, skip_if_server_version_lt
 
-from .compat import mock
+from .compat import aclosing, mock
 from .conftest import asynccontextmanager
 from .test_pubsub import wait_for_message
 
@@ -42,7 +42,7 @@ async def test_auto_disconnect_redis_created_pool(self, r: redis.Redis):
         new_conn = await self.create_two_conn(r)
         assert new_conn != r.connection
         assert self.get_total_connected_connections(r.connection_pool) == 2
-        await r.close()
+        await r.aclose()
         assert self.has_no_connected_connections(r.connection_pool)
 
     async def test_do_not_auto_disconnect_redis_created_pool(self, r2: redis.Redis):
@@ -52,7 +52,7 @@ async def test_do_not_auto_disconnect_redis_created_pool(self, r2: redis.Redis):
         )
         new_conn = await self.create_two_conn(r2)
         assert self.get_total_connected_connections(r2.connection_pool) == 2
-        await r2.close()
+        await r2.aclose()
         assert r2.connection_pool._in_use_connections == {new_conn}
         assert new_conn.is_connected
         assert len(r2.connection_pool._available_connections) == 1
@@ -61,7 +61,7 @@ async def test_do_not_auto_disconnect_redis_created_pool(self, r2: redis.Redis):
     async def test_auto_release_override_true_manual_created_pool(self, r: redis.Redis):
         assert r.auto_close_connection_pool is True, "This is from the class fixture"
         await self.create_two_conn(r)
-        await r.close()
+        await r.aclose()
         assert self.get_total_connected_connections(r.connection_pool) == 2, (
             "The connection pool should not be disconnected as a manually created "
             "connection pool was passed in in conftest.py"
@@ -72,7 +72,7 @@ async def test_auto_release_override_true_manual_created_pool(self, r: redis.Red
     async def test_close_override(self, r: redis.Redis, auto_close_conn_pool):
         r.auto_close_connection_pool = auto_close_conn_pool
         await self.create_two_conn(r)
-        await r.close(close_connection_pool=True)
+        await r.aclose(close_connection_pool=True)
         assert self.has_no_connected_connections(r.connection_pool)
 
     @pytest.mark.parametrize("auto_close_conn_pool", [True, False])
@@ -81,7 +81,7 @@ async def test_negate_auto_close_client_pool(
     ):
         r.auto_close_connection_pool = auto_close_conn_pool
         new_conn = await self.create_two_conn(r)
-        await r.close(close_connection_pool=False)
+        await r.aclose(close_connection_pool=False)
         assert not self.has_no_connected_connections(r.connection_pool)
         assert r.connection_pool._in_use_connections == {new_conn}
         assert r.connection_pool._available_connections[0].is_connected
@@ -135,6 +135,16 @@ async def test_connection_creation(self):
             assert isinstance(connection, DummyConnection)
             assert connection.kwargs == connection_kwargs
 
+    async def test_aclosing(self):
+        connection_kwargs = {"foo": "bar", "biz": "baz"}
+        pool = redis.ConnectionPool(
+            connection_class=DummyConnection,
+            max_connections=None,
+            **connection_kwargs,
+        )
+        async with aclosing(pool):
+            pass
+
     async def test_multiple_connections(self, master_host):
         connection_kwargs = {"host": master_host[0]}
         async with self.get_pool(connection_kwargs=connection_kwargs) as pool:
diff --git a/tests/test_asyncio/test_pipeline.py b/tests/test_asyncio/test_pipeline.py
index edd2f6d147..0fa1204750 100644
--- a/tests/test_asyncio/test_pipeline.py
+++ b/tests/test_asyncio/test_pipeline.py
@@ -2,6 +2,7 @@
 import redis
 from tests.conftest import skip_if_server_version_lt
 
+from .compat import aclosing, mock
 from .conftest import wait_for_command
 
 
@@ -286,6 +287,24 @@ async def test_watch_reset_unwatch(self, r):
             assert unwatch_command is not None
             assert unwatch_command["command"] == "UNWATCH"
 
+    @pytest.mark.onlynoncluster
+    async def test_aclose_is_reset(self, r):
+        async with r.pipeline() as pipe:
+            called = 0
+
+            async def mock_reset():
+                nonlocal called
+                called += 1
+
+            with mock.patch.object(pipe, "reset", mock_reset):
+                await pipe.aclose()
+                assert called == 1
+
+    @pytest.mark.onlynoncluster
+    async def test_aclosing(self, r):
+        async with aclosing(r.pipeline()):
+            pass
+
     @pytest.mark.onlynoncluster
     async def test_transaction_callable(self, r):
         await r.set("a", 1)
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index 858576584f..8fef34d83d 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -20,7 +20,7 @@
 from redis.utils import HIREDIS_AVAILABLE
 from tests.conftest import get_protocol_version, skip_if_server_version_lt
 
-from .compat import create_task, mock
+from .compat import aclosing, create_task, mock
 
 
 def with_timeout(t):
@@ -84,9 +84,8 @@ def make_subscribe_test_data(pubsub, type):
 
 @pytest_asyncio.fixture()
 async def pubsub(r: redis.Redis):
-    p = r.pubsub()
-    yield p
-    await p.close()
+    async with r.pubsub() as p:
+        yield p
 
 
 @pytest.mark.onlynoncluster
@@ -217,6 +216,46 @@ async def test_subscribe_property_with_patterns(self, pubsub):
         kwargs = make_subscribe_test_data(pubsub, "pattern")
         await self._test_subscribed_property(**kwargs)
 
+    async def test_aclosing(self, r: redis.Redis):
+        p = r.pubsub()
+        async with aclosing(p):
+            assert p.subscribed is False
+            await p.subscribe("foo")
+            assert p.subscribed is True
+        assert p.subscribed is False
+
+    async def test_context_manager(self, r: redis.Redis):
+        p = r.pubsub()
+        async with p:
+            assert p.subscribed is False
+            await p.subscribe("foo")
+            assert p.subscribed is True
+        assert p.subscribed is False
+
+    async def test_close_is_aclose(self, r: redis.Redis):
+        """
+        Test backwards compatible close method
+        """
+        p = r.pubsub()
+        assert p.subscribed is False
+        await p.subscribe("foo")
+        assert p.subscribed is True
+        with pytest.deprecated_call():
+            await p.close()
+        assert p.subscribed is False
+
+    async def test_reset_is_aclose(self, r: redis.Redis):
+        """
+        Test backwards compatible reset method
+        """
+        p = r.pubsub()
+        assert p.subscribed is False
+        await p.subscribe("foo")
+        assert p.subscribed is True
+        with pytest.deprecated_call():
+            await p.reset()
+        assert p.subscribed is False
+
     async def test_ignore_all_subscribe_messages(self, r: redis.Redis):
         p = r.pubsub(ignore_subscribe_messages=True)
 
@@ -233,7 +272,7 @@ async def test_ignore_all_subscribe_messages(self, r: redis.Redis):
             assert p.subscribed is True
             assert await wait_for_message(p) is None
         assert p.subscribed is False
-        await p.close()
+        await p.aclose()
 
     async def test_ignore_individual_subscribe_messages(self, pubsub):
         p = pubsub
@@ -350,7 +389,7 @@ async def test_channel_message_handler(self, r: redis.Redis):
         assert await r.publish("foo", "test message") == 1
         assert await wait_for_message(p) is None
         assert self.message == make_message("message", "foo", "test message")
-        await p.close()
+        await p.aclose()
 
     async def test_channel_async_message_handler(self, r):
         p = r.pubsub(ignore_subscribe_messages=True)
@@ -359,7 +398,7 @@ async def test_channel_async_message_handler(self, r):
         assert await r.publish("foo", "test message") == 1
         assert await wait_for_message(p) is None
         assert self.async_message == make_message("message", "foo", "test message")
-        await p.close()
+        await p.aclose()
 
     async def test_channel_sync_async_message_handler(self, r):
         p = r.pubsub(ignore_subscribe_messages=True)
@@ -371,7 +410,7 @@ async def test_channel_sync_async_message_handler(self, r):
         assert await wait_for_message(p) is None
         assert self.message == make_message("message", "foo", "test message")
         assert self.async_message == make_message("message", "bar", "test message 2")
-        await p.close()
+        await p.aclose()
 
     @pytest.mark.onlynoncluster
     async def test_pattern_message_handler(self, r: redis.Redis):
@@ -383,7 +422,7 @@ async def test_pattern_message_handler(self, r: redis.Redis):
         assert self.message == make_message(
             "pmessage", "foo", "test message", pattern="f*"
         )
-        await p.close()
+        await p.aclose()
 
     async def test_unicode_channel_message_handler(self, r: redis.Redis):
         p = r.pubsub(ignore_subscribe_messages=True)
@@ -394,7 +433,7 @@ async def test_unicode_channel_message_handler(self, r: redis.Redis):
         assert await r.publish(channel, "test message") == 1
         assert await wait_for_message(p) is None
         assert self.message == make_message("message", channel, "test message")
-        await p.close()
+        await p.aclose()
 
     @pytest.mark.onlynoncluster
     # see: https://redis-py-cluster.readthedocs.io/en/stable/pubsub.html
@@ -410,7 +449,7 @@ async def test_unicode_pattern_message_handler(self, r: redis.Redis):
         assert self.message == make_message(
             "pmessage", channel, "test message", pattern=pattern
         )
-        await p.close()
+        await p.aclose()
 
     async def test_get_message_without_subscribe(self, r: redis.Redis, pubsub):
         p = pubsub
@@ -524,7 +563,7 @@ async def test_channel_message_handler(self, r: redis.Redis):
         await r.publish(self.channel, new_data)
         assert await wait_for_message(p) is None
         assert self.message == self.make_message("message", self.channel, new_data)
-        await p.close()
+        await p.aclose()
 
     async def test_pattern_message_handler(self, r: redis.Redis):
         p = r.pubsub(ignore_subscribe_messages=True)
@@ -546,7 +585,7 @@ async def test_pattern_message_handler(self, r: redis.Redis):
         assert self.message == self.make_message(
             "pmessage", self.channel, new_data, pattern=self.pattern
         )
-        await p.close()
+        await p.aclose()
 
     async def test_context_manager(self, r: redis.Redis):
         async with r.pubsub() as pubsub:
@@ -556,7 +595,7 @@ async def test_context_manager(self, r: redis.Redis):
         assert pubsub.connection is None
         assert pubsub.channels == {}
         assert pubsub.patterns == {}
-        await pubsub.close()
+        await pubsub.aclose()
 
 
 @pytest.mark.onlynoncluster
@@ -597,9 +636,9 @@ async def test_pubsub_numsub(self, r: redis.Redis):
 
         channels = [(b"foo", 1), (b"bar", 2), (b"baz", 3)]
         assert await r.pubsub_numsub("foo", "bar", "baz") == channels
-        await p1.close()
-        await p2.close()
-        await p3.close()
+        await p1.aclose()
+        await p2.aclose()
+        await p3.aclose()
 
     @skip_if_server_version_lt("2.8.0")
     async def test_pubsub_numpat(self, r: redis.Redis):
@@ -608,7 +647,7 @@ async def test_pubsub_numpat(self, r: redis.Redis):
         for i in range(3):
             assert (await wait_for_message(p))["type"] == "psubscribe"
         assert await r.pubsub_numpat() == 3
-        await p.close()
+        await p.aclose()
 
 
 @pytest.mark.onlynoncluster
@@ -621,7 +660,7 @@ async def test_send_pubsub_ping(self, r: redis.Redis):
         assert await wait_for_message(p) == make_message(
             type="pong", channel=None, data="", pattern=None
         )
-        await p.close()
+        await p.aclose()
 
     @skip_if_server_version_lt("3.0.0")
     async def test_send_pubsub_ping_message(self, r: redis.Redis):
@@ -631,7 +670,7 @@ async def test_send_pubsub_ping_message(self, r: redis.Redis):
         assert await wait_for_message(p) == make_message(
             type="pong", channel=None, data="hello world", pattern=None
         )
-        await p.close()
+        await p.aclose()
 
 
 @pytest.mark.onlynoncluster
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index ab0fc6be98..ef70a8ff35 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -1,6 +1,7 @@
 import os
 import re
 import time
+from contextlib import closing
 from threading import Thread
 from unittest import mock
 
@@ -51,6 +52,16 @@ def test_connection_creation(self):
         assert isinstance(connection, DummyConnection)
         assert connection.kwargs == connection_kwargs
 
+    def test_closing(self):
+        connection_kwargs = {"foo": "bar", "biz": "baz"}
+        pool = redis.ConnectionPool(
+            connection_class=DummyConnection,
+            max_connections=None,
+            **connection_kwargs,
+        )
+        with closing(pool):
+            pass
+
     def test_multiple_connections(self, master_host):
         connection_kwargs = {"host": master_host[0], "port": master_host[1]}
         pool = self.get_pool(connection_kwargs=connection_kwargs)
diff --git a/tests/test_pipeline.py b/tests/test_pipeline.py
index 7b048eec01..e64a763bae 100644
--- a/tests/test_pipeline.py
+++ b/tests/test_pipeline.py
@@ -1,3 +1,6 @@
+from contextlib import closing
+from unittest import mock
+
 import pytest
 import redis
 
@@ -284,6 +287,24 @@ def test_watch_reset_unwatch(self, r):
             assert unwatch_command is not None
             assert unwatch_command["command"] == "UNWATCH"
 
+    @pytest.mark.onlynoncluster
+    def test_close_is_reset(self, r):
+        with r.pipeline() as pipe:
+            called = 0
+
+            def mock_reset():
+                nonlocal called
+                called += 1
+
+            with mock.patch.object(pipe, "reset", mock_reset):
+                pipe.close()
+                assert called == 1
+
+    @pytest.mark.onlynoncluster
+    def test_closing(self, r):
+        with closing(r.pipeline()):
+            pass
+
     @pytest.mark.onlynoncluster
     def test_transaction_callable(self, r):
         r["a"] = 1

From ded9f7c7e130b1797a11ee73a141e537ae37a83d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Wed, 20 Sep 2023 17:27:40 +0000
Subject: [PATCH 0787/1164] async fixes, remove __del__ and other things
 (#2870)

* Use correct redis url if not default when creating Connection

* Make resource-warning __del__ code safer during shutdown

* Remove __del__ handler, fix pubsub weakref callback handling

* Clarify comment, since there is no __del__ on asyncio.connection.ConnectionPool

* Remove remaining __del__ from async parser.  They are not needed.

* make connect callback methods internal

* similarly make non-async connect callbacks internal, use same system as for async.

* Reformat __del__()
---
 redis/_parsers/base.py                        |  6 ----
 redis/asyncio/client.py                       | 28 ++++++++++++-------
 redis/asyncio/cluster.py                      | 27 +++++++++++-------
 redis/asyncio/connection.py                   | 15 +++++++---
 redis/client.py                               |  4 +--
 redis/cluster.py                              |  2 +-
 redis/connection.py                           | 15 +++++++---
 .../test_sentinel_managed_connection.py       |  4 +--
 8 files changed, 62 insertions(+), 39 deletions(-)

diff --git a/redis/_parsers/base.py b/redis/_parsers/base.py
index f77296df6a..5de04c0f94 100644
--- a/redis/_parsers/base.py
+++ b/redis/_parsers/base.py
@@ -138,12 +138,6 @@ def __init__(self, socket_read_size: int):
         self._stream: Optional[StreamReader] = None
         self._read_size = socket_read_size
 
-    def __del__(self):
-        try:
-            self.on_disconnect()
-        except Exception:
-            pass
-
     async def can_read_destructive(self) -> bool:
         raise NotImplementedError()
 
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index c340d851b1..381df50ccc 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -227,7 +227,6 @@ def __init__(
         lib_version: Optional[str] = get_lib_version(),
         username: Optional[str] = None,
         retry: Optional[Retry] = None,
-        # deprecated. create a pool and use connection_pool instead
         auto_close_connection_pool: Optional[bool] = None,
         redis_connect_func=None,
         credential_provider: Optional[CredentialProvider] = None,
@@ -241,7 +240,9 @@ def __init__(
         To retry on TimeoutError, `retry_on_timeout` can also be set to `True`.
         """
         kwargs: Dict[str, Any]
-
+        # auto_close_connection_pool only has an effect if connection_pool is
+        # None. It is assumed that if connection_pool is not None, the user
+        # wants to manage the connection pool themselves.
         if auto_close_connection_pool is not None:
             warnings.warn(
                 DeprecationWarning(
@@ -531,13 +532,20 @@ async def __aexit__(self, exc_type, exc_value, traceback):
 
     _DEL_MESSAGE = "Unclosed Redis client"
 
-    def __del__(self, _warnings: Any = warnings) -> None:
+    # passing _warnings and _grl as argument default since they may be gone
+    # by the time __del__ is called at shutdown
+    def __del__(
+        self,
+        _warn: Any = warnings.warn,
+        _grl: Any = asyncio.get_running_loop,
+    ) -> None:
         if hasattr(self, "connection") and (self.connection is not None):
-            _warnings.warn(
-                f"Unclosed client session {self!r}", ResourceWarning, source=self
-            )
-            context = {"client": self, "message": self._DEL_MESSAGE}
-            asyncio.get_running_loop().call_exception_handler(context)
+            _warn(f"Unclosed client session {self!r}", ResourceWarning, source=self)
+            try:
+                context = {"client": self, "message": self._DEL_MESSAGE}
+                _grl().call_exception_handler(context)
+            except RuntimeError:
+                pass
 
     async def aclose(self, close_connection_pool: Optional[bool] = None) -> None:
         """
@@ -786,7 +794,7 @@ async def aclose(self):
         async with self._lock:
             if self.connection:
                 await self.connection.disconnect()
-                self.connection.clear_connect_callbacks()
+                self.connection._deregister_connect_callback(self.on_connect)
                 await self.connection_pool.release(self.connection)
                 self.connection = None
             self.channels = {}
@@ -849,7 +857,7 @@ async def connect(self):
             )
             # register a callback that re-subscribes to any channels we
             # were listening to when we were disconnected
-            self.connection.register_connect_callback(self.on_connect)
+            self.connection._register_connect_callback(self.on_connect)
         else:
             await self.connection.connect()
         if self.push_handler_func is not None and not HIREDIS_AVAILABLE:
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index f4f031580d..15634de81f 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -433,14 +433,18 @@ def __await__(self) -> Generator[Any, None, "RedisCluster"]:
 
     _DEL_MESSAGE = "Unclosed RedisCluster client"
 
-    def __del__(self) -> None:
+    def __del__(
+        self,
+        _warn: Any = warnings.warn,
+        _grl: Any = asyncio.get_running_loop,
+    ) -> None:
         if hasattr(self, "_initialize") and not self._initialize:
-            warnings.warn(f"{self._DEL_MESSAGE} {self!r}", ResourceWarning, source=self)
+            _warn(f"{self._DEL_MESSAGE} {self!r}", ResourceWarning, source=self)
             try:
                 context = {"client": self, "message": self._DEL_MESSAGE}
-                asyncio.get_running_loop().call_exception_handler(context)
+                _grl().call_exception_handler(context)
             except RuntimeError:
-                ...
+                pass
 
     async def on_connect(self, connection: Connection) -> None:
         await connection.on_connect()
@@ -969,17 +973,20 @@ def __eq__(self, obj: Any) -> bool:
 
     _DEL_MESSAGE = "Unclosed ClusterNode object"
 
-    def __del__(self) -> None:
+    def __del__(
+        self,
+        _warn: Any = warnings.warn,
+        _grl: Any = asyncio.get_running_loop,
+    ) -> None:
         for connection in self._connections:
             if connection.is_connected:
-                warnings.warn(
-                    f"{self._DEL_MESSAGE} {self!r}", ResourceWarning, source=self
-                )
+                _warn(f"{self._DEL_MESSAGE} {self!r}", ResourceWarning, source=self)
+
                 try:
                     context = {"client": self, "message": self._DEL_MESSAGE}
-                    asyncio.get_running_loop().call_exception_handler(context)
+                    _grl().call_exception_handler(context)
                 except RuntimeError:
-                    ...
+                    pass
                 break
 
     async def disconnect(self) -> None:
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 71d0e92002..f36b4bf79b 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -216,11 +216,16 @@ def repr_pieces(self):
     def is_connected(self):
         return self._reader is not None and self._writer is not None
 
-    def register_connect_callback(self, callback):
-        self._connect_callbacks.append(weakref.WeakMethod(callback))
+    def _register_connect_callback(self, callback):
+        wm = weakref.WeakMethod(callback)
+        if wm not in self._connect_callbacks:
+            self._connect_callbacks.append(wm)
 
-    def clear_connect_callbacks(self):
-        self._connect_callbacks = []
+    def _deregister_connect_callback(self, callback):
+        try:
+            self._connect_callbacks.remove(weakref.WeakMethod(callback))
+        except ValueError:
+            pass
 
     def set_parser(self, parser_class: Type[BaseParser]) -> None:
         """
@@ -263,6 +268,8 @@ async def connect(self):
 
         # run any user callbacks. right now the only internal callback
         # is for pubsub channel/pattern resubscription
+        # first, remove any dead weakrefs
+        self._connect_callbacks = [ref for ref in self._connect_callbacks if ref()]
         for ref in self._connect_callbacks:
             callback = ref()
             task = callback(self)
diff --git a/redis/client.py b/redis/client.py
index 1e1ff57605..cf6dbf1eed 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -690,7 +690,7 @@ def __del__(self):
     def reset(self):
         if self.connection:
             self.connection.disconnect()
-            self.connection.clear_connect_callbacks()
+            self.connection._deregister_connect_callback(self.on_connect)
             self.connection_pool.release(self.connection)
             self.connection = None
         self.health_check_response_counter = 0
@@ -748,7 +748,7 @@ def execute_command(self, *args):
             )
             # register a callback that re-subscribes to any channels we
             # were listening to when we were disconnected
-            self.connection.register_connect_callback(self.on_connect)
+            self.connection._register_connect_callback(self.on_connect)
             if self.push_handler_func is not None and not HIREDIS_AVAILABLE:
                 self.connection._parser.set_push_handler(self.push_handler_func)
         connection = self.connection
diff --git a/redis/cluster.py b/redis/cluster.py
index 2ce9c54f85..ee3e1a865d 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -1775,7 +1775,7 @@ def execute_command(self, *args):
             )
             # register a callback that re-subscribes to any channels we
             # were listening to when we were disconnected
-            self.connection.register_connect_callback(self.on_connect)
+            self.connection._register_connect_callback(self.on_connect)
             if self.push_handler_func is not None and not HIREDIS_AVAILABLE:
                 self.connection._parser.set_push_handler(self.push_handler_func)
         connection = self.connection
diff --git a/redis/connection.py b/redis/connection.py
index 45ecd2a370..f5266d7dce 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -237,11 +237,16 @@ def _construct_command_packer(self, packer):
         else:
             return PythonRespSerializer(self._buffer_cutoff, self.encoder.encode)
 
-    def register_connect_callback(self, callback):
-        self._connect_callbacks.append(weakref.WeakMethod(callback))
+    def _register_connect_callback(self, callback):
+        wm = weakref.WeakMethod(callback)
+        if wm not in self._connect_callbacks:
+            self._connect_callbacks.append(wm)
 
-    def clear_connect_callbacks(self):
-        self._connect_callbacks = []
+    def _deregister_connect_callback(self, callback):
+        try:
+            self._connect_callbacks.remove(weakref.WeakMethod(callback))
+        except ValueError:
+            pass
 
     def set_parser(self, parser_class):
         """
@@ -279,6 +284,8 @@ def connect(self):
 
         # run any user callbacks. right now the only internal callback
         # is for pubsub channel/pattern resubscription
+        # first, remove any dead weakrefs
+        self._connect_callbacks = [ref for ref in self._connect_callbacks if ref()]
         for ref in self._connect_callbacks:
             callback = ref()
             if callback:
diff --git a/tests/test_asyncio/test_sentinel_managed_connection.py b/tests/test_asyncio/test_sentinel_managed_connection.py
index e784690c77..711b3ee733 100644
--- a/tests/test_asyncio/test_sentinel_managed_connection.py
+++ b/tests/test_asyncio/test_sentinel_managed_connection.py
@@ -10,11 +10,11 @@
 pytestmark = pytest.mark.asyncio
 
 
-async def test_connect_retry_on_timeout_error():
+async def test_connect_retry_on_timeout_error(connect_args):
     """Test that the _connect function is retried in case of a timeout"""
     connection_pool = mock.AsyncMock()
     connection_pool.get_master_address = mock.AsyncMock(
-        return_value=("localhost", 6379)
+        return_value=(connect_args["host"], connect_args["port"])
     )
     conn = SentinelManagedConnection(
         retry_on_timeout=True,

From 1b370da71709ad31ec947bf14af4b5831d57b9cb Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 21 Sep 2023 11:43:57 +0300
Subject: [PATCH 0788/1164] Replace clear_connect_callbacks with
 _deregister_connect_callback (#2955)

---
 redis/asyncio/client.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 381df50ccc..e4d2e776bc 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -783,7 +783,7 @@ async def __aexit__(self, exc_type, exc_value, traceback):
 
     def __del__(self):
         if self.connection:
-            self.connection.clear_connect_callbacks()
+            self.connection._deregister_connect_callback(self.on_connect)
 
     async def aclose(self):
         # In case a connection property does not yet exist

From 56b254eb7b3827274e8eeb45b18e0b2345a27582 Mon Sep 17 00:00:00 2001
From: ali <anio@users.noreply.github.com>
Date: Thu, 21 Sep 2023 10:48:34 +0200
Subject: [PATCH 0789/1164] Save a reference to created async tasks, to avoid
 tasks potentially disappearing (#2816)

* save a reference to created tasks, to avoid tasks disappearing mid-execution

* Ignore linter

* Ignore linter

---------

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/asyncio/cluster.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 15634de81f..636144a9c7 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -1135,13 +1135,13 @@ def set_nodes(
         if remove_old:
             for name in list(old.keys()):
                 if name not in new:
-                    asyncio.create_task(old.pop(name).disconnect())
+                    task = asyncio.create_task(old.pop(name).disconnect())  # noqa
 
         for name, node in new.items():
             if name in old:
                 if old[name] is node:
                     continue
-                asyncio.create_task(old[name].disconnect())
+                task = asyncio.create_task(old[name].disconnect())  # noqa
             old[name] = node
 
     def _update_moved_slots(self) -> None:

From 2ee7c3cb352d368df6521425f2e613dd4b2fcadc Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 21 Sep 2023 14:23:40 +0300
Subject: [PATCH 0790/1164] Type hint improvements (#2952)

* Some type hints

* fixed callable[T]

* con

* more connectios

* restoring dev reqs

* Update redis/commands/search/suggestion.py

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* Update redis/commands/core.py

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* Update redis/commands/search/suggestion.py

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* Update redis/commands/search/commands.py

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* Update redis/client.py

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* Update redis/commands/search/suggestion.py

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* Update redis/connection.py

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* Update redis/connection.py

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* Update redis/connection.py

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* Update redis/connection.py

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* Update redis/client.py

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* Update redis/client.py

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* linters

---------

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/_parsers/base.py                |   1 -
 redis/_parsers/resp3.py               |   6 +-
 redis/asyncio/connection.py           |   1 -
 redis/client.py                       | 118 +++++++++++++-----------
 redis/cluster.py                      |   1 -
 redis/commands/core.py                |   2 +-
 redis/commands/json/commands.py       |   1 -
 redis/commands/search/__init__.py     |   1 -
 redis/commands/search/aggregation.py  |  44 ++++-----
 redis/commands/search/commands.py     |  76 +++++++++-------
 redis/commands/search/field.py        |   1 -
 redis/commands/search/query.py        | 124 +++++++++++++++-----------
 redis/commands/search/reducers.py     |  30 ++++---
 redis/commands/search/result.py       |   2 +-
 redis/commands/search/suggestion.py   |  10 ++-
 redis/connection.py                   |  62 ++++++-------
 tests/test_asyncio/test_cwe_404.py    |   4 -
 tests/test_asyncio/test_json.py       |   6 --
 tests/test_asyncio/test_lock.py       |   1 -
 tests/test_asyncio/test_pipeline.py   |   1 -
 tests/test_asyncio/test_pubsub.py     |   2 -
 tests/test_asyncio/test_search.py     |  51 +++++------
 tests/test_asyncio/test_sentinel.py   |   1 -
 tests/test_asyncio/test_timeseries.py |   1 -
 tests/test_commands.py                |   2 -
 tests/test_graph_utils/test_edge.py   |   1 -
 tests/test_json.py                    |   7 --
 tests/test_lock.py                    |   1 -
 tests/test_pipeline.py                |   1 -
 tests/test_pubsub.py                  |   2 -
 tests/test_search.py                  |   3 -
 tests/test_timeseries.py              |   1 -
 32 files changed, 289 insertions(+), 276 deletions(-)

diff --git a/redis/_parsers/base.py b/redis/_parsers/base.py
index 5de04c0f94..8e59249bef 100644
--- a/redis/_parsers/base.py
+++ b/redis/_parsers/base.py
@@ -46,7 +46,6 @@
 
 
 class BaseParser(ABC):
-
     EXCEPTION_CLASSES = {
         "ERR": {
             "max number of clients reached": ConnectionError,
diff --git a/redis/_parsers/resp3.py b/redis/_parsers/resp3.py
index 1275686710..ad766a8f95 100644
--- a/redis/_parsers/resp3.py
+++ b/redis/_parsers/resp3.py
@@ -243,10 +243,8 @@ async def _read_response(
             ]
             res = self.push_handler_func(response)
             if not push_request:
-                return await (
-                    self._read_response(
-                        disable_decoding=disable_decoding, push_request=push_request
-                    )
+                return await self._read_response(
+                    disable_decoding=disable_decoding, push_request=push_request
                 )
             else:
                 return res
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index f36b4bf79b..65fa58643b 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -1155,7 +1155,6 @@ def __init__(
         queue_class: Type[asyncio.Queue] = asyncio.LifoQueue,  # deprecated
         **connection_kwargs,
     ):
-
         super().__init__(
             connection_class=connection_class,
             max_connections=max_connections,
diff --git a/redis/client.py b/redis/client.py
index cf6dbf1eed..4923143543 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -4,8 +4,9 @@
 import time
 import warnings
 from itertools import chain
-from typing import Optional, Type
+from typing import Any, Callable, Dict, List, Optional, Type, Union
 
+from redis._parsers.encoders import Encoder
 from redis._parsers.helpers import (
     _RedisCallbacks,
     _RedisCallbacksRESP2,
@@ -49,7 +50,7 @@
 class CaseInsensitiveDict(dict):
     "Case insensitive dict implementation. Assumes string keys only."
 
-    def __init__(self, data):
+    def __init__(self, data: Dict[str, str]) -> None:
         for k, v in data.items():
             self[k.upper()] = v
 
@@ -93,7 +94,7 @@ class Redis(RedisModuleCommands, CoreCommands, SentinelCommands):
     """
 
     @classmethod
-    def from_url(cls, url, **kwargs):
+    def from_url(cls, url: str, **kwargs) -> None:
         """
         Return a Redis client object configured from the given URL
 
@@ -202,7 +203,7 @@ def __init__(
         redis_connect_func=None,
         credential_provider: Optional[CredentialProvider] = None,
         protocol: Optional[int] = 2,
-    ):
+    ) -> None:
         """
         Initialize a new Redis client.
         To specify a retry policy for specific errors, first set
@@ -309,14 +310,14 @@ def __init__(
         else:
             self.response_callbacks.update(_RedisCallbacksRESP2)
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return f"{type(self).__name__}<{repr(self.connection_pool)}>"
 
-    def get_encoder(self):
+    def get_encoder(self) -> "Encoder":
         """Get the connection pool's encoder"""
         return self.connection_pool.get_encoder()
 
-    def get_connection_kwargs(self):
+    def get_connection_kwargs(self) -> Dict:
         """Get the connection's key-word arguments"""
         return self.connection_pool.connection_kwargs
 
@@ -327,11 +328,11 @@ def set_retry(self, retry: "Retry") -> None:
         self.get_connection_kwargs().update({"retry": retry})
         self.connection_pool.set_retry(retry)
 
-    def set_response_callback(self, command, callback):
+    def set_response_callback(self, command: str, callback: Callable) -> None:
         """Set a custom Response Callback"""
         self.response_callbacks[command] = callback
 
-    def load_external_module(self, funcname, func):
+    def load_external_module(self, funcname, func) -> None:
         """
         This function can be used to add externally defined redis modules,
         and their namespaces to the redis client.
@@ -354,7 +355,7 @@ def load_external_module(self, funcname, func):
         """
         setattr(self, funcname, func)
 
-    def pipeline(self, transaction=True, shard_hint=None):
+    def pipeline(self, transaction=True, shard_hint=None) -> "Pipeline":
         """
         Return a new pipeline object that can queue multiple commands for
         later execution. ``transaction`` indicates whether all commands
@@ -366,7 +367,9 @@ def pipeline(self, transaction=True, shard_hint=None):
             self.connection_pool, self.response_callbacks, transaction, shard_hint
         )
 
-    def transaction(self, func, *watches, **kwargs):
+    def transaction(
+        self, func: Callable[["Pipeline"], None], *watches, **kwargs
+    ) -> None:
         """
         Convenience method for executing the callable `func` as a transaction
         while watching all keys specified in `watches`. The 'func' callable
@@ -390,13 +393,13 @@ def transaction(self, func, *watches, **kwargs):
 
     def lock(
         self,
-        name,
-        timeout=None,
-        sleep=0.1,
-        blocking=True,
-        blocking_timeout=None,
-        lock_class=None,
-        thread_local=True,
+        name: str,
+        timeout: Optional[float] = None,
+        sleep: float = 0.1,
+        blocking: bool = True,
+        blocking_timeout: Optional[float] = None,
+        lock_class: Union[None, Any] = None,
+        thread_local: bool = True,
     ):
         """
         Return a new Lock object using key ``name`` that mimics
@@ -648,9 +651,9 @@ def __init__(
         self,
         connection_pool,
         shard_hint=None,
-        ignore_subscribe_messages=False,
-        encoder=None,
-        push_handler_func=None,
+        ignore_subscribe_messages: bool = False,
+        encoder: Optional["Encoder"] = None,
+        push_handler_func: Union[None, Callable[[str], None]] = None,
     ):
         self.connection_pool = connection_pool
         self.shard_hint = shard_hint
@@ -672,13 +675,13 @@ def __init__(
             _set_info_logger()
         self.reset()
 
-    def __enter__(self):
+    def __enter__(self) -> "PubSub":
         return self
 
-    def __exit__(self, exc_type, exc_value, traceback):
+    def __exit__(self, exc_type, exc_value, traceback) -> None:
         self.reset()
 
-    def __del__(self):
+    def __del__(self) -> None:
         try:
             # if this object went out of scope prior to shutting down
             # subscriptions, close the connection manually before
@@ -687,7 +690,7 @@ def __del__(self):
         except Exception:
             pass
 
-    def reset(self):
+    def reset(self) -> None:
         if self.connection:
             self.connection.disconnect()
             self.connection._deregister_connect_callback(self.on_connect)
@@ -702,10 +705,10 @@ def reset(self):
         self.pending_unsubscribe_patterns = set()
         self.subscribed_event.clear()
 
-    def close(self):
+    def close(self) -> None:
         self.reset()
 
-    def on_connect(self, connection):
+    def on_connect(self, connection) -> None:
         "Re-subscribe to any channels and patterns previously subscribed to"
         # NOTE: for python3, we can't pass bytestrings as keyword arguments
         # so we need to decode channel/pattern names back to unicode strings
@@ -731,7 +734,7 @@ def on_connect(self, connection):
             self.ssubscribe(**shard_channels)
 
     @property
-    def subscribed(self):
+    def subscribed(self) -> bool:
         """Indicates if there are subscriptions to any channels or patterns"""
         return self.subscribed_event.is_set()
 
@@ -757,7 +760,7 @@ def execute_command(self, *args):
             self.clean_health_check_responses()
         self._execute(connection, connection.send_command, *args, **kwargs)
 
-    def clean_health_check_responses(self):
+    def clean_health_check_responses(self) -> None:
         """
         If any health check responses are present, clean them
         """
@@ -775,7 +778,7 @@ def clean_health_check_responses(self):
                     )
             ttl -= 1
 
-    def _disconnect_raise_connect(self, conn, error):
+    def _disconnect_raise_connect(self, conn, error) -> None:
         """
         Close the connection and raise an exception
         if retry_on_timeout is not set or the error
@@ -826,7 +829,7 @@ def try_read():
             return None
         return response
 
-    def is_health_check_response(self, response):
+    def is_health_check_response(self, response) -> bool:
         """
         Check if the response is a health check response.
         If there are no subscriptions redis responds to PING command with a
@@ -837,7 +840,7 @@ def is_health_check_response(self, response):
             self.health_check_response_b,  # If there wasn't
         ]
 
-    def check_health(self):
+    def check_health(self) -> None:
         conn = self.connection
         if conn is None:
             raise RuntimeError(
@@ -849,7 +852,7 @@ def check_health(self):
             conn.send_command("PING", self.HEALTH_CHECK_MESSAGE, check_health=False)
             self.health_check_response_counter += 1
 
-    def _normalize_keys(self, data):
+    def _normalize_keys(self, data) -> Dict:
         """
         normalize channel/pattern names to be either bytes or strings
         based on whether responses are automatically decoded. this saves us
@@ -983,7 +986,9 @@ def listen(self):
             if response is not None:
                 yield response
 
-    def get_message(self, ignore_subscribe_messages=False, timeout=0.0):
+    def get_message(
+        self, ignore_subscribe_messages: bool = False, timeout: float = 0.0
+    ):
         """
         Get the next message if one is available, otherwise None.
 
@@ -1012,7 +1017,7 @@ def get_message(self, ignore_subscribe_messages=False, timeout=0.0):
 
     get_sharded_message = get_message
 
-    def ping(self, message=None):
+    def ping(self, message: Union[str, None] = None) -> bool:
         """
         Ping the Redis server
         """
@@ -1093,7 +1098,12 @@ def handle_message(self, response, ignore_subscribe_messages=False):
 
         return message
 
-    def run_in_thread(self, sleep_time=0, daemon=False, exception_handler=None):
+    def run_in_thread(
+        self,
+        sleep_time: int = 0,
+        daemon: bool = False,
+        exception_handler: Optional[Callable] = None,
+    ) -> "PubSubWorkerThread":
         for channel, handler in self.channels.items():
             if handler is None:
                 raise PubSubError(f"Channel: '{channel}' has no handler registered")
@@ -1114,7 +1124,15 @@ def run_in_thread(self, sleep_time=0, daemon=False, exception_handler=None):
 
 
 class PubSubWorkerThread(threading.Thread):
-    def __init__(self, pubsub, sleep_time, daemon=False, exception_handler=None):
+    def __init__(
+        self,
+        pubsub,
+        sleep_time: float,
+        daemon: bool = False,
+        exception_handler: Union[
+            Callable[[Exception, "PubSub", "PubSubWorkerThread"], None], None
+        ] = None,
+    ):
         super().__init__()
         self.daemon = daemon
         self.pubsub = pubsub
@@ -1122,7 +1140,7 @@ def __init__(self, pubsub, sleep_time, daemon=False, exception_handler=None):
         self.exception_handler = exception_handler
         self._running = threading.Event()
 
-    def run(self):
+    def run(self) -> None:
         if self._running.is_set():
             return
         self._running.set()
@@ -1137,7 +1155,7 @@ def run(self):
                 self.exception_handler(e, pubsub, self)
         pubsub.close()
 
-    def stop(self):
+    def stop(self) -> None:
         # trip the flag so the run loop exits. the run loop will
         # close the pubsub connection, which disconnects the socket
         # and returns the connection to the pool.
@@ -1175,7 +1193,7 @@ def __init__(self, connection_pool, response_callbacks, transaction, shard_hint)
         self.watching = False
         self.reset()
 
-    def __enter__(self):
+    def __enter__(self) -> "Pipeline":
         return self
 
     def __exit__(self, exc_type, exc_value, traceback):
@@ -1187,14 +1205,14 @@ def __del__(self):
         except Exception:
             pass
 
-    def __len__(self):
+    def __len__(self) -> int:
         return len(self.command_stack)
 
-    def __bool__(self):
+    def __bool__(self) -> bool:
         """Pipeline instances should always evaluate to True"""
         return True
 
-    def reset(self):
+    def reset(self) -> None:
         self.command_stack = []
         self.scripts = set()
         # make sure to reset the connection state in the event that we were
@@ -1217,11 +1235,11 @@ def reset(self):
             self.connection_pool.release(self.connection)
             self.connection = None
 
-    def close(self):
+    def close(self) -> None:
         """Close the pipeline"""
         self.reset()
 
-    def multi(self):
+    def multi(self) -> None:
         """
         Start a transactional block of the pipeline after WATCH commands
         are issued. End the transactional block with `execute`.
@@ -1239,7 +1257,7 @@ def execute_command(self, *args, **kwargs):
             return self.immediate_execute_command(*args, **kwargs)
         return self.pipeline_execute_command(*args, **kwargs)
 
-    def _disconnect_reset_raise(self, conn, error):
+    def _disconnect_reset_raise(self, conn, error) -> None:
         """
         Close the connection, reset watching state and
         raise an exception if we were watching,
@@ -1282,7 +1300,7 @@ def immediate_execute_command(self, *args, **options):
             lambda error: self._disconnect_reset_raise(conn, error),
         )
 
-    def pipeline_execute_command(self, *args, **options):
+    def pipeline_execute_command(self, *args, **options) -> "Pipeline":
         """
         Stage a command to be executed when execute() is next called
 
@@ -1297,7 +1315,7 @@ def pipeline_execute_command(self, *args, **options):
         self.command_stack.append((args, options))
         return self
 
-    def _execute_transaction(self, connection, commands, raise_on_error):
+    def _execute_transaction(self, connection, commands, raise_on_error) -> List:
         cmds = chain([(("MULTI",), {})], commands, [(("EXEC",), {})])
         all_cmds = connection.pack_commands(
             [args for args, options in cmds if EMPTY_RESPONSE not in options]
@@ -1415,7 +1433,7 @@ def load_scripts(self):
                 if not exist:
                     s.sha = immediate("SCRIPT LOAD", s.script)
 
-    def _disconnect_raise_reset(self, conn, error):
+    def _disconnect_raise_reset(self, conn: Redis, error: Exception) -> None:
         """
         Close the connection, raise an exception if we were watching,
         and raise an exception if TimeoutError is not part of retry_on_error,
@@ -1477,6 +1495,6 @@ def watch(self, *names):
             raise RedisError("Cannot issue a WATCH after a MULTI")
         return self.execute_command("WATCH", *names)
 
-    def unwatch(self):
+    def unwatch(self) -> bool:
         """Unwatches all previously specified keys"""
         return self.watching and self.execute_command("UNWATCH") or True
diff --git a/redis/cluster.py b/redis/cluster.py
index ee3e1a865d..873d586c4a 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -2457,7 +2457,6 @@ def read(self):
         """ """
         connection = self.connection
         for c in self.commands:
-
             # if there is a result on this command,
             # it means we ran into an exception
             # like a connection error. Trying to parse
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 9d81e9772c..e73553e47e 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -403,7 +403,7 @@ class ManagementCommands(CommandsProtocol):
     Redis management commands
     """
 
-    def auth(self, password, username=None, **kwargs):
+    def auth(self, password: str, username: Optional[str] = None, **kwargs):
         """
         Authenticates the user. If you do not pass username, Redis will try to
         authenticate for the "default" user. If you do pass username, it will
diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index 3abe155796..0f92e0d6c9 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -80,7 +80,6 @@ def arrpop(
         path: Optional[str] = Path.root_path(),
         index: Optional[int] = -1,
     ) -> List[Union[str, None]]:
-
         """Pop the element at ``index`` in the array JSON value under
         ``path`` at key ``name``.
 
diff --git a/redis/commands/search/__init__.py b/redis/commands/search/__init__.py
index e635f91e99..a2bb23b76d 100644
--- a/redis/commands/search/__init__.py
+++ b/redis/commands/search/__init__.py
@@ -27,7 +27,6 @@ class BatchIndexer:
         """
 
         def __init__(self, client, chunk_size=1000):
-
             self.client = client
             self.execute_command = client.execute_command
             self._pipeline = client.pipeline(transaction=False, shard_hint=None)
diff --git a/redis/commands/search/aggregation.py b/redis/commands/search/aggregation.py
index 93a3d9273b..50d18f476a 100644
--- a/redis/commands/search/aggregation.py
+++ b/redis/commands/search/aggregation.py
@@ -1,8 +1,10 @@
+from typing import List, Union
+
 FIELDNAME = object()
 
 
 class Limit:
-    def __init__(self, offset=0, count=0):
+    def __init__(self, offset: int = 0, count: int = 0) -> None:
         self.offset = offset
         self.count = count
 
@@ -22,12 +24,12 @@ class Reducer:
 
     NAME = None
 
-    def __init__(self, *args):
+    def __init__(self, *args: List[str]) -> None:
         self._args = args
         self._field = None
         self._alias = None
 
-    def alias(self, alias):
+    def alias(self, alias: str) -> "Reducer":
         """
         Set the alias for this reducer.
 
@@ -51,7 +53,7 @@ def alias(self, alias):
         return self
 
     @property
-    def args(self):
+    def args(self) -> List[str]:
         return self._args
 
 
@@ -62,7 +64,7 @@ class SortDirection:
 
     DIRSTRING = None
 
-    def __init__(self, field):
+    def __init__(self, field: str) -> None:
         self.field = field
 
 
@@ -87,7 +89,7 @@ class AggregateRequest:
     Aggregation request which can be passed to `Client.aggregate`.
     """
 
-    def __init__(self, query="*"):
+    def __init__(self, query: str = "*") -> None:
         """
         Create an aggregation request. This request may then be passed to
         `client.aggregate()`.
@@ -110,7 +112,7 @@ def __init__(self, query="*"):
         self._cursor = []
         self._dialect = None
 
-    def load(self, *fields):
+    def load(self, *fields: List[str]) -> "AggregateRequest":
         """
         Indicate the fields to be returned in the response. These fields are
         returned in addition to any others implicitly specified.
@@ -126,7 +128,9 @@ def load(self, *fields):
             self._loadall = True
         return self
 
-    def group_by(self, fields, *reducers):
+    def group_by(
+        self, fields: List[str], *reducers: Union[Reducer, List[Reducer]]
+    ) -> "AggregateRequest":
         """
         Specify by which fields to group the aggregation.
 
@@ -151,7 +155,7 @@ def group_by(self, fields, *reducers):
         self._aggregateplan.extend(ret)
         return self
 
-    def apply(self, **kwexpr):
+    def apply(self, **kwexpr) -> "AggregateRequest":
         """
         Specify one or more projection expressions to add to each result
 
@@ -169,7 +173,7 @@ def apply(self, **kwexpr):
 
         return self
 
-    def limit(self, offset, num):
+    def limit(self, offset: int, num: int) -> "AggregateRequest":
         """
         Sets the limit for the most recent group or query.
 
@@ -215,7 +219,7 @@ def limit(self, offset, num):
         self._aggregateplan.extend(_limit.build_args())
         return self
 
-    def sort_by(self, *fields, **kwargs):
+    def sort_by(self, *fields: List[str], **kwargs) -> "AggregateRequest":
         """
         Indicate how the results should be sorted. This can also be used for
         *top-N* style queries
@@ -262,7 +266,7 @@ def sort_by(self, *fields, **kwargs):
         self._aggregateplan.extend(ret)
         return self
 
-    def filter(self, expressions):
+    def filter(self, expressions: Union[str, List[str]]) -> "AggregateRequest":
         """
         Specify filter for post-query results using predicates relating to
         values in the result set.
@@ -280,7 +284,7 @@ def filter(self, expressions):
 
         return self
 
-    def with_schema(self):
+    def with_schema(self) -> "AggregateRequest":
         """
         If set, the `schema` property will contain a list of `[field, type]`
         entries in the result object.
@@ -288,11 +292,11 @@ def with_schema(self):
         self._with_schema = True
         return self
 
-    def verbatim(self):
+    def verbatim(self) -> "AggregateRequest":
         self._verbatim = True
         return self
 
-    def cursor(self, count=0, max_idle=0.0):
+    def cursor(self, count: int = 0, max_idle: float = 0.0) -> "AggregateRequest":
         args = ["WITHCURSOR"]
         if count:
             args += ["COUNT", str(count)]
@@ -301,7 +305,7 @@ def cursor(self, count=0, max_idle=0.0):
         self._cursor = args
         return self
 
-    def build_args(self):
+    def build_args(self) -> List[str]:
         # @foo:bar ...
         ret = [self._query]
 
@@ -329,7 +333,7 @@ def build_args(self):
 
         return ret
 
-    def dialect(self, dialect):
+    def dialect(self, dialect: int) -> "AggregateRequest":
         """
         Add a dialect field to the aggregate command.
 
@@ -340,7 +344,7 @@ def dialect(self, dialect):
 
 
 class Cursor:
-    def __init__(self, cid):
+    def __init__(self, cid: int) -> None:
         self.cid = cid
         self.max_idle = 0
         self.count = 0
@@ -355,12 +359,12 @@ def build_args(self):
 
 
 class AggregateResult:
-    def __init__(self, rows, cursor, schema):
+    def __init__(self, rows, cursor: Cursor, schema) -> None:
         self.rows = rows
         self.cursor = cursor
         self.schema = schema
 
-    def __repr__(self):
+    def __repr__(self) -> (str, str):
         cid = self.cursor.cid if self.cursor else -1
         return (
             f"<{self.__class__.__name__} at 0x{id(self):x} "
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 83dea106d2..2df2b5a754 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -1,6 +1,6 @@
 import itertools
 import time
-from typing import Dict, Optional, Union
+from typing import Dict, List, Optional, Union
 
 from redis.client import Pipeline
 from redis.utils import deprecated_function
@@ -220,7 +220,7 @@ def create_index(
 
         return self.execute_command(*args)
 
-    def alter_schema_add(self, fields):
+    def alter_schema_add(self, fields: List[str]):
         """
         Alter the existing search index by adding new fields. The index
         must already exist.
@@ -240,7 +240,7 @@ def alter_schema_add(self, fields):
 
         return self.execute_command(*args)
 
-    def dropindex(self, delete_documents=False):
+    def dropindex(self, delete_documents: bool = False):
         """
         Drop the index if it exists.
         Replaced `drop_index` in RediSearch 2.0.
@@ -322,15 +322,15 @@ def _add_document_hash(
     )
     def add_document(
         self,
-        doc_id,
-        nosave=False,
-        score=1.0,
-        payload=None,
-        replace=False,
-        partial=False,
-        language=None,
-        no_create=False,
-        **fields,
+        doc_id: str,
+        nosave: bool = False,
+        score: float = 1.0,
+        payload: bool = None,
+        replace: bool = False,
+        partial: bool = False,
+        language: Optional[str] = None,
+        no_create: str = False,
+        **fields: List[str],
     ):
         """
         Add a single document to the index.
@@ -554,7 +554,9 @@ def aggregate(
             AGGREGATE_CMD, raw, query=query, has_cursor=has_cursor
         )
 
-    def _get_aggregate_result(self, raw, query, has_cursor):
+    def _get_aggregate_result(
+        self, raw: List, query: Union[str, Query, AggregateRequest], has_cursor: bool
+    ):
         if has_cursor:
             if isinstance(query, Cursor):
                 query.cid = raw[1]
@@ -642,7 +644,7 @@ def spellcheck(self, query, distance=None, include=None, exclude=None):
 
         return self._parse_results(SPELLCHECK_CMD, res)
 
-    def dict_add(self, name, *terms):
+    def dict_add(self, name: str, *terms: List[str]):
         """Adds terms to a dictionary.
 
         ### Parameters
@@ -656,7 +658,7 @@ def dict_add(self, name, *terms):
         cmd.extend(terms)
         return self.execute_command(*cmd)
 
-    def dict_del(self, name, *terms):
+    def dict_del(self, name: str, *terms: List[str]):
         """Deletes terms from a dictionary.
 
         ### Parameters
@@ -670,7 +672,7 @@ def dict_del(self, name, *terms):
         cmd.extend(terms)
         return self.execute_command(*cmd)
 
-    def dict_dump(self, name):
+    def dict_dump(self, name: str):
         """Dumps all terms in the given dictionary.
 
         ### Parameters
@@ -682,7 +684,7 @@ def dict_dump(self, name):
         cmd = [DICT_DUMP_CMD, name]
         return self.execute_command(*cmd)
 
-    def config_set(self, option, value):
+    def config_set(self, option: str, value: str) -> bool:
         """Set runtime configuration option.
 
         ### Parameters
@@ -696,7 +698,7 @@ def config_set(self, option, value):
         raw = self.execute_command(*cmd)
         return raw == "OK"
 
-    def config_get(self, option):
+    def config_get(self, option: str) -> str:
         """Get runtime configuration option value.
 
         ### Parameters
@@ -709,7 +711,7 @@ def config_get(self, option):
         res = self.execute_command(*cmd)
         return self._parse_results(CONFIG_CMD, res)
 
-    def tagvals(self, tagfield):
+    def tagvals(self, tagfield: str):
         """
         Return a list of all possible tag values
 
@@ -722,7 +724,7 @@ def tagvals(self, tagfield):
 
         return self.execute_command(TAGVALS_CMD, self.index_name, tagfield)
 
-    def aliasadd(self, alias):
+    def aliasadd(self, alias: str):
         """
         Alias a search index - will fail if alias already exists
 
@@ -735,7 +737,7 @@ def aliasadd(self, alias):
 
         return self.execute_command(ALIAS_ADD_CMD, alias, self.index_name)
 
-    def aliasupdate(self, alias):
+    def aliasupdate(self, alias: str):
         """
         Updates an alias - will fail if alias does not already exist
 
@@ -748,7 +750,7 @@ def aliasupdate(self, alias):
 
         return self.execute_command(ALIAS_UPDATE_CMD, alias, self.index_name)
 
-    def aliasdel(self, alias):
+    def aliasdel(self, alias: str):
         """
         Removes an alias to a search index
 
@@ -783,7 +785,7 @@ def sugadd(self, key, *suggestions, **kwargs):
 
         return pipe.execute()[-1]
 
-    def suglen(self, key):
+    def suglen(self, key: str) -> int:
         """
         Return the number of entries in the AutoCompleter index.
 
@@ -791,7 +793,7 @@ def suglen(self, key):
         """  # noqa
         return self.execute_command(SUGLEN_COMMAND, key)
 
-    def sugdel(self, key, string):
+    def sugdel(self, key: str, string: str) -> int:
         """
         Delete a string from the AutoCompleter index.
         Returns 1 if the string was found and deleted, 0 otherwise.
@@ -801,8 +803,14 @@ def sugdel(self, key, string):
         return self.execute_command(SUGDEL_COMMAND, key, string)
 
     def sugget(
-        self, key, prefix, fuzzy=False, num=10, with_scores=False, with_payloads=False
-    ):
+        self,
+        key: str,
+        prefix: str,
+        fuzzy: bool = False,
+        num: int = 10,
+        with_scores: bool = False,
+        with_payloads: bool = False,
+    ) -> List[SuggestionParser]:
         """
         Get a list of suggestions from the AutoCompleter, for a given prefix.
 
@@ -850,7 +858,7 @@ def sugget(
         parser = SuggestionParser(with_scores, with_payloads, res)
         return [s for s in parser]
 
-    def synupdate(self, groupid, skipinitial=False, *terms):
+    def synupdate(self, groupid: str, skipinitial: bool = False, *terms: List[str]):
         """
         Updates a synonym group.
         The command is used to create or update a synonym group with
@@ -986,7 +994,7 @@ async def spellcheck(self, query, distance=None, include=None, exclude=None):
 
         return self._parse_results(SPELLCHECK_CMD, res)
 
-    async def config_set(self, option, value):
+    async def config_set(self, option: str, value: str) -> bool:
         """Set runtime configuration option.
 
         ### Parameters
@@ -1000,7 +1008,7 @@ async def config_set(self, option, value):
         raw = await self.execute_command(*cmd)
         return raw == "OK"
 
-    async def config_get(self, option):
+    async def config_get(self, option: str) -> str:
         """Get runtime configuration option value.
 
         ### Parameters
@@ -1053,8 +1061,14 @@ async def sugadd(self, key, *suggestions, **kwargs):
         return (await pipe.execute())[-1]
 
     async def sugget(
-        self, key, prefix, fuzzy=False, num=10, with_scores=False, with_payloads=False
-    ):
+        self,
+        key: str,
+        prefix: str,
+        fuzzy: bool = False,
+        num: int = 10,
+        with_scores: bool = False,
+        with_payloads: bool = False,
+    ) -> List[SuggestionParser]:
         """
         Get a list of suggestions from the AutoCompleter, for a given prefix.
 
diff --git a/redis/commands/search/field.py b/redis/commands/search/field.py
index 6f31ce1fc2..76eb58c2d7 100644
--- a/redis/commands/search/field.py
+++ b/redis/commands/search/field.py
@@ -4,7 +4,6 @@
 
 
 class Field:
-
     NUMERIC = "NUMERIC"
     TEXT = "TEXT"
     WEIGHT = "WEIGHT"
diff --git a/redis/commands/search/query.py b/redis/commands/search/query.py
index 362dd6c72a..113ddf9da8 100644
--- a/redis/commands/search/query.py
+++ b/redis/commands/search/query.py
@@ -1,3 +1,6 @@
+from typing import List, Optional, Union
+
+
 class Query:
     """
     Query is used to build complex queries that have more parameters than just
@@ -8,52 +11,52 @@ class Query:
     i.e. `Query("foo").verbatim().filter(...)` etc.
     """
 
-    def __init__(self, query_string):
+    def __init__(self, query_string: str) -> None:
         """
         Create a new query object.
         The query string is set in the constructor, and other options have
         setter functions.
         """
 
-        self._query_string = query_string
-        self._offset = 0
-        self._num = 10
-        self._no_content = False
-        self._no_stopwords = False
-        self._fields = None
-        self._verbatim = False
-        self._with_payloads = False
-        self._with_scores = False
-        self._scorer = False
-        self._filters = list()
-        self._ids = None
-        self._slop = -1
-        self._timeout = None
-        self._in_order = False
-        self._sortby = None
-        self._return_fields = []
-        self._summarize_fields = []
-        self._highlight_fields = []
-        self._language = None
-        self._expander = None
-        self._dialect = None
-
-    def query_string(self):
+        self._query_string: str = query_string
+        self._offset: int = 0
+        self._num: int = 10
+        self._no_content: bool = False
+        self._no_stopwords: bool = False
+        self._fields: Optional[List[str]] = None
+        self._verbatim: bool = False
+        self._with_payloads: bool = False
+        self._with_scores: bool = False
+        self._scorer: Optional[str] = None
+        self._filters: List = list()
+        self._ids: Optional[List[str]] = None
+        self._slop: int = -1
+        self._timeout: Optional[float] = None
+        self._in_order: bool = False
+        self._sortby: Optional[SortbyField] = None
+        self._return_fields: List = []
+        self._summarize_fields: List = []
+        self._highlight_fields: List = []
+        self._language: Optional[str] = None
+        self._expander: Optional[str] = None
+        self._dialect: Optional[int] = None
+
+    def query_string(self) -> str:
         """Return the query string of this query only."""
         return self._query_string
 
-    def limit_ids(self, *ids):
+    def limit_ids(self, *ids) -> "Query":
         """Limit the results to a specific set of pre-known document
         ids of any length."""
         self._ids = ids
         return self
 
-    def return_fields(self, *fields):
+    def return_fields(self, *fields) -> "Query":
         """Add fields to return fields."""
         self._return_fields += fields
         return self
 
-    def return_field(self, field, as_field=None):
+    def return_field(self, field: str, as_field: Optional[str] = None) -> "Query":
         """Add field to return fields (Optional: add 'AS' name
         to the field)."""
         self._return_fields.append(field)
@@ -61,12 +64,18 @@ def return_field(self, field, as_field=None):
             self._return_fields += ("AS", as_field)
         return self
 
-    def _mk_field_list(self, fields):
+    def _mk_field_list(self, fields: List[str]) -> List:
         if not fields:
             return []
         return [fields] if isinstance(fields, str) else list(fields)
 
-    def summarize(self, fields=None, context_len=None, num_frags=None, sep=None):
+    def summarize(
+        self,
+        fields: Optional[List] = None,
+        context_len: Optional[int] = None,
+        num_frags: Optional[int] = None,
+        sep: Optional[str] = None,
+    ) -> "Query":
         """
         Return an abridged format of the field, containing only the segments of
         the field which contain the matching term(s).
@@ -98,7 +107,9 @@ def summarize(self, fields=None, context_len=None, num_frags=None, sep=None):
         self._summarize_fields = args
         return self
 
-    def highlight(self, fields=None, tags=None):
+    def highlight(
+        self, fields: Optional[List[str]] = None, tags: Optional[List[str]] = None
+    ) -> None:
         """
         Apply specified markup to matched term(s) within the returned field(s).
 
@@ -116,7 +127,7 @@ def highlight(self, fields=None, tags=None):
         self._highlight_fields = args
         return self
 
-    def language(self, language):
+    def language(self, language: str) -> "Query":
         """
         Analyze the query as being in the specified language.
 
@@ -125,19 +136,19 @@ def language(self, language):
         self._language = language
         return self
 
-    def slop(self, slop):
+    def slop(self, slop: int) -> "Query":
         """Allow a maximum of N intervening non matched terms between
         phrase terms (0 means exact phrase).
         """
         self._slop = slop
         return self
 
-    def timeout(self, timeout):
+    def timeout(self, timeout: float) -> "Query":
         """overrides the timeout parameter of the module"""
         self._timeout = timeout
         return self
 
-    def in_order(self):
+    def in_order(self) -> "Query":
         """
         Match only documents where the query terms appear in
         the same order in the document.
@@ -146,7 +157,7 @@ def in_order(self):
         self._in_order = True
         return self
 
-    def scorer(self, scorer):
+    def scorer(self, scorer: str) -> "Query":
         """
         Use a different scoring function to evaluate document relevance.
         Default is `TFIDF`.
@@ -157,7 +168,7 @@ def scorer(self, scorer):
         self._scorer = scorer
         return self
 
-    def get_args(self):
+    def get_args(self) -> List[str]:
         """Format the redis arguments for this query and return them."""
         args = [self._query_string]
         args += self._get_args_tags()
@@ -165,7 +176,7 @@ def get_args(self):
         args += ["LIMIT", self._offset, self._num]
         return args
 
-    def _get_args_tags(self):
+    def _get_args_tags(self) -> List[str]:
         args = []
         if self._no_content:
             args.append("NOCONTENT")
@@ -216,7 +227,7 @@ def _get_args_tags(self):
 
         return args
 
-    def paging(self, offset, num):
+    def paging(self, offset: int, num: int) -> "Query":
         """
         Set the paging for the query (defaults to 0..10).
 
@@ -227,19 +238,19 @@ def paging(self, offset, num):
         self._num = num
         return self
 
-    def verbatim(self):
+    def verbatim(self) -> "Query":
         """Set the query to be verbatim, i.e. use no query expansion
         or stemming.
         """
         self._verbatim = True
         return self
 
-    def no_content(self):
+    def no_content(self) -> "Query":
         """Set the query to only return ids and not the document content."""
         self._no_content = True
         return self
 
-    def no_stopwords(self):
+    def no_stopwords(self) -> "Query":
         """
         Prevent the query from being filtered for stopwords.
         Only useful in very big queries that you are certain contain
@@ -248,17 +259,17 @@ def no_stopwords(self):
         self._no_stopwords = True
         return self
 
-    def with_payloads(self):
+    def with_payloads(self) -> "Query":
         """Ask the engine to return document payloads."""
         self._with_payloads = True
         return self
 
-    def with_scores(self):
+    def with_scores(self) -> "Query":
         """Ask the engine to return document search scores."""
         self._with_scores = True
         return self
 
-    def limit_fields(self, *fields):
+    def limit_fields(self, *fields: List[str]) -> "Query":
         """
         Limit the search to specific TEXT fields only.
 
@@ -268,7 +279,7 @@ def limit_fields(self, *fields):
         self._fields = fields
         return self
 
-    def add_filter(self, flt):
+    def add_filter(self, flt: "Filter") -> "Query":
         """
         Add a numeric or geo filter to the query.
         **Currently only one of each filter is supported by the engine**
@@ -280,7 +291,7 @@ def add_filter(self, flt):
         self._filters.append(flt)
         return self
 
-    def sort_by(self, field, asc=True):
+    def sort_by(self, field: str, asc: bool = True) -> "Query":
         """
         Add a sortby field to the query.
 
@@ -290,7 +301,7 @@ def sort_by(self, field, asc=True):
         self._sortby = SortbyField(field, asc)
         return self
 
-    def expander(self, expander):
+    def expander(self, expander: str) -> "Query":
         """
         Add a expander field to the query.
 
@@ -310,7 +321,7 @@ def dialect(self, dialect: int) -> "Query":
 
 
 class Filter:
-    def __init__(self, keyword, field, *args):
+    def __init__(self, keyword: str, field: str, *args: List[str]) -> None:
         self.args = [keyword, field] + list(args)
 
 
@@ -318,7 +329,14 @@ class NumericFilter(Filter):
     INF = "+inf"
     NEG_INF = "-inf"
 
-    def __init__(self, field, minval, maxval, minExclusive=False, maxExclusive=False):
+    def __init__(
+        self,
+        field: str,
+        minval: Union[int, str],
+        maxval: Union[int, str],
+        minExclusive: bool = False,
+        maxExclusive: bool = False,
+    ) -> None:
         args = [
             minval if not minExclusive else f"({minval}",
             maxval if not maxExclusive else f"({maxval}",
@@ -333,10 +351,12 @@ class GeoFilter(Filter):
     FEET = "ft"
     MILES = "mi"
 
-    def __init__(self, field, lon, lat, radius, unit=KILOMETERS):
+    def __init__(
+        self, field: str, lon: float, lat: float, radius: float, unit: str = KILOMETERS
+    ) -> None:
         Filter.__init__(self, "GEOFILTER", field, lon, lat, radius, unit)
 
 
 class SortbyField:
-    def __init__(self, field, asc=True):
+    def __init__(self, field: str, asc=True) -> None:
         self.args = [field, "ASC" if asc else "DESC"]
diff --git a/redis/commands/search/reducers.py b/redis/commands/search/reducers.py
index 41ed11a238..8b60f23283 100644
--- a/redis/commands/search/reducers.py
+++ b/redis/commands/search/reducers.py
@@ -1,8 +1,12 @@
-from .aggregation import Reducer, SortDirection
+from typing import Union
+
+from .aggregation import Asc, Desc, Reducer, SortDirection
 
 
 class FieldOnlyReducer(Reducer):
-    def __init__(self, field):
+    """See https://redis.io/docs/interact/search-and-query/search/aggregations/"""
+
+    def __init__(self, field: str) -> None:
         super().__init__(field)
         self._field = field
 
@@ -14,7 +18,7 @@ class count(Reducer):
 
     NAME = "COUNT"
 
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__()
 
 
@@ -25,7 +29,7 @@ class sum(FieldOnlyReducer):
 
     NAME = "SUM"
 
-    def __init__(self, field):
+    def __init__(self, field: str) -> None:
         super().__init__(field)
 
 
@@ -36,7 +40,7 @@ class min(FieldOnlyReducer):
 
     NAME = "MIN"
 
-    def __init__(self, field):
+    def __init__(self, field: str) -> None:
         super().__init__(field)
 
 
@@ -47,7 +51,7 @@ class max(FieldOnlyReducer):
 
     NAME = "MAX"
 
-    def __init__(self, field):
+    def __init__(self, field: str) -> None:
         super().__init__(field)
 
 
@@ -58,7 +62,7 @@ class avg(FieldOnlyReducer):
 
     NAME = "AVG"
 
-    def __init__(self, field):
+    def __init__(self, field: str) -> None:
         super().__init__(field)
 
 
@@ -69,7 +73,7 @@ class tolist(FieldOnlyReducer):
 
     NAME = "TOLIST"
 
-    def __init__(self, field):
+    def __init__(self, field: str) -> None:
         super().__init__(field)
 
 
@@ -81,7 +85,7 @@ class count_distinct(FieldOnlyReducer):
 
     NAME = "COUNT_DISTINCT"
 
-    def __init__(self, field):
+    def __init__(self, field: str) -> None:
         super().__init__(field)
 
 
@@ -103,7 +107,7 @@ class quantile(Reducer):
 
     NAME = "QUANTILE"
 
-    def __init__(self, field, pct):
+    def __init__(self, field: str, pct: float) -> None:
         super().__init__(field, str(pct))
         self._field = field
 
@@ -115,7 +119,7 @@ class stddev(FieldOnlyReducer):
 
     NAME = "STDDEV"
 
-    def __init__(self, field):
+    def __init__(self, field: str) -> None:
         super().__init__(field)
 
 
@@ -126,7 +130,7 @@ class first_value(Reducer):
 
     NAME = "FIRST_VALUE"
 
-    def __init__(self, field, *byfields):
+    def __init__(self, field: str, *byfields: Union[Asc, Desc]) -> None:
         """
         Selects the first value of the given field within the group.
 
@@ -166,7 +170,7 @@ class random_sample(Reducer):
 
     NAME = "RANDOM_SAMPLE"
 
-    def __init__(self, field, size):
+    def __init__(self, field: str, size: int) -> None:
         """
         ### Parameter
 
diff --git a/redis/commands/search/result.py b/redis/commands/search/result.py
index 451bf89bb7..5b19e6faa4 100644
--- a/redis/commands/search/result.py
+++ b/redis/commands/search/result.py
@@ -69,5 +69,5 @@ def __init__(
             )
             self.docs.append(doc)
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return f"Result{{{self.total} total, docs: {self.docs}}}"
diff --git a/redis/commands/search/suggestion.py b/redis/commands/search/suggestion.py
index 5d1eba64b8..499c8d917e 100644
--- a/redis/commands/search/suggestion.py
+++ b/redis/commands/search/suggestion.py
@@ -1,3 +1,5 @@
+from typing import Optional
+
 from ._util import to_string
 
 
@@ -7,12 +9,14 @@ class Suggestion:
     autocomplete server
     """
 
-    def __init__(self, string, score=1.0, payload=None):
+    def __init__(
+        self, string: str, score: float = 1.0, payload: Optional[str] = None
+    ) -> None:
         self.string = to_string(string)
         self.payload = to_string(payload)
         self.score = score
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return self.string
 
 
@@ -23,7 +27,7 @@ class SuggestionParser:
     the return value depending on what objects were requested
     """
 
-    def __init__(self, with_scores, with_payloads, ret):
+    def __init__(self, with_scores: bool, with_payloads: bool, ret) -> None:
         self.with_scores = with_scores
         self.with_payloads = with_payloads
 
diff --git a/redis/connection.py b/redis/connection.py
index f5266d7dce..b39ba28f76 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -9,7 +9,7 @@
 from itertools import chain
 from queue import Empty, Full, LifoQueue
 from time import time
-from typing import Optional, Type, Union
+from typing import Any, Callable, List, Optional, Type, Union
 from urllib.parse import parse_qs, unquote, urlparse
 
 from ._parsers import Encoder, _HiredisParser, _RESP2Parser, _RESP3Parser
@@ -55,7 +55,7 @@
 
 
 class HiredisRespSerializer:
-    def pack(self, *args):
+    def pack(self, *args: List):
         """Pack a series of arguments into the Redis protocol"""
         output = []
 
@@ -128,27 +128,27 @@ class AbstractConnection:
 
     def __init__(
         self,
-        db=0,
-        password=None,
-        socket_timeout=None,
-        socket_connect_timeout=None,
-        retry_on_timeout=False,
+        db: int = 0,
+        password: Optional[str] = None,
+        socket_timeout: Optional[float] = None,
+        socket_connect_timeout: Optional[float] = None,
+        retry_on_timeout: bool = False,
         retry_on_error=SENTINEL,
-        encoding="utf-8",
-        encoding_errors="strict",
-        decode_responses=False,
+        encoding: str = "utf-8",
+        encoding_errors: str = "strict",
+        decode_responses: bool = False,
         parser_class=DefaultParser,
-        socket_read_size=65536,
-        health_check_interval=0,
-        client_name=None,
-        lib_name="redis-py",
-        lib_version=get_lib_version(),
-        username=None,
-        retry=None,
-        redis_connect_func=None,
+        socket_read_size: int = 65536,
+        health_check_interval: int = 0,
+        client_name: Optional[str] = None,
+        lib_name: Optional[str] = "redis-py",
+        lib_version: Optional[str] = get_lib_version(),
+        username: Optional[str] = None,
+        retry: Union[Any, None] = None,
+        redis_connect_func: Optional[Callable[[], None]] = None,
         credential_provider: Optional[CredentialProvider] = None,
         protocol: Optional[int] = 2,
-        command_packer=None,
+        command_packer: Optional[Callable[[], None]] = None,
     ):
         """
         Initialize a new Connection.
@@ -977,7 +977,10 @@ class initializer. In the case of conflicting arguments, querystring
         return cls(**kwargs)
 
     def __init__(
-        self, connection_class=Connection, max_connections=None, **connection_kwargs
+        self,
+        connection_class=Connection,
+        max_connections: Optional[int] = None,
+        **connection_kwargs,
     ):
         max_connections = max_connections or 2**31
         if not isinstance(max_connections, int) or max_connections < 0:
@@ -998,13 +1001,13 @@ def __init__(
         self._fork_lock = threading.Lock()
         self.reset()
 
-    def __repr__(self):
+    def __repr__(self) -> (str, str):
         return (
             f"{type(self).__name__}"
             f"<{repr(self.connection_class(**self.connection_kwargs))}>"
         )
 
-    def reset(self):
+    def reset(self) -> None:
         self._lock = threading.Lock()
         self._created_connections = 0
         self._available_connections = []
@@ -1021,7 +1024,7 @@ def reset(self):
         # reset() and they will immediately release _fork_lock and continue on.
         self.pid = os.getpid()
 
-    def _checkpid(self):
+    def _checkpid(self) -> None:
         # _checkpid() attempts to keep ConnectionPool fork-safe on modern
         # systems. this is called by all ConnectionPool methods that
         # manipulate the pool's state such as get_connection() and release().
@@ -1068,7 +1071,7 @@ def _checkpid(self):
             finally:
                 self._fork_lock.release()
 
-    def get_connection(self, command_name, *keys, **options):
+    def get_connection(self, command_name: str, *keys, **options) -> "Connection":
         "Get a connection from the pool"
         self._checkpid()
         with self._lock:
@@ -1101,7 +1104,7 @@ def get_connection(self, command_name, *keys, **options):
 
         return connection
 
-    def get_encoder(self):
+    def get_encoder(self) -> Encoder:
         "Return an encoder based on encoding settings"
         kwargs = self.connection_kwargs
         return Encoder(
@@ -1110,14 +1113,14 @@ def get_encoder(self):
             decode_responses=kwargs.get("decode_responses", False),
         )
 
-    def make_connection(self):
+    def make_connection(self) -> "Connection":
         "Create a new connection"
         if self._created_connections >= self.max_connections:
             raise ConnectionError("Too many connections")
         self._created_connections += 1
         return self.connection_class(**self.connection_kwargs)
 
-    def release(self, connection):
+    def release(self, connection: "Connection") -> None:
         "Releases the connection back to the pool"
         self._checkpid()
         with self._lock:
@@ -1138,10 +1141,10 @@ def release(self, connection):
                 connection.disconnect()
                 return
 
-    def owns_connection(self, connection):
+    def owns_connection(self, connection: "Connection") -> int:
         return connection.pid == self.pid
 
-    def disconnect(self, inuse_connections=True):
+    def disconnect(self, inuse_connections: bool = True) -> None:
         """
         Disconnects connections in the pool
 
@@ -1215,7 +1218,6 @@ def __init__(
         queue_class=LifoQueue,
         **connection_kwargs,
     ):
-
         self.queue_class = queue_class
         self.timeout = timeout
         super().__init__(
diff --git a/tests/test_asyncio/test_cwe_404.py b/tests/test_asyncio/test_cwe_404.py
index 76ec2bbd26..17ed6822ac 100644
--- a/tests/test_asyncio/test_cwe_404.py
+++ b/tests/test_asyncio/test_cwe_404.py
@@ -99,17 +99,14 @@ async def pipe(
 @pytest.mark.onlynoncluster
 @pytest.mark.parametrize("delay", argvalues=[0.05, 0.5, 1, 2])
 async def test_standalone(delay, master_host):
-
     # create a tcp socket proxy that relays data to Redis and back,
     # inserting 0.1 seconds of delay
     async with DelayProxy(addr=("127.0.0.1", 5380), redis_addr=master_host) as dp:
-
         for b in [True, False]:
             # note that we connect to proxy, rather than to Redis directly
             async with Redis(
                 host="127.0.0.1", port=5380, single_connection_client=b
             ) as r:
-
                 await r.set("foo", "foo")
                 await r.set("bar", "bar")
 
@@ -189,7 +186,6 @@ async def op(pipe):
 
 @pytest.mark.onlycluster
 async def test_cluster(master_host):
-
     delay = 0.1
     cluster_port = 16379
     remap_base = 7372
diff --git a/tests/test_asyncio/test_json.py b/tests/test_asyncio/test_json.py
index ed651cd903..a35bd4795f 100644
--- a/tests/test_asyncio/test_json.py
+++ b/tests/test_asyncio/test_json.py
@@ -490,7 +490,6 @@ async def test_json_mget_dollar(decoded_r: redis.Redis):
 
 @pytest.mark.redismod
 async def test_numby_commands_dollar(decoded_r: redis.Redis):
-
     # Test NUMINCRBY
     await decoded_r.json().set(
         "doc1", "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]}
@@ -546,7 +545,6 @@ async def test_numby_commands_dollar(decoded_r: redis.Redis):
 
 @pytest.mark.redismod
 async def test_strappend_dollar(decoded_r: redis.Redis):
-
     await decoded_r.json().set(
         "doc1", "$", {"a": "foo", "nested1": {"a": "hello"}, "nested2": {"a": 31}}
     )
@@ -578,7 +576,6 @@ async def test_strappend_dollar(decoded_r: redis.Redis):
 
 @pytest.mark.redismod
 async def test_strlen_dollar(decoded_r: redis.Redis):
-
     # Test multi
     await decoded_r.json().set(
         "doc1", "$", {"a": "foo", "nested1": {"a": "hello"}, "nested2": {"a": 31}}
@@ -713,7 +710,6 @@ async def test_arrinsert_dollar(decoded_r: redis.Redis):
 
 @pytest.mark.redismod
 async def test_arrlen_dollar(decoded_r: redis.Redis):
-
     await decoded_r.json().set(
         "doc1",
         "$",
@@ -802,7 +798,6 @@ async def test_arrpop_dollar(decoded_r: redis.Redis):
 
 @pytest.mark.redismod
 async def test_arrtrim_dollar(decoded_r: redis.Redis):
-
     await decoded_r.json().set(
         "doc1",
         "$",
@@ -960,7 +955,6 @@ async def test_type_dollar(decoded_r: redis.Redis):
 
 @pytest.mark.redismod
 async def test_clear_dollar(decoded_r: redis.Redis):
-
     await decoded_r.json().set(
         "doc1",
         "$",
diff --git a/tests/test_asyncio/test_lock.py b/tests/test_asyncio/test_lock.py
index 75484a2791..c052eae2a0 100644
--- a/tests/test_asyncio/test_lock.py
+++ b/tests/test_asyncio/test_lock.py
@@ -234,7 +234,6 @@ class TestLockClassSelection:
     def test_lock_class_argument(self, r):
         class MyLock:
             def __init__(self, *args, **kwargs):
-
                 pass
 
         lock = r.lock("foo", lock_class=MyLock)
diff --git a/tests/test_asyncio/test_pipeline.py b/tests/test_asyncio/test_pipeline.py
index 0fa1204750..3d271bf1d0 100644
--- a/tests/test_asyncio/test_pipeline.py
+++ b/tests/test_asyncio/test_pipeline.py
@@ -396,7 +396,6 @@ async def test_pipeline_get(self, r):
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.0.0")
     async def test_pipeline_discard(self, r):
-
         # empty pipeline should raise an error
         async with r.pipeline() as pipe:
             pipe.set("key", "someval")
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index 8fef34d83d..19d4b1c650 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -121,7 +121,6 @@ async def test_pattern_subscribe_unsubscribe(self, pubsub):
     async def _test_resubscribe_on_reconnection(
         self, p, sub_type, unsub_type, sub_func, unsub_func, keys
     ):
-
         for key in keys:
             assert await sub_func(key) is None
 
@@ -163,7 +162,6 @@ async def test_resubscribe_to_patterns_on_reconnection(self, pubsub):
     async def _test_subscribed_property(
         self, p, sub_type, unsub_type, sub_func, unsub_func, keys
     ):
-
         assert p.subscribed is False
         await sub_func(keys[0])
         # we're now subscribed even though we haven't processed the
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index e46de39c70..efc5bf549c 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -77,7 +77,6 @@ async def createIndex(decoded_r, num_docs=100, definition=None):
 
     r = csv.reader(bzfp, delimiter=";")
     for n, line in enumerate(r):
-
         play, chapter, _, text = line[1], line[2], line[4], line[5]
 
         key = f"{play}:{chapter}".lower()
@@ -163,10 +162,8 @@ async def test_client(decoded_r: redis.Redis):
             )
         ).total
         both_total = (
-            await (
-                decoded_r.ft().search(
-                    Query("henry").no_content().limit_fields("play", "txt")
-                )
+            await decoded_r.ft().search(
+                Query("henry").no_content().limit_fields("play", "txt")
             )
         ).total
         assert 129 == txt_total
@@ -370,18 +367,14 @@ async def test_stopwords(decoded_r: redis.Redis):
 
 @pytest.mark.redismod
 async def test_filters(decoded_r: redis.Redis):
-    await (
-        decoded_r.ft().create_index(
-            (TextField("txt"), NumericField("num"), GeoField("loc"))
-        )
+    await decoded_r.ft().create_index(
+        (TextField("txt"), NumericField("num"), GeoField("loc"))
     )
-    await (
-        decoded_r.hset(
-            "doc1", mapping={"txt": "foo bar", "num": 3.141, "loc": "-0.441,51.458"}
-        )
+    await decoded_r.hset(
+        "doc1", mapping={"txt": "foo bar", "num": 3.141, "loc": "-0.441,51.458"}
     )
-    await (
-        decoded_r.hset("doc2", mapping={"txt": "foo baz", "num": 2, "loc": "-0.1,51.2"})
+    await decoded_r.hset(
+        "doc2", mapping={"txt": "foo baz", "num": 2, "loc": "-0.1,51.2"}
     )
 
     await waitForIndex(decoded_r, "idx")
@@ -432,10 +425,8 @@ async def test_filters(decoded_r: redis.Redis):
 
 @pytest.mark.redismod
 async def test_sort_by(decoded_r: redis.Redis):
-    await (
-        decoded_r.ft().create_index(
-            (TextField("txt"), NumericField("num", sortable=True))
-        )
+    await decoded_r.ft().create_index(
+        (TextField("txt"), NumericField("num", sortable=True))
     )
     await decoded_r.hset("doc1", mapping={"txt": "foo bar", "num": 1})
     await decoded_r.hset("doc2", mapping={"txt": "foo baz", "num": 2})
@@ -488,8 +479,8 @@ async def test_drop_index(decoded_r: redis.Redis):
 @pytest.mark.redismod
 async def test_example(decoded_r: redis.Redis):
     # Creating the index definition and schema
-    await (
-        decoded_r.ft().create_index((TextField("title", weight=5.0), TextField("body")))
+    await decoded_r.ft().create_index(
+        (TextField("title", weight=5.0), TextField("body"))
     )
 
     # Indexing a document
@@ -550,8 +541,8 @@ async def test_auto_complete(decoded_r: redis.Redis):
     await decoded_r.ft().sugadd("ac", Suggestion("pay2", payload="pl2"))
     await decoded_r.ft().sugadd("ac", Suggestion("pay3", payload="pl3"))
 
-    sugs = await (
-        decoded_r.ft().sugget("ac", "pay", with_payloads=True, with_scores=True)
+    sugs = await decoded_r.ft().sugget(
+        "ac", "pay", with_payloads=True, with_scores=True
     )
     assert 3 == len(sugs)
     for sug in sugs:
@@ -639,8 +630,8 @@ async def test_no_index(decoded_r: redis.Redis):
 
 @pytest.mark.redismod
 async def test_explain(decoded_r: redis.Redis):
-    await (
-        decoded_r.ft().create_index((TextField("f1"), TextField("f2"), TextField("f3")))
+    await decoded_r.ft().create_index(
+        (TextField("f1"), TextField("f2"), TextField("f3"))
     )
     res = await decoded_r.ft().explain("@f3:f3_val @f2:f2_val @f1:f1_val")
     assert res
@@ -903,10 +894,8 @@ async def test_alter_schema_add(decoded_r: redis.Redis):
 async def test_spell_check(decoded_r: redis.Redis):
     await decoded_r.ft().create_index((TextField("f1"), TextField("f2")))
 
-    await (
-        decoded_r.hset(
-            "doc1", mapping={"f1": "some valid content", "f2": "this is sample text"}
-        )
+    await decoded_r.hset(
+        "doc1", mapping={"f1": "some valid content", "f2": "this is sample text"}
     )
     await decoded_r.hset("doc2", mapping={"f1": "very important", "f2": "lorem ipsum"})
     await waitForIndex(decoded_r, "idx")
@@ -1042,8 +1031,8 @@ async def test_scorer(decoded_r: redis.Redis):
         assert 1.0 == res.docs[0].score
         res = await decoded_r.ft().search(Query("quick").scorer("TFIDF").with_scores())
         assert 1.0 == res.docs[0].score
-        res = await (
-            decoded_r.ft().search(Query("quick").scorer("TFIDF.DOCNORM").with_scores())
+        res = await decoded_r.ft().search(
+            Query("quick").scorer("TFIDF.DOCNORM").with_scores()
         )
         assert 0.14285714285714285 == res.docs[0].score
         res = await decoded_r.ft().search(Query("quick").scorer("BM25").with_scores())
diff --git a/tests/test_asyncio/test_sentinel.py b/tests/test_asyncio/test_sentinel.py
index a2d52f17b7..25bd7730da 100644
--- a/tests/test_asyncio/test_sentinel.py
+++ b/tests/test_asyncio/test_sentinel.py
@@ -72,7 +72,6 @@ def client(self, host, port, **kwargs):
 
 @pytest_asyncio.fixture()
 async def cluster(master_ip):
-
     cluster = SentinelTestCluster(ip=master_ip)
     saved_Redis = redis.asyncio.sentinel.Redis
     redis.asyncio.sentinel.Redis = cluster.client
diff --git a/tests/test_asyncio/test_timeseries.py b/tests/test_asyncio/test_timeseries.py
index 48ffdfd889..91c15c3db2 100644
--- a/tests/test_asyncio/test_timeseries.py
+++ b/tests/test_asyncio/test_timeseries.py
@@ -108,7 +108,6 @@ async def test_add(decoded_r: redis.Redis):
 @pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
 async def test_add_duplicate_policy(r: redis.Redis):
-
     # Test for duplicate policy BLOCK
     assert 1 == await r.ts().add("time-serie-add-ooo-block", 1, 5.0)
     with pytest.raises(Exception):
diff --git a/tests/test_commands.py b/tests/test_commands.py
index b538dc3038..6660c2c6b0 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -516,7 +516,6 @@ def test_client_trackinginfo(self, r):
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise()
     def test_client_tracking(self, r, r2):
-
         # simple case
         assert r.client_tracking_on()
         assert r.client_tracking_off()
@@ -5011,7 +5010,6 @@ def test_module_loadex(self, r: redis.Redis):
 
     @skip_if_server_version_lt("2.6.0")
     def test_restore(self, r):
-
         # standard restore
         key = "foo"
         r.set(key, "bar")
diff --git a/tests/test_graph_utils/test_edge.py b/tests/test_graph_utils/test_edge.py
index 581ebfab5d..d2a1e3f39e 100644
--- a/tests/test_graph_utils/test_edge.py
+++ b/tests/test_graph_utils/test_edge.py
@@ -4,7 +4,6 @@
 
 @pytest.mark.redismod
 def test_init():
-
     with pytest.raises(AssertionError):
         edge.Edge(None, None, None)
         edge.Edge(node.Node(), None, None)
diff --git a/tests/test_json.py b/tests/test_json.py
index be347f6677..73d72b8cc9 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -464,7 +464,6 @@ def test_json_mget_dollar(client):
 
 
 def test_numby_commands_dollar(client):
-
     # Test NUMINCRBY
     client.json().set("doc1", "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]})
     # Test multi
@@ -508,7 +507,6 @@ def test_numby_commands_dollar(client):
 
 
 def test_strappend_dollar(client):
-
     client.json().set(
         "doc1", "$", {"a": "foo", "nested1": {"a": "hello"}, "nested2": {"a": 31}}
     )
@@ -539,7 +537,6 @@ def test_strappend_dollar(client):
 
 
 def test_strlen_dollar(client):
-
     # Test multi
     client.json().set(
         "doc1", "$", {"a": "foo", "nested1": {"a": "hello"}, "nested2": {"a": 31}}
@@ -672,7 +669,6 @@ def test_arrinsert_dollar(client):
 
 
 def test_arrlen_dollar(client):
-
     client.json().set(
         "doc1",
         "$",
@@ -762,7 +758,6 @@ def test_arrpop_dollar(client):
 
 
 def test_arrtrim_dollar(client):
-
     client.json().set(
         "doc1",
         "$",
@@ -1015,7 +1010,6 @@ def test_toggle_dollar(client):
 
 
 def test_resp_dollar(client):
-
     data = {
         "L1": {
             "a": {
@@ -1244,7 +1238,6 @@ def test_resp_dollar(client):
 
 
 def test_arrindex_dollar(client):
-
     client.json().set(
         "store",
         "$",
diff --git a/tests/test_lock.py b/tests/test_lock.py
index b34f7f0159..72af87fa81 100644
--- a/tests/test_lock.py
+++ b/tests/test_lock.py
@@ -247,7 +247,6 @@ class TestLockClassSelection:
     def test_lock_class_argument(self, r):
         class MyLock:
             def __init__(self, *args, **kwargs):
-
                 pass
 
         lock = r.lock("foo", lock_class=MyLock)
diff --git a/tests/test_pipeline.py b/tests/test_pipeline.py
index e64a763bae..7f10fcad4f 100644
--- a/tests/test_pipeline.py
+++ b/tests/test_pipeline.py
@@ -390,7 +390,6 @@ def test_pipeline_with_bitfield(self, r):
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.0.0")
     def test_pipeline_discard(self, r):
-
         # empty pipeline should raise an error
         with r.pipeline() as pipe:
             pipe.set("key", "someval")
diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index ba097e3194..fb46772af3 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -152,7 +152,6 @@ def test_shard_channel_subscribe_unsubscribe_cluster(self, r):
     def _test_resubscribe_on_reconnection(
         self, p, sub_type, unsub_type, sub_func, unsub_func, keys
     ):
-
         for key in keys:
             assert sub_func(key) is None
 
@@ -201,7 +200,6 @@ def test_resubscribe_to_shard_channels_on_reconnection(self, r):
     def _test_subscribed_property(
         self, p, sub_type, unsub_type, sub_func, unsub_func, keys
     ):
-
         assert p.subscribed is False
         sub_func(keys[0])
         # we're now subscribed even though we haven't processed the
diff --git a/tests/test_search.py b/tests/test_search.py
index 7612332470..9bbfc3c696 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -86,7 +86,6 @@ def createIndex(client, num_docs=100, definition=None):
 
     r = csv.reader(bzfp, delimiter=";")
     for n, line in enumerate(r):
-
         play, chapter, _, text = line[1], line[2], line[4], line[5]
 
         key = f"{play}:{chapter}".lower()
@@ -820,7 +819,6 @@ def test_spell_check(client):
     waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
     if is_resp2_connection(client):
-
         # test spellcheck
         res = client.ft().spellcheck("impornant")
         assert "important" == res["impornant"][0]["suggestion"]
@@ -2100,7 +2098,6 @@ def test_numeric_params(client):
 @pytest.mark.redismod
 @skip_ifmodversion_lt("2.4.3", "search")
 def test_geo_params(client):
-
     client.ft().create_index((GeoField("g")))
     client.hset("doc1", mapping={"g": "29.69465, 34.95126"})
     client.hset("doc2", mapping={"g": "29.69350, 34.94737"})
diff --git a/tests/test_timeseries.py b/tests/test_timeseries.py
index 4ab86cd56e..6b59967f3c 100644
--- a/tests/test_timeseries.py
+++ b/tests/test_timeseries.py
@@ -104,7 +104,6 @@ def test_add(client):
 
 @skip_ifmodversion_lt("1.4.0", "timeseries")
 def test_add_duplicate_policy(client):
-
     # Test for duplicate policy BLOCK
     assert 1 == client.ts().add("time-serie-add-ooo-block", 1, 5.0)
     with pytest.raises(Exception):

From cc4bc1a544d1030aec1696baef2861064fa8dd1c Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 21 Sep 2023 15:50:38 +0300
Subject: [PATCH 0791/1164] Version 5.0.1 (#2958)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 475e3565fa..f22d809d27 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="5.0.0",
+    version="5.0.1",
     packages=find_packages(
         include=[
             "redis",

From 24887dcb96212e8b54918e5de649f89d0ac54184 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 5 Oct 2023 09:41:05 +0300
Subject: [PATCH 0792/1164] Bump actions/checkout from 3 to 4 (#2969)

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/codeql-analysis.yml |  2 +-
 .github/workflows/docs.yaml           |  2 +-
 .github/workflows/integration.yaml    | 12 ++++++------
 .github/workflows/pypi-publish.yaml   |  2 +-
 .github/workflows/spellcheck.yml      |  2 +-
 5 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/.github/workflows/codeql-analysis.yml b/.github/workflows/codeql-analysis.yml
index e82e7e1530..61da2fce55 100644
--- a/.github/workflows/codeql-analysis.yml
+++ b/.github/workflows/codeql-analysis.yml
@@ -36,7 +36,7 @@ jobs:
 
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
 
     # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL
diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml
index 61ec76e9f8..56f16fa2b0 100644
--- a/.github/workflows/docs.yaml
+++ b/.github/workflows/docs.yaml
@@ -25,7 +25,7 @@ jobs:
      name: Build docs
      runs-on: ubuntu-latest
      steps:
-       - uses: actions/checkout@v3
+       - uses: actions/checkout@v4
        - uses: actions/setup-python@v4
          with:
            python-version: 3.9
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 7e0fea2e41..96b51fbafb 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -29,7 +29,7 @@ jobs:
      name: Dependency audit
      runs-on: ubuntu-latest
      steps:
-       - uses: actions/checkout@v3
+       - uses: actions/checkout@v4
        - uses: pypa/gh-action-pip-audit@v1.0.8
          with:
            inputs: requirements.txt dev_requirements.txt
@@ -40,7 +40,7 @@ jobs:
      name: Code linters
      runs-on: ubuntu-latest
      steps:
-       - uses: actions/checkout@v3
+       - uses: actions/checkout@v4
        - uses: actions/setup-python@v4
          with:
            python-version: 3.9
@@ -64,7 +64,7 @@ jobs:
        ACTIONS_ALLOW_UNSECURE_COMMANDS: true
      name: Python ${{ matrix.python-version }} ${{matrix.test-type}}-${{matrix.connection-type}} tests
      steps:
-       - uses: actions/checkout@v3
+       - uses: actions/checkout@v4
        - uses: actions/setup-python@v4
          with:
            python-version: ${{ matrix.python-version }}
@@ -119,7 +119,7 @@ jobs:
        ACTIONS_ALLOW_UNSECURE_COMMANDS: true
     name: RESP3 [${{ matrix.python-version }} ${{matrix.test-type}}-${{matrix.connection-type}}]
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - uses: actions/setup-python@v4
         with:
           python-version: ${{ matrix.python-version }}
@@ -146,7 +146,7 @@ jobs:
       matrix:
         extension: ['tar.gz', 'whl']
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - uses: actions/setup-python@v4
         with:
           python-version: 3.9
@@ -162,7 +162,7 @@ jobs:
       matrix:
         python-version: ['3.7', '3.8', '3.9', '3.10', '3.11', 'pypy-3.7', 'pypy-3.8', 'pypy-3.9']
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - uses: actions/setup-python@v4
         with:
           python-version: ${{ matrix.python-version }}
diff --git a/.github/workflows/pypi-publish.yaml b/.github/workflows/pypi-publish.yaml
index 50332c1995..4f8833372f 100644
--- a/.github/workflows/pypi-publish.yaml
+++ b/.github/workflows/pypi-publish.yaml
@@ -12,7 +12,7 @@ jobs:
   build_and_package:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: install python
         uses: actions/setup-python@v4
         with:
diff --git a/.github/workflows/spellcheck.yml b/.github/workflows/spellcheck.yml
index e152841553..3bd776cf1e 100644
--- a/.github/workflows/spellcheck.yml
+++ b/.github/workflows/spellcheck.yml
@@ -6,7 +6,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Check Spelling
         uses: rojopolis/spellcheck-github-actions@0.33.1
         with:

From 787d7314b2fbb6b5cb160afca5d7149b0e4ee507 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 5 Oct 2023 09:41:17 +0300
Subject: [PATCH 0793/1164] Bump rojopolis/spellcheck-github-actions from
 0.33.1 to 0.34.0 (#2970)

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/spellcheck.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/spellcheck.yml b/.github/workflows/spellcheck.yml
index 3bd776cf1e..46c629b2cc 100644
--- a/.github/workflows/spellcheck.yml
+++ b/.github/workflows/spellcheck.yml
@@ -8,7 +8,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
       - name: Check Spelling
-        uses: rojopolis/spellcheck-github-actions@0.33.1
+        uses: rojopolis/spellcheck-github-actions@0.34.0
         with:
           config_path: .github/spellcheck-settings.yml
           task_name: Markdown

From 054caf39eeab2fba305660299f2d85200eb81b98 Mon Sep 17 00:00:00 2001
From: Artem Diubkov <d184230@gmail.com>
Date: Tue, 10 Oct 2023 02:35:36 +0300
Subject: [PATCH 0794/1164] fix type hint (#2963)

Co-authored-by: d184230 <dubkov.a@skbkontur.ru>
---
 redis/client.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/client.py b/redis/client.py
index 4923143543..b526d7787b 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -94,7 +94,7 @@ class Redis(RedisModuleCommands, CoreCommands, SentinelCommands):
     """
 
     @classmethod
-    def from_url(cls, url: str, **kwargs) -> None:
+    def from_url(cls, url: str, **kwargs) -> "Redis":
         """
         Return a Redis client object configured from the given URL
 

From d1dbb153ebe90ce1908f88d87c1af047a0a00b4d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Wed, 11 Oct 2023 12:41:22 +0000
Subject: [PATCH 0795/1164] Don't perform blocking connect inside the
 BlockingConnectionQueue Condition variable. (#2997)

---
 redis/asyncio/connection.py | 34 +++++++++++++++++++++++-----------
 1 file changed, 23 insertions(+), 11 deletions(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 65fa58643b..1ef9960ff3 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -1027,7 +1027,18 @@ def can_get_connection(self) -> bool:
         )
 
     async def get_connection(self, command_name, *keys, **options):
-        """Get a connection from the pool"""
+        """Get a connected connection from the pool"""
+        connection = self.get_available_connection()
+        try:
+            await self.ensure_connection(connection)
+        except BaseException:
+            await self.release(connection)
+            raise
+
+        return connection
+
+    def get_available_connection(self):
+        """Get a connection from the pool, without making sure it is connected"""
         try:
             connection = self._available_connections.pop()
         except IndexError:
@@ -1035,13 +1046,6 @@ async def get_connection(self, command_name, *keys, **options):
                 raise ConnectionError("Too many connections") from None
             connection = self.make_connection()
         self._in_use_connections.add(connection)
-
-        try:
-            await self.ensure_connection(connection)
-        except BaseException:
-            await self.release(connection)
-            raise
-
         return connection
 
     def get_encoder(self):
@@ -1166,13 +1170,21 @@ def __init__(
     async def get_connection(self, command_name, *keys, **options):
         """Gets a connection from the pool, blocking until one is available"""
         try:
-            async with async_timeout(self.timeout):
-                async with self._condition:
+            async with self._condition:
+                async with async_timeout(self.timeout):
                     await self._condition.wait_for(self.can_get_connection)
-                    return await super().get_connection(command_name, *keys, **options)
+                    connection = super().get_available_connection()
         except asyncio.TimeoutError as err:
             raise ConnectionError("No connection available.") from err
 
+        # We now perform the connection check outside of the lock.
+        try:
+            await self.ensure_connection(connection)
+            return connection
+        except BaseException:
+            await self.release(connection)
+            raise
+
     async def release(self, connection: AbstractConnection):
         """Releases the connection back to the pool."""
         async with self._condition:

From 5391c5fc39a2c9aaa1b2e5acc799b93444270b88 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Wed, 11 Oct 2023 15:45:01 +0300
Subject: [PATCH 0796/1164] Creating CODEOWNERS for the examples (#2993)

---
 .github/CODEOWNERS | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 .github/CODEOWNERS

diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
new file mode 100644
index 0000000000..1af2323fe9
--- /dev/null
+++ b/.github/CODEOWNERS
@@ -0,0 +1 @@
+doctests/* @dmaier-redislabs

From df3b9e9826c151d1593262dc1133b91fca7f6218 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Mon, 16 Oct 2023 10:36:58 +0000
Subject: [PATCH 0797/1164] Close various objects created during asyncio tests
 (#3005)

* Close various objects created during asyncio tests

* Fix resource leake in test_cwe_404.py
Need to wait for individual handler tasks when shutting down server.
---
 tests/test_asyncio/test_commands.py           |  2 ++
 tests/test_asyncio/test_connect.py            |  2 ++
 tests/test_asyncio/test_connection.py         |  4 ++++
 tests/test_asyncio/test_cwe_404.py            | 15 +++++++++----
 tests/test_asyncio/test_retry.py              |  3 +++
 tests/test_asyncio/test_sentinel.py           | 22 +++++++++----------
 .../test_sentinel_managed_connection.py       |  1 +
 7 files changed, 34 insertions(+), 15 deletions(-)

diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 9b9852e9ef..35b9f2a29f 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -370,10 +370,12 @@ async def test_client_setinfo(self, r: redis.Redis):
         info = await r2.client_info()
         assert info["lib-name"] == "test2"
         assert info["lib-ver"] == "1234"
+        await r2.aclose()
         r3 = redis.asyncio.Redis(lib_name=None, lib_version=None)
         info = await r3.client_info()
         assert info["lib-name"] == ""
         assert info["lib-ver"] == ""
+        await r3.aclose()
 
     @skip_if_server_version_lt("2.6.9")
     @pytest.mark.onlynoncluster
diff --git a/tests/test_asyncio/test_connect.py b/tests/test_asyncio/test_connect.py
index 0b2d7c2afa..5e6b120fb3 100644
--- a/tests/test_asyncio/test_connect.py
+++ b/tests/test_asyncio/test_connect.py
@@ -73,6 +73,8 @@ async def _handler(reader, writer):
         try:
             return await _redis_request_handler(reader, writer, stop_event)
         finally:
+            writer.close()
+            await writer.wait_closed()
             finished.set()
 
     if isinstance(server_address, str):
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index 28e6b0d9c3..9c7f25bf87 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -85,6 +85,8 @@ async def get_conn(_):
 
     assert init_call_count == 1
     assert command_call_count == 2
+    r.connection = None  # it was a Mock
+    await r.aclose()
 
 
 @skip_if_server_version_lt("4.0.0")
@@ -143,6 +145,7 @@ async def mock_connect():
     conn._connect.side_effect = mock_connect
     await conn.connect()
     assert conn._connect.call_count == 3
+    await conn.disconnect()
 
 
 async def test_connect_without_retry_on_os_error():
@@ -194,6 +197,7 @@ async def test_connection_parse_response_resume(r: redis.Redis):
         pytest.fail("didn't receive a response")
     assert response
     assert i > 0
+    await conn.disconnect()
 
 
 @pytest.mark.onlynoncluster
diff --git a/tests/test_asyncio/test_cwe_404.py b/tests/test_asyncio/test_cwe_404.py
index 17ed6822ac..bb9f1780ac 100644
--- a/tests/test_asyncio/test_cwe_404.py
+++ b/tests/test_asyncio/test_cwe_404.py
@@ -15,6 +15,8 @@ def __init__(self, addr, redis_addr, delay: float = 0.0):
         self.send_event = asyncio.Event()
         self.server = None
         self.task = None
+        self.cond = asyncio.Condition()
+        self.running = 0
 
     async def __aenter__(self):
         await self.start()
@@ -63,10 +65,10 @@ async def stop(self):
         except asyncio.CancelledError:
             pass
         await self.server.wait_closed()
-        # do we need to close individual connections too?
-        # prudently close all async generators
-        loop = self.server.get_loop()
-        await loop.shutdown_asyncgens()
+        # Server does not wait for all spawned tasks.  We must do that also to ensure
+        # that all sockets are closed.
+        async with self.cond:
+            await self.cond.wait_for(lambda: self.running == 0)
 
     async def pipe(
         self,
@@ -75,6 +77,7 @@ async def pipe(
         name="",
         event: asyncio.Event = None,
     ):
+        self.running += 1
         try:
             while True:
                 data = await reader.read(1000)
@@ -94,6 +97,10 @@ async def pipe(
                 # ignore errors on close pertaining to no event loop. Don't want
                 # to clutter the test output with errors if being garbage collected
                 pass
+            async with self.cond:
+                self.running -= 1
+                if self.running == 0:
+                    self.cond.notify_all()
 
 
 @pytest.mark.onlynoncluster
diff --git a/tests/test_asyncio/test_retry.py b/tests/test_asyncio/test_retry.py
index 2912ca786c..8bc71c1479 100644
--- a/tests/test_asyncio/test_retry.py
+++ b/tests/test_asyncio/test_retry.py
@@ -131,5 +131,8 @@ async def test_get_set_retry_object(self, request):
         assert r.get_retry()._retries == new_retry_policy._retries
         assert isinstance(r.get_retry()._backoff, ExponentialBackoff)
         assert exiting_conn.retry._retries == new_retry_policy._retries
+        await r.connection_pool.release(exiting_conn)
         new_conn = await r.connection_pool.get_connection("_")
         assert new_conn.retry._retries == new_retry_policy._retries
+        await r.connection_pool.release(new_conn)
+        await r.aclose()
diff --git a/tests/test_asyncio/test_sentinel.py b/tests/test_asyncio/test_sentinel.py
index 25bd7730da..51e59d69d0 100644
--- a/tests/test_asyncio/test_sentinel.py
+++ b/tests/test_asyncio/test_sentinel.py
@@ -183,13 +183,13 @@ async def test_discover_slaves(cluster, sentinel):
 
 @pytest.mark.onlynoncluster
 async def test_master_for(cluster, sentinel, master_ip):
-    master = sentinel.master_for("mymaster", db=9)
-    assert await master.ping()
-    assert master.connection_pool.master_address == (master_ip, 6379)
+    async with sentinel.master_for("mymaster", db=9) as master:
+        assert await master.ping()
+        assert master.connection_pool.master_address == (master_ip, 6379)
 
     # Use internal connection check
-    master = sentinel.master_for("mymaster", db=9, check_connection=True)
-    assert await master.ping()
+    async with sentinel.master_for("mymaster", db=9, check_connection=True) as master:
+        assert await master.ping()
 
 
 @pytest.mark.onlynoncluster
@@ -197,16 +197,16 @@ async def test_slave_for(cluster, sentinel):
     cluster.slaves = [
         {"ip": "127.0.0.1", "port": 6379, "is_odown": False, "is_sdown": False}
     ]
-    slave = sentinel.slave_for("mymaster", db=9)
-    assert await slave.ping()
+    async with sentinel.slave_for("mymaster", db=9) as slave:
+        assert await slave.ping()
 
 
 @pytest.mark.onlynoncluster
 async def test_slave_for_slave_not_found_error(cluster, sentinel):
     cluster.master["is_odown"] = True
-    slave = sentinel.slave_for("mymaster", db=9)
-    with pytest.raises(SlaveNotFoundError):
-        await slave.ping()
+    async with sentinel.slave_for("mymaster", db=9) as slave:
+        with pytest.raises(SlaveNotFoundError):
+            await slave.ping()
 
 
 @pytest.mark.onlynoncluster
@@ -260,7 +260,7 @@ async def mock_disconnect():
         calls += 1
 
     with mock.patch.object(pool, "disconnect", mock_disconnect):
-        await client.close()
+        await client.aclose()
 
     assert calls == 1
     await pool.disconnect()
diff --git a/tests/test_asyncio/test_sentinel_managed_connection.py b/tests/test_asyncio/test_sentinel_managed_connection.py
index 711b3ee733..cae4b9581f 100644
--- a/tests/test_asyncio/test_sentinel_managed_connection.py
+++ b/tests/test_asyncio/test_sentinel_managed_connection.py
@@ -34,3 +34,4 @@ async def mock_connect():
     conn._connect.side_effect = mock_connect
     await conn.connect()
     assert conn._connect.call_count == 3
+    await conn.disconnect()

From 7867c6252c86398d442da455c3f57745d21ae0c4 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Mon, 16 Oct 2023 14:18:34 +0300
Subject: [PATCH 0798/1164] Linking to Redis resources (#3006)

---
 README.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/README.md b/README.md
index 4bd71b4060..2097e87bba 100644
--- a/README.md
+++ b/README.md
@@ -17,6 +17,20 @@ The Python interface to the Redis key-value store.
 
 ---------------------------------------------
 
+## How do I Redis?
+
+[Learn for free at Redis University](https://university.redis.com/)
+
+[Build faster with the Redis Launchpad](https://launchpad.redis.com/)
+
+[Try the Redis Cloud](https://redis.com/try-free/)
+
+[Dive in developer tutorials](https://developer.redis.com/)
+
+[Join the Redis community](https://redis.com/community/)
+
+[Work at Redis](https://redis.com/company/careers/jobs/)
+
 ## Installation
 
 Start a redis via docker:

From 05124de3dbc45eca8f6a29344f4de50f34ffb2e0 Mon Sep 17 00:00:00 2001
From: Shaya Potter <spotter@gmail.com>
Date: Mon, 16 Oct 2023 14:18:50 +0300
Subject: [PATCH 0799/1164] Add GEOSHAPE field type for index creation of
 RediSearch (#2957)

* first pass of geoshape index type

* first attempt at test, but demonstrates the initial commit is broken

* fix new field + fix tests

* work on linter

* more linter

* try to mark test with correct fixture

* fix linter
---
 redis/commands/search/field.py | 16 ++++++++++++++++
 tests/test_search.py           | 18 ++++++++++++++++++
 2 files changed, 34 insertions(+)

diff --git a/redis/commands/search/field.py b/redis/commands/search/field.py
index 76eb58c2d7..f316ed9f14 100644
--- a/redis/commands/search/field.py
+++ b/redis/commands/search/field.py
@@ -13,6 +13,7 @@ class Field:
     SORTABLE = "SORTABLE"
     NOINDEX = "NOINDEX"
     AS = "AS"
+    GEOSHAPE = "GEOSHAPE"
 
     def __init__(
         self,
@@ -91,6 +92,21 @@ def __init__(self, name: str, **kwargs):
         Field.__init__(self, name, args=[Field.NUMERIC], **kwargs)
 
 
+class GeoShapeField(Field):
+    """
+    GeoShapeField is used to enable within/contain indexing/searching
+    """
+
+    SPHERICAL = "SPHERICAL"
+    FLAT = "FLAT"
+
+    def __init__(self, name: str, coord_system=None, **kwargs):
+        args = [Field.GEOSHAPE]
+        if coord_system:
+            args.append(coord_system)
+        Field.__init__(self, name, args=args, **kwargs)
+
+
 class GeoField(Field):
     """
     GeoField is used to define a geo-indexing field in a schema definition
diff --git a/tests/test_search.py b/tests/test_search.py
index 9bbfc3c696..7469123453 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -13,6 +13,7 @@
 from redis.commands.search import Search
 from redis.commands.search.field import (
     GeoField,
+    GeoShapeField,
     NumericField,
     TagField,
     TextField,
@@ -2266,3 +2267,20 @@ def test_query_timeout(r: redis.Redis):
     q2 = Query("foo").timeout("not_a_number")
     with pytest.raises(redis.ResponseError):
         r.ft().search(q2)
+
+
+@pytest.mark.redismod
+def test_geoshape(client: redis.Redis):
+    client.ft().create_index((GeoShapeField("geom", GeoShapeField.FLAT)))
+    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
+    client.hset("small", "geom", "POLYGON((1 1, 1 100, 100 100, 100 1, 1 1))")
+    client.hset("large", "geom", "POLYGON((1 1, 1 200, 200 200, 200 1, 1 1))")
+    q1 = Query("@geom:[WITHIN $poly]").dialect(3)
+    qp1 = {"poly": "POLYGON((0 0, 0 150, 150 150, 150 0, 0 0))"}
+    q2 = Query("@geom:[CONTAINS $poly]").dialect(3)
+    qp2 = {"poly": "POLYGON((2 2, 2 50, 50 50, 50 2, 2 2))"}
+    result = client.ft().search(q1, query_params=qp1)
+    assert len(result.docs) == 1
+    assert result.docs[0]["id"] == "small"
+    result = client.ft().search(q2, query_params=qp2)
+    assert len(result.docs) == 2

From 14be2da44f5f8e768a1e2e1ae41d5733bcfc8df3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Mon, 16 Oct 2023 14:16:17 +0000
Subject: [PATCH 0800/1164] Better deal with "lost" connections for async Redis
 (#2999)

* Allow tracking/reporting and closing of "lost" connections.
ConnectionPool keeps a WeakSet of in_use connections, allowing lost ones to be collected.
Collection produces a warning and closes the underlying transport.

* Add tests for the __del__ handlers of async Redis and Connection objects

* capture expected warnings in the test

* lint
---
 redis/asyncio/client.py               |  1 +
 redis/asyncio/connection.py           | 21 ++++++++++-
 tests/test_asyncio/test_connection.py | 52 ++++++++++++++++++++++++++-
 3 files changed, 72 insertions(+), 2 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index e4d2e776bc..acc89941f2 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -546,6 +546,7 @@ def __del__(
                 _grl().call_exception_handler(context)
             except RuntimeError:
                 pass
+            self.connection._close()
 
     async def aclose(self, close_connection_pool: Optional[bool] = None) -> None:
         """
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 1ef9960ff3..7b0443454b 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -5,6 +5,7 @@
 import socket
 import ssl
 import sys
+import warnings
 import weakref
 from abc import abstractmethod
 from itertools import chain
@@ -204,6 +205,24 @@ def __init__(
                 raise ConnectionError("protocol must be either 2 or 3")
             self.protocol = protocol
 
+    def __del__(self, _warnings: Any = warnings):
+        # For some reason, the individual streams don't get properly garbage
+        # collected and therefore produce no resource warnings.  We add one
+        # here, in the same style as those from the stdlib.
+        if getattr(self, "_writer", None):
+            _warnings.warn(
+                f"unclosed Connection {self!r}", ResourceWarning, source=self
+            )
+            self._close()
+
+    def _close(self):
+        """
+        Internal method to silently close the connection without waiting
+        """
+        if self._writer:
+            self._writer.close()
+            self._writer = self._reader = None
+
     def __repr__(self):
         repr_args = ",".join((f"{k}={v}" for k, v in self.repr_pieces()))
         return f"{self.__class__.__name__}<{repr_args}>"
@@ -1017,7 +1036,7 @@ def __repr__(self):
 
     def reset(self):
         self._available_connections = []
-        self._in_use_connections = set()
+        self._in_use_connections = weakref.WeakSet()
 
     def can_get_connection(self) -> bool:
         """Return True if a connection can be retrieved from the pool."""
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index 9c7f25bf87..55a1c3a2f6 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -320,7 +320,8 @@ async def mock_aclose(self):
     url: str = request.config.getoption("--redis-url")
     r1 = await Redis.from_url(url)
     with patch.object(r1, "aclose", mock_aclose):
-        await r1.close()
+        with pytest.deprecated_call():
+            await r1.close()
         assert calls == 1
 
     with pytest.deprecated_call():
@@ -440,3 +441,52 @@ async def mock_disconnect(_):
 
     assert called == 0
     await pool.disconnect()
+
+
+async def test_client_garbage_collection(request):
+    """
+    Test that a Redis client will call _close() on any
+    connection that it holds at time of destruction
+    """
+
+    url: str = request.config.getoption("--redis-url")
+    pool = ConnectionPool.from_url(url)
+
+    # create a client with a connection from the pool
+    client = Redis(connection_pool=pool, single_connection_client=True)
+    await client.initialize()
+    with mock.patch.object(client, "connection") as a:
+        # we cannot, in unittests, or from asyncio, reliably trigger garbage collection
+        # so we must just invoke the handler
+        with pytest.warns(ResourceWarning):
+            client.__del__()
+            assert a._close.called
+
+    await client.aclose()
+    await pool.aclose()
+
+
+async def test_connection_garbage_collection(request):
+    """
+    Test that a Connection object will call close() on the
+    stream that it holds.
+    """
+
+    url: str = request.config.getoption("--redis-url")
+    pool = ConnectionPool.from_url(url)
+
+    # create a client with a connection from the pool
+    client = Redis(connection_pool=pool, single_connection_client=True)
+    await client.initialize()
+    conn = client.connection
+
+    with mock.patch.object(conn, "_reader"):
+        with mock.patch.object(conn, "_writer") as a:
+            # we cannot, in unittests, or from asyncio, reliably trigger
+            # garbage collection so we must just invoke the handler
+            with pytest.warns(ResourceWarning):
+                conn.__del__()
+                assert a.close.called
+
+    await client.aclose()
+    await pool.aclose()

From d3a3ada03e080f39144807c9fbe44876c40e0548 Mon Sep 17 00:00:00 2001
From: "Bosheng (Daniel) Zhang" <740807262@qq.com>
Date: Tue, 17 Oct 2023 00:16:37 +1000
Subject: [PATCH 0801/1164] Update client.py sleep_time typing for
 run_in_thread function (#2977)

Changed from
`sleep_time: int = 0`
to
`sleep_time: float = 0.0`
To avoid Pylance complaining:
`Argument of type "float" cannot be assigned to parameter "sleep_time" of type "int" in function "run_in_thread"
  "float" is incompatible with "int"`
---
 redis/client.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/client.py b/redis/client.py
index b526d7787b..cb91c7a088 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1100,7 +1100,7 @@ def handle_message(self, response, ignore_subscribe_messages=False):
 
     def run_in_thread(
         self,
-        sleep_time: int = 0,
+        sleep_time: float = 0.0,
         daemon: bool = False,
         exception_handler: Optional[Callable] = None,
     ) -> "PubSubWorkerThread":

From c2d5596e4b200b4da883315a23a976736d18835a Mon Sep 17 00:00:00 2001
From: Romain <r0ro@users.noreply.github.com>
Date: Mon, 13 Nov 2023 02:41:55 +0100
Subject: [PATCH 0802/1164] Fix BlockingConnectionPool.from_url parsing of
 timeout in query args #2983 (#2984)

Co-authored-by: Romain Fliedel <romain@oqee.tv>
---
 redis/asyncio/connection.py                |  1 +
 redis/connection.py                        |  1 +
 tests/test_asyncio/test_connection_pool.py | 25 ++++++++++++++++++++++
 tests/test_connection_pool.py              | 25 ++++++++++++++++++++++
 4 files changed, 52 insertions(+)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 7b0443454b..77312211a9 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -880,6 +880,7 @@ def to_bool(value) -> Optional[bool]:
         "max_connections": int,
         "health_check_interval": int,
         "ssl_check_hostname": to_bool,
+        "timeout": float,
     }
 )
 
diff --git a/redis/connection.py b/redis/connection.py
index b39ba28f76..fead6135e0 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -853,6 +853,7 @@ def to_bool(value):
     "max_connections": int,
     "health_check_interval": int,
     "ssl_check_hostname": to_bool,
+    "timeout": float,
 }
 
 
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
index c93fa91a39..ed90fc73fc 100644
--- a/tests/test_asyncio/test_connection_pool.py
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -454,6 +454,31 @@ def test_invalid_scheme_raises_error(self):
         )
 
 
+class TestBlockingConnectionPoolURLParsing:
+    def test_extra_typed_querystring_options(self):
+        pool = redis.BlockingConnectionPool.from_url(
+            "redis://localhost/2?socket_timeout=20&socket_connect_timeout=10"
+            "&socket_keepalive=&retry_on_timeout=Yes&max_connections=10&timeout=13.37"
+        )
+
+        assert pool.connection_class == redis.Connection
+        assert pool.connection_kwargs == {
+            "host": "localhost",
+            "db": 2,
+            "socket_timeout": 20.0,
+            "socket_connect_timeout": 10.0,
+            "retry_on_timeout": True,
+        }
+        assert pool.max_connections == 10
+        assert pool.timeout == 13.37
+
+    def test_invalid_extra_typed_querystring_options(self):
+        with pytest.raises(ValueError):
+            redis.BlockingConnectionPool.from_url(
+                "redis://localhost/2?timeout=_not_a_float_"
+            )
+
+
 class TestConnectionPoolUnixSocketURLParsing:
     def test_defaults(self):
         pool = redis.ConnectionPool.from_url("unix:///socket")
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index ef70a8ff35..d1e984ee9c 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -359,6 +359,31 @@ def test_invalid_scheme_raises_error_when_double_slash_missing(self):
         )
 
 
+class TestBlockingConnectionPoolURLParsing:
+    def test_extra_typed_querystring_options(self):
+        pool = redis.BlockingConnectionPool.from_url(
+            "redis://localhost/2?socket_timeout=20&socket_connect_timeout=10"
+            "&socket_keepalive=&retry_on_timeout=Yes&max_connections=10&timeout=42"
+        )
+
+        assert pool.connection_class == redis.Connection
+        assert pool.connection_kwargs == {
+            "host": "localhost",
+            "db": 2,
+            "socket_timeout": 20.0,
+            "socket_connect_timeout": 10.0,
+            "retry_on_timeout": True,
+        }
+        assert pool.max_connections == 10
+        assert pool.timeout == 42.0
+
+    def test_invalid_extra_typed_querystring_options(self):
+        with pytest.raises(ValueError):
+            redis.BlockingConnectionPool.from_url(
+                "redis://localhost/2?timeout=_not_a_float_"
+            )
+
+
 class TestConnectionPoolUnixSocketURLParsing:
     def test_defaults(self):
         pool = redis.ConnectionPool.from_url("unix:///socket")

From 0113034634c7b4968cfc34b42980f3ad86eb1fc6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Mon, 13 Nov 2023 01:43:57 +0000
Subject: [PATCH 0803/1164] Fix parsing resp3 dicts (#2982)

---
 redis/_parsers/resp3.py | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/redis/_parsers/resp3.py b/redis/_parsers/resp3.py
index ad766a8f95..569e7ee679 100644
--- a/redis/_parsers/resp3.py
+++ b/redis/_parsers/resp3.py
@@ -96,8 +96,9 @@ def _read_response(self, disable_decoding=False, push_request=False):
                 pass
         # map response
         elif byte == b"%":
-            # we use this approach and not dict comprehension here
-            # because this dict comprehension fails in python 3.7
+            # We cannot use a dict-comprehension to parse stream.
+            # Evaluation order of key:val expression in dict comprehension only
+            # became defined to be left-right in version 3.8
             resp_dict = {}
             for _ in range(int(response)):
                 key = self._read_response(disable_decoding=disable_decoding)
@@ -225,12 +226,16 @@ async def _read_response(
                 pass
         # map response
         elif byte == b"%":
-            response = {
-                (await self._read_response(disable_decoding=disable_decoding)): (
-                    await self._read_response(disable_decoding=disable_decoding)
+            # We cannot use a dict-comprehension to parse stream.
+            # Evaluation order of key:val expression in dict comprehension only
+            # became defined to be left-right in version 3.8
+            resp_dict = {}
+            for _ in range(int(response)):
+                key = await self._read_response(disable_decoding=disable_decoding)
+                resp_dict[key] = await self._read_response(
+                    disable_decoding=disable_decoding, push_request=push_request
                 )
-                for _ in range(int(response))
-            }
+            response = resp_dict
         # push response
         elif byte == b">":
             response = [

From 69782750343496b7b88bf82c006f4205afd7aabd Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 16 Nov 2023 12:26:32 +0200
Subject: [PATCH 0804/1164] Client Side Caching: Alpha support (#3038)

* CSC

* get keys from command

* fix review comments

* return respone in execute_command

* fix tests

* fix comments

* linters

---------

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/__init__.py                     |   2 +
 redis/asyncio/client.py               |   2 +
 redis/asyncio/cluster.py              |   2 +
 redis/asyncio/sentinel.py             |   1 +
 redis/cache.py                        | 326 ++++++++++++++++++++++++++
 redis/client.py                       |  88 ++++++-
 redis/cluster.py                      |   2 +
 redis/commands/cluster.py             |   2 +-
 redis/commands/core.py                | 119 +++++-----
 redis/commands/json/commands.py       |  18 +-
 redis/commands/timeseries/commands.py |   8 +-
 redis/commands/timeseries/utils.py    |   2 +-
 redis/sentinel.py                     |   1 +
 redis/typing.py                       |   1 +
 14 files changed, 492 insertions(+), 82 deletions(-)
 create mode 100644 redis/cache.py

diff --git a/redis/__init__.py b/redis/__init__.py
index 495d2d99bb..7bf6839453 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -2,6 +2,7 @@
 
 from redis import asyncio  # noqa
 from redis.backoff import default_backoff
+from redis.cache import _LocalChace
 from redis.client import Redis, StrictRedis
 from redis.cluster import RedisCluster
 from redis.connection import (
@@ -61,6 +62,7 @@ def int_or_str(value):
     VERSION = tuple([99, 99, 99])
 
 __all__ = [
+    "_LocalChace",
     "AuthenticationError",
     "AuthenticationWrongNumberOfArgsError",
     "BlockingConnectionPool",
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index acc89941f2..8a8f54dc9c 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -597,6 +597,7 @@ async def _disconnect_raise(self, conn: Connection, error: Exception):
     async def execute_command(self, *args, **options):
         """Execute a command and return a parsed response"""
         await self.initialize()
+        options.pop("keys", None)  # the keys are used only for client side caching
         pool = self.connection_pool
         command_name = args[0]
         conn = self.connection or await pool.get_connection(command_name, **options)
@@ -1275,6 +1276,7 @@ def multi(self):
     def execute_command(
         self, *args, **kwargs
     ) -> Union["Pipeline", Awaitable["Pipeline"]]:
+        kwargs.pop("keys", None)  # the keys are used only for client side caching
         if (self.watching or args[0] == "WATCH") and not self.explicit_transaction:
             return self.immediate_execute_command(*args, **kwargs)
         return self.pipeline_execute_command(*args, **kwargs)
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 636144a9c7..ebc7e4a4cb 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -682,6 +682,7 @@ async def execute_command(self, *args: EncodableT, **kwargs: Any) -> Any:
         :raises RedisClusterException: if target_nodes is not provided & the command
             can't be mapped to a slot
         """
+        kwargs.pop("keys", None)  # the keys are used only for client side caching
         command = args[0]
         target_nodes = []
         target_nodes_specified = False
@@ -1447,6 +1448,7 @@ def execute_command(
               or List[:class:`~.ClusterNode`] or Dict[Any, :class:`~.ClusterNode`]
             - Rest of the kwargs are passed to the Redis connection
         """
+        kwargs.pop("keys", None)  # the keys are used only for client side caching
         self._command_stack.append(
             PipelineCommand(len(self._command_stack), *args, **kwargs)
         )
diff --git a/redis/asyncio/sentinel.py b/redis/asyncio/sentinel.py
index 6834fb194f..56f5e9d651 100644
--- a/redis/asyncio/sentinel.py
+++ b/redis/asyncio/sentinel.py
@@ -220,6 +220,7 @@ async def execute_command(self, *args, **kwargs):
         once - If set to True, then execute the resulting command on a single
                node at random, rather than across the entire sentinel cluster.
         """
+        kwargs.pop("keys", None)  # the keys are used only for client side caching
         once = bool(kwargs.get("once", False))
         if "once" in kwargs.keys():
             kwargs.pop("once")
diff --git a/redis/cache.py b/redis/cache.py
new file mode 100644
index 0000000000..5a689d0ebd
--- /dev/null
+++ b/redis/cache.py
@@ -0,0 +1,326 @@
+import random
+import time
+from collections import OrderedDict, defaultdict
+from enum import Enum
+from typing import List
+
+from redis.typing import KeyT, ResponseT
+
+DEFAULT_EVICTION_POLICY = "lru"
+
+
+DEFAULT_BLACKLIST = [
+    "BF.CARD",
+    "BF.DEBUG",
+    "BF.EXISTS",
+    "BF.INFO",
+    "BF.MEXISTS",
+    "BF.SCANDUMP",
+    "CF.COMPACT",
+    "CF.COUNT",
+    "CF.DEBUG",
+    "CF.EXISTS",
+    "CF.INFO",
+    "CF.MEXISTS",
+    "CF.SCANDUMP",
+    "CMS.INFO",
+    "CMS.QUERY",
+    "DUMP",
+    "EXPIRETIME",
+    "FT.AGGREGATE",
+    "FT.ALIASADD",
+    "FT.ALIASDEL",
+    "FT.ALIASUPDATE",
+    "FT.CURSOR",
+    "FT.EXPLAIN",
+    "FT.EXPLAINCLI",
+    "FT.GET",
+    "FT.INFO",
+    "FT.MGET",
+    "FT.PROFILE",
+    "FT.SEARCH",
+    "FT.SPELLCHECK",
+    "FT.SUGGET",
+    "FT.SUGLEN",
+    "FT.SYNDUMP",
+    "FT.TAGVALS",
+    "FT._ALIASADDIFNX",
+    "FT._ALIASDELIFX",
+    "HRANDFIELD",
+    "JSON.DEBUG",
+    "PEXPIRETIME",
+    "PFCOUNT",
+    "PTTL",
+    "SRANDMEMBER",
+    "TDIGEST.BYRANK",
+    "TDIGEST.BYREVRANK",
+    "TDIGEST.CDF",
+    "TDIGEST.INFO",
+    "TDIGEST.MAX",
+    "TDIGEST.MIN",
+    "TDIGEST.QUANTILE",
+    "TDIGEST.RANK",
+    "TDIGEST.REVRANK",
+    "TDIGEST.TRIMMED_MEAN",
+    "TOPK.INFO",
+    "TOPK.LIST",
+    "TOPK.QUERY",
+    "TOUCH",
+    "TTL",
+]
+
+
+DEFAULT_WHITELIST = [
+    "BITCOUNT",
+    "BITFIELD_RO",
+    "BITPOS",
+    "EXISTS",
+    "GEODIST",
+    "GEOHASH",
+    "GEOPOS",
+    "GEORADIUSBYMEMBER_RO",
+    "GEORADIUS_RO",
+    "GEOSEARCH",
+    "GET",
+    "GETBIT",
+    "GETRANGE",
+    "HEXISTS",
+    "HGET",
+    "HGETALL",
+    "HKEYS",
+    "HLEN",
+    "HMGET",
+    "HSTRLEN",
+    "HVALS",
+    "JSON.ARRINDEX",
+    "JSON.ARRLEN",
+    "JSON.GET",
+    "JSON.MGET",
+    "JSON.OBJKEYS",
+    "JSON.OBJLEN",
+    "JSON.RESP",
+    "JSON.STRLEN",
+    "JSON.TYPE",
+    "LCS",
+    "LINDEX",
+    "LLEN",
+    "LPOS",
+    "LRANGE",
+    "MGET",
+    "SCARD",
+    "SDIFF",
+    "SINTER",
+    "SINTERCARD",
+    "SISMEMBER",
+    "SMEMBERS",
+    "SMISMEMBER",
+    "SORT_RO",
+    "STRLEN",
+    "SUBSTR",
+    "SUNION",
+    "TS.GET",
+    "TS.INFO",
+    "TS.RANGE",
+    "TS.REVRANGE",
+    "TYPE",
+    "XLEN",
+    "XPENDING",
+    "XRANGE",
+    "XREAD",
+    "XREVRANGE",
+    "ZCARD",
+    "ZCOUNT",
+    "ZDIFF",
+    "ZINTER",
+    "ZINTERCARD",
+    "ZLEXCOUNT",
+    "ZMSCORE",
+    "ZRANGE",
+    "ZRANGEBYLEX",
+    "ZRANGEBYSCORE",
+    "ZRANK",
+    "ZREVRANGE",
+    "ZREVRANGEBYLEX",
+    "ZREVRANGEBYSCORE",
+    "ZREVRANK",
+    "ZSCORE",
+    "ZUNION",
+]
+
+_RESPONSE = "response"
+_KEYS = "keys"
+_CTIME = "ctime"
+_ACCESS_COUNT = "access_count"
+
+
+class EvictionPolicy(Enum):
+    LRU = "lru"
+    LFU = "lfu"
+    RANDOM = "random"
+
+
+class _LocalChace:
+    """
+    A caching mechanism for storing redis commands and their responses.
+
+    Args:
+        max_size (int): The maximum number of commands to be stored in the cache.
+        ttl (int): The time-to-live for each command in seconds.
+        eviction_policy (EvictionPolicy): The eviction policy to use for removing commands when the cache is full.
+
+    Attributes:
+        max_size (int): The maximum number of commands to be stored in the cache.
+        ttl (int): The time-to-live for each command in seconds.
+        eviction_policy (EvictionPolicy): The eviction policy used for cache management.
+        cache (OrderedDict): The ordered dictionary to store commands and their metadata.
+        key_commands_map (defaultdict): A mapping of keys to the set of commands that use each key.
+        commands_ttl_list (list): A list to keep track of the commands in the order they were added.  # noqa
+    """
+
+    def __init__(
+        self, max_size: int, ttl: int, eviction_policy: EvictionPolicy, **kwargs
+    ):
+        self.max_size = max_size
+        self.ttl = ttl
+        self.eviction_policy = eviction_policy
+        self.cache = OrderedDict()
+        self.key_commands_map = defaultdict(set)
+        self.commands_ttl_list = []
+
+    def set(self, command: str, response: ResponseT, keys_in_command: List[KeyT]):
+        """
+        Set a redis command and its response in the cache.
+
+        Args:
+            command (str): The redis command.
+            response (ResponseT): The response associated with the command.
+            keys_in_command (List[KeyT]): The list of keys used in the command.
+        """
+        if len(self.cache) >= self.max_size:
+            self._evict()
+        self.cache[command] = {
+            _RESPONSE: response,
+            _KEYS: keys_in_command,
+            _CTIME: time.monotonic(),
+            _ACCESS_COUNT: 0,  # Used only for LFU
+        }
+        self._update_key_commands_map(keys_in_command, command)
+        self.commands_ttl_list.append(command)
+
+    def get(self, command: str) -> ResponseT:
+        """
+        Get the response for a redis command from the cache.
+
+        Args:
+            command (str): The redis command.
+
+        Returns:
+            ResponseT: The response associated with the command, or None if the command is not in the cache.  # noqa
+        """
+        if command in self.cache:
+            if self._is_expired(command):
+                self.delete(command)
+            self._update_access(command)
+            return self.cache[command]["response"]
+
+    def delete(self, command: str):
+        """
+        Delete a redis command and its metadata from the cache.
+
+        Args:
+            command (str): The redis command to be deleted.
+        """
+        if command in self.cache:
+            keys_in_command = self.cache[command].get("keys")
+            self._del_key_commands_map(keys_in_command, command)
+            self.commands_ttl_list.remove(command)
+            del self.cache[command]
+
+    def delete_many(self, commands):
+        pass
+
+    def flush(self):
+        """Clear the entire cache, removing all redis commands and metadata."""
+        self.cache.clear()
+        self.key_commands_map.clear()
+        self.commands_ttl_list = []
+
+    def _is_expired(self, command: str) -> bool:
+        """
+        Check if a redis command has expired based on its time-to-live.
+
+        Args:
+            command (str): The redis command.
+
+        Returns:
+            bool: True if the command has expired, False otherwise.
+        """
+        if self.ttl == 0:
+            return False
+        return time.monotonic() - self.cache[command]["ctime"] > self.ttl
+
+    def _update_access(self, command: str):
+        """
+        Update the access information for a redis command based on the eviction policy.
+
+        Args:
+            command (str): The redis command.
+        """
+        if self.eviction_policy == EvictionPolicy.LRU:
+            self.cache.move_to_end(command)
+        elif self.eviction_policy == EvictionPolicy.LFU:
+            self.cache[command]["access_count"] = (
+                self.cache.get(command, {}).get("access_count", 0) + 1
+            )
+            self.cache.move_to_end(command)
+        elif self.eviction_policy == EvictionPolicy.RANDOM:
+            pass  # Random eviction doesn't require updates
+
+    def _evict(self):
+        """Evict a redis command from the cache based on the eviction policy."""
+        if self._is_expired(self.commands_ttl_list[0]):
+            self.delete(self.commands_ttl_list[0])
+        elif self.eviction_policy == EvictionPolicy.LRU:
+            self.cache.popitem(last=False)
+        elif self.eviction_policy == EvictionPolicy.LFU:
+            min_access_command = min(
+                self.cache, key=lambda k: self.cache[k].get("access_count", 0)
+            )
+            self.cache.pop(min_access_command)
+        elif self.eviction_policy == EvictionPolicy.RANDOM:
+            random_command = random.choice(list(self.cache.keys()))
+            self.cache.pop(random_command)
+
+    def _update_key_commands_map(self, keys: List[KeyT], command: str):
+        """
+        Update the key_commands_map with command that uses the keys.
+
+        Args:
+            keys (List[KeyT]): The list of keys used in the command.
+            command (str): The redis command.
+        """
+        for key in keys:
+            self.key_commands_map[key].add(command)
+
+    def _del_key_commands_map(self, keys: List[KeyT], command: str):
+        """
+        Remove a redis command from the key_commands_map.
+
+        Args:
+            keys (List[KeyT]): The list of keys used in the redis command.
+            command (str): The redis command.
+        """
+        for key in keys:
+            self.key_commands_map[key].remove(command)
+
+    def invalidate(self, key: KeyT):
+        """
+        Invalidate (delete) all redis commands associated with a specific key.
+
+        Args:
+            key (KeyT): The key to be invalidated.
+        """
+        if key not in self.key_commands_map:
+            return
+        for command in self.key_commands_map[key]:
+            self.delete(command)
diff --git a/redis/client.py b/redis/client.py
index cb91c7a088..2ff3706d16 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -13,6 +13,12 @@
     _RedisCallbacksRESP3,
     bool_ok,
 )
+from redis.cache import (
+    DEFAULT_BLACKLIST,
+    DEFAULT_EVICTION_POLICY,
+    DEFAULT_WHITELIST,
+    _LocalChace,
+)
 from redis.commands import (
     CoreCommands,
     RedisModuleCommands,
@@ -32,6 +38,7 @@
 )
 from redis.lock import Lock
 from redis.retry import Retry
+from redis.typing import KeysT, ResponseT
 from redis.utils import (
     HIREDIS_AVAILABLE,
     _set_info_logger,
@@ -203,6 +210,13 @@ def __init__(
         redis_connect_func=None,
         credential_provider: Optional[CredentialProvider] = None,
         protocol: Optional[int] = 2,
+        cache_enable: bool = False,
+        client_cache: Optional[_LocalChace] = None,
+        cache_max_size: int = 100,
+        cache_ttl: int = 0,
+        cache_eviction_policy: str = DEFAULT_EVICTION_POLICY,
+        cache_blacklist: List[str] = DEFAULT_BLACKLIST,
+        cache_whitelist: List[str] = DEFAULT_WHITELIST,
     ) -> None:
         """
         Initialize a new Redis client.
@@ -310,6 +324,15 @@ def __init__(
         else:
             self.response_callbacks.update(_RedisCallbacksRESP2)
 
+        self.client_cache = client_cache
+        if cache_enable:
+            self.client_cache = _LocalChace(
+                cache_max_size, cache_ttl, cache_eviction_policy
+            )
+        if self.client_cache is not None:
+            self.cache_blacklist = cache_blacklist
+            self.cache_whitelist = cache_whitelist
+
     def __repr__(self) -> str:
         return f"{type(self).__name__}<{repr(self.connection_pool)}>"
 
@@ -525,23 +548,63 @@ def _disconnect_raise(self, conn, error):
         ):
             raise error
 
+    def _get_from_local_cache(self, command: str):
+        """
+        If the command is in the local cache, return the response
+        """
+        if (
+            self.client_cache is None
+            or command[0] in self.cache_blacklist
+            or command[0] not in self.cache_whitelist
+        ):
+            return None
+        return self.client_cache.get(command)
+
+    def _add_to_local_cache(self, command: str, response: ResponseT, keys: List[KeysT]):
+        """
+        Add the command and response to the local cache if the command
+        is allowed to be cached
+        """
+        if (
+            self.client_cache is not None
+            and (self.cache_blacklist == [] or command[0] not in self.cache_blacklist)
+            and (self.cache_whitelist == [] or command[0] in self.cache_whitelist)
+        ):
+            self.client_cache.set(command, response, keys)
+
+    def delete_from_local_cache(self, command: str):
+        """
+        Delete the command from the local cache
+        """
+        try:
+            self.client_cache.delete(command)
+        except AttributeError:
+            pass
+
     # COMMAND EXECUTION AND PROTOCOL PARSING
     def execute_command(self, *args, **options):
         """Execute a command and return a parsed response"""
-        pool = self.connection_pool
         command_name = args[0]
-        conn = self.connection or pool.get_connection(command_name, **options)
+        keys = options.pop("keys", None)
+        response_from_cache = self._get_from_local_cache(args)
+        if response_from_cache is not None:
+            return response_from_cache
+        else:
+            pool = self.connection_pool
+            conn = self.connection or pool.get_connection(command_name, **options)
 
-        try:
-            return conn.retry.call_with_retry(
-                lambda: self._send_command_parse_response(
-                    conn, command_name, *args, **options
-                ),
-                lambda error: self._disconnect_raise(conn, error),
-            )
-        finally:
-            if not self.connection:
-                pool.release(conn)
+            try:
+                response = conn.retry.call_with_retry(
+                    lambda: self._send_command_parse_response(
+                        conn, command_name, *args, **options
+                    ),
+                    lambda error: self._disconnect_raise(conn, error),
+                )
+                self._add_to_local_cache(args, response, keys)
+                return response
+            finally:
+                if not self.connection:
+                    pool.release(conn)
 
     def parse_response(self, connection, command_name, **options):
         """Parses a response from the Redis server"""
@@ -1253,6 +1316,7 @@ def multi(self) -> None:
         self.explicit_transaction = True
 
     def execute_command(self, *args, **kwargs):
+        kwargs.pop("keys", None)  # the keys are used only for client side caching
         if (self.watching or args[0] == "WATCH") and not self.explicit_transaction:
             return self.immediate_execute_command(*args, **kwargs)
         return self.pipeline_execute_command(*args, **kwargs)
diff --git a/redis/cluster.py b/redis/cluster.py
index 873d586c4a..4de11b4e8c 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -1060,6 +1060,7 @@ def execute_command(self, *args, **kwargs):
             list<ClusterNode>
             dict<Any, ClusterNode>
         """
+        kwargs.pop("keys", None)  # the keys are used only for client side caching
         target_nodes_specified = False
         is_default_node = False
         target_nodes = None
@@ -1962,6 +1963,7 @@ def execute_command(self, *args, **kwargs):
         """
         Wrapper function for pipeline_execute_command
         """
+        kwargs.pop("keys", None)  # the keys are used only for client side caching
         return self.pipeline_execute_command(*args, **kwargs)
 
     def pipeline_execute_command(self, *args, **options):
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index 14b8741443..8637f6c247 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -23,6 +23,7 @@
     KeysT,
     KeyT,
     PatternT,
+    ResponseT,
 )
 
 from .core import (
@@ -40,7 +41,6 @@
     ManagementCommands,
     ModuleCommands,
     PubSubCommands,
-    ResponseT,
     ScriptCommands,
 )
 from .helpers import list_or_args
diff --git a/redis/commands/core.py b/redis/commands/core.py
index e73553e47e..f97724d030 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -5,7 +5,6 @@
 import warnings
 from typing import (
     TYPE_CHECKING,
-    Any,
     AsyncIterator,
     Awaitable,
     Callable,
@@ -37,6 +36,7 @@
     KeysT,
     KeyT,
     PatternT,
+    ResponseT,
     ScriptTextT,
     StreamIdT,
     TimeoutSecT,
@@ -49,8 +49,6 @@
     from redis.asyncio.client import Redis as AsyncRedis
     from redis.client import Redis
 
-ResponseT = Union[Awaitable, Any]
-
 
 class ACLCommands(CommandsProtocol):
     """
@@ -1590,7 +1588,7 @@ def bitcount(
             raise DataError("Both start and end must be specified")
         if mode is not None:
             params.append(mode)
-        return self.execute_command("BITCOUNT", *params)
+        return self.execute_command("BITCOUNT", *params, keys=[key])
 
     def bitfield(
         self: Union["Redis", "AsyncRedis"],
@@ -1626,7 +1624,7 @@ def bitfield_ro(
         items = items or []
         for encoding, offset in items:
             params.extend(["GET", encoding, offset])
-        return self.execute_command("BITFIELD_RO", *params)
+        return self.execute_command("BITFIELD_RO", *params, keys=[key])
 
     def bitop(self, operation: str, dest: KeyT, *keys: KeyT) -> ResponseT:
         """
@@ -1666,7 +1664,7 @@ def bitpos(
 
         if mode is not None:
             params.append(mode)
-        return self.execute_command("BITPOS", *params)
+        return self.execute_command("BITPOS", *params, keys=[key])
 
     def copy(
         self,
@@ -1733,7 +1731,7 @@ def exists(self, *names: KeyT) -> ResponseT:
 
         For more information see https://redis.io/commands/exists
         """
-        return self.execute_command("EXISTS", *names)
+        return self.execute_command("EXISTS", *names, keys=names)
 
     __contains__ = exists
 
@@ -1826,7 +1824,7 @@ def get(self, name: KeyT) -> ResponseT:
 
         For more information see https://redis.io/commands/get
         """
-        return self.execute_command("GET", name)
+        return self.execute_command("GET", name, keys=[name])
 
     def getdel(self, name: KeyT) -> ResponseT:
         """
@@ -1920,7 +1918,7 @@ def getbit(self, name: KeyT, offset: int) -> ResponseT:
 
         For more information see https://redis.io/commands/getbit
         """
-        return self.execute_command("GETBIT", name, offset)
+        return self.execute_command("GETBIT", name, offset, keys=[name])
 
     def getrange(self, key: KeyT, start: int, end: int) -> ResponseT:
         """
@@ -1929,7 +1927,7 @@ def getrange(self, key: KeyT, start: int, end: int) -> ResponseT:
 
         For more information see https://redis.io/commands/getrange
         """
-        return self.execute_command("GETRANGE", key, start, end)
+        return self.execute_command("GETRANGE", key, start, end, keys=[key])
 
     def getset(self, name: KeyT, value: EncodableT) -> ResponseT:
         """
@@ -2012,6 +2010,7 @@ def mget(self, keys: KeysT, *args: EncodableT) -> ResponseT:
         options = {}
         if not args:
             options[EMPTY_RESPONSE] = []
+        options["keys"] = keys
         return self.execute_command("MGET", *args, **options)
 
     def mset(self, mapping: Mapping[AnyKeyT, EncodableT]) -> ResponseT:
@@ -2458,14 +2457,14 @@ def strlen(self, name: KeyT) -> ResponseT:
 
         For more information see https://redis.io/commands/strlen
         """
-        return self.execute_command("STRLEN", name)
+        return self.execute_command("STRLEN", name, keys=[name])
 
     def substr(self, name: KeyT, start: int, end: int = -1) -> ResponseT:
         """
         Return a substring of the string at key ``name``. ``start`` and ``end``
         are 0-based integers specifying the portion of the string to return.
         """
-        return self.execute_command("SUBSTR", name, start, end)
+        return self.execute_command("SUBSTR", name, start, end, keys=[name])
 
     def touch(self, *args: KeyT) -> ResponseT:
         """
@@ -2490,7 +2489,7 @@ def type(self, name: KeyT) -> ResponseT:
 
         For more information see https://redis.io/commands/type
         """
-        return self.execute_command("TYPE", name)
+        return self.execute_command("TYPE", name, keys=[name])
 
     def watch(self, *names: KeyT) -> None:
         """
@@ -2543,7 +2542,7 @@ def lcs(
             pieces.extend(["MINMATCHLEN", minmatchlen])
         if withmatchlen:
             pieces.append("WITHMATCHLEN")
-        return self.execute_command("LCS", *pieces)
+        return self.execute_command("LCS", *pieces, keys=[key1, key2])
 
 
 class AsyncBasicKeyCommands(BasicKeyCommands):
@@ -2682,7 +2681,7 @@ def lindex(
 
         For more information see https://redis.io/commands/lindex
         """
-        return self.execute_command("LINDEX", name, index)
+        return self.execute_command("LINDEX", name, index, keys=[name])
 
     def linsert(
         self, name: str, where: str, refvalue: str, value: str
@@ -2704,7 +2703,7 @@ def llen(self, name: str) -> Union[Awaitable[int], int]:
 
         For more information see https://redis.io/commands/llen
         """
-        return self.execute_command("LLEN", name)
+        return self.execute_command("LLEN", name, keys=[name])
 
     def lpop(
         self,
@@ -2751,7 +2750,7 @@ def lrange(self, name: str, start: int, end: int) -> Union[Awaitable[list], list
 
         For more information see https://redis.io/commands/lrange
         """
-        return self.execute_command("LRANGE", name, start, end)
+        return self.execute_command("LRANGE", name, start, end, keys=[name])
 
     def lrem(self, name: str, count: int, value: str) -> Union[Awaitable[int], int]:
         """
@@ -2874,7 +2873,7 @@ def lpos(
         if maxlen is not None:
             pieces.extend(["MAXLEN", maxlen])
 
-        return self.execute_command("LPOS", *pieces)
+        return self.execute_command("LPOS", *pieces, keys=[name])
 
     def sort(
         self,
@@ -2946,6 +2945,7 @@ def sort(
                 )
 
         options = {"groups": len(get) if groups else None}
+        options["keys"] = [name]
         return self.execute_command("SORT", *pieces, **options)
 
     def sort_ro(
@@ -3319,7 +3319,7 @@ def scard(self, name: str) -> Union[Awaitable[int], int]:
 
         For more information see https://redis.io/commands/scard
         """
-        return self.execute_command("SCARD", name)
+        return self.execute_command("SCARD", name, keys=[name])
 
     def sdiff(self, keys: List, *args: List) -> Union[Awaitable[list], list]:
         """
@@ -3328,7 +3328,7 @@ def sdiff(self, keys: List, *args: List) -> Union[Awaitable[list], list]:
         For more information see https://redis.io/commands/sdiff
         """
         args = list_or_args(keys, args)
-        return self.execute_command("SDIFF", *args)
+        return self.execute_command("SDIFF", *args, keys=args)
 
     def sdiffstore(
         self, dest: str, keys: List, *args: List
@@ -3349,7 +3349,7 @@ def sinter(self, keys: List, *args: List) -> Union[Awaitable[list], list]:
         For more information see https://redis.io/commands/sinter
         """
         args = list_or_args(keys, args)
-        return self.execute_command("SINTER", *args)
+        return self.execute_command("SINTER", *args, keys=args)
 
     def sintercard(
         self, numkeys: int, keys: List[str], limit: int = 0
@@ -3364,7 +3364,7 @@ def sintercard(
         For more information see https://redis.io/commands/sintercard
         """
         args = [numkeys, *keys, "LIMIT", limit]
-        return self.execute_command("SINTERCARD", *args)
+        return self.execute_command("SINTERCARD", *args, keys=keys)
 
     def sinterstore(
         self, dest: str, keys: List, *args: List
@@ -3388,7 +3388,7 @@ def sismember(
 
         For more information see https://redis.io/commands/sismember
         """
-        return self.execute_command("SISMEMBER", name, value)
+        return self.execute_command("SISMEMBER", name, value, keys=[name])
 
     def smembers(self, name: str) -> Union[Awaitable[Set], Set]:
         """
@@ -3396,7 +3396,7 @@ def smembers(self, name: str) -> Union[Awaitable[Set], Set]:
 
         For more information see https://redis.io/commands/smembers
         """
-        return self.execute_command("SMEMBERS", name)
+        return self.execute_command("SMEMBERS", name, keys=[name])
 
     def smismember(
         self, name: str, values: List, *args: List
@@ -3413,7 +3413,7 @@ def smismember(
         For more information see https://redis.io/commands/smismember
         """
         args = list_or_args(values, args)
-        return self.execute_command("SMISMEMBER", name, *args)
+        return self.execute_command("SMISMEMBER", name, *args, keys=[name])
 
     def smove(self, src: str, dst: str, value: str) -> Union[Awaitable[bool], bool]:
         """
@@ -3462,7 +3462,7 @@ def sunion(self, keys: List, *args: List) -> Union[Awaitable[List], List]:
         For more information see https://redis.io/commands/sunion
         """
         args = list_or_args(keys, args)
-        return self.execute_command("SUNION", *args)
+        return self.execute_command("SUNION", *args, keys=args)
 
     def sunionstore(
         self, dest: str, keys: List, *args: List
@@ -3820,7 +3820,7 @@ def xlen(self, name: KeyT) -> ResponseT:
 
         For more information see https://redis.io/commands/xlen
         """
-        return self.execute_command("XLEN", name)
+        return self.execute_command("XLEN", name, keys=[name])
 
     def xpending(self, name: KeyT, groupname: GroupT) -> ResponseT:
         """
@@ -3830,7 +3830,7 @@ def xpending(self, name: KeyT, groupname: GroupT) -> ResponseT:
 
         For more information see https://redis.io/commands/xpending
         """
-        return self.execute_command("XPENDING", name, groupname)
+        return self.execute_command("XPENDING", name, groupname, keys=[name])
 
     def xpending_range(
         self,
@@ -3919,7 +3919,7 @@ def xrange(
             pieces.append(b"COUNT")
             pieces.append(str(count))
 
-        return self.execute_command("XRANGE", name, *pieces)
+        return self.execute_command("XRANGE", name, *pieces, keys=[name])
 
     def xread(
         self,
@@ -3957,7 +3957,7 @@ def xread(
         keys, values = zip(*streams.items())
         pieces.extend(keys)
         pieces.extend(values)
-        return self.execute_command("XREAD", *pieces)
+        return self.execute_command("XREAD", *pieces, keys=keys)
 
     def xreadgroup(
         self,
@@ -4036,7 +4036,7 @@ def xrevrange(
             pieces.append(b"COUNT")
             pieces.append(str(count))
 
-        return self.execute_command("XREVRANGE", name, *pieces)
+        return self.execute_command("XREVRANGE", name, *pieces, keys=[name])
 
     def xtrim(
         self,
@@ -4175,7 +4175,7 @@ def zcard(self, name: KeyT) -> ResponseT:
 
         For more information see https://redis.io/commands/zcard
         """
-        return self.execute_command("ZCARD", name)
+        return self.execute_command("ZCARD", name, keys=[name])
 
     def zcount(self, name: KeyT, min: ZScoreBoundT, max: ZScoreBoundT) -> ResponseT:
         """
@@ -4184,7 +4184,7 @@ def zcount(self, name: KeyT, min: ZScoreBoundT, max: ZScoreBoundT) -> ResponseT:
 
         For more information see https://redis.io/commands/zcount
         """
-        return self.execute_command("ZCOUNT", name, min, max)
+        return self.execute_command("ZCOUNT", name, min, max, keys=[name])
 
     def zdiff(self, keys: KeysT, withscores: bool = False) -> ResponseT:
         """
@@ -4196,7 +4196,7 @@ def zdiff(self, keys: KeysT, withscores: bool = False) -> ResponseT:
         pieces = [len(keys), *keys]
         if withscores:
             pieces.append("WITHSCORES")
-        return self.execute_command("ZDIFF", *pieces)
+        return self.execute_command("ZDIFF", *pieces, keys=keys)
 
     def zdiffstore(self, dest: KeyT, keys: KeysT) -> ResponseT:
         """
@@ -4264,7 +4264,7 @@ def zintercard(
         For more information see https://redis.io/commands/zintercard
         """
         args = [numkeys, *keys, "LIMIT", limit]
-        return self.execute_command("ZINTERCARD", *args)
+        return self.execute_command("ZINTERCARD", *args, keys=keys)
 
     def zlexcount(self, name, min, max):
         """
@@ -4273,7 +4273,7 @@ def zlexcount(self, name, min, max):
 
         For more information see https://redis.io/commands/zlexcount
         """
-        return self.execute_command("ZLEXCOUNT", name, min, max)
+        return self.execute_command("ZLEXCOUNT", name, min, max, keys=[name])
 
     def zpopmax(self, name: KeyT, count: Union[int, None] = None) -> ResponseT:
         """
@@ -4456,6 +4456,7 @@ def _zrange(
         if withscores:
             pieces.append("WITHSCORES")
         options = {"withscores": withscores, "score_cast_func": score_cast_func}
+        options["keys"] = [name]
         return self.execute_command(*pieces, **options)
 
     def zrange(
@@ -4544,6 +4545,7 @@ def zrevrange(
         if withscores:
             pieces.append(b"WITHSCORES")
         options = {"withscores": withscores, "score_cast_func": score_cast_func}
+        options["keys"] = name
         return self.execute_command(*pieces, **options)
 
     def zrangestore(
@@ -4618,7 +4620,7 @@ def zrangebylex(
         pieces = ["ZRANGEBYLEX", name, min, max]
         if start is not None and num is not None:
             pieces.extend([b"LIMIT", start, num])
-        return self.execute_command(*pieces)
+        return self.execute_command(*pieces, keys=[name])
 
     def zrevrangebylex(
         self,
@@ -4642,7 +4644,7 @@ def zrevrangebylex(
         pieces = ["ZREVRANGEBYLEX", name, max, min]
         if start is not None and num is not None:
             pieces.extend(["LIMIT", start, num])
-        return self.execute_command(*pieces)
+        return self.execute_command(*pieces, keys=[name])
 
     def zrangebyscore(
         self,
@@ -4676,6 +4678,7 @@ def zrangebyscore(
         if withscores:
             pieces.append("WITHSCORES")
         options = {"withscores": withscores, "score_cast_func": score_cast_func}
+        options["keys"] = [name]
         return self.execute_command(*pieces, **options)
 
     def zrevrangebyscore(
@@ -4710,6 +4713,7 @@ def zrevrangebyscore(
         if withscores:
             pieces.append("WITHSCORES")
         options = {"withscores": withscores, "score_cast_func": score_cast_func}
+        options["keys"] = [name]
         return self.execute_command(*pieces, **options)
 
     def zrank(
@@ -4727,8 +4731,8 @@ def zrank(
         For more information see https://redis.io/commands/zrank
         """
         if withscore:
-            return self.execute_command("ZRANK", name, value, "WITHSCORE")
-        return self.execute_command("ZRANK", name, value)
+            return self.execute_command("ZRANK", name, value, "WITHSCORE", keys=[name])
+        return self.execute_command("ZRANK", name, value, keys=[name])
 
     def zrem(self, name: KeyT, *values: FieldT) -> ResponseT:
         """
@@ -4786,8 +4790,10 @@ def zrevrank(
         For more information see https://redis.io/commands/zrevrank
         """
         if withscore:
-            return self.execute_command("ZREVRANK", name, value, "WITHSCORE")
-        return self.execute_command("ZREVRANK", name, value)
+            return self.execute_command(
+                "ZREVRANK", name, value, "WITHSCORE", keys=[name]
+            )
+        return self.execute_command("ZREVRANK", name, value, keys=[name])
 
     def zscore(self, name: KeyT, value: EncodableT) -> ResponseT:
         """
@@ -4795,7 +4801,7 @@ def zscore(self, name: KeyT, value: EncodableT) -> ResponseT:
 
         For more information see https://redis.io/commands/zscore
         """
-        return self.execute_command("ZSCORE", name, value)
+        return self.execute_command("ZSCORE", name, value, keys=[name])
 
     def zunion(
         self,
@@ -4842,7 +4848,7 @@ def zmscore(self, key: KeyT, members: List[str]) -> ResponseT:
         if not members:
             raise DataError("ZMSCORE members must be a non-empty list")
         pieces = [key] + members
-        return self.execute_command("ZMSCORE", *pieces)
+        return self.execute_command("ZMSCORE", *pieces, keys=[key])
 
     def _zaggregate(
         self,
@@ -4872,6 +4878,7 @@ def _zaggregate(
                 raise DataError("aggregate can be sum, min or max.")
         if options.get("withscores", False):
             pieces.append(b"WITHSCORES")
+        options["keys"] = keys
         return self.execute_command(*pieces, **options)
 
 
@@ -4933,7 +4940,7 @@ def hexists(self, name: str, key: str) -> Union[Awaitable[bool], bool]:
 
         For more information see https://redis.io/commands/hexists
         """
-        return self.execute_command("HEXISTS", name, key)
+        return self.execute_command("HEXISTS", name, key, keys=[name])
 
     def hget(
         self, name: str, key: str
@@ -4943,7 +4950,7 @@ def hget(
 
         For more information see https://redis.io/commands/hget
         """
-        return self.execute_command("HGET", name, key)
+        return self.execute_command("HGET", name, key, keys=[name])
 
     def hgetall(self, name: str) -> Union[Awaitable[dict], dict]:
         """
@@ -4951,7 +4958,7 @@ def hgetall(self, name: str) -> Union[Awaitable[dict], dict]:
 
         For more information see https://redis.io/commands/hgetall
         """
-        return self.execute_command("HGETALL", name)
+        return self.execute_command("HGETALL", name, keys=[name])
 
     def hincrby(
         self, name: str, key: str, amount: int = 1
@@ -4979,7 +4986,7 @@ def hkeys(self, name: str) -> Union[Awaitable[List], List]:
 
         For more information see https://redis.io/commands/hkeys
         """
-        return self.execute_command("HKEYS", name)
+        return self.execute_command("HKEYS", name, keys=[name])
 
     def hlen(self, name: str) -> Union[Awaitable[int], int]:
         """
@@ -4987,7 +4994,7 @@ def hlen(self, name: str) -> Union[Awaitable[int], int]:
 
         For more information see https://redis.io/commands/hlen
         """
-        return self.execute_command("HLEN", name)
+        return self.execute_command("HLEN", name, keys=[name])
 
     def hset(
         self,
@@ -5054,7 +5061,7 @@ def hmget(self, name: str, keys: List, *args: List) -> Union[Awaitable[List], Li
         For more information see https://redis.io/commands/hmget
         """
         args = list_or_args(keys, args)
-        return self.execute_command("HMGET", name, *args)
+        return self.execute_command("HMGET", name, *args, keys=[name])
 
     def hvals(self, name: str) -> Union[Awaitable[List], List]:
         """
@@ -5062,7 +5069,7 @@ def hvals(self, name: str) -> Union[Awaitable[List], List]:
 
         For more information see https://redis.io/commands/hvals
         """
-        return self.execute_command("HVALS", name)
+        return self.execute_command("HVALS", name, keys=[name])
 
     def hstrlen(self, name: str, key: str) -> Union[Awaitable[int], int]:
         """
@@ -5071,7 +5078,7 @@ def hstrlen(self, name: str, key: str) -> Union[Awaitable[int], int]:
 
         For more information see https://redis.io/commands/hstrlen
         """
-        return self.execute_command("HSTRLEN", name, key)
+        return self.execute_command("HSTRLEN", name, key, keys=[name])
 
 
 AsyncHashCommands = HashCommands
@@ -5464,7 +5471,7 @@ def geodist(
             raise DataError("GEODIST invalid unit")
         elif unit:
             pieces.append(unit)
-        return self.execute_command("GEODIST", *pieces)
+        return self.execute_command("GEODIST", *pieces, keys=[name])
 
     def geohash(self, name: KeyT, *values: FieldT) -> ResponseT:
         """
@@ -5473,7 +5480,7 @@ def geohash(self, name: KeyT, *values: FieldT) -> ResponseT:
 
         For more information see https://redis.io/commands/geohash
         """
-        return self.execute_command("GEOHASH", name, *values)
+        return self.execute_command("GEOHASH", name, *values, keys=[name])
 
     def geopos(self, name: KeyT, *values: FieldT) -> ResponseT:
         """
@@ -5483,7 +5490,7 @@ def geopos(self, name: KeyT, *values: FieldT) -> ResponseT:
 
         For more information see https://redis.io/commands/geopos
         """
-        return self.execute_command("GEOPOS", name, *values)
+        return self.execute_command("GEOPOS", name, *values, keys=[name])
 
     def georadius(
         self,
@@ -5823,6 +5830,8 @@ def _geosearchgeneric(
             if kwargs[arg_name]:
                 pieces.append(byte_repr)
 
+        kwargs["keys"] = [args[0] if command == "GEOSEARCH" else args[1]]
+
         return self.execute_command(command, *pieces, **kwargs)
 
 
diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index 0f92e0d6c9..ef0cb205a5 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -49,7 +49,7 @@ def arrindex(
             if stop is not None:
                 pieces.append(stop)
 
-        return self.execute_command("JSON.ARRINDEX", *pieces)
+        return self.execute_command("JSON.ARRINDEX", *pieces, keys=[name])
 
     def arrinsert(
         self, name: str, path: str, index: int, *args: List[JsonType]
@@ -72,7 +72,7 @@ def arrlen(
 
         For more information see `JSON.ARRLEN <https://redis.io/commands/json.arrlen>`_.
         """  # noqa
-        return self.execute_command("JSON.ARRLEN", name, str(path))
+        return self.execute_command("JSON.ARRLEN", name, str(path), keys=[name])
 
     def arrpop(
         self,
@@ -102,14 +102,14 @@ def type(self, name: str, path: Optional[str] = Path.root_path()) -> List[str]:
 
         For more information see `JSON.TYPE <https://redis.io/commands/json.type>`_.
         """  # noqa
-        return self.execute_command("JSON.TYPE", name, str(path))
+        return self.execute_command("JSON.TYPE", name, str(path), keys=[name])
 
     def resp(self, name: str, path: Optional[str] = Path.root_path()) -> List:
         """Return the JSON value under ``path`` at key ``name``.
 
         For more information see `JSON.RESP <https://redis.io/commands/json.resp>`_.
         """  # noqa
-        return self.execute_command("JSON.RESP", name, str(path))
+        return self.execute_command("JSON.RESP", name, str(path), keys=[name])
 
     def objkeys(
         self, name: str, path: Optional[str] = Path.root_path()
@@ -119,7 +119,7 @@ def objkeys(
 
         For more information see `JSON.OBJKEYS <https://redis.io/commands/json.objkeys>`_.
         """  # noqa
-        return self.execute_command("JSON.OBJKEYS", name, str(path))
+        return self.execute_command("JSON.OBJKEYS", name, str(path), keys=[name])
 
     def objlen(self, name: str, path: Optional[str] = Path.root_path()) -> int:
         """Return the length of the dictionary JSON value under ``path`` at key
@@ -127,7 +127,7 @@ def objlen(self, name: str, path: Optional[str] = Path.root_path()) -> int:
 
         For more information see `JSON.OBJLEN <https://redis.io/commands/json.objlen>`_.
         """  # noqa
-        return self.execute_command("JSON.OBJLEN", name, str(path))
+        return self.execute_command("JSON.OBJLEN", name, str(path), keys=[name])
 
     def numincrby(self, name: str, path: str, number: int) -> str:
         """Increment the numeric (integer or floating point) JSON value under
@@ -197,7 +197,7 @@ def get(
         # Handle case where key doesn't exist. The JSONDecoder would raise a
         # TypeError exception since it can't decode None
         try:
-            return self.execute_command("JSON.GET", *pieces)
+            return self.execute_command("JSON.GET", *pieces, keys=[name])
         except TypeError:
             return None
 
@@ -211,7 +211,7 @@ def mget(self, keys: List[str], path: str) -> List[JsonType]:
         pieces = []
         pieces += keys
         pieces.append(str(path))
-        return self.execute_command("JSON.MGET", *pieces)
+        return self.execute_command("JSON.MGET", *pieces, keys=keys)
 
     def set(
         self,
@@ -364,7 +364,7 @@ def strlen(self, name: str, path: Optional[str] = None) -> List[Union[int, None]
         pieces = [name]
         if path is not None:
             pieces.append(str(path))
-        return self.execute_command("JSON.STRLEN", *pieces)
+        return self.execute_command("JSON.STRLEN", *pieces, keys=[name])
 
     def toggle(
         self, name: str, path: Optional[str] = Path.root_path()
diff --git a/redis/commands/timeseries/commands.py b/redis/commands/timeseries/commands.py
index 13e3cdf498..1cb183d087 100644
--- a/redis/commands/timeseries/commands.py
+++ b/redis/commands/timeseries/commands.py
@@ -425,7 +425,7 @@ def range(
             bucket_timestamp,
             empty,
         )
-        return self.execute_command(RANGE_CMD, *params)
+        return self.execute_command(RANGE_CMD, *params, keys=[key])
 
     def revrange(
         self,
@@ -497,7 +497,7 @@ def revrange(
             bucket_timestamp,
             empty,
         )
-        return self.execute_command(REVRANGE_CMD, *params)
+        return self.execute_command(REVRANGE_CMD, *params, keys=[key])
 
     def __mrange_params(
         self,
@@ -721,7 +721,7 @@ def get(self, key: KeyT, latest: Optional[bool] = False):
         """  # noqa
         params = [key]
         self._append_latest(params, latest)
-        return self.execute_command(GET_CMD, *params)
+        return self.execute_command(GET_CMD, *params, keys=[key])
 
     def mget(
         self,
@@ -761,7 +761,7 @@ def info(self, key: KeyT):
 
         For more information: https://redis.io/commands/ts.info/
         """  # noqa
-        return self.execute_command(INFO_CMD, key)
+        return self.execute_command(INFO_CMD, key, keys=[key])
 
     def queryindex(self, filters: List[str]):
         """# noqa
diff --git a/redis/commands/timeseries/utils.py b/redis/commands/timeseries/utils.py
index c49b040271..12ed656277 100644
--- a/redis/commands/timeseries/utils.py
+++ b/redis/commands/timeseries/utils.py
@@ -5,7 +5,7 @@ def list_to_dict(aList):
     return {nativestr(aList[i][0]): nativestr(aList[i][1]) for i in range(len(aList))}
 
 
-def parse_range(response):
+def parse_range(response, **kwargs):
     """Parse range response. Used by TS.RANGE and TS.REVRANGE."""
     return [tuple((r[0], float(r[1]))) for r in response]
 
diff --git a/redis/sentinel.py b/redis/sentinel.py
index 41f308d1ee..a1ae5c5275 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -244,6 +244,7 @@ def execute_command(self, *args, **kwargs):
         once - If set to True, then execute the resulting command on a single
         node at random, rather than across the entire sentinel cluster.
         """
+        kwargs.pop("keys", None)  # the keys are used only for client side caching
         once = bool(kwargs.get("once", False))
         if "once" in kwargs.keys():
             kwargs.pop("once")
diff --git a/redis/typing.py b/redis/typing.py
index 56a1e99ba7..d1cd5568a3 100644
--- a/redis/typing.py
+++ b/redis/typing.py
@@ -33,6 +33,7 @@
 PatternT = _StringLikeT  # Patterns matched against keys, fields etc
 FieldT = EncodableT  # Fields within hash tables, streams and geo commands
 KeysT = Union[KeyT, Iterable[KeyT]]
+ResponseT = Union[Awaitable, Any]
 ChannelT = _StringLikeT
 GroupT = _StringLikeT  # Consumer group
 ConsumerT = _StringLikeT  # Consumer name

From 8875d553ba52b630f6c23cd69723f2be720b15b8 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 16 Nov 2023 13:59:07 +0200
Subject: [PATCH 0805/1164] Version 5.1.0a1 (#3044)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index f22d809d27..8979b29b23 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="5.0.1",
+    version="5.1.0a1",
     packages=find_packages(
         include=[
             "redis",

From 58da813e2ed3ce45d9bc14fff8d0a378b0f5ee82 Mon Sep 17 00:00:00 2001
From: Aniket Patil <128228805+AniketP04@users.noreply.github.com>
Date: Wed, 29 Nov 2023 06:01:50 +0530
Subject: [PATCH 0806/1164] Update ocsp.py (#3022)

---
 redis/ocsp.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/redis/ocsp.py b/redis/ocsp.py
index b0420b4711..8819848fa9 100644
--- a/redis/ocsp.py
+++ b/redis/ocsp.py
@@ -61,7 +61,7 @@ def _check_certificate(issuer_cert, ocsp_bytes, validate=True):
             )
     else:
         raise ConnectionError(
-            "failed to retrieve a sucessful response from the ocsp responder"
+            "failed to retrieve a successful response from the ocsp responder"
         )
 
     if ocsp_response.this_update >= datetime.datetime.now():
@@ -139,7 +139,7 @@ def _get_pubkey_hash(certificate):
 
 
 def ocsp_staple_verifier(con, ocsp_bytes, expected=None):
-    """An implemention of a function for set_ocsp_client_callback in PyOpenSSL.
+    """An implementation of a function for set_ocsp_client_callback in PyOpenSSL.
 
     This function validates that the provide ocsp_bytes response is valid,
     and matches the expected, stapled responses.
@@ -266,7 +266,7 @@ def build_certificate_url(self, server, cert, issuer_cert):
         return url
 
     def check_certificate(self, server, cert, issuer_url):
-        """Checks the validitity of an ocsp server for an issuer"""
+        """Checks the validity of an ocsp server for an issuer"""
 
         r = requests.get(issuer_url)
         if not r.ok:

From a60d25e0a0da8742d85447b198817f01a4089ce4 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 3 Dec 2023 02:40:49 +0200
Subject: [PATCH 0807/1164] Bump rojopolis/spellcheck-github-actions from
 0.34.0 to 0.35.0 (#3060)

Bumps [rojopolis/spellcheck-github-actions](https://github.com/rojopolis/spellcheck-github-actions) from 0.34.0 to 0.35.0.
- [Release notes](https://github.com/rojopolis/spellcheck-github-actions/releases)
- [Changelog](https://github.com/rojopolis/spellcheck-github-actions/blob/master/CHANGELOG.md)
- [Commits](https://github.com/rojopolis/spellcheck-github-actions/compare/0.34.0...0.35.0)

---
updated-dependencies:
- dependency-name: rojopolis/spellcheck-github-actions
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/spellcheck.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/spellcheck.yml b/.github/workflows/spellcheck.yml
index 46c629b2cc..a48781aa84 100644
--- a/.github/workflows/spellcheck.yml
+++ b/.github/workflows/spellcheck.yml
@@ -8,7 +8,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
       - name: Check Spelling
-        uses: rojopolis/spellcheck-github-actions@0.34.0
+        uses: rojopolis/spellcheck-github-actions@0.35.0
         with:
           config_path: .github/spellcheck-settings.yml
           task_name: Markdown

From ac92e0c53c8d2a54e2111fab923ecfa1a51dbfcd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Stanis=C5=82aw=20Denkowski?= <mr.denkov@gmail.com>
Date: Sun, 3 Dec 2023 01:45:47 +0100
Subject: [PATCH 0808/1164] Use `disable_decoding` in async `read_response`.
 (#3042)

---
 CHANGES                   |  1 +
 redis/_parsers/hiredis.py | 10 ++++++++--
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/CHANGES b/CHANGES
index 8cfc47db18..ef983e4b51 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Fix async `read_response` to use `disable_decoding`.
     * Add 'aclose()' methods to async classes, deprecate async close().
     * Fix #2831, add auto_close_connection_pool=True arg to asyncio.Redis.from_url()
     * Fix incorrect redis.asyncio.Cluster type hint for `retry_on_error`
diff --git a/redis/_parsers/hiredis.py b/redis/_parsers/hiredis.py
index b3247b71ec..1919d3658e 100644
--- a/redis/_parsers/hiredis.py
+++ b/redis/_parsers/hiredis.py
@@ -198,10 +198,16 @@ async def read_response(
         if not self._connected:
             raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR) from None
 
-        response = self._reader.gets()
+        if disable_decoding:
+            response = self._reader.gets(False)
+        else:
+            response = self._reader.gets()
         while response is False:
             await self.read_from_socket()
-            response = self._reader.gets()
+            if disable_decoding:
+                response = self._reader.gets(False)
+            else:
+                response = self._reader.gets()
 
         # if the response is a ConnectionError or the response is a list and
         # the first item is a ConnectionError, raise it as something bad

From eefe3ab371db40ac6d0d54d15cc18fc81e94dfbf Mon Sep 17 00:00:00 2001
From: Pedram Parsian <pedram.parsian@gmail.com>
Date: Sun, 3 Dec 2023 04:20:52 +0330
Subject: [PATCH 0809/1164] Add "sum" to DUPLICATE_POLICY documentation of
 TS.CREATE, TS.ADD and TS.ALTER (#3027)

---
 CHANGES                               | 1 +
 redis/commands/timeseries/commands.py | 9 +++++++++
 2 files changed, 10 insertions(+)

diff --git a/CHANGES b/CHANGES
index ef983e4b51..191286d4af 100644
--- a/CHANGES
+++ b/CHANGES
@@ -56,6 +56,7 @@
     * Fix for Unhandled exception related to self.host with unix socket (#2496)
     * Improve error output for master discovery 
     * Make `ClusterCommandsProtocol` an actual Protocol
+    * Add `sum` to DUPLICATE_POLICY documentation of `TS.CREATE`, `TS.ADD` and `TS.ALTER`
 
 * 4.1.3 (Feb 8, 2022)
   * Fix flushdb and flushall (#1926)
diff --git a/redis/commands/timeseries/commands.py b/redis/commands/timeseries/commands.py
index 1cb183d087..208ddfb09f 100644
--- a/redis/commands/timeseries/commands.py
+++ b/redis/commands/timeseries/commands.py
@@ -59,6 +59,9 @@ def create(
             - 'last': override with latest value.
             - 'min': only override if the value is lower than the existing value.
             - 'max': only override if the value is higher than the existing value.
+            - 'sum': If a previous sample exists, add the new sample to it so that \
+            the updated value is equal to (previous + new). If no previous sample \
+            exists, set the updated value equal to the new value.
 
         For more information: https://redis.io/commands/ts.create/
         """  # noqa
@@ -103,6 +106,9 @@ def alter(
             - 'last': override with latest value.
             - 'min': only override if the value is lower than the existing value.
             - 'max': only override if the value is higher than the existing value.
+            - 'sum': If a previous sample exists, add the new sample to it so that \
+            the updated value is equal to (previous + new). If no previous sample \
+            exists, set the updated value equal to the new value.
 
         For more information: https://redis.io/commands/ts.alter/
         """  # noqa
@@ -154,6 +160,9 @@ def add(
             - 'last': override with latest value.
             - 'min': only override if the value is lower than the existing value.
             - 'max': only override if the value is higher than the existing value.
+            - 'sum': If a previous sample exists, add the new sample to it so that \
+            the updated value is equal to (previous + new). If no previous sample \
+            exists, set the updated value equal to the new value.
 
         For more information: https://redis.io/commands/ts.add/
         """  # noqa

From 8a3ae36de7c6a99c4b3b655c67531db40e575c3f Mon Sep 17 00:00:00 2001
From: BackflipPenguin <63213817+BackflipPenguin@users.noreply.github.com>
Date: Sat, 2 Dec 2023 21:51:27 -0300
Subject: [PATCH 0810/1164] Update advanced_features.rst (#3019)

---
 docs/advanced_features.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/advanced_features.rst b/docs/advanced_features.rst
index fd29d2f684..de645bd764 100644
--- a/docs/advanced_features.rst
+++ b/docs/advanced_features.rst
@@ -346,7 +346,7 @@ running.
 
 The third option runs an event loop in a separate thread.
 pubsub.run_in_thread() creates a new thread and starts the event loop.
-The thread object is returned to the caller of [un_in_thread(). The
+The thread object is returned to the caller of run_in_thread(). The
 caller can use the thread.stop() method to shut down the event loop and
 thread. Behind the scenes, this is simply a wrapper around get_message()
 that runs in a separate thread, essentially creating a tiny non-blocking

From e13356db9220de1196ca3b7d10a2de623cc15b69 Mon Sep 17 00:00:00 2001
From: AYMEN Mohammed <53928879+AYMENJD@users.noreply.github.com>
Date: Sun, 3 Dec 2023 03:53:30 +0300
Subject: [PATCH 0811/1164] Fix typos. (#3016)

---
 docs/conf.py                          | 2 +-
 docs/examples/pipeline_examples.ipynb | 2 +-
 redis/cluster.py                      | 2 +-
 redis/commands/cluster.py             | 6 +++---
 tests/test_asyncio/test_cwe_404.py    | 2 +-
 tests/test_asyncio/test_search.py     | 2 +-
 tests/test_graph.py                   | 2 +-
 tests/test_graph_utils/test_edge.py   | 2 +-
 tests/test_graph_utils/test_node.py   | 2 +-
 tests/test_search.py                  | 4 ++--
 10 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index 8849752404..a201da2fc0 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -86,7 +86,7 @@
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
-exclude_patterns = ["_build", "**.ipynb_checkponts"]
+exclude_patterns = ["_build", "**.ipynb_checkpoints"]
 
 # The reST default role (used for this markup: `text`) to use for all
 # documents.
diff --git a/docs/examples/pipeline_examples.ipynb b/docs/examples/pipeline_examples.ipynb
index 4e20375bfa..36ce31d708 100644
--- a/docs/examples/pipeline_examples.ipynb
+++ b/docs/examples/pipeline_examples.ipynb
@@ -123,7 +123,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "The responses of the three commands are stored in a list. In the above example, the two first boolean indicates that the `set` commands were successfull and the last element of the list is the result of the `get(\"a\")` comand."
+    "The responses of the three commands are stored in a list. In the above example, the two first boolean indicates that the `set` commands were successful and the last element of the list is the result of the `get(\"a\")` comand."
    ]
   },
   {
diff --git a/redis/cluster.py b/redis/cluster.py
index 4de11b4e8c..595efcb683 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -2198,7 +2198,7 @@ def _send_cluster_commands(
         )
         if attempt and allow_redirections:
             # RETRY MAGIC HAPPENS HERE!
-            # send these remaing commands one at a time using `execute_command`
+            # send these remaining commands one at a time using `execute_command`
             # in the main client. This keeps our retry logic
             # in one place mostly,
             # and allows us to be more confident in correctness of behavior.
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index 8637f6c247..af3a717c27 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -225,7 +225,7 @@ def delete(self, *keys: KeyT) -> ResponseT:
         The keys are first split up into slots
         and then an DEL command is sent for every slot
 
-        Non-existant keys are ignored.
+        Non-existent keys are ignored.
         Returns the number of keys that were deleted.
 
         For more information see https://redis.io/commands/del
@@ -240,7 +240,7 @@ def touch(self, *keys: KeyT) -> ResponseT:
         The keys are first split up into slots
         and then an TOUCH command is sent for every slot
 
-        Non-existant keys are ignored.
+        Non-existent keys are ignored.
         Returns the number of keys that were touched.
 
         For more information see https://redis.io/commands/touch
@@ -254,7 +254,7 @@ def unlink(self, *keys: KeyT) -> ResponseT:
         The keys are first split up into slots
         and then an TOUCH command is sent for every slot
 
-        Non-existant keys are ignored.
+        Non-existent keys are ignored.
         Returns the number of keys that were unlinked.
 
         For more information see https://redis.io/commands/unlink
diff --git a/tests/test_asyncio/test_cwe_404.py b/tests/test_asyncio/test_cwe_404.py
index bb9f1780ac..df46cabc43 100644
--- a/tests/test_asyncio/test_cwe_404.py
+++ b/tests/test_asyncio/test_cwe_404.py
@@ -253,7 +253,7 @@ async def op(r):
             with pytest.raises(asyncio.CancelledError):
                 await t
 
-            # try a number of requests to excercise all the connections
+            # try a number of requests to exercise all the connections
             async def doit():
                 assert await r.get("bar") == b"bar"
                 assert await r.ping()
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index efc5bf549c..1f1931e28a 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -1503,7 +1503,7 @@ async def test_withsuffixtrie(decoded_r: redis.Redis):
         assert "WITHSUFFIXTRIE" not in info["attributes"][0]["flags"]
         assert await decoded_r.ft().dropindex("idx")
 
-        # create withsuffixtrie index (text fiels)
+        # create withsuffixtrie index (text fields)
         assert await decoded_r.ft().create_index((TextField("t", withsuffixtrie=True)))
         waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
         info = await decoded_r.ft().info()
diff --git a/tests/test_graph.py b/tests/test_graph.py
index 6fa9977d98..c6d128908e 100644
--- a/tests/test_graph.py
+++ b/tests/test_graph.py
@@ -404,7 +404,7 @@ def test_cache_sync(client):
     # Client B will try to get Client A out of sync by:
     # 1. deleting the graph
     # 2. reconstructing the graph in a different order, this will casuse
-    #    a differance in the current mapping between string IDs and the
+    #    a difference in the current mapping between string IDs and the
     #    mapping Client A is aware of
     #
     # Client A should pick up on the changes by comparing graph versions
diff --git a/tests/test_graph_utils/test_edge.py b/tests/test_graph_utils/test_edge.py
index d2a1e3f39e..1918a6ff44 100644
--- a/tests/test_graph_utils/test_edge.py
+++ b/tests/test_graph_utils/test_edge.py
@@ -61,7 +61,7 @@ def test_stringify():
 
 
 @pytest.mark.redismod
-def test_comparision():
+def test_comparison():
     node1 = node.Node(node_id=1)
     node2 = node.Node(node_id=2)
     node3 = node.Node(node_id=3)
diff --git a/tests/test_graph_utils/test_node.py b/tests/test_graph_utils/test_node.py
index c3b34ac6ff..22e6d59414 100644
--- a/tests/test_graph_utils/test_node.py
+++ b/tests/test_graph_utils/test_node.py
@@ -33,7 +33,7 @@ def test_stringify(fixture):
 
 
 @pytest.mark.redismod
-def test_comparision(fixture):
+def test_comparison(fixture):
     no_args, no_props, props_only, no_label, multi_label = fixture
 
     assert node.Node() == node.Node()
diff --git a/tests/test_search.py b/tests/test_search.py
index 7469123453..bfe204254c 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -2227,7 +2227,7 @@ def test_withsuffixtrie(client: redis.Redis):
         assert "WITHSUFFIXTRIE" not in info["attributes"][0]
         assert client.ft().dropindex("idx")
 
-        # create withsuffixtrie index (text fiels)
+        # create withsuffixtrie index (text fields)
         assert client.ft().create_index((TextField("t", withsuffixtrie=True)))
         waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
         info = client.ft().info()
@@ -2244,7 +2244,7 @@ def test_withsuffixtrie(client: redis.Redis):
         assert "WITHSUFFIXTRIE" not in info["attributes"][0]["flags"]
         assert client.ft().dropindex("idx")
 
-        # create withsuffixtrie index (text fiels)
+        # create withsuffixtrie index (text fields)
         assert client.ft().create_index((TextField("t", withsuffixtrie=True)))
         waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
         info = client.ft().info()

From ce9eb83a14a3baaf31ee1038810977e36a0e05e0 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 4 Dec 2023 13:33:42 +0200
Subject: [PATCH 0812/1164] Fix parsing of `FT.PROFILE` result (#3063)

* Fix parsing of ft.profile result

* test
---
 redis/commands/helpers.py | 5 +++++
 tests/test_helpers.py     | 2 ++
 2 files changed, 7 insertions(+)

diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
index 324d981d66..127141f650 100644
--- a/redis/commands/helpers.py
+++ b/redis/commands/helpers.py
@@ -64,6 +64,11 @@ def parse_list_to_dict(response):
     for i in range(0, len(response), 2):
         if isinstance(response[i], list):
             res["Child iterators"].append(parse_list_to_dict(response[i]))
+            try:
+                if isinstance(response[i + 1], list):
+                    res["Child iterators"].append(parse_list_to_dict(response[i + 1]))
+            except IndexError:
+                pass
         elif isinstance(response[i + 1], list):
             res["Child iterators"] = [parse_list_to_dict(response[i + 1])]
         else:
diff --git a/tests/test_helpers.py b/tests/test_helpers.py
index 57a94d2f45..66ee1c5390 100644
--- a/tests/test_helpers.py
+++ b/tests/test_helpers.py
@@ -41,6 +41,7 @@ def test_parse_to_dict():
                 "Child iterators",
                 ["Type", "bar", "Time", "0.0729", "Counter", 3],
                 ["Type", "barbar", "Time", "0.058", "Counter", 3],
+                ["Type", "barbarbar", "Time", "0.0234", "Counter", 3],
             ],
         ],
     ]
@@ -49,6 +50,7 @@ def test_parse_to_dict():
             "Child iterators": [
                 {"Counter": 3.0, "Time": 0.0729, "Type": "bar"},
                 {"Counter": 3.0, "Time": 0.058, "Type": "barbar"},
+                {"Counter": 3.0, "Time": 0.0234, "Type": "barbarbar"},
             ],
             "Counter": 3.0,
             "Time": 0.2089,

From 3502c4d563e71ffcf2e71936528294ff130c9440 Mon Sep 17 00:00:00 2001
From: Jakob Keller <57402305+jakob-keller@users.noreply.github.com>
Date: Mon, 11 Dec 2023 01:38:13 +0100
Subject: [PATCH 0813/1164] Prevent async ClusterPipeline instances from
 becoming "false-y" in case of empty command stack (#3068)

---
 CHANGES                             | 1 +
 redis/asyncio/cluster.py            | 3 ++-
 tests/test_asyncio/test_pipeline.py | 1 -
 3 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/CHANGES b/CHANGES
index 191286d4af..e1496fa15c 100644
--- a/CHANGES
+++ b/CHANGES
@@ -57,6 +57,7 @@
     * Improve error output for master discovery 
     * Make `ClusterCommandsProtocol` an actual Protocol
     * Add `sum` to DUPLICATE_POLICY documentation of `TS.CREATE`, `TS.ADD` and `TS.ALTER`
+    * Prevent async ClusterPipeline instances from becoming "false-y" in case of empty command stack (#3061)
 
 * 4.1.3 (Feb 8, 2022)
   * Fix flushdb and flushall (#1926)
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index ebc7e4a4cb..6a1753ad19 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -1429,7 +1429,8 @@ def __exit__(self, exc_type: None, exc_value: None, traceback: None) -> None:
         self._command_stack = []
 
     def __bool__(self) -> bool:
-        return bool(self._command_stack)
+        "Pipeline instances should  always evaluate to True on Python 3+"
+        return True
 
     def __len__(self) -> int:
         return len(self._command_stack)
diff --git a/tests/test_asyncio/test_pipeline.py b/tests/test_asyncio/test_pipeline.py
index 3d271bf1d0..4b29360d72 100644
--- a/tests/test_asyncio/test_pipeline.py
+++ b/tests/test_asyncio/test_pipeline.py
@@ -7,7 +7,6 @@
 
 
 class TestPipeline:
-    @pytest.mark.onlynoncluster
     async def test_pipeline_is_true(self, r):
         """Ensure pipeline instances are not false-y"""
         async with r.pipeline() as pipe:

From 50245cdc6fecd4f7432e821816c79de23666fe63 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Mon, 11 Dec 2023 00:44:29 +0000
Subject: [PATCH 0814/1164] =?UTF-8?q?Update=20repr=20of=20important=20clas?=
 =?UTF-8?q?ses=20with=20module=20name=20and=20recommended=20"<=20=E2=80=A6?=
 =?UTF-8?q?=20(#3001)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Update repr of important classes with module name and recommended "< ... >" syntax.

* update tests which examine repr

* formatting
---
 redis/asyncio/client.py                    |  5 ++-
 redis/asyncio/connection.py                |  6 ++--
 redis/asyncio/sentinel.py                  | 16 +++++++---
 redis/client.py                            |  5 ++-
 redis/connection.py                        |  6 ++--
 redis/sentinel.py                          | 15 +++++++--
 tests/test_asyncio/test_connection_pool.py | 37 +++++++++-------------
 tests/test_connection_pool.py              | 36 ++++++++-------------
 8 files changed, 66 insertions(+), 60 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 8a8f54dc9c..9724a3dd54 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -337,7 +337,10 @@ def __init__(
         self._single_conn_lock = asyncio.Lock()
 
     def __repr__(self):
-        return f"{self.__class__.__name__}<{self.connection_pool!r}>"
+        return (
+            f"<{self.__class__.__module__}.{self.__class__.__name__}"
+            f"({self.connection_pool!r})>"
+        )
 
     def __await__(self):
         return self.initialize().__await__()
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 77312211a9..739cd7f64e 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -225,7 +225,7 @@ def _close(self):
 
     def __repr__(self):
         repr_args = ",".join((f"{k}={v}" for k, v in self.repr_pieces()))
-        return f"{self.__class__.__name__}<{repr_args}>"
+        return f"<{self.__class__.__module__}.{self.__class__.__name__}({repr_args})>"
 
     @abstractmethod
     def repr_pieces(self):
@@ -1031,8 +1031,8 @@ def __init__(
 
     def __repr__(self):
         return (
-            f"{self.__class__.__name__}"
-            f"<{self.connection_class(**self.connection_kwargs)!r}>"
+            f"<{self.__class__.__module__}.{self.__class__.__name__}"
+            f"({self.connection_class(**self.connection_kwargs)!r})>"
         )
 
     def reset(self):
diff --git a/redis/asyncio/sentinel.py b/redis/asyncio/sentinel.py
index 56f5e9d651..d88babc59c 100644
--- a/redis/asyncio/sentinel.py
+++ b/redis/asyncio/sentinel.py
@@ -30,11 +30,14 @@ def __init__(self, **kwargs):
 
     def __repr__(self):
         pool = self.connection_pool
-        s = f"{self.__class__.__name__}<service={pool.service_name}"
+        s = (
+            f"<{self.__class__.__module__}.{self.__class__.__name__}"
+            f"(service={pool.service_name}"
+        )
         if self.host:
             host_info = f",host={self.host},port={self.port}"
             s += host_info
-        return s + ">"
+        return s + ")>"
 
     async def connect_to(self, address):
         self.host, self.port = address
@@ -120,8 +123,8 @@ def __init__(self, service_name, sentinel_manager, **kwargs):
 
     def __repr__(self):
         return (
-            f"{self.__class__.__name__}"
-            f"<service={self.service_name}({self.is_master and 'master' or 'slave'})>"
+            f"<{self.__class__.__module__}.{self.__class__.__name__}"
+            f"(service={self.service_name}({self.is_master and 'master' or 'slave'}))>"
         )
 
     def reset(self):
@@ -242,7 +245,10 @@ def __repr__(self):
                 f"{sentinel.connection_pool.connection_kwargs['host']}:"
                 f"{sentinel.connection_pool.connection_kwargs['port']}"
             )
-        return f"{self.__class__.__name__}<sentinels=[{','.join(sentinel_addresses)}]>"
+        return (
+            f"<{self.__class__}.{self.__class__.__name__}"
+            f"(sentinels=[{','.join(sentinel_addresses)}])>"
+        )
 
     def check_master_state(self, state: dict, service_name: str) -> bool:
         if not state["is_master"] or state["is_sdown"] or state["is_odown"]:
diff --git a/redis/client.py b/redis/client.py
index 2ff3706d16..53748afbcc 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -334,7 +334,10 @@ def __init__(
             self.cache_whitelist = cache_whitelist
 
     def __repr__(self) -> str:
-        return f"{type(self).__name__}<{repr(self.connection_pool)}>"
+        return (
+            f"<{type(self).__module__}.{type(self).__name__}"
+            f"({repr(self.connection_pool)})>"
+        )
 
     def get_encoder(self) -> "Encoder":
         """Get the connection pool's encoder"""
diff --git a/redis/connection.py b/redis/connection.py
index fead6135e0..8129bf03a4 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -217,7 +217,7 @@ def __init__(
 
     def __repr__(self):
         repr_args = ",".join([f"{k}={v}" for k, v in self.repr_pieces()])
-        return f"{self.__class__.__name__}<{repr_args}>"
+        return f"<{self.__class__.__module__}.{self.__class__.__name__}({repr_args})>"
 
     @abstractmethod
     def repr_pieces(self):
@@ -1004,8 +1004,8 @@ def __init__(
 
     def __repr__(self) -> (str, str):
         return (
-            f"{type(self).__name__}"
-            f"<{repr(self.connection_class(**self.connection_kwargs))}>"
+            f"<{type(self).__module__}.{type(self).__name__}"
+            f"({repr(self.connection_class(**self.connection_kwargs))})>"
         )
 
     def reset(self) -> None:
diff --git a/redis/sentinel.py b/redis/sentinel.py
index a1ae5c5275..dfcd8ff64b 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -24,7 +24,10 @@ def __init__(self, **kwargs):
 
     def __repr__(self):
         pool = self.connection_pool
-        s = f"{type(self).__name__}<service={pool.service_name}%s>"
+        s = (
+            f"<{type(self).__module__}.{type(self).__name__}"
+            f"(service={pool.service_name}%s)>"
+        )
         if self.host:
             host_info = f",host={self.host},port={self.port}"
             s = s % host_info
@@ -162,7 +165,10 @@ def __init__(self, service_name, sentinel_manager, **kwargs):
 
     def __repr__(self):
         role = "master" if self.is_master else "slave"
-        return f"{type(self).__name__}<service={self.service_name}({role})"
+        return (
+            f"<{type(self).__module__}.{type(self).__name__}"
+            f"(service={self.service_name}({role}))>"
+        )
 
     def reset(self):
         super().reset()
@@ -262,7 +268,10 @@ def __repr__(self):
             sentinel_addresses.append(
                 "{host}:{port}".format_map(sentinel.connection_pool.connection_kwargs)
             )
-        return f'{type(self).__name__}<sentinels=[{",".join(sentinel_addresses)}]>'
+        return (
+            f"<{type(self).__module__}.{type(self).__name__}"
+            f'(sentinels=[{",".join(sentinel_addresses)}])>'
+        )
 
     def check_master_state(self, state, service_name):
         if not state["is_master"] or state["is_sdown"] or state["is_odown"]:
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
index ed90fc73fc..5e4d3f206f 100644
--- a/tests/test_asyncio/test_connection_pool.py
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -180,11 +180,8 @@ async def test_repr_contains_db_info_tcp(self):
         async with self.get_pool(
             connection_kwargs=connection_kwargs, connection_class=redis.Connection
         ) as pool:
-            expected = (
-                "ConnectionPool<Connection<"
-                "host=localhost,port=6379,db=1,client_name=test-client>>"
-            )
-            assert repr(pool) == expected
+            expected = "host=localhost,port=6379,db=1,client_name=test-client"
+            assert expected in repr(pool)
 
     async def test_repr_contains_db_info_unix(self):
         connection_kwargs = {"path": "/abc", "db": 1, "client_name": "test-client"}
@@ -192,11 +189,8 @@ async def test_repr_contains_db_info_unix(self):
             connection_kwargs=connection_kwargs,
             connection_class=redis.UnixDomainSocketConnection,
         ) as pool:
-            expected = (
-                "ConnectionPool<UnixDomainSocketConnection<"
-                "path=/abc,db=1,client_name=test-client>>"
-            )
-            assert repr(pool) == expected
+            expected = "path=/abc,db=1,client_name=test-client"
+            assert expected in repr(pool)
 
 
 class TestBlockingConnectionPool:
@@ -293,11 +287,8 @@ def test_repr_contains_db_info_tcp(self):
         pool = redis.ConnectionPool(
             host="localhost", port=6379, client_name="test-client"
         )
-        expected = (
-            "ConnectionPool<Connection<"
-            "host=localhost,port=6379,db=0,client_name=test-client>>"
-        )
-        assert repr(pool) == expected
+        expected = "host=localhost,port=6379,db=0,client_name=test-client"
+        assert expected in repr(pool)
 
     def test_repr_contains_db_info_unix(self):
         pool = redis.ConnectionPool(
@@ -305,11 +296,8 @@ def test_repr_contains_db_info_unix(self):
             path="abc",
             client_name="test-client",
         )
-        expected = (
-            "ConnectionPool<UnixDomainSocketConnection<"
-            "path=abc,db=0,client_name=test-client>>"
-        )
-        assert repr(pool) == expected
+        expected = "path=abc,db=0,client_name=test-client"
+        assert expected in repr(pool)
 
 
 class TestConnectionPoolURLParsing:
@@ -659,7 +647,10 @@ def test_connect_from_url_tcp(self):
         connection = redis.Redis.from_url("redis://localhost")
         pool = connection.connection_pool
 
-        assert re.match("(.*)<(.*)<(.*)>>", repr(pool)).groups() == (
+        print(repr(pool))
+        assert re.match(
+            r"< .*?([^\.]+) \( < .*?([^\.]+) \( (.+) \) > \) >", repr(pool), re.VERBOSE
+        ).groups() == (
             "ConnectionPool",
             "Connection",
             "host=localhost,port=6379,db=0",
@@ -669,7 +660,9 @@ def test_connect_from_url_unix(self):
         connection = redis.Redis.from_url("unix:///path/to/socket")
         pool = connection.connection_pool
 
-        assert re.match("(.*)<(.*)<(.*)>>", repr(pool)).groups() == (
+        assert re.match(
+            r"< .*?([^\.]+) \( < .*?([^\.]+) \( (.+) \) > \) >", repr(pool), re.VERBOSE
+        ).groups() == (
             "ConnectionPool",
             "UnixDomainSocketConnection",
             "path=/path/to/socket,db=0",
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index d1e984ee9c..dee7c554d3 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -95,11 +95,8 @@ def test_repr_contains_db_info_tcp(self):
         pool = self.get_pool(
             connection_kwargs=connection_kwargs, connection_class=redis.Connection
         )
-        expected = (
-            "ConnectionPool<Connection<"
-            "host=localhost,port=6379,db=1,client_name=test-client>>"
-        )
-        assert repr(pool) == expected
+        expected = "host=localhost,port=6379,db=1,client_name=test-client"
+        assert expected in repr(pool)
 
     def test_repr_contains_db_info_unix(self):
         connection_kwargs = {"path": "/abc", "db": 1, "client_name": "test-client"}
@@ -107,11 +104,8 @@ def test_repr_contains_db_info_unix(self):
             connection_kwargs=connection_kwargs,
             connection_class=redis.UnixDomainSocketConnection,
         )
-        expected = (
-            "ConnectionPool<UnixDomainSocketConnection<"
-            "path=/abc,db=1,client_name=test-client>>"
-        )
-        assert repr(pool) == expected
+        expected = "path=/abc,db=1,client_name=test-client"
+        assert expected in repr(pool)
 
 
 class TestBlockingConnectionPool:
@@ -190,11 +184,8 @@ def test_repr_contains_db_info_tcp(self):
         pool = redis.ConnectionPool(
             host="localhost", port=6379, client_name="test-client"
         )
-        expected = (
-            "ConnectionPool<Connection<"
-            "host=localhost,port=6379,db=0,client_name=test-client>>"
-        )
-        assert repr(pool) == expected
+        expected = "host=localhost,port=6379,db=0,client_name=test-client"
+        assert expected in repr(pool)
 
     def test_repr_contains_db_info_unix(self):
         pool = redis.ConnectionPool(
@@ -202,11 +193,8 @@ def test_repr_contains_db_info_unix(self):
             path="abc",
             client_name="test-client",
         )
-        expected = (
-            "ConnectionPool<UnixDomainSocketConnection<"
-            "path=abc,db=0,client_name=test-client>>"
-        )
-        assert repr(pool) == expected
+        expected = "path=abc,db=0,client_name=test-client"
+        assert expected in repr(pool)
 
 
 class TestConnectionPoolURLParsing:
@@ -579,7 +567,9 @@ def test_connect_from_url_tcp(self):
         connection = redis.Redis.from_url("redis://localhost")
         pool = connection.connection_pool
 
-        assert re.match("(.*)<(.*)<(.*)>>", repr(pool)).groups() == (
+        assert re.match(
+            r"< .*?([^\.]+) \( < .*?([^\.]+) \( (.+) \) > \) >", repr(pool), re.VERBOSE
+        ).groups() == (
             "ConnectionPool",
             "Connection",
             "host=localhost,port=6379,db=0",
@@ -589,7 +579,9 @@ def test_connect_from_url_unix(self):
         connection = redis.Redis.from_url("unix:///path/to/socket")
         pool = connection.connection_pool
 
-        assert re.match("(.*)<(.*)<(.*)>>", repr(pool)).groups() == (
+        assert re.match(
+            r"< .*?([^\.]+) \( < .*?([^\.]+) \( (.+) \) > \) >", repr(pool), re.VERBOSE
+        ).groups() == (
             "ConnectionPool",
             "UnixDomainSocketConnection",
             "path=/path/to/socket,db=0",

From fd281e096a000ac9a300747b7ebaed133f126a0b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Mon, 11 Dec 2023 00:45:43 +0000
Subject: [PATCH 0815/1164] Make the connection callback methods public again,
 add documentation (#2980)

---
 CHANGES                     |  1 +
 redis/asyncio/client.py     |  6 +++---
 redis/asyncio/connection.py | 16 ++++++++++++++--
 redis/client.py             |  4 ++--
 redis/cluster.py            |  2 +-
 redis/connection.py         | 16 ++++++++++++++--
 6 files changed, 35 insertions(+), 10 deletions(-)

diff --git a/CHANGES b/CHANGES
index e1496fa15c..7c4b476ec2 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Connection.register_connect_callback() is made public.
     * Fix async `read_response` to use `disable_decoding`.
     * Add 'aclose()' methods to async classes, deprecate async close().
     * Fix #2831, add auto_close_connection_pool=True arg to asyncio.Redis.from_url()
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 9724a3dd54..de27da1714 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -788,7 +788,7 @@ async def __aexit__(self, exc_type, exc_value, traceback):
 
     def __del__(self):
         if self.connection:
-            self.connection._deregister_connect_callback(self.on_connect)
+            self.connection.deregister_connect_callback(self.on_connect)
 
     async def aclose(self):
         # In case a connection property does not yet exist
@@ -799,7 +799,7 @@ async def aclose(self):
         async with self._lock:
             if self.connection:
                 await self.connection.disconnect()
-                self.connection._deregister_connect_callback(self.on_connect)
+                self.connection.deregister_connect_callback(self.on_connect)
                 await self.connection_pool.release(self.connection)
                 self.connection = None
             self.channels = {}
@@ -862,7 +862,7 @@ async def connect(self):
             )
             # register a callback that re-subscribes to any channels we
             # were listening to when we were disconnected
-            self.connection._register_connect_callback(self.on_connect)
+            self.connection.register_connect_callback(self.on_connect)
         else:
             await self.connection.connect()
         if self.push_handler_func is not None and not HIREDIS_AVAILABLE:
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 739cd7f64e..bbd438fc0b 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -235,12 +235,24 @@ def repr_pieces(self):
     def is_connected(self):
         return self._reader is not None and self._writer is not None
 
-    def _register_connect_callback(self, callback):
+    def register_connect_callback(self, callback):
+        """
+        Register a callback to be called when the connection is established either
+        initially or reconnected.  This allows listeners to issue commands that
+        are ephemeral to the connection, for example pub/sub subscription or
+        key tracking.  The callback must be a _method_ and will be kept as
+        a weak reference.
+        """
         wm = weakref.WeakMethod(callback)
         if wm not in self._connect_callbacks:
             self._connect_callbacks.append(wm)
 
-    def _deregister_connect_callback(self, callback):
+    def deregister_connect_callback(self, callback):
+        """
+        De-register a previously registered callback.  It will no-longer receive
+        notifications on connection events.  Calling this is not required when the
+        listener goes away, since the callbacks are kept as weak methods.
+        """
         try:
             self._connect_callbacks.remove(weakref.WeakMethod(callback))
         except ValueError:
diff --git a/redis/client.py b/redis/client.py
index 53748afbcc..0af7e050d6 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -759,7 +759,7 @@ def __del__(self) -> None:
     def reset(self) -> None:
         if self.connection:
             self.connection.disconnect()
-            self.connection._deregister_connect_callback(self.on_connect)
+            self.connection.deregister_connect_callback(self.on_connect)
             self.connection_pool.release(self.connection)
             self.connection = None
         self.health_check_response_counter = 0
@@ -817,7 +817,7 @@ def execute_command(self, *args):
             )
             # register a callback that re-subscribes to any channels we
             # were listening to when we were disconnected
-            self.connection._register_connect_callback(self.on_connect)
+            self.connection.register_connect_callback(self.on_connect)
             if self.push_handler_func is not None and not HIREDIS_AVAILABLE:
                 self.connection._parser.set_push_handler(self.push_handler_func)
         connection = self.connection
diff --git a/redis/cluster.py b/redis/cluster.py
index 595efcb683..0405b0547c 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -1776,7 +1776,7 @@ def execute_command(self, *args):
             )
             # register a callback that re-subscribes to any channels we
             # were listening to when we were disconnected
-            self.connection._register_connect_callback(self.on_connect)
+            self.connection.register_connect_callback(self.on_connect)
             if self.push_handler_func is not None and not HIREDIS_AVAILABLE:
                 self.connection._parser.set_push_handler(self.push_handler_func)
         connection = self.connection
diff --git a/redis/connection.py b/redis/connection.py
index 8129bf03a4..c201224e35 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -237,12 +237,24 @@ def _construct_command_packer(self, packer):
         else:
             return PythonRespSerializer(self._buffer_cutoff, self.encoder.encode)
 
-    def _register_connect_callback(self, callback):
+    def register_connect_callback(self, callback):
+        """
+        Register a callback to be called when the connection is established either
+        initially or reconnected.  This allows listeners to issue commands that
+        are ephemeral to the connection, for example pub/sub subscription or
+        key tracking.  The callback must be a _method_ and will be kept as
+        a weak reference.
+        """
         wm = weakref.WeakMethod(callback)
         if wm not in self._connect_callbacks:
             self._connect_callbacks.append(wm)
 
-    def _deregister_connect_callback(self, callback):
+    def deregister_connect_callback(self, callback):
+        """
+        De-register a previously registered callback.  It will no-longer receive
+        notifications on connection events.  Calling this is not required when the
+        listener goes away, since the callbacks are kept as weak methods.
+        """
         try:
             self._connect_callbacks.remove(weakref.WeakMethod(callback))
         except ValueError:

From d5a59cdea8e35137beaecd0e6135607c80f08486 Mon Sep 17 00:00:00 2001
From: Zachary Ware <zachary.ware@gmail.com>
Date: Sun, 10 Dec 2023 18:46:00 -0600
Subject: [PATCH 0816/1164] Fix reported version of deprecations in
 asyncio.client (#2968)

---
 redis/asyncio/client.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index de27da1714..9e0491f810 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -168,7 +168,7 @@ class initializer. In the case of conflicting arguments, querystring
             warnings.warn(
                 DeprecationWarning(
                     '"auto_close_connection_pool" is deprecated '
-                    "since version 5.0.0. "
+                    "since version 5.0.1. "
                     "Please create a ConnectionPool explicitly and "
                     "provide to the Redis() constructor instead."
                 )
@@ -247,7 +247,7 @@ def __init__(
             warnings.warn(
                 DeprecationWarning(
                     '"auto_close_connection_pool" is deprecated '
-                    "since version 5.0.0. "
+                    "since version 5.0.1. "
                     "Please create a ConnectionPool explicitly and "
                     "provide to the Redis() constructor instead."
                 )
@@ -569,7 +569,7 @@ async def aclose(self, close_connection_pool: Optional[bool] = None) -> None:
         ):
             await self.connection_pool.disconnect()
 
-    @deprecated_function(version="5.0.0", reason="Use aclose() instead", name="close")
+    @deprecated_function(version="5.0.1", reason="Use aclose() instead", name="close")
     async def close(self, close_connection_pool: Optional[bool] = None) -> None:
         """
         Alias for aclose(), for backwards compatibility
@@ -807,12 +807,12 @@ async def aclose(self):
             self.patterns = {}
             self.pending_unsubscribe_patterns = set()
 
-    @deprecated_function(version="5.0.0", reason="Use aclose() instead", name="close")
+    @deprecated_function(version="5.0.1", reason="Use aclose() instead", name="close")
     async def close(self) -> None:
         """Alias for aclose(), for backwards compatibility"""
         await self.aclose()
 
-    @deprecated_function(version="5.0.0", reason="Use aclose() instead", name="reset")
+    @deprecated_function(version="5.0.1", reason="Use aclose() instead", name="reset")
     async def reset(self) -> None:
         """Alias for aclose(), for backwards compatibility"""
         await self.aclose()

From a1df1cf47808fd55150d4983dba3437b329f9d15 Mon Sep 17 00:00:00 2001
From: "Tyler Bream (Event pipeline)"
 <97038416+tbbream@users.noreply.github.com>
Date: Sun, 10 Dec 2023 19:47:43 -0500
Subject: [PATCH 0817/1164] Allow the parsing of the asking command to forward
 original options (#3012)

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/_parsers/helpers.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/_parsers/helpers.py b/redis/_parsers/helpers.py
index fb5da831fe..bdd749a5bc 100644
--- a/redis/_parsers/helpers.py
+++ b/redis/_parsers/helpers.py
@@ -322,7 +322,7 @@ def float_or_none(response):
     return float(response)
 
 
-def bool_ok(response):
+def bool_ok(response, **options):
     return str_if_bytes(response) == "OK"
 
 

From 5fec523455643e1b6a9daa11fa74d3317da7e233 Mon Sep 17 00:00:00 2001
From: Binbin <binloveplay1314@qq.com>
Date: Tue, 12 Dec 2023 06:41:59 +0800
Subject: [PATCH 0818/1164] Fix Specifying Target Nodes broken hyperlink
 (#3072)

The typo cause hyperlinks to fail.
---
 docs/clustering.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/clustering.rst b/docs/clustering.rst
index 9b4dee1c9f..f8320e4e59 100644
--- a/docs/clustering.rst
+++ b/docs/clustering.rst
@@ -92,7 +92,7 @@ The ‘target_nodes’ parameter is explained in the following section,
    >>> # target-node: default-node
    >>> rc.ping()
 
-Specfiying Target Nodes
+Specifying Target Nodes
 -----------------------
 
 As mentioned above, all non key-based RedisCluster commands accept the

From f6a4b49bff925225ec64694414d3f09b847863df Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?P=C3=A1rmenas=20Haniel?=
 <42049025+parmenashp@users.noreply.github.com>
Date: Mon, 11 Dec 2023 19:42:39 -0300
Subject: [PATCH 0819/1164] Fix return types in json commands (#3071)

* Fix return types in JSONCommands class

* Update CHANGES
---
 CHANGES                         | 1 +
 redis/commands/json/commands.py | 6 +++---
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/CHANGES b/CHANGES
index 7c4b476ec2..9e0db230c6 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Fix return types for `get`, `set_path` and `strappend` in JSONCommands
     * Connection.register_connect_callback() is made public.
     * Fix async `read_response` to use `disable_decoding`.
     * Add 'aclose()' methods to async classes, deprecate async close().
diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index ef0cb205a5..4c2e58369c 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -173,7 +173,7 @@ def delete(self, key: str, path: Optional[str] = Path.root_path()) -> int:
 
     def get(
         self, name: str, *args, no_escape: Optional[bool] = False
-    ) -> List[JsonType]:
+    ) -> Optional[List[JsonType]]:
         """
         Get the object stored as a JSON value at key ``name``.
 
@@ -324,7 +324,7 @@ def set_path(
         nx: Optional[bool] = False,
         xx: Optional[bool] = False,
         decode_keys: Optional[bool] = False,
-    ) -> List[Dict[str, bool]]:
+    ) -> Dict[str, bool]:
         """
         Iterate over ``root_folder`` and set each JSON file to a value
         under ``json_path`` with the file name as the key.
@@ -377,7 +377,7 @@ def toggle(
         return self.execute_command("JSON.TOGGLE", name, str(path))
 
     def strappend(
-        self, name: str, value: str, path: Optional[int] = Path.root_path()
+        self, name: str, value: str, path: Optional[str] = Path.root_path()
     ) -> Union[int, List[Optional[int]]]:
         """Append to the string JSON value. If two options are specified after
         the key name, the path is determined to be the first. If a single

From 53de3086f7a2176dea1e804676d2eb7f618c41cf Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 1 Jan 2024 12:13:04 +0200
Subject: [PATCH 0820/1164] Client side caching invalidations (standalone)
 (#3089)

* cache invalidations

* isort

* deamon thread

* remove threads

* delete comment

* tests

* skip if hiredis available

* async

* review comments

* docstring

* decode test

* fix test

* fix decode response test
---
 redis/__init__.py                |   2 -
 redis/_parsers/resp3.py          |  66 ++++++++++------
 redis/asyncio/client.py          | 131 ++++++++++++++++++++++++++-----
 redis/asyncio/connection.py      |   4 +
 redis/cache.py                   |  18 +++--
 redis/client.py                  |  37 +++++++--
 redis/cluster.py                 |   2 +-
 redis/connection.py              |   6 ++
 tests/test_asyncio/test_cache.py | 129 ++++++++++++++++++++++++++++++
 tests/test_cache.py              | 119 ++++++++++++++++++++++++++++
 10 files changed, 457 insertions(+), 57 deletions(-)
 create mode 100644 tests/test_asyncio/test_cache.py
 create mode 100644 tests/test_cache.py

diff --git a/redis/__init__.py b/redis/__init__.py
index 7bf6839453..495d2d99bb 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -2,7 +2,6 @@
 
 from redis import asyncio  # noqa
 from redis.backoff import default_backoff
-from redis.cache import _LocalChace
 from redis.client import Redis, StrictRedis
 from redis.cluster import RedisCluster
 from redis.connection import (
@@ -62,7 +61,6 @@ def int_or_str(value):
     VERSION = tuple([99, 99, 99])
 
 __all__ = [
-    "_LocalChace",
     "AuthenticationError",
     "AuthenticationWrongNumberOfArgsError",
     "BlockingConnectionPool",
diff --git a/redis/_parsers/resp3.py b/redis/_parsers/resp3.py
index 569e7ee679..13aa1ffccb 100644
--- a/redis/_parsers/resp3.py
+++ b/redis/_parsers/resp3.py
@@ -6,15 +6,18 @@
 from .base import _AsyncRESPBase, _RESPBase
 from .socket import SERVER_CLOSED_CONNECTION_ERROR
 
+_INVALIDATION_MESSAGE = [b"invalidate", "invalidate"]
+
 
 class _RESP3Parser(_RESPBase):
     """RESP3 protocol implementation"""
 
     def __init__(self, socket_read_size):
         super().__init__(socket_read_size)
-        self.push_handler_func = self.handle_push_response
+        self.pubsub_push_handler_func = self.handle_pubsub_push_response
+        self.invalidations_push_handler_func = None
 
-    def handle_push_response(self, response):
+    def handle_pubsub_push_response(self, response):
         logger = getLogger("push_response")
         logger.info("Push response: " + str(response))
         return response
@@ -114,13 +117,7 @@ def _read_response(self, disable_decoding=False, push_request=False):
                 )
                 for _ in range(int(response))
             ]
-            res = self.push_handler_func(response)
-            if not push_request:
-                return self._read_response(
-                    disable_decoding=disable_decoding, push_request=push_request
-                )
-            else:
-                return res
+            self.handle_push_response(response, disable_decoding, push_request)
         else:
             raise InvalidResponse(f"Protocol Error: {raw!r}")
 
@@ -128,16 +125,32 @@ def _read_response(self, disable_decoding=False, push_request=False):
             response = self.encoder.decode(response)
         return response
 
-    def set_push_handler(self, push_handler_func):
-        self.push_handler_func = push_handler_func
+    def handle_push_response(self, response, disable_decoding, push_request):
+        if response[0] in _INVALIDATION_MESSAGE:
+            res = self.invalidation_push_handler_func(response)
+        else:
+            res = self.pubsub_push_handler_func(response)
+        if not push_request:
+            return self._read_response(
+                disable_decoding=disable_decoding, push_request=push_request
+            )
+        else:
+            return res
+
+    def set_pubsub_push_handler(self, pubsub_push_handler_func):
+        self.pubsub_push_handler_func = pubsub_push_handler_func
+
+    def set_invalidation_push_handler(self, invalidations_push_handler_func):
+        self.invalidation_push_handler_func = invalidations_push_handler_func
 
 
 class _AsyncRESP3Parser(_AsyncRESPBase):
     def __init__(self, socket_read_size):
         super().__init__(socket_read_size)
-        self.push_handler_func = self.handle_push_response
+        self.pubsub_push_handler_func = self.handle_pubsub_push_response
+        self.invalidations_push_handler_func = None
 
-    def handle_push_response(self, response):
+    def handle_pubsub_push_response(self, response):
         logger = getLogger("push_response")
         logger.info("Push response: " + str(response))
         return response
@@ -246,13 +259,7 @@ async def _read_response(
                 )
                 for _ in range(int(response))
             ]
-            res = self.push_handler_func(response)
-            if not push_request:
-                return await self._read_response(
-                    disable_decoding=disable_decoding, push_request=push_request
-                )
-            else:
-                return res
+            await self.handle_push_response(response, disable_decoding, push_request)
         else:
             raise InvalidResponse(f"Protocol Error: {raw!r}")
 
@@ -260,5 +267,20 @@ async def _read_response(
             response = self.encoder.decode(response)
         return response
 
-    def set_push_handler(self, push_handler_func):
-        self.push_handler_func = push_handler_func
+    async def handle_push_response(self, response, disable_decoding, push_request):
+        if response[0] in _INVALIDATION_MESSAGE:
+            res = self.invalidation_push_handler_func(response)
+        else:
+            res = self.pubsub_push_handler_func(response)
+        if not push_request:
+            return await self._read_response(
+                disable_decoding=disable_decoding, push_request=push_request
+            )
+        else:
+            return res
+
+    def set_pubsub_push_handler(self, pubsub_push_handler_func):
+        self.pubsub_push_handler_func = pubsub_push_handler_func
+
+    def set_invalidation_push_handler(self, invalidations_push_handler_func):
+        self.invalidation_push_handler_func = invalidations_push_handler_func
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 9e0491f810..eea9612f4a 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -37,6 +37,12 @@
 )
 from redis.asyncio.lock import Lock
 from redis.asyncio.retry import Retry
+from redis.cache import (
+    DEFAULT_BLACKLIST,
+    DEFAULT_EVICTION_POLICY,
+    DEFAULT_WHITELIST,
+    _LocalCache,
+)
 from redis.client import (
     EMPTY_RESPONSE,
     NEVER_DECODE,
@@ -60,7 +66,7 @@
     TimeoutError,
     WatchError,
 )
-from redis.typing import ChannelT, EncodableT, KeyT
+from redis.typing import ChannelT, EncodableT, KeysT, KeyT, ResponseT
 from redis.utils import (
     HIREDIS_AVAILABLE,
     _set_info_logger,
@@ -231,6 +237,13 @@ def __init__(
         redis_connect_func=None,
         credential_provider: Optional[CredentialProvider] = None,
         protocol: Optional[int] = 2,
+        cache_enable: bool = False,
+        client_cache: Optional[_LocalCache] = None,
+        cache_max_size: int = 100,
+        cache_ttl: int = 0,
+        cache_eviction_policy: str = DEFAULT_EVICTION_POLICY,
+        cache_blacklist: List[str] = DEFAULT_BLACKLIST,
+        cache_whitelist: List[str] = DEFAULT_WHITELIST,
     ):
         """
         Initialize a new Redis client.
@@ -336,6 +349,16 @@ def __init__(
         # on a set of redis commands
         self._single_conn_lock = asyncio.Lock()
 
+        self.client_cache = client_cache
+        if cache_enable:
+            self.client_cache = _LocalCache(
+                cache_max_size, cache_ttl, cache_eviction_policy
+            )
+        if self.client_cache is not None:
+            self.cache_blacklist = cache_blacklist
+            self.cache_whitelist = cache_whitelist
+            self.client_cache_initialized = False
+
     def __repr__(self):
         return (
             f"<{self.__class__.__module__}.{self.__class__.__name__}"
@@ -350,6 +373,10 @@ async def initialize(self: _RedisT) -> _RedisT:
             async with self._single_conn_lock:
                 if self.connection is None:
                     self.connection = await self.connection_pool.get_connection("_")
+            if self.client_cache is not None:
+                self.connection._parser.set_invalidation_push_handler(
+                    self._cache_invalidation_process
+                )
         return self
 
     def set_response_callback(self, command: str, callback: ResponseCallbackT):
@@ -568,6 +595,8 @@ async def aclose(self, close_connection_pool: Optional[bool] = None) -> None:
             close_connection_pool is None and self.auto_close_connection_pool
         ):
             await self.connection_pool.disconnect()
+        if self.client_cache:
+            self.client_cache.flush()
 
     @deprecated_function(version="5.0.1", reason="Use aclose() instead", name="close")
     async def close(self, close_connection_pool: Optional[bool] = None) -> None:
@@ -596,29 +625,95 @@ async def _disconnect_raise(self, conn: Connection, error: Exception):
         ):
             raise error
 
+    def _cache_invalidation_process(
+        self, data: List[Union[str, Optional[List[str]]]]
+    ) -> None:
+        """
+        Invalidate (delete) all redis commands associated with a specific key.
+        `data` is a list of strings, where the first string is the invalidation message
+        and the second string is the list of keys to invalidate.
+        (if the list of keys is None, then all keys are invalidated)
+        """
+        if data[1] is not None:
+            for key in data[1]:
+                self.client_cache.invalidate(str_if_bytes(key))
+            else:
+                self.client_cache.flush()
+
+    async def _get_from_local_cache(self, command: str):
+        """
+        If the command is in the local cache, return the response
+        """
+        if (
+            self.client_cache is None
+            or command[0] in self.cache_blacklist
+            or command[0] not in self.cache_whitelist
+        ):
+            return None
+        while not self.connection._is_socket_empty():
+            await self.connection.read_response(push_request=True)
+        return self.client_cache.get(command)
+
+    def _add_to_local_cache(
+        self, command: Tuple[str], response: ResponseT, keys: List[KeysT]
+    ):
+        """
+        Add the command and response to the local cache if the command
+        is allowed to be cached
+        """
+        if (
+            self.client_cache is not None
+            and (self.cache_blacklist == [] or command[0] not in self.cache_blacklist)
+            and (self.cache_whitelist == [] or command[0] in self.cache_whitelist)
+        ):
+            self.client_cache.set(command, response, keys)
+
+    def delete_from_local_cache(self, command: str):
+        """
+        Delete the command from the local cache
+        """
+        try:
+            self.client_cache.delete(command)
+        except AttributeError:
+            pass
+
     # COMMAND EXECUTION AND PROTOCOL PARSING
     async def execute_command(self, *args, **options):
         """Execute a command and return a parsed response"""
         await self.initialize()
-        options.pop("keys", None)  # the keys are used only for client side caching
-        pool = self.connection_pool
         command_name = args[0]
-        conn = self.connection or await pool.get_connection(command_name, **options)
+        keys = options.pop("keys", None)  # keys are used only for client side caching
+        response_from_cache = await self._get_from_local_cache(args)
+        if response_from_cache is not None:
+            return response_from_cache
+        else:
+            pool = self.connection_pool
+            conn = self.connection or await pool.get_connection(command_name, **options)
 
-        if self.single_connection_client:
-            await self._single_conn_lock.acquire()
-        try:
-            return await conn.retry.call_with_retry(
-                lambda: self._send_command_parse_response(
-                    conn, command_name, *args, **options
-                ),
-                lambda error: self._disconnect_raise(conn, error),
-            )
-        finally:
             if self.single_connection_client:
-                self._single_conn_lock.release()
-            if not self.connection:
-                await pool.release(conn)
+                await self._single_conn_lock.acquire()
+            try:
+                if self.client_cache is not None and not self.client_cache_initialized:
+                    await conn.retry.call_with_retry(
+                        lambda: self._send_command_parse_response(
+                            conn, "CLIENT", *("CLIENT", "TRACKING", "ON")
+                        ),
+                        lambda error: self._disconnect_raise(conn, error),
+                    )
+                    self.client_cache_initialized = True
+                response = await conn.retry.call_with_retry(
+                    lambda: self._send_command_parse_response(
+                        conn, command_name, *args, **options
+                    ),
+                    lambda error: self._disconnect_raise(conn, error),
+                )
+                self._add_to_local_cache(args, response, keys)
+                return response
+            finally:
+                if self.single_connection_client:
+                    self._single_conn_lock.release()
+                if not self.connection:
+                    await pool.release(conn)
 
     async def parse_response(
         self, connection: Connection, command_name: Union[str, bytes], **options
@@ -866,7 +961,7 @@ async def connect(self):
         else:
             await self.connection.connect()
         if self.push_handler_func is not None and not HIREDIS_AVAILABLE:
-            self.connection._parser.set_push_handler(self.push_handler_func)
+            self.connection._parser.set_pubsub_push_handler(self.push_handler_func)
 
     async def _disconnect_raise_connect(self, conn, error):
         """
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index bbd438fc0b..39f75a5f13 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -645,6 +645,10 @@ def pack_commands(self, commands: Iterable[Iterable[EncodableT]]) -> List[bytes]
             output.append(SYM_EMPTY.join(pieces))
         return output
 
+    def _is_socket_empty(self):
+        """Check if the socket is empty"""
+        return not self._reader.at_eof()
+
 
 class Connection(AbstractConnection):
     "Manages TCP communication to and from a Redis server"
diff --git a/redis/cache.py b/redis/cache.py
index 5a689d0ebd..d920702339 100644
--- a/redis/cache.py
+++ b/redis/cache.py
@@ -159,7 +159,7 @@ class EvictionPolicy(Enum):
     RANDOM = "random"
 
 
-class _LocalChace:
+class _LocalCache:
     """
     A caching mechanism for storing redis commands and their responses.
 
@@ -220,6 +220,7 @@ def get(self, command: str) -> ResponseT:
         if command in self.cache:
             if self._is_expired(command):
                 self.delete(command)
+                return
             self._update_access(command)
             return self.cache[command]["response"]
 
@@ -266,28 +267,28 @@ def _update_access(self, command: str):
         Args:
             command (str): The redis command.
         """
-        if self.eviction_policy == EvictionPolicy.LRU:
+        if self.eviction_policy == EvictionPolicy.LRU.value:
             self.cache.move_to_end(command)
-        elif self.eviction_policy == EvictionPolicy.LFU:
+        elif self.eviction_policy == EvictionPolicy.LFU.value:
             self.cache[command]["access_count"] = (
                 self.cache.get(command, {}).get("access_count", 0) + 1
             )
             self.cache.move_to_end(command)
-        elif self.eviction_policy == EvictionPolicy.RANDOM:
+        elif self.eviction_policy == EvictionPolicy.RANDOM.value:
             pass  # Random eviction doesn't require updates
 
     def _evict(self):
         """Evict a redis command from the cache based on the eviction policy."""
         if self._is_expired(self.commands_ttl_list[0]):
             self.delete(self.commands_ttl_list[0])
-        elif self.eviction_policy == EvictionPolicy.LRU:
+        elif self.eviction_policy == EvictionPolicy.LRU.value:
             self.cache.popitem(last=False)
-        elif self.eviction_policy == EvictionPolicy.LFU:
+        elif self.eviction_policy == EvictionPolicy.LFU.value:
             min_access_command = min(
                 self.cache, key=lambda k: self.cache[k].get("access_count", 0)
             )
             self.cache.pop(min_access_command)
-        elif self.eviction_policy == EvictionPolicy.RANDOM:
+        elif self.eviction_policy == EvictionPolicy.RANDOM.value:
             random_command = random.choice(list(self.cache.keys()))
             self.cache.pop(random_command)
 
@@ -322,5 +323,6 @@ def invalidate(self, key: KeyT):
         """
         if key not in self.key_commands_map:
             return
-        for command in self.key_commands_map[key]:
+        commands = list(self.key_commands_map[key])
+        for command in commands:
             self.delete(command)
diff --git a/redis/client.py b/redis/client.py
index 0af7e050d6..7f2c8d290d 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -4,7 +4,7 @@
 import time
 import warnings
 from itertools import chain
-from typing import Any, Callable, Dict, List, Optional, Type, Union
+from typing import Any, Callable, Dict, List, Optional, Tuple, Type, Union
 
 from redis._parsers.encoders import Encoder
 from redis._parsers.helpers import (
@@ -17,7 +17,7 @@
     DEFAULT_BLACKLIST,
     DEFAULT_EVICTION_POLICY,
     DEFAULT_WHITELIST,
-    _LocalChace,
+    _LocalCache,
 )
 from redis.commands import (
     CoreCommands,
@@ -211,7 +211,7 @@ def __init__(
         credential_provider: Optional[CredentialProvider] = None,
         protocol: Optional[int] = 2,
         cache_enable: bool = False,
-        client_cache: Optional[_LocalChace] = None,
+        client_cache: Optional[_LocalCache] = None,
         cache_max_size: int = 100,
         cache_ttl: int = 0,
         cache_eviction_policy: str = DEFAULT_EVICTION_POLICY,
@@ -326,12 +326,16 @@ def __init__(
 
         self.client_cache = client_cache
         if cache_enable:
-            self.client_cache = _LocalChace(
+            self.client_cache = _LocalCache(
                 cache_max_size, cache_ttl, cache_eviction_policy
             )
         if self.client_cache is not None:
             self.cache_blacklist = cache_blacklist
             self.cache_whitelist = cache_whitelist
+            self.client_tracking_on()
+            self.connection._parser.set_invalidation_push_handler(
+                self._cache_invalidation_process
+            )
 
     def __repr__(self) -> str:
         return (
@@ -358,6 +362,21 @@ def set_response_callback(self, command: str, callback: Callable) -> None:
         """Set a custom Response Callback"""
         self.response_callbacks[command] = callback
 
+    def _cache_invalidation_process(
+        self, data: List[Union[str, Optional[List[str]]]]
+    ) -> None:
+        """
+        Invalidate (delete) all redis commands associated with a specific key.
+        `data` is a list of strings, where the first string is the invalidation message
+        and the second string is the list of keys to invalidate.
+        (if the list of keys is None, then all keys are invalidated)
+        """
+        if data[1] is not None:
+            for key in data[1]:
+                self.client_cache.invalidate(str_if_bytes(key))
+            else:
+                self.client_cache.flush()
+
     def load_external_module(self, funcname, func) -> None:
         """
         This function can be used to add externally defined redis modules,
@@ -530,6 +549,8 @@ def close(self):
 
         if self.auto_close_connection_pool:
             self.connection_pool.disconnect()
+        if self.client_cache:
+            self.client_cache.flush()
 
     def _send_command_parse_response(self, conn, command_name, *args, **options):
         """
@@ -561,9 +582,13 @@ def _get_from_local_cache(self, command: str):
             or command[0] not in self.cache_whitelist
         ):
             return None
+        while not self.connection._is_socket_empty():
+            self.connection.read_response(push_request=True)
         return self.client_cache.get(command)
 
-    def _add_to_local_cache(self, command: str, response: ResponseT, keys: List[KeysT]):
+    def _add_to_local_cache(
+        self, command: Tuple[str], response: ResponseT, keys: List[KeysT]
+    ):
         """
         Add the command and response to the local cache if the command
         is allowed to be cached
@@ -819,7 +844,7 @@ def execute_command(self, *args):
             # were listening to when we were disconnected
             self.connection.register_connect_callback(self.on_connect)
             if self.push_handler_func is not None and not HIREDIS_AVAILABLE:
-                self.connection._parser.set_push_handler(self.push_handler_func)
+                self.connection._parser.set_pubsub_push_handler(self.push_handler_func)
         connection = self.connection
         kwargs = {"check_health": not self.subscribed}
         if not self.subscribed:
diff --git a/redis/cluster.py b/redis/cluster.py
index 0405b0547c..8032173e66 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -1778,7 +1778,7 @@ def execute_command(self, *args):
             # were listening to when we were disconnected
             self.connection.register_connect_callback(self.on_connect)
             if self.push_handler_func is not None and not HIREDIS_AVAILABLE:
-                self.connection._parser.set_push_handler(self.push_handler_func)
+                self.connection._parser.set_pubsub_push_handler(self.push_handler_func)
         connection = self.connection
         self._execute(connection, connection.send_command, *args)
 
diff --git a/redis/connection.py b/redis/connection.py
index c201224e35..35a4ff4a37 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1,5 +1,6 @@
 import copy
 import os
+import select
 import socket
 import ssl
 import sys
@@ -572,6 +573,11 @@ def pack_commands(self, commands):
             output.append(SYM_EMPTY.join(pieces))
         return output
 
+    def _is_socket_empty(self):
+        """Check if the socket is empty"""
+        r, _, _ = select.select([self._sock], [], [], 0)
+        return not bool(r)
+
 
 class Connection(AbstractConnection):
     "Manages TCP communication to and from a Redis server"
diff --git a/tests/test_asyncio/test_cache.py b/tests/test_asyncio/test_cache.py
new file mode 100644
index 0000000000..c837acfed1
--- /dev/null
+++ b/tests/test_asyncio/test_cache.py
@@ -0,0 +1,129 @@
+import time
+
+import pytest
+import redis.asyncio as redis
+from redis.utils import HIREDIS_AVAILABLE
+
+
+@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+async def test_get_from_cache():
+    r = redis.Redis(cache_enable=True, single_connection_client=True, protocol=3)
+    r2 = redis.Redis(protocol=3)
+    # add key to redis
+    await r.set("foo", "bar")
+    # get key from redis and save in local cache
+    assert await r.get("foo") == b"bar"
+    # get key from local cache
+    assert r.client_cache.get(("GET", "foo")) == b"bar"
+    # change key in redis (cause invalidation)
+    await r2.set("foo", "barbar")
+    # send any command to redis (process invalidation in background)
+    await r.ping()
+    # the command is not in the local cache anymore
+    assert r.client_cache.get(("GET", "foo")) is None
+    # get key from redis
+    assert await r.get("foo") == b"barbar"
+
+    await r.aclose()
+
+
+@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+async def test_cache_max_size():
+    r = redis.Redis(
+        cache_enable=True, cache_max_size=3, single_connection_client=True, protocol=3
+    )
+    # add 3 keys to redis
+    await r.set("foo", "bar")
+    await r.set("foo2", "bar2")
+    await r.set("foo3", "bar3")
+    # get 3 keys from redis and save in local cache
+    assert await r.get("foo") == b"bar"
+    assert await r.get("foo2") == b"bar2"
+    assert await r.get("foo3") == b"bar3"
+    # get the 3 keys from local cache
+    assert r.client_cache.get(("GET", "foo")) == b"bar"
+    assert r.client_cache.get(("GET", "foo2")) == b"bar2"
+    assert r.client_cache.get(("GET", "foo3")) == b"bar3"
+    # add 1 more key to redis (exceed the max size)
+    await r.set("foo4", "bar4")
+    assert await r.get("foo4") == b"bar4"
+    # the first key is not in the local cache anymore
+    assert r.client_cache.get(("GET", "foo")) is None
+
+    await r.aclose()
+
+
+@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+async def test_cache_ttl():
+    r = redis.Redis(
+        cache_enable=True, cache_ttl=1, single_connection_client=True, protocol=3
+    )
+    # add key to redis
+    await r.set("foo", "bar")
+    # get key from redis and save in local cache
+    assert await r.get("foo") == b"bar"
+    # get key from local cache
+    assert r.client_cache.get(("GET", "foo")) == b"bar"
+    # wait for the key to expire
+    time.sleep(1)
+    # the key is not in the local cache anymore
+    assert r.client_cache.get(("GET", "foo")) is None
+
+    await r.aclose()
+
+
+@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+async def test_cache_lfu_eviction():
+    r = redis.Redis(
+        cache_enable=True,
+        cache_max_size=3,
+        cache_eviction_policy="lfu",
+        single_connection_client=True,
+        protocol=3,
+    )
+    # add 3 keys to redis
+    await r.set("foo", "bar")
+    await r.set("foo2", "bar2")
+    await r.set("foo3", "bar3")
+    # get 3 keys from redis and save in local cache
+    assert await r.get("foo") == b"bar"
+    assert await r.get("foo2") == b"bar2"
+    assert await r.get("foo3") == b"bar3"
+    # change the order of the keys in the cache
+    assert r.client_cache.get(("GET", "foo")) == b"bar"
+    assert r.client_cache.get(("GET", "foo")) == b"bar"
+    assert r.client_cache.get(("GET", "foo3")) == b"bar3"
+    # add 1 more key to redis (exceed the max size)
+    await r.set("foo4", "bar4")
+    assert await r.get("foo4") == b"bar4"
+    # test the eviction policy
+    assert len(r.client_cache.cache) == 3
+    assert r.client_cache.get(("GET", "foo")) == b"bar"
+    assert r.client_cache.get(("GET", "foo2")) is None
+
+    await r.aclose()
+
+
+@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+async def test_cache_decode_response():
+    r = redis.Redis(
+        decode_responses=True,
+        cache_enable=True,
+        single_connection_client=True,
+        protocol=3,
+    )
+    await r.set("foo", "bar")
+    # get key from redis and save in local cache
+    assert await r.get("foo") == "bar"
+    # get key from local cache
+    assert r.client_cache.get(("GET", "foo")) == "bar"
+    # change key in redis (cause invalidation)
+    await r.set("foo", "barbar")
+    # send any command to redis (process invalidation in background)
+    await r.ping()
+    # the command is not in the local cache anymore
+    assert r.client_cache.get(("GET", "foo")) is None
+    # get key from redis
+    assert await r.get("foo") == "barbar"
+
+    await r.aclose()
diff --git a/tests/test_cache.py b/tests/test_cache.py
new file mode 100644
index 0000000000..45621fe77e
--- /dev/null
+++ b/tests/test_cache.py
@@ -0,0 +1,119 @@
+import time
+
+import pytest
+import redis
+from redis.utils import HIREDIS_AVAILABLE
+
+
+@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+def test_get_from_cache():
+    r = redis.Redis(cache_enable=True, single_connection_client=True, protocol=3)
+    r2 = redis.Redis(protocol=3)
+    # add key to redis
+    r.set("foo", "bar")
+    # get key from redis and save in local cache
+    assert r.get("foo") == b"bar"
+    # get key from local cache
+    assert r.client_cache.get(("GET", "foo")) == b"bar"
+    # change key in redis (cause invalidation)
+    r2.set("foo", "barbar")
+    # send any command to redis (process invalidation in background)
+    r.ping()
+    # the command is not in the local cache anymore
+    assert r.client_cache.get(("GET", "foo")) is None
+    # get key from redis
+    assert r.get("foo") == b"barbar"
+
+
+@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+def test_cache_max_size():
+    r = redis.Redis(
+        cache_enable=True, cache_max_size=3, single_connection_client=True, protocol=3
+    )
+    # add 3 keys to redis
+    r.set("foo", "bar")
+    r.set("foo2", "bar2")
+    r.set("foo3", "bar3")
+    # get 3 keys from redis and save in local cache
+    assert r.get("foo") == b"bar"
+    assert r.get("foo2") == b"bar2"
+    assert r.get("foo3") == b"bar3"
+    # get the 3 keys from local cache
+    assert r.client_cache.get(("GET", "foo")) == b"bar"
+    assert r.client_cache.get(("GET", "foo2")) == b"bar2"
+    assert r.client_cache.get(("GET", "foo3")) == b"bar3"
+    # add 1 more key to redis (exceed the max size)
+    r.set("foo4", "bar4")
+    assert r.get("foo4") == b"bar4"
+    # the first key is not in the local cache anymore
+    assert r.client_cache.get(("GET", "foo")) is None
+
+
+@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+def test_cache_ttl():
+    r = redis.Redis(
+        cache_enable=True, cache_ttl=1, single_connection_client=True, protocol=3
+    )
+    # add key to redis
+    r.set("foo", "bar")
+    # get key from redis and save in local cache
+    assert r.get("foo") == b"bar"
+    # get key from local cache
+    assert r.client_cache.get(("GET", "foo")) == b"bar"
+    # wait for the key to expire
+    time.sleep(1)
+    # the key is not in the local cache anymore
+    assert r.client_cache.get(("GET", "foo")) is None
+
+
+@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+def test_cache_lfu_eviction():
+    r = redis.Redis(
+        cache_enable=True,
+        cache_max_size=3,
+        cache_eviction_policy="lfu",
+        single_connection_client=True,
+        protocol=3,
+    )
+    # add 3 keys to redis
+    r.set("foo", "bar")
+    r.set("foo2", "bar2")
+    r.set("foo3", "bar3")
+    # get 3 keys from redis and save in local cache
+    assert r.get("foo") == b"bar"
+    assert r.get("foo2") == b"bar2"
+    assert r.get("foo3") == b"bar3"
+    # change the order of the keys in the cache
+    assert r.client_cache.get(("GET", "foo")) == b"bar"
+    assert r.client_cache.get(("GET", "foo")) == b"bar"
+    assert r.client_cache.get(("GET", "foo3")) == b"bar3"
+    # add 1 more key to redis (exceed the max size)
+    r.set("foo4", "bar4")
+    assert r.get("foo4") == b"bar4"
+    # test the eviction policy
+    assert len(r.client_cache.cache) == 3
+    assert r.client_cache.get(("GET", "foo")) == b"bar"
+    assert r.client_cache.get(("GET", "foo2")) is None
+
+
+@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+def test_cache_decode_response():
+    r = redis.Redis(
+        decode_responses=True,
+        cache_enable=True,
+        single_connection_client=True,
+        protocol=3,
+    )
+    r.set("foo", "bar")
+    # get key from redis and save in local cache
+    assert r.get("foo") == "bar"
+    # get key from local cache
+    assert r.client_cache.get(("GET", "foo")) == "bar"
+    # change key in redis (cause invalidation)
+    r.set("foo", "barbar")
+    # send any command to redis (process invalidation in background)
+    r.ping()
+    # the command is not in the local cache anymore
+    assert r.client_cache.get(("GET", "foo")) is None
+    # get key from redis
+    assert r.get("foo") == "barbar"

From 6046d5f8a2a50eba9b47fc9a6253c87a24fbc4df Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 1 Jan 2024 13:22:15 +0200
Subject: [PATCH 0821/1164] fix acl_genpass with bits (#3062)

---
 redis/commands/core.py | 1 +
 tests/test_commands.py | 3 ++-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index f97724d030..8fbd0d9104 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -97,6 +97,7 @@ def acl_genpass(self, bits: Union[int, None] = None, **kwargs) -> ResponseT:
                 b = int(bits)
                 if b < 0 or b > 4096:
                     raise ValueError
+                pieces.append(b)
             except ValueError:
                 raise DataError(
                     "genpass optionally accepts a bits argument, between 0 and 4096."
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 6660c2c6b0..b2d7c1b9ed 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -201,8 +201,9 @@ def test_acl_genpass(self, r):
             r.acl_genpass(-5)
             r.acl_genpass(5555)
 
-        r.acl_genpass(555)
+        password = r.acl_genpass(555)
         assert isinstance(password, (str, bytes))
+        assert len(password) == 139
 
     @skip_if_server_version_lt("7.0.0")
     @skip_if_redis_enterprise()

From aea575597d317930c00350cdda18e6acb3814958 Mon Sep 17 00:00:00 2001
From: Aarni Koskela <akx@iki.fi>
Date: Mon, 1 Jan 2024 15:10:22 +0200
Subject: [PATCH 0822/1164] Partial clean up of Python 3.7 compatibility
 (#2928)

* Drop typing_extensions dependency (not necessary when targeting Python 3.8+)

* Bump python_requires to >=3.8, drop importlib-metadata shim dependency

* Cease testing on Python 3.7

* Add 3.8 test

---------

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 .github/workflows/integration.yaml | 6 +++---
 redis/_parsers/hiredis.py          | 4 +---
 redis/asyncio/client.py            | 3 ++-
 redis/asyncio/connection.py        | 3 ++-
 redis/commands/cluster.py          | 2 +-
 redis/commands/core.py             | 2 +-
 redis/compat.py                    | 6 ------
 redis/typing.py                    | 3 +--
 setup.py                           | 5 +----
 9 files changed, 12 insertions(+), 22 deletions(-)
 delete mode 100644 redis/compat.py

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 96b51fbafb..207d58fac7 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -57,7 +57,7 @@ jobs:
        max-parallel: 15
        fail-fast: false
        matrix:
-         python-version: ['3.7', '3.8', '3.9', '3.10', '3.11', 'pypy-3.7', 'pypy-3.8', 'pypy-3.9']
+         python-version: ['3.8', '3.9', '3.10', '3.11', 'pypy-3.8', 'pypy-3.9']
          test-type: ['standalone', 'cluster']
          connection-type: ['hiredis', 'plain']
      env:
@@ -111,7 +111,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ['3.7', '3.11']
+        python-version: ['3.8', '3.11']
         test-type: ['standalone', 'cluster']
         connection-type: ['hiredis', 'plain']
         protocol: ['3']
@@ -160,7 +160,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ['3.7', '3.8', '3.9', '3.10', '3.11', 'pypy-3.7', 'pypy-3.8', 'pypy-3.9']
+        python-version: ['3.8', '3.9', '3.10', '3.11', 'pypy-3.8', 'pypy-3.9']
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v4
diff --git a/redis/_parsers/hiredis.py b/redis/_parsers/hiredis.py
index 1919d3658e..a52dbbd013 100644
--- a/redis/_parsers/hiredis.py
+++ b/redis/_parsers/hiredis.py
@@ -1,15 +1,13 @@
 import asyncio
 import socket
 import sys
-from typing import Callable, List, Optional, Union
+from typing import Callable, List, Optional, TypedDict, Union
 
 if sys.version_info.major >= 3 and sys.version_info.minor >= 11:
     from asyncio import timeout as async_timeout
 else:
     from async_timeout import timeout as async_timeout
 
-from redis.compat import TypedDict
-
 from ..exceptions import ConnectionError, InvalidResponse, RedisError
 from ..typing import EncodableT
 from ..utils import HIREDIS_AVAILABLE
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index eea9612f4a..79689fcb5e 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -15,9 +15,11 @@
     Mapping,
     MutableMapping,
     Optional,
+    Protocol,
     Set,
     Tuple,
     Type,
+    TypedDict,
     TypeVar,
     Union,
     cast,
@@ -55,7 +57,6 @@
     AsyncSentinelCommands,
     list_or_args,
 )
-from redis.compat import Protocol, TypedDict
 from redis.credentials import CredentialProvider
 from redis.exceptions import (
     ConnectionError,
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 39f75a5f13..df2bd20f9f 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -17,9 +17,11 @@
     List,
     Mapping,
     Optional,
+    Protocol,
     Set,
     Tuple,
     Type,
+    TypedDict,
     TypeVar,
     Union,
 )
@@ -34,7 +36,6 @@
 
 from redis.asyncio.retry import Retry
 from redis.backoff import NoBackoff
-from redis.compat import Protocol, TypedDict
 from redis.connection import DEFAULT_RESP_VERSION
 from redis.credentials import CredentialProvider, UsernamePasswordCredentialProvider
 from redis.exceptions import (
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index af3a717c27..8dd463ed18 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -7,13 +7,13 @@
     Iterable,
     Iterator,
     List,
+    Literal,
     Mapping,
     NoReturn,
     Optional,
     Union,
 )
 
-from redis.compat import Literal
 from redis.crc import key_slot
 from redis.exceptions import RedisClusterException, RedisError
 from redis.typing import (
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 8fbd0d9104..5d7b774dc3 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -12,6 +12,7 @@
     Iterable,
     Iterator,
     List,
+    Literal,
     Mapping,
     Optional,
     Sequence,
@@ -20,7 +21,6 @@
     Union,
 )
 
-from redis.compat import Literal
 from redis.exceptions import ConnectionError, DataError, NoScriptError, RedisError
 from redis.typing import (
     AbsExpiryT,
diff --git a/redis/compat.py b/redis/compat.py
deleted file mode 100644
index e478493467..0000000000
--- a/redis/compat.py
+++ /dev/null
@@ -1,6 +0,0 @@
-# flake8: noqa
-try:
-    from typing import Literal, Protocol, TypedDict  # lgtm [py/unused-import]
-except ImportError:
-    from typing_extensions import Literal  # lgtm [py/unused-import]
-    from typing_extensions import Protocol, TypedDict
diff --git a/redis/typing.py b/redis/typing.py
index d1cd5568a3..a5d1369d63 100644
--- a/redis/typing.py
+++ b/redis/typing.py
@@ -7,13 +7,12 @@
     Awaitable,
     Iterable,
     Mapping,
+    Protocol,
     Type,
     TypeVar,
     Union,
 )
 
-from redis.compat import Protocol
-
 if TYPE_CHECKING:
     from redis._parsers import Encoder
     from redis.asyncio.connection import ConnectionPool as AsyncConnectionPool
diff --git a/setup.py b/setup.py
index 8979b29b23..89aa2e6658 100644
--- a/setup.py
+++ b/setup.py
@@ -34,10 +34,8 @@
     },
     author="Redis Inc.",
     author_email="oss@redis.com",
-    python_requires=">=3.7",
+    python_requires=">=3.8",
     install_requires=[
-        'importlib-metadata >= 1.0; python_version < "3.8"',
-        'typing-extensions; python_version<"3.8"',
         'async-timeout>=4.0.2; python_full_version<="3.11.2"',
     ],
     classifiers=[
@@ -49,7 +47,6 @@
         "Programming Language :: Python",
         "Programming Language :: Python :: 3",
         "Programming Language :: Python :: 3 :: Only",
-        "Programming Language :: Python :: 3.7",
         "Programming Language :: Python :: 3.8",
         "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",

From c6bbfcad5a25d5497845010a52eef8c06224f79e Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 1 Jan 2024 15:22:54 +0200
Subject: [PATCH 0823/1164] Version 5.1.0b1 (#3093)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 89aa2e6658..8329f00066 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="5.1.0a1",
+    version="5.1.0b1",
     packages=find_packages(
         include=[
             "redis",

From a63ba91d0df7ffed8e724a2d82cde4709a9196ec Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 2 Jan 2024 09:07:18 +0200
Subject: [PATCH 0824/1164] Bump github/codeql-action from 2 to 3 (#3096)

Bumps [github/codeql-action](https://github.com/github/codeql-action) from 2 to 3.
- [Release notes](https://github.com/github/codeql-action/releases)
- [Changelog](https://github.com/github/codeql-action/blob/main/CHANGELOG.md)
- [Commits](https://github.com/github/codeql-action/compare/v2...v3)

---
updated-dependencies:
- dependency-name: github/codeql-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/codeql-analysis.yml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/codeql-analysis.yml b/.github/workflows/codeql-analysis.yml
index 61da2fce55..4670c55b0f 100644
--- a/.github/workflows/codeql-analysis.yml
+++ b/.github/workflows/codeql-analysis.yml
@@ -40,7 +40,7 @@ jobs:
 
     # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL
-      uses: github/codeql-action/init@v2
+      uses: github/codeql-action/init@v3
       with:
         languages: ${{ matrix.language }}
         # If you wish to specify custom queries, you can do so here or in a config file.
@@ -51,7 +51,7 @@ jobs:
     # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
     # If this step fails, then you should remove it and run the build manually (see below)
     - name: Autobuild
-      uses: github/codeql-action/autobuild@v2
+      uses: github/codeql-action/autobuild@v3
 
     # ℹ️ Command-line programs to run using the OS shell.
     # 📚 https://git.io/JvXDl
@@ -65,4 +65,4 @@ jobs:
     #   make release
 
     - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@v2
+      uses: github/codeql-action/analyze@v3

From 4f3b894d67296118fe8cc3e98c9e1f02e33f6488 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 2 Jan 2024 09:07:27 +0200
Subject: [PATCH 0825/1164] Bump actions/upload-artifact from 3 to 4 (#3097)

Bumps [actions/upload-artifact](https://github.com/actions/upload-artifact) from 3 to 4.
- [Release notes](https://github.com/actions/upload-artifact/releases)
- [Commits](https://github.com/actions/upload-artifact/compare/v3...v4)

---
updated-dependencies:
- dependency-name: actions/upload-artifact
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/docs.yaml        | 2 +-
 .github/workflows/integration.yaml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml
index 56f16fa2b0..f32afb6a90 100644
--- a/.github/workflows/docs.yaml
+++ b/.github/workflows/docs.yaml
@@ -40,7 +40,7 @@ jobs:
            invoke build-docs
 
        - name: upload docs
-         uses: actions/upload-artifact@v3
+         uses: actions/upload-artifact@v4
          with:
            name: redis-py-docs
            path: |
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 207d58fac7..23f6674aac 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -81,7 +81,7 @@ jobs:
            sleep 10 # time to settle
            invoke ${{matrix.test-type}}-tests
 
-       - uses: actions/upload-artifact@v3
+       - uses: actions/upload-artifact@v4
          if: success() || failure()
          with:
            name: pytest-results-${{matrix.test-type}}-${{matrix.connection-type}}-${{matrix.python-version}}

From 6d77c6d715430c30f22147f8c572659d77380a9f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 2 Jan 2024 09:07:43 +0200
Subject: [PATCH 0826/1164] Bump actions/setup-python from 4 to 5 (#3095)

Bumps [actions/setup-python](https://github.com/actions/setup-python) from 4 to 5.
- [Release notes](https://github.com/actions/setup-python/releases)
- [Commits](https://github.com/actions/setup-python/compare/v4...v5)

---
updated-dependencies:
- dependency-name: actions/setup-python
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/docs.yaml         |  2 +-
 .github/workflows/integration.yaml  | 10 +++++-----
 .github/workflows/pypi-publish.yaml |  2 +-
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml
index f32afb6a90..c5c74aa4d3 100644
--- a/.github/workflows/docs.yaml
+++ b/.github/workflows/docs.yaml
@@ -26,7 +26,7 @@ jobs:
      runs-on: ubuntu-latest
      steps:
        - uses: actions/checkout@v4
-       - uses: actions/setup-python@v4
+       - uses: actions/setup-python@v5
          with:
            python-version: 3.9
            cache: 'pip'
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 23f6674aac..f4ba256359 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -41,7 +41,7 @@ jobs:
      runs-on: ubuntu-latest
      steps:
        - uses: actions/checkout@v4
-       - uses: actions/setup-python@v4
+       - uses: actions/setup-python@v5
          with:
            python-version: 3.9
            cache: 'pip'
@@ -65,7 +65,7 @@ jobs:
      name: Python ${{ matrix.python-version }} ${{matrix.test-type}}-${{matrix.connection-type}} tests
      steps:
        - uses: actions/checkout@v4
-       - uses: actions/setup-python@v4
+       - uses: actions/setup-python@v5
          with:
            python-version: ${{ matrix.python-version }}
            cache: 'pip'
@@ -120,7 +120,7 @@ jobs:
     name: RESP3 [${{ matrix.python-version }} ${{matrix.test-type}}-${{matrix.connection-type}}]
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-python@v4
+      - uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
           cache: 'pip'
@@ -147,7 +147,7 @@ jobs:
         extension: ['tar.gz', 'whl']
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-python@v4
+      - uses: actions/setup-python@v5
         with:
           python-version: 3.9
       - name: Run installed unit tests
@@ -163,7 +163,7 @@ jobs:
         python-version: ['3.8', '3.9', '3.10', '3.11', 'pypy-3.8', 'pypy-3.9']
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-python@v4
+      - uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
           cache: 'pip'
diff --git a/.github/workflows/pypi-publish.yaml b/.github/workflows/pypi-publish.yaml
index 4f8833372f..30720d7b8a 100644
--- a/.github/workflows/pypi-publish.yaml
+++ b/.github/workflows/pypi-publish.yaml
@@ -14,7 +14,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: install python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: 3.9
       - name: Install dev tools

From 8cbf7f5fa899675ef8fca09ec63f8588d351e297 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 7 Jan 2024 14:15:58 +0200
Subject: [PATCH 0827/1164] Support client side caching with ConnectionPool
 (#3099)

* sync

* async

* fixs connection mocks

* fix async connection mock

* fix test_asyncio/test_connection.py::test_single_connection

* add test for cache blacklist and flushdb at the end of each test

* fix review comments
---
 redis/{cache.py => _cache.py}         |   6 +-
 redis/asyncio/client.py               | 106 +++++---------------------
 redis/asyncio/connection.py           |  88 ++++++++++++++++++++-
 redis/client.py                       |  98 +++++-------------------
 redis/connection.py                   |  91 +++++++++++++++++++++-
 tests/conftest.py                     |   1 +
 tests/test_asyncio/conftest.py        |   1 +
 tests/test_asyncio/test_cache.py      |  83 +++++++++++---------
 tests/test_asyncio/test_connection.py |   3 +-
 tests/test_cache.py                   |  87 ++++++++++++---------
 10 files changed, 318 insertions(+), 246 deletions(-)
 rename redis/{cache.py => _cache.py} (98%)

diff --git a/redis/cache.py b/redis/_cache.py
similarity index 98%
rename from redis/cache.py
rename to redis/_cache.py
index d920702339..4255afb7a4 100644
--- a/redis/cache.py
+++ b/redis/_cache.py
@@ -178,7 +178,11 @@ class _LocalCache:
     """
 
     def __init__(
-        self, max_size: int, ttl: int, eviction_policy: EvictionPolicy, **kwargs
+        self,
+        max_size: int = 100,
+        ttl: int = 0,
+        eviction_policy: EvictionPolicy = DEFAULT_EVICTION_POLICY,
+        **kwargs,
     ):
         self.max_size = max_size
         self.ttl = ttl
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 79689fcb5e..143d997757 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -25,6 +25,12 @@
     cast,
 )
 
+from redis._cache import (
+    DEFAULT_BLACKLIST,
+    DEFAULT_EVICTION_POLICY,
+    DEFAULT_WHITELIST,
+    _LocalCache,
+)
 from redis._parsers.helpers import (
     _RedisCallbacks,
     _RedisCallbacksRESP2,
@@ -39,12 +45,6 @@
 )
 from redis.asyncio.lock import Lock
 from redis.asyncio.retry import Retry
-from redis.cache import (
-    DEFAULT_BLACKLIST,
-    DEFAULT_EVICTION_POLICY,
-    DEFAULT_WHITELIST,
-    _LocalCache,
-)
 from redis.client import (
     EMPTY_RESPONSE,
     NEVER_DECODE,
@@ -67,7 +67,7 @@
     TimeoutError,
     WatchError,
 )
-from redis.typing import ChannelT, EncodableT, KeysT, KeyT, ResponseT
+from redis.typing import ChannelT, EncodableT, KeyT
 from redis.utils import (
     HIREDIS_AVAILABLE,
     _set_info_logger,
@@ -294,6 +294,13 @@ def __init__(
                 "lib_version": lib_version,
                 "redis_connect_func": redis_connect_func,
                 "protocol": protocol,
+                "cache_enable": cache_enable,
+                "client_cache": client_cache,
+                "cache_max_size": cache_max_size,
+                "cache_ttl": cache_ttl,
+                "cache_eviction_policy": cache_eviction_policy,
+                "cache_blacklist": cache_blacklist,
+                "cache_whitelist": cache_whitelist,
             }
             # based on input, setup appropriate connection args
             if unix_socket_path is not None:
@@ -350,16 +357,6 @@ def __init__(
         # on a set of redis commands
         self._single_conn_lock = asyncio.Lock()
 
-        self.client_cache = client_cache
-        if cache_enable:
-            self.client_cache = _LocalCache(
-                cache_max_size, cache_ttl, cache_eviction_policy
-            )
-        if self.client_cache is not None:
-            self.cache_blacklist = cache_blacklist
-            self.cache_whitelist = cache_whitelist
-            self.client_cache_initialized = False
-
     def __repr__(self):
         return (
             f"<{self.__class__.__module__}.{self.__class__.__name__}"
@@ -374,10 +371,6 @@ async def initialize(self: _RedisT) -> _RedisT:
             async with self._single_conn_lock:
                 if self.connection is None:
                     self.connection = await self.connection_pool.get_connection("_")
-            if self.client_cache is not None:
-                self.connection._parser.set_invalidation_push_handler(
-                    self._cache_invalidation_process
-                )
         return self
 
     def set_response_callback(self, command: str, callback: ResponseCallbackT):
@@ -596,8 +589,6 @@ async def aclose(self, close_connection_pool: Optional[bool] = None) -> None:
             close_connection_pool is None and self.auto_close_connection_pool
         ):
             await self.connection_pool.disconnect()
-        if self.client_cache:
-            self.client_cache.flush()
 
     @deprecated_function(version="5.0.1", reason="Use aclose() instead", name="close")
     async def close(self, close_connection_pool: Optional[bool] = None) -> None:
@@ -626,89 +617,28 @@ async def _disconnect_raise(self, conn: Connection, error: Exception):
         ):
             raise error
 
-    def _cache_invalidation_process(
-        self, data: List[Union[str, Optional[List[str]]]]
-    ) -> None:
-        """
-        Invalidate (delete) all redis commands associated with a specific key.
-        `data` is a list of strings, where the first string is the invalidation message
-        and the second string is the list of keys to invalidate.
-        (if the list of keys is None, then all keys are invalidated)
-        """
-        if data[1] is not None:
-            for key in data[1]:
-                self.client_cache.invalidate(str_if_bytes(key))
-            else:
-                self.client_cache.flush()
-
-    async def _get_from_local_cache(self, command: str):
-        """
-        If the command is in the local cache, return the response
-        """
-        if (
-            self.client_cache is None
-            or command[0] in self.cache_blacklist
-            or command[0] not in self.cache_whitelist
-        ):
-            return None
-        while not self.connection._is_socket_empty():
-            await self.connection.read_response(push_request=True)
-        return self.client_cache.get(command)
-
-    def _add_to_local_cache(
-        self, command: Tuple[str], response: ResponseT, keys: List[KeysT]
-    ):
-        """
-        Add the command and response to the local cache if the command
-        is allowed to be cached
-        """
-        if (
-            self.client_cache is not None
-            and (self.cache_blacklist == [] or command[0] not in self.cache_blacklist)
-            and (self.cache_whitelist == [] or command[0] in self.cache_whitelist)
-        ):
-            self.client_cache.set(command, response, keys)
-
-    def delete_from_local_cache(self, command: str):
-        """
-        Delete the command from the local cache
-        """
-        try:
-            self.client_cache.delete(command)
-        except AttributeError:
-            pass
-
     # COMMAND EXECUTION AND PROTOCOL PARSING
     async def execute_command(self, *args, **options):
         """Execute a command and return a parsed response"""
         await self.initialize()
         command_name = args[0]
         keys = options.pop("keys", None)  # keys are used only for client side caching
-        response_from_cache = await self._get_from_local_cache(args)
+        pool = self.connection_pool
+        conn = self.connection or await pool.get_connection(command_name, **options)
+        response_from_cache = await conn._get_from_local_cache(args)
         if response_from_cache is not None:
             return response_from_cache
         else:
-            pool = self.connection_pool
-            conn = self.connection or await pool.get_connection(command_name, **options)
-
             if self.single_connection_client:
                 await self._single_conn_lock.acquire()
             try:
-                if self.client_cache is not None and not self.client_cache_initialized:
-                    await conn.retry.call_with_retry(
-                        lambda: self._send_command_parse_response(
-                            conn, "CLIENT", *("CLIENT", "TRACKING", "ON")
-                        ),
-                        lambda error: self._disconnect_raise(conn, error),
-                    )
-                    self.client_cache_initialized = True
                 response = await conn.retry.call_with_retry(
                     lambda: self._send_command_parse_response(
                         conn, command_name, *args, **options
                     ),
                     lambda error: self._disconnect_raise(conn, error),
                 )
-                self._add_to_local_cache(args, response, keys)
+                conn._add_to_local_cache(args, response, keys)
                 return response
             finally:
                 if self.single_connection_client:
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index df2bd20f9f..7f1c0b71e4 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -47,9 +47,15 @@
     ResponseError,
     TimeoutError,
 )
-from redis.typing import EncodableT
+from redis.typing import EncodableT, KeysT, ResponseT
 from redis.utils import HIREDIS_AVAILABLE, get_lib_version, str_if_bytes
 
+from .._cache import (
+    DEFAULT_BLACKLIST,
+    DEFAULT_EVICTION_POLICY,
+    DEFAULT_WHITELIST,
+    _LocalCache,
+)
 from .._parsers import (
     BaseParser,
     Encoder,
@@ -114,6 +120,9 @@ class AbstractConnection:
         "encoder",
         "ssl_context",
         "protocol",
+        "client_cache",
+        "cache_blacklist",
+        "cache_whitelist",
         "_reader",
         "_writer",
         "_parser",
@@ -148,6 +157,13 @@ def __init__(
         encoder_class: Type[Encoder] = Encoder,
         credential_provider: Optional[CredentialProvider] = None,
         protocol: Optional[int] = 2,
+        cache_enable: bool = False,
+        client_cache: Optional[_LocalCache] = None,
+        cache_max_size: int = 100,
+        cache_ttl: int = 0,
+        cache_eviction_policy: str = DEFAULT_EVICTION_POLICY,
+        cache_blacklist: List[str] = DEFAULT_BLACKLIST,
+        cache_whitelist: List[str] = DEFAULT_WHITELIST,
     ):
         if (username or password) and credential_provider is not None:
             raise DataError(
@@ -205,6 +221,14 @@ def __init__(
             if p < 2 or p > 3:
                 raise ConnectionError("protocol must be either 2 or 3")
             self.protocol = protocol
+        if cache_enable:
+            _cache = _LocalCache(cache_max_size, cache_ttl, cache_eviction_policy)
+        else:
+            _cache = None
+        self.client_cache = client_cache if client_cache is not None else _cache
+        if self.client_cache is not None:
+            self.cache_blacklist = cache_blacklist
+            self.cache_whitelist = cache_whitelist
 
     def __del__(self, _warnings: Any = warnings):
         # For some reason, the individual streams don't get properly garbage
@@ -395,6 +419,11 @@ async def on_connect(self) -> None:
         # if a database is specified, switch to it. Also pipeline this
         if self.db:
             await self.send_command("SELECT", self.db)
+        # if client caching is enabled, start tracking
+        if self.client_cache:
+            await self.send_command("CLIENT", "TRACKING", "ON")
+            await self.read_response()
+            self._parser.set_invalidation_push_handler(self._cache_invalidation_process)
 
         # read responses from pipeline
         for _ in (sent for sent in (self.lib_name, self.lib_version) if sent):
@@ -429,6 +458,9 @@ async def disconnect(self, nowait: bool = False) -> None:
             raise TimeoutError(
                 f"Timed out closing connection after {self.socket_connect_timeout}"
             ) from None
+        finally:
+            if self.client_cache:
+                self.client_cache.flush()
 
     async def _send_ping(self):
         """Send PING, expect PONG in return"""
@@ -646,10 +678,62 @@ def pack_commands(self, commands: Iterable[Iterable[EncodableT]]) -> List[bytes]
             output.append(SYM_EMPTY.join(pieces))
         return output
 
-    def _is_socket_empty(self):
+    def _socket_is_empty(self):
         """Check if the socket is empty"""
         return not self._reader.at_eof()
 
+    def _cache_invalidation_process(
+        self, data: List[Union[str, Optional[List[str]]]]
+    ) -> None:
+        """
+        Invalidate (delete) all redis commands associated with a specific key.
+        `data` is a list of strings, where the first string is the invalidation message
+        and the second string is the list of keys to invalidate.
+        (if the list of keys is None, then all keys are invalidated)
+        """
+        if data[1] is not None:
+            self.client_cache.flush()
+        else:
+            for key in data[1]:
+                self.client_cache.invalidate(str_if_bytes(key))
+
+    async def _get_from_local_cache(self, command: str):
+        """
+        If the command is in the local cache, return the response
+        """
+        if (
+            self.client_cache is None
+            or command[0] in self.cache_blacklist
+            or command[0] not in self.cache_whitelist
+        ):
+            return None
+        while not self._socket_is_empty():
+            await self.read_response(push_request=True)
+        return self.client_cache.get(command)
+
+    def _add_to_local_cache(
+        self, command: Tuple[str], response: ResponseT, keys: List[KeysT]
+    ):
+        """
+        Add the command and response to the local cache if the command
+        is allowed to be cached
+        """
+        if (
+            self.client_cache is not None
+            and (self.cache_blacklist == [] or command[0] not in self.cache_blacklist)
+            and (self.cache_whitelist == [] or command[0] in self.cache_whitelist)
+        ):
+            self.client_cache.set(command, response, keys)
+
+    def delete_from_local_cache(self, command: str):
+        """
+        Delete the command from the local cache
+        """
+        try:
+            self.client_cache.delete(command)
+        except AttributeError:
+            pass
+
 
 class Connection(AbstractConnection):
     "Manages TCP communication to and from a Redis server"
diff --git a/redis/client.py b/redis/client.py
index 7f2c8d290d..d685145339 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -4,8 +4,14 @@
 import time
 import warnings
 from itertools import chain
-from typing import Any, Callable, Dict, List, Optional, Tuple, Type, Union
+from typing import Any, Callable, Dict, List, Optional, Type, Union
 
+from redis._cache import (
+    DEFAULT_BLACKLIST,
+    DEFAULT_EVICTION_POLICY,
+    DEFAULT_WHITELIST,
+    _LocalCache,
+)
 from redis._parsers.encoders import Encoder
 from redis._parsers.helpers import (
     _RedisCallbacks,
@@ -13,12 +19,6 @@
     _RedisCallbacksRESP3,
     bool_ok,
 )
-from redis.cache import (
-    DEFAULT_BLACKLIST,
-    DEFAULT_EVICTION_POLICY,
-    DEFAULT_WHITELIST,
-    _LocalCache,
-)
 from redis.commands import (
     CoreCommands,
     RedisModuleCommands,
@@ -38,7 +38,6 @@
 )
 from redis.lock import Lock
 from redis.retry import Retry
-from redis.typing import KeysT, ResponseT
 from redis.utils import (
     HIREDIS_AVAILABLE,
     _set_info_logger,
@@ -268,6 +267,13 @@ def __init__(
                 "redis_connect_func": redis_connect_func,
                 "credential_provider": credential_provider,
                 "protocol": protocol,
+                "cache_enable": cache_enable,
+                "client_cache": client_cache,
+                "cache_max_size": cache_max_size,
+                "cache_ttl": cache_ttl,
+                "cache_eviction_policy": cache_eviction_policy,
+                "cache_blacklist": cache_blacklist,
+                "cache_whitelist": cache_whitelist,
             }
             # based on input, setup appropriate connection args
             if unix_socket_path is not None:
@@ -324,19 +330,6 @@ def __init__(
         else:
             self.response_callbacks.update(_RedisCallbacksRESP2)
 
-        self.client_cache = client_cache
-        if cache_enable:
-            self.client_cache = _LocalCache(
-                cache_max_size, cache_ttl, cache_eviction_policy
-            )
-        if self.client_cache is not None:
-            self.cache_blacklist = cache_blacklist
-            self.cache_whitelist = cache_whitelist
-            self.client_tracking_on()
-            self.connection._parser.set_invalidation_push_handler(
-                self._cache_invalidation_process
-            )
-
     def __repr__(self) -> str:
         return (
             f"<{type(self).__module__}.{type(self).__name__}"
@@ -362,21 +355,6 @@ def set_response_callback(self, command: str, callback: Callable) -> None:
         """Set a custom Response Callback"""
         self.response_callbacks[command] = callback
 
-    def _cache_invalidation_process(
-        self, data: List[Union[str, Optional[List[str]]]]
-    ) -> None:
-        """
-        Invalidate (delete) all redis commands associated with a specific key.
-        `data` is a list of strings, where the first string is the invalidation message
-        and the second string is the list of keys to invalidate.
-        (if the list of keys is None, then all keys are invalidated)
-        """
-        if data[1] is not None:
-            for key in data[1]:
-                self.client_cache.invalidate(str_if_bytes(key))
-            else:
-                self.client_cache.flush()
-
     def load_external_module(self, funcname, func) -> None:
         """
         This function can be used to add externally defined redis modules,
@@ -549,8 +527,6 @@ def close(self):
 
         if self.auto_close_connection_pool:
             self.connection_pool.disconnect()
-        if self.client_cache:
-            self.client_cache.flush()
 
     def _send_command_parse_response(self, conn, command_name, *args, **options):
         """
@@ -572,55 +548,17 @@ def _disconnect_raise(self, conn, error):
         ):
             raise error
 
-    def _get_from_local_cache(self, command: str):
-        """
-        If the command is in the local cache, return the response
-        """
-        if (
-            self.client_cache is None
-            or command[0] in self.cache_blacklist
-            or command[0] not in self.cache_whitelist
-        ):
-            return None
-        while not self.connection._is_socket_empty():
-            self.connection.read_response(push_request=True)
-        return self.client_cache.get(command)
-
-    def _add_to_local_cache(
-        self, command: Tuple[str], response: ResponseT, keys: List[KeysT]
-    ):
-        """
-        Add the command and response to the local cache if the command
-        is allowed to be cached
-        """
-        if (
-            self.client_cache is not None
-            and (self.cache_blacklist == [] or command[0] not in self.cache_blacklist)
-            and (self.cache_whitelist == [] or command[0] in self.cache_whitelist)
-        ):
-            self.client_cache.set(command, response, keys)
-
-    def delete_from_local_cache(self, command: str):
-        """
-        Delete the command from the local cache
-        """
-        try:
-            self.client_cache.delete(command)
-        except AttributeError:
-            pass
-
     # COMMAND EXECUTION AND PROTOCOL PARSING
     def execute_command(self, *args, **options):
         """Execute a command and return a parsed response"""
         command_name = args[0]
         keys = options.pop("keys", None)
-        response_from_cache = self._get_from_local_cache(args)
+        pool = self.connection_pool
+        conn = self.connection or pool.get_connection(command_name, **options)
+        response_from_cache = conn._get_from_local_cache(args)
         if response_from_cache is not None:
             return response_from_cache
         else:
-            pool = self.connection_pool
-            conn = self.connection or pool.get_connection(command_name, **options)
-
             try:
                 response = conn.retry.call_with_retry(
                     lambda: self._send_command_parse_response(
@@ -628,7 +566,7 @@ def execute_command(self, *args, **options):
                     ),
                     lambda error: self._disconnect_raise(conn, error),
                 )
-                self._add_to_local_cache(args, response, keys)
+                conn._add_to_local_cache(args, response, keys)
                 return response
             finally:
                 if not self.connection:
diff --git a/redis/connection.py b/redis/connection.py
index 35a4ff4a37..a09fb3949c 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -10,9 +10,15 @@
 from itertools import chain
 from queue import Empty, Full, LifoQueue
 from time import time
-from typing import Any, Callable, List, Optional, Type, Union
+from typing import Any, Callable, List, Optional, Tuple, Type, Union
 from urllib.parse import parse_qs, unquote, urlparse
 
+from ._cache import (
+    DEFAULT_BLACKLIST,
+    DEFAULT_EVICTION_POLICY,
+    DEFAULT_WHITELIST,
+    _LocalCache,
+)
 from ._parsers import Encoder, _HiredisParser, _RESP2Parser, _RESP3Parser
 from .backoff import NoBackoff
 from .credentials import CredentialProvider, UsernamePasswordCredentialProvider
@@ -27,6 +33,7 @@
     TimeoutError,
 )
 from .retry import Retry
+from .typing import KeysT, ResponseT
 from .utils import (
     CRYPTOGRAPHY_AVAILABLE,
     HIREDIS_AVAILABLE,
@@ -150,6 +157,13 @@ def __init__(
         credential_provider: Optional[CredentialProvider] = None,
         protocol: Optional[int] = 2,
         command_packer: Optional[Callable[[], None]] = None,
+        cache_enable: bool = False,
+        client_cache: Optional[_LocalCache] = None,
+        cache_max_size: int = 100,
+        cache_ttl: int = 0,
+        cache_eviction_policy: str = DEFAULT_EVICTION_POLICY,
+        cache_blacklist: List[str] = DEFAULT_BLACKLIST,
+        cache_whitelist: List[str] = DEFAULT_WHITELIST,
     ):
         """
         Initialize a new Connection.
@@ -215,6 +229,18 @@ def __init__(
                 # p = DEFAULT_RESP_VERSION
             self.protocol = p
         self._command_packer = self._construct_command_packer(command_packer)
+        if cache_enable:
+            _cache = _LocalCache(cache_max_size, cache_ttl, cache_eviction_policy)
+        else:
+            _cache = None
+        self.client_cache = client_cache if client_cache is not None else _cache
+        if self.client_cache is not None:
+            if self.protocol not in [3, "3"]:
+                raise RedisError(
+                    "client caching is only supported with protocol version 3 or higher"
+                )
+            self.cache_blacklist = cache_blacklist
+            self.cache_whitelist = cache_whitelist
 
     def __repr__(self):
         repr_args = ",".join([f"{k}={v}" for k, v in self.repr_pieces()])
@@ -406,6 +432,12 @@ def on_connect(self):
             if str_if_bytes(self.read_response()) != "OK":
                 raise ConnectionError("Invalid Database")
 
+        # if client caching is enabled, start tracking
+        if self.client_cache:
+            self.send_command("CLIENT", "TRACKING", "ON")
+            self.read_response()
+            self._parser.set_invalidation_push_handler(self._cache_invalidation_process)
+
     def disconnect(self, *args):
         "Disconnects from the Redis server"
         self._parser.on_disconnect()
@@ -426,6 +458,9 @@ def disconnect(self, *args):
         except OSError:
             pass
 
+        if self.client_cache:
+            self.client_cache.flush()
+
     def _send_ping(self):
         """Send PING, expect PONG in return"""
         self.send_command("PING", check_health=False)
@@ -573,11 +608,63 @@ def pack_commands(self, commands):
             output.append(SYM_EMPTY.join(pieces))
         return output
 
-    def _is_socket_empty(self):
+    def _socket_is_empty(self):
         """Check if the socket is empty"""
         r, _, _ = select.select([self._sock], [], [], 0)
         return not bool(r)
 
+    def _cache_invalidation_process(
+        self, data: List[Union[str, Optional[List[str]]]]
+    ) -> None:
+        """
+        Invalidate (delete) all redis commands associated with a specific key.
+        `data` is a list of strings, where the first string is the invalidation message
+        and the second string is the list of keys to invalidate.
+        (if the list of keys is None, then all keys are invalidated)
+        """
+        if data[1] is None:
+            self.client_cache.flush()
+        else:
+            for key in data[1]:
+                self.client_cache.invalidate(str_if_bytes(key))
+
+    def _get_from_local_cache(self, command: str):
+        """
+        If the command is in the local cache, return the response
+        """
+        if (
+            self.client_cache is None
+            or command[0] in self.cache_blacklist
+            or command[0] not in self.cache_whitelist
+        ):
+            return None
+        while not self._socket_is_empty():
+            self.read_response(push_request=True)
+        return self.client_cache.get(command)
+
+    def _add_to_local_cache(
+        self, command: Tuple[str], response: ResponseT, keys: List[KeysT]
+    ):
+        """
+        Add the command and response to the local cache if the command
+        is allowed to be cached
+        """
+        if (
+            self.client_cache is not None
+            and (self.cache_blacklist == [] or command[0] not in self.cache_blacklist)
+            and (self.cache_whitelist == [] or command[0] in self.cache_whitelist)
+        ):
+            self.client_cache.set(command, response, keys)
+
+    def delete_from_local_cache(self, command: str):
+        """
+        Delete the command from the local cache
+        """
+        try:
+            self.client_cache.delete(command)
+        except AttributeError:
+            pass
+
 
 class Connection(AbstractConnection):
     "Manages TCP communication to and from a Redis server"
diff --git a/tests/conftest.py b/tests/conftest.py
index bad9f43e42..e56b5f6aed 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -356,6 +356,7 @@ def _gen_cluster_mock_resp(r, response):
     connection = Mock(spec=Connection)
     connection.retry = Retry(NoBackoff(), 0)
     connection.read_response.return_value = response
+    connection._get_from_local_cache.return_value = None
     with mock.patch.object(r, "connection", connection):
         yield r
 
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index 5d9e0b4f2e..c79b706abc 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -141,6 +141,7 @@ def _gen_cluster_mock_resp(r, response):
     connection = mock.AsyncMock(spec=Connection)
     connection.retry = Retry(NoBackoff(), 0)
     connection.read_response.return_value = response
+    connection._get_from_local_cache.return_value = None
     with mock.patch.object(r, "connection", connection):
         yield r
 
diff --git a/tests/test_asyncio/test_cache.py b/tests/test_asyncio/test_cache.py
index c837acfed1..92328b8391 100644
--- a/tests/test_asyncio/test_cache.py
+++ b/tests/test_asyncio/test_cache.py
@@ -2,36 +2,38 @@
 
 import pytest
 import redis.asyncio as redis
+from redis._cache import _LocalCache
 from redis.utils import HIREDIS_AVAILABLE
 
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 async def test_get_from_cache():
-    r = redis.Redis(cache_enable=True, single_connection_client=True, protocol=3)
+    cache = _LocalCache()
+    r = redis.Redis(protocol=3, client_cache=cache)
     r2 = redis.Redis(protocol=3)
     # add key to redis
     await r.set("foo", "bar")
     # get key from redis and save in local cache
     assert await r.get("foo") == b"bar"
     # get key from local cache
-    assert r.client_cache.get(("GET", "foo")) == b"bar"
+    assert cache.get(("GET", "foo")) == b"bar"
     # change key in redis (cause invalidation)
     await r2.set("foo", "barbar")
     # send any command to redis (process invalidation in background)
     await r.ping()
     # the command is not in the local cache anymore
-    assert r.client_cache.get(("GET", "foo")) is None
+    assert cache.get(("GET", "foo")) is None
     # get key from redis
     assert await r.get("foo") == b"barbar"
 
+    await r.flushdb()
     await r.aclose()
 
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 async def test_cache_max_size():
-    r = redis.Redis(
-        cache_enable=True, cache_max_size=3, single_connection_client=True, protocol=3
-    )
+    cache = _LocalCache(max_size=3)
+    r = redis.Redis(client_cache=cache, protocol=3)
     # add 3 keys to redis
     await r.set("foo", "bar")
     await r.set("foo2", "bar2")
@@ -41,46 +43,42 @@ async def test_cache_max_size():
     assert await r.get("foo2") == b"bar2"
     assert await r.get("foo3") == b"bar3"
     # get the 3 keys from local cache
-    assert r.client_cache.get(("GET", "foo")) == b"bar"
-    assert r.client_cache.get(("GET", "foo2")) == b"bar2"
-    assert r.client_cache.get(("GET", "foo3")) == b"bar3"
+    assert cache.get(("GET", "foo")) == b"bar"
+    assert cache.get(("GET", "foo2")) == b"bar2"
+    assert cache.get(("GET", "foo3")) == b"bar3"
     # add 1 more key to redis (exceed the max size)
     await r.set("foo4", "bar4")
     assert await r.get("foo4") == b"bar4"
     # the first key is not in the local cache anymore
-    assert r.client_cache.get(("GET", "foo")) is None
+    assert cache.get(("GET", "foo")) is None
 
+    await r.flushdb()
     await r.aclose()
 
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 async def test_cache_ttl():
-    r = redis.Redis(
-        cache_enable=True, cache_ttl=1, single_connection_client=True, protocol=3
-    )
+    cache = _LocalCache(ttl=1)
+    r = redis.Redis(client_cache=cache, protocol=3)
     # add key to redis
     await r.set("foo", "bar")
     # get key from redis and save in local cache
     assert await r.get("foo") == b"bar"
     # get key from local cache
-    assert r.client_cache.get(("GET", "foo")) == b"bar"
+    assert cache.get(("GET", "foo")) == b"bar"
     # wait for the key to expire
     time.sleep(1)
     # the key is not in the local cache anymore
-    assert r.client_cache.get(("GET", "foo")) is None
+    assert cache.get(("GET", "foo")) is None
 
+    await r.flushdb()
     await r.aclose()
 
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 async def test_cache_lfu_eviction():
-    r = redis.Redis(
-        cache_enable=True,
-        cache_max_size=3,
-        cache_eviction_policy="lfu",
-        single_connection_client=True,
-        protocol=3,
-    )
+    cache = _LocalCache(max_size=3, eviction_policy="lfu")
+    r = redis.Redis(client_cache=cache, protocol=3)
     # add 3 keys to redis
     await r.set("foo", "bar")
     await r.set("foo2", "bar2")
@@ -90,40 +88,53 @@ async def test_cache_lfu_eviction():
     assert await r.get("foo2") == b"bar2"
     assert await r.get("foo3") == b"bar3"
     # change the order of the keys in the cache
-    assert r.client_cache.get(("GET", "foo")) == b"bar"
-    assert r.client_cache.get(("GET", "foo")) == b"bar"
-    assert r.client_cache.get(("GET", "foo3")) == b"bar3"
+    assert cache.get(("GET", "foo")) == b"bar"
+    assert cache.get(("GET", "foo")) == b"bar"
+    assert cache.get(("GET", "foo3")) == b"bar3"
     # add 1 more key to redis (exceed the max size)
     await r.set("foo4", "bar4")
     assert await r.get("foo4") == b"bar4"
     # test the eviction policy
-    assert len(r.client_cache.cache) == 3
-    assert r.client_cache.get(("GET", "foo")) == b"bar"
-    assert r.client_cache.get(("GET", "foo2")) is None
+    assert len(cache.cache) == 3
+    assert cache.get(("GET", "foo")) == b"bar"
+    assert cache.get(("GET", "foo2")) is None
 
+    await r.flushdb()
     await r.aclose()
 
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 async def test_cache_decode_response():
-    r = redis.Redis(
-        decode_responses=True,
-        cache_enable=True,
-        single_connection_client=True,
-        protocol=3,
-    )
+    cache = _LocalCache()
+    r = redis.Redis(decode_responses=True, client_cache=cache, protocol=3)
     await r.set("foo", "bar")
     # get key from redis and save in local cache
     assert await r.get("foo") == "bar"
     # get key from local cache
-    assert r.client_cache.get(("GET", "foo")) == "bar"
+    assert cache.get(("GET", "foo")) == "bar"
     # change key in redis (cause invalidation)
     await r.set("foo", "barbar")
     # send any command to redis (process invalidation in background)
     await r.ping()
     # the command is not in the local cache anymore
-    assert r.client_cache.get(("GET", "foo")) is None
+    assert cache.get(("GET", "foo")) is None
     # get key from redis
     assert await r.get("foo") == "barbar"
 
+    await r.flushdb()
+    await r.aclose()
+
+
+@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+async def test_cache_blacklist():
+    cache = _LocalCache()
+    r = redis.Redis(client_cache=cache, cache_blacklist=["LLEN"], protocol=3)
+    # add list to redis
+    await r.lpush("mylist", "foo", "bar", "baz")
+    assert await r.llen("mylist") == 3
+    assert await r.lindex("mylist", 1) == b"bar"
+    assert cache.get(("LLEN", "mylist")) is None
+    assert cache.get(("LINDEX", "mylist", 1)) == b"bar"
+
+    await r.flushdb()
     await r.aclose()
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index 55a1c3a2f6..4ff3808602 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -68,8 +68,9 @@ async def call_with_retry(self, _, __):
             in_use = False
             return "foo"
 
-    mock_conn = mock.MagicMock()
+    mock_conn = mock.AsyncMock(spec=Connection)
     mock_conn.retry = Retry_()
+    mock_conn._get_from_local_cache.return_value = None
 
     async def get_conn(_):
         # Validate only one client is created in single-client mode when
diff --git a/tests/test_cache.py b/tests/test_cache.py
index 45621fe77e..85df8b1a22 100644
--- a/tests/test_cache.py
+++ b/tests/test_cache.py
@@ -2,34 +2,37 @@
 
 import pytest
 import redis
+from redis._cache import _LocalCache
 from redis.utils import HIREDIS_AVAILABLE
 
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 def test_get_from_cache():
-    r = redis.Redis(cache_enable=True, single_connection_client=True, protocol=3)
+    cache = _LocalCache()
+    r = redis.Redis(protocol=3, client_cache=cache)
     r2 = redis.Redis(protocol=3)
     # add key to redis
     r.set("foo", "bar")
     # get key from redis and save in local cache
     assert r.get("foo") == b"bar"
     # get key from local cache
-    assert r.client_cache.get(("GET", "foo")) == b"bar"
+    assert cache.get(("GET", "foo")) == b"bar"
     # change key in redis (cause invalidation)
     r2.set("foo", "barbar")
     # send any command to redis (process invalidation in background)
     r.ping()
     # the command is not in the local cache anymore
-    assert r.client_cache.get(("GET", "foo")) is None
+    assert cache.get(("GET", "foo")) is None
     # get key from redis
     assert r.get("foo") == b"barbar"
 
+    r.flushdb()
+
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 def test_cache_max_size():
-    r = redis.Redis(
-        cache_enable=True, cache_max_size=3, single_connection_client=True, protocol=3
-    )
+    cache = _LocalCache(max_size=3)
+    r = redis.Redis(client_cache=cache, protocol=3)
     # add 3 keys to redis
     r.set("foo", "bar")
     r.set("foo2", "bar2")
@@ -39,42 +42,40 @@ def test_cache_max_size():
     assert r.get("foo2") == b"bar2"
     assert r.get("foo3") == b"bar3"
     # get the 3 keys from local cache
-    assert r.client_cache.get(("GET", "foo")) == b"bar"
-    assert r.client_cache.get(("GET", "foo2")) == b"bar2"
-    assert r.client_cache.get(("GET", "foo3")) == b"bar3"
+    assert cache.get(("GET", "foo")) == b"bar"
+    assert cache.get(("GET", "foo2")) == b"bar2"
+    assert cache.get(("GET", "foo3")) == b"bar3"
     # add 1 more key to redis (exceed the max size)
     r.set("foo4", "bar4")
     assert r.get("foo4") == b"bar4"
     # the first key is not in the local cache anymore
-    assert r.client_cache.get(("GET", "foo")) is None
+    assert cache.get(("GET", "foo")) is None
+
+    r.flushdb()
 
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 def test_cache_ttl():
-    r = redis.Redis(
-        cache_enable=True, cache_ttl=1, single_connection_client=True, protocol=3
-    )
+    cache = _LocalCache(ttl=1)
+    r = redis.Redis(client_cache=cache, protocol=3)
     # add key to redis
     r.set("foo", "bar")
     # get key from redis and save in local cache
     assert r.get("foo") == b"bar"
     # get key from local cache
-    assert r.client_cache.get(("GET", "foo")) == b"bar"
+    assert cache.get(("GET", "foo")) == b"bar"
     # wait for the key to expire
     time.sleep(1)
     # the key is not in the local cache anymore
-    assert r.client_cache.get(("GET", "foo")) is None
+    assert cache.get(("GET", "foo")) is None
+
+    r.flushdb()
 
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 def test_cache_lfu_eviction():
-    r = redis.Redis(
-        cache_enable=True,
-        cache_max_size=3,
-        cache_eviction_policy="lfu",
-        single_connection_client=True,
-        protocol=3,
-    )
+    cache = _LocalCache(max_size=3, eviction_policy="lfu")
+    r = redis.Redis(client_cache=cache, protocol=3)
     # add 3 keys to redis
     r.set("foo", "bar")
     r.set("foo2", "bar2")
@@ -84,36 +85,50 @@ def test_cache_lfu_eviction():
     assert r.get("foo2") == b"bar2"
     assert r.get("foo3") == b"bar3"
     # change the order of the keys in the cache
-    assert r.client_cache.get(("GET", "foo")) == b"bar"
-    assert r.client_cache.get(("GET", "foo")) == b"bar"
-    assert r.client_cache.get(("GET", "foo3")) == b"bar3"
+    assert cache.get(("GET", "foo")) == b"bar"
+    assert cache.get(("GET", "foo")) == b"bar"
+    assert cache.get(("GET", "foo3")) == b"bar3"
     # add 1 more key to redis (exceed the max size)
     r.set("foo4", "bar4")
     assert r.get("foo4") == b"bar4"
     # test the eviction policy
-    assert len(r.client_cache.cache) == 3
-    assert r.client_cache.get(("GET", "foo")) == b"bar"
-    assert r.client_cache.get(("GET", "foo2")) is None
+    assert len(cache.cache) == 3
+    assert cache.get(("GET", "foo")) == b"bar"
+    assert cache.get(("GET", "foo2")) is None
+
+    r.flushdb()
 
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 def test_cache_decode_response():
-    r = redis.Redis(
-        decode_responses=True,
-        cache_enable=True,
-        single_connection_client=True,
-        protocol=3,
-    )
+    cache = _LocalCache()
+    r = redis.Redis(decode_responses=True, client_cache=cache, protocol=3)
     r.set("foo", "bar")
     # get key from redis and save in local cache
     assert r.get("foo") == "bar"
     # get key from local cache
-    assert r.client_cache.get(("GET", "foo")) == "bar"
+    assert cache.get(("GET", "foo")) == "bar"
     # change key in redis (cause invalidation)
     r.set("foo", "barbar")
     # send any command to redis (process invalidation in background)
     r.ping()
     # the command is not in the local cache anymore
-    assert r.client_cache.get(("GET", "foo")) is None
+    assert cache.get(("GET", "foo")) is None
     # get key from redis
     assert r.get("foo") == "barbar"
+
+    r.flushdb()
+
+
+@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+def test_cache_blacklist():
+    cache = _LocalCache()
+    r = redis.Redis(client_cache=cache, cache_blacklist=["LLEN"], protocol=3)
+    # add list to redis
+    r.lpush("mylist", "foo", "bar", "baz")
+    assert r.llen("mylist") == 3
+    assert r.lindex("mylist", 1) == b"bar"
+    assert cache.get(("LLEN", "mylist")) is None
+    assert cache.get(("LINDEX", "mylist", 1)) == b"bar"
+
+    r.flushdb()

From b5d4d29409f83e9a0056c6ed12414bf58e1ea1c0 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 7 Jan 2024 14:46:23 +0200
Subject: [PATCH 0828/1164] Version 5.1.0b2 (#3100)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 8329f00066..795aecd142 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="5.1.0b1",
+    version="5.1.0b2",
     packages=find_packages(
         include=[
             "redis",

From c7a13ae3f2529ee3f1bd0b5f991de4d06c33a6db Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Tue, 9 Jan 2024 12:47:00 +0200
Subject: [PATCH 0829/1164] Support client side caching with RedisCluster
 (#3102)

* sync

* fix mock_node_resp

* fix mock_node_resp_func

* fix test_handling_cluster_failover_to_a_replica

* fix test_handling_cluster_failover_to_a_replica

* async cluster and cleanup tests

* delete comment
---
 redis/asyncio/cluster.py           |  46 ++++-
 redis/asyncio/connection.py        |   4 +
 redis/cluster.py                   |  29 ++-
 tests/conftest.py                  |   2 +-
 tests/test_asyncio/conftest.py     |   3 +-
 tests/test_asyncio/test_cache.py   | 291 ++++++++++++++++-------------
 tests/test_asyncio/test_cluster.py |   2 +
 tests/test_cache.py                | 286 ++++++++++++++++------------
 tests/test_cluster.py              |   3 +
 9 files changed, 398 insertions(+), 268 deletions(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 6a1753ad19..486053e1cc 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -18,6 +18,12 @@
     Union,
 )
 
+from redis._cache import (
+    DEFAULT_BLACKLIST,
+    DEFAULT_EVICTION_POLICY,
+    DEFAULT_WHITELIST,
+    _LocalCache,
+)
 from redis._parsers import AsyncCommandsParser, Encoder
 from redis._parsers.helpers import (
     _RedisCallbacks,
@@ -267,6 +273,13 @@ def __init__(
         ssl_keyfile: Optional[str] = None,
         protocol: Optional[int] = 2,
         address_remap: Optional[Callable[[str, int], Tuple[str, int]]] = None,
+        cache_enable: bool = False,
+        client_cache: Optional[_LocalCache] = None,
+        cache_max_size: int = 100,
+        cache_ttl: int = 0,
+        cache_eviction_policy: str = DEFAULT_EVICTION_POLICY,
+        cache_blacklist: List[str] = DEFAULT_BLACKLIST,
+        cache_whitelist: List[str] = DEFAULT_WHITELIST,
     ) -> None:
         if db:
             raise RedisClusterException(
@@ -310,6 +323,14 @@ def __init__(
             "socket_timeout": socket_timeout,
             "retry": retry,
             "protocol": protocol,
+            # Client cache related kwargs
+            "cache_enable": cache_enable,
+            "client_cache": client_cache,
+            "cache_max_size": cache_max_size,
+            "cache_ttl": cache_ttl,
+            "cache_eviction_policy": cache_eviction_policy,
+            "cache_blacklist": cache_blacklist,
+            "cache_whitelist": cache_whitelist,
         }
 
         if ssl:
@@ -682,7 +703,6 @@ async def execute_command(self, *args: EncodableT, **kwargs: Any) -> Any:
         :raises RedisClusterException: if target_nodes is not provided & the command
             can't be mapped to a slot
         """
-        kwargs.pop("keys", None)  # the keys are used only for client side caching
         command = args[0]
         target_nodes = []
         target_nodes_specified = False
@@ -1039,16 +1059,24 @@ async def parse_response(
     async def execute_command(self, *args: Any, **kwargs: Any) -> Any:
         # Acquire connection
         connection = self.acquire_connection()
+        keys = kwargs.pop("keys", None)
 
-        # Execute command
-        await connection.send_packed_command(connection.pack_command(*args), False)
-
-        # Read response
-        try:
-            return await self.parse_response(connection, args[0], **kwargs)
-        finally:
-            # Release connection
+        response_from_cache = await connection._get_from_local_cache(args)
+        if response_from_cache is not None:
             self._free.append(connection)
+            return response_from_cache
+        else:
+            # Execute command
+            await connection.send_packed_command(connection.pack_command(*args), False)
+
+            # Read response
+            try:
+                response = await self.parse_response(connection, args[0], **kwargs)
+                connection._add_to_local_cache(args, response, keys)
+                return response
+            finally:
+                # Release connection
+                self._free.append(connection)
 
     async def execute_pipeline(self, commands: List["PipelineCommand"]) -> bool:
         # Acquire connection
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 7f1c0b71e4..05a27879a6 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -227,6 +227,10 @@ def __init__(
             _cache = None
         self.client_cache = client_cache if client_cache is not None else _cache
         if self.client_cache is not None:
+            if self.protocol not in [3, "3"]:
+                raise RedisError(
+                    "client caching is only supported with protocol version 3 or higher"
+                )
             self.cache_blacklist = cache_blacklist
             self.cache_whitelist = cache_whitelist
 
diff --git a/redis/cluster.py b/redis/cluster.py
index 8032173e66..7bdf4c1951 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -167,6 +167,13 @@ def parse_cluster_myshardid(resp, **options):
     "ssl_password",
     "unix_socket_path",
     "username",
+    "cache_enable",
+    "client_cache",
+    "cache_max_size",
+    "cache_ttl",
+    "cache_eviction_policy",
+    "cache_blacklist",
+    "cache_whitelist",
 )
 KWARGS_DISABLED_KEYS = ("host", "port")
 
@@ -1060,7 +1067,6 @@ def execute_command(self, *args, **kwargs):
             list<ClusterNode>
             dict<Any, ClusterNode>
         """
-        kwargs.pop("keys", None)  # the keys are used only for client side caching
         target_nodes_specified = False
         is_default_node = False
         target_nodes = None
@@ -1119,6 +1125,7 @@ def _execute_command(self, target_node, *args, **kwargs):
         """
         Send a command to a node in the cluster
         """
+        keys = kwargs.pop("keys", None)
         command = args[0]
         redis_node = None
         connection = None
@@ -1147,14 +1154,18 @@ def _execute_command(self, target_node, *args, **kwargs):
                     connection.send_command("ASKING")
                     redis_node.parse_response(connection, "ASKING", **kwargs)
                     asking = False
-
-                connection.send_command(*args)
-                response = redis_node.parse_response(connection, command, **kwargs)
-                if command in self.cluster_response_callbacks:
-                    response = self.cluster_response_callbacks[command](
-                        response, **kwargs
-                    )
-                return response
+                response_from_cache = connection._get_from_local_cache(args)
+                if response_from_cache is not None:
+                    return response_from_cache
+                else:
+                    connection.send_command(*args)
+                    response = redis_node.parse_response(connection, command, **kwargs)
+                    if command in self.cluster_response_callbacks:
+                        response = self.cluster_response_callbacks[command](
+                            response, **kwargs
+                        )
+                    connection._add_to_local_cache(args, response, keys)
+                    return response
             except AuthenticationError:
                 raise
             except (ConnectionError, TimeoutError) as e:
diff --git a/tests/conftest.py b/tests/conftest.py
index e56b5f6aed..8786e2b9f0 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -275,7 +275,7 @@ def _get_client(
         redis_url = request.config.getoption("--redis-url")
     else:
         redis_url = from_url
-    if "protocol" not in redis_url:
+    if "protocol" not in redis_url and kwargs.get("protocol") is None:
         kwargs["protocol"] = request.config.getoption("--protocol")
 
     cluster_mode = REDIS_INFO["cluster_enabled"]
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index c79b706abc..c6afec5af6 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -69,10 +69,9 @@ async def client_factory(
         url: str = request.config.getoption("--redis-url"),
         cls=redis.Redis,
         flushdb=True,
-        protocol=request.config.getoption("--protocol"),
         **kwargs,
     ):
-        if "protocol" not in url:
+        if "protocol" not in url and kwargs.get("protocol") is None:
             kwargs["protocol"] = request.config.getoption("--protocol")
 
         cluster_mode = REDIS_INFO["cluster_enabled"]
diff --git a/tests/test_asyncio/test_cache.py b/tests/test_asyncio/test_cache.py
index 92328b8391..098ede8d75 100644
--- a/tests/test_asyncio/test_cache.py
+++ b/tests/test_asyncio/test_cache.py
@@ -1,140 +1,177 @@
 import time
 
 import pytest
-import redis.asyncio as redis
+import pytest_asyncio
 from redis._cache import _LocalCache
 from redis.utils import HIREDIS_AVAILABLE
 
 
-@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
-async def test_get_from_cache():
-    cache = _LocalCache()
-    r = redis.Redis(protocol=3, client_cache=cache)
-    r2 = redis.Redis(protocol=3)
-    # add key to redis
-    await r.set("foo", "bar")
-    # get key from redis and save in local cache
-    assert await r.get("foo") == b"bar"
-    # get key from local cache
-    assert cache.get(("GET", "foo")) == b"bar"
-    # change key in redis (cause invalidation)
-    await r2.set("foo", "barbar")
-    # send any command to redis (process invalidation in background)
-    await r.ping()
-    # the command is not in the local cache anymore
-    assert cache.get(("GET", "foo")) is None
-    # get key from redis
-    assert await r.get("foo") == b"barbar"
-
-    await r.flushdb()
-    await r.aclose()
-
-
-@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
-async def test_cache_max_size():
-    cache = _LocalCache(max_size=3)
-    r = redis.Redis(client_cache=cache, protocol=3)
-    # add 3 keys to redis
-    await r.set("foo", "bar")
-    await r.set("foo2", "bar2")
-    await r.set("foo3", "bar3")
-    # get 3 keys from redis and save in local cache
-    assert await r.get("foo") == b"bar"
-    assert await r.get("foo2") == b"bar2"
-    assert await r.get("foo3") == b"bar3"
-    # get the 3 keys from local cache
-    assert cache.get(("GET", "foo")) == b"bar"
-    assert cache.get(("GET", "foo2")) == b"bar2"
-    assert cache.get(("GET", "foo3")) == b"bar3"
-    # add 1 more key to redis (exceed the max size)
-    await r.set("foo4", "bar4")
-    assert await r.get("foo4") == b"bar4"
-    # the first key is not in the local cache anymore
-    assert cache.get(("GET", "foo")) is None
-
-    await r.flushdb()
-    await r.aclose()
-
-
-@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
-async def test_cache_ttl():
-    cache = _LocalCache(ttl=1)
-    r = redis.Redis(client_cache=cache, protocol=3)
-    # add key to redis
-    await r.set("foo", "bar")
-    # get key from redis and save in local cache
-    assert await r.get("foo") == b"bar"
-    # get key from local cache
-    assert cache.get(("GET", "foo")) == b"bar"
-    # wait for the key to expire
-    time.sleep(1)
-    # the key is not in the local cache anymore
-    assert cache.get(("GET", "foo")) is None
-
-    await r.flushdb()
-    await r.aclose()
-
-
-@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
-async def test_cache_lfu_eviction():
-    cache = _LocalCache(max_size=3, eviction_policy="lfu")
-    r = redis.Redis(client_cache=cache, protocol=3)
-    # add 3 keys to redis
-    await r.set("foo", "bar")
-    await r.set("foo2", "bar2")
-    await r.set("foo3", "bar3")
-    # get 3 keys from redis and save in local cache
-    assert await r.get("foo") == b"bar"
-    assert await r.get("foo2") == b"bar2"
-    assert await r.get("foo3") == b"bar3"
-    # change the order of the keys in the cache
-    assert cache.get(("GET", "foo")) == b"bar"
-    assert cache.get(("GET", "foo")) == b"bar"
-    assert cache.get(("GET", "foo3")) == b"bar3"
-    # add 1 more key to redis (exceed the max size)
-    await r.set("foo4", "bar4")
-    assert await r.get("foo4") == b"bar4"
-    # test the eviction policy
-    assert len(cache.cache) == 3
-    assert cache.get(("GET", "foo")) == b"bar"
-    assert cache.get(("GET", "foo2")) is None
-
-    await r.flushdb()
-    await r.aclose()
+@pytest_asyncio.fixture
+async def r(request, create_redis):
+    cache = request.param.get("cache")
+    kwargs = request.param.get("kwargs", {})
+    r = await create_redis(protocol=3, client_cache=cache, **kwargs)
+    yield r, cache
 
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
-async def test_cache_decode_response():
-    cache = _LocalCache()
-    r = redis.Redis(decode_responses=True, client_cache=cache, protocol=3)
-    await r.set("foo", "bar")
-    # get key from redis and save in local cache
-    assert await r.get("foo") == "bar"
-    # get key from local cache
-    assert cache.get(("GET", "foo")) == "bar"
-    # change key in redis (cause invalidation)
-    await r.set("foo", "barbar")
-    # send any command to redis (process invalidation in background)
-    await r.ping()
-    # the command is not in the local cache anymore
-    assert cache.get(("GET", "foo")) is None
-    # get key from redis
-    assert await r.get("foo") == "barbar"
-
-    await r.flushdb()
-    await r.aclose()
+class TestLocalCache:
+    @pytest.mark.onlynoncluster
+    @pytest.mark.parametrize("r", [{"cache": _LocalCache()}], indirect=True)
+    async def test_get_from_cache(self, r, r2):
+        r, cache = r
+        # add key to redis
+        await r.set("foo", "bar")
+        # get key from redis and save in local cache
+        assert await r.get("foo") == b"bar"
+        # get key from local cache
+        assert cache.get(("GET", "foo")) == b"bar"
+        # change key in redis (cause invalidation)
+        await r2.set("foo", "barbar")
+        # send any command to redis (process invalidation in background)
+        await r.ping()
+        # the command is not in the local cache anymore
+        assert cache.get(("GET", "foo")) is None
+        # get key from redis
+        assert await r.get("foo") == b"barbar"
+
+    @pytest.mark.parametrize("r", [{"cache": _LocalCache(max_size=3)}], indirect=True)
+    async def test_cache_max_size(self, r):
+        r, cache = r
+        # add 3 keys to redis
+        await r.set("foo", "bar")
+        await r.set("foo2", "bar2")
+        await r.set("foo3", "bar3")
+        # get 3 keys from redis and save in local cache
+        assert await r.get("foo") == b"bar"
+        assert await r.get("foo2") == b"bar2"
+        assert await r.get("foo3") == b"bar3"
+        # get the 3 keys from local cache
+        assert cache.get(("GET", "foo")) == b"bar"
+        assert cache.get(("GET", "foo2")) == b"bar2"
+        assert cache.get(("GET", "foo3")) == b"bar3"
+        # add 1 more key to redis (exceed the max size)
+        await r.set("foo4", "bar4")
+        assert await r.get("foo4") == b"bar4"
+        # the first key is not in the local cache anymore
+        assert cache.get(("GET", "foo")) is None
+
+    @pytest.mark.parametrize("r", [{"cache": _LocalCache(ttl=1)}], indirect=True)
+    async def test_cache_ttl(self, r):
+        r, cache = r
+        # add key to redis
+        await r.set("foo", "bar")
+        # get key from redis and save in local cache
+        assert await r.get("foo") == b"bar"
+        # get key from local cache
+        assert cache.get(("GET", "foo")) == b"bar"
+        # wait for the key to expire
+        time.sleep(1)
+        # the key is not in the local cache anymore
+        assert cache.get(("GET", "foo")) is None
+
+    @pytest.mark.parametrize(
+        "r", [{"cache": _LocalCache(max_size=3, eviction_policy="lfu")}], indirect=True
+    )
+    async def test_cache_lfu_eviction(self, r):
+        r, cache = r
+        # add 3 keys to redis
+        await r.set("foo", "bar")
+        await r.set("foo2", "bar2")
+        await r.set("foo3", "bar3")
+        # get 3 keys from redis and save in local cache
+        assert await r.get("foo") == b"bar"
+        assert await r.get("foo2") == b"bar2"
+        assert await r.get("foo3") == b"bar3"
+        # change the order of the keys in the cache
+        assert cache.get(("GET", "foo")) == b"bar"
+        assert cache.get(("GET", "foo")) == b"bar"
+        assert cache.get(("GET", "foo3")) == b"bar3"
+        # add 1 more key to redis (exceed the max size)
+        await r.set("foo4", "bar4")
+        assert await r.get("foo4") == b"bar4"
+        # test the eviction policy
+        assert len(cache.cache) == 3
+        assert cache.get(("GET", "foo")) == b"bar"
+        assert cache.get(("GET", "foo2")) is None
+
+    @pytest.mark.onlynoncluster
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    async def test_cache_decode_response(self, r):
+        r, cache = r
+        await r.set("foo", "bar")
+        # get key from redis and save in local cache
+        assert await r.get("foo") == "bar"
+        # get key from local cache
+        assert cache.get(("GET", "foo")) == "bar"
+        # change key in redis (cause invalidation)
+        await r.set("foo", "barbar")
+        # send any command to redis (process invalidation in background)
+        await r.ping()
+        # the command is not in the local cache anymore
+        assert cache.get(("GET", "foo")) is None
+        # get key from redis
+        assert await r.get("foo") == "barbar"
+
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"cache_blacklist": ["LLEN"]}}],
+        indirect=True,
+    )
+    async def test_cache_blacklist(self, r):
+        r, cache = r
+        # add list to redis
+        await r.lpush("mylist", "foo", "bar", "baz")
+        assert await r.llen("mylist") == 3
+        assert await r.lindex("mylist", 1) == b"bar"
+        assert cache.get(("LLEN", "mylist")) is None
+        assert cache.get(("LINDEX", "mylist", 1)) == b"bar"
 
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
-async def test_cache_blacklist():
-    cache = _LocalCache()
-    r = redis.Redis(client_cache=cache, cache_blacklist=["LLEN"], protocol=3)
-    # add list to redis
-    await r.lpush("mylist", "foo", "bar", "baz")
-    assert await r.llen("mylist") == 3
-    assert await r.lindex("mylist", 1) == b"bar"
-    assert cache.get(("LLEN", "mylist")) is None
-    assert cache.get(("LINDEX", "mylist", 1)) == b"bar"
-
-    await r.flushdb()
-    await r.aclose()
+@pytest.mark.onlycluster
+class TestClusterLocalCache:
+    @pytest.mark.parametrize("r", [{"cache": _LocalCache()}], indirect=True)
+    async def test_get_from_cache(self, r, r2):
+        r, cache = r
+        # add key to redis
+        await r.set("foo", "bar")
+        # get key from redis and save in local cache
+        assert await r.get("foo") == b"bar"
+        # get key from local cache
+        assert cache.get(("GET", "foo")) == b"bar"
+        # change key in redis (cause invalidation)
+        await r2.set("foo", "barbar")
+        # send any command to redis (process invalidation in background)
+        node = r.get_node_from_key("foo")
+        await r.ping(target_nodes=node)
+        # the command is not in the local cache anymore
+        assert cache.get(("GET", "foo")) is None
+        # get key from redis
+        assert await r.get("foo") == b"barbar"
+
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    async def test_cache_decode_response(self, r):
+        r, cache = r
+        await r.set("foo", "bar")
+        # get key from redis and save in local cache
+        assert await r.get("foo") == "bar"
+        # get key from local cache
+        assert cache.get(("GET", "foo")) == "bar"
+        # change key in redis (cause invalidation)
+        await r.set("foo", "barbar")
+        # send any command to redis (process invalidation in background)
+        node = r.get_node_from_key("foo")
+        await r.ping(target_nodes=node)
+        # the command is not in the local cache anymore
+        assert cache.get(("GET", "foo")) is None
+        # get key from redis
+        assert await r.get("foo") == "barbar"
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index e6cf2e4ce7..a57d32f5d2 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -178,6 +178,7 @@ def mock_node_resp(node: ClusterNode, response: Any) -> ClusterNode:
     connection = mock.AsyncMock(spec=Connection)
     connection.is_connected = True
     connection.read_response.return_value = response
+    connection._get_from_local_cache.return_value = None
     while node._free:
         node._free.pop()
     node._free.append(connection)
@@ -188,6 +189,7 @@ def mock_node_resp_exc(node: ClusterNode, exc: Exception) -> ClusterNode:
     connection = mock.AsyncMock(spec=Connection)
     connection.is_connected = True
     connection.read_response.side_effect = exc
+    connection._get_from_local_cache.return_value = None
     while node._free:
         node._free.pop()
     node._free.append(connection)
diff --git a/tests/test_cache.py b/tests/test_cache.py
index 85df8b1a22..570385a4b5 100644
--- a/tests/test_cache.py
+++ b/tests/test_cache.py
@@ -4,131 +4,177 @@
 import redis
 from redis._cache import _LocalCache
 from redis.utils import HIREDIS_AVAILABLE
+from tests.conftest import _get_client
 
 
-@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
-def test_get_from_cache():
-    cache = _LocalCache()
-    r = redis.Redis(protocol=3, client_cache=cache)
-    r2 = redis.Redis(protocol=3)
-    # add key to redis
-    r.set("foo", "bar")
-    # get key from redis and save in local cache
-    assert r.get("foo") == b"bar"
-    # get key from local cache
-    assert cache.get(("GET", "foo")) == b"bar"
-    # change key in redis (cause invalidation)
-    r2.set("foo", "barbar")
-    # send any command to redis (process invalidation in background)
-    r.ping()
-    # the command is not in the local cache anymore
-    assert cache.get(("GET", "foo")) is None
-    # get key from redis
-    assert r.get("foo") == b"barbar"
-
-    r.flushdb()
-
-
-@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
-def test_cache_max_size():
-    cache = _LocalCache(max_size=3)
-    r = redis.Redis(client_cache=cache, protocol=3)
-    # add 3 keys to redis
-    r.set("foo", "bar")
-    r.set("foo2", "bar2")
-    r.set("foo3", "bar3")
-    # get 3 keys from redis and save in local cache
-    assert r.get("foo") == b"bar"
-    assert r.get("foo2") == b"bar2"
-    assert r.get("foo3") == b"bar3"
-    # get the 3 keys from local cache
-    assert cache.get(("GET", "foo")) == b"bar"
-    assert cache.get(("GET", "foo2")) == b"bar2"
-    assert cache.get(("GET", "foo3")) == b"bar3"
-    # add 1 more key to redis (exceed the max size)
-    r.set("foo4", "bar4")
-    assert r.get("foo4") == b"bar4"
-    # the first key is not in the local cache anymore
-    assert cache.get(("GET", "foo")) is None
-
-    r.flushdb()
-
-
-@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
-def test_cache_ttl():
-    cache = _LocalCache(ttl=1)
-    r = redis.Redis(client_cache=cache, protocol=3)
-    # add key to redis
-    r.set("foo", "bar")
-    # get key from redis and save in local cache
-    assert r.get("foo") == b"bar"
-    # get key from local cache
-    assert cache.get(("GET", "foo")) == b"bar"
-    # wait for the key to expire
-    time.sleep(1)
-    # the key is not in the local cache anymore
-    assert cache.get(("GET", "foo")) is None
-
-    r.flushdb()
-
-
-@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
-def test_cache_lfu_eviction():
-    cache = _LocalCache(max_size=3, eviction_policy="lfu")
-    r = redis.Redis(client_cache=cache, protocol=3)
-    # add 3 keys to redis
-    r.set("foo", "bar")
-    r.set("foo2", "bar2")
-    r.set("foo3", "bar3")
-    # get 3 keys from redis and save in local cache
-    assert r.get("foo") == b"bar"
-    assert r.get("foo2") == b"bar2"
-    assert r.get("foo3") == b"bar3"
-    # change the order of the keys in the cache
-    assert cache.get(("GET", "foo")) == b"bar"
-    assert cache.get(("GET", "foo")) == b"bar"
-    assert cache.get(("GET", "foo3")) == b"bar3"
-    # add 1 more key to redis (exceed the max size)
-    r.set("foo4", "bar4")
-    assert r.get("foo4") == b"bar4"
-    # test the eviction policy
-    assert len(cache.cache) == 3
-    assert cache.get(("GET", "foo")) == b"bar"
-    assert cache.get(("GET", "foo2")) is None
-
-    r.flushdb()
+@pytest.fixture()
+def r(request):
+    cache = request.param.get("cache")
+    kwargs = request.param.get("kwargs", {})
+    with _get_client(
+        redis.Redis, request, protocol=3, client_cache=cache, **kwargs
+    ) as client:
+        yield client, cache
 
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
-def test_cache_decode_response():
-    cache = _LocalCache()
-    r = redis.Redis(decode_responses=True, client_cache=cache, protocol=3)
-    r.set("foo", "bar")
-    # get key from redis and save in local cache
-    assert r.get("foo") == "bar"
-    # get key from local cache
-    assert cache.get(("GET", "foo")) == "bar"
-    # change key in redis (cause invalidation)
-    r.set("foo", "barbar")
-    # send any command to redis (process invalidation in background)
-    r.ping()
-    # the command is not in the local cache anymore
-    assert cache.get(("GET", "foo")) is None
-    # get key from redis
-    assert r.get("foo") == "barbar"
-
-    r.flushdb()
+class TestLocalCache:
+    @pytest.mark.onlynoncluster
+    @pytest.mark.parametrize("r", [{"cache": _LocalCache()}], indirect=True)
+    def test_get_from_cache(self, r, r2):
+        r, cache = r
+        # add key to redis
+        r.set("foo", "bar")
+        # get key from redis and save in local cache
+        assert r.get("foo") == b"bar"
+        # get key from local cache
+        assert cache.get(("GET", "foo")) == b"bar"
+        # change key in redis (cause invalidation)
+        r2.set("foo", "barbar")
+        # send any command to redis (process invalidation in background)
+        r.ping()
+        # the command is not in the local cache anymore
+        assert cache.get(("GET", "foo")) is None
+        # get key from redis
+        assert r.get("foo") == b"barbar"
+
+    @pytest.mark.parametrize("r", [{"cache": _LocalCache(max_size=3)}], indirect=True)
+    def test_cache_max_size(self, r):
+        r, cache = r
+        # add 3 keys to redis
+        r.set("foo", "bar")
+        r.set("foo2", "bar2")
+        r.set("foo3", "bar3")
+        # get 3 keys from redis and save in local cache
+        assert r.get("foo") == b"bar"
+        assert r.get("foo2") == b"bar2"
+        assert r.get("foo3") == b"bar3"
+        # get the 3 keys from local cache
+        assert cache.get(("GET", "foo")) == b"bar"
+        assert cache.get(("GET", "foo2")) == b"bar2"
+        assert cache.get(("GET", "foo3")) == b"bar3"
+        # add 1 more key to redis (exceed the max size)
+        r.set("foo4", "bar4")
+        assert r.get("foo4") == b"bar4"
+        # the first key is not in the local cache anymore
+        assert cache.get(("GET", "foo")) is None
+
+    @pytest.mark.parametrize("r", [{"cache": _LocalCache(ttl=1)}], indirect=True)
+    def test_cache_ttl(self, r):
+        r, cache = r
+        # add key to redis
+        r.set("foo", "bar")
+        # get key from redis and save in local cache
+        assert r.get("foo") == b"bar"
+        # get key from local cache
+        assert cache.get(("GET", "foo")) == b"bar"
+        # wait for the key to expire
+        time.sleep(1)
+        # the key is not in the local cache anymore
+        assert cache.get(("GET", "foo")) is None
+
+    @pytest.mark.parametrize(
+        "r", [{"cache": _LocalCache(max_size=3, eviction_policy="lfu")}], indirect=True
+    )
+    def test_cache_lfu_eviction(self, r):
+        r, cache = r
+        # add 3 keys to redis
+        r.set("foo", "bar")
+        r.set("foo2", "bar2")
+        r.set("foo3", "bar3")
+        # get 3 keys from redis and save in local cache
+        assert r.get("foo") == b"bar"
+        assert r.get("foo2") == b"bar2"
+        assert r.get("foo3") == b"bar3"
+        # change the order of the keys in the cache
+        assert cache.get(("GET", "foo")) == b"bar"
+        assert cache.get(("GET", "foo")) == b"bar"
+        assert cache.get(("GET", "foo3")) == b"bar3"
+        # add 1 more key to redis (exceed the max size)
+        r.set("foo4", "bar4")
+        assert r.get("foo4") == b"bar4"
+        # test the eviction policy
+        assert len(cache.cache) == 3
+        assert cache.get(("GET", "foo")) == b"bar"
+        assert cache.get(("GET", "foo2")) is None
+
+    @pytest.mark.onlynoncluster
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    def test_cache_decode_response(self, r):
+        r, cache = r
+        r.set("foo", "bar")
+        # get key from redis and save in local cache
+        assert r.get("foo") == "bar"
+        # get key from local cache
+        assert cache.get(("GET", "foo")) == "bar"
+        # change key in redis (cause invalidation)
+        r.set("foo", "barbar")
+        # send any command to redis (process invalidation in background)
+        r.ping()
+        # the command is not in the local cache anymore
+        assert cache.get(("GET", "foo")) is None
+        # get key from redis
+        assert r.get("foo") == "barbar"
+
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"cache_blacklist": ["LLEN"]}}],
+        indirect=True,
+    )
+    def test_cache_blacklist(self, r):
+        r, cache = r
+        # add list to redis
+        r.lpush("mylist", "foo", "bar", "baz")
+        assert r.llen("mylist") == 3
+        assert r.lindex("mylist", 1) == b"bar"
+        assert cache.get(("LLEN", "mylist")) is None
+        assert cache.get(("LINDEX", "mylist", 1)) == b"bar"
 
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
-def test_cache_blacklist():
-    cache = _LocalCache()
-    r = redis.Redis(client_cache=cache, cache_blacklist=["LLEN"], protocol=3)
-    # add list to redis
-    r.lpush("mylist", "foo", "bar", "baz")
-    assert r.llen("mylist") == 3
-    assert r.lindex("mylist", 1) == b"bar"
-    assert cache.get(("LLEN", "mylist")) is None
-    assert cache.get(("LINDEX", "mylist", 1)) == b"bar"
-
-    r.flushdb()
+@pytest.mark.onlycluster
+class TestClusterLocalCache:
+    @pytest.mark.parametrize("r", [{"cache": _LocalCache()}], indirect=True)
+    def test_get_from_cache(self, r, r2):
+        r, cache = r
+        # add key to redis
+        r.set("foo", "bar")
+        # get key from redis and save in local cache
+        assert r.get("foo") == b"bar"
+        # get key from local cache
+        assert cache.get(("GET", "foo")) == b"bar"
+        # change key in redis (cause invalidation)
+        r2.set("foo", "barbar")
+        # send any command to redis (process invalidation in background)
+        node = r.get_node_from_key("foo")
+        r.ping(target_nodes=node)
+        # the command is not in the local cache anymore
+        assert cache.get(("GET", "foo")) is None
+        # get key from redis
+        assert r.get("foo") == b"barbar"
+
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    def test_cache_decode_response(self, r):
+        r, cache = r
+        r.set("foo", "bar")
+        # get key from redis and save in local cache
+        assert r.get("foo") == "bar"
+        # get key from local cache
+        assert cache.get(("GET", "foo")) == "bar"
+        # change key in redis (cause invalidation)
+        r.set("foo", "barbar")
+        # send any command to redis (process invalidation in background)
+        node = r.get_node_from_key("foo")
+        r.ping(target_nodes=node)
+        # the command is not in the local cache anymore
+        assert cache.get(("GET", "foo")) is None
+        # get key from redis
+        assert r.get("foo") == "barbar"
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index ae194db3a2..854b64c563 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -202,6 +202,7 @@ def cmd_init_mock(self, r):
 def mock_node_resp(node, response):
     connection = Mock()
     connection.read_response.return_value = response
+    connection._get_from_local_cache.return_value = None
     node.redis_connection.connection = connection
     return node
 
@@ -209,6 +210,7 @@ def mock_node_resp(node, response):
 def mock_node_resp_func(node, func):
     connection = Mock()
     connection.read_response.side_effect = func
+    connection._get_from_local_cache.return_value = None
     node.redis_connection.connection = connection
     return node
 
@@ -477,6 +479,7 @@ def mock_execute_command(*_args, **_kwargs):
         redis_mock_node.execute_command.side_effect = mock_execute_command
         # Mock response value for all other commands
         redis_mock_node.parse_response.return_value = "MOCK_OK"
+        redis_mock_node.connection._get_from_local_cache.return_value = None
         for node in r.get_nodes():
             if node.port != primary.port:
                 node.redis_connection = redis_mock_node

From 63932bb0a1bc876410241786b863420e7d1d33e1 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 9 Jan 2024 13:22:09 +0200
Subject: [PATCH 0830/1164] Always sending codecov (#3101)

---
 .github/workflows/integration.yaml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index f4ba256359..7aaf346170 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -89,7 +89,6 @@ jobs:
 
        - name: Upload codecov coverage
          uses: codecov/codecov-action@v3
-         if: ${{matrix.python-version == '3.11'}}
          with:
            fail_ci_if_error: false
 

From 902754b843e6cf1174a114322eea417ee467d454 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Tue, 9 Jan 2024 13:43:40 +0200
Subject: [PATCH 0831/1164] filter commits for main branch (#3036)

---
 .github/release-drafter-config.yml | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/.github/release-drafter-config.yml b/.github/release-drafter-config.yml
index 9ccb28aca4..4607da071c 100644
--- a/.github/release-drafter-config.yml
+++ b/.github/release-drafter-config.yml
@@ -1,5 +1,7 @@
 name-template: '$NEXT_MINOR_VERSION'
 tag-template: 'v$NEXT_MINOR_VERSION'
+filter-by-commitish: true
+commitish: master
 autolabeler:
   - label: 'maintenance'
     files:
@@ -15,7 +17,7 @@ autolabeler:
     branch:
       - '/feature-.+'
 categories:
-  - title: 'Breaking Changes'
+  - title: '🔥 Breaking Changes'
     labels:
       - 'breakingchange'
   - title: '🧪 Experimental Features'
@@ -32,7 +34,12 @@ categories:
       - 'bug'
       - 'BUG'
   - title: '🧰 Maintenance'
-    label: 'maintenance'
+    labels:
+      - 'maintenance'
+      - 'dependencies'
+      - 'documentation'
+      - 'docs'
+      - 'testing'
 change-template: '- $TITLE (#$NUMBER)'
 exclude-labels:
   - 'skip-changelog'

From f9b6a5e2a7a1cf29c0044be80fdc237768493282 Mon Sep 17 00:00:00 2001
From: "Wei-Hsiang (Matt) Wang" <mattwang44@gmail.com>
Date: Tue, 9 Jan 2024 19:46:08 +0800
Subject: [PATCH 0832/1164] fix(docs): organize cluster mode part of lua
 scripting (#3073)

---
 docs/lua_scripting.rst | 33 +++++++++++++++++++--------------
 1 file changed, 19 insertions(+), 14 deletions(-)

diff --git a/docs/lua_scripting.rst b/docs/lua_scripting.rst
index 0edb6b6723..bd7b9bc01d 100644
--- a/docs/lua_scripting.rst
+++ b/docs/lua_scripting.rst
@@ -92,19 +92,24 @@ Cluster Mode
 
 Cluster mode has limited support for lua scripting.
 
-The following commands are supported, with caveats: - ``EVAL`` and
-``EVALSHA``: The command is sent to the relevant node, depending on the
-keys (i.e., in ``EVAL "<script>" num_keys key_1 ... key_n ...``). The
-keys *must* all be on the same node. If the script requires 0 keys, *the
-command is sent to a random (primary) node*. - ``SCRIPT EXISTS``: The
-command is sent to all primaries. The result is a list of booleans
-corresponding to the input SHA hashes. Each boolean is an AND of “does
-the script exist on each node?”. In other words, each boolean is True
-iff the script exists on all nodes. - ``SCRIPT FLUSH``: The command is
-sent to all primaries. The result is a bool AND over all nodes’
-responses. - ``SCRIPT LOAD``: The command is sent to all primaries. The
-result is the SHA1 digest.
-
-The following commands are not supported: - ``EVAL_RO`` - ``EVALSHA_RO``
+The following commands are supported, with caveats:
+
+- ``EVAL`` and ``EVALSHA``: The command is sent to the relevant node,
+  depending on the keys (i.e., in ``EVAL "<script>" num_keys key_1 ...
+  key_n ...``). The keys *must* all be on the same node. If the script
+  requires 0 keys, *the command is sent to a random (primary) node*.
+- ``SCRIPT EXISTS``: The command is sent to all primaries. The result
+  is a list of booleans corresponding to the input SHA hashes. Each
+  boolean is an AND of “does the script exist on each node?”. In other
+  words, each boolean is True iff the script exists on all nodes.
+- ``SCRIPT FLUSH``: The command is sent to all primaries. The result
+  is a bool AND over all nodes’ responses.
+- ``SCRIPT LOAD``: The command is sent to all primaries. The result
+  is the SHA1 digest.
+
+The following commands are not supported:
+
+- ``EVAL_RO``
+- ``EVALSHA_RO``
 
 Using scripting within pipelines in cluster mode is **not supported**.

From bd4ce15f7ef872901a8457abd9a70e837aac6690 Mon Sep 17 00:00:00 2001
From: Dmitry Kulazhenko <dmkulazhenko@gmail.com>
Date: Tue, 9 Jan 2024 18:17:31 +0300
Subject: [PATCH 0833/1164] Fix typing for `HashCommand.hdel` (#3029)

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/commands/core.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 5d7b774dc3..2840dc0386 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -4927,7 +4927,7 @@ class HashCommands(CommandsProtocol):
     see: https://redis.io/topics/data-types-intro#redis-hashes
     """
 
-    def hdel(self, name: str, *keys: List) -> Union[Awaitable[int], int]:
+    def hdel(self, name: str, *keys: str) -> Union[Awaitable[int], int]:
         """
         Delete ``keys`` from hash ``name``
 

From 18bb01686e3af2f8ad086f838ce95672a78c12c4 Mon Sep 17 00:00:00 2001
From: Dan Lousqui <github@blusky.fr>
Date: Tue, 9 Jan 2024 16:17:44 +0100
Subject: [PATCH 0834/1164] Adding lock_name to LockError (#3023)

* Adding lock_name to LockError

* Adding lock_name to LockError

---------

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 CHANGES             |  1 +
 redis/exceptions.py |  5 ++++-
 redis/lock.py       | 33 ++++++++++++++++++++++++---------
 tests/test_lock.py  |  7 +++++++
 4 files changed, 36 insertions(+), 10 deletions(-)

diff --git a/CHANGES b/CHANGES
index 9e0db230c6..3d9d6292a1 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Add an optional lock_name attribute to LockError.
     * Fix return types for `get`, `set_path` and `strappend` in JSONCommands
     * Connection.register_connect_callback() is made public.
     * Fix async `read_response` to use `disable_decoding`.
diff --git a/redis/exceptions.py b/redis/exceptions.py
index 7cf15a7d07..ddb4041da3 100644
--- a/redis/exceptions.py
+++ b/redis/exceptions.py
@@ -81,7 +81,10 @@ class LockError(RedisError, ValueError):
     "Errors acquiring or releasing a lock"
     # NOTE: For backwards compatibility, this class derives from ValueError.
     # This was originally chosen to behave like threading.Lock.
-    pass
+
+    def __init__(self, message, lock_name=None):
+        self.message = message
+        self.lock_name = lock_name
 
 
 class LockNotOwnedError(LockError):
diff --git a/redis/lock.py b/redis/lock.py
index 4cca102d10..cae7f27ea1 100644
--- a/redis/lock.py
+++ b/redis/lock.py
@@ -157,7 +157,10 @@ def register_scripts(self) -> None:
     def __enter__(self) -> "Lock":
         if self.acquire():
             return self
-        raise LockError("Unable to acquire lock within the time specified")
+        raise LockError(
+            "Unable to acquire lock within the time specified",
+            lock_name=self.name,
+        )
 
     def __exit__(
         self,
@@ -248,7 +251,7 @@ def release(self) -> None:
         """
         expected_token = self.local.token
         if expected_token is None:
-            raise LockError("Cannot release an unlocked lock")
+            raise LockError("Cannot release an unlocked lock", lock_name=self.name)
         self.local.token = None
         self.do_release(expected_token)
 
@@ -256,7 +259,10 @@ def do_release(self, expected_token: str) -> None:
         if not bool(
             self.lua_release(keys=[self.name], args=[expected_token], client=self.redis)
         ):
-            raise LockNotOwnedError("Cannot release a lock that's no longer owned")
+            raise LockNotOwnedError(
+                "Cannot release a lock that's no longer owned",
+                lock_name=self.name,
+            )
 
     def extend(self, additional_time: int, replace_ttl: bool = False) -> bool:
         """
@@ -270,9 +276,9 @@ def extend(self, additional_time: int, replace_ttl: bool = False) -> bool:
         `additional_time`.
         """
         if self.local.token is None:
-            raise LockError("Cannot extend an unlocked lock")
+            raise LockError("Cannot extend an unlocked lock", lock_name=self.name)
         if self.timeout is None:
-            raise LockError("Cannot extend a lock with no timeout")
+            raise LockError("Cannot extend a lock with no timeout", lock_name=self.name)
         return self.do_extend(additional_time, replace_ttl)
 
     def do_extend(self, additional_time: int, replace_ttl: bool) -> bool:
@@ -284,7 +290,10 @@ def do_extend(self, additional_time: int, replace_ttl: bool) -> bool:
                 client=self.redis,
             )
         ):
-            raise LockNotOwnedError("Cannot extend a lock that's no longer owned")
+            raise LockNotOwnedError(
+                "Cannot extend a lock that's no longer owned",
+                lock_name=self.name,
+            )
         return True
 
     def reacquire(self) -> bool:
@@ -292,9 +301,12 @@ def reacquire(self) -> bool:
         Resets a TTL of an already acquired lock back to a timeout value.
         """
         if self.local.token is None:
-            raise LockError("Cannot reacquire an unlocked lock")
+            raise LockError("Cannot reacquire an unlocked lock", lock_name=self.name)
         if self.timeout is None:
-            raise LockError("Cannot reacquire a lock with no timeout")
+            raise LockError(
+                "Cannot reacquire a lock with no timeout",
+                lock_name=self.name,
+            )
         return self.do_reacquire()
 
     def do_reacquire(self) -> bool:
@@ -304,5 +316,8 @@ def do_reacquire(self) -> bool:
                 keys=[self.name], args=[self.local.token, timeout], client=self.redis
             )
         ):
-            raise LockNotOwnedError("Cannot reacquire a lock that's no longer owned")
+            raise LockNotOwnedError(
+                "Cannot reacquire a lock that's no longer owned",
+                lock_name=self.name,
+            )
         return True
diff --git a/tests/test_lock.py b/tests/test_lock.py
index 72af87fa81..5c804b426e 100644
--- a/tests/test_lock.py
+++ b/tests/test_lock.py
@@ -242,6 +242,13 @@ def test_context_manager_reacquiring_lock_no_longer_owned_raises_error(self, r):
             with self.get_lock(r, "foo", timeout=10, blocking=False):
                 r.set("foo", "a")
 
+    def test_lock_error_gives_correct_lock_name(self, r):
+        r.set("foo", "bar")
+        with pytest.raises(LockError) as excinfo:
+            with self.get_lock(r, "foo", blocking_timeout=0.1):
+                pass
+            assert excinfo.value.lock_name == "foo"
+
 
 class TestLockClassSelection:
     def test_lock_class_argument(self, r):

From fabc23e0aaeef82ffd2da7037eeb707e567ce340 Mon Sep 17 00:00:00 2001
From: trkwyk <50520795+trkwyk@users.noreply.github.com>
Date: Wed, 10 Jan 2024 02:49:30 +0800
Subject: [PATCH 0835/1164] Fix objlen type hint (#2966)

* Fix objlen type hint

* Update redis/commands/json/commands.py

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>

* linters

---------

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/commands/json/commands.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index 4c2e58369c..b37dc37687 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -121,7 +121,9 @@ def objkeys(
         """  # noqa
         return self.execute_command("JSON.OBJKEYS", name, str(path), keys=[name])
 
-    def objlen(self, name: str, path: Optional[str] = Path.root_path()) -> int:
+    def objlen(
+        self, name: str, path: Optional[str] = Path.root_path()
+    ) -> List[Optional[int]]:
         """Return the length of the dictionary JSON value under ``path`` at key
         ``name``.
 

From 4a66c1e2b06bce1fc2a05febe00ad46e5d78e2e2 Mon Sep 17 00:00:00 2001
From: SwordHeart <37992593+zxjlm@users.noreply.github.com>
Date: Wed, 10 Jan 2024 06:45:21 +0800
Subject: [PATCH 0836/1164] Fix type hint of arbitrary argument lists (#2908)

---
 redis/commands/core.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 2840dc0386..fa48a04be4 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -5260,12 +5260,12 @@ class ScriptCommands(CommandsProtocol):
     """
 
     def _eval(
-        self, command: str, script: str, numkeys: int, *keys_and_args: list
+        self, command: str, script: str, numkeys: int, *keys_and_args: str
     ) -> Union[Awaitable[str], str]:
         return self.execute_command(command, script, numkeys, *keys_and_args)
 
     def eval(
-        self, script: str, numkeys: int, *keys_and_args: list
+        self, script: str, numkeys: int, *keys_and_args: str
     ) -> Union[Awaitable[str], str]:
         """
         Execute the Lua ``script``, specifying the ``numkeys`` the script
@@ -5280,7 +5280,7 @@ def eval(
         return self._eval("EVAL", script, numkeys, *keys_and_args)
 
     def eval_ro(
-        self, script: str, numkeys: int, *keys_and_args: list
+        self, script: str, numkeys: int, *keys_and_args: str
     ) -> Union[Awaitable[str], str]:
         """
         The read-only variant of the EVAL command
@@ -5299,7 +5299,7 @@ def _evalsha(
         return self.execute_command(command, sha, numkeys, *keys_and_args)
 
     def evalsha(
-        self, sha: str, numkeys: int, *keys_and_args: list
+        self, sha: str, numkeys: int, *keys_and_args: str
     ) -> Union[Awaitable[str], str]:
         """
         Use the ``sha`` to execute a Lua script already registered via EVAL
@@ -5315,7 +5315,7 @@ def evalsha(
         return self._evalsha("EVALSHA", sha, numkeys, *keys_and_args)
 
     def evalsha_ro(
-        self, sha: str, numkeys: int, *keys_and_args: list
+        self, sha: str, numkeys: int, *keys_and_args: str
     ) -> Union[Awaitable[str], str]:
         """
         The read-only variant of the EVALSHA command

From 273f032094fa691462d3c51f6767aae541a9f8c2 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 11 Jan 2024 10:41:16 +0200
Subject: [PATCH 0837/1164] Fix: hset unexpectedly mutates the list passed to
 items (#3103)

---
 redis/commands/core.py | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index fa48a04be4..6d81d76035 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -5017,14 +5017,16 @@ def hset(
         """
         if key is None and not mapping and not items:
             raise DataError("'hset' with no key value pairs")
-        items = items or []
+        pieces = []
+        if items:
+            pieces.extend(items)
         if key is not None:
-            items.extend((key, value))
+            pieces.extend((key, value))
         if mapping:
             for pair in mapping.items():
-                items.extend(pair)
+                pieces.extend(pair)
 
-        return self.execute_command("HSET", name, *items)
+        return self.execute_command("HSET", name, *pieces)
 
     def hsetnx(self, name: str, key: str, value: str) -> Union[Awaitable[bool], bool]:
         """

From df2956684c4f1b0c553cced55e022485598b0ebb Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 11 Jan 2024 10:41:26 +0200
Subject: [PATCH 0838/1164] Return a copy of the respnse from cache (#3106)

---
 redis/_cache.py                  |  3 ++-
 tests/test_asyncio/test_cache.py | 11 +++++++++++
 tests/test_cache.py              | 12 ++++++++++++
 3 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/redis/_cache.py b/redis/_cache.py
index 4255afb7a4..f8cc7d21bf 100644
--- a/redis/_cache.py
+++ b/redis/_cache.py
@@ -1,3 +1,4 @@
+import copy
 import random
 import time
 from collections import OrderedDict, defaultdict
@@ -226,7 +227,7 @@ def get(self, command: str) -> ResponseT:
                 self.delete(command)
                 return
             self._update_access(command)
-            return self.cache[command]["response"]
+            return copy.deepcopy(self.cache[command]["response"])
 
     def delete(self, command: str):
         """
diff --git a/tests/test_asyncio/test_cache.py b/tests/test_asyncio/test_cache.py
index 098ede8d75..bf20337dfb 100644
--- a/tests/test_asyncio/test_cache.py
+++ b/tests/test_asyncio/test_cache.py
@@ -131,6 +131,17 @@ async def test_cache_blacklist(self, r):
         assert cache.get(("LLEN", "mylist")) is None
         assert cache.get(("LINDEX", "mylist", 1)) == b"bar"
 
+    @pytest.mark.parametrize("r", [{"cache": _LocalCache()}], indirect=True)
+    async def test_cache_return_copy(self, r):
+        r, cache = r
+        await r.lpush("mylist", "foo", "bar", "baz")
+        assert await r.lrange("mylist", 0, -1) == [b"baz", b"bar", b"foo"]
+        res = cache.get(("LRANGE", "mylist", 0, -1))
+        assert res == [b"baz", b"bar", b"foo"]
+        res.append(b"new")
+        check = cache.get(("LRANGE", "mylist", 0, -1))
+        assert check == [b"baz", b"bar", b"foo"]
+
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 @pytest.mark.onlycluster
diff --git a/tests/test_cache.py b/tests/test_cache.py
index 570385a4b5..4eb5160ecc 100644
--- a/tests/test_cache.py
+++ b/tests/test_cache.py
@@ -15,6 +15,7 @@ def r(request):
         redis.Redis, request, protocol=3, client_cache=cache, **kwargs
     ) as client:
         yield client, cache
+        # client.flushdb()
 
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
@@ -134,6 +135,17 @@ def test_cache_blacklist(self, r):
         assert cache.get(("LLEN", "mylist")) is None
         assert cache.get(("LINDEX", "mylist", 1)) == b"bar"
 
+    @pytest.mark.parametrize("r", [{"cache": _LocalCache()}], indirect=True)
+    def test_cache_return_copy(self, r):
+        r, cache = r
+        r.lpush("mylist", "foo", "bar", "baz")
+        assert r.lrange("mylist", 0, -1) == [b"baz", b"bar", b"foo"]
+        res = cache.get(("LRANGE", "mylist", 0, -1))
+        assert res == [b"baz", b"bar", b"foo"]
+        res.append(b"new")
+        check = cache.get(("LRANGE", "mylist", 0, -1))
+        assert check == [b"baz", b"bar", b"foo"]
+
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 @pytest.mark.onlycluster

From 254c8c095edc63d6aa19a11af245e7dd09873b64 Mon Sep 17 00:00:00 2001
From: Jason <31104990+ING-XIAOJIAN@users.noreply.github.com>
Date: Thu, 11 Jan 2024 18:33:07 +0800
Subject: [PATCH 0839/1164] Fix possible pipeline connections leak (#3104)

* Update cluster.py

When Executing "n.write()" may generate some unknown errors(e.g. DataError), which could result in the connection not being released.

* Update cluster.py

* Update cluster.py

release connection move to "try...finally"

* Update cluster.py

 fix the linters

* fix problems of code review
---
 redis/cluster.py | 54 +++++++++++++++++++++++++-----------------------
 1 file changed, 28 insertions(+), 26 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index 7bdf4c1951..e558be1689 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -2166,32 +2166,34 @@ def _send_cluster_commands(
         # we dont' multiplex on the sockets as they come available,
         # but that shouldn't make too much difference.
         node_commands = nodes.values()
-        for n in node_commands:
-            n.write()
-
-        for n in node_commands:
-            n.read()
-
-        # release all of the redis connections we allocated earlier
-        # back into the connection pool.
-        # we used to do this step as part of a try/finally block,
-        # but it is really dangerous to
-        # release connections back into the pool if for some
-        # reason the socket has data still left in it
-        # from a previous operation. The write and
-        # read operations already have try/catch around them for
-        # all known types of errors including connection
-        # and socket level errors.
-        # So if we hit an exception, something really bad
-        # happened and putting any oF
-        # these connections back into the pool is a very bad idea.
-        # the socket might have unread buffer still sitting in it,
-        # and then the next time we read from it we pass the
-        # buffered result back from a previous command and
-        # every single request after to that connection will always get
-        # a mismatched result.
-        for n in nodes.values():
-            n.connection_pool.release(n.connection)
+        try:
+            node_commands = nodes.values()
+            for n in node_commands:
+                n.write()
+
+            for n in node_commands:
+                n.read()
+        finally:
+            # release all of the redis connections we allocated earlier
+            # back into the connection pool.
+            # we used to do this step as part of a try/finally block,
+            # but it is really dangerous to
+            # release connections back into the pool if for some
+            # reason the socket has data still left in it
+            # from a previous operation. The write and
+            # read operations already have try/catch around them for
+            # all known types of errors including connection
+            # and socket level errors.
+            # So if we hit an exception, something really bad
+            # happened and putting any oF
+            # these connections back into the pool is a very bad idea.
+            # the socket might have unread buffer still sitting in it,
+            # and then the next time we read from it we pass the
+            # buffered result back from a previous command and
+            # every single request after to that connection will always get
+            # a mismatched result.
+            for n in nodes.values():
+                n.connection_pool.release(n.connection)
 
         # if the response isn't an exception it is a
         # valid response from the node

From 562152ba68ecb8a167bd71a0af85f095f67c400c Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 15 Jan 2024 16:05:01 +0200
Subject: [PATCH 0840/1164] CSC Review Fixes - expose delete functions, rename
 attribute names, add AbstractCache class (#3110)

* CSC review fixes

* cahnge cache_max_size default value

* use ABC and add docstring
---
 redis/_cache.py             | 46 +++++++++++++++++++++++-----
 redis/asyncio/client.py     | 39 ++++++++++++++++++++----
 redis/asyncio/cluster.py    | 12 ++++----
 redis/asyncio/connection.py | 54 +++++++++++++++++++++++----------
 redis/client.py             | 41 ++++++++++++++++++++-----
 redis/cluster.py            |  4 +--
 redis/connection.py         | 60 +++++++++++++++++++++++++++----------
 7 files changed, 196 insertions(+), 60 deletions(-)

diff --git a/redis/_cache.py b/redis/_cache.py
index f8cc7d21bf..7acfdde3e7 100644
--- a/redis/_cache.py
+++ b/redis/_cache.py
@@ -1,6 +1,7 @@
 import copy
 import random
 import time
+from abc import ABC, abstractmethod
 from collections import OrderedDict, defaultdict
 from enum import Enum
 from typing import List
@@ -160,7 +161,38 @@ class EvictionPolicy(Enum):
     RANDOM = "random"
 
 
-class _LocalCache:
+class AbstractCache(ABC):
+    """
+    An abstract base class for client caching implementations.
+    If you want to implement your own cache you must support these methods.
+    """
+
+    @abstractmethod
+    def set(self, command: str, response: ResponseT, keys_in_command: List[KeyT]):
+        pass
+
+    @abstractmethod
+    def get(self, command: str) -> ResponseT:
+        pass
+
+    @abstractmethod
+    def delete_command(self, command: str):
+        pass
+
+    @abstractmethod
+    def delete_many(self, commands):
+        pass
+
+    @abstractmethod
+    def flush(self):
+        pass
+
+    @abstractmethod
+    def invalidate_key(self, key: KeyT):
+        pass
+
+
+class _LocalCache(AbstractCache):
     """
     A caching mechanism for storing redis commands and their responses.
 
@@ -180,7 +212,7 @@ class _LocalCache:
 
     def __init__(
         self,
-        max_size: int = 100,
+        max_size: int = 10000,
         ttl: int = 0,
         eviction_policy: EvictionPolicy = DEFAULT_EVICTION_POLICY,
         **kwargs,
@@ -224,12 +256,12 @@ def get(self, command: str) -> ResponseT:
         """
         if command in self.cache:
             if self._is_expired(command):
-                self.delete(command)
+                self.delete_command(command)
                 return
             self._update_access(command)
             return copy.deepcopy(self.cache[command]["response"])
 
-    def delete(self, command: str):
+    def delete_command(self, command: str):
         """
         Delete a redis command and its metadata from the cache.
 
@@ -285,7 +317,7 @@ def _update_access(self, command: str):
     def _evict(self):
         """Evict a redis command from the cache based on the eviction policy."""
         if self._is_expired(self.commands_ttl_list[0]):
-            self.delete(self.commands_ttl_list[0])
+            self.delete_command(self.commands_ttl_list[0])
         elif self.eviction_policy == EvictionPolicy.LRU.value:
             self.cache.popitem(last=False)
         elif self.eviction_policy == EvictionPolicy.LFU.value:
@@ -319,7 +351,7 @@ def _del_key_commands_map(self, keys: List[KeyT], command: str):
         for key in keys:
             self.key_commands_map[key].remove(command)
 
-    def invalidate(self, key: KeyT):
+    def invalidate_key(self, key: KeyT):
         """
         Invalidate (delete) all redis commands associated with a specific key.
 
@@ -330,4 +362,4 @@ def invalidate(self, key: KeyT):
             return
         commands = list(self.key_commands_map[key])
         for command in commands:
-            self.delete(command)
+            self.delete_command(command)
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 143d997757..88de893f5b 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -29,7 +29,7 @@
     DEFAULT_BLACKLIST,
     DEFAULT_EVICTION_POLICY,
     DEFAULT_WHITELIST,
-    _LocalCache,
+    AbstractCache,
 )
 from redis._parsers.helpers import (
     _RedisCallbacks,
@@ -238,11 +238,11 @@ def __init__(
         redis_connect_func=None,
         credential_provider: Optional[CredentialProvider] = None,
         protocol: Optional[int] = 2,
-        cache_enable: bool = False,
-        client_cache: Optional[_LocalCache] = None,
+        cache_enabled: bool = False,
+        client_cache: Optional[AbstractCache] = None,
         cache_max_size: int = 100,
         cache_ttl: int = 0,
-        cache_eviction_policy: str = DEFAULT_EVICTION_POLICY,
+        cache_policy: str = DEFAULT_EVICTION_POLICY,
         cache_blacklist: List[str] = DEFAULT_BLACKLIST,
         cache_whitelist: List[str] = DEFAULT_WHITELIST,
     ):
@@ -294,11 +294,11 @@ def __init__(
                 "lib_version": lib_version,
                 "redis_connect_func": redis_connect_func,
                 "protocol": protocol,
-                "cache_enable": cache_enable,
+                "cache_enabled": cache_enabled,
                 "client_cache": client_cache,
                 "cache_max_size": cache_max_size,
                 "cache_ttl": cache_ttl,
-                "cache_eviction_policy": cache_eviction_policy,
+                "cache_policy": cache_policy,
                 "cache_blacklist": cache_blacklist,
                 "cache_whitelist": cache_whitelist,
             }
@@ -671,6 +671,33 @@ async def parse_response(
             return await retval if inspect.isawaitable(retval) else retval
         return response
 
+    def flush_cache(self):
+        try:
+            if self.connection:
+                self.connection.client_cache.flush()
+            else:
+                self.connection_pool.flush_cache()
+        except AttributeError:
+            pass
+
+    def delete_command_from_cache(self, command):
+        try:
+            if self.connection:
+                self.connection.client_cache.delete_command(command)
+            else:
+                self.connection_pool.delete_command_from_cache(command)
+        except AttributeError:
+            pass
+
+    def invalidate_key_from_cache(self, key):
+        try:
+            if self.connection:
+                self.connection.client_cache.invalidate_key(key)
+            else:
+                self.connection_pool.invalidate_key_from_cache(key)
+        except AttributeError:
+            pass
+
 
 StrictRedis = Redis
 
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 486053e1cc..337c7bbdcc 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -22,7 +22,7 @@
     DEFAULT_BLACKLIST,
     DEFAULT_EVICTION_POLICY,
     DEFAULT_WHITELIST,
-    _LocalCache,
+    AbstractCache,
 )
 from redis._parsers import AsyncCommandsParser, Encoder
 from redis._parsers.helpers import (
@@ -273,11 +273,11 @@ def __init__(
         ssl_keyfile: Optional[str] = None,
         protocol: Optional[int] = 2,
         address_remap: Optional[Callable[[str, int], Tuple[str, int]]] = None,
-        cache_enable: bool = False,
-        client_cache: Optional[_LocalCache] = None,
+        cache_enabled: bool = False,
+        client_cache: Optional[AbstractCache] = None,
         cache_max_size: int = 100,
         cache_ttl: int = 0,
-        cache_eviction_policy: str = DEFAULT_EVICTION_POLICY,
+        cache_policy: str = DEFAULT_EVICTION_POLICY,
         cache_blacklist: List[str] = DEFAULT_BLACKLIST,
         cache_whitelist: List[str] = DEFAULT_WHITELIST,
     ) -> None:
@@ -324,11 +324,11 @@ def __init__(
             "retry": retry,
             "protocol": protocol,
             # Client cache related kwargs
-            "cache_enable": cache_enable,
+            "cache_enabled": cache_enabled,
             "client_cache": client_cache,
             "cache_max_size": cache_max_size,
             "cache_ttl": cache_ttl,
-            "cache_eviction_policy": cache_eviction_policy,
+            "cache_policy": cache_policy,
             "cache_blacklist": cache_blacklist,
             "cache_whitelist": cache_whitelist,
         }
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 05a27879a6..77aa21f034 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -54,6 +54,7 @@
     DEFAULT_BLACKLIST,
     DEFAULT_EVICTION_POLICY,
     DEFAULT_WHITELIST,
+    AbstractCache,
     _LocalCache,
 )
 from .._parsers import (
@@ -157,11 +158,11 @@ def __init__(
         encoder_class: Type[Encoder] = Encoder,
         credential_provider: Optional[CredentialProvider] = None,
         protocol: Optional[int] = 2,
-        cache_enable: bool = False,
-        client_cache: Optional[_LocalCache] = None,
-        cache_max_size: int = 100,
+        cache_enabled: bool = False,
+        client_cache: Optional[AbstractCache] = None,
+        cache_max_size: int = 10000,
         cache_ttl: int = 0,
-        cache_eviction_policy: str = DEFAULT_EVICTION_POLICY,
+        cache_policy: str = DEFAULT_EVICTION_POLICY,
         cache_blacklist: List[str] = DEFAULT_BLACKLIST,
         cache_whitelist: List[str] = DEFAULT_WHITELIST,
     ):
@@ -221,8 +222,8 @@ def __init__(
             if p < 2 or p > 3:
                 raise ConnectionError("protocol must be either 2 or 3")
             self.protocol = protocol
-        if cache_enable:
-            _cache = _LocalCache(cache_max_size, cache_ttl, cache_eviction_policy)
+        if cache_enabled:
+            _cache = _LocalCache(cache_max_size, cache_ttl, cache_policy)
         else:
             _cache = None
         self.client_cache = client_cache if client_cache is not None else _cache
@@ -699,7 +700,7 @@ def _cache_invalidation_process(
             self.client_cache.flush()
         else:
             for key in data[1]:
-                self.client_cache.invalidate(str_if_bytes(key))
+                self.client_cache.invalidate_key(str_if_bytes(key))
 
     async def _get_from_local_cache(self, command: str):
         """
@@ -729,15 +730,6 @@ def _add_to_local_cache(
         ):
             self.client_cache.set(command, response, keys)
 
-    def delete_from_local_cache(self, command: str):
-        """
-        Delete the command from the local cache
-        """
-        try:
-            self.client_cache.delete(command)
-        except AttributeError:
-            pass
-
 
 class Connection(AbstractConnection):
     "Manages TCP communication to and from a Redis server"
@@ -1241,6 +1233,36 @@ def set_retry(self, retry: "Retry") -> None:
         for conn in self._in_use_connections:
             conn.retry = retry
 
+    def flush_cache(self):
+        connections = chain(self._available_connections, self._in_use_connections)
+
+        for connection in connections:
+            try:
+                connection.client_cache.flush()
+            except AttributeError:
+                # cache is not enabled
+                pass
+
+    def delete_command_from_cache(self, command: str):
+        connections = chain(self._available_connections, self._in_use_connections)
+
+        for connection in connections:
+            try:
+                connection.client_cache.delete_command(command)
+            except AttributeError:
+                # cache is not enabled
+                pass
+
+    def invalidate_key_from_cache(self, key: str):
+        connections = chain(self._available_connections, self._in_use_connections)
+
+        for connection in connections:
+            try:
+                connection.client_cache.invalidate_key(key)
+            except AttributeError:
+                # cache is not enabled
+                pass
+
 
 class BlockingConnectionPool(ConnectionPool):
     """
diff --git a/redis/client.py b/redis/client.py
index d685145339..2d4c512699 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -10,7 +10,7 @@
     DEFAULT_BLACKLIST,
     DEFAULT_EVICTION_POLICY,
     DEFAULT_WHITELIST,
-    _LocalCache,
+    AbstractCache,
 )
 from redis._parsers.encoders import Encoder
 from redis._parsers.helpers import (
@@ -209,11 +209,11 @@ def __init__(
         redis_connect_func=None,
         credential_provider: Optional[CredentialProvider] = None,
         protocol: Optional[int] = 2,
-        cache_enable: bool = False,
-        client_cache: Optional[_LocalCache] = None,
-        cache_max_size: int = 100,
+        cache_enabled: bool = False,
+        client_cache: Optional[AbstractCache] = None,
+        cache_max_size: int = 10000,
         cache_ttl: int = 0,
-        cache_eviction_policy: str = DEFAULT_EVICTION_POLICY,
+        cache_policy: str = DEFAULT_EVICTION_POLICY,
         cache_blacklist: List[str] = DEFAULT_BLACKLIST,
         cache_whitelist: List[str] = DEFAULT_WHITELIST,
     ) -> None:
@@ -267,11 +267,11 @@ def __init__(
                 "redis_connect_func": redis_connect_func,
                 "credential_provider": credential_provider,
                 "protocol": protocol,
-                "cache_enable": cache_enable,
+                "cache_enabled": cache_enabled,
                 "client_cache": client_cache,
                 "cache_max_size": cache_max_size,
                 "cache_ttl": cache_ttl,
-                "cache_eviction_policy": cache_eviction_policy,
+                "cache_policy": cache_policy,
                 "cache_blacklist": cache_blacklist,
                 "cache_whitelist": cache_whitelist,
             }
@@ -592,6 +592,33 @@ def parse_response(self, connection, command_name, **options):
             return self.response_callbacks[command_name](response, **options)
         return response
 
+    def flush_cache(self):
+        try:
+            if self.connection:
+                self.connection.client_cache.flush()
+            else:
+                self.connection_pool.flush_cache()
+        except AttributeError:
+            pass
+
+    def delete_command_from_cache(self, command):
+        try:
+            if self.connection:
+                self.connection.client_cache.delete_command(command)
+            else:
+                self.connection_pool.delete_command_from_cache(command)
+        except AttributeError:
+            pass
+
+    def invalidate_key_from_cache(self, key):
+        try:
+            if self.connection:
+                self.connection.client_cache.invalidate_key(key)
+            else:
+                self.connection_pool.invalidate_key_from_cache(key)
+        except AttributeError:
+            pass
+
 
 StrictRedis = Redis
 
diff --git a/redis/cluster.py b/redis/cluster.py
index e558be1689..c36665eb5c 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -167,11 +167,11 @@ def parse_cluster_myshardid(resp, **options):
     "ssl_password",
     "unix_socket_path",
     "username",
-    "cache_enable",
+    "cache_enabled",
     "client_cache",
     "cache_max_size",
     "cache_ttl",
-    "cache_eviction_policy",
+    "cache_policy",
     "cache_blacklist",
     "cache_whitelist",
 )
diff --git a/redis/connection.py b/redis/connection.py
index a09fb3949c..1f46267146 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -17,6 +17,7 @@
     DEFAULT_BLACKLIST,
     DEFAULT_EVICTION_POLICY,
     DEFAULT_WHITELIST,
+    AbstractCache,
     _LocalCache,
 )
 from ._parsers import Encoder, _HiredisParser, _RESP2Parser, _RESP3Parser
@@ -157,11 +158,11 @@ def __init__(
         credential_provider: Optional[CredentialProvider] = None,
         protocol: Optional[int] = 2,
         command_packer: Optional[Callable[[], None]] = None,
-        cache_enable: bool = False,
-        client_cache: Optional[_LocalCache] = None,
-        cache_max_size: int = 100,
+        cache_enabled: bool = False,
+        client_cache: Optional[AbstractCache] = None,
+        cache_max_size: int = 10000,
         cache_ttl: int = 0,
-        cache_eviction_policy: str = DEFAULT_EVICTION_POLICY,
+        cache_policy: str = DEFAULT_EVICTION_POLICY,
         cache_blacklist: List[str] = DEFAULT_BLACKLIST,
         cache_whitelist: List[str] = DEFAULT_WHITELIST,
     ):
@@ -229,8 +230,8 @@ def __init__(
                 # p = DEFAULT_RESP_VERSION
             self.protocol = p
         self._command_packer = self._construct_command_packer(command_packer)
-        if cache_enable:
-            _cache = _LocalCache(cache_max_size, cache_ttl, cache_eviction_policy)
+        if cache_enabled:
+            _cache = _LocalCache(cache_max_size, cache_ttl, cache_policy)
         else:
             _cache = None
         self.client_cache = client_cache if client_cache is not None else _cache
@@ -626,7 +627,7 @@ def _cache_invalidation_process(
             self.client_cache.flush()
         else:
             for key in data[1]:
-                self.client_cache.invalidate(str_if_bytes(key))
+                self.client_cache.invalidate_key(str_if_bytes(key))
 
     def _get_from_local_cache(self, command: str):
         """
@@ -656,15 +657,6 @@ def _add_to_local_cache(
         ):
             self.client_cache.set(command, response, keys)
 
-    def delete_from_local_cache(self, command: str):
-        """
-        Delete the command from the local cache
-        """
-        try:
-            self.client_cache.delete(command)
-        except AttributeError:
-            pass
-
 
 class Connection(AbstractConnection):
     "Manages TCP communication to and from a Redis server"
@@ -1281,6 +1273,42 @@ def set_retry(self, retry: "Retry") -> None:
         for conn in self._in_use_connections:
             conn.retry = retry
 
+    def flush_cache(self):
+        self._checkpid()
+        with self._lock:
+            connections = chain(self._available_connections, self._in_use_connections)
+
+            for connection in connections:
+                try:
+                    connection.client_cache.flush()
+                except AttributeError:
+                    # cache is not enabled
+                    pass
+
+    def delete_command_from_cache(self, command: str):
+        self._checkpid()
+        with self._lock:
+            connections = chain(self._available_connections, self._in_use_connections)
+
+            for connection in connections:
+                try:
+                    connection.client_cache.delete_command(command)
+                except AttributeError:
+                    # cache is not enabled
+                    pass
+
+    def invalidate_key_from_cache(self, key: str):
+        self._checkpid()
+        with self._lock:
+            connections = chain(self._available_connections, self._in_use_connections)
+
+            for connection in connections:
+                try:
+                    connection.client_cache.invalidate_key(key)
+                except AttributeError:
+                    # cache is not enabled
+                    pass
+
 
 class BlockingConnectionPool(ConnectionPool):
     """

From 908f2a5709dda6cb16b2e9019f66e21d9104155b Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 15 Jan 2024 16:14:24 +0200
Subject: [PATCH 0841/1164] Update install_requires (#3109)

---
 setup.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 795aecd142..143ba69fa4 100644
--- a/setup.py
+++ b/setup.py
@@ -36,7 +36,8 @@
     author_email="oss@redis.com",
     python_requires=">=3.8",
     install_requires=[
-        'async-timeout>=4.0.2; python_full_version<="3.11.2"',
+        'typing-extensions; python_version<"3.8"',
+        'async-timeout>=4.0.3',
     ],
     classifiers=[
         "Development Status :: 5 - Production/Stable",

From 0a824962e9c0f8ec1b6b9b0fc823db8ec296e580 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 15 Jan 2024 17:14:18 +0200
Subject: [PATCH 0842/1164] Version 5.1.0b3 (#3112)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 143ba69fa4..aca2244218 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="5.1.0b2",
+    version="5.1.0b3",
     packages=find_packages(
         include=[
             "redis",

From 70e2a1321019a4df873230ac64f11f1215198624 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Sun, 21 Jan 2024 12:10:26 +0200
Subject: [PATCH 0843/1164] Add modules support to async RedisCluster (#3115)

---
 redis/commands/cluster.py             |  3 +-
 tests/test_asyncio/test_bloom.py      | 26 +---------------
 tests/test_asyncio/test_graph.py      | 20 -------------
 tests/test_asyncio/test_json.py       | 43 +--------------------------
 tests/test_asyncio/test_timeseries.py | 25 +---------------
 5 files changed, 5 insertions(+), 112 deletions(-)

diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index 8dd463ed18..f31b88bc4e 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -44,7 +44,7 @@
     ScriptCommands,
 )
 from .helpers import list_or_args
-from .redismodules import RedisModuleCommands
+from .redismodules import AsyncRedisModuleCommands, RedisModuleCommands
 
 if TYPE_CHECKING:
     from redis.asyncio.cluster import TargetNodesT
@@ -907,6 +907,7 @@ class AsyncRedisClusterCommands(
     AsyncFunctionCommands,
     AsyncGearsCommands,
     AsyncModuleCommands,
+    AsyncRedisModuleCommands,
 ):
     """
     A class for all Redis Cluster commands
diff --git a/tests/test_asyncio/test_bloom.py b/tests/test_asyncio/test_bloom.py
index d0a25e5625..278844416f 100644
--- a/tests/test_asyncio/test_bloom.py
+++ b/tests/test_asyncio/test_bloom.py
@@ -15,7 +15,6 @@ def intlist(obj):
     return [int(v) for v in obj]
 
 
-@pytest.mark.redismod
 async def test_create(decoded_r: redis.Redis):
     """Test CREATE/RESERVE calls"""
     assert await decoded_r.bf().create("bloom", 0.01, 1000)
@@ -30,13 +29,11 @@ async def test_create(decoded_r: redis.Redis):
     assert await decoded_r.topk().reserve("topk", 5, 100, 5, 0.9)
 
 
-@pytest.mark.redismod
 @pytest.mark.experimental
 async def test_tdigest_create(decoded_r: redis.Redis):
     assert await decoded_r.tdigest().create("tDigest", 100)
 
 
-@pytest.mark.redismod
 async def test_bf_add(decoded_r: redis.Redis):
     assert await decoded_r.bf().create("bloom", 0.01, 1000)
     assert 1 == await decoded_r.bf().add("bloom", "foo")
@@ -49,7 +46,6 @@ async def test_bf_add(decoded_r: redis.Redis):
     assert [1, 0] == intlist(await decoded_r.bf().mexists("bloom", "foo", "noexist"))
 
 
-@pytest.mark.redismod
 async def test_bf_insert(decoded_r: redis.Redis):
     assert await decoded_r.bf().create("bloom", 0.01, 1000)
     assert [1] == intlist(await decoded_r.bf().insert("bloom", ["foo"]))
@@ -80,7 +76,6 @@ async def test_bf_insert(decoded_r: redis.Redis):
     )
 
 
-@pytest.mark.redismod
 async def test_bf_scandump_and_loadchunk(decoded_r: redis.Redis):
     # Store a filter
     await decoded_r.bf().create("myBloom", "0.0001", "1000")
@@ -132,7 +127,6 @@ async def do_verify():
     await decoded_r.bf().create("myBloom", "0.0001", "10000000")
 
 
-@pytest.mark.redismod
 async def test_bf_info(decoded_r: redis.Redis):
     expansion = 4
     # Store a filter
@@ -164,7 +158,6 @@ async def test_bf_info(decoded_r: redis.Redis):
         assert True
 
 
-@pytest.mark.redismod
 async def test_bf_card(decoded_r: redis.Redis):
     # return 0 if the key does not exist
     assert await decoded_r.bf().card("not_exist") == 0
@@ -179,7 +172,6 @@ async def test_bf_card(decoded_r: redis.Redis):
         await decoded_r.bf().card("setKey")
 
 
-@pytest.mark.redismod
 async def test_cf_add_and_insert(decoded_r: redis.Redis):
     assert await decoded_r.cf().create("cuckoo", 1000)
     assert await decoded_r.cf().add("cuckoo", "filter")
@@ -205,7 +197,6 @@ async def test_cf_add_and_insert(decoded_r: redis.Redis):
     )
 
 
-@pytest.mark.redismod
 async def test_cf_exists_and_del(decoded_r: redis.Redis):
     assert await decoded_r.cf().create("cuckoo", 1000)
     assert await decoded_r.cf().add("cuckoo", "filter")
@@ -217,7 +208,6 @@ async def test_cf_exists_and_del(decoded_r: redis.Redis):
     assert 0 == await decoded_r.cf().count("cuckoo", "filter")
 
 
-@pytest.mark.redismod
 async def test_cms(decoded_r: redis.Redis):
     assert await decoded_r.cms().initbydim("dim", 1000, 5)
     assert await decoded_r.cms().initbyprob("prob", 0.01, 0.01)
@@ -233,7 +223,6 @@ async def test_cms(decoded_r: redis.Redis):
     assert 25 == info["count"]
 
 
-@pytest.mark.redismod
 @pytest.mark.onlynoncluster
 async def test_cms_merge(decoded_r: redis.Redis):
     assert await decoded_r.cms().initbydim("A", 1000, 5)
@@ -251,7 +240,6 @@ async def test_cms_merge(decoded_r: redis.Redis):
     assert [16, 15, 21] == await decoded_r.cms().query("C", "foo", "bar", "baz")
 
 
-@pytest.mark.redismod
 async def test_topk(decoded_r: redis.Redis):
     # test list with empty buckets
     assert await decoded_r.topk().reserve("topk", 3, 50, 4, 0.9)
@@ -332,7 +320,6 @@ async def test_topk(decoded_r: redis.Redis):
     assert 0.9 == round(float(info["decay"]), 1)
 
 
-@pytest.mark.redismod
 async def test_topk_incrby(decoded_r: redis.Redis):
     await decoded_r.flushdb()
     assert await decoded_r.topk().reserve("topk", 3, 10, 3, 1)
@@ -347,7 +334,6 @@ async def test_topk_incrby(decoded_r: redis.Redis):
         )
 
 
-@pytest.mark.redismod
 @pytest.mark.experimental
 async def test_tdigest_reset(decoded_r: redis.Redis):
     assert await decoded_r.tdigest().create("tDigest", 10)
@@ -364,7 +350,6 @@ async def test_tdigest_reset(decoded_r: redis.Redis):
     )
 
 
-@pytest.mark.redismod
 @pytest.mark.onlynoncluster
 async def test_tdigest_merge(decoded_r: redis.Redis):
     assert await decoded_r.tdigest().create("to-tDigest", 10)
@@ -392,7 +377,6 @@ async def test_tdigest_merge(decoded_r: redis.Redis):
     assert 4.0 == await decoded_r.tdigest().max("to-tDigest")
 
 
-@pytest.mark.redismod
 @pytest.mark.experimental
 async def test_tdigest_min_and_max(decoded_r: redis.Redis):
     assert await decoded_r.tdigest().create("tDigest", 100)
@@ -403,7 +387,6 @@ async def test_tdigest_min_and_max(decoded_r: redis.Redis):
     assert 1 == await decoded_r.tdigest().min("tDigest")
 
 
-@pytest.mark.redismod
 @pytest.mark.experimental
 @skip_ifmodversion_lt("2.4.0", "bf")
 async def test_tdigest_quantile(decoded_r: redis.Redis):
@@ -432,7 +415,6 @@ async def test_tdigest_quantile(decoded_r: redis.Redis):
     assert [3.0, 5.0] == res
 
 
-@pytest.mark.redismod
 @pytest.mark.experimental
 async def test_tdigest_cdf(decoded_r: redis.Redis):
     assert await decoded_r.tdigest().create("tDigest", 100)
@@ -444,7 +426,6 @@ async def test_tdigest_cdf(decoded_r: redis.Redis):
     assert [0.1, 0.9] == [round(x, 1) for x in res]
 
 
-@pytest.mark.redismod
 @pytest.mark.experimental
 @skip_ifmodversion_lt("2.4.0", "bf")
 async def test_tdigest_trimmed_mean(decoded_r: redis.Redis):
@@ -455,7 +436,6 @@ async def test_tdigest_trimmed_mean(decoded_r: redis.Redis):
     assert 4.5 == await decoded_r.tdigest().trimmed_mean("tDigest", 0.4, 0.5)
 
 
-@pytest.mark.redismod
 @pytest.mark.experimental
 async def test_tdigest_rank(decoded_r: redis.Redis):
     assert await decoded_r.tdigest().create("t-digest", 500)
@@ -466,7 +446,6 @@ async def test_tdigest_rank(decoded_r: redis.Redis):
     assert [-1, 20, 9] == await decoded_r.tdigest().rank("t-digest", -20, 20, 9)
 
 
-@pytest.mark.redismod
 @pytest.mark.experimental
 async def test_tdigest_revrank(decoded_r: redis.Redis):
     assert await decoded_r.tdigest().create("t-digest", 500)
@@ -476,7 +455,6 @@ async def test_tdigest_revrank(decoded_r: redis.Redis):
     assert [-1, 19, 9] == await decoded_r.tdigest().revrank("t-digest", 21, 0, 10)
 
 
-@pytest.mark.redismod
 @pytest.mark.experimental
 async def test_tdigest_byrank(decoded_r: redis.Redis):
     assert await decoded_r.tdigest().create("t-digest", 500)
@@ -488,7 +466,6 @@ async def test_tdigest_byrank(decoded_r: redis.Redis):
         (await decoded_r.tdigest().byrank("t-digest", -1))[0]
 
 
-@pytest.mark.redismod
 @pytest.mark.experimental
 async def test_tdigest_byrevrank(decoded_r: redis.Redis):
     assert await decoded_r.tdigest().create("t-digest", 500)
@@ -500,8 +477,7 @@ async def test_tdigest_byrevrank(decoded_r: redis.Redis):
         (await decoded_r.tdigest().byrevrank("t-digest", -1))[0]
 
 
-# @pytest.mark.redismod
-# async def test_pipeline(decoded_r: redis.Redis):
+# # async def test_pipeline(decoded_r: redis.Redis):
 #     pipeline = await decoded_r.bf().pipeline()
 #     assert not await decoded_r.bf().execute_command("get pipeline")
 #
diff --git a/tests/test_asyncio/test_graph.py b/tests/test_asyncio/test_graph.py
index 22195901e6..4caf79470e 100644
--- a/tests/test_asyncio/test_graph.py
+++ b/tests/test_asyncio/test_graph.py
@@ -6,14 +6,12 @@
 from tests.conftest import skip_if_redis_enterprise
 
 
-@pytest.mark.redismod
 async def test_bulk(decoded_r):
     with pytest.raises(NotImplementedError):
         await decoded_r.graph().bulk()
         await decoded_r.graph().bulk(foo="bar!")
 
 
-@pytest.mark.redismod
 async def test_graph_creation(decoded_r: redis.Redis):
     graph = decoded_r.graph()
 
@@ -58,7 +56,6 @@ async def test_graph_creation(decoded_r: redis.Redis):
     await graph.delete()
 
 
-@pytest.mark.redismod
 async def test_array_functions(decoded_r: redis.Redis):
     graph = decoded_r.graph()
 
@@ -81,7 +78,6 @@ async def test_array_functions(decoded_r: redis.Redis):
     assert [a] == result.result_set[0][0]
 
 
-@pytest.mark.redismod
 async def test_path(decoded_r: redis.Redis):
     node0 = Node(node_id=0, label="L1")
     node1 = Node(node_id=1, label="L1")
@@ -101,7 +97,6 @@ async def test_path(decoded_r: redis.Redis):
     assert expected_results == result.result_set
 
 
-@pytest.mark.redismod
 async def test_param(decoded_r: redis.Redis):
     params = [1, 2.3, "str", True, False, None, [0, 1, 2]]
     query = "RETURN $param"
@@ -111,7 +106,6 @@ async def test_param(decoded_r: redis.Redis):
         assert expected_results == result.result_set
 
 
-@pytest.mark.redismod
 async def test_map(decoded_r: redis.Redis):
     query = "RETURN {a:1, b:'str', c:NULL, d:[1,2,3], e:True, f:{x:1, y:2}}"
 
@@ -128,7 +122,6 @@ async def test_map(decoded_r: redis.Redis):
     assert actual == expected
 
 
-@pytest.mark.redismod
 async def test_point(decoded_r: redis.Redis):
     query = "RETURN point({latitude: 32.070794860, longitude: 34.820751118})"
     expected_lat = 32.070794860
@@ -145,7 +138,6 @@ async def test_point(decoded_r: redis.Redis):
     assert abs(actual["longitude"] - expected_lon) < 0.001
 
 
-@pytest.mark.redismod
 async def test_index_response(decoded_r: redis.Redis):
     result_set = await decoded_r.graph().query("CREATE INDEX ON :person(age)")
     assert 1 == result_set.indices_created
@@ -160,7 +152,6 @@ async def test_index_response(decoded_r: redis.Redis):
         await decoded_r.graph().query("DROP INDEX ON :person(age)")
 
 
-@pytest.mark.redismod
 async def test_stringify_query_result(decoded_r: redis.Redis):
     graph = decoded_r.graph()
 
@@ -214,7 +205,6 @@ async def test_stringify_query_result(decoded_r: redis.Redis):
     await graph.delete()
 
 
-@pytest.mark.redismod
 async def test_optional_match(decoded_r: redis.Redis):
     # Build a graph of form (a)-[R]->(b)
     node0 = Node(node_id=0, label="L1", properties={"value": "a"})
@@ -239,7 +229,6 @@ async def test_optional_match(decoded_r: redis.Redis):
     await graph.delete()
 
 
-@pytest.mark.redismod
 async def test_cached_execution(decoded_r: redis.Redis):
     await decoded_r.graph().query("CREATE ()")
 
@@ -259,7 +248,6 @@ async def test_cached_execution(decoded_r: redis.Redis):
     assert cached_result.cached_execution
 
 
-@pytest.mark.redismod
 async def test_slowlog(decoded_r: redis.Redis):
     create_query = """CREATE
     (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
@@ -272,7 +260,6 @@ async def test_slowlog(decoded_r: redis.Redis):
     assert results[0][2] == create_query
 
 
-@pytest.mark.redismod
 @pytest.mark.xfail(strict=False)
 async def test_query_timeout(decoded_r: redis.Redis):
     # Build a sample graph with 1000 nodes.
@@ -287,7 +274,6 @@ async def test_query_timeout(decoded_r: redis.Redis):
         assert False is False
 
 
-@pytest.mark.redismod
 async def test_read_only_query(decoded_r: redis.Redis):
     with pytest.raises(Exception):
         # Issue a write query, specifying read-only true,
@@ -296,7 +282,6 @@ async def test_read_only_query(decoded_r: redis.Redis):
         assert False is False
 
 
-@pytest.mark.redismod
 async def test_profile(decoded_r: redis.Redis):
     q = """UNWIND range(1, 3) AS x CREATE (p:Person {v:x})"""
     profile = (await decoded_r.graph().profile(q)).result_set
@@ -311,7 +296,6 @@ async def test_profile(decoded_r: redis.Redis):
     assert "Node By Label Scan | (p:Person) | Records produced: 3" in profile
 
 
-@pytest.mark.redismod
 @skip_if_redis_enterprise()
 async def test_config(decoded_r: redis.Redis):
     config_name = "RESULTSET_SIZE"
@@ -343,7 +327,6 @@ async def test_config(decoded_r: redis.Redis):
     await decoded_r.graph().config("RESULTSET_SIZE", -100, set=True)
 
 
-@pytest.mark.redismod
 @pytest.mark.onlynoncluster
 async def test_list_keys(decoded_r: redis.Redis):
     result = await decoded_r.graph().list_keys()
@@ -367,7 +350,6 @@ async def test_list_keys(decoded_r: redis.Redis):
     assert result == []
 
 
-@pytest.mark.redismod
 async def test_multi_label(decoded_r: redis.Redis):
     redis_graph = decoded_r.graph("g")
 
@@ -393,7 +375,6 @@ async def test_multi_label(decoded_r: redis.Redis):
         assert True
 
 
-@pytest.mark.redismod
 async def test_execution_plan(decoded_r: redis.Redis):
     redis_graph = decoded_r.graph("execution_plan")
     create_query = """CREATE
@@ -412,7 +393,6 @@ async def test_execution_plan(decoded_r: redis.Redis):
     await redis_graph.delete()
 
 
-@pytest.mark.redismod
 async def test_explain(decoded_r: redis.Redis):
     redis_graph = decoded_r.graph("execution_plan")
     # graph creation / population
diff --git a/tests/test_asyncio/test_json.py b/tests/test_asyncio/test_json.py
index a35bd4795f..920ec71dce 100644
--- a/tests/test_asyncio/test_json.py
+++ b/tests/test_asyncio/test_json.py
@@ -5,7 +5,6 @@
 from tests.conftest import assert_resp_response, skip_ifmodversion_lt
 
 
-@pytest.mark.redismod
 async def test_json_setbinarykey(decoded_r: redis.Redis):
     d = {"hello": "world", b"some": "value"}
     with pytest.raises(TypeError):
@@ -13,7 +12,6 @@ async def test_json_setbinarykey(decoded_r: redis.Redis):
     assert await decoded_r.json().set("somekey", Path.root_path(), d, decode_keys=True)
 
 
-@pytest.mark.redismod
 async def test_json_setgetdeleteforget(decoded_r: redis.Redis):
     assert await decoded_r.json().set("foo", Path.root_path(), "bar")
     assert_resp_response(decoded_r, await decoded_r.json().get("foo"), "bar", [["bar"]])
@@ -23,13 +21,11 @@ async def test_json_setgetdeleteforget(decoded_r: redis.Redis):
     assert await decoded_r.exists("foo") == 0
 
 
-@pytest.mark.redismod
 async def test_jsonget(decoded_r: redis.Redis):
     await decoded_r.json().set("foo", Path.root_path(), "bar")
     assert_resp_response(decoded_r, await decoded_r.json().get("foo"), "bar", [["bar"]])
 
 
-@pytest.mark.redismod
 async def test_json_get_jset(decoded_r: redis.Redis):
     assert await decoded_r.json().set("foo", Path.root_path(), "bar")
     assert_resp_response(decoded_r, await decoded_r.json().get("foo"), "bar", [["bar"]])
@@ -38,7 +34,6 @@ async def test_json_get_jset(decoded_r: redis.Redis):
     assert await decoded_r.exists("foo") == 0
 
 
-@pytest.mark.redismod
 async def test_nonascii_setgetdelete(decoded_r: redis.Redis):
     assert await decoded_r.json().set("notascii", Path.root_path(), "hyvää-élève")
     res = "hyvää-élève"
@@ -49,7 +44,6 @@ async def test_nonascii_setgetdelete(decoded_r: redis.Redis):
     assert await decoded_r.exists("notascii") == 0
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("2.6.0", "ReJSON")
 async def test_json_merge(decoded_r: redis.Redis):
     # Test with root path $
@@ -84,7 +78,6 @@ async def test_json_merge(decoded_r: redis.Redis):
     }
 
 
-@pytest.mark.redismod
 async def test_jsonsetexistentialmodifiersshouldsucceed(decoded_r: redis.Redis):
     obj = {"foo": "bar"}
     assert await decoded_r.json().set("obj", Path.root_path(), obj)
@@ -102,7 +95,6 @@ async def test_jsonsetexistentialmodifiersshouldsucceed(decoded_r: redis.Redis):
         await decoded_r.json().set("obj", Path("foo"), "baz", nx=True, xx=True)
 
 
-@pytest.mark.redismod
 async def test_mgetshouldsucceed(decoded_r: redis.Redis):
     await decoded_r.json().set("1", Path.root_path(), 1)
     await decoded_r.json().set("2", Path.root_path(), 2)
@@ -111,7 +103,6 @@ async def test_mgetshouldsucceed(decoded_r: redis.Redis):
     assert await decoded_r.json().mget([1, 2], Path.root_path()) == [1, 2]
 
 
-@pytest.mark.redismod
 @pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("2.6.0", "ReJSON")
 async def test_mset(decoded_r: redis.Redis):
@@ -123,7 +114,6 @@ async def test_mset(decoded_r: redis.Redis):
     assert await decoded_r.json().mget(["1", "2"], Path.root_path()) == [1, 2]
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
 async def test_clear(decoded_r: redis.Redis):
     await decoded_r.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
@@ -131,7 +121,6 @@ async def test_clear(decoded_r: redis.Redis):
     assert_resp_response(decoded_r, await decoded_r.json().get("arr"), [], [[[]]])
 
 
-@pytest.mark.redismod
 async def test_type(decoded_r: redis.Redis):
     await decoded_r.json().set("1", Path.root_path(), 1)
     assert_resp_response(
@@ -145,7 +134,6 @@ async def test_type(decoded_r: redis.Redis):
     )
 
 
-@pytest.mark.redismod
 async def test_numincrby(decoded_r):
     await decoded_r.json().set("num", Path.root_path(), 1)
     assert_resp_response(
@@ -157,7 +145,6 @@ async def test_numincrby(decoded_r):
     assert_resp_response(decoded_r, res, 1.25, [1.25])
 
 
-@pytest.mark.redismod
 async def test_nummultby(decoded_r: redis.Redis):
     await decoded_r.json().set("num", Path.root_path(), 1)
 
@@ -170,7 +157,6 @@ async def test_nummultby(decoded_r: redis.Redis):
         assert_resp_response(decoded_r, res, 2.5, [2.5])
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
 async def test_toggle(decoded_r: redis.Redis):
     await decoded_r.json().set("bool", Path.root_path(), False)
@@ -182,7 +168,6 @@ async def test_toggle(decoded_r: redis.Redis):
         await decoded_r.json().toggle("num", Path.root_path())
 
 
-@pytest.mark.redismod
 async def test_strappend(decoded_r: redis.Redis):
     await decoded_r.json().set("jsonkey", Path.root_path(), "foo")
     assert 6 == await decoded_r.json().strappend("jsonkey", "bar")
@@ -190,7 +175,6 @@ async def test_strappend(decoded_r: redis.Redis):
     assert_resp_response(decoded_r, res, "foobar", [["foobar"]])
 
 
-@pytest.mark.redismod
 async def test_strlen(decoded_r: redis.Redis):
     await decoded_r.json().set("str", Path.root_path(), "foo")
     assert 3 == await decoded_r.json().strlen("str", Path.root_path())
@@ -199,7 +183,6 @@ async def test_strlen(decoded_r: redis.Redis):
     assert 6 == await decoded_r.json().strlen("str")
 
 
-@pytest.mark.redismod
 async def test_arrappend(decoded_r: redis.Redis):
     await decoded_r.json().set("arr", Path.root_path(), [1])
     assert 2 == await decoded_r.json().arrappend("arr", Path.root_path(), 2)
@@ -207,7 +190,6 @@ async def test_arrappend(decoded_r: redis.Redis):
     assert 7 == await decoded_r.json().arrappend("arr", Path.root_path(), *[5, 6, 7])
 
 
-@pytest.mark.redismod
 async def test_arrindex(decoded_r: redis.Redis):
     r_path = Path.root_path()
     await decoded_r.json().set("arr", r_path, [0, 1, 2, 3, 4])
@@ -220,7 +202,6 @@ async def test_arrindex(decoded_r: redis.Redis):
     assert -1 == await decoded_r.json().arrindex("arr", r_path, 4, start=1, stop=3)
 
 
-@pytest.mark.redismod
 async def test_arrinsert(decoded_r: redis.Redis):
     await decoded_r.json().set("arr", Path.root_path(), [0, 4])
     assert 5 == await decoded_r.json().arrinsert("arr", Path.root_path(), 1, *[1, 2, 3])
@@ -234,7 +215,6 @@ async def test_arrinsert(decoded_r: redis.Redis):
     assert_resp_response(decoded_r, await decoded_r.json().get("val2"), res, [[res]])
 
 
-@pytest.mark.redismod
 async def test_arrlen(decoded_r: redis.Redis):
     await decoded_r.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
     assert 5 == await decoded_r.json().arrlen("arr", Path.root_path())
@@ -242,7 +222,6 @@ async def test_arrlen(decoded_r: redis.Redis):
     assert await decoded_r.json().arrlen("fakekey") is None
 
 
-@pytest.mark.redismod
 async def test_arrpop(decoded_r: redis.Redis):
     await decoded_r.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
     assert 4 == await decoded_r.json().arrpop("arr", Path.root_path(), 4)
@@ -260,7 +239,6 @@ async def test_arrpop(decoded_r: redis.Redis):
     assert await decoded_r.json().arrpop("arr") is None
 
 
-@pytest.mark.redismod
 async def test_arrtrim(decoded_r: redis.Redis):
     await decoded_r.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
     assert 3 == await decoded_r.json().arrtrim("arr", Path.root_path(), 1, 3)
@@ -284,7 +262,6 @@ async def test_arrtrim(decoded_r: redis.Redis):
     assert 0 == await decoded_r.json().arrtrim("arr", Path.root_path(), 9, 11)
 
 
-@pytest.mark.redismod
 async def test_resp(decoded_r: redis.Redis):
     obj = {"foo": "bar", "baz": 1, "qaz": True}
     await decoded_r.json().set("obj", Path.root_path(), obj)
@@ -294,7 +271,6 @@ async def test_resp(decoded_r: redis.Redis):
     assert isinstance(await decoded_r.json().resp("obj"), list)
 
 
-@pytest.mark.redismod
 async def test_objkeys(decoded_r: redis.Redis):
     obj = {"foo": "bar", "baz": "qaz"}
     await decoded_r.json().set("obj", Path.root_path(), obj)
@@ -311,7 +287,6 @@ async def test_objkeys(decoded_r: redis.Redis):
     assert await decoded_r.json().objkeys("fakekey") is None
 
 
-@pytest.mark.redismod
 async def test_objlen(decoded_r: redis.Redis):
     obj = {"foo": "bar", "baz": "qaz"}
     await decoded_r.json().set("obj", Path.root_path(), obj)
@@ -345,7 +320,6 @@ async def test_objlen(decoded_r: redis.Redis):
 #     assert await decoded_r.get("foo") is None
 
 
-@pytest.mark.redismod
 async def test_json_delete_with_dollar(decoded_r: redis.Redis):
     doc1 = {"a": 1, "nested": {"a": 2, "b": 3}}
     assert await decoded_r.json().set("doc1", "$", doc1)
@@ -399,7 +373,6 @@ async def test_json_delete_with_dollar(decoded_r: redis.Redis):
     await decoded_r.json().delete("not_a_document", "..a")
 
 
-@pytest.mark.redismod
 async def test_json_forget_with_dollar(decoded_r: redis.Redis):
     doc1 = {"a": 1, "nested": {"a": 2, "b": 3}}
     assert await decoded_r.json().set("doc1", "$", doc1)
@@ -452,7 +425,7 @@ async def test_json_forget_with_dollar(decoded_r: redis.Redis):
     await decoded_r.json().forget("not_a_document", "..a")
 
 
-@pytest.mark.redismod
+@pytest.mark.onlynoncluster
 async def test_json_mget_dollar(decoded_r: redis.Redis):
     # Test mget with multi paths
     await decoded_r.json().set(
@@ -488,7 +461,6 @@ async def test_json_mget_dollar(decoded_r: redis.Redis):
     assert res == [None, None]
 
 
-@pytest.mark.redismod
 async def test_numby_commands_dollar(decoded_r: redis.Redis):
     # Test NUMINCRBY
     await decoded_r.json().set(
@@ -543,7 +515,6 @@ async def test_numby_commands_dollar(decoded_r: redis.Redis):
         await decoded_r.json().nummultby("doc1", ".b[0].a", 3) == 6
 
 
-@pytest.mark.redismod
 async def test_strappend_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1", "$", {"a": "foo", "nested1": {"a": "hello"}, "nested2": {"a": 31}}
@@ -574,7 +545,6 @@ async def test_strappend_dollar(decoded_r: redis.Redis):
         await decoded_r.json().strappend("doc1", "piu")
 
 
-@pytest.mark.redismod
 async def test_strlen_dollar(decoded_r: redis.Redis):
     # Test multi
     await decoded_r.json().set(
@@ -595,7 +565,6 @@ async def test_strlen_dollar(decoded_r: redis.Redis):
         await decoded_r.json().strlen("non_existing_doc", "$..a")
 
 
-@pytest.mark.redismod
 async def test_arrappend_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1",
@@ -669,7 +638,6 @@ async def test_arrappend_dollar(decoded_r: redis.Redis):
         await decoded_r.json().arrappend("non_existing_doc", "$..a")
 
 
-@pytest.mark.redismod
 async def test_arrinsert_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1",
@@ -708,7 +676,6 @@ async def test_arrinsert_dollar(decoded_r: redis.Redis):
         await decoded_r.json().arrappend("non_existing_doc", "$..a")
 
 
-@pytest.mark.redismod
 async def test_arrlen_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1",
@@ -754,7 +721,6 @@ async def test_arrlen_dollar(decoded_r: redis.Redis):
     assert await decoded_r.json().arrlen("non_existing_doc", "..a") is None
 
 
-@pytest.mark.redismod
 async def test_arrpop_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1",
@@ -796,7 +762,6 @@ async def test_arrpop_dollar(decoded_r: redis.Redis):
         await decoded_r.json().arrpop("non_existing_doc", "..a")
 
 
-@pytest.mark.redismod
 async def test_arrtrim_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1",
@@ -848,7 +813,6 @@ async def test_arrtrim_dollar(decoded_r: redis.Redis):
         await decoded_r.json().arrtrim("non_existing_doc", "..a", 1, 1)
 
 
-@pytest.mark.redismod
 async def test_objkeys_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1",
@@ -878,7 +842,6 @@ async def test_objkeys_dollar(decoded_r: redis.Redis):
     assert await decoded_r.json().objkeys("doc1", "$..nowhere") == []
 
 
-@pytest.mark.redismod
 async def test_objlen_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1",
@@ -914,7 +877,6 @@ async def test_objlen_dollar(decoded_r: redis.Redis):
     await decoded_r.json().objlen("doc1", ".nowhere")
 
 
-@pytest.mark.redismod
 def load_types_data(nested_key_name):
     td = {
         "object": {},
@@ -934,7 +896,6 @@ def load_types_data(nested_key_name):
     return jdata, types
 
 
-@pytest.mark.redismod
 async def test_type_dollar(decoded_r: redis.Redis):
     jdata, jtypes = load_types_data("a")
     await decoded_r.json().set("doc1", "$", jdata)
@@ -953,7 +914,6 @@ async def test_type_dollar(decoded_r: redis.Redis):
     )
 
 
-@pytest.mark.redismod
 async def test_clear_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1",
@@ -1007,7 +967,6 @@ async def test_clear_dollar(decoded_r: redis.Redis):
         await decoded_r.json().clear("non_existing_doc", "$..a")
 
 
-@pytest.mark.redismod
 async def test_toggle_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1",
diff --git a/tests/test_asyncio/test_timeseries.py b/tests/test_asyncio/test_timeseries.py
index 91c15c3db2..b44219707e 100644
--- a/tests/test_asyncio/test_timeseries.py
+++ b/tests/test_asyncio/test_timeseries.py
@@ -10,7 +10,6 @@
 )
 
 
-@pytest.mark.redismod
 async def test_create(decoded_r: redis.Redis):
     assert await decoded_r.ts().create(1)
     assert await decoded_r.ts().create(2, retention_msecs=5)
@@ -28,7 +27,6 @@ async def test_create(decoded_r: redis.Redis):
     assert_resp_response(decoded_r, 128, info.get("chunk_size"), info.get("chunkSize"))
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
 async def test_create_duplicate_policy(decoded_r: redis.Redis):
     # Test for duplicate policy
@@ -44,7 +42,6 @@ async def test_create_duplicate_policy(decoded_r: redis.Redis):
         )
 
 
-@pytest.mark.redismod
 async def test_alter(decoded_r: redis.Redis):
     assert await decoded_r.ts().create(1)
     res = await decoded_r.ts().info(1)
@@ -67,7 +64,6 @@ async def test_alter(decoded_r: redis.Redis):
     )
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
 async def test_alter_diplicate_policy(decoded_r: redis.Redis):
     assert await decoded_r.ts().create(1)
@@ -82,7 +78,6 @@ async def test_alter_diplicate_policy(decoded_r: redis.Redis):
     )
 
 
-@pytest.mark.redismod
 async def test_add(decoded_r: redis.Redis):
     assert 1 == await decoded_r.ts().add(1, 1, 1)
     assert 2 == await decoded_r.ts().add(2, 2, 3, retention_msecs=10)
@@ -105,7 +100,6 @@ async def test_add(decoded_r: redis.Redis):
     assert_resp_response(decoded_r, 128, info.get("chunk_size"), info.get("chunkSize"))
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
 async def test_add_duplicate_policy(r: redis.Redis):
     # Test for duplicate policy BLOCK
@@ -146,7 +140,6 @@ async def test_add_duplicate_policy(r: redis.Redis):
     assert 5.0 == res[1]
 
 
-@pytest.mark.redismod
 async def test_madd(decoded_r: redis.Redis):
     await decoded_r.ts().create("a")
     assert [1, 2, 3] == await decoded_r.ts().madd(
@@ -154,7 +147,6 @@ async def test_madd(decoded_r: redis.Redis):
     )
 
 
-@pytest.mark.redismod
 async def test_incrby_decrby(decoded_r: redis.Redis):
     for _ in range(100):
         assert await decoded_r.ts().incrby(1, 1)
@@ -183,7 +175,6 @@ async def test_incrby_decrby(decoded_r: redis.Redis):
     assert_resp_response(decoded_r, 128, info.get("chunk_size"), info.get("chunkSize"))
 
 
-@pytest.mark.redismod
 async def test_create_and_delete_rule(decoded_r: redis.Redis):
     # test rule creation
     time = 100
@@ -207,7 +198,6 @@ async def test_create_and_delete_rule(decoded_r: redis.Redis):
     assert not info["rules"]
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 async def test_del_range(decoded_r: redis.Redis):
     try:
@@ -224,7 +214,6 @@ async def test_del_range(decoded_r: redis.Redis):
     )
 
 
-@pytest.mark.redismod
 async def test_range(r: redis.Redis):
     for i in range(100):
         await r.ts().add(1, i, i % 7)
@@ -239,7 +228,6 @@ async def test_range(r: redis.Redis):
     assert 10 == len(await r.ts().range(1, 0, 500, count=10))
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 async def test_range_advanced(decoded_r: redis.Redis):
     for i in range(100):
@@ -270,7 +258,6 @@ async def test_range_advanced(decoded_r: redis.Redis):
     assert_resp_response(decoded_r, res, [(0, 2.55), (10, 3.0)], [[0, 2.55], [10, 3.0]])
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 async def test_rev_range(decoded_r: redis.Redis):
     for i in range(100):
@@ -314,7 +301,6 @@ async def test_rev_range(decoded_r: redis.Redis):
     )
 
 
-@pytest.mark.redismod
 @pytest.mark.onlynoncluster
 async def test_multi_range(decoded_r: redis.Redis):
     await decoded_r.ts().create(1, labels={"Test": "This", "team": "ny"})
@@ -369,7 +355,6 @@ async def test_multi_range(decoded_r: redis.Redis):
         assert {"Test": "This", "team": "ny"} == res["1"][0]
 
 
-@pytest.mark.redismod
 @pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 async def test_multi_range_advanced(decoded_r: redis.Redis):
@@ -487,7 +472,6 @@ async def test_multi_range_advanced(decoded_r: redis.Redis):
         assert [[0, 5.0], [5, 6.0]] == res["1"][2]
 
 
-@pytest.mark.redismod
 @pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 async def test_multi_reverse_range(decoded_r: redis.Redis):
@@ -651,7 +635,6 @@ async def test_multi_reverse_range(decoded_r: redis.Redis):
         assert [[1, 10.0], [0, 1.0]] == res["1"][2]
 
 
-@pytest.mark.redismod
 async def test_get(decoded_r: redis.Redis):
     name = "test"
     await decoded_r.ts().create(name)
@@ -662,7 +645,6 @@ async def test_get(decoded_r: redis.Redis):
     assert 4 == (await decoded_r.ts().get(name))[1]
 
 
-@pytest.mark.redismod
 @pytest.mark.onlynoncluster
 async def test_mget(decoded_r: redis.Redis):
     await decoded_r.ts().create(1, labels={"Test": "This"})
@@ -698,7 +680,6 @@ async def test_mget(decoded_r: redis.Redis):
         assert {"Taste": "That", "Test": "This"} == res["2"][0]
 
 
-@pytest.mark.redismod
 async def test_info(decoded_r: redis.Redis):
     await decoded_r.ts().create(
         1, retention_msecs=5, labels={"currentLabel": "currentData"}
@@ -710,7 +691,6 @@ async def test_info(decoded_r: redis.Redis):
     assert info["labels"]["currentLabel"] == "currentData"
 
 
-@pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
 async def testInfoDuplicatePolicy(decoded_r: redis.Redis):
     await decoded_r.ts().create(
@@ -728,7 +708,6 @@ async def testInfoDuplicatePolicy(decoded_r: redis.Redis):
     )
 
 
-@pytest.mark.redismod
 @pytest.mark.onlynoncluster
 async def test_query_index(decoded_r: redis.Redis):
     await decoded_r.ts().create(1, labels={"Test": "This"})
@@ -740,8 +719,7 @@ async def test_query_index(decoded_r: redis.Redis):
     )
 
 
-# @pytest.mark.redismod
-# async def test_pipeline(r: redis.Redis):
+# # async def test_pipeline(r: redis.Redis):
 #     pipeline = await r.ts().pipeline()
 #     pipeline.create("with_pipeline")
 #     for i in range(100):
@@ -754,7 +732,6 @@ async def test_query_index(decoded_r: redis.Redis):
 #     assert await r.ts().get("with_pipeline")[1] == 99 * 1.1
 
 
-@pytest.mark.redismod
 async def test_uncompressed(decoded_r: redis.Redis):
     await decoded_r.ts().create("compressed")
     await decoded_r.ts().create("uncompressed", uncompressed=True)

From 1a7d474268fe7072686369adc20aa498d63f063e Mon Sep 17 00:00:00 2001
From: Ahmed Ashraf <104530599+ahmedabdou14@users.noreply.github.com>
Date: Tue, 23 Jan 2024 14:35:54 +0300
Subject: [PATCH 0844/1164] Fix grammer in BlockingConnectionPool class
 documentation (#3120)

Co-authored-by: ahmedabdou14 <root@xps>
---
 redis/asyncio/connection.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 77aa21f034..07c4262233 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -1280,7 +1280,7 @@ class BlockingConnectionPool(ConnectionPool):
     connection from the pool when all of connections are in use, rather than
     raising a :py:class:`~redis.ConnectionError` (as the default
     :py:class:`~redis.asyncio.ConnectionPool` implementation does), it
-    makes blocks the current `Task` for a specified number of seconds until
+    blocks the current `Task` for a specified number of seconds until
     a connection becomes available.
 
     Use ``max_connections`` to increase / decrease the pool size::

From 2f88840383453d713859244b8206d7f942c3bcc4 Mon Sep 17 00:00:00 2001
From: Dongkeun Lee <3315213+zakaf@users.noreply.github.com>
Date: Mon, 5 Feb 2024 02:04:10 +0900
Subject: [PATCH 0845/1164] release already acquired connections on
 ClusterPipeline, when get_connection raises an exception (#3133)

Signed-off-by: zach.lee <zach.lee@sendbird.com>
---
 redis/cluster.py      |  2 ++
 tests/test_cluster.py | 26 ++++++++++++++++++++++++++
 2 files changed, 28 insertions(+)

diff --git a/redis/cluster.py b/redis/cluster.py
index c36665eb5c..ba25b92246 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -2143,6 +2143,8 @@ def _send_cluster_commands(
                     try:
                         connection = get_connection(redis_node, c.args)
                     except ConnectionError:
+                        for n in nodes.values():
+                            n.connection_pool.release(n.connection)
                         # Connection retries are being handled in the node's
                         # Retry object. Reinitialize the node -> slot table.
                         self.nodes_manager.initialize()
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 854b64c563..8a44d45ea3 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -10,6 +10,7 @@
 from unittest.mock import DEFAULT, Mock, call, patch
 
 import pytest
+import redis
 from redis import Redis
 from redis._parsers import CommandsParser
 from redis.backoff import ExponentialBackoff, NoBackoff, default_backoff
@@ -3250,6 +3251,31 @@ def raise_ask_error():
             assert ask_node.redis_connection.connection.read_response.called
             assert res == ["MOCK_OK"]
 
+    def test_return_previously_acquired_connections(self, r):
+        # in order to ensure that a pipeline will make use of connections
+        #   from different nodes
+        assert r.keyslot("a") != r.keyslot("b")
+
+        orig_func = redis.cluster.get_connection
+        with patch("redis.cluster.get_connection") as get_connection:
+
+            def raise_error(target_node, *args, **kwargs):
+                if get_connection.call_count == 2:
+                    raise ConnectionError("mocked error")
+                else:
+                    return orig_func(target_node, *args, **kwargs)
+
+            get_connection.side_effect = raise_error
+
+            r.pipeline().get("a").get("b").execute()
+
+        # 4 = 2 get_connections per execution * 2 executions
+        assert get_connection.call_count == 4
+        for cluster_node in r.nodes_manager.nodes_cache.values():
+            connection_pool = cluster_node.redis_connection.connection_pool
+            num_of_conns = len(connection_pool._available_connections)
+            assert num_of_conns == connection_pool._created_connections
+
     def test_empty_stack(self, r):
         """
         If pipeline is executed with no commands it should

From b1ee455ec2e384f9f4092717b02e640d06e8e1a6 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 5 Feb 2024 01:58:17 +0200
Subject: [PATCH 0846/1164] Bump actions/stale from 3 to 9 (#3132)

Bumps [actions/stale](https://github.com/actions/stale) from 3 to 9.
- [Release notes](https://github.com/actions/stale/releases)
- [Changelog](https://github.com/actions/stale/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/stale/compare/v3...v9)

---
updated-dependencies:
- dependency-name: actions/stale
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/stale-issues.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/stale-issues.yml b/.github/workflows/stale-issues.yml
index 32fd9e8179..445af1c818 100644
--- a/.github/workflows/stale-issues.yml
+++ b/.github/workflows/stale-issues.yml
@@ -12,7 +12,7 @@ jobs:
 
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/stale@v3
+    - uses: actions/stale@v9
       with:
         repo-token: ${{ secrets.GITHUB_TOKEN }}
         stale-issue-message: 'This issue is marked stale. It will be closed in 30 days if it is not updated.'

From 7f632962d124d74a361a961a5ee452593098d1b8 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 5 Feb 2024 01:58:39 +0200
Subject: [PATCH 0847/1164] Bump codecov/codecov-action from 3 to 4 (#3131)

Bumps [codecov/codecov-action](https://github.com/codecov/codecov-action) from 3 to 4.
- [Release notes](https://github.com/codecov/codecov-action/releases)
- [Changelog](https://github.com/codecov/codecov-action/blob/main/CHANGELOG.md)
- [Commits](https://github.com/codecov/codecov-action/compare/v3...v4)

---
updated-dependencies:
- dependency-name: codecov/codecov-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/integration.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 7aaf346170..695e1b307c 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -88,7 +88,7 @@ jobs:
            path: '${{matrix.test-type}}*results.xml'
 
        - name: Upload codecov coverage
-         uses: codecov/codecov-action@v3
+         uses: codecov/codecov-action@v4
          with:
            fail_ci_if_error: false
 

From 7df57e5a32ad44446c1209ed7b8a38e996036354 Mon Sep 17 00:00:00 2001
From: poiuj <1099644+poiuj@users.noreply.github.com>
Date: Mon, 5 Feb 2024 15:12:59 +0200
Subject: [PATCH 0848/1164] Allow to control the minimum SSL version (#3127)

* Allow to control the minimum SSL version

It's useful for applications that has strict security requirements.

* Add tests for minimum SSL version

The commit updates test_tcp_ssl_connect for both sync and async
connections. Now it sets the minimum SSL version. The test is ran with
both TLSv1.2 and TLSv1.3 (if supported).

A new test case is test_tcp_ssl_version_mismatch. The test added for
both sync and async connections. It uses TLS 1.3 on the client side,
and TLS 1.2 on the server side. It expects a connection error. The
test is skipped if TLS 1.3 is not supported.

* Add example of using a minimum TLS version
---
 CHANGES                                     |  1 +
 docs/examples/ssl_connection_examples.ipynb | 36 +++++++++++++
 redis/asyncio/client.py                     |  3 ++
 redis/asyncio/cluster.py                    |  3 ++
 redis/asyncio/connection.py                 | 11 ++++
 redis/client.py                             |  2 +
 redis/connection.py                         |  5 ++
 tests/test_asyncio/test_connect.py          | 54 ++++++++++++++++++--
 tests/test_connect.py                       | 56 ++++++++++++++++++---
 9 files changed, 161 insertions(+), 10 deletions(-)

diff --git a/CHANGES b/CHANGES
index 3d9d6292a1..e0959b0ef3 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Allow to control the minimum SSL version
     * Add an optional lock_name attribute to LockError.
     * Fix return types for `get`, `set_path` and `strappend` in JSONCommands
     * Connection.register_connect_callback() is made public.
diff --git a/docs/examples/ssl_connection_examples.ipynb b/docs/examples/ssl_connection_examples.ipynb
index ab3b4415ae..a3d015619f 100644
--- a/docs/examples/ssl_connection_examples.ipynb
+++ b/docs/examples/ssl_connection_examples.ipynb
@@ -76,6 +76,42 @@
     "ssl_connection.ping()"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Connecting to a Redis instance via SSL, while specifying a minimum TLS version"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 6,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "import redis\n",
+    "import ssl\n",
+    "\n",
+    "ssl_conn = redis.Redis(\n",
+    "    host=\"localhost\",\n",
+    "    port=6666,\n",
+    "    ssl=True,\n",
+    "    ssl_min_version=ssl.TLSVersion.TLSv1_3,\n",
+    ")\n",
+    "ssl_conn.ping()"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 88de893f5b..62bdc7dd5c 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -2,6 +2,7 @@
 import copy
 import inspect
 import re
+import ssl
 import warnings
 from typing import (
     TYPE_CHECKING,
@@ -226,6 +227,7 @@ def __init__(
         ssl_ca_certs: Optional[str] = None,
         ssl_ca_data: Optional[str] = None,
         ssl_check_hostname: bool = False,
+        ssl_min_version: Optional[ssl.TLSVersion] = None,
         max_connections: Optional[int] = None,
         single_connection_client: bool = False,
         health_check_interval: int = 0,
@@ -332,6 +334,7 @@ def __init__(
                             "ssl_ca_certs": ssl_ca_certs,
                             "ssl_ca_data": ssl_ca_data,
                             "ssl_check_hostname": ssl_check_hostname,
+                            "ssl_min_version": ssl_min_version,
                         }
                     )
             # This arg only used if no pool is passed in
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 337c7bbdcc..4fb2fc4647 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -2,6 +2,7 @@
 import collections
 import random
 import socket
+import ssl
 import warnings
 from typing import (
     Any,
@@ -271,6 +272,7 @@ def __init__(
         ssl_certfile: Optional[str] = None,
         ssl_check_hostname: bool = False,
         ssl_keyfile: Optional[str] = None,
+        ssl_min_version: Optional[ssl.TLSVersion] = None,
         protocol: Optional[int] = 2,
         address_remap: Optional[Callable[[str, int], Tuple[str, int]]] = None,
         cache_enabled: bool = False,
@@ -344,6 +346,7 @@ def __init__(
                     "ssl_certfile": ssl_certfile,
                     "ssl_check_hostname": ssl_check_hostname,
                     "ssl_keyfile": ssl_keyfile,
+                    "ssl_min_version": ssl_min_version,
                 }
             )
 
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 07c4262233..81df3b3543 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -823,6 +823,7 @@ def __init__(
         ssl_ca_certs: Optional[str] = None,
         ssl_ca_data: Optional[str] = None,
         ssl_check_hostname: bool = False,
+        ssl_min_version: Optional[ssl.TLSVersion] = None,
         **kwargs,
     ):
         self.ssl_context: RedisSSLContext = RedisSSLContext(
@@ -832,6 +833,7 @@ def __init__(
             ca_certs=ssl_ca_certs,
             ca_data=ssl_ca_data,
             check_hostname=ssl_check_hostname,
+            min_version=ssl_min_version,
         )
         super().__init__(**kwargs)
 
@@ -864,6 +866,10 @@ def ca_data(self):
     def check_hostname(self):
         return self.ssl_context.check_hostname
 
+    @property
+    def min_version(self):
+        return self.ssl_context.min_version
+
 
 class RedisSSLContext:
     __slots__ = (
@@ -874,6 +880,7 @@ class RedisSSLContext:
         "ca_data",
         "context",
         "check_hostname",
+        "min_version",
     )
 
     def __init__(
@@ -884,6 +891,7 @@ def __init__(
         ca_certs: Optional[str] = None,
         ca_data: Optional[str] = None,
         check_hostname: bool = False,
+        min_version: Optional[ssl.TLSVersion] = None,
     ):
         self.keyfile = keyfile
         self.certfile = certfile
@@ -903,6 +911,7 @@ def __init__(
         self.ca_certs = ca_certs
         self.ca_data = ca_data
         self.check_hostname = check_hostname
+        self.min_version = min_version
         self.context: Optional[ssl.SSLContext] = None
 
     def get(self) -> ssl.SSLContext:
@@ -914,6 +923,8 @@ def get(self) -> ssl.SSLContext:
                 context.load_cert_chain(certfile=self.certfile, keyfile=self.keyfile)
             if self.ca_certs or self.ca_data:
                 context.load_verify_locations(cafile=self.ca_certs, cadata=self.ca_data)
+            if self.min_version is not None:
+                context.minimum_version = self.min_version
             self.context = context
         return self.context
 
diff --git a/redis/client.py b/redis/client.py
index 2d4c512699..1209a978d2 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -198,6 +198,7 @@ def __init__(
         ssl_validate_ocsp_stapled=False,
         ssl_ocsp_context=None,
         ssl_ocsp_expected_cert=None,
+        ssl_min_version=None,
         max_connections=None,
         single_connection_client=False,
         health_check_interval=0,
@@ -311,6 +312,7 @@ def __init__(
                             "ssl_validate_ocsp": ssl_validate_ocsp,
                             "ssl_ocsp_context": ssl_ocsp_context,
                             "ssl_ocsp_expected_cert": ssl_ocsp_expected_cert,
+                            "ssl_min_version": ssl_min_version,
                         }
                     )
             connection_pool = ConnectionPool(**kwargs)
diff --git a/redis/connection.py b/redis/connection.py
index 1f46267146..c9f7fc55d0 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -769,6 +769,7 @@ def __init__(
         ssl_validate_ocsp_stapled=False,
         ssl_ocsp_context=None,
         ssl_ocsp_expected_cert=None,
+        ssl_min_version=None,
         **kwargs,
     ):
         """Constructor
@@ -787,6 +788,7 @@ def __init__(
             ssl_validate_ocsp_stapled: If set, perform a validation on a stapled ocsp response
             ssl_ocsp_context: A fully initialized OpenSSL.SSL.Context object to be used in verifying the ssl_ocsp_expected_cert
             ssl_ocsp_expected_cert: A PEM armoured string containing the expected certificate to be returned from the ocsp verification service.
+            ssl_min_version: The lowest supported SSL version. It affects the supported SSL versions of the SSLContext. None leaves the default provided by ssl module.
 
         Raises:
             RedisError
@@ -819,6 +821,7 @@ def __init__(
         self.ssl_validate_ocsp_stapled = ssl_validate_ocsp_stapled
         self.ssl_ocsp_context = ssl_ocsp_context
         self.ssl_ocsp_expected_cert = ssl_ocsp_expected_cert
+        self.ssl_min_version = ssl_min_version
         super().__init__(**kwargs)
 
     def _connect(self):
@@ -841,6 +844,8 @@ def _connect(self):
             context.load_verify_locations(
                 cafile=self.ca_certs, capath=self.ca_path, cadata=self.ca_data
             )
+        if self.ssl_min_version is not None:
+            context.minimum_version = self.ssl_min_version
         sslsock = context.wrap_socket(sock, server_hostname=self.host)
         if self.ssl_validate_ocsp is True and CRYPTOGRAPHY_AVAILABLE is False:
             raise RedisError("cryptography is not installed.")
diff --git a/tests/test_asyncio/test_connect.py b/tests/test_asyncio/test_connect.py
index 5e6b120fb3..5497501258 100644
--- a/tests/test_asyncio/test_connect.py
+++ b/tests/test_asyncio/test_connect.py
@@ -10,6 +10,7 @@
     SSLConnection,
     UnixDomainSocketConnection,
 )
+from redis.exceptions import ConnectionError
 
 from ..ssl_utils import get_ssl_filename
 
@@ -50,7 +51,17 @@ async def test_uds_connect(uds_address):
 
 
 @pytest.mark.ssl
-async def test_tcp_ssl_connect(tcp_address):
+@pytest.mark.parametrize(
+    "ssl_min_version",
+    [
+        ssl.TLSVersion.TLSv1_2,
+        pytest.param(
+            ssl.TLSVersion.TLSv1_3,
+            marks=pytest.mark.skipif(not ssl.HAS_TLSv1_3, reason="requires TLSv1.3"),
+        ),
+    ],
+)
+async def test_tcp_ssl_connect(tcp_address, ssl_min_version):
     host, port = tcp_address
     certfile = get_ssl_filename("server-cert.pem")
     keyfile = get_ssl_filename("server-key.pem")
@@ -60,12 +71,44 @@ async def test_tcp_ssl_connect(tcp_address):
         client_name=_CLIENT_NAME,
         ssl_ca_certs=certfile,
         socket_timeout=10,
+        ssl_min_version=ssl_min_version,
     )
     await _assert_connect(conn, tcp_address, certfile=certfile, keyfile=keyfile)
     await conn.disconnect()
 
 
-async def _assert_connect(conn, server_address, certfile=None, keyfile=None):
+@pytest.mark.ssl
+@pytest.mark.skipif(not ssl.HAS_TLSv1_3, reason="requires TLSv1.3")
+async def test_tcp_ssl_version_mismatch(tcp_address):
+    host, port = tcp_address
+    certfile = get_ssl_filename("server-cert.pem")
+    keyfile = get_ssl_filename("server-key.pem")
+    conn = SSLConnection(
+        host=host,
+        port=port,
+        client_name=_CLIENT_NAME,
+        ssl_ca_certs=certfile,
+        socket_timeout=1,
+        ssl_min_version=ssl.TLSVersion.TLSv1_3,
+    )
+    with pytest.raises(ConnectionError):
+        await _assert_connect(
+            conn,
+            tcp_address,
+            certfile=certfile,
+            keyfile=keyfile,
+            ssl_version=ssl.TLSVersion.TLSv1_2,
+        )
+    await conn.disconnect()
+
+
+async def _assert_connect(
+    conn,
+    server_address,
+    certfile=None,
+    keyfile=None,
+    ssl_version=None,
+):
     stop_event = asyncio.Event()
     finished = asyncio.Event()
 
@@ -82,7 +125,9 @@ async def _handler(reader, writer):
     elif certfile:
         host, port = server_address
         context = ssl.create_default_context(ssl.Purpose.CLIENT_AUTH)
-        context.minimum_version = ssl.TLSVersion.TLSv1_2
+        if ssl_version is not None:
+            context.minimum_version = ssl_version
+            context.maximum_version = ssl_version
         context.load_cert_chain(certfile=certfile, keyfile=keyfile)
         server = await asyncio.start_server(_handler, host=host, port=port, ssl=context)
     else:
@@ -94,6 +139,9 @@ async def _handler(reader, writer):
         try:
             await conn.connect()
             await conn.disconnect()
+        except ConnectionError:
+            finished.set()
+            raise
         finally:
             stop_event.set()
             aserver.close()
diff --git a/tests/test_connect.py b/tests/test_connect.py
index 696e69ceea..0fdbb7005f 100644
--- a/tests/test_connect.py
+++ b/tests/test_connect.py
@@ -7,6 +7,7 @@
 
 import pytest
 from redis.connection import Connection, SSLConnection, UnixDomainSocketConnection
+from redis.exceptions import ConnectionError
 
 from .ssl_utils import get_ssl_filename
 
@@ -45,7 +46,17 @@ def test_uds_connect(uds_address):
 
 
 @pytest.mark.ssl
-def test_tcp_ssl_connect(tcp_address):
+@pytest.mark.parametrize(
+    "ssl_min_version",
+    [
+        ssl.TLSVersion.TLSv1_2,
+        pytest.param(
+            ssl.TLSVersion.TLSv1_3,
+            marks=pytest.mark.skipif(not ssl.HAS_TLSv1_3, reason="requires TLSv1.3"),
+        ),
+    ],
+)
+def test_tcp_ssl_connect(tcp_address, ssl_min_version):
     host, port = tcp_address
     certfile = get_ssl_filename("server-cert.pem")
     keyfile = get_ssl_filename("server-key.pem")
@@ -55,19 +66,42 @@ def test_tcp_ssl_connect(tcp_address):
         client_name=_CLIENT_NAME,
         ssl_ca_certs=certfile,
         socket_timeout=10,
+        ssl_min_version=ssl_min_version,
     )
     _assert_connect(conn, tcp_address, certfile=certfile, keyfile=keyfile)
 
 
-def _assert_connect(conn, server_address, certfile=None, keyfile=None):
+@pytest.mark.ssl
+@pytest.mark.skipif(not ssl.HAS_TLSv1_3, reason="requires TLSv1.3")
+def test_tcp_ssl_version_mismatch(tcp_address):
+    host, port = tcp_address
+    certfile = get_ssl_filename("server-cert.pem")
+    keyfile = get_ssl_filename("server-key.pem")
+    conn = SSLConnection(
+        host=host,
+        port=port,
+        client_name=_CLIENT_NAME,
+        ssl_ca_certs=certfile,
+        socket_timeout=10,
+        ssl_min_version=ssl.TLSVersion.TLSv1_3,
+    )
+    with pytest.raises(ConnectionError):
+        _assert_connect(
+            conn,
+            tcp_address,
+            certfile=certfile,
+            keyfile=keyfile,
+            ssl_version=ssl.PROTOCOL_TLSv1_2,
+        )
+
+
+def _assert_connect(conn, server_address, **tcp_kw):
     if isinstance(server_address, str):
         if not _RedisUDSServer:
             pytest.skip("Unix domain sockets are not supported on this platform")
         server = _RedisUDSServer(server_address, _RedisRequestHandler)
     else:
-        server = _RedisTCPServer(
-            server_address, _RedisRequestHandler, certfile=certfile, keyfile=keyfile
-        )
+        server = _RedisTCPServer(server_address, _RedisRequestHandler, **tcp_kw)
     with server as aserver:
         t = threading.Thread(target=aserver.serve_forever)
         t.start()
@@ -81,11 +115,19 @@ def _assert_connect(conn, server_address, certfile=None, keyfile=None):
 
 
 class _RedisTCPServer(socketserver.TCPServer):
-    def __init__(self, *args, certfile=None, keyfile=None, **kw) -> None:
+    def __init__(
+        self,
+        *args,
+        certfile=None,
+        keyfile=None,
+        ssl_version=ssl.PROTOCOL_TLS,
+        **kw,
+    ) -> None:
         self._ready_event = threading.Event()
         self._stop_requested = False
         self._certfile = certfile
         self._keyfile = keyfile
+        self._ssl_version = ssl_version
         super().__init__(*args, **kw)
 
     def service_actions(self):
@@ -110,7 +152,7 @@ def get_request(self):
             server_side=True,
             certfile=self._certfile,
             keyfile=self._keyfile,
-            ssl_version=ssl.PROTOCOL_TLSv1_2,
+            ssl_version=self._ssl_version,
         )
         return connstream, fromaddr
 

From 6240ea1e46bf5c8d79862c5eac30d48ff1f9a62e Mon Sep 17 00:00:00 2001
From: Qiangning Hong <hongqn@gmail.com>
Date: Mon, 5 Feb 2024 22:18:18 +0800
Subject: [PATCH 0849/1164] docs: Add timeout parameter for get_message example
 (#3129)

The `get_message()` method in asyncio PubSub has a `timeout` argument that defaults to 0.0, causing it to immediately return. This can cause high CPU usage with the given code example and should not be recommended. By setting `timeout=None`, it works with much more efficient resource usage.
---
 docs/examples/asyncio_examples.ipynb | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/examples/asyncio_examples.ipynb b/docs/examples/asyncio_examples.ipynb
index 5eab4db1f7..5029e907da 100644
--- a/docs/examples/asyncio_examples.ipynb
+++ b/docs/examples/asyncio_examples.ipynb
@@ -201,7 +201,7 @@
     "\n",
     "async def reader(channel: redis.client.PubSub):\n",
     "    while True:\n",
-    "        message = await channel.get_message(ignore_subscribe_messages=True)\n",
+    "        message = await channel.get_message(ignore_subscribe_messages=True, timeout=None)\n",
     "        if message is not None:\n",
     "            print(f\"(Reader) Message Received: {message}\")\n",
     "            if message[\"data\"].decode() == STOPWORD:\n",
@@ -264,7 +264,7 @@
     "\n",
     "async def reader(channel: redis.client.PubSub):\n",
     "    while True:\n",
-    "        message = await channel.get_message(ignore_subscribe_messages=True)\n",
+    "        message = await channel.get_message(ignore_subscribe_messages=True, timeout=None)\n",
     "        if message is not None:\n",
     "            print(f\"(Reader) Message Received: {message}\")\n",
     "            if message[\"data\"].decode() == STOPWORD:\n",

From 6b89786a2957025b2540700baed7878943a7d401 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Mon, 12 Feb 2024 18:30:42 +0200
Subject: [PATCH 0850/1164] Revert stale isuue version update (#3142)

---
 .github/workflows/stale-issues.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/stale-issues.yml b/.github/workflows/stale-issues.yml
index 445af1c818..32fd9e8179 100644
--- a/.github/workflows/stale-issues.yml
+++ b/.github/workflows/stale-issues.yml
@@ -12,7 +12,7 @@ jobs:
 
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/stale@v9
+    - uses: actions/stale@v3
       with:
         repo-token: ${{ secrets.GITHUB_TOKEN }}
         stale-issue-message: 'This issue is marked stale. It will be closed in 30 days if it is not updated.'

From 4099d5e0e3a15c377a10754ed6a376f3a6c20676 Mon Sep 17 00:00:00 2001
From: wKollendorf <83725977+wKollendorf@users.noreply.github.com>
Date: Mon, 19 Feb 2024 10:48:42 +0100
Subject: [PATCH 0851/1164] Update connection.py (#3149)

Exception ignored in: <function Redis.__del__ at ...>
Traceback ....
TypeError: 'NoneType' object cannot be interpreted as an integer.

This happens when closing the connection within a spawned Process (multiprocess).
---
 redis/connection.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/connection.py b/redis/connection.py
index c9f7fc55d0..617d04af5c 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -451,7 +451,7 @@ def disconnect(self, *args):
         if os.getpid() == self.pid:
             try:
                 conn_sock.shutdown(socket.SHUT_RDWR)
-            except OSError:
+            except (OSError, TypeError):
                 pass
 
         try:

From 2b2a2e0bfe34584c6d8728ba5d03b70648b47f36 Mon Sep 17 00:00:00 2001
From: Aarni Koskela <akx@iki.fi>
Date: Mon, 19 Feb 2024 11:49:18 +0200
Subject: [PATCH 0852/1164] Remove typing-extensions from deps (#3146)

It's not used, and this library requires Python 3.8+.
---
 requirements.txt | 1 -
 setup.py         | 1 -
 2 files changed, 2 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index 82c46c92c6..a716b84463 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,2 +1 @@
 async-timeout>=4.0.2
-typing-extensions; python_version<"3.8"
diff --git a/setup.py b/setup.py
index aca2244218..c6a9e205f5 100644
--- a/setup.py
+++ b/setup.py
@@ -36,7 +36,6 @@
     author_email="oss@redis.com",
     python_requires=">=3.8",
     install_requires=[
-        'typing-extensions; python_version<"3.8"',
         'async-timeout>=4.0.3',
     ],
     classifiers=[

From ebb6171832f284d61df4fe3afa0a23af88fbf9b6 Mon Sep 17 00:00:00 2001
From: Will Miller <w-miller@users.noreply.github.com>
Date: Mon, 19 Feb 2024 10:32:01 +0000
Subject: [PATCH 0853/1164] Fix retry logic for pubsub and pipeline (#3134)

* Fix retry logic for pubsub and pipeline

Extend the fix from bea72995fd39b01e2f0a1682b16b6c7690933f36 to apply to
pipeline and pubsub as well.

Fixes #2973

* fix isort

---------

Co-authored-by: dvora-h <67596500+dvora-h@users.noreply.github.com>
---
 redis/asyncio/client.py | 36 ++++++++++++++++++-----------
 redis/client.py         | 50 ++++++++++++++++++++++++++++-------------
 2 files changed, 57 insertions(+), 29 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 62bdc7dd5c..3e2912bfca 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -927,11 +927,15 @@ async def connect(self):
     async def _disconnect_raise_connect(self, conn, error):
         """
         Close the connection and raise an exception
-        if retry_on_timeout is not set or the error
-        is not a TimeoutError. Otherwise, try to reconnect
+        if retry_on_error is not set or the error is not one
+        of the specified error types. Otherwise, try to
+        reconnect
         """
         await conn.disconnect()
-        if not (conn.retry_on_timeout and isinstance(error, TimeoutError)):
+        if (
+            conn.retry_on_error is None
+            or isinstance(error, tuple(conn.retry_on_error)) is False
+        ):
             raise error
         await conn.connect()
 
@@ -1344,8 +1348,8 @@ async def _disconnect_reset_raise(self, conn, error):
         """
         Close the connection, reset watching state and
         raise an exception if we were watching,
-        retry_on_timeout is not set,
-        or the error is not a TimeoutError
+        if retry_on_error is not set or the error is not one
+        of the specified error types.
         """
         await conn.disconnect()
         # if we were already watching a variable, the watch is no longer
@@ -1356,9 +1360,12 @@ async def _disconnect_reset_raise(self, conn, error):
             raise WatchError(
                 "A ConnectionError occurred on while watching one or more keys"
             )
-        # if retry_on_timeout is not set, or the error is not
-        # a TimeoutError, raise it
-        if not (conn.retry_on_timeout and isinstance(error, TimeoutError)):
+        # if retry_on_error is not set or the error is not one
+        # of the specified error types, raise it
+        if (
+            conn.retry_on_error is None
+            or isinstance(error, tuple(conn.retry_on_error)) is False
+        ):
             await self.aclose()
             raise
 
@@ -1533,8 +1540,8 @@ async def load_scripts(self):
     async def _disconnect_raise_reset(self, conn: Connection, error: Exception):
         """
         Close the connection, raise an exception if we were watching,
-        and raise an exception if retry_on_timeout is not set,
-        or the error is not a TimeoutError
+        and raise an exception if retry_on_error is not set or the
+        error is not one of the specified error types.
         """
         await conn.disconnect()
         # if we were watching a variable, the watch is no longer valid
@@ -1544,9 +1551,12 @@ async def _disconnect_raise_reset(self, conn: Connection, error: Exception):
             raise WatchError(
                 "A ConnectionError occurred on while watching one or more keys"
             )
-        # if retry_on_timeout is not set, or the error is not
-        # a TimeoutError, raise it
-        if not (conn.retry_on_timeout and isinstance(error, TimeoutError)):
+        # if retry_on_error is not set or the error is not one
+        # of the specified error types, raise it
+        if (
+            conn.retry_on_error is None
+            or isinstance(error, tuple(conn.retry_on_error)) is False
+        ):
             await self.reset()
             raise
 
diff --git a/redis/client.py b/redis/client.py
index 1209a978d2..85ed7380a8 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -25,7 +25,12 @@
     SentinelCommands,
     list_or_args,
 )
-from redis.connection import ConnectionPool, SSLConnection, UnixDomainSocketConnection
+from redis.connection import (
+    AbstractConnection,
+    ConnectionPool,
+    SSLConnection,
+    UnixDomainSocketConnection,
+)
 from redis.credentials import CredentialProvider
 from redis.exceptions import (
     ConnectionError,
@@ -839,11 +844,15 @@ def clean_health_check_responses(self) -> None:
     def _disconnect_raise_connect(self, conn, error) -> None:
         """
         Close the connection and raise an exception
-        if retry_on_timeout is not set or the error
-        is not a TimeoutError. Otherwise, try to reconnect
+        if retry_on_error is not set or the error is not one
+        of the specified error types. Otherwise, try to
+        reconnect
         """
         conn.disconnect()
-        if not (conn.retry_on_timeout and isinstance(error, TimeoutError)):
+        if (
+            conn.retry_on_error is None
+            or isinstance(error, tuple(conn.retry_on_error)) is False
+        ):
             raise error
         conn.connect()
 
@@ -1320,8 +1329,8 @@ def _disconnect_reset_raise(self, conn, error) -> None:
         """
         Close the connection, reset watching state and
         raise an exception if we were watching,
-        retry_on_timeout is not set,
-        or the error is not a TimeoutError
+        if retry_on_error is not set or the error is not one
+        of the specified error types.
         """
         conn.disconnect()
         # if we were already watching a variable, the watch is no longer
@@ -1332,9 +1341,12 @@ def _disconnect_reset_raise(self, conn, error) -> None:
             raise WatchError(
                 "A ConnectionError occurred on while watching one or more keys"
             )
-        # if retry_on_timeout is not set, or the error is not
-        # a TimeoutError, raise it
-        if not (conn.retry_on_timeout and isinstance(error, TimeoutError)):
+        # if retry_on_error is not set or the error is not one
+        # of the specified error types, raise it
+        if (
+            conn.retry_on_error is None
+            or isinstance(error, tuple(conn.retry_on_error)) is False
+        ):
             self.reset()
             raise
 
@@ -1492,11 +1504,15 @@ def load_scripts(self):
                 if not exist:
                     s.sha = immediate("SCRIPT LOAD", s.script)
 
-    def _disconnect_raise_reset(self, conn: Redis, error: Exception) -> None:
+    def _disconnect_raise_reset(
+        self,
+        conn: AbstractConnection,
+        error: Exception,
+    ) -> None:
         """
         Close the connection, raise an exception if we were watching,
-        and raise an exception if TimeoutError is not part of retry_on_error,
-        or the error is not a TimeoutError
+        and raise an exception if retry_on_error is not set or the
+        error is not one of the specified error types.
         """
         conn.disconnect()
         # if we were watching a variable, the watch is no longer valid
@@ -1506,11 +1522,13 @@ def _disconnect_raise_reset(self, conn: Redis, error: Exception) -> None:
             raise WatchError(
                 "A ConnectionError occurred on while watching one or more keys"
             )
-        # if TimeoutError is not part of retry_on_error, or the error
-        # is not a TimeoutError, raise it
-        if not (
-            TimeoutError in conn.retry_on_error and isinstance(error, TimeoutError)
+        # if retry_on_error is not set or the error is not one
+        # of the specified error types, raise it
+        if (
+            conn.retry_on_error is None
+            or isinstance(error, tuple(conn.retry_on_error)) is False
         ):
+
             self.reset()
             raise error
 

From d529c2ad8d2cf4dcfb41bfd93ea68cfefd81aa66 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristj=C3=A1n=20Valur=20J=C3=B3nsson?= <sweskman@gmail.com>
Date: Thu, 22 Feb 2024 12:48:00 +0000
Subject: [PATCH 0854/1164] Fix incorrect asserts in test and ensure
 connections are closed (#3004)

---
 tests/test_ssl.py | 31 +++++++++++++++++++++----------
 1 file changed, 21 insertions(+), 10 deletions(-)

diff --git a/tests/test_ssl.py b/tests/test_ssl.py
index 465fdabb89..dfd8837262 100644
--- a/tests/test_ssl.py
+++ b/tests/test_ssl.py
@@ -26,13 +26,15 @@ def test_ssl_with_invalid_cert(self, request):
         sslclient = redis.from_url(ssl_url)
         with pytest.raises(ConnectionError) as e:
             sslclient.ping()
-            assert "SSL: CERTIFICATE_VERIFY_FAILED" in str(e)
+        assert "SSL: CERTIFICATE_VERIFY_FAILED" in str(e)
+        sslclient.close()
 
     def test_ssl_connection(self, request):
         ssl_url = request.config.option.redis_ssl_url
         p = urlparse(ssl_url)[1].split(":")
         r = redis.Redis(host=p[0], port=p[1], ssl=True, ssl_cert_reqs="none")
         assert r.ping()
+        r.close()
 
     def test_ssl_connection_without_ssl(self, request):
         ssl_url = request.config.option.redis_ssl_url
@@ -41,7 +43,8 @@ def test_ssl_connection_without_ssl(self, request):
 
         with pytest.raises(ConnectionError) as e:
             r.ping()
-            assert "Connection closed by server" in str(e)
+        assert "Connection closed by server" in str(e)
+        r.close()
 
     def test_validating_self_signed_certificate(self, request):
         ssl_url = request.config.option.redis_ssl_url
@@ -56,6 +59,7 @@ def test_validating_self_signed_certificate(self, request):
             ssl_ca_certs=self.SERVER_CERT,
         )
         assert r.ping()
+        r.close()
 
     def test_validating_self_signed_string_certificate(self, request):
         with open(self.SERVER_CERT) as f:
@@ -72,6 +76,7 @@ def test_validating_self_signed_string_certificate(self, request):
             ssl_ca_data=cert_data,
         )
         assert r.ping()
+        r.close()
 
     def _create_oscp_conn(self, request):
         ssl_url = request.config.option.redis_ssl_url
@@ -92,22 +97,25 @@ def _create_oscp_conn(self, request):
     def test_ssl_ocsp_called(self, request):
         r = self._create_oscp_conn(request)
         with pytest.raises(RedisError) as e:
-            assert r.ping()
-            assert "cryptography not installed" in str(e)
+            r.ping()
+        assert "cryptography is not installed" in str(e)
+        r.close()
 
     @skip_if_nocryptography()
     def test_ssl_ocsp_called_withcrypto(self, request):
         r = self._create_oscp_conn(request)
         with pytest.raises(ConnectionError) as e:
             assert r.ping()
-            assert "No AIA information present in ssl certificate" in str(e)
+        assert "No AIA information present in ssl certificate" in str(e)
+        r.close()
 
         # rediss://, url based
         ssl_url = request.config.option.redis_ssl_url
         sslclient = redis.from_url(ssl_url)
         with pytest.raises(ConnectionError) as e:
             sslclient.ping()
-            assert "No AIA information present in ssl certificate" in str(e)
+        assert "No AIA information present in ssl certificate" in str(e)
+        sslclient.close()
 
     @skip_if_nocryptography()
     def test_valid_ocsp_cert_http(self):
@@ -132,7 +140,7 @@ def test_revoked_ocsp_certificate(self):
                 ocsp = OCSPVerifier(wrapped, hostname, 443)
                 with pytest.raises(ConnectionError) as e:
                     assert ocsp.is_valid()
-                    assert "REVOKED" in str(e)
+                assert "REVOKED" in str(e)
 
     @skip_if_nocryptography()
     def test_unauthorized_ocsp(self):
@@ -157,7 +165,7 @@ def test_ocsp_not_present_in_response(self):
                 ocsp = OCSPVerifier(wrapped, hostname, 443)
                 with pytest.raises(ConnectionError) as e:
                     assert ocsp.is_valid()
-                    assert "from the" in str(e)
+                assert "from the" in str(e)
 
     @skip_if_nocryptography()
     def test_unauthorized_then_direct(self):
@@ -193,6 +201,7 @@ def test_mock_ocsp_staple(self, request):
 
         with pytest.raises(RedisError):
             r.ping()
+        r.close()
 
         ctx = OpenSSL.SSL.Context(OpenSSL.SSL.SSLv23_METHOD)
         ctx.use_certificate_file(self.SERVER_CERT)
@@ -213,7 +222,8 @@ def test_mock_ocsp_staple(self, request):
 
         with pytest.raises(ConnectionError) as e:
             r.ping()
-            assert "no ocsp response present" in str(e)
+        assert "no ocsp response present" in str(e)
+        r.close()
 
         r = redis.Redis(
             host=p[0],
@@ -228,4 +238,5 @@ def test_mock_ocsp_staple(self, request):
 
         with pytest.raises(ConnectionError) as e:
             r.ping()
-            assert "no ocsp response present" in str(e)
+        assert "no ocsp response present" in str(e)
+        r.close()

From c573bc4ab61d0d57726f872fdfca31962d44b534 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 28 Feb 2024 14:31:59 +0200
Subject: [PATCH 0855/1164] Fix bug: client side caching causes unexpected
 disconnections (#3160)

* fix disconnects

* skip test in cluster

---------

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/_parsers/resp3.py |  4 +++-
 redis/client.py         | 14 +++++++-------
 redis/commands/core.py  |  2 +-
 redis/connection.py     | 17 +++++++---------
 tests/test_cache.py     | 43 +++++++++++++++++++++++++++++++++++++++++
 5 files changed, 61 insertions(+), 19 deletions(-)

diff --git a/redis/_parsers/resp3.py b/redis/_parsers/resp3.py
index 13aa1ffccb..88c8d5e52b 100644
--- a/redis/_parsers/resp3.py
+++ b/redis/_parsers/resp3.py
@@ -117,7 +117,9 @@ def _read_response(self, disable_decoding=False, push_request=False):
                 )
                 for _ in range(int(response))
             ]
-            self.handle_push_response(response, disable_decoding, push_request)
+            response = self.handle_push_response(
+                response, disable_decoding, push_request
+            )
         else:
             raise InvalidResponse(f"Protocol Error: {raw!r}")
 
diff --git a/redis/client.py b/redis/client.py
index 85ed7380a8..79f52cc989 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -563,10 +563,10 @@ def execute_command(self, *args, **options):
         pool = self.connection_pool
         conn = self.connection or pool.get_connection(command_name, **options)
         response_from_cache = conn._get_from_local_cache(args)
-        if response_from_cache is not None:
-            return response_from_cache
-        else:
-            try:
+        try:
+            if response_from_cache is not None:
+                return response_from_cache
+            else:
                 response = conn.retry.call_with_retry(
                     lambda: self._send_command_parse_response(
                         conn, command_name, *args, **options
@@ -575,9 +575,9 @@ def execute_command(self, *args, **options):
                 )
                 conn._add_to_local_cache(args, response, keys)
                 return response
-            finally:
-                if not self.connection:
-                    pool.release(conn)
+        finally:
+            if not self.connection:
+                pool.release(conn)
 
     def parse_response(self, connection, command_name, **options):
         """Parses a response from the Redis server"""
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 6d81d76035..464e8d8c85 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -2011,7 +2011,7 @@ def mget(self, keys: KeysT, *args: EncodableT) -> ResponseT:
         options = {}
         if not args:
             options[EMPTY_RESPONSE] = []
-        options["keys"] = keys
+        options["keys"] = args
         return self.execute_command("MGET", *args, **options)
 
     def mset(self, mapping: Mapping[AnyKeyT, EncodableT]) -> ResponseT:
diff --git a/redis/connection.py b/redis/connection.py
index 617d04af5c..b89ce0e94b 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1,6 +1,5 @@
 import copy
 import os
-import select
 import socket
 import ssl
 import sys
@@ -609,11 +608,6 @@ def pack_commands(self, commands):
             output.append(SYM_EMPTY.join(pieces))
         return output
 
-    def _socket_is_empty(self):
-        """Check if the socket is empty"""
-        r, _, _ = select.select([self._sock], [], [], 0)
-        return not bool(r)
-
     def _cache_invalidation_process(
         self, data: List[Union[str, Optional[List[str]]]]
     ) -> None:
@@ -639,7 +633,7 @@ def _get_from_local_cache(self, command: str):
             or command[0] not in self.cache_whitelist
         ):
             return None
-        while not self._socket_is_empty():
+        while self.can_read():
             self.read_response(push_request=True)
         return self.client_cache.get(command)
 
@@ -1187,12 +1181,15 @@ def get_connection(self, command_name: str, *keys, **options) -> "Connection":
         try:
             # ensure this connection is connected to Redis
             connection.connect()
-            # connections that the pool provides should be ready to send
-            # a command. if not, the connection was either returned to the
+            # if client caching is not enabled connections that the pool
+            # provides should be ready to send a command.
+            # if not, the connection was either returned to the
             # pool before all data has been read or the socket has been
             # closed. either way, reconnect and verify everything is good.
+            # (if caching enabled the connection will not always be ready
+            # to send a command because it may contain invalidation messages)
             try:
-                if connection.can_read():
+                if connection.can_read() and connection.client_cache is None:
                     raise ConnectionError("Connection has data")
             except (ConnectionError, OSError):
                 connection.disconnect()
diff --git a/tests/test_cache.py b/tests/test_cache.py
index 4eb5160ecc..dd33afd23e 100644
--- a/tests/test_cache.py
+++ b/tests/test_cache.py
@@ -146,6 +146,49 @@ def test_cache_return_copy(self, r):
         check = cache.get(("LRANGE", "mylist", 0, -1))
         assert check == [b"baz", b"bar", b"foo"]
 
+    @pytest.mark.onlynoncluster
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    def test_csc_not_cause_disconnects(self, r):
+        r, cache = r
+        id1 = r.client_id()
+        r.mset({"a": 1, "b": 1, "c": 1, "d": 1, "e": 1, "f": 1})
+        assert r.mget("a", "b", "c", "d", "e", "f") == ["1", "1", "1", "1", "1", "1"]
+        id2 = r.client_id()
+
+        # client should get value from client cache
+        assert r.mget("a", "b", "c", "d", "e", "f") == ["1", "1", "1", "1", "1", "1"]
+        assert cache.get(("MGET", "a", "b", "c", "d", "e", "f")) == [
+            "1",
+            "1",
+            "1",
+            "1",
+            "1",
+            "1",
+        ]
+
+        r.mset({"a": 2, "b": 2, "c": 2, "d": 2, "e": 2, "f": 2})
+        id3 = r.client_id()
+        # client should get value from redis server post invalidate messages
+        assert r.mget("a", "b", "c", "d", "e", "f") == ["2", "2", "2", "2", "2", "2"]
+
+        r.mset({"a": 3, "b": 3, "c": 3, "d": 3, "e": 3, "f": 3})
+        # need to check that we get correct value 3 and not 2
+        assert r.mget("a", "b", "c", "d", "e", "f") == ["3", "3", "3", "3", "3", "3"]
+        # client should get value from client cache
+        assert r.mget("a", "b", "c", "d", "e", "f") == ["3", "3", "3", "3", "3", "3"]
+
+        r.mset({"a": 4, "b": 4, "c": 4, "d": 4, "e": 4, "f": 4})
+        # need to check that we get correct value 4 and not 3
+        assert r.mget("a", "b", "c", "d", "e", "f") == ["4", "4", "4", "4", "4", "4"]
+        # client should get value from client cache
+        assert r.mget("a", "b", "c", "d", "e", "f") == ["4", "4", "4", "4", "4", "4"]
+        id4 = r.client_id()
+        assert id1 == id2 == id3 == id4
+
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 @pytest.mark.onlycluster

From 26ab964ec18ec255672abaec90de439705151b5c Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 29 Feb 2024 11:59:31 +0200
Subject: [PATCH 0856/1164] Fix bug: client side caching causes unexpected
 disconnections (async version) (#3165)

* fix disconnects

* skip test in cluster

* add test

* save return value from handle_push_response (without it 'read_response' return the push message)

* insert return response from cache to the try block to prevent connection leak

* enable to get connection with data avaliable to read in csc mode and change can_read_destructive to not read data

* fix check if socket is empty (at_eof() can return False but this doesn't mean there's definitely more data to read)

---------

Co-authored-by: Chayim <chayim@users.noreply.github.com>
---
 redis/_parsers/base.py           |  2 +-
 redis/_parsers/resp3.py          |  4 ++-
 redis/asyncio/client.py          | 40 +++++++++++++++---------------
 redis/asyncio/connection.py      | 14 ++++++++---
 tests/test_asyncio/test_cache.py | 42 ++++++++++++++++++++++++++++++++
 5 files changed, 77 insertions(+), 25 deletions(-)

diff --git a/redis/_parsers/base.py b/redis/_parsers/base.py
index 8e59249bef..0137539d66 100644
--- a/redis/_parsers/base.py
+++ b/redis/_parsers/base.py
@@ -182,7 +182,7 @@ async def can_read_destructive(self) -> bool:
             return True
         try:
             async with async_timeout(0):
-                return await self._stream.read(1)
+                return self._stream.at_eof()
         except TimeoutError:
             return False
 
diff --git a/redis/_parsers/resp3.py b/redis/_parsers/resp3.py
index 88c8d5e52b..7afa43a0c2 100644
--- a/redis/_parsers/resp3.py
+++ b/redis/_parsers/resp3.py
@@ -261,7 +261,9 @@ async def _read_response(
                 )
                 for _ in range(int(response))
             ]
-            await self.handle_push_response(response, disable_decoding, push_request)
+            response = await self.handle_push_response(
+                response, disable_decoding, push_request
+            )
         else:
             raise InvalidResponse(f"Protocol Error: {raw!r}")
 
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 3e2912bfca..9ff2e3917f 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -629,25 +629,27 @@ async def execute_command(self, *args, **options):
         pool = self.connection_pool
         conn = self.connection or await pool.get_connection(command_name, **options)
         response_from_cache = await conn._get_from_local_cache(args)
-        if response_from_cache is not None:
-            return response_from_cache
-        else:
-            if self.single_connection_client:
-                await self._single_conn_lock.acquire()
-            try:
-                response = await conn.retry.call_with_retry(
-                    lambda: self._send_command_parse_response(
-                        conn, command_name, *args, **options
-                    ),
-                    lambda error: self._disconnect_raise(conn, error),
-                )
-                conn._add_to_local_cache(args, response, keys)
-                return response
-            finally:
-                if self.single_connection_client:
-                    self._single_conn_lock.release()
-                if not self.connection:
-                    await pool.release(conn)
+        try:
+            if response_from_cache is not None:
+                return response_from_cache
+            else:
+                try:
+                    if self.single_connection_client:
+                        await self._single_conn_lock.acquire()
+                    response = await conn.retry.call_with_retry(
+                        lambda: self._send_command_parse_response(
+                            conn, command_name, *args, **options
+                        ),
+                        lambda error: self._disconnect_raise(conn, error),
+                    )
+                    conn._add_to_local_cache(args, response, keys)
+                    return response
+                finally:
+                    if self.single_connection_client:
+                        self._single_conn_lock.release()
+        finally:
+            if not self.connection:
+                await pool.release(conn)
 
     async def parse_response(
         self, connection: Connection, command_name: Union[str, bytes], **options
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 81df3b3543..6c5c58c683 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -685,7 +685,7 @@ def pack_commands(self, commands: Iterable[Iterable[EncodableT]]) -> List[bytes]
 
     def _socket_is_empty(self):
         """Check if the socket is empty"""
-        return not self._reader.at_eof()
+        return len(self._reader._buffer) == 0
 
     def _cache_invalidation_process(
         self, data: List[Union[str, Optional[List[str]]]]
@@ -1192,12 +1192,18 @@ def make_connection(self):
     async def ensure_connection(self, connection: AbstractConnection):
         """Ensure that the connection object is connected and valid"""
         await connection.connect()
-        # connections that the pool provides should be ready to send
-        # a command. if not, the connection was either returned to the
+        # if client caching is not enabled connections that the pool
+        # provides should be ready to send a command.
+        # if not, the connection was either returned to the
         # pool before all data has been read or the socket has been
         # closed. either way, reconnect and verify everything is good.
+        # (if caching enabled the connection will not always be ready
+        # to send a command because it may contain invalidation messages)
         try:
-            if await connection.can_read_destructive():
+            if (
+                await connection.can_read_destructive()
+                and connection.client_cache is None
+            ):
                 raise ConnectionError("Connection has data") from None
         except (ConnectionError, OSError):
             await connection.disconnect()
diff --git a/tests/test_asyncio/test_cache.py b/tests/test_asyncio/test_cache.py
index bf20337dfb..4762bb7c05 100644
--- a/tests/test_asyncio/test_cache.py
+++ b/tests/test_asyncio/test_cache.py
@@ -142,6 +142,48 @@ async def test_cache_return_copy(self, r):
         check = cache.get(("LRANGE", "mylist", 0, -1))
         assert check == [b"baz", b"bar", b"foo"]
 
+    @pytest.mark.onlynoncluster
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    async def test_csc_not_cause_disconnects(self, r):
+        r, cache = r
+        id1 = await r.client_id()
+        await r.mset({"a": 1, "b": 1, "c": 1, "d": 1, "e": 1})
+        assert await r.mget("a", "b", "c", "d", "e") == ["1", "1", "1", "1", "1"]
+        id2 = await r.client_id()
+
+        # client should get value from client cache
+        assert await r.mget("a", "b", "c", "d", "e") == ["1", "1", "1", "1", "1"]
+        assert cache.get(("MGET", "a", "b", "c", "d", "e")) == [
+            "1",
+            "1",
+            "1",
+            "1",
+            "1",
+        ]
+
+        await r.mset({"a": 2, "b": 2, "c": 2, "d": 2, "e": 2})
+        id3 = await r.client_id()
+        # client should get value from redis server post invalidate messages
+        assert await r.mget("a", "b", "c", "d", "e") == ["2", "2", "2", "2", "2"]
+
+        await r.mset({"a": 3, "b": 3, "c": 3, "d": 3, "e": 3})
+        # need to check that we get correct value 3 and not 2
+        assert await r.mget("a", "b", "c", "d", "e") == ["3", "3", "3", "3", "3"]
+        # client should get value from client cache
+        assert await r.mget("a", "b", "c", "d", "e") == ["3", "3", "3", "3", "3"]
+
+        await r.mset({"a": 4, "b": 4, "c": 4, "d": 4, "e": 4})
+        # need to check that we get correct value 4 and not 3
+        assert await r.mget("a", "b", "c", "d", "e") == ["4", "4", "4", "4", "4"]
+        # client should get value from client cache
+        assert await r.mget("a", "b", "c", "d", "e") == ["4", "4", "4", "4", "4"]
+        id4 = await r.client_id()
+        assert id1 == id2 == id3 == id4
+
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 @pytest.mark.onlycluster

From 9df2225ba6309d50742959328958755210d757bd Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 29 Feb 2024 13:07:37 +0200
Subject: [PATCH 0857/1164] Version 5.1.0b4 (#3166)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index c6a9e205f5..68bfc25c42 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="5.1.0b3",
+    version="5.1.0b4",
     packages=find_packages(
         include=[
             "redis",

From 9ad1546c06bb7321e7e19bbb9c8dd758343c0390 Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Thu, 7 Mar 2024 15:12:48 +0200
Subject: [PATCH 0858/1164] Fix lock error (#3176)

---
 redis/exceptions.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/exceptions.py b/redis/exceptions.py
index ddb4041da3..8af58cb0db 100644
--- a/redis/exceptions.py
+++ b/redis/exceptions.py
@@ -82,7 +82,7 @@ class LockError(RedisError, ValueError):
     # NOTE: For backwards compatibility, this class derives from ValueError.
     # This was originally chosen to behave like threading.Lock.
 
-    def __init__(self, message, lock_name=None):
+    def __init__(self, message=None, lock_name=None):
         self.message = message
         self.lock_name = lock_name
 

From 22957070f72615bae090a6550143a1f091efdae1 Mon Sep 17 00:00:00 2001
From: Kamil Monicz <kamil@monicz.dev>
Date: Sun, 10 Mar 2024 10:41:06 +0100
Subject: [PATCH 0859/1164] Remove redundant async-timeout dependency in modern
 Python (#3177)

https://github.com/redis/redis-py/issues/3174
---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 68bfc25c42..1098e115c6 100644
--- a/setup.py
+++ b/setup.py
@@ -36,7 +36,7 @@
     author_email="oss@redis.com",
     python_requires=">=3.8",
     install_requires=[
-        'async-timeout>=4.0.3',
+        'async-timeout>=4.0.3; python_full_version<"3.11.3"',
     ],
     classifiers=[
         "Development Status :: 5 - Production/Stable",

From 0a0321523078ee514801a47bd83b7fe5a5ba198e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 10 Mar 2024 11:41:34 +0200
Subject: [PATCH 0860/1164] Bump rojopolis/spellcheck-github-actions from
 0.35.0 to 0.36.0 (#3172)

Bumps [rojopolis/spellcheck-github-actions](https://github.com/rojopolis/spellcheck-github-actions) from 0.35.0 to 0.36.0.
- [Release notes](https://github.com/rojopolis/spellcheck-github-actions/releases)
- [Changelog](https://github.com/rojopolis/spellcheck-github-actions/blob/master/CHANGELOG.md)
- [Commits](https://github.com/rojopolis/spellcheck-github-actions/compare/0.35.0...0.36.0)

---
updated-dependencies:
- dependency-name: rojopolis/spellcheck-github-actions
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/spellcheck.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/spellcheck.yml b/.github/workflows/spellcheck.yml
index a48781aa84..f739a54242 100644
--- a/.github/workflows/spellcheck.yml
+++ b/.github/workflows/spellcheck.yml
@@ -8,7 +8,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
       - name: Check Spelling
-        uses: rojopolis/spellcheck-github-actions@0.35.0
+        uses: rojopolis/spellcheck-github-actions@0.36.0
         with:
           config_path: .github/spellcheck-settings.yml
           task_name: Markdown

From 4f8dfae5aa58fc6ddc9e75f82877f5e23d69de24 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 10 Mar 2024 12:32:12 +0200
Subject: [PATCH 0861/1164] Bump release-drafter/release-drafter from 5 to 6
 (#3171)

Bumps [release-drafter/release-drafter](https://github.com/release-drafter/release-drafter) from 5 to 6.
- [Release notes](https://github.com/release-drafter/release-drafter/releases)
- [Commits](https://github.com/release-drafter/release-drafter/compare/v5...v6)

---
updated-dependencies:
- dependency-name: release-drafter/release-drafter
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/release-drafter.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/release-drafter.yml b/.github/workflows/release-drafter.yml
index eebb3e678b..6695abfe4b 100644
--- a/.github/workflows/release-drafter.yml
+++ b/.github/workflows/release-drafter.yml
@@ -16,7 +16,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       # Drafts your next Release notes as Pull Requests are merged into "master"
-      - uses: release-drafter/release-drafter@v5
+      - uses: release-drafter/release-drafter@v6
         with:
           # (Optional) specify config name to use, relative to .github/. Default: release-drafter.yml
            config-name: release-drafter-config.yml

From ddff7b54b5db4ace94203dc141151b3f08060d2a Mon Sep 17 00:00:00 2001
From: Willian Moreira <willianmrs@gmail.com>
Date: Tue, 12 Mar 2024 08:14:25 -0300
Subject: [PATCH 0862/1164] Optimizing cluster initialization changing the
 checks for cluster-enabled flag (#3158)

* change if the cluster-mode is enabled by trying run CLUSTER SLOT insted of INFO

* fix typo

* fixing cluster mode is not enabled on this node tests

* remove changes on asyncio

* rename mock flag to be more consistent

* optimizing async cluster creation using CLUSTER SLOT command instead of INFO command

* fixing test. Before INFO and CLUSTER_SLOT was used for performing the connection, now only the CLUSTER_SLOT, so the total commands is minus 1

* remove dot at the end of string

* remove unecessary print from test

* fix lint problems

---------

Co-authored-by: Willian Moreira <willian.moreira@ifood.com.br>
---
 redis/asyncio/cluster.py           |  7 +++----
 redis/cluster.py                   |  5 +++--
 tests/test_asyncio/test_cluster.py | 20 ++++++++++++++------
 tests/test_cluster.py              | 16 ++++++++++++----
 4 files changed, 32 insertions(+), 16 deletions(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 4fb2fc4647..11c423b848 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -1253,13 +1253,12 @@ async def initialize(self) -> None:
         for startup_node in self.startup_nodes.values():
             try:
                 # Make sure cluster mode is enabled on this node
-                if not (await startup_node.execute_command("INFO")).get(
-                    "cluster_enabled"
-                ):
+                try:
+                    cluster_slots = await startup_node.execute_command("CLUSTER SLOTS")
+                except ResponseError:
                     raise RedisClusterException(
                         "Cluster mode is not enabled on this node"
                     )
-                cluster_slots = await startup_node.execute_command("CLUSTER SLOTS")
                 startup_nodes_reachable = True
             except Exception as e:
                 # Try the next startup node.
diff --git a/redis/cluster.py b/redis/cluster.py
index ba25b92246..a9213f4235 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -1525,11 +1525,12 @@ def initialize(self):
                     )
                     self.startup_nodes[startup_node.name].redis_connection = r
                 # Make sure cluster mode is enabled on this node
-                if bool(r.info().get("cluster_enabled")) is False:
+                try:
+                    cluster_slots = str_if_bytes(r.execute_command("CLUSTER SLOTS"))
+                except ResponseError:
                     raise RedisClusterException(
                         "Cluster mode is not enabled on this node"
                     )
-                cluster_slots = str_if_bytes(r.execute_command("CLUSTER SLOTS"))
                 startup_nodes_reachable = True
             except Exception as e:
                 # Try the next startup node.
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index a57d32f5d2..d7554b12a5 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -127,7 +127,9 @@ async def slowlog(r: RedisCluster) -> None:
     await r.config_set("slowlog-max-len", old_max_length_value)
 
 
-async def get_mocked_redis_client(*args, **kwargs) -> RedisCluster:
+async def get_mocked_redis_client(
+    cluster_slots_raise_error=False, *args, **kwargs
+) -> RedisCluster:
     """
     Return a stable RedisCluster object that have deterministic
     nodes and slots setup to remove the problem of different IP addresses
@@ -139,9 +141,13 @@ async def get_mocked_redis_client(*args, **kwargs) -> RedisCluster:
     with mock.patch.object(ClusterNode, "execute_command") as execute_command_mock:
 
         async def execute_command(*_args, **_kwargs):
+
             if _args[0] == "CLUSTER SLOTS":
-                mock_cluster_slots = cluster_slots
-                return mock_cluster_slots
+                if cluster_slots_raise_error:
+                    raise ResponseError()
+                else:
+                    mock_cluster_slots = cluster_slots
+                    return mock_cluster_slots
             elif _args[0] == "COMMAND":
                 return {"get": [], "set": []}
             elif _args[0] == "INFO":
@@ -2458,7 +2464,10 @@ async def test_init_slots_cache_cluster_mode_disabled(self) -> None:
         """
         with pytest.raises(RedisClusterException) as e:
             rc = await get_mocked_redis_client(
-                host=default_host, port=default_port, cluster_enabled=False
+                cluster_slots_raise_error=True,
+                host=default_host,
+                port=default_port,
+                cluster_enabled=False,
             )
             await rc.aclose()
         assert "Cluster mode is not enabled on this node" in str(e.value)
@@ -2719,10 +2728,9 @@ async def parse_response(
             async with r.pipeline() as pipe:
                 with pytest.raises(ClusterDownError):
                     await pipe.get(key).execute()
-
                 assert (
                     node.parse_response.await_count
-                    == 4 * r.cluster_error_retry_attempts - 3
+                    == 3 * r.cluster_error_retry_attempts - 2
                 )
 
     async def test_connection_error_not_raised(self, r: RedisCluster) -> None:
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 8a44d45ea3..1f505b816d 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -151,7 +151,9 @@ def cleanup():
     r.config_set("slowlog-max-len", 128)
 
 
-def get_mocked_redis_client(func=None, *args, **kwargs):
+def get_mocked_redis_client(
+    func=None, cluster_slots_raise_error=False, *args, **kwargs
+):
     """
     Return a stable RedisCluster object that have deterministic
     nodes and slots setup to remove the problem of different IP addresses
@@ -164,8 +166,11 @@ def get_mocked_redis_client(func=None, *args, **kwargs):
 
         def execute_command(*_args, **_kwargs):
             if _args[0] == "CLUSTER SLOTS":
-                mock_cluster_slots = cluster_slots
-                return mock_cluster_slots
+                if cluster_slots_raise_error:
+                    raise ResponseError()
+                else:
+                    mock_cluster_slots = cluster_slots
+                    return mock_cluster_slots
             elif _args[0] == "COMMAND":
                 return {"get": [], "set": []}
             elif _args[0] == "INFO":
@@ -2654,7 +2659,10 @@ def test_init_slots_cache_cluster_mode_disabled(self):
         """
         with pytest.raises(RedisClusterException) as e:
             get_mocked_redis_client(
-                host=default_host, port=default_port, cluster_enabled=False
+                cluster_slots_raise_error=True,
+                host=default_host,
+                port=default_port,
+                cluster_enabled=False,
             )
             assert "Cluster mode is not enabled on this node" in str(e.value)
 

From 5090875fe5ab84ea8142a28909a93d6ef35c784f Mon Sep 17 00:00:00 2001
From: Mathieu Rey <matrey@gmail.com>
Date: Thu, 14 Mar 2024 18:30:05 +0800
Subject: [PATCH 0863/1164] Update asyncio_examples.ipynb (#3125)

clarified wording + one case of deprecated .close() changed to .aclose()
---
 docs/examples/asyncio_examples.ipynb | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/examples/asyncio_examples.ipynb b/docs/examples/asyncio_examples.ipynb
index 5029e907da..d2b11b56be 100644
--- a/docs/examples/asyncio_examples.ipynb
+++ b/docs/examples/asyncio_examples.ipynb
@@ -15,7 +15,7 @@
     "\n",
     "## Connecting and Disconnecting\n",
     "\n",
-    "Utilizing asyncio Redis requires an explicit disconnect of the connection since there is no asyncio deconstructor magic method. By default, a connection pool is created on `redis.Redis()` and attached to this `Redis` instance. The connection pool closes automatically on the call to `Redis.aclose` which disconnects all connections."
+    "Using asyncio Redis requires an explicit disconnect of the connection since there is no asyncio deconstructor magic method. By default, an internal connection pool is created on `redis.Redis()` and attached to the `Redis` instance. When calling `Redis.aclose` this internal connection pool closes automatically, which disconnects all connections."
    ]
   },
   {
@@ -48,7 +48,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "If you create custom `ConnectionPool` for the `Redis` instance to use alone, use the `from_pool` class method to create it.  This will cause the pool to be disconnected along with the Redis instance. Disconnecting the connection pool simply disconnects all connections hosted in the pool."
+    "If you create a custom `ConnectionPool` to be used by a single `Redis` instance, use the `Redis.from_pool` class method. The Redis client will take ownership of the connection pool. This will cause the pool to be disconnected along with the Redis instance. Disconnecting the connection pool simply disconnects all connections hosted in the pool."
    ]
   },
   {
@@ -61,7 +61,7 @@
     "\n",
     "pool = redis.ConnectionPool.from_url(\"redis://localhost\")\n",
     "client = redis.Redis.from_pool(pool)\n",
-    "await client.close()"
+    "await client.aclose()"
    ]
   },
   {
@@ -74,7 +74,7 @@
    },
    "source": [
     "\n",
-    "However, If you supply a `ConnectionPool` that is shared several `Redis` instances, you may want to disconnect the connection pool explicitly. use the `connection_pool` argument in that case."
+    "However, if the `ConnectionPool` is to be shared by several `Redis` instances, you should use the `connection_pool` argument, and you may want to disconnect the connection pool explicitly."
    ]
   },
   {

From 037d10826e609fa0de7a4a0f56bca440cc1d245c Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@gmail.com>
Date: Mon, 18 Mar 2024 14:57:46 +0200
Subject: [PATCH 0864/1164] Avoid workflows canceling each other out (#3183)

Co-authored-by: Gabriel Erzse <gabriel.erzse@redis.com>
---
 .github/workflows/docs.yaml        | 2 +-
 .github/workflows/integration.yaml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml
index c5c74aa4d3..a3512b46dc 100644
--- a/.github/workflows/docs.yaml
+++ b/.github/workflows/docs.yaml
@@ -13,7 +13,7 @@ on:
     - cron: '0 1 * * *' # nightly build
 
 concurrency:
-  group: ${{ github.event.pull_request.number || github.ref }}
+  group: ${{ github.event.pull_request.number || github.ref }}-docs
   cancel-in-progress: true
 
 permissions:
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 695e1b307c..8f60efe6c7 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -17,7 +17,7 @@ on:
     - cron: '0 1 * * *' # nightly build
 
 concurrency:
-  group: ${{ github.event.pull_request.number || github.ref }}
+  group: ${{ github.event.pull_request.number || github.ref }}-integration
   cancel-in-progress: true
 
 permissions:

From 07fc339b4a4088c1ff052527685ebdde43dfc4be Mon Sep 17 00:00:00 2001
From: dvora-h <67596500+dvora-h@users.noreply.github.com>
Date: Wed, 27 Mar 2024 13:13:32 +0200
Subject: [PATCH 0865/1164] Update black version to 24.3.0 (#3193)

* Update black version to 24.3.0

* fix black changes
---
 .flake8                             |  2 ++
 dev_requirements.txt                |  2 +-
 redis/_parsers/helpers.py           | 31 +++++++++++++++--------------
 redis/asyncio/client.py             | 12 ++++-------
 redis/asyncio/cluster.py            | 14 ++++++-------
 redis/asyncio/connection.py         | 14 ++++++-------
 redis/asyncio/sentinel.py           |  8 +++++---
 redis/cluster.py                    |  6 +++---
 redis/commands/core.py              |  4 +---
 redis/exceptions.py                 |  3 +--
 redis/sentinel.py                   |  8 +++++---
 redis/typing.py                     |  6 ++----
 tests/test_asyncio/test_commands.py |  1 +
 13 files changed, 55 insertions(+), 56 deletions(-)

diff --git a/.flake8 b/.flake8
index 73b4a96bb6..d2ee181447 100644
--- a/.flake8
+++ b/.flake8
@@ -16,6 +16,8 @@ exclude =
 ignore =
     E126
     E203
+    E701
+    E704
     F405
     N801
     N802
diff --git a/dev_requirements.txt b/dev_requirements.txt
index 3715599af0..ef3b1aa22d 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -1,5 +1,5 @@
 click==8.0.4
-black==22.3.0
+black==24.3.0
 flake8==5.0.4
 flake8-isort==6.0.0
 flynt~=0.69.0
diff --git a/redis/_parsers/helpers.py b/redis/_parsers/helpers.py
index bdd749a5bc..a1df927bf3 100644
--- a/redis/_parsers/helpers.py
+++ b/redis/_parsers/helpers.py
@@ -819,18 +819,19 @@ def string_keys_to_dict(key_string, callback):
         lambda r, **kwargs: r,
     ),
     **string_keys_to_dict("XREAD XREADGROUP", parse_xread_resp3),
-    "ACL LOG": lambda r: [
-        {str_if_bytes(key): str_if_bytes(value) for key, value in x.items()} for x in r
-    ]
-    if isinstance(r, list)
-    else bool_ok(r),
+    "ACL LOG": lambda r: (
+        [
+            {str_if_bytes(key): str_if_bytes(value) for key, value in x.items()}
+            for x in r
+        ]
+        if isinstance(r, list)
+        else bool_ok(r)
+    ),
     "COMMAND": parse_command_resp3,
     "CONFIG GET": lambda r: {
-        str_if_bytes(key)
-        if key is not None
-        else None: str_if_bytes(value)
-        if value is not None
-        else None
+        str_if_bytes(key) if key is not None else None: (
+            str_if_bytes(value) if value is not None else None
+        )
         for key, value in r.items()
     },
     "MEMORY STATS": lambda r: {str_if_bytes(key): value for key, value in r.items()},
@@ -838,11 +839,11 @@ def string_keys_to_dict(key_string, callback):
     "SENTINEL MASTERS": parse_sentinel_masters_resp3,
     "SENTINEL SENTINELS": parse_sentinel_slaves_and_sentinels_resp3,
     "SENTINEL SLAVES": parse_sentinel_slaves_and_sentinels_resp3,
-    "STRALGO": lambda r, **options: {
-        str_if_bytes(key): str_if_bytes(value) for key, value in r.items()
-    }
-    if isinstance(r, dict)
-    else str_if_bytes(r),
+    "STRALGO": lambda r, **options: (
+        {str_if_bytes(key): str_if_bytes(value) for key, value in r.items()}
+        if isinstance(r, dict)
+        else str_if_bytes(r)
+    ),
     "XINFO CONSUMERS": lambda r: [
         {str_if_bytes(key): value for key, value in x.items()} for x in r
     ],
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 9ff2e3917f..e153f0cd37 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -88,13 +88,11 @@
 
 
 class ResponseCallbackProtocol(Protocol):
-    def __call__(self, response: Any, **kwargs):
-        ...
+    def __call__(self, response: Any, **kwargs): ...
 
 
 class AsyncResponseCallbackProtocol(Protocol):
-    async def __call__(self, response: Any, **kwargs):
-        ...
+    async def __call__(self, response: Any, **kwargs): ...
 
 
 ResponseCallbackT = Union[ResponseCallbackProtocol, AsyncResponseCallbackProtocol]
@@ -1220,13 +1218,11 @@ async def run(
 
 
 class PubsubWorkerExceptionHandler(Protocol):
-    def __call__(self, e: BaseException, pubsub: PubSub):
-        ...
+    def __call__(self, e: BaseException, pubsub: PubSub): ...
 
 
 class AsyncPubsubWorkerExceptionHandler(Protocol):
-    async def __call__(self, e: BaseException, pubsub: PubSub):
-        ...
+    async def __call__(self, e: BaseException, pubsub: PubSub): ...
 
 
 PSWorkerThreadExcHandlerT = Union[
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 11c423b848..ff2bd10c9d 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -402,10 +402,10 @@ def __init__(
         self.command_flags = self.__class__.COMMAND_FLAGS.copy()
         self.response_callbacks = kwargs["response_callbacks"]
         self.result_callbacks = self.__class__.RESULT_CALLBACKS.copy()
-        self.result_callbacks[
-            "CLUSTER SLOTS"
-        ] = lambda cmd, res, **kwargs: parse_cluster_slots(
-            list(res.values())[0], **kwargs
+        self.result_callbacks["CLUSTER SLOTS"] = (
+            lambda cmd, res, **kwargs: parse_cluster_slots(
+                list(res.values())[0], **kwargs
+            )
         )
 
         self._initialize = True
@@ -1318,9 +1318,9 @@ async def initialize(self) -> None:
                                 )
                             tmp_slots[i].append(target_replica_node)
                             # add this node to the nodes cache
-                            tmp_nodes_cache[
-                                target_replica_node.name
-                            ] = target_replica_node
+                            tmp_nodes_cache[target_replica_node.name] = (
+                                target_replica_node
+                            )
                     else:
                         # Validate that 2 nodes want to use the same slot cache
                         # setup
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 6c5c58c683..2e470bfcfb 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -87,13 +87,11 @@ class _Sentinel(enum.Enum):
 
 
 class ConnectCallbackProtocol(Protocol):
-    def __call__(self, connection: "AbstractConnection"):
-        ...
+    def __call__(self, connection: "AbstractConnection"): ...
 
 
 class AsyncConnectCallbackProtocol(Protocol):
-    async def __call__(self, connection: "AbstractConnection"):
-        ...
+    async def __call__(self, connection: "AbstractConnection"): ...
 
 
 ConnectCallbackT = Union[ConnectCallbackProtocol, AsyncConnectCallbackProtocol]
@@ -319,9 +317,11 @@ async def connect(self):
                 await self.on_connect()
             else:
                 # Use the passed function redis_connect_func
-                await self.redis_connect_func(self) if asyncio.iscoroutinefunction(
-                    self.redis_connect_func
-                ) else self.redis_connect_func(self)
+                (
+                    await self.redis_connect_func(self)
+                    if asyncio.iscoroutinefunction(self.redis_connect_func)
+                    else self.redis_connect_func(self)
+                )
         except RedisError:
             # clean up after any error in on_connect
             await self.disconnect()
diff --git a/redis/asyncio/sentinel.py b/redis/asyncio/sentinel.py
index d88babc59c..6fd233adc8 100644
--- a/redis/asyncio/sentinel.py
+++ b/redis/asyncio/sentinel.py
@@ -108,9 +108,11 @@ class SentinelConnectionPool(ConnectionPool):
     def __init__(self, service_name, sentinel_manager, **kwargs):
         kwargs["connection_class"] = kwargs.get(
             "connection_class",
-            SentinelManagedSSLConnection
-            if kwargs.pop("ssl", False)
-            else SentinelManagedConnection,
+            (
+                SentinelManagedSSLConnection
+                if kwargs.pop("ssl", False)
+                else SentinelManagedConnection
+            ),
         )
         self.is_master = kwargs.pop("is_master", True)
         self.check_connection = kwargs.pop("check_connection", False)
diff --git a/redis/cluster.py b/redis/cluster.py
index a9213f4235..cfe902115e 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -1582,9 +1582,9 @@ def initialize(self):
                             )
                             tmp_slots[i].append(target_replica_node)
                             # add this node to the nodes cache
-                            tmp_nodes_cache[
-                                target_replica_node.name
-                            ] = target_replica_node
+                            tmp_nodes_cache[target_replica_node.name] = (
+                                target_replica_node
+                            )
                     else:
                         # Validate that 2 nodes want to use the same slot cache
                         # setup
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 464e8d8c85..566846a20e 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3399,9 +3399,7 @@ def smembers(self, name: str) -> Union[Awaitable[Set], Set]:
         """
         return self.execute_command("SMEMBERS", name, keys=[name])
 
-    def smismember(
-        self, name: str, values: List, *args: List
-    ) -> Union[
+    def smismember(self, name: str, values: List, *args: List) -> Union[
         Awaitable[List[Union[Literal[0], Literal[1]]]],
         List[Union[Literal[0], Literal[1]]],
     ]:
diff --git a/redis/exceptions.py b/redis/exceptions.py
index 8af58cb0db..dcc06774b0 100644
--- a/redis/exceptions.py
+++ b/redis/exceptions.py
@@ -217,5 +217,4 @@ class SlotNotCoveredError(RedisClusterException):
     pass
 
 
-class MaxConnectionsError(ConnectionError):
-    ...
+class MaxConnectionsError(ConnectionError): ...
diff --git a/redis/sentinel.py b/redis/sentinel.py
index dfcd8ff64b..72b5bef548 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -145,9 +145,11 @@ class SentinelConnectionPool(ConnectionPool):
     def __init__(self, service_name, sentinel_manager, **kwargs):
         kwargs["connection_class"] = kwargs.get(
             "connection_class",
-            SentinelManagedSSLConnection
-            if kwargs.pop("ssl", False)
-            else SentinelManagedConnection,
+            (
+                SentinelManagedSSLConnection
+                if kwargs.pop("ssl", False)
+                else SentinelManagedConnection
+            ),
         )
         self.is_master = kwargs.pop("is_master", True)
         self.check_connection = kwargs.pop("check_connection", False)
diff --git a/redis/typing.py b/redis/typing.py
index a5d1369d63..838219fbb6 100644
--- a/redis/typing.py
+++ b/redis/typing.py
@@ -54,12 +54,10 @@
 class CommandsProtocol(Protocol):
     connection_pool: Union["AsyncConnectionPool", "ConnectionPool"]
 
-    def execute_command(self, *args, **options):
-        ...
+    def execute_command(self, *args, **options): ...
 
 
 class ClusterCommandsProtocol(CommandsProtocol, Protocol):
     encoder: "Encoder"
 
-    def execute_command(self, *args, **options) -> Union[Any, Awaitable]:
-        ...
+    def execute_command(self, *args, **options) -> Union[Any, Awaitable]: ...
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 35b9f2a29f..7102450fe4 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -1,6 +1,7 @@
 """
 Tests async overrides of commands from their mixins
 """
+
 import asyncio
 import binascii
 import datetime

From 64f291f7797b5b3e5652da8941947b8c2db517e9 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Sun, 5 May 2024 12:20:08 +0300
Subject: [PATCH 0866/1164] Adding twine check prior to package upload (#3198)

---
 .github/workflows/pypi-publish.yaml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.github/workflows/pypi-publish.yaml b/.github/workflows/pypi-publish.yaml
index 30720d7b8a..108dfa6da5 100644
--- a/.github/workflows/pypi-publish.yaml
+++ b/.github/workflows/pypi-publish.yaml
@@ -27,6 +27,10 @@ jobs:
           python setup.py build
           python setup.py sdist bdist_wheel
 
+      - name: Basic package test prior to upload
+        run: |
+          twine check dist/*
+
       - name: Publish to Pypi
         uses: pypa/gh-action-pypi-publish@release/v1
         with:

From 3bd311c7ee9ae04da62d5f1e3b1777da49b2e61f Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@gmail.com>
Date: Wed, 8 May 2024 03:52:44 +0300
Subject: [PATCH 0867/1164] Streamline client side caching API typing (#3216)

* Streamline client side caching API typing

Streamline the typing of the client side caching API. Some of the
methods are defining commands of type `str`, while in reality tuples
are being sent for those parameters.

Add client side cache tests for Sentinels. In order to make this work,
fix the sentinel configuration in the docker-compose stack.

Add a test for client side caching with a truly custom cache, not just
injecting our internal cache structure as custom.

Add a test for client side caching where two different types of commands
use the same key, to make sure they invalidate each others cached data.

* Fixes after running tests against RE

* More test cases

* Fix async tests

* Tests for raw commands

* Change terminology for allow/deny lists

* Add test for single connection

* Make sure flushing the cache works everywhere

* Reenable some tests for cluster too

* Align cache typings at abstract level

* Use Sequence instead of Iterable for types

* Remove some exceptions in favor of ifs

---------

Co-authored-by: Gabriel Erzse <gabriel.erzse@redis.com>
---
 dev_requirements.txt             |   1 +
 dockers/sentinel.conf            |   3 +-
 redis/_cache.py                  |  96 ++++----
 redis/asyncio/client.py          |  48 ++--
 redis/asyncio/cluster.py         |  51 ++++-
 redis/asyncio/connection.py      |  59 +++--
 redis/client.py                  |  48 ++--
 redis/cluster.py                 |  43 +++-
 redis/connection.py              |  59 +++--
 tests/conftest.py                |  42 ++++
 tests/test_asyncio/conftest.py   |  29 +++
 tests/test_asyncio/test_cache.py | 194 +++++++++++++++-
 tests/test_cache.py              | 374 ++++++++++++++++++++++++++++++-
 13 files changed, 861 insertions(+), 186 deletions(-)

diff --git a/dev_requirements.txt b/dev_requirements.txt
index ef3b1aa22d..48ec278d83 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -1,5 +1,6 @@
 click==8.0.4
 black==24.3.0
+cachetools
 flake8==5.0.4
 flake8-isort==6.0.0
 flynt~=0.69.0
diff --git a/dockers/sentinel.conf b/dockers/sentinel.conf
index 1a33f53344..75f711e5d4 100644
--- a/dockers/sentinel.conf
+++ b/dockers/sentinel.conf
@@ -1,4 +1,5 @@
-sentinel monitor redis-py-test 127.0.0.1 6379 2
+sentinel resolve-hostnames yes
+sentinel monitor redis-py-test redis 6379 2
 sentinel down-after-milliseconds redis-py-test 5000
 sentinel failover-timeout redis-py-test 60000
 sentinel parallel-syncs redis-py-test 1
\ No newline at end of file
diff --git a/redis/_cache.py b/redis/_cache.py
index 7acfdde3e7..90288383d6 100644
--- a/redis/_cache.py
+++ b/redis/_cache.py
@@ -4,14 +4,20 @@
 from abc import ABC, abstractmethod
 from collections import OrderedDict, defaultdict
 from enum import Enum
-from typing import List
+from typing import List, Sequence, Union
 
 from redis.typing import KeyT, ResponseT
 
-DEFAULT_EVICTION_POLICY = "lru"
 
+class EvictionPolicy(Enum):
+    LRU = "lru"
+    LFU = "lfu"
+    RANDOM = "random"
 
-DEFAULT_BLACKLIST = [
+
+DEFAULT_EVICTION_POLICY = EvictionPolicy.LRU
+
+DEFAULT_DENY_LIST = [
     "BF.CARD",
     "BF.DEBUG",
     "BF.EXISTS",
@@ -71,8 +77,7 @@
     "TTL",
 ]
 
-
-DEFAULT_WHITELIST = [
+DEFAULT_ALLOW_LIST = [
     "BITCOUNT",
     "BITFIELD_RO",
     "BITPOS",
@@ -155,12 +160,6 @@
 _ACCESS_COUNT = "access_count"
 
 
-class EvictionPolicy(Enum):
-    LRU = "lru"
-    LFU = "lfu"
-    RANDOM = "random"
-
-
 class AbstractCache(ABC):
     """
     An abstract base class for client caching implementations.
@@ -168,19 +167,24 @@ class AbstractCache(ABC):
     """
 
     @abstractmethod
-    def set(self, command: str, response: ResponseT, keys_in_command: List[KeyT]):
+    def set(
+        self,
+        command: Union[str, Sequence[str]],
+        response: ResponseT,
+        keys_in_command: List[KeyT],
+    ):
         pass
 
     @abstractmethod
-    def get(self, command: str) -> ResponseT:
+    def get(self, command: Union[str, Sequence[str]]) -> ResponseT:
         pass
 
     @abstractmethod
-    def delete_command(self, command: str):
+    def delete_command(self, command: Union[str, Sequence[str]]):
         pass
 
     @abstractmethod
-    def delete_many(self, commands):
+    def delete_commands(self, commands: List[Union[str, Sequence[str]]]):
         pass
 
     @abstractmethod
@@ -215,7 +219,6 @@ def __init__(
         max_size: int = 10000,
         ttl: int = 0,
         eviction_policy: EvictionPolicy = DEFAULT_EVICTION_POLICY,
-        **kwargs,
     ):
         self.max_size = max_size
         self.ttl = ttl
@@ -224,12 +227,17 @@ def __init__(
         self.key_commands_map = defaultdict(set)
         self.commands_ttl_list = []
 
-    def set(self, command: str, response: ResponseT, keys_in_command: List[KeyT]):
+    def set(
+        self,
+        command: Union[str, Sequence[str]],
+        response: ResponseT,
+        keys_in_command: List[KeyT],
+    ):
         """
         Set a redis command and its response in the cache.
 
         Args:
-            command (str): The redis command.
+            command (Union[str, Sequence[str]]): The redis command.
             response (ResponseT): The response associated with the command.
             keys_in_command (List[KeyT]): The list of keys used in the command.
         """
@@ -244,12 +252,12 @@ def set(self, command: str, response: ResponseT, keys_in_command: List[KeyT]):
         self._update_key_commands_map(keys_in_command, command)
         self.commands_ttl_list.append(command)
 
-    def get(self, command: str) -> ResponseT:
+    def get(self, command: Union[str, Sequence[str]]) -> ResponseT:
         """
         Get the response for a redis command from the cache.
 
         Args:
-            command (str): The redis command.
+            command (Union[str, Sequence[str]]): The redis command.
 
         Returns:
             ResponseT: The response associated with the command, or None if the command is not in the cache.  # noqa
@@ -261,12 +269,12 @@ def get(self, command: str) -> ResponseT:
             self._update_access(command)
             return copy.deepcopy(self.cache[command]["response"])
 
-    def delete_command(self, command: str):
+    def delete_command(self, command: Union[str, Sequence[str]]):
         """
         Delete a redis command and its metadata from the cache.
 
         Args:
-            command (str): The redis command to be deleted.
+            command (Union[str, Sequence[str]]): The redis command to be deleted.
         """
         if command in self.cache:
             keys_in_command = self.cache[command].get("keys")
@@ -274,8 +282,16 @@ def delete_command(self, command: str):
             self.commands_ttl_list.remove(command)
             del self.cache[command]
 
-    def delete_many(self, commands):
-        pass
+    def delete_commands(self, commands: List[Union[str, Sequence[str]]]):
+        """
+        Delete multiple commands and their metadata from the cache.
+
+        Args:
+            commands (List[Union[str, Sequence[str]]]): The list of commands to be
+            deleted.
+        """
+        for command in commands:
+            self.delete_command(command)
 
     def flush(self):
         """Clear the entire cache, removing all redis commands and metadata."""
@@ -283,12 +299,12 @@ def flush(self):
         self.key_commands_map.clear()
         self.commands_ttl_list = []
 
-    def _is_expired(self, command: str) -> bool:
+    def _is_expired(self, command: Union[str, Sequence[str]]) -> bool:
         """
         Check if a redis command has expired based on its time-to-live.
 
         Args:
-            command (str): The redis command.
+            command (Union[str, Sequence[str]]): The redis command.
 
         Returns:
             bool: True if the command has expired, False otherwise.
@@ -297,56 +313,60 @@ def _is_expired(self, command: str) -> bool:
             return False
         return time.monotonic() - self.cache[command]["ctime"] > self.ttl
 
-    def _update_access(self, command: str):
+    def _update_access(self, command: Union[str, Sequence[str]]):
         """
         Update the access information for a redis command based on the eviction policy.
 
         Args:
-            command (str): The redis command.
+            command (Union[str, Sequence[str]]): The redis command.
         """
-        if self.eviction_policy == EvictionPolicy.LRU.value:
+        if self.eviction_policy == EvictionPolicy.LRU:
             self.cache.move_to_end(command)
-        elif self.eviction_policy == EvictionPolicy.LFU.value:
+        elif self.eviction_policy == EvictionPolicy.LFU:
             self.cache[command]["access_count"] = (
                 self.cache.get(command, {}).get("access_count", 0) + 1
             )
             self.cache.move_to_end(command)
-        elif self.eviction_policy == EvictionPolicy.RANDOM.value:
+        elif self.eviction_policy == EvictionPolicy.RANDOM:
             pass  # Random eviction doesn't require updates
 
     def _evict(self):
         """Evict a redis command from the cache based on the eviction policy."""
         if self._is_expired(self.commands_ttl_list[0]):
             self.delete_command(self.commands_ttl_list[0])
-        elif self.eviction_policy == EvictionPolicy.LRU.value:
+        elif self.eviction_policy == EvictionPolicy.LRU:
             self.cache.popitem(last=False)
-        elif self.eviction_policy == EvictionPolicy.LFU.value:
+        elif self.eviction_policy == EvictionPolicy.LFU:
             min_access_command = min(
                 self.cache, key=lambda k: self.cache[k].get("access_count", 0)
             )
             self.cache.pop(min_access_command)
-        elif self.eviction_policy == EvictionPolicy.RANDOM.value:
+        elif self.eviction_policy == EvictionPolicy.RANDOM:
             random_command = random.choice(list(self.cache.keys()))
             self.cache.pop(random_command)
 
-    def _update_key_commands_map(self, keys: List[KeyT], command: str):
+    def _update_key_commands_map(
+        self, keys: List[KeyT], command: Union[str, Sequence[str]]
+    ):
         """
         Update the key_commands_map with command that uses the keys.
 
         Args:
             keys (List[KeyT]): The list of keys used in the command.
-            command (str): The redis command.
+            command (Union[str, Sequence[str]]): The redis command.
         """
         for key in keys:
             self.key_commands_map[key].add(command)
 
-    def _del_key_commands_map(self, keys: List[KeyT], command: str):
+    def _del_key_commands_map(
+        self, keys: List[KeyT], command: Union[str, Sequence[str]]
+    ):
         """
         Remove a redis command from the key_commands_map.
 
         Args:
             keys (List[KeyT]): The list of keys used in the redis command.
-            command (str): The redis command.
+            command (Union[str, Sequence[str]]): The redis command.
         """
         for key in keys:
             self.key_commands_map[key].remove(command)
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index e153f0cd37..9860a2b4f9 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -27,9 +27,9 @@
 )
 
 from redis._cache import (
-    DEFAULT_BLACKLIST,
+    DEFAULT_ALLOW_LIST,
+    DEFAULT_DENY_LIST,
     DEFAULT_EVICTION_POLICY,
-    DEFAULT_WHITELIST,
     AbstractCache,
 )
 from redis._parsers.helpers import (
@@ -243,8 +243,8 @@ def __init__(
         cache_max_size: int = 100,
         cache_ttl: int = 0,
         cache_policy: str = DEFAULT_EVICTION_POLICY,
-        cache_blacklist: List[str] = DEFAULT_BLACKLIST,
-        cache_whitelist: List[str] = DEFAULT_WHITELIST,
+        cache_deny_list: List[str] = DEFAULT_DENY_LIST,
+        cache_allow_list: List[str] = DEFAULT_ALLOW_LIST,
     ):
         """
         Initialize a new Redis client.
@@ -299,8 +299,8 @@ def __init__(
                 "cache_max_size": cache_max_size,
                 "cache_ttl": cache_ttl,
                 "cache_policy": cache_policy,
-                "cache_blacklist": cache_blacklist,
-                "cache_whitelist": cache_whitelist,
+                "cache_deny_list": cache_deny_list,
+                "cache_allow_list": cache_allow_list,
             }
             # based on input, setup appropriate connection args
             if unix_socket_path is not None:
@@ -640,7 +640,8 @@ async def execute_command(self, *args, **options):
                         ),
                         lambda error: self._disconnect_raise(conn, error),
                     )
-                    conn._add_to_local_cache(args, response, keys)
+                    if keys:
+                        conn._add_to_local_cache(args, response, keys)
                     return response
                 finally:
                     if self.single_connection_client:
@@ -675,31 +676,22 @@ async def parse_response(
         return response
 
     def flush_cache(self):
-        try:
-            if self.connection:
-                self.connection.client_cache.flush()
-            else:
-                self.connection_pool.flush_cache()
-        except AttributeError:
-            pass
+        if self.connection:
+            self.connection.flush_cache()
+        else:
+            self.connection_pool.flush_cache()
 
     def delete_command_from_cache(self, command):
-        try:
-            if self.connection:
-                self.connection.client_cache.delete_command(command)
-            else:
-                self.connection_pool.delete_command_from_cache(command)
-        except AttributeError:
-            pass
+        if self.connection:
+            self.connection.delete_command_from_cache(command)
+        else:
+            self.connection_pool.delete_command_from_cache(command)
 
     def invalidate_key_from_cache(self, key):
-        try:
-            if self.connection:
-                self.connection.client_cache.invalidate_key(key)
-            else:
-                self.connection_pool.invalidate_key_from_cache(key)
-        except AttributeError:
-            pass
+        if self.connection:
+            self.connection.invalidate_key_from_cache(key)
+        else:
+            self.connection_pool.invalidate_key_from_cache(key)
 
 
 StrictRedis = Redis
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index ff2bd10c9d..302dc0d86b 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -20,9 +20,9 @@
 )
 
 from redis._cache import (
-    DEFAULT_BLACKLIST,
+    DEFAULT_ALLOW_LIST,
+    DEFAULT_DENY_LIST,
     DEFAULT_EVICTION_POLICY,
-    DEFAULT_WHITELIST,
     AbstractCache,
 )
 from redis._parsers import AsyncCommandsParser, Encoder
@@ -280,8 +280,8 @@ def __init__(
         cache_max_size: int = 100,
         cache_ttl: int = 0,
         cache_policy: str = DEFAULT_EVICTION_POLICY,
-        cache_blacklist: List[str] = DEFAULT_BLACKLIST,
-        cache_whitelist: List[str] = DEFAULT_WHITELIST,
+        cache_deny_list: List[str] = DEFAULT_DENY_LIST,
+        cache_allow_list: List[str] = DEFAULT_ALLOW_LIST,
     ) -> None:
         if db:
             raise RedisClusterException(
@@ -331,8 +331,8 @@ def __init__(
             "cache_max_size": cache_max_size,
             "cache_ttl": cache_ttl,
             "cache_policy": cache_policy,
-            "cache_blacklist": cache_blacklist,
-            "cache_whitelist": cache_whitelist,
+            "cache_deny_list": cache_deny_list,
+            "cache_allow_list": cache_allow_list,
         }
 
         if ssl:
@@ -936,6 +936,18 @@ def lock(
             thread_local=thread_local,
         )
 
+    def flush_cache(self):
+        if self.nodes_manager:
+            self.nodes_manager.flush_cache()
+
+    def delete_command_from_cache(self, command):
+        if self.nodes_manager:
+            self.nodes_manager.delete_command_from_cache(command)
+
+    def invalidate_key_from_cache(self, key):
+        if self.nodes_manager:
+            self.nodes_manager.invalidate_key_from_cache(key)
+
 
 class ClusterNode:
     """
@@ -1075,7 +1087,8 @@ async def execute_command(self, *args: Any, **kwargs: Any) -> Any:
             # Read response
             try:
                 response = await self.parse_response(connection, args[0], **kwargs)
-                connection._add_to_local_cache(args, response, keys)
+                if keys:
+                    connection._add_to_local_cache(args, response, keys)
                 return response
             finally:
                 # Release connection
@@ -1106,6 +1119,18 @@ async def execute_pipeline(self, commands: List["PipelineCommand"]) -> bool:
 
         return ret
 
+    def flush_cache(self):
+        for connection in self._connections:
+            connection.flush_cache()
+
+    def delete_command_from_cache(self, command):
+        for connection in self._connections:
+            connection.delete_command_from_cache(command)
+
+    def invalidate_key_from_cache(self, key):
+        for connection in self._connections:
+            connection.invalidate_key_from_cache(key)
+
 
 class NodesManager:
     __slots__ = (
@@ -1391,6 +1416,18 @@ def remap_host_port(self, host: str, port: int) -> Tuple[str, int]:
             return self.address_remap((host, port))
         return host, port
 
+    def flush_cache(self):
+        for node in self.nodes_cache.values():
+            node.flush_cache()
+
+    def delete_command_from_cache(self, command):
+        for node in self.nodes_cache.values():
+            node.delete_command_from_cache(command)
+
+    def invalidate_key_from_cache(self, key):
+        for node in self.nodes_cache.values():
+            node.invalidate_key_from_cache(key)
+
 
 class ClusterPipeline(AbstractRedis, AbstractRedisCluster, AsyncRedisClusterCommands):
     """
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 2e470bfcfb..3899cb8c79 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -51,9 +51,9 @@
 from redis.utils import HIREDIS_AVAILABLE, get_lib_version, str_if_bytes
 
 from .._cache import (
-    DEFAULT_BLACKLIST,
+    DEFAULT_ALLOW_LIST,
+    DEFAULT_DENY_LIST,
     DEFAULT_EVICTION_POLICY,
-    DEFAULT_WHITELIST,
     AbstractCache,
     _LocalCache,
 )
@@ -120,8 +120,8 @@ class AbstractConnection:
         "ssl_context",
         "protocol",
         "client_cache",
-        "cache_blacklist",
-        "cache_whitelist",
+        "cache_deny_list",
+        "cache_allow_list",
         "_reader",
         "_writer",
         "_parser",
@@ -161,8 +161,8 @@ def __init__(
         cache_max_size: int = 10000,
         cache_ttl: int = 0,
         cache_policy: str = DEFAULT_EVICTION_POLICY,
-        cache_blacklist: List[str] = DEFAULT_BLACKLIST,
-        cache_whitelist: List[str] = DEFAULT_WHITELIST,
+        cache_deny_list: List[str] = DEFAULT_DENY_LIST,
+        cache_allow_list: List[str] = DEFAULT_ALLOW_LIST,
     ):
         if (username or password) and credential_provider is not None:
             raise DataError(
@@ -230,8 +230,8 @@ def __init__(
                 raise RedisError(
                     "client caching is only supported with protocol version 3 or higher"
                 )
-            self.cache_blacklist = cache_blacklist
-            self.cache_whitelist = cache_whitelist
+            self.cache_deny_list = cache_deny_list
+            self.cache_allow_list = cache_allow_list
 
     def __del__(self, _warnings: Any = warnings):
         # For some reason, the individual streams don't get properly garbage
@@ -696,7 +696,7 @@ def _cache_invalidation_process(
         and the second string is the list of keys to invalidate.
         (if the list of keys is None, then all keys are invalidated)
         """
-        if data[1] is not None:
+        if data[1] is None:
             self.client_cache.flush()
         else:
             for key in data[1]:
@@ -708,8 +708,8 @@ async def _get_from_local_cache(self, command: str):
         """
         if (
             self.client_cache is None
-            or command[0] in self.cache_blacklist
-            or command[0] not in self.cache_whitelist
+            or command[0] in self.cache_deny_list
+            or command[0] not in self.cache_allow_list
         ):
             return None
         while not self._socket_is_empty():
@@ -725,11 +725,23 @@ def _add_to_local_cache(
         """
         if (
             self.client_cache is not None
-            and (self.cache_blacklist == [] or command[0] not in self.cache_blacklist)
-            and (self.cache_whitelist == [] or command[0] in self.cache_whitelist)
+            and (self.cache_deny_list == [] or command[0] not in self.cache_deny_list)
+            and (self.cache_allow_list == [] or command[0] in self.cache_allow_list)
         ):
             self.client_cache.set(command, response, keys)
 
+    def flush_cache(self):
+        if self.client_cache:
+            self.client_cache.flush()
+
+    def delete_command_from_cache(self, command):
+        if self.client_cache:
+            self.client_cache.delete_command(command)
+
+    def invalidate_key_from_cache(self, key):
+        if self.client_cache:
+            self.client_cache.invalidate_key(key)
+
 
 class Connection(AbstractConnection):
     "Manages TCP communication to and from a Redis server"
@@ -1252,33 +1264,18 @@ def set_retry(self, retry: "Retry") -> None:
 
     def flush_cache(self):
         connections = chain(self._available_connections, self._in_use_connections)
-
         for connection in connections:
-            try:
-                connection.client_cache.flush()
-            except AttributeError:
-                # cache is not enabled
-                pass
+            connection.flush_cache()
 
     def delete_command_from_cache(self, command: str):
         connections = chain(self._available_connections, self._in_use_connections)
-
         for connection in connections:
-            try:
-                connection.client_cache.delete_command(command)
-            except AttributeError:
-                # cache is not enabled
-                pass
+            connection.delete_command_from_cache(command)
 
     def invalidate_key_from_cache(self, key: str):
         connections = chain(self._available_connections, self._in_use_connections)
-
         for connection in connections:
-            try:
-                connection.client_cache.invalidate_key(key)
-            except AttributeError:
-                # cache is not enabled
-                pass
+            connection.invalidate_key_from_cache(key)
 
 
 class BlockingConnectionPool(ConnectionPool):
diff --git a/redis/client.py b/redis/client.py
index 79f52cc989..2605c0423e 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -7,9 +7,9 @@
 from typing import Any, Callable, Dict, List, Optional, Type, Union
 
 from redis._cache import (
-    DEFAULT_BLACKLIST,
+    DEFAULT_ALLOW_LIST,
+    DEFAULT_DENY_LIST,
     DEFAULT_EVICTION_POLICY,
-    DEFAULT_WHITELIST,
     AbstractCache,
 )
 from redis._parsers.encoders import Encoder
@@ -220,8 +220,8 @@ def __init__(
         cache_max_size: int = 10000,
         cache_ttl: int = 0,
         cache_policy: str = DEFAULT_EVICTION_POLICY,
-        cache_blacklist: List[str] = DEFAULT_BLACKLIST,
-        cache_whitelist: List[str] = DEFAULT_WHITELIST,
+        cache_deny_list: List[str] = DEFAULT_DENY_LIST,
+        cache_allow_list: List[str] = DEFAULT_ALLOW_LIST,
     ) -> None:
         """
         Initialize a new Redis client.
@@ -278,8 +278,8 @@ def __init__(
                 "cache_max_size": cache_max_size,
                 "cache_ttl": cache_ttl,
                 "cache_policy": cache_policy,
-                "cache_blacklist": cache_blacklist,
-                "cache_whitelist": cache_whitelist,
+                "cache_deny_list": cache_deny_list,
+                "cache_allow_list": cache_allow_list,
             }
             # based on input, setup appropriate connection args
             if unix_socket_path is not None:
@@ -573,7 +573,8 @@ def execute_command(self, *args, **options):
                     ),
                     lambda error: self._disconnect_raise(conn, error),
                 )
-                conn._add_to_local_cache(args, response, keys)
+                if keys:
+                    conn._add_to_local_cache(args, response, keys)
                 return response
         finally:
             if not self.connection:
@@ -600,31 +601,22 @@ def parse_response(self, connection, command_name, **options):
         return response
 
     def flush_cache(self):
-        try:
-            if self.connection:
-                self.connection.client_cache.flush()
-            else:
-                self.connection_pool.flush_cache()
-        except AttributeError:
-            pass
+        if self.connection:
+            self.connection.flush_cache()
+        else:
+            self.connection_pool.flush_cache()
 
     def delete_command_from_cache(self, command):
-        try:
-            if self.connection:
-                self.connection.client_cache.delete_command(command)
-            else:
-                self.connection_pool.delete_command_from_cache(command)
-        except AttributeError:
-            pass
+        if self.connection:
+            self.connection.delete_command_from_cache(command)
+        else:
+            self.connection_pool.delete_command_from_cache(command)
 
     def invalidate_key_from_cache(self, key):
-        try:
-            if self.connection:
-                self.connection.client_cache.invalidate_key(key)
-            else:
-                self.connection_pool.invalidate_key_from_cache(key)
-        except AttributeError:
-            pass
+        if self.connection:
+            self.connection.invalidate_key_from_cache(key)
+        else:
+            self.connection_pool.invalidate_key_from_cache(key)
 
 
 StrictRedis = Redis
diff --git a/redis/cluster.py b/redis/cluster.py
index cfe902115e..e792d51867 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -172,8 +172,8 @@ def parse_cluster_myshardid(resp, **options):
     "cache_max_size",
     "cache_ttl",
     "cache_policy",
-    "cache_blacklist",
-    "cache_whitelist",
+    "cache_deny_list",
+    "cache_allow_list",
 )
 KWARGS_DISABLED_KEYS = ("host", "port")
 
@@ -1164,7 +1164,8 @@ def _execute_command(self, target_node, *args, **kwargs):
                         response = self.cluster_response_callbacks[command](
                             response, **kwargs
                         )
-                    connection._add_to_local_cache(args, response, keys)
+                    if keys:
+                        connection._add_to_local_cache(args, response, keys)
                     return response
             except AuthenticationError:
                 raise
@@ -1265,6 +1266,18 @@ def load_external_module(self, funcname, func):
         """
         setattr(self, funcname, func)
 
+    def flush_cache(self):
+        if self.nodes_manager:
+            self.nodes_manager.flush_cache()
+
+    def delete_command_from_cache(self, command):
+        if self.nodes_manager:
+            self.nodes_manager.delete_command_from_cache(command)
+
+    def invalidate_key_from_cache(self, key):
+        if self.nodes_manager:
+            self.nodes_manager.invalidate_key_from_cache(key)
+
 
 class ClusterNode:
     def __init__(self, host, port, server_type=None, redis_connection=None):
@@ -1293,6 +1306,18 @@ def __del__(self):
         if self.redis_connection is not None:
             self.redis_connection.close()
 
+    def flush_cache(self):
+        if self.redis_connection is not None:
+            self.redis_connection.flush_cache()
+
+    def delete_command_from_cache(self, command):
+        if self.redis_connection is not None:
+            self.redis_connection.delete_command_from_cache(command)
+
+    def invalidate_key_from_cache(self, key):
+        if self.redis_connection is not None:
+            self.redis_connection.invalidate_key_from_cache(key)
+
 
 class LoadBalancer:
     """
@@ -1659,6 +1684,18 @@ def remap_host_port(self, host: str, port: int) -> Tuple[str, int]:
             return self.address_remap((host, port))
         return host, port
 
+    def flush_cache(self):
+        for node in self.nodes_cache.values():
+            node.flush_cache()
+
+    def delete_command_from_cache(self, command):
+        for node in self.nodes_cache.values():
+            node.delete_command_from_cache(command)
+
+    def invalidate_key_from_cache(self, key):
+        for node in self.nodes_cache.values():
+            node.invalidate_key_from_cache(key)
+
 
 class ClusterPubSub(PubSub):
     """
diff --git a/redis/connection.py b/redis/connection.py
index b89ce0e94b..0799cd3c29 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -9,13 +9,13 @@
 from itertools import chain
 from queue import Empty, Full, LifoQueue
 from time import time
-from typing import Any, Callable, List, Optional, Tuple, Type, Union
+from typing import Any, Callable, List, Optional, Sequence, Type, Union
 from urllib.parse import parse_qs, unquote, urlparse
 
 from ._cache import (
-    DEFAULT_BLACKLIST,
+    DEFAULT_ALLOW_LIST,
+    DEFAULT_DENY_LIST,
     DEFAULT_EVICTION_POLICY,
-    DEFAULT_WHITELIST,
     AbstractCache,
     _LocalCache,
 )
@@ -162,8 +162,8 @@ def __init__(
         cache_max_size: int = 10000,
         cache_ttl: int = 0,
         cache_policy: str = DEFAULT_EVICTION_POLICY,
-        cache_blacklist: List[str] = DEFAULT_BLACKLIST,
-        cache_whitelist: List[str] = DEFAULT_WHITELIST,
+        cache_deny_list: List[str] = DEFAULT_DENY_LIST,
+        cache_allow_list: List[str] = DEFAULT_ALLOW_LIST,
     ):
         """
         Initialize a new Connection.
@@ -239,8 +239,8 @@ def __init__(
                 raise RedisError(
                     "client caching is only supported with protocol version 3 or higher"
                 )
-            self.cache_blacklist = cache_blacklist
-            self.cache_whitelist = cache_whitelist
+            self.cache_deny_list = cache_deny_list
+            self.cache_allow_list = cache_allow_list
 
     def __repr__(self):
         repr_args = ",".join([f"{k}={v}" for k, v in self.repr_pieces()])
@@ -623,14 +623,14 @@ def _cache_invalidation_process(
             for key in data[1]:
                 self.client_cache.invalidate_key(str_if_bytes(key))
 
-    def _get_from_local_cache(self, command: str):
+    def _get_from_local_cache(self, command: Sequence[str]):
         """
         If the command is in the local cache, return the response
         """
         if (
             self.client_cache is None
-            or command[0] in self.cache_blacklist
-            or command[0] not in self.cache_whitelist
+            or command[0] in self.cache_deny_list
+            or command[0] not in self.cache_allow_list
         ):
             return None
         while self.can_read():
@@ -638,7 +638,7 @@ def _get_from_local_cache(self, command: str):
         return self.client_cache.get(command)
 
     def _add_to_local_cache(
-        self, command: Tuple[str], response: ResponseT, keys: List[KeysT]
+        self, command: Sequence[str], response: ResponseT, keys: List[KeysT]
     ):
         """
         Add the command and response to the local cache if the command
@@ -646,11 +646,23 @@ def _add_to_local_cache(
         """
         if (
             self.client_cache is not None
-            and (self.cache_blacklist == [] or command[0] not in self.cache_blacklist)
-            and (self.cache_whitelist == [] or command[0] in self.cache_whitelist)
+            and (self.cache_deny_list == [] or command[0] not in self.cache_deny_list)
+            and (self.cache_allow_list == [] or command[0] in self.cache_allow_list)
         ):
             self.client_cache.set(command, response, keys)
 
+    def flush_cache(self):
+        if self.client_cache:
+            self.client_cache.flush()
+
+    def delete_command_from_cache(self, command: Union[str, Sequence[str]]):
+        if self.client_cache:
+            self.client_cache.delete_command(command)
+
+    def invalidate_key_from_cache(self, key: KeysT):
+        if self.client_cache:
+            self.client_cache.invalidate_key(key)
+
 
 class Connection(AbstractConnection):
     "Manages TCP communication to and from a Redis server"
@@ -1279,37 +1291,22 @@ def flush_cache(self):
         self._checkpid()
         with self._lock:
             connections = chain(self._available_connections, self._in_use_connections)
-
             for connection in connections:
-                try:
-                    connection.client_cache.flush()
-                except AttributeError:
-                    # cache is not enabled
-                    pass
+                connection.flush_cache()
 
     def delete_command_from_cache(self, command: str):
         self._checkpid()
         with self._lock:
             connections = chain(self._available_connections, self._in_use_connections)
-
             for connection in connections:
-                try:
-                    connection.client_cache.delete_command(command)
-                except AttributeError:
-                    # cache is not enabled
-                    pass
+                connection.delete_command_from_cache(command)
 
     def invalidate_key_from_cache(self, key: str):
         self._checkpid()
         with self._lock:
             connections = chain(self._available_connections, self._in_use_connections)
-
             for connection in connections:
-                try:
-                    connection.client_cache.invalidate_key(key)
-                except AttributeError:
-                    # cache is not enabled
-                    pass
+                connection.invalidate_key_from_cache(key)
 
 
 class BlockingConnectionPool(ConnectionPool):
diff --git a/tests/conftest.py b/tests/conftest.py
index 8786e2b9f0..e783b6e8f9 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -9,6 +9,7 @@
 import pytest
 import redis
 from packaging.version import Version
+from redis import Sentinel
 from redis.backoff import NoBackoff
 from redis.connection import Connection, parse_url
 from redis.exceptions import RedisClusterException
@@ -105,6 +106,19 @@ def pytest_addoption(parser):
         "--uvloop", action=BooleanOptionalAction, help="Run tests with uvloop"
     )
 
+    parser.addoption(
+        "--sentinels",
+        action="store",
+        default="localhost:26379,localhost:26380,localhost:26381",
+        help="Comma-separated list of sentinel IPs and ports",
+    )
+    parser.addoption(
+        "--master-service",
+        action="store",
+        default="redis-py-test",
+        help="Name of the Redis master service that the sentinels are monitoring",
+    )
+
 
 def _get_info(redis_url):
     client = redis.Redis.from_url(redis_url)
@@ -352,6 +366,34 @@ def sslclient(request):
         yield client
 
 
+@pytest.fixture()
+def sentinel_setup(local_cache, request):
+    sentinel_ips = request.config.getoption("--sentinels")
+    sentinel_endpoints = [
+        (ip.strip(), int(port.strip()))
+        for ip, port in (endpoint.split(":") for endpoint in sentinel_ips.split(","))
+    ]
+    kwargs = request.param.get("kwargs", {}) if hasattr(request, "param") else {}
+    sentinel = Sentinel(
+        sentinel_endpoints,
+        socket_timeout=0.1,
+        client_cache=local_cache,
+        protocol=3,
+        **kwargs,
+    )
+    yield sentinel
+    for s in sentinel.sentinels:
+        s.close()
+
+
+@pytest.fixture()
+def master(request, sentinel_setup):
+    master_service = request.config.getoption("--master-service")
+    master = sentinel_setup.master_for(master_service)
+    yield master
+    master.close()
+
+
 def _gen_cluster_mock_resp(r, response):
     connection = Mock(spec=Connection)
     connection.retry = Retry(NoBackoff(), 0)
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index c6afec5af6..cff239fa11 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -7,6 +7,7 @@
 import redis.asyncio as redis
 from packaging.version import Version
 from redis._parsers import _AsyncHiredisParser, _AsyncRESP2Parser
+from redis.asyncio import Sentinel
 from redis.asyncio.client import Monitor
 from redis.asyncio.connection import Connection, parse_url
 from redis.asyncio.retry import Retry
@@ -136,6 +137,34 @@ async def decoded_r(create_redis):
     return await create_redis(decode_responses=True)
 
 
+@pytest_asyncio.fixture()
+async def sentinel_setup(local_cache, request):
+    sentinel_ips = request.config.getoption("--sentinels")
+    sentinel_endpoints = [
+        (ip.strip(), int(port.strip()))
+        for ip, port in (endpoint.split(":") for endpoint in sentinel_ips.split(","))
+    ]
+    kwargs = request.param.get("kwargs", {}) if hasattr(request, "param") else {}
+    sentinel = Sentinel(
+        sentinel_endpoints,
+        socket_timeout=0.1,
+        client_cache=local_cache,
+        protocol=3,
+        **kwargs,
+    )
+    yield sentinel
+    for s in sentinel.sentinels:
+        await s.aclose()
+
+
+@pytest_asyncio.fixture()
+async def master(request, sentinel_setup):
+    master_service = request.config.getoption("--master-service")
+    master = sentinel_setup.master_for(master_service)
+    yield master
+    await master.aclose()
+
+
 def _gen_cluster_mock_resp(r, response):
     connection = mock.AsyncMock(spec=Connection)
     connection.retry = Retry(NoBackoff(), 0)
diff --git a/tests/test_asyncio/test_cache.py b/tests/test_asyncio/test_cache.py
index 4762bb7c05..7a7f881ce2 100644
--- a/tests/test_asyncio/test_cache.py
+++ b/tests/test_asyncio/test_cache.py
@@ -2,7 +2,7 @@
 
 import pytest
 import pytest_asyncio
-from redis._cache import _LocalCache
+from redis._cache import EvictionPolicy, _LocalCache
 from redis.utils import HIREDIS_AVAILABLE
 
 
@@ -14,10 +14,15 @@ async def r(request, create_redis):
     yield r, cache
 
 
+@pytest_asyncio.fixture()
+async def local_cache():
+    yield _LocalCache()
+
+
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 class TestLocalCache:
-    @pytest.mark.onlynoncluster
     @pytest.mark.parametrize("r", [{"cache": _LocalCache()}], indirect=True)
+    @pytest.mark.onlynoncluster
     async def test_get_from_cache(self, r, r2):
         r, cache = r
         # add key to redis
@@ -36,7 +41,7 @@ async def test_get_from_cache(self, r, r2):
         assert await r.get("foo") == b"barbar"
 
     @pytest.mark.parametrize("r", [{"cache": _LocalCache(max_size=3)}], indirect=True)
-    async def test_cache_max_size(self, r):
+    async def test_cache_lru_eviction(self, r):
         r, cache = r
         # add 3 keys to redis
         await r.set("foo", "bar")
@@ -71,7 +76,9 @@ async def test_cache_ttl(self, r):
         assert cache.get(("GET", "foo")) is None
 
     @pytest.mark.parametrize(
-        "r", [{"cache": _LocalCache(max_size=3, eviction_policy="lfu")}], indirect=True
+        "r",
+        [{"cache": _LocalCache(max_size=3, eviction_policy=EvictionPolicy.LFU)}],
+        indirect=True,
     )
     async def test_cache_lfu_eviction(self, r):
         r, cache = r
@@ -95,12 +102,12 @@ async def test_cache_lfu_eviction(self, r):
         assert cache.get(("GET", "foo")) == b"bar"
         assert cache.get(("GET", "foo2")) is None
 
-    @pytest.mark.onlynoncluster
     @pytest.mark.parametrize(
         "r",
         [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
         indirect=True,
     )
+    @pytest.mark.onlynoncluster
     async def test_cache_decode_response(self, r):
         r, cache = r
         await r.set("foo", "bar")
@@ -119,10 +126,10 @@ async def test_cache_decode_response(self, r):
 
     @pytest.mark.parametrize(
         "r",
-        [{"cache": _LocalCache(), "kwargs": {"cache_blacklist": ["LLEN"]}}],
+        [{"cache": _LocalCache(), "kwargs": {"cache_deny_list": ["LLEN"]}}],
         indirect=True,
     )
-    async def test_cache_blacklist(self, r):
+    async def test_cache_deny_list(self, r):
         r, cache = r
         # add list to redis
         await r.lpush("mylist", "foo", "bar", "baz")
@@ -131,6 +138,20 @@ async def test_cache_blacklist(self, r):
         assert cache.get(("LLEN", "mylist")) is None
         assert cache.get(("LINDEX", "mylist", 1)) == b"bar"
 
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"cache_allow_list": ["LLEN"]}}],
+        indirect=True,
+    )
+    async def test_cache_allow_list(self, r):
+        r, cache = r
+        # add list to redis
+        await r.lpush("mylist", "foo", "bar", "baz")
+        assert await r.llen("mylist") == 3
+        assert await r.lindex("mylist", 1) == b"bar"
+        assert cache.get(("LLEN", "mylist")) == 3
+        assert cache.get(("LINDEX", "mylist", 1)) is None
+
     @pytest.mark.parametrize("r", [{"cache": _LocalCache()}], indirect=True)
     async def test_cache_return_copy(self, r):
         r, cache = r
@@ -142,12 +163,12 @@ async def test_cache_return_copy(self, r):
         check = cache.get(("LRANGE", "mylist", 0, -1))
         assert check == [b"baz", b"bar", b"foo"]
 
-    @pytest.mark.onlynoncluster
     @pytest.mark.parametrize(
         "r",
         [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
         indirect=True,
     )
+    @pytest.mark.onlynoncluster
     async def test_csc_not_cause_disconnects(self, r):
         r, cache = r
         id1 = await r.client_id()
@@ -184,6 +205,99 @@ async def test_csc_not_cause_disconnects(self, r):
         id4 = await r.client_id()
         assert id1 == id2 == id3 == id4
 
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    async def test_execute_command_keys_provided(self, r):
+        r, cache = r
+        assert await r.execute_command("SET", "b", "2") is True
+        assert await r.execute_command("GET", "b", keys=["b"]) == "2"
+        assert cache.get(("GET", "b")) == "2"
+
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    async def test_execute_command_keys_not_provided(self, r):
+        r, cache = r
+        assert await r.execute_command("SET", "b", "2") is True
+        assert (
+            await r.execute_command("GET", "b") == "2"
+        )  # keys not provided, not cached
+        assert cache.get(("GET", "b")) is None
+
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    async def test_delete_one_command(self, r):
+        r, cache = r
+        assert await r.mset({"a{a}": 1, "b{a}": 1}) is True
+        assert await r.set("c", 1) is True
+        assert await r.mget("a{a}", "b{a}") == ["1", "1"]
+        assert await r.get("c") == "1"
+        # values should be in local cache
+        assert cache.get(("MGET", "a{a}", "b{a}")) == ["1", "1"]
+        assert cache.get(("GET", "c")) == "1"
+        # delete one command from the cache
+        r.delete_command_from_cache(("MGET", "a{a}", "b{a}"))
+        # the other command is still in the local cache anymore
+        assert cache.get(("MGET", "a{a}", "b{a}")) is None
+        assert cache.get(("GET", "c")) == "1"
+        # get from redis
+        assert await r.mget("a{a}", "b{a}") == ["1", "1"]
+        assert await r.get("c") == "1"
+
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    async def test_invalidate_key(self, r):
+        r, cache = r
+        assert await r.mset({"a{a}": 1, "b{a}": 1}) is True
+        assert await r.set("c", 1) is True
+        assert await r.mget("a{a}", "b{a}") == ["1", "1"]
+        assert await r.get("c") == "1"
+        # values should be in local cache
+        assert cache.get(("MGET", "a{a}", "b{a}")) == ["1", "1"]
+        assert cache.get(("GET", "c")) == "1"
+        # invalidate one key from the cache
+        r.invalidate_key_from_cache("b{a}")
+        # one other command is still in the local cache anymore
+        assert cache.get(("MGET", "a{a}", "b{a}")) is None
+        assert cache.get(("GET", "c")) == "1"
+        # get from redis
+        assert await r.mget("a{a}", "b{a}") == ["1", "1"]
+        assert await r.get("c") == "1"
+
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    async def test_flush_entire_cache(self, r):
+        r, cache = r
+        assert await r.mset({"a{a}": 1, "b{a}": 1}) is True
+        assert await r.set("c", 1) is True
+        assert await r.mget("a{a}", "b{a}") == ["1", "1"]
+        assert await r.get("c") == "1"
+        # values should be in local cache
+        assert cache.get(("MGET", "a{a}", "b{a}")) == ["1", "1"]
+        assert cache.get(("GET", "c")) == "1"
+        # flush the local cache
+        r.flush_cache()
+        # the commands are not in the local cache anymore
+        assert cache.get(("MGET", "a{a}", "b{a}")) is None
+        assert cache.get(("GET", "c")) is None
+        # get from redis
+        assert await r.mget("a{a}", "b{a}") == ["1", "1"]
+        assert await r.get("c") == "1"
+
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 @pytest.mark.onlycluster
@@ -228,3 +342,67 @@ async def test_cache_decode_response(self, r):
         assert cache.get(("GET", "foo")) is None
         # get key from redis
         assert await r.get("foo") == "barbar"
+
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    async def test_execute_command_keys_provided(self, r):
+        r, cache = r
+        assert await r.execute_command("SET", "b", "2") is True
+        assert await r.execute_command("GET", "b", keys=["b"]) == "2"
+        assert cache.get(("GET", "b")) == "2"
+
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    async def test_execute_command_keys_not_provided(self, r):
+        r, cache = r
+        assert await r.execute_command("SET", "b", "2") is True
+        assert (
+            await r.execute_command("GET", "b") == "2"
+        )  # keys not provided, not cached
+        assert cache.get(("GET", "b")) is None
+
+
+@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+@pytest.mark.onlynoncluster
+class TestSentinelLocalCache:
+
+    async def test_get_from_cache(self, local_cache, master):
+        await master.set("foo", "bar")
+        # get key from redis and save in local cache
+        assert await master.get("foo") == b"bar"
+        # get key from local cache
+        assert local_cache.get(("GET", "foo")) == b"bar"
+        # change key in redis (cause invalidation)
+        await master.set("foo", "barbar")
+        # send any command to redis (process invalidation in background)
+        await master.ping()
+        # the command is not in the local cache anymore
+        assert local_cache.get(("GET", "foo")) is None
+        # get key from redis
+        assert await master.get("foo") == b"barbar"
+
+    @pytest.mark.parametrize(
+        "sentinel_setup",
+        [{"kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    async def test_cache_decode_response(self, local_cache, sentinel_setup, master):
+        await master.set("foo", "bar")
+        # get key from redis and save in local cache
+        assert await master.get("foo") == "bar"
+        # get key from local cache
+        assert local_cache.get(("GET", "foo")) == "bar"
+        # change key in redis (cause invalidation)
+        await master.set("foo", "barbar")
+        # send any command to redis (process invalidation in background)
+        await master.ping()
+        # the command is not in the local cache anymore
+        assert local_cache.get(("GET", "foo")) is None
+        # get key from redis
+        assert await master.get("foo") == "barbar"
diff --git a/tests/test_cache.py b/tests/test_cache.py
index dd33afd23e..022364e87a 100644
--- a/tests/test_cache.py
+++ b/tests/test_cache.py
@@ -1,8 +1,13 @@
 import time
+from collections import defaultdict
+from typing import List, Sequence, Union
 
+import cachetools
 import pytest
 import redis
-from redis._cache import _LocalCache
+from redis import RedisError
+from redis._cache import AbstractCache, EvictionPolicy, _LocalCache
+from redis.typing import KeyT, ResponseT
 from redis.utils import HIREDIS_AVAILABLE
 from tests.conftest import _get_client
 
@@ -11,17 +16,28 @@
 def r(request):
     cache = request.param.get("cache")
     kwargs = request.param.get("kwargs", {})
+    protocol = request.param.get("protocol", 3)
+    single_connection_client = request.param.get("single_connection_client", False)
     with _get_client(
-        redis.Redis, request, protocol=3, client_cache=cache, **kwargs
+        redis.Redis,
+        request,
+        single_connection_client=single_connection_client,
+        protocol=protocol,
+        client_cache=cache,
+        **kwargs,
     ) as client:
         yield client, cache
-        # client.flushdb()
+
+
+@pytest.fixture()
+def local_cache():
+    return _LocalCache()
 
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 class TestLocalCache:
-    @pytest.mark.onlynoncluster
     @pytest.mark.parametrize("r", [{"cache": _LocalCache()}], indirect=True)
+    @pytest.mark.onlynoncluster
     def test_get_from_cache(self, r, r2):
         r, cache = r
         # add key to redis
@@ -39,8 +55,12 @@ def test_get_from_cache(self, r, r2):
         # get key from redis
         assert r.get("foo") == b"barbar"
 
-    @pytest.mark.parametrize("r", [{"cache": _LocalCache(max_size=3)}], indirect=True)
-    def test_cache_max_size(self, r):
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(max_size=3)}],
+        indirect=True,
+    )
+    def test_cache_lru_eviction(self, r):
         r, cache = r
         # add 3 keys to redis
         r.set("foo", "bar")
@@ -75,7 +95,9 @@ def test_cache_ttl(self, r):
         assert cache.get(("GET", "foo")) is None
 
     @pytest.mark.parametrize(
-        "r", [{"cache": _LocalCache(max_size=3, eviction_policy="lfu")}], indirect=True
+        "r",
+        [{"cache": _LocalCache(max_size=3, eviction_policy=EvictionPolicy.LFU)}],
+        indirect=True,
     )
     def test_cache_lfu_eviction(self, r):
         r, cache = r
@@ -99,12 +121,12 @@ def test_cache_lfu_eviction(self, r):
         assert cache.get(("GET", "foo")) == b"bar"
         assert cache.get(("GET", "foo2")) is None
 
-    @pytest.mark.onlynoncluster
     @pytest.mark.parametrize(
         "r",
         [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
         indirect=True,
     )
+    @pytest.mark.onlynoncluster
     def test_cache_decode_response(self, r):
         r, cache = r
         r.set("foo", "bar")
@@ -123,10 +145,10 @@ def test_cache_decode_response(self, r):
 
     @pytest.mark.parametrize(
         "r",
-        [{"cache": _LocalCache(), "kwargs": {"cache_blacklist": ["LLEN"]}}],
+        [{"cache": _LocalCache(), "kwargs": {"cache_deny_list": ["LLEN"]}}],
         indirect=True,
     )
-    def test_cache_blacklist(self, r):
+    def test_cache_deny_list(self, r):
         r, cache = r
         # add list to redis
         r.lpush("mylist", "foo", "bar", "baz")
@@ -135,6 +157,19 @@ def test_cache_blacklist(self, r):
         assert cache.get(("LLEN", "mylist")) is None
         assert cache.get(("LINDEX", "mylist", 1)) == b"bar"
 
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"cache_allow_list": ["LLEN"]}}],
+        indirect=True,
+    )
+    def test_cache_allow_list(self, r):
+        r, cache = r
+        r.lpush("mylist", "foo", "bar", "baz")
+        assert r.llen("mylist") == 3
+        assert r.lindex("mylist", 1) == b"bar"
+        assert cache.get(("LLEN", "mylist")) == 3
+        assert cache.get(("LINDEX", "mylist", 1)) is None
+
     @pytest.mark.parametrize("r", [{"cache": _LocalCache()}], indirect=True)
     def test_cache_return_copy(self, r):
         r, cache = r
@@ -146,12 +181,12 @@ def test_cache_return_copy(self, r):
         check = cache.get(("LRANGE", "mylist", 0, -1))
         assert check == [b"baz", b"bar", b"foo"]
 
-    @pytest.mark.onlynoncluster
     @pytest.mark.parametrize(
         "r",
         [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
         indirect=True,
     )
+    @pytest.mark.onlynoncluster
     def test_csc_not_cause_disconnects(self, r):
         r, cache = r
         id1 = r.client_id()
@@ -189,6 +224,198 @@ def test_csc_not_cause_disconnects(self, r):
         id4 = r.client_id()
         assert id1 == id2 == id3 == id4
 
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    @pytest.mark.onlynoncluster
+    def test_multiple_commands_same_key(self, r):
+        r, cache = r
+        r.mset({"a": 1, "b": 1})
+        assert r.mget("a", "b") == ["1", "1"]
+        # value should be in local cache
+        assert cache.get(("MGET", "a", "b")) == ["1", "1"]
+        # set only one key
+        r.set("a", 2)
+        # send any command to redis (process invalidation in background)
+        r.ping()
+        # the command is not in the local cache anymore
+        assert cache.get(("MGET", "a", "b")) is None
+        # get from redis
+        assert r.mget("a", "b") == ["2", "1"]
+
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    def test_delete_one_command(self, r):
+        r, cache = r
+        r.mset({"a{a}": 1, "b{a}": 1})
+        r.set("c", 1)
+        assert r.mget("a{a}", "b{a}") == ["1", "1"]
+        assert r.get("c") == "1"
+        # values should be in local cache
+        assert cache.get(("MGET", "a{a}", "b{a}")) == ["1", "1"]
+        assert cache.get(("GET", "c")) == "1"
+        # delete one command from the cache
+        r.delete_command_from_cache(("MGET", "a{a}", "b{a}"))
+        # the other command is still in the local cache anymore
+        assert cache.get(("MGET", "a{a}", "b{a}")) is None
+        assert cache.get(("GET", "c")) == "1"
+        # get from redis
+        assert r.mget("a{a}", "b{a}") == ["1", "1"]
+        assert r.get("c") == "1"
+
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    def test_delete_several_commands(self, r):
+        r, cache = r
+        r.mset({"a{a}": 1, "b{a}": 1})
+        r.set("c", 1)
+        assert r.mget("a{a}", "b{a}") == ["1", "1"]
+        assert r.get("c") == "1"
+        # values should be in local cache
+        assert cache.get(("MGET", "a{a}", "b{a}")) == ["1", "1"]
+        assert cache.get(("GET", "c")) == "1"
+        # delete the commands from the cache
+        cache.delete_commands([("MGET", "a{a}", "b{a}"), ("GET", "c")])
+        # the commands are not in the local cache anymore
+        assert cache.get(("MGET", "a{a}", "b{a}")) is None
+        assert cache.get(("GET", "c")) is None
+        # get from redis
+        assert r.mget("a{a}", "b{a}") == ["1", "1"]
+        assert r.get("c") == "1"
+
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    def test_invalidate_key(self, r):
+        r, cache = r
+        r.mset({"a{a}": 1, "b{a}": 1})
+        r.set("c", 1)
+        assert r.mget("a{a}", "b{a}") == ["1", "1"]
+        assert r.get("c") == "1"
+        # values should be in local cache
+        assert cache.get(("MGET", "a{a}", "b{a}")) == ["1", "1"]
+        assert cache.get(("GET", "c")) == "1"
+        # invalidate one key from the cache
+        r.invalidate_key_from_cache("b{a}")
+        # one other command is still in the local cache anymore
+        assert cache.get(("MGET", "a{a}", "b{a}")) is None
+        assert cache.get(("GET", "c")) == "1"
+        # get from redis
+        assert r.mget("a{a}", "b{a}") == ["1", "1"]
+        assert r.get("c") == "1"
+
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    def test_flush_entire_cache(self, r):
+        r, cache = r
+        r.mset({"a{a}": 1, "b{a}": 1})
+        r.set("c", 1)
+        assert r.mget("a{a}", "b{a}") == ["1", "1"]
+        assert r.get("c") == "1"
+        # values should be in local cache
+        assert cache.get(("MGET", "a{a}", "b{a}")) == ["1", "1"]
+        assert cache.get(("GET", "c")) == "1"
+        # flush the local cache
+        r.flush_cache()
+        # the commands are not in the local cache anymore
+        assert cache.get(("MGET", "a{a}", "b{a}")) is None
+        assert cache.get(("GET", "c")) is None
+        # get from redis
+        assert r.mget("a{a}", "b{a}") == ["1", "1"]
+        assert r.get("c") == "1"
+
+    @pytest.mark.onlynoncluster
+    def test_cache_not_available_with_resp2(self, request):
+        with pytest.raises(RedisError) as e:
+            _get_client(redis.Redis, request, protocol=2, client_cache=_LocalCache())
+        assert "protocol version 3 or higher" in str(e.value)
+
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    @pytest.mark.onlynoncluster
+    def test_execute_command_args_not_split(self, r):
+        r, cache = r
+        assert r.execute_command("SET a 1") == "OK"
+        assert r.execute_command("GET a") == "1"
+        # "get a" is not whitelisted by default, the args should be separated
+        assert cache.get(("GET a",)) is None
+
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    def test_execute_command_keys_provided(self, r):
+        r, cache = r
+        assert r.execute_command("SET", "b", "2") is True
+        assert r.execute_command("GET", "b", keys=["b"]) == "2"
+        assert cache.get(("GET", "b")) == "2"
+
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    def test_execute_command_keys_not_provided(self, r):
+        r, cache = r
+        assert r.execute_command("SET", "b", "2") is True
+        assert r.execute_command("GET", "b") == "2"  # keys not provided, not cached
+        assert cache.get(("GET", "b")) is None
+
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "single_connection_client": True}],
+        indirect=True,
+    )
+    @pytest.mark.onlynoncluster
+    def test_single_connection(self, r):
+        r, cache = r
+        # add key to redis
+        r.set("foo", "bar")
+        # get key from redis and save in local cache
+        assert r.get("foo") == b"bar"
+        # get key from local cache
+        assert cache.get(("GET", "foo")) == b"bar"
+        # change key in redis (cause invalidation)
+        r.set("foo", "barbar")
+        # send any command to redis (process invalidation in background)
+        r.ping()
+        # the command is not in the local cache anymore
+        assert cache.get(("GET", "foo")) is None
+        # get key from redis
+        assert r.get("foo") == b"barbar"
+
+    @pytest.mark.parametrize("r", [{"cache": _LocalCache()}], indirect=True)
+    def test_get_from_cache_invalidate_via_get(self, r, r2):
+        r, cache = r
+        # add key to redis
+        r.set("foo", "bar")
+        # get key from redis and save in local cache
+        assert r.get("foo") == b"bar"
+        # get key from local cache
+        assert cache.get(("GET", "foo")) == b"bar"
+        # change key in redis (cause invalidation)
+        r2.set("foo", "barbar")
+        # don't send any command to redis, just run another get
+        # it should process the invalidation in background
+        assert r.get("foo") == b"barbar"
+
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 @pytest.mark.onlycluster
@@ -233,3 +460,128 @@ def test_cache_decode_response(self, r):
         assert cache.get(("GET", "foo")) is None
         # get key from redis
         assert r.get("foo") == "barbar"
+
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    def test_execute_command_keys_provided(self, r):
+        r, cache = r
+        assert r.execute_command("SET", "b", "2") is True
+        assert r.execute_command("GET", "b", keys=["b"]) == "2"
+        assert cache.get(("GET", "b")) == "2"
+
+    @pytest.mark.parametrize(
+        "r",
+        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    def test_execute_command_keys_not_provided(self, r):
+        r, cache = r
+        assert r.execute_command("SET", "b", "2") is True
+        assert r.execute_command("GET", "b") == "2"  # keys not provided, not cached
+        assert cache.get(("GET", "b")) is None
+
+
+@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+@pytest.mark.onlynoncluster
+class TestSentinelLocalCache:
+
+    def test_get_from_cache(self, local_cache, master):
+        master.set("foo", "bar")
+        # get key from redis and save in local cache
+        assert master.get("foo") == b"bar"
+        # get key from local cache
+        assert local_cache.get(("GET", "foo")) == b"bar"
+        # change key in redis (cause invalidation)
+        master.set("foo", "barbar")
+        # send any command to redis (process invalidation in background)
+        master.ping()
+        # the command is not in the local cache anymore
+        assert local_cache.get(("GET", "foo")) is None
+        # get key from redis
+        assert master.get("foo") == b"barbar"
+
+    @pytest.mark.parametrize(
+        "sentinel_setup",
+        [{"kwargs": {"decode_responses": True}}],
+        indirect=True,
+    )
+    def test_cache_decode_response(self, local_cache, sentinel_setup, master):
+        master.set("foo", "bar")
+        # get key from redis and save in local cache
+        assert master.get("foo") == "bar"
+        # get key from local cache
+        assert local_cache.get(("GET", "foo")) == "bar"
+        # change key in redis (cause invalidation)
+        master.set("foo", "barbar")
+        # send any command to redis (process invalidation in background)
+        master.ping()
+        # the command is not in the local cache anymore
+        assert local_cache.get(("GET", "foo")) is None
+        # get key from redis
+        assert master.get("foo") == "barbar"
+
+
+@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+@pytest.mark.onlynoncluster
+class TestCustomCache:
+    class _CustomCache(AbstractCache):
+        def __init__(self):
+            self.responses = cachetools.LRUCache(maxsize=1000)
+            self.keys_to_commands = defaultdict(list)
+            self.commands_to_keys = defaultdict(list)
+
+        def set(
+            self,
+            command: Union[str, Sequence[str]],
+            response: ResponseT,
+            keys_in_command: List[KeyT],
+        ):
+            self.responses[command] = response
+            for key in keys_in_command:
+                self.keys_to_commands[key].append(tuple(command))
+                self.commands_to_keys[command].append(tuple(keys_in_command))
+
+        def get(self, command: Union[str, Sequence[str]]) -> ResponseT:
+            return self.responses.get(command)
+
+        def delete_command(self, command: Union[str, Sequence[str]]):
+            self.responses.pop(command, None)
+            keys = self.commands_to_keys.pop(command, [])
+            for key in keys:
+                if command in self.keys_to_commands[key]:
+                    self.keys_to_commands[key].remove(command)
+
+        def delete_commands(self, commands: List[Union[str, Sequence[str]]]):
+            for command in commands:
+                self.delete_command(command)
+
+        def flush(self):
+            self.responses.clear()
+            self.commands_to_keys.clear()
+            self.keys_to_commands.clear()
+
+        def invalidate_key(self, key: KeyT):
+            commands = self.keys_to_commands.pop(key, [])
+            for command in commands:
+                self.delete_command(command)
+
+    @pytest.mark.parametrize("r", [{"cache": _CustomCache()}], indirect=True)
+    def test_get_from_cache(self, r, r2):
+        r, cache = r
+        # add key to redis
+        r.set("foo", "bar")
+        # get key from redis and save in local cache
+        assert r.get("foo") == b"bar"
+        # get key from local cache
+        assert cache.get(("GET", "foo")) == b"bar"
+        # change key in redis (cause invalidation)
+        r2.set("foo", "barbar")
+        # send any command to redis (process invalidation in background)
+        r.ping()
+        # the command is not in the local cache anymore
+        assert cache.get(("GET", "foo")) is None
+        # get key from redis
+        assert r.get("foo") == b"barbar"

From 8afddde93a107cc2e4eaf469c13780c8c7913a1b Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@gmail.com>
Date: Wed, 8 May 2024 03:53:12 +0300
Subject: [PATCH 0868/1164] Make it possible to customize SSL ciphers (#3212)
 (#3214)

Given that Python 3.10 changed the default list of TLS ciphers, it is a
good idea to allow customization of the list of ciphers when using
Redis with TLS. In some situations the client is unusable right now
with older servers and Python >= 3.10.
---
 redis/asyncio/client.py            |  2 +
 redis/asyncio/cluster.py           |  2 +
 redis/asyncio/connection.py        |  7 ++++
 redis/client.py                    |  2 +
 redis/connection.py                |  5 +++
 tests/test_asyncio/test_cluster.py | 54 ++++++++++++++++++++++++++
 tests/test_asyncio/test_connect.py | 26 +++++++++++++
 tests/test_connect.py              | 25 ++++++++++++
 tests/test_ssl.py                  | 62 ++++++++++++++++++++++++++++++
 9 files changed, 185 insertions(+)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 9860a2b4f9..1845b7252f 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -226,6 +226,7 @@ def __init__(
         ssl_ca_data: Optional[str] = None,
         ssl_check_hostname: bool = False,
         ssl_min_version: Optional[ssl.TLSVersion] = None,
+        ssl_ciphers: Optional[str] = None,
         max_connections: Optional[int] = None,
         single_connection_client: bool = False,
         health_check_interval: int = 0,
@@ -333,6 +334,7 @@ def __init__(
                             "ssl_ca_data": ssl_ca_data,
                             "ssl_check_hostname": ssl_check_hostname,
                             "ssl_min_version": ssl_min_version,
+                            "ssl_ciphers": ssl_ciphers,
                         }
                     )
             # This arg only used if no pool is passed in
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 302dc0d86b..d5e5756045 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -273,6 +273,7 @@ def __init__(
         ssl_check_hostname: bool = False,
         ssl_keyfile: Optional[str] = None,
         ssl_min_version: Optional[ssl.TLSVersion] = None,
+        ssl_ciphers: Optional[str] = None,
         protocol: Optional[int] = 2,
         address_remap: Optional[Callable[[str, int], Tuple[str, int]]] = None,
         cache_enabled: bool = False,
@@ -347,6 +348,7 @@ def __init__(
                     "ssl_check_hostname": ssl_check_hostname,
                     "ssl_keyfile": ssl_keyfile,
                     "ssl_min_version": ssl_min_version,
+                    "ssl_ciphers": ssl_ciphers,
                 }
             )
 
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 3899cb8c79..96f18876ea 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -836,6 +836,7 @@ def __init__(
         ssl_ca_data: Optional[str] = None,
         ssl_check_hostname: bool = False,
         ssl_min_version: Optional[ssl.TLSVersion] = None,
+        ssl_ciphers: Optional[str] = None,
         **kwargs,
     ):
         self.ssl_context: RedisSSLContext = RedisSSLContext(
@@ -846,6 +847,7 @@ def __init__(
             ca_data=ssl_ca_data,
             check_hostname=ssl_check_hostname,
             min_version=ssl_min_version,
+            ciphers=ssl_ciphers,
         )
         super().__init__(**kwargs)
 
@@ -893,6 +895,7 @@ class RedisSSLContext:
         "context",
         "check_hostname",
         "min_version",
+        "ciphers",
     )
 
     def __init__(
@@ -904,6 +907,7 @@ def __init__(
         ca_data: Optional[str] = None,
         check_hostname: bool = False,
         min_version: Optional[ssl.TLSVersion] = None,
+        ciphers: Optional[str] = None,
     ):
         self.keyfile = keyfile
         self.certfile = certfile
@@ -924,6 +928,7 @@ def __init__(
         self.ca_data = ca_data
         self.check_hostname = check_hostname
         self.min_version = min_version
+        self.ciphers = ciphers
         self.context: Optional[ssl.SSLContext] = None
 
     def get(self) -> ssl.SSLContext:
@@ -937,6 +942,8 @@ def get(self) -> ssl.SSLContext:
                 context.load_verify_locations(cafile=self.ca_certs, cadata=self.ca_data)
             if self.min_version is not None:
                 context.minimum_version = self.min_version
+            if self.ciphers is not None:
+                context.set_ciphers(self.ciphers)
             self.context = context
         return self.context
 
diff --git a/redis/client.py b/redis/client.py
index 2605c0423e..02fc724322 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -204,6 +204,7 @@ def __init__(
         ssl_ocsp_context=None,
         ssl_ocsp_expected_cert=None,
         ssl_min_version=None,
+        ssl_ciphers=None,
         max_connections=None,
         single_connection_client=False,
         health_check_interval=0,
@@ -318,6 +319,7 @@ def __init__(
                             "ssl_ocsp_context": ssl_ocsp_context,
                             "ssl_ocsp_expected_cert": ssl_ocsp_expected_cert,
                             "ssl_min_version": ssl_min_version,
+                            "ssl_ciphers": ssl_ciphers,
                         }
                     )
             connection_pool = ConnectionPool(**kwargs)
diff --git a/redis/connection.py b/redis/connection.py
index 0799cd3c29..f745ecc1d5 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -776,6 +776,7 @@ def __init__(
         ssl_ocsp_context=None,
         ssl_ocsp_expected_cert=None,
         ssl_min_version=None,
+        ssl_ciphers=None,
         **kwargs,
     ):
         """Constructor
@@ -795,6 +796,7 @@ def __init__(
             ssl_ocsp_context: A fully initialized OpenSSL.SSL.Context object to be used in verifying the ssl_ocsp_expected_cert
             ssl_ocsp_expected_cert: A PEM armoured string containing the expected certificate to be returned from the ocsp verification service.
             ssl_min_version: The lowest supported SSL version. It affects the supported SSL versions of the SSLContext. None leaves the default provided by ssl module.
+            ssl_ciphers: A string listing the ciphers that are allowed to be used. Defaults to None, which means that the default ciphers are used. See https://docs.python.org/3/library/ssl.html#ssl.SSLContext.set_ciphers for more information.
 
         Raises:
             RedisError
@@ -828,6 +830,7 @@ def __init__(
         self.ssl_ocsp_context = ssl_ocsp_context
         self.ssl_ocsp_expected_cert = ssl_ocsp_expected_cert
         self.ssl_min_version = ssl_min_version
+        self.ssl_ciphers = ssl_ciphers
         super().__init__(**kwargs)
 
     def _connect(self):
@@ -852,6 +855,8 @@ def _connect(self):
             )
         if self.ssl_min_version is not None:
             context.minimum_version = self.ssl_min_version
+        if self.ssl_ciphers:
+            context.set_ciphers(self.ssl_ciphers)
         sslsock = context.wrap_socket(sock, server_hostname=self.host)
         if self.ssl_validate_ocsp is True and CRYPTOGRAPHY_AVAILABLE is False:
             raise RedisError("cryptography is not installed.")
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index d7554b12a5..04cd683c14 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -1,6 +1,7 @@
 import asyncio
 import binascii
 import datetime
+import ssl
 import warnings
 from typing import Any, Awaitable, Callable, Dict, List, Optional, Type, Union
 from urllib.parse import urlparse
@@ -2961,6 +2962,59 @@ async def test_ssl_connection(
         async with await create_client(ssl=True, ssl_cert_reqs="none") as rc:
             assert await rc.ping()
 
+    @pytest.mark.parametrize(
+        "ssl_ciphers",
+        [
+            "AES256-SHA:DHE-RSA-AES256-SHA:AES128-SHA:DHE-RSA-AES128-SHA",
+            "ECDHE-ECDSA-AES256-GCM-SHA384",
+            "ECDHE-RSA-AES128-GCM-SHA256",
+        ],
+    )
+    async def test_ssl_connection_tls12_custom_ciphers(
+        self, ssl_ciphers, create_client: Callable[..., Awaitable[RedisCluster]]
+    ) -> None:
+        async with await create_client(
+            ssl=True,
+            ssl_cert_reqs="none",
+            ssl_min_version=ssl.TLSVersion.TLSv1_2,
+            ssl_ciphers=ssl_ciphers,
+        ) as rc:
+            assert await rc.ping()
+
+    async def test_ssl_connection_tls12_custom_ciphers_invalid(
+        self, create_client: Callable[..., Awaitable[RedisCluster]]
+    ) -> None:
+        async with await create_client(
+            ssl=True,
+            ssl_cert_reqs="none",
+            ssl_min_version=ssl.TLSVersion.TLSv1_2,
+            ssl_ciphers="foo:bar",
+        ) as rc:
+            with pytest.raises(RedisClusterException) as e:
+                assert await rc.ping()
+            assert "Redis Cluster cannot be connected" in str(e.value)
+
+    @pytest.mark.parametrize(
+        "ssl_ciphers",
+        [
+            "TLS_CHACHA20_POLY1305_SHA256",
+            "TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256",
+        ],
+    )
+    async def test_ssl_connection_tls13_custom_ciphers(
+        self, ssl_ciphers, create_client: Callable[..., Awaitable[RedisCluster]]
+    ) -> None:
+        # TLSv1.3 does not support changing the ciphers
+        async with await create_client(
+            ssl=True,
+            ssl_cert_reqs="none",
+            ssl_min_version=ssl.TLSVersion.TLSv1_2,
+            ssl_ciphers=ssl_ciphers,
+        ) as rc:
+            with pytest.raises(RedisClusterException) as e:
+                assert await rc.ping()
+            assert "Redis Cluster cannot be connected" in str(e.value)
+
     async def test_validating_self_signed_certificate(
         self, create_client: Callable[..., Awaitable[RedisCluster]]
     ) -> None:
diff --git a/tests/test_asyncio/test_connect.py b/tests/test_asyncio/test_connect.py
index 5497501258..6c902c2d05 100644
--- a/tests/test_asyncio/test_connect.py
+++ b/tests/test_asyncio/test_connect.py
@@ -50,6 +50,32 @@ async def test_uds_connect(uds_address):
     await _assert_connect(conn, path)
 
 
+@pytest.mark.ssl
+@pytest.mark.parametrize(
+    "ssl_ciphers",
+    [
+        "AES256-SHA:DHE-RSA-AES256-SHA:AES128-SHA:DHE-RSA-AES128-SHA",
+        "ECDHE-ECDSA-AES256-GCM-SHA384",
+        "ECDHE-RSA-AES128-GCM-SHA256",
+    ],
+)
+async def test_tcp_ssl_tls12_custom_ciphers(tcp_address, ssl_ciphers):
+    host, port = tcp_address
+    certfile = get_ssl_filename("server-cert.pem")
+    keyfile = get_ssl_filename("server-key.pem")
+    conn = SSLConnection(
+        host=host,
+        port=port,
+        client_name=_CLIENT_NAME,
+        ssl_ca_certs=certfile,
+        socket_timeout=10,
+        ssl_min_version=ssl.TLSVersion.TLSv1_2,
+        ssl_ciphers=ssl_ciphers,
+    )
+    await _assert_connect(conn, tcp_address, certfile=certfile, keyfile=keyfile)
+    await conn.disconnect()
+
+
 @pytest.mark.ssl
 @pytest.mark.parametrize(
     "ssl_min_version",
diff --git a/tests/test_connect.py b/tests/test_connect.py
index 0fdbb7005f..fcc1a05268 100644
--- a/tests/test_connect.py
+++ b/tests/test_connect.py
@@ -71,6 +71,31 @@ def test_tcp_ssl_connect(tcp_address, ssl_min_version):
     _assert_connect(conn, tcp_address, certfile=certfile, keyfile=keyfile)
 
 
+@pytest.mark.ssl
+@pytest.mark.parametrize(
+    "ssl_ciphers",
+    [
+        "AES256-SHA:DHE-RSA-AES256-SHA:AES128-SHA:DHE-RSA-AES128-SHA",
+        "ECDHE-ECDSA-AES256-GCM-SHA384",
+        "ECDHE-RSA-AES128-GCM-SHA256",
+    ],
+)
+def test_tcp_ssl_tls12_custom_ciphers(tcp_address, ssl_ciphers):
+    host, port = tcp_address
+    certfile = get_ssl_filename("server-cert.pem")
+    keyfile = get_ssl_filename("server-key.pem")
+    conn = SSLConnection(
+        host=host,
+        port=port,
+        client_name=_CLIENT_NAME,
+        ssl_ca_certs=certfile,
+        socket_timeout=10,
+        ssl_min_version=ssl.TLSVersion.TLSv1_2,
+        ssl_ciphers=ssl_ciphers,
+    )
+    _assert_connect(conn, tcp_address, certfile=certfile, keyfile=keyfile)
+
+
 @pytest.mark.ssl
 @pytest.mark.skipif(not ssl.HAS_TLSv1_3, reason="requires TLSv1.3")
 def test_tcp_ssl_version_mismatch(tcp_address):
diff --git a/tests/test_ssl.py b/tests/test_ssl.py
index dfd8837262..fd6fa51db7 100644
--- a/tests/test_ssl.py
+++ b/tests/test_ssl.py
@@ -78,6 +78,68 @@ def test_validating_self_signed_string_certificate(self, request):
         assert r.ping()
         r.close()
 
+    @pytest.mark.parametrize(
+        "ssl_ciphers",
+        [
+            "AES256-SHA:DHE-RSA-AES256-SHA:AES128-SHA:DHE-RSA-AES128-SHA",
+            "DHE-RSA-AES256-GCM-SHA384",
+            "ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305",
+        ],
+    )
+    def test_ssl_connection_tls12_custom_ciphers(self, request, ssl_ciphers):
+        ssl_url = request.config.option.redis_ssl_url
+        p = urlparse(ssl_url)[1].split(":")
+        r = redis.Redis(
+            host=p[0],
+            port=p[1],
+            ssl=True,
+            ssl_cert_reqs="none",
+            ssl_min_version=ssl.TLSVersion.TLSv1_3,
+            ssl_ciphers=ssl_ciphers,
+        )
+        assert r.ping()
+        r.close()
+
+    def test_ssl_connection_tls12_custom_ciphers_invalid(self, request):
+        ssl_url = request.config.option.redis_ssl_url
+        p = urlparse(ssl_url)[1].split(":")
+        r = redis.Redis(
+            host=p[0],
+            port=p[1],
+            ssl=True,
+            ssl_cert_reqs="none",
+            ssl_min_version=ssl.TLSVersion.TLSv1_2,
+            ssl_ciphers="foo:bar",
+        )
+        with pytest.raises(RedisError) as e:
+            r.ping()
+        assert "No cipher can be selected" in str(e)
+        r.close()
+
+    @pytest.mark.parametrize(
+        "ssl_ciphers",
+        [
+            "TLS_CHACHA20_POLY1305_SHA256",
+            "TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256",
+        ],
+    )
+    def test_ssl_connection_tls13_custom_ciphers(self, request, ssl_ciphers):
+        # TLSv1.3 does not support changing the ciphers
+        ssl_url = request.config.option.redis_ssl_url
+        p = urlparse(ssl_url)[1].split(":")
+        r = redis.Redis(
+            host=p[0],
+            port=p[1],
+            ssl=True,
+            ssl_cert_reqs="none",
+            ssl_min_version=ssl.TLSVersion.TLSv1_2,
+            ssl_ciphers=ssl_ciphers,
+        )
+        with pytest.raises(RedisError) as e:
+            r.ping()
+        assert "No cipher can be selected" in str(e)
+        r.close()
+
     def _create_oscp_conn(self, request):
         ssl_url = request.config.option.redis_ssl_url
         p = urlparse(ssl_url)[1].split(":")

From 4981761db2bc933434824f60629c4d48d351d7e9 Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@gmail.com>
Date: Wed, 8 May 2024 14:47:15 +0300
Subject: [PATCH 0869/1164] Version 5.1.0b5 (#3224)

Co-authored-by: Gabriel Erzse <gabriel.erzse@redis.com>
---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 1098e115c6..cf3d582713 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="5.1.0b4",
+    version="5.1.0b5",
     packages=find_packages(
         include=[
             "redis",

From a2bcea26e1b8b364da0edc01ec5ef9bc73f4fb93 Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@gmail.com>
Date: Thu, 9 May 2024 10:07:38 +0300
Subject: [PATCH 0870/1164] Support the MAXAGE option for CLIENT KILL (#3187)

Issue #3154

The CLIENT KILL command has a new option, called MAXAGE, to kill
clients older than a given age. Add support for this new option.

Co-authored-by: Gabriel Erzse <gabriel.erzse@redis.com>
---
 redis/commands/core.py | 4 ++++
 tests/test_commands.py | 9 +++++++++
 2 files changed, 13 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 566846a20e..331c2e5e4d 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -459,6 +459,7 @@ def client_kill_filter(
         skipme: Union[bool, None] = None,
         laddr: Union[bool, None] = None,
         user: str = None,
+        maxage: Union[int, None] = None,
         **kwargs,
     ) -> ResponseT:
         """
@@ -472,6 +473,7 @@ def client_kill_filter(
         options. If skipme is not provided, the server defaults to skipme=True
         :param laddr: Kills a client by its 'local (bind) address:port'
         :param user: Kills a client for a specific user name
+        :param maxage: Kills clients that are older than the specified age in seconds
         """
         args = []
         if _type is not None:
@@ -494,6 +496,8 @@ def client_kill_filter(
             args.extend((b"LADDR", laddr))
         if user is not None:
             args.extend((b"USER", user))
+        if maxage is not None:
+            args.extend((b"MAXAGE", maxage))
         if not args:
             raise DataError(
                 "CLIENT KILL <filter> <value> ... ... <filter> "
diff --git a/tests/test_commands.py b/tests/test_commands.py
index b2d7c1b9ed..1b5fe80e00 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -707,6 +707,15 @@ def test_client_kill_filter_by_user(self, r, request):
             assert c["user"] != killuser
         r.acl_deluser(killuser)
 
+    @skip_if_server_version_lt("7.4.0")
+    @skip_if_redis_enterprise()
+    def test_client_kill_filter_by_maxage(self, r, request):
+        _get_client(redis.Redis, request, flushdb=False)
+        time.sleep(4)
+        assert len(r.client_list()) == 2
+        r.client_kill_filter(maxage=2)
+        assert len(r.client_list()) == 1
+
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.9.50")
     @skip_if_redis_enterprise()

From cd92428cb3f0bc989bdf2fc03ee572bb239e7f3a Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@gmail.com>
Date: Thu, 9 May 2024 10:11:59 +0300
Subject: [PATCH 0871/1164] Support NOVALUES parameter for HSCAN (#3157)

* Support NOVALUES parameter for HSCAN

Issue #3153

The NOVALUES parameter instructs HSCAN to only return the hash keys,
without values.

Co-authored-by: Gabriel Erzse <gabriel.erzse@redis.com>
---
 redis/_parsers/helpers.py           |  7 ++++++-
 redis/commands/core.py              | 32 +++++++++++++++++++++++------
 tests/test_asyncio/test_commands.py | 27 ++++++++++++++++++++++++
 tests/test_commands.py              | 25 ++++++++++++++++++++++
 4 files changed, 84 insertions(+), 7 deletions(-)

diff --git a/redis/_parsers/helpers.py b/redis/_parsers/helpers.py
index a1df927bf3..74faa5fd7e 100644
--- a/redis/_parsers/helpers.py
+++ b/redis/_parsers/helpers.py
@@ -354,7 +354,12 @@ def parse_scan(response, **options):
 
 def parse_hscan(response, **options):
     cursor, r = response
-    return int(cursor), r and pairs_to_dict(r) or {}
+    no_values = options.get("no_values", False)
+    if no_values:
+        payload = r or []
+    else:
+        payload = r and pairs_to_dict(r) or {}
+    return int(cursor), payload
 
 
 def parse_zscan(response, **options):
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 331c2e5e4d..45ccf5be4d 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3106,6 +3106,7 @@ def hscan(
         cursor: int = 0,
         match: Union[PatternT, None] = None,
         count: Union[int, None] = None,
+        no_values: Union[bool, None] = None,
     ) -> ResponseT:
         """
         Incrementally return key/value slices in a hash. Also return a cursor
@@ -3115,6 +3116,8 @@ def hscan(
 
         ``count`` allows for hint the minimum number of returns
 
+        ``no_values`` indicates to return only the keys, without values.
+
         For more information see https://redis.io/commands/hscan
         """
         pieces: list[EncodableT] = [name, cursor]
@@ -3122,13 +3125,16 @@ def hscan(
             pieces.extend([b"MATCH", match])
         if count is not None:
             pieces.extend([b"COUNT", count])
-        return self.execute_command("HSCAN", *pieces)
+        if no_values is not None:
+            pieces.extend([b"NOVALUES"])
+        return self.execute_command("HSCAN", *pieces, no_values=no_values)
 
     def hscan_iter(
         self,
         name: str,
         match: Union[PatternT, None] = None,
         count: Union[int, None] = None,
+        no_values: Union[bool, None] = None,
     ) -> Iterator:
         """
         Make an iterator using the HSCAN command so that the client doesn't
@@ -3137,11 +3143,18 @@ def hscan_iter(
         ``match`` allows for filtering the keys by pattern
 
         ``count`` allows for hint the minimum number of returns
+
+        ``no_values`` indicates to return only the keys, without values
         """
         cursor = "0"
         while cursor != 0:
-            cursor, data = self.hscan(name, cursor=cursor, match=match, count=count)
-            yield from data.items()
+            cursor, data = self.hscan(
+                name, cursor=cursor, match=match, count=count, no_values=no_values
+            )
+            if no_values:
+                yield from data
+            else:
+                yield from data.items()
 
     def zscan(
         self,
@@ -3257,6 +3270,7 @@ async def hscan_iter(
         name: str,
         match: Union[PatternT, None] = None,
         count: Union[int, None] = None,
+        no_values: Union[bool, None] = None,
     ) -> AsyncIterator:
         """
         Make an iterator using the HSCAN command so that the client doesn't
@@ -3265,14 +3279,20 @@ async def hscan_iter(
         ``match`` allows for filtering the keys by pattern
 
         ``count`` allows for hint the minimum number of returns
+
+        ``no_values`` indicates to return only the keys, without values
         """
         cursor = "0"
         while cursor != 0:
             cursor, data = await self.hscan(
-                name, cursor=cursor, match=match, count=count
+                name, cursor=cursor, match=match, count=count, no_values=no_values
             )
-            for it in data.items():
-                yield it
+            if no_values:
+                for it in data:
+                    yield it
+            else:
+                for it in data.items():
+                    yield it
 
     async def zscan_iter(
         self,
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 7102450fe4..b3e42bae8e 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -1349,6 +1349,19 @@ async def test_hscan(self, r: redis.Redis):
         assert dic == {b"a": b"1", b"b": b"2", b"c": b"3"}
         _, dic = await r.hscan("a", match="a")
         assert dic == {b"a": b"1"}
+        _, dic = await r.hscan("a_notset", match="a")
+        assert dic == {}
+
+    @skip_if_server_version_lt("7.4.0")
+    async def test_hscan_novalues(self, r: redis.Redis):
+        await r.hset("a", mapping={"a": 1, "b": 2, "c": 3})
+        cursor, keys = await r.hscan("a", no_values=True)
+        assert cursor == 0
+        assert sorted(keys) == [b"a", b"b", b"c"]
+        _, keys = await r.hscan("a", match="a", no_values=True)
+        assert keys == [b"a"]
+        _, keys = await r.hscan("a_notset", match="a", no_values=True)
+        assert keys == []
 
     @skip_if_server_version_lt("2.8.0")
     async def test_hscan_iter(self, r: redis.Redis):
@@ -1357,6 +1370,20 @@ async def test_hscan_iter(self, r: redis.Redis):
         assert dic == {b"a": b"1", b"b": b"2", b"c": b"3"}
         dic = {k: v async for k, v in r.hscan_iter("a", match="a")}
         assert dic == {b"a": b"1"}
+        dic = {k: v async for k, v in r.hscan_iter("a_notset", match="a")}
+        assert dic == {}
+
+    @skip_if_server_version_lt("7.4.0")
+    async def test_hscan_iter_novalues(self, r: redis.Redis):
+        await r.hset("a", mapping={"a": 1, "b": 2, "c": 3})
+        keys = list([k async for k in r.hscan_iter("a", no_values=True)])
+        assert sorted(keys) == [b"a", b"b", b"c"]
+        keys = list([k async for k in r.hscan_iter("a", match="a", no_values=True)])
+        assert keys == [b"a"]
+        keys = list(
+            [k async for k in r.hscan_iter("a", match="a_notset", no_values=True)]
+        )
+        assert keys == []
 
     @skip_if_server_version_lt("2.8.0")
     async def test_zscan(self, r: redis.Redis):
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 1b5fe80e00..cd392552d1 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2171,6 +2171,19 @@ def test_hscan(self, r):
         assert dic == {b"a": b"1", b"b": b"2", b"c": b"3"}
         _, dic = r.hscan("a", match="a")
         assert dic == {b"a": b"1"}
+        _, dic = r.hscan("a_notset")
+        assert dic == {}
+
+    @skip_if_server_version_lt("7.4.0")
+    def test_hscan_novalues(self, r):
+        r.hset("a", mapping={"a": 1, "b": 2, "c": 3})
+        cursor, keys = r.hscan("a", no_values=True)
+        assert cursor == 0
+        assert sorted(keys) == [b"a", b"b", b"c"]
+        _, keys = r.hscan("a", match="a", no_values=True)
+        assert keys == [b"a"]
+        _, keys = r.hscan("a_notset", no_values=True)
+        assert keys == []
 
     @skip_if_server_version_lt("2.8.0")
     def test_hscan_iter(self, r):
@@ -2179,6 +2192,18 @@ def test_hscan_iter(self, r):
         assert dic == {b"a": b"1", b"b": b"2", b"c": b"3"}
         dic = dict(r.hscan_iter("a", match="a"))
         assert dic == {b"a": b"1"}
+        dic = dict(r.hscan_iter("a_notset"))
+        assert dic == {}
+
+    @skip_if_server_version_lt("7.4.0")
+    def test_hscan_iter_novalues(self, r):
+        r.hset("a", mapping={"a": 1, "b": 2, "c": 3})
+        keys = list(r.hscan_iter("a", no_values=True))
+        assert keys == [b"a", b"b", b"c"]
+        keys = list(r.hscan_iter("a", match="a", no_values=True))
+        assert keys == [b"a"]
+        keys = list(r.hscan_iter("a_notset", no_values=True))
+        assert keys == []
 
     @skip_if_server_version_lt("2.8.0")
     def test_zscan(self, r):

From 68d6d537529cba18ed994edb512985da766eb989 Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@gmail.com>
Date: Tue, 14 May 2024 18:58:28 +0300
Subject: [PATCH 0872/1164] Fix CNs in test certificates (#3226)

The CNs in the test certificates (CA, server and client) were all the
same, which is not right. Make them different.

Cleanup the Jupyter notebook that documents how SSL connections work.
Make the code blocks actually run, by using the test certificates from
devenv. Simplify a bit the OCSP examples, since they can't run anyway,
due to lack of OCSP in our test infrastructure, so they are rather informative.

Co-authored-by: Gabriel Erzse <gabriel.erzse@redis.com>
---
 dockers/stunnel/create_certs.sh             |   7 +-
 dockers/stunnel/keys/ca-cert.pem            |  36 ++-
 dockers/stunnel/keys/ca-key.pem             |  55 ++---
 dockers/stunnel/keys/client-cert.pem        |  34 ++-
 dockers/stunnel/keys/client-key.pem         |  52 ++---
 dockers/stunnel/keys/client-req.pem         |  28 ++-
 dockers/stunnel/keys/server-cert.pem        |  34 ++-
 dockers/stunnel/keys/server-key.pem         |  52 ++---
 dockers/stunnel/keys/server-req.pem         |  28 ++-
 docs/examples/ssl_connection_examples.ipynb | 231 +++++++++-----------
 tests/test_asyncio/test_cluster.py          |  17 +-
 tests/test_asyncio/test_connect.py          |  14 +-
 tests/test_connect.py                       |  14 +-
 tests/test_ssl.py                           |  54 ++---
 14 files changed, 313 insertions(+), 343 deletions(-)

diff --git a/dockers/stunnel/create_certs.sh b/dockers/stunnel/create_certs.sh
index f3bcea6f5d..4065562cfb 100755
--- a/dockers/stunnel/create_certs.sh
+++ b/dockers/stunnel/create_certs.sh
@@ -6,7 +6,6 @@ DESTDIR=`dirname "$0"`/keys
 test -d ${DESTDIR} || mkdir ${DESTDIR}
 cd ${DESTDIR}
 
-SSL_SUBJECT="/C=CA/ST=Winnipeg/L=Manitoba/O=Some Corp/OU=IT Department/CN=example.com"
 which openssl &>/dev/null
 if [ $? -ne 0 ]; then
 	echo "No openssl binary present, exiting."
@@ -18,12 +17,12 @@ openssl genrsa -out ca-key.pem 2048 &>/dev/null
 openssl req -new -x509 -nodes -days 365000 \
    -key ca-key.pem \
    -out ca-cert.pem \
-   -subj "${SSL_SUBJECT}" &>/dev/null
+   -subj "/CN=redis-py-ca" &>/dev/null
 
 openssl req -newkey rsa:2048 -nodes -days 365000 \
    -keyout server-key.pem \
    -out server-req.pem \
-   -subj "${SSL_SUBJECT}" &>/dev/null
+   -subj "/CN=redis-py-server" &>/dev/null
 
 openssl x509 -req -days 365000 -set_serial 01 \
    -in server-req.pem \
@@ -34,7 +33,7 @@ openssl x509 -req -days 365000 -set_serial 01 \
 openssl req -newkey rsa:2048 -nodes -days 365000 \
    -keyout client-key.pem \
    -out client-req.pem \
-   -subj "${SSL_SUBJECT}" &>/dev/null
+   -subj "/CN=redis-py-client" &>/dev/null
 
 openssl x509 -req -days 365000 -set_serial 01 \
    -in client-req.pem \
diff --git a/dockers/stunnel/keys/ca-cert.pem b/dockers/stunnel/keys/ca-cert.pem
index 460354d9ad..291cf8e23f 100644
--- a/dockers/stunnel/keys/ca-cert.pem
+++ b/dockers/stunnel/keys/ca-cert.pem
@@ -1,21 +1,19 @@
 -----BEGIN CERTIFICATE-----
-MIIDaDCCAlACCQCui7X/vxmwGjANBgkqhkiG9w0BAQsFADB1MQswCQYDVQQGEwJD
-QTERMA8GA1UECAwIV2lubmlwZWcxETAPBgNVBAcMCE1hbml0b2JhMRIwEAYDVQQK
-DAlTb21lIENvcnAxFjAUBgNVBAsMDUlUIERlcGFydG1lbnQxFDASBgNVBAMMC2V4
-YW1wbGUuY29tMCAXDTIyMDExMjE0NTQyMVoYDzMwMjEwNTE1MTQ1NDIxWjB1MQsw
-CQYDVQQGEwJDQTERMA8GA1UECAwIV2lubmlwZWcxETAPBgNVBAcMCE1hbml0b2Jh
-MRIwEAYDVQQKDAlTb21lIENvcnAxFjAUBgNVBAsMDUlUIERlcGFydG1lbnQxFDAS
-BgNVBAMMC2V4YW1wbGUuY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
-AQEAtSqof5fXyN/Y6GSLBBNA/zhrqw2qcBW4va6+Wc24WTaBXcP0w13njz+j1b5V
-9rbpz0i7WUkg3bBPecFFuCFyQnvn2JaE9b7kX1lLmszanrYfWQ9bYQyecox3HuYq
-eu330S+bD0liYh5rV7oEanuSCJW+a/dgEl3l/+Qb0zo2ZNEAXRuBv6lNmvBSsdIt
-lc5n/P06ntJ6Ia/7rO0ZEiBb6hLFKfiIo/XvDrGNlYulJEcDmC3PkzzJRGnA7R2F
-7Vggj4l4pGE/3EtnA4C/rd0Shf9TIPQFA2HOx3oYsrOonuBYM2urciNeojP5XGY/
-Zdau7hzgFBgF8tWsLU6bKyZ3NwIDAQABMA0GCSqGSIb3DQEBCwUAA4IBAQBJwnf3
-FARRxQF1Q2jIXQdyUS/lqq74C+PZF5IKOKb2K3dT1BFJlBgduvj4Ih5KUakImhMB
-SdaiwKzgB9APXNVAgrzSCb49PzXzvmaIFhPmBXSITFFfGupxpo0ZStwI03B0KZBs
-l3Zd0SzjKqZNVtTnxyDyWnYNFJtuCGanTjyPcCAFvVwzDQyzZ14liyM389WM950a
-ANM7H0iv6U/h7lWhnvBOlRfj89JChBvEROlWuYfyyELZpAXsmuwWdh0pwgGpqMI/
-EtLas2sbX5apE8P1S2Uxc+dS4IjoA/TrnP21rXwJ8AWzrntsZalSx9uueb1qhPp8
-EL7asG4+G3BpQrL1
+MIIDDzCCAfegAwIBAgIUZWdrJiIH/w7FJkNbLTYldxOFEpswDQYJKoZIhvcNAQEL
+BQAwFjEUMBIGA1UEAwwLcmVkaXMtcHktY2EwIBcNMjQwNTA5MDcyMDE4WhgPMzAy
+MzA5MTAwNzIwMThaMBYxFDASBgNVBAMMC3JlZGlzLXB5LWNhMIIBIjANBgkqhkiG
+9w0BAQEFAAOCAQ8AMIIBCgKCAQEA0N9BXLRx3Hxb+ZGuKi5hZabcDWDMEeUGunJG
+F1ijxO9XbNWXxYiR127Le2dMkS3TefU3CNiiYJa7eRxMPAS/wGUp6Bb7LrCoeC3F
+1bfJSYnzC6SwhMq66m51VhqctjAbJxBBAPYqyNBFB2w2BQZOIkKDNPgPJTDNmF/7
+G/5jmAaOPlhm1GITnT+sSTyfr/JcoRRbV9VTVc9VUaTjk6ytHsW+K2sK+uWrjdig
+qdzZDng0gtasTn907QkTDDyR4E/UY9N47aD2Jy5F3XHesy9kEfuppq+A1WYOs8/H
+bXgEL53ncayqDNAgjnid5kHvKJ9wTAPSMDqmupHG0l5ADisahwIDAQABo1MwUTAd
+BgNVHQ4EFgQUWg70hcbq4zibHXAFlZd8mHVEWzowHwYDVR0jBBgwFoAUWg70hcbq
+4zibHXAFlZd8mHVEWzowDwYDVR0TAQH/BAUwAwEB/zANBgkqhkiG9w0BAQsFAAOC
+AQEAe1qupf8GoqCgtzTwFCwmcDygLibX4vI/EfCMOLVZHMgDacDwQbmYPlM+goJT
+Pz8WCklopFcMJ6MSdUGy3g4hjKmJpKttTSuhEd3uZWPZYjhRj2SY8531/aAajg9/
+oezyvlgN/DWXAREG31XWyXLzPU7VLbg99mYB+2+lo2cAciAOCBdIOu6WzqnQax82
+aDSqXIHiTGc/5QYZ6ZIzdVRYiVdddKSxTNKZn9x0hu3L8r2e9ryGLLVKJmZfNZDS
+tXYwiY3fE0EwYViIPiPlmBEXiBhHlC2kAQMFK8Qd4LgX6rGki4luL15GYxxKPQbF
+EtDS9EqM4EdRWZq3SDjOA1zODA==
 -----END CERTIFICATE-----
diff --git a/dockers/stunnel/keys/ca-key.pem b/dockers/stunnel/keys/ca-key.pem
index 64db528c48..25989d0817 100644
--- a/dockers/stunnel/keys/ca-key.pem
+++ b/dockers/stunnel/keys/ca-key.pem
@@ -1,27 +1,28 @@
------BEGIN RSA PRIVATE KEY-----
-MIIEogIBAAKCAQEAtSqof5fXyN/Y6GSLBBNA/zhrqw2qcBW4va6+Wc24WTaBXcP0
-w13njz+j1b5V9rbpz0i7WUkg3bBPecFFuCFyQnvn2JaE9b7kX1lLmszanrYfWQ9b
-YQyecox3HuYqeu330S+bD0liYh5rV7oEanuSCJW+a/dgEl3l/+Qb0zo2ZNEAXRuB
-v6lNmvBSsdItlc5n/P06ntJ6Ia/7rO0ZEiBb6hLFKfiIo/XvDrGNlYulJEcDmC3P
-kzzJRGnA7R2F7Vggj4l4pGE/3EtnA4C/rd0Shf9TIPQFA2HOx3oYsrOonuBYM2ur
-ciNeojP5XGY/Zdau7hzgFBgF8tWsLU6bKyZ3NwIDAQABAoIBACq8mWsgAsNcKusH
-bNPVRuvt/1gmrSIrvZzhb/33TZmeBf58j2zW5h0gwiFV+SluFNHVMnzph1tEkDsE
-oNHC8hVE7XhmaY8fLPhhNDicQqZWCCcWPFQ0idwzzpX3beX55Q/vzwBYK2FCE8hq
-FUiZReXIjVci0AMFK5Cl2vqFLPezAGvaZ4/M1reOF3vCgWl8IXTwYOs4EYd1CJt7
-bMwO9Q6P8V0BVhJO2tdwIe5XL5X086sMMPYXqMuwX9m3vZFQFpsZobmoAyYLVY+h
-IMoQZdh4O4sFYPQBPzhZXluFDl8rX6G5A9jUPxDfeVz+799RXi31jTYeH01OwM89
-/0BNryECgYEA15hU0qDAnM7fBiTTGbRUT/QPOmEUOPcnWfLWOyJsovAVLL1X0jmt
-GFm+FkTtOlcTVgDHXeHNw81zrgDDuW7fwaKloPeyWhyO6rp2jntAz/OayfA5UYOf
-REhXdQH7rMAkGgy1t7zKGHTYAslHjD2dOikCuHH/13otSJS4wNvTaZUCgYEA1x6L
-abxYDpR7jn2Yym0CbIiZ6tqShtqLi4eNF7PDVe3rUM7gYU767UFSKPvRpsq+BFwf
-LLRFgpggNRDrZWoK0ZekHD1x8pCJF+O4pj/Fhra4uI+hInycRQ4xsj9VU/WftxQ4
-aOojB28F0fBO56T90caQVSR09DGNmElSQFcw4psCgYApf8n8DTNmO6/UV+xGi16b
-UUhJHXyuBm0NtF+mXFb6+impRf0Mm0uFX2jmknfzfeVb7aRyns9jvD1jJgSGwh/R
-/wPQuz0aeVrNNf0yKels3eBStKnj1eknVKF5BVuzgfyxAvdLmcxw7rTRvHrINOf5
-1QEQDemISZ1D1lTF0sqcDQKBgCmE6rGAuZouzF4nHZtMSOB7yQFMKGXAvpgylGfT
-uUrXfch99U6yuLmcFuh0GfXQQbaDtTyimpvnEqhLWLOdMPNdCj6tGVYQ0XT77cKg
-olYq5CIzDo2icWLep3bYxHZM/QOP8odFUXd41S287O3GqXqYkXjtbWlIOyT+WdKz
-QWsrAoGALnac4Vh2s12Cv3YiQbkPtBRe8oxI0h6DEIdBciPDGq6WXq6O2PXXuBhM
-X47mObUsSuzI6hI4/vd4/tXD7TM3fS1YDdZXj7d51ZjT/jmlTVxAHa3DJ8i7o+rH
-Fqv/lh6MB6FGkXZ9vAGQe5RwUbDD16QO/1mz7fg0YBA9A8plM8s=
------END RSA PRIVATE KEY-----
+-----BEGIN PRIVATE KEY-----
+MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDQ30FctHHcfFv5
+ka4qLmFlptwNYMwR5Qa6ckYXWKPE71ds1ZfFiJHXbst7Z0yRLdN59TcI2KJglrt5
+HEw8BL/AZSnoFvsusKh4LcXVt8lJifMLpLCEyrrqbnVWGpy2MBsnEEEA9irI0EUH
+bDYFBk4iQoM0+A8lMM2YX/sb/mOYBo4+WGbUYhOdP6xJPJ+v8lyhFFtX1VNVz1VR
+pOOTrK0exb4rawr65auN2KCp3NkOeDSC1qxOf3TtCRMMPJHgT9Rj03jtoPYnLkXd
+cd6zL2QR+6mmr4DVZg6zz8dteAQvnedxrKoM0CCOeJ3mQe8on3BMA9IwOqa6kcbS
+XkAOKxqHAgMBAAECggEAB16eh28qcUrF/VPsNDrMtEcjOSmdfv14s6K34bepQkKQ
+8BsdLsVhzUXF0jB+iBojfbMZjQCvwf6vgKzEl9LcZ8+/Sca9zWjtmMfsqgdrsmI2
+psYvIDr9m1XoYpsFGnyEs2fPE1dG19eusn4D7et0svVr0bZK5SyypFoGmcyWUP/M
+kA990HAP7enGzPfpvcpr++Iu3EwWlTY3rjYgh9a7AiFhtj9zDzb9Sg0+4Xl9+8TZ
+dsOvyVsiLu09MZ3vScGg5l+46w+rai+R0IxpgI9QM0sMxAS3AYFY666akrJqn6NU
+S0Q5Q9gZ5V9hHxU7IHfo3weygPQuBW07nbwtX6+JCQKBgQDp7+smBlstRD+1/ZHJ
+KO4Xhi+yrhtkKzViC+gF2vXpZ1GQ+3plRJFzRMFu+LkBgn1jPfg479Tm7CM4W4vM
+cTZo45+hhnpwmLGnltTf3Vw23yXzLdUMenaE2u66PWh3DFPkPHwNqb30QGnx131Q
+Mjnp+2EsBdiZ1d8TFF815ucG7QKBgQDkkiz7I4JgGGCbd51AseFryHgUepsrgeaA
+DIWKEKBOoxOnfWH7JOxtm0oXcpWHLciQ4M6FaTFNv2vNA9Hrz5yApXFwIkKgXVU9
++zsok4eWdEYmwxZFwjCNYvzsIDGBBwa1PQeps6C5L+nciOE8IZHYW7egAR96prV3
+E4ZQ6aWkwwKBgQCL/nJXIAiiLyx9SVBb9C1/UGLs57ommKDqmrtv/ZeZ5KVwQL3/
+KihstaGYOinkmGVW5XfNAuECjB+Lk2U2pC1uWYFm1SYiiY4O/3lGup57i9CXFT9g
+p0yTtryUITmJvIvbksKeHo05RO7hthYczuHPfwqooJr9fHpxXYiYpiRtBQKBgCp0
+kFBRhyzsOj2GWTokEDfh85PyNhI9vZ+5M7CyZ+RTXBo3KtToRdYSCxAR435JXcCz
+UQjswhCr5o0dEYfYdzxZ/pkSdAevbl7l5FYkGQI0NLeMcv2gFT6dzVban/dUY8WU
+QXEfAVKEeM7SyetOXPWwC4p3yu4QOxKUGNW8oFzbAoGBAK3WKV51jhmMz3dtCkGW
+UZxcDp5q/3uV29/UUF3/CNEhLcVuQLtNOPYRG+S9zMvwo0SNsz4mZJH1nFDSWSNL
+xGXg/Ret9Li4JQTWD47kcheBCVLoTtX1bc66D2LlXDKzN5DRBACxKkAJPUjouhMB
+mPDd05msnfgzPBMHMwsNjg5W
+-----END PRIVATE KEY-----
diff --git a/dockers/stunnel/keys/client-cert.pem b/dockers/stunnel/keys/client-cert.pem
index 5c48eb8b3d..4db466a4f2 100644
--- a/dockers/stunnel/keys/client-cert.pem
+++ b/dockers/stunnel/keys/client-cert.pem
@@ -1,21 +1,17 @@
 -----BEGIN CERTIFICATE-----
-MIIDYDCCAkgCAQEwDQYJKoZIhvcNAQEFBQAwdTELMAkGA1UEBhMCQ0ExETAPBgNV
-BAgMCFdpbm5pcGVnMREwDwYDVQQHDAhNYW5pdG9iYTESMBAGA1UECgwJU29tZSBD
-b3JwMRYwFAYDVQQLDA1JVCBEZXBhcnRtZW50MRQwEgYDVQQDDAtleGFtcGxlLmNv
-bTAgFw0yMjAxMTIxNDU0MjFaGA8zMDIxMDUxNTE0NTQyMVowdTELMAkGA1UEBhMC
-Q0ExETAPBgNVBAgMCFdpbm5pcGVnMREwDwYDVQQHDAhNYW5pdG9iYTESMBAGA1UE
-CgwJU29tZSBDb3JwMRYwFAYDVQQLDA1JVCBEZXBhcnRtZW50MRQwEgYDVQQDDAtl
-eGFtcGxlLmNvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALwWezv2
-WHf6fCyiLYHmi3+Qf/33VmdNAapWzpOZ0Xmuzf8SSoEep/YotvnmIBe8DqspjzBW
-eeg+n7qre+qawGv1AOANlStLKeNvnXhWS0bdoAKMP68Q8jvU+YSmJNZTRkg/39MA
-YNqxYABYamoIQ7qX+g91HsCxPSzqIyjLwY4hPHGYfxGhRH5ne2RtsYEcMjOJWs8s
-U4x6wpwn9Y4vnG1AqpcwY4xm65g/52BWWM9WfZ++y17MynSdoE29EqXCAGqhh1i1
-IRlKN1vr/792VYzOm2fHScaaCaCmhDIlTw0TlOgnfi7CFtY0z6uizSwG4RWCW+3/
-g47T3q8aCnvlkCkCAwEAATANBgkqhkiG9w0BAQUFAAOCAQEAGuNzbKtvKsdfQaAV
-SmeNAZqyoG2Fbmh/txj6j+UThu3tadk07/SukgsM6yepeq05+wguW43eBtig/LzH
-pSHCn4s/w0fvu1GqePWsTdGI3xnJakZIlkOXPStIgZJNewT9rD6WoRfthvTOda8v
-NBjW0InACnVvzAivX9xhbUB4K/I8aEGaAZwzIGnQbsxygPVZKe/Y8oWhiks0qYo2
-Wev1Swli4EeqbYvg+3TMy7T1pDkjAmAdsv7yJAYKsM3xCu7K8vA/e+2J2hjUQIfI
-Thdjb6FNywihVaAK2BUqL6cMgF8I+nX7ywVOBAz+a3F00sSogapztinzqsjFDeT9
-5V/MSg==
+MIICpjCCAY4CAQEwDQYJKoZIhvcNAQELBQAwFjEUMBIGA1UEAwwLcmVkaXMtcHkt
+Y2EwIBcNMjQwNTA5MDcyMDE5WhgPMzAyMzA5MTAwNzIwMTlaMBoxGDAWBgNVBAMM
+D3JlZGlzLXB5LWNsaWVudDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB
+ALOL3znn2vpX8+VHOlETymeFpw8wsCeOfr9fNhK2o5APIG1NhrGjlu+T7ri/DfrM
+ZmjF+uDSuuUs044o5SFOECNi7yOwpdC9YVWSPQQ5VrsMENqyjIYyq2BC7fLHztAt
+VF1jg0D0zijfFg/4meG2tAOnXLa0O9WUcmwsNlxEgyFzcLvCoTaXpUJbLYJZ2IxW
+BoKgJ85acLlIFQIex053CqmgG/odM8Ib8s1YO+IXI4JsJlJFd9we+zYgZ2TRSZ8L
+v8A8gXM+WTBZpZXNXYv020dW22X7gu+VH4LHcg/6eF0GtkdrFdlQjCEjwGIoVFTu
+fNSp3NvSSYrK/qeJtSNaSw0CAwEAATANBgkqhkiG9w0BAQsFAAOCAQEAdA1QqJn/
+d4rcSO8z2L64d3SdO4wLf78Qznh3vTrIlQ/i0sESRQppw1U57PHSyYtAJzc1MV39
+zgn8KvuQToPQl9UoRWD6mVK8L//xplTPxWJB4BqD/kUc+lA9akBNU8Yhx7KbI5zX
+z4OgTIeWAtY9R5CH1xbQlVCqAAk+SdDk2raOebNQMpzJrMUdeDTrgoDaBFnHgDbb
+XHQCOF9/LrbBlrTlNJh6PHY8YztrJKdDDhSxJ9Tudz7ynUA+NcZ8dF5o/Co+QD5b
+gkVdz/nV8LoDeO8QjJXsgsHFD/B+ljWYeEGc5flFe6jWLGOCtgQB5JhImg9lsWFh
+X9i921F9Cqox3Q==
 -----END CERTIFICATE-----
diff --git a/dockers/stunnel/keys/client-key.pem b/dockers/stunnel/keys/client-key.pem
index 4117706d0e..a53cbce0f2 100644
--- a/dockers/stunnel/keys/client-key.pem
+++ b/dockers/stunnel/keys/client-key.pem
@@ -1,28 +1,28 @@
 -----BEGIN PRIVATE KEY-----
-MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQC8Fns79lh3+nws
-oi2B5ot/kH/991ZnTQGqVs6TmdF5rs3/EkqBHqf2KLb55iAXvA6rKY8wVnnoPp+6
-q3vqmsBr9QDgDZUrSynjb514VktG3aACjD+vEPI71PmEpiTWU0ZIP9/TAGDasWAA
-WGpqCEO6l/oPdR7AsT0s6iMoy8GOITxxmH8RoUR+Z3tkbbGBHDIziVrPLFOMesKc
-J/WOL5xtQKqXMGOMZuuYP+dgVljPVn2fvstezMp0naBNvRKlwgBqoYdYtSEZSjdb
-6/+/dlWMzptnx0nGmgmgpoQyJU8NE5ToJ34uwhbWNM+ros0sBuEVglvt/4OO096v
-Ggp75ZApAgMBAAECggEBAJDXLydJ2W7rMdydNzYld59Qg3/rjFoYbwPhvUrk1O9D
-sdaPG1i7ZtSlHeLrWCNu6kzcwCuVLGOwdgimLdLIQQ3hqj7fttOUGjnOphEZQvbb
-jHDp19DU1/VDWLLRzuRNVH4m0hIG5I8EsM0TST9GBgIXLrXgl0IEOvvvggvUfMUZ
-eGrrVsW56XIc25LZCalf20lcoyKa2hVjtlF2ds41PY6WqytkRJ7zpnBzO4g+Kz3D
-iA2rzNn/Ds2CCvuNDA8UF6qG/INbcySaq+qbSYLohWSsz9smIhkWUyF4YfbtziZr
-8AbxZKbS8VopSFxF+o35CbEZeTPkFkrBfbD0xUlCeEECgYEA6h1hLodTeQUpQoc3
-6brWvw1gM/tM0RyKbpOEwJGK1MnX99IM5z6qGY+d1htl7cB3RARpaY1HAvRXHhXt
-9qaSdhqR1hagZLn2vbelFkbJ0N1agdR6XYgGoxfH2RCluNfZZPOB6urfCLNbMjgb
-B1rkvIWiELCzujwsZ6m5sOomP70CgYEAzauggpcqEXQ4P4+y6B/8gOt7chuRczft
-1YTj2Y5tfZSTZmh01BUgenDgA1+NFJ9ni33P6+Ij/1D0ZGdea5Lqw2VP1ZDEIYSm
-j3ekkge/0AljZgIil2UviBhx5W2BlwnlukIwMvzVRwDulQsV3sDxprZKHYTaRcnC
-EB4Y9T6uUt0CgYBjeCojP8IaiDPYnWUHPKgjMoaub1Za/ppekvTzcKMg98V3+Noc
-okZZZ+iy4J81HfJOhuVWwHzsZ25gTQb3JhzSa0WNRb3OLikEwHM2/MqgoHvk76cx
-+CqBvwfdVTJkT+mA9+k6K6KpqrLTqnzpahgHdWu/VaR3OzvOq5FG9qVbrQKBgF5F
-xRUW5RmLBB1eaMstnjgZuEPdjxYZFNNCTo5yUo21hLr0NljgNjrpckUZjzlct8Gg
-saWVyppFKUC8gPMeLK3TynxCFySmARLR7IVjN/DL3NvtLp3mq5reWZaoUzZAOyTd
-Ieq9KaWaL8HxitzH4/xeoipVsxc6G9H3eckwKgehAoGBAM/E0qLpEXOaLxODY8tt
-+qpoNWHZn1M6cVX+tA/6igKfqUY96lefLmEiV1N01qW7+keFMXT12X/edsykG8jd
-gcNkNjSNwDSi8ixl0YlQwRJjX93TEip78sisQ3mCUqZUCNbm0Dm66Bqe8rAD5AdF
-G4oVbUu1gN0StX85Uw8J0AYS
+MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQCzi98559r6V/Pl
+RzpRE8pnhacPMLAnjn6/XzYStqOQDyBtTYaxo5bvk+64vw36zGZoxfrg0rrlLNOO
+KOUhThAjYu8jsKXQvWFVkj0EOVa7DBDasoyGMqtgQu3yx87QLVRdY4NA9M4o3xYP
++JnhtrQDp1y2tDvVlHJsLDZcRIMhc3C7wqE2l6VCWy2CWdiMVgaCoCfOWnC5SBUC
+HsdOdwqpoBv6HTPCG/LNWDviFyOCbCZSRXfcHvs2IGdk0UmfC7/APIFzPlkwWaWV
+zV2L9NtHVttl+4LvlR+Cx3IP+nhdBrZHaxXZUIwhI8BiKFRU7nzUqdzb0kmKyv6n
+ibUjWksNAgMBAAECggEAEelgSZyRwevITxU+AhyhUpaIxgErcabLijfrYw6JXrPD
+nmPfjhUt15TAefnFYUHG7ajikE81ietg54u44AuznHQgO0VCJYLfFPRT1foKZvqb
+K9YoIrMnWaETr+azAR2kjvSAgZhqgLVQtCMu5s+dQcgOfcOZPINkrtnySl4jXtDE
+SOTaj65VjSIkura17rj7nJNUPmDGFwsxwKpeEcXZTfa//ypT/hHVREkRmbSFk5Kw
+rf3T3O1pMVF8+SeacK/oyDUf3ISc8wn9Xmwgpv8I74xWtDy3kAs315tfWPMOHe4b
+CYk7GD1fu2rVRhtDCvkljiw2NejfeMzKt5+2wLXRmQKBgQD0KeCv8vdw6JBLH6PI
+72yE/GRkjAn4KfhmHK+1GZN6m49DV4XAYaA7T6u2Q3gn9gNsVsHC2FCsCHy63BpA
+I6ZJfdm2rcJkqgeKKRQpLBRedDMpQLY1WyXjugpV46KmA0ThtgtZeVKilJWvamHs
+t/TwSbf/humg0cIcamEnkKVawwKBgQC8QBS1pfMqlSodylbPG0VaJqgdF/yAthp6
+gunVqpgbTMqGLTCpKUfSgPMpzu8znaCNeZN0EK1p7qZ7VE1VHpVoyQHC9Eu8d6PF
+HAENaOUcUoCQNtXLoaN4waSjt7i6vYRldT/qrYB1YdpkkVKdj39w2N+uaxtZzDXu
+hHu0eixF7wKBgCR3TLN6mjImycYuh4uvFooWF/hcYfDKc+rsReHKXBhnu1HXdIZz
+DjdNgtvJ39w4BfLcUjwDiqjm65oM3W7O5Dr9rNJ3yRy3uECOOhCcIL6qpCl5HL2D
+S3ljg7+oK9aXjmYXhkJquEjH4EM+pDlykAaDPBPR1nrKWS9dQ/1gwRF5AoGAd+Uo
+S3jiIqDWLhsMpuNrjDtKnx0DyMYynwx5+YepUNnbsxFdCKAuCjfupxYQ6wLdmr1v
+2GA20l0Y0zuh9TCBYDeFU7Fb+zEHsSZg1TWVljBFiZQjHopYHzTVsx/0G5tQk33V
+s5XFVv13ps2XnJokRK8b5254AP067Cqczxlw0SkCgYEA0ito+l4TOa1/DnsbP1Q0
+kgeTb/9wPHpHVJ0Hz6vIXabaDlvvYwgRh151+9xzMmrs/0QCbI2+SHucAzu4RTjM
+MAiytSBQtXA+L9deNNU9QqPKsy6/Xq6SsKLRkL9kiUasiUE0v7c/T7L9D81nTFuS
+8htCfXw1/Tf8tLb+Rtvvwtw=
 -----END PRIVATE KEY-----
diff --git a/dockers/stunnel/keys/client-req.pem b/dockers/stunnel/keys/client-req.pem
index ecf83f4daa..62828e1950 100644
--- a/dockers/stunnel/keys/client-req.pem
+++ b/dockers/stunnel/keys/client-req.pem
@@ -1,17 +1,15 @@
 -----BEGIN CERTIFICATE REQUEST-----
-MIICujCCAaICAQAwdTELMAkGA1UEBhMCQ0ExETAPBgNVBAgMCFdpbm5pcGVnMREw
-DwYDVQQHDAhNYW5pdG9iYTESMBAGA1UECgwJU29tZSBDb3JwMRYwFAYDVQQLDA1J
-VCBEZXBhcnRtZW50MRQwEgYDVQQDDAtleGFtcGxlLmNvbTCCASIwDQYJKoZIhvcN
-AQEBBQADggEPADCCAQoCggEBALwWezv2WHf6fCyiLYHmi3+Qf/33VmdNAapWzpOZ
-0Xmuzf8SSoEep/YotvnmIBe8DqspjzBWeeg+n7qre+qawGv1AOANlStLKeNvnXhW
-S0bdoAKMP68Q8jvU+YSmJNZTRkg/39MAYNqxYABYamoIQ7qX+g91HsCxPSzqIyjL
-wY4hPHGYfxGhRH5ne2RtsYEcMjOJWs8sU4x6wpwn9Y4vnG1AqpcwY4xm65g/52BW
-WM9WfZ++y17MynSdoE29EqXCAGqhh1i1IRlKN1vr/792VYzOm2fHScaaCaCmhDIl
-Tw0TlOgnfi7CFtY0z6uizSwG4RWCW+3/g47T3q8aCnvlkCkCAwEAAaAAMA0GCSqG
-SIb3DQEBCwUAA4IBAQAqLgfkWWIE1RV1TENnr9jT+SK8u3F2nX4mUzNmy8azq52I
-fO8qPKmvV2amt5y961jNpR+rRpARncONuf6NQR5qCMu/EKjVi9BhOkoIOK0RjgtK
-AkCTON1J8022JDQpN5/H5ZpLDkIlBtpwDvEaR/PnTaJxtGwLY8HxY6h20PDjP3J9
-Xu3w3m/s3uVjFG07RDvbwK02vYskePnlsKVw+uu5C2blOQRlRVvdCCkwN0y6IiWW
-uRGRSzwufgejrfDUJG4VZuNpvWjFfzjHW105g1AxaTW3anRqBSNxYF+iawfbGdf4
-bGT4Wazbwq5uU3uixxOzxPMI5ZP/gn0ywz9S1RRK
+MIICXzCCAUcCAQAwGjEYMBYGA1UEAwwPcmVkaXMtcHktY2xpZW50MIIBIjANBgkq
+hkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAs4vfOefa+lfz5Uc6URPKZ4WnDzCwJ45+
+v182ErajkA8gbU2GsaOW75PuuL8N+sxmaMX64NK65SzTjijlIU4QI2LvI7Cl0L1h
+VZI9BDlWuwwQ2rKMhjKrYELt8sfO0C1UXWODQPTOKN8WD/iZ4ba0A6dctrQ71ZRy
+bCw2XESDIXNwu8KhNpelQlstglnYjFYGgqAnzlpwuUgVAh7HTncKqaAb+h0zwhvy
+zVg74hcjgmwmUkV33B77NiBnZNFJnwu/wDyBcz5ZMFmllc1di/TbR1bbZfuC75Uf
+gsdyD/p4XQa2R2sV2VCMISPAYihUVO581Knc29JJisr+p4m1I1pLDQIDAQABoAAw
+DQYJKoZIhvcNAQELBQADggEBAD3H8McA7SmTrswSp0lw1C1UFmtazhKbFYY3/+Ld
+ntZimzTy4Y5Ai1UW/blgwVLZxWWzazfkfWPMsRXtWcttuW/pxFGkLlyzFm4OsUQA
+hpxtUNlmEwzcYZAin3qNnCA9bQfGL/z+zUcuMuf6HGplAUhtPhTUnvGZ2B7rJ+aC
+syyt+/T/JJdnnnY0o4s4OzQa9ow6P7mC6egefHgLrtFbbuB4L/L/NdVj5NBzkXso
+kmHLTUwkEtKOiG4gFLRDXsgXCy+sfEEqqWapeFhOQdagENYg+LXSN0jpxGWeR1J/
+vZHMSJT4GK4SgyNpZFu5To2lf7ucw6ywCFfg6jH2EWQeCjk=
 -----END CERTIFICATE REQUEST-----
diff --git a/dockers/stunnel/keys/server-cert.pem b/dockers/stunnel/keys/server-cert.pem
index 3a1bf72011..c17bf9ca0f 100644
--- a/dockers/stunnel/keys/server-cert.pem
+++ b/dockers/stunnel/keys/server-cert.pem
@@ -1,21 +1,17 @@
 -----BEGIN CERTIFICATE-----
-MIIDYDCCAkgCAQEwDQYJKoZIhvcNAQEFBQAwdTELMAkGA1UEBhMCQ0ExETAPBgNV
-BAgMCFdpbm5pcGVnMREwDwYDVQQHDAhNYW5pdG9iYTESMBAGA1UECgwJU29tZSBD
-b3JwMRYwFAYDVQQLDA1JVCBEZXBhcnRtZW50MRQwEgYDVQQDDAtleGFtcGxlLmNv
-bTAgFw0yMjAxMTIxNDU0MjFaGA8zMDIxMDUxNTE0NTQyMVowdTELMAkGA1UEBhMC
-Q0ExETAPBgNVBAgMCFdpbm5pcGVnMREwDwYDVQQHDAhNYW5pdG9iYTESMBAGA1UE
-CgwJU29tZSBDb3JwMRYwFAYDVQQLDA1JVCBEZXBhcnRtZW50MRQwEgYDVQQDDAtl
-eGFtcGxlLmNvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMxZETTb
-dxqFsNjUIJbpS6ZT9RkH/dWYTVk1uRUMh6Cr6920g/7pSaRLIx8guTDHa1jhPIlX
-lax7oZyX9coLjhSc6cy0ZmoH0zrp8ZbRc/qOawuO62arKP89pO/18MB3r9zPb1PJ
-evTP203+2a8ly25cscMTUge+rHMFAUW+/01hc90CY9ial9oCl9wtoPdPGA8XlX3u
-RswOAM79fM+Szvv+bX0VvFakkfHIE8oIK5/rJYDswBKAshw5CjW/OEjD6FbCb84c
-1E7jJhwwd6X70yDMOrJ8iVkA/lpzfoosiuYm/okgbPPXWEo8aa//MrSH90l2+M9q
-Vvn8hbmwlJl+2IMCAwEAATANBgkqhkiG9w0BAQUFAAOCAQEAEcTps0CUnBZJBH/w
-8oJo8kAvsHhFTLJpTtiztut5qI+FMgC6sPcVUKi95gie2pdJ91y6sFzqLpghAciR
-ocYBy/jxK0M7OGJHLpUPeCS1yxeEyeZXpMPS90bUo1tPh7QDAojoRrFYo6M6DbL3
-dcErTJlvKnBBT9/DmENx75R+1nSB86vq0je+X0IqbZXeJyWju6ybjbwo1NPpnu+f
-jnXTG0+ZIsepms0VTXwcTy3dthIE+uw4XqTQ1qYg2stQAOUJ0nmb68NExi5zom5G
-0nh7tZnL0N+Z+XeNo7gaVatxfmgyk/HO2Vl4Wk4NA0PkR0yk2vNUwS0rKAb2mYc6
-T2gHdQ==
+MIICpjCCAY4CAQEwDQYJKoZIhvcNAQELBQAwFjEUMBIGA1UEAwwLcmVkaXMtcHkt
+Y2EwIBcNMjQwNTA5MDcyMDE5WhgPMzAyMzA5MTAwNzIwMTlaMBoxGDAWBgNVBAMM
+D3JlZGlzLXB5LXNlcnZlcjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB
+AOg14yTsgmakeSFuqtvy4fV1rcSgLiGdGKzOBsoytmCZzV++5Jljj7utSpJiYMYk
+HOTZtyqAVwmF/0yyZ25lbEHR/N3S3Jj/al4EG9u+K7O3eNZrTQkg4+ifwcT+V1Xo
+s6f+L6BRld4y78QVZwdEsTy4SIeSAwGygACymEWYZ6NZBgM2xgp8SInHYxHP3gXh
+02wioB79B62DExFVUKwUXjbUhPooyvGf9MMpUrmdFmQFfcosW/urCQF9YI6ZcPnr
+ybXJ6kiplmNKeVD4dEyQLYNp09alnT6q+pcJa+NwW6O0eyqEsHQxCJyo9ZA3IW5I
+SH+oftVxnZJIIPcsXABuH10CAwEAATANBgkqhkiG9w0BAQsFAAOCAQEAdWY0UeR4
+/9hpK3Mhl8VVz0zQwwEfnxCmI/TxpqNw+5lvpit/WvriIAEP9MToWHwYvG24zRrp
+zv/LDHNh8UtnX3GILGs0CY/oFDevAEU1tixbmFJPceuMwKsrMtkp/6NyWF4p62o2
+fiQK68l1HSGgaH7kJ6BKYgV4JQK3Fgk9J4KrejwmYXzCFKcEvNtKMG7i0WN+AmK2
+vnxxZ3xx4HPH3OJ5ss6T2gGlvjFnOS7Z0kHtbkzPzxaC9ZVqMySwPRggf84tUUdk
+vCwDHiJcbk5BMLug3yI9xTfSG3lMnwgZAWXMOqm/w6c1IIM8R/nKwNfwbG+4eUK0
+t2F8EBCShzAJGg==
 -----END CERTIFICATE-----
diff --git a/dockers/stunnel/keys/server-key.pem b/dockers/stunnel/keys/server-key.pem
index 62595e017c..8dd9a1e21a 100644
--- a/dockers/stunnel/keys/server-key.pem
+++ b/dockers/stunnel/keys/server-key.pem
@@ -1,28 +1,28 @@
 -----BEGIN PRIVATE KEY-----
-MIIEvwIBADANBgkqhkiG9w0BAQEFAASCBKkwggSlAgEAAoIBAQDMWRE023cahbDY
-1CCW6UumU/UZB/3VmE1ZNbkVDIegq+vdtIP+6UmkSyMfILkwx2tY4TyJV5Wse6Gc
-l/XKC44UnOnMtGZqB9M66fGW0XP6jmsLjutmqyj/PaTv9fDAd6/cz29TyXr0z9tN
-/tmvJctuXLHDE1IHvqxzBQFFvv9NYXPdAmPYmpfaApfcLaD3TxgPF5V97kbMDgDO
-/XzPks77/m19FbxWpJHxyBPKCCuf6yWA7MASgLIcOQo1vzhIw+hWwm/OHNRO4yYc
-MHel+9MgzDqyfIlZAP5ac36KLIrmJv6JIGzz11hKPGmv/zK0h/dJdvjPalb5/IW5
-sJSZftiDAgMBAAECggEAct5+daAIy7frOXfE+hAanl0DohaD8dWzZTp12Ac7Fm6O
-IAqhSGILK3exPoY+k9UF2uiCBxJc6KB2sHgbioAEVkH+izu9dkz/yFZJn+YNtALq
-2Yx1dzkvyor0dI9jzk15Zj6U7hyMKaHOPYHNDE/Kkzc4Fdh+fCwK9H0TwgkjqnLj
-hfRK32+SqaftkhZnCxaFfdVVzhonWsaB7VcyUPdIHAMG0xUQ9oNTM0WLPotU/uh0
-XDCemwXhkqfKaAlnj0YBsu65WOTTiPixOPigDe745CHFBXwvCF28kxjSbCAVlHIv
-JcTtq1EA+fNHRTeHgNGSpqOdfuVrBMyp3KiztLBfQQKBgQD47MFmQphXVQWRmKoU
-gCFf28notV8J0VGyG7E0tFMS3GgyAAl8H8I6fB9UYOmD95PrHTROxKpc7jYtZRW3
-KcYJP5zKa+DqSSks8I5dLwFkKYVC0GiEJWuRwS9aHaD7ja65NtXJO+2iZ598s39w
-iSx0OAvaf9cFUrsAmHAE84c+/QKBgQDSJ/VE1CS0Tv2kL5Wbr/RmgYBZbXHnRz6j
-LFA7JwX3seHtuo+WBe8BMOMS4YqW6K2YTqwU8NtN1oATWg72TcLhwJZ3sKGPiMhM
-/cHW0dJqYsXujIOd/dlSr+j9Mouoxm6Spl+hGpj2IPUV9Dlm8N4SqPk83m0O+8Hy
-P088HK7NfwKBgQC3D0XbMjZeY0RJIoBRuzjQCg6eeGOAENOHrB3RqJs/T5/AxY40
-Hhb0c7uGjg6s4jGBwmRpWPAAj56AG8qwfKQKwSFJK7SoF02UowPPO3ZGdtJtpF54
-cBx/gBaWqxtsY3GO++iUqOHFgXckeczKsdZjUaRF96XlYEXt1izrNzzK8QKBgQCP
-OsCE6nkhknx3/B5g/2j4u+Y4DMmGsR3VpAwCZLRCfq/WkEHwI5cjHqiEY8dK1sYJ
-egT6OLWetUSQ694qrBDYP6PNa0qRQs4Q+xmzSUm5TBxOWuIROcN2AYIvntVkb+lI
-da/TYwdBKHEhR1Qf/qW73gIQJB/8CEXEzrU36OySDQKBgQD35khRdiU+1bPt/DpW
-+8A+88BuxXMFxKYtEoMuTJnb7enarwp7+FtY6WhNgOgxELTpRbYw9496mOmNbJKL
-PmTXzs3aS5bv/2JTtc5+CHzf9PJ+jAYWnh9hCq9x/mA0QRMQAZEi8vhhYFaWiiV3
-wUYnDFnnAKia1VILt9jZ7I4T7Q==
+MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQDoNeMk7IJmpHkh
+bqrb8uH1da3EoC4hnRiszgbKMrZgmc1fvuSZY4+7rUqSYmDGJBzk2bcqgFcJhf9M
+smduZWxB0fzd0tyY/2peBBvbviuzt3jWa00JIOPon8HE/ldV6LOn/i+gUZXeMu/E
+FWcHRLE8uEiHkgMBsoAAsphFmGejWQYDNsYKfEiJx2MRz94F4dNsIqAe/QetgxMR
+VVCsFF421IT6KMrxn/TDKVK5nRZkBX3KLFv7qwkBfWCOmXD568m1yepIqZZjSnlQ
++HRMkC2DadPWpZ0+qvqXCWvjcFujtHsqhLB0MQicqPWQNyFuSEh/qH7VcZ2SSCD3
+LFwAbh9dAgMBAAECggEAI0llDgxeuIhP2/O8RRZAnhNW56VLvVHpGQFp6LoSGtXk
+bqNMi76kbemkhmAqwpFkTqaC/hNoporVQ+tsaktBSzNE0NSlLx7JJCZNsXPRokrE
+Mxk1KKj12TjFslDQJr7o5iNrS1p6gryM0OhLssAOiuKaKvfWOyDL8M8y8oh5X0ny
+1M6IAJMkbpwiWU2OHIH7irkS8fYyCeOz0JMovCwMPwYkovHD7uHKbV4qGKzdOKN1
+QD8qMWAF1lCv/57juuwpzulGY3sSyU7yRZMMxJQ7nbIRj5iuj6+e2m6JhVghIiYG
+IObIkGyubCr9QH315byiSS9ma1xzml3EqyM3XQkEhQKBgQDyxGY+60/dkUW9vAAm
+g20eVZnflhE8+ooEpX9VPIliL7ADy3HU2poV2oXif8pVauMvRaYla8BHIOPV2qGI
+tHTYNvubs6lxEq2Z7gM+8c5qOElXjup8Ch9/XCHXZavW8caWEcA9Z84Z4dCxbaku
+EhEL0SduCn7j1tU1+Z9jBs08ewKBgQD03i29kCUeCnW+zEo+aO2Spn6HpdyZkuzG
+2az5XurHGUFAgWYLOpShatjD4BY1GONvJTlD/gH2vqEkfY2OGgZ2pbjCFSfhIma/
+cnMuhsO2IlcuETqzlod1HGHcn6gGRM5LvYP343UIdv9nmJaT31nckueWv+yBd8HO
+kAx1W2boBwKBgBtM7tqgh8i474jYvYOXQAwrQDSeoa2j1yWSnvEs7541Eqw6ksCH
+HNDcVDYWfOCCNq44POj0ZxkYn8aK4aOH96Pg+waVe7aVjSREWeUYOEhFsCnCjqgI
+U2Z1K/EXI+32Hoj90gqVw92xQVDSrjXaHkSf7rk3QPHKVQvO2JfAShBFAoGAW5ic
+nZNE/ybEgrmicBQKAlh7bjxx95SJM50LYkDKK+3bhcihpkOkg3kXWrYBOJ11vga7
+lB55F5aZaq/4epZroog9Q4RsZX/b1XN3eIj6vq+70sSpI7KEOx+Bz+h9DtNAI/7h
+VaHlDmSNB3CBqxDaaXMeZDqouolUmvMxZdjp9pMCgYEA1Y7vhCvMZA62OJwFJ4X8
+9Xg7bPE3jZQ6Tj3FbVCMy+RQdlo8GzYeoNZDjhpSxjJe/1lyk//EBwVNs3E4rRNl
++GcaEOo0X/J7SkPFqM6aFITypIIGeJpFyz/S99i/5tkfsNt9BQtiTS+x1Kj1iREV
+bXIoNJRac5m/LLZKtDtHv18=
 -----END PRIVATE KEY-----
diff --git a/dockers/stunnel/keys/server-req.pem b/dockers/stunnel/keys/server-req.pem
index 361891d1c8..6d853693fb 100644
--- a/dockers/stunnel/keys/server-req.pem
+++ b/dockers/stunnel/keys/server-req.pem
@@ -1,17 +1,15 @@
 -----BEGIN CERTIFICATE REQUEST-----
-MIICujCCAaICAQAwdTELMAkGA1UEBhMCQ0ExETAPBgNVBAgMCFdpbm5pcGVnMREw
-DwYDVQQHDAhNYW5pdG9iYTESMBAGA1UECgwJU29tZSBDb3JwMRYwFAYDVQQLDA1J
-VCBEZXBhcnRtZW50MRQwEgYDVQQDDAtleGFtcGxlLmNvbTCCASIwDQYJKoZIhvcN
-AQEBBQADggEPADCCAQoCggEBAMxZETTbdxqFsNjUIJbpS6ZT9RkH/dWYTVk1uRUM
-h6Cr6920g/7pSaRLIx8guTDHa1jhPIlXlax7oZyX9coLjhSc6cy0ZmoH0zrp8ZbR
-c/qOawuO62arKP89pO/18MB3r9zPb1PJevTP203+2a8ly25cscMTUge+rHMFAUW+
-/01hc90CY9ial9oCl9wtoPdPGA8XlX3uRswOAM79fM+Szvv+bX0VvFakkfHIE8oI
-K5/rJYDswBKAshw5CjW/OEjD6FbCb84c1E7jJhwwd6X70yDMOrJ8iVkA/lpzfoos
-iuYm/okgbPPXWEo8aa//MrSH90l2+M9qVvn8hbmwlJl+2IMCAwEAAaAAMA0GCSqG
-SIb3DQEBCwUAA4IBAQCljqLOTU3tFEqxJ2AbZ5HVg9AN/SEUX8c/SyzCBii3r9Dj
-ubp0YWvYvgm7lnXsFAVDznf89RAzwdFur5iAQ95VfWBW6NEjdFQIh51KF6P/Qzjg
-TbctVeX/MTPuKewVhkQg9/sRmegbb+RBKEeCZccLUVuk5DAgFmi0cFP4e50uuNRG
-gwskG9nJp/X5aBd4Y1YKg8XS+WLPwwrYvffoHN8mWHh+YqF16MbxMHM5xRMWu6E7
-801EzEWAW5Y8J2ssp/9FSI+aXOhk68aNlIVNc2R6Rg1IA8zKV4WSWTMUWAud832h
-z9UZH/YkPgipuiflpKBGs5lbElRx3o6lYblhRL8J
+MIICXzCCAUcCAQAwGjEYMBYGA1UEAwwPcmVkaXMtcHktc2VydmVyMIIBIjANBgkq
+hkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA6DXjJOyCZqR5IW6q2/Lh9XWtxKAuIZ0Y
+rM4GyjK2YJnNX77kmWOPu61KkmJgxiQc5Nm3KoBXCYX/TLJnbmVsQdH83dLcmP9q
+XgQb274rs7d41mtNCSDj6J/BxP5XVeizp/4voFGV3jLvxBVnB0SxPLhIh5IDAbKA
+ALKYRZhno1kGAzbGCnxIicdjEc/eBeHTbCKgHv0HrYMTEVVQrBReNtSE+ijK8Z/0
+wylSuZ0WZAV9yixb+6sJAX1gjplw+evJtcnqSKmWY0p5UPh0TJAtg2nT1qWdPqr6
+lwlr43Bbo7R7KoSwdDEInKj1kDchbkhIf6h+1XGdkkgg9yxcAG4fXQIDAQABoAAw
+DQYJKoZIhvcNAQELBQADggEBAGMLI6jfG95L1Kqny8+Fl9sVnJ4ynb5905Hk9vXJ
+V/BVc3P6JS6c4qYSeFd6wihHC7/j2EC3wt55Sj6JzYKy93AEjBfDfBb2ZuB6VpPy
+iGKXzSGO71ziI2uzz92ltJhptNc6TNUUxwaBhOZiq2sxnLpnIcPZ/txDC75fGYEm
+9iSbeeHNNZTSqQyQOzKW0OL6ss+GHhlfJPzx6mSH5dvb6bpKB2SCG1aZaDuOQTl3
+8aDIo1Z/ug6BrqoDMCyRAZTDnTohhC96bbKLRMdm0g3wwDeoWuQy1q9s1/AUYfBm
+305LUYORBdFy08n41lFWo1JA4errzBhVTpHNKZ6DyQfMOxA=
 -----END CERTIFICATE REQUEST-----
diff --git a/docs/examples/ssl_connection_examples.ipynb b/docs/examples/ssl_connection_examples.ipynb
index a3d015619f..c94c4e0191 100644
--- a/docs/examples/ssl_connection_examples.ipynb
+++ b/docs/examples/ssl_connection_examples.ipynb
@@ -11,12 +11,12 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## Connecting to a Redis instance via SSL."
+    "## Connecting to a Redis instance via SSL"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 5,
+   "execution_count": null,
    "metadata": {},
    "outputs": [
     {
@@ -25,7 +25,7 @@
        "True"
       ]
      },
-     "execution_count": 5,
+     "execution_count": null,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -33,8 +33,13 @@
    "source": [
     "import redis\n",
     "\n",
-    "ssl_connection = redis.Redis(host='localhost', port=6666, ssl=True, ssl_cert_reqs=\"none\")\n",
-    "ssl_connection.ping()"
+    "r = redis.Redis(\n",
+    "    host='localhost', \n",
+    "    port=6666, \n",
+    "    ssl=True, \n",
+    "    ssl_cert_reqs=\"none\",\n",
+    ")\n",
+    "r.ping()"
    ]
   },
   {
@@ -48,39 +53,30 @@
    "cell_type": "code",
    "execution_count": null,
    "metadata": {},
-   "outputs": [],
-   "source": [
-    "import redis\n",
-    "url_connection = redis.from_url(\"redis://localhost:6379?ssl_cert_reqs=none&decode_responses=True&health_check_interval=2\")\n",
-    "url_connection.ping()"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "04e70233",
-   "metadata": {},
-   "source": [
-    "## Connecting to a Redis instance using ConnectionPool"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "2903de26",
-   "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": null,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "import redis\n",
-    "redis_pool = redis.ConnectionPool(host=\"localhost\", port=6666, connection_class=redis.SSLConnection)\n",
-    "ssl_connection = redis.StrictRedis(connection_pool=redis_pool) \n",
-    "ssl_connection.ping()"
+    "\n",
+    "r = redis.from_url(\"rediss://localhost:6666?ssl_cert_reqs=none&decode_responses=True&health_check_interval=2\")\n",
+    "r.ping()"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## Connecting to a Redis instance via SSL, while specifying a minimum TLS version"
+    "## Connecting to a Redis instance using a ConnectionPool"
    ]
   },
   {
@@ -94,34 +90,35 @@
        "True"
       ]
      },
-     "execution_count": 6,
+     "execution_count": null,
      "metadata": {},
      "output_type": "execute_result"
     }
    ],
    "source": [
     "import redis\n",
-    "import ssl\n",
     "\n",
-    "ssl_conn = redis.Redis(\n",
-    "    host=\"localhost\",\n",
-    "    port=6666,\n",
-    "    ssl=True,\n",
-    "    ssl_min_version=ssl.TLSVersion.TLSv1_3,\n",
+    "redis_pool = redis.ConnectionPool(\n",
+    "    host=\"localhost\", \n",
+    "    port=6666, \n",
+    "    connection_class=redis.SSLConnection, \n",
+    "    ssl_cert_reqs=\"none\",\n",
     ")\n",
-    "ssl_conn.ping()"
+    "\n",
+    "r = redis.StrictRedis(connection_pool=redis_pool) \n",
+    "r.ping()"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## Connecting to a Redis instance via SSL, while specifying a self-signed SSL certificate."
+    "## Connecting to a Redis instance via SSL, while specifying a minimum TLS version"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 6,
+   "execution_count": null,
    "metadata": {},
    "outputs": [
     {
@@ -130,42 +127,30 @@
        "True"
       ]
      },
-     "execution_count": 6,
+     "execution_count": null,
      "metadata": {},
      "output_type": "execute_result"
     }
    ],
    "source": [
-    "import os\n",
     "import redis\n",
+    "import ssl\n",
     "\n",
-    "ssl_certfile=\"some-certificate.pem\"\n",
-    "ssl_keyfile=\"some-key.pem\"\n",
-    "ssl_ca_certs=ssl_certfile\n",
-    "\n",
-    "ssl_cert_conn = redis.Redis(\n",
+    "r = redis.Redis(\n",
     "    host=\"localhost\",\n",
     "    port=6666,\n",
     "    ssl=True,\n",
-    "    ssl_certfile=ssl_certfile,\n",
-    "    ssl_keyfile=ssl_keyfile,\n",
-    "    ssl_cert_reqs=\"required\",\n",
-    "    ssl_ca_certs=ssl_ca_certs,\n",
+    "    ssl_min_version=ssl.TLSVersion.TLSv1_3,\n",
+    "    ssl_cert_reqs=\"none\",\n",
     ")\n",
-    "ssl_cert_conn.ping()"
+    "r.ping()"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## Connecting to a Redis instance via SSL, and validate the OCSP status of the certificate\n",
-    "\n",
-    "The redis package is design to be small, meaning extra libraries must be installed, in order to support OCSP stapling. As a result, first install redis via:\n",
-    "\n",
-    "*pip install redis[ocsp]*\n",
-    "\n",
-    "This will install cryptography, requests, and PyOpenSSL, none of which are generally required to use Redis."
+    "## Connecting to a Redis instance via SSL, while specifying a self-signed SSL CA certificate"
    ]
   },
   {
@@ -179,48 +164,42 @@
        "True"
       ]
      },
+     "execution_count": null,
      "metadata": {},
-     "output_type": "display_data"
+     "output_type": "execute_result"
     }
    ],
    "source": [
     "import os\n",
     "import redis\n",
     "\n",
-    "ssl_certfile=\"some-certificate.pem\"\n",
-    "ssl_keyfile=\"some-key.pem\"\n",
-    "ssl_ca_certs=ssl_certfile\n",
+    "pki_dir = os.path.join(\"..\", \"..\", \"dockers\", \"stunnel\", \"keys\")\n",
     "\n",
-    "ssl_cert_conn = redis.Redis(\n",
+    "r = redis.Redis(\n",
     "    host=\"localhost\",\n",
     "    port=6666,\n",
     "    ssl=True,\n",
-    "    ssl_certfile=ssl_certfile,\n",
-    "    ssl_keyfile=ssl_keyfile,\n",
+    "    ssl_certfile=os.path.join(pki_dir, \"client-cert.pem\"),\n",
+    "    ssl_keyfile=os.path.join(pki_dir, \"client-key.pem\"),\n",
     "    ssl_cert_reqs=\"required\",\n",
-    "    ssl_validate_ocsp=True\n",
+    "    ssl_ca_certs=os.path.join(pki_dir, \"ca-cert.pem\"),\n",
     ")\n",
-    "ssl_cert_conn.ping()"
+    "r.ping()"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## Connect via SSL, validate OCSP-stapled certificates\n",
+    "## Connecting to a Redis instance via SSL, and validate the OCSP status of the certificate\n",
     "\n",
-    "The redis package is design to be small, meaning extra libraries must be installed, in order to support OCSP stapling. As a result, first install redis via:\n",
+    "The redis package is designed to be small, meaning extra libraries must be installed, in order to support OCSP stapling. As a result, first install redis via:\n",
     "\n",
-    "*pip install redis[ocsp]*\n",
+    "`pip install redis[ocsp]`\n",
     "\n",
-    "This will install cryptography, requests, and PyOpenSSL, none of which are generally required to use Redis."
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "### Using a custom SSL context and validating against an expected certificate"
+    "This will install cryptography, requests, and PyOpenSSL, none of which are generally required to use Redis.\n",
+    "\n",
+    "In the next example, we will connect to a Redis instance via SSL, and validate the OCSP status of the certificate. However, the certificate we are using does not have an AIA extension, which means that the OCSP validation cannot be performed."
    ]
   },
   {
@@ -229,81 +208,88 @@
    "metadata": {},
    "outputs": [
     {
-     "data": {
-      "text/plain": [
-       "True"
-      ]
-     },
-     "metadata": {},
-     "output_type": "display_data"
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "OCSP validation failed as expected.\n"
+     ]
     }
    ],
    "source": [
+    "import os\n",
     "import redis\n",
-    "import OpenSSL\n",
-    "\n",
-    "ssl_certfile=\"some-certificate.pem\"\n",
-    "ssl_keyfile=\"some-key.pem\"\n",
-    "ssl_ca_certs=ssl_certfile\n",
-    "ssl_expected_certificate = \"expected-ocsp-certificate.pem\"\n",
     "\n",
-    "# PyOpenSSL is used only for the purpose of validating the ocsp\n",
-    "# stapled response\n",
-    "ctx = OpenSSL.SSL.Context(OpenSSL.SSL.SSLv23_METHOD)\n",
-    "ctx.use_certificate_file=ssl_certfile\n",
-    "ctx.use_privatekey_file=ssl_keyfile\n",
-    "expected_certificate = open(ssl_expected_certificate, 'rb').read()\n",
+    "pki_dir = os.path.join(\"..\", \"..\", \"dockers\", \"stunnel\", \"keys\")\n",
     "\n",
-    "ssl_cert_conn = redis.Redis(\n",
+    "r = redis.Redis(\n",
     "    host=\"localhost\",\n",
     "    port=6666,\n",
     "    ssl=True,\n",
-    "    ssl_certfile=ssl_certfile,\n",
-    "    ssl_keyfile=ssl_keyfile,\n",
+    "    ssl_certfile=os.path.join(pki_dir, \"client-cert.pem\"),\n",
+    "    ssl_keyfile=os.path.join(pki_dir, \"client-key.pem\"),\n",
     "    ssl_cert_reqs=\"required\",\n",
-    "    ssl_ocsp_context=ctx,\n",
-    "    ssl_ocsp_expected_cert=expected_certificate,\n",
+    "    ssl_ca_certs=os.path.join(pki_dir, \"ca-cert.pem\"),\n",
+    "    ssl_validate_ocsp=True,\n",
     ")\n",
-    "ssl_cert_conn.ping()"
+    "\n",
+    "try:\n",
+    "    r.ping()\n",
+    "except redis.ConnectionError as e:\n",
+    "    assert e.args[0] == \"No AIA information present in ssl certificate\"\n",
+    "    print(\"OCSP validation failed as expected.\")"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "### Naive validation of a stapled OCSP certificate"
+    "## Connect to a Redis instance via SSL, and validate OCSP-stapled certificates\n",
+    "\n",
+    "It is also possible to validate an OCSP stapled response. Again, for this example the server does not send an OCSP stapled response, so the validation will fail."
    ]
   },
   {
    "cell_type": "code",
    "execution_count": null,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "OCSP validation failed as expected.\n"
+     ]
+    }
+   ],
    "source": [
+    "import os\n",
     "import redis\n",
-    "import OpenSSL\n",
     "\n",
-    "ssl_certfile=\"some-certificate.pem\"\n",
-    "ssl_keyfile=\"some-key.pem\"\n",
-    "ssl_ca_certs=ssl_certfile\n",
-    "ssl_expected_certificate = \"expected-ocsp-certificate.pem\"\n",
+    "pki_dir = os.path.join(\"..\", \"..\", \"dockers\", \"stunnel\", \"keys\")\n",
+    "ca_cert = os.path.join(pki_dir, \"ca-cert.pem\")\n",
+    "\n",
+    "# It is possible to specify an expected certificate, or leave it out.\n",
+    "expected_certificate = open(ca_cert, 'rb').read()\n",
     "\n",
-    "# PyOpenSSL is used only for the purpose of validating the ocsp\n",
-    "# stapled response\n",
-    "ctx = OpenSSL.SSL.Context(OpenSSL.SSL.SSLv23_METHOD)\n",
-    "ctx.use_certificate_file=ssl_certfile\n",
-    "ctx.use_privatekey_file=ssl_keyfile\n",
+    "# If needed, a custom SSL context for OCSP can be specified via ssl_ocsp_context\n",
     "\n",
-    "ssl_cert_conn = redis.Redis(\n",
+    "r = redis.Redis(\n",
     "    host=\"localhost\",\n",
     "    port=6666,\n",
     "    ssl=True,\n",
-    "    ssl_certfile=ssl_certfile,\n",
-    "    ssl_keyfile=ssl_keyfile,\n",
+    "    ssl_certfile=os.path.join(pki_dir, \"client-cert.pem\"),\n",
+    "    ssl_keyfile=os.path.join(pki_dir, \"client-key.pem\"),\n",
     "    ssl_cert_reqs=\"required\",\n",
+    "    ssl_ca_certs=ca_cert,\n",
     "    ssl_validate_ocsp_stapled=True,\n",
+    "    ssl_ocsp_expected_cert=expected_certificate,\n",
     ")\n",
-    "ssl_cert_conn.ping()"
+    "\n",
+    "try:\n",
+    "    r.ping()\n",
+    "except redis.ConnectionError as e:\n",
+    "    assert e.args[0] == \"no ocsp response present\"\n",
+    "    print(\"OCSP validation failed as expected.\")"
    ]
   }
  ],
@@ -325,10 +311,9 @@
    "mimetype": "text/x-python",
    "name": "python",
    "nbconvert_exporter": "python",
-   "pygments_lexer": "ipython3",
-   "version": "3.8.12"
+   "pygments_lexer": "ipython3"
   }
  },
  "nbformat": 4,
- "nbformat_minor": 2
+ "nbformat_minor": 4
 }
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 04cd683c14..0d9510c64b 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -2895,8 +2895,9 @@ class TestSSL:
     appropriate port.
     """
 
-    SERVER_CERT = get_ssl_filename("server-cert.pem")
-    SERVER_KEY = get_ssl_filename("server-key.pem")
+    CA_CERT = get_ssl_filename("ca-cert.pem")
+    CLIENT_CERT = get_ssl_filename("client-cert.pem")
+    CLIENT_KEY = get_ssl_filename("client-key.pem")
 
     @pytest_asyncio.fixture()
     def create_client(self, request: FixtureRequest) -> Callable[..., RedisCluster]:
@@ -3020,24 +3021,24 @@ async def test_validating_self_signed_certificate(
     ) -> None:
         async with await create_client(
             ssl=True,
-            ssl_ca_certs=self.SERVER_CERT,
+            ssl_ca_certs=self.CA_CERT,
             ssl_cert_reqs="required",
-            ssl_certfile=self.SERVER_CERT,
-            ssl_keyfile=self.SERVER_KEY,
+            ssl_certfile=self.CLIENT_CERT,
+            ssl_keyfile=self.CLIENT_KEY,
         ) as rc:
             assert await rc.ping()
 
     async def test_validating_self_signed_string_certificate(
         self, create_client: Callable[..., Awaitable[RedisCluster]]
     ) -> None:
-        with open(self.SERVER_CERT) as f:
+        with open(self.CA_CERT) as f:
             cert_data = f.read()
 
         async with await create_client(
             ssl=True,
             ssl_ca_data=cert_data,
             ssl_cert_reqs="required",
-            ssl_certfile=self.SERVER_CERT,
-            ssl_keyfile=self.SERVER_KEY,
+            ssl_certfile=self.CLIENT_CERT,
+            ssl_keyfile=self.CLIENT_KEY,
         ) as rc:
             assert await rc.ping()
diff --git a/tests/test_asyncio/test_connect.py b/tests/test_asyncio/test_connect.py
index 6c902c2d05..0df7ebb43a 100644
--- a/tests/test_asyncio/test_connect.py
+++ b/tests/test_asyncio/test_connect.py
@@ -61,13 +61,14 @@ async def test_uds_connect(uds_address):
 )
 async def test_tcp_ssl_tls12_custom_ciphers(tcp_address, ssl_ciphers):
     host, port = tcp_address
-    certfile = get_ssl_filename("server-cert.pem")
-    keyfile = get_ssl_filename("server-key.pem")
+    certfile = get_ssl_filename("client-cert.pem")
+    keyfile = get_ssl_filename("client-key.pem")
+    ca_certfile = get_ssl_filename("ca-cert.pem")
     conn = SSLConnection(
         host=host,
         port=port,
         client_name=_CLIENT_NAME,
-        ssl_ca_certs=certfile,
+        ssl_ca_certs=ca_certfile,
         socket_timeout=10,
         ssl_min_version=ssl.TLSVersion.TLSv1_2,
         ssl_ciphers=ssl_ciphers,
@@ -89,13 +90,14 @@ async def test_tcp_ssl_tls12_custom_ciphers(tcp_address, ssl_ciphers):
 )
 async def test_tcp_ssl_connect(tcp_address, ssl_min_version):
     host, port = tcp_address
-    certfile = get_ssl_filename("server-cert.pem")
-    keyfile = get_ssl_filename("server-key.pem")
+    certfile = get_ssl_filename("client-cert.pem")
+    keyfile = get_ssl_filename("client-key.pem")
+    ca_certfile = get_ssl_filename("ca-cert.pem")
     conn = SSLConnection(
         host=host,
         port=port,
         client_name=_CLIENT_NAME,
-        ssl_ca_certs=certfile,
+        ssl_ca_certs=ca_certfile,
         socket_timeout=10,
         ssl_min_version=ssl_min_version,
     )
diff --git a/tests/test_connect.py b/tests/test_connect.py
index fcc1a05268..71986dd8f3 100644
--- a/tests/test_connect.py
+++ b/tests/test_connect.py
@@ -58,13 +58,14 @@ def test_uds_connect(uds_address):
 )
 def test_tcp_ssl_connect(tcp_address, ssl_min_version):
     host, port = tcp_address
-    certfile = get_ssl_filename("server-cert.pem")
-    keyfile = get_ssl_filename("server-key.pem")
+    certfile = get_ssl_filename("client-cert.pem")
+    keyfile = get_ssl_filename("client-key.pem")
+    ca_certfile = get_ssl_filename("ca-cert.pem")
     conn = SSLConnection(
         host=host,
         port=port,
         client_name=_CLIENT_NAME,
-        ssl_ca_certs=certfile,
+        ssl_ca_certs=ca_certfile,
         socket_timeout=10,
         ssl_min_version=ssl_min_version,
     )
@@ -82,13 +83,14 @@ def test_tcp_ssl_connect(tcp_address, ssl_min_version):
 )
 def test_tcp_ssl_tls12_custom_ciphers(tcp_address, ssl_ciphers):
     host, port = tcp_address
-    certfile = get_ssl_filename("server-cert.pem")
-    keyfile = get_ssl_filename("server-key.pem")
+    certfile = get_ssl_filename("client-cert.pem")
+    keyfile = get_ssl_filename("client-key.pem")
+    ca_certfile = get_ssl_filename("ca-cert.pem")
     conn = SSLConnection(
         host=host,
         port=port,
         client_name=_CLIENT_NAME,
-        ssl_ca_certs=certfile,
+        ssl_ca_certs=ca_certfile,
         socket_timeout=10,
         ssl_min_version=ssl.TLSVersion.TLSv1_2,
         ssl_ciphers=ssl_ciphers,
diff --git a/tests/test_ssl.py b/tests/test_ssl.py
index fd6fa51db7..fc7416dbc7 100644
--- a/tests/test_ssl.py
+++ b/tests/test_ssl.py
@@ -18,8 +18,10 @@ class TestSSL:
     and connecting to the appropriate port.
     """
 
+    CA_CERT = get_ssl_filename("ca-cert.pem")
+    CLIENT_CERT = get_ssl_filename("client-cert.pem")
+    CLIENT_KEY = get_ssl_filename("client-key.pem")
     SERVER_CERT = get_ssl_filename("server-cert.pem")
-    SERVER_KEY = get_ssl_filename("server-key.pem")
 
     def test_ssl_with_invalid_cert(self, request):
         ssl_url = request.config.option.redis_ssl_url
@@ -53,16 +55,16 @@ def test_validating_self_signed_certificate(self, request):
             host=p[0],
             port=p[1],
             ssl=True,
-            ssl_certfile=self.SERVER_CERT,
-            ssl_keyfile=self.SERVER_KEY,
+            ssl_certfile=self.CLIENT_CERT,
+            ssl_keyfile=self.CLIENT_KEY,
             ssl_cert_reqs="required",
-            ssl_ca_certs=self.SERVER_CERT,
+            ssl_ca_certs=self.CA_CERT,
         )
         assert r.ping()
         r.close()
 
     def test_validating_self_signed_string_certificate(self, request):
-        with open(self.SERVER_CERT) as f:
+        with open(self.CA_CERT) as f:
             cert_data = f.read()
         ssl_url = request.config.option.redis_ssl_url
         p = urlparse(ssl_url)[1].split(":")
@@ -70,8 +72,8 @@ def test_validating_self_signed_string_certificate(self, request):
             host=p[0],
             port=p[1],
             ssl=True,
-            ssl_certfile=self.SERVER_CERT,
-            ssl_keyfile=self.SERVER_KEY,
+            ssl_certfile=self.CLIENT_CERT,
+            ssl_keyfile=self.CLIENT_KEY,
             ssl_cert_reqs="required",
             ssl_ca_data=cert_data,
         )
@@ -147,10 +149,10 @@ def _create_oscp_conn(self, request):
             host=p[0],
             port=p[1],
             ssl=True,
-            ssl_certfile=self.SERVER_CERT,
-            ssl_keyfile=self.SERVER_KEY,
+            ssl_certfile=self.CLIENT_CERT,
+            ssl_keyfile=self.CLIENT_KEY,
             ssl_cert_reqs="required",
-            ssl_ca_certs=self.SERVER_CERT,
+            ssl_ca_certs=self.CA_CERT,
             ssl_validate_ocsp=True,
         )
         return r
@@ -171,14 +173,6 @@ def test_ssl_ocsp_called_withcrypto(self, request):
         assert "No AIA information present in ssl certificate" in str(e)
         r.close()
 
-        # rediss://, url based
-        ssl_url = request.config.option.redis_ssl_url
-        sslclient = redis.from_url(ssl_url)
-        with pytest.raises(ConnectionError) as e:
-            sslclient.ping()
-        assert "No AIA information present in ssl certificate" in str(e)
-        sslclient.close()
-
     @skip_if_nocryptography()
     def test_valid_ocsp_cert_http(self):
         from redis.ocsp import OCSPVerifier
@@ -253,10 +247,10 @@ def test_mock_ocsp_staple(self, request):
             host=p[0],
             port=p[1],
             ssl=True,
-            ssl_certfile=self.SERVER_CERT,
-            ssl_keyfile=self.SERVER_KEY,
+            ssl_certfile=self.CLIENT_CERT,
+            ssl_keyfile=self.CLIENT_KEY,
             ssl_cert_reqs="required",
-            ssl_ca_certs=self.SERVER_CERT,
+            ssl_ca_certs=self.CA_CERT,
             ssl_validate_ocsp=True,
             ssl_ocsp_context=p,  # just needs to not be none
         )
@@ -266,19 +260,19 @@ def test_mock_ocsp_staple(self, request):
         r.close()
 
         ctx = OpenSSL.SSL.Context(OpenSSL.SSL.SSLv23_METHOD)
-        ctx.use_certificate_file(self.SERVER_CERT)
-        ctx.use_privatekey_file(self.SERVER_KEY)
+        ctx.use_certificate_file(self.CLIENT_CERT)
+        ctx.use_privatekey_file(self.CLIENT_KEY)
 
         r = redis.Redis(
             host=p[0],
             port=p[1],
             ssl=True,
-            ssl_certfile=self.SERVER_CERT,
-            ssl_keyfile=self.SERVER_KEY,
+            ssl_certfile=self.CLIENT_CERT,
+            ssl_keyfile=self.CLIENT_KEY,
             ssl_cert_reqs="required",
-            ssl_ca_certs=self.SERVER_CERT,
+            ssl_ca_certs=self.CA_CERT,
             ssl_ocsp_context=ctx,
-            ssl_ocsp_expected_cert=open(self.SERVER_KEY, "rb").read(),
+            ssl_ocsp_expected_cert=open(self.SERVER_CERT, "rb").read(),
             ssl_validate_ocsp_stapled=True,
         )
 
@@ -291,10 +285,10 @@ def test_mock_ocsp_staple(self, request):
             host=p[0],
             port=p[1],
             ssl=True,
-            ssl_certfile=self.SERVER_CERT,
-            ssl_keyfile=self.SERVER_KEY,
+            ssl_certfile=self.CLIENT_CERT,
+            ssl_keyfile=self.CLIENT_KEY,
             ssl_cert_reqs="required",
-            ssl_ca_certs=self.SERVER_CERT,
+            ssl_ca_certs=self.CA_CERT,
             ssl_validate_ocsp_stapled=True,
         )
 

From 0b2008701d9187f2b128542322ca833d62619a45 Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@gmail.com>
Date: Wed, 15 May 2024 15:41:47 +0300
Subject: [PATCH 0873/1164] Document XREAD of last message (+) (#3188)

XREAD now supports reading the last message in the stream, with the +
special Id. The code already supports this, so just add some
documentation to an existing Jupyter notebook.

Fixes #3155

Co-authored-by: Gabriel Erzse <gabriel.erzse@redis.com>
---
 docs/examples/redis-stream-example.ipynb | 102 +++++++++++++++--------
 1 file changed, 65 insertions(+), 37 deletions(-)

diff --git a/docs/examples/redis-stream-example.ipynb b/docs/examples/redis-stream-example.ipynb
index eb1f2e9a20..60f4ddd3d3 100644
--- a/docs/examples/redis-stream-example.ipynb
+++ b/docs/examples/redis-stream-example.ipynb
@@ -108,7 +108,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "[[b'skey', [(b'1657571033115-0', {b'ts': b'1657571033.1128936', b'v': b'0'}), (b'1657571033117-0', {b'ts': b'1657571033.1176307', b'v': b'1'})]]]\n"
+      "[[b'skey', [(b'1710790167982-0', {b'ts': b'1710790167.9824948', b'v': b'0'}), (b'1710790167983-0', {b'ts': b'1710790167.9830241', b'v': b'1'})]]]\n"
      ]
     }
    ],
@@ -135,8 +135,8 @@
      "output_type": "stream",
      "text": [
       "got data from stream: b'skey'\n",
-      "id: b'1657571033115-0' value: b'0'\n",
-      "id: b'1657571033117-0' value: b'1'\n"
+      "id: b'1710790167982-0' value: b'0'\n",
+      "id: b'1710790167983-0' value: b'1'\n"
      ]
     }
    ],
@@ -165,8 +165,8 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "id: b'1657571033115-0' value: b'0'\n",
-      "id: b'1657571033117-0' value: b'1'\n"
+      "id: b'1710790167982-0' value: b'0'\n",
+      "id: b'1710790167983-0' value: b'1'\n"
      ]
     }
    ],
@@ -192,8 +192,8 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "id: b'1657571033118-0' value: b'2'\n",
-      "id: b'1657571033119-0' value: b'3'\n"
+      "id: b'1710790167983-1' value: b'2'\n",
+      "id: b'1710790167983-2' value: b'3'\n"
      ]
     }
    ],
@@ -213,8 +213,8 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "id: b'1657571033119-1' value: b'4'\n",
-      "id: b'1657571033121-0' value: b'5'\n"
+      "id: b'1710790167983-3' value: b'4'\n",
+      "id: b'1710790167983-4' value: b'5'\n"
      ]
     }
    ],
@@ -255,6 +255,34 @@
     "print( f\"stream length: {r.xlen( stream_key )}\")"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "source": [
+    "to get the last entry in the stream"
+   ],
+   "metadata": {}
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[[b'skey', [(b'1710790167984-0', {b'ts': b'1710790167.9839962', b'v': b'9'})]]]\n",
+      "stream length: 10\n"
+     ]
+    }
+   ],
+   "source": [
+    "# read the last available message\n",
+    "l = r.xread( count=1, streams={stream_key: '+'} )\n",
+    "print(l)\n",
+    "print( f\"stream length: {r.xlen( stream_key )}\")"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},
@@ -298,8 +326,8 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "got from b'skey' the entry [(b'1657571033115-0', {b'ts': b'1657571033.1128936', b'v': b'0'})]\n",
-      "got from b's2key' the entry [(b'1657571042111-0', {b'v': b'1000'})]\n"
+      "got from b'skey' the entry [(b'1710790167982-0', {b'ts': b'1710790167.9824948', b'v': b'0'})]\n",
+      "got from b's2key' the entry [(b'1710790173142-0', {b'v': b'1000'})]\n"
      ]
     }
    ],
@@ -425,8 +453,8 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "got element b'1657571033115-0'from stream b'skey'\n",
-      "got element b'1657571033117-0'from stream b'skey'\n"
+      "got element b'1710790167982-0'from stream b'skey'\n",
+      "got element b'1710790167983-0'from stream b'skey'\n"
      ]
     }
    ],
@@ -453,8 +481,8 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "got element b'1657571033118-0'from stream b'skey'\n",
-      "got element b'1657571033119-0'from stream b'skey'\n"
+      "got element b'1710790167983-1'from stream b'skey'\n",
+      "got element b'1710790167983-2'from stream b'skey'\n"
      ]
     }
    ],
@@ -484,10 +512,10 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "got element b'1657571033115-0'from stream b'skey'\n",
-      "got element b'1657571033117-0'from stream b'skey'\n",
-      "got element b'1657571042111-0'from stream b's2key'\n",
-      "got element b'1657571042113-0'from stream b's2key'\n"
+      "got element b'1710790167982-0'from stream b'skey'\n",
+      "got element b'1710790167983-0'from stream b'skey'\n",
+      "got element b'1710790173142-0'from stream b's2key'\n",
+      "got element b'1710790173143-0'from stream b's2key'\n"
      ]
     }
    ],
@@ -546,8 +574,8 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "got element b'1657571033118-0'from stream b'skey'\n",
-      "got element b'1657571033119-0'from stream b'skey'\n"
+      "got element b'1710790167983-1'from stream b'skey'\n",
+      "got element b'1710790167983-2'from stream b'skey'\n"
      ]
     }
    ],
@@ -593,22 +621,22 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "got element b'1657571033119-1'from stream b'skey'\n",
-      "got element b'1657571033121-0'from stream b'skey'\n",
-      "got element b'1657571033121-1'from stream b'skey'\n",
-      "got element b'1657571033121-2'from stream b'skey'\n",
-      "got element b'1657571033122-0'from stream b'skey'\n",
-      "got element b'1657571033122-1'from stream b'skey'\n",
-      "got element b'1657571049557-0'from stream b'skey'\n",
-      "got element b'1657571049557-1'from stream b'skey'\n",
-      "got element b'1657571049558-0'from stream b'skey'\n",
-      "got element b'1657571049559-0'from stream b'skey'\n",
-      "got element b'1657571049559-1'from stream b'skey'\n",
-      "got element b'1657571049559-2'from stream b'skey'\n",
-      "got element b'1657571049560-0'from stream b'skey'\n",
-      "got element b'1657571049562-0'from stream b'skey'\n",
-      "got element b'1657571049563-0'from stream b'skey'\n",
-      "got element b'1657571049563-1'from stream b'skey'\n",
+      "got element b'1710790167983-3'from stream b'skey'\n",
+      "got element b'1710790167983-4'from stream b'skey'\n",
+      "got element b'1710790167983-5'from stream b'skey'\n",
+      "got element b'1710790167983-6'from stream b'skey'\n",
+      "got element b'1710790167983-7'from stream b'skey'\n",
+      "got element b'1710790167984-0'from stream b'skey'\n",
+      "got element b'1710790173157-0'from stream b'skey'\n",
+      "got element b'1710790173158-0'from stream b'skey'\n",
+      "got element b'1710790173158-1'from stream b'skey'\n",
+      "got element b'1710790173158-2'from stream b'skey'\n",
+      "got element b'1710790173158-3'from stream b'skey'\n",
+      "got element b'1710790173158-4'from stream b'skey'\n",
+      "got element b'1710790173158-5'from stream b'skey'\n",
+      "got element b'1710790173159-0'from stream b'skey'\n",
+      "got element b'1710790173159-1'from stream b'skey'\n",
+      "got element b'1710790173159-2'from stream b'skey'\n",
       "2 pending messages on 'skey' for group 'grp1'\n"
      ]
     }

From 6751de20a0cad597a2a024cdae2a1518ea1b1580 Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@gmail.com>
Date: Wed, 15 May 2024 16:50:11 +0300
Subject: [PATCH 0874/1164] Streamline documentation style (#3232)

Adopt the Google docstrings style as the preferred way to document code.
Update one of the existing docstrings to the new format, to showcase how
it would look like.

Enable the `napoleon` preprocessor in Sphinx, to be able to process
Google style docstrings.

Take the opportunity to make the copyright year dynamic, so we don't
have to manually keep it up to date.

Add a section about documentation to the contributors guide.

---------

Co-authored-by: Gabriel Erzse <gabriel.erzse@redis.com>
---
 .github/wordlist.txt   |   2 +
 CONTRIBUTING.md        |  13 +++++
 docs/conf.py           |  12 +++--
 redis/commands/core.py | 109 ++++++++++++++++++-----------------------
 4 files changed, 73 insertions(+), 63 deletions(-)

diff --git a/.github/wordlist.txt b/.github/wordlist.txt
index 22ae767e46..540e915277 100644
--- a/.github/wordlist.txt
+++ b/.github/wordlist.txt
@@ -74,6 +74,8 @@ bysource
 charset
 del
 dev
+docstring
+docstrings
 eg
 exc
 firsttimersonly
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 4da55c737c..d87e6ba1c3 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -81,6 +81,19 @@ using `invoke standalone-tests`; similarly, RedisCluster tests can be run by usi
 Each run of tests starts and stops the various dockers required. Sometimes
 things get stuck, an `invoke clean` can help.
 
+## Documentation
+
+If relevant, update the code documentation, via docstrings, or in `/docs`.
+
+You can check how the documentation looks locally by running `invoke build-docs`
+and loading the generated HTML files in a browser.
+
+Historically there is a mix of styles in the docstrings, but the preferred way
+of documenting code is by applying the
+[Google style](https://sphinxcontrib-napoleon.readthedocs.io/en/latest/example_google.html).
+Type hints should be added according to PEP484, and should not be repeated in
+the docstrings.
+
 ### Docker Tips
 
 Following are a few tips that can help you work with the Docker-based
diff --git a/docs/conf.py b/docs/conf.py
index a201da2fc0..33a8589654 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -10,6 +10,7 @@
 # All configuration values have a default; values that are commented out
 # serve to show the default.
 
+import datetime
 import os
 import sys
 
@@ -30,12 +31,15 @@
     "nbsphinx",
     "sphinx_gallery.load_style",
     "sphinx.ext.autodoc",
-    "sphinx_autodoc_typehints",
-    "sphinx.ext.doctest",
     "sphinx.ext.viewcode",
     "sphinx.ext.autosectionlabel",
+    "sphinx.ext.napoleon",
 ]
 
+# Napoleon settings. We only accept Google-style docstrings.
+napoleon_google_docstring = True
+napoleon_numpy_docstring = False
+
 # AutosectionLabel settings.
 # Uses a <page>:<label> schema which doesn't work for duplicate sub-section
 # labels, so set max depth.
@@ -43,6 +47,7 @@
 autosectionlabel_maxdepth = 2
 
 # AutodocTypehints settings.
+autodoc_typehints = 'description'
 always_document_param_types = True
 typehints_defaults = "comma"
 
@@ -60,7 +65,8 @@
 
 # General information about the project.
 project = "redis-py"
-copyright = "2023, Redis Inc"
+current_year = datetime.datetime.now().year
+copyright = f"{current_year}, Redis Inc"
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 45ccf5be4d..0656fd8136 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -199,69 +199,58 @@ def acl_setuser(
         """
         Create or update an ACL user.
 
-        Create or update the ACL for ``username``. If the user already exists,
+        Create or update the ACL for `username`. If the user already exists,
         the existing ACL is completely overwritten and replaced with the
         specified values.
 
-        ``enabled`` is a boolean indicating whether the user should be allowed
-        to authenticate or not. Defaults to ``False``.
-
-        ``nopass`` is a boolean indicating whether the can authenticate without
-        a password. This cannot be True if ``passwords`` are also specified.
-
-        ``passwords`` if specified is a list of plain text passwords
-        to add to or remove from the user. Each password must be prefixed with
-        a '+' to add or a '-' to remove. For convenience, the value of
-        ``passwords`` can be a simple prefixed string when adding or
-        removing a single password.
-
-        ``hashed_passwords`` if specified is a list of SHA-256 hashed passwords
-        to add to or remove from the user. Each hashed password must be
-        prefixed with a '+' to add or a '-' to remove. For convenience,
-        the value of ``hashed_passwords`` can be a simple prefixed string when
-        adding or removing a single password.
-
-        ``categories`` if specified is a list of strings representing category
-        permissions. Each string must be prefixed with either a '+' to add the
-        category permission or a '-' to remove the category permission.
-
-        ``commands`` if specified is a list of strings representing command
-        permissions. Each string must be prefixed with either a '+' to add the
-        command permission or a '-' to remove the command permission.
-
-        ``keys`` if specified is a list of key patterns to grant the user
-        access to. Keys patterns allow '*' to support wildcard matching. For
-        example, '*' grants access to all keys while 'cache:*' grants access
-        to all keys that are prefixed with 'cache:'. ``keys`` should not be
-        prefixed with a '~'.
-
-        ``reset`` is a boolean indicating whether the user should be fully
-        reset prior to applying the new ACL. Setting this to True will
-        remove all existing passwords, flags and privileges from the user and
-        then apply the specified rules. If this is False, the user's existing
-        passwords, flags and privileges will be kept and any new specified
-        rules will be applied on top.
-
-        ``reset_keys`` is a boolean indicating whether the user's key
-        permissions should be reset prior to applying any new key permissions
-        specified in ``keys``. If this is False, the user's existing
-        key permissions will be kept and any new specified key permissions
-        will be applied on top.
-
-        ``reset_channels`` is a boolean indicating whether the user's channel
-        permissions should be reset prior to applying any new channel permissions
-        specified in ``channels``.If this is False, the user's existing
-        channel permissions will be kept and any new specified channel permissions
-        will be applied on top.
-
-        ``reset_passwords`` is a boolean indicating whether to remove all
-        existing passwords and the 'nopass' flag from the user prior to
-        applying any new passwords specified in 'passwords' or
-        'hashed_passwords'. If this is False, the user's existing passwords
-        and 'nopass' status will be kept and any new specified passwords
-        or hashed_passwords will be applied on top.
-
-        For more information see https://redis.io/commands/acl-setuser
+        For more information, see https://redis.io/commands/acl-setuser
+
+        Args:
+            username: The name of the user whose ACL is to be created or updated.
+            enabled: Indicates whether the user should be allowed to authenticate.
+                     Defaults to `False`.
+            nopass: Indicates whether the user can authenticate without a password.
+                    This cannot be `True` if `passwords` are also specified.
+            passwords: A list of plain text passwords to add to or remove from the user.
+                       Each password must be prefixed with a '+' to add or a '-' to
+                       remove. For convenience, a single prefixed string can be used
+                       when adding or removing a single password.
+            hashed_passwords: A list of SHA-256 hashed passwords to add to or remove
+                              from the user. Each hashed password must be prefixed with
+                              a '+' to add or a '-' to remove. For convenience, a single
+                              prefixed string can be used when adding or removing a
+                              single password.
+            categories: A list of strings representing category permissions. Each string
+                        must be prefixed with either a '+' to add the category
+                        permission or a '-' to remove the category permission.
+            commands: A list of strings representing command permissions. Each string
+                      must be prefixed with either a '+' to add the command permission
+                      or a '-' to remove the command permission.
+            keys: A list of key patterns to grant the user access to. Key patterns allow
+                  '*' to support wildcard matching. For example, '*' grants access to
+                  all keys while 'cache:*' grants access to all keys that are prefixed
+                  with 'cache:'. `keys` should not be prefixed with a '~'.
+            reset: Indicates whether the user should be fully reset prior to applying
+                   the new ACL. Setting this to `True` will remove all existing
+                   passwords, flags, and privileges from the user and then apply the
+                   specified rules. If `False`, the user's existing passwords, flags,
+                   and privileges will be kept and any new specified rules will be
+                   applied on top.
+            reset_keys: Indicates whether the user's key permissions should be reset
+                        prior to applying any new key permissions specified in `keys`.
+                        If `False`, the user's existing key permissions will be kept and
+                        any new specified key permissions will be applied on top.
+            reset_channels: Indicates whether the user's channel permissions should be
+                            reset prior to applying any new channel permissions
+                            specified in `channels`. If `False`, the user's existing
+                            channel permissions will be kept and any new specified
+                            channel permissions will be applied on top.
+            reset_passwords: Indicates whether to remove all existing passwords and the
+                             `nopass` flag from the user prior to applying any new
+                             passwords specified in `passwords` or `hashed_passwords`.
+                             If `False`, the user's existing passwords and `nopass`
+                             status will be kept and any new specified passwords or
+                             hashed passwords will be applied on top.
         """
         encoder = self.get_encoder()
         pieces: List[EncodableT] = [username]

From cefc36ef9360fb730025087ef359d676991fd96d Mon Sep 17 00:00:00 2001
From: Will Frey <jfrey89@gmail.com>
Date: Mon, 20 May 2024 23:44:46 +0900
Subject: [PATCH 0875/1164] Update ResponseT type alias (#3227)

Pyright treats explicit and implicit `Any` differently, with implicit `Any` being treated as `Unknown`. Pyright raised a warning indicating an unknown member type for 'Awaitable' when used in 'ResponseT'. Using the `incr` method as an example, the warning is:

```
"warning: Type of 'incr' is partially unknown
 Type of 'incr' is '(name: bytes | str | memoryview, amount: int = 1) -> (Awaitable[Unknown] | Any)' (reportUnknownMemberType)"
```

By explicitly specifying 'Awaitable[Any]' in the union for 'ResponseT', this resolves the ambiguity about the member type.
---
 CHANGES         | 1 +
 redis/typing.py | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/CHANGES b/CHANGES
index e0959b0ef3..82c5b6db2a 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Update `ResponseT` type hint
     * Allow to control the minimum SSL version
     * Add an optional lock_name attribute to LockError.
     * Fix return types for `get`, `set_path` and `strappend` in JSONCommands
diff --git a/redis/typing.py b/redis/typing.py
index 838219fbb6..ee4296245f 100644
--- a/redis/typing.py
+++ b/redis/typing.py
@@ -32,7 +32,7 @@
 PatternT = _StringLikeT  # Patterns matched against keys, fields etc
 FieldT = EncodableT  # Fields within hash tables, streams and geo commands
 KeysT = Union[KeyT, Iterable[KeyT]]
-ResponseT = Union[Awaitable, Any]
+ResponseT = Union[Awaitable[Any], Any]
 ChannelT = _StringLikeT
 GroupT = _StringLikeT  # Consumer group
 ConsumerT = _StringLikeT  # Consumer name

From de8b5709a7d2022deff55034fe7dabc5770225a2 Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@gmail.com>
Date: Mon, 20 May 2024 18:39:49 +0300
Subject: [PATCH 0876/1164] Use new Redis logo and website (#3233)

Use the new logo, and use the SVG version of the logo in all places,
including the README.

Replace most of the redis.com URLs with their new redis.io counterparts.

Co-authored-by: Gabriel Erzse <gabriel.erzse@redis.com>
---
 README.md                                 |  16 +++++-------
 docs/_static/logo-redis.svg               |  10 ++++++++
 docs/_static/redis-cube-red-white-rgb.svg |  30 ----------------------
 docs/conf.py                              |   2 +-
 docs/logo-redis.png                       | Bin 8388 -> 0 bytes
 redis/commands/core.py                    |   2 +-
 redis/commands/timeseries/info.py         |   4 +--
 7 files changed, 21 insertions(+), 43 deletions(-)
 create mode 100644 docs/_static/logo-redis.svg
 delete mode 100644 docs/_static/redis-cube-red-white-rgb.svg
 delete mode 100644 docs/logo-redis.png

diff --git a/README.md b/README.md
index 2097e87bba..ecd6cccd64 100644
--- a/README.md
+++ b/README.md
@@ -19,17 +19,15 @@ The Python interface to the Redis key-value store.
 
 ## How do I Redis?
 
-[Learn for free at Redis University](https://university.redis.com/)
+[Learn for free at Redis University](https://redis.io/university/)
 
-[Build faster with the Redis Launchpad](https://launchpad.redis.com/)
+[Try the Redis Cloud](https://redis.io/try-free/)
 
-[Try the Redis Cloud](https://redis.com/try-free/)
+[Dive in developer tutorials](https://redis.io/learn)
 
-[Dive in developer tutorials](https://developer.redis.com/)
+[Join the Redis community](https://redis.io/community/)
 
-[Join the Redis community](https://redis.com/community/)
-
-[Work at Redis](https://redis.com/company/careers/jobs/)
+[Work at Redis](https://redis.io/careers/)
 
 ## Installation
 
@@ -159,7 +157,7 @@ The following example shows how to utilize [Redis Pub/Sub](https://redis.io/docs
 
 ### Author
 
-redis-py is developed and maintained by [Redis Inc](https://redis.com). It can be found [here](
+redis-py is developed and maintained by [Redis Inc](https://redis.io). It can be found [here](
 https://github.com/redis/redis-py), or downloaded from [pypi](https://pypi.org/project/redis/).
 
 Special thanks to:
@@ -171,4 +169,4 @@ Special thanks to:
     system.
 -   Paul Hubbard for initial packaging support.
 
-[![Redis](./docs/logo-redis.png)](https://www.redis.com)
+[![Redis](./docs/_static/logo-redis.svg)](https://redis.io)
diff --git a/docs/_static/logo-redis.svg b/docs/_static/logo-redis.svg
new file mode 100644
index 0000000000..a8de68d23c
--- /dev/null
+++ b/docs/_static/logo-redis.svg
@@ -0,0 +1,10 @@
+<svg width="85" height="27" viewBox="0 0 85 27" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_1878_297)">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M75.2909 13.8125C75.2909 10.8448 77.4892 9.12284 80.2371 9.12284C82.2888 9.12284 84.1207 10.1121 85 12.5668C84.7435 13.8125 83.2047 15.2047 82.5453 15.4246C81.9957 14.2522 81.3728 13.556 80.7866 13.556C80.0539 13.556 80.0172 14.069 80.0172 14.7284C80.0172 15.1955 80.151 15.8834 80.3119 16.7112C80.5549 17.9615 80.8599 19.5309 80.8599 21.1401C80.8599 24.0711 78.8082 26.2328 75.6573 26.2328C72.7721 26.2328 71.1778 24.3414 70.4665 21.3198C68.5818 24.6972 65.8257 26.2328 63.7134 26.2328C60.411 26.2328 59.6338 23.7919 59.7121 21.3161C58.3852 23.6612 55.831 26.2328 53.3815 26.2328C50.8809 26.2328 49.9976 24.0563 50.2002 21.5215C48.702 24.3122 45.9919 26.2328 43.3793 26.2328C40.5442 26.2328 39.141 23.9806 39.5951 21.189C37.6878 23.5333 34.1374 26.2328 30.4461 26.2328C26.2373 26.2328 24.4053 23.9632 24.1882 21.1193C22.1568 24.375 19.4187 26.3427 16.1573 26.3427C11.4493 26.3427 9.76537 22.1561 9.52032 18.7315C7.77547 21.0681 5.81377 23.4923 3.40733 26.1961C3.15086 26.4526 2.93103 26.5991 2.67457 26.5991C1.8319 26.5991 0.109914 22.8621 0 21.4698C0.723099 20.3478 5.28119 15.3398 8.95093 11.3079C10.2409 9.89066 11.4211 8.594 12.2863 7.6291C10.0389 8.30726 7.72169 9.65975 4.79957 11.7608C4.28664 12.1272 2.85776 8.7931 2.8944 6.22845C6.26509 3.73707 11.3944 2.16164 15.5345 2.16164C21.3233 2.16164 24.6573 5.38578 24.6573 9.8556C24.6573 13.5927 21.5431 17.6961 17 17.8427C14.6377 17.904 13.1237 16.578 12.3494 14.9405C12.4419 17.473 13.7587 20.5905 17.2931 20.5905C21.1462 20.5905 22.9965 18.2646 25.7559 14.7958C25.9352 14.5704 26.1183 14.3403 26.306 14.1056C28.6509 11.2112 31.3621 8.64655 35.319 8.64655C37.7371 8.64655 39.3858 10.1487 39.3858 12.4203C39.3858 15.1681 36.1616 18.9784 31.6552 18.9784C30.8855 18.9784 30.1839 18.877 29.5917 18.6766C29.5768 18.7921 29.5668 18.9058 29.5668 19.0151C29.5668 20.2974 30.0431 21.0668 32.1315 21.0668C35.2091 21.0668 38.1034 19.2349 41.6207 14.9483C45.0647 10.7349 47.6659 8.90302 50.4138 8.90302C52.2687 8.90302 53.6765 9.90832 54.2969 11.6014C57.9796 6.28253 61.1038 2.51388 63.75 0C66.3513 1.09914 68.2198 3.26078 67.7069 3.70043C65.7651 5.45905 59.2802 12.5302 56.7155 16.7435C56.056 17.8427 55.4332 19.0517 55.4332 19.6379C55.4332 20.1875 55.7629 20.3707 56.1293 20.3707C57.8898 20.3707 61.4176 16.2147 64.4645 12.6253C65.6026 11.2845 66.6736 10.0228 67.5603 9.08621C69.6121 9.92888 71.7004 11.7241 71.1875 12.347C68.4763 15.5711 66.4246 18.2091 66.4246 19.7112C66.4246 20.1142 66.5711 20.3707 67.1207 20.3707C68.1466 20.3707 69.0991 19.4547 70.6746 17.5129C71.0043 17.1099 71.4073 17.1099 71.6638 17.7328C72.3599 19.4181 73.3858 20.3341 74.1918 20.3341C75.1444 20.3341 75.6207 19.4914 75.6207 18.2091C75.6207 17.3327 75.5137 16.3138 75.4217 15.4365C75.3521 14.7733 75.2909 14.191 75.2909 13.8125ZM16.194 13.3362C18.1358 13.3362 20.2608 12.2737 20.2608 10.1121C20.2608 8.80024 19.4466 7.59084 17.2708 7.22257C17.156 7.40192 17.042 7.58017 16.9287 7.75739C15.8231 9.4858 14.7804 11.116 13.7281 12.7095C14.3586 13.0636 15.156 13.3362 16.194 13.3362ZM35.8319 13.9957C35.8319 13.4095 35.4655 13.0065 34.8793 13.0065C33.4094 13.0065 31.1923 15.0693 30.149 17.0613C30.5341 17.2101 30.9862 17.2931 31.472 17.2931C34.0733 17.2931 35.8319 15.3147 35.8319 13.9957ZM45.4677 19.3082C45.4677 19.9677 45.834 20.4073 46.6034 20.4073C48.9849 20.4073 51.9526 16.0841 51.9526 14.3254C51.9526 13.5927 51.5496 13.153 50.8901 13.153C48.7285 13.153 45.4677 17.2565 45.4677 19.3082ZM76.0599 6.08207C75.2172 7.47431 73.9349 9.04974 73.4586 9.52603C71.2603 8.61008 69.2086 6.77819 69.5017 6.26525C70.3077 4.83638 71.6267 3.29758 72.103 2.82129C74.3012 3.73724 76.353 5.60577 76.0599 6.08207Z" fill="#FF4438"/>
+</g>
+<defs>
+<clipPath id="clip0_1878_297">
+<rect width="85" height="26.5991" fill="white"/>
+</clipPath>
+</defs>
+</svg>
diff --git a/docs/_static/redis-cube-red-white-rgb.svg b/docs/_static/redis-cube-red-white-rgb.svg
deleted file mode 100644
index 936eb231b9..0000000000
--- a/docs/_static/redis-cube-red-white-rgb.svg
+++ /dev/null
@@ -1,30 +0,0 @@
-<?xml version="1.0" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd">
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" id="body_1" width="70" height="52">
-
-<defs>
-                <clipPath  id="1">
-
-                    <path clip-rule="evenodd" transform="matrix(1 0 0 1 0.01 0.01)"  d="M0 0L146.42 0L146.42 125.48L0 125.48z" />                </clipPath>
-</defs>
-
-<g transform="matrix(0.41404575 0 0 0.41404575 4.689784 -0)">
-	<g>
-		<g>
-			<g clip-path="url(#1)" >
-                <path transform="matrix(1 0 0 1 0.01 0.01)"  d="M140.66 96.74C 132.86 100.82 92.380005 117.47 83.66 122.03999C 74.94 126.609985 70.270004 126.479996 63.450005 123.21999C 56.630005 119.95999 13.7 102.5 5.92 98.78C 2 96.94 0 95.37 0 93.9L0 93.9L0 79.09C 0 79.09 56.08 66.92 65.13 63.64C 74.17999 60.36 77.31 60.28 85 63.1C 92.69 65.92 138.79 74.24 146.4 77L146.4 77L146.4 91.6C 146.4 93.119995 144.65 94.6 140.65999 96.729996L140.65999 96.729996L140.66 96.74z" stroke="none" fill="#A32422" fill-rule="nonzero" />
-                <path transform="matrix(1 0 0 1 0.01 0.01)"  d="M140.66 82C 132.86 86.06 92.380005 102.71 83.66 107.2C 74.94 111.689995 70.270004 111.649994 63.450005 108.399994C 56.630005 105.149994 13.7 87.69 5.92 84C -1.8599997 80.31 -2.0099998 77.73 5.62 74.75C 13.25 71.77 56.08 55 65.13 51.7C 74.17999 48.4 77.31 48.33 85 51.16C 92.69 53.989998 133 70 140.57 72.79C 148.14001 75.58 148.49 77.87 140.66 81.92L140.66 81.92L140.66 82z" stroke="none" fill="#DC382C" fill-rule="nonzero" />
-                <path transform="matrix(1 0 0 1 0.01 0.01)"  d="M140.66 72.62C 132.86 76.69 92.380005 93.33 83.66 97.82001C 74.94 102.31001 70.31 102.27 63.49 99C 56.670006 95.73 13.7 78.37 5.92 74.66C 2 72.8 0 71.24 0 69.76L0 69.76L0 55C 0 55 56.08 42.79 65.13 39.51C 74.17999 36.229996 77.31 36.14 85 39C 92.69 41.86 138.79 50.1 146.4 52.88L146.4 52.88L146.4 67.48C 146.4 69 144.65 70.52 140.66 72.62z" stroke="none" fill="#A32422" fill-rule="nonzero" />
-                <path transform="matrix(1 0 0 1 0.01 0.01)"  d="M140.66 57.81C 132.86 61.89 92.380005 78.53 83.66 83.020004C 74.94 87.51001 70.270004 87.48 63.450005 84.22C 56.630005 80.96 13.7 63.57 5.92 59.85C -1.8599997 56.129997 -2 53.6 5.62 50.62C 13.24 47.64 56.079998 30.829998 65.13 27.619999C 74.17999 24.41 77.31 24.21 85 27C 92.69 29.79 133 45.94 140.57 48.65C 148.14001 51.360004 148.49 53.74 140.66 57.780003L140.66 57.780003L140.66 57.81z" stroke="none" fill="#DC382C" fill-rule="nonzero" />
-                <path transform="matrix(1 0 0 1 0.01 0.01)"  d="M140.66 47.59C 132.86 51.67 92.380005 68.32 83.66 72.8C 74.94 77.28001 70.31 77.25 63.49 74C 56.670006 70.75 13.7 53.34 5.92 49.63C 2 47.79 0 46.22 0 44.74L0 44.74L0 29.93C 0 29.93 56.08 17.76 65.13 14.49C 74.17999 11.219999 77.31 11.12 85 13.94C 92.69 16.759998 138.77 25.08 146.38 27.86L146.38 27.86L146.38 42.46C 146.4 44 144.65 45.5 140.66 47.59z" stroke="none" fill="#A32422" fill-rule="nonzero" />
-                <path transform="matrix(1 0 0 1 0.01 0.01)"  d="M140.66 32.8C 132.86 36.8 92.380005 53.55 83.66 58C 74.94 62.45 70.270004 62.44 63.450005 59.2C 56.630005 55.960003 13.7 38.53 5.92 34.83C -1.8599997 31.130005 -2.0099998 28.560001 5.62 25.580002C 13.25 22.600002 56.08 5.8 65.13 2.54C 74.17999 -0.72000027 77.31 -0.82 85 2C 92.69 4.8199997 133 20.85 140.57 23.63C 148.14001 26.409998 148.49 28.72 140.66 32.77L140.66 32.77L140.66 32.8z" stroke="none" fill="#DC382C" fill-rule="nonzero" />
-			</g>
-            <path d="M75.51 11.78L85.17 8.61L82.55 14.87L92.38 18.55L79.71 19.87L76.86 26.71L72.28 19.08L57.63 17.76L68.57 13.82L65.28 7.76L75.51 11.78L75.51 11.78L75.51 11.78L75.51 11.78" stroke="none" fill="#FFFFFF" fill-rule="nonzero" />
-            <path d="M76.12 51.71L52.44 41.88L86.36 36.67L76.12 51.71L76.12 51.71L76.12 51.71L76.12 51.71" stroke="none" fill="#FFFFFF" fill-rule="nonzero" />
-            <path transform="matrix(1 0 0 1 0.01 0.01)"  d="M43.28 22.34C 53.28 22.34 61.409996 25.49 61.409996 29.34C 61.409996 33.190002 53.259995 36.34 43.28 36.34C 33.300003 36.34 25.14 33.19 25.14 29.34C 25.14 25.490002 33.27 22.34 43.28 22.34z" stroke="none" fill="#FFFFFF" fill-rule="nonzero" />
-            <path d="M107.39 20.42L127.46 28.35L107.41 36.28L107.39 20.42L107.39 20.42L107.39 20.42L107.39 20.42" stroke="none" fill="#741113" fill-rule="nonzero" />
-            <path d="M107.39 20.42L107.41 36.28L105.23 37.13L85.17 29.2L107.39 20.42L107.39 20.42L107.39 20.42L107.39 20.42" stroke="none" fill="#AC2724" fill-rule="nonzero" />
-		</g>
-	</g>
-</g>
-</svg>
\ No newline at end of file
diff --git a/docs/conf.py b/docs/conf.py
index 33a8589654..f66c5903ff 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -158,7 +158,7 @@
 
 # The name of an image file (relative to this directory) to place at the top
 # of the sidebar.
-html_logo = "_static/redis-cube-red-white-rgb.svg"
+html_logo = "_static/logo-redis.svg"
 
 # The name of an image file (within the static path) to use as favicon of the
 # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
diff --git a/docs/logo-redis.png b/docs/logo-redis.png
deleted file mode 100644
index 45b4a3f284f3d10b558c2f77b75cd11739a117f7..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 8388
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
a2=V_BGxZdvyr}2^0000<MNUMnLSTZ7g9pt3

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 0656fd8136..4e1e242dc4 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -5269,7 +5269,7 @@ def pubsub_shardnumsub(self, *args: ChannelT, **kwargs) -> ResponseT:
 class ScriptCommands(CommandsProtocol):
     """
     Redis Lua script commands. see:
-    https://redis.com/ebook/part-3-next-steps/chapter-11-scripting-redis-with-lua/
+    https://redis.io/ebook/part-3-next-steps/chapter-11-scripting-redis-with-lua/
     """
 
     def _eval(
diff --git a/redis/commands/timeseries/info.py b/redis/commands/timeseries/info.py
index 3a384dc049..d86b92ace2 100644
--- a/redis/commands/timeseries/info.py
+++ b/redis/commands/timeseries/info.py
@@ -6,7 +6,7 @@ class TSInfo:
     """
     Hold information and statistics on the time-series.
     Can be created using ``tsinfo`` command
-    https://oss.redis.com/redistimeseries/commands/#tsinfo.
+    https://redis.io/docs/latest/commands/ts.info/
     """
 
     rules = []
@@ -57,7 +57,7 @@ def __init__(self, args):
             Policy that will define handling of duplicate samples.
 
         Can read more about on
-        https://oss.redis.com/redistimeseries/configuration/#duplicate_policy
+        https://redis.io/docs/latest/develop/data-types/timeseries/configuration/#duplicate_policy
         """
         response = dict(zip(map(nativestr, args[::2]), args[1::2]))
         self.rules = response.get("rules")

From 9a70f627f5c9a213b4bdb0358fc84fdedb77894f Mon Sep 17 00:00:00 2001
From: Dave Johansen <davejohansen@gmail.com>
Date: Tue, 21 May 2024 01:17:49 -0600
Subject: [PATCH 0877/1164] Fix typing for address_remap (fixes #3234) (#3235)

The address_remap callback received a tuple with the host and the port.
Make this clear in the typing hints.
---
 redis/asyncio/cluster.py | 4 ++--
 redis/cluster.py         | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index d5e5756045..719c2d2283 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -275,7 +275,7 @@ def __init__(
         ssl_min_version: Optional[ssl.TLSVersion] = None,
         ssl_ciphers: Optional[str] = None,
         protocol: Optional[int] = 2,
-        address_remap: Optional[Callable[[str, int], Tuple[str, int]]] = None,
+        address_remap: Optional[Callable[[Tuple[str, int]], Tuple[str, int]]] = None,
         cache_enabled: bool = False,
         client_cache: Optional[AbstractCache] = None,
         cache_max_size: int = 100,
@@ -1152,7 +1152,7 @@ def __init__(
         startup_nodes: List["ClusterNode"],
         require_full_coverage: bool,
         connection_kwargs: Dict[str, Any],
-        address_remap: Optional[Callable[[str, int], Tuple[str, int]]] = None,
+        address_remap: Optional[Callable[[Tuple[str, int]], Tuple[str, int]]] = None,
     ) -> None:
         self.startup_nodes = {node.name: node for node in startup_nodes}
         self.require_full_coverage = require_full_coverage
diff --git a/redis/cluster.py b/redis/cluster.py
index e792d51867..6fde3530ef 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -506,7 +506,7 @@ def __init__(
         read_from_replicas: bool = False,
         dynamic_startup_nodes: bool = True,
         url: Optional[str] = None,
-        address_remap: Optional[Callable[[str, int], Tuple[str, int]]] = None,
+        address_remap: Optional[Callable[[Tuple[str, int]], Tuple[str, int]]] = None,
         **kwargs,
     ):
         """
@@ -1347,7 +1347,7 @@ def __init__(
         lock=None,
         dynamic_startup_nodes=True,
         connection_pool_class=ConnectionPool,
-        address_remap: Optional[Callable[[str, int], Tuple[str, int]]] = None,
+        address_remap: Optional[Callable[[Tuple[str, int]], Tuple[str, int]]] = None,
         **kwargs,
     ):
         self.nodes_cache = {}

From 9908a4d4fa33b96dffe4e11b1f257f2c59954dcd Mon Sep 17 00:00:00 2001
From: Dave Johansen <davejohansen@gmail.com>
Date: Thu, 23 May 2024 08:21:29 -0600
Subject: [PATCH 0878/1164] Run pyupgrade for 3.8 (#3236)

Run pyupgrade for 3.8.
---
 redis/__init__.py                 |  7 +------
 redis/client.py                   |  2 +-
 redis/cluster.py                  |  3 +--
 redis/commands/bf/__init__.py     |  2 +-
 redis/commands/bf/info.py         | 10 +++++-----
 redis/commands/graph/__init__.py  |  2 +-
 redis/commands/json/commands.py   |  2 +-
 redis/utils.py                    |  6 +-----
 tests/ssl_utils.py                |  2 +-
 tests/test_asyncio/compat.py      |  2 +-
 tests/test_asyncio/test_search.py |  8 ++++----
 tests/test_search.py              | 28 +++++++++++++---------------
 12 files changed, 31 insertions(+), 43 deletions(-)

diff --git a/redis/__init__.py b/redis/__init__.py
index 495d2d99bb..94324a0de8 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -1,4 +1,4 @@
-import sys
+from importlib import metadata
 
 from redis import asyncio  # noqa
 from redis.backoff import default_backoff
@@ -36,11 +36,6 @@
 )
 from redis.utils import from_url
 
-if sys.version_info >= (3, 8):
-    from importlib import metadata
-else:
-    import importlib_metadata as metadata
-
 
 def int_or_str(value):
     try:
diff --git a/redis/client.py b/redis/client.py
index 02fc724322..b7a1f88d92 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -831,7 +831,7 @@ def clean_health_check_responses(self) -> None:
                 else:
                     raise PubSubError(
                         "A non health check response was cleaned by "
-                        "execute_command: {0}".format(response)
+                        "execute_command: {}".format(response)
                     )
             ttl -= 1
 
diff --git a/redis/cluster.py b/redis/cluster.py
index 6fde3530ef..144844ec8a 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -1851,8 +1851,7 @@ def _sharded_message_generator(self):
 
     def _pubsubs_generator(self):
         while True:
-            for pubsub in self.node_pubsub_mapping.values():
-                yield pubsub
+            yield from self.node_pubsub_mapping.values()
 
     def get_sharded_message(
         self, ignore_subscribe_messages=False, timeout=0.0, target_node=None
diff --git a/redis/commands/bf/__init__.py b/redis/commands/bf/__init__.py
index 959358f8e8..29c5c18767 100644
--- a/redis/commands/bf/__init__.py
+++ b/redis/commands/bf/__init__.py
@@ -5,7 +5,7 @@
 from .info import BFInfo, CFInfo, CMSInfo, TDigestInfo, TopKInfo
 
 
-class AbstractBloom(object):
+class AbstractBloom:
     """
     The client allows to interact with RedisBloom and use all of
     it's functionality.
diff --git a/redis/commands/bf/info.py b/redis/commands/bf/info.py
index e1f0208609..1a876c1655 100644
--- a/redis/commands/bf/info.py
+++ b/redis/commands/bf/info.py
@@ -1,7 +1,7 @@
 from ..helpers import nativestr
 
 
-class BFInfo(object):
+class BFInfo:
     capacity = None
     size = None
     filterNum = None
@@ -26,7 +26,7 @@ def __getitem__(self, item):
         return getattr(self, item)
 
 
-class CFInfo(object):
+class CFInfo:
     size = None
     bucketNum = None
     filterNum = None
@@ -57,7 +57,7 @@ def __getitem__(self, item):
         return getattr(self, item)
 
 
-class CMSInfo(object):
+class CMSInfo:
     width = None
     depth = None
     count = None
@@ -72,7 +72,7 @@ def __getitem__(self, item):
         return getattr(self, item)
 
 
-class TopKInfo(object):
+class TopKInfo:
     k = None
     width = None
     depth = None
@@ -89,7 +89,7 @@ def __getitem__(self, item):
         return getattr(self, item)
 
 
-class TDigestInfo(object):
+class TDigestInfo:
     compression = None
     capacity = None
     merged_nodes = None
diff --git a/redis/commands/graph/__init__.py b/redis/commands/graph/__init__.py
index ffaf1fb4ff..ddc0e34f4c 100644
--- a/redis/commands/graph/__init__.py
+++ b/redis/commands/graph/__init__.py
@@ -252,7 +252,7 @@ async def call_procedure(self, procedure, *args, read_only=False, **kwagrs):
         return await self.query(q, read_only=read_only)
 
     async def labels(self):
-        return ((await self.call_procedure(DB_LABELS, read_only=True))).result_set
+        return (await self.call_procedure(DB_LABELS, read_only=True)).result_set
 
     async def property_keys(self):
         return (await self.call_procedure(DB_PROPERTYKEYS, read_only=True)).result_set
diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index b37dc37687..da879df611 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -314,7 +314,7 @@ def set_file(
 
         """
 
-        with open(file_name, "r") as fp:
+        with open(file_name) as fp:
             file_content = loads(fp.read())
 
         return self.set(name, path, file_content, nx=nx, xx=xx, decode_keys=decode_keys)
diff --git a/redis/utils.py b/redis/utils.py
index 01fdfed7a2..ea2eac149e 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -1,5 +1,4 @@
 import logging
-import sys
 from contextlib import contextmanager
 from functools import wraps
 from typing import Any, Dict, Mapping, Union
@@ -28,10 +27,7 @@
 except ImportError:
     CRYPTOGRAPHY_AVAILABLE = False
 
-if sys.version_info >= (3, 8):
-    from importlib import metadata
-else:
-    import importlib_metadata as metadata
+from importlib import metadata
 
 
 def from_url(url, **kwargs):
diff --git a/tests/ssl_utils.py b/tests/ssl_utils.py
index ab9c2e8944..1de53bbf66 100644
--- a/tests/ssl_utils.py
+++ b/tests/ssl_utils.py
@@ -9,6 +9,6 @@ def get_ssl_filename(name):
             os.path.join(root, "..", "dockers", "stunnel", "keys")
         )
         if not os.path.isdir(cert_dir):
-            raise IOError(f"No SSL certificates found. They should be in {cert_dir}")
+            raise OSError(f"No SSL certificates found. They should be in {cert_dir}")
 
     return os.path.join(cert_dir, name)
diff --git a/tests/test_asyncio/compat.py b/tests/test_asyncio/compat.py
index 4a9778b70a..aa1dc49af0 100644
--- a/tests/test_asyncio/compat.py
+++ b/tests/test_asyncio/compat.py
@@ -4,7 +4,7 @@
 try:
     mock.AsyncMock
 except AttributeError:
-    import mock
+    from unittest import mock
 
 try:
     from contextlib import aclosing
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 1f1931e28a..8d42d08b66 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -1487,14 +1487,14 @@ async def test_withsuffixtrie(decoded_r: redis.Redis):
         assert await decoded_r.ft().dropindex("idx")
 
         # create withsuffixtrie index (text field)
-        assert await decoded_r.ft().create_index((TextField("t", withsuffixtrie=True)))
+        assert await decoded_r.ft().create_index(TextField("t", withsuffixtrie=True))
         await waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
         info = await decoded_r.ft().info()
         assert "WITHSUFFIXTRIE" in info["attributes"][0]
         assert await decoded_r.ft().dropindex("idx")
 
         # create withsuffixtrie index (tag field)
-        assert await decoded_r.ft().create_index((TagField("t", withsuffixtrie=True)))
+        assert await decoded_r.ft().create_index(TagField("t", withsuffixtrie=True))
         await waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
         info = await decoded_r.ft().info()
         assert "WITHSUFFIXTRIE" in info["attributes"][0]
@@ -1504,14 +1504,14 @@ async def test_withsuffixtrie(decoded_r: redis.Redis):
         assert await decoded_r.ft().dropindex("idx")
 
         # create withsuffixtrie index (text fields)
-        assert await decoded_r.ft().create_index((TextField("t", withsuffixtrie=True)))
+        assert await decoded_r.ft().create_index(TextField("t", withsuffixtrie=True))
         waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
         info = await decoded_r.ft().info()
         assert "WITHSUFFIXTRIE" in info["attributes"][0]["flags"]
         assert await decoded_r.ft().dropindex("idx")
 
         # create withsuffixtrie index (tag field)
-        assert await decoded_r.ft().create_index((TagField("t", withsuffixtrie=True)))
+        assert await decoded_r.ft().create_index(TagField("t", withsuffixtrie=True))
         waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
         info = await decoded_r.ft().info()
         assert "WITHSUFFIXTRIE" in info["attributes"][0]["flags"]
diff --git a/tests/test_search.py b/tests/test_search.py
index bfe204254c..f19c193891 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1383,16 +1383,14 @@ def test_aggregations_apply(client):
     )
     res = client.ft().aggregate(req)
     if is_resp2_connection(client):
-        res_set = set([res.rows[0][1], res.rows[1][1]])
-        assert res_set == set(["6373878785249699840", "6373878758592700416"])
+        res_set = {res.rows[0][1], res.rows[1][1]}
+        assert res_set == {"6373878785249699840", "6373878758592700416"}
     else:
-        res_set = set(
-            [
-                res["results"][0]["extra_attributes"]["CreatedDateTimeUTC"],
-                res["results"][1]["extra_attributes"]["CreatedDateTimeUTC"],
-            ],
-        )
-        assert res_set == set(["6373878785249699840", "6373878758592700416"])
+        res_set = {
+            res["results"][0]["extra_attributes"]["CreatedDateTimeUTC"],
+            res["results"][1]["extra_attributes"]["CreatedDateTimeUTC"],
+        }
+        assert res_set == {"6373878785249699840", "6373878758592700416"}
 
 
 @pytest.mark.redismod
@@ -2099,7 +2097,7 @@ def test_numeric_params(client):
 @pytest.mark.redismod
 @skip_ifmodversion_lt("2.4.3", "search")
 def test_geo_params(client):
-    client.ft().create_index((GeoField("g")))
+    client.ft().create_index(GeoField("g"))
     client.hset("doc1", mapping={"g": "29.69465, 34.95126"})
     client.hset("doc2", mapping={"g": "29.69350, 34.94737"})
     client.hset("doc3", mapping={"g": "29.68746, 34.94882"})
@@ -2228,14 +2226,14 @@ def test_withsuffixtrie(client: redis.Redis):
         assert client.ft().dropindex("idx")
 
         # create withsuffixtrie index (text fields)
-        assert client.ft().create_index((TextField("t", withsuffixtrie=True)))
+        assert client.ft().create_index(TextField("t", withsuffixtrie=True))
         waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
         info = client.ft().info()
         assert "WITHSUFFIXTRIE" in info["attributes"][0]
         assert client.ft().dropindex("idx")
 
         # create withsuffixtrie index (tag field)
-        assert client.ft().create_index((TagField("t", withsuffixtrie=True)))
+        assert client.ft().create_index(TagField("t", withsuffixtrie=True))
         waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
         info = client.ft().info()
         assert "WITHSUFFIXTRIE" in info["attributes"][0]
@@ -2245,14 +2243,14 @@ def test_withsuffixtrie(client: redis.Redis):
         assert client.ft().dropindex("idx")
 
         # create withsuffixtrie index (text fields)
-        assert client.ft().create_index((TextField("t", withsuffixtrie=True)))
+        assert client.ft().create_index(TextField("t", withsuffixtrie=True))
         waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
         info = client.ft().info()
         assert "WITHSUFFIXTRIE" in info["attributes"][0]["flags"]
         assert client.ft().dropindex("idx")
 
         # create withsuffixtrie index (tag field)
-        assert client.ft().create_index((TagField("t", withsuffixtrie=True)))
+        assert client.ft().create_index(TagField("t", withsuffixtrie=True))
         waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
         info = client.ft().info()
         assert "WITHSUFFIXTRIE" in info["attributes"][0]["flags"]
@@ -2271,7 +2269,7 @@ def test_query_timeout(r: redis.Redis):
 
 @pytest.mark.redismod
 def test_geoshape(client: redis.Redis):
-    client.ft().create_index((GeoShapeField("geom", GeoShapeField.FLAT)))
+    client.ft().create_index(GeoShapeField("geom", GeoShapeField.FLAT))
     waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
     client.hset("small", "geom", "POLYGON((1 1, 1 100, 100 100, 100 1, 1 1))")
     client.hset("large", "geom", "POLYGON((1 1, 1 200, 200 200, 200 1, 1 1))")

From b7a85eb6b477298dd3765da3a299979cc1ddafcc Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@gmail.com>
Date: Fri, 24 May 2024 11:50:01 +0300
Subject: [PATCH 0879/1164] Parse FT.PROFILE response more robustly (#3245)

When parsing the response of FT.PROFILE, handle the cases when the
nested items are either not lists, or empty lists, or lists with a
single item.

Co-authored-by: Gabriel Erzse <gabriel.erzse@redis.com>
---
 redis/commands/helpers.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
index 127141f650..1ea02a60cf 100644
--- a/redis/commands/helpers.py
+++ b/redis/commands/helpers.py
@@ -85,7 +85,11 @@ def parse_to_dict(response):
 
     res = {}
     for det in response:
-        if isinstance(det[1], list):
+        if not isinstance(det, list) or not det:
+            continue
+        if len(det) == 1:
+            res[det[0]] = True
+        elif isinstance(det[1], list):
             res[det[0]] = parse_list_to_dict(det[1])
         else:
             try:  # try to set the attribute. may be provided without value

From 85dafcc7eac8c997b89a072016e4f64fa3a8f973 Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@gmail.com>
Date: Tue, 28 May 2024 10:25:15 +0300
Subject: [PATCH 0880/1164] More robust parsing of memory stats response
 (#3247)

Make the parsing of memory stats response more robust, to not break on
changes that will be added to the Redis server.

Also make a test related to client kill by maxage more resilient.

Co-authored-by: Gabriel Erzse <gabriel.erzse@redis.com>
---
 redis/_parsers/helpers.py           | 2 +-
 tests/test_asyncio/test_commands.py | 2 +-
 tests/test_commands.py              | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/redis/_parsers/helpers.py b/redis/_parsers/helpers.py
index 74faa5fd7e..aa115aa4a1 100644
--- a/redis/_parsers/helpers.py
+++ b/redis/_parsers/helpers.py
@@ -80,7 +80,7 @@ def parse_memory_stats(response, **kwargs):
     """Parse the results of MEMORY STATS"""
     stats = pairs_to_dict(response, decode_keys=True, decode_string_values=True)
     for key, value in stats.items():
-        if key.startswith("db."):
+        if key.startswith("db.") and isinstance(value, list):
             stats[key] = pairs_to_dict(
                 value, decode_keys=True, decode_string_values=True
             )
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index b3e42bae8e..a01a4862ab 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -3235,7 +3235,7 @@ async def test_memory_stats(self, r: redis.Redis):
         assert isinstance(stats, dict)
         for key, value in stats.items():
             if key.startswith("db."):
-                assert isinstance(value, dict)
+                assert not isinstance(value, list)
 
     @skip_if_server_version_lt("4.0.0")
     async def test_memory_usage(self, r: redis.Redis):
diff --git a/tests/test_commands.py b/tests/test_commands.py
index cd392552d1..54df183fc6 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -712,7 +712,7 @@ def test_client_kill_filter_by_user(self, r, request):
     def test_client_kill_filter_by_maxage(self, r, request):
         _get_client(redis.Redis, request, flushdb=False)
         time.sleep(4)
-        assert len(r.client_list()) == 2
+        assert len(r.client_list()) >= 2
         r.client_kill_filter(maxage=2)
         assert len(r.client_list()) == 1
 
@@ -4914,7 +4914,7 @@ def test_memory_stats(self, r):
         assert isinstance(stats, dict)
         for key, value in stats.items():
             if key.startswith("db."):
-                assert isinstance(value, dict)
+                assert not isinstance(value, list)
 
     @skip_if_server_version_lt("4.0.0")
     def test_memory_usage(self, r):

From 0d47d6527a10fb70f8fcfdf8df69ae3b11ec92ef Mon Sep 17 00:00:00 2001
From: Max Muoto <maxmuoto@gmail.com>
Date: Tue, 28 May 2024 07:28:02 -0700
Subject: [PATCH 0881/1164] Add missing type hints for backoff.py (#3249)

Add type hints to backoff.py
---
 redis/backoff.py | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/redis/backoff.py b/redis/backoff.py
index c62e760bdc..f612d60704 100644
--- a/redis/backoff.py
+++ b/redis/backoff.py
@@ -19,7 +19,7 @@ def reset(self):
         pass
 
     @abstractmethod
-    def compute(self, failures):
+    def compute(self, failures: int) -> float:
         """Compute backoff in seconds upon failure"""
         pass
 
@@ -27,25 +27,25 @@ def compute(self, failures):
 class ConstantBackoff(AbstractBackoff):
     """Constant backoff upon failure"""
 
-    def __init__(self, backoff):
+    def __init__(self, backoff: float) -> None:
         """`backoff`: backoff time in seconds"""
         self._backoff = backoff
 
-    def compute(self, failures):
+    def compute(self, failures: int) -> float:
         return self._backoff
 
 
 class NoBackoff(ConstantBackoff):
     """No backoff upon failure"""
 
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__(0)
 
 
 class ExponentialBackoff(AbstractBackoff):
     """Exponential backoff upon failure"""
 
-    def __init__(self, cap=DEFAULT_CAP, base=DEFAULT_BASE):
+    def __init__(self, cap: float = DEFAULT_CAP, base: float = DEFAULT_BASE):
         """
         `cap`: maximum backoff time in seconds
         `base`: base backoff time in seconds
@@ -53,14 +53,14 @@ def __init__(self, cap=DEFAULT_CAP, base=DEFAULT_BASE):
         self._cap = cap
         self._base = base
 
-    def compute(self, failures):
+    def compute(self, failures: int) -> float:
         return min(self._cap, self._base * 2**failures)
 
 
 class FullJitterBackoff(AbstractBackoff):
     """Full jitter backoff upon failure"""
 
-    def __init__(self, cap=DEFAULT_CAP, base=DEFAULT_BASE):
+    def __init__(self, cap: float = DEFAULT_CAP, base: float = DEFAULT_BASE) -> None:
         """
         `cap`: maximum backoff time in seconds
         `base`: base backoff time in seconds
@@ -68,14 +68,14 @@ def __init__(self, cap=DEFAULT_CAP, base=DEFAULT_BASE):
         self._cap = cap
         self._base = base
 
-    def compute(self, failures):
+    def compute(self, failures: int) -> float:
         return random.uniform(0, min(self._cap, self._base * 2**failures))
 
 
 class EqualJitterBackoff(AbstractBackoff):
     """Equal jitter backoff upon failure"""
 
-    def __init__(self, cap=DEFAULT_CAP, base=DEFAULT_BASE):
+    def __init__(self, cap: float = DEFAULT_CAP, base: float = DEFAULT_BASE) -> None:
         """
         `cap`: maximum backoff time in seconds
         `base`: base backoff time in seconds
@@ -83,7 +83,7 @@ def __init__(self, cap=DEFAULT_CAP, base=DEFAULT_BASE):
         self._cap = cap
         self._base = base
 
-    def compute(self, failures):
+    def compute(self, failures: int) -> float:
         temp = min(self._cap, self._base * 2**failures) / 2
         return temp + random.uniform(0, temp)
 
@@ -91,7 +91,7 @@ def compute(self, failures):
 class DecorrelatedJitterBackoff(AbstractBackoff):
     """Decorrelated jitter backoff upon failure"""
 
-    def __init__(self, cap=DEFAULT_CAP, base=DEFAULT_BASE):
+    def __init__(self, cap: float = DEFAULT_CAP, base: float = DEFAULT_BASE) -> None:
         """
         `cap`: maximum backoff time in seconds
         `base`: base backoff time in seconds
@@ -100,10 +100,10 @@ def __init__(self, cap=DEFAULT_CAP, base=DEFAULT_BASE):
         self._base = base
         self._previous_backoff = 0
 
-    def reset(self):
+    def reset(self) -> None:
         self._previous_backoff = 0
 
-    def compute(self, failures):
+    def compute(self, failures: int) -> float:
         max_backoff = max(self._base, self._previous_backoff * 3)
         temp = random.uniform(self._base, max_backoff)
         self._previous_backoff = min(self._cap, temp)

From 9fd5576b296b5ad315024d7245fb0376ba1c4aae Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@gmail.com>
Date: Wed, 5 Jun 2024 15:30:42 +0300
Subject: [PATCH 0882/1164] Fix parsing of INFO response (#3265)

If the INFO response contains a single `a=b` value for any of the keys,
that must also be parsed into a dictionary.

Fixes #3262

Co-authored-by: Gabriel Erzse <gabriel.erzse@redis.com>
---
 redis/_parsers/helpers.py          |  2 +-
 tests/test_parsers/test_helpers.py | 35 ++++++++++++++++++++++++++++++
 2 files changed, 36 insertions(+), 1 deletion(-)
 create mode 100644 tests/test_parsers/test_helpers.py

diff --git a/redis/_parsers/helpers.py b/redis/_parsers/helpers.py
index aa115aa4a1..57b12ab89e 100644
--- a/redis/_parsers/helpers.py
+++ b/redis/_parsers/helpers.py
@@ -38,7 +38,7 @@ def parse_info(response):
     response = str_if_bytes(response)
 
     def get_value(value):
-        if "," not in value or "=" not in value:
+        if "," not in value and "=" not in value:
             try:
                 if "." in value:
                     return float(value)
diff --git a/tests/test_parsers/test_helpers.py b/tests/test_parsers/test_helpers.py
new file mode 100644
index 0000000000..6430a237f6
--- /dev/null
+++ b/tests/test_parsers/test_helpers.py
@@ -0,0 +1,35 @@
+from redis._parsers.helpers import parse_info
+
+
+def test_parse_info():
+    info_output = """
+# Modules
+module:name=search,ver=999999,api=1,filters=0,usedby=[],using=[ReJSON],options=[handle-io-errors]
+
+# search_fields_statistics
+search_fields_text:Text=3
+search_fields_tag:Tag=2,Sortable=1
+
+# search_version
+search_version:99.99.99
+search_redis_version:7.2.2 - oss
+
+# search_runtime_configurations
+search_query_timeout_ms:500
+    """
+    info = parse_info(info_output)
+
+    assert isinstance(info["modules"], list)
+    assert isinstance(info["modules"][0], dict)
+    assert info["modules"][0]["name"] == "search"
+
+    assert isinstance(info["search_fields_text"], dict)
+    assert info["search_fields_text"]["Text"] == 3
+
+    assert isinstance(info["search_fields_tag"], dict)
+    assert info["search_fields_tag"]["Tag"] == 2
+    assert info["search_fields_tag"]["Sortable"] == 1
+
+    assert info["search_version"] == "99.99.99"
+    assert info["search_redis_version"] == "7.2.2 - oss"
+    assert info["search_query_timeout_ms"] == 500

From ff7821dcb4867db3870477ae3cce90287c1f73c5 Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@gmail.com>
Date: Thu, 6 Jun 2024 15:43:30 +0300
Subject: [PATCH 0883/1164] Use standard Redis docker image in CI (#3246)

Adapt the tests to use the standard Redis docker image where possible,
instead of using the Redis Stack image in all places. This way we can
run the CI against different versions of Redis and Redis Stack.

Run the test cluster based on the default Redis docker image, i.e.
without Stack support. This is needed in order to make the CI pass until
Stack gets a new release. What is needed is to mark all Stack related
tests accordingly, and then they don't get executed in the cluster
tests (they are already filtered out in `invoke cluster-tests`).

Take the opportunity to remove some empty tests and to fix the naming in
two tests.

---------

Co-authored-by: Gabriel Erzse <gabriel.erzse@redis.com>
---
 docker-compose.yml                    | 39 +++++++------
 dockers/Dockerfile.cluster            |  4 +-
 dockers/cluster.redis.conf            |  6 --
 dockers/create_cluster.sh             |  6 +-
 tasks.py                              |  2 +-
 tests/conftest.py                     | 17 +++++-
 tests/test_asyncio/test_bloom.py      | 45 +++++++++------
 tests/test_asyncio/test_graph.py      | 26 +++++++++
 tests/test_asyncio/test_json.py       | 47 +++++++++++++++
 tests/test_asyncio/test_search.py     |  6 ++
 tests/test_asyncio/test_timeseries.py | 59 ++++++++++++-------
 tests/test_bloom.py                   | 39 ++++++++++++-
 tests/test_cluster.py                 |  3 +
 tests/test_commands.py                | 54 ++++++++---------
 tests/test_graph.py                   | 26 ++++++++-
 tests/test_json.py                    | 83 ++++++++++++++++-----------
 tests/test_search.py                  |  4 +-
 tests/test_timeseries.py              | 50 +++++++++++++++-
 18 files changed, 384 insertions(+), 132 deletions(-)

diff --git a/docker-compose.yml b/docker-compose.yml
index 17d4b23977..09418ed094 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -5,12 +5,11 @@ version: "3.8"
 services:
 
   redis:
-    image: redis/redis-stack-server:edge
+    image: ${REDIS_IMAGE:-redis:latest}
     container_name: redis-standalone
+    command: redis-server --enable-debug-command yes
     ports:
       - 6379:6379
-    environment:
-      - "REDIS_ARGS=--enable-debug-command yes --enable-module-command yes"
     profiles:
       - standalone
       - sentinel
@@ -18,12 +17,11 @@ services:
       - all
 
   replica:
-    image: redis/redis-stack-server:edge
+    image: ${REDIS_IMAGE:-redis:latest}
     container_name: redis-replica
     depends_on:
       - redis
-    environment:
-      - "REDIS_ARGS=--replicaof redis 6379"
+    command: redis-server --replicaof redis 6379
     ports:
       - 6380:6379
     profiles:
@@ -35,6 +33,8 @@ services:
     build:
       context: .
       dockerfile: dockers/Dockerfile.cluster
+      args:
+        REDIS_IMAGE: ${REDIS_IMAGE:-redis:latest}
     ports:
       - 16379:16379
       - 16380:16380
@@ -63,13 +63,11 @@ services:
       - "./dockers/stunnel/keys:/etc/stunnel/keys:ro"
 
   sentinel:
-    image: redis/redis-stack-server:edge
+    image: ${REDIS_IMAGE:-redis:latest}
     container_name: redis-sentinel
     depends_on:
       - redis
-    environment:
-      - "REDIS_ARGS=--port 26379"
-    entrypoint: "/opt/redis-stack/bin/redis-sentinel /redis.conf --port 26379"
+    entrypoint: "/usr/local/bin/redis-sentinel /redis.conf --port 26379"
     ports:
       - 26379:26379
     volumes:
@@ -79,13 +77,11 @@ services:
       - all
 
   sentinel2:
-    image: redis/redis-stack-server:edge
+    image: ${REDIS_IMAGE:-redis:latest}
     container_name: redis-sentinel2
     depends_on:
       - redis
-    environment:
-      - "REDIS_ARGS=--port 26380"
-    entrypoint: "/opt/redis-stack/bin/redis-sentinel /redis.conf --port 26380"
+    entrypoint: "/usr/local/bin/redis-sentinel /redis.conf --port 26380"
     ports:
       - 26380:26380
     volumes:
@@ -95,11 +91,11 @@ services:
       - all
 
   sentinel3:
-    image: redis/redis-stack-server:edge
+    image: ${REDIS_IMAGE:-redis:latest}
     container_name: redis-sentinel3
     depends_on:
       - redis
-    entrypoint: "/opt/redis-stack/bin/redis-sentinel /redis.conf --port 26381"
+    entrypoint: "/usr/local/bin/redis-sentinel /redis.conf --port 26381"
     ports:
       - 26381:26381
     volumes:
@@ -107,3 +103,14 @@ services:
     profiles:
       - sentinel
       - all
+
+  redis-stack:
+    image: redis/redis-stack-server:edge
+    container_name: redis-stack
+    ports:
+      - 6479:6379
+    environment:
+      - "REDIS_ARGS=--enable-debug-command yes --enable-module-command yes"
+    profiles:
+      - standalone
+      - all
diff --git a/dockers/Dockerfile.cluster b/dockers/Dockerfile.cluster
index 3a0d73415e..4096009f9a 100644
--- a/dockers/Dockerfile.cluster
+++ b/dockers/Dockerfile.cluster
@@ -1,7 +1,7 @@
-FROM redis/redis-stack-server:edge as rss
+ARG REDIS_IMAGE=redis:latest
+FROM $REDIS_IMAGE
 
 COPY dockers/create_cluster.sh /create_cluster.sh
-RUN ls -R /opt/redis-stack
 RUN chmod a+x /create_cluster.sh
 
 ENTRYPOINT [ "/create_cluster.sh"]
diff --git a/dockers/cluster.redis.conf b/dockers/cluster.redis.conf
index d4de46fbed..e9f7617d09 100644
--- a/dockers/cluster.redis.conf
+++ b/dockers/cluster.redis.conf
@@ -1,8 +1,2 @@
 protected-mode no
 enable-debug-command yes
-loadmodule /opt/redis-stack/lib/redisearch.so
-loadmodule /opt/redis-stack/lib/redisgraph.so
-loadmodule /opt/redis-stack/lib/redistimeseries.so
-loadmodule /opt/redis-stack/lib/rejson.so
-loadmodule /opt/redis-stack/lib/redisbloom.so
-loadmodule /opt/redis-stack/lib/redisgears.so v8-plugin-path /opt/redis-stack/lib/libredisgears_v8_plugin.so
diff --git a/dockers/create_cluster.sh b/dockers/create_cluster.sh
index da9a0cb606..af41192585 100644
--- a/dockers/create_cluster.sh
+++ b/dockers/create_cluster.sh
@@ -31,7 +31,7 @@ dir /nodes/$PORT
 EOF
 
   set -x
-  /opt/redis-stack/bin/redis-server /nodes/$PORT/redis.conf
+  /usr/local/bin/redis-server /nodes/$PORT/redis.conf
   sleep 1
   if [ $? -ne 0 ]; then
     echo "Redis failed to start, exiting."
@@ -40,8 +40,8 @@ EOF
   echo 127.0.0.1:$PORT >> /nodes/nodemap
 done
 if [ -z "${REDIS_PASSWORD}" ]; then
-    echo yes | /opt/redis-stack/bin/redis-cli --cluster create `seq -f 127.0.0.1:%g ${START_PORT} ${END_PORT}` --cluster-replicas 1
+    echo yes | /usr/local/bin/redis-cli --cluster create `seq -f 127.0.0.1:%g ${START_PORT} ${END_PORT}` --cluster-replicas 1
 else
-    echo yes | opt/redis-stack/bin/redis-cli -a ${REDIS_PASSWORD} --cluster create `seq -f 127.0.0.1:%g ${START_PORT} ${END_PORT}` --cluster-replicas 1
+    echo yes | /usr/local/bin/redis-cli -a ${REDIS_PASSWORD} --cluster create `seq -f 127.0.0.1:%g ${START_PORT} ${END_PORT}` --cluster-replicas 1
 fi
 tail -f /redis.log
diff --git a/tasks.py b/tasks.py
index c60fa2791e..7f26081150 100644
--- a/tasks.py
+++ b/tasks.py
@@ -13,7 +13,7 @@
 def devenv(c):
     """Brings up the test environment, by wrapping docker compose."""
     clean(c)
-    cmd = "docker-compose --profile all up -d"
+    cmd = "docker-compose --profile all up -d --build"
     run(cmd)
 
 
diff --git a/tests/conftest.py b/tests/conftest.py
index e783b6e8f9..9263c4353d 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -18,7 +18,7 @@
 REDIS_INFO = {}
 default_redis_url = "redis://localhost:6379/0"
 default_protocol = "2"
-default_redismod_url = "redis://localhost:6379"
+default_redismod_url = "redis://localhost:6479"
 
 # default ssl client ignores verification for the purpose of testing
 default_redis_ssl_url = "rediss://localhost:6666"
@@ -341,6 +341,21 @@ def r(request):
         yield client
 
 
+@pytest.fixture()
+def stack_url(request):
+    stack_url = request.config.getoption("--redis-url", default=default_redismod_url)
+    if stack_url == default_redis_url:
+        return default_redismod_url
+    else:
+        return stack_url
+
+
+@pytest.fixture()
+def stack_r(request, stack_url):
+    with _get_client(redis.Redis, request, from_url=stack_url) as client:
+        yield client
+
+
 @pytest.fixture()
 def decoded_r(request):
     with _get_client(redis.Redis, request, decode_responses=True) as client:
diff --git a/tests/test_asyncio/test_bloom.py b/tests/test_asyncio/test_bloom.py
index 278844416f..c63559a31c 100644
--- a/tests/test_asyncio/test_bloom.py
+++ b/tests/test_asyncio/test_bloom.py
@@ -1,6 +1,7 @@
 from math import inf
 
 import pytest
+import pytest_asyncio
 import redis.asyncio as redis
 from redis.exceptions import ModuleError, RedisError
 from redis.utils import HIREDIS_AVAILABLE
@@ -11,10 +12,16 @@
 )
 
 
+@pytest_asyncio.fixture()
+async def decoded_r(create_redis, stack_url):
+    return await create_redis(decode_responses=True, url=stack_url)
+
+
 def intlist(obj):
     return [int(v) for v in obj]
 
 
+@pytest.mark.redismod
 async def test_create(decoded_r: redis.Redis):
     """Test CREATE/RESERVE calls"""
     assert await decoded_r.bf().create("bloom", 0.01, 1000)
@@ -30,10 +37,12 @@ async def test_create(decoded_r: redis.Redis):
 
 
 @pytest.mark.experimental
+@pytest.mark.redismod
 async def test_tdigest_create(decoded_r: redis.Redis):
     assert await decoded_r.tdigest().create("tDigest", 100)
 
 
+@pytest.mark.redismod
 async def test_bf_add(decoded_r: redis.Redis):
     assert await decoded_r.bf().create("bloom", 0.01, 1000)
     assert 1 == await decoded_r.bf().add("bloom", "foo")
@@ -46,6 +55,7 @@ async def test_bf_add(decoded_r: redis.Redis):
     assert [1, 0] == intlist(await decoded_r.bf().mexists("bloom", "foo", "noexist"))
 
 
+@pytest.mark.redismod
 async def test_bf_insert(decoded_r: redis.Redis):
     assert await decoded_r.bf().create("bloom", 0.01, 1000)
     assert [1] == intlist(await decoded_r.bf().insert("bloom", ["foo"]))
@@ -76,6 +86,7 @@ async def test_bf_insert(decoded_r: redis.Redis):
     )
 
 
+@pytest.mark.redismod
 async def test_bf_scandump_and_loadchunk(decoded_r: redis.Redis):
     # Store a filter
     await decoded_r.bf().create("myBloom", "0.0001", "1000")
@@ -127,6 +138,7 @@ async def do_verify():
     await decoded_r.bf().create("myBloom", "0.0001", "10000000")
 
 
+@pytest.mark.redismod
 async def test_bf_info(decoded_r: redis.Redis):
     expansion = 4
     # Store a filter
@@ -158,6 +170,7 @@ async def test_bf_info(decoded_r: redis.Redis):
         assert True
 
 
+@pytest.mark.redismod
 async def test_bf_card(decoded_r: redis.Redis):
     # return 0 if the key does not exist
     assert await decoded_r.bf().card("not_exist") == 0
@@ -172,6 +185,7 @@ async def test_bf_card(decoded_r: redis.Redis):
         await decoded_r.bf().card("setKey")
 
 
+@pytest.mark.redismod
 async def test_cf_add_and_insert(decoded_r: redis.Redis):
     assert await decoded_r.cf().create("cuckoo", 1000)
     assert await decoded_r.cf().add("cuckoo", "filter")
@@ -197,6 +211,7 @@ async def test_cf_add_and_insert(decoded_r: redis.Redis):
     )
 
 
+@pytest.mark.redismod
 async def test_cf_exists_and_del(decoded_r: redis.Redis):
     assert await decoded_r.cf().create("cuckoo", 1000)
     assert await decoded_r.cf().add("cuckoo", "filter")
@@ -208,6 +223,7 @@ async def test_cf_exists_and_del(decoded_r: redis.Redis):
     assert 0 == await decoded_r.cf().count("cuckoo", "filter")
 
 
+@pytest.mark.redismod
 async def test_cms(decoded_r: redis.Redis):
     assert await decoded_r.cms().initbydim("dim", 1000, 5)
     assert await decoded_r.cms().initbyprob("prob", 0.01, 0.01)
@@ -224,6 +240,7 @@ async def test_cms(decoded_r: redis.Redis):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 async def test_cms_merge(decoded_r: redis.Redis):
     assert await decoded_r.cms().initbydim("A", 1000, 5)
     assert await decoded_r.cms().initbydim("B", 1000, 5)
@@ -240,6 +257,7 @@ async def test_cms_merge(decoded_r: redis.Redis):
     assert [16, 15, 21] == await decoded_r.cms().query("C", "foo", "bar", "baz")
 
 
+@pytest.mark.redismod
 async def test_topk(decoded_r: redis.Redis):
     # test list with empty buckets
     assert await decoded_r.topk().reserve("topk", 3, 50, 4, 0.9)
@@ -320,6 +338,7 @@ async def test_topk(decoded_r: redis.Redis):
     assert 0.9 == round(float(info["decay"]), 1)
 
 
+@pytest.mark.redismod
 async def test_topk_incrby(decoded_r: redis.Redis):
     await decoded_r.flushdb()
     assert await decoded_r.topk().reserve("topk", 3, 10, 3, 1)
@@ -335,6 +354,7 @@ async def test_topk_incrby(decoded_r: redis.Redis):
 
 
 @pytest.mark.experimental
+@pytest.mark.redismod
 async def test_tdigest_reset(decoded_r: redis.Redis):
     assert await decoded_r.tdigest().create("tDigest", 10)
     # reset on empty histogram
@@ -351,6 +371,7 @@ async def test_tdigest_reset(decoded_r: redis.Redis):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 async def test_tdigest_merge(decoded_r: redis.Redis):
     assert await decoded_r.tdigest().create("to-tDigest", 10)
     assert await decoded_r.tdigest().create("from-tDigest", 10)
@@ -378,6 +399,7 @@ async def test_tdigest_merge(decoded_r: redis.Redis):
 
 
 @pytest.mark.experimental
+@pytest.mark.redismod
 async def test_tdigest_min_and_max(decoded_r: redis.Redis):
     assert await decoded_r.tdigest().create("tDigest", 100)
     # insert data-points into sketch
@@ -388,6 +410,7 @@ async def test_tdigest_min_and_max(decoded_r: redis.Redis):
 
 
 @pytest.mark.experimental
+@pytest.mark.redismod
 @skip_ifmodversion_lt("2.4.0", "bf")
 async def test_tdigest_quantile(decoded_r: redis.Redis):
     assert await decoded_r.tdigest().create("tDigest", 500)
@@ -416,6 +439,7 @@ async def test_tdigest_quantile(decoded_r: redis.Redis):
 
 
 @pytest.mark.experimental
+@pytest.mark.redismod
 async def test_tdigest_cdf(decoded_r: redis.Redis):
     assert await decoded_r.tdigest().create("tDigest", 100)
     # insert data-points into sketch
@@ -427,6 +451,7 @@ async def test_tdigest_cdf(decoded_r: redis.Redis):
 
 
 @pytest.mark.experimental
+@pytest.mark.redismod
 @skip_ifmodversion_lt("2.4.0", "bf")
 async def test_tdigest_trimmed_mean(decoded_r: redis.Redis):
     assert await decoded_r.tdigest().create("tDigest", 100)
@@ -437,6 +462,7 @@ async def test_tdigest_trimmed_mean(decoded_r: redis.Redis):
 
 
 @pytest.mark.experimental
+@pytest.mark.redismod
 async def test_tdigest_rank(decoded_r: redis.Redis):
     assert await decoded_r.tdigest().create("t-digest", 500)
     assert await decoded_r.tdigest().add("t-digest", list(range(0, 20)))
@@ -447,6 +473,7 @@ async def test_tdigest_rank(decoded_r: redis.Redis):
 
 
 @pytest.mark.experimental
+@pytest.mark.redismod
 async def test_tdigest_revrank(decoded_r: redis.Redis):
     assert await decoded_r.tdigest().create("t-digest", 500)
     assert await decoded_r.tdigest().add("t-digest", list(range(0, 20)))
@@ -456,6 +483,7 @@ async def test_tdigest_revrank(decoded_r: redis.Redis):
 
 
 @pytest.mark.experimental
+@pytest.mark.redismod
 async def test_tdigest_byrank(decoded_r: redis.Redis):
     assert await decoded_r.tdigest().create("t-digest", 500)
     assert await decoded_r.tdigest().add("t-digest", list(range(1, 11)))
@@ -467,6 +495,7 @@ async def test_tdigest_byrank(decoded_r: redis.Redis):
 
 
 @pytest.mark.experimental
+@pytest.mark.redismod
 async def test_tdigest_byrevrank(decoded_r: redis.Redis):
     assert await decoded_r.tdigest().create("t-digest", 500)
     assert await decoded_r.tdigest().add("t-digest", list(range(1, 11)))
@@ -475,19 +504,3 @@ async def test_tdigest_byrevrank(decoded_r: redis.Redis):
     assert (await decoded_r.tdigest().byrevrank("t-digest", 100))[0] == -inf
     with pytest.raises(redis.ResponseError):
         (await decoded_r.tdigest().byrevrank("t-digest", -1))[0]
-
-
-# # async def test_pipeline(decoded_r: redis.Redis):
-#     pipeline = await decoded_r.bf().pipeline()
-#     assert not await decoded_r.bf().execute_command("get pipeline")
-#
-#     assert await decoded_r.bf().create("pipeline", 0.01, 1000)
-#     for i in range(100):
-#         pipeline.add("pipeline", i)
-#     for i in range(100):
-#         assert not (await decoded_r.bf().exists("pipeline", i))
-#
-#     pipeline.execute()
-#
-#     for i in range(100):
-#         assert await decoded_r.bf().exists("pipeline", i)
diff --git a/tests/test_asyncio/test_graph.py b/tests/test_asyncio/test_graph.py
index 4caf79470e..9cd9149dcc 100644
--- a/tests/test_asyncio/test_graph.py
+++ b/tests/test_asyncio/test_graph.py
@@ -1,4 +1,5 @@
 import pytest
+import pytest_asyncio
 import redis.asyncio as redis
 from redis.commands.graph import Edge, Node, Path
 from redis.commands.graph.execution_plan import Operation
@@ -6,12 +7,19 @@
 from tests.conftest import skip_if_redis_enterprise
 
 
+@pytest_asyncio.fixture()
+async def decoded_r(create_redis, stack_url):
+    return await create_redis(decode_responses=True, url=stack_url)
+
+
+@pytest.mark.redismod
 async def test_bulk(decoded_r):
     with pytest.raises(NotImplementedError):
         await decoded_r.graph().bulk()
         await decoded_r.graph().bulk(foo="bar!")
 
 
+@pytest.mark.redismod
 async def test_graph_creation(decoded_r: redis.Redis):
     graph = decoded_r.graph()
 
@@ -56,6 +64,7 @@ async def test_graph_creation(decoded_r: redis.Redis):
     await graph.delete()
 
 
+@pytest.mark.redismod
 async def test_array_functions(decoded_r: redis.Redis):
     graph = decoded_r.graph()
 
@@ -78,6 +87,7 @@ async def test_array_functions(decoded_r: redis.Redis):
     assert [a] == result.result_set[0][0]
 
 
+@pytest.mark.redismod
 async def test_path(decoded_r: redis.Redis):
     node0 = Node(node_id=0, label="L1")
     node1 = Node(node_id=1, label="L1")
@@ -97,6 +107,7 @@ async def test_path(decoded_r: redis.Redis):
     assert expected_results == result.result_set
 
 
+@pytest.mark.redismod
 async def test_param(decoded_r: redis.Redis):
     params = [1, 2.3, "str", True, False, None, [0, 1, 2]]
     query = "RETURN $param"
@@ -106,6 +117,7 @@ async def test_param(decoded_r: redis.Redis):
         assert expected_results == result.result_set
 
 
+@pytest.mark.redismod
 async def test_map(decoded_r: redis.Redis):
     query = "RETURN {a:1, b:'str', c:NULL, d:[1,2,3], e:True, f:{x:1, y:2}}"
 
@@ -122,6 +134,7 @@ async def test_map(decoded_r: redis.Redis):
     assert actual == expected
 
 
+@pytest.mark.redismod
 async def test_point(decoded_r: redis.Redis):
     query = "RETURN point({latitude: 32.070794860, longitude: 34.820751118})"
     expected_lat = 32.070794860
@@ -138,6 +151,7 @@ async def test_point(decoded_r: redis.Redis):
     assert abs(actual["longitude"] - expected_lon) < 0.001
 
 
+@pytest.mark.redismod
 async def test_index_response(decoded_r: redis.Redis):
     result_set = await decoded_r.graph().query("CREATE INDEX ON :person(age)")
     assert 1 == result_set.indices_created
@@ -152,6 +166,7 @@ async def test_index_response(decoded_r: redis.Redis):
         await decoded_r.graph().query("DROP INDEX ON :person(age)")
 
 
+@pytest.mark.redismod
 async def test_stringify_query_result(decoded_r: redis.Redis):
     graph = decoded_r.graph()
 
@@ -205,6 +220,7 @@ async def test_stringify_query_result(decoded_r: redis.Redis):
     await graph.delete()
 
 
+@pytest.mark.redismod
 async def test_optional_match(decoded_r: redis.Redis):
     # Build a graph of form (a)-[R]->(b)
     node0 = Node(node_id=0, label="L1", properties={"value": "a"})
@@ -229,6 +245,7 @@ async def test_optional_match(decoded_r: redis.Redis):
     await graph.delete()
 
 
+@pytest.mark.redismod
 async def test_cached_execution(decoded_r: redis.Redis):
     await decoded_r.graph().query("CREATE ()")
 
@@ -248,6 +265,7 @@ async def test_cached_execution(decoded_r: redis.Redis):
     assert cached_result.cached_execution
 
 
+@pytest.mark.redismod
 async def test_slowlog(decoded_r: redis.Redis):
     create_query = """CREATE
     (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
@@ -261,6 +279,7 @@ async def test_slowlog(decoded_r: redis.Redis):
 
 
 @pytest.mark.xfail(strict=False)
+@pytest.mark.redismod
 async def test_query_timeout(decoded_r: redis.Redis):
     # Build a sample graph with 1000 nodes.
     await decoded_r.graph().query("UNWIND range(0,1000) as val CREATE ({v: val})")
@@ -274,6 +293,7 @@ async def test_query_timeout(decoded_r: redis.Redis):
         assert False is False
 
 
+@pytest.mark.redismod
 async def test_read_only_query(decoded_r: redis.Redis):
     with pytest.raises(Exception):
         # Issue a write query, specifying read-only true,
@@ -282,6 +302,7 @@ async def test_read_only_query(decoded_r: redis.Redis):
         assert False is False
 
 
+@pytest.mark.redismod
 async def test_profile(decoded_r: redis.Redis):
     q = """UNWIND range(1, 3) AS x CREATE (p:Person {v:x})"""
     profile = (await decoded_r.graph().profile(q)).result_set
@@ -297,6 +318,7 @@ async def test_profile(decoded_r: redis.Redis):
 
 
 @skip_if_redis_enterprise()
+@pytest.mark.redismod
 async def test_config(decoded_r: redis.Redis):
     config_name = "RESULTSET_SIZE"
     config_value = 3
@@ -328,6 +350,7 @@ async def test_config(decoded_r: redis.Redis):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 async def test_list_keys(decoded_r: redis.Redis):
     result = await decoded_r.graph().list_keys()
     assert result == []
@@ -350,6 +373,7 @@ async def test_list_keys(decoded_r: redis.Redis):
     assert result == []
 
 
+@pytest.mark.redismod
 async def test_multi_label(decoded_r: redis.Redis):
     redis_graph = decoded_r.graph("g")
 
@@ -375,6 +399,7 @@ async def test_multi_label(decoded_r: redis.Redis):
         assert True
 
 
+@pytest.mark.redismod
 async def test_execution_plan(decoded_r: redis.Redis):
     redis_graph = decoded_r.graph("execution_plan")
     create_query = """CREATE
@@ -393,6 +418,7 @@ async def test_execution_plan(decoded_r: redis.Redis):
     await redis_graph.delete()
 
 
+@pytest.mark.redismod
 async def test_explain(decoded_r: redis.Redis):
     redis_graph = decoded_r.graph("execution_plan")
     # graph creation / population
diff --git a/tests/test_asyncio/test_json.py b/tests/test_asyncio/test_json.py
index 920ec71dce..c713f1aca2 100644
--- a/tests/test_asyncio/test_json.py
+++ b/tests/test_asyncio/test_json.py
@@ -1,10 +1,17 @@
 import pytest
+import pytest_asyncio
 import redis.asyncio as redis
 from redis import exceptions
 from redis.commands.json.path import Path
 from tests.conftest import assert_resp_response, skip_ifmodversion_lt
 
 
+@pytest_asyncio.fixture()
+async def decoded_r(create_redis, stack_url):
+    return await create_redis(decode_responses=True, url=stack_url)
+
+
+@pytest.mark.redismod
 async def test_json_setbinarykey(decoded_r: redis.Redis):
     d = {"hello": "world", b"some": "value"}
     with pytest.raises(TypeError):
@@ -12,6 +19,7 @@ async def test_json_setbinarykey(decoded_r: redis.Redis):
     assert await decoded_r.json().set("somekey", Path.root_path(), d, decode_keys=True)
 
 
+@pytest.mark.redismod
 async def test_json_setgetdeleteforget(decoded_r: redis.Redis):
     assert await decoded_r.json().set("foo", Path.root_path(), "bar")
     assert_resp_response(decoded_r, await decoded_r.json().get("foo"), "bar", [["bar"]])
@@ -21,11 +29,13 @@ async def test_json_setgetdeleteforget(decoded_r: redis.Redis):
     assert await decoded_r.exists("foo") == 0
 
 
+@pytest.mark.redismod
 async def test_jsonget(decoded_r: redis.Redis):
     await decoded_r.json().set("foo", Path.root_path(), "bar")
     assert_resp_response(decoded_r, await decoded_r.json().get("foo"), "bar", [["bar"]])
 
 
+@pytest.mark.redismod
 async def test_json_get_jset(decoded_r: redis.Redis):
     assert await decoded_r.json().set("foo", Path.root_path(), "bar")
     assert_resp_response(decoded_r, await decoded_r.json().get("foo"), "bar", [["bar"]])
@@ -34,6 +44,7 @@ async def test_json_get_jset(decoded_r: redis.Redis):
     assert await decoded_r.exists("foo") == 0
 
 
+@pytest.mark.redismod
 async def test_nonascii_setgetdelete(decoded_r: redis.Redis):
     assert await decoded_r.json().set("notascii", Path.root_path(), "hyvää-élève")
     res = "hyvää-élève"
@@ -44,6 +55,7 @@ async def test_nonascii_setgetdelete(decoded_r: redis.Redis):
     assert await decoded_r.exists("notascii") == 0
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("2.6.0", "ReJSON")
 async def test_json_merge(decoded_r: redis.Redis):
     # Test with root path $
@@ -78,6 +90,7 @@ async def test_json_merge(decoded_r: redis.Redis):
     }
 
 
+@pytest.mark.redismod
 async def test_jsonsetexistentialmodifiersshouldsucceed(decoded_r: redis.Redis):
     obj = {"foo": "bar"}
     assert await decoded_r.json().set("obj", Path.root_path(), obj)
@@ -95,6 +108,7 @@ async def test_jsonsetexistentialmodifiersshouldsucceed(decoded_r: redis.Redis):
         await decoded_r.json().set("obj", Path("foo"), "baz", nx=True, xx=True)
 
 
+@pytest.mark.redismod
 async def test_mgetshouldsucceed(decoded_r: redis.Redis):
     await decoded_r.json().set("1", Path.root_path(), 1)
     await decoded_r.json().set("2", Path.root_path(), 2)
@@ -104,6 +118,7 @@ async def test_mgetshouldsucceed(decoded_r: redis.Redis):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 @skip_ifmodversion_lt("2.6.0", "ReJSON")
 async def test_mset(decoded_r: redis.Redis):
     await decoded_r.json().mset(
@@ -114,6 +129,7 @@ async def test_mset(decoded_r: redis.Redis):
     assert await decoded_r.json().mget(["1", "2"], Path.root_path()) == [1, 2]
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
 async def test_clear(decoded_r: redis.Redis):
     await decoded_r.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
@@ -121,6 +137,7 @@ async def test_clear(decoded_r: redis.Redis):
     assert_resp_response(decoded_r, await decoded_r.json().get("arr"), [], [[[]]])
 
 
+@pytest.mark.redismod
 async def test_type(decoded_r: redis.Redis):
     await decoded_r.json().set("1", Path.root_path(), 1)
     assert_resp_response(
@@ -134,6 +151,7 @@ async def test_type(decoded_r: redis.Redis):
     )
 
 
+@pytest.mark.redismod
 async def test_numincrby(decoded_r):
     await decoded_r.json().set("num", Path.root_path(), 1)
     assert_resp_response(
@@ -145,6 +163,7 @@ async def test_numincrby(decoded_r):
     assert_resp_response(decoded_r, res, 1.25, [1.25])
 
 
+@pytest.mark.redismod
 async def test_nummultby(decoded_r: redis.Redis):
     await decoded_r.json().set("num", Path.root_path(), 1)
 
@@ -157,6 +176,7 @@ async def test_nummultby(decoded_r: redis.Redis):
         assert_resp_response(decoded_r, res, 2.5, [2.5])
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
 async def test_toggle(decoded_r: redis.Redis):
     await decoded_r.json().set("bool", Path.root_path(), False)
@@ -168,6 +188,7 @@ async def test_toggle(decoded_r: redis.Redis):
         await decoded_r.json().toggle("num", Path.root_path())
 
 
+@pytest.mark.redismod
 async def test_strappend(decoded_r: redis.Redis):
     await decoded_r.json().set("jsonkey", Path.root_path(), "foo")
     assert 6 == await decoded_r.json().strappend("jsonkey", "bar")
@@ -175,6 +196,7 @@ async def test_strappend(decoded_r: redis.Redis):
     assert_resp_response(decoded_r, res, "foobar", [["foobar"]])
 
 
+@pytest.mark.redismod
 async def test_strlen(decoded_r: redis.Redis):
     await decoded_r.json().set("str", Path.root_path(), "foo")
     assert 3 == await decoded_r.json().strlen("str", Path.root_path())
@@ -183,6 +205,7 @@ async def test_strlen(decoded_r: redis.Redis):
     assert 6 == await decoded_r.json().strlen("str")
 
 
+@pytest.mark.redismod
 async def test_arrappend(decoded_r: redis.Redis):
     await decoded_r.json().set("arr", Path.root_path(), [1])
     assert 2 == await decoded_r.json().arrappend("arr", Path.root_path(), 2)
@@ -190,6 +213,7 @@ async def test_arrappend(decoded_r: redis.Redis):
     assert 7 == await decoded_r.json().arrappend("arr", Path.root_path(), *[5, 6, 7])
 
 
+@pytest.mark.redismod
 async def test_arrindex(decoded_r: redis.Redis):
     r_path = Path.root_path()
     await decoded_r.json().set("arr", r_path, [0, 1, 2, 3, 4])
@@ -202,6 +226,7 @@ async def test_arrindex(decoded_r: redis.Redis):
     assert -1 == await decoded_r.json().arrindex("arr", r_path, 4, start=1, stop=3)
 
 
+@pytest.mark.redismod
 async def test_arrinsert(decoded_r: redis.Redis):
     await decoded_r.json().set("arr", Path.root_path(), [0, 4])
     assert 5 == await decoded_r.json().arrinsert("arr", Path.root_path(), 1, *[1, 2, 3])
@@ -215,6 +240,7 @@ async def test_arrinsert(decoded_r: redis.Redis):
     assert_resp_response(decoded_r, await decoded_r.json().get("val2"), res, [[res]])
 
 
+@pytest.mark.redismod
 async def test_arrlen(decoded_r: redis.Redis):
     await decoded_r.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
     assert 5 == await decoded_r.json().arrlen("arr", Path.root_path())
@@ -222,6 +248,7 @@ async def test_arrlen(decoded_r: redis.Redis):
     assert await decoded_r.json().arrlen("fakekey") is None
 
 
+@pytest.mark.redismod
 async def test_arrpop(decoded_r: redis.Redis):
     await decoded_r.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
     assert 4 == await decoded_r.json().arrpop("arr", Path.root_path(), 4)
@@ -239,6 +266,7 @@ async def test_arrpop(decoded_r: redis.Redis):
     assert await decoded_r.json().arrpop("arr") is None
 
 
+@pytest.mark.redismod
 async def test_arrtrim(decoded_r: redis.Redis):
     await decoded_r.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
     assert 3 == await decoded_r.json().arrtrim("arr", Path.root_path(), 1, 3)
@@ -262,6 +290,7 @@ async def test_arrtrim(decoded_r: redis.Redis):
     assert 0 == await decoded_r.json().arrtrim("arr", Path.root_path(), 9, 11)
 
 
+@pytest.mark.redismod
 async def test_resp(decoded_r: redis.Redis):
     obj = {"foo": "bar", "baz": 1, "qaz": True}
     await decoded_r.json().set("obj", Path.root_path(), obj)
@@ -271,6 +300,7 @@ async def test_resp(decoded_r: redis.Redis):
     assert isinstance(await decoded_r.json().resp("obj"), list)
 
 
+@pytest.mark.redismod
 async def test_objkeys(decoded_r: redis.Redis):
     obj = {"foo": "bar", "baz": "qaz"}
     await decoded_r.json().set("obj", Path.root_path(), obj)
@@ -287,6 +317,7 @@ async def test_objkeys(decoded_r: redis.Redis):
     assert await decoded_r.json().objkeys("fakekey") is None
 
 
+@pytest.mark.redismod
 async def test_objlen(decoded_r: redis.Redis):
     obj = {"foo": "bar", "baz": "qaz"}
     await decoded_r.json().set("obj", Path.root_path(), obj)
@@ -320,6 +351,7 @@ async def test_objlen(decoded_r: redis.Redis):
 #     assert await decoded_r.get("foo") is None
 
 
+@pytest.mark.redismod
 async def test_json_delete_with_dollar(decoded_r: redis.Redis):
     doc1 = {"a": 1, "nested": {"a": 2, "b": 3}}
     assert await decoded_r.json().set("doc1", "$", doc1)
@@ -373,6 +405,7 @@ async def test_json_delete_with_dollar(decoded_r: redis.Redis):
     await decoded_r.json().delete("not_a_document", "..a")
 
 
+@pytest.mark.redismod
 async def test_json_forget_with_dollar(decoded_r: redis.Redis):
     doc1 = {"a": 1, "nested": {"a": 2, "b": 3}}
     assert await decoded_r.json().set("doc1", "$", doc1)
@@ -426,6 +459,7 @@ async def test_json_forget_with_dollar(decoded_r: redis.Redis):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 async def test_json_mget_dollar(decoded_r: redis.Redis):
     # Test mget with multi paths
     await decoded_r.json().set(
@@ -461,6 +495,7 @@ async def test_json_mget_dollar(decoded_r: redis.Redis):
     assert res == [None, None]
 
 
+@pytest.mark.redismod
 async def test_numby_commands_dollar(decoded_r: redis.Redis):
     # Test NUMINCRBY
     await decoded_r.json().set(
@@ -515,6 +550,7 @@ async def test_numby_commands_dollar(decoded_r: redis.Redis):
         await decoded_r.json().nummultby("doc1", ".b[0].a", 3) == 6
 
 
+@pytest.mark.redismod
 async def test_strappend_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1", "$", {"a": "foo", "nested1": {"a": "hello"}, "nested2": {"a": 31}}
@@ -545,6 +581,7 @@ async def test_strappend_dollar(decoded_r: redis.Redis):
         await decoded_r.json().strappend("doc1", "piu")
 
 
+@pytest.mark.redismod
 async def test_strlen_dollar(decoded_r: redis.Redis):
     # Test multi
     await decoded_r.json().set(
@@ -565,6 +602,7 @@ async def test_strlen_dollar(decoded_r: redis.Redis):
         await decoded_r.json().strlen("non_existing_doc", "$..a")
 
 
+@pytest.mark.redismod
 async def test_arrappend_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1",
@@ -638,6 +676,7 @@ async def test_arrappend_dollar(decoded_r: redis.Redis):
         await decoded_r.json().arrappend("non_existing_doc", "$..a")
 
 
+@pytest.mark.redismod
 async def test_arrinsert_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1",
@@ -676,6 +715,7 @@ async def test_arrinsert_dollar(decoded_r: redis.Redis):
         await decoded_r.json().arrappend("non_existing_doc", "$..a")
 
 
+@pytest.mark.redismod
 async def test_arrlen_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1",
@@ -721,6 +761,7 @@ async def test_arrlen_dollar(decoded_r: redis.Redis):
     assert await decoded_r.json().arrlen("non_existing_doc", "..a") is None
 
 
+@pytest.mark.redismod
 async def test_arrpop_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1",
@@ -762,6 +803,7 @@ async def test_arrpop_dollar(decoded_r: redis.Redis):
         await decoded_r.json().arrpop("non_existing_doc", "..a")
 
 
+@pytest.mark.redismod
 async def test_arrtrim_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1",
@@ -813,6 +855,7 @@ async def test_arrtrim_dollar(decoded_r: redis.Redis):
         await decoded_r.json().arrtrim("non_existing_doc", "..a", 1, 1)
 
 
+@pytest.mark.redismod
 async def test_objkeys_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1",
@@ -842,6 +885,7 @@ async def test_objkeys_dollar(decoded_r: redis.Redis):
     assert await decoded_r.json().objkeys("doc1", "$..nowhere") == []
 
 
+@pytest.mark.redismod
 async def test_objlen_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1",
@@ -896,6 +940,7 @@ def load_types_data(nested_key_name):
     return jdata, types
 
 
+@pytest.mark.redismod
 async def test_type_dollar(decoded_r: redis.Redis):
     jdata, jtypes = load_types_data("a")
     await decoded_r.json().set("doc1", "$", jdata)
@@ -914,6 +959,7 @@ async def test_type_dollar(decoded_r: redis.Redis):
     )
 
 
+@pytest.mark.redismod
 async def test_clear_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1",
@@ -967,6 +1013,7 @@ async def test_clear_dollar(decoded_r: redis.Redis):
         await decoded_r.json().clear("non_existing_doc", "$..a")
 
 
+@pytest.mark.redismod
 async def test_toggle_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1",
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 8d42d08b66..4cc00c8e5f 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -5,6 +5,7 @@
 from io import TextIOWrapper
 
 import pytest
+import pytest_asyncio
 import redis.asyncio as redis
 import redis.commands.search
 import redis.commands.search.aggregation as aggregations
@@ -31,6 +32,11 @@
 )
 
 
+@pytest_asyncio.fixture()
+async def decoded_r(create_redis, stack_url):
+    return await create_redis(decode_responses=True, url=stack_url)
+
+
 async def waitForIndex(env, idx, timeout=None):
     delay = 0.1
     while True:
diff --git a/tests/test_asyncio/test_timeseries.py b/tests/test_asyncio/test_timeseries.py
index b44219707e..0c78ce0941 100644
--- a/tests/test_asyncio/test_timeseries.py
+++ b/tests/test_asyncio/test_timeseries.py
@@ -2,6 +2,7 @@
 from time import sleep
 
 import pytest
+import pytest_asyncio
 import redis.asyncio as redis
 from tests.conftest import (
     assert_resp_response,
@@ -10,6 +11,12 @@
 )
 
 
+@pytest_asyncio.fixture()
+async def decoded_r(create_redis, stack_url):
+    return await create_redis(decode_responses=True, url=stack_url)
+
+
+@pytest.mark.redismod
 async def test_create(decoded_r: redis.Redis):
     assert await decoded_r.ts().create(1)
     assert await decoded_r.ts().create(2, retention_msecs=5)
@@ -27,6 +34,7 @@ async def test_create(decoded_r: redis.Redis):
     assert_resp_response(decoded_r, 128, info.get("chunk_size"), info.get("chunkSize"))
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
 async def test_create_duplicate_policy(decoded_r: redis.Redis):
     # Test for duplicate policy
@@ -42,6 +50,7 @@ async def test_create_duplicate_policy(decoded_r: redis.Redis):
         )
 
 
+@pytest.mark.redismod
 async def test_alter(decoded_r: redis.Redis):
     assert await decoded_r.ts().create(1)
     res = await decoded_r.ts().info(1)
@@ -64,6 +73,7 @@ async def test_alter(decoded_r: redis.Redis):
     )
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
 async def test_alter_diplicate_policy(decoded_r: redis.Redis):
     assert await decoded_r.ts().create(1)
@@ -78,6 +88,7 @@ async def test_alter_diplicate_policy(decoded_r: redis.Redis):
     )
 
 
+@pytest.mark.redismod
 async def test_add(decoded_r: redis.Redis):
     assert 1 == await decoded_r.ts().add(1, 1, 1)
     assert 2 == await decoded_r.ts().add(2, 2, 3, retention_msecs=10)
@@ -100,6 +111,7 @@ async def test_add(decoded_r: redis.Redis):
     assert_resp_response(decoded_r, 128, info.get("chunk_size"), info.get("chunkSize"))
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
 async def test_add_duplicate_policy(r: redis.Redis):
     # Test for duplicate policy BLOCK
@@ -140,6 +152,7 @@ async def test_add_duplicate_policy(r: redis.Redis):
     assert 5.0 == res[1]
 
 
+@pytest.mark.redismod
 async def test_madd(decoded_r: redis.Redis):
     await decoded_r.ts().create("a")
     assert [1, 2, 3] == await decoded_r.ts().madd(
@@ -147,6 +160,7 @@ async def test_madd(decoded_r: redis.Redis):
     )
 
 
+@pytest.mark.redismod
 async def test_incrby_decrby(decoded_r: redis.Redis):
     for _ in range(100):
         assert await decoded_r.ts().incrby(1, 1)
@@ -175,6 +189,7 @@ async def test_incrby_decrby(decoded_r: redis.Redis):
     assert_resp_response(decoded_r, 128, info.get("chunk_size"), info.get("chunkSize"))
 
 
+@pytest.mark.redismod
 async def test_create_and_delete_rule(decoded_r: redis.Redis):
     # test rule creation
     time = 100
@@ -198,6 +213,7 @@ async def test_create_and_delete_rule(decoded_r: redis.Redis):
     assert not info["rules"]
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 async def test_del_range(decoded_r: redis.Redis):
     try:
@@ -214,20 +230,24 @@ async def test_del_range(decoded_r: redis.Redis):
     )
 
 
-async def test_range(r: redis.Redis):
+@pytest.mark.redismod
+async def test_range(decoded_r: redis.Redis):
     for i in range(100):
-        await r.ts().add(1, i, i % 7)
-    assert 100 == len(await r.ts().range(1, 0, 200))
+        await decoded_r.ts().add(1, i, i % 7)
+    assert 100 == len(await decoded_r.ts().range(1, 0, 200))
     for i in range(100):
-        await r.ts().add(1, i + 200, i % 7)
-    assert 200 == len(await r.ts().range(1, 0, 500))
+        await decoded_r.ts().add(1, i + 200, i % 7)
+    assert 200 == len(await decoded_r.ts().range(1, 0, 500))
     # last sample isn't returned
     assert 20 == len(
-        await r.ts().range(1, 0, 500, aggregation_type="avg", bucket_size_msec=10)
+        await decoded_r.ts().range(
+            1, 0, 500, aggregation_type="avg", bucket_size_msec=10
+        )
     )
-    assert 10 == len(await r.ts().range(1, 0, 500, count=10))
+    assert 10 == len(await decoded_r.ts().range(1, 0, 500, count=10))
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 async def test_range_advanced(decoded_r: redis.Redis):
     for i in range(100):
@@ -258,6 +278,7 @@ async def test_range_advanced(decoded_r: redis.Redis):
     assert_resp_response(decoded_r, res, [(0, 2.55), (10, 3.0)], [[0, 2.55], [10, 3.0]])
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 async def test_rev_range(decoded_r: redis.Redis):
     for i in range(100):
@@ -302,6 +323,7 @@ async def test_rev_range(decoded_r: redis.Redis):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 async def test_multi_range(decoded_r: redis.Redis):
     await decoded_r.ts().create(1, labels={"Test": "This", "team": "ny"})
     await decoded_r.ts().create(
@@ -356,6 +378,7 @@ async def test_multi_range(decoded_r: redis.Redis):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 async def test_multi_range_advanced(decoded_r: redis.Redis):
     await decoded_r.ts().create(1, labels={"Test": "This", "team": "ny"})
@@ -473,6 +496,7 @@ async def test_multi_range_advanced(decoded_r: redis.Redis):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 async def test_multi_reverse_range(decoded_r: redis.Redis):
     await decoded_r.ts().create(1, labels={"Test": "This", "team": "ny"})
@@ -635,6 +659,7 @@ async def test_multi_reverse_range(decoded_r: redis.Redis):
         assert [[1, 10.0], [0, 1.0]] == res["1"][2]
 
 
+@pytest.mark.redismod
 async def test_get(decoded_r: redis.Redis):
     name = "test"
     await decoded_r.ts().create(name)
@@ -646,6 +671,7 @@ async def test_get(decoded_r: redis.Redis):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 async def test_mget(decoded_r: redis.Redis):
     await decoded_r.ts().create(1, labels={"Test": "This"})
     await decoded_r.ts().create(2, labels={"Test": "This", "Taste": "That"})
@@ -680,6 +706,7 @@ async def test_mget(decoded_r: redis.Redis):
         assert {"Taste": "That", "Test": "This"} == res["2"][0]
 
 
+@pytest.mark.redismod
 async def test_info(decoded_r: redis.Redis):
     await decoded_r.ts().create(
         1, retention_msecs=5, labels={"currentLabel": "currentData"}
@@ -691,8 +718,9 @@ async def test_info(decoded_r: redis.Redis):
     assert info["labels"]["currentLabel"] == "currentData"
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
-async def testInfoDuplicatePolicy(decoded_r: redis.Redis):
+async def test_info_duplicate_policy(decoded_r: redis.Redis):
     await decoded_r.ts().create(
         1, retention_msecs=5, labels={"currentLabel": "currentData"}
     )
@@ -709,6 +737,7 @@ async def testInfoDuplicatePolicy(decoded_r: redis.Redis):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 async def test_query_index(decoded_r: redis.Redis):
     await decoded_r.ts().create(1, labels={"Test": "This"})
     await decoded_r.ts().create(2, labels={"Test": "This", "Taste": "That"})
@@ -719,19 +748,7 @@ async def test_query_index(decoded_r: redis.Redis):
     )
 
 
-# # async def test_pipeline(r: redis.Redis):
-#     pipeline = await r.ts().pipeline()
-#     pipeline.create("with_pipeline")
-#     for i in range(100):
-#         pipeline.add("with_pipeline", i, 1.1 * i)
-#     pipeline.execute()
-
-#     info = await r.ts().info("with_pipeline")
-#     assert info.lastTimeStamp == 99
-#     assert info.total_samples == 100
-#     assert await r.ts().get("with_pipeline")[1] == 99 * 1.1
-
-
+@pytest.mark.redismod
 async def test_uncompressed(decoded_r: redis.Redis):
     await decoded_r.ts().create("compressed")
     await decoded_r.ts().create("uncompressed", uncompressed=True)
diff --git a/tests/test_bloom.py b/tests/test_bloom.py
index 464a946f54..d1a0484225 100644
--- a/tests/test_bloom.py
+++ b/tests/test_bloom.py
@@ -5,7 +5,20 @@
 from redis.exceptions import ModuleError, RedisError
 from redis.utils import HIREDIS_AVAILABLE
 
-from .conftest import assert_resp_response, is_resp2_connection, skip_ifmodversion_lt
+from .conftest import (
+    _get_client,
+    assert_resp_response,
+    is_resp2_connection,
+    skip_ifmodversion_lt,
+)
+
+
+@pytest.fixture()
+def decoded_r(request, stack_url):
+    with _get_client(
+        redis.Redis, request, decode_responses=True, from_url=stack_url
+    ) as client:
+        yield client
 
 
 def intlist(obj):
@@ -24,6 +37,7 @@ def client(decoded_r):
     return decoded_r
 
 
+@pytest.mark.redismod
 def test_create(client):
     """Test CREATE/RESERVE calls"""
     assert client.bf().create("bloom", 0.01, 1000)
@@ -38,6 +52,7 @@ def test_create(client):
     assert client.topk().reserve("topk", 5, 100, 5, 0.9)
 
 
+@pytest.mark.redismod
 def test_bf_reserve(client):
     """Testing BF.RESERVE"""
     assert client.bf().reserve("bloom", 0.01, 1000)
@@ -53,10 +68,12 @@ def test_bf_reserve(client):
 
 
 @pytest.mark.experimental
+@pytest.mark.redismod
 def test_tdigest_create(client):
     assert client.tdigest().create("tDigest", 100)
 
 
+@pytest.mark.redismod
 def test_bf_add(client):
     assert client.bf().create("bloom", 0.01, 1000)
     assert 1 == client.bf().add("bloom", "foo")
@@ -69,6 +86,7 @@ def test_bf_add(client):
     assert [1, 0] == intlist(client.bf().mexists("bloom", "foo", "noexist"))
 
 
+@pytest.mark.redismod
 def test_bf_insert(client):
     assert client.bf().create("bloom", 0.01, 1000)
     assert [1] == intlist(client.bf().insert("bloom", ["foo"]))
@@ -99,6 +117,7 @@ def test_bf_insert(client):
     )
 
 
+@pytest.mark.redismod
 def test_bf_scandump_and_loadchunk(client):
     # Store a filter
     client.bf().create("myBloom", "0.0001", "1000")
@@ -150,6 +169,7 @@ def do_verify():
     client.bf().create("myBloom", "0.0001", "10000000")
 
 
+@pytest.mark.redismod
 def test_bf_info(client):
     expansion = 4
     # Store a filter
@@ -181,6 +201,7 @@ def test_bf_info(client):
         assert True
 
 
+@pytest.mark.redismod
 def test_bf_card(client):
     # return 0 if the key does not exist
     assert client.bf().card("not_exist") == 0
@@ -195,6 +216,7 @@ def test_bf_card(client):
         client.bf().card("setKey")
 
 
+@pytest.mark.redismod
 def test_cf_add_and_insert(client):
     assert client.cf().create("cuckoo", 1000)
     assert client.cf().add("cuckoo", "filter")
@@ -220,6 +242,7 @@ def test_cf_add_and_insert(client):
     )
 
 
+@pytest.mark.redismod
 def test_cf_exists_and_del(client):
     assert client.cf().create("cuckoo", 1000)
     assert client.cf().add("cuckoo", "filter")
@@ -232,6 +255,7 @@ def test_cf_exists_and_del(client):
     assert 0 == client.cf().count("cuckoo", "filter")
 
 
+@pytest.mark.redismod
 def test_cms(client):
     assert client.cms().initbydim("dim", 1000, 5)
     assert client.cms().initbyprob("prob", 0.01, 0.01)
@@ -248,6 +272,7 @@ def test_cms(client):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 def test_cms_merge(client):
     assert client.cms().initbydim("A", 1000, 5)
     assert client.cms().initbydim("B", 1000, 5)
@@ -264,6 +289,7 @@ def test_cms_merge(client):
     assert [16, 15, 21] == client.cms().query("C", "foo", "bar", "baz")
 
 
+@pytest.mark.redismod
 def test_topk(client):
     # test list with empty buckets
     assert client.topk().reserve("topk", 3, 50, 4, 0.9)
@@ -343,6 +369,7 @@ def test_topk(client):
     assert 0.9 == round(float(info["decay"]), 1)
 
 
+@pytest.mark.redismod
 def test_topk_incrby(client):
     client.flushdb()
     assert client.topk().reserve("topk", 3, 10, 3, 1)
@@ -357,6 +384,7 @@ def test_topk_incrby(client):
 
 
 @pytest.mark.experimental
+@pytest.mark.redismod
 def test_tdigest_reset(client):
     assert client.tdigest().create("tDigest", 10)
     # reset on empty histogram
@@ -373,6 +401,7 @@ def test_tdigest_reset(client):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 def test_tdigest_merge(client):
     assert client.tdigest().create("to-tDigest", 10)
     assert client.tdigest().create("from-tDigest", 10)
@@ -400,6 +429,7 @@ def test_tdigest_merge(client):
 
 
 @pytest.mark.experimental
+@pytest.mark.redismod
 def test_tdigest_min_and_max(client):
     assert client.tdigest().create("tDigest", 100)
     # insert data-points into sketch
@@ -410,6 +440,7 @@ def test_tdigest_min_and_max(client):
 
 
 @pytest.mark.experimental
+@pytest.mark.redismod
 @skip_ifmodversion_lt("2.4.0", "bf")
 def test_tdigest_quantile(client):
     assert client.tdigest().create("tDigest", 500)
@@ -431,6 +462,7 @@ def test_tdigest_quantile(client):
 
 
 @pytest.mark.experimental
+@pytest.mark.redismod
 def test_tdigest_cdf(client):
     assert client.tdigest().create("tDigest", 100)
     # insert data-points into sketch
@@ -442,6 +474,7 @@ def test_tdigest_cdf(client):
 
 
 @pytest.mark.experimental
+@pytest.mark.redismod
 @skip_ifmodversion_lt("2.4.0", "bf")
 def test_tdigest_trimmed_mean(client):
     assert client.tdigest().create("tDigest", 100)
@@ -452,6 +485,7 @@ def test_tdigest_trimmed_mean(client):
 
 
 @pytest.mark.experimental
+@pytest.mark.redismod
 def test_tdigest_rank(client):
     assert client.tdigest().create("t-digest", 500)
     assert client.tdigest().add("t-digest", list(range(0, 20)))
@@ -462,6 +496,7 @@ def test_tdigest_rank(client):
 
 
 @pytest.mark.experimental
+@pytest.mark.redismod
 def test_tdigest_revrank(client):
     assert client.tdigest().create("t-digest", 500)
     assert client.tdigest().add("t-digest", list(range(0, 20)))
@@ -471,6 +506,7 @@ def test_tdigest_revrank(client):
 
 
 @pytest.mark.experimental
+@pytest.mark.redismod
 def test_tdigest_byrank(client):
     assert client.tdigest().create("t-digest", 500)
     assert client.tdigest().add("t-digest", list(range(1, 11)))
@@ -482,6 +518,7 @@ def test_tdigest_byrank(client):
 
 
 @pytest.mark.experimental
+@pytest.mark.redismod
 def test_tdigest_byrevrank(client):
     assert client.tdigest().create("t-digest", 500)
     assert client.tdigest().add("t-digest", list(range(1, 11)))
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 1f505b816d..d41ebcd506 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -2450,6 +2450,7 @@ def try_delete_libs(self, r, *lib_names):
             except Exception:
                 pass
 
+    @pytest.mark.redismod
     @skip_if_server_version_lt("7.1.140")
     def test_tfunction_load_delete(self, r):
         r.gears_refresh_cluster()
@@ -2458,6 +2459,7 @@ def test_tfunction_load_delete(self, r):
         assert r.tfunction_load(lib_code)
         assert r.tfunction_delete("lib1")
 
+    @pytest.mark.redismod
     @skip_if_server_version_lt("7.1.140")
     def test_tfunction_list(self, r):
         r.gears_refresh_cluster()
@@ -2481,6 +2483,7 @@ def test_tfunction_list(self, r):
         assert r.tfunction_delete("lib2")
         assert r.tfunction_delete("lib3")
 
+    @pytest.mark.redismod
     @skip_if_server_version_lt("7.1.140")
     def test_tfcall(self, r):
         r.gears_refresh_cluster()
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 54df183fc6..8fbec5fb7e 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1818,44 +1818,44 @@ def try_delete_libs(self, r, *lib_names):
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("7.1.140")
-    def test_tfunction_load_delete(self, r):
-        self.try_delete_libs(r, "lib1")
+    def test_tfunction_load_delete(self, stack_r):
+        self.try_delete_libs(stack_r, "lib1")
         lib_code = self.generate_lib_code("lib1")
-        assert r.tfunction_load(lib_code)
-        assert r.tfunction_delete("lib1")
+        assert stack_r.tfunction_load(lib_code)
+        assert stack_r.tfunction_delete("lib1")
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("7.1.140")
-    def test_tfunction_list(self, r):
-        self.try_delete_libs(r, "lib1", "lib2", "lib3")
-        assert r.tfunction_load(self.generate_lib_code("lib1"))
-        assert r.tfunction_load(self.generate_lib_code("lib2"))
-        assert r.tfunction_load(self.generate_lib_code("lib3"))
+    def test_tfunction_list(self, stack_r):
+        self.try_delete_libs(stack_r, "lib1", "lib2", "lib3")
+        assert stack_r.tfunction_load(self.generate_lib_code("lib1"))
+        assert stack_r.tfunction_load(self.generate_lib_code("lib2"))
+        assert stack_r.tfunction_load(self.generate_lib_code("lib3"))
 
         # test error thrown when verbose > 4
         with pytest.raises(redis.exceptions.DataError):
-            assert r.tfunction_list(verbose=8)
+            assert stack_r.tfunction_list(verbose=8)
 
-        functions = r.tfunction_list(verbose=1)
+        functions = stack_r.tfunction_list(verbose=1)
         assert len(functions) == 3
 
         expected_names = [b"lib1", b"lib2", b"lib3"]
         actual_names = [functions[0][13], functions[1][13], functions[2][13]]
 
         assert sorted(expected_names) == sorted(actual_names)
-        assert r.tfunction_delete("lib1")
-        assert r.tfunction_delete("lib2")
-        assert r.tfunction_delete("lib3")
+        assert stack_r.tfunction_delete("lib1")
+        assert stack_r.tfunction_delete("lib2")
+        assert stack_r.tfunction_delete("lib3")
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("7.1.140")
-    def test_tfcall(self, r):
-        self.try_delete_libs(r, "lib1")
-        assert r.tfunction_load(self.generate_lib_code("lib1"))
-        assert r.tfcall("lib1", "foo") == b"bar"
-        assert r.tfcall_async("lib1", "foo") == b"bar"
+    def test_tfcall(self, stack_r):
+        self.try_delete_libs(stack_r, "lib1")
+        assert stack_r.tfunction_load(self.generate_lib_code("lib1"))
+        assert stack_r.tfcall("lib1", "foo") == b"bar"
+        assert stack_r.tfcall_async("lib1", "foo") == b"bar"
 
-        assert r.tfunction_delete("lib1")
+        assert stack_r.tfunction_delete("lib1")
 
     def test_ttl(self, r):
         r["a"] = "1"
@@ -5022,25 +5022,27 @@ def test_command_getkeysandflags(self, r: redis.Redis):
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("4.0.0")
     @skip_if_redis_enterprise()
-    def test_module(self, r):
+    def test_module(self, stack_r):
         with pytest.raises(redis.exceptions.ModuleError) as excinfo:
-            r.module_load("/some/fake/path")
+            stack_r.module_load("/some/fake/path")
             assert "Error loading the extension." in str(excinfo.value)
 
         with pytest.raises(redis.exceptions.ModuleError) as excinfo:
-            r.module_load("/some/fake/path", "arg1", "arg2", "arg3", "arg4")
+            stack_r.module_load("/some/fake/path", "arg1", "arg2", "arg3", "arg4")
             assert "Error loading the extension." in str(excinfo.value)
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("7.0.0")
     @skip_if_redis_enterprise()
-    def test_module_loadex(self, r: redis.Redis):
+    def test_module_loadex(self, stack_r: redis.Redis):
         with pytest.raises(redis.exceptions.ModuleError) as excinfo:
-            r.module_loadex("/some/fake/path")
+            stack_r.module_loadex("/some/fake/path")
             assert "Error loading the extension." in str(excinfo.value)
 
         with pytest.raises(redis.exceptions.ModuleError) as excinfo:
-            r.module_loadex("/some/fake/path", ["name", "value"], ["arg1", "arg2"])
+            stack_r.module_loadex(
+                "/some/fake/path", ["name", "value"], ["arg1", "arg2"]
+            )
             assert "Error loading the extension." in str(excinfo.value)
 
     @skip_if_server_version_lt("2.6.0")
diff --git a/tests/test_graph.py b/tests/test_graph.py
index c6d128908e..2eace0181c 100644
--- a/tests/test_graph.py
+++ b/tests/test_graph.py
@@ -24,18 +24,20 @@
 
 
 @pytest.fixture
-def client(request):
-    r = _get_client(Redis, request, decode_responses=True)
+def client(request, stack_url):
+    r = _get_client(Redis, request, decode_responses=True, from_url=stack_url)
     r.flushdb()
     return r
 
 
+@pytest.mark.redismod
 def test_bulk(client):
     with pytest.raises(NotImplementedError):
         client.graph().bulk()
         client.graph().bulk(foo="bar!")
 
 
+@pytest.mark.redismod
 def test_graph_creation(client):
     graph = client.graph()
 
@@ -80,6 +82,7 @@ def test_graph_creation(client):
     graph.delete()
 
 
+@pytest.mark.redismod
 def test_array_functions(client):
     query = """CREATE (p:person{name:'a',age:32, array:[0,1,2]})"""
     client.graph().query(query)
@@ -100,6 +103,7 @@ def test_array_functions(client):
     assert [a] == result.result_set[0][0]
 
 
+@pytest.mark.redismod
 def test_path(client):
     node0 = Node(node_id=0, label="L1")
     node1 = Node(node_id=1, label="L1")
@@ -119,6 +123,7 @@ def test_path(client):
     assert expected_results == result.result_set
 
 
+@pytest.mark.redismod
 def test_param(client):
     params = [1, 2.3, "str", True, False, None, [0, 1, 2], r"\" RETURN 1337 //"]
     query = "RETURN $param"
@@ -128,6 +133,7 @@ def test_param(client):
         assert expected_results == result.result_set
 
 
+@pytest.mark.redismod
 def test_map(client):
     query = "RETURN {a:1, b:'str', c:NULL, d:[1,2,3], e:True, f:{x:1, y:2}}"
 
@@ -144,6 +150,7 @@ def test_map(client):
     assert actual == expected
 
 
+@pytest.mark.redismod
 def test_point(client):
     query = "RETURN point({latitude: 32.070794860, longitude: 34.820751118})"
     expected_lat = 32.070794860
@@ -160,6 +167,7 @@ def test_point(client):
     assert abs(actual["longitude"] - expected_lon) < 0.001
 
 
+@pytest.mark.redismod
 def test_index_response(client):
     result_set = client.graph().query("CREATE INDEX ON :person(age)")
     assert 1 == result_set.indices_created
@@ -174,6 +182,7 @@ def test_index_response(client):
         client.graph().query("DROP INDEX ON :person(age)")
 
 
+@pytest.mark.redismod
 def test_stringify_query_result(client):
     graph = client.graph()
 
@@ -227,6 +236,7 @@ def test_stringify_query_result(client):
     graph.delete()
 
 
+@pytest.mark.redismod
 def test_optional_match(client):
     # Build a graph of form (a)-[R]->(b)
     node0 = Node(node_id=0, label="L1", properties={"value": "a"})
@@ -251,6 +261,7 @@ def test_optional_match(client):
     graph.delete()
 
 
+@pytest.mark.redismod
 def test_cached_execution(client):
     client.graph().query("CREATE ()")
 
@@ -268,6 +279,7 @@ def test_cached_execution(client):
     assert cached_result.cached_execution
 
 
+@pytest.mark.redismod
 def test_slowlog(client):
     create_query = """CREATE (:Rider
     {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
@@ -280,6 +292,7 @@ def test_slowlog(client):
     assert results[0][2] == create_query
 
 
+@pytest.mark.redismod
 @pytest.mark.xfail(strict=False)
 def test_query_timeout(client):
     # Build a sample graph with 1000 nodes.
@@ -294,6 +307,7 @@ def test_query_timeout(client):
         assert False is False
 
 
+@pytest.mark.redismod
 def test_read_only_query(client):
     with pytest.raises(Exception):
         # Issue a write query, specifying read-only true,
@@ -302,6 +316,7 @@ def test_read_only_query(client):
         assert False is False
 
 
+@pytest.mark.redismod
 def test_profile(client):
     q = """UNWIND range(1, 3) AS x CREATE (p:Person {v:x})"""
     profile = client.graph().profile(q).result_set
@@ -316,6 +331,7 @@ def test_profile(client):
     assert "Node By Label Scan | (p:Person) | Records produced: 3" in profile
 
 
+@pytest.mark.redismod
 @skip_if_redis_enterprise()
 def test_config(client):
     config_name = "RESULTSET_SIZE"
@@ -348,6 +364,7 @@ def test_config(client):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 def test_list_keys(client):
     result = client.graph().list_keys()
     assert result == []
@@ -370,6 +387,7 @@ def test_list_keys(client):
     assert result == []
 
 
+@pytest.mark.redismod
 def test_multi_label(client):
     redis_graph = client.graph("g")
 
@@ -395,6 +413,7 @@ def test_multi_label(client):
         assert True
 
 
+@pytest.mark.redismod
 def test_cache_sync(client):
     pass
     return
@@ -467,6 +486,7 @@ def test_cache_sync(client):
     assert A._relationship_types[1] == "R"
 
 
+@pytest.mark.redismod
 def test_execution_plan(client):
     redis_graph = client.graph("execution_plan")
     create_query = """CREATE
@@ -485,6 +505,7 @@ def test_execution_plan(client):
     redis_graph.delete()
 
 
+@pytest.mark.redismod
 def test_explain(client):
     redis_graph = client.graph("execution_plan")
     # graph creation / population
@@ -573,6 +594,7 @@ def test_explain(client):
     redis_graph.delete()
 
 
+@pytest.mark.redismod
 def test_resultset_statistics(client):
     with patch.object(target=QueryResult, attribute="_get_stat") as mock_get_stats:
         result = client.graph().query("RETURN 1")
diff --git a/tests/test_json.py b/tests/test_json.py
index 73d72b8cc9..5cf9b11e17 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -8,12 +8,13 @@
 
 
 @pytest.fixture
-def client(request):
-    r = _get_client(Redis, request, decode_responses=True)
+def client(request, stack_url):
+    r = _get_client(Redis, request, decode_responses=True, from_url=stack_url)
     r.flushdb()
     return r
 
 
+@pytest.mark.redismod
 def test_json_setbinarykey(client):
     d = {"hello": "world", b"some": "value"}
     with pytest.raises(TypeError):
@@ -21,6 +22,7 @@ def test_json_setbinarykey(client):
     assert client.json().set("somekey", Path.root_path(), d, decode_keys=True)
 
 
+@pytest.mark.redismod
 def test_json_setgetdeleteforget(client):
     assert client.json().set("foo", Path.root_path(), "bar")
     assert_resp_response(client, client.json().get("foo"), "bar", [["bar"]])
@@ -30,11 +32,13 @@ def test_json_setgetdeleteforget(client):
     assert client.exists("foo") == 0
 
 
+@pytest.mark.redismod
 def test_jsonget(client):
     client.json().set("foo", Path.root_path(), "bar")
     assert_resp_response(client, client.json().get("foo"), "bar", [["bar"]])
 
 
+@pytest.mark.redismod
 def test_json_get_jset(client):
     assert client.json().set("foo", Path.root_path(), "bar")
     assert_resp_response(client, client.json().get("foo"), "bar", [["bar"]])
@@ -43,6 +47,7 @@ def test_json_get_jset(client):
     assert client.exists("foo") == 0
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("2.06.00", "ReJSON")  # todo: update after the release
 def test_json_merge(client):
     # Test with root path $
@@ -75,6 +80,7 @@ def test_json_merge(client):
     }
 
 
+@pytest.mark.redismod
 def test_nonascii_setgetdelete(client):
     assert client.json().set("notascii", Path.root_path(), "hyvää-élève")
     res = "hyvää-élève"
@@ -85,6 +91,7 @@ def test_nonascii_setgetdelete(client):
     assert client.exists("notascii") == 0
 
 
+@pytest.mark.redismod
 def test_jsonsetexistentialmodifiersshouldsucceed(client):
     obj = {"foo": "bar"}
     assert client.json().set("obj", Path.root_path(), obj)
@@ -102,6 +109,7 @@ def test_jsonsetexistentialmodifiersshouldsucceed(client):
         client.json().set("obj", Path("foo"), "baz", nx=True, xx=True)
 
 
+@pytest.mark.redismod
 def test_mgetshouldsucceed(client):
     client.json().set("1", Path.root_path(), 1)
     client.json().set("2", Path.root_path(), 2)
@@ -111,6 +119,7 @@ def test_mgetshouldsucceed(client):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 @skip_ifmodversion_lt("2.06.00", "ReJSON")
 def test_mset(client):
     client.json().mset([("1", Path.root_path(), 1), ("2", Path.root_path(), 2)])
@@ -119,6 +128,7 @@ def test_mset(client):
     assert client.json().mget(["1", "2"], Path.root_path()) == [1, 2]
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
 def test_clear(client):
     client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
@@ -126,6 +136,7 @@ def test_clear(client):
     assert_resp_response(client, client.json().get("arr"), [], [[[]]])
 
 
+@pytest.mark.redismod
 def test_type(client):
     client.json().set("1", Path.root_path(), 1)
     assert_resp_response(
@@ -134,6 +145,7 @@ def test_type(client):
     assert_resp_response(client, client.json().type("1"), "integer", ["integer"])
 
 
+@pytest.mark.redismod
 def test_numincrby(client):
     client.json().set("num", Path.root_path(), 1)
     assert_resp_response(
@@ -147,6 +159,7 @@ def test_numincrby(client):
     )
 
 
+@pytest.mark.redismod
 def test_nummultby(client):
     client.json().set("num", Path.root_path(), 1)
 
@@ -162,6 +175,7 @@ def test_nummultby(client):
         )
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "ReJSON")  # todo: update after the release
 def test_toggle(client):
     client.json().set("bool", Path.root_path(), False)
@@ -173,6 +187,7 @@ def test_toggle(client):
         client.json().toggle("num", Path.root_path())
 
 
+@pytest.mark.redismod
 def test_strappend(client):
     client.json().set("jsonkey", Path.root_path(), "foo")
     assert 6 == client.json().strappend("jsonkey", "bar")
@@ -181,15 +196,7 @@ def test_strappend(client):
     )
 
 
-# # def test_debug(client):
-#    client.json().set("str", Path.root_path(), "foo")
-#    assert 24 == client.json().debug("MEMORY", "str", Path.root_path())
-#    assert 24 == client.json().debug("MEMORY", "str")
-#
-#    # technically help is valid
-#    assert isinstance(client.json().debug("HELP"), list)
-
-
+@pytest.mark.redismod
 def test_strlen(client):
     client.json().set("str", Path.root_path(), "foo")
     assert 3 == client.json().strlen("str", Path.root_path())
@@ -198,6 +205,7 @@ def test_strlen(client):
     assert 6 == client.json().strlen("str")
 
 
+@pytest.mark.redismod
 def test_arrappend(client):
     client.json().set("arr", Path.root_path(), [1])
     assert 2 == client.json().arrappend("arr", Path.root_path(), 2)
@@ -205,6 +213,7 @@ def test_arrappend(client):
     assert 7 == client.json().arrappend("arr", Path.root_path(), *[5, 6, 7])
 
 
+@pytest.mark.redismod
 def test_arrindex(client):
     client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
     assert 1 == client.json().arrindex("arr", Path.root_path(), 1)
@@ -216,6 +225,7 @@ def test_arrindex(client):
     assert -1 == client.json().arrindex("arr", Path.root_path(), 4, start=1, stop=3)
 
 
+@pytest.mark.redismod
 def test_arrinsert(client):
     client.json().set("arr", Path.root_path(), [0, 4])
     assert 5 - -client.json().arrinsert("arr", Path.root_path(), 1, *[1, 2, 3])
@@ -229,6 +239,7 @@ def test_arrinsert(client):
     assert_resp_response(client, client.json().get("val2"), res, [[res]])
 
 
+@pytest.mark.redismod
 def test_arrlen(client):
     client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
     assert 5 == client.json().arrlen("arr", Path.root_path())
@@ -236,6 +247,7 @@ def test_arrlen(client):
     assert client.json().arrlen("fakekey") is None
 
 
+@pytest.mark.redismod
 def test_arrpop(client):
     client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
     assert 4 == client.json().arrpop("arr", Path.root_path(), 4)
@@ -253,6 +265,7 @@ def test_arrpop(client):
     assert client.json().arrpop("arr") is None
 
 
+@pytest.mark.redismod
 def test_arrtrim(client):
     client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
     assert 3 == client.json().arrtrim("arr", Path.root_path(), 1, 3)
@@ -275,6 +288,7 @@ def test_arrtrim(client):
     assert 0 == client.json().arrtrim("arr", Path.root_path(), 9, 11)
 
 
+@pytest.mark.redismod
 def test_resp(client):
     obj = {"foo": "bar", "baz": 1, "qaz": True}
     client.json().set("obj", Path.root_path(), obj)
@@ -284,6 +298,7 @@ def test_resp(client):
     assert isinstance(client.json().resp("obj"), list)
 
 
+@pytest.mark.redismod
 def test_objkeys(client):
     obj = {"foo": "bar", "baz": "qaz"}
     client.json().set("obj", Path.root_path(), obj)
@@ -300,6 +315,7 @@ def test_objkeys(client):
     assert client.json().objkeys("fakekey") is None
 
 
+@pytest.mark.redismod
 def test_objlen(client):
     obj = {"foo": "bar", "baz": "qaz"}
     client.json().set("obj", Path.root_path(), obj)
@@ -309,6 +325,7 @@ def test_objlen(client):
     assert len(obj) == client.json().objlen("obj")
 
 
+@pytest.mark.redismod
 def test_json_commands_in_pipeline(client):
     p = client.json().pipeline()
     p.set("foo", Path.root_path(), "bar")
@@ -332,6 +349,7 @@ def test_json_commands_in_pipeline(client):
     assert client.get("foo") is None
 
 
+@pytest.mark.redismod
 def test_json_delete_with_dollar(client):
     doc1 = {"a": 1, "nested": {"a": 2, "b": 3}}
     assert client.json().set("doc1", "$", doc1)
@@ -383,6 +401,7 @@ def test_json_delete_with_dollar(client):
     client.json().delete("not_a_document", "..a")
 
 
+@pytest.mark.redismod
 def test_json_forget_with_dollar(client):
     doc1 = {"a": 1, "nested": {"a": 2, "b": 3}}
     assert client.json().set("doc1", "$", doc1)
@@ -434,6 +453,7 @@ def test_json_forget_with_dollar(client):
     client.json().forget("not_a_document", "..a")
 
 
+@pytest.mark.redismod
 def test_json_mget_dollar(client):
     # Test mget with multi paths
     client.json().set(
@@ -463,6 +483,7 @@ def test_json_mget_dollar(client):
     assert res == [None, None]
 
 
+@pytest.mark.redismod
 def test_numby_commands_dollar(client):
     # Test NUMINCRBY
     client.json().set("doc1", "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]})
@@ -506,6 +527,7 @@ def test_numby_commands_dollar(client):
         client.json().nummultby("doc1", ".b[0].a", 3) == 6
 
 
+@pytest.mark.redismod
 def test_strappend_dollar(client):
     client.json().set(
         "doc1", "$", {"a": "foo", "nested1": {"a": "hello"}, "nested2": {"a": 31}}
@@ -536,6 +558,7 @@ def test_strappend_dollar(client):
         client.json().strappend("doc1", "piu")
 
 
+@pytest.mark.redismod
 def test_strlen_dollar(client):
     # Test multi
     client.json().set(
@@ -556,6 +579,7 @@ def test_strlen_dollar(client):
         client.json().strlen("non_existing_doc", "$..a")
 
 
+@pytest.mark.redismod
 def test_arrappend_dollar(client):
     client.json().set(
         "doc1",
@@ -630,6 +654,7 @@ def test_arrappend_dollar(client):
         client.json().arrappend("non_existing_doc", "$..a")
 
 
+@pytest.mark.redismod
 def test_arrinsert_dollar(client):
     client.json().set(
         "doc1",
@@ -668,6 +693,7 @@ def test_arrinsert_dollar(client):
         client.json().arrappend("non_existing_doc", "$..a")
 
 
+@pytest.mark.redismod
 def test_arrlen_dollar(client):
     client.json().set(
         "doc1",
@@ -716,6 +742,7 @@ def test_arrlen_dollar(client):
     assert client.json().arrlen("non_existing_doc", "..a") is None
 
 
+@pytest.mark.redismod
 def test_arrpop_dollar(client):
     client.json().set(
         "doc1",
@@ -757,6 +784,7 @@ def test_arrpop_dollar(client):
         client.json().arrpop("non_existing_doc", "..a")
 
 
+@pytest.mark.redismod
 def test_arrtrim_dollar(client):
     client.json().set(
         "doc1",
@@ -809,6 +837,7 @@ def test_arrtrim_dollar(client):
         client.json().arrtrim("non_existing_doc", "..a", 1, 1)
 
 
+@pytest.mark.redismod
 def test_objkeys_dollar(client):
     client.json().set(
         "doc1",
@@ -838,6 +867,7 @@ def test_objkeys_dollar(client):
     assert client.json().objkeys("doc1", "$..nowhere") == []
 
 
+@pytest.mark.redismod
 def test_objlen_dollar(client):
     client.json().set(
         "doc1",
@@ -892,6 +922,7 @@ def load_types_data(nested_key_name):
     return jdata, types
 
 
+@pytest.mark.redismod
 def test_type_dollar(client):
     jdata, jtypes = load_types_data("a")
     client.json().set("doc1", "$", jdata)
@@ -909,6 +940,7 @@ def test_type_dollar(client):
     )
 
 
+@pytest.mark.redismod
 def test_clear_dollar(client):
     client.json().set(
         "doc1",
@@ -959,6 +991,7 @@ def test_clear_dollar(client):
         client.json().clear("non_existing_doc", "$..a")
 
 
+@pytest.mark.redismod
 def test_toggle_dollar(client):
     client.json().set(
         "doc1",
@@ -987,28 +1020,7 @@ def test_toggle_dollar(client):
         client.json().toggle("non_existing_doc", "$..a")
 
 
-# # def test_debug_dollar(client):
-#
-#    jdata, jtypes = load_types_data("a")
-#
-#    client.json().set("doc1", "$", jdata)
-#
-#    # Test multi
-#    assert client.json().debug("MEMORY", "doc1", "$..a") == [72, 24, 24, 16, 16, 1, 0]
-#
-#    # Test single
-#    assert client.json().debug("MEMORY", "doc1", "$.nested2.a") == [24]
-#
-#    # Test legacy
-#    assert client.json().debug("MEMORY", "doc1", "..a") == 72
-#
-#    # Test missing path (defaults to root)
-#    assert client.json().debug("MEMORY", "doc1") == 72
-#
-#    # Test missing key
-#    assert client.json().debug("MEMORY", "non_existing_doc", "$..a") == []
-
-
+@pytest.mark.redismod
 def test_resp_dollar(client):
     data = {
         "L1": {
@@ -1237,6 +1249,7 @@ def test_resp_dollar(client):
     client.json().resp("non_existing_doc", "$..a")
 
 
+@pytest.mark.redismod
 def test_arrindex_dollar(client):
     client.json().set(
         "store",
@@ -1462,6 +1475,7 @@ def test_arrindex_dollar(client):
     assert client.json().arrindex("test_None", "..nested2_not_found.arr", "None") == 0
 
 
+@pytest.mark.redismod
 def test_decoders_and_unstring():
     assert unstring("4") == 4
     assert unstring("45.55") == 45.55
@@ -1472,6 +1486,7 @@ def test_decoders_and_unstring():
     assert decode_list(["hello", b"world"]) == ["hello", "world"]
 
 
+@pytest.mark.redismod
 def test_custom_decoder(client):
     import json
 
@@ -1487,6 +1502,7 @@ def test_custom_decoder(client):
     assert not isinstance(cj.__decoder__, json.JSONDecoder)
 
 
+@pytest.mark.redismod
 def test_set_file(client):
     import json
     import tempfile
@@ -1505,6 +1521,7 @@ def test_set_file(client):
         client.json().set_file("test2", Path.root_path(), nojsonfile.name)
 
 
+@pytest.mark.redismod
 def test_set_path(client):
     import json
     import tempfile
diff --git a/tests/test_search.py b/tests/test_search.py
index f19c193891..6b40c5129d 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -107,8 +107,8 @@ def createIndex(client, num_docs=100, definition=None):
 
 
 @pytest.fixture
-def client(request):
-    r = _get_client(redis.Redis, request, decode_responses=True)
+def client(request, stack_url):
+    r = _get_client(redis.Redis, request, decode_responses=True, from_url=stack_url)
     r.flushdb()
     return r
 
diff --git a/tests/test_timeseries.py b/tests/test_timeseries.py
index 6b59967f3c..5318818e79 100644
--- a/tests/test_timeseries.py
+++ b/tests/test_timeseries.py
@@ -5,7 +5,20 @@
 import pytest
 import redis
 
-from .conftest import assert_resp_response, is_resp2_connection, skip_ifmodversion_lt
+from .conftest import (
+    _get_client,
+    assert_resp_response,
+    is_resp2_connection,
+    skip_ifmodversion_lt,
+)
+
+
+@pytest.fixture()
+def decoded_r(request, stack_url):
+    with _get_client(
+        redis.Redis, request, decode_responses=True, from_url=stack_url
+    ) as client:
+        yield client
 
 
 @pytest.fixture
@@ -14,6 +27,7 @@ def client(decoded_r):
     return decoded_r
 
 
+@pytest.mark.redismod
 def test_create(client):
     assert client.ts().create(1)
     assert client.ts().create(2, retention_msecs=5)
@@ -31,6 +45,7 @@ def test_create(client):
     assert_resp_response(client, 128, info.get("chunk_size"), info.get("chunkSize"))
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
 def test_create_duplicate_policy(client):
     # Test for duplicate policy
@@ -46,6 +61,7 @@ def test_create_duplicate_policy(client):
         )
 
 
+@pytest.mark.redismod
 def test_alter(client):
     assert client.ts().create(1)
     info = client.ts().info(1)
@@ -66,6 +82,7 @@ def test_alter(client):
     )
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
 def test_alter_diplicate_policy(client):
     assert client.ts().create(1)
@@ -80,6 +97,7 @@ def test_alter_diplicate_policy(client):
     )
 
 
+@pytest.mark.redismod
 def test_add(client):
     assert 1 == client.ts().add(1, 1, 1)
     assert 2 == client.ts().add(2, 2, 3, retention_msecs=10)
@@ -102,6 +120,7 @@ def test_add(client):
     assert_resp_response(client, 128, info.get("chunk_size"), info.get("chunkSize"))
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
 def test_add_duplicate_policy(client):
     # Test for duplicate policy BLOCK
@@ -138,11 +157,13 @@ def test_add_duplicate_policy(client):
     assert 5.0 == client.ts().get("time-serie-add-ooo-min")[1]
 
 
+@pytest.mark.redismod
 def test_madd(client):
     client.ts().create("a")
     assert [1, 2, 3] == client.ts().madd([("a", 1, 5), ("a", 2, 10), ("a", 3, 15)])
 
 
+@pytest.mark.redismod
 def test_incrby_decrby(client):
     for _ in range(100):
         assert client.ts().incrby(1, 1)
@@ -171,6 +192,7 @@ def test_incrby_decrby(client):
     assert_resp_response(client, 128, info.get("chunk_size"), info.get("chunkSize"))
 
 
+@pytest.mark.redismod
 def test_create_and_delete_rule(client):
     # test rule creation
     time = 100
@@ -194,6 +216,7 @@ def test_create_and_delete_rule(client):
     assert not info["rules"]
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 def test_del_range(client):
     try:
@@ -208,6 +231,7 @@ def test_del_range(client):
     assert_resp_response(client, client.ts().range(1, 22, 22), [(22, 1.0)], [[22, 1.0]])
 
 
+@pytest.mark.redismod
 def test_range(client):
     for i in range(100):
         client.ts().add(1, i, i % 7)
@@ -222,6 +246,7 @@ def test_range(client):
     assert 10 == len(client.ts().range(1, 0, 500, count=10))
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 def test_range_advanced(client):
     for i in range(100):
@@ -251,6 +276,7 @@ def test_range_advanced(client):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.8.0", "timeseries")
 def test_range_latest(client: redis.Redis):
     timeseries = client.ts()
@@ -275,6 +301,7 @@ def test_range_latest(client: redis.Redis):
     )
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.8.0", "timeseries")
 def test_range_bucket_timestamp(client: redis.Redis):
     timeseries = client.ts()
@@ -308,6 +335,7 @@ def test_range_bucket_timestamp(client: redis.Redis):
     )
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.8.0", "timeseries")
 def test_range_empty(client: redis.Redis):
     timeseries = client.ts()
@@ -352,6 +380,7 @@ def test_range_empty(client: redis.Redis):
     assert_resp_response(client, res, resp2_expected, resp3_expected)
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 def test_rev_range(client):
     for i in range(100):
@@ -400,6 +429,7 @@ def test_rev_range(client):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.8.0", "timeseries")
 def test_revrange_latest(client: redis.Redis):
     timeseries = client.ts()
@@ -418,6 +448,7 @@ def test_revrange_latest(client: redis.Redis):
     assert_resp_response(client, res, [(0, 4.0)], [[0, 4.0]])
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.8.0", "timeseries")
 def test_revrange_bucket_timestamp(client: redis.Redis):
     timeseries = client.ts()
@@ -451,6 +482,7 @@ def test_revrange_bucket_timestamp(client: redis.Redis):
     )
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.8.0", "timeseries")
 def test_revrange_empty(client: redis.Redis):
     timeseries = client.ts()
@@ -496,6 +528,7 @@ def test_revrange_empty(client: redis.Redis):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 def test_mrange(client):
     client.ts().create(1, labels={"Test": "This", "team": "ny"})
     client.ts().create(2, labels={"Test": "This", "Taste": "That", "team": "sf"})
@@ -544,6 +577,7 @@ def test_mrange(client):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 def test_multi_range_advanced(client):
     client.ts().create(1, labels={"Test": "This", "team": "ny"})
@@ -657,6 +691,7 @@ def test_multi_range_advanced(client):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.8.0", "timeseries")
 def test_mrange_latest(client: redis.Redis):
     timeseries = client.ts()
@@ -686,6 +721,7 @@ def test_mrange_latest(client: redis.Redis):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 @skip_ifmodversion_lt("99.99.99", "timeseries")
 def test_multi_reverse_range(client):
     client.ts().create(1, labels={"Test": "This", "team": "ny"})
@@ -804,6 +840,7 @@ def test_multi_reverse_range(client):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.8.0", "timeseries")
 def test_mrevrange_latest(client: redis.Redis):
     timeseries = client.ts()
@@ -832,6 +869,7 @@ def test_mrevrange_latest(client: redis.Redis):
     )
 
 
+@pytest.mark.redismod
 def test_get(client):
     name = "test"
     client.ts().create(name)
@@ -843,6 +881,7 @@ def test_get(client):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.8.0", "timeseries")
 def test_get_latest(client: redis.Redis):
     timeseries = client.ts()
@@ -860,6 +899,7 @@ def test_get_latest(client: redis.Redis):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 def test_mget(client):
     client.ts().create(1, labels={"Test": "This"})
     client.ts().create(2, labels={"Test": "This", "Taste": "That"})
@@ -895,6 +935,7 @@ def test_mget(client):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.8.0", "timeseries")
 def test_mget_latest(client: redis.Redis):
     timeseries = client.ts()
@@ -911,6 +952,7 @@ def test_mget_latest(client: redis.Redis):
     assert_resp_response(client, res, [{"t2": [{}, 10, 8.0]}], {"t2": [{}, [10, 8.0]]})
 
 
+@pytest.mark.redismod
 def test_info(client):
     client.ts().create(1, retention_msecs=5, labels={"currentLabel": "currentData"})
     info = client.ts().info(1)
@@ -920,8 +962,9 @@ def test_info(client):
     assert info["labels"]["currentLabel"] == "currentData"
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
-def testInfoDuplicatePolicy(client):
+def test_info_duplicate_policy(client):
     client.ts().create(1, retention_msecs=5, labels={"currentLabel": "currentData"})
     info = client.ts().info(1)
     assert_resp_response(
@@ -935,6 +978,7 @@ def testInfoDuplicatePolicy(client):
     )
 
 
+@pytest.mark.redismod
 @pytest.mark.onlynoncluster
 def test_query_index(client):
     client.ts().create(1, labels={"Test": "This"})
@@ -944,6 +988,7 @@ def test_query_index(client):
     assert_resp_response(client, client.ts().queryindex(["Taste=That"]), [2], {"2"})
 
 
+@pytest.mark.redismod
 def test_pipeline(client):
     pipeline = client.ts().pipeline()
     pipeline.create("with_pipeline")
@@ -961,6 +1006,7 @@ def test_pipeline(client):
     assert client.ts().get("with_pipeline")[1] == 99 * 1.1
 
 
+@pytest.mark.redismod
 def test_uncompressed(client):
     client.ts().create("compressed")
     client.ts().create("uncompressed", uncompressed=True)

From 27accc8dd535feeee6e0060c6d0feffef15b35e7 Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@gmail.com>
Date: Thu, 6 Jun 2024 20:14:55 +0300
Subject: [PATCH 0884/1164] Hash field expiration commands (#3218)

Support hash field expiration commands that become available with
Redis 7.4.

Adapt some tests to match recent server-side changes. Update tests
related to memory stats. Make CLIENT KILL test not run with cluster.
Disable tests related to Graph module. The Graph module is no longer
part of Redis Stack, so for the moment disable all related tests.

---------

Co-authored-by: Gabriel Erzse <gabriel.erzse@redis.com>
---
 redis/commands/core.py              | 368 +++++++++++++++++++++++++++
 tests/test_asyncio/test_cluster.py  |   2 +-
 tests/test_asyncio/test_commands.py |   4 +-
 tests/test_asyncio/test_graph.py    |  19 ++
 tests/test_asyncio/test_hash.py     | 300 ++++++++++++++++++++++
 tests/test_cluster.py               |   2 +-
 tests/test_commands.py              |   7 +-
 tests/test_graph.py                 |  22 ++
 tests/test_hash.py                  | 369 ++++++++++++++++++++++++++++
 9 files changed, 1086 insertions(+), 7 deletions(-)
 create mode 100644 tests/test_asyncio/test_hash.py
 create mode 100644 tests/test_hash.py

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 4e1e242dc4..a56b3d2cba 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -5094,6 +5094,374 @@ def hstrlen(self, name: str, key: str) -> Union[Awaitable[int], int]:
         """
         return self.execute_command("HSTRLEN", name, key, keys=[name])
 
+    def hexpire(
+        self,
+        name: KeyT,
+        seconds: ExpiryT,
+        *fields: str,
+        nx: bool = False,
+        xx: bool = False,
+        gt: bool = False,
+        lt: bool = False,
+    ) -> ResponseT:
+        """
+        Sets or updates the expiration time for fields within a hash key, using relative
+        time in seconds.
+
+        If a field already has an expiration time, the behavior of the update can be
+        controlled using the `nx`, `xx`, `gt`, and `lt` parameters.
+
+        The return value provides detailed information about the outcome for each field.
+
+        For more information, see https://redis.io/commands/hexpire
+
+        Args:
+            name: The name of the hash key.
+            seconds: Expiration time in seconds, relative. Can be an integer, or a
+                     Python `timedelta` object.
+            fields: List of fields within the hash to apply the expiration time to.
+            nx: Set expiry only when the field has no expiry.
+            xx: Set expiry only when the field has an existing expiry.
+            gt: Set expiry only when the new expiry is greater than the current one.
+            lt: Set expiry only when the new expiry is less than the current one.
+
+        Returns:
+            If the key does not exist, returns an empty list. If the key exists, returns
+            a list which contains for each field in the request:
+                - `-2` if the field does not exist.
+                - `0` if the specified NX | XX | GT | LT condition was not met.
+                - `1` if the expiration time was set or updated.
+                - `2` if the field was deleted because the specified expiration time is
+                  in the past.
+        """
+        conditions = [nx, xx, gt, lt]
+        if sum(conditions) > 1:
+            raise ValueError("Only one of 'nx', 'xx', 'gt', 'lt' can be specified.")
+
+        if isinstance(seconds, datetime.timedelta):
+            seconds = int(seconds.total_seconds())
+
+        options = []
+        if nx:
+            options.append("NX")
+        if xx:
+            options.append("XX")
+        if gt:
+            options.append("GT")
+        if lt:
+            options.append("LT")
+
+        return self.execute_command(
+            "HEXPIRE", name, seconds, *options, "FIELDS", len(fields), *fields
+        )
+
+    def hpexpire(
+        self,
+        name: KeyT,
+        milliseconds: ExpiryT,
+        *fields: str,
+        nx: bool = False,
+        xx: bool = False,
+        gt: bool = False,
+        lt: bool = False,
+    ) -> ResponseT:
+        """
+        Sets or updates the expiration time for fields within a hash key, using relative
+        time in milliseconds.
+
+        If a field already has an expiration time, the behavior of the update can be
+        controlled using the `nx`, `xx`, `gt`, and `lt` parameters.
+
+        The return value provides detailed information about the outcome for each field.
+
+        For more information, see https://redis.io/commands/hpexpire
+
+        Args:
+            name: The name of the hash key.
+            milliseconds: Expiration time in milliseconds, relative. Can be an integer,
+                          or a Python `timedelta` object.
+            fields: List of fields within the hash to apply the expiration time to.
+            nx: Set expiry only when the field has no expiry.
+            xx: Set expiry only when the field has an existing expiry.
+            gt: Set expiry only when the new expiry is greater than the current one.
+            lt: Set expiry only when the new expiry is less than the current one.
+
+        Returns:
+            If the key does not exist, returns an empty list. If the key exists, returns
+            a list which contains for each field in the request:
+                - `-2` if the field does not exist.
+                - `0` if the specified NX | XX | GT | LT condition was not met.
+                - `1` if the expiration time was set or updated.
+                - `2` if the field was deleted because the specified expiration time is
+                  in the past.
+        """
+        conditions = [nx, xx, gt, lt]
+        if sum(conditions) > 1:
+            raise ValueError("Only one of 'nx', 'xx', 'gt', 'lt' can be specified.")
+
+        if isinstance(milliseconds, datetime.timedelta):
+            milliseconds = int(milliseconds.total_seconds() * 1000)
+
+        options = []
+        if nx:
+            options.append("NX")
+        if xx:
+            options.append("XX")
+        if gt:
+            options.append("GT")
+        if lt:
+            options.append("LT")
+
+        return self.execute_command(
+            "HPEXPIRE", name, milliseconds, *options, "FIELDS", len(fields), *fields
+        )
+
+    def hexpireat(
+        self,
+        name: KeyT,
+        unix_time_seconds: AbsExpiryT,
+        *fields: str,
+        nx: bool = False,
+        xx: bool = False,
+        gt: bool = False,
+        lt: bool = False,
+    ) -> ResponseT:
+        """
+        Sets or updates the expiration time for fields within a hash key, using an
+        absolute Unix timestamp in seconds.
+
+        If a field already has an expiration time, the behavior of the update can be
+        controlled using the `nx`, `xx`, `gt`, and `lt` parameters.
+
+        The return value provides detailed information about the outcome for each field.
+
+        For more information, see https://redis.io/commands/hexpireat
+
+        Args:
+            name: The name of the hash key.
+            unix_time_seconds: Expiration time as Unix timestamp in seconds. Can be an
+                               integer or a Python `datetime` object.
+            fields: List of fields within the hash to apply the expiration time to.
+            nx: Set expiry only when the field has no expiry.
+            xx: Set expiry only when the field has an existing expiration time.
+            gt: Set expiry only when the new expiry is greater than the current one.
+            lt: Set expiry only when the new expiry is less than the current one.
+
+        Returns:
+            If the key does not exist, returns an empty list. If the key exists, returns
+            a list which contains for each field in the request:
+                - `-2` if the field does not exist.
+                - `0` if the specified NX | XX | GT | LT condition was not met.
+                - `1` if the expiration time was set or updated.
+                - `2` if the field was deleted because the specified expiration time is
+                  in the past.
+        """
+        conditions = [nx, xx, gt, lt]
+        if sum(conditions) > 1:
+            raise ValueError("Only one of 'nx', 'xx', 'gt', 'lt' can be specified.")
+
+        if isinstance(unix_time_seconds, datetime.datetime):
+            unix_time_seconds = int(unix_time_seconds.timestamp())
+
+        options = []
+        if nx:
+            options.append("NX")
+        if xx:
+            options.append("XX")
+        if gt:
+            options.append("GT")
+        if lt:
+            options.append("LT")
+
+        return self.execute_command(
+            "HEXPIREAT",
+            name,
+            unix_time_seconds,
+            *options,
+            "FIELDS",
+            len(fields),
+            *fields,
+        )
+
+    def hpexpireat(
+        self,
+        name: KeyT,
+        unix_time_milliseconds: AbsExpiryT,
+        *fields: str,
+        nx: bool = False,
+        xx: bool = False,
+        gt: bool = False,
+        lt: bool = False,
+    ) -> ResponseT:
+        """
+        Sets or updates the expiration time for fields within a hash key, using an
+        absolute Unix timestamp in milliseconds.
+
+        If a field already has an expiration time, the behavior of the update can be
+        controlled using the `nx`, `xx`, `gt`, and `lt` parameters.
+
+        The return value provides detailed information about the outcome for each field.
+
+        For more information, see https://redis.io/commands/hpexpireat
+
+        Args:
+            name: The name of the hash key.
+            unix_time_milliseconds: Expiration time as Unix timestamp in milliseconds.
+                                    Can be an integer or a Python `datetime` object.
+            fields: List of fields within the hash to apply the expiry.
+            nx: Set expiry only when the field has no expiry.
+            xx: Set expiry only when the field has an existing expiry.
+            gt: Set expiry only when the new expiry is greater than the current one.
+            lt: Set expiry only when the new expiry is less than the current one.
+
+        Returns:
+            If the key does not exist, returns an empty list. If the key exists, returns
+            a list which contains for each field in the request:
+                - `-2` if the field does not exist.
+                - `0` if the specified NX | XX | GT | LT condition was not met.
+                - `1` if the expiration time was set or updated.
+                - `2` if the field was deleted because the specified expiration time is
+                  in the past.
+        """
+        conditions = [nx, xx, gt, lt]
+        if sum(conditions) > 1:
+            raise ValueError("Only one of 'nx', 'xx', 'gt', 'lt' can be specified.")
+
+        if isinstance(unix_time_milliseconds, datetime.datetime):
+            unix_time_milliseconds = int(unix_time_milliseconds.timestamp() * 1000)
+
+        options = []
+        if nx:
+            options.append("NX")
+        if xx:
+            options.append("XX")
+        if gt:
+            options.append("GT")
+        if lt:
+            options.append("LT")
+
+        return self.execute_command(
+            "HPEXPIREAT",
+            name,
+            unix_time_milliseconds,
+            *options,
+            "FIELDS",
+            len(fields),
+            *fields,
+        )
+
+    def hpersist(self, name: KeyT, *fields: str) -> ResponseT:
+        """
+        Removes the expiration time for each specified field in a hash.
+
+        For more information, see https://redis.io/commands/hpersist
+
+        Args:
+            name: The name of the hash key.
+            fields: A list of fields within the hash from which to remove the
+                    expiration time.
+
+        Returns:
+            If the key does not exist, returns an empty list. If the key exists, returns
+            a list which contains for each field in the request:
+                - `-2` if the field does not exist.
+                - `-1` if the field exists but has no associated expiration time.
+                - `1` if the expiration time was successfully removed from the field.
+        """
+        return self.execute_command("HPERSIST", name, "FIELDS", len(fields), *fields)
+
+    def hexpiretime(self, key: KeyT, *fields: str) -> ResponseT:
+        """
+        Returns the expiration times of hash fields as Unix timestamps in seconds.
+
+        For more information, see https://redis.io/commands/hexpiretime
+
+        Args:
+            key: The hash key.
+            fields: A list of fields within the hash for which to get the expiration
+                    time.
+
+        Returns:
+            If the key does not exist, returns an empty list. If the key exists, returns
+            a list which contains for each field in the request:
+                - `-2` if the field does not exist.
+                - `-1` if the field exists but has no associated expire time.
+                - A positive integer representing the expiration Unix timestamp in
+                  seconds, if the field has an associated expiration time.
+        """
+        return self.execute_command(
+            "HEXPIRETIME", key, "FIELDS", len(fields), *fields, keys=[key]
+        )
+
+    def hpexpiretime(self, key: KeyT, *fields: str) -> ResponseT:
+        """
+        Returns the expiration times of hash fields as Unix timestamps in milliseconds.
+
+        For more information, see https://redis.io/commands/hpexpiretime
+
+        Args:
+            key: The hash key.
+            fields: A list of fields within the hash for which to get the expiration
+                    time.
+
+        Returns:
+            If the key does not exist, returns an empty list. If the key exists, returns
+            a list which contains for each field in the request:
+                - `-2` if the field does not exist.
+                - `-1` if the field exists but has no associated expire time.
+                - A positive integer representing the expiration Unix timestamp in
+                  milliseconds, if the field has an associated expiration time.
+        """
+        return self.execute_command(
+            "HPEXPIRETIME", key, "FIELDS", len(fields), *fields, keys=[key]
+        )
+
+    def httl(self, key: KeyT, *fields: str) -> ResponseT:
+        """
+        Returns the TTL (Time To Live) in seconds for each specified field within a hash
+        key.
+
+        For more information, see https://redis.io/commands/httl
+
+        Args:
+            key: The hash key.
+            fields: A list of fields within the hash for which to get the TTL.
+
+        Returns:
+            If the key does not exist, returns an empty list. If the key exists, returns
+            a list which contains for each field in the request:
+                - `-2` if the field does not exist.
+                - `-1` if the field exists but has no associated expire time.
+                - A positive integer representing the TTL in seconds if the field has
+                  an associated expiration time.
+        """
+        return self.execute_command(
+            "HTTL", key, "FIELDS", len(fields), *fields, keys=[key]
+        )
+
+    def hpttl(self, key: KeyT, *fields: str) -> ResponseT:
+        """
+        Returns the TTL (Time To Live) in milliseconds for each specified field within a
+        hash key.
+
+        For more information, see https://redis.io/commands/hpttl
+
+        Args:
+            key: The hash key.
+            fields: A list of fields within the hash for which to get the TTL.
+
+        Returns:
+            If the key does not exist, returns an empty list. If the key exists, returns
+            a list which contains for each field in the request:
+                - `-2` if the field does not exist.
+                - `-1` if the field exists but has no associated expire time.
+                - A positive integer representing the TTL in milliseconds if the field
+                  has an associated expiration time.
+        """
+        return self.execute_command(
+            "HPTTL", key, "FIELDS", len(fields), *fields, keys=[key]
+        )
+
 
 AsyncHashCommands = HashCommands
 
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 0d9510c64b..80b0b1bff8 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -1453,7 +1453,7 @@ async def test_memory_stats(self, r: RedisCluster) -> None:
         assert isinstance(stats, dict)
         for key, value in stats.items():
             if key.startswith("db."):
-                assert isinstance(value, dict)
+                assert not isinstance(value, list)
 
     @skip_if_server_version_lt("4.0.0")
     async def test_memory_help(self, r: RedisCluster) -> None:
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index a01a4862ab..a29b4a548a 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -1352,7 +1352,7 @@ async def test_hscan(self, r: redis.Redis):
         _, dic = await r.hscan("a_notset", match="a")
         assert dic == {}
 
-    @skip_if_server_version_lt("7.4.0")
+    @skip_if_server_version_lt("7.3.240")
     async def test_hscan_novalues(self, r: redis.Redis):
         await r.hset("a", mapping={"a": 1, "b": 2, "c": 3})
         cursor, keys = await r.hscan("a", no_values=True)
@@ -1373,7 +1373,7 @@ async def test_hscan_iter(self, r: redis.Redis):
         dic = {k: v async for k, v in r.hscan_iter("a_notset", match="a")}
         assert dic == {}
 
-    @skip_if_server_version_lt("7.4.0")
+    @skip_if_server_version_lt("7.3.240")
     async def test_hscan_iter_novalues(self, r: redis.Redis):
         await r.hset("a", mapping={"a": 1, "b": 2, "c": 3})
         keys = list([k async for k in r.hscan_iter("a", no_values=True)])
diff --git a/tests/test_asyncio/test_graph.py b/tests/test_asyncio/test_graph.py
index 9cd9149dcc..ab8bf17618 100644
--- a/tests/test_asyncio/test_graph.py
+++ b/tests/test_asyncio/test_graph.py
@@ -20,6 +20,7 @@ async def test_bulk(decoded_r):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 async def test_graph_creation(decoded_r: redis.Redis):
     graph = decoded_r.graph()
 
@@ -65,6 +66,7 @@ async def test_graph_creation(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 async def test_array_functions(decoded_r: redis.Redis):
     graph = decoded_r.graph()
 
@@ -88,6 +90,7 @@ async def test_array_functions(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 async def test_path(decoded_r: redis.Redis):
     node0 = Node(node_id=0, label="L1")
     node1 = Node(node_id=1, label="L1")
@@ -108,6 +111,7 @@ async def test_path(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 async def test_param(decoded_r: redis.Redis):
     params = [1, 2.3, "str", True, False, None, [0, 1, 2]]
     query = "RETURN $param"
@@ -118,6 +122,7 @@ async def test_param(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 async def test_map(decoded_r: redis.Redis):
     query = "RETURN {a:1, b:'str', c:NULL, d:[1,2,3], e:True, f:{x:1, y:2}}"
 
@@ -135,6 +140,7 @@ async def test_map(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 async def test_point(decoded_r: redis.Redis):
     query = "RETURN point({latitude: 32.070794860, longitude: 34.820751118})"
     expected_lat = 32.070794860
@@ -152,6 +158,7 @@ async def test_point(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 async def test_index_response(decoded_r: redis.Redis):
     result_set = await decoded_r.graph().query("CREATE INDEX ON :person(age)")
     assert 1 == result_set.indices_created
@@ -167,6 +174,7 @@ async def test_index_response(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 async def test_stringify_query_result(decoded_r: redis.Redis):
     graph = decoded_r.graph()
 
@@ -221,6 +229,7 @@ async def test_stringify_query_result(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 async def test_optional_match(decoded_r: redis.Redis):
     # Build a graph of form (a)-[R]->(b)
     node0 = Node(node_id=0, label="L1", properties={"value": "a"})
@@ -246,6 +255,7 @@ async def test_optional_match(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 async def test_cached_execution(decoded_r: redis.Redis):
     await decoded_r.graph().query("CREATE ()")
 
@@ -266,6 +276,7 @@ async def test_cached_execution(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 async def test_slowlog(decoded_r: redis.Redis):
     create_query = """CREATE
     (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
@@ -280,6 +291,7 @@ async def test_slowlog(decoded_r: redis.Redis):
 
 @pytest.mark.xfail(strict=False)
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 async def test_query_timeout(decoded_r: redis.Redis):
     # Build a sample graph with 1000 nodes.
     await decoded_r.graph().query("UNWIND range(0,1000) as val CREATE ({v: val})")
@@ -294,6 +306,7 @@ async def test_query_timeout(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 async def test_read_only_query(decoded_r: redis.Redis):
     with pytest.raises(Exception):
         # Issue a write query, specifying read-only true,
@@ -303,6 +316,7 @@ async def test_read_only_query(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 async def test_profile(decoded_r: redis.Redis):
     q = """UNWIND range(1, 3) AS x CREATE (p:Person {v:x})"""
     profile = (await decoded_r.graph().profile(q)).result_set
@@ -319,6 +333,7 @@ async def test_profile(decoded_r: redis.Redis):
 
 @skip_if_redis_enterprise()
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 async def test_config(decoded_r: redis.Redis):
     config_name = "RESULTSET_SIZE"
     config_value = 3
@@ -351,6 +366,7 @@ async def test_config(decoded_r: redis.Redis):
 
 @pytest.mark.onlynoncluster
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 async def test_list_keys(decoded_r: redis.Redis):
     result = await decoded_r.graph().list_keys()
     assert result == []
@@ -374,6 +390,7 @@ async def test_list_keys(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 async def test_multi_label(decoded_r: redis.Redis):
     redis_graph = decoded_r.graph("g")
 
@@ -400,6 +417,7 @@ async def test_multi_label(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 async def test_execution_plan(decoded_r: redis.Redis):
     redis_graph = decoded_r.graph("execution_plan")
     create_query = """CREATE
@@ -419,6 +437,7 @@ async def test_execution_plan(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 async def test_explain(decoded_r: redis.Redis):
     redis_graph = decoded_r.graph("execution_plan")
     # graph creation / population
diff --git a/tests/test_asyncio/test_hash.py b/tests/test_asyncio/test_hash.py
new file mode 100644
index 0000000000..d4f180539e
--- /dev/null
+++ b/tests/test_asyncio/test_hash.py
@@ -0,0 +1,300 @@
+import asyncio
+from datetime import datetime, timedelta
+
+from tests.conftest import skip_if_server_version_lt
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hexpire_basic(r):
+    await r.delete("test:hash")
+    await r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    assert await r.hexpire("test:hash", 1, "field1") == [1]
+    await asyncio.sleep(1.1)
+    assert await r.hexists("test:hash", "field1") is False
+    assert await r.hexists("test:hash", "field2") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hexpire_with_timedelta(r):
+    await r.delete("test:hash")
+    await r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    assert await r.hexpire("test:hash", timedelta(seconds=1), "field1") == [1]
+    await asyncio.sleep(1.1)
+    assert await r.hexists("test:hash", "field1") is False
+    assert await r.hexists("test:hash", "field2") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hexpire_conditions(r):
+    await r.delete("test:hash")
+    await r.hset("test:hash", mapping={"field1": "value1"})
+    assert await r.hexpire("test:hash", 2, "field1", xx=True) == [0]
+    assert await r.hexpire("test:hash", 2, "field1", nx=True) == [1]
+    assert await r.hexpire("test:hash", 1, "field1", xx=True) == [1]
+    assert await r.hexpire("test:hash", 2, "field1", nx=True) == [0]
+    await asyncio.sleep(1.1)
+    assert await r.hexists("test:hash", "field1") is False
+    await r.hset("test:hash", "field1", "value1")
+    await r.hexpire("test:hash", 2, "field1")
+    assert await r.hexpire("test:hash", 1, "field1", gt=True) == [0]
+    assert await r.hexpire("test:hash", 1, "field1", lt=True) == [1]
+    await asyncio.sleep(1.1)
+    assert await r.hexists("test:hash", "field1") is False
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hexpire_nonexistent_key_or_field(r):
+    await r.delete("test:hash")
+    assert await r.hexpire("test:hash", 1, "field1") == []
+    await r.hset("test:hash", "field1", "value1")
+    assert await r.hexpire("test:hash", 1, "nonexistent_field") == [-2]
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hexpire_multiple_fields(r):
+    await r.delete("test:hash")
+    await r.hset(
+        "test:hash",
+        mapping={"field1": "value1", "field2": "value2", "field3": "value3"},
+    )
+    assert await r.hexpire("test:hash", 1, "field1", "field2") == [1, 1]
+    await asyncio.sleep(1.1)
+    assert await r.hexists("test:hash", "field1") is False
+    assert await r.hexists("test:hash", "field2") is False
+    assert await r.hexists("test:hash", "field3") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hpexpire_basic(r):
+    await r.delete("test:hash")
+    await r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    assert await r.hpexpire("test:hash", 500, "field1") == [1]
+    await asyncio.sleep(0.6)
+    assert await r.hexists("test:hash", "field1") is False
+    assert await r.hexists("test:hash", "field2") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hpexpire_with_timedelta(r):
+    await r.delete("test:hash")
+    await r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    assert await r.hpexpire("test:hash", timedelta(milliseconds=500), "field1") == [1]
+    await asyncio.sleep(0.6)
+    assert await r.hexists("test:hash", "field1") is False
+    assert await r.hexists("test:hash", "field2") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hpexpire_conditions(r):
+    await r.delete("test:hash")
+    await r.hset("test:hash", mapping={"field1": "value1"})
+    assert await r.hpexpire("test:hash", 1500, "field1", xx=True) == [0]
+    assert await r.hpexpire("test:hash", 1500, "field1", nx=True) == [1]
+    assert await r.hpexpire("test:hash", 500, "field1", xx=True) == [1]
+    assert await r.hpexpire("test:hash", 1500, "field1", nx=True) == [0]
+    await asyncio.sleep(0.6)
+    assert await r.hexists("test:hash", "field1") is False
+    await r.hset("test:hash", "field1", "value1")
+    await r.hpexpire("test:hash", 1000, "field1")
+    assert await r.hpexpire("test:hash", 500, "field1", gt=True) == [0]
+    assert await r.hpexpire("test:hash", 500, "field1", lt=True) == [1]
+    await asyncio.sleep(0.6)
+    assert await r.hexists("test:hash", "field1") is False
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hpexpire_nonexistent_key_or_field(r):
+    await r.delete("test:hash")
+    assert await r.hpexpire("test:hash", 500, "field1") == []
+    await r.hset("test:hash", "field1", "value1")
+    assert await r.hpexpire("test:hash", 500, "nonexistent_field") == [-2]
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hpexpire_multiple_fields(r):
+    await r.delete("test:hash")
+    await r.hset(
+        "test:hash",
+        mapping={"field1": "value1", "field2": "value2", "field3": "value3"},
+    )
+    assert await r.hpexpire("test:hash", 500, "field1", "field2") == [1, 1]
+    await asyncio.sleep(0.6)
+    assert await r.hexists("test:hash", "field1") is False
+    assert await r.hexists("test:hash", "field2") is False
+    assert await r.hexists("test:hash", "field3") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hexpireat_basic(r):
+    await r.delete("test:hash")
+    await r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    exp_time = int((datetime.now() + timedelta(seconds=1)).timestamp())
+    assert await r.hexpireat("test:hash", exp_time, "field1") == [1]
+    await asyncio.sleep(1.1)
+    assert await r.hexists("test:hash", "field1") is False
+    assert await r.hexists("test:hash", "field2") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hexpireat_with_datetime(r):
+    await r.delete("test:hash")
+    await r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    exp_time = datetime.now() + timedelta(seconds=1)
+    assert await r.hexpireat("test:hash", exp_time, "field1") == [1]
+    await asyncio.sleep(1.1)
+    assert await r.hexists("test:hash", "field1") is False
+    assert await r.hexists("test:hash", "field2") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hexpireat_conditions(r):
+    await r.delete("test:hash")
+    await r.hset("test:hash", mapping={"field1": "value1"})
+    future_exp_time = int((datetime.now() + timedelta(seconds=2)).timestamp())
+    past_exp_time = int((datetime.now() - timedelta(seconds=1)).timestamp())
+    assert await r.hexpireat("test:hash", future_exp_time, "field1", xx=True) == [0]
+    assert await r.hexpireat("test:hash", future_exp_time, "field1", nx=True) == [1]
+    assert await r.hexpireat("test:hash", past_exp_time, "field1", gt=True) == [0]
+    assert await r.hexpireat("test:hash", past_exp_time, "field1", lt=True) == [2]
+    assert await r.hexists("test:hash", "field1") is False
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hexpireat_nonexistent_key_or_field(r):
+    await r.delete("test:hash")
+    future_exp_time = int((datetime.now() + timedelta(seconds=1)).timestamp())
+    assert await r.hexpireat("test:hash", future_exp_time, "field1") == []
+    await r.hset("test:hash", "field1", "value1")
+    assert await r.hexpireat("test:hash", future_exp_time, "nonexistent_field") == [-2]
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hexpireat_multiple_fields(r):
+    await r.delete("test:hash")
+    await r.hset(
+        "test:hash",
+        mapping={"field1": "value1", "field2": "value2", "field3": "value3"},
+    )
+    exp_time = int((datetime.now() + timedelta(seconds=1)).timestamp())
+    assert await r.hexpireat("test:hash", exp_time, "field1", "field2") == [1, 1]
+    await asyncio.sleep(1.1)
+    assert await r.hexists("test:hash", "field1") is False
+    assert await r.hexists("test:hash", "field2") is False
+    assert await r.hexists("test:hash", "field3") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hpexpireat_basic(r):
+    await r.delete("test:hash")
+    await r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    exp_time = int((datetime.now() + timedelta(milliseconds=400)).timestamp() * 1000)
+    assert await r.hpexpireat("test:hash", exp_time, "field1") == [1]
+    await asyncio.sleep(0.5)
+    assert await r.hexists("test:hash", "field1") is False
+    assert await r.hexists("test:hash", "field2") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hpexpireat_with_datetime(r):
+    await r.delete("test:hash")
+    await r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    exp_time = datetime.now() + timedelta(milliseconds=400)
+    assert await r.hpexpireat("test:hash", exp_time, "field1") == [1]
+    await asyncio.sleep(0.5)
+    assert await r.hexists("test:hash", "field1") is False
+    assert await r.hexists("test:hash", "field2") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hpexpireat_conditions(r):
+    await r.delete("test:hash")
+    await r.hset("test:hash", mapping={"field1": "value1"})
+    future_exp_time = int(
+        (datetime.now() + timedelta(milliseconds=500)).timestamp() * 1000
+    )
+    past_exp_time = int(
+        (datetime.now() - timedelta(milliseconds=500)).timestamp() * 1000
+    )
+    assert await r.hpexpireat("test:hash", future_exp_time, "field1", xx=True) == [0]
+    assert await r.hpexpireat("test:hash", future_exp_time, "field1", nx=True) == [1]
+    assert await r.hpexpireat("test:hash", past_exp_time, "field1", gt=True) == [0]
+    assert await r.hpexpireat("test:hash", past_exp_time, "field1", lt=True) == [2]
+    assert await r.hexists("test:hash", "field1") is False
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hpexpireat_nonexistent_key_or_field(r):
+    await r.delete("test:hash")
+    future_exp_time = int(
+        (datetime.now() + timedelta(milliseconds=500)).timestamp() * 1000
+    )
+    assert await r.hpexpireat("test:hash", future_exp_time, "field1") == []
+    await r.hset("test:hash", "field1", "value1")
+    assert await r.hpexpireat("test:hash", future_exp_time, "nonexistent_field") == [-2]
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hpexpireat_multiple_fields(r):
+    await r.delete("test:hash")
+    await r.hset(
+        "test:hash",
+        mapping={"field1": "value1", "field2": "value2", "field3": "value3"},
+    )
+    exp_time = int((datetime.now() + timedelta(milliseconds=400)).timestamp() * 1000)
+    assert await r.hpexpireat("test:hash", exp_time, "field1", "field2") == [1, 1]
+    await asyncio.sleep(0.5)
+    assert await r.hexists("test:hash", "field1") is False
+    assert await r.hexists("test:hash", "field2") is False
+    assert await r.hexists("test:hash", "field3") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hpersist_multiple_fields_mixed_conditions(r):
+    await r.delete("test:hash")
+    await r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    await r.hexpire("test:hash", 5000, "field1")
+    assert await r.hpersist("test:hash", "field1", "field2", "field3") == [1, -1, -2]
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hexpiretime_multiple_fields_mixed_conditions(r):
+    await r.delete("test:hash")
+    await r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    future_time = int((datetime.now() + timedelta(minutes=30)).timestamp())
+    await r.hexpireat("test:hash", future_time, "field1")
+    result = await r.hexpiretime("test:hash", "field1", "field2", "field3")
+    assert future_time - 10 < result[0] <= future_time
+    assert result[1:] == [-1, -2]
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_hpexpiretime_multiple_fields_mixed_conditions(r):
+    await r.delete("test:hash")
+    await r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    future_time = int((datetime.now() + timedelta(minutes=30)).timestamp())
+    await r.hexpireat("test:hash", future_time, "field1")
+    result = await r.hpexpiretime("test:hash", "field1", "field2", "field3")
+    assert future_time * 1000 - 10000 < result[0] <= future_time * 1000
+    assert result[1:] == [-1, -2]
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_ttl_multiple_fields_mixed_conditions(r):
+    await r.delete("test:hash")
+    await r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    future_time = int((datetime.now() + timedelta(minutes=30)).timestamp())
+    await r.hexpireat("test:hash", future_time, "field1")
+    result = await r.httl("test:hash", "field1", "field2", "field3")
+    assert 30 * 60 - 10 < result[0] <= 30 * 60
+    assert result[1:] == [-1, -2]
+
+
+@skip_if_server_version_lt("7.3.240")
+async def test_pttl_multiple_fields_mixed_conditions(r):
+    await r.delete("test:hash")
+    await r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    future_time = int((datetime.now() + timedelta(minutes=30)).timestamp())
+    await r.hexpireat("test:hash", future_time, "field1")
+    result = await r.hpttl("test:hash", "field1", "field2", "field3")
+    assert 30 * 60000 - 10000 < result[0] <= 30 * 60000
+    assert result[1:] == [-1, -2]
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index d41ebcd506..5a32bd6a7e 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -1577,7 +1577,7 @@ def test_memory_stats(self, r):
         assert isinstance(stats, dict)
         for key, value in stats.items():
             if key.startswith("db."):
-                assert isinstance(value, dict)
+                assert not isinstance(value, list)
 
     @skip_if_server_version_lt("4.0.0")
     def test_memory_help(self, r):
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 8fbec5fb7e..d0c235daf9 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -707,8 +707,9 @@ def test_client_kill_filter_by_user(self, r, request):
             assert c["user"] != killuser
         r.acl_deluser(killuser)
 
-    @skip_if_server_version_lt("7.4.0")
+    @skip_if_server_version_lt("7.3.240")
     @skip_if_redis_enterprise()
+    @pytest.mark.onlynoncluster
     def test_client_kill_filter_by_maxage(self, r, request):
         _get_client(redis.Redis, request, flushdb=False)
         time.sleep(4)
@@ -2174,7 +2175,7 @@ def test_hscan(self, r):
         _, dic = r.hscan("a_notset")
         assert dic == {}
 
-    @skip_if_server_version_lt("7.4.0")
+    @skip_if_server_version_lt("7.3.240")
     def test_hscan_novalues(self, r):
         r.hset("a", mapping={"a": 1, "b": 2, "c": 3})
         cursor, keys = r.hscan("a", no_values=True)
@@ -2195,7 +2196,7 @@ def test_hscan_iter(self, r):
         dic = dict(r.hscan_iter("a_notset"))
         assert dic == {}
 
-    @skip_if_server_version_lt("7.4.0")
+    @skip_if_server_version_lt("7.3.240")
     def test_hscan_iter_novalues(self, r):
         r.hset("a", mapping={"a": 1, "b": 2, "c": 3})
         keys = list(r.hscan_iter("a", no_values=True))
diff --git a/tests/test_graph.py b/tests/test_graph.py
index 2eace0181c..7f46a538ff 100644
--- a/tests/test_graph.py
+++ b/tests/test_graph.py
@@ -31,6 +31,7 @@ def client(request, stack_url):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_bulk(client):
     with pytest.raises(NotImplementedError):
         client.graph().bulk()
@@ -38,6 +39,7 @@ def test_bulk(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_graph_creation(client):
     graph = client.graph()
 
@@ -83,6 +85,7 @@ def test_graph_creation(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_array_functions(client):
     query = """CREATE (p:person{name:'a',age:32, array:[0,1,2]})"""
     client.graph().query(query)
@@ -104,6 +107,7 @@ def test_array_functions(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_path(client):
     node0 = Node(node_id=0, label="L1")
     node1 = Node(node_id=1, label="L1")
@@ -124,6 +128,7 @@ def test_path(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_param(client):
     params = [1, 2.3, "str", True, False, None, [0, 1, 2], r"\" RETURN 1337 //"]
     query = "RETURN $param"
@@ -134,6 +139,7 @@ def test_param(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_map(client):
     query = "RETURN {a:1, b:'str', c:NULL, d:[1,2,3], e:True, f:{x:1, y:2}}"
 
@@ -151,6 +157,7 @@ def test_map(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_point(client):
     query = "RETURN point({latitude: 32.070794860, longitude: 34.820751118})"
     expected_lat = 32.070794860
@@ -168,6 +175,7 @@ def test_point(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_index_response(client):
     result_set = client.graph().query("CREATE INDEX ON :person(age)")
     assert 1 == result_set.indices_created
@@ -183,6 +191,7 @@ def test_index_response(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_stringify_query_result(client):
     graph = client.graph()
 
@@ -237,6 +246,7 @@ def test_stringify_query_result(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_optional_match(client):
     # Build a graph of form (a)-[R]->(b)
     node0 = Node(node_id=0, label="L1", properties={"value": "a"})
@@ -262,6 +272,7 @@ def test_optional_match(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_cached_execution(client):
     client.graph().query("CREATE ()")
 
@@ -280,6 +291,7 @@ def test_cached_execution(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_slowlog(client):
     create_query = """CREATE (:Rider
     {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
@@ -294,6 +306,7 @@ def test_slowlog(client):
 
 @pytest.mark.redismod
 @pytest.mark.xfail(strict=False)
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_query_timeout(client):
     # Build a sample graph with 1000 nodes.
     client.graph().query("UNWIND range(0,1000) as val CREATE ({v: val})")
@@ -308,6 +321,7 @@ def test_query_timeout(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_read_only_query(client):
     with pytest.raises(Exception):
         # Issue a write query, specifying read-only true,
@@ -317,6 +331,7 @@ def test_read_only_query(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_profile(client):
     q = """UNWIND range(1, 3) AS x CREATE (p:Person {v:x})"""
     profile = client.graph().profile(q).result_set
@@ -333,6 +348,7 @@ def test_profile(client):
 
 @pytest.mark.redismod
 @skip_if_redis_enterprise()
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_config(client):
     config_name = "RESULTSET_SIZE"
     config_value = 3
@@ -365,6 +381,7 @@ def test_config(client):
 
 @pytest.mark.onlynoncluster
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_list_keys(client):
     result = client.graph().list_keys()
     assert result == []
@@ -388,6 +405,7 @@ def test_list_keys(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_multi_label(client):
     redis_graph = client.graph("g")
 
@@ -414,6 +432,7 @@ def test_multi_label(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_cache_sync(client):
     pass
     return
@@ -487,6 +506,7 @@ def test_cache_sync(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_execution_plan(client):
     redis_graph = client.graph("execution_plan")
     create_query = """CREATE
@@ -506,6 +526,7 @@ def test_execution_plan(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_explain(client):
     redis_graph = client.graph("execution_plan")
     # graph creation / population
@@ -595,6 +616,7 @@ def test_explain(client):
 
 
 @pytest.mark.redismod
+@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_resultset_statistics(client):
     with patch.object(target=QueryResult, attribute="_get_stat") as mock_get_stats:
         result = client.graph().query("RETURN 1")
diff --git a/tests/test_hash.py b/tests/test_hash.py
new file mode 100644
index 0000000000..7145b10a07
--- /dev/null
+++ b/tests/test_hash.py
@@ -0,0 +1,369 @@
+import time
+from datetime import datetime, timedelta
+
+import pytest
+from tests.conftest import skip_if_server_version_lt
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hexpire_basic(r):
+    r.delete("test:hash")
+    r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    assert r.hexpire("test:hash", 1, "field1") == [1]
+    time.sleep(1.1)
+    assert r.hexists("test:hash", "field1") is False
+    assert r.hexists("test:hash", "field2") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hexpire_with_timedelta(r):
+    r.delete("test:hash")
+    r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    assert r.hexpire("test:hash", timedelta(seconds=1), "field1") == [1]
+    time.sleep(1.1)
+    assert r.hexists("test:hash", "field1") is False
+    assert r.hexists("test:hash", "field2") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hexpire_conditions(r):
+    r.delete("test:hash")
+    r.hset("test:hash", mapping={"field1": "value1"})
+    assert r.hexpire("test:hash", 2, "field1", xx=True) == [0]
+    assert r.hexpire("test:hash", 2, "field1", nx=True) == [1]
+    assert r.hexpire("test:hash", 1, "field1", xx=True) == [1]
+    assert r.hexpire("test:hash", 2, "field1", nx=True) == [0]
+    time.sleep(1.1)
+    assert r.hexists("test:hash", "field1") is False
+    r.hset("test:hash", "field1", "value1")
+    r.hexpire("test:hash", 2, "field1")
+    assert r.hexpire("test:hash", 1, "field1", gt=True) == [0]
+    assert r.hexpire("test:hash", 1, "field1", lt=True) == [1]
+    time.sleep(1.1)
+    assert r.hexists("test:hash", "field1") is False
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hexpire_nonexistent_key_or_field(r):
+    r.delete("test:hash")
+    assert r.hexpire("test:hash", 1, "field1") == []
+    r.hset("test:hash", "field1", "value1")
+    assert r.hexpire("test:hash", 1, "nonexistent_field") == [-2]
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hexpire_multiple_fields(r):
+    r.delete("test:hash")
+    r.hset(
+        "test:hash",
+        mapping={"field1": "value1", "field2": "value2", "field3": "value3"},
+    )
+    assert r.hexpire("test:hash", 1, "field1", "field2") == [1, 1]
+    time.sleep(1.1)
+    assert r.hexists("test:hash", "field1") is False
+    assert r.hexists("test:hash", "field2") is False
+    assert r.hexists("test:hash", "field3") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hexpire_multiple_condition_flags_error(r):
+    r.delete("test:hash")
+    r.hset("test:hash", mapping={"field1": "value1"})
+    with pytest.raises(ValueError) as e:
+        r.hexpire("test:hash", 1, "field1", nx=True, xx=True)
+    assert "Only one of" in str(e)
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hpexpire_basic(r):
+    r.delete("test:hash")
+    r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    assert r.hpexpire("test:hash", 500, "field1") == [1]
+    time.sleep(0.6)
+    assert r.hexists("test:hash", "field1") is False
+    assert r.hexists("test:hash", "field2") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hpexpire_with_timedelta(r):
+    r.delete("test:hash")
+    r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    assert r.hpexpire("test:hash", timedelta(milliseconds=500), "field1") == [1]
+    time.sleep(0.6)
+    assert r.hexists("test:hash", "field1") is False
+    assert r.hexists("test:hash", "field2") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hpexpire_conditions(r):
+    r.delete("test:hash")
+    r.hset("test:hash", mapping={"field1": "value1"})
+    assert r.hpexpire("test:hash", 1500, "field1", xx=True) == [0]
+    assert r.hpexpire("test:hash", 1500, "field1", nx=True) == [1]
+    assert r.hpexpire("test:hash", 500, "field1", xx=True) == [1]
+    assert r.hpexpire("test:hash", 1500, "field1", nx=True) == [0]
+    time.sleep(0.6)
+    assert r.hexists("test:hash", "field1") is False
+    r.hset("test:hash", "field1", "value1")
+    r.hpexpire("test:hash", 1000, "field1")
+    assert r.hpexpire("test:hash", 500, "field1", gt=True) == [0]
+    assert r.hpexpire("test:hash", 500, "field1", lt=True) == [1]
+    time.sleep(0.6)
+    assert r.hexists("test:hash", "field1") is False
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hpexpire_nonexistent_key_or_field(r):
+    r.delete("test:hash")
+    assert r.hpexpire("test:hash", 500, "field1") == []
+    r.hset("test:hash", "field1", "value1")
+    assert r.hpexpire("test:hash", 500, "nonexistent_field") == [-2]
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hpexpire_multiple_fields(r):
+    r.delete("test:hash")
+    r.hset(
+        "test:hash",
+        mapping={"field1": "value1", "field2": "value2", "field3": "value3"},
+    )
+    assert r.hpexpire("test:hash", 500, "field1", "field2") == [1, 1]
+    time.sleep(0.6)
+    assert r.hexists("test:hash", "field1") is False
+    assert r.hexists("test:hash", "field2") is False
+    assert r.hexists("test:hash", "field3") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hpexpire_multiple_condition_flags_error(r):
+    r.delete("test:hash")
+    r.hset("test:hash", mapping={"field1": "value1"})
+    with pytest.raises(ValueError) as e:
+        r.hpexpire("test:hash", 500, "field1", nx=True, xx=True)
+    assert "Only one of" in str(e)
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hexpireat_basic(r):
+    r.delete("test:hash")
+    r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    exp_time = int((datetime.now() + timedelta(seconds=1)).timestamp())
+    assert r.hexpireat("test:hash", exp_time, "field1") == [1]
+    time.sleep(1.1)
+    assert r.hexists("test:hash", "field1") is False
+    assert r.hexists("test:hash", "field2") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hexpireat_with_datetime(r):
+    r.delete("test:hash")
+    r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    exp_time = datetime.now() + timedelta(seconds=1)
+    assert r.hexpireat("test:hash", exp_time, "field1") == [1]
+    time.sleep(1.1)
+    assert r.hexists("test:hash", "field1") is False
+    assert r.hexists("test:hash", "field2") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hexpireat_conditions(r):
+    r.delete("test:hash")
+    r.hset("test:hash", mapping={"field1": "value1"})
+    future_exp_time = int((datetime.now() + timedelta(seconds=2)).timestamp())
+    past_exp_time = int((datetime.now() - timedelta(seconds=1)).timestamp())
+    assert r.hexpireat("test:hash", future_exp_time, "field1", xx=True) == [0]
+    assert r.hexpireat("test:hash", future_exp_time, "field1", nx=True) == [1]
+    assert r.hexpireat("test:hash", past_exp_time, "field1", gt=True) == [0]
+    assert r.hexpireat("test:hash", past_exp_time, "field1", lt=True) == [2]
+    assert r.hexists("test:hash", "field1") is False
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hexpireat_nonexistent_key_or_field(r):
+    r.delete("test:hash")
+    future_exp_time = int((datetime.now() + timedelta(seconds=1)).timestamp())
+    assert r.hexpireat("test:hash", future_exp_time, "field1") == []
+    r.hset("test:hash", "field1", "value1")
+    assert r.hexpireat("test:hash", future_exp_time, "nonexistent_field") == [-2]
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hexpireat_multiple_fields(r):
+    r.delete("test:hash")
+    r.hset(
+        "test:hash",
+        mapping={"field1": "value1", "field2": "value2", "field3": "value3"},
+    )
+    exp_time = int((datetime.now() + timedelta(seconds=1)).timestamp())
+    assert r.hexpireat("test:hash", exp_time, "field1", "field2") == [1, 1]
+    time.sleep(1.1)
+    assert r.hexists("test:hash", "field1") is False
+    assert r.hexists("test:hash", "field2") is False
+    assert r.hexists("test:hash", "field3") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hexpireat_multiple_condition_flags_error(r):
+    r.delete("test:hash")
+    r.hset("test:hash", mapping={"field1": "value1"})
+    exp_time = int((datetime.now() + timedelta(seconds=1)).timestamp())
+    with pytest.raises(ValueError) as e:
+        r.hexpireat("test:hash", exp_time, "field1", nx=True, xx=True)
+    assert "Only one of" in str(e)
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hpexpireat_basic(r):
+    r.delete("test:hash")
+    r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    exp_time = int((datetime.now() + timedelta(milliseconds=400)).timestamp() * 1000)
+    assert r.hpexpireat("test:hash", exp_time, "field1") == [1]
+    time.sleep(0.5)
+    assert r.hexists("test:hash", "field1") is False
+    assert r.hexists("test:hash", "field2") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hpexpireat_with_datetime(r):
+    r.delete("test:hash")
+    r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    exp_time = datetime.now() + timedelta(milliseconds=400)
+    assert r.hpexpireat("test:hash", exp_time, "field1") == [1]
+    time.sleep(0.5)
+    assert r.hexists("test:hash", "field1") is False
+    assert r.hexists("test:hash", "field2") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hpexpireat_conditions(r):
+    r.delete("test:hash")
+    r.hset("test:hash", mapping={"field1": "value1"})
+    future_exp_time = int(
+        (datetime.now() + timedelta(milliseconds=500)).timestamp() * 1000
+    )
+    past_exp_time = int(
+        (datetime.now() - timedelta(milliseconds=500)).timestamp() * 1000
+    )
+    assert r.hpexpireat("test:hash", future_exp_time, "field1", xx=True) == [0]
+    assert r.hpexpireat("test:hash", future_exp_time, "field1", nx=True) == [1]
+    assert r.hpexpireat("test:hash", past_exp_time, "field1", gt=True) == [0]
+    assert r.hpexpireat("test:hash", past_exp_time, "field1", lt=True) == [2]
+    assert r.hexists("test:hash", "field1") is False
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hpexpireat_nonexistent_key_or_field(r):
+    r.delete("test:hash")
+    future_exp_time = int(
+        (datetime.now() + timedelta(milliseconds=500)).timestamp() * 1000
+    )
+    assert r.hpexpireat("test:hash", future_exp_time, "field1") == []
+    r.hset("test:hash", "field1", "value1")
+    assert r.hpexpireat("test:hash", future_exp_time, "nonexistent_field") == [-2]
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hpexpireat_multiple_fields(r):
+    r.delete("test:hash")
+    r.hset(
+        "test:hash",
+        mapping={"field1": "value1", "field2": "value2", "field3": "value3"},
+    )
+    exp_time = int((datetime.now() + timedelta(milliseconds=400)).timestamp() * 1000)
+    assert r.hpexpireat("test:hash", exp_time, "field1", "field2") == [1, 1]
+    time.sleep(0.5)
+    assert r.hexists("test:hash", "field1") is False
+    assert r.hexists("test:hash", "field2") is False
+    assert r.hexists("test:hash", "field3") is True
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hpexpireat_multiple_condition_flags_error(r):
+    r.delete("test:hash")
+    r.hset("test:hash", mapping={"field1": "value1"})
+    exp_time = int((datetime.now() + timedelta(milliseconds=500)).timestamp())
+    with pytest.raises(ValueError) as e:
+        r.hpexpireat("test:hash", exp_time, "field1", nx=True, xx=True)
+    assert "Only one of" in str(e)
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hpersist_multiple_fields(r):
+    r.delete("test:hash")
+    r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    r.hexpire("test:hash", 5000, "field1")
+    assert r.hpersist("test:hash", "field1", "field2", "field3") == [1, -1, -2]
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hpersist_nonexistent_key(r):
+    r.delete("test:hash")
+    assert r.hpersist("test:hash", "field1", "field2", "field3") == []
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hexpiretime_multiple_fields_mixed_conditions(r):
+    r.delete("test:hash")
+    r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    future_time = int((datetime.now() + timedelta(minutes=30)).timestamp())
+    r.hexpireat("test:hash", future_time, "field1")
+    result = r.hexpiretime("test:hash", "field1", "field2", "field3")
+    assert future_time - 10 < result[0] <= future_time
+    assert result[1:] == [-1, -2]
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hexpiretime_nonexistent_key(r):
+    r.delete("test:hash")
+    assert r.hexpiretime("test:hash", "field1", "field2", "field3") == []
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hpexpiretime_multiple_fields_mixed_conditions(r):
+    r.delete("test:hash")
+    r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    future_time = int((datetime.now() + timedelta(minutes=30)).timestamp())
+    r.hexpireat("test:hash", future_time, "field1")
+    result = r.hpexpiretime("test:hash", "field1", "field2", "field3")
+    assert future_time * 1000 - 10000 < result[0] <= future_time * 1000
+    assert result[1:] == [-1, -2]
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hpexpiretime_nonexistent_key(r):
+    r.delete("test:hash")
+    assert r.hpexpiretime("test:hash", "field1", "field2", "field3") == []
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_httl_multiple_fields_mixed_conditions(r):
+    r.delete("test:hash")
+    r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    future_time = int((datetime.now() + timedelta(minutes=30)).timestamp())
+    r.hexpireat("test:hash", future_time, "field1")
+    result = r.httl("test:hash", "field1", "field2", "field3")
+    assert 30 * 60 - 10 < result[0] <= 30 * 60
+    assert result[1:] == [-1, -2]
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_httl_nonexistent_key(r):
+    r.delete("test:hash")
+    assert r.httl("test:hash", "field1", "field2", "field3") == []
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hpttl_multiple_fields_mixed_conditions(r):
+    r.delete("test:hash")
+    r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
+    future_time = int((datetime.now() + timedelta(minutes=30)).timestamp())
+    r.hexpireat("test:hash", future_time, "field1")
+    result = r.hpttl("test:hash", "field1", "field2", "field3")
+    assert 30 * 60000 - 10000 < result[0] <= 30 * 60000
+    assert result[1:] == [-1, -2]
+
+
+@skip_if_server_version_lt("7.3.240")
+def test_hpttl_nonexistent_key(r):
+    r.delete("test:hash")
+    assert r.hpttl("test:hash", "field1", "field2", "field3") == []

From 3a0c724f9b300452b95347014af596f254810dca Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@gmail.com>
Date: Thu, 6 Jun 2024 20:54:06 +0300
Subject: [PATCH 0885/1164] Version 5.1.0b6 (#3269)

Bump version to 5.1.0b6

Co-authored-by: Gabriel Erzse <gabriel.erzse@redis.com>
---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index cf3d582713..8df216ccea 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="5.1.0b5",
+    version="5.1.0b6",
     packages=find_packages(
         include=[
             "redis",

From 9d85723ecf0fe642040d15d30fb1b35d256d16fd Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@redis.com>
Date: Wed, 12 Jun 2024 13:29:41 +0300
Subject: [PATCH 0886/1164] Timeseries insertion filters for close samples
 (#3228)

Support timeseries insertion filters for samples that are close to each
other in time and value.

Use the documented way to disable compression, i.e. `ENCODING
UNCOMPRESSED` instead of `UNCOMPRESSED`.

Polish the documentation related to timeseries.

Align things needed around CI, to make sure all tests are actually executed.

BREAKING CHANGES:

1. Remove the `uncompressed` flag from TS.ALTER, since compression of
existing timeseries cannot be changed. This should not have been used, so
there should be no real impact.

2. For the TS.ADD command (TimeSeriesCommands.add method): the
`duplicate_policy` Python parameter that was mapping to
`ON DUPLICATE` was now rewired to map to `DUPLICATE POLICY`.
A new Python parameter called `on_duplicate` was added, that maps to
`ON DUPLICATE`. The expected impact of this change is low.
---
 .github/workflows/integration.yaml    | 160 ++---
 docker-compose.yml                    |   2 +-
 redis/commands/timeseries/commands.py | 939 ++++++++++++++++----------
 tests/conftest.py                     |   6 +-
 tests/test_asyncio/test_timeseries.py | 160 ++++-
 tests/test_timeseries.py              | 195 +++++-
 6 files changed, 980 insertions(+), 482 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 8f60efe6c7..11b08c934e 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -23,89 +23,91 @@ concurrency:
 permissions:
   contents: read  #  to fetch code (actions/checkout)
 
-jobs:
+env:
+  REDIS_STACK_IMAGE: redis/redis-stack-server:7.4.0-rc1
 
-   dependency-audit:
-     name: Dependency audit
-     runs-on: ubuntu-latest
-     steps:
-       - uses: actions/checkout@v4
-       - uses: pypa/gh-action-pip-audit@v1.0.8
-         with:
-           inputs: requirements.txt dev_requirements.txt
-           ignore-vulns: |
-             GHSA-w596-4wvx-j9j6  # subversion related git pull, dependency for pytest. There is no impact here.
+jobs:
+  dependency-audit:
+    name: Dependency audit
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pypa/gh-action-pip-audit@v1.0.8
+        with:
+          inputs: requirements.txt dev_requirements.txt
+          ignore-vulns: |
+            GHSA-w596-4wvx-j9j6  # subversion related git pull, dependency for pytest. There is no impact here.
 
-   lint:
-     name: Code linters
-     runs-on: ubuntu-latest
-     steps:
-       - uses: actions/checkout@v4
-       - uses: actions/setup-python@v5
-         with:
-           python-version: 3.9
-           cache: 'pip'
-       - name: run code linters
-         run: |
-           pip install -r dev_requirements.txt
-           invoke linters
+  lint:
+    name: Code linters
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.9
+          cache: 'pip'
+      - name: run code linters
+        run: |
+          pip install -r dev_requirements.txt
+          invoke linters
 
-   run-tests:
-     runs-on: ubuntu-latest
-     timeout-minutes: 60
-     strategy:
-       max-parallel: 15
-       fail-fast: false
-       matrix:
-         python-version: ['3.8', '3.9', '3.10', '3.11', 'pypy-3.8', 'pypy-3.9']
-         test-type: ['standalone', 'cluster']
-         connection-type: ['hiredis', 'plain']
-     env:
-       ACTIONS_ALLOW_UNSECURE_COMMANDS: true
-     name: Python ${{ matrix.python-version }} ${{matrix.test-type}}-${{matrix.connection-type}} tests
-     steps:
-       - uses: actions/checkout@v4
-       - uses: actions/setup-python@v5
-         with:
-           python-version: ${{ matrix.python-version }}
-           cache: 'pip'
-       - name: run tests
-         run: |
-           pip install -U setuptools wheel
-           pip install -r requirements.txt
-           pip install -r dev_requirements.txt
-           if [ "${{matrix.connection-type}}" == "hiredis" ]; then
-            pip install hiredis
-           fi
-           invoke devenv
-           sleep 10 # time to settle
-           invoke ${{matrix.test-type}}-tests
+  run-tests:
+    runs-on: ubuntu-latest
+    timeout-minutes: 60
+    strategy:
+      max-parallel: 15
+      fail-fast: false
+      matrix:
+        python-version: ['3.8', '3.9', '3.10', '3.11', 'pypy-3.8', 'pypy-3.9']
+        test-type: ['standalone', 'cluster']
+        connection-type: ['hiredis', 'plain']
+    env:
+      ACTIONS_ALLOW_UNSECURE_COMMANDS: true
+    name: Python ${{ matrix.python-version }} ${{matrix.test-type}}-${{matrix.connection-type}} tests
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: 'pip'
+      - name: run tests
+        run: |
+          pip install -U setuptools wheel
+          pip install -r requirements.txt
+          pip install -r dev_requirements.txt
+          if [ "${{matrix.connection-type}}" == "hiredis" ]; then
+           pip install hiredis
+          fi
+          invoke devenv
+          sleep 10 # time to settle
+          invoke ${{matrix.test-type}}-tests
 
-       - uses: actions/upload-artifact@v4
-         if: success() || failure()
-         with:
-           name: pytest-results-${{matrix.test-type}}-${{matrix.connection-type}}-${{matrix.python-version}}
-           path: '${{matrix.test-type}}*results.xml'
+      - uses: actions/upload-artifact@v4
+        if: success() || failure()
+        with:
+          name: pytest-results-${{matrix.test-type}}-${{matrix.connection-type}}-${{matrix.python-version}}
+          path: '${{matrix.test-type}}*results.xml'
 
-       - name: Upload codecov coverage
-         uses: codecov/codecov-action@v4
-         with:
-           fail_ci_if_error: false
+      - name: Upload codecov coverage
+        uses: codecov/codecov-action@v4
+        with:
+          fail_ci_if_error: false
 
-       - name: View Test Results
-         uses: dorny/test-reporter@v1
-         if: success() || failure()
-         continue-on-error: true
-         with:
-           name: Test Results ${{matrix.python-version}} ${{matrix.test-type}}-${{matrix.connection-type}}
-           path: '*.xml'
-           reporter: java-junit
-           list-suites: all
-           list-tests: all
-           max-annotations: 10
-           fail-on-error: 'false'
+      - name: View Test Results
+        uses: dorny/test-reporter@v1
+        if: success() || failure()
+        continue-on-error: true
+        with:
+          name: Test Results ${{matrix.python-version}} ${{matrix.test-type}}-${{matrix.connection-type}}
+          path: '*.xml'
+          reporter: java-junit
+          list-suites: all
+          list-tests: all
+          max-annotations: 10
+          fail-on-error: 'false'
 
-   resp3_tests:
+  resp3_tests:
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
@@ -115,7 +117,7 @@ jobs:
         connection-type: ['hiredis', 'plain']
         protocol: ['3']
     env:
-       ACTIONS_ALLOW_UNSECURE_COMMANDS: true
+      ACTIONS_ALLOW_UNSECURE_COMMANDS: true
     name: RESP3 [${{ matrix.python-version }} ${{matrix.test-type}}-${{matrix.connection-type}}]
     steps:
       - uses: actions/checkout@v4
@@ -136,7 +138,7 @@ jobs:
           invoke ${{matrix.test-type}}-tests
           invoke ${{matrix.test-type}}-tests --uvloop
 
-   build_and_test_package:
+  build_and_test_package:
     name: Validate building and installing the package
     runs-on: ubuntu-latest
     needs: [run-tests]
@@ -153,7 +155,7 @@ jobs:
         run: |
           bash .github/workflows/install_and_test.sh ${{ matrix.extension }}
 
-   install_package_from_commit:
+  install_package_from_commit:
     name: Install package from commit hash
     runs-on: ubuntu-latest
     strategy:
diff --git a/docker-compose.yml b/docker-compose.yml
index 09418ed094..72c43c2252 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -105,7 +105,7 @@ services:
       - all
 
   redis-stack:
-    image: redis/redis-stack-server:edge
+    image: ${REDIS_STACK_IMAGE:-redis/redis-stack-server:edge}
     container_name: redis-stack
     ports:
       - 6479:6379
diff --git a/redis/commands/timeseries/commands.py b/redis/commands/timeseries/commands.py
index 208ddfb09f..f8dfe8b5c0 100644
--- a/redis/commands/timeseries/commands.py
+++ b/redis/commands/timeseries/commands.py
@@ -33,44 +33,67 @@ def create(
         labels: Optional[Dict[str, str]] = None,
         chunk_size: Optional[int] = None,
         duplicate_policy: Optional[str] = None,
+        ignore_max_time_diff: Optional[int] = None,
+        ignore_max_val_diff: Optional[Number] = None,
     ):
         """
         Create a new time-series.
 
-        Args:
+        For more information see https://redis.io/commands/ts.create/
 
-        key:
-            time-series key
-        retention_msecs:
-            Maximum age for samples compared to highest reported timestamp (in milliseconds).
-            If None or 0 is passed then  the series is not trimmed at all.
-        uncompressed:
-            Changes data storage from compressed (by default) to uncompressed
-        labels:
-            Set of label-value pairs that represent metadata labels of the key.
-        chunk_size:
-            Memory size, in bytes, allocated for each data chunk.
-            Must be a multiple of 8 in the range [128 .. 1048576].
-        duplicate_policy:
-            Policy for handling multiple samples with identical timestamps.
-            Can be one of:
-            - 'block': an error will occur for any out of order sample.
-            - 'first': ignore the new value.
-            - 'last': override with latest value.
-            - 'min': only override if the value is lower than the existing value.
-            - 'max': only override if the value is higher than the existing value.
-            - 'sum': If a previous sample exists, add the new sample to it so that \
-            the updated value is equal to (previous + new). If no previous sample \
-            exists, set the updated value equal to the new value.
-
-        For more information: https://redis.io/commands/ts.create/
-        """  # noqa
+        Args:
+            key:
+                The time-series key.
+            retention_msecs:
+                Maximum age for samples, compared to the highest reported timestamp in
+                milliseconds. If `None` or `0` is passed, the series is not trimmed at
+                all.
+            uncompressed:
+                Changes data storage from compressed (default) to uncompressed.
+            labels:
+                A dictionary of label-value pairs that represent metadata labels of the
+                key.
+            chunk_size:
+                Memory size, in bytes, allocated for each data chunk. Must be a multiple
+                of 8 in the range `[48..1048576]`. In earlier versions of the module the
+                minimum value was different.
+            duplicate_policy:
+                Policy for handling multiple samples with identical timestamps. Can be
+                one of:
+                    - 'block': An error will occur and the new value will be ignored.
+                    - 'first': Ignore the new value.
+                    - 'last': Override with the latest value.
+                    - 'min': Only override if the value is lower than the existing
+                      value.
+                    - 'max': Only override if the value is higher than the existing
+                      value.
+                    - 'sum': If a previous sample exists, add the new sample to it so
+                      that the updated value is equal to (previous + new). If no
+                      previous sample exists, set the updated value equal to the new
+                      value.
+            ignore_max_time_diff:
+                A non-negative integer value, in milliseconds, that sets an ignore
+                threshold for added timestamps. If the difference between the last
+                timestamp and the new timestamp is lower than this threshold, the new
+                entry is ignored. Only applicable if `duplicate_policy` is set to
+                `last`, and if `ignore_max_val_diff` is also set. Available since
+                RedisTimeSeries version 1.12.0.
+            ignore_max_val_diff:
+                A non-negative floating point value, that sets an ignore threshold for
+                added values. If the difference between the last value and the new value
+                is lower than this threshold, the new entry is ignored. Only applicable
+                if `duplicate_policy` is set to `last`, and if `ignore_max_time_diff` is
+                also set. Available since RedisTimeSeries version 1.12.0.
+        """
         params = [key]
         self._append_retention(params, retention_msecs)
         self._append_uncompressed(params, uncompressed)
         self._append_chunk_size(params, chunk_size)
-        self._append_duplicate_policy(params, CREATE_CMD, duplicate_policy)
+        self._append_duplicate_policy(params, duplicate_policy)
         self._append_labels(params, labels)
+        self._append_insertion_filters(
+            params, ignore_max_time_diff, ignore_max_val_diff
+        )
 
         return self.execute_command(CREATE_CMD, *params)
 
@@ -81,42 +104,65 @@ def alter(
         labels: Optional[Dict[str, str]] = None,
         chunk_size: Optional[int] = None,
         duplicate_policy: Optional[str] = None,
+        ignore_max_time_diff: Optional[int] = None,
+        ignore_max_val_diff: Optional[Number] = None,
     ):
         """
-        Update the retention, chunk size, duplicate policy, and labels of an existing
-        time series.
+        Update an existing time series.
 
-        Args:
+        For more information see https://redis.io/commands/ts.alter/
 
-        key:
-            time-series key
-        retention_msecs:
-            Maximum retention period, compared to maximal existing timestamp (in milliseconds).
-            If None or 0 is passed then  the series is not trimmed at all.
-        labels:
-            Set of label-value pairs that represent metadata labels of the key.
-        chunk_size:
-            Memory size, in bytes, allocated for each data chunk.
-            Must be a multiple of 8 in the range [128 .. 1048576].
-        duplicate_policy:
-            Policy for handling multiple samples with identical timestamps.
-            Can be one of:
-            - 'block': an error will occur for any out of order sample.
-            - 'first': ignore the new value.
-            - 'last': override with latest value.
-            - 'min': only override if the value is lower than the existing value.
-            - 'max': only override if the value is higher than the existing value.
-            - 'sum': If a previous sample exists, add the new sample to it so that \
-            the updated value is equal to (previous + new). If no previous sample \
-            exists, set the updated value equal to the new value.
-
-        For more information: https://redis.io/commands/ts.alter/
-        """  # noqa
+        Args:
+            key:
+                The time-series key.
+            retention_msecs:
+                Maximum age for samples, compared to the highest reported timestamp in
+                milliseconds. If `None` or `0` is passed, the series is not trimmed at
+                all.
+            labels:
+                A dictionary of label-value pairs that represent metadata labels of the
+                key.
+            chunk_size:
+                Memory size, in bytes, allocated for each data chunk. Must be a multiple
+                of 8 in the range `[48..1048576]`. In earlier versions of the module the
+                minimum value was different. Changing this value does not affect
+                existing chunks.
+            duplicate_policy:
+                Policy for handling multiple samples with identical timestamps. Can be
+                one of:
+                    - 'block': An error will occur and the new value will be ignored.
+                    - 'first': Ignore the new value.
+                    - 'last': Override with the latest value.
+                    - 'min': Only override if the value is lower than the existing
+                      value.
+                    - 'max': Only override if the value is higher than the existing
+                      value.
+                    - 'sum': If a previous sample exists, add the new sample to it so
+                      that the updated value is equal to (previous + new). If no
+                      previous sample exists, set the updated value equal to the new
+                      value.
+            ignore_max_time_diff:
+                A non-negative integer value, in milliseconds, that sets an ignore
+                threshold for added timestamps. If the difference between the last
+                timestamp and the new timestamp is lower than this threshold, the new
+                entry is ignored. Only applicable if `duplicate_policy` is set to
+                `last`, and if `ignore_max_val_diff` is also set. Available since
+                RedisTimeSeries version 1.12.0.
+            ignore_max_val_diff:
+                A non-negative floating point value, that sets an ignore threshold for
+                added values. If the difference between the last value and the new value
+                is lower than this threshold, the new entry is ignored. Only applicable
+                if `duplicate_policy` is set to `last`, and if `ignore_max_time_diff` is
+                also set. Available since RedisTimeSeries version 1.12.0.
+        """
         params = [key]
         self._append_retention(params, retention_msecs)
         self._append_chunk_size(params, chunk_size)
-        self._append_duplicate_policy(params, ALTER_CMD, duplicate_policy)
+        self._append_duplicate_policy(params, duplicate_policy)
         self._append_labels(params, labels)
+        self._append_insertion_filters(
+            params, ignore_max_time_diff, ignore_max_val_diff
+        )
 
         return self.execute_command(ALTER_CMD, *params)
 
@@ -130,60 +176,104 @@ def add(
         labels: Optional[Dict[str, str]] = None,
         chunk_size: Optional[int] = None,
         duplicate_policy: Optional[str] = None,
+        ignore_max_time_diff: Optional[int] = None,
+        ignore_max_val_diff: Optional[Number] = None,
+        on_duplicate: Optional[str] = None,
     ):
         """
-        Append (or create and append) a new sample to a time series.
+        Append a sample to a time series. When the specified key does not exist, a new
+        time series is created.
 
-        Args:
+        For more information see https://redis.io/commands/ts.add/
 
-        key:
-            time-series key
-        timestamp:
-            Timestamp of the sample. * can be used for automatic timestamp (using the system clock).
-        value:
-            Numeric data value of the sample
-        retention_msecs:
-            Maximum retention period, compared to maximal existing timestamp (in milliseconds).
-            If None or 0 is passed then  the series is not trimmed at all.
-        uncompressed:
-            Changes data storage from compressed (by default) to uncompressed
-        labels:
-            Set of label-value pairs that represent metadata labels of the key.
-        chunk_size:
-            Memory size, in bytes, allocated for each data chunk.
-            Must be a multiple of 8 in the range [128 .. 1048576].
-        duplicate_policy:
-            Policy for handling multiple samples with identical timestamps.
-            Can be one of:
-            - 'block': an error will occur for any out of order sample.
-            - 'first': ignore the new value.
-            - 'last': override with latest value.
-            - 'min': only override if the value is lower than the existing value.
-            - 'max': only override if the value is higher than the existing value.
-            - 'sum': If a previous sample exists, add the new sample to it so that \
-            the updated value is equal to (previous + new). If no previous sample \
-            exists, set the updated value equal to the new value.
-
-        For more information: https://redis.io/commands/ts.add/
-        """  # noqa
+        Args:
+            key:
+                The time-series key.
+            timestamp:
+                Timestamp of the sample. `*` can be used for automatic timestamp (using
+                the system clock).
+            value:
+                Numeric data value of the sample.
+            retention_msecs:
+                Maximum age for samples, compared to the highest reported timestamp in
+                milliseconds. If `None` or `0` is passed, the series is not trimmed at
+                all.
+            uncompressed:
+                Changes data storage from compressed (default) to uncompressed.
+            labels:
+                A dictionary of label-value pairs that represent metadata labels of the
+                key.
+            chunk_size:
+                Memory size, in bytes, allocated for each data chunk. Must be a multiple
+                of 8 in the range `[48..1048576]`. In earlier versions of the module the
+                minimum value was different.
+            duplicate_policy:
+                Policy for handling multiple samples with identical timestamps. Can be
+                one of:
+                    - 'block': An error will occur and the new value will be ignored.
+                    - 'first': Ignore the new value.
+                    - 'last': Override with the latest value.
+                    - 'min': Only override if the value is lower than the existing
+                      value.
+                    - 'max': Only override if the value is higher than the existing
+                      value.
+                    - 'sum': If a previous sample exists, add the new sample to it so
+                      that the updated value is equal to (previous + new). If no
+                      previous sample exists, set the updated value equal to the new
+                      value.
+            ignore_max_time_diff:
+                A non-negative integer value, in milliseconds, that sets an ignore
+                threshold for added timestamps. If the difference between the last
+                timestamp and the new timestamp is lower than this threshold, the new
+                entry is ignored. Only applicable if `duplicate_policy` is set to
+                `last`, and if `ignore_max_val_diff` is also set. Available since
+                RedisTimeSeries version 1.12.0.
+            ignore_max_val_diff:
+                A non-negative floating point value, that sets an ignore threshold for
+                added values. If the difference between the last value and the new value
+                is lower than this threshold, the new entry is ignored. Only applicable
+                if `duplicate_policy` is set to `last`, and if `ignore_max_time_diff` is
+                also set. Available since RedisTimeSeries version 1.12.0.
+            on_duplicate:
+                Use a specific duplicate policy for the specified timestamp. Overrides
+                the duplicate policy set by `duplicate_policy`.
+        """
         params = [key, timestamp, value]
         self._append_retention(params, retention_msecs)
         self._append_uncompressed(params, uncompressed)
         self._append_chunk_size(params, chunk_size)
-        self._append_duplicate_policy(params, ADD_CMD, duplicate_policy)
+        self._append_duplicate_policy(params, duplicate_policy)
         self._append_labels(params, labels)
+        self._append_insertion_filters(
+            params, ignore_max_time_diff, ignore_max_val_diff
+        )
+        self._append_on_duplicate(params, on_duplicate)
 
         return self.execute_command(ADD_CMD, *params)
 
     def madd(self, ktv_tuples: List[Tuple[KeyT, Union[int, str], Number]]):
         """
-        Append (or create and append) a new `value` to series
-        `key` with `timestamp`.
-        Expects a list of `tuples` as (`key`,`timestamp`, `value`).
-        Return value is an array with timestamps of insertions.
+        Append new samples to one or more time series.
+
+        Each time series must already exist.
+
+        The method expects a list of tuples. Each tuple should contain three elements:
+        (`key`, `timestamp`, `value`). The `value` will be appended to the time series
+        identified by 'key', at the given 'timestamp'.
 
-        For more information: https://redis.io/commands/ts.madd/
-        """  # noqa
+        For more information see https://redis.io/commands/ts.madd/
+
+        Args:
+            ktv_tuples:
+                A list of tuples, where each tuple contains:
+                    - `key`: The key of the time series.
+                    - `timestamp`: The timestamp at which the value should be appended.
+                    - `value`: The value to append to the time series.
+
+        Returns:
+            A list that contains, for each sample, either the timestamp that was used,
+            or an error, if the sample could not be added.
+        """
         params = []
         for ktv in ktv_tuples:
             params.extend(ktv)
@@ -199,37 +289,86 @@ def incrby(
         uncompressed: Optional[bool] = False,
         labels: Optional[Dict[str, str]] = None,
         chunk_size: Optional[int] = None,
+        duplicate_policy: Optional[str] = None,
+        ignore_max_time_diff: Optional[int] = None,
+        ignore_max_val_diff: Optional[Number] = None,
     ):
         """
-        Increment (or create an time-series and increment) the latest sample's of a series.
-        This command can be used as a counter or gauge that automatically gets history as a time series.
+        Increment the latest sample's of a series. When the specified key does not
+        exist, a new time series is created.
 
-        Args:
+        This command can be used as a counter or gauge that automatically gets history
+        as a time series.
+
+        For more information see https://redis.io/commands/ts.incrby/
 
-        key:
-            time-series key
-        value:
-            Numeric data value of the sample
-        timestamp:
-            Timestamp of the sample. * can be used for automatic timestamp (using the system clock).
-        retention_msecs:
-            Maximum age for samples compared to last event time (in milliseconds).
-            If None or 0 is passed then  the series is not trimmed at all.
-        uncompressed:
-            Changes data storage from compressed (by default) to uncompressed
-        labels:
-            Set of label-value pairs that represent metadata labels of the key.
-        chunk_size:
-            Memory size, in bytes, allocated for each data chunk.
-
-        For more information: https://redis.io/commands/ts.incrby/
-        """  # noqa
+        Args:
+            key:
+                The time-series key.
+            value:
+                Numeric value to be added (addend).
+            timestamp:
+                Timestamp of the sample. `*` can be used for automatic timestamp (using
+                the system clock). `timestamp` must be equal to or higher than the
+                maximum existing timestamp in the series. When equal, the value of the
+                sample with the maximum existing timestamp is increased. If it is
+                higher, a new sample with a timestamp set to `timestamp` is created, and
+                its value is set to the value of the sample with the maximum existing
+                timestamp plus the addend.
+            retention_msecs:
+                Maximum age for samples, compared to the highest reported timestamp in
+                milliseconds. If `None` or `0` is passed, the series is not trimmed at
+                all.
+            uncompressed:
+                Changes data storage from compressed (default) to uncompressed.
+            labels:
+                A dictionary of label-value pairs that represent metadata labels of the
+                key.
+            chunk_size:
+                Memory size, in bytes, allocated for each data chunk. Must be a multiple
+                of 8 in the range `[48..1048576]`. In earlier versions of the module the
+                minimum value was different.
+            duplicate_policy:
+                Policy for handling multiple samples with identical timestamps. Can be
+                one of:
+                    - 'block': An error will occur and the new value will be ignored.
+                    - 'first': Ignore the new value.
+                    - 'last': Override with the latest value.
+                    - 'min': Only override if the value is lower than the existing
+                      value.
+                    - 'max': Only override if the value is higher than the existing
+                      value.
+                    - 'sum': If a previous sample exists, add the new sample to it so
+                      that the updated value is equal to (previous + new). If no
+                      previous sample exists, set the updated value equal to the new
+                      value.
+            ignore_max_time_diff:
+                A non-negative integer value, in milliseconds, that sets an ignore
+                threshold for added timestamps. If the difference between the last
+                timestamp and the new timestamp is lower than this threshold, the new
+                entry is ignored. Only applicable if `duplicate_policy` is set to
+                `last`, and if `ignore_max_val_diff` is also set. Available since
+                RedisTimeSeries version 1.12.0.
+            ignore_max_val_diff:
+                A non-negative floating point value, that sets an ignore threshold for
+                added values. If the difference between the last value and the new value
+                is lower than this threshold, the new entry is ignored. Only applicable
+                if `duplicate_policy` is set to `last`, and if `ignore_max_time_diff` is
+                also set. Available since RedisTimeSeries version 1.12.0.
+
+        Returns:
+            The timestamp of the sample that was modified or added.
+        """
         params = [key, value]
         self._append_timestamp(params, timestamp)
         self._append_retention(params, retention_msecs)
         self._append_uncompressed(params, uncompressed)
         self._append_chunk_size(params, chunk_size)
+        self._append_duplicate_policy(params, duplicate_policy)
         self._append_labels(params, labels)
+        self._append_insertion_filters(
+            params, ignore_max_time_diff, ignore_max_val_diff
+        )
 
         return self.execute_command(INCRBY_CMD, *params)
 
@@ -242,37 +381,86 @@ def decrby(
         uncompressed: Optional[bool] = False,
         labels: Optional[Dict[str, str]] = None,
         chunk_size: Optional[int] = None,
+        duplicate_policy: Optional[str] = None,
+        ignore_max_time_diff: Optional[int] = None,
+        ignore_max_val_diff: Optional[Number] = None,
     ):
         """
-        Decrement (or create an time-series and decrement) the latest sample's of a series.
-        This command can be used as a counter or gauge that automatically gets history as a time series.
+        Decrement the latest sample's of a series. When the specified key does not
+        exist, a new time series is created.
 
-        Args:
+        This command can be used as a counter or gauge that automatically gets history
+        as a time series.
 
-        key:
-            time-series key
-        value:
-            Numeric data value of the sample
-        timestamp:
-            Timestamp of the sample. * can be used for automatic timestamp (using the system clock).
-        retention_msecs:
-            Maximum age for samples compared to last event time (in milliseconds).
-            If None or 0 is passed then  the series is not trimmed at all.
-        uncompressed:
-            Changes data storage from compressed (by default) to uncompressed
-        labels:
-            Set of label-value pairs that represent metadata labels of the key.
-        chunk_size:
-            Memory size, in bytes, allocated for each data chunk.
-
-        For more information: https://redis.io/commands/ts.decrby/
-        """  # noqa
+        For more information see https://redis.io/commands/ts.decrby/
+
+        Args:
+            key:
+                The time-series key.
+            value:
+                Numeric value to subtract (subtrahend).
+            timestamp:
+                Timestamp of the sample. `*` can be used for automatic timestamp (using
+                the system clock). `timestamp` must be equal to or higher than the
+                maximum existing timestamp in the series. When equal, the value of the
+                sample with the maximum existing timestamp is decreased. If it is
+                higher, a new sample with a timestamp set to `timestamp` is created, and
+                its value is set to the value of the sample with the maximum existing
+                timestamp minus subtrahend.
+            retention_msecs:
+                Maximum age for samples, compared to the highest reported timestamp in
+                milliseconds. If `None` or `0` is passed, the series is not trimmed at
+                all.
+            uncompressed:
+                Changes data storage from compressed (default) to uncompressed.
+            labels:
+                A dictionary of label-value pairs that represent metadata labels of the
+                key.
+            chunk_size:
+                Memory size, in bytes, allocated for each data chunk. Must be a multiple
+                of 8 in the range `[48..1048576]`. In earlier versions of the module the
+                minimum value was different.
+            duplicate_policy:
+                Policy for handling multiple samples with identical timestamps. Can be
+                one of:
+                    - 'block': An error will occur and the new value will be ignored.
+                    - 'first': Ignore the new value.
+                    - 'last': Override with the latest value.
+                    - 'min': Only override if the value is lower than the existing
+                      value.
+                    - 'max': Only override if the value is higher than the existing
+                      value.
+                    - 'sum': If a previous sample exists, add the new sample to it so
+                      that the updated value is equal to (previous + new). If no
+                      previous sample exists, set the updated value equal to the new
+                      value.
+            ignore_max_time_diff:
+                A non-negative integer value, in milliseconds, that sets an ignore
+                threshold for added timestamps. If the difference between the last
+                timestamp and the new timestamp is lower than this threshold, the new
+                entry is ignored. Only applicable if `duplicate_policy` is set to
+                `last`, and if `ignore_max_val_diff` is also set. Available since
+                RedisTimeSeries version 1.12.0.
+            ignore_max_val_diff:
+                A non-negative floating point value, that sets an ignore threshold for
+                added values. If the difference between the last value and the new value
+                is lower than this threshold, the new entry is ignored. Only applicable
+                if `duplicate_policy` is set to `last`, and if `ignore_max_time_diff` is
+                also set. Available since RedisTimeSeries version 1.12.0.
+
+        Returns:
+            The timestamp of the sample that was modified or added.
+        """
         params = [key, value]
         self._append_timestamp(params, timestamp)
         self._append_retention(params, retention_msecs)
         self._append_uncompressed(params, uncompressed)
         self._append_chunk_size(params, chunk_size)
+        self._append_duplicate_policy(params, duplicate_policy)
         self._append_labels(params, labels)
+        self._append_insertion_filters(
+            params, ignore_max_time_diff, ignore_max_val_diff
+        )
 
         return self.execute_command(DECRBY_CMD, *params)
 
@@ -280,17 +468,22 @@ def delete(self, key: KeyT, from_time: int, to_time: int):
         """
         Delete all samples between two timestamps for a given time series.
 
-        Args:
+        The given timestamp interval is closed (inclusive), meaning that samples whose
+        timestamp equals `from_time` or `to_time` are also deleted.
 
-        key:
-            time-series key.
-        from_time:
-            Start timestamp for the range deletion.
-        to_time:
-            End timestamp for the range deletion.
+        For more information see https://redis.io/commands/ts.del/
 
-        For more information: https://redis.io/commands/ts.del/
-        """  # noqa
+        Args:
+            key:
+                The time-series key.
+            from_time:
+                Start timestamp for the range deletion.
+            to_time:
+                End timestamp for the range deletion.
+
+        Returns:
+            The number of samples deleted.
+        """
         return self.execute_command(DEL_CMD, key, from_time, to_time)
 
     def createrule(
@@ -304,24 +497,23 @@ def createrule(
         """
         Create a compaction rule from values added to `source_key` into `dest_key`.
 
-        Args:
+        For more information see https://redis.io/commands/ts.createrule/
 
-        source_key:
-            Key name for source time series
-        dest_key:
-            Key name for destination (compacted) time series
-        aggregation_type:
-            Aggregation type: One of the following:
-            [`avg`, `sum`, `min`, `max`, `range`, `count`, `first`, `last`, `std.p`,
-            `std.s`, `var.p`, `var.s`, `twa`]
-        bucket_size_msec:
-            Duration of each bucket, in milliseconds
-        align_timestamp:
-            Assure that there is a bucket that starts at exactly align_timestamp and
-            align all other buckets accordingly.
-
-        For more information: https://redis.io/commands/ts.createrule/
-        """  # noqa
+        Args:
+            source_key:
+                Key name for source time series.
+            dest_key:
+                Key name for destination (compacted) time series.
+            aggregation_type:
+                Aggregation type: One of the following:
+                [`avg`, `sum`, `min`, `max`, `range`, `count`, `first`, `last`, `std.p`,
+                `std.s`, `var.p`, `var.s`, `twa`]
+            bucket_size_msec:
+                Duration of each bucket, in milliseconds.
+            align_timestamp:
+                Assure that there is a bucket that starts at exactly align_timestamp and
+                align all other buckets accordingly.
+        """
         params = [source_key, dest_key]
         self._append_aggregation(params, aggregation_type, bucket_size_msec)
         if align_timestamp is not None:
@@ -331,10 +523,10 @@ def createrule(
 
     def deleterule(self, source_key: KeyT, dest_key: KeyT):
         """
-        Delete a compaction rule from `source_key` to `dest_key`..
+        Delete a compaction rule from `source_key` to `dest_key`.
 
-        For more information: https://redis.io/commands/ts.deleterule/
-        """  # noqa
+        For more information see https://redis.io/commands/ts.deleterule/
+        """
         return self.execute_command(DELETERULE_CMD, source_key, dest_key)
 
     def __range_params(
@@ -383,42 +575,46 @@ def range(
         empty: Optional[bool] = False,
     ):
         """
-        Query a range in forward direction for a specific time-serie.
+        Query a range in forward direction for a specific time-series.
 
-        Args:
+        For more information see https://redis.io/commands/ts.range/
 
-        key:
-            Key name for timeseries.
-        from_time:
-            Start timestamp for the range query. - can be used to express the minimum possible timestamp (0).
-        to_time:
-            End timestamp for range query, + can be used to express the maximum possible timestamp.
-        count:
-            Limits the number of returned samples.
-        aggregation_type:
-            Optional aggregation type. Can be one of [`avg`, `sum`, `min`, `max`,
-            `range`, `count`, `first`, `last`, `std.p`, `std.s`, `var.p`, `var.s`, `twa`]
-        bucket_size_msec:
-            Time bucket for aggregation in milliseconds.
-        filter_by_ts:
-            List of timestamps to filter the result by specific timestamps.
-        filter_by_min_value:
-            Filter result by minimum value (must mention also filter by_max_value).
-        filter_by_max_value:
-            Filter result by maximum value (must mention also filter by_min_value).
-        align:
-            Timestamp for alignment control for aggregation.
-        latest:
-            Used when a time series is a compaction, reports the compacted value of the
-            latest possibly partial bucket
-        bucket_timestamp:
-            Controls how bucket timestamps are reported. Can be one of [`-`, `low`, `+`,
-            `high`, `~`, `mid`].
-        empty:
-            Reports aggregations for empty buckets.
-
-        For more information: https://redis.io/commands/ts.range/
-        """  # noqa
+        Args:
+            key:
+                Key name for timeseries.
+            from_time:
+                Start timestamp for the range query. `-` can be used to express the
+                minimum possible timestamp (0).
+            to_time:
+                End timestamp for range query, `+` can be used to express the maximum
+                possible timestamp.
+            count:
+                Limits the number of returned samples.
+            aggregation_type:
+                Optional aggregation type. Can be one of [`avg`, `sum`, `min`, `max`,
+                `range`, `count`, `first`, `last`, `std.p`, `std.s`, `var.p`, `var.s`,
+                `twa`]
+            bucket_size_msec:
+                Time bucket for aggregation in milliseconds.
+            filter_by_ts:
+                List of timestamps to filter the result by specific timestamps.
+            filter_by_min_value:
+                Filter result by minimum value (must mention also
+                `filter by_max_value`).
+            filter_by_max_value:
+                Filter result by maximum value (must mention also
+                `filter by_min_value`).
+            align:
+                Timestamp for alignment control for aggregation.
+            latest:
+                Used when a time series is a compaction, reports the compacted value of
+                the latest possibly partial bucket.
+            bucket_timestamp:
+                Controls how bucket timestamps are reported. Can be one of [`-`, `low`,
+                `+`, `high`, `~`, `mid`].
+            empty:
+                Reports aggregations for empty buckets.
+        """
         params = self.__range_params(
             key,
             from_time,
@@ -457,40 +653,44 @@ def revrange(
 
         **Note**: This command is only available since RedisTimeSeries >= v1.4
 
-        Args:
+        For more information see https://redis.io/commands/ts.revrange/
 
-        key:
-            Key name for timeseries.
-        from_time:
-            Start timestamp for the range query. - can be used to express the minimum possible timestamp (0).
-        to_time:
-            End timestamp for range query, + can be used to express the maximum possible timestamp.
-        count:
-            Limits the number of returned samples.
-        aggregation_type:
-            Optional aggregation type. Can be one of [`avg`, `sum`, `min`, `max`,
-            `range`, `count`, `first`, `last`, `std.p`, `std.s`, `var.p`, `var.s`, `twa`]
-        bucket_size_msec:
-            Time bucket for aggregation in milliseconds.
-        filter_by_ts:
-            List of timestamps to filter the result by specific timestamps.
-        filter_by_min_value:
-            Filter result by minimum value (must mention also filter_by_max_value).
-        filter_by_max_value:
-            Filter result by maximum value (must mention also filter_by_min_value).
-        align:
-            Timestamp for alignment control for aggregation.
-        latest:
-            Used when a time series is a compaction, reports the compacted value of the
-            latest possibly partial bucket
-        bucket_timestamp:
-            Controls how bucket timestamps are reported. Can be one of [`-`, `low`, `+`,
-            `high`, `~`, `mid`].
-        empty:
-            Reports aggregations for empty buckets.
-
-        For more information: https://redis.io/commands/ts.revrange/
-        """  # noqa
+        Args:
+            key:
+                Key name for timeseries.
+            from_time:
+                Start timestamp for the range query. `-` can be used to express the
+                minimum possible timestamp (0).
+            to_time:
+                End timestamp for range query, `+` can be used to express the maximum
+                possible timestamp.
+            count:
+                Limits the number of returned samples.
+            aggregation_type:
+                Optional aggregation type. Can be one of [`avg`, `sum`, `min`, `max`,
+                `range`, `count`, `first`, `last`, `std.p`, `std.s`, `var.p`, `var.s`,
+                `twa`]
+            bucket_size_msec:
+                Time bucket for aggregation in milliseconds.
+            filter_by_ts:
+                List of timestamps to filter the result by specific timestamps.
+            filter_by_min_value:
+                Filter result by minimum value (must mention also
+                `filter_by_max_value`).
+            filter_by_max_value:
+                Filter result by maximum value (must mention also
+                `filter_by_min_value`).
+            align:
+                Timestamp for alignment control for aggregation.
+            latest:
+                Used when a time series is a compaction, reports the compacted value of
+                the latest possibly partial bucket.
+            bucket_timestamp:
+                Controls how bucket timestamps are reported. Can be one of [`-`, `low`,
+                `+`, `high`, `~`, `mid`].
+            empty:
+                Reports aggregations for empty buckets.
+        """
         params = self.__range_params(
             key,
             from_time,
@@ -567,49 +767,55 @@ def mrange(
         """
         Query a range across multiple time-series by filters in forward direction.
 
-        Args:
+        For more information see https://redis.io/commands/ts.mrange/
 
-        from_time:
-            Start timestamp for the range query. `-` can be used to express the minimum possible timestamp (0).
-        to_time:
-            End timestamp for range query, `+` can be used to express the maximum possible timestamp.
-        filters:
-            filter to match the time-series labels.
-        count:
-            Limits the number of returned samples.
-        aggregation_type:
-            Optional aggregation type. Can be one of [`avg`, `sum`, `min`, `max`,
-            `range`, `count`, `first`, `last`, `std.p`, `std.s`, `var.p`, `var.s`, `twa`]
-        bucket_size_msec:
-            Time bucket for aggregation in milliseconds.
-        with_labels:
-            Include in the reply all label-value pairs representing metadata labels of the time series.
-        filter_by_ts:
-            List of timestamps to filter the result by specific timestamps.
-        filter_by_min_value:
-            Filter result by minimum value (must mention also filter_by_max_value).
-        filter_by_max_value:
-            Filter result by maximum value (must mention also filter_by_min_value).
-        groupby:
-            Grouping by fields the results (must mention also reduce).
-        reduce:
-            Applying reducer functions on each group. Can be one of [`avg` `sum`, `min`,
-            `max`, `range`, `count`, `std.p`, `std.s`, `var.p`, `var.s`].
-        select_labels:
-            Include in the reply only a subset of the key-value pair labels of a series.
-        align:
-            Timestamp for alignment control for aggregation.
-        latest:
-            Used when a time series is a compaction, reports the compacted
-            value of the latest possibly partial bucket
-        bucket_timestamp:
-            Controls how bucket timestamps are reported. Can be one of [`-`, `low`, `+`,
-            `high`, `~`, `mid`].
-        empty:
-            Reports aggregations for empty buckets.
-
-        For more information: https://redis.io/commands/ts.mrange/
-        """  # noqa
+        Args:
+            from_time:
+                Start timestamp for the range query. `-` can be used to express the
+                minimum possible timestamp (0).
+            to_time:
+                End timestamp for range query, `+` can be used to express the maximum
+                possible timestamp.
+            filters:
+                Filter to match the time-series labels.
+            count:
+                Limits the number of returned samples.
+            aggregation_type:
+                Optional aggregation type. Can be one of [`avg`, `sum`, `min`, `max`,
+                `range`, `count`, `first`, `last`, `std.p`, `std.s`, `var.p`, `var.s`,
+                `twa`]
+            bucket_size_msec:
+                Time bucket for aggregation in milliseconds.
+            with_labels:
+                Include in the reply all label-value pairs representing metadata labels
+                of the time series.
+            filter_by_ts:
+                List of timestamps to filter the result by specific timestamps.
+            filter_by_min_value:
+                Filter result by minimum value (must mention also
+                `filter_by_max_value`).
+            filter_by_max_value:
+                Filter result by maximum value (must mention also
+                `filter_by_min_value`).
+            groupby:
+                Grouping by fields the results (must mention also `reduce`).
+            reduce:
+                Applying reducer functions on each group. Can be one of [`avg` `sum`,
+                `min`, `max`, `range`, `count`, `std.p`, `std.s`, `var.p`, `var.s`].
+            select_labels:
+                Include in the reply only a subset of the key-value pair labels of a
+                series.
+            align:
+                Timestamp for alignment control for aggregation.
+            latest:
+                Used when a time series is a compaction, reports the compacted value of
+                the latest possibly partial bucket.
+            bucket_timestamp:
+                Controls how bucket timestamps are reported. Can be one of [`-`, `low`,
+                `+`, `high`, `~`, `mid`].
+            empty:
+                Reports aggregations for empty buckets.
+        """
         params = self.__mrange_params(
             aggregation_type,
             bucket_size_msec,
@@ -655,49 +861,55 @@ def mrevrange(
         """
         Query a range across multiple time-series by filters in reverse direction.
 
-        Args:
+        For more information see https://redis.io/commands/ts.mrevrange/
 
-        from_time:
-            Start timestamp for the range query. - can be used to express the minimum possible timestamp (0).
-        to_time:
-            End timestamp for range query, + can be used to express the maximum possible timestamp.
-        filters:
-            Filter to match the time-series labels.
-        count:
-            Limits the number of returned samples.
-        aggregation_type:
-            Optional aggregation type. Can be one of [`avg`, `sum`, `min`, `max`,
-            `range`, `count`, `first`, `last`, `std.p`, `std.s`, `var.p`, `var.s`, `twa`]
-        bucket_size_msec:
-            Time bucket for aggregation in milliseconds.
-        with_labels:
-            Include in the reply all label-value pairs representing metadata labels of the time series.
-        filter_by_ts:
-            List of timestamps to filter the result by specific timestamps.
-        filter_by_min_value:
-            Filter result by minimum value (must mention also filter_by_max_value).
-        filter_by_max_value:
-            Filter result by maximum value (must mention also filter_by_min_value).
-        groupby:
-            Grouping by fields the results (must mention also reduce).
-        reduce:
-            Applying reducer functions on each group. Can be one of [`avg` `sum`, `min`,
-            `max`, `range`, `count`, `std.p`, `std.s`, `var.p`, `var.s`].
-        select_labels:
-            Include in the reply only a subset of the key-value pair labels of a series.
-        align:
-            Timestamp for alignment control for aggregation.
-        latest:
-            Used when a time series is a compaction, reports the compacted
-            value of the latest possibly partial bucket
-        bucket_timestamp:
-            Controls how bucket timestamps are reported. Can be one of [`-`, `low`, `+`,
-            `high`, `~`, `mid`].
-        empty:
-            Reports aggregations for empty buckets.
-
-        For more information: https://redis.io/commands/ts.mrevrange/
-        """  # noqa
+        Args:
+            from_time:
+                Start timestamp for the range query. '-' can be used to express the
+                minimum possible timestamp (0).
+            to_time:
+                End timestamp for range query, '+' can be used to express the maximum
+                possible timestamp.
+            filters:
+                Filter to match the time-series labels.
+            count:
+                Limits the number of returned samples.
+            aggregation_type:
+                Optional aggregation type. Can be one of [`avg`, `sum`, `min`, `max`,
+                `range`, `count`, `first`, `last`, `std.p`, `std.s`, `var.p`, `var.s`,
+                `twa`].
+            bucket_size_msec:
+                Time bucket for aggregation in milliseconds.
+            with_labels:
+                Include in the reply all label-value pairs representing metadata labels
+                of the time series.
+            filter_by_ts:
+                List of timestamps to filter the result by specific timestamps.
+            filter_by_min_value:
+                Filter result by minimum value (must mention also
+                `filter_by_max_value`).
+            filter_by_max_value:
+                Filter result by maximum value (must mention also
+                `filter_by_min_value`).
+            groupby:
+                Grouping by fields the results (must mention also `reduce`).
+            reduce:
+                Applying reducer functions on each group. Can be one of [`avg` `sum`,
+                `min`, `max`, `range`, `count`, `std.p`, `std.s`, `var.p`, `var.s`].
+            select_labels:
+                Include in the reply only a subset of the key-value pair labels of a
+                series.
+            align:
+                Timestamp for alignment control for aggregation.
+            latest:
+                Used when a time series is a compaction, reports the compacted value of
+                the latest possibly partial bucket.
+            bucket_timestamp:
+                Controls how bucket timestamps are reported. Can be one of [`-`, `low`,
+                `+`, `high`, `~`, `mid`].
+            empty:
+                Reports aggregations for empty buckets.
+        """
         params = self.__mrange_params(
             aggregation_type,
             bucket_size_msec,
@@ -721,13 +933,16 @@ def mrevrange(
         return self.execute_command(MREVRANGE_CMD, *params)
 
     def get(self, key: KeyT, latest: Optional[bool] = False):
-        """# noqa
+        """
         Get the last sample of `key`.
-        `latest` used when a time series is a compaction, reports the compacted
-        value of the latest (possibly partial) bucket
 
-        For more information: https://redis.io/commands/ts.get/
-        """  # noqa
+        For more information see https://redis.io/commands/ts.get/
+
+        Args:
+            latest:
+                Used when a time series is a compaction, reports the compacted value of
+                the latest (possibly partial) bucket.
+        """
         params = [key]
         self._append_latest(params, latest)
         return self.execute_command(GET_CMD, *params, keys=[key])
@@ -739,24 +954,24 @@ def mget(
         select_labels: Optional[List[str]] = None,
         latest: Optional[bool] = False,
     ):
-        """# noqa
+        """
         Get the last samples matching the specific `filter`.
 
-        Args:
+        For more information see https://redis.io/commands/ts.mget/
 
-        filters:
-            Filter to match the time-series labels.
-        with_labels:
-            Include in the reply all label-value pairs representing metadata
-            labels of the time series.
-        select_labels:
-            Include in the reply only a subset of the key-value pair labels of a series.
-        latest:
-            Used when a time series is a compaction, reports the compacted
-            value of the latest possibly partial bucket
-
-        For more information: https://redis.io/commands/ts.mget/
-        """  # noqa
+        Args:
+            filters:
+                Filter to match the time-series labels.
+            with_labels:
+                Include in the reply all label-value pairs representing metadata labels
+                of the time series.
+            select_labels:
+                Include in the reply only a subset of the key-value pair labels o the
+                time series.
+            latest:
+                Used when a time series is a compaction, reports the compacted value of
+                the latest possibly partial bucket.
+        """
         params = []
         self._append_latest(params, latest)
         self._append_with_labels(params, with_labels, select_labels)
@@ -765,26 +980,26 @@ def mget(
         return self.execute_command(MGET_CMD, *params)
 
     def info(self, key: KeyT):
-        """# noqa
+        """
         Get information of `key`.
 
-        For more information: https://redis.io/commands/ts.info/
-        """  # noqa
+        For more information see https://redis.io/commands/ts.info/
+        """
         return self.execute_command(INFO_CMD, key, keys=[key])
 
     def queryindex(self, filters: List[str]):
-        """# noqa
+        """
         Get all time series keys matching the `filter` list.
 
-        For more information: https://redis.io/commands/ts.queryindex/
-        """  # noq
+        For more information see https://redis.io/commands/ts.queryindex/
+        """
         return self.execute_command(QUERYINDEX_CMD, *filters)
 
     @staticmethod
     def _append_uncompressed(params: List[str], uncompressed: Optional[bool]):
         """Append UNCOMPRESSED tag to params."""
         if uncompressed:
-            params.extend(["UNCOMPRESSED"])
+            params.extend(["ENCODING", "UNCOMPRESSED"])
 
     @staticmethod
     def _append_with_labels(
@@ -860,17 +1075,16 @@ def _append_chunk_size(params: List[str], chunk_size: Optional[int]):
             params.extend(["CHUNK_SIZE", chunk_size])
 
     @staticmethod
-    def _append_duplicate_policy(
-        params: List[str], command: Optional[str], duplicate_policy: Optional[str]
-    ):
-        """Append DUPLICATE_POLICY property to params on CREATE
-        and ON_DUPLICATE on ADD.
-        """
+    def _append_duplicate_policy(params: List[str], duplicate_policy: Optional[str]):
+        """Append DUPLICATE_POLICY property to params."""
         if duplicate_policy is not None:
-            if command == "TS.ADD":
-                params.extend(["ON_DUPLICATE", duplicate_policy])
-            else:
-                params.extend(["DUPLICATE_POLICY", duplicate_policy])
+            params.extend(["DUPLICATE_POLICY", duplicate_policy])
+
+    @staticmethod
+    def _append_on_duplicate(params: List[str], on_duplicate: Optional[str]):
+        """Append ON_DUPLICATE property to params."""
+        if on_duplicate is not None:
+            params.extend(["ON_DUPLICATE", on_duplicate])
 
     @staticmethod
     def _append_filer_by_ts(params: List[str], ts_list: Optional[List[int]]):
@@ -903,3 +1117,20 @@ def _append_empty(params: List[str], empty: Optional[bool]):
         """Append EMPTY property to params."""
         if empty:
             params.append("EMPTY")
+
+    @staticmethod
+    def _append_insertion_filters(
+        params: List[str],
+        ignore_max_time_diff: Optional[int] = None,
+        ignore_max_val_diff: Optional[Number] = None,
+    ):
+        """Append insertion filters to params."""
+        if (ignore_max_time_diff is None) != (ignore_max_val_diff is None):
+            raise ValueError(
+                "Both ignore_max_time_diff and ignore_max_val_diff must be set."
+            )
+
+        if ignore_max_time_diff is not None and ignore_max_val_diff is not None:
+            params.extend(
+                ["IGNORE", str(ignore_max_time_diff), str(ignore_max_val_diff)]
+            )
diff --git a/tests/conftest.py b/tests/conftest.py
index 9263c4353d..6df6875845 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -157,8 +157,12 @@ def pytest_sessionstart(session):
     session.config.REDIS_INFO = REDIS_INFO
 
     # module info
+    stack_url = redis_url
+    if stack_url == default_redis_url:
+        stack_url = default_redismod_url
     try:
-        REDIS_INFO["modules"] = info["modules"]
+        stack_info = _get_info(stack_url)
+        REDIS_INFO["modules"] = stack_info["modules"]
     except (KeyError, redis.exceptions.ConnectionError):
         pass
 
diff --git a/tests/test_asyncio/test_timeseries.py b/tests/test_asyncio/test_timeseries.py
index 0c78ce0941..c93af1ea5b 100644
--- a/tests/test_asyncio/test_timeseries.py
+++ b/tests/test_asyncio/test_timeseries.py
@@ -75,7 +75,7 @@ async def test_alter(decoded_r: redis.Redis):
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
-async def test_alter_diplicate_policy(decoded_r: redis.Redis):
+async def test_alter_duplicate_policy(decoded_r: redis.Redis):
     assert await decoded_r.ts().create(1)
     info = await decoded_r.ts().info(1)
     assert_resp_response(
@@ -113,42 +113,44 @@ async def test_add(decoded_r: redis.Redis):
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
-async def test_add_duplicate_policy(r: redis.Redis):
+async def test_add_duplicate_policy(decoded_r: redis.Redis):
     # Test for duplicate policy BLOCK
-    assert 1 == await r.ts().add("time-serie-add-ooo-block", 1, 5.0)
+    assert 1 == await decoded_r.ts().add("time-serie-add-ooo-block", 1, 5.0)
     with pytest.raises(Exception):
-        await r.ts().add("time-serie-add-ooo-block", 1, 5.0, duplicate_policy="block")
+        await decoded_r.ts().add(
+            "time-serie-add-ooo-block", 1, 5.0, on_duplicate="block"
+        )
 
     # Test for duplicate policy LAST
-    assert 1 == await r.ts().add("time-serie-add-ooo-last", 1, 5.0)
-    assert 1 == await r.ts().add(
-        "time-serie-add-ooo-last", 1, 10.0, duplicate_policy="last"
+    assert 1 == await decoded_r.ts().add("time-serie-add-ooo-last", 1, 5.0)
+    assert 1 == await decoded_r.ts().add(
+        "time-serie-add-ooo-last", 1, 10.0, on_duplicate="last"
     )
-    res = await r.ts().get("time-serie-add-ooo-last")
+    res = await decoded_r.ts().get("time-serie-add-ooo-last")
     assert 10.0 == res[1]
 
     # Test for duplicate policy FIRST
-    assert 1 == await r.ts().add("time-serie-add-ooo-first", 1, 5.0)
-    assert 1 == await r.ts().add(
-        "time-serie-add-ooo-first", 1, 10.0, duplicate_policy="first"
+    assert 1 == await decoded_r.ts().add("time-serie-add-ooo-first", 1, 5.0)
+    assert 1 == await decoded_r.ts().add(
+        "time-serie-add-ooo-first", 1, 10.0, on_duplicate="first"
     )
-    res = await r.ts().get("time-serie-add-ooo-first")
+    res = await decoded_r.ts().get("time-serie-add-ooo-first")
     assert 5.0 == res[1]
 
     # Test for duplicate policy MAX
-    assert 1 == await r.ts().add("time-serie-add-ooo-max", 1, 5.0)
-    assert 1 == await r.ts().add(
-        "time-serie-add-ooo-max", 1, 10.0, duplicate_policy="max"
+    assert 1 == await decoded_r.ts().add("time-serie-add-ooo-max", 1, 5.0)
+    assert 1 == await decoded_r.ts().add(
+        "time-serie-add-ooo-max", 1, 10.0, on_duplicate="max"
     )
-    res = await r.ts().get("time-serie-add-ooo-max")
+    res = await decoded_r.ts().get("time-serie-add-ooo-max")
     assert 10.0 == res[1]
 
     # Test for duplicate policy MIN
-    assert 1 == await r.ts().add("time-serie-add-ooo-min", 1, 5.0)
-    assert 1 == await r.ts().add(
-        "time-serie-add-ooo-min", 1, 10.0, duplicate_policy="min"
+    assert 1 == await decoded_r.ts().add("time-serie-add-ooo-min", 1, 5.0)
+    assert 1 == await decoded_r.ts().add(
+        "time-serie-add-ooo-min", 1, 10.0, on_duplicate="min"
     )
-    res = await r.ts().get("time-serie-add-ooo-min")
+    res = await decoded_r.ts().get("time-serie-add-ooo-min")
     assert 5.0 == res[1]
 
 
@@ -214,7 +216,7 @@ async def test_create_and_delete_rule(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
-@skip_ifmodversion_lt("99.99.99", "timeseries")
+@skip_ifmodversion_lt("1.10.0", "timeseries")
 async def test_del_range(decoded_r: redis.Redis):
     try:
         await decoded_r.ts().delete("test", 0, 100)
@@ -248,7 +250,7 @@ async def test_range(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
-@skip_ifmodversion_lt("99.99.99", "timeseries")
+@skip_ifmodversion_lt("1.10.0", "timeseries")
 async def test_range_advanced(decoded_r: redis.Redis):
     for i in range(100):
         await decoded_r.ts().add(1, i, i % 7)
@@ -279,7 +281,7 @@ async def test_range_advanced(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
-@skip_ifmodversion_lt("99.99.99", "timeseries")
+@skip_ifmodversion_lt("1.10.0", "timeseries")
 async def test_rev_range(decoded_r: redis.Redis):
     for i in range(100):
         await decoded_r.ts().add(1, i, i % 7)
@@ -379,7 +381,7 @@ async def test_multi_range(decoded_r: redis.Redis):
 
 @pytest.mark.onlynoncluster
 @pytest.mark.redismod
-@skip_ifmodversion_lt("99.99.99", "timeseries")
+@skip_ifmodversion_lt("1.10.0", "timeseries")
 async def test_multi_range_advanced(decoded_r: redis.Redis):
     await decoded_r.ts().create(1, labels={"Test": "This", "team": "ny"})
     await decoded_r.ts().create(
@@ -497,7 +499,7 @@ async def test_multi_range_advanced(decoded_r: redis.Redis):
 
 @pytest.mark.onlynoncluster
 @pytest.mark.redismod
-@skip_ifmodversion_lt("99.99.99", "timeseries")
+@skip_ifmodversion_lt("1.10.0", "timeseries")
 async def test_multi_reverse_range(decoded_r: redis.Redis):
     await decoded_r.ts().create(1, labels={"Test": "This", "team": "ny"})
     await decoded_r.ts().create(
@@ -752,9 +754,117 @@ async def test_query_index(decoded_r: redis.Redis):
 async def test_uncompressed(decoded_r: redis.Redis):
     await decoded_r.ts().create("compressed")
     await decoded_r.ts().create("uncompressed", uncompressed=True)
+    for i in range(1000):
+        await decoded_r.ts().add("compressed", i, i)
+        await decoded_r.ts().add("uncompressed", i, i)
     compressed_info = await decoded_r.ts().info("compressed")
     uncompressed_info = await decoded_r.ts().info("uncompressed")
     if is_resp2_connection(decoded_r):
         assert compressed_info.memory_usage != uncompressed_info.memory_usage
     else:
         assert compressed_info["memoryUsage"] != uncompressed_info["memoryUsage"]
+
+
+@skip_ifmodversion_lt("1.12.0", "timeseries")
+async def test_create_with_insertion_filters(decoded_r: redis.Redis):
+    await decoded_r.ts().create(
+        "time-series-1",
+        duplicate_policy="last",
+        ignore_max_time_diff=5,
+        ignore_max_val_diff=10.0,
+    )
+    assert 1000 == await decoded_r.ts().add("time-series-1", 1000, 1.0)
+    assert 1010 == await decoded_r.ts().add("time-series-1", 1010, 11.0)
+    assert 1010 == await decoded_r.ts().add("time-series-1", 1013, 10.0)
+    assert 1020 == await decoded_r.ts().add("time-series-1", 1020, 11.5)
+    assert 1021 == await decoded_r.ts().add("time-series-1", 1021, 22.0)
+
+    data_points = await decoded_r.ts().range("time-series-1", "-", "+")
+    expected_points = [(1000, 1.0), (1010, 11.0), (1020, 11.5), (1021, 22.0)]
+    assert expected_points == data_points
+
+
+@skip_ifmodversion_lt("1.12.0", "timeseries")
+async def test_alter_with_insertion_filters(decoded_r: redis.Redis):
+    assert 1000 == await decoded_r.ts().add("time-series-1", 1000, 1.0)
+    assert 1010 == await decoded_r.ts().add("time-series-1", 1010, 11.0)
+    assert 1013 == await decoded_r.ts().add("time-series-1", 1013, 10.0)
+
+    await decoded_r.ts().alter(
+        "time-series-1",
+        duplicate_policy="last",
+        ignore_max_time_diff=5,
+        ignore_max_val_diff=10.0,
+    )
+
+    assert 1013 == await decoded_r.ts().add("time-series-1", 1015, 11.5)
+
+    data_points = await decoded_r.ts().range("time-series-1", "-", "+")
+    expected_points = [(1000, 1.0), (1010, 11.0), (1013, 10.0)]
+    assert expected_points == data_points
+
+
+@skip_ifmodversion_lt("1.12.0", "timeseries")
+async def test_add_with_insertion_filters(decoded_r: redis.Redis):
+    assert 1000 == await decoded_r.ts().add(
+        "time-series-1",
+        1000,
+        1.0,
+        duplicate_policy="last",
+        ignore_max_time_diff=5,
+        ignore_max_val_diff=10.0,
+    )
+
+    assert 1000 == await decoded_r.ts().add("time-series-1", 1004, 3.0)
+
+    data_points = await decoded_r.ts().range("time-series-1", "-", "+")
+    expected_points = [(1000, 1.0)]
+    assert expected_points == data_points
+
+
+@skip_ifmodversion_lt("1.12.0", "timeseries")
+async def test_incrby_with_insertion_filters(decoded_r: redis.Redis):
+    assert 1000 == await decoded_r.ts().incrby(
+        "time-series-1",
+        1.0,
+        timestamp=1000,
+        duplicate_policy="last",
+        ignore_max_time_diff=5,
+        ignore_max_val_diff=10.0,
+    )
+
+    assert 1000 == await decoded_r.ts().incrby("time-series-1", 3.0, timestamp=1000)
+
+    data_points = await decoded_r.ts().range("time-series-1", "-", "+")
+    expected_points = [(1000, 1.0)]
+    assert expected_points == data_points
+
+    assert 1000 == await decoded_r.ts().incrby("time-series-1", 10.1, timestamp=1000)
+
+    data_points = await decoded_r.ts().range("time-series-1", "-", "+")
+    expected_points = [(1000, 11.1)]
+    assert expected_points == data_points
+
+
+@skip_ifmodversion_lt("1.12.0", "timeseries")
+async def test_decrby_with_insertion_filters(decoded_r: redis.Redis):
+    assert 1000 == await decoded_r.ts().decrby(
+        "time-series-1",
+        1.0,
+        timestamp=1000,
+        duplicate_policy="last",
+        ignore_max_time_diff=5,
+        ignore_max_val_diff=10.0,
+    )
+
+    assert 1000 == await decoded_r.ts().decrby("time-series-1", 3.0, timestamp=1000)
+
+    data_points = await decoded_r.ts().range("time-series-1", "-", "+")
+    expected_points = [(1000, -1.0)]
+    assert expected_points == data_points
+
+    assert 1000 == await decoded_r.ts().decrby("time-series-1", 10.1, timestamp=1000)
+
+    data_points = await decoded_r.ts().range("time-series-1", "-", "+")
+    expected_points = [(1000, -11.1)]
+    assert expected_points == data_points
diff --git a/tests/test_timeseries.py b/tests/test_timeseries.py
index 5318818e79..5647bd45c6 100644
--- a/tests/test_timeseries.py
+++ b/tests/test_timeseries.py
@@ -84,7 +84,7 @@ def test_alter(client):
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
-def test_alter_diplicate_policy(client):
+def test_alter_duplicate_policy(client):
     assert client.ts().create(1)
     info = client.ts().info(1)
     assert_resp_response(
@@ -122,38 +122,32 @@ def test_add(client):
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
-def test_add_duplicate_policy(client):
+def test_add_on_duplicate(client):
     # Test for duplicate policy BLOCK
     assert 1 == client.ts().add("time-serie-add-ooo-block", 1, 5.0)
     with pytest.raises(Exception):
-        client.ts().add("time-serie-add-ooo-block", 1, 5.0, duplicate_policy="block")
+        client.ts().add("time-serie-add-ooo-block", 1, 5.0, on_duplicate="block")
 
     # Test for duplicate policy LAST
     assert 1 == client.ts().add("time-serie-add-ooo-last", 1, 5.0)
-    assert 1 == client.ts().add(
-        "time-serie-add-ooo-last", 1, 10.0, duplicate_policy="last"
-    )
+    assert 1 == client.ts().add("time-serie-add-ooo-last", 1, 10.0, on_duplicate="last")
     assert 10.0 == client.ts().get("time-serie-add-ooo-last")[1]
 
     # Test for duplicate policy FIRST
     assert 1 == client.ts().add("time-serie-add-ooo-first", 1, 5.0)
     assert 1 == client.ts().add(
-        "time-serie-add-ooo-first", 1, 10.0, duplicate_policy="first"
+        "time-serie-add-ooo-first", 1, 10.0, on_duplicate="first"
     )
     assert 5.0 == client.ts().get("time-serie-add-ooo-first")[1]
 
     # Test for duplicate policy MAX
     assert 1 == client.ts().add("time-serie-add-ooo-max", 1, 5.0)
-    assert 1 == client.ts().add(
-        "time-serie-add-ooo-max", 1, 10.0, duplicate_policy="max"
-    )
+    assert 1 == client.ts().add("time-serie-add-ooo-max", 1, 10.0, on_duplicate="max")
     assert 10.0 == client.ts().get("time-serie-add-ooo-max")[1]
 
     # Test for duplicate policy MIN
     assert 1 == client.ts().add("time-serie-add-ooo-min", 1, 5.0)
-    assert 1 == client.ts().add(
-        "time-serie-add-ooo-min", 1, 10.0, duplicate_policy="min"
-    )
+    assert 1 == client.ts().add("time-serie-add-ooo-min", 1, 10.0, on_duplicate="min")
     assert 5.0 == client.ts().get("time-serie-add-ooo-min")[1]
 
 
@@ -163,6 +157,15 @@ def test_madd(client):
     assert [1, 2, 3] == client.ts().madd([("a", 1, 5), ("a", 2, 10), ("a", 3, 15)])
 
 
+@pytest.mark.redismod
+def test_madd_missing_timeseries(client):
+    response = client.ts().madd([("a", 1, 5), ("a", 2, 10)])
+    assert isinstance(response, list)
+    assert len(response) == 2
+    assert isinstance(response[0], redis.ResponseError)
+    assert isinstance(response[1], redis.ResponseError)
+
+
 @pytest.mark.redismod
 def test_incrby_decrby(client):
     for _ in range(100):
@@ -217,12 +220,12 @@ def test_create_and_delete_rule(client):
 
 
 @pytest.mark.redismod
-@skip_ifmodversion_lt("99.99.99", "timeseries")
+@skip_ifmodversion_lt("1.10.0", "timeseries")
 def test_del_range(client):
     try:
         client.ts().delete("test", 0, 100)
-    except Exception as e:
-        assert e.__str__() != ""
+    except redis.ResponseError as e:
+        assert "key does not exist" in str(e)
 
     for i in range(100):
         client.ts().add(1, i, i % 7)
@@ -247,7 +250,7 @@ def test_range(client):
 
 
 @pytest.mark.redismod
-@skip_ifmodversion_lt("99.99.99", "timeseries")
+@skip_ifmodversion_lt("1.10.0", "timeseries")
 def test_range_advanced(client):
     for i in range(100):
         client.ts().add(1, i, i % 7)
@@ -381,7 +384,7 @@ def test_range_empty(client: redis.Redis):
 
 
 @pytest.mark.redismod
-@skip_ifmodversion_lt("99.99.99", "timeseries")
+@skip_ifmodversion_lt("1.10.0", "timeseries")
 def test_rev_range(client):
     for i in range(100):
         client.ts().add(1, i, i % 7)
@@ -578,7 +581,7 @@ def test_mrange(client):
 
 @pytest.mark.onlynoncluster
 @pytest.mark.redismod
-@skip_ifmodversion_lt("99.99.99", "timeseries")
+@skip_ifmodversion_lt("1.10.0", "timeseries")
 def test_multi_range_advanced(client):
     client.ts().create(1, labels={"Test": "This", "team": "ny"})
     client.ts().create(2, labels={"Test": "This", "Taste": "That", "team": "sf"})
@@ -722,7 +725,7 @@ def test_mrange_latest(client: redis.Redis):
 
 @pytest.mark.onlynoncluster
 @pytest.mark.redismod
-@skip_ifmodversion_lt("99.99.99", "timeseries")
+@skip_ifmodversion_lt("1.10.0", "timeseries")
 def test_multi_reverse_range(client):
     client.ts().create(1, labels={"Test": "This", "team": "ny"})
     client.ts().create(2, labels={"Test": "This", "Taste": "That", "team": "sf"})
@@ -1010,9 +1013,157 @@ def test_pipeline(client):
 def test_uncompressed(client):
     client.ts().create("compressed")
     client.ts().create("uncompressed", uncompressed=True)
+    for i in range(1000):
+        client.ts().add("compressed", i, i)
+        client.ts().add("uncompressed", i, i)
     compressed_info = client.ts().info("compressed")
     uncompressed_info = client.ts().info("uncompressed")
     if is_resp2_connection(client):
-        assert compressed_info.memory_usage != uncompressed_info.memory_usage
+        assert compressed_info.memory_usage < uncompressed_info.memory_usage
     else:
-        assert compressed_info["memoryUsage"] != uncompressed_info["memoryUsage"]
+        assert compressed_info["memoryUsage"] < uncompressed_info["memoryUsage"]
+
+
+@skip_ifmodversion_lt("1.12.0", "timeseries")
+def test_create_with_insertion_filters(client):
+    client.ts().create(
+        "time-series-1",
+        duplicate_policy="last",
+        ignore_max_time_diff=5,
+        ignore_max_val_diff=10.0,
+    )
+    assert 1000 == client.ts().add("time-series-1", 1000, 1.0)
+    assert 1010 == client.ts().add("time-series-1", 1010, 11.0)
+    assert 1010 == client.ts().add("time-series-1", 1013, 10.0)
+    assert 1020 == client.ts().add("time-series-1", 1020, 11.5)
+    assert 1021 == client.ts().add("time-series-1", 1021, 22.0)
+
+    data_points = client.ts().range("time-series-1", "-", "+")
+    expected_points = [(1000, 1.0), (1010, 11.0), (1020, 11.5), (1021, 22.0)]
+    assert expected_points == data_points
+
+
+@skip_ifmodversion_lt("1.12.0", "timeseries")
+def test_create_with_insertion_filters_other_duplicate_policy(client):
+    client.ts().create(
+        "time-series-1",
+        ignore_max_time_diff=5,
+        ignore_max_val_diff=10.0,
+    )
+    assert 1000 == client.ts().add("time-series-1", 1000, 1.0)
+    assert 1010 == client.ts().add("time-series-1", 1010, 11.0)
+    # Still accepted because the duplicate_policy is not `last`.
+    assert 1013 == client.ts().add("time-series-1", 1013, 10.0)
+
+    data_points = client.ts().range("time-series-1", "-", "+")
+    expected_points = [(1000, 1.0), (1010, 11.0), (1013, 10)]
+    assert expected_points == data_points
+
+
+@skip_ifmodversion_lt("1.12.0", "timeseries")
+def test_alter_with_insertion_filters(client):
+    assert 1000 == client.ts().add("time-series-1", 1000, 1.0)
+    assert 1010 == client.ts().add("time-series-1", 1010, 11.0)
+    assert 1013 == client.ts().add("time-series-1", 1013, 10.0)
+
+    client.ts().alter(
+        "time-series-1",
+        duplicate_policy="last",
+        ignore_max_time_diff=5,
+        ignore_max_val_diff=10.0,
+    )
+
+    assert 1013 == client.ts().add("time-series-1", 1015, 11.5)
+
+    data_points = client.ts().range("time-series-1", "-", "+")
+    expected_points = [(1000, 1.0), (1010, 11.0), (1013, 10.0)]
+    assert expected_points == data_points
+
+
+@skip_ifmodversion_lt("1.12.0", "timeseries")
+def test_add_with_insertion_filters(client):
+    assert 1000 == client.ts().add(
+        "time-series-1",
+        1000,
+        1.0,
+        duplicate_policy="last",
+        ignore_max_time_diff=5,
+        ignore_max_val_diff=10.0,
+    )
+
+    assert 1000 == client.ts().add("time-series-1", 1004, 3.0)
+
+    data_points = client.ts().range("time-series-1", "-", "+")
+    expected_points = [(1000, 1.0)]
+    assert expected_points == data_points
+
+
+@skip_ifmodversion_lt("1.12.0", "timeseries")
+def test_incrby_with_insertion_filters(client):
+    assert 1000 == client.ts().incrby(
+        "time-series-1",
+        1.0,
+        timestamp=1000,
+        duplicate_policy="last",
+        ignore_max_time_diff=5,
+        ignore_max_val_diff=10.0,
+    )
+
+    assert 1000 == client.ts().incrby("time-series-1", 3.0, timestamp=1000)
+
+    data_points = client.ts().range("time-series-1", "-", "+")
+    expected_points = [(1000, 1.0)]
+    assert expected_points == data_points
+
+    assert 1000 == client.ts().incrby("time-series-1", 10.1, timestamp=1000)
+
+    data_points = client.ts().range("time-series-1", "-", "+")
+    expected_points = [(1000, 11.1)]
+    assert expected_points == data_points
+
+
+@skip_ifmodversion_lt("1.12.0", "timeseries")
+def test_decrby_with_insertion_filters(client):
+    assert 1000 == client.ts().decrby(
+        "time-series-1",
+        1.0,
+        timestamp=1000,
+        duplicate_policy="last",
+        ignore_max_time_diff=5,
+        ignore_max_val_diff=10.0,
+    )
+
+    assert 1000 == client.ts().decrby("time-series-1", 3.0, timestamp=1000)
+
+    data_points = client.ts().range("time-series-1", "-", "+")
+    expected_points = [(1000, -1.0)]
+    assert expected_points == data_points
+
+    assert 1000 == client.ts().decrby("time-series-1", 10.1, timestamp=1000)
+
+    data_points = client.ts().range("time-series-1", "-", "+")
+    expected_points = [(1000, -11.1)]
+    assert expected_points == data_points
+
+
+@skip_ifmodversion_lt("1.12.0", "timeseries")
+def test_madd_with_insertion_filters(client):
+    client.ts().create(
+        "time-series-1",
+        duplicate_policy="last",
+        ignore_max_time_diff=5,
+        ignore_max_val_diff=10.0,
+    )
+    assert 1010 == client.ts().add("time-series-1", 1010, 1.0)
+    assert [1010, 1010, 1020, 1021] == client.ts().madd(
+        [
+            ("time-series-1", 1011, 11.0),
+            ("time-series-1", 1013, 10.0),
+            ("time-series-1", 1020, 2.0),
+            ("time-series-1", 1021, 22.0),
+        ]
+    )
+
+    data_points = client.ts().range("time-series-1", "-", "+")
+    expected_points = [(1010, 1.0), (1020, 2.0), (1021, 22.0)]
+    assert expected_points == data_points

From 29b861bd72faac2568c5cd804f9f4e7129705ebf Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@redis.com>
Date: Wed, 12 Jun 2024 14:17:49 +0300
Subject: [PATCH 0887/1164] Add extra tests for GEO search (#3244)

Add more tests for GEO search, to cover the query operators `within`,
`contains`, `intersects` and `disjoint`, for POINT and POLYGON, i.e. the
currently supported shapes and operators.
---
 tests/test_search.py | 82 +++++++++++++++++++++++++++++++++++++-------
 1 file changed, 69 insertions(+), 13 deletions(-)

diff --git a/tests/test_search.py b/tests/test_search.py
index 6b40c5129d..7d335f6cec 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -2105,16 +2105,60 @@ def test_geo_params(client):
     params_dict = {"lat": "34.95126", "lon": "29.69465", "radius": 1000, "units": "km"}
     q = Query("@g:[$lon $lat $radius $units]").dialect(2)
     res = client.ft().search(q, query_params=params_dict)
-    if is_resp2_connection(client):
-        assert 3 == res.total
-        assert "doc1" == res.docs[0].id
-        assert "doc2" == res.docs[1].id
-        assert "doc3" == res.docs[2].id
-    else:
-        assert 3 == res["total_results"]
-        assert "doc1" == res["results"][0]["id"]
-        assert "doc2" == res["results"][1]["id"]
-        assert "doc3" == res["results"][2]["id"]
+    _assert_geosearch_result(client, res, ["doc1", "doc2", "doc3"])
+
+
+@pytest.mark.redismod
+def test_geoshapes_query_intersects_and_disjoint(client):
+    client.ft().create_index((GeoShapeField("g", coord_system=GeoShapeField.FLAT)))
+    client.hset("doc_point1", mapping={"g": "POINT (10 10)"})
+    client.hset("doc_point2", mapping={"g": "POINT (50 50)"})
+    client.hset("doc_polygon1", mapping={"g": "POLYGON ((20 20, 25 35, 35 25, 20 20))"})
+    client.hset(
+        "doc_polygon2", mapping={"g": "POLYGON ((60 60, 65 75, 70 70, 65 55, 60 60))"}
+    )
+
+    intersection = client.ft().search(
+        Query("@g:[intersects $shape]").dialect(3),
+        query_params={"shape": "POLYGON((15 15, 75 15, 50 70, 20 40, 15 15))"},
+    )
+    _assert_geosearch_result(client, intersection, ["doc_point2", "doc_polygon1"])
+
+    disjunction = client.ft().search(
+        Query("@g:[disjoint $shape]").dialect(3),
+        query_params={"shape": "POLYGON((15 15, 75 15, 50 70, 20 40, 15 15))"},
+    )
+    _assert_geosearch_result(client, disjunction, ["doc_point1", "doc_polygon2"])
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.10.0", "search")
+def test_geoshapes_query_contains_and_within(client):
+    client.ft().create_index((GeoShapeField("g", coord_system=GeoShapeField.FLAT)))
+    client.hset("doc_point1", mapping={"g": "POINT (10 10)"})
+    client.hset("doc_point2", mapping={"g": "POINT (50 50)"})
+    client.hset("doc_polygon1", mapping={"g": "POLYGON ((20 20, 25 35, 35 25, 20 20))"})
+    client.hset(
+        "doc_polygon2", mapping={"g": "POLYGON ((60 60, 65 75, 70 70, 65 55, 60 60))"}
+    )
+
+    contains_a = client.ft().search(
+        Query("@g:[contains $shape]").dialect(3),
+        query_params={"shape": "POINT(25 25)"},
+    )
+    _assert_geosearch_result(client, contains_a, ["doc_polygon1"])
+
+    contains_b = client.ft().search(
+        Query("@g:[contains $shape]").dialect(3),
+        query_params={"shape": "POLYGON((24 24, 24 26, 25 25, 24 24))"},
+    )
+    _assert_geosearch_result(client, contains_b, ["doc_polygon1"])
+
+    within = client.ft().search(
+        Query("@g:[within $shape]").dialect(3),
+        query_params={"shape": "POLYGON((15 15, 75 15, 50 70, 20 40, 15 15))"},
+    )
+    _assert_geosearch_result(client, within, ["doc_point2", "doc_polygon1"])
 
 
 @pytest.mark.redismod
@@ -2278,7 +2322,19 @@ def test_geoshape(client: redis.Redis):
     q2 = Query("@geom:[CONTAINS $poly]").dialect(3)
     qp2 = {"poly": "POLYGON((2 2, 2 50, 50 50, 50 2, 2 2))"}
     result = client.ft().search(q1, query_params=qp1)
-    assert len(result.docs) == 1
-    assert result.docs[0]["id"] == "small"
+    _assert_geosearch_result(client, result, ["small"])
     result = client.ft().search(q2, query_params=qp2)
-    assert len(result.docs) == 2
+    _assert_geosearch_result(client, result, ["small", "large"])
+
+
+def _assert_geosearch_result(client, result, expected_doc_ids):
+    """
+    Make sure the result of a geo search is as expected, taking into account the RESP
+    version being used.
+    """
+    if is_resp2_connection(client):
+        assert set([doc.id for doc in result.docs]) == set(expected_doc_ids)
+        assert result.total == len(expected_doc_ids)
+    else:
+        assert set([doc["id"] for doc in result["results"]]) == set(expected_doc_ids)
+        assert result["total_results"] == len(expected_doc_ids)

From 5115145b0cbf4e171aaadc0eb0cc47a73a325e1d Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@redis.com>
Date: Thu, 13 Jun 2024 09:57:06 +0300
Subject: [PATCH 0888/1164] Support missing and empty values in search (#3231)

Add support for indexing and searching missing and empty values.

Currently there are some limitation from the server side, for example
empty values are supported only for TEXT and TAG fields.
---
 redis/commands/search/commands.py |  67 ++++++-------
 redis/commands/search/field.py    |  26 +++++
 tests/test_search.py              | 156 +++++++++++++++++++++++++++---
 3 files changed, 205 insertions(+), 44 deletions(-)

diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 2df2b5a754..764ad4c2b8 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -9,6 +9,8 @@
 from ._util import to_string
 from .aggregation import AggregateRequest, AggregateResult, Cursor
 from .document import Document
+from .field import Field
+from .indexDefinition import IndexDefinition
 from .query import Query
 from .result import Result
 from .suggestion import SuggestionParser
@@ -151,44 +153,43 @@ def batch_indexer(self, chunk_size=100):
 
     def create_index(
         self,
-        fields,
-        no_term_offsets=False,
-        no_field_flags=False,
-        stopwords=None,
-        definition=None,
+        fields: List[Field],
+        no_term_offsets: bool = False,
+        no_field_flags: bool = False,
+        stopwords: Optional[List[str]] = None,
+        definition: Optional[IndexDefinition] = None,
         max_text_fields=False,
         temporary=None,
-        no_highlight=False,
-        no_term_frequencies=False,
-        skip_initial_scan=False,
+        no_highlight: bool = False,
+        no_term_frequencies: bool = False,
+        skip_initial_scan: bool = False,
     ):
         """
-        Create the search index. The index must not already exist.
-
-        ### Parameters:
-
-        - **fields**: a list of TextField or NumericField objects
-        - **no_term_offsets**: If true, we will not save term offsets in
-        the index
-        - **no_field_flags**: If true, we will not save field flags that
-        allow searching in specific fields
-        - **stopwords**: If not None, we create the index with this custom
-        stopword list. The list can be empty
-        - **max_text_fields**: If true, we will encode indexes as if there
-        were more than 32 text fields which allows you to add additional
-        fields (beyond 32).
-        - **temporary**: Create a lightweight temporary index which will
-        expire after the specified period of inactivity (in seconds). The
-        internal idle timer is reset whenever the index is searched or added to.
-        - **no_highlight**: If true, disabling highlighting support.
-        Also implied by no_term_offsets.
-        - **no_term_frequencies**: If true, we avoid saving the term frequencies
-        in the index.
-        - **skip_initial_scan**: If true, we do not scan and index.
-
-        For more information see `FT.CREATE <https://redis.io/commands/ft.create>`_.
-        """  # noqa
+        Creates the search index. The index must not already exist.
+
+        For more information, see https://redis.io/commands/ft.create/
+
+        Args:
+            fields: A list of Field objects.
+            no_term_offsets: If `true`, term offsets will not be saved in the index.
+            no_field_flags: If true, field flags that allow searching in specific fields
+                            will not be saved.
+            stopwords: If provided, the index will be created with this custom stopword
+                       list. The list can be empty.
+            definition: If provided, the index will be created with this custom index
+                        definition.
+            max_text_fields: If true, indexes will be encoded as if there were more than
+                             32 text fields, allowing for additional fields beyond 32.
+            temporary: Creates a lightweight temporary index which will expire after the
+                       specified period of inactivity. The internal idle timer is reset
+                       whenever the index is searched or added to.
+            no_highlight: If true, disables highlighting support. Also implied by
+                          `no_term_offsets`.
+            no_term_frequencies: If true, term frequencies will not be saved in the
+                                 index.
+            skip_initial_scan: If true, the initial scan and indexing will be skipped.
 
+        """
         args = [CREATE_CMD, self.index_name]
         if definition is not None:
             args += definition.args
diff --git a/redis/commands/search/field.py b/redis/commands/search/field.py
index f316ed9f14..8af7777f19 100644
--- a/redis/commands/search/field.py
+++ b/redis/commands/search/field.py
@@ -4,6 +4,10 @@
 
 
 class Field:
+    """
+    A class representing a field in a document.
+    """
+
     NUMERIC = "NUMERIC"
     TEXT = "TEXT"
     WEIGHT = "WEIGHT"
@@ -14,6 +18,8 @@ class Field:
     NOINDEX = "NOINDEX"
     AS = "AS"
     GEOSHAPE = "GEOSHAPE"
+    INDEX_MISSING = "INDEXMISSING"
+    INDEX_EMPTY = "INDEXEMPTY"
 
     def __init__(
         self,
@@ -21,8 +27,24 @@ def __init__(
         args: List[str] = None,
         sortable: bool = False,
         no_index: bool = False,
+        index_missing: bool = False,
+        index_empty: bool = False,
         as_name: str = None,
     ):
+        """
+        Create a new field object.
+
+        Args:
+            name: The name of the field.
+            args:
+            sortable: If `True`, the field will be sortable.
+            no_index: If `True`, the field will not be indexed.
+            index_missing: If `True`, it will be possible to search for documents that
+                           have this field missing.
+            index_empty: If `True`, it will be possible to search for documents that
+                         have this field empty.
+            as_name: If provided, this alias will be used for the field.
+        """
         if args is None:
             args = []
         self.name = name
@@ -34,6 +56,10 @@ def __init__(
             self.args_suffix.append(Field.SORTABLE)
         if no_index:
             self.args_suffix.append(Field.NOINDEX)
+        if index_missing:
+            self.args_suffix.append(Field.INDEX_MISSING)
+        if index_empty:
+            self.args_suffix.append(Field.INDEX_EMPTY)
 
         if no_index and not sortable:
             raise ValueError("Non-Sortable non-Indexable fields are ignored")
diff --git a/tests/test_search.py b/tests/test_search.py
index 7d335f6cec..cceb12a547 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -2105,7 +2105,7 @@ def test_geo_params(client):
     params_dict = {"lat": "34.95126", "lon": "29.69465", "radius": 1000, "units": "km"}
     q = Query("@g:[$lon $lat $radius $units]").dialect(2)
     res = client.ft().search(q, query_params=params_dict)
-    _assert_geosearch_result(client, res, ["doc1", "doc2", "doc3"])
+    _assert_search_result(client, res, ["doc1", "doc2", "doc3"])
 
 
 @pytest.mark.redismod
@@ -2122,13 +2122,13 @@ def test_geoshapes_query_intersects_and_disjoint(client):
         Query("@g:[intersects $shape]").dialect(3),
         query_params={"shape": "POLYGON((15 15, 75 15, 50 70, 20 40, 15 15))"},
     )
-    _assert_geosearch_result(client, intersection, ["doc_point2", "doc_polygon1"])
+    _assert_search_result(client, intersection, ["doc_point2", "doc_polygon1"])
 
     disjunction = client.ft().search(
         Query("@g:[disjoint $shape]").dialect(3),
         query_params={"shape": "POLYGON((15 15, 75 15, 50 70, 20 40, 15 15))"},
     )
-    _assert_geosearch_result(client, disjunction, ["doc_point1", "doc_polygon2"])
+    _assert_search_result(client, disjunction, ["doc_point1", "doc_polygon2"])
 
 
 @pytest.mark.redismod
@@ -2146,19 +2146,19 @@ def test_geoshapes_query_contains_and_within(client):
         Query("@g:[contains $shape]").dialect(3),
         query_params={"shape": "POINT(25 25)"},
     )
-    _assert_geosearch_result(client, contains_a, ["doc_polygon1"])
+    _assert_search_result(client, contains_a, ["doc_polygon1"])
 
     contains_b = client.ft().search(
         Query("@g:[contains $shape]").dialect(3),
         query_params={"shape": "POLYGON((24 24, 24 26, 25 25, 24 24))"},
     )
-    _assert_geosearch_result(client, contains_b, ["doc_polygon1"])
+    _assert_search_result(client, contains_b, ["doc_polygon1"])
 
     within = client.ft().search(
         Query("@g:[within $shape]").dialect(3),
         query_params={"shape": "POLYGON((15 15, 75 15, 50 70, 20 40, 15 15))"},
     )
-    _assert_geosearch_result(client, within, ["doc_point2", "doc_polygon1"])
+    _assert_search_result(client, within, ["doc_point2", "doc_polygon1"])
 
 
 @pytest.mark.redismod
@@ -2322,19 +2322,153 @@ def test_geoshape(client: redis.Redis):
     q2 = Query("@geom:[CONTAINS $poly]").dialect(3)
     qp2 = {"poly": "POLYGON((2 2, 2 50, 50 50, 50 2, 2 2))"}
     result = client.ft().search(q1, query_params=qp1)
-    _assert_geosearch_result(client, result, ["small"])
+    _assert_search_result(client, result, ["small"])
     result = client.ft().search(q2, query_params=qp2)
-    _assert_geosearch_result(client, result, ["small", "large"])
+    _assert_search_result(client, result, ["small", "large"])
 
 
-def _assert_geosearch_result(client, result, expected_doc_ids):
+@pytest.mark.redismod
+def test_search_missing_fields(client):
+    definition = IndexDefinition(prefix=["property:"], index_type=IndexType.HASH)
+
+    fields = [
+        TextField("title", sortable=True),
+        TagField("features", index_missing=True),
+        TextField("description", index_missing=True),
+    ]
+
+    client.ft().create_index(fields, definition=definition)
+
+    # All fields present
+    client.hset(
+        "property:1",
+        mapping={
+            "title": "Luxury Villa in Malibu",
+            "features": "pool,sea view,modern",
+            "description": "A stunning modern villa overlooking the Pacific Ocean.",
+        },
+    )
+
+    # Missing features
+    client.hset(
+        "property:2",
+        mapping={
+            "title": "Downtown Flat",
+            "description": "Modern flat in central Paris with easy access to metro.",
+        },
+    )
+
+    # Missing description
+    client.hset(
+        "property:3",
+        mapping={
+            "title": "Beachfront Bungalow",
+            "features": "beachfront,sun deck",
+        },
+    )
+
+    with pytest.raises(redis.exceptions.ResponseError) as e:
+        client.ft().search(
+            Query("ismissing(@title)").dialect(5).return_field("id").no_content()
+        )
+    assert "to be defined with 'INDEXMISSING'" in e.value.args[0]
+
+    res = client.ft().search(
+        Query("ismissing(@features)").dialect(5).return_field("id").no_content()
+    )
+    _assert_search_result(client, res, ["property:2"])
+
+    res = client.ft().search(
+        Query("-ismissing(@features)").dialect(5).return_field("id").no_content()
+    )
+    _assert_search_result(client, res, ["property:1", "property:3"])
+
+    res = client.ft().search(
+        Query("ismissing(@description)").dialect(5).return_field("id").no_content()
+    )
+    _assert_search_result(client, res, ["property:3"])
+
+    res = client.ft().search(
+        Query("-ismissing(@description)").dialect(5).return_field("id").no_content()
+    )
+    _assert_search_result(client, res, ["property:1", "property:2"])
+
+
+@pytest.mark.redismod
+def test_search_empty_fields(client):
+    definition = IndexDefinition(prefix=["property:"], index_type=IndexType.HASH)
+
+    fields = [
+        TextField("title", sortable=True),
+        TagField("features", index_empty=True),
+        TextField("description", index_empty=True),
+    ]
+
+    client.ft().create_index(fields, definition=definition)
+
+    # All fields present
+    client.hset(
+        "property:1",
+        mapping={
+            "title": "Luxury Villa in Malibu",
+            "features": "pool,sea view,modern",
+            "description": "A stunning modern villa overlooking the Pacific Ocean.",
+        },
+    )
+
+    # Empty features
+    client.hset(
+        "property:2",
+        mapping={
+            "title": "Downtown Flat",
+            "features": "",
+            "description": "Modern flat in central Paris with easy access to metro.",
+        },
+    )
+
+    # Empty description
+    client.hset(
+        "property:3",
+        mapping={
+            "title": "Beachfront Bungalow",
+            "features": "beachfront,sun deck",
+            "description": "",
+        },
+    )
+
+    with pytest.raises(redis.exceptions.ResponseError) as e:
+        client.ft().search(
+            Query("@title:''").dialect(5).return_field("id").no_content()
+        )
+    assert "to be defined with `INDEXEMPTY`" in e.value.args[0]
+
+    res = client.ft().search(
+        Query("@features:{ }").dialect(5).return_field("id").no_content()
+    )
+    _assert_search_result(client, res, ["property:2"])
+
+    res = client.ft().search(
+        Query("-@features:{ }").dialect(5).return_field("id").no_content()
+    )
+    _assert_search_result(client, res, ["property:1", "property:3"])
+
+    res = client.ft().search(
+        Query("@description:''").dialect(5).return_field("id").no_content()
+    )
+    _assert_search_result(client, res, ["property:3"])
+
+    res = client.ft().search(
+        Query("-@description:''").dialect(5).return_field("id").no_content()
+    )
+    _assert_search_result(client, res, ["property:1", "property:2"])
+
+
+def _assert_search_result(client, result, expected_doc_ids):
     """
     Make sure the result of a geo search is as expected, taking into account the RESP
     version being used.
     """
     if is_resp2_connection(client):
         assert set([doc.id for doc in result.docs]) == set(expected_doc_ids)
-        assert result.total == len(expected_doc_ids)
     else:
         assert set([doc["id"] for doc in result["results"]]) == set(expected_doc_ids)
-        assert result["total_results"] == len(expected_doc_ids)

From 6de96968c9b81ca9f60979663837ffcb9bcbe11d Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@redis.com>
Date: Thu, 13 Jun 2024 12:38:25 +0300
Subject: [PATCH 0889/1164] Test special characters escaping in search (#3276)

With RediSearch dialect 5 less special characters need escaping when
searching, given that TAG fields are used. Add a test to show some
examples.
---
 tests/test_search.py | 59 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)

diff --git a/tests/test_search.py b/tests/test_search.py
index cceb12a547..284bccd913 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -2463,6 +2463,65 @@ def test_search_empty_fields(client):
     _assert_search_result(client, res, ["property:1", "property:2"])
 
 
+@pytest.mark.redismod
+def test_special_characters_in_fields(client):
+    definition = IndexDefinition(prefix=["resource:"], index_type=IndexType.HASH)
+
+    fields = [
+        TagField("uuid"),
+        TagField("tags", separator="|"),
+        TextField("description"),
+        NumericField("rating"),
+    ]
+
+    client.ft().create_index(fields, definition=definition)
+
+    client.hset(
+        "resource:1",
+        mapping={
+            "uuid": "123e4567-e89b-12d3-a456-426614174000",
+            "tags": "finance|crypto|$btc|blockchain",
+            "description": "Analysis of blockchain technologies & Bitcoin's potential.",
+            "rating": 5,
+        },
+    )
+
+    client.hset(
+        "resource:2",
+        mapping={
+            "uuid": "987e6543-e21c-12d3-a456-426614174999",
+            "tags": "health|well-being|fitness|new-year's-resolutions",
+            "description": "Health trends for the new year, including fitness regimes.",
+            "rating": 4,
+        },
+    )
+
+    # no need to escape - when using params
+    res = client.ft().search(
+        Query("@uuid:{$uuid}").dialect(2),
+        query_params={"uuid": "123e4567-e89b-12d3-a456-426614174000"},
+    )
+    _assert_search_result(client, res, ["resource:1"])
+
+    # with dialect 5 no need to escape the - even without params
+    res = client.ft().search(
+        Query("@uuid:{123e4567-e89b-12d3-a456-426614174000}").dialect(5)
+    )
+    _assert_search_result(client, res, ["resource:1"])
+
+    # also no need to escape ' with dialect 5
+    res = client.ft().search(Query("@tags:{new-year's-resolutions}").dialect(5))
+    _assert_search_result(client, res, ["resource:2"])
+
+    # possible to search numeric fields by single value
+    res = client.ft().search(Query("@rating:[4]").dialect(2))
+    _assert_search_result(client, res, ["resource:2"])
+
+    # some chars still need escaping
+    res = client.ft().search(Query(r"@tags:{\$btc}").dialect(5))
+    _assert_search_result(client, res, ["resource:1"])
+
+
 def _assert_search_result(client, result, expected_doc_ids):
     """
     Make sure the result of a geo search is as expected, taking into account the RESP

From 733f8006713d506a869498e20d442fec144aa7b3 Mon Sep 17 00:00:00 2001
From: andy-stark-redis <164213578+andy-stark-redis@users.noreply.github.com>
Date: Thu, 13 Jun 2024 11:02:54 +0100
Subject: [PATCH 0890/1164] Move code samples to master branch (#3271)

Move the code samples used for documentation into the master branch,
so they sit next to the code they document.
---
 CHANGES                       |   1 +
 doctests/README.md            |  32 +++
 doctests/dt_bitfield.py       |  34 +++
 doctests/dt_bitmap.py         |  40 ++++
 doctests/dt_bloom.py          |  41 ++++
 doctests/dt_cms.py            |  32 +++
 doctests/dt_cuckoo.py         |  36 +++
 doctests/dt_geo.py            |  45 ++++
 doctests/dt_hash.py           | 107 +++++++++
 doctests/dt_hll.py            |  36 +++
 doctests/dt_json.py           | 372 +++++++++++++++++++++++++++++
 doctests/dt_list.py           | 323 ++++++++++++++++++++++++++
 doctests/dt_set.py            | 172 ++++++++++++++
 doctests/dt_ss.py             | 118 ++++++++++
 doctests/dt_stream.py         | 423 +++++++++++++++++++++++++++++++++
 doctests/dt_string.py         |  61 +++++
 doctests/dt_tdigest.py        |  81 +++++++
 doctests/dt_topk.py           |  38 +++
 doctests/requirements.txt     |   5 +
 doctests/run_examples.sh      |  15 ++
 doctests/search_quickstart.py | 425 ++++++++++++++++++++++++++++++++++
 doctests/search_vss.py        | 347 +++++++++++++++++++++++++++
 doctests/string_set_get.py    |  25 ++
 23 files changed, 2809 insertions(+)
 create mode 100644 doctests/README.md
 create mode 100644 doctests/dt_bitfield.py
 create mode 100644 doctests/dt_bitmap.py
 create mode 100644 doctests/dt_bloom.py
 create mode 100644 doctests/dt_cms.py
 create mode 100644 doctests/dt_cuckoo.py
 create mode 100644 doctests/dt_geo.py
 create mode 100644 doctests/dt_hash.py
 create mode 100644 doctests/dt_hll.py
 create mode 100644 doctests/dt_json.py
 create mode 100644 doctests/dt_list.py
 create mode 100644 doctests/dt_set.py
 create mode 100644 doctests/dt_ss.py
 create mode 100644 doctests/dt_stream.py
 create mode 100644 doctests/dt_string.py
 create mode 100644 doctests/dt_tdigest.py
 create mode 100644 doctests/dt_topk.py
 create mode 100644 doctests/requirements.txt
 create mode 100644 doctests/run_examples.sh
 create mode 100644 doctests/search_quickstart.py
 create mode 100644 doctests/search_vss.py
 create mode 100644 doctests/string_set_get.py

diff --git a/CHANGES b/CHANGES
index 82c5b6db2a..20d7d8f51f 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Move doctests (doc code examples) to main branch
     * Update `ResponseT` type hint
     * Allow to control the minimum SSL version
     * Add an optional lock_name attribute to LockError.
diff --git a/doctests/README.md b/doctests/README.md
new file mode 100644
index 0000000000..9dd6eaeb5d
--- /dev/null
+++ b/doctests/README.md
@@ -0,0 +1,32 @@
+# Command examples for redis.io
+
+## How to add an example
+
+Create regular python file in the current folder with meaningful name. It makes sense prefix example files with
+command category (e.g. string, set, list, hash, etc) to make navigation in the folder easier. Files ending in *.py*
+are automatically run by the test suite.
+
+### Special markup
+
+See https://github.com/redis-stack/redis-stack-website#readme for more details.
+
+## How to test examples
+
+Examples are standalone python scripts, committed to the *doctests* directory. These scripts assume that the
+```requirements.txt``` and ```dev_requirements.txt``` from this repository have been installed, as per below.
+
+```bash
+pip install -r requirements.txt
+pip install -r dev_requirements.txt
+pip install -r doctests/requirements.txt
+```
+
+Note - the CI process, runs the basic ```black``` and ```isort``` linters against the examples. Assuming
+the requirements above have been installed you can run ```black yourfile.py``` and ```isort yourfile.py```
+locally to validate the linting, prior to CI.
+
+Just include necessary assertions in the example file and run
+```bash
+sh doctests/run_examples.sh
+```
+to test all examples in the current folder.
diff --git a/doctests/dt_bitfield.py b/doctests/dt_bitfield.py
new file mode 100644
index 0000000000..44717bf128
--- /dev/null
+++ b/doctests/dt_bitfield.py
@@ -0,0 +1,34 @@
+# EXAMPLE: bitfield_tutorial
+# HIDE_START
+"""
+Code samples for Bitfield doc pages:
+    https://redis.io/docs/latest/develop/data-types/bitfields/
+"""
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+
+# REMOVE_START
+r.delete("bike:1:stats")
+# REMOVE_END
+
+# STEP_START bf
+bf = r.bitfield("bike:1:stats")
+res1 = bf.set("u32", "#0", 1000).execute()
+print(res1)  # >>> [0]
+
+res2 = bf.incrby("u32", "#0", -50).incrby("u32", "#1", 1).execute()
+print(res2)  # >>> [950, 1]
+
+res3 = bf.incrby("u32", "#0", 500).incrby("u32", "#1", 1).execute()
+print(res3)  # >>> [1450, 2]
+
+res4 = bf.get("u32", "#0").get("u32", "#1").execute()
+print(res4)  # >>> [1450, 2]
+# STEP_END
+
+# REMOVE_START
+assert res1 == [0]
+assert res4 == [1450, 2]
+# REMOVE_END
diff --git a/doctests/dt_bitmap.py b/doctests/dt_bitmap.py
new file mode 100644
index 0000000000..a769c96863
--- /dev/null
+++ b/doctests/dt_bitmap.py
@@ -0,0 +1,40 @@
+# EXAMPLE: bitmap_tutorial
+# HIDE_START
+"""
+Code samples for Bitmap doc pages:
+    https://redis.io/docs/latest/develop/data-types/bitmaps/
+"""
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+
+# REMOVE_START
+r.delete("pings:2024-01-01-00:00")
+# REMOVE_END
+
+# STEP_START ping
+res1 = r.setbit("pings:2024-01-01-00:00", 123, 1)
+print(res1)  # >>> 0
+
+res2 = r.getbit("pings:2024-01-01-00:00", 123)
+print(res2)  # >>> 1
+
+res3 = r.getbit("pings:2024-01-01-00:00", 456)
+print(res3)  # >>> 0
+# STEP_END
+
+# REMOVE_START
+assert res1 == 0
+# REMOVE_END
+
+# STEP_START bitcount
+# HIDE_START
+r.setbit("pings:2024-01-01-00:00", 123, 1)
+# HIDE_END
+res4 = r.bitcount("pings:2024-01-01-00:00")
+print(res4)  # >>> 1
+# STEP_END
+# REMOVE_START
+assert res4 == 1
+# REMOVE_END
diff --git a/doctests/dt_bloom.py b/doctests/dt_bloom.py
new file mode 100644
index 0000000000..fab815240f
--- /dev/null
+++ b/doctests/dt_bloom.py
@@ -0,0 +1,41 @@
+# EXAMPLE: bf_tutorial
+# HIDE_START
+"""
+Code samples for Bloom filter doc pages:
+    https://redis.io/docs/latest/develop/data-types/probabilistic/bloom-filter/
+"""
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+
+# STEP_START bloom
+res1 = r.bf().reserve("bikes:models", 0.01, 1000)
+print(res1)  # >>> True
+
+res2 = r.bf().add("bikes:models", "Smoky Mountain Striker")
+print(res2)  # >>> True
+
+res3 = r.bf().exists("bikes:models", "Smoky Mountain Striker")
+print(res3)  # >>> True
+
+res4 = r.bf().madd(
+    "bikes:models",
+    "Rocky Mountain Racer",
+    "Cloudy City Cruiser",
+    "Windy City Wippet",
+)
+print(res4)  # >>> [True, True, True]
+
+res5 = r.bf().mexists(
+    "bikes:models",
+    "Rocky Mountain Racer",
+    "Cloudy City Cruiser",
+    "Windy City Wippet",
+)
+print(res5)  # >>> [True, True, True]
+# STEP_END
+
+# REMOVE_START
+assert res1 is True
+# REMOVE_END
diff --git a/doctests/dt_cms.py b/doctests/dt_cms.py
new file mode 100644
index 0000000000..b784aa5f3b
--- /dev/null
+++ b/doctests/dt_cms.py
@@ -0,0 +1,32 @@
+# EXAMPLE: cms_tutorial
+# HIDE_START
+"""
+Code samples for Count-min sketch doc pages:
+    https://redis.io/docs/latest/develop/data-types/probabilistic/count-min-sketch/
+"""
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+# REMOVE_START
+r.delete("bikes:profit")
+# REMOVE_END
+
+# STEP_START cms
+res1 = r.cms().initbyprob("bikes:profit", 0.001, 0.002)
+print(res1)  # >>> True
+
+res2 = r.cms().incrby("bikes:profit", ["Smoky Mountain Striker"], [100])
+print(res2)  # >>> [100]
+
+res3 = r.cms().incrby(
+    "bikes:profit", ["Rocky Mountain Racer", "Cloudy City Cruiser"], [200, 150]
+)
+print(res3)  # >>> [200, 150]
+
+res4 = r.cms().query("bikes:profit", "Smoky Mountain Striker")
+print(res4)  # >>> [100]
+
+res5 = r.cms().info("bikes:profit")
+print(res5.width, res5.depth, res5.count)  # >>> 2000 9 450
+# STEP_END
diff --git a/doctests/dt_cuckoo.py b/doctests/dt_cuckoo.py
new file mode 100644
index 0000000000..b7c58e99f5
--- /dev/null
+++ b/doctests/dt_cuckoo.py
@@ -0,0 +1,36 @@
+# EXAMPLE: cuckoo_tutorial
+# HIDE_START
+"""
+Code samples for Cuckoo filter doc pages:
+    https://redis.io/docs/latest/develop/data-types/probabilistic/cuckoo-filter/
+"""
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+
+# REMOVE_START
+r.delete("bikes:models")
+# REMOVE_END
+
+# STEP_START cuckoo
+res1 = r.cf().reserve("bikes:models", 1000000)
+print(res1)  # >>> True
+
+res2 = r.cf().add("bikes:models", "Smoky Mountain Striker")
+print(res2)  # >>> 1
+
+res3 = r.cf().exists("bikes:models", "Smoky Mountain Striker")
+print(res3)  # >>> 1
+
+res4 = r.cf().exists("bikes:models", "Terrible Bike Name")
+print(res4)  # >>> 0
+
+res5 = r.cf().delete("bikes:models", "Smoky Mountain Striker")
+print(res5)  # >>> 1
+# STEP_END
+
+# REMOVE_START
+assert res1 is True
+assert res5 == 1
+# REMOVE_END
diff --git a/doctests/dt_geo.py b/doctests/dt_geo.py
new file mode 100644
index 0000000000..a841cb1df6
--- /dev/null
+++ b/doctests/dt_geo.py
@@ -0,0 +1,45 @@
+# EXAMPLE: geo_tutorial
+# HIDE_START
+"""
+Code samples for Geospatial doc pages:
+    https://redis.io/docs/latest/develop/data-types/geospatial/
+"""
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+# REMOVE_START
+r.delete("bikes:rentable")
+# REMOVE_END
+
+# STEP_START geoadd
+res1 = r.geoadd("bikes:rentable", [-122.27652, 37.805186, "station:1"])
+print(res1)  # >>> 1
+
+res2 = r.geoadd("bikes:rentable", [-122.2674626, 37.8062344, "station:2"])
+print(res2)  # >>> 1
+
+res3 = r.geoadd("bikes:rentable", [-122.2469854, 37.8104049, "station:3"])
+print(res3)  # >>> 1
+# STEP_END
+
+# REMOVE_START
+assert res1 == 1
+assert res2 == 1
+assert res3 == 1
+# REMOVE_END
+
+# STEP_START geosearch
+res4 = r.geosearch(
+    "bikes:rentable",
+    longitude=-122.27652,
+    latitude=37.805186,
+    radius=5,
+    unit="km",
+)
+print(res4)  # >>> ['station:1', 'station:2', 'station:3']
+# STEP_END
+
+# REMOVE_START
+assert res4 == ["station:1", "station:2", "station:3"]
+# REMOVE_END
diff --git a/doctests/dt_hash.py b/doctests/dt_hash.py
new file mode 100644
index 0000000000..a9d5b0bf64
--- /dev/null
+++ b/doctests/dt_hash.py
@@ -0,0 +1,107 @@
+# EXAMPLE: hash_tutorial
+# HIDE_START
+"""
+Code samples for Hash doc pages:
+    https://redis.io/docs/latest/develop/data-types/hashes/
+"""
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+# STEP_START set_get_all
+res1 = r.hset(
+    "bike:1",
+    mapping={
+        "model": "Deimos",
+        "brand": "Ergonom",
+        "type": "Enduro bikes",
+        "price": 4972,
+    },
+)
+print(res1)
+# >>> 4
+
+res2 = r.hget("bike:1", "model")
+print(res2)
+# >>> 'Deimos'
+
+res3 = r.hget("bike:1", "price")
+print(res3)
+# >>> '4972'
+
+res4 = r.hgetall("bike:1")
+print(res4)
+# >>> {'model': 'Deimos', 'brand': 'Ergonom', 'type': 'Enduro bikes', 'price': '4972'}
+
+# STEP_END
+
+# REMOVE_START
+assert res1 == 4
+assert res2 == "Deimos"
+assert res3 == "4972"
+assert res4 == {
+    "model": "Deimos",
+    "brand": "Ergonom",
+    "type": "Enduro bikes",
+    "price": "4972",
+}
+# REMOVE_END
+
+# STEP_START hmget
+res5 = r.hmget("bike:1", ["model", "price"])
+print(res5)
+# >>> ['Deimos', '4972']
+# STEP_END
+
+# REMOVE_START
+assert res5 == ["Deimos", "4972"]
+# REMOVE_END
+
+# STEP_START hincrby
+res6 = r.hincrby("bike:1", "price", 100)
+print(res6)
+# >>> 5072
+res7 = r.hincrby("bike:1", "price", -100)
+print(res7)
+# >>> 4972
+# STEP_END
+
+# REMOVE_START
+assert res6 == 5072
+assert res7 == 4972
+# REMOVE_END
+
+
+# STEP_START incrby_get_mget
+res11 = r.hincrby("bike:1:stats", "rides", 1)
+print(res11)
+# >>> 1
+res12 = r.hincrby("bike:1:stats", "rides", 1)
+print(res12)
+# >>> 2
+res13 = r.hincrby("bike:1:stats", "rides", 1)
+print(res13)
+# >>> 3
+res14 = r.hincrby("bike:1:stats", "crashes", 1)
+print(res14)
+# >>> 1
+res15 = r.hincrby("bike:1:stats", "owners", 1)
+print(res15)
+# >>> 1
+res16 = r.hget("bike:1:stats", "rides")
+print(res16)
+# >>> 3
+res17 = r.hmget("bike:1:stats", ["crashes", "owners"])
+print(res17)
+# >>> ['1', '1']
+# STEP_END
+
+# REMOVE_START
+assert res11 == 1
+assert res12 == 2
+assert res13 == 3
+assert res14 == 1
+assert res15 == 1
+assert res16 == "3"
+assert res17 == ["1", "1"]
+# REMOVE_END
diff --git a/doctests/dt_hll.py b/doctests/dt_hll.py
new file mode 100644
index 0000000000..281d7f0a0b
--- /dev/null
+++ b/doctests/dt_hll.py
@@ -0,0 +1,36 @@
+# # EXAMPLE: hll_tutorial
+# HIDE_START
+"""
+Code samples for HyperLogLog doc pages:
+    https://redis.io/docs/latest/develop/data-types/probabilistic/hyperloglogs/
+"""
+
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+
+# REMOVE_START
+r.delete("bikes", "commuter_bikes", "all_bikes")
+# REMOVE_END
+
+# STEP_START pfadd
+res1 = r.pfadd("bikes", "Hyperion", "Deimos", "Phoebe", "Quaoar")
+print(res1)  # >>> 1
+
+res2 = r.pfcount("bikes")
+print(res2)  # >>> 4
+
+res3 = r.pfadd("commuter_bikes", "Salacia", "Mimas", "Quaoar")
+print(res3)  # >>> 1
+
+res4 = r.pfmerge("all_bikes", "bikes", "commuter_bikes")
+print(res4)  # >>> True
+
+res5 = r.pfcount("all_bikes")
+print(res5)  # >>> 6
+# STEP_END
+
+# REMOVE_START
+assert res4 is True
+# REMOVE_END
diff --git a/doctests/dt_json.py b/doctests/dt_json.py
new file mode 100644
index 0000000000..f7c2226048
--- /dev/null
+++ b/doctests/dt_json.py
@@ -0,0 +1,372 @@
+# EXAMPLE: json_tutorial
+# HIDE_START
+"""
+Code samples for JSON doc pages:
+    https://redis.io/docs/latest/develop/data-types/json/
+"""
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+
+# REMOVE_START
+r.delete("bike")
+r.delete("crashes")
+r.delete("newbike")
+r.delete("rider")
+# REMOVE_END
+
+# STEP_START set_get
+res1 = r.json().set("bike", "$", '"Hyperion"')
+print(res1)  # >>> True
+
+res2 = r.json().get("bike", "$")
+print(res2)  # >>> ['"Hyperion"']
+
+res3 = r.json().type("bike", "$")
+print(res3)  # >>> ['string']
+# STEP_END
+
+# REMOVE_START
+assert res2 == ['"Hyperion"']
+# REMOVE_END
+
+# STEP_START str
+res4 = r.json().strlen("bike", "$")
+print(res4)  # >>> [10]
+
+res5 = r.json().strappend("bike", '" (Enduro bikes)"')
+print(res5)  # >>> 27
+
+res6 = r.json().get("bike", "$")
+print(res6)  # >>> ['"Hyperion"" (Enduro bikes)"']
+# STEP_END
+
+# REMOVE_START
+assert res6 == ['"Hyperion"" (Enduro bikes)"']
+# REMOVE_END
+
+# STEP_START num
+res7 = r.json().set("crashes", "$", 0)
+print(res7)  # >>> True
+
+res8 = r.json().numincrby("crashes", "$", 1)
+print(res8)  # >>> [1]
+
+res9 = r.json().numincrby("crashes", "$", 1.5)
+print(res9)  # >>> [2.5]
+
+res10 = r.json().numincrby("crashes", "$", -0.75)
+print(res10)  # >>> [1.75]
+# STEP_END
+
+# REMOVE_START
+assert res10 == [1.75]
+# REMOVE_END
+
+# STEP_START arr
+res11 = r.json().set("newbike", "$", ["Deimos", {"crashes": 0}, None])
+print(res11)  # >>> True
+
+res12 = r.json().get("newbike", "$")
+print(res12)  # >>> ['["Deimos", { "crashes": 0 }, null]']
+
+res13 = r.json().get("newbike", "$[1].crashes")
+print(res13)  # >>> ['0']
+
+res14 = r.json().delete("newbike", "$.[-1]")
+print(res14)  # >>> [1]
+
+res15 = r.json().get("newbike", "$")
+print(res15)  # >>> [['Deimos', {'crashes': 0}]]
+# STEP_END
+
+# REMOVE_START
+assert res15 == [["Deimos", {"crashes": 0}]]
+# REMOVE_END
+
+# STEP_START arr2
+res16 = r.json().set("riders", "$", [])
+print(res16)  # >>> True
+
+res17 = r.json().arrappend("riders", "$", "Norem")
+print(res17)  # >>> [1]
+
+res18 = r.json().get("riders", "$")
+print(res18)  # >>> [['Norem']]
+
+res19 = r.json().arrinsert("riders", "$", 1, "Prickett", "Royce", "Castilla")
+print(res19)  # >>> [4]
+
+res20 = r.json().get("riders", "$")
+print(res20)  # >>> [['Norem', 'Prickett', 'Royce', 'Castilla']]
+
+res21 = r.json().arrtrim("riders", "$", 1, 1)
+print(res21)  # >>> [1]
+
+res22 = r.json().get("riders", "$")
+print(res22)  # >>> [['Prickett']]
+
+res23 = r.json().arrpop("riders", "$")
+print(res23)  # >>> ['"Prickett"']
+
+res24 = r.json().arrpop("riders", "$")
+print(res24)  # >>> [None]
+# STEP_END
+
+# REMOVE_START
+assert res24 == [None]
+# REMOVE_END
+
+# STEP_START obj
+res25 = r.json().set(
+    "bike:1", "$", {"model": "Deimos", "brand": "Ergonom", "price": 4972}
+)
+print(res25)  # >>> True
+
+res26 = r.json().objlen("bike:1", "$")
+print(res26)  # >>> [3]
+
+res27 = r.json().objkeys("bike:1", "$")
+print(res27)  # >>> [['model', 'brand', 'price']]
+# STEP_END
+
+# REMOVE_START
+assert res27 == [["model", "brand", "price"]]
+# REMOVE_END
+
+# STEP_START set_bikes
+# HIDE_START
+inventory_json = {
+    "inventory": {
+        "mountain_bikes": [
+            {
+                "id": "bike:1",
+                "model": "Phoebe",
+                "description": "This is a mid-travel trail slayer that is a fantastic "
+                "daily driver or one bike quiver. The Shimano Claris 8-speed groupset "
+                "gives plenty of gear range to tackle hills and there\u2019s room for "
+                "mudguards and a rack too.  This is the bike for the rider who wants "
+                "trail manners with low fuss ownership.",
+                "price": 1920,
+                "specs": {"material": "carbon", "weight": 13.1},
+                "colors": ["black", "silver"],
+            },
+            {
+                "id": "bike:2",
+                "model": "Quaoar",
+                "description": "Redesigned for the 2020 model year, this bike "
+                "impressed our testers and is the best all-around trail bike we've "
+                "ever tested. The Shimano gear system effectively does away with an "
+                "external cassette, so is super low maintenance in terms of wear "
+                "and tear. All in all it's an impressive package for the price, "
+                "making it very competitive.",
+                "price": 2072,
+                "specs": {"material": "aluminium", "weight": 7.9},
+                "colors": ["black", "white"],
+            },
+            {
+                "id": "bike:3",
+                "model": "Weywot",
+                "description": "This bike gives kids aged six years and older "
+                "a durable and uberlight mountain bike for their first experience "
+                "on tracks and easy cruising through forests and fields. A set of "
+                "powerful Shimano hydraulic disc brakes provide ample stopping "
+                "ability. If you're after a budget option, this is one of the best "
+                "bikes you could get.",
+                "price": 3264,
+                "specs": {"material": "alloy", "weight": 13.8},
+            },
+        ],
+        "commuter_bikes": [
+            {
+                "id": "bike:4",
+                "model": "Salacia",
+                "description": "This bike is a great option for anyone who just "
+                "wants a bike to get about on With a slick-shifting Claris gears "
+                "from Shimano\u2019s, this is a bike which doesn\u2019t break the "
+                "bank and delivers craved performance.  It\u2019s for the rider "
+                "who wants both efficiency and capability.",
+                "price": 1475,
+                "specs": {"material": "aluminium", "weight": 16.6},
+                "colors": ["black", "silver"],
+            },
+            {
+                "id": "bike:5",
+                "model": "Mimas",
+                "description": "A real joy to ride, this bike got very high "
+                "scores in last years Bike of the year report. The carefully "
+                "crafted 50-34 tooth chainset and 11-32 tooth cassette give an "
+                "easy-on-the-legs bottom gear for climbing, and the high-quality "
+                "Vittoria Zaffiro tires give balance and grip.It includes "
+                "a low-step frame , our memory foam seat, bump-resistant shocks and "
+                "conveniently placed thumb throttle. Put it all together and you "
+                "get a bike that helps redefine what can be done for this price.",
+                "price": 3941,
+                "specs": {"material": "alloy", "weight": 11.6},
+            },
+        ],
+    }
+}
+# HIDE_END
+
+res1 = r.json().set("bikes:inventory", "$", inventory_json)
+print(res1)  # >>> True
+# STEP_END
+
+# STEP_START get_bikes
+res2 = r.json().get("bikes:inventory", "$.inventory.*")
+print(res2)
+# >>>    [[{'id': 'bike:1', 'model': 'Phoebe',
+# >>>       'description': 'This is a mid-travel trail slayer...
+# STEP_END
+
+# STEP_START get_mtnbikes
+res3 = r.json().get("bikes:inventory", "$.inventory.mountain_bikes[*].model")
+print(res3)  # >>> [['Phoebe', 'Quaoar', 'Weywot']]
+
+res4 = r.json().get("bikes:inventory", '$.inventory["mountain_bikes"][*].model')
+print(res4)  # >>> [['Phoebe', 'Quaoar', 'Weywot']]
+
+res5 = r.json().get("bikes:inventory", "$..mountain_bikes[*].model")
+print(res5)  # >>> [['Phoebe', 'Quaoar', 'Weywot']]
+# STEP_END
+
+# REMOVE_START
+assert res3 == ["Phoebe", "Quaoar", "Weywot"]
+assert res4 == ["Phoebe", "Quaoar", "Weywot"]
+assert res5 == ["Phoebe", "Quaoar", "Weywot"]
+# REMOVE_END
+
+# STEP_START get_models
+res6 = r.json().get("bikes:inventory", "$..model")
+print(res6)  # >>> [['Phoebe', 'Quaoar', 'Weywot', 'Salacia', 'Mimas']]
+# STEP_END
+
+# REMOVE_START
+assert res6 == ["Phoebe", "Quaoar", "Weywot", "Salacia", "Mimas"]
+# REMOVE_END
+
+# STEP_START get2mtnbikes
+res7 = r.json().get("bikes:inventory", "$..mountain_bikes[0:2].model")
+print(res7)  # >>> [['Phoebe', 'Quaoar']]
+# STEP_END
+
+# REMOVE_START
+assert res7 == ["Phoebe", "Quaoar"]
+# REMOVE_END
+
+# STEP_START filter1
+res8 = r.json().get(
+    "bikes:inventory",
+    "$..mountain_bikes[?(@.price < 3000 && @.specs.weight < 10)]",
+)
+print(res8)
+# >>> [{'id': 'bike:2', 'model': 'Quaoar',
+#           'description': "Redesigned for the 2020 model year...
+# STEP_END
+
+# REMOVE_START
+assert res8 == [
+    {
+        "id": "bike:2",
+        "model": "Quaoar",
+        "description": "Redesigned for the 2020 model year, this bike impressed "
+        "our testers and is the best all-around trail bike we've ever tested. "
+        "The Shimano gear system effectively does away with an external cassette, "
+        "so is super low maintenance in terms of wear and tear. All in all it's "
+        "an impressive package for the price, making it very competitive.",
+        "price": 2072,
+        "specs": {"material": "aluminium", "weight": 7.9},
+        "colors": ["black", "white"],
+    }
+]
+# REMOVE_END
+
+# STEP_START filter2
+#  names of bikes made from an alloy
+res9 = r.json().get("bikes:inventory", "$..[?(@.specs.material == 'alloy')].model")
+print(res9)  # >>> ['Weywot', 'Mimas']
+# STEP_END
+
+# REMOVE_START
+assert res9 == ["Weywot", "Mimas"]
+# REMOVE_END
+
+# STEP_START filter3
+res10 = r.json().get("bikes:inventory", "$..[?(@.specs.material =~ '(?i)al')].model")
+print(res10)  # >>> ['Quaoar', 'Weywot', 'Salacia', 'Mimas']
+# STEP_END
+
+# REMOVE_START
+assert res10 == ["Quaoar", "Weywot", "Salacia", "Mimas"]
+# REMOVE_END
+
+# STEP_START filter4
+res11 = r.json().set(
+    "bikes:inventory", "$.inventory.mountain_bikes[0].regex_pat", "(?i)al"
+)
+res12 = r.json().set(
+    "bikes:inventory", "$.inventory.mountain_bikes[1].regex_pat", "(?i)al"
+)
+res13 = r.json().set(
+    "bikes:inventory", "$.inventory.mountain_bikes[2].regex_pat", "(?i)al"
+)
+
+res14 = r.json().get(
+    "bikes:inventory",
+    "$.inventory.mountain_bikes[?(@.specs.material =~ @.regex_pat)].model",
+)
+print(res14)  # >>> ['Quaoar', 'Weywot']
+# STEP_END
+
+# REMOVE_START
+assert res14 == ["Quaoar", "Weywot"]
+# REMOVE_END
+
+# STEP_START update_bikes
+res15 = r.json().get("bikes:inventory", "$..price")
+print(res15)  # >>> [1920, 2072, 3264, 1475, 3941]
+
+res16 = r.json().numincrby("bikes:inventory", "$..price", -100)
+print(res16)  # >>> [1820, 1972, 3164, 1375, 3841]
+
+res17 = r.json().numincrby("bikes:inventory", "$..price", 100)
+print(res17)  # >>> [1920, 2072, 3264, 1475, 3941]
+# STEP_END
+
+# REMOVE_START
+assert res15 == [1920, 2072, 3264, 1475, 3941]
+assert res16 == [1820, 1972, 3164, 1375, 3841]
+assert res17 == [1920, 2072, 3264, 1475, 3941]
+# REMOVE_END
+
+# STEP_START update_filters1
+res18 = r.json().set("bikes:inventory", "$.inventory.*[?(@.price<2000)].price", 1500)
+res19 = r.json().get("bikes:inventory", "$..price")
+print(res19)  # >>> [1500, 2072, 3264, 1500, 3941]
+# STEP_END
+
+# REMOVE_START
+assert res19 == [1500, 2072, 3264, 1500, 3941]
+# REMOVE_END
+
+# STEP_START update_filters2
+res20 = r.json().arrappend(
+    "bikes:inventory", "$.inventory.*[?(@.price<2000)].colors", "pink"
+)
+print(res20)  # >>> [3, 3]
+
+res21 = r.json().get("bikes:inventory", "$..[*].colors")
+print(
+    res21
+)  # >>> [['black', 'silver', 'pink'], ['black', 'white'], ['black', 'silver', 'pink']]
+# STEP_END
+
+# REMOVE_START
+assert res21 == [
+    ["black", "silver", "pink"],
+    ["black", "white"],
+    ["black", "silver", "pink"],
+]
+# REMOVE_END
diff --git a/doctests/dt_list.py b/doctests/dt_list.py
new file mode 100644
index 0000000000..be8a4b8562
--- /dev/null
+++ b/doctests/dt_list.py
@@ -0,0 +1,323 @@
+# EXAMPLE: list_tutorial
+# HIDE_START
+"""
+Code samples for List doc pages:
+    https://redis.io/docs/latest/develop/data-types/lists/
+"""
+
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+# REMOVE_START
+r.delete("bikes:repairs")
+r.delete("bikes:finished")
+# REMOVE_END
+
+# STEP_START queue
+res1 = r.lpush("bikes:repairs", "bike:1")
+print(res1)  # >>> 1
+
+res2 = r.lpush("bikes:repairs", "bike:2")
+print(res2)  # >>> 2
+
+res3 = r.rpop("bikes:repairs")
+print(res3)  # >>> bike:1
+
+res4 = r.rpop("bikes:repairs")
+print(res4)  # >>> bike:2
+# STEP_END
+
+# REMOVE_START
+assert res1 == 1
+assert res2 == 2
+assert res3 == "bike:1"
+assert res4 == "bike:2"
+# REMOVE_END
+
+# STEP_START stack
+res5 = r.lpush("bikes:repairs", "bike:1")
+print(res5)  # >>> 1
+
+res6 = r.lpush("bikes:repairs", "bike:2")
+print(res6)  # >>> 2
+
+res7 = r.lpop("bikes:repairs")
+print(res7)  # >>> bike:2
+
+res8 = r.lpop("bikes:repairs")
+print(res8)  # >>> bike:1
+# STEP_END
+
+# REMOVE_START
+assert res5 == 1
+assert res6 == 2
+assert res7 == "bike:2"
+assert res8 == "bike:1"
+# REMOVE_END
+
+# STEP_START llen
+res9 = r.llen("bikes:repairs")
+print(res9)  # >>> 0
+# STEP_END
+
+# REMOVE_START
+assert res9 == 0
+# REMOVE_END
+
+# STEP_START lmove_lrange
+res10 = r.lpush("bikes:repairs", "bike:1")
+print(res10)  # >>> 1
+
+res11 = r.lpush("bikes:repairs", "bike:2")
+print(res11)  # >>> 2
+
+res12 = r.lmove("bikes:repairs", "bikes:finished", "LEFT", "LEFT")
+print(res12)  # >>> 'bike:2'
+
+res13 = r.lrange("bikes:repairs", 0, -1)
+print(res13)  # >>> ['bike:1']
+
+res14 = r.lrange("bikes:finished", 0, -1)
+print(res14)  # >>> ['bike:2']
+# STEP_END
+
+# REMOVE_START
+assert res10 == 1
+assert res11 == 2
+assert res12 == "bike:2"
+assert res13 == ["bike:1"]
+assert res14 == ["bike:2"]
+r.delete("bikes:repairs")
+# REMOVE_END
+
+# STEP_START lpush_rpush
+res15 = r.rpush("bikes:repairs", "bike:1")
+print(res15)  # >>> 1
+
+res16 = r.rpush("bikes:repairs", "bike:2")
+print(res16)  # >>> 2
+
+res17 = r.lpush("bikes:repairs", "bike:important_bike")
+print(res17)  # >>> 3
+
+res18 = r.lrange("bikes:repairs", 0, -1)
+print(res18)  # >>> ['bike:important_bike', 'bike:1', 'bike:2']
+# STEP_END
+
+# REMOVE_START
+assert res15 == 1
+assert res16 == 2
+assert res17 == 3
+assert res18 == ["bike:important_bike", "bike:1", "bike:2"]
+r.delete("bikes:repairs")
+# REMOVE_END
+
+# STEP_START variadic
+res19 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
+print(res19)  # >>> 3
+
+res20 = r.lpush("bikes:repairs", "bike:important_bike", "bike:very_important_bike")
+print(res20)  # >>> 5
+
+res21 = r.lrange("bikes:repairs", 0, -1)
+print(
+    res21
+)  # >>> ['bike:very_important_bike', 'bike:important_bike', 'bike:1', ...
+# STEP_END
+
+# REMOVE_START
+assert res19 == 3
+assert res20 == 5
+assert res21 == [
+    "bike:very_important_bike",
+    "bike:important_bike",
+    "bike:1",
+    "bike:2",
+    "bike:3",
+]
+r.delete("bikes:repairs")
+# REMOVE_END
+
+# STEP_START lpop_rpop
+res22 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
+print(res22)  # >>> 3
+
+res23 = r.rpop("bikes:repairs")
+print(res23)  # >>> 'bike:3'
+
+res24 = r.lpop("bikes:repairs")
+print(res24)  # >>> 'bike:1'
+
+res25 = r.rpop("bikes:repairs")
+print(res25)  # >>> 'bike:2'
+
+res26 = r.rpop("bikes:repairs")
+print(res26)  # >>> None
+# STEP_END
+
+# REMOVE_START
+assert res22 == 3
+assert res23 == "bike:3"
+assert res24 == "bike:1"
+assert res25 == "bike:2"
+assert res26 is None
+# REMOVE_END
+
+# STEP_START ltrim
+res27 = r.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5")
+print(res27)  # >>> 5
+
+res28 = r.ltrim("bikes:repairs", 0, 2)
+print(res28)  # >>> True
+
+res29 = r.lrange("bikes:repairs", 0, -1)
+print(res29)  # >>> ['bike:5', 'bike:4', 'bike:3']
+# STEP_END
+
+# REMOVE_START
+assert res27 == 5
+assert res28 is True
+assert res29 == ["bike:5", "bike:4", "bike:3"]
+r.delete("bikes:repairs")
+# REMOVE_END
+
+# STEP_START ltrim_end_of_list
+res27 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5")
+print(res27)  # >>> 5
+
+res28 = r.ltrim("bikes:repairs", -3, -1)
+print(res28)  # >>> True
+
+res29 = r.lrange("bikes:repairs", 0, -1)
+print(res29)  # >>> ['bike:3', 'bike:4', 'bike:5']
+# STEP_END
+
+# REMOVE_START
+assert res27 == 5
+assert res28 is True
+assert res29 == ["bike:3", "bike:4", "bike:5"]
+r.delete("bikes:repairs")
+# REMOVE_END
+
+# STEP_START brpop
+res31 = r.rpush("bikes:repairs", "bike:1", "bike:2")
+print(res31)  # >>> 2
+
+res32 = r.brpop("bikes:repairs", timeout=1)
+print(res32)  # >>> ('bikes:repairs', 'bike:2')
+
+res33 = r.brpop("bikes:repairs", timeout=1)
+print(res33)  # >>> ('bikes:repairs', 'bike:1')
+
+res34 = r.brpop("bikes:repairs", timeout=1)
+print(res34)  # >>> None
+# STEP_END
+
+# REMOVE_START
+assert res31 == 2
+assert res32 == ("bikes:repairs", "bike:2")
+assert res33 == ("bikes:repairs", "bike:1")
+assert res34 is None
+r.delete("bikes:repairs")
+r.delete("new_bikes")
+# REMOVE_END
+
+# STEP_START rule_1
+res35 = r.delete("new_bikes")
+print(res35)  # >>> 0
+
+res36 = r.lpush("new_bikes", "bike:1", "bike:2", "bike:3")
+print(res36)  # >>> 3
+# STEP_END
+
+# REMOVE_START
+assert res35 == 0
+assert res36 == 3
+r.delete("new_bikes")
+# REMOVE_END
+
+# STEP_START rule_1.1
+res37 = r.set("new_bikes", "bike:1")
+print(res37)  # >>> True
+
+res38 = r.type("new_bikes")
+print(res38)  # >>> 'string'
+
+try:
+    res39 = r.lpush("new_bikes", "bike:2", "bike:3")
+    # >>> redis.exceptions.ResponseError:
+    # >>> WRONGTYPE Operation against a key holding the wrong kind of value
+except redis.exceptions.ResponseError as e:
+    print(e)
+# STEP_END
+
+# REMOVE_START
+assert res37 is True
+assert res38 == "string"
+r.delete("new_bikes")
+# REMOVE_END
+
+# STEP_START rule_2
+r.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
+print(res36)  # >>> 3
+
+res40 = r.exists("bikes:repairs")
+print(res40)  # >>> 1
+
+res41 = r.lpop("bikes:repairs")
+print(res41)  # >>> 'bike:3'
+
+res42 = r.lpop("bikes:repairs")
+print(res42)  # >>> 'bike:2'
+
+res43 = r.lpop("bikes:repairs")
+print(res43)  # >>> 'bike:1'
+
+res44 = r.exists("bikes:repairs")
+print(res44)  # >>> False
+# STEP_END
+
+# REMOVE_START
+assert res40 == 1
+assert res41 == "bike:3"
+assert res42 == "bike:2"
+assert res43 == "bike:1"
+assert res44 == 0
+r.delete("bikes:repairs")
+# REMOVE_END
+
+# STEP_START rule_3
+res45 = r.delete("bikes:repairs")
+print(res45)  # >>> 0
+
+res46 = r.llen("bikes:repairs")
+print(res46)  # >>> 0
+
+res47 = r.lpop("bikes:repairs")
+print(res47)  # >>> None
+# STEP_END
+
+# REMOVE_START
+assert res45 == 0
+assert res46 == 0
+assert res47 is None
+# REMOVE_END
+
+# STEP_START ltrim.1
+res48 = r.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5")
+print(res48)  # >>> 5
+
+res49 = r.ltrim("bikes:repairs", 0, 2)
+print(res49)  # >>> True
+
+res50 = r.lrange("bikes:repairs", 0, -1)
+print(res50)  # >>> ['bike:5', 'bike:4', 'bike:3']
+# STEP_END
+
+# REMOVE_START
+assert res48 == 5
+assert res49 is True
+assert res50 == ["bike:5", "bike:4", "bike:3"]
+r.delete("bikes:repairs")
+# REMOVE_END
diff --git a/doctests/dt_set.py b/doctests/dt_set.py
new file mode 100644
index 0000000000..bcc7ba934f
--- /dev/null
+++ b/doctests/dt_set.py
@@ -0,0 +1,172 @@
+# EXAMPLE: sets_tutorial
+# HIDE_START
+"""
+Code samples for Set doc pages:
+    https://redis.io/docs/latest/develop/data-types/sets/
+"""
+
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+# REMOVE_START
+r.delete("bikes:racing:france")
+r.delete("bikes:racing:usa")
+# REMOVE_END
+
+# STEP_START sadd
+res1 = r.sadd("bikes:racing:france", "bike:1")
+print(res1)  # >>> 1
+
+res2 = r.sadd("bikes:racing:france", "bike:1")
+print(res2)  # >>> 0
+
+res3 = r.sadd("bikes:racing:france", "bike:2", "bike:3")
+print(res3)  # >>> 2
+
+res4 = r.sadd("bikes:racing:usa", "bike:1", "bike:4")
+print(res4)  # >>> 2
+# STEP_END
+
+# REMOVE_START
+assert res1 == 1
+assert res2 == 0
+assert res3 == 2
+assert res4 == 2
+# REMOVE_END
+
+# STEP_START sismember
+# HIDE_START
+r.sadd("bikes:racing:france", "bike:1", "bike:2", "bike:3")
+r.sadd("bikes:racing:usa", "bike:1", "bike:4")
+# HIDE_END
+res5 = r.sismember("bikes:racing:usa", "bike:1")
+print(res5)  # >>> 1
+
+res6 = r.sismember("bikes:racing:usa", "bike:2")
+print(res6)  # >>> 1
+# STEP_END
+
+# REMOVE_START
+assert res5 == 1
+assert res6 == 0
+# REMOVE_END
+
+# STEP_START sinter
+# HIDE_START
+r.sadd("bikes:racing:france", "bike:1", "bike:2", "bike:3")
+r.sadd("bikes:racing:usa", "bike:1", "bike:4")
+# HIDE_END
+res7 = r.sinter("bikes:racing:france", "bikes:racing:usa")
+print(res7)  # >>> {'bike:1'}
+# STEP_END
+
+# REMOVE_START
+assert res7 == {"bike:1"}
+# REMOVE_END
+
+# STEP_START scard
+# HIDE_START
+r.sadd("bikes:racing:france", "bike:1", "bike:2", "bike:3")
+# HIDE_END
+res8 = r.scard("bikes:racing:france")
+print(res8)  # >>> 3
+# STEP_END
+
+# REMOVE_START
+assert res8 == 3
+r.delete("bikes:racing:france")
+# REMOVE_END
+
+# STEP_START sadd_smembers
+res9 = r.sadd("bikes:racing:france", "bike:1", "bike:2", "bike:3")
+print(res9)  # >>> 3
+
+res10 = r.smembers("bikes:racing:france")
+print(res10)  # >>> {'bike:1', 'bike:2', 'bike:3'}
+# STEP_END
+
+# REMOVE_START
+assert res9 == 3
+assert res10 == {"bike:1", "bike:2", "bike:3"}
+# REMOVE_END
+
+# STEP_START smismember
+res11 = r.sismember("bikes:racing:france", "bike:1")
+print(res11)  # >>> 1
+
+res12 = r.smismember("bikes:racing:france", "bike:2", "bike:3", "bike:4")
+print(res12)  # >>> [1, 1, 0]
+# STEP_END
+
+# REMOVE_START
+assert res11 == 1
+assert res12 == [1, 1, 0]
+# REMOVE_END
+
+# STEP_START sdiff
+r.sadd("bikes:racing:france", "bike:1", "bike:2", "bike:3")
+r.sadd("bikes:racing:usa", "bike:1", "bike:4")
+
+res13 = r.sdiff("bikes:racing:france", "bikes:racing:usa")
+print(res13)  # >>> {'bike:2', 'bike:3'}
+# STEP_END
+
+# REMOVE_START
+assert res13 == {"bike:2", "bike:3"}
+r.delete("bikes:racing:france")
+r.delete("bikes:racing:usa")
+# REMOVE_END
+
+# STEP_START multisets
+r.sadd("bikes:racing:france", "bike:1", "bike:2", "bike:3")
+r.sadd("bikes:racing:usa", "bike:1", "bike:4")
+r.sadd("bikes:racing:italy", "bike:1", "bike:2", "bike:3", "bike:4")
+
+res13 = r.sinter("bikes:racing:france", "bikes:racing:usa", "bikes:racing:italy")
+print(res13)  # >>> {'bike:1'}
+
+res14 = r.sunion("bikes:racing:france", "bikes:racing:usa", "bikes:racing:italy")
+print(res14)  # >>> {'bike:1', 'bike:2', 'bike:3', 'bike:4'}
+
+res15 = r.sdiff("bikes:racing:france", "bikes:racing:usa", "bikes:racing:italy")
+print(res15)  # >>> set()
+
+res16 = r.sdiff("bikes:racing:usa", "bikes:racing:france")
+print(res16)  # >>> {'bike:4'}
+
+res17 = r.sdiff("bikes:racing:france", "bikes:racing:usa")
+print(res17)  # >>> {'bike:2', 'bike:3'}
+# STEP_END
+
+# REMOVE_START
+assert res13 == {"bike:1"}
+assert res14 == {"bike:1", "bike:2", "bike:3", "bike:4"}
+assert res15 == set()
+assert res16 == {"bike:4"}
+assert res17 == {"bike:2", "bike:3"}
+r.delete("bikes:racing:france")
+r.delete("bikes:racing:usa")
+r.delete("bikes:racing:italy")
+# REMOVE_END
+
+# STEP_START srem
+r.sadd("bikes:racing:france", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5")
+
+res18 = r.srem("bikes:racing:france", "bike:1")
+print(res18)  # >>> 1
+
+res19 = r.spop("bikes:racing:france")
+print(res19)  # >>> bike:3
+
+res20 = r.smembers("bikes:racing:france")
+print(res20)  # >>> {'bike:2', 'bike:4', 'bike:5'}
+
+res21 = r.srandmember("bikes:racing:france")
+print(res21)  # >>> bike:4
+# STEP_END
+
+# REMOVE_START
+assert res18 == 1
+# none of the other results are deterministic
+# REMOVE_END
diff --git a/doctests/dt_ss.py b/doctests/dt_ss.py
new file mode 100644
index 0000000000..76fa72ad4c
--- /dev/null
+++ b/doctests/dt_ss.py
@@ -0,0 +1,118 @@
+# EXAMPLE: ss_tutorial
+# HIDE_START
+"""
+Code samples for Sorted set doc pages:
+    https://redis.io/docs/latest/develop/data-types/sorted-sets/
+"""
+
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+
+# REMOVE_START
+r.delete("racer_scores")
+# REMOVE_END
+
+# STEP_START zadd
+res1 = r.zadd("racer_scores", {"Norem": 10})
+print(res1)  # >>> 1
+
+res2 = r.zadd("racer_scores", {"Castilla": 12})
+print(res2)  # >>> 1
+
+res3 = r.zadd(
+    "racer_scores",
+    {"Sam-Bodden": 8, "Royce": 10, "Ford": 6, "Prickett": 14, "Castilla": 12},
+)
+print(res3)  # >>> 4
+# STEP_END
+
+# REMOVE_START
+assert r.zcard("racer_scores") == 6
+# REMOVE_END
+
+# STEP_START zrange
+res4 = r.zrange("racer_scores", 0, -1)
+print(res4)  # >>> ['Ford', 'Sam-Bodden', 'Norem', 'Royce', 'Castilla', 'Prickett']
+
+res5 = r.zrevrange("racer_scores", 0, -1)
+print(res5)  # >>> ['Prickett', 'Castilla', 'Royce', 'Norem', 'Sam-Bodden', 'Ford']
+# STEP_END
+
+# STEP_START zrange_withscores
+res6 = r.zrange("racer_scores", 0, -1, withscores=True)
+print(
+    res6
+)
+# >>> [
+#       ('Ford', 6.0), ('Sam-Bodden', 8.0), ('Norem', 10.0), ('Royce', 10.0),
+#       ('Castilla', 12.0), ('Prickett', 14.0)
+# ]
+# STEP_END
+
+# STEP_START zrangebyscore
+res7 = r.zrangebyscore("racer_scores", "-inf", 10)
+print(res7)  # >>> ['Ford', 'Sam-Bodden', 'Norem', 'Royce']
+# STEP_END
+
+# STEP_START zremrangebyscore
+res8 = r.zrem("racer_scores", "Castilla")
+print(res8)  # >>> 1
+
+res9 = r.zremrangebyscore("racer_scores", "-inf", 9)
+print(res9)  # >>> 2
+
+res10 = r.zrange("racer_scores", 0, -1)
+print(res10)  # >>> ['Norem', 'Royce', 'Prickett']
+# STEP_END
+
+# REMOVE_START
+assert r.zcard("racer_scores") == 3
+# REMOVE_END
+
+# STEP_START zrank
+res11 = r.zrank("racer_scores", "Norem")
+print(res11)  # >>> 0
+
+res12 = r.zrevrank("racer_scores", "Norem")
+print(res12)  # >>> 2
+# STEP_END
+
+# STEP_START zadd_lex
+res13 = r.zadd(
+    "racer_scores",
+    {
+        "Norem": 0,
+        "Sam-Bodden": 0,
+        "Royce": 0,
+        "Ford": 0,
+        "Prickett": 0,
+        "Castilla": 0,
+    },
+)
+print(res13)  # >>> 3
+
+res14 = r.zrange("racer_scores", 0, -1)
+print(res14)  # >>> ['Castilla', 'Ford', 'Norem', 'Prickett', 'Royce', 'Sam-Bodden']
+
+res15 = r.zrangebylex("racer_scores", "[A", "[L")
+print(res15)  # >>> ['Castilla', 'Ford']
+# STEP_END
+
+# STEP_START leaderboard
+res16 = r.zadd("racer_scores", {"Wood": 100})
+print(res16)  # >>> 1
+
+res17 = r.zadd("racer_scores", {"Henshaw": 100})
+print(res17)  # >>> 1
+
+res18 = r.zadd("racer_scores", {"Henshaw": 150})
+print(res18)  # >>> 0
+
+res19 = r.zincrby("racer_scores", 50, "Wood")
+print(res19)  # >>> 150.0
+
+res20 = r.zincrby("racer_scores", 50, "Henshaw")
+print(res20)  # >>> 200.0
+# STEP_END
diff --git a/doctests/dt_stream.py b/doctests/dt_stream.py
new file mode 100644
index 0000000000..7282ee3d24
--- /dev/null
+++ b/doctests/dt_stream.py
@@ -0,0 +1,423 @@
+# EXAMPLE: stream_tutorial
+# HIDE_START
+"""
+Code samples for Stream doc pages:
+    https://redis.io/docs/latest/develop/data-types/streams/
+"""
+
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+# REMOVE_START
+r.delete("race:france", "race:italy", "race:usa")
+# REMOVE_END
+
+# STEP_START xadd
+res1 = r.xadd(
+    "race:france",
+    {"rider": "Castilla", "speed": 30.2, "position": 1, "location_id": 1},
+)
+print(res1)  # >>> 1692629576966-0
+
+res2 = r.xadd(
+    "race:france",
+    {"rider": "Norem", "speed": 28.8, "position": 3, "location_id": 1},
+)
+print(res2)  # >>> 1692629594113-0
+
+res3 = r.xadd(
+    "race:france",
+    {"rider": "Prickett", "speed": 29.7, "position": 2, "location_id": 1},
+)
+print(res3)  # >>> 1692629613374-0
+# STEP_END
+
+# REMOVE_START
+assert r.xlen("race:france") == 3
+# REMOVE_END
+
+# STEP_START xrange
+res4 = r.xrange("race:france", "1691765278160-0", "+", 2)
+print(
+    res4
+)  # >>> [
+#   ('1692629576966-0',
+#       {'rider': 'Castilla', 'speed': '30.2', 'position': '1', 'location_id': '1'}
+#   ),
+#   ('1692629594113-0',
+#       {'rider': 'Norem', 'speed': '28.8', 'position': '3', 'location_id': '1'}
+#   )
+# ]
+# STEP_END
+
+# STEP_START xread_block
+res5 = r.xread(streams={"race:france": 0}, count=100, block=300)
+print(
+    res5
+)
+# >>> [
+#   ['race:france',
+#       [('1692629576966-0',
+#           {'rider': 'Castilla', 'speed': '30.2', 'position': '1', 'location_id': '1'}
+#       ),
+#       ('1692629594113-0',
+#           {'rider': 'Norem', 'speed': '28.8', 'position': '3', 'location_id': '1'}
+#       ),
+#       ('1692629613374-0',
+#           {'rider': 'Prickett', 'speed': '29.7', 'position': '2', 'location_id': '1'}
+#       )]
+# ]
+# ]
+# STEP_END
+
+# STEP_START xadd_2
+res6 = r.xadd(
+    "race:france",
+    {"rider": "Castilla", "speed": 29.9, "position": 1, "location_id": 2},
+)
+print(res6)  # >>> 1692629676124-0
+# STEP_END
+
+# STEP_START xlen
+res7 = r.xlen("race:france")
+print(res7)  # >>> 4
+# STEP_END
+
+
+# STEP_START xadd_id
+res8 = r.xadd("race:usa", {"racer": "Castilla"}, id="0-1")
+print(res8)  # >>> 0-1
+
+res9 = r.xadd("race:usa", {"racer": "Norem"}, id="0-2")
+print(res9)  # >>> 0-2
+# STEP_END
+
+# STEP_START xadd_bad_id
+try:
+    res10 = r.xadd("race:usa", {"racer": "Prickett"}, id="0-1")
+    print(res10)  # >>> 0-1
+except redis.exceptions.ResponseError as e:
+    print(e)  # >>> WRONGID
+# STEP_END
+
+# STEP_START xadd_7
+# Not yet implemented
+# STEP_END
+
+# STEP_START xrange_all
+res11 = r.xrange("race:france", "-", "+")
+print(
+    res11
+)
+# >>> [
+#   ('1692629576966-0',
+#       {'rider': 'Castilla', 'speed': '30.2', 'position': '1', 'location_id': '1'}
+#   ),
+#   ('1692629594113-0',
+#       {'rider': 'Norem', 'speed': '28.8', 'position': '3', 'location_id': '1'}
+#   ),
+#   ('1692629613374-0',
+#       {'rider': 'Prickett', 'speed': '29.7', 'position': '2', 'location_id': '1'}
+#   ),
+#   ('1692629676124-0',
+#       {'rider': 'Castilla', 'speed': '29.9', 'position': '1', 'location_id': '2'}
+#   )
+# ]
+# STEP_END
+
+# STEP_START xrange_time
+res12 = r.xrange("race:france", 1692629576965, 1692629576967)
+print(
+    res12
+)
+# >>> [
+#       ('1692629576966-0',
+#           {'rider': 'Castilla', 'speed': '30.2', 'position': '1', 'location_id': '1'}
+#       )
+# ]
+# STEP_END
+
+# STEP_START xrange_step_1
+res13 = r.xrange("race:france", "-", "+", 2)
+print(
+    res13
+)
+# >>> [
+#   ('1692629576966-0',
+#       {'rider': 'Castilla', 'speed': '30.2', 'position': '1', 'location_id': '1'}
+#   ),
+#   ('1692629594113-0',
+#       {'rider': 'Norem', 'speed': '28.8', 'position': '3', 'location_id': '1'}
+#   )
+# ]
+# STEP_END
+
+# STEP_START xrange_step_2
+res14 = r.xrange("race:france", "(1692629594113-0", "+", 2)
+print(
+    res14
+)
+# >>> [
+#   ('1692629613374-0',
+#       {'rider': 'Prickett', 'speed': '29.7', 'position': '2', 'location_id': '1'}
+#   ),
+#   ('1692629676124-0',
+#       {'rider': 'Castilla', 'speed': '29.9', 'position': '1', 'location_id': '2'}
+#   )
+# ]
+# STEP_END
+
+# STEP_START xrange_empty
+res15 = r.xrange("race:france", "(1692629676124-0", "+", 2)
+print(res15)  # >>> []
+# STEP_END
+
+# STEP_START xrevrange
+res16 = r.xrevrange("race:france", "+", "-", 1)
+print(
+    res16
+)
+# >>> [
+#       ('1692629676124-0',
+#           {'rider': 'Castilla', 'speed': '29.9', 'position': '1', 'location_id': '2'}
+#       )
+# ]
+# STEP_END
+
+# STEP_START xread
+res17 = r.xread(streams={"race:france": 0}, count=2)
+print(
+    res17
+)
+# >>> [
+#       ['race:france', [
+#       ('1692629576966-0',
+#           {'rider': 'Castilla', 'speed': '30.2', 'position': '1', 'location_id': '1'}
+#       ),
+#       ('1692629594113-0',
+#           {'rider': 'Norem', 'speed': '28.8', 'position': '3', 'location_id': '1'}
+#       )
+#       ]
+#       ]
+#   ]
+# STEP_END
+
+# STEP_START xgroup_create
+res18 = r.xgroup_create("race:france", "france_riders", "$")
+print(res18)  # >>> True
+# STEP_END
+
+# STEP_START xgroup_create_mkstream
+res19 = r.xgroup_create("race:italy", "italy_riders", "$", mkstream=True)
+print(res19)  # >>> True
+# STEP_END
+
+# STEP_START xgroup_read
+r.xadd("race:italy", {"rider": "Castilla"})
+r.xadd("race:italy", {"rider": "Royce"})
+r.xadd("race:italy", {"rider": "Sam-Bodden"})
+r.xadd("race:italy", {"rider": "Prickett"})
+r.xadd("race:italy", {"rider": "Norem"})
+
+res20 = r.xreadgroup(
+    streams={"race:italy": ">"},
+    consumername="Alice",
+    groupname="italy_riders",
+    count=1,
+)
+print(res20)  # >>> [['race:italy', [('1692629925771-0', {'rider': 'Castilla'})]]]
+# STEP_END
+
+# STEP_START xgroup_read_id
+res21 = r.xreadgroup(
+    streams={"race:italy": 0},
+    consumername="Alice",
+    groupname="italy_riders",
+    count=1,
+)
+print(res21)  # >>> [['race:italy', [('1692629925771-0', {'rider': 'Castilla'})]]]
+# STEP_END
+
+# STEP_START xack
+res22 = r.xack("race:italy", "italy_riders", "1692629925771-0")
+print(res22)  # >>> 1
+
+res23 = r.xreadgroup(
+    streams={"race:italy": 0},
+    consumername="Alice",
+    groupname="italy_riders",
+    count=1,
+)
+print(res23)  # >>> [['race:italy', []]]
+# STEP_END
+
+# STEP_START xgroup_read_bob
+res24 = r.xreadgroup(
+    streams={"race:italy": ">"},
+    consumername="Bob",
+    groupname="italy_riders",
+    count=2,
+)
+print(
+    res24
+)
+# >>> [
+#       ['race:italy', [
+#           ('1692629925789-0',
+#               {'rider': 'Royce'}
+#           ),
+#           ('1692629925790-0',
+#               {'rider': 'Sam-Bodden'}
+#           )
+#       ]
+#       ]
+# ]
+# STEP_END
+
+# STEP_START xpending
+res25 = r.xpending("race:italy", "italy_riders")
+print(
+    res25
+)
+# >>> {
+#       'pending': 2, 'min': '1692629925789-0', 'max': '1692629925790-0',
+#       'consumers': [{'name': 'Bob', 'pending': 2}]
+# }
+# STEP_END
+
+# STEP_START xpending_plus_minus
+res26 = r.xpending_range("race:italy", "italy_riders", "-", "+", 10)
+print(
+    res26
+)
+# >>> [
+#       {
+#           'message_id': '1692629925789-0', 'consumer': 'Bob',
+#           'time_since_delivered': 31084, 'times_delivered': 1
+#       },
+#       {
+#           'message_id': '1692629925790-0', 'consumer': 'Bob',
+#           'time_since_delivered': 31084, 'times_delivered': 1
+#       }
+# ]
+# STEP_END
+
+# STEP_START xrange_pending
+res27 = r.xrange("race:italy", "1692629925789-0", "1692629925789-0")
+print(res27)  # >>> [('1692629925789-0', {'rider': 'Royce'})]
+# STEP_END
+
+# STEP_START xclaim
+res28 = r.xclaim("race:italy", "italy_riders", "Alice", 60000, ["1692629925789-0"])
+print(res28)  # >>> [('1692629925789-0', {'rider': 'Royce'})]
+# STEP_END
+
+# STEP_START xautoclaim
+res29 = r.xautoclaim("race:italy", "italy_riders", "Alice", 1, "0-0", 1)
+print(res29)  # >>> ['1692629925790-0', [('1692629925789-0', {'rider': 'Royce'})]]
+# STEP_END
+
+# STEP_START xautoclaim_cursor
+res30 = r.xautoclaim("race:italy", "italy_riders", "Alice", 1, "(1692629925789-0", 1)
+print(res30)  # >>> ['0-0', [('1692629925790-0', {'rider': 'Sam-Bodden'})]]
+# STEP_END
+
+# STEP_START xinfo
+res31 = r.xinfo_stream("race:italy")
+print(
+    res31
+)
+# >>> {
+#       'length': 5, 'radix-tree-keys': 1, 'radix-tree-nodes': 2,
+#       'last-generated-id': '1692629926436-0', 'groups': 1,
+#       'first-entry': ('1692629925771-0', {'rider': 'Castilla'}),
+#       'last-entry': ('1692629926436-0', {'rider': 'Norem'})
+# }
+# STEP_END
+
+# STEP_START xinfo_groups
+res32 = r.xinfo_groups("race:italy")
+print(
+    res32
+)
+# >>> [
+#       {
+#           'name': 'italy_riders', 'consumers': 2, 'pending': 2,
+#           'last-delivered-id': '1692629925790-0'
+#       }
+# ]
+# STEP_END
+
+# STEP_START xinfo_consumers
+res33 = r.xinfo_consumers("race:italy", "italy_riders")
+print(
+    res33
+)
+# >>> [
+#       {'name': 'Alice', 'pending': 2, 'idle': 199332},
+#       {'name': 'Bob', 'pending': 0, 'idle': 489170}
+# ]
+# STEP_END
+
+# STEP_START maxlen
+r.xadd("race:italy", {"rider": "Jones"}, maxlen=2)
+r.xadd("race:italy", {"rider": "Wood"}, maxlen=2)
+r.xadd("race:italy", {"rider": "Henshaw"}, maxlen=2)
+
+res34 = r.xlen("race:italy")
+print(res34)  # >>> 8
+
+res35 = r.xrange("race:italy", "-", "+")
+print(
+    res35
+)
+# >>> [
+#       ('1692629925771-0', {'rider': 'Castilla'}),
+#       ('1692629925789-0', {'rider': 'Royce'}),
+#       ('1692629925790-0', {'rider': 'Sam-Bodden'}),
+#       ('1692629925791-0', {'rider': 'Prickett'}),
+#       ('1692629926436-0', {'rider': 'Norem'}),
+#       ('1692630612602-0', {'rider': 'Jones'}),
+#       ('1692630641947-0', {'rider': 'Wood'}),
+#       ('1692630648281-0', {'rider': 'Henshaw'})
+# ]
+
+r.xadd("race:italy", {"rider": "Smith"}, maxlen=2, approximate=False)
+
+res36 = r.xrange("race:italy", "-", "+")
+print(
+    res36
+)
+# >>> [
+#       ('1692630648281-0', {'rider': 'Henshaw'}),
+#       ('1692631018238-0', {'rider': 'Smith'})
+# ]
+# STEP_END
+
+# STEP_START xtrim
+res37 = r.xtrim("race:italy", maxlen=10, approximate=False)
+print(res37)  # >>> 0
+# STEP_END
+
+# STEP_START xtrim2
+res38 = r.xtrim("race:italy", maxlen=10)
+print(res38)  # >>> 0
+# STEP_END
+
+# STEP_START xdel
+res39 = r.xrange("race:italy", "-", "+")
+print(
+    res39
+)
+# >>> [
+#       ('1692630648281-0', {'rider': 'Henshaw'}),
+#       ('1692631018238-0', {'rider': 'Smith'})
+# ]
+
+res40 = r.xdel("race:italy", "1692631018238-0")
+print(res40)  # >>> 1
+
+res41 = r.xrange("race:italy", "-", "+")
+print(res41)  # >>> [('1692630648281-0', {'rider': 'Henshaw'})]
+# STEP_END
diff --git a/doctests/dt_string.py b/doctests/dt_string.py
new file mode 100644
index 0000000000..7d4cc41b89
--- /dev/null
+++ b/doctests/dt_string.py
@@ -0,0 +1,61 @@
+# EXAMPLE: set_tutorial
+# HIDE_START
+"""
+Code samples for String doc pages:
+    https://redis.io/docs/latest/develop/data-types/strings/
+"""
+
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+
+# STEP_START set_get
+res1 = r.set("bike:1", "Deimos")
+print(res1)  # True
+res2 = r.get("bike:1")
+print(res2)  # Deimos
+# STEP_END
+
+# REMOVE_START
+assert res1
+assert res2 == "Deimos"
+# REMOVE_END
+
+# STEP_START setnx_xx
+res3 = r.set("bike:1", "bike", nx=True)
+print(res3)  # None
+print(r.get("bike:1"))  # Deimos
+res4 = r.set("bike:1", "bike", xx=True)
+print(res4)  # True
+# STEP_END
+
+# REMOVE_START
+assert res3 is None
+assert res4
+# REMOVE_END
+
+# STEP_START mset
+res5 = r.mset({"bike:1": "Deimos", "bike:2": "Ares", "bike:3": "Vanth"})
+print(res5)  # True
+res6 = r.mget(["bike:1", "bike:2", "bike:3"])
+print(res6)  # ['Deimos', 'Ares', 'Vanth']
+# STEP_END
+
+# REMOVE_START
+assert res5
+assert res6 == ["Deimos", "Ares", "Vanth"]
+# REMOVE_END
+
+# STEP_START incr
+r.set("total_crashes", 0)
+res7 = r.incr("total_crashes")
+print(res7)  # 1
+res8 = r.incrby("total_crashes", 10)
+print(res8)  # 11
+# STEP_END
+
+# REMOVE_START
+assert res7 == 1
+assert res8 == 11
+# REMOVE_END
diff --git a/doctests/dt_tdigest.py b/doctests/dt_tdigest.py
new file mode 100644
index 0000000000..61124ac79b
--- /dev/null
+++ b/doctests/dt_tdigest.py
@@ -0,0 +1,81 @@
+# EXAMPLE: tdigest_tutorial
+# HIDE_START
+"""
+Code samples for t-digest pages:
+    https://redis.io/docs/latest/develop/data-types/probabilistic/t-digest/
+"""
+
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+
+# REMOVE_START
+r.delete("racer_ages")
+r.delete("bikes:sales")
+# REMOVE_END
+
+# STEP_START tdig_start
+res1 = r.tdigest().create("bikes:sales", 100)
+print(res1)  # >>> True
+
+res2 = r.tdigest().add("bikes:sales", [21])
+print(res2)  # >>> OK
+
+res3 = r.tdigest().add("bikes:sales", [150, 95, 75, 34])
+print(res3)  # >>> OK
+# STEP_END
+
+# REMOVE_START
+assert res1 is True
+# REMOVE_END
+
+# STEP_START tdig_cdf
+res4 = r.tdigest().create("racer_ages")
+print(res4)  # >>> True
+
+res5 = r.tdigest().add(
+    "racer_ages",
+    [
+        45.88,
+        44.2,
+        58.03,
+        19.76,
+        39.84,
+        69.28,
+        50.97,
+        25.41,
+        19.27,
+        85.71,
+        42.63,
+    ],
+)
+print(res5)  # >>> OK
+
+res6 = r.tdigest().rank("racer_ages", 50)
+print(res6)  # >>> [7]
+
+res7 = r.tdigest().rank("racer_ages", 50, 40)
+print(res7)  # >>> [7, 4]
+# STEP_END
+
+# STEP_START tdig_quant
+res8 = r.tdigest().quantile("racer_ages", 0.5)
+print(res8)  # >>> [44.2]
+
+res9 = r.tdigest().byrank("racer_ages", 4)
+print(res9)  # >>> [42.63]
+# STEP_END
+
+# STEP_START tdig_min
+res10 = r.tdigest().min("racer_ages")
+print(res10)  # >>> 19.27
+
+res11 = r.tdigest().max("racer_ages")
+print(res11)  # >>> 85.71
+# STEP_END
+
+# STEP_START tdig_reset
+res12 = r.tdigest().reset("racer_ages")
+print(res12)  # >>> OK
+# STEP_END
diff --git a/doctests/dt_topk.py b/doctests/dt_topk.py
new file mode 100644
index 0000000000..9767e3f265
--- /dev/null
+++ b/doctests/dt_topk.py
@@ -0,0 +1,38 @@
+# EXAMPLE: topk_tutorial
+# HIDE_START
+"""
+Code samples for Top-K pages:
+    https://redis.io/docs/latest/develop/data-types/probabilistic/top-k/
+"""
+
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+
+# REMOVE_START
+r.delete("bikes:keywords")
+# REMOVE_END
+
+# STEP_START topk
+res1 = r.topk().reserve("bikes:keywords", 5, 2000, 7, 0.925)
+print(res1)  # >>> True
+
+res2 = r.topk().add(
+    "bikes:keywords",
+    "store",
+    "seat",
+    "handlebars",
+    "handles",
+    "pedals",
+    "tires",
+    "store",
+    "seat",
+)
+print(res2)  # >>> [None, None, None, None, None, 'handlebars', None, None]
+
+res3 = r.topk().list("bikes:keywords")
+print(res3)  # >>> ['store', 'seat', 'pedals', 'tires', 'handles']
+
+res4 = r.topk().query("bikes:keywords", "store", "handlebars")
+print(res4)  # >>> [1, 0]
diff --git a/doctests/requirements.txt b/doctests/requirements.txt
new file mode 100644
index 0000000000..209d87b9c8
--- /dev/null
+++ b/doctests/requirements.txt
@@ -0,0 +1,5 @@
+numpy
+pandas
+requests
+sentence_transformers
+tabulate
diff --git a/doctests/run_examples.sh b/doctests/run_examples.sh
new file mode 100644
index 0000000000..51360639ee
--- /dev/null
+++ b/doctests/run_examples.sh
@@ -0,0 +1,15 @@
+#!/bin/sh
+
+
+basepath=`readlink -f $1`
+if [ $? -ne 0 ]; then
+basepath=`readlink -f $(dirname $0)`
+fi
+echo "No path specified, using ${basepath}"
+
+set -e
+cd ${basepath}
+for i in `ls ${basepath}/*.py`; do
+    redis-cli flushdb
+    python $i
+done
diff --git a/doctests/search_quickstart.py b/doctests/search_quickstart.py
new file mode 100644
index 0000000000..e190393b16
--- /dev/null
+++ b/doctests/search_quickstart.py
@@ -0,0 +1,425 @@
+# EXAMPLE: search_quickstart
+# HIDE_START
+"""
+Code samples for document database quickstart pages:
+    https://redis.io/docs/latest/develop/get-started/document-database/
+"""
+
+import redis
+import redis.commands.search.aggregation as aggregations
+import redis.commands.search.reducers as reducers
+from redis.commands.json.path import Path
+from redis.commands.search.field import NumericField, TagField, TextField
+from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.query import Query
+
+# HIDE_END
+
+# STEP_START connect
+r = redis.Redis(host="localhost", port=6379, db=0, decode_responses=True)
+# STEP_END
+# REMOVE_START
+try:
+    r.ft("idx:bicycle").dropindex()
+except Exception:
+    pass
+# REMOVE_END
+# STEP_START data_sample
+bicycle = {
+    "brand": "Velorim",
+    "model": "Jigger",
+    "price": 270,
+    "description": (
+        "Small and powerful, the Jigger is the best ride "
+        "for the smallest of tikes! This is the tiniest "
+        "kids’ pedal bike on the market available without"
+        " a coaster brake, the Jigger is the vehicle of "
+        "choice for the rare tenacious little rider "
+        "raring to go."
+    ),
+    "condition": "new",
+}
+# STEP_END
+
+bicycles = [
+    bicycle,
+    {
+        "brand": "Bicyk",
+        "model": "Hillcraft",
+        "price": 1200,
+        "description": (
+            "Kids want to ride with as little weight as possible."
+            " Especially on an incline! They may be at the age "
+            'when a 27.5" wheel bike is just too clumsy coming '
+            'off a 24" bike. The Hillcraft 26 is just the solution'
+            " they need!"
+        ),
+        "condition": "used",
+    },
+    {
+        "brand": "Nord",
+        "model": "Chook air 5",
+        "price": 815,
+        "description": (
+            "The Chook Air 5  gives kids aged six years and older "
+            "a durable and uberlight mountain bike for their first"
+            " experience on tracks and easy cruising through forests"
+            " and fields. The lower  top tube makes it easy to mount"
+            " and dismount in any situation, giving your kids greater"
+            " safety on the trails."
+        ),
+        "condition": "used",
+    },
+    {
+        "brand": "Eva",
+        "model": "Eva 291",
+        "price": 3400,
+        "description": (
+            "The sister company to Nord, Eva launched in 2005 as the"
+            " first and only women-dedicated bicycle brand. Designed"
+            " by women for women, allEva bikes are optimized for the"
+            " feminine physique using analytics from a body metrics"
+            " database. If you like 29ers, try the Eva 291. It’s a "
+            "brand new bike for 2022.. This full-suspension, "
+            "cross-country ride has been designed for velocity. The"
+            " 291 has 100mm of front and rear travel, a superlight "
+            "aluminum frame and fast-rolling 29-inch wheels. Yippee!"
+        ),
+        "condition": "used",
+    },
+    {
+        "brand": "Noka Bikes",
+        "model": "Kahuna",
+        "price": 3200,
+        "description": (
+            "Whether you want to try your hand at XC racing or are "
+            "looking for a lively trail bike that's just as inspiring"
+            " on the climbs as it is over rougher ground, the Wilder"
+            " is one heck of a bike built specifically for short women."
+            " Both the frames and components have been tweaked to "
+            "include a women’s saddle, different bars and unique "
+            "colourway."
+        ),
+        "condition": "used",
+    },
+    {
+        "brand": "Breakout",
+        "model": "XBN 2.1 Alloy",
+        "price": 810,
+        "description": (
+            "The XBN 2.1 Alloy is our entry-level road bike – but that’s"
+            " not to say that it’s a basic machine. With an internal "
+            "weld aluminium frame, a full carbon fork, and the slick-shifting"
+            " Claris gears from Shimano’s, this is a bike which doesn’t"
+            " break the bank and delivers craved performance."
+        ),
+        "condition": "new",
+    },
+    {
+        "brand": "ScramBikes",
+        "model": "WattBike",
+        "price": 2300,
+        "description": (
+            "The WattBike is the best e-bike for people who still feel young"
+            " at heart. It has a Bafang 1000W mid-drive system and a 48V"
+            " 17.5AH Samsung Lithium-Ion battery, allowing you to ride for"
+            " more than 60 miles on one charge. It’s great for tackling hilly"
+            " terrain or if you just fancy a more leisurely ride. With three"
+            " working modes, you can choose between E-bike, assisted bicycle,"
+            " and normal bike modes."
+        ),
+        "condition": "new",
+    },
+    {
+        "brand": "Peaknetic",
+        "model": "Secto",
+        "price": 430,
+        "description": (
+            "If you struggle with stiff fingers or a kinked neck or back after"
+            " a few minutes on the road, this lightweight, aluminum bike"
+            " alleviates those issues and allows you to enjoy the ride. From"
+            " the ergonomic grips to the lumbar-supporting seat position, the"
+            " Roll Low-Entry offers incredible comfort. The rear-inclined seat"
+            " tube facilitates stability by allowing you to put a foot on the"
+            " ground to balance at a stop, and the low step-over frame makes it"
+            " accessible for all ability and mobility levels. The saddle is"
+            " very soft, with a wide back to support your hip joints and a"
+            " cutout in the center to redistribute that pressure. Rim brakes"
+            " deliver satisfactory braking control, and the wide tires provide"
+            " a smooth, stable ride on paved roads and gravel. Rack and fender"
+            " mounts facilitate setting up the Roll Low-Entry as your preferred"
+            " commuter, and the BMX-like handlebar offers space for mounting a"
+            " flashlight, bell, or phone holder."
+        ),
+        "condition": "new",
+    },
+    {
+        "brand": "nHill",
+        "model": "Summit",
+        "price": 1200,
+        "description": (
+            "This budget mountain bike from nHill performs well both on bike"
+            " paths and on the trail. The fork with 100mm of travel absorbs"
+            " rough terrain. Fat Kenda Booster tires give you grip in corners"
+            " and on wet trails. The Shimano Tourney drivetrain offered enough"
+            " gears for finding a comfortable pace to ride uphill, and the"
+            " Tektro hydraulic disc brakes break smoothly. Whether you want an"
+            " affordable bike that you can take to work, but also take trail in"
+            " mountains on the weekends or you’re just after a stable,"
+            " comfortable ride for the bike path, the Summit gives a good value"
+            " for money."
+        ),
+        "condition": "new",
+    },
+    {
+        "model": "ThrillCycle",
+        "brand": "BikeShind",
+        "price": 815,
+        "description": (
+            "An artsy,  retro-inspired bicycle that’s as functional as it is"
+            " pretty: The ThrillCycle steel frame offers a smooth ride. A"
+            " 9-speed drivetrain has enough gears for coasting in the city, but"
+            " we wouldn’t suggest taking it to the mountains. Fenders protect"
+            " you from mud, and a rear basket lets you transport groceries,"
+            " flowers and books. The ThrillCycle comes with a limited lifetime"
+            " warranty, so this little guy will last you long past graduation."
+        ),
+        "condition": "refurbished",
+    },
+]
+
+# STEP_START create_index
+schema = (
+    TextField("$.brand", as_name="brand"),
+    TextField("$.model", as_name="model"),
+    TextField("$.description", as_name="description"),
+    NumericField("$.price", as_name="price"),
+    TagField("$.condition", as_name="condition"),
+)
+
+index = r.ft("idx:bicycle")
+index.create_index(
+    schema,
+    definition=IndexDefinition(prefix=["bicycle:"], index_type=IndexType.JSON),
+)
+# STEP_END
+# STEP_START add_documents
+for bid, bicycle in enumerate(bicycles):
+    r.json().set(f"bicycle:{bid}", Path.root_path(), bicycle)
+# STEP_END
+
+
+# STEP_START wildcard_query
+res = index.search(Query("*"))
+print("Documents found:", res.total)
+# >>> Documents found: 10
+# STEP_END
+# REMOVE_START
+assert res.total == 10
+# REMOVE_END
+
+# STEP_START query_single_term
+res = index.search(Query("@model:Jigger"))
+print(res)
+# >>> Result{1 total, docs: [
+# Document {
+#   'id': 'bicycle:0',
+#   'payload': None,
+#   'json': '{
+#       "brand":"Velorim",
+#       "model":"Jigger",
+#       "price":270,
+#       ...
+#       "condition":"new"
+#    }'
+# }]}
+# STEP_END
+# REMOVE_START
+assert res.docs[0].id == "bicycle:0"
+# REMOVE_END
+
+# STEP_START query_single_term_limit_fields
+res = index.search(Query("@model:Jigger").return_field("$.price", as_field="price"))
+print(res)
+# >>> [Document {'id': 'bicycle:0', 'payload': None, 'price': '270'}]
+# STEP_END
+# REMOVE_START
+assert res.docs[0].id == "bicycle:0"
+# REMOVE_END
+
+# STEP_START query_single_term_and_num_range
+res = index.search(Query("basic @price:[500 1000]"))
+print(res)
+# >>> Result{1 total, docs: [
+# Document {
+#   'id': 'bicycle:5',
+#   'payload': None,
+#   'json': '{
+#       "brand":"Breakout",
+#       "model":"XBN 2.1 Alloy",
+#       "price":810,
+#       ...
+#       "condition":"new"
+#    }'
+# }]}
+# STEP_END
+# REMOVE_START
+assert res.docs[0].id == "bicycle:5"
+# REMOVE_END
+
+# STEP_START query_exact_matching
+res = index.search(Query('@brand:"Noka Bikes"'))
+print(res)
+# >>> Result{1 total, docs: [
+# Document {
+#   'id': 'bicycle:4',
+#   'payload': None,
+#   'json': '{
+#       "brand":"Noka Bikes",
+#       "model":"Kahuna",
+#       "price":3200,
+#       ...
+#       "condition":"used"
+#    }'
+# }]}
+# STEP_END
+# REMOVE_START
+assert res.docs[0].id == "bicycle:4"
+# REMOVE_END
+
+# STEP_START query_fuzzy_matching
+res = index.search(
+    Query("@description:%analitics%").dialect(  # Note the typo in the word "analytics"
+        2
+    )
+)
+print(res)
+# >>> Result{1 total, docs: [
+# Document {
+#   'id': 'bicycle:3',
+#   'payload': None,
+#   'json': '{
+#       "brand":"Eva",
+#       "model":"Eva 291",
+#       "price":3400,
+#       "description":"...using analytics from a body metrics database...",
+#       "condition":"used"
+#    }'
+# }]}
+# STEP_END
+# REMOVE_START
+assert res.docs[0].id == "bicycle:3"
+# REMOVE_END
+
+# STEP_START query_fuzzy_matching_level2
+res = index.search(
+    Query("@description:%%analitycs%%").dialect(  # Note 2 typos in the word "analytics"
+        2
+    )
+)
+print(res)
+# >>> Result{1 total, docs: [
+# Document {
+#   'id': 'bicycle:3',
+#   'payload': None,
+#   'json': '{
+#       "brand":"Eva",
+#       "model":"Eva 291",
+#       "price":3400,
+#       "description":"...using analytics from a body metrics database...",
+#       "condition":"used"
+#    }'
+# }]}
+# STEP_END
+# REMOVE_START
+assert res.docs[0].id == "bicycle:3"
+# REMOVE_END
+
+# STEP_START query_prefix_matching
+res = index.search(Query("@model:hill*"))
+print(res)
+# >>> Result{1 total, docs: [
+# Document {
+#   'id': 'bicycle:1',
+#   'payload': None,
+#   'json': '{
+#       "brand":"Bicyk",
+#       "model":"Hillcraft",
+#       "price":1200,
+#       ...
+#       "condition":"used"
+#    }'
+# }]}
+# STEP_END
+# REMOVE_START
+assert res.docs[0].id == "bicycle:1"
+# REMOVE_END
+
+# STEP_START query_suffix_matching
+res = index.search(Query("@model:*bike"))
+print(res)
+# >>> Result{1 total, docs: [
+# Document {
+#   'id': 'bicycle:6',
+#   'payload': None,
+#   'json': '{
+#       "brand":"ScramBikes",
+#       "model":"WattBike",
+#       "price":2300,
+#       ...
+#       "condition":"new"
+#   }'
+# }]}
+# STEP_END
+# REMOVE_START
+assert res.docs[0].id == "bicycle:6"
+# REMOVE_END
+
+# STEP_START query_wildcard_matching
+res = index.search(Query("w'H?*craft'").dialect(2))
+print(res.docs[0].json)
+# >>> {
+#   "brand":"Bicyk",
+#   "model":"Hillcraft",
+#   "price":1200,
+#   ...
+#   "condition":"used"
+# }
+# STEP_END
+# REMOVE_START
+assert res.docs[0].id == "bicycle:1"
+# REMOVE_END
+
+
+# STEP_START query_with_default_scorer
+res = index.search(Query("mountain").with_scores())
+for sr in res.docs:
+    print(f"{sr.id}: score={sr.score}")
+# STEP_END
+# REMOVE_START
+assert res.total == 3
+# REMOVE_END
+
+# STEP_START query_with_bm25_scorer
+res = index.search(Query("mountain").with_scores().scorer("BM25"))
+for sr in res.docs:
+    print(f"{sr.id}: score={sr.score}")
+# STEP_END
+# REMOVE_START
+assert res.total == 3
+assert res.docs[0].score == res.docs[1].score
+# REMOVE_END
+
+# STEP_START simple_aggregation
+req = aggregations.AggregateRequest("*").group_by(
+    "@condition", reducers.count().alias("count")
+)
+res = index.aggregate(req).rows
+print(res)
+# >>> [['condition', 'refurbished', 'count', '1'],
+#      ['condition', 'used', 'count', '4'],
+#      ['condition', 'new', 'count', '5']]
+# STEP_END
+# REMOVE_START
+assert len(res) == 3
+# REMOVE_END
diff --git a/doctests/search_vss.py b/doctests/search_vss.py
new file mode 100644
index 0000000000..8b4884727a
--- /dev/null
+++ b/doctests/search_vss.py
@@ -0,0 +1,347 @@
+# EXAMPLE: search_vss
+# HIDE_START
+"""
+Code samples for vector database quickstart pages:
+    https://redis.io/docs/latest/develop/get-started/vector-database/
+"""
+# HIDE_END
+
+# STEP_START imports
+import json
+import time
+
+import numpy as np
+import pandas as pd
+import requests
+import redis
+from redis.commands.search.field import (
+    NumericField,
+    TagField,
+    TextField,
+    VectorField,
+)
+from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.query import Query
+from sentence_transformers import SentenceTransformer
+
+# STEP_END
+
+# STEP_START get_data
+URL = ("https://raw.githubusercontent.com/bsbodden/redis_vss_getting_started"
+       "/main/data/bikes.json"
+       )
+response = requests.get(URL, timeout=10)
+bikes = response.json()
+# STEP_END
+# REMOVE_START
+assert bikes[0]["model"] == "Jigger"
+# REMOVE_END
+
+# STEP_START dump_data
+json.dumps(bikes[0], indent=2)
+# STEP_END
+
+# STEP_START connect
+client = redis.Redis(host="localhost", port=6379, decode_responses=True)
+# STEP_END
+
+# STEP_START connection_test
+res = client.ping()
+# >>> True
+# STEP_END
+# REMOVE_START
+assert res
+# REMOVE_END
+
+# STEP_START load_data
+pipeline = client.pipeline()
+for i, bike in enumerate(bikes, start=1):
+    redis_key = f"bikes:{i:03}"
+    pipeline.json().set(redis_key, "$", bike)
+res = pipeline.execute()
+# >>> [True, True, True, True, True, True, True, True, True, True, True]
+# STEP_END
+# REMOVE_START
+assert res == [True, True, True, True, True, True, True, True, True, True, True]
+# REMOVE_END
+
+# STEP_START get
+res = client.json().get("bikes:010", "$.model")
+# >>> ['Summit']
+# STEP_END
+# REMOVE_START
+assert res == ["Summit"]
+# REMOVE_END
+
+# STEP_START get_keys
+keys = sorted(client.keys("bikes:*"))
+# >>> ['bikes:001', 'bikes:002', ..., 'bikes:011']
+# STEP_END
+# REMOVE_START
+assert keys[0] == "bikes:001"
+# REMOVE_END
+
+# STEP_START generate_embeddings
+descriptions = client.json().mget(keys, "$.description")
+descriptions = [item for sublist in descriptions for item in sublist]
+embedder = SentenceTransformer("msmarco-distilbert-base-v4")
+embeddings = embedder.encode(descriptions).astype(np.float32).tolist()
+VECTOR_DIMENSION = len(embeddings[0])
+# >>> 768
+# STEP_END
+# REMOVE_START
+assert VECTOR_DIMENSION == 768
+# REMOVE_END
+
+# STEP_START load_embeddings
+pipeline = client.pipeline()
+for key, embedding in zip(keys, embeddings):
+    pipeline.json().set(key, "$.description_embeddings", embedding)
+pipeline.execute()
+# >>> [True, True, True, True, True, True, True, True, True, True, True]
+# STEP_END
+
+# STEP_START dump_example
+res = client.json().get("bikes:010")
+# >>>
+# {
+#   "model": "Summit",
+#   "brand": "nHill",
+#   "price": 1200,
+#   "type": "Mountain Bike",
+#   "specs": {
+#     "material": "alloy",
+#     "weight": "11.3"
+#   },
+#   "description": "This budget mountain bike from nHill performs well..."
+#   "description_embeddings": [
+#     -0.538114607334137,
+#     -0.49465855956077576,
+#     -0.025176964700222015,
+#     ...
+#   ]
+# }
+# STEP_END
+# REMOVE_START
+assert len(res["description_embeddings"]) == 768
+# REMOVE_END
+
+# STEP_START create_index
+schema = (
+    TextField("$.model", no_stem=True, as_name="model"),
+    TextField("$.brand", no_stem=True, as_name="brand"),
+    NumericField("$.price", as_name="price"),
+    TagField("$.type", as_name="type"),
+    TextField("$.description", as_name="description"),
+    VectorField(
+        "$.description_embeddings",
+        "FLAT",
+        {
+            "TYPE": "FLOAT32",
+            "DIM": VECTOR_DIMENSION,
+            "DISTANCE_METRIC": "COSINE",
+        },
+        as_name="vector",
+    ),
+)
+definition = IndexDefinition(prefix=["bikes:"], index_type=IndexType.JSON)
+res = client.ft("idx:bikes_vss").create_index(fields=schema, definition=definition)
+# >>> 'OK'
+# STEP_END
+# REMOVE_START
+assert res == "OK"
+time.sleep(2)
+# REMOVE_END
+
+# STEP_START validate_index
+info = client.ft("idx:bikes_vss").info()
+num_docs = info["num_docs"]
+indexing_failures = info["hash_indexing_failures"]
+# print(f"{num_docs} documents indexed with {indexing_failures} failures")
+# >>> 11 documents indexed with 0 failures
+# STEP_END
+# REMOVE_START
+assert (num_docs == "11") and (indexing_failures == "0")
+# REMOVE_END
+
+# STEP_START simple_query_1
+query = Query("@brand:Peaknetic")
+res = client.ft("idx:bikes_vss").search(query).docs
+# print(res)
+# >>> [
+#       Document {
+#           'id': 'bikes:008',
+#           'payload': None,
+#           'brand': 'Peaknetic',
+#           'model': 'Soothe Electric bike',
+#           'price': '1950', 'description_embeddings': ...
+# STEP_END
+# REMOVE_START
+
+assert all(
+    item in [x.__dict__["id"] for x in res] for item in ["bikes:008", "bikes:009"]
+)
+# REMOVE_END
+
+# STEP_START simple_query_2
+query = Query("@brand:Peaknetic").return_fields("id", "brand", "model", "price")
+res = client.ft("idx:bikes_vss").search(query).docs
+# print(res)
+# >>> [
+#       Document {
+#           'id': 'bikes:008',
+#           'payload': None,
+#           'brand': 'Peaknetic',
+#           'model': 'Soothe Electric bike',
+#           'price': '1950'
+#       },
+#       Document {
+#           'id': 'bikes:009',
+#           'payload': None,
+#           'brand': 'Peaknetic',
+#           'model': 'Secto',
+#           'price': '430'
+#       }
+# ]
+# STEP_END
+# REMOVE_START
+assert all(
+    item in [x.__dict__["id"] for x in res] for item in ["bikes:008", "bikes:009"]
+)
+# REMOVE_END
+
+# STEP_START simple_query_3
+query = Query("@brand:Peaknetic @price:[0 1000]").return_fields(
+    "id", "brand", "model", "price"
+)
+res = client.ft("idx:bikes_vss").search(query).docs
+# print(res)
+# >>> [
+#       Document {
+#           'id': 'bikes:009',
+#           'payload': None,
+#           'brand': 'Peaknetic',
+#           'model': 'Secto',
+#           'price': '430'
+#       }
+# ]
+# STEP_END
+# REMOVE_START
+assert all(item in [x.__dict__["id"] for x in res] for item in ["bikes:009"])
+# REMOVE_END
+
+# STEP_START def_bulk_queries
+queries = [
+    "Bike for small kids",
+    "Best Mountain bikes for kids",
+    "Cheap Mountain bike for kids",
+    "Female specific mountain bike",
+    "Road bike for beginners",
+    "Commuter bike for people over 60",
+    "Comfortable commuter bike",
+    "Good bike for college students",
+    "Mountain bike for beginners",
+    "Vintage bike",
+    "Comfortable city bike",
+]
+# STEP_END
+
+# STEP_START enc_bulk_queries
+encoded_queries = embedder.encode(queries)
+len(encoded_queries)
+# >>> 11
+# STEP_END
+# REMOVE_START
+assert len(encoded_queries) == 11
+# REMOVE_END
+
+
+# STEP_START define_bulk_query
+def create_query_table(query, queries, encoded_queries, extra_params=None):
+    """
+    Creates a query table.
+    """
+    results_list = []
+    for i, encoded_query in enumerate(encoded_queries):
+        result_docs = (
+            client.ft("idx:bikes_vss")
+            .search(
+                query,
+                {"query_vector": np.array(encoded_query, dtype=np.float32).tobytes()}
+                | (extra_params if extra_params else {}),
+            )
+            .docs
+        )
+        for doc in result_docs:
+            vector_score = round(1 - float(doc.vector_score), 2)
+            results_list.append(
+                {
+                    "query": queries[i],
+                    "score": vector_score,
+                    "id": doc.id,
+                    "brand": doc.brand,
+                    "model": doc.model,
+                    "description": doc.description,
+                }
+            )
+
+    # Optional: convert the table to Markdown using Pandas
+    queries_table = pd.DataFrame(results_list)
+    queries_table.sort_values(
+        by=["query", "score"], ascending=[True, False], inplace=True
+    )
+    queries_table["query"] = queries_table.groupby("query")["query"].transform(
+        lambda x: [x.iloc[0]] + [""] * (len(x) - 1)
+    )
+    queries_table["description"] = queries_table["description"].apply(
+        lambda x: (x[:497] + "...") if len(x) > 500 else x
+    )
+    return queries_table.to_markdown(index=False)
+
+
+# STEP_END
+
+# STEP_START run_knn_query
+query = (
+    Query("(*)=>[KNN 3 @vector $query_vector AS vector_score]")
+    .sort_by("vector_score")
+    .return_fields("vector_score", "id", "brand", "model", "description")
+    .dialect(2)
+)
+
+table = create_query_table(query, queries, encoded_queries)
+print(table)
+# >>> | Best Mountain bikes for kids     |    0.54 | bikes:003...
+# STEP_END
+
+# STEP_START run_hybrid_query
+hybrid_query = (
+    Query("(@brand:Peaknetic)=>[KNN 3 @vector $query_vector AS vector_score]")
+    .sort_by("vector_score")
+    .return_fields("vector_score", "id", "brand", "model", "description")
+    .dialect(2)
+)
+table = create_query_table(hybrid_query, queries, encoded_queries)
+print(table)
+# >>> | Best Mountain bikes for kids     |    0.3  | bikes:008...
+# STEP_END
+
+# STEP_START run_range_query
+range_query = (
+    Query(
+        "@vector:[VECTOR_RANGE $range $query_vector]=>"
+        "{$YIELD_DISTANCE_AS: vector_score}"
+    )
+    .sort_by("vector_score")
+    .return_fields("vector_score", "id", "brand", "model", "description")
+    .paging(0, 4)
+    .dialect(2)
+)
+table = create_query_table(
+    range_query, queries[:1],
+    encoded_queries[:1],
+    {"range": 0.55}
+)
+print(table)
+# >>> | Bike for small kids |    0.52 | bikes:001 | Velorim    |...
+# STEP_END
diff --git a/doctests/string_set_get.py b/doctests/string_set_get.py
new file mode 100644
index 0000000000..d5f260c281
--- /dev/null
+++ b/doctests/string_set_get.py
@@ -0,0 +1,25 @@
+# EXAMPLE: set_and_get
+# HIDE_START
+"""
+Code samples for data structure store quickstart pages:
+    https://redis.io/docs/latest/develop/get-started/data-store/
+"""
+
+import redis
+
+r = redis.Redis(host="localhost", port=6379, db=0, decode_responses=True)
+# HIDE_END
+
+res = r.set("bike:1", "Process 134")
+print(res)
+# >>> True
+# REMOVE_START
+assert res
+# REMOVE_END
+
+res = r.get("bike:1")
+print(res)
+# >>> "Process 134"
+# REMOVE_START
+assert res == "Process 134"
+# REMOVE_END

From 93ae56ae01c6e389aec8eb0f9ade177876e0bf6f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 13 Jun 2024 13:05:15 +0300
Subject: [PATCH 0891/1164] Bump rojopolis/spellcheck-github-actions from
 0.36.0 to 0.37.0 (#3260)

Bumps [rojopolis/spellcheck-github-actions](https://github.com/rojopolis/spellcheck-github-actions) from 0.36.0 to 0.37.0.
- [Release notes](https://github.com/rojopolis/spellcheck-github-actions/releases)
- [Changelog](https://github.com/rojopolis/spellcheck-github-actions/blob/master/CHANGELOG.md)
- [Commits](https://github.com/rojopolis/spellcheck-github-actions/compare/0.36.0...0.37.0)

---
updated-dependencies:
- dependency-name: rojopolis/spellcheck-github-actions
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/spellcheck.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/spellcheck.yml b/.github/workflows/spellcheck.yml
index f739a54242..451e508376 100644
--- a/.github/workflows/spellcheck.yml
+++ b/.github/workflows/spellcheck.yml
@@ -8,7 +8,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
       - name: Check Spelling
-        uses: rojopolis/spellcheck-github-actions@0.36.0
+        uses: rojopolis/spellcheck-github-actions@0.37.0
         with:
           config_path: .github/spellcheck-settings.yml
           task_name: Markdown

From 69d9606c36260771f42c2a2bdcf2432fa91e92b7 Mon Sep 17 00:00:00 2001
From: Binbin <binloveplay1314@qq.com>
Date: Fri, 14 Jun 2024 14:08:02 +0800
Subject: [PATCH 0892/1164] Add missing asserts in json tests (#3261)

Fix some some statements with missing asserts.
---
 tests/test_asyncio/test_json.py | 23 +++++++++---------
 tests/test_json.py              | 43 +++++++++++++++++----------------
 2 files changed, 34 insertions(+), 32 deletions(-)

diff --git a/tests/test_asyncio/test_json.py b/tests/test_asyncio/test_json.py
index c713f1aca2..cc98a55323 100644
--- a/tests/test_asyncio/test_json.py
+++ b/tests/test_asyncio/test_json.py
@@ -103,7 +103,7 @@ async def test_jsonsetexistentialmodifiersshouldsucceed(decoded_r: redis.Redis):
     assert await decoded_r.json().set("obj", Path("foo"), "baz", xx=True)
     assert await decoded_r.json().set("obj", Path("qaz"), "baz", nx=True)
 
-    # Test that flags are mutually exlusive
+    # Test that flags are mutually exclusive
     with pytest.raises(Exception):
         await decoded_r.json().set("obj", Path("foo"), "baz", nx=True, xx=True)
 
@@ -483,7 +483,7 @@ async def test_json_mget_dollar(decoded_r: redis.Redis):
     )
 
     # Test mget with single path
-    await decoded_r.json().mget("doc1", "$..a") == [1, 3, None]
+    assert await decoded_r.json().mget(["doc1"], "$..a") == [[1, 3, None]]
     # Test mget with multi path
     res = await decoded_r.json().mget(["doc1", "doc2"], "$..a")
     assert res == [[1, 3, None], [4, 6, [None]]]
@@ -539,7 +539,7 @@ async def test_numby_commands_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1", "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]}
     )
-    await decoded_r.json().numincrby("doc1", ".b[0].a", 3) == 5
+    assert await decoded_r.json().numincrby("doc1", ".b[0].a", 3) == 5
 
     # Test legacy NUMMULTBY
     await decoded_r.json().set(
@@ -547,7 +547,7 @@ async def test_numby_commands_dollar(decoded_r: redis.Redis):
     )
 
     with pytest.deprecated_call():
-        await decoded_r.json().nummultby("doc1", ".b[0].a", 3) == 6
+        assert await decoded_r.json().nummultby("doc1", ".b[0].a", 3) == 6
 
 
 @pytest.mark.redismod
@@ -556,13 +556,13 @@ async def test_strappend_dollar(decoded_r: redis.Redis):
         "doc1", "$", {"a": "foo", "nested1": {"a": "hello"}, "nested2": {"a": 31}}
     )
     # Test multi
-    await decoded_r.json().strappend("doc1", "bar", "$..a") == [6, 8, None]
+    assert await decoded_r.json().strappend("doc1", "bar", "$..a") == [6, 8, None]
 
     res = [{"a": "foobar", "nested1": {"a": "hellobar"}, "nested2": {"a": 31}}]
     assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
 
     # Test single
-    await decoded_r.json().strappend("doc1", "baz", "$.nested1.a") == [11]
+    assert await decoded_r.json().strappend("doc1", "baz", "$.nested1.a") == [11]
 
     res = [{"a": "foobar", "nested1": {"a": "hellobarbaz"}, "nested2": {"a": 31}}]
     assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
@@ -572,7 +572,7 @@ async def test_strappend_dollar(decoded_r: redis.Redis):
         await decoded_r.json().strappend("non_existing_doc", "$..a", "err")
 
     # Test multi
-    await decoded_r.json().strappend("doc1", "bar", ".*.a") == 8
+    assert await decoded_r.json().strappend("doc1", "bar", ".*.a") == 14
     res = [{"a": "foobar", "nested1": {"a": "hellobarbazbar"}, "nested2": {"a": 31}}]
     assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
 
@@ -594,8 +594,8 @@ async def test_strlen_dollar(decoded_r: redis.Redis):
     assert res1 == res2
 
     # Test single
-    await decoded_r.json().strlen("doc1", "$.nested1.a") == [8]
-    await decoded_r.json().strlen("doc1", "$.nested2.a") == [None]
+    assert await decoded_r.json().strlen("doc1", "$.nested1.a") == [8]
+    assert await decoded_r.json().strlen("doc1", "$.nested2.a") == [None]
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -614,7 +614,8 @@ async def test_arrappend_dollar(decoded_r: redis.Redis):
         },
     )
     # Test multi
-    await decoded_r.json().arrappend("doc1", "$..a", "bar", "racuda") == [3, 5, None]
+    res = [3, 5, None]
+    assert await decoded_r.json().arrappend("doc1", "$..a", "bar", "racuda") == res
     res = [
         {
             "a": ["foo", "bar", "racuda"],
@@ -794,7 +795,7 @@ async def test_arrpop_dollar(decoded_r: redis.Redis):
         },
     )
     # Test multi (all paths are updated, but return result of last path)
-    await decoded_r.json().arrpop("doc1", "..a", "1") is None
+    assert await decoded_r.json().arrpop("doc1", "..a", "1") == "null"
     res = [{"a": [], "nested1": {"a": ["hello", "world"]}, "nested2": {"a": 31}}]
     assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
 
diff --git a/tests/test_json.py b/tests/test_json.py
index 5cf9b11e17..9996c898d4 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -104,7 +104,7 @@ def test_jsonsetexistentialmodifiersshouldsucceed(client):
     assert client.json().set("obj", Path("foo"), "baz", xx=True)
     assert client.json().set("obj", Path("qaz"), "baz", nx=True)
 
-    # Test that flags are mutually exlusive
+    # Test that flags are mutually exclusive
     with pytest.raises(Exception):
         client.json().set("obj", Path("foo"), "baz", nx=True, xx=True)
 
@@ -453,6 +453,7 @@ def test_json_forget_with_dollar(client):
     client.json().forget("not_a_document", "..a")
 
 
+@pytest.mark.onlynoncluster
 @pytest.mark.redismod
 def test_json_mget_dollar(client):
     # Test mget with multi paths
@@ -473,14 +474,14 @@ def test_json_mget_dollar(client):
     assert_resp_response(client, client.json().get("doc2", "$..a"), res, [res])
 
     # Test mget with single path
-    client.json().mget("doc1", "$..a") == [1, 3, None]
+    assert client.json().mget(["doc1"], "$..a") == [[1, 3, None]]
     # Test mget with multi path
-    client.json().mget(["doc1", "doc2"], "$..a") == [[1, 3, None], [4, 6, [None]]]
+    res = [[1, 3, None], [4, 6, [None]]]
+    assert client.json().mget(["doc1", "doc2"], "$..a") == res
 
     # Test missing key
-    client.json().mget(["doc1", "missing_doc"], "$..a") == [[1, 3, None], None]
-    res = client.json().mget(["missing_doc1", "missing_doc2"], "$..a")
-    assert res == [None, None]
+    assert client.json().mget(["doc1", "missing_doc"], "$..a") == [[1, 3, None], None]
+    assert client.json().mget(["missing_doc1", "missing_doc2"], "$..a") == [None, None]
 
 
 @pytest.mark.redismod
@@ -518,13 +519,13 @@ def test_numby_commands_dollar(client):
 
     # Test legacy NUMINCRBY
     client.json().set("doc1", "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]})
-    client.json().numincrby("doc1", ".b[0].a", 3) == 5
+    assert client.json().numincrby("doc1", ".b[0].a", 3) == 5
 
     # Test legacy NUMMULTBY
     client.json().set("doc1", "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]})
 
     with pytest.deprecated_call():
-        client.json().nummultby("doc1", ".b[0].a", 3) == 6
+        assert client.json().nummultby("doc1", ".b[0].a", 3) == 6
 
 
 @pytest.mark.redismod
@@ -533,25 +534,25 @@ def test_strappend_dollar(client):
         "doc1", "$", {"a": "foo", "nested1": {"a": "hello"}, "nested2": {"a": 31}}
     )
     # Test multi
-    client.json().strappend("doc1", "bar", "$..a") == [6, 8, None]
+    assert client.json().strappend("doc1", "bar", "$..a") == [6, 8, None]
 
-    # res = [{"a": "foobar", "nested1": {"a": "hellobar"}, "nested2": {"a": 31}}]
-    # assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    res = [{"a": "foobar", "nested1": {"a": "hellobar"}, "nested2": {"a": 31}}]
+    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
 
     # Test single
-    client.json().strappend("doc1", "baz", "$.nested1.a") == [11]
+    assert client.json().strappend("doc1", "baz", "$.nested1.a") == [11]
 
-    # res = [{"a": "foobar", "nested1": {"a": "hellobarbaz"}, "nested2": {"a": 31}}]
-    # assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    res = [{"a": "foobar", "nested1": {"a": "hellobarbaz"}, "nested2": {"a": 31}}]
+    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
         client.json().strappend("non_existing_doc", "$..a", "err")
 
     # Test multi
-    client.json().strappend("doc1", "bar", ".*.a") == 8
-    # res = [{"a": "foo", "nested1": {"a": "hellobar"}, "nested2": {"a": 31}}]
-    # assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    assert client.json().strappend("doc1", "bar", ".*.a") == 14
+    res = [{"a": "foobar", "nested1": {"a": "hellobarbazbar"}, "nested2": {"a": 31}}]
+    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
 
     # Test missing path
     with pytest.raises(exceptions.ResponseError):
@@ -571,8 +572,8 @@ def test_strlen_dollar(client):
     assert res1 == res2
 
     # Test single
-    client.json().strlen("doc1", "$.nested1.a") == [8]
-    client.json().strlen("doc1", "$.nested2.a") == [None]
+    assert client.json().strlen("doc1", "$.nested1.a") == [8]
+    assert client.json().strlen("doc1", "$.nested2.a") == [None]
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -591,7 +592,7 @@ def test_arrappend_dollar(client):
         },
     )
     # Test multi
-    client.json().arrappend("doc1", "$..a", "bar", "racuda") == [3, 5, None]
+    assert client.json().arrappend("doc1", "$..a", "bar", "racuda") == [3, 5, None]
     res = [
         {
             "a": ["foo", "bar", "racuda"],
@@ -775,7 +776,7 @@ def test_arrpop_dollar(client):
         },
     )
     # Test multi (all paths are updated, but return result of last path)
-    client.json().arrpop("doc1", "..a", "1") is None
+    assert client.json().arrpop("doc1", "..a", "1") == "null"
     res = [{"a": [], "nested1": {"a": ["hello", "world"]}, "nested2": {"a": 31}}]
     assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
 

From 9ae3d977fd962a9348bb0c78f92db9ab1655534b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 14 Jun 2024 09:09:05 +0300
Subject: [PATCH 0893/1164] Bump actions/stale from 3 to 9 (#3170)

Bumps [actions/stale](https://github.com/actions/stale) from 3 to 9.
- [Release notes](https://github.com/actions/stale/releases)
- [Changelog](https://github.com/actions/stale/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/stale/compare/v3...v9)

---
updated-dependencies:
- dependency-name: actions/stale
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/stale-issues.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/stale-issues.yml b/.github/workflows/stale-issues.yml
index 32fd9e8179..445af1c818 100644
--- a/.github/workflows/stale-issues.yml
+++ b/.github/workflows/stale-issues.yml
@@ -12,7 +12,7 @@ jobs:
 
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/stale@v3
+    - uses: actions/stale@v9
       with:
         repo-token: ${{ secrets.GITHUB_TOKEN }}
         stale-issue-message: 'This issue is marked stale. It will be closed in 30 days if it is not updated.'

From 893efc30b6f1d321e38d058657b757b1ec17aa99 Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@redis.com>
Date: Fri, 14 Jun 2024 11:19:04 +0300
Subject: [PATCH 0894/1164] Handle lists in the response of INFO (#3278)

Parse lists in the response of INFO, and even lines where list items are
mixed with key=value items, in which case the overall structure will be
a dict, and the items without value get `True` as their value.
---
 redis/_parsers/helpers.py          | 11 +++++++++--
 tests/test_parsers/test_helpers.py | 28 ++++++++++++++++++++++++++++
 2 files changed, 37 insertions(+), 2 deletions(-)

diff --git a/redis/_parsers/helpers.py b/redis/_parsers/helpers.py
index 57b12ab89e..56d912c157 100644
--- a/redis/_parsers/helpers.py
+++ b/redis/_parsers/helpers.py
@@ -46,11 +46,18 @@ def get_value(value):
                     return int(value)
             except ValueError:
                 return value
+        elif "=" not in value:
+            return [get_value(v) for v in value.split(",") if v]
         else:
             sub_dict = {}
             for item in value.split(","):
-                k, v = item.rsplit("=", 1)
-                sub_dict[k] = get_value(v)
+                if not item:
+                    continue
+                if "=" in item:
+                    k, v = item.rsplit("=", 1)
+                    sub_dict[k] = get_value(v)
+                else:
+                    sub_dict[item] = True
             return sub_dict
 
     for line in response.splitlines():
diff --git a/tests/test_parsers/test_helpers.py b/tests/test_parsers/test_helpers.py
index 6430a237f6..383b9de794 100644
--- a/tests/test_parsers/test_helpers.py
+++ b/tests/test_parsers/test_helpers.py
@@ -33,3 +33,31 @@ def test_parse_info():
     assert info["search_version"] == "99.99.99"
     assert info["search_redis_version"] == "7.2.2 - oss"
     assert info["search_query_timeout_ms"] == 500
+
+
+def test_parse_info_list():
+    info_output = """
+list_one:a,
+list_two:a b,,c,10,1.1
+    """
+    info = parse_info(info_output)
+
+    assert isinstance(info["list_one"], list)
+    assert info["list_one"] == ["a"]
+
+    assert isinstance(info["list_two"], list)
+    assert info["list_two"] == ["a b", "c", 10, 1.1]
+
+
+def test_parse_info_list_dict_mixed():
+    info_output = """
+list_one:a,b=1
+list_two:a b=foo,,c,d=bar,e,
+    """
+    info = parse_info(info_output)
+
+    assert isinstance(info["list_one"], dict)
+    assert info["list_one"] == {"a": True, "b": 1}
+
+    assert isinstance(info["list_two"], dict)
+    assert info["list_two"] == {"a b": "foo", "c": True, "d": "bar", "e": True}

From 87696012cb9e34150535036afd081e9abe247f57 Mon Sep 17 00:00:00 2001
From: andy-stark-redis <164213578+andy-stark-redis@users.noreply.github.com>
Date: Tue, 18 Jun 2024 13:11:15 +0100
Subject: [PATCH 0895/1164] Small fixes to comments (#3280)

Small fixed to doctests.
---
 doctests/dt_json.py | 1 -
 doctests/dt_set.py  | 2 +-
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/doctests/dt_json.py b/doctests/dt_json.py
index f7c2226048..ad0d427ef6 100644
--- a/doctests/dt_json.py
+++ b/doctests/dt_json.py
@@ -284,7 +284,6 @@
 # REMOVE_END
 
 # STEP_START filter2
-#  names of bikes made from an alloy
 res9 = r.json().get("bikes:inventory", "$..[?(@.specs.material == 'alloy')].model")
 print(res9)  # >>> ['Weywot', 'Mimas']
 # STEP_END
diff --git a/doctests/dt_set.py b/doctests/dt_set.py
index bcc7ba934f..8ac22fe1de 100644
--- a/doctests/dt_set.py
+++ b/doctests/dt_set.py
@@ -44,7 +44,7 @@
 print(res5)  # >>> 1
 
 res6 = r.sismember("bikes:racing:usa", "bike:2")
-print(res6)  # >>> 1
+print(res6)  # >>> 0
 # STEP_END
 
 # REMOVE_START

From 017f76787a3480243b21a0a1b9d3437f9f629e8f Mon Sep 17 00:00:00 2001
From: Zhongsheng Ji <9573586@qq.com>
Date: Tue, 18 Jun 2024 22:48:22 +0800
Subject: [PATCH 0896/1164] Improve parsing of XINFO STREAM response (#3282)

Make the parsing of XINFO STREAM response more resilient, by
handling the case when first and last entries are None after XTRIM.

Improve the parsing of consumers related info.
---
 redis/_parsers/helpers.py           | 11 ++++++++---
 tests/test_asyncio/test_commands.py | 25 +++++++++++++++++++++++++
 tests/test_commands.py              | 16 +++++++++++++++-
 3 files changed, 48 insertions(+), 4 deletions(-)

diff --git a/redis/_parsers/helpers.py b/redis/_parsers/helpers.py
index 56d912c157..2341c92d8a 100644
--- a/redis/_parsers/helpers.py
+++ b/redis/_parsers/helpers.py
@@ -275,17 +275,22 @@ def parse_xinfo_stream(response, **options):
         data = {str_if_bytes(k): v for k, v in response.items()}
     if not options.get("full", False):
         first = data.get("first-entry")
-        if first is not None:
+        if first is not None and first[0] is not None:
             data["first-entry"] = (first[0], pairs_to_dict(first[1]))
         last = data["last-entry"]
-        if last is not None:
+        if last is not None and last[0] is not None:
             data["last-entry"] = (last[0], pairs_to_dict(last[1]))
     else:
         data["entries"] = {_id: pairs_to_dict(entry) for _id, entry in data["entries"]}
-        if isinstance(data["groups"][0], list):
+        if len(data["groups"]) > 0 and isinstance(data["groups"][0], list):
             data["groups"] = [
                 pairs_to_dict(group, decode_keys=True) for group in data["groups"]
             ]
+            for g in data["groups"]:
+                if g["consumers"] and g["consumers"][0] is not None:
+                    g["consumers"] = [
+                        pairs_to_dict(c, decode_keys=True) for c in g["consumers"]
+                    ]
         else:
             data["groups"] = [
                 {str_if_bytes(k): v for k, v in group.items()}
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index a29b4a548a..61c00541cb 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -2919,6 +2919,31 @@ async def test_xinfo_stream(self, r: redis.Redis):
         assert info["first-entry"] == await get_stream_message(r, stream, m1)
         assert info["last-entry"] == await get_stream_message(r, stream, m2)
 
+        await r.xtrim(stream, 0)
+        info = await r.xinfo_stream(stream)
+        assert info["length"] == 0
+        assert info["first-entry"] is None
+        assert info["last-entry"] is None
+
+    @skip_if_server_version_lt("6.0.0")
+    async def test_xinfo_stream_full(self, r: redis.Redis):
+        stream = "stream"
+        group = "group"
+
+        await r.xadd(stream, {"foo": "bar"})
+        info = await r.xinfo_stream(stream, full=True)
+        assert info["length"] == 1
+        assert len(info["groups"]) == 0
+
+        await r.xgroup_create(stream, group, 0)
+        info = await r.xinfo_stream(stream, full=True)
+        assert info["length"] == 1
+
+        await r.xreadgroup(group, "consumer", streams={stream: ">"})
+        info = await r.xinfo_stream(stream, full=True)
+        consumer = info["groups"][0]["consumers"][0]
+        assert isinstance(consumer, dict)
+
     @skip_if_server_version_lt("5.0.0")
     async def test_xlen(self, r: redis.Redis):
         stream = "stream"
diff --git a/tests/test_commands.py b/tests/test_commands.py
index d0c235daf9..d0071155ea 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -4452,14 +4452,23 @@ def test_xinfo_stream(self, r):
         assert info["entries-added"] == 2
         assert info["recorded-first-entry-id"] == m1
 
+        r.xtrim(stream, 0)
+        info = r.xinfo_stream(stream)
+        assert info["length"] == 0
+        assert info["first-entry"] is None
+        assert info["last-entry"] is None
+
     @skip_if_server_version_lt("6.0.0")
     def test_xinfo_stream_full(self, r):
         stream = "stream"
         group = "group"
         m1 = r.xadd(stream, {"foo": "bar"})
-        r.xgroup_create(stream, group, 0)
         info = r.xinfo_stream(stream, full=True)
+        assert info["length"] == 1
+        assert len(info["groups"]) == 0
 
+        r.xgroup_create(stream, group, 0)
+        info = r.xinfo_stream(stream, full=True)
         assert info["length"] == 1
         assert_resp_response_in(
             r,
@@ -4469,6 +4478,11 @@ def test_xinfo_stream_full(self, r):
         )
         assert len(info["groups"]) == 1
 
+        r.xreadgroup(group, "consumer", streams={stream: ">"})
+        info = r.xinfo_stream(stream, full=True)
+        consumer = info["groups"][0]["consumers"][0]
+        assert isinstance(consumer, dict)
+
     @skip_if_server_version_lt("5.0.0")
     def test_xlen(self, r):
         stream = "stream"

From 04391fd51f0ef672ea43ad240317523f0588cbc7 Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@redis.com>
Date: Wed, 19 Jun 2024 11:09:03 +0300
Subject: [PATCH 0897/1164] Make sure the CI actually runs RESP3 tests (#3270)

The CI tests were not running with RESP3 protocol, it was just an
illusion that they do. Fix this, and also preserve coverage and test
artifacts from those runs too.

Some issues have surfaced after the change.

The most notable issue is a bug in hiredis-py, which prevents it
from being used in cluster mode at least. Make sure cluster tests do
not run with hiredis-py. Also make sure some specific unit tests do
not run with hiredis-py.

One other issue with hiredis-py is fixed in this commit. Use a
sentinel object instance to signal lack of data in hiredis-py, instead
of piggybacking of `False`, which can also be returned by parsing
valid RESP payloads.

Some of the unit tests, mostly for modules, were failing, they are now
updated so that they pass.

Remove async parser from test fixture params. Leave the decision for
the async parser to be used in tests to be taken based on the availability
of hiredis-py, and on the protocol that is set for the tests. Otherwise
when hiredis-py is available we would also run the non-hiredis tests.
---
 .github/workflows/integration.yaml    |  34 +++++++-
 redis/_parsers/hiredis.py             |  25 ++++--
 tests/test_asyncio/conftest.py        |  35 ++------
 tests/test_asyncio/test_json.py       | 106 +++++++++++-------------
 tests/test_asyncio/test_timeseries.py |  31 +++----
 tests/test_command_parser.py          |   4 +
 tests/test_commands.py                |  13 ++-
 tests/test_json.py                    | 113 ++++++++++++--------------
 tests/test_timeseries.py              |  47 +++++++----
 9 files changed, 212 insertions(+), 196 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 11b08c934e..a211e5d403 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -115,7 +115,9 @@ jobs:
         python-version: ['3.8', '3.11']
         test-type: ['standalone', 'cluster']
         connection-type: ['hiredis', 'plain']
-        protocol: ['3']
+        exclude:
+          - test-type: 'cluster'
+            connection-type: 'hiredis'
     env:
       ACTIONS_ALLOW_UNSECURE_COMMANDS: true
     name: RESP3 [${{ matrix.python-version }} ${{matrix.test-type}}-${{matrix.connection-type}}]
@@ -134,9 +136,33 @@ jobs:
             pip install hiredis
           fi
           invoke devenv
-          sleep 5 # time to settle
-          invoke ${{matrix.test-type}}-tests
-          invoke ${{matrix.test-type}}-tests --uvloop
+          sleep 10 # time to settle
+          invoke ${{matrix.test-type}}-tests --protocol=3
+          invoke ${{matrix.test-type}}-tests --uvloop --protocol=3
+
+      - uses: actions/upload-artifact@v4
+        if: success() || failure()
+        with:
+          name: pytest-results-${{matrix.test-type}}-${{matrix.connection-type}}-${{matrix.python-version}}-resp3
+          path: '${{matrix.test-type}}*results.xml'
+
+      - name: Upload codecov coverage
+        uses: codecov/codecov-action@v4
+        with:
+          fail_ci_if_error: false
+
+      - name: View Test Results
+        uses: dorny/test-reporter@v1
+        if: success() || failure()
+        continue-on-error: true
+        with:
+          name: Test Results ${{matrix.python-version}} ${{matrix.test-type}}-${{matrix.connection-type}}-resp3
+          path: '*.xml'
+          reporter: java-junit
+          list-suites: all
+          list-tests: all
+          max-annotations: 10
+          fail-on-error: 'false'
 
   build_and_test_package:
     name: Validate building and installing the package
diff --git a/redis/_parsers/hiredis.py b/redis/_parsers/hiredis.py
index a52dbbd013..c807bd903a 100644
--- a/redis/_parsers/hiredis.py
+++ b/redis/_parsers/hiredis.py
@@ -19,6 +19,11 @@
     SERVER_CLOSED_CONNECTION_ERROR,
 )
 
+# Used to signal that hiredis-py does not have enough data to parse.
+# Using `False` or `None` is not reliable, given that the parser can
+# return `False` or `None` for legitimate reasons from RESP payloads.
+NOT_ENOUGH_DATA = object()
+
 
 class _HiredisReaderArgs(TypedDict, total=False):
     protocolError: Callable[[str], Exception]
@@ -51,25 +56,26 @@ def on_connect(self, connection, **kwargs):
             "protocolError": InvalidResponse,
             "replyError": self.parse_error,
             "errors": connection.encoder.encoding_errors,
+            "notEnoughData": NOT_ENOUGH_DATA,
         }
 
         if connection.encoder.decode_responses:
             kwargs["encoding"] = connection.encoder.encoding
         self._reader = hiredis.Reader(**kwargs)
-        self._next_response = False
+        self._next_response = NOT_ENOUGH_DATA
 
     def on_disconnect(self):
         self._sock = None
         self._reader = None
-        self._next_response = False
+        self._next_response = NOT_ENOUGH_DATA
 
     def can_read(self, timeout):
         if not self._reader:
             raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
 
-        if self._next_response is False:
+        if self._next_response is NOT_ENOUGH_DATA:
             self._next_response = self._reader.gets()
-            if self._next_response is False:
+            if self._next_response is NOT_ENOUGH_DATA:
                 return self.read_from_socket(timeout=timeout, raise_on_timeout=False)
         return True
 
@@ -108,9 +114,9 @@ def read_response(self, disable_decoding=False):
             raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
 
         # _next_response might be cached from a can_read() call
-        if self._next_response is not False:
+        if self._next_response is not NOT_ENOUGH_DATA:
             response = self._next_response
-            self._next_response = False
+            self._next_response = NOT_ENOUGH_DATA
             return response
 
         if disable_decoding:
@@ -118,7 +124,7 @@ def read_response(self, disable_decoding=False):
         else:
             response = self._reader.gets()
 
-        while response is False:
+        while response is NOT_ENOUGH_DATA:
             self.read_from_socket()
             if disable_decoding:
                 response = self._reader.gets(False)
@@ -156,6 +162,7 @@ def on_connect(self, connection):
         kwargs: _HiredisReaderArgs = {
             "protocolError": InvalidResponse,
             "replyError": self.parse_error,
+            "notEnoughData": NOT_ENOUGH_DATA,
         }
         if connection.encoder.decode_responses:
             kwargs["encoding"] = connection.encoder.encoding
@@ -170,7 +177,7 @@ def on_disconnect(self):
     async def can_read_destructive(self):
         if not self._connected:
             raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
-        if self._reader.gets():
+        if self._reader.gets() is not NOT_ENOUGH_DATA:
             return True
         try:
             async with async_timeout(0):
@@ -200,7 +207,7 @@ async def read_response(
             response = self._reader.gets(False)
         else:
             response = self._reader.gets()
-        while response is False:
+        while response is NOT_ENOUGH_DATA:
             await self.read_from_socket()
             if disable_decoding:
                 response = self._reader.gets(False)
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index cff239fa11..6e93407b4c 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -6,13 +6,11 @@
 import pytest_asyncio
 import redis.asyncio as redis
 from packaging.version import Version
-from redis._parsers import _AsyncHiredisParser, _AsyncRESP2Parser
 from redis.asyncio import Sentinel
 from redis.asyncio.client import Monitor
 from redis.asyncio.connection import Connection, parse_url
 from redis.asyncio.retry import Retry
 from redis.backoff import NoBackoff
-from redis.utils import HIREDIS_AVAILABLE
 from tests.conftest import REDIS_INFO
 
 from .compat import mock
@@ -28,41 +26,21 @@ async def _get_info(redis_url):
 @pytest_asyncio.fixture(
     params=[
         pytest.param(
-            (True, _AsyncRESP2Parser),
+            (True,),
             marks=pytest.mark.skipif(
                 'config.REDIS_INFO["cluster_enabled"]', reason="cluster mode enabled"
             ),
         ),
-        (False, _AsyncRESP2Parser),
-        pytest.param(
-            (True, _AsyncHiredisParser),
-            marks=[
-                pytest.mark.skipif(
-                    'config.REDIS_INFO["cluster_enabled"]',
-                    reason="cluster mode enabled",
-                ),
-                pytest.mark.skipif(
-                    not HIREDIS_AVAILABLE, reason="hiredis is not installed"
-                ),
-            ],
-        ),
-        pytest.param(
-            (False, _AsyncHiredisParser),
-            marks=pytest.mark.skipif(
-                not HIREDIS_AVAILABLE, reason="hiredis is not installed"
-            ),
-        ),
+        (False,),
     ],
     ids=[
-        "single-python-parser",
-        "pool-python-parser",
-        "single-hiredis",
-        "pool-hiredis",
+        "single",
+        "pool",
     ],
 )
 async def create_redis(request):
     """Wrapper around redis.create_redis."""
-    single_connection, parser_cls = request.param
+    (single_connection,) = request.param
 
     teardown_clients = []
 
@@ -78,10 +56,9 @@ async def client_factory(
         cluster_mode = REDIS_INFO["cluster_enabled"]
         if not cluster_mode:
             single = kwargs.pop("single_connection_client", False) or single_connection
-            parser_class = kwargs.pop("parser_class", None) or parser_cls
             url_options = parse_url(url)
             url_options.update(kwargs)
-            pool = redis.ConnectionPool(parser_class=parser_class, **url_options)
+            pool = redis.ConnectionPool(**url_options)
             client = cls(connection_pool=pool)
         else:
             client = redis.RedisCluster.from_url(url, **kwargs)
diff --git a/tests/test_asyncio/test_json.py b/tests/test_asyncio/test_json.py
index cc98a55323..507afc5621 100644
--- a/tests/test_asyncio/test_json.py
+++ b/tests/test_asyncio/test_json.py
@@ -22,7 +22,7 @@ async def test_json_setbinarykey(decoded_r: redis.Redis):
 @pytest.mark.redismod
 async def test_json_setgetdeleteforget(decoded_r: redis.Redis):
     assert await decoded_r.json().set("foo", Path.root_path(), "bar")
-    assert_resp_response(decoded_r, await decoded_r.json().get("foo"), "bar", [["bar"]])
+    assert await decoded_r.json().get("foo") == "bar"
     assert await decoded_r.json().get("baz") is None
     assert await decoded_r.json().delete("foo") == 1
     assert await decoded_r.json().forget("foo") == 0  # second delete
@@ -32,13 +32,13 @@ async def test_json_setgetdeleteforget(decoded_r: redis.Redis):
 @pytest.mark.redismod
 async def test_jsonget(decoded_r: redis.Redis):
     await decoded_r.json().set("foo", Path.root_path(), "bar")
-    assert_resp_response(decoded_r, await decoded_r.json().get("foo"), "bar", [["bar"]])
+    assert await decoded_r.json().get("foo") == "bar"
 
 
 @pytest.mark.redismod
 async def test_json_get_jset(decoded_r: redis.Redis):
     assert await decoded_r.json().set("foo", Path.root_path(), "bar")
-    assert_resp_response(decoded_r, await decoded_r.json().get("foo"), "bar", [["bar"]])
+    assert await decoded_r.json().get("foo") == "bar"
     assert await decoded_r.json().get("baz") is None
     assert 1 == await decoded_r.json().delete("foo")
     assert await decoded_r.exists("foo") == 0
@@ -47,10 +47,7 @@ async def test_json_get_jset(decoded_r: redis.Redis):
 @pytest.mark.redismod
 async def test_nonascii_setgetdelete(decoded_r: redis.Redis):
     assert await decoded_r.json().set("notascii", Path.root_path(), "hyvää-élève")
-    res = "hyvää-élève"
-    assert_resp_response(
-        decoded_r, await decoded_r.json().get("notascii", no_escape=True), res, [[res]]
-    )
+    assert await decoded_r.json().get("notascii", no_escape=True) == "hyvää-élève"
     assert 1 == await decoded_r.json().delete("notascii")
     assert await decoded_r.exists("notascii") == 0
 
@@ -192,8 +189,7 @@ async def test_toggle(decoded_r: redis.Redis):
 async def test_strappend(decoded_r: redis.Redis):
     await decoded_r.json().set("jsonkey", Path.root_path(), "foo")
     assert 6 == await decoded_r.json().strappend("jsonkey", "bar")
-    res = await decoded_r.json().get("jsonkey", Path.root_path())
-    assert_resp_response(decoded_r, res, "foobar", [["foobar"]])
+    assert "foobar" == await decoded_r.json().get("jsonkey", Path.root_path())
 
 
 @pytest.mark.redismod
@@ -230,14 +226,12 @@ async def test_arrindex(decoded_r: redis.Redis):
 async def test_arrinsert(decoded_r: redis.Redis):
     await decoded_r.json().set("arr", Path.root_path(), [0, 4])
     assert 5 == await decoded_r.json().arrinsert("arr", Path.root_path(), 1, *[1, 2, 3])
-    res = [0, 1, 2, 3, 4]
-    assert_resp_response(decoded_r, await decoded_r.json().get("arr"), res, [[res]])
+    assert await decoded_r.json().get("arr") == [0, 1, 2, 3, 4]
 
     # test prepends
     await decoded_r.json().set("val2", Path.root_path(), [5, 6, 7, 8, 9])
     await decoded_r.json().arrinsert("val2", Path.root_path(), 0, ["some", "thing"])
-    res = [["some", "thing"], 5, 6, 7, 8, 9]
-    assert_resp_response(decoded_r, await decoded_r.json().get("val2"), res, [[res]])
+    assert await decoded_r.json().get("val2") == [["some", "thing"], 5, 6, 7, 8, 9]
 
 
 @pytest.mark.redismod
@@ -255,7 +249,7 @@ async def test_arrpop(decoded_r: redis.Redis):
     assert 3 == await decoded_r.json().arrpop("arr", Path.root_path(), -1)
     assert 2 == await decoded_r.json().arrpop("arr", Path.root_path())
     assert 0 == await decoded_r.json().arrpop("arr", Path.root_path(), 0)
-    assert_resp_response(decoded_r, await decoded_r.json().get("arr"), [1], [[[1]]])
+    assert [1] == await decoded_r.json().get("arr")
 
     # test out of bounds
     await decoded_r.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
@@ -270,8 +264,7 @@ async def test_arrpop(decoded_r: redis.Redis):
 async def test_arrtrim(decoded_r: redis.Redis):
     await decoded_r.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
     assert 3 == await decoded_r.json().arrtrim("arr", Path.root_path(), 1, 3)
-    res = await decoded_r.json().get("arr")
-    assert_resp_response(decoded_r, res, [1, 2, 3], [[[1, 2, 3]]])
+    assert [1, 2, 3] == await decoded_r.json().get("arr")
 
     # <0 test, should be 0 equivalent
     await decoded_r.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
@@ -356,15 +349,14 @@ async def test_json_delete_with_dollar(decoded_r: redis.Redis):
     doc1 = {"a": 1, "nested": {"a": 2, "b": 3}}
     assert await decoded_r.json().set("doc1", "$", doc1)
     assert await decoded_r.json().delete("doc1", "$..a") == 2
-    res = [{"nested": {"b": 3}}]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
+    assert await decoded_r.json().get("doc1", "$") == [{"nested": {"b": 3}}]
 
     doc2 = {"a": {"a": 2, "b": 3}, "b": ["a", "b"], "nested": {"b": [True, "a", "b"]}}
     assert await decoded_r.json().set("doc2", "$", doc2)
     assert await decoded_r.json().delete("doc2", "$..a") == 1
-    res = await decoded_r.json().get("doc2", "$")
-    res = [{"nested": {"b": [True, "a", "b"]}, "b": ["a", "b"]}]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc2", "$"), res, [res])
+    assert await decoded_r.json().get("doc2", "$") == [
+        {"nested": {"b": [True, "a", "b"]}, "b": ["a", "b"]}
+    ]
 
     doc3 = [
         {
@@ -395,8 +387,7 @@ async def test_json_delete_with_dollar(decoded_r: redis.Redis):
             }
         ]
     ]
-    res = await decoded_r.json().get("doc3", "$")
-    assert_resp_response(decoded_r, res, doc3val, [doc3val])
+    assert await decoded_r.json().get("doc3", "$") == doc3val
 
     # Test async default path
     assert await decoded_r.json().delete("doc3") == 1
@@ -410,14 +401,14 @@ async def test_json_forget_with_dollar(decoded_r: redis.Redis):
     doc1 = {"a": 1, "nested": {"a": 2, "b": 3}}
     assert await decoded_r.json().set("doc1", "$", doc1)
     assert await decoded_r.json().forget("doc1", "$..a") == 2
-    res = [{"nested": {"b": 3}}]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
+    assert await decoded_r.json().get("doc1", "$") == [{"nested": {"b": 3}}]
 
     doc2 = {"a": {"a": 2, "b": 3}, "b": ["a", "b"], "nested": {"b": [True, "a", "b"]}}
     assert await decoded_r.json().set("doc2", "$", doc2)
     assert await decoded_r.json().forget("doc2", "$..a") == 1
-    res = [{"nested": {"b": [True, "a", "b"]}, "b": ["a", "b"]}]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc2", "$"), res, [res])
+    assert await decoded_r.json().get("doc2", "$") == [
+        {"nested": {"b": [True, "a", "b"]}, "b": ["a", "b"]}
+    ]
 
     doc3 = [
         {
@@ -448,8 +439,7 @@ async def test_json_forget_with_dollar(decoded_r: redis.Redis):
             }
         ]
     ]
-    res = await decoded_r.json().get("doc3", "$")
-    assert_resp_response(decoded_r, res, doc3val, [doc3val])
+    assert await decoded_r.json().get("doc3", "$") == doc3val
 
     # Test async default path
     assert await decoded_r.json().forget("doc3") == 1
@@ -473,14 +463,8 @@ async def test_json_mget_dollar(decoded_r: redis.Redis):
         {"a": 4, "b": 5, "nested": {"a": 6}, "c": None, "nested2": {"a": [None]}},
     )
     # Compare also to single JSON.GET
-    res = [1, 3, None]
-    assert_resp_response(
-        decoded_r, await decoded_r.json().get("doc1", "$..a"), res, [res]
-    )
-    res = [4, 6, [None]]
-    assert_resp_response(
-        decoded_r, await decoded_r.json().get("doc2", "$..a"), res, [res]
-    )
+    assert await decoded_r.json().get("doc1", "$..a") == [1, 3, None]
+    assert await decoded_r.json().get("doc2", "$..a") == [4, 6, [None]]
 
     # Test mget with single path
     assert await decoded_r.json().mget(["doc1"], "$..a") == [[1, 3, None]]
@@ -539,7 +523,9 @@ async def test_numby_commands_dollar(decoded_r: redis.Redis):
     await decoded_r.json().set(
         "doc1", "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]}
     )
-    assert await decoded_r.json().numincrby("doc1", ".b[0].a", 3) == 5
+    assert_resp_response(
+        decoded_r, await decoded_r.json().numincrby("doc1", ".b[0].a", 3), 5, [5]
+    )
 
     # Test legacy NUMMULTBY
     await decoded_r.json().set(
@@ -547,7 +533,9 @@ async def test_numby_commands_dollar(decoded_r: redis.Redis):
     )
 
     with pytest.deprecated_call():
-        assert await decoded_r.json().nummultby("doc1", ".b[0].a", 3) == 6
+        assert_resp_response(
+            decoded_r, await decoded_r.json().nummultby("doc1", ".b[0].a", 3), 6, [6]
+        )
 
 
 @pytest.mark.redismod
@@ -559,13 +547,13 @@ async def test_strappend_dollar(decoded_r: redis.Redis):
     assert await decoded_r.json().strappend("doc1", "bar", "$..a") == [6, 8, None]
 
     res = [{"a": "foobar", "nested1": {"a": "hellobar"}, "nested2": {"a": 31}}]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
+    assert await decoded_r.json().get("doc1", "$") == res
 
     # Test single
     assert await decoded_r.json().strappend("doc1", "baz", "$.nested1.a") == [11]
 
     res = [{"a": "foobar", "nested1": {"a": "hellobarbaz"}, "nested2": {"a": 31}}]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
+    assert await decoded_r.json().get("doc1", "$") == res
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -574,7 +562,7 @@ async def test_strappend_dollar(decoded_r: redis.Redis):
     # Test multi
     assert await decoded_r.json().strappend("doc1", "bar", ".*.a") == 14
     res = [{"a": "foobar", "nested1": {"a": "hellobarbazbar"}, "nested2": {"a": 31}}]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
+    assert await decoded_r.json().get("doc1", "$") == res
 
     # Test missing path
     with pytest.raises(exceptions.ResponseError):
@@ -623,7 +611,7 @@ async def test_arrappend_dollar(decoded_r: redis.Redis):
             "nested2": {"a": 31},
         }
     ]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
+    assert await decoded_r.json().get("doc1", "$") == res
 
     # Test single
     assert await decoded_r.json().arrappend("doc1", "$.nested1.a", "baz") == [6]
@@ -634,7 +622,7 @@ async def test_arrappend_dollar(decoded_r: redis.Redis):
             "nested2": {"a": 31},
         }
     ]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
+    assert await decoded_r.json().get("doc1", "$") == res
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -660,7 +648,7 @@ async def test_arrappend_dollar(decoded_r: redis.Redis):
             "nested2": {"a": 31},
         }
     ]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
+    assert await decoded_r.json().get("doc1", "$") == res
     # Test single
     assert await decoded_r.json().arrappend("doc1", ".nested1.a", "baz") == 6
     res = [
@@ -670,7 +658,7 @@ async def test_arrappend_dollar(decoded_r: redis.Redis):
             "nested2": {"a": 31},
         }
     ]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
+    assert await decoded_r.json().get("doc1", "$") == res
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -699,7 +687,7 @@ async def test_arrinsert_dollar(decoded_r: redis.Redis):
             "nested2": {"a": 31},
         }
     ]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
+    assert await decoded_r.json().get("doc1", "$") == res
     # Test single
     assert await decoded_r.json().arrinsert("doc1", "$.nested1.a", -2, "baz") == [6]
     res = [
@@ -709,7 +697,7 @@ async def test_arrinsert_dollar(decoded_r: redis.Redis):
             "nested2": {"a": 31},
         }
     ]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
+    assert await decoded_r.json().get("doc1", "$") == res
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -778,7 +766,7 @@ async def test_arrpop_dollar(decoded_r: redis.Redis):
     assert await decoded_r.json().arrpop("doc1", "$..a", 1) == ['"foo"', None, None]
 
     res = [{"a": [], "nested1": {"a": ["hello", "world"]}, "nested2": {"a": 31}}]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
+    assert await decoded_r.json().get("doc1", "$") == res
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -797,7 +785,7 @@ async def test_arrpop_dollar(decoded_r: redis.Redis):
     # Test multi (all paths are updated, but return result of last path)
     assert await decoded_r.json().arrpop("doc1", "..a", "1") == "null"
     res = [{"a": [], "nested1": {"a": ["hello", "world"]}, "nested2": {"a": 31}}]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
+    assert await decoded_r.json().get("doc1", "$") == res
 
     # # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -818,15 +806,15 @@ async def test_arrtrim_dollar(decoded_r: redis.Redis):
     # Test multi
     assert await decoded_r.json().arrtrim("doc1", "$..a", "1", -1) == [0, 2, None]
     res = [{"a": [], "nested1": {"a": [None, "world"]}, "nested2": {"a": 31}}]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
+    assert await decoded_r.json().get("doc1", "$") == res
 
     assert await decoded_r.json().arrtrim("doc1", "$..a", "1", "1") == [0, 1, None]
     res = [{"a": [], "nested1": {"a": ["world"]}, "nested2": {"a": 31}}]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
+    assert await decoded_r.json().get("doc1", "$") == res
     # Test single
     assert await decoded_r.json().arrtrim("doc1", "$.nested1.a", 1, 0) == [0]
     res = [{"a": [], "nested1": {"a": []}, "nested2": {"a": 31}}]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
+    assert await decoded_r.json().get("doc1", "$") == res
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -849,7 +837,7 @@ async def test_arrtrim_dollar(decoded_r: redis.Redis):
     # Test single
     assert await decoded_r.json().arrtrim("doc1", ".nested1.a", "1", "1") == 1
     res = [{"a": [], "nested1": {"a": ["world"]}, "nested2": {"a": 31}}]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
+    assert await decoded_r.json().get("doc1", "$") == res
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -979,7 +967,7 @@ async def test_clear_dollar(decoded_r: redis.Redis):
     res = [
         {"nested1": {"a": {}}, "a": [], "nested2": {"a": "claro"}, "nested3": {"a": {}}}
     ]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
+    assert await decoded_r.json().get("doc1", "$") == res
 
     # Test single
     await decoded_r.json().set(
@@ -1001,13 +989,11 @@ async def test_clear_dollar(decoded_r: redis.Redis):
             "nested3": {"a": {"baz": 50}},
         }
     ]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
+    assert await decoded_r.json().get("doc1", "$") == res
 
     # Test missing path (async defaults to root)
     assert await decoded_r.json().clear("doc1") == 1
-    assert_resp_response(
-        decoded_r, await decoded_r.json().get("doc1", "$"), [{}], [[{}]]
-    )
+    assert await decoded_r.json().get("doc1", "$") == [{}]
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -1036,7 +1022,7 @@ async def test_toggle_dollar(decoded_r: redis.Redis):
             "nested3": {"a": False},
         }
     ]
-    assert_resp_response(decoded_r, await decoded_r.json().get("doc1", "$"), res, [res])
+    assert await decoded_r.json().get("doc1", "$") == res
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
diff --git a/tests/test_asyncio/test_timeseries.py b/tests/test_asyncio/test_timeseries.py
index c93af1ea5b..0475c318ec 100644
--- a/tests/test_asyncio/test_timeseries.py
+++ b/tests/test_asyncio/test_timeseries.py
@@ -780,8 +780,12 @@ async def test_create_with_insertion_filters(decoded_r: redis.Redis):
     assert 1021 == await decoded_r.ts().add("time-series-1", 1021, 22.0)
 
     data_points = await decoded_r.ts().range("time-series-1", "-", "+")
-    expected_points = [(1000, 1.0), (1010, 11.0), (1020, 11.5), (1021, 22.0)]
-    assert expected_points == data_points
+    assert_resp_response(
+        decoded_r,
+        data_points,
+        [(1000, 1.0), (1010, 11.0), (1020, 11.5), (1021, 22.0)],
+        [[1000, 1.0], [1010, 11.0], [1020, 11.5], [1021, 22.0]],
+    )
 
 
 @skip_ifmodversion_lt("1.12.0", "timeseries")
@@ -800,8 +804,12 @@ async def test_alter_with_insertion_filters(decoded_r: redis.Redis):
     assert 1013 == await decoded_r.ts().add("time-series-1", 1015, 11.5)
 
     data_points = await decoded_r.ts().range("time-series-1", "-", "+")
-    expected_points = [(1000, 1.0), (1010, 11.0), (1013, 10.0)]
-    assert expected_points == data_points
+    assert_resp_response(
+        decoded_r,
+        data_points,
+        [(1000, 1.0), (1010, 11.0), (1013, 10.0)],
+        [[1000, 1.0], [1010, 11.0], [1013, 10.0]],
+    )
 
 
 @skip_ifmodversion_lt("1.12.0", "timeseries")
@@ -818,8 +826,7 @@ async def test_add_with_insertion_filters(decoded_r: redis.Redis):
     assert 1000 == await decoded_r.ts().add("time-series-1", 1004, 3.0)
 
     data_points = await decoded_r.ts().range("time-series-1", "-", "+")
-    expected_points = [(1000, 1.0)]
-    assert expected_points == data_points
+    assert_resp_response(decoded_r, data_points, [(1000, 1.0)], [[1000, 1.0]])
 
 
 @skip_ifmodversion_lt("1.12.0", "timeseries")
@@ -836,14 +843,12 @@ async def test_incrby_with_insertion_filters(decoded_r: redis.Redis):
     assert 1000 == await decoded_r.ts().incrby("time-series-1", 3.0, timestamp=1000)
 
     data_points = await decoded_r.ts().range("time-series-1", "-", "+")
-    expected_points = [(1000, 1.0)]
-    assert expected_points == data_points
+    assert_resp_response(decoded_r, data_points, [(1000, 1.0)], [[1000, 1.0]])
 
     assert 1000 == await decoded_r.ts().incrby("time-series-1", 10.1, timestamp=1000)
 
     data_points = await decoded_r.ts().range("time-series-1", "-", "+")
-    expected_points = [(1000, 11.1)]
-    assert expected_points == data_points
+    assert_resp_response(decoded_r, data_points, [(1000, 11.1)], [[1000, 11.1]])
 
 
 @skip_ifmodversion_lt("1.12.0", "timeseries")
@@ -860,11 +865,9 @@ async def test_decrby_with_insertion_filters(decoded_r: redis.Redis):
     assert 1000 == await decoded_r.ts().decrby("time-series-1", 3.0, timestamp=1000)
 
     data_points = await decoded_r.ts().range("time-series-1", "-", "+")
-    expected_points = [(1000, -1.0)]
-    assert expected_points == data_points
+    assert_resp_response(decoded_r, data_points, [(1000, -1.0)], [[1000, -1.0]])
 
     assert 1000 == await decoded_r.ts().decrby("time-series-1", 10.1, timestamp=1000)
 
     data_points = await decoded_r.ts().range("time-series-1", "-", "+")
-    expected_points = [(1000, -11.1)]
-    assert expected_points == data_points
+    assert_resp_response(decoded_r, data_points, [(1000, -11.1)], [[1000, -11.1]])
diff --git a/tests/test_command_parser.py b/tests/test_command_parser.py
index e3b44a147f..5c23a7096f 100644
--- a/tests/test_command_parser.py
+++ b/tests/test_command_parser.py
@@ -1,5 +1,6 @@
 import pytest
 from redis._parsers import CommandsParser
+from redis.utils import HIREDIS_AVAILABLE
 
 from .conftest import (
     assert_resp_response,
@@ -8,6 +9,9 @@
 )
 
 
+# The response to COMMAND contains maps inside sets, which are not handled
+# by the hiredis-py parser (see https://github.com/redis/hiredis-py/issues/188)
+@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 class TestCommandsParser:
     def test_init_commands(self, r):
         commands_parser = CommandsParser(r)
diff --git a/tests/test_commands.py b/tests/test_commands.py
index d0071155ea..aab2a227ed 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -18,6 +18,7 @@
     parse_info,
 )
 from redis.client import EMPTY_RESPONSE, NEVER_DECODE
+from redis.utils import HIREDIS_AVAILABLE
 
 from .conftest import (
     _get_client,
@@ -1841,7 +1842,14 @@ def test_tfunction_list(self, stack_r):
         assert len(functions) == 3
 
         expected_names = [b"lib1", b"lib2", b"lib3"]
-        actual_names = [functions[0][13], functions[1][13], functions[2][13]]
+        if is_resp2_connection(stack_r):
+            actual_names = [functions[0][13], functions[1][13], functions[2][13]]
+        else:
+            actual_names = [
+                functions[0][b"name"],
+                functions[1][b"name"],
+                functions[2][b"name"],
+            ]
 
         assert sorted(expected_names) == sorted(actual_names)
         assert stack_r.tfunction_delete("lib1")
@@ -5009,6 +5017,9 @@ def test_command_getkeys(self, r):
             r, res, ["key1", "key2", "key3"], [b"key1", b"key2", b"key3"]
         )
 
+    # The response to COMMAND contains maps inside sets, which are not handled
+    # by the hiredis-py parser (see https://github.com/redis/hiredis-py/issues/188)
+    @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
     @skip_if_server_version_lt("2.8.13")
     def test_command(self, r):
         res = r.command()
diff --git a/tests/test_json.py b/tests/test_json.py
index 9996c898d4..a688464874 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -25,7 +25,7 @@ def test_json_setbinarykey(client):
 @pytest.mark.redismod
 def test_json_setgetdeleteforget(client):
     assert client.json().set("foo", Path.root_path(), "bar")
-    assert_resp_response(client, client.json().get("foo"), "bar", [["bar"]])
+    assert client.json().get("foo") == "bar"
     assert client.json().get("baz") is None
     assert client.json().delete("foo") == 1
     assert client.json().forget("foo") == 0  # second delete
@@ -35,13 +35,13 @@ def test_json_setgetdeleteforget(client):
 @pytest.mark.redismod
 def test_jsonget(client):
     client.json().set("foo", Path.root_path(), "bar")
-    assert_resp_response(client, client.json().get("foo"), "bar", [["bar"]])
+    assert client.json().get("foo") == "bar"
 
 
 @pytest.mark.redismod
 def test_json_get_jset(client):
     assert client.json().set("foo", Path.root_path(), "bar")
-    assert_resp_response(client, client.json().get("foo"), "bar", [["bar"]])
+    assert client.json().get("foo") == "bar"
     assert client.json().get("baz") is None
     assert 1 == client.json().delete("foo")
     assert client.exists("foo") == 0
@@ -83,10 +83,7 @@ def test_json_merge(client):
 @pytest.mark.redismod
 def test_nonascii_setgetdelete(client):
     assert client.json().set("notascii", Path.root_path(), "hyvää-élève")
-    res = "hyvää-élève"
-    assert_resp_response(
-        client, client.json().get("notascii", no_escape=True), res, [[res]]
-    )
+    assert client.json().get("notascii", no_escape=True) == "hyvää-élève"
     assert 1 == client.json().delete("notascii")
     assert client.exists("notascii") == 0
 
@@ -191,9 +188,7 @@ def test_toggle(client):
 def test_strappend(client):
     client.json().set("jsonkey", Path.root_path(), "foo")
     assert 6 == client.json().strappend("jsonkey", "bar")
-    assert_resp_response(
-        client, client.json().get("jsonkey", Path.root_path()), "foobar", [["foobar"]]
-    )
+    assert "foobar" == client.json().get("jsonkey", Path.root_path())
 
 
 @pytest.mark.redismod
@@ -229,14 +224,12 @@ def test_arrindex(client):
 def test_arrinsert(client):
     client.json().set("arr", Path.root_path(), [0, 4])
     assert 5 - -client.json().arrinsert("arr", Path.root_path(), 1, *[1, 2, 3])
-    res = [0, 1, 2, 3, 4]
-    assert_resp_response(client, client.json().get("arr"), res, [[res]])
+    assert client.json().get("arr") == [0, 1, 2, 3, 4]
 
     # test prepends
     client.json().set("val2", Path.root_path(), [5, 6, 7, 8, 9])
     client.json().arrinsert("val2", Path.root_path(), 0, ["some", "thing"])
-    res = [["some", "thing"], 5, 6, 7, 8, 9]
-    assert_resp_response(client, client.json().get("val2"), res, [[res]])
+    assert client.json().get("val2") == [["some", "thing"], 5, 6, 7, 8, 9]
 
 
 @pytest.mark.redismod
@@ -254,7 +247,7 @@ def test_arrpop(client):
     assert 3 == client.json().arrpop("arr", Path.root_path(), -1)
     assert 2 == client.json().arrpop("arr", Path.root_path())
     assert 0 == client.json().arrpop("arr", Path.root_path(), 0)
-    assert_resp_response(client, client.json().get("arr"), [1], [[[1]]])
+    assert [1] == client.json().get("arr")
 
     # test out of bounds
     client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
@@ -269,7 +262,7 @@ def test_arrpop(client):
 def test_arrtrim(client):
     client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
     assert 3 == client.json().arrtrim("arr", Path.root_path(), 1, 3)
-    assert_resp_response(client, client.json().get("arr"), [1, 2, 3], [[[1, 2, 3]]])
+    assert [1, 2, 3] == client.json().get("arr")
 
     # <0 test, should be 0 equivalent
     client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
@@ -331,7 +324,7 @@ def test_json_commands_in_pipeline(client):
     p.set("foo", Path.root_path(), "bar")
     p.get("foo")
     p.delete("foo")
-    assert_resp_response(client, p.execute(), [True, "bar", 1], [True, [["bar"]], 1])
+    assert p.execute() == [True, "bar", 1]
     assert client.keys() == []
     assert client.get("foo") is None
 
@@ -344,7 +337,7 @@ def test_json_commands_in_pipeline(client):
         p.jsonget("foo")
     p.exists("notarealkey")
     p.delete("foo")
-    assert_resp_response(client, p.execute(), [True, d, 0, 1], [True, [[d]], 0, 1])
+    assert p.execute() == [True, d, 0, 1]
     assert client.keys() == []
     assert client.get("foo") is None
 
@@ -355,13 +348,13 @@ def test_json_delete_with_dollar(client):
     assert client.json().set("doc1", "$", doc1)
     assert client.json().delete("doc1", "$..a") == 2
     res = [{"nested": {"b": 3}}]
-    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    assert client.json().get("doc1", "$") == res
 
     doc2 = {"a": {"a": 2, "b": 3}, "b": ["a", "b"], "nested": {"b": [True, "a", "b"]}}
     assert client.json().set("doc2", "$", doc2)
     assert client.json().delete("doc2", "$..a") == 1
     res = [{"nested": {"b": [True, "a", "b"]}, "b": ["a", "b"]}]
-    assert_resp_response(client, client.json().get("doc2", "$"), res, [res])
+    assert client.json().get("doc2", "$") == res
 
     doc3 = [
         {
@@ -392,7 +385,7 @@ def test_json_delete_with_dollar(client):
             }
         ]
     ]
-    assert_resp_response(client, client.json().get("doc3", "$"), doc3val, [doc3val])
+    assert client.json().get("doc3", "$") == doc3val
 
     # Test default path
     assert client.json().delete("doc3") == 1
@@ -407,13 +400,13 @@ def test_json_forget_with_dollar(client):
     assert client.json().set("doc1", "$", doc1)
     assert client.json().forget("doc1", "$..a") == 2
     res = [{"nested": {"b": 3}}]
-    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    assert client.json().get("doc1", "$") == res
 
     doc2 = {"a": {"a": 2, "b": 3}, "b": ["a", "b"], "nested": {"b": [True, "a", "b"]}}
     assert client.json().set("doc2", "$", doc2)
     assert client.json().forget("doc2", "$..a") == 1
     res = [{"nested": {"b": [True, "a", "b"]}, "b": ["a", "b"]}]
-    assert_resp_response(client, client.json().get("doc2", "$"), res, [res])
+    assert client.json().get("doc2", "$") == res
 
     doc3 = [
         {
@@ -444,7 +437,7 @@ def test_json_forget_with_dollar(client):
             }
         ]
     ]
-    assert_resp_response(client, client.json().get("doc3", "$"), doc3val, [doc3val])
+    assert client.json().get("doc3", "$") == doc3val
 
     # Test default path
     assert client.json().forget("doc3") == 1
@@ -469,9 +462,9 @@ def test_json_mget_dollar(client):
     )
     # Compare also to single JSON.GET
     res = [1, 3, None]
-    assert_resp_response(client, client.json().get("doc1", "$..a"), res, [res])
+    assert client.json().get("doc1", "$..a") == res
     res = [4, 6, [None]]
-    assert_resp_response(client, client.json().get("doc2", "$..a"), res, [res])
+    assert client.json().get("doc2", "$..a") == res
 
     # Test mget with single path
     assert client.json().mget(["doc1"], "$..a") == [[1, 3, None]]
@@ -519,13 +512,15 @@ def test_numby_commands_dollar(client):
 
     # Test legacy NUMINCRBY
     client.json().set("doc1", "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]})
-    assert client.json().numincrby("doc1", ".b[0].a", 3) == 5
+    assert_resp_response(client, client.json().numincrby("doc1", ".b[0].a", 3), 5, [5])
 
     # Test legacy NUMMULTBY
     client.json().set("doc1", "$", {"a": "b", "b": [{"a": 2}, {"a": 5.0}, {"a": "c"}]})
 
     with pytest.deprecated_call():
-        assert client.json().nummultby("doc1", ".b[0].a", 3) == 6
+        assert_resp_response(
+            client, client.json().nummultby("doc1", ".b[0].a", 3), 6, [6]
+        )
 
 
 @pytest.mark.redismod
@@ -537,13 +532,13 @@ def test_strappend_dollar(client):
     assert client.json().strappend("doc1", "bar", "$..a") == [6, 8, None]
 
     res = [{"a": "foobar", "nested1": {"a": "hellobar"}, "nested2": {"a": 31}}]
-    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    assert_resp_response(client, client.json().get("doc1", "$"), res, res)
 
     # Test single
     assert client.json().strappend("doc1", "baz", "$.nested1.a") == [11]
 
     res = [{"a": "foobar", "nested1": {"a": "hellobarbaz"}, "nested2": {"a": 31}}]
-    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    assert_resp_response(client, client.json().get("doc1", "$"), res, res)
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -552,7 +547,7 @@ def test_strappend_dollar(client):
     # Test multi
     assert client.json().strappend("doc1", "bar", ".*.a") == 14
     res = [{"a": "foobar", "nested1": {"a": "hellobarbazbar"}, "nested2": {"a": 31}}]
-    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    assert_resp_response(client, client.json().get("doc1", "$"), res, res)
 
     # Test missing path
     with pytest.raises(exceptions.ResponseError):
@@ -600,7 +595,7 @@ def test_arrappend_dollar(client):
             "nested2": {"a": 31},
         }
     ]
-    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    assert client.json().get("doc1", "$") == res
 
     # Test single
     assert client.json().arrappend("doc1", "$.nested1.a", "baz") == [6]
@@ -611,7 +606,7 @@ def test_arrappend_dollar(client):
             "nested2": {"a": 31},
         }
     ]
-    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    assert client.json().get("doc1", "$") == res
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -637,7 +632,7 @@ def test_arrappend_dollar(client):
             "nested2": {"a": 31},
         }
     ]
-    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    assert client.json().get("doc1", "$") == res
 
     # Test single
     assert client.json().arrappend("doc1", ".nested1.a", "baz") == 6
@@ -648,7 +643,7 @@ def test_arrappend_dollar(client):
             "nested2": {"a": 31},
         }
     ]
-    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    assert client.json().get("doc1", "$") == res
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -676,7 +671,7 @@ def test_arrinsert_dollar(client):
             "nested2": {"a": 31},
         }
     ]
-    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    assert client.json().get("doc1", "$") == res
 
     # Test single
     assert client.json().arrinsert("doc1", "$.nested1.a", -2, "baz") == [6]
@@ -687,7 +682,7 @@ def test_arrinsert_dollar(client):
             "nested2": {"a": 31},
         }
     ]
-    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    assert client.json().get("doc1", "$") == res
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -759,7 +754,7 @@ def test_arrpop_dollar(client):
     assert client.json().arrpop("doc1", "$..a", 1) == ['"foo"', None, None]
 
     res = [{"a": [], "nested1": {"a": ["hello", "world"]}, "nested2": {"a": 31}}]
-    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    assert client.json().get("doc1", "$") == res
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -778,7 +773,7 @@ def test_arrpop_dollar(client):
     # Test multi (all paths are updated, but return result of last path)
     assert client.json().arrpop("doc1", "..a", "1") == "null"
     res = [{"a": [], "nested1": {"a": ["hello", "world"]}, "nested2": {"a": 31}}]
-    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    assert client.json().get("doc1", "$") == res
 
     # # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -799,16 +794,16 @@ def test_arrtrim_dollar(client):
     # Test multi
     assert client.json().arrtrim("doc1", "$..a", "1", -1) == [0, 2, None]
     res = [{"a": [], "nested1": {"a": [None, "world"]}, "nested2": {"a": 31}}]
-    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    assert client.json().get("doc1", "$") == res
 
     assert client.json().arrtrim("doc1", "$..a", "1", "1") == [0, 1, None]
     res = [{"a": [], "nested1": {"a": ["world"]}, "nested2": {"a": 31}}]
-    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    assert client.json().get("doc1", "$") == res
 
     # Test single
     assert client.json().arrtrim("doc1", "$.nested1.a", 1, 0) == [0]
     res = [{"a": [], "nested1": {"a": []}, "nested2": {"a": 31}}]
-    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    assert client.json().get("doc1", "$") == res
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -831,7 +826,7 @@ def test_arrtrim_dollar(client):
     # Test single
     assert client.json().arrtrim("doc1", ".nested1.a", "1", "1") == 1
     res = [{"a": [], "nested1": {"a": ["world"]}, "nested2": {"a": 31}}]
-    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    assert client.json().get("doc1", "$") == res
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -959,7 +954,7 @@ def test_clear_dollar(client):
     res = [
         {"nested1": {"a": {}}, "a": [], "nested2": {"a": "claro"}, "nested3": {"a": {}}}
     ]
-    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    assert client.json().get("doc1", "$") == res
 
     # Test single
     client.json().set(
@@ -981,11 +976,11 @@ def test_clear_dollar(client):
             "nested3": {"a": {"baz": 50}},
         }
     ]
-    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    assert client.json().get("doc1", "$") == res
 
     # Test missing path (defaults to root)
     assert client.json().clear("doc1") == 1
-    assert_resp_response(client, client.json().get("doc1", "$"), [{}], [[{}]])
+    assert client.json().get("doc1", "$") == [{}]
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -1014,7 +1009,7 @@ def test_toggle_dollar(client):
             "nested3": {"a": False},
         }
     ]
-    assert_resp_response(client, client.json().get("doc1", "$"), res, [res])
+    assert client.json().get("doc1", "$") == res
 
     # Test missing key
     with pytest.raises(exceptions.ResponseError):
@@ -1294,12 +1289,10 @@ def test_arrindex_dollar(client):
         },
     )
 
-    assert_resp_response(
-        client,
-        client.json().get("store", "$.store.book[?(@.price<10)].size"),
-        [[10, 20, 30, 40], [5, 10, 20, 30]],
-        [[[10, 20, 30, 40], [5, 10, 20, 30]]],
-    )
+    assert client.json().get("store", "$.store.book[?(@.price<10)].size") == [
+        [10, 20, 30, 40],
+        [5, 10, 20, 30],
+    ]
 
     assert client.json().arrindex(
         "store", "$.store.book[?(@.price<10)].size", "20"
@@ -1328,7 +1321,7 @@ def test_arrindex_dollar(client):
         "3",
         [],
     ]
-    assert_resp_response(client, client.json().get("test_num", "$..arr"), res, [res])
+    assert client.json().get("test_num", "$..arr") == res
 
     assert client.json().arrindex("test_num", "$..arr", 3) == [3, 2, -1, None, -1]
 
@@ -1361,7 +1354,7 @@ def test_arrindex_dollar(client):
         "3",
         [],
     ]
-    assert_resp_response(client, client.json().get("test_string", "$..arr"), res, [res])
+    assert client.json().get("test_string", "$..arr") == res
 
     assert client.json().arrindex("test_string", "$..arr", "baz") == [
         3,
@@ -1454,7 +1447,7 @@ def test_arrindex_dollar(client):
         None,
         [],
     ]
-    assert_resp_response(client, client.json().get("test_None", "$..arr"), res, [res])
+    assert client.json().get("test_None", "$..arr") == res
 
     # Test with none-scalar value
     assert client.json().arrindex(
@@ -1495,7 +1488,7 @@ def test_custom_decoder(client):
 
     cj = client.json(encoder=ujson, decoder=ujson)
     assert cj.set("foo", Path.root_path(), "bar")
-    assert_resp_response(client, cj.get("foo"), "bar", [["bar"]])
+    assert cj.get("foo") == "bar"
     assert cj.get("baz") is None
     assert 1 == cj.delete("foo")
     assert client.exists("foo") == 0
@@ -1517,7 +1510,7 @@ def test_set_file(client):
     nojsonfile.write(b"Hello World")
 
     assert client.json().set_file("test", Path.root_path(), jsonfile.name)
-    assert_resp_response(client, client.json().get("test"), obj, [[obj]])
+    assert client.json().get("test") == obj
     with pytest.raises(json.JSONDecodeError):
         client.json().set_file("test2", Path.root_path(), nojsonfile.name)
 
@@ -1540,6 +1533,4 @@ def test_set_path(client):
     result = {jsonfile: True, nojsonfile: False}
     assert client.json().set_path(Path.root_path(), root) == result
     res = {"hello": "world"}
-    assert_resp_response(
-        client, client.json().get(jsonfile.rsplit(".")[0]), res, [[res]]
-    )
+    assert client.json().get(jsonfile.rsplit(".")[0]) == res
diff --git a/tests/test_timeseries.py b/tests/test_timeseries.py
index 5647bd45c6..95402a1cee 100644
--- a/tests/test_timeseries.py
+++ b/tests/test_timeseries.py
@@ -1039,8 +1039,12 @@ def test_create_with_insertion_filters(client):
     assert 1021 == client.ts().add("time-series-1", 1021, 22.0)
 
     data_points = client.ts().range("time-series-1", "-", "+")
-    expected_points = [(1000, 1.0), (1010, 11.0), (1020, 11.5), (1021, 22.0)]
-    assert expected_points == data_points
+    assert_resp_response(
+        client,
+        data_points,
+        [(1000, 1.0), (1010, 11.0), (1020, 11.5), (1021, 22.0)],
+        [[1000, 1.0], [1010, 11.0], [1020, 11.5], [1021, 22.0]],
+    )
 
 
 @skip_ifmodversion_lt("1.12.0", "timeseries")
@@ -1056,8 +1060,12 @@ def test_create_with_insertion_filters_other_duplicate_policy(client):
     assert 1013 == client.ts().add("time-series-1", 1013, 10.0)
 
     data_points = client.ts().range("time-series-1", "-", "+")
-    expected_points = [(1000, 1.0), (1010, 11.0), (1013, 10)]
-    assert expected_points == data_points
+    assert_resp_response(
+        client,
+        data_points,
+        [(1000, 1.0), (1010, 11.0), (1013, 10)],
+        [[1000, 1.0], [1010, 11.0], [1013, 10]],
+    )
 
 
 @skip_ifmodversion_lt("1.12.0", "timeseries")
@@ -1076,8 +1084,12 @@ def test_alter_with_insertion_filters(client):
     assert 1013 == client.ts().add("time-series-1", 1015, 11.5)
 
     data_points = client.ts().range("time-series-1", "-", "+")
-    expected_points = [(1000, 1.0), (1010, 11.0), (1013, 10.0)]
-    assert expected_points == data_points
+    assert_resp_response(
+        client,
+        data_points,
+        [(1000, 1.0), (1010, 11.0), (1013, 10.0)],
+        [[1000, 1.0], [1010, 11.0], [1013, 10.0]],
+    )
 
 
 @skip_ifmodversion_lt("1.12.0", "timeseries")
@@ -1094,8 +1106,7 @@ def test_add_with_insertion_filters(client):
     assert 1000 == client.ts().add("time-series-1", 1004, 3.0)
 
     data_points = client.ts().range("time-series-1", "-", "+")
-    expected_points = [(1000, 1.0)]
-    assert expected_points == data_points
+    assert_resp_response(client, data_points, [(1000, 1.0)], [[1000, 1.0]])
 
 
 @skip_ifmodversion_lt("1.12.0", "timeseries")
@@ -1112,14 +1123,12 @@ def test_incrby_with_insertion_filters(client):
     assert 1000 == client.ts().incrby("time-series-1", 3.0, timestamp=1000)
 
     data_points = client.ts().range("time-series-1", "-", "+")
-    expected_points = [(1000, 1.0)]
-    assert expected_points == data_points
+    assert_resp_response(client, data_points, [(1000, 1.0)], [[1000, 1.0]])
 
     assert 1000 == client.ts().incrby("time-series-1", 10.1, timestamp=1000)
 
     data_points = client.ts().range("time-series-1", "-", "+")
-    expected_points = [(1000, 11.1)]
-    assert expected_points == data_points
+    assert_resp_response(client, data_points, [(1000, 11.1)], [[1000, 11.1]])
 
 
 @skip_ifmodversion_lt("1.12.0", "timeseries")
@@ -1136,14 +1145,12 @@ def test_decrby_with_insertion_filters(client):
     assert 1000 == client.ts().decrby("time-series-1", 3.0, timestamp=1000)
 
     data_points = client.ts().range("time-series-1", "-", "+")
-    expected_points = [(1000, -1.0)]
-    assert expected_points == data_points
+    assert_resp_response(client, data_points, [(1000, -1.0)], [[1000, -1.0]])
 
     assert 1000 == client.ts().decrby("time-series-1", 10.1, timestamp=1000)
 
     data_points = client.ts().range("time-series-1", "-", "+")
-    expected_points = [(1000, -11.1)]
-    assert expected_points == data_points
+    assert_resp_response(client, data_points, [(1000, -11.1)], [[1000, -11.1]])
 
 
 @skip_ifmodversion_lt("1.12.0", "timeseries")
@@ -1165,5 +1172,9 @@ def test_madd_with_insertion_filters(client):
     )
 
     data_points = client.ts().range("time-series-1", "-", "+")
-    expected_points = [(1010, 1.0), (1020, 2.0), (1021, 22.0)]
-    assert expected_points == data_points
+    assert_resp_response(
+        client,
+        data_points,
+        [(1010, 1.0), (1020, 2.0), (1021, 22.0)],
+        [[1010, 1.0], [1020, 2.0], [1021, 22.0]],
+    )

From caf4b209f13badaa38fcf4e3bf3ef2d5e4b390d1 Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@redis.com>
Date: Wed, 19 Jun 2024 13:45:08 +0300
Subject: [PATCH 0898/1164] Add CODECOV token to CI (#3285)

We did not push code coverage from the master branch
since a while. Try to add a Codecov token, to get back on
track.
---
 .github/workflows/integration.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index a211e5d403..6bddc1cf4e 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -25,6 +25,7 @@ permissions:
 
 env:
   REDIS_STACK_IMAGE: redis/redis-stack-server:7.4.0-rc1
+  CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
 
 jobs:
   dependency-audit:

From d288a297fd09f52c89ec6dcc46f89b3a6f1bfdf5 Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@redis.com>
Date: Wed, 19 Jun 2024 14:39:43 +0300
Subject: [PATCH 0899/1164] Do not restrict pytest dependencies versions
 (#3286)

Try to not restrict the versions of pytest dependencies, see if we can
get rid of the segmentation faults that we see pretty often in the CI.

Take the opportunity to sort the dev_requirements.txt file.
---
 dev_requirements.txt | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/dev_requirements.txt b/dev_requirements.txt
index 48ec278d83..b1e10f9682 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -1,18 +1,18 @@
-click==8.0.4
 black==24.3.0
 cachetools
-flake8==5.0.4
+click==8.0.4
 flake8-isort==6.0.0
+flake8==5.0.4
 flynt~=0.69.0
+invoke==1.7.3
 mock==4.0.3
 packaging>=20.4
-pytest==7.2.0
-pytest-timeout==2.1.0
-pytest-asyncio>=0.20.2
-invoke==1.7.3
-pytest-cov>=4.0.0
-vulture>=2.3.0
+pytest
+pytest-asyncio
+pytest-cov
+pytest-timeout
 ujson>=4.2.0
-wheel>=0.30.0
 urllib3<2
 uvloop
+vulture>=2.3.0
+wheel>=0.30.0

From 12b040e6bf6f5210a3389c720c09a4796a95f443 Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@redis.com>
Date: Thu, 20 Jun 2024 10:17:27 +0300
Subject: [PATCH 0900/1164] Re-enable Graph tests (#3287)

Although the Graph module was deprecated, we want to have tests running
as long as we keep the client code. Therefore re-enable the Graph tests, by
adding to the docker-compose stack an older redis-stack-server image. The
Graph tests run only with RESP2.

Tweak the CI so that it runs against the latest RC release for now. This way
we get all the features in RC release of server, so we can execute all tests,
including the ones for hash field expiration.

Some test failures brought to light issues with the RESP3 push message
invalidation handler, align a bit the code in that area.

Some more housekeeping around tests, here and there.
---
 .github/workflows/integration.yaml |  3 +-
 docker-compose.yml                 | 19 +++++++++---
 dockers/create_cluster.sh          |  6 ++--
 redis/_parsers/resp3.py            | 22 ++++++++-----
 tests/conftest.py                  |  7 +++++
 tests/test_asyncio/test_graph.py   | 43 ++++++++++++-------------
 tests/test_commands.py             | 10 ++++--
 tests/test_graph.py                | 50 ++++++++++++++++--------------
 tests/test_timeseries.py           |  7 +++++
 9 files changed, 102 insertions(+), 65 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 6bddc1cf4e..f6186b8271 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -24,8 +24,9 @@ permissions:
   contents: read  #  to fetch code (actions/checkout)
 
 env:
-  REDIS_STACK_IMAGE: redis/redis-stack-server:7.4.0-rc1
   CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+  REDIS_IMAGE: redis/redis-stack-server:7.4.0-rc1
+  REDIS_STACK_IMAGE: redis/redis-stack-server:7.4.0-rc1
 
 jobs:
   dependency-audit:
diff --git a/docker-compose.yml b/docker-compose.yml
index 72c43c2252..c8528a7d58 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -7,7 +7,7 @@ services:
   redis:
     image: ${REDIS_IMAGE:-redis:latest}
     container_name: redis-standalone
-    command: redis-server --enable-debug-command yes
+    command: redis-server --enable-debug-command yes --protected-mode no
     ports:
       - 6379:6379
     profiles:
@@ -21,7 +21,7 @@ services:
     container_name: redis-replica
     depends_on:
       - redis
-    command: redis-server --replicaof redis 6379
+    command: redis-server --replicaof redis 6379 --protected-mode no
     ports:
       - 6380:6379
     profiles:
@@ -67,7 +67,7 @@ services:
     container_name: redis-sentinel
     depends_on:
       - redis
-    entrypoint: "/usr/local/bin/redis-sentinel /redis.conf --port 26379"
+    entrypoint: "redis-sentinel /redis.conf --port 26379"
     ports:
       - 26379:26379
     volumes:
@@ -81,7 +81,7 @@ services:
     container_name: redis-sentinel2
     depends_on:
       - redis
-    entrypoint: "/usr/local/bin/redis-sentinel /redis.conf --port 26380"
+    entrypoint: "redis-sentinel /redis.conf --port 26380"
     ports:
       - 26380:26380
     volumes:
@@ -95,7 +95,7 @@ services:
     container_name: redis-sentinel3
     depends_on:
       - redis
-    entrypoint: "/usr/local/bin/redis-sentinel /redis.conf --port 26381"
+    entrypoint: "redis-sentinel /redis.conf --port 26381"
     ports:
       - 26381:26381
     volumes:
@@ -114,3 +114,12 @@ services:
     profiles:
       - standalone
       - all
+
+  redis-stack-graph:
+    image: redis/redis-stack-server:6.2.6-v15
+    container_name: redis-stack-graph
+    ports:
+      - 6480:6379
+    profiles:
+      - standalone
+      - all
diff --git a/dockers/create_cluster.sh b/dockers/create_cluster.sh
index af41192585..dc17c7c4d9 100644
--- a/dockers/create_cluster.sh
+++ b/dockers/create_cluster.sh
@@ -31,7 +31,7 @@ dir /nodes/$PORT
 EOF
 
   set -x
-  /usr/local/bin/redis-server /nodes/$PORT/redis.conf
+  redis-server /nodes/$PORT/redis.conf
   sleep 1
   if [ $? -ne 0 ]; then
     echo "Redis failed to start, exiting."
@@ -40,8 +40,8 @@ EOF
   echo 127.0.0.1:$PORT >> /nodes/nodemap
 done
 if [ -z "${REDIS_PASSWORD}" ]; then
-    echo yes | /usr/local/bin/redis-cli --cluster create `seq -f 127.0.0.1:%g ${START_PORT} ${END_PORT}` --cluster-replicas 1
+    echo yes | redis-cli --cluster create `seq -f 127.0.0.1:%g ${START_PORT} ${END_PORT}` --cluster-replicas 1
 else
-    echo yes | /usr/local/bin/redis-cli -a ${REDIS_PASSWORD} --cluster create `seq -f 127.0.0.1:%g ${START_PORT} ${END_PORT}` --cluster-replicas 1
+    echo yes | redis-cli -a ${REDIS_PASSWORD} --cluster create `seq -f 127.0.0.1:%g ${START_PORT} ${END_PORT}` --cluster-replicas 1
 fi
 tail -f /redis.log
diff --git a/redis/_parsers/resp3.py b/redis/_parsers/resp3.py
index 7afa43a0c2..cc210b9df5 100644
--- a/redis/_parsers/resp3.py
+++ b/redis/_parsers/resp3.py
@@ -15,7 +15,7 @@ class _RESP3Parser(_RESPBase):
     def __init__(self, socket_read_size):
         super().__init__(socket_read_size)
         self.pubsub_push_handler_func = self.handle_pubsub_push_response
-        self.invalidations_push_handler_func = None
+        self.invalidation_push_handler_func = None
 
     def handle_pubsub_push_response(self, response):
         logger = getLogger("push_response")
@@ -129,7 +129,10 @@ def _read_response(self, disable_decoding=False, push_request=False):
 
     def handle_push_response(self, response, disable_decoding, push_request):
         if response[0] in _INVALIDATION_MESSAGE:
-            res = self.invalidation_push_handler_func(response)
+            if self.invalidation_push_handler_func:
+                res = self.invalidation_push_handler_func(response)
+            else:
+                res = None
         else:
             res = self.pubsub_push_handler_func(response)
         if not push_request:
@@ -142,15 +145,15 @@ def handle_push_response(self, response, disable_decoding, push_request):
     def set_pubsub_push_handler(self, pubsub_push_handler_func):
         self.pubsub_push_handler_func = pubsub_push_handler_func
 
-    def set_invalidation_push_handler(self, invalidations_push_handler_func):
-        self.invalidation_push_handler_func = invalidations_push_handler_func
+    def set_invalidation_push_handler(self, invalidation_push_handler_func):
+        self.invalidation_push_handler_func = invalidation_push_handler_func
 
 
 class _AsyncRESP3Parser(_AsyncRESPBase):
     def __init__(self, socket_read_size):
         super().__init__(socket_read_size)
         self.pubsub_push_handler_func = self.handle_pubsub_push_response
-        self.invalidations_push_handler_func = None
+        self.invalidation_push_handler_func = None
 
     def handle_pubsub_push_response(self, response):
         logger = getLogger("push_response")
@@ -273,7 +276,10 @@ async def _read_response(
 
     async def handle_push_response(self, response, disable_decoding, push_request):
         if response[0] in _INVALIDATION_MESSAGE:
-            res = self.invalidation_push_handler_func(response)
+            if self.invalidation_push_handler_func:
+                res = self.invalidation_push_handler_func(response)
+            else:
+                res = None
         else:
             res = self.pubsub_push_handler_func(response)
         if not push_request:
@@ -286,5 +292,5 @@ async def handle_push_response(self, response, disable_decoding, push_request):
     def set_pubsub_push_handler(self, pubsub_push_handler_func):
         self.pubsub_push_handler_func = pubsub_push_handler_func
 
-    def set_invalidation_push_handler(self, invalidations_push_handler_func):
-        self.invalidation_push_handler_func = invalidations_push_handler_func
+    def set_invalidation_push_handler(self, invalidation_push_handler_func):
+        self.invalidation_push_handler_func = invalidation_push_handler_func
diff --git a/tests/conftest.py b/tests/conftest.py
index 6df6875845..e3326f85d5 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -135,6 +135,8 @@ def _get_info(redis_url):
 def pytest_sessionstart(session):
     # during test discovery, e.g. with VS Code, we may not
     # have a server running.
+    protocol = session.config.getoption("--protocol")
+    REDIS_INFO["resp_version"] = int(protocol) if protocol else None
     redis_url = session.config.getoption("--redis-url")
     try:
         info = _get_info(redis_url)
@@ -279,6 +281,11 @@ def skip_if_cryptography() -> _TestDecorator:
         return pytest.mark.skipif(False, reason="No cryptography dependency")
 
 
+def skip_if_resp_version(resp_version) -> _TestDecorator:
+    check = REDIS_INFO.get("resp_version", None) == resp_version
+    return pytest.mark.skipif(check, reason=f"RESP version required != {resp_version}")
+
+
 def _get_client(
     cls, request, single_connection_client=True, flushdb=True, from_url=None, **kwargs
 ):
diff --git a/tests/test_asyncio/test_graph.py b/tests/test_asyncio/test_graph.py
index ab8bf17618..2014ea38b6 100644
--- a/tests/test_asyncio/test_graph.py
+++ b/tests/test_asyncio/test_graph.py
@@ -4,15 +4,16 @@
 from redis.commands.graph import Edge, Node, Path
 from redis.commands.graph.execution_plan import Operation
 from redis.exceptions import ResponseError
-from tests.conftest import skip_if_redis_enterprise
+from tests.conftest import skip_if_redis_enterprise, skip_if_resp_version
 
 
 @pytest_asyncio.fixture()
 async def decoded_r(create_redis, stack_url):
-    return await create_redis(decode_responses=True, url=stack_url)
+    return await create_redis(decode_responses=True, url="redis://localhost:6480")
 
 
 @pytest.mark.redismod
+@skip_if_resp_version(3)
 async def test_bulk(decoded_r):
     with pytest.raises(NotImplementedError):
         await decoded_r.graph().bulk()
@@ -20,7 +21,7 @@ async def test_bulk(decoded_r):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 async def test_graph_creation(decoded_r: redis.Redis):
     graph = decoded_r.graph()
 
@@ -66,7 +67,7 @@ async def test_graph_creation(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 async def test_array_functions(decoded_r: redis.Redis):
     graph = decoded_r.graph()
 
@@ -90,7 +91,7 @@ async def test_array_functions(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 async def test_path(decoded_r: redis.Redis):
     node0 = Node(node_id=0, label="L1")
     node1 = Node(node_id=1, label="L1")
@@ -111,7 +112,7 @@ async def test_path(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 async def test_param(decoded_r: redis.Redis):
     params = [1, 2.3, "str", True, False, None, [0, 1, 2]]
     query = "RETURN $param"
@@ -122,7 +123,7 @@ async def test_param(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 async def test_map(decoded_r: redis.Redis):
     query = "RETURN {a:1, b:'str', c:NULL, d:[1,2,3], e:True, f:{x:1, y:2}}"
 
@@ -140,7 +141,7 @@ async def test_map(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 async def test_point(decoded_r: redis.Redis):
     query = "RETURN point({latitude: 32.070794860, longitude: 34.820751118})"
     expected_lat = 32.070794860
@@ -158,7 +159,7 @@ async def test_point(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 async def test_index_response(decoded_r: redis.Redis):
     result_set = await decoded_r.graph().query("CREATE INDEX ON :person(age)")
     assert 1 == result_set.indices_created
@@ -174,7 +175,7 @@ async def test_index_response(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 async def test_stringify_query_result(decoded_r: redis.Redis):
     graph = decoded_r.graph()
 
@@ -229,7 +230,7 @@ async def test_stringify_query_result(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 async def test_optional_match(decoded_r: redis.Redis):
     # Build a graph of form (a)-[R]->(b)
     node0 = Node(node_id=0, label="L1", properties={"value": "a"})
@@ -255,7 +256,7 @@ async def test_optional_match(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 async def test_cached_execution(decoded_r: redis.Redis):
     await decoded_r.graph().query("CREATE ()")
 
@@ -276,7 +277,7 @@ async def test_cached_execution(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 async def test_slowlog(decoded_r: redis.Redis):
     create_query = """CREATE
     (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
@@ -291,7 +292,7 @@ async def test_slowlog(decoded_r: redis.Redis):
 
 @pytest.mark.xfail(strict=False)
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 async def test_query_timeout(decoded_r: redis.Redis):
     # Build a sample graph with 1000 nodes.
     await decoded_r.graph().query("UNWIND range(0,1000) as val CREATE ({v: val})")
@@ -306,7 +307,7 @@ async def test_query_timeout(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 async def test_read_only_query(decoded_r: redis.Redis):
     with pytest.raises(Exception):
         # Issue a write query, specifying read-only true,
@@ -316,7 +317,7 @@ async def test_read_only_query(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 async def test_profile(decoded_r: redis.Redis):
     q = """UNWIND range(1, 3) AS x CREATE (p:Person {v:x})"""
     profile = (await decoded_r.graph().profile(q)).result_set
@@ -333,7 +334,7 @@ async def test_profile(decoded_r: redis.Redis):
 
 @skip_if_redis_enterprise()
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 async def test_config(decoded_r: redis.Redis):
     config_name = "RESULTSET_SIZE"
     config_value = 3
@@ -366,7 +367,7 @@ async def test_config(decoded_r: redis.Redis):
 
 @pytest.mark.onlynoncluster
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 async def test_list_keys(decoded_r: redis.Redis):
     result = await decoded_r.graph().list_keys()
     assert result == []
@@ -390,7 +391,7 @@ async def test_list_keys(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 async def test_multi_label(decoded_r: redis.Redis):
     redis_graph = decoded_r.graph("g")
 
@@ -417,7 +418,7 @@ async def test_multi_label(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 async def test_execution_plan(decoded_r: redis.Redis):
     redis_graph = decoded_r.graph("execution_plan")
     create_query = """CREATE
@@ -437,7 +438,7 @@ async def test_execution_plan(decoded_r: redis.Redis):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 async def test_explain(decoded_r: redis.Redis):
     redis_graph = decoded_r.graph("execution_plan")
     # graph creation / population
diff --git a/tests/test_commands.py b/tests/test_commands.py
index aab2a227ed..42376b50d8 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -712,11 +712,15 @@ def test_client_kill_filter_by_user(self, r, request):
     @skip_if_redis_enterprise()
     @pytest.mark.onlynoncluster
     def test_client_kill_filter_by_maxage(self, r, request):
-        _get_client(redis.Redis, request, flushdb=False)
+        r2 = _get_client(redis.Redis, request, flushdb=False)
+        name = "target-foobar"
+        r2.client_setname(name)
         time.sleep(4)
-        assert len(r.client_list()) >= 2
+        initial_clients = [c["name"] for c in r.client_list()]
+        assert name in initial_clients
         r.client_kill_filter(maxage=2)
-        assert len(r.client_list()) == 1
+        final_clients = [c["name"] for c in r.client_list()]
+        assert name not in final_clients
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.9.50")
diff --git a/tests/test_graph.py b/tests/test_graph.py
index 7f46a538ff..680b8af645 100644
--- a/tests/test_graph.py
+++ b/tests/test_graph.py
@@ -20,18 +20,20 @@
     QueryResult,
 )
 from redis.exceptions import ResponseError
-from tests.conftest import _get_client, skip_if_redis_enterprise
+from tests.conftest import _get_client, skip_if_redis_enterprise, skip_if_resp_version
 
 
 @pytest.fixture
 def client(request, stack_url):
-    r = _get_client(Redis, request, decode_responses=True, from_url=stack_url)
+    r = _get_client(
+        Redis, request, decode_responses=True, from_url="redis://localhost:6480"
+    )
     r.flushdb()
     return r
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 def test_bulk(client):
     with pytest.raises(NotImplementedError):
         client.graph().bulk()
@@ -39,7 +41,7 @@ def test_bulk(client):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 def test_graph_creation(client):
     graph = client.graph()
 
@@ -85,7 +87,7 @@ def test_graph_creation(client):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 def test_array_functions(client):
     query = """CREATE (p:person{name:'a',age:32, array:[0,1,2]})"""
     client.graph().query(query)
@@ -107,7 +109,7 @@ def test_array_functions(client):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 def test_path(client):
     node0 = Node(node_id=0, label="L1")
     node1 = Node(node_id=1, label="L1")
@@ -128,7 +130,7 @@ def test_path(client):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 def test_param(client):
     params = [1, 2.3, "str", True, False, None, [0, 1, 2], r"\" RETURN 1337 //"]
     query = "RETURN $param"
@@ -139,7 +141,7 @@ def test_param(client):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 def test_map(client):
     query = "RETURN {a:1, b:'str', c:NULL, d:[1,2,3], e:True, f:{x:1, y:2}}"
 
@@ -157,7 +159,7 @@ def test_map(client):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 def test_point(client):
     query = "RETURN point({latitude: 32.070794860, longitude: 34.820751118})"
     expected_lat = 32.070794860
@@ -175,7 +177,7 @@ def test_point(client):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 def test_index_response(client):
     result_set = client.graph().query("CREATE INDEX ON :person(age)")
     assert 1 == result_set.indices_created
@@ -191,7 +193,7 @@ def test_index_response(client):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 def test_stringify_query_result(client):
     graph = client.graph()
 
@@ -246,7 +248,7 @@ def test_stringify_query_result(client):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 def test_optional_match(client):
     # Build a graph of form (a)-[R]->(b)
     node0 = Node(node_id=0, label="L1", properties={"value": "a"})
@@ -272,7 +274,7 @@ def test_optional_match(client):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 def test_cached_execution(client):
     client.graph().query("CREATE ()")
 
@@ -291,7 +293,7 @@ def test_cached_execution(client):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 def test_slowlog(client):
     create_query = """CREATE (:Rider
     {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
@@ -305,8 +307,8 @@ def test_slowlog(client):
 
 
 @pytest.mark.redismod
+@skip_if_resp_version(3)
 @pytest.mark.xfail(strict=False)
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_query_timeout(client):
     # Build a sample graph with 1000 nodes.
     client.graph().query("UNWIND range(0,1000) as val CREATE ({v: val})")
@@ -321,7 +323,7 @@ def test_query_timeout(client):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 def test_read_only_query(client):
     with pytest.raises(Exception):
         # Issue a write query, specifying read-only true,
@@ -331,7 +333,7 @@ def test_read_only_query(client):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 def test_profile(client):
     q = """UNWIND range(1, 3) AS x CREATE (p:Person {v:x})"""
     profile = client.graph().profile(q).result_set
@@ -347,8 +349,8 @@ def test_profile(client):
 
 
 @pytest.mark.redismod
+@skip_if_resp_version(3)
 @skip_if_redis_enterprise()
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
 def test_config(client):
     config_name = "RESULTSET_SIZE"
     config_value = 3
@@ -381,7 +383,7 @@ def test_config(client):
 
 @pytest.mark.onlynoncluster
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 def test_list_keys(client):
     result = client.graph().list_keys()
     assert result == []
@@ -405,7 +407,7 @@ def test_list_keys(client):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 def test_multi_label(client):
     redis_graph = client.graph("g")
 
@@ -432,7 +434,7 @@ def test_multi_label(client):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 def test_cache_sync(client):
     pass
     return
@@ -506,7 +508,7 @@ def test_cache_sync(client):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 def test_execution_plan(client):
     redis_graph = client.graph("execution_plan")
     create_query = """CREATE
@@ -526,7 +528,7 @@ def test_execution_plan(client):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 def test_explain(client):
     redis_graph = client.graph("execution_plan")
     # graph creation / population
@@ -616,7 +618,7 @@ def test_explain(client):
 
 
 @pytest.mark.redismod
-@pytest.mark.skip(reason="Graph module removed from Redis Stack")
+@skip_if_resp_version(3)
 def test_resultset_statistics(client):
     with patch.object(target=QueryResult, attribute="_get_stat") as mock_get_stats:
         result = client.graph().query("RETURN 1")
diff --git a/tests/test_timeseries.py b/tests/test_timeseries.py
index 95402a1cee..90e627ef6e 100644
--- a/tests/test_timeseries.py
+++ b/tests/test_timeseries.py
@@ -1024,6 +1024,7 @@ def test_uncompressed(client):
         assert compressed_info["memoryUsage"] < uncompressed_info["memoryUsage"]
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.12.0", "timeseries")
 def test_create_with_insertion_filters(client):
     client.ts().create(
@@ -1047,6 +1048,7 @@ def test_create_with_insertion_filters(client):
     )
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.12.0", "timeseries")
 def test_create_with_insertion_filters_other_duplicate_policy(client):
     client.ts().create(
@@ -1068,6 +1070,7 @@ def test_create_with_insertion_filters_other_duplicate_policy(client):
     )
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.12.0", "timeseries")
 def test_alter_with_insertion_filters(client):
     assert 1000 == client.ts().add("time-series-1", 1000, 1.0)
@@ -1092,6 +1095,7 @@ def test_alter_with_insertion_filters(client):
     )
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.12.0", "timeseries")
 def test_add_with_insertion_filters(client):
     assert 1000 == client.ts().add(
@@ -1109,6 +1113,7 @@ def test_add_with_insertion_filters(client):
     assert_resp_response(client, data_points, [(1000, 1.0)], [[1000, 1.0]])
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.12.0", "timeseries")
 def test_incrby_with_insertion_filters(client):
     assert 1000 == client.ts().incrby(
@@ -1131,6 +1136,7 @@ def test_incrby_with_insertion_filters(client):
     assert_resp_response(client, data_points, [(1000, 11.1)], [[1000, 11.1]])
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.12.0", "timeseries")
 def test_decrby_with_insertion_filters(client):
     assert 1000 == client.ts().decrby(
@@ -1153,6 +1159,7 @@ def test_decrby_with_insertion_filters(client):
     assert_resp_response(client, data_points, [(1000, -11.1)], [[1000, -11.1]])
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.12.0", "timeseries")
 def test_madd_with_insertion_filters(client):
     client.ts().create(

From 70b4f4886e5e2af3f0da40d6643953cca8f7d94e Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@redis.com>
Date: Thu, 20 Jun 2024 11:11:48 +0300
Subject: [PATCH 0901/1164] Version 5.1.0b7 (#3288)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 8df216ccea..ab1cb9631f 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="5.1.0b6",
+    version="5.1.0b7",
     packages=find_packages(
         include=[
             "redis",

From b7f9a4c02aeb687d4db307a63cff0fb24aaec427 Mon Sep 17 00:00:00 2001
From: David Maier <60782329+dmaier-redislabs@users.noreply.github.com>
Date: Tue, 25 Jun 2024 13:14:13 +0200
Subject: [PATCH 0902/1164] Fixes CAE-333 (#3290)

* Fixes CAE-333, which uncovered that the init method of the base
class did override the initialization of the socket_timeout parameter.

* Added missing blank lines

* Removed blank line

* Changed to quotes

---------

Co-authored-by: vladvildanov <divinez122@outlook.com>
---
 redis/connection.py   |  2 +-
 tests/test_connect.py | 17 +++++++++++++++++
 2 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/redis/connection.py b/redis/connection.py
index f745ecc1d5..728c221257 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -909,9 +909,9 @@ class UnixDomainSocketConnection(AbstractConnection):
     "Manages UDS communication to and from a Redis server"
 
     def __init__(self, path="", socket_timeout=None, **kwargs):
+        super().__init__(**kwargs)
         self.path = path
         self.socket_timeout = socket_timeout
-        super().__init__(**kwargs)
 
     def repr_pieces(self):
         pieces = [("path", self.path), ("db", self.db)]
diff --git a/tests/test_connect.py b/tests/test_connect.py
index 71986dd8f3..d7ca04b651 100644
--- a/tests/test_connect.py
+++ b/tests/test_connect.py
@@ -98,6 +98,23 @@ def test_tcp_ssl_tls12_custom_ciphers(tcp_address, ssl_ciphers):
     _assert_connect(conn, tcp_address, certfile=certfile, keyfile=keyfile)
 
 
+"""
+Addresses bug CAE-333 which uncovered that the init method of the base
+class did override the initialization of the socket_timeout parameter.
+"""
+
+
+def test_unix_socket_with_timeout():
+    conn = UnixDomainSocketConnection(socket_timeout=1000)
+
+    # Check if the base class defaults were taken over.
+    assert conn.db == 0
+
+    # Verify if the timeout and the path is set correctly.
+    assert conn.socket_timeout == 1000
+    assert conn.path == ""
+
+
 @pytest.mark.ssl
 @pytest.mark.skipif(not ssl.HAS_TLSv1_3, reason="requires TLSv1.3")
 def test_tcp_ssl_version_mismatch(tcp_address):

From 54e1f0cd1d050740c9cb23d7d30230830c01c701 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 3 Jul 2024 12:24:47 +0300
Subject: [PATCH 0903/1164] Bump rojopolis/spellcheck-github-actions from
 0.37.0 to 0.38.0 (#3301)

Bumps [rojopolis/spellcheck-github-actions](https://github.com/rojopolis/spellcheck-github-actions) from 0.37.0 to 0.38.0.
- [Release notes](https://github.com/rojopolis/spellcheck-github-actions/releases)
- [Changelog](https://github.com/rojopolis/spellcheck-github-actions/blob/master/CHANGELOG.md)
- [Commits](https://github.com/rojopolis/spellcheck-github-actions/compare/0.37.0...0.38.0)

---
updated-dependencies:
- dependency-name: rojopolis/spellcheck-github-actions
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/spellcheck.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/spellcheck.yml b/.github/workflows/spellcheck.yml
index 451e508376..62e38997e4 100644
--- a/.github/workflows/spellcheck.yml
+++ b/.github/workflows/spellcheck.yml
@@ -8,7 +8,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
       - name: Check Spelling
-        uses: rojopolis/spellcheck-github-actions@0.37.0
+        uses: rojopolis/spellcheck-github-actions@0.38.0
         with:
           config_path: .github/spellcheck-settings.yml
           task_name: Markdown

From ee2a98b2b7d777e4a636d18d47f377c6ef71a7b2 Mon Sep 17 00:00:00 2001
From: Max Muoto <maxmuoto@gmail.com>
Date: Wed, 3 Jul 2024 06:48:29 -0500
Subject: [PATCH 0904/1164] Add missing type hints for `retry.py` (#3250)

Add missing type hints in the retry.py file and related tests.
---
 redis/retry.py      | 26 +++++++++++++++++++++-----
 tests/test_retry.py |  4 ++--
 2 files changed, 23 insertions(+), 7 deletions(-)

diff --git a/redis/retry.py b/redis/retry.py
index 606443053e..03fd973c4c 100644
--- a/redis/retry.py
+++ b/redis/retry.py
@@ -1,17 +1,27 @@
 import socket
 from time import sleep
+from typing import TYPE_CHECKING, Any, Callable, Iterable, Tuple, Type, TypeVar
 
 from redis.exceptions import ConnectionError, TimeoutError
 
+T = TypeVar("T")
+
+if TYPE_CHECKING:
+    from redis.backoff import AbstractBackoff
+
 
 class Retry:
     """Retry a specific number of times after a failure"""
 
     def __init__(
         self,
-        backoff,
-        retries,
-        supported_errors=(ConnectionError, TimeoutError, socket.timeout),
+        backoff: "AbstractBackoff",
+        retries: int,
+        supported_errors: Tuple[Type[Exception], ...] = (
+            ConnectionError,
+            TimeoutError,
+            socket.timeout,
+        ),
     ):
         """
         Initialize a `Retry` object with a `Backoff` object
@@ -24,7 +34,9 @@ def __init__(
         self._retries = retries
         self._supported_errors = supported_errors
 
-    def update_supported_errors(self, specified_errors: list):
+    def update_supported_errors(
+        self, specified_errors: Iterable[Type[Exception]]
+    ) -> None:
         """
         Updates the supported errors with the specified error types
         """
@@ -32,7 +44,11 @@ def update_supported_errors(self, specified_errors: list):
             set(self._supported_errors + tuple(specified_errors))
         )
 
-    def call_with_retry(self, do, fail):
+    def call_with_retry(
+        self,
+        do: Callable[[], T],
+        fail: Callable[[Exception], Any],
+    ) -> T:
         """
         Execute an operation that might fail and returns its result, or
         raise the exception that was thrown depending on the `Backoff` object.
diff --git a/tests/test_retry.py b/tests/test_retry.py
index e9d3015897..183807386d 100644
--- a/tests/test_retry.py
+++ b/tests/test_retry.py
@@ -1,7 +1,7 @@
 from unittest.mock import patch
 
 import pytest
-from redis.backoff import ExponentialBackoff, NoBackoff
+from redis.backoff import AbstractBackoff, ExponentialBackoff, NoBackoff
 from redis.client import Redis
 from redis.connection import Connection, UnixDomainSocketConnection
 from redis.exceptions import (
@@ -15,7 +15,7 @@
 from .conftest import _get_client
 
 
-class BackoffMock:
+class BackoffMock(AbstractBackoff):
     def __init__(self):
         self.reset_calls = 0
         self.calls = 0

From 57af28562dc042a10228cd2da6686a370cead823 Mon Sep 17 00:00:00 2001
From: dkuser <dima.kanev@gmail.com>
Date: Wed, 3 Jul 2024 21:40:42 +0400
Subject: [PATCH 0905/1164] Add details to the asyncio connection error message
 (#3211)

For asyncio connection errors, include the details in the error message,
instead of only including the error code.

Co-authored-by: dmitry.kanev <dmitry.kanev@dualbootpartners.com>
Co-authored-by: Gabriel Erzse <gabriel.erzse@redis.com>
---
 redis/asyncio/connection.py           |  2 +-
 tests/test_asyncio/test_connection.py | 18 ++++++++++++++++++
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 96f18876ea..b3dae2a27b 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -817,7 +817,7 @@ def _error_message(self, exception: BaseException) -> str:
         else:
             return (
                 f"Error {exception.args[0]} connecting to {host_error}. "
-                f"{exception.args[0]}."
+                f"{exception}."
             )
 
 
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index 4ff3808602..6255ae7d6d 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -491,3 +491,21 @@ async def test_connection_garbage_collection(request):
 
     await client.aclose()
     await pool.aclose()
+
+
+@pytest.mark.parametrize(
+    "error, expected_message",
+    [
+        (OSError(), "Error connecting to localhost:6379. Connection reset by peer"),
+        (OSError(12), "Error connecting to localhost:6379. 12."),
+        (
+            OSError(12, "Some Error"),
+            "Error 12 connecting to localhost:6379. [Errno 12] Some Error.",
+        ),
+    ],
+)
+async def test_connect_error_message(error, expected_message):
+    """Test that the _error_message function formats errors correctly"""
+    conn = Connection()
+    error_message = conn._error_message(error)
+    assert error_message == expected_message

From 04962e0a7aa9e85f35b4c85c7d9c056fc10ebd87 Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@redis.com>
Date: Thu, 4 Jul 2024 17:49:18 +0300
Subject: [PATCH 0906/1164] Prepare for Redis 7.4 RC2 (#3303)

Adapt the code and some of the tests to match the changes done in the
Redis 7.4 RC2 release.
---
 .github/workflows/integration.yaml |  4 +--
 redis/commands/core.py             | 45 ++++++++++++------------------
 tests/test_asyncio/test_hash.py    |  8 +++---
 tests/test_asyncio/test_json.py    |  2 +-
 tests/test_hash.py                 | 18 ++++++------
 tests/test_json.py                 |  2 +-
 tests/test_search.py               | 33 +++++++++++-----------
 7 files changed, 52 insertions(+), 60 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index f6186b8271..a619275b47 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -25,8 +25,8 @@ permissions:
 
 env:
   CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
-  REDIS_IMAGE: redis/redis-stack-server:7.4.0-rc1
-  REDIS_STACK_IMAGE: redis/redis-stack-server:7.4.0-rc1
+  REDIS_IMAGE: redis:7.4-rc2
+  REDIS_STACK_IMAGE: redis/redis-stack-server:7.4.0-rc2
 
 jobs:
   dependency-audit:
diff --git a/redis/commands/core.py b/redis/commands/core.py
index a56b3d2cba..26af9eb99c 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -5126,9 +5126,8 @@ def hexpire(
             lt: Set expiry only when the new expiry is less than the current one.
 
         Returns:
-            If the key does not exist, returns an empty list. If the key exists, returns
-            a list which contains for each field in the request:
-                - `-2` if the field does not exist.
+            Returns a list which contains for each field in the request:
+                - `-2` if the field does not exist, or if the key does not exist.
                 - `0` if the specified NX | XX | GT | LT condition was not met.
                 - `1` if the expiration time was set or updated.
                 - `2` if the field was deleted because the specified expiration time is
@@ -5187,9 +5186,8 @@ def hpexpire(
             lt: Set expiry only when the new expiry is less than the current one.
 
         Returns:
-            If the key does not exist, returns an empty list. If the key exists, returns
-            a list which contains for each field in the request:
-                - `-2` if the field does not exist.
+            Returns a list which contains for each field in the request:
+                - `-2` if the field does not exist, or if the key does not exist.
                 - `0` if the specified NX | XX | GT | LT condition was not met.
                 - `1` if the expiration time was set or updated.
                 - `2` if the field was deleted because the specified expiration time is
@@ -5248,9 +5246,8 @@ def hexpireat(
             lt: Set expiry only when the new expiry is less than the current one.
 
         Returns:
-            If the key does not exist, returns an empty list. If the key exists, returns
-            a list which contains for each field in the request:
-                - `-2` if the field does not exist.
+            Returns a list which contains for each field in the request:
+                - `-2` if the field does not exist, or if the key does not exist.
                 - `0` if the specified NX | XX | GT | LT condition was not met.
                 - `1` if the expiration time was set or updated.
                 - `2` if the field was deleted because the specified expiration time is
@@ -5315,9 +5312,8 @@ def hpexpireat(
             lt: Set expiry only when the new expiry is less than the current one.
 
         Returns:
-            If the key does not exist, returns an empty list. If the key exists, returns
-            a list which contains for each field in the request:
-                - `-2` if the field does not exist.
+            Returns a list which contains for each field in the request:
+                - `-2` if the field does not exist, or if the key does not exist.
                 - `0` if the specified NX | XX | GT | LT condition was not met.
                 - `1` if the expiration time was set or updated.
                 - `2` if the field was deleted because the specified expiration time is
@@ -5362,9 +5358,8 @@ def hpersist(self, name: KeyT, *fields: str) -> ResponseT:
                     expiration time.
 
         Returns:
-            If the key does not exist, returns an empty list. If the key exists, returns
-            a list which contains for each field in the request:
-                - `-2` if the field does not exist.
+            Returns a list which contains for each field in the request:
+                - `-2` if the field does not exist, or if the key does not exist.
                 - `-1` if the field exists but has no associated expiration time.
                 - `1` if the expiration time was successfully removed from the field.
         """
@@ -5382,9 +5377,8 @@ def hexpiretime(self, key: KeyT, *fields: str) -> ResponseT:
                     time.
 
         Returns:
-            If the key does not exist, returns an empty list. If the key exists, returns
-            a list which contains for each field in the request:
-                - `-2` if the field does not exist.
+            Returns a list which contains for each field in the request:
+                - `-2` if the field does not exist, or if the key does not exist.
                 - `-1` if the field exists but has no associated expire time.
                 - A positive integer representing the expiration Unix timestamp in
                   seconds, if the field has an associated expiration time.
@@ -5405,9 +5399,8 @@ def hpexpiretime(self, key: KeyT, *fields: str) -> ResponseT:
                     time.
 
         Returns:
-            If the key does not exist, returns an empty list. If the key exists, returns
-            a list which contains for each field in the request:
-                - `-2` if the field does not exist.
+            Returns a list which contains for each field in the request:
+                - `-2` if the field does not exist, or if the key does not exist.
                 - `-1` if the field exists but has no associated expire time.
                 - A positive integer representing the expiration Unix timestamp in
                   milliseconds, if the field has an associated expiration time.
@@ -5428,9 +5421,8 @@ def httl(self, key: KeyT, *fields: str) -> ResponseT:
             fields: A list of fields within the hash for which to get the TTL.
 
         Returns:
-            If the key does not exist, returns an empty list. If the key exists, returns
-            a list which contains for each field in the request:
-                - `-2` if the field does not exist.
+            Returns a list which contains for each field in the request:
+                - `-2` if the field does not exist, or if the key does not exist.
                 - `-1` if the field exists but has no associated expire time.
                 - A positive integer representing the TTL in seconds if the field has
                   an associated expiration time.
@@ -5451,9 +5443,8 @@ def hpttl(self, key: KeyT, *fields: str) -> ResponseT:
             fields: A list of fields within the hash for which to get the TTL.
 
         Returns:
-            If the key does not exist, returns an empty list. If the key exists, returns
-            a list which contains for each field in the request:
-                - `-2` if the field does not exist.
+            Returns a list which contains for each field in the request:
+                - `-2` if the field does not exist, or if the key does not exist.
                 - `-1` if the field exists but has no associated expire time.
                 - A positive integer representing the TTL in milliseconds if the field
                   has an associated expiration time.
diff --git a/tests/test_asyncio/test_hash.py b/tests/test_asyncio/test_hash.py
index d4f180539e..e31ea7eaf3 100644
--- a/tests/test_asyncio/test_hash.py
+++ b/tests/test_asyncio/test_hash.py
@@ -45,7 +45,7 @@ async def test_hexpire_conditions(r):
 @skip_if_server_version_lt("7.3.240")
 async def test_hexpire_nonexistent_key_or_field(r):
     await r.delete("test:hash")
-    assert await r.hexpire("test:hash", 1, "field1") == []
+    assert await r.hexpire("test:hash", 1, "field1") == [-2]
     await r.hset("test:hash", "field1", "value1")
     assert await r.hexpire("test:hash", 1, "nonexistent_field") == [-2]
 
@@ -105,7 +105,7 @@ async def test_hpexpire_conditions(r):
 @skip_if_server_version_lt("7.3.240")
 async def test_hpexpire_nonexistent_key_or_field(r):
     await r.delete("test:hash")
-    assert await r.hpexpire("test:hash", 500, "field1") == []
+    assert await r.hpexpire("test:hash", 500, "field1") == [-2]
     await r.hset("test:hash", "field1", "value1")
     assert await r.hpexpire("test:hash", 500, "nonexistent_field") == [-2]
 
@@ -163,7 +163,7 @@ async def test_hexpireat_conditions(r):
 async def test_hexpireat_nonexistent_key_or_field(r):
     await r.delete("test:hash")
     future_exp_time = int((datetime.now() + timedelta(seconds=1)).timestamp())
-    assert await r.hexpireat("test:hash", future_exp_time, "field1") == []
+    assert await r.hexpireat("test:hash", future_exp_time, "field1") == [-2]
     await r.hset("test:hash", "field1", "value1")
     assert await r.hexpireat("test:hash", future_exp_time, "nonexistent_field") == [-2]
 
@@ -228,7 +228,7 @@ async def test_hpexpireat_nonexistent_key_or_field(r):
     future_exp_time = int(
         (datetime.now() + timedelta(milliseconds=500)).timestamp() * 1000
     )
-    assert await r.hpexpireat("test:hash", future_exp_time, "field1") == []
+    assert await r.hpexpireat("test:hash", future_exp_time, "field1") == [-2]
     await r.hset("test:hash", "field1", "value1")
     assert await r.hpexpireat("test:hash", future_exp_time, "nonexistent_field") == [-2]
 
diff --git a/tests/test_asyncio/test_json.py b/tests/test_asyncio/test_json.py
index 507afc5621..852fd4aaa6 100644
--- a/tests/test_asyncio/test_json.py
+++ b/tests/test_asyncio/test_json.py
@@ -131,7 +131,7 @@ async def test_mset(decoded_r: redis.Redis):
 async def test_clear(decoded_r: redis.Redis):
     await decoded_r.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
     assert 1 == await decoded_r.json().clear("arr", Path.root_path())
-    assert_resp_response(decoded_r, await decoded_r.json().get("arr"), [], [[[]]])
+    assert_resp_response(decoded_r, await decoded_r.json().get("arr"), [], [])
 
 
 @pytest.mark.redismod
diff --git a/tests/test_hash.py b/tests/test_hash.py
index 7145b10a07..9ed5e98132 100644
--- a/tests/test_hash.py
+++ b/tests/test_hash.py
@@ -46,7 +46,7 @@ def test_hexpire_conditions(r):
 @skip_if_server_version_lt("7.3.240")
 def test_hexpire_nonexistent_key_or_field(r):
     r.delete("test:hash")
-    assert r.hexpire("test:hash", 1, "field1") == []
+    assert r.hexpire("test:hash", 1, "field1") == [-2]
     r.hset("test:hash", "field1", "value1")
     assert r.hexpire("test:hash", 1, "nonexistent_field") == [-2]
 
@@ -115,7 +115,7 @@ def test_hpexpire_conditions(r):
 @skip_if_server_version_lt("7.3.240")
 def test_hpexpire_nonexistent_key_or_field(r):
     r.delete("test:hash")
-    assert r.hpexpire("test:hash", 500, "field1") == []
+    assert r.hpexpire("test:hash", 500, "field1") == [-2]
     r.hset("test:hash", "field1", "value1")
     assert r.hpexpire("test:hash", 500, "nonexistent_field") == [-2]
 
@@ -182,7 +182,7 @@ def test_hexpireat_conditions(r):
 def test_hexpireat_nonexistent_key_or_field(r):
     r.delete("test:hash")
     future_exp_time = int((datetime.now() + timedelta(seconds=1)).timestamp())
-    assert r.hexpireat("test:hash", future_exp_time, "field1") == []
+    assert r.hexpireat("test:hash", future_exp_time, "field1") == [-2]
     r.hset("test:hash", "field1", "value1")
     assert r.hexpireat("test:hash", future_exp_time, "nonexistent_field") == [-2]
 
@@ -257,7 +257,7 @@ def test_hpexpireat_nonexistent_key_or_field(r):
     future_exp_time = int(
         (datetime.now() + timedelta(milliseconds=500)).timestamp() * 1000
     )
-    assert r.hpexpireat("test:hash", future_exp_time, "field1") == []
+    assert r.hpexpireat("test:hash", future_exp_time, "field1") == [-2]
     r.hset("test:hash", "field1", "value1")
     assert r.hpexpireat("test:hash", future_exp_time, "nonexistent_field") == [-2]
 
@@ -298,7 +298,7 @@ def test_hpersist_multiple_fields(r):
 @skip_if_server_version_lt("7.3.240")
 def test_hpersist_nonexistent_key(r):
     r.delete("test:hash")
-    assert r.hpersist("test:hash", "field1", "field2", "field3") == []
+    assert r.hpersist("test:hash", "field1", "field2", "field3") == [-2, -2, -2]
 
 
 @skip_if_server_version_lt("7.3.240")
@@ -315,7 +315,7 @@ def test_hexpiretime_multiple_fields_mixed_conditions(r):
 @skip_if_server_version_lt("7.3.240")
 def test_hexpiretime_nonexistent_key(r):
     r.delete("test:hash")
-    assert r.hexpiretime("test:hash", "field1", "field2", "field3") == []
+    assert r.hexpiretime("test:hash", "field1", "field2", "field3") == [-2, -2, -2]
 
 
 @skip_if_server_version_lt("7.3.240")
@@ -332,7 +332,7 @@ def test_hpexpiretime_multiple_fields_mixed_conditions(r):
 @skip_if_server_version_lt("7.3.240")
 def test_hpexpiretime_nonexistent_key(r):
     r.delete("test:hash")
-    assert r.hpexpiretime("test:hash", "field1", "field2", "field3") == []
+    assert r.hpexpiretime("test:hash", "field1", "field2", "field3") == [-2, -2, -2]
 
 
 @skip_if_server_version_lt("7.3.240")
@@ -349,7 +349,7 @@ def test_httl_multiple_fields_mixed_conditions(r):
 @skip_if_server_version_lt("7.3.240")
 def test_httl_nonexistent_key(r):
     r.delete("test:hash")
-    assert r.httl("test:hash", "field1", "field2", "field3") == []
+    assert r.httl("test:hash", "field1", "field2", "field3") == [-2, -2, -2]
 
 
 @skip_if_server_version_lt("7.3.240")
@@ -366,4 +366,4 @@ def test_hpttl_multiple_fields_mixed_conditions(r):
 @skip_if_server_version_lt("7.3.240")
 def test_hpttl_nonexistent_key(r):
     r.delete("test:hash")
-    assert r.hpttl("test:hash", "field1", "field2", "field3") == []
+    assert r.hpttl("test:hash", "field1", "field2", "field3") == [-2, -2, -2]
diff --git a/tests/test_json.py b/tests/test_json.py
index a688464874..50787c717c 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -130,7 +130,7 @@ def test_mset(client):
 def test_clear(client):
     client.json().set("arr", Path.root_path(), [0, 1, 2, 3, 4])
     assert 1 == client.json().clear("arr", Path.root_path())
-    assert_resp_response(client, client.json().get("arr"), [], [[[]]])
+    assert_resp_response(client, client.json().get("arr"), [], [])
 
 
 @pytest.mark.redismod
diff --git a/tests/test_search.py b/tests/test_search.py
index 284bccd913..a61f361c3a 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -2369,27 +2369,27 @@ def test_search_missing_fields(client):
 
     with pytest.raises(redis.exceptions.ResponseError) as e:
         client.ft().search(
-            Query("ismissing(@title)").dialect(5).return_field("id").no_content()
+            Query("ismissing(@title)").dialect(2).return_field("id").no_content()
         )
     assert "to be defined with 'INDEXMISSING'" in e.value.args[0]
 
     res = client.ft().search(
-        Query("ismissing(@features)").dialect(5).return_field("id").no_content()
+        Query("ismissing(@features)").dialect(2).return_field("id").no_content()
     )
     _assert_search_result(client, res, ["property:2"])
 
     res = client.ft().search(
-        Query("-ismissing(@features)").dialect(5).return_field("id").no_content()
+        Query("-ismissing(@features)").dialect(2).return_field("id").no_content()
     )
     _assert_search_result(client, res, ["property:1", "property:3"])
 
     res = client.ft().search(
-        Query("ismissing(@description)").dialect(5).return_field("id").no_content()
+        Query("ismissing(@description)").dialect(2).return_field("id").no_content()
     )
     _assert_search_result(client, res, ["property:3"])
 
     res = client.ft().search(
-        Query("-ismissing(@description)").dialect(5).return_field("id").no_content()
+        Query("-ismissing(@description)").dialect(2).return_field("id").no_content()
     )
     _assert_search_result(client, res, ["property:1", "property:2"])
 
@@ -2438,27 +2438,29 @@ def test_search_empty_fields(client):
 
     with pytest.raises(redis.exceptions.ResponseError) as e:
         client.ft().search(
-            Query("@title:''").dialect(5).return_field("id").no_content()
+            Query("@title:''").dialect(2).return_field("id").no_content()
         )
-    assert "to be defined with `INDEXEMPTY`" in e.value.args[0]
+    assert "Use `INDEXEMPTY` in field creation" in e.value.args[0]
 
     res = client.ft().search(
-        Query("@features:{ }").dialect(5).return_field("id").no_content()
+        Query("@features:{$empty}").dialect(2).return_field("id").no_content(),
+        query_params={"empty": ""},
     )
     _assert_search_result(client, res, ["property:2"])
 
     res = client.ft().search(
-        Query("-@features:{ }").dialect(5).return_field("id").no_content()
+        Query("-@features:{$empty}").dialect(2).return_field("id").no_content(),
+        query_params={"empty": ""},
     )
     _assert_search_result(client, res, ["property:1", "property:3"])
 
     res = client.ft().search(
-        Query("@description:''").dialect(5).return_field("id").no_content()
+        Query("@description:''").dialect(2).return_field("id").no_content()
     )
     _assert_search_result(client, res, ["property:3"])
 
     res = client.ft().search(
-        Query("-@description:''").dialect(5).return_field("id").no_content()
+        Query("-@description:''").dialect(2).return_field("id").no_content()
     )
     _assert_search_result(client, res, ["property:1", "property:2"])
 
@@ -2503,14 +2505,13 @@ def test_special_characters_in_fields(client):
     )
     _assert_search_result(client, res, ["resource:1"])
 
-    # with dialect 5 no need to escape the - even without params
+    # with double quotes exact match no need to escape the - even without params
     res = client.ft().search(
-        Query("@uuid:{123e4567-e89b-12d3-a456-426614174000}").dialect(5)
+        Query('@uuid:{"123e4567-e89b-12d3-a456-426614174000"}').dialect(2)
     )
     _assert_search_result(client, res, ["resource:1"])
 
-    # also no need to escape ' with dialect 5
-    res = client.ft().search(Query("@tags:{new-year's-resolutions}").dialect(5))
+    res = client.ft().search(Query('@tags:{"new-year\'s-resolutions"}').dialect(2))
     _assert_search_result(client, res, ["resource:2"])
 
     # possible to search numeric fields by single value
@@ -2518,7 +2519,7 @@ def test_special_characters_in_fields(client):
     _assert_search_result(client, res, ["resource:2"])
 
     # some chars still need escaping
-    res = client.ft().search(Query(r"@tags:{\$btc}").dialect(5))
+    res = client.ft().search(Query(r"@tags:{\$btc}").dialect(2))
     _assert_search_result(client, res, ["resource:1"])
 
 

From 0be67bfdf609943e6ce8ecdb026c3234753bbfec Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@redis.com>
Date: Thu, 4 Jul 2024 18:00:48 +0300
Subject: [PATCH 0907/1164] Format connection errors in the same way everywhere
 (#3305)

Connection errors are formatted in four places, sync and async, network
socket and unix socket. Each place has some small differences compared
to the others, while they could be, and should be, formatted in an
uniform way. Factor out the logic in a helper method and call that
method in all four places. Arguably we lose some specificity, e.g. the
words "unix socket" won't be there anymore, but it is more valuable to not
have code duplication.
---
 redis/asyncio/connection.py           | 40 ++-------------------
 redis/connection.py                   | 39 ++------------------
 redis/utils.py                        | 12 +++++++
 tests/test_asyncio/test_connection.py | 51 +++++++++++++++++++++++----
 tests/test_connection.py              | 50 ++++++++++++++++++++++++++
 5 files changed, 111 insertions(+), 81 deletions(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index b3dae2a27b..ec1ce5a915 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -27,6 +27,8 @@
 )
 from urllib.parse import ParseResult, parse_qs, unquote, urlparse
 
+from ..utils import format_error_message
+
 # the functionality is available in 3.11.x but has a major issue before
 # 3.11.3. See https://github.com/redis/redis-py/issues/2633
 if sys.version_info >= (3, 11, 3):
@@ -345,9 +347,8 @@ async def _connect(self):
     def _host_error(self) -> str:
         pass
 
-    @abstractmethod
     def _error_message(self, exception: BaseException) -> str:
-        pass
+        return format_error_message(self._host_error(), exception)
 
     async def on_connect(self) -> None:
         """Initialize the connection, authenticate and select a database"""
@@ -799,27 +800,6 @@ async def _connect(self):
     def _host_error(self) -> str:
         return f"{self.host}:{self.port}"
 
-    def _error_message(self, exception: BaseException) -> str:
-        # args for socket.error can either be (errno, "message")
-        # or just "message"
-
-        host_error = self._host_error()
-
-        if not exception.args:
-            # asyncio has a bug where on Connection reset by peer, the
-            # exception is not instanciated, so args is empty. This is the
-            # workaround.
-            # See: https://github.com/redis/redis-py/issues/2237
-            # See: https://github.com/python/cpython/issues/94061
-            return f"Error connecting to {host_error}. Connection reset by peer"
-        elif len(exception.args) == 1:
-            return f"Error connecting to {host_error}. {exception.args[0]}."
-        else:
-            return (
-                f"Error {exception.args[0]} connecting to {host_error}. "
-                f"{exception}."
-            )
-
 
 class SSLConnection(Connection):
     """Manages SSL connections to and from the Redis server(s).
@@ -971,20 +951,6 @@ async def _connect(self):
     def _host_error(self) -> str:
         return self.path
 
-    def _error_message(self, exception: BaseException) -> str:
-        # args for socket.error can either be (errno, "message")
-        # or just "message"
-        host_error = self._host_error()
-        if len(exception.args) == 1:
-            return (
-                f"Error connecting to unix socket: {host_error}. {exception.args[0]}."
-            )
-        else:
-            return (
-                f"Error {exception.args[0]} connecting to unix socket: "
-                f"{host_error}. {exception.args[1]}."
-            )
-
 
 FALSE_STRINGS = ("0", "F", "FALSE", "N", "NO")
 
diff --git a/redis/connection.py b/redis/connection.py
index 728c221257..6e3b3ab081 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -39,6 +39,7 @@
     HIREDIS_AVAILABLE,
     HIREDIS_PACK_AVAILABLE,
     SSL_AVAILABLE,
+    format_error_message,
     get_lib_version,
     str_if_bytes,
 )
@@ -338,9 +339,8 @@ def _connect(self):
     def _host_error(self):
         pass
 
-    @abstractmethod
     def _error_message(self, exception):
-        pass
+        return format_error_message(self._host_error(), exception)
 
     def on_connect(self):
         "Initialize the connection, authenticate and select a database"
@@ -733,27 +733,6 @@ def _connect(self):
     def _host_error(self):
         return f"{self.host}:{self.port}"
 
-    def _error_message(self, exception):
-        # args for socket.error can either be (errno, "message")
-        # or just "message"
-
-        host_error = self._host_error()
-
-        if len(exception.args) == 1:
-            try:
-                return f"Error connecting to {host_error}. \
-                        {exception.args[0]}."
-            except AttributeError:
-                return f"Connection Error: {exception.args[0]}"
-        else:
-            try:
-                return (
-                    f"Error {exception.args[0]} connecting to "
-                    f"{host_error}. {exception.args[1]}."
-                )
-            except AttributeError:
-                return f"Connection Error: {exception.args[0]}"
-
 
 class SSLConnection(Connection):
     """Manages SSL connections to and from the Redis server(s).
@@ -930,20 +909,6 @@ def _connect(self):
     def _host_error(self):
         return self.path
 
-    def _error_message(self, exception):
-        # args for socket.error can either be (errno, "message")
-        # or just "message"
-        host_error = self._host_error()
-        if len(exception.args) == 1:
-            return (
-                f"Error connecting to unix socket: {host_error}. {exception.args[0]}."
-            )
-        else:
-            return (
-                f"Error {exception.args[0]} connecting to unix socket: "
-                f"{host_error}. {exception.args[1]}."
-            )
-
 
 FALSE_STRINGS = ("0", "F", "FALSE", "N", "NO")
 
diff --git a/redis/utils.py b/redis/utils.py
index ea2eac149e..360ee54b8c 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -141,3 +141,15 @@ def get_lib_version():
     except metadata.PackageNotFoundError:
         libver = "99.99.99"
     return libver
+
+
+def format_error_message(host_error: str, exception: BaseException) -> str:
+    if not exception.args:
+        return f"Error connecting to {host_error}."
+    elif len(exception.args) == 1:
+        return f"Error {exception.args[0]} connecting to {host_error}."
+    else:
+        return (
+            f"Error {exception.args[0]} connecting to {host_error}. "
+            f"{exception.args[1]}."
+        )
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index 6255ae7d6d..8f79f7d947 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -12,7 +12,12 @@
     _AsyncRESPBase,
 )
 from redis.asyncio import ConnectionPool, Redis
-from redis.asyncio.connection import Connection, UnixDomainSocketConnection, parse_url
+from redis.asyncio.connection import (
+    Connection,
+    SSLConnection,
+    UnixDomainSocketConnection,
+    parse_url,
+)
 from redis.asyncio.retry import Retry
 from redis.backoff import NoBackoff
 from redis.exceptions import ConnectionError, InvalidResponse, TimeoutError
@@ -494,18 +499,50 @@ async def test_connection_garbage_collection(request):
 
 
 @pytest.mark.parametrize(
-    "error, expected_message",
+    "conn, error, expected_message",
     [
-        (OSError(), "Error connecting to localhost:6379. Connection reset by peer"),
-        (OSError(12), "Error connecting to localhost:6379. 12."),
+        (SSLConnection(), OSError(), "Error connecting to localhost:6379."),
+        (SSLConnection(), OSError(12), "Error 12 connecting to localhost:6379."),
         (
+            SSLConnection(),
             OSError(12, "Some Error"),
-            "Error 12 connecting to localhost:6379. [Errno 12] Some Error.",
+            "Error 12 connecting to localhost:6379. Some Error.",
+        ),
+        (
+            UnixDomainSocketConnection(path="unix:///tmp/redis.sock"),
+            OSError(),
+            "Error connecting to unix:///tmp/redis.sock.",
+        ),
+        (
+            UnixDomainSocketConnection(path="unix:///tmp/redis.sock"),
+            OSError(12),
+            "Error 12 connecting to unix:///tmp/redis.sock.",
+        ),
+        (
+            UnixDomainSocketConnection(path="unix:///tmp/redis.sock"),
+            OSError(12, "Some Error"),
+            "Error 12 connecting to unix:///tmp/redis.sock. Some Error.",
         ),
     ],
 )
-async def test_connect_error_message(error, expected_message):
+async def test_format_error_message(conn, error, expected_message):
     """Test that the _error_message function formats errors correctly"""
-    conn = Connection()
     error_message = conn._error_message(error)
     assert error_message == expected_message
+
+
+async def test_network_connection_failure():
+    with pytest.raises(ConnectionError) as e:
+        redis = Redis(host="127.0.0.1", port=9999)
+        await redis.set("a", "b")
+    assert str(e.value).startswith("Error 111 connecting to 127.0.0.1:9999. Connect")
+
+
+async def test_unix_socket_connection_failure():
+    with pytest.raises(ConnectionError) as e:
+        redis = Redis(unix_socket_path="unix:///tmp/a.sock")
+        await redis.set("a", "b")
+    assert (
+        str(e.value)
+        == "Error 2 connecting to unix:///tmp/a.sock. No such file or directory."
+    )
diff --git a/tests/test_connection.py b/tests/test_connection.py
index bff249559e..69275d58c0 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -296,3 +296,53 @@ def mock_disconnect(_):
 
     assert called == 1
     pool.disconnect()
+
+
+@pytest.mark.parametrize(
+    "conn, error, expected_message",
+    [
+        (SSLConnection(), OSError(), "Error connecting to localhost:6379."),
+        (SSLConnection(), OSError(12), "Error 12 connecting to localhost:6379."),
+        (
+            SSLConnection(),
+            OSError(12, "Some Error"),
+            "Error 12 connecting to localhost:6379. Some Error.",
+        ),
+        (
+            UnixDomainSocketConnection(path="unix:///tmp/redis.sock"),
+            OSError(),
+            "Error connecting to unix:///tmp/redis.sock.",
+        ),
+        (
+            UnixDomainSocketConnection(path="unix:///tmp/redis.sock"),
+            OSError(12),
+            "Error 12 connecting to unix:///tmp/redis.sock.",
+        ),
+        (
+            UnixDomainSocketConnection(path="unix:///tmp/redis.sock"),
+            OSError(12, "Some Error"),
+            "Error 12 connecting to unix:///tmp/redis.sock. Some Error.",
+        ),
+    ],
+)
+def test_format_error_message(conn, error, expected_message):
+    """Test that the _error_message function formats errors correctly"""
+    error_message = conn._error_message(error)
+    assert error_message == expected_message
+
+
+def test_network_connection_failure():
+    with pytest.raises(ConnectionError) as e:
+        redis = Redis(port=9999)
+        redis.set("a", "b")
+    assert str(e.value) == "Error 111 connecting to localhost:9999. Connection refused."
+
+
+def test_unix_socket_connection_failure():
+    with pytest.raises(ConnectionError) as e:
+        redis = Redis(unix_socket_path="unix:///tmp/a.sock")
+        redis.set("a", "b")
+    assert (
+        str(e.value)
+        == "Error 2 connecting to unix:///tmp/a.sock. No such file or directory."
+    )

From 1bb8eaba2d9dd30ebc123929dc3f22a137efcfde Mon Sep 17 00:00:00 2001
From: Igor Malinovskiy <u.glide@gmail.com>
Date: Wed, 10 Jul 2024 19:09:41 +0200
Subject: [PATCH 0908/1164] Decode search results at field level (#3309)

Make it possible to configure at field level how search
results are decoded.

Fixes: #2772, #2275
---
 dev_requirements.txt                          |  1 +
 .../search_vector_similarity_examples.ipynb   |  5 +-
 redis/commands/search/_util.py                |  4 +-
 redis/commands/search/commands.py             | 17 ++++-
 redis/commands/search/query.py                | 23 +++++--
 redis/commands/search/result.py               | 44 ++++++++-----
 tests/test_asyncio/test_search.py             | 62 ++++++++++++++++++-
 tests/test_search.py                          | 50 +++++++++++++++
 8 files changed, 178 insertions(+), 28 deletions(-)

diff --git a/dev_requirements.txt b/dev_requirements.txt
index b1e10f9682..c008b69b1d 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -16,3 +16,4 @@ urllib3<2
 uvloop
 vulture>=2.3.0
 wheel>=0.30.0
+numpy>=1.24.0
diff --git a/docs/examples/search_vector_similarity_examples.ipynb b/docs/examples/search_vector_similarity_examples.ipynb
index bd1df3c1ef..809dbda4ea 100644
--- a/docs/examples/search_vector_similarity_examples.ipynb
+++ b/docs/examples/search_vector_similarity_examples.ipynb
@@ -162,8 +162,8 @@
     {
      "data": {
       "text/plain": [
-       "[Document {'id': 'doc:b', 'payload': None, 'score': '0.2376562953'},\n",
-       " Document {'id': 'doc:c', 'payload': None, 'score': '0.240063905716'}]"
+       "[Document {'id': 'doc:c', 'payload': None, 'score': '0.251625061035', 'vector': b'\\xf8\\x1ed?\\xbf\\t\\x90<\\xfd\\x9b\\x10?\\xe3\\x1b\\xed>\\xbc\\xea%=lp\\x1a>\\x11hC?\\x84 :?\\x8d\\x7f\\xe4>\\xfd\\xff\\x94>n\\x9c4?\\x0e\\x9fy?\\xd6\\x8a\\x97<\\xf6\\x0b\"?Kg\\x99>\\xc4\\xde0>\\xa5\\r\\xb9>\\xb0R(>\\xd3\\x1d\\xcd>?\\xab\\xbb>\\x9cx\\x0c?\\xd7\\xa3\\x9e>\\xad\\xee\\xf4<\\x0c\\x93\\xf6>aW\\x0b?\\xd8F0<0\\x9e(?\\xc5Pn>\\x03\\xf4\\xb0>B\\xaay?\\xa9~\\x7f?Gh\\x18>\\x15\\x8e\\xf1>]\\xc8\\xea>x\\xc5\\x9c>\\xa1\\xeb>?\\xbb\\n-?aDZ?\\x92\\x9bL<4\\xa4\\r?\\x1d\\xe1\\xcd>cO\\xa3>\\'\\xed<?\\x8a\\x15\\xf5>vPk?\\xa7\\xdch?\\x02\\x14\\x8a>\\xb6:\\x07;O\\x139?\\x8d$5?^e5?\\x06\\x10\\x89>\\x88+\\xd2>\\xea\\xb7\\xa4>\\xf9\\x0e-?\\x9c\\xbf\\xb5>\\x81\\x8e\\x03?\\x00\\xc43?/\\xdb\\xfb>\\xe8\\'e>\\xbe\\xaa9?\\xf2\\xe88?\\x1b\\xa8\\x03>\\x91\\x9fO?%\\xb2;?\\xb7}w?\\xd0/\\x08?\\x1aD\\x1c?\\xf9E??\\x9bB.?\\x96)\\x19?\\x10a\\xda>+\\xbfV>\\x83\\xbd}>\\x0bTz>\\x82Mz?\\xf0EY?:\\x99\\x19?\"\\x1ep?\\xafX\\xcb>*\\xa0\\x0c>X\\xf5\\xb9>\\x8d\\t8?Q\\xba\\xf4>\\x1e\\x97x>\\xc0Q@?\\xd2\\x1a\\xa6>M\\xed\\xcf>\\x15\\x90$>\\xb7\\x99[?o\\x84e?\\x8a2P?\\x8c\\x92^?\\'\\xe3\\xd9>@\\x83(?E\\x91V?\\xad\\x1b\\xa8>\\xf5\\xca=?\\x0c\\x10h?m8\\xc0>\\xaf\\xe4f?\\xb9\\xdcZ?\\xce9\\xdb>\\x9f|\\xc1>^\\xa9B>\\xc3\\xce_>s\\x93\\xd4<\\x96\\xd7\\x02?\\x10\\t ?\\x07\\xb9:>\\x9f_\\xa4=\\xcb\\xecK>\\xb2\\xdes>\\x9f\\x0b*?ln\\x15>\\x0c;y?L\\xe7a?:\\x8fg?Hs\\x17?`v\\t?\\xdf\\xe8Q?1Od=4\\x1c\\xba>\\x1b\\n8=;\\x9f??\\xbb\\xa5X=kLL=u=4?\\xdf\\x17<>\\x1b\\x06\\xb5>\\x91W\\xc5>H\\nw?\\xc8\\x05N?w\\xf5\\xcf>\\xee^Y?\\x14\\x90\\xd1;\\xc7b\">\\xfa\\xeb_?y\\xbb\\x95>\\xef\\xb66>\\xe4Pa?c-/?\\x88\\x9a\\xf2=\\xe9\\x8b\\t?fp\\xda>B\\xcb\\xef=\\xd0\\x1b\\x99>\\x0e\\xb2f?n\\x82~>\\xd6e\\xcb>\\x02\\\\a?\\xcbR\\x14?cY[?E\\xfc\\xe7>0v\\x14?\\x0c\\x1e\\x07?`\\x1f\\xdc=\\xb7\\x1d\\r>v/4?\\xaa\\xb2\\r?\\xda\\x89\\xfa=c>x>\\x01\\xd2\\xad>\\x04\\xd3\\xe6>\\xa7E\\x9d=\\xc0|_?\\xcf\\x96o?\\x89dd?\\xbb\\xad>?UL\\'<\\xf4$h<\\x9fO\\x12?\\x86*\\xd4>\\xef\\x8dU?\\x02\\xc9_=5\\xf8.?\\xe5\\xf8\\x11?\\x96y\\xec>\\x18S\\xac>BT\\xec<\\xa4bu?\\xa3v-?s\\x8eq?\\xc8\\x99b?u\\xf6\\xc9=\\xca\\x9b*?\\xb9O)?s\\xa9\\r?\\x8d\\xf6\\x9d> \\xba/?\\xe9\\x7f\\xb7>\\xd4}\\xc3=C\\x99a?\\xf5\\xf4\\x1e=(\\xb54?X\\xe1_?\\xd7\\xa7a=\\xe12:>\\xb1,\\xb9>R\\x0b\\x17;\\xe7\\xe8\\x8a=Ew\\x05?\\x1a\\x0es?\\xdc&w?\\xe2J`?\\xde\\x9b\\xd7>\\xb7\\xbf\\xb5>\\x9d\\xbd\\xdb>\\xb4\\x10\\x19?\\xb10D?L_\\xc2>#\\x0e\\x8e>o\\x08\\x05>\\xab\\xec\\x10?\\xbd6)?\\xd5i]?\\xd4F\\xe4=\\x93I\\xf3>\\xcdc\\xd3>\\x1f\\xb5\\x11?\\xab\\xabW?\\xden;?\\x96h\\xf1<\\x8d\\xf1#?\\xa4sA?\\xac\\x8d<?\\'\\xef\\xa0>?\\x86.> \\xf9\\t?g\\xcc\\x93=\\xc2\\x98I?\\xcc\\xc0P?\\xdd9`?@\\'\\xfa>\\xe4\\x1c\\xf5>\\xaa\\xcfn>|\\xae\\x10?\\x1a\\x9b\\x1e?\\x86\\x10F?6\\xc2\\xaf>$L\\xf2>\\xfb\\x0c\\x8b>\\xbb\\xb4\\xb7>{K\\x98> 1\\x1a?\\xd8N\\x8c=h\\x0cx?\\xfd\\x98\\xe2=\\xe5\\x02,>\\x97p\\x06?\\xb6!\\xe1>\\x95\\xfc\\x93>\\x8co\\xf0>\\xa54\\xfe>\\x94\\xe7j?\\x0c6\\x13?\\xba\\xe0\\xc1>%ll?;\\xafW?\\xf9\\xb9\\x9d>\\xdd:N?SZ~>:p$?1\\x00z>C$\\xb9>\\x8c\\xeaL?\\x96|!?.6\\xe9>\\xf2i\\xf2> \\x0c(?\\xb4|\\x80>Yx\\x88>\\xd2 \\xe6>\\xe1\\x94\\x00?\\xc0\\x88C?\\x134\\'?Oy\\x9f>\\xb5\\xeaw?\\x97X\\'?\\xa3\\x07\\x07?\\x94.h?B\\xf5\\xd1>\\xd9\\xae2>\\xbf\\x9e,?*w\\xa3>\\xbe\\x8e\\x12?ZU>?\\x83\\xaar?\\xbe.\\x82>\\x0e^^?\\x07\\xe4\\xa2>\\x04dZ?#)\\x1f?\\xbd\\x0f\\xa0=\\xac\\x9e\\xfe>\\xb1\\x81B>\\x827a?\\xcb\\xfb\\x08?\\x04\\xca\\xa2<7Zd?\\xdau9?\\xe6Z.?4\\x96N?\\xf6\\xcaw>+\\xa64?p\\xe3\\xae>\\xaey\\x95>!H\\xb7>~!\\xbe>\\xe1\\x0eK>\\x98\\xdaZ?\\xe0\\x0b\\xbc>\\xdd\\xc8??\\x98\\xaf >o\\x8d\\x7f?\\x16\\xea\\xa3>r\\x94F>\\xfb\\xa5i?n\\xf0\\xdd>u\\x19e>\\xb3j\\x1e=\\xf7S\\x0b?\\xdaY\\x0b?\\xbd\\x11\\x9b>\\xa77\\xa2>\\xcc^\\xaf>\\xf9a\\xa7>\\xc2N\\x13?\\xcbf\\x12?\\xb4\\x1bK>j\\xb7L?\\x99aS?\\xeeyY?\\x968\\x82=R\\x0e#>`\\xb9c={\\nH?b\\xb4\\x14>d\\x02W?\\xde\\xd4\\\\>\\xe5\\xb6F?>\\x96\\xac>\\xc7`\\x91>?\\x0e\\xad>]\\x84\\x02?\\xac\\x14{?(2\\xad>\\x11\\xdd\\xf6=\\xa0\\xb5\\xbf>df\\xad>\\xea\\xe1\\x04?B\\x17:?k\\xb8\\xb6=|\\xbft?\\x84\\x1f\\x05>\\xab&??\\x156\\xc2>`Y\\x02>J!\\x1f?\\xc0\\xce\\x1a?-V2?\\xe8\\xfen?\\xb58\\x1c?\\x91\\x96\\x94>\\xa1\"\\x1e?K\\xd5\\x04?Gk\\xa9>\\xf0\\xd7\\x03?{;l?\\x88\\xa5!>t\\x0e\\r>%E\\xa8>\\n\\x1cM?\\x8b\\xbfN?\\xc9\\x84\\xea>\\xdb\\xebd?\\xe7\\xe9G?-t\\x9b>\\xb8\\xc80?\\xb7w\"?\\xdcz1>xT\\xf2=\\xb7\\x12\\xa1>\\x887\\x95>8\\x19\\xdf>\\xa9\\xbbY?\\x89w\\x8d>M\\xb4r=\\xd1~\\x02?\\xd1\\xd6x?\\x0c\\xb7\\x06?\\xc1w\\x17>v\\xba\\xe4>\\x11\\x16\\xec>\\x9f\\x8a\\xc7>r\\xf0L?d_>>\\x01TS?8\\x9f\\x0b>RBd=\"\\xc3\\xe1;\\x9f\\xf7\\x9c>^\\x1cg?\\xc5\\xee\\n?N.\"?\\x9d\\x13\\x8c=\\x9e\\x90W>\\'\\xf0<>&\\x86]?\\xb6[\\xe2>\\xf9S5<N\\xe0@>\\x1f\\x1aN>s\\xbfL?\\xbb\\xec=?\\xcf\\x08C?\\\\M\\xa8>\\xc7\\xcf\\xe3=\\x84\\xfe%>d\\'\\xdc>5\\xaa\\xc6=\\xf7A\\xe9=VY^?\\xb8\\x84f=\\xfa\\x95L=\\x95\\xd7x?\\xc0A\\x9a>\\x9c\\xa37?K\\x8c]?B\\xdb\\xc5>\\xc5\\x19\\xed>\\xfa\\x1f#?\\xa2-\\xf1<\\xc4\\xf4B?\\xfdQ}=7\\x06k>-\\xa8\\x88=4\\xe3\\xc7=\\x91j[?\\xaa\\xe5I=\\x8f\\xeaf?\\x97\\x7f\\x9d>\\xb8\\x9c\\x03?\\xfc(\\x1b?\\xce\\xe7\\xd7>\\xf2\\xc8X>I\\xa6}?\\x8f\\xb4E==\\xb7.>\\xd8\\n\\x18?\\xb4\\xc1C?\\x8f\\x16q?\\x88C]>\\x06\\x99\\x0e?mz\\x93>\\xd1\\xb2\\x18?(\\xb8r?\\xe7\\xcb\\xab>{\\x87F=\\x9a?\\x1a?\\x86\\x82$?\\xf9\\x0b\\xe9>\\x85\\xa05? X5?\\xec<K?\\x81\\x115?\\xc4\\x0e^?\\xc3\\x1a\\x04=H\\x0f\\xfa>5&)?x\\xf1G?q\\xfc\\x91>\\'\\xd7\\x1a>s\\x14A>\\xe3\\xb1\\xe0>Sk\\x0c?\\x14\\x973?\\x15\\xc7\\xd7>z*4?\\x14Hq?\\x1f\\x83\\xe8>\\x01\\xd5.=\\x17\\xde\\x08?z\\x1d`>o\\x14/>\\xd1\\xbcA>8G0>\\xf2Hh?\\xdc\\xdfd=\\xe9R\"?\\xfb\\xa7~?\\xd2\\xae\\x06=\\xe8y\\xd6>\\xc0\\xb7\\x8c=\\xbc\\xe9\\x03?\\xae\\x10\\x0f?3rh?N\\xacf?\\xb5\\xfd\\x06=\\xc5\\xf6r>\\x8c\\\\\\xfc>\\xa2I\\xd7>\\xb6T`?Hn0>V#3>\\xf7\\xc9C=\\xdaR\\xa4=\\xfdPh>\\x18\\xe4&?k}1>\\x0e\\xbdB?\\xb7r|?\\xf7\\xb9\\x17?K\\x10\\xd8>\\xd8f\\xa9>\\xf6,D?,\\x1a\\xab>\\xf2*w?\\xd6\\xa0\\x1d>q\\xcd\\xf5>\\x01\\xf6j?G\\xe1q>\\xd3D\\xc0>\\x9a!\\xdb>\\x81_\\xe6>\\xea\\xa8\\'>f\\xa1W>\\xcdzI?O|,>\\xfa\\xc5}>\\xbc# ?F\\xfd9>K\\xd0\\xa2>\"\\x06i?>\\x9bm?c\\xe2\\xd8>\\x11\\xca\\xf1=\\x06\\x08E?\\xf2\\x0cQ?+\\x8d\\xfe>`\\xb0\\xfc>K_\\x18<\\x02\\x13g?hx\\xd0>\\x9a\\x8b\\xf3>d\\x99H>\\xcd\\x9d)>P\\xb4\\x84>\\xea\\x16o?\\x18\\x9fD?\\x16\\xa2\">)\\xc4|?\\tIr?\\xdf\\xd9\\x9a>!\\xebu?p:\\x0b?X3\\xca>\\x84\\xa9g>\\xef\\x9d\\x8e>\\x1ekt?\\xe1\\xa5N?]\\xbe\\x06?h\\xc8\\x9e>\\xb0(\\x12?\\xe1A\\xa4>V\\xefY<:\\x19\\xc5>O\\xeb1?\\xd0P\\x10?\\x1feT?U7x?\\x96]t?\\xbd\\x82c?\\xe1\\x87+?\\xbcVi?6\\'+?\\xc3PL?A\\x1aR=\\x1a-]?\\xd8\\xae\\x1e?\\x12K>?\\xfc\\x00\\xf4>\\xc5\"\\xf3=\\x17\\xc0\\xa4=\\xe6G\\x1b=\\x0f\\xdcP?\\x1d*\\xe4>pw\\x97>\\xe8v\\x13?\\xf00\\r?\\n\\xd0J>\\x87~\\xa6=k/^?\\x1f\\xe5\\xe3:V\\xbc??\\xb4\\x81=>;\\xd4,?]F#?0D\\x07?\\xb8\\xe7=>\\xba\\x0fC?\\x0fe\\x8d>I\\x80(?\\xa4\\x9e\\t?\\x12\\xaaJ?\\xdca6>!Uc>}\\x0c<?\\xcf\\x11|?\\x08\\x1f%?\\x00\\xbf\\xed>\\xc3\\xcd\\x8b<\\x02\\nG?\\x0eFY?\\x03\\xc4\\\\?\\xce\\x96\\x95>\\xb9\\xa95?\\xc4)\\xb0<z\\xfbR?\\x9cQ\\'?\\xa8\\x12??\\xee\\xa8\\x17?8\\x02\\xcf>\\xdf[R>\\x87\\xd24?\\x1fSk?\\x03\\xbdG=\\x18o6?x\\xdf\\x1c>\\x10Sc?=\\x06\\x82>j\\xee^?\\x96\\xc8\\x8c>L\\xf7\"?;\\xb4e?H\\xfbY>\\xa6\\x14\\xfc;\\x9d0\\x12?R\\xab\\xd9>\\x06\\x8d\\'?\\x7f%\\xc6>\\xc4;Z>\\xeb\\xaba?}\\x92\\x12>P\\xdcq>\\x93\\xa4\\x14?7\\x8b\\xb0>\\xf2um=\\xc9Q\\xe8=\\x08\\xdag?e\\x13j?j\\xefL?\\x1eeN?s;\\xff>\\xc5r\\x02?\\x86@w?\\xb8\\x00r>#-b?\\x87\\xc36>%\\x93f?\\x88\\xd8 ?d\\xa3d?\\xb0\\xe2z?b\\xb3\\xb7>\\xban\\xaf=\\xcf\\xaaE>_J\\xde>\\x80\\xa6\\x1b?\\xd1@\\xd8>670>\\x11k\\xc5>\\xfb\\x05\\xd4>\\xb0\\x98N?\\xcem\\x9f=\\xbd\\xc8r?+\\xcd\\xc4<\"\\xebN>J\\x0f\\xb2>\\xec\\xb4E?\\x807\\xef>\\xbc\\xa2>?;\\\\\\x12?fM\\t?\\x04}\\x19?:\\xff\\xa6>\\xd5\\xe3\\x96>\\x1cX\\xcf>\\x89\\x19\\xe8=\\xedc??\\x00\\x18^?\\xe7\\x0e\\xd9>L\\x00i?g\\x1a(?1P\\x12?\\xb8\\x16L?E\\x97N>\\xa4\\xe6\\xbc>\\x18\\x02\\xa8>\\xbc\\x12f?r[\\xd5>5Ii>\\xc2\\x1b\\xe3>\\x14\\xc6\\x13?\\xc3{L?\\x7fY\\xbb>\\xbcq\\xc3=XR\\xfd>A\\xcf<?\\x1f\\xd3@?\\x94\\xcaq>@@\\x88>\\xbf\\xe0\\xd4>\\xa2\\xb1??wP\\xc1=\\xd8\\xdc\\x17?\\xe7\\xcc??]\\xc6 ?%\\xd5\\x1d?\\x9f\\x94a?\\x1b\\xcf1>R\\xcf\">l\\xa7{>\\xe8Df<\\xc5\\x02L?\\xa8\\xc9\"?\\x12\\x17\\x0f?\\xd3\\x17\\x06?2AE?\\x1a\\xd9\\xc0=\\xac\\x06h>\\\\\\'\\x10?H\\xb2\\x1e>\\xe3=S?E\\xee\"?J\\xa2\\x02=,l>?\\xa1\\x97\\x83=s\\xf3-?/\\x04~?\\xa2\\xac\\x9b>k\\xaa\\x1a<\\xe0\\x1c\\x06?\\x00\\xa1s?>\\x8f\\xe1=\\n\\x9f\\xd7=\\xd0\\xc1\\xc1=\\xf0\\xf1R?\\x99$q>l#b?\\x9b\\xe6\\xd8>\\xfe\\xa2\\x1e?\\xd8\\xdb\\x9b>R\\x86L?\\x95m\\xff=\\xd8#\\x0c?\\xd77\\xd7>\\x83_\\xbf>\\xece9>\\xbc\\xe8\\xac<q\\x00~>E\\x0ei?\\x01Kg?m\\xa1/?\\xe8n\\x8f>\\xc9@\\xb1>\\t\\xdb&>\\x84\\r\\t?\\x9a\\xa4=?\\xce \\x10?\\x91\\xae\\xcf>Db\\xce>vB\\xc8>\\xd9\\xffs?X\\x83\\xec=\\xbf)\\x18?;\\xde\\xa0>\\x19\\xac\\x14?\\x99\\xe6\\xed>t\\x17r>!g\\x03?BD\\x86>\\xe7\\xcbk?\\xd8\\xa2B?\\xcd\\xc7\\x01>m\\xc4s?\\xf0)\\xdb>xuG?\\x10\\xd8\\x10?;\\x04+>-`e?\\xc4\\xf7\\xa8>\\xf9\\x86\\x80=\\x04\\x11M?\\x9e\\xe9\\x16?:\\xe2U?W$\\x93>\\xf7\\xbc{?\\xa7\\x02E?\\x95\\xf3\\'>\\xcd\\xb0\\x0b>\\xe2\\x0b\\xa3>\\xbe4V>\\x1fJ.?\\xbayg?\\x0c\\x15\\x1d>\\xfcQn>\\x13\\xb6\\x91>\\xad\\x01]?\\xbcMb?Yw:?,\\xed\\x81>\\xaf\\x87\\xeb=\\xed?\\xd6>\\x8cQP?a\\x89C?\\xb9S*?\\xf5\\xcb&?1\\xc4\\xcc>%J\\x80>Du\\x16=\\x05\\xd6$>u\\x8e\\xe0>\\xd6\\x81L?\\xa6\\xac\\x10?\\r\\x11i?\\xb2~2?\\xa5\\xca]?\\xfa}\\xc4>\\xc5m5?3R3?\\xdb\\x13\\xdb=\\xb3\\xa0[?\\xf0\\xc4V?\\xe3\\x97\\'>\\xa0\\xf1\\x16?=W\\xf5=\\x17O\\xfc>\\xf1I\\xcd>H\\x05r=(kg>EE5>)f3?U\\xae\\xed>\\xdd\\xe0\\x9e>\\x9b4#?`E(?-\\xcdA?\\xba\\x81D>\\x87bk?Kr\\xf2>\\x88\\x15+=\\xc16\\xe6>\\x93\\x05\\xa1>\\xbf\\x7f}>\\xb72*?\\x0f\\xb4;?8\\xc3f>{\\xff\\x00?A&\\xfd>+g\\xdf>\\xc0\\xbf7?\\x86\\xd9F?~dk?\\xc7\\\\e>\\xff\\x99\\xf4>\\xfc\\x11\\x8b=\\xfdda?w\\xa7\\xae=w\\xa8\\xfc=\\xe7\\x10\\x02?\\xfa*E?\\x93L\\x1f?>\\x8dD?\\xdd\\xed\\x9d>\\xb1\\x8bQ?\\x0eV\\x99=F\\x7f|?m\\x10\\xd8>V\\xe0\\x17>\\x9b\\xca#?h\\x83\\xd7>\\xa4vX>\\xec\\xce7?\\xa5\\xf6\\x15?\\xe5\\x9e\\xbf>|\\x85\\xfb>)7\\xf4>\\xc5\\r\\x1e?\\x89\\xde5=\\x9f\\xc66?\\\\\\x8e\\r?\\xde\\xb58>JXe?\\xcd\\xe1\\xc3>\\x9f.p>\\nCw?\\xd4\\x01p>\\x81\\\\\\'?\\xa4\\x8f\\\\>\\x89\\xf1\\x84;\\xf5\\xdfu?\\xed\\x19\\xd9>\\x03~\\xf9>\\x8b\\xfb\\xca=$\\xe4\\xb2>\\xdb\\x92\\x01>\\xd0\\x90:?Le\\xff:\\x84\\'\\xef=0QM?\\xaf\\x01x?\\xb7C\\n?\\xc8\\xb9(?qea?\\x1f\\xbe\\x17?\\x86\\x0b\\xdb>\\x9f&\\x08>A\\xeb\\xc8=~\\xc9\\xa8>\\xd08\\x88>\\x87\\x88O?j\\x96>?x5l>\\xdf\\x8f(?\\xd4[a?}T\\x07?\\xb8\\x0c1?V\\x8fl>>,F?8\\x8a$?\\x01\\xf6+?9\\xfd\\xeb>\\r\\xf0:>\\x13\\xd8~=u\\xb0{>;\\xcc\\x11?\\x94I\\xb3>\\xcf\\x87\\xcb<\\x82\\xdc\\xa6>\\xb3\\xda\\x03?G\\x92,?\\xc4\\xcaG?@\\xabV?\\x86\\xb1\\xff>G\\x82%?\\x93m\\xe7>\\xb6\\xb4\\xd0<\\xc1^Z?M\\x06g>\\xf7]G>\\x92/\\x87>\\x03\\xe4e?1\\xb4\\xe9>\\x12%\\r?\\xa7)\\x89=/\\x18O?\\xfcW\\xf7>\\xa1\\xdb\\x17?\\xd7@\\x11?\\x04\\xea\\xeb>_\\x912?\\x0bK\\xd8=\\xabat?\\x89\\xc5\\xdc>\\x93\\xc1\\xe0<0\\x91\\x07?\\xa2H\\xec>\\x16E5?\"\\xfb]?<p\\r?y\\xa7s?-\\x93\\x07>iX\\xcd>t\\x7f\\xe8>\\xc7\\x88\\x80>u\\xaf\\x11?\\xb4`\\x02=\\xf1\\xe6\\xb8>.\\xd7;?\\xeb\\xe82>KO\\x8d>\\xc7\\t)?\\x86\\xd7\\xed>z\\xf99?\\'\\xf8b?\\xaa\\x1bC=\\x7f9`?tGi?Kc\\xf8>\\x97\\x96a>\\x03\\x82\\xba>\\xfc\\r\\x85>\\xbb\\xd3u?j\\xb7<?>\\xf8\\x81>\\xd9\\x16+?g\\xdc\\xb7>P\\x00q?\\x1b\\x81+>g\\xbea?\\xcf\\x9b\\xe6>O\\xab\\xbf>S\\xe1{?\\x18\\xec\\x85>\\x92\\xc5>?e\\xe8J>\\xc7\\xf2\\xbf>\\xbc\\xf7\\x06?\\xc0\\x91?>$\\x18>?\\xdc\\x8d\">]\\x1c\\xa5>\\xb7!l?\\x94\\xf4\\xb2=8\\x05b?\\xf9j\\x02?1\\x1b\\x9a>\\x01O\\x05?\\xef\\xcb.?\\xb7\\xe0\\xeb>\\x872H?\\x7f\\x1a\\xb6>Q\\xc4P?F+3?X\\xab2?^E+?\\xaaK\\xaa>\\xa5\\xbf\\xbe=\\xc3F\\'?\\xcc\\xb2M>q\\xd4.?s\\xf9K?e\\x0es>\\xa2]\\x1c?~h\\xa5=\\x8d\\x81;?\\x95\\xd7\\x19?\\x9f\\xbd\\x7f?:\\x00f?\\x1c\\x19\\x12>1\\xd2\\x80=\\x81\\xb1\\x06?\\x83\\x9bb>5\\x8f\\xae>-\\x9d\\x1d>\\xf4\\x89b?z\\xfdT>\\xf0n`?,\\xba2?\\xbe\\'\\x1d?\\xc6\\n\\xb1>J\\xd0k?\\xa4\\xfcq>\\xd4\\x02\\'??@\\xaa>\\xc5\\xfc\\x93>\\x8f\\x12y>s\\xa1\\xc7>\\xfa\\x15J>\\x13\\x90X>\\x9c\\x0cp>\\xe5\\xd0\\xf9>p\\xb0\\xad>Ef\\xb3>4\\xb1L?^\\xa3\\x87>_\\x8c\\x05?:lE<\\xfc\\xf8w?u\\x12\\x8a>W5\\xf7>\\xcb\\xb8{=s\\xa7\\xc9>K\\x88P?\\x93\\\\\\x93>\\xb0\\xed\\x03?\\xdb|-?\\xb8U\\x1c?\\xe1!<? \\xc6\\x94>n\\xcec>m\\xa6K>.\\xd3Y?\\xeeN\\x12>\\x89\\xa8@?\\x80\\xeaO?*l\\x7f?\\xa9\\xe6\\xc0>$F\\xcc>\\xf3\\x8e\\xd1>9\\x98\\xcd=6n\\x01?\\xd8\\x1et?+\\xb3I?\\x9d\\xdc\\x11?\\xc5v\\x10?%\\xda:>\\xbfC\\x17>\\xda\\x85\\xb8=*\\xceO?3eS>\\xff\\x1c1?fs\\x1e<\\xa12\\xce>\\xecB\\xbf>\\xb9$,?\\xfa\\xe6N>\\xdc\\xb1H?\\xf2\\x07\\\\>\\xc6\\x9e\\xf0>\\xce\\x18L?K\\xc1\\x13>x\\xd5)?F{q?\\xe7f.?S\\x02!>39.?\\x19c\\xaa>}\\x9bs>\\xcf\\x1fx?D\\xf3\\xd8>!!H?\\xa7uD?\\x8c\\x9e\\\\?\\xb5\\x1dY?f\\xb0\\x04=\\x90\\xda\\xd1>\\xd2\\x13\\r?\\x92{\\xcb<\\xa1\\xf4L?\\xedh^>\\xe6\\xe5o?\\x86\\xe49?oS\\x1d=sWs>\\xb0c\\xad>\\x94\\x1e\\xd5=)\\xdf\\x12?\\xb5A\\x1c>\\x11\\xda{?\\xd5+\\n?\\xd1G\\xe4>\\xdf^7>\\x9e-\\xc7=]\\xbbp?\\x88\\x97\\xaa=\\xfc\\xb3y?J\\x0c\\x0e>\\x83\\xa0\\x89>\\xfeEQ?\\x93H\\xd9>\\rZ\\x19?\\xfc\\xe2\\xf5=\\x93d\\x0e?!\\xb1\\t?\\xaat\\x19?\\xce\\xc2\\xdf<C\\x1c\\x9d>s\\x8fd?\\x17\\xd53>\\x01\\xcd\\xd0>\\x86\\xbfD?\\xdbD\\x1a?\\x17\\x81\\xac>\\xfb.#>\\xfe\\xfd\\x15?\\xb8\\xa0\\x00?TnZ>Q\\xd0\\x15?\\'y\\x13?\\x04\\xca\\xe4>^\\xc4\\xb6=\\xa9$]?7\\xc1\\x9f>S\\xbf\\xc8>\\xa7=k?2\\xf7D?%\\x03c?O\\x99l?\\xd4]\\xa0=K(\\xda>\\xa6\\x90]?2<\\x13?\\xb4\\x16a?y\\x80h?k\\xed\\xd8>D\\xa1\\xa7>\\xae\\xc4\\x1f?\\xe5|\\x05?\\xc9g\\xe6>\\xfc4\\n?\\xd9\\xaf\\xf9>\\x10@\\xf1=% \\xe2=\\xb5\\xae\\x1a?\\xedv\\x8b<\\x98\\x01~>\\x81\\xb4\\x13?\\xa4N\\xe6=\\xb69-?za\\r?\\xc6\\x00A?\\x97\\xf2k?\\xa7\\x06U?\\x91\\xbfs?\\xfd\\xa6\\xf6=K\\xf8=?|\\xea\\xd3>\\xa7\\xaa.>\\x12\\x08F=\\xa2\\xcd\\xf4=\\x8doh?\\xb8\\xe7q?gt7>\\x03\\x91C?ML\\x03?\\xe7m/?=B\\x06?\\xe3\\xd2E>P\\x1c\\x10>uH\\\\?|\\xafH?\\xa2\\x82|?\\xad\\x99\\x14?6\\xb2V>\\xe9)\\xa8<\\x04\\xf3\\x04?B\\xa1$?ne\\xc5>\\x96\\xb2/?\\xb0&\\xa9=\\x8f`\\xaa=\\xce-\\x03=\\xbc\\x10\\xdd>!\\x16g>[R\\x04?\"\\xa3F?\\x83\\xd6B?Z\\xefC?\\x85yX?%o\\xa4>z\\x19}?\\xf7\\xcf\\x92=\\xf7b\\x9b>\\x8cG\\xcc>\\xfeY8?\\xd8\\x86\\xac>\\xb3al?\\x00\\xf5\\n?t\\xfcx?B\\xe7\\xe7>W\\xb8\\xb5=K\\xedv?(:I?\\x82\\x9a\\'?\\xe3\\xef$>fW\\xdd>\\xf9\\x81Q;P\\x9a\\'?\\xfak-?\\x1b=+?P\\x11E?\\xcbG\\x07?\\x90\\xcc\\x9f>4W\\xfc>E#\\xa5>\\x08\\xf1V?-o\\xf7>%W#?\\xfd\\xda\\xa9=*\\xab\\r>\\xb5\\x1a\\xd1:\\xbb\\x89Z?1\\xa4Q?*\\xc7\\x05?\\xe0u.=S\\xbe\\x08?\\x1c\\xe9\\xc7> \\x95\\x9d>\\x84\\x03+?\\x1a9A?\\xcb\\xb8\\xa1>\\xfb\\xa1\\x84=\\xac\\xadc?\\xe5\\xca\\x81>\\xec\\x07/?\\xc9\\xe0p?(TU?\\xef\\xefP?\\xec\\xce|>:\\xc5\\x17?\\x1a\\x89\\x9c>\\xab\\'F?,\\x9eR?\\x8d;\\xb3>Z {?\\xa8\\xee\\xbb>|\\x81m?=\\xf4`>\\x01\\xea\\x9e>q68?Xcj?T\\x04\\x1e?\\xb1\\x13$?\\x88\\xea\\x9b>\\xa8\\x83\\x08?h\\xffd?Vw\\n?\\x07\\x93h?424?_\\x1b\\xf9>r\\xcf]?L\\t\\xdc>i\\xc9q?$B\\xce>\\xb8\\xc6\\xb1>\\x01\\xe5\\xa3<\\xd6z\\x9b>\\x15\\xecn?\\x96\\x0c<>7\\xa2\\x96>\\xe1:=?2\\x03\\xe9>oPr?\\x85\\x9b\\xac>r7\\xf3=\\xe0^\\x0c>\\xefk\\r>f\\xac8?\\xbc\\xe5\\x11?1kS?\\xd9\\xd3\\x1a>M\\xfe\\\\?\\xb3J\\x14=\\x90\\xba@?\\x98\\xfc\\x8b>\\x01\\x8d,?>\\x13{?\\x0bb4?\\x9b\\xc7\\xd4>b\\x16\\x99>^9;?T\\xec\\xd3:^*K?\\x1b.\\x05?\\xa3\\xb1\\x88>-\\xb2\\\\?\\xa9\\xd3\\xba>y\\xda\\xb8=\\xc2{\\'?\\x95A0?j\\x80S?yB\\xe1>:\\xa4T=Q\\x01y>\\xa3-l>-\\x08\\x19?\\xe5\\xe6\\x08>q\\x0e1?\\xe7wG?\\xcbs$?pH)?\\x9b\\xb8\\xe6:\\xad\\xc8I>\\x8a\\x9ad?\\xff\\xcet?\\xaa\\x1f\\xce>\\x92U\\xfc>\\xe1\\xb4V>,T8?\\xbbR+>\\xf0\\xc7a>\\xd8\\xa1\\x90>\\x14\\xc7b?RFP?6Ps?\\xd1G8>\\xbcQA>4\\x99\\xbb>0\\xfd\\xda=\\x89\\xdc~?l%R?\\xb8\\x05\\x1e?\\x0cS3>\\x1c\\x8aU?y\\xb2P?\\x15\\x97\\xe7>5\\x91G?8C\\xa5>c\\x8e\\x0e?\\\\UP?;4m>6\\x024?\\x11\\xed\\x87>}H7?f\\x8e&?+\\xe4\\xc0>\\x11\\xfdL?\\x94\\xf1\\xef>\\xea\\xa3\\x08?1h\\xfa>\\xed\\xfdJ?*\\x13:?\\x16:\\xe0>\\x0c\\xd8\\x14?\\xb9\\x1ej?(\\x8c\\x94=\\xce\\xe6\\xa3>F\\x14\\x99>r\\xf8T?\\xa5~\\xca=t\\xe7e?\\xfc\\xbd\\xc6>+\\x8c\\x08?\\x88\\x99b?\\xb7\\x02|?B\\xa8\\x87<*\\x0f\\xea>\\xf6\\xc8~>\\x9b\\x92[?\\xdcO\\xa2<\\xa6=Q>\\x9a\\xfbl?\\xa5\\x89\\xb0>\\xf0f\\xd5>v1/?S\\xbd3?\\xb9\\xc5D?\\xc5\\x0f\\xff>\\x07\\x043?\\x08\\x05\\x12?&\\xc3G?#\\xcb\\xb6>$\\xf3h>\\xf6\\xd1\\\\?z\\x85\\x03?I-\\x1b?I\\xf8\\xb1>\\n*\\xb9>\\x82\\xcd\\x1b>\\x11A\\xd9>VE(?v\\xd2\\xa4>\\xf0\\x8f\\xc3=a\\x89\\x7f>\\xbcF\\x9f>\\xe5\\x97\\x81>&\\x1eI?\\x1f[\\xab=r\\xac\\x1a;\\xd6\\x16\\x1a?\\x06\\xfa\\'?[\\xc1\\x13>\\x1el(?\\x971\\xd5>)\\xbc\\x85>|\\xe3;?@KB?\\x99\\x17\\x13=\\x1a\\x9dP?\\x92\\nR>c\\r}?1+\\xfd>\\xb61&?\\xd7o@?\\x0cP5?\\xcf\\r\\x08>\\x06Qo?\\xa2\\xe2Z?\\xa5\\xccY>X\\xda\\xdb>]\\x8a9?\\xbc>u?\\xfc\\xcc->!\\xe27?\\xec\\xd4Y?\\xabj^>v\\xa7W?\\xeb\\xa52?\\xbb\\x10$?\\xa3\\xf3;?BOw?\\xc6=p=\\xadU}?\\x14\\x9a\\x03?\\xc8)\\x01?\\xa7\\r\\xa1>\\xfdKX?\\xcf\\xab\\xcd>\\x0ecE>\\x88Ox?bx%?\\xe8sg?\\xa1\\xb2d?\\xed|\\x98>/p\\xa1>\\x90b\\x0c>Rd#?\\xde\\xda_?\\x1a\\'\\xf7>y\\xaf:?%`\\xe7>\\x99_+?6\\x8a\\x08?\\x19YJ?\\xc1\\xb1\\xd9>PF\\xe2=\\xd4\\x8a\\x1b?\\x1f\\x18\\xa5>.\\x94<?\\xc3T\\x1b?VVu>\\xd5\\xe0\\xfd>VC\\x17?BE\\x0b=\\x9a\\xf7\\xe1>CTK>\\x97\\x92d?\\xec\\x1f\\x1b?\\xe0\\xc7J?\\x9b\\xef\\x13?\\xdd\\x8e\\x0b?q\\xb1a?\\x07Tt?\\x91\\xa7\\xe9=(\\xe3\\xaa>\\x04\\x8e[>?\\x19\\xc8>(\\x10\\x9f=d[}?\\xf2\\xba\\xa5>N~\\xd4;98$?DG\\xc8<3\\x026??\\x99e?'},\n",
+       " Document {'id': 'doc:b', 'payload': None, 'score': '0.253424823284', 'vector': b'1\\x16\\xe9>\\x9cax?z\\xc6c?\\x92\\xa2%?\\xcdk\\x9c>\\xa3|\\x8a>#L\\xec>\\xc9\\xca\\xf0;\\xce\\x1d\\x1a?\\x12\\xe4\\xab>h\\x88\\xe4>\\x9a\\xb4\\xe8>\\xb7\\x03\\xdc=\\xf2*l?\\xe7\\xe1,?(;p?\\xceL\\x13?\\xf5\\xfd\\xdc=\\x19\\x92\\x84=7\\xe1\\x7f?\\xb7\\x898?yR@?\\xa4\\x1cp?S\\xde\\xb1>5#\\xf4>F4\\xc4>\\x14R\\x18><W\\x0b>\\xb8n:?/%A?NEU?tu\\x0e?\\x85\\xe8\\x88>e\\x04\\x1b?T\\xed4?\\x08\\xea\\x03?\\x98\\x16p?\\x0f\\xa4\\xfa>$\\xb5O>\\x9b\\xb0~?\\x94\\xab\\xbc>\\xa0\\xe6G?\\x1f\\x8bz?s\\xca-?\\x03\\x9e\\xb3>\\xb4|\\xd1=\\xf0Z_<\\x1a\\xe3:?\\x06q]>\\x02\\x0b\\x9c>\\xdcZ\\x1a?L\\xb0\\xcc=E^\\x1a?\\x05~\\x03?m\\xea\\x15?\\xc4r]?\\x0c\"\\x89>\\x9c\\xb78?\\x87\\xf3\\x8f>+e\\xc0>\\x16\\xe3@?\\xa5\\x85M=jq\\x12>5.`=T\\xac&?\\xc7\\x91\\xb8>\\x93\\x9cs?\\xb1\\t\\xfa=\\xb2\\xdfd?#\\x8cO?zX&?R*\\x05?\\x90\\x9f\\xf7=\\x83\\x9c\\x02=AY\\x1d?m$w?\\xa6\\xc4\\x80>\\xfd\\xceH?\\x87\\xbaK>\\xca\\t\\xf8<{\\x1c\\xf5=L\\xf9a?TB ?\\xae\\xcd\\xb2=\\xd0*\\xe9=\\x92\\x88[?[\\x06F?\\xb4\\xffu?Y{\\xbc>\\xba\\x8bU?z,\\r>d\\x7fE?\\xcd\\x85\\xb4>m\\x91\\x9a>z\\xa5N?7\\xd5\\x8a>\\x8a\\xfbA>n\\xa2,>\\xf9j\\x04?\\xe8\\x84\\\\>\\xb4A=>\\xe8v\\xde>\\x19\\xbaX?\\x1d\\xd3E?\\x90\\xcf\\x9f=\\'\\x18w?\\xbd:\\'?1C\\x17?\\xac\\xaeJ?ae\\xef>\\xc8_v?\\xe8\\xfcP?/\\x96S?E\\x16D?2\\xf4~=\\xcaV\\x1f>\\xef\\xdb\\x1a?\\x87)\\x11?:6\\xfd>uLk?\\x9ddT?\\x02gc?\\xc7A\"<\\x87\\x18v?x\\xec8?\\x84\\xad\\xf4=\\x0cj\\xf6>\\x04\\xa0\\xaf=\\xa5\\x12\\xf0>\\xda\\x98}?kB\\xab>\\xd2\\t\\x9c>\\xf0\\x90\\x8c>\\xbe,9?\\x1b>S?J\\x17[?+\\xb2k?\\xbdO\\xf9=\\xb8\\xdd\\xaa>\\xbc\\xbc\\x1a?\\x98\\xa3&=\\xdbo\\x1b?*\\x1c\\x17?\\xacP\\n?\\x15\\x99\\xfb=D\\xd6s?\\x97:~?\\x83\\x97H:\\x814\\r?\\x1d\\xbdt?\\x98\\t\\x0e?\\x10\\xbd\\xf6>\\xad)\\x80=(\\x8b!>Th\\x1e?\\xfaOX?\\xd835?\\x00\\x8c\\x03?9\\xf1\\xa7=\\x80\\xbd\\x12?*\\t\\x19?F\\xa7\\xd2>\\x0e\\x9c\\x1f?\\x8d\\xed\\xf9>\\x8bD\\xea>\\xdb\\xe4+?\\xb3%\\x12?h\\xd0F=R\\xb5\\xc7>\\xaf\\x99\\xe8=\\xda\\xe4\\xe6=J\\x073?4;\\x1c?|e\\xf6=\\x99\\x8e!?\\xdeJ\\x9d>5\\xa2j>\\x06\\xdf ?\\x99\\x85\\xfb=A\\xcce?z\\x19M?\\x1f\\xccA?\\xb3\\xea)?Ex\\xf7>4\\x15%=\\xe4\\xe1(?C\\xe0~?;\\x9a\\x19?\\xe2A.?@\\x82\\x1a>\\xf2\\x909?\\xcb\\x18\\xfe>\\x87\\xff\\x11?\\xd0-H?h\\xd9K?Bps?K\\x9b\\x0b?|%u?\\x1b\\xcd\\n?\\xbb\\xdb\\xb9>]\\xd0\\\\?\\xbee\\xb5>*\\x9f\\x9b=\\x8f\\x1b\\x7f?O\\xf8N>\\x91\\xf2b=\\x9a\\xe5\\xcc=5\\xf3o?\\x86\\x83\\xbc>9\\xaeG>#\\xd4\\xbe=\\xa9m\\x85=\\xc3\\xa7\\xf3<\\xf6\\xb3\\xed>\\x94\\xcc\\x98>\\xb7m\\x12?\\x19\\xbaq?\\xae\\x96Z?g\\xa2\\x11?j9\\xc2>/\\xc2f=&\\xcf??\\xdc\\xado?\\x01d\\x1f?B\\xb8U?t\\\\b?\\xc0W\\x9c>r\\xeb}?\\xef\\xc9\\xe6=\\xaf{#?\\x89BW?S\\xffO?\\x8e\\xaa\\x03?\\xfb\\xf1\\xb5>0\\x89\\x81>\\x96\\xed\\r?\\x88W\\xf6>\\xe5ZG>\\x122\\x14?\\xe8\\x0e\\x91>\\x1a\\xc2\\xf4>\\x15\"Q?\\x8c\\x87\\xa0>\\\\d\\xa7>p\\x94-?\\xe2\\xe5\\x17?\\x8f\\xe5\\xdd=\\xb9\\x04#>_\\x9fU?\\xd8\\x0cL>2Jn?1\\xa7\\\\>\\xebT\\xe4>NT\\x9c>B6\\x0e?_\\x0fS=\\xb6\\xcdR<\\x96\\xb2\\xc9>\\xbc\\xf6\\xe2>^\\x8f\\xa2<\\x95\\x93\\xee=\\xf3\\xc0C>\\xfdw\\xd1>\\xbc\\xba\\xf5>\\x8b\\x13Q?\\xa5_\\xaf>\\xa9\\xb0W?\\x1bWd>!\\xa8\\xf8>\\x9d\\x87\\x17?\\x84.\\x01?G<\\x10?\\xf6^\\xc9=\\x8a\\x87g?\\xae\\xc61?\\xcbn]>\\xe9\\xf9+>\\x1b\\x01\\x99>\\xcd\\x02\\x86>\\xeb\\xe0y?\\t.4>\\xa4\\xb2\\x01?;4]=}\"\\xde>\"\\xf5n>{\\xe7\\r>\\xbb\\x03G??8\\x18>\\x96\\xd1$?\\xed\\xa2\\xcc=\\x8d\\xef\\xd1>t\\xf1\\x08?\\x82\\x9cO>~I\\xf2>\\x0b\\xd6\\x1d?\\xff-\">\\xb8(_?W\\x94o?\\xcd\\x08A>\\xac7\\x87>\\x15\\xaf&<\\xab\\xcd\\xd2>\\xf6\\xb9\\xae=@M\\x86>\\xb2\\x89^?=\\x10j?x\"\\xb9>\\x03\\x05H?&L}?\\x05\\x803>\\x97\\x18\\xe4>\\x1c\\xb9\\xaa>\\x07\\xb5\\x9d<\\x05\\xb1~=\\xa9L\\xbc><)[?\\xdc\\x8eC?\\xa3\\xcb\\xf8<k_>?_\\x12e?3\\xce5?\\xef.V?h\\x92\\r?U<\\xa6>\\xe6,\\x83>J\\xd3\\x8a>\\xf4\\xe6*?\\xf1y]?\\xea\\xda\\xea=|\\xff\\x96>\\xe4\\x8ed?\\xff\\x00\\x82>\\x13\\xb6\\x1e?\\x04{h?\\xa9\\xf4\\x86>\\x8d\\xed\\xf9>]\\xf3|<\\x8d!\\t?mq\\x94>M6]?\\xa5cP=\\tb~>\\xcf\\xd6\\x83=K\\xb4Z?\\rPt>+\\x1bW?\\x93>W?\\xc7E ?\\x81\\xcb-?D)i?\\x99\\x02\\xb0>\\xa4X\\x18>:\\xc5\\xc8>~\\x85\\xef>=\\x7fy>h\\x8ee?\\x02\\xd7Y?\\x1bd\\xf2<\\x82\\xda\\x0c>\\xb9f,>\\xed\\xd9:?\\x12\\xf66>\\x90\\xeek?:+l?+e\\xbe>7\\x18=?j\\xda~?\\xd0A\\xb8>\\x8f2\\x95>E\\x92\\xc0=f\\xb2\\xbb>X\\x8e\\x99>\\xfc\\xcaa>\\xa7j\\xde80\\xe6\\xde>\\x8d:l<[%\\x0c=\\xaaq\\x05?\\xe8\\xf7\\x89>\\xc4\\x9c\\\\?h\\xcfG?\\xfa\\x03T?v\\x03k?\\xc7\\x90\\x0c;Y\\x8fL?\\x15S\"?\\xbc\\t\\xd9>\\xc8\\xda\\xa4>\\xcf\\x82+?\\xe0\\x11\\x1c?\\'\\xe2\\xc5>a\\x031?\\xd4\\x08G=\\x82\\xb5\\xd5<\\x9e\\xa7j?b\\tx>&I\\xc1;\\xfa\\xc0c?8$\\x0c?t\\xea??\\x1eoT?\\x02*l?\\xe0\\xee\\xa0=3\\x0f\\x84>\\x81\\xae\\xbc=!E\\xed>\\x0b\\xee\\x80=|^\\xeb>\\xb6\\x0b@?\\x1a\\xb5v>\\x86\\xc5M?\\xb3]k?x\\x0e\\xe1>\\xb0d\\xcb>\\xe5\\x7f\\xa5><\\x89\\x10?{\\x96\\x96>\\x9bqf?\\xf6\\x9cd>b\\xee\\xbf>\\x8dP\\x00?\\xbe\\xa8;>a\\xf0\\xd4>?\\x89T?\\xbf\\xff\\xb8=\\xe5\\ry?\\x1b\\xcb\\x02?\\xb7S\\x19>\\x0f\\x96&?\\xa1\\xca\\x18?[A)?y\\x8cX?\\xf5O#>\\x85\\x8f\\x11>}\\x14\\x81=UN\\xb6>\\x8fi\\x92>\\x9d\\x84A> \\xd5\\xad>\\xff2\\xa2>yG\\x18<\\xb5m/?cW.>#\\xa1e?\\xa0\\xfa\\x1d?\\xcfd\\x16?E\\xaal?M\\x87x?\\x8b0\\xe6>\\x10MW?\\x01<\\xd1>\\t\\x990>\\xa32\\t?\\xfd\\xe3/?\\xa9\\xe5=>\\x7f\\xdd:>a,\\'>Eo\\x06?\\xe9\\xabe?\\xc5\\x879?\\n\\xe5h=\\xd4\\x0b^?y\\xa7G<\\x02A\\xf5=\\xf7Hy?\\xe3\\x9e ?\\x82\\xb6>?~\\xf8\\xf4>\\x90\\xd8\\xaf=\\xfcpX?\\x1d\\xa5\\x1e?2\\xc11?\\xadf\\xe1>\\xcf\\x1c\\n?x\\x0f\\xd8>\\x86\\x02\\xa9=\\xb8\\xb3\\xcf=\\x11\\x91:?\\x92\\xf4\\x0e?\\xbf\\x14\\x9b>\\x93G\\x7f>\\xaa-\\xea>\\xf1\\x95\\xbb>\\xa0*\\xde>R9\\x7f?\\x95\\xe2N>B\\x84\\x12?2\\xa0u?\\xadbD?\\xbb\\xefO?i]\\xf8=b\\x05\\t?g\\xd6\\x80>F\\xf6[?n\\xde\\xb0=\\xa2\\xbdj?I^\\xfd>\\xb7k\\x07>\\x1bE\\xf8>vB\\xb7>O%=?T\\xebF?\\x90\\x87m?Q+\\x16?YCc?\\xba\\x08\\xb4>\\x0fNT>xe\\x0e?\\x974P?\\xc4\\xbdi>\\x8bu\\x81>U;\\x1a?|\\xae8?\\x1f\\xef\\x01>4M\\xaa>\\x7fgr?\\xf8\\xd6\\xba>z\\xa0\\xbc>}\\xde/>\\x90\\xbeI?\\xa5\\xc2e?\\x9e\\x0cf?\\x95:J? \\xb2\\xf3>\\x00\\xf6p?\\xdaZE?\\xce\\x18\\x1d>\\xe8\\xdc`>\\x9f\\x03\\xa0>\\xe1\\xf9\\x1d?E_\\xcd=\\xdc\\x1e9?\\xb3?a?\\xcfnf?\\xc1$\\x01>5S\\x11?f\\xf38?0z;?\\xfd\\x8cb?C\\xe1\\xe6>\\\\\\xd3S?l_\\xa5>k\\xe8\\x1f?\\xa7\\xe3\\xea>\\xb5$p>\\xa9\\x90\\x05?z\\xf4P>&\\xb0\\x0b?M\\x8b\\x08?\\xdd\\x94\\xcf>MA\\x0b?\\xea\\x12\\x19>l\\xf2\\x1a>\\x9e\\xecs?\\x1a=\\x83>\\xd9\\xc5\\t?n.2>\\t\\xb73?\\xbb\\x9f??\\x15=a?s\\xd5N?\\xb7\\xc9b>`\\x1dP?\\xa2\\xd0\\x80>\\x04\\xf4\\xd0>\\xf6,K?~\\xb2z>\\xcc\\xa5s?$\\xd0f=\\x1f\\x86\\x1d?\\x17\\xc8v>\\x11\\xd8@?,@0?\\xc7\\xa9\\'>\\xc0/\\x1b?!\\xbb\\x85>I\\x9a\\xb5=7\\x8dx?z\\xa7w?w\\xb4\\x1e>6\\xb8\\x7f>\\x8a\\x86\\xca>K|`?\\xd5\\xc7\\x19?\\x99E ?0@%?\\xf3\\x0f\\x10?\\x9a\\x01\\xa2>\\xc5\\xbe]?\\x13LR?V\\x0eH?\\x7f9\\x13>\\x10\\x10\\xce>\\xba\\xd6\\x00><\\x03\\x87>\\x1d/\\xaf=Q\\x06x?6y\\x03<\\x9c\\xa88?\\x06\\\\\\xa0>\\xf24\\xe8>\\xe57V>\\xe4\\x803?\\x0fu5?\\xb8\\x02\\xd2>:P!=\\x08\\x98\\x88>&\\x1dW?\\xf9f\\xcc=BU&=;\\xb5\\xd6>\\xa1\\xa5\\xb3>wj`?\\xf9 g?\\x02A+?\\x12\\xe4H?\\x99\\xb4\\xf6=\\x15\\x02\\xed>\\x9eKZ>\\x14vX>\\xc7\\xe2\\'?_\\xd16?e\\x166?y\\xc2R>\\xc3\\x93n>\\xc8\\x98\\xc9<\\x9d*\\x01?\\xf1*\\x8d<\\x9e\\xe2\\t?\\xbb\\xcdS?C\\xdc\\x0c?\\\\\\xa6h?\\x9a\\x13\\x8d>5\\x023?$+\\xcf=\\xd5H\\x03=w\\xba\\xba>\\x1f\\x86P>0\\x06\\x0c?*\\xac\\x03?\\x8e\\xeb_?\\x14~\\x14?\\xa1h=?*<\\x94>\\xe3\\'\\xa5>&\\xfb2>\\xf7\\xbc\\x9a>2\\xc2\\xf6=a7\\xad=<3\\x03?\\x89\\x16u?f\\xa2v?\\xfc{\\x05?\\xe9\\xbf\\x95>\\xc8\\xc9\\x0e?\\x81\\xf9D?\\xbd\\xc8\\x18?\\xe7Y\\xb9=\\xa8\\xac\\xa8>\\x109c>\\xd4\\x04\\x18?7\\x859?\\xa2e\\x92>\\xcf\\x9d\\x11>\\x95\\xe6\\x94>\\x17\\x02\\xf1>\\x85\\xd3Y?\\xa0E\\xc6>\\x80n\\xe2>/\\x03\\x10?\\x16-\\x8b>\\x95h,?r\\x1a\\x11>2L\\xe3=\\xa0\\xf8E>\\x8b\\xc3\\xfd>\\xebN\\xc2>\\'=\\xd2>\\xc6\\xadM?\\x04\\xe8\\xf6>\\xf2\\x89\\xc5>*JG?\\xdb\\x1db?o\\x9bg?\"\\xf7o=ly&?2\\xf6f?2%\\xd8>\\xaf70?\\xfdV\\x82>\\x1a\\x10v?\\xa4\\xe9\\xd4=e\\x8cK?\\xf2=\\xe5=\\x8d\\xa9u?C\\x1c\\xff>Maq?I\\x97\\x10?t\\xbf\\x04?\\xe3Z\\x00?\\xa5\\xec\\xf7=\\x0ew\\xbb>3jP?\\x1eS\\xec>\\xdb\\xe1??\\xde\\xb5\\x15?\\xb1\\xc0H>\\x0f\\xf7,?F\\x83\\x8e=\\xd5\\x08_?\\x1a\\x0fo?i\\xe3p?\\xe0\\x1a\\x11?_\\x0cI?rF\"?P\\x82&?\\x94\\x8fY?\\x0f\\xb5c?\\xc5$\\xa4>3-}>\\x05\\xdcV>\\xeb.\\xe1>\\xa5\\xf8\\'?\\xbd\\xaaN>\\x1b\\xc3\\xce=\\xad\\xc2\\x0f?R\\x80k?\\xb0\\x95\\xf2>\\xa8\\xe7\\xb8=,3\\xb0>\\xc0i4>9\\xd1\\x1d?\\xc5\\x8d\\x11?\\x17\\xeb\\x13?\\xed\\xecE>\\x88\\xb6Q?Ou\\xea>\\x84<\\xed><\\xcf\\x02>\\xec\\n\\x90>\\xb1\\xe4\\x15>9\\xf8U?\\x90\\x91\\xb8>\\x94N\\xd6>\\xbc\\xf2\\x0f>\\xaa\\xae\\xb8>\\x83 \\xe3>fH\\r?\\x8a\\x19\\xae>c\\xe3\\x8c>x#w?\\x07*\\x14?\\xba$\\x89=\\x0c\\xe7T?\\xbb\\n\\x14?*\\xa5\\xd5>@\\x15\\xd4=\\x1d}1?\\xaf\\xbb\\x1a>\\x83\\x18\\xa8>0\\r\\xeb>\\xabt\\xf3>\\x1b\\x9f\\x03?}\\xd7k?2+c<\\x04\\xf2\\xe9=~B=?\\xc4an?`\\xd9\\xb3>\\x82\\x92\\x7f?\\xba}\\xa9>\\xe75j=\\xe8\\x9f/?\\xd4Z\\x19>\\t\\xaa}?>\\x97\\xa6=o\\x1b+>\\\\\\xca\\xf9>\\xe3Xl?C\\xa3T??*\\xf2>\\xe1\\xd7d?\\x90M\\xb2>2{U?\\xba\\xd0y?\\xe47M?M\\xca7>3\\x84\\x1e?\\xb0D\\xfb>\\x1d \\xc9>~I\\x16?\\\\O\\xf3=:\\xbf#?DT\\xdb>\\xa9\\x901>e\\xd9\\x16>\\xae\\x13\\xa3<\\\\\\xc5\\xfc>\\xde\\xabk?\\xd7\\xcc\\xdb<\\xdf\\xb6;?\\x99\\x13)>\\xc7q`<,\\xa5\\xe3>\\xb6\\xfd\\x02?\\x15\\x11\\x06?ia/?8\\xf1D>U\\xddf?\\n\\x9f(?O\\xf0d?\\xa114?\\x85\\xca[>P\\x89\\\\?\\x7f\\x1df?r\\xdd|?\\xb8\\xcfV?\\x96AS>gs\\x0b>}\\x89U?\\x89\\x18+?\\xa0\\xf4\\xb1>\\xf0\\xf3n?\\x8aQ\\x11?p\\xbdI>\\xed\\x10%?\\xdc/\\x08?j@\\xcb>C\\x04\\x8b>\\x8b9\\x11<\\x8a\\xc2 ?\\xb8,7>\\xd7$\\xeb>\\x8f\\xc0w?\\xfc\\x0fb>cJi?\\x00\\x14\\x0f?\\xeb\\xb9:?\\x18!`?.\\x18\\'?\\\\\\x98Y?\\xc1\\xe0\\xa9>~\\xae2?\\x8a\\xe0\\xa0<\\xec\\xf0&?\\xf71J?\\x92u\\xef>S\\xfem?\\xd6\\xea}=\\xfa@\\x99>8\\xffo>\\x83\\xddq?\\xf3m\\\\>%\\xfe\\xbf>\\xac\\xdc\\x1c?\\xba\\x80Y?\\x01\\x08W?`\\xf5i?\\xb0\\xda\\xdf>\\x08@>?\\xc8\\xb6\\x8a>\\x98_\\x0e=\\x88r\\x9e=\\x94h]>\\xa5\\xba*?\\x0c\\x10!?.\\xbe\\x9a>\\x87R*>-2\\x8b>\\x89\\x08I?*\\xf5&?\\n40?\\xe1\\xa6o?\\xafW\\xf1=i\\xb6\\x83>\\x10\\xe0\\x18?\\xb48B?\\t\\xaf/?\\xdf3o?)jY>i\\xce\\x97>X f?x\\x84\\xbc>d\\x7f\\x19>\\x00(\\xe4>\\xc7p[?J\\xce$>\\xe9\\xbeq?M$O?\\xdd\\x0b5=v\\xfaS>d\\xa5t>bj\\xec>\\xab\\xees?v)7?\\x9d\\x03\\xd7>\\xbc\\xa9\\x98=\\xc7x\\';\\xa4\\xb2\\xdf>\\xfe:\\x06?\\xde\\'\\xeb>\\xf5-\\xa7<\\x9c\\xc9f?`\\xf9@>\\x1e\\xffh?\\xe1\\xd7\\xbb>\\x84D\\xbd>\\xf4(\\x7f>D\\x15U?T\\x9e\\x80=>\\xbbO?\\xa8R\\xfc=)#n?\\x91\\xd8\\t?k9Q>$\\x9a\\xad>$\\xd3b?\\xee\\xb6.=\\xc0\\xf8\\r>\\x87\\x8f\\xa1=\\x95Y]?P\\x0f\\x1a?\\x14\\t\\xf0>n\\xa1\\x16>@\\xff\\xbb>\\xa44\\x03?<\\x87\\x8d=e4\\xd1>\\xbb\\x1fD?\\x84-\\xb9>\\x11\\xc6\\xab>\\xce\\x99|?\\x82\\xde9?C!\\xb1=nXh?|\\\\\\x12=\\x8a\\xea8?Q\\x80i?\\xf6\\xf3k?\\x8c#n?\\x07\\xb6\"?b\\xe5.?\\xc8\\xa0y?&{i=\\x1c\\xeb\\xa6>\\x14\\xc3\\xb6=6rW?\\xb3\\xd2\\xbc>t\\'k>F\\xca\\xa7>e\\xce\\x05?JL\\xa2>\\x13\\x02\\t?\\xbcF\\xc6>\\xaf=u?\\r\\x16p?\\x0e\\x002=\\x9b\\x89\\xfa=\\xcdY\\xb0>+\\xf4c>\\xe2Wl?\\x90m\\xa8>\\x14)\\x18?m\\xff\\xc7>\\x8f\\xda\\x1d?\\x19\\xa0\\x1d?Q\\xfbv?\\xcb[\\xae>\\x80\\xc3\\x9c>\\x1eP\\x17?G.\\x9c>d\\xcdD?7\\x1eC?\\xb9hK?E\\xdf\\'>\\xccPQ?\\x8b\\x1a\\xcb>\\x81^T>\\xe7\\x9b\\x97>:\\xa2\\xbe>\\x84e3?\\x00>\\xe1=\\xc0u\\xd0=\\xc3\\xb6\\xca=y\\xbaL?\\x1eU\\xb7>\\x1f`\\xcc>\\x16\\xf1K?\\xb4\\xed*?\\xa5\\x83\\x16>_\\xdd\\xfe=\\x0c\\xa3\\x01?1y\\xdd>\\x7f\\xaa<>\\x97[\\x14?*\\x7f[?n\\xf3:?3g\\xf6>\\x96\\xa1x>%n\\x96=\\xfa?\\x15?\\x08\\xf3\\xac>\\xe8\\xefh?B5\\x7f>\\xfd\\x9cu?L\\x0ew>.\\x1f\\x8c>\\x11\\xae\\xf0>\\xe1\\x0e\\x01?\\xca\\xac\\x17?8\\xb4b?\\xd3\\xa9\\xbf=\\x81\\x17i?\\x18\\xd4\\xd3>X\\x99\\r>\\x1af\\x1e?\\xc4\\xaaa>K\\xd8\\xb9>B\\xb3\\x0c?\\x9d\\xbdB?\\xb0PN?\\xad\\x1ah>\\xb9\\xfaL?\\xf1@*?\\x9d+V?1\\xf9\\xe4>\\x17\\xb1\\xc2>\\x9e\\xa3\\x85;\\xae4\\xdc>\\xdfw\\x1a?\\xee\\xabQ?\\x0f\\x1ab?\\x05\\x1f??^\\xedz?n\\xff\\xde>\\x18W\\xbd=ZT\\x92>\\xe1\\xba7?\\x86\\xd5\\xf6>g\\xee\\xa0>\\xa6R\\xbd=\\x1e\\x04\\x84>\\x07\\x9e\\xe6=\\xc3\\x03\"?\\xe2y\\x94>\\xf0u??~\\xafA>\\xfax\\x19?\\xc2=\\x01?/\\x812?\\xad\\xd2\\xd8<\\'\\x80\\xb1>\\x9c$\\xff<\\xe6\\x0b\\xca>S\\xa6\\xda>\\xe8_u?\\xa4O\\xd8>7t\\x1b=\\xcbA\\xd3>\\xa6\\xa9\\xee>\\xe7\\x82\\xfb>\\xad\\x86x?$\\xbcc?\\x83\\x9bI?\\xcf\\xe48?\\xb5\\x0fm?\\x7f\\xf75>$\\xa3G?\\'\\xee\\x0b>\\x17\\xc5\\x12>\\xbb\\x83Y?\\xfc\\x01 ?-\\x9en?U\\xe5$>\\x10\\t\\r?v\\x05Q?/*\\x1c>\\x06\\xa5t>KNR?\\x06\\xb8\\x16:`\"D?\\x9c\\x94\\x04?\\x1e\\xa2#?\\xfc\\x8b\\xe3>\\x91\\x1fN?\\x1c\\xd0\\x17?\\xd3{\\xe8>\\xe6,4?\\xe9\\x8fP?\\xf1r\\x83>\\x80\\x85\\x80>\\xa7u<?\\xac$\\xe1>\\xb2y\\x94>\\x88F\\x1f?)H\\xc7>\\x89]\\xf9>\\xf5\\x03\\x82>R\\x8c\\xd0>3\\xaf>?\\xc4&b?\\xab\\xfbW?\\xf8VL=J\\x81V?.\\xe1x>\\x7f\\x1ei?\\xb1\\x16k?\\xe5\\xe24> 5z=\\xfd\\xed\\x0f>\\nN\\xc9>\\xb4\\x84\\xfc>@\\x13k?\\xea\\x0b[=\\xf1.l?\\xdc\\xf9\"?\\nr/?\\xc1)=?B\\x14,?YD6?WK\\x0c?\\x05F\\xfa<c\\xe2\\xb2=\\x8f\\x0e\\x12>\\x9cW\\t?\\x8a\\x0c\\x1f?i=\\x15?nq\\x02;\\x9d\\xefj?^eA>0\\xc2=?O\\xca\\xf2=\\'\\xb9\\xf1=\\x96Y\\x1f>W\\x838?x\\x1a\\xe5>\\x02r\\x1f?\\xca\\x14\\x1a?\\x0e\\rU>\\nG\\xb1>\\xcdKP<\\x18\\x83\\x93=\\xdf\\x84\\x88>p\\x02\\xa6>\\xad\\xc3\\xe9<\\xe8\\x07_?\\x92U\\t?\\x1bs\\x00?\\xc0\\xb1\\xc6>\\xef\\xfc\\xca=k\"8>\\xb2,\\x00>\\xa6\\x1d7>\\x17\\xc1\\x05>l.N?\\xd3i\\xb3>\\xdd\\xc0\\x0b?\\xfdmn=H\\xf0\\xd3;ZN/?H\\x15\\xb4>L*n?Nq(?E+]?$\\x92\\x14?x\\x9b\\x1b?^`\\xbb=\\x0e\\xc8r?\\xb47<>\\xcdv\\x1d?\\xc3\\xda\\xe0>6P\\xd2>A\\x99\\xc4>0\\x85X?\\x86\\xe8%?t*\\xb1>\\xbf\\xb0\\xaa>N\\xb9\\xfd>\\x10d\\x92>\\xf7X\\x0e?\\x04\\x9c\\xb1>HM\\x16?\\xf8\\x1c\\x82>\\x01\\xb2\\xab=\\xa2\\xce\\x15>\\x9e\\xcdl?bb1?wz\\xf6<Y\\xd5d?x@\\x1d=\\xf9\\xed\\x10?\\xe2\\xbf\\xd6>\\xcc\\xfa\\xa4>]\\x86B?\\xb8\\x9aV>\\xe7\\xe86?\\x10\\x9f\\xea==P,?\\xc2T\\xc0>0p\\x1d>?}\\xd6>\\xd4\\x08\\xfd=\\xe5}\\x92>\\x98\\x95\\xd0>\\xf1\\x8f\\x0e>\\x07OV?\\xd8F\\xc9>\\xf0\\x95\\x10?\\xdc\\xf9i?\\x95\\xc8\\xb6<\\xa0%\\\\>\\x15\\x99??\\x1c\\x8a\\xfe>*<->\\xc0\\xf9\\xba=\\x17\\xa1\\xd0> O\\xff><\\xfd^?\\x1c\\xb9\\xbf>\\xbed\\x8f>\\x8c\\x14\\x7f>\\x12j\\xbc>30x?\\x8b~\\x85>\\xdez\\x17?m\\xd1_?\\xc0\\n\\xde>\\xecV\\x84=\\x0fj\\x84>\\xb8)\\xef<=n\\xe9>~\\x8e\\xf0>\\xee\\xc3z?\\x9a\\xa5-?\\x1d\\xea7?\\x14\\xec\\xc3>\\x1a|W>\\x00h\\x97>\\xc9\\xe0\\x89>t\\xdeH?\\xf4PN?\\x94X\\x13?\\xbd\\x10\\xa5>\\x7f\\xab6?\\xce\\xab\\x07?\\xceQr?/t\\x1d?H\\r\\xf2=\\x0bX\\xae<\\x11\\xb3\\x0f?\\xff\\xe7N?\\xf5\\xcf%?L\\xe8.?\\xf7A\\x19?\\x05\\x18%>/#\\x91=\\xd3A\\t?\\xbb\\xce\\x06?\\x1bS\\r>\\x13\\xd8.?(+\\x15?\\xf9\\x1e\\x01>\\xdf\\xf1\\x96>\\xe7\\x953?Y\\x1d>=\\xd9\\xf4\\x91>\\x16wA?\\x84V8?O\\x8b<=\\rd\\xbe>\\xf1\\xc2\\xcd>-\\x10:?\\x02>\\x96>VI\\xbc>n\\x9b\\x10?\\xbf\\x97\\x14?A\\x85\\xce>a\\xae\\x9e>U5%?d\\xda\\x01?\\xd5N\\xa2>\\xcd\\xe0\\xf6>:\\x9f\\x1d>V\"9?\\xa9\\\\\\x04?u2t:+$\\xfe>\\x18\\x00??-\\t\\xcd>\\xdd\\xe3W>\\xe1\\x8c*?\\xd0\\xa2\\x11>U\\xa0x>\\xf6Hk>\\xddwP=\\x85cg?\\x9d\\x18u?z\\xceb>4\\x11\\xd6=\\n \\xe9>W\\xff\\xcc>\\xb8\\x0b\\x95>\\xab\\xcd\\x0b?\\xcc\\xf5q?dI=?\\xb9\\xa5x?\\x92\\x02\\x1c?\\xabm\\xb4>N\\xa7%?A5\\xcc>;;u>>~\\xed=\\x8fp&?\\xa3K\\x8c=%r\\t?\\xb6ns?\\xa1\\x89H?\\x01=\\xc0>\\xce\\x1e\\xfd=\\x08\\xfc\\x91>\\x97D\\xa6>\\x01\\x9ae?w\\xe4\\x9f>\\xd8\\x14\\xb7<i#q?\\xd1\\xbd\\x05?\\x9a\\x00\\x13>d\\xac\\t?\\xd5i\\x8a>\\xdf\\xb4\\n?S\\xa0\\x1f?Pu1>J\\rd?\\x02\\xc8M>\\x97\\xb9E?\\x0f8c?\\xcc\\x14&?\\xd5\\xa6\\x95=\\r\\xdd\\x80>I\\x81G?\\x8eC~?h\\x07L?A?J?\\x15j\\x0f?\\xcat\\xf1>\\x8a.\\xcb>\\xee\\xacy?,Q\\xdf=\\xa4>\\xc2>-\\n\\x11?-z\\xf8=oV1>\\'\\xf9B?\\x86W\\xa2>\\x9f\\xd8a<\\xfd1\\x07?&\\xd1\\x16?\\x0c\\x17\\xe0>\\xbe\\tP>T@\\xeb=\\xfe:\\x97>\\x05o\\x83;\\x9d-\"?Ks\\xef>\\xde\\x8e\\x13?\\xc9\\xe7\\x98>[\\xdb=>\\xafs!?9\\xe7\\xae=\\\\\\xce\\t?F\\xec\\x93>\\xd4\\xe05>\\x9f\\xa5:>\\xefe\\xa3>Z\\x8e\\xfa>\\x12\\xc7\\xda<\\x91\\xbd\\xfb>E\\r\\xbd>37T?\\xf6\\xdc%?\\xc28\\x01=DB\\xc7>K\\x022?\\xb5\\xd3\\x8a>\\xb1\\xd3H?\\x1f\\xe2q?\\x1b\\x91k?\\xa5\\xb0$?\\xee\\xa6\\xa4>(\\xae\\xe6<\\']\\x18?\\xf5\\xce\\x95>\\xdc\\x06\\x1f?\\x06\\xa9\\xce=\\xe0u\\xbb>e\\xc1j>:\\xf4D?\\n\\xc6\\\\?\\x83\\xb7Q?\\xebT\\x15?%g0>?\\xa7s>C(@?\\x86GQ<`go?_\\x8dp?!B\\x8f>\\xd1\\x16\\xea>\\x03\\xed\\xbe>ni\\x13>ezA>\\xdf<\\x02<\\xda\\xe1x>\\x91\\xd6\\x81>\\x1c.k?\\xe6\\x8b\\xa7>\\xea<P?v\\xec<?\\xd8\\x12q?\\xe9\\x00\\xda=\\x1c\\xf8\\xce>f\\xa7\\x1f?}\\xf7a>\\xff\\x96q?\\xd2\\xf8\\xed>f\\xd0<?\\xcd\\x06\\xe8>B\\xb6\\xd9>0W6?\\xc2\\t\\x19?x\\x909?\\xc7\\x06\\xd6>Xa\\xae>\\n\\x12\\x06?_\\xacq?\\x9d\\x85L<8\\x8f\\xdf>\\x87\\xfcE?\\x89\\xbbT?\\x0fb{?<b\\x82=}\\xe8\\x04?\\xafA\\xab>a\\xf6\\x86;{\\xa6T?\\xca\\xb2\\xeb>\\xc8\\xa0\\xca>\\x08\\xa5q?\\xe4`\\x85>\\x7f}\\xb6=k\\xe6W?\\xd0\\xaf3>,\\x1e)=\\x02\\x0f7?\\xb8\\xd4r?\\xfa\\x0bD?\\xc5\\x8b@?\\x1dFQ?\\xdc\\xdd_?!\\xb0\\x06<\\x04v\\xbc>\\x12kN?\\xa7*\\xd7>\\x8ab\\xa2>q]N?\\x8b\\']=9\\xefF?\\xcd\\xc6\\t?\\xf3OO?\\xc48e>*vC>\\x80\\x9a\\xc3=\\x8d\\xa9J?L@j?\\x985\\xb3>\\xa0\\xd5\\xc9>\\x7f\\x04\\xc0>\\x94\\xeb\\x0f?F\\xa9\\x91>h\\xf3\\xed>\\x08\\xbe\\x1d>-\\xc79>\\x0b[R?\\xcc\\x17\\x06?\\xf5@\\xe3>5\\xc1_?\\xceF\\xb0>\\xf8\\x8d\\xb9>\\x10{3?\\xf5\\xce\\xee>\\x89\\xceu?:\\x14f?\\xb7\\xc6\\xf2=y\\xc5\\xa1>\\x13\\xd8t?6d\\xbc>X\\xd2\\xa4>\\xdb\\x1ez??\\x15\\\\?\\x9a2\\x1e?\\x8b\\x9eS>j\\x92\\xe0>\\xf3\\xcb\\xf3=\\x12\\xdb\\t?\\xb8\\xd8_>\\x8a\\x11A?\\x93\\xc3\\xdf=\\xb8\\x9bq?\\xe0\\x9a,?\\xd3\\xe6^>\\xb6\\xecQ?\\xba\\xa0\\x85>\\x95\\xcb\\x90=\\xc6\\x8b\\xba>\\xdd\\xafq?vj-?\\xdc\\xd0\\xe7=\\xa0\\x1f\\xca>v\\xce\\xb9=/\\xa9;?Y_\\xcc>\\x99\\x8e0?\\xf55.?+9\\\\>y|\\xba=\\xa4\\xe9\\x14?.%\\xb3>\\xde\\xd9\\x1e?w,\\x88>\\xad\\x86\\x94=\\xa0\\xd8)?\\x9f\\x1d\\xb2>\\xdbx\\xa9>U4\\x00?#\\xbcX?I\\xc3\\x8e='}]"
       ]
      },
      "execution_count": 5,
@@ -176,6 +176,7 @@
     "    Query(\"*=>[KNN 2 @vector $vec as score]\")\n",
     "     .sort_by(\"score\")\n",
     "     .return_fields(\"id\", \"score\")\n",
+    "     .return_field(\"vector\", decode_field=False) # return the vector field as bytes\n",
     "     .paging(0, 2)\n",
     "     .dialect(2)\n",
     ")\n",
diff --git a/redis/commands/search/_util.py b/redis/commands/search/_util.py
index dd1dff33dd..191600d7c6 100644
--- a/redis/commands/search/_util.py
+++ b/redis/commands/search/_util.py
@@ -1,7 +1,7 @@
-def to_string(s):
+def to_string(s, encoding: str = "utf-8"):
     if isinstance(s, str):
         return s
     elif isinstance(s, bytes):
-        return s.decode("utf-8", "ignore")
+        return s.decode(encoding, "ignore")
     else:
         return s  # Not a string we care about
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 764ad4c2b8..6a828c7e62 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -2,7 +2,7 @@
 import time
 from typing import Dict, List, Optional, Union
 
-from redis.client import Pipeline
+from redis.client import NEVER_DECODE, Pipeline
 from redis.utils import deprecated_function
 
 from ..helpers import get_protocol_version, parse_to_dict
@@ -82,6 +82,7 @@ def _parse_search(self, res, **kwargs):
             duration=kwargs["duration"],
             has_payload=kwargs["query"]._with_payloads,
             with_scores=kwargs["query"]._with_scores,
+            field_encodings=kwargs["query"]._return_fields_decode_as,
         )
 
     def _parse_aggregate(self, res, **kwargs):
@@ -499,7 +500,12 @@ def search(
         """  # noqa
         args, query = self._mk_query_args(query, query_params=query_params)
         st = time.time()
-        res = self.execute_command(SEARCH_CMD, *args)
+
+        options = {}
+        if get_protocol_version(self.client) not in ["3", 3]:
+            options[NEVER_DECODE] = True
+
+        res = self.execute_command(SEARCH_CMD, *args, **options)
 
         if isinstance(res, Pipeline):
             return res
@@ -926,7 +932,12 @@ async def search(
         """  # noqa
         args, query = self._mk_query_args(query, query_params=query_params)
         st = time.time()
-        res = await self.execute_command(SEARCH_CMD, *args)
+
+        options = {}
+        if get_protocol_version(self.client) not in ["3", 3]:
+            options[NEVER_DECODE] = True
+
+        res = await self.execute_command(SEARCH_CMD, *args, **options)
 
         if isinstance(res, Pipeline):
             return res
diff --git a/redis/commands/search/query.py b/redis/commands/search/query.py
index 113ddf9da8..84d60a7cec 100644
--- a/redis/commands/search/query.py
+++ b/redis/commands/search/query.py
@@ -35,6 +35,7 @@ def __init__(self, query_string: str) -> None:
         self._in_order: bool = False
         self._sortby: Optional[SortbyField] = None
         self._return_fields: List = []
+        self._return_fields_decode_as: dict = {}
         self._summarize_fields: List = []
         self._highlight_fields: List = []
         self._language: Optional[str] = None
@@ -53,13 +54,27 @@ def limit_ids(self, *ids) -> "Query":
 
     def return_fields(self, *fields) -> "Query":
         """Add fields to return fields."""
-        self._return_fields += fields
+        for field in fields:
+            self.return_field(field)
         return self
 
-    def return_field(self, field: str, as_field: Optional[str] = None) -> "Query":
-        """Add field to return fields (Optional: add 'AS' name
-        to the field)."""
+    def return_field(
+        self,
+        field: str,
+        as_field: Optional[str] = None,
+        decode_field: Optional[bool] = True,
+        encoding: Optional[str] = "utf8",
+    ) -> "Query":
+        """
+        Add a field to the list of fields to return.
+
+        - **field**: The field to include in query results
+        - **as_field**: The alias for the field
+        - **decode_field**: Whether to decode the field from bytes to string
+        - **encoding**: The encoding to use when decoding the field
+        """
         self._return_fields.append(field)
+        self._return_fields_decode_as[field] = encoding if decode_field else None
         if as_field is not None:
             self._return_fields += ("AS", as_field)
         return self
diff --git a/redis/commands/search/result.py b/redis/commands/search/result.py
index 5b19e6faa4..e2c7efb71f 100644
--- a/redis/commands/search/result.py
+++ b/redis/commands/search/result.py
@@ -1,3 +1,5 @@
+from typing import Optional
+
 from ._util import to_string
 from .document import Document
 
@@ -9,11 +11,19 @@ class Result:
     """
 
     def __init__(
-        self, res, hascontent, duration=0, has_payload=False, with_scores=False
+        self,
+        res,
+        hascontent,
+        duration=0,
+        has_payload=False,
+        with_scores=False,
+        field_encodings: Optional[dict] = None,
     ):
         """
-        - **snippets**: An optional dictionary of the form
-        {field: snippet_size} for snippet formatting
+        - duration: the execution time of the query
+        - has_payload: whether the query has payloads
+        - with_scores: whether the query has scores
+        - field_encodings: a dictionary of field encodings if any is provided
         """
 
         self.total = res[0]
@@ -39,18 +49,22 @@ def __init__(
 
             fields = {}
             if hascontent and res[i + fields_offset] is not None:
-                fields = (
-                    dict(
-                        dict(
-                            zip(
-                                map(to_string, res[i + fields_offset][::2]),
-                                map(to_string, res[i + fields_offset][1::2]),
-                            )
-                        )
-                    )
-                    if hascontent
-                    else {}
-                )
+                keys = map(to_string, res[i + fields_offset][::2])
+                values = res[i + fields_offset][1::2]
+
+                for key, value in zip(keys, values):
+                    if field_encodings is None or key not in field_encodings:
+                        fields[key] = to_string(value)
+                        continue
+
+                    encoding = field_encodings[key]
+
+                    # If the encoding is None, we don't need to decode the value
+                    if encoding is None:
+                        fields[key] = value
+                    else:
+                        fields[key] = to_string(value, encoding=encoding)
+
             try:
                 del fields["id"]
             except KeyError:
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 4cc00c8e5f..4d13cb4a38 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -4,6 +4,7 @@
 import time
 from io import TextIOWrapper
 
+import numpy as np
 import pytest
 import pytest_asyncio
 import redis.asyncio as redis
@@ -11,8 +12,14 @@
 import redis.commands.search.aggregation as aggregations
 import redis.commands.search.reducers as reducers
 from redis.commands.search import AsyncSearch
-from redis.commands.search.field import GeoField, NumericField, TagField, TextField
-from redis.commands.search.indexDefinition import IndexDefinition
+from redis.commands.search.field import (
+    GeoField,
+    NumericField,
+    TagField,
+    TextField,
+    VectorField,
+)
+from redis.commands.search.indexDefinition import IndexDefinition, IndexType
 from redis.commands.search.query import GeoFilter, NumericFilter, Query
 from redis.commands.search.result import Result
 from redis.commands.search.suggestion import Suggestion
@@ -20,6 +27,7 @@
     assert_resp_response,
     is_resp2_connection,
     skip_if_redis_enterprise,
+    skip_if_resp_version,
     skip_ifmodversion_lt,
 )
 
@@ -1560,3 +1568,53 @@ async def test_query_timeout(decoded_r: redis.Redis):
     q2 = Query("foo").timeout("not_a_number")
     with pytest.raises(redis.ResponseError):
         await decoded_r.ft().search(q2)
+
+
+@pytest.mark.redismod
+@skip_if_resp_version(3)
+async def test_binary_and_text_fields(decoded_r: redis.Redis):
+    fake_vec = np.array([0.1, 0.2, 0.3, 0.4], dtype=np.float32)
+
+    index_name = "mixed_index"
+    mixed_data = {"first_name": "🐍python", "vector_emb": fake_vec.tobytes()}
+    await decoded_r.hset(f"{index_name}:1", mapping=mixed_data)
+
+    schema = (
+        TagField("first_name"),
+        VectorField(
+            "embeddings_bio",
+            algorithm="HNSW",
+            attributes={
+                "TYPE": "FLOAT32",
+                "DIM": 4,
+                "DISTANCE_METRIC": "COSINE",
+            },
+        ),
+    )
+
+    await decoded_r.ft(index_name).create_index(
+        fields=schema,
+        definition=IndexDefinition(
+            prefix=[f"{index_name}:"], index_type=IndexType.HASH
+        ),
+    )
+
+    query = (
+        Query("*")
+        .return_field("vector_emb", decode_field=False)
+        .return_field("first_name")
+    )
+    result = await decoded_r.ft(index_name).search(query=query, query_params={})
+    docs = result.docs
+
+    decoded_vec_from_search_results = np.frombuffer(
+        docs[0]["vector_emb"], dtype=np.float32
+    )
+
+    assert np.array_equal(
+        decoded_vec_from_search_results, fake_vec
+    ), "The vectors are not equal"
+
+    assert (
+        docs[0]["first_name"] == mixed_data["first_name"]
+    ), "The text field is not decoded correctly"
diff --git a/tests/test_search.py b/tests/test_search.py
index a61f361c3a..493171a035 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -4,6 +4,7 @@
 import time
 from io import TextIOWrapper
 
+import numpy as np
 import pytest
 import redis
 import redis.commands.search
@@ -29,6 +30,7 @@
     assert_resp_response,
     is_resp2_connection,
     skip_if_redis_enterprise,
+    skip_if_resp_version,
     skip_ifmodversion_lt,
 )
 
@@ -1705,6 +1707,54 @@ def test_search_return_fields(client):
         assert "telmatosaurus" == total["results"][0]["extra_attributes"]["txt"]
 
 
+@pytest.mark.redismod
+@skip_if_resp_version(3)
+def test_binary_and_text_fields(client):
+    fake_vec = np.array([0.1, 0.2, 0.3, 0.4], dtype=np.float32)
+
+    index_name = "mixed_index"
+    mixed_data = {"first_name": "🐍python", "vector_emb": fake_vec.tobytes()}
+    client.hset(f"{index_name}:1", mapping=mixed_data)
+
+    schema = (
+        TagField("first_name"),
+        VectorField(
+            "embeddings_bio",
+            algorithm="HNSW",
+            attributes={
+                "TYPE": "FLOAT32",
+                "DIM": 4,
+                "DISTANCE_METRIC": "COSINE",
+            },
+        ),
+    )
+
+    client.ft(index_name).create_index(
+        fields=schema,
+        definition=IndexDefinition(
+            prefix=[f"{index_name}:"], index_type=IndexType.HASH
+        ),
+    )
+
+    query = (
+        Query("*")
+        .return_field("vector_emb", decode_field=False)
+        .return_field("first_name")
+    )
+    docs = client.ft(index_name).search(query=query, query_params={}).docs
+    decoded_vec_from_search_results = np.frombuffer(
+        docs[0]["vector_emb"], dtype=np.float32
+    )
+
+    assert np.array_equal(
+        decoded_vec_from_search_results, fake_vec
+    ), "The vectors are not equal"
+
+    assert (
+        docs[0]["first_name"] == mixed_data["first_name"]
+    ), "The text field is not decoded correctly"
+
+
 @pytest.mark.redismod
 def test_synupdate(client):
     definition = IndexDefinition(index_type=IndexType.HASH)

From d1b4191f7a7918a39c1cb46e9e816389c3996233 Mon Sep 17 00:00:00 2001
From: Chayim <chayim@users.noreply.github.com>
Date: Thu, 11 Jul 2024 13:34:50 +0300
Subject: [PATCH 0909/1164] Add support for Python 3.12 (#2979)

Add support for Python 3.12. This required a bunch of changes all
over the place, listed below in a random order.

Fix tests, especially around SSL connections.

Stop requiring typing-extensions.

Enable tracemalloc for tests, and add the possibility to run the tests
with profiling enabled. Fix some issues identified by tracemalloc, like
sockets not being closed in case of SSL handshake failures.

Remove the CI test reporting plugin, it does not work easily with forked
repos anyway.

Fix checking of module versions, make the comparison accurate. Not
sure how it worked before, but it looks like it did not match exactly
the format in the server INFO response, i.e. MMmmPP.

Remove loggers from tests, it's just noise in the output. If we don't use
asserts, nobody will check the log output from CI.

Speed up the computation for slots when initializing a cluster. After
profiling, this turned out to be very slow, when it does not have to be.
It does not make sense to recompute the same thing over and over
in a loop.

Run uvloop tests in matrix, i.e. don't bundle two tests executions
(without uvloop and with it) in the same job. Easier to spot failures
like this, and arguably the jobs can be scheduled in parallel so the
overall execution is faster.

Unlock urllib version, to be able to use more recent pytest versions.

---------

Co-authored-by: Gabriel Erzse <gabriel.erzse@redis.com>
---
 .flake8                              |  1 +
 .github/workflows/integration.yaml   | 89 +++++++++++++---------------
 .gitignore                           |  2 +
 dev_requirements.txt                 |  6 +-
 redis/asyncio/cluster.py             | 40 ++++++-------
 redis/asyncio/connection.py          |  2 +-
 redis/cluster.py                     | 35 +++++------
 redis/commands/graph/query_result.py | 17 +++++-
 redis/connection.py                  | 22 ++++++-
 requirements.txt                     |  2 +-
 setup.py                             |  3 +-
 tasks.py                             | 24 ++++----
 tests/conftest.py                    | 19 +++++-
 tests/test_asyncio/test_cluster.py   | 13 ++--
 tests/test_asyncio/test_connect.py   | 34 ++++-------
 tests/test_asyncio/test_cwe_404.py   |  2 +-
 tests/test_asyncio/test_lock.py      |  6 +-
 tests/test_asyncio/test_search.py    |  4 +-
 tests/test_connect.py                | 38 +++++-------
 19 files changed, 194 insertions(+), 165 deletions(-)

diff --git a/.flake8 b/.flake8
index d2ee181447..b1bd1d0b75 100644
--- a/.flake8
+++ b/.flake8
@@ -16,6 +16,7 @@ exclude =
 ignore =
     E126
     E203
+    E231
     E701
     E704
     F405
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index a619275b47..94fe8f35b6 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -25,6 +25,8 @@ permissions:
 
 env:
   CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+  # this speeds up coverage with Python 3.12: https://github.com/nedbat/coveragepy/issues/1665
+  COVERAGE_CORE: sysmon
   REDIS_IMAGE: redis:7.4-rc2
   REDIS_STACK_IMAGE: redis/redis-stack-server:7.4.0-rc2
 
@@ -54,26 +56,28 @@ jobs:
           pip install -r dev_requirements.txt
           invoke linters
 
-  run-tests:
+  resp2-tests:
     runs-on: ubuntu-latest
     timeout-minutes: 60
     strategy:
       max-parallel: 15
       fail-fast: false
       matrix:
-        python-version: ['3.8', '3.9', '3.10', '3.11', 'pypy-3.8', 'pypy-3.9']
+        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12', 'pypy-3.8', 'pypy-3.9']
         test-type: ['standalone', 'cluster']
         connection-type: ['hiredis', 'plain']
     env:
       ACTIONS_ALLOW_UNSECURE_COMMANDS: true
-    name: Python ${{ matrix.python-version }} ${{matrix.test-type}}-${{matrix.connection-type}} tests
+    name: RESP2 ${{ matrix.python-version }} ${{matrix.test-type}}-${{matrix.connection-type}}
     steps:
       - uses: actions/checkout@v4
+
       - uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
           cache: 'pip'
-      - name: run tests
+
+      - name: Run tests
         run: |
           pip install -U setuptools wheel
           pip install -r requirements.txt
@@ -84,52 +88,48 @@ jobs:
           invoke devenv
           sleep 10 # time to settle
           invoke ${{matrix.test-type}}-tests
+          ls -1
 
-      - uses: actions/upload-artifact@v4
-        if: success() || failure()
+      - name: Upload test results and profiling data
+        uses: actions/upload-artifact@v4
         with:
           name: pytest-results-${{matrix.test-type}}-${{matrix.connection-type}}-${{matrix.python-version}}
-          path: '${{matrix.test-type}}*results.xml'
+          path: |
+            ${{matrix.test-type}}*-results.xml
+            prof/**
+            profile_output*
+          if-no-files-found: error
+          retention-days: 10
 
       - name: Upload codecov coverage
         uses: codecov/codecov-action@v4
         with:
           fail_ci_if_error: false
 
-      - name: View Test Results
-        uses: dorny/test-reporter@v1
-        if: success() || failure()
-        continue-on-error: true
-        with:
-          name: Test Results ${{matrix.python-version}} ${{matrix.test-type}}-${{matrix.connection-type}}
-          path: '*.xml'
-          reporter: java-junit
-          list-suites: all
-          list-tests: all
-          max-annotations: 10
-          fail-on-error: 'false'
-
-  resp3_tests:
+  resp3-tests:
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        python-version: ['3.8', '3.11']
+        python-version: ['3.8', '3.12']
         test-type: ['standalone', 'cluster']
         connection-type: ['hiredis', 'plain']
+        event-loop: ['asyncio', 'uvloop']
         exclude:
           - test-type: 'cluster'
             connection-type: 'hiredis'
     env:
       ACTIONS_ALLOW_UNSECURE_COMMANDS: true
-    name: RESP3 [${{ matrix.python-version }} ${{matrix.test-type}}-${{matrix.connection-type}}]
+    name: RESP3 ${{ matrix.python-version }} ${{matrix.test-type}}-${{matrix.connection-type}}-${{matrix.event-loop}}
     steps:
       - uses: actions/checkout@v4
+
       - uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
           cache: 'pip'
-      - name: run tests
+
+      - name: Run tests
         run: |
           pip install -U setuptools wheel
           pip install -r requirements.txt
@@ -139,37 +139,32 @@ jobs:
           fi
           invoke devenv
           sleep 10 # time to settle
-          invoke ${{matrix.test-type}}-tests --protocol=3
-          invoke ${{matrix.test-type}}-tests --uvloop --protocol=3
+          if [ "${{matrix.event-loop}}" == "uvloop" ]; then
+            invoke ${{matrix.test-type}}-tests --uvloop --protocol=3
+          else
+            invoke ${{matrix.test-type}}-tests --protocol=3
+          fi
 
-      - uses: actions/upload-artifact@v4
-        if: success() || failure()
+      - name: Upload test results and profiling data
+        uses: actions/upload-artifact@v4
         with:
-          name: pytest-results-${{matrix.test-type}}-${{matrix.connection-type}}-${{matrix.python-version}}-resp3
-          path: '${{matrix.test-type}}*results.xml'
+          name: pytest-results-${{matrix.test-type}}-${{matrix.connection-type}}-${{matrix.python-version}}-${{matrix.event-loop}}-resp3
+          path: |
+            ${{matrix.test-type}}*-results.xml
+            prof/**
+            profile_output*
+          if-no-files-found: error
+          retention-days: 10
 
       - name: Upload codecov coverage
         uses: codecov/codecov-action@v4
         with:
           fail_ci_if_error: false
 
-      - name: View Test Results
-        uses: dorny/test-reporter@v1
-        if: success() || failure()
-        continue-on-error: true
-        with:
-          name: Test Results ${{matrix.python-version}} ${{matrix.test-type}}-${{matrix.connection-type}}-resp3
-          path: '*.xml'
-          reporter: java-junit
-          list-suites: all
-          list-tests: all
-          max-annotations: 10
-          fail-on-error: 'false'
-
-  build_and_test_package:
+  build-and-test-package:
     name: Validate building and installing the package
     runs-on: ubuntu-latest
-    needs: [run-tests]
+    needs: [resp2-tests, resp3-tests]
     strategy:
       fail-fast: false
       matrix:
@@ -183,13 +178,13 @@ jobs:
         run: |
           bash .github/workflows/install_and_test.sh ${{ matrix.extension }}
 
-  install_package_from_commit:
+  install-package-from-commit:
     name: Install package from commit hash
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        python-version: ['3.8', '3.9', '3.10', '3.11', 'pypy-3.8', 'pypy-3.9']
+        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12', 'pypy-3.8', 'pypy-3.9']
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
diff --git a/.gitignore b/.gitignore
index 3baa34034f..c6a4efd1ec 100644
--- a/.gitignore
+++ b/.gitignore
@@ -16,4 +16,6 @@ coverage.xml
 .venv*
 *.xml
 .coverage*
+prof
+profile_output*
 docker/stunnel/keys
diff --git a/dev_requirements.txt b/dev_requirements.txt
index c008b69b1d..e9d5738b69 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -4,15 +4,15 @@ click==8.0.4
 flake8-isort==6.0.0
 flake8==5.0.4
 flynt~=0.69.0
-invoke==1.7.3
-mock==4.0.3
+invoke==2.2.0
+mock
 packaging>=20.4
 pytest
 pytest-asyncio
 pytest-cov
+pytest-profiling
 pytest-timeout
 ujson>=4.2.0
-urllib3<2
 uvloop
 vulture>=2.3.0
 wheel>=0.30.0
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 719c2d2283..40b2948a7f 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -1317,6 +1317,8 @@ async def initialize(self) -> None:
                 port = int(primary_node[1])
                 host, port = self.remap_host_port(host, port)
 
+                nodes_for_slot = []
+
                 target_node = tmp_nodes_cache.get(get_node_name(host, port))
                 if not target_node:
                     target_node = ClusterNode(
@@ -1324,30 +1326,26 @@ async def initialize(self) -> None:
                     )
                 # add this node to the nodes cache
                 tmp_nodes_cache[target_node.name] = target_node
+                nodes_for_slot.append(target_node)
+
+                replica_nodes = slot[3:]
+                for replica_node in replica_nodes:
+                    host = replica_node[0]
+                    port = replica_node[1]
+                    host, port = self.remap_host_port(host, port)
+
+                    target_replica_node = tmp_nodes_cache.get(get_node_name(host, port))
+                    if not target_replica_node:
+                        target_replica_node = ClusterNode(
+                            host, port, REPLICA, **self.connection_kwargs
+                        )
+                    # add this node to the nodes cache
+                    tmp_nodes_cache[target_replica_node.name] = target_replica_node
+                    nodes_for_slot.append(target_replica_node)
 
                 for i in range(int(slot[0]), int(slot[1]) + 1):
                     if i not in tmp_slots:
-                        tmp_slots[i] = []
-                        tmp_slots[i].append(target_node)
-                        replica_nodes = [slot[j] for j in range(3, len(slot))]
-
-                        for replica_node in replica_nodes:
-                            host = replica_node[0]
-                            port = replica_node[1]
-                            host, port = self.remap_host_port(host, port)
-
-                            target_replica_node = tmp_nodes_cache.get(
-                                get_node_name(host, port)
-                            )
-                            if not target_replica_node:
-                                target_replica_node = ClusterNode(
-                                    host, port, REPLICA, **self.connection_kwargs
-                                )
-                            tmp_slots[i].append(target_replica_node)
-                            # add this node to the nodes cache
-                            tmp_nodes_cache[target_replica_node.name] = (
-                                target_replica_node
-                            )
+                        tmp_slots[i] = nodes_for_slot
                     else:
                         # Validate that 2 nodes want to use the same slot cache
                         # setup
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index ec1ce5a915..2ac6637986 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -1000,7 +1000,7 @@ def parse_url(url: str) -> ConnectKwargs:
                 try:
                     kwargs[name] = parser(value)
                 except (TypeError, ValueError):
-                    raise ValueError(f"Invalid value for `{name}` in connection URL.")
+                    raise ValueError(f"Invalid value for '{name}' in connection URL.")
             else:
                 kwargs[name] = value
 
diff --git a/redis/cluster.py b/redis/cluster.py
index 144844ec8a..be7685e9a1 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -1522,6 +1522,8 @@ def _get_or_create_cluster_node(self, host, port, role, tmp_nodes_cache):
                 target_node = ClusterNode(host, port, role)
             if target_node.server_type != role:
                 target_node.server_type = role
+            # add this node to the nodes cache
+            tmp_nodes_cache[target_node.name] = target_node
 
         return target_node
 
@@ -1585,31 +1587,26 @@ def initialize(self):
                 port = int(primary_node[1])
                 host, port = self.remap_host_port(host, port)
 
+                nodes_for_slot = []
+
                 target_node = self._get_or_create_cluster_node(
                     host, port, PRIMARY, tmp_nodes_cache
                 )
-                # add this node to the nodes cache
-                tmp_nodes_cache[target_node.name] = target_node
+                nodes_for_slot.append(target_node)
+
+                replica_nodes = slot[3:]
+                for replica_node in replica_nodes:
+                    host = str_if_bytes(replica_node[0])
+                    port = int(replica_node[1])
+                    host, port = self.remap_host_port(host, port)
+                    target_replica_node = self._get_or_create_cluster_node(
+                        host, port, REPLICA, tmp_nodes_cache
+                    )
+                    nodes_for_slot.append(target_replica_node)
 
                 for i in range(int(slot[0]), int(slot[1]) + 1):
                     if i not in tmp_slots:
-                        tmp_slots[i] = []
-                        tmp_slots[i].append(target_node)
-                        replica_nodes = [slot[j] for j in range(3, len(slot))]
-
-                        for replica_node in replica_nodes:
-                            host = str_if_bytes(replica_node[0])
-                            port = replica_node[1]
-                            host, port = self.remap_host_port(host, port)
-
-                            target_replica_node = self._get_or_create_cluster_node(
-                                host, port, REPLICA, tmp_nodes_cache
-                            )
-                            tmp_slots[i].append(target_replica_node)
-                            # add this node to the nodes cache
-                            tmp_nodes_cache[target_replica_node.name] = (
-                                target_replica_node
-                            )
+                        tmp_slots[i] = nodes_for_slot
                     else:
                         # Validate that 2 nodes want to use the same slot cache
                         # setup
diff --git a/redis/commands/graph/query_result.py b/redis/commands/graph/query_result.py
index 7c7f58b99f..7709081bcf 100644
--- a/redis/commands/graph/query_result.py
+++ b/redis/commands/graph/query_result.py
@@ -1,6 +1,5 @@
 import sys
 from collections import OrderedDict
-from distutils.util import strtobool
 
 # from prettytable import PrettyTable
 from redis import ResponseError
@@ -571,3 +570,19 @@ async def parse_array(self, value):
         """
         scalar = [await self.parse_scalar(value[i]) for i in range(len(value))]
         return scalar
+
+
+def strtobool(val):
+    """
+    Convert a string representation of truth to true (1) or false (0).
+    True values are 'y', 'yes', 't', 'true', 'on', and '1'; false values
+    are 'n', 'no', 'f', 'false', 'off', and '0'.  Raises ValueError if
+    'val' is anything else.
+    """
+    val = val.lower()
+    if val in ("y", "yes", "t", "true", "on", "1"):
+        return True
+    elif val in ("n", "no", "f", "false", "off", "0"):
+        return False
+    else:
+        raise ValueError(f"invalid truth value {val!r}")
diff --git a/redis/connection.py b/redis/connection.py
index 6e3b3ab081..19263376d2 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -813,8 +813,26 @@ def __init__(
         super().__init__(**kwargs)
 
     def _connect(self):
-        "Wrap the socket with SSL support"
+        """
+        Wrap the socket with SSL support, handling potential errors.
+        """
         sock = super()._connect()
+        try:
+            return self._wrap_socket_with_ssl(sock)
+        except OSError:
+            sock.close()
+            raise
+
+    def _wrap_socket_with_ssl(self, sock):
+        """
+        Wraps the socket with SSL support.
+
+        Args:
+            sock: The plain socket to wrap with SSL.
+
+        Returns:
+            An SSL wrapped socket.
+        """
         context = ssl.create_default_context()
         context.check_hostname = self.check_hostname
         context.verify_mode = self.cert_reqs
@@ -957,7 +975,7 @@ def parse_url(url):
                 try:
                     kwargs[name] = parser(value)
                 except (TypeError, ValueError):
-                    raise ValueError(f"Invalid value for `{name}` in connection URL.")
+                    raise ValueError(f"Invalid value for '{name}' in connection URL.")
             else:
                 kwargs[name] = value
 
diff --git a/requirements.txt b/requirements.txt
index a716b84463..3274a80f62 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1 +1 @@
-async-timeout>=4.0.2
+async-timeout>=4.0.3
diff --git a/setup.py b/setup.py
index ab1cb9631f..39cd40b807 100644
--- a/setup.py
+++ b/setup.py
@@ -51,11 +51,12 @@
         "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
         "Programming Language :: Python :: Implementation :: CPython",
         "Programming Language :: Python :: Implementation :: PyPy",
     ],
     extras_require={
         "hiredis": ["hiredis>=1.0.0"],
-        "ocsp": ["cryptography>=36.0.1", "pyopenssl==20.0.1", "requests>=2.26.0"],
+        "ocsp": ["cryptography>=36.0.1", "pyopenssl==23.2.1", "requests>=2.31.0"],
     },
 )
diff --git a/tasks.py b/tasks.py
index 7f26081150..79b27852e3 100644
--- a/tasks.py
+++ b/tasks.py
@@ -42,39 +42,39 @@ def all_tests(c):
 
 
 @task
-def tests(c, uvloop=False, protocol=2):
-    """Run the redis-py test suite against the current python,
-    with and without hiredis.
-    """
+def tests(c, uvloop=False, protocol=2, profile=False):
+    """Run the redis-py test suite against the current python."""
     print("Starting Redis tests")
-    standalone_tests(c, uvloop=uvloop, protocol=protocol)
-    cluster_tests(c, uvloop=uvloop, protocol=protocol)
+    standalone_tests(c, uvloop=uvloop, protocol=protocol, profile=profile)
+    cluster_tests(c, uvloop=uvloop, protocol=protocol, profile=profile)
 
 
 @task
-def standalone_tests(c, uvloop=False, protocol=2):
+def standalone_tests(c, uvloop=False, protocol=2, profile=False):
     """Run tests against a standalone redis instance"""
+    profile_arg = "--profile" if profile else ""
     if uvloop:
         run(
-            f"pytest --protocol={protocol} --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' --uvloop --junit-xml=standalone-uvloop-results.xml"
+            f"pytest {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' --uvloop --junit-xml=standalone-uvloop-results.xml"
         )
     else:
         run(
-            f"pytest --protocol={protocol} --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' --junit-xml=standalone-results.xml"
+            f"pytest {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' --junit-xml=standalone-results.xml"
         )
 
 
 @task
-def cluster_tests(c, uvloop=False, protocol=2):
+def cluster_tests(c, uvloop=False, protocol=2, profile=False):
     """Run tests against a redis cluster"""
+    profile_arg = "--profile" if profile else ""
     cluster_url = "redis://localhost:16379/0"
     if uvloop:
         run(
-            f"pytest --protocol={protocol} --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --junit-xml=cluster-uvloop-results.xml --uvloop"
+            f"pytest {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --junit-xml=cluster-uvloop-results.xml --uvloop"
         )
     else:
         run(
-            f"pytest --protocol={protocol} --cov=./ --cov-report=xml:coverage_clusteclient.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --junit-xml=cluster-results.xml"
+            f"pytest  {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_clusteclient.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --junit-xml=cluster-results.xml"
         )
 
 
diff --git a/tests/conftest.py b/tests/conftest.py
index e3326f85d5..dd78bb6a2c 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -72,6 +72,21 @@ def format_usage(self):
         return " | ".join(self.option_strings)
 
 
+@pytest.fixture(scope="session", autouse=True)
+def enable_tracemalloc():
+    """
+    Enable tracemalloc while tests are being executed.
+    """
+    try:
+        import tracemalloc
+
+        tracemalloc.start()
+        yield
+        tracemalloc.stop()
+    except ImportError:
+        yield
+
+
 def pytest_addoption(parser):
     parser.addoption(
         "--redis-url",
@@ -246,7 +261,9 @@ def skip_ifmodversion_lt(min_version: str, module_name: str):
     for j in modules:
         if module_name == j.get("name"):
             version = j.get("ver")
-            mv = int(min_version.replace(".", ""))
+            mv = int(
+                "".join(["%02d" % int(segment) for segment in min_version.split(".")])
+            )
             check = version < mv
             return pytest.mark.skipif(check, reason="Redis module version")
 
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 80b0b1bff8..a36040f11b 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -58,7 +58,6 @@ class NodeProxy:
     def __init__(self, addr, redis_addr):
         self.addr = addr
         self.redis_addr = redis_addr
-        self.send_event = asyncio.Event()
         self.server = None
         self.task = None
         self.n_connections = 0
@@ -83,14 +82,20 @@ async def handle(self, reader, writer):
             await asyncio.gather(pipe1, pipe2)
         finally:
             redis_writer.close()
+            await self.redis_writer.wait_closed()
+            writer.close()
+            await writer.wait_closed()
 
     async def aclose(self):
-        self.task.cancel()
         try:
-            await self.task
+            self.task.cancel()
+            await asyncio.wait_for(self.task, timeout=1)
+            self.server.close()
+            await self.server.wait_closed()
+        except asyncio.TimeoutError:
+            pass
         except asyncio.CancelledError:
             pass
-        await self.server.wait_closed()
 
     async def pipe(
         self,
diff --git a/tests/test_asyncio/test_connect.py b/tests/test_asyncio/test_connect.py
index 0df7ebb43a..943540c885 100644
--- a/tests/test_asyncio/test_connect.py
+++ b/tests/test_asyncio/test_connect.py
@@ -1,5 +1,4 @@
 import asyncio
-import logging
 import re
 import socket
 import ssl
@@ -14,9 +13,6 @@
 
 from ..ssl_utils import get_ssl_filename
 
-_logger = logging.getLogger(__name__)
-
-
 _CLIENT_NAME = "test-suite-client"
 _CMD_SEP = b"\r\n"
 _SUCCESS_RESP = b"+OK" + _CMD_SEP
@@ -125,7 +121,7 @@ async def test_tcp_ssl_version_mismatch(tcp_address):
             tcp_address,
             certfile=certfile,
             keyfile=keyfile,
-            ssl_version=ssl.TLSVersion.TLSv1_2,
+            maximum_ssl_version=ssl.TLSVersion.TLSv1_2,
         )
     await conn.disconnect()
 
@@ -135,7 +131,8 @@ async def _assert_connect(
     server_address,
     certfile=None,
     keyfile=None,
-    ssl_version=None,
+    minimum_ssl_version=ssl.TLSVersion.TLSv1_2,
+    maximum_ssl_version=ssl.TLSVersion.TLSv1_3,
 ):
     stop_event = asyncio.Event()
     finished = asyncio.Event()
@@ -153,9 +150,8 @@ async def _handler(reader, writer):
     elif certfile:
         host, port = server_address
         context = ssl.create_default_context(ssl.Purpose.CLIENT_AUTH)
-        if ssl_version is not None:
-            context.minimum_version = ssl_version
-            context.maximum_version = ssl_version
+        context.minimum_version = minimum_ssl_version
+        context.maximum_version = maximum_ssl_version
         context.load_cert_chain(certfile=certfile, keyfile=keyfile)
         server = await asyncio.start_server(_handler, host=host, port=port, ssl=context)
     else:
@@ -178,23 +174,18 @@ async def _handler(reader, writer):
 
 
 async def _redis_request_handler(reader, writer, stop_event):
-    buffer = b""
     command = None
     command_ptr = None
     fragment_length = None
-    while not stop_event.is_set() or buffer:
-        _logger.info(str(stop_event.is_set()))
-        try:
-            buffer += await asyncio.wait_for(reader.read(1024), timeout=0.5)
-        except TimeoutError:
-            continue
+    while not stop_event.is_set():
+        buffer = await reader.read(1024)
         if not buffer:
-            continue
+            break
         parts = re.split(_CMD_SEP, buffer)
-        buffer = parts[-1]
-        for fragment in parts[:-1]:
+        for fragment in parts:
             fragment = fragment.decode()
-            _logger.info("Command fragment: %s", fragment)
+            if not fragment:
+                continue
 
             if fragment.startswith("*") and command is None:
                 command = [None for _ in range(int(fragment[1:]))]
@@ -214,10 +205,7 @@ async def _redis_request_handler(reader, writer, stop_event):
                 continue
 
             command = " ".join(command)
-            _logger.info("Command %s", command)
             resp = _SUPPORTED_CMDS.get(command, _ERROR_RESP)
-            _logger.info("Response from %s", resp)
             writer.write(resp)
             await writer.drain()
             command = None
-    _logger.info("Exit handler")
diff --git a/tests/test_asyncio/test_cwe_404.py b/tests/test_asyncio/test_cwe_404.py
index df46cabc43..e920a3fb98 100644
--- a/tests/test_asyncio/test_cwe_404.py
+++ b/tests/test_asyncio/test_cwe_404.py
@@ -261,4 +261,4 @@ async def doit():
 
             await asyncio.gather(*[doit() for _ in range(10)])
         finally:
-            await r.close()
+            await r.aclose()
diff --git a/tests/test_asyncio/test_lock.py b/tests/test_asyncio/test_lock.py
index c052eae2a0..9eaaed6920 100644
--- a/tests/test_asyncio/test_lock.py
+++ b/tests/test_asyncio/test_lock.py
@@ -104,16 +104,16 @@ async def test_blocking(self, r):
         lock_2 = self.get_lock(r, "foo")
         assert lock_2.blocking
 
-    async def test_blocking_timeout(self, r, event_loop):
+    async def test_blocking_timeout(self, r):
         lock1 = self.get_lock(r, "foo")
         assert await lock1.acquire(blocking=False)
         bt = 0.2
         sleep = 0.05
         lock2 = self.get_lock(r, "foo", sleep=sleep, blocking_timeout=bt)
-        start = event_loop.time()
+        start = asyncio.get_running_loop().time()
         assert not await lock2.acquire()
         # The elapsed duration should be less than the total blocking_timeout
-        assert bt >= (event_loop.time() - start) > bt - sleep
+        assert bt >= (asyncio.get_running_loop().time() - start) > bt - sleep
         await lock1.release()
 
     async def test_context_manager(self, r):
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 4d13cb4a38..47d34f9c07 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -1519,14 +1519,14 @@ async def test_withsuffixtrie(decoded_r: redis.Redis):
 
         # create withsuffixtrie index (text fields)
         assert await decoded_r.ft().create_index(TextField("t", withsuffixtrie=True))
-        waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
+        await waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
         info = await decoded_r.ft().info()
         assert "WITHSUFFIXTRIE" in info["attributes"][0]["flags"]
         assert await decoded_r.ft().dropindex("idx")
 
         # create withsuffixtrie index (tag field)
         assert await decoded_r.ft().create_index(TagField("t", withsuffixtrie=True))
-        waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
+        await waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
         info = await decoded_r.ft().info()
         assert "WITHSUFFIXTRIE" in info["attributes"][0]["flags"]
 
diff --git a/tests/test_connect.py b/tests/test_connect.py
index d7ca04b651..b11c4446e5 100644
--- a/tests/test_connect.py
+++ b/tests/test_connect.py
@@ -1,4 +1,3 @@
-import logging
 import re
 import socket
 import socketserver
@@ -7,13 +6,10 @@
 
 import pytest
 from redis.connection import Connection, SSLConnection, UnixDomainSocketConnection
-from redis.exceptions import ConnectionError
+from redis.exceptions import RedisError
 
 from .ssl_utils import get_ssl_filename
 
-_logger = logging.getLogger(__name__)
-
-
 _CLIENT_NAME = "test-suite-client"
 _CMD_SEP = b"\r\n"
 _SUCCESS_RESP = b"+OK" + _CMD_SEP
@@ -126,16 +122,16 @@ def test_tcp_ssl_version_mismatch(tcp_address):
         port=port,
         client_name=_CLIENT_NAME,
         ssl_ca_certs=certfile,
-        socket_timeout=10,
+        socket_timeout=3,
         ssl_min_version=ssl.TLSVersion.TLSv1_3,
     )
-    with pytest.raises(ConnectionError):
+    with pytest.raises(RedisError):
         _assert_connect(
             conn,
             tcp_address,
             certfile=certfile,
             keyfile=keyfile,
-            ssl_version=ssl.PROTOCOL_TLSv1_2,
+            maximum_ssl_version=ssl.TLSVersion.TLSv1_2,
         )
 
 
@@ -164,14 +160,16 @@ def __init__(
         *args,
         certfile=None,
         keyfile=None,
-        ssl_version=ssl.PROTOCOL_TLS,
+        minimum_ssl_version=ssl.TLSVersion.TLSv1_2,
+        maximum_ssl_version=ssl.TLSVersion.TLSv1_3,
         **kw,
     ) -> None:
         self._ready_event = threading.Event()
         self._stop_requested = False
         self._certfile = certfile
         self._keyfile = keyfile
-        self._ssl_version = ssl_version
+        self._minimum_ssl_version = minimum_ssl_version
+        self._maximum_ssl_version = maximum_ssl_version
         super().__init__(*args, **kw)
 
     def service_actions(self):
@@ -191,13 +189,11 @@ def get_request(self):
         if self._certfile is None:
             return super().get_request()
         newsocket, fromaddr = self.socket.accept()
-        connstream = ssl.wrap_socket(
-            newsocket,
-            server_side=True,
-            certfile=self._certfile,
-            keyfile=self._keyfile,
-            ssl_version=self._ssl_version,
-        )
+        context = ssl.create_default_context(ssl.Purpose.CLIENT_AUTH)
+        context.load_cert_chain(certfile=self._certfile, keyfile=self._keyfile)
+        context.minimum_version = self._minimum_ssl_version
+        context.maximum_version = self._maximum_ssl_version
+        connstream = context.wrap_socket(newsocket, server_side=True)
         return connstream, fromaddr
 
 
@@ -228,10 +224,10 @@ def is_serving(self):
 
 class _RedisRequestHandler(socketserver.StreamRequestHandler):
     def setup(self):
-        _logger.info("%s connected", self.client_address)
+        pass
 
     def finish(self):
-        _logger.info("%s disconnected", self.client_address)
+        pass
 
     def handle(self):
         buffer = b""
@@ -249,7 +245,6 @@ def handle(self):
             buffer = parts[-1]
             for fragment in parts[:-1]:
                 fragment = fragment.decode()
-                _logger.info("Command fragment: %s", fragment)
 
                 if fragment.startswith("*") and command is None:
                     command = [None for _ in range(int(fragment[1:]))]
@@ -269,9 +264,6 @@ def handle(self):
                     continue
 
                 command = " ".join(command)
-                _logger.info("Command %s", command)
                 resp = _SUPPORTED_CMDS.get(command, _ERROR_RESP)
-                _logger.info("Response %s", resp)
                 self.request.sendall(resp)
                 command = None
-        _logger.info("Exit handler")

From b2179f65d05eb02182271f06b52f8af701092045 Mon Sep 17 00:00:00 2001
From: Kurt McKee <contactme@kurtmckee.org>
Date: Wed, 17 Jul 2024 03:38:31 -0500
Subject: [PATCH 0910/1164] Close Unix sockets if the connection attempt fails
 (#3315)

Make sure Unix sockets get closed if the connection fails.

Fixes #3314
---
 CHANGES             | 1 +
 redis/connection.py | 7 ++++++-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/CHANGES b/CHANGES
index 20d7d8f51f..107e21a963 100644
--- a/CHANGES
+++ b/CHANGES
@@ -64,6 +64,7 @@
     * Make `ClusterCommandsProtocol` an actual Protocol
     * Add `sum` to DUPLICATE_POLICY documentation of `TS.CREATE`, `TS.ADD` and `TS.ALTER`
     * Prevent async ClusterPipeline instances from becoming "false-y" in case of empty command stack (#3061)
+    * Close Unix sockets if the connection attempt fails. This prevents `ResourceWarning`s. (#3314)
 
 * 4.1.3 (Feb 8, 2022)
   * Fix flushdb and flushall (#1926)
diff --git a/redis/connection.py b/redis/connection.py
index 19263376d2..457e2b1896 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -920,7 +920,12 @@ def _connect(self):
         "Create a Unix domain socket connection"
         sock = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
         sock.settimeout(self.socket_connect_timeout)
-        sock.connect(self.path)
+        try:
+            sock.connect(self.path)
+        except OSError:
+            # Prevent ResourceWarnings for unclosed sockets.
+            sock.close()
+            raise
         sock.settimeout(self.socket_timeout)
         return sock
 

From b206a0f512dd0bc2f761890b9f79c3f77797a831 Mon Sep 17 00:00:00 2001
From: Kurt McKee <contactme@kurtmckee.org>
Date: Wed, 17 Jul 2024 06:15:42 -0500
Subject: [PATCH 0911/1164] Suppress `Graph` deprecation warning in test suite
 (#3316)

Move pytest warning control to `pytest.ini`.

Ignore `Graph` `DeprecationWarning` in the test suite

One extra test is added to verify the warning is actually thrown.
---
 pytest.ini          | 3 +++
 tasks.py            | 8 ++++----
 tests/test_graph.py | 9 +++++++++
 3 files changed, 16 insertions(+), 4 deletions(-)

diff --git a/pytest.ini b/pytest.ini
index f1b716ae96..9db630e5b1 100644
--- a/pytest.ini
+++ b/pytest.ini
@@ -11,3 +11,6 @@ markers =
     experimental: run only experimental tests
 asyncio_mode = auto
 timeout = 30
+filterwarnings =
+    always
+    ignore:RedisGraph support is deprecated as of Redis Stack 7.2:DeprecationWarning
diff --git a/tasks.py b/tasks.py
index 79b27852e3..0fef093f3c 100644
--- a/tasks.py
+++ b/tasks.py
@@ -55,11 +55,11 @@ def standalone_tests(c, uvloop=False, protocol=2, profile=False):
     profile_arg = "--profile" if profile else ""
     if uvloop:
         run(
-            f"pytest {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' --uvloop --junit-xml=standalone-uvloop-results.xml"
+            f"pytest {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_redis.xml -m 'not onlycluster' --uvloop --junit-xml=standalone-uvloop-results.xml"
         )
     else:
         run(
-            f"pytest {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_redis.xml -W always -m 'not onlycluster' --junit-xml=standalone-results.xml"
+            f"pytest {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_redis.xml -m 'not onlycluster' --junit-xml=standalone-results.xml"
         )
 
 
@@ -70,11 +70,11 @@ def cluster_tests(c, uvloop=False, protocol=2, profile=False):
     cluster_url = "redis://localhost:16379/0"
     if uvloop:
         run(
-            f"pytest {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_cluster.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --junit-xml=cluster-uvloop-results.xml --uvloop"
+            f"pytest {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_cluster.xml -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --junit-xml=cluster-uvloop-results.xml --uvloop"
         )
     else:
         run(
-            f"pytest  {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_clusteclient.xml -W always -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --junit-xml=cluster-results.xml"
+            f"pytest  {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_clusteclient.xml -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --junit-xml=cluster-results.xml"
         )
 
 
diff --git a/tests/test_graph.py b/tests/test_graph.py
index 680b8af645..c82c5030c8 100644
--- a/tests/test_graph.py
+++ b/tests/test_graph.py
@@ -40,6 +40,15 @@ def test_bulk(client):
         client.graph().bulk(foo="bar!")
 
 
+@pytest.mark.redismod
+def test_graph_creation_throws_deprecation_warning(client):
+    """Verify that a DeprecationWarning is raised when creating a Graph instance."""
+
+    match = "RedisGraph support is deprecated as of Redis Stack 7.2"
+    with pytest.warns(DeprecationWarning, match=match):
+        client.graph()
+
+
 @pytest.mark.redismod
 @skip_if_resp_version(3)
 def test_graph_creation(client):

From 96076084d35e424f563d532ebd91eae2294835b4 Mon Sep 17 00:00:00 2001
From: Kurt McKee <contactme@kurtmckee.org>
Date: Wed, 17 Jul 2024 08:36:12 -0500
Subject: [PATCH 0912/1164] Close SSL sockets when connections/validations fail
 (#3318)

Handle more cases of failure when initializing SSL sockets, and make
sure no socket is left unclosed in case of errors.

Fixes #3317
---
 CHANGES             | 1 +
 redis/connection.py | 5 +++--
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/CHANGES b/CHANGES
index 107e21a963..f0d75a45ce 100644
--- a/CHANGES
+++ b/CHANGES
@@ -65,6 +65,7 @@
     * Add `sum` to DUPLICATE_POLICY documentation of `TS.CREATE`, `TS.ADD` and `TS.ALTER`
     * Prevent async ClusterPipeline instances from becoming "false-y" in case of empty command stack (#3061)
     * Close Unix sockets if the connection attempt fails. This prevents `ResourceWarning`s. (#3314)
+    * Close SSL sockets if the connection attempt fails, or if validations fail. (#3317)
 
 * 4.1.3 (Feb 8, 2022)
   * Fix flushdb and flushall (#1926)
diff --git a/redis/connection.py b/redis/connection.py
index 457e2b1896..1f862d0371 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -819,7 +819,7 @@ def _connect(self):
         sock = super()._connect()
         try:
             return self._wrap_socket_with_ssl(sock)
-        except OSError:
+        except (OSError, RedisError):
             sock.close()
             raise
 
@@ -854,7 +854,6 @@ def _wrap_socket_with_ssl(self, sock):
             context.minimum_version = self.ssl_min_version
         if self.ssl_ciphers:
             context.set_ciphers(self.ssl_ciphers)
-        sslsock = context.wrap_socket(sock, server_hostname=self.host)
         if self.ssl_validate_ocsp is True and CRYPTOGRAPHY_AVAILABLE is False:
             raise RedisError("cryptography is not installed.")
 
@@ -864,6 +863,8 @@ def _wrap_socket_with_ssl(self, sock):
                 "- not both."
             )
 
+        sslsock = context.wrap_socket(sock, server_hostname=self.host)
+
         # validation for the stapled case
         if self.ssl_validate_ocsp_stapled:
             import OpenSSL

From 7e2b4fbecf6085ca1b170718256cc457b327f07e Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@redis.com>
Date: Thu, 18 Jul 2024 16:53:20 +0300
Subject: [PATCH 0913/1164] Upgrade Flake8 (#3323)

Use the latest available Flake8. Fix some linter errors that surfaced.

Take the opportunity to fix typing hints and remove code duplication
around CommandsProtocol.
---
 dev_requirements.txt                       | 4 ++--
 redis/_parsers/helpers.py                  | 2 +-
 redis/commands/core.py                     | 3 ---
 redis/commands/timeseries/info.py          | 2 +-
 redis/typing.py                            | 6 ++----
 tests/test_asyncio/test_connection_pool.py | 1 -
 tests/test_asyncio/test_lock.py            | 2 +-
 tests/test_json.py                         | 1 -
 tests/test_lock.py                         | 2 +-
 9 files changed, 8 insertions(+), 15 deletions(-)

diff --git a/dev_requirements.txt b/dev_requirements.txt
index e9d5738b69..a8da4b49cd 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -1,8 +1,8 @@
 black==24.3.0
 cachetools
 click==8.0.4
-flake8-isort==6.0.0
-flake8==5.0.4
+flake8-isort
+flake8
 flynt~=0.69.0
 invoke==2.2.0
 mock
diff --git a/redis/_parsers/helpers.py b/redis/_parsers/helpers.py
index 2341c92d8a..23fc6db40e 100644
--- a/redis/_parsers/helpers.py
+++ b/redis/_parsers/helpers.py
@@ -507,7 +507,7 @@ def parse_geosearch_generic(response, **options):
     except KeyError:  # it means the command was sent via execute_command
         return response
 
-    if type(response) != list:
+    if not isinstance(response, list):
         response_list = [response]
     else:
         response_list = response
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 26af9eb99c..5a27a2ea31 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1380,9 +1380,6 @@ def failover(self):
         )
 
 
-AsyncManagementCommands = ManagementCommands
-
-
 class AsyncManagementCommands(ManagementCommands):
     async def command_info(self, **kwargs) -> None:
         return super().command_info(**kwargs)
diff --git a/redis/commands/timeseries/info.py b/redis/commands/timeseries/info.py
index d86b92ace2..861e3ef003 100644
--- a/redis/commands/timeseries/info.py
+++ b/redis/commands/timeseries/info.py
@@ -78,7 +78,7 @@ def __init__(self, args):
             self.chunk_size = response["chunkSize"]
         if "duplicatePolicy" in response:
             self.duplicate_policy = response["duplicatePolicy"]
-            if type(self.duplicate_policy) == bytes:
+            if isinstance(self.duplicate_policy, bytes):
                 self.duplicate_policy = self.duplicate_policy.decode()
 
     def get(self, item):
diff --git a/redis/typing.py b/redis/typing.py
index ee4296245f..b4d442c444 100644
--- a/redis/typing.py
+++ b/redis/typing.py
@@ -54,10 +54,8 @@
 class CommandsProtocol(Protocol):
     connection_pool: Union["AsyncConnectionPool", "ConnectionPool"]
 
-    def execute_command(self, *args, **options): ...
+    def execute_command(self, *args, **options) -> ResponseT: ...
 
 
-class ClusterCommandsProtocol(CommandsProtocol, Protocol):
+class ClusterCommandsProtocol(CommandsProtocol):
     encoder: "Encoder"
-
-    def execute_command(self, *args, **options) -> Union[Any, Awaitable]: ...
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
index 5e4d3f206f..2f5bbfb621 100644
--- a/tests/test_asyncio/test_connection_pool.py
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -647,7 +647,6 @@ def test_connect_from_url_tcp(self):
         connection = redis.Redis.from_url("redis://localhost")
         pool = connection.connection_pool
 
-        print(repr(pool))
         assert re.match(
             r"< .*?([^\.]+) \( < .*?([^\.]+) \( (.+) \) > \) >", repr(pool), re.VERBOSE
         ).groups() == (
diff --git a/tests/test_asyncio/test_lock.py b/tests/test_asyncio/test_lock.py
index 9eaaed6920..033a8b7467 100644
--- a/tests/test_asyncio/test_lock.py
+++ b/tests/test_asyncio/test_lock.py
@@ -237,4 +237,4 @@ def __init__(self, *args, **kwargs):
                 pass
 
         lock = r.lock("foo", lock_class=MyLock)
-        assert type(lock) == MyLock
+        assert isinstance(lock, MyLock)
diff --git a/tests/test_json.py b/tests/test_json.py
index 50787c717c..f4cea73787 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -446,7 +446,6 @@ def test_json_forget_with_dollar(client):
     client.json().forget("not_a_document", "..a")
 
 
-@pytest.mark.onlynoncluster
 @pytest.mark.redismod
 def test_json_mget_dollar(client):
     # Test mget with multi paths
diff --git a/tests/test_lock.py b/tests/test_lock.py
index 5c804b426e..d77ff9717a 100644
--- a/tests/test_lock.py
+++ b/tests/test_lock.py
@@ -257,4 +257,4 @@ def __init__(self, *args, **kwargs):
                 pass
 
         lock = r.lock("foo", lock_class=MyLock)
-        assert type(lock) == MyLock
+        assert isinstance(lock, MyLock)

From 2ffcac32347d5e2ceac3d60e3332367e16774e30 Mon Sep 17 00:00:00 2001
From: Kurt McKee <contactme@kurtmckee.org>
Date: Thu, 18 Jul 2024 09:49:17 -0500
Subject: [PATCH 0914/1164] Resolve some docs warnings (#3322)

Get rid of some warning related to documentation.
---
 .github/wordlist.txt              |  1 +
 docs/conf.py                      |  1 -
 docs/connections.rst              |  6 ++---
 docs/opentelemetry.rst            |  8 +++----
 redis/commands/core.py            | 27 +++++++++++++---------
 redis/commands/graph/commands.py  |  2 +-
 redis/commands/search/commands.py | 38 +++++++++++++++----------------
 7 files changed, 44 insertions(+), 39 deletions(-)

diff --git a/.github/wordlist.txt b/.github/wordlist.txt
index 540e915277..ca2102b825 100644
--- a/.github/wordlist.txt
+++ b/.github/wordlist.txt
@@ -141,3 +141,4 @@ unicode
 url
 virtualenv
 www
+yaml
diff --git a/docs/conf.py b/docs/conf.py
index f66c5903ff..865bd522a2 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -128,7 +128,6 @@
 # further.  For a list of options available for each theme, see the
 # documentation.
 html_theme_options = {
-    "display_version": True,
     "footer_icons": [
         {
             "name": "GitHub",
diff --git a/docs/connections.rst b/docs/connections.rst
index 1c826a0cf8..b547a7659e 100644
--- a/docs/connections.rst
+++ b/docs/connections.rst
@@ -55,7 +55,7 @@ ClusterNode
 Async Client
 ************
 
-See complete example: `here <examples/asyncio_examples.html>`_
+See complete example: `here <examples/asyncio_examples.html>`__
 
 This client is used for communicating with Redis, asynchronously.
 
@@ -88,7 +88,7 @@ ClusterPipeline (Async)
 Connection
 **********
 
-See complete example: `here <examples/connection_examples.html>`_
+See complete example: `here <examples/connection_examples.html>`__
 
 Connection
 ==========
@@ -104,7 +104,7 @@ Connection (Async)
 Connection Pools
 ****************
 
-See complete example: `here <examples/connection_examples.html>`_
+See complete example: `here <examples/connection_examples.html>`__
 
 ConnectionPool
 ==============
diff --git a/docs/opentelemetry.rst b/docs/opentelemetry.rst
index d006a60461..c0285e6761 100644
--- a/docs/opentelemetry.rst
+++ b/docs/opentelemetry.rst
@@ -4,7 +4,7 @@ Integrating OpenTelemetry
 What is OpenTelemetry?
 ----------------------
 
-`OpenTelemetry <https://opentelemetry.io>`_ is an open-source observability framework for traces, metrics, and logs. It is a merger of OpenCensus and OpenTracing projects hosted by Cloud Native Computing Foundation.
+`OpenTelemetry <https://opentelemetry.io>`__ is an open-source observability framework for traces, metrics, and logs. It is a merger of OpenCensus and OpenTracing projects hosted by Cloud Native Computing Foundation.
 
 OpenTelemetry allows developers to collect and export telemetry data in a vendor agnostic way. With OpenTelemetry, you can instrument your application once and then add or change vendors without changing the instrumentation, for example, here is a list of `popular DataDog competitors <https://uptrace.dev/get/compare/datadog-competitors.html>`_ that support OpenTelemetry.
 
@@ -61,7 +61,7 @@ Once the code is patched, you can use redis-py as usually:
 OpenTelemetry API
 -----------------
 
-`OpenTelemetry <https://uptrace.dev/opentelemetry/>`_ API is a programming interface that you can use to instrument code and collect telemetry data such as traces, metrics, and logs.
+`OpenTelemetry API <https://uptrace.dev/opentelemetry/>`__ is a programming interface that you can use to instrument code and collect telemetry data such as traces, metrics, and logs.
 
 You can use OpenTelemetry API to measure important operations:
 
@@ -125,7 +125,7 @@ Alerting and notifications
 
 Uptrace also allows you to monitor `OpenTelemetry metrics <https://uptrace.dev/opentelemetry/metrics.html>`_ using alerting rules. For example, the following monitor uses the group by node expression to create an alert whenever an individual Redis shard is down:
 
-.. code-block:: python
+.. code-block:: yaml
 
    monitors:
      - name: Redis shard is down
@@ -142,7 +142,7 @@ Uptrace also allows you to monitor `OpenTelemetry metrics <https://uptrace.dev/o
 
 You can also create queries with more complex expressions. For example, the following rule creates an alert when the keyspace hit rate is lower than 75%:
 
-.. code-block:: python
+.. code-block:: yaml
 
    monitors:
      - name: Redis read hit rate < 75%
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 5a27a2ea31..b356d101ee 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -79,7 +79,7 @@ def acl_dryrun(self, username, *args, **kwargs):
 
     def acl_deluser(self, *username: str, **kwargs) -> ResponseT:
         """
-        Delete the ACL for the specified ``username``s
+        Delete the ACL for the specified ``username``\\s
 
         For more information see https://redis.io/commands/acl-deluser
         """
@@ -227,9 +227,10 @@ def acl_setuser(
                       must be prefixed with either a '+' to add the command permission
                       or a '-' to remove the command permission.
             keys: A list of key patterns to grant the user access to. Key patterns allow
-                  '*' to support wildcard matching. For example, '*' grants access to
-                  all keys while 'cache:*' grants access to all keys that are prefixed
-                  with 'cache:'. `keys` should not be prefixed with a '~'.
+                  ``'*'`` to support wildcard matching. For example, ``'*'`` grants
+                  access to all keys while ``'cache:*'`` grants access to all keys that
+                  are prefixed with ``cache:``.
+                  `keys` should not be prefixed with a ``'~'``.
             reset: Indicates whether the user should be fully reset prior to applying
                    the new ACL. Setting this to `True` will remove all existing
                    passwords, flags, and privileges from the user and then apply the
@@ -3366,7 +3367,7 @@ def sintercard(
         self, numkeys: int, keys: List[str], limit: int = 0
     ) -> Union[Awaitable[int], int]:
         """
-        Return the cardinality of the intersect of multiple sets specified by ``keys`.
+        Return the cardinality of the intersect of multiple sets specified by ``keys``.
 
         When LIMIT provided (defaults to 0 and means unlimited), if the intersection
         cardinality reaches limit partway through the computation, the algorithm will
@@ -3498,9 +3499,11 @@ class StreamCommands(CommandsProtocol):
     def xack(self, name: KeyT, groupname: GroupT, *ids: StreamIdT) -> ResponseT:
         """
         Acknowledges the successful processing of one or more messages.
-        name: name of the stream.
-        groupname: name of the consumer group.
-        *ids: message ids to acknowledge.
+
+        Args:
+            name: name of the stream.
+            groupname: name of the consumer group.
+            *ids: message ids to acknowledge.
 
         For more information see https://redis.io/commands/xack
         """
@@ -3696,8 +3699,10 @@ def xclaim(
     def xdel(self, name: KeyT, *ids: StreamIdT) -> ResponseT:
         """
         Deletes one or more messages from a stream.
-        name: name of the stream.
-        *ids: message ids to delete.
+
+        Args:
+            name: name of the stream.
+            *ids: message ids to delete.
 
         For more information see https://redis.io/commands/xdel
         """
@@ -4265,7 +4270,7 @@ def zintercard(
     ) -> Union[Awaitable[int], int]:
         """
         Return the cardinality of the intersect of multiple sorted sets
-        specified by ``keys`.
+        specified by ``keys``.
         When LIMIT provided (defaults to 0 and means unlimited), if the intersection
         cardinality reaches limit partway through the computation, the algorithm will
         exit and yield limit as the cardinality
diff --git a/redis/commands/graph/commands.py b/redis/commands/graph/commands.py
index 762ab42e16..d92018f731 100644
--- a/redis/commands/graph/commands.py
+++ b/redis/commands/graph/commands.py
@@ -155,7 +155,7 @@ def slowlog(self):
     def config(self, name, value=None, set=False):
         """
         Retrieve or update a RedisGraph configuration.
-        For more information see `https://redis.io/commands/graph.config-get/>`_. # noqa
+        For more information see `<https://redis.io/commands/graph.config-get/>`__.
 
         Args:
 
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 6a828c7e62..da79016ad4 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -337,30 +337,30 @@ def add_document(
         """
         Add a single document to the index.
 
-        ### Parameters
+        Args:
 
-        - **doc_id**: the id of the saved document.
-        - **nosave**: if set to true, we just index the document, and don't
+            doc_id: the id of the saved document.
+            nosave: if set to true, we just index the document, and don't
                       save a copy of it. This means that searches will just
                       return ids.
-        - **score**: the document ranking, between 0.0 and 1.0
-        - **payload**: optional inner-index payload we can save for fast
-        i              access in scoring functions
-        - **replace**: if True, and the document already is in the index,
-        we perform an update and reindex the document
-        - **partial**: if True, the fields specified will be added to the
+            score: the document ranking, between 0.0 and 1.0
+            payload: optional inner-index payload we can save for fast
+                     access in scoring functions
+            replace: if True, and the document already is in the index,
+                     we perform an update and reindex the document
+            partial: if True, the fields specified will be added to the
                        existing document.
                        This has the added benefit that any fields specified
                        with `no_index`
                        will not be reindexed again. Implies `replace`
-        - **language**: Specify the language used for document tokenization.
-        - **no_create**: if True, the document is only updated and reindexed
+            language: Specify the language used for document tokenization.
+            no_create: if True, the document is only updated and reindexed
                          if it already exists.
                          If the document does not exist, an error will be
                          returned. Implies `replace`
-        - **fields** kwargs dictionary of the document fields to be saved
-                         and/or indexed.
-                     NOTE: Geo points shoule be encoded as strings of "lon,lat"
+            fields: kwargs dictionary of the document fields to be saved
+                    and/or indexed.
+                    NOTE: Geo points shoule be encoded as strings of "lon,lat"
         """  # noqa
         return self._add_document(
             doc_id,
@@ -627,13 +627,13 @@ def spellcheck(self, query, distance=None, include=None, exclude=None):
         """
         Issue a spellcheck query
 
-        ### Parameters
+        Args:
 
-        **query**: search query.
-        **distance***: the maximal Levenshtein distance for spelling
+            query: search query.
+            distance: the maximal Levenshtein distance for spelling
                        suggestions (default: 1, max: 4).
-        **include**: specifies an inclusion custom dictionary.
-        **exclude**: specifies an exclusion custom dictionary.
+            include: specifies an inclusion custom dictionary.
+            exclude: specifies an exclusion custom dictionary.
 
         For more information see `FT.SPELLCHECK <https://redis.io/commands/ft.spellcheck>`_.
         """  # noqa

From fd0b0d3eec48daa07ca37e06862e3461c8373a60 Mon Sep 17 00:00:00 2001
From: Gabriel Erzse <gabriel.erzse@redis.com>
Date: Mon, 22 Jul 2024 10:20:26 +0300
Subject: [PATCH 0915/1164] Handle RESP3 sets as Python lists (#3324)

* Handle RESP3 sets as Python lists

Although the RESP3 protocol defines the set data structure, sometimes
the responses from the Redis server contain sets with nested maps, which
cannot be represented in Python as sets with nested dicts, because dicts
are not hashable.

Versions of HIREDIS before 3.0.0 would cause segmentation fault when
parsing such responses. Starting with version 3.0.0 the problem was
fixed, with the compromise that RESP3 sets are represented as Python
lists.

The embedded RESP3 parser was so far trying to represent RESP3 sets as
Python sets, if possible. Only when this was not possible it would
switch to the list representation. Arguably this is not the best user
experience, not knowing when you will get back a set or a list.

Upgrade the required hiredis-py version to be at least 3.0.0, and change
the embedded parser to always represent RESP3 sets as lists. This way we
get a consistent experience in all cases.

This is a breaking change.

* Also cover RESP2 sets

* Fix failing tests

* Fix async RESP3 parser
---
 doctests/dt_set.py                    | 34 +++++++--------
 redis/_parsers/helpers.py             |  3 --
 redis/_parsers/resp3.py               | 12 +-----
 redis/commands/bf/commands.py         |  6 +--
 redis/utils.py                        |  4 +-
 setup.py                              |  2 +-
 tests/test_asyncio/test_bloom.py      |  7 +---
 tests/test_asyncio/test_cluster.py    | 24 +++++------
 tests/test_asyncio/test_commands.py   | 36 ++++++++--------
 tests/test_asyncio/test_search.py     |  5 +--
 tests/test_asyncio/test_timeseries.py |  2 +-
 tests/test_bloom.py                   |  7 +---
 tests/test_cluster.py                 | 24 +++++------
 tests/test_command_parser.py          |  4 --
 tests/test_commands.py                | 60 ++++++++++-----------------
 tests/test_function.py                |  4 +-
 tests/test_search.py                  |  3 +-
 tests/test_timeseries.py              |  2 +-
 18 files changed, 95 insertions(+), 144 deletions(-)

diff --git a/doctests/dt_set.py b/doctests/dt_set.py
index 8ac22fe1de..0c0562ac80 100644
--- a/doctests/dt_set.py
+++ b/doctests/dt_set.py
@@ -58,11 +58,11 @@
 r.sadd("bikes:racing:usa", "bike:1", "bike:4")
 # HIDE_END
 res7 = r.sinter("bikes:racing:france", "bikes:racing:usa")
-print(res7)  # >>> {'bike:1'}
+print(res7)  # >>> ['bike:1']
 # STEP_END
 
 # REMOVE_START
-assert res7 == {"bike:1"}
+assert res7 == ["bike:1"]
 # REMOVE_END
 
 # STEP_START scard
@@ -83,12 +83,12 @@
 print(res9)  # >>> 3
 
 res10 = r.smembers("bikes:racing:france")
-print(res10)  # >>> {'bike:1', 'bike:2', 'bike:3'}
+print(res10)  # >>> ['bike:1', 'bike:2', 'bike:3']
 # STEP_END
 
 # REMOVE_START
 assert res9 == 3
-assert res10 == {"bike:1", "bike:2", "bike:3"}
+assert res10 == ['bike:1', 'bike:2', 'bike:3']
 # REMOVE_END
 
 # STEP_START smismember
@@ -109,11 +109,11 @@
 r.sadd("bikes:racing:usa", "bike:1", "bike:4")
 
 res13 = r.sdiff("bikes:racing:france", "bikes:racing:usa")
-print(res13)  # >>> {'bike:2', 'bike:3'}
+print(res13)  # >>> ['bike:2', 'bike:3']
 # STEP_END
 
 # REMOVE_START
-assert res13 == {"bike:2", "bike:3"}
+assert res13 == ['bike:2', 'bike:3']
 r.delete("bikes:racing:france")
 r.delete("bikes:racing:usa")
 # REMOVE_END
@@ -124,27 +124,27 @@
 r.sadd("bikes:racing:italy", "bike:1", "bike:2", "bike:3", "bike:4")
 
 res13 = r.sinter("bikes:racing:france", "bikes:racing:usa", "bikes:racing:italy")
-print(res13)  # >>> {'bike:1'}
+print(res13)  # >>> ['bike:1']
 
 res14 = r.sunion("bikes:racing:france", "bikes:racing:usa", "bikes:racing:italy")
-print(res14)  # >>> {'bike:1', 'bike:2', 'bike:3', 'bike:4'}
+print(res14)  # >>> ['bike:1', 'bike:2', 'bike:3', 'bike:4']
 
 res15 = r.sdiff("bikes:racing:france", "bikes:racing:usa", "bikes:racing:italy")
-print(res15)  # >>> set()
+print(res15)  # >>> []
 
 res16 = r.sdiff("bikes:racing:usa", "bikes:racing:france")
-print(res16)  # >>> {'bike:4'}
+print(res16)  # >>> ['bike:4']
 
 res17 = r.sdiff("bikes:racing:france", "bikes:racing:usa")
-print(res17)  # >>> {'bike:2', 'bike:3'}
+print(res17)  # >>> ['bike:2', 'bike:3']
 # STEP_END
 
 # REMOVE_START
-assert res13 == {"bike:1"}
-assert res14 == {"bike:1", "bike:2", "bike:3", "bike:4"}
-assert res15 == set()
-assert res16 == {"bike:4"}
-assert res17 == {"bike:2", "bike:3"}
+assert res13 == ['bike:1']
+assert res14 == ['bike:1', 'bike:2', 'bike:3', 'bike:4']
+assert res15 == []
+assert res16 == ['bike:4']
+assert res17 == ['bike:2', 'bike:3']
 r.delete("bikes:racing:france")
 r.delete("bikes:racing:usa")
 r.delete("bikes:racing:italy")
@@ -160,7 +160,7 @@
 print(res19)  # >>> bike:3
 
 res20 = r.smembers("bikes:racing:france")
-print(res20)  # >>> {'bike:2', 'bike:4', 'bike:5'}
+print(res20)  # >>> ['bike:2', 'bike:4', 'bike:5']
 
 res21 = r.srandmember("bikes:racing:france")
 print(res21)  # >>> bike:4
diff --git a/redis/_parsers/helpers.py b/redis/_parsers/helpers.py
index 23fc6db40e..85b084dfdf 100644
--- a/redis/_parsers/helpers.py
+++ b/redis/_parsers/helpers.py
@@ -783,9 +783,6 @@ def string_keys_to_dict(key_string, callback):
 
 
 _RedisCallbacksRESP2 = {
-    **string_keys_to_dict(
-        "SDIFF SINTER SMEMBERS SUNION", lambda r: r and set(r) or set()
-    ),
     **string_keys_to_dict(
         "ZDIFF ZINTER ZPOPMAX ZPOPMIN ZRANGE ZRANGEBYSCORE ZRANK ZREVRANGE "
         "ZREVRANGEBYSCORE ZREVRANK ZUNION",
diff --git a/redis/_parsers/resp3.py b/redis/_parsers/resp3.py
index cc210b9df5..3547fcf355 100644
--- a/redis/_parsers/resp3.py
+++ b/redis/_parsers/resp3.py
@@ -88,15 +88,11 @@ def _read_response(self, disable_decoding=False, push_request=False):
         # set response
         elif byte == b"~":
             # redis can return unhashable types (like dict) in a set,
-            # so we need to first convert to a list, and then try to convert it to a set
+            # so we return sets as list, all the time, for predictability
             response = [
                 self._read_response(disable_decoding=disable_decoding)
                 for _ in range(int(response))
             ]
-            try:
-                response = set(response)
-            except TypeError:
-                pass
         # map response
         elif byte == b"%":
             # We cannot use a dict-comprehension to parse stream.
@@ -233,15 +229,11 @@ async def _read_response(
         # set response
         elif byte == b"~":
             # redis can return unhashable types (like dict) in a set,
-            # so we need to first convert to a list, and then try to convert it to a set
+            # so we always convert to a list, to have predictable return types
             response = [
                 (await self._read_response(disable_decoding=disable_decoding))
                 for _ in range(int(response))
             ]
-            try:
-                response = set(response)
-            except TypeError:
-                pass
         # map response
         elif byte == b"%":
             # We cannot use a dict-comprehension to parse stream.
diff --git a/redis/commands/bf/commands.py b/redis/commands/bf/commands.py
index 447f844508..0a88505557 100644
--- a/redis/commands/bf/commands.py
+++ b/redis/commands/bf/commands.py
@@ -1,6 +1,5 @@
 from redis.client import NEVER_DECODE
-from redis.exceptions import ModuleError
-from redis.utils import HIREDIS_AVAILABLE, deprecated_function
+from redis.utils import deprecated_function
 
 BF_RESERVE = "BF.RESERVE"
 BF_ADD = "BF.ADD"
@@ -139,9 +138,6 @@ def scandump(self, key, iter):
         This command will return successive (iter, data) pairs until (0, NULL) to indicate completion.
         For more information see `BF.SCANDUMP <https://redis.io/commands/bf.scandump>`_.
         """  # noqa
-        if HIREDIS_AVAILABLE:
-            raise ModuleError("This command cannot be used when hiredis is available.")
-
         params = [key, iter]
         options = {}
         options[NEVER_DECODE] = []
diff --git a/redis/utils.py b/redis/utils.py
index 360ee54b8c..a0f31f7ca4 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -6,8 +6,8 @@
 try:
     import hiredis  # noqa
 
-    # Only support Hiredis >= 1.0:
-    HIREDIS_AVAILABLE = not hiredis.__version__.startswith("0.")
+    # Only support Hiredis >= 3.0:
+    HIREDIS_AVAILABLE = int(hiredis.__version__.split(".")[0]) >= 3
     HIREDIS_PACK_AVAILABLE = hasattr(hiredis, "pack_command")
 except ImportError:
     HIREDIS_AVAILABLE = False
diff --git a/setup.py b/setup.py
index 39cd40b807..0c968a4d9f 100644
--- a/setup.py
+++ b/setup.py
@@ -56,7 +56,7 @@
         "Programming Language :: Python :: Implementation :: PyPy",
     ],
     extras_require={
-        "hiredis": ["hiredis>=1.0.0"],
+        "hiredis": ["hiredis>=3.0.0"],
         "ocsp": ["cryptography>=36.0.1", "pyopenssl==23.2.1", "requests>=2.31.0"],
     },
 )
diff --git a/tests/test_asyncio/test_bloom.py b/tests/test_asyncio/test_bloom.py
index c63559a31c..031e8364d7 100644
--- a/tests/test_asyncio/test_bloom.py
+++ b/tests/test_asyncio/test_bloom.py
@@ -3,8 +3,7 @@
 import pytest
 import pytest_asyncio
 import redis.asyncio as redis
-from redis.exceptions import ModuleError, RedisError
-from redis.utils import HIREDIS_AVAILABLE
+from redis.exceptions import RedisError
 from tests.conftest import (
     assert_resp_response,
     is_resp2_connection,
@@ -105,10 +104,6 @@ async def do_verify():
 
     await do_verify()
     cmds = []
-    if HIREDIS_AVAILABLE:
-        with pytest.raises(ModuleError):
-            cur = await decoded_r.bf().scandump("myBloom", 0)
-        return
 
     cur = await decoded_r.bf().scandump("myBloom", 0)
     first = cur[0]
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index a36040f11b..c16272bb5b 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -1753,49 +1753,49 @@ async def test_cluster_rpoplpush(self, r: RedisCluster) -> None:
 
     async def test_cluster_sdiff(self, r: RedisCluster) -> None:
         await r.sadd("{foo}a", "1", "2", "3")
-        assert await r.sdiff("{foo}a", "{foo}b") == {b"1", b"2", b"3"}
+        assert set(await r.sdiff("{foo}a", "{foo}b")) == {b"1", b"2", b"3"}
         await r.sadd("{foo}b", "2", "3")
-        assert await r.sdiff("{foo}a", "{foo}b") == {b"1"}
+        assert await r.sdiff("{foo}a", "{foo}b") == [b"1"]
 
     async def test_cluster_sdiffstore(self, r: RedisCluster) -> None:
         await r.sadd("{foo}a", "1", "2", "3")
         assert await r.sdiffstore("{foo}c", "{foo}a", "{foo}b") == 3
-        assert await r.smembers("{foo}c") == {b"1", b"2", b"3"}
+        assert set(await r.smembers("{foo}c")) == {b"1", b"2", b"3"}
         await r.sadd("{foo}b", "2", "3")
         assert await r.sdiffstore("{foo}c", "{foo}a", "{foo}b") == 1
-        assert await r.smembers("{foo}c") == {b"1"}
+        assert await r.smembers("{foo}c") == [b"1"]
 
     async def test_cluster_sinter(self, r: RedisCluster) -> None:
         await r.sadd("{foo}a", "1", "2", "3")
-        assert await r.sinter("{foo}a", "{foo}b") == set()
+        assert await r.sinter("{foo}a", "{foo}b") == []
         await r.sadd("{foo}b", "2", "3")
-        assert await r.sinter("{foo}a", "{foo}b") == {b"2", b"3"}
+        assert set(await r.sinter("{foo}a", "{foo}b")) == {b"2", b"3"}
 
     async def test_cluster_sinterstore(self, r: RedisCluster) -> None:
         await r.sadd("{foo}a", "1", "2", "3")
         assert await r.sinterstore("{foo}c", "{foo}a", "{foo}b") == 0
-        assert await r.smembers("{foo}c") == set()
+        assert await r.smembers("{foo}c") == []
         await r.sadd("{foo}b", "2", "3")
         assert await r.sinterstore("{foo}c", "{foo}a", "{foo}b") == 2
-        assert await r.smembers("{foo}c") == {b"2", b"3"}
+        assert set(await r.smembers("{foo}c")) == {b"2", b"3"}
 
     async def test_cluster_smove(self, r: RedisCluster) -> None:
         await r.sadd("{foo}a", "a1", "a2")
         await r.sadd("{foo}b", "b1", "b2")
         assert await r.smove("{foo}a", "{foo}b", "a1")
-        assert await r.smembers("{foo}a") == {b"a2"}
-        assert await r.smembers("{foo}b") == {b"b1", b"b2", b"a1"}
+        assert await r.smembers("{foo}a") == [b"a2"]
+        assert set(await r.smembers("{foo}b")) == {b"b1", b"b2", b"a1"}
 
     async def test_cluster_sunion(self, r: RedisCluster) -> None:
         await r.sadd("{foo}a", "1", "2")
         await r.sadd("{foo}b", "2", "3")
-        assert await r.sunion("{foo}a", "{foo}b") == {b"1", b"2", b"3"}
+        assert set(await r.sunion("{foo}a", "{foo}b")) == {b"1", b"2", b"3"}
 
     async def test_cluster_sunionstore(self, r: RedisCluster) -> None:
         await r.sadd("{foo}a", "1", "2")
         await r.sadd("{foo}b", "2", "3")
         assert await r.sunionstore("{foo}c", "{foo}a", "{foo}b") == 3
-        assert await r.smembers("{foo}c") == {b"1", b"2", b"3"}
+        assert set(await r.smembers("{foo}c")) == {b"1", b"2", b"3"}
 
     @skip_if_server_version_lt("6.2.0")
     async def test_cluster_zdiff(self, r: RedisCluster) -> None:
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 61c00541cb..28c3094cdb 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -1406,7 +1406,7 @@ async def test_zscan_iter(self, r: redis.Redis):
     async def test_sadd(self, r: redis.Redis):
         members = {b"1", b"2", b"3"}
         await r.sadd("a", *members)
-        assert await r.smembers("a") == members
+        assert set(await r.smembers("a")) == members
 
     async def test_scard(self, r: redis.Redis):
         await r.sadd("a", "1", "2", "3")
@@ -1415,34 +1415,34 @@ async def test_scard(self, r: redis.Redis):
     @pytest.mark.onlynoncluster
     async def test_sdiff(self, r: redis.Redis):
         await r.sadd("a", "1", "2", "3")
-        assert await r.sdiff("a", "b") == {b"1", b"2", b"3"}
+        assert set(await r.sdiff("a", "b")) == {b"1", b"2", b"3"}
         await r.sadd("b", "2", "3")
-        assert await r.sdiff("a", "b") == {b"1"}
+        assert await r.sdiff("a", "b") == [b"1"]
 
     @pytest.mark.onlynoncluster
     async def test_sdiffstore(self, r: redis.Redis):
         await r.sadd("a", "1", "2", "3")
         assert await r.sdiffstore("c", "a", "b") == 3
-        assert await r.smembers("c") == {b"1", b"2", b"3"}
+        assert set(await r.smembers("c")) == {b"1", b"2", b"3"}
         await r.sadd("b", "2", "3")
         assert await r.sdiffstore("c", "a", "b") == 1
-        assert await r.smembers("c") == {b"1"}
+        assert await r.smembers("c") == [b"1"]
 
     @pytest.mark.onlynoncluster
     async def test_sinter(self, r: redis.Redis):
         await r.sadd("a", "1", "2", "3")
-        assert await r.sinter("a", "b") == set()
+        assert await r.sinter("a", "b") == []
         await r.sadd("b", "2", "3")
-        assert await r.sinter("a", "b") == {b"2", b"3"}
+        assert set(await r.sinter("a", "b")) == {b"2", b"3"}
 
     @pytest.mark.onlynoncluster
     async def test_sinterstore(self, r: redis.Redis):
         await r.sadd("a", "1", "2", "3")
         assert await r.sinterstore("c", "a", "b") == 0
-        assert await r.smembers("c") == set()
+        assert await r.smembers("c") == []
         await r.sadd("b", "2", "3")
         assert await r.sinterstore("c", "a", "b") == 2
-        assert await r.smembers("c") == {b"2", b"3"}
+        assert set(await r.smembers("c")) == {b"2", b"3"}
 
     async def test_sismember(self, r: redis.Redis):
         await r.sadd("a", "1", "2", "3")
@@ -1453,22 +1453,22 @@ async def test_sismember(self, r: redis.Redis):
 
     async def test_smembers(self, r: redis.Redis):
         await r.sadd("a", "1", "2", "3")
-        assert await r.smembers("a") == {b"1", b"2", b"3"}
+        assert set(await r.smembers("a")) == {b"1", b"2", b"3"}
 
     @pytest.mark.onlynoncluster
     async def test_smove(self, r: redis.Redis):
         await r.sadd("a", "a1", "a2")
         await r.sadd("b", "b1", "b2")
         assert await r.smove("a", "b", "a1")
-        assert await r.smembers("a") == {b"a2"}
-        assert await r.smembers("b") == {b"b1", b"b2", b"a1"}
+        assert await r.smembers("a") == [b"a2"]
+        assert set(await r.smembers("b")) == {b"b1", b"b2", b"a1"}
 
     async def test_spop(self, r: redis.Redis):
         s = [b"1", b"2", b"3"]
         await r.sadd("a", *s)
         value = await r.spop("a")
         assert value in s
-        assert await r.smembers("a") == set(s) - {value}
+        assert set(await r.smembers("a")) == set(s) - {value}
 
     @skip_if_server_version_lt("3.2.0")
     async def test_spop_multi_value(self, r: redis.Redis):
@@ -1481,9 +1481,7 @@ async def test_spop_multi_value(self, r: redis.Redis):
             assert value in s
 
         response = await r.spop("a", 1)
-        assert_resp_response(
-            r, response, list(set(s) - set(values)), set(s) - set(values)
-        )
+        assert set(response) == set(s) - set(values)
 
     async def test_srandmember(self, r: redis.Redis):
         s = [b"1", b"2", b"3"]
@@ -1502,20 +1500,20 @@ async def test_srem(self, r: redis.Redis):
         await r.sadd("a", "1", "2", "3", "4")
         assert await r.srem("a", "5") == 0
         assert await r.srem("a", "2", "4") == 2
-        assert await r.smembers("a") == {b"1", b"3"}
+        assert set(await r.smembers("a")) == {b"1", b"3"}
 
     @pytest.mark.onlynoncluster
     async def test_sunion(self, r: redis.Redis):
         await r.sadd("a", "1", "2")
         await r.sadd("b", "2", "3")
-        assert await r.sunion("a", "b") == {b"1", b"2", b"3"}
+        assert set(await r.sunion("a", "b")) == {b"1", b"2", b"3"}
 
     @pytest.mark.onlynoncluster
     async def test_sunionstore(self, r: redis.Redis):
         await r.sadd("a", "1", "2")
         await r.sadd("b", "2", "3")
         assert await r.sunionstore("c", "a", "b") == 3
-        assert await r.smembers("c") == {b"1", b"2", b"3"}
+        assert set(await r.smembers("c")) == {b"1", b"2", b"3"}
 
     # SORTED SET COMMANDS
     async def test_zadd(self, r: redis.Redis):
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 47d34f9c07..68560d1f2a 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -24,7 +24,6 @@
 from redis.commands.search.result import Result
 from redis.commands.search.suggestion import Suggestion
 from tests.conftest import (
-    assert_resp_response,
     is_resp2_connection,
     skip_if_redis_enterprise,
     skip_if_resp_version,
@@ -862,7 +861,7 @@ async def test_tags(decoded_r: redis.Redis):
         assert 1 == res["total_results"]
 
         q2 = await decoded_r.ft().tagvals("tags")
-        assert set(tags.split(",") + tags2.split(",")) == q2
+        assert set(tags.split(",") + tags2.split(",")) == set(q2)
 
 
 @pytest.mark.redismod
@@ -986,7 +985,7 @@ async def test_dict_operations(decoded_r: redis.Redis):
 
     # Dump dict and inspect content
     res = await decoded_r.ft().dict_dump("custom_dict")
-    assert_resp_response(decoded_r, res, ["item1", "item3"], {"item1", "item3"})
+    assert res == ["item1", "item3"]
 
     # Remove rest of the items before reload
     await decoded_r.ft().dict_del("custom_dict", *res)
diff --git a/tests/test_asyncio/test_timeseries.py b/tests/test_asyncio/test_timeseries.py
index 0475c318ec..5a1597f2d0 100644
--- a/tests/test_asyncio/test_timeseries.py
+++ b/tests/test_asyncio/test_timeseries.py
@@ -746,7 +746,7 @@ async def test_query_index(decoded_r: redis.Redis):
     assert 2 == len(await decoded_r.ts().queryindex(["Test=This"]))
     assert 1 == len(await decoded_r.ts().queryindex(["Taste=That"]))
     assert_resp_response(
-        decoded_r, await decoded_r.ts().queryindex(["Taste=That"]), [2], {"2"}
+        decoded_r, await decoded_r.ts().queryindex(["Taste=That"]), [2], ["2"]
     )
 
 
diff --git a/tests/test_bloom.py b/tests/test_bloom.py
index d1a0484225..e44c421634 100644
--- a/tests/test_bloom.py
+++ b/tests/test_bloom.py
@@ -2,8 +2,7 @@
 
 import pytest
 import redis.commands.bf
-from redis.exceptions import ModuleError, RedisError
-from redis.utils import HIREDIS_AVAILABLE
+from redis.exceptions import RedisError
 
 from .conftest import (
     _get_client,
@@ -136,10 +135,6 @@ def do_verify():
 
     do_verify()
     cmds = []
-    if HIREDIS_AVAILABLE:
-        with pytest.raises(ModuleError):
-            cur = client.bf().scandump("myBloom", 0)
-        return
 
     cur = client.bf().scandump("myBloom", 0)
     first = cur[0]
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 5a32bd6a7e..5a28f4cde5 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -1868,49 +1868,49 @@ def test_cluster_rpoplpush(self, r):
 
     def test_cluster_sdiff(self, r):
         r.sadd("{foo}a", "1", "2", "3")
-        assert r.sdiff("{foo}a", "{foo}b") == {b"1", b"2", b"3"}
+        assert set(r.sdiff("{foo}a", "{foo}b")) == {b"1", b"2", b"3"}
         r.sadd("{foo}b", "2", "3")
-        assert r.sdiff("{foo}a", "{foo}b") == {b"1"}
+        assert r.sdiff("{foo}a", "{foo}b") == [b"1"]
 
     def test_cluster_sdiffstore(self, r):
         r.sadd("{foo}a", "1", "2", "3")
         assert r.sdiffstore("{foo}c", "{foo}a", "{foo}b") == 3
-        assert r.smembers("{foo}c") == {b"1", b"2", b"3"}
+        assert set(r.smembers("{foo}c")) == {b"1", b"2", b"3"}
         r.sadd("{foo}b", "2", "3")
         assert r.sdiffstore("{foo}c", "{foo}a", "{foo}b") == 1
-        assert r.smembers("{foo}c") == {b"1"}
+        assert r.smembers("{foo}c") == [b"1"]
 
     def test_cluster_sinter(self, r):
         r.sadd("{foo}a", "1", "2", "3")
-        assert r.sinter("{foo}a", "{foo}b") == set()
+        assert r.sinter("{foo}a", "{foo}b") == []
         r.sadd("{foo}b", "2", "3")
-        assert r.sinter("{foo}a", "{foo}b") == {b"2", b"3"}
+        assert set(r.sinter("{foo}a", "{foo}b")) == {b"2", b"3"}
 
     def test_cluster_sinterstore(self, r):
         r.sadd("{foo}a", "1", "2", "3")
         assert r.sinterstore("{foo}c", "{foo}a", "{foo}b") == 0
-        assert r.smembers("{foo}c") == set()
+        assert r.smembers("{foo}c") == []
         r.sadd("{foo}b", "2", "3")
         assert r.sinterstore("{foo}c", "{foo}a", "{foo}b") == 2
-        assert r.smembers("{foo}c") == {b"2", b"3"}
+        assert set(r.smembers("{foo}c")) == {b"2", b"3"}
 
     def test_cluster_smove(self, r):
         r.sadd("{foo}a", "a1", "a2")
         r.sadd("{foo}b", "b1", "b2")
         assert r.smove("{foo}a", "{foo}b", "a1")
-        assert r.smembers("{foo}a") == {b"a2"}
-        assert r.smembers("{foo}b") == {b"b1", b"b2", b"a1"}
+        assert r.smembers("{foo}a") == [b"a2"]
+        assert set(r.smembers("{foo}b")) == {b"b1", b"b2", b"a1"}
 
     def test_cluster_sunion(self, r):
         r.sadd("{foo}a", "1", "2")
         r.sadd("{foo}b", "2", "3")
-        assert r.sunion("{foo}a", "{foo}b") == {b"1", b"2", b"3"}
+        assert set(r.sunion("{foo}a", "{foo}b")) == {b"1", b"2", b"3"}
 
     def test_cluster_sunionstore(self, r):
         r.sadd("{foo}a", "1", "2")
         r.sadd("{foo}b", "2", "3")
         assert r.sunionstore("{foo}c", "{foo}a", "{foo}b") == 3
-        assert r.smembers("{foo}c") == {b"1", b"2", b"3"}
+        assert set(r.smembers("{foo}c")) == {b"1", b"2", b"3"}
 
     @skip_if_server_version_lt("6.2.0")
     def test_cluster_zdiff(self, r):
diff --git a/tests/test_command_parser.py b/tests/test_command_parser.py
index 5c23a7096f..e3b44a147f 100644
--- a/tests/test_command_parser.py
+++ b/tests/test_command_parser.py
@@ -1,6 +1,5 @@
 import pytest
 from redis._parsers import CommandsParser
-from redis.utils import HIREDIS_AVAILABLE
 
 from .conftest import (
     assert_resp_response,
@@ -9,9 +8,6 @@
 )
 
 
-# The response to COMMAND contains maps inside sets, which are not handled
-# by the hiredis-py parser (see https://github.com/redis/hiredis-py/issues/188)
-@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 class TestCommandsParser:
     def test_init_commands(self, r):
         commands_parser = CommandsParser(r)
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 42376b50d8..02afab3c40 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -18,7 +18,6 @@
     parse_info,
 )
 from redis.client import EMPTY_RESPONSE, NEVER_DECODE
-from redis.utils import HIREDIS_AVAILABLE
 
 from .conftest import (
     _get_client,
@@ -2239,7 +2238,7 @@ def test_zscan_iter(self, r):
     def test_sadd(self, r):
         members = {b"1", b"2", b"3"}
         r.sadd("a", *members)
-        assert r.smembers("a") == members
+        assert set(r.smembers("a")) == members
 
     def test_scard(self, r):
         r.sadd("a", "1", "2", "3")
@@ -2248,25 +2247,25 @@ def test_scard(self, r):
     @pytest.mark.onlynoncluster
     def test_sdiff(self, r):
         r.sadd("a", "1", "2", "3")
-        assert r.sdiff("a", "b") == {b"1", b"2", b"3"}
+        assert set(r.sdiff("a", "b")) == {b"1", b"2", b"3"}
         r.sadd("b", "2", "3")
-        assert r.sdiff("a", "b") == {b"1"}
+        assert r.sdiff("a", "b") == [b"1"]
 
     @pytest.mark.onlynoncluster
     def test_sdiffstore(self, r):
         r.sadd("a", "1", "2", "3")
         assert r.sdiffstore("c", "a", "b") == 3
-        assert r.smembers("c") == {b"1", b"2", b"3"}
+        assert set(r.smembers("c")) == {b"1", b"2", b"3"}
         r.sadd("b", "2", "3")
         assert r.sdiffstore("c", "a", "b") == 1
-        assert r.smembers("c") == {b"1"}
+        assert r.smembers("c") == [b"1"]
 
     @pytest.mark.onlynoncluster
     def test_sinter(self, r):
         r.sadd("a", "1", "2", "3")
-        assert r.sinter("a", "b") == set()
+        assert r.sinter("a", "b") == []
         r.sadd("b", "2", "3")
-        assert r.sinter("a", "b") == {b"2", b"3"}
+        assert set(r.sinter("a", "b")) == {b"2", b"3"}
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("7.0.0")
@@ -2281,10 +2280,10 @@ def test_sintercard(self, r):
     def test_sinterstore(self, r):
         r.sadd("a", "1", "2", "3")
         assert r.sinterstore("c", "a", "b") == 0
-        assert r.smembers("c") == set()
+        assert r.smembers("c") == []
         r.sadd("b", "2", "3")
         assert r.sinterstore("c", "a", "b") == 2
-        assert r.smembers("c") == {b"2", b"3"}
+        assert set(r.smembers("c")) == {b"2", b"3"}
 
     def test_sismember(self, r):
         r.sadd("a", "1", "2", "3")
@@ -2295,7 +2294,7 @@ def test_sismember(self, r):
 
     def test_smembers(self, r):
         r.sadd("a", "1", "2", "3")
-        assert r.smembers("a") == {b"1", b"2", b"3"}
+        assert set(r.smembers("a")) == {b"1", b"2", b"3"}
 
     @skip_if_server_version_lt("6.2.0")
     def test_smismember(self, r):
@@ -2309,15 +2308,15 @@ def test_smove(self, r):
         r.sadd("a", "a1", "a2")
         r.sadd("b", "b1", "b2")
         assert r.smove("a", "b", "a1")
-        assert r.smembers("a") == {b"a2"}
-        assert r.smembers("b") == {b"b1", b"b2", b"a1"}
+        assert r.smembers("a") == [b"a2"]
+        assert set(r.smembers("b")) == {b"b1", b"b2", b"a1"}
 
     def test_spop(self, r):
         s = [b"1", b"2", b"3"]
         r.sadd("a", *s)
         value = r.spop("a")
         assert value in s
-        assert r.smembers("a") == set(s) - {value}
+        assert set(r.smembers("a")) == set(s) - {value}
 
     @skip_if_server_version_lt("3.2.0")
     def test_spop_multi_value(self, r):
@@ -2328,12 +2327,7 @@ def test_spop_multi_value(self, r):
 
         for value in values:
             assert value in s
-        assert_resp_response(
-            r,
-            r.spop("a", 1),
-            list(set(s) - set(values)),
-            set(s) - set(values),
-        )
+        assert set(r.spop("a", 1)) == set(s) - set(values)
 
     def test_srandmember(self, r):
         s = [b"1", b"2", b"3"]
@@ -2352,20 +2346,20 @@ def test_srem(self, r):
         r.sadd("a", "1", "2", "3", "4")
         assert r.srem("a", "5") == 0
         assert r.srem("a", "2", "4") == 2
-        assert r.smembers("a") == {b"1", b"3"}
+        assert set(r.smembers("a")) == {b"1", b"3"}
 
     @pytest.mark.onlynoncluster
     def test_sunion(self, r):
         r.sadd("a", "1", "2")
         r.sadd("b", "2", "3")
-        assert r.sunion("a", "b") == {b"1", b"2", b"3"}
+        assert set(r.sunion("a", "b")) == {b"1", b"2", b"3"}
 
     @pytest.mark.onlynoncluster
     def test_sunionstore(self, r):
         r.sadd("a", "1", "2")
         r.sadd("b", "2", "3")
         assert r.sunionstore("c", "a", "b") == 3
-        assert r.smembers("c") == {b"1", b"2", b"3"}
+        assert set(r.smembers("c")) == {b"1", b"2", b"3"}
 
     @skip_if_server_version_lt("1.0.0")
     @skip_if_redis_enterprise()
@@ -5021,9 +5015,6 @@ def test_command_getkeys(self, r):
             r, res, ["key1", "key2", "key3"], [b"key1", b"key2", b"key3"]
         )
 
-    # The response to COMMAND contains maps inside sets, which are not handled
-    # by the hiredis-py parser (see https://github.com/redis/hiredis-py/issues/188)
-    @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
     @skip_if_server_version_lt("2.8.13")
     def test_command(self, r):
         res = r.command()
@@ -5036,18 +5027,11 @@ def test_command(self, r):
     @skip_if_server_version_lt("7.0.0")
     @skip_if_redis_enterprise()
     def test_command_getkeysandflags(self, r: redis.Redis):
-        assert_resp_response(
-            r,
-            r.command_getkeysandflags("LMOVE", "mylist1", "mylist2", "left", "left"),
-            [
-                [b"mylist1", [b"RW", b"access", b"delete"]],
-                [b"mylist2", [b"RW", b"insert"]],
-            ],
-            [
-                [b"mylist1", {b"RW", b"access", b"delete"}],
-                [b"mylist2", {b"RW", b"insert"}],
-            ],
-        )
+        res = r.command_getkeysandflags("LMOVE", "mylist1", "mylist2", "left", "left")
+        assert res == [
+            [b"mylist1", [b"RW", b"access", b"delete"]],
+            [b"mylist2", [b"RW", b"insert"]],
+        ]
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("4.0.0")
diff --git a/tests/test_function.py b/tests/test_function.py
index 9d6712ecf7..afb5833d18 100644
--- a/tests/test_function.py
+++ b/tests/test_function.py
@@ -68,7 +68,7 @@ def test_function_list(self, r):
                 b"library_name": b"mylib",
                 b"engine": b"LUA",
                 b"functions": [
-                    {b"name": b"myfunc", b"description": None, b"flags": {b"no-writes"}}
+                    {b"name": b"myfunc", b"description": None, b"flags": [b"no-writes"]}
                 ],
             }
         ]
@@ -98,7 +98,7 @@ def test_function_list_on_cluster(self, r):
                 b"library_name": b"mylib",
                 b"engine": b"LUA",
                 b"functions": [
-                    {b"name": b"myfunc", b"description": None, b"flags": {b"no-writes"}}
+                    {b"name": b"myfunc", b"description": None, b"flags": [b"no-writes"]}
                 ],
             }
         ]
diff --git a/tests/test_search.py b/tests/test_search.py
index 493171a035..e84f03c0e4 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -27,7 +27,6 @@
 
 from .conftest import (
     _get_client,
-    assert_resp_response,
     is_resp2_connection,
     skip_if_redis_enterprise,
     skip_if_resp_version,
@@ -893,7 +892,7 @@ def test_dict_operations(client):
 
     # Dump dict and inspect content
     res = client.ft().dict_dump("custom_dict")
-    assert_resp_response(client, res, ["item1", "item3"], {"item1", "item3"})
+    assert res == ["item1", "item3"]
 
     # Remove rest of the items before reload
     client.ft().dict_del("custom_dict", *res)
diff --git a/tests/test_timeseries.py b/tests/test_timeseries.py
index 90e627ef6e..fb604d0329 100644
--- a/tests/test_timeseries.py
+++ b/tests/test_timeseries.py
@@ -988,7 +988,7 @@ def test_query_index(client):
     client.ts().create(2, labels={"Test": "This", "Taste": "That"})
     assert 2 == len(client.ts().queryindex(["Test=This"]))
     assert 1 == len(client.ts().queryindex(["Taste=That"]))
-    assert_resp_response(client, client.ts().queryindex(["Taste=That"]), [2], {"2"})
+    assert_resp_response(client, client.ts().queryindex(["Taste=That"]), [2], ["2"])
 
 
 @pytest.mark.redismod

From fb74aa2806100f4026e290dab0cb7164262ff142 Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Tue, 30 Jul 2024 15:00:11 +0300
Subject: [PATCH 0916/1164] Added support for ADDSCORES modifier (#3329)

* Added support for ADDSCORES modifier

* Fixed codestyle issues

* More codestyle fixes

* Updated test cases and testing image to represent latest

* Codestyle issues

* Added handling for dict responses
---
 .github/workflows/integration.yaml   |  2 +-
 redis/commands/search/aggregation.py | 11 +++++++++++
 tests/test_asyncio/test_search.py    | 26 ++++++++++++++++++++++++++
 tests/test_search.py                 | 26 ++++++++++++++++++++++++++
 4 files changed, 64 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 94fe8f35b6..5342238dd3 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -28,7 +28,7 @@ env:
   # this speeds up coverage with Python 3.12: https://github.com/nedbat/coveragepy/issues/1665
   COVERAGE_CORE: sysmon
   REDIS_IMAGE: redis:7.4-rc2
-  REDIS_STACK_IMAGE: redis/redis-stack-server:7.4.0-rc2
+  REDIS_STACK_IMAGE: redis/redis-stack-server:latest
 
 jobs:
   dependency-audit:
diff --git a/redis/commands/search/aggregation.py b/redis/commands/search/aggregation.py
index 50d18f476a..42c3547b0b 100644
--- a/redis/commands/search/aggregation.py
+++ b/redis/commands/search/aggregation.py
@@ -111,6 +111,7 @@ def __init__(self, query: str = "*") -> None:
         self._verbatim = False
         self._cursor = []
         self._dialect = None
+        self._add_scores = False
 
     def load(self, *fields: List[str]) -> "AggregateRequest":
         """
@@ -292,6 +293,13 @@ def with_schema(self) -> "AggregateRequest":
         self._with_schema = True
         return self
 
+    def add_scores(self) -> "AggregateRequest":
+        """
+        If set, includes the score as an ordinary field of the row.
+        """
+        self._add_scores = True
+        return self
+
     def verbatim(self) -> "AggregateRequest":
         self._verbatim = True
         return self
@@ -315,6 +323,9 @@ def build_args(self) -> List[str]:
         if self._verbatim:
             ret.append("VERBATIM")
 
+        if self._add_scores:
+            ret.append("ADDSCORES")
+
         if self._cursor:
             ret += self._cursor
 
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 68560d1f2a..0e6fe22131 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -1530,6 +1530,32 @@ async def test_withsuffixtrie(decoded_r: redis.Redis):
         assert "WITHSUFFIXTRIE" in info["attributes"][0]["flags"]
 
 
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.10.05", "search")
+async def test_aggregations_add_scores(decoded_r: redis.Redis):
+    assert await decoded_r.ft().create_index(
+        (
+            TextField("name", sortable=True, weight=5.0),
+            NumericField("age", sortable=True),
+        )
+    )
+
+    assert await decoded_r.hset("doc1", mapping={"name": "bar", "age": "25"})
+    assert await decoded_r.hset("doc2", mapping={"name": "foo", "age": "19"})
+
+    req = aggregations.AggregateRequest("*").add_scores()
+    res = await decoded_r.ft().aggregate(req)
+
+    if isinstance(res, dict):
+        assert len(res["results"]) == 2
+        assert res["results"][0]["extra_attributes"] == {"__score": "0.2"}
+        assert res["results"][1]["extra_attributes"] == {"__score": "0.2"}
+    else:
+        assert len(res.rows) == 2
+        assert res.rows[0] == ["__score", "0.2"]
+        assert res.rows[1] == ["__score", "0.2"]
+
+
 @pytest.mark.redismod
 @skip_if_redis_enterprise()
 async def test_search_commands_in_pipeline(decoded_r: redis.Redis):
diff --git a/tests/test_search.py b/tests/test_search.py
index e84f03c0e4..dde59f0f87 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1440,6 +1440,32 @@ def test_aggregations_filter(client):
             assert res["results"][1]["extra_attributes"] == {"age": "25"}
 
 
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.10.05", "search")
+def test_aggregations_add_scores(client):
+    client.ft().create_index(
+        (
+            TextField("name", sortable=True, weight=5.0),
+            NumericField("age", sortable=True),
+        )
+    )
+
+    client.hset("doc1", mapping={"name": "bar", "age": "25"})
+    client.hset("doc2", mapping={"name": "foo", "age": "19"})
+
+    req = aggregations.AggregateRequest("*").add_scores()
+    res = client.ft().aggregate(req)
+
+    if isinstance(res, dict):
+        assert len(res["results"]) == 2
+        assert res["results"][0]["extra_attributes"] == {"__score": "0.2"}
+        assert res["results"][1]["extra_attributes"] == {"__score": "0.2"}
+    else:
+        assert len(res.rows) == 2
+        assert res.rows[0] == ["__score", "0.2"]
+        assert res.rows[1] == ["__score", "0.2"]
+
+
 @pytest.mark.redismod
 @skip_ifmodversion_lt("2.0.0", "search")
 def test_index_definition(client):

From 1cbb97ecd7a0bf87aec332a257b589919385d90d Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Fri, 9 Aug 2024 16:13:43 +0300
Subject: [PATCH 0917/1164] Updated commands from docker-compose to docker
 compose (#3352)

---
 tasks.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tasks.py b/tasks.py
index 0fef093f3c..76737b8eff 100644
--- a/tasks.py
+++ b/tasks.py
@@ -13,7 +13,7 @@
 def devenv(c):
     """Brings up the test environment, by wrapping docker compose."""
     clean(c)
-    cmd = "docker-compose --profile all up -d --build"
+    cmd = "docker compose --profile all up -d --build"
     run(cmd)
 
 
@@ -85,7 +85,7 @@ def clean(c):
         shutil.rmtree("build")
     if os.path.isdir("dist"):
         shutil.rmtree("dist")
-    run("docker-compose --profile all rm -s -f")
+    run("docker compose --profile all rm -s -f")
 
 
 @task

From 76bf989c19b4087fd169ef2a330704334a5d6193 Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Mon, 2 Sep 2024 11:26:13 +0300
Subject: [PATCH 0918/1164] Added version restrictions for pytest-asyncio
 (#3362)

---
 dev_requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev_requirements.txt b/dev_requirements.txt
index a8da4b49cd..931784cdaf 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -8,7 +8,7 @@ invoke==2.2.0
 mock
 packaging>=20.4
 pytest
-pytest-asyncio
+pytest-asyncio>=0.23.0,<0.24.0
 pytest-cov
 pytest-profiling
 pytest-timeout

From 147f7cabf0394a04bcb5617ba10e3ea948782ecc Mon Sep 17 00:00:00 2001
From: Dudi <16744955+dudizimber@users.noreply.github.com>
Date: Mon, 2 Sep 2024 12:32:54 +0300
Subject: [PATCH 0919/1164] Add `hostname` field to _parse_node_line (#3343)

Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
---
 redis/_parsers/helpers.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/redis/_parsers/helpers.py b/redis/_parsers/helpers.py
index 85b084dfdf..7494c79210 100644
--- a/redis/_parsers/helpers.py
+++ b/redis/_parsers/helpers.py
@@ -445,9 +445,11 @@ def parse_cluster_info(response, **options):
 def _parse_node_line(line):
     line_items = line.split(" ")
     node_id, addr, flags, master_id, ping, pong, epoch, connected = line.split(" ")[:8]
-    addr = addr.split("@")[0]
+    ip = addr.split("@")[0]
+    hostname = addr.split("@")[1].split(",")[1] if "@" in addr and "," in addr else ""
     node_dict = {
         "node_id": node_id,
+        "hostname": hostname,
         "flags": flags,
         "master_id": master_id,
         "last_ping_sent": ping,
@@ -460,7 +462,7 @@ def _parse_node_line(line):
     if len(line_items) >= 9:
         slots, migrations = _parse_slots(line_items[8:])
         node_dict["slots"], node_dict["migrations"] = slots, migrations
-    return addr, node_dict
+    return ip, node_dict
 
 
 def _parse_slots(slot_ranges):

From 77e09b7c43d2c89767441c1036e6f27551b06ec9 Mon Sep 17 00:00:00 2001
From: Kurt McKee <contactme@kurtmckee.org>
Date: Mon, 2 Sep 2024 05:36:47 -0500
Subject: [PATCH 0920/1164] More docs fixes (#3326)

* Docs: Resolve 'Unexpected indentation' warnings

* Docs: Resolve 'Unexpected unindent' warnings

* Docs: Resolve "more than one target for cross-reference 'Redis'" warnings

When Sphinx runs, `TYPE_CHECKING` is not enabled,
so the differentiating sync/async `Redis` imports don't happen,
and Sphinx appears to be unable to infer which class
`"Redis"` should cross-reference.

---------

Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
---
 redis/asyncio/client.py               |  10 ++-
 redis/commands/core.py                |  59 ++++++++------
 redis/commands/timeseries/commands.py | 110 +++++++++++++-------------
 3 files changed, 97 insertions(+), 82 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 1845b7252f..70a5e997ef 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -579,10 +579,12 @@ async def aclose(self, close_connection_pool: Optional[bool] = None) -> None:
         """
         Closes Redis client connection
 
-        :param close_connection_pool: decides whether to close the connection pool used
-        by this Redis client, overriding Redis.auto_close_connection_pool. By default,
-        let Redis.auto_close_connection_pool decide whether to close the connection
-        pool.
+        Args:
+            close_connection_pool:
+                decides whether to close the connection pool used by this Redis client,
+                overriding Redis.auto_close_connection_pool.
+                By default, let Redis.auto_close_connection_pool decide
+                whether to close the connection pool.
         """
         conn = self.connection
         if conn:
diff --git a/redis/commands/core.py b/redis/commands/core.py
index b356d101ee..91f5a8661b 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -46,8 +46,8 @@
 from .helpers import list_or_args
 
 if TYPE_CHECKING:
-    from redis.asyncio.client import Redis as AsyncRedis
-    from redis.client import Redis
+    import redis.asyncio.client
+    import redis.client
 
 
 class ACLCommands(CommandsProtocol):
@@ -731,16 +731,19 @@ def client_pause(self, timeout: int, all: bool = True, **kwargs) -> ResponseT:
 
         For more information see https://redis.io/commands/client-pause
 
-        :param timeout: milliseconds to pause clients
-        :param all: If true (default) all client commands are blocked.
-        otherwise, clients are only blocked if they attempt to execute
-        a write command.
+        Args:
+            timeout: milliseconds to pause clients
+            all: If true (default) all client commands are blocked.
+                 otherwise, clients are only blocked if they attempt to execute
+                 a write command.
+
         For the WRITE mode, some commands have special behavior:
-        EVAL/EVALSHA: Will block client for all scripts.
-        PUBLISH: Will block client.
-        PFCOUNT: Will block client.
-        WAIT: Acknowledgments will be delayed, so this command will
-        appear blocked.
+
+        * EVAL/EVALSHA: Will block client for all scripts.
+        * PUBLISH: Will block client.
+        * PFCOUNT: Will block client.
+        * WAIT: Acknowledgments will be delayed, so this command will
+            appear blocked.
         """
         args = ["CLIENT PAUSE", str(timeout)]
         if not isinstance(timeout, int):
@@ -1439,7 +1442,7 @@ class BitFieldOperation:
 
     def __init__(
         self,
-        client: Union["Redis", "AsyncRedis"],
+        client: Union["redis.client.Redis", "redis.asyncio.client.Redis"],
         key: str,
         default_overflow: Union[str, None] = None,
     ):
@@ -1583,7 +1586,7 @@ def bitcount(
         return self.execute_command("BITCOUNT", *params, keys=[key])
 
     def bitfield(
-        self: Union["Redis", "AsyncRedis"],
+        self: Union["redis.client.Redis", "redis.asyncio.client.Redis"],
         key: KeyT,
         default_overflow: Union[str, None] = None,
     ) -> BitFieldOperation:
@@ -1596,7 +1599,7 @@ def bitfield(
         return BitFieldOperation(self, key, default_overflow=default_overflow)
 
     def bitfield_ro(
-        self: Union["Redis", "AsyncRedis"],
+        self: Union["redis.client.Redis", "redis.asyncio.client.Redis"],
         key: KeyT,
         encoding: str,
         offset: BitfieldOffsetT,
@@ -5464,7 +5467,7 @@ class Script:
     An executable Lua script object returned by ``register_script``
     """
 
-    def __init__(self, registered_client: "Redis", script: ScriptTextT):
+    def __init__(self, registered_client: "redis.client.Redis", script: ScriptTextT):
         self.registered_client = registered_client
         self.script = script
         # Precalculate and store the SHA1 hex digest of the script.
@@ -5484,7 +5487,7 @@ def __call__(
         self,
         keys: Union[Sequence[KeyT], None] = None,
         args: Union[Iterable[EncodableT], None] = None,
-        client: Union["Redis", None] = None,
+        client: Union["redis.client.Redis", None] = None,
     ):
         """Execute the script, passing any required ``args``"""
         keys = keys or []
@@ -5513,7 +5516,11 @@ class AsyncScript:
     An executable Lua script object returned by ``register_script``
     """
 
-    def __init__(self, registered_client: "AsyncRedis", script: ScriptTextT):
+    def __init__(
+        self,
+        registered_client: "redis.asyncio.client.Redis",
+        script: ScriptTextT,
+    ):
         self.registered_client = registered_client
         self.script = script
         # Precalculate and store the SHA1 hex digest of the script.
@@ -5533,7 +5540,7 @@ async def __call__(
         self,
         keys: Union[Sequence[KeyT], None] = None,
         args: Union[Iterable[EncodableT], None] = None,
-        client: Union["AsyncRedis", None] = None,
+        client: Union["redis.asyncio.client.Redis", None] = None,
     ):
         """Execute the script, passing any required ``args``"""
         keys = keys or []
@@ -5758,7 +5765,7 @@ def script_load(self, script: ScriptTextT) -> ResponseT:
         """
         return self.execute_command("SCRIPT LOAD", script)
 
-    def register_script(self: "Redis", script: ScriptTextT) -> Script:
+    def register_script(self: "redis.client.Redis", script: ScriptTextT) -> Script:
         """
         Register a Lua ``script`` specifying the ``keys`` it will touch.
         Returns a Script object that is callable and hides the complexity of
@@ -5772,7 +5779,10 @@ class AsyncScriptCommands(ScriptCommands):
     async def script_debug(self, *args) -> None:
         return super().script_debug()
 
-    def register_script(self: "AsyncRedis", script: ScriptTextT) -> AsyncScript:
+    def register_script(
+        self: "redis.asyncio.client.Redis",
+        script: ScriptTextT,
+    ) -> AsyncScript:
         """
         Register a Lua ``script`` specifying the ``keys`` it will touch.
         Returns a Script object that is callable and hides the complexity of
@@ -6415,9 +6425,12 @@ def function_list(
     ) -> Union[Awaitable[List], List]:
         """
         Return information about the functions and libraries.
-        :param library: pecify a pattern for matching library names
-        :param withcode: cause the server to include the libraries source
-         implementation in the reply
+
+        Args:
+
+            library: specify a pattern for matching library names
+            withcode: cause the server to include the libraries source implementation
+                in the reply
         """
         args = ["LIBRARYNAME", library]
         if withcode:
diff --git a/redis/commands/timeseries/commands.py b/redis/commands/timeseries/commands.py
index f8dfe8b5c0..b0cb864237 100644
--- a/redis/commands/timeseries/commands.py
+++ b/redis/commands/timeseries/commands.py
@@ -60,17 +60,17 @@ def create(
             duplicate_policy:
                 Policy for handling multiple samples with identical timestamps. Can be
                 one of:
-                    - 'block': An error will occur and the new value will be ignored.
-                    - 'first': Ignore the new value.
-                    - 'last': Override with the latest value.
-                    - 'min': Only override if the value is lower than the existing
-                      value.
-                    - 'max': Only override if the value is higher than the existing
-                      value.
-                    - 'sum': If a previous sample exists, add the new sample to it so
-                      that the updated value is equal to (previous + new). If no
-                      previous sample exists, set the updated value equal to the new
-                      value.
+
+                - 'block': An error will occur and the new value will be ignored.
+                - 'first': Ignore the new value.
+                - 'last': Override with the latest value.
+                - 'min': Only override if the value is lower than the existing value.
+                - 'max': Only override if the value is higher than the existing value.
+                - 'sum': If a previous sample exists, add the new sample to it so
+                  that the updated value is equal to (previous + new). If no
+                  previous sample exists, set the updated value equal to the new
+                  value.
+
             ignore_max_time_diff:
                 A non-negative integer value, in milliseconds, that sets an ignore
                 threshold for added timestamps. If the difference between the last
@@ -130,17 +130,17 @@ def alter(
             duplicate_policy:
                 Policy for handling multiple samples with identical timestamps. Can be
                 one of:
-                    - 'block': An error will occur and the new value will be ignored.
-                    - 'first': Ignore the new value.
-                    - 'last': Override with the latest value.
-                    - 'min': Only override if the value is lower than the existing
-                      value.
-                    - 'max': Only override if the value is higher than the existing
-                      value.
-                    - 'sum': If a previous sample exists, add the new sample to it so
-                      that the updated value is equal to (previous + new). If no
-                      previous sample exists, set the updated value equal to the new
-                      value.
+
+                - 'block': An error will occur and the new value will be ignored.
+                - 'first': Ignore the new value.
+                - 'last': Override with the latest value.
+                - 'min': Only override if the value is lower than the existing value.
+                - 'max': Only override if the value is higher than the existing value.
+                - 'sum': If a previous sample exists, add the new sample to it so
+                  that the updated value is equal to (previous + new). If no
+                  previous sample exists, set the updated value equal to the new
+                  value.
+
             ignore_max_time_diff:
                 A non-negative integer value, in milliseconds, that sets an ignore
                 threshold for added timestamps. If the difference between the last
@@ -210,17 +210,17 @@ def add(
             duplicate_policy:
                 Policy for handling multiple samples with identical timestamps. Can be
                 one of:
-                    - 'block': An error will occur and the new value will be ignored.
-                    - 'first': Ignore the new value.
-                    - 'last': Override with the latest value.
-                    - 'min': Only override if the value is lower than the existing
-                      value.
-                    - 'max': Only override if the value is higher than the existing
-                      value.
-                    - 'sum': If a previous sample exists, add the new sample to it so
-                      that the updated value is equal to (previous + new). If no
-                      previous sample exists, set the updated value equal to the new
-                      value.
+
+                - 'block': An error will occur and the new value will be ignored.
+                - 'first': Ignore the new value.
+                - 'last': Override with the latest value.
+                - 'min': Only override if the value is lower than the existing value.
+                - 'max': Only override if the value is higher than the existing value.
+                - 'sum': If a previous sample exists, add the new sample to it so
+                  that the updated value is equal to (previous + new). If no
+                  previous sample exists, set the updated value equal to the new
+                  value.
+
             ignore_max_time_diff:
                 A non-negative integer value, in milliseconds, that sets an ignore
                 threshold for added timestamps. If the difference between the last
@@ -331,17 +331,17 @@ def incrby(
             duplicate_policy:
                 Policy for handling multiple samples with identical timestamps. Can be
                 one of:
-                    - 'block': An error will occur and the new value will be ignored.
-                    - 'first': Ignore the new value.
-                    - 'last': Override with the latest value.
-                    - 'min': Only override if the value is lower than the existing
-                      value.
-                    - 'max': Only override if the value is higher than the existing
-                      value.
-                    - 'sum': If a previous sample exists, add the new sample to it so
-                      that the updated value is equal to (previous + new). If no
-                      previous sample exists, set the updated value equal to the new
-                      value.
+
+                - 'block': An error will occur and the new value will be ignored.
+                - 'first': Ignore the new value.
+                - 'last': Override with the latest value.
+                - 'min': Only override if the value is lower than the existing value.
+                - 'max': Only override if the value is higher than the existing value.
+                - 'sum': If a previous sample exists, add the new sample to it so
+                  that the updated value is equal to (previous + new). If no
+                  previous sample exists, set the updated value equal to the new
+                  value.
+
             ignore_max_time_diff:
                 A non-negative integer value, in milliseconds, that sets an ignore
                 threshold for added timestamps. If the difference between the last
@@ -423,17 +423,17 @@ def decrby(
             duplicate_policy:
                 Policy for handling multiple samples with identical timestamps. Can be
                 one of:
-                    - 'block': An error will occur and the new value will be ignored.
-                    - 'first': Ignore the new value.
-                    - 'last': Override with the latest value.
-                    - 'min': Only override if the value is lower than the existing
-                      value.
-                    - 'max': Only override if the value is higher than the existing
-                      value.
-                    - 'sum': If a previous sample exists, add the new sample to it so
-                      that the updated value is equal to (previous + new). If no
-                      previous sample exists, set the updated value equal to the new
-                      value.
+
+                - 'block': An error will occur and the new value will be ignored.
+                - 'first': Ignore the new value.
+                - 'last': Override with the latest value.
+                - 'min': Only override if the value is lower than the existing value.
+                - 'max': Only override if the value is higher than the existing value.
+                - 'sum': If a previous sample exists, add the new sample to it so
+                  that the updated value is equal to (previous + new). If no
+                  previous sample exists, set the updated value equal to the new
+                  value.
+
             ignore_max_time_diff:
                 A non-negative integer value, in milliseconds, that sets an ignore
                 threshold for added timestamps. If the difference between the last

From c6faa6597e7f1e64bd8632dd999ed0afc3dd97bc Mon Sep 17 00:00:00 2001
From: Kurt McKee <contactme@kurtmckee.org>
Date: Mon, 2 Sep 2024 06:31:04 -0500
Subject: [PATCH 0921/1164] Ignore a coverage warning re: sysmon on Pythons <
 3.12 (#3334)

Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
---
 pytest.ini | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/pytest.ini b/pytest.ini
index 9db630e5b1..990968d6f9 100644
--- a/pytest.ini
+++ b/pytest.ini
@@ -14,3 +14,5 @@ timeout = 30
 filterwarnings =
     always
     ignore:RedisGraph support is deprecated as of Redis Stack 7.2:DeprecationWarning
+    # Ignore a coverage warning when COVERAGE_CORE=sysmon for Pythons < 3.12.
+    ignore:sys.monitoring isn't available:coverage.exceptions.CoverageWarning

From 93b9d8536190842185729b9bac68c7f89e4f32c5 Mon Sep 17 00:00:00 2001
From: Kurt McKee <contactme@kurtmckee.org>
Date: Mon, 2 Sep 2024 06:42:59 -0500
Subject: [PATCH 0922/1164] Delete the first-defined (and thus "duplicate")
 `Script` class (#3333)

The second definition was copied over the first definition,
with the following changes:

* The type annotations were copied to the second definition
* The mutable default arguments to the `keys` and `args` parameters
  were replaced with `None`, as is best-practice.

Closes #3332

Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
---
 CHANGES                |  1 +
 redis/commands/core.py | 80 ++++++++++--------------------------------
 2 files changed, 20 insertions(+), 61 deletions(-)

diff --git a/CHANGES b/CHANGES
index f0d75a45ce..8750128b05 100644
--- a/CHANGES
+++ b/CHANGES
@@ -66,6 +66,7 @@
     * Prevent async ClusterPipeline instances from becoming "false-y" in case of empty command stack (#3061)
     * Close Unix sockets if the connection attempt fails. This prevents `ResourceWarning`s. (#3314)
     * Close SSL sockets if the connection attempt fails, or if validations fail. (#3317)
+    * Eliminate mutable default arguments in the `redis.commands.core.Script` class. (#3332)
 
 * 4.1.3 (Feb 8, 2022)
   * Fix flushdb and flushall (#1926)
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 91f5a8661b..d46e55446c 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -5475,11 +5475,7 @@ def __init__(self, registered_client: "redis.client.Redis", script: ScriptTextT)
         if isinstance(script, str):
             # We need the encoding from the client in order to generate an
             # accurate byte representation of the script
-            try:
-                encoder = registered_client.connection_pool.get_encoder()
-            except AttributeError:
-                # Cluster
-                encoder = registered_client.get_encoder()
+            encoder = self.get_encoder()
             script = encoder.encode(script)
         self.sha = hashlib.sha1(script).hexdigest()
 
@@ -5510,6 +5506,24 @@ def __call__(
             self.sha = client.script_load(self.script)
             return client.evalsha(self.sha, len(keys), *args)
 
+    def get_encoder(self):
+        """Get the encoder to encode string scripts into bytes."""
+        try:
+            return self.registered_client.get_encoder()
+        except AttributeError:
+            # DEPRECATED
+            # In version <=4.1.2, this was the code we used to get the encoder.
+            # However, after 4.1.2 we added support for scripting in clustered
+            # redis. ClusteredRedis doesn't have a `.connection_pool` attribute
+            # so we changed the Script class to use
+            # `self.registered_client.get_encoder` (see above).
+            # However, that is technically a breaking change, as consumers who
+            # use Scripts directly might inject a `registered_client` that
+            # doesn't have a `.get_encoder` field. This try/except prevents us
+            # from breaking backward-compatibility. Ideally, it would be
+            # removed in the next major release.
+            return self.registered_client.connection_pool.get_encoder()
+
 
 class AsyncScript:
     """
@@ -6293,62 +6307,6 @@ def command(self) -> ResponseT:
         return self.execute_command("COMMAND")
 
 
-class Script:
-    """
-    An executable Lua script object returned by ``register_script``
-    """
-
-    def __init__(self, registered_client, script):
-        self.registered_client = registered_client
-        self.script = script
-        # Precalculate and store the SHA1 hex digest of the script.
-
-        if isinstance(script, str):
-            # We need the encoding from the client in order to generate an
-            # accurate byte representation of the script
-            encoder = self.get_encoder()
-            script = encoder.encode(script)
-        self.sha = hashlib.sha1(script).hexdigest()
-
-    def __call__(self, keys=[], args=[], client=None):
-        "Execute the script, passing any required ``args``"
-        if client is None:
-            client = self.registered_client
-        args = tuple(keys) + tuple(args)
-        # make sure the Redis server knows about the script
-        from redis.client import Pipeline
-
-        if isinstance(client, Pipeline):
-            # Make sure the pipeline can register the script before executing.
-            client.scripts.add(self)
-        try:
-            return client.evalsha(self.sha, len(keys), *args)
-        except NoScriptError:
-            # Maybe the client is pointed to a different server than the client
-            # that created this instance?
-            # Overwrite the sha just in case there was a discrepancy.
-            self.sha = client.script_load(self.script)
-            return client.evalsha(self.sha, len(keys), *args)
-
-    def get_encoder(self):
-        """Get the encoder to encode string scripts into bytes."""
-        try:
-            return self.registered_client.get_encoder()
-        except AttributeError:
-            # DEPRECATED
-            # In version <=4.1.2, this was the code we used to get the encoder.
-            # However, after 4.1.2 we added support for scripting in clustered
-            # redis. ClusteredRedis doesn't have a `.connection_pool` attribute
-            # so we changed the Script class to use
-            # `self.registered_client.get_encoder` (see above).
-            # However, that is technically a breaking change, as consumers who
-            # use Scripts directly might inject a `registered_client` that
-            # doesn't have a `.get_encoder` field. This try/except prevents us
-            # from breaking backward-compatibility. Ideally, it would be
-            # removed in the next major release.
-            return self.registered_client.connection_pool.get_encoder()
-
-
 class AsyncModuleCommands(ModuleCommands):
     async def command_info(self) -> None:
         return super().command_info()

From b4fcbaa1ea20bbf3997b81221556e06f7aae2017 Mon Sep 17 00:00:00 2001
From: Kurt McKee <contactme@kurtmckee.org>
Date: Mon, 2 Sep 2024 07:35:36 -0500
Subject: [PATCH 0923/1164] Catch a known `DeprecationWarning` when calling
 `.close()` (#3335)

Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
---
 tests/test_asyncio/test_cluster.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index c16272bb5b..fefa4ef8f9 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -313,7 +313,8 @@ async def mock_aclose():
             called += 1
 
         with mock.patch.object(cluster, "aclose", mock_aclose):
-            await cluster.close()
+            with pytest.warns(DeprecationWarning, match=r"Use aclose\(\) instead"):
+                await cluster.close()
             assert called == 1
         await cluster.aclose()
 

From 6c94faa827274ef3da2c7887d0a9c29b26b6a53f Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Wed, 4 Sep 2024 14:55:55 +0300
Subject: [PATCH 0924/1164] Update PyPy 3.8 to 3.10 in CI (#3370)

---
 .github/workflows/integration.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 5342238dd3..c4da3bf3aa 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -63,7 +63,7 @@ jobs:
       max-parallel: 15
       fail-fast: false
       matrix:
-        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12', 'pypy-3.8', 'pypy-3.9']
+        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12', 'pypy-3.9', 'pypy-3.10']
         test-type: ['standalone', 'cluster']
         connection-type: ['hiredis', 'plain']
     env:
@@ -184,7 +184,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12', 'pypy-3.8', 'pypy-3.9']
+        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12', 'pypy-3.9', 'pypy-3.10']
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5

From e00f3d2110f5b80c6ef37c3e3373c2bfb6ffb5f5 Mon Sep 17 00:00:00 2001
From: "Kirill A. Korinsky" <kirill@korins.ky>
Date: Wed, 4 Sep 2024 15:44:28 +0200
Subject: [PATCH 0925/1164] Add missed redismod at test_commands.py (#3369)

Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
---
 tests/test_commands.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/tests/test_commands.py b/tests/test_commands.py
index 02afab3c40..74e9c1c88e 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -4964,6 +4964,7 @@ def test_latency_latest(self, r: redis.Redis):
     def test_latency_reset(self, r: redis.Redis):
         assert r.latency_reset() == 0
 
+    @pytest.mark.redismod
     @skip_if_server_version_lt("4.0.0")
     @skip_if_redis_enterprise()
     def test_module_list(self, r):
@@ -5033,6 +5034,7 @@ def test_command_getkeysandflags(self, r: redis.Redis):
             [b"mylist2", [b"RW", b"insert"]],
         ]
 
+    @pytest.mark.redismod
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("4.0.0")
     @skip_if_redis_enterprise()
@@ -5045,6 +5047,7 @@ def test_module(self, stack_r):
             stack_r.module_load("/some/fake/path", "arg1", "arg2", "arg3", "arg4")
             assert "Error loading the extension." in str(excinfo.value)
 
+    @pytest.mark.redismod
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("7.0.0")
     @skip_if_redis_enterprise()

From 2fb40c10014c0b10fdb5005d0e7b5f2f4cdc1e00 Mon Sep 17 00:00:00 2001
From: David Dougherty <david.dougherty@redis.com>
Date: Fri, 6 Sep 2024 05:02:05 -0700
Subject: [PATCH 0926/1164] TCEs for select command pages (#3361)

Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
---
 doctests/cmds_generic.py    | 200 ++++++++++++++++++++++++++++++++++++
 doctests/cmds_hash.py       |  63 ++++++++++++
 doctests/cmds_sorted_set.py |  89 ++++++++++++++++
 doctests/cmds_string.py     |  19 ++++
 4 files changed, 371 insertions(+)
 create mode 100644 doctests/cmds_generic.py
 create mode 100644 doctests/cmds_hash.py
 create mode 100644 doctests/cmds_sorted_set.py
 create mode 100644 doctests/cmds_string.py

diff --git a/doctests/cmds_generic.py b/doctests/cmds_generic.py
new file mode 100644
index 0000000000..31f781f773
--- /dev/null
+++ b/doctests/cmds_generic.py
@@ -0,0 +1,200 @@
+# EXAMPLE: cmds_generic
+# HIDE_START
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+
+# STEP_START del
+res = r.set("key1", "Hello")
+print(res)
+# >>> True
+
+res = r.set("key2", "World")
+print(res)
+# >>> True
+
+res = r.delete("key1", "key2", "key3")
+print(res)
+# >>> 2
+# REMOVE_START
+assert res == 2
+# REMOVE_END
+# STEP_END
+
+# STEP_START expire
+res = r.set("mykey", "Hello")
+print(res)
+# >>> True
+
+res = r.expire("mykey", 10)
+print(res)
+# >>> True
+
+res = r.ttl("mykey")
+print(res)
+# >>> 10
+# REMOVE_START
+assert res == 10
+# REMOVE_END
+
+res = r.set("mykey", "Hello World")
+print(res)
+# >>> True
+
+res = r.ttl("mykey")
+print(res)
+# >>> -1
+# REMOVE_START
+assert res == -1
+# REMOVE_END
+
+res = r.expire("mykey", 10, xx=True)
+print(res)
+# >>> False
+# REMOVE_START
+assert res == False
+# REMOVE_END
+
+res = r.ttl("mykey")
+print(res)
+# >>> -1
+# REMOVE_START
+assert res == -1
+# REMOVE_END
+
+res = r.expire("mykey", 10, nx=True)
+print(res)
+# >>> True
+# REMOVE_START
+assert res == True
+# REMOVE_END
+
+res = r.ttl("mykey")
+print(res)
+# >>> 10
+# REMOVE_START
+assert res == 10
+r.delete("mykey")
+# REMOVE_END
+# STEP_END
+
+# STEP_START ttl
+res = r.set("mykey", "Hello")
+print(res)
+# >>> True
+
+res = r.expire("mykey", 10)
+print(res)
+# >>> True
+
+res = r.ttl("mykey")
+print(res)
+# >>> 10
+# REMOVE_START
+assert res == 10
+r.delete("mykey")
+# REMOVE_END
+# STEP_END
+
+# STEP_START scan1
+res = r.sadd("myset", *set([1, 2, 3, "foo", "foobar", "feelsgood"]))
+print(res)
+# >>> 6
+
+res = list(r.sscan_iter("myset", match="f*"))
+print(res)
+# >>> ['foobar', 'foo', 'feelsgood']
+# REMOVE_START
+assert sorted(res) == sorted(["foo", "foobar", "feelsgood"])
+r.delete("myset")
+# REMOVE_END
+# STEP_END
+
+# STEP_START scan2
+# REMOVE_START
+for i in range(1, 1001):
+    r.set(f"key:{i}", i)
+# REMOVE_END
+
+cursor, key = r.scan(cursor=0, match='*11*')
+print(cursor, key)
+
+cursor, key = r.scan(cursor, match='*11*')
+print(cursor, key)
+
+cursor, key = r.scan(cursor, match='*11*')
+print(cursor, key)
+
+cursor, key = r.scan(cursor, match='*11*')
+print(cursor, key)
+
+cursor, keys = r.scan(cursor, match='*11*', count=1000)
+print(cursor, keys)
+
+# REMOVE_START
+assert len(keys) == 18
+cursor = '0'
+prefix = "key:*"
+while cursor != 0:
+    cursor, keys = r.scan(cursor=cursor, match=prefix, count=1000)
+    if keys:
+        r.delete(*keys)
+# REMOVE_END
+# STEP_END
+
+# STEP_START scan3
+res = r.geoadd("geokey", (0, 0, "value"))
+print(res)
+# >>> 1
+
+res = r.zadd("zkey", {"value": 1000})
+print(res)
+# >>> 1
+
+res = r.type("geokey")
+print(res)
+# >>> zset
+# REMOVE_START
+assert res == "zset"
+# REMOVE_END
+
+res = r.type("zkey")
+print(res)
+# >>> zset
+# REMOVE_START
+assert res == "zset"
+# REMOVE_END
+
+cursor, keys = r.scan(cursor=0, _type="zset")
+print(keys)
+# >>> ['zkey', 'geokey']
+# REMOVE_START
+assert sorted(keys) == sorted(["zkey", "geokey"])
+r.delete("geokey", "zkey")
+# REMOVE_END
+# STEP_END
+
+# STEP_START scan4
+res = r.hset("myhash", mapping={"a": 1, "b": 2})
+print(res)
+# >>> 2
+
+cursor, keys = r.hscan("myhash", 0)
+print(keys)
+# >>> {'a': '1', 'b': '2'}
+# REMOVE_START
+assert keys == {'a': '1', 'b': '2'}
+# REMOVE_END
+
+cursor, keys = r.hscan("myhash", 0, no_values=True)
+print(keys)
+# >>> ['a', 'b']
+# REMOVE_START
+assert keys == ['a', 'b']
+# REMOVE_END
+
+# REMOVE_START
+r.delete("myhash")
+# REMOVE_END
+# STEP_END
diff --git a/doctests/cmds_hash.py b/doctests/cmds_hash.py
new file mode 100644
index 0000000000..0bc1cb8038
--- /dev/null
+++ b/doctests/cmds_hash.py
@@ -0,0 +1,63 @@
+# EXAMPLE: cmds_hash
+# HIDE_START
+import redis
+
+r = redis.Redis(host="localhost", port=6379, db=0, decode_responses=True)
+# HIDE_END
+
+# STEP_START hset
+res1 = r.hset("myhash", "field1", "Hello")
+print(res1)
+# >>> 1
+
+res2 = r.hget("myhash", "field1")
+print(res2)
+# >>> Hello
+
+res3 = r.hset("myhash", mapping={"field2": "Hi", "field3": "World"})
+print(res3)
+# >>> 2
+
+res4 = r.hget("myhash", "field2")
+print(res4)
+# >>> Hi
+
+res5 = r.hget("myhash", "field3")
+print(res5)
+# >>> World
+
+res6 = r.hgetall("myhash")
+print(res6)
+# >>> { "field1": "Hello", "field2": "Hi", "field3": "World" }
+
+# REMOVE_START
+assert res1 == 1
+assert res2 == "Hello"
+assert res3 == 2
+assert res4 == "Hi"
+assert res5 == "World"
+assert res6 == { "field1": "Hello", "field2": "Hi", "field3": "World" }
+r.delete("myhash")
+# REMOVE_END
+# STEP_END
+
+# STEP_START hget
+res7 = r.hset("myhash", "field1", "foo")
+print(res7)
+# >>> 1
+
+res8 = r.hget("myhash", "field1")
+print(res8)
+# >>> foo
+
+res9 = r.hget("myhash", "field2")
+print(res9)
+# >>> None
+
+# REMOVE_START
+assert res7 == 1
+assert res8 == "foo"
+assert res9 == None
+r.delete("myhash")
+# REMOVE_END
+# STEP_END
diff --git a/doctests/cmds_sorted_set.py b/doctests/cmds_sorted_set.py
new file mode 100644
index 0000000000..a566262e09
--- /dev/null
+++ b/doctests/cmds_sorted_set.py
@@ -0,0 +1,89 @@
+# EXAMPLE: cmds_sorted_set
+# HIDE_START
+import redis
+
+r = redis.Redis(host="localhost", port=6379, db=0, decode_responses=True)
+# HIDE_END
+
+# STEP_START zadd
+res = r.zadd("myzset", {"one": 1})
+print(res)
+# >>> 1
+# REMOVE_START
+assert res == 1
+# REMOVE_END
+
+res = r.zadd("myzset", {"uno": 1})
+print(res)
+# >>> 1
+# REMOVE_START
+assert res == 1
+# REMOVE_END
+
+res = r.zadd("myzset", {"two": 2, "three": 3})
+print(res)
+# >>> 2
+# REMOVE_START
+assert res == 2
+# REMOVE_END
+
+res = r.zrange("myzset", 0, -1, withscores=True)
+# >>> [('one', 1.0), ('uno', 1.0), ('two', 2.0), ('three', 3.0)]
+# REMOVE_START
+assert res == [('one', 1.0), ('uno', 1.0), ('two', 2.0), ('three', 3.0)]
+# REMOVE_END
+
+# REMOVE_START
+r.delete("myzset")
+# REMOVE_END
+# STEP_END
+
+# STEP_START zrange1
+res = r.zadd("myzset", {"one": 1, "two":2, "three":3})
+print(res)
+# >>> 3
+
+res = r.zrange("myzset", 0, -1)
+print(res)
+# >>> ['one', 'two', 'three']
+# REMOVE_START
+assert res == ['one', 'two', 'three']
+# REMOVE_END
+
+res = r.zrange("myzset", 2, 3)
+print(res)
+# >>> ['three']
+# REMOVE_START
+assert res == ['three']
+# REMOVE_END
+
+res = r.zrange("myzset", -2, -1)
+print(res)
+# >>> ['two', 'three']
+# REMOVE_START
+assert res == ['two', 'three']
+r.delete("myzset")
+# REMOVE_END
+# STEP_END
+
+# STEP_START zrange2
+res = r.zadd("myzset", {"one": 1, "two":2, "three":3})
+res = r.zrange("myzset", 0, 1, withscores=True)
+print(res)
+# >>> [('one', 1.0), ('two', 2.0)]
+# REMOVE_START
+assert res == [('one', 1.0), ('two', 2.0)]
+r.delete("myzset")
+# REMOVE_END
+# STEP_END
+
+# STEP_START zrange3
+res = r.zadd("myzset", {"one": 1, "two":2, "three":3})
+res = r.zrange("myzset", 2, 3, byscore=True, offset=1, num=1)
+print(res)
+# >>> ['three']
+# REMOVE_START
+assert res == ['three']
+r.delete("myzset")
+# REMOVE_END
+# STEP_END
diff --git a/doctests/cmds_string.py b/doctests/cmds_string.py
new file mode 100644
index 0000000000..e5663706a3
--- /dev/null
+++ b/doctests/cmds_string.py
@@ -0,0 +1,19 @@
+# EXAMPLE: cmds_string
+# HIDE_START
+import redis
+
+r = redis.Redis(host="localhost", port=6379, db=0, decode_responses=True)
+# HIDE_END
+
+# STEP_START incr
+res = r.set("mykey", "10")
+print(res)
+# >>> True
+res = r.incr("mykey")
+print(res)
+# >>> 11
+# REMOVE_START
+assert res == 11
+r.delete("mykey")
+# REMOVE_END
+# STEP_END

From cbb129d8a1876142f6c92b8d3c5ca23b4948ac94 Mon Sep 17 00:00:00 2001
From: TomerHekmati <72793005+TomerHekmati@users.noreply.github.com>
Date: Mon, 9 Sep 2024 13:48:40 +0300
Subject: [PATCH 0927/1164] Update README.md - mentioning redis 7.4 support
 (#3375)

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index ecd6cccd64..08eff587be 100644
--- a/README.md
+++ b/README.md
@@ -54,7 +54,7 @@ Looking for a high-level library to handle object mapping? See [redis-om-python]
 
 ## Supported Redis Versions
 
-The most recent version of this library supports redis version [5.0](https://github.com/redis/redis/blob/5.0/00-RELEASENOTES), [6.0](https://github.com/redis/redis/blob/6.0/00-RELEASENOTES), [6.2](https://github.com/redis/redis/blob/6.2/00-RELEASENOTES), [7.0](https://github.com/redis/redis/blob/7.0/00-RELEASENOTES) and [7.2](https://github.com/redis/redis/blob/7.2/00-RELEASENOTES).
+The most recent version of this library supports redis version [5.0](https://github.com/redis/redis/blob/5.0/00-RELEASENOTES), [6.0](https://github.com/redis/redis/blob/6.0/00-RELEASENOTES), [6.2](https://github.com/redis/redis/blob/6.2/00-RELEASENOTES), [7.0](https://github.com/redis/redis/blob/7.0/00-RELEASENOTES), [7.2](https://github.com/redis/redis/blob/7.2/00-RELEASENOTES) and [7.4](https://github.com/redis/redis/blob/7.4/00-RELEASENOTES).
 
 The table below highlights version compatibility of the most-recent library versions and redis versions.
 

From 0c8a98624ce48a030ecf9dbadd6ec522bd6bf1ad Mon Sep 17 00:00:00 2001
From: David Dougherty <dwdougherty@gmail.com>
Date: Wed, 11 Sep 2024 01:29:25 -0700
Subject: [PATCH 0928/1164] DOC-4194: add TCEs to the exact match query page
 (#3372)

---
 doctests/data/query_em.json     |  92 ++++++++++++++++++++++++
 doctests/data/query_vector.json | 123 ++++++++++++++++++++++++++++++++
 doctests/query_em.py            | 111 ++++++++++++++++++++++++++++
 3 files changed, 326 insertions(+)
 create mode 100644 doctests/data/query_em.json
 create mode 100644 doctests/data/query_vector.json
 create mode 100644 doctests/query_em.py

diff --git a/doctests/data/query_em.json b/doctests/data/query_em.json
new file mode 100644
index 0000000000..bcf908aaf8
--- /dev/null
+++ b/doctests/data/query_em.json
@@ -0,0 +1,92 @@
+[
+  {
+	  "pickup_zone": "POLYGON((-74.0610 40.7578, -73.9510 40.7578, -73.9510 40.6678, -74.0610 40.6678, -74.0610 40.7578))",
+	  "store_location": "-74.0060,40.7128",
+	  "brand": "Velorim",
+	  "model": "Jigger",
+	  "price": 270,
+	  "description": "Small and powerful, the Jigger is the best ride for the smallest of tikes! This is the tiniest kids’ pedal bike on the market available without a coaster brake, the Jigger is the vehicle of choice for the rare tenacious little rider raring to go.",
+	  "condition": "new"
+  },
+  {
+    "pickup_zone": "POLYGON((-118.2887 34.0972, -118.1987 34.0972, -118.1987 33.9872, -118.2887 33.9872, -118.2887 34.0972))",
+	  "store_location": "-118.2437,34.0522",
+	  "brand": "Bicyk",
+	  "model": "Hillcraft",
+	  "price": 1200,
+	  "description": "Kids want to ride with as little weight as possible. Especially on an incline! They may be at the age when a 27.5\" wheel bike is just too clumsy coming off a 24\" bike. The Hillcraft 26 is just the solution they need!",
+	  "condition": "used"
+  },
+  {
+    "pickup_zone": "POLYGON((-87.6848 41.9331, -87.5748 41.9331, -87.5748 41.8231, -87.6848 41.8231, -87.6848 41.9331))",
+	  "store_location": "-87.6298,41.8781",
+  	"brand": "Nord",
+  	"model": "Chook air 5",
+  	"price": 815,
+  	"description": "The Chook Air 5  gives kids aged six years and older a durable and uberlight mountain bike for their first experience on tracks and easy cruising through forests and fields. The lower  top tube makes it easy to mount and dismount in any situation, giving your kids greater safety on the trails.",
+  	"condition": "used"
+  },
+  {
+    "pickup_zone": "POLYGON((-80.2433 25.8067, -80.1333 25.8067, -80.1333 25.6967, -80.2433 25.6967, -80.2433 25.8067))",
+  	"store_location": "-80.1918,25.7617",
+  	"brand": "Eva",
+  	"model": "Eva 291",
+  	"price": 3400,
+  	"description": "The sister company to Nord, Eva launched in 2005 as the first and only women-dedicated bicycle brand. Designed by women for women, allEva bikes are optimized for the feminine physique using analytics from a body metrics database. If you like 29ers, try the Eva 291. It’s a brand new bike for 2022.. This full-suspension, cross-country ride has been designed for velocity. The 291 has 100mm of front and rear travel, a superlight aluminum frame and fast-rolling 29-inch wheels. Yippee!",
+  	"condition": "used"
+  },
+  {
+    "pickup_zone": "POLYGON((-122.4644 37.8199, -122.3544 37.8199, -122.3544 37.7099, -122.4644 37.7099, -122.4644 37.8199))",
+  	"store_location": "-122.4194,37.7749",
+  	"brand": "Noka Bikes",
+  	"model": "Kahuna",
+  	"price": 3200,
+  	"description": "Whether you want to try your hand at XC racing or are looking for a lively trail bike that's just as inspiring on the climbs as it is over rougher ground, the Wilder is one heck of a bike built specifically for short women. Both the frames and components have been tweaked to include a women’s saddle, different bars and unique colourway.",
+  	"condition": "used"
+  },
+  {
+    "pickup_zone": "POLYGON((-0.1778 51.5524, 0.0822 51.5524, 0.0822 51.4024, -0.1778 51.4024, -0.1778 51.5524))",
+    "store_location": "-0.1278,51.5074",
+    "brand": "Breakout",
+    "model": "XBN 2.1 Alloy",
+    "price": 810,
+    "description": "The XBN 2.1 Alloy is our entry-level road bike – but that’s not to say that it’s a basic machine. With an internal weld aluminium frame, a full carbon fork, and the slick-shifting Claris gears from Shimano’s, this is a bike which doesn’t break the bank and delivers craved performance.",
+    "condition": "new"
+  },
+  {
+    "pickup_zone": "POLYGON((2.1767 48.9016, 2.5267 48.9016, 2.5267 48.5516, 2.1767 48.5516, 2.1767 48.9016))",
+    "store_location": "2.3522,48.8566",
+    "brand": "ScramBikes",
+    "model": "WattBike",
+    "price": 2300,
+    "description": "The WattBike is the best e-bike for people who still feel young at heart. It has a Bafang 1000W mid-drive system and a 48V 17.5AH Samsung Lithium-Ion battery, allowing you to ride for more than 60 miles on one charge. It’s great for tackling hilly terrain or if you just fancy a more leisurely ride. With three working modes, you can choose between E-bike, assisted bicycle, and normal bike modes.",
+    "condition": "new"
+  },
+  {
+    "pickup_zone": "POLYGON((13.3260 52.5700, 13.6550 52.5700, 13.6550 52.2700, 13.3260 52.2700, 13.3260 52.5700))",
+    "store_location": "13.4050,52.5200",
+    "brand": "Peaknetic",
+    "model": "Secto",
+    "price": 430,
+    "description": "If you struggle with stiff fingers or a kinked neck or back after a few minutes on the road, this lightweight, aluminum bike alleviates those issues and allows you to enjoy the ride. From the ergonomic grips to the lumbar-supporting seat position, the Roll Low-Entry offers incredible comfort. The rear-inclined seat tube facilitates stability by allowing you to put a foot on the ground to balance at a stop, and the low step-over frame makes it accessible for all ability and mobility levels. The saddle is very soft, with a wide back to support your hip joints and a cutout in the center to redistribute that pressure. Rim brakes deliver satisfactory braking control, and the wide tires provide a smooth, stable ride on paved roads and gravel. Rack and fender mounts facilitate setting up the Roll Low-Entry as your preferred commuter, and the BMX-like handlebar offers space for mounting a flashlight, bell, or phone holder.",
+    "condition": "new"
+  },
+  {
+    "pickup_zone": "POLYGON((1.9450 41.4301, 2.4018 41.4301, 2.4018 41.1987, 1.9450 41.1987, 1.9450 41.4301))",
+    "store_location": "2.1734, 41.3851",
+    "brand": "nHill",
+    "model": "Summit",
+    "price": 1200,
+    "description": "This budget mountain bike from nHill performs well both on bike paths and on the trail. The fork with 100mm of travel absorbs rough terrain. Fat Kenda Booster tires give you grip in corners and on wet trails. The Shimano Tourney drivetrain offered enough gears for finding a comfortable pace to ride uphill, and the Tektro hydraulic disc brakes break smoothly. Whether you want an affordable bike that you can take to work, but also take trail in mountains on the weekends or you’re just after a stable, comfortable ride for the bike path, the Summit gives a good value for money.",
+    "condition": "new"
+  },
+  {
+    "pickup_zone": "POLYGON((12.4464 42.1028, 12.5464 42.1028, 12.5464 41.7028, 12.4464 41.7028, 12.4464 42.1028))",
+    "store_location": "12.4964,41.9028",
+    "model": "ThrillCycle",
+    "brand": "BikeShind",
+    "price": 815,
+    "description": "An artsy,  retro-inspired bicycle that’s as functional as it is pretty: The ThrillCycle steel frame offers a smooth ride. A 9-speed drivetrain has enough gears for coasting in the city, but we wouldn’t suggest taking it to the mountains. Fenders protect you from mud, and a rear basket lets you transport groceries, flowers and books. The ThrillCycle comes with a limited lifetime warranty, so this little guy will last you long past graduation.",
+    "condition": "refurbished"
+  }
+]
diff --git a/doctests/data/query_vector.json b/doctests/data/query_vector.json
new file mode 100644
index 0000000000..0d128bbedb
--- /dev/null
+++ b/doctests/data/query_vector.json
@@ -0,0 +1,123 @@
+[
+  {
+    "model": "Jigger",
+    "brand": "Velorim",
+    "price": 270,
+    "type": "Kids bikes",
+    "specs": {
+      "material": "aluminium",
+      "weight": "10"
+    },
+    "description": "Small and powerful, the Jigger is the best ride for the smallest of tikes! This is the tiniest kids’ pedal bike on the market available without a coaster brake, the Jigger is the vehicle of choice for the rare tenacious little rider raring to go. We say rare because this smokin’ little bike is not ideal for a nervous first-time rider, but it’s a true giddy up for a true speedster. The Jigger is a 12 inch lightweight kids bicycle and it will meet your little one’s need for speed. It’s a single speed bike that makes learning to pump pedals simple and intuitive. It even has  a handle in the bottom of the saddle so you can easily help your child during training!  The Jigger is among the most lightweight children’s bikes on the planet. It is designed so that 2-3 year-olds fit comfortably in a molded ride position that allows for efficient riding, balanced handling and agility. The Jigger’s frame design and gears work together so your buddingbiker can stand up out of the seat, stop rapidly, rip over trails and pump tracks. The Jigger’s is amazing on dirt or pavement. Your tike will speed down the bike path in no time. The Jigger will ship with a coaster brake. A freewheel kit is provided at no cost. "
+  },
+  {
+    "model": "Hillcraft",
+    "brand": "Bicyk",
+    "price": 1200,
+    "type": "Kids Mountain Bikes",
+    "specs": {
+      "material": "carbon",
+      "weight": "11"
+    },
+    "description": "Kids want to ride with as little weight as possible. Especially on an incline! They may be at the age when a 27.5\" wheel bike is just too clumsy coming off a 24\" bike. The Hillcraft 26 is just the solution they need! Imagine 120mm travel. Boost front/rear.  You have NOTHING to tweak because it is easy to assemble right out of the box. The Hillcraft 26 is an efficient trail trekking machine. Up or down does not matter - dominate the trails going both down and up with this amazing bike. The name Monarch comes from Monarch trail in Colorado where we love to ride.  It’s a highly technical, steep and rocky trail but the rip on the waydown is so fulfilling.  Don’t ride the trail on a hardtail! It is so much more fun on the full suspension Hillcraft!  Hit your local trail with the Hillcraft Monarch 26 to get to where you want to go.  "
+  },
+  {
+    "model": "Chook air 5",
+    "brand": "Nord",
+    "price": 815,
+    "type": "Kids Mountain Bikes",
+    "specs": {
+      "material": "alloy",
+      "weight": "9.1"
+    },
+    "description": "The Chook Air 5  gives kids aged six years and older a durable and uberlight mountain bike for their first experience on tracks and easy cruising through forests and fields. The lower  top tube makes it easy to mount and dismount in any situation, giving your kids greater safety on the trails. The Chook Air 5 is the perfect intro to mountain biking."
+  },
+  {
+    "model": "Eva 291",
+    "brand": "Eva",
+    "price": 3400,
+    "type": "Mountain Bikes",
+    "specs": {
+      "material": "carbon",
+      "weight": "9.1"
+    },
+    "description": "The sister company to Nord, Eva launched in 2005 as the first and only women-dedicated bicycle brand. Designed by women for women, allEva bikes are optimized for the feminine physique using analytics from a body metrics database. If you like 29ers, try the Eva 291. It’s a brand new bike for 2022.. This full-suspension, cross-country ride has been designed for velocity. The 291 has 100mm of front and rear travel, a superlight aluminum frame and fast-rolling 29-inch wheels. Yippee!"
+  },
+  {
+    "model": "Kahuna",
+    "brand": "Noka Bikes",
+    "price": 3200,
+    "type": "Mountain Bikes",
+    "specs": {
+      "material": "alloy",
+      "weight": "9.8"
+    },
+    "description": "Whether you want to try your hand at XC racing or are looking for a lively trail bike that's just as inspiring on the climbs as it is over rougher ground, the Wilder is one heck of a bike built specifically for short women. Both the frames and components have been tweaked to include a women’s saddle, different bars and unique colourway."
+  },
+  {
+    "model": "XBN 2.1 Alloy",
+    "brand": "Breakout",
+    "price": 810,
+    "type": "Road Bikes",
+    "specs": {
+      "material": "alloy",
+      "weight": "7.2"
+    },
+    "description": "The XBN 2.1 Alloy is our entry-level road bike – but that’s not to say that it’s a basic machine. With an internal weld aluminium frame, a full carbon fork, and the slick-shifting Claris gears from Shimano’s, this is a bike which doesn’t break the bank and delivers craved performance. The 6061 alloy frame is triple-butted which ensures a lighter weight and smoother ride. And it’s comfortable with dropped seat stays and the carbon fork. The carefully crafted 50-34 tooth chainset and 11-32 tooth cassette give an easy-on-the-legs bottom gear for climbing, and the high-quality Vittoria Zaffiro tires balance grip, rolling friction and puncture protection when coasting down the other side.  "
+  },
+  {
+    "model": "WattBike",
+    "brand": "ScramBikes",
+    "price": 2300,
+    "type": "eBikes",
+    "specs": {
+      "material": "alloy",
+      "weight": "15"
+    },
+    "description": "The WattBike is the best e-bike for people who still feel young at heart. It has a  Bafang 500 watt geared hub motor that can reach 20 miles per hour on both steep inclines and city streets. The lithium-ion battery, which gets nearly 40 miles per charge, has a lightweight form factor, making it easier for seniors to use. It comes fully assembled (no convoluted instructions!) and includes a sturdy helmet at no cost. The Plush saddle softens over time with use. The included Seatpost, however, is easily adjustable and adds to this bike’s fantastic rating for seniors, as do the hydraulic disc brakes from Tektro.  "
+  },
+  {
+    "model": "Soothe Electric bike",
+    "brand": "Peaknetic",
+    "price": 1950,
+    "type": "eBikes",
+    "specs": {
+      "material": "alloy",
+      "weight": "14.7"
+    },
+    "description": "The Soothe is an everyday electric bike, from the makers of Exercycle  bikes, that conveys style while you get around the city. The Soothe lives up to its name by keeping your posture upright and relaxed for the ride ahead, keeping those aches and pains from riding at bay. It includes a low-step frame , our memory foam seat, bump-resistant shocks and conveniently placed thumb throttle. "
+  },
+  {
+    "model": "Secto",
+    "brand": "Peaknetic",
+    "price": 430,
+    "type": "Commuter bikes",
+    "specs": {
+      "material": "aluminium",
+      "weight": "10.0"
+    },
+    "description": "If you struggle with stiff fingers or a kinked neck or back after a few minutes on the road, this lightweight, aluminum bike alleviates those issues and allows you to enjoy the ride. From the ergonomic grips to the lumbar-supporting seat position, the Roll Low-Entry offers incredible comfort. The rear-inclined seat tube facilitates stability by allowing you to put a foot on the ground to balance at a stop, and the low step-over frame makes it accessible for all ability and mobility levels. The saddle is very soft, with a wide back to support your hip joints and a cutout in the center to redistribute that pressure. Rim brakes deliver satisfactory braking control, and the wide tires provide a smooth, stable ride on paved roads and gravel. Rack and fender mounts facilitate setting up the Roll Low-Entry as your preferred commuter, and the BMX-like handlebar offers space for mounting a flashlight, bell, or phone holder."
+  },
+  {
+    "model": "Summit",
+    "brand": "nHill",
+    "price": 1200,
+    "type": "Mountain Bike",
+    "specs": {
+      "material": "alloy",
+      "weight": "11.3"
+    },
+    "description": "This budget mountain bike from nHill performs well both on bike paths and on the trail. The fork with 100mm of travel absorbs rough terrain. Fat Kenda Booster tires give you grip in corners and on wet trails. The Shimano Tourney drivetrain offered enough gears for finding a comfortable pace to ride uphill, and the Tektro hydraulic disc brakes break smoothly. Whether you want an affordable bike that you can take to work, but also take trail riding on the weekends or you’re just after a stable, comfortable ride for the bike path, the Summit gives a good value for money."
+  },
+  {
+    "model": "ThrillCycle",
+    "brand": "BikeShind",
+    "price": 815,
+    "type": "Commuter Bikes",
+    "specs": {
+      "material": "alloy",
+      "weight": "12.7"
+    },
+    "description": "An artsy,  retro-inspired bicycle that’s as functional as it is pretty: The ThrillCycle steel frame offers a smooth ride. A 9-speed drivetrain has enough gears for coasting in the city, but we wouldn’t suggest taking it to the mountains. Fenders protect you from mud, and a rear basket lets you transport groceries, flowers and books. The ThrillCycle comes with a limited lifetime warranty, so this little guy will last you long past graduation."
+  }
+]
\ No newline at end of file
diff --git a/doctests/query_em.py b/doctests/query_em.py
new file mode 100644
index 0000000000..a00ff11150
--- /dev/null
+++ b/doctests/query_em.py
@@ -0,0 +1,111 @@
+# EXAMPLE: query_em
+# HIDE_START
+import json
+import redis
+from redis.commands.json.path import Path
+from redis.commands.search.field import TextField, NumericField, TagField
+from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.query import NumericFilter, Query
+
+r = redis.Redis(decode_responses=True)
+
+# create index
+schema = (
+    TextField("$.description", as_name="description"),
+    NumericField("$.price", as_name="price"),
+    TagField("$.condition", as_name="condition"),
+)
+
+index = r.ft("idx:bicycle")
+index.create_index(
+    schema,
+    definition=IndexDefinition(prefix=["bicycle:"], index_type=IndexType.JSON),
+)
+
+# load data
+with open("data/query_em.json") as f:
+    bicycles = json.load(f)
+
+pipeline = r.pipeline(transaction=False)
+for bid, bicycle in enumerate(bicycles):
+    pipeline.json().set(f'bicycle:{bid}', Path.root_path(), bicycle)
+pipeline.execute()
+# HIDE_END
+
+# STEP_START em1
+res = index.search(Query("@price:[270 270]"))
+print(res.total)
+# >>> 1
+# REMOVE_START
+assert res.total == 1
+# REMOVE_END
+
+try:
+    res = index.search(Query("@price:[270]")) # not yet supported in redis-py
+    print(res.total)
+    # >>> 1
+    assert res.total == 1
+except:
+    print("'@price:[270]' syntax not yet supported.")
+
+try:
+    res = index.search(Query("@price==270")) # not yet supported in redis-py
+    print(res.total)
+    # >>> 1
+    assert res.total == 1
+except:
+    print("'@price==270' syntax not yet supported.")
+
+query = Query("*").add_filter(NumericFilter("price", 270, 270))
+res = index.search(query)
+print(res.total)
+# >>> 1
+# REMOVE_START
+assert res.total == 1
+# REMOVE_END
+# STEP_END
+
+# STEP_START em2
+res = index.search(Query("@condition:{new}"))
+print(res.total)
+# >>> 5
+# REMOVE_START
+assert res.total == 5
+# REMOVE_END
+# STEP_END
+
+# STEP_START em3
+schema = (
+    TagField("$.email", as_name="email")
+)
+
+idx_email = r.ft("idx:email")
+idx_email.create_index(
+    schema,
+    definition=IndexDefinition(prefix=["key:"], index_type=IndexType.JSON),
+)
+r.json().set('key:1', Path.root_path(), '{"email": "test@redis.com"}')
+
+try:
+    res = idx_email.search(Query("test@redis.com").dialect(2))
+    print(res)
+except:
+    print("'test@redis.com' syntax not yet supported.")
+# REMOVE_START
+r.ft("idx:email").dropindex(delete_documents=True)
+# REMOVE_END
+# STEP_END
+
+# STEP_START em4
+res = index.search(Query("@description:\"rough terrain\""))
+print(res.total)
+# >>> 1 (Result{1 total, docs: [Document {'id': 'bicycle:8'...)
+# REMOVE_START
+assert res.total == 1
+# REMOVE_END
+# STEP_END
+
+# REMOVE_START
+# destroy index and data
+r.ft("idx:bicycle").dropindex(delete_documents=True)
+# REMOVE_END

From 64d4bb8040718f8e5fa30481d0b7409ecb1b0d67 Mon Sep 17 00:00:00 2001
From: David Dougherty <dwdougherty@gmail.com>
Date: Wed, 11 Sep 2024 01:29:54 -0700
Subject: [PATCH 0929/1164] DOC-4194: add TCEs to the range query page (#3374)

---
 doctests/query_range.py | 79 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 79 insertions(+)
 create mode 100644 doctests/query_range.py

diff --git a/doctests/query_range.py b/doctests/query_range.py
new file mode 100644
index 0000000000..4ef957acfb
--- /dev/null
+++ b/doctests/query_range.py
@@ -0,0 +1,79 @@
+# EXAMPLE: query_range
+# HIDE_START
+import json
+import sys
+import redis
+from redis.commands.json.path import Path
+from redis.commands.search.field import TextField, NumericField, TagField
+from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.query import NumericFilter, Query
+
+r = redis.Redis(decode_responses=True)
+
+# create index
+schema = (
+    TextField("$.description", as_name="description"),
+    NumericField("$.price", as_name="price"),
+    TagField("$.condition", as_name="condition"),
+)
+
+index = r.ft("idx:bicycle")
+index.create_index(
+    schema,
+    definition=IndexDefinition(prefix=["bicycle:"], index_type=IndexType.JSON),
+)
+
+# load data
+with open("data/query_em.json") as f:
+    bicycles = json.load(f)
+
+pipeline = r.pipeline(transaction=False)
+for bid, bicycle in enumerate(bicycles):
+    pipeline.json().set(f'bicycle:{bid}', Path.root_path(), bicycle)
+pipeline.execute()
+# HIDE_END
+
+# STEP_START range1
+res = index.search(Query("@price:[500 1000]"))
+print(res.total)
+# >>> 3
+# REMOVE_START
+assert res.total == 3
+# REMOVE_END
+# STEP_END
+
+# STEP_START range2
+query = Query("*").add_filter(NumericFilter("price", 500, 1000))
+res = index.search(query)
+print(res.total)
+# >>> 3
+# REMOVE_START
+assert res.total == 3
+# REMOVE_END
+# STEP_END
+
+# STEP_START range3
+query = Query("*").add_filter(NumericFilter("price", "(1000", "+inf"))
+res = index.search(query)
+print(res.total)
+# >>> 5
+# REMOVE_START
+assert res.total == 5
+# REMOVE_END
+# STEP_END
+
+# STEP_START range4
+query = Query('@price:[-inf 2000]').sort_by('price').paging(0, 5)
+res = index.search(query)
+print(res.total)
+print(res)
+# >>> Result{7 total, docs: [Document {'id': 'bicycle:0', ... }, Document {'id': 'bicycle:7', ... }, Document {'id': 'bicycle:5', ... }, ...]
+# REMOVE_START
+assert res.total == 7
+# REMOVE_END
+# STEP_END
+
+# REMOVE_START
+# destroy index and data
+r.ft("idx:bicycle").dropindex(delete_documents=True)
+# REMOVE_END

From c7483b3d63a2001508a2ff2c9952ad50d9252732 Mon Sep 17 00:00:00 2001
From: David Dougherty <dwdougherty@gmail.com>
Date: Thu, 12 Sep 2024 00:37:17 -0700
Subject: [PATCH 0930/1164] DOC-4196: add TCEs to the full-text query page
 (#3377)

---
 doctests/query_ft.py | 84 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 84 insertions(+)
 create mode 100644 doctests/query_ft.py

diff --git a/doctests/query_ft.py b/doctests/query_ft.py
new file mode 100644
index 0000000000..182a5b2bd3
--- /dev/null
+++ b/doctests/query_ft.py
@@ -0,0 +1,84 @@
+# EXAMPLE: query_ft
+# HIDE_START
+import json
+import sys
+import redis
+from redis.commands.json.path import Path
+from redis.commands.search.field import TextField, NumericField, TagField
+from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.query import NumericFilter, Query
+
+r = redis.Redis(decode_responses=True)
+
+# create index
+schema = (
+    TextField("$.brand", as_name="brand"),
+    TextField("$.model", as_name="model"),
+    TextField("$.description", as_name="description"),
+)
+
+index = r.ft("idx:bicycle")
+index.create_index(
+    schema,
+    definition=IndexDefinition(prefix=["bicycle:"], index_type=IndexType.JSON),
+)
+
+# load data
+with open("data/query_em.json") as f:
+    bicycles = json.load(f)
+
+pipeline = r.pipeline(transaction=False)
+for bid, bicycle in enumerate(bicycles):
+    pipeline.json().set(f'bicycle:{bid}', Path.root_path(), bicycle)
+pipeline.execute()
+# HIDE_END
+
+# STEP_START ft1
+res = index.search(Query("@description: kids"))
+print(res.total)
+# >>> 2
+# REMOVE_START
+assert res.total == 2
+# REMOVE_END
+# STEP_END
+
+# STEP_START ft2
+res = index.search(Query("@model: ka*"))
+print(res.total)
+# >>> 1
+# REMOVE_START
+assert res.total == 1
+# REMOVE_END
+# STEP_END
+
+# STEP_START ft3
+res = index.search(Query("@brand: *bikes"))
+print(res.total)
+# >>> 2
+# REMOVE_START
+assert res.total == 2
+# REMOVE_END
+# STEP_END
+
+# STEP_START ft4
+res = index.search(Query("%optamized%"))
+print(res)
+# >>> Result{1 total, docs: [Document {'id': 'bicycle:3', 'payload': None, 'json': '{"pickup_zone":"POLYGON((-80.2433 25.8067, -80.1333 25.8067, -80.1333 25.6967, -80.2433 25.6967, -80.2433 25.8067))","store_location":"-80.1918,25.7617","brand":"Eva","model":"Eva 291","price":3400,"description":"The sister company to Nord, Eva launched in 2005 as the first and only women-dedicated bicycle brand. Designed by women for women, allEva bikes are optimized for the feminine physique using analytics from a body metrics database. If you like 29ers, try the Eva 291. It’s a brand new bike for 2022.. This full-suspension, cross-country ride has been designed for velocity. The 291 has 100mm of front and rear travel, a superlight aluminum frame and fast-rolling 29-inch wheels. Yippee!","condition":"used"}'}]}
+# REMOVE_START
+assert res.total == 1
+# REMOVE_END
+# STEP_END
+
+# STEP_START ft5
+res = index.search(Query("%%optamised%%"))
+print(res)
+# >>> Result{1 total, docs: [Document {'id': 'bicycle:3', 'payload': None, 'json': '{"pickup_zone":"POLYGON((-80.2433 25.8067, -80.1333 25.8067, -80.1333 25.6967, -80.2433 25.6967, -80.2433 25.8067))","store_location":"-80.1918,25.7617","brand":"Eva","model":"Eva 291","price":3400,"description":"The sister company to Nord, Eva launched in 2005 as the first and only women-dedicated bicycle brand. Designed by women for women, allEva bikes are optimized for the feminine physique using analytics from a body metrics database. If you like 29ers, try the Eva 291. It’s a brand new bike for 2022.. This full-suspension, cross-country ride has been designed for velocity. The 291 has 100mm of front and rear travel, a superlight aluminum frame and fast-rolling 29-inch wheels. Yippee!","condition":"used"}'}]}
+# REMOVE_START
+assert res.total == 1
+# REMOVE_END
+# STEP_END
+
+# REMOVE_START
+# destroy index and data
+r.ft("idx:bicycle").dropindex(delete_documents=True)
+# REMOVE_END

From 7d73d742d6df4b3d6f6a1f0ec73e72d4a02add74 Mon Sep 17 00:00:00 2001
From: David Dougherty <dwdougherty@gmail.com>
Date: Thu, 12 Sep 2024 00:37:53 -0700
Subject: [PATCH 0931/1164] DOC-4197: add TCEs to the geospatial query page
 (#3378)

---
 doctests/query_geo.py | 69 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 doctests/query_geo.py

diff --git a/doctests/query_geo.py b/doctests/query_geo.py
new file mode 100644
index 0000000000..dcb7db6ee7
--- /dev/null
+++ b/doctests/query_geo.py
@@ -0,0 +1,69 @@
+# EXAMPLE: query_geo
+# HIDE_START
+import json
+import sys
+import redis
+from redis.commands.json.path import Path
+from redis.commands.search.field import GeoField, GeoShapeField
+from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.query import Query
+
+r = redis.Redis(decode_responses=True)
+
+# create index
+schema = (
+    GeoField("$.store_location", as_name="store_location"),
+    GeoShapeField("$.pickup_zone", coord_system=GeoShapeField.FLAT, as_name="pickup_zone")
+)
+
+index = r.ft("idx:bicycle")
+index.create_index(
+    schema,
+    definition=IndexDefinition(prefix=["bicycle:"], index_type=IndexType.JSON),
+)
+
+# load data
+with open("data/query_em.json") as f:
+    bicycles = json.load(f)
+
+pipeline = r.pipeline(transaction=False)
+for bid, bicycle in enumerate(bicycles):
+    pipeline.json().set(f'bicycle:{bid}', Path.root_path(), bicycle)
+pipeline.execute()
+# HIDE_END
+
+# STEP_START geo1
+params_dict = {"lon": -0.1778, "lat": 51.5524, "radius": 20, "units": "mi"}
+q = Query("@store_location:[$lon $lat $radius $units]").dialect(2)
+res = index.search(q, query_params=params_dict)
+print(res)
+# >>> Result{1 total, docs: [Document {'id': 'bicycle:5', ...
+# REMOVE_START
+assert res.total == 1
+# REMOVE_END
+# STEP_END
+
+# STEP_START geo2
+params_dict = {"bike": "POINT(-0.1278 51.5074)"}
+q = Query("@pickup_zone:[CONTAINS $bike]").dialect(3)
+res = index.search(q, query_params=params_dict)
+print(res.total) # >>> 1
+# REMOVE_START
+assert res.total == 1
+# REMOVE_END
+# STEP_END
+
+# STEP_START geo3
+params_dict = {"europe": "POLYGON((-25 35, 40 35, 40 70, -25 70, -25 35))"}
+q = Query("@pickup_zone:[WITHIN $europe]").dialect(3)
+res = index.search(q, query_params=params_dict)
+print(res.total) # >>> 5
+# REMOVE_START
+assert res.total == 5
+# REMOVE_END
+# STEP_END
+
+# REMOVE_START
+# destroy index and data
+r.ft("idx:bicycle").dropindex(delete_documents=True)
+# REMOVE_END

From 2e46613dcdf9db7f948f3258fee1c9199da8cbfa Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Fri, 27 Sep 2024 14:16:16 +0300
Subject: [PATCH 0932/1164] Client side caching refactoring (#3350)

* Restructure client side caching code

Right now the client side caching code is implemented mostly on the
level of Connections, which is too low. We need to have a shared cache
across several connections.

Move the cache implementation higher, while trying to encapsulate it
better, into a `CacheMixin` class.

This is work in progress, many details still need to be taken care of!

* Temporary refactor

* Finished CacheProxyConnection implementation, added comments

* Added test cases and scheduler dependency

* Added support for RedisCluster and multi-threaded test cases

* Added support for BlockingConnectionPool

* Fixed docker-compose command

* Revert port changes

* Initial take on Sentinel support

* Remove keys option after usage

* Added condition to remove keys entry on async

* Added same keys entry removal in pipeline

* Added caching support for Sentinel

* Added locking when accesing cache object

* Rmoved keys option from options

* Removed redundant entities

* Added cache support for SSLConnection

* Moved ssl argument handling to cover cluster case

* Revert local test changes

* Fixed bug with missing async operator

* Revert accidental changes

* Added API to return cache object

* Added eviction policy configuration

* Added mark to skip test on cluster

* Removed test case that makes no sense

* Skip tests in RESP2

* Added scheduler to dev_requirements

* Codestyle changes

* Fixed characters per line restriction

* Fixed line length

* Removed blank lines in imports

* Fixed imports codestyle

* Added CacheInterface abstraction

* Removed redundant references

* Moved hardcoded values to constants, restricted dependency versions

* Changed defaults to correct values

* Added custom background scheduler, added unit testing

* Codestyle changes

* Updated RESP2 restriction

* Cahnged typing to more generic

* Restrict pytest-asyncio version to 0.23

* Added upper version limit

* Removed usntable multithreaded tests

* Removed more flacky multithreaded tests

* Fixed issue with Sentinel killing healthcheck thread before execution

* Removed cachetools dependency, added custom cache implementation

* Updated test cases

* Updated typings

* Updated types

* Revert changes

* Removed use_cache, make health_check configurable, removed retry logic around can_read()

* Revert test skip

* Added documentation and codestyle fixes

* Updated excluded wordlist

* Added health_check thread cancelling in BlockingPool

* Revert argument rename, extended documentation

* Updated NodesManager to create shared cache between all nodes

* Codestyle fixes

* Updated docs

* Added version restrictions

* Added missing property getter

* Updated Redis server version

* Skip on long exception message

* Removed keys entry as it's csc specific

* Updated exception message for CSC

* Updated condition by adding server name check

* Added test coverage for decoded responses

* Codestyle changes

* Removed background healthcheck, use connection reference approach instead

* Removed unused imports

* Fixed broken tests

* Codestyle changes

* Fixed additional broken tests

* Codestyle changes

* Increased timer to avoid flackiness

* Restrict tests cause of PyPy

* Codestyle changes

* Updated docs, convert getters function to properties, added dataclasses

---------

Co-authored-by: Gabriel Erzse <gabriel.erzse@redis.com>
---
 .github/wordlist.txt                    |    1 +
 .github/workflows/integration.yaml      |    2 +-
 dev_requirements.txt                    |    1 -
 docs/examples/connection_examples.ipynb |    2 -
 docs/resp3_features.rst                 |   32 +
 redis/_cache.py                         |  385 ------
 redis/_parsers/resp3.py                 |   48 +-
 redis/asyncio/client.py                 |   75 +-
 redis/asyncio/cluster.py                |   86 +-
 redis/asyncio/connection.py             |  119 +-
 redis/asyncio/sentinel.py               |    1 -
 redis/cache.py                          |  401 ++++++
 redis/client.py                         |   89 +-
 redis/cluster.py                        |  103 +-
 redis/commands/core.py                  |    6 +-
 redis/connection.py                     |  465 +++++--
 redis/sentinel.py                       |   11 +-
 redis/utils.py                          |   39 +
 requirements.txt                        |    2 +-
 tests/conftest.py                       |   67 +-
 tests/test_asyncio/conftest.py          |    1 -
 tests/test_asyncio/test_cache.py        |  408 ------
 tests/test_asyncio/test_cluster.py      |    2 -
 tests/test_asyncio/test_connection.py   |    1 -
 tests/test_asyncio/test_hash.py         |    2 +-
 tests/test_asyncio/test_pubsub.py       |    2 +-
 tests/test_cache.py                     | 1500 ++++++++++++++++-------
 tests/test_cluster.py                   |   11 +-
 tests/test_connection.py                |  221 +++-
 tests/test_utils.py                     |   27 +
 30 files changed, 2344 insertions(+), 1766 deletions(-)
 delete mode 100644 redis/_cache.py
 create mode 100644 redis/cache.py
 delete mode 100644 tests/test_asyncio/test_cache.py
 create mode 100644 tests/test_utils.py

diff --git a/.github/wordlist.txt b/.github/wordlist.txt
index ca2102b825..3ea543748e 100644
--- a/.github/wordlist.txt
+++ b/.github/wordlist.txt
@@ -1,6 +1,7 @@
 APM
 ARGV
 BFCommands
+CacheImpl
 CFCommands
 CMSCommands
 ClusterNode
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index c4da3bf3aa..b10edf2fb4 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -27,7 +27,7 @@ env:
   CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
   # this speeds up coverage with Python 3.12: https://github.com/nedbat/coveragepy/issues/1665
   COVERAGE_CORE: sysmon
-  REDIS_IMAGE: redis:7.4-rc2
+  REDIS_IMAGE: redis:latest
   REDIS_STACK_IMAGE: redis/redis-stack-server:latest
 
 jobs:
diff --git a/dev_requirements.txt b/dev_requirements.txt
index 931784cdaf..37a107d16d 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -1,5 +1,4 @@
 black==24.3.0
-cachetools
 click==8.0.4
 flake8-isort
 flake8
diff --git a/docs/examples/connection_examples.ipynb b/docs/examples/connection_examples.ipynb
index cddded2865..fd60e2a495 100644
--- a/docs/examples/connection_examples.ipynb
+++ b/docs/examples/connection_examples.ipynb
@@ -69,9 +69,7 @@
   },
   {
    "cell_type": "markdown",
-   "execution_count": null,
    "metadata": {},
-   "outputs": [],
    "source": [
     "### By default this library uses the RESP 2 protocol. To enable RESP3, set protocol=3."
    ]
diff --git a/docs/resp3_features.rst b/docs/resp3_features.rst
index 11c01985a0..326495b775 100644
--- a/docs/resp3_features.rst
+++ b/docs/resp3_features.rst
@@ -67,3 +67,35 @@ This means that should you want to perform something, on a given push notificati
     >> p = r.pubsub(push_handler_func=our_func)
 
 In the example above, upon receipt of a push notification, rather than log the message, in the case where specific text occurs, an IOError is raised. This example, highlights how one could start implementing a customized message handler.
+
+Client-side caching
+-------------------
+
+Client-side caching is a technique used to create high performance services.
+It utilizes the memory on application servers, typically separate from the database nodes, to cache a subset of the data directly on the application side.
+For more information please check `official Redis documentation <https://redis.io/docs/latest/develop/use/client-side-caching/>`_.
+Please notice that this feature only available with RESP3 protocol enabled in sync client only. Supported in standalone, Cluster and Sentinel clients.
+
+Basic usage:
+
+Enable caching with default configuration:
+
+.. code:: python
+
+    >>> import redis
+    >>> from redis.cache import CacheConfig
+    >>> r = redis.Redis(host='localhost', port=6379, protocol=3, cache_config=CacheConfig())
+
+The same interface applies to Redis Cluster and Sentinel.
+
+Enable caching with custom cache implementation:
+
+.. code:: python
+
+    >>> import redis
+    >>> from foo.bar import CacheImpl
+    >>> r = redis.Redis(host='localhost', port=6379, protocol=3, cache=CacheImpl())
+
+CacheImpl should implement a `CacheInterface` specified in `redis.cache` package.
+
+More comprehensive documentation soon will be available at `official Redis documentation <https://redis.io/docs/latest/>`_.
diff --git a/redis/_cache.py b/redis/_cache.py
deleted file mode 100644
index 90288383d6..0000000000
--- a/redis/_cache.py
+++ /dev/null
@@ -1,385 +0,0 @@
-import copy
-import random
-import time
-from abc import ABC, abstractmethod
-from collections import OrderedDict, defaultdict
-from enum import Enum
-from typing import List, Sequence, Union
-
-from redis.typing import KeyT, ResponseT
-
-
-class EvictionPolicy(Enum):
-    LRU = "lru"
-    LFU = "lfu"
-    RANDOM = "random"
-
-
-DEFAULT_EVICTION_POLICY = EvictionPolicy.LRU
-
-DEFAULT_DENY_LIST = [
-    "BF.CARD",
-    "BF.DEBUG",
-    "BF.EXISTS",
-    "BF.INFO",
-    "BF.MEXISTS",
-    "BF.SCANDUMP",
-    "CF.COMPACT",
-    "CF.COUNT",
-    "CF.DEBUG",
-    "CF.EXISTS",
-    "CF.INFO",
-    "CF.MEXISTS",
-    "CF.SCANDUMP",
-    "CMS.INFO",
-    "CMS.QUERY",
-    "DUMP",
-    "EXPIRETIME",
-    "FT.AGGREGATE",
-    "FT.ALIASADD",
-    "FT.ALIASDEL",
-    "FT.ALIASUPDATE",
-    "FT.CURSOR",
-    "FT.EXPLAIN",
-    "FT.EXPLAINCLI",
-    "FT.GET",
-    "FT.INFO",
-    "FT.MGET",
-    "FT.PROFILE",
-    "FT.SEARCH",
-    "FT.SPELLCHECK",
-    "FT.SUGGET",
-    "FT.SUGLEN",
-    "FT.SYNDUMP",
-    "FT.TAGVALS",
-    "FT._ALIASADDIFNX",
-    "FT._ALIASDELIFX",
-    "HRANDFIELD",
-    "JSON.DEBUG",
-    "PEXPIRETIME",
-    "PFCOUNT",
-    "PTTL",
-    "SRANDMEMBER",
-    "TDIGEST.BYRANK",
-    "TDIGEST.BYREVRANK",
-    "TDIGEST.CDF",
-    "TDIGEST.INFO",
-    "TDIGEST.MAX",
-    "TDIGEST.MIN",
-    "TDIGEST.QUANTILE",
-    "TDIGEST.RANK",
-    "TDIGEST.REVRANK",
-    "TDIGEST.TRIMMED_MEAN",
-    "TOPK.INFO",
-    "TOPK.LIST",
-    "TOPK.QUERY",
-    "TOUCH",
-    "TTL",
-]
-
-DEFAULT_ALLOW_LIST = [
-    "BITCOUNT",
-    "BITFIELD_RO",
-    "BITPOS",
-    "EXISTS",
-    "GEODIST",
-    "GEOHASH",
-    "GEOPOS",
-    "GEORADIUSBYMEMBER_RO",
-    "GEORADIUS_RO",
-    "GEOSEARCH",
-    "GET",
-    "GETBIT",
-    "GETRANGE",
-    "HEXISTS",
-    "HGET",
-    "HGETALL",
-    "HKEYS",
-    "HLEN",
-    "HMGET",
-    "HSTRLEN",
-    "HVALS",
-    "JSON.ARRINDEX",
-    "JSON.ARRLEN",
-    "JSON.GET",
-    "JSON.MGET",
-    "JSON.OBJKEYS",
-    "JSON.OBJLEN",
-    "JSON.RESP",
-    "JSON.STRLEN",
-    "JSON.TYPE",
-    "LCS",
-    "LINDEX",
-    "LLEN",
-    "LPOS",
-    "LRANGE",
-    "MGET",
-    "SCARD",
-    "SDIFF",
-    "SINTER",
-    "SINTERCARD",
-    "SISMEMBER",
-    "SMEMBERS",
-    "SMISMEMBER",
-    "SORT_RO",
-    "STRLEN",
-    "SUBSTR",
-    "SUNION",
-    "TS.GET",
-    "TS.INFO",
-    "TS.RANGE",
-    "TS.REVRANGE",
-    "TYPE",
-    "XLEN",
-    "XPENDING",
-    "XRANGE",
-    "XREAD",
-    "XREVRANGE",
-    "ZCARD",
-    "ZCOUNT",
-    "ZDIFF",
-    "ZINTER",
-    "ZINTERCARD",
-    "ZLEXCOUNT",
-    "ZMSCORE",
-    "ZRANGE",
-    "ZRANGEBYLEX",
-    "ZRANGEBYSCORE",
-    "ZRANK",
-    "ZREVRANGE",
-    "ZREVRANGEBYLEX",
-    "ZREVRANGEBYSCORE",
-    "ZREVRANK",
-    "ZSCORE",
-    "ZUNION",
-]
-
-_RESPONSE = "response"
-_KEYS = "keys"
-_CTIME = "ctime"
-_ACCESS_COUNT = "access_count"
-
-
-class AbstractCache(ABC):
-    """
-    An abstract base class for client caching implementations.
-    If you want to implement your own cache you must support these methods.
-    """
-
-    @abstractmethod
-    def set(
-        self,
-        command: Union[str, Sequence[str]],
-        response: ResponseT,
-        keys_in_command: List[KeyT],
-    ):
-        pass
-
-    @abstractmethod
-    def get(self, command: Union[str, Sequence[str]]) -> ResponseT:
-        pass
-
-    @abstractmethod
-    def delete_command(self, command: Union[str, Sequence[str]]):
-        pass
-
-    @abstractmethod
-    def delete_commands(self, commands: List[Union[str, Sequence[str]]]):
-        pass
-
-    @abstractmethod
-    def flush(self):
-        pass
-
-    @abstractmethod
-    def invalidate_key(self, key: KeyT):
-        pass
-
-
-class _LocalCache(AbstractCache):
-    """
-    A caching mechanism for storing redis commands and their responses.
-
-    Args:
-        max_size (int): The maximum number of commands to be stored in the cache.
-        ttl (int): The time-to-live for each command in seconds.
-        eviction_policy (EvictionPolicy): The eviction policy to use for removing commands when the cache is full.
-
-    Attributes:
-        max_size (int): The maximum number of commands to be stored in the cache.
-        ttl (int): The time-to-live for each command in seconds.
-        eviction_policy (EvictionPolicy): The eviction policy used for cache management.
-        cache (OrderedDict): The ordered dictionary to store commands and their metadata.
-        key_commands_map (defaultdict): A mapping of keys to the set of commands that use each key.
-        commands_ttl_list (list): A list to keep track of the commands in the order they were added.  # noqa
-    """
-
-    def __init__(
-        self,
-        max_size: int = 10000,
-        ttl: int = 0,
-        eviction_policy: EvictionPolicy = DEFAULT_EVICTION_POLICY,
-    ):
-        self.max_size = max_size
-        self.ttl = ttl
-        self.eviction_policy = eviction_policy
-        self.cache = OrderedDict()
-        self.key_commands_map = defaultdict(set)
-        self.commands_ttl_list = []
-
-    def set(
-        self,
-        command: Union[str, Sequence[str]],
-        response: ResponseT,
-        keys_in_command: List[KeyT],
-    ):
-        """
-        Set a redis command and its response in the cache.
-
-        Args:
-            command (Union[str, Sequence[str]]): The redis command.
-            response (ResponseT): The response associated with the command.
-            keys_in_command (List[KeyT]): The list of keys used in the command.
-        """
-        if len(self.cache) >= self.max_size:
-            self._evict()
-        self.cache[command] = {
-            _RESPONSE: response,
-            _KEYS: keys_in_command,
-            _CTIME: time.monotonic(),
-            _ACCESS_COUNT: 0,  # Used only for LFU
-        }
-        self._update_key_commands_map(keys_in_command, command)
-        self.commands_ttl_list.append(command)
-
-    def get(self, command: Union[str, Sequence[str]]) -> ResponseT:
-        """
-        Get the response for a redis command from the cache.
-
-        Args:
-            command (Union[str, Sequence[str]]): The redis command.
-
-        Returns:
-            ResponseT: The response associated with the command, or None if the command is not in the cache.  # noqa
-        """
-        if command in self.cache:
-            if self._is_expired(command):
-                self.delete_command(command)
-                return
-            self._update_access(command)
-            return copy.deepcopy(self.cache[command]["response"])
-
-    def delete_command(self, command: Union[str, Sequence[str]]):
-        """
-        Delete a redis command and its metadata from the cache.
-
-        Args:
-            command (Union[str, Sequence[str]]): The redis command to be deleted.
-        """
-        if command in self.cache:
-            keys_in_command = self.cache[command].get("keys")
-            self._del_key_commands_map(keys_in_command, command)
-            self.commands_ttl_list.remove(command)
-            del self.cache[command]
-
-    def delete_commands(self, commands: List[Union[str, Sequence[str]]]):
-        """
-        Delete multiple commands and their metadata from the cache.
-
-        Args:
-            commands (List[Union[str, Sequence[str]]]): The list of commands to be
-            deleted.
-        """
-        for command in commands:
-            self.delete_command(command)
-
-    def flush(self):
-        """Clear the entire cache, removing all redis commands and metadata."""
-        self.cache.clear()
-        self.key_commands_map.clear()
-        self.commands_ttl_list = []
-
-    def _is_expired(self, command: Union[str, Sequence[str]]) -> bool:
-        """
-        Check if a redis command has expired based on its time-to-live.
-
-        Args:
-            command (Union[str, Sequence[str]]): The redis command.
-
-        Returns:
-            bool: True if the command has expired, False otherwise.
-        """
-        if self.ttl == 0:
-            return False
-        return time.monotonic() - self.cache[command]["ctime"] > self.ttl
-
-    def _update_access(self, command: Union[str, Sequence[str]]):
-        """
-        Update the access information for a redis command based on the eviction policy.
-
-        Args:
-            command (Union[str, Sequence[str]]): The redis command.
-        """
-        if self.eviction_policy == EvictionPolicy.LRU:
-            self.cache.move_to_end(command)
-        elif self.eviction_policy == EvictionPolicy.LFU:
-            self.cache[command]["access_count"] = (
-                self.cache.get(command, {}).get("access_count", 0) + 1
-            )
-            self.cache.move_to_end(command)
-        elif self.eviction_policy == EvictionPolicy.RANDOM:
-            pass  # Random eviction doesn't require updates
-
-    def _evict(self):
-        """Evict a redis command from the cache based on the eviction policy."""
-        if self._is_expired(self.commands_ttl_list[0]):
-            self.delete_command(self.commands_ttl_list[0])
-        elif self.eviction_policy == EvictionPolicy.LRU:
-            self.cache.popitem(last=False)
-        elif self.eviction_policy == EvictionPolicy.LFU:
-            min_access_command = min(
-                self.cache, key=lambda k: self.cache[k].get("access_count", 0)
-            )
-            self.cache.pop(min_access_command)
-        elif self.eviction_policy == EvictionPolicy.RANDOM:
-            random_command = random.choice(list(self.cache.keys()))
-            self.cache.pop(random_command)
-
-    def _update_key_commands_map(
-        self, keys: List[KeyT], command: Union[str, Sequence[str]]
-    ):
-        """
-        Update the key_commands_map with command that uses the keys.
-
-        Args:
-            keys (List[KeyT]): The list of keys used in the command.
-            command (Union[str, Sequence[str]]): The redis command.
-        """
-        for key in keys:
-            self.key_commands_map[key].add(command)
-
-    def _del_key_commands_map(
-        self, keys: List[KeyT], command: Union[str, Sequence[str]]
-    ):
-        """
-        Remove a redis command from the key_commands_map.
-
-        Args:
-            keys (List[KeyT]): The list of keys used in the redis command.
-            command (Union[str, Sequence[str]]): The redis command.
-        """
-        for key in keys:
-            self.key_commands_map[key].remove(command)
-
-    def invalidate_key(self, key: KeyT):
-        """
-        Invalidate (delete) all redis commands associated with a specific key.
-
-        Args:
-            key (KeyT): The key to be invalidated.
-        """
-        if key not in self.key_commands_map:
-            return
-        commands = list(self.key_commands_map[key])
-        for command in commands:
-            self.delete_command(command)
diff --git a/redis/_parsers/resp3.py b/redis/_parsers/resp3.py
index 3547fcf355..281546430b 100644
--- a/redis/_parsers/resp3.py
+++ b/redis/_parsers/resp3.py
@@ -116,6 +116,12 @@ def _read_response(self, disable_decoding=False, push_request=False):
             response = self.handle_push_response(
                 response, disable_decoding, push_request
             )
+            if not push_request:
+                return self._read_response(
+                    disable_decoding=disable_decoding, push_request=push_request
+                )
+            else:
+                return response
         else:
             raise InvalidResponse(f"Protocol Error: {raw!r}")
 
@@ -124,19 +130,10 @@ def _read_response(self, disable_decoding=False, push_request=False):
         return response
 
     def handle_push_response(self, response, disable_decoding, push_request):
-        if response[0] in _INVALIDATION_MESSAGE:
-            if self.invalidation_push_handler_func:
-                res = self.invalidation_push_handler_func(response)
-            else:
-                res = None
-        else:
-            res = self.pubsub_push_handler_func(response)
-        if not push_request:
-            return self._read_response(
-                disable_decoding=disable_decoding, push_request=push_request
-            )
-        else:
-            return res
+        if response[0] not in _INVALIDATION_MESSAGE:
+            return self.pubsub_push_handler_func(response)
+        if self.invalidation_push_handler_func:
+            return self.invalidation_push_handler_func(response)
 
     def set_pubsub_push_handler(self, pubsub_push_handler_func):
         self.pubsub_push_handler_func = pubsub_push_handler_func
@@ -151,7 +148,7 @@ def __init__(self, socket_read_size):
         self.pubsub_push_handler_func = self.handle_pubsub_push_response
         self.invalidation_push_handler_func = None
 
-    def handle_pubsub_push_response(self, response):
+    async def handle_pubsub_push_response(self, response):
         logger = getLogger("push_response")
         logger.info("Push response: " + str(response))
         return response
@@ -259,6 +256,12 @@ async def _read_response(
             response = await self.handle_push_response(
                 response, disable_decoding, push_request
             )
+            if not push_request:
+                return await self._read_response(
+                    disable_decoding=disable_decoding, push_request=push_request
+                )
+            else:
+                return response
         else:
             raise InvalidResponse(f"Protocol Error: {raw!r}")
 
@@ -267,19 +270,10 @@ async def _read_response(
         return response
 
     async def handle_push_response(self, response, disable_decoding, push_request):
-        if response[0] in _INVALIDATION_MESSAGE:
-            if self.invalidation_push_handler_func:
-                res = self.invalidation_push_handler_func(response)
-            else:
-                res = None
-        else:
-            res = self.pubsub_push_handler_func(response)
-        if not push_request:
-            return await self._read_response(
-                disable_decoding=disable_decoding, push_request=push_request
-            )
-        else:
-            return res
+        if response[0] not in _INVALIDATION_MESSAGE:
+            return await self.pubsub_push_handler_func(response)
+        if self.invalidation_push_handler_func:
+            return await self.invalidation_push_handler_func(response)
 
     def set_pubsub_push_handler(self, pubsub_push_handler_func):
         self.pubsub_push_handler_func = pubsub_push_handler_func
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 70a5e997ef..039ebfdfae 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -26,12 +26,6 @@
     cast,
 )
 
-from redis._cache import (
-    DEFAULT_ALLOW_LIST,
-    DEFAULT_DENY_LIST,
-    DEFAULT_EVICTION_POLICY,
-    AbstractCache,
-)
 from redis._parsers.helpers import (
     _RedisCallbacks,
     _RedisCallbacksRESP2,
@@ -239,13 +233,6 @@ def __init__(
         redis_connect_func=None,
         credential_provider: Optional[CredentialProvider] = None,
         protocol: Optional[int] = 2,
-        cache_enabled: bool = False,
-        client_cache: Optional[AbstractCache] = None,
-        cache_max_size: int = 100,
-        cache_ttl: int = 0,
-        cache_policy: str = DEFAULT_EVICTION_POLICY,
-        cache_deny_list: List[str] = DEFAULT_DENY_LIST,
-        cache_allow_list: List[str] = DEFAULT_ALLOW_LIST,
     ):
         """
         Initialize a new Redis client.
@@ -295,13 +282,6 @@ def __init__(
                 "lib_version": lib_version,
                 "redis_connect_func": redis_connect_func,
                 "protocol": protocol,
-                "cache_enabled": cache_enabled,
-                "client_cache": client_cache,
-                "cache_max_size": cache_max_size,
-                "cache_ttl": cache_ttl,
-                "cache_policy": cache_policy,
-                "cache_deny_list": cache_deny_list,
-                "cache_allow_list": cache_allow_list,
             }
             # based on input, setup appropriate connection args
             if unix_socket_path is not None:
@@ -626,31 +606,22 @@ async def _disconnect_raise(self, conn: Connection, error: Exception):
     async def execute_command(self, *args, **options):
         """Execute a command and return a parsed response"""
         await self.initialize()
-        command_name = args[0]
-        keys = options.pop("keys", None)  # keys are used only for client side caching
         pool = self.connection_pool
+        command_name = args[0]
         conn = self.connection or await pool.get_connection(command_name, **options)
-        response_from_cache = await conn._get_from_local_cache(args)
+
+        if self.single_connection_client:
+            await self._single_conn_lock.acquire()
         try:
-            if response_from_cache is not None:
-                return response_from_cache
-            else:
-                try:
-                    if self.single_connection_client:
-                        await self._single_conn_lock.acquire()
-                    response = await conn.retry.call_with_retry(
-                        lambda: self._send_command_parse_response(
-                            conn, command_name, *args, **options
-                        ),
-                        lambda error: self._disconnect_raise(conn, error),
-                    )
-                    if keys:
-                        conn._add_to_local_cache(args, response, keys)
-                    return response
-                finally:
-                    if self.single_connection_client:
-                        self._single_conn_lock.release()
+            return await conn.retry.call_with_retry(
+                lambda: self._send_command_parse_response(
+                    conn, command_name, *args, **options
+                ),
+                lambda error: self._disconnect_raise(conn, error),
+            )
         finally:
+            if self.single_connection_client:
+                self._single_conn_lock.release()
             if not self.connection:
                 await pool.release(conn)
 
@@ -672,6 +643,9 @@ async def parse_response(
         if EMPTY_RESPONSE in options:
             options.pop(EMPTY_RESPONSE)
 
+        # Remove keys entry, it needs only for cache.
+        options.pop("keys", None)
+
         if command_name in self.response_callbacks:
             # Mypy bug: https://github.com/python/mypy/issues/10977
             command_name = cast(str, command_name)
@@ -679,24 +653,6 @@ async def parse_response(
             return await retval if inspect.isawaitable(retval) else retval
         return response
 
-    def flush_cache(self):
-        if self.connection:
-            self.connection.flush_cache()
-        else:
-            self.connection_pool.flush_cache()
-
-    def delete_command_from_cache(self, command):
-        if self.connection:
-            self.connection.delete_command_from_cache(command)
-        else:
-            self.connection_pool.delete_command_from_cache(command)
-
-    def invalidate_key_from_cache(self, key):
-        if self.connection:
-            self.connection.invalidate_key_from_cache(key)
-        else:
-            self.connection_pool.invalidate_key_from_cache(key)
-
 
 StrictRedis = Redis
 
@@ -1333,7 +1289,6 @@ def multi(self):
     def execute_command(
         self, *args, **kwargs
     ) -> Union["Pipeline", Awaitable["Pipeline"]]:
-        kwargs.pop("keys", None)  # the keys are used only for client side caching
         if (self.watching or args[0] == "WATCH") and not self.explicit_transaction:
             return self.immediate_execute_command(*args, **kwargs)
         return self.pipeline_execute_command(*args, **kwargs)
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 40b2948a7f..4e82e5448f 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -19,12 +19,6 @@
     Union,
 )
 
-from redis._cache import (
-    DEFAULT_ALLOW_LIST,
-    DEFAULT_DENY_LIST,
-    DEFAULT_EVICTION_POLICY,
-    AbstractCache,
-)
 from redis._parsers import AsyncCommandsParser, Encoder
 from redis._parsers.helpers import (
     _RedisCallbacks,
@@ -276,13 +270,6 @@ def __init__(
         ssl_ciphers: Optional[str] = None,
         protocol: Optional[int] = 2,
         address_remap: Optional[Callable[[Tuple[str, int]], Tuple[str, int]]] = None,
-        cache_enabled: bool = False,
-        client_cache: Optional[AbstractCache] = None,
-        cache_max_size: int = 100,
-        cache_ttl: int = 0,
-        cache_policy: str = DEFAULT_EVICTION_POLICY,
-        cache_deny_list: List[str] = DEFAULT_DENY_LIST,
-        cache_allow_list: List[str] = DEFAULT_ALLOW_LIST,
     ) -> None:
         if db:
             raise RedisClusterException(
@@ -326,14 +313,6 @@ def __init__(
             "socket_timeout": socket_timeout,
             "retry": retry,
             "protocol": protocol,
-            # Client cache related kwargs
-            "cache_enabled": cache_enabled,
-            "client_cache": client_cache,
-            "cache_max_size": cache_max_size,
-            "cache_ttl": cache_ttl,
-            "cache_policy": cache_policy,
-            "cache_deny_list": cache_deny_list,
-            "cache_allow_list": cache_allow_list,
         }
 
         if ssl:
@@ -938,18 +917,6 @@ def lock(
             thread_local=thread_local,
         )
 
-    def flush_cache(self):
-        if self.nodes_manager:
-            self.nodes_manager.flush_cache()
-
-    def delete_command_from_cache(self, command):
-        if self.nodes_manager:
-            self.nodes_manager.delete_command_from_cache(command)
-
-    def invalidate_key_from_cache(self, key):
-        if self.nodes_manager:
-            self.nodes_manager.invalidate_key_from_cache(key)
-
 
 class ClusterNode:
     """
@@ -1067,6 +1034,9 @@ async def parse_response(
         if EMPTY_RESPONSE in kwargs:
             kwargs.pop(EMPTY_RESPONSE)
 
+        # Remove keys entry, it needs only for cache.
+        kwargs.pop("keys", None)
+
         # Return response
         if command in self.response_callbacks:
             return self.response_callbacks[command](response, **kwargs)
@@ -1076,25 +1046,16 @@ async def parse_response(
     async def execute_command(self, *args: Any, **kwargs: Any) -> Any:
         # Acquire connection
         connection = self.acquire_connection()
-        keys = kwargs.pop("keys", None)
 
-        response_from_cache = await connection._get_from_local_cache(args)
-        if response_from_cache is not None:
-            self._free.append(connection)
-            return response_from_cache
-        else:
-            # Execute command
-            await connection.send_packed_command(connection.pack_command(*args), False)
+        # Execute command
+        await connection.send_packed_command(connection.pack_command(*args), False)
 
-            # Read response
-            try:
-                response = await self.parse_response(connection, args[0], **kwargs)
-                if keys:
-                    connection._add_to_local_cache(args, response, keys)
-                return response
-            finally:
-                # Release connection
-                self._free.append(connection)
+        # Read response
+        try:
+            return await self.parse_response(connection, args[0], **kwargs)
+        finally:
+            # Release connection
+            self._free.append(connection)
 
     async def execute_pipeline(self, commands: List["PipelineCommand"]) -> bool:
         # Acquire connection
@@ -1121,18 +1082,6 @@ async def execute_pipeline(self, commands: List["PipelineCommand"]) -> bool:
 
         return ret
 
-    def flush_cache(self):
-        for connection in self._connections:
-            connection.flush_cache()
-
-    def delete_command_from_cache(self, command):
-        for connection in self._connections:
-            connection.delete_command_from_cache(command)
-
-    def invalidate_key_from_cache(self, key):
-        for connection in self._connections:
-            connection.invalidate_key_from_cache(key)
-
 
 class NodesManager:
     __slots__ = (
@@ -1416,18 +1365,6 @@ def remap_host_port(self, host: str, port: int) -> Tuple[str, int]:
             return self.address_remap((host, port))
         return host, port
 
-    def flush_cache(self):
-        for node in self.nodes_cache.values():
-            node.flush_cache()
-
-    def delete_command_from_cache(self, command):
-        for node in self.nodes_cache.values():
-            node.delete_command_from_cache(command)
-
-    def invalidate_key_from_cache(self, key):
-        for node in self.nodes_cache.values():
-            node.invalidate_key_from_cache(key)
-
 
 class ClusterPipeline(AbstractRedis, AbstractRedisCluster, AsyncRedisClusterCommands):
     """
@@ -1516,7 +1453,6 @@ def execute_command(
               or List[:class:`~.ClusterNode`] or Dict[Any, :class:`~.ClusterNode`]
             - Rest of the kwargs are passed to the Redis connection
         """
-        kwargs.pop("keys", None)  # the keys are used only for client side caching
         self._command_stack.append(
             PipelineCommand(len(self._command_stack), *args, **kwargs)
         )
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 2ac6637986..ddbd22c95d 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -49,16 +49,9 @@
     ResponseError,
     TimeoutError,
 )
-from redis.typing import EncodableT, KeysT, ResponseT
+from redis.typing import EncodableT
 from redis.utils import HIREDIS_AVAILABLE, get_lib_version, str_if_bytes
 
-from .._cache import (
-    DEFAULT_ALLOW_LIST,
-    DEFAULT_DENY_LIST,
-    DEFAULT_EVICTION_POLICY,
-    AbstractCache,
-    _LocalCache,
-)
 from .._parsers import (
     BaseParser,
     Encoder,
@@ -121,9 +114,6 @@ class AbstractConnection:
         "encoder",
         "ssl_context",
         "protocol",
-        "client_cache",
-        "cache_deny_list",
-        "cache_allow_list",
         "_reader",
         "_writer",
         "_parser",
@@ -158,13 +148,6 @@ def __init__(
         encoder_class: Type[Encoder] = Encoder,
         credential_provider: Optional[CredentialProvider] = None,
         protocol: Optional[int] = 2,
-        cache_enabled: bool = False,
-        client_cache: Optional[AbstractCache] = None,
-        cache_max_size: int = 10000,
-        cache_ttl: int = 0,
-        cache_policy: str = DEFAULT_EVICTION_POLICY,
-        cache_deny_list: List[str] = DEFAULT_DENY_LIST,
-        cache_allow_list: List[str] = DEFAULT_ALLOW_LIST,
     ):
         if (username or password) and credential_provider is not None:
             raise DataError(
@@ -222,18 +205,6 @@ def __init__(
             if p < 2 or p > 3:
                 raise ConnectionError("protocol must be either 2 or 3")
             self.protocol = protocol
-        if cache_enabled:
-            _cache = _LocalCache(cache_max_size, cache_ttl, cache_policy)
-        else:
-            _cache = None
-        self.client_cache = client_cache if client_cache is not None else _cache
-        if self.client_cache is not None:
-            if self.protocol not in [3, "3"]:
-                raise RedisError(
-                    "client caching is only supported with protocol version 3 or higher"
-                )
-            self.cache_deny_list = cache_deny_list
-            self.cache_allow_list = cache_allow_list
 
     def __del__(self, _warnings: Any = warnings):
         # For some reason, the individual streams don't get properly garbage
@@ -425,11 +396,6 @@ async def on_connect(self) -> None:
         # if a database is specified, switch to it. Also pipeline this
         if self.db:
             await self.send_command("SELECT", self.db)
-        # if client caching is enabled, start tracking
-        if self.client_cache:
-            await self.send_command("CLIENT", "TRACKING", "ON")
-            await self.read_response()
-            self._parser.set_invalidation_push_handler(self._cache_invalidation_process)
 
         # read responses from pipeline
         for _ in (sent for sent in (self.lib_name, self.lib_version) if sent):
@@ -464,9 +430,6 @@ async def disconnect(self, nowait: bool = False) -> None:
             raise TimeoutError(
                 f"Timed out closing connection after {self.socket_connect_timeout}"
             ) from None
-        finally:
-            if self.client_cache:
-                self.client_cache.flush()
 
     async def _send_ping(self):
         """Send PING, expect PONG in return"""
@@ -688,60 +651,9 @@ def _socket_is_empty(self):
         """Check if the socket is empty"""
         return len(self._reader._buffer) == 0
 
-    def _cache_invalidation_process(
-        self, data: List[Union[str, Optional[List[str]]]]
-    ) -> None:
-        """
-        Invalidate (delete) all redis commands associated with a specific key.
-        `data` is a list of strings, where the first string is the invalidation message
-        and the second string is the list of keys to invalidate.
-        (if the list of keys is None, then all keys are invalidated)
-        """
-        if data[1] is None:
-            self.client_cache.flush()
-        else:
-            for key in data[1]:
-                self.client_cache.invalidate_key(str_if_bytes(key))
-
-    async def _get_from_local_cache(self, command: str):
-        """
-        If the command is in the local cache, return the response
-        """
-        if (
-            self.client_cache is None
-            or command[0] in self.cache_deny_list
-            or command[0] not in self.cache_allow_list
-        ):
-            return None
+    async def process_invalidation_messages(self):
         while not self._socket_is_empty():
             await self.read_response(push_request=True)
-        return self.client_cache.get(command)
-
-    def _add_to_local_cache(
-        self, command: Tuple[str], response: ResponseT, keys: List[KeysT]
-    ):
-        """
-        Add the command and response to the local cache if the command
-        is allowed to be cached
-        """
-        if (
-            self.client_cache is not None
-            and (self.cache_deny_list == [] or command[0] not in self.cache_deny_list)
-            and (self.cache_allow_list == [] or command[0] in self.cache_allow_list)
-        ):
-            self.client_cache.set(command, response, keys)
-
-    def flush_cache(self):
-        if self.client_cache:
-            self.client_cache.flush()
-
-    def delete_command_from_cache(self, command):
-        if self.client_cache:
-            self.client_cache.delete_command(command)
-
-    def invalidate_key_from_cache(self, key):
-        if self.client_cache:
-            self.client_cache.invalidate_key(key)
 
 
 class Connection(AbstractConnection):
@@ -1177,18 +1089,12 @@ def make_connection(self):
     async def ensure_connection(self, connection: AbstractConnection):
         """Ensure that the connection object is connected and valid"""
         await connection.connect()
-        # if client caching is not enabled connections that the pool
-        # provides should be ready to send a command.
-        # if not, the connection was either returned to the
+        # connections that the pool provides should be ready to send
+        # a command. if not, the connection was either returned to the
         # pool before all data has been read or the socket has been
         # closed. either way, reconnect and verify everything is good.
-        # (if caching enabled the connection will not always be ready
-        # to send a command because it may contain invalidation messages)
         try:
-            if (
-                await connection.can_read_destructive()
-                and connection.client_cache is None
-            ):
+            if await connection.can_read_destructive():
                 raise ConnectionError("Connection has data") from None
         except (ConnectionError, OSError):
             await connection.disconnect()
@@ -1235,21 +1141,6 @@ def set_retry(self, retry: "Retry") -> None:
         for conn in self._in_use_connections:
             conn.retry = retry
 
-    def flush_cache(self):
-        connections = chain(self._available_connections, self._in_use_connections)
-        for connection in connections:
-            connection.flush_cache()
-
-    def delete_command_from_cache(self, command: str):
-        connections = chain(self._available_connections, self._in_use_connections)
-        for connection in connections:
-            connection.delete_command_from_cache(command)
-
-    def invalidate_key_from_cache(self, key: str):
-        connections = chain(self._available_connections, self._in_use_connections)
-        for connection in connections:
-            connection.invalidate_key_from_cache(key)
-
 
 class BlockingConnectionPool(ConnectionPool):
     """
diff --git a/redis/asyncio/sentinel.py b/redis/asyncio/sentinel.py
index 6fd233adc8..5d4608ed2f 100644
--- a/redis/asyncio/sentinel.py
+++ b/redis/asyncio/sentinel.py
@@ -225,7 +225,6 @@ async def execute_command(self, *args, **kwargs):
         once - If set to True, then execute the resulting command on a single
                node at random, rather than across the entire sentinel cluster.
         """
-        kwargs.pop("keys", None)  # the keys are used only for client side caching
         once = bool(kwargs.get("once", False))
         if "once" in kwargs.keys():
             kwargs.pop("once")
diff --git a/redis/cache.py b/redis/cache.py
new file mode 100644
index 0000000000..9971edd256
--- /dev/null
+++ b/redis/cache.py
@@ -0,0 +1,401 @@
+from abc import ABC, abstractmethod
+from collections import OrderedDict
+from dataclasses import dataclass
+from enum import Enum
+from typing import Any, List, Optional, Union
+
+
+class CacheEntryStatus(Enum):
+    VALID = "VALID"
+    IN_PROGRESS = "IN_PROGRESS"
+
+
+class EvictionPolicyType(Enum):
+    time_based = "time_based"
+    frequency_based = "frequency_based"
+
+
+@dataclass(frozen=True)
+class CacheKey:
+    command: str
+    redis_keys: tuple
+
+
+class CacheEntry:
+    def __init__(
+        self,
+        cache_key: CacheKey,
+        cache_value: bytes,
+        status: CacheEntryStatus,
+        connection_ref,
+    ):
+        self.cache_key = cache_key
+        self.cache_value = cache_value
+        self.status = status
+        self.connection_ref = connection_ref
+
+    def __hash__(self):
+        return hash(
+            (self.cache_key, self.cache_value, self.status, self.connection_ref)
+        )
+
+    def __eq__(self, other):
+        return hash(self) == hash(other)
+
+
+class EvictionPolicyInterface(ABC):
+    @property
+    @abstractmethod
+    def cache(self):
+        pass
+
+    @cache.setter
+    def cache(self, value):
+        pass
+
+    @property
+    @abstractmethod
+    def type(self) -> EvictionPolicyType:
+        pass
+
+    @abstractmethod
+    def evict_next(self) -> CacheKey:
+        pass
+
+    @abstractmethod
+    def evict_many(self, count: int) -> List[CacheKey]:
+        pass
+
+    @abstractmethod
+    def touch(self, cache_key: CacheKey) -> None:
+        pass
+
+
+class CacheConfigurationInterface(ABC):
+    @abstractmethod
+    def get_cache_class(self):
+        pass
+
+    @abstractmethod
+    def get_max_size(self) -> int:
+        pass
+
+    @abstractmethod
+    def get_eviction_policy(self):
+        pass
+
+    @abstractmethod
+    def is_exceeds_max_size(self, count: int) -> bool:
+        pass
+
+    @abstractmethod
+    def is_allowed_to_cache(self, command: str) -> bool:
+        pass
+
+
+class CacheInterface(ABC):
+    @property
+    @abstractmethod
+    def collection(self) -> OrderedDict:
+        pass
+
+    @property
+    @abstractmethod
+    def config(self) -> CacheConfigurationInterface:
+        pass
+
+    @property
+    @abstractmethod
+    def eviction_policy(self) -> EvictionPolicyInterface:
+        pass
+
+    @property
+    @abstractmethod
+    def size(self) -> int:
+        pass
+
+    @abstractmethod
+    def get(self, key: CacheKey) -> Union[CacheEntry, None]:
+        pass
+
+    @abstractmethod
+    def set(self, entry: CacheEntry) -> bool:
+        pass
+
+    @abstractmethod
+    def delete_by_cache_keys(self, cache_keys: List[CacheKey]) -> List[bool]:
+        pass
+
+    @abstractmethod
+    def delete_by_redis_keys(self, redis_keys: List[bytes]) -> List[bool]:
+        pass
+
+    @abstractmethod
+    def flush(self) -> int:
+        pass
+
+    @abstractmethod
+    def is_cachable(self, key: CacheKey) -> bool:
+        pass
+
+
+class DefaultCache(CacheInterface):
+    def __init__(
+        self,
+        cache_config: CacheConfigurationInterface,
+    ) -> None:
+        self._cache = OrderedDict()
+        self._cache_config = cache_config
+        self._eviction_policy = self._cache_config.get_eviction_policy().value()
+        self._eviction_policy.cache = self
+
+    @property
+    def collection(self) -> OrderedDict:
+        return self._cache
+
+    @property
+    def config(self) -> CacheConfigurationInterface:
+        return self._cache_config
+
+    @property
+    def eviction_policy(self) -> EvictionPolicyInterface:
+        return self._eviction_policy
+
+    @property
+    def size(self) -> int:
+        return len(self._cache)
+
+    def set(self, entry: CacheEntry) -> bool:
+        if not self.is_cachable(entry.cache_key):
+            return False
+
+        self._cache[entry.cache_key] = entry
+        self._eviction_policy.touch(entry.cache_key)
+
+        if self._cache_config.is_exceeds_max_size(len(self._cache)):
+            self._eviction_policy.evict_next()
+
+        return True
+
+    def get(self, key: CacheKey) -> Union[CacheEntry, None]:
+        entry = self._cache.get(key, None)
+
+        if entry is None:
+            return None
+
+        self._eviction_policy.touch(key)
+        return entry
+
+    def delete_by_cache_keys(self, cache_keys: List[CacheKey]) -> List[bool]:
+        response = []
+
+        for key in cache_keys:
+            if self.get(key) is not None:
+                self._cache.pop(key)
+                response.append(True)
+            else:
+                response.append(False)
+
+        return response
+
+    def delete_by_redis_keys(self, redis_keys: List[bytes]) -> List[bool]:
+        response = []
+        keys_to_delete = []
+
+        for redis_key in redis_keys:
+            if isinstance(redis_key, bytes):
+                redis_key = redis_key.decode()
+            for cache_key in self._cache:
+                if redis_key in cache_key.redis_keys:
+                    keys_to_delete.append(cache_key)
+                    response.append(True)
+
+        for key in keys_to_delete:
+            self._cache.pop(key)
+
+        return response
+
+    def flush(self) -> int:
+        elem_count = len(self._cache)
+        self._cache.clear()
+        return elem_count
+
+    def is_cachable(self, key: CacheKey) -> bool:
+        return self._cache_config.is_allowed_to_cache(key.command)
+
+
+class LRUPolicy(EvictionPolicyInterface):
+    def __init__(self):
+        self.cache = None
+
+    @property
+    def cache(self):
+        return self._cache
+
+    @cache.setter
+    def cache(self, cache: CacheInterface):
+        self._cache = cache
+
+    @property
+    def type(self) -> EvictionPolicyType:
+        return EvictionPolicyType.time_based
+
+    def evict_next(self) -> CacheKey:
+        self._assert_cache()
+        popped_entry = self._cache.collection.popitem(last=False)
+        return popped_entry[0]
+
+    def evict_many(self, count: int) -> List[CacheKey]:
+        self._assert_cache()
+        if count > len(self._cache.collection):
+            raise ValueError("Evictions count is above cache size")
+
+        popped_keys = []
+
+        for _ in range(count):
+            popped_entry = self._cache.collection.popitem(last=False)
+            popped_keys.append(popped_entry[0])
+
+        return popped_keys
+
+    def touch(self, cache_key: CacheKey) -> None:
+        self._assert_cache()
+
+        if self._cache.collection.get(cache_key) is None:
+            raise ValueError("Given entry does not belong to the cache")
+
+        self._cache.collection.move_to_end(cache_key)
+
+    def _assert_cache(self):
+        if self.cache is None or not isinstance(self.cache, CacheInterface):
+            raise ValueError("Eviction policy should be associated with valid cache.")
+
+
+class EvictionPolicy(Enum):
+    LRU = LRUPolicy
+
+
+class CacheConfig(CacheConfigurationInterface):
+    DEFAULT_CACHE_CLASS = DefaultCache
+    DEFAULT_EVICTION_POLICY = EvictionPolicy.LRU
+    DEFAULT_MAX_SIZE = 10000
+
+    DEFAULT_ALLOW_LIST = [
+        "BITCOUNT",
+        "BITFIELD_RO",
+        "BITPOS",
+        "EXISTS",
+        "GEODIST",
+        "GEOHASH",
+        "GEOPOS",
+        "GEORADIUSBYMEMBER_RO",
+        "GEORADIUS_RO",
+        "GEOSEARCH",
+        "GET",
+        "GETBIT",
+        "GETRANGE",
+        "HEXISTS",
+        "HGET",
+        "HGETALL",
+        "HKEYS",
+        "HLEN",
+        "HMGET",
+        "HSTRLEN",
+        "HVALS",
+        "JSON.ARRINDEX",
+        "JSON.ARRLEN",
+        "JSON.GET",
+        "JSON.MGET",
+        "JSON.OBJKEYS",
+        "JSON.OBJLEN",
+        "JSON.RESP",
+        "JSON.STRLEN",
+        "JSON.TYPE",
+        "LCS",
+        "LINDEX",
+        "LLEN",
+        "LPOS",
+        "LRANGE",
+        "MGET",
+        "SCARD",
+        "SDIFF",
+        "SINTER",
+        "SINTERCARD",
+        "SISMEMBER",
+        "SMEMBERS",
+        "SMISMEMBER",
+        "SORT_RO",
+        "STRLEN",
+        "SUBSTR",
+        "SUNION",
+        "TS.GET",
+        "TS.INFO",
+        "TS.RANGE",
+        "TS.REVRANGE",
+        "TYPE",
+        "XLEN",
+        "XPENDING",
+        "XRANGE",
+        "XREAD",
+        "XREVRANGE",
+        "ZCARD",
+        "ZCOUNT",
+        "ZDIFF",
+        "ZINTER",
+        "ZINTERCARD",
+        "ZLEXCOUNT",
+        "ZMSCORE",
+        "ZRANGE",
+        "ZRANGEBYLEX",
+        "ZRANGEBYSCORE",
+        "ZRANK",
+        "ZREVRANGE",
+        "ZREVRANGEBYLEX",
+        "ZREVRANGEBYSCORE",
+        "ZREVRANK",
+        "ZSCORE",
+        "ZUNION",
+    ]
+
+    def __init__(
+        self,
+        max_size: int = DEFAULT_MAX_SIZE,
+        cache_class: Any = DEFAULT_CACHE_CLASS,
+        eviction_policy: EvictionPolicy = DEFAULT_EVICTION_POLICY,
+    ):
+        self._cache_class = cache_class
+        self._max_size = max_size
+        self._eviction_policy = eviction_policy
+
+    def get_cache_class(self):
+        return self._cache_class
+
+    def get_max_size(self) -> int:
+        return self._max_size
+
+    def get_eviction_policy(self) -> EvictionPolicy:
+        return self._eviction_policy
+
+    def is_exceeds_max_size(self, count: int) -> bool:
+        return count > self._max_size
+
+    def is_allowed_to_cache(self, command: str) -> bool:
+        return command in self.DEFAULT_ALLOW_LIST
+
+
+class CacheFactoryInterface(ABC):
+    @abstractmethod
+    def get_cache(self) -> CacheInterface:
+        pass
+
+
+class CacheFactory(CacheFactoryInterface):
+    def __init__(self, cache_config: Optional[CacheConfig] = None):
+        self._config = cache_config
+
+        if self._config is None:
+            self._config = CacheConfig()
+
+    def get_cache(self) -> CacheInterface:
+        cache_class = self._config.get_cache_class()
+        return cache_class(cache_config=self._config)
diff --git a/redis/client.py b/redis/client.py
index b7a1f88d92..bf3432e7eb 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -6,12 +6,6 @@
 from itertools import chain
 from typing import Any, Callable, Dict, List, Optional, Type, Union
 
-from redis._cache import (
-    DEFAULT_ALLOW_LIST,
-    DEFAULT_DENY_LIST,
-    DEFAULT_EVICTION_POLICY,
-    AbstractCache,
-)
 from redis._parsers.encoders import Encoder
 from redis._parsers.helpers import (
     _RedisCallbacks,
@@ -19,6 +13,7 @@
     _RedisCallbacksRESP3,
     bool_ok,
 )
+from redis.cache import CacheConfig, CacheInterface
 from redis.commands import (
     CoreCommands,
     RedisModuleCommands,
@@ -216,13 +211,8 @@ def __init__(
         redis_connect_func=None,
         credential_provider: Optional[CredentialProvider] = None,
         protocol: Optional[int] = 2,
-        cache_enabled: bool = False,
-        client_cache: Optional[AbstractCache] = None,
-        cache_max_size: int = 10000,
-        cache_ttl: int = 0,
-        cache_policy: str = DEFAULT_EVICTION_POLICY,
-        cache_deny_list: List[str] = DEFAULT_DENY_LIST,
-        cache_allow_list: List[str] = DEFAULT_ALLOW_LIST,
+        cache: Optional[CacheInterface] = None,
+        cache_config: Optional[CacheConfig] = None,
     ) -> None:
         """
         Initialize a new Redis client.
@@ -274,13 +264,6 @@ def __init__(
                 "redis_connect_func": redis_connect_func,
                 "credential_provider": credential_provider,
                 "protocol": protocol,
-                "cache_enabled": cache_enabled,
-                "client_cache": client_cache,
-                "cache_max_size": cache_max_size,
-                "cache_ttl": cache_ttl,
-                "cache_policy": cache_policy,
-                "cache_deny_list": cache_deny_list,
-                "cache_allow_list": cache_allow_list,
             }
             # based on input, setup appropriate connection args
             if unix_socket_path is not None:
@@ -322,12 +305,26 @@ def __init__(
                             "ssl_ciphers": ssl_ciphers,
                         }
                     )
+                if (cache_config or cache) and protocol in [3, "3"]:
+                    kwargs.update(
+                        {
+                            "cache": cache,
+                            "cache_config": cache_config,
+                        }
+                    )
             connection_pool = ConnectionPool(**kwargs)
             self.auto_close_connection_pool = True
         else:
             self.auto_close_connection_pool = False
 
         self.connection_pool = connection_pool
+
+        if (cache_config or cache) and self.connection_pool.get_protocol() not in [
+            3,
+            "3",
+        ]:
+            raise RedisError("Client caching is only supported with RESP version 3")
+
         self.connection = None
         if single_connection_client:
             self.connection = self.connection_pool.get_connection("_")
@@ -541,7 +538,7 @@ def _send_command_parse_response(self, conn, command_name, *args, **options):
         """
         Send a command and parse the response
         """
-        conn.send_command(*args)
+        conn.send_command(*args, **options)
         return self.parse_response(conn, command_name, **options)
 
     def _disconnect_raise(self, conn, error):
@@ -559,25 +556,20 @@ def _disconnect_raise(self, conn, error):
 
     # COMMAND EXECUTION AND PROTOCOL PARSING
     def execute_command(self, *args, **options):
+        return self._execute_command(*args, **options)
+
+    def _execute_command(self, *args, **options):
         """Execute a command and return a parsed response"""
-        command_name = args[0]
-        keys = options.pop("keys", None)
         pool = self.connection_pool
+        command_name = args[0]
         conn = self.connection or pool.get_connection(command_name, **options)
-        response_from_cache = conn._get_from_local_cache(args)
         try:
-            if response_from_cache is not None:
-                return response_from_cache
-            else:
-                response = conn.retry.call_with_retry(
-                    lambda: self._send_command_parse_response(
-                        conn, command_name, *args, **options
-                    ),
-                    lambda error: self._disconnect_raise(conn, error),
-                )
-                if keys:
-                    conn._add_to_local_cache(args, response, keys)
-                return response
+            return conn.retry.call_with_retry(
+                lambda: self._send_command_parse_response(
+                    conn, command_name, *args, **options
+                ),
+                lambda error: self._disconnect_raise(conn, error),
+            )
         finally:
             if not self.connection:
                 pool.release(conn)
@@ -598,27 +590,15 @@ def parse_response(self, connection, command_name, **options):
         if EMPTY_RESPONSE in options:
             options.pop(EMPTY_RESPONSE)
 
+        # Remove keys entry, it needs only for cache.
+        options.pop("keys", None)
+
         if command_name in self.response_callbacks:
             return self.response_callbacks[command_name](response, **options)
         return response
 
-    def flush_cache(self):
-        if self.connection:
-            self.connection.flush_cache()
-        else:
-            self.connection_pool.flush_cache()
-
-    def delete_command_from_cache(self, command):
-        if self.connection:
-            self.connection.delete_command_from_cache(command)
-        else:
-            self.connection_pool.delete_command_from_cache(command)
-
-    def invalidate_key_from_cache(self, key):
-        if self.connection:
-            self.connection.invalidate_key_from_cache(key)
-        else:
-            self.connection_pool.invalidate_key_from_cache(key)
+    def get_cache(self) -> Optional[CacheInterface]:
+        return self.connection_pool.cache
 
 
 StrictRedis = Redis
@@ -1314,7 +1294,6 @@ def multi(self) -> None:
         self.explicit_transaction = True
 
     def execute_command(self, *args, **kwargs):
-        kwargs.pop("keys", None)  # the keys are used only for client side caching
         if (self.watching or args[0] == "WATCH") and not self.explicit_transaction:
             return self.immediate_execute_command(*args, **kwargs)
         return self.pipeline_execute_command(*args, **kwargs)
@@ -1441,6 +1420,8 @@ def _execute_transaction(self, connection, commands, raise_on_error) -> List:
         for r, cmd in zip(response, commands):
             if not isinstance(r, Exception):
                 args, options = cmd
+                # Remove keys entry, it needs only for cache.
+                options.pop("keys", None)
                 command_name = args[0]
                 if command_name in self.response_callbacks:
                     r = self.response_callbacks[command_name](r, **options)
diff --git a/redis/cluster.py b/redis/cluster.py
index be7685e9a1..fbf5428d40 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -9,6 +9,7 @@
 from redis._parsers import CommandsParser, Encoder
 from redis._parsers.helpers import parse_scan
 from redis.backoff import default_backoff
+from redis.cache import CacheConfig, CacheFactory, CacheFactoryInterface, CacheInterface
 from redis.client import CaseInsensitiveDict, PubSub, Redis
 from redis.commands import READ_COMMANDS, RedisClusterCommands
 from redis.commands.helpers import list_or_args
@@ -167,13 +168,8 @@ def parse_cluster_myshardid(resp, **options):
     "ssl_password",
     "unix_socket_path",
     "username",
-    "cache_enabled",
-    "client_cache",
-    "cache_max_size",
-    "cache_ttl",
-    "cache_policy",
-    "cache_deny_list",
-    "cache_allow_list",
+    "cache",
+    "cache_config",
 )
 KWARGS_DISABLED_KEYS = ("host", "port")
 
@@ -507,6 +503,8 @@ def __init__(
         dynamic_startup_nodes: bool = True,
         url: Optional[str] = None,
         address_remap: Optional[Callable[[Tuple[str, int]], Tuple[str, int]]] = None,
+        cache: Optional[CacheInterface] = None,
+        cache_config: Optional[CacheConfig] = None,
         **kwargs,
     ):
         """
@@ -630,6 +628,10 @@ def __init__(
             kwargs.get("encoding_errors", "strict"),
             kwargs.get("decode_responses", False),
         )
+        protocol = kwargs.get("protocol", None)
+        if (cache_config or cache) and protocol not in [3, "3"]:
+            raise RedisError("Client caching is only supported with RESP version 3")
+
         self.cluster_error_retry_attempts = cluster_error_retry_attempts
         self.command_flags = self.__class__.COMMAND_FLAGS.copy()
         self.node_flags = self.__class__.NODE_FLAGS.copy()
@@ -642,6 +644,8 @@ def __init__(
             require_full_coverage=require_full_coverage,
             dynamic_startup_nodes=dynamic_startup_nodes,
             address_remap=address_remap,
+            cache=cache,
+            cache_config=cache_config,
             **kwargs,
         )
 
@@ -649,6 +653,7 @@ def __init__(
             self.__class__.CLUSTER_COMMANDS_RESPONSE_CALLBACKS
         )
         self.result_callbacks = CaseInsensitiveDict(self.__class__.RESULT_CALLBACKS)
+
         self.commands_parser = CommandsParser(self)
         self._lock = threading.Lock()
 
@@ -1052,6 +1057,9 @@ def _parse_target_nodes(self, target_nodes):
         return nodes
 
     def execute_command(self, *args, **kwargs):
+        return self._internal_execute_command(*args, **kwargs)
+
+    def _internal_execute_command(self, *args, **kwargs):
         """
         Wrapper for ERRORS_ALLOW_RETRY error handling.
 
@@ -1125,7 +1133,6 @@ def _execute_command(self, target_node, *args, **kwargs):
         """
         Send a command to a node in the cluster
         """
-        keys = kwargs.pop("keys", None)
         command = args[0]
         redis_node = None
         connection = None
@@ -1154,19 +1161,13 @@ def _execute_command(self, target_node, *args, **kwargs):
                     connection.send_command("ASKING")
                     redis_node.parse_response(connection, "ASKING", **kwargs)
                     asking = False
-                response_from_cache = connection._get_from_local_cache(args)
-                if response_from_cache is not None:
-                    return response_from_cache
-                else:
-                    connection.send_command(*args)
-                    response = redis_node.parse_response(connection, command, **kwargs)
-                    if command in self.cluster_response_callbacks:
-                        response = self.cluster_response_callbacks[command](
-                            response, **kwargs
-                        )
-                    if keys:
-                        connection._add_to_local_cache(args, response, keys)
-                    return response
+                connection.send_command(*args, **kwargs)
+                response = redis_node.parse_response(connection, command, **kwargs)
+                if command in self.cluster_response_callbacks:
+                    response = self.cluster_response_callbacks[command](
+                        response, **kwargs
+                    )
+                return response
             except AuthenticationError:
                 raise
             except (ConnectionError, TimeoutError) as e:
@@ -1266,18 +1267,6 @@ def load_external_module(self, funcname, func):
         """
         setattr(self, funcname, func)
 
-    def flush_cache(self):
-        if self.nodes_manager:
-            self.nodes_manager.flush_cache()
-
-    def delete_command_from_cache(self, command):
-        if self.nodes_manager:
-            self.nodes_manager.delete_command_from_cache(command)
-
-    def invalidate_key_from_cache(self, key):
-        if self.nodes_manager:
-            self.nodes_manager.invalidate_key_from_cache(key)
-
 
 class ClusterNode:
     def __init__(self, host, port, server_type=None, redis_connection=None):
@@ -1306,18 +1295,6 @@ def __del__(self):
         if self.redis_connection is not None:
             self.redis_connection.close()
 
-    def flush_cache(self):
-        if self.redis_connection is not None:
-            self.redis_connection.flush_cache()
-
-    def delete_command_from_cache(self, command):
-        if self.redis_connection is not None:
-            self.redis_connection.delete_command_from_cache(command)
-
-    def invalidate_key_from_cache(self, key):
-        if self.redis_connection is not None:
-            self.redis_connection.invalidate_key_from_cache(key)
-
 
 class LoadBalancer:
     """
@@ -1348,6 +1325,9 @@ def __init__(
         dynamic_startup_nodes=True,
         connection_pool_class=ConnectionPool,
         address_remap: Optional[Callable[[Tuple[str, int]], Tuple[str, int]]] = None,
+        cache: Optional[CacheInterface] = None,
+        cache_config: Optional[CacheConfig] = None,
+        cache_factory: Optional[CacheFactoryInterface] = None,
         **kwargs,
     ):
         self.nodes_cache = {}
@@ -1360,6 +1340,9 @@ def __init__(
         self._dynamic_startup_nodes = dynamic_startup_nodes
         self.connection_pool_class = connection_pool_class
         self.address_remap = address_remap
+        self._cache = cache
+        self._cache_config = cache_config
+        self._cache_factory = cache_factory
         self._moved_exception = None
         self.connection_kwargs = kwargs
         self.read_load_balancer = LoadBalancer()
@@ -1503,9 +1486,15 @@ def create_redis_node(self, host, port, **kwargs):
             # Create a redis node with a costumed connection pool
             kwargs.update({"host": host})
             kwargs.update({"port": port})
+            kwargs.update({"cache": self._cache})
             r = Redis(connection_pool=self.connection_pool_class(**kwargs))
         else:
-            r = Redis(host=host, port=port, **kwargs)
+            r = Redis(
+                host=host,
+                port=port,
+                cache=self._cache,
+                **kwargs,
+            )
         return r
 
     def _get_or_create_cluster_node(self, host, port, role, tmp_nodes_cache):
@@ -1554,6 +1543,7 @@ def initialize(self):
                 # Make sure cluster mode is enabled on this node
                 try:
                     cluster_slots = str_if_bytes(r.execute_command("CLUSTER SLOTS"))
+                    r.connection_pool.disconnect()
                 except ResponseError:
                     raise RedisClusterException(
                         "Cluster mode is not enabled on this node"
@@ -1634,6 +1624,12 @@ def initialize(self):
                 f"one reachable node: {str(exception)}"
             ) from exception
 
+        if self._cache is None and self._cache_config is not None:
+            if self._cache_factory is None:
+                self._cache = CacheFactory(self._cache_config).get_cache()
+            else:
+                self._cache = self._cache_factory.get_cache()
+
         # Create Redis connections to all nodes
         self.create_redis_connections(list(tmp_nodes_cache.values()))
 
@@ -1681,18 +1677,6 @@ def remap_host_port(self, host: str, port: int) -> Tuple[str, int]:
             return self.address_remap((host, port))
         return host, port
 
-    def flush_cache(self):
-        for node in self.nodes_cache.values():
-            node.flush_cache()
-
-    def delete_command_from_cache(self, command):
-        for node in self.nodes_cache.values():
-            node.delete_command_from_cache(command)
-
-    def invalidate_key_from_cache(self, key):
-        for node in self.nodes_cache.values():
-            node.invalidate_key_from_cache(key)
-
 
 class ClusterPubSub(PubSub):
     """
@@ -2008,7 +1992,6 @@ def execute_command(self, *args, **kwargs):
         """
         Wrapper function for pipeline_execute_command
         """
-        kwargs.pop("keys", None)  # the keys are used only for client side caching
         return self.pipeline_execute_command(*args, **kwargs)
 
     def pipeline_execute_command(self, *args, **options):
@@ -2282,6 +2265,8 @@ def _send_cluster_commands(
         response = []
         for c in sorted(stack, key=lambda x: x.position):
             if c.args[0] in self.cluster_response_callbacks:
+                # Remove keys entry, it needs only for cache.
+                c.options.pop("keys", None)
                 c.result = self.cluster_response_callbacks[c.args[0]](
                     c.result, **c.options
                 )
diff --git a/redis/commands/core.py b/redis/commands/core.py
index d46e55446c..8986a48de2 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -5728,7 +5728,7 @@ def script_exists(self, *args: str) -> ResponseT:
         """
         Check if a script exists in the script cache by specifying the SHAs of
         each script as ``args``. Returns a list of boolean values indicating if
-        if each already script exists in the cache.
+        if each already script exists in the cache_data.
 
         For more information see  https://redis.io/commands/script-exists
         """
@@ -5742,7 +5742,7 @@ def script_debug(self, *args) -> None:
     def script_flush(
         self, sync_type: Union[Literal["SYNC"], Literal["ASYNC"]] = None
     ) -> ResponseT:
-        """Flush all scripts from the script cache.
+        """Flush all scripts from the script cache_data.
 
         ``sync_type`` is by default SYNC (synchronous) but it can also be
                       ASYNC.
@@ -5773,7 +5773,7 @@ def script_kill(self) -> ResponseT:
 
     def script_load(self, script: ScriptTextT) -> ResponseT:
         """
-        Load a Lua ``script`` into the script cache. Returns the SHA.
+        Load a Lua ``script`` into the script cache_data. Returns the SHA.
 
         For more information see https://redis.io/commands/script-load
         """
diff --git a/redis/connection.py b/redis/connection.py
index 1f862d0371..6aae2101c2 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -9,16 +9,18 @@
 from itertools import chain
 from queue import Empty, Full, LifoQueue
 from time import time
-from typing import Any, Callable, List, Optional, Sequence, Type, Union
+from typing import Any, Callable, Dict, List, Optional, Type, Union
 from urllib.parse import parse_qs, unquote, urlparse
 
-from ._cache import (
-    DEFAULT_ALLOW_LIST,
-    DEFAULT_DENY_LIST,
-    DEFAULT_EVICTION_POLICY,
-    AbstractCache,
-    _LocalCache,
+from redis.cache import (
+    CacheEntry,
+    CacheEntryStatus,
+    CacheFactory,
+    CacheFactoryInterface,
+    CacheInterface,
+    CacheKey,
 )
+
 from ._parsers import Encoder, _HiredisParser, _RESP2Parser, _RESP3Parser
 from .backoff import NoBackoff
 from .credentials import CredentialProvider, UsernamePasswordCredentialProvider
@@ -33,12 +35,13 @@
     TimeoutError,
 )
 from .retry import Retry
-from .typing import KeysT, ResponseT
 from .utils import (
     CRYPTOGRAPHY_AVAILABLE,
     HIREDIS_AVAILABLE,
     HIREDIS_PACK_AVAILABLE,
     SSL_AVAILABLE,
+    compare_versions,
+    ensure_string,
     format_error_message,
     get_lib_version,
     str_if_bytes,
@@ -132,7 +135,76 @@ def pack(self, *args):
         return output
 
 
-class AbstractConnection:
+class ConnectionInterface:
+    @abstractmethod
+    def repr_pieces(self):
+        pass
+
+    @abstractmethod
+    def register_connect_callback(self, callback):
+        pass
+
+    @abstractmethod
+    def deregister_connect_callback(self, callback):
+        pass
+
+    @abstractmethod
+    def set_parser(self, parser_class):
+        pass
+
+    @abstractmethod
+    def connect(self):
+        pass
+
+    @abstractmethod
+    def on_connect(self):
+        pass
+
+    @abstractmethod
+    def disconnect(self, *args):
+        pass
+
+    @abstractmethod
+    def check_health(self):
+        pass
+
+    @abstractmethod
+    def send_packed_command(self, command, check_health=True):
+        pass
+
+    @abstractmethod
+    def send_command(self, *args, **kwargs):
+        pass
+
+    @abstractmethod
+    def can_read(self, timeout=0):
+        pass
+
+    @abstractmethod
+    def read_response(
+        self,
+        disable_decoding=False,
+        *,
+        disconnect_on_error=True,
+        push_request=False,
+    ):
+        pass
+
+    @abstractmethod
+    def pack_command(self, *args):
+        pass
+
+    @abstractmethod
+    def pack_commands(self, commands):
+        pass
+
+    @property
+    @abstractmethod
+    def handshake_metadata(self) -> Union[Dict[bytes, bytes], Dict[str, str]]:
+        pass
+
+
+class AbstractConnection(ConnectionInterface):
     "Manages communication to and from a Redis server"
 
     def __init__(
@@ -158,13 +230,6 @@ def __init__(
         credential_provider: Optional[CredentialProvider] = None,
         protocol: Optional[int] = 2,
         command_packer: Optional[Callable[[], None]] = None,
-        cache_enabled: bool = False,
-        client_cache: Optional[AbstractCache] = None,
-        cache_max_size: int = 10000,
-        cache_ttl: int = 0,
-        cache_policy: str = DEFAULT_EVICTION_POLICY,
-        cache_deny_list: List[str] = DEFAULT_DENY_LIST,
-        cache_allow_list: List[str] = DEFAULT_ALLOW_LIST,
     ):
         """
         Initialize a new Connection.
@@ -213,6 +278,7 @@ def __init__(
         self.next_health_check = 0
         self.redis_connect_func = redis_connect_func
         self.encoder = Encoder(encoding, encoding_errors, decode_responses)
+        self.handshake_metadata = None
         self._sock = None
         self._socket_read_size = socket_read_size
         self.set_parser(parser_class)
@@ -230,18 +296,6 @@ def __init__(
                 # p = DEFAULT_RESP_VERSION
             self.protocol = p
         self._command_packer = self._construct_command_packer(command_packer)
-        if cache_enabled:
-            _cache = _LocalCache(cache_max_size, cache_ttl, cache_policy)
-        else:
-            _cache = None
-        self.client_cache = client_cache if client_cache is not None else _cache
-        if self.client_cache is not None:
-            if self.protocol not in [3, "3"]:
-                raise RedisError(
-                    "client caching is only supported with protocol version 3 or higher"
-                )
-            self.cache_deny_list = cache_deny_list
-            self.cache_allow_list = cache_allow_list
 
     def __repr__(self):
         repr_args = ",".join([f"{k}={v}" for k, v in self.repr_pieces()])
@@ -367,7 +421,7 @@ def on_connect(self):
             if len(auth_args) == 1:
                 auth_args = ["default", auth_args[0]]
             self.send_command("HELLO", self.protocol, "AUTH", *auth_args)
-            response = self.read_response()
+            self.handshake_metadata = self.read_response()
             # if response.get(b"proto") != self.protocol and response.get(
             #     "proto"
             # ) != self.protocol:
@@ -398,10 +452,10 @@ def on_connect(self):
                 self._parser.EXCEPTION_CLASSES = parser.EXCEPTION_CLASSES
                 self._parser.on_connect(self)
             self.send_command("HELLO", self.protocol)
-            response = self.read_response()
+            self.handshake_metadata = self.read_response()
             if (
-                response.get(b"proto") != self.protocol
-                and response.get("proto") != self.protocol
+                self.handshake_metadata.get(b"proto") != self.protocol
+                and self.handshake_metadata.get("proto") != self.protocol
             ):
                 raise ConnectionError("Invalid RESP version")
 
@@ -432,12 +486,6 @@ def on_connect(self):
             if str_if_bytes(self.read_response()) != "OK":
                 raise ConnectionError("Invalid Database")
 
-        # if client caching is enabled, start tracking
-        if self.client_cache:
-            self.send_command("CLIENT", "TRACKING", "ON")
-            self.read_response()
-            self._parser.set_invalidation_push_handler(self._cache_invalidation_process)
-
     def disconnect(self, *args):
         "Disconnects from the Redis server"
         self._parser.on_disconnect()
@@ -458,9 +506,6 @@ def disconnect(self, *args):
         except OSError:
             pass
 
-        if self.client_cache:
-            self.client_cache.flush()
-
     def _send_ping(self):
         """Send PING, expect PONG in return"""
         self.send_command("PING", check_health=False)
@@ -608,60 +653,16 @@ def pack_commands(self, commands):
             output.append(SYM_EMPTY.join(pieces))
         return output
 
-    def _cache_invalidation_process(
-        self, data: List[Union[str, Optional[List[str]]]]
-    ) -> None:
-        """
-        Invalidate (delete) all redis commands associated with a specific key.
-        `data` is a list of strings, where the first string is the invalidation message
-        and the second string is the list of keys to invalidate.
-        (if the list of keys is None, then all keys are invalidated)
-        """
-        if data[1] is None:
-            self.client_cache.flush()
-        else:
-            for key in data[1]:
-                self.client_cache.invalidate_key(str_if_bytes(key))
-
-    def _get_from_local_cache(self, command: Sequence[str]):
-        """
-        If the command is in the local cache, return the response
-        """
-        if (
-            self.client_cache is None
-            or command[0] in self.cache_deny_list
-            or command[0] not in self.cache_allow_list
-        ):
-            return None
-        while self.can_read():
-            self.read_response(push_request=True)
-        return self.client_cache.get(command)
-
-    def _add_to_local_cache(
-        self, command: Sequence[str], response: ResponseT, keys: List[KeysT]
-    ):
-        """
-        Add the command and response to the local cache if the command
-        is allowed to be cached
-        """
-        if (
-            self.client_cache is not None
-            and (self.cache_deny_list == [] or command[0] not in self.cache_deny_list)
-            and (self.cache_allow_list == [] or command[0] in self.cache_allow_list)
-        ):
-            self.client_cache.set(command, response, keys)
-
-    def flush_cache(self):
-        if self.client_cache:
-            self.client_cache.flush()
+    def get_protocol(self) -> int or str:
+        return self.protocol
 
-    def delete_command_from_cache(self, command: Union[str, Sequence[str]]):
-        if self.client_cache:
-            self.client_cache.delete_command(command)
+    @property
+    def handshake_metadata(self) -> Union[Dict[bytes, bytes], Dict[str, str]]:
+        return self._handshake_metadata
 
-    def invalidate_key_from_cache(self, key: KeysT):
-        if self.client_cache:
-            self.client_cache.invalidate_key(key)
+    @handshake_metadata.setter
+    def handshake_metadata(self, value: Union[Dict[bytes, bytes], Dict[str, str]]):
+        self._handshake_metadata = value
 
 
 class Connection(AbstractConnection):
@@ -734,6 +735,206 @@ def _host_error(self):
         return f"{self.host}:{self.port}"
 
 
+class CacheProxyConnection(ConnectionInterface):
+    DUMMY_CACHE_VALUE = b"foo"
+    MIN_ALLOWED_VERSION = "7.4.0"
+    DEFAULT_SERVER_NAME = "redis"
+
+    def __init__(
+        self,
+        conn: ConnectionInterface,
+        cache: CacheInterface,
+        pool_lock: threading.Lock,
+    ):
+        self.pid = os.getpid()
+        self._conn = conn
+        self.retry = self._conn.retry
+        self.host = self._conn.host
+        self.port = self._conn.port
+        self._pool_lock = pool_lock
+        self._cache = cache
+        self._cache_lock = threading.Lock()
+        self._current_command_cache_key = None
+        self._current_options = None
+        self.register_connect_callback(self._enable_tracking_callback)
+
+    def repr_pieces(self):
+        return self._conn.repr_pieces()
+
+    def register_connect_callback(self, callback):
+        self._conn.register_connect_callback(callback)
+
+    def deregister_connect_callback(self, callback):
+        self._conn.deregister_connect_callback(callback)
+
+    def set_parser(self, parser_class):
+        self._conn.set_parser(parser_class)
+
+    def connect(self):
+        self._conn.connect()
+
+        server_name = self._conn.handshake_metadata.get(b"server", None)
+        if server_name is None:
+            server_name = self._conn.handshake_metadata.get("server", None)
+        server_ver = self._conn.handshake_metadata.get(b"version", None)
+        if server_ver is None:
+            server_ver = self._conn.handshake_metadata.get("version", None)
+        if server_ver is None or server_ver is None:
+            raise ConnectionError("Cannot retrieve information about server version")
+
+        server_ver = ensure_string(server_ver)
+        server_name = ensure_string(server_name)
+
+        if (
+            server_name != self.DEFAULT_SERVER_NAME
+            or compare_versions(server_ver, self.MIN_ALLOWED_VERSION) == 1
+        ):
+            raise ConnectionError(
+                "To maximize compatibility with all Redis products, client-side caching is supported by Redis 7.4 or later"  # noqa: E501
+            )
+
+    def on_connect(self):
+        self._conn.on_connect()
+
+    def disconnect(self, *args):
+        with self._cache_lock:
+            self._cache.flush()
+        self._conn.disconnect(*args)
+
+    def check_health(self):
+        self._conn.check_health()
+
+    def send_packed_command(self, command, check_health=True):
+        # TODO: Investigate if it's possible to unpack command
+        #  or extract keys from packed command
+        self._conn.send_packed_command(command)
+
+    def send_command(self, *args, **kwargs):
+        self._process_pending_invalidations()
+
+        with self._cache_lock:
+            # Command is write command or not allowed
+            # to be cached.
+            if not self._cache.is_cachable(CacheKey(command=args[0], redis_keys=())):
+                self._current_command_cache_key = None
+                self._conn.send_command(*args, **kwargs)
+                return
+
+        if kwargs.get("keys") is None:
+            raise ValueError("Cannot create cache key.")
+
+        # Creates cache key.
+        self._current_command_cache_key = CacheKey(
+            command=args[0], redis_keys=tuple(kwargs.get("keys"))
+        )
+
+        with self._cache_lock:
+            # We have to trigger invalidation processing in case if
+            # it was cached by another connection to avoid
+            # queueing invalidations in stale connections.
+            if self._cache.get(self._current_command_cache_key):
+                entry = self._cache.get(self._current_command_cache_key)
+
+                if entry.connection_ref != self._conn:
+                    with self._pool_lock:
+                        while entry.connection_ref.can_read():
+                            entry.connection_ref.read_response(push_request=True)
+
+                return
+
+            # Set temporary entry value to prevent
+            # race condition from another connection.
+            self._cache.set(
+                CacheEntry(
+                    cache_key=self._current_command_cache_key,
+                    cache_value=self.DUMMY_CACHE_VALUE,
+                    status=CacheEntryStatus.IN_PROGRESS,
+                    connection_ref=self._conn,
+                )
+            )
+
+        # Send command over socket only if it's allowed
+        # read-only command that not yet cached.
+        self._conn.send_command(*args, **kwargs)
+
+    def can_read(self, timeout=0):
+        return self._conn.can_read(timeout)
+
+    def read_response(
+        self, disable_decoding=False, *, disconnect_on_error=True, push_request=False
+    ):
+        with self._cache_lock:
+            # Check if command response exists in a cache and it's not in progress.
+            if (
+                self._current_command_cache_key is not None
+                and self._cache.get(self._current_command_cache_key) is not None
+                and self._cache.get(self._current_command_cache_key).status
+                != CacheEntryStatus.IN_PROGRESS
+            ):
+                return copy.deepcopy(
+                    self._cache.get(self._current_command_cache_key).cache_value
+                )
+
+        response = self._conn.read_response(
+            disable_decoding=disable_decoding,
+            disconnect_on_error=disconnect_on_error,
+            push_request=push_request,
+        )
+
+        with self._cache_lock:
+            # Prevent not-allowed command from caching.
+            if self._current_command_cache_key is None:
+                return response
+            # If response is None prevent from caching.
+            if response is None:
+                self._cache.delete_by_cache_keys([self._current_command_cache_key])
+                return response
+
+            cache_entry = self._cache.get(self._current_command_cache_key)
+
+            # Cache only responses that still valid
+            # and wasn't invalidated by another connection in meantime.
+            if cache_entry is not None:
+                cache_entry.status = CacheEntryStatus.VALID
+                cache_entry.cache_value = response
+                self._cache.set(cache_entry)
+
+        return response
+
+    def pack_command(self, *args):
+        return self._conn.pack_command(*args)
+
+    def pack_commands(self, commands):
+        return self._conn.pack_commands(commands)
+
+    @property
+    def handshake_metadata(self) -> Union[Dict[bytes, bytes], Dict[str, str]]:
+        return self._conn.handshake_metadata
+
+    def _connect(self):
+        self._conn._connect()
+
+    def _host_error(self):
+        self._conn._host_error()
+
+    def _enable_tracking_callback(self, conn: ConnectionInterface) -> None:
+        conn.send_command("CLIENT", "TRACKING", "ON")
+        conn.read_response()
+        conn._parser.set_invalidation_push_handler(self._on_invalidation_callback)
+
+    def _process_pending_invalidations(self):
+        while self.can_read():
+            self._conn.read_response(push_request=True)
+
+    def _on_invalidation_callback(self, data: List[Union[str, Optional[List[bytes]]]]):
+        with self._cache_lock:
+            # Flush cache when DB flushed on server-side
+            if data[1] is None:
+                self._cache.flush()
+            else:
+                self._cache.delete_by_redis_keys(data[1])
+
+
 class SSLConnection(Connection):
     """Manages SSL connections to and from the Redis server(s).
     This class extends the Connection class, adding SSL functionality, and making
@@ -1083,6 +1284,7 @@ def __init__(
         self,
         connection_class=Connection,
         max_connections: Optional[int] = None,
+        cache_factory: Optional[CacheFactoryInterface] = None,
         **connection_kwargs,
     ):
         max_connections = max_connections or 2**31
@@ -1092,6 +1294,30 @@ def __init__(
         self.connection_class = connection_class
         self.connection_kwargs = connection_kwargs
         self.max_connections = max_connections
+        self.cache = None
+        self._cache_factory = cache_factory
+
+        if connection_kwargs.get("cache_config") or connection_kwargs.get("cache"):
+            if connection_kwargs.get("protocol") not in [3, "3"]:
+                raise RedisError("Client caching is only supported with RESP version 3")
+
+            cache = self.connection_kwargs.get("cache")
+
+            if cache is not None:
+                if not isinstance(cache, CacheInterface):
+                    raise ValueError("Cache must implement CacheInterface")
+
+                self.cache = cache
+            else:
+                if self._cache_factory is not None:
+                    self.cache = self._cache_factory.get_cache()
+                else:
+                    self.cache = CacheFactory(
+                        self.connection_kwargs.get("cache_config")
+                    ).get_cache()
+
+        connection_kwargs.pop("cache", None)
+        connection_kwargs.pop("cache_config", None)
 
         # a lock to protect the critical section in _checkpid().
         # this lock is acquired when the process id changes, such as
@@ -1110,6 +1336,14 @@ def __repr__(self) -> (str, str):
             f"({repr(self.connection_class(**self.connection_kwargs))})>"
         )
 
+    def get_protocol(self):
+        """
+        Returns:
+            The RESP protocol version, or ``None`` if the protocol is not specified,
+            in which case the server default will be used.
+        """
+        return self.connection_kwargs.get("protocol", None)
+
     def reset(self) -> None:
         self._lock = threading.Lock()
         self._created_connections = 0
@@ -1187,15 +1421,12 @@ def get_connection(self, command_name: str, *keys, **options) -> "Connection":
         try:
             # ensure this connection is connected to Redis
             connection.connect()
-            # if client caching is not enabled connections that the pool
-            # provides should be ready to send a command.
-            # if not, the connection was either returned to the
+            # connections that the pool provides should be ready to send
+            # a command. if not, the connection was either returned to the
             # pool before all data has been read or the socket has been
             # closed. either way, reconnect and verify everything is good.
-            # (if caching enabled the connection will not always be ready
-            # to send a command because it may contain invalidation messages)
             try:
-                if connection.can_read() and connection.client_cache is None:
+                if connection.can_read() and self.cache is None:
                     raise ConnectionError("Connection has data")
             except (ConnectionError, OSError):
                 connection.disconnect()
@@ -1219,11 +1450,17 @@ def get_encoder(self) -> Encoder:
             decode_responses=kwargs.get("decode_responses", False),
         )
 
-    def make_connection(self) -> "Connection":
+    def make_connection(self) -> "ConnectionInterface":
         "Create a new connection"
         if self._created_connections >= self.max_connections:
             raise ConnectionError("Too many connections")
         self._created_connections += 1
+
+        if self.cache is not None:
+            return CacheProxyConnection(
+                self.connection_class(**self.connection_kwargs), self.cache, self._lock
+            )
+
         return self.connection_class(**self.connection_kwargs)
 
     def release(self, connection: "Connection") -> None:
@@ -1281,27 +1518,6 @@ def set_retry(self, retry: "Retry") -> None:
         for conn in self._in_use_connections:
             conn.retry = retry
 
-    def flush_cache(self):
-        self._checkpid()
-        with self._lock:
-            connections = chain(self._available_connections, self._in_use_connections)
-            for connection in connections:
-                connection.flush_cache()
-
-    def delete_command_from_cache(self, command: str):
-        self._checkpid()
-        with self._lock:
-            connections = chain(self._available_connections, self._in_use_connections)
-            for connection in connections:
-                connection.delete_command_from_cache(command)
-
-    def invalidate_key_from_cache(self, key: str):
-        self._checkpid()
-        with self._lock:
-            connections = chain(self._available_connections, self._in_use_connections)
-            for connection in connections:
-                connection.invalidate_key_from_cache(key)
-
 
 class BlockingConnectionPool(ConnectionPool):
     """
@@ -1379,7 +1595,12 @@ def reset(self):
 
     def make_connection(self):
         "Make a fresh connection."
-        connection = self.connection_class(**self.connection_kwargs)
+        if self.cache is not None:
+            connection = CacheProxyConnection(
+                self.connection_class(**self.connection_kwargs), self.cache, self._lock
+            )
+        else:
+            connection = self.connection_class(**self.connection_kwargs)
         self._connections.append(connection)
         return connection
 
diff --git a/redis/sentinel.py b/redis/sentinel.py
index 72b5bef548..01e210794c 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -229,6 +229,7 @@ def __init__(
         sentinels,
         min_other_sentinels=0,
         sentinel_kwargs=None,
+        force_master_ip=None,
         **connection_kwargs,
     ):
         # if sentinel_kwargs isn't defined, use the socket_* options from
@@ -245,6 +246,7 @@ def __init__(
         ]
         self.min_other_sentinels = min_other_sentinels
         self.connection_kwargs = connection_kwargs
+        self._force_master_ip = force_master_ip
 
     def execute_command(self, *args, **kwargs):
         """
@@ -252,7 +254,6 @@ def execute_command(self, *args, **kwargs):
         once - If set to True, then execute the resulting command on a single
         node at random, rather than across the entire sentinel cluster.
         """
-        kwargs.pop("keys", None)  # the keys are used only for client side caching
         once = bool(kwargs.get("once", False))
         if "once" in kwargs.keys():
             kwargs.pop("once")
@@ -305,7 +306,13 @@ def discover_master(self, service_name):
                     sentinel,
                     self.sentinels[0],
                 )
-                return state["ip"], state["port"]
+
+                ip = (
+                    self._force_master_ip
+                    if self._force_master_ip is not None
+                    else state["ip"]
+                )
+                return ip, state["port"]
 
         error_info = ""
         if len(collected_errors) > 0:
diff --git a/redis/utils.py b/redis/utils.py
index a0f31f7ca4..b4e9afb054 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -153,3 +153,42 @@ def format_error_message(host_error: str, exception: BaseException) -> str:
             f"Error {exception.args[0]} connecting to {host_error}. "
             f"{exception.args[1]}."
         )
+
+
+def compare_versions(version1: str, version2: str) -> int:
+    """
+    Compare two versions.
+
+    :return: -1 if version1 > version2
+             0 if both versions are equal
+             1 if version1 < version2
+    """
+
+    num_versions1 = list(map(int, version1.split(".")))
+    num_versions2 = list(map(int, version2.split(".")))
+
+    if len(num_versions1) > len(num_versions2):
+        diff = len(num_versions1) - len(num_versions2)
+        for _ in range(diff):
+            num_versions2.append(0)
+    elif len(num_versions1) < len(num_versions2):
+        diff = len(num_versions2) - len(num_versions1)
+        for _ in range(diff):
+            num_versions1.append(0)
+
+    for i, ver in enumerate(num_versions1):
+        if num_versions1[i] > num_versions2[i]:
+            return -1
+        elif num_versions1[i] < num_versions2[i]:
+            return 1
+
+    return 0
+
+
+def ensure_string(key):
+    if isinstance(key, bytes):
+        return key.decode("utf-8")
+    elif isinstance(key, str):
+        return key
+    else:
+        raise TypeError("Key must be either a string or bytes")
diff --git a/requirements.txt b/requirements.txt
index 3274a80f62..622f70b810 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1 +1 @@
-async-timeout>=4.0.3
+async-timeout>=4.0.3
\ No newline at end of file
diff --git a/tests/conftest.py b/tests/conftest.py
index dd78bb6a2c..0c98eee4d8 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -11,9 +11,17 @@
 from packaging.version import Version
 from redis import Sentinel
 from redis.backoff import NoBackoff
-from redis.connection import Connection, parse_url
+from redis.cache import (
+    CacheConfig,
+    CacheFactoryInterface,
+    CacheInterface,
+    CacheKey,
+    EvictionPolicy,
+)
+from redis.connection import Connection, ConnectionInterface, SSLConnection, parse_url
 from redis.exceptions import RedisClusterException
 from redis.retry import Retry
+from tests.ssl_utils import get_ssl_filename
 
 REDIS_INFO = {}
 default_redis_url = "redis://localhost:6379/0"
@@ -321,8 +329,22 @@ def _get_client(
         kwargs["protocol"] = request.config.getoption("--protocol")
 
     cluster_mode = REDIS_INFO["cluster_enabled"]
+    ssl = kwargs.pop("ssl", False)
     if not cluster_mode:
         url_options = parse_url(redis_url)
+        connection_class = Connection
+        if ssl:
+            connection_class = SSLConnection
+            kwargs["ssl_certfile"] = get_ssl_filename("client-cert.pem")
+            kwargs["ssl_keyfile"] = get_ssl_filename("client-key.pem")
+            # When you try to assign "required" as single string
+            # it assigns tuple instead of string.
+            # Probably some reserved keyword
+            # I can't explain how does it work -_-
+            kwargs["ssl_cert_reqs"] = "require" + "d"
+            kwargs["ssl_ca_certs"] = get_ssl_filename("ca-cert.pem")
+            kwargs["port"] = 6666
+        kwargs["connection_class"] = connection_class
         url_options.update(kwargs)
         pool = redis.ConnectionPool(**url_options)
         client = cls(connection_pool=pool)
@@ -410,18 +432,25 @@ def sslclient(request):
 
 
 @pytest.fixture()
-def sentinel_setup(local_cache, request):
+def sentinel_setup(request):
     sentinel_ips = request.config.getoption("--sentinels")
     sentinel_endpoints = [
         (ip.strip(), int(port.strip()))
         for ip, port in (endpoint.split(":") for endpoint in sentinel_ips.split(","))
     ]
     kwargs = request.param.get("kwargs", {}) if hasattr(request, "param") else {}
+    cache = request.param.get("cache", None)
+    cache_config = request.param.get("cache_config", None)
+    force_master_ip = request.param.get("force_master_ip", None)
+    decode_responses = request.param.get("decode_responses", False)
     sentinel = Sentinel(
         sentinel_endpoints,
+        force_master_ip=force_master_ip,
         socket_timeout=0.1,
-        client_cache=local_cache,
+        cache=cache,
+        cache_config=cache_config,
         protocol=3,
+        decode_responses=decode_responses,
         **kwargs,
     )
     yield sentinel
@@ -441,7 +470,6 @@ def _gen_cluster_mock_resp(r, response):
     connection = Mock(spec=Connection)
     connection.retry = Retry(NoBackoff(), 0)
     connection.read_response.return_value = response
-    connection._get_from_local_cache.return_value = None
     with mock.patch.object(r, "connection", connection):
         yield r
 
@@ -514,6 +542,37 @@ def master_host(request):
     return parts.hostname, (parts.port or 6379)
 
 
+@pytest.fixture()
+def cache_conf() -> CacheConfig:
+    return CacheConfig(max_size=100, eviction_policy=EvictionPolicy.LRU)
+
+
+@pytest.fixture()
+def mock_cache_factory() -> CacheFactoryInterface:
+    mock_factory = Mock(spec=CacheFactoryInterface)
+    return mock_factory
+
+
+@pytest.fixture()
+def mock_cache() -> CacheInterface:
+    mock_cache = Mock(spec=CacheInterface)
+    return mock_cache
+
+
+@pytest.fixture()
+def mock_connection() -> ConnectionInterface:
+    mock_connection = Mock(spec=ConnectionInterface)
+    return mock_connection
+
+
+@pytest.fixture()
+def cache_key(request) -> CacheKey:
+    command = request.param.get("command")
+    keys = request.param.get("redis_keys")
+
+    return CacheKey(command, keys)
+
+
 def wait_for_command(client, monitor, command, key=None):
     # issue a command with a key name that's local to this process.
     # if we find a command with our key before the command we're waiting
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index 6e93407b4c..41b47b2268 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -146,7 +146,6 @@ def _gen_cluster_mock_resp(r, response):
     connection = mock.AsyncMock(spec=Connection)
     connection.retry = Retry(NoBackoff(), 0)
     connection.read_response.return_value = response
-    connection._get_from_local_cache.return_value = None
     with mock.patch.object(r, "connection", connection):
         yield r
 
diff --git a/tests/test_asyncio/test_cache.py b/tests/test_asyncio/test_cache.py
deleted file mode 100644
index 7a7f881ce2..0000000000
--- a/tests/test_asyncio/test_cache.py
+++ /dev/null
@@ -1,408 +0,0 @@
-import time
-
-import pytest
-import pytest_asyncio
-from redis._cache import EvictionPolicy, _LocalCache
-from redis.utils import HIREDIS_AVAILABLE
-
-
-@pytest_asyncio.fixture
-async def r(request, create_redis):
-    cache = request.param.get("cache")
-    kwargs = request.param.get("kwargs", {})
-    r = await create_redis(protocol=3, client_cache=cache, **kwargs)
-    yield r, cache
-
-
-@pytest_asyncio.fixture()
-async def local_cache():
-    yield _LocalCache()
-
-
-@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
-class TestLocalCache:
-    @pytest.mark.parametrize("r", [{"cache": _LocalCache()}], indirect=True)
-    @pytest.mark.onlynoncluster
-    async def test_get_from_cache(self, r, r2):
-        r, cache = r
-        # add key to redis
-        await r.set("foo", "bar")
-        # get key from redis and save in local cache
-        assert await r.get("foo") == b"bar"
-        # get key from local cache
-        assert cache.get(("GET", "foo")) == b"bar"
-        # change key in redis (cause invalidation)
-        await r2.set("foo", "barbar")
-        # send any command to redis (process invalidation in background)
-        await r.ping()
-        # the command is not in the local cache anymore
-        assert cache.get(("GET", "foo")) is None
-        # get key from redis
-        assert await r.get("foo") == b"barbar"
-
-    @pytest.mark.parametrize("r", [{"cache": _LocalCache(max_size=3)}], indirect=True)
-    async def test_cache_lru_eviction(self, r):
-        r, cache = r
-        # add 3 keys to redis
-        await r.set("foo", "bar")
-        await r.set("foo2", "bar2")
-        await r.set("foo3", "bar3")
-        # get 3 keys from redis and save in local cache
-        assert await r.get("foo") == b"bar"
-        assert await r.get("foo2") == b"bar2"
-        assert await r.get("foo3") == b"bar3"
-        # get the 3 keys from local cache
-        assert cache.get(("GET", "foo")) == b"bar"
-        assert cache.get(("GET", "foo2")) == b"bar2"
-        assert cache.get(("GET", "foo3")) == b"bar3"
-        # add 1 more key to redis (exceed the max size)
-        await r.set("foo4", "bar4")
-        assert await r.get("foo4") == b"bar4"
-        # the first key is not in the local cache anymore
-        assert cache.get(("GET", "foo")) is None
-
-    @pytest.mark.parametrize("r", [{"cache": _LocalCache(ttl=1)}], indirect=True)
-    async def test_cache_ttl(self, r):
-        r, cache = r
-        # add key to redis
-        await r.set("foo", "bar")
-        # get key from redis and save in local cache
-        assert await r.get("foo") == b"bar"
-        # get key from local cache
-        assert cache.get(("GET", "foo")) == b"bar"
-        # wait for the key to expire
-        time.sleep(1)
-        # the key is not in the local cache anymore
-        assert cache.get(("GET", "foo")) is None
-
-    @pytest.mark.parametrize(
-        "r",
-        [{"cache": _LocalCache(max_size=3, eviction_policy=EvictionPolicy.LFU)}],
-        indirect=True,
-    )
-    async def test_cache_lfu_eviction(self, r):
-        r, cache = r
-        # add 3 keys to redis
-        await r.set("foo", "bar")
-        await r.set("foo2", "bar2")
-        await r.set("foo3", "bar3")
-        # get 3 keys from redis and save in local cache
-        assert await r.get("foo") == b"bar"
-        assert await r.get("foo2") == b"bar2"
-        assert await r.get("foo3") == b"bar3"
-        # change the order of the keys in the cache
-        assert cache.get(("GET", "foo")) == b"bar"
-        assert cache.get(("GET", "foo")) == b"bar"
-        assert cache.get(("GET", "foo3")) == b"bar3"
-        # add 1 more key to redis (exceed the max size)
-        await r.set("foo4", "bar4")
-        assert await r.get("foo4") == b"bar4"
-        # test the eviction policy
-        assert len(cache.cache) == 3
-        assert cache.get(("GET", "foo")) == b"bar"
-        assert cache.get(("GET", "foo2")) is None
-
-    @pytest.mark.parametrize(
-        "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
-        indirect=True,
-    )
-    @pytest.mark.onlynoncluster
-    async def test_cache_decode_response(self, r):
-        r, cache = r
-        await r.set("foo", "bar")
-        # get key from redis and save in local cache
-        assert await r.get("foo") == "bar"
-        # get key from local cache
-        assert cache.get(("GET", "foo")) == "bar"
-        # change key in redis (cause invalidation)
-        await r.set("foo", "barbar")
-        # send any command to redis (process invalidation in background)
-        await r.ping()
-        # the command is not in the local cache anymore
-        assert cache.get(("GET", "foo")) is None
-        # get key from redis
-        assert await r.get("foo") == "barbar"
-
-    @pytest.mark.parametrize(
-        "r",
-        [{"cache": _LocalCache(), "kwargs": {"cache_deny_list": ["LLEN"]}}],
-        indirect=True,
-    )
-    async def test_cache_deny_list(self, r):
-        r, cache = r
-        # add list to redis
-        await r.lpush("mylist", "foo", "bar", "baz")
-        assert await r.llen("mylist") == 3
-        assert await r.lindex("mylist", 1) == b"bar"
-        assert cache.get(("LLEN", "mylist")) is None
-        assert cache.get(("LINDEX", "mylist", 1)) == b"bar"
-
-    @pytest.mark.parametrize(
-        "r",
-        [{"cache": _LocalCache(), "kwargs": {"cache_allow_list": ["LLEN"]}}],
-        indirect=True,
-    )
-    async def test_cache_allow_list(self, r):
-        r, cache = r
-        # add list to redis
-        await r.lpush("mylist", "foo", "bar", "baz")
-        assert await r.llen("mylist") == 3
-        assert await r.lindex("mylist", 1) == b"bar"
-        assert cache.get(("LLEN", "mylist")) == 3
-        assert cache.get(("LINDEX", "mylist", 1)) is None
-
-    @pytest.mark.parametrize("r", [{"cache": _LocalCache()}], indirect=True)
-    async def test_cache_return_copy(self, r):
-        r, cache = r
-        await r.lpush("mylist", "foo", "bar", "baz")
-        assert await r.lrange("mylist", 0, -1) == [b"baz", b"bar", b"foo"]
-        res = cache.get(("LRANGE", "mylist", 0, -1))
-        assert res == [b"baz", b"bar", b"foo"]
-        res.append(b"new")
-        check = cache.get(("LRANGE", "mylist", 0, -1))
-        assert check == [b"baz", b"bar", b"foo"]
-
-    @pytest.mark.parametrize(
-        "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
-        indirect=True,
-    )
-    @pytest.mark.onlynoncluster
-    async def test_csc_not_cause_disconnects(self, r):
-        r, cache = r
-        id1 = await r.client_id()
-        await r.mset({"a": 1, "b": 1, "c": 1, "d": 1, "e": 1})
-        assert await r.mget("a", "b", "c", "d", "e") == ["1", "1", "1", "1", "1"]
-        id2 = await r.client_id()
-
-        # client should get value from client cache
-        assert await r.mget("a", "b", "c", "d", "e") == ["1", "1", "1", "1", "1"]
-        assert cache.get(("MGET", "a", "b", "c", "d", "e")) == [
-            "1",
-            "1",
-            "1",
-            "1",
-            "1",
-        ]
-
-        await r.mset({"a": 2, "b": 2, "c": 2, "d": 2, "e": 2})
-        id3 = await r.client_id()
-        # client should get value from redis server post invalidate messages
-        assert await r.mget("a", "b", "c", "d", "e") == ["2", "2", "2", "2", "2"]
-
-        await r.mset({"a": 3, "b": 3, "c": 3, "d": 3, "e": 3})
-        # need to check that we get correct value 3 and not 2
-        assert await r.mget("a", "b", "c", "d", "e") == ["3", "3", "3", "3", "3"]
-        # client should get value from client cache
-        assert await r.mget("a", "b", "c", "d", "e") == ["3", "3", "3", "3", "3"]
-
-        await r.mset({"a": 4, "b": 4, "c": 4, "d": 4, "e": 4})
-        # need to check that we get correct value 4 and not 3
-        assert await r.mget("a", "b", "c", "d", "e") == ["4", "4", "4", "4", "4"]
-        # client should get value from client cache
-        assert await r.mget("a", "b", "c", "d", "e") == ["4", "4", "4", "4", "4"]
-        id4 = await r.client_id()
-        assert id1 == id2 == id3 == id4
-
-    @pytest.mark.parametrize(
-        "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
-        indirect=True,
-    )
-    async def test_execute_command_keys_provided(self, r):
-        r, cache = r
-        assert await r.execute_command("SET", "b", "2") is True
-        assert await r.execute_command("GET", "b", keys=["b"]) == "2"
-        assert cache.get(("GET", "b")) == "2"
-
-    @pytest.mark.parametrize(
-        "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
-        indirect=True,
-    )
-    async def test_execute_command_keys_not_provided(self, r):
-        r, cache = r
-        assert await r.execute_command("SET", "b", "2") is True
-        assert (
-            await r.execute_command("GET", "b") == "2"
-        )  # keys not provided, not cached
-        assert cache.get(("GET", "b")) is None
-
-    @pytest.mark.parametrize(
-        "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
-        indirect=True,
-    )
-    async def test_delete_one_command(self, r):
-        r, cache = r
-        assert await r.mset({"a{a}": 1, "b{a}": 1}) is True
-        assert await r.set("c", 1) is True
-        assert await r.mget("a{a}", "b{a}") == ["1", "1"]
-        assert await r.get("c") == "1"
-        # values should be in local cache
-        assert cache.get(("MGET", "a{a}", "b{a}")) == ["1", "1"]
-        assert cache.get(("GET", "c")) == "1"
-        # delete one command from the cache
-        r.delete_command_from_cache(("MGET", "a{a}", "b{a}"))
-        # the other command is still in the local cache anymore
-        assert cache.get(("MGET", "a{a}", "b{a}")) is None
-        assert cache.get(("GET", "c")) == "1"
-        # get from redis
-        assert await r.mget("a{a}", "b{a}") == ["1", "1"]
-        assert await r.get("c") == "1"
-
-    @pytest.mark.parametrize(
-        "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
-        indirect=True,
-    )
-    async def test_invalidate_key(self, r):
-        r, cache = r
-        assert await r.mset({"a{a}": 1, "b{a}": 1}) is True
-        assert await r.set("c", 1) is True
-        assert await r.mget("a{a}", "b{a}") == ["1", "1"]
-        assert await r.get("c") == "1"
-        # values should be in local cache
-        assert cache.get(("MGET", "a{a}", "b{a}")) == ["1", "1"]
-        assert cache.get(("GET", "c")) == "1"
-        # invalidate one key from the cache
-        r.invalidate_key_from_cache("b{a}")
-        # one other command is still in the local cache anymore
-        assert cache.get(("MGET", "a{a}", "b{a}")) is None
-        assert cache.get(("GET", "c")) == "1"
-        # get from redis
-        assert await r.mget("a{a}", "b{a}") == ["1", "1"]
-        assert await r.get("c") == "1"
-
-    @pytest.mark.parametrize(
-        "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
-        indirect=True,
-    )
-    async def test_flush_entire_cache(self, r):
-        r, cache = r
-        assert await r.mset({"a{a}": 1, "b{a}": 1}) is True
-        assert await r.set("c", 1) is True
-        assert await r.mget("a{a}", "b{a}") == ["1", "1"]
-        assert await r.get("c") == "1"
-        # values should be in local cache
-        assert cache.get(("MGET", "a{a}", "b{a}")) == ["1", "1"]
-        assert cache.get(("GET", "c")) == "1"
-        # flush the local cache
-        r.flush_cache()
-        # the commands are not in the local cache anymore
-        assert cache.get(("MGET", "a{a}", "b{a}")) is None
-        assert cache.get(("GET", "c")) is None
-        # get from redis
-        assert await r.mget("a{a}", "b{a}") == ["1", "1"]
-        assert await r.get("c") == "1"
-
-
-@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
-@pytest.mark.onlycluster
-class TestClusterLocalCache:
-    @pytest.mark.parametrize("r", [{"cache": _LocalCache()}], indirect=True)
-    async def test_get_from_cache(self, r, r2):
-        r, cache = r
-        # add key to redis
-        await r.set("foo", "bar")
-        # get key from redis and save in local cache
-        assert await r.get("foo") == b"bar"
-        # get key from local cache
-        assert cache.get(("GET", "foo")) == b"bar"
-        # change key in redis (cause invalidation)
-        await r2.set("foo", "barbar")
-        # send any command to redis (process invalidation in background)
-        node = r.get_node_from_key("foo")
-        await r.ping(target_nodes=node)
-        # the command is not in the local cache anymore
-        assert cache.get(("GET", "foo")) is None
-        # get key from redis
-        assert await r.get("foo") == b"barbar"
-
-    @pytest.mark.parametrize(
-        "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
-        indirect=True,
-    )
-    async def test_cache_decode_response(self, r):
-        r, cache = r
-        await r.set("foo", "bar")
-        # get key from redis and save in local cache
-        assert await r.get("foo") == "bar"
-        # get key from local cache
-        assert cache.get(("GET", "foo")) == "bar"
-        # change key in redis (cause invalidation)
-        await r.set("foo", "barbar")
-        # send any command to redis (process invalidation in background)
-        node = r.get_node_from_key("foo")
-        await r.ping(target_nodes=node)
-        # the command is not in the local cache anymore
-        assert cache.get(("GET", "foo")) is None
-        # get key from redis
-        assert await r.get("foo") == "barbar"
-
-    @pytest.mark.parametrize(
-        "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
-        indirect=True,
-    )
-    async def test_execute_command_keys_provided(self, r):
-        r, cache = r
-        assert await r.execute_command("SET", "b", "2") is True
-        assert await r.execute_command("GET", "b", keys=["b"]) == "2"
-        assert cache.get(("GET", "b")) == "2"
-
-    @pytest.mark.parametrize(
-        "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
-        indirect=True,
-    )
-    async def test_execute_command_keys_not_provided(self, r):
-        r, cache = r
-        assert await r.execute_command("SET", "b", "2") is True
-        assert (
-            await r.execute_command("GET", "b") == "2"
-        )  # keys not provided, not cached
-        assert cache.get(("GET", "b")) is None
-
-
-@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
-@pytest.mark.onlynoncluster
-class TestSentinelLocalCache:
-
-    async def test_get_from_cache(self, local_cache, master):
-        await master.set("foo", "bar")
-        # get key from redis and save in local cache
-        assert await master.get("foo") == b"bar"
-        # get key from local cache
-        assert local_cache.get(("GET", "foo")) == b"bar"
-        # change key in redis (cause invalidation)
-        await master.set("foo", "barbar")
-        # send any command to redis (process invalidation in background)
-        await master.ping()
-        # the command is not in the local cache anymore
-        assert local_cache.get(("GET", "foo")) is None
-        # get key from redis
-        assert await master.get("foo") == b"barbar"
-
-    @pytest.mark.parametrize(
-        "sentinel_setup",
-        [{"kwargs": {"decode_responses": True}}],
-        indirect=True,
-    )
-    async def test_cache_decode_response(self, local_cache, sentinel_setup, master):
-        await master.set("foo", "bar")
-        # get key from redis and save in local cache
-        assert await master.get("foo") == "bar"
-        # get key from local cache
-        assert local_cache.get(("GET", "foo")) == "bar"
-        # change key in redis (cause invalidation)
-        await master.set("foo", "barbar")
-        # send any command to redis (process invalidation in background)
-        await master.ping()
-        # the command is not in the local cache anymore
-        assert local_cache.get(("GET", "foo")) is None
-        # get key from redis
-        assert await master.get("foo") == "barbar"
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index fefa4ef8f9..e480db332b 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -190,7 +190,6 @@ def mock_node_resp(node: ClusterNode, response: Any) -> ClusterNode:
     connection = mock.AsyncMock(spec=Connection)
     connection.is_connected = True
     connection.read_response.return_value = response
-    connection._get_from_local_cache.return_value = None
     while node._free:
         node._free.pop()
     node._free.append(connection)
@@ -201,7 +200,6 @@ def mock_node_resp_exc(node: ClusterNode, exc: Exception) -> ClusterNode:
     connection = mock.AsyncMock(spec=Connection)
     connection.is_connected = True
     connection.read_response.side_effect = exc
-    connection._get_from_local_cache.return_value = None
     while node._free:
         node._free.pop()
     node._free.append(connection)
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index 8f79f7d947..e584fc6999 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -75,7 +75,6 @@ async def call_with_retry(self, _, __):
 
     mock_conn = mock.AsyncMock(spec=Connection)
     mock_conn.retry = Retry_()
-    mock_conn._get_from_local_cache.return_value = None
 
     async def get_conn(_):
         # Validate only one client is created in single-client mode when
diff --git a/tests/test_asyncio/test_hash.py b/tests/test_asyncio/test_hash.py
index e31ea7eaf3..8d94799fbb 100644
--- a/tests/test_asyncio/test_hash.py
+++ b/tests/test_asyncio/test_hash.py
@@ -177,7 +177,7 @@ async def test_hexpireat_multiple_fields(r):
     )
     exp_time = int((datetime.now() + timedelta(seconds=1)).timestamp())
     assert await r.hexpireat("test:hash", exp_time, "field1", "field2") == [1, 1]
-    await asyncio.sleep(1.1)
+    await asyncio.sleep(1.5)
     assert await r.hexists("test:hash", "field1") is False
     assert await r.hexists("test:hash", "field2") is False
     assert await r.hexists("test:hash", "field3") is True
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index 19d4b1c650..13a6158b40 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -461,7 +461,7 @@ async def test_get_message_without_subscribe(self, r: redis.Redis, pubsub):
 
 @pytest.mark.onlynoncluster
 class TestPubSubRESP3Handler:
-    def my_handler(self, message):
+    async def my_handler(self, message):
         self.message = ["my handler", message]
 
     @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
diff --git a/tests/test_cache.py b/tests/test_cache.py
index 022364e87a..1803646094 100644
--- a/tests/test_cache.py
+++ b/tests/test_cache.py
@@ -1,106 +1,186 @@
 import time
-from collections import defaultdict
-from typing import List, Sequence, Union
 
-import cachetools
 import pytest
 import redis
-from redis import RedisError
-from redis._cache import AbstractCache, EvictionPolicy, _LocalCache
-from redis.typing import KeyT, ResponseT
+from redis.cache import (
+    CacheConfig,
+    CacheEntry,
+    CacheEntryStatus,
+    CacheKey,
+    DefaultCache,
+    EvictionPolicy,
+    EvictionPolicyType,
+    LRUPolicy,
+)
 from redis.utils import HIREDIS_AVAILABLE
-from tests.conftest import _get_client
+from tests.conftest import _get_client, skip_if_resp_version, skip_if_server_version_lt
 
 
 @pytest.fixture()
 def r(request):
     cache = request.param.get("cache")
+    cache_config = request.param.get("cache_config")
     kwargs = request.param.get("kwargs", {})
     protocol = request.param.get("protocol", 3)
+    ssl = request.param.get("ssl", False)
     single_connection_client = request.param.get("single_connection_client", False)
+    decode_responses = request.param.get("decode_responses", False)
     with _get_client(
         redis.Redis,
         request,
-        single_connection_client=single_connection_client,
         protocol=protocol,
-        client_cache=cache,
+        ssl=ssl,
+        single_connection_client=single_connection_client,
+        cache=cache,
+        cache_config=cache_config,
+        decode_responses=decode_responses,
         **kwargs,
     ) as client:
-        yield client, cache
-
-
-@pytest.fixture()
-def local_cache():
-    return _LocalCache()
+        yield client
 
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
-class TestLocalCache:
-    @pytest.mark.parametrize("r", [{"cache": _LocalCache()}], indirect=True)
+@pytest.mark.onlynoncluster
+# @skip_if_resp_version(2)
+@skip_if_server_version_lt("7.4.0")
+class TestCache:
+    @pytest.mark.parametrize(
+        "r",
+        [
+            {
+                "cache": DefaultCache(CacheConfig(max_size=5)),
+                "single_connection_client": True,
+            },
+            {
+                "cache": DefaultCache(CacheConfig(max_size=5)),
+                "single_connection_client": False,
+            },
+            {
+                "cache": DefaultCache(CacheConfig(max_size=5)),
+                "single_connection_client": False,
+                "decode_responses": True,
+            },
+        ],
+        ids=["single", "pool", "decoded"],
+        indirect=True,
+    )
     @pytest.mark.onlynoncluster
-    def test_get_from_cache(self, r, r2):
-        r, cache = r
+    def test_get_from_given_cache(self, r, r2):
+        cache = r.get_cache()
         # add key to redis
         r.set("foo", "bar")
         # get key from redis and save in local cache
-        assert r.get("foo") == b"bar"
+        assert r.get("foo") in [b"bar", "bar"]
         # get key from local cache
-        assert cache.get(("GET", "foo")) == b"bar"
+        assert cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value in [
+            b"bar",
+            "bar",
+        ]
         # change key in redis (cause invalidation)
         r2.set("foo", "barbar")
-        # send any command to redis (process invalidation in background)
-        r.ping()
-        # the command is not in the local cache anymore
-        assert cache.get(("GET", "foo")) is None
-        # get key from redis
-        assert r.get("foo") == b"barbar"
+        # Retrieves a new value from server and cache it
+        assert r.get("foo") in [b"barbar", "barbar"]
+        # Make sure that new value was cached
+        assert cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value in [
+            b"barbar",
+            "barbar",
+        ]
 
     @pytest.mark.parametrize(
         "r",
-        [{"cache": _LocalCache(max_size=3)}],
+        [
+            {
+                "cache_config": CacheConfig(max_size=128),
+                "single_connection_client": True,
+            },
+            {
+                "cache_config": CacheConfig(max_size=128),
+                "single_connection_client": False,
+            },
+            {
+                "cache_config": CacheConfig(max_size=128),
+                "single_connection_client": False,
+                "decode_responses": True,
+            },
+        ],
+        ids=["single", "pool", "decoded"],
         indirect=True,
     )
-    def test_cache_lru_eviction(self, r):
-        r, cache = r
-        # add 3 keys to redis
+    @pytest.mark.onlynoncluster
+    def test_get_from_default_cache(self, r, r2):
+        cache = r.get_cache()
+        assert isinstance(cache.eviction_policy, LRUPolicy)
+        assert cache.config.get_max_size() == 128
+
+        # add key to redis
         r.set("foo", "bar")
-        r.set("foo2", "bar2")
-        r.set("foo3", "bar3")
-        # get 3 keys from redis and save in local cache
-        assert r.get("foo") == b"bar"
-        assert r.get("foo2") == b"bar2"
-        assert r.get("foo3") == b"bar3"
-        # get the 3 keys from local cache
-        assert cache.get(("GET", "foo")) == b"bar"
-        assert cache.get(("GET", "foo2")) == b"bar2"
-        assert cache.get(("GET", "foo3")) == b"bar3"
-        # add 1 more key to redis (exceed the max size)
-        r.set("foo4", "bar4")
-        assert r.get("foo4") == b"bar4"
-        # the first key is not in the local cache anymore
-        assert cache.get(("GET", "foo")) is None
+        # get key from redis and save in local cache
+        assert r.get("foo") in [b"bar", "bar"]
+        # get key from local cache
+        assert cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value in [
+            b"bar",
+            "bar",
+        ]
+        # change key in redis (cause invalidation)
+        r2.set("foo", "barbar")
+        # Retrieves a new value from server and cache it
+        assert r.get("foo") in [b"barbar", "barbar"]
+        # Make sure that new value was cached
+        assert cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value in [
+            b"barbar",
+            "barbar",
+        ]
 
-    @pytest.mark.parametrize("r", [{"cache": _LocalCache(ttl=1)}], indirect=True)
-    def test_cache_ttl(self, r):
-        r, cache = r
+    @pytest.mark.parametrize(
+        "r",
+        [
+            {
+                "cache_config": CacheConfig(max_size=128),
+                "single_connection_client": True,
+            },
+            {
+                "cache_config": CacheConfig(max_size=128),
+                "single_connection_client": False,
+            },
+        ],
+        ids=["single", "pool"],
+        indirect=True,
+    )
+    @pytest.mark.onlynoncluster
+    def test_cache_clears_on_disconnect(self, r, cache):
+        cache = r.get_cache()
         # add key to redis
         r.set("foo", "bar")
         # get key from redis and save in local cache
         assert r.get("foo") == b"bar"
         # get key from local cache
-        assert cache.get(("GET", "foo")) == b"bar"
-        # wait for the key to expire
-        time.sleep(1)
-        # the key is not in the local cache anymore
-        assert cache.get(("GET", "foo")) is None
+        assert (
+            cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value
+            == b"bar"
+        )
+        # Force disconnection
+        r.connection_pool.get_connection("_").disconnect()
+        # Make sure cache is empty
+        assert cache.size == 0
 
     @pytest.mark.parametrize(
         "r",
-        [{"cache": _LocalCache(max_size=3, eviction_policy=EvictionPolicy.LFU)}],
+        [
+            {
+                "cache_config": CacheConfig(max_size=3),
+                "single_connection_client": True,
+            },
+            {
+                "cache_config": CacheConfig(max_size=3),
+                "single_connection_client": False,
+            },
+        ],
+        ids=["single", "pool"],
         indirect=True,
     )
-    def test_cache_lfu_eviction(self, r):
-        r, cache = r
+    @pytest.mark.onlynoncluster
+    def test_cache_lru_eviction(self, r, cache):
+        cache = r.get_cache()
         # add 3 keys to redis
         r.set("foo", "bar")
         r.set("foo2", "bar2")
@@ -109,479 +189,1035 @@ def test_cache_lfu_eviction(self, r):
         assert r.get("foo") == b"bar"
         assert r.get("foo2") == b"bar2"
         assert r.get("foo3") == b"bar3"
-        # change the order of the keys in the cache
-        assert cache.get(("GET", "foo")) == b"bar"
-        assert cache.get(("GET", "foo")) == b"bar"
-        assert cache.get(("GET", "foo3")) == b"bar3"
+        # get the 3 keys from local cache
+        assert (
+            cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value
+            == b"bar"
+        )
+        assert (
+            cache.get(CacheKey(command="GET", redis_keys=("foo2",))).cache_value
+            == b"bar2"
+        )
+        assert (
+            cache.get(CacheKey(command="GET", redis_keys=("foo3",))).cache_value
+            == b"bar3"
+        )
         # add 1 more key to redis (exceed the max size)
         r.set("foo4", "bar4")
         assert r.get("foo4") == b"bar4"
-        # test the eviction policy
-        assert len(cache.cache) == 3
-        assert cache.get(("GET", "foo")) == b"bar"
-        assert cache.get(("GET", "foo2")) is None
+        # the first key is not in the local cache anymore
+        assert cache.get(CacheKey(command="GET", redis_keys=("foo",))) is None
+        assert cache.size == 3
 
     @pytest.mark.parametrize(
         "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        [
+            {
+                "cache_config": CacheConfig(max_size=128),
+                "single_connection_client": True,
+            },
+            {
+                "cache_config": CacheConfig(max_size=128),
+                "single_connection_client": False,
+            },
+        ],
+        ids=["single", "pool"],
         indirect=True,
     )
     @pytest.mark.onlynoncluster
-    def test_cache_decode_response(self, r):
-        r, cache = r
-        r.set("foo", "bar")
-        # get key from redis and save in local cache
-        assert r.get("foo") == "bar"
-        # get key from local cache
-        assert cache.get(("GET", "foo")) == "bar"
-        # change key in redis (cause invalidation)
-        r.set("foo", "barbar")
-        # send any command to redis (process invalidation in background)
-        r.ping()
-        # the command is not in the local cache anymore
-        assert cache.get(("GET", "foo")) is None
-        # get key from redis
-        assert r.get("foo") == "barbar"
+    def test_cache_ignore_not_allowed_command(self, r):
+        cache = r.get_cache()
+        # add fields to hash
+        assert r.hset("foo", "bar", "baz")
+        # get random field
+        assert r.hrandfield("foo") == b"bar"
+        assert cache.get(CacheKey(command="HRANDFIELD", redis_keys=("foo",))) is None
 
     @pytest.mark.parametrize(
         "r",
-        [{"cache": _LocalCache(), "kwargs": {"cache_deny_list": ["LLEN"]}}],
+        [
+            {
+                "cache_config": CacheConfig(max_size=128),
+                "single_connection_client": True,
+            },
+            {
+                "cache_config": CacheConfig(max_size=128),
+                "single_connection_client": False,
+            },
+        ],
+        ids=["single", "pool"],
         indirect=True,
     )
-    def test_cache_deny_list(self, r):
-        r, cache = r
-        # add list to redis
-        r.lpush("mylist", "foo", "bar", "baz")
-        assert r.llen("mylist") == 3
-        assert r.lindex("mylist", 1) == b"bar"
-        assert cache.get(("LLEN", "mylist")) is None
-        assert cache.get(("LINDEX", "mylist", 1)) == b"bar"
+    @pytest.mark.onlynoncluster
+    def test_cache_invalidate_all_related_responses(self, r):
+        cache = r.get_cache()
+        # Add keys
+        assert r.set("foo", "bar")
+        assert r.set("bar", "foo")
 
-    @pytest.mark.parametrize(
-        "r",
-        [{"cache": _LocalCache(), "kwargs": {"cache_allow_list": ["LLEN"]}}],
-        indirect=True,
-    )
-    def test_cache_allow_list(self, r):
-        r, cache = r
-        r.lpush("mylist", "foo", "bar", "baz")
-        assert r.llen("mylist") == 3
-        assert r.lindex("mylist", 1) == b"bar"
-        assert cache.get(("LLEN", "mylist")) == 3
-        assert cache.get(("LINDEX", "mylist", 1)) is None
-
-    @pytest.mark.parametrize("r", [{"cache": _LocalCache()}], indirect=True)
-    def test_cache_return_copy(self, r):
-        r, cache = r
-        r.lpush("mylist", "foo", "bar", "baz")
-        assert r.lrange("mylist", 0, -1) == [b"baz", b"bar", b"foo"]
-        res = cache.get(("LRANGE", "mylist", 0, -1))
-        assert res == [b"baz", b"bar", b"foo"]
-        res.append(b"new")
-        check = cache.get(("LRANGE", "mylist", 0, -1))
-        assert check == [b"baz", b"bar", b"foo"]
+        res = r.mget("foo", "bar")
+        # Make sure that replies was cached
+        assert res == [b"bar", b"foo"]
+        assert (
+            cache.get(CacheKey(command="MGET", redis_keys=("foo", "bar"))).cache_value
+            == res
+        )
+
+        # Make sure that objects are immutable.
+        another_res = r.mget("foo", "bar")
+        res.append(b"baz")
+        assert another_res != res
+
+        # Invalidate one of the keys and make sure that
+        # all associated cached entries was removed
+        assert r.set("foo", "baz")
+        assert r.get("foo") == b"baz"
+        assert cache.get(CacheKey(command="MGET", redis_keys=("foo", "bar"))) is None
+        assert (
+            cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value
+            == b"baz"
+        )
 
     @pytest.mark.parametrize(
         "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        [
+            {
+                "cache_config": CacheConfig(max_size=128),
+                "single_connection_client": True,
+            },
+            {
+                "cache_config": CacheConfig(max_size=128),
+                "single_connection_client": False,
+            },
+        ],
+        ids=["single", "pool"],
         indirect=True,
     )
     @pytest.mark.onlynoncluster
-    def test_csc_not_cause_disconnects(self, r):
-        r, cache = r
-        id1 = r.client_id()
-        r.mset({"a": 1, "b": 1, "c": 1, "d": 1, "e": 1, "f": 1})
-        assert r.mget("a", "b", "c", "d", "e", "f") == ["1", "1", "1", "1", "1", "1"]
-        id2 = r.client_id()
-
-        # client should get value from client cache
-        assert r.mget("a", "b", "c", "d", "e", "f") == ["1", "1", "1", "1", "1", "1"]
-        assert cache.get(("MGET", "a", "b", "c", "d", "e", "f")) == [
-            "1",
-            "1",
-            "1",
-            "1",
-            "1",
-            "1",
-        ]
+    def test_cache_flushed_on_server_flush(self, r):
+        cache = r.get_cache()
+        # Add keys
+        assert r.set("foo", "bar")
+        assert r.set("bar", "foo")
+        assert r.set("baz", "bar")
+
+        # Make sure that replies was cached
+        assert r.get("foo") == b"bar"
+        assert r.get("bar") == b"foo"
+        assert r.get("baz") == b"bar"
+        assert (
+            cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value
+            == b"bar"
+        )
+        assert (
+            cache.get(CacheKey(command="GET", redis_keys=("bar",))).cache_value
+            == b"foo"
+        )
+        assert (
+            cache.get(CacheKey(command="GET", redis_keys=("baz",))).cache_value
+            == b"bar"
+        )
+
+        # Flush server and trying to access cached entry
+        assert r.flushall()
+        assert r.get("foo") is None
+        assert cache.size == 0
 
-        r.mset({"a": 2, "b": 2, "c": 2, "d": 2, "e": 2, "f": 2})
-        id3 = r.client_id()
-        # client should get value from redis server post invalidate messages
-        assert r.mget("a", "b", "c", "d", "e", "f") == ["2", "2", "2", "2", "2", "2"]
-
-        r.mset({"a": 3, "b": 3, "c": 3, "d": 3, "e": 3, "f": 3})
-        # need to check that we get correct value 3 and not 2
-        assert r.mget("a", "b", "c", "d", "e", "f") == ["3", "3", "3", "3", "3", "3"]
-        # client should get value from client cache
-        assert r.mget("a", "b", "c", "d", "e", "f") == ["3", "3", "3", "3", "3", "3"]
-
-        r.mset({"a": 4, "b": 4, "c": 4, "d": 4, "e": 4, "f": 4})
-        # need to check that we get correct value 4 and not 3
-        assert r.mget("a", "b", "c", "d", "e", "f") == ["4", "4", "4", "4", "4", "4"]
-        # client should get value from client cache
-        assert r.mget("a", "b", "c", "d", "e", "f") == ["4", "4", "4", "4", "4", "4"]
-        id4 = r.client_id()
-        assert id1 == id2 == id3 == id4
 
+@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+@pytest.mark.onlycluster
+@skip_if_resp_version(2)
+@skip_if_server_version_lt("7.4.0")
+class TestClusterCache:
     @pytest.mark.parametrize(
         "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        [
+            {
+                "cache": DefaultCache(CacheConfig(max_size=128)),
+            },
+            {
+                "cache": DefaultCache(CacheConfig(max_size=128)),
+                "decode_responses": True,
+            },
+        ],
         indirect=True,
     )
-    @pytest.mark.onlynoncluster
-    def test_multiple_commands_same_key(self, r):
-        r, cache = r
-        r.mset({"a": 1, "b": 1})
-        assert r.mget("a", "b") == ["1", "1"]
-        # value should be in local cache
-        assert cache.get(("MGET", "a", "b")) == ["1", "1"]
-        # set only one key
-        r.set("a", 2)
-        # send any command to redis (process invalidation in background)
-        r.ping()
-        # the command is not in the local cache anymore
-        assert cache.get(("MGET", "a", "b")) is None
-        # get from redis
-        assert r.mget("a", "b") == ["2", "1"]
+    @pytest.mark.onlycluster
+    def test_get_from_cache(self, r):
+        cache = r.nodes_manager.get_node_from_slot(12000).redis_connection.get_cache()
+        # add key to redis
+        r.set("foo", "bar")
+        # get key from redis and save in local cache
+        assert r.get("foo") in [b"bar", "bar"]
+        # get key from local cache
+        assert cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value in [
+            b"bar",
+            "bar",
+        ]
+        # change key in redis (cause invalidation)
+        r.set("foo", "barbar")
+        # Retrieves a new value from server and cache it
+        assert r.get("foo") in [b"barbar", "barbar"]
+        # Make sure that new value was cached
+        assert cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value in [
+            b"barbar",
+            "barbar",
+        ]
+        # Make sure that cache is shared between nodes.
+        assert (
+            cache == r.nodes_manager.get_node_from_slot(1).redis_connection.get_cache()
+        )
 
     @pytest.mark.parametrize(
         "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        [
+            {
+                "cache_config": CacheConfig(max_size=128),
+            },
+            {
+                "cache_config": CacheConfig(max_size=128),
+                "decode_responses": True,
+            },
+        ],
         indirect=True,
     )
-    def test_delete_one_command(self, r):
-        r, cache = r
-        r.mset({"a{a}": 1, "b{a}": 1})
-        r.set("c", 1)
-        assert r.mget("a{a}", "b{a}") == ["1", "1"]
-        assert r.get("c") == "1"
-        # values should be in local cache
-        assert cache.get(("MGET", "a{a}", "b{a}")) == ["1", "1"]
-        assert cache.get(("GET", "c")) == "1"
-        # delete one command from the cache
-        r.delete_command_from_cache(("MGET", "a{a}", "b{a}"))
-        # the other command is still in the local cache anymore
-        assert cache.get(("MGET", "a{a}", "b{a}")) is None
-        assert cache.get(("GET", "c")) == "1"
-        # get from redis
-        assert r.mget("a{a}", "b{a}") == ["1", "1"]
-        assert r.get("c") == "1"
+    def test_get_from_custom_cache(self, r, r2):
+        cache = r.nodes_manager.get_node_from_slot(12000).redis_connection.get_cache()
+        assert isinstance(cache.eviction_policy, LRUPolicy)
+        assert cache.config.get_max_size() == 128
+
+        # add key to redis
+        assert r.set("foo", "bar")
+        # get key from redis and save in local cache
+        assert r.get("foo") in [b"bar", "bar"]
+        # get key from local cache
+        assert cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value in [
+            b"bar",
+            "bar",
+        ]
+        # change key in redis (cause invalidation)
+        r2.set("foo", "barbar")
+        # Retrieves a new value from server and cache it
+        assert r.get("foo") in [b"barbar", "barbar"]
+        # Make sure that new value was cached
+        assert cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value in [
+            b"barbar",
+            "barbar",
+        ]
 
     @pytest.mark.parametrize(
         "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        [
+            {
+                "cache_config": CacheConfig(max_size=128),
+            },
+        ],
         indirect=True,
     )
-    def test_delete_several_commands(self, r):
-        r, cache = r
-        r.mset({"a{a}": 1, "b{a}": 1})
-        r.set("c", 1)
-        assert r.mget("a{a}", "b{a}") == ["1", "1"]
-        assert r.get("c") == "1"
-        # values should be in local cache
-        assert cache.get(("MGET", "a{a}", "b{a}")) == ["1", "1"]
-        assert cache.get(("GET", "c")) == "1"
-        # delete the commands from the cache
-        cache.delete_commands([("MGET", "a{a}", "b{a}"), ("GET", "c")])
-        # the commands are not in the local cache anymore
-        assert cache.get(("MGET", "a{a}", "b{a}")) is None
-        assert cache.get(("GET", "c")) is None
-        # get from redis
-        assert r.mget("a{a}", "b{a}") == ["1", "1"]
-        assert r.get("c") == "1"
+    @pytest.mark.onlycluster
+    def test_cache_clears_on_disconnect(self, r, r2):
+        cache = r.nodes_manager.get_node_from_slot(12000).redis_connection.get_cache()
+        # add key to redis
+        r.set("foo", "bar")
+        # get key from redis and save in local cache
+        assert r.get("foo") == b"bar"
+        # get key from local cache
+        assert (
+            cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value
+            == b"bar"
+        )
+        # Force disconnection
+        r.nodes_manager.get_node_from_slot(
+            12000
+        ).redis_connection.connection_pool.get_connection("_").disconnect()
+        # Make sure cache is empty
+        assert cache.size == 0
 
     @pytest.mark.parametrize(
         "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        [
+            {
+                "cache_config": CacheConfig(max_size=3),
+            },
+        ],
         indirect=True,
     )
-    def test_invalidate_key(self, r):
-        r, cache = r
-        r.mset({"a{a}": 1, "b{a}": 1})
-        r.set("c", 1)
-        assert r.mget("a{a}", "b{a}") == ["1", "1"]
-        assert r.get("c") == "1"
-        # values should be in local cache
-        assert cache.get(("MGET", "a{a}", "b{a}")) == ["1", "1"]
-        assert cache.get(("GET", "c")) == "1"
-        # invalidate one key from the cache
-        r.invalidate_key_from_cache("b{a}")
-        # one other command is still in the local cache anymore
-        assert cache.get(("MGET", "a{a}", "b{a}")) is None
-        assert cache.get(("GET", "c")) == "1"
-        # get from redis
-        assert r.mget("a{a}", "b{a}") == ["1", "1"]
-        assert r.get("c") == "1"
+    @pytest.mark.onlycluster
+    def test_cache_lru_eviction(self, r):
+        cache = r.nodes_manager.get_node_from_slot(10).redis_connection.get_cache()
+        # add 3 keys to redis
+        r.set("foo{slot}", "bar")
+        r.set("foo2{slot}", "bar2")
+        r.set("foo3{slot}", "bar3")
+        # get 3 keys from redis and save in local cache
+        assert r.get("foo{slot}") == b"bar"
+        assert r.get("foo2{slot}") == b"bar2"
+        assert r.get("foo3{slot}") == b"bar3"
+        # get the 3 keys from local cache
+        assert (
+            cache.get(CacheKey(command="GET", redis_keys=("foo{slot}",))).cache_value
+            == b"bar"
+        )
+        assert (
+            cache.get(CacheKey(command="GET", redis_keys=("foo2{slot}",))).cache_value
+            == b"bar2"
+        )
+        assert (
+            cache.get(CacheKey(command="GET", redis_keys=("foo3{slot}",))).cache_value
+            == b"bar3"
+        )
+        # add 1 more key to redis (exceed the max size)
+        r.set("foo4{slot}", "bar4")
+        assert r.get("foo4{slot}") == b"bar4"
+        # the first key is not in the local cache_data anymore
+        assert cache.get(CacheKey(command="GET", redis_keys=("foo{slot}",))) is None
 
     @pytest.mark.parametrize(
         "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        [
+            {
+                "cache_config": CacheConfig(max_size=128),
+            },
+        ],
         indirect=True,
     )
-    def test_flush_entire_cache(self, r):
-        r, cache = r
-        r.mset({"a{a}": 1, "b{a}": 1})
-        r.set("c", 1)
-        assert r.mget("a{a}", "b{a}") == ["1", "1"]
-        assert r.get("c") == "1"
-        # values should be in local cache
-        assert cache.get(("MGET", "a{a}", "b{a}")) == ["1", "1"]
-        assert cache.get(("GET", "c")) == "1"
-        # flush the local cache
-        r.flush_cache()
-        # the commands are not in the local cache anymore
-        assert cache.get(("MGET", "a{a}", "b{a}")) is None
-        assert cache.get(("GET", "c")) is None
-        # get from redis
-        assert r.mget("a{a}", "b{a}") == ["1", "1"]
-        assert r.get("c") == "1"
-
-    @pytest.mark.onlynoncluster
-    def test_cache_not_available_with_resp2(self, request):
-        with pytest.raises(RedisError) as e:
-            _get_client(redis.Redis, request, protocol=2, client_cache=_LocalCache())
-        assert "protocol version 3 or higher" in str(e.value)
+    @pytest.mark.onlycluster
+    def test_cache_ignore_not_allowed_command(self, r):
+        cache = r.nodes_manager.get_node_from_slot(12000).redis_connection.get_cache()
+        # add fields to hash
+        assert r.hset("foo", "bar", "baz")
+        # get random field
+        assert r.hrandfield("foo") == b"bar"
+        assert cache.get(CacheKey(command="HRANDFIELD", redis_keys=("foo",))) is None
 
     @pytest.mark.parametrize(
         "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        [
+            {
+                "cache_config": CacheConfig(max_size=128),
+            },
+        ],
         indirect=True,
     )
-    @pytest.mark.onlynoncluster
-    def test_execute_command_args_not_split(self, r):
-        r, cache = r
-        assert r.execute_command("SET a 1") == "OK"
-        assert r.execute_command("GET a") == "1"
-        # "get a" is not whitelisted by default, the args should be separated
-        assert cache.get(("GET a",)) is None
+    @pytest.mark.onlycluster
+    def test_cache_invalidate_all_related_responses(self, r, cache):
+        cache = r.nodes_manager.get_node_from_slot(10).redis_connection.get_cache()
+        # Add keys
+        assert r.set("foo{slot}", "bar")
+        assert r.set("bar{slot}", "foo")
+
+        # Make sure that replies was cached
+        assert r.mget("foo{slot}", "bar{slot}") == [b"bar", b"foo"]
+        assert cache.get(
+            CacheKey(command="MGET", redis_keys=("foo{slot}", "bar{slot}")),
+        ).cache_value == [b"bar", b"foo"]
+
+        # Invalidate one of the keys and make sure
+        # that all associated cached entries was removed
+        assert r.set("foo{slot}", "baz")
+        assert r.get("foo{slot}") == b"baz"
+        assert (
+            cache.get(
+                CacheKey(command="MGET", redis_keys=("foo{slot}", "bar{slot}")),
+            )
+            is None
+        )
+        assert (
+            cache.get(CacheKey(command="GET", redis_keys=("foo{slot}",))).cache_value
+            == b"baz"
+        )
 
     @pytest.mark.parametrize(
         "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        [
+            {
+                "cache_config": CacheConfig(max_size=128),
+            },
+        ],
         indirect=True,
     )
-    def test_execute_command_keys_provided(self, r):
-        r, cache = r
-        assert r.execute_command("SET", "b", "2") is True
-        assert r.execute_command("GET", "b", keys=["b"]) == "2"
-        assert cache.get(("GET", "b")) == "2"
+    @pytest.mark.onlycluster
+    def test_cache_flushed_on_server_flush(self, r, cache):
+        cache = r.nodes_manager.get_node_from_slot(10).redis_connection.get_cache()
+        # Add keys
+        assert r.set("foo{slot}", "bar")
+        assert r.set("bar{slot}", "foo")
+        assert r.set("baz{slot}", "bar")
+
+        # Make sure that replies was cached
+        assert r.get("foo{slot}") == b"bar"
+        assert r.get("bar{slot}") == b"foo"
+        assert r.get("baz{slot}") == b"bar"
+        assert (
+            cache.get(CacheKey(command="GET", redis_keys=("foo{slot}",))).cache_value
+            == b"bar"
+        )
+        assert (
+            cache.get(CacheKey(command="GET", redis_keys=("bar{slot}",))).cache_value
+            == b"foo"
+        )
+        assert (
+            cache.get(CacheKey(command="GET", redis_keys=("baz{slot}",))).cache_value
+            == b"bar"
+        )
 
+        # Flush server and trying to access cached entry
+        assert r.flushall()
+        assert r.get("foo{slot}") is None
+        assert cache.size == 0
+
+
+@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+@pytest.mark.onlynoncluster
+@skip_if_resp_version(2)
+@skip_if_server_version_lt("7.4.0")
+class TestSentinelCache:
     @pytest.mark.parametrize(
-        "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        "sentinel_setup",
+        [
+            {
+                "cache": DefaultCache(CacheConfig(max_size=128)),
+                "force_master_ip": "localhost",
+            },
+            {
+                "cache": DefaultCache(CacheConfig(max_size=128)),
+                "force_master_ip": "localhost",
+                "decode_responses": True,
+            },
+        ],
         indirect=True,
     )
-    def test_execute_command_keys_not_provided(self, r):
-        r, cache = r
-        assert r.execute_command("SET", "b", "2") is True
-        assert r.execute_command("GET", "b") == "2"  # keys not provided, not cached
-        assert cache.get(("GET", "b")) is None
+    @pytest.mark.onlynoncluster
+    def test_get_from_cache(self, master):
+        cache = master.get_cache()
+        master.set("foo", "bar")
+        # get key from redis and save in local cache_data
+        assert master.get("foo") in [b"bar", "bar"]
+        # get key from local cache_data
+        assert cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value in [
+            b"bar",
+            "bar",
+        ]
+        # change key in redis (cause invalidation)
+        master.set("foo", "barbar")
+        # get key from redis
+        assert master.get("foo") in [b"barbar", "barbar"]
+        # Make sure that new value was cached
+        assert cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value in [
+            b"barbar",
+            "barbar",
+        ]
 
     @pytest.mark.parametrize(
         "r",
-        [{"cache": _LocalCache(), "single_connection_client": True}],
+        [
+            {
+                "cache_config": CacheConfig(max_size=128),
+            },
+            {
+                "cache_config": CacheConfig(max_size=128),
+                "decode_responses": True,
+            },
+        ],
         indirect=True,
     )
-    @pytest.mark.onlynoncluster
-    def test_single_connection(self, r):
-        r, cache = r
-        # add key to redis
-        r.set("foo", "bar")
-        # get key from redis and save in local cache
-        assert r.get("foo") == b"bar"
-        # get key from local cache
-        assert cache.get(("GET", "foo")) == b"bar"
-        # change key in redis (cause invalidation)
-        r.set("foo", "barbar")
-        # send any command to redis (process invalidation in background)
-        r.ping()
-        # the command is not in the local cache anymore
-        assert cache.get(("GET", "foo")) is None
-        # get key from redis
-        assert r.get("foo") == b"barbar"
+    def test_get_from_default_cache(self, r, r2):
+        cache = r.get_cache()
+        assert isinstance(cache.eviction_policy, LRUPolicy)
 
-    @pytest.mark.parametrize("r", [{"cache": _LocalCache()}], indirect=True)
-    def test_get_from_cache_invalidate_via_get(self, r, r2):
-        r, cache = r
         # add key to redis
         r.set("foo", "bar")
-        # get key from redis and save in local cache
-        assert r.get("foo") == b"bar"
-        # get key from local cache
-        assert cache.get(("GET", "foo")) == b"bar"
+        # get key from redis and save in local cache_data
+        assert r.get("foo") in [b"bar", "bar"]
+        # get key from local cache_data
+        assert cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value in [
+            b"bar",
+            "bar",
+        ]
         # change key in redis (cause invalidation)
         r2.set("foo", "barbar")
-        # don't send any command to redis, just run another get
-        # it should process the invalidation in background
-        assert r.get("foo") == b"barbar"
+        # Retrieves a new value from server and cache_data it
+        assert r.get("foo") in [b"barbar", "barbar"]
+        # Make sure that new value was cached
+        assert cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value in [
+            b"barbar",
+            "barbar",
+        ]
+
+    @pytest.mark.parametrize(
+        "sentinel_setup",
+        [
+            {
+                "cache_config": CacheConfig(max_size=128),
+                "force_master_ip": "localhost",
+            }
+        ],
+        indirect=True,
+    )
+    @pytest.mark.onlynoncluster
+    def test_cache_clears_on_disconnect(self, master, cache):
+        cache = master.get_cache()
+        # add key to redis
+        master.set("foo", "bar")
+        # get key from redis and save in local cache_data
+        assert master.get("foo") == b"bar"
+        # get key from local cache_data
+        assert (
+            cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value
+            == b"bar"
+        )
+        # Force disconnection
+        master.connection_pool.get_connection("_").disconnect()
+        # Make sure cache_data is empty
+        assert cache.size == 0
 
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
-@pytest.mark.onlycluster
-class TestClusterLocalCache:
-    @pytest.mark.parametrize("r", [{"cache": _LocalCache()}], indirect=True)
-    def test_get_from_cache(self, r, r2):
-        r, cache = r
+@pytest.mark.onlynoncluster
+@skip_if_resp_version(2)
+@skip_if_server_version_lt("7.4.0")
+class TestSSLCache:
+    @pytest.mark.parametrize(
+        "r",
+        [
+            {
+                "cache": DefaultCache(CacheConfig(max_size=128)),
+                "ssl": True,
+            },
+            {
+                "cache": DefaultCache(CacheConfig(max_size=128)),
+                "ssl": True,
+                "decode_responses": True,
+            },
+        ],
+        indirect=True,
+    )
+    @pytest.mark.onlynoncluster
+    def test_get_from_cache(self, r, r2, cache):
+        cache = r.get_cache()
         # add key to redis
         r.set("foo", "bar")
-        # get key from redis and save in local cache
-        assert r.get("foo") == b"bar"
-        # get key from local cache
-        assert cache.get(("GET", "foo")) == b"bar"
+        # get key from redis and save in local cache_data
+        assert r.get("foo") in [b"bar", "bar"]
+        # get key from local cache_data
+        assert cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value in [
+            b"bar",
+            "bar",
+        ]
         # change key in redis (cause invalidation)
-        r2.set("foo", "barbar")
-        # send any command to redis (process invalidation in background)
-        node = r.get_node_from_key("foo")
-        r.ping(target_nodes=node)
-        # the command is not in the local cache anymore
-        assert cache.get(("GET", "foo")) is None
-        # get key from redis
-        assert r.get("foo") == b"barbar"
+        assert r2.set("foo", "barbar")
+        # Timeout needed for SSL connection because there's timeout
+        # between data appears in socket buffer
+        time.sleep(0.1)
+        # Retrieves a new value from server and cache_data it
+        assert r.get("foo") in [b"barbar", "barbar"]
+        # Make sure that new value was cached
+        assert cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value in [
+            b"barbar",
+            "barbar",
+        ]
 
     @pytest.mark.parametrize(
         "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        [
+            {
+                "cache_config": CacheConfig(max_size=128),
+                "ssl": True,
+            },
+            {
+                "cache_config": CacheConfig(max_size=128),
+                "ssl": True,
+                "decode_responses": True,
+            },
+        ],
         indirect=True,
     )
-    def test_cache_decode_response(self, r):
-        r, cache = r
+    def test_get_from_custom_cache(self, r, r2):
+        cache = r.get_cache()
+        assert isinstance(cache.eviction_policy, LRUPolicy)
+
+        # add key to redis
         r.set("foo", "bar")
-        # get key from redis and save in local cache
-        assert r.get("foo") == "bar"
-        # get key from local cache
-        assert cache.get(("GET", "foo")) == "bar"
+        # get key from redis and save in local cache_data
+        assert r.get("foo") in [b"bar", "bar"]
+        # get key from local cache_data
+        assert cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value in [
+            b"bar",
+            "bar",
+        ]
         # change key in redis (cause invalidation)
-        r.set("foo", "barbar")
-        # send any command to redis (process invalidation in background)
-        node = r.get_node_from_key("foo")
-        r.ping(target_nodes=node)
-        # the command is not in the local cache anymore
-        assert cache.get(("GET", "foo")) is None
-        # get key from redis
-        assert r.get("foo") == "barbar"
+        r2.set("foo", "barbar")
+        # Timeout needed for SSL connection because there's timeout
+        # between data appears in socket buffer
+        time.sleep(0.1)
+        # Retrieves a new value from server and cache_data it
+        assert r.get("foo") in [b"barbar", "barbar"]
+        # Make sure that new value was cached
+        assert cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value in [
+            b"barbar",
+            "barbar",
+        ]
 
     @pytest.mark.parametrize(
         "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
+        [
+            {
+                "cache_config": CacheConfig(max_size=128),
+                "ssl": True,
+            }
+        ],
         indirect=True,
     )
-    def test_execute_command_keys_provided(self, r):
-        r, cache = r
-        assert r.execute_command("SET", "b", "2") is True
-        assert r.execute_command("GET", "b", keys=["b"]) == "2"
-        assert cache.get(("GET", "b")) == "2"
+    @pytest.mark.onlynoncluster
+    def test_cache_invalidate_all_related_responses(self, r):
+        cache = r.get_cache()
+        # Add keys
+        assert r.set("foo", "bar")
+        assert r.set("bar", "foo")
+
+        # Make sure that replies was cached
+        assert r.mget("foo", "bar") == [b"bar", b"foo"]
+        assert cache.get(
+            CacheKey(command="MGET", redis_keys=("foo", "bar"))
+        ).cache_value == [b"bar", b"foo"]
+
+        # Invalidate one of the keys and make sure
+        # that all associated cached entries was removed
+        assert r.set("foo", "baz")
+        # Timeout needed for SSL connection because there's timeout
+        # between data appears in socket buffer
+        time.sleep(0.1)
+        assert r.get("foo") == b"baz"
+        assert cache.get(CacheKey(command="MGET", redis_keys=("foo", "bar"))) is None
+        assert (
+            cache.get(CacheKey(command="GET", redis_keys=("foo",))).cache_value
+            == b"baz"
+        )
+
+
+class TestUnitDefaultCache:
+    def test_get_eviction_policy(self):
+        cache = DefaultCache(CacheConfig(max_size=5))
+        assert isinstance(cache.eviction_policy, LRUPolicy)
+
+    def test_get_max_size(self):
+        cache = DefaultCache(CacheConfig(max_size=5))
+        assert cache.config.get_max_size() == 5
+
+    def test_get_size(self):
+        cache = DefaultCache(CacheConfig(max_size=5))
+        assert cache.size == 0
 
     @pytest.mark.parametrize(
-        "r",
-        [{"cache": _LocalCache(), "kwargs": {"decode_responses": True}}],
-        indirect=True,
+        "cache_key", [{"command": "GET", "redis_keys": ("bar",)}], indirect=True
     )
-    def test_execute_command_keys_not_provided(self, r):
-        r, cache = r
-        assert r.execute_command("SET", "b", "2") is True
-        assert r.execute_command("GET", "b") == "2"  # keys not provided, not cached
-        assert cache.get(("GET", "b")) is None
+    def test_set_non_existing_cache_key(self, cache_key, mock_connection):
+        cache = DefaultCache(CacheConfig(max_size=5))
 
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key,
+                cache_value=b"val",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+        assert cache.get(cache_key).cache_value == b"val"
 
-@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
-@pytest.mark.onlynoncluster
-class TestSentinelLocalCache:
+    @pytest.mark.parametrize(
+        "cache_key", [{"command": "GET", "redis_keys": ("bar",)}], indirect=True
+    )
+    def test_set_updates_existing_cache_key(self, cache_key, mock_connection):
+        cache = DefaultCache(CacheConfig(max_size=5))
 
-    def test_get_from_cache(self, local_cache, master):
-        master.set("foo", "bar")
-        # get key from redis and save in local cache
-        assert master.get("foo") == b"bar"
-        # get key from local cache
-        assert local_cache.get(("GET", "foo")) == b"bar"
-        # change key in redis (cause invalidation)
-        master.set("foo", "barbar")
-        # send any command to redis (process invalidation in background)
-        master.ping()
-        # the command is not in the local cache anymore
-        assert local_cache.get(("GET", "foo")) is None
-        # get key from redis
-        assert master.get("foo") == b"barbar"
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key,
+                cache_value=b"val",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+        assert cache.get(cache_key).cache_value == b"val"
+
+        cache.set(
+            CacheEntry(
+                cache_key=cache_key,
+                cache_value=b"new_val",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+        assert cache.get(cache_key).cache_value == b"new_val"
 
     @pytest.mark.parametrize(
-        "sentinel_setup",
-        [{"kwargs": {"decode_responses": True}}],
-        indirect=True,
+        "cache_key", [{"command": "HRANDFIELD", "redis_keys": ("bar",)}], indirect=True
     )
-    def test_cache_decode_response(self, local_cache, sentinel_setup, master):
-        master.set("foo", "bar")
-        # get key from redis and save in local cache
-        assert master.get("foo") == "bar"
-        # get key from local cache
-        assert local_cache.get(("GET", "foo")) == "bar"
-        # change key in redis (cause invalidation)
-        master.set("foo", "barbar")
-        # send any command to redis (process invalidation in background)
-        master.ping()
-        # the command is not in the local cache anymore
-        assert local_cache.get(("GET", "foo")) is None
-        # get key from redis
-        assert master.get("foo") == "barbar"
+    def test_set_does_not_store_not_allowed_key(self, cache_key, mock_connection):
+        cache = DefaultCache(CacheConfig(max_size=5))
 
+        assert not cache.set(
+            CacheEntry(
+                cache_key=cache_key,
+                cache_value=b"val",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
 
-@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
-@pytest.mark.onlynoncluster
-class TestCustomCache:
-    class _CustomCache(AbstractCache):
-        def __init__(self):
-            self.responses = cachetools.LRUCache(maxsize=1000)
-            self.keys_to_commands = defaultdict(list)
-            self.commands_to_keys = defaultdict(list)
-
-        def set(
-            self,
-            command: Union[str, Sequence[str]],
-            response: ResponseT,
-            keys_in_command: List[KeyT],
+    def test_set_evict_lru_cache_key_on_reaching_max_size(self, mock_connection):
+        cache = DefaultCache(CacheConfig(max_size=3))
+        cache_key1 = CacheKey(command="GET", redis_keys=("foo",))
+        cache_key2 = CacheKey(command="GET", redis_keys=("foo1",))
+        cache_key3 = CacheKey(command="GET", redis_keys=("foo2",))
+
+        # Set 3 different keys
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key1,
+                cache_value=b"bar",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key2,
+                cache_value=b"bar1",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key3,
+                cache_value=b"bar2",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+
+        # Accessing key in the order that it makes 2nd key LRU
+        assert cache.get(cache_key1).cache_value == b"bar"
+        assert cache.get(cache_key2).cache_value == b"bar1"
+        assert cache.get(cache_key3).cache_value == b"bar2"
+        assert cache.get(cache_key1).cache_value == b"bar"
+
+        cache_key4 = CacheKey(command="GET", redis_keys=("foo3",))
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key4,
+                cache_value=b"bar3",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+
+        # Make sure that new key was added and 2nd is evicted
+        assert cache.get(cache_key4).cache_value == b"bar3"
+        assert cache.get(cache_key2) is None
+
+    @pytest.mark.parametrize(
+        "cache_key", [{"command": "GET", "redis_keys": ("bar",)}], indirect=True
+    )
+    def test_get_return_correct_value(self, cache_key, mock_connection):
+        cache = DefaultCache(CacheConfig(max_size=5))
+
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key,
+                cache_value=b"val",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+        assert cache.get(cache_key).cache_value == b"val"
+
+        wrong_key = CacheKey(command="HGET", redis_keys=("foo",))
+        assert cache.get(wrong_key) is None
+
+        result = cache.get(cache_key)
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key,
+                cache_value=b"new_val",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+
+        # Make sure that result is immutable.
+        assert result.cache_value != cache.get(cache_key).cache_value
+
+    def test_delete_by_cache_keys_removes_associated_entries(self, mock_connection):
+        cache = DefaultCache(CacheConfig(max_size=5))
+
+        cache_key1 = CacheKey(command="GET", redis_keys=("foo",))
+        cache_key2 = CacheKey(command="GET", redis_keys=("foo1",))
+        cache_key3 = CacheKey(command="GET", redis_keys=("foo2",))
+        cache_key4 = CacheKey(command="GET", redis_keys=("foo3",))
+
+        # Set 3 different keys
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key1,
+                cache_value=b"bar",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key2,
+                cache_value=b"bar1",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key3,
+                cache_value=b"bar2",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+
+        assert cache.delete_by_cache_keys([cache_key1, cache_key2, cache_key4]) == [
+            True,
+            True,
+            False,
+        ]
+        assert len(cache.collection) == 1
+        assert cache.get(cache_key3).cache_value == b"bar2"
+
+    def test_delete_by_redis_keys_removes_associated_entries(self, mock_connection):
+        cache = DefaultCache(CacheConfig(max_size=5))
+
+        cache_key1 = CacheKey(command="GET", redis_keys=("foo",))
+        cache_key2 = CacheKey(command="GET", redis_keys=("foo1",))
+        cache_key3 = CacheKey(command="MGET", redis_keys=("foo", "foo3"))
+        cache_key4 = CacheKey(command="MGET", redis_keys=("foo2", "foo3"))
+
+        # Set 3 different keys
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key1,
+                cache_value=b"bar",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key2,
+                cache_value=b"bar1",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key3,
+                cache_value=b"bar2",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key4,
+                cache_value=b"bar3",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+
+        assert cache.delete_by_redis_keys([b"foo", b"foo1"]) == [True, True, True]
+        assert len(cache.collection) == 1
+        assert cache.get(cache_key4).cache_value == b"bar3"
+
+    def test_flush(self, mock_connection):
+        cache = DefaultCache(CacheConfig(max_size=5))
+
+        cache_key1 = CacheKey(command="GET", redis_keys=("foo",))
+        cache_key2 = CacheKey(command="GET", redis_keys=("foo1",))
+        cache_key3 = CacheKey(command="GET", redis_keys=("foo2",))
+
+        # Set 3 different keys
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key1,
+                cache_value=b"bar",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key2,
+                cache_value=b"bar1",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key3,
+                cache_value=b"bar2",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+
+        assert cache.flush() == 3
+        assert len(cache.collection) == 0
+
+
+class TestUnitLRUPolicy:
+    def test_type(self):
+        policy = LRUPolicy()
+        assert policy.type == EvictionPolicyType.time_based
+
+    def test_evict_next(self, mock_connection):
+        cache = DefaultCache(
+            CacheConfig(max_size=5, eviction_policy=EvictionPolicy.LRU)
+        )
+        policy = cache.eviction_policy
+
+        cache_key1 = CacheKey(command="GET", redis_keys=("foo",))
+        cache_key2 = CacheKey(command="GET", redis_keys=("bar",))
+
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key1,
+                cache_value=b"bar",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key2,
+                cache_value=b"foo",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+
+        assert policy.evict_next() == cache_key1
+        assert cache.get(cache_key1) is None
+
+    def test_evict_many(self, mock_connection):
+        cache = DefaultCache(
+            CacheConfig(max_size=5, eviction_policy=EvictionPolicy.LRU)
+        )
+        policy = cache.eviction_policy
+        cache_key1 = CacheKey(command="GET", redis_keys=("foo",))
+        cache_key2 = CacheKey(command="GET", redis_keys=("bar",))
+        cache_key3 = CacheKey(command="GET", redis_keys=("baz",))
+
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key1,
+                cache_value=b"bar",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key2,
+                cache_value=b"foo",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+        assert cache.set(
+            CacheEntry(
+                cache_key=cache_key3,
+                cache_value=b"baz",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+
+        assert policy.evict_many(2) == [cache_key1, cache_key2]
+        assert cache.get(cache_key1) is None
+        assert cache.get(cache_key2) is None
+
+        with pytest.raises(ValueError, match="Evictions count is above cache size"):
+            policy.evict_many(99)
+
+    def test_touch(self, mock_connection):
+        cache = DefaultCache(
+            CacheConfig(max_size=5, eviction_policy=EvictionPolicy.LRU)
+        )
+        policy = cache.eviction_policy
+
+        cache_key1 = CacheKey(command="GET", redis_keys=("foo",))
+        cache_key2 = CacheKey(command="GET", redis_keys=("bar",))
+
+        cache.set(
+            CacheEntry(
+                cache_key=cache_key1,
+                cache_value=b"bar",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+        cache.set(
+            CacheEntry(
+                cache_key=cache_key2,
+                cache_value=b"foo",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+
+        assert cache.collection.popitem(last=True)[0] == cache_key2
+        cache.set(
+            CacheEntry(
+                cache_key=cache_key2,
+                cache_value=b"foo",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+
+        policy.touch(cache_key1)
+        assert cache.collection.popitem(last=True)[0] == cache_key1
+
+    def test_throws_error_on_invalid_cache(self):
+        policy = LRUPolicy()
+
+        with pytest.raises(
+            ValueError, match="Eviction policy should be associated with valid cache."
         ):
-            self.responses[command] = response
-            for key in keys_in_command:
-                self.keys_to_commands[key].append(tuple(command))
-                self.commands_to_keys[command].append(tuple(keys_in_command))
-
-        def get(self, command: Union[str, Sequence[str]]) -> ResponseT:
-            return self.responses.get(command)
-
-        def delete_command(self, command: Union[str, Sequence[str]]):
-            self.responses.pop(command, None)
-            keys = self.commands_to_keys.pop(command, [])
-            for key in keys:
-                if command in self.keys_to_commands[key]:
-                    self.keys_to_commands[key].remove(command)
-
-        def delete_commands(self, commands: List[Union[str, Sequence[str]]]):
-            for command in commands:
-                self.delete_command(command)
-
-        def flush(self):
-            self.responses.clear()
-            self.commands_to_keys.clear()
-            self.keys_to_commands.clear()
-
-        def invalidate_key(self, key: KeyT):
-            commands = self.keys_to_commands.pop(key, [])
-            for command in commands:
-                self.delete_command(command)
-
-    @pytest.mark.parametrize("r", [{"cache": _CustomCache()}], indirect=True)
-    def test_get_from_cache(self, r, r2):
-        r, cache = r
-        # add key to redis
-        r.set("foo", "bar")
-        # get key from redis and save in local cache
-        assert r.get("foo") == b"bar"
-        # get key from local cache
-        assert cache.get(("GET", "foo")) == b"bar"
-        # change key in redis (cause invalidation)
-        r2.set("foo", "barbar")
-        # send any command to redis (process invalidation in background)
-        r.ping()
-        # the command is not in the local cache anymore
-        assert cache.get(("GET", "foo")) is None
-        # get key from redis
-        assert r.get("foo") == b"barbar"
+            policy.evict_next()
+
+        policy.cache = "wrong_type"
+
+        with pytest.raises(
+            ValueError, match="Eviction policy should be associated with valid cache."
+        ):
+            policy.evict_next()
+
+
+class TestUnitCacheConfiguration:
+    MAX_SIZE = 100
+    EVICTION_POLICY = EvictionPolicy.LRU
+
+    def test_get_max_size(self, cache_conf: CacheConfig):
+        assert self.MAX_SIZE == cache_conf.get_max_size()
+
+    def test_get_eviction_policy(self, cache_conf: CacheConfig):
+        assert self.EVICTION_POLICY == cache_conf.get_eviction_policy()
+
+    def test_is_exceeds_max_size(self, cache_conf: CacheConfig):
+        assert not cache_conf.is_exceeds_max_size(self.MAX_SIZE)
+        assert cache_conf.is_exceeds_max_size(self.MAX_SIZE + 1)
+
+    def test_is_allowed_to_cache(self, cache_conf: CacheConfig):
+        assert cache_conf.is_allowed_to_cache("GET")
+        assert not cache_conf.is_allowed_to_cache("SET")
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 5a28f4cde5..c4b3188050 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -208,7 +208,6 @@ def cmd_init_mock(self, r):
 def mock_node_resp(node, response):
     connection = Mock()
     connection.read_response.return_value = response
-    connection._get_from_local_cache.return_value = None
     node.redis_connection.connection = connection
     return node
 
@@ -216,7 +215,6 @@ def mock_node_resp(node, response):
 def mock_node_resp_func(node, func):
     connection = Mock()
     connection.read_response.side_effect = func
-    connection._get_from_local_cache.return_value = None
     node.redis_connection.connection = connection
     return node
 
@@ -485,7 +483,6 @@ def mock_execute_command(*_args, **_kwargs):
         redis_mock_node.execute_command.side_effect = mock_execute_command
         # Mock response value for all other commands
         redis_mock_node.parse_response.return_value = "MOCK_OK"
-        redis_mock_node.connection._get_from_local_cache.return_value = None
         for node in r.get_nodes():
             if node.port != primary.port:
                 node.redis_connection = redis_mock_node
@@ -646,10 +643,10 @@ def parse_response_mock_third(connection, *args, **options):
                 mocks["send_command"].assert_has_calls(
                     [
                         call("READONLY"),
-                        call("GET", "foo"),
+                        call("GET", "foo", keys=["foo"]),
                         call("READONLY"),
-                        call("GET", "foo"),
-                        call("GET", "foo"),
+                        call("GET", "foo", keys=["foo"]),
+                        call("GET", "foo", keys=["foo"]),
                     ]
                 )
 
@@ -2695,7 +2692,7 @@ def test_init_slots_cache_slots_collision(self, request):
 
             def create_mocked_redis_node(host, port, **kwargs):
                 """
-                Helper function to return custom slots cache data from
+                Helper function to return custom slots cache_data data from
                 different redis nodes
                 """
                 if port == 7000:
diff --git a/tests/test_connection.py b/tests/test_connection.py
index 69275d58c0..a58703e3b5 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -1,20 +1,34 @@
+import copy
+import platform
 import socket
+import threading
 import types
+from typing import Any
 from unittest import mock
-from unittest.mock import patch
+from unittest.mock import call, patch
 
 import pytest
 import redis
 from redis import ConnectionPool, Redis
 from redis._parsers import _HiredisParser, _RESP2Parser, _RESP3Parser
 from redis.backoff import NoBackoff
+from redis.cache import (
+    CacheConfig,
+    CacheEntry,
+    CacheEntryStatus,
+    CacheInterface,
+    CacheKey,
+    DefaultCache,
+    LRUPolicy,
+)
 from redis.connection import (
+    CacheProxyConnection,
     Connection,
     SSLConnection,
     UnixDomainSocketConnection,
     parse_url,
 )
-from redis.exceptions import ConnectionError, InvalidResponse, TimeoutError
+from redis.exceptions import ConnectionError, InvalidResponse, RedisError, TimeoutError
 from redis.retry import Retry
 from redis.utils import HIREDIS_AVAILABLE
 
@@ -346,3 +360,206 @@ def test_unix_socket_connection_failure():
         str(e.value)
         == "Error 2 connecting to unix:///tmp/a.sock. No such file or directory."
     )
+
+
+class TestUnitConnectionPool:
+
+    @pytest.mark.parametrize(
+        "max_conn", (-1, "str"), ids=("non-positive", "wrong type")
+    )
+    def test_throws_error_on_incorrect_max_connections(self, max_conn):
+        with pytest.raises(
+            ValueError, match='"max_connections" must be a positive integer'
+        ):
+            ConnectionPool(
+                max_connections=max_conn,
+            )
+
+    def test_throws_error_on_cache_enable_in_resp2(self):
+        with pytest.raises(
+            RedisError, match="Client caching is only supported with RESP version 3"
+        ):
+            ConnectionPool(protocol=2, cache_config=CacheConfig())
+
+    def test_throws_error_on_incorrect_cache_implementation(self):
+        with pytest.raises(ValueError, match="Cache must implement CacheInterface"):
+            ConnectionPool(protocol=3, cache="wrong")
+
+    def test_returns_custom_cache_implementation(self, mock_cache):
+        connection_pool = ConnectionPool(protocol=3, cache=mock_cache)
+
+        assert mock_cache == connection_pool.cache
+        connection_pool.disconnect()
+
+    def test_creates_cache_with_custom_cache_factory(
+        self, mock_cache_factory, mock_cache
+    ):
+        mock_cache_factory.get_cache.return_value = mock_cache
+
+        connection_pool = ConnectionPool(
+            protocol=3,
+            cache_config=CacheConfig(max_size=5),
+            cache_factory=mock_cache_factory,
+        )
+
+        assert connection_pool.cache == mock_cache
+        connection_pool.disconnect()
+
+    def test_creates_cache_with_given_configuration(self, mock_cache):
+        connection_pool = ConnectionPool(
+            protocol=3, cache_config=CacheConfig(max_size=100)
+        )
+
+        assert isinstance(connection_pool.cache, CacheInterface)
+        assert connection_pool.cache.config.get_max_size() == 100
+        assert isinstance(connection_pool.cache.eviction_policy, LRUPolicy)
+        connection_pool.disconnect()
+
+    def test_make_connection_proxy_connection_on_given_cache(self):
+        connection_pool = ConnectionPool(protocol=3, cache_config=CacheConfig())
+
+        assert isinstance(connection_pool.make_connection(), CacheProxyConnection)
+        connection_pool.disconnect()
+
+
+class TestUnitCacheProxyConnection:
+    def test_clears_cache_on_disconnect(self, mock_connection, cache_conf):
+        cache = DefaultCache(CacheConfig(max_size=10))
+        cache_key = CacheKey(command="GET", redis_keys=("foo",))
+
+        cache.set(
+            CacheEntry(
+                cache_key=cache_key,
+                cache_value=b"bar",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            )
+        )
+        assert cache.get(cache_key).cache_value == b"bar"
+
+        mock_connection.disconnect.return_value = None
+        mock_connection.retry = "mock"
+        mock_connection.host = "mock"
+        mock_connection.port = "mock"
+
+        proxy_connection = CacheProxyConnection(
+            mock_connection, cache, threading.Lock()
+        )
+        proxy_connection.disconnect()
+
+        assert len(cache.collection) == 0
+
+    @pytest.mark.skipif(
+        platform.python_implementation() == "PyPy",
+        reason="Pypy doesn't support side_effect",
+    )
+    def test_read_response_returns_cached_reply(self, mock_cache, mock_connection):
+        mock_connection.retry = "mock"
+        mock_connection.host = "mock"
+        mock_connection.port = "mock"
+
+        mock_cache.is_cachable.return_value = True
+        mock_cache.get.side_effect = [
+            None,
+            None,
+            CacheEntry(
+                cache_key=CacheKey(command="GET", redis_keys=("foo",)),
+                cache_value=CacheProxyConnection.DUMMY_CACHE_VALUE,
+                status=CacheEntryStatus.IN_PROGRESS,
+                connection_ref=mock_connection,
+            ),
+            CacheEntry(
+                cache_key=CacheKey(command="GET", redis_keys=("foo",)),
+                cache_value=b"bar",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            ),
+            CacheEntry(
+                cache_key=CacheKey(command="GET", redis_keys=("foo",)),
+                cache_value=b"bar",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            ),
+            CacheEntry(
+                cache_key=CacheKey(command="GET", redis_keys=("foo",)),
+                cache_value=b"bar",
+                status=CacheEntryStatus.VALID,
+                connection_ref=mock_connection,
+            ),
+        ]
+        mock_connection.send_command.return_value = Any
+        mock_connection.read_response.return_value = b"bar"
+        mock_connection.can_read.return_value = False
+
+        proxy_connection = CacheProxyConnection(
+            mock_connection, mock_cache, threading.Lock()
+        )
+        proxy_connection.send_command(*["GET", "foo"], **{"keys": ["foo"]})
+        assert proxy_connection.read_response() == b"bar"
+        assert proxy_connection.read_response() == b"bar"
+
+        mock_connection.read_response.assert_called_once()
+        mock_cache.set.assert_has_calls(
+            [
+                call(
+                    CacheEntry(
+                        cache_key=CacheKey(command="GET", redis_keys=("foo",)),
+                        cache_value=CacheProxyConnection.DUMMY_CACHE_VALUE,
+                        status=CacheEntryStatus.IN_PROGRESS,
+                        connection_ref=mock_connection,
+                    )
+                ),
+                call(
+                    CacheEntry(
+                        cache_key=CacheKey(command="GET", redis_keys=("foo",)),
+                        cache_value=b"bar",
+                        status=CacheEntryStatus.VALID,
+                        connection_ref=mock_connection,
+                    )
+                ),
+            ]
+        )
+
+        mock_cache.get.assert_has_calls(
+            [
+                call(CacheKey(command="GET", redis_keys=("foo",))),
+                call(CacheKey(command="GET", redis_keys=("foo",))),
+                call(CacheKey(command="GET", redis_keys=("foo",))),
+                call(CacheKey(command="GET", redis_keys=("foo",))),
+                call(CacheKey(command="GET", redis_keys=("foo",))),
+                call(CacheKey(command="GET", redis_keys=("foo",))),
+            ]
+        )
+
+    @pytest.mark.skipif(
+        platform.python_implementation() == "PyPy",
+        reason="Pypy doesn't support side_effect",
+    )
+    def test_triggers_invalidation_processing_on_another_connection(
+        self, mock_cache, mock_connection
+    ):
+        mock_connection.retry = "mock"
+        mock_connection.host = "mock"
+        mock_connection.port = "mock"
+
+        another_conn = copy.deepcopy(mock_connection)
+        another_conn.can_read.side_effect = [True, False]
+        another_conn.read_response.return_value = None
+        cache_entry = CacheEntry(
+            cache_key=CacheKey(command="GET", redis_keys=("foo",)),
+            cache_value=b"bar",
+            status=CacheEntryStatus.VALID,
+            connection_ref=another_conn,
+        )
+        mock_cache.is_cachable.return_value = True
+        mock_cache.get.return_value = cache_entry
+        mock_connection.can_read.return_value = False
+
+        proxy_connection = CacheProxyConnection(
+            mock_connection, mock_cache, threading.Lock()
+        )
+        proxy_connection.send_command(*["GET", "foo"], **{"keys": ["foo"]})
+
+        assert proxy_connection.read_response() == b"bar"
+        assert another_conn.can_read.call_count == 2
+        another_conn.read_response.assert_called_once()
diff --git a/tests/test_utils.py b/tests/test_utils.py
new file mode 100644
index 0000000000..764ef5d0a9
--- /dev/null
+++ b/tests/test_utils.py
@@ -0,0 +1,27 @@
+import pytest
+from redis.utils import compare_versions
+
+
+@pytest.mark.parametrize(
+    "version1,version2,expected_res",
+    [
+        ("1.0.0", "0.9.0", -1),
+        ("1.0.0", "1.0.0", 0),
+        ("0.9.0", "1.0.0", 1),
+        ("1.09.0", "1.9.0", 0),
+        ("1.090.0", "1.9.0", -1),
+        ("1", "0.9.0", -1),
+        ("1", "1.0.0", 0),
+    ],
+    ids=[
+        "version1 > version2",
+        "version1 == version2",
+        "version1 < version2",
+        "version1 == version2 - different minor format",
+        "version1 > version2 - different minor format",
+        "version1 > version2 - major version only",
+        "version1 == version2 - major version only",
+    ],
+)
+def test_compare_versions(version1, version2, expected_res):
+    assert compare_versions(version1, version2) == expected_res

From 700045c7a7db6d986df6610d61239375a2211053 Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Mon, 7 Oct 2024 16:11:56 +0300
Subject: [PATCH 0933/1164] Backport 5.1 changes into master (#3406)

* Updated package version (#3389)

* Fix bug with Redis Set commands returns List instead of Set (#3399)

* Fix bug with Redis Set commands returns List instead of Set in RESP2

* Removed fixture, codestyle fixes

* Fixed tests for async

* Fixed asyncio cluster test cases

* Added Sets alignment for RESP2 and RESP3

* Updated doctests

* Fix bug with partial Hiredis availability (#3400)

* Fix bug with partial Hiredis availability

* Added yes flag

* Codestyl fixes

* Removed redundant check

* Removed redundant checks associated with pack command

* Updated condition to check the actual flag

* Removed unused import

* Fix bug with async pipeline and cluster fails with some commands (#3402)

* Fix bug with async pipeline fails with some commands

* Codestyl changes

* Remove keys option in cluster context

* Updated package version (#3403)
---
 .github/workflows/integration.yaml  | 33 ++++++++++++++++++++++++++++
 doctests/dt_set.py                  | 34 ++++++++++++++---------------
 redis/_parsers/helpers.py           |  6 +++++
 redis/asyncio/client.py             |  4 ++++
 redis/cluster.py                    |  4 ++++
 redis/connection.py                 |  3 +--
 redis/utils.py                      |  4 ++--
 setup.py                            |  2 +-
 tests/test_asyncio/test_cluster.py  | 20 ++++++++---------
 tests/test_asyncio/test_commands.py | 20 ++++++++---------
 tests/test_asyncio/test_pipeline.py | 10 +++++++++
 tests/test_cache.py                 |  2 +-
 tests/test_cluster.py               | 24 ++++++++++----------
 tests/test_commands.py              | 20 ++++++++---------
 tests/test_encoding.py              | 18 ---------------
 tests/test_pipeline.py              | 10 +++++++++
 16 files changed, 131 insertions(+), 83 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index b10edf2fb4..ed969d11f1 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -90,6 +90,21 @@ jobs:
           invoke ${{matrix.test-type}}-tests
           ls -1
 
+      - name: Run tests against hiredis < 3.0.0
+        if: ${{ matrix.connection-type == 'hiredis' && matrix.python-version == '3.12'}}
+        run: |
+          pip uninstall hiredis -y
+          pip install -U setuptools wheel
+          pip install -r requirements.txt
+          pip install -r dev_requirements.txt
+          if [ "${{matrix.connection-type}}" == "hiredis" ]; then
+           pip install "hiredis<3.0.0"
+          fi
+          invoke devenv
+          sleep 10 # time to settle
+          invoke ${{matrix.test-type}}-tests
+          ls -1
+
       - name: Upload test results and profiling data
         uses: actions/upload-artifact@v4
         with:
@@ -145,6 +160,24 @@ jobs:
             invoke ${{matrix.test-type}}-tests --protocol=3
           fi
 
+      - name: Run tests against hiredis < 3.0.0
+        if: ${{ matrix.connection-type == 'hiredis' && matrix.python-version == '3.12'}}
+        run: |
+          pip uninstall hiredis -y
+          pip install -U setuptools wheel
+          pip install -r requirements.txt
+          pip install -r dev_requirements.txt
+          if [ "${{matrix.connection-type}}" == "hiredis" ]; then
+            pip install "hiredis<3.0.0"
+          fi
+          invoke devenv
+          sleep 10 # time to settle
+          if [ "${{matrix.event-loop}}" == "uvloop" ]; then
+            invoke ${{matrix.test-type}}-tests --uvloop --protocol=3
+          else
+            invoke ${{matrix.test-type}}-tests --protocol=3
+          fi
+
       - name: Upload test results and profiling data
         uses: actions/upload-artifact@v4
         with:
diff --git a/doctests/dt_set.py b/doctests/dt_set.py
index 0c0562ac80..fc66410b45 100644
--- a/doctests/dt_set.py
+++ b/doctests/dt_set.py
@@ -58,11 +58,11 @@
 r.sadd("bikes:racing:usa", "bike:1", "bike:4")
 # HIDE_END
 res7 = r.sinter("bikes:racing:france", "bikes:racing:usa")
-print(res7)  # >>> ['bike:1']
+print(res7)  # >>> {'bike:1'}
 # STEP_END
 
 # REMOVE_START
-assert res7 == ["bike:1"]
+assert res7 == {"bike:1"}
 # REMOVE_END
 
 # STEP_START scard
@@ -83,12 +83,12 @@
 print(res9)  # >>> 3
 
 res10 = r.smembers("bikes:racing:france")
-print(res10)  # >>> ['bike:1', 'bike:2', 'bike:3']
+print(res10)  # >>> {'bike:1', 'bike:2', 'bike:3'}
 # STEP_END
 
 # REMOVE_START
 assert res9 == 3
-assert res10 == ['bike:1', 'bike:2', 'bike:3']
+assert res10 == {'bike:1', 'bike:2', 'bike:3'}
 # REMOVE_END
 
 # STEP_START smismember
@@ -109,11 +109,11 @@
 r.sadd("bikes:racing:usa", "bike:1", "bike:4")
 
 res13 = r.sdiff("bikes:racing:france", "bikes:racing:usa")
-print(res13)  # >>> ['bike:2', 'bike:3']
+print(res13)  # >>> {'bike:2', 'bike:3'}
 # STEP_END
 
 # REMOVE_START
-assert res13 == ['bike:2', 'bike:3']
+assert res13 == {'bike:2', 'bike:3'}
 r.delete("bikes:racing:france")
 r.delete("bikes:racing:usa")
 # REMOVE_END
@@ -124,27 +124,27 @@
 r.sadd("bikes:racing:italy", "bike:1", "bike:2", "bike:3", "bike:4")
 
 res13 = r.sinter("bikes:racing:france", "bikes:racing:usa", "bikes:racing:italy")
-print(res13)  # >>> ['bike:1']
+print(res13)  # >>> {'bike:1'}
 
 res14 = r.sunion("bikes:racing:france", "bikes:racing:usa", "bikes:racing:italy")
-print(res14)  # >>> ['bike:1', 'bike:2', 'bike:3', 'bike:4']
+print(res14)  # >>> {'bike:1', 'bike:2', 'bike:3', 'bike:4'}
 
 res15 = r.sdiff("bikes:racing:france", "bikes:racing:usa", "bikes:racing:italy")
-print(res15)  # >>> []
+print(res15)  # >>> {}
 
 res16 = r.sdiff("bikes:racing:usa", "bikes:racing:france")
-print(res16)  # >>> ['bike:4']
+print(res16)  # >>> {'bike:4'}
 
 res17 = r.sdiff("bikes:racing:france", "bikes:racing:usa")
-print(res17)  # >>> ['bike:2', 'bike:3']
+print(res17)  # >>> {'bike:2', 'bike:3'}
 # STEP_END
 
 # REMOVE_START
-assert res13 == ['bike:1']
-assert res14 == ['bike:1', 'bike:2', 'bike:3', 'bike:4']
-assert res15 == []
-assert res16 == ['bike:4']
-assert res17 == ['bike:2', 'bike:3']
+assert res13 == {'bike:1'}
+assert res14 == {'bike:1', 'bike:2', 'bike:3', 'bike:4'}
+assert res15 == {}
+assert res16 == {'bike:4'}
+assert res17 == {'bike:2', 'bike:3'}
 r.delete("bikes:racing:france")
 r.delete("bikes:racing:usa")
 r.delete("bikes:racing:italy")
@@ -160,7 +160,7 @@
 print(res19)  # >>> bike:3
 
 res20 = r.smembers("bikes:racing:france")
-print(res20)  # >>> ['bike:2', 'bike:4', 'bike:5']
+print(res20)  # >>> {'bike:2', 'bike:4', 'bike:5'}
 
 res21 = r.srandmember("bikes:racing:france")
 print(res21)  # >>> bike:4
diff --git a/redis/_parsers/helpers.py b/redis/_parsers/helpers.py
index 7494c79210..6832100bb6 100644
--- a/redis/_parsers/helpers.py
+++ b/redis/_parsers/helpers.py
@@ -785,6 +785,9 @@ def string_keys_to_dict(key_string, callback):
 
 
 _RedisCallbacksRESP2 = {
+    **string_keys_to_dict(
+        "SDIFF SINTER SMEMBERS SUNION", lambda r: r and set(r) or set()
+    ),
     **string_keys_to_dict(
         "ZDIFF ZINTER ZPOPMAX ZPOPMIN ZRANGE ZRANGEBYSCORE ZRANK ZREVRANGE "
         "ZREVRANGEBYSCORE ZREVRANK ZUNION",
@@ -829,6 +832,9 @@ def string_keys_to_dict(key_string, callback):
 
 
 _RedisCallbacksRESP3 = {
+    **string_keys_to_dict(
+        "SDIFF SINTER SMEMBERS SUNION", lambda r: r and set(r) or set()
+    ),
     **string_keys_to_dict(
         "ZRANGE ZINTER ZPOPMAX ZPOPMIN ZRANGEBYSCORE ZREVRANGE ZREVRANGEBYSCORE "
         "ZUNION HGETALL XREADGROUP",
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 039ebfdfae..9508849703 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -1423,6 +1423,10 @@ async def _execute_transaction(  # noqa: C901
             if not isinstance(r, Exception):
                 args, options = cmd
                 command_name = args[0]
+
+                # Remove keys entry, it needs only for cache.
+                options.pop("keys", None)
+
                 if command_name in self.response_callbacks:
                     r = self.response_callbacks[command_name](r, **options)
                     if inspect.isawaitable(r):
diff --git a/redis/cluster.py b/redis/cluster.py
index fbf5428d40..9dcbad7fc1 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -1163,6 +1163,10 @@ def _execute_command(self, target_node, *args, **kwargs):
                     asking = False
                 connection.send_command(*args, **kwargs)
                 response = redis_node.parse_response(connection, command, **kwargs)
+
+                # Remove keys entry, it needs only for cache.
+                kwargs.pop("keys", None)
+
                 if command in self.cluster_response_callbacks:
                     response = self.cluster_response_callbacks[command](
                         response, **kwargs
diff --git a/redis/connection.py b/redis/connection.py
index 6aae2101c2..40f2d29722 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -38,7 +38,6 @@
 from .utils import (
     CRYPTOGRAPHY_AVAILABLE,
     HIREDIS_AVAILABLE,
-    HIREDIS_PACK_AVAILABLE,
     SSL_AVAILABLE,
     compare_versions,
     ensure_string,
@@ -314,7 +313,7 @@ def __del__(self):
     def _construct_command_packer(self, packer):
         if packer is not None:
             return packer
-        elif HIREDIS_PACK_AVAILABLE:
+        elif HIREDIS_AVAILABLE:
             return HiredisRespSerializer()
         else:
             return PythonRespSerializer(self._buffer_cutoff, self.encoder.encode)
diff --git a/redis/utils.py b/redis/utils.py
index b4e9afb054..8693fb3c8f 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -8,10 +8,10 @@
 
     # Only support Hiredis >= 3.0:
     HIREDIS_AVAILABLE = int(hiredis.__version__.split(".")[0]) >= 3
-    HIREDIS_PACK_AVAILABLE = hasattr(hiredis, "pack_command")
+    if not HIREDIS_AVAILABLE:
+        raise ImportError("hiredis package should be >= 3.0.0")
 except ImportError:
     HIREDIS_AVAILABLE = False
-    HIREDIS_PACK_AVAILABLE = False
 
 try:
     import ssl  # noqa
diff --git a/setup.py b/setup.py
index 0c968a4d9f..8036b64066 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="5.1.0b7",
+    version="5.1.1",
     packages=find_packages(
         include=[
             "redis",
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index e480db332b..f3b76b80c9 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -1752,38 +1752,38 @@ async def test_cluster_rpoplpush(self, r: RedisCluster) -> None:
 
     async def test_cluster_sdiff(self, r: RedisCluster) -> None:
         await r.sadd("{foo}a", "1", "2", "3")
-        assert set(await r.sdiff("{foo}a", "{foo}b")) == {b"1", b"2", b"3"}
+        assert await r.sdiff("{foo}a", "{foo}b") == {b"1", b"2", b"3"}
         await r.sadd("{foo}b", "2", "3")
-        assert await r.sdiff("{foo}a", "{foo}b") == [b"1"]
+        assert await r.sdiff("{foo}a", "{foo}b") == {b"1"}
 
     async def test_cluster_sdiffstore(self, r: RedisCluster) -> None:
         await r.sadd("{foo}a", "1", "2", "3")
         assert await r.sdiffstore("{foo}c", "{foo}a", "{foo}b") == 3
-        assert set(await r.smembers("{foo}c")) == {b"1", b"2", b"3"}
+        assert await r.smembers("{foo}c") == {b"1", b"2", b"3"}
         await r.sadd("{foo}b", "2", "3")
         assert await r.sdiffstore("{foo}c", "{foo}a", "{foo}b") == 1
-        assert await r.smembers("{foo}c") == [b"1"]
+        assert await r.smembers("{foo}c") == {b"1"}
 
     async def test_cluster_sinter(self, r: RedisCluster) -> None:
         await r.sadd("{foo}a", "1", "2", "3")
-        assert await r.sinter("{foo}a", "{foo}b") == []
+        assert await r.sinter("{foo}a", "{foo}b") == set()
         await r.sadd("{foo}b", "2", "3")
-        assert set(await r.sinter("{foo}a", "{foo}b")) == {b"2", b"3"}
+        assert await r.sinter("{foo}a", "{foo}b") == {b"2", b"3"}
 
     async def test_cluster_sinterstore(self, r: RedisCluster) -> None:
         await r.sadd("{foo}a", "1", "2", "3")
         assert await r.sinterstore("{foo}c", "{foo}a", "{foo}b") == 0
-        assert await r.smembers("{foo}c") == []
+        assert await r.smembers("{foo}c") == set()
         await r.sadd("{foo}b", "2", "3")
         assert await r.sinterstore("{foo}c", "{foo}a", "{foo}b") == 2
-        assert set(await r.smembers("{foo}c")) == {b"2", b"3"}
+        assert await r.smembers("{foo}c") == {b"2", b"3"}
 
     async def test_cluster_smove(self, r: RedisCluster) -> None:
         await r.sadd("{foo}a", "a1", "a2")
         await r.sadd("{foo}b", "b1", "b2")
         assert await r.smove("{foo}a", "{foo}b", "a1")
-        assert await r.smembers("{foo}a") == [b"a2"]
-        assert set(await r.smembers("{foo}b")) == {b"b1", b"b2", b"a1"}
+        assert await r.smembers("{foo}a") == {b"a2"}
+        assert await r.smembers("{foo}b") == {b"b1", b"b2", b"a1"}
 
     async def test_cluster_sunion(self, r: RedisCluster) -> None:
         await r.sadd("{foo}a", "1", "2")
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 28c3094cdb..f6ed07fab5 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -1415,34 +1415,34 @@ async def test_scard(self, r: redis.Redis):
     @pytest.mark.onlynoncluster
     async def test_sdiff(self, r: redis.Redis):
         await r.sadd("a", "1", "2", "3")
-        assert set(await r.sdiff("a", "b")) == {b"1", b"2", b"3"}
+        assert await r.sdiff("a", "b") == {b"1", b"2", b"3"}
         await r.sadd("b", "2", "3")
-        assert await r.sdiff("a", "b") == [b"1"]
+        assert await r.sdiff("a", "b") == {b"1"}
 
     @pytest.mark.onlynoncluster
     async def test_sdiffstore(self, r: redis.Redis):
         await r.sadd("a", "1", "2", "3")
         assert await r.sdiffstore("c", "a", "b") == 3
-        assert set(await r.smembers("c")) == {b"1", b"2", b"3"}
+        assert await r.smembers("c") == {b"1", b"2", b"3"}
         await r.sadd("b", "2", "3")
         assert await r.sdiffstore("c", "a", "b") == 1
-        assert await r.smembers("c") == [b"1"]
+        assert await r.smembers("c") == {b"1"}
 
     @pytest.mark.onlynoncluster
     async def test_sinter(self, r: redis.Redis):
         await r.sadd("a", "1", "2", "3")
-        assert await r.sinter("a", "b") == []
+        assert await r.sinter("a", "b") == set()
         await r.sadd("b", "2", "3")
-        assert set(await r.sinter("a", "b")) == {b"2", b"3"}
+        assert await r.sinter("a", "b") == {b"2", b"3"}
 
     @pytest.mark.onlynoncluster
     async def test_sinterstore(self, r: redis.Redis):
         await r.sadd("a", "1", "2", "3")
         assert await r.sinterstore("c", "a", "b") == 0
-        assert await r.smembers("c") == []
+        assert await r.smembers("c") == set()
         await r.sadd("b", "2", "3")
         assert await r.sinterstore("c", "a", "b") == 2
-        assert set(await r.smembers("c")) == {b"2", b"3"}
+        assert await r.smembers("c") == {b"2", b"3"}
 
     async def test_sismember(self, r: redis.Redis):
         await r.sadd("a", "1", "2", "3")
@@ -1460,8 +1460,8 @@ async def test_smove(self, r: redis.Redis):
         await r.sadd("a", "a1", "a2")
         await r.sadd("b", "b1", "b2")
         assert await r.smove("a", "b", "a1")
-        assert await r.smembers("a") == [b"a2"]
-        assert set(await r.smembers("b")) == {b"b1", b"b2", b"a1"}
+        assert await r.smembers("a") == {b"a2"}
+        assert await r.smembers("b") == {b"b1", b"b2", b"a1"}
 
     async def test_spop(self, r: redis.Redis):
         s = [b"1", b"2", b"3"]
diff --git a/tests/test_asyncio/test_pipeline.py b/tests/test_asyncio/test_pipeline.py
index 4b29360d72..31759d84a3 100644
--- a/tests/test_asyncio/test_pipeline.py
+++ b/tests/test_asyncio/test_pipeline.py
@@ -417,3 +417,13 @@ async def test_pipeline_discard(self, r):
             response = await pipe.execute()
         assert response[0]
         assert await r.get("foo") == b"bar"
+
+    @pytest.mark.onlynoncluster
+    async def test_send_set_commands_over_async_pipeline(self, r: redis.asyncio.Redis):
+        pipe = r.pipeline()
+        pipe.hset("hash:1", "foo", "bar")
+        pipe.hset("hash:1", "bar", "foo")
+        pipe.hset("hash:1", "baz", "bar")
+        pipe.hgetall("hash:1")
+        resp = await pipe.execute()
+        assert resp == [1, 1, 1, {b"bar": b"foo", b"baz": b"bar", b"foo": b"bar"}]
diff --git a/tests/test_cache.py b/tests/test_cache.py
index 1803646094..67733dc9af 100644
--- a/tests/test_cache.py
+++ b/tests/test_cache.py
@@ -41,7 +41,7 @@ def r(request):
 
 @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 @pytest.mark.onlynoncluster
-# @skip_if_resp_version(2)
+@skip_if_resp_version(2)
 @skip_if_server_version_lt("7.4.0")
 class TestCache:
     @pytest.mark.parametrize(
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index c4b3188050..fe5852d1fb 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -1865,49 +1865,49 @@ def test_cluster_rpoplpush(self, r):
 
     def test_cluster_sdiff(self, r):
         r.sadd("{foo}a", "1", "2", "3")
-        assert set(r.sdiff("{foo}a", "{foo}b")) == {b"1", b"2", b"3"}
+        assert r.sdiff("{foo}a", "{foo}b") == {b"1", b"2", b"3"}
         r.sadd("{foo}b", "2", "3")
-        assert r.sdiff("{foo}a", "{foo}b") == [b"1"]
+        assert r.sdiff("{foo}a", "{foo}b") == {b"1"}
 
     def test_cluster_sdiffstore(self, r):
         r.sadd("{foo}a", "1", "2", "3")
         assert r.sdiffstore("{foo}c", "{foo}a", "{foo}b") == 3
-        assert set(r.smembers("{foo}c")) == {b"1", b"2", b"3"}
+        assert r.smembers("{foo}c") == {b"1", b"2", b"3"}
         r.sadd("{foo}b", "2", "3")
         assert r.sdiffstore("{foo}c", "{foo}a", "{foo}b") == 1
-        assert r.smembers("{foo}c") == [b"1"]
+        assert r.smembers("{foo}c") == {b"1"}
 
     def test_cluster_sinter(self, r):
         r.sadd("{foo}a", "1", "2", "3")
-        assert r.sinter("{foo}a", "{foo}b") == []
+        assert r.sinter("{foo}a", "{foo}b") == set()
         r.sadd("{foo}b", "2", "3")
-        assert set(r.sinter("{foo}a", "{foo}b")) == {b"2", b"3"}
+        assert r.sinter("{foo}a", "{foo}b") == {b"2", b"3"}
 
     def test_cluster_sinterstore(self, r):
         r.sadd("{foo}a", "1", "2", "3")
         assert r.sinterstore("{foo}c", "{foo}a", "{foo}b") == 0
-        assert r.smembers("{foo}c") == []
+        assert r.smembers("{foo}c") == set()
         r.sadd("{foo}b", "2", "3")
         assert r.sinterstore("{foo}c", "{foo}a", "{foo}b") == 2
-        assert set(r.smembers("{foo}c")) == {b"2", b"3"}
+        assert r.smembers("{foo}c") == {b"2", b"3"}
 
     def test_cluster_smove(self, r):
         r.sadd("{foo}a", "a1", "a2")
         r.sadd("{foo}b", "b1", "b2")
         assert r.smove("{foo}a", "{foo}b", "a1")
-        assert r.smembers("{foo}a") == [b"a2"]
-        assert set(r.smembers("{foo}b")) == {b"b1", b"b2", b"a1"}
+        assert r.smembers("{foo}a") == {b"a2"}
+        assert r.smembers("{foo}b") == {b"b1", b"b2", b"a1"}
 
     def test_cluster_sunion(self, r):
         r.sadd("{foo}a", "1", "2")
         r.sadd("{foo}b", "2", "3")
-        assert set(r.sunion("{foo}a", "{foo}b")) == {b"1", b"2", b"3"}
+        assert r.sunion("{foo}a", "{foo}b") == {b"1", b"2", b"3"}
 
     def test_cluster_sunionstore(self, r):
         r.sadd("{foo}a", "1", "2")
         r.sadd("{foo}b", "2", "3")
         assert r.sunionstore("{foo}c", "{foo}a", "{foo}b") == 3
-        assert set(r.smembers("{foo}c")) == {b"1", b"2", b"3"}
+        assert r.smembers("{foo}c") == {b"1", b"2", b"3"}
 
     @skip_if_server_version_lt("6.2.0")
     def test_cluster_zdiff(self, r):
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 74e9c1c88e..4cad4c14b6 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2247,25 +2247,25 @@ def test_scard(self, r):
     @pytest.mark.onlynoncluster
     def test_sdiff(self, r):
         r.sadd("a", "1", "2", "3")
-        assert set(r.sdiff("a", "b")) == {b"1", b"2", b"3"}
+        assert r.sdiff("a", "b") == {b"1", b"2", b"3"}
         r.sadd("b", "2", "3")
-        assert r.sdiff("a", "b") == [b"1"]
+        assert r.sdiff("a", "b") == {b"1"}
 
     @pytest.mark.onlynoncluster
     def test_sdiffstore(self, r):
         r.sadd("a", "1", "2", "3")
         assert r.sdiffstore("c", "a", "b") == 3
-        assert set(r.smembers("c")) == {b"1", b"2", b"3"}
+        assert r.smembers("c") == {b"1", b"2", b"3"}
         r.sadd("b", "2", "3")
         assert r.sdiffstore("c", "a", "b") == 1
-        assert r.smembers("c") == [b"1"]
+        assert r.smembers("c") == {b"1"}
 
     @pytest.mark.onlynoncluster
     def test_sinter(self, r):
         r.sadd("a", "1", "2", "3")
-        assert r.sinter("a", "b") == []
+        assert r.sinter("a", "b") == set()
         r.sadd("b", "2", "3")
-        assert set(r.sinter("a", "b")) == {b"2", b"3"}
+        assert r.sinter("a", "b") == {b"2", b"3"}
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("7.0.0")
@@ -2280,10 +2280,10 @@ def test_sintercard(self, r):
     def test_sinterstore(self, r):
         r.sadd("a", "1", "2", "3")
         assert r.sinterstore("c", "a", "b") == 0
-        assert r.smembers("c") == []
+        assert r.smembers("c") == set()
         r.sadd("b", "2", "3")
         assert r.sinterstore("c", "a", "b") == 2
-        assert set(r.smembers("c")) == {b"2", b"3"}
+        assert r.smembers("c") == {b"2", b"3"}
 
     def test_sismember(self, r):
         r.sadd("a", "1", "2", "3")
@@ -2308,8 +2308,8 @@ def test_smove(self, r):
         r.sadd("a", "a1", "a2")
         r.sadd("b", "b1", "b2")
         assert r.smove("a", "b", "a1")
-        assert r.smembers("a") == [b"a2"]
-        assert set(r.smembers("b")) == {b"b1", b"b2", b"a1"}
+        assert r.smembers("a") == {b"a2"}
+        assert r.smembers("b") == {b"b1", b"b2", b"a1"}
 
     def test_spop(self, r):
         s = [b"1", b"2", b"3"]
diff --git a/tests/test_encoding.py b/tests/test_encoding.py
index 331cd5108c..0fcb256cfb 100644
--- a/tests/test_encoding.py
+++ b/tests/test_encoding.py
@@ -1,7 +1,5 @@
 import pytest
 import redis
-from redis.connection import Connection
-from redis.utils import HIREDIS_PACK_AVAILABLE
 
 from .conftest import _get_client
 
@@ -75,22 +73,6 @@ def test_replace(self, request):
         assert r.get("a") == "foo\ufffd"
 
 
-@pytest.mark.skipif(
-    HIREDIS_PACK_AVAILABLE,
-    reason="Packing via hiredis does not preserve memoryviews",
-)
-class TestMemoryviewsAreNotPacked:
-    def test_memoryviews_are_not_packed(self):
-        c = Connection()
-        arg = memoryview(b"some_arg")
-        arg_list = ["SOME_COMMAND", arg]
-        cmd = c.pack_command(*arg_list)
-        assert cmd[1] is arg
-        cmds = c.pack_commands([arg_list, arg_list])
-        assert cmds[1] is arg
-        assert cmds[3] is arg
-
-
 class TestCommandsAreNotEncoded:
     @pytest.fixture()
     def r(self, request):
diff --git a/tests/test_pipeline.py b/tests/test_pipeline.py
index 7f10fcad4f..be7784ad0b 100644
--- a/tests/test_pipeline.py
+++ b/tests/test_pipeline.py
@@ -412,3 +412,13 @@ def test_pipeline_discard(self, r):
             response = pipe.execute()
         assert response[0]
         assert r.get("foo") == b"bar"
+
+    @pytest.mark.onlynoncluster
+    def test_send_set_commands_over_pipeline(self, r: redis.Redis):
+        pipe = r.pipeline()
+        pipe.hset("hash:1", "foo", "bar")
+        pipe.hset("hash:1", "bar", "foo")
+        pipe.hset("hash:1", "baz", "bar")
+        pipe.hgetall("hash:1")
+        resp = pipe.execute()
+        assert resp == [1, 1, 1, {b"bar": b"foo", b"baz": b"bar", b"foo": b"bar"}]

From 17db62e3c9ea796f5705d2857f49e52799057af7 Mon Sep 17 00:00:00 2001
From: David Dougherty <dwdougherty@gmail.com>
Date: Tue, 8 Oct 2024 22:38:12 -0700
Subject: [PATCH 0934/1164] DOC-4200: add TCEs to the aggregation query page
 (#3381)

---
 doctests/query_agg.py | 103 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 103 insertions(+)
 create mode 100644 doctests/query_agg.py

diff --git a/doctests/query_agg.py b/doctests/query_agg.py
new file mode 100644
index 0000000000..4fa8f14b84
--- /dev/null
+++ b/doctests/query_agg.py
@@ -0,0 +1,103 @@
+# EXAMPLE: query_agg
+# HIDE_START
+import json
+import redis
+from redis.commands.json.path import Path
+from redis.commands.search import Search
+from redis.commands.search.aggregation import AggregateRequest
+from redis.commands.search.field import NumericField, TagField
+from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+import redis.commands.search.reducers as reducers
+
+r = redis.Redis(decode_responses=True)
+
+# create index
+schema = (
+    TagField("$.condition", as_name="condition"),
+    NumericField("$.price", as_name="price"),
+)
+
+index = r.ft("idx:bicycle")
+index.create_index(
+    schema,
+    definition=IndexDefinition(prefix=["bicycle:"], index_type=IndexType.JSON),
+)
+
+# load data
+with open("data/query_em.json") as f:
+    bicycles = json.load(f)
+
+pipeline = r.pipeline(transaction=False)
+for bid, bicycle in enumerate(bicycles):
+    pipeline.json().set(f'bicycle:{bid}', Path.root_path(), bicycle)
+pipeline.execute()
+# HIDE_END
+
+# STEP_START agg1
+search = Search(r, index_name="idx:bicycle")
+aggregate_request = AggregateRequest(query='@condition:{new}') \
+    .load('__key', 'price') \
+    .apply(discounted='@price - (@price * 0.1)')
+res = search.aggregate(aggregate_request)
+print(len(res.rows)) # >>> 5
+print(res.rows) # >>> [['__key', 'bicycle:0', ...
+#[['__key', 'bicycle:0', 'price', '270', 'discounted', '243'],
+# ['__key', 'bicycle:5', 'price', '810', 'discounted', '729'],
+# ['__key', 'bicycle:6', 'price', '2300', 'discounted', '2070'],
+# ['__key', 'bicycle:7', 'price', '430', 'discounted', '387'],
+# ['__key', 'bicycle:8', 'price', '1200', 'discounted', '1080']]
+# REMOVE_START
+assert len(res.rows) == 5
+# REMOVE_END
+# STEP_END
+
+# STEP_START agg2
+search = Search(r, index_name="idx:bicycle")
+aggregate_request = AggregateRequest(query='*') \
+    .load('price') \
+    .apply(price_category='@price<1000') \
+    .group_by('@condition', reducers.sum('@price_category').alias('num_affordable'))
+res = search.aggregate(aggregate_request)
+print(len(res.rows)) # >>> 3
+print(res.rows) # >>>
+#[['condition', 'refurbished', 'num_affordable', '1'],
+# ['condition', 'used', 'num_affordable', '1'],
+# ['condition', 'new', 'num_affordable', '3']]
+# REMOVE_START
+assert len(res.rows) == 3
+# REMOVE_END
+# STEP_END
+
+# STEP_START agg3
+search = Search(r, index_name="idx:bicycle")
+aggregate_request = AggregateRequest(query='*') \
+    .apply(type="'bicycle'") \
+    .group_by('@type', reducers.count().alias('num_total'))
+res = search.aggregate(aggregate_request)
+print(len(res.rows)) # >>> 1
+print(res.rows) # >>> [['type', 'bicycle', 'num_total', '10']]
+# REMOVE_START
+assert len(res.rows) == 1
+# REMOVE_END
+# STEP_END
+
+# STEP_START agg4
+search = Search(r, index_name="idx:bicycle")
+aggregate_request = AggregateRequest(query='*') \
+    .load('__key') \
+    .group_by('@condition', reducers.tolist('__key').alias('bicycles'))
+res = search.aggregate(aggregate_request)
+print(len(res.rows)) # >>> 3
+print(res.rows) # >>>
+#[['condition', 'refurbished', 'bicycles', ['bicycle:9']],
+# ['condition', 'used', 'bicycles', ['bicycle:1', 'bicycle:2', 'bicycle:3', 'bicycle:4']],
+# ['condition', 'new', 'bicycles', ['bicycle:5', 'bicycle:6', 'bicycle:7', 'bicycle:0', 'bicycle:8']]]
+# REMOVE_START
+assert len(res.rows) == 3
+# REMOVE_END
+# STEP_END
+
+# REMOVE_START
+# destroy index and data
+r.ft("idx:bicycle").dropindex(delete_documents=True)
+# REMOVE_END

From d6ddb0d66bc4bd28c99d9cf148c9085117cc8ce9 Mon Sep 17 00:00:00 2001
From: David Dougherty <dwdougherty@gmail.com>
Date: Wed, 16 Oct 2024 00:50:50 -0700
Subject: [PATCH 0935/1164] DOC-4199: add TCEs to the combined query page
 (#3380)

Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
---
 doctests/query_combined.py | 124 +++++++++++++++++++++++++++++++++++++
 1 file changed, 124 insertions(+)
 create mode 100644 doctests/query_combined.py

diff --git a/doctests/query_combined.py b/doctests/query_combined.py
new file mode 100644
index 0000000000..a17f19417c
--- /dev/null
+++ b/doctests/query_combined.py
@@ -0,0 +1,124 @@
+# EXAMPLE: query_combined
+# HIDE_START
+import json
+import numpy as np
+import redis
+import warnings
+from redis.commands.json.path import Path
+from redis.commands.search.field import NumericField, TagField, TextField, VectorField
+from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.query import Query
+from sentence_transformers import  SentenceTransformer
+
+
+def embed_text(model, text):
+    return np.array(model.encode(text)).astype(np.float32).tobytes()
+
+warnings.filterwarnings("ignore", category=FutureWarning, message=r".*clean_up_tokenization_spaces.*")
+model = SentenceTransformer('sentence-transformers/all-MiniLM-L6-v2')
+query = "Bike for small kids"
+query_vector = embed_text(model, query)
+
+r = redis.Redis(decode_responses=True)
+
+# create index
+schema = (
+    TextField("$.description", no_stem=True, as_name="model"),
+    TagField("$.condition", as_name="condition"),
+    NumericField("$.price", as_name="price"),
+    VectorField(
+        "$.description_embeddings",
+        "FLAT",
+        {
+            "TYPE": "FLOAT32",
+            "DIM": 384,
+            "DISTANCE_METRIC": "COSINE",
+        },
+        as_name="vector",
+    ),
+)
+
+index = r.ft("idx:bicycle")
+index.create_index(
+    schema,
+    definition=IndexDefinition(prefix=["bicycle:"], index_type=IndexType.JSON),
+)
+
+# load data
+with open("data/query_vector.json") as f:
+    bicycles = json.load(f)
+
+pipeline = r.pipeline(transaction=False)
+for bid, bicycle in enumerate(bicycles):
+    pipeline.json().set(f'bicycle:{bid}', Path.root_path(), bicycle)
+pipeline.execute()
+# HIDE_END
+
+# STEP_START combined1
+q = Query("@price:[500 1000] @condition:{new}")
+res = index.search(q)
+print(res.total) # >>> 1
+# REMOVE_START
+assert res.total == 1
+# REMOVE_END
+# STEP_END
+
+# STEP_START combined2
+q = Query("kids @price:[500 1000] @condition:{used}")
+res = index.search(q)
+print(res.total) # >>> 1
+# REMOVE_START
+assert res.total == 1
+# REMOVE_END
+# STEP_END
+
+# STEP_START combined3
+q = Query("(kids | small) @condition:{used}")
+res = index.search(q)
+print(res.total) # >>> 2
+# REMOVE_START
+assert res.total == 2
+# REMOVE_END
+# STEP_END
+
+# STEP_START combined4
+q = Query("@description:(kids | small) @condition:{used}")
+res = index.search(q)
+print(res.total) # >>> 0
+# REMOVE_START
+assert res.total == 0
+# REMOVE_END
+# STEP_END
+
+# STEP_START combined5
+q = Query("@description:(kids | small) @condition:{new | used}")
+res = index.search(q)
+print(res.total) # >>> 0
+# REMOVE_START
+assert res.total == 0
+# REMOVE_END
+# STEP_END
+
+# STEP_START combined6
+q = Query("@price:[500 1000] -@condition:{new}")
+res = index.search(q)
+print(res.total) # >>> 2
+# REMOVE_START
+assert res.total == 2
+# REMOVE_END
+# STEP_END
+
+# STEP_START combined7
+q = Query("(@price:[500 1000] -@condition:{new})=>[KNN 3 @vector $query_vector]").dialect(2)
+# put query string here
+res = index.search(q,{ 'query_vector': query_vector })
+print(res.total) # >>> 2
+# REMOVE_START
+assert res.total == 2
+# REMOVE_END
+# STEP_END
+
+# REMOVE_START
+# destroy index and data
+r.ft("idx:bicycle").dropindex(delete_documents=True)
+# REMOVE_END

From 4c4d4afd2b31b5c36a2d5e22419bcbf584265a17 Mon Sep 17 00:00:00 2001
From: Igor Malinovskiy <u.glide@gmail.com>
Date: Mon, 21 Oct 2024 09:31:12 +0200
Subject: [PATCH 0936/1164] Pin pytest-profiling (#3417)

See https://github.com/man-group/pytest-plugins/issues/242
---
 dev_requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev_requirements.txt b/dev_requirements.txt
index 37a107d16d..adfa99e80c 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -9,7 +9,7 @@ packaging>=20.4
 pytest
 pytest-asyncio>=0.23.0,<0.24.0
 pytest-cov
-pytest-profiling
+pytest-profiling==1.7.0
 pytest-timeout
 ujson>=4.2.0
 uvloop

From 00f5be420b397adfa1b9aa9c2761f7d8a27c0a9a Mon Sep 17 00:00:00 2001
From: Robert Shelton <robert.shelton@redis.com>
Date: Tue, 22 Oct 2024 10:45:57 -0400
Subject: [PATCH 0937/1164] adds scorer to AggregateRequest (#3409)

* adds scorer to AggregateRequest

* fix linting

* update tests for BM25

* enum for aggregation scorer

* update signature

* revert back to string input

---------

Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
---
 redis/commands/search/aggregation.py | 16 ++++++++
 tests/test_asyncio/test_search.py    | 55 ++++++++++++++++++++++++++++
 tests/test_search.py                 | 55 ++++++++++++++++++++++++++++
 3 files changed, 126 insertions(+)

diff --git a/redis/commands/search/aggregation.py b/redis/commands/search/aggregation.py
index 42c3547b0b..5638f1d662 100644
--- a/redis/commands/search/aggregation.py
+++ b/redis/commands/search/aggregation.py
@@ -112,6 +112,7 @@ def __init__(self, query: str = "*") -> None:
         self._cursor = []
         self._dialect = None
         self._add_scores = False
+        self._scorer = "TFIDF"
 
     def load(self, *fields: List[str]) -> "AggregateRequest":
         """
@@ -300,6 +301,17 @@ def add_scores(self) -> "AggregateRequest":
         self._add_scores = True
         return self
 
+    def scorer(self, scorer: str) -> "AggregateRequest":
+        """
+        Use a different scoring function to evaluate document relevance.
+        Default is `TFIDF`.
+
+        :param scorer: The scoring function to use
+                       (e.g. `TFIDF.DOCNORM` or `BM25`)
+        """
+        self._scorer = scorer
+        return self
+
     def verbatim(self) -> "AggregateRequest":
         self._verbatim = True
         return self
@@ -323,6 +335,9 @@ def build_args(self) -> List[str]:
         if self._verbatim:
             ret.append("VERBATIM")
 
+        if self._scorer:
+            ret.extend(["SCORER", self._scorer])
+
         if self._add_scores:
             ret.append("ADDSCORES")
 
@@ -332,6 +347,7 @@ def build_args(self) -> List[str]:
         if self._loadall:
             ret.append("LOAD")
             ret.append("*")
+
         elif self._loadfields:
             ret.append("LOAD")
             ret.append(str(len(self._loadfields)))
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 0e6fe22131..fb813b0bc7 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -1556,6 +1556,61 @@ async def test_aggregations_add_scores(decoded_r: redis.Redis):
         assert res.rows[1] == ["__score", "0.2"]
 
 
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.10.05", "search")
+async def test_aggregations_hybrid_scoring(decoded_r: redis.Redis):
+    assert await decoded_r.ft().create_index(
+        (
+            TextField("name", sortable=True, weight=5.0),
+            TextField("description", sortable=True, weight=5.0),
+            VectorField(
+                "vector",
+                "HNSW",
+                {"TYPE": "FLOAT32", "DIM": 2, "DISTANCE_METRIC": "COSINE"},
+            ),
+        )
+    )
+
+    assert await decoded_r.hset(
+        "doc1",
+        mapping={
+            "name": "cat book",
+            "description": "an animal book about cats",
+            "vector": np.array([0.1, 0.2]).astype(np.float32).tobytes(),
+        },
+    )
+    assert await decoded_r.hset(
+        "doc2",
+        mapping={
+            "name": "dog book",
+            "description": "an animal book about dogs",
+            "vector": np.array([0.2, 0.1]).astype(np.float32).tobytes(),
+        },
+    )
+
+    query_string = "(@description:animal)=>[KNN 3 @vector $vec_param AS dist]"
+    req = (
+        aggregations.AggregateRequest(query_string)
+        .scorer("BM25")
+        .add_scores()
+        .apply(hybrid_score="@__score + @dist")
+        .load("*")
+        .dialect(4)
+    )
+
+    res = await decoded_r.ft().aggregate(
+        req,
+        query_params={"vec_param": np.array([0.11, 0.22]).astype(np.float32).tobytes()},
+    )
+
+    if isinstance(res, dict):
+        assert len(res["results"]) == 2
+    else:
+        assert len(res.rows) == 2
+        for row in res.rows:
+            len(row) == 6
+
+
 @pytest.mark.redismod
 @skip_if_redis_enterprise()
 async def test_search_commands_in_pipeline(decoded_r: redis.Redis):
diff --git a/tests/test_search.py b/tests/test_search.py
index dde59f0f87..0f0e7bb309 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1466,6 +1466,61 @@ def test_aggregations_add_scores(client):
         assert res.rows[1] == ["__score", "0.2"]
 
 
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.10.05", "search")
+async def test_aggregations_hybrid_scoring(client):
+    client.ft().create_index(
+        (
+            TextField("name", sortable=True, weight=5.0),
+            TextField("description", sortable=True, weight=5.0),
+            VectorField(
+                "vector",
+                "HNSW",
+                {"TYPE": "FLOAT32", "DIM": 2, "DISTANCE_METRIC": "COSINE"},
+            ),
+        )
+    )
+
+    client.hset(
+        "doc1",
+        mapping={
+            "name": "cat book",
+            "description": "an animal book about cats",
+            "vector": np.array([0.1, 0.2]).astype(np.float32).tobytes(),
+        },
+    )
+    client.hset(
+        "doc2",
+        mapping={
+            "name": "dog book",
+            "description": "an animal book about dogs",
+            "vector": np.array([0.2, 0.1]).astype(np.float32).tobytes(),
+        },
+    )
+
+    query_string = "(@description:animal)=>[KNN 3 @vector $vec_param AS dist]"
+    req = (
+        aggregations.AggregateRequest(query_string)
+        .scorer("BM25")
+        .add_scores()
+        .apply(hybrid_score="@__score + @dist")
+        .load("*")
+        .dialect(4)
+    )
+
+    res = client.ft().aggregate(
+        req,
+        query_params={"vec_param": np.array([0.11, 0.21]).astype(np.float32).tobytes()},
+    )
+
+    if isinstance(res, dict):
+        assert len(res["results"]) == 2
+    else:
+        assert len(res.rows) == 2
+        for row in res.rows:
+            len(row) == 6
+
+
 @pytest.mark.redismod
 @skip_ifmodversion_lt("2.0.0", "search")
 def test_index_definition(client):

From 3d45064bb5d0b60d0d33360edff2697297303130 Mon Sep 17 00:00:00 2001
From: Igor Malinovskiy <u.glide@gmail.com>
Date: Thu, 21 Nov 2024 10:32:00 +0100
Subject: [PATCH 0938/1164] Migrate to clients test image (#3415)

* Migrate to client-testing image

- Use clients-testing image for standalone and cluster
- Remove hardcoded TLS certificates and keys
- Remove stunnel
- Remove Cluster docker and configs

* Fix migration bugs

* Create reusable action to run tests

- Reduce copy paste by using reusable action for running tests
- Gain better control of tests matrix

Add missing actions checkout

More fixes in integration workflow

Another attempt to fix matrix

* Reorg test matrix

* Fix jobs names and execution order

* Execute standalone and cluster test simultaneously

* Streamline test execution

- Automatically map Redis version to Redis Stack version and use it for testing module commands
- Remove Graph commands from execution by default
- Include more Redis versions to the test matrix

* More fixes to integration job

* Move python compatibility tests to a separate task

* Improve run-tests action

* Add missing pytest marks for TS tests

* Fix cluster configuration

* Debug cluster tests

* Fix Cluster TLS port

* Move current redis version to env var

* Fix ssl tests

* Show CLUSTER NODES on fail

* Fix integration workflow bugs

* Add workarounds for IPv6 bug in tests

* Use hostname instead of hardcoded IPv4 loopback

* Fix bug in _get_client

* Fix run-tests action

* Fix imports

* Add missing version guards in search tests

* Add compatibility for Redis < 7

* Add missing version guard in search tests

* Fix run-tests

* Add missing tls-auth-clients option

* Skip module tests when Redis < 7 and RESP3 is enabled

* Fix async test_moved_redirection_on_slave_with_default

The test was broken for a while after migrating to all-in-one container with Cluster

* Cleanup test after debugging

* Use correct profile in install_and_test.sh

* Use matrix to execute hiredis<=3.0.0 tests

* Fix hiredis job

* Fix pytest command in install_and_test.sh

* Use 7.4.1 as default version in docker-compose.yml

* Fix uvloop-tests
---
 .github/actions/run-tests/action.yml  | 147 +++++++++++++++++++
 .github/workflows/install_and_test.sh |   8 +-
 .github/workflows/integration.yaml    | 195 +++++++++++---------------
 .gitignore                            |   4 +
 docker-compose.yml                    |  75 +++++-----
 dockers/Dockerfile.cluster            |   7 -
 dockers/cluster.redis.conf            |   2 -
 dockers/create_cluster.sh             |  47 -------
 dockers/stunnel/README                |   1 -
 dockers/stunnel/conf/redis.conf       |   6 -
 dockers/stunnel/create_certs.sh       |  45 ------
 dockers/stunnel/keys/ca-cert.pem      |  19 ---
 dockers/stunnel/keys/ca-key.pem       |  28 ----
 dockers/stunnel/keys/client-cert.pem  |  17 ---
 dockers/stunnel/keys/client-key.pem   |  28 ----
 dockers/stunnel/keys/client-req.pem   |  15 --
 dockers/stunnel/keys/server-cert.pem  |  17 ---
 dockers/stunnel/keys/server-key.pem   |  28 ----
 dockers/stunnel/keys/server-req.pem   |  15 --
 pytest.ini                            |   1 +
 tasks.py                              |  20 ++-
 tests/conftest.py                     |  38 ++---
 tests/ssl_utils.py                    |  41 +++++-
 tests/test_asyncio/test_cluster.py    |  36 ++---
 tests/test_asyncio/test_connect.py    |  29 ++--
 tests/test_asyncio/test_cwe_404.py    |   4 +-
 tests/test_asyncio/test_graph.py      |  40 +++---
 tests/test_asyncio/test_search.py     |   2 +
 tests/test_asyncio/test_timeseries.py |   5 +
 tests/test_cluster.py                 |  13 +-
 tests/test_connect.py                 |  27 ++--
 tests/test_graph.py                   |  46 +++---
 tests/test_graph_utils/test_edge.py   |   8 +-
 tests/test_graph_utils/test_node.py   |   6 +-
 tests/test_graph_utils/test_path.py   |  10 +-
 tests/test_search.py                  |  13 ++
 tests/test_ssl.py                     |  55 ++++----
 37 files changed, 503 insertions(+), 595 deletions(-)
 create mode 100644 .github/actions/run-tests/action.yml
 delete mode 100644 dockers/Dockerfile.cluster
 delete mode 100644 dockers/cluster.redis.conf
 delete mode 100644 dockers/create_cluster.sh
 delete mode 100644 dockers/stunnel/README
 delete mode 100644 dockers/stunnel/conf/redis.conf
 delete mode 100755 dockers/stunnel/create_certs.sh
 delete mode 100644 dockers/stunnel/keys/ca-cert.pem
 delete mode 100644 dockers/stunnel/keys/ca-key.pem
 delete mode 100644 dockers/stunnel/keys/client-cert.pem
 delete mode 100644 dockers/stunnel/keys/client-key.pem
 delete mode 100644 dockers/stunnel/keys/client-req.pem
 delete mode 100644 dockers/stunnel/keys/server-cert.pem
 delete mode 100644 dockers/stunnel/keys/server-key.pem
 delete mode 100644 dockers/stunnel/keys/server-req.pem

diff --git a/.github/actions/run-tests/action.yml b/.github/actions/run-tests/action.yml
new file mode 100644
index 0000000000..64d31969bd
--- /dev/null
+++ b/.github/actions/run-tests/action.yml
@@ -0,0 +1,147 @@
+name: 'Run redis-py tests'
+description: 'Runs redis-py tests against different Redis versions and configurations'
+inputs:
+  python-version:
+    description: 'Python version to use for running tests'
+    default: '3.12'
+  parser-backend:
+    description: 'Parser backend to use: plain or hiredis'
+    required: true
+  redis-version:
+    description: 'Redis version to test against'
+    required: true
+  hiredis-version:
+    description: 'hiredis version to test against'
+    required: false
+    default: '>3.0.0'
+  event-loop:
+    description: 'Event loop to use'
+    required: false
+    default: 'asyncio'
+runs:
+  using: "composite"
+  steps:
+    - uses: actions/checkout@v4
+
+    - uses: actions/setup-python@v5
+      with:
+        python-version: ${{ inputs.python-version }}
+        cache: 'pip'
+
+    - name: Setup Test environment
+      env:
+        REDIS_VERSION: ${{ inputs.redis-version }}
+        REDIS_IMAGE: "redis:${{ inputs.redis-version }}"
+        CLIENT_LIBS_TEST_IMAGE: "redislabs/client-libs-test:${{ inputs.redis-version }}"
+      run: |
+        set -e
+                
+        echo "::group::Installing dependencies"
+        pip install -U setuptools wheel
+        pip install -r requirements.txt
+        pip install -r dev_requirements.txt
+        if [ "${{inputs.parser-backend}}" == "hiredis" ]; then
+          pip install "hiredis${{inputs.hiredis-version}}"
+          echo "PARSER_BACKEND=$(echo "${{inputs.parser-backend}}_${{inputs.hiredis-version}}" | sed 's/[^a-zA-Z0-9]/_/g')" >> $GITHUB_ENV        
+        else
+          echo "PARSER_BACKEND=${{inputs.parser-backend}}" >> $GITHUB_ENV
+        fi
+        echo "::endgroup::"
+        
+        echo "::group::Starting Redis servers"
+        redis_major_version=$(echo "$REDIS_VERSION" | grep -oP '^\d+')
+        
+        if (( redis_major_version < 8 )); then
+          echo "Using redis-stack for module tests"
+        
+          # Mapping of redis version to stack version  
+          declare -A redis_stack_version_mapping=(
+            ["7.4.1"]="7.4.0-v1"
+            ["7.2.6"]="7.2.0-v13"
+            ["6.2.16"]="6.2.6-v17"
+          )
+                  
+          if [[ -v redis_stack_version_mapping[$REDIS_VERSION] ]]; then
+            export REDIS_STACK_IMAGE="redis/redis-stack-server:${redis_stack_version_mapping[$REDIS_VERSION]}"
+            echo "REDIS_MOD_URL=redis://127.0.0.1:6479/0" >> $GITHUB_ENV
+          else
+            echo "Version not found in the mapping."
+            exit 1
+          fi
+                  
+          if (( redis_major_version < 7 )); then
+            export REDIS_STACK_EXTRA_ARGS="--tls-auth-clients optional --save ''"
+            export REDIS_EXTRA_ARGS="--tls-auth-clients optional --save ''"
+            echo "REDIS_MAJOR_VERSION=${redis_major_version}" >> $GITHUB_ENV
+          fi
+        
+          invoke devenv --endpoints=all-stack
+        else
+          echo "Using redis CE for module tests"
+          echo "REDIS_MOD_URL=redis://127.0.0.1:6379" >> $GITHUB_ENV
+          invoke devenv --endpoints all
+        fi        
+        
+        sleep 10 # time to settle
+        echo "::endgroup::"
+      shell: bash
+
+    - name: Run tests
+      run: |
+        set -e
+        
+        run_tests() {
+          local protocol=$1
+          local eventloop=""
+    
+          if [ "${{inputs.event-loop}}" == "uvloop" ]; then
+            eventloop="--uvloop"
+          fi
+    
+          echo "::group::RESP${protocol} standalone tests"
+          echo "REDIS_MOD_URL=${REDIS_MOD_URL}"
+        
+          if (( $REDIS_MAJOR_VERSION < 7 )) && [ "$protocol" == "3" ]; then
+            echo "Skipping module tests: Modules doesn't support RESP3 for Redis versions < 7"
+            invoke standalone-tests --redis-mod-url=${REDIS_MOD_URL} $eventloop --protocol="${protocol}" --extra-markers="not redismod"
+          else        
+            invoke standalone-tests --redis-mod-url=${REDIS_MOD_URL} $eventloop --protocol="${protocol}"
+          fi
+        
+          echo "::endgroup::"
+    
+          if [ "$protocol" == "2" ] || [ "${{inputs.parser-backend}}" != 'hiredis' ]; then
+            echo "::group::RESP${protocol} cluster tests"
+            invoke cluster-tests $eventloop --protocol=${protocol}
+            echo "::endgroup::"
+          fi
+        }
+  
+        run_tests 2 "${{inputs.event-loop}}"
+        run_tests 3 "${{inputs.event-loop}}"
+      shell: bash
+
+    - name: Debug
+      if: failure()
+      run: |
+        sudo apt-get install -y redis-tools
+        echo "Docker Containers:"
+        docker ps
+        redis-cli -p 16379 CLUSTER NODES
+      shell: bash
+
+    - name: Upload test results and profiling data
+      uses: actions/upload-artifact@v4
+      with:
+        name: pytest-results-redis_${{inputs.redis-version}}-python_${{inputs.python-version}}-parser_${{env.PARSER_BACKEND}}-el_${{inputs.event-loop}}
+        path: |
+          *-results.xml
+          prof/**
+          profile_output*
+        if-no-files-found: error
+        retention-days: 10
+
+    - name: Upload codecov coverage
+      uses: codecov/codecov-action@v4
+      with:
+        fail_ci_if_error: false
diff --git a/.github/workflows/install_and_test.sh b/.github/workflows/install_and_test.sh
index 33a1edb1e7..5c879c1b3a 100755
--- a/.github/workflows/install_and_test.sh
+++ b/.github/workflows/install_and_test.sh
@@ -21,7 +21,7 @@ python -m venv ${DESTENV}
 source ${DESTENV}/bin/activate
 pip install --upgrade --quiet pip
 pip install --quiet -r dev_requirements.txt
-invoke devenv
+invoke devenv --endpoints=all-stack
 invoke package
 
 # find packages
@@ -39,7 +39,9 @@ cd ${TESTDIR}
 # install, run tests
 pip install ${PKG}
 # Redis tests
-pytest -m 'not onlycluster'
+pytest -m 'not onlycluster and not graph'
 # RedisCluster tests
 CLUSTER_URL="redis://localhost:16379/0"
-pytest -m 'not onlynoncluster and not redismod and not ssl' --redis-url=${CLUSTER_URL}
+CLUSTER_SSL_URL="rediss://localhost:27379/0"
+pytest -m 'not onlynoncluster and not redismod and not ssl and not graph' \
+  --redis-url="${CLUSTER_URL}" --redis-ssl-url="${CLUSTER_SSL_URL}"
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index ed969d11f1..7c74de5290 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -29,6 +29,7 @@ env:
   COVERAGE_CORE: sysmon
   REDIS_IMAGE: redis:latest
   REDIS_STACK_IMAGE: redis/redis-stack-server:latest
+  CURRENT_REDIS_VERSION: '7.4.1'
 
 jobs:
   dependency-audit:
@@ -56,148 +57,118 @@ jobs:
           pip install -r dev_requirements.txt
           invoke linters
 
-  resp2-tests:
+  redis_version:
+    runs-on: ubuntu-latest
+    outputs:
+      CURRENT: ${{ env.CURRENT_REDIS_VERSION }}
+    steps:
+      - name: Compute outputs
+        run: |
+          echo "CURRENT=${{ env.CURRENT_REDIS_VERSION }}" >> $GITHUB_OUTPUT
+
+  tests:
     runs-on: ubuntu-latest
     timeout-minutes: 60
+    needs: redis_version
     strategy:
       max-parallel: 15
       fail-fast: false
       matrix:
-        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12', 'pypy-3.9', 'pypy-3.10']
-        test-type: ['standalone', 'cluster']
-        connection-type: ['hiredis', 'plain']
+        redis-version: [ '${{ needs.redis_version.outputs.CURRENT }}', '7.2.6', '6.2.16']
+        python-version: ['3.8', '3.12']
+        parser-backend: ['plain']
+        event-loop: ['asyncio']
     env:
       ACTIONS_ALLOW_UNSECURE_COMMANDS: true
-    name: RESP2 ${{ matrix.python-version }} ${{matrix.test-type}}-${{matrix.connection-type}}
+    name: Redis ${{ matrix.redis-version }}; Python ${{ matrix.python-version }}; RESP Parser:${{matrix.parser-backend}}; EL:${{matrix.event-loop}}
     steps:
       - uses: actions/checkout@v4
-
-      - uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-          cache: 'pip'
-
       - name: Run tests
-        run: |
-          pip install -U setuptools wheel
-          pip install -r requirements.txt
-          pip install -r dev_requirements.txt
-          if [ "${{matrix.connection-type}}" == "hiredis" ]; then
-           pip install hiredis
-          fi
-          invoke devenv
-          sleep 10 # time to settle
-          invoke ${{matrix.test-type}}-tests
-          ls -1
-
-      - name: Run tests against hiredis < 3.0.0
-        if: ${{ matrix.connection-type == 'hiredis' && matrix.python-version == '3.12'}}
-        run: |
-          pip uninstall hiredis -y
-          pip install -U setuptools wheel
-          pip install -r requirements.txt
-          pip install -r dev_requirements.txt
-          if [ "${{matrix.connection-type}}" == "hiredis" ]; then
-           pip install "hiredis<3.0.0"
-          fi
-          invoke devenv
-          sleep 10 # time to settle
-          invoke ${{matrix.test-type}}-tests
-          ls -1
-
-      - name: Upload test results and profiling data
-        uses: actions/upload-artifact@v4
+        uses: ./.github/actions/run-tests
         with:
-          name: pytest-results-${{matrix.test-type}}-${{matrix.connection-type}}-${{matrix.python-version}}
-          path: |
-            ${{matrix.test-type}}*-results.xml
-            prof/**
-            profile_output*
-          if-no-files-found: error
-          retention-days: 10
+            python-version: ${{ matrix.python-version }}
+            parser-backend: ${{ matrix.parser-backend }}
+            redis-version: ${{ matrix.redis-version }}
 
-      - name: Upload codecov coverage
-        uses: codecov/codecov-action@v4
-        with:
-          fail_ci_if_error: false
-
-  resp3-tests:
+  python-compatibility-tests:
     runs-on: ubuntu-latest
+    needs: [ redis_version, tests ]
+    timeout-minutes: 60
     strategy:
+      max-parallel: 15
       fail-fast: false
       matrix:
-        python-version: ['3.8', '3.12']
-        test-type: ['standalone', 'cluster']
-        connection-type: ['hiredis', 'plain']
-        event-loop: ['asyncio', 'uvloop']
-        exclude:
-          - test-type: 'cluster'
-            connection-type: 'hiredis'
+        redis-version: [ '${{ needs.redis_version.outputs.CURRENT }}' ]
+        python-version: ['3.9', '3.10', '3.11', 'pypy-3.9', 'pypy-3.10']
+        parser-backend: [ 'plain' ]
+        event-loop: [ 'asyncio' ]
     env:
       ACTIONS_ALLOW_UNSECURE_COMMANDS: true
-    name: RESP3 ${{ matrix.python-version }} ${{matrix.test-type}}-${{matrix.connection-type}}-${{matrix.event-loop}}
+    name: Redis ${{ matrix.redis-version }}; Python ${{ matrix.python-version }}; RESP Parser:${{matrix.parser-backend}}; EL:${{matrix.event-loop}}
     steps:
       - uses: actions/checkout@v4
-
-      - uses: actions/setup-python@v5
+      - name: Run tests
+        uses: ./.github/actions/run-tests
         with:
           python-version: ${{ matrix.python-version }}
-          cache: 'pip'
+          parser-backend: ${{ matrix.parser-backend }}
+          redis-version: ${{ matrix.redis-version }}
 
+  hiredis-tests:
+    runs-on: ubuntu-latest
+    needs: [redis_version, tests]
+    timeout-minutes: 60
+    strategy:
+      max-parallel: 15
+      fail-fast: false
+      matrix:
+        redis-version: [ '${{ needs.redis_version.outputs.CURRENT }}' ]
+        python-version: [ '3.8', '3.12']
+        parser-backend: [ 'hiredis' ]
+        hiredis-version: [ '>=3.0.0', '<3.0.0' ]
+        event-loop: [ 'asyncio' ]
+    env:
+      ACTIONS_ALLOW_UNSECURE_COMMANDS: true
+    name: Redis ${{ matrix.redis-version }}; Python ${{ matrix.python-version }}; RESP Parser:${{matrix.parser-backend}} (${{ matrix.hiredis-version }}); EL:${{matrix.event-loop}}
+    steps:
+      - uses: actions/checkout@v4
       - name: Run tests
-        run: |
-          pip install -U setuptools wheel
-          pip install -r requirements.txt
-          pip install -r dev_requirements.txt
-          if [ "${{matrix.connection-type}}" == "hiredis" ]; then
-            pip install hiredis
-          fi
-          invoke devenv
-          sleep 10 # time to settle
-          if [ "${{matrix.event-loop}}" == "uvloop" ]; then
-            invoke ${{matrix.test-type}}-tests --uvloop --protocol=3
-          else
-            invoke ${{matrix.test-type}}-tests --protocol=3
-          fi
-
-      - name: Run tests against hiredis < 3.0.0
-        if: ${{ matrix.connection-type == 'hiredis' && matrix.python-version == '3.12'}}
-        run: |
-          pip uninstall hiredis -y
-          pip install -U setuptools wheel
-          pip install -r requirements.txt
-          pip install -r dev_requirements.txt
-          if [ "${{matrix.connection-type}}" == "hiredis" ]; then
-            pip install "hiredis<3.0.0"
-          fi
-          invoke devenv
-          sleep 10 # time to settle
-          if [ "${{matrix.event-loop}}" == "uvloop" ]; then
-            invoke ${{matrix.test-type}}-tests --uvloop --protocol=3
-          else
-            invoke ${{matrix.test-type}}-tests --protocol=3
-          fi
-
-      - name: Upload test results and profiling data
-        uses: actions/upload-artifact@v4
+        uses: ./.github/actions/run-tests
         with:
-          name: pytest-results-${{matrix.test-type}}-${{matrix.connection-type}}-${{matrix.python-version}}-${{matrix.event-loop}}-resp3
-          path: |
-            ${{matrix.test-type}}*-results.xml
-            prof/**
-            profile_output*
-          if-no-files-found: error
-          retention-days: 10
+          python-version: ${{ matrix.python-version }}
+          parser-backend: ${{ matrix.parser-backend }}
+          redis-version: ${{ matrix.redis-version }}
+          hiredis-version: ${{ matrix.hiredis-version }}
 
-      - name: Upload codecov coverage
-        uses: codecov/codecov-action@v4
+  uvloop-tests:
+    runs-on: ubuntu-latest
+    needs: [redis_version, tests]
+    timeout-minutes: 60
+    strategy:
+      max-parallel: 15
+      fail-fast: false
+      matrix:
+        redis-version: [ '${{ needs.redis_version.outputs.CURRENT }}' ]
+        python-version: [ '3.8', '3.12' ]
+        parser-backend: [ 'plain' ]
+        event-loop: [ 'uvloop' ]
+    env:
+      ACTIONS_ALLOW_UNSECURE_COMMANDS: true
+    name: Redis ${{ matrix.redis-version }}; Python ${{ matrix.python-version }}; RESP Parser:${{matrix.parser-backend}}; EL:${{matrix.event-loop}}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Run tests
+        uses: ./.github/actions/run-tests
         with:
-          fail_ci_if_error: false
+          python-version: ${{ matrix.python-version }}
+          parser-backend: ${{ matrix.parser-backend }}
+          redis-version: ${{ matrix.redis-version }}
+          event-loop: ${{ matrix.event-loop }}
 
   build-and-test-package:
     name: Validate building and installing the package
     runs-on: ubuntu-latest
-    needs: [resp2-tests, resp3-tests]
+    needs: [tests]
     strategy:
       fail-fast: false
       matrix:
@@ -208,6 +179,10 @@ jobs:
         with:
           python-version: 3.9
       - name: Run installed unit tests
+        env:
+          REDIS_VERSION: ${{ env.CURRENT_REDIS_VERSION }}
+          REDIS_IMAGE: "redis:${{ env.CURRENT_REDIS_VERSION }}"
+          CLIENT_LIBS_TEST_IMAGE: "redislabs/client-libs-test:${{ env.CURRENT_REDIS_VERSION }}"
         run: |
           bash .github/workflows/install_and_test.sh ${{ matrix.extension }}
 
diff --git a/.gitignore b/.gitignore
index c6a4efd1ec..ee1bda0fa5 100644
--- a/.gitignore
+++ b/.gitignore
@@ -19,3 +19,7 @@ coverage.xml
 prof
 profile_output*
 docker/stunnel/keys
+/dockers/*/node-*/*
+/dockers/*/tls/*
+/dockers/standalone/
+/dockers/cluster/
diff --git a/docker-compose.yml b/docker-compose.yml
index c8528a7d58..7804f09c8a 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,69 +1,64 @@
 ---
 
-version: "3.8"
-
 services:
 
   redis:
-    image: ${REDIS_IMAGE:-redis:latest}
+    image: ${CLIENT_LIBS_TEST_IMAGE:-redislabs/client-libs-test:7.4.1}
     container_name: redis-standalone
-    command: redis-server --enable-debug-command yes --protected-mode no
+    environment:
+      - TLS_ENABLED=yes
+      - REDIS_CLUSTER=no
+      - PORT=6379
+      - TLS_PORT=6666
+    command: ${REDIS_EXTRA_ARGS:---enable-debug-command yes --enable-module-command yes --tls-auth-clients optional --save ""}
     ports:
       - 6379:6379
+      - 6666:6666 # TLS port
+    volumes:
+      - "./dockers/standalone:/redis/work"
     profiles:
       - standalone
       - sentinel
       - replica
+      - all-stack
       - all
 
   replica:
-    image: ${REDIS_IMAGE:-redis:latest}
+    image: ${REDIS_IMAGE:-redis:7.4.1}
     container_name: redis-replica
     depends_on:
       - redis
-    command: redis-server --replicaof redis 6379 --protected-mode no
+    command: redis-server --replicaof redis 6379 --protected-mode no --save ""
     ports:
       - 6380:6379
     profiles:
       - replica
+      - all-stack
       - all
 
   cluster:
+    image: ${CLIENT_LIBS_TEST_IMAGE:-redislabs/client-libs-test:7.4.1}
     container_name: redis-cluster
-    build:
-      context: .
-      dockerfile: dockers/Dockerfile.cluster
-      args:
-        REDIS_IMAGE: ${REDIS_IMAGE:-redis:latest}
+    environment:
+      - REDIS_CLUSTER=yes
+      - NODES=6
+      - REPLICAS=1
+      - TLS_ENABLED=yes
+      - PORT=16379
+      - TLS_PORT=27379
+    command: ${REDIS_EXTRA_ARGS:---enable-debug-command yes --enable-module-command yes --tls-auth-clients optional --save ""}
     ports:
-      - 16379:16379
-      - 16380:16380
-      - 16381:16381
-      - 16382:16382
-      - 16383:16383
-      - 16384:16384
+      - "16379-16384:16379-16384"
+      - "27379-27384:27379-27384"
     volumes:
-      - "./dockers/cluster.redis.conf:/redis.conf:ro"
+      - "./dockers/cluster:/redis/work"
     profiles:
       - cluster
+      - all-stack
       - all
 
-  stunnel:
-    image: redisfab/stunnel:latest
-    depends_on:
-      - redis
-    ports:
-      - 6666:6666
-    profiles:
-      - all
-      - standalone
-      - ssl
-    volumes:
-      - "./dockers/stunnel/conf:/etc/stunnel/conf.d:ro"
-      - "./dockers/stunnel/keys:/etc/stunnel/keys:ro"
-
   sentinel:
-    image: ${REDIS_IMAGE:-redis:latest}
+    image: ${REDIS_IMAGE:-redis:7.4.1}
     container_name: redis-sentinel
     depends_on:
       - redis
@@ -74,10 +69,11 @@ services:
       - "./dockers/sentinel.conf:/redis.conf"
     profiles:
       - sentinel
+      - all-stack
       - all
 
   sentinel2:
-    image: ${REDIS_IMAGE:-redis:latest}
+    image: ${REDIS_IMAGE:-redis:7.4.1}
     container_name: redis-sentinel2
     depends_on:
       - redis
@@ -88,10 +84,11 @@ services:
       - "./dockers/sentinel.conf:/redis.conf"
     profiles:
       - sentinel
+      - all-stack
       - all
 
   sentinel3:
-    image: ${REDIS_IMAGE:-redis:latest}
+    image: ${REDIS_IMAGE:-redis:7.4.1}
     container_name: redis-sentinel3
     depends_on:
       - redis
@@ -102,6 +99,7 @@ services:
       - "./dockers/sentinel.conf:/redis.conf"
     profiles:
       - sentinel
+      - all-stack
       - all
 
   redis-stack:
@@ -110,10 +108,10 @@ services:
     ports:
       - 6479:6379
     environment:
-      - "REDIS_ARGS=--enable-debug-command yes --enable-module-command yes"
+      - "REDIS_ARGS=${REDIS_STACK_EXTRA_ARGS:---enable-debug-command yes --enable-module-command yes --save ''}"
     profiles:
       - standalone
-      - all
+      - all-stack
 
   redis-stack-graph:
     image: redis/redis-stack-server:6.2.6-v15
@@ -121,5 +119,4 @@ services:
     ports:
       - 6480:6379
     profiles:
-      - standalone
-      - all
+      - graph
diff --git a/dockers/Dockerfile.cluster b/dockers/Dockerfile.cluster
deleted file mode 100644
index 4096009f9a..0000000000
--- a/dockers/Dockerfile.cluster
+++ /dev/null
@@ -1,7 +0,0 @@
-ARG REDIS_IMAGE=redis:latest
-FROM $REDIS_IMAGE
-
-COPY dockers/create_cluster.sh /create_cluster.sh
-RUN chmod a+x /create_cluster.sh
-
-ENTRYPOINT [ "/create_cluster.sh"]
diff --git a/dockers/cluster.redis.conf b/dockers/cluster.redis.conf
deleted file mode 100644
index e9f7617d09..0000000000
--- a/dockers/cluster.redis.conf
+++ /dev/null
@@ -1,2 +0,0 @@
-protected-mode no
-enable-debug-command yes
diff --git a/dockers/create_cluster.sh b/dockers/create_cluster.sh
deleted file mode 100644
index dc17c7c4d9..0000000000
--- a/dockers/create_cluster.sh
+++ /dev/null
@@ -1,47 +0,0 @@
-#! /bin/bash
-
-mkdir -p /nodes
-touch /nodes/nodemap
-if [ -z ${START_PORT} ]; then
-    START_PORT=16379
-fi
-if [ -z ${END_PORT} ]; then
-    END_PORT=16384
-fi
-if [ ! -z "$3" ]; then
-    START_PORT=$2
-    START_PORT=$3
-fi
-echo "STARTING: ${START_PORT}"
-echo "ENDING: ${END_PORT}"
-
-for PORT in `seq ${START_PORT} ${END_PORT}`; do
-  mkdir -p /nodes/$PORT
-  if [[ -e /redis.conf ]]; then
-    cp /redis.conf /nodes/$PORT/redis.conf
-  else
-    touch /nodes/$PORT/redis.conf
-  fi
-  cat << EOF >> /nodes/$PORT/redis.conf
-port ${PORT}
-cluster-enabled yes
-daemonize yes
-logfile /redis.log
-dir /nodes/$PORT
-EOF
-
-  set -x
-  redis-server /nodes/$PORT/redis.conf
-  sleep 1
-  if [ $? -ne 0 ]; then
-    echo "Redis failed to start, exiting."
-    continue
-  fi
-  echo 127.0.0.1:$PORT >> /nodes/nodemap
-done
-if [ -z "${REDIS_PASSWORD}" ]; then
-    echo yes | redis-cli --cluster create `seq -f 127.0.0.1:%g ${START_PORT} ${END_PORT}` --cluster-replicas 1
-else
-    echo yes | redis-cli -a ${REDIS_PASSWORD} --cluster create `seq -f 127.0.0.1:%g ${START_PORT} ${END_PORT}` --cluster-replicas 1
-fi
-tail -f /redis.log
diff --git a/dockers/stunnel/README b/dockers/stunnel/README
deleted file mode 100644
index e92ae78981..0000000000
--- a/dockers/stunnel/README
+++ /dev/null
@@ -1 +0,0 @@
- This directory contains a helper script to create ssl certificates for ssl tests. If the certificates are out of date, re-run create_certs and check them in. These are snake oil certificates.
diff --git a/dockers/stunnel/conf/redis.conf b/dockers/stunnel/conf/redis.conf
deleted file mode 100644
index a150d8b011..0000000000
--- a/dockers/stunnel/conf/redis.conf
+++ /dev/null
@@ -1,6 +0,0 @@
-[redis]
-accept = 6666
-connect = redis:6379
-cert = /etc/stunnel/keys/server-cert.pem
-key = /etc/stunnel/keys/server-key.pem
-verify = 0
diff --git a/dockers/stunnel/create_certs.sh b/dockers/stunnel/create_certs.sh
deleted file mode 100755
index 4065562cfb..0000000000
--- a/dockers/stunnel/create_certs.sh
+++ /dev/null
@@ -1,45 +0,0 @@
-#!/bin/bash
-
-set -e
-
-DESTDIR=`dirname "$0"`/keys
-test -d ${DESTDIR} || mkdir ${DESTDIR}
-cd ${DESTDIR}
-
-which openssl &>/dev/null
-if [ $? -ne 0 ]; then
-	echo "No openssl binary present, exiting."
-	exit 1
-fi
-
-openssl genrsa -out ca-key.pem 2048 &>/dev/null
-
-openssl req -new -x509 -nodes -days 365000 \
-   -key ca-key.pem \
-   -out ca-cert.pem \
-   -subj "/CN=redis-py-ca" &>/dev/null
-
-openssl req -newkey rsa:2048 -nodes -days 365000 \
-   -keyout server-key.pem \
-   -out server-req.pem \
-   -subj "/CN=redis-py-server" &>/dev/null
-
-openssl x509 -req -days 365000 -set_serial 01 \
-   -in server-req.pem \
-   -out server-cert.pem \
-   -CA ca-cert.pem \
-   -CAkey ca-key.pem &>/dev/null
-
-openssl req -newkey rsa:2048 -nodes -days 365000 \
-   -keyout client-key.pem \
-   -out client-req.pem \
-   -subj "/CN=redis-py-client" &>/dev/null
-
-openssl x509 -req -days 365000 -set_serial 01 \
-   -in client-req.pem \
-   -out client-cert.pem \
-   -CA ca-cert.pem \
-   -CAkey ca-key.pem &>/dev/null
-
-echo "Keys generated in ${DESTDIR}:"
-ls
diff --git a/dockers/stunnel/keys/ca-cert.pem b/dockers/stunnel/keys/ca-cert.pem
deleted file mode 100644
index 291cf8e23f..0000000000
--- a/dockers/stunnel/keys/ca-cert.pem
+++ /dev/null
@@ -1,19 +0,0 @@
------BEGIN CERTIFICATE-----
-MIIDDzCCAfegAwIBAgIUZWdrJiIH/w7FJkNbLTYldxOFEpswDQYJKoZIhvcNAQEL
-BQAwFjEUMBIGA1UEAwwLcmVkaXMtcHktY2EwIBcNMjQwNTA5MDcyMDE4WhgPMzAy
-MzA5MTAwNzIwMThaMBYxFDASBgNVBAMMC3JlZGlzLXB5LWNhMIIBIjANBgkqhkiG
-9w0BAQEFAAOCAQ8AMIIBCgKCAQEA0N9BXLRx3Hxb+ZGuKi5hZabcDWDMEeUGunJG
-F1ijxO9XbNWXxYiR127Le2dMkS3TefU3CNiiYJa7eRxMPAS/wGUp6Bb7LrCoeC3F
-1bfJSYnzC6SwhMq66m51VhqctjAbJxBBAPYqyNBFB2w2BQZOIkKDNPgPJTDNmF/7
-G/5jmAaOPlhm1GITnT+sSTyfr/JcoRRbV9VTVc9VUaTjk6ytHsW+K2sK+uWrjdig
-qdzZDng0gtasTn907QkTDDyR4E/UY9N47aD2Jy5F3XHesy9kEfuppq+A1WYOs8/H
-bXgEL53ncayqDNAgjnid5kHvKJ9wTAPSMDqmupHG0l5ADisahwIDAQABo1MwUTAd
-BgNVHQ4EFgQUWg70hcbq4zibHXAFlZd8mHVEWzowHwYDVR0jBBgwFoAUWg70hcbq
-4zibHXAFlZd8mHVEWzowDwYDVR0TAQH/BAUwAwEB/zANBgkqhkiG9w0BAQsFAAOC
-AQEAe1qupf8GoqCgtzTwFCwmcDygLibX4vI/EfCMOLVZHMgDacDwQbmYPlM+goJT
-Pz8WCklopFcMJ6MSdUGy3g4hjKmJpKttTSuhEd3uZWPZYjhRj2SY8531/aAajg9/
-oezyvlgN/DWXAREG31XWyXLzPU7VLbg99mYB+2+lo2cAciAOCBdIOu6WzqnQax82
-aDSqXIHiTGc/5QYZ6ZIzdVRYiVdddKSxTNKZn9x0hu3L8r2e9ryGLLVKJmZfNZDS
-tXYwiY3fE0EwYViIPiPlmBEXiBhHlC2kAQMFK8Qd4LgX6rGki4luL15GYxxKPQbF
-EtDS9EqM4EdRWZq3SDjOA1zODA==
------END CERTIFICATE-----
diff --git a/dockers/stunnel/keys/ca-key.pem b/dockers/stunnel/keys/ca-key.pem
deleted file mode 100644
index 25989d0817..0000000000
--- a/dockers/stunnel/keys/ca-key.pem
+++ /dev/null
@@ -1,28 +0,0 @@
------BEGIN PRIVATE KEY-----
-MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDQ30FctHHcfFv5
-ka4qLmFlptwNYMwR5Qa6ckYXWKPE71ds1ZfFiJHXbst7Z0yRLdN59TcI2KJglrt5
-HEw8BL/AZSnoFvsusKh4LcXVt8lJifMLpLCEyrrqbnVWGpy2MBsnEEEA9irI0EUH
-bDYFBk4iQoM0+A8lMM2YX/sb/mOYBo4+WGbUYhOdP6xJPJ+v8lyhFFtX1VNVz1VR
-pOOTrK0exb4rawr65auN2KCp3NkOeDSC1qxOf3TtCRMMPJHgT9Rj03jtoPYnLkXd
-cd6zL2QR+6mmr4DVZg6zz8dteAQvnedxrKoM0CCOeJ3mQe8on3BMA9IwOqa6kcbS
-XkAOKxqHAgMBAAECggEAB16eh28qcUrF/VPsNDrMtEcjOSmdfv14s6K34bepQkKQ
-8BsdLsVhzUXF0jB+iBojfbMZjQCvwf6vgKzEl9LcZ8+/Sca9zWjtmMfsqgdrsmI2
-psYvIDr9m1XoYpsFGnyEs2fPE1dG19eusn4D7et0svVr0bZK5SyypFoGmcyWUP/M
-kA990HAP7enGzPfpvcpr++Iu3EwWlTY3rjYgh9a7AiFhtj9zDzb9Sg0+4Xl9+8TZ
-dsOvyVsiLu09MZ3vScGg5l+46w+rai+R0IxpgI9QM0sMxAS3AYFY666akrJqn6NU
-S0Q5Q9gZ5V9hHxU7IHfo3weygPQuBW07nbwtX6+JCQKBgQDp7+smBlstRD+1/ZHJ
-KO4Xhi+yrhtkKzViC+gF2vXpZ1GQ+3plRJFzRMFu+LkBgn1jPfg479Tm7CM4W4vM
-cTZo45+hhnpwmLGnltTf3Vw23yXzLdUMenaE2u66PWh3DFPkPHwNqb30QGnx131Q
-Mjnp+2EsBdiZ1d8TFF815ucG7QKBgQDkkiz7I4JgGGCbd51AseFryHgUepsrgeaA
-DIWKEKBOoxOnfWH7JOxtm0oXcpWHLciQ4M6FaTFNv2vNA9Hrz5yApXFwIkKgXVU9
-+zsok4eWdEYmwxZFwjCNYvzsIDGBBwa1PQeps6C5L+nciOE8IZHYW7egAR96prV3
-E4ZQ6aWkwwKBgQCL/nJXIAiiLyx9SVBb9C1/UGLs57ommKDqmrtv/ZeZ5KVwQL3/
-KihstaGYOinkmGVW5XfNAuECjB+Lk2U2pC1uWYFm1SYiiY4O/3lGup57i9CXFT9g
-p0yTtryUITmJvIvbksKeHo05RO7hthYczuHPfwqooJr9fHpxXYiYpiRtBQKBgCp0
-kFBRhyzsOj2GWTokEDfh85PyNhI9vZ+5M7CyZ+RTXBo3KtToRdYSCxAR435JXcCz
-UQjswhCr5o0dEYfYdzxZ/pkSdAevbl7l5FYkGQI0NLeMcv2gFT6dzVban/dUY8WU
-QXEfAVKEeM7SyetOXPWwC4p3yu4QOxKUGNW8oFzbAoGBAK3WKV51jhmMz3dtCkGW
-UZxcDp5q/3uV29/UUF3/CNEhLcVuQLtNOPYRG+S9zMvwo0SNsz4mZJH1nFDSWSNL
-xGXg/Ret9Li4JQTWD47kcheBCVLoTtX1bc66D2LlXDKzN5DRBACxKkAJPUjouhMB
-mPDd05msnfgzPBMHMwsNjg5W
------END PRIVATE KEY-----
diff --git a/dockers/stunnel/keys/client-cert.pem b/dockers/stunnel/keys/client-cert.pem
deleted file mode 100644
index 4db466a4f2..0000000000
--- a/dockers/stunnel/keys/client-cert.pem
+++ /dev/null
@@ -1,17 +0,0 @@
------BEGIN CERTIFICATE-----
-MIICpjCCAY4CAQEwDQYJKoZIhvcNAQELBQAwFjEUMBIGA1UEAwwLcmVkaXMtcHkt
-Y2EwIBcNMjQwNTA5MDcyMDE5WhgPMzAyMzA5MTAwNzIwMTlaMBoxGDAWBgNVBAMM
-D3JlZGlzLXB5LWNsaWVudDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB
-ALOL3znn2vpX8+VHOlETymeFpw8wsCeOfr9fNhK2o5APIG1NhrGjlu+T7ri/DfrM
-ZmjF+uDSuuUs044o5SFOECNi7yOwpdC9YVWSPQQ5VrsMENqyjIYyq2BC7fLHztAt
-VF1jg0D0zijfFg/4meG2tAOnXLa0O9WUcmwsNlxEgyFzcLvCoTaXpUJbLYJZ2IxW
-BoKgJ85acLlIFQIex053CqmgG/odM8Ib8s1YO+IXI4JsJlJFd9we+zYgZ2TRSZ8L
-v8A8gXM+WTBZpZXNXYv020dW22X7gu+VH4LHcg/6eF0GtkdrFdlQjCEjwGIoVFTu
-fNSp3NvSSYrK/qeJtSNaSw0CAwEAATANBgkqhkiG9w0BAQsFAAOCAQEAdA1QqJn/
-d4rcSO8z2L64d3SdO4wLf78Qznh3vTrIlQ/i0sESRQppw1U57PHSyYtAJzc1MV39
-zgn8KvuQToPQl9UoRWD6mVK8L//xplTPxWJB4BqD/kUc+lA9akBNU8Yhx7KbI5zX
-z4OgTIeWAtY9R5CH1xbQlVCqAAk+SdDk2raOebNQMpzJrMUdeDTrgoDaBFnHgDbb
-XHQCOF9/LrbBlrTlNJh6PHY8YztrJKdDDhSxJ9Tudz7ynUA+NcZ8dF5o/Co+QD5b
-gkVdz/nV8LoDeO8QjJXsgsHFD/B+ljWYeEGc5flFe6jWLGOCtgQB5JhImg9lsWFh
-X9i921F9Cqox3Q==
------END CERTIFICATE-----
diff --git a/dockers/stunnel/keys/client-key.pem b/dockers/stunnel/keys/client-key.pem
deleted file mode 100644
index a53cbce0f2..0000000000
--- a/dockers/stunnel/keys/client-key.pem
+++ /dev/null
@@ -1,28 +0,0 @@
------BEGIN PRIVATE KEY-----
-MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQCzi98559r6V/Pl
-RzpRE8pnhacPMLAnjn6/XzYStqOQDyBtTYaxo5bvk+64vw36zGZoxfrg0rrlLNOO
-KOUhThAjYu8jsKXQvWFVkj0EOVa7DBDasoyGMqtgQu3yx87QLVRdY4NA9M4o3xYP
-+JnhtrQDp1y2tDvVlHJsLDZcRIMhc3C7wqE2l6VCWy2CWdiMVgaCoCfOWnC5SBUC
-HsdOdwqpoBv6HTPCG/LNWDviFyOCbCZSRXfcHvs2IGdk0UmfC7/APIFzPlkwWaWV
-zV2L9NtHVttl+4LvlR+Cx3IP+nhdBrZHaxXZUIwhI8BiKFRU7nzUqdzb0kmKyv6n
-ibUjWksNAgMBAAECggEAEelgSZyRwevITxU+AhyhUpaIxgErcabLijfrYw6JXrPD
-nmPfjhUt15TAefnFYUHG7ajikE81ietg54u44AuznHQgO0VCJYLfFPRT1foKZvqb
-K9YoIrMnWaETr+azAR2kjvSAgZhqgLVQtCMu5s+dQcgOfcOZPINkrtnySl4jXtDE
-SOTaj65VjSIkura17rj7nJNUPmDGFwsxwKpeEcXZTfa//ypT/hHVREkRmbSFk5Kw
-rf3T3O1pMVF8+SeacK/oyDUf3ISc8wn9Xmwgpv8I74xWtDy3kAs315tfWPMOHe4b
-CYk7GD1fu2rVRhtDCvkljiw2NejfeMzKt5+2wLXRmQKBgQD0KeCv8vdw6JBLH6PI
-72yE/GRkjAn4KfhmHK+1GZN6m49DV4XAYaA7T6u2Q3gn9gNsVsHC2FCsCHy63BpA
-I6ZJfdm2rcJkqgeKKRQpLBRedDMpQLY1WyXjugpV46KmA0ThtgtZeVKilJWvamHs
-t/TwSbf/humg0cIcamEnkKVawwKBgQC8QBS1pfMqlSodylbPG0VaJqgdF/yAthp6
-gunVqpgbTMqGLTCpKUfSgPMpzu8znaCNeZN0EK1p7qZ7VE1VHpVoyQHC9Eu8d6PF
-HAENaOUcUoCQNtXLoaN4waSjt7i6vYRldT/qrYB1YdpkkVKdj39w2N+uaxtZzDXu
-hHu0eixF7wKBgCR3TLN6mjImycYuh4uvFooWF/hcYfDKc+rsReHKXBhnu1HXdIZz
-DjdNgtvJ39w4BfLcUjwDiqjm65oM3W7O5Dr9rNJ3yRy3uECOOhCcIL6qpCl5HL2D
-S3ljg7+oK9aXjmYXhkJquEjH4EM+pDlykAaDPBPR1nrKWS9dQ/1gwRF5AoGAd+Uo
-S3jiIqDWLhsMpuNrjDtKnx0DyMYynwx5+YepUNnbsxFdCKAuCjfupxYQ6wLdmr1v
-2GA20l0Y0zuh9TCBYDeFU7Fb+zEHsSZg1TWVljBFiZQjHopYHzTVsx/0G5tQk33V
-s5XFVv13ps2XnJokRK8b5254AP067Cqczxlw0SkCgYEA0ito+l4TOa1/DnsbP1Q0
-kgeTb/9wPHpHVJ0Hz6vIXabaDlvvYwgRh151+9xzMmrs/0QCbI2+SHucAzu4RTjM
-MAiytSBQtXA+L9deNNU9QqPKsy6/Xq6SsKLRkL9kiUasiUE0v7c/T7L9D81nTFuS
-8htCfXw1/Tf8tLb+Rtvvwtw=
------END PRIVATE KEY-----
diff --git a/dockers/stunnel/keys/client-req.pem b/dockers/stunnel/keys/client-req.pem
deleted file mode 100644
index 62828e1950..0000000000
--- a/dockers/stunnel/keys/client-req.pem
+++ /dev/null
@@ -1,15 +0,0 @@
------BEGIN CERTIFICATE REQUEST-----
-MIICXzCCAUcCAQAwGjEYMBYGA1UEAwwPcmVkaXMtcHktY2xpZW50MIIBIjANBgkq
-hkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAs4vfOefa+lfz5Uc6URPKZ4WnDzCwJ45+
-v182ErajkA8gbU2GsaOW75PuuL8N+sxmaMX64NK65SzTjijlIU4QI2LvI7Cl0L1h
-VZI9BDlWuwwQ2rKMhjKrYELt8sfO0C1UXWODQPTOKN8WD/iZ4ba0A6dctrQ71ZRy
-bCw2XESDIXNwu8KhNpelQlstglnYjFYGgqAnzlpwuUgVAh7HTncKqaAb+h0zwhvy
-zVg74hcjgmwmUkV33B77NiBnZNFJnwu/wDyBcz5ZMFmllc1di/TbR1bbZfuC75Uf
-gsdyD/p4XQa2R2sV2VCMISPAYihUVO581Knc29JJisr+p4m1I1pLDQIDAQABoAAw
-DQYJKoZIhvcNAQELBQADggEBAD3H8McA7SmTrswSp0lw1C1UFmtazhKbFYY3/+Ld
-ntZimzTy4Y5Ai1UW/blgwVLZxWWzazfkfWPMsRXtWcttuW/pxFGkLlyzFm4OsUQA
-hpxtUNlmEwzcYZAin3qNnCA9bQfGL/z+zUcuMuf6HGplAUhtPhTUnvGZ2B7rJ+aC
-syyt+/T/JJdnnnY0o4s4OzQa9ow6P7mC6egefHgLrtFbbuB4L/L/NdVj5NBzkXso
-kmHLTUwkEtKOiG4gFLRDXsgXCy+sfEEqqWapeFhOQdagENYg+LXSN0jpxGWeR1J/
-vZHMSJT4GK4SgyNpZFu5To2lf7ucw6ywCFfg6jH2EWQeCjk=
------END CERTIFICATE REQUEST-----
diff --git a/dockers/stunnel/keys/server-cert.pem b/dockers/stunnel/keys/server-cert.pem
deleted file mode 100644
index c17bf9ca0f..0000000000
--- a/dockers/stunnel/keys/server-cert.pem
+++ /dev/null
@@ -1,17 +0,0 @@
------BEGIN CERTIFICATE-----
-MIICpjCCAY4CAQEwDQYJKoZIhvcNAQELBQAwFjEUMBIGA1UEAwwLcmVkaXMtcHkt
-Y2EwIBcNMjQwNTA5MDcyMDE5WhgPMzAyMzA5MTAwNzIwMTlaMBoxGDAWBgNVBAMM
-D3JlZGlzLXB5LXNlcnZlcjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB
-AOg14yTsgmakeSFuqtvy4fV1rcSgLiGdGKzOBsoytmCZzV++5Jljj7utSpJiYMYk
-HOTZtyqAVwmF/0yyZ25lbEHR/N3S3Jj/al4EG9u+K7O3eNZrTQkg4+ifwcT+V1Xo
-s6f+L6BRld4y78QVZwdEsTy4SIeSAwGygACymEWYZ6NZBgM2xgp8SInHYxHP3gXh
-02wioB79B62DExFVUKwUXjbUhPooyvGf9MMpUrmdFmQFfcosW/urCQF9YI6ZcPnr
-ybXJ6kiplmNKeVD4dEyQLYNp09alnT6q+pcJa+NwW6O0eyqEsHQxCJyo9ZA3IW5I
-SH+oftVxnZJIIPcsXABuH10CAwEAATANBgkqhkiG9w0BAQsFAAOCAQEAdWY0UeR4
-/9hpK3Mhl8VVz0zQwwEfnxCmI/TxpqNw+5lvpit/WvriIAEP9MToWHwYvG24zRrp
-zv/LDHNh8UtnX3GILGs0CY/oFDevAEU1tixbmFJPceuMwKsrMtkp/6NyWF4p62o2
-fiQK68l1HSGgaH7kJ6BKYgV4JQK3Fgk9J4KrejwmYXzCFKcEvNtKMG7i0WN+AmK2
-vnxxZ3xx4HPH3OJ5ss6T2gGlvjFnOS7Z0kHtbkzPzxaC9ZVqMySwPRggf84tUUdk
-vCwDHiJcbk5BMLug3yI9xTfSG3lMnwgZAWXMOqm/w6c1IIM8R/nKwNfwbG+4eUK0
-t2F8EBCShzAJGg==
------END CERTIFICATE-----
diff --git a/dockers/stunnel/keys/server-key.pem b/dockers/stunnel/keys/server-key.pem
deleted file mode 100644
index 8dd9a1e21a..0000000000
--- a/dockers/stunnel/keys/server-key.pem
+++ /dev/null
@@ -1,28 +0,0 @@
------BEGIN PRIVATE KEY-----
-MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQDoNeMk7IJmpHkh
-bqrb8uH1da3EoC4hnRiszgbKMrZgmc1fvuSZY4+7rUqSYmDGJBzk2bcqgFcJhf9M
-smduZWxB0fzd0tyY/2peBBvbviuzt3jWa00JIOPon8HE/ldV6LOn/i+gUZXeMu/E
-FWcHRLE8uEiHkgMBsoAAsphFmGejWQYDNsYKfEiJx2MRz94F4dNsIqAe/QetgxMR
-VVCsFF421IT6KMrxn/TDKVK5nRZkBX3KLFv7qwkBfWCOmXD568m1yepIqZZjSnlQ
-+HRMkC2DadPWpZ0+qvqXCWvjcFujtHsqhLB0MQicqPWQNyFuSEh/qH7VcZ2SSCD3
-LFwAbh9dAgMBAAECggEAI0llDgxeuIhP2/O8RRZAnhNW56VLvVHpGQFp6LoSGtXk
-bqNMi76kbemkhmAqwpFkTqaC/hNoporVQ+tsaktBSzNE0NSlLx7JJCZNsXPRokrE
-Mxk1KKj12TjFslDQJr7o5iNrS1p6gryM0OhLssAOiuKaKvfWOyDL8M8y8oh5X0ny
-1M6IAJMkbpwiWU2OHIH7irkS8fYyCeOz0JMovCwMPwYkovHD7uHKbV4qGKzdOKN1
-QD8qMWAF1lCv/57juuwpzulGY3sSyU7yRZMMxJQ7nbIRj5iuj6+e2m6JhVghIiYG
-IObIkGyubCr9QH315byiSS9ma1xzml3EqyM3XQkEhQKBgQDyxGY+60/dkUW9vAAm
-g20eVZnflhE8+ooEpX9VPIliL7ADy3HU2poV2oXif8pVauMvRaYla8BHIOPV2qGI
-tHTYNvubs6lxEq2Z7gM+8c5qOElXjup8Ch9/XCHXZavW8caWEcA9Z84Z4dCxbaku
-EhEL0SduCn7j1tU1+Z9jBs08ewKBgQD03i29kCUeCnW+zEo+aO2Spn6HpdyZkuzG
-2az5XurHGUFAgWYLOpShatjD4BY1GONvJTlD/gH2vqEkfY2OGgZ2pbjCFSfhIma/
-cnMuhsO2IlcuETqzlod1HGHcn6gGRM5LvYP343UIdv9nmJaT31nckueWv+yBd8HO
-kAx1W2boBwKBgBtM7tqgh8i474jYvYOXQAwrQDSeoa2j1yWSnvEs7541Eqw6ksCH
-HNDcVDYWfOCCNq44POj0ZxkYn8aK4aOH96Pg+waVe7aVjSREWeUYOEhFsCnCjqgI
-U2Z1K/EXI+32Hoj90gqVw92xQVDSrjXaHkSf7rk3QPHKVQvO2JfAShBFAoGAW5ic
-nZNE/ybEgrmicBQKAlh7bjxx95SJM50LYkDKK+3bhcihpkOkg3kXWrYBOJ11vga7
-lB55F5aZaq/4epZroog9Q4RsZX/b1XN3eIj6vq+70sSpI7KEOx+Bz+h9DtNAI/7h
-VaHlDmSNB3CBqxDaaXMeZDqouolUmvMxZdjp9pMCgYEA1Y7vhCvMZA62OJwFJ4X8
-9Xg7bPE3jZQ6Tj3FbVCMy+RQdlo8GzYeoNZDjhpSxjJe/1lyk//EBwVNs3E4rRNl
-+GcaEOo0X/J7SkPFqM6aFITypIIGeJpFyz/S99i/5tkfsNt9BQtiTS+x1Kj1iREV
-bXIoNJRac5m/LLZKtDtHv18=
------END PRIVATE KEY-----
diff --git a/dockers/stunnel/keys/server-req.pem b/dockers/stunnel/keys/server-req.pem
deleted file mode 100644
index 6d853693fb..0000000000
--- a/dockers/stunnel/keys/server-req.pem
+++ /dev/null
@@ -1,15 +0,0 @@
------BEGIN CERTIFICATE REQUEST-----
-MIICXzCCAUcCAQAwGjEYMBYGA1UEAwwPcmVkaXMtcHktc2VydmVyMIIBIjANBgkq
-hkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA6DXjJOyCZqR5IW6q2/Lh9XWtxKAuIZ0Y
-rM4GyjK2YJnNX77kmWOPu61KkmJgxiQc5Nm3KoBXCYX/TLJnbmVsQdH83dLcmP9q
-XgQb274rs7d41mtNCSDj6J/BxP5XVeizp/4voFGV3jLvxBVnB0SxPLhIh5IDAbKA
-ALKYRZhno1kGAzbGCnxIicdjEc/eBeHTbCKgHv0HrYMTEVVQrBReNtSE+ijK8Z/0
-wylSuZ0WZAV9yixb+6sJAX1gjplw+evJtcnqSKmWY0p5UPh0TJAtg2nT1qWdPqr6
-lwlr43Bbo7R7KoSwdDEInKj1kDchbkhIf6h+1XGdkkgg9yxcAG4fXQIDAQABoAAw
-DQYJKoZIhvcNAQELBQADggEBAGMLI6jfG95L1Kqny8+Fl9sVnJ4ynb5905Hk9vXJ
-V/BVc3P6JS6c4qYSeFd6wihHC7/j2EC3wt55Sj6JzYKy93AEjBfDfBb2ZuB6VpPy
-iGKXzSGO71ziI2uzz92ltJhptNc6TNUUxwaBhOZiq2sxnLpnIcPZ/txDC75fGYEm
-9iSbeeHNNZTSqQyQOzKW0OL6ss+GHhlfJPzx6mSH5dvb6bpKB2SCG1aZaDuOQTl3
-8aDIo1Z/ug6BrqoDMCyRAZTDnTohhC96bbKLRMdm0g3wwDeoWuQy1q9s1/AUYfBm
-305LUYORBdFy08n41lFWo1JA4errzBhVTpHNKZ6DyQfMOxA=
------END CERTIFICATE REQUEST-----
diff --git a/pytest.ini b/pytest.ini
index 990968d6f9..bbb8d420c4 100644
--- a/pytest.ini
+++ b/pytest.ini
@@ -2,6 +2,7 @@
 addopts = -s
 markers =
     redismod: run only the redis module tests
+    graph: run only the redisgraph tests
     pipeline: pipeline tests
     onlycluster: marks tests to be run only with cluster mode redis
     onlynoncluster: marks tests to be run only with standalone redis
diff --git a/tasks.py b/tasks.py
index 76737b8eff..f7b728aed4 100644
--- a/tasks.py
+++ b/tasks.py
@@ -10,10 +10,10 @@
 
 
 @task
-def devenv(c):
+def devenv(c, endpoints="all"):
     """Brings up the test environment, by wrapping docker compose."""
     clean(c)
-    cmd = "docker compose --profile all up -d --build"
+    cmd = f"docker compose --profile {endpoints} up -d --build"
     run(cmd)
 
 
@@ -50,16 +50,21 @@ def tests(c, uvloop=False, protocol=2, profile=False):
 
 
 @task
-def standalone_tests(c, uvloop=False, protocol=2, profile=False):
+def standalone_tests(
+    c, uvloop=False, protocol=2, profile=False, redis_mod_url=None, extra_markers=""
+):
     """Run tests against a standalone redis instance"""
     profile_arg = "--profile" if profile else ""
+    redis_mod_url = f"--redis-mod-url={redis_mod_url}" if redis_mod_url else ""
+    extra_markers = f" and {extra_markers}" if extra_markers else ""
+
     if uvloop:
         run(
-            f"pytest {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_redis.xml -m 'not onlycluster' --uvloop --junit-xml=standalone-uvloop-results.xml"
+            f"pytest {profile_arg} --protocol={protocol} {redis_mod_url} --cov=./ --cov-report=xml:coverage_resp{protocol}_uvloop.xml -m 'not onlycluster and not graph{extra_markers}' --uvloop --junit-xml=standalone-resp{protocol}-uvloop-results.xml"
         )
     else:
         run(
-            f"pytest {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_redis.xml -m 'not onlycluster' --junit-xml=standalone-results.xml"
+            f"pytest {profile_arg} --protocol={protocol} {redis_mod_url} --cov=./ --cov-report=xml:coverage_resp{protocol}.xml -m 'not onlycluster and not graph{extra_markers}' --junit-xml=standalone-resp{protocol}-results.xml"
         )
 
 
@@ -68,13 +73,14 @@ def cluster_tests(c, uvloop=False, protocol=2, profile=False):
     """Run tests against a redis cluster"""
     profile_arg = "--profile" if profile else ""
     cluster_url = "redis://localhost:16379/0"
+    cluster_tls_url = "rediss://localhost:27379/0"
     if uvloop:
         run(
-            f"pytest {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_cluster.xml -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --junit-xml=cluster-uvloop-results.xml --uvloop"
+            f"pytest {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_cluster_resp{protocol}_uvloop.xml -m 'not onlynoncluster and not redismod and not graph' --redis-url={cluster_url} --redis-ssl-url={cluster_tls_url} --junit-xml=cluster-resp{protocol}-uvloop-results.xml --uvloop"
         )
     else:
         run(
-            f"pytest  {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_clusteclient.xml -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --junit-xml=cluster-results.xml"
+            f"pytest  {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_cluster_resp{protocol}.xml -m 'not onlynoncluster and not redismod and not graph' --redis-url={cluster_url} --redis-ssl-url={cluster_tls_url} --junit-xml=cluster-resp{protocol}-results.xml"
         )
 
 
diff --git a/tests/conftest.py b/tests/conftest.py
index 0c98eee4d8..7c65898856 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -21,7 +21,7 @@
 from redis.connection import Connection, ConnectionInterface, SSLConnection, parse_url
 from redis.exceptions import RedisClusterException
 from redis.retry import Retry
-from tests.ssl_utils import get_ssl_filename
+from tests.ssl_utils import get_tls_certificates
 
 REDIS_INFO = {}
 default_redis_url = "redis://localhost:6379/0"
@@ -103,6 +103,13 @@ def pytest_addoption(parser):
         help="Redis connection string, defaults to `%(default)s`",
     )
 
+    parser.addoption(
+        "--redis-mod-url",
+        default=default_redismod_url,
+        action="store",
+        help="Redis with modules connection string, defaults to `%(default)s`",
+    )
+
     parser.addoption(
         "--protocol",
         default=default_protocol,
@@ -177,14 +184,14 @@ def pytest_sessionstart(session):
     REDIS_INFO["version"] = version
     REDIS_INFO["arch_bits"] = arch_bits
     REDIS_INFO["cluster_enabled"] = cluster_enabled
+    REDIS_INFO["tls_cert_subdir"] = "cluster" if cluster_enabled else "standalone"
     REDIS_INFO["enterprise"] = enterprise
     # store REDIS_INFO in config so that it is available from "condition strings"
     session.config.REDIS_INFO = REDIS_INFO
 
     # module info
-    stack_url = redis_url
-    if stack_url == default_redis_url:
-        stack_url = default_redismod_url
+    stack_url = session.config.getoption("--redis-mod-url")
+
     try:
         stack_info = _get_info(stack_url)
         REDIS_INFO["modules"] = stack_info["modules"]
@@ -325,6 +332,9 @@ def _get_client(
         redis_url = request.config.getoption("--redis-url")
     else:
         redis_url = from_url
+
+    redis_tls_url = request.config.getoption("--redis-ssl-url")
+
     if "protocol" not in redis_url and kwargs.get("protocol") is None:
         kwargs["protocol"] = request.config.getoption("--protocol")
 
@@ -335,15 +345,11 @@ def _get_client(
         connection_class = Connection
         if ssl:
             connection_class = SSLConnection
-            kwargs["ssl_certfile"] = get_ssl_filename("client-cert.pem")
-            kwargs["ssl_keyfile"] = get_ssl_filename("client-key.pem")
-            # When you try to assign "required" as single string
-            # it assigns tuple instead of string.
-            # Probably some reserved keyword
-            # I can't explain how does it work -_-
-            kwargs["ssl_cert_reqs"] = "require" + "d"
-            kwargs["ssl_ca_certs"] = get_ssl_filename("ca-cert.pem")
-            kwargs["port"] = 6666
+            kwargs["ssl_certfile"], kwargs["ssl_keyfile"], kwargs["ssl_ca_certs"] = (
+                get_tls_certificates()
+            )
+            kwargs["ssl_cert_reqs"] = "required"
+            kwargs["port"] = urlparse(redis_tls_url).port
         kwargs["connection_class"] = connection_class
         url_options.update(kwargs)
         pool = redis.ConnectionPool(**url_options)
@@ -393,11 +399,7 @@ def r(request):
 
 @pytest.fixture()
 def stack_url(request):
-    stack_url = request.config.getoption("--redis-url", default=default_redismod_url)
-    if stack_url == default_redis_url:
-        return default_redismod_url
-    else:
-        return stack_url
+    return request.config.getoption("--redis-mod-url", default=default_redismod_url)
 
 
 @pytest.fixture()
diff --git a/tests/ssl_utils.py b/tests/ssl_utils.py
index 1de53bbf66..612c0d5aca 100644
--- a/tests/ssl_utils.py
+++ b/tests/ssl_utils.py
@@ -1,14 +1,43 @@
+import enum
 import os
+from collections import namedtuple
 
+CLIENT_CERT_NAME = "client.crt"
+CLIENT_KEY_NAME = "client.key"
+SERVER_CERT_NAME = "redis.crt"
+SERVER_KEY_NAME = "redis.key"
+CA_CERT_NAME = "ca.crt"
 
-def get_ssl_filename(name):
+
+class CertificateType(str, enum.Enum):
+    client = "client"
+    server = "server"
+
+
+TLSFiles = namedtuple("TLSFiles", ["certfile", "keyfile", "ca_certfile"])
+
+
+def get_tls_certificates(
+    subdir: str = "standalone",
+    cert_type: CertificateType = CertificateType.client,
+):
     root = os.path.join(os.path.dirname(__file__), "..")
-    cert_dir = os.path.abspath(os.path.join(root, "dockers", "stunnel", "keys"))
+    cert_subdir = ("dockers", subdir, "tls")
+    cert_dir = os.path.abspath(os.path.join(root, *cert_subdir))
     if not os.path.isdir(cert_dir):  # github actions package validation case
-        cert_dir = os.path.abspath(
-            os.path.join(root, "..", "dockers", "stunnel", "keys")
-        )
+        cert_dir = os.path.abspath(os.path.join(root, "..", *cert_subdir))
         if not os.path.isdir(cert_dir):
             raise OSError(f"No SSL certificates found. They should be in {cert_dir}")
 
-    return os.path.join(cert_dir, name)
+    if cert_type == CertificateType.client:
+        return TLSFiles(
+            os.path.join(cert_dir, CLIENT_CERT_NAME),
+            os.path.join(cert_dir, CLIENT_KEY_NAME),
+            os.path.join(cert_dir, CA_CERT_NAME),
+        )
+    elif cert_type == CertificateType.server:
+        return TLSFiles(
+            os.path.join(cert_dir, SERVER_CERT_NAME),
+            os.path.join(cert_dir, SERVER_KEY_NAME),
+            os.path.join(cert_dir, CA_CERT_NAME),
+        )
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index f3b76b80c9..477397dd5f 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -33,12 +33,11 @@
     assert_resp_response,
     is_resp2_connection,
     skip_if_redis_enterprise,
-    skip_if_server_version_gte,
     skip_if_server_version_lt,
     skip_unless_arch_bits,
 )
 
-from ..ssl_utils import get_ssl_filename
+from ..ssl_utils import get_tls_certificates
 from .compat import aclosing, mock
 
 pytestmark = pytest.mark.onlycluster
@@ -380,20 +379,22 @@ async def test_cluster_retry_object(self, request: FixtureRequest) -> None:
         async with RedisCluster.from_url(url) as rc_default:
             # Test default retry
             retry = rc_default.connection_kwargs.get("retry")
+
+            # FIXME: Workaround for https://github.com/redis/redis-py/issues/3030
+            host = rc_default.get_default_node().host
+
             assert isinstance(retry, Retry)
             assert retry._retries == 3
             assert isinstance(retry._backoff, type(default_backoff()))
-            assert rc_default.get_node("127.0.0.1", 16379).connection_kwargs.get(
+            assert rc_default.get_node(host, 16379).connection_kwargs.get(
                 "retry"
-            ) == rc_default.get_node("127.0.0.1", 16380).connection_kwargs.get("retry")
+            ) == rc_default.get_node(host, 16380).connection_kwargs.get("retry")
 
         retry = Retry(ExponentialBackoff(10, 5), 5)
         async with RedisCluster.from_url(url, retry=retry) as rc_custom_retry:
             # Test custom retry
             assert (
-                rc_custom_retry.get_node("127.0.0.1", 16379).connection_kwargs.get(
-                    "retry"
-                )
+                rc_custom_retry.get_node(host, 16379).connection_kwargs.get("retry")
                 == retry
             )
 
@@ -402,9 +403,7 @@ async def test_cluster_retry_object(self, request: FixtureRequest) -> None:
         ) as rc_no_retries:
             # Test no connection retries
             assert (
-                rc_no_retries.get_node("127.0.0.1", 16379).connection_kwargs.get(
-                    "retry"
-                )
+                rc_no_retries.get_node(host, 16379).connection_kwargs.get("retry")
                 is None
             )
 
@@ -412,7 +411,7 @@ async def test_cluster_retry_object(self, request: FixtureRequest) -> None:
             url, retry=Retry(NoBackoff(), 0)
         ) as rc_no_retries:
             assert (
-                rc_no_retries.get_node("127.0.0.1", 16379)
+                rc_no_retries.get_node(host, 16379)
                 .connection_kwargs.get("retry")
                 ._retries
                 == 0
@@ -493,8 +492,8 @@ async def test_execute_command_node_flag_replicas(self, r: RedisCluster) -> None
         Test command execution with nodes flag REPLICAS
         """
         replicas = r.get_replicas()
-        if not replicas:
-            r = await get_mocked_redis_client(default_host, default_port)
+        assert len(replicas) != 0, "This test requires Cluster with 1 replica"
+
         primaries = r.get_primaries()
         mock_all_nodes_resp(r, "PONG")
         assert await r.ping(target_nodes=RedisCluster.REPLICAS) is True
@@ -2804,7 +2803,6 @@ async def test_asking_error(self, r: RedisCluster) -> None:
             assert ask_node._free.pop().read_response.await_count
             assert res == ["MOCK_OK"]
 
-    @skip_if_server_version_gte("7.0.0")
     async def test_moved_redirection_on_slave_with_default(
         self, r: RedisCluster
     ) -> None:
@@ -2824,11 +2822,7 @@ async def test_moved_redirection_on_slave_with_default(
             async def parse_response(
                 self, connection: Connection, command: str, **kwargs: Any
             ) -> Any:
-                if (
-                    command == "GET"
-                    and self.host != primary.host
-                    and self.port != primary.port
-                ):
+                if command == "GET" and self.port != primary.port:
                     raise MovedError(moved_error)
 
                 return await parse_response_orig(connection, command, **kwargs)
@@ -2899,9 +2893,7 @@ class TestSSL:
     appropriate port.
     """
 
-    CA_CERT = get_ssl_filename("ca-cert.pem")
-    CLIENT_CERT = get_ssl_filename("client-cert.pem")
-    CLIENT_KEY = get_ssl_filename("client-key.pem")
+    CLIENT_CERT, CLIENT_KEY, CA_CERT = get_tls_certificates("cluster")
 
     @pytest_asyncio.fixture()
     def create_client(self, request: FixtureRequest) -> Callable[..., RedisCluster]:
diff --git a/tests/test_asyncio/test_connect.py b/tests/test_asyncio/test_connect.py
index 943540c885..6c4b3c33d7 100644
--- a/tests/test_asyncio/test_connect.py
+++ b/tests/test_asyncio/test_connect.py
@@ -11,7 +11,7 @@
 )
 from redis.exceptions import ConnectionError
 
-from ..ssl_utils import get_ssl_filename
+from ..ssl_utils import CertificateType, get_tls_certificates
 
 _CLIENT_NAME = "test-suite-client"
 _CMD_SEP = b"\r\n"
@@ -57,19 +57,21 @@ async def test_uds_connect(uds_address):
 )
 async def test_tcp_ssl_tls12_custom_ciphers(tcp_address, ssl_ciphers):
     host, port = tcp_address
-    certfile = get_ssl_filename("client-cert.pem")
-    keyfile = get_ssl_filename("client-key.pem")
-    ca_certfile = get_ssl_filename("ca-cert.pem")
+
+    server_certs = get_tls_certificates(cert_type=CertificateType.server)
+
     conn = SSLConnection(
         host=host,
         port=port,
         client_name=_CLIENT_NAME,
-        ssl_ca_certs=ca_certfile,
+        ssl_ca_certs=server_certs.ca_certfile,
         socket_timeout=10,
         ssl_min_version=ssl.TLSVersion.TLSv1_2,
         ssl_ciphers=ssl_ciphers,
     )
-    await _assert_connect(conn, tcp_address, certfile=certfile, keyfile=keyfile)
+    await _assert_connect(
+        conn, tcp_address, certfile=server_certs.certfile, keyfile=server_certs.keyfile
+    )
     await conn.disconnect()
 
 
@@ -86,18 +88,20 @@ async def test_tcp_ssl_tls12_custom_ciphers(tcp_address, ssl_ciphers):
 )
 async def test_tcp_ssl_connect(tcp_address, ssl_min_version):
     host, port = tcp_address
-    certfile = get_ssl_filename("client-cert.pem")
-    keyfile = get_ssl_filename("client-key.pem")
-    ca_certfile = get_ssl_filename("ca-cert.pem")
+
+    server_certs = get_tls_certificates(cert_type=CertificateType.server)
+
     conn = SSLConnection(
         host=host,
         port=port,
         client_name=_CLIENT_NAME,
-        ssl_ca_certs=ca_certfile,
+        ssl_ca_certs=server_certs.ca_certfile,
         socket_timeout=10,
         ssl_min_version=ssl_min_version,
     )
-    await _assert_connect(conn, tcp_address, certfile=certfile, keyfile=keyfile)
+    await _assert_connect(
+        conn, tcp_address, certfile=server_certs.certfile, keyfile=server_certs.keyfile
+    )
     await conn.disconnect()
 
 
@@ -105,8 +109,7 @@ async def test_tcp_ssl_connect(tcp_address, ssl_min_version):
 @pytest.mark.skipif(not ssl.HAS_TLSv1_3, reason="requires TLSv1.3")
 async def test_tcp_ssl_version_mismatch(tcp_address):
     host, port = tcp_address
-    certfile = get_ssl_filename("server-cert.pem")
-    keyfile = get_ssl_filename("server-key.pem")
+    certfile, keyfile, _ = get_tls_certificates(cert_type=CertificateType.server)
     conn = SSLConnection(
         host=host,
         port=port,
diff --git a/tests/test_asyncio/test_cwe_404.py b/tests/test_asyncio/test_cwe_404.py
index e920a3fb98..677e165fc6 100644
--- a/tests/test_asyncio/test_cwe_404.py
+++ b/tests/test_asyncio/test_cwe_404.py
@@ -208,7 +208,7 @@ def remap(address):
         port = cluster_port + i
         remapped = remap_base + i
         forward_addr = hostname, port
-        proxy = DelayProxy(addr=("127.0.0.1", remapped), redis_addr=forward_addr)
+        proxy = DelayProxy(addr=(hostname, remapped), redis_addr=forward_addr)
         proxies.append(proxy)
 
     def all_clear():
@@ -233,7 +233,7 @@ def set_delay(delay: float):
             await stack.enter_async_context(p)
 
         r = RedisCluster.from_url(
-            f"redis://127.0.0.1:{remap_base}", address_remap=remap
+            f"redis://{hostname}:{remap_base}", address_remap=remap
         )
         try:
             await r.initialize()
diff --git a/tests/test_asyncio/test_graph.py b/tests/test_asyncio/test_graph.py
index 2014ea38b6..2a506d5e22 100644
--- a/tests/test_asyncio/test_graph.py
+++ b/tests/test_asyncio/test_graph.py
@@ -12,7 +12,7 @@ async def decoded_r(create_redis, stack_url):
     return await create_redis(decode_responses=True, url="redis://localhost:6480")
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 async def test_bulk(decoded_r):
     with pytest.raises(NotImplementedError):
@@ -20,7 +20,7 @@ async def test_bulk(decoded_r):
         await decoded_r.graph().bulk(foo="bar!")
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 async def test_graph_creation(decoded_r: redis.Redis):
     graph = decoded_r.graph()
@@ -66,7 +66,7 @@ async def test_graph_creation(decoded_r: redis.Redis):
     await graph.delete()
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 async def test_array_functions(decoded_r: redis.Redis):
     graph = decoded_r.graph()
@@ -90,7 +90,7 @@ async def test_array_functions(decoded_r: redis.Redis):
     assert [a] == result.result_set[0][0]
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 async def test_path(decoded_r: redis.Redis):
     node0 = Node(node_id=0, label="L1")
@@ -111,7 +111,7 @@ async def test_path(decoded_r: redis.Redis):
     assert expected_results == result.result_set
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 async def test_param(decoded_r: redis.Redis):
     params = [1, 2.3, "str", True, False, None, [0, 1, 2]]
@@ -122,7 +122,7 @@ async def test_param(decoded_r: redis.Redis):
         assert expected_results == result.result_set
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 async def test_map(decoded_r: redis.Redis):
     query = "RETURN {a:1, b:'str', c:NULL, d:[1,2,3], e:True, f:{x:1, y:2}}"
@@ -140,7 +140,7 @@ async def test_map(decoded_r: redis.Redis):
     assert actual == expected
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 async def test_point(decoded_r: redis.Redis):
     query = "RETURN point({latitude: 32.070794860, longitude: 34.820751118})"
@@ -158,7 +158,7 @@ async def test_point(decoded_r: redis.Redis):
     assert abs(actual["longitude"] - expected_lon) < 0.001
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 async def test_index_response(decoded_r: redis.Redis):
     result_set = await decoded_r.graph().query("CREATE INDEX ON :person(age)")
@@ -174,7 +174,7 @@ async def test_index_response(decoded_r: redis.Redis):
         await decoded_r.graph().query("DROP INDEX ON :person(age)")
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 async def test_stringify_query_result(decoded_r: redis.Redis):
     graph = decoded_r.graph()
@@ -229,7 +229,7 @@ async def test_stringify_query_result(decoded_r: redis.Redis):
     await graph.delete()
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 async def test_optional_match(decoded_r: redis.Redis):
     # Build a graph of form (a)-[R]->(b)
@@ -255,7 +255,7 @@ async def test_optional_match(decoded_r: redis.Redis):
     await graph.delete()
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 async def test_cached_execution(decoded_r: redis.Redis):
     await decoded_r.graph().query("CREATE ()")
@@ -276,7 +276,7 @@ async def test_cached_execution(decoded_r: redis.Redis):
     assert cached_result.cached_execution
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 async def test_slowlog(decoded_r: redis.Redis):
     create_query = """CREATE
@@ -291,7 +291,7 @@ async def test_slowlog(decoded_r: redis.Redis):
 
 
 @pytest.mark.xfail(strict=False)
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 async def test_query_timeout(decoded_r: redis.Redis):
     # Build a sample graph with 1000 nodes.
@@ -306,7 +306,7 @@ async def test_query_timeout(decoded_r: redis.Redis):
         assert False is False
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 async def test_read_only_query(decoded_r: redis.Redis):
     with pytest.raises(Exception):
@@ -316,7 +316,7 @@ async def test_read_only_query(decoded_r: redis.Redis):
         assert False is False
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 async def test_profile(decoded_r: redis.Redis):
     q = """UNWIND range(1, 3) AS x CREATE (p:Person {v:x})"""
@@ -333,7 +333,7 @@ async def test_profile(decoded_r: redis.Redis):
 
 
 @skip_if_redis_enterprise()
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 async def test_config(decoded_r: redis.Redis):
     config_name = "RESULTSET_SIZE"
@@ -366,7 +366,7 @@ async def test_config(decoded_r: redis.Redis):
 
 
 @pytest.mark.onlynoncluster
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 async def test_list_keys(decoded_r: redis.Redis):
     result = await decoded_r.graph().list_keys()
@@ -390,7 +390,7 @@ async def test_list_keys(decoded_r: redis.Redis):
     assert result == []
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 async def test_multi_label(decoded_r: redis.Redis):
     redis_graph = decoded_r.graph("g")
@@ -417,7 +417,7 @@ async def test_multi_label(decoded_r: redis.Redis):
         assert True
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 async def test_execution_plan(decoded_r: redis.Redis):
     redis_graph = decoded_r.graph("execution_plan")
@@ -437,7 +437,7 @@ async def test_execution_plan(decoded_r: redis.Redis):
     await redis_graph.delete()
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 async def test_explain(decoded_r: redis.Redis):
     redis_graph = decoded_r.graph("execution_plan")
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index fb813b0bc7..5260605039 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -1025,6 +1025,8 @@ async def test_phonetic_matcher(decoded_r: redis.Redis):
 
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
+# NOTE(imalinovskyi): This test contains hardcoded scores valid only for RediSearch 2.8+
+@skip_ifmodversion_lt("2.8.0", "search")
 async def test_scorer(decoded_r: redis.Redis):
     await decoded_r.ft().create_index((TextField("description"),))
 
diff --git a/tests/test_asyncio/test_timeseries.py b/tests/test_asyncio/test_timeseries.py
index 5a1597f2d0..b21f7d0ac8 100644
--- a/tests/test_asyncio/test_timeseries.py
+++ b/tests/test_asyncio/test_timeseries.py
@@ -765,6 +765,7 @@ async def test_uncompressed(decoded_r: redis.Redis):
         assert compressed_info["memoryUsage"] != uncompressed_info["memoryUsage"]
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.12.0", "timeseries")
 async def test_create_with_insertion_filters(decoded_r: redis.Redis):
     await decoded_r.ts().create(
@@ -788,6 +789,7 @@ async def test_create_with_insertion_filters(decoded_r: redis.Redis):
     )
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.12.0", "timeseries")
 async def test_alter_with_insertion_filters(decoded_r: redis.Redis):
     assert 1000 == await decoded_r.ts().add("time-series-1", 1000, 1.0)
@@ -812,6 +814,7 @@ async def test_alter_with_insertion_filters(decoded_r: redis.Redis):
     )
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.12.0", "timeseries")
 async def test_add_with_insertion_filters(decoded_r: redis.Redis):
     assert 1000 == await decoded_r.ts().add(
@@ -829,6 +832,7 @@ async def test_add_with_insertion_filters(decoded_r: redis.Redis):
     assert_resp_response(decoded_r, data_points, [(1000, 1.0)], [[1000, 1.0]])
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.12.0", "timeseries")
 async def test_incrby_with_insertion_filters(decoded_r: redis.Redis):
     assert 1000 == await decoded_r.ts().incrby(
@@ -851,6 +855,7 @@ async def test_incrby_with_insertion_filters(decoded_r: redis.Redis):
     assert_resp_response(decoded_r, data_points, [(1000, 11.1)], [[1000, 11.1]])
 
 
+@pytest.mark.redismod
 @skip_ifmodversion_lt("1.12.0", "timeseries")
 async def test_decrby_with_insertion_filters(decoded_r: redis.Redis):
     assert 1000 == await decoded_r.ts().decrby(
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index fe5852d1fb..1b9b9969c5 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -862,21 +862,22 @@ def test_cluster_get_set_retry_object(self, request):
 
     def test_cluster_retry_object(self, r) -> None:
         # Test default retry
+        # FIXME: Workaround for https://github.com/redis/redis-py/issues/3030
+        host = r.get_default_node().host
+
         retry = r.get_connection_kwargs().get("retry")
         assert isinstance(retry, Retry)
         assert retry._retries == 0
         assert isinstance(retry._backoff, type(default_backoff()))
-        node1 = r.get_node("127.0.0.1", 16379).redis_connection
-        node2 = r.get_node("127.0.0.1", 16380).redis_connection
+        node1 = r.get_node(host, 16379).redis_connection
+        node2 = r.get_node(host, 16380).redis_connection
         assert node1.get_retry()._retries == node2.get_retry()._retries
 
         # Test custom retry
         retry = Retry(ExponentialBackoff(10, 5), 5)
-        rc_custom_retry = RedisCluster("127.0.0.1", 16379, retry=retry)
+        rc_custom_retry = RedisCluster(host, 16379, retry=retry)
         assert (
-            rc_custom_retry.get_node("127.0.0.1", 16379)
-            .redis_connection.get_retry()
-            ._retries
+            rc_custom_retry.get_node(host, 16379).redis_connection.get_retry()._retries
             == retry._retries
         )
 
diff --git a/tests/test_connect.py b/tests/test_connect.py
index b11c4446e5..f3c02b330f 100644
--- a/tests/test_connect.py
+++ b/tests/test_connect.py
@@ -8,7 +8,7 @@
 from redis.connection import Connection, SSLConnection, UnixDomainSocketConnection
 from redis.exceptions import RedisError
 
-from .ssl_utils import get_ssl_filename
+from .ssl_utils import CertificateType, get_tls_certificates
 
 _CLIENT_NAME = "test-suite-client"
 _CMD_SEP = b"\r\n"
@@ -54,18 +54,18 @@ def test_uds_connect(uds_address):
 )
 def test_tcp_ssl_connect(tcp_address, ssl_min_version):
     host, port = tcp_address
-    certfile = get_ssl_filename("client-cert.pem")
-    keyfile = get_ssl_filename("client-key.pem")
-    ca_certfile = get_ssl_filename("ca-cert.pem")
+    server_certs = get_tls_certificates(cert_type=CertificateType.server)
     conn = SSLConnection(
         host=host,
         port=port,
         client_name=_CLIENT_NAME,
-        ssl_ca_certs=ca_certfile,
+        ssl_ca_certs=server_certs.ca_certfile,
         socket_timeout=10,
         ssl_min_version=ssl_min_version,
     )
-    _assert_connect(conn, tcp_address, certfile=certfile, keyfile=keyfile)
+    _assert_connect(
+        conn, tcp_address, certfile=server_certs.certfile, keyfile=server_certs.keyfile
+    )
 
 
 @pytest.mark.ssl
@@ -79,19 +79,21 @@ def test_tcp_ssl_connect(tcp_address, ssl_min_version):
 )
 def test_tcp_ssl_tls12_custom_ciphers(tcp_address, ssl_ciphers):
     host, port = tcp_address
-    certfile = get_ssl_filename("client-cert.pem")
-    keyfile = get_ssl_filename("client-key.pem")
-    ca_certfile = get_ssl_filename("ca-cert.pem")
+
+    server_certs = get_tls_certificates(cert_type=CertificateType.server)
+
     conn = SSLConnection(
         host=host,
         port=port,
         client_name=_CLIENT_NAME,
-        ssl_ca_certs=ca_certfile,
+        ssl_ca_certs=server_certs.ca_certfile,
         socket_timeout=10,
         ssl_min_version=ssl.TLSVersion.TLSv1_2,
         ssl_ciphers=ssl_ciphers,
     )
-    _assert_connect(conn, tcp_address, certfile=certfile, keyfile=keyfile)
+    _assert_connect(
+        conn, tcp_address, certfile=server_certs.certfile, keyfile=server_certs.keyfile
+    )
 
 
 """
@@ -115,8 +117,7 @@ def test_unix_socket_with_timeout():
 @pytest.mark.skipif(not ssl.HAS_TLSv1_3, reason="requires TLSv1.3")
 def test_tcp_ssl_version_mismatch(tcp_address):
     host, port = tcp_address
-    certfile = get_ssl_filename("server-cert.pem")
-    keyfile = get_ssl_filename("server-key.pem")
+    certfile, keyfile, _ = get_tls_certificates(cert_type=CertificateType.server)
     conn = SSLConnection(
         host=host,
         port=port,
diff --git a/tests/test_graph.py b/tests/test_graph.py
index c82c5030c8..efb10dada7 100644
--- a/tests/test_graph.py
+++ b/tests/test_graph.py
@@ -32,7 +32,7 @@ def client(request, stack_url):
     return r
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 def test_bulk(client):
     with pytest.raises(NotImplementedError):
@@ -40,7 +40,7 @@ def test_bulk(client):
         client.graph().bulk(foo="bar!")
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 def test_graph_creation_throws_deprecation_warning(client):
     """Verify that a DeprecationWarning is raised when creating a Graph instance."""
 
@@ -49,7 +49,7 @@ def test_graph_creation_throws_deprecation_warning(client):
         client.graph()
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 def test_graph_creation(client):
     graph = client.graph()
@@ -95,7 +95,7 @@ def test_graph_creation(client):
     graph.delete()
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 def test_array_functions(client):
     query = """CREATE (p:person{name:'a',age:32, array:[0,1,2]})"""
@@ -117,7 +117,7 @@ def test_array_functions(client):
     assert [a] == result.result_set[0][0]
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 def test_path(client):
     node0 = Node(node_id=0, label="L1")
@@ -138,7 +138,7 @@ def test_path(client):
     assert expected_results == result.result_set
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 def test_param(client):
     params = [1, 2.3, "str", True, False, None, [0, 1, 2], r"\" RETURN 1337 //"]
@@ -149,7 +149,7 @@ def test_param(client):
         assert expected_results == result.result_set
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 def test_map(client):
     query = "RETURN {a:1, b:'str', c:NULL, d:[1,2,3], e:True, f:{x:1, y:2}}"
@@ -167,7 +167,7 @@ def test_map(client):
     assert actual == expected
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 def test_point(client):
     query = "RETURN point({latitude: 32.070794860, longitude: 34.820751118})"
@@ -185,7 +185,7 @@ def test_point(client):
     assert abs(actual["longitude"] - expected_lon) < 0.001
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 def test_index_response(client):
     result_set = client.graph().query("CREATE INDEX ON :person(age)")
@@ -201,7 +201,7 @@ def test_index_response(client):
         client.graph().query("DROP INDEX ON :person(age)")
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 def test_stringify_query_result(client):
     graph = client.graph()
@@ -256,7 +256,7 @@ def test_stringify_query_result(client):
     graph.delete()
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 def test_optional_match(client):
     # Build a graph of form (a)-[R]->(b)
@@ -282,7 +282,7 @@ def test_optional_match(client):
     graph.delete()
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 def test_cached_execution(client):
     client.graph().query("CREATE ()")
@@ -301,7 +301,7 @@ def test_cached_execution(client):
     assert cached_result.cached_execution
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 def test_slowlog(client):
     create_query = """CREATE (:Rider
@@ -315,7 +315,7 @@ def test_slowlog(client):
     assert results[0][2] == create_query
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 @pytest.mark.xfail(strict=False)
 def test_query_timeout(client):
@@ -331,7 +331,7 @@ def test_query_timeout(client):
         assert False is False
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 def test_read_only_query(client):
     with pytest.raises(Exception):
@@ -341,7 +341,7 @@ def test_read_only_query(client):
         assert False is False
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 def test_profile(client):
     q = """UNWIND range(1, 3) AS x CREATE (p:Person {v:x})"""
@@ -357,7 +357,7 @@ def test_profile(client):
     assert "Node By Label Scan | (p:Person) | Records produced: 3" in profile
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 @skip_if_redis_enterprise()
 def test_config(client):
@@ -391,7 +391,7 @@ def test_config(client):
 
 
 @pytest.mark.onlynoncluster
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 def test_list_keys(client):
     result = client.graph().list_keys()
@@ -415,7 +415,7 @@ def test_list_keys(client):
     assert result == []
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 def test_multi_label(client):
     redis_graph = client.graph("g")
@@ -442,7 +442,7 @@ def test_multi_label(client):
         assert True
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 def test_cache_sync(client):
     pass
@@ -516,7 +516,7 @@ def test_cache_sync(client):
     assert A._relationship_types[1] == "R"
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 def test_execution_plan(client):
     redis_graph = client.graph("execution_plan")
@@ -536,7 +536,7 @@ def test_execution_plan(client):
     redis_graph.delete()
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 def test_explain(client):
     redis_graph = client.graph("execution_plan")
@@ -626,7 +626,7 @@ def test_explain(client):
     redis_graph.delete()
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 @skip_if_resp_version(3)
 def test_resultset_statistics(client):
     with patch.object(target=QueryResult, attribute="_get_stat") as mock_get_stats:
diff --git a/tests/test_graph_utils/test_edge.py b/tests/test_graph_utils/test_edge.py
index 1918a6ff44..09e6fa08ed 100644
--- a/tests/test_graph_utils/test_edge.py
+++ b/tests/test_graph_utils/test_edge.py
@@ -2,7 +2,7 @@
 from redis.commands.graph import edge, node
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 def test_init():
     with pytest.raises(AssertionError):
         edge.Edge(None, None, None)
@@ -14,7 +14,7 @@ def test_init():
     )
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 def test_to_string():
     props_result = edge.Edge(
         node.Node(), None, node.Node(), properties={"a": "a", "b": 10}
@@ -27,7 +27,7 @@ def test_to_string():
     assert no_props_result == ""
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 def test_stringify():
     john = node.Node(
         alias="a",
@@ -60,7 +60,7 @@ def test_stringify():
     )
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 def test_comparison():
     node1 = node.Node(node_id=1)
     node2 = node.Node(node_id=2)
diff --git a/tests/test_graph_utils/test_node.py b/tests/test_graph_utils/test_node.py
index 22e6d59414..e9b8a54f43 100644
--- a/tests/test_graph_utils/test_node.py
+++ b/tests/test_graph_utils/test_node.py
@@ -12,7 +12,7 @@ def fixture():
     return no_args, no_props, props_only, no_label, multi_label
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 def test_to_string(fixture):
     no_args, no_props, props_only, no_label, multi_label = fixture
     assert no_args.to_string() == ""
@@ -22,7 +22,7 @@ def test_to_string(fixture):
     assert multi_label.to_string() == ""
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 def test_stringify(fixture):
     no_args, no_props, props_only, no_label, multi_label = fixture
     assert str(no_args) == "()"
@@ -32,7 +32,7 @@ def test_stringify(fixture):
     assert str(multi_label) == "(alias:l:ll)"
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 def test_comparison(fixture):
     no_args, no_props, props_only, no_label, multi_label = fixture
 
diff --git a/tests/test_graph_utils/test_path.py b/tests/test_graph_utils/test_path.py
index 1bd38efab4..33ca041cfa 100644
--- a/tests/test_graph_utils/test_path.py
+++ b/tests/test_graph_utils/test_path.py
@@ -2,7 +2,7 @@
 from redis.commands.graph import edge, node, path
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 def test_init():
     with pytest.raises(TypeError):
         path.Path(None, None)
@@ -12,7 +12,7 @@ def test_init():
     assert isinstance(path.Path([], []), path.Path)
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 def test_new_empty_path():
     new_empty_path = path.Path.new_empty_path()
     assert isinstance(new_empty_path, path.Path)
@@ -20,7 +20,7 @@ def test_new_empty_path():
     assert new_empty_path._edges == []
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 def test_wrong_flows():
     node_1 = node.Node(node_id=1)
     node_2 = node.Node(node_id=2)
@@ -42,7 +42,7 @@ def test_wrong_flows():
         p.add_edge(edge_2)
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 def test_nodes_and_edges():
     node_1 = node.Node(node_id=1)
     node_2 = node.Node(node_id=2)
@@ -69,7 +69,7 @@ def test_nodes_and_edges():
     assert 2 == p.nodes_count()
 
 
-@pytest.mark.redismod
+@pytest.mark.graph
 def test_compare():
     node_1 = node.Node(node_id=1)
     node_2 = node.Node(node_id=2)
diff --git a/tests/test_search.py b/tests/test_search.py
index 0f0e7bb309..c6e9a3717f 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -30,6 +30,7 @@
     is_resp2_connection,
     skip_if_redis_enterprise,
     skip_if_resp_version,
+    skip_if_server_version_lt,
     skip_ifmodversion_lt,
 )
 
@@ -932,6 +933,8 @@ def test_phonetic_matcher(client):
 
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
+# NOTE(imalinovskyi): This test contains hardcoded scores valid only for RediSearch 2.8+
+@skip_ifmodversion_lt("2.8.0", "search")
 def test_scorer(client):
     client.ft().create_index((TextField("description"),))
 
@@ -2239,6 +2242,8 @@ def test_geo_params(client):
 
 
 @pytest.mark.redismod
+@skip_if_server_version_lt("7.4.0")
+@skip_ifmodversion_lt("2.10.0", "search")
 def test_geoshapes_query_intersects_and_disjoint(client):
     client.ft().create_index((GeoShapeField("g", coord_system=GeoShapeField.FLAT)))
     client.hset("doc_point1", mapping={"g": "POINT (10 10)"})
@@ -2442,6 +2447,8 @@ def test_query_timeout(r: redis.Redis):
 
 
 @pytest.mark.redismod
+@skip_if_server_version_lt("7.2.0")
+@skip_ifmodversion_lt("2.8.4", "search")
 def test_geoshape(client: redis.Redis):
     client.ft().create_index(GeoShapeField("geom", GeoShapeField.FLAT))
     waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
@@ -2458,6 +2465,8 @@ def test_geoshape(client: redis.Redis):
 
 
 @pytest.mark.redismod
+@skip_if_server_version_lt("7.4.0")
+@skip_ifmodversion_lt("2.10.0", "search")
 def test_search_missing_fields(client):
     definition = IndexDefinition(prefix=["property:"], index_type=IndexType.HASH)
 
@@ -2525,6 +2534,8 @@ def test_search_missing_fields(client):
 
 
 @pytest.mark.redismod
+@skip_if_server_version_lt("7.4.0")
+@skip_ifmodversion_lt("2.10.0", "search")
 def test_search_empty_fields(client):
     definition = IndexDefinition(prefix=["property:"], index_type=IndexType.HASH)
 
@@ -2596,6 +2607,8 @@ def test_search_empty_fields(client):
 
 
 @pytest.mark.redismod
+@skip_if_server_version_lt("7.4.0")
+@skip_ifmodversion_lt("2.10.0", "search")
 def test_special_characters_in_fields(client):
     definition = IndexDefinition(prefix=["resource:"], index_type=IndexType.HASH)
 
diff --git a/tests/test_ssl.py b/tests/test_ssl.py
index fc7416dbc7..2a945ac287 100644
--- a/tests/test_ssl.py
+++ b/tests/test_ssl.py
@@ -7,7 +7,7 @@
 from redis.exceptions import ConnectionError, RedisError
 
 from .conftest import skip_if_cryptography, skip_if_nocryptography
-from .ssl_utils import get_ssl_filename
+from .ssl_utils import CertificateType, get_tls_certificates
 
 
 @pytest.mark.ssl
@@ -18,10 +18,13 @@ class TestSSL:
     and connecting to the appropriate port.
     """
 
-    CA_CERT = get_ssl_filename("ca-cert.pem")
-    CLIENT_CERT = get_ssl_filename("client-cert.pem")
-    CLIENT_KEY = get_ssl_filename("client-key.pem")
-    SERVER_CERT = get_ssl_filename("server-cert.pem")
+    @pytest.fixture(autouse=True)
+    def _set_ssl_certs(self, request):
+        tls_cert_subdir = request.session.config.REDIS_INFO["tls_cert_subdir"]
+        self.client_certs = get_tls_certificates(tls_cert_subdir)
+        self.server_certs = get_tls_certificates(
+            tls_cert_subdir, cert_type=CertificateType.server
+        )
 
     def test_ssl_with_invalid_cert(self, request):
         ssl_url = request.config.option.redis_ssl_url
@@ -55,16 +58,16 @@ def test_validating_self_signed_certificate(self, request):
             host=p[0],
             port=p[1],
             ssl=True,
-            ssl_certfile=self.CLIENT_CERT,
-            ssl_keyfile=self.CLIENT_KEY,
+            ssl_certfile=self.client_certs.certfile,
+            ssl_keyfile=self.client_certs.keyfile,
             ssl_cert_reqs="required",
-            ssl_ca_certs=self.CA_CERT,
+            ssl_ca_certs=self.client_certs.ca_certfile,
         )
         assert r.ping()
         r.close()
 
     def test_validating_self_signed_string_certificate(self, request):
-        with open(self.CA_CERT) as f:
+        with open(self.client_certs.ca_certfile) as f:
             cert_data = f.read()
         ssl_url = request.config.option.redis_ssl_url
         p = urlparse(ssl_url)[1].split(":")
@@ -72,8 +75,8 @@ def test_validating_self_signed_string_certificate(self, request):
             host=p[0],
             port=p[1],
             ssl=True,
-            ssl_certfile=self.CLIENT_CERT,
-            ssl_keyfile=self.CLIENT_KEY,
+            ssl_certfile=self.client_certs.certfile,
+            ssl_keyfile=self.client_certs.keyfile,
             ssl_cert_reqs="required",
             ssl_ca_data=cert_data,
         )
@@ -149,10 +152,10 @@ def _create_oscp_conn(self, request):
             host=p[0],
             port=p[1],
             ssl=True,
-            ssl_certfile=self.CLIENT_CERT,
-            ssl_keyfile=self.CLIENT_KEY,
+            ssl_certfile=self.client_certs.certfile,
+            ssl_keyfile=self.client_certs.keyfile,
             ssl_cert_reqs="required",
-            ssl_ca_certs=self.CA_CERT,
+            ssl_ca_certs=self.client_certs.ca_certfile,
             ssl_validate_ocsp=True,
         )
         return r
@@ -247,10 +250,10 @@ def test_mock_ocsp_staple(self, request):
             host=p[0],
             port=p[1],
             ssl=True,
-            ssl_certfile=self.CLIENT_CERT,
-            ssl_keyfile=self.CLIENT_KEY,
+            ssl_certfile=self.client_certs.cert,
+            ssl_keyfile=self.client_certs.keyfile,
             ssl_cert_reqs="required",
-            ssl_ca_certs=self.CA_CERT,
+            ssl_ca_certs=self.client_certs.ca_certfile,
             ssl_validate_ocsp=True,
             ssl_ocsp_context=p,  # just needs to not be none
         )
@@ -260,19 +263,19 @@ def test_mock_ocsp_staple(self, request):
         r.close()
 
         ctx = OpenSSL.SSL.Context(OpenSSL.SSL.SSLv23_METHOD)
-        ctx.use_certificate_file(self.CLIENT_CERT)
-        ctx.use_privatekey_file(self.CLIENT_KEY)
+        ctx.use_certificate_file(self.client_certs.cert)
+        ctx.use_privatekey_file(self.client_certs.keyfile)
 
         r = redis.Redis(
             host=p[0],
             port=p[1],
             ssl=True,
-            ssl_certfile=self.CLIENT_CERT,
-            ssl_keyfile=self.CLIENT_KEY,
+            ssl_certfile=self.client_certs.cert,
+            ssl_keyfile=self.client_certs.keyfile,
             ssl_cert_reqs="required",
-            ssl_ca_certs=self.CA_CERT,
+            ssl_ca_certs=self.client_certs.ca_certfile,
             ssl_ocsp_context=ctx,
-            ssl_ocsp_expected_cert=open(self.SERVER_CERT, "rb").read(),
+            ssl_ocsp_expected_cert=open(self.server_certs.ca_certfile, "rb").read(),
             ssl_validate_ocsp_stapled=True,
         )
 
@@ -285,10 +288,10 @@ def test_mock_ocsp_staple(self, request):
             host=p[0],
             port=p[1],
             ssl=True,
-            ssl_certfile=self.CLIENT_CERT,
-            ssl_keyfile=self.CLIENT_KEY,
+            ssl_certfile=self.client_certs.cert,
+            ssl_keyfile=self.client_certs.keyfile,
             ssl_cert_reqs="required",
-            ssl_ca_certs=self.CA_CERT,
+            ssl_ca_certs=self.client_certs.ca_certfile,
             ssl_validate_ocsp_stapled=True,
         )
 

From c73a43dbcb5b8788b2e0af59bb6bb74c58707152 Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Thu, 28 Nov 2024 16:00:10 +0200
Subject: [PATCH 0939/1164] Fixed unsecured tempfile.mktemp() command usage
 (#3446)

* Fixed unsecured tempfile.mktemp() command usage

* Added proper tuple handling
---
 tests/test_json.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/test_json.py b/tests/test_json.py
index f4cea73787..96009cd063 100644
--- a/tests/test_json.py
+++ b/tests/test_json.py
@@ -1521,8 +1521,8 @@ def test_set_path(client):
 
     root = tempfile.mkdtemp()
     sub = tempfile.mkdtemp(dir=root)
-    jsonfile = tempfile.mktemp(suffix=".json", dir=sub)
-    nojsonfile = tempfile.mktemp(dir=root)
+    jsonfile = tempfile.mkstemp(suffix=".json", dir=sub)[1]
+    nojsonfile = tempfile.mkstemp(dir=root)[1]
 
     with open(jsonfile, "w+") as fp:
         fp.write(json.dumps({"hello": "world"}))

From db8918cfefe9e14124eea41aa5a4efe66b70159d Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Thu, 5 Dec 2024 11:57:55 +0200
Subject: [PATCH 0940/1164] Fixed bug with SLOWLOG GET response parsing from
 Redis Enterprise (#3441)

---
 redis/_parsers/helpers.py | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/redis/_parsers/helpers.py b/redis/_parsers/helpers.py
index 6832100bb6..5468addf62 100644
--- a/redis/_parsers/helpers.py
+++ b/redis/_parsers/helpers.py
@@ -396,13 +396,20 @@ def parse_item(item):
         # an O(N) complexity) instead of the command.
         if isinstance(item[3], list):
             result["command"] = space.join(item[3])
-            result["client_address"] = item[4]
-            result["client_name"] = item[5]
+
+            # These fields are optional, depends on environment.
+            if len(item) >= 6:
+                result["client_address"] = item[4]
+                result["client_name"] = item[5]
         else:
             result["complexity"] = item[3]
             result["command"] = space.join(item[4])
-            result["client_address"] = item[5]
-            result["client_name"] = item[6]
+
+            # These fields are optional, depends on environment.
+            if len(item) >= 7:
+                result["client_address"] = item[5]
+                result["client_name"] = item[6]
+
         return result
 
     return [parse_item(item) for item in response]

From 5043b69652ac98aa0422ed8fa1b8f8a6fc3ea60f Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Thu, 5 Dec 2024 14:06:46 +0200
Subject: [PATCH 0941/1164] Fixed issue with invoking _close() on closed event
 loop (#3438)

* Fixed issue with invoking _close() on closed event loop

* Removed unused import

* Revert weakref changes

* Codestyle fix

* Added test coverage

* Codestyle fixes

* Codestyle fixes

* Removed failure check that fails in 3.12

* Codestyle fixes

* Codestyle fixes
---
 redis/asyncio/connection.py         |  8 +++++++-
 redis/asyncio/sentinel.py           |  6 +-----
 tests/test_asyncio/test_sentinel.py | 20 ++++++++++++++++++++
 3 files changed, 28 insertions(+), 6 deletions(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index ddbd22c95d..8c3123ac04 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -214,7 +214,13 @@ def __del__(self, _warnings: Any = warnings):
             _warnings.warn(
                 f"unclosed Connection {self!r}", ResourceWarning, source=self
             )
-            self._close()
+
+            try:
+                asyncio.get_running_loop()
+                self._close()
+            except RuntimeError:
+                # No actions been taken if pool already closed.
+                pass
 
     def _close(self):
         """
diff --git a/redis/asyncio/sentinel.py b/redis/asyncio/sentinel.py
index 5d4608ed2f..f1d2cab3f1 100644
--- a/redis/asyncio/sentinel.py
+++ b/redis/asyncio/sentinel.py
@@ -29,11 +29,7 @@ def __init__(self, **kwargs):
         super().__init__(**kwargs)
 
     def __repr__(self):
-        pool = self.connection_pool
-        s = (
-            f"<{self.__class__.__module__}.{self.__class__.__name__}"
-            f"(service={pool.service_name}"
-        )
+        s = f"<{self.__class__.__module__}.{self.__class__.__name__}"
         if self.host:
             host_info = f",host={self.host},port={self.port}"
             s += host_info
diff --git a/tests/test_asyncio/test_sentinel.py b/tests/test_asyncio/test_sentinel.py
index 51e59d69d0..e553fdb00b 100644
--- a/tests/test_asyncio/test_sentinel.py
+++ b/tests/test_asyncio/test_sentinel.py
@@ -264,3 +264,23 @@ async def mock_disconnect():
 
     assert calls == 1
     await pool.disconnect()
+
+
+@pytest.mark.onlynoncluster
+async def test_repr_correctly_represents_connection_object(sentinel):
+    pool = SentinelConnectionPool("mymaster", sentinel)
+    connection = await pool.get_connection("PING")
+
+    assert (
+        str(connection)
+        == "<redis.asyncio.sentinel.SentinelManagedConnection,host=127.0.0.1,port=6379)>"  # noqa: E501
+    )
+    assert connection.connection_pool == pool
+    await pool.release(connection)
+
+    del pool
+
+    assert (
+        str(connection)
+        == "<redis.asyncio.sentinel.SentinelManagedConnection,host=127.0.0.1,port=6379)>"  # noqa: E501
+    )

From 9d5751d2409c1ca42f74c8c2186ec1e3d9d3b780 Mon Sep 17 00:00:00 2001
From: Ilian Iliev <ilian@ilian.io>
Date: Thu, 5 Dec 2024 16:32:37 +0200
Subject: [PATCH 0942/1164] Fixing randomly failing test (#3437)

* Fixing randomly failing test

* Always rounding up to avoid randomly failing tests

* Always rounding up to avoid randomly failing tests

---------

Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
---
 tests/test_asyncio/test_hash.py | 13 +++++++------
 tests/test_hash.py              | 13 +++++++------
 2 files changed, 14 insertions(+), 12 deletions(-)

diff --git a/tests/test_asyncio/test_hash.py b/tests/test_asyncio/test_hash.py
index 8d94799fbb..15e426673b 100644
--- a/tests/test_asyncio/test_hash.py
+++ b/tests/test_asyncio/test_hash.py
@@ -1,4 +1,5 @@
 import asyncio
+import math
 from datetime import datetime, timedelta
 
 from tests.conftest import skip_if_server_version_lt
@@ -128,9 +129,9 @@ async def test_hpexpire_multiple_fields(r):
 async def test_hexpireat_basic(r):
     await r.delete("test:hash")
     await r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
-    exp_time = int((datetime.now() + timedelta(seconds=1)).timestamp())
+    exp_time = math.ceil((datetime.now() + timedelta(seconds=1)).timestamp())
     assert await r.hexpireat("test:hash", exp_time, "field1") == [1]
-    await asyncio.sleep(1.1)
+    await asyncio.sleep(2.1)
     assert await r.hexists("test:hash", "field1") is False
     assert await r.hexists("test:hash", "field2") is True
 
@@ -139,9 +140,9 @@ async def test_hexpireat_basic(r):
 async def test_hexpireat_with_datetime(r):
     await r.delete("test:hash")
     await r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
-    exp_time = datetime.now() + timedelta(seconds=1)
+    exp_time = (datetime.now() + timedelta(seconds=2)).replace(microsecond=0)
     assert await r.hexpireat("test:hash", exp_time, "field1") == [1]
-    await asyncio.sleep(1.1)
+    await asyncio.sleep(2.1)
     assert await r.hexists("test:hash", "field1") is False
     assert await r.hexists("test:hash", "field2") is True
 
@@ -175,9 +176,9 @@ async def test_hexpireat_multiple_fields(r):
         "test:hash",
         mapping={"field1": "value1", "field2": "value2", "field3": "value3"},
     )
-    exp_time = int((datetime.now() + timedelta(seconds=1)).timestamp())
+    exp_time = math.ceil((datetime.now() + timedelta(seconds=1)).timestamp())
     assert await r.hexpireat("test:hash", exp_time, "field1", "field2") == [1, 1]
-    await asyncio.sleep(1.5)
+    await asyncio.sleep(2.1)
     assert await r.hexists("test:hash", "field1") is False
     assert await r.hexists("test:hash", "field2") is False
     assert await r.hexists("test:hash", "field3") is True
diff --git a/tests/test_hash.py b/tests/test_hash.py
index 9ed5e98132..0422185865 100644
--- a/tests/test_hash.py
+++ b/tests/test_hash.py
@@ -1,3 +1,4 @@
+import math
 import time
 from datetime import datetime, timedelta
 
@@ -147,9 +148,9 @@ def test_hpexpire_multiple_condition_flags_error(r):
 def test_hexpireat_basic(r):
     r.delete("test:hash")
     r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
-    exp_time = int((datetime.now() + timedelta(seconds=1)).timestamp())
+    exp_time = math.ceil((datetime.now() + timedelta(seconds=1)).timestamp())
     assert r.hexpireat("test:hash", exp_time, "field1") == [1]
-    time.sleep(1.1)
+    time.sleep(2.1)
     assert r.hexists("test:hash", "field1") is False
     assert r.hexists("test:hash", "field2") is True
 
@@ -158,9 +159,9 @@ def test_hexpireat_basic(r):
 def test_hexpireat_with_datetime(r):
     r.delete("test:hash")
     r.hset("test:hash", mapping={"field1": "value1", "field2": "value2"})
-    exp_time = datetime.now() + timedelta(seconds=1)
+    exp_time = (datetime.now() + timedelta(seconds=2)).replace(microsecond=0)
     assert r.hexpireat("test:hash", exp_time, "field1") == [1]
-    time.sleep(1.1)
+    time.sleep(2.1)
     assert r.hexists("test:hash", "field1") is False
     assert r.hexists("test:hash", "field2") is True
 
@@ -194,9 +195,9 @@ def test_hexpireat_multiple_fields(r):
         "test:hash",
         mapping={"field1": "value1", "field2": "value2", "field3": "value3"},
     )
-    exp_time = int((datetime.now() + timedelta(seconds=1)).timestamp())
+    exp_time = math.ceil((datetime.now() + timedelta(seconds=1)).timestamp())
     assert r.hexpireat("test:hash", exp_time, "field1", "field2") == [1, 1]
-    time.sleep(1.1)
+    time.sleep(2.1)
     assert r.hexists("test:hash", "field1") is False
     assert r.hexists("test:hash", "field2") is False
     assert r.hexists("test:hash", "field3") is True

From 8f2276e14d98b20cd9fc7b4a9e4e084fe9c74609 Mon Sep 17 00:00:00 2001
From: andy-stark-redis <164213578+andy-stark-redis@users.noreply.github.com>
Date: Mon, 9 Dec 2024 08:32:22 +0000
Subject: [PATCH 0943/1164] DOC-4560 pipe/transaction examples (#3449)

---
 doctests/trans_pipe.py | 98 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 98 insertions(+)
 create mode 100644 doctests/trans_pipe.py

diff --git a/doctests/trans_pipe.py b/doctests/trans_pipe.py
new file mode 100644
index 0000000000..d020f7b2dc
--- /dev/null
+++ b/doctests/trans_pipe.py
@@ -0,0 +1,98 @@
+# EXAMPLE: pipe_trans_tutorial
+# HIDE_START
+"""
+Code samples for vector database quickstart pages:
+    https://redis.io/docs/latest/develop/get-started/vector-database/
+"""
+# HIDE_END
+import redis
+
+# STEP_START basic_pipe
+r = redis.Redis(decode_responses=True)
+# REMOVE_START
+for i in range(5):
+    r.delete(f"seat:{i}")
+
+r.delete("shellpath")
+# REMOVE_END
+
+pipe = r.pipeline()
+
+for i in range(5):
+    pipe.set(f"seat:{i}", f"#{i}")
+
+set_5_result = pipe.execute()
+print(set_5_result)  # >>> [True, True, True, True, True]
+
+pipe = r.pipeline()
+
+# "Chain" pipeline commands together.
+get_3_result = pipe.get("seat:0").get("seat:3").get("seat:4").execute()
+print(get_3_result)  # >>> ['#0', '#3', '#4']
+# STEP_END
+# REMOVE_START
+assert set_5_result == [True, True, True, True, True]
+assert get_3_result == ['#0', '#3', '#4']
+# REMOVE_END
+
+# STEP_START trans_watch
+r.set("shellpath", "/usr/syscmds/")
+
+with r.pipeline() as pipe:
+    # Repeat until successful.
+    while True:
+        try:
+            # Watch the key we are about to change.
+            pipe.watch("shellpath")
+
+            # The pipeline executes commands directly (instead of
+            # buffering them) from immediately after the `watch()`
+            # call until we begin the transaction.
+            current_path = pipe.get("shellpath")
+            new_path = current_path + ":/usr/mycmds/"
+
+            # Start the transaction, which will enable buffering
+            # again for the remaining commands.
+            pipe.multi()
+
+            pipe.set("shellpath", new_path)
+
+            pipe.execute()
+
+            # The transaction succeeded, so break out of the loop.
+            break
+        except redis.WatchError:
+            # The transaction failed, so continue with the next attempt.
+            continue
+
+get_path_result = r.get("shellpath")
+print(get_path_result)  # >>> '/usr/syscmds/:/usr/mycmds/'
+# STEP_END
+# REMOVE_START
+assert get_path_result == '/usr/syscmds/:/usr/mycmds/'
+r.delete("shellpath")
+# REMOVE_END
+
+# STEP_START watch_conv_method
+r.set("shellpath", "/usr/syscmds/")
+
+
+def watched_sequence(pipe):
+    current_path = pipe.get("shellpath")
+    new_path = current_path + ":/usr/mycmds/"
+
+    pipe.multi()
+
+    pipe.set("shellpath", new_path)
+
+
+trans_result = r.transaction(watched_sequence, "shellpath")
+print(trans_result)  # True
+
+get_path_result = r.get("shellpath")
+print(get_path_result)  # >>> '/usr/syscmds/:/usr/mycmds/'
+# REMOVE_START
+assert trans_result
+assert get_path_result == '/usr/syscmds/:/usr/mycmds/'
+# REMOVE_END
+# STEP_END

From 40e5fc131b457edc368637c1034424567553ba55 Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Fri, 20 Dec 2024 19:26:01 +0200
Subject: [PATCH 0944/1164] StreamingCredentialProvider support (#3445)

* Added StreamingCredentialProvider interface

* StreamingCredentialProvider support

* Removed debug statement

* Changed an approach to handle multiple connection pools

* Added support for RedisCluster

* Added dispatching of custom connection pool

* Extended CredentialProvider interface with async API

* Changed method implementation

* Added support for async API

* Removed unused lock

* Added async API

* Added support for single connection client

* Added core functionality

* Revert debug call

* Added package to setup.py

* Added handling of in-use connections

* Added testing

* Changed fixture name

* Added marker

* Marked tests with correct annotations

* Added better cancelation handling

* Removed another annotation

* Added support for async cluster

* Added pipeline tests

* Added support for Pub/Sub

* Added support for Pub/Sub in cluster

* Added an option to parse endpoint from endpoints.json

* Updated package names and ENV variables

* Moved SSL certificates code into context of class

* Fixed fixtures for async

* Fixed test

* Added better endpoitns handling

* Changed variable names

* Added logging

* Fixed broken tests

* Added TODO for SSL tests

* Added error propagation to main thread

* Added single connection lock

* Codestyle fixes

* Added missing methods

* Removed wrong annotation

* Fixed tests

* Codestyle fix

* Updated EventListener instantiation inside of class

* Fixed variable name

* Fixed variable names

* Fixed variable name

* Added EventException

* Codestyle fix

* Removed redundant code

* Codestyle fix

* Updated test case

* Fixed tests

* Fixed test

* Removed dependency
---
 .github/actions/run-tests/action.yml       |   2 +-
 dev_requirements.txt                       |   1 +
 pytest.ini                                 |   1 +
 redis/asyncio/client.py                    |  43 +-
 redis/asyncio/cluster.py                   |  54 ++
 redis/asyncio/connection.py                |  73 ++-
 redis/auth/__init__.py                     |   0
 redis/auth/err.py                          |  31 ++
 redis/auth/idp.py                          |  28 +
 redis/auth/token.py                        | 126 +++++
 redis/auth/token_manager.py                | 370 ++++++++++++++
 redis/client.py                            |  54 +-
 redis/cluster.py                           |  39 ++
 redis/connection.py                        |  73 +++
 redis/credentials.py                       |  41 +-
 redis/event.py                             | 394 ++++++++++++++
 requirements.txt                           |   3 +-
 setup.py                                   |   1 +
 tests/conftest.py                          | 177 ++++++-
 tests/test_asyncio/conftest.py             | 139 +++++
 tests/test_asyncio/test_cluster.py         |  17 +-
 tests/test_asyncio/test_connection_pool.py |   7 +
 tests/test_asyncio/test_credentials.py     | 417 ++++++++++++++-
 tests/test_auth/__init__.py                |   0
 tests/test_auth/test_token.py              |  76 +++
 tests/test_auth/test_token_manager.py      | 566 +++++++++++++++++++++
 tests/test_connection.py                   |   4 +
 tests/test_credentials.py                  | 413 ++++++++++++++-
 28 files changed, 3117 insertions(+), 33 deletions(-)
 create mode 100644 redis/auth/__init__.py
 create mode 100644 redis/auth/err.py
 create mode 100644 redis/auth/idp.py
 create mode 100644 redis/auth/token.py
 create mode 100644 redis/auth/token_manager.py
 create mode 100644 redis/event.py
 create mode 100644 tests/test_auth/__init__.py
 create mode 100644 tests/test_auth/test_token.py
 create mode 100644 tests/test_auth/test_token_manager.py

diff --git a/.github/actions/run-tests/action.yml b/.github/actions/run-tests/action.yml
index 64d31969bd..5ca6bf5a09 100644
--- a/.github/actions/run-tests/action.yml
+++ b/.github/actions/run-tests/action.yml
@@ -103,7 +103,7 @@ runs:
         
           if (( $REDIS_MAJOR_VERSION < 7 )) && [ "$protocol" == "3" ]; then
             echo "Skipping module tests: Modules doesn't support RESP3 for Redis versions < 7"
-            invoke standalone-tests --redis-mod-url=${REDIS_MOD_URL} $eventloop --protocol="${protocol}" --extra-markers="not redismod"
+            invoke standalone-tests --redis-mod-url=${REDIS_MOD_URL} $eventloop --protocol="${protocol}" --extra-markers="not redismod and not cp_integration"
           else        
             invoke standalone-tests --redis-mod-url=${REDIS_MOD_URL} $eventloop --protocol="${protocol}"
           fi
diff --git a/dev_requirements.txt b/dev_requirements.txt
index adfa99e80c..945afc35dc 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -16,3 +16,4 @@ uvloop
 vulture>=2.3.0
 wheel>=0.30.0
 numpy>=1.24.0
+redispy-entraid-credentials @ git+https://github.com/redis-developer/redispy-entra-credentials.git/@main
diff --git a/pytest.ini b/pytest.ini
index bbb8d420c4..68fee2b603 100644
--- a/pytest.ini
+++ b/pytest.ini
@@ -10,6 +10,7 @@ markers =
     asyncio: marker for async tests
     replica: replica tests
     experimental: run only experimental tests
+    cp_integration: credential provider integration tests
 asyncio_mode = auto
 timeout = 30
 filterwarnings =
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 9508849703..9478d539d7 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -53,6 +53,13 @@
     list_or_args,
 )
 from redis.credentials import CredentialProvider
+from redis.event import (
+    AfterPooledConnectionsInstantiationEvent,
+    AfterPubSubConnectionInstantiationEvent,
+    AfterSingleConnectionInstantiationEvent,
+    ClientType,
+    EventDispatcher,
+)
 from redis.exceptions import (
     ConnectionError,
     ExecAbortError,
@@ -233,6 +240,7 @@ def __init__(
         redis_connect_func=None,
         credential_provider: Optional[CredentialProvider] = None,
         protocol: Optional[int] = 2,
+        event_dispatcher: Optional[EventDispatcher] = None,
     ):
         """
         Initialize a new Redis client.
@@ -242,6 +250,10 @@ def __init__(
         To retry on TimeoutError, `retry_on_timeout` can also be set to `True`.
         """
         kwargs: Dict[str, Any]
+        if event_dispatcher is None:
+            self._event_dispatcher = EventDispatcher()
+        else:
+            self._event_dispatcher = event_dispatcher
         # auto_close_connection_pool only has an effect if connection_pool is
         # None. It is assumed that if connection_pool is not None, the user
         # wants to manage the connection pool themselves.
@@ -320,9 +332,19 @@ def __init__(
             # This arg only used if no pool is passed in
             self.auto_close_connection_pool = auto_close_connection_pool
             connection_pool = ConnectionPool(**kwargs)
+            self._event_dispatcher.dispatch(
+                AfterPooledConnectionsInstantiationEvent(
+                    [connection_pool], ClientType.ASYNC, credential_provider
+                )
+            )
         else:
             # If a pool is passed in, do not close it
             self.auto_close_connection_pool = False
+            self._event_dispatcher.dispatch(
+                AfterPooledConnectionsInstantiationEvent(
+                    [connection_pool], ClientType.ASYNC, credential_provider
+                )
+            )
 
         self.connection_pool = connection_pool
         self.single_connection_client = single_connection_client
@@ -354,6 +376,12 @@ async def initialize(self: _RedisT) -> _RedisT:
             async with self._single_conn_lock:
                 if self.connection is None:
                     self.connection = await self.connection_pool.get_connection("_")
+
+            self._event_dispatcher.dispatch(
+                AfterSingleConnectionInstantiationEvent(
+                    self.connection, ClientType.ASYNC, self._single_conn_lock
+                )
+            )
         return self
 
     def set_response_callback(self, command: str, callback: ResponseCallbackT):
@@ -521,7 +549,9 @@ def pubsub(self, **kwargs) -> "PubSub":
         subscribe to channels and listen for messages that get published to
         them.
         """
-        return PubSub(self.connection_pool, **kwargs)
+        return PubSub(
+            self.connection_pool, event_dispatcher=self._event_dispatcher, **kwargs
+        )
 
     def monitor(self) -> "Monitor":
         return Monitor(self.connection_pool)
@@ -759,7 +789,12 @@ def __init__(
         ignore_subscribe_messages: bool = False,
         encoder=None,
         push_handler_func: Optional[Callable] = None,
+        event_dispatcher: Optional["EventDispatcher"] = None,
     ):
+        if event_dispatcher is None:
+            self._event_dispatcher = EventDispatcher()
+        else:
+            self._event_dispatcher = event_dispatcher
         self.connection_pool = connection_pool
         self.shard_hint = shard_hint
         self.ignore_subscribe_messages = ignore_subscribe_messages
@@ -876,6 +911,12 @@ async def connect(self):
         if self.push_handler_func is not None and not HIREDIS_AVAILABLE:
             self.connection._parser.set_pubsub_push_handler(self.push_handler_func)
 
+        self._event_dispatcher.dispatch(
+            AfterPubSubConnectionInstantiationEvent(
+                self.connection, self.connection_pool, ClientType.ASYNC, self._lock
+            )
+        )
+
     async def _disconnect_raise_connect(self, conn, error):
         """
         Close the connection and raise an exception
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 4e82e5448f..408fa19363 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -29,6 +29,7 @@
 from redis.asyncio.connection import Connection, DefaultParser, SSLConnection, parse_url
 from redis.asyncio.lock import Lock
 from redis.asyncio.retry import Retry
+from redis.auth.token import TokenInterface
 from redis.backoff import default_backoff
 from redis.client import EMPTY_RESPONSE, NEVER_DECODE, AbstractRedis
 from redis.cluster import (
@@ -45,6 +46,7 @@
 from redis.commands import READ_COMMANDS, AsyncRedisClusterCommands
 from redis.crc import REDIS_CLUSTER_HASH_SLOTS, key_slot
 from redis.credentials import CredentialProvider
+from redis.event import AfterAsyncClusterInstantiationEvent, EventDispatcher
 from redis.exceptions import (
     AskError,
     BusyLoadingError,
@@ -57,6 +59,7 @@
     MaxConnectionsError,
     MovedError,
     RedisClusterException,
+    RedisError,
     ResponseError,
     SlotNotCoveredError,
     TimeoutError,
@@ -270,6 +273,7 @@ def __init__(
         ssl_ciphers: Optional[str] = None,
         protocol: Optional[int] = 2,
         address_remap: Optional[Callable[[Tuple[str, int]], Tuple[str, int]]] = None,
+        event_dispatcher: Optional[EventDispatcher] = None,
     ) -> None:
         if db:
             raise RedisClusterException(
@@ -366,11 +370,17 @@ def __init__(
         if host and port:
             startup_nodes.append(ClusterNode(host, port, **self.connection_kwargs))
 
+        if event_dispatcher is None:
+            self._event_dispatcher = EventDispatcher()
+        else:
+            self._event_dispatcher = event_dispatcher
+
         self.nodes_manager = NodesManager(
             startup_nodes,
             require_full_coverage,
             kwargs,
             address_remap=address_remap,
+            event_dispatcher=self._event_dispatcher,
         )
         self.encoder = Encoder(encoding, encoding_errors, decode_responses)
         self.read_from_replicas = read_from_replicas
@@ -929,6 +939,8 @@ class ClusterNode:
     __slots__ = (
         "_connections",
         "_free",
+        "_lock",
+        "_event_dispatcher",
         "connection_class",
         "connection_kwargs",
         "host",
@@ -966,6 +978,9 @@ def __init__(
 
         self._connections: List[Connection] = []
         self._free: Deque[Connection] = collections.deque(maxlen=self.max_connections)
+        self._event_dispatcher = self.connection_kwargs.get("event_dispatcher", None)
+        if self._event_dispatcher is None:
+            self._event_dispatcher = EventDispatcher()
 
     def __repr__(self) -> str:
         return (
@@ -1082,10 +1097,38 @@ async def execute_pipeline(self, commands: List["PipelineCommand"]) -> bool:
 
         return ret
 
+    async def re_auth_callback(self, token: TokenInterface):
+        tmp_queue = collections.deque()
+        while self._free:
+            conn = self._free.popleft()
+            await conn.retry.call_with_retry(
+                lambda: conn.send_command(
+                    "AUTH", token.try_get("oid"), token.get_value()
+                ),
+                lambda error: self._mock(error),
+            )
+            await conn.retry.call_with_retry(
+                lambda: conn.read_response(), lambda error: self._mock(error)
+            )
+            tmp_queue.append(conn)
+
+        while tmp_queue:
+            conn = tmp_queue.popleft()
+            self._free.append(conn)
+
+    async def _mock(self, error: RedisError):
+        """
+        Dummy functions, needs to be passed as error callback to retry object.
+        :param error:
+        :return:
+        """
+        pass
+
 
 class NodesManager:
     __slots__ = (
         "_moved_exception",
+        "_event_dispatcher",
         "connection_kwargs",
         "default_node",
         "nodes_cache",
@@ -1102,6 +1145,7 @@ def __init__(
         require_full_coverage: bool,
         connection_kwargs: Dict[str, Any],
         address_remap: Optional[Callable[[Tuple[str, int]], Tuple[str, int]]] = None,
+        event_dispatcher: Optional[EventDispatcher] = None,
     ) -> None:
         self.startup_nodes = {node.name: node for node in startup_nodes}
         self.require_full_coverage = require_full_coverage
@@ -1113,6 +1157,10 @@ def __init__(
         self.slots_cache: Dict[int, List["ClusterNode"]] = {}
         self.read_load_balancer = LoadBalancer()
         self._moved_exception: MovedError = None
+        if event_dispatcher is None:
+            self._event_dispatcher = EventDispatcher()
+        else:
+            self._event_dispatcher = event_dispatcher
 
     def get_node(
         self,
@@ -1230,6 +1278,12 @@ async def initialize(self) -> None:
             try:
                 # Make sure cluster mode is enabled on this node
                 try:
+                    self._event_dispatcher.dispatch(
+                        AfterAsyncClusterInstantiationEvent(
+                            self.nodes_cache,
+                            self.connection_kwargs.get("credential_provider", None),
+                        )
+                    )
                     cluster_slots = await startup_node.execute_command("CLUSTER SLOTS")
                 except ResponseError:
                     raise RedisClusterException(
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 8c3123ac04..4a743ff374 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -27,6 +27,8 @@
 )
 from urllib.parse import ParseResult, parse_qs, unquote, urlparse
 
+from ..auth.token import TokenInterface
+from ..event import AsyncAfterConnectionReleasedEvent, EventDispatcher
 from ..utils import format_error_message
 
 # the functionality is available in 3.11.x but has a major issue before
@@ -148,6 +150,7 @@ def __init__(
         encoder_class: Type[Encoder] = Encoder,
         credential_provider: Optional[CredentialProvider] = None,
         protocol: Optional[int] = 2,
+        event_dispatcher: Optional[EventDispatcher] = None,
     ):
         if (username or password) and credential_provider is not None:
             raise DataError(
@@ -156,6 +159,10 @@ def __init__(
                 "1. 'password' and (optional) 'username'\n"
                 "2. 'credential_provider'"
             )
+        if event_dispatcher is None:
+            self._event_dispatcher = EventDispatcher()
+        else:
+            self._event_dispatcher = event_dispatcher
         self.db = db
         self.client_name = client_name
         self.lib_name = lib_name
@@ -195,6 +202,8 @@ def __init__(
         self.set_parser(parser_class)
         self._connect_callbacks: List[weakref.WeakMethod[ConnectCallbackT]] = []
         self._buffer_cutoff = 6000
+        self._re_auth_token: Optional[TokenInterface] = None
+
         try:
             p = int(protocol)
         except TypeError:
@@ -327,6 +336,9 @@ def _host_error(self) -> str:
     def _error_message(self, exception: BaseException) -> str:
         return format_error_message(self._host_error(), exception)
 
+    def get_protocol(self):
+        return self.protocol
+
     async def on_connect(self) -> None:
         """Initialize the connection, authenticate and select a database"""
         self._parser.on_connect(self)
@@ -339,7 +351,8 @@ async def on_connect(self) -> None:
                 self.credential_provider
                 or UsernamePasswordCredentialProvider(self.username, self.password)
             )
-            auth_args = cred_provider.get_credentials()
+            auth_args = await cred_provider.get_credentials_async()
+
             # if resp version is specified and we have auth args,
             # we need to send them via HELLO
         if auth_args and self.protocol not in [2, "2"]:
@@ -661,6 +674,19 @@ async def process_invalidation_messages(self):
         while not self._socket_is_empty():
             await self.read_response(push_request=True)
 
+    def set_re_auth_token(self, token: TokenInterface):
+        self._re_auth_token = token
+
+    async def re_auth(self):
+        if self._re_auth_token is not None:
+            await self.send_command(
+                "AUTH",
+                self._re_auth_token.try_get("oid"),
+                self._re_auth_token.get_value(),
+            )
+            await self.read_response()
+            self._re_auth_token = None
+
 
 class Connection(AbstractConnection):
     "Manages TCP communication to and from a Redis server"
@@ -1039,6 +1065,10 @@ def __init__(
         self._available_connections: List[AbstractConnection] = []
         self._in_use_connections: Set[AbstractConnection] = set()
         self.encoder_class = self.connection_kwargs.get("encoder_class", Encoder)
+        self._lock = asyncio.Lock()
+        self._event_dispatcher = self.connection_kwargs.get("event_dispatcher", None)
+        if self._event_dispatcher is None:
+            self._event_dispatcher = EventDispatcher()
 
     def __repr__(self):
         return (
@@ -1058,13 +1088,14 @@ def can_get_connection(self) -> bool:
         )
 
     async def get_connection(self, command_name, *keys, **options):
-        """Get a connected connection from the pool"""
-        connection = self.get_available_connection()
-        try:
-            await self.ensure_connection(connection)
-        except BaseException:
-            await self.release(connection)
-            raise
+        async with self._lock:
+            """Get a connected connection from the pool"""
+            connection = self.get_available_connection()
+            try:
+                await self.ensure_connection(connection)
+            except BaseException:
+                await self.release(connection)
+                raise
 
         return connection
 
@@ -1114,6 +1145,9 @@ async def release(self, connection: AbstractConnection):
         # not doing so is an error that will cause an exception here.
         self._in_use_connections.remove(connection)
         self._available_connections.append(connection)
+        await self._event_dispatcher.dispatch_async(
+            AsyncAfterConnectionReleasedEvent(connection)
+        )
 
     async def disconnect(self, inuse_connections: bool = True):
         """
@@ -1147,6 +1181,29 @@ def set_retry(self, retry: "Retry") -> None:
         for conn in self._in_use_connections:
             conn.retry = retry
 
+    async def re_auth_callback(self, token: TokenInterface):
+        async with self._lock:
+            for conn in self._available_connections:
+                await conn.retry.call_with_retry(
+                    lambda: conn.send_command(
+                        "AUTH", token.try_get("oid"), token.get_value()
+                    ),
+                    lambda error: self._mock(error),
+                )
+                await conn.retry.call_with_retry(
+                    lambda: conn.read_response(), lambda error: self._mock(error)
+                )
+            for conn in self._in_use_connections:
+                conn.set_re_auth_token(token)
+
+    async def _mock(self, error: RedisError):
+        """
+        Dummy functions, needs to be passed as error callback to retry object.
+        :param error:
+        :return:
+        """
+        pass
+
 
 class BlockingConnectionPool(ConnectionPool):
     """
diff --git a/redis/auth/__init__.py b/redis/auth/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/redis/auth/err.py b/redis/auth/err.py
new file mode 100644
index 0000000000..743dab18fe
--- /dev/null
+++ b/redis/auth/err.py
@@ -0,0 +1,31 @@
+from typing import Iterable
+
+
+class RequestTokenErr(Exception):
+    """
+    Represents an exception during token request.
+    """
+
+    def __init__(self, *args):
+        super().__init__(*args)
+
+
+class InvalidTokenSchemaErr(Exception):
+    """
+    Represents an exception related to invalid token schema.
+    """
+
+    def __init__(self, missing_fields: Iterable[str] = []):
+        super().__init__(
+            "Unexpected token schema. Following fields are missing: "
+            + ", ".join(missing_fields)
+        )
+
+
+class TokenRenewalErr(Exception):
+    """
+    Represents an exception during token renewal process.
+    """
+
+    def __init__(self, *args):
+        super().__init__(*args)
diff --git a/redis/auth/idp.py b/redis/auth/idp.py
new file mode 100644
index 0000000000..0951d95641
--- /dev/null
+++ b/redis/auth/idp.py
@@ -0,0 +1,28 @@
+from abc import ABC, abstractmethod
+
+from redis.auth.token import TokenInterface
+
+"""
+This interface is the facade of an identity provider
+"""
+
+
+class IdentityProviderInterface(ABC):
+    """
+    Receive a token from the identity provider.
+    Receiving a token only works when being authenticated.
+    """
+
+    @abstractmethod
+    def request_token(self, force_refresh=False) -> TokenInterface:
+        pass
+
+
+class IdentityProviderConfigInterface(ABC):
+    """
+    Configuration class that provides a configured identity provider.
+    """
+
+    @abstractmethod
+    def get_provider(self) -> IdentityProviderInterface:
+        pass
diff --git a/redis/auth/token.py b/redis/auth/token.py
new file mode 100644
index 0000000000..876e95c4fa
--- /dev/null
+++ b/redis/auth/token.py
@@ -0,0 +1,126 @@
+from abc import ABC, abstractmethod
+from datetime import datetime, timezone
+
+import jwt
+from redis.auth.err import InvalidTokenSchemaErr
+
+
+class TokenInterface(ABC):
+    @abstractmethod
+    def is_expired(self) -> bool:
+        pass
+
+    @abstractmethod
+    def ttl(self) -> float:
+        pass
+
+    @abstractmethod
+    def try_get(self, key: str) -> str:
+        pass
+
+    @abstractmethod
+    def get_value(self) -> str:
+        pass
+
+    @abstractmethod
+    def get_expires_at_ms(self) -> float:
+        pass
+
+    @abstractmethod
+    def get_received_at_ms(self) -> float:
+        pass
+
+
+class TokenResponse:
+    def __init__(self, token: TokenInterface):
+        self._token = token
+
+    def get_token(self) -> TokenInterface:
+        return self._token
+
+    def get_ttl_ms(self) -> float:
+        return self._token.get_expires_at_ms() - self._token.get_received_at_ms()
+
+
+class SimpleToken(TokenInterface):
+    def __init__(
+        self, value: str, expires_at_ms: float, received_at_ms: float, claims: dict
+    ) -> None:
+        self.value = value
+        self.expires_at = expires_at_ms
+        self.received_at = received_at_ms
+        self.claims = claims
+
+    def ttl(self) -> float:
+        if self.expires_at == -1:
+            return -1
+
+        return self.expires_at - (datetime.now(timezone.utc).timestamp() * 1000)
+
+    def is_expired(self) -> bool:
+        if self.expires_at == -1:
+            return False
+
+        return self.ttl() <= 0
+
+    def try_get(self, key: str) -> str:
+        return self.claims.get(key)
+
+    def get_value(self) -> str:
+        return self.value
+
+    def get_expires_at_ms(self) -> float:
+        return self.expires_at
+
+    def get_received_at_ms(self) -> float:
+        return self.received_at
+
+
+class JWToken(TokenInterface):
+
+    REQUIRED_FIELDS = {"exp"}
+
+    def __init__(self, token: str):
+        self._value = token
+        self._decoded = jwt.decode(
+            self._value,
+            options={"verify_signature": False},
+            algorithms=[jwt.get_unverified_header(self._value).get("alg")],
+        )
+        self._validate_token()
+
+    def is_expired(self) -> bool:
+        exp = self._decoded["exp"]
+        if exp == -1:
+            return False
+
+        return (
+            self._decoded["exp"] * 1000 <= datetime.now(timezone.utc).timestamp() * 1000
+        )
+
+    def ttl(self) -> float:
+        exp = self._decoded["exp"]
+        if exp == -1:
+            return -1
+
+        return (
+            self._decoded["exp"] * 1000 - datetime.now(timezone.utc).timestamp() * 1000
+        )
+
+    def try_get(self, key: str) -> str:
+        return self._decoded.get(key)
+
+    def get_value(self) -> str:
+        return self._value
+
+    def get_expires_at_ms(self) -> float:
+        return float(self._decoded["exp"] * 1000)
+
+    def get_received_at_ms(self) -> float:
+        return datetime.now(timezone.utc).timestamp() * 1000
+
+    def _validate_token(self):
+        actual_fields = {x for x in self._decoded.keys()}
+
+        if len(self.REQUIRED_FIELDS - actual_fields) != 0:
+            raise InvalidTokenSchemaErr(self.REQUIRED_FIELDS - actual_fields)
diff --git a/redis/auth/token_manager.py b/redis/auth/token_manager.py
new file mode 100644
index 0000000000..dd8d16233d
--- /dev/null
+++ b/redis/auth/token_manager.py
@@ -0,0 +1,370 @@
+import asyncio
+import logging
+import threading
+from datetime import datetime, timezone
+from time import sleep
+from typing import Any, Awaitable, Callable, Union
+
+from redis.auth.err import RequestTokenErr, TokenRenewalErr
+from redis.auth.idp import IdentityProviderInterface
+from redis.auth.token import TokenResponse
+
+logger = logging.getLogger(__name__)
+
+
+class CredentialsListener:
+    """
+    Listeners that will be notified on events related to credentials.
+    Accepts callbacks and awaitable callbacks.
+    """
+
+    def __init__(self):
+        self._on_next = None
+        self._on_error = None
+
+    @property
+    def on_next(self) -> Union[Callable[[Any], None], Awaitable]:
+        return self._on_next
+
+    @on_next.setter
+    def on_next(self, callback: Union[Callable[[Any], None], Awaitable]) -> None:
+        self._on_next = callback
+
+    @property
+    def on_error(self) -> Union[Callable[[Exception], None], Awaitable]:
+        return self._on_error
+
+    @on_error.setter
+    def on_error(self, callback: Union[Callable[[Exception], None], Awaitable]) -> None:
+        self._on_error = callback
+
+
+class RetryPolicy:
+    def __init__(self, max_attempts: int, delay_in_ms: float):
+        self.max_attempts = max_attempts
+        self.delay_in_ms = delay_in_ms
+
+    def get_max_attempts(self) -> int:
+        """
+        Retry attempts before exception will be thrown.
+
+        :return: int
+        """
+        return self.max_attempts
+
+    def get_delay_in_ms(self) -> float:
+        """
+        Delay between retries in seconds.
+
+        :return: int
+        """
+        return self.delay_in_ms
+
+
+class TokenManagerConfig:
+    def __init__(
+        self,
+        expiration_refresh_ratio: float,
+        lower_refresh_bound_millis: int,
+        token_request_execution_timeout_in_ms: int,
+        retry_policy: RetryPolicy,
+    ):
+        self._expiration_refresh_ratio = expiration_refresh_ratio
+        self._lower_refresh_bound_millis = lower_refresh_bound_millis
+        self._token_request_execution_timeout_in_ms = (
+            token_request_execution_timeout_in_ms
+        )
+        self._retry_policy = retry_policy
+
+    def get_expiration_refresh_ratio(self) -> float:
+        """
+        Represents the ratio of a token's lifetime at which a refresh should be triggered. # noqa: E501
+        For example, a value of 0.75 means the token should be refreshed
+        when 75% of its lifetime has elapsed (or when 25% of its lifetime remains).
+
+        :return: float
+        """
+
+        return self._expiration_refresh_ratio
+
+    def get_lower_refresh_bound_millis(self) -> int:
+        """
+        Represents the minimum time in milliseconds before token expiration
+        to trigger a refresh, in milliseconds.
+        This value sets a fixed lower bound for when a token refresh should occur,
+        regardless of the token's total lifetime.
+        If set to 0 there will be no lower bound and the refresh will be triggered
+        based on the expirationRefreshRatio only.
+
+        :return: int
+        """
+        return self._lower_refresh_bound_millis
+
+    def get_token_request_execution_timeout_in_ms(self) -> int:
+        """
+        Represents the maximum time in milliseconds to wait
+        for a token request to complete.
+
+        :return: int
+        """
+        return self._token_request_execution_timeout_in_ms
+
+    def get_retry_policy(self) -> RetryPolicy:
+        """
+        Represents the retry policy for token requests.
+
+        :return: RetryPolicy
+        """
+        return self._retry_policy
+
+
+class TokenManager:
+    def __init__(
+        self, identity_provider: IdentityProviderInterface, config: TokenManagerConfig
+    ):
+        self._idp = identity_provider
+        self._config = config
+        self._next_timer = None
+        self._listener = None
+        self._init_timer = None
+        self._retries = 0
+
+    def __del__(self):
+        logger.info("Token manager are disposed")
+        self.stop()
+
+    def start(
+        self,
+        listener: CredentialsListener,
+        skip_initial: bool = False,
+    ) -> Callable[[], None]:
+        self._listener = listener
+
+        try:
+            loop = asyncio.get_running_loop()
+        except RuntimeError:
+            # Run loop in a separate thread to unblock main thread.
+            loop = asyncio.new_event_loop()
+            thread = threading.Thread(
+                target=_start_event_loop_in_thread, args=(loop,), daemon=True
+            )
+            thread.start()
+
+        # Event to block for initial execution.
+        init_event = asyncio.Event()
+        self._init_timer = loop.call_later(
+            0, self._renew_token, skip_initial, init_event
+        )
+        logger.info("Token manager started")
+
+        # Blocks in thread-safe manner.
+        asyncio.run_coroutine_threadsafe(init_event.wait(), loop).result()
+        return self.stop
+
+    async def start_async(
+        self,
+        listener: CredentialsListener,
+        block_for_initial: bool = False,
+        initial_delay_in_ms: float = 0,
+        skip_initial: bool = False,
+    ) -> Callable[[], None]:
+        self._listener = listener
+
+        loop = asyncio.get_running_loop()
+        init_event = asyncio.Event()
+
+        # Wraps the async callback with async wrapper to schedule with loop.call_later()
+        wrapped = _async_to_sync_wrapper(
+            loop, self._renew_token_async, skip_initial, init_event
+        )
+        self._init_timer = loop.call_later(initial_delay_in_ms / 1000, wrapped)
+        logger.info("Token manager started")
+
+        if block_for_initial:
+            await init_event.wait()
+
+        return self.stop
+
+    def stop(self):
+        if self._init_timer is not None:
+            self._init_timer.cancel()
+        if self._next_timer is not None:
+            self._next_timer.cancel()
+
+    def acquire_token(self, force_refresh=False) -> TokenResponse:
+        try:
+            token = self._idp.request_token(force_refresh)
+        except RequestTokenErr as e:
+            if self._retries < self._config.get_retry_policy().get_max_attempts():
+                self._retries += 1
+                sleep(self._config.get_retry_policy().get_delay_in_ms() / 1000)
+                return self.acquire_token(force_refresh)
+            else:
+                raise e
+
+        self._retries = 0
+        return TokenResponse(token)
+
+    async def acquire_token_async(self, force_refresh=False) -> TokenResponse:
+        try:
+            token = self._idp.request_token(force_refresh)
+        except RequestTokenErr as e:
+            if self._retries < self._config.get_retry_policy().get_max_attempts():
+                self._retries += 1
+                await asyncio.sleep(
+                    self._config.get_retry_policy().get_delay_in_ms() / 1000
+                )
+                return await self.acquire_token_async(force_refresh)
+            else:
+                raise e
+
+        self._retries = 0
+        return TokenResponse(token)
+
+    def _calculate_renewal_delay(self, expire_date: float, issue_date: float) -> float:
+        delay_for_lower_refresh = self._delay_for_lower_refresh(expire_date)
+        delay_for_ratio_refresh = self._delay_for_ratio_refresh(expire_date, issue_date)
+        delay = min(delay_for_ratio_refresh, delay_for_lower_refresh)
+
+        return 0 if delay < 0 else delay / 1000
+
+    def _delay_for_lower_refresh(self, expire_date: float):
+        return (
+            expire_date
+            - self._config.get_lower_refresh_bound_millis()
+            - (datetime.now(timezone.utc).timestamp() * 1000)
+        )
+
+    def _delay_for_ratio_refresh(self, expire_date: float, issue_date: float):
+        token_ttl = expire_date - issue_date
+        refresh_before = token_ttl - (
+            token_ttl * self._config.get_expiration_refresh_ratio()
+        )
+
+        return (
+            expire_date
+            - refresh_before
+            - (datetime.now(timezone.utc).timestamp() * 1000)
+        )
+
+    def _renew_token(
+        self, skip_initial: bool = False, init_event: asyncio.Event = None
+    ):
+        """
+        Task to renew token from identity provider.
+        Schedules renewal tasks based on token TTL.
+        """
+
+        try:
+            token_res = self.acquire_token(force_refresh=True)
+            delay = self._calculate_renewal_delay(
+                token_res.get_token().get_expires_at_ms(),
+                token_res.get_token().get_received_at_ms(),
+            )
+
+            if token_res.get_token().is_expired():
+                raise TokenRenewalErr("Requested token is expired")
+
+            if self._listener.on_next is None:
+                logger.warning(
+                    "No registered callback for token renewal task. Renewal cancelled"
+                )
+                return
+
+            if not skip_initial:
+                try:
+                    self._listener.on_next(token_res.get_token())
+                except Exception as e:
+                    raise TokenRenewalErr(e)
+
+            if delay <= 0:
+                return
+
+            loop = asyncio.get_running_loop()
+            self._next_timer = loop.call_later(delay, self._renew_token)
+            logger.info(f"Next token renewal scheduled in {delay} seconds")
+            return token_res
+        except Exception as e:
+            if self._listener.on_error is None:
+                raise e
+
+            self._listener.on_error(e)
+        finally:
+            if init_event:
+                init_event.set()
+
+    async def _renew_token_async(
+        self, skip_initial: bool = False, init_event: asyncio.Event = None
+    ):
+        """
+        Async task to renew tokens from identity provider.
+        Schedules renewal tasks based on token TTL.
+        """
+
+        try:
+            token_res = await self.acquire_token_async(force_refresh=True)
+            delay = self._calculate_renewal_delay(
+                token_res.get_token().get_expires_at_ms(),
+                token_res.get_token().get_received_at_ms(),
+            )
+
+            if token_res.get_token().is_expired():
+                raise TokenRenewalErr("Requested token is expired")
+
+            if self._listener.on_next is None:
+                logger.warning(
+                    "No registered callback for token renewal task. Renewal cancelled"
+                )
+                return
+
+            if not skip_initial:
+                try:
+                    await self._listener.on_next(token_res.get_token())
+                except Exception as e:
+                    raise TokenRenewalErr(e)
+
+            if delay <= 0:
+                return
+
+            loop = asyncio.get_running_loop()
+            wrapped = _async_to_sync_wrapper(loop, self._renew_token_async)
+            logger.info(f"Next token renewal scheduled in {delay} seconds")
+            loop.call_later(delay, wrapped)
+        except Exception as e:
+            if self._listener.on_error is None:
+                raise e
+
+            await self._listener.on_error(e)
+        finally:
+            if init_event:
+                init_event.set()
+
+
+def _async_to_sync_wrapper(loop, coro_func, *args, **kwargs):
+    """
+    Wraps an asynchronous function so it can be used with loop.call_later.
+
+    :param loop: The event loop in which the coroutine will be executed.
+    :param coro_func: The coroutine function to wrap.
+    :param args: Positional arguments to pass to the coroutine function.
+    :param kwargs: Keyword arguments to pass to the coroutine function.
+    :return: A regular function suitable for loop.call_later.
+    """
+
+    def wrapped():
+        # Schedule the coroutine in the event loop
+        asyncio.ensure_future(coro_func(*args, **kwargs), loop=loop)
+
+    return wrapped
+
+
+def _start_event_loop_in_thread(event_loop: asyncio.AbstractEventLoop):
+    """
+    Starts event loop in a thread.
+    Used to be able to schedule tasks using loop.call_later.
+
+    :param event_loop:
+    :return:
+    """
+    asyncio.set_event_loop(event_loop)
+    event_loop.run_forever()
diff --git a/redis/client.py b/redis/client.py
index bf3432e7eb..a7c1364a10 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -27,6 +27,13 @@
     UnixDomainSocketConnection,
 )
 from redis.credentials import CredentialProvider
+from redis.event import (
+    AfterPooledConnectionsInstantiationEvent,
+    AfterPubSubConnectionInstantiationEvent,
+    AfterSingleConnectionInstantiationEvent,
+    ClientType,
+    EventDispatcher,
+)
 from redis.exceptions import (
     ConnectionError,
     ExecAbortError,
@@ -213,6 +220,7 @@ def __init__(
         protocol: Optional[int] = 2,
         cache: Optional[CacheInterface] = None,
         cache_config: Optional[CacheConfig] = None,
+        event_dispatcher: Optional[EventDispatcher] = None,
     ) -> None:
         """
         Initialize a new Redis client.
@@ -227,6 +235,10 @@ def __init__(
             if `True`, connection pool is not used. In that case `Redis`
             instance use is not thread safe.
         """
+        if event_dispatcher is None:
+            self._event_dispatcher = EventDispatcher()
+        else:
+            self._event_dispatcher = event_dispatcher
         if not connection_pool:
             if charset is not None:
                 warnings.warn(
@@ -313,9 +325,19 @@ def __init__(
                         }
                     )
             connection_pool = ConnectionPool(**kwargs)
+            self._event_dispatcher.dispatch(
+                AfterPooledConnectionsInstantiationEvent(
+                    [connection_pool], ClientType.SYNC, credential_provider
+                )
+            )
             self.auto_close_connection_pool = True
         else:
             self.auto_close_connection_pool = False
+            self._event_dispatcher.dispatch(
+                AfterPooledConnectionsInstantiationEvent(
+                    [connection_pool], ClientType.SYNC, credential_provider
+                )
+            )
 
         self.connection_pool = connection_pool
 
@@ -325,9 +347,16 @@ def __init__(
         ]:
             raise RedisError("Client caching is only supported with RESP version 3")
 
+        self.single_connection_lock = threading.Lock()
         self.connection = None
-        if single_connection_client:
+        self._single_connection_client = single_connection_client
+        if self._single_connection_client:
             self.connection = self.connection_pool.get_connection("_")
+            self._event_dispatcher.dispatch(
+                AfterSingleConnectionInstantiationEvent(
+                    self.connection, ClientType.SYNC, self.single_connection_lock
+                )
+            )
 
         self.response_callbacks = CaseInsensitiveDict(_RedisCallbacks)
 
@@ -500,7 +529,9 @@ def pubsub(self, **kwargs):
         subscribe to channels and listen for messages that get published to
         them.
         """
-        return PubSub(self.connection_pool, **kwargs)
+        return PubSub(
+            self.connection_pool, event_dispatcher=self._event_dispatcher, **kwargs
+        )
 
     def monitor(self):
         return Monitor(self.connection_pool)
@@ -563,6 +594,9 @@ def _execute_command(self, *args, **options):
         pool = self.connection_pool
         command_name = args[0]
         conn = self.connection or pool.get_connection(command_name, **options)
+
+        if self._single_connection_client:
+            self.single_connection_lock.acquire()
         try:
             return conn.retry.call_with_retry(
                 lambda: self._send_command_parse_response(
@@ -571,6 +605,8 @@ def _execute_command(self, *args, **options):
                 lambda error: self._disconnect_raise(conn, error),
             )
         finally:
+            if self._single_connection_client:
+                self.single_connection_lock.release()
             if not self.connection:
                 pool.release(conn)
 
@@ -691,6 +727,7 @@ def __init__(
         ignore_subscribe_messages: bool = False,
         encoder: Optional["Encoder"] = None,
         push_handler_func: Union[None, Callable[[str], None]] = None,
+        event_dispatcher: Optional["EventDispatcher"] = None,
     ):
         self.connection_pool = connection_pool
         self.shard_hint = shard_hint
@@ -701,6 +738,11 @@ def __init__(
         # to lookup channel and pattern names for callback handlers.
         self.encoder = encoder
         self.push_handler_func = push_handler_func
+        if event_dispatcher is None:
+            self._event_dispatcher = EventDispatcher()
+        else:
+            self._event_dispatcher = event_dispatcher
+        self._lock = threading.Lock()
         if self.encoder is None:
             self.encoder = self.connection_pool.get_encoder()
         self.health_check_response_b = self.encoder.encode(self.HEALTH_CHECK_MESSAGE)
@@ -791,11 +833,17 @@ def execute_command(self, *args):
             self.connection.register_connect_callback(self.on_connect)
             if self.push_handler_func is not None and not HIREDIS_AVAILABLE:
                 self.connection._parser.set_pubsub_push_handler(self.push_handler_func)
+            self._event_dispatcher.dispatch(
+                AfterPubSubConnectionInstantiationEvent(
+                    self.connection, self.connection_pool, ClientType.SYNC, self._lock
+                )
+            )
         connection = self.connection
         kwargs = {"check_health": not self.subscribed}
         if not self.subscribed:
             self.clean_health_check_responses()
-        self._execute(connection, connection.send_command, *args, **kwargs)
+        with self._lock:
+            self._execute(connection, connection.send_command, *args, **kwargs)
 
     def clean_health_check_responses(self) -> None:
         """
diff --git a/redis/cluster.py b/redis/cluster.py
index 9dcbad7fc1..38bd5dde1a 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -15,6 +15,12 @@
 from redis.commands.helpers import list_or_args
 from redis.connection import ConnectionPool, DefaultParser, parse_url
 from redis.crc import REDIS_CLUSTER_HASH_SLOTS, key_slot
+from redis.event import (
+    AfterPooledConnectionsInstantiationEvent,
+    AfterPubSubConnectionInstantiationEvent,
+    ClientType,
+    EventDispatcher,
+)
 from redis.exceptions import (
     AskError,
     AuthenticationError,
@@ -505,6 +511,7 @@ def __init__(
         address_remap: Optional[Callable[[Tuple[str, int]], Tuple[str, int]]] = None,
         cache: Optional[CacheInterface] = None,
         cache_config: Optional[CacheConfig] = None,
+        event_dispatcher: Optional[EventDispatcher] = None,
         **kwargs,
     ):
         """
@@ -638,6 +645,10 @@ def __init__(
         self.read_from_replicas = read_from_replicas
         self.reinitialize_counter = 0
         self.reinitialize_steps = reinitialize_steps
+        if event_dispatcher is None:
+            self._event_dispatcher = EventDispatcher()
+        else:
+            self._event_dispatcher = event_dispatcher
         self.nodes_manager = NodesManager(
             startup_nodes=startup_nodes,
             from_url=from_url,
@@ -646,6 +657,7 @@ def __init__(
             address_remap=address_remap,
             cache=cache,
             cache_config=cache_config,
+            event_dispatcher=self._event_dispatcher,
             **kwargs,
         )
 
@@ -1332,6 +1344,7 @@ def __init__(
         cache: Optional[CacheInterface] = None,
         cache_config: Optional[CacheConfig] = None,
         cache_factory: Optional[CacheFactoryInterface] = None,
+        event_dispatcher: Optional[EventDispatcher] = None,
         **kwargs,
     ):
         self.nodes_cache = {}
@@ -1353,6 +1366,13 @@ def __init__(
         if lock is None:
             lock = threading.Lock()
         self._lock = lock
+        if event_dispatcher is None:
+            self._event_dispatcher = EventDispatcher()
+        else:
+            self._event_dispatcher = event_dispatcher
+        self._credential_provider = self.connection_kwargs.get(
+            "credential_provider", None
+        )
         self.initialize()
 
     def get_node(self, host=None, port=None, node_name=None):
@@ -1479,11 +1499,19 @@ def create_redis_connections(self, nodes):
         """
         This function will create a redis connection to all nodes in :nodes:
         """
+        connection_pools = []
         for node in nodes:
             if node.redis_connection is None:
                 node.redis_connection = self.create_redis_node(
                     host=node.host, port=node.port, **self.connection_kwargs
                 )
+                connection_pools.append(node.redis_connection.connection_pool)
+
+        self._event_dispatcher.dispatch(
+            AfterPooledConnectionsInstantiationEvent(
+                connection_pools, ClientType.SYNC, self._credential_provider
+            )
+        )
 
     def create_redis_node(self, host, port, **kwargs):
         if self.from_url:
@@ -1698,6 +1726,7 @@ def __init__(
         host=None,
         port=None,
         push_handler_func=None,
+        event_dispatcher: Optional["EventDispatcher"] = None,
         **kwargs,
     ):
         """
@@ -1723,10 +1752,15 @@ def __init__(
         self.cluster = redis_cluster
         self.node_pubsub_mapping = {}
         self._pubsubs_generator = self._pubsubs_generator()
+        if event_dispatcher is None:
+            self._event_dispatcher = EventDispatcher()
+        else:
+            self._event_dispatcher = event_dispatcher
         super().__init__(
             connection_pool=connection_pool,
             encoder=redis_cluster.encoder,
             push_handler_func=push_handler_func,
+            event_dispatcher=self._event_dispatcher,
             **kwargs,
         )
 
@@ -1813,6 +1847,11 @@ def execute_command(self, *args):
             self.connection.register_connect_callback(self.on_connect)
             if self.push_handler_func is not None and not HIREDIS_AVAILABLE:
                 self.connection._parser.set_pubsub_push_handler(self.push_handler_func)
+            self._event_dispatcher.dispatch(
+                AfterPubSubConnectionInstantiationEvent(
+                    self.connection, self.connection_pool, ClientType.SYNC, self._lock
+                )
+            )
         connection = self.connection
         self._execute(connection, connection.send_command, *args)
 
diff --git a/redis/connection.py b/redis/connection.py
index 40f2d29722..9d29b4aba6 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -22,8 +22,10 @@
 )
 
 from ._parsers import Encoder, _HiredisParser, _RESP2Parser, _RESP3Parser
+from .auth.token import TokenInterface
 from .backoff import NoBackoff
 from .credentials import CredentialProvider, UsernamePasswordCredentialProvider
+from .event import AfterConnectionReleasedEvent, EventDispatcher
 from .exceptions import (
     AuthenticationError,
     AuthenticationWrongNumberOfArgsError,
@@ -151,6 +153,10 @@ def deregister_connect_callback(self, callback):
     def set_parser(self, parser_class):
         pass
 
+    @abstractmethod
+    def get_protocol(self):
+        pass
+
     @abstractmethod
     def connect(self):
         pass
@@ -202,6 +208,14 @@ def pack_commands(self, commands):
     def handshake_metadata(self) -> Union[Dict[bytes, bytes], Dict[str, str]]:
         pass
 
+    @abstractmethod
+    def set_re_auth_token(self, token: TokenInterface):
+        pass
+
+    @abstractmethod
+    def re_auth(self):
+        pass
+
 
 class AbstractConnection(ConnectionInterface):
     "Manages communication to and from a Redis server"
@@ -229,6 +243,7 @@ def __init__(
         credential_provider: Optional[CredentialProvider] = None,
         protocol: Optional[int] = 2,
         command_packer: Optional[Callable[[], None]] = None,
+        event_dispatcher: Optional[EventDispatcher] = None,
     ):
         """
         Initialize a new Connection.
@@ -244,6 +259,10 @@ def __init__(
                 "1. 'password' and (optional) 'username'\n"
                 "2. 'credential_provider'"
             )
+        if event_dispatcher is None:
+            self._event_dispatcher = EventDispatcher()
+        else:
+            self._event_dispatcher = event_dispatcher
         self.pid = os.getpid()
         self.db = db
         self.client_name = client_name
@@ -283,6 +302,7 @@ def __init__(
         self.set_parser(parser_class)
         self._connect_callbacks = []
         self._buffer_cutoff = 6000
+        self._re_auth_token: Optional[TokenInterface] = None
         try:
             p = int(protocol)
         except TypeError:
@@ -663,6 +683,19 @@ def handshake_metadata(self) -> Union[Dict[bytes, bytes], Dict[str, str]]:
     def handshake_metadata(self, value: Union[Dict[bytes, bytes], Dict[str, str]]):
         self._handshake_metadata = value
 
+    def set_re_auth_token(self, token: TokenInterface):
+        self._re_auth_token = token
+
+    def re_auth(self):
+        if self._re_auth_token is not None:
+            self.send_command(
+                "AUTH",
+                self._re_auth_token.try_get("oid"),
+                self._re_auth_token.get_value(),
+            )
+            self.read_response()
+            self._re_auth_token = None
+
 
 class Connection(AbstractConnection):
     "Manages TCP communication to and from a Redis server"
@@ -750,6 +783,7 @@ def __init__(
         self.retry = self._conn.retry
         self.host = self._conn.host
         self.port = self._conn.port
+        self.credential_provider = conn.credential_provider
         self._pool_lock = pool_lock
         self._cache = cache
         self._cache_lock = threading.Lock()
@@ -933,6 +967,15 @@ def _on_invalidation_callback(self, data: List[Union[str, Optional[List[bytes]]]
             else:
                 self._cache.delete_by_redis_keys(data[1])
 
+    def get_protocol(self):
+        return self._conn.get_protocol()
+
+    def set_re_auth_token(self, token: TokenInterface):
+        self._conn.set_re_auth_token(token)
+
+    def re_auth(self):
+        self._conn.re_auth()
+
 
 class SSLConnection(Connection):
     """Manages SSL connections to and from the Redis server(s).
@@ -1318,6 +1361,10 @@ def __init__(
         connection_kwargs.pop("cache", None)
         connection_kwargs.pop("cache_config", None)
 
+        self._event_dispatcher = self.connection_kwargs.get("event_dispatcher", None)
+        if self._event_dispatcher is None:
+            self._event_dispatcher = EventDispatcher()
+
         # a lock to protect the critical section in _checkpid().
         # this lock is acquired when the process id changes, such as
         # after a fork. during this time, multiple threads in the child
@@ -1475,6 +1522,9 @@ def release(self, connection: "Connection") -> None:
 
             if self.owns_connection(connection):
                 self._available_connections.append(connection)
+                self._event_dispatcher.dispatch(
+                    AfterConnectionReleasedEvent(connection)
+                )
             else:
                 # pool doesn't own this connection. do not add it back
                 # to the pool and decrement the count so that another
@@ -1517,6 +1567,29 @@ def set_retry(self, retry: "Retry") -> None:
         for conn in self._in_use_connections:
             conn.retry = retry
 
+    def re_auth_callback(self, token: TokenInterface):
+        with self._lock:
+            for conn in self._available_connections:
+                conn.retry.call_with_retry(
+                    lambda: conn.send_command(
+                        "AUTH", token.try_get("oid"), token.get_value()
+                    ),
+                    lambda error: self._mock(error),
+                )
+                conn.retry.call_with_retry(
+                    lambda: conn.read_response(), lambda error: self._mock(error)
+                )
+            for conn in self._in_use_connections:
+                conn.set_re_auth_token(token)
+
+    async def _mock(self, error: RedisError):
+        """
+        Dummy functions, needs to be passed as error callback to retry object.
+        :param error:
+        :return:
+        """
+        pass
+
 
 class BlockingConnectionPool(ConnectionPool):
     """
diff --git a/redis/credentials.py b/redis/credentials.py
index 7ba26dcde1..6e59454ed3 100644
--- a/redis/credentials.py
+++ b/redis/credentials.py
@@ -1,4 +1,8 @@
-from typing import Optional, Tuple, Union
+import logging
+from abc import ABC, abstractmethod
+from typing import Any, Callable, Optional, Tuple, Union
+
+logger = logging.getLogger(__name__)
 
 
 class CredentialProvider:
@@ -9,6 +13,38 @@ class CredentialProvider:
     def get_credentials(self) -> Union[Tuple[str], Tuple[str, str]]:
         raise NotImplementedError("get_credentials must be implemented")
 
+    async def get_credentials_async(self) -> Union[Tuple[str], Tuple[str, str]]:
+        logger.warning(
+            "This method is added for backward compatability. "
+            "Please override it in your implementation."
+        )
+        return self.get_credentials()
+
+
+class StreamingCredentialProvider(CredentialProvider, ABC):
+    """
+    Credential provider that streams credentials in the background.
+    """
+
+    @abstractmethod
+    def on_next(self, callback: Callable[[Any], None]):
+        """
+        Specifies the callback that should be invoked
+        when the next credentials will be retrieved.
+
+        :param callback: Callback with
+        :return:
+        """
+        pass
+
+    @abstractmethod
+    def on_error(self, callback: Callable[[Exception], None]):
+        pass
+
+    @abstractmethod
+    def is_streaming(self) -> bool:
+        pass
+
 
 class UsernamePasswordCredentialProvider(CredentialProvider):
     """
@@ -24,3 +60,6 @@ def get_credentials(self):
         if self.username:
             return self.username, self.password
         return (self.password,)
+
+    async def get_credentials_async(self) -> Union[Tuple[str], Tuple[str, str]]:
+        return self.get_credentials()
diff --git a/redis/event.py b/redis/event.py
new file mode 100644
index 0000000000..5cc6c0017c
--- /dev/null
+++ b/redis/event.py
@@ -0,0 +1,394 @@
+import asyncio
+import threading
+from abc import ABC, abstractmethod
+from enum import Enum
+from typing import List, Optional, Union
+
+from redis.auth.token import TokenInterface
+from redis.credentials import CredentialProvider, StreamingCredentialProvider
+
+
+class EventListenerInterface(ABC):
+    """
+    Represents a listener for given event object.
+    """
+
+    @abstractmethod
+    def listen(self, event: object):
+        pass
+
+
+class AsyncEventListenerInterface(ABC):
+    """
+    Represents an async listener for given event object.
+    """
+
+    @abstractmethod
+    async def listen(self, event: object):
+        pass
+
+
+class EventDispatcherInterface(ABC):
+    """
+    Represents a dispatcher that dispatches events to listeners
+    associated with given event.
+    """
+
+    @abstractmethod
+    def dispatch(self, event: object):
+        pass
+
+    @abstractmethod
+    async def dispatch_async(self, event: object):
+        pass
+
+
+class EventException(Exception):
+    """
+    Exception wrapper that adds an event object into exception context.
+    """
+
+    def __init__(self, exception: Exception, event: object):
+        self.exception = exception
+        self.event = event
+        super().__init__(exception)
+
+
+class EventDispatcher(EventDispatcherInterface):
+    # TODO: Make dispatcher to accept external mappings.
+    def __init__(self):
+        """
+        Mapping should be extended for any new events or listeners to be added.
+        """
+        self._event_listeners_mapping = {
+            AfterConnectionReleasedEvent: [
+                ReAuthConnectionListener(),
+            ],
+            AfterPooledConnectionsInstantiationEvent: [
+                RegisterReAuthForPooledConnections()
+            ],
+            AfterSingleConnectionInstantiationEvent: [
+                RegisterReAuthForSingleConnection()
+            ],
+            AfterPubSubConnectionInstantiationEvent: [RegisterReAuthForPubSub()],
+            AfterAsyncClusterInstantiationEvent: [RegisterReAuthForAsyncClusterNodes()],
+            AsyncAfterConnectionReleasedEvent: [
+                AsyncReAuthConnectionListener(),
+            ],
+        }
+
+    def dispatch(self, event: object):
+        listeners = self._event_listeners_mapping.get(type(event))
+
+        for listener in listeners:
+            listener.listen(event)
+
+    async def dispatch_async(self, event: object):
+        listeners = self._event_listeners_mapping.get(type(event))
+
+        for listener in listeners:
+            await listener.listen(event)
+
+
+class AfterConnectionReleasedEvent:
+    """
+    Event that will be fired before each command execution.
+    """
+
+    def __init__(self, connection):
+        self._connection = connection
+
+    @property
+    def connection(self):
+        return self._connection
+
+
+class AsyncAfterConnectionReleasedEvent(AfterConnectionReleasedEvent):
+    pass
+
+
+class ClientType(Enum):
+    SYNC = ("sync",)
+    ASYNC = ("async",)
+
+
+class AfterPooledConnectionsInstantiationEvent:
+    """
+    Event that will be fired after pooled connection instances was created.
+    """
+
+    def __init__(
+        self,
+        connection_pools: List,
+        client_type: ClientType,
+        credential_provider: Optional[CredentialProvider] = None,
+    ):
+        self._connection_pools = connection_pools
+        self._client_type = client_type
+        self._credential_provider = credential_provider
+
+    @property
+    def connection_pools(self):
+        return self._connection_pools
+
+    @property
+    def client_type(self) -> ClientType:
+        return self._client_type
+
+    @property
+    def credential_provider(self) -> Union[CredentialProvider, None]:
+        return self._credential_provider
+
+
+class AfterSingleConnectionInstantiationEvent:
+    """
+    Event that will be fired after single connection instances was created.
+
+    :param connection_lock: For sync client thread-lock should be provided,
+    for async asyncio.Lock
+    """
+
+    def __init__(
+        self,
+        connection,
+        client_type: ClientType,
+        connection_lock: Union[threading.Lock, asyncio.Lock],
+    ):
+        self._connection = connection
+        self._client_type = client_type
+        self._connection_lock = connection_lock
+
+    @property
+    def connection(self):
+        return self._connection
+
+    @property
+    def client_type(self) -> ClientType:
+        return self._client_type
+
+    @property
+    def connection_lock(self) -> Union[threading.Lock, asyncio.Lock]:
+        return self._connection_lock
+
+
+class AfterPubSubConnectionInstantiationEvent:
+    def __init__(
+        self,
+        pubsub_connection,
+        connection_pool,
+        client_type: ClientType,
+        connection_lock: Union[threading.Lock, asyncio.Lock],
+    ):
+        self._pubsub_connection = pubsub_connection
+        self._connection_pool = connection_pool
+        self._client_type = client_type
+        self._connection_lock = connection_lock
+
+    @property
+    def pubsub_connection(self):
+        return self._pubsub_connection
+
+    @property
+    def connection_pool(self):
+        return self._connection_pool
+
+    @property
+    def client_type(self) -> ClientType:
+        return self._client_type
+
+    @property
+    def connection_lock(self) -> Union[threading.Lock, asyncio.Lock]:
+        return self._connection_lock
+
+
+class AfterAsyncClusterInstantiationEvent:
+    """
+    Event that will be fired after async cluster instance was created.
+
+    Async cluster doesn't use connection pools,
+    instead ClusterNode object manages connections.
+    """
+
+    def __init__(
+        self,
+        nodes: dict,
+        credential_provider: Optional[CredentialProvider] = None,
+    ):
+        self._nodes = nodes
+        self._credential_provider = credential_provider
+
+    @property
+    def nodes(self) -> dict:
+        return self._nodes
+
+    @property
+    def credential_provider(self) -> Union[CredentialProvider, None]:
+        return self._credential_provider
+
+
+class ReAuthConnectionListener(EventListenerInterface):
+    """
+    Listener that performs re-authentication of given connection.
+    """
+
+    def listen(self, event: AfterConnectionReleasedEvent):
+        event.connection.re_auth()
+
+
+class AsyncReAuthConnectionListener(AsyncEventListenerInterface):
+    """
+    Async listener that performs re-authentication of given connection.
+    """
+
+    async def listen(self, event: AsyncAfterConnectionReleasedEvent):
+        await event.connection.re_auth()
+
+
+class RegisterReAuthForPooledConnections(EventListenerInterface):
+    """
+    Listener that registers a re-authentication callback for pooled connections.
+    Required by :class:`StreamingCredentialProvider`.
+    """
+
+    def __init__(self):
+        self._event = None
+
+    def listen(self, event: AfterPooledConnectionsInstantiationEvent):
+        if isinstance(event.credential_provider, StreamingCredentialProvider):
+            self._event = event
+
+            if event.client_type == ClientType.SYNC:
+                event.credential_provider.on_next(self._re_auth)
+                event.credential_provider.on_error(self._raise_on_error)
+            else:
+                event.credential_provider.on_next(self._re_auth_async)
+                event.credential_provider.on_error(self._raise_on_error_async)
+
+    def _re_auth(self, token):
+        for pool in self._event.connection_pools:
+            pool.re_auth_callback(token)
+
+    async def _re_auth_async(self, token):
+        for pool in self._event.connection_pools:
+            await pool.re_auth_callback(token)
+
+    def _raise_on_error(self, error: Exception):
+        raise EventException(error, self._event)
+
+    async def _raise_on_error_async(self, error: Exception):
+        raise EventException(error, self._event)
+
+
+class RegisterReAuthForSingleConnection(EventListenerInterface):
+    """
+    Listener that registers a re-authentication callback for single connection.
+    Required by :class:`StreamingCredentialProvider`.
+    """
+
+    def __init__(self):
+        self._event = None
+
+    def listen(self, event: AfterSingleConnectionInstantiationEvent):
+        if isinstance(
+            event.connection.credential_provider, StreamingCredentialProvider
+        ):
+            self._event = event
+
+            if event.client_type == ClientType.SYNC:
+                event.connection.credential_provider.on_next(self._re_auth)
+                event.connection.credential_provider.on_error(self._raise_on_error)
+            else:
+                event.connection.credential_provider.on_next(self._re_auth_async)
+                event.connection.credential_provider.on_error(
+                    self._raise_on_error_async
+                )
+
+    def _re_auth(self, token):
+        with self._event.connection_lock:
+            self._event.connection.send_command(
+                "AUTH", token.try_get("oid"), token.get_value()
+            )
+            self._event.connection.read_response()
+
+    async def _re_auth_async(self, token):
+        async with self._event.connection_lock:
+            await self._event.connection.send_command(
+                "AUTH", token.try_get("oid"), token.get_value()
+            )
+            await self._event.connection.read_response()
+
+    def _raise_on_error(self, error: Exception):
+        raise EventException(error, self._event)
+
+    async def _raise_on_error_async(self, error: Exception):
+        raise EventException(error, self._event)
+
+
+class RegisterReAuthForAsyncClusterNodes(EventListenerInterface):
+    def __init__(self):
+        self._event = None
+
+    def listen(self, event: AfterAsyncClusterInstantiationEvent):
+        if isinstance(event.credential_provider, StreamingCredentialProvider):
+            self._event = event
+            event.credential_provider.on_next(self._re_auth)
+            event.credential_provider.on_error(self._raise_on_error)
+
+    async def _re_auth(self, token: TokenInterface):
+        for key in self._event.nodes:
+            await self._event.nodes[key].re_auth_callback(token)
+
+    async def _raise_on_error(self, error: Exception):
+        raise EventException(error, self._event)
+
+
+class RegisterReAuthForPubSub(EventListenerInterface):
+    def __init__(self):
+        self._connection = None
+        self._connection_pool = None
+        self._client_type = None
+        self._connection_lock = None
+        self._event = None
+
+    def listen(self, event: AfterPubSubConnectionInstantiationEvent):
+        if isinstance(
+            event.pubsub_connection.credential_provider, StreamingCredentialProvider
+        ) and event.pubsub_connection.get_protocol() in [3, "3"]:
+            self._event = event
+            self._connection = event.pubsub_connection
+            self._connection_pool = event.connection_pool
+            self._client_type = event.client_type
+            self._connection_lock = event.connection_lock
+
+            if self._client_type == ClientType.SYNC:
+                self._connection.credential_provider.on_next(self._re_auth)
+                self._connection.credential_provider.on_error(self._raise_on_error)
+            else:
+                self._connection.credential_provider.on_next(self._re_auth_async)
+                self._connection.credential_provider.on_error(
+                    self._raise_on_error_async
+                )
+
+    def _re_auth(self, token: TokenInterface):
+        with self._connection_lock:
+            self._connection.send_command(
+                "AUTH", token.try_get("oid"), token.get_value()
+            )
+            self._connection.read_response()
+
+        self._connection_pool.re_auth_callback(token)
+
+    async def _re_auth_async(self, token: TokenInterface):
+        async with self._connection_lock:
+            await self._connection.send_command(
+                "AUTH", token.try_get("oid"), token.get_value()
+            )
+            await self._connection.read_response()
+
+        await self._connection_pool.re_auth_callback(token)
+
+    def _raise_on_error(self, error: Exception):
+        raise EventException(error, self._event)
+
+    async def _raise_on_error_async(self, error: Exception):
+        raise EventException(error, self._event)
diff --git a/requirements.txt b/requirements.txt
index 622f70b810..9760e5bb13 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1 +1,2 @@
-async-timeout>=4.0.3
\ No newline at end of file
+async-timeout>=4.0.3
+PyJWT~=2.9.0
\ No newline at end of file
diff --git a/setup.py b/setup.py
index 8036b64066..ee3a7c2023 100644
--- a/setup.py
+++ b/setup.py
@@ -14,6 +14,7 @@
             "redis",
             "redis._parsers",
             "redis.asyncio",
+            "redis.auth",
             "redis.commands",
             "redis.commands.bf",
             "redis.commands.json",
diff --git a/tests/conftest.py b/tests/conftest.py
index 7c65898856..a900cea8bf 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -1,15 +1,22 @@
 import argparse
+import json
+import os
 import random
 import time
+from datetime import datetime, timezone
+from enum import Enum
 from typing import Callable, TypeVar
 from unittest import mock
 from unittest.mock import Mock
 from urllib.parse import urlparse
 
+import jwt
 import pytest
 import redis
 from packaging.version import Version
 from redis import Sentinel
+from redis.auth.idp import IdentityProviderInterface
+from redis.auth.token import JWToken
 from redis.backoff import NoBackoff
 from redis.cache import (
     CacheConfig,
@@ -19,8 +26,16 @@
     EvictionPolicy,
 )
 from redis.connection import Connection, ConnectionInterface, SSLConnection, parse_url
+from redis.credentials import CredentialProvider
 from redis.exceptions import RedisClusterException
 from redis.retry import Retry
+from redis_entraid.cred_provider import EntraIdCredentialsProvider, TokenAuthConfig
+from redis_entraid.identity_provider import (
+    ManagedIdentityIdType,
+    ManagedIdentityType,
+    create_provider_from_managed_identity,
+    create_provider_from_service_principal,
+)
 from tests.ssl_utils import get_tls_certificates
 
 REDIS_INFO = {}
@@ -36,6 +51,11 @@
 _TestDecorator = Callable[[_DecoratedTest], _DecoratedTest]
 
 
+class AuthType(Enum):
+    MANAGED_IDENTITY = "managed_identity"
+    SERVICE_PRINCIPAL = "service_principal"
+
+
 # Taken from python3.9
 class BooleanOptionalAction(argparse.Action):
     def __init__(
@@ -149,6 +169,13 @@ def pytest_addoption(parser):
         help="Name of the Redis master service that the sentinels are monitoring",
     )
 
+    parser.addoption(
+        "--endpoint-name",
+        action="store",
+        default=None,
+        help="Name of the Redis endpoint the tests should be executed on",
+    )
+
 
 def _get_info(redis_url):
     client = redis.Redis.from_url(redis_url)
@@ -296,12 +323,14 @@ def skip_ifnot_redis_enterprise() -> _TestDecorator:
 
 
 def skip_if_nocryptography() -> _TestDecorator:
-    try:
-        import cryptography  # noqa
-
-        return pytest.mark.skipif(False, reason="Cryptography dependency found")
-    except ImportError:
-        return pytest.mark.skipif(True, reason="No cryptography dependency")
+    # try:
+    #     import cryptography  # noqa
+    #
+    #     return pytest.mark.skipif(False, reason="Cryptography dependency found")
+    # except ImportError:
+    # TODO: Because JWT library depends on cryptography,
+    #  now it's always true and tests should be fixed
+    return pytest.mark.skipif(True, reason="No cryptography dependency")
 
 
 def skip_if_cryptography() -> _TestDecorator:
@@ -575,6 +604,142 @@ def cache_key(request) -> CacheKey:
     return CacheKey(command, keys)
 
 
+def mock_identity_provider() -> IdentityProviderInterface:
+    mock_provider = Mock(spec=IdentityProviderInterface)
+    token = {"exp": datetime.now(timezone.utc).timestamp() + 3600, "oid": "username"}
+    encoded = jwt.encode(token, "secret", algorithm="HS256")
+    jwt_token = JWToken(encoded)
+    mock_provider.request_token.return_value = jwt_token
+    return mock_provider
+
+
+def identity_provider(request) -> IdentityProviderInterface:
+    if hasattr(request, "param"):
+        kwargs = request.param.get("idp_kwargs", {})
+    else:
+        kwargs = {}
+
+    if request.param.get("mock_idp", None) is not None:
+        return mock_identity_provider()
+
+    auth_type = kwargs.pop("auth_type", AuthType.SERVICE_PRINCIPAL)
+
+    if auth_type == "MANAGED_IDENTITY":
+        return _get_managed_identity_provider(request)
+
+    return _get_service_principal_provider(request)
+
+
+def _get_managed_identity_provider(request):
+    authority = os.getenv("AZURE_AUTHORITY")
+    resource = os.getenv("AZURE_RESOURCE")
+    id_value = os.getenv("AZURE_ID_VALUE", None)
+
+    if hasattr(request, "param"):
+        kwargs = request.param.get("idp_kwargs", {})
+    else:
+        kwargs = {}
+
+    identity_type = kwargs.pop("identity_type", ManagedIdentityType.SYSTEM_ASSIGNED)
+    id_type = kwargs.pop("id_type", ManagedIdentityIdType.CLIENT_ID)
+
+    return create_provider_from_managed_identity(
+        identity_type=identity_type,
+        resource=resource,
+        id_type=id_type,
+        id_value=id_value,
+        authority=authority,
+        **kwargs,
+    )
+
+
+def _get_service_principal_provider(request):
+    client_id = os.getenv("AZURE_CLIENT_ID")
+    client_credential = os.getenv("AZURE_CLIENT_SECRET")
+    authority = os.getenv("AZURE_AUTHORITY")
+    scopes = os.getenv("AZURE_REDIS_SCOPES", [])
+
+    if hasattr(request, "param"):
+        kwargs = request.param.get("idp_kwargs", {})
+        token_kwargs = request.param.get("token_kwargs", {})
+        timeout = request.param.get("timeout", None)
+    else:
+        kwargs = {}
+        token_kwargs = {}
+        timeout = None
+
+    if isinstance(scopes, str):
+        scopes = scopes.split(",")
+
+    return create_provider_from_service_principal(
+        client_id=client_id,
+        client_credential=client_credential,
+        scopes=scopes,
+        timeout=timeout,
+        token_kwargs=token_kwargs,
+        authority=authority,
+        **kwargs,
+    )
+
+
+def get_credential_provider(request) -> CredentialProvider:
+    cred_provider_class = request.param.get("cred_provider_class")
+    cred_provider_kwargs = request.param.get("cred_provider_kwargs", {})
+
+    if cred_provider_class != EntraIdCredentialsProvider:
+        return cred_provider_class(**cred_provider_kwargs)
+
+    idp = identity_provider(request)
+    initial_delay_in_ms = cred_provider_kwargs.get("initial_delay_in_ms", 0)
+    block_for_initial = cred_provider_kwargs.get("block_for_initial", False)
+    expiration_refresh_ratio = cred_provider_kwargs.get(
+        "expiration_refresh_ratio", TokenAuthConfig.DEFAULT_EXPIRATION_REFRESH_RATIO
+    )
+    lower_refresh_bound_millis = cred_provider_kwargs.get(
+        "lower_refresh_bound_millis", TokenAuthConfig.DEFAULT_LOWER_REFRESH_BOUND_MILLIS
+    )
+    max_attempts = cred_provider_kwargs.get(
+        "max_attempts", TokenAuthConfig.DEFAULT_MAX_ATTEMPTS
+    )
+    delay_in_ms = cred_provider_kwargs.get(
+        "delay_in_ms", TokenAuthConfig.DEFAULT_DELAY_IN_MS
+    )
+
+    auth_config = TokenAuthConfig(idp)
+    auth_config.expiration_refresh_ratio = expiration_refresh_ratio
+    auth_config.lower_refresh_bound_millis = lower_refresh_bound_millis
+    auth_config.max_attempts = max_attempts
+    auth_config.delay_in_ms = delay_in_ms
+
+    return EntraIdCredentialsProvider(
+        config=auth_config,
+        initial_delay_in_ms=initial_delay_in_ms,
+        block_for_initial=block_for_initial,
+    )
+
+
+@pytest.fixture()
+def credential_provider(request) -> CredentialProvider:
+    return get_credential_provider(request)
+
+
+def get_endpoint(endpoint_name: str):
+    endpoints_config = os.getenv("REDIS_ENDPOINTS_CONFIG_PATH", None)
+
+    if not (endpoints_config and os.path.exists(endpoints_config)):
+        raise FileNotFoundError(f"Endpoints config file not found: {endpoints_config}")
+
+    try:
+        with open(endpoints_config, "r") as f:
+            data = json.load(f)
+            db = data[endpoint_name]
+            return db["endpoints"][0]
+    except Exception as e:
+        raise ValueError(
+            f"Failed to load endpoints config file: {endpoints_config}"
+        ) from e
+
+
 def wait_for_command(client, monitor, command, key=None):
     # issue a command with a key name that's local to this process.
     # if we find a command with our key before the command we're waiting
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index 41b47b2268..8833426af1 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -1,21 +1,41 @@
+import os
 import random
 from contextlib import asynccontextmanager as _asynccontextmanager
+from datetime import datetime, timezone
+from enum import Enum
 from typing import Union
 
+import jwt
 import pytest
 import pytest_asyncio
 import redis.asyncio as redis
+from mock.mock import Mock
 from packaging.version import Version
 from redis.asyncio import Sentinel
 from redis.asyncio.client import Monitor
 from redis.asyncio.connection import Connection, parse_url
 from redis.asyncio.retry import Retry
+from redis.auth.idp import IdentityProviderInterface
+from redis.auth.token import JWToken
 from redis.backoff import NoBackoff
+from redis.credentials import CredentialProvider
+from redis_entraid.cred_provider import EntraIdCredentialsProvider, TokenAuthConfig
+from redis_entraid.identity_provider import (
+    ManagedIdentityIdType,
+    ManagedIdentityType,
+    create_provider_from_managed_identity,
+    create_provider_from_service_principal,
+)
 from tests.conftest import REDIS_INFO
 
 from .compat import mock
 
 
+class AuthType(Enum):
+    MANAGED_IDENTITY = "managed_identity"
+    SERVICE_PRINCIPAL = "service_principal"
+
+
 async def _get_info(redis_url):
     client = redis.Redis.from_url(redis_url)
     info = await client.info()
@@ -216,6 +236,125 @@ async def mock_cluster_resp_slaves(create_redis, **kwargs):
         yield mocked
 
 
+def mock_identity_provider() -> IdentityProviderInterface:
+    mock_provider = Mock(spec=IdentityProviderInterface)
+    token = {"exp": datetime.now(timezone.utc).timestamp() + 3600, "oid": "username"}
+    encoded = jwt.encode(token, "secret", algorithm="HS256")
+    jwt_token = JWToken(encoded)
+    mock_provider.request_token.return_value = jwt_token
+    return mock_provider
+
+
+def identity_provider(request) -> IdentityProviderInterface:
+    if hasattr(request, "param"):
+        kwargs = request.param.get("idp_kwargs", {})
+    else:
+        kwargs = {}
+
+    if request.param.get("mock_idp", None) is not None:
+        return mock_identity_provider()
+
+    auth_type = kwargs.pop("auth_type", AuthType.SERVICE_PRINCIPAL)
+
+    if auth_type == "MANAGED_IDENTITY":
+        return _get_managed_identity_provider(request)
+
+    return _get_service_principal_provider(request)
+
+
+def _get_managed_identity_provider(request):
+    authority = os.getenv("AZURE_AUTHORITY")
+    resource = os.getenv("AZURE_RESOURCE")
+    id_value = os.getenv("AZURE_ID_VALUE", None)
+
+    if hasattr(request, "param"):
+        kwargs = request.param.get("idp_kwargs", {})
+    else:
+        kwargs = {}
+
+    identity_type = kwargs.pop("identity_type", ManagedIdentityType.SYSTEM_ASSIGNED)
+    id_type = kwargs.pop("id_type", ManagedIdentityIdType.CLIENT_ID)
+
+    return create_provider_from_managed_identity(
+        identity_type=identity_type,
+        resource=resource,
+        id_type=id_type,
+        id_value=id_value,
+        authority=authority,
+        **kwargs,
+    )
+
+
+def _get_service_principal_provider(request):
+    client_id = os.getenv("AZURE_CLIENT_ID")
+    client_credential = os.getenv("AZURE_CLIENT_SECRET")
+    authority = os.getenv("AZURE_AUTHORITY")
+    scopes = os.getenv("AZURE_REDIS_SCOPES", [])
+
+    if hasattr(request, "param"):
+        kwargs = request.param.get("idp_kwargs", {})
+        token_kwargs = request.param.get("token_kwargs", {})
+        timeout = request.param.get("timeout", None)
+    else:
+        kwargs = {}
+        token_kwargs = {}
+        timeout = None
+
+    if isinstance(scopes, str):
+        scopes = scopes.split(",")
+
+    return create_provider_from_service_principal(
+        client_id=client_id,
+        client_credential=client_credential,
+        scopes=scopes,
+        timeout=timeout,
+        token_kwargs=token_kwargs,
+        authority=authority,
+        **kwargs,
+    )
+
+
+def get_credential_provider(request) -> CredentialProvider:
+    cred_provider_class = request.param.get("cred_provider_class")
+    cred_provider_kwargs = request.param.get("cred_provider_kwargs", {})
+
+    if cred_provider_class != EntraIdCredentialsProvider:
+        return cred_provider_class(**cred_provider_kwargs)
+
+    idp = identity_provider(request)
+    initial_delay_in_ms = cred_provider_kwargs.get("initial_delay_in_ms", 0)
+    block_for_initial = cred_provider_kwargs.get("block_for_initial", False)
+    expiration_refresh_ratio = cred_provider_kwargs.get(
+        "expiration_refresh_ratio", TokenAuthConfig.DEFAULT_EXPIRATION_REFRESH_RATIO
+    )
+    lower_refresh_bound_millis = cred_provider_kwargs.get(
+        "lower_refresh_bound_millis", TokenAuthConfig.DEFAULT_LOWER_REFRESH_BOUND_MILLIS
+    )
+    max_attempts = cred_provider_kwargs.get(
+        "max_attempts", TokenAuthConfig.DEFAULT_MAX_ATTEMPTS
+    )
+    delay_in_ms = cred_provider_kwargs.get(
+        "delay_in_ms", TokenAuthConfig.DEFAULT_DELAY_IN_MS
+    )
+
+    auth_config = TokenAuthConfig(idp)
+    auth_config.expiration_refresh_ratio = expiration_refresh_ratio
+    auth_config.lower_refresh_bound_millis = lower_refresh_bound_millis
+    auth_config.max_attempts = max_attempts
+    auth_config.delay_in_ms = delay_in_ms
+
+    return EntraIdCredentialsProvider(
+        config=auth_config,
+        initial_delay_in_ms=initial_delay_in_ms,
+        block_for_initial=block_for_initial,
+    )
+
+
+@pytest_asyncio.fixture()
+async def credential_provider(request) -> CredentialProvider:
+    return get_credential_provider(request)
+
+
 async def wait_for_command(
     client: redis.Redis, monitor: Monitor, command: str, key: Union[str, None] = None
 ):
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 477397dd5f..c95babf687 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -2893,12 +2893,13 @@ class TestSSL:
     appropriate port.
     """
 
-    CLIENT_CERT, CLIENT_KEY, CA_CERT = get_tls_certificates("cluster")
-
     @pytest_asyncio.fixture()
     def create_client(self, request: FixtureRequest) -> Callable[..., RedisCluster]:
         ssl_url = request.config.option.redis_ssl_url
         ssl_host, ssl_port = urlparse(ssl_url)[1].split(":")
+        self.client_cert, self.client_key, self.ca_cert = get_tls_certificates(
+            "cluster"
+        )
 
         async def _create_client(mocked: bool = True, **kwargs: Any) -> RedisCluster:
             if mocked:
@@ -3017,24 +3018,24 @@ async def test_validating_self_signed_certificate(
     ) -> None:
         async with await create_client(
             ssl=True,
-            ssl_ca_certs=self.CA_CERT,
+            ssl_ca_certs=self.ca_cert,
             ssl_cert_reqs="required",
-            ssl_certfile=self.CLIENT_CERT,
-            ssl_keyfile=self.CLIENT_KEY,
+            ssl_certfile=self.client_cert,
+            ssl_keyfile=self.client_key,
         ) as rc:
             assert await rc.ping()
 
     async def test_validating_self_signed_string_certificate(
         self, create_client: Callable[..., Awaitable[RedisCluster]]
     ) -> None:
-        with open(self.CA_CERT) as f:
+        with open(self.ca_cert) as f:
             cert_data = f.read()
 
         async with await create_client(
             ssl=True,
             ssl_ca_data=cert_data,
             ssl_cert_reqs="required",
-            ssl_certfile=self.CLIENT_CERT,
-            ssl_keyfile=self.CLIENT_KEY,
+            ssl_certfile=self.client_cert,
+            ssl_keyfile=self.client_key,
         ) as rc:
             assert await rc.ping()
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
index 2f5bbfb621..83545b4ede 100644
--- a/tests/test_asyncio/test_connection_pool.py
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -5,6 +5,7 @@
 import pytest_asyncio
 import redis.asyncio as redis
 from redis.asyncio.connection import Connection, to_bool
+from redis.auth.token import TokenInterface
 from tests.conftest import skip_if_redis_enterprise, skip_if_server_version_lt
 
 from .compat import aclosing, mock
@@ -106,6 +107,12 @@ async def disconnect(self):
     async def can_read_destructive(self, timeout: float = 0):
         return False
 
+    def set_re_auth_token(self, token: TokenInterface):
+        pass
+
+    async def re_auth(self):
+        pass
+
 
 class TestConnectionPool:
     @asynccontextmanager
diff --git a/tests/test_asyncio/test_credentials.py b/tests/test_asyncio/test_credentials.py
index 4429f7453b..ca42d19090 100644
--- a/tests/test_asyncio/test_credentials.py
+++ b/tests/test_asyncio/test_credentials.py
@@ -1,15 +1,51 @@
 import functools
 import random
 import string
+from asyncio import Lock as AsyncLock
+from asyncio import sleep as async_sleep
 from typing import Optional, Tuple, Union
 
 import pytest
 import pytest_asyncio
 import redis
-from redis import AuthenticationError, DataError, ResponseError
+from mock.mock import Mock, call
+from redis import AuthenticationError, DataError, RedisError, ResponseError
+from redis.asyncio import Connection, ConnectionPool, Redis
+from redis.asyncio.retry import Retry
+from redis.auth.err import RequestTokenErr
+from redis.backoff import NoBackoff
 from redis.credentials import CredentialProvider, UsernamePasswordCredentialProvider
+from redis.exceptions import ConnectionError
 from redis.utils import str_if_bytes
-from tests.conftest import skip_if_redis_enterprise
+from redis_entraid.cred_provider import EntraIdCredentialsProvider
+from tests.conftest import get_endpoint, skip_if_redis_enterprise
+from tests.test_asyncio.conftest import get_credential_provider
+
+
+@pytest.fixture()
+def endpoint(request):
+    endpoint_name = request.config.getoption("--endpoint-name")
+
+    try:
+        return get_endpoint(endpoint_name)
+    except FileNotFoundError as e:
+        pytest.skip(
+            f"Skipping scenario test because endpoints file is missing: {str(e)}"
+        )
+
+
+@pytest_asyncio.fixture()
+async def r_credential(request, create_redis, endpoint):
+    credential_provider = request.param.get("cred_provider_class", None)
+
+    if credential_provider is not None:
+        credential_provider = get_credential_provider(request)
+
+    kwargs = {
+        "credential_provider": credential_provider,
+    }
+
+    return await create_redis(url=endpoint, **kwargs)
 
 
 @pytest_asyncio.fixture()
@@ -281,3 +317,380 @@ async def test_user_pass_provider_only_password(
         r2 = await create_redis(flushdb=False, credential_provider=provider)
         assert await r2.auth(provider.password) is True
         assert await r2.ping() is True
+
+
+@pytest.mark.asyncio
+@pytest.mark.onlynoncluster
+class TestStreamingCredentialProvider:
+    @pytest.mark.parametrize(
+        "credential_provider",
+        [
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "cred_provider_kwargs": {"expiration_refresh_ratio": 0.00005},
+                "mock_idp": True,
+            }
+        ],
+        indirect=True,
+    )
+    async def test_async_re_auth_all_connections(self, credential_provider):
+        mock_connection = Mock(spec=Connection)
+        mock_connection.retry = Retry(NoBackoff(), 0)
+        mock_another_connection = Mock(spec=Connection)
+        mock_pool = Mock(spec=ConnectionPool)
+        mock_pool.connection_kwargs = {
+            "credential_provider": credential_provider,
+        }
+        mock_pool.get_connection.return_value = mock_connection
+        mock_pool._available_connections = [mock_connection, mock_another_connection]
+        mock_pool._lock = AsyncLock()
+        auth_token = None
+
+        async def re_auth_callback(token):
+            nonlocal auth_token
+            auth_token = token
+            async with mock_pool._lock:
+                for conn in mock_pool._available_connections:
+                    await conn.send_command(
+                        "AUTH", token.try_get("oid"), token.get_value()
+                    )
+                    await conn.read_response()
+
+        mock_pool.re_auth_callback = re_auth_callback
+
+        await Redis(
+            connection_pool=mock_pool,
+            credential_provider=credential_provider,
+        )
+
+        await credential_provider.get_credentials_async()
+        await async_sleep(0.5)
+
+        mock_connection.send_command.assert_has_calls(
+            [call("AUTH", auth_token.try_get("oid"), auth_token.get_value())]
+        )
+        mock_another_connection.send_command.assert_has_calls(
+            [call("AUTH", auth_token.try_get("oid"), auth_token.get_value())]
+        )
+
+    @pytest.mark.parametrize(
+        "credential_provider",
+        [
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "cred_provider_kwargs": {"expiration_refresh_ratio": 0.00005},
+                "mock_idp": True,
+            }
+        ],
+        indirect=True,
+    )
+    async def test_async_re_auth_partial_connections(self, credential_provider):
+        mock_connection = Mock(spec=Connection)
+        mock_connection.retry = Retry(NoBackoff(), 3)
+        mock_another_connection = Mock(spec=Connection)
+        mock_another_connection.retry = Retry(NoBackoff(), 3)
+        mock_failed_connection = Mock(spec=Connection)
+        mock_failed_connection.read_response.side_effect = ConnectionError(
+            "Failed auth"
+        )
+        mock_failed_connection.retry = Retry(NoBackoff(), 3)
+        mock_pool = Mock(spec=ConnectionPool)
+        mock_pool.connection_kwargs = {
+            "credential_provider": credential_provider,
+        }
+        mock_pool.get_connection.return_value = mock_connection
+        mock_pool._available_connections = [
+            mock_connection,
+            mock_another_connection,
+            mock_failed_connection,
+        ]
+        mock_pool._lock = AsyncLock()
+
+        async def _raise(error: RedisError):
+            pass
+
+        async def re_auth_callback(token):
+            async with mock_pool._lock:
+                for conn in mock_pool._available_connections:
+                    await conn.retry.call_with_retry(
+                        lambda: conn.send_command(
+                            "AUTH", token.try_get("oid"), token.get_value()
+                        ),
+                        lambda error: _raise(error),
+                    )
+                    await conn.retry.call_with_retry(
+                        lambda: conn.read_response(), lambda error: _raise(error)
+                    )
+
+        mock_pool.re_auth_callback = re_auth_callback
+
+        await Redis(
+            connection_pool=mock_pool,
+            credential_provider=credential_provider,
+        )
+
+        await credential_provider.get_credentials_async()
+        await async_sleep(0.5)
+
+        mock_connection.read_response.assert_has_calls([call()])
+        mock_another_connection.read_response.assert_has_calls([call()])
+        mock_failed_connection.read_response.assert_has_calls([call(), call(), call()])
+
+    @pytest.mark.parametrize(
+        "credential_provider",
+        [
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "cred_provider_kwargs": {"expiration_refresh_ratio": 0.00005},
+                "mock_idp": True,
+            }
+        ],
+        indirect=True,
+    )
+    async def test_re_auth_pub_sub_in_resp3(self, credential_provider):
+        mock_pubsub_connection = Mock(spec=Connection)
+        mock_pubsub_connection.get_protocol.return_value = 3
+        mock_pubsub_connection.credential_provider = credential_provider
+        mock_pubsub_connection.retry = Retry(NoBackoff(), 3)
+        mock_another_connection = Mock(spec=Connection)
+        mock_another_connection.retry = Retry(NoBackoff(), 3)
+
+        mock_pool = Mock(spec=ConnectionPool)
+        mock_pool.connection_kwargs = {
+            "credential_provider": credential_provider,
+        }
+        mock_pool.get_connection.side_effect = [
+            mock_pubsub_connection,
+            mock_another_connection,
+        ]
+        mock_pool._available_connections = [mock_another_connection]
+        mock_pool._lock = AsyncLock()
+        auth_token = None
+
+        async def re_auth_callback(token):
+            nonlocal auth_token
+            auth_token = token
+            async with mock_pool._lock:
+                for conn in mock_pool._available_connections:
+                    await conn.send_command(
+                        "AUTH", token.try_get("oid"), token.get_value()
+                    )
+                    await conn.read_response()
+
+        mock_pool.re_auth_callback = re_auth_callback
+
+        r = Redis(
+            connection_pool=mock_pool,
+            credential_provider=credential_provider,
+        )
+        p = r.pubsub()
+        await p.subscribe("test")
+        await credential_provider.get_credentials_async()
+        await async_sleep(0.5)
+
+        mock_pubsub_connection.send_command.assert_has_calls(
+            [
+                call("SUBSCRIBE", "test", check_health=True),
+                call("AUTH", auth_token.try_get("oid"), auth_token.get_value()),
+            ]
+        )
+        mock_another_connection.send_command.assert_has_calls(
+            [call("AUTH", auth_token.try_get("oid"), auth_token.get_value())]
+        )
+
+    @pytest.mark.parametrize(
+        "credential_provider",
+        [
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "cred_provider_kwargs": {"expiration_refresh_ratio": 0.00005},
+                "mock_idp": True,
+            }
+        ],
+        indirect=True,
+    )
+    async def test_do_not_re_auth_pub_sub_in_resp2(self, credential_provider):
+        mock_pubsub_connection = Mock(spec=Connection)
+        mock_pubsub_connection.get_protocol.return_value = 2
+        mock_pubsub_connection.credential_provider = credential_provider
+        mock_pubsub_connection.retry = Retry(NoBackoff(), 3)
+        mock_another_connection = Mock(spec=Connection)
+        mock_another_connection.retry = Retry(NoBackoff(), 3)
+
+        mock_pool = Mock(spec=ConnectionPool)
+        mock_pool.connection_kwargs = {
+            "credential_provider": credential_provider,
+        }
+        mock_pool.get_connection.side_effect = [
+            mock_pubsub_connection,
+            mock_another_connection,
+        ]
+        mock_pool._available_connections = [mock_another_connection]
+        mock_pool._lock = AsyncLock()
+        auth_token = None
+
+        async def re_auth_callback(token):
+            nonlocal auth_token
+            auth_token = token
+            async with mock_pool._lock:
+                for conn in mock_pool._available_connections:
+                    await conn.send_command(
+                        "AUTH", token.try_get("oid"), token.get_value()
+                    )
+                    await conn.read_response()
+
+        mock_pool.re_auth_callback = re_auth_callback
+
+        r = Redis(
+            connection_pool=mock_pool,
+            credential_provider=credential_provider,
+        )
+        p = r.pubsub()
+        await p.subscribe("test")
+        await credential_provider.get_credentials_async()
+        await async_sleep(0.5)
+
+        mock_pubsub_connection.send_command.assert_has_calls(
+            [
+                call("SUBSCRIBE", "test", check_health=True),
+            ]
+        )
+        mock_another_connection.send_command.assert_has_calls(
+            [call("AUTH", auth_token.try_get("oid"), auth_token.get_value())]
+        )
+
+    @pytest.mark.parametrize(
+        "credential_provider",
+        [
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "cred_provider_kwargs": {"expiration_refresh_ratio": 0.00005},
+                "mock_idp": True,
+            }
+        ],
+        indirect=True,
+    )
+    async def test_fails_on_token_renewal(self, credential_provider):
+        credential_provider._token_mgr._idp.request_token.side_effect = [
+            RequestTokenErr,
+            RequestTokenErr,
+            RequestTokenErr,
+            RequestTokenErr,
+        ]
+        mock_connection = Mock(spec=Connection)
+        mock_connection.retry = Retry(NoBackoff(), 0)
+        mock_another_connection = Mock(spec=Connection)
+        mock_pool = Mock(spec=ConnectionPool)
+        mock_pool.connection_kwargs = {
+            "credential_provider": credential_provider,
+        }
+        mock_pool.get_connection.return_value = mock_connection
+        mock_pool._available_connections = [mock_connection, mock_another_connection]
+
+        await Redis(
+            connection_pool=mock_pool,
+            credential_provider=credential_provider,
+        )
+
+        with pytest.raises(RequestTokenErr):
+            await credential_provider.get_credentials()
+
+
+@pytest.mark.asyncio
+@pytest.mark.onlynoncluster
+@pytest.mark.cp_integration
+class TestEntraIdCredentialsProvider:
+    @pytest.mark.parametrize(
+        "r_credential",
+        [
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+            },
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "cred_provider_kwargs": {"block_for_initial": True},
+            },
+        ],
+        ids=["blocked", "non-blocked"],
+        indirect=True,
+    )
+    @pytest.mark.asyncio
+    @pytest.mark.onlynoncluster
+    @pytest.mark.cp_integration
+    async def test_async_auth_pool_with_credential_provider(self, r_credential: Redis):
+        assert await r_credential.ping() is True
+
+    @pytest.mark.parametrize(
+        "r_credential",
+        [
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+            },
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "cred_provider_kwargs": {"block_for_initial": True},
+            },
+        ],
+        ids=["blocked", "non-blocked"],
+        indirect=True,
+    )
+    @pytest.mark.asyncio
+    @pytest.mark.onlynoncluster
+    @pytest.mark.cp_integration
+    async def test_async_pipeline_with_credential_provider(self, r_credential: Redis):
+        pipe = r_credential.pipeline()
+
+        await pipe.set("key", "value")
+        await pipe.get("key")
+
+        assert await pipe.execute() == [True, b"value"]
+
+    @pytest.mark.parametrize(
+        "r_credential",
+        [
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+            },
+        ],
+        indirect=True,
+    )
+    @pytest.mark.asyncio
+    @pytest.mark.onlynoncluster
+    @pytest.mark.cp_integration
+    async def test_async_auth_pubsub_with_credential_provider(
+        self, r_credential: Redis
+    ):
+        p = r_credential.pubsub()
+        await p.subscribe("entraid")
+
+        await r_credential.publish("entraid", "test")
+        await r_credential.publish("entraid", "test")
+
+        msg1 = await p.get_message()
+
+        assert msg1["type"] == "subscribe"
+
+
+@pytest.mark.asyncio
+@pytest.mark.onlycluster
+@pytest.mark.cp_integration
+class TestClusterEntraIdCredentialsProvider:
+    @pytest.mark.parametrize(
+        "r_credential",
+        [
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+            },
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "cred_provider_kwargs": {"block_for_initial": True},
+            },
+        ],
+        ids=["blocked", "non-blocked"],
+        indirect=True,
+    )
+    @pytest.mark.asyncio
+    @pytest.mark.onlycluster
+    @pytest.mark.cp_integration
+    async def test_async_auth_pool_with_credential_provider(self, r_credential: Redis):
+        assert await r_credential.ping() is True
diff --git a/tests/test_auth/__init__.py b/tests/test_auth/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/tests/test_auth/test_token.py b/tests/test_auth/test_token.py
new file mode 100644
index 0000000000..978cc2ca8c
--- /dev/null
+++ b/tests/test_auth/test_token.py
@@ -0,0 +1,76 @@
+from datetime import datetime, timezone
+
+import jwt
+import pytest
+from redis.auth.err import InvalidTokenSchemaErr
+from redis.auth.token import JWToken, SimpleToken
+
+
+class TestToken:
+
+    def test_simple_token(self):
+        token = SimpleToken(
+            "value",
+            (datetime.now(timezone.utc).timestamp() * 1000) + 1000,
+            (datetime.now(timezone.utc).timestamp() * 1000),
+            {"key": "value"},
+        )
+
+        assert token.ttl() == pytest.approx(1000, 10)
+        assert token.is_expired() is False
+        assert token.try_get("key") == "value"
+        assert token.get_value() == "value"
+        assert token.get_expires_at_ms() == pytest.approx(
+            (datetime.now(timezone.utc).timestamp() * 1000) + 100, 10
+        )
+        assert token.get_received_at_ms() == pytest.approx(
+            (datetime.now(timezone.utc).timestamp() * 1000), 10
+        )
+
+        token = SimpleToken(
+            "value",
+            -1,
+            (datetime.now(timezone.utc).timestamp() * 1000),
+            {"key": "value"},
+        )
+
+        assert token.ttl() == -1
+        assert token.is_expired() is False
+        assert token.get_expires_at_ms() == -1
+
+    def test_jwt_token(self):
+        token = {
+            "exp": datetime.now(timezone.utc).timestamp() + 100,
+            "iat": datetime.now(timezone.utc).timestamp(),
+            "key": "value",
+        }
+        encoded = jwt.encode(token, "secret", algorithm="HS256")
+        jwt_token = JWToken(encoded)
+
+        assert jwt_token.ttl() == pytest.approx(100000, 10)
+        assert jwt_token.is_expired() is False
+        assert jwt_token.try_get("key") == "value"
+        assert jwt_token.get_value() == encoded
+        assert jwt_token.get_expires_at_ms() == pytest.approx(
+            (datetime.now(timezone.utc).timestamp() * 1000) + 100000, 10
+        )
+        assert jwt_token.get_received_at_ms() == pytest.approx(
+            (datetime.now(timezone.utc).timestamp() * 1000), 10
+        )
+
+        token = {
+            "exp": -1,
+            "iat": datetime.now(timezone.utc).timestamp(),
+            "key": "value",
+        }
+        encoded = jwt.encode(token, "secret", algorithm="HS256")
+        jwt_token = JWToken(encoded)
+
+        assert jwt_token.ttl() == -1
+        assert jwt_token.is_expired() is False
+        assert jwt_token.get_expires_at_ms() == -1000
+
+        with pytest.raises(InvalidTokenSchemaErr):
+            token = {"key": "value"}
+            encoded = jwt.encode(token, "secret", algorithm="HS256")
+            JWToken(encoded)
diff --git a/tests/test_auth/test_token_manager.py b/tests/test_auth/test_token_manager.py
new file mode 100644
index 0000000000..bb396e246c
--- /dev/null
+++ b/tests/test_auth/test_token_manager.py
@@ -0,0 +1,566 @@
+import asyncio
+from datetime import datetime, timezone
+from time import sleep
+from unittest.mock import Mock
+
+import pytest
+from redis.auth.err import RequestTokenErr, TokenRenewalErr
+from redis.auth.idp import IdentityProviderInterface
+from redis.auth.token import SimpleToken
+from redis.auth.token_manager import (
+    CredentialsListener,
+    RetryPolicy,
+    TokenManager,
+    TokenManagerConfig,
+)
+
+
+class TestTokenManager:
+    @pytest.mark.parametrize(
+        "exp_refresh_ratio,tokens_refreshed",
+        [
+            (0.9, 2),
+            (0.28, 4),
+        ],
+        ids=[
+            "Refresh ratio = 0.9,  2 tokens in 0,1 second",
+            "Refresh ratio = 0.28, 4 tokens in 0,1 second",
+        ],
+    )
+    def test_success_token_renewal(self, exp_refresh_ratio, tokens_refreshed):
+        tokens = []
+        mock_provider = Mock(spec=IdentityProviderInterface)
+        mock_provider.request_token.side_effect = [
+            SimpleToken(
+                "value",
+                (datetime.now(timezone.utc).timestamp() * 1000) + 100,
+                (datetime.now(timezone.utc).timestamp() * 1000),
+                {"oid": "test"},
+            ),
+            SimpleToken(
+                "value",
+                (datetime.now(timezone.utc).timestamp() * 1000) + 130,
+                (datetime.now(timezone.utc).timestamp() * 1000) + 30,
+                {"oid": "test"},
+            ),
+            SimpleToken(
+                "value",
+                (datetime.now(timezone.utc).timestamp() * 1000) + 160,
+                (datetime.now(timezone.utc).timestamp() * 1000) + 60,
+                {"oid": "test"},
+            ),
+            SimpleToken(
+                "value",
+                (datetime.now(timezone.utc).timestamp() * 1000) + 190,
+                (datetime.now(timezone.utc).timestamp() * 1000) + 90,
+                {"oid": "test"},
+            ),
+        ]
+
+        def on_next(token):
+            nonlocal tokens
+            tokens.append(token)
+
+        mock_listener = Mock(spec=CredentialsListener)
+        mock_listener.on_next = on_next
+
+        retry_policy = RetryPolicy(1, 10)
+        config = TokenManagerConfig(exp_refresh_ratio, 0, 1000, retry_policy)
+        mgr = TokenManager(mock_provider, config)
+        mgr.start(mock_listener)
+        sleep(0.1)
+
+        assert len(tokens) == tokens_refreshed
+
+    @pytest.mark.parametrize(
+        "exp_refresh_ratio,tokens_refreshed",
+        [
+            (0.9, 2),
+            (0.28, 4),
+        ],
+        ids=[
+            "Refresh ratio = 0.9,  2 tokens in 0,1 second",
+            "Refresh ratio = 0.28, 4 tokens in 0,1 second",
+        ],
+    )
+    @pytest.mark.asyncio
+    async def test_async_success_token_renewal(
+        self, exp_refresh_ratio, tokens_refreshed
+    ):
+        tokens = []
+        mock_provider = Mock(spec=IdentityProviderInterface)
+        mock_provider.request_token.side_effect = [
+            SimpleToken(
+                "value",
+                (datetime.now(timezone.utc).timestamp() * 1000) + 100,
+                (datetime.now(timezone.utc).timestamp() * 1000),
+                {"oid": "test"},
+            ),
+            SimpleToken(
+                "value",
+                (datetime.now(timezone.utc).timestamp() * 1000) + 130,
+                (datetime.now(timezone.utc).timestamp() * 1000) + 30,
+                {"oid": "test"},
+            ),
+            SimpleToken(
+                "value",
+                (datetime.now(timezone.utc).timestamp() * 1000) + 160,
+                (datetime.now(timezone.utc).timestamp() * 1000) + 60,
+                {"oid": "test"},
+            ),
+            SimpleToken(
+                "value",
+                (datetime.now(timezone.utc).timestamp() * 1000) + 190,
+                (datetime.now(timezone.utc).timestamp() * 1000) + 90,
+                {"oid": "test"},
+            ),
+        ]
+
+        async def on_next(token):
+            nonlocal tokens
+            tokens.append(token)
+
+        mock_listener = Mock(spec=CredentialsListener)
+        mock_listener.on_next = on_next
+
+        retry_policy = RetryPolicy(1, 10)
+        config = TokenManagerConfig(exp_refresh_ratio, 0, 1000, retry_policy)
+        mgr = TokenManager(mock_provider, config)
+        await mgr.start_async(mock_listener, block_for_initial=True)
+        await asyncio.sleep(0.1)
+
+        assert len(tokens) == tokens_refreshed
+
+    @pytest.mark.parametrize(
+        "block_for_initial,tokens_acquired",
+        [
+            (True, 1),
+            (False, 0),
+        ],
+        ids=[
+            "Block for initial, callback will triggered once",
+            "Non blocked, callback wont be triggered",
+        ],
+    )
+    @pytest.mark.asyncio
+    async def test_async_request_token_blocking_behaviour(
+        self, block_for_initial, tokens_acquired
+    ):
+        tokens = []
+        mock_provider = Mock(spec=IdentityProviderInterface)
+        mock_provider.request_token.return_value = SimpleToken(
+            "value",
+            (datetime.now(timezone.utc).timestamp() * 1000) + 100,
+            (datetime.now(timezone.utc).timestamp() * 1000),
+            {"oid": "test"},
+        )
+
+        async def on_next(token):
+            nonlocal tokens
+            sleep(0.1)
+            tokens.append(token)
+
+        mock_listener = Mock(spec=CredentialsListener)
+        mock_listener.on_next = on_next
+
+        retry_policy = RetryPolicy(1, 10)
+        config = TokenManagerConfig(1, 0, 1000, retry_policy)
+        mgr = TokenManager(mock_provider, config)
+        await mgr.start_async(mock_listener, block_for_initial=block_for_initial)
+
+        assert len(tokens) == tokens_acquired
+
+    def test_token_renewal_with_skip_initial(self):
+        tokens = []
+        mock_provider = Mock(spec=IdentityProviderInterface)
+        mock_provider.request_token.side_effect = [
+            SimpleToken(
+                "value",
+                (datetime.now(timezone.utc).timestamp() * 1000) + 100,
+                (datetime.now(timezone.utc).timestamp() * 1000),
+                {"oid": "test"},
+            ),
+            SimpleToken(
+                "value",
+                (datetime.now(timezone.utc).timestamp() * 1000) + 120,
+                (datetime.now(timezone.utc).timestamp() * 1000),
+                {"oid": "test"},
+            ),
+            SimpleToken(
+                "value",
+                (datetime.now(timezone.utc).timestamp() * 1000) + 140,
+                (datetime.now(timezone.utc).timestamp() * 1000),
+                {"oid": "test"},
+            ),
+        ]
+
+        def on_next(token):
+            nonlocal tokens
+            tokens.append(token)
+
+        mock_listener = Mock(spec=CredentialsListener)
+        mock_listener.on_next = on_next
+
+        retry_policy = RetryPolicy(3, 10)
+        config = TokenManagerConfig(1, 0, 1000, retry_policy)
+        mgr = TokenManager(mock_provider, config)
+        mgr.start(mock_listener, skip_initial=True)
+        # Should be less than a 0.1, or it will be flacky due to
+        # additional token renewal.
+        sleep(0.2)
+
+        assert len(tokens) == 2
+
+    @pytest.mark.asyncio
+    async def test_async_token_renewal_with_skip_initial(self):
+        tokens = []
+        mock_provider = Mock(spec=IdentityProviderInterface)
+        mock_provider.request_token.side_effect = [
+            SimpleToken(
+                "value",
+                (datetime.now(timezone.utc).timestamp() * 1000) + 100,
+                (datetime.now(timezone.utc).timestamp() * 1000),
+                {"oid": "test"},
+            ),
+            SimpleToken(
+                "value",
+                (datetime.now(timezone.utc).timestamp() * 1000) + 120,
+                (datetime.now(timezone.utc).timestamp() * 1000),
+                {"oid": "test"},
+            ),
+            SimpleToken(
+                "value",
+                (datetime.now(timezone.utc).timestamp() * 1000) + 140,
+                (datetime.now(timezone.utc).timestamp() * 1000),
+                {"oid": "test"},
+            ),
+        ]
+
+        async def on_next(token):
+            nonlocal tokens
+            tokens.append(token)
+
+        mock_listener = Mock(spec=CredentialsListener)
+        mock_listener.on_next = on_next
+
+        retry_policy = RetryPolicy(3, 10)
+        config = TokenManagerConfig(1, 0, 1000, retry_policy)
+        mgr = TokenManager(mock_provider, config)
+        await mgr.start_async(mock_listener, skip_initial=True)
+        # Should be less than a 0.1, or it will be flacky
+        # due to additional token renewal.
+        await asyncio.sleep(0.2)
+
+        assert len(tokens) == 2
+
+    def test_success_token_renewal_with_retry(self):
+        tokens = []
+        mock_provider = Mock(spec=IdentityProviderInterface)
+        mock_provider.request_token.side_effect = [
+            RequestTokenErr,
+            RequestTokenErr,
+            SimpleToken(
+                "value",
+                (datetime.now(timezone.utc).timestamp() * 1000) + 100,
+                (datetime.now(timezone.utc).timestamp() * 1000),
+                {"oid": "test"},
+            ),
+            SimpleToken(
+                "value",
+                (datetime.now(timezone.utc).timestamp() * 1000) + 100,
+                (datetime.now(timezone.utc).timestamp() * 1000),
+                {"oid": "test"},
+            ),
+        ]
+
+        def on_next(token):
+            nonlocal tokens
+            tokens.append(token)
+
+        mock_listener = Mock(spec=CredentialsListener)
+        mock_listener.on_next = on_next
+
+        retry_policy = RetryPolicy(3, 10)
+        config = TokenManagerConfig(1, 0, 1000, retry_policy)
+        mgr = TokenManager(mock_provider, config)
+        mgr.start(mock_listener)
+        # Should be less than a 0.1, or it will be flacky
+        # due to additional token renewal.
+        sleep(0.08)
+
+        assert mock_provider.request_token.call_count > 0
+        assert len(tokens) > 0
+
+    @pytest.mark.asyncio
+    async def test_async_success_token_renewal_with_retry(self):
+        tokens = []
+        mock_provider = Mock(spec=IdentityProviderInterface)
+        mock_provider.request_token.side_effect = [
+            RequestTokenErr,
+            RequestTokenErr,
+            SimpleToken(
+                "value",
+                (datetime.now(timezone.utc).timestamp() * 1000) + 100,
+                (datetime.now(timezone.utc).timestamp() * 1000),
+                {"oid": "test"},
+            ),
+            SimpleToken(
+                "value",
+                (datetime.now(timezone.utc).timestamp() * 1000) + 100,
+                (datetime.now(timezone.utc).timestamp() * 1000),
+                {"oid": "test"},
+            ),
+        ]
+
+        async def on_next(token):
+            nonlocal tokens
+            tokens.append(token)
+
+        mock_listener = Mock(spec=CredentialsListener)
+        mock_listener.on_next = on_next
+        mock_listener.on_error = None
+
+        retry_policy = RetryPolicy(3, 10)
+        config = TokenManagerConfig(1, 0, 1000, retry_policy)
+        mgr = TokenManager(mock_provider, config)
+        await mgr.start_async(mock_listener, block_for_initial=True)
+        # Should be less than a 0.1, or it will be flacky
+        # due to additional token renewal.
+        await asyncio.sleep(0.08)
+
+        assert mock_provider.request_token.call_count > 0
+        assert len(tokens) > 0
+
+    def test_no_token_renewal_on_process_complete(self):
+        tokens = []
+        mock_provider = Mock(spec=IdentityProviderInterface)
+        mock_provider.request_token.return_value = SimpleToken(
+            "value",
+            (datetime.now(timezone.utc).timestamp() * 1000) + 1000,
+            (datetime.now(timezone.utc).timestamp() * 1000),
+            {"oid": "test"},
+        )
+
+        def on_next(token):
+            nonlocal tokens
+            tokens.append(token)
+
+        mock_listener = Mock(spec=CredentialsListener)
+        mock_listener.on_next = on_next
+
+        retry_policy = RetryPolicy(1, 10)
+        config = TokenManagerConfig(0.9, 0, 1000, retry_policy)
+        mgr = TokenManager(mock_provider, config)
+        mgr.start(mock_listener)
+        sleep(0.2)
+
+        assert len(tokens) == 1
+
+    @pytest.mark.asyncio
+    async def test_async_no_token_renewal_on_process_complete(self):
+        tokens = []
+        mock_provider = Mock(spec=IdentityProviderInterface)
+        mock_provider.request_token.return_value = SimpleToken(
+            "value",
+            (datetime.now(timezone.utc).timestamp() * 1000) + 1000,
+            (datetime.now(timezone.utc).timestamp() * 1000),
+            {"oid": "test"},
+        )
+
+        async def on_next(token):
+            nonlocal tokens
+            tokens.append(token)
+
+        mock_listener = Mock(spec=CredentialsListener)
+        mock_listener.on_next = on_next
+
+        retry_policy = RetryPolicy(1, 10)
+        config = TokenManagerConfig(0.9, 0, 1000, retry_policy)
+        mgr = TokenManager(mock_provider, config)
+        await mgr.start_async(mock_listener, block_for_initial=True)
+        await asyncio.sleep(0.2)
+
+        assert len(tokens) == 1
+
+    def test_failed_token_renewal_with_retry(self):
+        tokens = []
+        exceptions = []
+
+        mock_provider = Mock(spec=IdentityProviderInterface)
+        mock_provider.request_token.side_effect = [
+            RequestTokenErr,
+            RequestTokenErr,
+            RequestTokenErr,
+            RequestTokenErr,
+        ]
+
+        def on_next(token):
+            nonlocal tokens
+            tokens.append(token)
+
+        def on_error(exception):
+            nonlocal exceptions
+            exceptions.append(exception)
+
+        mock_listener = Mock(spec=CredentialsListener)
+        mock_listener.on_next = on_next
+        mock_listener.on_error = on_error
+
+        retry_policy = RetryPolicy(3, 10)
+        config = TokenManagerConfig(1, 0, 1000, retry_policy)
+        mgr = TokenManager(mock_provider, config)
+        mgr.start(mock_listener)
+        sleep(0.1)
+
+        assert mock_provider.request_token.call_count == 4
+        assert len(tokens) == 0
+        assert len(exceptions) == 1
+
+    @pytest.mark.asyncio
+    async def test_async_failed_token_renewal_with_retry(self):
+        tokens = []
+        exceptions = []
+
+        mock_provider = Mock(spec=IdentityProviderInterface)
+        mock_provider.request_token.side_effect = [
+            RequestTokenErr,
+            RequestTokenErr,
+            RequestTokenErr,
+            RequestTokenErr,
+        ]
+
+        async def on_next(token):
+            nonlocal tokens
+            tokens.append(token)
+
+        async def on_error(exception):
+            nonlocal exceptions
+            exceptions.append(exception)
+
+        mock_listener = Mock(spec=CredentialsListener)
+        mock_listener.on_next = on_next
+        mock_listener.on_error = on_error
+
+        retry_policy = RetryPolicy(3, 10)
+        config = TokenManagerConfig(1, 0, 1000, retry_policy)
+        mgr = TokenManager(mock_provider, config)
+        await mgr.start_async(mock_listener, block_for_initial=True)
+        sleep(0.1)
+
+        assert mock_provider.request_token.call_count == 4
+        assert len(tokens) == 0
+        assert len(exceptions) == 1
+
+    def test_failed_renewal_on_expired_token(self):
+        errors = []
+        mock_provider = Mock(spec=IdentityProviderInterface)
+        mock_provider.request_token.return_value = SimpleToken(
+            "value",
+            (datetime.now(timezone.utc).timestamp() * 1000) - 100,
+            (datetime.now(timezone.utc).timestamp() * 1000) - 1000,
+            {"oid": "test"},
+        )
+
+        def on_error(error: TokenRenewalErr):
+            nonlocal errors
+            errors.append(error)
+
+        mock_listener = Mock(spec=CredentialsListener)
+        mock_listener.on_error = on_error
+
+        retry_policy = RetryPolicy(1, 10)
+        config = TokenManagerConfig(1, 0, 1000, retry_policy)
+        mgr = TokenManager(mock_provider, config)
+        mgr.start(mock_listener)
+
+        assert len(errors) == 1
+        assert isinstance(errors[0], TokenRenewalErr)
+        assert str(errors[0]) == "Requested token is expired"
+
+    @pytest.mark.asyncio
+    async def test_async_failed_renewal_on_expired_token(self):
+        errors = []
+        mock_provider = Mock(spec=IdentityProviderInterface)
+        mock_provider.request_token.return_value = SimpleToken(
+            "value",
+            (datetime.now(timezone.utc).timestamp() * 1000) - 100,
+            (datetime.now(timezone.utc).timestamp() * 1000) - 1000,
+            {"oid": "test"},
+        )
+
+        async def on_error(error: TokenRenewalErr):
+            nonlocal errors
+            errors.append(error)
+
+        mock_listener = Mock(spec=CredentialsListener)
+        mock_listener.on_error = on_error
+
+        retry_policy = RetryPolicy(1, 10)
+        config = TokenManagerConfig(1, 0, 1000, retry_policy)
+        mgr = TokenManager(mock_provider, config)
+        await mgr.start_async(mock_listener, block_for_initial=True)
+
+        assert len(errors) == 1
+        assert isinstance(errors[0], TokenRenewalErr)
+        assert str(errors[0]) == "Requested token is expired"
+
+    def test_failed_renewal_on_callback_error(self):
+        errors = []
+        mock_provider = Mock(spec=IdentityProviderInterface)
+        mock_provider.request_token.return_value = SimpleToken(
+            "value",
+            (datetime.now(timezone.utc).timestamp() * 1000) + 1000,
+            (datetime.now(timezone.utc).timestamp() * 1000),
+            {"oid": "test"},
+        )
+
+        def on_next(token):
+            raise Exception("Some exception")
+
+        def on_error(error):
+            nonlocal errors
+            errors.append(error)
+
+        mock_listener = Mock(spec=CredentialsListener)
+        mock_listener.on_next = on_next
+        mock_listener.on_error = on_error
+
+        retry_policy = RetryPolicy(1, 10)
+        config = TokenManagerConfig(1, 0, 1000, retry_policy)
+        mgr = TokenManager(mock_provider, config)
+        mgr.start(mock_listener)
+
+        assert len(errors) == 1
+        assert isinstance(errors[0], TokenRenewalErr)
+        assert str(errors[0]) == "Some exception"
+
+    @pytest.mark.asyncio
+    async def test_async_failed_renewal_on_callback_error(self):
+        errors = []
+        mock_provider = Mock(spec=IdentityProviderInterface)
+        mock_provider.request_token.return_value = SimpleToken(
+            "value",
+            (datetime.now(timezone.utc).timestamp() * 1000) + 1000,
+            (datetime.now(timezone.utc).timestamp() * 1000),
+            {"oid": "test"},
+        )
+
+        async def on_next(token):
+            raise Exception("Some exception")
+
+        async def on_error(error):
+            nonlocal errors
+            errors.append(error)
+
+        mock_listener = Mock(spec=CredentialsListener)
+        mock_listener.on_next = on_next
+        mock_listener.on_error = on_error
+
+        retry_policy = RetryPolicy(1, 10)
+        config = TokenManagerConfig(1, 0, 1000, retry_policy)
+        mgr = TokenManager(mock_provider, config)
+        await mgr.start_async(mock_listener, block_for_initial=True)
+
+        assert len(errors) == 1
+        assert isinstance(errors[0], TokenRenewalErr)
+        assert str(errors[0]) == "Some exception"
diff --git a/tests/test_connection.py b/tests/test_connection.py
index a58703e3b5..7683a1416d 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -28,6 +28,7 @@
     UnixDomainSocketConnection,
     parse_url,
 )
+from redis.credentials import UsernamePasswordCredentialProvider
 from redis.exceptions import ConnectionError, InvalidResponse, RedisError, TimeoutError
 from redis.retry import Retry
 from redis.utils import HIREDIS_AVAILABLE
@@ -441,6 +442,7 @@ def test_clears_cache_on_disconnect(self, mock_connection, cache_conf):
         mock_connection.retry = "mock"
         mock_connection.host = "mock"
         mock_connection.port = "mock"
+        mock_connection.credential_provider = UsernamePasswordCredentialProvider()
 
         proxy_connection = CacheProxyConnection(
             mock_connection, cache, threading.Lock()
@@ -457,6 +459,7 @@ def test_read_response_returns_cached_reply(self, mock_cache, mock_connection):
         mock_connection.retry = "mock"
         mock_connection.host = "mock"
         mock_connection.port = "mock"
+        mock_connection.credential_provider = UsernamePasswordCredentialProvider()
 
         mock_cache.is_cachable.return_value = True
         mock_cache.get.side_effect = [
@@ -541,6 +544,7 @@ def test_triggers_invalidation_processing_on_another_connection(
         mock_connection.retry = "mock"
         mock_connection.host = "mock"
         mock_connection.port = "mock"
+        mock_connection.credential_provider = UsernamePasswordCredentialProvider()
 
         another_conn = copy.deepcopy(mock_connection)
         another_conn.can_read.side_effect = [True, False]
diff --git a/tests/test_credentials.py b/tests/test_credentials.py
index aade04e082..b0b79d305f 100644
--- a/tests/test_credentials.py
+++ b/tests/test_credentials.py
@@ -1,14 +1,58 @@
 import functools
 import random
 import string
+import threading
+from time import sleep
 from typing import Optional, Tuple, Union
 
 import pytest
 import redis
-from redis import AuthenticationError, DataError, ResponseError
+from mock.mock import Mock, call
+from redis import AuthenticationError, DataError, Redis, ResponseError
+from redis.auth.err import RequestTokenErr
+from redis.backoff import NoBackoff
+from redis.connection import ConnectionInterface, ConnectionPool
 from redis.credentials import CredentialProvider, UsernamePasswordCredentialProvider
+from redis.exceptions import ConnectionError, RedisError
+from redis.retry import Retry
 from redis.utils import str_if_bytes
-from tests.conftest import _get_client, skip_if_redis_enterprise
+from redis_entraid.cred_provider import EntraIdCredentialsProvider
+from tests.conftest import (
+    _get_client,
+    get_credential_provider,
+    get_endpoint,
+    skip_if_redis_enterprise,
+)
+
+
+@pytest.fixture()
+def endpoint(request):
+    endpoint_name = request.config.getoption("--endpoint-name")
+
+    try:
+        return get_endpoint(endpoint_name)
+    except FileNotFoundError as e:
+        pytest.skip(
+            f"Skipping scenario test because endpoints file is missing: {str(e)}"
+        )
+
+
+@pytest.fixture()
+def r_entra(request, endpoint):
+    credential_provider = request.param.get("cred_provider_class", None)
+    single_connection = request.param.get("single_connection_client", False)
+
+    if credential_provider is not None:
+        credential_provider = get_credential_provider(request)
+
+    with _get_client(
+        redis.Redis,
+        request,
+        credential_provider=credential_provider,
+        single_connection_client=single_connection,
+        from_url=endpoint,
+    ) as client:
+        yield client
 
 
 class NoPassCredProvider(CredentialProvider):
@@ -248,3 +292,368 @@ def test_user_pass_provider_only_password(self, r, request):
         )
         assert r2.auth(provider.password) is True
         assert r2.ping() is True
+
+
+@pytest.mark.onlynoncluster
+class TestStreamingCredentialProvider:
+    @pytest.mark.parametrize(
+        "credential_provider",
+        [
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "cred_provider_kwargs": {"expiration_refresh_ratio": 0.00005},
+                "mock_idp": True,
+            }
+        ],
+        indirect=True,
+    )
+    def test_re_auth_all_connections(self, credential_provider):
+        mock_connection = Mock(spec=ConnectionInterface)
+        mock_connection.retry = Retry(NoBackoff(), 0)
+        mock_another_connection = Mock(spec=ConnectionInterface)
+        mock_pool = Mock(spec=ConnectionPool)
+        mock_pool.connection_kwargs = {
+            "credential_provider": credential_provider,
+        }
+        mock_pool.get_connection.return_value = mock_connection
+        mock_pool._available_connections = [mock_connection, mock_another_connection]
+        mock_pool._lock = threading.Lock()
+        auth_token = None
+
+        def re_auth_callback(token):
+            nonlocal auth_token
+            auth_token = token
+            with mock_pool._lock:
+                for conn in mock_pool._available_connections:
+                    conn.send_command("AUTH", token.try_get("oid"), token.get_value())
+                    conn.read_response()
+
+        mock_pool.re_auth_callback = re_auth_callback
+
+        Redis(
+            connection_pool=mock_pool,
+            credential_provider=credential_provider,
+        )
+
+        credential_provider.get_credentials()
+        sleep(0.5)
+
+        mock_connection.send_command.assert_has_calls(
+            [call("AUTH", auth_token.try_get("oid"), auth_token.get_value())]
+        )
+        mock_another_connection.send_command.assert_has_calls(
+            [call("AUTH", auth_token.try_get("oid"), auth_token.get_value())]
+        )
+
+    @pytest.mark.parametrize(
+        "credential_provider",
+        [
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "cred_provider_kwargs": {"expiration_refresh_ratio": 0.00005},
+                "mock_idp": True,
+            }
+        ],
+        indirect=True,
+    )
+    def test_re_auth_partial_connections(self, credential_provider):
+        mock_connection = Mock(spec=ConnectionInterface)
+        mock_connection.retry = Retry(NoBackoff(), 3)
+        mock_another_connection = Mock(spec=ConnectionInterface)
+        mock_another_connection.retry = Retry(NoBackoff(), 3)
+        mock_failed_connection = Mock(spec=ConnectionInterface)
+        mock_failed_connection.read_response.side_effect = ConnectionError(
+            "Failed auth"
+        )
+        mock_failed_connection.retry = Retry(NoBackoff(), 3)
+        mock_pool = Mock(spec=ConnectionPool)
+        mock_pool.connection_kwargs = {
+            "credential_provider": credential_provider,
+        }
+        mock_pool.get_connection.return_value = mock_connection
+        mock_pool._available_connections = [
+            mock_connection,
+            mock_another_connection,
+            mock_failed_connection,
+        ]
+        mock_pool._lock = threading.Lock()
+
+        def _raise(error: RedisError):
+            pass
+
+        def re_auth_callback(token):
+            with mock_pool._lock:
+                for conn in mock_pool._available_connections:
+                    conn.retry.call_with_retry(
+                        lambda: conn.send_command(
+                            "AUTH", token.try_get("oid"), token.get_value()
+                        ),
+                        lambda error: _raise(error),
+                    )
+                    conn.retry.call_with_retry(
+                        lambda: conn.read_response(), lambda error: _raise(error)
+                    )
+
+        mock_pool.re_auth_callback = re_auth_callback
+
+        Redis(
+            connection_pool=mock_pool,
+            credential_provider=credential_provider,
+        )
+
+        credential_provider.get_credentials()
+        sleep(0.5)
+
+        mock_connection.read_response.assert_has_calls([call()])
+        mock_another_connection.read_response.assert_has_calls([call()])
+        mock_failed_connection.read_response.assert_has_calls([call(), call(), call()])
+
+    @pytest.mark.parametrize(
+        "credential_provider",
+        [
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "cred_provider_kwargs": {"expiration_refresh_ratio": 0.00005},
+                "mock_idp": True,
+            }
+        ],
+        indirect=True,
+    )
+    def test_re_auth_pub_sub_in_resp3(self, credential_provider):
+        mock_pubsub_connection = Mock(spec=ConnectionInterface)
+        mock_pubsub_connection.get_protocol.return_value = 3
+        mock_pubsub_connection.credential_provider = credential_provider
+        mock_pubsub_connection.retry = Retry(NoBackoff(), 3)
+        mock_another_connection = Mock(spec=ConnectionInterface)
+        mock_another_connection.retry = Retry(NoBackoff(), 3)
+
+        mock_pool = Mock(spec=ConnectionPool)
+        mock_pool.connection_kwargs = {
+            "credential_provider": credential_provider,
+        }
+        mock_pool.get_connection.side_effect = [
+            mock_pubsub_connection,
+            mock_another_connection,
+        ]
+        mock_pool._available_connections = [mock_another_connection]
+        mock_pool._lock = threading.Lock()
+        auth_token = None
+
+        def re_auth_callback(token):
+            nonlocal auth_token
+            auth_token = token
+            with mock_pool._lock:
+                for conn in mock_pool._available_connections:
+                    conn.send_command("AUTH", token.try_get("oid"), token.get_value())
+                    conn.read_response()
+
+        mock_pool.re_auth_callback = re_auth_callback
+
+        r = Redis(
+            connection_pool=mock_pool,
+            credential_provider=credential_provider,
+        )
+        p = r.pubsub()
+        p.subscribe("test")
+        credential_provider.get_credentials()
+        sleep(0.5)
+
+        mock_pubsub_connection.send_command.assert_has_calls(
+            [
+                call("SUBSCRIBE", "test", check_health=True),
+                call("AUTH", auth_token.try_get("oid"), auth_token.get_value()),
+            ]
+        )
+        mock_another_connection.send_command.assert_has_calls(
+            [call("AUTH", auth_token.try_get("oid"), auth_token.get_value())]
+        )
+
+    @pytest.mark.parametrize(
+        "credential_provider",
+        [
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "cred_provider_kwargs": {"expiration_refresh_ratio": 0.00005},
+                "mock_idp": True,
+            }
+        ],
+        indirect=True,
+    )
+    def test_do_not_re_auth_pub_sub_in_resp2(self, credential_provider):
+        mock_pubsub_connection = Mock(spec=ConnectionInterface)
+        mock_pubsub_connection.get_protocol.return_value = 2
+        mock_pubsub_connection.credential_provider = credential_provider
+        mock_pubsub_connection.retry = Retry(NoBackoff(), 3)
+        mock_another_connection = Mock(spec=ConnectionInterface)
+        mock_another_connection.retry = Retry(NoBackoff(), 3)
+
+        mock_pool = Mock(spec=ConnectionPool)
+        mock_pool.connection_kwargs = {
+            "credential_provider": credential_provider,
+        }
+        mock_pool.get_connection.side_effect = [
+            mock_pubsub_connection,
+            mock_another_connection,
+        ]
+        mock_pool._available_connections = [mock_another_connection]
+        mock_pool._lock = threading.Lock()
+        auth_token = None
+
+        def re_auth_callback(token):
+            nonlocal auth_token
+            auth_token = token
+            with mock_pool._lock:
+                for conn in mock_pool._available_connections:
+                    conn.send_command("AUTH", token.try_get("oid"), token.get_value())
+                    conn.read_response()
+
+        mock_pool.re_auth_callback = re_auth_callback
+
+        r = Redis(
+            connection_pool=mock_pool,
+            credential_provider=credential_provider,
+        )
+        p = r.pubsub()
+        p.subscribe("test")
+        credential_provider.get_credentials()
+        sleep(0.5)
+
+        mock_pubsub_connection.send_command.assert_has_calls(
+            [
+                call("SUBSCRIBE", "test", check_health=True),
+            ]
+        )
+        mock_another_connection.send_command.assert_has_calls(
+            [call("AUTH", auth_token.try_get("oid"), auth_token.get_value())]
+        )
+
+    @pytest.mark.parametrize(
+        "credential_provider",
+        [
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "cred_provider_kwargs": {"expiration_refresh_ratio": 0.00005},
+                "mock_idp": True,
+            }
+        ],
+        indirect=True,
+    )
+    def test_fails_on_token_renewal(self, credential_provider):
+        credential_provider._token_mgr._idp.request_token.side_effect = [
+            RequestTokenErr,
+            RequestTokenErr,
+            RequestTokenErr,
+            RequestTokenErr,
+        ]
+        mock_connection = Mock(spec=ConnectionInterface)
+        mock_connection.retry = Retry(NoBackoff(), 0)
+        mock_another_connection = Mock(spec=ConnectionInterface)
+        mock_pool = Mock(spec=ConnectionPool)
+        mock_pool.connection_kwargs = {
+            "credential_provider": credential_provider,
+        }
+        mock_pool.get_connection.return_value = mock_connection
+        mock_pool._available_connections = [mock_connection, mock_another_connection]
+        mock_pool._lock = threading.Lock()
+
+        Redis(
+            connection_pool=mock_pool,
+            credential_provider=credential_provider,
+        )
+
+        with pytest.raises(RequestTokenErr):
+            credential_provider.get_credentials()
+
+
+@pytest.mark.onlynoncluster
+@pytest.mark.cp_integration
+class TestEntraIdCredentialsProvider:
+    @pytest.mark.parametrize(
+        "r_entra",
+        [
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "single_connection_client": False,
+            },
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "single_connection_client": True,
+            },
+        ],
+        ids=["pool", "single"],
+        indirect=True,
+    )
+    @pytest.mark.onlynoncluster
+    @pytest.mark.cp_integration
+    def test_auth_pool_with_credential_provider(self, r_entra: redis.Redis):
+        assert r_entra.ping() is True
+
+    @pytest.mark.parametrize(
+        "r_entra",
+        [
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "single_connection_client": False,
+            },
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "single_connection_client": True,
+            },
+        ],
+        ids=["pool", "single"],
+        indirect=True,
+    )
+    @pytest.mark.onlynoncluster
+    @pytest.mark.cp_integration
+    def test_auth_pipeline_with_credential_provider(self, r_entra: redis.Redis):
+        pipe = r_entra.pipeline()
+
+        pipe.set("key", "value")
+        pipe.get("key")
+
+        assert pipe.execute() == [True, b"value"]
+
+    @pytest.mark.parametrize(
+        "r_entra",
+        [
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+            },
+        ],
+        indirect=True,
+    )
+    @pytest.mark.onlynoncluster
+    @pytest.mark.cp_integration
+    def test_auth_pubsub_with_credential_provider(self, r_entra: redis.Redis):
+        p = r_entra.pubsub()
+        p.subscribe("entraid")
+
+        r_entra.publish("entraid", "test")
+        r_entra.publish("entraid", "test")
+
+        assert p.get_message()["type"] == "subscribe"
+        assert p.get_message()["type"] == "message"
+
+
+@pytest.mark.onlycluster
+@pytest.mark.cp_integration
+class TestClusterEntraIdCredentialsProvider:
+    @pytest.mark.parametrize(
+        "r_entra",
+        [
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "single_connection_client": False,
+            },
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "single_connection_client": True,
+            },
+        ],
+        ids=["pool", "single"],
+        indirect=True,
+    )
+    @pytest.mark.onlycluster
+    @pytest.mark.cp_integration
+    def test_auth_pool_with_credential_provider(self, r_entra: redis.Redis):
+        assert r_entra.ping() is True

From 3208809c7237522c77dac0daea7af5a14148eebf Mon Sep 17 00:00:00 2001
From: Wout De Nolf <woutdenolf@users.sf.net>
Date: Mon, 23 Dec 2024 10:55:09 +0100
Subject: [PATCH 0945/1164] add missing dependency (#3462)

* add missing dependency

* fix dev_requirements.txt

* Changed main branch to release version

---------

Co-authored-by: vladvildanov <divinez122@outlook.com>
---
 dev_requirements.txt | 2 +-
 setup.py             | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/dev_requirements.txt b/dev_requirements.txt
index 945afc35dc..be74470ec2 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -16,4 +16,4 @@ uvloop
 vulture>=2.3.0
 wheel>=0.30.0
 numpy>=1.24.0
-redispy-entraid-credentials @ git+https://github.com/redis-developer/redispy-entra-credentials.git/@main
+redis-entraid==0.1.0b1
diff --git a/setup.py b/setup.py
index ee3a7c2023..02853251b2 100644
--- a/setup.py
+++ b/setup.py
@@ -38,6 +38,7 @@
     python_requires=">=3.8",
     install_requires=[
         'async-timeout>=4.0.3; python_full_version<"3.11.3"',
+        "PyJWT~=2.9.0",
     ],
     classifiers=[
         "Development Status :: 5 - Production/Stable",

From 8e2f2d3032e067123ed60d90d424a99910cf8891 Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Mon, 23 Dec 2024 13:30:38 +0200
Subject: [PATCH 0946/1164] Added workflow_dispatch for pypi release workflow
 (#3465)

---
 .github/workflows/pypi-publish.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/pypi-publish.yaml b/.github/workflows/pypi-publish.yaml
index 108dfa6da5..e4815aa1b5 100644
--- a/.github/workflows/pypi-publish.yaml
+++ b/.github/workflows/pypi-publish.yaml
@@ -3,6 +3,7 @@ name: Publish tag to Pypi
 on:
   release:
     types: [published]
+  workflow_dispatch:
 
 permissions:
   contents: read  #  to fetch code (actions/checkout)

From a694a79dda3801db509bf3645c5518a8fd35486e Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Mon, 30 Dec 2024 11:06:35 +0200
Subject: [PATCH 0947/1164] Fixed flacky TokenManager test (#3468)

* Fixed flacky TokenManager test

* Fixed additional flacky test

* Removed token count assertion

* Skipped test on version 3.9
---
 tests/test_auth/test_token_manager.py | 36 +++++++++++----------------
 tests/test_connection.py              |  2 ++
 2 files changed, 17 insertions(+), 21 deletions(-)

diff --git a/tests/test_auth/test_token_manager.py b/tests/test_auth/test_token_manager.py
index bb396e246c..cdbf60889d 100644
--- a/tests/test_auth/test_token_manager.py
+++ b/tests/test_auth/test_token_manager.py
@@ -17,17 +17,17 @@
 
 class TestTokenManager:
     @pytest.mark.parametrize(
-        "exp_refresh_ratio,tokens_refreshed",
+        "exp_refresh_ratio",
         [
-            (0.9, 2),
-            (0.28, 4),
+            0.9,
+            0.28,
         ],
         ids=[
-            "Refresh ratio = 0.9,  2 tokens in 0,1 second",
-            "Refresh ratio = 0.28, 4 tokens in 0,1 second",
+            "Refresh ratio = 0.9",
+            "Refresh ratio = 0.28",
         ],
     )
-    def test_success_token_renewal(self, exp_refresh_ratio, tokens_refreshed):
+    def test_success_token_renewal(self, exp_refresh_ratio):
         tokens = []
         mock_provider = Mock(spec=IdentityProviderInterface)
         mock_provider.request_token.side_effect = [
@@ -39,14 +39,14 @@ def test_success_token_renewal(self, exp_refresh_ratio, tokens_refreshed):
             ),
             SimpleToken(
                 "value",
-                (datetime.now(timezone.utc).timestamp() * 1000) + 130,
-                (datetime.now(timezone.utc).timestamp() * 1000) + 30,
+                (datetime.now(timezone.utc).timestamp() * 1000) + 150,
+                (datetime.now(timezone.utc).timestamp() * 1000) + 50,
                 {"oid": "test"},
             ),
             SimpleToken(
                 "value",
-                (datetime.now(timezone.utc).timestamp() * 1000) + 160,
-                (datetime.now(timezone.utc).timestamp() * 1000) + 60,
+                (datetime.now(timezone.utc).timestamp() * 1000) + 170,
+                (datetime.now(timezone.utc).timestamp() * 1000) + 70,
                 {"oid": "test"},
             ),
             SimpleToken(
@@ -70,7 +70,7 @@ def on_next(token):
         mgr.start(mock_listener)
         sleep(0.1)
 
-        assert len(tokens) == tokens_refreshed
+        assert len(tokens) > 0
 
     @pytest.mark.parametrize(
         "exp_refresh_ratio,tokens_refreshed",
@@ -176,19 +176,13 @@ def test_token_renewal_with_skip_initial(self):
         mock_provider.request_token.side_effect = [
             SimpleToken(
                 "value",
-                (datetime.now(timezone.utc).timestamp() * 1000) + 100,
+                (datetime.now(timezone.utc).timestamp() * 1000) + 50,
                 (datetime.now(timezone.utc).timestamp() * 1000),
                 {"oid": "test"},
             ),
             SimpleToken(
                 "value",
-                (datetime.now(timezone.utc).timestamp() * 1000) + 120,
-                (datetime.now(timezone.utc).timestamp() * 1000),
-                {"oid": "test"},
-            ),
-            SimpleToken(
-                "value",
-                (datetime.now(timezone.utc).timestamp() * 1000) + 140,
+                (datetime.now(timezone.utc).timestamp() * 1000) + 150,
                 (datetime.now(timezone.utc).timestamp() * 1000),
                 {"oid": "test"},
             ),
@@ -207,9 +201,9 @@ def on_next(token):
         mgr.start(mock_listener, skip_initial=True)
         # Should be less than a 0.1, or it will be flacky due to
         # additional token renewal.
-        sleep(0.2)
+        sleep(0.1)
 
-        assert len(tokens) == 2
+        assert len(tokens) == 1
 
     @pytest.mark.asyncio
     async def test_async_token_renewal_with_skip_initial(self):
diff --git a/tests/test_connection.py b/tests/test_connection.py
index 7683a1416d..65d80e2574 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -1,6 +1,7 @@
 import copy
 import platform
 import socket
+import sys
 import threading
 import types
 from typing import Any
@@ -249,6 +250,7 @@ def get_redis_connection():
     r1.close()
 
 
+@pytest.mark.skipif(sys.version_info == (3, 9), reason="Flacky test on Python 3.9")
 @pytest.mark.parametrize("from_url", (True, False), ids=("from_url", "from_args"))
 def test_redis_connection_pool(request, from_url):
     """Verify that basic Redis instances using `connection_pool`

From e8e6d99300529c2628d31350b5806589e7ee9ad8 Mon Sep 17 00:00:00 2001
From: zs-neo <48560952+zs-neo@users.noreply.github.com>
Date: Mon, 30 Dec 2024 18:26:05 +0800
Subject: [PATCH 0948/1164] Fix incorrect attribute reuse (#3456)

add CacheEntry

Co-authored-by: zhousheng06 <zhousheng06@meituan.com>
Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
---
 redis/connection.py      | 6 +++++-
 tests/test_connection.py | 5 +----
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/redis/connection.py b/redis/connection.py
index 9d29b4aba6..ace1ed8727 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -904,9 +904,11 @@ def read_response(
                 and self._cache.get(self._current_command_cache_key).status
                 != CacheEntryStatus.IN_PROGRESS
             ):
-                return copy.deepcopy(
+                res = copy.deepcopy(
                     self._cache.get(self._current_command_cache_key).cache_value
                 )
+                self._current_command_cache_key = None
+                return res
 
         response = self._conn.read_response(
             disable_decoding=disable_decoding,
@@ -932,6 +934,8 @@ def read_response(
                 cache_entry.cache_value = response
                 self._cache.set(cache_entry)
 
+            self._current_command_cache_key = None
+
         return response
 
     def pack_command(self, *args):
diff --git a/tests/test_connection.py b/tests/test_connection.py
index 65d80e2574..fbc23ae8c0 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -501,9 +501,9 @@ def test_read_response_returns_cached_reply(self, mock_cache, mock_connection):
         )
         proxy_connection.send_command(*["GET", "foo"], **{"keys": ["foo"]})
         assert proxy_connection.read_response() == b"bar"
+        assert proxy_connection._current_command_cache_key is None
         assert proxy_connection.read_response() == b"bar"
 
-        mock_connection.read_response.assert_called_once()
         mock_cache.set.assert_has_calls(
             [
                 call(
@@ -530,9 +530,6 @@ def test_read_response_returns_cached_reply(self, mock_cache, mock_connection):
                 call(CacheKey(command="GET", redis_keys=("foo",))),
                 call(CacheKey(command="GET", redis_keys=("foo",))),
                 call(CacheKey(command="GET", redis_keys=("foo",))),
-                call(CacheKey(command="GET", redis_keys=("foo",))),
-                call(CacheKey(command="GET", redis_keys=("foo",))),
-                call(CacheKey(command="GET", redis_keys=("foo",))),
             ]
         )
 

From 49e434e376a1375a3d42748018903a063b2a3d3d Mon Sep 17 00:00:00 2001
From: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
Date: Mon, 6 Jan 2025 04:39:41 -0800
Subject: [PATCH 0949/1164] Expand type for EncodedT (#3472)

As of PEP 688, type checkers will no longer implicitly consider bytearray to be compatible with bytes
---
 redis/typing.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/typing.py b/redis/typing.py
index b4d442c444..24ad607480 100644
--- a/redis/typing.py
+++ b/redis/typing.py
@@ -20,7 +20,7 @@
 
 
 Number = Union[int, float]
-EncodedT = Union[bytes, memoryview]
+EncodedT = Union[bytes, bytearray, memoryview]
 DecodedT = Union[str, int, float]
 EncodableT = Union[EncodedT, DecodedT]
 AbsExpiryT = Union[int, datetime]

From 9dfaeae4c328acdad76fc0d86c4d2abf78c53b95 Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Mon, 6 Jan 2025 17:23:03 +0200
Subject: [PATCH 0950/1164] Moved self._lock initialisation to Pool constructor
 (#3473)

* Moved self._lock initialisation to Pool constructor

* Added test case

* Codestyle fixes

* Added correct annotations
---
 redis/connection.py           |  2 +-
 tests/test_connection_pool.py | 28 ++++++++++++++++++++++++----
 2 files changed, 25 insertions(+), 5 deletions(-)

diff --git a/redis/connection.py b/redis/connection.py
index ace1ed8727..d905c6481b 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1378,6 +1378,7 @@ def __init__(
         # will notice the first thread already did the work and simply
         # release the lock.
         self._fork_lock = threading.Lock()
+        self._lock = threading.Lock()
         self.reset()
 
     def __repr__(self) -> (str, str):
@@ -1395,7 +1396,6 @@ def get_protocol(self):
         return self.connection_kwargs.get("protocol", None)
 
     def reset(self) -> None:
-        self._lock = threading.Lock()
         self._created_connections = 0
         self._available_connections = []
         self._in_use_connections = set()
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index dee7c554d3..118294ee1b 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -7,10 +7,16 @@
 
 import pytest
 import redis
-from redis.connection import to_bool
-from redis.utils import SSL_AVAILABLE
-
-from .conftest import _get_client, skip_if_redis_enterprise, skip_if_server_version_lt
+from redis.cache import CacheConfig
+from redis.connection import CacheProxyConnection, Connection, to_bool
+from redis.utils import HIREDIS_AVAILABLE, SSL_AVAILABLE
+
+from .conftest import (
+    _get_client,
+    skip_if_redis_enterprise,
+    skip_if_resp_version,
+    skip_if_server_version_lt,
+)
 from .test_pubsub import wait_for_message
 
 
@@ -196,6 +202,20 @@ def test_repr_contains_db_info_unix(self):
         expected = "path=abc,db=0,client_name=test-client"
         assert expected in repr(pool)
 
+    @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
+    @pytest.mark.onlynoncluster
+    @skip_if_resp_version(2)
+    @skip_if_server_version_lt("7.4.0")
+    def test_initialise_pool_with_cache(self, master_host):
+        pool = redis.BlockingConnectionPool(
+            connection_class=Connection,
+            host=master_host[0],
+            port=master_host[1],
+            protocol=3,
+            cache_config=CacheConfig(),
+        )
+        assert isinstance(pool.get_connection("_"), CacheProxyConnection)
+
 
 class TestConnectionPoolURLParsing:
     def test_hostname(self):

From 7a6b412fa86f019b590da8625efd04114f119965 Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Thu, 9 Jan 2025 14:21:33 +0200
Subject: [PATCH 0951/1164] Changed default dialect to 2 (#3467)

* Changed default dialect to 2

* Codestyle fixes

* Fixed async tests

* Added handling of RESP3 responses

* Fixed flacky tests

* Codestyle fix

* Added separate file to hold default value
---
 redis/commands/search/aggregation.py  |   4 +-
 redis/commands/search/dialect.py      |   3 +
 redis/commands/search/query.py        |   4 +-
 tests/test_asyncio/test_search.py     |   2 +-
 tests/test_auth/test_token_manager.py |  20 ++---
 tests/test_search.py                  | 118 ++++++++++++++++++--------
 6 files changed, 102 insertions(+), 49 deletions(-)
 create mode 100644 redis/commands/search/dialect.py

diff --git a/redis/commands/search/aggregation.py b/redis/commands/search/aggregation.py
index 5638f1d662..13edefa081 100644
--- a/redis/commands/search/aggregation.py
+++ b/redis/commands/search/aggregation.py
@@ -1,5 +1,7 @@
 from typing import List, Union
 
+from redis.commands.search.dialect import DEFAULT_DIALECT
+
 FIELDNAME = object()
 
 
@@ -110,7 +112,7 @@ def __init__(self, query: str = "*") -> None:
         self._with_schema = False
         self._verbatim = False
         self._cursor = []
-        self._dialect = None
+        self._dialect = DEFAULT_DIALECT
         self._add_scores = False
         self._scorer = "TFIDF"
 
diff --git a/redis/commands/search/dialect.py b/redis/commands/search/dialect.py
new file mode 100644
index 0000000000..828b3f2a43
--- /dev/null
+++ b/redis/commands/search/dialect.py
@@ -0,0 +1,3 @@
+# Value for the default dialect to be used as a part of
+# Search or Aggregate query.
+DEFAULT_DIALECT = 2
diff --git a/redis/commands/search/query.py b/redis/commands/search/query.py
index 84d60a7cec..964ce6cdf4 100644
--- a/redis/commands/search/query.py
+++ b/redis/commands/search/query.py
@@ -1,5 +1,7 @@
 from typing import List, Optional, Union
 
+from redis.commands.search.dialect import DEFAULT_DIALECT
+
 
 class Query:
     """
@@ -40,7 +42,7 @@ def __init__(self, query_string: str) -> None:
         self._highlight_fields: List = []
         self._language: Optional[str] = None
         self._expander: Optional[str] = None
-        self._dialect: Optional[int] = None
+        self._dialect: int = DEFAULT_DIALECT
 
     def query_string(self) -> str:
         """Return the query string of this query only."""
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 5260605039..cc75e4b4a4 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -1646,7 +1646,7 @@ async def test_search_commands_in_pipeline(decoded_r: redis.Redis):
 @pytest.mark.redismod
 async def test_query_timeout(decoded_r: redis.Redis):
     q1 = Query("foo").timeout(5000)
-    assert q1.get_args() == ["foo", "TIMEOUT", 5000, "LIMIT", 0, 10]
+    assert q1.get_args() == ["foo", "TIMEOUT", 5000, "DIALECT", 2, "LIMIT", 0, 10]
     q2 = Query("foo").timeout("not_a_number")
     with pytest.raises(redis.ResponseError):
         await decoded_r.ft().search(q2)
diff --git a/tests/test_auth/test_token_manager.py b/tests/test_auth/test_token_manager.py
index cdbf60889d..f675c125dd 100644
--- a/tests/test_auth/test_token_manager.py
+++ b/tests/test_auth/test_token_manager.py
@@ -73,20 +73,18 @@ def on_next(token):
         assert len(tokens) > 0
 
     @pytest.mark.parametrize(
-        "exp_refresh_ratio,tokens_refreshed",
+        "exp_refresh_ratio",
         [
-            (0.9, 2),
-            (0.28, 4),
+            (0.9),
+            (0.28),
         ],
         ids=[
-            "Refresh ratio = 0.9,  2 tokens in 0,1 second",
-            "Refresh ratio = 0.28, 4 tokens in 0,1 second",
+            "Refresh ratio = 0.9",
+            "Refresh ratio = 0.28",
         ],
     )
     @pytest.mark.asyncio
-    async def test_async_success_token_renewal(
-        self, exp_refresh_ratio, tokens_refreshed
-    ):
+    async def test_async_success_token_renewal(self, exp_refresh_ratio):
         tokens = []
         mock_provider = Mock(spec=IdentityProviderInterface)
         mock_provider.request_token.side_effect = [
@@ -129,7 +127,7 @@ async def on_next(token):
         await mgr.start_async(mock_listener, block_for_initial=True)
         await asyncio.sleep(0.1)
 
-        assert len(tokens) == tokens_refreshed
+        assert len(tokens) > 0
 
     @pytest.mark.parametrize(
         "block_for_initial,tokens_acquired",
@@ -203,7 +201,7 @@ def on_next(token):
         # additional token renewal.
         sleep(0.1)
 
-        assert len(tokens) == 1
+        assert len(tokens) > 0
 
     @pytest.mark.asyncio
     async def test_async_token_renewal_with_skip_initial(self):
@@ -245,7 +243,7 @@ async def on_next(token):
         # due to additional token renewal.
         await asyncio.sleep(0.2)
 
-        assert len(tokens) == 2
+        assert len(tokens) > 0
 
     def test_success_token_renewal_with_retry(self):
         tokens = []
diff --git a/tests/test_search.py b/tests/test_search.py
index c6e9a3717f..a257484425 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -2122,7 +2122,7 @@ def test_profile_query_params(client):
     client.hset("b", "v", "aaaabaaa")
     client.hset("c", "v", "aaaaabaa")
     query = "*=>[KNN 2 @v $vec]"
-    q = Query(query).return_field("__v_score").sort_by("__v_score", True).dialect(2)
+    q = Query(query).return_field("__v_score").sort_by("__v_score", True)
     if is_resp2_connection(client):
         res, det = client.ft().profile(q, query_params={"vec": "aaaaaaaa"})
         assert det["Iterators profile"]["Counter"] == 2.0
@@ -2155,7 +2155,7 @@ def test_vector_field(client):
     client.hset("c", "v", "aaaaabaa")
 
     query = "*=>[KNN 2 @v $vec]"
-    q = Query(query).return_field("__v_score").sort_by("__v_score", True).dialect(2)
+    q = Query(query).return_field("__v_score").sort_by("__v_score", True)
     res = client.ft().search(q, query_params={"vec": "aaaaaaaa"})
 
     if is_resp2_connection(client):
@@ -2191,7 +2191,7 @@ def test_text_params(client):
     client.hset("doc3", mapping={"name": "Carol"})
 
     params_dict = {"name1": "Alice", "name2": "Bob"}
-    q = Query("@name:($name1 | $name2 )").dialect(2)
+    q = Query("@name:($name1 | $name2 )")
     res = client.ft().search(q, query_params=params_dict)
     if is_resp2_connection(client):
         assert 2 == res.total
@@ -2214,7 +2214,7 @@ def test_numeric_params(client):
     client.hset("doc3", mapping={"numval": 103})
 
     params_dict = {"min": 101, "max": 102}
-    q = Query("@numval:[$min $max]").dialect(2)
+    q = Query("@numval:[$min $max]")
     res = client.ft().search(q, query_params=params_dict)
 
     if is_resp2_connection(client):
@@ -2236,7 +2236,7 @@ def test_geo_params(client):
     client.hset("doc3", mapping={"g": "29.68746, 34.94882"})
 
     params_dict = {"lat": "34.95126", "lon": "29.69465", "radius": 1000, "units": "km"}
-    q = Query("@g:[$lon $lat $radius $units]").dialect(2)
+    q = Query("@g:[$lon $lat $radius $units]")
     res = client.ft().search(q, query_params=params_dict)
     _assert_search_result(client, res, ["doc1", "doc2", "doc3"])
 
@@ -2355,19 +2355,19 @@ def test_dialect(client):
     with pytest.raises(redis.ResponseError) as err:
         client.ft().explain(Query("(*)").dialect(1))
     assert "Syntax error" in str(err)
-    assert "WILDCARD" in client.ft().explain(Query("(*)").dialect(2))
+    assert "WILDCARD" in client.ft().explain(Query("(*)"))
 
     with pytest.raises(redis.ResponseError) as err:
         client.ft().explain(Query("$hello").dialect(1))
     assert "Syntax error" in str(err)
-    q = Query("$hello").dialect(2)
+    q = Query("$hello")
     expected = "UNION {\n  hello\n  +hello(expanded)\n}\n"
     assert expected in client.ft().explain(q, query_params={"hello": "hello"})
 
     expected = "NUMERIC {0.000000 <= @num <= 10.000000}\n"
     assert expected in client.ft().explain(Query("@title:(@num:[0 10])").dialect(1))
     with pytest.raises(redis.ResponseError) as err:
-        client.ft().explain(Query("@title:(@num:[0 10])").dialect(2))
+        client.ft().explain(Query("@title:(@num:[0 10])"))
     assert "Syntax error" in str(err)
 
 
@@ -2438,9 +2438,9 @@ def test_withsuffixtrie(client: redis.Redis):
 @pytest.mark.redismod
 def test_query_timeout(r: redis.Redis):
     q1 = Query("foo").timeout(5000)
-    assert q1.get_args() == ["foo", "TIMEOUT", 5000, "LIMIT", 0, 10]
+    assert q1.get_args() == ["foo", "TIMEOUT", 5000, "DIALECT", 2, "LIMIT", 0, 10]
     q1 = Query("foo").timeout(0)
-    assert q1.get_args() == ["foo", "TIMEOUT", 0, "LIMIT", 0, 10]
+    assert q1.get_args() == ["foo", "TIMEOUT", 0, "DIALECT", 2, "LIMIT", 0, 10]
     q2 = Query("foo").timeout("not_a_number")
     with pytest.raises(redis.ResponseError):
         r.ft().search(q2)
@@ -2507,28 +2507,26 @@ def test_search_missing_fields(client):
     )
 
     with pytest.raises(redis.exceptions.ResponseError) as e:
-        client.ft().search(
-            Query("ismissing(@title)").dialect(2).return_field("id").no_content()
-        )
+        client.ft().search(Query("ismissing(@title)").return_field("id").no_content())
     assert "to be defined with 'INDEXMISSING'" in e.value.args[0]
 
     res = client.ft().search(
-        Query("ismissing(@features)").dialect(2).return_field("id").no_content()
+        Query("ismissing(@features)").return_field("id").no_content()
     )
     _assert_search_result(client, res, ["property:2"])
 
     res = client.ft().search(
-        Query("-ismissing(@features)").dialect(2).return_field("id").no_content()
+        Query("-ismissing(@features)").return_field("id").no_content()
     )
     _assert_search_result(client, res, ["property:1", "property:3"])
 
     res = client.ft().search(
-        Query("ismissing(@description)").dialect(2).return_field("id").no_content()
+        Query("ismissing(@description)").return_field("id").no_content()
     )
     _assert_search_result(client, res, ["property:3"])
 
     res = client.ft().search(
-        Query("-ismissing(@description)").dialect(2).return_field("id").no_content()
+        Query("-ismissing(@description)").return_field("id").no_content()
     )
     _assert_search_result(client, res, ["property:1", "property:2"])
 
@@ -2578,31 +2576,25 @@ def test_search_empty_fields(client):
     )
 
     with pytest.raises(redis.exceptions.ResponseError) as e:
-        client.ft().search(
-            Query("@title:''").dialect(2).return_field("id").no_content()
-        )
+        client.ft().search(Query("@title:''").return_field("id").no_content())
     assert "Use `INDEXEMPTY` in field creation" in e.value.args[0]
 
     res = client.ft().search(
-        Query("@features:{$empty}").dialect(2).return_field("id").no_content(),
+        Query("@features:{$empty}").return_field("id").no_content(),
         query_params={"empty": ""},
     )
     _assert_search_result(client, res, ["property:2"])
 
     res = client.ft().search(
-        Query("-@features:{$empty}").dialect(2).return_field("id").no_content(),
+        Query("-@features:{$empty}").return_field("id").no_content(),
         query_params={"empty": ""},
     )
     _assert_search_result(client, res, ["property:1", "property:3"])
 
-    res = client.ft().search(
-        Query("@description:''").dialect(2).return_field("id").no_content()
-    )
+    res = client.ft().search(Query("@description:''").return_field("id").no_content())
     _assert_search_result(client, res, ["property:3"])
 
-    res = client.ft().search(
-        Query("-@description:''").dialect(2).return_field("id").no_content()
-    )
+    res = client.ft().search(Query("-@description:''").return_field("id").no_content())
     _assert_search_result(client, res, ["property:1", "property:2"])
 
 
@@ -2643,29 +2635,85 @@ def test_special_characters_in_fields(client):
 
     # no need to escape - when using params
     res = client.ft().search(
-        Query("@uuid:{$uuid}").dialect(2),
+        Query("@uuid:{$uuid}"),
         query_params={"uuid": "123e4567-e89b-12d3-a456-426614174000"},
     )
     _assert_search_result(client, res, ["resource:1"])
 
     # with double quotes exact match no need to escape the - even without params
-    res = client.ft().search(
-        Query('@uuid:{"123e4567-e89b-12d3-a456-426614174000"}').dialect(2)
-    )
+    res = client.ft().search(Query('@uuid:{"123e4567-e89b-12d3-a456-426614174000"}'))
     _assert_search_result(client, res, ["resource:1"])
 
-    res = client.ft().search(Query('@tags:{"new-year\'s-resolutions"}').dialect(2))
+    res = client.ft().search(Query('@tags:{"new-year\'s-resolutions"}'))
     _assert_search_result(client, res, ["resource:2"])
 
     # possible to search numeric fields by single value
-    res = client.ft().search(Query("@rating:[4]").dialect(2))
+    res = client.ft().search(Query("@rating:[4]"))
     _assert_search_result(client, res, ["resource:2"])
 
     # some chars still need escaping
-    res = client.ft().search(Query(r"@tags:{\$btc}").dialect(2))
+    res = client.ft().search(Query(r"@tags:{\$btc}"))
     _assert_search_result(client, res, ["resource:1"])
 
 
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+def test_vector_search_with_default_dialect(client):
+    client.ft().create_index(
+        (
+            VectorField(
+                "v", "HNSW", {"TYPE": "FLOAT32", "DIM": 2, "DISTANCE_METRIC": "L2"}
+            ),
+        )
+    )
+
+    client.hset("a", "v", "aaaaaaaa")
+    client.hset("b", "v", "aaaabaaa")
+    client.hset("c", "v", "aaaaabaa")
+
+    query = "*=>[KNN 2 @v $vec]"
+    q = Query(query)
+
+    assert "DIALECT" in q.get_args()
+    assert 2 in q.get_args()
+
+    res = client.ft().search(q, query_params={"vec": "aaaaaaaa"})
+    if is_resp2_connection(client):
+        assert res.total == 2
+    else:
+        assert res["total_results"] == 2
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+def test_search_query_with_different_dialects(client):
+    client.ft().create_index(
+        (TextField("name"), TextField("lastname")),
+        definition=IndexDefinition(prefix=["test:"]),
+    )
+
+    client.hset("test:1", "name", "James")
+    client.hset("test:1", "lastname", "Brown")
+
+    # Query with default DIALECT 2
+    query = "@name: James Brown"
+    q = Query(query)
+    res = client.ft().search(q)
+    if is_resp2_connection(client):
+        assert res.total == 1
+    else:
+        assert res["total_results"] == 1
+
+    # Query with explicit DIALECT 1
+    query = "@name: James Brown"
+    q = Query(query).dialect(1)
+    res = client.ft().search(q)
+    if is_resp2_connection(client):
+        assert res.total == 0
+    else:
+        assert res["total_results"] == 0
+
+
 def _assert_search_result(client, result, expected_doc_ids):
     """
     Make sure the result of a geo search is as expected, taking into account the RESP

From fab31b4d87d9d0e2a0d7a8eb9fce3bebf665d6e7 Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Wed, 15 Jan 2025 12:00:51 +0200
Subject: [PATCH 0952/1164] Moved ClusterParser exceptions to BaseParser class
 (#3475)

* Moved ClusterParser exceptions to BaseParser class

* Codestyle fixes

* Removed ubused imports

* Sorted imports
---
 docs/clustering.rst      |  4 ++--
 redis/_parsers/base.py   | 12 ++++++++++++
 redis/asyncio/cluster.py | 27 ++-------------------------
 redis/cluster.py         | 19 +------------------
 4 files changed, 17 insertions(+), 45 deletions(-)

diff --git a/docs/clustering.rst b/docs/clustering.rst
index f8320e4e59..cf257d8ad5 100644
--- a/docs/clustering.rst
+++ b/docs/clustering.rst
@@ -17,8 +17,8 @@ Nodes <#specifying-target-nodes>`__ \| `Multi-key
 Commands <#multi-key-commands>`__ \| `Known PubSub
 Limitations <#known-pubsub-limitations>`__
 
-Creating clusters
------------------
+Connecting to cluster
+---------------------
 
 Connecting redis-py to a Redis Cluster instance(s) requires at a minimum
 a single node for cluster discovery. There are multiple ways in which a
diff --git a/redis/_parsers/base.py b/redis/_parsers/base.py
index 0137539d66..91a4f74199 100644
--- a/redis/_parsers/base.py
+++ b/redis/_parsers/base.py
@@ -9,18 +9,24 @@
     from async_timeout import timeout as async_timeout
 
 from ..exceptions import (
+    AskError,
     AuthenticationError,
     AuthenticationWrongNumberOfArgsError,
     BusyLoadingError,
+    ClusterCrossSlotError,
+    ClusterDownError,
     ConnectionError,
     ExecAbortError,
+    MasterDownError,
     ModuleError,
+    MovedError,
     NoPermissionError,
     NoScriptError,
     OutOfMemoryError,
     ReadOnlyError,
     RedisError,
     ResponseError,
+    TryAgainError,
 )
 from ..typing import EncodableT
 from .encoders import Encoder
@@ -72,6 +78,12 @@ class BaseParser(ABC):
         "READONLY": ReadOnlyError,
         "NOAUTH": AuthenticationError,
         "NOPERM": NoPermissionError,
+        "ASK": AskError,
+        "TRYAGAIN": TryAgainError,
+        "MOVED": MovedError,
+        "CLUSTERDOWN": ClusterDownError,
+        "CROSSSLOT": ClusterCrossSlotError,
+        "MASTERDOWN": MasterDownError,
     }
 
     @classmethod
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 408fa19363..87a2c16afa 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -26,7 +26,7 @@
     _RedisCallbacksRESP3,
 )
 from redis.asyncio.client import ResponseCallbackT
-from redis.asyncio.connection import Connection, DefaultParser, SSLConnection, parse_url
+from redis.asyncio.connection import Connection, SSLConnection, parse_url
 from redis.asyncio.lock import Lock
 from redis.asyncio.retry import Retry
 from redis.auth.token import TokenInterface
@@ -50,12 +50,10 @@
 from redis.exceptions import (
     AskError,
     BusyLoadingError,
-    ClusterCrossSlotError,
     ClusterDownError,
     ClusterError,
     ConnectionError,
     DataError,
-    MasterDownError,
     MaxConnectionsError,
     MovedError,
     RedisClusterException,
@@ -66,33 +64,13 @@
     TryAgainError,
 )
 from redis.typing import AnyKeyT, EncodableT, KeyT
-from redis.utils import (
-    deprecated_function,
-    dict_merge,
-    get_lib_version,
-    safe_str,
-    str_if_bytes,
-)
+from redis.utils import deprecated_function, get_lib_version, safe_str, str_if_bytes
 
 TargetNodesT = TypeVar(
     "TargetNodesT", str, "ClusterNode", List["ClusterNode"], Dict[Any, "ClusterNode"]
 )
 
 
-class ClusterParser(DefaultParser):
-    EXCEPTION_CLASSES = dict_merge(
-        DefaultParser.EXCEPTION_CLASSES,
-        {
-            "ASK": AskError,
-            "CLUSTERDOWN": ClusterDownError,
-            "CROSSSLOT": ClusterCrossSlotError,
-            "MASTERDOWN": MasterDownError,
-            "MOVED": MovedError,
-            "TRYAGAIN": TryAgainError,
-        },
-    )
-
-
 class RedisCluster(AbstractRedis, AbstractRedisCluster, AsyncRedisClusterCommands):
     """
     Create a new RedisCluster client.
@@ -297,7 +275,6 @@ def __init__(
         kwargs: Dict[str, Any] = {
             "max_connections": max_connections,
             "connection_class": Connection,
-            "parser_class": ClusterParser,
             # Client related kwargs
             "credential_provider": credential_provider,
             "username": username,
diff --git a/redis/cluster.py b/redis/cluster.py
index 38bd5dde1a..8718493759 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -13,7 +13,7 @@
 from redis.client import CaseInsensitiveDict, PubSub, Redis
 from redis.commands import READ_COMMANDS, RedisClusterCommands
 from redis.commands.helpers import list_or_args
-from redis.connection import ConnectionPool, DefaultParser, parse_url
+from redis.connection import ConnectionPool, parse_url
 from redis.crc import REDIS_CLUSTER_HASH_SLOTS, key_slot
 from redis.event import (
     AfterPooledConnectionsInstantiationEvent,
@@ -24,12 +24,10 @@
 from redis.exceptions import (
     AskError,
     AuthenticationError,
-    ClusterCrossSlotError,
     ClusterDownError,
     ClusterError,
     ConnectionError,
     DataError,
-    MasterDownError,
     MovedError,
     RedisClusterException,
     RedisError,
@@ -193,20 +191,6 @@ def cleanup_kwargs(**kwargs):
     return connection_kwargs
 
 
-class ClusterParser(DefaultParser):
-    EXCEPTION_CLASSES = dict_merge(
-        DefaultParser.EXCEPTION_CLASSES,
-        {
-            "ASK": AskError,
-            "TRYAGAIN": TryAgainError,
-            "MOVED": MovedError,
-            "CLUSTERDOWN": ClusterDownError,
-            "CROSSSLOT": ClusterCrossSlotError,
-            "MASTERDOWN": MasterDownError,
-        },
-    )
-
-
 class AbstractRedisCluster:
     RedisClusterRequestTTL = 16
 
@@ -692,7 +676,6 @@ def on_connect(self, connection):
         Initialize the connection, authenticate and select a database and send
          READONLY if it is set during object initialization.
         """
-        connection.set_parser(ClusterParser)
         connection.on_connect()
 
         if self.read_from_replicas:

From afabed6a881b5940ed64a2c1e0ec109f18826eb7 Mon Sep 17 00:00:00 2001
From: David Dougherty <dwdougherty@gmail.com>
Date: Fri, 17 Jan 2025 00:28:35 -0800
Subject: [PATCH 0953/1164] DOC-4423: add TCEs for various command pages
 (#3476)

Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
---
 doctests/cmds_cnxmgmt.py    |  36 +++++++++++
 doctests/cmds_hash.py       |  24 +++++++
 doctests/cmds_list.py       | 123 ++++++++++++++++++++++++++++++++++++
 doctests/cmds_servermgmt.py |  30 +++++++++
 doctests/cmds_set.py        |  35 ++++++++++
 5 files changed, 248 insertions(+)
 create mode 100644 doctests/cmds_cnxmgmt.py
 create mode 100644 doctests/cmds_list.py
 create mode 100644 doctests/cmds_servermgmt.py
 create mode 100644 doctests/cmds_set.py

diff --git a/doctests/cmds_cnxmgmt.py b/doctests/cmds_cnxmgmt.py
new file mode 100644
index 0000000000..c691f723cf
--- /dev/null
+++ b/doctests/cmds_cnxmgmt.py
@@ -0,0 +1,36 @@
+# EXAMPLE: cmds_cnxmgmt
+# HIDE_START
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+
+# STEP_START auth1
+# REMOVE_START
+r.config_set("requirepass", "temp_pass")
+# REMOVE_END
+res1 = r.auth(password="temp_pass")
+print(res1) # >>> True
+
+res2 = r.auth(password="temp_pass", username="default")
+print(res2) # >>> True
+
+# REMOVE_START
+assert res1 == True
+assert res2 == True
+r.config_set("requirepass", "")
+# REMOVE_END
+# STEP_END
+
+# STEP_START auth2
+# REMOVE_START
+r.acl_setuser("test-user", enabled=True, passwords=["+strong_password"], commands=["+acl"])
+# REMOVE_END
+res = r.auth(username="test-user", password="strong_password")
+print(res) # >>> True
+
+# REMOVE_START
+assert res == True
+r.acl_deluser("test-user")
+# REMOVE_END
+# STEP_END
diff --git a/doctests/cmds_hash.py b/doctests/cmds_hash.py
index 0bc1cb8038..65bbd52d60 100644
--- a/doctests/cmds_hash.py
+++ b/doctests/cmds_hash.py
@@ -61,3 +61,27 @@
 r.delete("myhash")
 # REMOVE_END
 # STEP_END
+
+# STEP_START hgetall
+res10 = r.hset("myhash", mapping={"field1": "Hello", "field2": "World"})
+
+res11 = r.hgetall("myhash")
+print(res11) # >>> { "field1": "Hello", "field2": "World" }
+
+# REMOVE_START
+assert res11 == { "field1": "Hello", "field2": "World" }
+r.delete("myhash")
+# REMOVE_END
+# STEP_END
+
+# STEP_START hvals
+res10 = r.hset("myhash", mapping={"field1": "Hello", "field2": "World"})
+
+res11 = r.hvals("myhash")
+print(res11) # >>> [ "Hello", "World" ]
+
+# REMOVE_START
+assert res11 == [ "Hello", "World" ]
+r.delete("myhash")
+# REMOVE_END
+# STEP_END
\ No newline at end of file
diff --git a/doctests/cmds_list.py b/doctests/cmds_list.py
new file mode 100644
index 0000000000..cce2d540a8
--- /dev/null
+++ b/doctests/cmds_list.py
@@ -0,0 +1,123 @@
+# EXAMPLE: cmds_list
+# HIDE_START
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+
+# STEP_START lpush
+res1 = r.lpush("mylist", "world")
+print(res1) # >>> 1
+
+res2 = r.lpush("mylist", "hello")
+print(res2) # >>> 2
+
+res3 = r.lrange("mylist", 0, -1)
+print(res3)  # >>> [ "hello", "world" ]
+
+# REMOVE_START
+assert res3 == [ "hello", "world" ]
+r.delete("mylist")
+# REMOVE_END
+# STEP_END
+
+# STEP_START lrange
+res4 = r.rpush("mylist", "one");
+print(res4) # >>> 1
+
+res5 = r.rpush("mylist", "two")
+print(res5) # >>> 2
+
+res6 = r.rpush("mylist", "three")
+print(res6) # >>> 3
+
+res7 = r.lrange('mylist', 0, 0)
+print(res7) # >>> [ 'one' ]
+
+res8 = r.lrange('mylist', -3, 2)
+print(res8) # >>> [ 'one', 'two', 'three' ]
+
+res9 = r.lrange('mylist', -100, 100)
+print(res9) # >>> [ 'one', 'two', 'three' ]
+
+res10 = r.lrange('mylist', 5, 10)
+print(res10) # >>> []
+
+# REMOVE_START
+assert res7 == [ 'one' ]
+assert res8 == [ 'one', 'two', 'three' ]
+assert res9 == [ 'one', 'two', 'three' ]
+assert res10 == []
+r.delete('mylist')
+# REMOVE_END
+# STEP_END
+
+# STEP_START llen
+res11 = r.lpush("mylist", "World")
+print(res11) # >>> 1
+
+res12 = r.lpush("mylist", "Hello")
+print(res12) # >>> 2
+
+res13 = r.llen("mylist")
+print(res13)  # >>> 2
+
+# REMOVE_START
+assert res13 == 2
+r.delete("mylist")
+# REMOVE_END
+# STEP_END
+
+# STEP_START rpush
+res14 = r.rpush("mylist", "hello")
+print(res14) # >>> 1
+
+res15 = r.rpush("mylist", "world")
+print(res15) # >>> 2
+
+res16 = r.lrange("mylist", 0, -1)
+print(res16)  # >>> [ "hello", "world" ]
+
+# REMOVE_START
+assert res16 == [ "hello", "world" ]
+r.delete("mylist")
+# REMOVE_END
+# STEP_END
+
+# STEP_START lpop
+res17 = r.rpush("mylist", *["one", "two", "three", "four", "five"])
+print(res17) # >>> 5
+
+res18 = r.lpop("mylist")
+print(res18) # >>> "one"
+
+res19 = r.lpop("mylist", 2)
+print(res19) # >>> ['two', 'three']
+
+res17 = r.lrange("mylist", 0, -1)
+print(res17)  # >>> [ "four", "five" ]
+
+# REMOVE_START
+assert res17 == [ "four", "five" ]
+r.delete("mylist")
+# REMOVE_END
+# STEP_END
+
+# STEP_START rpop
+res18 = r.rpush("mylist", *["one", "two", "three", "four", "five"])
+print(res18) # >>> 5
+
+res19 = r.rpop("mylist")
+print(res19) # >>> "five"
+
+res20 = r.rpop("mylist", 2)
+print(res20) # >>> ['four', 'three']
+
+res21 = r.lrange("mylist", 0, -1)
+print(res21)  # >>> [ "one", "two" ]
+
+# REMOVE_START
+assert res21 == [ "one", "two" ]
+r.delete("mylist")
+# REMOVE_END
+# STEP_END
\ No newline at end of file
diff --git a/doctests/cmds_servermgmt.py b/doctests/cmds_servermgmt.py
new file mode 100644
index 0000000000..6ad2b6acb2
--- /dev/null
+++ b/doctests/cmds_servermgmt.py
@@ -0,0 +1,30 @@
+# EXAMPLE: cmds_servermgmt
+# HIDE_START
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+
+# STEP_START flushall
+# REMOVE_START
+r.set("foo", "1")
+r.set("bar", "2")
+r.set("baz", "3")
+# REMOVE_END
+res1 = r.flushall(asynchronous=False)
+print(res1) # >>> True
+
+res2 = r.keys()
+print(res2) # >>> []
+
+# REMOVE_START
+assert res1 == True
+assert res2 == []
+# REMOVE_END
+# STEP_END
+
+# STEP_START info
+res3 = r.info()
+print(res3)
+# >>> {'redis_version': '7.4.0', 'redis_git_sha1': 'c9d29f6a',...}
+# STEP_END
\ No newline at end of file
diff --git a/doctests/cmds_set.py b/doctests/cmds_set.py
new file mode 100644
index 0000000000..ece74e8cf0
--- /dev/null
+++ b/doctests/cmds_set.py
@@ -0,0 +1,35 @@
+# EXAMPLE: cmds_set
+# HIDE_START
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+
+# STEP_START sadd
+res1 = r.sadd("myset", "Hello", "World")
+print(res1)  # >>> 2
+
+res2 = r.sadd("myset", "World")
+print(res2)  # >>> 0
+
+res3 = r.smembers("myset")
+print(res3)  # >>> {'Hello', 'World'}
+
+# REMOVE_START
+assert res3 == {'Hello', 'World'}
+r.delete('myset')
+# REMOVE_END
+# STEP_END
+
+# STEP_START smembers
+res4 = r.sadd("myset", "Hello", "World")
+print(res4)  # >>> 2
+
+res5 = r.smembers("myset")
+print(res5)  # >>> {'Hello', 'World'}
+
+# REMOVE_START
+assert res5 == {'Hello', 'World'}
+r.delete('myset')
+# REMOVE_END
+# STEP_END
\ No newline at end of file

From eff310f31cc1d6d8f6f67f01876470a34ce1159a Mon Sep 17 00:00:00 2001
From: andy-stark-redis <164213578+andy-stark-redis@users.noreply.github.com>
Date: Tue, 21 Jan 2025 09:06:48 +0000
Subject: [PATCH 0954/1164] DOC-4345 added testable JSON search examples for
 home page (#3407)

* DOC-4345 added testable JSON search examples for home page

* DOC-4345 avoid possible non-deterministic results in tests

* DOC-4345 close connection at end of example

* DOC-4345 remove unnecessary blank lines
---
 doctests/home_json.py | 137 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 137 insertions(+)
 create mode 100644 doctests/home_json.py

diff --git a/doctests/home_json.py b/doctests/home_json.py
new file mode 100644
index 0000000000..922c83d2fe
--- /dev/null
+++ b/doctests/home_json.py
@@ -0,0 +1,137 @@
+# EXAMPLE: py_home_json
+"""
+JSON examples from redis-py "home" page"
+ https://redis.io/docs/latest/develop/connect/clients/python/redis-py/#example-indexing-and-querying-json-documents
+"""
+
+# STEP_START import
+import redis
+from redis.commands.json.path import Path
+import redis.commands.search.aggregation as aggregations
+import redis.commands.search.reducers as reducers
+from redis.commands.search.field import TextField, NumericField, TagField
+from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.query import Query
+import redis.exceptions
+# STEP_END
+
+# STEP_START connect
+r = redis.Redis(decode_responses=True)
+# STEP_END
+
+# REMOVE_START
+try:
+    r.ft("idx:users").dropindex(True)
+except redis.exceptions.ResponseError:
+    pass
+
+r.delete("user:1", "user:2", "user:3")
+# REMOVE_END
+# STEP_START create_data
+user1 = {
+    "name": "Paul John",
+    "email": "paul.john@example.com",
+    "age": 42,
+    "city": "London"
+}
+
+user2 = {
+    "name": "Eden Zamir",
+    "email": "eden.zamir@example.com",
+    "age": 29,
+    "city": "Tel Aviv"
+}
+
+user3 = {
+    "name": "Paul Zamir",
+    "email": "paul.zamir@example.com",
+    "age": 35,
+    "city": "Tel Aviv"
+}
+# STEP_END
+
+# STEP_START make_index
+schema = (
+    TextField("$.name", as_name="name"),
+    TagField("$.city", as_name="city"),
+    NumericField("$.age", as_name="age")
+)
+
+indexCreated = r.ft("idx:users").create_index(
+    schema,
+    definition=IndexDefinition(
+        prefix=["user:"], index_type=IndexType.JSON
+    )
+)
+# STEP_END
+# Tests for 'make_index' step.
+# REMOVE_START
+assert indexCreated
+# REMOVE_END
+
+# STEP_START add_data
+user1Set = r.json().set("user:1", Path.root_path(), user1)
+user2Set = r.json().set("user:2", Path.root_path(), user2)
+user3Set = r.json().set("user:3", Path.root_path(), user3)
+# STEP_END
+# Tests for 'add_data' step.
+# REMOVE_START
+assert user1Set
+assert user2Set
+assert user3Set
+# REMOVE_END
+
+# STEP_START query1
+findPaulResult = r.ft("idx:users").search(
+    Query("Paul @age:[30 40]")
+)
+
+print(findPaulResult)
+# >>> Result{1 total, docs: [Document {'id': 'user:3', ...
+# STEP_END
+# Tests for 'query1' step.
+# REMOVE_START
+assert str(findPaulResult) == (
+    "Result{1 total, docs: [Document {'id': 'user:3', 'payload': None, "
+    + "'json': '{\"name\":\"Paul Zamir\",\"email\":"
+    + "\"paul.zamir@example.com\",\"age\":35,\"city\":\"Tel Aviv\"}'}]}"
+)
+# REMOVE_END
+
+# STEP_START query2
+citiesResult = r.ft("idx:users").search(
+    Query("Paul").return_field("$.city", as_field="city")
+).docs
+
+print(citiesResult)
+# >>> [Document {'id': 'user:1', 'payload': None, ...
+# STEP_END
+# Tests for 'query2' step.
+# REMOVE_START
+citiesResult.sort(key=lambda doc: doc['id'])
+
+assert str(citiesResult) == (
+    "[Document {'id': 'user:1', 'payload': None, 'city': 'London'}, "
+    + "Document {'id': 'user:3', 'payload': None, 'city': 'Tel Aviv'}]"
+)
+# REMOVE_END
+
+# STEP_START query3
+req = aggregations.AggregateRequest("*").group_by(
+    '@city', reducers.count().alias('count')
+)
+
+aggResult = r.ft("idx:users").aggregate(req).rows
+print(aggResult)
+# >>> [['city', 'London', 'count', '1'], ['city', 'Tel Aviv', 'count', '2']]
+# STEP_END
+# Tests for 'query3' step.
+# REMOVE_START
+aggResult.sort(key=lambda row: row[1])
+
+assert str(aggResult) == (
+    "[['city', 'London', 'count', '1'], ['city', 'Tel Aviv', 'count', '2']]"
+)
+# REMOVE_END
+
+r.close()

From b2dd8e8c1cf64ba58c4dc331e6b805e6f15c8f0a Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Tue, 21 Jan 2025 11:24:42 +0200
Subject: [PATCH 0955/1164] Added Redis 8.0 to test matrix (#3469)

* Added Redis 8.0 to test matrix

* Fixed test cases

* Added version annotation

* Changed FT.PROFILE response type

* Added version restrictions

* Updated file names, fixed tests assertions

* Removed unused API
---
 .github/workflows/integration.yaml            |   2 +-
 doctests/query_agg.py                         |   2 +-
 doctests/query_combined.py                    |   2 +-
 doctests/query_em.py                          |   2 +-
 doctests/query_ft.py                          |   2 +-
 doctests/query_geo.py                         |   2 +-
 doctests/query_range.py                       |   2 +-
 doctests/search_quickstart.py                 |   2 +-
 doctests/search_vss.py                        |   2 +-
 redis/commands/helpers.py                     |  23 ---
 redis/commands/search/commands.py             |   9 +-
 ...indexDefinition.py => index_definition.py} |   0
 redis/commands/search/profile_information.py  |  14 ++
 tests/test_asyncio/test_search.py             |  18 ++-
 tests/test_commands.py                        |  26 +++
 tests/test_helpers.py                         |  35 ----
 tests/test_search.py                          | 149 +++++++++++++++---
 17 files changed, 195 insertions(+), 97 deletions(-)
 rename redis/commands/search/{indexDefinition.py => index_definition.py} (100%)
 create mode 100644 redis/commands/search/profile_information.py

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 7c74de5290..c32029e6f9 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -74,7 +74,7 @@ jobs:
       max-parallel: 15
       fail-fast: false
       matrix:
-        redis-version: [ '${{ needs.redis_version.outputs.CURRENT }}', '7.2.6', '6.2.16']
+        redis-version: ['8.0-M02', '${{ needs.redis_version.outputs.CURRENT }}', '7.2.6', '6.2.16']
         python-version: ['3.8', '3.12']
         parser-backend: ['plain']
         event-loop: ['asyncio']
diff --git a/doctests/query_agg.py b/doctests/query_agg.py
index 4fa8f14b84..4d81ddbcda 100644
--- a/doctests/query_agg.py
+++ b/doctests/query_agg.py
@@ -6,7 +6,7 @@
 from redis.commands.search import Search
 from redis.commands.search.aggregation import AggregateRequest
 from redis.commands.search.field import NumericField, TagField
-from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.index_definition import IndexDefinition, IndexType
 import redis.commands.search.reducers as reducers
 
 r = redis.Redis(decode_responses=True)
diff --git a/doctests/query_combined.py b/doctests/query_combined.py
index a17f19417c..e6dd5a2cb5 100644
--- a/doctests/query_combined.py
+++ b/doctests/query_combined.py
@@ -6,7 +6,7 @@
 import warnings
 from redis.commands.json.path import Path
 from redis.commands.search.field import NumericField, TagField, TextField, VectorField
-from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.index_definition import IndexDefinition, IndexType
 from redis.commands.search.query import Query
 from sentence_transformers import  SentenceTransformer
 
diff --git a/doctests/query_em.py b/doctests/query_em.py
index a00ff11150..91cc5ae940 100644
--- a/doctests/query_em.py
+++ b/doctests/query_em.py
@@ -4,7 +4,7 @@
 import redis
 from redis.commands.json.path import Path
 from redis.commands.search.field import TextField, NumericField, TagField
-from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.index_definition import IndexDefinition, IndexType
 from redis.commands.search.query import NumericFilter, Query
 
 r = redis.Redis(decode_responses=True)
diff --git a/doctests/query_ft.py b/doctests/query_ft.py
index 182a5b2bd3..6272cdab25 100644
--- a/doctests/query_ft.py
+++ b/doctests/query_ft.py
@@ -5,7 +5,7 @@
 import redis
 from redis.commands.json.path import Path
 from redis.commands.search.field import TextField, NumericField, TagField
-from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.index_definition import IndexDefinition, IndexType
 from redis.commands.search.query import NumericFilter, Query
 
 r = redis.Redis(decode_responses=True)
diff --git a/doctests/query_geo.py b/doctests/query_geo.py
index dcb7db6ee7..ed8c9a5f99 100644
--- a/doctests/query_geo.py
+++ b/doctests/query_geo.py
@@ -5,7 +5,7 @@
 import redis
 from redis.commands.json.path import Path
 from redis.commands.search.field import GeoField, GeoShapeField
-from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.index_definition import IndexDefinition, IndexType
 from redis.commands.search.query import Query
 
 r = redis.Redis(decode_responses=True)
diff --git a/doctests/query_range.py b/doctests/query_range.py
index 4ef957acfb..674afc492a 100644
--- a/doctests/query_range.py
+++ b/doctests/query_range.py
@@ -5,7 +5,7 @@
 import redis
 from redis.commands.json.path import Path
 from redis.commands.search.field import TextField, NumericField, TagField
-from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.index_definition import IndexDefinition, IndexType
 from redis.commands.search.query import NumericFilter, Query
 
 r = redis.Redis(decode_responses=True)
diff --git a/doctests/search_quickstart.py b/doctests/search_quickstart.py
index e190393b16..cde4caa84a 100644
--- a/doctests/search_quickstart.py
+++ b/doctests/search_quickstart.py
@@ -10,7 +10,7 @@
 import redis.commands.search.reducers as reducers
 from redis.commands.json.path import Path
 from redis.commands.search.field import NumericField, TagField, TextField
-from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.index_definition import IndexDefinition, IndexType
 from redis.commands.search.query import Query
 
 # HIDE_END
diff --git a/doctests/search_vss.py b/doctests/search_vss.py
index 8b4884727a..a1132971db 100644
--- a/doctests/search_vss.py
+++ b/doctests/search_vss.py
@@ -20,7 +20,7 @@
     TextField,
     VectorField,
 )
-from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.index_definition import IndexDefinition, IndexType
 from redis.commands.search.query import Query
 from sentence_transformers import SentenceTransformer
 
diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
index 1ea02a60cf..7d9095ea41 100644
--- a/redis/commands/helpers.py
+++ b/redis/commands/helpers.py
@@ -79,29 +79,6 @@ def parse_list_to_dict(response):
     return res
 
 
-def parse_to_dict(response):
-    if response is None:
-        return {}
-
-    res = {}
-    for det in response:
-        if not isinstance(det, list) or not det:
-            continue
-        if len(det) == 1:
-            res[det[0]] = True
-        elif isinstance(det[1], list):
-            res[det[0]] = parse_list_to_dict(det[1])
-        else:
-            try:  # try to set the attribute. may be provided without value
-                try:  # try to convert the value to float
-                    res[det[0]] = float(det[1])
-                except (TypeError, ValueError):
-                    res[det[0]] = det[1]
-            except IndexError:
-                pass
-    return res
-
-
 def random_string(length=10):
     """
     Returns a random N character long string.
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index da79016ad4..2447959922 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -5,12 +5,13 @@
 from redis.client import NEVER_DECODE, Pipeline
 from redis.utils import deprecated_function
 
-from ..helpers import get_protocol_version, parse_to_dict
+from ..helpers import get_protocol_version
 from ._util import to_string
 from .aggregation import AggregateRequest, AggregateResult, Cursor
 from .document import Document
 from .field import Field
-from .indexDefinition import IndexDefinition
+from .index_definition import IndexDefinition
+from .profile_information import ProfileInformation
 from .query import Query
 from .result import Result
 from .suggestion import SuggestionParser
@@ -67,7 +68,7 @@ class SearchCommands:
 
     def _parse_results(self, cmd, res, **kwargs):
         if get_protocol_version(self.client) in ["3", 3]:
-            return res
+            return ProfileInformation(res) if cmd == "FT.PROFILE" else res
         else:
             return self._RESP2_MODULE_CALLBACKS[cmd](res, **kwargs)
 
@@ -101,7 +102,7 @@ def _parse_profile(self, res, **kwargs):
                 with_scores=query._with_scores,
             )
 
-        return result, parse_to_dict(res[1])
+        return result, ProfileInformation(res[1])
 
     def _parse_spellcheck(self, res, **kwargs):
         corrections = {}
diff --git a/redis/commands/search/indexDefinition.py b/redis/commands/search/index_definition.py
similarity index 100%
rename from redis/commands/search/indexDefinition.py
rename to redis/commands/search/index_definition.py
diff --git a/redis/commands/search/profile_information.py b/redis/commands/search/profile_information.py
new file mode 100644
index 0000000000..23551be27f
--- /dev/null
+++ b/redis/commands/search/profile_information.py
@@ -0,0 +1,14 @@
+from typing import Any
+
+
+class ProfileInformation:
+    """
+    Wrapper around FT.PROFILE response
+    """
+
+    def __init__(self, info: Any) -> None:
+        self._info: Any = info
+
+    @property
+    def info(self) -> Any:
+        return self._info
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index cc75e4b4a4..4f5a4c2f04 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -19,7 +19,7 @@
     TextField,
     VectorField,
 )
-from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.index_definition import IndexDefinition, IndexType
 from redis.commands.search.query import GeoFilter, NumericFilter, Query
 from redis.commands.search.result import Result
 from redis.commands.search.suggestion import Suggestion
@@ -27,6 +27,8 @@
     is_resp2_connection,
     skip_if_redis_enterprise,
     skip_if_resp_version,
+    skip_if_server_version_gte,
+    skip_if_server_version_lt,
     skip_ifmodversion_lt,
 )
 
@@ -1111,6 +1113,7 @@ async def test_get(decoded_r: redis.Redis):
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("2.2.0", "search")
+@skip_if_server_version_gte("7.9.0")
 async def test_config(decoded_r: redis.Redis):
     assert await decoded_r.ft().config_set("TIMEOUT", "100")
     with pytest.raises(redis.ResponseError):
@@ -1121,6 +1124,19 @@ async def test_config(decoded_r: redis.Redis):
     assert "100" == res["TIMEOUT"]
 
 
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+@skip_if_server_version_lt("7.9.0")
+async def test_config_with_removed_ftconfig(decoded_r: redis.Redis):
+    assert await decoded_r.config_set("timeout", "100")
+    with pytest.raises(redis.ResponseError):
+        await decoded_r.config_set("timeout", "null")
+    res = await decoded_r.config_get("*")
+    assert "100" == res["timeout"]
+    res = await decoded_r.config_get("timeout")
+    assert "100" == res["timeout"]
+
+
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
 async def test_aggregations_groupby(decoded_r: redis.Redis):
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 4cad4c14b6..2681b8eaf0 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1823,6 +1823,7 @@ def try_delete_libs(self, r, *lib_names):
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("7.1.140")
+    @skip_if_server_version_gte("7.9.0")
     def test_tfunction_load_delete(self, stack_r):
         self.try_delete_libs(stack_r, "lib1")
         lib_code = self.generate_lib_code("lib1")
@@ -1831,6 +1832,7 @@ def test_tfunction_load_delete(self, stack_r):
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("7.1.140")
+    @skip_if_server_version_gte("7.9.0")
     def test_tfunction_list(self, stack_r):
         self.try_delete_libs(stack_r, "lib1", "lib2", "lib3")
         assert stack_r.tfunction_load(self.generate_lib_code("lib1"))
@@ -1861,6 +1863,7 @@ def test_tfunction_list(self, stack_r):
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("7.1.140")
+    @skip_if_server_version_gte("7.9.0")
     def test_tfcall(self, stack_r):
         self.try_delete_libs(stack_r, "lib1")
         assert stack_r.tfunction_load(self.generate_lib_code("lib1"))
@@ -4329,6 +4332,7 @@ def test_xgroup_create_mkstream(self, r):
         assert r.xinfo_groups(stream) == expected
 
     @skip_if_server_version_lt("7.0.0")
+    @skip_if_server_version_gte("7.9.0")
     def test_xgroup_create_entriesread(self, r: redis.Redis):
         stream = "stream"
         group = "group"
@@ -4350,6 +4354,28 @@ def test_xgroup_create_entriesread(self, r: redis.Redis):
         ]
         assert r.xinfo_groups(stream) == expected
 
+    @skip_if_server_version_lt("7.9.0")
+    def test_xgroup_create_entriesread_with_fixed_lag_field(self, r: redis.Redis):
+        stream = "stream"
+        group = "group"
+        r.xadd(stream, {"foo": "bar"})
+
+        # no group is setup yet, no info to obtain
+        assert r.xinfo_groups(stream) == []
+
+        assert r.xgroup_create(stream, group, 0, entries_read=7)
+        expected = [
+            {
+                "name": group.encode(),
+                "consumers": 0,
+                "pending": 0,
+                "last-delivered-id": b"0-0",
+                "entries-read": 7,
+                "lag": 1,
+            }
+        ]
+        assert r.xinfo_groups(stream) == expected
+
     @skip_if_server_version_lt("5.0.0")
     def test_xgroup_delconsumer(self, r):
         stream = "stream"
diff --git a/tests/test_helpers.py b/tests/test_helpers.py
index 66ee1c5390..06265d382e 100644
--- a/tests/test_helpers.py
+++ b/tests/test_helpers.py
@@ -4,7 +4,6 @@
     delist,
     list_or_args,
     nativestr,
-    parse_to_dict,
     parse_to_list,
     quote_string,
     random_string,
@@ -26,40 +25,6 @@ def test_parse_to_list():
     assert parse_to_list(r) == ["hello", "my name", 45, 555.55, "is simon!", None]
 
 
-def test_parse_to_dict():
-    assert parse_to_dict(None) == {}
-    r = [
-        ["Some number", "1.0345"],
-        ["Some string", "hello"],
-        [
-            "Child iterators",
-            [
-                "Time",
-                "0.2089",
-                "Counter",
-                3,
-                "Child iterators",
-                ["Type", "bar", "Time", "0.0729", "Counter", 3],
-                ["Type", "barbar", "Time", "0.058", "Counter", 3],
-                ["Type", "barbarbar", "Time", "0.0234", "Counter", 3],
-            ],
-        ],
-    ]
-    assert parse_to_dict(r) == {
-        "Child iterators": {
-            "Child iterators": [
-                {"Counter": 3.0, "Time": 0.0729, "Type": "bar"},
-                {"Counter": 3.0, "Time": 0.058, "Type": "barbar"},
-                {"Counter": 3.0, "Time": 0.0234, "Type": "barbarbar"},
-            ],
-            "Counter": 3.0,
-            "Time": 0.2089,
-        },
-        "Some number": 1.0345,
-        "Some string": "hello",
-    }
-
-
 def test_nativestr():
     assert nativestr("teststr") == "teststr"
     assert nativestr(b"teststr") == "teststr"
diff --git a/tests/test_search.py b/tests/test_search.py
index a257484425..ee1ba66434 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -20,7 +20,7 @@
     TextField,
     VectorField,
 )
-from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.index_definition import IndexDefinition, IndexType
 from redis.commands.search.query import GeoFilter, NumericFilter, Query
 from redis.commands.search.result import Result
 from redis.commands.search.suggestion import Suggestion
@@ -30,6 +30,7 @@
     is_resp2_connection,
     skip_if_redis_enterprise,
     skip_if_resp_version,
+    skip_if_server_version_gte,
     skip_if_server_version_lt,
     skip_ifmodversion_lt,
 )
@@ -1007,6 +1008,7 @@ def test_get(client):
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
 @skip_ifmodversion_lt("2.2.0", "search")
+@skip_if_server_version_gte("7.9.0")
 def test_config(client):
     assert client.ft().config_set("TIMEOUT", "100")
     with pytest.raises(redis.ResponseError):
@@ -1017,6 +1019,19 @@ def test_config(client):
     assert "100" == res["TIMEOUT"]
 
 
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+@skip_if_server_version_lt("7.9.0")
+def test_config_with_removed_ftconfig(client):
+    assert client.config_set("timeout", "100")
+    with pytest.raises(redis.ResponseError):
+        client.config_set("timeout", "null")
+    res = client.config_get("*")
+    assert "100" == res["timeout"]
+    res = client.config_get("timeout")
+    assert "100" == res["timeout"]
+
+
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
 def test_aggregations_groupby(client):
@@ -1571,6 +1586,7 @@ def test_index_definition(client):
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
 @skip_if_redis_enterprise()
+@skip_if_server_version_gte("7.9.0")
 def test_expire(client):
     client.ft().create_index((TextField("txt", sortable=True),), temporary=4)
     ttl = client.execute_command("ft.debug", "TTL", "idx")
@@ -2025,6 +2041,8 @@ def test_json_with_jsonpath(client):
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
 @skip_if_redis_enterprise()
+@skip_if_server_version_gte("7.9.0")
+@skip_if_server_version_lt("6.3.0")
 def test_profile(client):
     client.ft().create_index((TextField("t"),))
     client.ft().client.hset("1", "t", "hello")
@@ -2034,10 +2052,9 @@ def test_profile(client):
     q = Query("hello|world").no_content()
     if is_resp2_connection(client):
         res, det = client.ft().profile(q)
-        assert det["Iterators profile"]["Counter"] == 2.0
-        assert len(det["Iterators profile"]["Child iterators"]) == 2
-        assert det["Iterators profile"]["Type"] == "UNION"
-        assert det["Parsing time"] < 0.5
+        det = det.info
+
+        assert isinstance(det, list)
         assert len(res.docs) == 2  # check also the search result
 
         # check using AggregateRequest
@@ -2047,15 +2064,14 @@ def test_profile(client):
             .apply(prefix="startswith(@t, 'hel')")
         )
         res, det = client.ft().profile(req)
-        assert det["Iterators profile"]["Counter"] == 2
-        assert det["Iterators profile"]["Type"] == "WILDCARD"
-        assert isinstance(det["Parsing time"], float)
+        det = det.info
+        assert isinstance(det, list)
         assert len(res.rows) == 2  # check also the search result
     else:
         res = client.ft().profile(q)
-        assert res["profile"]["Iterators profile"][0]["Counter"] == 2.0
-        assert res["profile"]["Iterators profile"][0]["Type"] == "UNION"
-        assert res["profile"]["Parsing time"] < 0.5
+        res = res.info
+
+        assert isinstance(res, dict)
         assert len(res["results"]) == 2  # check also the search result
 
         # check using AggregateRequest
@@ -2065,14 +2081,97 @@ def test_profile(client):
             .apply(prefix="startswith(@t, 'hel')")
         )
         res = client.ft().profile(req)
-        assert res["profile"]["Iterators profile"][0]["Counter"] == 2
-        assert res["profile"]["Iterators profile"][0]["Type"] == "WILDCARD"
-        assert isinstance(res["profile"]["Parsing time"], float)
+        res = res.info
+
+        assert isinstance(res, dict)
         assert len(res["results"]) == 2  # check also the search result
 
 
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
+@skip_if_redis_enterprise()
+@skip_if_server_version_lt("7.9.0")
+def test_profile_with_coordinator(client):
+    client.ft().create_index((TextField("t"),))
+    client.ft().client.hset("1", "t", "hello")
+    client.ft().client.hset("2", "t", "world")
+
+    # check using Query
+    q = Query("hello|world").no_content()
+    if is_resp2_connection(client):
+        res, det = client.ft().profile(q)
+        det = det.info
+
+        assert isinstance(det, list)
+        assert len(res.docs) == 2  # check also the search result
+
+        # check using AggregateRequest
+        req = (
+            aggregations.AggregateRequest("*")
+            .load("t")
+            .apply(prefix="startswith(@t, 'hel')")
+        )
+        res, det = client.ft().profile(req)
+        det = det.info
+
+        assert isinstance(det, list)
+        assert det[0] == "Shards"
+        assert det[2] == "Coordinator"
+        assert len(res.rows) == 2  # check also the search result
+    else:
+        res = client.ft().profile(q)
+        res = res.info
+
+        assert isinstance(res, dict)
+        assert len(res["Results"]["results"]) == 2  # check also the search result
+
+        # check using AggregateRequest
+        req = (
+            aggregations.AggregateRequest("*")
+            .load("t")
+            .apply(prefix="startswith(@t, 'hel')")
+        )
+        res = client.ft().profile(req)
+        res = res.info
+
+        assert isinstance(res, dict)
+        assert len(res["Results"]["results"]) == 2  # check also the search result
+
+
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+@skip_if_redis_enterprise()
+@skip_if_server_version_gte("6.3.0")
+def test_profile_with_no_warnings(client):
+    client.ft().create_index((TextField("t"),))
+    client.ft().client.hset("1", "t", "hello")
+    client.ft().client.hset("2", "t", "world")
+
+    # check using Query
+    q = Query("hello|world").no_content()
+    res, det = client.ft().profile(q)
+    det = det.info
+
+    assert isinstance(det, list)
+    assert len(res.docs) == 2  # check also the search result
+
+    # check using AggregateRequest
+    req = (
+        aggregations.AggregateRequest("*")
+        .load("t")
+        .apply(prefix="startswith(@t, 'hel')")
+    )
+    res, det = client.ft().profile(req)
+    det = det.info
+
+    assert isinstance(det, list)
+    assert len(res.rows) == 2  # check also the search result
+
+
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+@skip_if_server_version_gte("7.9.0")
+@skip_if_server_version_lt("6.3.0")
 def test_profile_limited(client):
     client.ft().create_index((TextField("t"),))
     client.ft().client.hset("1", "t", "hello")
@@ -2083,18 +2182,14 @@ def test_profile_limited(client):
     q = Query("%hell% hel*")
     if is_resp2_connection(client):
         res, det = client.ft().profile(q, limited=True)
-        assert (
-            det["Iterators profile"]["Child iterators"][0]["Child iterators"]
-            == "The number of iterators in the union is 3"
-        )
-        assert (
-            det["Iterators profile"]["Child iterators"][1]["Child iterators"]
-            == "The number of iterators in the union is 4"
-        )
-        assert det["Iterators profile"]["Type"] == "INTERSECT"
+        det = det.info
+        assert det[4][1][7][9] == "The number of iterators in the union is 3"
+        assert det[4][1][8][9] == "The number of iterators in the union is 4"
+        assert det[4][1][1] == "INTERSECT"
         assert len(res.docs) == 3  # check also the search result
     else:
         res = client.ft().profile(q, limited=True)
+        res = res.info
         iterators_profile = res["profile"]["Iterators profile"]
         assert (
             iterators_profile[0]["Child iterators"][0]["Child iterators"]
@@ -2110,6 +2205,8 @@ def test_profile_limited(client):
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_gte("7.9.0")
+@skip_if_server_version_lt("6.3.0")
 def test_profile_query_params(client):
     client.ft().create_index(
         (
@@ -2125,13 +2222,15 @@ def test_profile_query_params(client):
     q = Query(query).return_field("__v_score").sort_by("__v_score", True)
     if is_resp2_connection(client):
         res, det = client.ft().profile(q, query_params={"vec": "aaaaaaaa"})
-        assert det["Iterators profile"]["Counter"] == 2.0
-        assert det["Iterators profile"]["Type"] == "VECTOR"
+        det = det.info
+        assert det[4][1][5] == 2.0
+        assert det[4][1][1] == "VECTOR"
         assert res.total == 2
         assert "a" == res.docs[0].id
         assert "0" == res.docs[0].__getattribute__("__v_score")
     else:
         res = client.ft().profile(q, query_params={"vec": "aaaaaaaa"})
+        res = res.info
         assert res["profile"]["Iterators profile"][0]["Counter"] == 2
         assert res["profile"]["Iterators profile"][0]["Type"] == "VECTOR"
         assert res["total_results"] == 2

From e0906519ee8b5c8f0664cc01334c324d0d4be269 Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Tue, 28 Jan 2025 10:50:49 +0200
Subject: [PATCH 0956/1164] Updated test infrastructure with latest versions
 (#3484)

* Updated latest image to 8.0-M03-pre

* Changed redis image for testing purposes

* Updated image version

* Updated redis server versions

* Updated test case

* Revert version restriction

* Updated redis versions

* Added tests for new default scorer

* Skipped test on 8.0

* Fixed query to match exact-match syntax

* Codestyle fixes

* Added condition for 8.0-M04-pre image

* Added test for INFO section
---
 .github/actions/run-tests/action.yml | 10 ++-
 .github/workflows/integration.yaml   |  4 +-
 redis/commands/search/query.py       |  2 +
 tests/test_asyncio/test_search.py    | 94 +++++++++++++++++++++++++++-
 tests/test_commands.py               | 23 -------
 tests/test_search.py                 | 89 ++++++++++++++++++++++++--
 6 files changed, 186 insertions(+), 36 deletions(-)

diff --git a/.github/actions/run-tests/action.yml b/.github/actions/run-tests/action.yml
index 5ca6bf5a09..1f9332fb86 100644
--- a/.github/actions/run-tests/action.yml
+++ b/.github/actions/run-tests/action.yml
@@ -35,6 +35,10 @@ runs:
         CLIENT_LIBS_TEST_IMAGE: "redislabs/client-libs-test:${{ inputs.redis-version }}"
       run: |
         set -e
+        
+        if [ "${{inputs.redis-version}}" == "8.0-M04-pre" ]; then
+          export REDIS_IMAGE=redis:8.0-M03
+        fi
                 
         echo "::group::Installing dependencies"
         pip install -U setuptools wheel
@@ -56,9 +60,9 @@ runs:
         
           # Mapping of redis version to stack version  
           declare -A redis_stack_version_mapping=(
-            ["7.4.1"]="7.4.0-v1"
-            ["7.2.6"]="7.2.0-v13"
-            ["6.2.16"]="6.2.6-v17"
+            ["7.4.2"]="7.4.0-v2"
+            ["7.2.7"]="7.2.0-v14"
+            ["6.2.17"]="6.2.6-v18"
           )
                   
           if [[ -v redis_stack_version_mapping[$REDIS_VERSION] ]]; then
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index c32029e6f9..c4548c21ef 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -29,7 +29,7 @@ env:
   COVERAGE_CORE: sysmon
   REDIS_IMAGE: redis:latest
   REDIS_STACK_IMAGE: redis/redis-stack-server:latest
-  CURRENT_REDIS_VERSION: '7.4.1'
+  CURRENT_REDIS_VERSION: '7.4.2'
 
 jobs:
   dependency-audit:
@@ -74,7 +74,7 @@ jobs:
       max-parallel: 15
       fail-fast: false
       matrix:
-        redis-version: ['8.0-M02', '${{ needs.redis_version.outputs.CURRENT }}', '7.2.6', '6.2.16']
+        redis-version: ['8.0-M04-pre', '${{ needs.redis_version.outputs.CURRENT }}', '7.2.7', '6.2.17']
         python-version: ['3.8', '3.12']
         parser-backend: ['plain']
         event-loop: ['asyncio']
diff --git a/redis/commands/search/query.py b/redis/commands/search/query.py
index 964ce6cdf4..a8312a2ad2 100644
--- a/redis/commands/search/query.py
+++ b/redis/commands/search/query.py
@@ -179,6 +179,8 @@ def scorer(self, scorer: str) -> "Query":
         Use a different scoring function to evaluate document relevance.
         Default is `TFIDF`.
 
+        Since Redis 8.0 default was changed to BM25STD.
+
         :param scorer: The scoring function to use
                        (e.g. `TFIDF.DOCNORM` or `BM25`)
         """
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 4f5a4c2f04..c0efcce882 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -341,6 +341,7 @@ async def test_client(decoded_r: redis.Redis):
 
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
+@skip_if_server_version_gte("7.9.0")
 async def test_scores(decoded_r: redis.Redis):
     await decoded_r.ft().create_index((TextField("txt"),))
 
@@ -361,6 +362,29 @@ async def test_scores(decoded_r: redis.Redis):
         assert "doc1" == res["results"][1]["id"]
 
 
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+@skip_if_server_version_lt("7.9.0")
+async def test_scores_with_new_default_scorer(decoded_r: redis.Redis):
+    await decoded_r.ft().create_index((TextField("txt"),))
+
+    await decoded_r.hset("doc1", mapping={"txt": "foo baz"})
+    await decoded_r.hset("doc2", mapping={"txt": "foo bar"})
+
+    q = Query("foo ~bar").with_scores()
+    res = await decoded_r.ft().search(q)
+    if is_resp2_connection(decoded_r):
+        assert 2 == res.total
+        assert "doc2" == res.docs[0].id
+        assert 0.87 == pytest.approx(res.docs[0].score, 0.01)
+        assert "doc1" == res.docs[1].id
+    else:
+        assert 2 == res["total_results"]
+        assert "doc2" == res["results"][0]["id"]
+        assert 0.87 == pytest.approx(res["results"][0]["score"], 0.01)
+        assert "doc1" == res["results"][1]["id"]
+
+
 @pytest.mark.redismod
 async def test_stopwords(decoded_r: redis.Redis):
     stopwords = ["foo", "bar", "baz"]
@@ -663,7 +687,7 @@ async def test_summarize(decoded_r: redis.Redis):
     await createIndex(decoded_r.ft())
     await waitForIndex(decoded_r, "idx")
 
-    q = Query("king henry").paging(0, 1)
+    q = Query('"king henry"').paging(0, 1)
     q.highlight(fields=("play", "txt"), tags=("<b>", "</b>"))
     q.summarize("txt")
 
@@ -675,7 +699,7 @@ async def test_summarize(decoded_r: redis.Redis):
             == doc.txt
         )
 
-        q = Query("king henry").paging(0, 1).summarize().highlight()
+        q = Query('"king henry"').paging(0, 1).summarize().highlight()
 
         doc = sorted((await decoded_r.ft().search(q)).docs)[0]
         assert "<b>Henry</b> ... " == doc.play
@@ -691,7 +715,7 @@ async def test_summarize(decoded_r: redis.Redis):
             == doc["extra_attributes"]["txt"]
         )
 
-        q = Query("king henry").paging(0, 1).summarize().highlight()
+        q = Query('"king henry"').paging(0, 1).summarize().highlight()
 
         doc = sorted((await decoded_r.ft().search(q))["results"])[0]
         assert "<b>Henry</b> ... " == doc["extra_attributes"]["play"]
@@ -1029,6 +1053,7 @@ async def test_phonetic_matcher(decoded_r: redis.Redis):
 @pytest.mark.onlynoncluster
 # NOTE(imalinovskyi): This test contains hardcoded scores valid only for RediSearch 2.8+
 @skip_ifmodversion_lt("2.8.0", "search")
+@skip_if_server_version_gte("7.9.0")
 async def test_scorer(decoded_r: redis.Redis):
     await decoded_r.ft().create_index((TextField("description"),))
 
@@ -1087,6 +1112,69 @@ async def test_scorer(decoded_r: redis.Redis):
         assert 0.0 == res["results"][0]["score"]
 
 
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+# NOTE(imalinovskyi): This test contains hardcoded scores valid only for RediSearch 2.8+
+@skip_ifmodversion_lt("2.8.0", "search")
+@skip_if_server_version_lt("7.9.0")
+async def test_scorer_with_new_default_scorer(decoded_r: redis.Redis):
+    await decoded_r.ft().create_index((TextField("description"),))
+
+    await decoded_r.hset(
+        "doc1", mapping={"description": "The quick brown fox jumps over the lazy dog"}
+    )
+    await decoded_r.hset(
+        "doc2",
+        mapping={
+            "description": "Quick alice was beginning to get very tired of sitting by her quick sister on the bank, and of having nothing to do."  # noqa
+        },
+    )
+
+    if is_resp2_connection(decoded_r):
+        # default scorer is BM25STD
+        res = await decoded_r.ft().search(Query("quick").with_scores())
+        assert 0.23 == pytest.approx(res.docs[0].score, 0.05)
+        res = await decoded_r.ft().search(Query("quick").scorer("TFIDF").with_scores())
+        assert 1.0 == res.docs[0].score
+        res = await decoded_r.ft().search(
+            Query("quick").scorer("TFIDF.DOCNORM").with_scores()
+        )
+        assert 0.14285714285714285 == res.docs[0].score
+        res = await decoded_r.ft().search(Query("quick").scorer("BM25").with_scores())
+        assert 0.22471909420069797 == res.docs[0].score
+        res = await decoded_r.ft().search(Query("quick").scorer("DISMAX").with_scores())
+        assert 2.0 == res.docs[0].score
+        res = await decoded_r.ft().search(
+            Query("quick").scorer("DOCSCORE").with_scores()
+        )
+        assert 1.0 == res.docs[0].score
+        res = await decoded_r.ft().search(
+            Query("quick").scorer("HAMMING").with_scores()
+        )
+        assert 0.0 == res.docs[0].score
+    else:
+        res = await decoded_r.ft().search(Query("quick").with_scores())
+        assert 0.23 == pytest.approx(res["results"][0]["score"], 0.05)
+        res = await decoded_r.ft().search(Query("quick").scorer("TFIDF").with_scores())
+        assert 1.0 == res["results"][0]["score"]
+        res = await decoded_r.ft().search(
+            Query("quick").scorer("TFIDF.DOCNORM").with_scores()
+        )
+        assert 0.14285714285714285 == res["results"][0]["score"]
+        res = await decoded_r.ft().search(Query("quick").scorer("BM25").with_scores())
+        assert 0.22471909420069797 == res["results"][0]["score"]
+        res = await decoded_r.ft().search(Query("quick").scorer("DISMAX").with_scores())
+        assert 2.0 == res["results"][0]["score"]
+        res = await decoded_r.ft().search(
+            Query("quick").scorer("DOCSCORE").with_scores()
+        )
+        assert 1.0 == res["results"][0]["score"]
+        res = await decoded_r.ft().search(
+            Query("quick").scorer("HAMMING").with_scores()
+        )
+        assert 0.0 == res["results"][0]["score"]
+
+
 @pytest.mark.redismod
 async def test_get(decoded_r: redis.Redis):
     await decoded_r.ft().create_index((TextField("f1"), TextField("f2")))
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 2681b8eaf0..f83fe76aa9 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -4332,7 +4332,6 @@ def test_xgroup_create_mkstream(self, r):
         assert r.xinfo_groups(stream) == expected
 
     @skip_if_server_version_lt("7.0.0")
-    @skip_if_server_version_gte("7.9.0")
     def test_xgroup_create_entriesread(self, r: redis.Redis):
         stream = "stream"
         group = "group"
@@ -4341,28 +4340,6 @@ def test_xgroup_create_entriesread(self, r: redis.Redis):
         # no group is setup yet, no info to obtain
         assert r.xinfo_groups(stream) == []
 
-        assert r.xgroup_create(stream, group, 0, entries_read=7)
-        expected = [
-            {
-                "name": group.encode(),
-                "consumers": 0,
-                "pending": 0,
-                "last-delivered-id": b"0-0",
-                "entries-read": 7,
-                "lag": -6,
-            }
-        ]
-        assert r.xinfo_groups(stream) == expected
-
-    @skip_if_server_version_lt("7.9.0")
-    def test_xgroup_create_entriesread_with_fixed_lag_field(self, r: redis.Redis):
-        stream = "stream"
-        group = "group"
-        r.xadd(stream, {"foo": "bar"})
-
-        # no group is setup yet, no info to obtain
-        assert r.xinfo_groups(stream) == []
-
         assert r.xgroup_create(stream, group, 0, entries_read=7)
         expected = [
             {
diff --git a/tests/test_search.py b/tests/test_search.py
index ee1ba66434..5b45cfc0a3 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -314,6 +314,7 @@ def test_client(client):
 
 @pytest.mark.redismod
 @pytest.mark.onlynoncluster
+@skip_if_server_version_gte("7.9.0")
 def test_scores(client):
     client.ft().create_index((TextField("txt"),))
 
@@ -334,6 +335,29 @@ def test_scores(client):
         assert "doc1" == res["results"][1]["id"]
 
 
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+@skip_if_server_version_lt("7.9.0")
+def test_scores_with_new_default_scorer(client):
+    client.ft().create_index((TextField("txt"),))
+
+    client.hset("doc1", mapping={"txt": "foo baz"})
+    client.hset("doc2", mapping={"txt": "foo bar"})
+
+    q = Query("foo ~bar").with_scores()
+    res = client.ft().search(q)
+    if is_resp2_connection(client):
+        assert 2 == res.total
+        assert "doc2" == res.docs[0].id
+        assert 0.87 == pytest.approx(res.docs[0].score, 0.01)
+        assert "doc1" == res.docs[1].id
+    else:
+        assert 2 == res["total_results"]
+        assert "doc2" == res["results"][0]["id"]
+        assert 0.87 == pytest.approx(res["results"][0]["score"], 0.01)
+        assert "doc1" == res["results"][1]["id"]
+
+
 @pytest.mark.redismod
 def test_stopwords(client):
     client.ft().create_index((TextField("txt"),), stopwords=["foo", "bar", "baz"])
@@ -623,7 +647,7 @@ def test_summarize(client):
     createIndex(client.ft())
     waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
-    q = Query("king henry").paging(0, 1)
+    q = Query('"king henry"').paging(0, 1)
     q.highlight(fields=("play", "txt"), tags=("<b>", "</b>"))
     q.summarize("txt")
 
@@ -635,7 +659,7 @@ def test_summarize(client):
             == doc.txt
         )
 
-        q = Query("king henry").paging(0, 1).summarize().highlight()
+        q = Query('"king henry"').paging(0, 1).summarize().highlight()
 
         doc = sorted(client.ft().search(q).docs)[0]
         assert "<b>Henry</b> ... " == doc.play
@@ -651,7 +675,7 @@ def test_summarize(client):
             == doc["extra_attributes"]["txt"]
         )
 
-        q = Query("king henry").paging(0, 1).summarize().highlight()
+        q = Query('"king henry"').paging(0, 1).summarize().highlight()
 
         doc = sorted(client.ft().search(q)["results"])[0]
         assert "<b>Henry</b> ... " == doc["extra_attributes"]["play"]
@@ -936,6 +960,7 @@ def test_phonetic_matcher(client):
 @pytest.mark.onlynoncluster
 # NOTE(imalinovskyi): This test contains hardcoded scores valid only for RediSearch 2.8+
 @skip_ifmodversion_lt("2.8.0", "search")
+@skip_if_server_version_gte("7.9.0")
 def test_scorer(client):
     client.ft().create_index((TextField("description"),))
 
@@ -982,6 +1007,55 @@ def test_scorer(client):
         assert 0.0 == res["results"][0]["score"]
 
 
+@pytest.mark.redismod
+@pytest.mark.onlynoncluster
+@skip_if_server_version_lt("7.9.0")
+def test_scorer_with_new_default_scorer(client):
+    client.ft().create_index((TextField("description"),))
+
+    client.hset(
+        "doc1", mapping={"description": "The quick brown fox jumps over the lazy dog"}
+    )
+    client.hset(
+        "doc2",
+        mapping={
+            "description": "Quick alice was beginning to get very tired of sitting by her quick sister on the bank, and of having nothing to do."  # noqa
+        },
+    )
+
+    # default scorer is BM25STD
+    if is_resp2_connection(client):
+        res = client.ft().search(Query("quick").with_scores())
+        assert 0.23 == pytest.approx(res.docs[0].score, 0.05)
+        res = client.ft().search(Query("quick").scorer("TFIDF").with_scores())
+        assert 1.0 == res.docs[0].score
+        res = client.ft().search(Query("quick").scorer("TFIDF.DOCNORM").with_scores())
+        assert 0.14285714285714285 == res.docs[0].score
+        res = client.ft().search(Query("quick").scorer("BM25").with_scores())
+        assert 0.22471909420069797 == res.docs[0].score
+        res = client.ft().search(Query("quick").scorer("DISMAX").with_scores())
+        assert 2.0 == res.docs[0].score
+        res = client.ft().search(Query("quick").scorer("DOCSCORE").with_scores())
+        assert 1.0 == res.docs[0].score
+        res = client.ft().search(Query("quick").scorer("HAMMING").with_scores())
+        assert 0.0 == res.docs[0].score
+    else:
+        res = client.ft().search(Query("quick").with_scores())
+        assert 0.23 == pytest.approx(res["results"][0]["score"], 0.05)
+        res = client.ft().search(Query("quick").scorer("TFIDF").with_scores())
+        assert 1.0 == res["results"][0]["score"]
+        res = client.ft().search(Query("quick").scorer("TFIDF.DOCNORM").with_scores())
+        assert 0.14285714285714285 == res["results"][0]["score"]
+        res = client.ft().search(Query("quick").scorer("BM25").with_scores())
+        assert 0.22471909420069797 == res["results"][0]["score"]
+        res = client.ft().search(Query("quick").scorer("DISMAX").with_scores())
+        assert 2.0 == res["results"][0]["score"]
+        res = client.ft().search(Query("quick").scorer("DOCSCORE").with_scores())
+        assert 1.0 == res["results"][0]["score"]
+        res = client.ft().search(Query("quick").scorer("HAMMING").with_scores())
+        assert 0.0 == res["results"][0]["score"]
+
+
 @pytest.mark.redismod
 def test_get(client):
     client.ft().create_index((TextField("f1"), TextField("f2")))
@@ -2605,9 +2679,8 @@ def test_search_missing_fields(client):
         },
     )
 
-    with pytest.raises(redis.exceptions.ResponseError) as e:
+    with pytest.raises(redis.exceptions.ResponseError):
         client.ft().search(Query("ismissing(@title)").return_field("id").no_content())
-    assert "to be defined with 'INDEXMISSING'" in e.value.args[0]
 
     res = client.ft().search(
         Query("ismissing(@features)").return_field("id").no_content()
@@ -2813,6 +2886,12 @@ def test_search_query_with_different_dialects(client):
         assert res["total_results"] == 0
 
 
+@pytest.mark.redismod
+@skip_if_server_version_lt("7.9.0")
+def test_info_exposes_search_info(client):
+    assert len(client.info("search")) > 0
+
+
 def _assert_search_result(client, result, expected_doc_ids):
     """
     Make sure the result of a geo search is as expected, taking into account the RESP

From 03031a2e3dae176ba9408f7d6021247cc8a59d43 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 28 Jan 2025 14:33:39 +0200
Subject: [PATCH 0957/1164] Adding unit text fixes to improve compatibility
 with MacOS. (#3486)

* Adding unit text fixes to improve compatibility with MacOS.

* Applying review comments

* Unifying the exception msg validation pattern for both test_connection.py  files

---------

Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
---
 docker-compose.yml                    |  3 ++-
 tests/test_asyncio/test_connection.py | 30 +++++++++++++--------------
 tests/test_connection.py              | 18 +++++++---------
 tests/test_multiprocessing.py         |  4 ++++
 4 files changed, 27 insertions(+), 28 deletions(-)

diff --git a/docker-compose.yml b/docker-compose.yml
index 7804f09c8a..60657d5653 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -103,7 +103,7 @@ services:
       - all
 
   redis-stack:
-    image: ${REDIS_STACK_IMAGE:-redis/redis-stack-server:edge}
+    image: ${REDIS_STACK_IMAGE:-redis/redis-stack-server:latest}
     container_name: redis-stack
     ports:
       - 6479:6379
@@ -112,6 +112,7 @@ services:
     profiles:
       - standalone
       - all-stack
+      - all
 
   redis-stack-graph:
     image: redis/redis-stack-server:6.2.6-v15
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index e584fc6999..d4956f16e9 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -1,6 +1,7 @@
 import asyncio
 import socket
 import types
+from errno import ECONNREFUSED
 from unittest.mock import patch
 
 import pytest
@@ -36,15 +37,16 @@ async def test_invalid_response(create_redis):
     fake_stream = MockStream(raw + b"\r\n")
 
     parser: _AsyncRESPBase = r.connection._parser
-    with mock.patch.object(parser, "_stream", fake_stream):
-        with pytest.raises(InvalidResponse) as cm:
-            await parser.read_response()
+
     if isinstance(parser, _AsyncRESPBase):
-        assert str(cm.value) == f"Protocol Error: {raw!r}"
+        exp_err = f"Protocol Error: {raw!r}"
     else:
-        assert (
-            str(cm.value) == f'Protocol error, got "{raw.decode()}" as reply type byte'
-        )
+        exp_err = f'Protocol error, got "{raw.decode()}" as reply type byte'
+
+    with mock.patch.object(parser, "_stream", fake_stream):
+        with pytest.raises(InvalidResponse, match=exp_err):
+            await parser.read_response()
+
     await r.connection.disconnect()
 
 
@@ -170,10 +172,9 @@ async def test_connect_timeout_error_without_retry():
     conn._connect = mock.AsyncMock()
     conn._connect.side_effect = socket.timeout
 
-    with pytest.raises(TimeoutError) as e:
+    with pytest.raises(TimeoutError, match="Timeout connecting to server"):
         await conn.connect()
     assert conn._connect.call_count == 1
-    assert str(e.value) == "Timeout connecting to server"
 
 
 @pytest.mark.onlynoncluster
@@ -531,17 +532,14 @@ async def test_format_error_message(conn, error, expected_message):
 
 
 async def test_network_connection_failure():
-    with pytest.raises(ConnectionError) as e:
+    exp_err = rf"^Error {ECONNREFUSED} connecting to 127.0.0.1:9999.(.+)$"
+    with pytest.raises(ConnectionError, match=exp_err):
         redis = Redis(host="127.0.0.1", port=9999)
         await redis.set("a", "b")
-    assert str(e.value).startswith("Error 111 connecting to 127.0.0.1:9999. Connect")
 
 
 async def test_unix_socket_connection_failure():
-    with pytest.raises(ConnectionError) as e:
+    exp_err = "Error 2 connecting to unix:///tmp/a.sock. No such file or directory."
+    with pytest.raises(ConnectionError, match=exp_err):
         redis = Redis(unix_socket_path="unix:///tmp/a.sock")
         await redis.set("a", "b")
-    assert (
-        str(e.value)
-        == "Error 2 connecting to unix:///tmp/a.sock. No such file or directory."
-    )
diff --git a/tests/test_connection.py b/tests/test_connection.py
index fbc23ae8c0..6c1498a329 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -4,6 +4,7 @@
 import sys
 import threading
 import types
+from errno import ECONNREFUSED
 from typing import Any
 from unittest import mock
 from unittest.mock import call, patch
@@ -44,9 +45,8 @@ def test_invalid_response(r):
     raw = b"x"
     parser = r.connection._parser
     with mock.patch.object(parser._buffer, "readline", return_value=raw):
-        with pytest.raises(InvalidResponse) as cm:
+        with pytest.raises(InvalidResponse, match=f"Protocol Error: {raw!r}"):
             parser.read_response()
-    assert str(cm.value) == f"Protocol Error: {raw!r}"
 
 
 @skip_if_server_version_lt("4.0.0")
@@ -141,10 +141,9 @@ def test_connect_timeout_error_without_retry(self):
         conn._connect = mock.Mock()
         conn._connect.side_effect = socket.timeout
 
-        with pytest.raises(TimeoutError) as e:
+        with pytest.raises(TimeoutError, match="Timeout connecting to server"):
             conn.connect()
         assert conn._connect.call_count == 1
-        assert str(e.value) == "Timeout connecting to server"
         self.clear(conn)
 
 
@@ -349,20 +348,17 @@ def test_format_error_message(conn, error, expected_message):
 
 
 def test_network_connection_failure():
-    with pytest.raises(ConnectionError) as e:
+    exp_err = f"Error {ECONNREFUSED} connecting to localhost:9999. Connection refused."
+    with pytest.raises(ConnectionError, match=exp_err):
         redis = Redis(port=9999)
         redis.set("a", "b")
-    assert str(e.value) == "Error 111 connecting to localhost:9999. Connection refused."
 
 
 def test_unix_socket_connection_failure():
-    with pytest.raises(ConnectionError) as e:
+    exp_err = "Error 2 connecting to unix:///tmp/a.sock. No such file or directory."
+    with pytest.raises(ConnectionError, match=exp_err):
         redis = Redis(unix_socket_path="unix:///tmp/a.sock")
         redis.set("a", "b")
-    assert (
-        str(e.value)
-        == "Error 2 connecting to unix:///tmp/a.sock. No such file or directory."
-    )
 
 
 class TestUnitConnectionPool:
diff --git a/tests/test_multiprocessing.py b/tests/test_multiprocessing.py
index 5cda3190a6..116d20dab0 100644
--- a/tests/test_multiprocessing.py
+++ b/tests/test_multiprocessing.py
@@ -1,5 +1,6 @@
 import contextlib
 import multiprocessing
+import sys
 
 import pytest
 import redis
@@ -8,6 +9,9 @@
 
 from .conftest import _get_client
 
+if sys.platform == "darwin":
+    multiprocessing.set_start_method("fork", force=True)
+
 
 @contextlib.contextmanager
 def exit_callback(callback, *args):

From 24273650372acffdc451f7f5471444ed5e62c13a Mon Sep 17 00:00:00 2001
From: Niklas Becker <48069565+niklasbec@users.noreply.github.com>
Date: Tue, 28 Jan 2025 16:36:14 +0100
Subject: [PATCH 0958/1164] fix: update redis university url, the old link
 doesn't work (#3481)

* fix: update redis university url

* fix: add comment to changes

---------

Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
---
 CHANGES   | 1 +
 README.md | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/CHANGES b/CHANGES
index 8750128b05..bd96846b6d 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Update URL in the readme linking to Redis University
     * Move doctests (doc code examples) to main branch
     * Update `ResponseT` type hint
     * Allow to control the minimum SSL version
diff --git a/README.md b/README.md
index 08eff587be..98ddee5b52 100644
--- a/README.md
+++ b/README.md
@@ -19,7 +19,7 @@ The Python interface to the Redis key-value store.
 
 ## How do I Redis?
 
-[Learn for free at Redis University](https://redis.io/university/)
+[Learn for free at Redis University](https://redis.io/learn/university)
 
 [Try the Redis Cloud](https://redis.io/try-free/)
 

From ceb12fe8b52f488bd1e0a42b9dc53161e77514d0 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 30 Jan 2025 10:25:33 +0200
Subject: [PATCH 0959/1164] Adding tests for modules ACL and modules config
 changes in 8.0 (#3489)

* Adding tests for modules ACL and modules config changes in 8.0

* Applying review comments

* Adding deprecation annotations for tf config commands
---
 redis/commands/search/commands.py   |   8 ++
 tests/test_asyncio/test_commands.py | 210 ++++++++++++++++++++++++++++
 tests/test_commands.py              | 209 +++++++++++++++++++++++++++
 3 files changed, 427 insertions(+)

diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 2447959922..9d9ef42415 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -692,6 +692,10 @@ def dict_dump(self, name: str):
         cmd = [DICT_DUMP_CMD, name]
         return self.execute_command(*cmd)
 
+    @deprecated_function(
+        version="8.0.0",
+        reason="deprecated since Redis 8.0, call config_set from core module instead",
+    )
     def config_set(self, option: str, value: str) -> bool:
         """Set runtime configuration option.
 
@@ -706,6 +710,10 @@ def config_set(self, option: str, value: str) -> bool:
         raw = self.execute_command(*cmd)
         return raw == "OK"
 
+    @deprecated_function(
+        version="8.0.0",
+        reason="deprecated since Redis 8.0, call config_get from core module instead",
+    )
     def config_get(self, option: str) -> str:
         """Get runtime configuration option value.
 
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index f6ed07fab5..9f154cb273 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -20,6 +20,9 @@
     parse_info,
 )
 from redis.client import EMPTY_RESPONSE, NEVER_DECODE
+from redis.commands.json.path import Path
+from redis.commands.search.field import TextField
+from redis.commands.search.query import Query
 from tests.conftest import (
     assert_resp_response,
     assert_resp_response_in,
@@ -49,6 +52,12 @@ def factory(username):
         return r
 
     yield factory
+    try:
+        client_info = await r.client_info()
+    except exceptions.NoPermissionError:
+        client_info = {}
+    if "default" != client_info.get("user", ""):
+        await r.auth("", "default")
     for username in usernames:
         await r.acl_deluser(username)
 
@@ -115,12 +124,65 @@ async def test_acl_cat_no_category(self, r: redis.Redis):
         assert isinstance(categories, list)
         assert "read" in categories or b"read" in categories
 
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.9.0")
+    async def test_acl_cat_contain_modules_no_category(self, r: redis.Redis):
+        modules_list = [
+            "search",
+            "bloom",
+            "json",
+            "cuckoo",
+            "timeseries",
+            "cms",
+            "topk",
+            "tdigest",
+        ]
+        categories = await r.acl_cat()
+        assert isinstance(categories, list)
+        for module_cat in modules_list:
+            assert module_cat in categories or module_cat.encode() in categories
+
     @skip_if_server_version_lt(REDIS_6_VERSION)
     async def test_acl_cat_with_category(self, r: redis.Redis):
         commands = await r.acl_cat("read")
         assert isinstance(commands, list)
         assert "get" in commands or b"get" in commands
 
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.9.0")
+    async def test_acl_modules_cat_with_category(self, r: redis.Redis):
+        search_commands = await r.acl_cat("search")
+        assert isinstance(search_commands, list)
+        assert "FT.SEARCH" in search_commands or b"FT.SEARCH" in search_commands
+
+        bloom_commands = await r.acl_cat("bloom")
+        assert isinstance(bloom_commands, list)
+        assert "bf.add" in bloom_commands or b"bf.add" in bloom_commands
+
+        json_commands = await r.acl_cat("json")
+        assert isinstance(json_commands, list)
+        assert "json.get" in json_commands or b"json.get" in json_commands
+
+        cuckoo_commands = await r.acl_cat("cuckoo")
+        assert isinstance(cuckoo_commands, list)
+        assert "cf.insert" in cuckoo_commands or b"cf.insert" in cuckoo_commands
+
+        cms_commands = await r.acl_cat("cms")
+        assert isinstance(cms_commands, list)
+        assert "cms.query" in cms_commands or b"cms.query" in cms_commands
+
+        topk_commands = await r.acl_cat("topk")
+        assert isinstance(topk_commands, list)
+        assert "topk.list" in topk_commands or b"topk.list" in topk_commands
+
+        tdigest_commands = await r.acl_cat("tdigest")
+        assert isinstance(tdigest_commands, list)
+        assert "tdigest.rank" in tdigest_commands or b"tdigest.rank" in tdigest_commands
+
+        timeseries_commands = await r.acl_cat("timeseries")
+        assert isinstance(timeseries_commands, list)
+        assert "ts.range" in timeseries_commands or b"ts.range" in timeseries_commands
+
     @skip_if_server_version_lt(REDIS_6_VERSION)
     async def test_acl_deluser(self, r_teardown):
         username = "redis-py-user"
@@ -316,6 +378,116 @@ async def test_acl_whoami(self, r: redis.Redis):
         username = await r.acl_whoami()
         assert isinstance(username, (str, bytes))
 
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.9.0")
+    async def test_acl_modules_commands(self, r_teardown):
+        username = "redis-py-user"
+        password = "pass-for-test-user"
+
+        r = r_teardown(username)
+        await r.flushdb()
+
+        await r.ft().create_index((TextField("txt"),))
+        await r.hset("doc1", mapping={"txt": "foo baz"})
+        await r.hset("doc2", mapping={"txt": "foo bar"})
+
+        await r.acl_setuser(
+            username,
+            enabled=True,
+            reset=True,
+            passwords=[f"+{password}"],
+            categories=["-all"],
+            commands=[
+                "+FT.SEARCH",
+                "-FT.DROPINDEX",
+                "+json.set",
+                "+json.get",
+                "-json.clear",
+                "+bf.reserve",
+                "-bf.info",
+                "+cf.reserve",
+                "+cms.initbydim",
+                "+topk.reserve",
+                "+tdigest.create",
+                "+ts.create",
+                "-ts.info",
+            ],
+            keys=["*"],
+        )
+
+        await r.auth(password, username)
+
+        assert await r.ft().search(Query("foo ~bar"))
+        with pytest.raises(exceptions.NoPermissionError):
+            await r.ft().dropindex()
+
+        await r.json().set("foo", Path.root_path(), "bar")
+        assert await r.json().get("foo") == "bar"
+        with pytest.raises(exceptions.NoPermissionError):
+            await r.json().clear("foo")
+
+        assert await r.bf().create("bloom", 0.01, 1000)
+        assert await r.cf().create("cuckoo", 1000)
+        assert await r.cms().initbydim("cmsDim", 100, 5)
+        assert await r.topk().reserve("topk", 5, 100, 5, 0.9)
+        assert await r.tdigest().create("to-tDigest", 10)
+        with pytest.raises(exceptions.NoPermissionError):
+            await r.bf().info("bloom")
+
+        assert await r.ts().create(1, labels={"Redis": "Labs"})
+        with pytest.raises(exceptions.NoPermissionError):
+            await r.ts().info(1)
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.9.0")
+    async def test_acl_modules_category_commands(self, r_teardown):
+        username = "redis-py-user"
+        password = "pass-for-test-user"
+
+        r = r_teardown(username)
+        await r.flushdb()
+
+        # validate modules categories acl config
+        await r.acl_setuser(
+            username,
+            enabled=True,
+            reset=True,
+            passwords=[f"+{password}"],
+            categories=[
+                "-all",
+                "+@search",
+                "+@json",
+                "+@bloom",
+                "+@cuckoo",
+                "+@topk",
+                "+@cms",
+                "+@timeseries",
+                "+@tdigest",
+            ],
+            keys=["*"],
+        )
+        await r.ft().create_index((TextField("txt"),))
+        await r.hset("doc1", mapping={"txt": "foo baz"})
+        await r.hset("doc2", mapping={"txt": "foo bar"})
+
+        await r.auth(password, username)
+
+        assert await r.ft().search(Query("foo ~bar"))
+        assert await r.ft().dropindex()
+
+        assert await r.json().set("foo", Path.root_path(), "bar")
+        assert await r.json().get("foo") == "bar"
+
+        assert await r.bf().create("bloom", 0.01, 1000)
+        assert await r.bf().info("bloom")
+        assert await r.cf().create("cuckoo", 1000)
+        assert await r.cms().initbydim("cmsDim", 100, 5)
+        assert await r.topk().reserve("topk", 5, 100, 5, 0.9)
+        assert await r.tdigest().create("to-tDigest", 10)
+
+        assert await r.ts().create(1, labels={"Redis": "Labs"})
+        assert await r.ts().info(1)
+
     @pytest.mark.onlynoncluster
     async def test_client_list(self, r: redis.Redis):
         clients = await r.client_list()
@@ -512,6 +684,44 @@ async def test_config_set(self, r: redis.Redis):
         assert await r.config_set("timeout", 0)
         assert (await r.config_get())["timeout"] == "0"
 
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.9.0")
+    async def test_config_get_for_modules(self, r: redis.Redis):
+        search_module_configs = await r.config_get("search-*")
+        assert "search-timeout" in search_module_configs
+
+        ts_module_configs = await r.config_get("ts-*")
+        assert "ts-retention-policy" in ts_module_configs
+
+        bf_module_configs = await r.config_get("bf-*")
+        assert "bf-error-rate" in bf_module_configs
+
+        cf_module_configs = await r.config_get("cf-*")
+        assert "cf-initial-size" in cf_module_configs
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.9.0")
+    async def test_config_set_for_search_module(self, r: redis.Redis):
+        config = await r.config_get("*")
+        initial_default_search_dialect = config["search-default-dialect"]
+        try:
+            default_dialect_new = "3"
+            assert await r.config_set("search-default-dialect", default_dialect_new)
+            assert (await r.config_get("*"))[
+                "search-default-dialect"
+            ] == default_dialect_new
+            assert (
+                (await r.ft().config_get("*"))[b"DEFAULT_DIALECT"]
+            ).decode() == default_dialect_new
+        except AssertionError as ex:
+            raise ex
+        finally:
+            assert await r.config_set(
+                "search-default-dialect", initial_default_search_dialect
+            )
+        with pytest.raises(exceptions.ResponseError):
+            await r.config_set("search-max-doctablesize", 2000000)
+
     @pytest.mark.onlynoncluster
     async def test_dbsize(self, r: redis.Redis):
         await r.set("a", "foo")
diff --git a/tests/test_commands.py b/tests/test_commands.py
index f83fe76aa9..24c320a3f3 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -18,6 +18,9 @@
     parse_info,
 )
 from redis.client import EMPTY_RESPONSE, NEVER_DECODE
+from redis.commands.json.path import Path
+from redis.commands.search.field import TextField
+from redis.commands.search.query import Query
 
 from .conftest import (
     _get_client,
@@ -144,12 +147,65 @@ def test_acl_cat_no_category(self, r):
         assert isinstance(categories, list)
         assert "read" in categories or b"read" in categories
 
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.9.0")
+    def test_acl_cat_contain_modules_no_category(self, r):
+        modules_list = [
+            "search",
+            "bloom",
+            "json",
+            "cuckoo",
+            "timeseries",
+            "cms",
+            "topk",
+            "tdigest",
+        ]
+        categories = r.acl_cat()
+        assert isinstance(categories, list)
+        for module_cat in modules_list:
+            assert module_cat in categories or module_cat.encode() in categories
+
     @skip_if_server_version_lt("6.0.0")
     def test_acl_cat_with_category(self, r):
         commands = r.acl_cat("read")
         assert isinstance(commands, list)
         assert "get" in commands or b"get" in commands
 
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.9.0")
+    def test_acl_modules_cat_with_category(self, r):
+        search_commands = r.acl_cat("search")
+        assert isinstance(search_commands, list)
+        assert "FT.SEARCH" in search_commands or b"FT.SEARCH" in search_commands
+
+        bloom_commands = r.acl_cat("bloom")
+        assert isinstance(bloom_commands, list)
+        assert "bf.add" in bloom_commands or b"bf.add" in bloom_commands
+
+        json_commands = r.acl_cat("json")
+        assert isinstance(json_commands, list)
+        assert "json.get" in json_commands or b"json.get" in json_commands
+
+        cuckoo_commands = r.acl_cat("cuckoo")
+        assert isinstance(cuckoo_commands, list)
+        assert "cf.insert" in cuckoo_commands or b"cf.insert" in cuckoo_commands
+
+        cms_commands = r.acl_cat("cms")
+        assert isinstance(cms_commands, list)
+        assert "cms.query" in cms_commands or b"cms.query" in cms_commands
+
+        topk_commands = r.acl_cat("topk")
+        assert isinstance(topk_commands, list)
+        assert "topk.list" in topk_commands or b"topk.list" in topk_commands
+
+        tdigest_commands = r.acl_cat("tdigest")
+        assert isinstance(tdigest_commands, list)
+        assert "tdigest.rank" in tdigest_commands or b"tdigest.rank" in tdigest_commands
+
+        timeseries_commands = r.acl_cat("timeseries")
+        assert isinstance(timeseries_commands, list)
+        assert "ts.range" in timeseries_commands or b"ts.range" in timeseries_commands
+
     @skip_if_server_version_lt("7.0.0")
     @skip_if_redis_enterprise()
     def test_acl_dryrun(self, r, request):
@@ -458,6 +514,123 @@ def test_acl_whoami(self, r):
         username = r.acl_whoami()
         assert isinstance(username, (str, bytes))
 
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.9.0")
+    def test_acl_modules_commands(self, r, request):
+        default_username = "default"
+        username = "redis-py-user"
+        password = "pass-for-test-user"
+
+        def teardown():
+            r.auth("", default_username)
+            r.acl_deluser(username)
+
+        request.addfinalizer(teardown)
+
+        r.ft().create_index((TextField("txt"),))
+        r.hset("doc1", mapping={"txt": "foo baz"})
+        r.hset("doc2", mapping={"txt": "foo bar"})
+
+        r.acl_setuser(
+            username,
+            enabled=True,
+            reset=True,
+            passwords=[f"+{password}"],
+            categories=["-all"],
+            commands=[
+                "+FT.SEARCH",
+                "-FT.DROPINDEX",
+                "+json.set",
+                "+json.get",
+                "-json.clear",
+                "+bf.reserve",
+                "-bf.info",
+                "+cf.reserve",
+                "+cms.initbydim",
+                "+topk.reserve",
+                "+tdigest.create",
+                "+ts.create",
+                "-ts.info",
+            ],
+            keys=["*"],
+        )
+        r.auth(password, username)
+
+        assert r.ft().search(Query("foo ~bar"))
+        with pytest.raises(exceptions.NoPermissionError):
+            r.ft().dropindex()
+
+        r.json().set("foo", Path.root_path(), "bar")
+        assert r.json().get("foo") == "bar"
+        with pytest.raises(exceptions.NoPermissionError):
+            r.json().clear("foo")
+
+        assert r.bf().create("bloom", 0.01, 1000)
+        assert r.cf().create("cuckoo", 1000)
+        assert r.cms().initbydim("cmsDim", 100, 5)
+        assert r.topk().reserve("topk", 5, 100, 5, 0.9)
+        assert r.tdigest().create("to-tDigest", 10)
+        with pytest.raises(exceptions.NoPermissionError):
+            r.bf().info("bloom")
+
+        assert r.ts().create(1, labels={"Redis": "Labs"})
+        with pytest.raises(exceptions.NoPermissionError):
+            r.ts().info(1)
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.9.0")
+    def test_acl_modules_category_commands(self, r, request):
+        default_username = "default"
+        username = "redis-py-user"
+        password = "pass-for-test-user"
+
+        def teardown():
+            r.auth("", default_username)
+            r.acl_deluser(username)
+
+        request.addfinalizer(teardown)
+
+        # validate modules categories acl config
+        r.acl_setuser(
+            username,
+            enabled=True,
+            reset=True,
+            passwords=[f"+{password}"],
+            categories=[
+                "-all",
+                "+@search",
+                "+@json",
+                "+@bloom",
+                "+@cuckoo",
+                "+@topk",
+                "+@cms",
+                "+@timeseries",
+                "+@tdigest",
+            ],
+            keys=["*"],
+        )
+        r.ft().create_index((TextField("txt"),))
+        r.hset("doc1", mapping={"txt": "foo baz"})
+        r.hset("doc2", mapping={"txt": "foo bar"})
+
+        r.auth(password, username)
+
+        assert r.ft().search(Query("foo ~bar"))
+        assert r.ft().dropindex()
+
+        assert r.json().set("foo", Path.root_path(), "bar")
+        assert r.json().get("foo") == "bar"
+
+        assert r.bf().create("bloom", 0.01, 1000)
+        assert r.bf().info("bloom")
+        assert r.cf().create("cuckoo", 1000)
+        assert r.cms().initbydim("cmsDim", 100, 5)
+        assert r.topk().reserve("topk", 5, 100, 5, 0.9)
+        assert r.tdigest().create("to-tDigest", 10)
+
+        assert r.ts().create(1, labels={"Redis": "Labs"})
+        assert r.ts().info(1)
+
     @pytest.mark.onlynoncluster
     def test_client_list(self, r):
         clients = r.client_list()
@@ -824,6 +997,42 @@ def test_config_set_multi_params(self, r: redis.Redis):
         assert r.config_get()["timeout"] == "0"
         assert r.config_get()["maxmemory"] == "0"
 
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.9.0")
+    def test_config_get_for_modules(self, r: redis.Redis):
+        search_module_configs = r.config_get("search-*")
+        assert "search-timeout" in search_module_configs
+
+        ts_module_configs = r.config_get("ts-*")
+        assert "ts-retention-policy" in ts_module_configs
+
+        bf_module_configs = r.config_get("bf-*")
+        assert "bf-error-rate" in bf_module_configs
+
+        cf_module_configs = r.config_get("cf-*")
+        assert "cf-initial-size" in cf_module_configs
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.9.0")
+    def test_config_set_for_search_module(self, r: redis.Redis):
+        initial_default_search_dialect = r.config_get("*")["search-default-dialect"]
+        try:
+            default_dialect_new = "3"
+            assert r.config_set("search-default-dialect", default_dialect_new)
+            assert r.config_get("*")["search-default-dialect"] == default_dialect_new
+            assert (
+                r.ft().config_get("*")[b"DEFAULT_DIALECT"]
+            ).decode() == default_dialect_new
+        except AssertionError as ex:
+            raise ex
+        finally:
+            assert r.config_set(
+                "search-default-dialect", initial_default_search_dialect
+            )
+
+        with pytest.raises(exceptions.ResponseError):
+            r.config_set("search-max-doctablesize", 2000000)
+
     @skip_if_server_version_lt("6.0.0")
     @skip_if_redis_enterprise()
     def test_failover(self, r):

From c675a56796a5863ce49f41c7af852cf40437a9b1 Mon Sep 17 00:00:00 2001
From: Patrick Arminio <patrick.arminio@gmail.com>
Date: Tue, 4 Feb 2025 08:10:06 +0000
Subject: [PATCH 0960/1164] Add return type to `close` functions (#3496)

---
 redis/client.py  | 3 +--
 redis/cluster.py | 4 ++--
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index a7c1364a10..4fa410c65e 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -550,7 +550,7 @@ def __exit__(self, exc_type, exc_value, traceback):
     def __del__(self):
         self.close()
 
-    def close(self):
+    def close(self) -> None:
         # In case a connection property does not yet exist
         # (due to a crash earlier in the Redis() constructor), return
         # immediately as there is nothing to clean-up.
@@ -1551,7 +1551,6 @@ def _disconnect_raise_reset(
             conn.retry_on_error is None
             or isinstance(error, tuple(conn.retry_on_error)) is False
         ):
-
             self.reset()
             raise error
 
diff --git a/redis/cluster.py b/redis/cluster.py
index 8718493759..2fff761f95 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -1227,7 +1227,7 @@ def _execute_command(self, target_node, *args, **kwargs):
 
         raise ClusterError("TTL exhausted.")
 
-    def close(self):
+    def close(self) -> None:
         try:
             with self._lock:
                 if self.nodes_manager:
@@ -1669,7 +1669,7 @@ def initialize(self):
         # If initialize was called after a MovedError, clear it
         self._moved_exception = None
 
-    def close(self):
+    def close(self) -> None:
         self.default_node = None
         for node in self.nodes_cache.values():
             if node.redis_connection:

From b7d4c48e46917032bccf24d9509b17d1fb0ccdde Mon Sep 17 00:00:00 2001
From: David Dougherty <dwdougherty@gmail.com>
Date: Tue, 4 Feb 2025 02:41:16 -0800
Subject: [PATCH 0961/1164] Update Python imports in doctests (index_definition
 => indexDefinition) (#3490)

---
 doctests/query_agg.py         | 2 +-
 doctests/query_combined.py    | 2 +-
 doctests/query_em.py          | 2 +-
 doctests/query_ft.py          | 2 +-
 doctests/query_geo.py         | 2 +-
 doctests/query_range.py       | 2 +-
 doctests/search_quickstart.py | 2 +-
 doctests/search_vss.py        | 2 +-
 8 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/doctests/query_agg.py b/doctests/query_agg.py
index 4d81ddbcda..4fa8f14b84 100644
--- a/doctests/query_agg.py
+++ b/doctests/query_agg.py
@@ -6,7 +6,7 @@
 from redis.commands.search import Search
 from redis.commands.search.aggregation import AggregateRequest
 from redis.commands.search.field import NumericField, TagField
-from redis.commands.search.index_definition import IndexDefinition, IndexType
+from redis.commands.search.indexDefinition import IndexDefinition, IndexType
 import redis.commands.search.reducers as reducers
 
 r = redis.Redis(decode_responses=True)
diff --git a/doctests/query_combined.py b/doctests/query_combined.py
index e6dd5a2cb5..a17f19417c 100644
--- a/doctests/query_combined.py
+++ b/doctests/query_combined.py
@@ -6,7 +6,7 @@
 import warnings
 from redis.commands.json.path import Path
 from redis.commands.search.field import NumericField, TagField, TextField, VectorField
-from redis.commands.search.index_definition import IndexDefinition, IndexType
+from redis.commands.search.indexDefinition import IndexDefinition, IndexType
 from redis.commands.search.query import Query
 from sentence_transformers import  SentenceTransformer
 
diff --git a/doctests/query_em.py b/doctests/query_em.py
index 91cc5ae940..a00ff11150 100644
--- a/doctests/query_em.py
+++ b/doctests/query_em.py
@@ -4,7 +4,7 @@
 import redis
 from redis.commands.json.path import Path
 from redis.commands.search.field import TextField, NumericField, TagField
-from redis.commands.search.index_definition import IndexDefinition, IndexType
+from redis.commands.search.indexDefinition import IndexDefinition, IndexType
 from redis.commands.search.query import NumericFilter, Query
 
 r = redis.Redis(decode_responses=True)
diff --git a/doctests/query_ft.py b/doctests/query_ft.py
index 6272cdab25..182a5b2bd3 100644
--- a/doctests/query_ft.py
+++ b/doctests/query_ft.py
@@ -5,7 +5,7 @@
 import redis
 from redis.commands.json.path import Path
 from redis.commands.search.field import TextField, NumericField, TagField
-from redis.commands.search.index_definition import IndexDefinition, IndexType
+from redis.commands.search.indexDefinition import IndexDefinition, IndexType
 from redis.commands.search.query import NumericFilter, Query
 
 r = redis.Redis(decode_responses=True)
diff --git a/doctests/query_geo.py b/doctests/query_geo.py
index ed8c9a5f99..dcb7db6ee7 100644
--- a/doctests/query_geo.py
+++ b/doctests/query_geo.py
@@ -5,7 +5,7 @@
 import redis
 from redis.commands.json.path import Path
 from redis.commands.search.field import GeoField, GeoShapeField
-from redis.commands.search.index_definition import IndexDefinition, IndexType
+from redis.commands.search.indexDefinition import IndexDefinition, IndexType
 from redis.commands.search.query import Query
 
 r = redis.Redis(decode_responses=True)
diff --git a/doctests/query_range.py b/doctests/query_range.py
index 674afc492a..4ef957acfb 100644
--- a/doctests/query_range.py
+++ b/doctests/query_range.py
@@ -5,7 +5,7 @@
 import redis
 from redis.commands.json.path import Path
 from redis.commands.search.field import TextField, NumericField, TagField
-from redis.commands.search.index_definition import IndexDefinition, IndexType
+from redis.commands.search.indexDefinition import IndexDefinition, IndexType
 from redis.commands.search.query import NumericFilter, Query
 
 r = redis.Redis(decode_responses=True)
diff --git a/doctests/search_quickstart.py b/doctests/search_quickstart.py
index cde4caa84a..e190393b16 100644
--- a/doctests/search_quickstart.py
+++ b/doctests/search_quickstart.py
@@ -10,7 +10,7 @@
 import redis.commands.search.reducers as reducers
 from redis.commands.json.path import Path
 from redis.commands.search.field import NumericField, TagField, TextField
-from redis.commands.search.index_definition import IndexDefinition, IndexType
+from redis.commands.search.indexDefinition import IndexDefinition, IndexType
 from redis.commands.search.query import Query
 
 # HIDE_END
diff --git a/doctests/search_vss.py b/doctests/search_vss.py
index a1132971db..8b4884727a 100644
--- a/doctests/search_vss.py
+++ b/doctests/search_vss.py
@@ -20,7 +20,7 @@
     TextField,
     VectorField,
 )
-from redis.commands.search.index_definition import IndexDefinition, IndexType
+from redis.commands.search.indexDefinition import IndexDefinition, IndexType
 from redis.commands.search.query import Query
 from sentence_transformers import SentenceTransformer
 

From d989bccbb5c3a4fd4301a5858be0752ecda125b0 Mon Sep 17 00:00:00 2001
From: Patrick Arminio <patrick.arminio@gmail.com>
Date: Tue, 4 Feb 2025 14:19:46 +0000
Subject: [PATCH 0962/1164] Add types to ConnectionPool.from_url (#3495)

Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
---
 redis/connection.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/redis/connection.py b/redis/connection.py
index d905c6481b..d47f46590b 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -9,7 +9,7 @@
 from itertools import chain
 from queue import Empty, Full, LifoQueue
 from time import time
-from typing import Any, Callable, Dict, List, Optional, Type, Union
+from typing import Any, Callable, Dict, List, Optional, Type, TypeVar, Union
 from urllib.parse import parse_qs, unquote, urlparse
 
 from redis.cache import (
@@ -1263,6 +1263,9 @@ def parse_url(url):
     return kwargs
 
 
+_CP = TypeVar("_CP", bound="ConnectionPool")
+
+
 class ConnectionPool:
     """
     Create a connection pool. ``If max_connections`` is set, then this
@@ -1278,7 +1281,7 @@ class ConnectionPool:
     """
 
     @classmethod
-    def from_url(cls, url, **kwargs):
+    def from_url(cls: Type[_CP], url: str, **kwargs) -> _CP:
         """
         Return a connection pool configured from the given URL.
 

From 5342409937203a3e619cd79ddeab721821cec4ef Mon Sep 17 00:00:00 2001
From: Patrick Arminio <patrick.arminio@gmail.com>
Date: Thu, 6 Feb 2025 08:18:17 +0000
Subject: [PATCH 0963/1164] Add types to execute method of pipelines (#3494)

Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
---
 redis/asyncio/client.py | 2 +-
 redis/client.py         | 2 +-
 redis/cluster.py        | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 9478d539d7..7c17938714 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -1554,7 +1554,7 @@ async def _disconnect_raise_reset(self, conn: Connection, error: Exception):
             await self.reset()
             raise
 
-    async def execute(self, raise_on_error: bool = True):
+    async def execute(self, raise_on_error: bool = True) -> List[Any]:
         """Execute all the commands in the current pipeline"""
         stack = self.command_stack
         if not stack and not self.watching:
diff --git a/redis/client.py b/redis/client.py
index 4fa410c65e..88bc6bf475 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1554,7 +1554,7 @@ def _disconnect_raise_reset(
             self.reset()
             raise error
 
-    def execute(self, raise_on_error=True):
+    def execute(self, raise_on_error: bool = True) -> List[Any]:
         """Execute all the commands in the current pipeline"""
         stack = self.command_stack
         if not stack and not self.watching:
diff --git a/redis/cluster.py b/redis/cluster.py
index 2fff761f95..6c6cfbf114 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -2050,7 +2050,7 @@ def annotate_exception(self, exception, number, command):
         )
         exception.args = (msg,) + exception.args[1:]
 
-    def execute(self, raise_on_error=True):
+    def execute(self, raise_on_error: bool = True) -> List[Any]:
         """
         Execute all the commands in the current pipeline
         """

From 4d5e417dee56ee49ff18b04eee094f4880846e35 Mon Sep 17 00:00:00 2001
From: andy-stark-redis <164213578+andy-stark-redis@users.noreply.github.com>
Date: Thu, 6 Feb 2025 12:31:00 +0000
Subject: [PATCH 0964/1164] DOC-4796 fixed capped lists example (#3493)

Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
---
 doctests/dt_list.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doctests/dt_list.py b/doctests/dt_list.py
index be8a4b8562..111da8eb08 100644
--- a/doctests/dt_list.py
+++ b/doctests/dt_list.py
@@ -165,20 +165,20 @@
 # REMOVE_END
 
 # STEP_START ltrim
-res27 = r.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5")
+res27 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5")
 print(res27)  # >>> 5
 
 res28 = r.ltrim("bikes:repairs", 0, 2)
 print(res28)  # >>> True
 
 res29 = r.lrange("bikes:repairs", 0, -1)
-print(res29)  # >>> ['bike:5', 'bike:4', 'bike:3']
+print(res29)  # >>> ['bike:1', 'bike:2', 'bike:3']
 # STEP_END
 
 # REMOVE_START
 assert res27 == 5
 assert res28 is True
-assert res29 == ["bike:5", "bike:4", "bike:3"]
+assert res29 == ["bike:1", "bike:2", "bike:3"]
 r.delete("bikes:repairs")
 # REMOVE_END
 

From f76afb24952eb37eea5a2cfe43cae6cf29ee545e Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Fri, 7 Feb 2025 13:12:24 +0200
Subject: [PATCH 0965/1164] Adding deprecation messages for the exposed in
 search module commands: FT.INFO, just for async client: FT.CONFIG GET and
 FT.CONFIG SET (#3499)

---
 redis/commands/search/commands.py | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 9d9ef42415..2158c01ba9 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -442,6 +442,10 @@ def get(self, *ids):
 
         return self.execute_command(MGET_CMD, self.index_name, *ids)
 
+    @deprecated_function(
+        version="8.0.0",
+        reason="deprecated since Redis 8.0, call info from core module instead",
+    )
     def info(self):
         """
         Get info an stats about the the current index, including the number of
@@ -912,6 +916,10 @@ def syndump(self):
 
 
 class AsyncSearchCommands(SearchCommands):
+    @deprecated_function(
+        version="8.0.0",
+        reason="deprecated since Redis 8.0, call info from core module instead",
+    )
     async def info(self):
         """
         Get info an stats about the the current index, including the number of
@@ -1015,6 +1023,10 @@ async def spellcheck(self, query, distance=None, include=None, exclude=None):
 
         return self._parse_results(SPELLCHECK_CMD, res)
 
+    @deprecated_function(
+        version="8.0.0",
+        reason="deprecated since Redis 8.0, call config_set from core module instead",
+    )
     async def config_set(self, option: str, value: str) -> bool:
         """Set runtime configuration option.
 
@@ -1029,6 +1041,10 @@ async def config_set(self, option: str, value: str) -> bool:
         raw = await self.execute_command(*cmd)
         return raw == "OK"
 
+    @deprecated_function(
+        version="8.0.0",
+        reason="deprecated since Redis 8.0, call config_get from core module instead",
+    )
     async def config_get(self, option: str) -> str:
         """Get runtime configuration option value.
 

From 9eab6fe4ebede4c184a6917f498f3c4ebdf26bce Mon Sep 17 00:00:00 2001
From: Artur Mostowski <artur.mostowski@protonmail.com>
Date: Mon, 10 Feb 2025 15:56:11 +0100
Subject: [PATCH 0966/1164] typing for client __init__ (#3357)

* typing for client __init__

* typing with string literals

* retry_on_error more specific typing

* retry typing

* fix lint

---------

Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
---
 redis/client.py | 99 ++++++++++++++++++++++++++++---------------------
 1 file changed, 57 insertions(+), 42 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 88bc6bf475..5a9f4fafb5 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -4,7 +4,17 @@
 import time
 import warnings
 from itertools import chain
-from typing import Any, Callable, Dict, List, Optional, Type, Union
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    List,
+    Mapping,
+    Optional,
+    Type,
+    Union,
+)
 
 from redis._parsers.encoders import Encoder
 from redis._parsers.helpers import (
@@ -53,6 +63,11 @@
     str_if_bytes,
 )
 
+if TYPE_CHECKING:
+    import ssl
+
+    import OpenSSL
+
 SYM_EMPTY = b""
 EMPTY_RESPONSE = "EMPTY_RESPONSE"
 
@@ -175,47 +190,47 @@ def from_pool(
 
     def __init__(
         self,
-        host="localhost",
-        port=6379,
-        db=0,
-        password=None,
-        socket_timeout=None,
-        socket_connect_timeout=None,
-        socket_keepalive=None,
-        socket_keepalive_options=None,
-        connection_pool=None,
-        unix_socket_path=None,
-        encoding="utf-8",
-        encoding_errors="strict",
-        charset=None,
-        errors=None,
-        decode_responses=False,
-        retry_on_timeout=False,
-        retry_on_error=None,
-        ssl=False,
-        ssl_keyfile=None,
-        ssl_certfile=None,
-        ssl_cert_reqs="required",
-        ssl_ca_certs=None,
-        ssl_ca_path=None,
-        ssl_ca_data=None,
-        ssl_check_hostname=False,
-        ssl_password=None,
-        ssl_validate_ocsp=False,
-        ssl_validate_ocsp_stapled=False,
-        ssl_ocsp_context=None,
-        ssl_ocsp_expected_cert=None,
-        ssl_min_version=None,
-        ssl_ciphers=None,
-        max_connections=None,
-        single_connection_client=False,
-        health_check_interval=0,
-        client_name=None,
-        lib_name="redis-py",
-        lib_version=get_lib_version(),
-        username=None,
-        retry=None,
-        redis_connect_func=None,
+        host: str = "localhost",
+        port: int = 6379,
+        db: int = 0,
+        password: Optional[str] = None,
+        socket_timeout: Optional[float] = None,
+        socket_connect_timeout: Optional[float] = None,
+        socket_keepalive: Optional[bool] = None,
+        socket_keepalive_options: Optional[Mapping[int, Union[int, bytes]]] = None,
+        connection_pool: Optional[ConnectionPool] = None,
+        unix_socket_path: Optional[str] = None,
+        encoding: str = "utf-8",
+        encoding_errors: str = "strict",
+        charset: Optional[str] = None,
+        errors: Optional[str] = None,
+        decode_responses: bool = False,
+        retry_on_timeout: bool = False,
+        retry_on_error: Optional[List[Type[Exception]]] = None,
+        ssl: bool = False,
+        ssl_keyfile: Optional[str] = None,
+        ssl_certfile: Optional[str] = None,
+        ssl_cert_reqs: str = "required",
+        ssl_ca_certs: Optional[str] = None,
+        ssl_ca_path: Optional[str] = None,
+        ssl_ca_data: Optional[str] = None,
+        ssl_check_hostname: bool = False,
+        ssl_password: Optional[str] = None,
+        ssl_validate_ocsp: bool = False,
+        ssl_validate_ocsp_stapled: bool = False,
+        ssl_ocsp_context: Optional["OpenSSL.SSL.Context"] = None,
+        ssl_ocsp_expected_cert: Optional[str] = None,
+        ssl_min_version: Optional["ssl.TLSVersion"] = None,
+        ssl_ciphers: Optional[str] = None,
+        max_connections: Optional[int] = None,
+        single_connection_client: bool = False,
+        health_check_interval: int = 0,
+        client_name: Optional[str] = None,
+        lib_name: Optional[str] = "redis-py",
+        lib_version: Optional[str] = get_lib_version(),
+        username: Optional[str] = None,
+        retry: Optional[Retry] = None,
+        redis_connect_func: Optional[Callable[[], None]] = None,
         credential_provider: Optional[CredentialProvider] = None,
         protocol: Optional[int] = 2,
         cache: Optional[CacheInterface] = None,

From 86a0d7aa78ef3b7126ba25709b8570186b56681d Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Mon, 10 Feb 2025 19:16:19 +0200
Subject: [PATCH 0967/1164] Since commands info and ft.info do not return
 redundant information - ft.info will not be deprecated in current release.
 (#3500)

---
 redis/commands/search/commands.py | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 2158c01ba9..e5e78578be 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -442,10 +442,6 @@ def get(self, *ids):
 
         return self.execute_command(MGET_CMD, self.index_name, *ids)
 
-    @deprecated_function(
-        version="8.0.0",
-        reason="deprecated since Redis 8.0, call info from core module instead",
-    )
     def info(self):
         """
         Get info an stats about the the current index, including the number of
@@ -916,10 +912,6 @@ def syndump(self):
 
 
 class AsyncSearchCommands(SearchCommands):
-    @deprecated_function(
-        version="8.0.0",
-        reason="deprecated since Redis 8.0, call info from core module instead",
-    )
     async def info(self):
         """
         Get info an stats about the the current index, including the number of

From 72cdaf69324cf2b21dae80fb5df1dea8e20be3e0 Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Tue, 11 Feb 2025 13:15:14 +0200
Subject: [PATCH 0968/1164] test: Updated CredentialProvider test
 infrastructure (#3502)

* test: Updated CredentialProvider test infrastructure

* Added linter exclusion

* Updated dev dependency

* Codestyle fixes

* Updated async test infra

* Added missing constant
---
 dev_requirements.txt           |  2 +-
 tests/conftest.py              | 99 +++++++++++++++++++++-------------
 tests/test_asyncio/conftest.py | 97 ++++++++++++++++++++-------------
 3 files changed, 124 insertions(+), 74 deletions(-)

diff --git a/dev_requirements.txt b/dev_requirements.txt
index be74470ec2..728536d6fb 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -16,4 +16,4 @@ uvloop
 vulture>=2.3.0
 wheel>=0.30.0
 numpy>=1.24.0
-redis-entraid==0.1.0b1
+redis-entraid==0.3.0b1
diff --git a/tests/conftest.py b/tests/conftest.py
index a900cea8bf..fc732c0d72 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -5,7 +5,7 @@
 import time
 from datetime import datetime, timezone
 from enum import Enum
-from typing import Callable, TypeVar
+from typing import Callable, TypeVar, Union
 from unittest import mock
 from unittest.mock import Mock
 from urllib.parse import urlparse
@@ -17,6 +17,7 @@
 from redis import Sentinel
 from redis.auth.idp import IdentityProviderInterface
 from redis.auth.token import JWToken
+from redis.auth.token_manager import RetryPolicy, TokenManagerConfig
 from redis.backoff import NoBackoff
 from redis.cache import (
     CacheConfig,
@@ -29,12 +30,21 @@
 from redis.credentials import CredentialProvider
 from redis.exceptions import RedisClusterException
 from redis.retry import Retry
-from redis_entraid.cred_provider import EntraIdCredentialsProvider, TokenAuthConfig
+from redis_entraid.cred_provider import (
+    DEFAULT_DELAY_IN_MS,
+    DEFAULT_EXPIRATION_REFRESH_RATIO,
+    DEFAULT_LOWER_REFRESH_BOUND_MILLIS,
+    DEFAULT_MAX_ATTEMPTS,
+    DEFAULT_TOKEN_REQUEST_EXECUTION_TIMEOUT_IN_MS,
+    EntraIdCredentialsProvider,
+)
 from redis_entraid.identity_provider import (
     ManagedIdentityIdType,
+    ManagedIdentityProviderConfig,
     ManagedIdentityType,
-    create_provider_from_managed_identity,
-    create_provider_from_service_principal,
+    ServicePrincipalIdentityProviderConfig,
+    _create_provider_from_managed_identity,
+    _create_provider_from_service_principal,
 )
 from tests.ssl_utils import get_tls_certificates
 
@@ -623,17 +633,33 @@ def identity_provider(request) -> IdentityProviderInterface:
         return mock_identity_provider()
 
     auth_type = kwargs.pop("auth_type", AuthType.SERVICE_PRINCIPAL)
+    config = get_identity_provider_config(request=request)
 
     if auth_type == "MANAGED_IDENTITY":
-        return _get_managed_identity_provider(request)
+        return _create_provider_from_managed_identity(config)
+
+    return _create_provider_from_service_principal(config)
 
-    return _get_service_principal_provider(request)
 
+def get_identity_provider_config(
+    request,
+) -> Union[ManagedIdentityProviderConfig, ServicePrincipalIdentityProviderConfig]:
+    if hasattr(request, "param"):
+        kwargs = request.param.get("idp_kwargs", {})
+    else:
+        kwargs = {}
+
+    auth_type = kwargs.pop("auth_type", AuthType.SERVICE_PRINCIPAL)
 
-def _get_managed_identity_provider(request):
-    authority = os.getenv("AZURE_AUTHORITY")
+    if auth_type == AuthType.MANAGED_IDENTITY:
+        return _get_managed_identity_provider_config(request)
+
+    return _get_service_principal_provider_config(request)
+
+
+def _get_managed_identity_provider_config(request) -> ManagedIdentityProviderConfig:
     resource = os.getenv("AZURE_RESOURCE")
-    id_value = os.getenv("AZURE_ID_VALUE", None)
+    id_value = os.getenv("AZURE_USER_ASSIGNED_MANAGED_ID", None)
 
     if hasattr(request, "param"):
         kwargs = request.param.get("idp_kwargs", {})
@@ -641,23 +667,24 @@ def _get_managed_identity_provider(request):
         kwargs = {}
 
     identity_type = kwargs.pop("identity_type", ManagedIdentityType.SYSTEM_ASSIGNED)
-    id_type = kwargs.pop("id_type", ManagedIdentityIdType.CLIENT_ID)
+    id_type = kwargs.pop("id_type", ManagedIdentityIdType.OBJECT_ID)
 
-    return create_provider_from_managed_identity(
+    return ManagedIdentityProviderConfig(
         identity_type=identity_type,
         resource=resource,
         id_type=id_type,
         id_value=id_value,
-        authority=authority,
-        **kwargs,
+        kwargs=kwargs,
     )
 
 
-def _get_service_principal_provider(request):
+def _get_service_principal_provider_config(
+    request,
+) -> ServicePrincipalIdentityProviderConfig:
     client_id = os.getenv("AZURE_CLIENT_ID")
     client_credential = os.getenv("AZURE_CLIENT_SECRET")
-    authority = os.getenv("AZURE_AUTHORITY")
-    scopes = os.getenv("AZURE_REDIS_SCOPES", [])
+    tenant_id = os.getenv("AZURE_TENANT_ID")
+    scopes = os.getenv("AZURE_REDIS_SCOPES", None)
 
     if hasattr(request, "param"):
         kwargs = request.param.get("idp_kwargs", {})
@@ -671,14 +698,14 @@ def _get_service_principal_provider(request):
     if isinstance(scopes, str):
         scopes = scopes.split(",")
 
-    return create_provider_from_service_principal(
+    return ServicePrincipalIdentityProviderConfig(
         client_id=client_id,
         client_credential=client_credential,
         scopes=scopes,
         timeout=timeout,
         token_kwargs=token_kwargs,
-        authority=authority,
-        **kwargs,
+        tenant_id=tenant_id,
+        app_kwargs=kwargs,
     )
 
 
@@ -690,31 +717,29 @@ def get_credential_provider(request) -> CredentialProvider:
         return cred_provider_class(**cred_provider_kwargs)
 
     idp = identity_provider(request)
-    initial_delay_in_ms = cred_provider_kwargs.get("initial_delay_in_ms", 0)
-    block_for_initial = cred_provider_kwargs.get("block_for_initial", False)
     expiration_refresh_ratio = cred_provider_kwargs.get(
-        "expiration_refresh_ratio", TokenAuthConfig.DEFAULT_EXPIRATION_REFRESH_RATIO
+        "expiration_refresh_ratio", DEFAULT_EXPIRATION_REFRESH_RATIO
     )
     lower_refresh_bound_millis = cred_provider_kwargs.get(
-        "lower_refresh_bound_millis", TokenAuthConfig.DEFAULT_LOWER_REFRESH_BOUND_MILLIS
-    )
-    max_attempts = cred_provider_kwargs.get(
-        "max_attempts", TokenAuthConfig.DEFAULT_MAX_ATTEMPTS
+        "lower_refresh_bound_millis", DEFAULT_LOWER_REFRESH_BOUND_MILLIS
     )
-    delay_in_ms = cred_provider_kwargs.get(
-        "delay_in_ms", TokenAuthConfig.DEFAULT_DELAY_IN_MS
+    max_attempts = cred_provider_kwargs.get("max_attempts", DEFAULT_MAX_ATTEMPTS)
+    delay_in_ms = cred_provider_kwargs.get("delay_in_ms", DEFAULT_DELAY_IN_MS)
+
+    token_mgr_config = TokenManagerConfig(
+        expiration_refresh_ratio=expiration_refresh_ratio,
+        lower_refresh_bound_millis=lower_refresh_bound_millis,
+        token_request_execution_timeout_in_ms=DEFAULT_TOKEN_REQUEST_EXECUTION_TIMEOUT_IN_MS,  # noqa
+        retry_policy=RetryPolicy(
+            max_attempts=max_attempts,
+            delay_in_ms=delay_in_ms,
+        ),
     )
 
-    auth_config = TokenAuthConfig(idp)
-    auth_config.expiration_refresh_ratio = expiration_refresh_ratio
-    auth_config.lower_refresh_bound_millis = lower_refresh_bound_millis
-    auth_config.max_attempts = max_attempts
-    auth_config.delay_in_ms = delay_in_ms
-
     return EntraIdCredentialsProvider(
-        config=auth_config,
-        initial_delay_in_ms=initial_delay_in_ms,
-        block_for_initial=block_for_initial,
+        identity_provider=idp,
+        token_manager_config=token_mgr_config,
+        initial_delay_in_ms=delay_in_ms,
     )
 
 
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index 8833426af1..fb6c51140e 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -17,14 +17,24 @@
 from redis.asyncio.retry import Retry
 from redis.auth.idp import IdentityProviderInterface
 from redis.auth.token import JWToken
+from redis.auth.token_manager import RetryPolicy, TokenManagerConfig
 from redis.backoff import NoBackoff
 from redis.credentials import CredentialProvider
-from redis_entraid.cred_provider import EntraIdCredentialsProvider, TokenAuthConfig
+from redis_entraid.cred_provider import (
+    DEFAULT_DELAY_IN_MS,
+    DEFAULT_EXPIRATION_REFRESH_RATIO,
+    DEFAULT_LOWER_REFRESH_BOUND_MILLIS,
+    DEFAULT_MAX_ATTEMPTS,
+    DEFAULT_TOKEN_REQUEST_EXECUTION_TIMEOUT_IN_MS,
+    EntraIdCredentialsProvider,
+)
 from redis_entraid.identity_provider import (
     ManagedIdentityIdType,
+    ManagedIdentityProviderConfig,
     ManagedIdentityType,
-    create_provider_from_managed_identity,
-    create_provider_from_service_principal,
+    ServicePrincipalIdentityProviderConfig,
+    _create_provider_from_managed_identity,
+    _create_provider_from_service_principal,
 )
 from tests.conftest import REDIS_INFO
 
@@ -255,17 +265,33 @@ def identity_provider(request) -> IdentityProviderInterface:
         return mock_identity_provider()
 
     auth_type = kwargs.pop("auth_type", AuthType.SERVICE_PRINCIPAL)
+    config = get_identity_provider_config(request=request)
 
     if auth_type == "MANAGED_IDENTITY":
-        return _get_managed_identity_provider(request)
+        return _create_provider_from_managed_identity(config)
+
+    return _create_provider_from_service_principal(config)
+
+
+def get_identity_provider_config(
+    request,
+) -> Union[ManagedIdentityProviderConfig, ServicePrincipalIdentityProviderConfig]:
+    if hasattr(request, "param"):
+        kwargs = request.param.get("idp_kwargs", {})
+    else:
+        kwargs = {}
 
-    return _get_service_principal_provider(request)
+    auth_type = kwargs.pop("auth_type", AuthType.SERVICE_PRINCIPAL)
+
+    if auth_type == AuthType.MANAGED_IDENTITY:
+        return _get_managed_identity_provider_config(request)
 
+    return _get_service_principal_provider_config(request)
 
-def _get_managed_identity_provider(request):
-    authority = os.getenv("AZURE_AUTHORITY")
+
+def _get_managed_identity_provider_config(request) -> ManagedIdentityProviderConfig:
     resource = os.getenv("AZURE_RESOURCE")
-    id_value = os.getenv("AZURE_ID_VALUE", None)
+    id_value = os.getenv("AZURE_USER_ASSIGNED_MANAGED_ID", None)
 
     if hasattr(request, "param"):
         kwargs = request.param.get("idp_kwargs", {})
@@ -273,23 +299,24 @@ def _get_managed_identity_provider(request):
         kwargs = {}
 
     identity_type = kwargs.pop("identity_type", ManagedIdentityType.SYSTEM_ASSIGNED)
-    id_type = kwargs.pop("id_type", ManagedIdentityIdType.CLIENT_ID)
+    id_type = kwargs.pop("id_type", ManagedIdentityIdType.OBJECT_ID)
 
-    return create_provider_from_managed_identity(
+    return ManagedIdentityProviderConfig(
         identity_type=identity_type,
         resource=resource,
         id_type=id_type,
         id_value=id_value,
-        authority=authority,
-        **kwargs,
+        kwargs=kwargs,
     )
 
 
-def _get_service_principal_provider(request):
+def _get_service_principal_provider_config(
+    request,
+) -> ServicePrincipalIdentityProviderConfig:
     client_id = os.getenv("AZURE_CLIENT_ID")
     client_credential = os.getenv("AZURE_CLIENT_SECRET")
-    authority = os.getenv("AZURE_AUTHORITY")
-    scopes = os.getenv("AZURE_REDIS_SCOPES", [])
+    tenant_id = os.getenv("AZURE_TENANT_ID")
+    scopes = os.getenv("AZURE_REDIS_SCOPES", None)
 
     if hasattr(request, "param"):
         kwargs = request.param.get("idp_kwargs", {})
@@ -303,14 +330,14 @@ def _get_service_principal_provider(request):
     if isinstance(scopes, str):
         scopes = scopes.split(",")
 
-    return create_provider_from_service_principal(
+    return ServicePrincipalIdentityProviderConfig(
         client_id=client_id,
         client_credential=client_credential,
         scopes=scopes,
         timeout=timeout,
         token_kwargs=token_kwargs,
-        authority=authority,
-        **kwargs,
+        tenant_id=tenant_id,
+        app_kwargs=kwargs,
     )
 
 
@@ -322,31 +349,29 @@ def get_credential_provider(request) -> CredentialProvider:
         return cred_provider_class(**cred_provider_kwargs)
 
     idp = identity_provider(request)
-    initial_delay_in_ms = cred_provider_kwargs.get("initial_delay_in_ms", 0)
-    block_for_initial = cred_provider_kwargs.get("block_for_initial", False)
     expiration_refresh_ratio = cred_provider_kwargs.get(
-        "expiration_refresh_ratio", TokenAuthConfig.DEFAULT_EXPIRATION_REFRESH_RATIO
+        "expiration_refresh_ratio", DEFAULT_EXPIRATION_REFRESH_RATIO
     )
     lower_refresh_bound_millis = cred_provider_kwargs.get(
-        "lower_refresh_bound_millis", TokenAuthConfig.DEFAULT_LOWER_REFRESH_BOUND_MILLIS
-    )
-    max_attempts = cred_provider_kwargs.get(
-        "max_attempts", TokenAuthConfig.DEFAULT_MAX_ATTEMPTS
+        "lower_refresh_bound_millis", DEFAULT_LOWER_REFRESH_BOUND_MILLIS
     )
-    delay_in_ms = cred_provider_kwargs.get(
-        "delay_in_ms", TokenAuthConfig.DEFAULT_DELAY_IN_MS
+    max_attempts = cred_provider_kwargs.get("max_attempts", DEFAULT_MAX_ATTEMPTS)
+    delay_in_ms = cred_provider_kwargs.get("delay_in_ms", DEFAULT_DELAY_IN_MS)
+
+    token_mgr_config = TokenManagerConfig(
+        expiration_refresh_ratio=expiration_refresh_ratio,
+        lower_refresh_bound_millis=lower_refresh_bound_millis,
+        token_request_execution_timeout_in_ms=DEFAULT_TOKEN_REQUEST_EXECUTION_TIMEOUT_IN_MS,  # noqa
+        retry_policy=RetryPolicy(
+            max_attempts=max_attempts,
+            delay_in_ms=delay_in_ms,
+        ),
     )
 
-    auth_config = TokenAuthConfig(idp)
-    auth_config.expiration_refresh_ratio = expiration_refresh_ratio
-    auth_config.lower_refresh_bound_millis = lower_refresh_bound_millis
-    auth_config.max_attempts = max_attempts
-    auth_config.delay_in_ms = delay_in_ms
-
     return EntraIdCredentialsProvider(
-        config=auth_config,
-        initial_delay_in_ms=initial_delay_in_ms,
-        block_for_initial=block_for_initial,
+        identity_provider=idp,
+        token_manager_config=token_mgr_config,
+        initial_delay_in_ms=delay_in_ms,
     )
 
 

From f037919bbb85f3ea043e5d2742def752b941598c Mon Sep 17 00:00:00 2001
From: Kevin Johnson <kcavemanj@gmail.com>
Date: Tue, 11 Feb 2025 10:16:03 -0500
Subject: [PATCH 0969/1164] Fixes minor grammar nit in documentation. (#3354)

---
 docs/opentelemetry.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/opentelemetry.rst b/docs/opentelemetry.rst
index c0285e6761..edf6a42071 100644
--- a/docs/opentelemetry.rst
+++ b/docs/opentelemetry.rst
@@ -46,7 +46,7 @@ You can then use it to instrument code like this:
 
    RedisInstrumentor().instrument()
 
-Once the code is patched, you can use redis-py as usually:
+Once the code is patched, you can use redis-py as usual:
 
 .. code-block:: python
 

From b8a05038112e92dbdb59fc01fe78b20426eed449 Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Thu, 13 Feb 2025 10:20:36 +0200
Subject: [PATCH 0970/1164] maintenance: Adding Python 3.13 compatibility
 (#3510)

---
 .github/workflows/integration.yaml | 10 +++++-----
 dev_requirements.txt               |  2 +-
 setup.py                           |  1 +
 3 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index c4548c21ef..4467de4f62 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -75,7 +75,7 @@ jobs:
       fail-fast: false
       matrix:
         redis-version: ['8.0-M04-pre', '${{ needs.redis_version.outputs.CURRENT }}', '7.2.7', '6.2.17']
-        python-version: ['3.8', '3.12']
+        python-version: ['3.8', '3.13']
         parser-backend: ['plain']
         event-loop: ['asyncio']
     env:
@@ -99,7 +99,7 @@ jobs:
       fail-fast: false
       matrix:
         redis-version: [ '${{ needs.redis_version.outputs.CURRENT }}' ]
-        python-version: ['3.9', '3.10', '3.11', 'pypy-3.9', 'pypy-3.10']
+        python-version: ['3.9', '3.10', '3.11', '3.12', 'pypy-3.9', 'pypy-3.10']
         parser-backend: [ 'plain' ]
         event-loop: [ 'asyncio' ]
     env:
@@ -123,7 +123,7 @@ jobs:
       fail-fast: false
       matrix:
         redis-version: [ '${{ needs.redis_version.outputs.CURRENT }}' ]
-        python-version: [ '3.8', '3.12']
+        python-version: [ '3.8', '3.13']
         parser-backend: [ 'hiredis' ]
         hiredis-version: [ '>=3.0.0', '<3.0.0' ]
         event-loop: [ 'asyncio' ]
@@ -149,7 +149,7 @@ jobs:
       fail-fast: false
       matrix:
         redis-version: [ '${{ needs.redis_version.outputs.CURRENT }}' ]
-        python-version: [ '3.8', '3.12' ]
+        python-version: [ '3.8', '3.13' ]
         parser-backend: [ 'plain' ]
         event-loop: [ 'uvloop' ]
     env:
@@ -192,7 +192,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12', 'pypy-3.9', 'pypy-3.10']
+        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12', '3.13', 'pypy-3.9', 'pypy-3.10']
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
diff --git a/dev_requirements.txt b/dev_requirements.txt
index 728536d6fb..619fbf479c 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -9,7 +9,7 @@ packaging>=20.4
 pytest
 pytest-asyncio>=0.23.0,<0.24.0
 pytest-cov
-pytest-profiling==1.7.0
+pytest-profiling==1.8.1
 pytest-timeout
 ujson>=4.2.0
 uvloop
diff --git a/setup.py b/setup.py
index 02853251b2..74f6fdafb7 100644
--- a/setup.py
+++ b/setup.py
@@ -54,6 +54,7 @@
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
         "Programming Language :: Python :: 3.12",
+        "Programming Language :: Python :: 3.13",
         "Programming Language :: Python :: Implementation :: CPython",
         "Programming Language :: Python :: Implementation :: PyPy",
     ],

From e1b81638579fb51f2b04a63abc73f0d9b945ccee Mon Sep 17 00:00:00 2001
From: Paolo <lazzari.paolok@gmail.com>
Date: Thu, 13 Feb 2025 10:37:27 +0100
Subject: [PATCH 0971/1164] Fix Incorrect markdown formatting for example in
 connection_examples.ipynb (#3504)

Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Co-authored-by: petyaslavova <petya.slavova@redis.com>
---
 docs/examples/connection_examples.ipynb | 21 +++++++++++++++++----
 1 file changed, 17 insertions(+), 4 deletions(-)

diff --git a/docs/examples/connection_examples.ipynb b/docs/examples/connection_examples.ipynb
index fd60e2a495..05c2c82081 100644
--- a/docs/examples/connection_examples.ipynb
+++ b/docs/examples/connection_examples.ipynb
@@ -75,13 +75,26 @@
    ]
   },
   {
-   "cell_type": "markdown",
+   "cell_type": "code",
+   "execution_count": 4,
    "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+    },
+     "execution_count": 4,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "import redis\n",
     "\n",
     "r = redis.Redis(protocol=3)\n",
-    "rcon.ping()"
+    "r.ping()"
    ]
   },
   {
@@ -93,7 +106,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 4,
+   "execution_count": 5,
    "metadata": {},
    "outputs": [
     {
@@ -102,7 +115,7 @@
        "True"
       ]
      },
-     "execution_count": 4,
+     "execution_count": 5,
      "metadata": {},
      "output_type": "execute_result"
     }

From 7ddb74734a0e083298c2ed7bdfe62359c83a45d0 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 13 Feb 2025 12:40:53 +0200
Subject: [PATCH 0972/1164] Adding unit test for core info command related to
 modules info (#3507)

---
 tests/test_commands.py | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/tests/test_commands.py b/tests/test_commands.py
index 24c320a3f3..f89c5f3365 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1066,6 +1066,21 @@ def test_info_multi_sections(self, r):
         assert "redis_version" in res
         assert "connected_clients" in res
 
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.9.0")
+    def test_info_with_modules(self, r: redis.Redis):
+        res = r.info(section="everything")
+        assert "modules" in res
+        assert "search_number_of_indexes" in res
+
+        res = r.info(section="modules")
+        assert "modules" in res
+        assert "search_number_of_indexes" in res
+
+        res = r.info(section="search")
+        assert "modules" not in res
+        assert "search_number_of_indexes" in res
+
     @pytest.mark.onlynoncluster
     @skip_if_redis_enterprise()
     def test_lastsave(self, r):

From db74c1ac3a7c874df8e16e164b6af1d2a6400925 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 13 Feb 2025 14:45:40 +0200
Subject: [PATCH 0973/1164] Replacing the redis and redis-stack-server images
 with redis-libs-tests image in test infrastructure (#3505)

* Replacing the redis image with redis-libs-tests image in test infrastructure

* Replacing redis-stack-server image usage with client-libs-test. Fixing lib version in setup.py

* Defining stack tag variable for the build and test github action

* Removing unused env var from build and test github actions
---
 .github/actions/run-tests/action.yml | 15 ++----
 .github/workflows/integration.yaml   |  8 ++--
 .gitignore                           |  3 ++
 docker-compose.yml                   | 70 ++++++++++++----------------
 setup.py                             |  2 +-
 5 files changed, 43 insertions(+), 55 deletions(-)

diff --git a/.github/actions/run-tests/action.yml b/.github/actions/run-tests/action.yml
index 1f9332fb86..ca775f5a5b 100644
--- a/.github/actions/run-tests/action.yml
+++ b/.github/actions/run-tests/action.yml
@@ -31,14 +31,9 @@ runs:
     - name: Setup Test environment
       env:
         REDIS_VERSION: ${{ inputs.redis-version }}
-        REDIS_IMAGE: "redis:${{ inputs.redis-version }}"
-        CLIENT_LIBS_TEST_IMAGE: "redislabs/client-libs-test:${{ inputs.redis-version }}"
+        CLIENT_LIBS_TEST_IMAGE_TAG: ${{ inputs.redis-version }}
       run: |
         set -e
-        
-        if [ "${{inputs.redis-version}}" == "8.0-M04-pre" ]; then
-          export REDIS_IMAGE=redis:8.0-M03
-        fi
                 
         echo "::group::Installing dependencies"
         pip install -U setuptools wheel
@@ -60,13 +55,13 @@ runs:
         
           # Mapping of redis version to stack version  
           declare -A redis_stack_version_mapping=(
-            ["7.4.2"]="7.4.0-v2"
-            ["7.2.7"]="7.2.0-v14"
-            ["6.2.17"]="6.2.6-v18"
+            ["7.4.2"]="rs-7.4.0-v2"
+            ["7.2.7"]="rs-7.2.0-v14"
+            ["6.2.17"]="rs-6.2.6-v18"
           )
                   
           if [[ -v redis_stack_version_mapping[$REDIS_VERSION] ]]; then
-            export REDIS_STACK_IMAGE="redis/redis-stack-server:${redis_stack_version_mapping[$REDIS_VERSION]}"
+            export CLIENT_LIBS_TEST_STACK_IMAGE_TAG=${redis_stack_version_mapping[$REDIS_VERSION]}
             echo "REDIS_MOD_URL=redis://127.0.0.1:6479/0" >> $GITHUB_ENV
           else
             echo "Version not found in the mapping."
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 4467de4f62..45e0d5bf8e 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -27,8 +27,7 @@ env:
   CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
   # this speeds up coverage with Python 3.12: https://github.com/nedbat/coveragepy/issues/1665
   COVERAGE_CORE: sysmon
-  REDIS_IMAGE: redis:latest
-  REDIS_STACK_IMAGE: redis/redis-stack-server:latest
+  CURRENT_CLIENT_LIBS_TEST_STACK_IMAGE_TAG: 'rs-7.4.0-v2'
   CURRENT_REDIS_VERSION: '7.4.2'
 
 jobs:
@@ -180,9 +179,8 @@ jobs:
           python-version: 3.9
       - name: Run installed unit tests
         env:
-          REDIS_VERSION: ${{ env.CURRENT_REDIS_VERSION }}
-          REDIS_IMAGE: "redis:${{ env.CURRENT_REDIS_VERSION }}"
-          CLIENT_LIBS_TEST_IMAGE: "redislabs/client-libs-test:${{ env.CURRENT_REDIS_VERSION }}"
+          CLIENT_LIBS_TEST_IMAGE_TAG: ${{ env.CURRENT_REDIS_VERSION }}
+          CLIENT_LIBS_TEST_STACK_IMAGE_TAG: ${{ env.CURRENT_CLIENT_LIBS_TEST_STACK_IMAGE_TAG }}
         run: |
           bash .github/workflows/install_and_test.sh ${{ matrix.extension }}
 
diff --git a/.gitignore b/.gitignore
index ee1bda0fa5..5f77dcfde4 100644
--- a/.gitignore
+++ b/.gitignore
@@ -23,3 +23,6 @@ docker/stunnel/keys
 /dockers/*/tls/*
 /dockers/standalone/
 /dockers/cluster/
+/dockers/replica/
+/dockers/sentinel/
+/dockers/redis-stack/
diff --git a/docker-compose.yml b/docker-compose.yml
index 60657d5653..8ca3471311 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,9 +1,14 @@
 ---
+x-client-libs-stack-image: &client-libs-stack-image
+  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_STACK_IMAGE_TAG:-rs-7.4.0-v2}"
+
+x-client-libs-image: &client-libs-image
+  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_IMAGE_TAG:-7.4.2}"
 
 services:
 
   redis:
-    image: ${CLIENT_LIBS_TEST_IMAGE:-redislabs/client-libs-test:7.4.1}
+    <<: *client-libs-image
     container_name: redis-standalone
     environment:
       - TLS_ENABLED=yes
@@ -24,20 +29,26 @@ services:
       - all
 
   replica:
-    image: ${REDIS_IMAGE:-redis:7.4.1}
+    <<: *client-libs-image
     container_name: redis-replica
     depends_on:
       - redis
-    command: redis-server --replicaof redis 6379 --protected-mode no --save ""
+    environment:
+      - TLS_ENABLED=no
+      - REDIS_CLUSTER=no
+      - PORT=6380
+    command: ${REDIS_EXTRA_ARGS:---enable-debug-command yes --replicaof redis 6379 --protected-mode no --save ""}
     ports:
-      - 6380:6379
+      - 6380:6380
+    volumes:
+      - "./dockers/replica:/redis/work"
     profiles:
       - replica
       - all-stack
       - all
 
   cluster:
-    image: ${CLIENT_LIBS_TEST_IMAGE:-redislabs/client-libs-test:7.4.1}
+    <<: *client-libs-image
     container_name: redis-cluster
     environment:
       - REDIS_CLUSTER=yes
@@ -58,57 +69,38 @@ services:
       - all
 
   sentinel:
-    image: ${REDIS_IMAGE:-redis:7.4.1}
+    <<: *client-libs-image
     container_name: redis-sentinel
     depends_on:
       - redis
-    entrypoint: "redis-sentinel /redis.conf --port 26379"
+    environment:
+      - REDIS_CLUSTER=no
+      - NODES=3
+      - PORT=26379
+    command: ${REDIS_EXTRA_ARGS:---sentinel}
     ports:
       - 26379:26379
-    volumes:
-      - "./dockers/sentinel.conf:/redis.conf"
-    profiles:
-      - sentinel
-      - all-stack
-      - all
-
-  sentinel2:
-    image: ${REDIS_IMAGE:-redis:7.4.1}
-    container_name: redis-sentinel2
-    depends_on:
-      - redis
-    entrypoint: "redis-sentinel /redis.conf --port 26380"
-    ports:
       - 26380:26380
-    volumes:
-      - "./dockers/sentinel.conf:/redis.conf"
-    profiles:
-      - sentinel
-      - all-stack
-      - all
-
-  sentinel3:
-    image: ${REDIS_IMAGE:-redis:7.4.1}
-    container_name: redis-sentinel3
-    depends_on:
-      - redis
-    entrypoint: "redis-sentinel /redis.conf --port 26381"
-    ports:
       - 26381:26381
     volumes:
-      - "./dockers/sentinel.conf:/redis.conf"
+      - "./dockers/sentinel.conf:/redis/config-default/redis.conf"
+      - "./dockers/sentinel:/redis/work"
     profiles:
       - sentinel
       - all-stack
       - all
 
   redis-stack:
-    image: ${REDIS_STACK_IMAGE:-redis/redis-stack-server:latest}
+    <<: *client-libs-stack-image
     container_name: redis-stack
+    environment:
+      - REDIS_CLUSTER=no
+      - PORT=6379
+    command: ${REDIS_EXTRA_ARGS:---enable-debug-command yes --enable-module-command yes --save ""}
     ports:
       - 6479:6379
-    environment:
-      - "REDIS_ARGS=${REDIS_STACK_EXTRA_ARGS:---enable-debug-command yes --enable-module-command yes --save ''}"
+    volumes:
+      - "./dockers/redis-stack:/redis/work"
     profiles:
       - standalone
       - all-stack
diff --git a/setup.py b/setup.py
index 74f6fdafb7..2cde3fb51b 100644
--- a/setup.py
+++ b/setup.py
@@ -8,7 +8,7 @@
     long_description_content_type="text/markdown",
     keywords=["Redis", "key-value store", "database"],
     license="MIT",
-    version="5.1.1",
+    version="5.2.1",
     packages=find_packages(
         include=[
             "redis",

From 8b53a9db84861251129cf48d68b926677777b8a5 Mon Sep 17 00:00:00 2001
From: Max Base <MaxBaseCode@Gmail.Com>
Date: Thu, 13 Feb 2025 15:12:22 +0100
Subject: [PATCH 0974/1164] Fix formatting in README.md - 'Note' - bold
 formatting (#3413)

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 98ddee5b52..8b4d4b6875 100644
--- a/README.md
+++ b/README.md
@@ -13,7 +13,7 @@ The Python interface to the Redis key-value store.
 
 ---------------------------------------------
 
-**Note: ** redis-py 5.0 will be the last version of redis-py to support Python 3.7, as it has reached [end of life](https://devguide.python.org/versions/). redis-py 5.1 will support Python 3.8+.
+**Note:** redis-py 5.0 will be the last version of redis-py to support Python 3.7, as it has reached [end of life](https://devguide.python.org/versions/). redis-py 5.1 will support Python 3.8+.
 
 ---------------------------------------------
 

From 746653a676cdade214a8fa7f433f930202805bf2 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 13 Feb 2025 17:06:18 +0200
Subject: [PATCH 0975/1164] Adding dev_requirements.txt and  pytest.ini
 resources into sdist. Fix for issue #3057 (#3511)

---
 MANIFEST.in | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/MANIFEST.in b/MANIFEST.in
index 97fa305889..80afb437ff 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -1,6 +1,8 @@
 include INSTALL
 include LICENSE
 include README.md
+include dev_requirements.txt
+include pytest.ini
 exclude __pycache__
 recursive-include tests *
 recursive-exclude tests *.pyc

From 60f24a9999aab0d2dfd3120a4d18ff1cc14dec9e Mon Sep 17 00:00:00 2001
From: Mateusz Bilski <mateusz.bilski@gmail.com>
Date: Mon, 17 Feb 2025 14:40:33 +0100
Subject: [PATCH 0976/1164] Reinitialize the cluster in case of TimeoutError
 inside a pipeline (#3513)

---
 redis/cluster.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index 6c6cfbf114..db866ce2bf 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -2185,7 +2185,7 @@ def _send_cluster_commands(
                     redis_node = self.get_redis_connection(node)
                     try:
                         connection = get_connection(redis_node, c.args)
-                    except ConnectionError:
+                    except (ConnectionError, TimeoutError):
                         for n in nodes.values():
                             n.connection_pool.release(n.connection)
                         # Connection retries are being handled in the node's

From 05e3094d62c57ce994b9349ef30cdf603e537cee Mon Sep 17 00:00:00 2001
From: Daniel <daniel@djroze.com>
Date: Tue, 18 Feb 2025 02:54:20 -0800
Subject: [PATCH 0977/1164] Fix inaccurate docstring for unwatch() (#3424)

The 'unwatch()' method of the Redis client, as currently documented, says that it unwatches the value at key "name", but it does not actually take any arguments ("name" or otherwise). According to the latest Redis documentation at the given URL for the UNWATCH command, this command unwatches all previously watched keys for the current transaction. Modified docstring to reflect that this method does not take any arguments and instead (presumably) unwatches all previously watched keys.
---
 redis/commands/core.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 8986a48de2..1d19e33f2c 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -2496,7 +2496,7 @@ def watch(self, *names: KeyT) -> None:
 
     def unwatch(self) -> None:
         """
-        Unwatches the value at key ``name``, or None of the key doesn't exist
+        Unwatches all previously watched keys for a transaction
 
         For more information see https://redis.io/commands/unwatch
         """

From 799716c1c65dff90db2d36eb7ee185cbe51eb56a Mon Sep 17 00:00:00 2001
From: birthdaysgift <35929293+birthdaysgift@users.noreply.github.com>
Date: Wed, 19 Feb 2025 11:01:09 +0300
Subject: [PATCH 0978/1164] Fix invalid return type annotation (#3480)

---
 redis/connection.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/connection.py b/redis/connection.py
index d47f46590b..c4ff9b7b17 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -672,7 +672,7 @@ def pack_commands(self, commands):
             output.append(SYM_EMPTY.join(pieces))
         return output
 
-    def get_protocol(self) -> int or str:
+    def get_protocol(self) -> Union[int, str]:
         return self.protocol
 
     @property

From 8427c7b454f1627ee4c5b5eb51a4af14bf9a4509 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 20 Feb 2025 09:54:28 +0200
Subject: [PATCH 0979/1164] Deprecating unused arguments in connection pools's
 get_connection functions (#3517)

---
 redis/asyncio/client.py                    | 16 ++----
 redis/asyncio/connection.py                | 16 +++++-
 redis/client.py                            | 14 ++---
 redis/cluster.py                           | 18 +++---
 redis/connection.py                        | 16 +++++-
 redis/utils.py                             | 65 ++++++++++++++++++++++
 tests/test_asyncio/test_connection.py      |  2 +-
 tests/test_asyncio/test_connection_pool.py | 64 ++++++++++-----------
 tests/test_asyncio/test_credentials.py     |  2 +-
 tests/test_asyncio/test_encoding.py        |  2 +-
 tests/test_asyncio/test_retry.py           |  4 +-
 tests/test_asyncio/test_sentinel.py        |  2 +-
 tests/test_cache.py                        |  6 +-
 tests/test_cluster.py                      |  4 +-
 tests/test_connection_pool.py              | 60 ++++++++++----------
 tests/test_credentials.py                  |  2 +-
 tests/test_multiprocessing.py              | 10 ++--
 tests/test_retry.py                        |  4 +-
 tests/test_sentinel.py                     |  2 +-
 19 files changed, 196 insertions(+), 113 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 7c17938714..4254441073 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -375,7 +375,7 @@ async def initialize(self: _RedisT) -> _RedisT:
         if self.single_connection_client:
             async with self._single_conn_lock:
                 if self.connection is None:
-                    self.connection = await self.connection_pool.get_connection("_")
+                    self.connection = await self.connection_pool.get_connection()
 
             self._event_dispatcher.dispatch(
                 AfterSingleConnectionInstantiationEvent(
@@ -638,7 +638,7 @@ async def execute_command(self, *args, **options):
         await self.initialize()
         pool = self.connection_pool
         command_name = args[0]
-        conn = self.connection or await pool.get_connection(command_name, **options)
+        conn = self.connection or await pool.get_connection()
 
         if self.single_connection_client:
             await self._single_conn_lock.acquire()
@@ -712,7 +712,7 @@ def __init__(self, connection_pool: ConnectionPool):
 
     async def connect(self):
         if self.connection is None:
-            self.connection = await self.connection_pool.get_connection("MONITOR")
+            self.connection = await self.connection_pool.get_connection()
 
     async def __aenter__(self):
         await self.connect()
@@ -900,9 +900,7 @@ async def connect(self):
         Ensure that the PubSub is connected
         """
         if self.connection is None:
-            self.connection = await self.connection_pool.get_connection(
-                "pubsub", self.shard_hint
-            )
+            self.connection = await self.connection_pool.get_connection()
             # register a callback that re-subscribes to any channels we
             # were listening to when we were disconnected
             self.connection.register_connect_callback(self.on_connect)
@@ -1370,9 +1368,7 @@ async def immediate_execute_command(self, *args, **options):
         conn = self.connection
         # if this is the first call, we need a connection
         if not conn:
-            conn = await self.connection_pool.get_connection(
-                command_name, self.shard_hint
-            )
+            conn = await self.connection_pool.get_connection()
             self.connection = conn
 
         return await conn.retry.call_with_retry(
@@ -1568,7 +1564,7 @@ async def execute(self, raise_on_error: bool = True) -> List[Any]:
 
         conn = self.connection
         if not conn:
-            conn = await self.connection_pool.get_connection("MULTI", self.shard_hint)
+            conn = await self.connection_pool.get_connection()
             # assign to self.connection so reset() releases the connection
             # back to the pool after we're done
             self.connection = conn
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 4a743ff374..e67dc5b207 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -29,7 +29,7 @@
 
 from ..auth.token import TokenInterface
 from ..event import AsyncAfterConnectionReleasedEvent, EventDispatcher
-from ..utils import format_error_message
+from ..utils import deprecated_args, format_error_message
 
 # the functionality is available in 3.11.x but has a major issue before
 # 3.11.3. See https://github.com/redis/redis-py/issues/2633
@@ -1087,7 +1087,12 @@ def can_get_connection(self) -> bool:
             or len(self._in_use_connections) < self.max_connections
         )
 
-    async def get_connection(self, command_name, *keys, **options):
+    @deprecated_args(
+        args_to_warn=["*"],
+        reason="Use get_connection() without args instead",
+        version="5.0.3",
+    )
+    async def get_connection(self, command_name=None, *keys, **options):
         async with self._lock:
             """Get a connected connection from the pool"""
             connection = self.get_available_connection()
@@ -1255,7 +1260,12 @@ def __init__(
         self._condition = asyncio.Condition()
         self.timeout = timeout
 
-    async def get_connection(self, command_name, *keys, **options):
+    @deprecated_args(
+        args_to_warn=["*"],
+        reason="Use get_connection() without args instead",
+        version="5.0.3",
+    )
+    async def get_connection(self, command_name=None, *keys, **options):
         """Gets a connection from the pool, blocking until one is available"""
         try:
             async with self._condition:
diff --git a/redis/client.py b/redis/client.py
index 5a9f4fafb5..fc535c8ca0 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -366,7 +366,7 @@ def __init__(
         self.connection = None
         self._single_connection_client = single_connection_client
         if self._single_connection_client:
-            self.connection = self.connection_pool.get_connection("_")
+            self.connection = self.connection_pool.get_connection()
             self._event_dispatcher.dispatch(
                 AfterSingleConnectionInstantiationEvent(
                     self.connection, ClientType.SYNC, self.single_connection_lock
@@ -608,7 +608,7 @@ def _execute_command(self, *args, **options):
         """Execute a command and return a parsed response"""
         pool = self.connection_pool
         command_name = args[0]
-        conn = self.connection or pool.get_connection(command_name, **options)
+        conn = self.connection or pool.get_connection()
 
         if self._single_connection_client:
             self.single_connection_lock.acquire()
@@ -667,7 +667,7 @@ class Monitor:
 
     def __init__(self, connection_pool):
         self.connection_pool = connection_pool
-        self.connection = self.connection_pool.get_connection("MONITOR")
+        self.connection = self.connection_pool.get_connection()
 
     def __enter__(self):
         self.connection.send_command("MONITOR")
@@ -840,9 +840,7 @@ def execute_command(self, *args):
         # subscribed to one or more channels
 
         if self.connection is None:
-            self.connection = self.connection_pool.get_connection(
-                "pubsub", self.shard_hint
-            )
+            self.connection = self.connection_pool.get_connection()
             # register a callback that re-subscribes to any channels we
             # were listening to when we were disconnected
             self.connection.register_connect_callback(self.on_connect)
@@ -1397,7 +1395,7 @@ def immediate_execute_command(self, *args, **options):
         conn = self.connection
         # if this is the first call, we need a connection
         if not conn:
-            conn = self.connection_pool.get_connection(command_name, self.shard_hint)
+            conn = self.connection_pool.get_connection()
             self.connection = conn
 
         return conn.retry.call_with_retry(
@@ -1583,7 +1581,7 @@ def execute(self, raise_on_error: bool = True) -> List[Any]:
 
         conn = self.connection
         if not conn:
-            conn = self.connection_pool.get_connection("MULTI", self.shard_hint)
+            conn = self.connection_pool.get_connection()
             # assign to self.connection so reset() releases the connection
             # back to the pool after we're done
             self.connection = conn
diff --git a/redis/cluster.py b/redis/cluster.py
index db866ce2bf..c184838a9b 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -40,6 +40,7 @@
 from redis.retry import Retry
 from redis.utils import (
     HIREDIS_AVAILABLE,
+    deprecated_args,
     dict_merge,
     list_keys_to_dict,
     merge_result,
@@ -52,10 +53,13 @@ def get_node_name(host: str, port: Union[str, int]) -> str:
     return f"{host}:{port}"
 
 
+@deprecated_args(
+    allowed_args=["redis_node"],
+    reason="Use get_connection(redis_node) instead",
+    version="5.0.3",
+)
 def get_connection(redis_node, *args, **options):
-    return redis_node.connection or redis_node.connection_pool.get_connection(
-        args[0], **options
-    )
+    return redis_node.connection or redis_node.connection_pool.get_connection()
 
 
 def parse_scan_result(command, res, **options):
@@ -1151,7 +1155,7 @@ def _execute_command(self, target_node, *args, **kwargs):
                     moved = False
 
                 redis_node = self.get_redis_connection(target_node)
-                connection = get_connection(redis_node, *args, **kwargs)
+                connection = get_connection(redis_node)
                 if asking:
                     connection.send_command("ASKING")
                     redis_node.parse_response(connection, "ASKING", **kwargs)
@@ -1822,9 +1826,7 @@ def execute_command(self, *args):
                 self.node = node
                 redis_connection = self.cluster.get_redis_connection(node)
                 self.connection_pool = redis_connection.connection_pool
-            self.connection = self.connection_pool.get_connection(
-                "pubsub", self.shard_hint
-            )
+            self.connection = self.connection_pool.get_connection()
             # register a callback that re-subscribes to any channels we
             # were listening to when we were disconnected
             self.connection.register_connect_callback(self.on_connect)
@@ -2184,7 +2186,7 @@ def _send_cluster_commands(
                 if node_name not in nodes:
                     redis_node = self.get_redis_connection(node)
                     try:
-                        connection = get_connection(redis_node, c.args)
+                        connection = get_connection(redis_node)
                     except (ConnectionError, TimeoutError):
                         for n in nodes.values():
                             n.connection_pool.release(n.connection)
diff --git a/redis/connection.py b/redis/connection.py
index c4ff9b7b17..d59a9b069b 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -42,6 +42,7 @@
     HIREDIS_AVAILABLE,
     SSL_AVAILABLE,
     compare_versions,
+    deprecated_args,
     ensure_string,
     format_error_message,
     get_lib_version,
@@ -1461,8 +1462,14 @@ def _checkpid(self) -> None:
             finally:
                 self._fork_lock.release()
 
-    def get_connection(self, command_name: str, *keys, **options) -> "Connection":
+    @deprecated_args(
+        args_to_warn=["*"],
+        reason="Use get_connection() without args instead",
+        version="5.0.3",
+    )
+    def get_connection(self, command_name=None, *keys, **options) -> "Connection":
         "Get a connection from the pool"
+
         self._checkpid()
         with self._lock:
             try:
@@ -1683,7 +1690,12 @@ def make_connection(self):
         self._connections.append(connection)
         return connection
 
-    def get_connection(self, command_name, *keys, **options):
+    @deprecated_args(
+        args_to_warn=["*"],
+        reason="Use get_connection() without args instead",
+        version="5.0.3",
+    )
+    def get_connection(self, command_name=None, *keys, **options):
         """
         Get a connection, blocking for ``self.timeout`` until a connection
         is available from the pool.
diff --git a/redis/utils.py b/redis/utils.py
index 8693fb3c8f..66465636a1 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -122,6 +122,71 @@ def wrapper(*args, **kwargs):
     return decorator
 
 
+def warn_deprecated_arg_usage(
+    arg_name: Union[list, str],
+    function_name: str,
+    reason: str = "",
+    version: str = "",
+    stacklevel: int = 2,
+):
+    import warnings
+
+    msg = (
+        f"Call to '{function_name}' function with deprecated"
+        f" usage of input argument/s '{arg_name}'."
+    )
+    if reason:
+        msg += f" ({reason})"
+    if version:
+        msg += f" -- Deprecated since version {version}."
+    warnings.warn(msg, category=DeprecationWarning, stacklevel=stacklevel)
+
+
+def deprecated_args(
+    args_to_warn: list = ["*"],
+    allowed_args: list = [],
+    reason: str = "",
+    version: str = "",
+):
+    """
+    Decorator to mark specified args of a function as deprecated.
+    If '*' is in args_to_warn, all arguments will be marked as deprecated.
+    """
+
+    def decorator(func):
+        @wraps(func)
+        def wrapper(*args, **kwargs):
+            # Get function argument names
+            arg_names = func.__code__.co_varnames[: func.__code__.co_argcount]
+
+            provided_args = dict(zip(arg_names, args))
+            provided_args.update(kwargs)
+
+            provided_args.pop("self", None)
+            for allowed_arg in allowed_args:
+                provided_args.pop(allowed_arg, None)
+
+            for arg in args_to_warn:
+                if arg == "*" and len(provided_args) > 0:
+                    warn_deprecated_arg_usage(
+                        list(provided_args.keys()),
+                        func.__name__,
+                        reason,
+                        version,
+                        stacklevel=3,
+                    )
+                elif arg in provided_args:
+                    warn_deprecated_arg_usage(
+                        arg, func.__name__, reason, version, stacklevel=3
+                    )
+
+            return func(*args, **kwargs)
+
+        return wrapper
+
+    return decorator
+
+
 def _set_info_logger():
     """
     Set up a logger that log info logs to stdout.
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index d4956f16e9..38764d30cd 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -78,7 +78,7 @@ async def call_with_retry(self, _, __):
     mock_conn = mock.AsyncMock(spec=Connection)
     mock_conn.retry = Retry_()
 
-    async def get_conn(_):
+    async def get_conn():
         # Validate only one client is created in single-client mode when
         # concurrent requests are made
         nonlocal init_call_count
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
index 83545b4ede..3d120e4ca7 100644
--- a/tests/test_asyncio/test_connection_pool.py
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -29,8 +29,8 @@ def get_total_connected_connections(pool):
     @staticmethod
     async def create_two_conn(r: redis.Redis):
         if not r.single_connection_client:  # Single already initialized connection
-            r.connection = await r.connection_pool.get_connection("_")
-        return await r.connection_pool.get_connection("_")
+            r.connection = await r.connection_pool.get_connection()
+        return await r.connection_pool.get_connection()
 
     @staticmethod
     def has_no_connected_connections(pool: redis.ConnectionPool):
@@ -138,7 +138,7 @@ async def test_connection_creation(self):
         async with self.get_pool(
             connection_kwargs=connection_kwargs, connection_class=DummyConnection
         ) as pool:
-            connection = await pool.get_connection("_")
+            connection = await pool.get_connection()
             assert isinstance(connection, DummyConnection)
             assert connection.kwargs == connection_kwargs
 
@@ -155,8 +155,8 @@ async def test_aclosing(self):
     async def test_multiple_connections(self, master_host):
         connection_kwargs = {"host": master_host[0]}
         async with self.get_pool(connection_kwargs=connection_kwargs) as pool:
-            c1 = await pool.get_connection("_")
-            c2 = await pool.get_connection("_")
+            c1 = await pool.get_connection()
+            c2 = await pool.get_connection()
             assert c1 != c2
 
     async def test_max_connections(self, master_host):
@@ -164,17 +164,17 @@ async def test_max_connections(self, master_host):
         async with self.get_pool(
             max_connections=2, connection_kwargs=connection_kwargs
         ) as pool:
-            await pool.get_connection("_")
-            await pool.get_connection("_")
+            await pool.get_connection()
+            await pool.get_connection()
             with pytest.raises(redis.ConnectionError):
-                await pool.get_connection("_")
+                await pool.get_connection()
 
     async def test_reuse_previously_released_connection(self, master_host):
         connection_kwargs = {"host": master_host[0]}
         async with self.get_pool(connection_kwargs=connection_kwargs) as pool:
-            c1 = await pool.get_connection("_")
+            c1 = await pool.get_connection()
             await pool.release(c1)
-            c2 = await pool.get_connection("_")
+            c2 = await pool.get_connection()
             assert c1 == c2
 
     async def test_repr_contains_db_info_tcp(self):
@@ -223,7 +223,7 @@ async def test_connection_creation(self, master_host):
             "port": master_host[1],
         }
         async with self.get_pool(connection_kwargs=connection_kwargs) as pool:
-            connection = await pool.get_connection("_")
+            connection = await pool.get_connection()
             assert isinstance(connection, DummyConnection)
             assert connection.kwargs == connection_kwargs
 
@@ -236,14 +236,14 @@ async def test_disconnect(self, master_host):
             "port": master_host[1],
         }
         async with self.get_pool(connection_kwargs=connection_kwargs) as pool:
-            await pool.get_connection("_")
+            await pool.get_connection()
             await pool.disconnect()
 
     async def test_multiple_connections(self, master_host):
         connection_kwargs = {"host": master_host[0], "port": master_host[1]}
         async with self.get_pool(connection_kwargs=connection_kwargs) as pool:
-            c1 = await pool.get_connection("_")
-            c2 = await pool.get_connection("_")
+            c1 = await pool.get_connection()
+            c2 = await pool.get_connection()
             assert c1 != c2
 
     async def test_connection_pool_blocks_until_timeout(self, master_host):
@@ -252,11 +252,11 @@ async def test_connection_pool_blocks_until_timeout(self, master_host):
         async with self.get_pool(
             max_connections=1, timeout=0.1, connection_kwargs=connection_kwargs
         ) as pool:
-            c1 = await pool.get_connection("_")
+            c1 = await pool.get_connection()
 
             start = asyncio.get_running_loop().time()
             with pytest.raises(redis.ConnectionError):
-                await pool.get_connection("_")
+                await pool.get_connection()
 
             # we should have waited at least some period of time
             assert asyncio.get_running_loop().time() - start >= 0.05
@@ -271,23 +271,23 @@ async def test_connection_pool_blocks_until_conn_available(self, master_host):
         async with self.get_pool(
             max_connections=1, timeout=2, connection_kwargs=connection_kwargs
         ) as pool:
-            c1 = await pool.get_connection("_")
+            c1 = await pool.get_connection()
 
             async def target():
                 await asyncio.sleep(0.1)
                 await pool.release(c1)
 
             start = asyncio.get_running_loop().time()
-            await asyncio.gather(target(), pool.get_connection("_"))
+            await asyncio.gather(target(), pool.get_connection())
             stop = asyncio.get_running_loop().time()
             assert (stop - start) <= 0.2
 
     async def test_reuse_previously_released_connection(self, master_host):
         connection_kwargs = {"host": master_host[0]}
         async with self.get_pool(connection_kwargs=connection_kwargs) as pool:
-            c1 = await pool.get_connection("_")
+            c1 = await pool.get_connection()
             await pool.release(c1)
-            c2 = await pool.get_connection("_")
+            c2 = await pool.get_connection()
             assert c1 == c2
 
     def test_repr_contains_db_info_tcp(self):
@@ -552,23 +552,23 @@ def test_cert_reqs_options(self):
         import ssl
 
         class DummyConnectionPool(redis.ConnectionPool):
-            def get_connection(self, *args, **kwargs):
+            def get_connection(self):
                 return self.make_connection()
 
         pool = DummyConnectionPool.from_url("rediss://?ssl_cert_reqs=none")
-        assert pool.get_connection("_").cert_reqs == ssl.CERT_NONE
+        assert pool.get_connection().cert_reqs == ssl.CERT_NONE
 
         pool = DummyConnectionPool.from_url("rediss://?ssl_cert_reqs=optional")
-        assert pool.get_connection("_").cert_reqs == ssl.CERT_OPTIONAL
+        assert pool.get_connection().cert_reqs == ssl.CERT_OPTIONAL
 
         pool = DummyConnectionPool.from_url("rediss://?ssl_cert_reqs=required")
-        assert pool.get_connection("_").cert_reqs == ssl.CERT_REQUIRED
+        assert pool.get_connection().cert_reqs == ssl.CERT_REQUIRED
 
         pool = DummyConnectionPool.from_url("rediss://?ssl_check_hostname=False")
-        assert pool.get_connection("_").check_hostname is False
+        assert pool.get_connection().check_hostname is False
 
         pool = DummyConnectionPool.from_url("rediss://?ssl_check_hostname=True")
-        assert pool.get_connection("_").check_hostname is True
+        assert pool.get_connection().check_hostname is True
 
 
 class TestConnection:
@@ -756,7 +756,7 @@ async def test_health_check_not_invoked_within_interval(self, r):
 
     async def test_health_check_in_pipeline(self, r):
         async with r.pipeline(transaction=False) as pipe:
-            pipe.connection = await pipe.connection_pool.get_connection("_")
+            pipe.connection = await pipe.connection_pool.get_connection()
             pipe.connection.next_health_check = 0
             with mock.patch.object(
                 pipe.connection, "send_command", wraps=pipe.connection.send_command
@@ -767,7 +767,7 @@ async def test_health_check_in_pipeline(self, r):
 
     async def test_health_check_in_transaction(self, r):
         async with r.pipeline(transaction=True) as pipe:
-            pipe.connection = await pipe.connection_pool.get_connection("_")
+            pipe.connection = await pipe.connection_pool.get_connection()
             pipe.connection.next_health_check = 0
             with mock.patch.object(
                 pipe.connection, "send_command", wraps=pipe.connection.send_command
@@ -779,7 +779,7 @@ async def test_health_check_in_transaction(self, r):
     async def test_health_check_in_watched_pipeline(self, r):
         await r.set("foo", "bar")
         async with r.pipeline(transaction=False) as pipe:
-            pipe.connection = await pipe.connection_pool.get_connection("_")
+            pipe.connection = await pipe.connection_pool.get_connection()
             pipe.connection.next_health_check = 0
             with mock.patch.object(
                 pipe.connection, "send_command", wraps=pipe.connection.send_command
@@ -803,7 +803,7 @@ async def test_health_check_in_watched_pipeline(self, r):
     async def test_health_check_in_pubsub_before_subscribe(self, r):
         """A health check happens before the first [p]subscribe"""
         p = r.pubsub()
-        p.connection = await p.connection_pool.get_connection("_")
+        p.connection = await p.connection_pool.get_connection()
         p.connection.next_health_check = 0
         with mock.patch.object(
             p.connection, "send_command", wraps=p.connection.send_command
@@ -825,7 +825,7 @@ async def test_health_check_in_pubsub_after_subscribed(self, r):
         connection health
         """
         p = r.pubsub()
-        p.connection = await p.connection_pool.get_connection("_")
+        p.connection = await p.connection_pool.get_connection()
         p.connection.next_health_check = 0
         with mock.patch.object(
             p.connection, "send_command", wraps=p.connection.send_command
@@ -865,7 +865,7 @@ async def test_health_check_in_pubsub_poll(self, r):
         check the connection's health.
         """
         p = r.pubsub()
-        p.connection = await p.connection_pool.get_connection("_")
+        p.connection = await p.connection_pool.get_connection()
         with mock.patch.object(
             p.connection, "send_command", wraps=p.connection.send_command
         ) as m:
diff --git a/tests/test_asyncio/test_credentials.py b/tests/test_asyncio/test_credentials.py
index ca42d19090..1eb988ce71 100644
--- a/tests/test_asyncio/test_credentials.py
+++ b/tests/test_asyncio/test_credentials.py
@@ -274,7 +274,7 @@ async def test_change_username_password_on_existing_connection(
         await init_acl_user(r, username, password)
         r2 = await create_redis(flushdb=False, username=username, password=password)
         assert await r2.ping() is True
-        conn = await r2.connection_pool.get_connection("_")
+        conn = await r2.connection_pool.get_connection()
         await conn.send_command("PING")
         assert str_if_bytes(await conn.read_response()) == "PONG"
         assert conn.username == username
diff --git a/tests/test_asyncio/test_encoding.py b/tests/test_asyncio/test_encoding.py
index 162ccb367d..74a9f28b2d 100644
--- a/tests/test_asyncio/test_encoding.py
+++ b/tests/test_asyncio/test_encoding.py
@@ -74,7 +74,7 @@ class TestMemoryviewsAreNotPacked:
     async def test_memoryviews_are_not_packed(self, r):
         arg = memoryview(b"some_arg")
         arg_list = ["SOME_COMMAND", arg]
-        c = r.connection or await r.connection_pool.get_connection("_")
+        c = r.connection or await r.connection_pool.get_connection()
         cmd = c.pack_command(*arg_list)
         assert cmd[1] is arg
         cmds = c.pack_commands([arg_list, arg_list])
diff --git a/tests/test_asyncio/test_retry.py b/tests/test_asyncio/test_retry.py
index 8bc71c1479..cd251a986f 100644
--- a/tests/test_asyncio/test_retry.py
+++ b/tests/test_asyncio/test_retry.py
@@ -126,13 +126,13 @@ async def test_get_set_retry_object(self, request):
         assert r.get_retry()._retries == retry._retries
         assert isinstance(r.get_retry()._backoff, NoBackoff)
         new_retry_policy = Retry(ExponentialBackoff(), 3)
-        exiting_conn = await r.connection_pool.get_connection("_")
+        exiting_conn = await r.connection_pool.get_connection()
         r.set_retry(new_retry_policy)
         assert r.get_retry()._retries == new_retry_policy._retries
         assert isinstance(r.get_retry()._backoff, ExponentialBackoff)
         assert exiting_conn.retry._retries == new_retry_policy._retries
         await r.connection_pool.release(exiting_conn)
-        new_conn = await r.connection_pool.get_connection("_")
+        new_conn = await r.connection_pool.get_connection()
         assert new_conn.retry._retries == new_retry_policy._retries
         await r.connection_pool.release(new_conn)
         await r.aclose()
diff --git a/tests/test_asyncio/test_sentinel.py b/tests/test_asyncio/test_sentinel.py
index e553fdb00b..a27ba92bb8 100644
--- a/tests/test_asyncio/test_sentinel.py
+++ b/tests/test_asyncio/test_sentinel.py
@@ -269,7 +269,7 @@ async def mock_disconnect():
 @pytest.mark.onlynoncluster
 async def test_repr_correctly_represents_connection_object(sentinel):
     pool = SentinelConnectionPool("mymaster", sentinel)
-    connection = await pool.get_connection("PING")
+    connection = await pool.get_connection()
 
     assert (
         str(connection)
diff --git a/tests/test_cache.py b/tests/test_cache.py
index 67733dc9af..7010baff5f 100644
--- a/tests/test_cache.py
+++ b/tests/test_cache.py
@@ -159,7 +159,7 @@ def test_cache_clears_on_disconnect(self, r, cache):
             == b"bar"
         )
         # Force disconnection
-        r.connection_pool.get_connection("_").disconnect()
+        r.connection_pool.get_connection().disconnect()
         # Make sure cache is empty
         assert cache.size == 0
 
@@ -429,7 +429,7 @@ def test_cache_clears_on_disconnect(self, r, r2):
         # Force disconnection
         r.nodes_manager.get_node_from_slot(
             12000
-        ).redis_connection.connection_pool.get_connection("_").disconnect()
+        ).redis_connection.connection_pool.get_connection().disconnect()
         # Make sure cache is empty
         assert cache.size == 0
 
@@ -667,7 +667,7 @@ def test_cache_clears_on_disconnect(self, master, cache):
             == b"bar"
         )
         # Force disconnection
-        master.connection_pool.get_connection("_").disconnect()
+        master.connection_pool.get_connection().disconnect()
         # Make sure cache_data is empty
         assert cache.size == 0
 
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 1b9b9969c5..908ac26211 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -845,7 +845,7 @@ def test_cluster_get_set_retry_object(self, request):
             assert node.redis_connection.get_retry()._retries == retry._retries
             assert isinstance(node.redis_connection.get_retry()._backoff, NoBackoff)
         rand_node = r.get_random_node()
-        existing_conn = rand_node.redis_connection.connection_pool.get_connection("_")
+        existing_conn = rand_node.redis_connection.connection_pool.get_connection()
         # Change retry policy
         new_retry = Retry(ExponentialBackoff(), 3)
         r.set_retry(new_retry)
@@ -857,7 +857,7 @@ def test_cluster_get_set_retry_object(self, request):
                 node.redis_connection.get_retry()._backoff, ExponentialBackoff
             )
         assert existing_conn.retry._retries == new_retry._retries
-        new_conn = rand_node.redis_connection.connection_pool.get_connection("_")
+        new_conn = rand_node.redis_connection.connection_pool.get_connection()
         assert new_conn.retry._retries == new_retry._retries
 
     def test_cluster_retry_object(self, r) -> None:
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 118294ee1b..387a0f4565 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -54,7 +54,7 @@ def test_connection_creation(self):
         pool = self.get_pool(
             connection_kwargs=connection_kwargs, connection_class=DummyConnection
         )
-        connection = pool.get_connection("_")
+        connection = pool.get_connection()
         assert isinstance(connection, DummyConnection)
         assert connection.kwargs == connection_kwargs
 
@@ -71,24 +71,24 @@ def test_closing(self):
     def test_multiple_connections(self, master_host):
         connection_kwargs = {"host": master_host[0], "port": master_host[1]}
         pool = self.get_pool(connection_kwargs=connection_kwargs)
-        c1 = pool.get_connection("_")
-        c2 = pool.get_connection("_")
+        c1 = pool.get_connection()
+        c2 = pool.get_connection()
         assert c1 != c2
 
     def test_max_connections(self, master_host):
         connection_kwargs = {"host": master_host[0], "port": master_host[1]}
         pool = self.get_pool(max_connections=2, connection_kwargs=connection_kwargs)
-        pool.get_connection("_")
-        pool.get_connection("_")
+        pool.get_connection()
+        pool.get_connection()
         with pytest.raises(redis.ConnectionError):
-            pool.get_connection("_")
+            pool.get_connection()
 
     def test_reuse_previously_released_connection(self, master_host):
         connection_kwargs = {"host": master_host[0], "port": master_host[1]}
         pool = self.get_pool(connection_kwargs=connection_kwargs)
-        c1 = pool.get_connection("_")
+        c1 = pool.get_connection()
         pool.release(c1)
-        c2 = pool.get_connection("_")
+        c2 = pool.get_connection()
         assert c1 == c2
 
     def test_repr_contains_db_info_tcp(self):
@@ -133,15 +133,15 @@ def test_connection_creation(self, master_host):
             "port": master_host[1],
         }
         pool = self.get_pool(connection_kwargs=connection_kwargs)
-        connection = pool.get_connection("_")
+        connection = pool.get_connection()
         assert isinstance(connection, DummyConnection)
         assert connection.kwargs == connection_kwargs
 
     def test_multiple_connections(self, master_host):
         connection_kwargs = {"host": master_host[0], "port": master_host[1]}
         pool = self.get_pool(connection_kwargs=connection_kwargs)
-        c1 = pool.get_connection("_")
-        c2 = pool.get_connection("_")
+        c1 = pool.get_connection()
+        c2 = pool.get_connection()
         assert c1 != c2
 
     def test_connection_pool_blocks_until_timeout(self, master_host):
@@ -150,11 +150,11 @@ def test_connection_pool_blocks_until_timeout(self, master_host):
         pool = self.get_pool(
             max_connections=1, timeout=0.1, connection_kwargs=connection_kwargs
         )
-        pool.get_connection("_")
+        pool.get_connection()
 
         start = time.time()
         with pytest.raises(redis.ConnectionError):
-            pool.get_connection("_")
+            pool.get_connection()
         # we should have waited at least 0.1 seconds
         assert time.time() - start >= 0.1
 
@@ -167,7 +167,7 @@ def test_connection_pool_blocks_until_conn_available(self, master_host):
         pool = self.get_pool(
             max_connections=1, timeout=2, connection_kwargs=connection_kwargs
         )
-        c1 = pool.get_connection("_")
+        c1 = pool.get_connection()
 
         def target():
             time.sleep(0.1)
@@ -175,15 +175,15 @@ def target():
 
         start = time.time()
         Thread(target=target).start()
-        pool.get_connection("_")
+        pool.get_connection()
         assert time.time() - start >= 0.1
 
     def test_reuse_previously_released_connection(self, master_host):
         connection_kwargs = {"host": master_host[0], "port": master_host[1]}
         pool = self.get_pool(connection_kwargs=connection_kwargs)
-        c1 = pool.get_connection("_")
+        c1 = pool.get_connection()
         pool.release(c1)
-        c2 = pool.get_connection("_")
+        c2 = pool.get_connection()
         assert c1 == c2
 
     def test_repr_contains_db_info_tcp(self):
@@ -214,7 +214,7 @@ def test_initialise_pool_with_cache(self, master_host):
             protocol=3,
             cache_config=CacheConfig(),
         )
-        assert isinstance(pool.get_connection("_"), CacheProxyConnection)
+        assert isinstance(pool.get_connection(), CacheProxyConnection)
 
 
 class TestConnectionPoolURLParsing:
@@ -489,23 +489,23 @@ def test_cert_reqs_options(self):
         import ssl
 
         class DummyConnectionPool(redis.ConnectionPool):
-            def get_connection(self, *args, **kwargs):
+            def get_connection(self):
                 return self.make_connection()
 
         pool = DummyConnectionPool.from_url("rediss://?ssl_cert_reqs=none")
-        assert pool.get_connection("_").cert_reqs == ssl.CERT_NONE
+        assert pool.get_connection().cert_reqs == ssl.CERT_NONE
 
         pool = DummyConnectionPool.from_url("rediss://?ssl_cert_reqs=optional")
-        assert pool.get_connection("_").cert_reqs == ssl.CERT_OPTIONAL
+        assert pool.get_connection().cert_reqs == ssl.CERT_OPTIONAL
 
         pool = DummyConnectionPool.from_url("rediss://?ssl_cert_reqs=required")
-        assert pool.get_connection("_").cert_reqs == ssl.CERT_REQUIRED
+        assert pool.get_connection().cert_reqs == ssl.CERT_REQUIRED
 
         pool = DummyConnectionPool.from_url("rediss://?ssl_check_hostname=False")
-        assert pool.get_connection("_").check_hostname is False
+        assert pool.get_connection().check_hostname is False
 
         pool = DummyConnectionPool.from_url("rediss://?ssl_check_hostname=True")
-        assert pool.get_connection("_").check_hostname is True
+        assert pool.get_connection().check_hostname is True
 
 
 class TestConnection:
@@ -701,7 +701,7 @@ def test_health_check_not_invoked_within_interval(self, r):
 
     def test_health_check_in_pipeline(self, r):
         with r.pipeline(transaction=False) as pipe:
-            pipe.connection = pipe.connection_pool.get_connection("_")
+            pipe.connection = pipe.connection_pool.get_connection()
             pipe.connection.next_health_check = 0
             with mock.patch.object(
                 pipe.connection, "send_command", wraps=pipe.connection.send_command
@@ -712,7 +712,7 @@ def test_health_check_in_pipeline(self, r):
 
     def test_health_check_in_transaction(self, r):
         with r.pipeline(transaction=True) as pipe:
-            pipe.connection = pipe.connection_pool.get_connection("_")
+            pipe.connection = pipe.connection_pool.get_connection()
             pipe.connection.next_health_check = 0
             with mock.patch.object(
                 pipe.connection, "send_command", wraps=pipe.connection.send_command
@@ -724,7 +724,7 @@ def test_health_check_in_transaction(self, r):
     def test_health_check_in_watched_pipeline(self, r):
         r.set("foo", "bar")
         with r.pipeline(transaction=False) as pipe:
-            pipe.connection = pipe.connection_pool.get_connection("_")
+            pipe.connection = pipe.connection_pool.get_connection()
             pipe.connection.next_health_check = 0
             with mock.patch.object(
                 pipe.connection, "send_command", wraps=pipe.connection.send_command
@@ -748,7 +748,7 @@ def test_health_check_in_watched_pipeline(self, r):
     def test_health_check_in_pubsub_before_subscribe(self, r):
         "A health check happens before the first [p]subscribe"
         p = r.pubsub()
-        p.connection = p.connection_pool.get_connection("_")
+        p.connection = p.connection_pool.get_connection()
         p.connection.next_health_check = 0
         with mock.patch.object(
             p.connection, "send_command", wraps=p.connection.send_command
@@ -770,7 +770,7 @@ def test_health_check_in_pubsub_after_subscribed(self, r):
         connection health
         """
         p = r.pubsub()
-        p.connection = p.connection_pool.get_connection("_")
+        p.connection = p.connection_pool.get_connection()
         p.connection.next_health_check = 0
         with mock.patch.object(
             p.connection, "send_command", wraps=p.connection.send_command
@@ -810,7 +810,7 @@ def test_health_check_in_pubsub_poll(self, r):
         check the connection's health.
         """
         p = r.pubsub()
-        p.connection = p.connection_pool.get_connection("_")
+        p.connection = p.connection_pool.get_connection()
         with mock.patch.object(
             p.connection, "send_command", wraps=p.connection.send_command
         ) as m:
diff --git a/tests/test_credentials.py b/tests/test_credentials.py
index b0b79d305f..95ec5577cc 100644
--- a/tests/test_credentials.py
+++ b/tests/test_credentials.py
@@ -252,7 +252,7 @@ def teardown():
             redis.Redis, request, flushdb=False, username=username, password=password
         )
         assert r2.ping() is True
-        conn = r2.connection_pool.get_connection("_")
+        conn = r2.connection_pool.get_connection()
         conn.send_command("PING")
         assert str_if_bytes(conn.read_response()) == "PONG"
         assert conn.username == username
diff --git a/tests/test_multiprocessing.py b/tests/test_multiprocessing.py
index 116d20dab0..0e8e8958c5 100644
--- a/tests/test_multiprocessing.py
+++ b/tests/test_multiprocessing.py
@@ -95,7 +95,7 @@ def test_pool(self, max_connections, master_host):
             max_connections=max_connections,
         )
 
-        conn = pool.get_connection("ping")
+        conn = pool.get_connection()
         main_conn_pid = conn.pid
         with exit_callback(pool.release, conn):
             conn.send_command("ping")
@@ -103,7 +103,7 @@ def test_pool(self, max_connections, master_host):
 
         def target(pool):
             with exit_callback(pool.disconnect):
-                conn = pool.get_connection("ping")
+                conn = pool.get_connection()
                 assert conn.pid != main_conn_pid
                 with exit_callback(pool.release, conn):
                     assert conn.send_command("ping") is None
@@ -116,7 +116,7 @@ def target(pool):
 
         # Check that connection is still alive after fork process has exited
         # and disconnected the connections in its pool
-        conn = pool.get_connection("ping")
+        conn = pool.get_connection()
         with exit_callback(pool.release, conn):
             assert conn.send_command("ping") is None
             assert conn.read_response() == b"PONG"
@@ -132,12 +132,12 @@ def test_close_pool_in_main(self, max_connections, master_host):
             max_connections=max_connections,
         )
 
-        conn = pool.get_connection("ping")
+        conn = pool.get_connection()
         assert conn.send_command("ping") is None
         assert conn.read_response() == b"PONG"
 
         def target(pool, disconnect_event):
-            conn = pool.get_connection("ping")
+            conn = pool.get_connection()
             with exit_callback(pool.release, conn):
                 assert conn.send_command("ping") is None
                 assert conn.read_response() == b"PONG"
diff --git a/tests/test_retry.py b/tests/test_retry.py
index 183807386d..e1e4c414a4 100644
--- a/tests/test_retry.py
+++ b/tests/test_retry.py
@@ -206,7 +206,7 @@ def test_client_retry_on_timeout(self, request):
     def test_get_set_retry_object(self, request):
         retry = Retry(NoBackoff(), 2)
         r = _get_client(Redis, request, retry_on_timeout=True, retry=retry)
-        exist_conn = r.connection_pool.get_connection("_")
+        exist_conn = r.connection_pool.get_connection()
         assert r.get_retry()._retries == retry._retries
         assert isinstance(r.get_retry()._backoff, NoBackoff)
         new_retry_policy = Retry(ExponentialBackoff(), 3)
@@ -214,5 +214,5 @@ def test_get_set_retry_object(self, request):
         assert r.get_retry()._retries == new_retry_policy._retries
         assert isinstance(r.get_retry()._backoff, ExponentialBackoff)
         assert exist_conn.retry._retries == new_retry_policy._retries
-        new_conn = r.connection_pool.get_connection("_")
+        new_conn = r.connection_pool.get_connection()
         assert new_conn.retry._retries == new_retry_policy._retries
diff --git a/tests/test_sentinel.py b/tests/test_sentinel.py
index 54b9647098..93455f3290 100644
--- a/tests/test_sentinel.py
+++ b/tests/test_sentinel.py
@@ -101,7 +101,7 @@ def test_discover_master_error(sentinel):
 @pytest.mark.onlynoncluster
 def test_dead_pool(sentinel):
     master = sentinel.master_for("mymaster", db=9)
-    conn = master.connection_pool.get_connection("_")
+    conn = master.connection_pool.get_connection()
     conn.disconnect()
     del master
     conn.connect()

From 75cac318d5772436c38f672980519f920dd5d71c Mon Sep 17 00:00:00 2001
From: Sviatoslav Abakumov <dust.harvesting@gmail.com>
Date: Fri, 21 Feb 2025 21:56:45 +0400
Subject: [PATCH 0980/1164] Type hint Lock.extend's additional_time as a Number
 (#3522)

It must be possible for the function to receive floats, as the docstring
and the code suggest.
---
 redis/lock.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/redis/lock.py b/redis/lock.py
index cae7f27ea1..f44ed629da 100644
--- a/redis/lock.py
+++ b/redis/lock.py
@@ -264,7 +264,7 @@ def do_release(self, expected_token: str) -> None:
                 lock_name=self.name,
             )
 
-    def extend(self, additional_time: int, replace_ttl: bool = False) -> bool:
+    def extend(self, additional_time: Number, replace_ttl: bool = False) -> bool:
         """
         Adds more time to an already acquired lock.
 
@@ -281,7 +281,7 @@ def extend(self, additional_time: int, replace_ttl: bool = False) -> bool:
             raise LockError("Cannot extend a lock with no timeout", lock_name=self.name)
         return self.do_extend(additional_time, replace_ttl)
 
-    def do_extend(self, additional_time: int, replace_ttl: bool) -> bool:
+    def do_extend(self, additional_time: Number, replace_ttl: bool) -> bool:
         additional_time = int(additional_time * 1000)
         if not bool(
             self.lua_extend(

From d8676605ef05c786bb705257467a83f963cd1d04 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Mon, 24 Feb 2025 17:33:56 +0200
Subject: [PATCH 0981/1164] Remove decreasing of created connections count when
 releasing not owned by connection pool connection(fixes issue #2832). (#3514)

* Removing decreasing of created connections count when releasing not owned by connection pool connection(#2832).

* Fixed another issue that was allowing adding connections to a pool owned by other pools. Adding unit tests.

* Fixing a typo in a comment
---
 redis/connection.py           | 10 +++++-----
 tests/test_connection_pool.py | 15 +++++++++++++++
 tests/test_multiprocessing.py | 34 ++++++++++++++++++++++++++++++++++
 3 files changed, 54 insertions(+), 5 deletions(-)

diff --git a/redis/connection.py b/redis/connection.py
index d59a9b069b..ece17d752b 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1532,7 +1532,7 @@ def release(self, connection: "Connection") -> None:
             except KeyError:
                 # Gracefully fail when a connection is returned to this pool
                 # that the pool doesn't actually own
-                pass
+                return
 
             if self.owns_connection(connection):
                 self._available_connections.append(connection)
@@ -1540,10 +1540,10 @@ def release(self, connection: "Connection") -> None:
                     AfterConnectionReleasedEvent(connection)
                 )
             else:
-                # pool doesn't own this connection. do not add it back
-                # to the pool and decrement the count so that another
-                # connection can take its place if needed
-                self._created_connections -= 1
+                # Pool doesn't own this connection, do not add it back
+                # to the pool.
+                # The created connections count should not be changed,
+                # because the connection was not created by the pool.
                 connection.disconnect()
                 return
 
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 387a0f4565..65f42923fe 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -91,6 +91,21 @@ def test_reuse_previously_released_connection(self, master_host):
         c2 = pool.get_connection()
         assert c1 == c2
 
+    def test_release_not_owned_connection(self, master_host):
+        connection_kwargs = {"host": master_host[0], "port": master_host[1]}
+        pool1 = self.get_pool(connection_kwargs=connection_kwargs)
+        c1 = pool1.get_connection("_")
+        pool2 = self.get_pool(
+            connection_kwargs={"host": master_host[0], "port": master_host[1]}
+        )
+        c2 = pool2.get_connection("_")
+        pool2.release(c2)
+
+        assert len(pool2._available_connections) == 1
+
+        pool2.release(c1)
+        assert len(pool2._available_connections) == 1
+
     def test_repr_contains_db_info_tcp(self):
         connection_kwargs = {
             "host": "localhost",
diff --git a/tests/test_multiprocessing.py b/tests/test_multiprocessing.py
index 0e8e8958c5..8b9e9fb90b 100644
--- a/tests/test_multiprocessing.py
+++ b/tests/test_multiprocessing.py
@@ -84,6 +84,40 @@ def target(conn, ev):
         proc.join(3)
         assert proc.exitcode == 0
 
+    @pytest.mark.parametrize("max_connections", [2, None])
+    def test_release_parent_connection_from_pool_in_child_process(
+        self, max_connections, master_host
+    ):
+        """
+        A connection owned by a parent should not decrease the _created_connections
+        counter in child when released - when the child process starts to use the
+        pool it resets all the counters that have been set in the parent process.
+        """
+
+        pool = ConnectionPool.from_url(
+            f"redis://{master_host[0]}:{master_host[1]}",
+            max_connections=max_connections,
+        )
+
+        parent_conn = pool.get_connection("ping")
+
+        def target(pool, parent_conn):
+            with exit_callback(pool.disconnect):
+                child_conn = pool.get_connection("ping")
+                assert child_conn.pid != parent_conn.pid
+                pool.release(child_conn)
+                assert pool._created_connections == 1
+                assert child_conn in pool._available_connections
+                pool.release(parent_conn)
+                assert pool._created_connections == 1
+                assert child_conn in pool._available_connections
+                assert parent_conn not in pool._available_connections
+
+        proc = multiprocessing.Process(target=target, args=(pool, parent_conn))
+        proc.start()
+        proc.join(3)
+        assert proc.exitcode == 0
+
     @pytest.mark.parametrize("max_connections", [1, 2, None])
     def test_pool(self, max_connections, master_host):
         """

From 483c021e88657ec045754537c3be3efc4d3a202c Mon Sep 17 00:00:00 2001
From: Aarni Koskela <akx@iki.fi>
Date: Tue, 25 Feb 2025 12:58:12 +0200
Subject: [PATCH 0982/1164] Switch to PEP 517 packaging using hatchling (#2930)

* Switch to PEP 517 packaging using hatchling

Refs #1316
Refs #1649
Remake of #2388

Co-authored-by: Ofek Lev <ofekmeister@gmail.com>

* Use a single source of truth for version info

* Uninstall redis wheel installed as redis-entraid dep

* Add build as dev_requirement

* Get rid of requirements.txt

* Get rid of setuptools and wheel deps

* Move pytest configuration to pyproject.toml

* Retain tests and dev_requirements.txt in sdist

---------

Co-authored-by: Ofek Lev <ofekmeister@gmail.com>
---
 .github/actions/run-tests/action.yml  |  4 +-
 .github/workflows/docs.yaml           |  2 +-
 .github/workflows/install_and_test.sh |  1 +
 .github/workflows/integration.yaml    |  3 +-
 .github/workflows/pypi-publish.yaml   |  9 +--
 CONTRIBUTING.md                       |  2 +-
 INSTALL                               |  6 --
 MANIFEST.in                           |  8 ---
 dev_requirements.txt                  |  2 +-
 docs/examples/opentelemetry/README.md |  2 +-
 pyproject.toml                        | 96 +++++++++++++++++++++++++++
 pytest.ini                            | 20 ------
 redis/__init__.py                     | 13 +---
 requirements.txt                      |  2 -
 setup.py                              | 65 ------------------
 tasks.py                              |  2 +-
 16 files changed, 110 insertions(+), 127 deletions(-)
 delete mode 100644 INSTALL
 delete mode 100644 MANIFEST.in
 create mode 100644 pyproject.toml
 delete mode 100644 pytest.ini
 delete mode 100644 requirements.txt
 delete mode 100644 setup.py

diff --git a/.github/actions/run-tests/action.yml b/.github/actions/run-tests/action.yml
index ca775f5a5b..d822e1d499 100644
--- a/.github/actions/run-tests/action.yml
+++ b/.github/actions/run-tests/action.yml
@@ -36,9 +36,9 @@ runs:
         set -e
                 
         echo "::group::Installing dependencies"
-        pip install -U setuptools wheel
-        pip install -r requirements.txt
         pip install -r dev_requirements.txt
+        pip uninstall -y redis  # uninstall Redis package installed via redis-entraid
+        pip install -e .  # install the working copy
         if [ "${{inputs.parser-backend}}" == "hiredis" ]; then
           pip install "hiredis${{inputs.hiredis-version}}"
           echo "PARSER_BACKEND=$(echo "${{inputs.parser-backend}}_${{inputs.hiredis-version}}" | sed 's/[^a-zA-Z0-9]/_/g')" >> $GITHUB_ENV        
diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml
index a3512b46dc..747b3b6d76 100644
--- a/.github/workflows/docs.yaml
+++ b/.github/workflows/docs.yaml
@@ -36,7 +36,7 @@ jobs:
            sudo apt-get install -yqq pandoc make
        - name: run code linters
          run: |
-           pip install -r requirements.txt -r dev_requirements.txt -r docs/requirements.txt
+           pip install -r dev_requirements.txt -r docs/requirements.txt
            invoke build-docs
 
        - name: upload docs
diff --git a/.github/workflows/install_and_test.sh b/.github/workflows/install_and_test.sh
index 5c879c1b3a..778dbe0b20 100755
--- a/.github/workflows/install_and_test.sh
+++ b/.github/workflows/install_and_test.sh
@@ -21,6 +21,7 @@ python -m venv ${DESTENV}
 source ${DESTENV}/bin/activate
 pip install --upgrade --quiet pip
 pip install --quiet -r dev_requirements.txt
+pip uninstall -y redis  # uninstall Redis package installed via redis-entraid
 invoke devenv --endpoints=all-stack
 invoke package
 
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 45e0d5bf8e..bb56e8a024 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -38,7 +38,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: pypa/gh-action-pip-audit@v1.0.8
         with:
-          inputs: requirements.txt dev_requirements.txt
+          inputs: dev_requirements.txt
           ignore-vulns: |
             GHSA-w596-4wvx-j9j6  # subversion related git pull, dependency for pytest. There is no impact here.
 
@@ -54,6 +54,7 @@ jobs:
       - name: run code linters
         run: |
           pip install -r dev_requirements.txt
+          pip uninstall -y redis  # uninstall Redis package installed via redis-entraid
           invoke linters
 
   redis_version:
diff --git a/.github/workflows/pypi-publish.yaml b/.github/workflows/pypi-publish.yaml
index e4815aa1b5..048d06c53c 100644
--- a/.github/workflows/pypi-publish.yaml
+++ b/.github/workflows/pypi-publish.yaml
@@ -18,15 +18,10 @@ jobs:
         uses: actions/setup-python@v5
         with:
           python-version: 3.9
-      - name: Install dev tools
-        run: |
-          pip install -r dev_requirements.txt
-          pip install twine wheel
+      - run: pip install build twine
 
       - name: Build package
-        run: |
-          python setup.py build
-          python setup.py sdist bdist_wheel
+        run: python -m build .
 
       - name: Basic package test prior to upload
         run: |
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index d87e6ba1c3..79983e4cb5 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -38,7 +38,7 @@ Here's how to get started with your code contribution:
         a.  python -m venv .venv
         b.  source .venv/bin/activate
         c.  pip install -r dev_requirements.txt
-        c.  pip install -r requirements.txt
+        c.  pip install -e .
 
 4.  If you need a development environment, run `invoke devenv`. Note: this relies on docker-compose to build environments, and assumes that you have a version supporting [docker profiles](https://docs.docker.com/compose/profiles/).
 5.  While developing, make sure the tests pass by running `invoke tests`
diff --git a/INSTALL b/INSTALL
deleted file mode 100644
index 951f7dea8a..0000000000
--- a/INSTALL
+++ /dev/null
@@ -1,6 +0,0 @@
-
-Please use
- python setup.py install
-
-and report errors to Andy McCurdy (sedrik@gmail.com)
-
diff --git a/MANIFEST.in b/MANIFEST.in
deleted file mode 100644
index 80afb437ff..0000000000
--- a/MANIFEST.in
+++ /dev/null
@@ -1,8 +0,0 @@
-include INSTALL
-include LICENSE
-include README.md
-include dev_requirements.txt
-include pytest.ini
-exclude __pycache__
-recursive-include tests *
-recursive-exclude tests *.pyc
diff --git a/dev_requirements.txt b/dev_requirements.txt
index 619fbf479c..7ee7ac2b75 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -1,3 +1,4 @@
+build
 black==24.3.0
 click==8.0.4
 flake8-isort
@@ -14,6 +15,5 @@ pytest-timeout
 ujson>=4.2.0
 uvloop
 vulture>=2.3.0
-wheel>=0.30.0
 numpy>=1.24.0
 redis-entraid==0.3.0b1
diff --git a/docs/examples/opentelemetry/README.md b/docs/examples/opentelemetry/README.md
index a1d1c04eda..58085c9637 100644
--- a/docs/examples/opentelemetry/README.md
+++ b/docs/examples/opentelemetry/README.md
@@ -24,7 +24,7 @@ source .venv/bin/active
 **Step 3**. Install dependencies:
 
 ```shell
-pip install -r requirements.txt
+pip install -e .
 ```
 
 **Step 4**. Start the services using Docker and make sure Uptrace is running:
diff --git a/pyproject.toml b/pyproject.toml
new file mode 100644
index 0000000000..7becde948e
--- /dev/null
+++ b/pyproject.toml
@@ -0,0 +1,96 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "redis"
+dynamic = ["version"]
+description = "Python client for Redis database and key-value store"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+authors = [
+    { name = "Redis Inc.", email = "oss@redis.com" },
+]
+keywords = [
+    "Redis",
+    "database",
+    "key-value-store",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Python :: Implementation :: PyPy",
+]
+dependencies = [
+    'async-timeout>=4.0.3; python_full_version<"3.11.3"',
+    "PyJWT~=2.9.0",
+]
+
+[project.optional-dependencies]
+hiredis = [
+    "hiredis>=3.0.0",
+]
+ocsp = [
+    "cryptography>=36.0.1",
+    "pyopenssl==20.0.1",
+    "requests>=2.31.0",
+]
+
+[project.urls]
+Changes = "https://github.com/redis/redis-py/releases"
+Code = "https://github.com/redis/redis-py"
+Documentation = "https://redis.readthedocs.io/en/latest/"
+Homepage = "https://github.com/redis/redis-py"
+"Issue tracker" = "https://github.com/redis/redis-py/issues"
+
+[tool.hatch.version]
+path = "redis/__init__.py"
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/redis",
+    "/tests",
+    "dev_requirements.txt",
+]
+
+[tool.hatch.build.targets.wheel]
+include = [
+    "/redis",
+]
+
+[tool.pytest.ini_options]
+addopts = "-s"
+markers = [
+    "redismod: run only the redis module tests",
+    "graph: run only the redisgraph tests",
+    "pipeline: pipeline tests",
+    "onlycluster: marks tests to be run only with cluster mode redis",
+    "onlynoncluster: marks tests to be run only with standalone redis",
+    "ssl: marker for only the ssl tests",
+    "asyncio: marker for async tests",
+    "replica: replica tests",
+    "experimental: run only experimental tests",
+    "cp_integration: credential provider integration tests",
+]
+asyncio_mode = "auto"
+timeout = 30
+filterwarnings = [
+    "always",
+    "ignore:RedisGraph support is deprecated as of Redis Stack 7.2:DeprecationWarning",
+    # Ignore a coverage warning when COVERAGE_CORE=sysmon for Pythons < 3.12.
+    "ignore:sys.monitoring isn't available:coverage.exceptions.CoverageWarning",
+]
diff --git a/pytest.ini b/pytest.ini
deleted file mode 100644
index 68fee2b603..0000000000
--- a/pytest.ini
+++ /dev/null
@@ -1,20 +0,0 @@
-[pytest]
-addopts = -s
-markers =
-    redismod: run only the redis module tests
-    graph: run only the redisgraph tests
-    pipeline: pipeline tests
-    onlycluster: marks tests to be run only with cluster mode redis
-    onlynoncluster: marks tests to be run only with standalone redis
-    ssl: marker for only the ssl tests
-    asyncio: marker for async tests
-    replica: replica tests
-    experimental: run only experimental tests
-    cp_integration: credential provider integration tests
-asyncio_mode = auto
-timeout = 30
-filterwarnings =
-    always
-    ignore:RedisGraph support is deprecated as of Redis Stack 7.2:DeprecationWarning
-    # Ignore a coverage warning when COVERAGE_CORE=sysmon for Pythons < 3.12.
-    ignore:sys.monitoring isn't available:coverage.exceptions.CoverageWarning
diff --git a/redis/__init__.py b/redis/__init__.py
index 94324a0de8..f82a876b2d 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -1,5 +1,3 @@
-from importlib import metadata
-
 from redis import asyncio  # noqa
 from redis.backoff import default_backoff
 from redis.client import Redis, StrictRedis
@@ -44,16 +42,9 @@ def int_or_str(value):
         return value
 
 
-try:
-    __version__ = metadata.version("redis")
-except metadata.PackageNotFoundError:
-    __version__ = "99.99.99"
-
+__version__ = "5.2.1"
+VERSION = tuple(map(int_or_str, __version__.split(".")))
 
-try:
-    VERSION = tuple(map(int_or_str, __version__.split(".")))
-except AttributeError:
-    VERSION = tuple([99, 99, 99])
 
 __all__ = [
     "AuthenticationError",
diff --git a/requirements.txt b/requirements.txt
deleted file mode 100644
index 9760e5bb13..0000000000
--- a/requirements.txt
+++ /dev/null
@@ -1,2 +0,0 @@
-async-timeout>=4.0.3
-PyJWT~=2.9.0
\ No newline at end of file
diff --git a/setup.py b/setup.py
deleted file mode 100644
index 2cde3fb51b..0000000000
--- a/setup.py
+++ /dev/null
@@ -1,65 +0,0 @@
-#!/usr/bin/env python
-from setuptools import find_packages, setup
-
-setup(
-    name="redis",
-    description="Python client for Redis database and key-value store",
-    long_description=open("README.md").read().strip(),
-    long_description_content_type="text/markdown",
-    keywords=["Redis", "key-value store", "database"],
-    license="MIT",
-    version="5.2.1",
-    packages=find_packages(
-        include=[
-            "redis",
-            "redis._parsers",
-            "redis.asyncio",
-            "redis.auth",
-            "redis.commands",
-            "redis.commands.bf",
-            "redis.commands.json",
-            "redis.commands.search",
-            "redis.commands.timeseries",
-            "redis.commands.graph",
-            "redis.parsers",
-        ]
-    ),
-    package_data={"redis": ["py.typed"]},
-    include_package_data=True,
-    url="https://github.com/redis/redis-py",
-    project_urls={
-        "Documentation": "https://redis.readthedocs.io/en/latest/",
-        "Changes": "https://github.com/redis/redis-py/releases",
-        "Code": "https://github.com/redis/redis-py",
-        "Issue tracker": "https://github.com/redis/redis-py/issues",
-    },
-    author="Redis Inc.",
-    author_email="oss@redis.com",
-    python_requires=">=3.8",
-    install_requires=[
-        'async-timeout>=4.0.3; python_full_version<"3.11.3"',
-        "PyJWT~=2.9.0",
-    ],
-    classifiers=[
-        "Development Status :: 5 - Production/Stable",
-        "Environment :: Console",
-        "Intended Audience :: Developers",
-        "License :: OSI Approved :: MIT License",
-        "Operating System :: OS Independent",
-        "Programming Language :: Python",
-        "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3 :: Only",
-        "Programming Language :: Python :: 3.8",
-        "Programming Language :: Python :: 3.9",
-        "Programming Language :: Python :: 3.10",
-        "Programming Language :: Python :: 3.11",
-        "Programming Language :: Python :: 3.12",
-        "Programming Language :: Python :: 3.13",
-        "Programming Language :: Python :: Implementation :: CPython",
-        "Programming Language :: Python :: Implementation :: PyPy",
-    ],
-    extras_require={
-        "hiredis": ["hiredis>=3.0.0"],
-        "ocsp": ["cryptography>=36.0.1", "pyopenssl==23.2.1", "requests>=2.31.0"],
-    },
-)
diff --git a/tasks.py b/tasks.py
index f7b728aed4..8a5cae97b2 100644
--- a/tasks.py
+++ b/tasks.py
@@ -97,4 +97,4 @@ def clean(c):
 @task
 def package(c):
     """Create the python packages"""
-    run("python setup.py sdist bdist_wheel")
+    run("python -m build .")

From 4418907950c31c09ccc04793b6e63ce0a95e47c6 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 25 Feb 2025 14:55:05 +0200
Subject: [PATCH 0983/1164] Removing the requirements.txt from docs building
 dependencies (#3527)

---
 .readthedocs.yml          | 1 -
 doctests/README.md        | 4 ++--
 doctests/requirements.txt | 1 +
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.readthedocs.yml b/.readthedocs.yml
index 800cb14816..80b9738d82 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -3,7 +3,6 @@ version: 2
 python:
   install:
     - requirements: ./docs/requirements.txt
-    - requirements: requirements.txt
 
 build:
   os: ubuntu-20.04
diff --git a/doctests/README.md b/doctests/README.md
index 9dd6eaeb5d..15664f1bcd 100644
--- a/doctests/README.md
+++ b/doctests/README.md
@@ -13,11 +13,11 @@ See https://github.com/redis-stack/redis-stack-website#readme for more details.
 ## How to test examples
 
 Examples are standalone python scripts, committed to the *doctests* directory. These scripts assume that the
-```requirements.txt``` and ```dev_requirements.txt``` from this repository have been installed, as per below.
+```doctests/requirements.txt``` and ```dev_requirements.txt``` from this repository have been installed, as per below.
 
 ```bash
-pip install -r requirements.txt
 pip install -r dev_requirements.txt
+pip uninstall -y redis  # uninstall Redis package installed via redis-entraid
 pip install -r doctests/requirements.txt
 ```
 
diff --git a/doctests/requirements.txt b/doctests/requirements.txt
index 209d87b9c8..1f239546c1 100644
--- a/doctests/requirements.txt
+++ b/doctests/requirements.txt
@@ -3,3 +3,4 @@ pandas
 requests
 sentence_transformers
 tabulate
+redis #install latest stable version

From cf2341f56ce26e2118f2faa25f9d3f51a1d80681 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 25 Feb 2025 17:06:09 +0200
Subject: [PATCH 0984/1164] Installing redis and its mandatory dependencies
 when building readthedocs (#3528)

---
 .readthedocs.yml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/.readthedocs.yml b/.readthedocs.yml
index 80b9738d82..4b22490a49 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -2,7 +2,10 @@ version: 2
 
 python:
   install:
-    - requirements: ./docs/requirements.txt
+    - method: pip
+      path: .
+    - method: pip
+      requirements: ./docs/requirements.txt
 
 build:
   os: ubuntu-20.04

From ac3112d9e50ad485abe397ff48820db6f1ca1c0b Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 25 Feb 2025 19:01:03 +0200
Subject: [PATCH 0985/1164] Adding vector search tests for types int8/uint8
 (#3525)

---
 tests/test_search.py | 58 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 58 insertions(+)

diff --git a/tests/test_search.py b/tests/test_search.py
index 5b45cfc0a3..c4598f3773 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -2856,6 +2856,64 @@ def test_vector_search_with_default_dialect(client):
         assert res["total_results"] == 2
 
 
+@pytest.mark.redismod
+@skip_if_server_version_lt("7.9.0")
+def test_vector_search_with_int8_type(client):
+    client.ft().create_index(
+        (VectorField("v", "FLAT", {"TYPE": "INT8", "DIM": 2, "DISTANCE_METRIC": "L2"}),)
+    )
+
+    a = [1.5, 10]
+    b = [123, 100]
+    c = [1, 1]
+
+    client.hset("a", "v", np.array(a, dtype=np.int8).tobytes())
+    client.hset("b", "v", np.array(b, dtype=np.int8).tobytes())
+    client.hset("c", "v", np.array(c, dtype=np.int8).tobytes())
+
+    query = Query("*=>[KNN 2 @v $vec as score]")
+    query_params = {"vec": np.array(a, dtype=np.int8).tobytes()}
+
+    assert 2 in query.get_args()
+
+    res = client.ft().search(query, query_params=query_params)
+    if is_resp2_connection(client):
+        assert res.total == 2
+    else:
+        assert res["total_results"] == 2
+
+
+@pytest.mark.redismod
+@skip_if_server_version_lt("7.9.0")
+def test_vector_search_with_uint8_type(client):
+    client.ft().create_index(
+        (
+            VectorField(
+                "v", "FLAT", {"TYPE": "UINT8", "DIM": 2, "DISTANCE_METRIC": "L2"}
+            ),
+        )
+    )
+
+    a = [1.5, 10]
+    b = [123, 100]
+    c = [1, 1]
+
+    client.hset("a", "v", np.array(a, dtype=np.uint8).tobytes())
+    client.hset("b", "v", np.array(b, dtype=np.uint8).tobytes())
+    client.hset("c", "v", np.array(c, dtype=np.uint8).tobytes())
+
+    query = Query("*=>[KNN 2 @v $vec as score]")
+    query_params = {"vec": np.array(a, dtype=np.uint8).tobytes()}
+
+    assert 2 in query.get_args()
+
+    res = client.ft().search(query, query_params=query_params)
+    if is_resp2_connection(client):
+        assert res.total == 2
+    else:
+        assert res["total_results"] == 2
+
+
 @pytest.mark.redismod
 @skip_ifmodversion_lt("2.4.3", "search")
 def test_search_query_with_different_dialects(client):

From f0f22db3618c592df9b2ed5f697ef41deb25a8b5 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 25 Feb 2025 19:54:21 +0200
Subject: [PATCH 0986/1164] Fixing wrong type hints (#3526)

---
 redis/commands/core.py            | 7 ++++---
 redis/commands/search/commands.py | 4 ++--
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 1d19e33f2c..6ab0602698 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -35,6 +35,7 @@
     GroupT,
     KeysT,
     KeyT,
+    Number,
     PatternT,
     ResponseT,
     ScriptTextT,
@@ -2567,7 +2568,7 @@ class ListCommands(CommandsProtocol):
     """
 
     def blpop(
-        self, keys: List, timeout: Optional[int] = 0
+        self, keys: List, timeout: Optional[Number] = 0
     ) -> Union[Awaitable[list], list]:
         """
         LPOP a value off of the first non-empty list
@@ -2588,7 +2589,7 @@ def blpop(
         return self.execute_command("BLPOP", *keys)
 
     def brpop(
-        self, keys: List, timeout: Optional[int] = 0
+        self, keys: List, timeout: Optional[Number] = 0
     ) -> Union[Awaitable[list], list]:
         """
         RPOP a value off of the first non-empty list
@@ -2609,7 +2610,7 @@ def brpop(
         return self.execute_command("BRPOP", *keys)
 
     def brpoplpush(
-        self, src: str, dst: str, timeout: Optional[int] = 0
+        self, src: str, dst: str, timeout: Optional[Number] = 0
     ) -> Union[Awaitable[Optional[str]], Optional[str]]:
         """
         Pop a value off the tail of ``src``, push it on the head of ``dst``
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index e5e78578be..1db57c23a5 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -586,7 +586,7 @@ def _get_aggregate_result(
 
     def profile(
         self,
-        query: Union[str, Query, AggregateRequest],
+        query: Union[Query, AggregateRequest],
         limited: bool = False,
         query_params: Optional[Dict[str, Union[str, int, float]]] = None,
     ):
@@ -596,7 +596,7 @@ def profile(
 
         ### Parameters
 
-        **query**: This can be either an `AggregateRequest`, `Query` or string.
+        **query**: This can be either an `AggregateRequest` or `Query`.
         **limited**: If set to True, removes details of reader iterator.
         **query_params**: Define one or more value parameters.
         Each parameter has a name and a value.

From 97a56e9f503ed40fe65be2874534bd6b6ebe7cd8 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Wed, 26 Feb 2025 10:25:23 +0200
Subject: [PATCH 0987/1164] Fix readthedocs.yml format for python install
 configuration (#3529)

---
 .readthedocs.yml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/.readthedocs.yml b/.readthedocs.yml
index 4b22490a49..17bfa9d47c 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -2,10 +2,9 @@ version: 2
 
 python:
   install:
+    - requirements: docs/requirements.txt
     - method: pip
       path: .
-    - method: pip
-      requirements: ./docs/requirements.txt
 
 build:
   os: ubuntu-20.04

From 6f752b0a827d316f8f2ab0a39bff95e9bbc27d82 Mon Sep 17 00:00:00 2001
From: bssyousefi <44493177+bssyousefi@users.noreply.github.com>
Date: Wed, 26 Feb 2025 08:14:59 -0500
Subject: [PATCH 0988/1164] Add valid Exception type to Except in
 ClusterPipeline (#3516)

---
 redis/cluster.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index c184838a9b..f518a1f184 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -2122,7 +2122,7 @@ def send_cluster_commands(
                     raise_on_error=raise_on_error,
                     allow_redirections=allow_redirections,
                 )
-            except (ClusterDownError, ConnectionError) as e:
+            except RedisCluster.ERRORS_ALLOW_RETRY as e:
                 if retry_attempts > 0:
                     # Try again with the new cluster setup. All other errors
                     # should be raised.

From dbbe7a713529e943f2ddd4dbad2a78b640a24a95 Mon Sep 17 00:00:00 2001
From: Aarni Koskela <akx@iki.fi>
Date: Thu, 27 Feb 2025 10:26:47 +0200
Subject: [PATCH 0989/1164] Make PyJWT an optional dependency (#3518)

---
 .github/actions/run-tests/action.yml |  2 +-
 CONTRIBUTING.md                      | 14 +++++++-------
 pyproject.toml                       |  4 +++-
 redis/auth/token.py                  |  7 ++++++-
 tests/conftest.py                    |  2 +-
 tests/test_asyncio/conftest.py       |  2 +-
 tests/test_auth/test_token.py        |  3 ++-
 7 files changed, 21 insertions(+), 13 deletions(-)

diff --git a/.github/actions/run-tests/action.yml b/.github/actions/run-tests/action.yml
index d822e1d499..aa958a9236 100644
--- a/.github/actions/run-tests/action.yml
+++ b/.github/actions/run-tests/action.yml
@@ -38,7 +38,7 @@ runs:
         echo "::group::Installing dependencies"
         pip install -r dev_requirements.txt
         pip uninstall -y redis  # uninstall Redis package installed via redis-entraid
-        pip install -e .  # install the working copy
+        pip install -e .[jwt]  # install the working copy
         if [ "${{inputs.parser-backend}}" == "hiredis" ]; then
           pip install "hiredis${{inputs.hiredis-version}}"
           echo "PARSER_BACKEND=$(echo "${{inputs.parser-backend}}_${{inputs.hiredis-version}}" | sed 's/[^a-zA-Z0-9]/_/g')" >> $GITHUB_ENV        
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 79983e4cb5..eb333f644f 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -32,13 +32,13 @@ Here's how to get started with your code contribution:
 
 1.  Create your own fork of redis-py
 2.  Do the changes in your fork
-3.
-    *Create a virtualenv and install the development dependencies from the dev_requirements.txt file:*
-
-        a.  python -m venv .venv
-        b.  source .venv/bin/activate
-        c.  pip install -r dev_requirements.txt
-        c.  pip install -e .
+3.  Create a virtualenv and install the development dependencies from the dev_requirements.txt file:
+    ```
+    python -m venv .venv
+    source .venv/bin/activate
+    pip install -r dev_requirements.txt
+    pip install -e .[jwt]
+    ```
 
 4.  If you need a development environment, run `invoke devenv`. Note: this relies on docker-compose to build environments, and assumes that you have a version supporting [docker profiles](https://docs.docker.com/compose/profiles/).
 5.  While developing, make sure the tests pass by running `invoke tests`
diff --git a/pyproject.toml b/pyproject.toml
index 7becde948e..0ec38ed3b1 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -37,7 +37,6 @@ classifiers = [
 ]
 dependencies = [
     'async-timeout>=4.0.3; python_full_version<"3.11.3"',
-    "PyJWT~=2.9.0",
 ]
 
 [project.optional-dependencies]
@@ -49,6 +48,9 @@ ocsp = [
     "pyopenssl==20.0.1",
     "requests>=2.31.0",
 ]
+jwt = [
+    "PyJWT~=2.9.0",
+]
 
 [project.urls]
 Changes = "https://github.com/redis/redis-py/releases"
diff --git a/redis/auth/token.py b/redis/auth/token.py
index 876e95c4fa..1c5246469b 100644
--- a/redis/auth/token.py
+++ b/redis/auth/token.py
@@ -1,7 +1,6 @@
 from abc import ABC, abstractmethod
 from datetime import datetime, timezone
 
-import jwt
 from redis.auth.err import InvalidTokenSchemaErr
 
 
@@ -81,6 +80,12 @@ class JWToken(TokenInterface):
     REQUIRED_FIELDS = {"exp"}
 
     def __init__(self, token: str):
+        try:
+            import jwt
+        except ImportError as ie:
+            raise ImportError(
+                f"The PyJWT library is required for {self.__class__.__name__}.",
+            ) from ie
         self._value = token
         self._decoded = jwt.decode(
             self._value,
diff --git a/tests/conftest.py b/tests/conftest.py
index fc732c0d72..8795c9f022 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -10,7 +10,6 @@
 from unittest.mock import Mock
 from urllib.parse import urlparse
 
-import jwt
 import pytest
 import redis
 from packaging.version import Version
@@ -615,6 +614,7 @@ def cache_key(request) -> CacheKey:
 
 
 def mock_identity_provider() -> IdentityProviderInterface:
+    jwt = pytest.importorskip("jwt")
     mock_provider = Mock(spec=IdentityProviderInterface)
     token = {"exp": datetime.now(timezone.utc).timestamp() + 3600, "oid": "username"}
     encoded = jwt.encode(token, "secret", algorithm="HS256")
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index fb6c51140e..99ad155d0a 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -5,7 +5,6 @@
 from enum import Enum
 from typing import Union
 
-import jwt
 import pytest
 import pytest_asyncio
 import redis.asyncio as redis
@@ -247,6 +246,7 @@ async def mock_cluster_resp_slaves(create_redis, **kwargs):
 
 
 def mock_identity_provider() -> IdentityProviderInterface:
+    jwt = pytest.importorskip("jwt")
     mock_provider = Mock(spec=IdentityProviderInterface)
     token = {"exp": datetime.now(timezone.utc).timestamp() + 3600, "oid": "username"}
     encoded = jwt.encode(token, "secret", algorithm="HS256")
diff --git a/tests/test_auth/test_token.py b/tests/test_auth/test_token.py
index 978cc2ca8c..2d72e08895 100644
--- a/tests/test_auth/test_token.py
+++ b/tests/test_auth/test_token.py
@@ -1,6 +1,5 @@
 from datetime import datetime, timezone
 
-import jwt
 import pytest
 from redis.auth.err import InvalidTokenSchemaErr
 from redis.auth.token import JWToken, SimpleToken
@@ -39,6 +38,8 @@ def test_simple_token(self):
         assert token.get_expires_at_ms() == -1
 
     def test_jwt_token(self):
+        jwt = pytest.importorskip("jwt")
+
         token = {
             "exp": datetime.now(timezone.utc).timestamp() + 100,
             "iat": datetime.now(timezone.utc).timestamp(),

From dd0c49265d8ec465a16a80292136aca149d865df Mon Sep 17 00:00:00 2001
From: alposomn <45829982+666romeo@users.noreply.github.com>
Date: Thu, 27 Feb 2025 14:58:20 +0200
Subject: [PATCH 0990/1164] Add force_master_ip support to async Sentinel
 client (#3524)

---
 redis/asyncio/sentinel.py      | 10 +++++++++-
 tests/test_asyncio/conftest.py |  2 ++
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/redis/asyncio/sentinel.py b/redis/asyncio/sentinel.py
index f1d2cab3f1..0389539fcf 100644
--- a/redis/asyncio/sentinel.py
+++ b/redis/asyncio/sentinel.py
@@ -198,6 +198,7 @@ def __init__(
         sentinels,
         min_other_sentinels=0,
         sentinel_kwargs=None,
+        force_master_ip=None,
         **connection_kwargs,
     ):
         # if sentinel_kwargs isn't defined, use the socket_* options from
@@ -214,6 +215,7 @@ def __init__(
         ]
         self.min_other_sentinels = min_other_sentinels
         self.connection_kwargs = connection_kwargs
+        self._force_master_ip = force_master_ip
 
     async def execute_command(self, *args, **kwargs):
         """
@@ -277,7 +279,13 @@ async def discover_master(self, service_name: str):
                     sentinel,
                     self.sentinels[0],
                 )
-                return state["ip"], state["port"]
+
+                ip = (
+                    self._force_master_ip
+                    if self._force_master_ip is not None
+                    else state["ip"]
+                )
+                return ip, state["port"]
 
         error_info = ""
         if len(collected_errors) > 0:
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index 99ad155d0a..d9cccf1b92 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -151,8 +151,10 @@ async def sentinel_setup(local_cache, request):
         for ip, port in (endpoint.split(":") for endpoint in sentinel_ips.split(","))
     ]
     kwargs = request.param.get("kwargs", {}) if hasattr(request, "param") else {}
+    force_master_ip = request.param.get("force_master_ip", None)
     sentinel = Sentinel(
         sentinel_endpoints,
+        force_master_ip=force_master_ip,
         socket_timeout=0.1,
         client_cache=local_cache,
         protocol=3,

From 577b4acb3b9a599e079151b086818f1e5acd69e9 Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Fri, 28 Feb 2025 17:16:14 +0200
Subject: [PATCH 0991/1164] Fixing typing for FCALL commands to match PEP 484
 (#3537)

* Fixing typing for FCALL commands to match PEP 484

* Codestyle fixes

* Fixes issue #3536
---
 redis/commands/core.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 6ab0602698..880d0fda41 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -5,6 +5,7 @@
 import warnings
 from typing import (
     TYPE_CHECKING,
+    Any,
     AsyncIterator,
     Awaitable,
     Callable,
@@ -6397,12 +6398,12 @@ def function_list(
         return self.execute_command("FUNCTION LIST", *args)
 
     def _fcall(
-        self, command: str, function, numkeys: int, *keys_and_args: Optional[List]
+        self, command: str, function, numkeys: int, *keys_and_args: Any
     ) -> Union[Awaitable[str], str]:
         return self.execute_command(command, function, numkeys, *keys_and_args)
 
     def fcall(
-        self, function, numkeys: int, *keys_and_args: Optional[List]
+        self, function, numkeys: int, *keys_and_args: Any
     ) -> Union[Awaitable[str], str]:
         """
         Invoke a function.
@@ -6412,7 +6413,7 @@ def fcall(
         return self._fcall("FCALL", function, numkeys, *keys_and_args)
 
     def fcall_ro(
-        self, function, numkeys: int, *keys_and_args: Optional[List]
+        self, function, numkeys: int, *keys_and_args: Any
     ) -> Union[Awaitable[str], str]:
         """
         This is a read-only variant of the FCALL command that cannot

From 2fb2f47d0aa46c2622ee09f547f8c01d2eeb7738 Mon Sep 17 00:00:00 2001
From: Mathew Shen <datahonor@gmail.com>
Date: Tue, 4 Mar 2025 17:34:19 +0800
Subject: [PATCH 0992/1164] fix(lock): Fix LockError message when releasing a
 lock. (#3534)

* fix(lock): raise LockNotOwnedError when release a lock from non-owned thread

* change: error raise

* fix: linter

* fix(lock): async release

---------

Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
---
 redis/asyncio/lock.py | 5 ++++-
 redis/lock.py         | 5 ++++-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/redis/asyncio/lock.py b/redis/asyncio/lock.py
index e1d11a882d..bb2cccab52 100644
--- a/redis/asyncio/lock.py
+++ b/redis/asyncio/lock.py
@@ -249,7 +249,10 @@ def release(self) -> Awaitable[None]:
         """Releases the already acquired lock"""
         expected_token = self.local.token
         if expected_token is None:
-            raise LockError("Cannot release an unlocked lock")
+            raise LockError(
+                "Cannot release a lock that's not owned or is already unlocked.",
+                lock_name=self.name,
+            )
         self.local.token = None
         return self.do_release(expected_token)
 
diff --git a/redis/lock.py b/redis/lock.py
index f44ed629da..7a1becb30a 100644
--- a/redis/lock.py
+++ b/redis/lock.py
@@ -251,7 +251,10 @@ def release(self) -> None:
         """
         expected_token = self.local.token
         if expected_token is None:
-            raise LockError("Cannot release an unlocked lock", lock_name=self.name)
+            raise LockError(
+                "Cannot release a lock that's not owned or is already unlocked.",
+                lock_name=self.name,
+            )
         self.local.token = None
         self.do_release(expected_token)
 

From 20c4475f769dc994bdebdebacf698991371f3797 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 4 Mar 2025 13:05:56 +0200
Subject: [PATCH 0993/1164] Bump rojopolis/spellcheck-github-actions from
 0.38.0 to 0.47.0 (#3538)

Bumps [rojopolis/spellcheck-github-actions](https://github.com/rojopolis/spellcheck-github-actions) from 0.38.0 to 0.47.0.
- [Release notes](https://github.com/rojopolis/spellcheck-github-actions/releases)
- [Changelog](https://github.com/rojopolis/spellcheck-github-actions/blob/master/CHANGELOG.md)
- [Commits](https://github.com/rojopolis/spellcheck-github-actions/compare/0.38.0...0.47.0)

---
updated-dependencies:
- dependency-name: rojopolis/spellcheck-github-actions
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: petyaslavova <petya.slavova@redis.com>
---
 .github/workflows/spellcheck.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/spellcheck.yml b/.github/workflows/spellcheck.yml
index 62e38997e4..beefa6164f 100644
--- a/.github/workflows/spellcheck.yml
+++ b/.github/workflows/spellcheck.yml
@@ -8,7 +8,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
       - name: Check Spelling
-        uses: rojopolis/spellcheck-github-actions@0.38.0
+        uses: rojopolis/spellcheck-github-actions@0.47.0
         with:
           config_path: .github/spellcheck-settings.yml
           task_name: Markdown

From 805848a1d5e7645bc4acb4545242867eb99480b7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E4=B8=89=E6=A0=B7?=
 <83902645+three-kinds@users.noreply.github.com>
Date: Wed, 5 Mar 2025 02:00:17 +0800
Subject: [PATCH 0994/1164] Fix client_list with multiple client ids (#3539)

---
 redis/commands/core.py |  2 +-
 tests/test_commands.py | 14 +++++++++-----
 2 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 880d0fda41..c3ffb955c4 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -530,7 +530,7 @@ def client_list(
             raise DataError("client_id must be a list")
         if client_id:
             args.append(b"ID")
-            args.append(" ".join(client_id))
+            args += client_id
         return self.execute_command("CLIENT LIST", *args, **kwargs)
 
     def client_getname(self, **kwargs) -> ResponseT:
diff --git a/tests/test_commands.py b/tests/test_commands.py
index f89c5f3365..b6f13f6aa8 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -667,11 +667,15 @@ def test_client_list_client_id(self, r, request):
         assert "addr" in clients[0]
 
         # testing multiple client ids
-        _get_client(redis.Redis, request, flushdb=False)
-        _get_client(redis.Redis, request, flushdb=False)
-        _get_client(redis.Redis, request, flushdb=False)
-        clients_listed = r.client_list(client_id=clients[:-1])
-        assert len(clients_listed) > 1
+        client_list = list()
+        client_count = 3
+        for i in range(client_count):
+            client = _get_client(redis.Redis, request, flushdb=False)
+            client_list.append(client)
+
+        multiple_client_ids = [str(client.client_id()) for client in client_list]
+        clients_listed = r.client_list(client_id=multiple_client_ids)
+        assert len(clients_listed) == len(multiple_client_ids)
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("5.0.0")

From b9af3744ab7343a502c8d0a949e3f78f0e9578da Mon Sep 17 00:00:00 2001
From: Antoni Baum <antoni.baum@protonmail.com>
Date: Tue, 4 Mar 2025 23:45:28 -0800
Subject: [PATCH 0995/1164] Fix connection health check for protocol != 2 when
 auth credentials are provided and health check interval is configured (#3477)

---
 redis/asyncio/connection.py | 6 +++++-
 redis/connection.py         | 6 +++++-
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index e67dc5b207..2e2a2502c3 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -363,7 +363,11 @@ async def on_connect(self) -> None:
                 self._parser.on_connect(self)
             if len(auth_args) == 1:
                 auth_args = ["default", auth_args[0]]
-            await self.send_command("HELLO", self.protocol, "AUTH", *auth_args)
+            # avoid checking health here -- PING will fail if we try
+            # to check the health prior to the AUTH
+            await self.send_command(
+                "HELLO", self.protocol, "AUTH", *auth_args, check_health=False
+            )
             response = await self.read_response()
             if response.get(b"proto") != int(self.protocol) and response.get(
                 "proto"
diff --git a/redis/connection.py b/redis/connection.py
index ece17d752b..2391e74d2c 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -440,7 +440,11 @@ def on_connect(self):
                 self._parser.on_connect(self)
             if len(auth_args) == 1:
                 auth_args = ["default", auth_args[0]]
-            self.send_command("HELLO", self.protocol, "AUTH", *auth_args)
+            # avoid checking health here -- PING will fail if we try
+            # to check the health prior to the AUTH
+            self.send_command(
+                "HELLO", self.protocol, "AUTH", *auth_args, check_health=False
+            )
             self.handshake_metadata = self.read_response()
             # if response.get(b"proto") != self.protocol and response.get(
             #     "proto"

From 589110961a270733e4e3fb6add75117be124d984 Mon Sep 17 00:00:00 2001
From: Aarni Koskela <akx@iki.fi>
Date: Wed, 5 Mar 2025 14:02:19 +0200
Subject: [PATCH 0996/1164] Isolate redis-entraid dependency for tests (#3521)

---
 tests/conftest.py                      | 141 +---------------------
 tests/entraid_utils.py                 | 140 ++++++++++++++++++++++
 tests/test_asyncio/conftest.py         | 154 +------------------------
 tests/test_asyncio/test_credentials.py |   9 +-
 tests/test_credentials.py              |   9 +-
 5 files changed, 163 insertions(+), 290 deletions(-)
 create mode 100644 tests/entraid_utils.py

diff --git a/tests/conftest.py b/tests/conftest.py
index 8795c9f022..e5eea4d582 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -4,8 +4,7 @@
 import random
 import time
 from datetime import datetime, timezone
-from enum import Enum
-from typing import Callable, TypeVar, Union
+from typing import Callable, TypeVar
 from unittest import mock
 from unittest.mock import Mock
 from urllib.parse import urlparse
@@ -16,7 +15,6 @@
 from redis import Sentinel
 from redis.auth.idp import IdentityProviderInterface
 from redis.auth.token import JWToken
-from redis.auth.token_manager import RetryPolicy, TokenManagerConfig
 from redis.backoff import NoBackoff
 from redis.cache import (
     CacheConfig,
@@ -29,22 +27,6 @@
 from redis.credentials import CredentialProvider
 from redis.exceptions import RedisClusterException
 from redis.retry import Retry
-from redis_entraid.cred_provider import (
-    DEFAULT_DELAY_IN_MS,
-    DEFAULT_EXPIRATION_REFRESH_RATIO,
-    DEFAULT_LOWER_REFRESH_BOUND_MILLIS,
-    DEFAULT_MAX_ATTEMPTS,
-    DEFAULT_TOKEN_REQUEST_EXECUTION_TIMEOUT_IN_MS,
-    EntraIdCredentialsProvider,
-)
-from redis_entraid.identity_provider import (
-    ManagedIdentityIdType,
-    ManagedIdentityProviderConfig,
-    ManagedIdentityType,
-    ServicePrincipalIdentityProviderConfig,
-    _create_provider_from_managed_identity,
-    _create_provider_from_service_principal,
-)
 from tests.ssl_utils import get_tls_certificates
 
 REDIS_INFO = {}
@@ -60,11 +42,6 @@
 _TestDecorator = Callable[[_DecoratedTest], _DecoratedTest]
 
 
-class AuthType(Enum):
-    MANAGED_IDENTITY = "managed_identity"
-    SERVICE_PRINCIPAL = "service_principal"
-
-
 # Taken from python3.9
 class BooleanOptionalAction(argparse.Action):
     def __init__(
@@ -623,124 +600,18 @@ def mock_identity_provider() -> IdentityProviderInterface:
     return mock_provider
 
 
-def identity_provider(request) -> IdentityProviderInterface:
-    if hasattr(request, "param"):
-        kwargs = request.param.get("idp_kwargs", {})
-    else:
-        kwargs = {}
-
-    if request.param.get("mock_idp", None) is not None:
-        return mock_identity_provider()
-
-    auth_type = kwargs.pop("auth_type", AuthType.SERVICE_PRINCIPAL)
-    config = get_identity_provider_config(request=request)
-
-    if auth_type == "MANAGED_IDENTITY":
-        return _create_provider_from_managed_identity(config)
-
-    return _create_provider_from_service_principal(config)
-
-
-def get_identity_provider_config(
-    request,
-) -> Union[ManagedIdentityProviderConfig, ServicePrincipalIdentityProviderConfig]:
-    if hasattr(request, "param"):
-        kwargs = request.param.get("idp_kwargs", {})
-    else:
-        kwargs = {}
-
-    auth_type = kwargs.pop("auth_type", AuthType.SERVICE_PRINCIPAL)
-
-    if auth_type == AuthType.MANAGED_IDENTITY:
-        return _get_managed_identity_provider_config(request)
-
-    return _get_service_principal_provider_config(request)
-
-
-def _get_managed_identity_provider_config(request) -> ManagedIdentityProviderConfig:
-    resource = os.getenv("AZURE_RESOURCE")
-    id_value = os.getenv("AZURE_USER_ASSIGNED_MANAGED_ID", None)
-
-    if hasattr(request, "param"):
-        kwargs = request.param.get("idp_kwargs", {})
-    else:
-        kwargs = {}
-
-    identity_type = kwargs.pop("identity_type", ManagedIdentityType.SYSTEM_ASSIGNED)
-    id_type = kwargs.pop("id_type", ManagedIdentityIdType.OBJECT_ID)
-
-    return ManagedIdentityProviderConfig(
-        identity_type=identity_type,
-        resource=resource,
-        id_type=id_type,
-        id_value=id_value,
-        kwargs=kwargs,
-    )
-
-
-def _get_service_principal_provider_config(
-    request,
-) -> ServicePrincipalIdentityProviderConfig:
-    client_id = os.getenv("AZURE_CLIENT_ID")
-    client_credential = os.getenv("AZURE_CLIENT_SECRET")
-    tenant_id = os.getenv("AZURE_TENANT_ID")
-    scopes = os.getenv("AZURE_REDIS_SCOPES", None)
-
-    if hasattr(request, "param"):
-        kwargs = request.param.get("idp_kwargs", {})
-        token_kwargs = request.param.get("token_kwargs", {})
-        timeout = request.param.get("timeout", None)
-    else:
-        kwargs = {}
-        token_kwargs = {}
-        timeout = None
-
-    if isinstance(scopes, str):
-        scopes = scopes.split(",")
-
-    return ServicePrincipalIdentityProviderConfig(
-        client_id=client_id,
-        client_credential=client_credential,
-        scopes=scopes,
-        timeout=timeout,
-        token_kwargs=token_kwargs,
-        tenant_id=tenant_id,
-        app_kwargs=kwargs,
-    )
-
-
 def get_credential_provider(request) -> CredentialProvider:
     cred_provider_class = request.param.get("cred_provider_class")
     cred_provider_kwargs = request.param.get("cred_provider_kwargs", {})
 
-    if cred_provider_class != EntraIdCredentialsProvider:
+    # Since we can't import EntraIdCredentialsProvider in this module,
+    # we'll just check the class name.
+    if cred_provider_class.__name__ != "EntraIdCredentialsProvider":
         return cred_provider_class(**cred_provider_kwargs)
 
-    idp = identity_provider(request)
-    expiration_refresh_ratio = cred_provider_kwargs.get(
-        "expiration_refresh_ratio", DEFAULT_EXPIRATION_REFRESH_RATIO
-    )
-    lower_refresh_bound_millis = cred_provider_kwargs.get(
-        "lower_refresh_bound_millis", DEFAULT_LOWER_REFRESH_BOUND_MILLIS
-    )
-    max_attempts = cred_provider_kwargs.get("max_attempts", DEFAULT_MAX_ATTEMPTS)
-    delay_in_ms = cred_provider_kwargs.get("delay_in_ms", DEFAULT_DELAY_IN_MS)
-
-    token_mgr_config = TokenManagerConfig(
-        expiration_refresh_ratio=expiration_refresh_ratio,
-        lower_refresh_bound_millis=lower_refresh_bound_millis,
-        token_request_execution_timeout_in_ms=DEFAULT_TOKEN_REQUEST_EXECUTION_TIMEOUT_IN_MS,  # noqa
-        retry_policy=RetryPolicy(
-            max_attempts=max_attempts,
-            delay_in_ms=delay_in_ms,
-        ),
-    )
+    from tests.entraid_utils import get_entra_id_credentials_provider
 
-    return EntraIdCredentialsProvider(
-        identity_provider=idp,
-        token_manager_config=token_mgr_config,
-        initial_delay_in_ms=delay_in_ms,
-    )
+    return get_entra_id_credentials_provider(request, cred_provider_kwargs)
 
 
 @pytest.fixture()
diff --git a/tests/entraid_utils.py b/tests/entraid_utils.py
new file mode 100644
index 0000000000..daefbd3956
--- /dev/null
+++ b/tests/entraid_utils.py
@@ -0,0 +1,140 @@
+import os
+from enum import Enum
+from typing import Union
+
+from redis.auth.idp import IdentityProviderInterface
+from redis.auth.token_manager import RetryPolicy, TokenManagerConfig
+from redis_entraid.cred_provider import (
+    DEFAULT_DELAY_IN_MS,
+    DEFAULT_EXPIRATION_REFRESH_RATIO,
+    DEFAULT_LOWER_REFRESH_BOUND_MILLIS,
+    DEFAULT_MAX_ATTEMPTS,
+    DEFAULT_TOKEN_REQUEST_EXECUTION_TIMEOUT_IN_MS,
+    EntraIdCredentialsProvider,
+)
+from redis_entraid.identity_provider import (
+    ManagedIdentityIdType,
+    ManagedIdentityProviderConfig,
+    ManagedIdentityType,
+    ServicePrincipalIdentityProviderConfig,
+    _create_provider_from_managed_identity,
+    _create_provider_from_service_principal,
+)
+from tests.conftest import mock_identity_provider
+
+
+class AuthType(Enum):
+    MANAGED_IDENTITY = "managed_identity"
+    SERVICE_PRINCIPAL = "service_principal"
+
+
+def identity_provider(request) -> IdentityProviderInterface:
+    if hasattr(request, "param"):
+        kwargs = request.param.get("idp_kwargs", {})
+    else:
+        kwargs = {}
+
+    if request.param.get("mock_idp", None) is not None:
+        return mock_identity_provider()
+
+    auth_type = kwargs.pop("auth_type", AuthType.SERVICE_PRINCIPAL)
+    config = get_identity_provider_config(request=request)
+
+    if auth_type == "MANAGED_IDENTITY":
+        return _create_provider_from_managed_identity(config)
+
+    return _create_provider_from_service_principal(config)
+
+
+def get_identity_provider_config(
+    request,
+) -> Union[ManagedIdentityProviderConfig, ServicePrincipalIdentityProviderConfig]:
+    if hasattr(request, "param"):
+        kwargs = request.param.get("idp_kwargs", {})
+    else:
+        kwargs = {}
+
+    auth_type = kwargs.pop("auth_type", AuthType.SERVICE_PRINCIPAL)
+
+    if auth_type == AuthType.MANAGED_IDENTITY:
+        return _get_managed_identity_provider_config(request)
+
+    return _get_service_principal_provider_config(request)
+
+
+def _get_managed_identity_provider_config(request) -> ManagedIdentityProviderConfig:
+    resource = os.getenv("AZURE_RESOURCE")
+    id_value = os.getenv("AZURE_USER_ASSIGNED_MANAGED_ID", None)
+
+    if hasattr(request, "param"):
+        kwargs = request.param.get("idp_kwargs", {})
+    else:
+        kwargs = {}
+
+    identity_type = kwargs.pop("identity_type", ManagedIdentityType.SYSTEM_ASSIGNED)
+    id_type = kwargs.pop("id_type", ManagedIdentityIdType.OBJECT_ID)
+
+    return ManagedIdentityProviderConfig(
+        identity_type=identity_type,
+        resource=resource,
+        id_type=id_type,
+        id_value=id_value,
+        kwargs=kwargs,
+    )
+
+
+def _get_service_principal_provider_config(
+    request,
+) -> ServicePrincipalIdentityProviderConfig:
+    client_id = os.getenv("AZURE_CLIENT_ID")
+    client_credential = os.getenv("AZURE_CLIENT_SECRET")
+    tenant_id = os.getenv("AZURE_TENANT_ID")
+    scopes = os.getenv("AZURE_REDIS_SCOPES", None)
+
+    if hasattr(request, "param"):
+        kwargs = request.param.get("idp_kwargs", {})
+        token_kwargs = request.param.get("token_kwargs", {})
+        timeout = request.param.get("timeout", None)
+    else:
+        kwargs = {}
+        token_kwargs = {}
+        timeout = None
+
+    if isinstance(scopes, str):
+        scopes = scopes.split(",")
+
+    return ServicePrincipalIdentityProviderConfig(
+        client_id=client_id,
+        client_credential=client_credential,
+        scopes=scopes,
+        timeout=timeout,
+        token_kwargs=token_kwargs,
+        tenant_id=tenant_id,
+        app_kwargs=kwargs,
+    )
+
+
+def get_entra_id_credentials_provider(request, cred_provider_kwargs):
+    idp = identity_provider(request)
+    expiration_refresh_ratio = cred_provider_kwargs.get(
+        "expiration_refresh_ratio", DEFAULT_EXPIRATION_REFRESH_RATIO
+    )
+    lower_refresh_bound_millis = cred_provider_kwargs.get(
+        "lower_refresh_bound_millis", DEFAULT_LOWER_REFRESH_BOUND_MILLIS
+    )
+    max_attempts = cred_provider_kwargs.get("max_attempts", DEFAULT_MAX_ATTEMPTS)
+    delay_in_ms = cred_provider_kwargs.get("delay_in_ms", DEFAULT_DELAY_IN_MS)
+    token_mgr_config = TokenManagerConfig(
+        expiration_refresh_ratio=expiration_refresh_ratio,
+        lower_refresh_bound_millis=lower_refresh_bound_millis,
+        token_request_execution_timeout_in_ms=DEFAULT_TOKEN_REQUEST_EXECUTION_TIMEOUT_IN_MS,  # noqa
+        retry_policy=RetryPolicy(
+            max_attempts=max_attempts,
+            delay_in_ms=delay_in_ms,
+        ),
+    )
+    return EntraIdCredentialsProvider(
+        identity_provider=idp,
+        token_manager_config=token_mgr_config,
+        initial_delay_in_ms=delay_in_ms,
+    )
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index d9cccf1b92..226b00aa45 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -1,41 +1,19 @@
-import os
 import random
 from contextlib import asynccontextmanager as _asynccontextmanager
-from datetime import datetime, timezone
 from enum import Enum
 from typing import Union
 
 import pytest
 import pytest_asyncio
 import redis.asyncio as redis
-from mock.mock import Mock
 from packaging.version import Version
 from redis.asyncio import Sentinel
 from redis.asyncio.client import Monitor
 from redis.asyncio.connection import Connection, parse_url
 from redis.asyncio.retry import Retry
-from redis.auth.idp import IdentityProviderInterface
-from redis.auth.token import JWToken
-from redis.auth.token_manager import RetryPolicy, TokenManagerConfig
 from redis.backoff import NoBackoff
 from redis.credentials import CredentialProvider
-from redis_entraid.cred_provider import (
-    DEFAULT_DELAY_IN_MS,
-    DEFAULT_EXPIRATION_REFRESH_RATIO,
-    DEFAULT_LOWER_REFRESH_BOUND_MILLIS,
-    DEFAULT_MAX_ATTEMPTS,
-    DEFAULT_TOKEN_REQUEST_EXECUTION_TIMEOUT_IN_MS,
-    EntraIdCredentialsProvider,
-)
-from redis_entraid.identity_provider import (
-    ManagedIdentityIdType,
-    ManagedIdentityProviderConfig,
-    ManagedIdentityType,
-    ServicePrincipalIdentityProviderConfig,
-    _create_provider_from_managed_identity,
-    _create_provider_from_service_principal,
-)
-from tests.conftest import REDIS_INFO
+from tests.conftest import REDIS_INFO, get_credential_provider
 
 from .compat import mock
 
@@ -247,136 +225,6 @@ async def mock_cluster_resp_slaves(create_redis, **kwargs):
         yield mocked
 
 
-def mock_identity_provider() -> IdentityProviderInterface:
-    jwt = pytest.importorskip("jwt")
-    mock_provider = Mock(spec=IdentityProviderInterface)
-    token = {"exp": datetime.now(timezone.utc).timestamp() + 3600, "oid": "username"}
-    encoded = jwt.encode(token, "secret", algorithm="HS256")
-    jwt_token = JWToken(encoded)
-    mock_provider.request_token.return_value = jwt_token
-    return mock_provider
-
-
-def identity_provider(request) -> IdentityProviderInterface:
-    if hasattr(request, "param"):
-        kwargs = request.param.get("idp_kwargs", {})
-    else:
-        kwargs = {}
-
-    if request.param.get("mock_idp", None) is not None:
-        return mock_identity_provider()
-
-    auth_type = kwargs.pop("auth_type", AuthType.SERVICE_PRINCIPAL)
-    config = get_identity_provider_config(request=request)
-
-    if auth_type == "MANAGED_IDENTITY":
-        return _create_provider_from_managed_identity(config)
-
-    return _create_provider_from_service_principal(config)
-
-
-def get_identity_provider_config(
-    request,
-) -> Union[ManagedIdentityProviderConfig, ServicePrincipalIdentityProviderConfig]:
-    if hasattr(request, "param"):
-        kwargs = request.param.get("idp_kwargs", {})
-    else:
-        kwargs = {}
-
-    auth_type = kwargs.pop("auth_type", AuthType.SERVICE_PRINCIPAL)
-
-    if auth_type == AuthType.MANAGED_IDENTITY:
-        return _get_managed_identity_provider_config(request)
-
-    return _get_service_principal_provider_config(request)
-
-
-def _get_managed_identity_provider_config(request) -> ManagedIdentityProviderConfig:
-    resource = os.getenv("AZURE_RESOURCE")
-    id_value = os.getenv("AZURE_USER_ASSIGNED_MANAGED_ID", None)
-
-    if hasattr(request, "param"):
-        kwargs = request.param.get("idp_kwargs", {})
-    else:
-        kwargs = {}
-
-    identity_type = kwargs.pop("identity_type", ManagedIdentityType.SYSTEM_ASSIGNED)
-    id_type = kwargs.pop("id_type", ManagedIdentityIdType.OBJECT_ID)
-
-    return ManagedIdentityProviderConfig(
-        identity_type=identity_type,
-        resource=resource,
-        id_type=id_type,
-        id_value=id_value,
-        kwargs=kwargs,
-    )
-
-
-def _get_service_principal_provider_config(
-    request,
-) -> ServicePrincipalIdentityProviderConfig:
-    client_id = os.getenv("AZURE_CLIENT_ID")
-    client_credential = os.getenv("AZURE_CLIENT_SECRET")
-    tenant_id = os.getenv("AZURE_TENANT_ID")
-    scopes = os.getenv("AZURE_REDIS_SCOPES", None)
-
-    if hasattr(request, "param"):
-        kwargs = request.param.get("idp_kwargs", {})
-        token_kwargs = request.param.get("token_kwargs", {})
-        timeout = request.param.get("timeout", None)
-    else:
-        kwargs = {}
-        token_kwargs = {}
-        timeout = None
-
-    if isinstance(scopes, str):
-        scopes = scopes.split(",")
-
-    return ServicePrincipalIdentityProviderConfig(
-        client_id=client_id,
-        client_credential=client_credential,
-        scopes=scopes,
-        timeout=timeout,
-        token_kwargs=token_kwargs,
-        tenant_id=tenant_id,
-        app_kwargs=kwargs,
-    )
-
-
-def get_credential_provider(request) -> CredentialProvider:
-    cred_provider_class = request.param.get("cred_provider_class")
-    cred_provider_kwargs = request.param.get("cred_provider_kwargs", {})
-
-    if cred_provider_class != EntraIdCredentialsProvider:
-        return cred_provider_class(**cred_provider_kwargs)
-
-    idp = identity_provider(request)
-    expiration_refresh_ratio = cred_provider_kwargs.get(
-        "expiration_refresh_ratio", DEFAULT_EXPIRATION_REFRESH_RATIO
-    )
-    lower_refresh_bound_millis = cred_provider_kwargs.get(
-        "lower_refresh_bound_millis", DEFAULT_LOWER_REFRESH_BOUND_MILLIS
-    )
-    max_attempts = cred_provider_kwargs.get("max_attempts", DEFAULT_MAX_ATTEMPTS)
-    delay_in_ms = cred_provider_kwargs.get("delay_in_ms", DEFAULT_DELAY_IN_MS)
-
-    token_mgr_config = TokenManagerConfig(
-        expiration_refresh_ratio=expiration_refresh_ratio,
-        lower_refresh_bound_millis=lower_refresh_bound_millis,
-        token_request_execution_timeout_in_ms=DEFAULT_TOKEN_REQUEST_EXECUTION_TIMEOUT_IN_MS,  # noqa
-        retry_policy=RetryPolicy(
-            max_attempts=max_attempts,
-            delay_in_ms=delay_in_ms,
-        ),
-    )
-
-    return EntraIdCredentialsProvider(
-        identity_provider=idp,
-        token_manager_config=token_mgr_config,
-        initial_delay_in_ms=delay_in_ms,
-    )
-
-
 @pytest_asyncio.fixture()
 async def credential_provider(request) -> CredentialProvider:
     return get_credential_provider(request)
diff --git a/tests/test_asyncio/test_credentials.py b/tests/test_asyncio/test_credentials.py
index 1eb988ce71..ce8d76ea45 100644
--- a/tests/test_asyncio/test_credentials.py
+++ b/tests/test_asyncio/test_credentials.py
@@ -17,10 +17,14 @@
 from redis.credentials import CredentialProvider, UsernamePasswordCredentialProvider
 from redis.exceptions import ConnectionError
 from redis.utils import str_if_bytes
-from redis_entraid.cred_provider import EntraIdCredentialsProvider
 from tests.conftest import get_endpoint, skip_if_redis_enterprise
 from tests.test_asyncio.conftest import get_credential_provider
 
+try:
+    from redis_entraid.cred_provider import EntraIdCredentialsProvider
+except ImportError:
+    EntraIdCredentialsProvider = None
+
 
 @pytest.fixture()
 def endpoint(request):
@@ -321,6 +325,7 @@ async def test_user_pass_provider_only_password(
 
 @pytest.mark.asyncio
 @pytest.mark.onlynoncluster
+@pytest.mark.skipif(not EntraIdCredentialsProvider, reason="requires redis-entraid")
 class TestStreamingCredentialProvider:
     @pytest.mark.parametrize(
         "credential_provider",
@@ -599,6 +604,7 @@ async def test_fails_on_token_renewal(self, credential_provider):
 @pytest.mark.asyncio
 @pytest.mark.onlynoncluster
 @pytest.mark.cp_integration
+@pytest.mark.skipif(not EntraIdCredentialsProvider, reason="requires redis-entraid")
 class TestEntraIdCredentialsProvider:
     @pytest.mark.parametrize(
         "r_credential",
@@ -674,6 +680,7 @@ async def test_async_auth_pubsub_with_credential_provider(
 @pytest.mark.asyncio
 @pytest.mark.onlycluster
 @pytest.mark.cp_integration
+@pytest.mark.skipif(not EntraIdCredentialsProvider, reason="requires redis-entraid")
 class TestClusterEntraIdCredentialsProvider:
     @pytest.mark.parametrize(
         "r_credential",
diff --git a/tests/test_credentials.py b/tests/test_credentials.py
index 95ec5577cc..1f98c5208d 100644
--- a/tests/test_credentials.py
+++ b/tests/test_credentials.py
@@ -16,7 +16,6 @@
 from redis.exceptions import ConnectionError, RedisError
 from redis.retry import Retry
 from redis.utils import str_if_bytes
-from redis_entraid.cred_provider import EntraIdCredentialsProvider
 from tests.conftest import (
     _get_client,
     get_credential_provider,
@@ -24,6 +23,11 @@
     skip_if_redis_enterprise,
 )
 
+try:
+    from redis_entraid.cred_provider import EntraIdCredentialsProvider
+except ImportError:
+    EntraIdCredentialsProvider = None
+
 
 @pytest.fixture()
 def endpoint(request):
@@ -295,6 +299,7 @@ def test_user_pass_provider_only_password(self, r, request):
 
 
 @pytest.mark.onlynoncluster
+@pytest.mark.skipif(not EntraIdCredentialsProvider, reason="requires redis-entraid")
 class TestStreamingCredentialProvider:
     @pytest.mark.parametrize(
         "credential_provider",
@@ -567,6 +572,7 @@ def test_fails_on_token_renewal(self, credential_provider):
 
 @pytest.mark.onlynoncluster
 @pytest.mark.cp_integration
+@pytest.mark.skipif(not EntraIdCredentialsProvider, reason="requires redis-entraid")
 class TestEntraIdCredentialsProvider:
     @pytest.mark.parametrize(
         "r_entra",
@@ -637,6 +643,7 @@ def test_auth_pubsub_with_credential_provider(self, r_entra: redis.Redis):
 
 @pytest.mark.onlycluster
 @pytest.mark.cp_integration
+@pytest.mark.skipif(not EntraIdCredentialsProvider, reason="requires redis-entraid")
 class TestClusterEntraIdCredentialsProvider:
     @pytest.mark.parametrize(
         "r_entra",

From 4122f7c109f6ec82fbff65f5734ecec00d77e2aa Mon Sep 17 00:00:00 2001
From: Aarni Koskela <akx@iki.fi>
Date: Wed, 5 Mar 2025 20:04:54 +0200
Subject: [PATCH 0997/1164] Replace flake8+isort+black with `ruff` (#3147)

* Replace flake8 + isort + flynt with ruff

* Replace black with `ruff format`; run it
---
 .flake8                                | 28 ---------------
 .isort.cfg                             |  5 ---
 benchmarks/basic_operations.py         |  2 +-
 benchmarks/command_packer_benchmark.py |  1 -
 benchmarks/socket_read_size.py         |  1 -
 dev_requirements.txt                   |  5 +--
 doctests/README.md                     |  4 +--
 pyproject.toml                         | 50 ++++++++++++++++++++++++++
 redis/_parsers/base.py                 |  4 +--
 redis/asyncio/cluster.py               |  6 ++--
 redis/asyncio/connection.py            |  2 +-
 redis/asyncio/utils.py                 |  2 +-
 redis/auth/token.py                    |  1 -
 redis/client.py                        |  3 +-
 redis/cluster.py                       |  5 ++-
 redis/commands/cluster.py              |  2 +-
 redis/commands/core.py                 |  7 ++--
 redis/commands/graph/commands.py       |  4 +--
 redis/commands/helpers.py              |  4 +--
 redis/connection.py                    |  6 ++--
 redis/exceptions.py                    |  3 ++
 redis/ocsp.py                          |  3 +-
 redis/sentinel.py                      |  2 +-
 tasks.py                               |  6 ++--
 tests/conftest.py                      |  2 +-
 tests/test_asyncio/conftest.py         |  2 +-
 tests/test_asyncio/test_cluster.py     | 11 +++---
 tests/test_asyncio/test_commands.py    | 15 ++++----
 tests/test_asyncio/test_graph.py       |  3 +-
 tests/test_asyncio/test_search.py      | 12 +++----
 tests/test_auth/test_token.py          |  1 -
 tests/test_cluster.py                  | 10 +++---
 tests/test_commands.py                 | 15 ++++----
 tests/test_connection.py               |  1 -
 tests/test_graph.py                    |  3 +-
 tests/test_search.py                   | 12 +++----
 36 files changed, 123 insertions(+), 120 deletions(-)
 delete mode 100644 .flake8
 delete mode 100644 .isort.cfg

diff --git a/.flake8 b/.flake8
deleted file mode 100644
index b1bd1d0b75..0000000000
--- a/.flake8
+++ /dev/null
@@ -1,28 +0,0 @@
-[flake8]
-max-line-length = 88
-exclude =
-    *.egg-info,
-    *.pyc,
-    .git,
-    .venv*,
-    build,
-    docs/*,
-    dist,
-    docker,
-    venv*,
-    .venv*,
-    whitelist.py,
-    tasks.py
-ignore =
-    E126
-    E203
-    E231
-    E701
-    E704
-    F405
-    N801
-    N802
-    N803
-    N806
-    N815
-    W503
diff --git a/.isort.cfg b/.isort.cfg
deleted file mode 100644
index 039f0337a2..0000000000
--- a/.isort.cfg
+++ /dev/null
@@ -1,5 +0,0 @@
-[settings]
-profile=black
-multi_line_output=3
-src_paths = ["redis", "tests"]
-skip_glob=benchmarks/*
\ No newline at end of file
diff --git a/benchmarks/basic_operations.py b/benchmarks/basic_operations.py
index c9f5853652..66cd6b320d 100644
--- a/benchmarks/basic_operations.py
+++ b/benchmarks/basic_operations.py
@@ -54,7 +54,7 @@ def wrapper(*args, **kwargs):
             count = args[1]
         print(f"{func.__name__} - {count} Requests")
         print(f"Duration  = {duration}")
-        print(f"Rate = {count/duration}")
+        print(f"Rate = {count / duration}")
         print()
         return ret
 
diff --git a/benchmarks/command_packer_benchmark.py b/benchmarks/command_packer_benchmark.py
index e66dbbcbf9..4fb7196422 100644
--- a/benchmarks/command_packer_benchmark.py
+++ b/benchmarks/command_packer_benchmark.py
@@ -78,7 +78,6 @@ def pack_command(self, *args):
 
 
 class CommandPackerBenchmark(Benchmark):
-
     ARGUMENTS = (
         {
             "name": "connection_class",
diff --git a/benchmarks/socket_read_size.py b/benchmarks/socket_read_size.py
index 544c733178..37ffa97812 100644
--- a/benchmarks/socket_read_size.py
+++ b/benchmarks/socket_read_size.py
@@ -4,7 +4,6 @@
 
 
 class SocketReadBenchmark(Benchmark):
-
     ARGUMENTS = (
         {"name": "parser", "values": [PythonParser, _HiredisParser]},
         {
diff --git a/dev_requirements.txt b/dev_requirements.txt
index 7ee7ac2b75..11797c98e5 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -1,9 +1,5 @@
 build
-black==24.3.0
 click==8.0.4
-flake8-isort
-flake8
-flynt~=0.69.0
 invoke==2.2.0
 mock
 packaging>=20.4
@@ -12,6 +8,7 @@ pytest-asyncio>=0.23.0,<0.24.0
 pytest-cov
 pytest-profiling==1.8.1
 pytest-timeout
+ruff==0.9.6
 ujson>=4.2.0
 uvloop
 vulture>=2.3.0
diff --git a/doctests/README.md b/doctests/README.md
index 15664f1bcd..b5deff7ff3 100644
--- a/doctests/README.md
+++ b/doctests/README.md
@@ -21,8 +21,8 @@ pip uninstall -y redis  # uninstall Redis package installed via redis-entraid
 pip install -r doctests/requirements.txt
 ```
 
-Note - the CI process, runs the basic ```black``` and ```isort``` linters against the examples. Assuming
-the requirements above have been installed you can run ```black yourfile.py``` and ```isort yourfile.py```
+Note - the CI process, runs linters against the examples. Assuming
+the requirements above have been installed you can run ```ruff check yourfile.py``` and ```ruff format yourfile.py```
 locally to validate the linting, prior to CI.
 
 Just include necessary assertions in the example file and run
diff --git a/pyproject.toml b/pyproject.toml
index 0ec38ed3b1..0ab1b61bb8 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -96,3 +96,53 @@ filterwarnings = [
     # Ignore a coverage warning when COVERAGE_CORE=sysmon for Pythons < 3.12.
     "ignore:sys.monitoring isn't available:coverage.exceptions.CoverageWarning",
 ]
+
+[tool.ruff]
+target-version = "py38"
+line-length = 88
+exclude = [
+    "*.egg-info",
+    "*.pyc",
+    ".git",
+    ".venv*",
+    "build",
+    "dist",
+    "docker",
+    "docs/*",
+    "doctests/*",
+    "tasks.py",
+    "venv*",
+    "whitelist.py",
+]
+
+[tool.ruff.lint]
+ignore = [
+    "E501",  # line too long (taken care of with ruff format)
+    "E741",  # ambiguous variable name
+    "N818",  # Errors should have Error suffix
+]
+
+select = [
+    "E",
+    "F",
+    "FLY",
+    "I",
+    "N",
+    "W",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"redis/commands/bf/*" = [
+    # the `bf` module uses star imports, so this is required there.
+    "F405",  # name may be undefined, or defined from star imports
+]
+"redis/commands/{bf,timeseries,json,search}/*" = [
+    "N",
+]
+"tests/*" = [
+    "I",  # TODO: could be enabled, plenty of changes
+    "N801",  # class name should use CapWords convention
+    "N803",  # argument name should be lowercase
+    "N802",  # function name should be lowercase
+    "N806",  # variable name should be lowercase
+]
diff --git a/redis/_parsers/base.py b/redis/_parsers/base.py
index 91a4f74199..ebc8313ce7 100644
--- a/redis/_parsers/base.py
+++ b/redis/_parsers/base.py
@@ -32,9 +32,9 @@
 from .encoders import Encoder
 from .socket import SERVER_CLOSED_CONNECTION_ERROR, SocketBuffer
 
-MODULE_LOAD_ERROR = "Error loading the extension. " "Please check the server logs."
+MODULE_LOAD_ERROR = "Error loading the extension. Please check the server logs."
 NO_SUCH_MODULE_ERROR = "Error unloading module: no such module with that name"
-MODULE_UNLOAD_NOT_POSSIBLE_ERROR = "Error unloading module: operation not " "possible."
+MODULE_UNLOAD_NOT_POSSIBLE_ERROR = "Error unloading module: operation not possible."
 MODULE_EXPORTS_DATA_TYPES_ERROR = (
     "Error unloading module: the module "
     "exports one or more module-side data "
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 87a2c16afa..f343e26b75 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -1154,9 +1154,7 @@ def get_node(
             return self.nodes_cache.get(node_name)
         else:
             raise DataError(
-                "get_node requires one of the following: "
-                "1. node name "
-                "2. host and port"
+                "get_node requires one of the following: 1. node name 2. host and port"
             )
 
     def set_nodes(
@@ -1338,7 +1336,7 @@ async def initialize(self) -> None:
                             if len(disagreements) > 5:
                                 raise RedisClusterException(
                                     f"startup_nodes could not agree on a valid "
-                                    f'slots cache: {", ".join(disagreements)}'
+                                    f"slots cache: {', '.join(disagreements)}"
                                 )
 
             # Validate if all slots are covered or if we should try next startup node
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 2e2a2502c3..9b5d0d8eb9 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -842,7 +842,7 @@ def __init__(
         if cert_reqs is None:
             self.cert_reqs = ssl.CERT_NONE
         elif isinstance(cert_reqs, str):
-            CERT_REQS = {
+            CERT_REQS = {  # noqa: N806
                 "none": ssl.CERT_NONE,
                 "optional": ssl.CERT_OPTIONAL,
                 "required": ssl.CERT_REQUIRED,
diff --git a/redis/asyncio/utils.py b/redis/asyncio/utils.py
index 5a55b36a33..fa014514ec 100644
--- a/redis/asyncio/utils.py
+++ b/redis/asyncio/utils.py
@@ -16,7 +16,7 @@ def from_url(url, **kwargs):
     return Redis.from_url(url, **kwargs)
 
 
-class pipeline:
+class pipeline:  # noqa: N801
     def __init__(self, redis_obj: "Redis"):
         self.p: "Pipeline" = redis_obj.pipeline()
 
diff --git a/redis/auth/token.py b/redis/auth/token.py
index 1c5246469b..1f613aff5f 100644
--- a/redis/auth/token.py
+++ b/redis/auth/token.py
@@ -76,7 +76,6 @@ def get_received_at_ms(self) -> float:
 
 
 class JWToken(TokenInterface):
-
     REQUIRED_FIELDS = {"exp"}
 
     def __init__(self, token: str):
diff --git a/redis/client.py b/redis/client.py
index fc535c8ca0..2bacbe14ac 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1514,8 +1514,7 @@ def raise_first_error(self, commands, response):
     def annotate_exception(self, exception, number, command):
         cmd = " ".join(map(safe_str, command))
         msg = (
-            f"Command # {number} ({cmd}) of pipeline "
-            f"caused error: {exception.args[0]}"
+            f"Command # {number} ({cmd}) of pipeline caused error: {exception.args[0]}"
         )
         exception.args = (msg,) + exception.args[1:]
 
diff --git a/redis/cluster.py b/redis/cluster.py
index f518a1f184..ef4500f895 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -1628,7 +1628,7 @@ def initialize(self):
                             if len(disagreements) > 5:
                                 raise RedisClusterException(
                                     f"startup_nodes could not agree on a valid "
-                                    f'slots cache: {", ".join(disagreements)}'
+                                    f"slots cache: {', '.join(disagreements)}"
                                 )
 
             fully_covered = self.check_slots_coverage(tmp_slots)
@@ -2047,8 +2047,7 @@ def annotate_exception(self, exception, number, command):
         """
         cmd = " ".join(map(safe_str, command))
         msg = (
-            f"Command # {number} ({cmd}) of pipeline "
-            f"caused error: {exception.args[0]}"
+            f"Command # {number} ({cmd}) of pipeline caused error: {exception.args[0]}"
         )
         exception.args = (msg,) + exception.args[1:]
 
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index f31b88bc4e..f0b65612e0 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -595,7 +595,7 @@ def cluster_setslot(
                 "CLUSTER SETSLOT", slot_id, state, node_id, target_nodes=target_node
             )
         elif state.upper() == "STABLE":
-            raise RedisError('For "stable" state please use ' "cluster_setslot_stable")
+            raise RedisError('For "stable" state please use cluster_setslot_stable')
         else:
             raise RedisError(f"Invalid slot state: {state}")
 
diff --git a/redis/commands/core.py b/redis/commands/core.py
index c3ffb955c4..b0e5dc6794 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3415,7 +3415,9 @@ def smembers(self, name: str) -> Union[Awaitable[Set], Set]:
         """
         return self.execute_command("SMEMBERS", name, keys=[name])
 
-    def smismember(self, name: str, values: List, *args: List) -> Union[
+    def smismember(
+        self, name: str, values: List, *args: List
+    ) -> Union[
         Awaitable[List[Union[Literal[0], Literal[1]]]],
         List[Union[Literal[0], Literal[1]]],
     ]:
@@ -4162,8 +4164,7 @@ def zadd(
             raise DataError("ZADD allows either 'gt' or 'lt', not both")
         if incr and len(mapping) != 1:
             raise DataError(
-                "ZADD option 'incr' only works when passing a "
-                "single element/score pair"
+                "ZADD option 'incr' only works when passing a single element/score pair"
             )
         if nx and (gt or lt):
             raise DataError("Only one of 'nx', 'lt', or 'gr' may be defined.")
diff --git a/redis/commands/graph/commands.py b/redis/commands/graph/commands.py
index d92018f731..1e41a5fb1f 100644
--- a/redis/commands/graph/commands.py
+++ b/redis/commands/graph/commands.py
@@ -171,9 +171,7 @@ def config(self, name, value=None, set=False):
             if set:
                 params.append(value)
             else:
-                raise DataError(
-                    "``value`` can be provided only when ``set`` is True"
-                )  # noqa
+                raise DataError("``value`` can be provided only when ``set`` is True")  # noqa
         return self.execute_command(CONFIG_CMD, *params)
 
     def list_keys(self):
diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
index 7d9095ea41..e11d34fb71 100644
--- a/redis/commands/helpers.py
+++ b/redis/commands/helpers.py
@@ -138,9 +138,9 @@ def stringify_param_value(value):
     elif value is None:
         return "null"
     elif isinstance(value, (list, tuple)):
-        return f'[{",".join(map(stringify_param_value, value))}]'
+        return f"[{','.join(map(stringify_param_value, value))}]"
     elif isinstance(value, dict):
-        return f'{{{",".join(f"{k}:{stringify_param_value(v)}" for k, v in value.items())}}}'  # noqa
+        return f"{{{','.join(f'{k}:{stringify_param_value(v)}' for k, v in value.items())}}}"  # noqa
     else:
         return str(value)
 
diff --git a/redis/connection.py b/redis/connection.py
index 2391e74d2c..43501800c8 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -622,9 +622,7 @@ def read_response(
         except OSError as e:
             if disconnect_on_error:
                 self.disconnect()
-            raise ConnectionError(
-                f"Error while reading from {host_error}" f" : {e.args}"
-            )
+            raise ConnectionError(f"Error while reading from {host_error} : {e.args}")
         except BaseException:
             # Also by default close in case of BaseException.  A lot of code
             # relies on this behaviour when doing Command/Response pairs.
@@ -1040,7 +1038,7 @@ def __init__(
         if ssl_cert_reqs is None:
             ssl_cert_reqs = ssl.CERT_NONE
         elif isinstance(ssl_cert_reqs, str):
-            CERT_REQS = {
+            CERT_REQS = {  # noqa: N806
                 "none": ssl.CERT_NONE,
                 "optional": ssl.CERT_OPTIONAL,
                 "required": ssl.CERT_REQUIRED,
diff --git a/redis/exceptions.py b/redis/exceptions.py
index dcc06774b0..82f62730ab 100644
--- a/redis/exceptions.py
+++ b/redis/exceptions.py
@@ -79,6 +79,7 @@ class ModuleError(ResponseError):
 
 class LockError(RedisError, ValueError):
     "Errors acquiring or releasing a lock"
+
     # NOTE: For backwards compatibility, this class derives from ValueError.
     # This was originally chosen to behave like threading.Lock.
 
@@ -89,11 +90,13 @@ def __init__(self, message=None, lock_name=None):
 
 class LockNotOwnedError(LockError):
     "Error trying to extend or release a lock that is (no longer) owned"
+
     pass
 
 
 class ChildDeadlockedError(Exception):
     "Error indicating that a child process is deadlocked after a fork()"
+
     pass
 
 
diff --git a/redis/ocsp.py b/redis/ocsp.py
index 8819848fa9..d69c914dee 100644
--- a/redis/ocsp.py
+++ b/redis/ocsp.py
@@ -15,6 +15,7 @@
 from cryptography.hazmat.primitives.hashes import SHA1, Hash
 from cryptography.hazmat.primitives.serialization import Encoding, PublicFormat
 from cryptography.x509 import ocsp
+
 from redis.exceptions import AuthorizationError, ConnectionError
 
 
@@ -56,7 +57,7 @@ def _check_certificate(issuer_cert, ocsp_bytes, validate=True):
     if ocsp_response.response_status == ocsp.OCSPResponseStatus.SUCCESSFUL:
         if ocsp_response.certificate_status != ocsp.OCSPCertStatus.GOOD:
             raise ConnectionError(
-                f'Received an {str(ocsp_response.certificate_status).split(".")[1]} '
+                f"Received an {str(ocsp_response.certificate_status).split('.')[1]} "
                 "ocsp certificate status"
             )
     else:
diff --git a/redis/sentinel.py b/redis/sentinel.py
index 01e210794c..521ac24142 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -273,7 +273,7 @@ def __repr__(self):
             )
         return (
             f"<{type(self).__module__}.{type(self).__name__}"
-            f'(sentinels=[{",".join(sentinel_addresses)}])>'
+            f"(sentinels=[{','.join(sentinel_addresses)}])>"
         )
 
     def check_master_state(self, state, service_name):
diff --git a/tasks.py b/tasks.py
index 8a5cae97b2..2d1a073437 100644
--- a/tasks.py
+++ b/tasks.py
@@ -27,11 +27,9 @@ def build_docs(c):
 @task
 def linters(c):
     """Run code linters"""
-    run("flake8 tests redis")
-    run("black --target-version py37 --check --diff tests redis")
-    run("isort --check-only --diff tests redis")
+    run("ruff check tests redis")
+    run("ruff format --check --diff tests redis")
     run("vulture redis whitelist.py --min-confidence 80")
-    run("flynt --fail-on-change --dry-run tests redis")
 
 
 @task
diff --git a/tests/conftest.py b/tests/conftest.py
index e5eea4d582..c485d626ca 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -646,7 +646,7 @@ def wait_for_command(client, monitor, command, key=None):
         if Version(redis_version) >= Version("5.0.0"):
             id_str = str(client.client_id())
         else:
-            id_str = f"{random.randrange(2 ** 32):08x}"
+            id_str = f"{random.randrange(2**32):08x}"
         key = f"__REDIS-PY-{id_str}__"
     client.get(key)
     while True:
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index 226b00aa45..60e447e6fd 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -242,7 +242,7 @@ async def wait_for_command(
         if Version(redis_version) >= Version("5.0.0"):
             id_str = str(await client.client_id())
         else:
-            id_str = f"{random.randrange(2 ** 32):08x}"
+            id_str = f"{random.randrange(2**32):08x}"
         key = f"__REDIS-PY-{id_str}__"
     await client.get(key)
     while True:
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index c95babf687..9911eced27 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -146,7 +146,6 @@ async def get_mocked_redis_client(
     with mock.patch.object(ClusterNode, "execute_command") as execute_command_mock:
 
         async def execute_command(*_args, **_kwargs):
-
             if _args[0] == "CLUSTER SLOTS":
                 if cluster_slots_raise_error:
                     raise ResponseError()
@@ -1577,7 +1576,7 @@ async def test_cluster_bitop_not_empty_string(self, r: RedisCluster) -> None:
 
     @skip_if_server_version_lt("2.6.0")
     async def test_cluster_bitop_not(self, r: RedisCluster) -> None:
-        test_str = b"\xAA\x00\xFF\x55"
+        test_str = b"\xaa\x00\xff\x55"
         correct = ~0xAA00FF55 & 0xFFFFFFFF
         await r.set("{foo}a", test_str)
         await r.bitop("not", "{foo}r", "{foo}a")
@@ -1585,7 +1584,7 @@ async def test_cluster_bitop_not(self, r: RedisCluster) -> None:
 
     @skip_if_server_version_lt("2.6.0")
     async def test_cluster_bitop_not_in_place(self, r: RedisCluster) -> None:
-        test_str = b"\xAA\x00\xFF\x55"
+        test_str = b"\xaa\x00\xff\x55"
         correct = ~0xAA00FF55 & 0xFFFFFFFF
         await r.set("{foo}a", test_str)
         await r.bitop("not", "{foo}a", "{foo}a")
@@ -1593,7 +1592,7 @@ async def test_cluster_bitop_not_in_place(self, r: RedisCluster) -> None:
 
     @skip_if_server_version_lt("2.6.0")
     async def test_cluster_bitop_single_string(self, r: RedisCluster) -> None:
-        test_str = b"\x01\x02\xFF"
+        test_str = b"\x01\x02\xff"
         await r.set("{foo}a", test_str)
         await r.bitop("and", "{foo}res1", "{foo}a")
         await r.bitop("or", "{foo}res2", "{foo}a")
@@ -1604,8 +1603,8 @@ async def test_cluster_bitop_single_string(self, r: RedisCluster) -> None:
 
     @skip_if_server_version_lt("2.6.0")
     async def test_cluster_bitop_string_operands(self, r: RedisCluster) -> None:
-        await r.set("{foo}a", b"\x01\x02\xFF\xFF")
-        await r.set("{foo}b", b"\x01\x02\xFF")
+        await r.set("{foo}a", b"\x01\x02\xff\xff")
+        await r.set("{foo}b", b"\x01\x02\xff")
         await r.bitop("and", "{foo}res1", "{foo}a", "{foo}b")
         await r.bitop("or", "{foo}res2", "{foo}a", "{foo}b")
         await r.bitop("xor", "{foo}res3", "{foo}a", "{foo}b")
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 9f154cb273..08bd5810f4 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -711,8 +711,9 @@ async def test_config_set_for_search_module(self, r: redis.Redis):
                 "search-default-dialect"
             ] == default_dialect_new
             assert (
-                (await r.ft().config_get("*"))[b"DEFAULT_DIALECT"]
-            ).decode() == default_dialect_new
+                ((await r.ft().config_get("*"))[b"DEFAULT_DIALECT"]).decode()
+                == default_dialect_new
+            )
         except AssertionError as ex:
             raise ex
         finally:
@@ -844,7 +845,7 @@ async def test_bitop_not_empty_string(self, r: redis.Redis):
     @skip_if_server_version_lt("2.6.0")
     @pytest.mark.onlynoncluster
     async def test_bitop_not(self, r: redis.Redis):
-        test_str = b"\xAA\x00\xFF\x55"
+        test_str = b"\xaa\x00\xff\x55"
         correct = ~0xAA00FF55 & 0xFFFFFFFF
         await r.set("a", test_str)
         await r.bitop("not", "r", "a")
@@ -853,7 +854,7 @@ async def test_bitop_not(self, r: redis.Redis):
     @skip_if_server_version_lt("2.6.0")
     @pytest.mark.onlynoncluster
     async def test_bitop_not_in_place(self, r: redis.Redis):
-        test_str = b"\xAA\x00\xFF\x55"
+        test_str = b"\xaa\x00\xff\x55"
         correct = ~0xAA00FF55 & 0xFFFFFFFF
         await r.set("a", test_str)
         await r.bitop("not", "a", "a")
@@ -862,7 +863,7 @@ async def test_bitop_not_in_place(self, r: redis.Redis):
     @skip_if_server_version_lt("2.6.0")
     @pytest.mark.onlynoncluster
     async def test_bitop_single_string(self, r: redis.Redis):
-        test_str = b"\x01\x02\xFF"
+        test_str = b"\x01\x02\xff"
         await r.set("a", test_str)
         await r.bitop("and", "res1", "a")
         await r.bitop("or", "res2", "a")
@@ -874,8 +875,8 @@ async def test_bitop_single_string(self, r: redis.Redis):
     @skip_if_server_version_lt("2.6.0")
     @pytest.mark.onlynoncluster
     async def test_bitop_string_operands(self, r: redis.Redis):
-        await r.set("a", b"\x01\x02\xFF\xFF")
-        await r.set("b", b"\x01\x02\xFF")
+        await r.set("a", b"\x01\x02\xff\xff")
+        await r.set("b", b"\x01\x02\xff")
         await r.bitop("and", "res1", "a", "b")
         await r.bitop("or", "res2", "a", "b")
         await r.bitop("xor", "res3", "a", "b")
diff --git a/tests/test_asyncio/test_graph.py b/tests/test_asyncio/test_graph.py
index 2a506d5e22..7b823265c3 100644
--- a/tests/test_asyncio/test_graph.py
+++ b/tests/test_asyncio/test_graph.py
@@ -44,8 +44,7 @@ async def test_graph_creation(decoded_r: redis.Redis):
     await graph.commit()
 
     query = (
-        'MATCH (p:person)-[v:visited {purpose:"pleasure"}]->(c:country) '
-        "RETURN p, v, c"
+        'MATCH (p:person)-[v:visited {purpose:"pleasure"}]->(c:country) RETURN p, v, c'
     )
 
     result = await graph.query(query)
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index c0efcce882..c55d57f3b2 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -1797,10 +1797,10 @@ async def test_binary_and_text_fields(decoded_r: redis.Redis):
         docs[0]["vector_emb"], dtype=np.float32
     )
 
-    assert np.array_equal(
-        decoded_vec_from_search_results, fake_vec
-    ), "The vectors are not equal"
+    assert np.array_equal(decoded_vec_from_search_results, fake_vec), (
+        "The vectors are not equal"
+    )
 
-    assert (
-        docs[0]["first_name"] == mixed_data["first_name"]
-    ), "The text field is not decoded correctly"
+    assert docs[0]["first_name"] == mixed_data["first_name"], (
+        "The text field is not decoded correctly"
+    )
diff --git a/tests/test_auth/test_token.py b/tests/test_auth/test_token.py
index 2d72e08895..97633e38e7 100644
--- a/tests/test_auth/test_token.py
+++ b/tests/test_auth/test_token.py
@@ -6,7 +6,6 @@
 
 
 class TestToken:
-
     def test_simple_token(self):
         token = SimpleToken(
             "value",
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 908ac26211..bec9a8ecb0 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -1692,7 +1692,7 @@ def test_cluster_bitop_not_empty_string(self, r):
 
     @skip_if_server_version_lt("2.6.0")
     def test_cluster_bitop_not(self, r):
-        test_str = b"\xAA\x00\xFF\x55"
+        test_str = b"\xaa\x00\xff\x55"
         correct = ~0xAA00FF55 & 0xFFFFFFFF
         r["{foo}a"] = test_str
         r.bitop("not", "{foo}r", "{foo}a")
@@ -1700,7 +1700,7 @@ def test_cluster_bitop_not(self, r):
 
     @skip_if_server_version_lt("2.6.0")
     def test_cluster_bitop_not_in_place(self, r):
-        test_str = b"\xAA\x00\xFF\x55"
+        test_str = b"\xaa\x00\xff\x55"
         correct = ~0xAA00FF55 & 0xFFFFFFFF
         r["{foo}a"] = test_str
         r.bitop("not", "{foo}a", "{foo}a")
@@ -1708,7 +1708,7 @@ def test_cluster_bitop_not_in_place(self, r):
 
     @skip_if_server_version_lt("2.6.0")
     def test_cluster_bitop_single_string(self, r):
-        test_str = b"\x01\x02\xFF"
+        test_str = b"\x01\x02\xff"
         r["{foo}a"] = test_str
         r.bitop("and", "{foo}res1", "{foo}a")
         r.bitop("or", "{foo}res2", "{foo}a")
@@ -1719,8 +1719,8 @@ def test_cluster_bitop_single_string(self, r):
 
     @skip_if_server_version_lt("2.6.0")
     def test_cluster_bitop_string_operands(self, r):
-        r["{foo}a"] = b"\x01\x02\xFF\xFF"
-        r["{foo}b"] = b"\x01\x02\xFF"
+        r["{foo}a"] = b"\x01\x02\xff\xff"
+        r["{foo}b"] = b"\x01\x02\xff"
         r.bitop("and", "{foo}res1", "{foo}a", "{foo}b")
         r.bitop("or", "{foo}res2", "{foo}a", "{foo}b")
         r.bitop("xor", "{foo}res3", "{foo}a", "{foo}b")
diff --git a/tests/test_commands.py b/tests/test_commands.py
index b6f13f6aa8..c6e39f565d 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1025,8 +1025,9 @@ def test_config_set_for_search_module(self, r: redis.Redis):
             assert r.config_set("search-default-dialect", default_dialect_new)
             assert r.config_get("*")["search-default-dialect"] == default_dialect_new
             assert (
-                r.ft().config_get("*")[b"DEFAULT_DIALECT"]
-            ).decode() == default_dialect_new
+                (r.ft().config_get("*")[b"DEFAULT_DIALECT"]).decode()
+                == default_dialect_new
+            )
         except AssertionError as ex:
             raise ex
         finally:
@@ -1268,7 +1269,7 @@ def test_bitop_not_empty_string(self, r):
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.6.0")
     def test_bitop_not(self, r):
-        test_str = b"\xAA\x00\xFF\x55"
+        test_str = b"\xaa\x00\xff\x55"
         correct = ~0xAA00FF55 & 0xFFFFFFFF
         r["a"] = test_str
         r.bitop("not", "r", "a")
@@ -1277,7 +1278,7 @@ def test_bitop_not(self, r):
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.6.0")
     def test_bitop_not_in_place(self, r):
-        test_str = b"\xAA\x00\xFF\x55"
+        test_str = b"\xaa\x00\xff\x55"
         correct = ~0xAA00FF55 & 0xFFFFFFFF
         r["a"] = test_str
         r.bitop("not", "a", "a")
@@ -1286,7 +1287,7 @@ def test_bitop_not_in_place(self, r):
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.6.0")
     def test_bitop_single_string(self, r):
-        test_str = b"\x01\x02\xFF"
+        test_str = b"\x01\x02\xff"
         r["a"] = test_str
         r.bitop("and", "res1", "a")
         r.bitop("or", "res2", "a")
@@ -1298,8 +1299,8 @@ def test_bitop_single_string(self, r):
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.6.0")
     def test_bitop_string_operands(self, r):
-        r["a"] = b"\x01\x02\xFF\xFF"
-        r["b"] = b"\x01\x02\xFF"
+        r["a"] = b"\x01\x02\xff\xff"
+        r["b"] = b"\x01\x02\xff"
         r.bitop("and", "res1", "a", "b")
         r.bitop("or", "res2", "a", "b")
         r.bitop("xor", "res3", "a", "b")
diff --git a/tests/test_connection.py b/tests/test_connection.py
index 6c1498a329..9664146ce5 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -362,7 +362,6 @@ def test_unix_socket_connection_failure():
 
 
 class TestUnitConnectionPool:
-
     @pytest.mark.parametrize(
         "max_conn", (-1, "str"), ids=("non-positive", "wrong type")
     )
diff --git a/tests/test_graph.py b/tests/test_graph.py
index efb10dada7..fd08385667 100644
--- a/tests/test_graph.py
+++ b/tests/test_graph.py
@@ -73,8 +73,7 @@ def test_graph_creation(client):
     graph.commit()
 
     query = (
-        'MATCH (p:person)-[v:visited {purpose:"pleasure"}]->(c:country) '
-        "RETURN p, v, c"
+        'MATCH (p:person)-[v:visited {purpose:"pleasure"}]->(c:country) RETURN p, v, c'
     )
 
     result = graph.query(query)
diff --git a/tests/test_search.py b/tests/test_search.py
index c4598f3773..11f22ac805 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1919,13 +1919,13 @@ def test_binary_and_text_fields(client):
         docs[0]["vector_emb"], dtype=np.float32
     )
 
-    assert np.array_equal(
-        decoded_vec_from_search_results, fake_vec
-    ), "The vectors are not equal"
+    assert np.array_equal(decoded_vec_from_search_results, fake_vec), (
+        "The vectors are not equal"
+    )
 
-    assert (
-        docs[0]["first_name"] == mixed_data["first_name"]
-    ), "The text field is not decoded correctly"
+    assert docs[0]["first_name"] == mixed_data["first_name"], (
+        "The text field is not decoded correctly"
+    )
 
 
 @pytest.mark.redismod

From 8314b7f62f2be83f216eb9fc9c3224ed0ee2e3fb Mon Sep 17 00:00:00 2001
From: Neil Bertram <neil@catalyst.net.nz>
Date: Thu, 6 Mar 2025 20:52:15 +1300
Subject: [PATCH 0998/1164] Correct the typedef of lock.extend() to accept
 floats, and test that float TTLs are honoured precisely (#3420)

---
 CHANGES                         | 1 +
 redis/asyncio/lock.py           | 7 ++++---
 tests/test_asyncio/test_lock.py | 9 +++++----
 tests/test_lock.py              | 9 +++++----
 4 files changed, 15 insertions(+), 11 deletions(-)

diff --git a/CHANGES b/CHANGES
index bd96846b6d..031d909f23 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Fix lock.extend() typedef to accept float TTL extension
     * Update URL in the readme linking to Redis University
     * Move doctests (doc code examples) to main branch
     * Update `ResponseT` type hint
diff --git a/redis/asyncio/lock.py b/redis/asyncio/lock.py
index bb2cccab52..f70a8d09ab 100644
--- a/redis/asyncio/lock.py
+++ b/redis/asyncio/lock.py
@@ -5,6 +5,7 @@
 from typing import TYPE_CHECKING, Awaitable, Optional, Union
 
 from redis.exceptions import LockError, LockNotOwnedError
+from redis.typing import Number
 
 if TYPE_CHECKING:
     from redis.asyncio import Redis, RedisCluster
@@ -82,7 +83,7 @@ def __init__(
         timeout: Optional[float] = None,
         sleep: float = 0.1,
         blocking: bool = True,
-        blocking_timeout: Optional[float] = None,
+        blocking_timeout: Optional[Number] = None,
         thread_local: bool = True,
     ):
         """
@@ -167,7 +168,7 @@ async def __aexit__(self, exc_type, exc_value, traceback):
     async def acquire(
         self,
         blocking: Optional[bool] = None,
-        blocking_timeout: Optional[float] = None,
+        blocking_timeout: Optional[Number] = None,
         token: Optional[Union[str, bytes]] = None,
     ):
         """
@@ -265,7 +266,7 @@ async def do_release(self, expected_token: bytes) -> None:
             raise LockNotOwnedError("Cannot release a lock that's no longer owned")
 
     def extend(
-        self, additional_time: float, replace_ttl: bool = False
+        self, additional_time: Number, replace_ttl: bool = False
     ) -> Awaitable[bool]:
         """
         Adds more time to an already acquired lock.
diff --git a/tests/test_asyncio/test_lock.py b/tests/test_asyncio/test_lock.py
index 033a8b7467..9973ef701f 100644
--- a/tests/test_asyncio/test_lock.py
+++ b/tests/test_asyncio/test_lock.py
@@ -174,11 +174,12 @@ async def test_extend_lock_replace_ttl(self, r):
         await lock.release()
 
     async def test_extend_lock_float(self, r):
-        lock = self.get_lock(r, "foo", timeout=10.0)
+        lock = self.get_lock(r, "foo", timeout=10.5)
         assert await lock.acquire(blocking=False)
-        assert 8000 < (await r.pttl("foo")) <= 10000
-        assert await lock.extend(10.0)
-        assert 16000 < (await r.pttl("foo")) <= 20000
+        assert 10400 < (await r.pttl("foo")) <= 10500
+        old_ttl = await r.pttl("foo")
+        assert await lock.extend(10.5)
+        assert old_ttl + 10400 < (await r.pttl("foo")) <= old_ttl + 10500
         await lock.release()
 
     async def test_extending_unlocked_lock_raises_error(self, r):
diff --git a/tests/test_lock.py b/tests/test_lock.py
index d77ff9717a..136c86e459 100644
--- a/tests/test_lock.py
+++ b/tests/test_lock.py
@@ -178,11 +178,12 @@ def test_extend_lock_replace_ttl(self, r):
         lock.release()
 
     def test_extend_lock_float(self, r):
-        lock = self.get_lock(r, "foo", timeout=10.0)
+        lock = self.get_lock(r, "foo", timeout=10.5)
         assert lock.acquire(blocking=False)
-        assert 8000 < r.pttl("foo") <= 10000
-        assert lock.extend(10.0)
-        assert 16000 < r.pttl("foo") <= 20000
+        assert 10400 < r.pttl("foo") <= 10500
+        old_ttl = r.pttl("foo")
+        assert lock.extend(10.5)
+        assert old_ttl + 10400 < r.pttl("foo") <= old_ttl + 10500
         lock.release()
 
     def test_extending_unlocked_lock_raises_error(self, r):

From b8ba39178b71895f4579b6be23c4582445ef04ed Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 6 Mar 2025 11:03:52 +0200
Subject: [PATCH 0999/1164] Removing deprecated usage of
 forbid_global_loop=True in pytest.mark.asyncio decorator (#3542)

---
 dev_requirements.txt                 |  2 +-
 pyproject.toml                       |  1 +
 tests/test_asyncio/test_scripting.py | 16 ++++++++--------
 3 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/dev_requirements.txt b/dev_requirements.txt
index 11797c98e5..2a0938bec3 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -4,7 +4,7 @@ invoke==2.2.0
 mock
 packaging>=20.4
 pytest
-pytest-asyncio>=0.23.0,<0.24.0
+pytest-asyncio>=0.23.0
 pytest-cov
 pytest-profiling==1.8.1
 pytest-timeout
diff --git a/pyproject.toml b/pyproject.toml
index 0ab1b61bb8..22f18bb1ae 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -88,6 +88,7 @@ markers = [
     "experimental: run only experimental tests",
     "cp_integration: credential provider integration tests",
 ]
+asyncio_default_fixture_loop_scope = "function"
 asyncio_mode = "auto"
 timeout = 30
 filterwarnings = [
diff --git a/tests/test_asyncio/test_scripting.py b/tests/test_asyncio/test_scripting.py
index 8375ecd787..b8e100c04a 100644
--- a/tests/test_asyncio/test_scripting.py
+++ b/tests/test_asyncio/test_scripting.py
@@ -28,14 +28,14 @@ async def r(self, create_redis):
         yield redis
         await redis.script_flush()
 
-    @pytest.mark.asyncio(forbid_global_loop=True)
+    @pytest.mark.asyncio()
     async def test_eval(self, r):
         await r.flushdb()
         await r.set("a", 2)
         # 2 * 3 == 6
         assert await r.eval(multiply_script, 1, "a", 3) == 6
 
-    @pytest.mark.asyncio(forbid_global_loop=True)
+    @pytest.mark.asyncio()
     @skip_if_server_version_lt("6.2.0")
     async def test_script_flush(self, r):
         await r.set("a", 2)
@@ -55,14 +55,14 @@ async def test_script_flush(self, r):
             await r.script_load(multiply_script)
             await r.script_flush("NOTREAL")
 
-    @pytest.mark.asyncio(forbid_global_loop=True)
+    @pytest.mark.asyncio()
     async def test_evalsha(self, r):
         await r.set("a", 2)
         sha = await r.script_load(multiply_script)
         # 2 * 3 == 6
         assert await r.evalsha(sha, 1, "a", 3) == 6
 
-    @pytest.mark.asyncio(forbid_global_loop=True)
+    @pytest.mark.asyncio()
     async def test_evalsha_script_not_loaded(self, r):
         await r.set("a", 2)
         sha = await r.script_load(multiply_script)
@@ -71,7 +71,7 @@ async def test_evalsha_script_not_loaded(self, r):
         with pytest.raises(exceptions.NoScriptError):
             await r.evalsha(sha, 1, "a", 3)
 
-    @pytest.mark.asyncio(forbid_global_loop=True)
+    @pytest.mark.asyncio()
     async def test_script_loading(self, r):
         # get the sha, then clear the cache
         sha = await r.script_load(multiply_script)
@@ -80,7 +80,7 @@ async def test_script_loading(self, r):
         await r.script_load(multiply_script)
         assert await r.script_exists(sha) == [True]
 
-    @pytest.mark.asyncio(forbid_global_loop=True)
+    @pytest.mark.asyncio()
     async def test_script_object(self, r):
         await r.script_flush()
         await r.set("a", 2)
@@ -97,7 +97,7 @@ async def test_script_object(self, r):
         # Test first evalsha block
         assert await multiply(keys=["a"], args=[3]) == 6
 
-    @pytest.mark.asyncio(forbid_global_loop=True)
+    @pytest.mark.asyncio()
     async def test_script_object_in_pipeline(self, r):
         await r.script_flush()
         multiply = r.register_script(multiply_script)
@@ -127,7 +127,7 @@ async def test_script_object_in_pipeline(self, r):
         assert await pipe.execute() == [True, b"2", 6]
         assert await r.script_exists(multiply.sha) == [True]
 
-    @pytest.mark.asyncio(forbid_global_loop=True)
+    @pytest.mark.asyncio()
     async def test_eval_msgpack_pipeline_error_in_lua(self, r):
         msgpack_hello = r.register_script(msgpack_hello_script)
         assert msgpack_hello.sha

From 601c1aa4ac9e59c79998ed1b418c14292d435a73 Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Thu, 6 Mar 2025 13:23:58 +0200
Subject: [PATCH 1000/1164] (tests): Added testing for auth via
 DefaultAzureCredential (#3544)

* (tests): Added testing for auth via DefaultAzureCredential

* Added testing for async

* Remove unused import
---
 dev_requirements.txt                   |  2 +-
 tests/entraid_utils.py                 | 39 ++++++++++++++++++++++++--
 tests/test_asyncio/conftest.py         |  6 ----
 tests/test_asyncio/test_credentials.py | 13 +++++++--
 tests/test_credentials.py              | 13 +++++++--
 5 files changed, 59 insertions(+), 14 deletions(-)

diff --git a/dev_requirements.txt b/dev_requirements.txt
index 2a0938bec3..ad7330598d 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -13,4 +13,4 @@ ujson>=4.2.0
 uvloop
 vulture>=2.3.0
 numpy>=1.24.0
-redis-entraid==0.3.0b1
+redis-entraid==0.4.0b2
diff --git a/tests/entraid_utils.py b/tests/entraid_utils.py
index daefbd3956..529c3ccdee 100644
--- a/tests/entraid_utils.py
+++ b/tests/entraid_utils.py
@@ -19,6 +19,8 @@
     ServicePrincipalIdentityProviderConfig,
     _create_provider_from_managed_identity,
     _create_provider_from_service_principal,
+    DefaultAzureCredentialIdentityProviderConfig,
+    _create_provider_from_default_azure_credential,
 )
 from tests.conftest import mock_identity_provider
 
@@ -26,6 +28,7 @@
 class AuthType(Enum):
     MANAGED_IDENTITY = "managed_identity"
     SERVICE_PRINCIPAL = "service_principal"
+    DEFAULT_AZURE_CREDENTIAL = "default_azure_credential"
 
 
 def identity_provider(request) -> IdentityProviderInterface:
@@ -37,18 +40,25 @@ def identity_provider(request) -> IdentityProviderInterface:
     if request.param.get("mock_idp", None) is not None:
         return mock_identity_provider()
 
-    auth_type = kwargs.pop("auth_type", AuthType.SERVICE_PRINCIPAL)
+    auth_type = kwargs.get("auth_type", AuthType.SERVICE_PRINCIPAL)
     config = get_identity_provider_config(request=request)
 
-    if auth_type == "MANAGED_IDENTITY":
+    if auth_type == AuthType.MANAGED_IDENTITY:
         return _create_provider_from_managed_identity(config)
 
+    if auth_type == AuthType.DEFAULT_AZURE_CREDENTIAL:
+        return _create_provider_from_default_azure_credential(config)
+
     return _create_provider_from_service_principal(config)
 
 
 def get_identity_provider_config(
     request,
-) -> Union[ManagedIdentityProviderConfig, ServicePrincipalIdentityProviderConfig]:
+) -> Union[
+    ManagedIdentityProviderConfig,
+    ServicePrincipalIdentityProviderConfig,
+    DefaultAzureCredentialIdentityProviderConfig,
+]:
     if hasattr(request, "param"):
         kwargs = request.param.get("idp_kwargs", {})
     else:
@@ -59,6 +69,9 @@ def get_identity_provider_config(
     if auth_type == AuthType.MANAGED_IDENTITY:
         return _get_managed_identity_provider_config(request)
 
+    if auth_type == AuthType.DEFAULT_AZURE_CREDENTIAL:
+        return _get_default_azure_credential_provider_config(request)
+
     return _get_service_principal_provider_config(request)
 
 
@@ -114,6 +127,26 @@ def _get_service_principal_provider_config(
     )
 
 
+def _get_default_azure_credential_provider_config(
+    request,
+) -> DefaultAzureCredentialIdentityProviderConfig:
+    scopes = os.getenv("AZURE_REDIS_SCOPES", ())
+
+    if hasattr(request, "param"):
+        kwargs = request.param.get("idp_kwargs", {})
+        token_kwargs = request.param.get("token_kwargs", {})
+    else:
+        kwargs = {}
+        token_kwargs = {}
+
+    if isinstance(scopes, str):
+        scopes = scopes.split(",")
+
+    return DefaultAzureCredentialIdentityProviderConfig(
+        scopes=scopes, app_kwargs=kwargs, token_kwargs=token_kwargs
+    )
+
+
 def get_entra_id_credentials_provider(request, cred_provider_kwargs):
     idp = identity_provider(request)
     expiration_refresh_ratio = cred_provider_kwargs.get(
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index 60e447e6fd..340d146ea3 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -1,6 +1,5 @@
 import random
 from contextlib import asynccontextmanager as _asynccontextmanager
-from enum import Enum
 from typing import Union
 
 import pytest
@@ -18,11 +17,6 @@
 from .compat import mock
 
 
-class AuthType(Enum):
-    MANAGED_IDENTITY = "managed_identity"
-    SERVICE_PRINCIPAL = "service_principal"
-
-
 async def _get_info(redis_url):
     client = redis.Redis.from_url(redis_url)
     info = await client.info()
diff --git a/tests/test_asyncio/test_credentials.py b/tests/test_asyncio/test_credentials.py
index ce8d76ea45..b4824be469 100644
--- a/tests/test_asyncio/test_credentials.py
+++ b/tests/test_asyncio/test_credentials.py
@@ -18,6 +18,7 @@
 from redis.exceptions import ConnectionError
 from redis.utils import str_if_bytes
 from tests.conftest import get_endpoint, skip_if_redis_enterprise
+from tests.entraid_utils import AuthType
 from tests.test_asyncio.conftest import get_credential_provider
 
 try:
@@ -616,8 +617,12 @@ class TestEntraIdCredentialsProvider:
                 "cred_provider_class": EntraIdCredentialsProvider,
                 "cred_provider_kwargs": {"block_for_initial": True},
             },
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "idp_kwargs": {"auth_type": AuthType.DEFAULT_AZURE_CREDENTIAL},
+            },
         ],
-        ids=["blocked", "non-blocked"],
+        ids=["blocked", "non-blocked", "DefaultAzureCredential"],
         indirect=True,
     )
     @pytest.mark.asyncio
@@ -692,8 +697,12 @@ class TestClusterEntraIdCredentialsProvider:
                 "cred_provider_class": EntraIdCredentialsProvider,
                 "cred_provider_kwargs": {"block_for_initial": True},
             },
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "idp_kwargs": {"auth_type": AuthType.DEFAULT_AZURE_CREDENTIAL},
+            },
         ],
-        ids=["blocked", "non-blocked"],
+        ids=["blocked", "non-blocked", "DefaultAzureCredential"],
         indirect=True,
     )
     @pytest.mark.asyncio
diff --git a/tests/test_credentials.py b/tests/test_credentials.py
index 1f98c5208d..58bbd01f28 100644
--- a/tests/test_credentials.py
+++ b/tests/test_credentials.py
@@ -22,6 +22,7 @@
     get_endpoint,
     skip_if_redis_enterprise,
 )
+from tests.entraid_utils import AuthType
 
 try:
     from redis_entraid.cred_provider import EntraIdCredentialsProvider
@@ -585,8 +586,12 @@ class TestEntraIdCredentialsProvider:
                 "cred_provider_class": EntraIdCredentialsProvider,
                 "single_connection_client": True,
             },
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "idp_kwargs": {"auth_type": AuthType.DEFAULT_AZURE_CREDENTIAL},
+            },
         ],
-        ids=["pool", "single"],
+        ids=["pool", "single", "DefaultAzureCredential"],
         indirect=True,
     )
     @pytest.mark.onlynoncluster
@@ -656,8 +661,12 @@ class TestClusterEntraIdCredentialsProvider:
                 "cred_provider_class": EntraIdCredentialsProvider,
                 "single_connection_client": True,
             },
+            {
+                "cred_provider_class": EntraIdCredentialsProvider,
+                "idp_kwargs": {"auth_type": AuthType.DEFAULT_AZURE_CREDENTIAL},
+            },
         ],
-        ids=["pool", "single"],
+        ids=["pool", "single", "DefaultAzureCredential"],
         indirect=True,
     )
     @pytest.mark.onlycluster

From 187d8001f41989d7e0ace57bfcd7ff2366b5dfb3 Mon Sep 17 00:00:00 2001
From: "Edmund L. Wong" <bacchuswng@gmail.com>
Date: Mon, 10 Mar 2025 01:11:11 -0700
Subject: [PATCH 1001/1164] Fix AttributeError when client.get_default_node()
 returns None (#3458)

---
 redis/asyncio/cluster.py | 30 ++++++++++++++++++------------
 1 file changed, 18 insertions(+), 12 deletions(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index f343e26b75..11d3f093f7 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -1597,18 +1597,24 @@ async def _execute(
                         result.args = (msg,) + result.args[1:]
                         raise result
 
-            default_node = nodes.get(client.get_default_node().name)
-            if default_node is not None:
-                # This pipeline execution used the default node, check if we need
-                # to replace it.
-                # Note: when the error is raised we'll reset the default node in the
-                # caller function.
-                for cmd in default_node[1]:
-                    # Check if it has a command that failed with a relevant
-                    # exception
-                    if type(cmd.result) in self.__class__.ERRORS_ALLOW_RETRY:
-                        client.replace_default_node()
-                        break
+            default_cluster_node = client.get_default_node()
+
+            # Check whether the default node was used. In some cases,
+            # 'client.get_default_node()' may return None. The check below
+            # prevents a potential AttributeError.
+            if default_cluster_node is not None:
+                default_node = nodes.get(default_cluster_node.name)
+                if default_node is not None:
+                    # This pipeline execution used the default node, check if we need
+                    # to replace it.
+                    # Note: when the error is raised we'll reset the default node in the
+                    # caller function.
+                    for cmd in default_node[1]:
+                        # Check if it has a command that failed with a relevant
+                        # exception
+                        if type(cmd.result) in self.__class__.ERRORS_ALLOW_RETRY:
+                            client.replace_default_node()
+                            break
 
         return [cmd.result for cmd in stack]
 

From 50943e05b058267c129660b1b4ce77868e36f29f Mon Sep 17 00:00:00 2001
From: Juliano Amadeu <65794514+julianolm@users.noreply.github.com>
Date: Mon, 10 Mar 2025 06:55:57 -0300
Subject: [PATCH 1002/1164] feat: adds option not to raise exception when
 leaving context manager after lock expiration (#3531)

* adds option not to raise when leaving context manager after lock expiration

* keep oroginal traceback

Co-authored-by: Aarni Koskela <akx@iki.fi>

* improves error traceback

* adds missing modifications

* sort imports

* run linter

* adds catch for other possible exception

* Update redis/lock.py to catch Both LockNotOwnedError and LockError in one except statement as LockError.

Co-authored-by: Juliano Amadeu <65794514+julianolm@users.noreply.github.com>

* Update redis/asyncio/lock.py

Co-authored-by: Juliano Amadeu <65794514+julianolm@users.noreply.github.com>

* fix linter errors

---------

Co-authored-by: Aarni Koskela <akx@iki.fi>
Co-authored-by: petyaslavova <petya.slavova@redis.com>
---
 redis/asyncio/client.py         |  7 +++++++
 redis/asyncio/cluster.py        |  7 +++++++
 redis/asyncio/lock.py           | 19 ++++++++++++++++++-
 redis/client.py                 |  7 +++++++
 redis/cluster.py                |  7 +++++++
 redis/exceptions.py             |  2 +-
 redis/lock.py                   | 19 ++++++++++++++++++-
 tests/test_asyncio/test_lock.py | 30 ++++++++++++++++++++++++++++++
 tests/test_lock.py              | 26 ++++++++++++++++++++++++++
 9 files changed, 121 insertions(+), 3 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 4254441073..412d5a24b3 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -478,6 +478,7 @@ def lock(
         blocking_timeout: Optional[float] = None,
         lock_class: Optional[Type[Lock]] = None,
         thread_local: bool = True,
+        raise_on_release_error: bool = True,
     ) -> Lock:
         """
         Return a new Lock object using key ``name`` that mimics
@@ -524,6 +525,11 @@ def lock(
                      thread-1 would see the token value as "xyz" and would be
                      able to successfully release the thread-2's lock.
 
+        ``raise_on_release_error`` indicates whether to raise an exception when
+        the lock is no longer owned when exiting the context manager. By default,
+        this is True, meaning an exception will be raised. If False, the warning
+        will be logged and the exception will be suppressed.
+
         In some use cases it's necessary to disable thread local storage. For
         example, if you have code where one thread acquires a lock and passes
         that lock instance to a worker thread to release later. If thread
@@ -541,6 +547,7 @@ def lock(
             blocking=blocking,
             blocking_timeout=blocking_timeout,
             thread_local=thread_local,
+            raise_on_release_error=raise_on_release_error,
         )
 
     def pubsub(self, **kwargs) -> "PubSub":
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 11d3f093f7..51dce89597 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -839,6 +839,7 @@ def lock(
         blocking_timeout: Optional[float] = None,
         lock_class: Optional[Type[Lock]] = None,
         thread_local: bool = True,
+        raise_on_release_error: bool = True,
     ) -> Lock:
         """
         Return a new Lock object using key ``name`` that mimics
@@ -885,6 +886,11 @@ def lock(
                      thread-1 would see the token value as "xyz" and would be
                      able to successfully release the thread-2's lock.
 
+        ``raise_on_release_error`` indicates whether to raise an exception when
+        the lock is no longer owned when exiting the context manager. By default,
+        this is True, meaning an exception will be raised. If False, the warning
+        will be logged and the exception will be suppressed.
+
         In some use cases it's necessary to disable thread local storage. For
         example, if you have code where one thread acquires a lock and passes
         that lock instance to a worker thread to release later. If thread
@@ -902,6 +908,7 @@ def lock(
             blocking=blocking,
             blocking_timeout=blocking_timeout,
             thread_local=thread_local,
+            raise_on_release_error=raise_on_release_error,
         )
 
 
diff --git a/redis/asyncio/lock.py b/redis/asyncio/lock.py
index f70a8d09ab..16d7fb6957 100644
--- a/redis/asyncio/lock.py
+++ b/redis/asyncio/lock.py
@@ -1,4 +1,5 @@
 import asyncio
+import logging
 import threading
 import uuid
 from types import SimpleNamespace
@@ -10,6 +11,8 @@
 if TYPE_CHECKING:
     from redis.asyncio import Redis, RedisCluster
 
+logger = logging.getLogger(__name__)
+
 
 class Lock:
     """
@@ -85,6 +88,7 @@ def __init__(
         blocking: bool = True,
         blocking_timeout: Optional[Number] = None,
         thread_local: bool = True,
+        raise_on_release_error: bool = True,
     ):
         """
         Create a new Lock instance named ``name`` using the Redis client
@@ -128,6 +132,11 @@ def __init__(
                      thread-1 would see the token value as "xyz" and would be
                      able to successfully release the thread-2's lock.
 
+        ``raise_on_release_error`` indicates whether to raise an exception when
+        the lock is no longer owned when exiting the context manager. By default,
+        this is True, meaning an exception will be raised. If False, the warning
+        will be logged and the exception will be suppressed.
+
         In some use cases it's necessary to disable thread local storage. For
         example, if you have code where one thread acquires a lock and passes
         that lock instance to a worker thread to release later. If thread
@@ -144,6 +153,7 @@ def __init__(
         self.blocking_timeout = blocking_timeout
         self.thread_local = bool(thread_local)
         self.local = threading.local() if self.thread_local else SimpleNamespace()
+        self.raise_on_release_error = raise_on_release_error
         self.local.token = None
         self.register_scripts()
 
@@ -163,7 +173,14 @@ async def __aenter__(self):
         raise LockError("Unable to acquire lock within the time specified")
 
     async def __aexit__(self, exc_type, exc_value, traceback):
-        await self.release()
+        try:
+            await self.release()
+        except LockError:
+            if self.raise_on_release_error:
+                raise
+            logger.warning(
+                "Lock was unlocked or no longer owned when exiting context manager."
+            )
 
     async def acquire(
         self,
diff --git a/redis/client.py b/redis/client.py
index 2bacbe14ac..2ba96bd6f9 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -473,6 +473,7 @@ def lock(
         blocking_timeout: Optional[float] = None,
         lock_class: Union[None, Any] = None,
         thread_local: bool = True,
+        raise_on_release_error: bool = True,
     ):
         """
         Return a new Lock object using key ``name`` that mimics
@@ -519,6 +520,11 @@ def lock(
                      thread-1 would see the token value as "xyz" and would be
                      able to successfully release the thread-2's lock.
 
+        ``raise_on_release_error`` indicates whether to raise an exception when
+        the lock is no longer owned when exiting the context manager. By default,
+        this is True, meaning an exception will be raised. If False, the warning
+        will be logged and the exception will be suppressed.
+
         In some use cases it's necessary to disable thread local storage. For
         example, if you have code where one thread acquires a lock and passes
         that lock instance to a worker thread to release later. If thread
@@ -536,6 +542,7 @@ def lock(
             blocking=blocking,
             blocking_timeout=blocking_timeout,
             thread_local=thread_local,
+            raise_on_release_error=raise_on_release_error,
         )
 
     def pubsub(self, **kwargs):
diff --git a/redis/cluster.py b/redis/cluster.py
index ef4500f895..c9523e2a76 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -822,6 +822,7 @@ def lock(
         blocking_timeout=None,
         lock_class=None,
         thread_local=True,
+        raise_on_release_error: bool = True,
     ):
         """
         Return a new Lock object using key ``name`` that mimics
@@ -868,6 +869,11 @@ def lock(
                      thread-1 would see the token value as "xyz" and would be
                      able to successfully release the thread-2's lock.
 
+        ``raise_on_release_error`` indicates whether to raise an exception when
+        the lock is no longer owned when exiting the context manager. By default,
+        this is True, meaning an exception will be raised. If False, the warning
+        will be logged and the exception will be suppressed.
+
         In some use cases it's necessary to disable thread local storage. For
         example, if you have code where one thread acquires a lock and passes
         that lock instance to a worker thread to release later. If thread
@@ -885,6 +891,7 @@ def lock(
             blocking=blocking,
             blocking_timeout=blocking_timeout,
             thread_local=thread_local,
+            raise_on_release_error=raise_on_release_error,
         )
 
     def set_response_callback(self, command, callback):
diff --git a/redis/exceptions.py b/redis/exceptions.py
index 82f62730ab..bad447a086 100644
--- a/redis/exceptions.py
+++ b/redis/exceptions.py
@@ -89,7 +89,7 @@ def __init__(self, message=None, lock_name=None):
 
 
 class LockNotOwnedError(LockError):
-    "Error trying to extend or release a lock that is (no longer) owned"
+    "Error trying to extend or release a lock that is not owned (anymore)"
 
     pass
 
diff --git a/redis/lock.py b/redis/lock.py
index 7a1becb30a..0288496e6f 100644
--- a/redis/lock.py
+++ b/redis/lock.py
@@ -1,3 +1,4 @@
+import logging
 import threading
 import time as mod_time
 import uuid
@@ -7,6 +8,8 @@
 from redis.exceptions import LockError, LockNotOwnedError
 from redis.typing import Number
 
+logger = logging.getLogger(__name__)
+
 
 class Lock:
     """
@@ -82,6 +85,7 @@ def __init__(
         blocking: bool = True,
         blocking_timeout: Optional[Number] = None,
         thread_local: bool = True,
+        raise_on_release_error: bool = True,
     ):
         """
         Create a new Lock instance named ``name`` using the Redis client
@@ -125,6 +129,11 @@ def __init__(
                      thread-1 would see the token value as "xyz" and would be
                      able to successfully release the thread-2's lock.
 
+        ``raise_on_release_error`` indicates whether to raise an exception when
+        the lock is no longer owned when exiting the context manager. By default,
+        this is True, meaning an exception will be raised. If False, the warning
+        will be logged and the exception will be suppressed.
+
         In some use cases it's necessary to disable thread local storage. For
         example, if you have code where one thread acquires a lock and passes
         that lock instance to a worker thread to release later. If thread
@@ -140,6 +149,7 @@ def __init__(
         self.blocking = blocking
         self.blocking_timeout = blocking_timeout
         self.thread_local = bool(thread_local)
+        self.raise_on_release_error = raise_on_release_error
         self.local = threading.local() if self.thread_local else SimpleNamespace()
         self.local.token = None
         self.register_scripts()
@@ -168,7 +178,14 @@ def __exit__(
         exc_value: Optional[BaseException],
         traceback: Optional[TracebackType],
     ) -> None:
-        self.release()
+        try:
+            self.release()
+        except LockError:
+            if self.raise_on_release_error:
+                raise
+            logger.warning(
+                "Lock was unlocked or no longer owned when exiting context manager."
+            )
 
     def acquire(
         self,
diff --git a/tests/test_asyncio/test_lock.py b/tests/test_asyncio/test_lock.py
index 9973ef701f..be4270acdf 100644
--- a/tests/test_asyncio/test_lock.py
+++ b/tests/test_asyncio/test_lock.py
@@ -129,6 +129,36 @@ async def test_context_manager_raises_when_locked_not_acquired(self, r):
             async with self.get_lock(r, "foo", blocking_timeout=0.1):
                 pass
 
+    async def test_context_manager_not_raise_on_release_lock_not_owned_error(self, r):
+        try:
+            async with self.get_lock(
+                r, "foo", timeout=0.1, raise_on_release_error=False
+            ):
+                await asyncio.sleep(0.15)
+        except LockNotOwnedError:
+            pytest.fail("LockNotOwnedError should not have been raised")
+
+        with pytest.raises(LockNotOwnedError):
+            async with self.get_lock(
+                r, "foo", timeout=0.1, raise_on_release_error=True
+            ):
+                await asyncio.sleep(0.15)
+
+    async def test_context_manager_not_raise_on_release_lock_error(self, r):
+        try:
+            async with self.get_lock(
+                r, "foo", timeout=0.1, raise_on_release_error=False
+            ) as lock:
+                lock.release()
+        except LockError:
+            pytest.fail("LockError should not have been raised")
+
+        with pytest.raises(LockError):
+            async with self.get_lock(
+                r, "foo", timeout=0.1, raise_on_release_error=True
+            ) as lock:
+                lock.release()
+
     async def test_high_sleep_small_blocking_timeout(self, r):
         lock1 = self.get_lock(r, "foo")
         assert await lock1.acquire(blocking=False)
diff --git a/tests/test_lock.py b/tests/test_lock.py
index 136c86e459..3d6d81465e 100644
--- a/tests/test_lock.py
+++ b/tests/test_lock.py
@@ -133,6 +133,32 @@ def test_context_manager_raises_when_locked_not_acquired(self, r):
             with self.get_lock(r, "foo", blocking_timeout=0.1):
                 pass
 
+    def test_context_manager_not_raise_on_release_lock_not_owned_error(self, r):
+        try:
+            with self.get_lock(r, "foo", timeout=0.1, raise_on_release_error=False):
+                time.sleep(0.15)
+        except LockNotOwnedError:
+            pytest.fail("LockNotOwnedError should not have been raised")
+
+        with pytest.raises(LockNotOwnedError):
+            with self.get_lock(r, "foo", timeout=0.1, raise_on_release_error=True):
+                time.sleep(0.15)
+
+    def test_context_manager_not_raise_on_release_lock_error(self, r):
+        try:
+            with self.get_lock(
+                r, "foo", timeout=0.1, raise_on_release_error=False
+            ) as lock:
+                lock.release()
+        except LockError:
+            pytest.fail("LockError should not have been raised")
+
+        with pytest.raises(LockError):
+            with self.get_lock(
+                r, "foo", timeout=0.1, raise_on_release_error=True
+            ) as lock:
+                lock.release()
+
     def test_high_sleep_small_blocking_timeout(self, r):
         lock1 = self.get_lock(r, "foo")
         assert lock1.acquire(blocking=False)

From d8b2afa9f0cc056512474b3242dc29722484bcd4 Mon Sep 17 00:00:00 2001
From: Vladimir Chebotarev <vladimir.chebotarev@gmail.com>
Date: Mon, 10 Mar 2025 13:23:13 +0300
Subject: [PATCH 1003/1164] Got rid of `time.time()`- replacing it with
 time.monotonic(). (#3551)

---
 redis/client.py                   |  6 +++---
 redis/commands/search/commands.py | 12 ++++++------
 redis/connection.py               |  6 +++---
 tests/conftest.py                 |  4 ++--
 tests/test_connection_pool.py     | 14 +++++++-------
 tests/test_pubsub.py              |  4 ++--
 6 files changed, 23 insertions(+), 23 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 2ba96bd6f9..ea29a864ce 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -957,7 +957,7 @@ def check_health(self) -> None:
                 "did you forget to call subscribe() or psubscribe()?"
             )
 
-        if conn.health_check_interval and time.time() > conn.next_health_check:
+        if conn.health_check_interval and time.monotonic() > conn.next_health_check:
             conn.send_command("PING", self.HEALTH_CHECK_MESSAGE, check_health=False)
             self.health_check_response_counter += 1
 
@@ -1107,12 +1107,12 @@ def get_message(
         """
         if not self.subscribed:
             # Wait for subscription
-            start_time = time.time()
+            start_time = time.monotonic()
             if self.subscribed_event.wait(timeout) is True:
                 # The connection was subscribed during the timeout time frame.
                 # The timeout should be adjusted based on the time spent
                 # waiting for the subscription
-                time_spent = time.time() - start_time
+                time_spent = time.monotonic() - start_time
                 timeout = max(0.0, timeout - time_spent)
             else:
                 # The connection isn't subscribed to any channels or patterns,
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 1db57c23a5..96c6d9c2af 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -500,7 +500,7 @@ def search(
         For more information see `FT.SEARCH <https://redis.io/commands/ft.search>`_.
         """  # noqa
         args, query = self._mk_query_args(query, query_params=query_params)
-        st = time.time()
+        st = time.monotonic()
 
         options = {}
         if get_protocol_version(self.client) not in ["3", 3]:
@@ -512,7 +512,7 @@ def search(
             return res
 
         return self._parse_results(
-            SEARCH_CMD, res, query=query, duration=(time.time() - st) * 1000.0
+            SEARCH_CMD, res, query=query, duration=(time.monotonic() - st) * 1000.0
         )
 
     def explain(
@@ -602,7 +602,7 @@ def profile(
         Each parameter has a name and a value.
 
         """
-        st = time.time()
+        st = time.monotonic()
         cmd = [PROFILE_CMD, self.index_name, ""]
         if limited:
             cmd.append("LIMITED")
@@ -621,7 +621,7 @@ def profile(
         res = self.execute_command(*cmd)
 
         return self._parse_results(
-            PROFILE_CMD, res, query=query, duration=(time.time() - st) * 1000.0
+            PROFILE_CMD, res, query=query, duration=(time.monotonic() - st) * 1000.0
         )
 
     def spellcheck(self, query, distance=None, include=None, exclude=None):
@@ -940,7 +940,7 @@ async def search(
         For more information see `FT.SEARCH <https://redis.io/commands/ft.search>`_.
         """  # noqa
         args, query = self._mk_query_args(query, query_params=query_params)
-        st = time.time()
+        st = time.monotonic()
 
         options = {}
         if get_protocol_version(self.client) not in ["3", 3]:
@@ -952,7 +952,7 @@ async def search(
             return res
 
         return self._parse_results(
-            SEARCH_CMD, res, query=query, duration=(time.time() - st) * 1000.0
+            SEARCH_CMD, res, query=query, duration=(time.monotonic() - st) * 1000.0
         )
 
     async def aggregate(
diff --git a/redis/connection.py b/redis/connection.py
index 43501800c8..a298542c03 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -4,11 +4,11 @@
 import ssl
 import sys
 import threading
+import time
 import weakref
 from abc import abstractmethod
 from itertools import chain
 from queue import Empty, Full, LifoQueue
-from time import time
 from typing import Any, Callable, Dict, List, Optional, Type, TypeVar, Union
 from urllib.parse import parse_qs, unquote, urlparse
 
@@ -542,7 +542,7 @@ def _ping_failed(self, error):
 
     def check_health(self):
         """Check the health of the connection with a PING/PONG"""
-        if self.health_check_interval and time() > self.next_health_check:
+        if self.health_check_interval and time.monotonic() > self.next_health_check:
             self.retry.call_with_retry(self._send_ping, self._ping_failed)
 
     def send_packed_command(self, command, check_health=True):
@@ -632,7 +632,7 @@ def read_response(
             raise
 
         if self.health_check_interval:
-            self.next_health_check = time() + self.health_check_interval
+            self.next_health_check = time.monotonic() + self.health_check_interval
 
         if isinstance(response, ResponseError):
             try:
diff --git a/tests/conftest.py b/tests/conftest.py
index c485d626ca..7eaccb1acb 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -237,7 +237,7 @@ def wait_for_cluster_creation(redis_url, cluster_nodes, timeout=60):
     :param cluster_nodes: The number of nodes in the cluster
     :param timeout: the amount of time to wait (in seconds)
     """
-    now = time.time()
+    now = time.monotonic()
     end_time = now + timeout
     client = None
     print(f"Waiting for {cluster_nodes} cluster nodes to become available")
@@ -250,7 +250,7 @@ def wait_for_cluster_creation(redis_url, cluster_nodes, timeout=60):
         except RedisClusterException:
             pass
         time.sleep(1)
-        now = time.time()
+        now = time.monotonic()
     if now >= end_time:
         available_nodes = 0 if client is None else len(client.get_nodes())
         raise RedisClusterException(
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 65f42923fe..c92d84c226 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -167,11 +167,11 @@ def test_connection_pool_blocks_until_timeout(self, master_host):
         )
         pool.get_connection()
 
-        start = time.time()
+        start = time.monotonic()
         with pytest.raises(redis.ConnectionError):
             pool.get_connection()
         # we should have waited at least 0.1 seconds
-        assert time.time() - start >= 0.1
+        assert time.monotonic() - start >= 0.1
 
     def test_connection_pool_blocks_until_conn_available(self, master_host):
         """
@@ -188,10 +188,10 @@ def target():
             time.sleep(0.1)
             pool.release(c1)
 
-        start = time.time()
+        start = time.monotonic()
         Thread(target=target).start()
         pool.get_connection()
-        assert time.time() - start >= 0.1
+        assert time.monotonic() - start >= 0.1
 
     def test_reuse_previously_released_connection(self, master_host):
         connection_kwargs = {"host": master_host[0], "port": master_host[1]}
@@ -679,18 +679,18 @@ def r(self, request):
         return _get_client(redis.Redis, request, health_check_interval=self.interval)
 
     def assert_interval_advanced(self, connection):
-        diff = connection.next_health_check - time.time()
+        diff = connection.next_health_check - time.monotonic()
         assert self.interval > diff > (self.interval - 1)
 
     def test_health_check_runs(self, r):
-        r.connection.next_health_check = time.time() - 1
+        r.connection.next_health_check = time.monotonic() - 1
         r.connection.check_health()
         self.assert_interval_advanced(r.connection)
 
     def test_arbitrary_command_invokes_health_check(self, r):
         # invoke a command to make sure the connection is entirely setup
         r.get("foo")
-        r.connection.next_health_check = time.time()
+        r.connection.next_health_check = time.monotonic()
         with mock.patch.object(
             r.connection, "send_command", wraps=r.connection.send_command
         ) as m:
diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index fb46772af3..9ead455af3 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -23,7 +23,7 @@
 def wait_for_message(
     pubsub, timeout=0.5, ignore_subscribe_messages=False, node=None, func=None
 ):
-    now = time.time()
+    now = time.monotonic()
     timeout = now + timeout
     while now < timeout:
         if node:
@@ -39,7 +39,7 @@ def wait_for_message(
         if message is not None:
             return message
         time.sleep(0.01)
-        now = time.time()
+        now = time.monotonic()
     return None
 
 

From c9a277ef030c14c4e0293fd55cdaaf6e16ba4930 Mon Sep 17 00:00:00 2001
From: David Hotham <david.hotham@microsoft.com>
Date: Mon, 10 Mar 2025 11:48:06 +0000
Subject: [PATCH 1004/1164] allow more recent pyopenssl (#3541)

---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 22f18bb1ae..9c868be4b7 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -45,7 +45,7 @@ hiredis = [
 ]
 ocsp = [
     "cryptography>=36.0.1",
-    "pyopenssl==20.0.1",
+    "pyopenssl>=20.0.1",
     "requests>=2.31.0",
 ]
 jwt = [

From 09b1376acb0f225b5d9e3918e16a5c1c1e3d6e50 Mon Sep 17 00:00:00 2001
From: byeongjulee222 <52685247+byeongjulee222@users.noreply.github.com>
Date: Mon, 10 Mar 2025 23:48:58 +0900
Subject: [PATCH 1005/1164] Fix #3464: Correct misleading exception_handler
 example in docs (#3474)

---
 docs/advanced_features.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/docs/advanced_features.rst b/docs/advanced_features.rst
index de645bd764..0ed3e1ff34 100644
--- a/docs/advanced_features.rst
+++ b/docs/advanced_features.rst
@@ -380,8 +380,6 @@ run_in_thread.
    >>> def exception_handler(ex, pubsub, thread):
    >>>     print(ex)
    >>>     thread.stop()
-   >>>     thread.join(timeout=1.0)
-   >>>     pubsub.close()
    >>> thread = p.run_in_thread(exception_handler=exception_handler)
 
 A PubSub object adheres to the same encoding semantics as the client

From ac3b147943c3085eb2fc144916b82cb9437f9395 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 11 Mar 2025 12:50:45 +0200
Subject: [PATCH 1006/1164] Removing support for RedisGraph module. (#3548)

---
 .github/wordlist.txt                   |   2 -
 .github/workflows/install_and_test.sh  |   4 +-
 CHANGES                                |   1 +
 docker-compose.yml                     |   8 -
 docs/redismodules.rst                  |  33 --
 pyproject.toml                         |  57 +--
 redis/cluster.py                       |   1 -
 redis/commands/graph/__init__.py       | 263 ----------
 redis/commands/graph/commands.py       | 311 ------------
 redis/commands/graph/edge.py           |  91 ----
 redis/commands/graph/exceptions.py     |   3 -
 redis/commands/graph/execution_plan.py | 211 --------
 redis/commands/graph/node.py           |  88 ----
 redis/commands/graph/path.py           |  78 ---
 redis/commands/graph/query_result.py   | 588 ----------------------
 redis/commands/helpers.py              |  47 --
 redis/commands/redismodules.py         |  20 -
 tasks.py                               |   8 +-
 tests/test_asyncio/test_graph.py       | 526 --------------------
 tests/test_graph.py                    | 656 -------------------------
 tests/test_graph_utils/__init__.py     |   0
 tests/test_graph_utils/test_edge.py    |  75 ---
 tests/test_graph_utils/test_node.py    |  51 --
 tests/test_graph_utils/test_path.py    |  90 ----
 tests/test_helpers.py                  |  13 -
 25 files changed, 23 insertions(+), 3202 deletions(-)
 delete mode 100644 redis/commands/graph/__init__.py
 delete mode 100644 redis/commands/graph/commands.py
 delete mode 100644 redis/commands/graph/edge.py
 delete mode 100644 redis/commands/graph/exceptions.py
 delete mode 100644 redis/commands/graph/execution_plan.py
 delete mode 100644 redis/commands/graph/node.py
 delete mode 100644 redis/commands/graph/path.py
 delete mode 100644 redis/commands/graph/query_result.py
 delete mode 100644 tests/test_asyncio/test_graph.py
 delete mode 100644 tests/test_graph.py
 delete mode 100644 tests/test_graph_utils/__init__.py
 delete mode 100644 tests/test_graph_utils/test_edge.py
 delete mode 100644 tests/test_graph_utils/test_node.py
 delete mode 100644 tests/test_graph_utils/test_path.py

diff --git a/.github/wordlist.txt b/.github/wordlist.txt
index 3ea543748e..29bcaa9d77 100644
--- a/.github/wordlist.txt
+++ b/.github/wordlist.txt
@@ -12,7 +12,6 @@ ConnectionPool
 CoreCommands
 EVAL
 EVALSHA
-GraphCommands
 Grokzen's
 INCR
 IOError
@@ -39,7 +38,6 @@ RedisCluster
 RedisClusterCommands
 RedisClusterException
 RedisClusters
-RedisGraph
 RedisInstrumentor
 RedisJSON
 RedisTimeSeries
diff --git a/.github/workflows/install_and_test.sh b/.github/workflows/install_and_test.sh
index 778dbe0b20..e647126539 100755
--- a/.github/workflows/install_and_test.sh
+++ b/.github/workflows/install_and_test.sh
@@ -40,9 +40,9 @@ cd ${TESTDIR}
 # install, run tests
 pip install ${PKG}
 # Redis tests
-pytest -m 'not onlycluster and not graph'
+pytest -m 'not onlycluster'
 # RedisCluster tests
 CLUSTER_URL="redis://localhost:16379/0"
 CLUSTER_SSL_URL="rediss://localhost:27379/0"
-pytest -m 'not onlynoncluster and not redismod and not ssl and not graph' \
+pytest -m 'not onlynoncluster and not redismod and not ssl' \
   --redis-url="${CLUSTER_URL}" --redis-ssl-url="${CLUSTER_SSL_URL}"
diff --git a/CHANGES b/CHANGES
index 031d909f23..24b52c54db 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Removing support for RedisGraph module. RedisGraph support is deprecated since Redis Stack 7.2 (https://redis.com/blog/redisgraph-eol/)
     * Fix lock.extend() typedef to accept float TTL extension
     * Update URL in the readme linking to Redis University
     * Move doctests (doc code examples) to main branch
diff --git a/docker-compose.yml b/docker-compose.yml
index 8ca3471311..76a60398f3 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -105,11 +105,3 @@ services:
       - standalone
       - all-stack
       - all
-
-  redis-stack-graph:
-    image: redis/redis-stack-server:6.2.6-v15
-    container_name: redis-stack-graph
-    ports:
-      - 6480:6379
-    profiles:
-      - graph
diff --git a/docs/redismodules.rst b/docs/redismodules.rst
index 27757cb692..07914fff12 100644
--- a/docs/redismodules.rst
+++ b/docs/redismodules.rst
@@ -51,39 +51,6 @@ These are the commands for interacting with the `RedisBloom module <https://redi
 
 ------
 
-RedisGraph Commands
-*******************
-
-These are the commands for interacting with the `RedisGraph module <https://redisgraph.io>`_. Below is a brief example, as well as documentation on the commands themselves.
-
-**Create a graph, adding two nodes**
-
-.. code-block:: python
-
-    import redis
-    from redis.graph.node import Node
-
-    john = Node(label="person", properties={"name": "John Doe", "age": 33}
-    jane = Node(label="person", properties={"name": "Jane Doe", "age": 34}
-
-    r = redis.Redis()
-    graph = r.graph()
-    graph.add_node(john)
-    graph.add_node(jane)
-    graph.add_node(pat)
-    graph.commit()
-
-.. automodule:: redis.commands.graph.node
-    :members: Node
-
-.. automodule:: redis.commands.graph.edge
-    :members: Edge
-
-.. automodule:: redis.commands.graph.commands
-    :members: GraphCommands
-
-------
-
 RedisJSON Commands
 ******************
 
diff --git a/pyproject.toml b/pyproject.toml
index 9c868be4b7..ab3e4cd77e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -9,14 +9,8 @@ description = "Python client for Redis database and key-value store"
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.8"
-authors = [
-    { name = "Redis Inc.", email = "oss@redis.com" },
-]
-keywords = [
-    "Redis",
-    "database",
-    "key-value-store",
-]
+authors = [{ name = "Redis Inc.", email = "oss@redis.com" }]
+keywords = ["Redis", "database", "key-value-store"]
 classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Environment :: Console",
@@ -35,9 +29,7 @@ classifiers = [
     "Programming Language :: Python :: Implementation :: CPython",
     "Programming Language :: Python :: Implementation :: PyPy",
 ]
-dependencies = [
-    'async-timeout>=4.0.3; python_full_version<"3.11.3"',
-]
+dependencies = ['async-timeout>=4.0.3; python_full_version<"3.11.3"']
 
 [project.optional-dependencies]
 hiredis = [
@@ -63,22 +55,15 @@ Homepage = "https://github.com/redis/redis-py"
 path = "redis/__init__.py"
 
 [tool.hatch.build.targets.sdist]
-include = [
-    "/redis",
-    "/tests",
-    "dev_requirements.txt",
-]
+include = ["/redis", "/tests", "dev_requirements.txt"]
 
 [tool.hatch.build.targets.wheel]
-include = [
-    "/redis",
-]
+include = ["/redis"]
 
 [tool.pytest.ini_options]
 addopts = "-s"
 markers = [
     "redismod: run only the redis module tests",
-    "graph: run only the redisgraph tests",
     "pipeline: pipeline tests",
     "onlycluster: marks tests to be run only with cluster mode redis",
     "onlynoncluster: marks tests to be run only with standalone redis",
@@ -93,7 +78,6 @@ asyncio_mode = "auto"
 timeout = 30
 filterwarnings = [
     "always",
-    "ignore:RedisGraph support is deprecated as of Redis Stack 7.2:DeprecationWarning",
     # Ignore a coverage warning when COVERAGE_CORE=sysmon for Pythons < 3.12.
     "ignore:sys.monitoring isn't available:coverage.exceptions.CoverageWarning",
 ]
@@ -118,32 +102,23 @@ exclude = [
 
 [tool.ruff.lint]
 ignore = [
-    "E501",  # line too long (taken care of with ruff format)
-    "E741",  # ambiguous variable name
-    "N818",  # Errors should have Error suffix
+    "E501", # line too long (taken care of with ruff format)
+    "E741", # ambiguous variable name
+    "N818", # Errors should have Error suffix
 ]
 
-select = [
-    "E",
-    "F",
-    "FLY",
-    "I",
-    "N",
-    "W",
-]
+select = ["E", "F", "FLY", "I", "N", "W"]
 
 [tool.ruff.lint.per-file-ignores]
 "redis/commands/bf/*" = [
     # the `bf` module uses star imports, so this is required there.
-    "F405",  # name may be undefined, or defined from star imports
-]
-"redis/commands/{bf,timeseries,json,search}/*" = [
-    "N",
+    "F405", # name may be undefined, or defined from star imports
 ]
+"redis/commands/{bf,timeseries,json,search}/*" = ["N"]
 "tests/*" = [
-    "I",  # TODO: could be enabled, plenty of changes
-    "N801",  # class name should use CapWords convention
-    "N803",  # argument name should be lowercase
-    "N802",  # function name should be lowercase
-    "N806",  # variable name should be lowercase
+    "I",    # TODO: could be enabled, plenty of changes
+    "N801", # class name should use CapWords convention
+    "N803", # argument name should be lowercase
+    "N802", # function name should be lowercase
+    "N806", # variable name should be lowercase
 ]
diff --git a/redis/cluster.py b/redis/cluster.py
index c9523e2a76..13253ec896 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -288,7 +288,6 @@ class AbstractRedisCluster:
                 "TFUNCTION LIST",
                 "TFCALL",
                 "TFCALLASYNC",
-                "GRAPH.CONFIG",
                 "LATENCY HISTORY",
                 "LATENCY LATEST",
                 "LATENCY RESET",
diff --git a/redis/commands/graph/__init__.py b/redis/commands/graph/__init__.py
deleted file mode 100644
index ddc0e34f4c..0000000000
--- a/redis/commands/graph/__init__.py
+++ /dev/null
@@ -1,263 +0,0 @@
-import warnings
-
-from ..helpers import quote_string, random_string, stringify_param_value
-from .commands import AsyncGraphCommands, GraphCommands
-from .edge import Edge  # noqa
-from .node import Node  # noqa
-from .path import Path  # noqa
-
-DB_LABELS = "DB.LABELS"
-DB_RAELATIONSHIPTYPES = "DB.RELATIONSHIPTYPES"
-DB_PROPERTYKEYS = "DB.PROPERTYKEYS"
-
-
-class Graph(GraphCommands):
-    """
-    Graph, collection of nodes and edges.
-    """
-
-    def __init__(self, client, name=random_string()):
-        """
-        Create a new graph.
-        """
-        warnings.warn(
-            DeprecationWarning(
-                "RedisGraph support is deprecated as of Redis Stack 7.2 \
-                (https://redis.com/blog/redisgraph-eol/)"
-            )
-        )
-        self.NAME = name  # Graph key
-        self.client = client
-        self.execute_command = client.execute_command
-
-        self.nodes = {}
-        self.edges = []
-        self._labels = []  # List of node labels.
-        self._properties = []  # List of properties.
-        self._relationship_types = []  # List of relation types.
-        self.version = 0  # Graph version
-
-    @property
-    def name(self):
-        return self.NAME
-
-    def _clear_schema(self):
-        self._labels = []
-        self._properties = []
-        self._relationship_types = []
-
-    def _refresh_schema(self):
-        self._clear_schema()
-        self._refresh_labels()
-        self._refresh_relations()
-        self._refresh_attributes()
-
-    def _refresh_labels(self):
-        lbls = self.labels()
-
-        # Unpack data.
-        self._labels = [l[0] for _, l in enumerate(lbls)]
-
-    def _refresh_relations(self):
-        rels = self.relationship_types()
-
-        # Unpack data.
-        self._relationship_types = [r[0] for _, r in enumerate(rels)]
-
-    def _refresh_attributes(self):
-        props = self.property_keys()
-
-        # Unpack data.
-        self._properties = [p[0] for _, p in enumerate(props)]
-
-    def get_label(self, idx):
-        """
-        Returns a label by it's index
-
-        Args:
-
-        idx:
-            The index of the label
-        """
-        try:
-            label = self._labels[idx]
-        except IndexError:
-            # Refresh labels.
-            self._refresh_labels()
-            label = self._labels[idx]
-        return label
-
-    def get_relation(self, idx):
-        """
-        Returns a relationship type by it's index
-
-        Args:
-
-        idx:
-            The index of the relation
-        """
-        try:
-            relationship_type = self._relationship_types[idx]
-        except IndexError:
-            # Refresh relationship types.
-            self._refresh_relations()
-            relationship_type = self._relationship_types[idx]
-        return relationship_type
-
-    def get_property(self, idx):
-        """
-        Returns a property by it's index
-
-        Args:
-
-        idx:
-            The index of the property
-        """
-        try:
-            p = self._properties[idx]
-        except IndexError:
-            # Refresh properties.
-            self._refresh_attributes()
-            p = self._properties[idx]
-        return p
-
-    def add_node(self, node):
-        """
-        Adds a node to the graph.
-        """
-        if node.alias is None:
-            node.alias = random_string()
-        self.nodes[node.alias] = node
-
-    def add_edge(self, edge):
-        """
-        Adds an edge to the graph.
-        """
-        if not (self.nodes[edge.src_node.alias] and self.nodes[edge.dest_node.alias]):
-            raise AssertionError("Both edge's end must be in the graph")
-
-        self.edges.append(edge)
-
-    def _build_params_header(self, params):
-        if params is None:
-            return ""
-        if not isinstance(params, dict):
-            raise TypeError("'params' must be a dict")
-        # Header starts with "CYPHER"
-        params_header = "CYPHER "
-        for key, value in params.items():
-            params_header += str(key) + "=" + stringify_param_value(value) + " "
-        return params_header
-
-    # Procedures.
-    def call_procedure(self, procedure, *args, read_only=False, **kwagrs):
-        args = [quote_string(arg) for arg in args]
-        q = f"CALL {procedure}({','.join(args)})"
-
-        y = kwagrs.get("y", None)
-        if y is not None:
-            q += f"YIELD {','.join(y)}"
-
-        return self.query(q, read_only=read_only)
-
-    def labels(self):
-        return self.call_procedure(DB_LABELS, read_only=True).result_set
-
-    def relationship_types(self):
-        return self.call_procedure(DB_RAELATIONSHIPTYPES, read_only=True).result_set
-
-    def property_keys(self):
-        return self.call_procedure(DB_PROPERTYKEYS, read_only=True).result_set
-
-
-class AsyncGraph(Graph, AsyncGraphCommands):
-    """Async version for Graph"""
-
-    async def _refresh_labels(self):
-        lbls = await self.labels()
-
-        # Unpack data.
-        self._labels = [l[0] for _, l in enumerate(lbls)]
-
-    async def _refresh_attributes(self):
-        props = await self.property_keys()
-
-        # Unpack data.
-        self._properties = [p[0] for _, p in enumerate(props)]
-
-    async def _refresh_relations(self):
-        rels = await self.relationship_types()
-
-        # Unpack data.
-        self._relationship_types = [r[0] for _, r in enumerate(rels)]
-
-    async def get_label(self, idx):
-        """
-        Returns a label by it's index
-
-        Args:
-
-        idx:
-            The index of the label
-        """
-        try:
-            label = self._labels[idx]
-        except IndexError:
-            # Refresh labels.
-            await self._refresh_labels()
-            label = self._labels[idx]
-        return label
-
-    async def get_property(self, idx):
-        """
-        Returns a property by it's index
-
-        Args:
-
-        idx:
-            The index of the property
-        """
-        try:
-            p = self._properties[idx]
-        except IndexError:
-            # Refresh properties.
-            await self._refresh_attributes()
-            p = self._properties[idx]
-        return p
-
-    async def get_relation(self, idx):
-        """
-        Returns a relationship type by it's index
-
-        Args:
-
-        idx:
-            The index of the relation
-        """
-        try:
-            relationship_type = self._relationship_types[idx]
-        except IndexError:
-            # Refresh relationship types.
-            await self._refresh_relations()
-            relationship_type = self._relationship_types[idx]
-        return relationship_type
-
-    async def call_procedure(self, procedure, *args, read_only=False, **kwagrs):
-        args = [quote_string(arg) for arg in args]
-        q = f"CALL {procedure}({','.join(args)})"
-
-        y = kwagrs.get("y", None)
-        if y is not None:
-            f"YIELD {','.join(y)}"
-        return await self.query(q, read_only=read_only)
-
-    async def labels(self):
-        return (await self.call_procedure(DB_LABELS, read_only=True)).result_set
-
-    async def property_keys(self):
-        return (await self.call_procedure(DB_PROPERTYKEYS, read_only=True)).result_set
-
-    async def relationship_types(self):
-        return (
-            await self.call_procedure(DB_RAELATIONSHIPTYPES, read_only=True)
-        ).result_set
diff --git a/redis/commands/graph/commands.py b/redis/commands/graph/commands.py
deleted file mode 100644
index 1e41a5fb1f..0000000000
--- a/redis/commands/graph/commands.py
+++ /dev/null
@@ -1,311 +0,0 @@
-from redis import DataError
-from redis.exceptions import ResponseError
-
-from .exceptions import VersionMismatchException
-from .execution_plan import ExecutionPlan
-from .query_result import AsyncQueryResult, QueryResult
-
-PROFILE_CMD = "GRAPH.PROFILE"
-RO_QUERY_CMD = "GRAPH.RO_QUERY"
-QUERY_CMD = "GRAPH.QUERY"
-DELETE_CMD = "GRAPH.DELETE"
-SLOWLOG_CMD = "GRAPH.SLOWLOG"
-CONFIG_CMD = "GRAPH.CONFIG"
-LIST_CMD = "GRAPH.LIST"
-EXPLAIN_CMD = "GRAPH.EXPLAIN"
-
-
-class GraphCommands:
-    """RedisGraph Commands"""
-
-    def commit(self):
-        """
-        Create entire graph.
-        """
-        if len(self.nodes) == 0 and len(self.edges) == 0:
-            return None
-
-        query = "CREATE "
-        for _, node in self.nodes.items():
-            query += str(node) + ","
-
-        query += ",".join([str(edge) for edge in self.edges])
-
-        # Discard leading comma.
-        if query[-1] == ",":
-            query = query[:-1]
-
-        return self.query(query)
-
-    def query(self, q, params=None, timeout=None, read_only=False, profile=False):
-        """
-        Executes a query against the graph.
-        For more information see `GRAPH.QUERY <https://redis.io/commands/graph.query>`_. # noqa
-
-        Args:
-
-        q : str
-            The query.
-        params : dict
-            Query parameters.
-        timeout : int
-            Maximum runtime for read queries in milliseconds.
-        read_only : bool
-            Executes a readonly query if set to True.
-        profile : bool
-            Return details on results produced by and time
-            spent in each operation.
-        """
-
-        # maintain original 'q'
-        query = q
-
-        # handle query parameters
-        query = self._build_params_header(params) + query
-
-        # construct query command
-        # ask for compact result-set format
-        # specify known graph version
-        if profile:
-            cmd = PROFILE_CMD
-        else:
-            cmd = RO_QUERY_CMD if read_only else QUERY_CMD
-        command = [cmd, self.name, query, "--compact"]
-
-        # include timeout is specified
-        if isinstance(timeout, int):
-            command.extend(["timeout", timeout])
-        elif timeout is not None:
-            raise Exception("Timeout argument must be a positive integer")
-
-        # issue query
-        try:
-            response = self.execute_command(*command)
-            return QueryResult(self, response, profile)
-        except ResponseError as e:
-            if "unknown command" in str(e) and read_only:
-                # `GRAPH.RO_QUERY` is unavailable in older versions.
-                return self.query(q, params, timeout, read_only=False)
-            raise e
-        except VersionMismatchException as e:
-            # client view over the graph schema is out of sync
-            # set client version and refresh local schema
-            self.version = e.version
-            self._refresh_schema()
-            # re-issue query
-            return self.query(q, params, timeout, read_only)
-
-    def merge(self, pattern):
-        """
-        Merge pattern.
-        """
-        query = "MERGE "
-        query += str(pattern)
-
-        return self.query(query)
-
-    def delete(self):
-        """
-        Deletes graph.
-        For more information see `DELETE <https://redis.io/commands/graph.delete>`_. # noqa
-        """
-        self._clear_schema()
-        return self.execute_command(DELETE_CMD, self.name)
-
-    # declared here, to override the built in redis.db.flush()
-    def flush(self):
-        """
-        Commit the graph and reset the edges and the nodes to zero length.
-        """
-        self.commit()
-        self.nodes = {}
-        self.edges = []
-
-    def bulk(self, **kwargs):
-        """Internal only. Not supported."""
-        raise NotImplementedError(
-            "GRAPH.BULK is internal only. "
-            "Use https://github.com/redisgraph/redisgraph-bulk-loader."
-        )
-
-    def profile(self, query):
-        """
-        Execute a query and produce an execution plan augmented with metrics
-        for each operation's execution. Return a string representation of a
-        query execution plan, with details on results produced by and time
-        spent in each operation.
-        For more information see `GRAPH.PROFILE <https://redis.io/commands/graph.profile>`_. # noqa
-        """
-        return self.query(query, profile=True)
-
-    def slowlog(self):
-        """
-        Get a list containing up to 10 of the slowest queries issued
-        against the given graph ID.
-        For more information see `GRAPH.SLOWLOG <https://redis.io/commands/graph.slowlog>`_. # noqa
-
-        Each item in the list has the following structure:
-        1. A unix timestamp at which the log entry was processed.
-        2. The issued command.
-        3. The issued query.
-        4. The amount of time needed for its execution, in milliseconds.
-        """
-        return self.execute_command(SLOWLOG_CMD, self.name)
-
-    def config(self, name, value=None, set=False):
-        """
-        Retrieve or update a RedisGraph configuration.
-        For more information see `<https://redis.io/commands/graph.config-get/>`__.
-
-        Args:
-
-        name : str
-            The name of the configuration
-        value :
-            The value we want to set (can be used only when `set` is on)
-        set : bool
-            Turn on to set a configuration. Default behavior is get.
-        """
-        params = ["SET" if set else "GET", name]
-        if value is not None:
-            if set:
-                params.append(value)
-            else:
-                raise DataError("``value`` can be provided only when ``set`` is True")  # noqa
-        return self.execute_command(CONFIG_CMD, *params)
-
-    def list_keys(self):
-        """
-        Lists all graph keys in the keyspace.
-        For more information see `GRAPH.LIST <https://redis.io/commands/graph.list>`_. # noqa
-        """
-        return self.execute_command(LIST_CMD)
-
-    def execution_plan(self, query, params=None):
-        """
-        Get the execution plan for given query,
-        GRAPH.EXPLAIN returns an array of operations.
-
-        Args:
-            query: the query that will be executed
-            params: query parameters
-        """
-        query = self._build_params_header(params) + query
-
-        plan = self.execute_command(EXPLAIN_CMD, self.name, query)
-        if isinstance(plan[0], bytes):
-            plan = [b.decode() for b in plan]
-        return "\n".join(plan)
-
-    def explain(self, query, params=None):
-        """
-        Get the execution plan for given query,
-        GRAPH.EXPLAIN returns ExecutionPlan object.
-        For more information see `GRAPH.EXPLAIN <https://redis.io/commands/graph.explain>`_. # noqa
-
-        Args:
-            query: the query that will be executed
-            params: query parameters
-        """
-        query = self._build_params_header(params) + query
-
-        plan = self.execute_command(EXPLAIN_CMD, self.name, query)
-        return ExecutionPlan(plan)
-
-
-class AsyncGraphCommands(GraphCommands):
-    async def query(self, q, params=None, timeout=None, read_only=False, profile=False):
-        """
-        Executes a query against the graph.
-        For more information see `GRAPH.QUERY <https://oss.redis.com/redisgraph/master/commands/#graphquery>`_. # noqa
-
-        Args:
-
-        q : str
-            The query.
-        params : dict
-            Query parameters.
-        timeout : int
-            Maximum runtime for read queries in milliseconds.
-        read_only : bool
-            Executes a readonly query if set to True.
-        profile : bool
-            Return details on results produced by and time
-            spent in each operation.
-        """
-
-        # maintain original 'q'
-        query = q
-
-        # handle query parameters
-        query = self._build_params_header(params) + query
-
-        # construct query command
-        # ask for compact result-set format
-        # specify known graph version
-        if profile:
-            cmd = PROFILE_CMD
-        else:
-            cmd = RO_QUERY_CMD if read_only else QUERY_CMD
-        command = [cmd, self.name, query, "--compact"]
-
-        # include timeout is specified
-        if isinstance(timeout, int):
-            command.extend(["timeout", timeout])
-        elif timeout is not None:
-            raise Exception("Timeout argument must be a positive integer")
-
-        # issue query
-        try:
-            response = await self.execute_command(*command)
-            return await AsyncQueryResult().initialize(self, response, profile)
-        except ResponseError as e:
-            if "unknown command" in str(e) and read_only:
-                # `GRAPH.RO_QUERY` is unavailable in older versions.
-                return await self.query(q, params, timeout, read_only=False)
-            raise e
-        except VersionMismatchException as e:
-            # client view over the graph schema is out of sync
-            # set client version and refresh local schema
-            self.version = e.version
-            self._refresh_schema()
-            # re-issue query
-            return await self.query(q, params, timeout, read_only)
-
-    async def execution_plan(self, query, params=None):
-        """
-        Get the execution plan for given query,
-        GRAPH.EXPLAIN returns an array of operations.
-
-        Args:
-            query: the query that will be executed
-            params: query parameters
-        """
-        query = self._build_params_header(params) + query
-
-        plan = await self.execute_command(EXPLAIN_CMD, self.name, query)
-        if isinstance(plan[0], bytes):
-            plan = [b.decode() for b in plan]
-        return "\n".join(plan)
-
-    async def explain(self, query, params=None):
-        """
-        Get the execution plan for given query,
-        GRAPH.EXPLAIN returns ExecutionPlan object.
-
-        Args:
-            query: the query that will be executed
-            params: query parameters
-        """
-        query = self._build_params_header(params) + query
-
-        plan = await self.execute_command(EXPLAIN_CMD, self.name, query)
-        return ExecutionPlan(plan)
-
-    async def flush(self):
-        """
-        Commit the graph and reset the edges and the nodes to zero length.
-        """
-        await self.commit()
-        self.nodes = {}
-        self.edges = []
diff --git a/redis/commands/graph/edge.py b/redis/commands/graph/edge.py
deleted file mode 100644
index 6ee195f1f5..0000000000
--- a/redis/commands/graph/edge.py
+++ /dev/null
@@ -1,91 +0,0 @@
-from ..helpers import quote_string
-from .node import Node
-
-
-class Edge:
-    """
-    An edge connecting two nodes.
-    """
-
-    def __init__(self, src_node, relation, dest_node, edge_id=None, properties=None):
-        """
-        Create a new edge.
-        """
-        if src_node is None or dest_node is None:
-            # NOTE(bors-42): It makes sense to change AssertionError to
-            #                ValueError here
-            raise AssertionError("Both src_node & dest_node must be provided")
-
-        self.id = edge_id
-        self.relation = relation or ""
-        self.properties = properties or {}
-        self.src_node = src_node
-        self.dest_node = dest_node
-
-    def to_string(self):
-        res = ""
-        if self.properties:
-            props = ",".join(
-                key + ":" + str(quote_string(val))
-                for key, val in sorted(self.properties.items())
-            )
-            res += "{" + props + "}"
-
-        return res
-
-    def __str__(self):
-        # Source node.
-        if isinstance(self.src_node, Node):
-            res = str(self.src_node)
-        else:
-            res = "()"
-
-        # Edge
-        res += "-["
-        if self.relation:
-            res += ":" + self.relation
-        if self.properties:
-            props = ",".join(
-                key + ":" + str(quote_string(val))
-                for key, val in sorted(self.properties.items())
-            )
-            res += "{" + props + "}"
-        res += "]->"
-
-        # Dest node.
-        if isinstance(self.dest_node, Node):
-            res += str(self.dest_node)
-        else:
-            res += "()"
-
-        return res
-
-    def __eq__(self, rhs):
-        # Type checking
-        if not isinstance(rhs, Edge):
-            return False
-
-        # Quick positive check, if both IDs are set.
-        if self.id is not None and rhs.id is not None and self.id == rhs.id:
-            return True
-
-        # Source and destination nodes should match.
-        if self.src_node != rhs.src_node:
-            return False
-
-        if self.dest_node != rhs.dest_node:
-            return False
-
-        # Relation should match.
-        if self.relation != rhs.relation:
-            return False
-
-        # Quick check for number of properties.
-        if len(self.properties) != len(rhs.properties):
-            return False
-
-        # Compare properties.
-        if self.properties != rhs.properties:
-            return False
-
-        return True
diff --git a/redis/commands/graph/exceptions.py b/redis/commands/graph/exceptions.py
deleted file mode 100644
index 4bbac1008e..0000000000
--- a/redis/commands/graph/exceptions.py
+++ /dev/null
@@ -1,3 +0,0 @@
-class VersionMismatchException(Exception):
-    def __init__(self, version):
-        self.version = version
diff --git a/redis/commands/graph/execution_plan.py b/redis/commands/graph/execution_plan.py
deleted file mode 100644
index 179a80cca0..0000000000
--- a/redis/commands/graph/execution_plan.py
+++ /dev/null
@@ -1,211 +0,0 @@
-import re
-
-
-class ProfileStats:
-    """
-    ProfileStats, runtime execution statistics of operation.
-    """
-
-    def __init__(self, records_produced, execution_time):
-        self.records_produced = records_produced
-        self.execution_time = execution_time
-
-
-class Operation:
-    """
-    Operation, single operation within execution plan.
-    """
-
-    def __init__(self, name, args=None, profile_stats=None):
-        """
-        Create a new operation.
-
-        Args:
-            name: string that represents the name of the operation
-            args: operation arguments
-            profile_stats: profile statistics
-        """
-        self.name = name
-        self.args = args
-        self.profile_stats = profile_stats
-        self.children = []
-
-    def append_child(self, child):
-        if not isinstance(child, Operation) or self is child:
-            raise Exception("child must be Operation")
-
-        self.children.append(child)
-        return self
-
-    def child_count(self):
-        return len(self.children)
-
-    def __eq__(self, o: object) -> bool:
-        if not isinstance(o, Operation):
-            return False
-
-        return self.name == o.name and self.args == o.args
-
-    def __str__(self) -> str:
-        args_str = "" if self.args is None else " | " + self.args
-        return f"{self.name}{args_str}"
-
-
-class ExecutionPlan:
-    """
-    ExecutionPlan, collection of operations.
-    """
-
-    def __init__(self, plan):
-        """
-        Create a new execution plan.
-
-        Args:
-            plan: array of strings that represents the collection operations
-                  the output from GRAPH.EXPLAIN
-        """
-        if not isinstance(plan, list):
-            raise Exception("plan must be an array")
-
-        if isinstance(plan[0], bytes):
-            plan = [b.decode() for b in plan]
-
-        self.plan = plan
-        self.structured_plan = self._operation_tree()
-
-    def _compare_operations(self, root_a, root_b):
-        """
-        Compare execution plan operation tree
-
-        Return: True if operation trees are equal, False otherwise
-        """
-
-        # compare current root
-        if root_a != root_b:
-            return False
-
-        # make sure root have the same number of children
-        if root_a.child_count() != root_b.child_count():
-            return False
-
-        # recursively compare children
-        for i in range(root_a.child_count()):
-            if not self._compare_operations(root_a.children[i], root_b.children[i]):
-                return False
-
-        return True
-
-    def __str__(self) -> str:
-        def aggraget_str(str_children):
-            return "\n".join(
-                [
-                    "    " + line
-                    for str_child in str_children
-                    for line in str_child.splitlines()
-                ]
-            )
-
-        def combine_str(x, y):
-            return f"{x}\n{y}"
-
-        return self._operation_traverse(
-            self.structured_plan, str, aggraget_str, combine_str
-        )
-
-    def __eq__(self, o: object) -> bool:
-        """Compares two execution plans
-
-        Return: True if the two plans are equal False otherwise
-        """
-        # make sure 'o' is an execution-plan
-        if not isinstance(o, ExecutionPlan):
-            return False
-
-        # get root for both plans
-        root_a = self.structured_plan
-        root_b = o.structured_plan
-
-        # compare execution trees
-        return self._compare_operations(root_a, root_b)
-
-    def _operation_traverse(self, op, op_f, aggregate_f, combine_f):
-        """
-        Traverse operation tree recursively applying functions
-
-        Args:
-            op: operation to traverse
-            op_f: function applied for each operation
-            aggregate_f: aggregation function applied for all children of a single operation
-            combine_f: combine function applied for the operation result and the children result
-        """  # noqa
-        # apply op_f for each operation
-        op_res = op_f(op)
-        if len(op.children) == 0:
-            return op_res  # no children return
-        else:
-            # apply _operation_traverse recursively
-            children = [
-                self._operation_traverse(child, op_f, aggregate_f, combine_f)
-                for child in op.children
-            ]
-            # combine the operation result with the children aggregated result
-            return combine_f(op_res, aggregate_f(children))
-
-    def _operation_tree(self):
-        """Build the operation tree from the string representation"""
-
-        # initial state
-        i = 0
-        level = 0
-        stack = []
-        current = None
-
-        def _create_operation(args):
-            profile_stats = None
-            name = args[0].strip()
-            args.pop(0)
-            if len(args) > 0 and "Records produced" in args[-1]:
-                records_produced = int(
-                    re.search("Records produced: (\\d+)", args[-1]).group(1)
-                )
-                execution_time = float(
-                    re.search("Execution time: (\\d+.\\d+) ms", args[-1]).group(1)
-                )
-                profile_stats = ProfileStats(records_produced, execution_time)
-                args.pop(-1)
-            return Operation(
-                name, None if len(args) == 0 else args[0].strip(), profile_stats
-            )
-
-        # iterate plan operations
-        while i < len(self.plan):
-            current_op = self.plan[i]
-            op_level = current_op.count("    ")
-            if op_level == level:
-                # if the operation level equal to the current level
-                # set the current operation and move next
-                child = _create_operation(current_op.split("|"))
-                if current:
-                    current = stack.pop()
-                    current.append_child(child)
-                current = child
-                i += 1
-            elif op_level == level + 1:
-                # if the operation is child of the current operation
-                # add it as child and set as current operation
-                child = _create_operation(current_op.split("|"))
-                current.append_child(child)
-                stack.append(current)
-                current = child
-                level += 1
-                i += 1
-            elif op_level < level:
-                # if the operation is not child of current operation
-                # go back to it's parent operation
-                levels_back = level - op_level + 1
-                for _ in range(levels_back):
-                    current = stack.pop()
-                level -= levels_back
-            else:
-                raise Exception("corrupted plan")
-        return stack[0]
diff --git a/redis/commands/graph/node.py b/redis/commands/graph/node.py
deleted file mode 100644
index 4546a393b1..0000000000
--- a/redis/commands/graph/node.py
+++ /dev/null
@@ -1,88 +0,0 @@
-from ..helpers import quote_string
-
-
-class Node:
-    """
-    A node within the graph.
-    """
-
-    def __init__(self, node_id=None, alias=None, label=None, properties=None):
-        """
-        Create a new node.
-        """
-        self.id = node_id
-        self.alias = alias
-        if isinstance(label, list):
-            label = [inner_label for inner_label in label if inner_label != ""]
-
-        if (
-            label is None
-            or label == ""
-            or (isinstance(label, list) and len(label) == 0)
-        ):
-            self.label = None
-            self.labels = None
-        elif isinstance(label, str):
-            self.label = label
-            self.labels = [label]
-        elif isinstance(label, list) and all(
-            [isinstance(inner_label, str) for inner_label in label]
-        ):
-            self.label = label[0]
-            self.labels = label
-        else:
-            raise AssertionError(
-                "label should be either None, string or a list of strings"
-            )
-
-        self.properties = properties or {}
-
-    def to_string(self):
-        res = ""
-        if self.properties:
-            props = ",".join(
-                key + ":" + str(quote_string(val))
-                for key, val in sorted(self.properties.items())
-            )
-            res += "{" + props + "}"
-
-        return res
-
-    def __str__(self):
-        res = "("
-        if self.alias:
-            res += self.alias
-        if self.labels:
-            res += ":" + ":".join(self.labels)
-        if self.properties:
-            props = ",".join(
-                key + ":" + str(quote_string(val))
-                for key, val in sorted(self.properties.items())
-            )
-            res += "{" + props + "}"
-        res += ")"
-
-        return res
-
-    def __eq__(self, rhs):
-        # Type checking
-        if not isinstance(rhs, Node):
-            return False
-
-        # Quick positive check, if both IDs are set.
-        if self.id is not None and rhs.id is not None and self.id != rhs.id:
-            return False
-
-        # Label should match.
-        if self.label != rhs.label:
-            return False
-
-        # Quick check for number of properties.
-        if len(self.properties) != len(rhs.properties):
-            return False
-
-        # Compare properties.
-        if self.properties != rhs.properties:
-            return False
-
-        return True
diff --git a/redis/commands/graph/path.py b/redis/commands/graph/path.py
deleted file mode 100644
index ee22dc8c6b..0000000000
--- a/redis/commands/graph/path.py
+++ /dev/null
@@ -1,78 +0,0 @@
-from .edge import Edge
-from .node import Node
-
-
-class Path:
-    def __init__(self, nodes, edges):
-        if not (isinstance(nodes, list) and isinstance(edges, list)):
-            raise TypeError("nodes and edges must be list")
-
-        self._nodes = nodes
-        self._edges = edges
-        self.append_type = Node
-
-    @classmethod
-    def new_empty_path(cls):
-        return cls([], [])
-
-    def nodes(self):
-        return self._nodes
-
-    def edges(self):
-        return self._edges
-
-    def get_node(self, index):
-        return self._nodes[index]
-
-    def get_relationship(self, index):
-        return self._edges[index]
-
-    def first_node(self):
-        return self._nodes[0]
-
-    def last_node(self):
-        return self._nodes[-1]
-
-    def edge_count(self):
-        return len(self._edges)
-
-    def nodes_count(self):
-        return len(self._nodes)
-
-    def add_node(self, node):
-        if not isinstance(node, self.append_type):
-            raise AssertionError("Add Edge before adding Node")
-        self._nodes.append(node)
-        self.append_type = Edge
-        return self
-
-    def add_edge(self, edge):
-        if not isinstance(edge, self.append_type):
-            raise AssertionError("Add Node before adding Edge")
-        self._edges.append(edge)
-        self.append_type = Node
-        return self
-
-    def __eq__(self, other):
-        # Type checking
-        if not isinstance(other, Path):
-            return False
-
-        return self.nodes() == other.nodes() and self.edges() == other.edges()
-
-    def __str__(self):
-        res = "<"
-        edge_count = self.edge_count()
-        for i in range(0, edge_count):
-            node_id = self.get_node(i).id
-            res += "(" + str(node_id) + ")"
-            edge = self.get_relationship(i)
-            res += (
-                "-[" + str(int(edge.id)) + "]->"
-                if edge.src_node == node_id
-                else "<-[" + str(int(edge.id)) + "]-"
-            )
-        node_id = self.get_node(edge_count).id
-        res += "(" + str(node_id) + ")"
-        res += ">"
-        return res
diff --git a/redis/commands/graph/query_result.py b/redis/commands/graph/query_result.py
deleted file mode 100644
index 7709081bcf..0000000000
--- a/redis/commands/graph/query_result.py
+++ /dev/null
@@ -1,588 +0,0 @@
-import sys
-from collections import OrderedDict
-
-# from prettytable import PrettyTable
-from redis import ResponseError
-
-from .edge import Edge
-from .exceptions import VersionMismatchException
-from .node import Node
-from .path import Path
-
-LABELS_ADDED = "Labels added"
-LABELS_REMOVED = "Labels removed"
-NODES_CREATED = "Nodes created"
-NODES_DELETED = "Nodes deleted"
-RELATIONSHIPS_DELETED = "Relationships deleted"
-PROPERTIES_SET = "Properties set"
-PROPERTIES_REMOVED = "Properties removed"
-RELATIONSHIPS_CREATED = "Relationships created"
-INDICES_CREATED = "Indices created"
-INDICES_DELETED = "Indices deleted"
-CACHED_EXECUTION = "Cached execution"
-INTERNAL_EXECUTION_TIME = "internal execution time"
-
-STATS = [
-    LABELS_ADDED,
-    LABELS_REMOVED,
-    NODES_CREATED,
-    PROPERTIES_SET,
-    PROPERTIES_REMOVED,
-    RELATIONSHIPS_CREATED,
-    NODES_DELETED,
-    RELATIONSHIPS_DELETED,
-    INDICES_CREATED,
-    INDICES_DELETED,
-    CACHED_EXECUTION,
-    INTERNAL_EXECUTION_TIME,
-]
-
-
-class ResultSetColumnTypes:
-    COLUMN_UNKNOWN = 0
-    COLUMN_SCALAR = 1
-    COLUMN_NODE = 2  # Unused as of RedisGraph v2.1.0, retained for backwards compatibility. # noqa
-    COLUMN_RELATION = 3  # Unused as of RedisGraph v2.1.0, retained for backwards compatibility. # noqa
-
-
-class ResultSetScalarTypes:
-    VALUE_UNKNOWN = 0
-    VALUE_NULL = 1
-    VALUE_STRING = 2
-    VALUE_INTEGER = 3
-    VALUE_BOOLEAN = 4
-    VALUE_DOUBLE = 5
-    VALUE_ARRAY = 6
-    VALUE_EDGE = 7
-    VALUE_NODE = 8
-    VALUE_PATH = 9
-    VALUE_MAP = 10
-    VALUE_POINT = 11
-
-
-class QueryResult:
-    def __init__(self, graph, response, profile=False):
-        """
-        A class that represents a result of the query operation.
-
-        Args:
-
-        graph:
-            The graph on which the query was executed.
-        response:
-            The response from the server.
-        profile:
-            A boolean indicating if the query command was "GRAPH.PROFILE"
-        """
-        self.graph = graph
-        self.header = []
-        self.result_set = []
-
-        # in case of an error an exception will be raised
-        self._check_for_errors(response)
-
-        if len(response) == 1:
-            self.parse_statistics(response[0])
-        elif profile:
-            self.parse_profile(response)
-        else:
-            # start by parsing statistics, matches the one we have
-            self.parse_statistics(response[-1])  # Last element.
-            self.parse_results(response)
-
-    def _check_for_errors(self, response):
-        """
-        Check if the response contains an error.
-        """
-        if isinstance(response[0], ResponseError):
-            error = response[0]
-            if str(error) == "version mismatch":
-                version = response[1]
-                error = VersionMismatchException(version)
-            raise error
-
-        # If we encountered a run-time error, the last response
-        # element will be an exception
-        if isinstance(response[-1], ResponseError):
-            raise response[-1]
-
-    def parse_results(self, raw_result_set):
-        """
-        Parse the query execution result returned from the server.
-        """
-        self.header = self.parse_header(raw_result_set)
-
-        # Empty header.
-        if len(self.header) == 0:
-            return
-
-        self.result_set = self.parse_records(raw_result_set)
-
-    def parse_statistics(self, raw_statistics):
-        """
-        Parse the statistics returned in the response.
-        """
-        self.statistics = {}
-
-        # decode statistics
-        for idx, stat in enumerate(raw_statistics):
-            if isinstance(stat, bytes):
-                raw_statistics[idx] = stat.decode()
-
-        for s in STATS:
-            v = self._get_value(s, raw_statistics)
-            if v is not None:
-                self.statistics[s] = v
-
-    def parse_header(self, raw_result_set):
-        """
-        Parse the header of the result.
-        """
-        # An array of column name/column type pairs.
-        header = raw_result_set[0]
-        return header
-
-    def parse_records(self, raw_result_set):
-        """
-        Parses the result set and returns a list of records.
-        """
-        records = [
-            [
-                self.parse_record_types[self.header[idx][0]](cell)
-                for idx, cell in enumerate(row)
-            ]
-            for row in raw_result_set[1]
-        ]
-
-        return records
-
-    def parse_entity_properties(self, props):
-        """
-        Parse node / edge properties.
-        """
-        # [[name, value type, value] X N]
-        properties = {}
-        for prop in props:
-            prop_name = self.graph.get_property(prop[0])
-            prop_value = self.parse_scalar(prop[1:])
-            properties[prop_name] = prop_value
-
-        return properties
-
-    def parse_string(self, cell):
-        """
-        Parse the cell as a string.
-        """
-        if isinstance(cell, bytes):
-            return cell.decode()
-        elif not isinstance(cell, str):
-            return str(cell)
-        else:
-            return cell
-
-    def parse_node(self, cell):
-        """
-        Parse the cell to a node.
-        """
-        # Node ID (integer),
-        # [label string offset (integer)],
-        # [[name, value type, value] X N]
-
-        node_id = int(cell[0])
-        labels = None
-        if len(cell[1]) > 0:
-            labels = []
-            for inner_label in cell[1]:
-                labels.append(self.graph.get_label(inner_label))
-        properties = self.parse_entity_properties(cell[2])
-        return Node(node_id=node_id, label=labels, properties=properties)
-
-    def parse_edge(self, cell):
-        """
-        Parse the cell to an edge.
-        """
-        # Edge ID (integer),
-        # reltype string offset (integer),
-        # src node ID offset (integer),
-        # dest node ID offset (integer),
-        # [[name, value, value type] X N]
-
-        edge_id = int(cell[0])
-        relation = self.graph.get_relation(cell[1])
-        src_node_id = int(cell[2])
-        dest_node_id = int(cell[3])
-        properties = self.parse_entity_properties(cell[4])
-        return Edge(
-            src_node_id, relation, dest_node_id, edge_id=edge_id, properties=properties
-        )
-
-    def parse_path(self, cell):
-        """
-        Parse the cell to a path.
-        """
-        nodes = self.parse_scalar(cell[0])
-        edges = self.parse_scalar(cell[1])
-        return Path(nodes, edges)
-
-    def parse_map(self, cell):
-        """
-        Parse the cell as a map.
-        """
-        m = OrderedDict()
-        n_entries = len(cell)
-
-        # A map is an array of key value pairs.
-        # 1. key (string)
-        # 2. array: (value type, value)
-        for i in range(0, n_entries, 2):
-            key = self.parse_string(cell[i])
-            m[key] = self.parse_scalar(cell[i + 1])
-
-        return m
-
-    def parse_point(self, cell):
-        """
-        Parse the cell to point.
-        """
-        p = {}
-        # A point is received an array of the form: [latitude, longitude]
-        # It is returned as a map of the form: {"latitude": latitude, "longitude": longitude} # noqa
-        p["latitude"] = float(cell[0])
-        p["longitude"] = float(cell[1])
-        return p
-
-    def parse_null(self, cell):
-        """
-        Parse a null value.
-        """
-        return None
-
-    def parse_integer(self, cell):
-        """
-        Parse the integer value from the cell.
-        """
-        return int(cell)
-
-    def parse_boolean(self, value):
-        """
-        Parse the cell value as a boolean.
-        """
-        value = value.decode() if isinstance(value, bytes) else value
-        try:
-            scalar = True if strtobool(value) else False
-        except ValueError:
-            sys.stderr.write("unknown boolean type\n")
-            scalar = None
-        return scalar
-
-    def parse_double(self, cell):
-        """
-        Parse the cell as a double.
-        """
-        return float(cell)
-
-    def parse_array(self, value):
-        """
-        Parse an array of values.
-        """
-        scalar = [self.parse_scalar(value[i]) for i in range(len(value))]
-        return scalar
-
-    def parse_unknown(self, cell):
-        """
-        Parse a cell of unknown type.
-        """
-        sys.stderr.write("Unknown type\n")
-        return None
-
-    def parse_scalar(self, cell):
-        """
-        Parse a scalar value from a cell in the result set.
-        """
-        scalar_type = int(cell[0])
-        value = cell[1]
-        scalar = self.parse_scalar_types[scalar_type](value)
-
-        return scalar
-
-    def parse_profile(self, response):
-        self.result_set = [x[0 : x.index(",")].strip() for x in response]
-
-    def is_empty(self):
-        return len(self.result_set) == 0
-
-    @staticmethod
-    def _get_value(prop, statistics):
-        for stat in statistics:
-            if prop in stat:
-                return float(stat.split(": ")[1].split(" ")[0])
-
-        return None
-
-    def _get_stat(self, stat):
-        return self.statistics[stat] if stat in self.statistics else 0
-
-    @property
-    def labels_added(self):
-        """Returns the number of labels added in the query"""
-        return self._get_stat(LABELS_ADDED)
-
-    @property
-    def labels_removed(self):
-        """Returns the number of labels removed in the query"""
-        return self._get_stat(LABELS_REMOVED)
-
-    @property
-    def nodes_created(self):
-        """Returns the number of nodes created in the query"""
-        return self._get_stat(NODES_CREATED)
-
-    @property
-    def nodes_deleted(self):
-        """Returns the number of nodes deleted in the query"""
-        return self._get_stat(NODES_DELETED)
-
-    @property
-    def properties_set(self):
-        """Returns the number of properties set in the query"""
-        return self._get_stat(PROPERTIES_SET)
-
-    @property
-    def properties_removed(self):
-        """Returns the number of properties removed in the query"""
-        return self._get_stat(PROPERTIES_REMOVED)
-
-    @property
-    def relationships_created(self):
-        """Returns the number of relationships created in the query"""
-        return self._get_stat(RELATIONSHIPS_CREATED)
-
-    @property
-    def relationships_deleted(self):
-        """Returns the number of relationships deleted in the query"""
-        return self._get_stat(RELATIONSHIPS_DELETED)
-
-    @property
-    def indices_created(self):
-        """Returns the number of indices created in the query"""
-        return self._get_stat(INDICES_CREATED)
-
-    @property
-    def indices_deleted(self):
-        """Returns the number of indices deleted in the query"""
-        return self._get_stat(INDICES_DELETED)
-
-    @property
-    def cached_execution(self):
-        """Returns whether or not the query execution plan was cached"""
-        return self._get_stat(CACHED_EXECUTION) == 1
-
-    @property
-    def run_time_ms(self):
-        """Returns the server execution time of the query"""
-        return self._get_stat(INTERNAL_EXECUTION_TIME)
-
-    @property
-    def parse_scalar_types(self):
-        return {
-            ResultSetScalarTypes.VALUE_NULL: self.parse_null,
-            ResultSetScalarTypes.VALUE_STRING: self.parse_string,
-            ResultSetScalarTypes.VALUE_INTEGER: self.parse_integer,
-            ResultSetScalarTypes.VALUE_BOOLEAN: self.parse_boolean,
-            ResultSetScalarTypes.VALUE_DOUBLE: self.parse_double,
-            ResultSetScalarTypes.VALUE_ARRAY: self.parse_array,
-            ResultSetScalarTypes.VALUE_NODE: self.parse_node,
-            ResultSetScalarTypes.VALUE_EDGE: self.parse_edge,
-            ResultSetScalarTypes.VALUE_PATH: self.parse_path,
-            ResultSetScalarTypes.VALUE_MAP: self.parse_map,
-            ResultSetScalarTypes.VALUE_POINT: self.parse_point,
-            ResultSetScalarTypes.VALUE_UNKNOWN: self.parse_unknown,
-        }
-
-    @property
-    def parse_record_types(self):
-        return {
-            ResultSetColumnTypes.COLUMN_SCALAR: self.parse_scalar,
-            ResultSetColumnTypes.COLUMN_NODE: self.parse_node,
-            ResultSetColumnTypes.COLUMN_RELATION: self.parse_edge,
-            ResultSetColumnTypes.COLUMN_UNKNOWN: self.parse_unknown,
-        }
-
-
-class AsyncQueryResult(QueryResult):
-    """
-    Async version for the QueryResult class - a class that
-    represents a result of the query operation.
-    """
-
-    def __init__(self):
-        """
-        To init the class you must call self.initialize()
-        """
-        pass
-
-    async def initialize(self, graph, response, profile=False):
-        """
-        Initializes the class.
-        Args:
-
-        graph:
-            The graph on which the query was executed.
-        response:
-            The response from the server.
-        profile:
-            A boolean indicating if the query command was "GRAPH.PROFILE"
-        """
-        self.graph = graph
-        self.header = []
-        self.result_set = []
-
-        # in case of an error an exception will be raised
-        self._check_for_errors(response)
-
-        if len(response) == 1:
-            self.parse_statistics(response[0])
-        elif profile:
-            self.parse_profile(response)
-        else:
-            # start by parsing statistics, matches the one we have
-            self.parse_statistics(response[-1])  # Last element.
-            await self.parse_results(response)
-
-        return self
-
-    async def parse_node(self, cell):
-        """
-        Parses a node from the cell.
-        """
-        # Node ID (integer),
-        # [label string offset (integer)],
-        # [[name, value type, value] X N]
-
-        labels = None
-        if len(cell[1]) > 0:
-            labels = []
-            for inner_label in cell[1]:
-                labels.append(await self.graph.get_label(inner_label))
-        properties = await self.parse_entity_properties(cell[2])
-        node_id = int(cell[0])
-        return Node(node_id=node_id, label=labels, properties=properties)
-
-    async def parse_scalar(self, cell):
-        """
-        Parses a scalar value from the server response.
-        """
-        scalar_type = int(cell[0])
-        value = cell[1]
-        try:
-            scalar = await self.parse_scalar_types[scalar_type](value)
-        except TypeError:
-            # Not all of the functions are async
-            scalar = self.parse_scalar_types[scalar_type](value)
-
-        return scalar
-
-    async def parse_records(self, raw_result_set):
-        """
-        Parses the result set and returns a list of records.
-        """
-        records = []
-        for row in raw_result_set[1]:
-            record = [
-                await self.parse_record_types[self.header[idx][0]](cell)
-                for idx, cell in enumerate(row)
-            ]
-            records.append(record)
-
-        return records
-
-    async def parse_results(self, raw_result_set):
-        """
-        Parse the query execution result returned from the server.
-        """
-        self.header = self.parse_header(raw_result_set)
-
-        # Empty header.
-        if len(self.header) == 0:
-            return
-
-        self.result_set = await self.parse_records(raw_result_set)
-
-    async def parse_entity_properties(self, props):
-        """
-        Parse node / edge properties.
-        """
-        # [[name, value type, value] X N]
-        properties = {}
-        for prop in props:
-            prop_name = await self.graph.get_property(prop[0])
-            prop_value = await self.parse_scalar(prop[1:])
-            properties[prop_name] = prop_value
-
-        return properties
-
-    async def parse_edge(self, cell):
-        """
-        Parse the cell to an edge.
-        """
-        # Edge ID (integer),
-        # reltype string offset (integer),
-        # src node ID offset (integer),
-        # dest node ID offset (integer),
-        # [[name, value, value type] X N]
-
-        edge_id = int(cell[0])
-        relation = await self.graph.get_relation(cell[1])
-        src_node_id = int(cell[2])
-        dest_node_id = int(cell[3])
-        properties = await self.parse_entity_properties(cell[4])
-        return Edge(
-            src_node_id, relation, dest_node_id, edge_id=edge_id, properties=properties
-        )
-
-    async def parse_path(self, cell):
-        """
-        Parse the cell to a path.
-        """
-        nodes = await self.parse_scalar(cell[0])
-        edges = await self.parse_scalar(cell[1])
-        return Path(nodes, edges)
-
-    async def parse_map(self, cell):
-        """
-        Parse the cell to a map.
-        """
-        m = OrderedDict()
-        n_entries = len(cell)
-
-        # A map is an array of key value pairs.
-        # 1. key (string)
-        # 2. array: (value type, value)
-        for i in range(0, n_entries, 2):
-            key = self.parse_string(cell[i])
-            m[key] = await self.parse_scalar(cell[i + 1])
-
-        return m
-
-    async def parse_array(self, value):
-        """
-        Parse array value.
-        """
-        scalar = [await self.parse_scalar(value[i]) for i in range(len(value))]
-        return scalar
-
-
-def strtobool(val):
-    """
-    Convert a string representation of truth to true (1) or false (0).
-    True values are 'y', 'yes', 't', 'true', 'on', and '1'; false values
-    are 'n', 'no', 'f', 'false', 'off', and '0'.  Raises ValueError if
-    'val' is anything else.
-    """
-    val = val.lower()
-    if val in ("y", "yes", "t", "true", "on", "1"):
-        return True
-    elif val in ("n", "no", "f", "false", "off", "0"):
-        return False
-    else:
-        raise ValueError(f"invalid truth value {val!r}")
diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
index e11d34fb71..f6121b6c3b 100644
--- a/redis/commands/helpers.py
+++ b/redis/commands/helpers.py
@@ -88,26 +88,6 @@ def random_string(length=10):
     )
 
 
-def quote_string(v):
-    """
-    RedisGraph strings must be quoted,
-    quote_string wraps given v with quotes incase
-    v is a string.
-    """
-
-    if isinstance(v, bytes):
-        v = v.decode()
-    elif not isinstance(v, str):
-        return v
-    if len(v) == 0:
-        return '""'
-
-    v = v.replace("\\", "\\\\")
-    v = v.replace('"', '\\"')
-
-    return f'"{v}"'
-
-
 def decode_dict_keys(obj):
     """Decode the keys of the given dictionary with utf-8."""
     newobj = copy.copy(obj)
@@ -118,33 +98,6 @@ def decode_dict_keys(obj):
     return newobj
 
 
-def stringify_param_value(value):
-    """
-    Turn a parameter value into a string suitable for the params header of
-    a Cypher command.
-    You may pass any value that would be accepted by `json.dumps()`.
-
-    Ways in which output differs from that of `str()`:
-        * Strings are quoted.
-        * None --> "null".
-        * In dictionaries, keys are _not_ quoted.
-
-    :param value: The parameter value to be turned into a string.
-    :return: string
-    """
-
-    if isinstance(value, str):
-        return quote_string(value)
-    elif value is None:
-        return "null"
-    elif isinstance(value, (list, tuple)):
-        return f"[{','.join(map(stringify_param_value, value))}]"
-    elif isinstance(value, dict):
-        return f"{{{','.join(f'{k}:{stringify_param_value(v)}' for k, v in value.items())}}}"  # noqa
-    else:
-        return str(value)
-
-
 def get_protocol_version(client):
     if isinstance(client, redis.Redis) or isinstance(client, redis.asyncio.Redis):
         return client.connection_pool.connection_kwargs.get("protocol")
diff --git a/redis/commands/redismodules.py b/redis/commands/redismodules.py
index 7e2045a722..7ba40dd845 100644
--- a/redis/commands/redismodules.py
+++ b/redis/commands/redismodules.py
@@ -72,16 +72,6 @@ def tdigest(self):
         tdigest = TDigestBloom(client=self)
         return tdigest
 
-    def graph(self, index_name="idx"):
-        """Access the graph namespace, providing support for
-        redis graph data.
-        """
-
-        from .graph import Graph
-
-        g = Graph(client=self, name=index_name)
-        return g
-
 
 class AsyncRedisModuleCommands(RedisModuleCommands):
     def ft(self, index_name="idx"):
@@ -91,13 +81,3 @@ def ft(self, index_name="idx"):
 
         s = AsyncSearch(client=self, index_name=index_name)
         return s
-
-    def graph(self, index_name="idx"):
-        """Access the graph namespace, providing support for
-        redis graph data.
-        """
-
-        from .graph import AsyncGraph
-
-        g = AsyncGraph(client=self, name=index_name)
-        return g
diff --git a/tasks.py b/tasks.py
index 2d1a073437..52decf08e7 100644
--- a/tasks.py
+++ b/tasks.py
@@ -58,11 +58,11 @@ def standalone_tests(
 
     if uvloop:
         run(
-            f"pytest {profile_arg} --protocol={protocol} {redis_mod_url} --cov=./ --cov-report=xml:coverage_resp{protocol}_uvloop.xml -m 'not onlycluster and not graph{extra_markers}' --uvloop --junit-xml=standalone-resp{protocol}-uvloop-results.xml"
+            f"pytest {profile_arg} --protocol={protocol} {redis_mod_url} --cov=./ --cov-report=xml:coverage_resp{protocol}_uvloop.xml -m 'not onlycluster{extra_markers}' --uvloop --junit-xml=standalone-resp{protocol}-uvloop-results.xml"
         )
     else:
         run(
-            f"pytest {profile_arg} --protocol={protocol} {redis_mod_url} --cov=./ --cov-report=xml:coverage_resp{protocol}.xml -m 'not onlycluster and not graph{extra_markers}' --junit-xml=standalone-resp{protocol}-results.xml"
+            f"pytest {profile_arg} --protocol={protocol} {redis_mod_url} --cov=./ --cov-report=xml:coverage_resp{protocol}.xml -m 'not onlycluster{extra_markers}' --junit-xml=standalone-resp{protocol}-results.xml"
         )
 
 
@@ -74,11 +74,11 @@ def cluster_tests(c, uvloop=False, protocol=2, profile=False):
     cluster_tls_url = "rediss://localhost:27379/0"
     if uvloop:
         run(
-            f"pytest {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_cluster_resp{protocol}_uvloop.xml -m 'not onlynoncluster and not redismod and not graph' --redis-url={cluster_url} --redis-ssl-url={cluster_tls_url} --junit-xml=cluster-resp{protocol}-uvloop-results.xml --uvloop"
+            f"pytest {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_cluster_resp{protocol}_uvloop.xml -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --redis-ssl-url={cluster_tls_url} --junit-xml=cluster-resp{protocol}-uvloop-results.xml --uvloop"
         )
     else:
         run(
-            f"pytest  {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_cluster_resp{protocol}.xml -m 'not onlynoncluster and not redismod and not graph' --redis-url={cluster_url} --redis-ssl-url={cluster_tls_url} --junit-xml=cluster-resp{protocol}-results.xml"
+            f"pytest  {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_cluster_resp{protocol}.xml -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --redis-ssl-url={cluster_tls_url} --junit-xml=cluster-resp{protocol}-results.xml"
         )
 
 
diff --git a/tests/test_asyncio/test_graph.py b/tests/test_asyncio/test_graph.py
deleted file mode 100644
index 7b823265c3..0000000000
--- a/tests/test_asyncio/test_graph.py
+++ /dev/null
@@ -1,526 +0,0 @@
-import pytest
-import pytest_asyncio
-import redis.asyncio as redis
-from redis.commands.graph import Edge, Node, Path
-from redis.commands.graph.execution_plan import Operation
-from redis.exceptions import ResponseError
-from tests.conftest import skip_if_redis_enterprise, skip_if_resp_version
-
-
-@pytest_asyncio.fixture()
-async def decoded_r(create_redis, stack_url):
-    return await create_redis(decode_responses=True, url="redis://localhost:6480")
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-async def test_bulk(decoded_r):
-    with pytest.raises(NotImplementedError):
-        await decoded_r.graph().bulk()
-        await decoded_r.graph().bulk(foo="bar!")
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-async def test_graph_creation(decoded_r: redis.Redis):
-    graph = decoded_r.graph()
-
-    john = Node(
-        label="person",
-        properties={
-            "name": "John Doe",
-            "age": 33,
-            "gender": "male",
-            "status": "single",
-        },
-    )
-    graph.add_node(john)
-    japan = Node(label="country", properties={"name": "Japan"})
-
-    graph.add_node(japan)
-    edge = Edge(john, "visited", japan, properties={"purpose": "pleasure"})
-    graph.add_edge(edge)
-
-    await graph.commit()
-
-    query = (
-        'MATCH (p:person)-[v:visited {purpose:"pleasure"}]->(c:country) RETURN p, v, c'
-    )
-
-    result = await graph.query(query)
-
-    person = result.result_set[0][0]
-    visit = result.result_set[0][1]
-    country = result.result_set[0][2]
-
-    assert person == john
-    assert visit.properties == edge.properties
-    assert country == japan
-
-    query = """RETURN [1, 2.3, "4", true, false, null]"""
-    result = await graph.query(query)
-    assert [1, 2.3, "4", True, False, None] == result.result_set[0][0]
-
-    # All done, remove graph.
-    await graph.delete()
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-async def test_array_functions(decoded_r: redis.Redis):
-    graph = decoded_r.graph()
-
-    query = """CREATE (p:person{name:'a',age:32, array:[0,1,2]})"""
-    await graph.query(query)
-
-    query = """WITH [0,1,2] as x return x"""
-    result = await graph.query(query)
-    assert [0, 1, 2] == result.result_set[0][0]
-
-    query = """MATCH(n) return collect(n)"""
-    result = await graph.query(query)
-
-    a = Node(
-        node_id=0,
-        label="person",
-        properties={"name": "a", "age": 32, "array": [0, 1, 2]},
-    )
-
-    assert [a] == result.result_set[0][0]
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-async def test_path(decoded_r: redis.Redis):
-    node0 = Node(node_id=0, label="L1")
-    node1 = Node(node_id=1, label="L1")
-    edge01 = Edge(node0, "R1", node1, edge_id=0, properties={"value": 1})
-
-    graph = decoded_r.graph()
-    graph.add_node(node0)
-    graph.add_node(node1)
-    graph.add_edge(edge01)
-    await graph.flush()
-
-    path01 = Path.new_empty_path().add_node(node0).add_edge(edge01).add_node(node1)
-    expected_results = [[path01]]
-
-    query = "MATCH p=(:L1)-[:R1]->(:L1) RETURN p ORDER BY p"
-    result = await graph.query(query)
-    assert expected_results == result.result_set
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-async def test_param(decoded_r: redis.Redis):
-    params = [1, 2.3, "str", True, False, None, [0, 1, 2]]
-    query = "RETURN $param"
-    for param in params:
-        result = await decoded_r.graph().query(query, {"param": param})
-        expected_results = [[param]]
-        assert expected_results == result.result_set
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-async def test_map(decoded_r: redis.Redis):
-    query = "RETURN {a:1, b:'str', c:NULL, d:[1,2,3], e:True, f:{x:1, y:2}}"
-
-    actual = (await decoded_r.graph().query(query)).result_set[0][0]
-    expected = {
-        "a": 1,
-        "b": "str",
-        "c": None,
-        "d": [1, 2, 3],
-        "e": True,
-        "f": {"x": 1, "y": 2},
-    }
-
-    assert actual == expected
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-async def test_point(decoded_r: redis.Redis):
-    query = "RETURN point({latitude: 32.070794860, longitude: 34.820751118})"
-    expected_lat = 32.070794860
-    expected_lon = 34.820751118
-    actual = (await decoded_r.graph().query(query)).result_set[0][0]
-    assert abs(actual["latitude"] - expected_lat) < 0.001
-    assert abs(actual["longitude"] - expected_lon) < 0.001
-
-    query = "RETURN point({latitude: 32, longitude: 34.0})"
-    expected_lat = 32
-    expected_lon = 34
-    actual = (await decoded_r.graph().query(query)).result_set[0][0]
-    assert abs(actual["latitude"] - expected_lat) < 0.001
-    assert abs(actual["longitude"] - expected_lon) < 0.001
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-async def test_index_response(decoded_r: redis.Redis):
-    result_set = await decoded_r.graph().query("CREATE INDEX ON :person(age)")
-    assert 1 == result_set.indices_created
-
-    result_set = await decoded_r.graph().query("CREATE INDEX ON :person(age)")
-    assert 0 == result_set.indices_created
-
-    result_set = await decoded_r.graph().query("DROP INDEX ON :person(age)")
-    assert 1 == result_set.indices_deleted
-
-    with pytest.raises(ResponseError):
-        await decoded_r.graph().query("DROP INDEX ON :person(age)")
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-async def test_stringify_query_result(decoded_r: redis.Redis):
-    graph = decoded_r.graph()
-
-    john = Node(
-        alias="a",
-        label="person",
-        properties={
-            "name": "John Doe",
-            "age": 33,
-            "gender": "male",
-            "status": "single",
-        },
-    )
-    graph.add_node(john)
-
-    japan = Node(alias="b", label="country", properties={"name": "Japan"})
-    graph.add_node(japan)
-
-    edge = Edge(john, "visited", japan, properties={"purpose": "pleasure"})
-    graph.add_edge(edge)
-
-    assert (
-        str(john)
-        == """(a:person{age:33,gender:"male",name:"John Doe",status:"single"})"""  # noqa
-    )
-    assert (
-        str(edge)
-        == """(a:person{age:33,gender:"male",name:"John Doe",status:"single"})"""  # noqa
-        + """-[:visited{purpose:"pleasure"}]->"""
-        + """(b:country{name:"Japan"})"""
-    )
-    assert str(japan) == """(b:country{name:"Japan"})"""
-
-    await graph.commit()
-
-    query = """MATCH (p:person)-[v:visited {purpose:"pleasure"}]->(c:country)
-            RETURN p, v, c"""
-
-    result = await graph.query(query)
-    person = result.result_set[0][0]
-    visit = result.result_set[0][1]
-    country = result.result_set[0][2]
-
-    assert (
-        str(person)
-        == """(:person{age:33,gender:"male",name:"John Doe",status:"single"})"""  # noqa
-    )
-    assert str(visit) == """()-[:visited{purpose:"pleasure"}]->()"""
-    assert str(country) == """(:country{name:"Japan"})"""
-
-    await graph.delete()
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-async def test_optional_match(decoded_r: redis.Redis):
-    # Build a graph of form (a)-[R]->(b)
-    node0 = Node(node_id=0, label="L1", properties={"value": "a"})
-    node1 = Node(node_id=1, label="L1", properties={"value": "b"})
-
-    edge01 = Edge(node0, "R", node1, edge_id=0)
-
-    graph = decoded_r.graph()
-    graph.add_node(node0)
-    graph.add_node(node1)
-    graph.add_edge(edge01)
-    await graph.flush()
-
-    # Issue a query that collects all outgoing edges from both nodes
-    # (the second has none)
-    query = """MATCH (a) OPTIONAL MATCH (a)-[e]->(b) RETURN a, e, b ORDER BY a.value"""  # noqa
-    expected_results = [[node0, edge01, node1], [node1, None, None]]
-
-    result = await graph.query(query)
-    assert expected_results == result.result_set
-
-    await graph.delete()
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-async def test_cached_execution(decoded_r: redis.Redis):
-    await decoded_r.graph().query("CREATE ()")
-
-    uncached_result = await decoded_r.graph().query(
-        "MATCH (n) RETURN n, $param", {"param": [0]}
-    )
-    assert uncached_result.cached_execution is False
-
-    # loop to make sure the query is cached on each thread on server
-    for x in range(0, 64):
-        cached_result = await decoded_r.graph().query(
-            "MATCH (n) RETURN n, $param", {"param": [0]}
-        )
-        assert uncached_result.result_set == cached_result.result_set
-
-    # should be cached on all threads by now
-    assert cached_result.cached_execution
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-async def test_slowlog(decoded_r: redis.Redis):
-    create_query = """CREATE
-    (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
-    (:Rider {name:'Dani Pedrosa'})-[:rides]->(:Team {name:'Honda'}),
-    (:Rider {name:'Andrea Dovizioso'})-[:rides]->(:Team {name:'Ducati'})"""
-    await decoded_r.graph().query(create_query)
-
-    results = await decoded_r.graph().slowlog()
-    assert results[0][1] == "GRAPH.QUERY"
-    assert results[0][2] == create_query
-
-
-@pytest.mark.xfail(strict=False)
-@pytest.mark.graph
-@skip_if_resp_version(3)
-async def test_query_timeout(decoded_r: redis.Redis):
-    # Build a sample graph with 1000 nodes.
-    await decoded_r.graph().query("UNWIND range(0,1000) as val CREATE ({v: val})")
-    # Issue a long-running query with a 1-millisecond timeout.
-    with pytest.raises(ResponseError):
-        await decoded_r.graph().query("MATCH (a), (b), (c), (d) RETURN *", timeout=1)
-        assert False is False
-
-    with pytest.raises(Exception):
-        await decoded_r.graph().query("RETURN 1", timeout="str")
-        assert False is False
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-async def test_read_only_query(decoded_r: redis.Redis):
-    with pytest.raises(Exception):
-        # Issue a write query, specifying read-only true,
-        # this call should fail.
-        await decoded_r.graph().query("CREATE (p:person {name:'a'})", read_only=True)
-        assert False is False
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-async def test_profile(decoded_r: redis.Redis):
-    q = """UNWIND range(1, 3) AS x CREATE (p:Person {v:x})"""
-    profile = (await decoded_r.graph().profile(q)).result_set
-    assert "Create | Records produced: 3" in profile
-    assert "Unwind | Records produced: 3" in profile
-
-    q = "MATCH (p:Person) WHERE p.v > 1 RETURN p"
-    profile = (await decoded_r.graph().profile(q)).result_set
-    assert "Results | Records produced: 2" in profile
-    assert "Project | Records produced: 2" in profile
-    assert "Filter | Records produced: 2" in profile
-    assert "Node By Label Scan | (p:Person) | Records produced: 3" in profile
-
-
-@skip_if_redis_enterprise()
-@pytest.mark.graph
-@skip_if_resp_version(3)
-async def test_config(decoded_r: redis.Redis):
-    config_name = "RESULTSET_SIZE"
-    config_value = 3
-
-    # Set configuration
-    response = await decoded_r.graph().config(config_name, config_value, set=True)
-    assert response == "OK"
-
-    # Make sure config been updated.
-    response = await decoded_r.graph().config(config_name, set=False)
-    expected_response = [config_name, config_value]
-    assert response == expected_response
-
-    config_name = "QUERY_MEM_CAPACITY"
-    config_value = 1 << 20  # 1MB
-
-    # Set configuration
-    response = await decoded_r.graph().config(config_name, config_value, set=True)
-    assert response == "OK"
-
-    # Make sure config been updated.
-    response = await decoded_r.graph().config(config_name, set=False)
-    expected_response = [config_name, config_value]
-    assert response == expected_response
-
-    # reset to default
-    await decoded_r.graph().config("QUERY_MEM_CAPACITY", 0, set=True)
-    await decoded_r.graph().config("RESULTSET_SIZE", -100, set=True)
-
-
-@pytest.mark.onlynoncluster
-@pytest.mark.graph
-@skip_if_resp_version(3)
-async def test_list_keys(decoded_r: redis.Redis):
-    result = await decoded_r.graph().list_keys()
-    assert result == []
-
-    await decoded_r.graph("G").query("CREATE (n)")
-    result = await decoded_r.graph().list_keys()
-    assert result == ["G"]
-
-    await decoded_r.graph("X").query("CREATE (m)")
-    result = await decoded_r.graph().list_keys()
-    assert result == ["G", "X"]
-
-    await decoded_r.delete("G")
-    await decoded_r.rename("X", "Z")
-    result = await decoded_r.graph().list_keys()
-    assert result == ["Z"]
-
-    await decoded_r.delete("Z")
-    result = await decoded_r.graph().list_keys()
-    assert result == []
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-async def test_multi_label(decoded_r: redis.Redis):
-    redis_graph = decoded_r.graph("g")
-
-    node = Node(label=["l", "ll"])
-    redis_graph.add_node(node)
-    await redis_graph.commit()
-
-    query = "MATCH (n) RETURN n"
-    result = await redis_graph.query(query)
-    result_node = result.result_set[0][0]
-    assert result_node == node
-
-    try:
-        Node(label=1)
-        assert False
-    except AssertionError:
-        assert True
-
-    try:
-        Node(label=["l", 1])
-        assert False
-    except AssertionError:
-        assert True
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-async def test_execution_plan(decoded_r: redis.Redis):
-    redis_graph = decoded_r.graph("execution_plan")
-    create_query = """CREATE
-    (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
-    (:Rider {name:'Dani Pedrosa'})-[:rides]->(:Team {name:'Honda'}),
-    (:Rider {name:'Andrea Dovizioso'})-[:rides]->(:Team {name:'Ducati'})"""
-    await redis_graph.query(create_query)
-
-    result = await redis_graph.execution_plan(
-        "MATCH (r:Rider)-[:rides]->(t:Team) WHERE t.name = $name RETURN r.name, t.name, $params",  # noqa
-        {"name": "Yehuda"},
-    )
-    expected = "Results\n    Project\n        Conditional Traverse | (t)->(r:Rider)\n            Filter\n                Node By Label Scan | (t:Team)"  # noqa
-    assert result == expected
-
-    await redis_graph.delete()
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-async def test_explain(decoded_r: redis.Redis):
-    redis_graph = decoded_r.graph("execution_plan")
-    # graph creation / population
-    create_query = """CREATE
-(:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
-(:Rider {name:'Dani Pedrosa'})-[:rides]->(:Team {name:'Honda'}),
-(:Rider {name:'Andrea Dovizioso'})-[:rides]->(:Team {name:'Ducati'})"""
-    await redis_graph.query(create_query)
-
-    result = await redis_graph.explain(
-        """MATCH (r:Rider)-[:rides]->(t:Team)
-WHERE t.name = $name
-RETURN r.name, t.name
-UNION
-MATCH (r:Rider)-[:rides]->(t:Team)
-WHERE t.name = $name
-RETURN r.name, t.name""",
-        {"name": "Yamaha"},
-    )
-    expected = """\
-Results
-Distinct
-    Join
-        Project
-            Conditional Traverse | (t)->(r:Rider)
-                Filter
-                    Node By Label Scan | (t:Team)
-        Project
-            Conditional Traverse | (t)->(r:Rider)
-                Filter
-                    Node By Label Scan | (t:Team)"""
-    assert str(result).replace(" ", "").replace("\n", "") == expected.replace(
-        " ", ""
-    ).replace("\n", "")
-
-    expected = Operation("Results").append_child(
-        Operation("Distinct").append_child(
-            Operation("Join")
-            .append_child(
-                Operation("Project").append_child(
-                    Operation("Conditional Traverse", "(t)->(r:Rider)").append_child(
-                        Operation("Filter").append_child(
-                            Operation("Node By Label Scan", "(t:Team)")
-                        )
-                    )
-                )
-            )
-            .append_child(
-                Operation("Project").append_child(
-                    Operation("Conditional Traverse", "(t)->(r:Rider)").append_child(
-                        Operation("Filter").append_child(
-                            Operation("Node By Label Scan", "(t:Team)")
-                        )
-                    )
-                )
-            )
-        )
-    )
-
-    assert result.structured_plan == expected
-
-    result = await redis_graph.explain(
-        """MATCH (r:Rider), (t:Team)
-                                    RETURN r.name, t.name"""
-    )
-    expected = """\
-Results
-Project
-    Cartesian Product
-        Node By Label Scan | (r:Rider)
-        Node By Label Scan | (t:Team)"""
-    assert str(result).replace(" ", "").replace("\n", "") == expected.replace(
-        " ", ""
-    ).replace("\n", "")
-
-    expected = Operation("Results").append_child(
-        Operation("Project").append_child(
-            Operation("Cartesian Product")
-            .append_child(Operation("Node By Label Scan"))
-            .append_child(Operation("Node By Label Scan"))
-        )
-    )
-
-    assert result.structured_plan == expected
-
-    await redis_graph.delete()
diff --git a/tests/test_graph.py b/tests/test_graph.py
deleted file mode 100644
index fd08385667..0000000000
--- a/tests/test_graph.py
+++ /dev/null
@@ -1,656 +0,0 @@
-from unittest.mock import patch
-
-import pytest
-from redis import Redis
-from redis.commands.graph import Edge, Node, Path
-from redis.commands.graph.execution_plan import Operation
-from redis.commands.graph.query_result import (
-    CACHED_EXECUTION,
-    INDICES_CREATED,
-    INDICES_DELETED,
-    INTERNAL_EXECUTION_TIME,
-    LABELS_ADDED,
-    LABELS_REMOVED,
-    NODES_CREATED,
-    NODES_DELETED,
-    PROPERTIES_REMOVED,
-    PROPERTIES_SET,
-    RELATIONSHIPS_CREATED,
-    RELATIONSHIPS_DELETED,
-    QueryResult,
-)
-from redis.exceptions import ResponseError
-from tests.conftest import _get_client, skip_if_redis_enterprise, skip_if_resp_version
-
-
-@pytest.fixture
-def client(request, stack_url):
-    r = _get_client(
-        Redis, request, decode_responses=True, from_url="redis://localhost:6480"
-    )
-    r.flushdb()
-    return r
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-def test_bulk(client):
-    with pytest.raises(NotImplementedError):
-        client.graph().bulk()
-        client.graph().bulk(foo="bar!")
-
-
-@pytest.mark.graph
-def test_graph_creation_throws_deprecation_warning(client):
-    """Verify that a DeprecationWarning is raised when creating a Graph instance."""
-
-    match = "RedisGraph support is deprecated as of Redis Stack 7.2"
-    with pytest.warns(DeprecationWarning, match=match):
-        client.graph()
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-def test_graph_creation(client):
-    graph = client.graph()
-
-    john = Node(
-        label="person",
-        properties={
-            "name": "John Doe",
-            "age": 33,
-            "gender": "male",
-            "status": "single",
-        },
-    )
-    graph.add_node(john)
-    japan = Node(label="country", properties={"name": "Japan"})
-
-    graph.add_node(japan)
-    edge = Edge(john, "visited", japan, properties={"purpose": "pleasure"})
-    graph.add_edge(edge)
-
-    graph.commit()
-
-    query = (
-        'MATCH (p:person)-[v:visited {purpose:"pleasure"}]->(c:country) RETURN p, v, c'
-    )
-
-    result = graph.query(query)
-
-    person = result.result_set[0][0]
-    visit = result.result_set[0][1]
-    country = result.result_set[0][2]
-
-    assert person == john
-    assert visit.properties == edge.properties
-    assert country == japan
-
-    query = """RETURN [1, 2.3, "4", true, false, null]"""
-    result = graph.query(query)
-    assert [1, 2.3, "4", True, False, None] == result.result_set[0][0]
-
-    # All done, remove graph.
-    graph.delete()
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-def test_array_functions(client):
-    query = """CREATE (p:person{name:'a',age:32, array:[0,1,2]})"""
-    client.graph().query(query)
-
-    query = """WITH [0,1,2] as x return x"""
-    result = client.graph().query(query)
-    assert [0, 1, 2] == result.result_set[0][0]
-
-    query = """MATCH(n) return collect(n)"""
-    result = client.graph().query(query)
-
-    a = Node(
-        node_id=0,
-        label="person",
-        properties={"name": "a", "age": 32, "array": [0, 1, 2]},
-    )
-
-    assert [a] == result.result_set[0][0]
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-def test_path(client):
-    node0 = Node(node_id=0, label="L1")
-    node1 = Node(node_id=1, label="L1")
-    edge01 = Edge(node0, "R1", node1, edge_id=0, properties={"value": 1})
-
-    graph = client.graph()
-    graph.add_node(node0)
-    graph.add_node(node1)
-    graph.add_edge(edge01)
-    graph.flush()
-
-    path01 = Path.new_empty_path().add_node(node0).add_edge(edge01).add_node(node1)
-    expected_results = [[path01]]
-
-    query = "MATCH p=(:L1)-[:R1]->(:L1) RETURN p ORDER BY p"
-    result = graph.query(query)
-    assert expected_results == result.result_set
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-def test_param(client):
-    params = [1, 2.3, "str", True, False, None, [0, 1, 2], r"\" RETURN 1337 //"]
-    query = "RETURN $param"
-    for param in params:
-        result = client.graph().query(query, {"param": param})
-        expected_results = [[param]]
-        assert expected_results == result.result_set
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-def test_map(client):
-    query = "RETURN {a:1, b:'str', c:NULL, d:[1,2,3], e:True, f:{x:1, y:2}}"
-
-    actual = client.graph().query(query).result_set[0][0]
-    expected = {
-        "a": 1,
-        "b": "str",
-        "c": None,
-        "d": [1, 2, 3],
-        "e": True,
-        "f": {"x": 1, "y": 2},
-    }
-
-    assert actual == expected
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-def test_point(client):
-    query = "RETURN point({latitude: 32.070794860, longitude: 34.820751118})"
-    expected_lat = 32.070794860
-    expected_lon = 34.820751118
-    actual = client.graph().query(query).result_set[0][0]
-    assert abs(actual["latitude"] - expected_lat) < 0.001
-    assert abs(actual["longitude"] - expected_lon) < 0.001
-
-    query = "RETURN point({latitude: 32, longitude: 34.0})"
-    expected_lat = 32
-    expected_lon = 34
-    actual = client.graph().query(query).result_set[0][0]
-    assert abs(actual["latitude"] - expected_lat) < 0.001
-    assert abs(actual["longitude"] - expected_lon) < 0.001
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-def test_index_response(client):
-    result_set = client.graph().query("CREATE INDEX ON :person(age)")
-    assert 1 == result_set.indices_created
-
-    result_set = client.graph().query("CREATE INDEX ON :person(age)")
-    assert 0 == result_set.indices_created
-
-    result_set = client.graph().query("DROP INDEX ON :person(age)")
-    assert 1 == result_set.indices_deleted
-
-    with pytest.raises(ResponseError):
-        client.graph().query("DROP INDEX ON :person(age)")
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-def test_stringify_query_result(client):
-    graph = client.graph()
-
-    john = Node(
-        alias="a",
-        label="person",
-        properties={
-            "name": "John Doe",
-            "age": 33,
-            "gender": "male",
-            "status": "single",
-        },
-    )
-    graph.add_node(john)
-
-    japan = Node(alias="b", label="country", properties={"name": "Japan"})
-    graph.add_node(japan)
-
-    edge = Edge(john, "visited", japan, properties={"purpose": "pleasure"})
-    graph.add_edge(edge)
-
-    assert (
-        str(john)
-        == """(a:person{age:33,gender:"male",name:"John Doe",status:"single"})"""  # noqa
-    )
-    assert (
-        str(edge)
-        == """(a:person{age:33,gender:"male",name:"John Doe",status:"single"})"""  # noqa
-        + """-[:visited{purpose:"pleasure"}]->"""
-        + """(b:country{name:"Japan"})"""
-    )
-    assert str(japan) == """(b:country{name:"Japan"})"""
-
-    graph.commit()
-
-    query = """MATCH (p:person)-[v:visited {purpose:"pleasure"}]->(c:country)
-            RETURN p, v, c"""
-
-    result = client.graph().query(query)
-    person = result.result_set[0][0]
-    visit = result.result_set[0][1]
-    country = result.result_set[0][2]
-
-    assert (
-        str(person)
-        == """(:person{age:33,gender:"male",name:"John Doe",status:"single"})"""  # noqa
-    )
-    assert str(visit) == """()-[:visited{purpose:"pleasure"}]->()"""
-    assert str(country) == """(:country{name:"Japan"})"""
-
-    graph.delete()
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-def test_optional_match(client):
-    # Build a graph of form (a)-[R]->(b)
-    node0 = Node(node_id=0, label="L1", properties={"value": "a"})
-    node1 = Node(node_id=1, label="L1", properties={"value": "b"})
-
-    edge01 = Edge(node0, "R", node1, edge_id=0)
-
-    graph = client.graph()
-    graph.add_node(node0)
-    graph.add_node(node1)
-    graph.add_edge(edge01)
-    graph.flush()
-
-    # Issue a query that collects all outgoing edges from both nodes
-    # (the second has none)
-    query = """MATCH (a) OPTIONAL MATCH (a)-[e]->(b) RETURN a, e, b ORDER BY a.value"""  # noqa
-    expected_results = [[node0, edge01, node1], [node1, None, None]]
-
-    result = client.graph().query(query)
-    assert expected_results == result.result_set
-
-    graph.delete()
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-def test_cached_execution(client):
-    client.graph().query("CREATE ()")
-
-    uncached_result = client.graph().query("MATCH (n) RETURN n, $param", {"param": [0]})
-    assert uncached_result.cached_execution is False
-
-    # loop to make sure the query is cached on each thread on server
-    for x in range(0, 64):
-        cached_result = client.graph().query(
-            "MATCH (n) RETURN n, $param", {"param": [0]}
-        )
-        assert uncached_result.result_set == cached_result.result_set
-
-    # should be cached on all threads by now
-    assert cached_result.cached_execution
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-def test_slowlog(client):
-    create_query = """CREATE (:Rider
-    {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
-    (:Rider {name:'Dani Pedrosa'})-[:rides]->(:Team {name:'Honda'}),
-    (:Rider {name:'Andrea Dovizioso'})-[:rides]->(:Team {name:'Ducati'})"""
-    client.graph().query(create_query)
-
-    results = client.graph().slowlog()
-    assert results[0][1] == "GRAPH.QUERY"
-    assert results[0][2] == create_query
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-@pytest.mark.xfail(strict=False)
-def test_query_timeout(client):
-    # Build a sample graph with 1000 nodes.
-    client.graph().query("UNWIND range(0,1000) as val CREATE ({v: val})")
-    # Issue a long-running query with a 1-millisecond timeout.
-    with pytest.raises(ResponseError):
-        client.graph().query("MATCH (a), (b), (c), (d) RETURN *", timeout=1)
-        assert False is False
-
-    with pytest.raises(Exception):
-        client.graph().query("RETURN 1", timeout="str")
-        assert False is False
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-def test_read_only_query(client):
-    with pytest.raises(Exception):
-        # Issue a write query, specifying read-only true,
-        # this call should fail.
-        client.graph().query("CREATE (p:person {name:'a'})", read_only=True)
-        assert False is False
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-def test_profile(client):
-    q = """UNWIND range(1, 3) AS x CREATE (p:Person {v:x})"""
-    profile = client.graph().profile(q).result_set
-    assert "Create | Records produced: 3" in profile
-    assert "Unwind | Records produced: 3" in profile
-
-    q = "MATCH (p:Person) WHERE p.v > 1 RETURN p"
-    profile = client.graph().profile(q).result_set
-    assert "Results | Records produced: 2" in profile
-    assert "Project | Records produced: 2" in profile
-    assert "Filter | Records produced: 2" in profile
-    assert "Node By Label Scan | (p:Person) | Records produced: 3" in profile
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-@skip_if_redis_enterprise()
-def test_config(client):
-    config_name = "RESULTSET_SIZE"
-    config_value = 3
-
-    # Set configuration
-    response = client.graph().config(config_name, config_value, set=True)
-    assert response == "OK"
-
-    # Make sure config been updated.
-    response = client.graph().config(config_name, set=False)
-    expected_response = [config_name, config_value]
-    assert response == expected_response
-
-    config_name = "QUERY_MEM_CAPACITY"
-    config_value = 1 << 20  # 1MB
-
-    # Set configuration
-    response = client.graph().config(config_name, config_value, set=True)
-    assert response == "OK"
-
-    # Make sure config been updated.
-    response = client.graph().config(config_name, set=False)
-    expected_response = [config_name, config_value]
-    assert response == expected_response
-
-    # reset to default
-    client.graph().config("QUERY_MEM_CAPACITY", 0, set=True)
-    client.graph().config("RESULTSET_SIZE", -100, set=True)
-
-
-@pytest.mark.onlynoncluster
-@pytest.mark.graph
-@skip_if_resp_version(3)
-def test_list_keys(client):
-    result = client.graph().list_keys()
-    assert result == []
-
-    client.graph("G").query("CREATE (n)")
-    result = client.graph().list_keys()
-    assert result == ["G"]
-
-    client.graph("X").query("CREATE (m)")
-    result = client.graph().list_keys()
-    assert result == ["G", "X"]
-
-    client.delete("G")
-    client.rename("X", "Z")
-    result = client.graph().list_keys()
-    assert result == ["Z"]
-
-    client.delete("Z")
-    result = client.graph().list_keys()
-    assert result == []
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-def test_multi_label(client):
-    redis_graph = client.graph("g")
-
-    node = Node(label=["l", "ll"])
-    redis_graph.add_node(node)
-    redis_graph.commit()
-
-    query = "MATCH (n) RETURN n"
-    result = redis_graph.query(query)
-    result_node = result.result_set[0][0]
-    assert result_node == node
-
-    try:
-        Node(label=1)
-        assert False
-    except AssertionError:
-        assert True
-
-    try:
-        Node(label=["l", 1])
-        assert False
-    except AssertionError:
-        assert True
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-def test_cache_sync(client):
-    pass
-    return
-    # This test verifies that client internal graph schema cache stays
-    # in sync with the graph schema
-    #
-    # Client B will try to get Client A out of sync by:
-    # 1. deleting the graph
-    # 2. reconstructing the graph in a different order, this will casuse
-    #    a difference in the current mapping between string IDs and the
-    #    mapping Client A is aware of
-    #
-    # Client A should pick up on the changes by comparing graph versions
-    # and resyncing its cache.
-
-    A = client.graph("cache-sync")
-    B = client.graph("cache-sync")
-
-    # Build order:
-    # 1. introduce label 'L' and 'K'
-    # 2. introduce attribute 'x' and 'q'
-    # 3. introduce relationship-type 'R' and 'S'
-
-    A.query("CREATE (:L)")
-    B.query("CREATE (:K)")
-    A.query("MATCH (n) SET n.x = 1")
-    B.query("MATCH (n) SET n.q = 1")
-    A.query("MATCH (n) CREATE (n)-[:R]->()")
-    B.query("MATCH (n) CREATE (n)-[:S]->()")
-
-    # Cause client A to populate its cache
-    A.query("MATCH (n)-[e]->() RETURN n, e")
-
-    assert len(A._labels) == 2
-    assert len(A._properties) == 2
-    assert len(A._relationship_types) == 2
-    assert A._labels[0] == "L"
-    assert A._labels[1] == "K"
-    assert A._properties[0] == "x"
-    assert A._properties[1] == "q"
-    assert A._relationship_types[0] == "R"
-    assert A._relationship_types[1] == "S"
-
-    # Have client B reconstruct the graph in a different order.
-    B.delete()
-
-    # Build order:
-    # 1. introduce relationship-type 'R'
-    # 2. introduce label 'L'
-    # 3. introduce attribute 'x'
-    B.query("CREATE ()-[:S]->()")
-    B.query("CREATE ()-[:R]->()")
-    B.query("CREATE (:K)")
-    B.query("CREATE (:L)")
-    B.query("MATCH (n) SET n.q = 1")
-    B.query("MATCH (n) SET n.x = 1")
-
-    # A's internal cached mapping is now out of sync
-    # issue a query and make sure A's cache is synced.
-    A.query("MATCH (n)-[e]->() RETURN n, e")
-
-    assert len(A._labels) == 2
-    assert len(A._properties) == 2
-    assert len(A._relationship_types) == 2
-    assert A._labels[0] == "K"
-    assert A._labels[1] == "L"
-    assert A._properties[0] == "q"
-    assert A._properties[1] == "x"
-    assert A._relationship_types[0] == "S"
-    assert A._relationship_types[1] == "R"
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-def test_execution_plan(client):
-    redis_graph = client.graph("execution_plan")
-    create_query = """CREATE
-    (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
-    (:Rider {name:'Dani Pedrosa'})-[:rides]->(:Team {name:'Honda'}),
-    (:Rider {name:'Andrea Dovizioso'})-[:rides]->(:Team {name:'Ducati'})"""
-    redis_graph.query(create_query)
-
-    result = redis_graph.execution_plan(
-        "MATCH (r:Rider)-[:rides]->(t:Team) WHERE t.name = $name RETURN r.name, t.name, $params",  # noqa
-        {"name": "Yehuda"},
-    )
-    expected = "Results\n    Project\n        Conditional Traverse | (t)->(r:Rider)\n            Filter\n                Node By Label Scan | (t:Team)"  # noqa
-    assert result == expected
-
-    redis_graph.delete()
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-def test_explain(client):
-    redis_graph = client.graph("execution_plan")
-    # graph creation / population
-    create_query = """CREATE
-(:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}),
-(:Rider {name:'Dani Pedrosa'})-[:rides]->(:Team {name:'Honda'}),
-(:Rider {name:'Andrea Dovizioso'})-[:rides]->(:Team {name:'Ducati'})"""
-    redis_graph.query(create_query)
-
-    result = redis_graph.explain(
-        """MATCH (r:Rider)-[:rides]->(t:Team)
-WHERE t.name = $name
-RETURN r.name, t.name
-UNION
-MATCH (r:Rider)-[:rides]->(t:Team)
-WHERE t.name = $name
-RETURN r.name, t.name""",
-        {"name": "Yamaha"},
-    )
-    expected = """\
-Results
-Distinct
-    Join
-        Project
-            Conditional Traverse | (t)->(r:Rider)
-                Filter
-                    Node By Label Scan | (t:Team)
-        Project
-            Conditional Traverse | (t)->(r:Rider)
-                Filter
-                    Node By Label Scan | (t:Team)"""
-    assert str(result).replace(" ", "").replace("\n", "") == expected.replace(
-        " ", ""
-    ).replace("\n", "")
-
-    expected = Operation("Results").append_child(
-        Operation("Distinct").append_child(
-            Operation("Join")
-            .append_child(
-                Operation("Project").append_child(
-                    Operation("Conditional Traverse", "(t)->(r:Rider)").append_child(
-                        Operation("Filter").append_child(
-                            Operation("Node By Label Scan", "(t:Team)")
-                        )
-                    )
-                )
-            )
-            .append_child(
-                Operation("Project").append_child(
-                    Operation("Conditional Traverse", "(t)->(r:Rider)").append_child(
-                        Operation("Filter").append_child(
-                            Operation("Node By Label Scan", "(t:Team)")
-                        )
-                    )
-                )
-            )
-        )
-    )
-
-    assert result.structured_plan == expected
-
-    result = redis_graph.explain(
-        """MATCH (r:Rider), (t:Team)
-                                    RETURN r.name, t.name"""
-    )
-    expected = """\
-Results
-Project
-    Cartesian Product
-        Node By Label Scan | (r:Rider)
-        Node By Label Scan | (t:Team)"""
-    assert str(result).replace(" ", "").replace("\n", "") == expected.replace(
-        " ", ""
-    ).replace("\n", "")
-
-    expected = Operation("Results").append_child(
-        Operation("Project").append_child(
-            Operation("Cartesian Product")
-            .append_child(Operation("Node By Label Scan"))
-            .append_child(Operation("Node By Label Scan"))
-        )
-    )
-
-    assert result.structured_plan == expected
-
-    redis_graph.delete()
-
-
-@pytest.mark.graph
-@skip_if_resp_version(3)
-def test_resultset_statistics(client):
-    with patch.object(target=QueryResult, attribute="_get_stat") as mock_get_stats:
-        result = client.graph().query("RETURN 1")
-        result.labels_added
-        mock_get_stats.assert_called_with(LABELS_ADDED)
-        result.labels_removed
-        mock_get_stats.assert_called_with(LABELS_REMOVED)
-        result.nodes_created
-        mock_get_stats.assert_called_with(NODES_CREATED)
-        result.nodes_deleted
-        mock_get_stats.assert_called_with(NODES_DELETED)
-        result.properties_set
-        mock_get_stats.assert_called_with(PROPERTIES_SET)
-        result.properties_removed
-        mock_get_stats.assert_called_with(PROPERTIES_REMOVED)
-        result.relationships_created
-        mock_get_stats.assert_called_with(RELATIONSHIPS_CREATED)
-        result.relationships_deleted
-        mock_get_stats.assert_called_with(RELATIONSHIPS_DELETED)
-        result.indices_created
-        mock_get_stats.assert_called_with(INDICES_CREATED)
-        result.indices_deleted
-        mock_get_stats.assert_called_with(INDICES_DELETED)
-        result.cached_execution
-        mock_get_stats.assert_called_with(CACHED_EXECUTION)
-        result.run_time_ms
-        mock_get_stats.assert_called_with(INTERNAL_EXECUTION_TIME)
diff --git a/tests/test_graph_utils/__init__.py b/tests/test_graph_utils/__init__.py
deleted file mode 100644
index e69de29bb2..0000000000
diff --git a/tests/test_graph_utils/test_edge.py b/tests/test_graph_utils/test_edge.py
deleted file mode 100644
index 09e6fa08ed..0000000000
--- a/tests/test_graph_utils/test_edge.py
+++ /dev/null
@@ -1,75 +0,0 @@
-import pytest
-from redis.commands.graph import edge, node
-
-
-@pytest.mark.graph
-def test_init():
-    with pytest.raises(AssertionError):
-        edge.Edge(None, None, None)
-        edge.Edge(node.Node(), None, None)
-        edge.Edge(None, None, node.Node())
-
-    assert isinstance(
-        edge.Edge(node.Node(node_id=1), None, node.Node(node_id=2)), edge.Edge
-    )
-
-
-@pytest.mark.graph
-def test_to_string():
-    props_result = edge.Edge(
-        node.Node(), None, node.Node(), properties={"a": "a", "b": 10}
-    ).to_string()
-    assert props_result == '{a:"a",b:10}'
-
-    no_props_result = edge.Edge(
-        node.Node(), None, node.Node(), properties={}
-    ).to_string()
-    assert no_props_result == ""
-
-
-@pytest.mark.graph
-def test_stringify():
-    john = node.Node(
-        alias="a",
-        label="person",
-        properties={"name": "John Doe", "age": 33, "someArray": [1, 2, 3]},
-    )
-    japan = node.Node(alias="b", label="country", properties={"name": "Japan"})
-    edge_with_relation = edge.Edge(
-        john, "visited", japan, properties={"purpose": "pleasure"}
-    )
-    assert (
-        '(a:person{age:33,name:"John Doe",someArray:[1, 2, 3]})'
-        '-[:visited{purpose:"pleasure"}]->'
-        '(b:country{name:"Japan"})' == str(edge_with_relation)
-    )
-
-    edge_no_relation_no_props = edge.Edge(japan, "", john)
-    assert (
-        '(b:country{name:"Japan"})'
-        "-[]->"
-        '(a:person{age:33,name:"John Doe",someArray:[1, 2, 3]})'
-        == str(edge_no_relation_no_props)
-    )
-
-    edge_only_props = edge.Edge(john, "", japan, properties={"a": "b", "c": 3})
-    assert (
-        '(a:person{age:33,name:"John Doe",someArray:[1, 2, 3]})'
-        '-[{a:"b",c:3}]->'
-        '(b:country{name:"Japan"})' == str(edge_only_props)
-    )
-
-
-@pytest.mark.graph
-def test_comparison():
-    node1 = node.Node(node_id=1)
-    node2 = node.Node(node_id=2)
-    node3 = node.Node(node_id=3)
-
-    edge1 = edge.Edge(node1, None, node2)
-    assert edge1 == edge.Edge(node1, None, node2)
-    assert edge1 != edge.Edge(node1, "bla", node2)
-    assert edge1 != edge.Edge(node1, None, node3)
-    assert edge1 != edge.Edge(node3, None, node2)
-    assert edge1 != edge.Edge(node2, None, node1)
-    assert edge1 != edge.Edge(node1, None, node2, properties={"a": 10})
diff --git a/tests/test_graph_utils/test_node.py b/tests/test_graph_utils/test_node.py
deleted file mode 100644
index e9b8a54f43..0000000000
--- a/tests/test_graph_utils/test_node.py
+++ /dev/null
@@ -1,51 +0,0 @@
-import pytest
-from redis.commands.graph import node
-
-
-@pytest.fixture
-def fixture():
-    no_args = node.Node()
-    no_props = node.Node(node_id=1, alias="alias", label="l")
-    props_only = node.Node(properties={"a": "a", "b": 10})
-    no_label = node.Node(node_id=1, alias="alias", properties={"a": "a"})
-    multi_label = node.Node(node_id=1, alias="alias", label=["l", "ll"])
-    return no_args, no_props, props_only, no_label, multi_label
-
-
-@pytest.mark.graph
-def test_to_string(fixture):
-    no_args, no_props, props_only, no_label, multi_label = fixture
-    assert no_args.to_string() == ""
-    assert no_props.to_string() == ""
-    assert props_only.to_string() == '{a:"a",b:10}'
-    assert no_label.to_string() == '{a:"a"}'
-    assert multi_label.to_string() == ""
-
-
-@pytest.mark.graph
-def test_stringify(fixture):
-    no_args, no_props, props_only, no_label, multi_label = fixture
-    assert str(no_args) == "()"
-    assert str(no_props) == "(alias:l)"
-    assert str(props_only) == '({a:"a",b:10})'
-    assert str(no_label) == '(alias{a:"a"})'
-    assert str(multi_label) == "(alias:l:ll)"
-
-
-@pytest.mark.graph
-def test_comparison(fixture):
-    no_args, no_props, props_only, no_label, multi_label = fixture
-
-    assert node.Node() == node.Node()
-    assert node.Node(node_id=1) == node.Node(node_id=1)
-    assert node.Node(node_id=1) != node.Node(node_id=2)
-    assert node.Node(node_id=1, alias="a") == node.Node(node_id=1, alias="b")
-    assert node.Node(node_id=1, alias="a") == node.Node(node_id=1, alias="a")
-    assert node.Node(node_id=1, label="a") == node.Node(node_id=1, label="a")
-    assert node.Node(node_id=1, label="a") != node.Node(node_id=1, label="b")
-    assert node.Node(node_id=1, alias="a", label="l") == node.Node(
-        node_id=1, alias="a", label="l"
-    )
-    assert node.Node(alias="a", label="l") != node.Node(alias="a", label="l1")
-    assert node.Node(properties={"a": 10}) == node.Node(properties={"a": 10})
-    assert node.Node() != node.Node(properties={"a": 10})
diff --git a/tests/test_graph_utils/test_path.py b/tests/test_graph_utils/test_path.py
deleted file mode 100644
index 33ca041cfa..0000000000
--- a/tests/test_graph_utils/test_path.py
+++ /dev/null
@@ -1,90 +0,0 @@
-import pytest
-from redis.commands.graph import edge, node, path
-
-
-@pytest.mark.graph
-def test_init():
-    with pytest.raises(TypeError):
-        path.Path(None, None)
-        path.Path([], None)
-        path.Path(None, [])
-
-    assert isinstance(path.Path([], []), path.Path)
-
-
-@pytest.mark.graph
-def test_new_empty_path():
-    new_empty_path = path.Path.new_empty_path()
-    assert isinstance(new_empty_path, path.Path)
-    assert new_empty_path._nodes == []
-    assert new_empty_path._edges == []
-
-
-@pytest.mark.graph
-def test_wrong_flows():
-    node_1 = node.Node(node_id=1)
-    node_2 = node.Node(node_id=2)
-    node_3 = node.Node(node_id=3)
-
-    edge_1 = edge.Edge(node_1, None, node_2)
-    edge_2 = edge.Edge(node_1, None, node_3)
-
-    p = path.Path.new_empty_path()
-    with pytest.raises(AssertionError):
-        p.add_edge(edge_1)
-
-    p.add_node(node_1)
-    with pytest.raises(AssertionError):
-        p.add_node(node_2)
-
-    p.add_edge(edge_1)
-    with pytest.raises(AssertionError):
-        p.add_edge(edge_2)
-
-
-@pytest.mark.graph
-def test_nodes_and_edges():
-    node_1 = node.Node(node_id=1)
-    node_2 = node.Node(node_id=2)
-    edge_1 = edge.Edge(node_1, None, node_2)
-
-    p = path.Path.new_empty_path()
-    assert p.nodes() == []
-    p.add_node(node_1)
-    assert [] == p.edges()
-    assert 0 == p.edge_count()
-    assert [node_1] == p.nodes()
-    assert node_1 == p.get_node(0)
-    assert node_1 == p.first_node()
-    assert node_1 == p.last_node()
-    assert 1 == p.nodes_count()
-    p.add_edge(edge_1)
-    assert [edge_1] == p.edges()
-    assert 1 == p.edge_count()
-    assert edge_1 == p.get_relationship(0)
-    p.add_node(node_2)
-    assert [node_1, node_2] == p.nodes()
-    assert node_1 == p.first_node()
-    assert node_2 == p.last_node()
-    assert 2 == p.nodes_count()
-
-
-@pytest.mark.graph
-def test_compare():
-    node_1 = node.Node(node_id=1)
-    node_2 = node.Node(node_id=2)
-    edge_1 = edge.Edge(node_1, None, node_2)
-
-    assert path.Path.new_empty_path() == path.Path.new_empty_path()
-    assert path.Path(nodes=[node_1, node_2], edges=[edge_1]) == path.Path(
-        nodes=[node_1, node_2], edges=[edge_1]
-    )
-    assert path.Path(nodes=[node_1], edges=[]) != path.Path(nodes=[], edges=[])
-    assert path.Path(nodes=[node_1], edges=[]) != path.Path(nodes=[], edges=[])
-    assert path.Path(nodes=[node_1], edges=[]) != path.Path(nodes=[node_2], edges=[])
-    assert path.Path(nodes=[node_1], edges=[edge_1]) != path.Path(
-        nodes=[node_1], edges=[]
-    )
-    assert path.Path(nodes=[node_1], edges=[edge_1]) != path.Path(
-        nodes=[node_2], edges=[edge_1]
-    )
diff --git a/tests/test_helpers.py b/tests/test_helpers.py
index 06265d382e..367700547f 100644
--- a/tests/test_helpers.py
+++ b/tests/test_helpers.py
@@ -5,7 +5,6 @@
     list_or_args,
     nativestr,
     parse_to_list,
-    quote_string,
     random_string,
 )
 
@@ -41,15 +40,3 @@ def test_random_string():
     assert len(random_string(15)) == 15
     for a in random_string():
         assert a in string.ascii_lowercase
-
-
-def test_quote_string():
-    assert quote_string("hello world!") == '"hello world!"'
-    assert quote_string("") == '""'
-    assert quote_string("hello world!") == '"hello world!"'
-    assert quote_string("abc") == '"abc"'
-    assert quote_string("") == '""'
-    assert quote_string('"') == r'"\""'
-    assert quote_string(r"foo \ bar") == r'"foo \\ bar"'
-    assert quote_string(r"foo \" bar") == r'"foo \\\" bar"'
-    assert quote_string('a"a') == r'"a\"a"'

From e4b6de133b6b588e5c0845b34749f83aede89b81 Mon Sep 17 00:00:00 2001
From: andy-stark-redis <164213578+andy-stark-redis@users.noreply.github.com>
Date: Tue, 11 Mar 2025 14:28:36 +0000
Subject: [PATCH 1007/1164] DOC-4736 added geo indexing examples (#3485)

---
 doctests/geo_index.py | 153 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 153 insertions(+)
 create mode 100644 doctests/geo_index.py

diff --git a/doctests/geo_index.py b/doctests/geo_index.py
new file mode 100644
index 0000000000..5e34ec8866
--- /dev/null
+++ b/doctests/geo_index.py
@@ -0,0 +1,153 @@
+# EXAMPLE: geoindex
+import redis
+from redis.commands.json.path import Path
+from redis.commands.search.field import TextField, GeoField, GeoShapeField
+from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.query import Query
+
+r = redis.Redis()
+# REMOVE_START
+try:
+    r.ft("productidx").dropindex(True)
+except redis.exceptions.ResponseError:
+    pass
+
+try:
+    r.ft("geomidx").dropindex(True)
+except redis.exceptions.ResponseError:
+    pass
+
+r.delete("product:46885", "product:46886", "shape:1", "shape:2", "shape:3", "shape:4")
+# REMOVE_END
+
+# STEP_START create_geo_idx
+geo_schema = (
+    GeoField("$.location", as_name="location")
+)
+
+geo_index_create_result = r.ft("productidx").create_index(
+    geo_schema,
+    definition=IndexDefinition(
+        prefix=["product:"], index_type=IndexType.JSON
+    )
+)
+print(geo_index_create_result)  # >>> True
+# STEP_END
+# REMOVE_START
+assert geo_index_create_result
+# REMOVE_END
+
+# STEP_START add_geo_json
+prd46885 = {
+    "description": "Navy Blue Slippers",
+    "price": 45.99,
+    "city": "Denver",
+    "location": "-104.991531, 39.742043"
+}
+
+json_add_result_1 = r.json().set("product:46885", Path.root_path(), prd46885)
+print(json_add_result_1)  # >>> True
+
+prd46886 = {
+    "description": "Bright Green Socks",
+    "price": 25.50,
+    "city": "Fort Collins",
+    "location": "-105.0618814,40.5150098"
+}
+
+json_add_result_2 = r.json().set("product:46886", Path.root_path(), prd46886)
+print(json_add_result_2)  # >>> True
+# STEP_END
+# REMOVE_START
+assert json_add_result_1
+assert json_add_result_2
+# REMOVE_END
+
+# STEP_START geo_query
+geo_result = r.ft("productidx").search(
+    "@location:[-104.800644 38.846127 100 mi]"
+)
+print(geo_result)
+# >>> Result{1 total, docs: [Document {'id': 'product:46885'...
+# STEP_END
+# REMOVE_START
+assert len(geo_result.docs) == 1
+assert geo_result.docs[0]["id"] == "product:46885"
+# REMOVE_END
+
+# STEP_START create_gshape_idx
+geom_schema = (
+    TextField("$.name", as_name="name"),
+    GeoShapeField(
+        "$.geom", as_name="geom", coord_system=GeoShapeField.FLAT
+    )
+)
+
+geom_index_create_result = r.ft("geomidx").create_index(
+    geom_schema,
+    definition=IndexDefinition(
+        prefix=["shape:"], index_type=IndexType.JSON
+    )
+)
+print(geom_index_create_result)  # True
+# STEP_END
+# REMOVE_START
+assert geom_index_create_result
+# REMOVE_END
+
+# STEP_START add_gshape_json
+shape1 = {
+    "name": "Green Square",
+    "geom": "POLYGON ((1 1, 1 3, 3 3, 3 1, 1 1))"
+}
+
+gm_json_res_1 = r.json().set("shape:1", Path.root_path(), shape1)
+print(gm_json_res_1)  # >>> True
+
+shape2 = {
+    "name": "Red Rectangle",
+    "geom": "POLYGON ((2 2.5, 2 3.5, 3.5 3.5, 3.5 2.5, 2 2.5))"
+}
+
+gm_json_res_2 = r.json().set("shape:2", Path.root_path(), shape2)
+print(gm_json_res_2)  # >>> True
+
+shape3 = {
+    "name": "Blue Triangle",
+    "geom": "POLYGON ((3.5 1, 3.75 2, 4 1, 3.5 1))"
+}
+
+gm_json_res_3 = r.json().set("shape:3", Path.root_path(), shape3)
+print(gm_json_res_3)  # >>> True
+
+shape4 = {
+    "name": "Purple Point",
+    "geom": "POINT (2 2)"
+}
+
+gm_json_res_4 = r.json().set("shape:4", Path.root_path(), shape4)
+print(gm_json_res_4)  # >>> True
+# STEP_END
+# REMOVE_START
+assert gm_json_res_1
+assert gm_json_res_2
+assert gm_json_res_3
+assert gm_json_res_4
+# REMOVE_END
+
+# STEP_START gshape_query
+geom_result = r.ft("geomidx").search(
+    Query(
+        "(-@name:(Green Square) @geom:[WITHIN $qshape])"
+    ).dialect(4).paging(0, 1),
+    query_params={
+        "qshape": "POLYGON ((1 1, 1 3, 3 3, 3 1, 1 1))"
+    }
+)
+print(geom_result)
+# >>> Result{1 total, docs: [Document {'id': 'shape:4'...
+# STEP_END
+# REMOVE_START
+assert len(geom_result.docs) == 1
+assert geom_result.docs[0]["id"] == "shape:4"
+# REMOVE_END

From 700a2449c3c7f3145fa24d81e414d4c6083ba2e9 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Wed, 12 Mar 2025 09:26:51 +0200
Subject: [PATCH 1008/1164] Fixing async cluster pipeline execution when client
 is created with cluster_error_retry_attempts=0 (#3545)

---
 redis/asyncio/cluster.py           | 23 +++++++++++------------
 tests/test_asyncio/test_cluster.py | 13 ++++++++++++-
 2 files changed, 23 insertions(+), 13 deletions(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 51dce89597..238f74f850 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -1516,29 +1516,28 @@ async def execute(
             return []
 
         try:
-            for _ in range(self._client.cluster_error_retry_attempts):
-                if self._client._initialize:
-                    await self._client.initialize()
-
+            retry_attempts = self._client.cluster_error_retry_attempts
+            while True:
                 try:
+                    if self._client._initialize:
+                        await self._client.initialize()
                     return await self._execute(
                         self._client,
                         self._command_stack,
                         raise_on_error=raise_on_error,
                         allow_redirections=allow_redirections,
                     )
-                except BaseException as e:
-                    if type(e) in self.__class__.ERRORS_ALLOW_RETRY:
-                        # Try again with the new cluster setup.
-                        exception = e
+
+                except self.__class__.ERRORS_ALLOW_RETRY as e:
+                    if retry_attempts > 0:
+                        # Try again with the new cluster setup. All other errors
+                        # should be raised.
+                        retry_attempts -= 1
                         await self._client.aclose()
                         await asyncio.sleep(0.25)
                     else:
                         # All other errors should be raised.
-                        raise
-
-            # If it fails the configured number of times then raise an exception
-            raise exception
+                        raise e
         finally:
             self._command_stack = []
 
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 9911eced27..4fbfcf62ce 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -2673,6 +2673,17 @@ async def test_redis_cluster_pipeline(self, r: RedisCluster) -> None:
         )
         assert result == [True, b"1", 1, {b"F": b"V"}, True, True, b"2", b"3", 1, 1, 1]
 
+    async def test_cluster_pipeline_execution_zero_cluster_err_retries(
+        self, r: RedisCluster
+    ) -> None:
+        """
+        Test that we can run successfully cluster pipeline execute at least once when
+        cluster_error_retry_attempts is set to 0
+        """
+        r.cluster_error_retry_attempts = 0
+        result = await r.pipeline().set("A", 1).get("A").delete("A").execute()
+        assert result == [True, b"1", 1]
+
     async def test_multi_key_operation_with_a_single_slot(
         self, r: RedisCluster
     ) -> None:
@@ -2733,7 +2744,7 @@ async def parse_response(
                     await pipe.get(key).execute()
                 assert (
                     node.parse_response.await_count
-                    == 3 * r.cluster_error_retry_attempts - 2
+                    == 3 * r.cluster_error_retry_attempts + 1
                 )
 
     async def test_connection_error_not_raised(self, r: RedisCluster) -> None:

From ea01a303ab54e9698689b796dc5c67644425ba51 Mon Sep 17 00:00:00 2001
From: Karolina Surma <33810531+befeleme@users.noreply.github.com>
Date: Wed, 12 Mar 2025 12:23:02 +0100
Subject: [PATCH 1009/1164] Avoid the multiprocessing forkserver method (#3442)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Miro Hrončok <miro@hroncok.cz>
---
 tests/test_multiprocessing.py | 24 +++++++++++++++---------
 1 file changed, 15 insertions(+), 9 deletions(-)

diff --git a/tests/test_multiprocessing.py b/tests/test_multiprocessing.py
index 8b9e9fb90b..f60898ab86 100644
--- a/tests/test_multiprocessing.py
+++ b/tests/test_multiprocessing.py
@@ -1,6 +1,5 @@
 import contextlib
 import multiprocessing
-import sys
 
 import pytest
 import redis
@@ -9,9 +8,6 @@
 
 from .conftest import _get_client
 
-if sys.platform == "darwin":
-    multiprocessing.set_start_method("fork", force=True)
-
 
 @contextlib.contextmanager
 def exit_callback(callback, *args):
@@ -22,6 +18,16 @@ def exit_callback(callback, *args):
 
 
 class TestMultiprocessing:
+    # On macOS and newly non-macOS POSIX systems (since Python 3.14),
+    # the default method has been changed to forkserver.
+    # The code in this module does not work with it,
+    # hence the explicit change to 'fork'
+    # See https://github.com/python/cpython/issues/125714
+    if multiprocessing.get_start_method() == "forkserver":
+        _mp_context = multiprocessing.get_context(method="fork")
+    else:
+        _mp_context = multiprocessing.get_context()
+
     # Test connection sharing between forks.
     # See issue #1085 for details.
 
@@ -45,7 +51,7 @@ def target(conn):
             assert conn.read_response() == b"PONG"
             conn.disconnect()
 
-        proc = multiprocessing.Process(target=target, args=(conn,))
+        proc = self._mp_context.Process(target=target, args=(conn,))
         proc.start()
         proc.join(3)
         assert proc.exitcode == 0
@@ -75,7 +81,7 @@ def target(conn, ev):
                 conn.send_command("ping")
 
         ev = multiprocessing.Event()
-        proc = multiprocessing.Process(target=target, args=(conn, ev))
+        proc = self._mp_context.Process(target=target, args=(conn, ev))
         proc.start()
 
         conn.disconnect()
@@ -143,7 +149,7 @@ def target(pool):
                     assert conn.send_command("ping") is None
                     assert conn.read_response() == b"PONG"
 
-        proc = multiprocessing.Process(target=target, args=(pool,))
+        proc = self._mp_context.Process(target=target, args=(pool,))
         proc.start()
         proc.join(3)
         assert proc.exitcode == 0
@@ -181,7 +187,7 @@ def target(pool, disconnect_event):
 
         ev = multiprocessing.Event()
 
-        proc = multiprocessing.Process(target=target, args=(pool, ev))
+        proc = self._mp_context.Process(target=target, args=(pool, ev))
         proc.start()
 
         pool.disconnect()
@@ -197,7 +203,7 @@ def target(client):
             assert client.ping() is True
             del client
 
-        proc = multiprocessing.Process(target=target, args=(r,))
+        proc = self._mp_context.Process(target=target, args=(r,))
         proc.start()
         proc.join(3)
         assert proc.exitcode == 0

From fa3a0ca8011b67c455831e9bc258aa50f7f255e9 Mon Sep 17 00:00:00 2001
From: Nicolas Noirbent <nicolas@noirbent.fr>
Date: Wed, 12 Mar 2025 18:48:10 +0100
Subject: [PATCH 1010/1164] Avoid stacktrace on process exit in
 Client.__del__() (#3397)

Client.close() may call ConnectionPool.release() or
ConnectionPool.disconnect(); both methods may end up calling
os.getpid() (through ConnectionPool._checkpid() or threading.Lock()
(through ConnectionPool.reset()). As mentioned in the Python
documentation [1], at interpreter shutdown, module globals (in this
case, the os and threading module references) may be deleted or set to
None before __del__() methods are called. This causes an
AttributeError to be raised when trying to run e.g. os.getpid(); while
the error is ignored by the interpreter, the traceback is still
printed out to stderr.

Closes #3014

[1] https://docs.python.org/3/reference/datamodel.html#object.__del__

Co-authored-by: petyaslavova <petya.slavova@redis.com>
---
 redis/client.py  | 5 ++++-
 redis/cluster.py | 5 ++++-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index ea29a864ce..2c4a1fadff 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -570,7 +570,10 @@ def __exit__(self, exc_type, exc_value, traceback):
         self.close()
 
     def __del__(self):
-        self.close()
+        try:
+            self.close()
+        except Exception:
+            pass
 
     def close(self) -> None:
         # In case a connection property does not yet exist
diff --git a/redis/cluster.py b/redis/cluster.py
index 13253ec896..118e67382c 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -663,7 +663,10 @@ def __exit__(self, exc_type, exc_value, traceback):
         self.close()
 
     def __del__(self):
-        self.close()
+        try:
+            self.close()
+        except Exception:
+            pass
 
     def disconnect_connection_pools(self):
         for node in self.get_nodes():

From daf66558590087ead61e913a4230b0f7f79e9387 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 13 Mar 2025 10:22:00 +0200
Subject: [PATCH 1011/1164] Increasing the operations-per-run for stale issues
 GH action (#3556)

---
 .github/workflows/stale-issues.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/stale-issues.yml b/.github/workflows/stale-issues.yml
index 445af1c818..f3bc21bbf3 100644
--- a/.github/workflows/stale-issues.yml
+++ b/.github/workflows/stale-issues.yml
@@ -21,5 +21,5 @@ jobs:
         days-before-close: 30
         stale-issue-label: "Stale"
         stale-pr-label: "Stale"
-        operations-per-run: 10
+        operations-per-run: 20
         remove-stale-when-updated: true

From 922c689aa00e31d82c5dab5effed8ee393cc860b Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 13 Mar 2025 13:19:21 +0200
Subject: [PATCH 1012/1164] Removing support for RedisGears module. (#3553)

---
 redis/cluster.py              |   1 -
 redis/commands/cluster.py     |  10 ---
 redis/commands/core.py        | 127 ----------------------------------
 tests/test_cluster.py         |  44 ------------
 tests/test_commands.py        |  51 --------------
 tests/test_connection_pool.py |   4 +-
 tests/test_multiprocessing.py |   4 +-
 7 files changed, 4 insertions(+), 237 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index 118e67382c..8edf82e413 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -307,7 +307,6 @@ class AbstractRedisCluster:
                 "FUNCTION LIST",
                 "FUNCTION LOAD",
                 "FUNCTION RESTORE",
-                "REDISGEARS_2.REFRESHCLUSTER",
                 "SCAN",
                 "SCRIPT EXISTS",
                 "SCRIPT FLUSH",
diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index f0b65612e0..13f2035265 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -31,13 +31,11 @@
     AsyncACLCommands,
     AsyncDataAccessCommands,
     AsyncFunctionCommands,
-    AsyncGearsCommands,
     AsyncManagementCommands,
     AsyncModuleCommands,
     AsyncScriptCommands,
     DataAccessCommands,
     FunctionCommands,
-    GearsCommands,
     ManagementCommands,
     ModuleCommands,
     PubSubCommands,
@@ -693,12 +691,6 @@ def readwrite(self, target_nodes: Optional["TargetNodesT"] = None) -> ResponseT:
         self.read_from_replicas = False
         return self.execute_command("READWRITE", target_nodes=target_nodes)
 
-    def gears_refresh_cluster(self, **kwargs) -> ResponseT:
-        """
-        On an OSS cluster, before executing any gears function, you must call this command. # noqa
-        """
-        return self.execute_command("REDISGEARS_2.REFRESHCLUSTER", **kwargs)
-
 
 class AsyncClusterManagementCommands(
     ClusterManagementCommands, AsyncManagementCommands
@@ -874,7 +866,6 @@ class RedisClusterCommands(
     ClusterDataAccessCommands,
     ScriptCommands,
     FunctionCommands,
-    GearsCommands,
     ModuleCommands,
     RedisModuleCommands,
 ):
@@ -905,7 +896,6 @@ class AsyncRedisClusterCommands(
     AsyncClusterDataAccessCommands,
     AsyncScriptCommands,
     AsyncFunctionCommands,
-    AsyncGearsCommands,
     AsyncModuleCommands,
     AsyncRedisModuleCommands,
 ):
diff --git a/redis/commands/core.py b/redis/commands/core.py
index b0e5dc6794..df76eafed0 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -6470,131 +6470,6 @@ def function_stats(self) -> Union[Awaitable[List], List]:
 AsyncFunctionCommands = FunctionCommands
 
 
-class GearsCommands:
-    def tfunction_load(
-        self, lib_code: str, replace: bool = False, config: Union[str, None] = None
-    ) -> ResponseT:
-        """
-        Load a new library to RedisGears.
-
-        ``lib_code`` - the library code.
-        ``config`` - a string representation of a JSON object
-        that will be provided to the library on load time,
-        for more information refer to
-        https://github.com/RedisGears/RedisGears/blob/master/docs/function_advance_topics.md#library-configuration
-        ``replace`` - an optional argument, instructs RedisGears to replace the
-        function if its already exists
-
-        For more information see https://redis.io/commands/tfunction-load/
-        """
-        pieces = []
-        if replace:
-            pieces.append("REPLACE")
-        if config is not None:
-            pieces.extend(["CONFIG", config])
-        pieces.append(lib_code)
-        return self.execute_command("TFUNCTION LOAD", *pieces)
-
-    def tfunction_delete(self, lib_name: str) -> ResponseT:
-        """
-        Delete a library from RedisGears.
-
-        ``lib_name`` the library name to delete.
-
-        For more information see https://redis.io/commands/tfunction-delete/
-        """
-        return self.execute_command("TFUNCTION DELETE", lib_name)
-
-    def tfunction_list(
-        self,
-        with_code: bool = False,
-        verbose: int = 0,
-        lib_name: Union[str, None] = None,
-    ) -> ResponseT:
-        """
-        List the functions with additional information about each function.
-
-        ``with_code`` Show libraries code.
-        ``verbose`` output verbosity level, higher number will increase verbosity level
-        ``lib_name`` specifying a library name (can be used multiple times to show multiple libraries in a single command) # noqa
-
-        For more information see https://redis.io/commands/tfunction-list/
-        """
-        pieces = []
-        if with_code:
-            pieces.append("WITHCODE")
-        if verbose >= 1 and verbose <= 3:
-            pieces.append("v" * verbose)
-        else:
-            raise DataError("verbose can be 1, 2 or 3")
-        if lib_name is not None:
-            pieces.append("LIBRARY")
-            pieces.append(lib_name)
-
-        return self.execute_command("TFUNCTION LIST", *pieces)
-
-    def _tfcall(
-        self,
-        lib_name: str,
-        func_name: str,
-        keys: KeysT = None,
-        _async: bool = False,
-        *args: List,
-    ) -> ResponseT:
-        pieces = [f"{lib_name}.{func_name}"]
-        if keys is not None:
-            pieces.append(len(keys))
-            pieces.extend(keys)
-        else:
-            pieces.append(0)
-        if args is not None:
-            pieces.extend(args)
-        if _async:
-            return self.execute_command("TFCALLASYNC", *pieces)
-        return self.execute_command("TFCALL", *pieces)
-
-    def tfcall(
-        self,
-        lib_name: str,
-        func_name: str,
-        keys: KeysT = None,
-        *args: List,
-    ) -> ResponseT:
-        """
-        Invoke a function.
-
-        ``lib_name`` - the library name contains the function.
-        ``func_name`` - the function name to run.
-        ``keys`` - the keys that will be touched by the function.
-        ``args`` - Additional argument to pass to the function.
-
-        For more information see https://redis.io/commands/tfcall/
-        """
-        return self._tfcall(lib_name, func_name, keys, False, *args)
-
-    def tfcall_async(
-        self,
-        lib_name: str,
-        func_name: str,
-        keys: KeysT = None,
-        *args: List,
-    ) -> ResponseT:
-        """
-        Invoke an async function (coroutine).
-
-        ``lib_name`` - the library name contains the function.
-        ``func_name`` - the function name to run.
-        ``keys`` - the keys that will be touched by the function.
-        ``args`` - Additional argument to pass to the function.
-
-        For more information see https://redis.io/commands/tfcall/
-        """
-        return self._tfcall(lib_name, func_name, keys, True, *args)
-
-
-AsyncGearsCommands = GearsCommands
-
-
 class DataAccessCommands(
     BasicKeyCommands,
     HyperlogCommands,
@@ -6638,7 +6513,6 @@ class CoreCommands(
     PubSubCommands,
     ScriptCommands,
     FunctionCommands,
-    GearsCommands,
 ):
     """
     A class containing all of the implemented redis commands. This class is
@@ -6655,7 +6529,6 @@ class AsyncCoreCommands(
     AsyncPubSubCommands,
     AsyncScriptCommands,
     AsyncFunctionCommands,
-    AsyncGearsCommands,
 ):
     """
     A class containing all of the implemented redis commands. This class is
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index bec9a8ecb0..e64db3690b 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -2448,50 +2448,6 @@ def try_delete_libs(self, r, *lib_names):
             except Exception:
                 pass
 
-    @pytest.mark.redismod
-    @skip_if_server_version_lt("7.1.140")
-    def test_tfunction_load_delete(self, r):
-        r.gears_refresh_cluster()
-        self.try_delete_libs(r, "lib1")
-        lib_code = self.generate_lib_code("lib1")
-        assert r.tfunction_load(lib_code)
-        assert r.tfunction_delete("lib1")
-
-    @pytest.mark.redismod
-    @skip_if_server_version_lt("7.1.140")
-    def test_tfunction_list(self, r):
-        r.gears_refresh_cluster()
-        self.try_delete_libs(r, "lib1", "lib2", "lib3")
-        assert r.tfunction_load(self.generate_lib_code("lib1"))
-        assert r.tfunction_load(self.generate_lib_code("lib2"))
-        assert r.tfunction_load(self.generate_lib_code("lib3"))
-
-        # test error thrown when verbose > 4
-        with pytest.raises(DataError):
-            assert r.tfunction_list(verbose=8)
-
-        functions = r.tfunction_list(verbose=1)
-        assert len(functions) == 3
-
-        expected_names = [b"lib1", b"lib2", b"lib3"]
-        actual_names = [functions[0][13], functions[1][13], functions[2][13]]
-
-        assert sorted(expected_names) == sorted(actual_names)
-        assert r.tfunction_delete("lib1")
-        assert r.tfunction_delete("lib2")
-        assert r.tfunction_delete("lib3")
-
-    @pytest.mark.redismod
-    @skip_if_server_version_lt("7.1.140")
-    def test_tfcall(self, r):
-        r.gears_refresh_cluster()
-        self.try_delete_libs(r, "lib1")
-        assert r.tfunction_load(self.generate_lib_code("lib1"))
-        assert r.tfcall("lib1", "foo") == b"bar"
-        assert r.tfcall_async("lib1", "foo") == b"bar"
-
-        assert r.tfunction_delete("lib1")
-
 
 @pytest.mark.onlycluster
 class TestNodesManager:
diff --git a/tests/test_commands.py b/tests/test_commands.py
index c6e39f565d..5c72a019ba 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -2050,57 +2050,6 @@ def try_delete_libs(self, r, *lib_names):
             except Exception:
                 pass
 
-    @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt("7.1.140")
-    @skip_if_server_version_gte("7.9.0")
-    def test_tfunction_load_delete(self, stack_r):
-        self.try_delete_libs(stack_r, "lib1")
-        lib_code = self.generate_lib_code("lib1")
-        assert stack_r.tfunction_load(lib_code)
-        assert stack_r.tfunction_delete("lib1")
-
-    @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt("7.1.140")
-    @skip_if_server_version_gte("7.9.0")
-    def test_tfunction_list(self, stack_r):
-        self.try_delete_libs(stack_r, "lib1", "lib2", "lib3")
-        assert stack_r.tfunction_load(self.generate_lib_code("lib1"))
-        assert stack_r.tfunction_load(self.generate_lib_code("lib2"))
-        assert stack_r.tfunction_load(self.generate_lib_code("lib3"))
-
-        # test error thrown when verbose > 4
-        with pytest.raises(redis.exceptions.DataError):
-            assert stack_r.tfunction_list(verbose=8)
-
-        functions = stack_r.tfunction_list(verbose=1)
-        assert len(functions) == 3
-
-        expected_names = [b"lib1", b"lib2", b"lib3"]
-        if is_resp2_connection(stack_r):
-            actual_names = [functions[0][13], functions[1][13], functions[2][13]]
-        else:
-            actual_names = [
-                functions[0][b"name"],
-                functions[1][b"name"],
-                functions[2][b"name"],
-            ]
-
-        assert sorted(expected_names) == sorted(actual_names)
-        assert stack_r.tfunction_delete("lib1")
-        assert stack_r.tfunction_delete("lib2")
-        assert stack_r.tfunction_delete("lib3")
-
-    @pytest.mark.onlynoncluster
-    @skip_if_server_version_lt("7.1.140")
-    @skip_if_server_version_gte("7.9.0")
-    def test_tfcall(self, stack_r):
-        self.try_delete_libs(stack_r, "lib1")
-        assert stack_r.tfunction_load(self.generate_lib_code("lib1"))
-        assert stack_r.tfcall("lib1", "foo") == b"bar"
-        assert stack_r.tfcall_async("lib1", "foo") == b"bar"
-
-        assert stack_r.tfunction_delete("lib1")
-
     def test_ttl(self, r):
         r["a"] = "1"
         assert r.expire("a", 10)
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index c92d84c226..0ec77a4fff 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -94,11 +94,11 @@ def test_reuse_previously_released_connection(self, master_host):
     def test_release_not_owned_connection(self, master_host):
         connection_kwargs = {"host": master_host[0], "port": master_host[1]}
         pool1 = self.get_pool(connection_kwargs=connection_kwargs)
-        c1 = pool1.get_connection("_")
+        c1 = pool1.get_connection()
         pool2 = self.get_pool(
             connection_kwargs={"host": master_host[0], "port": master_host[1]}
         )
-        c2 = pool2.get_connection("_")
+        c2 = pool2.get_connection()
         pool2.release(c2)
 
         assert len(pool2._available_connections) == 1
diff --git a/tests/test_multiprocessing.py b/tests/test_multiprocessing.py
index f60898ab86..79301b93f1 100644
--- a/tests/test_multiprocessing.py
+++ b/tests/test_multiprocessing.py
@@ -105,11 +105,11 @@ def test_release_parent_connection_from_pool_in_child_process(
             max_connections=max_connections,
         )
 
-        parent_conn = pool.get_connection("ping")
+        parent_conn = pool.get_connection()
 
         def target(pool, parent_conn):
             with exit_callback(pool.disconnect):
-                child_conn = pool.get_connection("ping")
+                child_conn = pool.get_connection()
                 assert child_conn.pid != parent_conn.pid
                 pool.release(child_conn)
                 assert pool._created_connections == 1

From 9251650769f67351bfb51c2da49e26b1b1bf1abe Mon Sep 17 00:00:00 2001
From: Joel Dice <joel.dice@fermyon.com>
Date: Fri, 14 Mar 2025 02:16:56 -0600
Subject: [PATCH 1013/1164] skip `ssl` import if not available (#3078)

* skip `ssl` import if not available

Signed-off-by: Joel Dice <joel.dice@fermyon.com>

* address review feedback and fix lint errors

Signed-off-by: Joel Dice <joel.dice@fermyon.com>

* remove TYPE_CHECKING clause from ssl conditional

Signed-off-by: Joel Dice <joel.dice@fermyon.com>

---------

Signed-off-by: Joel Dice <joel.dice@fermyon.com>
Co-authored-by: petyaslavova <petya.slavova@redis.com>
---
 redis/asyncio/client.py     |  9 +++++++--
 redis/asyncio/cluster.py    | 16 +++++++++++++---
 redis/asyncio/connection.py | 25 ++++++++++++++++++++-----
 redis/connection.py         |  6 +++++-
 4 files changed, 45 insertions(+), 11 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 412d5a24b3..0039cea540 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -2,7 +2,6 @@
 import copy
 import inspect
 import re
-import ssl
 import warnings
 from typing import (
     TYPE_CHECKING,
@@ -72,6 +71,7 @@
 from redis.typing import ChannelT, EncodableT, KeyT
 from redis.utils import (
     HIREDIS_AVAILABLE,
+    SSL_AVAILABLE,
     _set_info_logger,
     deprecated_function,
     get_lib_version,
@@ -79,6 +79,11 @@
     str_if_bytes,
 )
 
+if TYPE_CHECKING and SSL_AVAILABLE:
+    from ssl import TLSVersion
+else:
+    TLSVersion = None
+
 PubSubHandler = Callable[[Dict[str, str]], Awaitable[None]]
 _KeyT = TypeVar("_KeyT", bound=KeyT)
 _ArgT = TypeVar("_ArgT", KeyT, EncodableT)
@@ -226,7 +231,7 @@ def __init__(
         ssl_ca_certs: Optional[str] = None,
         ssl_ca_data: Optional[str] = None,
         ssl_check_hostname: bool = False,
-        ssl_min_version: Optional[ssl.TLSVersion] = None,
+        ssl_min_version: Optional[TLSVersion] = None,
         ssl_ciphers: Optional[str] = None,
         max_connections: Optional[int] = None,
         single_connection_client: bool = False,
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 238f74f850..ba35a7b7b8 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -2,7 +2,6 @@
 import collections
 import random
 import socket
-import ssl
 import warnings
 from typing import (
     Any,
@@ -64,7 +63,18 @@
     TryAgainError,
 )
 from redis.typing import AnyKeyT, EncodableT, KeyT
-from redis.utils import deprecated_function, get_lib_version, safe_str, str_if_bytes
+from redis.utils import (
+    SSL_AVAILABLE,
+    deprecated_function,
+    get_lib_version,
+    safe_str,
+    str_if_bytes,
+)
+
+if SSL_AVAILABLE:
+    from ssl import TLSVersion
+else:
+    TLSVersion = None
 
 TargetNodesT = TypeVar(
     "TargetNodesT", str, "ClusterNode", List["ClusterNode"], Dict[Any, "ClusterNode"]
@@ -247,7 +257,7 @@ def __init__(
         ssl_certfile: Optional[str] = None,
         ssl_check_hostname: bool = False,
         ssl_keyfile: Optional[str] = None,
-        ssl_min_version: Optional[ssl.TLSVersion] = None,
+        ssl_min_version: Optional[TLSVersion] = None,
         ssl_ciphers: Optional[str] = None,
         protocol: Optional[int] = 2,
         address_remap: Optional[Callable[[Tuple[str, int]], Tuple[str, int]]] = None,
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 9b5d0d8eb9..15b9219aaa 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -3,7 +3,6 @@
 import enum
 import inspect
 import socket
-import ssl
 import sys
 import warnings
 import weakref
@@ -27,6 +26,16 @@
 )
 from urllib.parse import ParseResult, parse_qs, unquote, urlparse
 
+from ..utils import SSL_AVAILABLE
+
+if SSL_AVAILABLE:
+    import ssl
+    from ssl import SSLContext, TLSVersion
+else:
+    ssl = None
+    TLSVersion = None
+    SSLContext = None
+
 from ..auth.token import TokenInterface
 from ..event import AsyncAfterConnectionReleasedEvent, EventDispatcher
 from ..utils import deprecated_args, format_error_message
@@ -763,10 +772,13 @@ def __init__(
         ssl_ca_certs: Optional[str] = None,
         ssl_ca_data: Optional[str] = None,
         ssl_check_hostname: bool = False,
-        ssl_min_version: Optional[ssl.TLSVersion] = None,
+        ssl_min_version: Optional[TLSVersion] = None,
         ssl_ciphers: Optional[str] = None,
         **kwargs,
     ):
+        if not SSL_AVAILABLE:
+            raise RedisError("Python wasn't built with SSL support")
+
         self.ssl_context: RedisSSLContext = RedisSSLContext(
             keyfile=ssl_keyfile,
             certfile=ssl_certfile,
@@ -834,9 +846,12 @@ def __init__(
         ca_certs: Optional[str] = None,
         ca_data: Optional[str] = None,
         check_hostname: bool = False,
-        min_version: Optional[ssl.TLSVersion] = None,
+        min_version: Optional[TLSVersion] = None,
         ciphers: Optional[str] = None,
     ):
+        if not SSL_AVAILABLE:
+            raise RedisError("Python wasn't built with SSL support")
+
         self.keyfile = keyfile
         self.certfile = certfile
         if cert_reqs is None:
@@ -857,9 +872,9 @@ def __init__(
         self.check_hostname = check_hostname
         self.min_version = min_version
         self.ciphers = ciphers
-        self.context: Optional[ssl.SSLContext] = None
+        self.context: Optional[SSLContext] = None
 
-    def get(self) -> ssl.SSLContext:
+    def get(self) -> SSLContext:
         if not self.context:
             context = ssl.create_default_context()
             context.check_hostname = self.check_hostname
diff --git a/redis/connection.py b/redis/connection.py
index a298542c03..b6dee40d75 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1,7 +1,6 @@
 import copy
 import os
 import socket
-import ssl
 import sys
 import threading
 import time
@@ -49,6 +48,11 @@
     str_if_bytes,
 )
 
+if SSL_AVAILABLE:
+    import ssl
+else:
+    ssl = None
+
 if HIREDIS_AVAILABLE:
     import hiredis
 

From 5cba97a37ba5f0d01e15f32ade91704216fde0fb Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 18 Mar 2025 10:46:41 +0200
Subject: [PATCH 1014/1164] Fixing search module dropindex function not to send
 invalid third parameter. Updating pipeline infra (#3564)

* Fixing search module dropindex function not to send invalid third parameter. Updating pipeline infra

* Fixing linters
---
 .github/workflows/integration.yaml |  2 +-
 redis/commands/search/commands.py  | 14 ++++++++++++--
 tests/test_asyncio/test_search.py  |  8 ++++----
 tests/test_search.py               | 10 +++++-----
 4 files changed, 22 insertions(+), 12 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index bb56e8a024..514a88a796 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -74,7 +74,7 @@ jobs:
       max-parallel: 15
       fail-fast: false
       matrix:
-        redis-version: ['8.0-M04-pre', '${{ needs.redis_version.outputs.CURRENT }}', '7.2.7', '6.2.17']
+        redis-version: ['8.0-M05-pre', '${{ needs.redis_version.outputs.CURRENT }}', '7.2.7', '6.2.17']
         python-version: ['3.8', '3.13']
         parser-backend: ['plain']
         event-loop: ['asyncio']
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 96c6d9c2af..42866f5ec1 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -255,8 +255,18 @@ def dropindex(self, delete_documents: bool = False):
 
         For more information see `FT.DROPINDEX <https://redis.io/commands/ft.dropindex>`_.
         """  # noqa
-        delete_str = "DD" if delete_documents else ""
-        return self.execute_command(DROPINDEX_CMD, self.index_name, delete_str)
+        args = [DROPINDEX_CMD, self.index_name]
+
+        delete_str = (
+            "DD"
+            if isinstance(delete_documents, bool) and delete_documents is True
+            else ""
+        )
+
+        if delete_str:
+            args.append(delete_str)
+
+        return self.execute_command(*args)
 
     def _add_document(
         self,
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index c55d57f3b2..9a318796bf 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -1603,14 +1603,14 @@ async def test_withsuffixtrie(decoded_r: redis.Redis):
     if is_resp2_connection(decoded_r):
         info = await decoded_r.ft().info()
         assert "WITHSUFFIXTRIE" not in info["attributes"][0]
-        assert await decoded_r.ft().dropindex("idx")
+        assert await decoded_r.ft().dropindex()
 
         # create withsuffixtrie index (text field)
         assert await decoded_r.ft().create_index(TextField("t", withsuffixtrie=True))
         await waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
         info = await decoded_r.ft().info()
         assert "WITHSUFFIXTRIE" in info["attributes"][0]
-        assert await decoded_r.ft().dropindex("idx")
+        assert await decoded_r.ft().dropindex()
 
         # create withsuffixtrie index (tag field)
         assert await decoded_r.ft().create_index(TagField("t", withsuffixtrie=True))
@@ -1620,14 +1620,14 @@ async def test_withsuffixtrie(decoded_r: redis.Redis):
     else:
         info = await decoded_r.ft().info()
         assert "WITHSUFFIXTRIE" not in info["attributes"][0]["flags"]
-        assert await decoded_r.ft().dropindex("idx")
+        assert await decoded_r.ft().dropindex()
 
         # create withsuffixtrie index (text fields)
         assert await decoded_r.ft().create_index(TextField("t", withsuffixtrie=True))
         await waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
         info = await decoded_r.ft().info()
         assert "WITHSUFFIXTRIE" in info["attributes"][0]["flags"]
-        assert await decoded_r.ft().dropindex("idx")
+        assert await decoded_r.ft().dropindex()
 
         # create withsuffixtrie index (tag field)
         assert await decoded_r.ft().create_index(TagField("t", withsuffixtrie=True))
diff --git a/tests/test_search.py b/tests/test_search.py
index 11f22ac805..7e4f59eb79 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1711,7 +1711,7 @@ def test_max_text_fields(client):
     with pytest.raises(redis.ResponseError):
         client.ft().alter_schema_add((TextField(f"f{x}"),))
 
-    client.ft().dropindex("idx")
+    client.ft().dropindex()
     # Creating the index definition
     client.ft().create_index((TextField("f0"),), max_text_fields=True)
     # Fill the index with fields
@@ -2575,14 +2575,14 @@ def test_withsuffixtrie(client: redis.Redis):
     if is_resp2_connection(client):
         info = client.ft().info()
         assert "WITHSUFFIXTRIE" not in info["attributes"][0]
-        assert client.ft().dropindex("idx")
+        assert client.ft().dropindex()
 
         # create withsuffixtrie index (text fields)
         assert client.ft().create_index(TextField("t", withsuffixtrie=True))
         waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
         info = client.ft().info()
         assert "WITHSUFFIXTRIE" in info["attributes"][0]
-        assert client.ft().dropindex("idx")
+        assert client.ft().dropindex()
 
         # create withsuffixtrie index (tag field)
         assert client.ft().create_index(TagField("t", withsuffixtrie=True))
@@ -2592,14 +2592,14 @@ def test_withsuffixtrie(client: redis.Redis):
     else:
         info = client.ft().info()
         assert "WITHSUFFIXTRIE" not in info["attributes"][0]["flags"]
-        assert client.ft().dropindex("idx")
+        assert client.ft().dropindex()
 
         # create withsuffixtrie index (text fields)
         assert client.ft().create_index(TextField("t", withsuffixtrie=True))
         waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
         info = client.ft().info()
         assert "WITHSUFFIXTRIE" in info["attributes"][0]["flags"]
-        assert client.ft().dropindex("idx")
+        assert client.ft().dropindex()
 
         # create withsuffixtrie index (tag field)
         assert client.ft().create_index(TagField("t", withsuffixtrie=True))

From 6317ef5c31bd186f1f612b90854c2addf4340bd2 Mon Sep 17 00:00:00 2001
From: Don Bowman <db@donbowman.ca>
Date: Tue, 18 Mar 2025 11:33:44 -0400
Subject: [PATCH 1015/1164] fix: add TimeoutError handling in get_connection()
 (#1485)

* fix: add TimeoutError handling in get_connection()

In get_connection() we can implicitly call read on
a connection. This can timeout of the underlying TCP
session is gone. With this change we remove it
from the connection pool and get a new connection.

* fix: add TimeoutError handling in get_connection() sync/async

In get_connection() we can implicitly call read on a connection. This
can timeout of the underlying TCP session is gone. With this change we
remove it from the connection pool and get a new connection.

* fix: update version number to match test expectations

* fix: revert version number to 5.2.1, manually uninstall entraid
---
 redis/asyncio/connection.py | 2 +-
 redis/connection.py         | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 15b9219aaa..66dbd09b61 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -1157,7 +1157,7 @@ async def ensure_connection(self, connection: AbstractConnection):
         try:
             if await connection.can_read_destructive():
                 raise ConnectionError("Connection has data") from None
-        except (ConnectionError, OSError):
+        except (ConnectionError, TimeoutError, OSError):
             await connection.disconnect()
             await connection.connect()
             if await connection.can_read_destructive():
diff --git a/redis/connection.py b/redis/connection.py
index b6dee40d75..f754a5165a 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1494,7 +1494,7 @@ def get_connection(self, command_name=None, *keys, **options) -> "Connection":
             try:
                 if connection.can_read() and self.cache is None:
                     raise ConnectionError("Connection has data")
-            except (ConnectionError, OSError):
+            except (ConnectionError, TimeoutError, OSError):
                 connection.disconnect()
                 connection.connect()
                 if connection.can_read():
@@ -1741,7 +1741,7 @@ def get_connection(self, command_name=None, *keys, **options):
             try:
                 if connection.can_read():
                     raise ConnectionError("Connection has data")
-            except (ConnectionError, OSError):
+            except (ConnectionError, TimeoutError, OSError):
                 connection.disconnect()
                 connection.connect()
                 if connection.can_read():

From 7a36e8b7cffdb51746d77f36152764d196ffa87a Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Wed, 19 Mar 2025 09:58:11 +0200
Subject: [PATCH 1016/1164] Adding load balancing strategy configuration to
 cluster clients(replacement for 'read_from_replicas' config) (#3563)

* Adding laod balancing strategy configuration to cluster clients(replacement for 'read_from_replicas' config)

* Fixing linter errors

* Changing the LoadBalancingStrategy type hints to be defined as optional. Fixed wording in pydocs

* Adding integration tests with the different load balancing strategies for read operation

* Fixing linters
---
 redis/asyncio/cluster.py           |  40 ++++++--
 redis/cluster.py                   | 100 +++++++++++++++---
 tests/test_asyncio/test_cluster.py | 139 +++++++++++++++++++++++--
 tests/test_cluster.py              | 160 +++++++++++++++++++++++++++--
 tests/test_multiprocessing.py      |   4 +-
 5 files changed, 400 insertions(+), 43 deletions(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index ba35a7b7b8..e2a4fbe2cc 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -38,6 +38,7 @@
     SLOT_ID,
     AbstractRedisCluster,
     LoadBalancer,
+    LoadBalancingStrategy,
     block_pipeline_command,
     get_node_name,
     parse_cluster_slots,
@@ -65,6 +66,7 @@
 from redis.typing import AnyKeyT, EncodableT, KeyT
 from redis.utils import (
     SSL_AVAILABLE,
+    deprecated_args,
     deprecated_function,
     get_lib_version,
     safe_str,
@@ -121,9 +123,15 @@ class RedisCluster(AbstractRedis, AbstractRedisCluster, AsyncRedisClusterCommand
         | See:
           https://redis.io/docs/manual/scaling/#redis-cluster-configuration-parameters
     :param read_from_replicas:
-        | Enable read from replicas in READONLY mode. You can read possibly stale data.
+        | @deprecated - please use load_balancing_strategy instead
+        | Enable read from replicas in READONLY mode.
           When set to true, read commands will be assigned between the primary and
           its replications in a Round-Robin manner.
+          The data read from replicas is eventually consistent with the data in primary nodes.
+    :param load_balancing_strategy:
+        | Enable read from replicas in READONLY mode and defines the load balancing
+          strategy that will be used for cluster node selection.
+          The data read from replicas is eventually consistent with the data in primary nodes.
     :param reinitialize_steps:
         | Specifies the number of MOVED errors that need to occur before reinitializing
           the whole cluster topology. If a MOVED error occurs and the cluster does not
@@ -216,6 +224,11 @@ def from_url(cls, url: str, **kwargs: Any) -> "RedisCluster":
         "result_callbacks",
     )
 
+    @deprecated_args(
+        args_to_warn=["read_from_replicas"],
+        reason="Please configure the 'load_balancing_strategy' instead",
+        version="5.0.3",
+    )
     def __init__(
         self,
         host: Optional[str] = None,
@@ -224,6 +237,7 @@ def __init__(
         startup_nodes: Optional[List["ClusterNode"]] = None,
         require_full_coverage: bool = True,
         read_from_replicas: bool = False,
+        load_balancing_strategy: Optional[LoadBalancingStrategy] = None,
         reinitialize_steps: int = 5,
         cluster_error_retry_attempts: int = 3,
         connection_error_retry_attempts: int = 3,
@@ -322,7 +336,7 @@ def __init__(
                 }
             )
 
-        if read_from_replicas:
+        if read_from_replicas or load_balancing_strategy:
             # Call our on_connect function to configure READONLY mode
             kwargs["redis_connect_func"] = self.on_connect
 
@@ -371,6 +385,7 @@ def __init__(
         )
         self.encoder = Encoder(encoding, encoding_errors, decode_responses)
         self.read_from_replicas = read_from_replicas
+        self.load_balancing_strategy = load_balancing_strategy
         self.reinitialize_steps = reinitialize_steps
         self.cluster_error_retry_attempts = cluster_error_retry_attempts
         self.connection_error_retry_attempts = connection_error_retry_attempts
@@ -589,6 +604,7 @@ async def _determine_nodes(
             self.nodes_manager.get_node_from_slot(
                 await self._determine_slot(command, *args),
                 self.read_from_replicas and command in READ_COMMANDS,
+                self.load_balancing_strategy if command in READ_COMMANDS else None,
             )
         ]
 
@@ -769,7 +785,11 @@ async def _execute_command(
                     # refresh the target node
                     slot = await self._determine_slot(*args)
                     target_node = self.nodes_manager.get_node_from_slot(
-                        slot, self.read_from_replicas and args[0] in READ_COMMANDS
+                        slot,
+                        self.read_from_replicas and args[0] in READ_COMMANDS,
+                        self.load_balancing_strategy
+                        if args[0] in READ_COMMANDS
+                        else None,
                     )
                     moved = False
 
@@ -1231,17 +1251,23 @@ def _update_moved_slots(self) -> None:
         self._moved_exception = None
 
     def get_node_from_slot(
-        self, slot: int, read_from_replicas: bool = False
+        self,
+        slot: int,
+        read_from_replicas: bool = False,
+        load_balancing_strategy=None,
     ) -> "ClusterNode":
         if self._moved_exception:
             self._update_moved_slots()
 
+        if read_from_replicas is True and load_balancing_strategy is None:
+            load_balancing_strategy = LoadBalancingStrategy.ROUND_ROBIN
+
         try:
-            if read_from_replicas:
-                # get the server index in a Round-Robin manner
+            if len(self.slots_cache[slot]) > 1 and load_balancing_strategy:
+                # get the server index using the strategy defined in load_balancing_strategy
                 primary_name = self.slots_cache[slot][0].name
                 node_idx = self.read_load_balancer.get_server_index(
-                    primary_name, len(self.slots_cache[slot])
+                    primary_name, len(self.slots_cache[slot]), load_balancing_strategy
                 )
                 return self.slots_cache[slot][node_idx]
             return self.slots_cache[slot][0]
diff --git a/redis/cluster.py b/redis/cluster.py
index 8edf82e413..0488608a60 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -4,6 +4,7 @@
 import threading
 import time
 from collections import OrderedDict
+from enum import Enum
 from typing import Any, Callable, Dict, List, Optional, Tuple, Union
 
 from redis._parsers import CommandsParser, Encoder
@@ -482,6 +483,11 @@ class initializer. In the case of conflicting arguments, querystring
         """
         return cls(url=url, **kwargs)
 
+    @deprecated_args(
+        args_to_warn=["read_from_replicas"],
+        reason="Please configure the 'load_balancing_strategy' instead",
+        version="5.0.3",
+    )
     def __init__(
         self,
         host: Optional[str] = None,
@@ -492,6 +498,7 @@ def __init__(
         require_full_coverage: bool = False,
         reinitialize_steps: int = 5,
         read_from_replicas: bool = False,
+        load_balancing_strategy: Optional["LoadBalancingStrategy"] = None,
         dynamic_startup_nodes: bool = True,
         url: Optional[str] = None,
         address_remap: Optional[Callable[[Tuple[str, int]], Tuple[str, int]]] = None,
@@ -520,11 +527,16 @@ def __init__(
             cluster client. If not all slots are covered, RedisClusterException
             will be thrown.
         :param read_from_replicas:
+             @deprecated - please use load_balancing_strategy instead
              Enable read from replicas in READONLY mode. You can read possibly
              stale data.
              When set to true, read commands will be assigned between the
              primary and its replications in a Round-Robin manner.
-         :param dynamic_startup_nodes:
+        :param load_balancing_strategy:
+             Enable read from replicas in READONLY mode and defines the load balancing
+             strategy that will be used for cluster node selection.
+             The data read from replicas is eventually consistent with the data in primary nodes.
+        :param dynamic_startup_nodes:
              Set the RedisCluster's startup nodes to all of the discovered nodes.
              If true (default value), the cluster's discovered nodes will be used to
              determine the cluster nodes-slots mapping in the next topology refresh.
@@ -629,6 +641,7 @@ def __init__(
         self.command_flags = self.__class__.COMMAND_FLAGS.copy()
         self.node_flags = self.__class__.NODE_FLAGS.copy()
         self.read_from_replicas = read_from_replicas
+        self.load_balancing_strategy = load_balancing_strategy
         self.reinitialize_counter = 0
         self.reinitialize_steps = reinitialize_steps
         if event_dispatcher is None:
@@ -683,7 +696,7 @@ def on_connect(self, connection):
         """
         connection.on_connect()
 
-        if self.read_from_replicas:
+        if self.read_from_replicas or self.load_balancing_strategy:
             # Sending READONLY command to server to configure connection as
             # readonly. Since each cluster node may change its server type due
             # to a failover, we should establish a READONLY connection
@@ -810,6 +823,7 @@ def pipeline(self, transaction=None, shard_hint=None):
             cluster_response_callbacks=self.cluster_response_callbacks,
             cluster_error_retry_attempts=self.cluster_error_retry_attempts,
             read_from_replicas=self.read_from_replicas,
+            load_balancing_strategy=self.load_balancing_strategy,
             reinitialize_steps=self.reinitialize_steps,
             lock=self._lock,
         )
@@ -934,7 +948,9 @@ def _determine_nodes(self, *args, **kwargs) -> List["ClusterNode"]:
             # get the node that holds the key's slot
             slot = self.determine_slot(*args)
             node = self.nodes_manager.get_node_from_slot(
-                slot, self.read_from_replicas and command in READ_COMMANDS
+                slot,
+                self.read_from_replicas and command in READ_COMMANDS,
+                self.load_balancing_strategy if command in READ_COMMANDS else None,
             )
             return [node]
 
@@ -1158,7 +1174,11 @@ def _execute_command(self, target_node, *args, **kwargs):
                     # refresh the target node
                     slot = self.determine_slot(*args)
                     target_node = self.nodes_manager.get_node_from_slot(
-                        slot, self.read_from_replicas and command in READ_COMMANDS
+                        slot,
+                        self.read_from_replicas and command in READ_COMMANDS,
+                        self.load_balancing_strategy
+                        if command in READ_COMMANDS
+                        else None,
                     )
                     moved = False
 
@@ -1307,6 +1327,12 @@ def __del__(self):
             self.redis_connection.close()
 
 
+class LoadBalancingStrategy(Enum):
+    ROUND_ROBIN = "round_robin"
+    ROUND_ROBIN_REPLICAS = "round_robin_replicas"
+    RANDOM_REPLICA = "random_replica"
+
+
 class LoadBalancer:
     """
     Round-Robin Load Balancing
@@ -1316,15 +1342,38 @@ def __init__(self, start_index: int = 0) -> None:
         self.primary_to_idx = {}
         self.start_index = start_index
 
-    def get_server_index(self, primary: str, list_size: int) -> int:
-        server_index = self.primary_to_idx.setdefault(primary, self.start_index)
-        # Update the index
-        self.primary_to_idx[primary] = (server_index + 1) % list_size
-        return server_index
+    def get_server_index(
+        self,
+        primary: str,
+        list_size: int,
+        load_balancing_strategy: LoadBalancingStrategy = LoadBalancingStrategy.ROUND_ROBIN,
+    ) -> int:
+        if load_balancing_strategy == LoadBalancingStrategy.RANDOM_REPLICA:
+            return self._get_random_replica_index(list_size)
+        else:
+            return self._get_round_robin_index(
+                primary,
+                list_size,
+                load_balancing_strategy == LoadBalancingStrategy.ROUND_ROBIN_REPLICAS,
+            )
 
     def reset(self) -> None:
         self.primary_to_idx.clear()
 
+    def _get_random_replica_index(self, list_size: int) -> int:
+        return random.randint(1, list_size - 1)
+
+    def _get_round_robin_index(
+        self, primary: str, list_size: int, replicas_only: bool
+    ) -> int:
+        server_index = self.primary_to_idx.setdefault(primary, self.start_index)
+        if replicas_only and server_index == 0:
+            # skip the primary node index
+            server_index = 1
+        # Update the index for the next round
+        self.primary_to_idx[primary] = (server_index + 1) % list_size
+        return server_index
+
 
 class NodesManager:
     def __init__(
@@ -1428,7 +1477,21 @@ def _update_moved_slots(self):
         # Reset moved_exception
         self._moved_exception = None
 
-    def get_node_from_slot(self, slot, read_from_replicas=False, server_type=None):
+    @deprecated_args(
+        args_to_warn=["server_type"],
+        reason=(
+            "In case you need select some load balancing strategy "
+            "that will use replicas, please set it through 'load_balancing_strategy'"
+        ),
+        version="5.0.3",
+    )
+    def get_node_from_slot(
+        self,
+        slot,
+        read_from_replicas=False,
+        load_balancing_strategy=None,
+        server_type=None,
+    ):
         """
         Gets a node that servers this hash slot
         """
@@ -1443,11 +1506,14 @@ def get_node_from_slot(self, slot, read_from_replicas=False, server_type=None):
                 f'"require_full_coverage={self._require_full_coverage}"'
             )
 
-        if read_from_replicas is True:
-            # get the server index in a Round-Robin manner
+        if read_from_replicas is True and load_balancing_strategy is None:
+            load_balancing_strategy = LoadBalancingStrategy.ROUND_ROBIN
+
+        if len(self.slots_cache[slot]) > 1 and load_balancing_strategy:
+            # get the server index using the strategy defined in load_balancing_strategy
             primary_name = self.slots_cache[slot][0].name
             node_idx = self.read_load_balancer.get_server_index(
-                primary_name, len(self.slots_cache[slot])
+                primary_name, len(self.slots_cache[slot]), load_balancing_strategy
             )
         elif (
             server_type is None
@@ -1730,7 +1796,7 @@ def __init__(
         first command execution. The node will be determined by:
          1. Hashing the channel name in the request to find its keyslot
          2. Selecting a node that handles the keyslot: If read_from_replicas is
-            set to true, a replica can be selected.
+            set to true or load_balancing_strategy is set, a replica can be selected.
 
         :type redis_cluster: RedisCluster
         :type node: ClusterNode
@@ -1826,7 +1892,9 @@ def execute_command(self, *args):
                     channel = args[1]
                     slot = self.cluster.keyslot(channel)
                     node = self.cluster.nodes_manager.get_node_from_slot(
-                        slot, self.cluster.read_from_replicas
+                        slot,
+                        self.cluster.read_from_replicas,
+                        self.cluster.load_balancing_strategy,
                     )
                 else:
                     # Get a random node
@@ -1969,6 +2037,7 @@ def __init__(
         cluster_response_callbacks: Optional[Dict[str, Callable]] = None,
         startup_nodes: Optional[List["ClusterNode"]] = None,
         read_from_replicas: bool = False,
+        load_balancing_strategy: Optional[LoadBalancingStrategy] = None,
         cluster_error_retry_attempts: int = 3,
         reinitialize_steps: int = 5,
         lock=None,
@@ -1984,6 +2053,7 @@ def __init__(
         )
         self.startup_nodes = startup_nodes if startup_nodes else []
         self.read_from_replicas = read_from_replicas
+        self.load_balancing_strategy = load_balancing_strategy
         self.command_flags = self.__class__.COMMAND_FLAGS.copy()
         self.cluster_response_callbacks = cluster_response_callbacks
         self.cluster_error_retry_attempts = cluster_error_retry_attempts
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 4fbfcf62ce..f57718b44f 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -14,7 +14,13 @@
 from redis.asyncio.connection import Connection, SSLConnection, async_timeout
 from redis.asyncio.retry import Retry
 from redis.backoff import ExponentialBackoff, NoBackoff, default_backoff
-from redis.cluster import PIPELINE_BLOCKED_COMMANDS, PRIMARY, REPLICA, get_node_name
+from redis.cluster import (
+    PIPELINE_BLOCKED_COMMANDS,
+    PRIMARY,
+    REPLICA,
+    LoadBalancingStrategy,
+    get_node_name,
+)
 from redis.crc import REDIS_CLUSTER_HASH_SLOTS, key_slot
 from redis.exceptions import (
     AskError,
@@ -181,7 +187,18 @@ def cmd_init_mock(self, r: ClusterNode) -> None:
 
             cmd_parser_initialize.side_effect = cmd_init_mock
 
-            return await RedisCluster(*args, **kwargs)
+            # Create a subclass of RedisCluster that overrides __del__
+            class MockedRedisCluster(RedisCluster):
+                def __del__(self):
+                    # Override to prevent connection cleanup attempts
+                    pass
+
+                @property
+                def connection_pool(self):
+                    # Required abstract property implementation
+                    return self.nodes_manager.get_default_node().redis_connection.connection_pool
+
+            return await MockedRedisCluster(*args, **kwargs)
 
 
 def mock_node_resp(node: ClusterNode, response: Any) -> ClusterNode:
@@ -677,7 +694,24 @@ def cmd_init_mock(self, r: ClusterNode) -> None:
                         assert execute_command.failed_calls == 1
                         assert execute_command.successful_calls == 1
 
-    async def test_reading_from_replicas_in_round_robin(self) -> None:
+    @pytest.mark.parametrize(
+        "read_from_replicas,load_balancing_strategy,mocks_srv_ports",
+        [
+            (True, None, [7001, 7002, 7001]),
+            (True, LoadBalancingStrategy.ROUND_ROBIN, [7001, 7002, 7001]),
+            (True, LoadBalancingStrategy.ROUND_ROBIN_REPLICAS, [7002, 7002, 7002]),
+            (True, LoadBalancingStrategy.RANDOM_REPLICA, [7002, 7002, 7002]),
+            (False, LoadBalancingStrategy.ROUND_ROBIN, [7001, 7002, 7001]),
+            (False, LoadBalancingStrategy.ROUND_ROBIN_REPLICAS, [7002, 7002, 7002]),
+            (False, LoadBalancingStrategy.RANDOM_REPLICA, [7002, 7002, 7002]),
+        ],
+    )
+    async def test_reading_with_load_balancing_strategies(
+        self,
+        read_from_replicas: bool,
+        load_balancing_strategy: LoadBalancingStrategy,
+        mocks_srv_ports: List[int],
+    ) -> None:
         with mock.patch.multiple(
             Connection,
             send_command=mock.DEFAULT,
@@ -693,19 +727,19 @@ async def test_reading_from_replicas_in_round_robin(self) -> None:
                 async def execute_command_mock_first(self, *args, **options):
                     await self.connection_class(**self.connection_kwargs).connect()
                     # Primary
-                    assert self.port == 7001
+                    assert self.port == mocks_srv_ports[0]
                     execute_command.side_effect = execute_command_mock_second
                     return "MOCK_OK"
 
                 def execute_command_mock_second(self, *args, **options):
                     # Replica
-                    assert self.port == 7002
+                    assert self.port == mocks_srv_ports[1]
                     execute_command.side_effect = execute_command_mock_third
                     return "MOCK_OK"
 
                 def execute_command_mock_third(self, *args, **options):
                     # Primary
-                    assert self.port == 7001
+                    assert self.port == mocks_srv_ports[2]
                     return "MOCK_OK"
 
                 # We don't need to create a real cluster connection but we
@@ -720,9 +754,13 @@ def execute_command_mock_third(self, *args, **options):
 
                 # Create a cluster with reading from replications
                 read_cluster = await get_mocked_redis_client(
-                    host=default_host, port=default_port, read_from_replicas=True
+                    host=default_host,
+                    port=default_port,
+                    read_from_replicas=read_from_replicas,
+                    load_balancing_strategy=load_balancing_strategy,
                 )
-                assert read_cluster.read_from_replicas is True
+                assert read_cluster.read_from_replicas is read_from_replicas
+                assert read_cluster.load_balancing_strategy is load_balancing_strategy
                 # Check that we read from the slot's nodes in a round robin
                 # matter.
                 # 'foo' belongs to slot 12182 and the slot's nodes are:
@@ -970,6 +1008,34 @@ async def test_get_and_set(self, r: RedisCluster) -> None:
         assert await r.get("integer") == str(integer).encode()
         assert (await r.get("unicode_string")).decode("utf-8") == unicode_string
 
+    @pytest.mark.parametrize(
+        "load_balancing_strategy",
+        [
+            LoadBalancingStrategy.ROUND_ROBIN,
+            LoadBalancingStrategy.ROUND_ROBIN_REPLICAS,
+            LoadBalancingStrategy.RANDOM_REPLICA,
+        ],
+    )
+    async def test_get_and_set_with_load_balanced_client(
+        self, create_redis, load_balancing_strategy: LoadBalancingStrategy
+    ) -> None:
+        r = await create_redis(
+            cls=RedisCluster,
+            load_balancing_strategy=load_balancing_strategy,
+        )
+
+        # get and set can't be tested independently of each other
+        assert await r.get("a") is None
+
+        byte_string = b"value"
+        assert await r.set("byte_string", byte_string)
+
+        # run the get command for the same key several times
+        # to iterate over the read nodes
+        assert await r.get("byte_string") == byte_string
+        assert await r.get("byte_string") == byte_string
+        assert await r.get("byte_string") == byte_string
+
     async def test_mget_nonatomic(self, r: RedisCluster) -> None:
         assert await r.mget_nonatomic([]) == []
         assert await r.mget_nonatomic(["a", "b"]) == [None, None]
@@ -2370,11 +2436,14 @@ async def test_load_balancer(self, r: RedisCluster) -> None:
         primary2_name = n_manager.slots_cache[slot_2][0].name
         list1_size = len(n_manager.slots_cache[slot_1])
         list2_size = len(n_manager.slots_cache[slot_2])
+
+        # default load balancer strategy: LoadBalancerStrategy.ROUND_ROBIN
         # slot 1
         assert lb.get_server_index(primary1_name, list1_size) == 0
         assert lb.get_server_index(primary1_name, list1_size) == 1
         assert lb.get_server_index(primary1_name, list1_size) == 2
         assert lb.get_server_index(primary1_name, list1_size) == 0
+
         # slot 2
         assert lb.get_server_index(primary2_name, list2_size) == 0
         assert lb.get_server_index(primary2_name, list2_size) == 1
@@ -2384,6 +2453,29 @@ async def test_load_balancer(self, r: RedisCluster) -> None:
         assert lb.get_server_index(primary1_name, list1_size) == 0
         assert lb.get_server_index(primary2_name, list2_size) == 0
 
+        # reset the indexes before load balancing strategy test
+        lb.reset()
+        # load balancer strategy: LoadBalancerStrategy.ROUND_ROBIN_REPLICAS
+        for i in [1, 2, 1]:
+            srv_index = lb.get_server_index(
+                primary1_name,
+                list1_size,
+                load_balancing_strategy=LoadBalancingStrategy.ROUND_ROBIN_REPLICAS,
+            )
+            assert srv_index == i
+
+        # reset the indexes before load balancing strategy test
+        lb.reset()
+        # load balancer strategy: LoadBalancerStrategy.RANDOM_REPLICA
+        for i in range(5):
+            srv_index = lb.get_server_index(
+                primary1_name,
+                list1_size,
+                load_balancing_strategy=LoadBalancingStrategy.RANDOM_REPLICA,
+            )
+
+            assert srv_index > 0 and srv_index <= 2
+
     async def test_init_slots_cache_not_all_slots_covered(self) -> None:
         """
         Test that if not all slots are covered it should raise an exception
@@ -2866,6 +2958,37 @@ async def test_readonly_pipeline_from_readonly_client(
                         break
             assert executed_on_replica
 
+    @pytest.mark.parametrize(
+        "load_balancing_strategy",
+        [
+            LoadBalancingStrategy.ROUND_ROBIN_REPLICAS,
+            LoadBalancingStrategy.RANDOM_REPLICA,
+        ],
+    )
+    async def test_readonly_pipeline_with_reading_from_replicas_strategies(
+        self, r: RedisCluster, load_balancing_strategy: LoadBalancingStrategy
+    ) -> None:
+        """
+        Test that the pipeline uses replicas for different replica-based
+        load balancing strategies.
+        """
+        # Set the load balancing strategy
+        r.load_balancing_strategy = load_balancing_strategy
+        key = "bar"
+        await r.set(key, "foo")
+
+        async with r.pipeline() as pipe:
+            mock_all_nodes_resp(r, "MOCK_OK")
+            assert await pipe.get(key).get(key).execute() == ["MOCK_OK", "MOCK_OK"]
+            slot_nodes = r.nodes_manager.slots_cache[r.keyslot(key)]
+            executed_on_replicas_only = True
+            for node in slot_nodes:
+                if node.server_type == PRIMARY:
+                    if node._free.pop().read_response.await_count > 0:
+                        executed_on_replicas_only = False
+                        break
+            assert executed_on_replicas_only
+
     async def test_can_run_concurrent_pipelines(self, r: RedisCluster) -> None:
         """Test that the pipeline can be used concurrently."""
         await asyncio.gather(
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index e64db3690b..b71908d396 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -4,6 +4,7 @@
 import socket
 import socketserver
 import threading
+from typing import List
 import warnings
 from queue import LifoQueue, Queue
 from time import sleep
@@ -19,6 +20,7 @@
     REDIS_CLUSTER_HASH_SLOTS,
     REPLICA,
     ClusterNode,
+    LoadBalancingStrategy,
     NodesManager,
     RedisCluster,
     get_node_name,
@@ -202,7 +204,18 @@ def cmd_init_mock(self, r):
 
             cmd_parser_initialize.side_effect = cmd_init_mock
 
-            return RedisCluster(*args, **kwargs)
+            # Create a subclass of RedisCluster that overrides __del__
+            class MockedRedisCluster(RedisCluster):
+                def __del__(self):
+                    # Override to prevent connection cleanup attempts
+                    pass
+
+                @property
+                def connection_pool(self):
+                    # Required abstract property implementation
+                    return self.nodes_manager.get_default_node().redis_connection.connection_pool
+
+            return MockedRedisCluster(*args, **kwargs)
 
 
 def mock_node_resp(node, response):
@@ -590,7 +603,24 @@ def cmd_init_mock(self, r):
                         assert parse_response.failed_calls == 1
                         assert parse_response.successful_calls == 1
 
-    def test_reading_from_replicas_in_round_robin(self):
+    @pytest.mark.parametrize(
+        "read_from_replicas,load_balancing_strategy,mocks_srv_ports",
+        [
+            (True, None, [7001, 7002, 7001]),
+            (True, LoadBalancingStrategy.ROUND_ROBIN, [7001, 7002, 7001]),
+            (True, LoadBalancingStrategy.ROUND_ROBIN_REPLICAS, [7002, 7002, 7002]),
+            (True, LoadBalancingStrategy.RANDOM_REPLICA, [7002, 7002, 7002]),
+            (False, LoadBalancingStrategy.ROUND_ROBIN, [7001, 7002, 7001]),
+            (False, LoadBalancingStrategy.ROUND_ROBIN_REPLICAS, [7002, 7002, 7002]),
+            (False, LoadBalancingStrategy.RANDOM_REPLICA, [7002, 7002, 7002]),
+        ],
+    )
+    def test_reading_with_load_balancing_strategies(
+        self,
+        read_from_replicas: bool,
+        load_balancing_strategy: LoadBalancingStrategy,
+        mocks_srv_ports: List[int],
+    ):
         with patch.multiple(
             Connection,
             send_command=DEFAULT,
@@ -603,19 +633,19 @@ def test_reading_from_replicas_in_round_robin(self):
 
                 def parse_response_mock_first(connection, *args, **options):
                     # Primary
-                    assert connection.port == 7001
+                    assert connection.port == mocks_srv_ports[0]
                     parse_response.side_effect = parse_response_mock_second
                     return "MOCK_OK"
 
                 def parse_response_mock_second(connection, *args, **options):
                     # Replica
-                    assert connection.port == 7002
+                    assert connection.port == mocks_srv_ports[1]
                     parse_response.side_effect = parse_response_mock_third
                     return "MOCK_OK"
 
                 def parse_response_mock_third(connection, *args, **options):
                     # Primary
-                    assert connection.port == 7001
+                    assert connection.port == mocks_srv_ports[2]
                     return "MOCK_OK"
 
                 # We don't need to create a real cluster connection but we
@@ -630,9 +660,13 @@ def parse_response_mock_third(connection, *args, **options):
 
                 # Create a cluster with reading from replications
                 read_cluster = get_mocked_redis_client(
-                    host=default_host, port=default_port, read_from_replicas=True
+                    host=default_host,
+                    port=default_port,
+                    read_from_replicas=read_from_replicas,
+                    load_balancing_strategy=load_balancing_strategy,
                 )
-                assert read_cluster.read_from_replicas is True
+                assert read_cluster.read_from_replicas is read_from_replicas
+                assert read_cluster.load_balancing_strategy is load_balancing_strategy
                 # Check that we read from the slot's nodes in a round robin
                 # matter.
                 # 'foo' belongs to slot 12182 and the slot's nodes are:
@@ -640,16 +674,27 @@ def parse_response_mock_third(connection, *args, **options):
                 read_cluster.get("foo")
                 read_cluster.get("foo")
                 read_cluster.get("foo")
-                mocks["send_command"].assert_has_calls(
+                expected_calls_list = []
+                expected_calls_list.append(call("READONLY"))
+                expected_calls_list.append(call("GET", "foo", keys=["foo"]))
+
+                if (
+                    load_balancing_strategy is None
+                    or load_balancing_strategy == LoadBalancingStrategy.ROUND_ROBIN
+                ):
+                    # in the round robin strategy the primary node can also receive read
+                    # requests and this means that there will be second node connected
+                    expected_calls_list.append(call("READONLY"))
+
+                expected_calls_list.extend(
                     [
-                        call("READONLY"),
-                        call("GET", "foo", keys=["foo"]),
-                        call("READONLY"),
                         call("GET", "foo", keys=["foo"]),
                         call("GET", "foo", keys=["foo"]),
                     ]
                 )
 
+                mocks["send_command"].assert_has_calls(expected_calls_list)
+
     def test_keyslot(self, r):
         """
         Test that method will compute correct key in all supported cases
@@ -975,6 +1020,35 @@ def test_get_and_set(self, r):
         assert r.get("integer") == str(integer).encode()
         assert r.get("unicode_string").decode("utf-8") == unicode_string
 
+    @pytest.mark.parametrize(
+        "load_balancing_strategy",
+        [
+            LoadBalancingStrategy.ROUND_ROBIN,
+            LoadBalancingStrategy.ROUND_ROBIN_REPLICAS,
+            LoadBalancingStrategy.RANDOM_REPLICA,
+        ],
+    )
+    def test_get_and_set_with_load_balanced_client(
+        self, request, load_balancing_strategy: LoadBalancingStrategy
+    ) -> None:
+        r = _get_client(
+            cls=RedisCluster,
+            request=request,
+            load_balancing_strategy=load_balancing_strategy,
+        )
+
+        # get and set can't be tested independently of each other
+        assert r.get("a") is None
+
+        byte_string = b"value"
+        assert r.set("byte_string", byte_string)
+
+        # run the get command for the same key several times
+        # to iterate over the read nodes
+        assert r.get("byte_string") == byte_string
+        assert r.get("byte_string") == byte_string
+        assert r.get("byte_string") == byte_string
+
     def test_mget_nonatomic(self, r):
         assert r.mget_nonatomic([]) == []
         assert r.mget_nonatomic(["a", "b"]) == [None, None]
@@ -2473,6 +2547,8 @@ def test_load_balancer(self, r):
         primary2_name = n_manager.slots_cache[slot_2][0].name
         list1_size = len(n_manager.slots_cache[slot_1])
         list2_size = len(n_manager.slots_cache[slot_2])
+
+        # default load balancer strategy: LoadBalancerStrategy.ROUND_ROBIN
         # slot 1
         assert lb.get_server_index(primary1_name, list1_size) == 0
         assert lb.get_server_index(primary1_name, list1_size) == 1
@@ -2487,6 +2563,29 @@ def test_load_balancer(self, r):
         assert lb.get_server_index(primary1_name, list1_size) == 0
         assert lb.get_server_index(primary2_name, list2_size) == 0
 
+        # reset the indexes before load balancing strategy test
+        lb.reset()
+        # load balancer strategy: LoadBalancerStrategy.ROUND_ROBIN_REPLICAS
+        for i in [1, 2, 1]:
+            srv_index = lb.get_server_index(
+                primary1_name,
+                list1_size,
+                load_balancing_strategy=LoadBalancingStrategy.ROUND_ROBIN_REPLICAS,
+            )
+            assert srv_index == i
+
+        # reset the indexes before load balancing strategy test
+        lb.reset()  # reset the indexes
+        # load balancer strategy: LoadBalancerStrategy.RANDOM_REPLICA
+        for i in range(5):
+            srv_index = lb.get_server_index(
+                primary1_name,
+                list1_size,
+                load_balancing_strategy=LoadBalancingStrategy.RANDOM_REPLICA,
+            )
+
+            assert srv_index > 0 and srv_index <= 2
+
     def test_init_slots_cache_not_all_slots_covered(self):
         """
         Test that if not all slots are covered it should raise an exception
@@ -3333,6 +3432,45 @@ def test_readonly_pipeline_from_readonly_client(self, request):
                             break
                 assert executed_on_replica is True
 
+    @pytest.mark.parametrize(
+        "load_balancing_strategy",
+        [
+            LoadBalancingStrategy.ROUND_ROBIN_REPLICAS,
+            LoadBalancingStrategy.RANDOM_REPLICA,
+        ],
+    )
+    def test_readonly_pipeline_with_reading_from_replicas_strategies(
+        self, request, load_balancing_strategy: LoadBalancingStrategy
+    ) -> None:
+        """
+        Test that the pipeline uses replicas for different replica-based
+        load balancing strategies.
+        """
+        ro = _get_client(
+            RedisCluster,
+            request,
+            load_balancing_strategy=load_balancing_strategy,
+        )
+        key = "bar"
+        ro.set(key, "foo")
+        import time
+
+        time.sleep(0.2)
+
+        with ro.pipeline() as readonly_pipe:
+            mock_all_nodes_resp(ro, "MOCK_OK")
+            assert readonly_pipe.load_balancing_strategy == load_balancing_strategy
+            assert readonly_pipe.get(key).get(key).execute() == ["MOCK_OK", "MOCK_OK"]
+            slot_nodes = ro.nodes_manager.slots_cache[ro.keyslot(key)]
+            executed_on_replicas_only = True
+            for node in slot_nodes:
+                if node.server_type == PRIMARY:
+                    conn = node.redis_connection.connection
+                    if conn.read_response.called:
+                        executed_on_replicas_only = False
+                        break
+            assert executed_on_replicas_only
+
 
 @pytest.mark.onlycluster
 class TestClusterMonitor:
diff --git a/tests/test_multiprocessing.py b/tests/test_multiprocessing.py
index 79301b93f1..549eeb49a2 100644
--- a/tests/test_multiprocessing.py
+++ b/tests/test_multiprocessing.py
@@ -23,7 +23,7 @@ class TestMultiprocessing:
     # The code in this module does not work with it,
     # hence the explicit change to 'fork'
     # See https://github.com/python/cpython/issues/125714
-    if multiprocessing.get_start_method() == "forkserver":
+    if multiprocessing.get_start_method() in ["forkserver", "spawn"]:
         _mp_context = multiprocessing.get_context(method="fork")
     else:
         _mp_context = multiprocessing.get_context()
@@ -119,7 +119,7 @@ def target(pool, parent_conn):
                 assert child_conn in pool._available_connections
                 assert parent_conn not in pool._available_connections
 
-        proc = multiprocessing.Process(target=target, args=(pool, parent_conn))
+        proc = self._mp_context.Process(target=target, args=(pool, parent_conn))
         proc.start()
         proc.join(3)
         assert proc.exitcode == 0

From 57a95cfacbe8c0efc728b10740783e22e25484d1 Mon Sep 17 00:00:00 2001
From: Jim Cameron-Burn <james.cameronburn@icloud.com>
Date: Mon, 24 Mar 2025 05:31:04 +0000
Subject: [PATCH 1017/1164] Exponential with jitter backoff (#3550)

---
 redis/backoff.py      | 15 +++++++++++++++
 tests/test_backoff.py | 18 ++++++++++++++++++
 2 files changed, 33 insertions(+)
 create mode 100644 tests/test_backoff.py

diff --git a/redis/backoff.py b/redis/backoff.py
index f612d60704..e236764d71 100644
--- a/redis/backoff.py
+++ b/redis/backoff.py
@@ -110,5 +110,20 @@ def compute(self, failures: int) -> float:
         return self._previous_backoff
 
 
+class ExponentialWithJitterBackoff(AbstractBackoff):
+    """Exponential backoff upon failure, with jitter"""
+
+    def __init__(self, cap: float = DEFAULT_CAP, base: float = DEFAULT_BASE) -> None:
+        """
+        `cap`: maximum backoff time in seconds
+        `base`: base backoff time in seconds
+        """
+        self._cap = cap
+        self._base = base
+
+    def compute(self, failures: int) -> float:
+        return min(self._cap, random.random() * self._base * 2**failures)
+
+
 def default_backoff():
     return EqualJitterBackoff()
diff --git a/tests/test_backoff.py b/tests/test_backoff.py
new file mode 100644
index 0000000000..0a491276ff
--- /dev/null
+++ b/tests/test_backoff.py
@@ -0,0 +1,18 @@
+from unittest.mock import Mock
+
+import pytest
+
+from redis.backoff import ExponentialWithJitterBackoff
+
+
+def test_exponential_with_jitter_backoff(monkeypatch: pytest.MonkeyPatch) -> None:
+    mock_random = Mock(side_effect=[0.25, 0.5, 0.75, 1.0, 0.9])
+    monkeypatch.setattr("random.random", mock_random)
+
+    bo = ExponentialWithJitterBackoff(cap=5, base=1)
+
+    assert bo.compute(0) == 0.25  # min(5, 0.25*2^0)
+    assert bo.compute(1) == 1.0  # min(5, 0.5*2^1)
+    assert bo.compute(2) == 3.0  # min(5, 0.75*2^2)
+    assert bo.compute(3) == 5.0  # min(5, 1*2^3)
+    assert bo.compute(4) == 5.0  # min(5, 0.9*2^4)

From 052e8ee9f193bdb307f1c3725085ede9eccce1ca Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Mon, 24 Mar 2025 14:28:21 +0200
Subject: [PATCH 1018/1164] Adding new hash commands with expiration options -
 HGETDEL, HGETEX, HSETEX (#3570)

---
 redis/commands/core.py              | 272 ++++++++++++++++++++-------
 redis/utils.py                      |  43 ++++-
 tests/test_asyncio/test_commands.py |  13 +-
 tests/test_asyncio/test_hash.py     | 276 ++++++++++++++++++++++++++++
 tests/test_asyncio/test_utils.py    |   8 +
 tests/test_commands.py              |  14 +-
 tests/test_hash.py                  | 247 +++++++++++++++++++++++++
 tests/test_utils.py                 |   7 +
 8 files changed, 788 insertions(+), 92 deletions(-)
 create mode 100644 tests/test_asyncio/test_utils.py

diff --git a/redis/commands/core.py b/redis/commands/core.py
index df76eafed0..271f640dec 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3,6 +3,7 @@
 import datetime
 import hashlib
 import warnings
+from enum import Enum
 from typing import (
     TYPE_CHECKING,
     Any,
@@ -44,6 +45,10 @@
     TimeoutSecT,
     ZScoreBoundT,
 )
+from redis.utils import (
+    deprecated_function,
+    extract_expire_flags,
+)
 
 from .helpers import list_or_args
 
@@ -1837,10 +1842,10 @@ def getdel(self, name: KeyT) -> ResponseT:
     def getex(
         self,
         name: KeyT,
-        ex: Union[ExpiryT, None] = None,
-        px: Union[ExpiryT, None] = None,
-        exat: Union[AbsExpiryT, None] = None,
-        pxat: Union[AbsExpiryT, None] = None,
+        ex: Optional[ExpiryT] = None,
+        px: Optional[ExpiryT] = None,
+        exat: Optional[AbsExpiryT] = None,
+        pxat: Optional[AbsExpiryT] = None,
         persist: bool = False,
     ) -> ResponseT:
         """
@@ -1863,7 +1868,6 @@ def getex(
 
         For more information see https://redis.io/commands/getex
         """
-
         opset = {ex, px, exat, pxat}
         if len(opset) > 2 or len(opset) > 1 and persist:
             raise DataError(
@@ -1871,33 +1875,12 @@ def getex(
                 "and ``persist`` are mutually exclusive."
             )
 
-        pieces: list[EncodableT] = []
-        # similar to set command
-        if ex is not None:
-            pieces.append("EX")
-            if isinstance(ex, datetime.timedelta):
-                ex = int(ex.total_seconds())
-            pieces.append(ex)
-        if px is not None:
-            pieces.append("PX")
-            if isinstance(px, datetime.timedelta):
-                px = int(px.total_seconds() * 1000)
-            pieces.append(px)
-        # similar to pexpireat command
-        if exat is not None:
-            pieces.append("EXAT")
-            if isinstance(exat, datetime.datetime):
-                exat = int(exat.timestamp())
-            pieces.append(exat)
-        if pxat is not None:
-            pieces.append("PXAT")
-            if isinstance(pxat, datetime.datetime):
-                pxat = int(pxat.timestamp() * 1000)
-            pieces.append(pxat)
+        exp_options: list[EncodableT] = extract_expire_flags(ex, px, exat, pxat)
+
         if persist:
-            pieces.append("PERSIST")
+            exp_options.append("PERSIST")
 
-        return self.execute_command("GETEX", name, *pieces)
+        return self.execute_command("GETEX", name, *exp_options)
 
     def __getitem__(self, name: KeyT):
         """
@@ -2255,14 +2238,14 @@ def set(
         self,
         name: KeyT,
         value: EncodableT,
-        ex: Union[ExpiryT, None] = None,
-        px: Union[ExpiryT, None] = None,
+        ex: Optional[ExpiryT] = None,
+        px: Optional[ExpiryT] = None,
         nx: bool = False,
         xx: bool = False,
         keepttl: bool = False,
         get: bool = False,
-        exat: Union[AbsExpiryT, None] = None,
-        pxat: Union[AbsExpiryT, None] = None,
+        exat: Optional[AbsExpiryT] = None,
+        pxat: Optional[AbsExpiryT] = None,
     ) -> ResponseT:
         """
         Set the value at key ``name`` to ``value``
@@ -2292,36 +2275,21 @@ def set(
 
         For more information see https://redis.io/commands/set
         """
+        opset = {ex, px, exat, pxat}
+        if len(opset) > 2 or len(opset) > 1 and keepttl:
+            raise DataError(
+                "``ex``, ``px``, ``exat``, ``pxat``, "
+                "and ``keepttl`` are mutually exclusive."
+            )
+
+        if nx and xx:
+            raise DataError("``nx`` and ``xx`` are mutually exclusive.")
+
         pieces: list[EncodableT] = [name, value]
         options = {}
-        if ex is not None:
-            pieces.append("EX")
-            if isinstance(ex, datetime.timedelta):
-                pieces.append(int(ex.total_seconds()))
-            elif isinstance(ex, int):
-                pieces.append(ex)
-            elif isinstance(ex, str) and ex.isdigit():
-                pieces.append(int(ex))
-            else:
-                raise DataError("ex must be datetime.timedelta or int")
-        if px is not None:
-            pieces.append("PX")
-            if isinstance(px, datetime.timedelta):
-                pieces.append(int(px.total_seconds() * 1000))
-            elif isinstance(px, int):
-                pieces.append(px)
-            else:
-                raise DataError("px must be datetime.timedelta or int")
-        if exat is not None:
-            pieces.append("EXAT")
-            if isinstance(exat, datetime.datetime):
-                exat = int(exat.timestamp())
-            pieces.append(exat)
-        if pxat is not None:
-            pieces.append("PXAT")
-            if isinstance(pxat, datetime.datetime):
-                pxat = int(pxat.timestamp() * 1000)
-            pieces.append(pxat)
+
+        pieces.extend(extract_expire_flags(ex, px, exat, pxat))
+
         if keepttl:
             pieces.append("KEEPTTL")
 
@@ -4940,6 +4908,16 @@ def pfmerge(self, dest: KeyT, *sources: KeyT) -> ResponseT:
 AsyncHyperlogCommands = HyperlogCommands
 
 
+class HashDataPersistOptions(Enum):
+    # set the value for each provided key to each
+    # provided value only if all do not already exist.
+    FNX = "FNX"
+
+    # set the value for each provided key to each
+    # provided value only if all already exist.
+    FXX = "FXX"
+
+
 class HashCommands(CommandsProtocol):
     """
     Redis commands for Hash data type.
@@ -4980,6 +4958,80 @@ def hgetall(self, name: str) -> Union[Awaitable[dict], dict]:
         """
         return self.execute_command("HGETALL", name, keys=[name])
 
+    def hgetdel(
+        self, name: str, *keys: str
+    ) -> Union[
+        Awaitable[Optional[List[Union[str, bytes]]]], Optional[List[Union[str, bytes]]]
+    ]:
+        """
+        Return the value of ``key`` within the hash ``name`` and
+        delete the field in the hash.
+        This command is similar to HGET, except for the fact that it also deletes
+        the key on success from the hash with the provided ```name```.
+
+        Available since Redis 8.0
+        For more information see https://redis.io/commands/hgetdel
+        """
+        if len(keys) == 0:
+            raise DataError("'hgetdel' should have at least one key provided")
+
+        return self.execute_command("HGETDEL", name, "FIELDS", len(keys), *keys)
+
+    def hgetex(
+        self,
+        name: KeyT,
+        *keys: str,
+        ex: Optional[ExpiryT] = None,
+        px: Optional[ExpiryT] = None,
+        exat: Optional[AbsExpiryT] = None,
+        pxat: Optional[AbsExpiryT] = None,
+        persist: bool = False,
+    ) -> Union[
+        Awaitable[Optional[List[Union[str, bytes]]]], Optional[List[Union[str, bytes]]]
+    ]:
+        """
+        Return the values of ``key`` and ``keys`` within the hash ``name``
+        and optionally set their expiration.
+
+        ``ex`` sets an expire flag on ``kyes`` for ``ex`` seconds.
+
+        ``px`` sets an expire flag on ``keys`` for ``px`` milliseconds.
+
+        ``exat`` sets an expire flag on ``keys`` for ``ex`` seconds,
+        specified in unix time.
+
+        ``pxat`` sets an expire flag on ``keys`` for ``ex`` milliseconds,
+        specified in unix time.
+
+        ``persist`` remove the time to live associated with the ``keys``.
+
+        Available since Redis 8.0
+        For more information see https://redis.io/commands/hgetex
+        """
+        if not keys:
+            raise DataError("'hgetex' should have at least one key provided")
+
+        opset = {ex, px, exat, pxat}
+        if len(opset) > 2 or len(opset) > 1 and persist:
+            raise DataError(
+                "``ex``, ``px``, ``exat``, ``pxat``, "
+                "and ``persist`` are mutually exclusive."
+            )
+
+        exp_options: list[EncodableT] = extract_expire_flags(ex, px, exat, pxat)
+
+        if persist:
+            exp_options.append("PERSIST")
+
+        return self.execute_command(
+            "HGETEX",
+            name,
+            *exp_options,
+            "FIELDS",
+            len(keys),
+            *keys,
+        )
+
     def hincrby(
         self, name: str, key: str, amount: int = 1
     ) -> Union[Awaitable[int], int]:
@@ -5034,8 +5086,10 @@ def hset(
 
         For more information see https://redis.io/commands/hset
         """
+
         if key is None and not mapping and not items:
             raise DataError("'hset' with no key value pairs")
+
         pieces = []
         if items:
             pieces.extend(items)
@@ -5047,6 +5101,89 @@ def hset(
 
         return self.execute_command("HSET", name, *pieces)
 
+    def hsetex(
+        self,
+        name: str,
+        key: Optional[str] = None,
+        value: Optional[str] = None,
+        mapping: Optional[dict] = None,
+        items: Optional[list] = None,
+        ex: Optional[ExpiryT] = None,
+        px: Optional[ExpiryT] = None,
+        exat: Optional[AbsExpiryT] = None,
+        pxat: Optional[AbsExpiryT] = None,
+        data_persist_option: Optional[HashDataPersistOptions] = None,
+        keepttl: bool = False,
+    ) -> Union[Awaitable[int], int]:
+        """
+        Set ``key`` to ``value`` within hash ``name``
+
+        ``mapping`` accepts a dict of key/value pairs that will be
+        added to hash ``name``.
+
+        ``items`` accepts a list of key/value pairs that will be
+        added to hash ``name``.
+
+        ``ex`` sets an expire flag on ``keys`` for ``ex`` seconds.
+
+        ``px`` sets an expire flag on ``keys`` for ``px`` milliseconds.
+
+        ``exat`` sets an expire flag on ``keys`` for ``ex`` seconds,
+            specified in unix time.
+
+        ``pxat`` sets an expire flag on ``keys`` for ``ex`` milliseconds,
+            specified in unix time.
+
+        ``data_persist_option`` can be set to ``FNX`` or ``FXX`` to control the
+            behavior of the command.
+            ``FNX`` will set the value for each provided key to each
+                provided value only if all do not already exist.
+            ``FXX`` will set the value for each provided key to each
+                provided value only if all already exist.
+
+        ``keepttl`` if True, retain the time to live associated with the keys.
+
+        Returns the number of fields that were added.
+
+        Available since Redis 8.0
+        For more information see https://redis.io/commands/hsetex
+        """
+        if key is None and not mapping and not items:
+            raise DataError("'hsetex' with no key value pairs")
+
+        if items and len(items) % 2 != 0:
+            raise DataError(
+                "'hsetex' with odd number of items. "
+                "'items' must contain a list of key/value pairs."
+            )
+
+        opset = {ex, px, exat, pxat}
+        if len(opset) > 2 or len(opset) > 1 and keepttl:
+            raise DataError(
+                "``ex``, ``px``, ``exat``, ``pxat``, "
+                "and ``keepttl`` are mutually exclusive."
+            )
+
+        exp_options: list[EncodableT] = extract_expire_flags(ex, px, exat, pxat)
+        if data_persist_option:
+            exp_options.append(data_persist_option.value)
+
+        if keepttl:
+            exp_options.append("KEEPTTL")
+
+        pieces = []
+        if items:
+            pieces.extend(items)
+        if key is not None:
+            pieces.extend((key, value))
+        if mapping:
+            for pair in mapping.items():
+                pieces.extend(pair)
+
+        return self.execute_command(
+            "HSETEX", name, *exp_options, "FIELDS", int(len(pieces) / 2), *pieces
+        )
+
     def hsetnx(self, name: str, key: str, value: str) -> Union[Awaitable[bool], bool]:
         """
         Set ``key`` to ``value`` within hash ``name`` if ``key`` does not
@@ -5056,6 +5193,11 @@ def hsetnx(self, name: str, key: str, value: str) -> Union[Awaitable[bool], bool
         """
         return self.execute_command("HSETNX", name, key, value)
 
+    @deprecated_function(
+        version="4.0.0",
+        reason="Use 'hset' instead.",
+        name="hmset",
+    )
     def hmset(self, name: str, mapping: dict) -> Union[Awaitable[str], str]:
         """
         Set key to value within hash ``name`` for each corresponding
@@ -5063,12 +5205,6 @@ def hmset(self, name: str, mapping: dict) -> Union[Awaitable[str], str]:
 
         For more information see https://redis.io/commands/hmset
         """
-        warnings.warn(
-            f"{self.__class__.__name__}.hmset() is deprecated. "
-            f"Use {self.__class__.__name__}.hset() instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
         if not mapping:
             raise DataError("'hmset' with 'mapping' of length 0")
         items = []
diff --git a/redis/utils.py b/redis/utils.py
index 66465636a1..9d9b4a9580 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -1,7 +1,11 @@
+import datetime
 import logging
 from contextlib import contextmanager
 from functools import wraps
-from typing import Any, Dict, Mapping, Union
+from typing import Any, Dict, List, Mapping, Optional, Union
+
+from redis.exceptions import DataError
+from redis.typing import AbsExpiryT, EncodableT, ExpiryT
 
 try:
     import hiredis  # noqa
@@ -257,3 +261,40 @@ def ensure_string(key):
         return key
     else:
         raise TypeError("Key must be either a string or bytes")
+
+
+def extract_expire_flags(
+    ex: Optional[ExpiryT] = None,
+    px: Optional[ExpiryT] = None,
+    exat: Optional[AbsExpiryT] = None,
+    pxat: Optional[AbsExpiryT] = None,
+) -> List[EncodableT]:
+    exp_options: list[EncodableT] = []
+    if ex is not None:
+        exp_options.append("EX")
+        if isinstance(ex, datetime.timedelta):
+            exp_options.append(int(ex.total_seconds()))
+        elif isinstance(ex, int):
+            exp_options.append(ex)
+        elif isinstance(ex, str) and ex.isdigit():
+            exp_options.append(int(ex))
+        else:
+            raise DataError("ex must be datetime.timedelta or int")
+    elif px is not None:
+        exp_options.append("PX")
+        if isinstance(px, datetime.timedelta):
+            exp_options.append(int(px.total_seconds() * 1000))
+        elif isinstance(px, int):
+            exp_options.append(px)
+        else:
+            raise DataError("px must be datetime.timedelta or int")
+    elif exat is not None:
+        if isinstance(exat, datetime.datetime):
+            exat = int(exat.timestamp())
+        exp_options.extend(["EXAT", exat])
+    elif pxat is not None:
+        if isinstance(pxat, datetime.datetime):
+            pxat = int(pxat.timestamp() * 1000)
+        exp_options.extend(["PXAT", pxat])
+
+    return exp_options
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 08bd5810f4..bfb6855a0f 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -31,6 +31,7 @@
     skip_if_server_version_lt,
     skip_unless_arch_bits,
 )
+from tests.test_asyncio.test_utils import redis_server_time
 
 if sys.version_info >= (3, 11, 3):
     from asyncio import timeout as async_timeout
@@ -77,12 +78,6 @@ async def slowlog(r: redis.Redis):
     await r.config_set("slowlog-max-len", old_max_legnth_value)
 
 
-async def redis_server_time(client: redis.Redis):
-    seconds, milliseconds = await client.time()
-    timestamp = float(f"{seconds}.{milliseconds}")
-    return datetime.datetime.fromtimestamp(timestamp)
-
-
 async def get_stream_message(client: redis.Redis, stream: str, message_id: str):
     """Fetch a stream message and format it as a (message_id, fields) pair"""
     response = await client.xrange(stream, min=message_id, max=message_id)
@@ -2328,12 +2323,8 @@ async def test_hmget(self, r: redis.Redis):
         assert await r.hmget("a", "a", "b", "c") == [b"1", b"2", b"3"]
 
     async def test_hmset(self, r: redis.Redis):
-        warning_message = (
-            r"^Redis(?:Cluster)*\.hmset\(\) is deprecated\. "
-            r"Use Redis(?:Cluster)*\.hset\(\) instead\.$"
-        )
         h = {b"a": b"1", b"b": b"2", b"c": b"3"}
-        with pytest.warns(DeprecationWarning, match=warning_message):
+        with pytest.warns(DeprecationWarning):
             assert await r.hmset("a", h)
         assert await r.hgetall("a") == h
 
diff --git a/tests/test_asyncio/test_hash.py b/tests/test_asyncio/test_hash.py
index 15e426673b..4fbc02c5fe 100644
--- a/tests/test_asyncio/test_hash.py
+++ b/tests/test_asyncio/test_hash.py
@@ -2,7 +2,12 @@
 import math
 from datetime import datetime, timedelta
 
+import pytest
+
+from redis import exceptions
+from redis.commands.core import HashDataPersistOptions
 from tests.conftest import skip_if_server_version_lt
+from tests.test_asyncio.test_utils import redis_server_time
 
 
 @skip_if_server_version_lt("7.3.240")
@@ -299,3 +304,274 @@ async def test_pttl_multiple_fields_mixed_conditions(r):
     result = await r.hpttl("test:hash", "field1", "field2", "field3")
     assert 30 * 60000 - 10000 < result[0] <= 30 * 60000
     assert result[1:] == [-1, -2]
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_hgetdel(r):
+    await r.delete("test:hash")
+    await r.hset("test:hash", "foo", "bar", mapping={"1": 1, "2": 2})
+    assert await r.hgetdel("test:hash", "foo", "1") == [b"bar", b"1"]
+    assert await r.hget("test:hash", "foo") is None
+    assert await r.hget("test:hash", "1") is None
+    assert await r.hget("test:hash", "2") == b"2"
+    assert await r.hgetdel("test:hash", "foo", "1") == [None, None]
+    assert await r.hget("test:hash", "2") == b"2"
+
+    with pytest.raises(exceptions.DataError):
+        await r.hgetdel("test:hash")
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_hgetex_no_expiration(r):
+    await r.delete("test:hash")
+    await r.hset(
+        "b", "foo", "bar", mapping={"1": 1, "2": 2, "3": "three", "4": b"four"}
+    )
+
+    assert await r.hgetex("b", "foo", "1", "4") == [b"bar", b"1", b"four"]
+    assert await r.hgetex("b", "foo") == [b"bar"]
+    assert await r.httl("b", "foo", "1", "4") == [-1, -1, -1]
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_hgetex_expiration_configs(r):
+    await r.delete("test:hash")
+    await r.hset(
+        "test:hash", "foo", "bar", mapping={"1": 1, "3": "three", "4": b"four"}
+    )
+
+    test_keys = ["foo", "1", "4"]
+    # test get with multiple fields with expiration set through 'ex'
+    assert await r.hgetex("test:hash", *test_keys, ex=10) == [
+        b"bar",
+        b"1",
+        b"four",
+    ]
+    ttls = await r.httl("test:hash", *test_keys)
+    for ttl in ttls:
+        assert pytest.approx(ttl) == 10
+
+    # test get with multiple fields removing expiration settings with 'persist'
+    assert await r.hgetex("test:hash", *test_keys, persist=True) == [
+        b"bar",
+        b"1",
+        b"four",
+    ]
+    assert await r.httl("test:hash", *test_keys) == [-1, -1, -1]
+
+    # test get with multiple fields with expiration set through 'px'
+    assert await r.hgetex("test:hash", *test_keys, px=6000) == [
+        b"bar",
+        b"1",
+        b"four",
+    ]
+    ttls = await r.httl("test:hash", *test_keys)
+    for ttl in ttls:
+        assert pytest.approx(ttl) == 6
+
+    # test get single field with expiration set through 'pxat'
+    expire_at = await redis_server_time(r) + timedelta(minutes=1)
+    assert await r.hgetex("test:hash", "foo", pxat=expire_at) == [b"bar"]
+    assert (await r.httl("test:hash", "foo"))[0] <= 61
+
+    # test get single field with expiration set through 'exat'
+    expire_at = await redis_server_time(r) + timedelta(seconds=10)
+    assert await r.hgetex("test:hash", "foo", exat=expire_at) == [b"bar"]
+    assert (await r.httl("test:hash", "foo"))[0] <= 10
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_hgetex_validate_expired_fields_removed(r):
+    await r.delete("test:hash")
+    await r.hset(
+        "test:hash", "foo", "bar", mapping={"1": 1, "3": "three", "4": b"four"}
+    )
+
+    # test get multiple fields with expiration set
+    # validate that expired fields are removed
+    assert await r.hgetex("test:hash", "foo", "1", "3", ex=1) == [
+        b"bar",
+        b"1",
+        b"three",
+    ]
+    await asyncio.sleep(1.1)
+    assert await r.hgetex("test:hash", "foo", "1", "3") == [None, None, None]
+    assert await r.httl("test:hash", "foo", "1", "3") == [-2, -2, -2]
+    assert await r.hgetex("test:hash", "4") == [b"four"]
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_hgetex_invalid_inputs(r):
+    with pytest.raises(exceptions.DataError):
+        await r.hgetex("b", "foo", ex=10, persist=True)
+
+    with pytest.raises(exceptions.DataError):
+        await r.hgetex("b", "foo", ex=10.0, persist=True)
+
+    with pytest.raises(exceptions.DataError):
+        await r.hgetex("b", "foo", ex=10, px=6000)
+
+    with pytest.raises(exceptions.DataError):
+        await r.hgetex("b", ex=10)
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_hsetex_no_expiration(r):
+    await r.delete("test:hash")
+
+    # # set items from mapping without expiration
+    assert await r.hsetex("test:hash", None, None, mapping={"1": 1, "4": b"four"}) == 1
+    assert await r.httl("test:hash", "foo", "1", "4") == [-2, -1, -1]
+    assert await r.hgetex("test:hash", "foo", "1") == [None, b"1"]
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_hsetex_expiration_ex_and_keepttl(r):
+    await r.delete("test:hash")
+
+    # set items from key/value provided
+    # combined with mapping and items with expiration - testing ex field
+    assert (
+        await r.hsetex(
+            "test:hash",
+            "foo",
+            "bar",
+            mapping={"1": 1, "2": "2"},
+            items=["i1", 11, "i2", 22],
+            ex=10,
+        )
+        == 1
+    )
+    test_keys = ["foo", "1", "2", "i1", "i2"]
+    ttls = await r.httl("test:hash", *test_keys)
+    for ttl in ttls:
+        assert pytest.approx(ttl) == 10
+
+    assert await r.hgetex("test:hash", *test_keys) == [
+        b"bar",
+        b"1",
+        b"2",
+        b"11",
+        b"22",
+    ]
+    await asyncio.sleep(1.1)
+    # validate keepttl
+    assert await r.hsetex("test:hash", "foo", "bar1", keepttl=True) == 1
+    assert 0 < (await r.httl("test:hash", "foo"))[0] < 10
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_hsetex_expiration_px(r):
+    await r.delete("test:hash")
+    # set items from key/value provided and mapping
+    # with expiration - testing px field
+    assert (
+        await r.hsetex("test:hash", "foo", "bar", mapping={"1": 1, "2": "2"}, px=60000)
+        == 1
+    )
+    test_keys = ["foo", "1", "2"]
+    ttls = await r.httl("test:hash", *test_keys)
+    for ttl in ttls:
+        assert pytest.approx(ttl) == 60
+
+    assert await r.hgetex("test:hash", *test_keys) == [b"bar", b"1", b"2"]
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_hsetex_expiration_pxat_and_fnx(r):
+    await r.delete("test:hash")
+    assert (
+        await r.hsetex("test:hash", "foo", "bar", mapping={"1": 1, "2": "2"}, ex=30)
+        == 1
+    )
+
+    expire_at = await redis_server_time(r) + timedelta(minutes=1)
+    assert (
+        await r.hsetex(
+            "test:hash",
+            "foo",
+            "bar1",
+            mapping={"new": "ok"},
+            pxat=expire_at,
+            data_persist_option=HashDataPersistOptions.FNX,
+        )
+        == 0
+    )
+    ttls = await r.httl("test:hash", "foo", "new")
+    assert ttls[0] <= 30
+    assert ttls[1] == -2
+
+    assert await r.hgetex("test:hash", "foo", "1", "new") == [b"bar", b"1", None]
+    assert (
+        await r.hsetex(
+            "test:hash",
+            "foo_new",
+            "bar1",
+            mapping={"new": "ok"},
+            pxat=expire_at,
+            data_persist_option=HashDataPersistOptions.FNX,
+        )
+        == 1
+    )
+    ttls = await r.httl("test:hash", "foo", "new")
+    for ttl in ttls:
+        assert ttl <= 61
+    assert await r.hgetex("test:hash", "foo", "foo_new", "new") == [
+        b"bar",
+        b"bar1",
+        b"ok",
+    ]
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_hsetex_expiration_exat_and_fxx(r):
+    await r.delete("test:hash")
+    assert (
+        await r.hsetex("test:hash", "foo", "bar", mapping={"1": 1, "2": "2"}, ex=30)
+        == 1
+    )
+
+    expire_at = await redis_server_time(r) + timedelta(seconds=10)
+    assert (
+        await r.hsetex(
+            "test:hash",
+            "foo",
+            "bar1",
+            mapping={"new": "ok"},
+            exat=expire_at,
+            data_persist_option=HashDataPersistOptions.FXX,
+        )
+        == 0
+    )
+    ttls = await r.httl("test:hash", "foo", "new")
+    assert 10 < ttls[0] <= 30
+    assert ttls[1] == -2
+
+    assert await r.hgetex("test:hash", "foo", "1", "new") == [b"bar", b"1", None]
+    assert (
+        await r.hsetex(
+            "test:hash",
+            "foo",
+            "bar1",
+            mapping={"1": "new_value"},
+            exat=expire_at,
+            data_persist_option=HashDataPersistOptions.FXX,
+        )
+        == 1
+    )
+    assert await r.hgetex("test:hash", "foo", "1") == [b"bar1", b"new_value"]
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_hsetex_invalid_inputs(r):
+    with pytest.raises(exceptions.DataError):
+        await r.hsetex("b", "foo", "bar", ex=10.0)
+
+    with pytest.raises(exceptions.DataError):
+        await r.hsetex("b", None, None)
+
+    with pytest.raises(exceptions.DataError):
+        await r.hsetex("b", "foo", "bar", items=["i1", 11, "i2"], px=6000)
+
+    with pytest.raises(exceptions.DataError):
+        await r.hsetex("b", "foo", "bar", ex=10, keepttl=True)
diff --git a/tests/test_asyncio/test_utils.py b/tests/test_asyncio/test_utils.py
new file mode 100644
index 0000000000..05cad1bfaf
--- /dev/null
+++ b/tests/test_asyncio/test_utils.py
@@ -0,0 +1,8 @@
+from datetime import datetime
+import redis
+
+
+async def redis_server_time(client: redis.Redis):
+    seconds, milliseconds = await client.time()
+    timestamp = float(f"{seconds}.{milliseconds}")
+    return datetime.fromtimestamp(timestamp)
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 5c72a019ba..8758efa771 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -21,6 +21,7 @@
 from redis.commands.json.path import Path
 from redis.commands.search.field import TextField
 from redis.commands.search.query import Query
+from tests.test_utils import redis_server_time
 
 from .conftest import (
     _get_client,
@@ -50,12 +51,6 @@ def cleanup():
     r.config_set("slowlog-max-len", 128)
 
 
-def redis_server_time(client):
-    seconds, milliseconds = client.time()
-    timestamp = float(f"{seconds}.{milliseconds}")
-    return datetime.datetime.fromtimestamp(timestamp)
-
-
 def get_stream_message(client, stream, message_id):
     "Fetch a stream message and format it as a (message_id, fields) pair"
     response = client.xrange(stream, min=message_id, max=message_id)
@@ -3393,13 +3388,8 @@ def test_hmget(self, r):
         assert r.hmget("a", "a", "b", "c") == [b"1", b"2", b"3"]
 
     def test_hmset(self, r):
-        redis_class = type(r).__name__
-        warning_message = (
-            r"^{0}\.hmset\(\) is deprecated\. "
-            r"Use {0}\.hset\(\) instead\.$".format(redis_class)
-        )
         h = {b"a": b"1", b"b": b"2", b"c": b"3"}
-        with pytest.warns(DeprecationWarning, match=warning_message):
+        with pytest.warns(DeprecationWarning):
             assert r.hmset("a", h)
         assert r.hgetall("a") == h
 
diff --git a/tests/test_hash.py b/tests/test_hash.py
index 0422185865..c2a92fb852 100644
--- a/tests/test_hash.py
+++ b/tests/test_hash.py
@@ -3,7 +3,10 @@
 from datetime import datetime, timedelta
 
 import pytest
+from redis import exceptions
+from redis.commands.core import HashDataPersistOptions
 from tests.conftest import skip_if_server_version_lt
+from tests.test_utils import redis_server_time
 
 
 @skip_if_server_version_lt("7.3.240")
@@ -368,3 +371,247 @@ def test_hpttl_multiple_fields_mixed_conditions(r):
 def test_hpttl_nonexistent_key(r):
     r.delete("test:hash")
     assert r.hpttl("test:hash", "field1", "field2", "field3") == [-2, -2, -2]
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_hgetdel(r):
+    r.delete("test:hash")
+    r.hset("test:hash", "foo", "bar", mapping={"1": 1, "2": 2})
+    assert r.hgetdel("test:hash", "foo", "1") == [b"bar", b"1"]
+    assert r.hget("test:hash", "foo") is None
+    assert r.hget("test:hash", "1") is None
+    assert r.hget("test:hash", "2") == b"2"
+    assert r.hgetdel("test:hash", "foo", "1") == [None, None]
+    assert r.hget("test:hash", "2") == b"2"
+
+    with pytest.raises(exceptions.DataError):
+        r.hgetdel("test:hash")
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_hgetex_no_expiration(r):
+    r.delete("test:hash")
+    r.hset("b", "foo", "bar", mapping={"1": 1, "2": 2, "3": "three", "4": b"four"})
+
+    assert r.hgetex("b", "foo", "1", "4") == [b"bar", b"1", b"four"]
+    assert r.httl("b", "foo", "1", "4") == [-1, -1, -1]
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_hgetex_expiration_configs(r):
+    r.delete("test:hash")
+    r.hset("test:hash", "foo", "bar", mapping={"1": 1, "3": "three", "4": b"four"})
+    test_keys = ["foo", "1", "4"]
+
+    # test get with multiple fields with expiration set through 'ex'
+    assert r.hgetex("test:hash", *test_keys, ex=10) == [b"bar", b"1", b"four"]
+    ttls = r.httl("test:hash", *test_keys)
+    for ttl in ttls:
+        assert pytest.approx(ttl) == 10
+
+    # test get with multiple fields removing expiration settings with 'persist'
+    assert r.hgetex("test:hash", *test_keys, persist=True) == [
+        b"bar",
+        b"1",
+        b"four",
+    ]
+    assert r.httl("test:hash", *test_keys) == [-1, -1, -1]
+
+    # test get with multiple fields with expiration set through 'px'
+    assert r.hgetex("test:hash", *test_keys, px=6000) == [b"bar", b"1", b"four"]
+    ttls = r.httl("test:hash", *test_keys)
+    for ttl in ttls:
+        assert pytest.approx(ttl) == 6
+
+    # test get single field with expiration set through 'pxat'
+    expire_at = redis_server_time(r) + timedelta(minutes=1)
+    assert r.hgetex("test:hash", "foo", pxat=expire_at) == [b"bar"]
+    assert r.httl("test:hash", "foo")[0] <= 61
+
+    # test get single field with expiration set through 'exat'
+    expire_at = redis_server_time(r) + timedelta(seconds=10)
+    assert r.hgetex("test:hash", "foo", exat=expire_at) == [b"bar"]
+    assert r.httl("test:hash", "foo")[0] <= 10
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_hgetex_validate_expired_fields_removed(r):
+    r.delete("test:hash")
+    r.hset("test:hash", "foo", "bar", mapping={"1": 1, "3": "three", "4": b"four"})
+
+    test_keys = ["foo", "1", "3"]
+    # test get multiple fields with expiration set
+    # validate that expired fields are removed
+    assert r.hgetex("test:hash", *test_keys, ex=1) == [b"bar", b"1", b"three"]
+    time.sleep(1.1)
+    assert r.hgetex("test:hash", *test_keys) == [None, None, None]
+    assert r.httl("test:hash", *test_keys) == [-2, -2, -2]
+    assert r.hgetex("test:hash", "4") == [b"four"]
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_hgetex_invalid_inputs(r):
+    with pytest.raises(exceptions.DataError):
+        r.hgetex("b", "foo", "1", "3", ex=10, persist=True)
+
+    with pytest.raises(exceptions.DataError):
+        r.hgetex("b", "foo", ex=10.0, persist=True)
+
+    with pytest.raises(exceptions.DataError):
+        r.hgetex("b", "foo", ex=10, px=6000)
+
+    with pytest.raises(exceptions.DataError):
+        r.hgetex("b", ex=10)
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_hsetex_no_expiration(r):
+    r.delete("test:hash")
+
+    # # set items from mapping without expiration
+    assert r.hsetex("test:hash", None, None, mapping={"1": 1, "4": b"four"}) == 1
+    assert r.httl("test:hash", "foo", "1", "4") == [-2, -1, -1]
+    assert r.hgetex("test:hash", "foo", "1") == [None, b"1"]
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_hsetex_expiration_ex_and_keepttl(r):
+    r.delete("test:hash")
+
+    # set items from key/value provided
+    # combined with mapping and items with expiration - testing ex field
+    assert (
+        r.hsetex(
+            "test:hash",
+            "foo",
+            "bar",
+            mapping={"1": 1, "2": "2"},
+            items=["i1", 11, "i2", 22],
+            ex=10,
+        )
+        == 1
+    )
+    ttls = r.httl("test:hash", "foo", "1", "2", "i1", "i2")
+    for ttl in ttls:
+        assert pytest.approx(ttl) == 10
+
+    assert r.hgetex("test:hash", "foo", "1", "2", "i1", "i2") == [
+        b"bar",
+        b"1",
+        b"2",
+        b"11",
+        b"22",
+    ]
+    time.sleep(1.1)
+    # validate keepttl
+    assert r.hsetex("test:hash", "foo", "bar1", keepttl=True) == 1
+    assert r.httl("test:hash", "foo")[0] < 10
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_hsetex_expiration_px(r):
+    r.delete("test:hash")
+    # set items from key/value provided and mapping
+    # with expiration - testing px field
+    assert (
+        r.hsetex("test:hash", "foo", "bar", mapping={"1": 1, "2": "2"}, px=60000) == 1
+    )
+    test_keys = ["foo", "1", "2"]
+    ttls = r.httl("test:hash", *test_keys)
+    for ttl in ttls:
+        assert pytest.approx(ttl) == 60
+    assert r.hgetex("test:hash", *test_keys) == [b"bar", b"1", b"2"]
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_hsetex_expiration_pxat_and_fnx(r):
+    r.delete("test:hash")
+    assert r.hsetex("test:hash", "foo", "bar", mapping={"1": 1, "2": "2"}, ex=30) == 1
+
+    expire_at = redis_server_time(r) + timedelta(minutes=1)
+    assert (
+        r.hsetex(
+            "test:hash",
+            "foo",
+            "bar1",
+            mapping={"new": "ok"},
+            pxat=expire_at,
+            data_persist_option=HashDataPersistOptions.FNX,
+        )
+        == 0
+    )
+    ttls = r.httl("test:hash", "foo", "new")
+    assert ttls[0] <= 30
+    assert ttls[1] == -2
+
+    assert r.hgetex("test:hash", "foo", "1", "new") == [b"bar", b"1", None]
+    assert (
+        r.hsetex(
+            "test:hash",
+            "foo_new",
+            "bar1",
+            mapping={"new": "ok"},
+            pxat=expire_at,
+            data_persist_option=HashDataPersistOptions.FNX,
+        )
+        == 1
+    )
+    ttls = r.httl("test:hash", "foo", "new")
+    for ttl in ttls:
+        assert ttl <= 61
+    assert r.hgetex("test:hash", "foo", "foo_new", "new") == [
+        b"bar",
+        b"bar1",
+        b"ok",
+    ]
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_hsetex_expiration_exat_and_fxx(r):
+    r.delete("test:hash")
+    assert r.hsetex("test:hash", "foo", "bar", mapping={"1": 1, "2": "2"}, ex=30) == 1
+
+    expire_at = redis_server_time(r) + timedelta(seconds=10)
+    assert (
+        r.hsetex(
+            "test:hash",
+            "foo",
+            "bar1",
+            mapping={"new": "ok"},
+            exat=expire_at,
+            data_persist_option=HashDataPersistOptions.FXX,
+        )
+        == 0
+    )
+    ttls = r.httl("test:hash", "foo", "new")
+    assert 10 < ttls[0] <= 30
+    assert ttls[1] == -2
+
+    assert r.hgetex("test:hash", "foo", "1", "new") == [b"bar", b"1", None]
+    assert (
+        r.hsetex(
+            "test:hash",
+            "foo",
+            "bar1",
+            mapping={"1": "new_value"},
+            exat=expire_at,
+            data_persist_option=HashDataPersistOptions.FXX,
+        )
+        == 1
+    )
+    assert r.hgetex("test:hash", "foo", "1") == [b"bar1", b"new_value"]
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_hsetex_invalid_inputs(r):
+    with pytest.raises(exceptions.DataError):
+        r.hsetex("b", "foo", "bar", ex=10.0)
+
+    with pytest.raises(exceptions.DataError):
+        r.hsetex("b", None, None)
+
+    with pytest.raises(exceptions.DataError):
+        r.hsetex("b", "foo", "bar", items=["i1", 11, "i2"], px=6000)
+
+    with pytest.raises(exceptions.DataError):
+        r.hsetex("b", "foo", "bar", ex=10, keepttl=True)
diff --git a/tests/test_utils.py b/tests/test_utils.py
index 764ef5d0a9..75de8dbb9f 100644
--- a/tests/test_utils.py
+++ b/tests/test_utils.py
@@ -1,3 +1,4 @@
+from datetime import datetime
 import pytest
 from redis.utils import compare_versions
 
@@ -25,3 +26,9 @@
 )
 def test_compare_versions(version1, version2, expected_res):
     assert compare_versions(version1, version2) == expected_res
+
+
+def redis_server_time(client):
+    seconds, milliseconds = client.time()
+    timestamp = float(f"{seconds}.{milliseconds}")
+    return datetime.fromtimestamp(timestamp)

From 55a50a2b96587674207c2eef1b947b6b366cb5e9 Mon Sep 17 00:00:00 2001
From: Rohan Singh <rohan@washington.edu>
Date: Tue, 25 Mar 2025 17:16:27 +0100
Subject: [PATCH 1019/1164] Truncate pipeline exception message to a sane size
 (#3530)

Fixes #20234.
---
 redis/asyncio/client.py             |  6 +++++-
 redis/asyncio/cluster.py            |  6 ++++--
 redis/client.py                     |  4 +++-
 redis/cluster.py                    |  4 +++-
 redis/utils.py                      |  7 +++++++
 tests/test_asyncio/test_cluster.py  | 19 +++++++++++++++++++
 tests/test_asyncio/test_pipeline.py | 16 ++++++++++++++++
 tests/test_cluster.py               | 19 +++++++++++++++++++
 tests/test_pipeline.py              | 16 ++++++++++++++++
 9 files changed, 92 insertions(+), 5 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 0039cea540..a35a5f1f8c 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -77,6 +77,7 @@
     get_lib_version,
     safe_str,
     str_if_bytes,
+    truncate_text,
 )
 
 if TYPE_CHECKING and SSL_AVAILABLE:
@@ -1513,7 +1514,10 @@ def annotate_exception(
         self, exception: Exception, number: int, command: Iterable[object]
     ) -> None:
         cmd = " ".join(map(safe_str, command))
-        msg = f"Command # {number} ({cmd}) of pipeline caused error: {exception.args}"
+        msg = (
+            f"Command # {number} ({truncate_text(cmd)}) "
+            "of pipeline caused error: {exception.args}"
+        )
         exception.args = (msg,) + exception.args[1:]
 
     async def parse_response(
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index e2a4fbe2cc..11f86cceb4 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -71,6 +71,7 @@
     get_lib_version,
     safe_str,
     str_if_bytes,
+    truncate_text,
 )
 
 if SSL_AVAILABLE:
@@ -1633,8 +1634,9 @@ async def _execute(
                     if isinstance(result, Exception):
                         command = " ".join(map(safe_str, cmd.args))
                         msg = (
-                            f"Command # {cmd.position + 1} ({command}) of pipeline "
-                            f"caused error: {result.args}"
+                            f"Command # {cmd.position + 1} "
+                            f"({truncate_text(command)}) "
+                            f"of pipeline caused error: {result.args}"
                         )
                         result.args = (msg,) + result.args[1:]
                         raise result
diff --git a/redis/client.py b/redis/client.py
index 2c4a1fadff..9fb89ec5cd 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -61,6 +61,7 @@
     get_lib_version,
     safe_str,
     str_if_bytes,
+    truncate_text,
 )
 
 if TYPE_CHECKING:
@@ -1524,7 +1525,8 @@ def raise_first_error(self, commands, response):
     def annotate_exception(self, exception, number, command):
         cmd = " ".join(map(safe_str, command))
         msg = (
-            f"Command # {number} ({cmd}) of pipeline caused error: {exception.args[0]}"
+            f"Command # {number} ({truncate_text(cmd)}) of pipeline "
+            f"caused error: {exception.args[0]}"
         )
         exception.args = (msg,) + exception.args[1:]
 
diff --git a/redis/cluster.py b/redis/cluster.py
index 0488608a60..4ec03ac98f 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -47,6 +47,7 @@
     merge_result,
     safe_str,
     str_if_bytes,
+    truncate_text,
 )
 
 
@@ -2125,7 +2126,8 @@ def annotate_exception(self, exception, number, command):
         """
         cmd = " ".join(map(safe_str, command))
         msg = (
-            f"Command # {number} ({cmd}) of pipeline caused error: {exception.args[0]}"
+            f"Command # {number} ({truncate_text(cmd)}) of pipeline "
+            f"caused error: {exception.args[0]}"
         )
         exception.args = (msg,) + exception.args[1:]
 
diff --git a/redis/utils.py b/redis/utils.py
index 9d9b4a9580..1f0b24d768 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -1,5 +1,6 @@
 import datetime
 import logging
+import textwrap
 from contextlib import contextmanager
 from functools import wraps
 from typing import Any, Dict, List, Mapping, Optional, Union
@@ -298,3 +299,9 @@ def extract_expire_flags(
         exp_options.extend(["PXAT", pxat])
 
     return exp_options
+
+
+def truncate_text(txt, max_length=100):
+    return textwrap.shorten(
+        text=txt, width=max_length, placeholder="...", break_long_words=True
+    )
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index f57718b44f..a0429152ec 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -2905,6 +2905,25 @@ async def test_asking_error(self, r: RedisCluster) -> None:
             assert ask_node._free.pop().read_response.await_count
             assert res == ["MOCK_OK"]
 
+    async def test_error_is_truncated(self, r) -> None:
+        """
+        Test that an error from the pipeline is truncated correctly.
+        """
+        key = "a" * 50
+        a_value = "a" * 20
+        b_value = "b" * 20
+
+        async with r.pipeline() as pipe:
+            pipe.set(key, 1)
+            pipe.hset(key, mapping={"field_a": a_value, "field_b": b_value})
+            pipe.expire(key, 100)
+
+            with pytest.raises(Exception) as ex:
+                await pipe.execute()
+
+            expected = f"Command # 2 (HSET {key} field_a {a_value} field_b...) of pipeline caused error: "
+            assert str(ex.value).startswith(expected)
+
     async def test_moved_redirection_on_slave_with_default(
         self, r: RedisCluster
     ) -> None:
diff --git a/tests/test_asyncio/test_pipeline.py b/tests/test_asyncio/test_pipeline.py
index 31759d84a3..19e11dc792 100644
--- a/tests/test_asyncio/test_pipeline.py
+++ b/tests/test_asyncio/test_pipeline.py
@@ -368,6 +368,22 @@ async def test_exec_error_in_no_transaction_pipeline_unicode_command(self, r):
 
         assert await r.get(key) == b"1"
 
+    async def test_exec_error_in_pipeline_truncated(self, r):
+        key = "a" * 50
+        a_value = "a" * 20
+        b_value = "b" * 20
+
+        await r.set(key, 1)
+        async with r.pipeline(transaction=False) as pipe:
+            pipe.hset(key, mapping={"field_a": a_value, "field_b": b_value})
+            pipe.expire(key, 100)
+
+            with pytest.raises(redis.ResponseError) as ex:
+                await pipe.execute()
+
+            expected = f"Command # 1 (HSET {key} field_a {a_value} field_b...) of pipeline caused error: "
+            assert str(ex.value).startswith(expected)
+
     async def test_pipeline_with_bitfield(self, r):
         async with r.pipeline() as pipe:
             pipe.set("a", "1")
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index b71908d396..d96342f87a 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -3315,6 +3315,25 @@ def raise_ask_error():
             assert ask_node.redis_connection.connection.read_response.called
             assert res == ["MOCK_OK"]
 
+    def test_error_is_truncated(self, r):
+        """
+        Test that an error from the pipeline is truncated correctly.
+        """
+        key = "a" * 50
+        a_value = "a" * 20
+        b_value = "b" * 20
+
+        with r.pipeline() as pipe:
+            pipe.set(key, 1)
+            pipe.hset(key, mapping={"field_a": a_value, "field_b": b_value})
+            pipe.expire(key, 100)
+
+            with pytest.raises(Exception) as ex:
+                pipe.execute()
+
+            expected = f"Command # 2 (HSET {key} field_a {a_value} field_b...) of pipeline caused error: "
+            assert str(ex.value).startswith(expected)
+
     def test_return_previously_acquired_connections(self, r):
         # in order to ensure that a pipeline will make use of connections
         #   from different nodes
diff --git a/tests/test_pipeline.py b/tests/test_pipeline.py
index be7784ad0b..bbf1ec9eb5 100644
--- a/tests/test_pipeline.py
+++ b/tests/test_pipeline.py
@@ -369,6 +369,22 @@ def test_exec_error_in_no_transaction_pipeline_unicode_command(self, r):
 
         assert r[key] == b"1"
 
+    def test_exec_error_in_pipeline_truncated(self, r):
+        key = "a" * 50
+        a_value = "a" * 20
+        b_value = "b" * 20
+
+        r[key] = 1
+        with r.pipeline(transaction=False) as pipe:
+            pipe.hset(key, mapping={"field_a": a_value, "field_b": b_value})
+            pipe.expire(key, 100)
+
+            with pytest.raises(redis.ResponseError) as ex:
+                pipe.execute()
+
+            expected = f"Command # 1 (HSET {key} field_a {a_value} field_b...) of pipeline caused error: "
+            assert str(ex.value).startswith(expected)
+
     def test_pipeline_with_bitfield(self, r):
         with r.pipeline() as pipe:
             pipe.set("a", "1")

From ee54d2aad5370882b9ceb11ef351a42a4a8daed1 Mon Sep 17 00:00:00 2001
From: Logan Attwood <lattwood@users.noreply.github.com>
Date: Tue, 25 Mar 2025 14:10:03 -0300
Subject: [PATCH 1020/1164] Support using ssl.VerifyMode enum for ssl_cert_reqs
 (#3346)

---
 redis/asyncio/client.py     | 5 +++--
 redis/asyncio/cluster.py    | 5 +++--
 redis/asyncio/connection.py | 9 +++++----
 redis/client.py             | 2 +-
 redis/connection.py         | 2 +-
 5 files changed, 13 insertions(+), 10 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index a35a5f1f8c..3f35fdd59e 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -81,9 +81,10 @@
 )
 
 if TYPE_CHECKING and SSL_AVAILABLE:
-    from ssl import TLSVersion
+    from ssl import TLSVersion, VerifyMode
 else:
     TLSVersion = None
+    VerifyMode = None
 
 PubSubHandler = Callable[[Dict[str, str]], Awaitable[None]]
 _KeyT = TypeVar("_KeyT", bound=KeyT)
@@ -228,7 +229,7 @@ def __init__(
         ssl: bool = False,
         ssl_keyfile: Optional[str] = None,
         ssl_certfile: Optional[str] = None,
-        ssl_cert_reqs: str = "required",
+        ssl_cert_reqs: Union[str, VerifyMode] = "required",
         ssl_ca_certs: Optional[str] = None,
         ssl_ca_data: Optional[str] = None,
         ssl_check_hostname: bool = False,
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 11f86cceb4..28fcd3aa23 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -75,9 +75,10 @@
 )
 
 if SSL_AVAILABLE:
-    from ssl import TLSVersion
+    from ssl import TLSVersion, VerifyMode
 else:
     TLSVersion = None
+    VerifyMode = None
 
 TargetNodesT = TypeVar(
     "TargetNodesT", str, "ClusterNode", List["ClusterNode"], Dict[Any, "ClusterNode"]
@@ -268,7 +269,7 @@ def __init__(
         ssl: bool = False,
         ssl_ca_certs: Optional[str] = None,
         ssl_ca_data: Optional[str] = None,
-        ssl_cert_reqs: str = "required",
+        ssl_cert_reqs: Union[str, VerifyMode] = "required",
         ssl_certfile: Optional[str] = None,
         ssl_check_hostname: bool = False,
         ssl_keyfile: Optional[str] = None,
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 66dbd09b61..ddf58cb1c6 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -768,7 +768,7 @@ def __init__(
         self,
         ssl_keyfile: Optional[str] = None,
         ssl_certfile: Optional[str] = None,
-        ssl_cert_reqs: str = "required",
+        ssl_cert_reqs: Union[str, ssl.VerifyMode] = "required",
         ssl_ca_certs: Optional[str] = None,
         ssl_ca_data: Optional[str] = None,
         ssl_check_hostname: bool = False,
@@ -842,7 +842,7 @@ def __init__(
         self,
         keyfile: Optional[str] = None,
         certfile: Optional[str] = None,
-        cert_reqs: Optional[str] = None,
+        cert_reqs: Optional[Union[str, ssl.VerifyMode]] = None,
         ca_certs: Optional[str] = None,
         ca_data: Optional[str] = None,
         check_hostname: bool = False,
@@ -855,7 +855,7 @@ def __init__(
         self.keyfile = keyfile
         self.certfile = certfile
         if cert_reqs is None:
-            self.cert_reqs = ssl.CERT_NONE
+            cert_reqs = ssl.CERT_NONE
         elif isinstance(cert_reqs, str):
             CERT_REQS = {  # noqa: N806
                 "none": ssl.CERT_NONE,
@@ -866,7 +866,8 @@ def __init__(
                 raise RedisError(
                     f"Invalid SSL Certificate Requirements Flag: {cert_reqs}"
                 )
-            self.cert_reqs = CERT_REQS[cert_reqs]
+            cert_reqs = CERT_REQS[cert_reqs]
+        self.cert_reqs = cert_reqs
         self.ca_certs = ca_certs
         self.ca_data = ca_data
         self.check_hostname = check_hostname
diff --git a/redis/client.py b/redis/client.py
index 9fb89ec5cd..e9435d33ef 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -211,7 +211,7 @@ def __init__(
         ssl: bool = False,
         ssl_keyfile: Optional[str] = None,
         ssl_certfile: Optional[str] = None,
-        ssl_cert_reqs: str = "required",
+        ssl_cert_reqs: Union[str, "ssl.VerifyMode"] = "required",
         ssl_ca_certs: Optional[str] = None,
         ssl_ca_path: Optional[str] = None,
         ssl_ca_data: Optional[str] = None,
diff --git a/redis/connection.py b/redis/connection.py
index f754a5165a..87aa986d17 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1017,7 +1017,7 @@ def __init__(
         Args:
             ssl_keyfile: Path to an ssl private key. Defaults to None.
             ssl_certfile: Path to an ssl certificate. Defaults to None.
-            ssl_cert_reqs: The string value for the SSLContext.verify_mode (none, optional, required). Defaults to "required".
+            ssl_cert_reqs: The string value for the SSLContext.verify_mode (none, optional, required), or an ssl.VerifyMode. Defaults to "required".
             ssl_ca_certs: The path to a file of concatenated CA certificates in PEM format. Defaults to None.
             ssl_ca_data: Either an ASCII string of one or more PEM-encoded certificates or a bytes-like object of DER-encoded certificates.
             ssl_check_hostname: If set, match the hostname during the SSL handshake. Defaults to False.

From c42df94a6c7be78aae29f9a9175ac174c5bed699 Mon Sep 17 00:00:00 2001
From: Robin <167366979+allrob23@users.noreply.github.com>
Date: Wed, 26 Mar 2025 06:09:55 -0300
Subject: [PATCH 1021/1164] Improvement: Use `shutdown()` Before `close()` in
 connection.py (#3567)

---
 redis/connection.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/redis/connection.py b/redis/connection.py
index 87aa986d17..b323be058b 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -764,6 +764,10 @@ def _connect(self):
             except OSError as _:
                 err = _
                 if sock is not None:
+                    try:
+                        sock.shutdown(socket.SHUT_RDWR)  # ensure a clean close
+                    except OSError:
+                        pass
                     sock.close()
 
         if err is not None:
@@ -1179,6 +1183,10 @@ def _connect(self):
             sock.connect(self.path)
         except OSError:
             # Prevent ResourceWarnings for unclosed sockets.
+            try:
+                sock.shutdown(socket.SHUT_RDWR)  # ensure a clean close
+            except OSError:
+                pass
             sock.close()
             raise
         sock.settimeout(self.socket_timeout)

From 7bfd4c54ba80f88ddd975c525496e3c233cadebc Mon Sep 17 00:00:00 2001
From: Vladimir Chebotarev <vladimir.chebotarev@gmail.com>
Date: Wed, 26 Mar 2025 14:34:22 +0300
Subject: [PATCH 1022/1164] Fixed infinitely recursive health checks. (#3557)

---
 redis/asyncio/connection.py | 39 +++++++++++++++++++++++++++++--------
 redis/connection.py         | 37 ++++++++++++++++++++++++++++-------
 2 files changed, 61 insertions(+), 15 deletions(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index ddf58cb1c6..7404f3d6f8 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -293,6 +293,9 @@ def set_parser(self, parser_class: Type[BaseParser]) -> None:
 
     async def connect(self):
         """Connects to the Redis server if not already connected"""
+        await self.connect_check_health(check_health=True)
+
+    async def connect_check_health(self, check_health: bool = True):
         if self.is_connected:
             return
         try:
@@ -311,7 +314,7 @@ async def connect(self):
         try:
             if not self.redis_connect_func:
                 # Use the default on_connect function
-                await self.on_connect()
+                await self.on_connect_check_health(check_health=check_health)
             else:
                 # Use the passed function redis_connect_func
                 (
@@ -350,6 +353,9 @@ def get_protocol(self):
 
     async def on_connect(self) -> None:
         """Initialize the connection, authenticate and select a database"""
+        await self.on_connect_check_health(check_health=True)
+
+    async def on_connect_check_health(self, check_health: bool = True) -> None:
         self._parser.on_connect(self)
         parser = self._parser
 
@@ -407,7 +413,7 @@ async def on_connect(self) -> None:
                 # update cluster exception classes
                 self._parser.EXCEPTION_CLASSES = parser.EXCEPTION_CLASSES
                 self._parser.on_connect(self)
-            await self.send_command("HELLO", self.protocol)
+            await self.send_command("HELLO", self.protocol, check_health=check_health)
             response = await self.read_response()
             # if response.get(b"proto") != self.protocol and response.get(
             #     "proto"
@@ -416,18 +422,35 @@ async def on_connect(self) -> None:
 
         # if a client_name is given, set it
         if self.client_name:
-            await self.send_command("CLIENT", "SETNAME", self.client_name)
+            await self.send_command(
+                "CLIENT",
+                "SETNAME",
+                self.client_name,
+                check_health=check_health,
+            )
             if str_if_bytes(await self.read_response()) != "OK":
                 raise ConnectionError("Error setting client name")
 
         # set the library name and version, pipeline for lower startup latency
         if self.lib_name:
-            await self.send_command("CLIENT", "SETINFO", "LIB-NAME", self.lib_name)
+            await self.send_command(
+                "CLIENT",
+                "SETINFO",
+                "LIB-NAME",
+                self.lib_name,
+                check_health=check_health,
+            )
         if self.lib_version:
-            await self.send_command("CLIENT", "SETINFO", "LIB-VER", self.lib_version)
+            await self.send_command(
+                "CLIENT",
+                "SETINFO",
+                "LIB-VER",
+                self.lib_version,
+                check_health=check_health,
+            )
         # if a database is specified, switch to it. Also pipeline this
         if self.db:
-            await self.send_command("SELECT", self.db)
+            await self.send_command("SELECT", self.db, check_health=check_health)
 
         # read responses from pipeline
         for _ in (sent for sent in (self.lib_name, self.lib_version) if sent):
@@ -489,8 +512,8 @@ async def send_packed_command(
         self, command: Union[bytes, str, Iterable[bytes]], check_health: bool = True
     ) -> None:
         if not self.is_connected:
-            await self.connect()
-        elif check_health:
+            await self.connect_check_health(check_health=False)
+        if check_health:
             await self.check_health()
 
         try:
diff --git a/redis/connection.py b/redis/connection.py
index b323be058b..08e980e866 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -376,6 +376,9 @@ def set_parser(self, parser_class):
 
     def connect(self):
         "Connects to the Redis server if not already connected"
+        self.connect_check_health(check_health=True)
+
+    def connect_check_health(self, check_health: bool = True):
         if self._sock:
             return
         try:
@@ -391,7 +394,7 @@ def connect(self):
         try:
             if self.redis_connect_func is None:
                 # Use the default on_connect function
-                self.on_connect()
+                self.on_connect_check_health(check_health=check_health)
             else:
                 # Use the passed function redis_connect_func
                 self.redis_connect_func(self)
@@ -421,6 +424,9 @@ def _error_message(self, exception):
         return format_error_message(self._host_error(), exception)
 
     def on_connect(self):
+        self.on_connect_check_health(check_health=True)
+
+    def on_connect_check_health(self, check_health: bool = True):
         "Initialize the connection, authenticate and select a database"
         self._parser.on_connect(self)
         parser = self._parser
@@ -479,7 +485,7 @@ def on_connect(self):
                 # update cluster exception classes
                 self._parser.EXCEPTION_CLASSES = parser.EXCEPTION_CLASSES
                 self._parser.on_connect(self)
-            self.send_command("HELLO", self.protocol)
+            self.send_command("HELLO", self.protocol, check_health=check_health)
             self.handshake_metadata = self.read_response()
             if (
                 self.handshake_metadata.get(b"proto") != self.protocol
@@ -489,28 +495,45 @@ def on_connect(self):
 
         # if a client_name is given, set it
         if self.client_name:
-            self.send_command("CLIENT", "SETNAME", self.client_name)
+            self.send_command(
+                "CLIENT",
+                "SETNAME",
+                self.client_name,
+                check_health=check_health,
+            )
             if str_if_bytes(self.read_response()) != "OK":
                 raise ConnectionError("Error setting client name")
 
         try:
             # set the library name and version
             if self.lib_name:
-                self.send_command("CLIENT", "SETINFO", "LIB-NAME", self.lib_name)
+                self.send_command(
+                    "CLIENT",
+                    "SETINFO",
+                    "LIB-NAME",
+                    self.lib_name,
+                    check_health=check_health,
+                )
                 self.read_response()
         except ResponseError:
             pass
 
         try:
             if self.lib_version:
-                self.send_command("CLIENT", "SETINFO", "LIB-VER", self.lib_version)
+                self.send_command(
+                    "CLIENT",
+                    "SETINFO",
+                    "LIB-VER",
+                    self.lib_version,
+                    check_health=check_health,
+                )
                 self.read_response()
         except ResponseError:
             pass
 
         # if a database is specified, switch to it
         if self.db:
-            self.send_command("SELECT", self.db)
+            self.send_command("SELECT", self.db, check_health=check_health)
             if str_if_bytes(self.read_response()) != "OK":
                 raise ConnectionError("Invalid Database")
 
@@ -552,7 +575,7 @@ def check_health(self):
     def send_packed_command(self, command, check_health=True):
         """Send an already packed command to the Redis server"""
         if not self._sock:
-            self.connect()
+            self.connect_check_health(check_health=False)
         # guard against health check recursion
         if check_health:
             self.check_health()

From e4b1fba1a51fa1ee7940de4018e83098dbd19073 Mon Sep 17 00:00:00 2001
From: Paolo <lazzari.paolok@gmail.com>
Date: Thu, 27 Mar 2025 12:20:13 +0100
Subject: [PATCH 1023/1164] Fix incorrect link to docs for fcall_ro command
 (#3576)

---
 redis/commands/core.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 271f640dec..a8c327f08f 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -6556,7 +6556,7 @@ def fcall_ro(
         This is a read-only variant of the FCALL command that cannot
         execute commands that modify data.
 
-        For more information see https://redis.io/commands/fcal_ro
+        For more information see https://redis.io/commands/fcall_ro
         """
         return self._fcall("FCALL_RO", function, numkeys, *keys_and_args)
 

From 1b1132df4f4884c6b26d08f734b9f935260a80d6 Mon Sep 17 00:00:00 2001
From: Robert Shelton <robert.b.shelton.42@gmail.com>
Date: Wed, 2 Apr 2025 09:03:02 -0400
Subject: [PATCH 1024/1164] Docs/raae 724/remove redis ventures (#3579)

---
 docs/examples/search_vector_similarity_examples.ipynb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/examples/search_vector_similarity_examples.ipynb b/docs/examples/search_vector_similarity_examples.ipynb
index 809dbda4ea..af6d825129 100644
--- a/docs/examples/search_vector_similarity_examples.ipynb
+++ b/docs/examples/search_vector_similarity_examples.ipynb
@@ -638,7 +638,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Find more example apps, tutorials, and projects using Redis Vector Similarity Search [in this GitHub organization](https://github.com/RedisVentures)."
+    "Find more example apps, tutorials, and projects using Redis Vector Similarity Search check out the [Redis AI resources repo](https://github.com/redis-developer/redis-ai-resources/tree/main)."
    ]
   }
  ],

From e6d4f109e32c6e64e30c4a99e42bc717ed65b181 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 3 Apr 2025 16:28:19 +0300
Subject: [PATCH 1025/1164] Bump rojopolis/spellcheck-github-actions from
 0.47.0 to 0.48.0 (#3580)

---
 .github/workflows/spellcheck.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/spellcheck.yml b/.github/workflows/spellcheck.yml
index beefa6164f..4d0fc338d6 100644
--- a/.github/workflows/spellcheck.yml
+++ b/.github/workflows/spellcheck.yml
@@ -8,7 +8,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
       - name: Check Spelling
-        uses: rojopolis/spellcheck-github-actions@0.47.0
+        uses: rojopolis/spellcheck-github-actions@0.48.0
         with:
           config_path: .github/spellcheck-settings.yml
           task_name: Markdown

From 72b89c9639d6a397de103c922bb406e99c448a37 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Fri, 4 Apr 2025 12:06:32 +0300
Subject: [PATCH 1026/1164] Run pipeline tests against latest 8.0 RC1 image.
 (#3585)

---
 .github/workflows/integration.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 514a88a796..f8aa5c8932 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -74,7 +74,7 @@ jobs:
       max-parallel: 15
       fail-fast: false
       matrix:
-        redis-version: ['8.0-M05-pre', '${{ needs.redis_version.outputs.CURRENT }}', '7.2.7', '6.2.17']
+        redis-version: ['8.0-RC1-pre', '${{ needs.redis_version.outputs.CURRENT }}', '7.2.7', '6.2.17']
         python-version: ['3.8', '3.13']
         parser-backend: ['plain']
         event-loop: ['asyncio']

From a16b7dbd4562aa38ad8fdcf32c78d891aba1cc42 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Fri, 4 Apr 2025 13:11:40 +0300
Subject: [PATCH 1027/1164] Adding info for sentinel handling failover when
 Redis client is acquired with master_for() method. (#3578)

Co-authored-by: Elena Kolevska <elena-kolevska@users.noreply.github.com>
---
 redis/asyncio/sentinel.py | 2 ++
 redis/sentinel.py         | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/redis/asyncio/sentinel.py b/redis/asyncio/sentinel.py
index 0389539fcf..fae6875d82 100644
--- a/redis/asyncio/sentinel.py
+++ b/redis/asyncio/sentinel.py
@@ -326,6 +326,8 @@ def master_for(
     ):
         """
         Returns a redis client instance for the ``service_name`` master.
+        Sentinel client will detect failover and reconnect Redis clients
+        automatically.
 
         A :py:class:`~redis.sentinel.SentinelConnectionPool` class is
         used to retrieve the master's address before establishing a new
diff --git a/redis/sentinel.py b/redis/sentinel.py
index 521ac24142..02aa244ede 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -349,6 +349,8 @@ def master_for(
     ):
         """
         Returns a redis client instance for the ``service_name`` master.
+        Sentinel client will detect failover and reconnect Redis clients
+        automatically.
 
         A :py:class:`~redis.sentinel.SentinelConnectionPool` class is
         used to retrieve the master's address before establishing a new

From 8ddc6fa0acbab18accc07015de1d1e06408dcb73 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Mon, 7 Apr 2025 15:09:29 +0300
Subject: [PATCH 1028/1164] Adding VectorSet commands support. (#3584)

---
 docker-compose.yml                   |   4 +-
 redis/commands/redismodules.py       |   8 +
 redis/commands/vectorset/__init__.py |  46 ++
 redis/commands/vectorset/commands.py | 367 ++++++++++++
 redis/commands/vectorset/utils.py    |  94 +++
 tests/test_asyncio/test_vsets.py     | 858 +++++++++++++++++++++++++++
 tests/test_vsets.py                  | 856 ++++++++++++++++++++++++++
 7 files changed, 2231 insertions(+), 2 deletions(-)
 create mode 100644 redis/commands/vectorset/__init__.py
 create mode 100644 redis/commands/vectorset/commands.py
 create mode 100644 redis/commands/vectorset/utils.py
 create mode 100644 tests/test_asyncio/test_vsets.py
 create mode 100644 tests/test_vsets.py

diff --git a/docker-compose.yml b/docker-compose.yml
index 76a60398f3..75292bbd03 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,9 +1,9 @@
 ---
 x-client-libs-stack-image: &client-libs-stack-image
-  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_STACK_IMAGE_TAG:-rs-7.4.0-v2}"
+  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_STACK_IMAGE_TAG:-8.0-M06-pre}"
 
 x-client-libs-image: &client-libs-image
-  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_IMAGE_TAG:-7.4.2}"
+  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_IMAGE_TAG:-8.0-M06-pre}"
 
 services:
 
diff --git a/redis/commands/redismodules.py b/redis/commands/redismodules.py
index 7ba40dd845..6e253b1597 100644
--- a/redis/commands/redismodules.py
+++ b/redis/commands/redismodules.py
@@ -72,6 +72,14 @@ def tdigest(self):
         tdigest = TDigestBloom(client=self)
         return tdigest
 
+    def vset(self):
+        """Access the VectorSet commands namespace."""
+
+        from .vectorset import VectorSet
+
+        vset = VectorSet(client=self)
+        return vset
+
 
 class AsyncRedisModuleCommands(RedisModuleCommands):
     def ft(self, index_name="idx"):
diff --git a/redis/commands/vectorset/__init__.py b/redis/commands/vectorset/__init__.py
new file mode 100644
index 0000000000..d78580a73b
--- /dev/null
+++ b/redis/commands/vectorset/__init__.py
@@ -0,0 +1,46 @@
+import json
+
+from redis._parsers.helpers import pairs_to_dict
+from redis.commands.vectorset.utils import (
+    parse_vemb_result,
+    parse_vlinks_result,
+    parse_vsim_result,
+)
+
+from ..helpers import get_protocol_version
+from .commands import (
+    VEMB_CMD,
+    VGETATTR_CMD,
+    VINFO_CMD,
+    VLINKS_CMD,
+    VSIM_CMD,
+    VectorSetCommands,
+)
+
+
+class VectorSet(VectorSetCommands):
+    def __init__(self, client, **kwargs):
+        """Create a new VectorSet client."""
+        # Set the module commands' callbacks
+        self._MODULE_CALLBACKS = {
+            VEMB_CMD: parse_vemb_result,
+            VGETATTR_CMD: lambda r: r and json.loads(r) or None,
+        }
+
+        self._RESP2_MODULE_CALLBACKS = {
+            VINFO_CMD: lambda r: r and pairs_to_dict(r) or None,
+            VSIM_CMD: parse_vsim_result,
+            VLINKS_CMD: parse_vlinks_result,
+        }
+        self._RESP3_MODULE_CALLBACKS = {}
+
+        self.client = client
+        self.execute_command = client.execute_command
+
+        if get_protocol_version(self.client) in ["3", 3]:
+            self._MODULE_CALLBACKS.update(self._RESP3_MODULE_CALLBACKS)
+        else:
+            self._MODULE_CALLBACKS.update(self._RESP2_MODULE_CALLBACKS)
+
+        for k, v in self._MODULE_CALLBACKS.items():
+            self.client.set_response_callback(k, v)
diff --git a/redis/commands/vectorset/commands.py b/redis/commands/vectorset/commands.py
new file mode 100644
index 0000000000..c24bd200ce
--- /dev/null
+++ b/redis/commands/vectorset/commands.py
@@ -0,0 +1,367 @@
+import json
+from enum import Enum
+from typing import Awaitable, Dict, List, Optional, Union
+
+from redis.client import NEVER_DECODE
+from redis.commands.helpers import get_protocol_version
+from redis.exceptions import DataError
+from redis.typing import CommandsProtocol, EncodableT, KeyT, Number
+
+VADD_CMD = "VADD"
+VSIM_CMD = "VSIM"
+VREM_CMD = "VREM"
+VDIM_CMD = "VDIM"
+VCARD_CMD = "VCARD"
+VEMB_CMD = "VEMB"
+VLINKS_CMD = "VLINKS"
+VINFO_CMD = "VINFO"
+VSETATTR_CMD = "VSETATTR"
+VGETATTR_CMD = "VGETATTR"
+VRANDMEMBER_CMD = "VRANDMEMBER"
+
+
+class QuantizationOptions(Enum):
+    """Quantization options for the VADD command."""
+
+    NOQUANT = "NOQUANT"
+    BIN = "BIN"
+    Q8 = "Q8"
+
+
+class CallbacksOptions(Enum):
+    """Options that can be set for the commands callbacks"""
+
+    RAW = "RAW"
+    WITHSCORES = "WITHSCORES"
+    ALLOW_DECODING = "ALLOW_DECODING"
+    RESP3 = "RESP3"
+
+
+class VectorSetCommands(CommandsProtocol):
+    """Redis VectorSet commands"""
+
+    def vadd(
+        self,
+        key: KeyT,
+        vector: Union[List[float], bytes],
+        element: str,
+        reduce_dim: Optional[int] = None,
+        cas: Optional[bool] = False,
+        quantization: Optional[QuantizationOptions] = None,
+        ef: Optional[Number] = None,
+        attributes: Optional[Union[dict, str]] = None,
+        numlinks: Optional[int] = None,
+    ) -> Union[Awaitable[int], int]:
+        """
+        Add vector ``vector`` for element ``element`` to a vector set ``key``.
+
+        ``reduce_dim`` sets the dimensions to reduce the vector to.
+                If not provided, the vector is not reduced.
+
+        ``cas`` is a boolean flag that indicates whether to use CAS (check-and-set style)
+                when adding the vector. If not provided, CAS is not used.
+
+        ``quantization`` sets the quantization type to use.
+                If not provided, int8 quantization is used.
+                The options are:
+                - NOQUANT: No quantization
+                - BIN: Binary quantization
+                - Q8: Signed 8-bit quantization
+
+        ``ef`` sets the exploration factor to use.
+                If not provided, the default exploration factor is used.
+
+        ``attributes`` is a dictionary or json string that contains the attributes to set for the vector.
+                If not provided, no attributes are set.
+
+        ``numlinks`` sets the number of links to create for the vector.
+                If not provided, the default number of links is used.
+
+        For more information see https://redis.io/commands/vadd
+        """
+        if not vector or not element:
+            raise DataError("Both vector and element must be provided")
+
+        pieces = []
+        if reduce_dim:
+            pieces.extend(["REDUCE", reduce_dim])
+
+        values_pieces = []
+        if isinstance(vector, bytes):
+            values_pieces.extend(["FP32", vector])
+        else:
+            values_pieces.extend(["VALUES", len(vector)])
+            values_pieces.extend(vector)
+        pieces.extend(values_pieces)
+
+        pieces.append(element)
+
+        if cas:
+            pieces.append("CAS")
+
+        if quantization:
+            pieces.append(quantization.value)
+
+        if ef:
+            pieces.extend(["EF", ef])
+
+        if attributes:
+            if isinstance(attributes, dict):
+                # transform attributes to json string
+                attributes_json = json.dumps(attributes)
+            else:
+                attributes_json = attributes
+            pieces.extend(["SETATTR", attributes_json])
+
+        if numlinks:
+            pieces.extend(["M", numlinks])
+
+        return self.execute_command(VADD_CMD, key, *pieces)
+
+    def vsim(
+        self,
+        key: KeyT,
+        input: Union[List[float], bytes, str],
+        with_scores: Optional[bool] = False,
+        count: Optional[int] = None,
+        ef: Optional[Number] = None,
+        filter: Optional[str] = None,
+        filter_ef: Optional[str] = None,
+        truth: Optional[bool] = False,
+        no_thread: Optional[bool] = False,
+    ) -> Union[
+        Awaitable[Optional[List[Union[List[EncodableT], Dict[EncodableT, Number]]]]],
+        Optional[List[Union[List[EncodableT], Dict[EncodableT, Number]]]],
+    ]:
+        """
+        Compare a vector or element ``input``  with the other vectors in a vector set ``key``.
+
+        ``with_scores`` sets if the results should be returned with the
+                similarity scores of the elements in the result.
+
+        ``count`` sets the number of results to return.
+
+        ``ef`` sets the exploration factor.
+
+        ``filter`` sets filter that should be applied for the search.
+
+        ``filter_ef`` sets the max filtering effort.
+
+        ``truth`` when enabled forces the command to perform linear scan.
+
+        ``no_thread`` when enabled forces the command to execute the search
+                on the data structure in the main thread.
+
+        For more information see https://redis.io/commands/vsim
+        """
+
+        if not input:
+            raise DataError("'input' should be provided")
+
+        pieces = []
+        options = {}
+
+        if isinstance(input, bytes):
+            pieces.extend(["FP32", input])
+        elif isinstance(input, list):
+            pieces.extend(["VALUES", len(input)])
+            pieces.extend(input)
+        else:
+            pieces.extend(["ELE", input])
+
+        if with_scores:
+            pieces.append("WITHSCORES")
+            options[CallbacksOptions.WITHSCORES.value] = True
+
+        if count:
+            pieces.extend(["COUNT", count])
+
+        if ef:
+            pieces.extend(["EF", ef])
+
+        if filter:
+            pieces.extend(["FILTER", filter])
+
+        if filter_ef:
+            pieces.extend(["FILTER-EF", filter_ef])
+
+        if truth:
+            pieces.append("TRUTH")
+
+        if no_thread:
+            pieces.append("NOTHREAD")
+
+        return self.execute_command(VSIM_CMD, key, *pieces, **options)
+
+    def vdim(self, key: KeyT) -> Union[Awaitable[int], int]:
+        """
+        Get the dimension of a vector set.
+
+        In the case of vectors that were populated using the `REDUCE`
+        option, for random projection, the vector set will report the size of
+        the projected (reduced) dimension.
+
+        Raises `redis.exceptions.ResponseError` if the vector set doesn't exist.
+
+        For more information see https://redis.io/commands/vdim
+        """
+        return self.execute_command(VDIM_CMD, key)
+
+    def vcard(self, key: KeyT) -> Union[Awaitable[int], int]:
+        """
+        Get the cardinality(the number of elements) of a vector set with key ``key``.
+
+        Raises `redis.exceptions.ResponseError` if the vector set doesn't exist.
+
+        For more information see https://redis.io/commands/vcard
+        """
+        return self.execute_command(VCARD_CMD, key)
+
+    def vrem(self, key: KeyT, element: str) -> Union[Awaitable[int], int]:
+        """
+        Remove an element from a vector set.
+
+        For more information see https://redis.io/commands/vrem
+        """
+        return self.execute_command(VREM_CMD, key, element)
+
+    def vemb(
+        self, key: KeyT, element: str, raw: Optional[bool] = False
+    ) -> Union[
+        Awaitable[Optional[Union[List[EncodableT], Dict[str, EncodableT]]]],
+        Optional[Union[List[EncodableT], Dict[str, EncodableT]]],
+    ]:
+        """
+        Get the approximated vector of an element ``element`` from vector set ``key``.
+
+        ``raw`` is a boolean flag that indicates whether to return the
+                interal representation used by the vector.
+
+
+        For more information see https://redis.io/commands/vembed
+        """
+        options = {}
+        pieces = []
+        pieces.extend([key, element])
+
+        if get_protocol_version(self.client) in ["3", 3]:
+            options[CallbacksOptions.RESP3.value] = True
+
+        if raw:
+            pieces.append("RAW")
+
+            options[NEVER_DECODE] = True
+            if (
+                hasattr(self.client, "connection_pool")
+                and self.client.connection_pool.connection_kwargs["decode_responses"]
+            ) or (
+                hasattr(self.client, "nodes_manager")
+                and self.client.nodes_manager.connection_kwargs["decode_responses"]
+            ):
+                # allow decoding in the postprocessing callback
+                # if the user set decode_responses=True
+                # in the connection pool
+                options[CallbacksOptions.ALLOW_DECODING.value] = True
+
+            options[CallbacksOptions.RAW.value] = True
+
+        return self.execute_command(VEMB_CMD, *pieces, **options)
+
+    def vlinks(
+        self, key: KeyT, element: str, with_scores: Optional[bool] = False
+    ) -> Union[
+        Awaitable[
+            Optional[
+                List[Union[List[Union[str, bytes]], Dict[Union[str, bytes], Number]]]
+            ]
+        ],
+        Optional[List[Union[List[Union[str, bytes]], Dict[Union[str, bytes], Number]]]],
+    ]:
+        """
+        Returns the neighbors for each level the element ``element`` exists in the vector set ``key``.
+
+        The result is a list of lists, where each list contains the neighbors for one level.
+        If the element does not exist, or if the vector set does not exist, None is returned.
+
+        If the ``WITHSCORES`` option is provided, the result is a list of dicts,
+        where each dict contains the neighbors for one level, with the scores as values.
+
+        For more information see https://redis.io/commands/vlinks
+        """
+        options = {}
+        pieces = []
+        pieces.extend([key, element])
+
+        if with_scores:
+            pieces.append("WITHSCORES")
+            options[CallbacksOptions.WITHSCORES.value] = True
+
+        return self.execute_command(VLINKS_CMD, *pieces, **options)
+
+    def vinfo(self, key: KeyT) -> Union[Awaitable[dict], dict]:
+        """
+        Get information about a vector set.
+
+        For more information see https://redis.io/commands/vinfo
+        """
+        return self.execute_command(VINFO_CMD, key)
+
+    def vsetattr(
+        self, key: KeyT, element: str, attributes: Optional[Union[dict, str]] = None
+    ) -> Union[Awaitable[int], int]:
+        """
+        Associate or remove JSON attributes ``attributes`` of element ``element``
+        for vector set ``key``.
+
+        For more information see https://redis.io/commands/vsetattr
+        """
+        if attributes is None:
+            attributes_json = "{}"
+        elif isinstance(attributes, dict):
+            # transform attributes to json string
+            attributes_json = json.dumps(attributes)
+        else:
+            attributes_json = attributes
+
+        return self.execute_command(VSETATTR_CMD, key, element, attributes_json)
+
+    def vgetattr(
+        self, key: KeyT, element: str
+    ) -> Union[Optional[Awaitable[dict]], Optional[dict]]:
+        """
+        Retrieve the JSON attributes of an element ``elemet`` for vector set ``key``.
+
+        If the element does not exist, or if the vector set does not exist, None is
+        returned.
+
+        For more information see https://redis.io/commands/vgetattr
+        """
+        return self.execute_command(VGETATTR_CMD, key, element)
+
+    def vrandmember(
+        self, key: KeyT, count: Optional[int] = None
+    ) -> Union[
+        Awaitable[Optional[Union[List[str], str]]], Optional[Union[List[str], str]]
+    ]:
+        """
+        Returns random elements from a vector set ``key``.
+
+        ``count`` is the number of elements to return.
+                If ``count`` is not provided, a single element is returned as a single string.
+                If ``count`` is positive(smaller than the number of elements
+                            in the vector set), the command returns a list with up to ``count``
+                            distinct elements from the vector set
+                If ``count`` is negative, the command returns a list with ``count`` random elements,
+                            potentially with duplicates.
+                If ``count`` is greater than the number of elements in the vector set,
+                            only the entire set is returned as a list.
+
+        If the vector set does not exist, ``None`` is returned.
+
+        For more information see https://redis.io/commands/vrandmember
+        """
+        pieces = []
+        pieces.append(key)
+        if count is not None:
+            pieces.append(count)
+        return self.execute_command(VRANDMEMBER_CMD, *pieces)
diff --git a/redis/commands/vectorset/utils.py b/redis/commands/vectorset/utils.py
new file mode 100644
index 0000000000..ed6d194ae0
--- /dev/null
+++ b/redis/commands/vectorset/utils.py
@@ -0,0 +1,94 @@
+from redis._parsers.helpers import pairs_to_dict
+from redis.commands.vectorset.commands import CallbacksOptions
+
+
+def parse_vemb_result(response, **options):
+    """
+    Handle VEMB result since the command can returning different result
+    structures depending on input options and on quantization type of the vector set.
+
+    Parsing VEMB result into:
+    - List[Union[bytes, Union[int, float]]]
+    - Dict[str, Union[bytes, str, float]]
+    """
+    if response is None:
+        return response
+
+    if options.get(CallbacksOptions.RAW.value):
+        result = {}
+        result["quantization"] = (
+            response[0].decode("utf-8")
+            if options.get(CallbacksOptions.ALLOW_DECODING.value)
+            else response[0]
+        )
+        result["raw"] = response[1]
+        result["l2"] = float(response[2])
+        if len(response) > 3:
+            result["range"] = float(response[3])
+        return result
+    else:
+        if options.get(CallbacksOptions.RESP3.value):
+            return response
+
+        result = []
+        for i in range(len(response)):
+            try:
+                result.append(int(response[i]))
+            except ValueError:
+                # if the value is not an integer, it should be a float
+                result.append(float(response[i]))
+
+        return result
+
+
+def parse_vlinks_result(response, **options):
+    """
+    Handle VLINKS result since the command can be returning different result
+    structures depending on input options.
+    Parsing VLINKS result into:
+    - List[List[str]]
+    - List[Dict[str, Number]]
+    """
+    if response is None:
+        return response
+
+    if options.get(CallbacksOptions.WITHSCORES.value):
+        result = []
+        # Redis will return a list of list of strings.
+        # This list have to be transformed to list of dicts
+        for level_item in response:
+            level_data_dict = {}
+            for key, value in pairs_to_dict(level_item).items():
+                value = float(value)
+                level_data_dict[key] = value
+            result.append(level_data_dict)
+        return result
+    else:
+        # return the list of elements for each level
+        # list of lists
+        return response
+
+
+def parse_vsim_result(response, **options):
+    """
+    Handle VSIM result since the command can be returning different result
+    structures depending on input options.
+    Parsing VSIM result into:
+    - List[List[str]]
+    - List[Dict[str, Number]]
+    """
+    if response is None:
+        return response
+
+    if options.get(CallbacksOptions.WITHSCORES.value):
+        # Redis will return a list of list of pairs.
+        # This list have to be transformed to dict
+        result_dict = {}
+        for key, value in pairs_to_dict(response).items():
+            value = float(value)
+            result_dict[key] = value
+        return result_dict
+    else:
+        # return the list of elements for each level
+        # list of lists
+        return response
diff --git a/tests/test_asyncio/test_vsets.py b/tests/test_asyncio/test_vsets.py
new file mode 100644
index 0000000000..9abc899066
--- /dev/null
+++ b/tests/test_asyncio/test_vsets.py
@@ -0,0 +1,858 @@
+import json
+import random
+import numpy as np
+import pytest
+import pytest_asyncio
+import redis
+from redis.commands.vectorset.commands import QuantizationOptions
+
+from tests.conftest import (
+    skip_if_server_version_lt,
+)
+
+
+@pytest_asyncio.fixture()
+async def d_client(create_redis, redis_url):
+    return await create_redis(url=redis_url, decode_responses=True)
+
+
+@pytest_asyncio.fixture()
+async def client(create_redis, redis_url):
+    return await create_redis(url=redis_url, decode_responses=False)
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_add_elem_with_values(d_client):
+    float_array = [1, 4.32, 0.11]
+    resp = await d_client.vset().vadd("myset", float_array, "elem1")
+    assert resp == 1
+
+    emb = await d_client.vset().vemb("myset", "elem1")
+    assert _validate_quantization(float_array, emb, tolerance=0.1)
+
+    with pytest.raises(redis.DataError):
+        await d_client.vset().vadd("myset_invalid_data", None, "elem1")
+
+    with pytest.raises(redis.DataError):
+        await d_client.vset().vadd("myset_invalid_data", [12, 45], None, reduce_dim=3)
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_add_elem_with_vector(d_client):
+    float_array = [1, 4.32, 0.11]
+    # Convert the list of floats to a byte array in fp32 format
+    byte_array = _to_fp32_blob_array(float_array)
+    resp = await d_client.vset().vadd("myset", byte_array, "elem1")
+    assert resp == 1
+
+    emb = await d_client.vset().vemb("myset", "elem1")
+    assert _validate_quantization(float_array, emb, tolerance=0.1)
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_add_elem_reduced_dim(d_client):
+    float_array = [1, 4.32, 0.11, 0.5, 0.9]
+    resp = await d_client.vset().vadd("myset", float_array, "elem1", reduce_dim=3)
+    assert resp == 1
+
+    dim = await d_client.vset().vdim("myset")
+    assert dim == 3
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_add_elem_cas(d_client):
+    float_array = [1, 4.32, 0.11, 0.5, 0.9]
+    resp = await d_client.vset().vadd(
+        "myset", vector=float_array, element="elem1", cas=True
+    )
+    assert resp == 1
+
+    emb = await d_client.vset().vemb("myset", "elem1")
+    assert _validate_quantization(float_array, emb, tolerance=0.1)
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_add_elem_no_quant(d_client):
+    float_array = [1, 4.32, 0.11, 0.5, 0.9]
+    resp = await d_client.vset().vadd(
+        "myset",
+        vector=float_array,
+        element="elem1",
+        quantization=QuantizationOptions.NOQUANT,
+    )
+    assert resp == 1
+
+    emb = await d_client.vset().vemb("myset", "elem1")
+    assert _validate_quantization(float_array, emb, tolerance=0.0)
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_add_elem_bin_quant(d_client):
+    float_array = [1, 4.32, 0.0, 0.05, -2.9]
+    resp = await d_client.vset().vadd(
+        "myset",
+        vector=float_array,
+        element="elem1",
+        quantization=QuantizationOptions.BIN,
+    )
+    assert resp == 1
+
+    emb = await d_client.vset().vemb("myset", "elem1")
+    expected_array = [1, 1, -1, 1, -1]
+    assert _validate_quantization(expected_array, emb, tolerance=0.0)
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_add_elem_q8_quant(d_client):
+    float_array = [1, 4.32, 10.0, -21, -2.9]
+    resp = await d_client.vset().vadd(
+        "myset",
+        vector=float_array,
+        element="elem1",
+        quantization=QuantizationOptions.BIN,
+    )
+    assert resp == 1
+
+    emb = await d_client.vset().vemb("myset", "elem1")
+    expected_array = [1, 1, 1, -1, -1]
+    assert _validate_quantization(expected_array, emb, tolerance=0.0)
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_add_elem_ef(d_client):
+    await d_client.vset().vadd("myset", vector=[5, 55, 65, -20, 30], element="elem1")
+    await d_client.vset().vadd(
+        "myset", vector=[-40, -40.32, 10.0, -4, 2.9], element="elem2"
+    )
+
+    float_array = [1, 4.32, 10.0, -21, -2.9]
+    resp = await d_client.vset().vadd("myset", float_array, "elem3", ef=1)
+    assert resp == 1
+
+    emb = await d_client.vset().vemb("myset", "elem3")
+    assert _validate_quantization(float_array, emb, tolerance=0.1)
+
+    sim = await d_client.vset().vsim("myset", input="elem3", with_scores=True)
+    assert len(sim) == 3
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_add_elem_with_attr(d_client):
+    float_array = [1, 4.32, 10.0, -21, -2.9]
+    attrs_dict = {"key1": "value1", "key2": "value2"}
+    resp = await d_client.vset().vadd(
+        "myset",
+        vector=float_array,
+        element="elem3",
+        attributes=attrs_dict,
+    )
+    assert resp == 1
+
+    emb = await d_client.vset().vemb("myset", "elem3")
+    assert _validate_quantization(float_array, emb, tolerance=0.1)
+
+    attr_saved = await d_client.vset().vgetattr("myset", "elem3")
+    assert attr_saved == attrs_dict
+
+    resp = await d_client.vset().vadd(
+        "myset",
+        vector=float_array,
+        element="elem4",
+        attributes={},
+    )
+    assert resp == 1
+
+    emb = await d_client.vset().vemb("myset", "elem4")
+    assert _validate_quantization(float_array, emb, tolerance=0.1)
+
+    attr_saved = await d_client.vset().vgetattr("myset", "elem4")
+    assert attr_saved is None
+
+    resp = await d_client.vset().vadd(
+        "myset",
+        vector=float_array,
+        element="elem5",
+        attributes=json.dumps(attrs_dict),
+    )
+    assert resp == 1
+
+    emb = await d_client.vset().vemb("myset", "elem5")
+    assert _validate_quantization(float_array, emb, tolerance=0.1)
+
+    attr_saved = await d_client.vset().vgetattr("myset", "elem5")
+    assert attr_saved == attrs_dict
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_add_elem_with_numlinks(d_client):
+    elements_count = 100
+    vector_dim = 10
+    for i in range(elements_count):
+        float_array = [random.randint(0, 10) for x in range(vector_dim)]
+        await d_client.vset().vadd(
+            "myset",
+            float_array,
+            f"elem{i}",
+            numlinks=8,
+        )
+
+    float_array = [1, 4.32, 0.11, 0.5, 0.9, 0.1, 0.2, 0.3, 0.4, 0.5]
+    resp = await d_client.vset().vadd("myset", float_array, "elem_numlinks", numlinks=8)
+    assert resp == 1
+
+    emb = await d_client.vset().vemb("myset", "elem_numlinks")
+    assert _validate_quantization(float_array, emb, tolerance=0.5)
+
+    numlinks_all_layers = await d_client.vset().vlinks("myset", "elem_numlinks")
+    for neighbours_list_for_layer in numlinks_all_layers:
+        assert len(neighbours_list_for_layer) <= 8
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_vsim_count(d_client):
+    elements_count = 30
+    vector_dim = 800
+    for i in range(elements_count):
+        float_array = [random.uniform(0, 10) for x in range(vector_dim)]
+        await d_client.vset().vadd(
+            "myset",
+            float_array,
+            f"elem{i}",
+            numlinks=64,
+        )
+
+    vsim = await d_client.vset().vsim("myset", input="elem1")
+    assert len(vsim) == 10
+    assert isinstance(vsim, list)
+    assert isinstance(vsim[0], str)
+
+    vsim = await d_client.vset().vsim("myset", input="elem1", count=5)
+    assert len(vsim) == 5
+    assert isinstance(vsim, list)
+    assert isinstance(vsim[0], str)
+
+    vsim = await d_client.vset().vsim("myset", input="elem1", count=50)
+    assert len(vsim) == 30
+    assert isinstance(vsim, list)
+    assert isinstance(vsim[0], str)
+
+    vsim = await d_client.vset().vsim("myset", input="elem1", count=15)
+    assert len(vsim) == 15
+    assert isinstance(vsim, list)
+    assert isinstance(vsim[0], str)
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_vsim_with_scores(d_client):
+    elements_count = 20
+    vector_dim = 50
+    for i in range(elements_count):
+        float_array = [random.uniform(0, 10) for x in range(vector_dim)]
+        await d_client.vset().vadd(
+            "myset",
+            float_array,
+            f"elem{i}",
+            numlinks=64,
+        )
+
+    vsim = await d_client.vset().vsim("myset", input="elem1", with_scores=True)
+    assert len(vsim) == 10
+    assert isinstance(vsim, dict)
+    assert isinstance(vsim["elem1"], float)
+    assert 0 <= vsim["elem1"] <= 1
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_vsim_with_different_vector_input_types(d_client):
+    elements_count = 10
+    vector_dim = 5
+    for i in range(elements_count):
+        float_array = [random.uniform(0, 10) for x in range(vector_dim)]
+        attributes = {"index": i, "elem_name": f"elem_{i}"}
+        await d_client.vset().vadd(
+            "myset",
+            float_array,
+            f"elem_{i}",
+            numlinks=4,
+            attributes=attributes,
+        )
+    sim = await d_client.vset().vsim("myset", input="elem_1")
+    assert len(sim) == 10
+    assert isinstance(sim, list)
+
+    float_array = [1, 4.32, 0.0, 0.05, -2.9]
+    sim_to_float_array = await d_client.vset().vsim("myset", input=float_array)
+    assert len(sim_to_float_array) == 10
+    assert isinstance(sim_to_float_array, list)
+
+    fp32_vector = _to_fp32_blob_array(float_array)
+    sim_to_fp32_vector = await d_client.vset().vsim("myset", input=fp32_vector)
+    assert len(sim_to_fp32_vector) == 10
+    assert isinstance(sim_to_fp32_vector, list)
+    assert sim_to_float_array == sim_to_fp32_vector
+
+    with pytest.raises(redis.DataError):
+        await d_client.vset().vsim("myset", input=None)
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_vsim_unexisting(d_client):
+    float_array = [1, 4.32, 0.11, 0.5, 0.9]
+    await d_client.vset().vadd("myset", vector=float_array, element="elem1", cas=True)
+
+    with pytest.raises(redis.ResponseError):
+        await d_client.vset().vsim("myset", input="elem_not_existing")
+
+    sim = await d_client.vset().vsim("myset_not_existing", input="elem1")
+    assert sim == []
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_vsim_with_filter(d_client):
+    elements_count = 30
+    vector_dim = 800
+    for i in range(elements_count):
+        float_array = [random.uniform(0, 10) for x in range(vector_dim)]
+        attributes = {"index": i, "elem_name": f"elem_{i}"}
+        await d_client.vset().vadd(
+            "myset",
+            float_array,
+            f"elem_{i}",
+            numlinks=4,
+            attributes=attributes,
+        )
+    sim = await d_client.vset().vsim("myset", input="elem_1", filter=".index > 10")
+    assert len(sim) == 10
+    assert isinstance(sim, list)
+    for elem in sim:
+        assert int(elem.split("_")[1]) > 10
+
+    sim = await d_client.vset().vsim(
+        "myset",
+        input="elem_1",
+        filter=".index > 10 and .index < 15 and .elem_name in ['elem_12', 'elem_17']",
+    )
+    assert len(sim) == 1
+    assert isinstance(sim, list)
+    assert sim[0] == "elem_12"
+
+    sim = await d_client.vset().vsim(
+        "myset",
+        input="elem_1",
+        filter=".index > 25 and .elem_name in ['elem_12', 'elem_17', 'elem_19']",
+        ef=100,
+    )
+    assert len(sim) == 0
+    assert isinstance(sim, list)
+
+    sim = await d_client.vset().vsim(
+        "myset",
+        input="elem_1",
+        filter=".index > 28 and .elem_name in ['elem_12', 'elem_17', 'elem_29']",
+        filter_ef=1,
+    )
+    assert len(sim) == 0
+    assert isinstance(sim, list)
+
+    sim = await d_client.vset().vsim(
+        "myset",
+        input="elem_1",
+        filter=".index > 28 and .elem_name in ['elem_12', 'elem_17', 'elem_29']",
+        filter_ef=20,
+    )
+    assert len(sim) == 1
+    assert isinstance(sim, list)
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_vsim_truth_no_thread_enabled(d_client):
+    elements_count = 5000
+    vector_dim = 30
+    for i in range(1, elements_count + 1):
+        float_array = [random.uniform(10 * i, 1000 * i) for x in range(vector_dim)]
+        await d_client.vset().vadd("myset", float_array, f"elem_{i}")
+
+    await d_client.vset().vadd("myset", [-22 for _ in range(vector_dim)], "elem_man_2")
+
+    sim_without_truth = await d_client.vset().vsim(
+        "myset", input="elem_man_2", with_scores=True
+    )
+    sim_truth = await d_client.vset().vsim(
+        "myset", input="elem_man_2", with_scores=True, truth=True
+    )
+
+    assert len(sim_without_truth) == 10
+    assert len(sim_truth) == 10
+
+    assert isinstance(sim_without_truth, dict)
+    assert isinstance(sim_truth, dict)
+
+    results_scores = list(
+        zip(
+            [v for _, v in sim_truth.items()], [v for _, v in sim_without_truth.items()]
+        )
+    )
+
+    found_better_match = False
+    for index, (score_with_truth, score_without_truth) in enumerate(results_scores):
+        if score_with_truth < score_without_truth:
+            assert False, (
+                "Score with truth [{score_with_truth}] < score without truth [{score_without_truth}]"
+            )
+        elif score_with_truth > score_without_truth:
+            found_better_match = True
+
+    assert found_better_match
+
+    sim_no_thread = await d_client.vset().vsim(
+        "myset", input="elem_man_2", with_scores=True, no_thread=True
+    )
+
+    assert len(sim_no_thread) == 10
+    assert isinstance(sim_no_thread, dict)
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_vdim(d_client):
+    float_array = [1, 4.32, 0.11, 0.5, 0.9, 0.1, 0.2]
+    await d_client.vset().vadd("myset", float_array, "elem1")
+
+    dim = await d_client.vset().vdim("myset")
+    assert dim == len(float_array)
+
+    await d_client.vset().vadd("myset_reduced", float_array, "elem1", reduce_dim=4)
+    reduced_dim = await d_client.vset().vdim("myset_reduced")
+    assert reduced_dim == 4
+
+    with pytest.raises(redis.ResponseError):
+        await d_client.vset().vdim("myset_unexisting")
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_vcard(d_client):
+    n = 20
+    for i in range(n):
+        float_array = [random.uniform(0, 10) for x in range(1, 8)]
+        await d_client.vset().vadd("myset", float_array, f"elem{i}")
+
+    card = await d_client.vset().vcard("myset")
+    assert card == n
+
+    with pytest.raises(redis.ResponseError):
+        await d_client.vset().vdim("myset_unexisting")
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_vrem(d_client):
+    n = 3
+    for i in range(n):
+        float_array = [random.uniform(0, 10) for x in range(1, 8)]
+        await d_client.vset().vadd("myset", float_array, f"elem{i}")
+
+    resp = await d_client.vset().vrem("myset", "elem2")
+    assert resp == 1
+
+    card = await d_client.vset().vcard("myset")
+    assert card == n - 1
+
+    resp = await d_client.vset().vrem("myset", "elem2")
+    assert resp == 0
+
+    card = await d_client.vset().vcard("myset")
+    assert card == n - 1
+
+    resp = await d_client.vset().vrem("myset_unexisting", "elem1")
+    assert resp == 0
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_vemb_bin_quantization(d_client):
+    e = [1, 4.32, 0.0, 0.05, -2.9]
+    await d_client.vset().vadd(
+        "myset",
+        e,
+        "elem",
+        quantization=QuantizationOptions.BIN,
+    )
+    emb_no_quant = await d_client.vset().vemb("myset", "elem")
+    assert emb_no_quant == [1, 1, -1, 1, -1]
+
+    emb_no_quant_raw = await d_client.vset().vemb("myset", "elem", raw=True)
+    assert emb_no_quant_raw["quantization"] == "bin"
+    assert isinstance(emb_no_quant_raw["raw"], bytes)
+    assert isinstance(emb_no_quant_raw["l2"], float)
+    assert "range" not in emb_no_quant_raw
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_vemb_q8_quantization(d_client):
+    e = [1, 10.32, 0.0, 2.05, -12.5]
+    await d_client.vset().vadd("myset", e, "elem", quantization=QuantizationOptions.Q8)
+
+    emb_q8_quant = await d_client.vset().vemb("myset", "elem")
+    assert _validate_quantization(e, emb_q8_quant, tolerance=0.1)
+
+    emb_q8_quant_raw = await d_client.vset().vemb("myset", "elem", raw=True)
+    assert emb_q8_quant_raw["quantization"] == "int8"
+    assert isinstance(emb_q8_quant_raw["raw"], bytes)
+    assert isinstance(emb_q8_quant_raw["l2"], float)
+    assert isinstance(emb_q8_quant_raw["range"], float)
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_vemb_no_quantization(d_client):
+    e = [1, 10.32, 0.0, 2.05, -12.5]
+    await d_client.vset().vadd(
+        "myset", e, "elem", quantization=QuantizationOptions.NOQUANT
+    )
+
+    emb_no_quant = await d_client.vset().vemb("myset", "elem")
+    assert _validate_quantization(e, emb_no_quant, tolerance=0.1)
+
+    emb_no_quant_raw = await d_client.vset().vemb("myset", "elem", raw=True)
+    assert emb_no_quant_raw["quantization"] == "f32"
+    assert isinstance(emb_no_quant_raw["raw"], bytes)
+    assert isinstance(emb_no_quant_raw["l2"], float)
+    assert "range" not in emb_no_quant_raw
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_vemb_default_quantization(d_client):
+    e = [1, 5.32, 0.0, 0.25, -5]
+    await d_client.vset().vadd("myset", vector=e, element="elem")
+
+    emb_default_quant = await d_client.vset().vemb("myset", "elem")
+    assert _validate_quantization(e, emb_default_quant, tolerance=0.1)
+
+    emb_default_quant_raw = await d_client.vset().vemb("myset", "elem", raw=True)
+    assert emb_default_quant_raw["quantization"] == "int8"
+    assert isinstance(emb_default_quant_raw["raw"], bytes)
+    assert isinstance(emb_default_quant_raw["l2"], float)
+    assert isinstance(emb_default_quant_raw["range"], float)
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_vemb_fp32_quantization(d_client):
+    float_array_fp32 = [1, 4.32, 0.11]
+    # Convert the list of floats to a byte array in fp32 format
+    byte_array = _to_fp32_blob_array(float_array_fp32)
+    await d_client.vset().vadd("myset", byte_array, "elem")
+
+    emb_fp32_quant = await d_client.vset().vemb("myset", "elem")
+    assert _validate_quantization(float_array_fp32, emb_fp32_quant, tolerance=0.1)
+
+    emb_fp32_quant_raw = await d_client.vset().vemb("myset", "elem", raw=True)
+    assert emb_fp32_quant_raw["quantization"] == "int8"
+    assert isinstance(emb_fp32_quant_raw["raw"], bytes)
+    assert isinstance(emb_fp32_quant_raw["l2"], float)
+    assert isinstance(emb_fp32_quant_raw["range"], float)
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_vemb_unexisting(d_client):
+    emb_not_existing = await d_client.vset().vemb("not_existing", "elem")
+    assert emb_not_existing is None
+
+    e = [1, 5.32, 0.0, 0.25, -5]
+    await d_client.vset().vadd("myset", vector=e, element="elem")
+    emb_elem_not_existing = await d_client.vset().vemb("myset", "not_existing")
+    assert emb_elem_not_existing is None
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_vlinks(d_client):
+    elements_count = 100
+    vector_dim = 800
+    for i in range(elements_count):
+        float_array = [random.uniform(0, 10) for x in range(vector_dim)]
+        await d_client.vset().vadd(
+            "myset",
+            float_array,
+            f"elem{i}",
+            numlinks=8,
+        )
+
+    element_links_all_layers = await d_client.vset().vlinks("myset", "elem1")
+    assert len(element_links_all_layers) >= 1
+    for neighbours_list_for_layer in element_links_all_layers:
+        assert isinstance(neighbours_list_for_layer, list)
+        for neighbour in neighbours_list_for_layer:
+            assert isinstance(neighbour, str)
+
+    elem_links_all_layers_with_scores = await d_client.vset().vlinks(
+        "myset", "elem1", with_scores=True
+    )
+    assert len(elem_links_all_layers_with_scores) >= 1
+    for neighbours_dict_for_layer in elem_links_all_layers_with_scores:
+        assert isinstance(neighbours_dict_for_layer, dict)
+        for neighbour_key, score_value in neighbours_dict_for_layer.items():
+            assert isinstance(neighbour_key, str)
+            assert isinstance(score_value, float)
+
+    float_array = [0.75, 0.25, 0.5, 0.1, 0.9]
+    await d_client.vset().vadd("myset_one_elem_only", float_array, "elem1")
+    elem_no_neighbours_with_scores = await d_client.vset().vlinks(
+        "myset_one_elem_only", "elem1", with_scores=True
+    )
+    assert len(elem_no_neighbours_with_scores) >= 1
+    for neighbours_dict_for_layer in elem_no_neighbours_with_scores:
+        assert isinstance(neighbours_dict_for_layer, dict)
+        assert len(neighbours_dict_for_layer) == 0
+
+    elem_no_neighbours_no_scores = await d_client.vset().vlinks(
+        "myset_one_elem_only", "elem1"
+    )
+    assert len(elem_no_neighbours_no_scores) >= 1
+    for neighbours_list_for_layer in elem_no_neighbours_no_scores:
+        assert isinstance(neighbours_list_for_layer, list)
+        assert len(neighbours_list_for_layer) == 0
+
+    unexisting_element_links = await d_client.vset().vlinks("myset", "unexisting_elem")
+    assert unexisting_element_links is None
+
+    unexisting_vset_links = await d_client.vset().vlinks("myset_unexisting", "elem1")
+    assert unexisting_vset_links is None
+
+    unexisting_element_links = await d_client.vset().vlinks(
+        "myset", "unexisting_elem", with_scores=True
+    )
+    assert unexisting_element_links is None
+
+    unexisting_vset_links = await d_client.vset().vlinks(
+        "myset_unexisting", "elem1", with_scores=True
+    )
+    assert unexisting_vset_links is None
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_vinfo(d_client):
+    elements_count = 100
+    vector_dim = 800
+    for i in range(elements_count):
+        float_array = [random.uniform(0, 10) for x in range(vector_dim)]
+        await d_client.vset().vadd(
+            "myset",
+            float_array,
+            f"elem{i}",
+            numlinks=8,
+            quantization=QuantizationOptions.BIN,
+        )
+
+    vset_info = await d_client.vset().vinfo("myset")
+    assert vset_info["quant-type"] == "bin"
+    assert vset_info["vector-dim"] == vector_dim
+    assert vset_info["size"] == elements_count
+    assert vset_info["max-level"] > 0
+    assert vset_info["hnsw-max-node-uid"] == elements_count
+
+    unexisting_vset_info = await d_client.vset().vinfo("myset_unexisting")
+    assert unexisting_vset_info is None
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_vset_vget_attributes(d_client):
+    float_array = [1, 4.32, 0.11]
+    attributes = {"key1": "value1", "key2": "value2"}
+
+    # validate vgetattrs when no attributes are set with vadd
+    resp = await d_client.vset().vadd("myset", float_array, "elem1")
+    assert resp == 1
+
+    attrs = await d_client.vset().vgetattr("myset", "elem1")
+    assert attrs is None
+
+    # validate vgetattrs when attributes are set with vadd
+    resp = await d_client.vset().vadd(
+        "myset_with_attrs", float_array, "elem1", attributes=attributes
+    )
+    assert resp == 1
+
+    attrs = await d_client.vset().vgetattr("myset_with_attrs", "elem1")
+    assert attrs == attributes
+
+    # Set attributes and get attributes
+    resp = await d_client.vset().vsetattr("myset", "elem1", attributes)
+    assert resp == 1
+    attr_saved = await d_client.vset().vgetattr("myset", "elem1")
+    assert attr_saved == attributes
+
+    # Set attributes to None
+    resp = await d_client.vset().vsetattr("myset", "elem1", None)
+    assert resp == 1
+    attr_saved = await d_client.vset().vgetattr("myset", "elem1")
+    assert attr_saved is None
+
+    # Set attributes to empty dict
+    resp = await d_client.vset().vsetattr("myset", "elem1", {})
+    assert resp == 1
+    attr_saved = await d_client.vset().vgetattr("myset", "elem1")
+    assert attr_saved is None
+
+    # Set attributes provided as string
+    resp = await d_client.vset().vsetattr("myset", "elem1", json.dumps(attributes))
+    assert resp == 1
+    attr_saved = await d_client.vset().vgetattr("myset", "elem1")
+    assert attr_saved == attributes
+
+    # Set attributes to unexisting element
+    resp = await d_client.vset().vsetattr("myset", "elem2", attributes)
+    assert resp == 0
+    attr_saved = await d_client.vset().vgetattr("myset", "elem2")
+    assert attr_saved is None
+
+    # Set attributes to unexisting vset
+    resp = await d_client.vset().vsetattr("myset_unexisting", "elem1", attributes)
+    assert resp == 0
+    attr_saved = await d_client.vset().vgetattr("myset_unexisting", "elem1")
+    assert attr_saved is None
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_vrandmember(d_client):
+    elements = ["elem1", "elem2", "elem3"]
+    for elem in elements:
+        float_array = [random.uniform(0, 10) for x in range(1, 8)]
+        await d_client.vset().vadd("myset", float_array, element=elem)
+
+    random_member = await d_client.vset().vrandmember("myset")
+    assert random_member in elements
+
+    members_list = await d_client.vset().vrandmember("myset", count=2)
+    assert len(members_list) == 2
+    assert all(member in elements for member in members_list)
+
+    # Test with count greater than the number of elements
+    members_list = await d_client.vset().vrandmember("myset", count=10)
+    assert len(members_list) == len(elements)
+    assert all(member in elements for member in members_list)
+
+    # Test with negative count
+    members_list = await d_client.vset().vrandmember("myset", count=-2)
+    assert len(members_list) == 2
+    assert all(member in elements for member in members_list)
+
+    # Test with count equal to the number of elements
+    members_list = await d_client.vset().vrandmember("myset", count=len(elements))
+    assert len(members_list) == len(elements)
+    assert all(member in elements for member in members_list)
+
+    # Test with count equal to 0
+    members_list = await d_client.vset().vrandmember("myset", count=0)
+    assert members_list == []
+
+    # Test with count equal to 1
+    members_list = await d_client.vset().vrandmember("myset", count=1)
+    assert len(members_list) == 1
+    assert members_list[0] in elements
+
+    # Test with count equal to -1
+    members_list = await d_client.vset().vrandmember("myset", count=-1)
+    assert len(members_list) == 1
+    assert members_list[0] in elements
+
+    # Test with unexisting vset & without count
+    members_list = await d_client.vset().vrandmember("myset_unexisting")
+    assert members_list is None
+
+    # Test with unexisting vset & count
+    members_list = await d_client.vset().vrandmember("myset_unexisting", count=5)
+    assert members_list == []
+
+
+@skip_if_server_version_lt("7.9.0")
+async def test_vset_commands_without_decoding_responces(client):
+    # test vadd
+    elements = ["elem1", "elem2", "elem3"]
+    for elem in elements:
+        float_array = [random.uniform(0, 10) for x in range(0, 8)]
+        resp = await client.vset().vadd("myset", float_array, element=elem)
+        assert resp == 1
+
+    # test vemb
+    emb = await client.vset().vemb("myset", "elem1")
+    assert len(emb) == 8
+    assert isinstance(emb, list)
+    assert all(isinstance(x, float) for x in emb)
+
+    emb_raw = await client.vset().vemb("myset", "elem1", raw=True)
+    assert emb_raw["quantization"] == b"int8"
+    assert isinstance(emb_raw["raw"], bytes)
+    assert isinstance(emb_raw["l2"], float)
+    assert isinstance(emb_raw["range"], float)
+
+    # test vsim
+    vsim = await client.vset().vsim("myset", input="elem1")
+    assert len(vsim) == 3
+    assert isinstance(vsim, list)
+    assert isinstance(vsim[0], bytes)
+
+    # test vsim with scores
+    vsim_with_scores = await client.vset().vsim(
+        "myset", input="elem1", with_scores=True
+    )
+    assert len(vsim_with_scores) == 3
+    assert isinstance(vsim_with_scores, dict)
+    assert isinstance(vsim_with_scores[b"elem1"], float)
+
+    # test vlinks - no scores
+    element_links_all_layers = await client.vset().vlinks("myset", "elem1")
+    assert len(element_links_all_layers) >= 1
+    for neighbours_list_for_layer in element_links_all_layers:
+        assert isinstance(neighbours_list_for_layer, list)
+        for neighbour in neighbours_list_for_layer:
+            assert isinstance(neighbour, bytes)
+    # test vlinks with scores
+    elem_links_all_layers_with_scores = await client.vset().vlinks(
+        "myset", "elem1", with_scores=True
+    )
+    assert len(elem_links_all_layers_with_scores) >= 1
+    for neighbours_dict_for_layer in elem_links_all_layers_with_scores:
+        assert isinstance(neighbours_dict_for_layer, dict)
+        for neighbour_key, score_value in neighbours_dict_for_layer.items():
+            assert isinstance(neighbour_key, bytes)
+            assert isinstance(score_value, float)
+
+    # test vinfo
+    vset_info = await client.vset().vinfo("myset")
+    assert vset_info[b"quant-type"] == b"int8"
+    assert vset_info[b"vector-dim"] == 8
+    assert vset_info[b"size"] == len(elements)
+    assert vset_info[b"max-level"] >= 0
+    assert vset_info[b"hnsw-max-node-uid"] == len(elements)
+
+    # test vgetattr
+    attributes = {"key1": "value1", "key2": "value2"}
+    await client.vset().vsetattr("myset", "elem1", attributes)
+    attrs = await client.vset().vgetattr("myset", "elem1")
+    assert attrs == attributes
+
+    # test vrandmember
+    random_member = await client.vset().vrandmember("myset")
+    assert isinstance(random_member, bytes)
+    assert random_member.decode("utf-8") in elements
+
+    members_list = await client.vset().vrandmember("myset", count=2)
+    assert len(members_list) == 2
+    assert all(member.decode("utf-8") in elements for member in members_list)
+
+
+def _to_fp32_blob_array(float_array):
+    """
+    Convert a list of floats to a byte array in fp32 format.
+    """
+    # Convert the list of floats to a NumPy array with dtype np.float32
+    arr = np.array(float_array, dtype=np.float32)
+    # Convert the NumPy array to a byte array
+    byte_array = arr.tobytes()
+    return byte_array
+
+
+def _validate_quantization(original, quantized, tolerance=0.1):
+    original = np.array(original, dtype=np.float32)
+    quantized = np.array(quantized, dtype=np.float32)
+
+    max_diff = np.max(np.abs(original - quantized))
+    if max_diff > tolerance:
+        return False
+    else:
+        return True
diff --git a/tests/test_vsets.py b/tests/test_vsets.py
new file mode 100644
index 0000000000..ab4194657b
--- /dev/null
+++ b/tests/test_vsets.py
@@ -0,0 +1,856 @@
+import json
+import random
+import numpy as np
+import pytest
+import redis
+from redis.commands.vectorset.commands import QuantizationOptions
+
+from .conftest import (
+    _get_client,
+    skip_if_server_version_lt,
+)
+
+
+@pytest.fixture
+def d_client(request):
+    r = _get_client(redis.Redis, request, decode_responses=True)
+
+    r.flushdb()
+    return r
+
+
+@pytest.fixture
+def client(request):
+    r = _get_client(redis.Redis, request, decode_responses=False)
+
+    r.flushdb()
+    return r
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_add_elem_with_values(d_client):
+    float_array = [1, 4.32, 0.11]
+    resp = d_client.vset().vadd("myset", float_array, "elem1")
+    assert resp == 1
+
+    emb = d_client.vset().vemb("myset", "elem1")
+    assert _validate_quantization(float_array, emb, tolerance=0.1)
+
+    with pytest.raises(redis.DataError):
+        d_client.vset().vadd("myset_invalid_data", None, "elem1")
+
+    with pytest.raises(redis.DataError):
+        d_client.vset().vadd("myset_invalid_data", [12, 45], None, reduce_dim=3)
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_add_elem_with_vector(d_client):
+    float_array = [1, 4.32, 0.11]
+    # Convert the list of floats to a byte array in fp32 format
+    byte_array = _to_fp32_blob_array(float_array)
+    resp = d_client.vset().vadd("myset", byte_array, "elem1")
+    assert resp == 1
+
+    emb = d_client.vset().vemb("myset", "elem1")
+    assert _validate_quantization(float_array, emb, tolerance=0.1)
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_add_elem_reduced_dim(d_client):
+    float_array = [1, 4.32, 0.11, 0.5, 0.9]
+    resp = d_client.vset().vadd("myset", float_array, "elem1", reduce_dim=3)
+    assert resp == 1
+
+    dim = d_client.vset().vdim("myset")
+    assert dim == 3
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_add_elem_cas(d_client):
+    float_array = [1, 4.32, 0.11, 0.5, 0.9]
+    resp = d_client.vset().vadd("myset", vector=float_array, element="elem1", cas=True)
+    assert resp == 1
+
+    emb = d_client.vset().vemb("myset", "elem1")
+    assert _validate_quantization(float_array, emb, tolerance=0.1)
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_add_elem_no_quant(d_client):
+    float_array = [1, 4.32, 0.11, 0.5, 0.9]
+    resp = d_client.vset().vadd(
+        "myset",
+        vector=float_array,
+        element="elem1",
+        quantization=QuantizationOptions.NOQUANT,
+    )
+    assert resp == 1
+
+    emb = d_client.vset().vemb("myset", "elem1")
+    assert _validate_quantization(float_array, emb, tolerance=0.0)
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_add_elem_bin_quant(d_client):
+    float_array = [1, 4.32, 0.0, 0.05, -2.9]
+    resp = d_client.vset().vadd(
+        "myset",
+        vector=float_array,
+        element="elem1",
+        quantization=QuantizationOptions.BIN,
+    )
+    assert resp == 1
+
+    emb = d_client.vset().vemb("myset", "elem1")
+    expected_array = [1, 1, -1, 1, -1]
+    assert _validate_quantization(expected_array, emb, tolerance=0.0)
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_add_elem_q8_quant(d_client):
+    float_array = [1, 4.32, 10.0, -21, -2.9]
+    resp = d_client.vset().vadd(
+        "myset",
+        vector=float_array,
+        element="elem1",
+        quantization=QuantizationOptions.BIN,
+    )
+    assert resp == 1
+
+    emb = d_client.vset().vemb("myset", "elem1")
+    expected_array = [1, 1, 1, -1, -1]
+    assert _validate_quantization(expected_array, emb, tolerance=0.0)
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_add_elem_ef(d_client):
+    d_client.vset().vadd("myset", vector=[5, 55, 65, -20, 30], element="elem1")
+    d_client.vset().vadd("myset", vector=[-40, -40.32, 10.0, -4, 2.9], element="elem2")
+
+    float_array = [1, 4.32, 10.0, -21, -2.9]
+    resp = d_client.vset().vadd("myset", float_array, "elem3", ef=1)
+    assert resp == 1
+
+    emb = d_client.vset().vemb("myset", "elem3")
+    assert _validate_quantization(float_array, emb, tolerance=0.1)
+
+    sim = d_client.vset().vsim("myset", input="elem3", with_scores=True)
+    assert len(sim) == 3
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_add_elem_with_attr(d_client):
+    float_array = [1, 4.32, 10.0, -21, -2.9]
+    attrs_dict = {"key1": "value1", "key2": "value2"}
+    resp = d_client.vset().vadd(
+        "myset",
+        vector=float_array,
+        element="elem3",
+        attributes=attrs_dict,
+    )
+    assert resp == 1
+
+    emb = d_client.vset().vemb("myset", "elem3")
+    assert _validate_quantization(float_array, emb, tolerance=0.1)
+
+    attr_saved = d_client.vset().vgetattr("myset", "elem3")
+    assert attr_saved == attrs_dict
+
+    resp = d_client.vset().vadd(
+        "myset",
+        vector=float_array,
+        element="elem4",
+        attributes={},
+    )
+    assert resp == 1
+
+    emb = d_client.vset().vemb("myset", "elem4")
+    assert _validate_quantization(float_array, emb, tolerance=0.1)
+
+    attr_saved = d_client.vset().vgetattr("myset", "elem4")
+    assert attr_saved is None
+
+    resp = d_client.vset().vadd(
+        "myset",
+        vector=float_array,
+        element="elem5",
+        attributes=json.dumps(attrs_dict),
+    )
+    assert resp == 1
+
+    emb = d_client.vset().vemb("myset", "elem5")
+    assert _validate_quantization(float_array, emb, tolerance=0.1)
+
+    attr_saved = d_client.vset().vgetattr("myset", "elem5")
+    assert attr_saved == attrs_dict
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_add_elem_with_numlinks(d_client):
+    elements_count = 100
+    vector_dim = 10
+    for i in range(elements_count):
+        float_array = [random.randint(0, 10) for x in range(vector_dim)]
+        d_client.vset().vadd(
+            "myset",
+            float_array,
+            f"elem{i}",
+            numlinks=8,
+        )
+
+    float_array = [1, 4.32, 0.11, 0.5, 0.9, 0.1, 0.2, 0.3, 0.4, 0.5]
+    resp = d_client.vset().vadd("myset", float_array, "elem_numlinks", numlinks=8)
+    assert resp == 1
+
+    emb = d_client.vset().vemb("myset", "elem_numlinks")
+    assert _validate_quantization(float_array, emb, tolerance=0.5)
+
+    numlinks_all_layers = d_client.vset().vlinks("myset", "elem_numlinks")
+    for neighbours_list_for_layer in numlinks_all_layers:
+        assert len(neighbours_list_for_layer) <= 8
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_vsim_count(d_client):
+    elements_count = 30
+    vector_dim = 800
+    for i in range(elements_count):
+        float_array = [random.uniform(0, 10) for x in range(vector_dim)]
+        d_client.vset().vadd(
+            "myset",
+            float_array,
+            f"elem{i}",
+            numlinks=64,
+        )
+
+    vsim = d_client.vset().vsim("myset", input="elem1")
+    assert len(vsim) == 10
+    assert isinstance(vsim, list)
+    assert isinstance(vsim[0], str)
+
+    vsim = d_client.vset().vsim("myset", input="elem1", count=5)
+    assert len(vsim) == 5
+    assert isinstance(vsim, list)
+    assert isinstance(vsim[0], str)
+
+    vsim = d_client.vset().vsim("myset", input="elem1", count=50)
+    assert len(vsim) == 30
+    assert isinstance(vsim, list)
+    assert isinstance(vsim[0], str)
+
+    vsim = d_client.vset().vsim("myset", input="elem1", count=15)
+    assert len(vsim) == 15
+    assert isinstance(vsim, list)
+    assert isinstance(vsim[0], str)
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_vsim_with_scores(d_client):
+    elements_count = 20
+    vector_dim = 50
+    for i in range(elements_count):
+        float_array = [random.uniform(0, 10) for x in range(vector_dim)]
+        d_client.vset().vadd(
+            "myset",
+            float_array,
+            f"elem{i}",
+            numlinks=64,
+        )
+
+    vsim = d_client.vset().vsim("myset", input="elem1", with_scores=True)
+    assert len(vsim) == 10
+    assert isinstance(vsim, dict)
+    assert isinstance(vsim["elem1"], float)
+    assert 0 <= vsim["elem1"] <= 1
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_vsim_with_different_vector_input_types(d_client):
+    elements_count = 10
+    vector_dim = 5
+    for i in range(elements_count):
+        float_array = [random.uniform(0, 10) for x in range(vector_dim)]
+        attributes = {"index": i, "elem_name": f"elem_{i}"}
+        d_client.vset().vadd(
+            "myset",
+            float_array,
+            f"elem_{i}",
+            numlinks=4,
+            attributes=attributes,
+        )
+    sim = d_client.vset().vsim("myset", input="elem_1")
+    assert len(sim) == 10
+    assert isinstance(sim, list)
+
+    float_array = [1, 4.32, 0.0, 0.05, -2.9]
+    sim_to_float_array = d_client.vset().vsim("myset", input=float_array)
+    assert len(sim_to_float_array) == 10
+    assert isinstance(sim_to_float_array, list)
+
+    fp32_vector = _to_fp32_blob_array(float_array)
+    sim_to_fp32_vector = d_client.vset().vsim("myset", input=fp32_vector)
+    assert len(sim_to_fp32_vector) == 10
+    assert isinstance(sim_to_fp32_vector, list)
+    assert sim_to_float_array == sim_to_fp32_vector
+
+    with pytest.raises(redis.DataError):
+        d_client.vset().vsim("myset", input=None)
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_vsim_unexisting(d_client):
+    float_array = [1, 4.32, 0.11, 0.5, 0.9]
+    d_client.vset().vadd("myset", vector=float_array, element="elem1", cas=True)
+
+    with pytest.raises(redis.ResponseError):
+        d_client.vset().vsim("myset", input="elem_not_existing")
+
+    sim = d_client.vset().vsim("myset_not_existing", input="elem1")
+    assert sim == []
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_vsim_with_filter(d_client):
+    elements_count = 30
+    vector_dim = 800
+    for i in range(elements_count):
+        float_array = [random.uniform(0, 10) for x in range(vector_dim)]
+        attributes = {"index": i, "elem_name": f"elem_{i}"}
+        d_client.vset().vadd(
+            "myset",
+            float_array,
+            f"elem_{i}",
+            numlinks=4,
+            attributes=attributes,
+        )
+    sim = d_client.vset().vsim("myset", input="elem_1", filter=".index > 10")
+    assert len(sim) == 10
+    assert isinstance(sim, list)
+    for elem in sim:
+        assert int(elem.split("_")[1]) > 10
+
+    sim = d_client.vset().vsim(
+        "myset",
+        input="elem_1",
+        filter=".index > 10 and .index < 15 and .elem_name in ['elem_12', 'elem_17']",
+    )
+    assert len(sim) == 1
+    assert isinstance(sim, list)
+    assert sim[0] == "elem_12"
+
+    sim = d_client.vset().vsim(
+        "myset",
+        input="elem_1",
+        filter=".index > 25 and .elem_name in ['elem_12', 'elem_17', 'elem_19']",
+        ef=100,
+    )
+    assert len(sim) == 0
+    assert isinstance(sim, list)
+
+    sim = d_client.vset().vsim(
+        "myset",
+        input="elem_1",
+        filter=".index > 28 and .elem_name in ['elem_12', 'elem_17', 'elem_29']",
+        filter_ef=1,
+    )
+    assert len(sim) == 0
+    assert isinstance(sim, list)
+
+    sim = d_client.vset().vsim(
+        "myset",
+        input="elem_1",
+        filter=".index > 28 and .elem_name in ['elem_12', 'elem_17', 'elem_29']",
+        filter_ef=20,
+    )
+    assert len(sim) == 1
+    assert isinstance(sim, list)
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_vsim_truth_no_thread_enabled(d_client):
+    elements_count = 5000
+    vector_dim = 30
+    for i in range(1, elements_count + 1):
+        float_array = [random.uniform(10 * i, 1000 * i) for x in range(vector_dim)]
+        d_client.vset().vadd("myset", float_array, f"elem_{i}")
+
+    d_client.vset().vadd("myset", [-22 for _ in range(vector_dim)], "elem_man_2")
+
+    sim_without_truth = d_client.vset().vsim(
+        "myset", input="elem_man_2", with_scores=True
+    )
+    sim_truth = d_client.vset().vsim(
+        "myset", input="elem_man_2", with_scores=True, truth=True
+    )
+
+    assert len(sim_without_truth) == 10
+    assert len(sim_truth) == 10
+
+    assert isinstance(sim_without_truth, dict)
+    assert isinstance(sim_truth, dict)
+
+    results_scores = list(
+        zip(
+            [v for _, v in sim_truth.items()], [v for _, v in sim_without_truth.items()]
+        )
+    )
+
+    found_better_match = False
+    for index, (score_with_truth, score_without_truth) in enumerate(results_scores):
+        if score_with_truth < score_without_truth:
+            assert False, (
+                "Score with truth [{score_with_truth}] < score without truth [{score_without_truth}]"
+            )
+        elif score_with_truth > score_without_truth:
+            found_better_match = True
+
+    assert found_better_match
+
+    sim_no_thread = d_client.vset().vsim(
+        "myset", input="elem_man_2", with_scores=True, no_thread=True
+    )
+
+    assert len(sim_no_thread) == 10
+    assert isinstance(sim_no_thread, dict)
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_vdim(d_client):
+    float_array = [1, 4.32, 0.11, 0.5, 0.9, 0.1, 0.2]
+    d_client.vset().vadd("myset", float_array, "elem1")
+
+    dim = d_client.vset().vdim("myset")
+    assert dim == len(float_array)
+
+    d_client.vset().vadd("myset_reduced", float_array, "elem1", reduce_dim=4)
+    reduced_dim = d_client.vset().vdim("myset_reduced")
+    assert reduced_dim == 4
+
+    with pytest.raises(redis.ResponseError):
+        d_client.vset().vdim("myset_unexisting")
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_vcard(d_client):
+    n = 20
+    for i in range(n):
+        float_array = [random.uniform(0, 10) for x in range(1, 8)]
+        d_client.vset().vadd("myset", float_array, f"elem{i}")
+
+    card = d_client.vset().vcard("myset")
+    assert card == n
+
+    with pytest.raises(redis.ResponseError):
+        d_client.vset().vdim("myset_unexisting")
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_vrem(d_client):
+    n = 3
+    for i in range(n):
+        float_array = [random.uniform(0, 10) for x in range(1, 8)]
+        d_client.vset().vadd("myset", float_array, f"elem{i}")
+
+    resp = d_client.vset().vrem("myset", "elem2")
+    assert resp == 1
+
+    card = d_client.vset().vcard("myset")
+    assert card == n - 1
+
+    resp = d_client.vset().vrem("myset", "elem2")
+    assert resp == 0
+
+    card = d_client.vset().vcard("myset")
+    assert card == n - 1
+
+    resp = d_client.vset().vrem("myset_unexisting", "elem1")
+    assert resp == 0
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_vemb_bin_quantization(d_client):
+    e = [1, 4.32, 0.0, 0.05, -2.9]
+    d_client.vset().vadd(
+        "myset",
+        e,
+        "elem",
+        quantization=QuantizationOptions.BIN,
+    )
+    emb_no_quant = d_client.vset().vemb("myset", "elem")
+    assert emb_no_quant == [1, 1, -1, 1, -1]
+
+    emb_no_quant_raw = d_client.vset().vemb("myset", "elem", raw=True)
+    assert emb_no_quant_raw["quantization"] == "bin"
+    assert isinstance(emb_no_quant_raw["raw"], bytes)
+    assert isinstance(emb_no_quant_raw["l2"], float)
+    assert "range" not in emb_no_quant_raw
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_vemb_q8_quantization(d_client):
+    e = [1, 10.32, 0.0, 2.05, -12.5]
+    d_client.vset().vadd("myset", e, "elem", quantization=QuantizationOptions.Q8)
+
+    emb_q8_quant = d_client.vset().vemb("myset", "elem")
+    assert _validate_quantization(e, emb_q8_quant, tolerance=0.1)
+
+    emb_q8_quant_raw = d_client.vset().vemb("myset", "elem", raw=True)
+    assert emb_q8_quant_raw["quantization"] == "int8"
+    assert isinstance(emb_q8_quant_raw["raw"], bytes)
+    assert isinstance(emb_q8_quant_raw["l2"], float)
+    assert isinstance(emb_q8_quant_raw["range"], float)
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_vemb_no_quantization(d_client):
+    e = [1, 10.32, 0.0, 2.05, -12.5]
+    d_client.vset().vadd("myset", e, "elem", quantization=QuantizationOptions.NOQUANT)
+
+    emb_no_quant = d_client.vset().vemb("myset", "elem")
+    assert _validate_quantization(e, emb_no_quant, tolerance=0.1)
+
+    emb_no_quant_raw = d_client.vset().vemb("myset", "elem", raw=True)
+    assert emb_no_quant_raw["quantization"] == "f32"
+    assert isinstance(emb_no_quant_raw["raw"], bytes)
+    assert isinstance(emb_no_quant_raw["l2"], float)
+    assert "range" not in emb_no_quant_raw
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_vemb_default_quantization(d_client):
+    e = [1, 5.32, 0.0, 0.25, -5]
+    d_client.vset().vadd("myset", vector=e, element="elem")
+
+    emb_default_quant = d_client.vset().vemb("myset", "elem")
+    assert _validate_quantization(e, emb_default_quant, tolerance=0.1)
+
+    emb_default_quant_raw = d_client.vset().vemb("myset", "elem", raw=True)
+    assert emb_default_quant_raw["quantization"] == "int8"
+    assert isinstance(emb_default_quant_raw["raw"], bytes)
+    assert isinstance(emb_default_quant_raw["l2"], float)
+    assert isinstance(emb_default_quant_raw["range"], float)
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_vemb_fp32_quantization(d_client):
+    float_array_fp32 = [1, 4.32, 0.11]
+    # Convert the list of floats to a byte array in fp32 format
+    byte_array = _to_fp32_blob_array(float_array_fp32)
+    d_client.vset().vadd("myset", byte_array, "elem")
+
+    emb_fp32_quant = d_client.vset().vemb("myset", "elem")
+    assert _validate_quantization(float_array_fp32, emb_fp32_quant, tolerance=0.1)
+
+    emb_fp32_quant_raw = d_client.vset().vemb("myset", "elem", raw=True)
+    assert emb_fp32_quant_raw["quantization"] == "int8"
+    assert isinstance(emb_fp32_quant_raw["raw"], bytes)
+    assert isinstance(emb_fp32_quant_raw["l2"], float)
+    assert isinstance(emb_fp32_quant_raw["range"], float)
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_vemb_unexisting(d_client):
+    emb_not_existing = d_client.vset().vemb("not_existing", "elem")
+    assert emb_not_existing is None
+
+    e = [1, 5.32, 0.0, 0.25, -5]
+    d_client.vset().vadd("myset", vector=e, element="elem")
+    emb_elem_not_existing = d_client.vset().vemb("myset", "not_existing")
+    assert emb_elem_not_existing is None
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_vlinks(d_client):
+    elements_count = 100
+    vector_dim = 800
+    for i in range(elements_count):
+        float_array = [random.uniform(0, 10) for x in range(vector_dim)]
+        d_client.vset().vadd(
+            "myset",
+            float_array,
+            f"elem{i}",
+            numlinks=8,
+        )
+
+    element_links_all_layers = d_client.vset().vlinks("myset", "elem1")
+    assert len(element_links_all_layers) >= 1
+    for neighbours_list_for_layer in element_links_all_layers:
+        assert isinstance(neighbours_list_for_layer, list)
+        for neighbour in neighbours_list_for_layer:
+            assert isinstance(neighbour, str)
+
+    elem_links_all_layers_with_scores = d_client.vset().vlinks(
+        "myset", "elem1", with_scores=True
+    )
+    assert len(elem_links_all_layers_with_scores) >= 1
+    for neighbours_dict_for_layer in elem_links_all_layers_with_scores:
+        assert isinstance(neighbours_dict_for_layer, dict)
+        for neighbour_key, score_value in neighbours_dict_for_layer.items():
+            assert isinstance(neighbour_key, str)
+            assert isinstance(score_value, float)
+
+    float_array = [0.75, 0.25, 0.5, 0.1, 0.9]
+    d_client.vset().vadd("myset_one_elem_only", float_array, "elem1")
+    elem_no_neighbours_with_scores = d_client.vset().vlinks(
+        "myset_one_elem_only", "elem1", with_scores=True
+    )
+    assert len(elem_no_neighbours_with_scores) >= 1
+    for neighbours_dict_for_layer in elem_no_neighbours_with_scores:
+        assert isinstance(neighbours_dict_for_layer, dict)
+        assert len(neighbours_dict_for_layer) == 0
+
+    elem_no_neighbours_no_scores = d_client.vset().vlinks(
+        "myset_one_elem_only", "elem1"
+    )
+    assert len(elem_no_neighbours_no_scores) >= 1
+    for neighbours_list_for_layer in elem_no_neighbours_no_scores:
+        assert isinstance(neighbours_list_for_layer, list)
+        assert len(neighbours_list_for_layer) == 0
+
+    unexisting_element_links = d_client.vset().vlinks("myset", "unexisting_elem")
+    assert unexisting_element_links is None
+
+    unexisting_vset_links = d_client.vset().vlinks("myset_unexisting", "elem1")
+    assert unexisting_vset_links is None
+
+    unexisting_element_links = d_client.vset().vlinks(
+        "myset", "unexisting_elem", with_scores=True
+    )
+    assert unexisting_element_links is None
+
+    unexisting_vset_links = d_client.vset().vlinks(
+        "myset_unexisting", "elem1", with_scores=True
+    )
+    assert unexisting_vset_links is None
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_vinfo(d_client):
+    elements_count = 100
+    vector_dim = 800
+    for i in range(elements_count):
+        float_array = [random.uniform(0, 10) for x in range(vector_dim)]
+        d_client.vset().vadd(
+            "myset",
+            float_array,
+            f"elem{i}",
+            numlinks=8,
+            quantization=QuantizationOptions.BIN,
+        )
+
+    vset_info = d_client.vset().vinfo("myset")
+    assert vset_info["quant-type"] == "bin"
+    assert vset_info["vector-dim"] == vector_dim
+    assert vset_info["size"] == elements_count
+    assert vset_info["max-level"] > 0
+    assert vset_info["hnsw-max-node-uid"] == elements_count
+
+    unexisting_vset_info = d_client.vset().vinfo("myset_unexisting")
+    assert unexisting_vset_info is None
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_vset_vget_attributes(d_client):
+    float_array = [1, 4.32, 0.11]
+    attributes = {"key1": "value1", "key2": "value2"}
+
+    # validate vgetattrs when no attributes are set with vadd
+    resp = d_client.vset().vadd("myset", float_array, "elem1")
+    assert resp == 1
+
+    attrs = d_client.vset().vgetattr("myset", "elem1")
+    assert attrs is None
+
+    # validate vgetattrs when attributes are set with vadd
+    resp = d_client.vset().vadd(
+        "myset_with_attrs", float_array, "elem1", attributes=attributes
+    )
+    assert resp == 1
+
+    attrs = d_client.vset().vgetattr("myset_with_attrs", "elem1")
+    assert attrs == attributes
+
+    # Set attributes and get attributes
+    resp = d_client.vset().vsetattr("myset", "elem1", attributes)
+    assert resp == 1
+    attr_saved = d_client.vset().vgetattr("myset", "elem1")
+    assert attr_saved == attributes
+
+    # Set attributes to None
+    resp = d_client.vset().vsetattr("myset", "elem1", None)
+    assert resp == 1
+    attr_saved = d_client.vset().vgetattr("myset", "elem1")
+    assert attr_saved is None
+
+    # Set attributes to empty dict
+    resp = d_client.vset().vsetattr("myset", "elem1", {})
+    assert resp == 1
+    attr_saved = d_client.vset().vgetattr("myset", "elem1")
+    assert attr_saved is None
+
+    # Set attributes provided as string
+    resp = d_client.vset().vsetattr("myset", "elem1", json.dumps(attributes))
+    assert resp == 1
+    attr_saved = d_client.vset().vgetattr("myset", "elem1")
+    assert attr_saved == attributes
+
+    # Set attributes to unexisting element
+    resp = d_client.vset().vsetattr("myset", "elem2", attributes)
+    assert resp == 0
+    attr_saved = d_client.vset().vgetattr("myset", "elem2")
+    assert attr_saved is None
+
+    # Set attributes to unexisting vset
+    resp = d_client.vset().vsetattr("myset_unexisting", "elem1", attributes)
+    assert resp == 0
+    attr_saved = d_client.vset().vgetattr("myset_unexisting", "elem1")
+    assert attr_saved is None
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_vrandmember(d_client):
+    elements = ["elem1", "elem2", "elem3"]
+    for elem in elements:
+        float_array = [random.uniform(0, 10) for x in range(1, 8)]
+        d_client.vset().vadd("myset", float_array, element=elem)
+
+    random_member = d_client.vset().vrandmember("myset")
+    assert random_member in elements
+
+    members_list = d_client.vset().vrandmember("myset", count=2)
+    assert len(members_list) == 2
+    assert all(member in elements for member in members_list)
+
+    # Test with count greater than the number of elements
+    members_list = d_client.vset().vrandmember("myset", count=10)
+    assert len(members_list) == len(elements)
+    assert all(member in elements for member in members_list)
+
+    # Test with negative count
+    members_list = d_client.vset().vrandmember("myset", count=-2)
+    assert len(members_list) == 2
+    assert all(member in elements for member in members_list)
+
+    # Test with count equal to the number of elements
+    members_list = d_client.vset().vrandmember("myset", count=len(elements))
+    assert len(members_list) == len(elements)
+    assert all(member in elements for member in members_list)
+
+    # Test with count equal to 0
+    members_list = d_client.vset().vrandmember("myset", count=0)
+    assert members_list == []
+
+    # Test with count equal to 1
+    members_list = d_client.vset().vrandmember("myset", count=1)
+    assert len(members_list) == 1
+    assert members_list[0] in elements
+
+    # Test with count equal to -1
+    members_list = d_client.vset().vrandmember("myset", count=-1)
+    assert len(members_list) == 1
+    assert members_list[0] in elements
+
+    # Test with unexisting vset & without count
+    members_list = d_client.vset().vrandmember("myset_unexisting")
+    assert members_list is None
+
+    # Test with unexisting vset & count
+    members_list = d_client.vset().vrandmember("myset_unexisting", count=5)
+    assert members_list == []
+
+
+@skip_if_server_version_lt("7.9.0")
+def test_vset_commands_without_decoding_responces(client):
+    # test vadd
+    elements = ["elem1", "elem2", "elem3"]
+    for elem in elements:
+        float_array = [random.uniform(0, 10) for x in range(0, 8)]
+        resp = client.vset().vadd("myset", float_array, element=elem)
+        assert resp == 1
+
+    # test vemb
+    emb = client.vset().vemb("myset", "elem1")
+    assert len(emb) == 8
+    assert isinstance(emb, list)
+    assert all(isinstance(x, float) for x in emb)
+
+    emb_raw = client.vset().vemb("myset", "elem1", raw=True)
+    assert emb_raw["quantization"] == b"int8"
+    assert isinstance(emb_raw["raw"], bytes)
+    assert isinstance(emb_raw["l2"], float)
+    assert isinstance(emb_raw["range"], float)
+
+    # test vsim
+    vsim = client.vset().vsim("myset", input="elem1")
+    assert len(vsim) == 3
+    assert isinstance(vsim, list)
+    assert isinstance(vsim[0], bytes)
+
+    # test vsim with scores
+    vsim_with_scores = client.vset().vsim("myset", input="elem1", with_scores=True)
+    assert len(vsim_with_scores) == 3
+    assert isinstance(vsim_with_scores, dict)
+    assert isinstance(vsim_with_scores[b"elem1"], float)
+
+    # test vlinks - no scores
+    element_links_all_layers = client.vset().vlinks("myset", "elem1")
+    assert len(element_links_all_layers) >= 1
+    for neighbours_list_for_layer in element_links_all_layers:
+        assert isinstance(neighbours_list_for_layer, list)
+        for neighbour in neighbours_list_for_layer:
+            assert isinstance(neighbour, bytes)
+    # test vlinks with scores
+    elem_links_all_layers_with_scores = client.vset().vlinks(
+        "myset", "elem1", with_scores=True
+    )
+    assert len(elem_links_all_layers_with_scores) >= 1
+    for neighbours_dict_for_layer in elem_links_all_layers_with_scores:
+        assert isinstance(neighbours_dict_for_layer, dict)
+        for neighbour_key, score_value in neighbours_dict_for_layer.items():
+            assert isinstance(neighbour_key, bytes)
+            assert isinstance(score_value, float)
+
+    # test vinfo
+    vset_info = client.vset().vinfo("myset")
+    assert vset_info[b"quant-type"] == b"int8"
+    assert vset_info[b"vector-dim"] == 8
+    assert vset_info[b"size"] == len(elements)
+    assert vset_info[b"max-level"] >= 0
+    assert vset_info[b"hnsw-max-node-uid"] == len(elements)
+
+    # test vgetattr
+    attributes = {"key1": "value1", "key2": "value2"}
+    client.vset().vsetattr("myset", "elem1", attributes)
+    attrs = client.vset().vgetattr("myset", "elem1")
+    assert attrs == attributes
+
+    # test vrandmember
+    random_member = client.vset().vrandmember("myset")
+    assert isinstance(random_member, bytes)
+    assert random_member.decode("utf-8") in elements
+
+    members_list = client.vset().vrandmember("myset", count=2)
+    assert len(members_list) == 2
+    assert all(member.decode("utf-8") in elements for member in members_list)
+
+
+def _to_fp32_blob_array(float_array):
+    """
+    Convert a list of floats to a byte array in fp32 format.
+    """
+    # Convert the list of floats to a NumPy array with dtype np.float32
+    arr = np.array(float_array, dtype=np.float32)
+    # Convert the NumPy array to a byte array
+    byte_array = arr.tobytes()
+    return byte_array
+
+
+def _validate_quantization(original, quantized, tolerance=0.1):
+    original = np.array(original, dtype=np.float32)
+    quantized = np.array(quantized, dtype=np.float32)
+
+    max_diff = np.max(np.abs(original - quantized))
+    if max_diff > tolerance:
+        return False
+    else:
+        return True

From f13456b84b6b8ac6773e08b884115f384a76a6f4 Mon Sep 17 00:00:00 2001
From: andy-stark-redis <164213578+andy-stark-redis@users.noreply.github.com>
Date: Wed, 9 Apr 2025 14:12:54 +0100
Subject: [PATCH 1029/1164] DOC-5073 added examples for vector sets intro page
 (#3590)

---
 doctests/dt_vec_set.py | 210 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 210 insertions(+)
 create mode 100644 doctests/dt_vec_set.py

diff --git a/doctests/dt_vec_set.py b/doctests/dt_vec_set.py
new file mode 100644
index 0000000000..398171a04c
--- /dev/null
+++ b/doctests/dt_vec_set.py
@@ -0,0 +1,210 @@
+# EXAMPLE: vecset_tutorial
+# HIDE_START
+"""
+Code samples for Vector set doc pages:
+    https://redis.io/docs/latest/develop/data-types/vector-sets/
+"""
+
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+
+# REMOVE_START
+r.delete("points")
+# REMOVE_END
+
+# STEP_START vadd
+res1 = r.vset().vadd("points", [1.0, 1.0], "pt:A")
+print(res1)  # >>> 1
+
+res2 = r.vset().vadd("points", [-1.0, -1.0], "pt:B")
+print(res2)  # >>> 1
+
+res3 = r.vset().vadd("points", [-1.0, 1.0], "pt:C")
+print(res3)  # >>> 1
+
+res4 = r.vset().vadd("points", [1.0, -1.0], "pt:D")
+print(res4)  # >>> 1
+
+res5 = r.vset().vadd("points", [1.0, 0], "pt:E")
+print(res5)  # >>> 1
+
+res6 = r.type("points")
+print(res6)  # >>> vectorset
+# STEP_END
+# REMOVE_START
+assert res1 == 1
+assert res2 == 1
+assert res3 == 1
+assert res4 == 1
+assert res5 == 1
+
+assert res6 == "vectorset"
+# REMOVE_END
+
+# STEP_START vcardvdim
+res7 = r.vset().vcard("points")
+print(res7)  # >>> 5
+
+res8 = r.vset().vdim("points")
+print(res8)  # >>> 2
+# STEP_END
+# REMOVE_START
+assert res7 == 5
+assert res8 == 2
+# REMOVE_END
+
+# STEP_START vemb
+res9 = r.vset().vemb("points", "pt:A")
+print(res9)  # >>> [0.9999999403953552, 0.9999999403953552]
+
+res10 = r.vset().vemb("points", "pt:B")
+print(res10)  # >>> [-0.9999999403953552, -0.9999999403953552]
+
+res11 = r.vset().vemb("points", "pt:C")
+print(res11)  # >>> [-0.9999999403953552, 0.9999999403953552]
+
+res12 = r.vset().vemb("points", "pt:D")
+print(res12)  # >>> [0.9999999403953552, -0.9999999403953552]
+
+res13 = r.vset().vemb("points", "pt:E")
+print(res13)  # >>> [1, 0]
+# STEP_END
+# REMOVE_START
+assert 1 - res9[0] < 0.001
+assert 1 - res9[1] < 0.001
+assert 1 + res10[0] < 0.001
+assert 1 + res10[1] < 0.001
+assert 1 + res11[0] < 0.001
+assert 1 - res11[1] < 0.001
+assert 1 - res12[0] < 0.001
+assert 1 + res12[1] < 0.001
+assert res13 == [1, 0]
+# REMOVE_END
+
+# STEP_START attr
+res14 = r.vset().vsetattr("points", "pt:A", {
+    "name": "Point A",
+    "description": "First point added"
+})
+print(res14)  # >>> 1
+
+res15 = r.vset().vgetattr("points", "pt:A")
+print(res15)
+# >>> {'name': 'Point A', 'description': 'First point added'}
+
+res16 = r.vset().vsetattr("points", "pt:A", "")
+print(res16)  # >>> 1
+
+res17 = r.vset().vgetattr("points", "pt:A")
+print(res17)  # >>> None
+# STEP_END
+# REMOVE_START
+assert res14 == 1
+assert res15 == {"name": "Point A", "description": "First point added"}
+assert res16 == 1
+assert res17 is None
+# REMOVE_END
+
+# STEP_START vrem
+res18 = r.vset().vadd("points", [0, 0], "pt:F")
+print(res18)  # >>> 1
+
+res19 = r.vset().vcard("points")
+print(res19)  # >>> 6
+
+res20 = r.vset().vrem("points", "pt:F")
+print(res20)  # >>> 1
+
+res21 = r.vset().vcard("points")
+print(res21)  # >>> 5
+# STEP_END
+# REMOVE_START
+assert res18 == 1
+assert res19 == 6
+assert res20 == 1
+assert res21 == 5
+# REMOVE_END
+
+# STEP_START vsim_basic
+res22 = r.vset().vsim("points", [0.9, 0.1])
+print(res22)
+# >>> ['pt:E', 'pt:A', 'pt:D', 'pt:C', 'pt:B']
+# STEP_END
+# REMOVE_START
+assert res22 == ["pt:E", "pt:A", "pt:D", "pt:C", "pt:B"]
+# REMOVE_END
+
+# STEP_START vsim_options
+res23 = r.vset().vsim(
+    "points", "pt:A",
+    with_scores=True,
+    count=4
+)
+print(res23)
+# >>> {'pt:A': 1.0, 'pt:E': 0.8535534143447876, 'pt:D': 0.5, 'pt:C': 0.5}
+# STEP_END
+# REMOVE_START
+assert res23["pt:A"] == 1.0
+assert res23["pt:C"] == 0.5
+assert res23["pt:D"] == 0.5
+assert res23["pt:E"] - 0.85 < 0.005
+# REMOVE_END
+
+# STEP_START vsim_filter
+res24 = r.vset().vsetattr("points", "pt:A", {
+    "size": "large",
+    "price": 18.99
+})
+print(res24)  # >>> 1
+
+res25 = r.vset().vsetattr("points", "pt:B", {
+    "size": "large",
+    "price": 35.99
+})
+print(res25)  # >>> 1
+
+res26 = r.vset().vsetattr("points", "pt:C", {
+    "size": "large",
+    "price": 25.99
+})
+print(res26)  # >>> 1
+
+res27 = r.vset().vsetattr("points", "pt:D", {
+    "size": "small",
+    "price": 21.00
+})
+print(res27)  # >>> 1
+
+res28 = r.vset().vsetattr("points", "pt:E", {
+    "size": "small",
+    "price": 17.75
+})
+print(res28)  # >>> 1
+
+# Return elements in order of distance from point A whose
+# `size` attribute is `large`.
+res29 = r.vset().vsim(
+    "points", "pt:A",
+    filter='.size == "large"'
+)
+print(res29)  # >>> ['pt:A', 'pt:C', 'pt:B']
+
+# Return elements in order of distance from point A whose size is
+# `large` and whose price is greater than 20.00.
+res30 = r.vset().vsim(
+    "points", "pt:A",
+    filter='.size == "large" && .price > 20.00'
+)
+print(res30)  # >>> ['pt:C', 'pt:B']
+# STEP_END
+# REMOVE_START
+assert res24 == 1
+assert res25 == 1
+assert res26 == 1
+assert res27 == 1
+assert res28 == 1
+
+assert res30 == ['pt:C', 'pt:B']
+# REMOVE_END

From 04589d47d6f575e1ebcd2a0fe8ff85e02d42859b Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Wed, 9 Apr 2025 17:22:44 +0300
Subject: [PATCH 1030/1164] Fixing some sporadically failing tests - part 1
 (#3589)

---
 docker-compose.yml               |  4 ++--
 redis/_parsers/resp3.py          |  4 ++--
 tests/test_asyncio/test_lock.py  |  4 ++--
 tests/test_asyncio/test_vsets.py | 27 +++++++++++++++++++--------
 tests/test_vsets.py              | 31 +++++++++++++++++++++----------
 5 files changed, 46 insertions(+), 24 deletions(-)

diff --git a/docker-compose.yml b/docker-compose.yml
index 75292bbd03..6b544553cb 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,9 +1,9 @@
 ---
 x-client-libs-stack-image: &client-libs-stack-image
-  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_STACK_IMAGE_TAG:-8.0-M06-pre}"
+  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_STACK_IMAGE_TAG:-7.4.2}"
 
 x-client-libs-image: &client-libs-image
-  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_IMAGE_TAG:-8.0-M06-pre}"
+  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_IMAGE_TAG:-7.4.2}"
 
 services:
 
diff --git a/redis/_parsers/resp3.py b/redis/_parsers/resp3.py
index 281546430b..ce4c59fb5b 100644
--- a/redis/_parsers/resp3.py
+++ b/redis/_parsers/resp3.py
@@ -19,7 +19,7 @@ def __init__(self, socket_read_size):
 
     def handle_pubsub_push_response(self, response):
         logger = getLogger("push_response")
-        logger.info("Push response: " + str(response))
+        logger.debug("Push response: " + str(response))
         return response
 
     def read_response(self, disable_decoding=False, push_request=False):
@@ -150,7 +150,7 @@ def __init__(self, socket_read_size):
 
     async def handle_pubsub_push_response(self, response):
         logger = getLogger("push_response")
-        logger.info("Push response: " + str(response))
+        logger.debug("Push response: " + str(response))
         return response
 
     async def read_response(
diff --git a/tests/test_asyncio/test_lock.py b/tests/test_asyncio/test_lock.py
index be4270acdf..fff045a7f4 100644
--- a/tests/test_asyncio/test_lock.py
+++ b/tests/test_asyncio/test_lock.py
@@ -149,7 +149,7 @@ async def test_context_manager_not_raise_on_release_lock_error(self, r):
             async with self.get_lock(
                 r, "foo", timeout=0.1, raise_on_release_error=False
             ) as lock:
-                lock.release()
+                await lock.release()
         except LockError:
             pytest.fail("LockError should not have been raised")
 
@@ -157,7 +157,7 @@ async def test_context_manager_not_raise_on_release_lock_error(self, r):
             async with self.get_lock(
                 r, "foo", timeout=0.1, raise_on_release_error=True
             ) as lock:
-                lock.release()
+                await lock.release()
 
     async def test_high_sleep_small_blocking_timeout(self, r):
         lock1 = self.get_lock(r, "foo")
diff --git a/tests/test_asyncio/test_vsets.py b/tests/test_asyncio/test_vsets.py
index 9abc899066..4ae336acf8 100644
--- a/tests/test_asyncio/test_vsets.py
+++ b/tests/test_asyncio/test_vsets.py
@@ -309,7 +309,7 @@ async def test_vsim_unexisting(d_client):
 
 @skip_if_server_version_lt("7.9.0")
 async def test_vsim_with_filter(d_client):
-    elements_count = 30
+    elements_count = 50
     vector_dim = 800
     for i in range(elements_count):
         float_array = [random.uniform(0, 10) for x in range(vector_dim)]
@@ -321,6 +321,15 @@ async def test_vsim_with_filter(d_client):
             numlinks=4,
             attributes=attributes,
         )
+    float_array = [-random.uniform(10, 20) for x in range(vector_dim)]
+    attributes = {"index": elements_count, "elem_name": "elem_special"}
+    await d_client.vset().vadd(
+        "myset",
+        float_array,
+        "elem_special",
+        numlinks=4,
+        attributes=attributes,
+    )
     sim = await d_client.vset().vsim("myset", input="elem_1", filter=".index > 10")
     assert len(sim) == 10
     assert isinstance(sim, list)
@@ -348,17 +357,19 @@ async def test_vsim_with_filter(d_client):
     sim = await d_client.vset().vsim(
         "myset",
         input="elem_1",
-        filter=".index > 28 and .elem_name in ['elem_12', 'elem_17', 'elem_29']",
+        filter=".index > 28 and .elem_name in ['elem_12', 'elem_17', 'elem_special']",
         filter_ef=1,
     )
-    assert len(sim) == 0
+    assert len(sim) == 0, (
+        f"Expected 0 results, but got {len(sim)} with filter_ef=1, sim: {sim}"
+    )
     assert isinstance(sim, list)
 
     sim = await d_client.vset().vsim(
         "myset",
         input="elem_1",
-        filter=".index > 28 and .elem_name in ['elem_12', 'elem_17', 'elem_29']",
-        filter_ef=20,
+        filter=".index > 28 and .elem_name in ['elem_12', 'elem_17', 'elem_special']",
+        filter_ef=500,
     )
     assert len(sim) == 1
     assert isinstance(sim, list)
@@ -367,7 +378,7 @@ async def test_vsim_with_filter(d_client):
 @skip_if_server_version_lt("7.9.0")
 async def test_vsim_truth_no_thread_enabled(d_client):
     elements_count = 5000
-    vector_dim = 30
+    vector_dim = 50
     for i in range(1, elements_count + 1):
         float_array = [random.uniform(10 * i, 1000 * i) for x in range(vector_dim)]
         await d_client.vset().vadd("myset", float_array, f"elem_{i}")
@@ -394,7 +405,7 @@ async def test_vsim_truth_no_thread_enabled(d_client):
     )
 
     found_better_match = False
-    for index, (score_with_truth, score_without_truth) in enumerate(results_scores):
+    for score_with_truth, score_without_truth in results_scores:
         if score_with_truth < score_without_truth:
             assert False, (
                 "Score with truth [{score_with_truth}] < score without truth [{score_without_truth}]"
@@ -764,7 +775,7 @@ async def test_vset_commands_without_decoding_responces(client):
     # test vadd
     elements = ["elem1", "elem2", "elem3"]
     for elem in elements:
-        float_array = [random.uniform(0, 10) for x in range(0, 8)]
+        float_array = [random.uniform(0.5, 10) for x in range(0, 8)]
         resp = await client.vset().vadd("myset", float_array, element=elem)
         assert resp == 1
 
diff --git a/tests/test_vsets.py b/tests/test_vsets.py
index ab4194657b..4a9d95bc1f 100644
--- a/tests/test_vsets.py
+++ b/tests/test_vsets.py
@@ -311,10 +311,10 @@ def test_vsim_unexisting(d_client):
 
 @skip_if_server_version_lt("7.9.0")
 def test_vsim_with_filter(d_client):
-    elements_count = 30
+    elements_count = 50
     vector_dim = 800
     for i in range(elements_count):
-        float_array = [random.uniform(0, 10) for x in range(vector_dim)]
+        float_array = [random.uniform(10, 20) for x in range(vector_dim)]
         attributes = {"index": i, "elem_name": f"elem_{i}"}
         d_client.vset().vadd(
             "myset",
@@ -323,6 +323,15 @@ def test_vsim_with_filter(d_client):
             numlinks=4,
             attributes=attributes,
         )
+    float_array = [-random.uniform(10, 20) for x in range(vector_dim)]
+    attributes = {"index": elements_count, "elem_name": "elem_special"}
+    d_client.vset().vadd(
+        "myset",
+        float_array,
+        "elem_special",
+        numlinks=4,
+        attributes=attributes,
+    )
     sim = d_client.vset().vsim("myset", input="elem_1", filter=".index > 10")
     assert len(sim) == 10
     assert isinstance(sim, list)
@@ -350,17 +359,19 @@ def test_vsim_with_filter(d_client):
     sim = d_client.vset().vsim(
         "myset",
         input="elem_1",
-        filter=".index > 28 and .elem_name in ['elem_12', 'elem_17', 'elem_29']",
+        filter=".index > 28 and .elem_name in ['elem_12', 'elem_17', 'elem_special']",
         filter_ef=1,
     )
-    assert len(sim) == 0
+    assert len(sim) == 0, (
+        f"Expected 0 results, but got {len(sim)} with filter_ef=1, sim: {sim}"
+    )
     assert isinstance(sim, list)
 
     sim = d_client.vset().vsim(
         "myset",
         input="elem_1",
-        filter=".index > 28 and .elem_name in ['elem_12', 'elem_17', 'elem_29']",
-        filter_ef=20,
+        filter=".index > 28 and .elem_name in ['elem_12', 'elem_17', 'elem_special']",
+        filter_ef=500,
     )
     assert len(sim) == 1
     assert isinstance(sim, list)
@@ -369,7 +380,7 @@ def test_vsim_with_filter(d_client):
 @skip_if_server_version_lt("7.9.0")
 def test_vsim_truth_no_thread_enabled(d_client):
     elements_count = 5000
-    vector_dim = 30
+    vector_dim = 50
     for i in range(1, elements_count + 1):
         float_array = [random.uniform(10 * i, 1000 * i) for x in range(vector_dim)]
         d_client.vset().vadd("myset", float_array, f"elem_{i}")
@@ -396,7 +407,7 @@ def test_vsim_truth_no_thread_enabled(d_client):
     )
 
     found_better_match = False
-    for index, (score_with_truth, score_without_truth) in enumerate(results_scores):
+    for score_with_truth, score_without_truth in results_scores:
         if score_with_truth < score_without_truth:
             assert False, (
                 "Score with truth [{score_with_truth}] < score without truth [{score_without_truth}]"
@@ -764,7 +775,7 @@ def test_vset_commands_without_decoding_responces(client):
     # test vadd
     elements = ["elem1", "elem2", "elem3"]
     for elem in elements:
-        float_array = [random.uniform(0, 10) for x in range(0, 8)]
+        float_array = [random.uniform(0.5, 10) for x in range(0, 8)]
         resp = client.vset().vadd("myset", float_array, element=elem)
         assert resp == 1
 
@@ -772,7 +783,7 @@ def test_vset_commands_without_decoding_responces(client):
     emb = client.vset().vemb("myset", "elem1")
     assert len(emb) == 8
     assert isinstance(emb, list)
-    assert all(isinstance(x, float) for x in emb)
+    assert all(isinstance(x, float) for x in emb), f"Expected float values, got {emb}"
 
     emb_raw = client.vset().vemb("myset", "elem1", raw=True)
     assert emb_raw["quantization"] == b"int8"

From 4e59d24360c6d46c5f633c5e3cee09c48c38dc69 Mon Sep 17 00:00:00 2001
From: andy-stark-redis <164213578+andy-stark-redis@users.noreply.github.com>
Date: Mon, 14 Apr 2025 08:58:17 +0100
Subject: [PATCH 1031/1164] DOC-5073 vector set quantization and dimension
 reduction examples (#3597)

* DOC-5073 added example of quantization

* DOC-5073 added example of reduce option for vadd()
---
 doctests/dt_vec_set.py | 78 +++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 77 insertions(+), 1 deletion(-)

diff --git a/doctests/dt_vec_set.py b/doctests/dt_vec_set.py
index 398171a04c..687ad90593 100644
--- a/doctests/dt_vec_set.py
+++ b/doctests/dt_vec_set.py
@@ -7,11 +7,18 @@
 
 import redis
 
+from redis.commands.vectorset.commands import (
+    QuantizationOptions
+)
+
 r = redis.Redis(decode_responses=True)
 # HIDE_END
 
 # REMOVE_START
-r.delete("points")
+r.delete(
+    "points", "quantSetQ8", "quantSetNoQ",
+    "quantSetBin", "setNotReduced", "setReduced"
+)
 # REMOVE_END
 
 # STEP_START vadd
@@ -208,3 +215,72 @@
 
 assert res30 == ['pt:C', 'pt:B']
 # REMOVE_END
+
+# STEP_START add_quant
+# Import `QuantizationOptions` enum using:
+#
+# from redis.commands.vectorset.commands import (
+#   QuantizationOptions
+# )
+res31 = r.vset().vadd(
+    "quantSetQ8", [1.262185, 1.958231],
+    "quantElement",
+    quantization=QuantizationOptions.Q8
+)
+print(res31)  # >>> 1
+
+res32 = r.vset().vemb("quantSetQ8", "quantElement")
+print(f"Q8: {res32}")
+# >>> Q8: [1.2643694877624512, 1.958230972290039]
+
+res33 = r.vset().vadd(
+    "quantSetNoQ", [1.262185, 1.958231],
+    "quantElement",
+    quantization=QuantizationOptions.NOQUANT
+)
+print(res33)  # >>> 1
+
+res34 = r.vset().vemb("quantSetNoQ", "quantElement")
+print(f"NOQUANT: {res34}")
+# >>> NOQUANT: [1.262184977531433, 1.958230972290039]
+
+res35 = r.vset().vadd(
+    "quantSetBin", [1.262185, 1.958231],
+    "quantElement",
+    quantization=QuantizationOptions.BIN
+)
+print(res35)  # >>> 1
+
+res36 = r.vset().vemb("quantSetBin", "quantElement")
+print(f"BIN: {res36}")
+# >>> BIN: [1, 1]
+# STEP_END
+# REMOVE_START
+assert res31 == 1
+# REMOVE_END
+
+# STEP_START add_reduce
+# Create a list of 300 arbitrary values.
+values = [x / 299 for x in range(300)]
+
+res37 = r.vset().vadd(
+    "setNotReduced",
+    values,
+    "element"
+)
+print(res37)  # >>> 1
+
+res38 = r.vset().vdim("setNotReduced")
+print(res38)  # >>> 300
+
+res39 = r.vset().vadd(
+    "setReduced",
+    values,
+    "element",
+    reduce_dim=100
+)
+print(res39)  # >>> 1
+
+res40 = r.vset().vdim("setReduced")  # >>> 100
+print(res40)
+# STEP_END

From 950a46220d4ff4cdd2ab2ade543d5c1dbc90060b Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 17 Apr 2025 14:25:35 +0300
Subject: [PATCH 1032/1164] Removing 'charset' and 'errors' inputs from the
 Redis initialization arguments - deprecated 3 years ago. (#3608)

---
 docs/advanced_features.rst |  4 ++--
 redis/client.py            | 17 -----------------
 redis/cluster.py           |  2 --
 3 files changed, 2 insertions(+), 21 deletions(-)

diff --git a/docs/advanced_features.rst b/docs/advanced_features.rst
index 0ed3e1ff34..603e728e84 100644
--- a/docs/advanced_features.rst
+++ b/docs/advanced_features.rst
@@ -384,13 +384,13 @@ run_in_thread.
 
 A PubSub object adheres to the same encoding semantics as the client
 instance it was created from. Any channel or pattern that's unicode will
-be encoded using the charset specified on the client before being sent
+be encoded using the encoding specified on the client before being sent
 to Redis. If the client's decode_responses flag is set the False (the
 default), the 'channel', 'pattern' and 'data' values in message
 dictionaries will be byte strings (str on Python 2, bytes on Python 3).
 If the client's decode_responses is True, then the 'channel', 'pattern'
 and 'data' values will be automatically decoded to unicode strings using
-the client's charset.
+the client's encoding.
 
 PubSub objects remember what channels and patterns they are subscribed
 to. In the event of a disconnection such as a network error or timeout,
diff --git a/redis/client.py b/redis/client.py
index e9435d33ef..fda927507a 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -2,7 +2,6 @@
 import re
 import threading
 import time
-import warnings
 from itertools import chain
 from typing import (
     TYPE_CHECKING,
@@ -203,8 +202,6 @@ def __init__(
         unix_socket_path: Optional[str] = None,
         encoding: str = "utf-8",
         encoding_errors: str = "strict",
-        charset: Optional[str] = None,
-        errors: Optional[str] = None,
         decode_responses: bool = False,
         retry_on_timeout: bool = False,
         retry_on_error: Optional[List[Type[Exception]]] = None,
@@ -256,20 +253,6 @@ def __init__(
         else:
             self._event_dispatcher = event_dispatcher
         if not connection_pool:
-            if charset is not None:
-                warnings.warn(
-                    DeprecationWarning(
-                        '"charset" is deprecated. Use "encoding" instead'
-                    )
-                )
-                encoding = charset
-            if errors is not None:
-                warnings.warn(
-                    DeprecationWarning(
-                        '"errors" is deprecated. Use "encoding_errors" instead'
-                    )
-                )
-                encoding_errors = errors
             if not retry_on_error:
                 retry_on_error = []
             if retry_on_timeout is True:
diff --git a/redis/cluster.py b/redis/cluster.py
index 4ec03ac98f..39b454babe 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -142,7 +142,6 @@ def parse_cluster_myshardid(resp, **options):
 SLOT_ID = "slot-id"
 
 REDIS_ALLOWED_KEYS = (
-    "charset",
     "connection_class",
     "connection_pool",
     "connection_pool_class",
@@ -152,7 +151,6 @@ def parse_cluster_myshardid(resp, **options):
     "decode_responses",
     "encoding",
     "encoding_errors",
-    "errors",
     "host",
     "lib_name",
     "lib_version",

From 0c242404d790fbcca9252be21eb63182f2834e7d Mon Sep 17 00:00:00 2001
From: andy-stark-redis <164213578+andy-stark-redis@users.noreply.github.com>
Date: Wed, 23 Apr 2025 08:15:51 +0100
Subject: [PATCH 1033/1164] DOC-5107 added hash examples for index/query intro
 page (#3609)

* DOC-5107 added hash examples for index/query intro page

* DOC-5107 restored old index_definition import
---
 doctests/home_json.py         | 55 +++++++++++++++++++++++++++++++++--
 doctests/query_agg.py         |  2 +-
 doctests/query_combined.py    |  2 +-
 doctests/query_em.py          |  2 +-
 doctests/query_ft.py          |  2 +-
 doctests/query_geo.py         |  2 +-
 doctests/query_range.py       |  2 +-
 doctests/search_quickstart.py |  2 +-
 doctests/search_vss.py        |  2 +-
 9 files changed, 61 insertions(+), 10 deletions(-)

diff --git a/doctests/home_json.py b/doctests/home_json.py
index 922c83d2fe..794f844034 100644
--- a/doctests/home_json.py
+++ b/doctests/home_json.py
@@ -10,7 +10,7 @@
 import redis.commands.search.aggregation as aggregations
 import redis.commands.search.reducers as reducers
 from redis.commands.search.field import TextField, NumericField, TagField
-from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.index_definition import IndexDefinition, IndexType
 from redis.commands.search.query import Query
 import redis.exceptions
 # STEP_END
@@ -25,7 +25,12 @@
 except redis.exceptions.ResponseError:
     pass
 
-r.delete("user:1", "user:2", "user:3")
+try:
+    r.ft("hash-idx:users").dropindex(True)
+except redis.exceptions.ResponseError:
+    pass
+
+r.delete("user:1", "user:2", "user:3", "huser:1", "huser:2", "huser:3")
 # REMOVE_END
 # STEP_START create_data
 user1 = {
@@ -134,4 +139,50 @@
 )
 # REMOVE_END
 
+# STEP_START make_hash_index
+hashSchema = (
+    TextField("name"),
+    TagField("city"),
+    NumericField("age")
+)
+
+hashIndexCreated = r.ft("hash-idx:users").create_index(
+    hashSchema,
+    definition=IndexDefinition(
+        prefix=["huser:"], index_type=IndexType.HASH
+    )
+)
+# STEP_END
+# REMOVE_START
+assert hashIndexCreated
+# REMOVE_END
+
+# STEP_START add_hash_data
+huser1Set = r.hset("huser:1", mapping=user1)
+huser2Set = r.hset("huser:2", mapping=user2)
+huser3Set = r.hset("huser:3", mapping=user3)
+# STEP_END
+# REMOVE_START
+assert huser1Set
+assert huser2Set
+assert huser3Set
+# REMOVE_END
+
+# STEP_START query1_hash
+findPaulHashResult = r.ft("hash-idx:users").search(
+    Query("Paul @age:[30 40]")
+)
+
+print(findPaulHashResult)
+# >>> Result{1 total, docs: [Document {'id': 'huser:3',
+# >>>   'payload': None, 'name': 'Paul Zamir', ...
+# STEP_END
+# REMOVE_START
+assert str(findPaulHashResult) == (
+    "Result{1 total, docs: [Document " +
+    "{'id': 'huser:3', 'payload': None, 'name': 'Paul Zamir', " +
+    "'email': 'paul.zamir@example.com', 'age': '35', 'city': 'Tel Aviv'}]}"
+)
+# REMOVE_END
+
 r.close()
diff --git a/doctests/query_agg.py b/doctests/query_agg.py
index 4fa8f14b84..4d81ddbcda 100644
--- a/doctests/query_agg.py
+++ b/doctests/query_agg.py
@@ -6,7 +6,7 @@
 from redis.commands.search import Search
 from redis.commands.search.aggregation import AggregateRequest
 from redis.commands.search.field import NumericField, TagField
-from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.index_definition import IndexDefinition, IndexType
 import redis.commands.search.reducers as reducers
 
 r = redis.Redis(decode_responses=True)
diff --git a/doctests/query_combined.py b/doctests/query_combined.py
index a17f19417c..e6dd5a2cb5 100644
--- a/doctests/query_combined.py
+++ b/doctests/query_combined.py
@@ -6,7 +6,7 @@
 import warnings
 from redis.commands.json.path import Path
 from redis.commands.search.field import NumericField, TagField, TextField, VectorField
-from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.index_definition import IndexDefinition, IndexType
 from redis.commands.search.query import Query
 from sentence_transformers import  SentenceTransformer
 
diff --git a/doctests/query_em.py b/doctests/query_em.py
index a00ff11150..91cc5ae940 100644
--- a/doctests/query_em.py
+++ b/doctests/query_em.py
@@ -4,7 +4,7 @@
 import redis
 from redis.commands.json.path import Path
 from redis.commands.search.field import TextField, NumericField, TagField
-from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.index_definition import IndexDefinition, IndexType
 from redis.commands.search.query import NumericFilter, Query
 
 r = redis.Redis(decode_responses=True)
diff --git a/doctests/query_ft.py b/doctests/query_ft.py
index 182a5b2bd3..6272cdab25 100644
--- a/doctests/query_ft.py
+++ b/doctests/query_ft.py
@@ -5,7 +5,7 @@
 import redis
 from redis.commands.json.path import Path
 from redis.commands.search.field import TextField, NumericField, TagField
-from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.index_definition import IndexDefinition, IndexType
 from redis.commands.search.query import NumericFilter, Query
 
 r = redis.Redis(decode_responses=True)
diff --git a/doctests/query_geo.py b/doctests/query_geo.py
index dcb7db6ee7..ed8c9a5f99 100644
--- a/doctests/query_geo.py
+++ b/doctests/query_geo.py
@@ -5,7 +5,7 @@
 import redis
 from redis.commands.json.path import Path
 from redis.commands.search.field import GeoField, GeoShapeField
-from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.index_definition import IndexDefinition, IndexType
 from redis.commands.search.query import Query
 
 r = redis.Redis(decode_responses=True)
diff --git a/doctests/query_range.py b/doctests/query_range.py
index 4ef957acfb..674afc492a 100644
--- a/doctests/query_range.py
+++ b/doctests/query_range.py
@@ -5,7 +5,7 @@
 import redis
 from redis.commands.json.path import Path
 from redis.commands.search.field import TextField, NumericField, TagField
-from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.index_definition import IndexDefinition, IndexType
 from redis.commands.search.query import NumericFilter, Query
 
 r = redis.Redis(decode_responses=True)
diff --git a/doctests/search_quickstart.py b/doctests/search_quickstart.py
index e190393b16..cde4caa84a 100644
--- a/doctests/search_quickstart.py
+++ b/doctests/search_quickstart.py
@@ -10,7 +10,7 @@
 import redis.commands.search.reducers as reducers
 from redis.commands.json.path import Path
 from redis.commands.search.field import NumericField, TagField, TextField
-from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.index_definition import IndexDefinition, IndexType
 from redis.commands.search.query import Query
 
 # HIDE_END
diff --git a/doctests/search_vss.py b/doctests/search_vss.py
index 8b4884727a..a1132971db 100644
--- a/doctests/search_vss.py
+++ b/doctests/search_vss.py
@@ -20,7 +20,7 @@
     TextField,
     VectorField,
 )
-from redis.commands.search.indexDefinition import IndexDefinition, IndexType
+from redis.commands.search.index_definition import IndexDefinition, IndexType
 from redis.commands.search.query import Query
 from sentence_transformers import SentenceTransformer
 

From 77e8db2974d02638762ac91e464efe0b4aa37902 Mon Sep 17 00:00:00 2001
From: Elena Kolevska <elena-kolevska@users.noreply.github.com>
Date: Thu, 24 Apr 2025 14:48:37 +0100
Subject: [PATCH 1034/1164] Marks old RediSearch 1.0 commands as deprecated
 (#3606)

* Marks old RediSearch 1.0 commands as deprecated

* linters
---
 redis/commands/search/commands.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 42866f5ec1..bc48fa9aa8 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -23,7 +23,6 @@
 SEARCH_CMD = "FT.SEARCH"
 ADD_CMD = "FT.ADD"
 ADDHASH_CMD = "FT.ADDHASH"
-DROP_CMD = "FT.DROP"
 DROPINDEX_CMD = "FT.DROPINDEX"
 EXPLAIN_CMD = "FT.EXPLAIN"
 EXPLAINCLI_CMD = "FT.EXPLAINCLI"
@@ -35,7 +34,6 @@
 DICT_ADD_CMD = "FT.DICTADD"
 DICT_DEL_CMD = "FT.DICTDEL"
 DICT_DUMP_CMD = "FT.DICTDUMP"
-GET_CMD = "FT.GET"
 MGET_CMD = "FT.MGET"
 CONFIG_CMD = "FT.CONFIG"
 TAGVALS_CMD = "FT.TAGVALS"
@@ -406,6 +404,7 @@ def add_document_hash(self, doc_id, score=1.0, language=None, replace=False):
             doc_id, conn=None, score=score, language=language, replace=replace
         )
 
+    @deprecated_function(version="2.0.0", reason="deprecated since redisearch 2.0")
     def delete_document(self, doc_id, conn=None, delete_actual_document=False):
         """
         Delete a document from index
@@ -440,6 +439,7 @@ def load_document(self, id):
 
         return Document(id=id, **fields)
 
+    @deprecated_function(version="2.0.0", reason="deprecated since redisearch 2.0")
     def get(self, *ids):
         """
         Returns the full contents of multiple documents.

From fcc19d36b04cf2fe517760590db08481352ea479 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Mon, 28 Apr 2025 15:43:51 +0300
Subject: [PATCH 1035/1164] Fixing flaky tests - part 2 (#3592)

---
 tests/test_asyncio/test_search.py | 18 ++++++++++++------
 tests/test_cache.py               |  2 ++
 2 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 9a318796bf..2ee74f710f 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -1,14 +1,13 @@
 import bz2
 import csv
 import os
-import time
+import asyncio
 from io import TextIOWrapper
 
 import numpy as np
 import pytest
 import pytest_asyncio
 import redis.asyncio as redis
-import redis.commands.search
 import redis.commands.search.aggregation as aggregations
 import redis.commands.search.reducers as reducers
 from redis.commands.search import AsyncSearch
@@ -49,8 +48,8 @@ async def decoded_r(create_redis, stack_url):
 async def waitForIndex(env, idx, timeout=None):
     delay = 0.1
     while True:
-        res = await env.execute_command("FT.INFO", idx)
         try:
+            res = await env.execute_command("FT.INFO", idx)
             if int(res[res.index("indexing") + 1]) == 0:
                 break
         except ValueError:
@@ -62,7 +61,7 @@ async def waitForIndex(env, idx, timeout=None):
             except ValueError:
                 break
 
-        time.sleep(delay)
+        await asyncio.sleep(delay)
         if timeout is not None:
             timeout -= delay
             if timeout <= 0:
@@ -1765,7 +1764,7 @@ async def test_binary_and_text_fields(decoded_r: redis.Redis):
     mixed_data = {"first_name": "🐍python", "vector_emb": fake_vec.tobytes()}
     await decoded_r.hset(f"{index_name}:1", mapping=mixed_data)
 
-    schema = (
+    schema = [
         TagField("first_name"),
         VectorField(
             "embeddings_bio",
@@ -1776,7 +1775,7 @@ async def test_binary_and_text_fields(decoded_r: redis.Redis):
                 "DISTANCE_METRIC": "COSINE",
             },
         ),
-    )
+    ]
 
     await decoded_r.ft(index_name).create_index(
         fields=schema,
@@ -1784,6 +1783,7 @@ async def test_binary_and_text_fields(decoded_r: redis.Redis):
             prefix=[f"{index_name}:"], index_type=IndexType.HASH
         ),
     )
+    await waitForIndex(decoded_r, index_name)
 
     query = (
         Query("*")
@@ -1793,6 +1793,12 @@ async def test_binary_and_text_fields(decoded_r: redis.Redis):
     result = await decoded_r.ft(index_name).search(query=query, query_params={})
     docs = result.docs
 
+    if len(docs) == 0:
+        hash_content = await decoded_r.hget(f"{index_name}:1", "first_name")
+    assert len(docs) > 0, (
+        f"Returned search results are empty. Result: {result}; Hash: {hash_content}"
+    )
+
     decoded_vec_from_search_results = np.frombuffer(
         docs[0]["vector_emb"], dtype=np.float32
     )
diff --git a/tests/test_cache.py b/tests/test_cache.py
index 7010baff5f..a305d2de7b 100644
--- a/tests/test_cache.py
+++ b/tests/test_cache.py
@@ -2,6 +2,7 @@
 
 import pytest
 import redis
+
 from redis.cache import (
     CacheConfig,
     CacheEntry,
@@ -636,6 +637,7 @@ def test_get_from_default_cache(self, r, r2):
         ]
         # change key in redis (cause invalidation)
         r2.set("foo", "barbar")
+        time.sleep(0.1)
         # Retrieves a new value from server and cache_data it
         assert r.get("foo") in [b"barbar", "barbar"]
         # Make sure that new value was cached

From f32a1ca4f6d18ca2a48af6a9bf384c55ba733109 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Mon, 28 Apr 2025 18:22:55 +0300
Subject: [PATCH 1036/1164] Updating default retry strategy for standalone
 clients. 3 retries with ExponentialWithJitterBackoff become the default
 config. (#3614)

* Changing the default retry configuration for Redis standalone clients.

* Updating default retry strategy for standalone clients. 3 retries with ExponentialWithJitterBackoff become the default config.

* Applying review comments - removing unused methods from retry objects, updating pydocs of error handler method
---
 redis/asyncio/client.py                    | 141 ++++++++++----------
 redis/client.py                            | 148 ++++++++++++---------
 redis/connection.py                        |   2 +-
 tests/test_asyncio/test_connection_pool.py |   6 +-
 tests/test_connection_pool.py              |   6 +-
 tests/test_retry.py                        |   4 +-
 6 files changed, 165 insertions(+), 142 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 3f35fdd59e..ac907b0c10 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -39,6 +39,7 @@
 )
 from redis.asyncio.lock import Lock
 from redis.asyncio.retry import Retry
+from redis.backoff import ExponentialWithJitterBackoff
 from redis.client import (
     EMPTY_RESPONSE,
     NEVER_DECODE,
@@ -65,7 +66,6 @@
     PubSubError,
     RedisError,
     ResponseError,
-    TimeoutError,
     WatchError,
 )
 from redis.typing import ChannelT, EncodableT, KeyT
@@ -73,6 +73,7 @@
     HIREDIS_AVAILABLE,
     SSL_AVAILABLE,
     _set_info_logger,
+    deprecated_args,
     deprecated_function,
     get_lib_version,
     safe_str,
@@ -208,6 +209,11 @@ def from_pool(
         client.auto_close_connection_pool = True
         return client
 
+    @deprecated_args(
+        args_to_warn=["retry_on_timeout"],
+        reason="TimeoutError is included by default.",
+        version="6.0.0",
+    )
     def __init__(
         self,
         *,
@@ -225,6 +231,9 @@ def __init__(
         encoding_errors: str = "strict",
         decode_responses: bool = False,
         retry_on_timeout: bool = False,
+        retry: Retry = Retry(
+            backoff=ExponentialWithJitterBackoff(base=1, cap=10), retries=3
+        ),
         retry_on_error: Optional[list] = None,
         ssl: bool = False,
         ssl_keyfile: Optional[str] = None,
@@ -242,7 +251,6 @@ def __init__(
         lib_name: Optional[str] = "redis-py",
         lib_version: Optional[str] = get_lib_version(),
         username: Optional[str] = None,
-        retry: Optional[Retry] = None,
         auto_close_connection_pool: Optional[bool] = None,
         redis_connect_func=None,
         credential_provider: Optional[CredentialProvider] = None,
@@ -251,10 +259,24 @@ def __init__(
     ):
         """
         Initialize a new Redis client.
-        To specify a retry policy for specific errors, first set
-        `retry_on_error` to a list of the error/s to retry on, then set
-        `retry` to a valid `Retry` object.
-        To retry on TimeoutError, `retry_on_timeout` can also be set to `True`.
+
+        To specify a retry policy for specific errors, you have two options:
+
+        1. Set the `retry_on_error` to a list of the error/s to retry on, and
+        you can also set `retry` to a valid `Retry` object(in case the default
+        one is not appropriate) - with this approach the retries will be triggered
+        on the default errors specified in the Retry object enriched with the
+        errors specified in `retry_on_error`.
+
+        2. Define a `Retry` object with configured 'supported_errors' and set
+        it to the `retry` parameter - with this approach you completely redefine
+        the errors on which retries will happen.
+
+        `retry_on_timeout` is deprecated - please include the TimeoutError
+        either in the Retry object or in the `retry_on_error` list.
+
+        When 'connection_pool' is provided - the retry configuration of the
+        provided pool will be used.
         """
         kwargs: Dict[str, Any]
         if event_dispatcher is None:
@@ -280,8 +302,6 @@ def __init__(
             # Create internal connection pool, expected to be closed by Redis instance
             if not retry_on_error:
                 retry_on_error = []
-            if retry_on_timeout is True:
-                retry_on_error.append(TimeoutError)
             kwargs = {
                 "db": db,
                 "username": username,
@@ -291,7 +311,6 @@ def __init__(
                 "encoding": encoding,
                 "encoding_errors": encoding_errors,
                 "decode_responses": decode_responses,
-                "retry_on_timeout": retry_on_timeout,
                 "retry_on_error": retry_on_error,
                 "retry": copy.deepcopy(retry),
                 "max_connections": max_connections,
@@ -403,10 +422,10 @@ def get_connection_kwargs(self):
         """Get the connection's key-word arguments"""
         return self.connection_pool.connection_kwargs
 
-    def get_retry(self) -> Optional["Retry"]:
+    def get_retry(self) -> Optional[Retry]:
         return self.get_connection_kwargs().get("retry")
 
-    def set_retry(self, retry: "Retry") -> None:
+    def set_retry(self, retry: Retry) -> None:
         self.get_connection_kwargs().update({"retry": retry})
         self.connection_pool.set_retry(retry)
 
@@ -633,18 +652,17 @@ async def _send_command_parse_response(self, conn, command_name, *args, **option
         await conn.send_command(*args)
         return await self.parse_response(conn, command_name, **options)
 
-    async def _disconnect_raise(self, conn: Connection, error: Exception):
+    async def _close_connection(self, conn: Connection):
         """
-        Close the connection and raise an exception
-        if retry_on_error is not set or the error
-        is not one of the specified error types
+        Close the connection before retrying.
+
+        The supported exceptions are already checked in the
+        retry object so we don't need to do it here.
+
+        After we disconnect the connection, it will try to reconnect and
+        do a health check as part of the send_command logic(on connection level).
         """
         await conn.disconnect()
-        if (
-            conn.retry_on_error is None
-            or isinstance(error, tuple(conn.retry_on_error)) is False
-        ):
-            raise error
 
     # COMMAND EXECUTION AND PROTOCOL PARSING
     async def execute_command(self, *args, **options):
@@ -661,7 +679,7 @@ async def execute_command(self, *args, **options):
                 lambda: self._send_command_parse_response(
                     conn, command_name, *args, **options
                 ),
-                lambda error: self._disconnect_raise(conn, error),
+                lambda _: self._close_connection(conn),
             )
         finally:
             if self.single_connection_client:
@@ -929,19 +947,11 @@ async def connect(self):
             )
         )
 
-    async def _disconnect_raise_connect(self, conn, error):
+    async def _reconnect(self, conn):
         """
-        Close the connection and raise an exception
-        if retry_on_error is not set or the error is not one
-        of the specified error types. Otherwise, try to
-        reconnect
+        Try to reconnect
         """
         await conn.disconnect()
-        if (
-            conn.retry_on_error is None
-            or isinstance(error, tuple(conn.retry_on_error)) is False
-        ):
-            raise error
         await conn.connect()
 
     async def _execute(self, conn, command, *args, **kwargs):
@@ -954,7 +964,7 @@ async def _execute(self, conn, command, *args, **kwargs):
         """
         return await conn.retry.call_with_retry(
             lambda: command(*args, **kwargs),
-            lambda error: self._disconnect_raise_connect(conn, error),
+            lambda _: self._reconnect(conn),
         )
 
     async def parse_response(self, block: bool = True, timeout: float = 0):
@@ -1245,7 +1255,8 @@ class Pipeline(Redis):  # lgtm [py/init-calls-subclass]
     in one transmission.  This is convenient for batch processing, such as
     saving all the values in a list to Redis.
 
-    All commands executed within a pipeline are wrapped with MULTI and EXEC
+    All commands executed within a pipeline(when running in transactional mode,
+    which is the default behavior) are wrapped with MULTI and EXEC
     calls. This guarantees all commands executed in the pipeline will be
     executed atomically.
 
@@ -1274,7 +1285,7 @@ def __init__(
         self.shard_hint = shard_hint
         self.watching = False
         self.command_stack: CommandStackT = []
-        self.scripts: Set["Script"] = set()
+        self.scripts: Set[Script] = set()
         self.explicit_transaction = False
 
     async def __aenter__(self: _RedisT) -> _RedisT:
@@ -1346,36 +1357,36 @@ def execute_command(
             return self.immediate_execute_command(*args, **kwargs)
         return self.pipeline_execute_command(*args, **kwargs)
 
-    async def _disconnect_reset_raise(self, conn, error):
+    async def _disconnect_reset_raise_on_watching(
+        self,
+        conn: Connection,
+        error: Exception,
+    ):
         """
-        Close the connection, reset watching state and
-        raise an exception if we were watching,
-        if retry_on_error is not set or the error is not one
-        of the specified error types.
+        Close the connection reset watching state and
+        raise an exception if we were watching.
+
+        The supported exceptions are already checked in the
+        retry object so we don't need to do it here.
+
+        After we disconnect the connection, it will try to reconnect and
+        do a health check as part of the send_command logic(on connection level).
         """
         await conn.disconnect()
         # if we were already watching a variable, the watch is no longer
         # valid since this connection has died. raise a WatchError, which
         # indicates the user should retry this transaction.
         if self.watching:
-            await self.aclose()
+            await self.reset()
             raise WatchError(
-                "A ConnectionError occurred on while watching one or more keys"
+                f"A {type(error).__name__} occurred while watching one or more keys"
             )
-        # if retry_on_error is not set or the error is not one
-        # of the specified error types, raise it
-        if (
-            conn.retry_on_error is None
-            or isinstance(error, tuple(conn.retry_on_error)) is False
-        ):
-            await self.aclose()
-            raise
 
     async def immediate_execute_command(self, *args, **options):
         """
-        Execute a command immediately, but don't auto-retry on a
-        ConnectionError if we're already WATCHing a variable. Used when
-        issuing WATCH or subsequent commands retrieving their values but before
+        Execute a command immediately, but don't auto-retry on the supported
+        errors for retry if we're already WATCHing a variable.
+        Used when issuing WATCH or subsequent commands retrieving their values but before
         MULTI is called.
         """
         command_name = args[0]
@@ -1389,7 +1400,7 @@ async def immediate_execute_command(self, *args, **options):
             lambda: self._send_command_parse_response(
                 conn, command_name, *args, **options
             ),
-            lambda error: self._disconnect_reset_raise(conn, error),
+            lambda error: self._disconnect_reset_raise_on_watching(conn, error),
         )
 
     def pipeline_execute_command(self, *args, **options):
@@ -1544,11 +1555,15 @@ async def load_scripts(self):
                 if not exist:
                     s.sha = await immediate("SCRIPT LOAD", s.script)
 
-    async def _disconnect_raise_reset(self, conn: Connection, error: Exception):
+    async def _disconnect_raise_on_watching(self, conn: Connection, error: Exception):
         """
-        Close the connection, raise an exception if we were watching,
-        and raise an exception if retry_on_error is not set or the
-        error is not one of the specified error types.
+        Close the connection, raise an exception if we were watching.
+
+        The supported exceptions are already checked in the
+        retry object so we don't need to do it here.
+
+        After we disconnect the connection, it will try to reconnect and
+        do a health check as part of the send_command logic(on connection level).
         """
         await conn.disconnect()
         # if we were watching a variable, the watch is no longer valid
@@ -1556,16 +1571,8 @@ async def _disconnect_raise_reset(self, conn: Connection, error: Exception):
         # indicates the user should retry this transaction.
         if self.watching:
             raise WatchError(
-                "A ConnectionError occurred on while watching one or more keys"
+                f"A {type(error).__name__} occurred while watching one or more keys"
             )
-        # if retry_on_error is not set or the error is not one
-        # of the specified error types, raise it
-        if (
-            conn.retry_on_error is None
-            or isinstance(error, tuple(conn.retry_on_error)) is False
-        ):
-            await self.reset()
-            raise
 
     async def execute(self, raise_on_error: bool = True) -> List[Any]:
         """Execute all the commands in the current pipeline"""
@@ -1590,7 +1597,7 @@ async def execute(self, raise_on_error: bool = True) -> List[Any]:
         try:
             return await conn.retry.call_with_retry(
                 lambda: execute(conn, stack, raise_on_error),
-                lambda error: self._disconnect_raise_reset(conn, error),
+                lambda error: self._disconnect_raise_on_watching(conn, error),
             )
         finally:
             await self.reset()
diff --git a/redis/client.py b/redis/client.py
index fda927507a..138f561974 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -11,6 +11,7 @@
     List,
     Mapping,
     Optional,
+    Set,
     Type,
     Union,
 )
@@ -22,6 +23,7 @@
     _RedisCallbacksRESP3,
     bool_ok,
 )
+from redis.backoff import ExponentialWithJitterBackoff
 from redis.cache import CacheConfig, CacheInterface
 from redis.commands import (
     CoreCommands,
@@ -29,6 +31,7 @@
     SentinelCommands,
     list_or_args,
 )
+from redis.commands.core import Script
 from redis.connection import (
     AbstractConnection,
     ConnectionPool,
@@ -49,7 +52,6 @@
     PubSubError,
     RedisError,
     ResponseError,
-    TimeoutError,
     WatchError,
 )
 from redis.lock import Lock
@@ -57,6 +59,7 @@
 from redis.utils import (
     HIREDIS_AVAILABLE,
     _set_info_logger,
+    deprecated_args,
     get_lib_version,
     safe_str,
     str_if_bytes,
@@ -188,6 +191,11 @@ def from_pool(
         client.auto_close_connection_pool = True
         return client
 
+    @deprecated_args(
+        args_to_warn=["retry_on_timeout"],
+        reason="TimeoutError is included by default.",
+        version="6.0.0",
+    )
     def __init__(
         self,
         host: str = "localhost",
@@ -204,6 +212,9 @@ def __init__(
         encoding_errors: str = "strict",
         decode_responses: bool = False,
         retry_on_timeout: bool = False,
+        retry: Retry = Retry(
+            backoff=ExponentialWithJitterBackoff(base=1, cap=10), retries=3
+        ),
         retry_on_error: Optional[List[Type[Exception]]] = None,
         ssl: bool = False,
         ssl_keyfile: Optional[str] = None,
@@ -227,7 +238,6 @@ def __init__(
         lib_name: Optional[str] = "redis-py",
         lib_version: Optional[str] = get_lib_version(),
         username: Optional[str] = None,
-        retry: Optional[Retry] = None,
         redis_connect_func: Optional[Callable[[], None]] = None,
         credential_provider: Optional[CredentialProvider] = None,
         protocol: Optional[int] = 2,
@@ -237,10 +247,24 @@ def __init__(
     ) -> None:
         """
         Initialize a new Redis client.
-        To specify a retry policy for specific errors, first set
-        `retry_on_error` to a list of the error/s to retry on, then set
-        `retry` to a valid `Retry` object.
-        To retry on TimeoutError, `retry_on_timeout` can also be set to `True`.
+
+        To specify a retry policy for specific errors, you have two options:
+
+        1. Set the `retry_on_error` to a list of the error/s to retry on, and
+        you can also set `retry` to a valid `Retry` object(in case the default
+        one is not appropriate) - with this approach the retries will be triggered
+        on the default errors specified in the Retry object enriched with the
+        errors specified in `retry_on_error`.
+
+        2. Define a `Retry` object with configured 'supported_errors' and set
+        it to the `retry` parameter - with this approach you completely redefine
+        the errors on which retries will happen.
+
+        `retry_on_timeout` is deprecated - please include the TimeoutError
+        either in the Retry object or in the `retry_on_error` list.
+
+        When 'connection_pool' is provided - the retry configuration of the
+        provided pool will be used.
 
         Args:
 
@@ -255,8 +279,6 @@ def __init__(
         if not connection_pool:
             if not retry_on_error:
                 retry_on_error = []
-            if retry_on_timeout is True:
-                retry_on_error.append(TimeoutError)
             kwargs = {
                 "db": db,
                 "username": username,
@@ -378,10 +400,10 @@ def get_connection_kwargs(self) -> Dict:
         """Get the connection's key-word arguments"""
         return self.connection_pool.connection_kwargs
 
-    def get_retry(self) -> Optional["Retry"]:
+    def get_retry(self) -> Optional[Retry]:
         return self.get_connection_kwargs().get("retry")
 
-    def set_retry(self, retry: "Retry") -> None:
+    def set_retry(self, retry: Retry) -> None:
         self.get_connection_kwargs().update({"retry": retry})
         self.connection_pool.set_retry(retry)
 
@@ -581,18 +603,18 @@ def _send_command_parse_response(self, conn, command_name, *args, **options):
         conn.send_command(*args, **options)
         return self.parse_response(conn, command_name, **options)
 
-    def _disconnect_raise(self, conn, error):
+    def _close_connection(self, conn) -> None:
         """
-        Close the connection and raise an exception
-        if retry_on_error is not set or the error
-        is not one of the specified error types
+        Close the connection before retrying.
+
+        The supported exceptions are already checked in the
+        retry object so we don't need to do it here.
+
+        After we disconnect the connection, it will try to reconnect and
+        do a health check as part of the send_command logic(on connection level).
         """
+
         conn.disconnect()
-        if (
-            conn.retry_on_error is None
-            or isinstance(error, tuple(conn.retry_on_error)) is False
-        ):
-            raise error
 
     # COMMAND EXECUTION AND PROTOCOL PARSING
     def execute_command(self, *args, **options):
@@ -611,7 +633,7 @@ def _execute_command(self, *args, **options):
                 lambda: self._send_command_parse_response(
                     conn, command_name, *args, **options
                 ),
-                lambda error: self._disconnect_raise(conn, error),
+                lambda _: self._close_connection(conn),
             )
         finally:
             if self._single_connection_client:
@@ -870,19 +892,14 @@ def clean_health_check_responses(self) -> None:
                     )
             ttl -= 1
 
-    def _disconnect_raise_connect(self, conn, error) -> None:
+    def _reconnect(self, conn) -> None:
         """
-        Close the connection and raise an exception
-        if retry_on_error is not set or the error is not one
-        of the specified error types. Otherwise, try to
-        reconnect
+        The supported exceptions are already checked in the
+        retry object so we don't need to do it here.
+
+        In this error handler we are trying to reconnect to the server.
         """
         conn.disconnect()
-        if (
-            conn.retry_on_error is None
-            or isinstance(error, tuple(conn.retry_on_error)) is False
-        ):
-            raise error
         conn.connect()
 
     def _execute(self, conn, command, *args, **kwargs):
@@ -895,7 +912,7 @@ def _execute(self, conn, command, *args, **kwargs):
         """
         return conn.retry.call_with_retry(
             lambda: command(*args, **kwargs),
-            lambda error: self._disconnect_raise_connect(conn, error),
+            lambda _: self._reconnect(conn),
         )
 
     def parse_response(self, block=True, timeout=0):
@@ -1264,7 +1281,8 @@ class Pipeline(Redis):
     in one transmission.  This is convenient for batch processing, such as
     saving all the values in a list to Redis.
 
-    All commands executed within a pipeline are wrapped with MULTI and EXEC
+    All commands executed within a pipeline(when running in transactional mode,
+    which is the default behavior) are wrapped with MULTI and EXEC
     calls. This guarantees all commands executed in the pipeline will be
     executed atomically.
 
@@ -1285,9 +1303,10 @@ def __init__(self, connection_pool, response_callbacks, transaction, shard_hint)
         self.response_callbacks = response_callbacks
         self.transaction = transaction
         self.shard_hint = shard_hint
-
         self.watching = False
-        self.reset()
+        self.command_stack = []
+        self.scripts: Set[Script] = set()
+        self.explicit_transaction = False
 
     def __enter__(self) -> "Pipeline":
         return self
@@ -1353,36 +1372,37 @@ def execute_command(self, *args, **kwargs):
             return self.immediate_execute_command(*args, **kwargs)
         return self.pipeline_execute_command(*args, **kwargs)
 
-    def _disconnect_reset_raise(self, conn, error) -> None:
+    def _disconnect_reset_raise_on_watching(
+        self,
+        conn: AbstractConnection,
+        error: Exception,
+    ) -> None:
         """
-        Close the connection, reset watching state and
-        raise an exception if we were watching,
-        if retry_on_error is not set or the error is not one
-        of the specified error types.
+        Close the connection reset watching state and
+        raise an exception if we were watching.
+
+        The supported exceptions are already checked in the
+        retry object so we don't need to do it here.
+
+        After we disconnect the connection, it will try to reconnect and
+        do a health check as part of the send_command logic(on connection level).
         """
         conn.disconnect()
+
         # if we were already watching a variable, the watch is no longer
         # valid since this connection has died. raise a WatchError, which
         # indicates the user should retry this transaction.
         if self.watching:
             self.reset()
             raise WatchError(
-                "A ConnectionError occurred on while watching one or more keys"
+                f"A {type(error).__name__} occurred while watching one or more keys"
             )
-        # if retry_on_error is not set or the error is not one
-        # of the specified error types, raise it
-        if (
-            conn.retry_on_error is None
-            or isinstance(error, tuple(conn.retry_on_error)) is False
-        ):
-            self.reset()
-            raise
 
     def immediate_execute_command(self, *args, **options):
         """
-        Execute a command immediately, but don't auto-retry on a
-        ConnectionError if we're already WATCHing a variable. Used when
-        issuing WATCH or subsequent commands retrieving their values but before
+        Execute a command immediately, but don't auto-retry on the supported
+        errors for retry if we're already WATCHing a variable.
+        Used when issuing WATCH or subsequent commands retrieving their values but before
         MULTI is called.
         """
         command_name = args[0]
@@ -1396,7 +1416,7 @@ def immediate_execute_command(self, *args, **options):
             lambda: self._send_command_parse_response(
                 conn, command_name, *args, **options
             ),
-            lambda error: self._disconnect_reset_raise(conn, error),
+            lambda error: self._disconnect_reset_raise_on_watching(conn, error),
         )
 
     def pipeline_execute_command(self, *args, **options) -> "Pipeline":
@@ -1534,15 +1554,19 @@ def load_scripts(self):
                 if not exist:
                     s.sha = immediate("SCRIPT LOAD", s.script)
 
-    def _disconnect_raise_reset(
+    def _disconnect_raise_on_watching(
         self,
         conn: AbstractConnection,
         error: Exception,
     ) -> None:
         """
-        Close the connection, raise an exception if we were watching,
-        and raise an exception if retry_on_error is not set or the
-        error is not one of the specified error types.
+        Close the connection, raise an exception if we were watching.
+
+        The supported exceptions are already checked in the
+        retry object so we don't need to do it here.
+
+        After we disconnect the connection, it will try to reconnect and
+        do a health check as part of the send_command logic(on connection level).
         """
         conn.disconnect()
         # if we were watching a variable, the watch is no longer valid
@@ -1550,16 +1574,8 @@ def _disconnect_raise_reset(
         # indicates the user should retry this transaction.
         if self.watching:
             raise WatchError(
-                "A ConnectionError occurred on while watching one or more keys"
+                f"A {type(error).__name__} occurred while watching one or more keys"
             )
-        # if retry_on_error is not set or the error is not one
-        # of the specified error types, raise it
-        if (
-            conn.retry_on_error is None
-            or isinstance(error, tuple(conn.retry_on_error)) is False
-        ):
-            self.reset()
-            raise error
 
     def execute(self, raise_on_error: bool = True) -> List[Any]:
         """Execute all the commands in the current pipeline"""
@@ -1583,7 +1599,7 @@ def execute(self, raise_on_error: bool = True) -> List[Any]:
         try:
             return conn.retry.call_with_retry(
                 lambda: execute(conn, stack, raise_on_error),
-                lambda error: self._disconnect_raise_reset(conn, error),
+                lambda error: self._disconnect_raise_on_watching(conn, error),
             )
         finally:
             self.reset()
diff --git a/redis/connection.py b/redis/connection.py
index 08e980e866..ffb1e37ba3 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1611,7 +1611,7 @@ def close(self) -> None:
         """Close the pool, disconnecting all connections"""
         self.disconnect()
 
-    def set_retry(self, retry: "Retry") -> None:
+    def set_retry(self, retry: Retry) -> None:
         self.connection_kwargs.update({"retry": retry})
         for conn in self._available_connections:
             conn.retry = retry
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
index 3d120e4ca7..09409e04a8 100644
--- a/tests/test_asyncio/test_connection_pool.py
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -614,9 +614,9 @@ async def test_busy_loading_from_pipeline_immediate_command(self, r):
                 "DEBUG", "ERROR", "LOADING fake message"
             )
         pool = r.connection_pool
-        assert not pipe.connection
-        assert len(pool._available_connections) == 1
-        assert not pool._available_connections[0]._reader
+        assert pipe.connection
+        assert pipe.connection in pool._in_use_connections
+        assert not pipe.connection._reader
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.8.8")
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 0ec77a4fff..d97c9063ac 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -563,9 +563,9 @@ def test_busy_loading_from_pipeline_immediate_command(self, r):
         with pytest.raises(redis.BusyLoadingError):
             pipe.immediate_execute_command("DEBUG", "ERROR", "LOADING fake message")
         pool = r.connection_pool
-        assert not pipe.connection
-        assert len(pool._available_connections) == 1
-        assert not pool._available_connections[0]._sock
+        assert pipe.connection
+        assert pipe.connection in pool._in_use_connections
+        assert not pipe.connection._sock
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.8.8")
diff --git a/tests/test_retry.py b/tests/test_retry.py
index e1e4c414a4..cb001fbbd5 100644
--- a/tests/test_retry.py
+++ b/tests/test_retry.py
@@ -159,7 +159,7 @@ def test_client_retry_on_error_raise(self, request):
 
     def test_client_retry_on_error_different_error_raised(self, request):
         with patch.object(Redis, "parse_response") as parse_response:
-            parse_response.side_effect = TimeoutError()
+            parse_response.side_effect = OSError()
             retries = 3
             r = _get_client(
                 Redis,
@@ -167,7 +167,7 @@ def test_client_retry_on_error_different_error_raised(self, request):
                 retry_on_error=[ReadOnlyError],
                 retry=Retry(NoBackoff(), retries),
             )
-            with pytest.raises(TimeoutError):
+            with pytest.raises(OSError):
                 try:
                     r.get("foo")
                 finally:

From 4fef1bdd34d5a97da2a4f109e71f87b2996bcac3 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 29 Apr 2025 14:40:17 +0300
Subject: [PATCH 1037/1164] Handling some special values when transforming
 responce data into list(issue #3573) (#3586)

---
 redis/commands/helpers.py        | 25 +++++++++++++++++++------
 tests/test_asyncio/test_bloom.py | 28 ++++++++++++++++++++++++++++
 tests/test_bloom.py              | 28 ++++++++++++++++++++++++++++
 3 files changed, 75 insertions(+), 6 deletions(-)

diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
index f6121b6c3b..859a43aea9 100644
--- a/redis/commands/helpers.py
+++ b/redis/commands/helpers.py
@@ -43,19 +43,32 @@ def parse_to_list(response):
     """Optimistically parse the response to a list."""
     res = []
 
+    special_values = {"infinity", "nan", "-infinity"}
+
     if response is None:
         return res
 
     for item in response:
+        if item is None:
+            res.append(None)
+            continue
         try:
-            res.append(int(item))
-        except ValueError:
-            try:
-                res.append(float(item))
-            except ValueError:
-                res.append(nativestr(item))
+            item_str = nativestr(item)
         except TypeError:
             res.append(None)
+            continue
+
+        if isinstance(item_str, str) and item_str.lower() in special_values:
+            res.append(item_str)  # Keep as string
+        else:
+            try:
+                res.append(int(item))
+            except ValueError:
+                try:
+                    res.append(float(item))
+                except ValueError:
+                    res.append(item_str)
+
     return res
 
 
diff --git a/tests/test_asyncio/test_bloom.py b/tests/test_asyncio/test_bloom.py
index 031e8364d7..d67858570f 100644
--- a/tests/test_asyncio/test_bloom.py
+++ b/tests/test_asyncio/test_bloom.py
@@ -333,6 +333,34 @@ async def test_topk(decoded_r: redis.Redis):
     assert 0.9 == round(float(info["decay"]), 1)
 
 
+@pytest.mark.redismod
+async def test_topk_list_with_special_words(decoded_r: redis.Redis):
+    # test list with empty buckets
+    assert await decoded_r.topk().reserve("topklist:specialwords", 5, 20, 4, 0.9)
+    assert await decoded_r.topk().add(
+        "topklist:specialwords",
+        "infinity",
+        "B",
+        "nan",
+        "D",
+        "-infinity",
+        "infinity",
+        "infinity",
+        "B",
+        "nan",
+        "G",
+        "D",
+        "B",
+        "D",
+        "infinity",
+        "-infinity",
+        "-infinity",
+    )
+    assert ["infinity", "B", "D", "-infinity", "nan"] == await decoded_r.topk().list(
+        "topklist:specialwords"
+    )
+
+
 @pytest.mark.redismod
 async def test_topk_incrby(decoded_r: redis.Redis):
     await decoded_r.flushdb()
diff --git a/tests/test_bloom.py b/tests/test_bloom.py
index e44c421634..a8d6390048 100644
--- a/tests/test_bloom.py
+++ b/tests/test_bloom.py
@@ -364,6 +364,34 @@ def test_topk(client):
     assert 0.9 == round(float(info["decay"]), 1)
 
 
+@pytest.mark.redismod
+def test_topk_list_with_special_words(client):
+    # test list with empty buckets
+    assert client.topk().reserve("topklist:specialwords", 5, 20, 4, 0.9)
+    assert client.topk().add(
+        "topklist:specialwords",
+        "infinity",
+        "B",
+        "nan",
+        "D",
+        "-infinity",
+        "infinity",
+        "infinity",
+        "B",
+        "nan",
+        "G",
+        "D",
+        "B",
+        "D",
+        "infinity",
+        "-infinity",
+        "-infinity",
+    )
+    assert ["infinity", "B", "D", "-infinity", "nan"] == client.topk().list(
+        "topklist:specialwords"
+    )
+
+
 @pytest.mark.redismod
 def test_topk_incrby(client):
     client.flushdb()

From a4df6b272d308e44b3e883bf91a39051eddb91eb Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 29 Apr 2025 16:48:48 +0300
Subject: [PATCH 1038/1164] When SlotNotCoveredError is raised, the cluster
 topology should be reinitialized as part of error handling and retrying of
 the commands. (#3621)

---
 redis/asyncio/cluster.py |  8 +++++++-
 redis/cluster.py         | 17 ++++++++++++++---
 2 files changed, 21 insertions(+), 4 deletions(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 28fcd3aa23..35ea2e580e 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -808,10 +808,16 @@ async def _execute_command(
                 # and try again with the new setup
                 await self.aclose()
                 raise
-            except ClusterDownError:
+            except (ClusterDownError, SlotNotCoveredError):
                 # ClusterDownError can occur during a failover and to get
                 # self-healed, we will try to reinitialize the cluster layout
                 # and retry executing the command
+
+                # SlotNotCoveredError can occur when the cluster is not fully
+                # initialized or can be temporary issue.
+                # We will try to reinitialize the cluster topology
+                # and retry executing the command
+
                 await self.aclose()
                 await asyncio.sleep(0.25)
                 raise
diff --git a/redis/cluster.py b/redis/cluster.py
index 39b454babe..fc5ffab892 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -410,7 +410,12 @@ class AbstractRedisCluster:
         list_keys_to_dict(["SCRIPT FLUSH"], lambda command, res: all(res.values())),
     )
 
-    ERRORS_ALLOW_RETRY = (ConnectionError, TimeoutError, ClusterDownError)
+    ERRORS_ALLOW_RETRY = (
+        ConnectionError,
+        TimeoutError,
+        ClusterDownError,
+        SlotNotCoveredError,
+    )
 
     def replace_default_node(self, target_node: "ClusterNode" = None) -> None:
         """Replace the default cluster node.
@@ -1239,13 +1244,19 @@ def _execute_command(self, target_node, *args, **kwargs):
             except AskError as e:
                 redirect_addr = get_node_name(host=e.host, port=e.port)
                 asking = True
-            except ClusterDownError as e:
+            except (ClusterDownError, SlotNotCoveredError):
                 # ClusterDownError can occur during a failover and to get
                 # self-healed, we will try to reinitialize the cluster layout
                 # and retry executing the command
+
+                # SlotNotCoveredError can occur when the cluster is not fully
+                # initialized or can be temporary issue.
+                # We will try to reinitialize the cluster topology
+                # and retry executing the command
+
                 time.sleep(0.25)
                 self.nodes_manager.initialize()
-                raise e
+                raise
             except ResponseError:
                 raise
             except Exception as e:

From 20538343af5f9d5076a393aa54500aa2ad93fbde Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Wed, 30 Apr 2025 13:02:33 +0300
Subject: [PATCH 1039/1164] Fixing the versions of some deprecations that
 wrongly added as 5.0.3 - the correct version is 5.3.0 (#3625)

---
 redis/asyncio/cluster.py    | 2 +-
 redis/asyncio/connection.py | 4 ++--
 redis/cluster.py            | 6 +++---
 redis/connection.py         | 4 ++--
 4 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 35ea2e580e..457642b792 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -229,7 +229,7 @@ def from_url(cls, url: str, **kwargs: Any) -> "RedisCluster":
     @deprecated_args(
         args_to_warn=["read_from_replicas"],
         reason="Please configure the 'load_balancing_strategy' instead",
-        version="5.0.3",
+        version="5.3.0",
     )
     def __init__(
         self,
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 7404f3d6f8..70d7d91898 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -1133,7 +1133,7 @@ def can_get_connection(self) -> bool:
     @deprecated_args(
         args_to_warn=["*"],
         reason="Use get_connection() without args instead",
-        version="5.0.3",
+        version="5.3.0",
     )
     async def get_connection(self, command_name=None, *keys, **options):
         async with self._lock:
@@ -1306,7 +1306,7 @@ def __init__(
     @deprecated_args(
         args_to_warn=["*"],
         reason="Use get_connection() without args instead",
-        version="5.0.3",
+        version="5.3.0",
     )
     async def get_connection(self, command_name=None, *keys, **options):
         """Gets a connection from the pool, blocking until one is available"""
diff --git a/redis/cluster.py b/redis/cluster.py
index fc5ffab892..010a3d94e6 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -58,7 +58,7 @@ def get_node_name(host: str, port: Union[str, int]) -> str:
 @deprecated_args(
     allowed_args=["redis_node"],
     reason="Use get_connection(redis_node) instead",
-    version="5.0.3",
+    version="5.3.0",
 )
 def get_connection(redis_node, *args, **options):
     return redis_node.connection or redis_node.connection_pool.get_connection()
@@ -490,7 +490,7 @@ class initializer. In the case of conflicting arguments, querystring
     @deprecated_args(
         args_to_warn=["read_from_replicas"],
         reason="Please configure the 'load_balancing_strategy' instead",
-        version="5.0.3",
+        version="5.3.0",
     )
     def __init__(
         self,
@@ -1493,7 +1493,7 @@ def _update_moved_slots(self):
             "In case you need select some load balancing strategy "
             "that will use replicas, please set it through 'load_balancing_strategy'"
         ),
-        version="5.0.3",
+        version="5.3.0",
     )
     def get_node_from_slot(
         self,
diff --git a/redis/connection.py b/redis/connection.py
index ffb1e37ba3..ddc6991c5c 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1502,7 +1502,7 @@ def _checkpid(self) -> None:
     @deprecated_args(
         args_to_warn=["*"],
         reason="Use get_connection() without args instead",
-        version="5.0.3",
+        version="5.3.0",
     )
     def get_connection(self, command_name=None, *keys, **options) -> "Connection":
         "Get a connection from the pool"
@@ -1730,7 +1730,7 @@ def make_connection(self):
     @deprecated_args(
         args_to_warn=["*"],
         reason="Use get_connection() without args instead",
-        version="5.0.3",
+        version="5.3.0",
     )
     def get_connection(self, command_name=None, *keys, **options):
         """

From 5170ba7097971f522b45437839e0dc4e49360300 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Wed, 30 Apr 2025 14:38:07 +0300
Subject: [PATCH 1040/1164] Updating pipeline tests to use test libs image with
 RC2. Updating timeseries tests. (#3623)

---
 .github/workflows/integration.yaml    |  2 +-
 docker-compose.yml                    |  2 +-
 tests/test_asyncio/test_timeseries.py | 39 +++++++++++++++++++++++++++
 tests/test_timeseries.py              | 39 ++++++++++++++++++++++++++-
 4 files changed, 79 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index f8aa5c8932..fbfcecdf68 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -74,7 +74,7 @@ jobs:
       max-parallel: 15
       fail-fast: false
       matrix:
-        redis-version: ['8.0-RC1-pre', '${{ needs.redis_version.outputs.CURRENT }}', '7.2.7', '6.2.17']
+        redis-version: ['8.0-RC2-pre', '${{ needs.redis_version.outputs.CURRENT }}', '7.2.7', '6.2.17']
         python-version: ['3.8', '3.13']
         parser-backend: ['plain']
         event-loop: ['asyncio']
diff --git a/docker-compose.yml b/docker-compose.yml
index 6b544553cb..76a60398f3 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,6 +1,6 @@
 ---
 x-client-libs-stack-image: &client-libs-stack-image
-  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_STACK_IMAGE_TAG:-7.4.2}"
+  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_STACK_IMAGE_TAG:-rs-7.4.0-v2}"
 
 x-client-libs-image: &client-libs-image
   image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_IMAGE_TAG:-7.4.2}"
diff --git a/tests/test_asyncio/test_timeseries.py b/tests/test_asyncio/test_timeseries.py
index b21f7d0ac8..24c36c9ca2 100644
--- a/tests/test_asyncio/test_timeseries.py
+++ b/tests/test_asyncio/test_timeseries.py
@@ -7,6 +7,8 @@
 from tests.conftest import (
     assert_resp_response,
     is_resp2_connection,
+    skip_if_server_version_gte,
+    skip_if_server_version_lt,
     skip_ifmodversion_lt,
 )
 
@@ -75,7 +77,24 @@ async def test_alter(decoded_r: redis.Redis):
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
+@skip_if_server_version_lt("7.9.0")
 async def test_alter_duplicate_policy(decoded_r: redis.Redis):
+    assert await decoded_r.ts().create(1)
+    info = await decoded_r.ts().info(1)
+    assert_resp_response(
+        decoded_r, "block", info.get("duplicate_policy"), info.get("duplicatePolicy")
+    )
+    assert await decoded_r.ts().alter(1, duplicate_policy="min")
+    info = await decoded_r.ts().info(1)
+    assert_resp_response(
+        decoded_r, "min", info.get("duplicate_policy"), info.get("duplicatePolicy")
+    )
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("1.4.0", "timeseries")
+@skip_if_server_version_gte("7.9.0")
+async def test_alter_duplicate_policy_prior_redis_8(decoded_r: redis.Redis):
     assert await decoded_r.ts().create(1)
     info = await decoded_r.ts().info(1)
     assert_resp_response(
@@ -722,7 +741,27 @@ async def test_info(decoded_r: redis.Redis):
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
+@skip_if_server_version_lt("7.9.0")
 async def test_info_duplicate_policy(decoded_r: redis.Redis):
+    await decoded_r.ts().create(
+        1, retention_msecs=5, labels={"currentLabel": "currentData"}
+    )
+    info = await decoded_r.ts().info(1)
+    assert_resp_response(
+        decoded_r, "block", info.get("duplicate_policy"), info.get("duplicatePolicy")
+    )
+
+    await decoded_r.ts().create("time-serie-2", duplicate_policy="min")
+    info = await decoded_r.ts().info("time-serie-2")
+    assert_resp_response(
+        decoded_r, "min", info.get("duplicate_policy"), info.get("duplicatePolicy")
+    )
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("1.4.0", "timeseries")
+@skip_if_server_version_gte("7.9.0")
+async def test_info_duplicate_policy_prior_redis_8(decoded_r: redis.Redis):
     await decoded_r.ts().create(
         1, retention_msecs=5, labels={"currentLabel": "currentData"}
     )
diff --git a/tests/test_timeseries.py b/tests/test_timeseries.py
index fb604d0329..ad98b1ca2f 100644
--- a/tests/test_timeseries.py
+++ b/tests/test_timeseries.py
@@ -9,6 +9,8 @@
     _get_client,
     assert_resp_response,
     is_resp2_connection,
+    skip_if_server_version_gte,
+    skip_if_server_version_lt,
     skip_ifmodversion_lt,
 )
 
@@ -84,7 +86,8 @@ def test_alter(client):
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
-def test_alter_duplicate_policy(client):
+@skip_if_server_version_gte("7.9.0")
+def test_alter_duplicate_policy_prior_redis_8(client):
     assert client.ts().create(1)
     info = client.ts().info(1)
     assert_resp_response(
@@ -97,6 +100,22 @@ def test_alter_duplicate_policy(client):
     )
 
 
+@pytest.mark.redismod
+@skip_ifmodversion_lt("1.4.0", "timeseries")
+@skip_if_server_version_lt("7.9.0")
+def test_alter_duplicate_policy(client):
+    assert client.ts().create(1)
+    info = client.ts().info(1)
+    assert_resp_response(
+        client, "block", info.get("duplicate_policy"), info.get("duplicatePolicy")
+    )
+    assert client.ts().alter(1, duplicate_policy="min")
+    info = client.ts().info(1)
+    assert_resp_response(
+        client, "min", info.get("duplicate_policy"), info.get("duplicatePolicy")
+    )
+
+
 @pytest.mark.redismod
 def test_add(client):
     assert 1 == client.ts().add(1, 1, 1)
@@ -967,7 +986,25 @@ def test_info(client):
 
 @pytest.mark.redismod
 @skip_ifmodversion_lt("1.4.0", "timeseries")
+@skip_if_server_version_lt("7.9.0")
 def test_info_duplicate_policy(client):
+    client.ts().create(1, retention_msecs=5, labels={"currentLabel": "currentData"})
+    info = client.ts().info(1)
+    assert_resp_response(
+        client, "block", info.get("duplicate_policy"), info.get("duplicatePolicy")
+    )
+
+    client.ts().create("time-serie-2", duplicate_policy="min")
+    info = client.ts().info("time-serie-2")
+    assert_resp_response(
+        client, "min", info.get("duplicate_policy"), info.get("duplicatePolicy")
+    )
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("1.4.0", "timeseries")
+@skip_if_server_version_gte("7.9.0")
+def test_info_duplicate_policy_prior_redis_8(client):
     client.ts().create(1, retention_msecs=5, labels={"currentLabel": "currentData"})
     info = client.ts().info(1)
     assert_resp_response(

From 7f14301a0a2a2adfac02ef3f75e00bfb5e6ca81b Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Wed, 30 Apr 2025 15:56:11 +0300
Subject: [PATCH 1041/1164] Updated default value of 'require_full_coverage'
 argument to true for sync Cluster client to match sync/async cluster APIs
 (#3434)

* Updated default value to much sync cluster API

* Updated default value to TRUE

---------

Co-authored-by: petyaslavova <petya.slavova@redis.com>
---
 redis/cluster.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index 010a3d94e6..ae9720652a 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -499,7 +499,7 @@ def __init__(
         startup_nodes: Optional[List["ClusterNode"]] = None,
         cluster_error_retry_attempts: int = 3,
         retry: Optional["Retry"] = None,
-        require_full_coverage: bool = False,
+        require_full_coverage: bool = True,
         reinitialize_steps: int = 5,
         read_from_replicas: bool = False,
         load_balancing_strategy: Optional["LoadBalancingStrategy"] = None,

From 8faac6034de96c1b6fd94239fb3c44c156eacf9f Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Wed, 30 Apr 2025 17:03:26 +0300
Subject: [PATCH 1042/1164] Adding default retry configuration changes for
 cluster clients (#3622)

* Adding default retry configuration changes for sync cluster client

* Adding default retry configuration changes for sync cluster client

* Adding default retry configuration changes for async cluster client

* Updating docs related to retries and read_from_replicas.

* Applying review comments.

* Removing retry checks when using set_retry for cluster clients.
---
 docs/clustering.rst                   |  11 ++-
 docs/retry.rst                        |  43 ++++++-----
 redis/asyncio/cluster.py              |  97 +++++++++++++----------
 redis/asyncio/retry.py                |  12 +++
 redis/cluster.py                      | 106 ++++++++++++++++++++------
 redis/commands/json/__init__.py       |   2 +-
 redis/commands/timeseries/__init__.py |   2 +-
 redis/retry.py                        |  12 +++
 tests/test_asyncio/test_cluster.py    |  85 ++++++++++++---------
 tests/test_cluster.py                 |  50 ++++++------
 tests/test_retry.py                   |  16 ++++
 11 files changed, 283 insertions(+), 153 deletions(-)

diff --git a/docs/clustering.rst b/docs/clustering.rst
index cf257d8ad5..3c28b9ee16 100644
--- a/docs/clustering.rst
+++ b/docs/clustering.rst
@@ -187,8 +187,8 @@ When a ClusterPubSub instance is created without specifying a node, a
 single node will be transparently chosen for the pubsub connection on
 the first command execution. The node will be determined by: 1. Hashing
 the channel name in the request to find its keyslot 2. Selecting a node
-that handles the keyslot: If read_from_replicas is set to true, a
-replica can be selected.
+that handles the keyslot: If read_from_replicas is set to true or
+load_balancing_strategy is provided, a replica can be selected.
 
 Known PubSub Limitations
 ------------------------
@@ -216,9 +216,12 @@ By default, Redis Cluster always returns MOVE redirection response on
 accessing a replica node. You can overcome this limitation and scale
 read commands by triggering READONLY mode.
 
-To enable READONLY mode pass read_from_replicas=True to RedisCluster
-constructor. When set to true, read commands will be assigned between
+To enable READONLY mode pass read_from_replicas=True or define
+a load_balancing_strategy to RedisCluster constructor.
+When read_from_replicas is set to true read commands will be assigned between
 the primary and its replications in a Round-Robin manner.
+With load_balancing_strategy you can define a custom strategy for
+assigning read commands to the replicas and primary nodes.
 
 READONLY mode can be set at runtime by calling the readonly() method
 with target_nodes=‘replicas’, and read-write access can be restored by
diff --git a/docs/retry.rst b/docs/retry.rst
index acf198ec94..0f2e318022 100644
--- a/docs/retry.rst
+++ b/docs/retry.rst
@@ -13,25 +13,25 @@ Retry in Redis Standalone
 >>> from redis.client import Redis
 >>> from redis.exceptions import (
 >>>    BusyLoadingError,
->>>    ConnectionError,
->>>    TimeoutError
+>>>    RedisError,
 >>> )
 >>>
 >>> # Run 3 retries with exponential backoff strategy
 >>> retry = Retry(ExponentialBackoff(), 3)
->>> # Redis client with retries on custom errors
->>> r = Redis(host='localhost', port=6379, retry=retry, retry_on_error=[BusyLoadingError, ConnectionError, TimeoutError])
->>> # Redis client with retries on TimeoutError only
->>> r_only_timeout = Redis(host='localhost', port=6379, retry=retry, retry_on_timeout=True)
+>>> # Redis client with retries on custom errors in addition to the errors
+>>> # that are already retried by default
+>>> r = Redis(host='localhost', port=6379, retry=retry, retry_on_error=[BusyLoadingError, RedisError])
 
-As you can see from the example above, Redis client supports 3 parameters to configure the retry behaviour:
+As you can see from the example above, Redis client supports 2 parameters to configure the retry behaviour:
 
 * ``retry``: :class:`~.Retry` instance with a :ref:`backoff-label` strategy and the max number of retries
-* ``retry_on_error``: list of :ref:`exceptions-label` to retry on
-* ``retry_on_timeout``: if ``True``, retry on :class:`~.TimeoutError` only
+    * The :class:`~.Retry` instance has default set of :ref:`exceptions-label` to retry on,
+      which can be overridden by passing a tuple with :ref:`exceptions-label` to the ``supported_errors`` parameter.
+* ``retry_on_error``: list of additional :ref:`exceptions-label` to retry on
 
-If either ``retry_on_error`` or ``retry_on_timeout`` are passed and no ``retry`` is given,
-by default it uses a ``Retry(NoBackoff(), 1)`` (meaning 1 retry right after the first failure).
+
+If no ``retry`` is provided, a default one is created with  :class:`~.ExponentialWithJitterBackoff` as backoff strategy
+and 3 retries.
 
 
 Retry in Redis Cluster
@@ -44,12 +44,18 @@ Retry in Redis Cluster
 >>> # Run 3 retries with exponential backoff strategy
 >>> retry = Retry(ExponentialBackoff(), 3)
 >>> # Redis Cluster client with retries
->>> rc = RedisCluster(host='localhost', port=6379, retry=retry, cluster_error_retry_attempts=2)
+>>> rc = RedisCluster(host='localhost', port=6379, retry=retry)
 
 Retry behaviour in Redis Cluster is a little bit different from Standalone:
 
-* ``retry``: :class:`~.Retry` instance with a :ref:`backoff-label` strategy and the max number of retries, default value is ``Retry(NoBackoff(), 0)``
-* ``cluster_error_retry_attempts``: number of times to retry before raising an error when :class:`~.TimeoutError` or :class:`~.ConnectionError` or :class:`~.ClusterDownError` are encountered, default value is ``3``
+* ``retry``: :class:`~.Retry` instance with a :ref:`backoff-label` strategy and the max number of retries, default value is ``Retry(ExponentialWithJitterBackoff(base=1, cap=10), cluster_error_retry_attempts)``
+* ``cluster_error_retry_attempts``: number of times to retry before raising an error when :class:`~.TimeoutError`, :class:`~.ConnectionError`, :class:`~.ClusterDownError` or :class:`~.SlotNotCoveredError` are encountered, default value is ``3``
+    * This argument is deprecated - it is used to initialize the number of retries for the retry object,
+      only in the case when the ``retry`` object is not provided.
+      When the ``retry`` argument is provided, the ``cluster_error_retry_attempts`` argument is ignored!
+
+* The retry object is not yet fully utilized in the cluster client.
+  The retry object is used only to determine the number of retries for the cluster level calls.
 
 Let's consider the following example:
 
@@ -57,14 +63,11 @@ Let's consider the following example:
 >>> from redis.retry import Retry
 >>> from redis.cluster import RedisCluster
 >>>
->>> rc = RedisCluster(host='localhost', port=6379, retry=Retry(ExponentialBackoff(), 6), cluster_error_retry_attempts=1)
+>>> rc = RedisCluster(host='localhost', port=6379, retry=Retry(ExponentialBackoff(), 6))
 >>> rc.set('foo', 'bar')
 
 #. the client library calculates the hash slot for key 'foo'.
 #. given the hash slot, it then determines which node to connect to, in order to execute the command.
 #. during the connection, a :class:`~.ConnectionError` is raised.
-#. because we set ``retry=Retry(ExponentialBackoff(), 6)``, the client tries to reconnect to the node up to 6 times, with an exponential backoff between each attempt.
-#. even after 6 retries, the client is still unable to connect.
-#. because we set ``cluster_error_retry_attempts=1``, before giving up, the client starts a cluster update, removes the failed node from the startup nodes, and re-initializes the cluster.
-#. after the cluster has been re-initialized, it starts a new cycle of retries, up to 6 retries, with an exponential backoff.
-#. if the client can connect, we're good. Otherwise, the exception is finally raised to the caller, because we've run out of attempts.
\ No newline at end of file
+#. because we set ``retry=Retry(ExponentialBackoff(), 6)``, the cluster client starts a cluster update, removes the failed node from the startup nodes, and re-initializes the cluster.
+#. the cluster client retries the command until it either succeeds or the max number of retries is reached.
\ No newline at end of file
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 457642b792..cc5e15bb63 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -29,7 +29,7 @@
 from redis.asyncio.lock import Lock
 from redis.asyncio.retry import Retry
 from redis.auth.token import TokenInterface
-from redis.backoff import default_backoff
+from redis.backoff import ExponentialWithJitterBackoff, NoBackoff
 from redis.client import EMPTY_RESPONSE, NEVER_DECODE, AbstractRedis
 from redis.cluster import (
     PIPELINE_BLOCKED_COMMANDS,
@@ -143,19 +143,23 @@ class RedisCluster(AbstractRedis, AbstractRedisCluster, AsyncRedisClusterCommand
           To avoid reinitializing the cluster on moved errors, set reinitialize_steps to
           0.
     :param cluster_error_retry_attempts:
-        | Number of times to retry before raising an error when :class:`~.TimeoutError`
-          or :class:`~.ConnectionError` or :class:`~.ClusterDownError` are encountered
-    :param connection_error_retry_attempts:
-        | Number of times to retry before reinitializing when :class:`~.TimeoutError`
-          or :class:`~.ConnectionError` are encountered.
-          The default backoff strategy will be set if Retry object is not passed (see
-          default_backoff in backoff.py). To change it, pass a custom Retry object
-          using the "retry" keyword.
+        | @deprecated - Please configure the 'retry' object instead
+          In case 'retry' object is set - this argument is ignored!
+
+          Number of times to retry before raising an error when :class:`~.TimeoutError`,
+          :class:`~.ConnectionError`, :class:`~.SlotNotCoveredError`
+          or :class:`~.ClusterDownError` are encountered
+    :param retry:
+        | A retry object that defines the retry strategy and the number of
+          retries for the cluster client.
+          In current implementation for the cluster client (starting form redis-py version 6.0.0)
+          the retry object is not yet fully utilized, instead it is used just to determine
+          the number of retries for the cluster client.
+          In the future releases the retry object will be used to handle the cluster client retries!
     :param max_connections:
         | Maximum number of connections per node. If there are no free connections & the
           maximum number of connections are already created, a
-          :class:`~.MaxConnectionsError` is raised. This error may be retried as defined
-          by :attr:`connection_error_retry_attempts`
+          :class:`~.MaxConnectionsError` is raised.
     :param address_remap:
         | An optional callable which, when provided with an internal network
           address of a node, e.g. a `(host, port)` tuple, will return the address
@@ -211,10 +215,9 @@ def from_url(cls, url: str, **kwargs: Any) -> "RedisCluster":
     __slots__ = (
         "_initialize",
         "_lock",
-        "cluster_error_retry_attempts",
+        "retry",
         "command_flags",
         "commands_parser",
-        "connection_error_retry_attempts",
         "connection_kwargs",
         "encoder",
         "node_flags",
@@ -231,6 +234,13 @@ def from_url(cls, url: str, **kwargs: Any) -> "RedisCluster":
         reason="Please configure the 'load_balancing_strategy' instead",
         version="5.3.0",
     )
+    @deprecated_args(
+        args_to_warn=[
+            "cluster_error_retry_attempts",
+        ],
+        reason="Please configure the 'retry' object instead",
+        version="6.0.0",
+    )
     def __init__(
         self,
         host: Optional[str] = None,
@@ -242,8 +252,9 @@ def __init__(
         load_balancing_strategy: Optional[LoadBalancingStrategy] = None,
         reinitialize_steps: int = 5,
         cluster_error_retry_attempts: int = 3,
-        connection_error_retry_attempts: int = 3,
         max_connections: int = 2**31,
+        retry: Optional["Retry"] = None,
+        retry_on_error: Optional[List[Type[Exception]]] = None,
         # Client related kwargs
         db: Union[str, int] = 0,
         path: Optional[str] = None,
@@ -263,8 +274,6 @@ def __init__(
         socket_keepalive: bool = False,
         socket_keepalive_options: Optional[Mapping[int, Union[int, bytes]]] = None,
         socket_timeout: Optional[float] = None,
-        retry: Optional["Retry"] = None,
-        retry_on_error: Optional[List[Type[Exception]]] = None,
         # SSL related kwargs
         ssl: bool = False,
         ssl_ca_certs: Optional[str] = None,
@@ -318,7 +327,6 @@ def __init__(
             "socket_keepalive": socket_keepalive,
             "socket_keepalive_options": socket_keepalive_options,
             "socket_timeout": socket_timeout,
-            "retry": retry,
             "protocol": protocol,
         }
 
@@ -342,17 +350,15 @@ def __init__(
             # Call our on_connect function to configure READONLY mode
             kwargs["redis_connect_func"] = self.on_connect
 
-        self.retry = retry
-        if retry or retry_on_error or connection_error_retry_attempts > 0:
-            # Set a retry object for all cluster nodes
-            self.retry = retry or Retry(
-                default_backoff(), connection_error_retry_attempts
+        if retry:
+            self.retry = retry
+        else:
+            self.retry = Retry(
+                backoff=ExponentialWithJitterBackoff(base=1, cap=10),
+                retries=cluster_error_retry_attempts,
             )
-            if not retry_on_error:
-                # Default errors for retrying
-                retry_on_error = [ConnectionError, TimeoutError]
+        if retry_on_error:
             self.retry.update_supported_errors(retry_on_error)
-            kwargs.update({"retry": self.retry})
 
         kwargs["response_callbacks"] = _RedisCallbacks.copy()
         if kwargs.get("protocol") in ["3", 3]:
@@ -389,8 +395,6 @@ def __init__(
         self.read_from_replicas = read_from_replicas
         self.load_balancing_strategy = load_balancing_strategy
         self.reinitialize_steps = reinitialize_steps
-        self.cluster_error_retry_attempts = cluster_error_retry_attempts
-        self.connection_error_retry_attempts = connection_error_retry_attempts
         self.reinitialize_counter = 0
         self.commands_parser = AsyncCommandsParser()
         self.node_flags = self.__class__.NODE_FLAGS.copy()
@@ -561,15 +565,8 @@ def get_connection_kwargs(self) -> Dict[str, Optional[Any]]:
         """Get the kwargs passed to :class:`~redis.asyncio.connection.Connection`."""
         return self.connection_kwargs
 
-    def get_retry(self) -> Optional["Retry"]:
-        return self.retry
-
-    def set_retry(self, retry: "Retry") -> None:
+    def set_retry(self, retry: Retry) -> None:
         self.retry = retry
-        for node in self.get_nodes():
-            node.connection_kwargs.update({"retry": retry})
-            for conn in node._connections:
-                conn.retry = retry
 
     def set_response_callback(self, command: str, callback: ResponseCallbackT) -> None:
         """Set a custom response callback."""
@@ -688,8 +685,8 @@ async def execute_command(self, *args: EncodableT, **kwargs: Any) -> Any:
         """
         Execute a raw command on the appropriate cluster node or target_nodes.
 
-        It will retry the command as specified by :attr:`cluster_error_retry_attempts` &
-        then raise an exception.
+        It will retry the command as specified by the retries property of
+        the :attr:`retry` & then raise an exception.
 
         :param args:
             | Raw command args
@@ -705,7 +702,7 @@ async def execute_command(self, *args: EncodableT, **kwargs: Any) -> Any:
         command = args[0]
         target_nodes = []
         target_nodes_specified = False
-        retry_attempts = self.cluster_error_retry_attempts
+        retry_attempts = self.retry.get_retries()
 
         passed_targets = kwargs.pop("target_nodes", None)
         if passed_targets and not self._is_node_flag(passed_targets):
@@ -1048,7 +1045,23 @@ def acquire_connection(self) -> Connection:
             return self._free.popleft()
         except IndexError:
             if len(self._connections) < self.max_connections:
-                connection = self.connection_class(**self.connection_kwargs)
+                # We are configuring the connection pool not to retry
+                # connections on lower level clients to avoid retrying
+                # connections to nodes that are not reachable
+                # and to avoid blocking the connection pool.
+                # The only error that will have some handling in the lower
+                # level clients is ConnectionError which will trigger disconnection
+                # of the socket.
+                # The retries will be handled on cluster client level
+                # where we will have proper handling of the cluster topology
+                retry = Retry(
+                    backoff=NoBackoff(),
+                    retries=0,
+                    supported_errors=(ConnectionError,),
+                )
+                connection_kwargs = self.connection_kwargs.copy()
+                connection_kwargs["retry"] = retry
+                connection = self.connection_class(**connection_kwargs)
                 self._connections.append(connection)
                 return connection
 
@@ -1544,7 +1557,7 @@ async def execute(
         """
         Execute the pipeline.
 
-        It will retry the commands as specified by :attr:`cluster_error_retry_attempts`
+        It will retry the commands as specified by retries specified in :attr:`retry`
         & then raise an exception.
 
         :param raise_on_error:
@@ -1560,7 +1573,7 @@ async def execute(
             return []
 
         try:
-            retry_attempts = self._client.cluster_error_retry_attempts
+            retry_attempts = self._client.retry.get_retries()
             while True:
                 try:
                     if self._client._initialize:
diff --git a/redis/asyncio/retry.py b/redis/asyncio/retry.py
index 7c5e3b0e7d..a20f8b4849 100644
--- a/redis/asyncio/retry.py
+++ b/redis/asyncio/retry.py
@@ -43,6 +43,18 @@ def update_supported_errors(self, specified_errors: list):
             set(self._supported_errors + tuple(specified_errors))
         )
 
+    def get_retries(self) -> int:
+        """
+        Get the number of retries.
+        """
+        return self._retries
+
+    def update_retries(self, value: int) -> None:
+        """
+        Set the number of retries.
+        """
+        self._retries = value
+
     async def call_with_retry(
         self, do: Callable[[], Awaitable[T]], fail: Callable[[RedisError], Any]
     ) -> T:
diff --git a/redis/cluster.py b/redis/cluster.py
index ae9720652a..c79f8e429d 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -9,7 +9,7 @@
 
 from redis._parsers import CommandsParser, Encoder
 from redis._parsers.helpers import parse_scan
-from redis.backoff import default_backoff
+from redis.backoff import ExponentialWithJitterBackoff, NoBackoff
 from redis.cache import CacheConfig, CacheFactory, CacheFactoryInterface, CacheInterface
 from redis.client import CaseInsensitiveDict, PubSub, Redis
 from redis.commands import READ_COMMANDS, RedisClusterCommands
@@ -179,7 +179,7 @@ def parse_cluster_myshardid(resp, **options):
     "cache",
     "cache_config",
 )
-KWARGS_DISABLED_KEYS = ("host", "port")
+KWARGS_DISABLED_KEYS = ("host", "port", "retry")
 
 
 def cleanup_kwargs(**kwargs):
@@ -436,7 +436,7 @@ def replace_default_node(self, target_node: "ClusterNode" = None) -> None:
                 # Choose a primary if the cluster contains different primaries
                 self.nodes_manager.default_node = random.choice(primaries)
             else:
-                # Otherwise, hoose a primary if the cluster contains different primaries
+                # Otherwise, choose a primary if the cluster contains different primaries
                 replicas = [node for node in self.get_replicas() if node != curr_node]
                 if replicas:
                     self.nodes_manager.default_node = random.choice(replicas)
@@ -492,6 +492,13 @@ class initializer. In the case of conflicting arguments, querystring
         reason="Please configure the 'load_balancing_strategy' instead",
         version="5.3.0",
     )
+    @deprecated_args(
+        args_to_warn=[
+            "cluster_error_retry_attempts",
+        ],
+        reason="Please configure the 'retry' object instead",
+        version="6.0.0",
+    )
     def __init__(
         self,
         host: Optional[str] = None,
@@ -549,9 +556,19 @@ def __init__(
              If you use dynamic DNS endpoints for startup nodes but CLUSTER SLOTS lists
              specific IP addresses, it is best to set it to false.
         :param cluster_error_retry_attempts:
+             @deprecated - Please configure the 'retry' object instead
+             In case 'retry' object is set - this argument is ignored!
+
              Number of times to retry before raising an error when
-             :class:`~.TimeoutError` or :class:`~.ConnectionError` or
+             :class:`~.TimeoutError` or :class:`~.ConnectionError`, :class:`~.SlotNotCoveredError` or
              :class:`~.ClusterDownError` are encountered
+        :param retry:
+            A retry object that defines the retry strategy and the number of
+            retries for the cluster client.
+            In current implementation for the cluster client (starting form redis-py version 6.0.0)
+            the retry object is not yet fully utilized, instead it is used just to determine
+            the number of retries for the cluster client.
+            In the future releases the retry object will be used to handle the cluster client retries!
         :param reinitialize_steps:
             Specifies the number of MOVED errors that need to occur before
             reinitializing the whole cluster topology. If a MOVED error occurs
@@ -571,7 +588,8 @@ def __init__(
 
          :**kwargs:
              Extra arguments that will be sent into Redis instance when created
-             (See Official redis-py doc for supported kwargs
+             (See Official redis-py doc for supported kwargs - the only limitation
+              is that you can't provide 'retry' object as part of kwargs.
          [https://github.com/andymccurdy/redis-py/blob/master/redis/client.py])
              Some kwargs are not supported and will raise a
              RedisClusterException:
@@ -586,6 +604,15 @@ def __init__(
                 "Argument 'db' is not possible to use in cluster mode"
             )
 
+        if "retry" in kwargs:
+            # Argument 'retry' is not possible to be used in kwargs when in cluster mode
+            # the kwargs are set to the lower level connections to the cluster nodes
+            # and there we provide retry configuration without retries allowed.
+            # The retries should be handled on cluster client level.
+            raise RedisClusterException(
+                "The 'retry' argument cannot be used in kwargs when running in cluster mode."
+            )
+
         # Get the startup node/s
         from_url = False
         if url is not None:
@@ -628,9 +655,11 @@ def __init__(
         kwargs = cleanup_kwargs(**kwargs)
         if retry:
             self.retry = retry
-            kwargs.update({"retry": self.retry})
         else:
-            kwargs.update({"retry": Retry(default_backoff(), 0)})
+            self.retry = Retry(
+                backoff=ExponentialWithJitterBackoff(base=1, cap=10),
+                retries=cluster_error_retry_attempts,
+            )
 
         self.encoder = Encoder(
             kwargs.get("encoding", "utf-8"),
@@ -641,7 +670,6 @@ def __init__(
         if (cache_config or cache) and protocol not in [3, "3"]:
             raise RedisError("Client caching is only supported with RESP version 3")
 
-        self.cluster_error_retry_attempts = cluster_error_retry_attempts
         self.command_flags = self.__class__.COMMAND_FLAGS.copy()
         self.node_flags = self.__class__.NODE_FLAGS.copy()
         self.read_from_replicas = read_from_replicas
@@ -772,13 +800,8 @@ def set_default_node(self, node):
         self.nodes_manager.default_node = node
         return True
 
-    def get_retry(self) -> Optional["Retry"]:
-        return self.retry
-
-    def set_retry(self, retry: "Retry") -> None:
+    def set_retry(self, retry: Retry) -> None:
         self.retry = retry
-        for node in self.get_nodes():
-            node.redis_connection.set_retry(retry)
 
     def monitor(self, target_node=None):
         """
@@ -825,10 +848,11 @@ def pipeline(self, transaction=None, shard_hint=None):
             startup_nodes=self.nodes_manager.startup_nodes,
             result_callbacks=self.result_callbacks,
             cluster_response_callbacks=self.cluster_response_callbacks,
-            cluster_error_retry_attempts=self.cluster_error_retry_attempts,
+            cluster_error_retry_attempts=self.retry.get_retries(),
             read_from_replicas=self.read_from_replicas,
             load_balancing_strategy=self.load_balancing_strategy,
             reinitialize_steps=self.reinitialize_steps,
+            retry=self.retry,
             lock=self._lock,
         )
 
@@ -1090,8 +1114,8 @@ def _internal_execute_command(self, *args, **kwargs):
         """
         Wrapper for ERRORS_ALLOW_RETRY error handling.
 
-        It will try the number of times specified by the config option
-        "self.cluster_error_retry_attempts" which defaults to 3 unless manually
+        It will try the number of times specified by the retries property from
+        config option "self.retry" which defaults to 3 unless manually
         configured.
 
         If it reaches the number of times, the command will raise the exception
@@ -1117,9 +1141,7 @@ def _internal_execute_command(self, *args, **kwargs):
         # execution since the nodes may not be valid anymore after the tables
         # were reinitialized. So in case of passed target nodes,
         # retry_attempts will be set to 0.
-        retry_attempts = (
-            0 if target_nodes_specified else self.cluster_error_retry_attempts
-        )
+        retry_attempts = 0 if target_nodes_specified else self.retry.get_retries()
         # Add one for the first execution
         execute_attempts = 1 + retry_attempts
         for _ in range(execute_attempts):
@@ -1333,8 +1355,12 @@ def __eq__(self, obj):
         return isinstance(obj, ClusterNode) and obj.name == self.name
 
     def __del__(self):
-        if self.redis_connection is not None:
-            self.redis_connection.close()
+        try:
+            if self.redis_connection is not None:
+                self.redis_connection.close()
+        except Exception:
+            # Ignore errors when closing the connection
+            pass
 
 
 class LoadBalancingStrategy(Enum):
@@ -1585,17 +1611,32 @@ def create_redis_connections(self, nodes):
         )
 
     def create_redis_node(self, host, port, **kwargs):
+        # We are configuring the connection pool not to retry
+        # connections on lower level clients to avoid retrying
+        # connections to nodes that are not reachable
+        # and to avoid blocking the connection pool.
+        # The only error that will have some handling in the lower
+        # level clients is ConnectionError which will trigger disconnection
+        # of the socket.
+        # The retries will be handled on cluster client level
+        # where we will have proper handling of the cluster topology
+        node_retry_config = Retry(
+            backoff=NoBackoff(), retries=0, supported_errors=(ConnectionError,)
+        )
+
         if self.from_url:
             # Create a redis node with a costumed connection pool
             kwargs.update({"host": host})
             kwargs.update({"port": port})
             kwargs.update({"cache": self._cache})
+            kwargs.update({"retry": node_retry_config})
             r = Redis(connection_pool=self.connection_pool_class(**kwargs))
         else:
             r = Redis(
                 host=host,
                 port=port,
                 cache=self._cache,
+                retry=node_retry_config,
                 **kwargs,
             )
         return r
@@ -2039,6 +2080,13 @@ class ClusterPipeline(RedisCluster):
         TryAgainError,
     )
 
+    @deprecated_args(
+        args_to_warn=[
+            "cluster_error_retry_attempts",
+        ],
+        reason="Please configure the 'retry' object instead",
+        version="6.0.0",
+    )
     def __init__(
         self,
         nodes_manager: "NodesManager",
@@ -2050,6 +2098,7 @@ def __init__(
         load_balancing_strategy: Optional[LoadBalancingStrategy] = None,
         cluster_error_retry_attempts: int = 3,
         reinitialize_steps: int = 5,
+        retry: Optional[Retry] = None,
         lock=None,
         **kwargs,
     ):
@@ -2066,9 +2115,16 @@ def __init__(
         self.load_balancing_strategy = load_balancing_strategy
         self.command_flags = self.__class__.COMMAND_FLAGS.copy()
         self.cluster_response_callbacks = cluster_response_callbacks
-        self.cluster_error_retry_attempts = cluster_error_retry_attempts
         self.reinitialize_counter = 0
         self.reinitialize_steps = reinitialize_steps
+        if retry is not None:
+            self.retry = retry
+        else:
+            self.retry = Retry(
+                backoff=ExponentialWithJitterBackoff(base=1, cap=10),
+                retries=self.cluster_error_retry_attempts,
+            )
+
         self.encoder = Encoder(
             kwargs.get("encoding", "utf-8"),
             kwargs.get("encoding_errors", "strict"),
@@ -2194,7 +2250,7 @@ def send_cluster_commands(
          - refereh_table_asap set to True
 
         It will try the number of times specified by
-        the config option "self.cluster_error_retry_attempts"
+        the retries in config option "self.retry"
         which defaults to 3 unless manually configured.
 
         If it reaches the number of times, the command will
@@ -2202,7 +2258,7 @@ def send_cluster_commands(
         """
         if not stack:
             return []
-        retry_attempts = self.cluster_error_retry_attempts
+        retry_attempts = self.retry.get_retries()
         while True:
             try:
                 return self._send_cluster_commands(
diff --git a/redis/commands/json/__init__.py b/redis/commands/json/__init__.py
index 01077e6b88..0e717b31d6 100644
--- a/redis/commands/json/__init__.py
+++ b/redis/commands/json/__init__.py
@@ -120,7 +120,7 @@ def pipeline(self, transaction=True, shard_hint=None):
                 startup_nodes=self.client.nodes_manager.startup_nodes,
                 result_callbacks=self.client.result_callbacks,
                 cluster_response_callbacks=self.client.cluster_response_callbacks,
-                cluster_error_retry_attempts=self.client.cluster_error_retry_attempts,
+                cluster_error_retry_attempts=self.client.retry.get_retries(),
                 read_from_replicas=self.client.read_from_replicas,
                 reinitialize_steps=self.client.reinitialize_steps,
                 lock=self.client._lock,
diff --git a/redis/commands/timeseries/__init__.py b/redis/commands/timeseries/__init__.py
index 4188b93d70..3fbf821172 100644
--- a/redis/commands/timeseries/__init__.py
+++ b/redis/commands/timeseries/__init__.py
@@ -84,7 +84,7 @@ def pipeline(self, transaction=True, shard_hint=None):
                 startup_nodes=self.client.nodes_manager.startup_nodes,
                 result_callbacks=self.client.result_callbacks,
                 cluster_response_callbacks=self.client.cluster_response_callbacks,
-                cluster_error_retry_attempts=self.client.cluster_error_retry_attempts,
+                cluster_error_retry_attempts=self.client.retry.get_retries(),
                 read_from_replicas=self.client.read_from_replicas,
                 reinitialize_steps=self.client.reinitialize_steps,
                 lock=self.client._lock,
diff --git a/redis/retry.py b/redis/retry.py
index 03fd973c4c..ca9ea76f24 100644
--- a/redis/retry.py
+++ b/redis/retry.py
@@ -44,6 +44,18 @@ def update_supported_errors(
             set(self._supported_errors + tuple(specified_errors))
         )
 
+    def get_retries(self) -> int:
+        """
+        Get the number of retries.
+        """
+        return self._retries
+
+    def update_retries(self, value: int) -> None:
+        """
+        Set the number of retries.
+        """
+        self._retries = value
+
     def call_with_retry(
         self,
         do: Callable[[], T],
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index a0429152ec..7d411b578b 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -13,7 +13,11 @@
 from redis.asyncio.cluster import ClusterNode, NodesManager, RedisCluster
 from redis.asyncio.connection import Connection, SSLConnection, async_timeout
 from redis.asyncio.retry import Retry
-from redis.backoff import ExponentialBackoff, NoBackoff, default_backoff
+from redis.backoff import (
+    ExponentialBackoff,
+    ExponentialWithJitterBackoff,
+    NoBackoff,
+)
 from redis.cluster import (
     PIPELINE_BLOCKED_COMMANDS,
     PRIMARY,
@@ -367,71 +371,79 @@ async def test_cluster_set_get_retry_object(self, request: FixtureRequest):
         retry = Retry(NoBackoff(), 2)
         url = request.config.getoption("--redis-url")
         async with RedisCluster.from_url(url, retry=retry) as r:
-            assert r.get_retry()._retries == retry._retries
-            assert isinstance(r.get_retry()._backoff, NoBackoff)
+            assert r.retry.get_retries() == retry.get_retries()
+            assert isinstance(r.retry._backoff, NoBackoff)
             for node in r.get_nodes():
-                n_retry = node.connection_kwargs.get("retry")
+                # validate nodes lower level connections default
+                # retry policy is applied
+                n_retry = node.acquire_connection().retry
                 assert n_retry is not None
-                assert n_retry._retries == retry._retries
+                assert n_retry._retries == 0
                 assert isinstance(n_retry._backoff, NoBackoff)
             rand_cluster_node = r.get_random_node()
             existing_conn = rand_cluster_node.acquire_connection()
             # Change retry policy
             new_retry = Retry(ExponentialBackoff(), 3)
             r.set_retry(new_retry)
-            assert r.get_retry()._retries == new_retry._retries
-            assert isinstance(r.get_retry()._backoff, ExponentialBackoff)
+            assert r.retry.get_retries() == new_retry.get_retries()
+            assert isinstance(r.retry._backoff, ExponentialBackoff)
             for node in r.get_nodes():
-                n_retry = node.connection_kwargs.get("retry")
+                # validate nodes lower level connections are not affected
+                n_retry = node.acquire_connection().retry
                 assert n_retry is not None
-                assert n_retry._retries == new_retry._retries
-                assert isinstance(n_retry._backoff, ExponentialBackoff)
-            assert existing_conn.retry._retries == new_retry._retries
+                assert n_retry._retries == 0
+                assert isinstance(n_retry._backoff, NoBackoff)
+            assert existing_conn.retry.get_retries() == 0
             new_conn = rand_cluster_node.acquire_connection()
-            assert new_conn.retry._retries == new_retry._retries
+            assert new_conn.retry._retries == 0
 
     async def test_cluster_retry_object(self, request: FixtureRequest) -> None:
         url = request.config.getoption("--redis-url")
         async with RedisCluster.from_url(url) as rc_default:
             # Test default retry
-            retry = rc_default.connection_kwargs.get("retry")
+            retry = rc_default.retry
 
             # FIXME: Workaround for https://github.com/redis/redis-py/issues/3030
             host = rc_default.get_default_node().host
 
             assert isinstance(retry, Retry)
             assert retry._retries == 3
-            assert isinstance(retry._backoff, type(default_backoff()))
-            assert rc_default.get_node(host, 16379).connection_kwargs.get(
-                "retry"
-            ) == rc_default.get_node(host, 16380).connection_kwargs.get("retry")
+            assert isinstance(retry._backoff, type(ExponentialWithJitterBackoff()))
+
+            # validate nodes connections are using the default retry for
+            # lower level connections when client is created through 'from_url' method
+            # without specified retry object
+            node1_retry = rc_default.get_node(host, 16379).acquire_connection().retry
+            node2_retry = rc_default.get_node(host, 16380).acquire_connection().retry
+            for node_retry in (node1_retry, node2_retry):
+                assert node_retry.get_retries() == 0
+                assert isinstance(node_retry._backoff, NoBackoff)
+                assert node_retry._supported_errors == (ConnectionError,)
 
         retry = Retry(ExponentialBackoff(10, 5), 5)
         async with RedisCluster.from_url(url, retry=retry) as rc_custom_retry:
             # Test custom retry
-            assert (
-                rc_custom_retry.get_node(host, 16379).connection_kwargs.get("retry")
-                == retry
-            )
+            assert rc_custom_retry.retry == retry
+            # validate nodes connections are using the default retry for
+            # lower level connections when client is created through 'from_url' method
+            # with specified retry object
+            node1_retry = rc_default.get_node(host, 16379).acquire_connection().retry
+            node2_retry = rc_default.get_node(host, 16380).acquire_connection().retry
+            for node_retry in (node1_retry, node2_retry):
+                assert node_retry.get_retries() == 0
+                assert isinstance(node_retry._backoff, NoBackoff)
+                assert node_retry._supported_errors == (ConnectionError,)
 
         async with RedisCluster.from_url(
-            url, connection_error_retry_attempts=0
+            url, cluster_error_retry_attempts=0
         ) as rc_no_retries:
-            # Test no connection retries
-            assert (
-                rc_no_retries.get_node(host, 16379).connection_kwargs.get("retry")
-                is None
-            )
+            # Test no cluster retries
+            assert rc_no_retries.retry.get_retries() == 0
 
         async with RedisCluster.from_url(
             url, retry=Retry(NoBackoff(), 0)
         ) as rc_no_retries:
-            assert (
-                rc_no_retries.get_node(host, 16379)
-                .connection_kwargs.get("retry")
-                ._retries
-                == 0
-            )
+            assert rc_no_retries.retry.get_retries() == 0
 
     async def test_empty_startup_nodes(self) -> None:
         """
@@ -2809,7 +2821,7 @@ async def test_multi_key_operation_with_multi_slots(self, r: RedisCluster) -> No
 
     async def test_cluster_down_error(self, r: RedisCluster) -> None:
         """
-        Test that the pipeline retries cluster_error_retry_attempts times before raising
+        Test that the pipeline retries the specified in retry object times before raising
         an error.
         """
         key = "foo"
@@ -2834,10 +2846,7 @@ async def parse_response(
             async with r.pipeline() as pipe:
                 with pytest.raises(ClusterDownError):
                     await pipe.get(key).execute()
-                assert (
-                    node.parse_response.await_count
-                    == 3 * r.cluster_error_retry_attempts + 1
-                )
+                assert node.parse_response.await_count == 3 * r.retry.get_retries() + 1
 
     async def test_connection_error_not_raised(self, r: RedisCluster) -> None:
         """Test ConnectionError handling with raise_on_error=False."""
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index d96342f87a..d4e48e199b 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -14,7 +14,11 @@
 import redis
 from redis import Redis
 from redis._parsers import CommandsParser
-from redis.backoff import ExponentialBackoff, NoBackoff, default_backoff
+from redis.backoff import (
+    ExponentialBackoff,
+    ExponentialWithJitterBackoff,
+    NoBackoff,
+)
 from redis.cluster import (
     PRIMARY,
     REDIS_CLUSTER_HASH_SLOTS,
@@ -884,46 +888,48 @@ def moved_redirect_effect(connection, *args, **options):
     def test_cluster_get_set_retry_object(self, request):
         retry = Retry(NoBackoff(), 2)
         r = _get_client(RedisCluster, request, retry=retry)
-        assert r.get_retry()._retries == retry._retries
-        assert isinstance(r.get_retry()._backoff, NoBackoff)
+        assert r.retry.get_retries() == retry.get_retries()
+        assert isinstance(r.retry._backoff, NoBackoff)
         for node in r.get_nodes():
-            assert node.redis_connection.get_retry()._retries == retry._retries
+            assert node.redis_connection.get_retry().get_retries() == 0
             assert isinstance(node.redis_connection.get_retry()._backoff, NoBackoff)
         rand_node = r.get_random_node()
         existing_conn = rand_node.redis_connection.connection_pool.get_connection()
         # Change retry policy
         new_retry = Retry(ExponentialBackoff(), 3)
         r.set_retry(new_retry)
-        assert r.get_retry()._retries == new_retry._retries
-        assert isinstance(r.get_retry()._backoff, ExponentialBackoff)
+        assert r.retry.get_retries() == new_retry.get_retries()
+        assert isinstance(r.retry._backoff, ExponentialBackoff)
         for node in r.get_nodes():
-            assert node.redis_connection.get_retry()._retries == new_retry._retries
-            assert isinstance(
-                node.redis_connection.get_retry()._backoff, ExponentialBackoff
-            )
-        assert existing_conn.retry._retries == new_retry._retries
+            assert node.redis_connection.get_retry()._retries == 0
+            assert isinstance(node.redis_connection.get_retry()._backoff, NoBackoff)
+        assert existing_conn.retry._retries == 0
         new_conn = rand_node.redis_connection.connection_pool.get_connection()
-        assert new_conn.retry._retries == new_retry._retries
+        assert new_conn.retry._retries == 0
 
     def test_cluster_retry_object(self, r) -> None:
         # Test default retry
         # FIXME: Workaround for https://github.com/redis/redis-py/issues/3030
         host = r.get_default_node().host
 
-        retry = r.get_connection_kwargs().get("retry")
+        # test default retry config
+        retry = r.retry
         assert isinstance(retry, Retry)
-        assert retry._retries == 0
-        assert isinstance(retry._backoff, type(default_backoff()))
-        node1 = r.get_node(host, 16379).redis_connection
-        node2 = r.get_node(host, 16380).redis_connection
-        assert node1.get_retry()._retries == node2.get_retry()._retries
-
-        # Test custom retry
+        assert retry.get_retries() == 3
+        assert isinstance(retry._backoff, type(ExponentialWithJitterBackoff()))
+        node1_connection = r.get_node(host, 16379).redis_connection
+        node2_connection = r.get_node(host, 16380).redis_connection
+        assert node1_connection.get_retry()._retries == 0
+        assert node2_connection.get_retry()._retries == 0
+
+        # Test custom retry is not applied to nodes
         retry = Retry(ExponentialBackoff(10, 5), 5)
         rc_custom_retry = RedisCluster(host, 16379, retry=retry)
         assert (
-            rc_custom_retry.get_node(host, 16379).redis_connection.get_retry()._retries
-            == retry._retries
+            rc_custom_retry.get_node(host, 16379)
+            .redis_connection.get_retry()
+            .get_retries()
+            == 0
         )
 
     def test_replace_cluster_node(self, r) -> None:
diff --git a/tests/test_retry.py b/tests/test_retry.py
index cb001fbbd5..926fe28313 100644
--- a/tests/test_retry.py
+++ b/tests/test_retry.py
@@ -203,6 +203,22 @@ def test_client_retry_on_timeout(self, request):
                 finally:
                     assert parse_response.call_count == retries + 1
 
+    @pytest.mark.onlycluster
+    def test_get_set_retry_object_for_cluster_client(self, request):
+        retry = Retry(NoBackoff(), 2)
+        r = _get_client(Redis, request, retry_on_timeout=True, retry=retry)
+        exist_conn = r.connection_pool.get_connection()
+        assert r.retry._retries == retry._retries
+        assert isinstance(r.retry._backoff, NoBackoff)
+        new_retry_policy = Retry(ExponentialBackoff(), 3)
+        r.set_retry(new_retry_policy)
+        assert r.retry._retries == new_retry_policy._retries
+        assert isinstance(r.retry._backoff, ExponentialBackoff)
+        assert exist_conn.retry._retries == new_retry_policy._retries
+        new_conn = r.connection_pool.get_connection()
+        assert new_conn.retry._retries == new_retry_policy._retries
+
+    @pytest.mark.onlynoncluster
     def test_get_set_retry_object(self, request):
         retry = Retry(NoBackoff(), 2)
         r = _get_client(Redis, request, retry_on_timeout=True, retry=retry)

From 120517f88671469888a747d8e1ca1d1c2348b301 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Wed, 30 Apr 2025 21:10:54 +0300
Subject: [PATCH 1043/1164] Changing the default value for ssl_check_hostname
 to True, to ensure security validations  are not skipped by default (#3626)

* Changing the default value for ssl_check_hostname to True, to ensure security validations  are not skipped by default

* Applying review comments

* Removing unused operation in tests.

* Removing unneeded comment from tests.
---
 docs/examples/ssl_connection_examples.ipynb | 19 ++++++++++-------
 redis/asyncio/client.py                     |  2 +-
 redis/asyncio/cluster.py                    |  2 +-
 redis/asyncio/connection.py                 |  2 +-
 redis/client.py                             |  2 +-
 redis/connection.py                         |  2 +-
 tests/test_asyncio/test_cluster.py          | 23 ++++++++++++++++++++-
 tests/test_asyncio/test_connect.py          | 13 +++++++++++-
 tests/test_connect.py                       | 10 +++++++++
 tests/test_ssl.py                           | 12 ++++++++++-
 10 files changed, 71 insertions(+), 16 deletions(-)

diff --git a/docs/examples/ssl_connection_examples.ipynb b/docs/examples/ssl_connection_examples.ipynb
index c94c4e0191..a09b87ec1f 100644
--- a/docs/examples/ssl_connection_examples.ipynb
+++ b/docs/examples/ssl_connection_examples.ipynb
@@ -34,9 +34,10 @@
     "import redis\n",
     "\n",
     "r = redis.Redis(\n",
-    "    host='localhost', \n",
-    "    port=6666, \n",
-    "    ssl=True, \n",
+    "    host='localhost',\n",
+    "    port=6666,\n",
+    "    ssl=True,\n",
+    "    ssl_check_hostname=False,\n",
     "    ssl_cert_reqs=\"none\",\n",
     ")\n",
     "r.ping()"
@@ -68,7 +69,7 @@
    "source": [
     "import redis\n",
     "\n",
-    "r = redis.from_url(\"rediss://localhost:6666?ssl_cert_reqs=none&decode_responses=True&health_check_interval=2\")\n",
+    "r = redis.from_url(\"rediss://localhost:6666?ssl_cert_reqs=none&ssl_check_hostname=False&decode_responses=True&health_check_interval=2\")\n",
     "r.ping()"
    ]
   },
@@ -99,13 +100,14 @@
     "import redis\n",
     "\n",
     "redis_pool = redis.ConnectionPool(\n",
-    "    host=\"localhost\", \n",
-    "    port=6666, \n",
-    "    connection_class=redis.SSLConnection, \n",
+    "    host=\"localhost\",\n",
+    "    port=6666,\n",
+    "    connection_class=redis.SSLConnection,\n",
+    "    ssl_check_hostname=False,\n",
     "    ssl_cert_reqs=\"none\",\n",
     ")\n",
     "\n",
-    "r = redis.StrictRedis(connection_pool=redis_pool) \n",
+    "r = redis.StrictRedis(connection_pool=redis_pool)\n",
     "r.ping()"
    ]
   },
@@ -141,6 +143,7 @@
     "    port=6666,\n",
     "    ssl=True,\n",
     "    ssl_min_version=ssl.TLSVersion.TLSv1_3,\n",
+    "    ssl_check_hostname=False,\n",
     "    ssl_cert_reqs=\"none\",\n",
     ")\n",
     "r.ping()"
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index ac907b0c10..1cb28e725e 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -241,7 +241,7 @@ def __init__(
         ssl_cert_reqs: Union[str, VerifyMode] = "required",
         ssl_ca_certs: Optional[str] = None,
         ssl_ca_data: Optional[str] = None,
-        ssl_check_hostname: bool = False,
+        ssl_check_hostname: bool = True,
         ssl_min_version: Optional[TLSVersion] = None,
         ssl_ciphers: Optional[str] = None,
         max_connections: Optional[int] = None,
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index cc5e15bb63..b066a100f6 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -280,7 +280,7 @@ def __init__(
         ssl_ca_data: Optional[str] = None,
         ssl_cert_reqs: Union[str, VerifyMode] = "required",
         ssl_certfile: Optional[str] = None,
-        ssl_check_hostname: bool = False,
+        ssl_check_hostname: bool = True,
         ssl_keyfile: Optional[str] = None,
         ssl_min_version: Optional[TLSVersion] = None,
         ssl_ciphers: Optional[str] = None,
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 70d7d91898..77131ab951 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -794,7 +794,7 @@ def __init__(
         ssl_cert_reqs: Union[str, ssl.VerifyMode] = "required",
         ssl_ca_certs: Optional[str] = None,
         ssl_ca_data: Optional[str] = None,
-        ssl_check_hostname: bool = False,
+        ssl_check_hostname: bool = True,
         ssl_min_version: Optional[TLSVersion] = None,
         ssl_ciphers: Optional[str] = None,
         **kwargs,
diff --git a/redis/client.py b/redis/client.py
index 138f561974..2ef95600c2 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -223,7 +223,7 @@ def __init__(
         ssl_ca_certs: Optional[str] = None,
         ssl_ca_path: Optional[str] = None,
         ssl_ca_data: Optional[str] = None,
-        ssl_check_hostname: bool = False,
+        ssl_check_hostname: bool = True,
         ssl_password: Optional[str] = None,
         ssl_validate_ocsp: bool = False,
         ssl_validate_ocsp_stapled: bool = False,
diff --git a/redis/connection.py b/redis/connection.py
index ddc6991c5c..dab45906d2 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1028,7 +1028,7 @@ def __init__(
         ssl_cert_reqs="required",
         ssl_ca_certs=None,
         ssl_ca_data=None,
-        ssl_check_hostname=False,
+        ssl_check_hostname=True,
         ssl_ca_path=None,
         ssl_password=None,
         ssl_validate_ocsp=False,
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 7d411b578b..aee9ebc86e 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -3118,7 +3118,9 @@ async def test_ssl_with_invalid_cert(
     async def test_ssl_connection(
         self, create_client: Callable[..., Awaitable[RedisCluster]]
     ) -> None:
-        async with await create_client(ssl=True, ssl_cert_reqs="none") as rc:
+        async with await create_client(
+            ssl=True, ssl_check_hostname=False, ssl_cert_reqs="none"
+        ) as rc:
             assert await rc.ping()
 
     @pytest.mark.parametrize(
@@ -3134,6 +3136,7 @@ async def test_ssl_connection_tls12_custom_ciphers(
     ) -> None:
         async with await create_client(
             ssl=True,
+            ssl_check_hostname=False,
             ssl_cert_reqs="none",
             ssl_min_version=ssl.TLSVersion.TLSv1_2,
             ssl_ciphers=ssl_ciphers,
@@ -3145,6 +3148,7 @@ async def test_ssl_connection_tls12_custom_ciphers_invalid(
     ) -> None:
         async with await create_client(
             ssl=True,
+            ssl_check_hostname=False,
             ssl_cert_reqs="none",
             ssl_min_version=ssl.TLSVersion.TLSv1_2,
             ssl_ciphers="foo:bar",
@@ -3166,6 +3170,7 @@ async def test_ssl_connection_tls13_custom_ciphers(
         # TLSv1.3 does not support changing the ciphers
         async with await create_client(
             ssl=True,
+            ssl_check_hostname=False,
             ssl_cert_reqs="none",
             ssl_min_version=ssl.TLSVersion.TLSv1_2,
             ssl_ciphers=ssl_ciphers,
@@ -3177,12 +3182,20 @@ async def test_ssl_connection_tls13_custom_ciphers(
     async def test_validating_self_signed_certificate(
         self, create_client: Callable[..., Awaitable[RedisCluster]]
     ) -> None:
+        # ssl_check_hostname=False is used to avoid hostname verification
+        # in the test environment, where the server certificate is self-signed
+        # and does not match the hostname that is extracted for the cluster.
+        # Cert hostname is 'localhost' in the cluster initialization when using
+        # 'localhost' it gets transformed into 127.0.0.1
+        # In production code, ssl_check_hostname should be set to True
+        # to ensure proper hostname verification.
         async with await create_client(
             ssl=True,
             ssl_ca_certs=self.ca_cert,
             ssl_cert_reqs="required",
             ssl_certfile=self.client_cert,
             ssl_keyfile=self.client_key,
+            ssl_check_hostname=False,
         ) as rc:
             assert await rc.ping()
 
@@ -3192,10 +3205,18 @@ async def test_validating_self_signed_string_certificate(
         with open(self.ca_cert) as f:
             cert_data = f.read()
 
+        # ssl_check_hostname=False is used to avoid hostname verification
+        # in the test environment, where the server certificate is self-signed
+        # and does not match the hostname that is extracted for the cluster.
+        # Cert hostname is 'localhost' in the cluster initialization when using
+        # 'localhost' it gets transformed into 127.0.0.1
+        # In production code, ssl_check_hostname should be set to True
+        # to ensure proper hostname verification.
         async with await create_client(
             ssl=True,
             ssl_ca_data=cert_data,
             ssl_cert_reqs="required",
+            ssl_check_hostname=False,
             ssl_certfile=self.client_cert,
             ssl_keyfile=self.client_key,
         ) as rc:
diff --git a/tests/test_asyncio/test_connect.py b/tests/test_asyncio/test_connect.py
index 6c4b3c33d7..62e8665d1f 100644
--- a/tests/test_asyncio/test_connect.py
+++ b/tests/test_asyncio/test_connect.py
@@ -58,6 +58,10 @@ async def test_uds_connect(uds_address):
 async def test_tcp_ssl_tls12_custom_ciphers(tcp_address, ssl_ciphers):
     host, port = tcp_address
 
+    # in order to have working hostname verification, we need to use "localhost"
+    # as redis host as the server certificate is self-signed and only valid for "localhost"
+    host = "localhost"
+
     server_certs = get_tls_certificates(cert_type=CertificateType.server)
 
     conn = SSLConnection(
@@ -89,6 +93,10 @@ async def test_tcp_ssl_tls12_custom_ciphers(tcp_address, ssl_ciphers):
 async def test_tcp_ssl_connect(tcp_address, ssl_min_version):
     host, port = tcp_address
 
+    # in order to have working hostname verification, we need to use "localhost"
+    # as redis host as the server certificate is self-signed and only valid for "localhost"
+    host = "localhost"
+
     server_certs = get_tls_certificates(cert_type=CertificateType.server)
 
     conn = SSLConnection(
@@ -100,7 +108,10 @@ async def test_tcp_ssl_connect(tcp_address, ssl_min_version):
         ssl_min_version=ssl_min_version,
     )
     await _assert_connect(
-        conn, tcp_address, certfile=server_certs.certfile, keyfile=server_certs.keyfile
+        conn,
+        tcp_address,
+        certfile=server_certs.certfile,
+        keyfile=server_certs.keyfile,
     )
     await conn.disconnect()
 
diff --git a/tests/test_connect.py b/tests/test_connect.py
index f3c02b330f..1e1c23c87e 100644
--- a/tests/test_connect.py
+++ b/tests/test_connect.py
@@ -54,10 +54,16 @@ def test_uds_connect(uds_address):
 )
 def test_tcp_ssl_connect(tcp_address, ssl_min_version):
     host, port = tcp_address
+
+    # in order to have working hostname verification, we need to use "localhost"
+    # as redis host as the server certificate is self-signed and only valid for "localhost"
+    host = "localhost"
     server_certs = get_tls_certificates(cert_type=CertificateType.server)
+
     conn = SSLConnection(
         host=host,
         port=port,
+        ssl_check_hostname=True,
         client_name=_CLIENT_NAME,
         ssl_ca_certs=server_certs.ca_certfile,
         socket_timeout=10,
@@ -80,6 +86,10 @@ def test_tcp_ssl_connect(tcp_address, ssl_min_version):
 def test_tcp_ssl_tls12_custom_ciphers(tcp_address, ssl_ciphers):
     host, port = tcp_address
 
+    # in order to have working hostname verification, we need to use "localhost"
+    # as redis host as the server certificate is self-signed and only valid for "localhost"
+    host = "localhost"
+
     server_certs = get_tls_certificates(cert_type=CertificateType.server)
 
     conn = SSLConnection(
diff --git a/tests/test_ssl.py b/tests/test_ssl.py
index 2a945ac287..5aa33353a8 100644
--- a/tests/test_ssl.py
+++ b/tests/test_ssl.py
@@ -37,7 +37,14 @@ def test_ssl_with_invalid_cert(self, request):
     def test_ssl_connection(self, request):
         ssl_url = request.config.option.redis_ssl_url
         p = urlparse(ssl_url)[1].split(":")
-        r = redis.Redis(host=p[0], port=p[1], ssl=True, ssl_cert_reqs="none")
+
+        r = redis.Redis(
+            host=p[0],
+            port=p[1],
+            ssl=True,
+            ssl_check_hostname=False,
+            ssl_cert_reqs="none",
+        )
         assert r.ping()
         r.close()
 
@@ -98,6 +105,7 @@ def test_ssl_connection_tls12_custom_ciphers(self, request, ssl_ciphers):
             host=p[0],
             port=p[1],
             ssl=True,
+            ssl_check_hostname=False,
             ssl_cert_reqs="none",
             ssl_min_version=ssl.TLSVersion.TLSv1_3,
             ssl_ciphers=ssl_ciphers,
@@ -112,6 +120,7 @@ def test_ssl_connection_tls12_custom_ciphers_invalid(self, request):
             host=p[0],
             port=p[1],
             ssl=True,
+            ssl_check_hostname=False,
             ssl_cert_reqs="none",
             ssl_min_version=ssl.TLSVersion.TLSv1_2,
             ssl_ciphers="foo:bar",
@@ -136,6 +145,7 @@ def test_ssl_connection_tls13_custom_ciphers(self, request, ssl_ciphers):
             host=p[0],
             port=p[1],
             ssl=True,
+            ssl_check_hostname=False,
             ssl_cert_reqs="none",
             ssl_min_version=ssl.TLSVersion.TLSv1_2,
             ssl_ciphers=ssl_ciphers,

From 37491a49759912b658a3f03140c7c3ff53229b86 Mon Sep 17 00:00:00 2001
From: Ivana Kellyer <ivana.kellyer@sentry.io>
Date: Mon, 5 May 2025 16:18:09 +0200
Subject: [PATCH 1044/1164] Fix AttributeError on ClusterPipeline (#3634)

---
 redis/cluster.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index c79f8e429d..99e5c37f9d 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -2122,7 +2122,7 @@ def __init__(
         else:
             self.retry = Retry(
                 backoff=ExponentialWithJitterBackoff(base=1, cap=10),
-                retries=self.cluster_error_retry_attempts,
+                retries=cluster_error_retry_attempts,
             )
 
         self.encoder = Encoder(

From a1f3cabf3e4e009c810d15e3972119287d8ad96f Mon Sep 17 00:00:00 2001
From: Terence Honles <terence@honles.com>
Date: Wed, 7 May 2025 09:51:09 +0200
Subject: [PATCH 1045/1164] add equality and hashability to ``Retry`` and
 backoff classes (#3628)

---
 redis/backoff.py    | 54 +++++++++++++++++++++++++++++++++++++++++++++
 redis/retry.py      | 13 +++++++++++
 tests/test_retry.py | 45 ++++++++++++++++++++++++++++++++++++-
 3 files changed, 111 insertions(+), 1 deletion(-)

diff --git a/redis/backoff.py b/redis/backoff.py
index e236764d71..22a3ed0abb 100644
--- a/redis/backoff.py
+++ b/redis/backoff.py
@@ -31,6 +31,15 @@ def __init__(self, backoff: float) -> None:
         """`backoff`: backoff time in seconds"""
         self._backoff = backoff
 
+    def __hash__(self) -> int:
+        return hash((self._backoff,))
+
+    def __eq__(self, other) -> bool:
+        if not isinstance(other, ConstantBackoff):
+            return NotImplemented
+
+        return self._backoff == other._backoff
+
     def compute(self, failures: int) -> float:
         return self._backoff
 
@@ -53,6 +62,15 @@ def __init__(self, cap: float = DEFAULT_CAP, base: float = DEFAULT_BASE):
         self._cap = cap
         self._base = base
 
+    def __hash__(self) -> int:
+        return hash((self._base, self._cap))
+
+    def __eq__(self, other) -> bool:
+        if not isinstance(other, ExponentialBackoff):
+            return NotImplemented
+
+        return self._base == other._base and self._cap == other._cap
+
     def compute(self, failures: int) -> float:
         return min(self._cap, self._base * 2**failures)
 
@@ -68,6 +86,15 @@ def __init__(self, cap: float = DEFAULT_CAP, base: float = DEFAULT_BASE) -> None
         self._cap = cap
         self._base = base
 
+    def __hash__(self) -> int:
+        return hash((self._base, self._cap))
+
+    def __eq__(self, other) -> bool:
+        if not isinstance(other, FullJitterBackoff):
+            return NotImplemented
+
+        return self._base == other._base and self._cap == other._cap
+
     def compute(self, failures: int) -> float:
         return random.uniform(0, min(self._cap, self._base * 2**failures))
 
@@ -83,6 +110,15 @@ def __init__(self, cap: float = DEFAULT_CAP, base: float = DEFAULT_BASE) -> None
         self._cap = cap
         self._base = base
 
+    def __hash__(self) -> int:
+        return hash((self._base, self._cap))
+
+    def __eq__(self, other) -> bool:
+        if not isinstance(other, EqualJitterBackoff):
+            return NotImplemented
+
+        return self._base == other._base and self._cap == other._cap
+
     def compute(self, failures: int) -> float:
         temp = min(self._cap, self._base * 2**failures) / 2
         return temp + random.uniform(0, temp)
@@ -100,6 +136,15 @@ def __init__(self, cap: float = DEFAULT_CAP, base: float = DEFAULT_BASE) -> None
         self._base = base
         self._previous_backoff = 0
 
+    def __hash__(self) -> int:
+        return hash((self._base, self._cap))
+
+    def __eq__(self, other) -> bool:
+        if not isinstance(other, DecorrelatedJitterBackoff):
+            return NotImplemented
+
+        return self._base == other._base and self._cap == other._cap
+
     def reset(self) -> None:
         self._previous_backoff = 0
 
@@ -121,6 +166,15 @@ def __init__(self, cap: float = DEFAULT_CAP, base: float = DEFAULT_BASE) -> None
         self._cap = cap
         self._base = base
 
+    def __hash__(self) -> int:
+        return hash((self._base, self._cap))
+
+    def __eq__(self, other) -> bool:
+        if not isinstance(other, EqualJitterBackoff):
+            return NotImplemented
+
+        return self._base == other._base and self._cap == other._cap
+
     def compute(self, failures: int) -> float:
         return min(self._cap, random.random() * self._base * 2**failures)
 
diff --git a/redis/retry.py b/redis/retry.py
index ca9ea76f24..c93f34e65f 100644
--- a/redis/retry.py
+++ b/redis/retry.py
@@ -34,6 +34,19 @@ def __init__(
         self._retries = retries
         self._supported_errors = supported_errors
 
+    def __eq__(self, other: Any) -> bool:
+        if not isinstance(other, Retry):
+            return NotImplemented
+
+        return (
+            self._backoff == other._backoff
+            and self._retries == other._retries
+            and set(self._supported_errors) == set(other._supported_errors)
+        )
+
+    def __hash__(self) -> int:
+        return hash((self._backoff, self._retries, frozenset(self._supported_errors)))
+
     def update_supported_errors(
         self, specified_errors: Iterable[Type[Exception]]
     ) -> None:
diff --git a/tests/test_retry.py b/tests/test_retry.py
index 926fe28313..4f4f04caca 100644
--- a/tests/test_retry.py
+++ b/tests/test_retry.py
@@ -1,7 +1,16 @@
 from unittest.mock import patch
 
 import pytest
-from redis.backoff import AbstractBackoff, ExponentialBackoff, NoBackoff
+from redis.backoff import (
+    AbstractBackoff,
+    ConstantBackoff,
+    DecorrelatedJitterBackoff,
+    EqualJitterBackoff,
+    ExponentialBackoff,
+    ExponentialWithJitterBackoff,
+    FullJitterBackoff,
+    NoBackoff,
+)
 from redis.client import Redis
 from redis.connection import Connection, UnixDomainSocketConnection
 from redis.exceptions import (
@@ -80,6 +89,40 @@ def test_retry_on_error_retry(self, Class, retries):
         assert c.retry._retries == retries
 
 
+@pytest.mark.parametrize(
+    "args",
+    [
+        (ConstantBackoff(0), 0),
+        (ConstantBackoff(10), 5),
+        (NoBackoff(), 0),
+    ]
+    + [
+        backoff
+        for Backoff in (
+            DecorrelatedJitterBackoff,
+            EqualJitterBackoff,
+            ExponentialBackoff,
+            ExponentialWithJitterBackoff,
+            FullJitterBackoff,
+        )
+        for backoff in ((Backoff(), 2), (Backoff(25), 5), (Backoff(25, 5), 5))
+    ],
+)
+def test_retry_eq_and_hashable(args):
+    assert Retry(*args) == Retry(*args)
+
+    # create another retry object with different parameters
+    copy = list(args)
+    if isinstance(copy[0], ConstantBackoff):
+        copy[1] = 9000
+    else:
+        copy[0] = ConstantBackoff(9000)
+
+    assert Retry(*args) != Retry(*copy)
+    assert Retry(*copy) != Retry(*args)
+    assert len({Retry(*args), Retry(*args), Retry(*copy), Retry(*copy)}) == 2
+
+
 class TestRetry:
     "Test that Retry calls backoff and retries the expected number of times"
 

From cfe06959991c54f7434c568ccd0e60aa76c9c8d9 Mon Sep 17 00:00:00 2001
From: kesha1225 <48860626+kesha1225@users.noreply.github.com>
Date: Thu, 8 May 2025 10:35:48 +0300
Subject: [PATCH 1046/1164] Change type hints with possible None args or return
 types to be annotated with Optional - includes commands in core.py and json
 commands (#3610)

* fix(redis-client): change `zrange` num parameter type to `Optional[int]`

* fix(redis-client): normalize optional parameter annotations

Replace all occurrences of Union[T, None] = None and bare T = None
with Optional[T] = None in zrange, _zrange, arrtrim, and other methods
so that type checkers no longer report errors.

* commit message: fix(redis-client): normalize optional parameter annotations and correct arrtrim return type
body: replaced all Union[T, None] = None and bare T = None with Optional[T] = None; changed arrtrim return annotation to Optional[int]

* fix(redis-client): replace Optional[None] with Optional[int] for numeric parameters
---
 CHANGES                         |   1 +
 redis/commands/core.py          | 208 ++++++++++++++++----------------
 redis/commands/json/commands.py |  16 +--
 3 files changed, 113 insertions(+), 112 deletions(-)

diff --git a/CHANGES b/CHANGES
index 24b52c54db..7ce774621d 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1146,3 +1146,4 @@ incompatible in code using*SCAN commands loops such as
   * Implemented STRLEN
   * Implemented PERSIST
   * Implemented SETRANGE
+  * Changed type annotation of the `num` parameter in `zrange` from `int` to `Optional[int]
\ No newline at end of file
diff --git a/redis/commands/core.py b/redis/commands/core.py
index a8c327f08f..378898272f 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -63,7 +63,7 @@ class ACLCommands(CommandsProtocol):
     see: https://redis.io/topics/acl
     """
 
-    def acl_cat(self, category: Union[str, None] = None, **kwargs) -> ResponseT:
+    def acl_cat(self, category: Optional[str] = None, **kwargs) -> ResponseT:
         """
         Returns a list of categories or commands within a category.
 
@@ -92,7 +92,7 @@ def acl_deluser(self, *username: str, **kwargs) -> ResponseT:
         """
         return self.execute_command("ACL DELUSER", *username, **kwargs)
 
-    def acl_genpass(self, bits: Union[int, None] = None, **kwargs) -> ResponseT:
+    def acl_genpass(self, bits: Optional[int] = None, **kwargs) -> ResponseT:
         """Generate a random password value.
         If ``bits`` is supplied then use this number of bits, rounded to
         the next multiple of 4.
@@ -137,7 +137,7 @@ def acl_list(self, **kwargs) -> ResponseT:
         """
         return self.execute_command("ACL LIST", **kwargs)
 
-    def acl_log(self, count: Union[int, None] = None, **kwargs) -> ResponseT:
+    def acl_log(self, count: Optional[int] = None, **kwargs) -> ResponseT:
         """
         Get ACL logs as a list.
         :param int count: Get logs[0:count].
@@ -190,8 +190,8 @@ def acl_setuser(
         username: str,
         enabled: bool = False,
         nopass: bool = False,
-        passwords: Union[str, Iterable[str], None] = None,
-        hashed_passwords: Union[str, Iterable[str], None] = None,
+        passwords: Optional[Union[str, Iterable[str]]] = None,
+        hashed_passwords: Optional[Union[str, Iterable[str]]] = None,
         categories: Optional[Iterable[str]] = None,
         commands: Optional[Iterable[str]] = None,
         keys: Optional[Iterable[KeyT]] = None,
@@ -450,13 +450,13 @@ def client_kill(self, address: str, **kwargs) -> ResponseT:
 
     def client_kill_filter(
         self,
-        _id: Union[str, None] = None,
-        _type: Union[str, None] = None,
-        addr: Union[str, None] = None,
-        skipme: Union[bool, None] = None,
-        laddr: Union[bool, None] = None,
-        user: str = None,
-        maxage: Union[int, None] = None,
+        _id: Optional[str] = None,
+        _type: Optional[str] = None,
+        addr: Optional[str] = None,
+        skipme: Optional[bool] = None,
+        laddr: Optional[bool] = None,
+        user: Optional[str] = None,
+        maxage: Optional[int] = None,
         **kwargs,
     ) -> ResponseT:
         """
@@ -512,7 +512,7 @@ def client_info(self, **kwargs) -> ResponseT:
         return self.execute_command("CLIENT INFO", **kwargs)
 
     def client_list(
-        self, _type: Union[str, None] = None, client_id: List[EncodableT] = [], **kwargs
+        self, _type: Optional[str] = None, client_id: List[EncodableT] = [], **kwargs
     ) -> ResponseT:
         """
         Returns a list of currently connected clients.
@@ -589,7 +589,7 @@ def client_id(self, **kwargs) -> ResponseT:
 
     def client_tracking_on(
         self,
-        clientid: Union[int, None] = None,
+        clientid: Optional[int] = None,
         prefix: Sequence[KeyT] = [],
         bcast: bool = False,
         optin: bool = False,
@@ -608,7 +608,7 @@ def client_tracking_on(
 
     def client_tracking_off(
         self,
-        clientid: Union[int, None] = None,
+        clientid: Optional[int] = None,
         prefix: Sequence[KeyT] = [],
         bcast: bool = False,
         optin: bool = False,
@@ -628,7 +628,7 @@ def client_tracking_off(
     def client_tracking(
         self,
         on: bool = True,
-        clientid: Union[int, None] = None,
+        clientid: Optional[int] = None,
         prefix: Sequence[KeyT] = [],
         bcast: bool = False,
         optin: bool = False,
@@ -988,7 +988,7 @@ def select(self, index: int, **kwargs) -> ResponseT:
         return self.execute_command("SELECT", index, **kwargs)
 
     def info(
-        self, section: Union[str, None] = None, *args: List[str], **kwargs
+        self, section: Optional[str] = None, *args: List[str], **kwargs
     ) -> ResponseT:
         """
         Returns a dictionary containing information about the Redis server
@@ -1070,7 +1070,7 @@ def migrate(
         timeout: int,
         copy: bool = False,
         replace: bool = False,
-        auth: Union[str, None] = None,
+        auth: Optional[str] = None,
         **kwargs,
     ) -> ResponseT:
         """
@@ -1152,7 +1152,7 @@ def memory_malloc_stats(self, **kwargs) -> ResponseT:
         return self.execute_command("MEMORY MALLOC-STATS", **kwargs)
 
     def memory_usage(
-        self, key: KeyT, samples: Union[int, None] = None, **kwargs
+        self, key: KeyT, samples: Optional[int] = None, **kwargs
     ) -> ResponseT:
         """
         Return the total memory usage for key, its value and associated
@@ -1291,7 +1291,7 @@ def shutdown(
         raise RedisError("SHUTDOWN seems to have failed.")
 
     def slaveof(
-        self, host: Union[str, None] = None, port: Union[int, None] = None, **kwargs
+        self, host: Optional[str] = None, port: Optional[int] = None, **kwargs
     ) -> ResponseT:
         """
         Set the server to be a replicated slave of the instance identified
@@ -1304,7 +1304,7 @@ def slaveof(
             return self.execute_command("SLAVEOF", b"NO", b"ONE", **kwargs)
         return self.execute_command("SLAVEOF", host, port, **kwargs)
 
-    def slowlog_get(self, num: Union[int, None] = None, **kwargs) -> ResponseT:
+    def slowlog_get(self, num: Optional[int] = None, **kwargs) -> ResponseT:
         """
         Get the entries from the slowlog. If ``num`` is specified, get the
         most recent ``num`` items.
@@ -1451,7 +1451,7 @@ def __init__(
         self,
         client: Union["redis.client.Redis", "redis.asyncio.client.Redis"],
         key: str,
-        default_overflow: Union[str, None] = None,
+        default_overflow: Optional[str] = None,
     ):
         self.client = client
         self.key = key
@@ -1487,7 +1487,7 @@ def incrby(
         fmt: str,
         offset: BitfieldOffsetT,
         increment: int,
-        overflow: Union[str, None] = None,
+        overflow: Optional[str] = None,
     ):
         """
         Increment a bitfield by a given amount.
@@ -1572,8 +1572,8 @@ def append(self, key: KeyT, value: EncodableT) -> ResponseT:
     def bitcount(
         self,
         key: KeyT,
-        start: Union[int, None] = None,
-        end: Union[int, None] = None,
+        start: Optional[int] = None,
+        end: Optional[int] = None,
         mode: Optional[str] = None,
     ) -> ResponseT:
         """
@@ -1595,7 +1595,7 @@ def bitcount(
     def bitfield(
         self: Union["redis.client.Redis", "redis.asyncio.client.Redis"],
         key: KeyT,
-        default_overflow: Union[str, None] = None,
+        default_overflow: Optional[str] = None,
     ) -> BitFieldOperation:
         """
         Return a BitFieldOperation instance to conveniently construct one or
@@ -1641,8 +1641,8 @@ def bitpos(
         self,
         key: KeyT,
         bit: int,
-        start: Union[int, None] = None,
-        end: Union[int, None] = None,
+        start: Optional[int] = None,
+        end: Optional[int] = None,
         mode: Optional[str] = None,
     ) -> ResponseT:
         """
@@ -1672,7 +1672,7 @@ def copy(
         self,
         source: str,
         destination: str,
-        destination_db: Union[str, None] = None,
+        destination_db: Optional[str] = None,
         replace: bool = False,
     ) -> ResponseT:
         """
@@ -2137,7 +2137,7 @@ def pttl(self, name: KeyT) -> ResponseT:
         return self.execute_command("PTTL", name)
 
     def hrandfield(
-        self, key: str, count: int = None, withvalues: bool = False
+        self, key: str, count: Optional[int] = None, withvalues: bool = False
     ) -> ResponseT:
         """
         Return a random field from the hash value stored at key.
@@ -2191,8 +2191,8 @@ def restore(
         value: EncodableT,
         replace: bool = False,
         absttl: bool = False,
-        idletime: Union[int, None] = None,
-        frequency: Union[int, None] = None,
+        idletime: Optional[int] = None,
+        frequency: Optional[int] = None,
     ) -> ResponseT:
         """
         Create a key using the provided serialized value, previously obtained
@@ -2360,7 +2360,7 @@ def stralgo(
         specific_argument: Union[Literal["strings"], Literal["keys"]] = "strings",
         len: bool = False,
         idx: bool = False,
-        minmatchlen: Union[int, None] = None,
+        minmatchlen: Optional[int] = None,
         withmatchlen: bool = False,
         **kwargs,
     ) -> ResponseT:
@@ -2960,8 +2960,8 @@ def scan(
         self,
         cursor: int = 0,
         match: Union[PatternT, None] = None,
-        count: Union[int, None] = None,
-        _type: Union[str, None] = None,
+        count: Optional[int] = None,
+        _type: Optional[str] = None,
         **kwargs,
     ) -> ResponseT:
         """
@@ -2992,8 +2992,8 @@ def scan(
     def scan_iter(
         self,
         match: Union[PatternT, None] = None,
-        count: Union[int, None] = None,
-        _type: Union[str, None] = None,
+        count: Optional[int] = None,
+        _type: Optional[str] = None,
         **kwargs,
     ) -> Iterator:
         """
@@ -3022,7 +3022,7 @@ def sscan(
         name: KeyT,
         cursor: int = 0,
         match: Union[PatternT, None] = None,
-        count: Union[int, None] = None,
+        count: Optional[int] = None,
     ) -> ResponseT:
         """
         Incrementally return lists of elements in a set. Also return a cursor
@@ -3045,7 +3045,7 @@ def sscan_iter(
         self,
         name: KeyT,
         match: Union[PatternT, None] = None,
-        count: Union[int, None] = None,
+        count: Optional[int] = None,
     ) -> Iterator:
         """
         Make an iterator using the SSCAN command so that the client doesn't
@@ -3065,7 +3065,7 @@ def hscan(
         name: KeyT,
         cursor: int = 0,
         match: Union[PatternT, None] = None,
-        count: Union[int, None] = None,
+        count: Optional[int] = None,
         no_values: Union[bool, None] = None,
     ) -> ResponseT:
         """
@@ -3093,7 +3093,7 @@ def hscan_iter(
         self,
         name: str,
         match: Union[PatternT, None] = None,
-        count: Union[int, None] = None,
+        count: Optional[int] = None,
         no_values: Union[bool, None] = None,
     ) -> Iterator:
         """
@@ -3121,7 +3121,7 @@ def zscan(
         name: KeyT,
         cursor: int = 0,
         match: Union[PatternT, None] = None,
-        count: Union[int, None] = None,
+        count: Optional[int] = None,
         score_cast_func: Union[type, Callable] = float,
     ) -> ResponseT:
         """
@@ -3148,7 +3148,7 @@ def zscan_iter(
         self,
         name: KeyT,
         match: Union[PatternT, None] = None,
-        count: Union[int, None] = None,
+        count: Optional[int] = None,
         score_cast_func: Union[type, Callable] = float,
     ) -> Iterator:
         """
@@ -3177,8 +3177,8 @@ class AsyncScanCommands(ScanCommands):
     async def scan_iter(
         self,
         match: Union[PatternT, None] = None,
-        count: Union[int, None] = None,
-        _type: Union[str, None] = None,
+        count: Optional[int] = None,
+        _type: Optional[str] = None,
         **kwargs,
     ) -> AsyncIterator:
         """
@@ -3207,7 +3207,7 @@ async def sscan_iter(
         self,
         name: KeyT,
         match: Union[PatternT, None] = None,
-        count: Union[int, None] = None,
+        count: Optional[int] = None,
     ) -> AsyncIterator:
         """
         Make an iterator using the SSCAN command so that the client doesn't
@@ -3229,7 +3229,7 @@ async def hscan_iter(
         self,
         name: str,
         match: Union[PatternT, None] = None,
-        count: Union[int, None] = None,
+        count: Optional[int] = None,
         no_values: Union[bool, None] = None,
     ) -> AsyncIterator:
         """
@@ -3258,7 +3258,7 @@ async def zscan_iter(
         self,
         name: KeyT,
         match: Union[PatternT, None] = None,
-        count: Union[int, None] = None,
+        count: Optional[int] = None,
         score_cast_func: Union[type, Callable] = float,
     ) -> AsyncIterator:
         """
@@ -3489,11 +3489,11 @@ def xadd(
         name: KeyT,
         fields: Dict[FieldT, EncodableT],
         id: StreamIdT = "*",
-        maxlen: Union[int, None] = None,
+        maxlen: Optional[int] = None,
         approximate: bool = True,
         nomkstream: bool = False,
         minid: Union[StreamIdT, None] = None,
-        limit: Union[int, None] = None,
+        limit: Optional[int] = None,
     ) -> ResponseT:
         """
         Add to a stream.
@@ -3544,7 +3544,7 @@ def xautoclaim(
         consumername: ConsumerT,
         min_idle_time: int,
         start_id: StreamIdT = "0-0",
-        count: Union[int, None] = None,
+        count: Optional[int] = None,
         justid: bool = False,
     ) -> ResponseT:
         """
@@ -3595,9 +3595,9 @@ def xclaim(
         consumername: ConsumerT,
         min_idle_time: int,
         message_ids: Union[List[StreamIdT], Tuple[StreamIdT]],
-        idle: Union[int, None] = None,
-        time: Union[int, None] = None,
-        retrycount: Union[int, None] = None,
+        idle: Optional[int] = None,
+        time: Optional[int] = None,
+        retrycount: Optional[int] = None,
         force: bool = False,
         justid: bool = False,
     ) -> ResponseT:
@@ -3829,7 +3829,7 @@ def xpending_range(
         max: StreamIdT,
         count: int,
         consumername: Union[ConsumerT, None] = None,
-        idle: Union[int, None] = None,
+        idle: Optional[int] = None,
     ) -> ResponseT:
         """
         Returns information about pending messages, in a range.
@@ -3883,7 +3883,7 @@ def xrange(
         name: KeyT,
         min: StreamIdT = "-",
         max: StreamIdT = "+",
-        count: Union[int, None] = None,
+        count: Optional[int] = None,
     ) -> ResponseT:
         """
         Read stream values within an interval.
@@ -3913,8 +3913,8 @@ def xrange(
     def xread(
         self,
         streams: Dict[KeyT, StreamIdT],
-        count: Union[int, None] = None,
-        block: Union[int, None] = None,
+        count: Optional[int] = None,
+        block: Optional[int] = None,
     ) -> ResponseT:
         """
         Block and monitor multiple streams for new data.
@@ -3953,8 +3953,8 @@ def xreadgroup(
         groupname: str,
         consumername: str,
         streams: Dict[KeyT, StreamIdT],
-        count: Union[int, None] = None,
-        block: Union[int, None] = None,
+        count: Optional[int] = None,
+        block: Optional[int] = None,
         noack: bool = False,
     ) -> ResponseT:
         """
@@ -4000,7 +4000,7 @@ def xrevrange(
         name: KeyT,
         max: StreamIdT = "+",
         min: StreamIdT = "-",
-        count: Union[int, None] = None,
+        count: Optional[int] = None,
     ) -> ResponseT:
         """
         Read stream values within an interval, in reverse order.
@@ -4030,10 +4030,10 @@ def xrevrange(
     def xtrim(
         self,
         name: KeyT,
-        maxlen: Union[int, None] = None,
+        maxlen: Optional[int] = None,
         approximate: bool = True,
         minid: Union[StreamIdT, None] = None,
-        limit: Union[int, None] = None,
+        limit: Optional[int] = None,
     ) -> ResponseT:
         """
         Trims old messages from a stream.
@@ -4205,7 +4205,7 @@ def zincrby(self, name: KeyT, amount: float, value: EncodableT) -> ResponseT:
         return self.execute_command("ZINCRBY", name, amount, value)
 
     def zinter(
-        self, keys: KeysT, aggregate: Union[str, None] = None, withscores: bool = False
+        self, keys: KeysT, aggregate: Optional[str] = None, withscores: bool = False
     ) -> ResponseT:
         """
         Return the intersect of multiple sorted sets specified by ``keys``.
@@ -4224,7 +4224,7 @@ def zinterstore(
         self,
         dest: KeyT,
         keys: Union[Sequence[KeyT], Mapping[AnyKeyT, float]],
-        aggregate: Union[str, None] = None,
+        aggregate: Optional[str] = None,
     ) -> ResponseT:
         """
         Intersect multiple sorted sets specified by ``keys`` into a new
@@ -4263,7 +4263,7 @@ def zlexcount(self, name, min, max):
         """
         return self.execute_command("ZLEXCOUNT", name, min, max, keys=[name])
 
-    def zpopmax(self, name: KeyT, count: Union[int, None] = None) -> ResponseT:
+    def zpopmax(self, name: KeyT, count: Optional[int] = None) -> ResponseT:
         """
         Remove and return up to ``count`` members with the highest scores
         from the sorted set ``name``.
@@ -4274,7 +4274,7 @@ def zpopmax(self, name: KeyT, count: Union[int, None] = None) -> ResponseT:
         options = {"withscores": True}
         return self.execute_command("ZPOPMAX", name, *args, **options)
 
-    def zpopmin(self, name: KeyT, count: Union[int, None] = None) -> ResponseT:
+    def zpopmin(self, name: KeyT, count: Optional[int] = None) -> ResponseT:
         """
         Remove and return up to ``count`` members with the lowest scores
         from the sorted set ``name``.
@@ -4286,7 +4286,7 @@ def zpopmin(self, name: KeyT, count: Union[int, None] = None) -> ResponseT:
         return self.execute_command("ZPOPMIN", name, *args, **options)
 
     def zrandmember(
-        self, key: KeyT, count: int = None, withscores: bool = False
+        self, key: KeyT, count: Optional[int] = None, withscores: bool = False
     ) -> ResponseT:
         """
         Return a random element from the sorted set value stored at key.
@@ -4418,8 +4418,8 @@ def _zrange(
         bylex: bool = False,
         withscores: bool = False,
         score_cast_func: Union[type, Callable, None] = float,
-        offset: Union[int, None] = None,
-        num: Union[int, None] = None,
+        offset: Optional[int] = None,
+        num: Optional[int] = None,
     ) -> ResponseT:
         if byscore and bylex:
             raise DataError("``byscore`` and ``bylex`` can not be specified together.")
@@ -4457,8 +4457,8 @@ def zrange(
         score_cast_func: Union[type, Callable] = float,
         byscore: bool = False,
         bylex: bool = False,
-        offset: int = None,
-        num: int = None,
+        offset: Optional[int] = None,
+        num: Optional[int] = None,
     ) -> ResponseT:
         """
         Return a range of values from sorted set ``name`` between
@@ -4545,8 +4545,8 @@ def zrangestore(
         byscore: bool = False,
         bylex: bool = False,
         desc: bool = False,
-        offset: Union[int, None] = None,
-        num: Union[int, None] = None,
+        offset: Optional[int] = None,
+        num: Optional[int] = None,
     ) -> ResponseT:
         """
         Stores in ``dest`` the result of a range of values from sorted set
@@ -4591,8 +4591,8 @@ def zrangebylex(
         name: KeyT,
         min: EncodableT,
         max: EncodableT,
-        start: Union[int, None] = None,
-        num: Union[int, None] = None,
+        start: Optional[int] = None,
+        num: Optional[int] = None,
     ) -> ResponseT:
         """
         Return the lexicographical range of values from sorted set ``name``
@@ -4615,8 +4615,8 @@ def zrevrangebylex(
         name: KeyT,
         max: EncodableT,
         min: EncodableT,
-        start: Union[int, None] = None,
-        num: Union[int, None] = None,
+        start: Optional[int] = None,
+        num: Optional[int] = None,
     ) -> ResponseT:
         """
         Return the reversed lexicographical range of values from sorted set
@@ -4639,8 +4639,8 @@ def zrangebyscore(
         name: KeyT,
         min: ZScoreBoundT,
         max: ZScoreBoundT,
-        start: Union[int, None] = None,
-        num: Union[int, None] = None,
+        start: Optional[int] = None,
+        num: Optional[int] = None,
         withscores: bool = False,
         score_cast_func: Union[type, Callable] = float,
     ) -> ResponseT:
@@ -4674,8 +4674,8 @@ def zrevrangebyscore(
         name: KeyT,
         max: ZScoreBoundT,
         min: ZScoreBoundT,
-        start: Union[int, None] = None,
-        num: Union[int, None] = None,
+        start: Optional[int] = None,
+        num: Optional[int] = None,
         withscores: bool = False,
         score_cast_func: Union[type, Callable] = float,
     ):
@@ -4794,7 +4794,7 @@ def zscore(self, name: KeyT, value: EncodableT) -> ResponseT:
     def zunion(
         self,
         keys: Union[Sequence[KeyT], Mapping[AnyKeyT, float]],
-        aggregate: Union[str, None] = None,
+        aggregate: Optional[str] = None,
         withscores: bool = False,
     ) -> ResponseT:
         """
@@ -4811,7 +4811,7 @@ def zunionstore(
         self,
         dest: KeyT,
         keys: Union[Sequence[KeyT], Mapping[AnyKeyT, float]],
-        aggregate: Union[str, None] = None,
+        aggregate: Optional[str] = None,
     ) -> ResponseT:
         """
         Union multiple sorted sets specified by ``keys`` into
@@ -4843,7 +4843,7 @@ def _zaggregate(
         command: str,
         dest: Union[KeyT, None],
         keys: Union[Sequence[KeyT], Mapping[AnyKeyT, float]],
-        aggregate: Union[str, None] = None,
+        aggregate: Optional[str] = None,
         **options,
     ) -> ResponseT:
         pieces: list[EncodableT] = [command]
@@ -5994,7 +5994,7 @@ def geoadd(
         return self.execute_command("GEOADD", *pieces)
 
     def geodist(
-        self, name: KeyT, place1: FieldT, place2: FieldT, unit: Union[str, None] = None
+        self, name: KeyT, place1: FieldT, place2: FieldT, unit: Optional[str] = None
     ) -> ResponseT:
         """
         Return the distance between ``place1`` and ``place2`` members of the
@@ -6036,14 +6036,14 @@ def georadius(
         longitude: float,
         latitude: float,
         radius: float,
-        unit: Union[str, None] = None,
+        unit: Optional[str] = None,
         withdist: bool = False,
         withcoord: bool = False,
         withhash: bool = False,
-        count: Union[int, None] = None,
-        sort: Union[str, None] = None,
-        store: Union[KeyT, None] = None,
-        store_dist: Union[KeyT, None] = None,
+        count: Optional[int] = None,
+        sort: Optional[str] = None,
+        store: Optional[KeyT] = None,
+        store_dist: Optional[KeyT] = None,
         any: bool = False,
     ) -> ResponseT:
         """
@@ -6098,12 +6098,12 @@ def georadiusbymember(
         name: KeyT,
         member: FieldT,
         radius: float,
-        unit: Union[str, None] = None,
+        unit: Optional[str] = None,
         withdist: bool = False,
         withcoord: bool = False,
         withhash: bool = False,
-        count: Union[int, None] = None,
-        sort: Union[str, None] = None,
+        count: Optional[int] = None,
+        sort: Optional[str] = None,
         store: Union[KeyT, None] = None,
         store_dist: Union[KeyT, None] = None,
         any: bool = False,
@@ -6188,8 +6188,8 @@ def geosearch(
         radius: Union[float, None] = None,
         width: Union[float, None] = None,
         height: Union[float, None] = None,
-        sort: Union[str, None] = None,
-        count: Union[int, None] = None,
+        sort: Optional[str] = None,
+        count: Optional[int] = None,
         any: bool = False,
         withcoord: bool = False,
         withdist: bool = False,
@@ -6263,15 +6263,15 @@ def geosearchstore(
         self,
         dest: KeyT,
         name: KeyT,
-        member: Union[FieldT, None] = None,
-        longitude: Union[float, None] = None,
-        latitude: Union[float, None] = None,
+        member: Optional[FieldT] = None,
+        longitude: Optional[float] = None,
+        latitude: Optional[float] = None,
         unit: str = "m",
-        radius: Union[float, None] = None,
-        width: Union[float, None] = None,
-        height: Union[float, None] = None,
-        sort: Union[str, None] = None,
-        count: Union[int, None] = None,
+        radius: Optional[float] = None,
+        width: Optional[float] = None,
+        height: Optional[float] = None,
+        sort: Optional[str] = None,
+        count: Optional[int] = None,
         any: bool = False,
         storedist: bool = False,
     ) -> ResponseT:
diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index da879df611..48849e1888 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -15,7 +15,7 @@ class JSONCommands:
 
     def arrappend(
         self, name: str, path: Optional[str] = Path.root_path(), *args: List[JsonType]
-    ) -> List[Union[int, None]]:
+    ) -> List[Optional[int]]:
         """Append the objects ``args`` to the array under the
         ``path` in key ``name``.
 
@@ -33,7 +33,7 @@ def arrindex(
         scalar: int,
         start: Optional[int] = None,
         stop: Optional[int] = None,
-    ) -> List[Union[int, None]]:
+    ) -> List[Optional[int]]:
         """
         Return the index of ``scalar`` in the JSON array under ``path`` at key
         ``name``.
@@ -53,7 +53,7 @@ def arrindex(
 
     def arrinsert(
         self, name: str, path: str, index: int, *args: List[JsonType]
-    ) -> List[Union[int, None]]:
+    ) -> List[Optional[int]]:
         """Insert the objects ``args`` to the array at index ``index``
         under the ``path` in key ``name``.
 
@@ -66,7 +66,7 @@ def arrinsert(
 
     def arrlen(
         self, name: str, path: Optional[str] = Path.root_path()
-    ) -> List[Union[int, None]]:
+    ) -> List[Optional[int]]:
         """Return the length of the array JSON value under ``path``
         at key``name``.
 
@@ -79,7 +79,7 @@ def arrpop(
         name: str,
         path: Optional[str] = Path.root_path(),
         index: Optional[int] = -1,
-    ) -> List[Union[str, None]]:
+    ) -> List[Optional[str]]:
         """Pop the element at ``index`` in the array JSON value under
         ``path`` at key ``name``.
 
@@ -89,7 +89,7 @@ def arrpop(
 
     def arrtrim(
         self, name: str, path: str, start: int, stop: int
-    ) -> List[Union[int, None]]:
+    ) -> List[Optional[int]]:
         """Trim the array JSON value under ``path`` at key ``name`` to the
         inclusive range given by ``start`` and ``stop``.
 
@@ -113,7 +113,7 @@ def resp(self, name: str, path: Optional[str] = Path.root_path()) -> List:
 
     def objkeys(
         self, name: str, path: Optional[str] = Path.root_path()
-    ) -> List[Union[List[str], None]]:
+    ) -> List[Optional[List[str]]]:
         """Return the key names in the dictionary JSON value under ``path`` at
         key ``name``.
 
@@ -357,7 +357,7 @@ def set_path(
 
         return set_files_result
 
-    def strlen(self, name: str, path: Optional[str] = None) -> List[Union[int, None]]:
+    def strlen(self, name: str, path: Optional[str] = None) -> List[Optional[int]]:
         """Return the length of the string JSON value under ``path`` at key
         ``name``.
 

From fdfc0d2ff41687e7b77c794101114f47d9d5a560 Mon Sep 17 00:00:00 2001
From: Armin Berres <20811121+aberres@users.noreply.github.com>
Date: Thu, 8 May 2025 14:55:33 +0200
Subject: [PATCH 1047/1164] Allow newer PyJWT versions (#3636)

Close #3630

Co-authored-by: Armin Berres <berres@weplan.info>
---
 CHANGES        | 1 +
 pyproject.toml | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/CHANGES b/CHANGES
index 7ce774621d..50126a86d7 100644
--- a/CHANGES
+++ b/CHANGES
@@ -70,6 +70,7 @@
     * Close Unix sockets if the connection attempt fails. This prevents `ResourceWarning`s. (#3314)
     * Close SSL sockets if the connection attempt fails, or if validations fail. (#3317)
     * Eliminate mutable default arguments in the `redis.commands.core.Script` class. (#3332)
+    * Allow newer versions of PyJWT as dependency. (#3630)
 
 * 4.1.3 (Feb 8, 2022)
   * Fix flushdb and flushall (#1926)
diff --git a/pyproject.toml b/pyproject.toml
index ab3e4cd77e..5cd40c0212 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -41,7 +41,7 @@ ocsp = [
     "requests>=2.31.0",
 ]
 jwt = [
-    "PyJWT~=2.9.0",
+    "PyJWT>=2.9.0",
 ]
 
 [project.urls]

From 010d8fe6a22c177ea3192a926b0402b91c9dda80 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 8 May 2025 16:59:46 +0300
Subject: [PATCH 1048/1164] Updating Redis 8 test image for GH pipeline (#3639)

---
 .github/workflows/integration.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index fbfcecdf68..dcc21b5a9c 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -74,7 +74,7 @@ jobs:
       max-parallel: 15
       fail-fast: false
       matrix:
-        redis-version: ['8.0-RC2-pre', '${{ needs.redis_version.outputs.CURRENT }}', '7.2.7', '6.2.17']
+        redis-version: ['8.0.1-pre', '${{ needs.redis_version.outputs.CURRENT }}', '7.2.7', '6.2.17']
         python-version: ['3.8', '3.13']
         parser-backend: ['plain']
         event-loop: ['asyncio']

From e13c42b8f4a98228ca4d193253cbfda87f36f467 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 8 May 2025 18:09:26 +0300
Subject: [PATCH 1049/1164] Prevent RuntimeError while reinitializing clusters
 - sync and async (#3633)

* Prevent RuntimeError while reinitializing clusters - sync and async

* Applying copilot's review comments
---
 redis/asyncio/cluster.py | 4 +++-
 redis/cluster.py         | 4 +++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index b066a100f6..6044edc23a 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -1313,7 +1313,9 @@ async def initialize(self) -> None:
         startup_nodes_reachable = False
         fully_covered = False
         exception = None
-        for startup_node in self.startup_nodes.values():
+        # Convert to tuple to prevent RuntimeError if self.startup_nodes
+        # is modified during iteration
+        for startup_node in tuple(self.startup_nodes.values()):
             try:
                 # Make sure cluster mode is enabled on this node
                 try:
diff --git a/redis/cluster.py b/redis/cluster.py
index 99e5c37f9d..6e3505404a 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -1674,7 +1674,9 @@ def initialize(self):
         fully_covered = False
         kwargs = self.connection_kwargs
         exception = None
-        for startup_node in self.startup_nodes.values():
+        # Convert to tuple to prevent RuntimeError if self.startup_nodes
+        # is modified during iteration
+        for startup_node in tuple(self.startup_nodes.values()):
             try:
                 if startup_node.redis_connection:
                     r = startup_node.redis_connection

From 4fd1100dc3823d376a46d9efb6347f4c249eee7c Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 8 May 2025 19:55:26 +0300
Subject: [PATCH 1050/1164] Adding return types for the RedisModuleCommands
 class (#3632)

---
 redis/commands/redismodules.py | 30 ++++++++++++++++++++----------
 1 file changed, 20 insertions(+), 10 deletions(-)

diff --git a/redis/commands/redismodules.py b/redis/commands/redismodules.py
index 6e253b1597..078844f7aa 100644
--- a/redis/commands/redismodules.py
+++ b/redis/commands/redismodules.py
@@ -1,4 +1,14 @@
+from __future__ import annotations
+
 from json import JSONDecoder, JSONEncoder
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .bf import BFBloom, CFBloom, CMSBloom, TDigestBloom, TOPKBloom
+    from .json import JSON
+    from .search import AsyncSearch, Search
+    from .timeseries import TimeSeries
+    from .vectorset import VectorSet
 
 
 class RedisModuleCommands:
@@ -6,7 +16,7 @@ class RedisModuleCommands:
     modules into the command namespace.
     """
 
-    def json(self, encoder=JSONEncoder(), decoder=JSONDecoder()):
+    def json(self, encoder=JSONEncoder(), decoder=JSONDecoder()) -> JSON:
         """Access the json namespace, providing support for redis json."""
 
         from .json import JSON
@@ -14,7 +24,7 @@ def json(self, encoder=JSONEncoder(), decoder=JSONDecoder()):
         jj = JSON(client=self, encoder=encoder, decoder=decoder)
         return jj
 
-    def ft(self, index_name="idx"):
+    def ft(self, index_name="idx") -> Search:
         """Access the search namespace, providing support for redis search."""
 
         from .search import Search
@@ -22,7 +32,7 @@ def ft(self, index_name="idx"):
         s = Search(client=self, index_name=index_name)
         return s
 
-    def ts(self):
+    def ts(self) -> TimeSeries:
         """Access the timeseries namespace, providing support for
         redis timeseries data.
         """
@@ -32,7 +42,7 @@ def ts(self):
         s = TimeSeries(client=self)
         return s
 
-    def bf(self):
+    def bf(self) -> BFBloom:
         """Access the bloom namespace."""
 
         from .bf import BFBloom
@@ -40,7 +50,7 @@ def bf(self):
         bf = BFBloom(client=self)
         return bf
 
-    def cf(self):
+    def cf(self) -> CFBloom:
         """Access the bloom namespace."""
 
         from .bf import CFBloom
@@ -48,7 +58,7 @@ def cf(self):
         cf = CFBloom(client=self)
         return cf
 
-    def cms(self):
+    def cms(self) -> CMSBloom:
         """Access the bloom namespace."""
 
         from .bf import CMSBloom
@@ -56,7 +66,7 @@ def cms(self):
         cms = CMSBloom(client=self)
         return cms
 
-    def topk(self):
+    def topk(self) -> TOPKBloom:
         """Access the bloom namespace."""
 
         from .bf import TOPKBloom
@@ -64,7 +74,7 @@ def topk(self):
         topk = TOPKBloom(client=self)
         return topk
 
-    def tdigest(self):
+    def tdigest(self) -> TDigestBloom:
         """Access the bloom namespace."""
 
         from .bf import TDigestBloom
@@ -72,7 +82,7 @@ def tdigest(self):
         tdigest = TDigestBloom(client=self)
         return tdigest
 
-    def vset(self):
+    def vset(self) -> VectorSet:
         """Access the VectorSet commands namespace."""
 
         from .vectorset import VectorSet
@@ -82,7 +92,7 @@ def vset(self):
 
 
 class AsyncRedisModuleCommands(RedisModuleCommands):
-    def ft(self, index_name="idx"):
+    def ft(self, index_name="idx") -> AsyncSearch:
         """Access the search namespace, providing support for redis search."""
 
         from .search import AsyncSearch

From 7130e1ad913f51abc0de1886a52cfd6338e1beee Mon Sep 17 00:00:00 2001
From: Igor Malinovskiy <u.glide@gmail.com>
Date: Fri, 9 May 2025 13:02:14 +0200
Subject: [PATCH 1051/1164] Test against unstable hiredis-py (#3617)

* Test against unstable hiredis-py

* Create a separate workflow instead

* Remove outdated guard for hiredis-py

The guard was required to prevent cluster tests on RESP3 with hiredis-py before 3.1.0

---------

Co-authored-by: petyaslavova <petya.slavova@redis.com>
---
 .github/actions/run-tests/action.yml          | 31 ++++++---
 .github/workflows/hiredis-py-integration.yaml | 66 +++++++++++++++++++
 2 files changed, 89 insertions(+), 8 deletions(-)
 create mode 100644 .github/workflows/hiredis-py-integration.yaml

diff --git a/.github/actions/run-tests/action.yml b/.github/actions/run-tests/action.yml
index aa958a9236..ae9575e055 100644
--- a/.github/actions/run-tests/action.yml
+++ b/.github/actions/run-tests/action.yml
@@ -14,6 +14,10 @@ inputs:
     description: 'hiredis version to test against'
     required: false
     default: '>3.0.0'
+  hiredis-branch:
+    description: 'hiredis branch to test against'
+    required: false
+    default: 'master'
   event-loop:
     description: 'Event loop to use'
     required: false
@@ -28,6 +32,14 @@ runs:
         python-version: ${{ inputs.python-version }}
         cache: 'pip'
 
+    - uses: actions/checkout@v4
+      if: ${{ inputs.parser-backend == 'hiredis' && inputs.hiredis-version == 'unstable' }}
+      with:
+        repository: redis/hiredis-py
+        submodules: true
+        path: hiredis-py
+        ref: ${{ inputs.hiredis-branch }}
+
     - name: Setup Test environment
       env:
         REDIS_VERSION: ${{ inputs.redis-version }}
@@ -40,8 +52,13 @@ runs:
         pip uninstall -y redis  # uninstall Redis package installed via redis-entraid
         pip install -e .[jwt]  # install the working copy
         if [ "${{inputs.parser-backend}}" == "hiredis" ]; then
-          pip install "hiredis${{inputs.hiredis-version}}"
-          echo "PARSER_BACKEND=$(echo "${{inputs.parser-backend}}_${{inputs.hiredis-version}}" | sed 's/[^a-zA-Z0-9]/_/g')" >> $GITHUB_ENV        
+          if [[ "${{inputs.hiredis-version}}" == "unstable" ]]; then
+            echo "Installing unstable version of hiredis from local directory"
+            pip install -e ./hiredis-py
+          else
+            pip install "hiredis${{inputs.hiredis-version}}"
+          fi          
+          echo "PARSER_BACKEND=$(echo "${{inputs.parser-backend}}_${{inputs.hiredis-version}}" | sed 's/[^a-zA-Z0-9]/_/g')" >> $GITHUB_ENV
         else
           echo "PARSER_BACKEND=${{inputs.parser-backend}}" >> $GITHUB_ENV
         fi
@@ -108,12 +125,10 @@ runs:
           fi
         
           echo "::endgroup::"
-    
-          if [ "$protocol" == "2" ] || [ "${{inputs.parser-backend}}" != 'hiredis' ]; then
-            echo "::group::RESP${protocol} cluster tests"
-            invoke cluster-tests $eventloop --protocol=${protocol}
-            echo "::endgroup::"
-          fi
+            
+          echo "::group::RESP${protocol} cluster tests"
+          invoke cluster-tests $eventloop --protocol=${protocol}
+          echo "::endgroup::"          
         }
   
         run_tests 2 "${{inputs.event-loop}}"
diff --git a/.github/workflows/hiredis-py-integration.yaml b/.github/workflows/hiredis-py-integration.yaml
new file mode 100644
index 0000000000..816a143fba
--- /dev/null
+++ b/.github/workflows/hiredis-py-integration.yaml
@@ -0,0 +1,66 @@
+name: Hiredis-py integration tests
+
+on:
+  workflow_dispatch:
+    inputs:
+      redis-py-branch:
+        description: 'redis-py branch to run tests on'
+        required: true
+        default: 'master'
+      hiredis-branch:
+        description: 'hiredis-py branch to run tests on'
+        required: true
+        default: 'master'
+
+concurrency:
+  group: ${{ github.event.pull_request.number || github.ref }}-hiredis-integration
+  cancel-in-progress: true
+
+permissions:
+  contents: read  #  to fetch code (actions/checkout)
+
+env:
+  CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+  # this speeds up coverage with Python 3.12: https://github.com/nedbat/coveragepy/issues/1665
+  COVERAGE_CORE: sysmon
+  CURRENT_CLIENT_LIBS_TEST_STACK_IMAGE_TAG: 'rs-7.4.0-v2'
+  CURRENT_REDIS_VERSION: '7.4.2'
+
+jobs:
+  redis_version:
+    runs-on: ubuntu-latest
+    outputs:
+      CURRENT: ${{ env.CURRENT_REDIS_VERSION }}
+    steps:
+      - name: Compute outputs
+        run: |
+          echo "CURRENT=${{ env.CURRENT_REDIS_VERSION }}" >> $GITHUB_OUTPUT  
+
+  hiredis-tests:
+    runs-on: ubuntu-latest
+    needs: [redis_version]
+    timeout-minutes: 60
+    strategy:
+      max-parallel: 15
+      fail-fast: false
+      matrix:
+        redis-version: [ '${{ needs.redis_version.outputs.CURRENT }}' ]
+        python-version: [ '3.8', '3.13']
+        parser-backend: [ 'hiredis' ]
+        hiredis-version: [ 'unstable' ]
+        hiredis-branch: ${{ inputs.hiredis-branch }}
+        event-loop: [ 'asyncio' ]
+    env:
+      ACTIONS_ALLOW_UNSECURE_COMMANDS: true
+    name: Redis ${{ matrix.redis-version }}; Python ${{ matrix.python-version }}; RESP Parser:${{matrix.parser-backend}} (${{ matrix.hiredis-version }}); EL:${{matrix.event-loop}}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.redis-py-branch }}
+      - name: Run tests
+        uses: ./.github/actions/run-tests
+        with:
+          python-version: ${{ matrix.python-version }}
+          parser-backend: ${{ matrix.parser-backend }}
+          redis-version: ${{ matrix.redis-version }}
+          hiredis-version: ${{ matrix.hiredis-version }}
\ No newline at end of file

From 92e2ff73e6ad3c1f9b437dd4dc15edf1131f477c Mon Sep 17 00:00:00 2001
From: Igor Malinovskiy <u.glide@gmail.com>
Date: Fri, 9 May 2025 17:10:42 +0200
Subject: [PATCH 1052/1164] Fix matrix in hiredis-py-integration.yaml (#3641)

---
 .github/workflows/hiredis-py-integration.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/hiredis-py-integration.yaml b/.github/workflows/hiredis-py-integration.yaml
index 816a143fba..947a0df05b 100644
--- a/.github/workflows/hiredis-py-integration.yaml
+++ b/.github/workflows/hiredis-py-integration.yaml
@@ -48,7 +48,6 @@ jobs:
         python-version: [ '3.8', '3.13']
         parser-backend: [ 'hiredis' ]
         hiredis-version: [ 'unstable' ]
-        hiredis-branch: ${{ inputs.hiredis-branch }}
         event-loop: [ 'asyncio' ]
     env:
       ACTIONS_ALLOW_UNSECURE_COMMANDS: true
@@ -63,4 +62,5 @@ jobs:
           python-version: ${{ matrix.python-version }}
           parser-backend: ${{ matrix.parser-backend }}
           redis-version: ${{ matrix.redis-version }}
-          hiredis-version: ${{ matrix.hiredis-version }}
\ No newline at end of file
+          hiredis-version: ${{ matrix.hiredis-version }}
+          hiredis-branch: ${{ inputs.hiredis-branch }}
\ No newline at end of file

From 02b2ab604f796b42465c75bd74d633f34f2d7cf7 Mon Sep 17 00:00:00 2001
From: Igor Malinovskiy <u.glide@gmail.com>
Date: Mon, 12 May 2025 08:50:11 +0200
Subject: [PATCH 1053/1164] Export REDIS_MAJOR_VERSION correctly in run-tests
 (#3642)

---
 .github/actions/run-tests/action.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/actions/run-tests/action.yml b/.github/actions/run-tests/action.yml
index ae9575e055..20cceb922b 100644
--- a/.github/actions/run-tests/action.yml
+++ b/.github/actions/run-tests/action.yml
@@ -66,6 +66,7 @@ runs:
         
         echo "::group::Starting Redis servers"
         redis_major_version=$(echo "$REDIS_VERSION" | grep -oP '^\d+')
+        echo "REDIS_MAJOR_VERSION=${redis_major_version}" >> $GITHUB_ENV
         
         if (( redis_major_version < 8 )); then
           echo "Using redis-stack for module tests"
@@ -87,8 +88,7 @@ runs:
                   
           if (( redis_major_version < 7 )); then
             export REDIS_STACK_EXTRA_ARGS="--tls-auth-clients optional --save ''"
-            export REDIS_EXTRA_ARGS="--tls-auth-clients optional --save ''"
-            echo "REDIS_MAJOR_VERSION=${redis_major_version}" >> $GITHUB_ENV
+            export REDIS_EXTRA_ARGS="--tls-auth-clients optional --save ''"            
           fi
         
           invoke devenv --endpoints=all-stack

From 91be4a0ff39556d5e270897740369d0b1cf9e044 Mon Sep 17 00:00:00 2001
From: robertosantamaria-scopely
 <136002179+robertosantamaria-scopely@users.noreply.github.com>
Date: Mon, 12 May 2025 12:54:29 +0200
Subject: [PATCH 1054/1164] Multi exec on cluster (#3611)

* feat(cluster): support for transactions on cluster-aware client

Adds support for transactions based on multi/watch/exec on clusters.
Transactions in this mode are limited to a single hash slot.

Contributed-by: Scopely <roberto.santamaria@scopely.com>

* fix: remove deprecated argument

* remove attributions from code

* Refactor ClusterPipeline to use execution strategies

* Refactored strategy to use composition

* Added test cases

* Sync with master

* Filter tests, ensure that tests are working after refactor

* Added test case

* Revert port changes

* Improved exception handling

* Change visibility of variable to public

* Changed variable ref

* Changed ref type

* Added documentation

* Refactored retries, fixed comments, fixed linters

* Added word to a wordlist

* Revert port changes

* Added quotes

* Fixed docs

* Updated CONNECTION_ERRORS

* Codestyle fixes

* Updated docs

* Revert import

---------

Co-authored-by: vladvildanov <vladyslav.vildanov@redis.com>
Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
---
 .github/wordlist.txt              |    1 +
 .gitignore                        |    1 +
 CHANGES                           |    1 +
 docs/advanced_features.rst        |  119 ++-
 redis/__init__.py                 |    6 +
 redis/client.py                   |   15 +-
 redis/cluster.py                  | 1290 ++++++++++++++++++++++-------
 redis/exceptions.py               |   18 +
 tests/test_cluster.py             |  115 ++-
 tests/test_cluster_transaction.py |  392 +++++++++
 10 files changed, 1601 insertions(+), 357 deletions(-)
 create mode 100644 tests/test_cluster_transaction.py

diff --git a/.github/wordlist.txt b/.github/wordlist.txt
index 29bcaa9d77..150f96a624 100644
--- a/.github/wordlist.txt
+++ b/.github/wordlist.txt
@@ -2,6 +2,7 @@ APM
 ARGV
 BFCommands
 CacheImpl
+CAS
 CFCommands
 CMSCommands
 ClusterNode
diff --git a/.gitignore b/.gitignore
index 5f77dcfde4..7184ad4e20 100644
--- a/.gitignore
+++ b/.gitignore
@@ -9,6 +9,7 @@ vagrant/.vagrant
 .cache
 .eggs
 .idea
+.vscode
 .coverage
 env
 venv
diff --git a/CHANGES b/CHANGES
index 50126a86d7..1a1f4eca11 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,4 @@
+    * Support transactions in ClusterPipeline
     * Removing support for RedisGraph module. RedisGraph support is deprecated since Redis Stack 7.2 (https://redis.com/blog/redisgraph-eol/)
     * Fix lock.extend() typedef to accept float TTL extension
     * Update URL in the readme linking to Redis University
diff --git a/docs/advanced_features.rst b/docs/advanced_features.rst
index 603e728e84..11ab8af716 100644
--- a/docs/advanced_features.rst
+++ b/docs/advanced_features.rst
@@ -167,6 +167,7 @@ the server.
 
 .. code:: python
 
+   >>> rc = RedisCluster()
    >>> with rc.pipeline() as pipe:
    ...     pipe.set('foo', 'value1')
    ...     pipe.set('bar', 'value2')
@@ -177,20 +178,110 @@ the server.
    ...     pipe.set('foo1', 'bar1').get('foo1').execute()
    [True, b'bar1']
 
-Please note: - RedisCluster pipelines currently only support key-based
-commands. - The pipeline gets its ‘read_from_replicas’ value from the
-cluster’s parameter. Thus, if read from replications is enabled in the
-cluster instance, the pipeline will also direct read commands to
-replicas. - The ‘transaction’ option is NOT supported in cluster-mode.
-In non-cluster mode, the ‘transaction’ option is available when
-executing pipelines. This wraps the pipeline commands with MULTI/EXEC
-commands, and effectively turns the pipeline commands into a single
-transaction block. This means that all commands are executed
-sequentially without any interruptions from other clients. However, in
-cluster-mode this is not possible, because commands are partitioned
-according to their respective destination nodes. This means that we can
-not turn the pipeline commands into one transaction block, because in
-most cases they are split up into several smaller pipelines.
+Please note:
+
+-  RedisCluster pipelines currently only support key-based commands.
+-  The pipeline gets its ‘load_balancing_strategy’ value from the
+   cluster’s parameter. Thus, if read from replications is enabled in
+   the cluster instance, the pipeline will also direct read commands to
+   replicas.
+
+
+Transactions in clusters
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Transactions are supported in cluster-mode with one caveat: all keys of
+all commands issued on a transaction pipeline must reside on the
+same slot. This is similar to the limitation of multikey commands in
+cluster. The reason behind this is that the Redis engine does not offer
+a mechanism to block or exchange key data across nodes on the fly. A
+client may add some logic to abstract engine limitations when running
+on a cluster, such as the pipeline behavior explained on the previous
+block, but there is no simple way that a client can enforce atomicity
+across nodes on a distributed system.
+
+The compromise of limiting the transaction pipeline to same-slot keys
+is exactly that: a compromise. While this behavior is different from
+non-transactional cluster pipelines, it simplifies migration of clients
+from standalone to cluster under some circumstances. Note that application
+code that issues multi/exec commands on a standalone client without
+embedding them within a pipeline would eventually get ‘AttributeError’.
+With this approach, if the application uses ‘client.pipeline(transaction=True)’,
+then switching the client with a cluster-aware instance would simplify
+code changes (to some extent). This may be true for application code that
+makes use of hash keys, since its transactions may already be
+mapping all commands to the same slot.
+
+An alternative is some kind of two-step commit solution, where a slot
+validation is run before the actual commands are run. This could work
+with controlled node maintenance but does not cover single node failures.
+
+Given the cluster limitations for transactions, by default pipeline isn't in
+transactional mode. To enable transactional context set:
+
+.. code:: python
+
+   >>> p = rc.pipeline(transaction=True)
+
+After entering the transactional context you can add commands to a transactional
+context, by one of the following ways:
+
+.. code:: python
+
+   >>> p = rc.pipeline(transaction=True) # Chaining commands
+   >>> p.set("key", "value")
+   >>> p.get("key")
+   >>> response = p.execute()
+
+Or
+
+.. code:: python
+
+   >>> with rc.pipeline(transaction=True) as pipe: # Using context manager
+   ...     pipe.set("key", "value")
+   ...     pipe.get("key")
+   ...     response = pipe.execute()
+
+As you see there's no need to explicitly send `MULTI/EXEC` commands to control context start/end
+`ClusterPipeline` will take care of it.
+
+To ensure that different keys will be mapped to a same hash slot on the server side
+prepend your keys with the same hash tag, the technique that allows you to control
+keys distribution.
+More information `here <https://redis.io/docs/latest/operate/oss_and_stack/reference/cluster-spec/#hash-tags>`_
+
+.. code:: python
+
+   >>> with rc.pipeline(transaction=True) as pipe:
+   ...     pipe.set("{tag}foo", "bar")
+   ...     pipe.set("{tag}bar", "foo")
+   ...     pipe.get("{tag}foo")
+   ...     pipe.get("{tag}bar")
+   ...     response = pipe.execute()
+
+CAS Transactions
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you want to apply optimistic locking for certain keys, you have to execute
+`WATCH` command in transactional context. `WATCH` command follows the same limitations
+as any other multi key command - all keys should be mapped to the same hash slot.
+
+However, the difference between CAS transaction and normal one is that you have to
+explicitly call MULTI command to indicate the start of transactional context, WATCH
+command itself and any subsequent commands before MULTI will be immediately executed
+on the server side so you can apply optimistic locking and get necessary data before
+transaction execution.
+
+.. code:: python
+
+   >>> with rc.pipeline(transaction=True) as pipe:
+   ...     pipe.watch("mykey")       # Apply locking by immediately executing command
+   ...     val = pipe.get("mykey")   # Immediately retrieves value
+   ...     val = val + 1             # Increment value
+   ...     pipe.multi()              # Starting transaction context
+   ...     pipe.set("mykey", val)    # Command will be pipelined
+   ...     response = pipe.execute() # Returns OK or None if key was modified in the meantime
+
 
 Publish / Subscribe
 -------------------
diff --git a/redis/__init__.py b/redis/__init__.py
index f82a876b2d..14030205e3 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -16,11 +16,14 @@
     BusyLoadingError,
     ChildDeadlockedError,
     ConnectionError,
+    CrossSlotTransactionError,
     DataError,
+    InvalidPipelineStack,
     InvalidResponse,
     OutOfMemoryError,
     PubSubError,
     ReadOnlyError,
+    RedisClusterException,
     RedisError,
     ResponseError,
     TimeoutError,
@@ -56,15 +59,18 @@ def int_or_str(value):
     "ConnectionError",
     "ConnectionPool",
     "CredentialProvider",
+    "CrossSlotTransactionError",
     "DataError",
     "from_url",
     "default_backoff",
+    "InvalidPipelineStack",
     "InvalidResponse",
     "OutOfMemoryError",
     "PubSubError",
     "ReadOnlyError",
     "Redis",
     "RedisCluster",
+    "RedisClusterException",
     "RedisError",
     "ResponseError",
     "Sentinel",
diff --git a/redis/client.py b/redis/client.py
index 2ef95600c2..dc4f0f9d0c 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -34,6 +34,7 @@
 from redis.commands.core import Script
 from redis.connection import (
     AbstractConnection,
+    Connection,
     ConnectionPool,
     SSLConnection,
     UnixDomainSocketConnection,
@@ -1297,9 +1298,15 @@ class Pipeline(Redis):
 
     UNWATCH_COMMANDS = {"DISCARD", "EXEC", "UNWATCH"}
 
-    def __init__(self, connection_pool, response_callbacks, transaction, shard_hint):
+    def __init__(
+        self,
+        connection_pool: ConnectionPool,
+        response_callbacks,
+        transaction,
+        shard_hint,
+    ):
         self.connection_pool = connection_pool
-        self.connection = None
+        self.connection: Optional[Connection] = None
         self.response_callbacks = response_callbacks
         self.transaction = transaction
         self.shard_hint = shard_hint
@@ -1434,7 +1441,9 @@ def pipeline_execute_command(self, *args, **options) -> "Pipeline":
         self.command_stack.append((args, options))
         return self
 
-    def _execute_transaction(self, connection, commands, raise_on_error) -> List:
+    def _execute_transaction(
+        self, connection: Connection, commands, raise_on_error
+    ) -> List:
         cmds = chain([(("MULTI",), {})], commands, [(("EXEC",), {})])
         all_cmds = connection.pack_commands(
             [args for args, options in cmds if EMPTY_RESPONSE not in options]
diff --git a/redis/cluster.py b/redis/cluster.py
index 6e3505404a..b614c598f9 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -3,18 +3,25 @@
 import sys
 import threading
 import time
+from abc import ABC, abstractmethod
 from collections import OrderedDict
+from copy import copy
 from enum import Enum
-from typing import Any, Callable, Dict, List, Optional, Tuple, Union
+from itertools import chain
+from typing import Any, Callable, Dict, List, Optional, Set, Tuple, Union
 
 from redis._parsers import CommandsParser, Encoder
 from redis._parsers.helpers import parse_scan
 from redis.backoff import ExponentialWithJitterBackoff, NoBackoff
 from redis.cache import CacheConfig, CacheFactory, CacheFactoryInterface, CacheInterface
-from redis.client import CaseInsensitiveDict, PubSub, Redis
+from redis.client import EMPTY_RESPONSE, CaseInsensitiveDict, PubSub, Redis
 from redis.commands import READ_COMMANDS, RedisClusterCommands
 from redis.commands.helpers import list_or_args
-from redis.connection import ConnectionPool, parse_url
+from redis.connection import (
+    Connection,
+    ConnectionPool,
+    parse_url,
+)
 from redis.crc import REDIS_CLUSTER_HASH_SLOTS, key_slot
 from redis.event import (
     AfterPooledConnectionsInstantiationEvent,
@@ -28,7 +35,10 @@
     ClusterDownError,
     ClusterError,
     ConnectionError,
+    CrossSlotTransactionError,
     DataError,
+    ExecAbortError,
+    InvalidPipelineStack,
     MovedError,
     RedisClusterException,
     RedisError,
@@ -36,6 +46,7 @@
     SlotNotCoveredError,
     TimeoutError,
     TryAgainError,
+    WatchError,
 )
 from redis.lock import Lock
 from redis.retry import Retry
@@ -60,7 +71,7 @@ def get_node_name(host: str, port: Union[str, int]) -> str:
     reason="Use get_connection(redis_node) instead",
     version="5.3.0",
 )
-def get_connection(redis_node, *args, **options):
+def get_connection(redis_node: Redis, *args, **options) -> Connection:
     return redis_node.connection or redis_node.connection_pool.get_connection()
 
 
@@ -741,7 +752,7 @@ def on_connect(self, connection):
         if self.user_on_connect_func is not None:
             self.user_on_connect_func(connection)
 
-    def get_redis_connection(self, node):
+    def get_redis_connection(self, node: "ClusterNode") -> Redis:
         if not node.redis_connection:
             with self._lock:
                 if not node.redis_connection:
@@ -839,9 +850,6 @@ def pipeline(self, transaction=None, shard_hint=None):
         if shard_hint:
             raise RedisClusterException("shard_hint is deprecated in cluster mode")
 
-        if transaction:
-            raise RedisClusterException("transaction is deprecated in cluster mode")
-
         return ClusterPipeline(
             nodes_manager=self.nodes_manager,
             commands_parser=self.commands_parser,
@@ -854,6 +862,7 @@ def pipeline(self, transaction=None, shard_hint=None):
             reinitialize_steps=self.reinitialize_steps,
             retry=self.retry,
             lock=self._lock,
+            transaction=transaction,
         )
 
     def lock(
@@ -1015,7 +1024,7 @@ def _get_command_keys(self, *args):
         redis_conn = self.get_default_node().redis_connection
         return self.commands_parser.get_keys(redis_conn, *args)
 
-    def determine_slot(self, *args):
+    def determine_slot(self, *args) -> int:
         """
         Figure out what slot to use based on args.
 
@@ -1228,8 +1237,6 @@ def _execute_command(self, target_node, *args, **kwargs):
             except AuthenticationError:
                 raise
             except (ConnectionError, TimeoutError) as e:
-                # Connection retries are being handled in the node's
-                # Retry object.
                 # ConnectionError can also be raised if we couldn't get a
                 # connection from the pool before timing out, so check that
                 # this is an actual connection before attempting to disconnect.
@@ -1330,6 +1337,28 @@ def load_external_module(self, funcname, func):
         """
         setattr(self, funcname, func)
 
+    def transaction(self, func, *watches, **kwargs):
+        """
+        Convenience method for executing the callable `func` as a transaction
+        while watching all keys specified in `watches`. The 'func' callable
+        should expect a single argument which is a Pipeline object.
+        """
+        shard_hint = kwargs.pop("shard_hint", None)
+        value_from_callable = kwargs.pop("value_from_callable", False)
+        watch_delay = kwargs.pop("watch_delay", None)
+        with self.pipeline(True, shard_hint) as pipe:
+            while True:
+                try:
+                    if watches:
+                        pipe.watch(*watches)
+                    func_value = func(pipe)
+                    exec_value = pipe.execute()
+                    return func_value if value_from_callable else exec_value
+                except WatchError:
+                    if watch_delay is not None and watch_delay > 0:
+                        time.sleep(watch_delay)
+                    continue
+
 
 class ClusterNode:
     def __init__(self, host, port, server_type=None, redis_connection=None):
@@ -1427,7 +1456,7 @@ def __init__(
         event_dispatcher: Optional[EventDispatcher] = None,
         **kwargs,
     ):
-        self.nodes_cache = {}
+        self.nodes_cache: Dict[str, Redis] = {}
         self.slots_cache = {}
         self.startup_nodes = {}
         self.default_node = None
@@ -1527,7 +1556,7 @@ def get_node_from_slot(
         read_from_replicas=False,
         load_balancing_strategy=None,
         server_type=None,
-    ):
+    ) -> ClusterNode:
         """
         Gets a node that servers this hash slot
         """
@@ -1823,6 +1852,16 @@ def remap_host_port(self, host: str, port: int) -> Tuple[str, int]:
             return self.address_remap((host, port))
         return host, port
 
+    def find_connection_owner(self, connection: Connection) -> Optional[Redis]:
+        node_name = get_node_name(connection.host, connection.port)
+        for node in tuple(self.nodes_cache.values()):
+            if node.redis_connection:
+                conn_args = node.redis_connection.connection_pool.connection_kwargs
+                if node_name == get_node_name(
+                    conn_args.get("host"), conn_args.get("port")
+                ):
+                    return node
+
 
 class ClusterPubSub(PubSub):
     """
@@ -2082,6 +2121,10 @@ class ClusterPipeline(RedisCluster):
         TryAgainError,
     )
 
+    NO_SLOTS_COMMANDS = {"UNWATCH"}
+    IMMEDIATE_EXECUTE_COMMANDS = {"WATCH", "UNWATCH"}
+    UNWATCH_COMMANDS = {"DISCARD", "EXEC", "UNWATCH"}
+
     @deprecated_args(
         args_to_warn=[
             "cluster_error_retry_attempts",
@@ -2102,6 +2145,7 @@ def __init__(
         reinitialize_steps: int = 5,
         retry: Optional[Retry] = None,
         lock=None,
+        transaction=False,
         **kwargs,
     ):
         """ """
@@ -2135,6 +2179,10 @@ def __init__(
         if lock is None:
             lock = threading.Lock()
         self._lock = lock
+        self.parent_execute_command = super().execute_command
+        self._execution_strategy: ExecutionStrategy = (
+            PipelineStrategy(self) if not transaction else TransactionStrategy(self)
+        )
 
     def __repr__(self):
         """ """
@@ -2156,7 +2204,7 @@ def __del__(self):
 
     def __len__(self):
         """ """
-        return len(self.command_stack)
+        return len(self._execution_strategy.command_queue)
 
     def __bool__(self):
         "Pipeline instances should  always evaluate to True on Python 3+"
@@ -2166,45 +2214,35 @@ def execute_command(self, *args, **kwargs):
         """
         Wrapper function for pipeline_execute_command
         """
-        return self.pipeline_execute_command(*args, **kwargs)
+        return self._execution_strategy.execute_command(*args, **kwargs)
 
     def pipeline_execute_command(self, *args, **options):
         """
-        Appends the executed command to the pipeline's command stack
-        """
-        self.command_stack.append(
-            PipelineCommand(args, options, len(self.command_stack))
-        )
-        return self
+        Stage a command to be executed when execute() is next called
 
-    def raise_first_error(self, stack):
-        """
-        Raise the first exception on the stack
+        Returns the current Pipeline object back so commands can be
+        chained together, such as:
+
+        pipe = pipe.set('foo', 'bar').incr('baz').decr('bang')
+
+        At some other point, you can then run: pipe.execute(),
+        which will execute all commands queued in the pipe.
         """
-        for c in stack:
-            r = c.result
-            if isinstance(r, Exception):
-                self.annotate_exception(r, c.position + 1, c.args)
-                raise r
+        return self._execution_strategy.execute_command(*args, **options)
 
     def annotate_exception(self, exception, number, command):
         """
         Provides extra context to the exception prior to it being handled
         """
-        cmd = " ".join(map(safe_str, command))
-        msg = (
-            f"Command # {number} ({truncate_text(cmd)}) of pipeline "
-            f"caused error: {exception.args[0]}"
-        )
-        exception.args = (msg,) + exception.args[1:]
+        self._execution_strategy.annotate_exception(exception, number, command)
 
     def execute(self, raise_on_error: bool = True) -> List[Any]:
         """
         Execute all the commands in the current pipeline
         """
-        stack = self.command_stack
+
         try:
-            return self.send_cluster_commands(stack, raise_on_error)
+            return self._execution_strategy.execute(raise_on_error)
         finally:
             self.reset()
 
@@ -2212,312 +2250,53 @@ def reset(self):
         """
         Reset back to empty pipeline.
         """
-        self.command_stack = []
-
-        self.scripts = set()
-
-        # TODO: Implement
-        # make sure to reset the connection state in the event that we were
-        # watching something
-        # if self.watching and self.connection:
-        #     try:
-        #         # call this manually since our unwatch or
-        #         # immediate_execute_command methods can call reset()
-        #         self.connection.send_command('UNWATCH')
-        #         self.connection.read_response()
-        #     except ConnectionError:
-        #         # disconnect will also remove any previous WATCHes
-        #         self.connection.disconnect()
-
-        # clean up the other instance attributes
-        self.watching = False
-        self.explicit_transaction = False
-
-        # TODO: Implement
-        # we can safely return the connection to the pool here since we're
-        # sure we're no longer WATCHing anything
-        # if self.connection:
-        #     self.connection_pool.release(self.connection)
-        #     self.connection = None
+        self._execution_strategy.reset()
 
     def send_cluster_commands(
         self, stack, raise_on_error=True, allow_redirections=True
     ):
-        """
-        Wrapper for CLUSTERDOWN error handling.
-
-        If the cluster reports it is down it is assumed that:
-         - connection_pool was disconnected
-         - connection_pool was reseted
-         - refereh_table_asap set to True
-
-        It will try the number of times specified by
-        the retries in config option "self.retry"
-        which defaults to 3 unless manually configured.
-
-        If it reaches the number of times, the command will
-        raises ClusterDownException.
-        """
-        if not stack:
-            return []
-        retry_attempts = self.retry.get_retries()
-        while True:
-            try:
-                return self._send_cluster_commands(
-                    stack,
-                    raise_on_error=raise_on_error,
-                    allow_redirections=allow_redirections,
-                )
-            except RedisCluster.ERRORS_ALLOW_RETRY as e:
-                if retry_attempts > 0:
-                    # Try again with the new cluster setup. All other errors
-                    # should be raised.
-                    retry_attempts -= 1
-                    pass
-                else:
-                    raise e
-
-    def _send_cluster_commands(
-        self, stack, raise_on_error=True, allow_redirections=True
-    ):
-        """
-        Send a bunch of cluster commands to the redis cluster.
-
-        `allow_redirections` If the pipeline should follow
-        `ASK` & `MOVED` responses automatically. If set
-        to false it will raise RedisClusterException.
-        """
-        # the first time sending the commands we send all of
-        # the commands that were queued up.
-        # if we have to run through it again, we only retry
-        # the commands that failed.
-        attempt = sorted(stack, key=lambda x: x.position)
-        is_default_node = False
-        # build a list of node objects based on node names we need to
-        nodes = {}
-
-        # as we move through each command that still needs to be processed,
-        # we figure out the slot number that command maps to, then from
-        # the slot determine the node.
-        for c in attempt:
-            while True:
-                # refer to our internal node -> slot table that
-                # tells us where a given command should route to.
-                # (it might be possible we have a cached node that no longer
-                # exists in the cluster, which is why we do this in a loop)
-                passed_targets = c.options.pop("target_nodes", None)
-                if passed_targets and not self._is_nodes_flag(passed_targets):
-                    target_nodes = self._parse_target_nodes(passed_targets)
-                else:
-                    target_nodes = self._determine_nodes(
-                        *c.args, node_flag=passed_targets
-                    )
-                    if not target_nodes:
-                        raise RedisClusterException(
-                            f"No targets were found to execute {c.args} command on"
-                        )
-                if len(target_nodes) > 1:
-                    raise RedisClusterException(
-                        f"Too many targets for command {c.args}"
-                    )
-
-                node = target_nodes[0]
-                if node == self.get_default_node():
-                    is_default_node = True
-
-                # now that we know the name of the node
-                # ( it's just a string in the form of host:port )
-                # we can build a list of commands for each node.
-                node_name = node.name
-                if node_name not in nodes:
-                    redis_node = self.get_redis_connection(node)
-                    try:
-                        connection = get_connection(redis_node)
-                    except (ConnectionError, TimeoutError):
-                        for n in nodes.values():
-                            n.connection_pool.release(n.connection)
-                        # Connection retries are being handled in the node's
-                        # Retry object. Reinitialize the node -> slot table.
-                        self.nodes_manager.initialize()
-                        if is_default_node:
-                            self.replace_default_node()
-                        raise
-                    nodes[node_name] = NodeCommands(
-                        redis_node.parse_response,
-                        redis_node.connection_pool,
-                        connection,
-                    )
-                nodes[node_name].append(c)
-                break
-
-        # send the commands in sequence.
-        # we  write to all the open sockets for each node first,
-        # before reading anything
-        # this allows us to flush all the requests out across the
-        # network essentially in parallel
-        # so that we can read them all in parallel as they come back.
-        # we dont' multiplex on the sockets as they come available,
-        # but that shouldn't make too much difference.
-        node_commands = nodes.values()
-        try:
-            node_commands = nodes.values()
-            for n in node_commands:
-                n.write()
-
-            for n in node_commands:
-                n.read()
-        finally:
-            # release all of the redis connections we allocated earlier
-            # back into the connection pool.
-            # we used to do this step as part of a try/finally block,
-            # but it is really dangerous to
-            # release connections back into the pool if for some
-            # reason the socket has data still left in it
-            # from a previous operation. The write and
-            # read operations already have try/catch around them for
-            # all known types of errors including connection
-            # and socket level errors.
-            # So if we hit an exception, something really bad
-            # happened and putting any oF
-            # these connections back into the pool is a very bad idea.
-            # the socket might have unread buffer still sitting in it,
-            # and then the next time we read from it we pass the
-            # buffered result back from a previous command and
-            # every single request after to that connection will always get
-            # a mismatched result.
-            for n in nodes.values():
-                n.connection_pool.release(n.connection)
-
-        # if the response isn't an exception it is a
-        # valid response from the node
-        # we're all done with that command, YAY!
-        # if we have more commands to attempt, we've run into problems.
-        # collect all the commands we are allowed to retry.
-        # (MOVED, ASK, or connection errors or timeout errors)
-        attempt = sorted(
-            (
-                c
-                for c in attempt
-                if isinstance(c.result, ClusterPipeline.ERRORS_ALLOW_RETRY)
-            ),
-            key=lambda x: x.position,
+        return self._execution_strategy.send_cluster_commands(
+            stack, raise_on_error=raise_on_error, allow_redirections=allow_redirections
         )
-        if attempt and allow_redirections:
-            # RETRY MAGIC HAPPENS HERE!
-            # send these remaining commands one at a time using `execute_command`
-            # in the main client. This keeps our retry logic
-            # in one place mostly,
-            # and allows us to be more confident in correctness of behavior.
-            # at this point any speed gains from pipelining have been lost
-            # anyway, so we might as well make the best
-            # attempt to get the correct behavior.
-            #
-            # The client command will handle retries for each
-            # individual command sequentially as we pass each
-            # one into `execute_command`. Any exceptions
-            # that bubble out should only appear once all
-            # retries have been exhausted.
-            #
-            # If a lot of commands have failed, we'll be setting the
-            # flag to rebuild the slots table from scratch.
-            # So MOVED errors should correct themselves fairly quickly.
-            self.reinitialize_counter += 1
-            if self._should_reinitialized():
-                self.nodes_manager.initialize()
-                if is_default_node:
-                    self.replace_default_node()
-            for c in attempt:
-                try:
-                    # send each command individually like we
-                    # do in the main client.
-                    c.result = super().execute_command(*c.args, **c.options)
-                except RedisError as e:
-                    c.result = e
-
-        # turn the response back into a simple flat array that corresponds
-        # to the sequence of commands issued in the stack in pipeline.execute()
-        response = []
-        for c in sorted(stack, key=lambda x: x.position):
-            if c.args[0] in self.cluster_response_callbacks:
-                # Remove keys entry, it needs only for cache.
-                c.options.pop("keys", None)
-                c.result = self.cluster_response_callbacks[c.args[0]](
-                    c.result, **c.options
-                )
-            response.append(c.result)
-
-        if raise_on_error:
-            self.raise_first_error(stack)
-
-        return response
-
-    def _fail_on_redirect(self, allow_redirections):
-        """ """
-        if not allow_redirections:
-            raise RedisClusterException(
-                "ASK & MOVED redirection not allowed in this pipeline"
-            )
 
     def exists(self, *keys):
-        return self.execute_command("EXISTS", *keys)
+        return self._execution_strategy.exists(*keys)
 
     def eval(self):
         """ """
-        raise RedisClusterException("method eval() is not implemented")
+        return self._execution_strategy.eval()
 
     def multi(self):
-        """ """
-        raise RedisClusterException("method multi() is not implemented")
-
-    def immediate_execute_command(self, *args, **options):
-        """ """
-        raise RedisClusterException(
-            "method immediate_execute_command() is not implemented"
-        )
+        """
+        Start a transactional block of the pipeline after WATCH commands
+        are issued. End the transactional block with `execute`.
+        """
+        self._execution_strategy.multi()
 
-    def _execute_transaction(self, *args, **kwargs):
+    def load_scripts(self):
         """ """
-        raise RedisClusterException("method _execute_transaction() is not implemented")
+        self._execution_strategy.load_scripts()
 
-    def load_scripts(self):
+    def discard(self):
         """ """
-        raise RedisClusterException("method load_scripts() is not implemented")
+        self._execution_strategy.discard()
 
     def watch(self, *names):
-        """ """
-        raise RedisClusterException("method watch() is not implemented")
+        """Watches the values at keys ``names``"""
+        self._execution_strategy.watch(*names)
 
     def unwatch(self):
-        """ """
-        raise RedisClusterException("method unwatch() is not implemented")
+        """Unwatches all previously specified keys"""
+        self._execution_strategy.unwatch()
 
     def script_load_for_pipeline(self, *args, **kwargs):
-        """ """
-        raise RedisClusterException(
-            "method script_load_for_pipeline() is not implemented"
-        )
+        self._execution_strategy.script_load_for_pipeline(*args, **kwargs)
 
     def delete(self, *names):
-        """
-        "Delete a key specified by ``names``"
-        """
-        if len(names) != 1:
-            raise RedisClusterException(
-                "deleting multiple keys is not implemented in pipeline command"
-            )
-
-        return self.execute_command("DEL", names[0])
+        self._execution_strategy.delete(*names)
 
     def unlink(self, *names):
-        """
-        "Unlink a key specified by ``names``"
-        """
-        if len(names) != 1:
-            raise RedisClusterException(
-                "unlinking multiple keys is not implemented in pipeline command"
-            )
-
-        return self.execute_command("UNLINK", names[0])
+        self._execution_strategy.unlink(*names)
 
 
 def block_pipeline_command(name: str) -> Callable[..., Any]:
@@ -2694,3 +2473,880 @@ def read(self):
                     return
                 except RedisError:
                     c.result = sys.exc_info()[1]
+
+
+class ExecutionStrategy(ABC):
+    @property
+    @abstractmethod
+    def command_queue(self):
+        pass
+
+    @abstractmethod
+    def execute_command(self, *args, **kwargs):
+        """
+        Execution flow for current execution strategy.
+
+        See: ClusterPipeline.execute_command()
+        """
+        pass
+
+    @abstractmethod
+    def annotate_exception(self, exception, number, command):
+        """
+        Annotate exception according to current execution strategy.
+
+        See: ClusterPipeline.annotate_exception()
+        """
+        pass
+
+    @abstractmethod
+    def pipeline_execute_command(self, *args, **options):
+        """
+        Pipeline execution flow for current execution strategy.
+
+        See: ClusterPipeline.pipeline_execute_command()
+        """
+        pass
+
+    @abstractmethod
+    def execute(self, raise_on_error: bool = True) -> List[Any]:
+        """
+        Executes current execution strategy.
+
+        See: ClusterPipeline.execute()
+        """
+        pass
+
+    @abstractmethod
+    def send_cluster_commands(
+        self, stack, raise_on_error=True, allow_redirections=True
+    ):
+        """
+        Sends commands according to current execution strategy.
+
+        See: ClusterPipeline.send_cluster_commands()
+        """
+        pass
+
+    @abstractmethod
+    def reset(self):
+        """
+        Resets current execution strategy.
+
+        See: ClusterPipeline.reset()
+        """
+        pass
+
+    @abstractmethod
+    def exists(self, *keys):
+        pass
+
+    @abstractmethod
+    def eval(self):
+        pass
+
+    @abstractmethod
+    def multi(self):
+        """
+        Starts transactional context.
+
+        See: ClusterPipeline.multi()
+        """
+        pass
+
+    @abstractmethod
+    def load_scripts(self):
+        pass
+
+    @abstractmethod
+    def watch(self, *names):
+        pass
+
+    @abstractmethod
+    def unwatch(self):
+        """
+        Unwatches all previously specified keys
+
+        See: ClusterPipeline.unwatch()
+        """
+        pass
+
+    @abstractmethod
+    def script_load_for_pipeline(self, *args, **kwargs):
+        pass
+
+    @abstractmethod
+    def delete(self, *names):
+        """
+        "Delete a key specified by ``names``"
+
+        See: ClusterPipeline.delete()
+        """
+        pass
+
+    @abstractmethod
+    def unlink(self, *names):
+        """
+        "Unlink a key specified by ``names``"
+
+        See: ClusterPipeline.unlink()
+        """
+        pass
+
+    @abstractmethod
+    def discard(self):
+        pass
+
+
+class AbstractStrategy(ExecutionStrategy):
+    def __init__(
+        self,
+        pipe: ClusterPipeline,
+    ):
+        self._command_queue: List[PipelineCommand] = []
+        self._pipe = pipe
+        self._nodes_manager = self._pipe.nodes_manager
+
+    @property
+    def command_queue(self):
+        return self._command_queue
+
+    @command_queue.setter
+    def command_queue(self, queue: List[PipelineCommand]):
+        self._command_queue = queue
+
+    @abstractmethod
+    def execute_command(self, *args, **kwargs):
+        pass
+
+    def pipeline_execute_command(self, *args, **options):
+        self._command_queue.append(
+            PipelineCommand(args, options, len(self._command_queue))
+        )
+        return self._pipe
+
+    @abstractmethod
+    def execute(self, raise_on_error: bool = True) -> List[Any]:
+        pass
+
+    @abstractmethod
+    def send_cluster_commands(
+        self, stack, raise_on_error=True, allow_redirections=True
+    ):
+        pass
+
+    @abstractmethod
+    def reset(self):
+        pass
+
+    def exists(self, *keys):
+        return self.execute_command("EXISTS", *keys)
+
+    def eval(self):
+        """ """
+        raise RedisClusterException("method eval() is not implemented")
+
+    def load_scripts(self):
+        """ """
+        raise RedisClusterException("method load_scripts() is not implemented")
+
+    def script_load_for_pipeline(self, *args, **kwargs):
+        """ """
+        raise RedisClusterException(
+            "method script_load_for_pipeline() is not implemented"
+        )
+
+    def annotate_exception(self, exception, number, command):
+        """
+        Provides extra context to the exception prior to it being handled
+        """
+        cmd = " ".join(map(safe_str, command))
+        msg = (
+            f"Command # {number} ({truncate_text(cmd)}) of pipeline "
+            f"caused error: {exception.args[0]}"
+        )
+        exception.args = (msg,) + exception.args[1:]
+
+
+class PipelineStrategy(AbstractStrategy):
+    def __init__(self, pipe: ClusterPipeline):
+        super().__init__(pipe)
+        self.command_flags = pipe.command_flags
+
+    def execute_command(self, *args, **kwargs):
+        return self.pipeline_execute_command(*args, **kwargs)
+
+    def _raise_first_error(self, stack):
+        """
+        Raise the first exception on the stack
+        """
+        for c in stack:
+            r = c.result
+            if isinstance(r, Exception):
+                self.annotate_exception(r, c.position + 1, c.args)
+                raise r
+
+    def execute(self, raise_on_error: bool = True) -> List[Any]:
+        stack = self._command_queue
+        if not stack:
+            return []
+
+        try:
+            return self.send_cluster_commands(stack, raise_on_error)
+        finally:
+            self.reset()
+
+    def reset(self):
+        """
+        Reset back to empty pipeline.
+        """
+        self._command_queue = []
+
+    def send_cluster_commands(
+        self, stack, raise_on_error=True, allow_redirections=True
+    ):
+        """
+        Wrapper for RedisCluster.ERRORS_ALLOW_RETRY errors handling.
+
+        If one of the retryable exceptions has been thrown we assume that:
+         - connection_pool was disconnected
+         - connection_pool was reseted
+         - refereh_table_asap set to True
+
+        It will try the number of times specified by
+        the retries in config option "self.retry"
+        which defaults to 3 unless manually configured.
+
+        If it reaches the number of times, the command will
+        raises ClusterDownException.
+        """
+        if not stack:
+            return []
+        retry_attempts = self._pipe.retry.get_retries()
+        while True:
+            try:
+                return self._send_cluster_commands(
+                    stack,
+                    raise_on_error=raise_on_error,
+                    allow_redirections=allow_redirections,
+                )
+            except RedisCluster.ERRORS_ALLOW_RETRY as e:
+                if retry_attempts > 0:
+                    # Try again with the new cluster setup. All other errors
+                    # should be raised.
+                    retry_attempts -= 1
+                    pass
+                else:
+                    raise e
+
+    def _send_cluster_commands(
+        self, stack, raise_on_error=True, allow_redirections=True
+    ):
+        """
+        Send a bunch of cluster commands to the redis cluster.
+
+        `allow_redirections` If the pipeline should follow
+        `ASK` & `MOVED` responses automatically. If set
+        to false it will raise RedisClusterException.
+        """
+        # the first time sending the commands we send all of
+        # the commands that were queued up.
+        # if we have to run through it again, we only retry
+        # the commands that failed.
+        attempt = sorted(stack, key=lambda x: x.position)
+        is_default_node = False
+        # build a list of node objects based on node names we need to
+        nodes = {}
+
+        # as we move through each command that still needs to be processed,
+        # we figure out the slot number that command maps to, then from
+        # the slot determine the node.
+        for c in attempt:
+            while True:
+                # refer to our internal node -> slot table that
+                # tells us where a given command should route to.
+                # (it might be possible we have a cached node that no longer
+                # exists in the cluster, which is why we do this in a loop)
+                passed_targets = c.options.pop("target_nodes", None)
+                if passed_targets and not self._is_nodes_flag(passed_targets):
+                    target_nodes = self._parse_target_nodes(passed_targets)
+                else:
+                    target_nodes = self._determine_nodes(
+                        *c.args, node_flag=passed_targets
+                    )
+                    if not target_nodes:
+                        raise RedisClusterException(
+                            f"No targets were found to execute {c.args} command on"
+                        )
+                if len(target_nodes) > 1:
+                    raise RedisClusterException(
+                        f"Too many targets for command {c.args}"
+                    )
+
+                node = target_nodes[0]
+                if node == self._pipe.get_default_node():
+                    is_default_node = True
+
+                # now that we know the name of the node
+                # ( it's just a string in the form of host:port )
+                # we can build a list of commands for each node.
+                node_name = node.name
+                if node_name not in nodes:
+                    redis_node = self._pipe.get_redis_connection(node)
+                    try:
+                        connection = get_connection(redis_node)
+                    except (ConnectionError, TimeoutError):
+                        for n in nodes.values():
+                            n.connection_pool.release(n.connection)
+                        # Connection retries are being handled in the node's
+                        # Retry object. Reinitialize the node -> slot table.
+                        self._nodes_manager.initialize()
+                        if is_default_node:
+                            self._pipe.replace_default_node()
+                        raise
+                    nodes[node_name] = NodeCommands(
+                        redis_node.parse_response,
+                        redis_node.connection_pool,
+                        connection,
+                    )
+                nodes[node_name].append(c)
+                break
+
+        # send the commands in sequence.
+        # we  write to all the open sockets for each node first,
+        # before reading anything
+        # this allows us to flush all the requests out across the
+        # network
+        # so that we can read them from different sockets as they come back.
+        # we dont' multiplex on the sockets as they come available,
+        # but that shouldn't make too much difference.
+        try:
+            node_commands = nodes.values()
+            for n in node_commands:
+                n.write()
+
+            for n in node_commands:
+                n.read()
+        finally:
+            # release all of the redis connections we allocated earlier
+            # back into the connection pool.
+            # we used to do this step as part of a try/finally block,
+            # but it is really dangerous to
+            # release connections back into the pool if for some
+            # reason the socket has data still left in it
+            # from a previous operation. The write and
+            # read operations already have try/catch around them for
+            # all known types of errors including connection
+            # and socket level errors.
+            # So if we hit an exception, something really bad
+            # happened and putting any oF
+            # these connections back into the pool is a very bad idea.
+            # the socket might have unread buffer still sitting in it,
+            # and then the next time we read from it we pass the
+            # buffered result back from a previous command and
+            # every single request after to that connection will always get
+            # a mismatched result.
+            for n in nodes.values():
+                n.connection_pool.release(n.connection)
+
+        # if the response isn't an exception it is a
+        # valid response from the node
+        # we're all done with that command, YAY!
+        # if we have more commands to attempt, we've run into problems.
+        # collect all the commands we are allowed to retry.
+        # (MOVED, ASK, or connection errors or timeout errors)
+        attempt = sorted(
+            (
+                c
+                for c in attempt
+                if isinstance(c.result, ClusterPipeline.ERRORS_ALLOW_RETRY)
+            ),
+            key=lambda x: x.position,
+        )
+        if attempt and allow_redirections:
+            # RETRY MAGIC HAPPENS HERE!
+            # send these remaining commands one at a time using `execute_command`
+            # in the main client. This keeps our retry logic
+            # in one place mostly,
+            # and allows us to be more confident in correctness of behavior.
+            # at this point any speed gains from pipelining have been lost
+            # anyway, so we might as well make the best
+            # attempt to get the correct behavior.
+            #
+            # The client command will handle retries for each
+            # individual command sequentially as we pass each
+            # one into `execute_command`. Any exceptions
+            # that bubble out should only appear once all
+            # retries have been exhausted.
+            #
+            # If a lot of commands have failed, we'll be setting the
+            # flag to rebuild the slots table from scratch.
+            # So MOVED errors should correct themselves fairly quickly.
+            self._pipe.reinitialize_counter += 1
+            if self._pipe._should_reinitialized():
+                self._nodes_manager.initialize()
+                if is_default_node:
+                    self._pipe.replace_default_node()
+            for c in attempt:
+                try:
+                    # send each command individually like we
+                    # do in the main client.
+                    c.result = self._pipe.parent_execute_command(*c.args, **c.options)
+                except RedisError as e:
+                    c.result = e
+
+        # turn the response back into a simple flat array that corresponds
+        # to the sequence of commands issued in the stack in pipeline.execute()
+        response = []
+        for c in sorted(stack, key=lambda x: x.position):
+            if c.args[0] in self._pipe.cluster_response_callbacks:
+                # Remove keys entry, it needs only for cache.
+                c.options.pop("keys", None)
+                c.result = self._pipe.cluster_response_callbacks[c.args[0]](
+                    c.result, **c.options
+                )
+            response.append(c.result)
+
+        if raise_on_error:
+            self._raise_first_error(stack)
+
+        return response
+
+    def _is_nodes_flag(self, target_nodes):
+        return isinstance(target_nodes, str) and target_nodes in self._pipe.node_flags
+
+    def _parse_target_nodes(self, target_nodes):
+        if isinstance(target_nodes, list):
+            nodes = target_nodes
+        elif isinstance(target_nodes, ClusterNode):
+            # Supports passing a single ClusterNode as a variable
+            nodes = [target_nodes]
+        elif isinstance(target_nodes, dict):
+            # Supports dictionaries of the format {node_name: node}.
+            # It enables to execute commands with multi nodes as follows:
+            # rc.cluster_save_config(rc.get_primaries())
+            nodes = target_nodes.values()
+        else:
+            raise TypeError(
+                "target_nodes type can be one of the following: "
+                "node_flag (PRIMARIES, REPLICAS, RANDOM, ALL_NODES),"
+                "ClusterNode, list<ClusterNode>, or dict<any, ClusterNode>. "
+                f"The passed type is {type(target_nodes)}"
+            )
+        return nodes
+
+    def _determine_nodes(self, *args, **kwargs) -> List["ClusterNode"]:
+        # Determine which nodes should be executed the command on.
+        # Returns a list of target nodes.
+        command = args[0].upper()
+        if (
+            len(args) >= 2
+            and f"{args[0]} {args[1]}".upper() in self._pipe.command_flags
+        ):
+            command = f"{args[0]} {args[1]}".upper()
+
+        nodes_flag = kwargs.pop("nodes_flag", None)
+        if nodes_flag is not None:
+            # nodes flag passed by the user
+            command_flag = nodes_flag
+        else:
+            # get the nodes group for this command if it was predefined
+            command_flag = self._pipe.command_flags.get(command)
+        if command_flag == self._pipe.RANDOM:
+            # return a random node
+            return [self._pipe.get_random_node()]
+        elif command_flag == self._pipe.PRIMARIES:
+            # return all primaries
+            return self._pipe.get_primaries()
+        elif command_flag == self._pipe.REPLICAS:
+            # return all replicas
+            return self._pipe.get_replicas()
+        elif command_flag == self._pipe.ALL_NODES:
+            # return all nodes
+            return self._pipe.get_nodes()
+        elif command_flag == self._pipe.DEFAULT_NODE:
+            # return the cluster's default node
+            return [self._nodes_manager.default_node]
+        elif command in self._pipe.SEARCH_COMMANDS[0]:
+            return [self._nodes_manager.default_node]
+        else:
+            # get the node that holds the key's slot
+            slot = self._pipe.determine_slot(*args)
+            node = self._nodes_manager.get_node_from_slot(
+                slot,
+                self._pipe.read_from_replicas and command in READ_COMMANDS,
+                self._pipe.load_balancing_strategy
+                if command in READ_COMMANDS
+                else None,
+            )
+            return [node]
+
+    def multi(self):
+        raise RedisClusterException(
+            "method multi() is not supported outside of transactional context"
+        )
+
+    def discard(self):
+        raise RedisClusterException(
+            "method discard() is not supported outside of transactional context"
+        )
+
+    def watch(self, *names):
+        raise RedisClusterException(
+            "method watch() is not supported outside of transactional context"
+        )
+
+    def unwatch(self, *names):
+        raise RedisClusterException(
+            "method unwatch() is not supported outside of transactional context"
+        )
+
+    def delete(self, *names):
+        if len(names) != 1:
+            raise RedisClusterException(
+                "deleting multiple keys is not implemented in pipeline command"
+            )
+
+        return self.execute_command("DEL", names[0])
+
+    def unlink(self, *names):
+        if len(names) != 1:
+            raise RedisClusterException(
+                "unlinking multiple keys is not implemented in pipeline command"
+            )
+
+        return self.execute_command("UNLINK", names[0])
+
+
+class TransactionStrategy(AbstractStrategy):
+    NO_SLOTS_COMMANDS = {"UNWATCH"}
+    IMMEDIATE_EXECUTE_COMMANDS = {"WATCH", "UNWATCH"}
+    UNWATCH_COMMANDS = {"DISCARD", "EXEC", "UNWATCH"}
+    SLOT_REDIRECT_ERRORS = (AskError, MovedError)
+    CONNECTION_ERRORS = (
+        ConnectionError,
+        OSError,
+        ClusterDownError,
+        SlotNotCoveredError,
+    )
+
+    def __init__(self, pipe: ClusterPipeline):
+        super().__init__(pipe)
+        self._explicit_transaction = False
+        self._watching = False
+        self._pipeline_slots: Set[int] = set()
+        self._transaction_connection: Optional[Connection] = None
+        self._executing = False
+        self._retry = copy(self._pipe.retry)
+        self._retry.update_supported_errors(
+            RedisCluster.ERRORS_ALLOW_RETRY + self.SLOT_REDIRECT_ERRORS
+        )
+
+    def _get_client_and_connection_for_transaction(self) -> Tuple[Redis, Connection]:
+        """
+        Find a connection for a pipeline transaction.
+
+        For running an atomic transaction, watch keys ensure that contents have not been
+        altered as long as the watch commands for those keys were sent over the same
+        connection. So once we start watching a key, we fetch a connection to the
+        node that owns that slot and reuse it.
+        """
+        if not self._pipeline_slots:
+            raise RedisClusterException(
+                "At least a command with a key is needed to identify a node"
+            )
+
+        node: ClusterNode = self._nodes_manager.get_node_from_slot(
+            list(self._pipeline_slots)[0], False
+        )
+        redis_node: Redis = self._pipe.get_redis_connection(node)
+        if self._transaction_connection:
+            if not redis_node.connection_pool.owns_connection(
+                self._transaction_connection
+            ):
+                previous_node = self._nodes_manager.find_connection_owner(
+                    self._transaction_connection
+                )
+                previous_node.connection_pool.release(self._transaction_connection)
+                self._transaction_connection = None
+
+        if not self._transaction_connection:
+            self._transaction_connection = get_connection(redis_node)
+
+        return redis_node, self._transaction_connection
+
+    def execute_command(self, *args, **kwargs):
+        slot_number: Optional[int] = None
+        if args[0] not in ClusterPipeline.NO_SLOTS_COMMANDS:
+            slot_number = self._pipe.determine_slot(*args)
+
+        if (
+            self._watching or args[0] in self.IMMEDIATE_EXECUTE_COMMANDS
+        ) and not self._explicit_transaction:
+            if args[0] == "WATCH":
+                self._validate_watch()
+
+            if slot_number is not None:
+                if self._pipeline_slots and slot_number not in self._pipeline_slots:
+                    raise CrossSlotTransactionError(
+                        "Cannot watch or send commands on different slots"
+                    )
+
+                self._pipeline_slots.add(slot_number)
+            elif args[0] not in self.NO_SLOTS_COMMANDS:
+                raise RedisClusterException(
+                    f"Cannot identify slot number for command: {args[0]},"
+                    "it cannot be triggered in a transaction"
+                )
+
+            return self._immediate_execute_command(*args, **kwargs)
+        else:
+            if slot_number is not None:
+                self._pipeline_slots.add(slot_number)
+
+            return self.pipeline_execute_command(*args, **kwargs)
+
+    def _validate_watch(self):
+        if self._explicit_transaction:
+            raise RedisError("Cannot issue a WATCH after a MULTI")
+
+        self._watching = True
+
+    def _immediate_execute_command(self, *args, **options):
+        return self._retry.call_with_retry(
+            lambda: self._get_connection_and_send_command(*args, **options),
+            self._reinitialize_on_error,
+        )
+
+    def _get_connection_and_send_command(self, *args, **options):
+        redis_node, connection = self._get_client_and_connection_for_transaction()
+        return self._send_command_parse_response(
+            connection, redis_node, args[0], *args, **options
+        )
+
+    def _send_command_parse_response(
+        self, conn, redis_node: Redis, command_name, *args, **options
+    ):
+        """
+        Send a command and parse the response
+        """
+
+        conn.send_command(*args)
+        output = redis_node.parse_response(conn, command_name, **options)
+
+        if command_name in self.UNWATCH_COMMANDS:
+            self._watching = False
+        return output
+
+    def _reinitialize_on_error(self, error):
+        if self._watching:
+            if type(error) in self.SLOT_REDIRECT_ERRORS and self._executing:
+                raise WatchError("Slot rebalancing occurred while watching keys")
+
+        if (
+            type(error) in self.SLOT_REDIRECT_ERRORS
+            or type(error) in self.CONNECTION_ERRORS
+        ):
+            if self._transaction_connection:
+                self._transaction_connection = None
+
+            self._pipe.reinitialize_counter += 1
+            if self._pipe._should_reinitialized():
+                self._nodes_manager.initialize()
+                self.reinitialize_counter = 0
+            else:
+                self._nodes_manager.update_moved_exception(error)
+
+        self._executing = False
+
+    def _raise_first_error(self, responses, stack):
+        """
+        Raise the first exception on the stack
+        """
+        for r, cmd in zip(responses, stack):
+            if isinstance(r, Exception):
+                self.annotate_exception(r, cmd.position + 1, cmd.args)
+                raise r
+
+    def execute(self, raise_on_error: bool = True) -> List[Any]:
+        stack = self._command_queue
+        if not stack and (not self._watching or not self._pipeline_slots):
+            return []
+
+        return self._execute_transaction_with_retries(stack, raise_on_error)
+
+    def _execute_transaction_with_retries(
+        self, stack: List["PipelineCommand"], raise_on_error: bool
+    ):
+        return self._retry.call_with_retry(
+            lambda: self._execute_transaction(stack, raise_on_error),
+            self._reinitialize_on_error,
+        )
+
+    def _execute_transaction(
+        self, stack: List["PipelineCommand"], raise_on_error: bool
+    ):
+        if len(self._pipeline_slots) > 1:
+            raise CrossSlotTransactionError(
+                "All keys involved in a cluster transaction must map to the same slot"
+            )
+
+        self._executing = True
+
+        redis_node, connection = self._get_client_and_connection_for_transaction()
+
+        stack = chain(
+            [PipelineCommand(("MULTI",))],
+            stack,
+            [PipelineCommand(("EXEC",))],
+        )
+        commands = [c.args for c in stack if EMPTY_RESPONSE not in c.options]
+        packed_commands = connection.pack_commands(commands)
+        connection.send_packed_command(packed_commands)
+        errors = []
+
+        # parse off the response for MULTI
+        # NOTE: we need to handle ResponseErrors here and continue
+        # so that we read all the additional command messages from
+        # the socket
+        try:
+            redis_node.parse_response(connection, "MULTI")
+        except ResponseError as e:
+            self.annotate_exception(e, 0, "MULTI")
+            errors.append(e)
+        except self.CONNECTION_ERRORS as cluster_error:
+            self.annotate_exception(cluster_error, 0, "MULTI")
+            raise
+
+        # and all the other commands
+        for i, command in enumerate(self._command_queue):
+            if EMPTY_RESPONSE in command.options:
+                errors.append((i, command.options[EMPTY_RESPONSE]))
+            else:
+                try:
+                    _ = redis_node.parse_response(connection, "_")
+                except self.SLOT_REDIRECT_ERRORS as slot_error:
+                    self.annotate_exception(slot_error, i + 1, command.args)
+                    errors.append(slot_error)
+                except self.CONNECTION_ERRORS as cluster_error:
+                    self.annotate_exception(cluster_error, i + 1, command.args)
+                    raise
+                except ResponseError as e:
+                    self.annotate_exception(e, i + 1, command.args)
+                    errors.append(e)
+
+        response = None
+        # parse the EXEC.
+        try:
+            response = redis_node.parse_response(connection, "EXEC")
+        except ExecAbortError:
+            if errors:
+                raise errors[0]
+            raise
+
+        self._executing = False
+
+        # EXEC clears any watched keys
+        self._watching = False
+
+        if response is None:
+            raise WatchError("Watched variable changed.")
+
+        # put any parse errors into the response
+        for i, e in errors:
+            response.insert(i, e)
+
+        if len(response) != len(self._command_queue):
+            raise InvalidPipelineStack(
+                "Unexpected response length for cluster pipeline EXEC."
+                " Command stack was {} but response had length {}".format(
+                    [c.args[0] for c in self._command_queue], len(response)
+                )
+            )
+
+        # find any errors in the response and raise if necessary
+        if raise_on_error or len(errors) > 0:
+            self._raise_first_error(
+                response,
+                self._command_queue,
+            )
+
+        # We have to run response callbacks manually
+        data = []
+        for r, cmd in zip(response, self._command_queue):
+            if not isinstance(r, Exception):
+                command_name = cmd.args[0]
+                if command_name in self._pipe.cluster_response_callbacks:
+                    r = self._pipe.cluster_response_callbacks[command_name](
+                        r, **cmd.options
+                    )
+            data.append(r)
+        return data
+
+    def reset(self):
+        self._command_queue = []
+
+        # make sure to reset the connection state in the event that we were
+        # watching something
+        if self._transaction_connection:
+            try:
+                # call this manually since our unwatch or
+                # immediate_execute_command methods can call reset()
+                self._transaction_connection.send_command("UNWATCH")
+                self._transaction_connection.read_response()
+                # we can safely return the connection to the pool here since we're
+                # sure we're no longer WATCHing anything
+                node = self._nodes_manager.find_connection_owner(
+                    self._transaction_connection
+                )
+                node.redis_connection.connection_pool.release(
+                    self._transaction_connection
+                )
+                self._transaction_connection = None
+            except self.CONNECTION_ERRORS:
+                # disconnect will also remove any previous WATCHes
+                if self._transaction_connection:
+                    self._transaction_connection.disconnect()
+
+        # clean up the other instance attributes
+        self._watching = False
+        self._explicit_transaction = False
+        self._pipeline_slots = set()
+        self._executing = False
+
+    def send_cluster_commands(
+        self, stack, raise_on_error=True, allow_redirections=True
+    ):
+        raise NotImplementedError(
+            "send_cluster_commands cannot be executed in transactional context."
+        )
+
+    def multi(self):
+        if self._explicit_transaction:
+            raise RedisError("Cannot issue nested calls to MULTI")
+        if self._command_queue:
+            raise RedisError(
+                "Commands without an initial WATCH have already been issued"
+            )
+        self._explicit_transaction = True
+
+    def watch(self, *names):
+        if self._explicit_transaction:
+            raise RedisError("Cannot issue a WATCH after a MULTI")
+
+        return self.execute_command("WATCH", *names)
+
+    def unwatch(self):
+        if self._watching:
+            return self.execute_command("UNWATCH")
+
+        return True
+
+    def discard(self):
+        self.reset()
+
+    def delete(self, *names):
+        return self.execute_command("DEL", *names)
+
+    def unlink(self, *names):
+        return self.execute_command("UNLINK", *names)
diff --git a/redis/exceptions.py b/redis/exceptions.py
index bad447a086..a00ac65ac1 100644
--- a/redis/exceptions.py
+++ b/redis/exceptions.py
@@ -221,3 +221,21 @@ class SlotNotCoveredError(RedisClusterException):
 
 
 class MaxConnectionsError(ConnectionError): ...
+
+
+class CrossSlotTransactionError(RedisClusterException):
+    """
+    Raised when a transaction or watch is triggered in a pipeline
+    and not all keys or all commands belong to the same slot.
+    """
+
+    pass
+
+
+class InvalidPipelineStack(RedisClusterException):
+    """
+    Raised on unexpected response length on pipelines. This is
+    most likely a handling error on the stack.
+    """
+
+    pass
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index d4e48e199b..d360ab07f7 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -3015,24 +3015,10 @@ def test_blocked_methods(self, r):
         They maybe implemented in the future.
         """
         pipe = r.pipeline()
-        with pytest.raises(RedisClusterException):
-            pipe.multi()
-
-        with pytest.raises(RedisClusterException):
-            pipe.immediate_execute_command()
-
-        with pytest.raises(RedisClusterException):
-            pipe._execute_transaction(None, None, None)
 
         with pytest.raises(RedisClusterException):
             pipe.load_scripts()
 
-        with pytest.raises(RedisClusterException):
-            pipe.watch()
-
-        with pytest.raises(RedisClusterException):
-            pipe.unwatch()
-
         with pytest.raises(RedisClusterException):
             pipe.script_load_for_pipeline(None)
 
@@ -3044,14 +3030,6 @@ def test_blocked_arguments(self, r):
         Currently some arguments is blocked when using in cluster mode.
         They maybe implemented in the future.
         """
-        with pytest.raises(RedisClusterException) as ex:
-            r.pipeline(transaction=True)
-
-        assert (
-            str(ex.value).startswith("transaction is deprecated in cluster mode")
-            is True
-        )
-
         with pytest.raises(RedisClusterException) as ex:
             r.pipeline(shard_hint=True)
 
@@ -3109,7 +3087,7 @@ def test_delete_single(self, r):
             pipe.delete("a")
             assert pipe.execute() == [1]
 
-    def test_multi_delete_unsupported(self, r):
+    def test_multi_delete_unsupported_cross_slot(self, r):
         """
         Test that multi delete operation is unsupported
         """
@@ -3119,6 +3097,16 @@ def test_multi_delete_unsupported(self, r):
             with pytest.raises(RedisClusterException):
                 pipe.delete("a", "b")
 
+    def test_multi_delete_supported_single_slot(self, r):
+        """
+        Test that multi delete operation is supported when all keys are in the same hash slot
+        """
+        with r.pipeline(transaction=True) as pipe:
+            r["{key}:a"] = 1
+            r["{key}:b"] = 2
+            pipe.delete("{key}:a", "{key}:b")
+            assert pipe.execute()
+
     def test_unlink_single(self, r):
         """
         Test a single unlink operation
@@ -3374,6 +3362,87 @@ def test_empty_stack(self, r):
         result = p.execute()
         assert result == []
 
+    @pytest.mark.onlycluster
+    def test_exec_error_in_response(self, r):
+        """
+        an invalid pipeline command at exec time adds the exception instance
+        to the list of returned values
+        """
+        hashkey = "{key}"
+        r[f"{hashkey}:c"] = "a"
+        with r.pipeline() as pipe:
+            pipe.set(f"{hashkey}:a", 1).set(f"{hashkey}:b", 2)
+            pipe.lpush(f"{hashkey}:c", 3).set(f"{hashkey}:d", 4)
+            result = pipe.execute(raise_on_error=False)
+
+            assert result[0]
+            assert r[f"{hashkey}:a"] == b"1"
+            assert result[1]
+            assert r[f"{hashkey}:b"] == b"2"
+
+            # we can't lpush to a key that's a string value, so this should
+            # be a ResponseError exception
+            assert isinstance(result[2], redis.ResponseError)
+            assert r[f"{hashkey}:c"] == b"a"
+
+            # since this isn't a transaction, the other commands after the
+            # error are still executed
+            assert result[3]
+            assert r[f"{hashkey}:d"] == b"4"
+
+            # make sure the pipe was restored to a working state
+            assert pipe.set(f"{hashkey}:z", "zzz").execute() == [True]
+            assert r[f"{hashkey}:z"] == b"zzz"
+
+    def test_exec_error_in_no_transaction_pipeline(self, r):
+        r["a"] = 1
+        with r.pipeline(transaction=False) as pipe:
+            pipe.llen("a")
+            pipe.expire("a", 100)
+
+            with pytest.raises(redis.ResponseError) as ex:
+                pipe.execute()
+
+            assert str(ex.value).startswith(
+                "Command # 1 (LLEN a) of pipeline caused error: "
+            )
+
+        assert r["a"] == b"1"
+
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("2.0.0")
+    def test_pipeline_discard(self, r):
+        hashkey = "{key}"
+
+        # empty pipeline should raise an error
+        with r.pipeline() as pipe:
+            pipe.set(f"{hashkey}:key", "someval")
+            with pytest.raises(redis.exceptions.RedisClusterException) as ex:
+                pipe.discard()
+
+            assert str(ex.value).startswith(
+                "method discard() is not supported outside of transactional context"
+            )
+
+        # setting a pipeline and discarding should do the same
+        with r.pipeline() as pipe:
+            pipe.set(f"{hashkey}:key", "someval")
+            pipe.set(f"{hashkey}:someotherkey", "val")
+            response = pipe.execute()
+            pipe.set(f"{hashkey}:key", "another value!")
+            with pytest.raises(redis.exceptions.RedisClusterException) as ex:
+                pipe.discard()
+
+            assert str(ex.value).startswith(
+                "method discard() is not supported outside of transactional context"
+            )
+
+            pipe.set(f"{hashkey}:foo", "bar")
+            response = pipe.execute()
+
+        assert response[0]
+        assert r.get(f"{hashkey}:foo") == b"bar"
+
 
 @pytest.mark.onlycluster
 class TestReadOnlyPipeline:
diff --git a/tests/test_cluster_transaction.py b/tests/test_cluster_transaction.py
new file mode 100644
index 0000000000..0eb7a4f256
--- /dev/null
+++ b/tests/test_cluster_transaction.py
@@ -0,0 +1,392 @@
+import threading
+from typing import Tuple
+from unittest.mock import patch, Mock
+
+import pytest
+
+import redis
+from redis import CrossSlotTransactionError, ConnectionPool, RedisClusterException
+from redis.backoff import NoBackoff
+from redis.client import Redis
+from redis.cluster import PRIMARY, ClusterNode, NodesManager, RedisCluster
+from redis.retry import Retry
+
+from .conftest import skip_if_server_version_lt
+
+
+def _find_source_and_target_node_for_slot(
+    r: RedisCluster, slot: int
+) -> Tuple[ClusterNode, ClusterNode]:
+    """Returns a pair of ClusterNodes, where the first node is the
+    one that owns the slot and the second is a possible target
+    for that slot, i.e. a primary node different from the first
+    one.
+    """
+    node_migrating = r.nodes_manager.get_node_from_slot(slot)
+    assert node_migrating, f"No node could be found that owns slot #{slot}"
+
+    available_targets = [
+        n
+        for n in r.nodes_manager.startup_nodes.values()
+        if node_migrating.name != n.name and n.server_type == PRIMARY
+    ]
+
+    assert available_targets, f"No possible target nodes for slot #{slot}"
+    return node_migrating, available_targets[0]
+
+
+class TestClusterTransaction:
+    @pytest.mark.onlycluster
+    def test_pipeline_is_true(self, r):
+        "Ensure pipeline instances are not false-y"
+        with r.pipeline(transaction=True) as pipe:
+            assert pipe
+
+    @pytest.mark.onlycluster
+    def test_pipeline_empty_transaction(self, r):
+        r["a"] = 0
+
+        with r.pipeline(transaction=True) as pipe:
+            assert pipe.execute() == []
+
+    @pytest.mark.onlycluster
+    def test_executes_transaction_against_cluster(self, r):
+        with r.pipeline(transaction=True) as tx:
+            tx.set("{foo}bar", "value1")
+            tx.set("{foo}baz", "value2")
+            tx.set("{foo}bad", "value3")
+            tx.get("{foo}bar")
+            tx.get("{foo}baz")
+            tx.get("{foo}bad")
+            assert tx.execute() == [
+                b"OK",
+                b"OK",
+                b"OK",
+                b"value1",
+                b"value2",
+                b"value3",
+            ]
+
+        r.flushall()
+
+        tx = r.pipeline(transaction=True)
+        tx.set("{foo}bar", "value1")
+        tx.set("{foo}baz", "value2")
+        tx.set("{foo}bad", "value3")
+        tx.get("{foo}bar")
+        tx.get("{foo}baz")
+        tx.get("{foo}bad")
+        assert tx.execute() == [b"OK", b"OK", b"OK", b"value1", b"value2", b"value3"]
+
+    @pytest.mark.onlycluster
+    def test_throws_exception_on_different_hash_slots(self, r):
+        with r.pipeline(transaction=True) as tx:
+            tx.set("{foo}bar", "value1")
+            tx.set("{foobar}baz", "value2")
+
+            with pytest.raises(
+                CrossSlotTransactionError,
+                match="All keys involved in a cluster transaction must map to the same slot",
+            ):
+                tx.execute()
+
+    @pytest.mark.onlycluster
+    def test_throws_exception_with_watch_on_different_hash_slots(self, r):
+        with r.pipeline(transaction=True) as tx:
+            with pytest.raises(
+                RedisClusterException,
+                match="WATCH - all keys must map to the same key slot",
+            ):
+                tx.watch("key1", "key2")
+
+    @pytest.mark.onlycluster
+    def test_transaction_with_watched_keys(self, r):
+        r["a"] = 0
+
+        with r.pipeline(transaction=True) as pipe:
+            pipe.watch("a")
+            a = pipe.get("a")
+            pipe.multi()
+            pipe.set("a", int(a) + 1)
+            assert pipe.execute() == [b"OK"]
+
+    @pytest.mark.onlycluster
+    def test_retry_transaction_during_unfinished_slot_migration(self, r):
+        """
+        When a transaction is triggered during a migration, MovedError
+        or AskError may appear (depends on the key being already migrated
+        or the key not existing already). The patch on parse_response
+        simulates such an error, but the slot cache is not updated
+        (meaning the migration is still ongogin) so the pipeline eventually
+        fails as if it was retried but the migration is not yet complete.
+        """
+        key = "book"
+        slot = r.keyslot(key)
+        node_migrating, node_importing = _find_source_and_target_node_for_slot(r, slot)
+
+        with patch.object(Redis, "parse_response") as parse_response, patch.object(
+            NodesManager, "_update_moved_slots"
+        ) as manager_update_moved_slots:
+
+            def ask_redirect_effect(connection, *args, **options):
+                if "MULTI" in args:
+                    return
+                elif "EXEC" in args:
+                    raise redis.exceptions.ExecAbortError()
+
+                raise redis.exceptions.AskError(f"{slot} {node_importing.name}")
+
+            parse_response.side_effect = ask_redirect_effect
+
+            with r.pipeline(transaction=True) as pipe:
+                pipe.set(key, "val")
+                with pytest.raises(redis.exceptions.AskError) as ex:
+                    pipe.execute()
+
+                assert str(ex.value).startswith(
+                    "Command # 1 (SET book val) of pipeline caused error:"
+                    f" {slot} {node_importing.name}"
+                )
+
+            manager_update_moved_slots.assert_called()
+
+    @pytest.mark.onlycluster
+    def test_retry_transaction_during_slot_migration_successful(self, r):
+        """
+        If a MovedError or AskError appears when calling EXEC and no key is watched,
+        the pipeline is retried after updating the node manager slot table. If the
+        migration was completed, the transaction may then complete successfully.
+        """
+        key = "book"
+        slot = r.keyslot(key)
+        node_migrating, node_importing = _find_source_and_target_node_for_slot(r, slot)
+
+        with patch.object(Redis, "parse_response") as parse_response, patch.object(
+            NodesManager, "_update_moved_slots"
+        ) as manager_update_moved_slots:
+
+            def ask_redirect_effect(conn, *args, **options):
+                # first call should go here, we trigger an AskError
+                if f"{conn.host}:{conn.port}" == node_migrating.name:
+                    if "MULTI" in args:
+                        return
+                    elif "EXEC" in args:
+                        raise redis.exceptions.ExecAbortError()
+
+                    raise redis.exceptions.AskError(f"{slot} {node_importing.name}")
+                # if the slot table is updated, the next call will go here
+                elif f"{conn.host}:{conn.port}" == node_importing.name:
+                    if "EXEC" in args:
+                        return [
+                            "MOCK_OK"
+                        ]  # mock value to validate this section was called
+                    return
+                else:
+                    assert False, f"unexpected node {conn.host}:{conn.port} was called"
+
+            def update_moved_slot():  # simulate slot table update
+                ask_error = r.nodes_manager._moved_exception
+                assert ask_error is not None, "No AskError was previously triggered"
+                assert f"{ask_error.host}:{ask_error.port}" == node_importing.name
+                r.nodes_manager._moved_exception = None
+                r.nodes_manager.slots_cache[slot] = [node_importing]
+
+            parse_response.side_effect = ask_redirect_effect
+            manager_update_moved_slots.side_effect = update_moved_slot
+
+            result = None
+            with r.pipeline(transaction=True) as pipe:
+                pipe.multi()
+                pipe.set(key, "val")
+                result = pipe.execute()
+
+            assert result and "MOCK_OK" in result, "Target node was not called"
+
+    @pytest.mark.onlycluster
+    def test_retry_transaction_with_watch_after_slot_migration(self, r):
+        """
+        If a MovedError or AskError appears when calling WATCH, the client
+        must attempt to recover itself before proceeding and no WatchError
+        should appear.
+        """
+        key = "book"
+        slot = r.keyslot(key)
+        r.reinitialize_steps = 1
+
+        # force a MovedError on the first call to pipe.watch()
+        # by switching the node that owns the slot to another one
+        _node_migrating, node_importing = _find_source_and_target_node_for_slot(r, slot)
+        r.nodes_manager.slots_cache[slot] = [node_importing]
+
+        with r.pipeline(transaction=True) as pipe:
+            pipe.watch(key)
+            pipe.multi()
+            pipe.set(key, "val")
+            assert pipe.execute() == [b"OK"]
+
+    @pytest.mark.onlycluster
+    def test_retry_transaction_with_watch_during_slot_migration(self, r):
+        """
+        If a MovedError or AskError appears when calling EXEC and keys were
+        being watched before the migration started, a WatchError should appear.
+        These errors imply resetting the connection and connecting to a new node,
+        so watches are lost anyway and the client code must be notified.
+        """
+        key = "book"
+        slot = r.keyslot(key)
+        node_migrating, node_importing = _find_source_and_target_node_for_slot(r, slot)
+
+        with patch.object(Redis, "parse_response") as parse_response:
+
+            def ask_redirect_effect(conn, *args, **options):
+                if f"{conn.host}:{conn.port}" == node_migrating.name:
+                    # we simulate the watch was sent before the migration started
+                    if "WATCH" in args:
+                        return b"OK"
+                    # but the pipeline was triggered after the migration started
+                    elif "MULTI" in args:
+                        return
+                    elif "EXEC" in args:
+                        raise redis.exceptions.ExecAbortError()
+
+                    raise redis.exceptions.AskError(f"{slot} {node_importing.name}")
+                # we should not try to connect to any other node
+                else:
+                    assert False, f"unexpected node {conn.host}:{conn.port} was called"
+
+            parse_response.side_effect = ask_redirect_effect
+
+            with r.pipeline(transaction=True) as pipe:
+                pipe.watch(key)
+                pipe.multi()
+                pipe.set(key, "val")
+                with pytest.raises(redis.exceptions.WatchError) as ex:
+                    pipe.execute()
+
+                assert str(ex.value).startswith(
+                    "Slot rebalancing occurred while watching keys"
+                )
+
+    @pytest.mark.onlycluster
+    def test_retry_transaction_on_connection_error(self, r, mock_connection):
+        key = "book"
+        slot = r.keyslot(key)
+
+        mock_connection.read_response.side_effect = redis.exceptions.ConnectionError(
+            "Conn error"
+        )
+        mock_connection.retry = Retry(NoBackoff(), 0)
+        mock_pool = Mock(spec=ConnectionPool)
+        mock_pool.get_connection.return_value = mock_connection
+        mock_pool._available_connections = [mock_connection]
+        mock_pool._lock = threading.Lock()
+
+        _node_migrating, node_importing = _find_source_and_target_node_for_slot(r, slot)
+        node_importing.redis_connection.connection_pool = mock_pool
+        r.nodes_manager.slots_cache[slot] = [node_importing]
+        r.reinitialize_steps = 1
+
+        with r.pipeline(transaction=True) as pipe:
+            pipe.set(key, "val")
+            assert pipe.execute() == [b"OK"]
+
+    @pytest.mark.onlycluster
+    def test_retry_transaction_on_connection_error_with_watched_keys(
+        self, r, mock_connection
+    ):
+        key = "book"
+        slot = r.keyslot(key)
+
+        mock_connection.read_response.side_effect = redis.exceptions.ConnectionError(
+            "Conn error"
+        )
+        mock_connection.retry = Retry(NoBackoff(), 0)
+        mock_pool = Mock(spec=ConnectionPool)
+        mock_pool.get_connection.return_value = mock_connection
+        mock_pool._available_connections = [mock_connection]
+        mock_pool._lock = threading.Lock()
+
+        _node_migrating, node_importing = _find_source_and_target_node_for_slot(r, slot)
+        node_importing.redis_connection.connection_pool = mock_pool
+        r.nodes_manager.slots_cache[slot] = [node_importing]
+        r.reinitialize_steps = 1
+
+        with r.pipeline(transaction=True) as pipe:
+            pipe.watch(key)
+            pipe.multi()
+            pipe.set(key, "val")
+            assert pipe.execute() == [b"OK"]
+
+    @pytest.mark.onlycluster
+    def test_exec_error_raised(self, r):
+        hashkey = "{key}"
+        r[f"{hashkey}:c"] = "a"
+        with r.pipeline(transaction=True) as pipe:
+            pipe.set(f"{hashkey}:a", 1).set(f"{hashkey}:b", 2)
+            pipe.lpush(f"{hashkey}:c", 3).set(f"{hashkey}:d", 4)
+            with pytest.raises(redis.ResponseError) as ex:
+                pipe.execute()
+            assert str(ex.value).startswith(
+                "Command # 3 (LPUSH {key}:c 3) of pipeline caused error: "
+            )
+
+            # make sure the pipe was restored to a working state
+            assert pipe.set(f"{hashkey}:z", "zzz").execute() == [b"OK"]
+            assert r[f"{hashkey}:z"] == b"zzz"
+
+    @pytest.mark.onlycluster
+    def test_parse_error_raised(self, r):
+        hashkey = "{key}"
+        with r.pipeline(transaction=True) as pipe:
+            # the zrem is invalid because we don't pass any keys to it
+            pipe.set(f"{hashkey}:a", 1).zrem(f"{hashkey}:b").set(f"{hashkey}:b", 2)
+            with pytest.raises(redis.ResponseError) as ex:
+                pipe.execute()
+
+            assert str(ex.value).startswith(
+                "Command # 2 (ZREM {key}:b) of pipeline caused error: wrong number"
+            )
+
+            # make sure the pipe was restored to a working state
+            assert pipe.set(f"{hashkey}:z", "zzz").execute() == [b"OK"]
+            assert r[f"{hashkey}:z"] == b"zzz"
+
+    @pytest.mark.onlycluster
+    def test_transaction_callable(self, r):
+        hashkey = "{key}"
+        r[f"{hashkey}:a"] = 1
+        r[f"{hashkey}:b"] = 2
+        has_run = []
+
+        def my_transaction(pipe):
+            a_value = pipe.get(f"{hashkey}:a")
+            assert a_value in (b"1", b"2")
+            b_value = pipe.get(f"{hashkey}:b")
+            assert b_value == b"2"
+
+            # silly run-once code... incr's "a" so WatchError should be raised
+            # forcing this all to run again. this should incr "a" once to "2"
+            if not has_run:
+                r.incr(f"{hashkey}:a")
+                has_run.append("it has")
+
+            pipe.multi()
+            pipe.set(f"{hashkey}:c", int(a_value) + int(b_value))
+
+        result = r.transaction(my_transaction, f"{hashkey}:a", f"{hashkey}:b")
+        assert result == [b"OK"]
+        assert r[f"{hashkey}:c"] == b"4"
+
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("2.0.0")
+    def test_transaction_discard(self, r):
+        hashkey = "{key}"
+
+        # pipelines enabled as transactions can be discarded at any point
+        with r.pipeline(transaction=True) as pipe:
+            pipe.watch(f"{hashkey}:key")
+            pipe.set(f"{hashkey}:key", "someval")
+            pipe.discard()
+
+            assert not pipe._execution_strategy._watching
+            assert not pipe.command_stack

From e9f22ddcba13173f1a2b3010f4e2a339a5b7fa57 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C3=96mer=20Feyzioglu?=
 <95534250+omerfeyzioglu@users.noreply.github.com>
Date: Mon, 12 May 2025 18:55:11 +0300
Subject: [PATCH 1055/1164] Fix  RedisCluster ssl_check_hostname not set to
 connections. For SSL verification with ssl_cert_reqs="none", check_hostname
 is set to False (#3637)

* Fix SSL verification with ssl_cert_reqs=none and ssl_check_hostname=True

* Add ssl_check_hostname to REDIS_ALLOWED_KEYS and fix default value in RedisSSLContext
---
 CHANGES                                     |  1 +
 docs/examples/ssl_connection_examples.ipynb |  5 +-
 redis/asyncio/connection.py                 |  6 ++-
 redis/cluster.py                            |  1 +
 redis/connection.py                         |  4 +-
 tests/test_asyncio/test_cluster.py          |  7 +--
 tests/test_asyncio/test_ssl.py              | 56 +++++++++++++++++++++
 tests/test_ssl.py                           | 27 ++++++++--
 8 files changed, 90 insertions(+), 17 deletions(-)
 create mode 100644 tests/test_asyncio/test_ssl.py

diff --git a/CHANGES b/CHANGES
index 1a1f4eca11..dbc27dbacc 100644
--- a/CHANGES
+++ b/CHANGES
@@ -71,6 +71,7 @@
     * Close Unix sockets if the connection attempt fails. This prevents `ResourceWarning`s. (#3314)
     * Close SSL sockets if the connection attempt fails, or if validations fail. (#3317)
     * Eliminate mutable default arguments in the `redis.commands.core.Script` class. (#3332)
+    * Fix SSL verification with `ssl_cert_reqs="none"` and `ssl_check_hostname=True` by automatically setting `check_hostname=False` when `verify_mode=ssl.CERT_NONE` (#3635) 
     * Allow newer versions of PyJWT as dependency. (#3630)
 
 * 4.1.3 (Feb 8, 2022)
diff --git a/docs/examples/ssl_connection_examples.ipynb b/docs/examples/ssl_connection_examples.ipynb
index a09b87ec1f..3fcc7bc3cc 100644
--- a/docs/examples/ssl_connection_examples.ipynb
+++ b/docs/examples/ssl_connection_examples.ipynb
@@ -37,7 +37,6 @@
     "    host='localhost',\n",
     "    port=6666,\n",
     "    ssl=True,\n",
-    "    ssl_check_hostname=False,\n",
     "    ssl_cert_reqs=\"none\",\n",
     ")\n",
     "r.ping()"
@@ -69,7 +68,7 @@
    "source": [
     "import redis\n",
     "\n",
-    "r = redis.from_url(\"rediss://localhost:6666?ssl_cert_reqs=none&ssl_check_hostname=False&decode_responses=True&health_check_interval=2\")\n",
+    "r = redis.from_url(\"rediss://localhost:6666?ssl_cert_reqs=none&decode_responses=True&health_check_interval=2\")\n",
     "r.ping()"
    ]
   },
@@ -103,7 +102,6 @@
     "    host=\"localhost\",\n",
     "    port=6666,\n",
     "    connection_class=redis.SSLConnection,\n",
-    "    ssl_check_hostname=False,\n",
     "    ssl_cert_reqs=\"none\",\n",
     ")\n",
     "\n",
@@ -143,7 +141,6 @@
     "    port=6666,\n",
     "    ssl=True,\n",
     "    ssl_min_version=ssl.TLSVersion.TLSv1_3,\n",
-    "    ssl_check_hostname=False,\n",
     "    ssl_cert_reqs=\"none\",\n",
     ")\n",
     "r.ping()"
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 77131ab951..d1ae81d269 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -868,7 +868,7 @@ def __init__(
         cert_reqs: Optional[Union[str, ssl.VerifyMode]] = None,
         ca_certs: Optional[str] = None,
         ca_data: Optional[str] = None,
-        check_hostname: bool = False,
+        check_hostname: bool = True,
         min_version: Optional[TLSVersion] = None,
         ciphers: Optional[str] = None,
     ):
@@ -893,7 +893,9 @@ def __init__(
         self.cert_reqs = cert_reqs
         self.ca_certs = ca_certs
         self.ca_data = ca_data
-        self.check_hostname = check_hostname
+        self.check_hostname = (
+            check_hostname if self.cert_reqs != ssl.CERT_NONE else False
+        )
         self.min_version = min_version
         self.ciphers = ciphers
         self.context: Optional[SSLContext] = None
diff --git a/redis/cluster.py b/redis/cluster.py
index b614c598f9..af60e1c76c 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -185,6 +185,7 @@ def parse_cluster_myshardid(resp, **options):
     "ssl_cert_reqs",
     "ssl_keyfile",
     "ssl_password",
+    "ssl_check_hostname",
     "unix_socket_path",
     "username",
     "cache",
diff --git a/redis/connection.py b/redis/connection.py
index dab45906d2..cc805e442f 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1083,7 +1083,9 @@ def __init__(
         self.ca_certs = ssl_ca_certs
         self.ca_data = ssl_ca_data
         self.ca_path = ssl_ca_path
-        self.check_hostname = ssl_check_hostname
+        self.check_hostname = (
+            ssl_check_hostname if self.cert_reqs != ssl.CERT_NONE else False
+        )
         self.certificate_password = ssl_password
         self.ssl_validate_ocsp = ssl_validate_ocsp
         self.ssl_validate_ocsp_stapled = ssl_validate_ocsp_stapled
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index aee9ebc86e..91e8b58a82 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -3118,9 +3118,7 @@ async def test_ssl_with_invalid_cert(
     async def test_ssl_connection(
         self, create_client: Callable[..., Awaitable[RedisCluster]]
     ) -> None:
-        async with await create_client(
-            ssl=True, ssl_check_hostname=False, ssl_cert_reqs="none"
-        ) as rc:
+        async with await create_client(ssl=True, ssl_cert_reqs="none") as rc:
             assert await rc.ping()
 
     @pytest.mark.parametrize(
@@ -3136,7 +3134,6 @@ async def test_ssl_connection_tls12_custom_ciphers(
     ) -> None:
         async with await create_client(
             ssl=True,
-            ssl_check_hostname=False,
             ssl_cert_reqs="none",
             ssl_min_version=ssl.TLSVersion.TLSv1_2,
             ssl_ciphers=ssl_ciphers,
@@ -3148,7 +3145,6 @@ async def test_ssl_connection_tls12_custom_ciphers_invalid(
     ) -> None:
         async with await create_client(
             ssl=True,
-            ssl_check_hostname=False,
             ssl_cert_reqs="none",
             ssl_min_version=ssl.TLSVersion.TLSv1_2,
             ssl_ciphers="foo:bar",
@@ -3170,7 +3166,6 @@ async def test_ssl_connection_tls13_custom_ciphers(
         # TLSv1.3 does not support changing the ciphers
         async with await create_client(
             ssl=True,
-            ssl_check_hostname=False,
             ssl_cert_reqs="none",
             ssl_min_version=ssl.TLSVersion.TLSv1_2,
             ssl_ciphers=ssl_ciphers,
diff --git a/tests/test_asyncio/test_ssl.py b/tests/test_asyncio/test_ssl.py
new file mode 100644
index 0000000000..75800f22de
--- /dev/null
+++ b/tests/test_asyncio/test_ssl.py
@@ -0,0 +1,56 @@
+from urllib.parse import urlparse
+import pytest
+import pytest_asyncio
+import redis.asyncio as redis
+
+# Skip test or not based on cryptography installation
+try:
+    import cryptography  # noqa
+
+    skip_if_cryptography = pytest.mark.skipif(False, reason="")
+    skip_if_nocryptography = pytest.mark.skipif(False, reason="")
+except ImportError:
+    skip_if_cryptography = pytest.mark.skipif(True, reason="cryptography not installed")
+    skip_if_nocryptography = pytest.mark.skipif(
+        True, reason="cryptography not installed"
+    )
+
+
+@pytest.mark.ssl
+class TestSSL:
+    """Tests for SSL connections in asyncio."""
+
+    @pytest_asyncio.fixture()
+    async def _get_client(self, request):
+        ssl_url = request.config.option.redis_ssl_url
+        p = urlparse(ssl_url)[1].split(":")
+        client = redis.Redis(host=p[0], port=p[1], ssl=True)
+        yield client
+        await client.aclose()
+
+    async def test_ssl_with_invalid_cert(self, _get_client):
+        """Test SSL connection with invalid certificate."""
+        pass
+
+    async def test_cert_reqs_none_with_check_hostname(self, request):
+        """Test that when ssl_cert_reqs=none is used with ssl_check_hostname=True,
+        the connection is created successfully with check_hostname internally set to False"""
+        ssl_url = request.config.option.redis_ssl_url
+        parsed_url = urlparse(ssl_url)
+        r = redis.Redis(
+            host=parsed_url.hostname,
+            port=parsed_url.port,
+            ssl=True,
+            ssl_cert_reqs="none",
+            # Check that ssl_check_hostname is ignored, when ssl_cert_reqs=none
+            ssl_check_hostname=True,
+        )
+        try:
+            # Connection should be successful
+            assert await r.ping()
+            # check_hostname should have been automatically set to False
+            assert r.connection_pool.connection_class == redis.SSLConnection
+            conn = r.connection_pool.make_connection()
+            assert conn.check_hostname is False
+        finally:
+            await r.aclose()
diff --git a/tests/test_ssl.py b/tests/test_ssl.py
index 5aa33353a8..cb3f227629 100644
--- a/tests/test_ssl.py
+++ b/tests/test_ssl.py
@@ -42,7 +42,6 @@ def test_ssl_connection(self, request):
             host=p[0],
             port=p[1],
             ssl=True,
-            ssl_check_hostname=False,
             ssl_cert_reqs="none",
         )
         assert r.ping()
@@ -105,7 +104,6 @@ def test_ssl_connection_tls12_custom_ciphers(self, request, ssl_ciphers):
             host=p[0],
             port=p[1],
             ssl=True,
-            ssl_check_hostname=False,
             ssl_cert_reqs="none",
             ssl_min_version=ssl.TLSVersion.TLSv1_3,
             ssl_ciphers=ssl_ciphers,
@@ -120,7 +118,6 @@ def test_ssl_connection_tls12_custom_ciphers_invalid(self, request):
             host=p[0],
             port=p[1],
             ssl=True,
-            ssl_check_hostname=False,
             ssl_cert_reqs="none",
             ssl_min_version=ssl.TLSVersion.TLSv1_2,
             ssl_ciphers="foo:bar",
@@ -145,7 +142,6 @@ def test_ssl_connection_tls13_custom_ciphers(self, request, ssl_ciphers):
             host=p[0],
             port=p[1],
             ssl=True,
-            ssl_check_hostname=False,
             ssl_cert_reqs="none",
             ssl_min_version=ssl.TLSVersion.TLSv1_2,
             ssl_ciphers=ssl_ciphers,
@@ -309,3 +305,26 @@ def test_mock_ocsp_staple(self, request):
             r.ping()
         assert "no ocsp response present" in str(e)
         r.close()
+
+    def test_cert_reqs_none_with_check_hostname(self, request):
+        """Test that when ssl_cert_reqs=none is used with ssl_check_hostname=True,
+        the connection is created successfully with check_hostname internally set to False"""
+        ssl_url = request.config.option.redis_ssl_url
+        parsed_url = urlparse(ssl_url)
+        r = redis.Redis(
+            host=parsed_url.hostname,
+            port=parsed_url.port,
+            ssl=True,
+            ssl_cert_reqs="none",
+            # Check that ssl_check_hostname is ignored, when ssl_cert_reqs=none
+            ssl_check_hostname=True,
+        )
+        try:
+            # Connection should be successful
+            assert r.ping()
+            # check_hostname should have been automatically set to False
+            assert r.connection_pool.connection_class == redis.SSLConnection
+            conn = r.connection_pool.make_connection()
+            assert conn.check_hostname is False
+        finally:
+            r.close()

From 0d28291d24d56fc6f95aa0a36f4f3d93a6835e04 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 13 May 2025 12:16:13 +0300
Subject: [PATCH 1056/1164] Updating the readme and lib version to contain the
 changes from the latest stable release (#3644)

---
 README.md          | 52 ++++++++++++++++++++++++++++++++++++++++------
 docker-compose.yml |  5 +++--
 redis/__init__.py  |  2 +-
 3 files changed, 50 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index 8b4d4b6875..177f78feeb 100644
--- a/README.md
+++ b/README.md
@@ -31,12 +31,17 @@ The Python interface to the Redis key-value store.
 
 ## Installation
 
-Start a redis via docker:
+Start a redis via docker (for Redis versions >= 8.0):
 
 ``` bash
-docker run -p 6379:6379 -it redis/redis-stack:latest
+docker run -p 6379:6379 -it redis:latest
 ```
 
+Start a redis via docker (for Redis versions < 8.0):
+
+``` bash
+docker run -p 6379:6379 -it redis/redis-stack:latest
+
 To install redis-py, simply:
 
 ``` bash
@@ -54,7 +59,7 @@ Looking for a high-level library to handle object mapping? See [redis-om-python]
 
 ## Supported Redis Versions
 
-The most recent version of this library supports redis version [5.0](https://github.com/redis/redis/blob/5.0/00-RELEASENOTES), [6.0](https://github.com/redis/redis/blob/6.0/00-RELEASENOTES), [6.2](https://github.com/redis/redis/blob/6.2/00-RELEASENOTES), [7.0](https://github.com/redis/redis/blob/7.0/00-RELEASENOTES), [7.2](https://github.com/redis/redis/blob/7.2/00-RELEASENOTES) and [7.4](https://github.com/redis/redis/blob/7.4/00-RELEASENOTES).
+The most recent version of this library supports Redis version [7.2](https://github.com/redis/redis/blob/7.2/00-RELEASENOTES), [7.4](https://github.com/redis/redis/blob/7.4/00-RELEASENOTES) and [8.0](https://github.com/redis/redis/blob/8.0/00-RELEASENOTES).
 
 The table below highlights version compatibility of the most-recent library versions and redis versions.
 
@@ -62,7 +67,8 @@ The table below highlights version compatibility of the most-recent library vers
 |-----------------|-------------------|
 | 3.5.3 | <= 6.2 Family of releases |
 | >= 4.5.0 | Version 5.0 to 7.0 |
-| >= 5.0.0 | Version 5.0 to current |
+| >= 5.0.0 | Version 5.0 to 7.4 |
+| >= 6.0.0 | Version 7.2 to current |
 
 
 ## Usage
@@ -152,8 +158,42 @@ The following example shows how to utilize [Redis Pub/Sub](https://redis.io/docs
 {'pattern': None, 'type': 'subscribe', 'channel': b'my-second-channel', 'data': 1}
 ```
 
+### Redis’ search and query capabilities default dialect
+
+Release 6.0.0 introduces a client-side default dialect for Redis’ search and query capabilities.
+By default, the client now overrides the server-side dialect with version 2, automatically appending *DIALECT 2* to commands like *FT.AGGREGATE* and *FT.SEARCH*.
 
---------------------------
+**Important**: Be aware that the query dialect may impact the results returned. If needed, you can revert to a different dialect version by configuring the client accordingly.
+
+``` python
+>>> from redis.commands.search.field import TextField
+>>> from redis.commands.search.query import Query
+>>> from redis.commands.search.index_definition import IndexDefinition
+>>> import redis
+
+>>> r = redis.Redis(host='localhost', port=6379, db=0)
+>>> r.ft().create_index(
+>>>     (TextField("name"), TextField("lastname")),
+>>>     definition=IndexDefinition(prefix=["test:"]),
+>>> )
+
+>>> r.hset("test:1", "name", "James")
+>>> r.hset("test:1", "lastname", "Brown")
+
+>>> # Query with default DIALECT 2
+>>> query = "@name: James Brown"
+>>> q = Query(query)
+>>> res = r.ft().search(q)
+
+>>> # Query with explicit DIALECT 1
+>>> query = "@name: James Brown"
+>>> q = Query(query).dialect(1)
+>>> res = r.ft().search(q)
+```
+
+You can find further details in the [query dialect documentation](https://redis.io/docs/latest/develop/interact/search-and-query/advanced-concepts/dialects/).
+
+---------------------------------------------
 
 ### Author
 
@@ -169,4 +209,4 @@ Special thanks to:
     system.
 -   Paul Hubbard for initial packaging support.
 
-[![Redis](./docs/_static/logo-redis.svg)](https://redis.io)
+[![Redis](./docs/_static/logo-redis.svg)](https://redis.io)
\ No newline at end of file
diff --git a/docker-compose.yml b/docker-compose.yml
index 76a60398f3..bcf85df1a7 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,9 +1,10 @@
 ---
+# image tag 8.0-RC2-pre is the one matching the 8.0 GA release
 x-client-libs-stack-image: &client-libs-stack-image
-  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_STACK_IMAGE_TAG:-rs-7.4.0-v2}"
+  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_STACK_IMAGE_TAG:-8.0-RC2-pre}"
 
 x-client-libs-image: &client-libs-image
-  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_IMAGE_TAG:-7.4.2}"
+  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_IMAGE_TAG:-8.0-RC2-pre}"
 
 services:
 
diff --git a/redis/__init__.py b/redis/__init__.py
index 14030205e3..cd3ee12adb 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -45,7 +45,7 @@ def int_or_str(value):
         return value
 
 
-__version__ = "5.2.1"
+__version__ = "6.1.0"
 VERSION = tuple(map(int_or_str, __version__.split(".")))
 
 

From 36619a507addc313c0245bf318e4678938fc5d44 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Wed, 14 May 2025 16:28:25 +0300
Subject: [PATCH 1057/1164] Add dynamic_startup_nodes parameter to async
 RedisCluster (#3646)

---
 redis/asyncio/cluster.py           | 20 ++++++++++++++++++--
 tests/test_asyncio/test_cluster.py | 21 +++++++++++++++++++++
 2 files changed, 39 insertions(+), 2 deletions(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 6044edc23a..aebfef230b 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -134,6 +134,14 @@ class RedisCluster(AbstractRedis, AbstractRedisCluster, AsyncRedisClusterCommand
         | Enable read from replicas in READONLY mode and defines the load balancing
           strategy that will be used for cluster node selection.
           The data read from replicas is eventually consistent with the data in primary nodes.
+    :param dynamic_startup_nodes:
+        | Set the RedisCluster's startup nodes to all the discovered nodes.
+          If true (default value), the cluster's discovered nodes will be used to
+          determine the cluster nodes-slots mapping in the next topology refresh.
+          It will remove the initial passed startup nodes if their endpoints aren't
+          listed in the CLUSTER SLOTS output.
+          If you use dynamic DNS endpoints for startup nodes but CLUSTER SLOTS lists
+          specific IP addresses, it is best to set it to false.
     :param reinitialize_steps:
         | Specifies the number of MOVED errors that need to occur before reinitializing
           the whole cluster topology. If a MOVED error occurs and the cluster does not
@@ -250,6 +258,7 @@ def __init__(
         require_full_coverage: bool = True,
         read_from_replicas: bool = False,
         load_balancing_strategy: Optional[LoadBalancingStrategy] = None,
+        dynamic_startup_nodes: bool = True,
         reinitialize_steps: int = 5,
         cluster_error_retry_attempts: int = 3,
         max_connections: int = 2**31,
@@ -388,6 +397,7 @@ def __init__(
             startup_nodes,
             require_full_coverage,
             kwargs,
+            dynamic_startup_nodes=dynamic_startup_nodes,
             address_remap=address_remap,
             event_dispatcher=self._event_dispatcher,
         )
@@ -1162,6 +1172,7 @@ async def _mock(self, error: RedisError):
 
 class NodesManager:
     __slots__ = (
+        "_dynamic_startup_nodes",
         "_moved_exception",
         "_event_dispatcher",
         "connection_kwargs",
@@ -1179,6 +1190,7 @@ def __init__(
         startup_nodes: List["ClusterNode"],
         require_full_coverage: bool,
         connection_kwargs: Dict[str, Any],
+        dynamic_startup_nodes: bool = True,
         address_remap: Optional[Callable[[Tuple[str, int]], Tuple[str, int]]] = None,
         event_dispatcher: Optional[EventDispatcher] = None,
     ) -> None:
@@ -1191,6 +1203,8 @@ def __init__(
         self.nodes_cache: Dict[str, "ClusterNode"] = {}
         self.slots_cache: Dict[int, List["ClusterNode"]] = {}
         self.read_load_balancer = LoadBalancer()
+
+        self._dynamic_startup_nodes: bool = dynamic_startup_nodes
         self._moved_exception: MovedError = None
         if event_dispatcher is None:
             self._event_dispatcher = EventDispatcher()
@@ -1433,8 +1447,10 @@ async def initialize(self) -> None:
         # Set the tmp variables to the real variables
         self.slots_cache = tmp_slots
         self.set_nodes(self.nodes_cache, tmp_nodes_cache, remove_old=True)
-        # Populate the startup nodes with all discovered nodes
-        self.set_nodes(self.startup_nodes, self.nodes_cache, remove_old=True)
+
+        if self._dynamic_startup_nodes:
+            # Populate the startup nodes with all discovered nodes
+            self.set_nodes(self.startup_nodes, self.nodes_cache, remove_old=True)
 
         # Set the default node
         self.default_node = self.get_nodes_by_server_type(PRIMARY)[0]
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 91e8b58a82..1b3fbd5526 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -2723,6 +2723,27 @@ def cmd_init_mock(self, r: ClusterNode) -> None:
                     assert rc.get_node(host=default_host, port=7001) is not None
                     assert rc.get_node(host=default_host, port=7002) is not None
 
+    @pytest.mark.parametrize("dynamic_startup_nodes", [True, False])
+    async def test_init_slots_dynamic_startup_nodes(self, dynamic_startup_nodes):
+        rc = await get_mocked_redis_client(
+            host="my@DNS.com",
+            port=7000,
+            cluster_slots=default_cluster_slots,
+            dynamic_startup_nodes=dynamic_startup_nodes,
+        )
+        # Nodes are taken from default_cluster_slots
+        discovered_nodes = [
+            "127.0.0.1:7000",
+            "127.0.0.1:7001",
+            "127.0.0.1:7002",
+            "127.0.0.1:7003",
+        ]
+        startup_nodes = list(rc.nodes_manager.startup_nodes.keys())
+        if dynamic_startup_nodes is True:
+            assert sorted(startup_nodes) == sorted(discovered_nodes)
+        else:
+            assert startup_nodes == ["my@DNS.com:7000"]
+
 
 class TestClusterPipeline:
     """Tests for the ClusterPipeline class."""

From c0a049260e9cf64989e5376e4f474e0cb51cc52d Mon Sep 17 00:00:00 2001
From: Igor Malinovskiy <u.glide@gmail.com>
Date: Fri, 23 May 2025 13:52:33 +0300
Subject: [PATCH 1058/1164] Support RESP3 with hiredis-py parser (#3648)

* Add minimalistic implementation for Push notifications parsing with hiredis-py

* Fixing linters(almost all errors). Fixing hiredis parser for invalidation messages when using connection pool.

* Fixing last linter errors. Fixes needed for pubsub message handling with hiredis.

* Fix handle_pubsub_push_response

* Update redis/utils.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Fix formatting

* Some good sleep solves a lot of problems. Isn't it?

* Enable verbose output from pytest to check why tests are skipped

* Revert

* Bump hiredis version to 3.2.0

* Bump hiredis-py version in CI

---------

Co-authored-by: Petya Slavova <petya.slavova@redis.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 .github/workflows/integration.yaml |  2 +-
 pyproject.toml                     |  2 +-
 redis/_parsers/__init__.py         |  9 +++-
 redis/_parsers/base.py             | 54 ++++++++++++++++++++-
 redis/_parsers/hiredis.py          | 77 ++++++++++++++++++++++++++++--
 redis/_parsers/resp3.py            | 45 ++++-------------
 redis/asyncio/client.py            |  3 +-
 redis/asyncio/connection.py        |  8 +---
 redis/client.py                    |  3 +-
 redis/cluster.py                   |  3 +-
 redis/connection.py                |  2 +-
 redis/utils.py                     |  7 ++-
 tests/test_asyncio/test_pubsub.py  |  2 -
 tests/test_asyncio/test_search.py  |  5 ++
 tests/test_cache.py                |  9 ++--
 tests/test_connection_pool.py      |  3 +-
 tests/test_pubsub.py               |  3 --
 tests/test_search.py               |  9 +++-
 18 files changed, 174 insertions(+), 72 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index dcc21b5a9c..7d0402e9d5 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -125,7 +125,7 @@ jobs:
         redis-version: [ '${{ needs.redis_version.outputs.CURRENT }}' ]
         python-version: [ '3.8', '3.13']
         parser-backend: [ 'hiredis' ]
-        hiredis-version: [ '>=3.0.0', '<3.0.0' ]
+        hiredis-version: [ '>=3.2.0', '<3.0.0' ]
         event-loop: [ 'asyncio' ]
     env:
       ACTIONS_ALLOW_UNSECURE_COMMANDS: true
diff --git a/pyproject.toml b/pyproject.toml
index 5cd40c0212..ac692ef9d1 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -33,7 +33,7 @@ dependencies = ['async-timeout>=4.0.3; python_full_version<"3.11.3"']
 
 [project.optional-dependencies]
 hiredis = [
-    "hiredis>=3.0.0",
+    "hiredis>=3.2.0",
 ]
 ocsp = [
     "cryptography>=36.0.1",
diff --git a/redis/_parsers/__init__.py b/redis/_parsers/__init__.py
index 6cc32e3cae..30cb1cd5b9 100644
--- a/redis/_parsers/__init__.py
+++ b/redis/_parsers/__init__.py
@@ -1,4 +1,9 @@
-from .base import BaseParser, _AsyncRESPBase
+from .base import (
+    AsyncPushNotificationsParser,
+    BaseParser,
+    PushNotificationsParser,
+    _AsyncRESPBase,
+)
 from .commands import AsyncCommandsParser, CommandsParser
 from .encoders import Encoder
 from .hiredis import _AsyncHiredisParser, _HiredisParser
@@ -11,10 +16,12 @@
     "_AsyncRESPBase",
     "_AsyncRESP2Parser",
     "_AsyncRESP3Parser",
+    "AsyncPushNotificationsParser",
     "CommandsParser",
     "Encoder",
     "BaseParser",
     "_HiredisParser",
     "_RESP2Parser",
     "_RESP3Parser",
+    "PushNotificationsParser",
 ]
diff --git a/redis/_parsers/base.py b/redis/_parsers/base.py
index ebc8313ce7..69d7b585dd 100644
--- a/redis/_parsers/base.py
+++ b/redis/_parsers/base.py
@@ -1,7 +1,7 @@
 import sys
 from abc import ABC
 from asyncio import IncompleteReadError, StreamReader, TimeoutError
-from typing import List, Optional, Union
+from typing import Callable, List, Optional, Protocol, Union
 
 if sys.version_info.major >= 3 and sys.version_info.minor >= 11:
     from asyncio import timeout as async_timeout
@@ -158,6 +158,58 @@ async def read_response(
         raise NotImplementedError()
 
 
+_INVALIDATION_MESSAGE = [b"invalidate", "invalidate"]
+
+
+class PushNotificationsParser(Protocol):
+    """Protocol defining RESP3-specific parsing functionality"""
+
+    pubsub_push_handler_func: Callable
+    invalidation_push_handler_func: Optional[Callable] = None
+
+    def handle_pubsub_push_response(self, response):
+        """Handle pubsub push responses"""
+        raise NotImplementedError()
+
+    def handle_push_response(self, response, **kwargs):
+        if response[0] not in _INVALIDATION_MESSAGE:
+            return self.pubsub_push_handler_func(response)
+        if self.invalidation_push_handler_func:
+            return self.invalidation_push_handler_func(response)
+
+    def set_pubsub_push_handler(self, pubsub_push_handler_func):
+        self.pubsub_push_handler_func = pubsub_push_handler_func
+
+    def set_invalidation_push_handler(self, invalidation_push_handler_func):
+        self.invalidation_push_handler_func = invalidation_push_handler_func
+
+
+class AsyncPushNotificationsParser(Protocol):
+    """Protocol defining async RESP3-specific parsing functionality"""
+
+    pubsub_push_handler_func: Callable
+    invalidation_push_handler_func: Optional[Callable] = None
+
+    async def handle_pubsub_push_response(self, response):
+        """Handle pubsub push responses asynchronously"""
+        raise NotImplementedError()
+
+    async def handle_push_response(self, response, **kwargs):
+        """Handle push responses asynchronously"""
+        if response[0] not in _INVALIDATION_MESSAGE:
+            return await self.pubsub_push_handler_func(response)
+        if self.invalidation_push_handler_func:
+            return await self.invalidation_push_handler_func(response)
+
+    def set_pubsub_push_handler(self, pubsub_push_handler_func):
+        """Set the pubsub push handler function"""
+        self.pubsub_push_handler_func = pubsub_push_handler_func
+
+    def set_invalidation_push_handler(self, invalidation_push_handler_func):
+        """Set the invalidation push handler function"""
+        self.invalidation_push_handler_func = invalidation_push_handler_func
+
+
 class _AsyncRESPBase(AsyncBaseParser):
     """Base class for async resp parsing"""
 
diff --git a/redis/_parsers/hiredis.py b/redis/_parsers/hiredis.py
index c807bd903a..521a58b26c 100644
--- a/redis/_parsers/hiredis.py
+++ b/redis/_parsers/hiredis.py
@@ -1,6 +1,7 @@
 import asyncio
 import socket
 import sys
+from logging import getLogger
 from typing import Callable, List, Optional, TypedDict, Union
 
 if sys.version_info.major >= 3 and sys.version_info.minor >= 11:
@@ -11,7 +12,12 @@
 from ..exceptions import ConnectionError, InvalidResponse, RedisError
 from ..typing import EncodableT
 from ..utils import HIREDIS_AVAILABLE
-from .base import AsyncBaseParser, BaseParser
+from .base import (
+    AsyncBaseParser,
+    AsyncPushNotificationsParser,
+    BaseParser,
+    PushNotificationsParser,
+)
 from .socket import (
     NONBLOCKING_EXCEPTION_ERROR_NUMBERS,
     NONBLOCKING_EXCEPTIONS,
@@ -32,7 +38,7 @@ class _HiredisReaderArgs(TypedDict, total=False):
     errors: Optional[str]
 
 
-class _HiredisParser(BaseParser):
+class _HiredisParser(BaseParser, PushNotificationsParser):
     "Parser class for connections using Hiredis"
 
     def __init__(self, socket_read_size):
@@ -40,6 +46,9 @@ def __init__(self, socket_read_size):
             raise RedisError("Hiredis is not installed")
         self.socket_read_size = socket_read_size
         self._buffer = bytearray(socket_read_size)
+        self.pubsub_push_handler_func = self.handle_pubsub_push_response
+        self.invalidation_push_handler_func = None
+        self._hiredis_PushNotificationType = None
 
     def __del__(self):
         try:
@@ -47,6 +56,11 @@ def __del__(self):
         except Exception:
             pass
 
+    def handle_pubsub_push_response(self, response):
+        logger = getLogger("push_response")
+        logger.debug("Push response: " + str(response))
+        return response
+
     def on_connect(self, connection, **kwargs):
         import hiredis
 
@@ -64,6 +78,12 @@ def on_connect(self, connection, **kwargs):
         self._reader = hiredis.Reader(**kwargs)
         self._next_response = NOT_ENOUGH_DATA
 
+        try:
+            self._hiredis_PushNotificationType = hiredis.PushNotification
+        except AttributeError:
+            # hiredis < 3.2
+            self._hiredis_PushNotificationType = None
+
     def on_disconnect(self):
         self._sock = None
         self._reader = None
@@ -109,7 +129,7 @@ def read_from_socket(self, timeout=SENTINEL, raise_on_timeout=True):
             if custom_timeout:
                 sock.settimeout(self._socket_timeout)
 
-    def read_response(self, disable_decoding=False):
+    def read_response(self, disable_decoding=False, push_request=False):
         if not self._reader:
             raise ConnectionError(SERVER_CLOSED_CONNECTION_ERROR)
 
@@ -117,6 +137,16 @@ def read_response(self, disable_decoding=False):
         if self._next_response is not NOT_ENOUGH_DATA:
             response = self._next_response
             self._next_response = NOT_ENOUGH_DATA
+            if self._hiredis_PushNotificationType is not None and isinstance(
+                response, self._hiredis_PushNotificationType
+            ):
+                response = self.handle_push_response(response)
+                if not push_request:
+                    return self.read_response(
+                        disable_decoding=disable_decoding, push_request=push_request
+                    )
+                else:
+                    return response
             return response
 
         if disable_decoding:
@@ -135,6 +165,16 @@ def read_response(self, disable_decoding=False):
         # happened
         if isinstance(response, ConnectionError):
             raise response
+        elif self._hiredis_PushNotificationType is not None and isinstance(
+            response, self._hiredis_PushNotificationType
+        ):
+            response = self.handle_push_response(response)
+            if not push_request:
+                return self.read_response(
+                    disable_decoding=disable_decoding, push_request=push_request
+                )
+            else:
+                return response
         elif (
             isinstance(response, list)
             and response
@@ -144,7 +184,7 @@ def read_response(self, disable_decoding=False):
         return response
 
 
-class _AsyncHiredisParser(AsyncBaseParser):
+class _AsyncHiredisParser(AsyncBaseParser, AsyncPushNotificationsParser):
     """Async implementation of parser class for connections using Hiredis"""
 
     __slots__ = ("_reader",)
@@ -154,6 +194,14 @@ def __init__(self, socket_read_size: int):
             raise RedisError("Hiredis is not available.")
         super().__init__(socket_read_size=socket_read_size)
         self._reader = None
+        self.pubsub_push_handler_func = self.handle_pubsub_push_response
+        self.invalidation_push_handler_func = None
+        self._hiredis_PushNotificationType = None
+
+    async def handle_pubsub_push_response(self, response):
+        logger = getLogger("push_response")
+        logger.debug("Push response: " + str(response))
+        return response
 
     def on_connect(self, connection):
         import hiredis
@@ -171,6 +219,14 @@ def on_connect(self, connection):
         self._reader = hiredis.Reader(**kwargs)
         self._connected = True
 
+        try:
+            self._hiredis_PushNotificationType = getattr(
+                hiredis, "PushNotification", None
+            )
+        except AttributeError:
+            # hiredis < 3.2
+            self._hiredis_PushNotificationType = None
+
     def on_disconnect(self):
         self._connected = False
 
@@ -195,7 +251,7 @@ async def read_from_socket(self):
         return True
 
     async def read_response(
-        self, disable_decoding: bool = False
+        self, disable_decoding: bool = False, push_request: bool = False
     ) -> Union[EncodableT, List[EncodableT]]:
         # If `on_disconnect()` has been called, prohibit any more reads
         # even if they could happen because data might be present.
@@ -207,6 +263,7 @@ async def read_response(
             response = self._reader.gets(False)
         else:
             response = self._reader.gets()
+
         while response is NOT_ENOUGH_DATA:
             await self.read_from_socket()
             if disable_decoding:
@@ -219,6 +276,16 @@ async def read_response(
         # happened
         if isinstance(response, ConnectionError):
             raise response
+        elif self._hiredis_PushNotificationType is not None and isinstance(
+            response, self._hiredis_PushNotificationType
+        ):
+            response = await self.handle_push_response(response)
+            if not push_request:
+                return await self.read_response(
+                    disable_decoding=disable_decoding, push_request=push_request
+                )
+            else:
+                return response
         elif (
             isinstance(response, list)
             and response
diff --git a/redis/_parsers/resp3.py b/redis/_parsers/resp3.py
index ce4c59fb5b..42c6652e31 100644
--- a/redis/_parsers/resp3.py
+++ b/redis/_parsers/resp3.py
@@ -3,13 +3,16 @@
 
 from ..exceptions import ConnectionError, InvalidResponse, ResponseError
 from ..typing import EncodableT
-from .base import _AsyncRESPBase, _RESPBase
+from .base import (
+    AsyncPushNotificationsParser,
+    PushNotificationsParser,
+    _AsyncRESPBase,
+    _RESPBase,
+)
 from .socket import SERVER_CLOSED_CONNECTION_ERROR
 
-_INVALIDATION_MESSAGE = [b"invalidate", "invalidate"]
 
-
-class _RESP3Parser(_RESPBase):
+class _RESP3Parser(_RESPBase, PushNotificationsParser):
     """RESP3 protocol implementation"""
 
     def __init__(self, socket_read_size):
@@ -113,9 +116,7 @@ def _read_response(self, disable_decoding=False, push_request=False):
                 )
                 for _ in range(int(response))
             ]
-            response = self.handle_push_response(
-                response, disable_decoding, push_request
-            )
+            response = self.handle_push_response(response)
             if not push_request:
                 return self._read_response(
                     disable_decoding=disable_decoding, push_request=push_request
@@ -129,20 +130,8 @@ def _read_response(self, disable_decoding=False, push_request=False):
             response = self.encoder.decode(response)
         return response
 
-    def handle_push_response(self, response, disable_decoding, push_request):
-        if response[0] not in _INVALIDATION_MESSAGE:
-            return self.pubsub_push_handler_func(response)
-        if self.invalidation_push_handler_func:
-            return self.invalidation_push_handler_func(response)
-
-    def set_pubsub_push_handler(self, pubsub_push_handler_func):
-        self.pubsub_push_handler_func = pubsub_push_handler_func
-
-    def set_invalidation_push_handler(self, invalidation_push_handler_func):
-        self.invalidation_push_handler_func = invalidation_push_handler_func
-
 
-class _AsyncRESP3Parser(_AsyncRESPBase):
+class _AsyncRESP3Parser(_AsyncRESPBase, AsyncPushNotificationsParser):
     def __init__(self, socket_read_size):
         super().__init__(socket_read_size)
         self.pubsub_push_handler_func = self.handle_pubsub_push_response
@@ -253,9 +242,7 @@ async def _read_response(
                 )
                 for _ in range(int(response))
             ]
-            response = await self.handle_push_response(
-                response, disable_decoding, push_request
-            )
+            response = await self.handle_push_response(response)
             if not push_request:
                 return await self._read_response(
                     disable_decoding=disable_decoding, push_request=push_request
@@ -268,15 +255,3 @@ async def _read_response(
         if isinstance(response, bytes) and disable_decoding is False:
             response = self.encoder.decode(response)
         return response
-
-    async def handle_push_response(self, response, disable_decoding, push_request):
-        if response[0] not in _INVALIDATION_MESSAGE:
-            return await self.pubsub_push_handler_func(response)
-        if self.invalidation_push_handler_func:
-            return await self.invalidation_push_handler_func(response)
-
-    def set_pubsub_push_handler(self, pubsub_push_handler_func):
-        self.pubsub_push_handler_func = pubsub_push_handler_func
-
-    def set_invalidation_push_handler(self, invalidation_push_handler_func):
-        self.invalidation_push_handler_func = invalidation_push_handler_func
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 1cb28e725e..aac409073f 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -70,7 +70,6 @@
 )
 from redis.typing import ChannelT, EncodableT, KeyT
 from redis.utils import (
-    HIREDIS_AVAILABLE,
     SSL_AVAILABLE,
     _set_info_logger,
     deprecated_args,
@@ -938,7 +937,7 @@ async def connect(self):
             self.connection.register_connect_callback(self.on_connect)
         else:
             await self.connection.connect()
-        if self.push_handler_func is not None and not HIREDIS_AVAILABLE:
+        if self.push_handler_func is not None:
             self.connection._parser.set_pubsub_push_handler(self.push_handler_func)
 
         self._event_dispatcher.dispatch(
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index d1ae81d269..d6c03f17c5 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -576,11 +576,7 @@ async def read_response(
         read_timeout = timeout if timeout is not None else self.socket_timeout
         host_error = self._host_error()
         try:
-            if (
-                read_timeout is not None
-                and self.protocol in ["3", 3]
-                and not HIREDIS_AVAILABLE
-            ):
+            if read_timeout is not None and self.protocol in ["3", 3]:
                 async with async_timeout(read_timeout):
                     response = await self._parser.read_response(
                         disable_decoding=disable_decoding, push_request=push_request
@@ -590,7 +586,7 @@ async def read_response(
                     response = await self._parser.read_response(
                         disable_decoding=disable_decoding
                     )
-            elif self.protocol in ["3", 3] and not HIREDIS_AVAILABLE:
+            elif self.protocol in ["3", 3]:
                 response = await self._parser.read_response(
                     disable_decoding=disable_decoding, push_request=push_request
                 )
diff --git a/redis/client.py b/redis/client.py
index dc4f0f9d0c..c662e591e0 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -58,7 +58,6 @@
 from redis.lock import Lock
 from redis.retry import Retry
 from redis.utils import (
-    HIREDIS_AVAILABLE,
     _set_info_logger,
     deprecated_args,
     get_lib_version,
@@ -861,7 +860,7 @@ def execute_command(self, *args):
             # register a callback that re-subscribes to any channels we
             # were listening to when we were disconnected
             self.connection.register_connect_callback(self.on_connect)
-            if self.push_handler_func is not None and not HIREDIS_AVAILABLE:
+            if self.push_handler_func is not None:
                 self.connection._parser.set_pubsub_push_handler(self.push_handler_func)
             self._event_dispatcher.dispatch(
                 AfterPubSubConnectionInstantiationEvent(
diff --git a/redis/cluster.py b/redis/cluster.py
index af60e1c76c..bbc4204bdf 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -51,7 +51,6 @@
 from redis.lock import Lock
 from redis.retry import Retry
 from redis.utils import (
-    HIREDIS_AVAILABLE,
     deprecated_args,
     dict_merge,
     list_keys_to_dict,
@@ -1999,7 +1998,7 @@ def execute_command(self, *args):
             # register a callback that re-subscribes to any channels we
             # were listening to when we were disconnected
             self.connection.register_connect_callback(self.on_connect)
-            if self.push_handler_func is not None and not HIREDIS_AVAILABLE:
+            if self.push_handler_func is not None:
                 self.connection._parser.set_pubsub_push_handler(self.push_handler_func)
             self._event_dispatcher.dispatch(
                 AfterPubSubConnectionInstantiationEvent(
diff --git a/redis/connection.py b/redis/connection.py
index cc805e442f..0884bca362 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -636,7 +636,7 @@ def read_response(
         host_error = self._host_error()
 
         try:
-            if self.protocol in ["3", 3] and not HIREDIS_AVAILABLE:
+            if self.protocol in ["3", 3]:
                 response = self._parser.read_response(
                     disable_decoding=disable_decoding, push_request=push_request
                 )
diff --git a/redis/utils.py b/redis/utils.py
index 1f0b24d768..715913e914 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -12,9 +12,12 @@
     import hiredis  # noqa
 
     # Only support Hiredis >= 3.0:
-    HIREDIS_AVAILABLE = int(hiredis.__version__.split(".")[0]) >= 3
+    hiredis_version = hiredis.__version__.split(".")
+    HIREDIS_AVAILABLE = int(hiredis_version[0]) > 3 or (
+        int(hiredis_version[0]) == 3 and int(hiredis_version[1]) >= 2
+    )
     if not HIREDIS_AVAILABLE:
-        raise ImportError("hiredis package should be >= 3.0.0")
+        raise ImportError("hiredis package should be >= 3.2.0")
 except ImportError:
     HIREDIS_AVAILABLE = False
 
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index 13a6158b40..5ea89a0b8b 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -17,7 +17,6 @@
 import redis.asyncio as redis
 from redis.exceptions import ConnectionError
 from redis.typing import EncodableT
-from redis.utils import HIREDIS_AVAILABLE
 from tests.conftest import get_protocol_version, skip_if_server_version_lt
 
 from .compat import aclosing, create_task, mock
@@ -464,7 +463,6 @@ class TestPubSubRESP3Handler:
     async def my_handler(self, message):
         self.message = ["my handler", message]
 
-    @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
     async def test_push_handler(self, r):
         if get_protocol_version(r) in [2, "2", None]:
             return
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 2ee74f710f..932ece59b8 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -7,6 +7,7 @@
 import numpy as np
 import pytest
 import pytest_asyncio
+from redis import ResponseError
 import redis.asyncio as redis
 import redis.commands.search.aggregation as aggregations
 import redis.commands.search.reducers as reducers
@@ -60,6 +61,10 @@ async def waitForIndex(env, idx, timeout=None):
                     break
             except ValueError:
                 break
+        except ResponseError:
+            # index doesn't exist yet
+            # continue to sleep and try again
+            pass
 
         await asyncio.sleep(delay)
         if timeout is not None:
diff --git a/tests/test_cache.py b/tests/test_cache.py
index a305d2de7b..1f3193c49d 100644
--- a/tests/test_cache.py
+++ b/tests/test_cache.py
@@ -13,7 +13,6 @@
     EvictionPolicyType,
     LRUPolicy,
 )
-from redis.utils import HIREDIS_AVAILABLE
 from tests.conftest import _get_client, skip_if_resp_version, skip_if_server_version_lt
 
 
@@ -40,7 +39,6 @@ def r(request):
         yield client
 
 
-@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 @pytest.mark.onlynoncluster
 @skip_if_resp_version(2)
 @skip_if_server_version_lt("7.4.0")
@@ -124,6 +122,10 @@ def test_get_from_default_cache(self, r, r2):
         ]
         # change key in redis (cause invalidation)
         r2.set("foo", "barbar")
+
+        # Add a small delay to allow invalidation to be processed
+        time.sleep(0.1)
+
         # Retrieves a new value from server and cache it
         assert r.get("foo") in [b"barbar", "barbar"]
         # Make sure that new value was cached
@@ -325,7 +327,6 @@ def test_cache_flushed_on_server_flush(self, r):
         assert cache.size == 0
 
 
-@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 @pytest.mark.onlycluster
 @skip_if_resp_version(2)
 @skip_if_server_version_lt("7.4.0")
@@ -568,7 +569,6 @@ def test_cache_flushed_on_server_flush(self, r, cache):
         assert cache.size == 0
 
 
-@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 @pytest.mark.onlynoncluster
 @skip_if_resp_version(2)
 @skip_if_server_version_lt("7.4.0")
@@ -674,7 +674,6 @@ def test_cache_clears_on_disconnect(self, master, cache):
         assert cache.size == 0
 
 
-@pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
 @pytest.mark.onlynoncluster
 @skip_if_resp_version(2)
 @skip_if_server_version_lt("7.4.0")
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index d97c9063ac..9e67659fa9 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -9,7 +9,7 @@
 import redis
 from redis.cache import CacheConfig
 from redis.connection import CacheProxyConnection, Connection, to_bool
-from redis.utils import HIREDIS_AVAILABLE, SSL_AVAILABLE
+from redis.utils import SSL_AVAILABLE
 
 from .conftest import (
     _get_client,
@@ -217,7 +217,6 @@ def test_repr_contains_db_info_unix(self):
         expected = "path=abc,db=0,client_name=test-client"
         assert expected in repr(pool)
 
-    @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
     @pytest.mark.onlynoncluster
     @skip_if_resp_version(2)
     @skip_if_server_version_lt("7.4.0")
diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index 9ead455af3..ac6965a188 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -10,7 +10,6 @@
 import pytest
 import redis
 from redis.exceptions import ConnectionError
-from redis.utils import HIREDIS_AVAILABLE
 
 from .conftest import (
     _get_client,
@@ -593,7 +592,6 @@ class TestPubSubRESP3Handler:
     def my_handler(self, message):
         self.message = ["my handler", message]
 
-    @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
     def test_push_handler(self, r):
         if is_resp2_connection(r):
             return
@@ -605,7 +603,6 @@ def test_push_handler(self, r):
         assert wait_for_message(p) is None
         assert self.message == ["my handler", [b"message", b"foo", b"test message"]]
 
-    @pytest.mark.skipif(HIREDIS_AVAILABLE, reason="PythonParser only")
     @skip_if_server_version_lt("7.0.0")
     def test_push_handler_sharded_pubsub(self, r):
         if is_resp2_connection(r):
diff --git a/tests/test_search.py b/tests/test_search.py
index 7e4f59eb79..4af55e8a17 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -6,6 +6,7 @@
 
 import numpy as np
 import pytest
+from redis import ResponseError
 import redis
 import redis.commands.search
 import redis.commands.search.aggregation as aggregations
@@ -47,8 +48,8 @@
 def waitForIndex(env, idx, timeout=None):
     delay = 0.1
     while True:
-        res = env.execute_command("FT.INFO", idx)
         try:
+            res = env.execute_command("FT.INFO", idx)
             if int(res[res.index("indexing") + 1]) == 0:
                 break
         except ValueError:
@@ -59,6 +60,10 @@ def waitForIndex(env, idx, timeout=None):
                     break
             except ValueError:
                 break
+        except ResponseError:
+            # index doesn't exist yet
+            # continue to sleep and try again
+            pass
 
         time.sleep(delay)
         if timeout is not None:
@@ -1909,6 +1914,8 @@ def test_binary_and_text_fields(client):
         ),
     )
 
+    waitForIndex(client, index_name)
+
     query = (
         Query("*")
         .return_field("vector_emb", decode_field=False)

From 94503631252201d5c2e52577a035d162ac2fda6a Mon Sep 17 00:00:00 2001
From: Shubham Kaudewar <38852978+ShubhamKaudewar@users.noreply.github.com>
Date: Fri, 23 May 2025 17:41:57 +0530
Subject: [PATCH 1059/1164] Update search_json_examples.ipynb:  Fix the old
 import indexDefinition -> index_definition (#3652)

Fix the old import indexDefinition -> index_definition
---
 docs/examples/search_json_examples.ipynb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/examples/search_json_examples.ipynb b/docs/examples/search_json_examples.ipynb
index 9ce1efc0ec..b641a6022d 100644
--- a/docs/examples/search_json_examples.ipynb
+++ b/docs/examples/search_json_examples.ipynb
@@ -30,7 +30,7 @@
     "import redis.commands.search.aggregation as aggregations\n",
     "import redis.commands.search.reducers as reducers\n",
     "from redis.commands.search.field import TextField, NumericField, TagField\n",
-    "from redis.commands.search.indexDefinition import IndexDefinition, IndexType\n",
+    "from redis.commands.search.index_definition import IndexDefinition, IndexType\n",
     "from redis.commands.search.query import NumericFilter, Query\n",
     "\n",
     "\n",

From 02b817808bac74b10206d0f4c2a59d3d5f847bb8 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Fri, 23 May 2025 16:08:07 +0300
Subject: [PATCH 1060/1164] Remove mandatory update the CHANGES file for new
 PRs. Changes file will be kept for history for versions < 4.0.0 (#3645)

---
 .github/PULL_REQUEST_TEMPLATE.md |   1 -
 CHANGES                          | 344 +------------------------------
 2 files changed, 2 insertions(+), 343 deletions(-)

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index 722906b048..66ba87ec23 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -7,7 +7,6 @@ _Please make sure to review and check all of these items:_
 - [ ] Is the new or changed code fully tested?
 - [ ] Is a documentation update included (if this change modifies existing APIs, or introduces new ones)?
 - [ ] Is there an example added to the examples folder (if applicable)?
-- [ ] Was the change added to CHANGES file?
 
 _NOTE: these things are not required to open a PR and can be done
 afterwards / while the PR is open._
diff --git a/CHANGES b/CHANGES
index dbc27dbacc..db57bdd54e 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,346 +1,6 @@
-    * Support transactions in ClusterPipeline
-    * Removing support for RedisGraph module. RedisGraph support is deprecated since Redis Stack 7.2 (https://redis.com/blog/redisgraph-eol/)
-    * Fix lock.extend() typedef to accept float TTL extension
-    * Update URL in the readme linking to Redis University
-    * Move doctests (doc code examples) to main branch
-    * Update `ResponseT` type hint
-    * Allow to control the minimum SSL version
-    * Add an optional lock_name attribute to LockError.
-    * Fix return types for `get`, `set_path` and `strappend` in JSONCommands
-    * Connection.register_connect_callback() is made public.
-    * Fix async `read_response` to use `disable_decoding`.
-    * Add 'aclose()' methods to async classes, deprecate async close().
-    * Fix #2831, add auto_close_connection_pool=True arg to asyncio.Redis.from_url()
-    * Fix incorrect redis.asyncio.Cluster type hint for `retry_on_error`
-    * Fix dead weakref in sentinel connection causing ReferenceError (#2767)
-    * Fix #2768, Fix KeyError: 'first-entry' in parse_xinfo_stream.
-    * Fix #2749, remove unnecessary __del__ logic to close connections.
-    * Fix #2754, adding a missing argument to SentinelManagedConnection
-    * Fix `xadd` command to accept non-negative `maxlen` including 0
-    * Revert #2104, #2673, add `disconnect_on_error` option to `read_response()` (issues #2506, #2624)
-    * Add `address_remap` parameter to `RedisCluster`
-    * Fix incorrect usage of once flag in async Sentinel
-    * asyncio: Fix memory leak caused by hiredis (#2693)
-    * Allow data to drain from async PythonParser when reading during a disconnect()
-    * Use asyncio.timeout() instead of async_timeout.timeout() for python >= 3.11 (#2602)
-    * Add a Dependabot configuration to auto-update GitHub action versions.
-    * Add test and fix async HiredisParser when reading during a disconnect() (#2349)
-    * Use hiredis-py pack_command if available.
-    * Support `.unlink()` in ClusterPipeline
-    * Simplify synchronous SocketBuffer state management
-    * Fix string cleanse in Redis Graph
-    * Make PythonParser resumable in case of error (#2510)
-    * Add `timeout=None` in `SentinelConnectionManager.read_response`
-    * Documentation fix: password protected socket connection (#2374)
-    * Allow `timeout=None` in `PubSub.get_message()` to wait forever
-    * add `nowait` flag to `asyncio.Connection.disconnect()`
-    * Update README.md links
-    * Fix timezone handling for datetime to unixtime conversions
-    * Fix start_id type for XAUTOCLAIM
-    * Remove verbose logging from cluster.py
-    * Add retry mechanism to async version of Connection
-    * Compare commands case-insensitively in the asyncio command parser
-    * Allow negative `retries` for `Retry` class to retry forever
-    * Add `items` parameter to `hset` signature
-    * Create codeql-analysis.yml (#1988). Thanks @chayim
-    * Add limited support for Lua scripting with RedisCluster
-    * Implement `.lock()` method on RedisCluster
-    * Fix cursor returned by SCAN for RedisCluster & change default target to PRIMARIES
-    * Fix scan_iter for RedisCluster
-    * Remove verbose logging when initializing ClusterPubSub, ClusterPipeline or RedisCluster
-    * Fix broken connection writer lock-up for asyncio (#2065)
-    * Fix auth bug when provided with no username (#2086)
-    * Fix missing ClusterPipeline._lock (#2189)
-    * Added dynaminc_startup_nodes configuration to RedisCluster
-    * Fix reusing the old nodes' connections when cluster topology refresh is being done
-    * Fix RedisCluster to immediately raise AuthenticationError without a retry
-    * ClusterPipeline Doesn't Handle ConnectionError for Dead Hosts (#2225)
-    * Remove compatibility code for old versions of Hiredis, drop Packaging dependency
-    * The `deprecated` library is no longer a dependency
-    * Failover handling improvements for RedisCluster and Async RedisCluster (#2377)
-    * Fixed "cannot pickle '_thread.lock' object" bug (#2354, #2297)
-    * Added CredentialsProvider class to support password rotation
-    * Enable Lock for asyncio cluster mode
-    * Fix Sentinel.execute_command doesn't execute across the entire sentinel cluster bug (#2458)
-    * Added a replacement for the default cluster node in the event of failure (#2463)
-    * Fix for Unhandled exception related to self.host with unix socket (#2496)
-    * Improve error output for master discovery 
-    * Make `ClusterCommandsProtocol` an actual Protocol
-    * Add `sum` to DUPLICATE_POLICY documentation of `TS.CREATE`, `TS.ADD` and `TS.ALTER`
-    * Prevent async ClusterPipeline instances from becoming "false-y" in case of empty command stack (#3061)
-    * Close Unix sockets if the connection attempt fails. This prevents `ResourceWarning`s. (#3314)
-    * Close SSL sockets if the connection attempt fails, or if validations fail. (#3317)
-    * Eliminate mutable default arguments in the `redis.commands.core.Script` class. (#3332)
-    * Fix SSL verification with `ssl_cert_reqs="none"` and `ssl_check_hostname=True` by automatically setting `check_hostname=False` when `verify_mode=ssl.CERT_NONE` (#3635) 
-    * Allow newer versions of PyJWT as dependency. (#3630)
+This file contains only the changes history before redis-py version 4.0.0
+After redis-py version 4.0.0 all changes can be found and tracked in the Release notes pubished in GitHub
 
-* 4.1.3 (Feb 8, 2022)
-  * Fix flushdb and flushall (#1926)
-  * Add redis5 and redis4 dockers (#1871)
-  * Change json.clear test multi to be up to date with redisjson (#1922)
-  * Fixing volume for unstable_cluster docker (#1914)
-  * Update changes file with changes since 4.0.0-beta2 (#1915)
-* 4.1.2 (Jan 27, 2022)
-  * Invalid OCSP certificates should raise ConnectionError on failed validation (#1907)
-  * Added retry mechanism on socket timeouts when connecting to the server (#1895)
-  * LMOVE, BLMOVE return incorrect responses (#1906)
-  * Fixing AttributeError in UnixDomainSocketConnection (#1903)
-  * Fixing TypeError in GraphCommands.explain (#1901)
-  * For tests, increasing wait time for the cluster (#1908)
-  * Increased pubsub's wait_for_messages timeout to prevent flaky tests (#1893)
-  * README code snippets formatted to highlight properly (#1888)
-  * Fix link in the main page (#1897)
-  * Documentation fixes: JSON Example, SSL Connection Examples, RTD version (#1887)
-  * Direct link to readthedocs (#1885)
-* 4.1.1 (Jan 17, 2022)
-  * Add retries to connections in Sentinel Pools (#1879)
-  * OCSP Stapling Support (#1873)
-  * Define incr/decr as aliases of incrby/decrby (#1874)
-  * FT.CREATE - support MAXTEXTFIELDS, TEMPORARY, NOHL, NOFREQS, SKIPINITIALSCAN (#1847)
-  * Timeseries docs fix (#1877)
-  * get_connection: catch OSError too (#1832)
-  * Set keys var otherwise variable not created (#1853)
-  * Clusters should optionally require full slot coverage (#1845)
-  * Triple quote docstrings in client.py PEP 257 (#1876)
-  * syncing requirements (#1870)
-  * Typo and typing in GraphCommands documentation (#1855)
-  * Allowing poetry and redis-py to install together (#1854)
-  * setup.py: Add project_urls for PyPI (#1867)
-  * Support test with redis unstable docker (#1850)
-  * Connection examples (#1835)
-  * Documentation cleanup (#1841)
-* 4.1.0 (Dec 26, 2021)
-  * OCSP stapling support (#1820)
-  * Support for SELECT (#1825)
-  * Support for specifying error types with retry (#1817)
-  * Support for RESET command since Redis 6.2.0 (#1824)
-  * Support CLIENT TRACKING (#1612)
-  * Support WRITE in CLIENT PAUSE (#1549)
-  * JSON set_file and set_path support (#1818)
-  * Allow ssl_ca_path with rediss:// urls (#1814)
-  * Support for password-encrypted SSL private keys (#1782)
-  * Support SYNC and PSYNC (#1741)
-  * Retry on error exception and timeout fixes (#1821)
-  * Fixing read race condition during pubsub (#1737)
-  * Fixing exception in listen (#1823)
-  * Fixed MovedError, and stopped iterating through startup nodes when slots are fully covered (#1819)
-  * Socket not closing after server disconnect (#1797)
-  * Single sourcing the package version (#1791)
-  * Ensure redis_connect_func is set on uds connection (#1794)
-  * SRTALGO - Skip for redis versions greater than 7.0.0 (#1831)
-  * Documentation updates (#1822)
-  * Add CI action to install package from repository commit hash (#1781) (#1790)
-  * Fix link in lmove docstring (#1793)
-  * Disabling JSON.DEBUG tests (#1787)
-  * Migrated targeted nodes to kwargs in Cluster Mode (#1762)
-  * Added support for MONITOR in clusters (#1756)
-  * Adding ROLE Command (#1610)
-  * Integrate RedisBloom support (#1683)
-  * Adding RedisGraph support (#1556)
-  * Allow overriding connection class via keyword arguments (#1752)
-  * Aggregation LOAD * support for RediSearch (#1735)
-  * Adding cluster, bloom, and graph docs (#1779)
-  * Add packaging to setup_requires, and use >= to play nice to setup.py (fixes #1625) (#1780)
-  * Fixing the license link in the readme (#1778)
-  * Removing distutils from tests (#1773)
-  * Fix cluster ACL tests (#1774)
-  * Improved RedisCluster's reinitialize_steps and documentation (#1765)
-  * Added black and isort (#1734)
-  * Link Documents for all module commands (#1711)
-  * Pyupgrade + flynt + f-strings (#1759)
-  * Remove unused aggregation subclasses in RediSearch (#1754)
-  * Adding RedisCluster client to support Redis Cluster Mode (#1660)
-  * Support RediSearch FT.PROFILE command (#1727)
-  * Adding support for non-decodable commands (#1731)
-  * COMMAND GETKEYS support (#1738)
-  * RedisJSON 2.0.4 behaviour support (#1747)
-  * Removing deprecating distutils (PEP 632) (#1730)
-  * Updating PR template (#1745)
-  * Removing duplication of Script class (#1751)
-  * Splitting documentation for read the docs (#1743)
-  * Improve code coverage for aggregation tests (#1713)
-  * Fixing COMMAND GETKEYS tests (#1750)
-  * GitHub release improvements (#1684)
-* 4.0.2 (Nov 22, 2021)
-  * Restoring Sentinel commands to redis client (#1723)
-  * Better removal of hiredis warning (#1726)
-  * Adding links to redis documents in function calls (#1719)
-* 4.0.1 (Nov 17, 2021)
-  * Removing command on initial connections (#1722)
-  * Removing hiredis warning when not installed (#1721)
-* 4.0.0 (Nov 15, 2021)
-  * FT.EXPLAINCLI intentionally raising NotImplementedError
-  * Restoring ZRANGE desc for Redis < 6.2.0 (#1697)
-  * Response parsing occasionally fails to parse floats (#1692)
-  * Re-enabling read-the-docs (#1707)
-  * Call HSET after FT.CREATE to avoid keyspace scan (#1706)
-  * Unit tests fixes for compatibility (#1703)
-  * Improve documentation about Locks (#1701)
-  * Fixes to allow --redis-url to pass through all tests (#1700)
-  * Fix unit tests running against Redis 4.0.0 (#1699)
-  * Search alias test fix (#1695)
-  * Adding RediSearch/RedisJSON tests (#1691)
-  * Updating codecov rules (#1689)
-  * Tests to validate custom JSON decoders (#1681)
-  * Added breaking icon to release drafter (#1702)
-  * Removing dependency on six (#1676)
-  * Re-enable pipeline support for JSON and TimeSeries (#1674)
-  * Export Sentinel, and SSL like other classes (#1671)
-  * Restore zrange functionality for older versions of Redis (#1670)
-  * Fixed garbage collection deadlock (#1578)
-  * Tests to validate built python packages (#1678)
-  * Sleep for flaky search test (#1680)
-  * Test function renames, to match standards (#1679)
-  * Docstring improvements for Redis class (#1675)
-  * Fix georadius tests (#1672)
-  * Improvements to JSON coverage (#1666)
-  * Add python_requires setuptools check for python > 3.6 (#1656)
-  * SMISMEMBER support (#1667)
-  * Exposing the module version in loaded_modules (#1648)
-  * RedisTimeSeries support (#1652)
-  * Support for json multipath ($) (#1663)
-  * Added boolean parsing to PEXPIRE and PEXPIREAT (#1665)
-  * Add python_requires setuptools check for python > 3.6 (#1656)
-  * Adding vulture for static analysis (#1655)
-  * Starting to clean the docs (#1657)
-  * Update README.md (#1654)
-  * Adding description format for package (#1651)
-  * Publish to pypi as releases are generated with the release drafter (#1647)
-  * Restore actions to prs (#1653)
-  * Fixing the package to include commands (#1649)
-  * Re-enabling codecov as part of CI process (#1646)
-  * Adding support for redisearch (#1640) Thanks @chayim
-  * redisjson support (#1636) Thanks @chayim
-  * Sentinel: Add SentinelManagedSSLConnection (#1419) Thanks @AbdealiJK
-  * Enable floating parameters in SET (ex and px) (#1635) Thanks @AvitalFineRedis
-  * Add warning when hiredis not installed. Recommend installation. (#1621) Thanks @adiamzn
-  * Raising NotImplementedError for SCRIPT DEBUG and DEBUG SEGFAULT (#1624) Thanks @chayim
-  * CLIENT REDIR command support (#1623) Thanks @chayim
-  * REPLICAOF command implementation (#1622) Thanks @chayim
-  * Add support to NX XX and CH to GEOADD (#1605) Thanks @AvitalFineRedis
-  * Add support to ZRANGE and ZRANGESTORE parameters (#1603) Thanks @AvitalFineRedis
-  * Pre 6.2 redis should default to None for script flush (#1641) Thanks @chayim
-  * Add FULL option to XINFO SUMMARY (#1638) Thanks @agusdmb
-  * Geosearch test should use any=True (#1594) Thanks @Andrew-Chen-Wang
-  * Removing packaging dependency (#1626) Thanks @chayim
-  * Fix client_kill_filter docs for skimpy (#1596) Thanks @Andrew-Chen-Wang
-  * Normalize minid and maxlen docs (#1593) Thanks @Andrew-Chen-Wang
-  * Update docs for multiple usernames for ACL DELUSER (#1595) Thanks @Andrew-Chen-Wang
-  * Fix grammar of get param in set command (#1588) Thanks @Andrew-Chen-Wang
-  * Fix docs for client_kill_filter (#1584) Thanks @Andrew-Chen-Wang
-  * Convert README & CONTRIBUTING from rst to md (#1633) Thanks @davidylee
-  * Test BYLEX param in zrangestore (#1634) Thanks @AvitalFineRedis
-  * Tox integrations with invoke and docker (#1632) Thanks @chayim
-  * Adding the release drafter to help simplify release notes (#1618). Thanks @chayim
-  * BACKWARDS INCOMPATIBLE: Removed support for end of life Python 2.7. #1318
-  * BACKWARDS INCOMPATIBLE: All values within Redis URLs are unquoted via
-      urllib.parse.unquote. Prior versions of redis-py supported this by
-      specifying the ``decode_components`` flag to the ``from_url`` functions.
-      This is now done by default and cannot be disabled. #589
-  * POTENTIALLY INCOMPATIBLE: Redis commands were moved into a mixin
-      (see commands.py). Anyone importing ``redis.client`` to access commands
-      directly should import ``redis.commands``. #1534, #1550
-  * Removed technical debt on REDIS_6_VERSION placeholder. Thanks @chayim #1582.
-  * Various docus fixes. Thanks @Andrew-Chen-Wang #1585, #1586.
-  * Support for LOLWUT command, available since Redis 5.0.0.
-      Thanks @brainix #1568.
-  * Added support for CLIENT REPLY, available in Redis 3.2.0.
-      Thanks @chayim #1581.
-  * Support for Auto-reconnect PubSub on get_message. Thanks @luhn #1574.
-  * Fix RST syntax error in README/ Thanks @JanCBrammer #1451.
-  * IDLETIME and FREQ support for RESTORE. Thanks @chayim #1580.
-  * Supporting args with MODULE LOAD. Thanks @chayim #1579.
-  * Updating RedisLabs with Redis. Thanks @gkorland #1575.
-  * Added support for ASYNC to SCRIPT FLUSH available in Redis 6.2.0.
-      Thanks @chayim. #1567
-  * Added CLIENT LIST fix to support multiple client ids available in
-      Redis 2.8.12. Thanks @chayim #1563.
-  * Added DISCARD support for pipelines available in Redis 2.0.0.
-      Thanks @chayim #1565.
-  * Added ACL DELUSER support for deleting lists of users available in
-      Redis 6.2.0. Thanks @chayim. #1562
-  * Added CLIENT TRACKINFO support available in Redis 6.2.0.
-      Thanks @chayim. #1560
-  * Added GEOSEARCH and GEOSEARCHSTORE support available in Redis 6.2.0.
-      Thanks @AvitalFine Redis. #1526
-  * Added LPUSHX support for lists available in Redis 4.0.0.
-      Thanks @chayim. #1559
-  * Added support for QUIT available in Redis 1.0.0.
-      Thanks @chayim. #1558
-  * Added support for COMMAND COUNT available in Redis 2.8.13.
-      Thanks @chayim. #1554.
-  * Added CREATECONSUMER support for XGROUP available in Redis 6.2.0.
-      Thanks @AvitalFineRedis. #1553
-  * Including slowly complexity in INFO if available.
-      Thanks @ian28223 #1489.
-  * Added support for STRALGO available in Redis 6.0.0.
-      Thanks @AvitalFineRedis. #1528
-  * Addes support for ZMSCORE available in Redis 6.2.0.
-      Thanks @2014BDuck and @jiekun.zhu. #1437
-  * Support MINID and LIMIT on XADD available in Redis 6.2.0.
-      Thanks @AvitalFineRedis. #1548
-  * Added sentinel commands FLUSHCONFIG, CKQUORUM, FAILOVER, and RESET
-      available in Redis 2.8.12.
-      Thanks @otherpirate. #834
-  * Migrated Version instead of StrictVersion for Python 3.10.
-      Thanks @tirkarthi. #1552
-  * Added retry mechanism with backoff. Thanks @nbraun-amazon. #1494
-  * Migrated commands to a mixin. Thanks @chayim. #1534
-  * Added support for ZUNION, available in Redis 6.2.0. Thanks
-      @AvitalFineRedis. #1522
-  * Added support for CLIENT LIST with ID, available in Redis 6.2.0.
-      Thanks @chayim. #1505
-  * Added support for MINID and LIMIT with xtrim, available in Reds 6.2.0.
-      Thanks @chayim. #1508
-  * Implemented LMOVE and BLMOVE commands, available in Redis 6.2.0.
-      Thanks @chayim. #1504
-  * Added GET argument to SET command, available in Redis 6.2.0.
-      Thanks @2014BDuck. #1412
-  * Documentation fixes. Thanks @enjoy-binbin @jonher937. #1496 #1532
-  * Added support for XAUTOCLAIM, available in Redis 6.2.0.
-      Thanks @AvitalFineRedis. #1529
-  * Added IDLE support for XPENDING, available in Redis 6.2.0.
-      Thanks @AvitalFineRedis. #1523
-  * Add a count parameter to lpop/rpop, available in Redis 6.2.0.
-      Thanks @wavenator. #1487
-  * Added a (pypy) trove classifier for Python 3.9.
-      Thanks @D3X. #1535
-  * Added ZINTER support, available in Redis 6.2.0.
-      Thanks @AvitalFineRedis. #1520
-  * Added ZINTER support, available in Redis 6.2.0.
-      Thanks @AvitalFineRedis. #1520
-  * Added ZDIFF and ZDIFFSTORE support, available in Redis 6.2.0.
-      Thanks @AvitalFineRedis. #1518
-  * Added ZRANGESTORE support, available in Redis 6.2.0.
-      Thanks @AvitalFineRedis. #1521
-  * Added LT and GT support for ZADD, available in Redis 6.2.0.
-      Thanks @chayim. #1509
-  * Added ZRANDMEMBER support, available in Redis 6.2.0.
-      Thanks @AvitalFineRedis. #1519
-  * Added GETDEL support, available in Redis 6.2.0.
-      Thanks @AvitalFineRedis. #1514
-  * Added CLIENT KILL laddr filter, available in Redis 6.2.0.
-      Thanks @chayim. #1506
-  * Added CLIENT UNPAUSE, available in Redis 6.2.0.
-      Thanks @chayim. #1512
-  * Added NOMKSTREAM support for XADD, available in Redis 6.2.0.
-      Thanks @chayim. #1507
-  * Added HRANDFIELD support, available in Redis 6.2.0.
-      Thanks @AvitalFineRedis. #1513
-  * Added CLIENT INFO support, available in Redis 6.2.0.
-      Thanks @AvitalFineRedis. #1517
-  * Added GETEX support, available in Redis 6.2.0.
-      Thanks @AvitalFineRedis. #1515
-  * Added support for COPY command, available in Redis 6.2.0.
-      Thanks @malinaa96. #1492
-  * Provide a development and testing environment via docker. Thanks
-      @abrookins. #1365
-  * Added support for the LPOS command available in Redis 6.0.6. Thanks
-      @aparcar #1353/#1354
-  * Added support for the ACL LOG command available in Redis 6. Thanks
-      @2014BDuck. #1307
-  * Added support for ABSTTL option of the RESTORE command available in
-      Redis 5.0. Thanks @charettes. #1423
 * 3.5.3 (June 1, 2020)
   * Restore try/except clauses to __del__ methods. These will be removed
       in 4.0 when more explicit resource management if enforced. #1339

From 3ebfd5b5693e7e2f4c33cfa533116454e1ab5067 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Fri, 23 May 2025 19:19:04 +0300
Subject: [PATCH 1061/1164] fix: Revert wrongly changed default value for
 check_hostname when instantiating RedisSSLContext (#3655)

---
 redis/asyncio/connection.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index d6c03f17c5..326daaa8f8 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -864,7 +864,7 @@ def __init__(
         cert_reqs: Optional[Union[str, ssl.VerifyMode]] = None,
         ca_certs: Optional[str] = None,
         ca_data: Optional[str] = None,
-        check_hostname: bool = True,
+        check_hostname: bool = False,
         min_version: Optional[TLSVersion] = None,
         ciphers: Optional[str] = None,
     ):

From 14a6fc39bdc8688218cc6a4eccc8c1a60306e356 Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Mon, 26 May 2025 14:45:34 +0300
Subject: [PATCH 1062/1164] fix: Fixed potential deadlock from unexpected
 __del__ call (#3654)

---
 redis/client.py     |  5 +++++
 redis/cluster.py    |  6 +++---
 redis/connection.py | 14 +++++++++++---
 3 files changed, 19 insertions(+), 6 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index c662e591e0..ea7f3d84de 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -368,6 +368,8 @@ def __init__(
         ]:
             raise RedisError("Client caching is only supported with RESP version 3")
 
+        # TODO: To avoid breaking changes during the bug fix, we have to keep non-reentrant lock.
+        # TODO: Remove this before next major version (7.0.0)
         self.single_connection_lock = threading.Lock()
         self.connection = None
         self._single_connection_client = single_connection_client
@@ -773,6 +775,9 @@ def __init__(
             self._event_dispatcher = EventDispatcher()
         else:
             self._event_dispatcher = event_dispatcher
+
+        # TODO: To avoid breaking changes during the bug fix, we have to keep non-reentrant lock.
+        # TODO: Remove this before next major version (7.0.0)
         self._lock = threading.Lock()
         if self.encoder is None:
             self.encoder = self.connection_pool.get_encoder()
diff --git a/redis/cluster.py b/redis/cluster.py
index bbc4204bdf..baa85ae122 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -709,7 +709,7 @@ def __init__(
         self.result_callbacks = CaseInsensitiveDict(self.__class__.RESULT_CALLBACKS)
 
         self.commands_parser = CommandsParser(self)
-        self._lock = threading.Lock()
+        self._lock = threading.RLock()
 
     def __enter__(self):
         return self
@@ -1473,7 +1473,7 @@ def __init__(
         self.connection_kwargs = kwargs
         self.read_load_balancer = LoadBalancer()
         if lock is None:
-            lock = threading.Lock()
+            lock = threading.RLock()
         self._lock = lock
         if event_dispatcher is None:
             self._event_dispatcher = EventDispatcher()
@@ -2177,7 +2177,7 @@ def __init__(
             kwargs.get("decode_responses", False),
         )
         if lock is None:
-            lock = threading.Lock()
+            lock = threading.RLock()
         self._lock = lock
         self.parent_execute_command = super().execute_command
         self._execution_strategy: ExecutionStrategy = (
diff --git a/redis/connection.py b/redis/connection.py
index 0884bca362..e87e7976a1 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -820,7 +820,7 @@ def __init__(
         self.credential_provider = conn.credential_provider
         self._pool_lock = pool_lock
         self._cache = cache
-        self._cache_lock = threading.Lock()
+        self._cache_lock = threading.RLock()
         self._current_command_cache_key = None
         self._current_options = None
         self.register_connect_callback(self._enable_tracking_callback)
@@ -1420,8 +1420,16 @@ def __init__(
         # object of this pool. subsequent threads acquiring this lock
         # will notice the first thread already did the work and simply
         # release the lock.
-        self._fork_lock = threading.Lock()
-        self._lock = threading.Lock()
+
+        self._fork_lock = threading.RLock()
+
+        if self.cache is None:
+            self._lock = threading.RLock()
+        else:
+            # TODO: To avoid breaking changes during the bug fix, we have to keep non-reentrant lock.
+            # TODO: Remove this before next major version (7.0.0)
+            self._lock = threading.Lock()
+
         self.reset()
 
     def __repr__(self) -> (str, str):

From e226ad2b4ce4ed3b0f09bc06c0ffcac2e271dd2f Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 27 May 2025 09:58:11 +0300
Subject: [PATCH 1063/1164] Removing connection_pool field from the
 CommandProtocol definition (#3656)

Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
---
 redis/typing.py | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/redis/typing.py b/redis/typing.py
index 24ad607480..ede5385e2d 100644
--- a/redis/typing.py
+++ b/redis/typing.py
@@ -15,8 +15,6 @@
 
 if TYPE_CHECKING:
     from redis._parsers import Encoder
-    from redis.asyncio.connection import ConnectionPool as AsyncConnectionPool
-    from redis.connection import ConnectionPool
 
 
 Number = Union[int, float]
@@ -52,8 +50,6 @@
 
 
 class CommandsProtocol(Protocol):
-    connection_pool: Union["AsyncConnectionPool", "ConnectionPool"]
-
     def execute_command(self, *args, **options) -> ResponseT: ...
 
 

From bc7de608b857f40c51e6d650f0f8e972702e95f1 Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Tue, 27 May 2025 11:58:08 +0300
Subject: [PATCH 1064/1164] [Async] Support for transactions in async
 RedisCluster client (#3649)

* Refactored ClusterPipeline

* Added some basic test coverage

* [Async] Multi Exec on cluster

* Codestyle fix

* Fixed variables access

* Fixed another variable access

* Fixes according to comments

* Changed usage of protected properties

* Revert port changes

* Remove duplicated code, added TODO's
---
 redis/asyncio/cluster.py                      | 769 ++++++++++++++++--
 tests/test_asyncio/test_cluster.py            |   4 -
 .../test_asyncio/test_cluster_transaction.py  | 397 +++++++++
 3 files changed, 1109 insertions(+), 61 deletions(-)
 create mode 100644 tests/test_asyncio/test_cluster_transaction.py

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index aebfef230b..1f34e03011 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -2,16 +2,23 @@
 import collections
 import random
 import socket
+import threading
+import time
 import warnings
+from abc import ABC, abstractmethod
+from copy import copy
+from itertools import chain
 from typing import (
     Any,
     Callable,
+    Coroutine,
     Deque,
     Dict,
     Generator,
     List,
     Mapping,
     Optional,
+    Set,
     Tuple,
     Type,
     TypeVar,
@@ -53,7 +60,10 @@
     ClusterDownError,
     ClusterError,
     ConnectionError,
+    CrossSlotTransactionError,
     DataError,
+    ExecAbortError,
+    InvalidPipelineStack,
     MaxConnectionsError,
     MovedError,
     RedisClusterException,
@@ -62,6 +72,7 @@
     SlotNotCoveredError,
     TimeoutError,
     TryAgainError,
+    WatchError,
 )
 from redis.typing import AnyKeyT, EncodableT, KeyT
 from redis.utils import (
@@ -870,10 +881,7 @@ def pipeline(
         if shard_hint:
             raise RedisClusterException("shard_hint is deprecated in cluster mode")
 
-        if transaction:
-            raise RedisClusterException("transaction is deprecated in cluster mode")
-
-        return ClusterPipeline(self)
+        return ClusterPipeline(self, transaction)
 
     def lock(
         self,
@@ -956,6 +964,30 @@ def lock(
             raise_on_release_error=raise_on_release_error,
         )
 
+    async def transaction(
+        self, func: Coroutine[None, "ClusterPipeline", Any], *watches, **kwargs
+    ):
+        """
+        Convenience method for executing the callable `func` as a transaction
+        while watching all keys specified in `watches`. The 'func' callable
+        should expect a single argument which is a Pipeline object.
+        """
+        shard_hint = kwargs.pop("shard_hint", None)
+        value_from_callable = kwargs.pop("value_from_callable", False)
+        watch_delay = kwargs.pop("watch_delay", None)
+        async with self.pipeline(True, shard_hint) as pipe:
+            while True:
+                try:
+                    if watches:
+                        await pipe.watch(*watches)
+                    func_value = await func(pipe)
+                    exec_value = await pipe.execute()
+                    return func_value if value_from_callable else exec_value
+                except WatchError:
+                    if watch_delay is not None and watch_delay > 0:
+                        time.sleep(watch_delay)
+                    continue
+
 
 class ClusterNode:
     """
@@ -1077,6 +1109,12 @@ def acquire_connection(self) -> Connection:
 
             raise MaxConnectionsError()
 
+    def release(self, connection: Connection) -> None:
+        """
+        Release connection back to free queue.
+        """
+        self._free.append(connection)
+
     async def parse_response(
         self, connection: Connection, command: str, **kwargs: Any
     ) -> Any:
@@ -1247,6 +1285,9 @@ def set_nodes(
                 task = asyncio.create_task(old[name].disconnect())  # noqa
             old[name] = node
 
+    def update_moved_exception(self, exception):
+        self._moved_exception = exception
+
     def _update_moved_slots(self) -> None:
         e = self._moved_exception
         redirected_node = self.get_node(host=e.host, port=e.port)
@@ -1514,41 +1555,47 @@ class ClusterPipeline(AbstractRedis, AbstractRedisCluster, AsyncRedisClusterComm
         | Existing :class:`~.RedisCluster` client
     """
 
-    __slots__ = ("_command_stack", "_client")
-
-    def __init__(self, client: RedisCluster) -> None:
-        self._client = client
+    __slots__ = ("cluster_client", "_transaction", "_execution_strategy")
 
-        self._command_stack: List["PipelineCommand"] = []
+    def __init__(
+        self, client: RedisCluster, transaction: Optional[bool] = None
+    ) -> None:
+        self.cluster_client = client
+        self._transaction = transaction
+        self._execution_strategy: ExecutionStrategy = (
+            PipelineStrategy(self)
+            if not self._transaction
+            else TransactionStrategy(self)
+        )
 
     async def initialize(self) -> "ClusterPipeline":
-        if self._client._initialize:
-            await self._client.initialize()
-        self._command_stack = []
+        await self._execution_strategy.initialize()
         return self
 
     async def __aenter__(self) -> "ClusterPipeline":
         return await self.initialize()
 
     async def __aexit__(self, exc_type: None, exc_value: None, traceback: None) -> None:
-        self._command_stack = []
+        await self.reset()
 
     def __await__(self) -> Generator[Any, None, "ClusterPipeline"]:
         return self.initialize().__await__()
 
     def __enter__(self) -> "ClusterPipeline":
-        self._command_stack = []
+        # TODO: Remove this method before 7.0.0
+        self._execution_strategy._command_queue = []
         return self
 
     def __exit__(self, exc_type: None, exc_value: None, traceback: None) -> None:
-        self._command_stack = []
+        # TODO: Remove this method before 7.0.0
+        self._execution_strategy._command_queue = []
 
     def __bool__(self) -> bool:
         "Pipeline instances should  always evaluate to True on Python 3+"
         return True
 
     def __len__(self) -> int:
-        return len(self._command_stack)
+        return len(self._execution_strategy)
 
     def execute_command(
         self, *args: Union[KeyT, EncodableT], **kwargs: Any
@@ -1564,10 +1611,7 @@ def execute_command(
               or List[:class:`~.ClusterNode`] or Dict[Any, :class:`~.ClusterNode`]
             - Rest of the kwargs are passed to the Redis connection
         """
-        self._command_stack.append(
-            PipelineCommand(len(self._command_stack), *args, **kwargs)
-        )
-        return self
+        return self._execution_strategy.execute_command(*args, **kwargs)
 
     async def execute(
         self, raise_on_error: bool = True, allow_redirections: bool = True
@@ -1587,34 +1631,294 @@ async def execute(
         :raises RedisClusterException: if target_nodes is not provided & the command
             can't be mapped to a slot
         """
-        if not self._command_stack:
+        try:
+            return await self._execution_strategy.execute(
+                raise_on_error, allow_redirections
+            )
+        finally:
+            await self.reset()
+
+    def _split_command_across_slots(
+        self, command: str, *keys: KeyT
+    ) -> "ClusterPipeline":
+        for slot_keys in self.cluster_client._partition_keys_by_slot(keys).values():
+            self.execute_command(command, *slot_keys)
+
+        return self
+
+    async def reset(self):
+        """
+        Reset back to empty pipeline.
+        """
+        await self._execution_strategy.reset()
+
+    def multi(self):
+        """
+        Start a transactional block of the pipeline after WATCH commands
+        are issued. End the transactional block with `execute`.
+        """
+        self._execution_strategy.multi()
+
+    async def discard(self):
+        """ """
+        await self._execution_strategy.discard()
+
+    async def watch(self, *names):
+        """Watches the values at keys ``names``"""
+        await self._execution_strategy.watch(*names)
+
+    async def unwatch(self):
+        """Unwatches all previously specified keys"""
+        await self._execution_strategy.unwatch()
+
+    async def unlink(self, *names):
+        await self._execution_strategy.unlink(*names)
+
+    def mset_nonatomic(
+        self, mapping: Mapping[AnyKeyT, EncodableT]
+    ) -> "ClusterPipeline":
+        return self._execution_strategy.mset_nonatomic(mapping)
+
+
+for command in PIPELINE_BLOCKED_COMMANDS:
+    command = command.replace(" ", "_").lower()
+    if command == "mset_nonatomic":
+        continue
+
+    setattr(ClusterPipeline, command, block_pipeline_command(command))
+
+
+class PipelineCommand:
+    def __init__(self, position: int, *args: Any, **kwargs: Any) -> None:
+        self.args = args
+        self.kwargs = kwargs
+        self.position = position
+        self.result: Union[Any, Exception] = None
+
+    def __repr__(self) -> str:
+        return f"[{self.position}] {self.args} ({self.kwargs})"
+
+
+class ExecutionStrategy(ABC):
+    @abstractmethod
+    async def initialize(self) -> "ClusterPipeline":
+        """
+        Initialize the execution strategy.
+
+        See ClusterPipeline.initialize()
+        """
+        pass
+
+    @abstractmethod
+    def execute_command(
+        self, *args: Union[KeyT, EncodableT], **kwargs: Any
+    ) -> "ClusterPipeline":
+        """
+        Append a raw command to the pipeline.
+
+        See ClusterPipeline.execute_command()
+        """
+        pass
+
+    @abstractmethod
+    async def execute(
+        self, raise_on_error: bool = True, allow_redirections: bool = True
+    ) -> List[Any]:
+        """
+        Execute the pipeline.
+
+        It will retry the commands as specified by retries specified in :attr:`retry`
+        & then raise an exception.
+
+        See ClusterPipeline.execute()
+        """
+        pass
+
+    @abstractmethod
+    def mset_nonatomic(
+        self, mapping: Mapping[AnyKeyT, EncodableT]
+    ) -> "ClusterPipeline":
+        """
+        Executes multiple MSET commands according to the provided slot/pairs mapping.
+
+        See ClusterPipeline.mset_nonatomic()
+        """
+        pass
+
+    @abstractmethod
+    async def reset(self):
+        """
+        Resets current execution strategy.
+
+        See: ClusterPipeline.reset()
+        """
+        pass
+
+    @abstractmethod
+    def multi(self):
+        """
+        Starts transactional context.
+
+        See: ClusterPipeline.multi()
+        """
+        pass
+
+    @abstractmethod
+    async def watch(self, *names):
+        """
+        Watch given keys.
+
+        See: ClusterPipeline.watch()
+        """
+        pass
+
+    @abstractmethod
+    async def unwatch(self):
+        """
+        Unwatches all previously specified keys
+
+        See: ClusterPipeline.unwatch()
+        """
+        pass
+
+    @abstractmethod
+    async def discard(self):
+        pass
+
+    @abstractmethod
+    async def unlink(self, *names):
+        """
+        "Unlink a key specified by ``names``"
+
+        See: ClusterPipeline.unlink()
+        """
+        pass
+
+    @abstractmethod
+    def __len__(self) -> int:
+        pass
+
+
+class AbstractStrategy(ExecutionStrategy):
+    def __init__(self, pipe: ClusterPipeline) -> None:
+        self._pipe: ClusterPipeline = pipe
+        self._command_queue: List["PipelineCommand"] = []
+
+    async def initialize(self) -> "ClusterPipeline":
+        if self._pipe.cluster_client._initialize:
+            await self._pipe.cluster_client.initialize()
+        self._command_queue = []
+        return self._pipe
+
+    def execute_command(
+        self, *args: Union[KeyT, EncodableT], **kwargs: Any
+    ) -> "ClusterPipeline":
+        self._command_queue.append(
+            PipelineCommand(len(self._command_queue), *args, **kwargs)
+        )
+        return self._pipe
+
+    def _annotate_exception(self, exception, number, command):
+        """
+        Provides extra context to the exception prior to it being handled
+        """
+        cmd = " ".join(map(safe_str, command))
+        msg = (
+            f"Command # {number} ({truncate_text(cmd)}) of pipeline "
+            f"caused error: {exception.args[0]}"
+        )
+        exception.args = (msg,) + exception.args[1:]
+
+    @abstractmethod
+    def mset_nonatomic(
+        self, mapping: Mapping[AnyKeyT, EncodableT]
+    ) -> "ClusterPipeline":
+        pass
+
+    @abstractmethod
+    async def execute(
+        self, raise_on_error: bool = True, allow_redirections: bool = True
+    ) -> List[Any]:
+        pass
+
+    @abstractmethod
+    async def reset(self):
+        pass
+
+    @abstractmethod
+    def multi(self):
+        pass
+
+    @abstractmethod
+    async def watch(self, *names):
+        pass
+
+    @abstractmethod
+    async def unwatch(self):
+        pass
+
+    @abstractmethod
+    async def discard(self):
+        pass
+
+    @abstractmethod
+    async def unlink(self, *names):
+        pass
+
+    def __len__(self) -> int:
+        return len(self._command_queue)
+
+
+class PipelineStrategy(AbstractStrategy):
+    def __init__(self, pipe: ClusterPipeline) -> None:
+        super().__init__(pipe)
+
+    def mset_nonatomic(
+        self, mapping: Mapping[AnyKeyT, EncodableT]
+    ) -> "ClusterPipeline":
+        encoder = self._pipe.cluster_client.encoder
+
+        slots_pairs = {}
+        for pair in mapping.items():
+            slot = key_slot(encoder.encode(pair[0]))
+            slots_pairs.setdefault(slot, []).extend(pair)
+
+        for pairs in slots_pairs.values():
+            self.execute_command("MSET", *pairs)
+
+        return self._pipe
+
+    async def execute(
+        self, raise_on_error: bool = True, allow_redirections: bool = True
+    ) -> List[Any]:
+        if not self._command_queue:
             return []
 
         try:
-            retry_attempts = self._client.retry.get_retries()
+            retry_attempts = self._pipe.cluster_client.retry.get_retries()
             while True:
                 try:
-                    if self._client._initialize:
-                        await self._client.initialize()
+                    if self._pipe.cluster_client._initialize:
+                        await self._pipe.cluster_client.initialize()
                     return await self._execute(
-                        self._client,
-                        self._command_stack,
+                        self._pipe.cluster_client,
+                        self._command_queue,
                         raise_on_error=raise_on_error,
                         allow_redirections=allow_redirections,
                     )
 
-                except self.__class__.ERRORS_ALLOW_RETRY as e:
+                except RedisCluster.ERRORS_ALLOW_RETRY as e:
                     if retry_attempts > 0:
                         # Try again with the new cluster setup. All other errors
                         # should be raised.
                         retry_attempts -= 1
-                        await self._client.aclose()
+                        await self._pipe.cluster_client.aclose()
                         await asyncio.sleep(0.25)
                     else:
                         # All other errors should be raised.
                         raise e
         finally:
-            self._command_stack = []
+            await self.reset()
 
     async def _execute(
         self,
@@ -1694,50 +1998,401 @@ async def _execute(
                     for cmd in default_node[1]:
                         # Check if it has a command that failed with a relevant
                         # exception
-                        if type(cmd.result) in self.__class__.ERRORS_ALLOW_RETRY:
+                        if type(cmd.result) in RedisCluster.ERRORS_ALLOW_RETRY:
                             client.replace_default_node()
                             break
 
         return [cmd.result for cmd in stack]
 
-    def _split_command_across_slots(
-        self, command: str, *keys: KeyT
-    ) -> "ClusterPipeline":
-        for slot_keys in self._client._partition_keys_by_slot(keys).values():
-            self.execute_command(command, *slot_keys)
+    async def reset(self):
+        """
+        Reset back to empty pipeline.
+        """
+        self._command_queue = []
 
-        return self
+    def multi(self):
+        raise RedisClusterException(
+            "method multi() is not supported outside of transactional context"
+        )
+
+    async def watch(self, *names):
+        raise RedisClusterException(
+            "method watch() is not supported outside of transactional context"
+        )
+
+    async def unwatch(self):
+        raise RedisClusterException(
+            "method unwatch() is not supported outside of transactional context"
+        )
+
+    async def discard(self):
+        raise RedisClusterException(
+            "method discard() is not supported outside of transactional context"
+        )
+
+    async def unlink(self, *names):
+        if len(names) != 1:
+            raise RedisClusterException(
+                "unlinking multiple keys is not implemented in pipeline command"
+            )
+
+        return self.execute_command("UNLINK", names[0])
+
+
+class TransactionStrategy(AbstractStrategy):
+    NO_SLOTS_COMMANDS = {"UNWATCH"}
+    IMMEDIATE_EXECUTE_COMMANDS = {"WATCH", "UNWATCH"}
+    UNWATCH_COMMANDS = {"DISCARD", "EXEC", "UNWATCH"}
+    SLOT_REDIRECT_ERRORS = (AskError, MovedError)
+    CONNECTION_ERRORS = (
+        ConnectionError,
+        OSError,
+        ClusterDownError,
+        SlotNotCoveredError,
+    )
+
+    def __init__(self, pipe: ClusterPipeline) -> None:
+        super().__init__(pipe)
+        self._explicit_transaction = False
+        self._watching = False
+        self._pipeline_slots: Set[int] = set()
+        self._transaction_node: Optional[ClusterNode] = None
+        self._transaction_connection: Optional[Connection] = None
+        self._executing = False
+        self._retry = copy(self._pipe.cluster_client.retry)
+        self._retry.update_supported_errors(
+            RedisCluster.ERRORS_ALLOW_RETRY + self.SLOT_REDIRECT_ERRORS
+        )
+
+    def _get_client_and_connection_for_transaction(
+        self,
+    ) -> Tuple[ClusterNode, Connection]:
+        """
+        Find a connection for a pipeline transaction.
+
+        For running an atomic transaction, watch keys ensure that contents have not been
+        altered as long as the watch commands for those keys were sent over the same
+        connection. So once we start watching a key, we fetch a connection to the
+        node that owns that slot and reuse it.
+        """
+        if not self._pipeline_slots:
+            raise RedisClusterException(
+                "At least a command with a key is needed to identify a node"
+            )
+
+        node: ClusterNode = self._pipe.cluster_client.nodes_manager.get_node_from_slot(
+            list(self._pipeline_slots)[0], False
+        )
+        self._transaction_node = node
+
+        if not self._transaction_connection:
+            connection: Connection = self._transaction_node.acquire_connection()
+            self._transaction_connection = connection
+
+        return self._transaction_node, self._transaction_connection
+
+    def execute_command(self, *args: Union[KeyT, EncodableT], **kwargs: Any) -> "Any":
+        # Given the limitation of ClusterPipeline sync API, we have to run it in thread.
+        response = None
+        error = None
+
+        def runner():
+            nonlocal response
+            nonlocal error
+            try:
+                response = asyncio.run(self._execute_command(*args, **kwargs))
+            except Exception as e:
+                error = e
+
+        thread = threading.Thread(target=runner)
+        thread.start()
+        thread.join()
+
+        if error:
+            raise error
+
+        return response
+
+    async def _execute_command(
+        self, *args: Union[KeyT, EncodableT], **kwargs: Any
+    ) -> Any:
+        if self._pipe.cluster_client._initialize:
+            await self._pipe.cluster_client.initialize()
+
+        slot_number: Optional[int] = None
+        if args[0] not in self.NO_SLOTS_COMMANDS:
+            slot_number = await self._pipe.cluster_client._determine_slot(*args)
+
+        if (
+            self._watching or args[0] in self.IMMEDIATE_EXECUTE_COMMANDS
+        ) and not self._explicit_transaction:
+            if args[0] == "WATCH":
+                self._validate_watch()
+
+            if slot_number is not None:
+                if self._pipeline_slots and slot_number not in self._pipeline_slots:
+                    raise CrossSlotTransactionError(
+                        "Cannot watch or send commands on different slots"
+                    )
+
+                self._pipeline_slots.add(slot_number)
+            elif args[0] not in self.NO_SLOTS_COMMANDS:
+                raise RedisClusterException(
+                    f"Cannot identify slot number for command: {args[0]},"
+                    "it cannot be triggered in a transaction"
+                )
+
+            return self._immediate_execute_command(*args, **kwargs)
+        else:
+            if slot_number is not None:
+                self._pipeline_slots.add(slot_number)
+
+            return super().execute_command(*args, **kwargs)
+
+    def _validate_watch(self):
+        if self._explicit_transaction:
+            raise RedisError("Cannot issue a WATCH after a MULTI")
+
+        self._watching = True
+
+    async def _immediate_execute_command(self, *args, **options):
+        return await self._retry.call_with_retry(
+            lambda: self._get_connection_and_send_command(*args, **options),
+            self._reinitialize_on_error,
+        )
+
+    async def _get_connection_and_send_command(self, *args, **options):
+        redis_node, connection = self._get_client_and_connection_for_transaction()
+        return await self._send_command_parse_response(
+            connection, redis_node, args[0], *args, **options
+        )
+
+    async def _send_command_parse_response(
+        self,
+        connection: Connection,
+        redis_node: ClusterNode,
+        command_name,
+        *args,
+        **options,
+    ):
+        """
+        Send a command and parse the response
+        """
+
+        await connection.send_command(*args)
+        output = await redis_node.parse_response(connection, command_name, **options)
+
+        if command_name in self.UNWATCH_COMMANDS:
+            self._watching = False
+        return output
+
+    async def _reinitialize_on_error(self, error):
+        if self._watching:
+            if type(error) in self.SLOT_REDIRECT_ERRORS and self._executing:
+                raise WatchError("Slot rebalancing occurred while watching keys")
+
+        if (
+            type(error) in self.SLOT_REDIRECT_ERRORS
+            or type(error) in self.CONNECTION_ERRORS
+        ):
+            if self._transaction_connection:
+                self._transaction_connection = None
+
+            self._pipe.cluster_client.reinitialize_counter += 1
+            if (
+                self._pipe.cluster_client.reinitialize_steps
+                and self._pipe.cluster_client.reinitialize_counter
+                % self._pipe.cluster_client.reinitialize_steps
+                == 0
+            ):
+                await self._pipe.cluster_client.nodes_manager.initialize()
+                self.reinitialize_counter = 0
+            else:
+                self._pipe.cluster_client.nodes_manager.update_moved_exception(error)
+
+        self._executing = False
+
+    def _raise_first_error(self, responses, stack):
+        """
+        Raise the first exception on the stack
+        """
+        for r, cmd in zip(responses, stack):
+            if isinstance(r, Exception):
+                self._annotate_exception(r, cmd.position + 1, cmd.args)
+                raise r
 
     def mset_nonatomic(
         self, mapping: Mapping[AnyKeyT, EncodableT]
     ) -> "ClusterPipeline":
-        encoder = self._client.encoder
+        raise NotImplementedError("Method is not supported in transactional context.")
 
-        slots_pairs = {}
-        for pair in mapping.items():
-            slot = key_slot(encoder.encode(pair[0]))
-            slots_pairs.setdefault(slot, []).extend(pair)
+    async def execute(
+        self, raise_on_error: bool = True, allow_redirections: bool = True
+    ) -> List[Any]:
+        stack = self._command_queue
+        if not stack and (not self._watching or not self._pipeline_slots):
+            return []
 
-        for pairs in slots_pairs.values():
-            self.execute_command("MSET", *pairs)
+        return await self._execute_transaction_with_retries(stack, raise_on_error)
 
-        return self
+    async def _execute_transaction_with_retries(
+        self, stack: List["PipelineCommand"], raise_on_error: bool
+    ):
+        return await self._retry.call_with_retry(
+            lambda: self._execute_transaction(stack, raise_on_error),
+            self._reinitialize_on_error,
+        )
 
+    async def _execute_transaction(
+        self, stack: List["PipelineCommand"], raise_on_error: bool
+    ):
+        if len(self._pipeline_slots) > 1:
+            raise CrossSlotTransactionError(
+                "All keys involved in a cluster transaction must map to the same slot"
+            )
 
-for command in PIPELINE_BLOCKED_COMMANDS:
-    command = command.replace(" ", "_").lower()
-    if command == "mset_nonatomic":
-        continue
+        self._executing = True
 
-    setattr(ClusterPipeline, command, block_pipeline_command(command))
+        redis_node, connection = self._get_client_and_connection_for_transaction()
 
+        stack = chain(
+            [PipelineCommand(0, "MULTI")],
+            stack,
+            [PipelineCommand(0, "EXEC")],
+        )
+        commands = [c.args for c in stack if EMPTY_RESPONSE not in c.kwargs]
+        packed_commands = connection.pack_commands(commands)
+        await connection.send_packed_command(packed_commands)
+        errors = []
+
+        # parse off the response for MULTI
+        # NOTE: we need to handle ResponseErrors here and continue
+        # so that we read all the additional command messages from
+        # the socket
+        try:
+            await redis_node.parse_response(connection, "MULTI")
+        except ResponseError as e:
+            self._annotate_exception(e, 0, "MULTI")
+            errors.append(e)
+        except self.CONNECTION_ERRORS as cluster_error:
+            self._annotate_exception(cluster_error, 0, "MULTI")
+            raise
 
-class PipelineCommand:
-    def __init__(self, position: int, *args: Any, **kwargs: Any) -> None:
-        self.args = args
-        self.kwargs = kwargs
-        self.position = position
-        self.result: Union[Any, Exception] = None
+        # and all the other commands
+        for i, command in enumerate(self._command_queue):
+            if EMPTY_RESPONSE in command.kwargs:
+                errors.append((i, command.kwargs[EMPTY_RESPONSE]))
+            else:
+                try:
+                    _ = await redis_node.parse_response(connection, "_")
+                except self.SLOT_REDIRECT_ERRORS as slot_error:
+                    self._annotate_exception(slot_error, i + 1, command.args)
+                    errors.append(slot_error)
+                except self.CONNECTION_ERRORS as cluster_error:
+                    self._annotate_exception(cluster_error, i + 1, command.args)
+                    raise
+                except ResponseError as e:
+                    self._annotate_exception(e, i + 1, command.args)
+                    errors.append(e)
+
+        response = None
+        # parse the EXEC.
+        try:
+            response = await redis_node.parse_response(connection, "EXEC")
+        except ExecAbortError:
+            if errors:
+                raise errors[0]
+            raise
 
-    def __repr__(self) -> str:
-        return f"[{self.position}] {self.args} ({self.kwargs})"
+        self._executing = False
+
+        # EXEC clears any watched keys
+        self._watching = False
+
+        if response is None:
+            raise WatchError("Watched variable changed.")
+
+        # put any parse errors into the response
+        for i, e in errors:
+            response.insert(i, e)
+
+        if len(response) != len(self._command_queue):
+            raise InvalidPipelineStack(
+                "Unexpected response length for cluster pipeline EXEC."
+                " Command stack was {} but response had length {}".format(
+                    [c.args[0] for c in self._command_queue], len(response)
+                )
+            )
+
+        # find any errors in the response and raise if necessary
+        if raise_on_error or len(errors) > 0:
+            self._raise_first_error(
+                response,
+                self._command_queue,
+            )
+
+        # We have to run response callbacks manually
+        data = []
+        for r, cmd in zip(response, self._command_queue):
+            if not isinstance(r, Exception):
+                command_name = cmd.args[0]
+                if command_name in self._pipe.cluster_client.response_callbacks:
+                    r = self._pipe.cluster_client.response_callbacks[command_name](
+                        r, **cmd.kwargs
+                    )
+            data.append(r)
+        return data
+
+    async def reset(self):
+        self._command_queue = []
+
+        # make sure to reset the connection state in the event that we were
+        # watching something
+        if self._transaction_connection:
+            try:
+                # call this manually since our unwatch or
+                # immediate_execute_command methods can call reset()
+                await self._transaction_connection.send_command("UNWATCH")
+                await self._transaction_connection.read_response()
+                # we can safely return the connection to the pool here since we're
+                # sure we're no longer WATCHing anything
+                self._transaction_node.release(self._transaction_connection)
+                self._transaction_connection = None
+            except self.CONNECTION_ERRORS:
+                # disconnect will also remove any previous WATCHes
+                if self._transaction_connection:
+                    await self._transaction_connection.disconnect()
+
+        # clean up the other instance attributes
+        self._transaction_node = None
+        self._watching = False
+        self._explicit_transaction = False
+        self._pipeline_slots = set()
+        self._executing = False
+
+    def multi(self):
+        if self._explicit_transaction:
+            raise RedisError("Cannot issue nested calls to MULTI")
+        if self._command_queue:
+            raise RedisError(
+                "Commands without an initial WATCH have already been issued"
+            )
+        self._explicit_transaction = True
+
+    async def watch(self, *names):
+        if self._explicit_transaction:
+            raise RedisError("Cannot issue a WATCH after a MULTI")
+
+        return await self.execute_command("WATCH", *names)
+
+    async def unwatch(self):
+        if self._watching:
+            return await self.execute_command("UNWATCH")
+
+        return True
+
+    async def discard(self):
+        await self.reset()
+
+    async def unlink(self, *names):
+        return self.execute_command("UNLINK", *names)
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 1b3fbd5526..7f87131c7a 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -2750,10 +2750,6 @@ class TestClusterPipeline:
 
     async def test_blocked_arguments(self, r: RedisCluster) -> None:
         """Test handling for blocked pipeline arguments."""
-        with pytest.raises(RedisClusterException) as ex:
-            r.pipeline(transaction=True)
-
-        assert str(ex.value) == "transaction is deprecated in cluster mode"
 
         with pytest.raises(RedisClusterException) as ex:
             r.pipeline(shard_hint=True)
diff --git a/tests/test_asyncio/test_cluster_transaction.py b/tests/test_asyncio/test_cluster_transaction.py
new file mode 100644
index 0000000000..e6d66a50ed
--- /dev/null
+++ b/tests/test_asyncio/test_cluster_transaction.py
@@ -0,0 +1,397 @@
+from typing import Tuple
+from unittest.mock import patch, Mock
+
+import pytest
+
+import redis
+from redis import CrossSlotTransactionError, RedisClusterException
+from redis.asyncio import RedisCluster, Connection
+from redis.asyncio.cluster import ClusterNode, NodesManager
+from redis.asyncio.retry import Retry
+from redis.backoff import NoBackoff
+from redis.cluster import PRIMARY
+from tests.conftest import skip_if_server_version_lt
+
+
+def _find_source_and_target_node_for_slot(
+    r: RedisCluster, slot: int
+) -> Tuple[ClusterNode, ClusterNode]:
+    """Returns a pair of ClusterNodes, where the first node is the
+    one that owns the slot and the second is a possible target
+    for that slot, i.e. a primary node different from the first
+    one.
+    """
+    node_migrating = r.nodes_manager.get_node_from_slot(slot)
+    assert node_migrating, f"No node could be found that owns slot #{slot}"
+
+    available_targets = [
+        n
+        for n in r.nodes_manager.startup_nodes.values()
+        if node_migrating.name != n.name and n.server_type == PRIMARY
+    ]
+
+    assert available_targets, f"No possible target nodes for slot #{slot}"
+    return node_migrating, available_targets[0]
+
+
+@pytest.mark.onlycluster
+class TestClusterTransaction:
+    @pytest.mark.onlycluster
+    async def test_pipeline_is_true(self, r) -> None:
+        "Ensure pipeline instances are not false-y"
+        async with r.pipeline(transaction=True) as pipe:
+            assert pipe
+
+    @pytest.mark.onlycluster
+    async def test_pipeline_empty_transaction(self, r):
+        await r.set("a", 0)
+
+        async with r.pipeline(transaction=True) as pipe:
+            assert await pipe.execute() == []
+
+    @pytest.mark.onlycluster
+    async def test_executes_transaction_against_cluster(self, r) -> None:
+        async with r.pipeline(transaction=True) as tx:
+            tx.set("{foo}bar", "value1")
+            tx.set("{foo}baz", "value2")
+            tx.set("{foo}bad", "value3")
+            tx.get("{foo}bar")
+            tx.get("{foo}baz")
+            tx.get("{foo}bad")
+            assert await tx.execute() == [
+                True,
+                True,
+                True,
+                b"value1",
+                b"value2",
+                b"value3",
+            ]
+
+        await r.flushall()
+
+        tx = r.pipeline(transaction=True)
+        tx.set("{foo}bar", "value1")
+        tx.set("{foo}baz", "value2")
+        tx.set("{foo}bad", "value3")
+        tx.get("{foo}bar")
+        tx.get("{foo}baz")
+        tx.get("{foo}bad")
+        assert await tx.execute() == [True, True, True, b"value1", b"value2", b"value3"]
+
+    @pytest.mark.onlycluster
+    async def test_throws_exception_on_different_hash_slots(self, r):
+        async with r.pipeline(transaction=True) as tx:
+            tx.set("{foo}bar", "value1")
+            tx.set("{foobar}baz", "value2")
+
+            with pytest.raises(
+                CrossSlotTransactionError,
+                match="All keys involved in a cluster transaction must map to the same slot",
+            ):
+                await tx.execute()
+
+    @pytest.mark.onlycluster
+    async def test_throws_exception_with_watch_on_different_hash_slots(self, r):
+        async with r.pipeline(transaction=True) as tx:
+            with pytest.raises(
+                RedisClusterException,
+                match="WATCH - all keys must map to the same key slot",
+            ):
+                await tx.watch("key1", "key2")
+
+    @pytest.mark.onlycluster
+    async def test_transaction_with_watched_keys(self, r):
+        await r.set("a", 0)
+
+        async with r.pipeline(transaction=True) as pipe:
+            await pipe.watch("a")
+            a = await pipe.get("a")
+
+            pipe.multi()
+            pipe.set("a", int(a) + 1)
+            assert await pipe.execute() == [True]
+
+    @pytest.mark.onlycluster
+    async def test_retry_transaction_during_unfinished_slot_migration(self, r):
+        """
+        When a transaction is triggered during a migration, MovedError
+        or AskError may appear (depends on the key being already migrated
+        or the key not existing already). The patch on parse_response
+        simulates such an error, but the slot cache is not updated
+        (meaning the migration is still ongoing) so the pipeline eventually
+        fails as if it was retried but the migration is not yet complete.
+        """
+        key = "book"
+        slot = r.keyslot(key)
+        node_migrating, node_importing = _find_source_and_target_node_for_slot(r, slot)
+
+        with patch.object(
+            ClusterNode, "parse_response"
+        ) as parse_response, patch.object(
+            NodesManager, "_update_moved_slots"
+        ) as manager_update_moved_slots:
+
+            def ask_redirect_effect(connection, *args, **options):
+                if "MULTI" in args:
+                    return
+                elif "EXEC" in args:
+                    raise redis.exceptions.ExecAbortError()
+
+                raise redis.exceptions.AskError(f"{slot} {node_importing.name}")
+
+            parse_response.side_effect = ask_redirect_effect
+
+            async with r.pipeline(transaction=True) as pipe:
+                pipe.set(key, "val")
+                with pytest.raises(redis.exceptions.AskError) as ex:
+                    await pipe.execute()
+
+                assert str(ex.value).startswith(
+                    "Command # 1 (SET book val) of pipeline caused error:"
+                    f" {slot} {node_importing.name}"
+                )
+
+            manager_update_moved_slots.assert_called()
+
+    @pytest.mark.onlycluster
+    async def test_retry_transaction_during_slot_migration_successful(
+        self, create_redis
+    ):
+        """
+        If a MovedError or AskError appears when calling EXEC and no key is watched,
+        the pipeline is retried after updating the node manager slot table. If the
+        migration was completed, the transaction may then complete successfully.
+        """
+        r = await create_redis(flushdb=False)
+        key = "book"
+        slot = r.keyslot(key)
+        node_migrating, node_importing = _find_source_and_target_node_for_slot(r, slot)
+
+        with patch.object(
+            ClusterNode, "parse_response"
+        ) as parse_response, patch.object(
+            NodesManager, "_update_moved_slots"
+        ) as manager_update_moved_slots:
+
+            def ask_redirect_effect(conn, *args, **options):
+                # first call should go here, we trigger an AskError
+                if f"{conn.host}:{conn.port}" == node_migrating.name:
+                    if "MULTI" in args:
+                        return
+                    elif "EXEC" in args:
+                        raise redis.exceptions.ExecAbortError()
+
+                    raise redis.exceptions.AskError(f"{slot} {node_importing.name}")
+                # if the slot table is updated, the next call will go here
+                elif f"{conn.host}:{conn.port}" == node_importing.name:
+                    if "EXEC" in args:
+                        return ["OK"]  # mock value to validate this section was called
+                    return
+                else:
+                    assert False, f"unexpected node {conn.host}:{conn.port} was called"
+
+            def update_moved_slot():  # simulate slot table update
+                ask_error = r.nodes_manager._moved_exception
+                assert ask_error is not None, "No AskError was previously triggered"
+                assert f"{ask_error.host}:{ask_error.port}" == node_importing.name
+                r.nodes_manager._moved_exception = None
+                r.nodes_manager.slots_cache[slot] = [node_importing]
+
+            parse_response.side_effect = ask_redirect_effect
+            manager_update_moved_slots.side_effect = update_moved_slot
+
+            result = None
+            async with r.pipeline(transaction=True) as pipe:
+                pipe.multi()
+                pipe.set(key, "val")
+                result = await pipe.execute()
+
+            assert result and True in result, "Target node was not called"
+
+    @pytest.mark.onlycluster
+    async def test_retry_transaction_with_watch_after_slot_migration(self, r):
+        """
+        If a MovedError or AskError appears when calling WATCH, the client
+        must attempt to recover itself before proceeding and no WatchError
+        should appear.
+        """
+        key = "book"
+        slot = r.keyslot(key)
+        r.reinitialize_steps = 1
+
+        # force a MovedError on the first call to pipe.watch()
+        # by switching the node that owns the slot to another one
+        _node_migrating, node_importing = _find_source_and_target_node_for_slot(r, slot)
+        r.nodes_manager.slots_cache[slot] = [node_importing]
+
+        async with r.pipeline(transaction=True) as pipe:
+            await pipe.watch(key)
+            pipe.multi()
+            pipe.set(key, "val")
+            assert await pipe.execute() == [True]
+
+    @pytest.mark.onlycluster
+    async def test_retry_transaction_with_watch_during_slot_migration(self, r):
+        """
+        If a MovedError or AskError appears when calling EXEC and keys were
+        being watched before the migration started, a WatchError should appear.
+        These errors imply resetting the connection and connecting to a new node,
+        so watches are lost anyway and the client code must be notified.
+        """
+        key = "book"
+        slot = r.keyslot(key)
+        node_migrating, node_importing = _find_source_and_target_node_for_slot(r, slot)
+
+        with patch.object(ClusterNode, "parse_response") as parse_response:
+
+            def ask_redirect_effect(conn, *args, **options):
+                if f"{conn.host}:{conn.port}" == node_migrating.name:
+                    # we simulate the watch was sent before the migration started
+                    if "WATCH" in args:
+                        return b"OK"
+                    # but the pipeline was triggered after the migration started
+                    elif "MULTI" in args:
+                        return
+                    elif "EXEC" in args:
+                        raise redis.exceptions.ExecAbortError()
+
+                    raise redis.exceptions.AskError(f"{slot} {node_importing.name}")
+                # we should not try to connect to any other node
+                else:
+                    assert False, f"unexpected node {conn.host}:{conn.port} was called"
+
+            parse_response.side_effect = ask_redirect_effect
+
+            async with r.pipeline(transaction=True) as pipe:
+                await pipe.watch(key)
+
+                pipe.multi()
+                pipe.set(key, "val")
+                with pytest.raises(redis.exceptions.WatchError) as ex:
+                    await pipe.execute()
+
+                assert str(ex.value).startswith(
+                    "Slot rebalancing occurred while watching keys"
+                )
+
+    @pytest.mark.onlycluster
+    async def test_retry_transaction_on_connection_error(self, r):
+        key = "book"
+        slot = r.keyslot(key)
+
+        mock_connection = Mock(spec=Connection)
+        mock_connection.read_response.side_effect = redis.exceptions.ConnectionError(
+            "Conn error"
+        )
+        mock_connection.retry = Retry(NoBackoff(), 0)
+
+        _node_migrating, node_importing = _find_source_and_target_node_for_slot(r, slot)
+        node_importing._free.append(mock_connection)
+        r.nodes_manager.slots_cache[slot] = [node_importing]
+        r.reinitialize_steps = 1
+
+        async with r.pipeline(transaction=True) as pipe:
+            pipe.set(key, "val")
+            assert await pipe.execute() == [True]
+
+        assert mock_connection.read_response.call_count == 1
+
+    @pytest.mark.onlycluster
+    async def test_retry_transaction_on_connection_error_with_watched_keys(self, r):
+        key = "book"
+        slot = r.keyslot(key)
+
+        mock_connection = Mock(spec=Connection)
+        mock_connection.read_response.side_effect = redis.exceptions.ConnectionError(
+            "Conn error"
+        )
+        mock_connection.retry = Retry(NoBackoff(), 0)
+
+        _node_migrating, node_importing = _find_source_and_target_node_for_slot(r, slot)
+        node_importing._free.append(mock_connection)
+        r.nodes_manager.slots_cache[slot] = [node_importing]
+        r.reinitialize_steps = 1
+
+        async with r.pipeline(transaction=True) as pipe:
+            await pipe.watch(key)
+
+            pipe.multi()
+            pipe.set(key, "val")
+            assert await pipe.execute() == [True]
+
+        assert mock_connection.read_response.call_count == 1
+
+    @pytest.mark.onlycluster
+    async def test_exec_error_raised(self, r):
+        hashkey = "{key}"
+        await r.set(f"{hashkey}:c", "a")
+
+        async with r.pipeline(transaction=True) as pipe:
+            pipe.set(f"{hashkey}:a", 1).set(f"{hashkey}:b", 2)
+            pipe.lpush(f"{hashkey}:c", 3).set(f"{hashkey}:d", 4)
+            with pytest.raises(redis.ResponseError) as ex:
+                await pipe.execute()
+            assert str(ex.value).startswith(
+                "Command # 3 (LPUSH {key}:c 3) of pipeline caused error: "
+            )
+
+            # make sure the pipe was restored to a working state
+            assert await pipe.set(f"{hashkey}:z", "zzz").execute() == [True]
+            assert await r.get(f"{hashkey}:z") == b"zzz"
+
+    @pytest.mark.onlycluster
+    async def test_parse_error_raised(self, r):
+        hashkey = "{key}"
+        async with r.pipeline(transaction=True) as pipe:
+            # the zrem is invalid because we don't pass any keys to it
+            pipe.set(f"{hashkey}:a", 1).zrem(f"{hashkey}:b").set(f"{hashkey}:b", 2)
+            with pytest.raises(redis.ResponseError) as ex:
+                await pipe.execute()
+
+            assert str(ex.value).startswith(
+                "Command # 2 (ZREM {key}:b) of pipeline caused error: wrong number"
+            )
+
+            # make sure the pipe was restored to a working state
+            assert await pipe.set(f"{hashkey}:z", "zzz").execute() == [True]
+            assert await r.get(f"{hashkey}:z") == b"zzz"
+
+    @pytest.mark.onlycluster
+    async def test_transaction_callable(self, r):
+        hashkey = "{key}"
+        await r.set(f"{hashkey}:a", 1)
+        await r.set(f"{hashkey}:b", 2)
+        has_run = []
+
+        async def my_transaction(pipe):
+            a_value = await pipe.get(f"{hashkey}:a")
+            assert a_value in (b"1", b"2")
+            b_value = await pipe.get(f"{hashkey}:b")
+            assert b_value == b"2"
+
+            # silly run-once code... incr's "a" so WatchError should be raised
+            # forcing this all to run again. this should incr "a" once to "2"
+            if not has_run:
+                await r.incr(f"{hashkey}:a")
+                has_run.append("it has")
+
+            pipe.multi()
+            pipe.set(f"{hashkey}:c", int(a_value) + int(b_value))
+
+        result = await r.transaction(my_transaction, f"{hashkey}:a", f"{hashkey}:b")
+        assert result == [True]
+        assert await r.get(f"{hashkey}:c") == b"4"
+
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("2.0.0")
+    async def test_transaction_discard(self, r):
+        hashkey = "{key}"
+
+        # pipelines enabled as transactions can be discarded at any point
+        async with r.pipeline(transaction=True) as pipe:
+            await pipe.watch(f"{hashkey}:key")
+            await pipe.set(f"{hashkey}:key", "someval")
+            await pipe.discard()
+
+            assert not pipe._execution_strategy._watching
+            assert not len(pipe)

From e5756daafaf80670b68454334ef00e924e70f07a Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 27 May 2025 13:51:15 +0300
Subject: [PATCH 1065/1164] Dropping Python 3.8 support as it has reached end
 of life (#3657)

---
 .github/workflows/hiredis-py-integration.yaml |  4 ++--
 .github/workflows/integration.yaml            |  8 +++----
 README.md                                     |  2 +-
 pyproject.toml                                |  5 ++---
 .../test_asyncio/test_cluster_transaction.py  | 22 ++++++++++---------
 tests/test_asyncio/test_pubsub.py             |  8 ++++---
 tests/test_cluster_transaction.py             | 18 ++++++++++-----
 tests/test_pubsub.py                          |  8 ++++---
 8 files changed, 43 insertions(+), 32 deletions(-)

diff --git a/.github/workflows/hiredis-py-integration.yaml b/.github/workflows/hiredis-py-integration.yaml
index 947a0df05b..d81b9977b1 100644
--- a/.github/workflows/hiredis-py-integration.yaml
+++ b/.github/workflows/hiredis-py-integration.yaml
@@ -34,7 +34,7 @@ jobs:
     steps:
       - name: Compute outputs
         run: |
-          echo "CURRENT=${{ env.CURRENT_REDIS_VERSION }}" >> $GITHUB_OUTPUT  
+          echo "CURRENT=${{ env.CURRENT_REDIS_VERSION }}" >> $GITHUB_OUTPUT
 
   hiredis-tests:
     runs-on: ubuntu-latest
@@ -45,7 +45,7 @@ jobs:
       fail-fast: false
       matrix:
         redis-version: [ '${{ needs.redis_version.outputs.CURRENT }}' ]
-        python-version: [ '3.8', '3.13']
+        python-version: [ '3.9', '3.13']
         parser-backend: [ 'hiredis' ]
         hiredis-version: [ 'unstable' ]
         event-loop: [ 'asyncio' ]
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 7d0402e9d5..ba746189ad 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -75,7 +75,7 @@ jobs:
       fail-fast: false
       matrix:
         redis-version: ['8.0.1-pre', '${{ needs.redis_version.outputs.CURRENT }}', '7.2.7', '6.2.17']
-        python-version: ['3.8', '3.13']
+        python-version: ['3.9', '3.13']
         parser-backend: ['plain']
         event-loop: ['asyncio']
     env:
@@ -123,7 +123,7 @@ jobs:
       fail-fast: false
       matrix:
         redis-version: [ '${{ needs.redis_version.outputs.CURRENT }}' ]
-        python-version: [ '3.8', '3.13']
+        python-version: [ '3.9', '3.13']
         parser-backend: [ 'hiredis' ]
         hiredis-version: [ '>=3.2.0', '<3.0.0' ]
         event-loop: [ 'asyncio' ]
@@ -149,7 +149,7 @@ jobs:
       fail-fast: false
       matrix:
         redis-version: [ '${{ needs.redis_version.outputs.CURRENT }}' ]
-        python-version: [ '3.8', '3.13' ]
+        python-version: [ '3.9', '3.13' ]
         parser-backend: [ 'plain' ]
         event-loop: [ 'uvloop' ]
     env:
@@ -191,7 +191,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12', '3.13', 'pypy-3.9', 'pypy-3.10']
+        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13', 'pypy-3.9', 'pypy-3.10']
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
diff --git a/README.md b/README.md
index 177f78feeb..414a0cf79e 100644
--- a/README.md
+++ b/README.md
@@ -14,7 +14,7 @@ The Python interface to the Redis key-value store.
 ---------------------------------------------
 
 **Note:** redis-py 5.0 will be the last version of redis-py to support Python 3.7, as it has reached [end of life](https://devguide.python.org/versions/). redis-py 5.1 will support Python 3.8+.
-
+**Note:** redis-py 6.1.0 will be the last version of redis-py to support Python 3.8, as it has reached [end of life](https://devguide.python.org/versions/). redis-py 6.2.0 will support Python 3.9+.
 ---------------------------------------------
 
 ## How do I Redis?
diff --git a/pyproject.toml b/pyproject.toml
index ac692ef9d1..ee061953c5 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -8,7 +8,7 @@ dynamic = ["version"]
 description = "Python client for Redis database and key-value store"
 readme = "README.md"
 license = "MIT"
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 authors = [{ name = "Redis Inc.", email = "oss@redis.com" }]
 keywords = ["Redis", "database", "key-value-store"]
 classifiers = [
@@ -20,7 +20,6 @@ classifiers = [
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
@@ -83,7 +82,7 @@ filterwarnings = [
 ]
 
 [tool.ruff]
-target-version = "py38"
+target-version = "py39"
 line-length = 88
 exclude = [
     "*.egg-info",
diff --git a/tests/test_asyncio/test_cluster_transaction.py b/tests/test_asyncio/test_cluster_transaction.py
index e6d66a50ed..5e540eae5e 100644
--- a/tests/test_asyncio/test_cluster_transaction.py
+++ b/tests/test_asyncio/test_cluster_transaction.py
@@ -125,11 +125,12 @@ async def test_retry_transaction_during_unfinished_slot_migration(self, r):
         slot = r.keyslot(key)
         node_migrating, node_importing = _find_source_and_target_node_for_slot(r, slot)
 
-        with patch.object(
-            ClusterNode, "parse_response"
-        ) as parse_response, patch.object(
-            NodesManager, "_update_moved_slots"
-        ) as manager_update_moved_slots:
+        with (
+            patch.object(ClusterNode, "parse_response") as parse_response,
+            patch.object(
+                NodesManager, "_update_moved_slots"
+            ) as manager_update_moved_slots,
+        ):
 
             def ask_redirect_effect(connection, *args, **options):
                 if "MULTI" in args:
@@ -167,11 +168,12 @@ async def test_retry_transaction_during_slot_migration_successful(
         slot = r.keyslot(key)
         node_migrating, node_importing = _find_source_and_target_node_for_slot(r, slot)
 
-        with patch.object(
-            ClusterNode, "parse_response"
-        ) as parse_response, patch.object(
-            NodesManager, "_update_moved_slots"
-        ) as manager_update_moved_slots:
+        with (
+            patch.object(ClusterNode, "parse_response") as parse_response,
+            patch.object(
+                NodesManager, "_update_moved_slots"
+            ) as manager_update_moved_slots,
+        ):
 
             def ask_redirect_effect(conn, *args, **options):
                 # first call should go here, we trigger an AskError
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index 5ea89a0b8b..d193cc9f2d 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -1048,9 +1048,11 @@ async def get_msg():
         assert msg is not None
         # timeout waiting for another message which never arrives
         assert pubsub.connection.is_connected
-        with patch("redis._parsers._AsyncRESP2Parser.read_response") as mock1, patch(
-            "redis._parsers._AsyncHiredisParser.read_response"
-        ) as mock2, patch("redis._parsers._AsyncRESP3Parser.read_response") as mock3:
+        with (
+            patch("redis._parsers._AsyncRESP2Parser.read_response") as mock1,
+            patch("redis._parsers._AsyncHiredisParser.read_response") as mock2,
+            patch("redis._parsers._AsyncRESP3Parser.read_response") as mock3,
+        ):
             mock1.side_effect = BaseException("boom")
             mock2.side_effect = BaseException("boom")
             mock3.side_effect = BaseException("boom")
diff --git a/tests/test_cluster_transaction.py b/tests/test_cluster_transaction.py
index 0eb7a4f256..cd43441f4c 100644
--- a/tests/test_cluster_transaction.py
+++ b/tests/test_cluster_transaction.py
@@ -124,9 +124,12 @@ def test_retry_transaction_during_unfinished_slot_migration(self, r):
         slot = r.keyslot(key)
         node_migrating, node_importing = _find_source_and_target_node_for_slot(r, slot)
 
-        with patch.object(Redis, "parse_response") as parse_response, patch.object(
-            NodesManager, "_update_moved_slots"
-        ) as manager_update_moved_slots:
+        with (
+            patch.object(Redis, "parse_response") as parse_response,
+            patch.object(
+                NodesManager, "_update_moved_slots"
+            ) as manager_update_moved_slots,
+        ):
 
             def ask_redirect_effect(connection, *args, **options):
                 if "MULTI" in args:
@@ -161,9 +164,12 @@ def test_retry_transaction_during_slot_migration_successful(self, r):
         slot = r.keyslot(key)
         node_migrating, node_importing = _find_source_and_target_node_for_slot(r, slot)
 
-        with patch.object(Redis, "parse_response") as parse_response, patch.object(
-            NodesManager, "_update_moved_slots"
-        ) as manager_update_moved_slots:
+        with (
+            patch.object(Redis, "parse_response") as parse_response,
+            patch.object(
+                NodesManager, "_update_moved_slots"
+            ) as manager_update_moved_slots,
+        ):
 
             def ask_redirect_effect(conn, *args, **options):
                 # first call should go here, we trigger an AskError
diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index ac6965a188..3dc07caf51 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -1138,9 +1138,11 @@ def get_msg():
         assert msg is not None
         # timeout waiting for another message which never arrives
         assert is_connected()
-        with patch("redis._parsers._RESP2Parser.read_response") as mock1, patch(
-            "redis._parsers._HiredisParser.read_response"
-        ) as mock2, patch("redis._parsers._RESP3Parser.read_response") as mock3:
+        with (
+            patch("redis._parsers._RESP2Parser.read_response") as mock1,
+            patch("redis._parsers._HiredisParser.read_response") as mock2,
+            patch("redis._parsers._RESP3Parser.read_response") as mock3,
+        ):
             mock1.side_effect = BaseException("boom")
             mock2.side_effect = BaseException("boom")
             mock3.side_effect = BaseException("boom")

From 34c40ff82d41270b91af864274e052b1394c6652 Mon Sep 17 00:00:00 2001
From: Jacques Cornat <cornat.jacques@gmail.com>
Date: Tue, 27 May 2025 14:51:48 +0200
Subject: [PATCH 1066/1164] fix(doc) : update Python print output in json
 doctests (#3658)

Co-authored-by: Elena Kolevska <elena-kolevska@users.noreply.github.com>
---
 doctests/dt_json.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctests/dt_json.py b/doctests/dt_json.py
index ad0d427ef6..7795926a73 100644
--- a/doctests/dt_json.py
+++ b/doctests/dt_json.py
@@ -72,7 +72,7 @@
 print(res12)  # >>> ['["Deimos", { "crashes": 0 }, null]']
 
 res13 = r.json().get("newbike", "$[1].crashes")
-print(res13)  # >>> ['0']
+print(res13)  # >>> [0]
 
 res14 = r.json().delete("newbike", "$.[-1]")
 print(res14)  # >>> [1]

From 793cdc63ac744bbcd715bc6b51c5c4e77af79618 Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Tue, 27 May 2025 17:32:01 +0300
Subject: [PATCH 1067/1164] maintenance: Update redis-entraid dependency
 (#3661)

Co-authored-by: petyaslavova <petya.slavova@redis.com>
---
 dev_requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev_requirements.txt b/dev_requirements.txt
index ad7330598d..848d6207c4 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -13,4 +13,4 @@ ujson>=4.2.0
 uvloop
 vulture>=2.3.0
 numpy>=1.24.0
-redis-entraid==0.4.0b2
+redis-entraid==1.0.0

From f5cd264c409e5a34578f7df14a041f3a24fa7c8d Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 27 May 2025 19:12:48 +0300
Subject: [PATCH 1068/1164] maintenance: Preparation for release 6.2.0 -
 updating lib version. (#3662)

---
 redis/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/__init__.py b/redis/__init__.py
index cd3ee12adb..c75d853bc6 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -45,7 +45,7 @@ def int_or_str(value):
         return value
 
 
-__version__ = "6.1.0"
+__version__ = "6.2.0"
 VERSION = tuple(map(int_or_str, __version__.split(".")))
 
 

From c1c602d659444f455f578a44682a57ec41206afa Mon Sep 17 00:00:00 2001
From: robertosantamaria-scopely
 <136002179+robertosantamaria-scopely@users.noreply.github.com>
Date: Thu, 29 May 2025 09:13:54 +0200
Subject: [PATCH 1069/1164] fix: avoid instantiating a connection on _repr__
 (#3653)

* fix: avoid instantiating a connection on _repr__

* include full kwargs

* Adding repr fix in async connection pool. Fix failing tests.

---------

Co-authored-by: petyaslavova <petya.slavova@redis.com>
---
 redis/asyncio/connection.py                | 4 +++-
 redis/connection.py                        | 8 +++++---
 tests/test_asyncio/test_connection_pool.py | 9 +++++----
 tests/test_connection_pool.py              | 9 +++++----
 4 files changed, 18 insertions(+), 12 deletions(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 326daaa8f8..95390bd66c 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -1112,9 +1112,11 @@ def __init__(
             self._event_dispatcher = EventDispatcher()
 
     def __repr__(self):
+        conn_kwargs = ",".join([f"{k}={v}" for k, v in self.connection_kwargs.items()])
         return (
             f"<{self.__class__.__module__}.{self.__class__.__name__}"
-            f"({self.connection_class(**self.connection_kwargs)!r})>"
+            f"(<{self.connection_class.__module__}.{self.connection_class.__name__}"
+            f"({conn_kwargs})>)>"
         )
 
     def reset(self):
diff --git a/redis/connection.py b/redis/connection.py
index e87e7976a1..131ae68c61 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1432,10 +1432,12 @@ def __init__(
 
         self.reset()
 
-    def __repr__(self) -> (str, str):
+    def __repr__(self) -> str:
+        conn_kwargs = ",".join([f"{k}={v}" for k, v in self.connection_kwargs.items()])
         return (
-            f"<{type(self).__module__}.{type(self).__name__}"
-            f"({repr(self.connection_class(**self.connection_kwargs))})>"
+            f"<{self.__class__.__module__}.{self.__class__.__name__}"
+            f"(<{self.connection_class.__module__}.{self.connection_class.__name__}"
+            f"({conn_kwargs})>)>"
         )
 
     def get_protocol(self):
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
index 09409e04a8..d016483840 100644
--- a/tests/test_asyncio/test_connection_pool.py
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -294,13 +294,14 @@ def test_repr_contains_db_info_tcp(self):
         pool = redis.ConnectionPool(
             host="localhost", port=6379, client_name="test-client"
         )
-        expected = "host=localhost,port=6379,db=0,client_name=test-client"
+        expected = "host=localhost,port=6379,client_name=test-client"
         assert expected in repr(pool)
 
     def test_repr_contains_db_info_unix(self):
         pool = redis.ConnectionPool(
             connection_class=redis.UnixDomainSocketConnection,
             path="abc",
+            db=0,
             client_name="test-client",
         )
         expected = "path=abc,db=0,client_name=test-client"
@@ -651,7 +652,7 @@ async def test_oom_error(self, r):
             await r.execute_command("DEBUG", "ERROR", "OOM blah blah")
 
     def test_connect_from_url_tcp(self):
-        connection = redis.Redis.from_url("redis://localhost")
+        connection = redis.Redis.from_url("redis://localhost:6379?db=0")
         pool = connection.connection_pool
 
         assert re.match(
@@ -659,7 +660,7 @@ def test_connect_from_url_tcp(self):
         ).groups() == (
             "ConnectionPool",
             "Connection",
-            "host=localhost,port=6379,db=0",
+            "db=0,host=localhost,port=6379",
         )
 
     def test_connect_from_url_unix(self):
@@ -671,7 +672,7 @@ def test_connect_from_url_unix(self):
         ).groups() == (
             "ConnectionPool",
             "UnixDomainSocketConnection",
-            "path=/path/to/socket,db=0",
+            "path=/path/to/socket",
         )
 
     @skip_if_redis_enterprise()
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 9e67659fa9..67b2fd5030 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -205,13 +205,14 @@ def test_repr_contains_db_info_tcp(self):
         pool = redis.ConnectionPool(
             host="localhost", port=6379, client_name="test-client"
         )
-        expected = "host=localhost,port=6379,db=0,client_name=test-client"
+        expected = "host=localhost,port=6379,client_name=test-client"
         assert expected in repr(pool)
 
     def test_repr_contains_db_info_unix(self):
         pool = redis.ConnectionPool(
             connection_class=redis.UnixDomainSocketConnection,
             path="abc",
+            db=0,
             client_name="test-client",
         )
         expected = "path=abc,db=0,client_name=test-client"
@@ -598,7 +599,7 @@ def test_oom_error(self, r):
             r.execute_command("DEBUG", "ERROR", "OOM blah blah")
 
     def test_connect_from_url_tcp(self):
-        connection = redis.Redis.from_url("redis://localhost")
+        connection = redis.Redis.from_url("redis://localhost:6379?db=0")
         pool = connection.connection_pool
 
         assert re.match(
@@ -606,7 +607,7 @@ def test_connect_from_url_tcp(self):
         ).groups() == (
             "ConnectionPool",
             "Connection",
-            "host=localhost,port=6379,db=0",
+            "db=0,host=localhost,port=6379",
         )
 
     def test_connect_from_url_unix(self):
@@ -618,7 +619,7 @@ def test_connect_from_url_unix(self):
         ).groups() == (
             "ConnectionPool",
             "UnixDomainSocketConnection",
-            "path=/path/to/socket,db=0",
+            "path=/path/to/socket",
         )
 
     @skip_if_redis_enterprise()

From 6246cbade4fa9ae879455b498ef8fef5250619b1 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 29 May 2025 15:31:23 +0300
Subject: [PATCH 1070/1164] Fixing the return type hint for the transaction
 method in the standalone client. (#3660)

* Fixing the return type hint for transaction method in standalone client

* Changing Optional to explicitly adding None with Union - to improve clarity
---
 redis/client.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/client.py b/redis/client.py
index ea7f3d84de..28e9a82f76 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -450,7 +450,7 @@ def pipeline(self, transaction=True, shard_hint=None) -> "Pipeline":
 
     def transaction(
         self, func: Callable[["Pipeline"], None], *watches, **kwargs
-    ) -> None:
+    ) -> Union[List[Any], Any, None]:
         """
         Convenience method for executing the callable `func` as a transaction
         while watching all keys specified in `watches`. The 'func' callable

From dd87924ea891527eb9bdf3e4a970875684c09698 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 2 Jun 2025 17:24:23 +0300
Subject: [PATCH 1071/1164] Bump rojopolis/spellcheck-github-actions from
 0.48.0 to 0.49.0 (#3665)

Bumps [rojopolis/spellcheck-github-actions](https://github.com/rojopolis/spellcheck-github-actions) from 0.48.0 to 0.49.0.
- [Release notes](https://github.com/rojopolis/spellcheck-github-actions/releases)
- [Changelog](https://github.com/rojopolis/spellcheck-github-actions/blob/master/CHANGELOG.md)
- [Commits](https://github.com/rojopolis/spellcheck-github-actions/compare/0.48.0...0.49.0)

---
updated-dependencies:
- dependency-name: rojopolis/spellcheck-github-actions
  dependency-version: 0.49.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/spellcheck.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/spellcheck.yml b/.github/workflows/spellcheck.yml
index 4d0fc338d6..6ab2c46701 100644
--- a/.github/workflows/spellcheck.yml
+++ b/.github/workflows/spellcheck.yml
@@ -8,7 +8,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
       - name: Check Spelling
-        uses: rojopolis/spellcheck-github-actions@0.48.0
+        uses: rojopolis/spellcheck-github-actions@0.49.0
         with:
           config_path: .github/spellcheck-settings.yml
           task_name: Markdown

From 5977e387760cb30936629919d5dc76a27652c790 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Mon, 2 Jun 2025 19:51:20 +0300
Subject: [PATCH 1072/1164] Dropping integration tests with Redis 6.2 from
 pipeline actions. (#3659)

---
 .github/actions/run-tests/action.yml | 43 ++++++++++++++--------------
 .github/workflows/integration.yaml   |  2 +-
 2 files changed, 22 insertions(+), 23 deletions(-)

diff --git a/.github/actions/run-tests/action.yml b/.github/actions/run-tests/action.yml
index 20cceb922b..56c601b615 100644
--- a/.github/actions/run-tests/action.yml
+++ b/.github/actions/run-tests/action.yml
@@ -46,7 +46,7 @@ runs:
         CLIENT_LIBS_TEST_IMAGE_TAG: ${{ inputs.redis-version }}
       run: |
         set -e
-                
+
         echo "::group::Installing dependencies"
         pip install -r dev_requirements.txt
         pip uninstall -y redis  # uninstall Redis package installed via redis-entraid
@@ -57,27 +57,26 @@ runs:
             pip install -e ./hiredis-py
           else
             pip install "hiredis${{inputs.hiredis-version}}"
-          fi          
+          fi
           echo "PARSER_BACKEND=$(echo "${{inputs.parser-backend}}_${{inputs.hiredis-version}}" | sed 's/[^a-zA-Z0-9]/_/g')" >> $GITHUB_ENV
         else
           echo "PARSER_BACKEND=${{inputs.parser-backend}}" >> $GITHUB_ENV
         fi
         echo "::endgroup::"
-        
+
         echo "::group::Starting Redis servers"
         redis_major_version=$(echo "$REDIS_VERSION" | grep -oP '^\d+')
         echo "REDIS_MAJOR_VERSION=${redis_major_version}" >> $GITHUB_ENV
-        
+
         if (( redis_major_version < 8 )); then
           echo "Using redis-stack for module tests"
-        
-          # Mapping of redis version to stack version  
+
+          # Mapping of redis version to stack version
           declare -A redis_stack_version_mapping=(
             ["7.4.2"]="rs-7.4.0-v2"
             ["7.2.7"]="rs-7.2.0-v14"
-            ["6.2.17"]="rs-6.2.6-v18"
           )
-                  
+
           if [[ -v redis_stack_version_mapping[$REDIS_VERSION] ]]; then
             export CLIENT_LIBS_TEST_STACK_IMAGE_TAG=${redis_stack_version_mapping[$REDIS_VERSION]}
             echo "REDIS_MOD_URL=redis://127.0.0.1:6479/0" >> $GITHUB_ENV
@@ -85,19 +84,19 @@ runs:
             echo "Version not found in the mapping."
             exit 1
           fi
-                  
+
           if (( redis_major_version < 7 )); then
             export REDIS_STACK_EXTRA_ARGS="--tls-auth-clients optional --save ''"
-            export REDIS_EXTRA_ARGS="--tls-auth-clients optional --save ''"            
+            export REDIS_EXTRA_ARGS="--tls-auth-clients optional --save ''"
           fi
-        
+
           invoke devenv --endpoints=all-stack
         else
           echo "Using redis CE for module tests"
           echo "REDIS_MOD_URL=redis://127.0.0.1:6379" >> $GITHUB_ENV
           invoke devenv --endpoints all
-        fi        
-        
+        fi
+
         sleep 10 # time to settle
         echo "::endgroup::"
       shell: bash
@@ -105,32 +104,32 @@ runs:
     - name: Run tests
       run: |
         set -e
-        
+
         run_tests() {
           local protocol=$1
           local eventloop=""
-    
+
           if [ "${{inputs.event-loop}}" == "uvloop" ]; then
             eventloop="--uvloop"
           fi
-    
+
           echo "::group::RESP${protocol} standalone tests"
           echo "REDIS_MOD_URL=${REDIS_MOD_URL}"
-        
+
           if (( $REDIS_MAJOR_VERSION < 7 )) && [ "$protocol" == "3" ]; then
             echo "Skipping module tests: Modules doesn't support RESP3 for Redis versions < 7"
             invoke standalone-tests --redis-mod-url=${REDIS_MOD_URL} $eventloop --protocol="${protocol}" --extra-markers="not redismod and not cp_integration"
-          else        
+          else
             invoke standalone-tests --redis-mod-url=${REDIS_MOD_URL} $eventloop --protocol="${protocol}"
           fi
-        
+
           echo "::endgroup::"
-            
+
           echo "::group::RESP${protocol} cluster tests"
           invoke cluster-tests $eventloop --protocol=${protocol}
-          echo "::endgroup::"          
+          echo "::endgroup::"
         }
-  
+
         run_tests 2 "${{inputs.event-loop}}"
         run_tests 3 "${{inputs.event-loop}}"
       shell: bash
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index ba746189ad..e3024713e7 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -74,7 +74,7 @@ jobs:
       max-parallel: 15
       fail-fast: false
       matrix:
-        redis-version: ['8.0.1-pre', '${{ needs.redis_version.outputs.CURRENT }}', '7.2.7', '6.2.17']
+        redis-version: ['8.0.1-pre', '${{ needs.redis_version.outputs.CURRENT }}', '7.2.7']
         python-version: ['3.9', '3.13']
         parser-backend: ['plain']
         event-loop: ['asyncio']

From 06fac1d5c5ed7a727b4f9e3f2cc5543dff05795f Mon Sep 17 00:00:00 2001
From: Mahesh Gupta <mahigupta@users.noreply.github.com>
Date: Thu, 5 Jun 2025 07:20:31 -0700
Subject: [PATCH 1073/1164] Fixing sentinel command execution to allow
 returning of actual responses when meaningful - behaviour controlled by
 'return_responses' argument. (#3191)

* Fixing sentinel command response

* Linter check pass

* Applying review comments and fixing some issues.

* Fix several spelling mistakes

* Adding new sentinel integration tests. Fixing the boolean return value type for sentinel's execute_command

* Replacing usage of reduce in the boolean return types with python's built-in 'all' function for better performance and improved readability.

* Changing the default behavior to be as before, returning of the responces is now optional. Fixed the pydocs to reflect the actual method behavior.

---------

Co-authored-by: petyaslavova <petya.slavova@redis.com>
---
 redis/asyncio/sentinel.py           | 34 +++++++----
 redis/commands/sentinel.py          | 54 +++++++++++++----
 redis/sentinel.py                   | 27 ++++++---
 tests/test_asyncio/test_sentinel.py | 89 +++++++++++++++++++++++++++--
 tests/test_sentinel.py              | 88 ++++++++++++++++++++++++++--
 5 files changed, 250 insertions(+), 42 deletions(-)

diff --git a/redis/asyncio/sentinel.py b/redis/asyncio/sentinel.py
index fae6875d82..0bf7086555 100644
--- a/redis/asyncio/sentinel.py
+++ b/redis/asyncio/sentinel.py
@@ -223,19 +223,31 @@ async def execute_command(self, *args, **kwargs):
         once - If set to True, then execute the resulting command on a single
                node at random, rather than across the entire sentinel cluster.
         """
-        once = bool(kwargs.get("once", False))
-        if "once" in kwargs.keys():
-            kwargs.pop("once")
+        once = bool(kwargs.pop("once", False))
+
+        # Check if command is supposed to return the original
+        # responses instead of boolean value.
+        return_responses = bool(kwargs.pop("return_responses", False))
 
         if once:
-            await random.choice(self.sentinels).execute_command(*args, **kwargs)
-        else:
-            tasks = [
-                asyncio.Task(sentinel.execute_command(*args, **kwargs))
-                for sentinel in self.sentinels
-            ]
-            await asyncio.gather(*tasks)
-        return True
+            response = await random.choice(self.sentinels).execute_command(
+                *args, **kwargs
+            )
+            if return_responses:
+                return [response]
+            else:
+                return True if response else False
+
+        tasks = [
+            asyncio.Task(sentinel.execute_command(*args, **kwargs))
+            for sentinel in self.sentinels
+        ]
+        responses = await asyncio.gather(*tasks)
+
+        if return_responses:
+            return responses
+
+        return all(responses)
 
     def __repr__(self):
         sentinel_addresses = []
diff --git a/redis/commands/sentinel.py b/redis/commands/sentinel.py
index f745757955..b2879b2015 100644
--- a/redis/commands/sentinel.py
+++ b/redis/commands/sentinel.py
@@ -11,16 +11,35 @@ def sentinel(self, *args):
         """Redis Sentinel's SENTINEL command."""
         warnings.warn(DeprecationWarning("Use the individual sentinel_* methods"))
 
-    def sentinel_get_master_addr_by_name(self, service_name):
-        """Returns a (host, port) pair for the given ``service_name``"""
-        return self.execute_command("SENTINEL GET-MASTER-ADDR-BY-NAME", service_name)
-
-    def sentinel_master(self, service_name):
-        """Returns a dictionary containing the specified masters state."""
-        return self.execute_command("SENTINEL MASTER", service_name)
+    def sentinel_get_master_addr_by_name(self, service_name, return_responses=False):
+        """
+        Returns a (host, port) pair for the given ``service_name`` when return_responses is True,
+        otherwise returns a boolean value that indicates if the command was successful.
+        """
+        return self.execute_command(
+            "SENTINEL GET-MASTER-ADDR-BY-NAME",
+            service_name,
+            once=True,
+            return_responses=return_responses,
+        )
+
+    def sentinel_master(self, service_name, return_responses=False):
+        """
+        Returns a dictionary containing the specified masters state, when return_responses is True,
+        otherwise returns a boolean value that indicates if the command was successful.
+        """
+        return self.execute_command(
+            "SENTINEL MASTER", service_name, return_responses=return_responses
+        )
 
     def sentinel_masters(self):
-        """Returns a list of dictionaries containing each master's state."""
+        """
+        Returns a list of dictionaries containing each master's state.
+
+        Important: This function is called by the Sentinel implementation and is
+        called directly on the Redis standalone client for sentinels,
+        so it doesn't support the "once" and "return_responses" options.
+        """
         return self.execute_command("SENTINEL MASTERS")
 
     def sentinel_monitor(self, name, ip, port, quorum):
@@ -31,16 +50,27 @@ def sentinel_remove(self, name):
         """Remove a master from Sentinel's monitoring"""
         return self.execute_command("SENTINEL REMOVE", name)
 
-    def sentinel_sentinels(self, service_name):
-        """Returns a list of sentinels for ``service_name``"""
-        return self.execute_command("SENTINEL SENTINELS", service_name)
+    def sentinel_sentinels(self, service_name, return_responses=False):
+        """
+        Returns a list of sentinels for ``service_name``, when return_responses is True,
+        otherwise returns a boolean value that indicates if the command was successful.
+        """
+        return self.execute_command(
+            "SENTINEL SENTINELS", service_name, return_responses=return_responses
+        )
 
     def sentinel_set(self, name, option, value):
         """Set Sentinel monitoring parameters for a given master"""
         return self.execute_command("SENTINEL SET", name, option, value)
 
     def sentinel_slaves(self, service_name):
-        """Returns a list of slaves for ``service_name``"""
+        """
+        Returns a list of slaves for ``service_name``
+
+        Important: This function is called by the Sentinel implementation and is
+        called directly on the Redis standalone client for sentinels,
+        so it doesn't support the "once" and "return_responses" options.
+        """
         return self.execute_command("SENTINEL SLAVES", service_name)
 
     def sentinel_reset(self, pattern):
diff --git a/redis/sentinel.py b/redis/sentinel.py
index 02aa244ede..198639c932 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -254,16 +254,27 @@ def execute_command(self, *args, **kwargs):
         once - If set to True, then execute the resulting command on a single
         node at random, rather than across the entire sentinel cluster.
         """
-        once = bool(kwargs.get("once", False))
-        if "once" in kwargs.keys():
-            kwargs.pop("once")
+        once = bool(kwargs.pop("once", False))
+
+        # Check if command is supposed to return the original
+        # responses instead of boolean value.
+        return_responses = bool(kwargs.pop("return_responses", False))
 
         if once:
-            random.choice(self.sentinels).execute_command(*args, **kwargs)
-        else:
-            for sentinel in self.sentinels:
-                sentinel.execute_command(*args, **kwargs)
-        return True
+            response = random.choice(self.sentinels).execute_command(*args, **kwargs)
+            if return_responses:
+                return [response]
+            else:
+                return True if response else False
+
+        responses = []
+        for sentinel in self.sentinels:
+            responses.append(sentinel.execute_command(*args, **kwargs))
+
+        if return_responses:
+            return responses
+
+        return all(responses)
 
     def __repr__(self):
         sentinel_addresses = []
diff --git a/tests/test_asyncio/test_sentinel.py b/tests/test_asyncio/test_sentinel.py
index a27ba92bb8..8d8b8f512c 100644
--- a/tests/test_asyncio/test_sentinel.py
+++ b/tests/test_asyncio/test_sentinel.py
@@ -84,6 +84,35 @@ def sentinel(request, cluster):
     return Sentinel([("foo", 26379), ("bar", 26379)])
 
 
+@pytest.fixture()
+async def deployed_sentinel(request):
+    sentinel_ips = request.config.getoption("--sentinels")
+    sentinel_endpoints = [
+        (ip.strip(), int(port.strip()))
+        for ip, port in (endpoint.split(":") for endpoint in sentinel_ips.split(","))
+    ]
+    kwargs = {}
+    decode_responses = True
+
+    sentinel_kwargs = {"decode_responses": decode_responses}
+    force_master_ip = "localhost"
+
+    protocol = request.config.getoption("--protocol", 2)
+
+    sentinel = Sentinel(
+        sentinel_endpoints,
+        force_master_ip=force_master_ip,
+        sentinel_kwargs=sentinel_kwargs,
+        socket_timeout=0.1,
+        protocol=protocol,
+        decode_responses=decode_responses,
+        **kwargs,
+    )
+    yield sentinel
+    for s in sentinel.sentinels:
+        await s.close()
+
+
 @pytest.mark.onlynoncluster
 async def test_discover_master(sentinel, master_ip):
     address = await sentinel.discover_master("mymaster")
@@ -226,19 +255,22 @@ async def test_slave_round_robin(cluster, sentinel, master_ip):
 
 
 @pytest.mark.onlynoncluster
-async def test_ckquorum(cluster, sentinel):
-    assert await sentinel.sentinel_ckquorum("mymaster")
+async def test_ckquorum(sentinel):
+    resp = await sentinel.sentinel_ckquorum("mymaster")
+    assert resp is True
 
 
 @pytest.mark.onlynoncluster
-async def test_flushconfig(cluster, sentinel):
-    assert await sentinel.sentinel_flushconfig()
+async def test_flushconfig(sentinel):
+    resp = await sentinel.sentinel_flushconfig()
+    assert resp is True
 
 
 @pytest.mark.onlynoncluster
 async def test_reset(cluster, sentinel):
     cluster.master["is_odown"] = True
-    assert await sentinel.sentinel_reset("mymaster")
+    resp = await sentinel.sentinel_reset("mymaster")
+    assert resp is True
 
 
 @pytest.mark.onlynoncluster
@@ -284,3 +316,50 @@ async def test_repr_correctly_represents_connection_object(sentinel):
         str(connection)
         == "<redis.asyncio.sentinel.SentinelManagedConnection,host=127.0.0.1,port=6379)>"  # noqa: E501
     )
+
+
+# Tests against real sentinel instances
+@pytest.mark.onlynoncluster
+async def test_get_sentinels(deployed_sentinel):
+    resps = await deployed_sentinel.sentinel_sentinels(
+        "redis-py-test", return_responses=True
+    )
+
+    # validate that the original command response is returned
+    assert isinstance(resps, list)
+
+    # validate that the command has been executed against all sentinels
+    # each response from each sentinel is returned
+    assert len(resps) > 1
+
+    # validate default behavior
+    resps = await deployed_sentinel.sentinel_sentinels("redis-py-test")
+    assert isinstance(resps, bool)
+
+
+@pytest.mark.onlynoncluster
+async def test_get_master_addr_by_name(deployed_sentinel):
+    resps = await deployed_sentinel.sentinel_get_master_addr_by_name(
+        "redis-py-test",
+        return_responses=True,
+    )
+
+    # validate that the original command response is returned
+    assert isinstance(resps, list)
+
+    # validate that the command has been executed just once
+    # when executed once, only one response element is returned
+    assert len(resps) == 1
+
+    assert isinstance(resps[0], tuple)
+
+    # validate default behavior
+    resps = await deployed_sentinel.sentinel_get_master_addr_by_name("redis-py-test")
+    assert isinstance(resps, bool)
+
+
+@pytest.mark.onlynoncluster
+async def test_redis_master_usage(deployed_sentinel):
+    r = await deployed_sentinel.master_for("redis-py-test", db=0)
+    await r.set("foo", "bar")
+    assert (await r.get("foo")) == "bar"
diff --git a/tests/test_sentinel.py b/tests/test_sentinel.py
index 93455f3290..0e7624c836 100644
--- a/tests/test_sentinel.py
+++ b/tests/test_sentinel.py
@@ -86,6 +86,35 @@ def sentinel(request, cluster):
     return Sentinel([("foo", 26379), ("bar", 26379)])
 
 
+@pytest.fixture()
+def deployed_sentinel(request):
+    sentinel_ips = request.config.getoption("--sentinels")
+    sentinel_endpoints = [
+        (ip.strip(), int(port.strip()))
+        for ip, port in (endpoint.split(":") for endpoint in sentinel_ips.split(","))
+    ]
+    kwargs = {}
+    decode_responses = True
+
+    sentinel_kwargs = {"decode_responses": decode_responses}
+    force_master_ip = "localhost"
+
+    protocol = request.config.getoption("--protocol", 2)
+
+    sentinel = Sentinel(
+        sentinel_endpoints,
+        force_master_ip=force_master_ip,
+        sentinel_kwargs=sentinel_kwargs,
+        socket_timeout=0.1,
+        protocol=protocol,
+        decode_responses=decode_responses,
+        **kwargs,
+    )
+    yield sentinel
+    for s in sentinel.sentinels:
+        s.close()
+
+
 @pytest.mark.onlynoncluster
 def test_discover_master(sentinel, master_ip):
     address = sentinel.discover_master("mymaster")
@@ -184,7 +213,7 @@ def test_discover_slaves(cluster, sentinel):
 
 
 @pytest.mark.onlynoncluster
-def test_master_for(cluster, sentinel, master_ip):
+def test_master_for(sentinel, master_ip):
     master = sentinel.master_for("mymaster", db=9)
     assert master.ping()
     assert master.connection_pool.master_address == (master_ip, 6379)
@@ -228,19 +257,22 @@ def test_slave_round_robin(cluster, sentinel, master_ip):
 
 
 @pytest.mark.onlynoncluster
-def test_ckquorum(cluster, sentinel):
-    assert sentinel.sentinel_ckquorum("mymaster")
+def test_ckquorum(sentinel):
+    resp = sentinel.sentinel_ckquorum("mymaster")
+    assert resp is True
 
 
 @pytest.mark.onlynoncluster
-def test_flushconfig(cluster, sentinel):
-    assert sentinel.sentinel_flushconfig()
+def test_flushconfig(sentinel):
+    resp = sentinel.sentinel_flushconfig()
+    assert resp is True
 
 
 @pytest.mark.onlynoncluster
 def test_reset(cluster, sentinel):
     cluster.master["is_odown"] = True
-    assert sentinel.sentinel_reset("mymaster")
+    resp = sentinel.sentinel_reset("mymaster")
+    assert resp is True
 
 
 @pytest.mark.onlynoncluster
@@ -266,3 +298,47 @@ def mock_disconnect():
 
     assert calls == 1
     pool.disconnect()
+
+
+# Tests against real sentinel instances
+@pytest.mark.onlynoncluster
+def test_get_sentinels(deployed_sentinel):
+    resps = deployed_sentinel.sentinel_sentinels("redis-py-test", return_responses=True)
+
+    # validate that the original command response is returned
+    assert isinstance(resps, list)
+
+    # validate that the command has been executed against all sentinels
+    # each response from each sentinel is returned
+    assert len(resps) > 1
+
+    # validate default behavior
+    resps = deployed_sentinel.sentinel_sentinels("redis-py-test")
+    assert isinstance(resps, bool)
+
+
+@pytest.mark.onlynoncluster
+def test_get_master_addr_by_name(deployed_sentinel):
+    resps = deployed_sentinel.sentinel_get_master_addr_by_name(
+        "redis-py-test", return_responses=True
+    )
+
+    # validate that the original command response is returned
+    assert isinstance(resps, list)
+
+    # validate that the command has been executed just once
+    # when executed once, only one response element is returned
+    assert len(resps) == 1
+
+    assert isinstance(resps[0], tuple)
+
+    # validate default behavior
+    resps = deployed_sentinel.sentinel_get_master_addr_by_name("redis-py-test")
+    assert isinstance(resps, bool)
+
+
+@pytest.mark.onlynoncluster
+def test_redis_master_usage(deployed_sentinel):
+    r = deployed_sentinel.master_for("redis-py-test", db=0)
+    r.set("foo", "bar")
+    assert r.get("foo") == "bar"

From cf725d49d054d9c0220fcc719f6e6235ef14bdb9 Mon Sep 17 00:00:00 2001
From: Ali-Akber Saifee <ali@indydevs.org>
Date: Mon, 9 Jun 2025 02:43:40 -0700
Subject: [PATCH 1074/1164] Remove deprecated arg from call to ClusterPipeline
 (#3670)

`cluster_error_retry_attempts` is a deprecated argument
that was being passed to the constructor of ClusterPipeline
from the `pipeline` method.
---
 redis/cluster.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index baa85ae122..db9e3e05f7 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -856,7 +856,6 @@ def pipeline(self, transaction=None, shard_hint=None):
             startup_nodes=self.nodes_manager.startup_nodes,
             result_callbacks=self.result_callbacks,
             cluster_response_callbacks=self.cluster_response_callbacks,
-            cluster_error_retry_attempts=self.retry.get_retries(),
             read_from_replicas=self.read_from_replicas,
             load_balancing_strategy=self.load_balancing_strategy,
             reinitialize_steps=self.reinitialize_steps,

From 852a627af19b225a26d2339e2d487785f76f5247 Mon Sep 17 00:00:00 2001
From: tzongw <tzongw@gmail.com>
Date: Wed, 11 Jun 2025 16:45:25 +0800
Subject: [PATCH 1075/1164] TransactionStrategy reset: UNWATCH only when status
 is watching (#3671)

---
 redis/asyncio/cluster.py | 9 +++++----
 redis/cluster.py         | 9 +++++----
 2 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 1f34e03011..5823d2f935 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -2350,10 +2350,11 @@ async def reset(self):
         # watching something
         if self._transaction_connection:
             try:
-                # call this manually since our unwatch or
-                # immediate_execute_command methods can call reset()
-                await self._transaction_connection.send_command("UNWATCH")
-                await self._transaction_connection.read_response()
+                if self._watching:
+                    # call this manually since our unwatch or
+                    # immediate_execute_command methods can call reset()
+                    await self._transaction_connection.send_command("UNWATCH")
+                    await self._transaction_connection.read_response()
                 # we can safely return the connection to the pool here since we're
                 # sure we're no longer WATCHing anything
                 self._transaction_node.release(self._transaction_connection)
diff --git a/redis/cluster.py b/redis/cluster.py
index db9e3e05f7..dbcf5cc2b7 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -3289,10 +3289,11 @@ def reset(self):
         # watching something
         if self._transaction_connection:
             try:
-                # call this manually since our unwatch or
-                # immediate_execute_command methods can call reset()
-                self._transaction_connection.send_command("UNWATCH")
-                self._transaction_connection.read_response()
+                if self._watching:
+                    # call this manually since our unwatch or
+                    # immediate_execute_command methods can call reset()
+                    self._transaction_connection.send_command("UNWATCH")
+                    self._transaction_connection.read_response()
                 # we can safely return the connection to the pool here since we're
                 # sure we're no longer WATCHing anything
                 node = self._nodes_manager.find_connection_owner(

From 9a53d46f37db3b90181116ae5a96018bcd26d35c Mon Sep 17 00:00:00 2001
From: earonesty <erik@q32.com>
Date: Wed, 11 Jun 2025 04:00:21 -0700
Subject: [PATCH 1076/1164] KeyT for set operations (#3190)

* KeyT for set operations

* Changing the dest argument type of sinterstore
---
 redis/commands/core.py | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 378898272f..fa448aaac3 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3290,7 +3290,7 @@ class SetCommands(CommandsProtocol):
     see: https://redis.io/topics/data-types#sets
     """
 
-    def sadd(self, name: str, *values: FieldT) -> Union[Awaitable[int], int]:
+    def sadd(self, name: KeyT, *values: FieldT) -> Union[Awaitable[int], int]:
         """
         Add ``value(s)`` to set ``name``
 
@@ -3298,7 +3298,7 @@ def sadd(self, name: str, *values: FieldT) -> Union[Awaitable[int], int]:
         """
         return self.execute_command("SADD", name, *values)
 
-    def scard(self, name: str) -> Union[Awaitable[int], int]:
+    def scard(self, name: KeyT) -> Union[Awaitable[int], int]:
         """
         Return the number of elements in set ``name``
 
@@ -3337,7 +3337,7 @@ def sinter(self, keys: List, *args: List) -> Union[Awaitable[list], list]:
         return self.execute_command("SINTER", *args, keys=args)
 
     def sintercard(
-        self, numkeys: int, keys: List[str], limit: int = 0
+        self, numkeys: int, keys: List[KeyT], limit: int = 0
     ) -> Union[Awaitable[int], int]:
         """
         Return the cardinality of the intersect of multiple sets specified by ``keys``.
@@ -3352,7 +3352,7 @@ def sintercard(
         return self.execute_command("SINTERCARD", *args, keys=keys)
 
     def sinterstore(
-        self, dest: str, keys: List, *args: List
+        self, dest: KeyT, keys: List, *args: List
     ) -> Union[Awaitable[int], int]:
         """
         Store the intersection of sets specified by ``keys`` into a new
@@ -3364,7 +3364,7 @@ def sinterstore(
         return self.execute_command("SINTERSTORE", dest, *args)
 
     def sismember(
-        self, name: str, value: str
+        self, name: KeyT, value: str
     ) -> Union[Awaitable[Union[Literal[0], Literal[1]]], Union[Literal[0], Literal[1]]]:
         """
         Return whether ``value`` is a member of set ``name``:
@@ -3375,7 +3375,7 @@ def sismember(
         """
         return self.execute_command("SISMEMBER", name, value, keys=[name])
 
-    def smembers(self, name: str) -> Union[Awaitable[Set], Set]:
+    def smembers(self, name: KeyT) -> Union[Awaitable[Set], Set]:
         """
         Return all members of the set ``name``
 
@@ -3384,7 +3384,7 @@ def smembers(self, name: str) -> Union[Awaitable[Set], Set]:
         return self.execute_command("SMEMBERS", name, keys=[name])
 
     def smismember(
-        self, name: str, values: List, *args: List
+        self, name: KeyT, values: List, *args: List
     ) -> Union[
         Awaitable[List[Union[Literal[0], Literal[1]]]],
         List[Union[Literal[0], Literal[1]]],
@@ -3400,7 +3400,7 @@ def smismember(
         args = list_or_args(values, args)
         return self.execute_command("SMISMEMBER", name, *args, keys=[name])
 
-    def smove(self, src: str, dst: str, value: str) -> Union[Awaitable[bool], bool]:
+    def smove(self, src: KeyT, dst: KeyT, value: str) -> Union[Awaitable[bool], bool]:
         """
         Move ``value`` from set ``src`` to set ``dst`` atomically
 
@@ -3408,7 +3408,7 @@ def smove(self, src: str, dst: str, value: str) -> Union[Awaitable[bool], bool]:
         """
         return self.execute_command("SMOVE", src, dst, value)
 
-    def spop(self, name: str, count: Optional[int] = None) -> Union[str, List, None]:
+    def spop(self, name: KeyT, count: Optional[int] = None) -> Union[str, List, None]:
         """
         Remove and return a random member of set ``name``
 
@@ -3418,7 +3418,7 @@ def spop(self, name: str, count: Optional[int] = None) -> Union[str, List, None]
         return self.execute_command("SPOP", name, *args)
 
     def srandmember(
-        self, name: str, number: Optional[int] = None
+        self, name: KeyT, number: Optional[int] = None
     ) -> Union[str, List, None]:
         """
         If ``number`` is None, returns a random member of set ``name``.
@@ -3432,7 +3432,7 @@ def srandmember(
         args = (number is not None) and [number] or []
         return self.execute_command("SRANDMEMBER", name, *args)
 
-    def srem(self, name: str, *values: FieldT) -> Union[Awaitable[int], int]:
+    def srem(self, name: KeyT, *values: FieldT) -> Union[Awaitable[int], int]:
         """
         Remove ``values`` from set ``name``
 
@@ -3450,7 +3450,7 @@ def sunion(self, keys: List, *args: List) -> Union[Awaitable[List], List]:
         return self.execute_command("SUNION", *args, keys=args)
 
     def sunionstore(
-        self, dest: str, keys: List, *args: List
+        self, dest: KeyT, keys: List, *args: List
     ) -> Union[Awaitable[int], int]:
         """
         Store the union of sets specified by ``keys`` into a new

From 8325ce2859b28e61086da904fba6ba87a4ee3d1b Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 12 Jun 2025 12:34:36 +0300
Subject: [PATCH 1077/1164] Removing references to old docs site
 'https://redis-py.readthedocs.io/' replaced by
 'https://redis.readthedocs.io/' (#3674)

---
 README.md                             | 2 +-
 docs/examples/README.md               | 2 +-
 docs/examples/opentelemetry/README.md | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 414a0cf79e..1c4dfc0f11 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,7 @@
 The Python interface to the Redis key-value store.
 
 [![CI](https://github.com/redis/redis-py/workflows/CI/badge.svg?branch=master)](https://github.com/redis/redis-py/actions?query=workflow%3ACI+branch%3Amaster)
-[![docs](https://readthedocs.org/projects/redis/badge/?version=stable&style=flat)](https://redis-py.readthedocs.io/en/stable/)
+[![docs](https://readthedocs.org/projects/redis/badge/?version=stable&style=flat)](https://redis.readthedocs.io/en/stable/)
 [![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 [![pypi](https://badge.fury.io/py/redis.svg)](https://pypi.org/project/redis/)
 [![pre-release](https://img.shields.io/github/v/release/redis/redis-py?include_prereleases&label=latest-prerelease)](https://github.com/redis/redis-py/releases)
diff --git a/docs/examples/README.md b/docs/examples/README.md
index ca6d5dcfa3..89fd85d712 100644
--- a/docs/examples/README.md
+++ b/docs/examples/README.md
@@ -1,3 +1,3 @@
 # Examples
 
-Examples of redis-py usage go here. They're being linked to the [generated documentation](https://redis-py.readthedocs.org).
+Examples of redis-py usage go here. They're being linked to the [generated documentation](https://redis.readthedocs.org).
diff --git a/docs/examples/opentelemetry/README.md b/docs/examples/opentelemetry/README.md
index 58085c9637..2bd1c0cafa 100644
--- a/docs/examples/opentelemetry/README.md
+++ b/docs/examples/opentelemetry/README.md
@@ -4,7 +4,7 @@ This example demonstrates how to monitor Redis using [OpenTelemetry](https://ope
 [Uptrace](https://github.com/uptrace/uptrace). It requires Docker to start Redis Server and Uptrace.
 
 See
-[Monitoring redis-py performance with OpenTelemetry](https://redis-py.readthedocs.io/en/latest/opentelemetry.html)
+[Monitoring redis-py performance with OpenTelemetry](https://redis.readthedocs.io/en/latest/opentelemetry.html)
 for details.
 
 **Step 1**. Download the example using Git:

From b1e5b01dad63795a1eb030d68cd12f14499d1bbb Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Fri, 13 Jun 2025 09:34:43 +0300
Subject: [PATCH 1078/1164] Improve JsonType type definition (#3667)

---
 redis/commands/json/_util.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/redis/commands/json/_util.py b/redis/commands/json/_util.py
index 3400bcd60f..5ef2edcd5c 100644
--- a/redis/commands/json/_util.py
+++ b/redis/commands/json/_util.py
@@ -1,3 +1,5 @@
-from typing import Any, Dict, List, Union
+from typing import List, Mapping, Union
 
-JsonType = Union[str, int, float, bool, None, Dict[str, Any], List[Any]]
+JsonType = Union[
+    str, int, float, bool, None, Mapping[str, "JsonType"], List["JsonType"]
+]

From cc5f1291421c30a4c3a1033e2b47427248b71622 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Mon, 16 Jun 2025 12:15:24 +0300
Subject: [PATCH 1079/1164] Removing the threading.Lock locks and replacing
 them with RLock objects to avoid deadlocks. (#3677)

---
 redis/client.py                   |  8 ++------
 redis/connection.py               | 10 ++--------
 redis/event.py                    |  8 ++++----
 tests/test_cluster_transaction.py |  4 ++--
 tests/test_connection.py          |  6 +++---
 tests/test_credentials.py         | 10 +++++-----
 6 files changed, 18 insertions(+), 28 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 28e9a82f76..0e05b6f542 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -368,9 +368,7 @@ def __init__(
         ]:
             raise RedisError("Client caching is only supported with RESP version 3")
 
-        # TODO: To avoid breaking changes during the bug fix, we have to keep non-reentrant lock.
-        # TODO: Remove this before next major version (7.0.0)
-        self.single_connection_lock = threading.Lock()
+        self.single_connection_lock = threading.RLock()
         self.connection = None
         self._single_connection_client = single_connection_client
         if self._single_connection_client:
@@ -776,9 +774,7 @@ def __init__(
         else:
             self._event_dispatcher = event_dispatcher
 
-        # TODO: To avoid breaking changes during the bug fix, we have to keep non-reentrant lock.
-        # TODO: Remove this before next major version (7.0.0)
-        self._lock = threading.Lock()
+        self._lock = threading.RLock()
         if self.encoder is None:
             self.encoder = self.connection_pool.get_encoder()
         self.health_check_response_b = self.encoder.encode(self.HEALTH_CHECK_MESSAGE)
diff --git a/redis/connection.py b/redis/connection.py
index 131ae68c61..d457b1015c 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -810,7 +810,7 @@ def __init__(
         self,
         conn: ConnectionInterface,
         cache: CacheInterface,
-        pool_lock: threading.Lock,
+        pool_lock: threading.RLock,
     ):
         self.pid = os.getpid()
         self._conn = conn
@@ -1422,13 +1422,7 @@ def __init__(
         # release the lock.
 
         self._fork_lock = threading.RLock()
-
-        if self.cache is None:
-            self._lock = threading.RLock()
-        else:
-            # TODO: To avoid breaking changes during the bug fix, we have to keep non-reentrant lock.
-            # TODO: Remove this before next major version (7.0.0)
-            self._lock = threading.Lock()
+        self._lock = threading.RLock()
 
         self.reset()
 
diff --git a/redis/event.py b/redis/event.py
index 5cc6c0017c..b86c66b082 100644
--- a/redis/event.py
+++ b/redis/event.py
@@ -152,7 +152,7 @@ def __init__(
         self,
         connection,
         client_type: ClientType,
-        connection_lock: Union[threading.Lock, asyncio.Lock],
+        connection_lock: Union[threading.RLock, asyncio.Lock],
     ):
         self._connection = connection
         self._client_type = client_type
@@ -167,7 +167,7 @@ def client_type(self) -> ClientType:
         return self._client_type
 
     @property
-    def connection_lock(self) -> Union[threading.Lock, asyncio.Lock]:
+    def connection_lock(self) -> Union[threading.RLock, asyncio.Lock]:
         return self._connection_lock
 
 
@@ -177,7 +177,7 @@ def __init__(
         pubsub_connection,
         connection_pool,
         client_type: ClientType,
-        connection_lock: Union[threading.Lock, asyncio.Lock],
+        connection_lock: Union[threading.RLock, asyncio.Lock],
     ):
         self._pubsub_connection = pubsub_connection
         self._connection_pool = connection_pool
@@ -197,7 +197,7 @@ def client_type(self) -> ClientType:
         return self._client_type
 
     @property
-    def connection_lock(self) -> Union[threading.Lock, asyncio.Lock]:
+    def connection_lock(self) -> Union[threading.RLock, asyncio.Lock]:
         return self._connection_lock
 
 
diff --git a/tests/test_cluster_transaction.py b/tests/test_cluster_transaction.py
index cd43441f4c..6ebd6df566 100644
--- a/tests/test_cluster_transaction.py
+++ b/tests/test_cluster_transaction.py
@@ -285,7 +285,7 @@ def test_retry_transaction_on_connection_error(self, r, mock_connection):
         mock_pool = Mock(spec=ConnectionPool)
         mock_pool.get_connection.return_value = mock_connection
         mock_pool._available_connections = [mock_connection]
-        mock_pool._lock = threading.Lock()
+        mock_pool._lock = threading.RLock()
 
         _node_migrating, node_importing = _find_source_and_target_node_for_slot(r, slot)
         node_importing.redis_connection.connection_pool = mock_pool
@@ -310,7 +310,7 @@ def test_retry_transaction_on_connection_error_with_watched_keys(
         mock_pool = Mock(spec=ConnectionPool)
         mock_pool.get_connection.return_value = mock_connection
         mock_pool._available_connections = [mock_connection]
-        mock_pool._lock = threading.Lock()
+        mock_pool._lock = threading.RLock()
 
         _node_migrating, node_importing = _find_source_and_target_node_for_slot(r, slot)
         node_importing.redis_connection.connection_pool = mock_pool
diff --git a/tests/test_connection.py b/tests/test_connection.py
index 9664146ce5..89ea04df75 100644
--- a/tests/test_connection.py
+++ b/tests/test_connection.py
@@ -442,7 +442,7 @@ def test_clears_cache_on_disconnect(self, mock_connection, cache_conf):
         mock_connection.credential_provider = UsernamePasswordCredentialProvider()
 
         proxy_connection = CacheProxyConnection(
-            mock_connection, cache, threading.Lock()
+            mock_connection, cache, threading.RLock()
         )
         proxy_connection.disconnect()
 
@@ -492,7 +492,7 @@ def test_read_response_returns_cached_reply(self, mock_cache, mock_connection):
         mock_connection.can_read.return_value = False
 
         proxy_connection = CacheProxyConnection(
-            mock_connection, mock_cache, threading.Lock()
+            mock_connection, mock_cache, threading.RLock()
         )
         proxy_connection.send_command(*["GET", "foo"], **{"keys": ["foo"]})
         assert proxy_connection.read_response() == b"bar"
@@ -554,7 +554,7 @@ def test_triggers_invalidation_processing_on_another_connection(
         mock_connection.can_read.return_value = False
 
         proxy_connection = CacheProxyConnection(
-            mock_connection, mock_cache, threading.Lock()
+            mock_connection, mock_cache, threading.RLock()
         )
         proxy_connection.send_command(*["GET", "foo"], **{"keys": ["foo"]})
 
diff --git a/tests/test_credentials.py b/tests/test_credentials.py
index 58bbd01f28..8b8e0cfc2c 100644
--- a/tests/test_credentials.py
+++ b/tests/test_credentials.py
@@ -323,7 +323,7 @@ def test_re_auth_all_connections(self, credential_provider):
         }
         mock_pool.get_connection.return_value = mock_connection
         mock_pool._available_connections = [mock_connection, mock_another_connection]
-        mock_pool._lock = threading.Lock()
+        mock_pool._lock = threading.RLock()
         auth_token = None
 
         def re_auth_callback(token):
@@ -382,7 +382,7 @@ def test_re_auth_partial_connections(self, credential_provider):
             mock_another_connection,
             mock_failed_connection,
         ]
-        mock_pool._lock = threading.Lock()
+        mock_pool._lock = threading.RLock()
 
         def _raise(error: RedisError):
             pass
@@ -442,7 +442,7 @@ def test_re_auth_pub_sub_in_resp3(self, credential_provider):
             mock_another_connection,
         ]
         mock_pool._available_connections = [mock_another_connection]
-        mock_pool._lock = threading.Lock()
+        mock_pool._lock = threading.RLock()
         auth_token = None
 
         def re_auth_callback(token):
@@ -502,7 +502,7 @@ def test_do_not_re_auth_pub_sub_in_resp2(self, credential_provider):
             mock_another_connection,
         ]
         mock_pool._available_connections = [mock_another_connection]
-        mock_pool._lock = threading.Lock()
+        mock_pool._lock = threading.RLock()
         auth_token = None
 
         def re_auth_callback(token):
@@ -560,7 +560,7 @@ def test_fails_on_token_renewal(self, credential_provider):
         }
         mock_pool.get_connection.return_value = mock_connection
         mock_pool._available_connections = [mock_connection, mock_another_connection]
-        mock_pool._lock = threading.Lock()
+        mock_pool._lock = threading.RLock()
 
         Redis(
             connection_pool=mock_pool,

From 0d0cfe66eaa541dfc078398f37277e5de8d11dc8 Mon Sep 17 00:00:00 2001
From: Luka Mikec <luka.mikec1@gmail.com>
Date: Mon, 16 Jun 2025 16:52:09 +0200
Subject: [PATCH 1080/1164] Redis Search/Aggregate improved type annotations
 (#3676)

* Fix ft.aggregate variable arguments type annotation

* Fix ft.aggregate query type annotation
---
 redis/commands/search/aggregation.py | 6 +++---
 redis/commands/search/commands.py    | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/redis/commands/search/aggregation.py b/redis/commands/search/aggregation.py
index 13edefa081..00435f626b 100644
--- a/redis/commands/search/aggregation.py
+++ b/redis/commands/search/aggregation.py
@@ -26,7 +26,7 @@ class Reducer:
 
     NAME = None
 
-    def __init__(self, *args: List[str]) -> None:
+    def __init__(self, *args: str) -> None:
         self._args = args
         self._field = None
         self._alias = None
@@ -116,7 +116,7 @@ def __init__(self, query: str = "*") -> None:
         self._add_scores = False
         self._scorer = "TFIDF"
 
-    def load(self, *fields: List[str]) -> "AggregateRequest":
+    def load(self, *fields: str) -> "AggregateRequest":
         """
         Indicate the fields to be returned in the response. These fields are
         returned in addition to any others implicitly specified.
@@ -223,7 +223,7 @@ def limit(self, offset: int, num: int) -> "AggregateRequest":
         self._aggregateplan.extend(_limit.build_args())
         return self
 
-    def sort_by(self, *fields: List[str], **kwargs) -> "AggregateRequest":
+    def sort_by(self, *fields: str, **kwargs) -> "AggregateRequest":
         """
         Indicate how the results should be sorted. This can also be used for
         *top-N* style queries
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index bc48fa9aa8..80d9b35728 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -542,7 +542,7 @@ def explain_cli(self, query: Union[str, Query]):  # noqa
 
     def aggregate(
         self,
-        query: Union[str, Query],
+        query: Union[AggregateRequest, Cursor],
         query_params: Dict[str, Union[str, int, float]] = None,
     ):
         """
@@ -573,7 +573,7 @@ def aggregate(
         )
 
     def _get_aggregate_result(
-        self, raw: List, query: Union[str, Query, AggregateRequest], has_cursor: bool
+        self, raw: List, query: Union[AggregateRequest, Cursor], has_cursor: bool
     ):
         if has_cursor:
             if isinstance(query, Cursor):
@@ -967,7 +967,7 @@ async def search(
 
     async def aggregate(
         self,
-        query: Union[str, Query],
+        query: Union[AggregateResult, Cursor],
         query_params: Dict[str, Union[str, int, float]] = None,
     ):
         """

From a0306fe773358bd9d5fa6da4f6e39817c2f90ecc Mon Sep 17 00:00:00 2001
From: Ilian Iliev <ilian@ilian.io>
Date: Thu, 26 Jun 2025 18:00:30 +0300
Subject: [PATCH 1081/1164] Removing unnecessary check for tests using
 AsyncMock (#3432)

---
 tests/test_asyncio/compat.py                           | 6 ------
 tests/test_asyncio/conftest.py                         | 3 +--
 tests/test_asyncio/test_cluster.py                     | 3 ++-
 tests/test_asyncio/test_connection.py                  | 2 +-
 tests/test_asyncio/test_connection_pool.py             | 3 ++-
 tests/test_asyncio/test_pipeline.py                    | 4 +++-
 tests/test_asyncio/test_pubsub.py                      | 4 +++-
 tests/test_asyncio/test_sentinel_managed_connection.py | 3 +--
 8 files changed, 13 insertions(+), 15 deletions(-)

diff --git a/tests/test_asyncio/compat.py b/tests/test_asyncio/compat.py
index aa1dc49af0..97c62c53c3 100644
--- a/tests/test_asyncio/compat.py
+++ b/tests/test_asyncio/compat.py
@@ -1,10 +1,4 @@
 import asyncio
-from unittest import mock
-
-try:
-    mock.AsyncMock
-except AttributeError:
-    from unittest import mock
 
 try:
     from contextlib import aclosing
diff --git a/tests/test_asyncio/conftest.py b/tests/test_asyncio/conftest.py
index 340d146ea3..7ebc2190df 100644
--- a/tests/test_asyncio/conftest.py
+++ b/tests/test_asyncio/conftest.py
@@ -1,6 +1,7 @@
 import random
 from contextlib import asynccontextmanager as _asynccontextmanager
 from typing import Union
+from unittest import mock
 
 import pytest
 import pytest_asyncio
@@ -14,8 +15,6 @@
 from redis.credentials import CredentialProvider
 from tests.conftest import REDIS_INFO, get_credential_provider
 
-from .compat import mock
-
 
 async def _get_info(redis_url):
     client = redis.Redis.from_url(redis_url)
diff --git a/tests/test_asyncio/test_cluster.py b/tests/test_asyncio/test_cluster.py
index 7f87131c7a..25f487fe4c 100644
--- a/tests/test_asyncio/test_cluster.py
+++ b/tests/test_asyncio/test_cluster.py
@@ -4,6 +4,7 @@
 import ssl
 import warnings
 from typing import Any, Awaitable, Callable, Dict, List, Optional, Type, Union
+from unittest import mock
 from urllib.parse import urlparse
 
 import pytest
@@ -48,7 +49,7 @@
 )
 
 from ..ssl_utils import get_tls_certificates
-from .compat import aclosing, mock
+from .compat import aclosing
 
 pytestmark = pytest.mark.onlycluster
 
diff --git a/tests/test_asyncio/test_connection.py b/tests/test_asyncio/test_connection.py
index 38764d30cd..35d404a36e 100644
--- a/tests/test_asyncio/test_connection.py
+++ b/tests/test_asyncio/test_connection.py
@@ -1,6 +1,7 @@
 import asyncio
 import socket
 import types
+from unittest import mock
 from errno import ECONNREFUSED
 from unittest.mock import patch
 
@@ -25,7 +26,6 @@
 from redis.utils import HIREDIS_AVAILABLE
 from tests.conftest import skip_if_server_version_lt
 
-from .compat import mock
 from .mocks import MockStream
 
 
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
index d016483840..c30220fb1d 100644
--- a/tests/test_asyncio/test_connection_pool.py
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -1,5 +1,6 @@
 import asyncio
 import re
+from unittest import mock
 
 import pytest
 import pytest_asyncio
@@ -8,7 +9,7 @@
 from redis.auth.token import TokenInterface
 from tests.conftest import skip_if_redis_enterprise, skip_if_server_version_lt
 
-from .compat import aclosing, mock
+from .compat import aclosing
 from .conftest import asynccontextmanager
 from .test_pubsub import wait_for_message
 
diff --git a/tests/test_asyncio/test_pipeline.py b/tests/test_asyncio/test_pipeline.py
index 19e11dc792..1f8c743b48 100644
--- a/tests/test_asyncio/test_pipeline.py
+++ b/tests/test_asyncio/test_pipeline.py
@@ -1,8 +1,10 @@
+from unittest import mock
+
 import pytest
 import redis
 from tests.conftest import skip_if_server_version_lt
 
-from .compat import aclosing, mock
+from .compat import aclosing
 from .conftest import wait_for_command
 
 
diff --git a/tests/test_asyncio/test_pubsub.py b/tests/test_asyncio/test_pubsub.py
index d193cc9f2d..b281cb1281 100644
--- a/tests/test_asyncio/test_pubsub.py
+++ b/tests/test_asyncio/test_pubsub.py
@@ -12,6 +12,8 @@
 else:
     from async_timeout import timeout as async_timeout
 
+from unittest import mock
+
 import pytest
 import pytest_asyncio
 import redis.asyncio as redis
@@ -19,7 +21,7 @@
 from redis.typing import EncodableT
 from tests.conftest import get_protocol_version, skip_if_server_version_lt
 
-from .compat import aclosing, create_task, mock
+from .compat import aclosing, create_task
 
 
 def with_timeout(t):
diff --git a/tests/test_asyncio/test_sentinel_managed_connection.py b/tests/test_asyncio/test_sentinel_managed_connection.py
index cae4b9581f..01f717ee38 100644
--- a/tests/test_asyncio/test_sentinel_managed_connection.py
+++ b/tests/test_asyncio/test_sentinel_managed_connection.py
@@ -1,12 +1,11 @@
 import socket
+from unittest import mock
 
 import pytest
 from redis.asyncio.retry import Retry
 from redis.asyncio.sentinel import SentinelManagedConnection
 from redis.backoff import NoBackoff
 
-from .compat import mock
-
 pytestmark = pytest.mark.asyncio
 
 

From 23422c14ce9dbd0e9839201621c0bb91bf6c7c02 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Fri, 27 Jun 2025 13:15:06 +0300
Subject: [PATCH 1082/1164] Updating test images for github pipeline execution
 (#3678)

---
 .github/actions/run-tests/action.yml          |  6 ++++--
 .github/workflows/hiredis-py-integration.yaml |  4 ++--
 .github/workflows/integration.yaml            |  6 +++---
 docker-compose.yml                            |  4 ++--
 tests/test_commands.py                        | 10 ++++++++++
 5 files changed, 21 insertions(+), 9 deletions(-)

diff --git a/.github/actions/run-tests/action.yml b/.github/actions/run-tests/action.yml
index 56c601b615..f2331a92a5 100644
--- a/.github/actions/run-tests/action.yml
+++ b/.github/actions/run-tests/action.yml
@@ -73,8 +73,8 @@ runs:
 
           # Mapping of redis version to stack version
           declare -A redis_stack_version_mapping=(
-            ["7.4.2"]="rs-7.4.0-v2"
-            ["7.2.7"]="rs-7.2.0-v14"
+            ["7.4.4"]="rs-7.4.0-v5"
+            ["7.2.9"]="rs-7.2.0-v17"
           )
 
           if [[ -v redis_stack_version_mapping[$REDIS_VERSION] ]]; then
@@ -91,8 +91,10 @@ runs:
           fi
 
           invoke devenv --endpoints=all-stack
+
         else
           echo "Using redis CE for module tests"
+          export CLIENT_LIBS_TEST_STACK_IMAGE_TAG=$REDIS_VERSION
           echo "REDIS_MOD_URL=redis://127.0.0.1:6379" >> $GITHUB_ENV
           invoke devenv --endpoints all
         fi
diff --git a/.github/workflows/hiredis-py-integration.yaml b/.github/workflows/hiredis-py-integration.yaml
index d81b9977b1..855e9aa8f2 100644
--- a/.github/workflows/hiredis-py-integration.yaml
+++ b/.github/workflows/hiredis-py-integration.yaml
@@ -23,8 +23,8 @@ env:
   CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
   # this speeds up coverage with Python 3.12: https://github.com/nedbat/coveragepy/issues/1665
   COVERAGE_CORE: sysmon
-  CURRENT_CLIENT_LIBS_TEST_STACK_IMAGE_TAG: 'rs-7.4.0-v2'
-  CURRENT_REDIS_VERSION: '7.4.2'
+  CURRENT_CLIENT_LIBS_TEST_STACK_IMAGE_TAG: '8.0.2'
+  CURRENT_REDIS_VERSION: '8.0.2'
 
 jobs:
   redis_version:
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index e3024713e7..c91fa91d01 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -27,8 +27,8 @@ env:
   CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
   # this speeds up coverage with Python 3.12: https://github.com/nedbat/coveragepy/issues/1665
   COVERAGE_CORE: sysmon
-  CURRENT_CLIENT_LIBS_TEST_STACK_IMAGE_TAG: 'rs-7.4.0-v2'
-  CURRENT_REDIS_VERSION: '7.4.2'
+  CURRENT_CLIENT_LIBS_TEST_STACK_IMAGE_TAG: '8.0.2'
+  CURRENT_REDIS_VERSION: '8.0.2'
 
 jobs:
   dependency-audit:
@@ -74,7 +74,7 @@ jobs:
       max-parallel: 15
       fail-fast: false
       matrix:
-        redis-version: ['8.0.1-pre', '${{ needs.redis_version.outputs.CURRENT }}', '7.2.7']
+        redis-version: ['8.2-M01-pre', '${{ needs.redis_version.outputs.CURRENT }}', '7.4.4', '7.2.9']
         python-version: ['3.9', '3.13']
         parser-backend: ['plain']
         event-loop: ['asyncio']
diff --git a/docker-compose.yml b/docker-compose.yml
index bcf85df1a7..1428e6f96b 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,10 +1,10 @@
 ---
 # image tag 8.0-RC2-pre is the one matching the 8.0 GA release
 x-client-libs-stack-image: &client-libs-stack-image
-  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_STACK_IMAGE_TAG:-8.0-RC2-pre}"
+  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_STACK_IMAGE_TAG:-8.0.2}"
 
 x-client-libs-image: &client-libs-image
-  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_IMAGE_TAG:-8.0-RC2-pre}"
+  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_IMAGE_TAG:-8.0.2}"
 
 services:
 
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 8758efa771..04574cbb81 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1088,6 +1088,7 @@ def test_lastsave(self, r):
 
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("5.0.0")
+    @skip_if_server_version_gte("8.0.0")
     def test_lolwut(self, r):
         lolwut = r.lolwut().decode("utf-8")
         assert "Redis ver." in lolwut
@@ -1095,6 +1096,15 @@ def test_lolwut(self, r):
         lolwut = r.lolwut(5, 6, 7, 8).decode("utf-8")
         assert "Redis ver." in lolwut
 
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.0.0")
+    def test_lolwut_v8_and_higher(self, r):
+        lolwut = r.lolwut().decode("utf-8")
+        assert lolwut
+
+        lolwut = r.lolwut(5, 6, 7, 8).decode("utf-8")
+        assert lolwut
+
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("6.2.0")
     @skip_if_redis_enterprise()

From 513c8d0f61460ef690d3218805e9a4a2ee675af9 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Fri, 27 Jun 2025 15:58:34 +0300
Subject: [PATCH 1083/1164] Removing synchronous context manager handling from
 async RedisCluster. (#3679)

---
 redis/asyncio/cluster.py | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 5823d2f935..956262696a 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -1581,15 +1581,6 @@ async def __aexit__(self, exc_type: None, exc_value: None, traceback: None) -> N
     def __await__(self) -> Generator[Any, None, "ClusterPipeline"]:
         return self.initialize().__await__()
 
-    def __enter__(self) -> "ClusterPipeline":
-        # TODO: Remove this method before 7.0.0
-        self._execution_strategy._command_queue = []
-        return self
-
-    def __exit__(self, exc_type: None, exc_value: None, traceback: None) -> None:
-        # TODO: Remove this method before 7.0.0
-        self._execution_strategy._command_queue = []
-
     def __bool__(self) -> bool:
         "Pipeline instances should  always evaluate to True on Python 3+"
         return True

From b7dcd8067d94c8610dcd92b3490319f4dc1eefcf Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Fri, 4 Jul 2025 18:57:17 +0300
Subject: [PATCH 1084/1164] Updating the latest Redis image for pipeline
 testing (#3695)

---
 .github/workflows/integration.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index c91fa91d01..b720e1d99c 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -74,7 +74,7 @@ jobs:
       max-parallel: 15
       fail-fast: false
       matrix:
-        redis-version: ['8.2-M01-pre', '${{ needs.redis_version.outputs.CURRENT }}', '7.4.4', '7.2.9']
+        redis-version: ['8.2-RC1-pre', '${{ needs.redis_version.outputs.CURRENT }}', '7.4.4', '7.2.9']
         python-version: ['3.9', '3.13']
         parser-backend: ['plain']
         event-loop: ['asyncio']

From fbce374b1ea949435e27e24c0a054fe444dd680e Mon Sep 17 00:00:00 2001
From: ofekshenawa <104765379+ofekshenawa@users.noreply.github.com>
Date: Mon, 7 Jul 2025 08:33:51 +0300
Subject: [PATCH 1085/1164] Add support for new BITOP operations: DIFF, DIFF1,
 ANDOR, ONE (#3690)

* Add support for new BITOP operations: DIFF, DIFF1, ANDOR, ONE

* fix linting issues

* change version checking from 8.2.0 to 8.1.224
---
 tests/test_asyncio/test_commands.py | 97 +++++++++++++++++++++++++++++
 tests/test_commands.py              | 97 +++++++++++++++++++++++++++++
 2 files changed, 194 insertions(+)

diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index bfb6855a0f..bf65210f31 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -879,6 +879,103 @@ async def test_bitop_string_operands(self, r: redis.Redis):
         assert int(binascii.hexlify(await r.get("res2")), 16) == 0x0102FFFF
         assert int(binascii.hexlify(await r.get("res3")), 16) == 0x000000FF
 
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.1.224")
+    async def test_bitop_diff(self, r: redis.Redis):
+        await r.set("a", b"\xf0")
+        await r.set("b", b"\xc0")
+        await r.set("c", b"\x80")
+
+        result = await r.bitop("DIFF", "result", "a", "b", "c")
+        assert result == 1
+        assert await r.get("result") == b"\x30"
+
+        await r.bitop("DIFF", "result2", "a", "nonexistent")
+        assert await r.get("result2") == b"\xf0"
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.1.224")
+    async def test_bitop_diff1(self, r: redis.Redis):
+        await r.set("a", b"\xf0")
+        await r.set("b", b"\xc0")
+        await r.set("c", b"\x80")
+
+        result = await r.bitop("DIFF1", "result", "a", "b", "c")
+        assert result == 1
+        assert await r.get("result") == b"\x00"
+
+        await r.set("d", b"\x0f")
+        await r.set("e", b"\x03")
+        await r.bitop("DIFF1", "result2", "d", "e")
+        assert await r.get("result2") == b"\x00"
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.1.224")
+    async def test_bitop_andor(self, r: redis.Redis):
+        await r.set("a", b"\xf0")
+        await r.set("b", b"\xc0")
+        await r.set("c", b"\x80")
+
+        result = await r.bitop("ANDOR", "result", "a", "b", "c")
+        assert result == 1
+        assert await r.get("result") == b"\xc0"
+
+        await r.set("x", b"\xf0")
+        await r.set("y", b"\x0f")
+        await r.bitop("ANDOR", "result2", "x", "y")
+        assert await r.get("result2") == b"\x00"
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.1.224")
+    async def test_bitop_one(self, r: redis.Redis):
+        await r.set("a", b"\xf0")
+        await r.set("b", b"\xc0")
+        await r.set("c", b"\x80")
+
+        result = await r.bitop("ONE", "result", "a", "b", "c")
+        assert result == 1
+        assert await r.get("result") == b"\x30"
+
+        await r.set("x", b"\xf0")
+        await r.set("y", b"\x0f")
+        await r.bitop("ONE", "result2", "x", "y")
+        assert await r.get("result2") == b"\xff"
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.1.224")
+    async def test_bitop_new_operations_with_empty_keys(self, r: redis.Redis):
+        await r.set("a", b"\xff")
+
+        await r.bitop("DIFF", "empty_result", "nonexistent", "a")
+        assert await r.get("empty_result") == b"\x00"
+
+        await r.bitop("DIFF1", "empty_result2", "a", "nonexistent")
+        assert await r.get("empty_result2") == b"\x00"
+
+        await r.bitop("ANDOR", "empty_result3", "a", "nonexistent")
+        assert await r.get("empty_result3") == b"\x00"
+
+        await r.bitop("ONE", "empty_result4", "nonexistent")
+        assert await r.get("empty_result4") is None
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.1.224")
+    async def test_bitop_new_operations_return_values(self, r: redis.Redis):
+        await r.set("a", b"\xff\x00\xff")
+        await r.set("b", b"\x00\xff")
+
+        result1 = await r.bitop("DIFF", "result1", "a", "b")
+        assert result1 == 3
+
+        result2 = await r.bitop("DIFF1", "result2", "a", "b")
+        assert result2 == 3
+
+        result3 = await r.bitop("ANDOR", "result3", "a", "b")
+        assert result3 == 3
+
+        result4 = await r.bitop("ONE", "result4", "a", "b")
+        assert result4 == 3
+
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.8.7")
     async def test_bitpos(self, r: redis.Redis):
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 04574cbb81..9ac8ee4933 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1313,6 +1313,103 @@ def test_bitop_string_operands(self, r):
         assert int(binascii.hexlify(r["res2"]), 16) == 0x0102FFFF
         assert int(binascii.hexlify(r["res3"]), 16) == 0x000000FF
 
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.1.224")
+    def test_bitop_diff(self, r):
+        r["a"] = b"\xf0"
+        r["b"] = b"\xc0"
+        r["c"] = b"\x80"
+
+        result = r.bitop("DIFF", "result", "a", "b", "c")
+        assert result == 1
+        assert r["result"] == b"\x30"
+
+        r.bitop("DIFF", "result2", "a", "nonexistent")
+        assert r["result2"] == b"\xf0"
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.1.224")
+    def test_bitop_diff1(self, r):
+        r["a"] = b"\xf0"
+        r["b"] = b"\xc0"
+        r["c"] = b"\x80"
+
+        result = r.bitop("DIFF1", "result", "a", "b", "c")
+        assert result == 1
+        assert r["result"] == b"\x00"
+
+        r["d"] = b"\x0f"
+        r["e"] = b"\x03"
+        r.bitop("DIFF1", "result2", "d", "e")
+        assert r["result2"] == b"\x00"
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.1.224")
+    def test_bitop_andor(self, r):
+        r["a"] = b"\xf0"
+        r["b"] = b"\xc0"
+        r["c"] = b"\x80"
+
+        result = r.bitop("ANDOR", "result", "a", "b", "c")
+        assert result == 1
+        assert r["result"] == b"\xc0"
+
+        r["x"] = b"\xf0"
+        r["y"] = b"\x0f"
+        r.bitop("ANDOR", "result2", "x", "y")
+        assert r["result2"] == b"\x00"
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.1.224")
+    def test_bitop_one(self, r):
+        r["a"] = b"\xf0"
+        r["b"] = b"\xc0"
+        r["c"] = b"\x80"
+
+        result = r.bitop("ONE", "result", "a", "b", "c")
+        assert result == 1
+        assert r["result"] == b"\x30"
+
+        r["x"] = b"\xf0"
+        r["y"] = b"\x0f"
+        r.bitop("ONE", "result2", "x", "y")
+        assert r["result2"] == b"\xff"
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.1.224")
+    def test_bitop_new_operations_with_empty_keys(self, r):
+        r["a"] = b"\xff"
+
+        r.bitop("DIFF", "empty_result", "nonexistent", "a")
+        assert r.get("empty_result") == b"\x00"
+
+        r.bitop("DIFF1", "empty_result2", "a", "nonexistent")
+        assert r.get("empty_result2") == b"\x00"
+
+        r.bitop("ANDOR", "empty_result3", "a", "nonexistent")
+        assert r.get("empty_result3") == b"\x00"
+
+        r.bitop("ONE", "empty_result4", "nonexistent")
+        assert r.get("empty_result4") is None
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.1.224")
+    def test_bitop_new_operations_return_values(self, r):
+        r["a"] = b"\xff\x00\xff"
+        r["b"] = b"\x00\xff"
+
+        result1 = r.bitop("DIFF", "result1", "a", "b")
+        assert result1 == 3
+
+        result2 = r.bitop("DIFF1", "result2", "a", "b")
+        assert result2 == 3
+
+        result3 = r.bitop("ANDOR", "result3", "a", "b")
+        assert result3 == 3
+
+        result4 = r.bitop("ONE", "result4", "a", "b")
+        assert result4 == 3
+
     @pytest.mark.onlynoncluster
     @skip_if_server_version_lt("2.8.7")
     def test_bitpos(self, r):

From a00d182445961c883ce1892be8f5ebd2272dae86 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 7 Jul 2025 10:35:47 +0300
Subject: [PATCH 1086/1164] Bump rojopolis/spellcheck-github-actions from
 0.49.0 to 0.51.0 (#3689)

Bumps [rojopolis/spellcheck-github-actions](https://github.com/rojopolis/spellcheck-github-actions) from 0.49.0 to 0.51.0.
- [Release notes](https://github.com/rojopolis/spellcheck-github-actions/releases)
- [Changelog](https://github.com/rojopolis/spellcheck-github-actions/blob/master/CHANGELOG.md)
- [Commits](https://github.com/rojopolis/spellcheck-github-actions/compare/0.49.0...0.51.0)

---
updated-dependencies:
- dependency-name: rojopolis/spellcheck-github-actions
  dependency-version: 0.51.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: petyaslavova <petya.slavova@redis.com>
---
 .github/workflows/spellcheck.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/spellcheck.yml b/.github/workflows/spellcheck.yml
index 6ab2c46701..81e73cd4ba 100644
--- a/.github/workflows/spellcheck.yml
+++ b/.github/workflows/spellcheck.yml
@@ -8,7 +8,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
       - name: Check Spelling
-        uses: rojopolis/spellcheck-github-actions@0.49.0
+        uses: rojopolis/spellcheck-github-actions@0.51.0
         with:
           config_path: .github/spellcheck-settings.yml
           task_name: Markdown

From 50773eccaf36b85c78dfeeed8440fc295169eb1f Mon Sep 17 00:00:00 2001
From: andy-stark-redis <164213578+andy-stark-redis@users.noreply.github.com>
Date: Mon, 7 Jul 2025 12:09:14 +0100
Subject: [PATCH 1087/1164] DOC-5225 testable probabilistic dt examples (#3691)

---
 doctests/home_prob_dts.py | 232 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 232 insertions(+)
 create mode 100644 doctests/home_prob_dts.py

diff --git a/doctests/home_prob_dts.py b/doctests/home_prob_dts.py
new file mode 100644
index 0000000000..39d516242f
--- /dev/null
+++ b/doctests/home_prob_dts.py
@@ -0,0 +1,232 @@
+# EXAMPLE: home_prob_dts
+"""
+Probabilistic data type examples:
+ https://redis.io/docs/latest/develop/connect/clients/python/redis-py/prob
+"""
+
+# HIDE_START
+import redis
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+# REMOVE_START
+r.delete(
+    "recorded_users", "other_users",
+    "group:1", "group:2", "both_groups",
+    "items_sold",
+    "male_heights", "female_heights", "all_heights",
+    "top_3_songs"
+)
+# REMOVE_END
+
+# STEP_START bloom
+res1 = r.bf().madd("recorded_users", "andy", "cameron", "david", "michelle")
+print(res1)  # >>> [1, 1, 1, 1]
+
+res2 = r.bf().exists("recorded_users", "cameron")
+print(res2)  # >>> 1
+
+res3 = r.bf().exists("recorded_users", "kaitlyn")
+print(res3)  # >>> 0
+# STEP_END
+# REMOVE_START
+assert res1 == [1, 1, 1, 1]
+assert res2 == 1
+assert res3 == 0
+# REMOVE_END
+
+# STEP_START cuckoo
+res4 = r.cf().add("other_users", "paolo")
+print(res4)  # >>> 1
+
+res5 = r.cf().add("other_users", "kaitlyn")
+print(res5)  # >>> 1
+
+res6 = r.cf().add("other_users", "rachel")
+print(res6)  # >>> 1
+
+res7 = r.cf().mexists("other_users", "paolo", "rachel", "andy")
+print(res7)  # >>> [1, 1, 0]
+
+res8 = r.cf().delete("other_users", "paolo")
+print(res8)  # >>> 1
+
+res9 = r.cf().exists("other_users", "paolo")
+print(res9)  # >>> 0
+# STEP_END
+# REMOVE_START
+assert res4 == 1
+assert res5 == 1
+assert res6 == 1
+assert res7 == [1, 1, 0]
+assert res8 == 1
+assert res9 == 0
+# REMOVE_END
+
+# STEP_START hyperloglog
+res10 = r.pfadd("group:1", "andy", "cameron", "david")
+print(res10)  # >>> 1
+
+res11 = r.pfcount("group:1")
+print(res11)  # >>> 3
+
+res12 = r.pfadd("group:2", "kaitlyn", "michelle", "paolo", "rachel")
+print(res12)  # >>> 1
+
+res13 = r.pfcount("group:2")
+print(res13)  # >>> 4
+
+res14 = r.pfmerge("both_groups", "group:1", "group:2")
+print(res14)  # >>> True
+
+res15 = r.pfcount("both_groups")
+print(res15)  # >>> 7
+# STEP_END
+# REMOVE_START
+assert res10 == 1
+assert res11 == 3
+assert res12 == 1
+assert res13 == 4
+assert res14
+assert res15 == 7
+# REMOVE_END
+
+# STEP_START cms
+# Specify that you want to keep the counts within 0.01
+# (1%) of the true value with a 0.005 (0.5%) chance
+# of going outside this limit.
+res16 = r.cms().initbyprob("items_sold", 0.01, 0.005)
+print(res16)  # >>> True
+
+# The parameters for `incrby()` are two lists. The count
+# for each item in the first list is incremented by the
+# value at the same index in the second list.
+res17 = r.cms().incrby(
+    "items_sold",
+    ["bread", "tea", "coffee", "beer"],  # Items sold
+    [300, 200, 200, 100]
+)
+print(res17)  # >>> [300, 200, 200, 100]
+
+res18 = r.cms().incrby(
+    "items_sold",
+    ["bread", "coffee"],
+    [100, 150]
+)
+print(res18)  # >>> [400, 350]
+
+res19 = r.cms().query("items_sold", "bread", "tea", "coffee", "beer")
+print(res19)  # >>> [400, 200, 350, 100]
+# STEP_END
+# REMOVE_START
+assert res16
+assert res17 == [300, 200, 200, 100]
+assert res18 == [400, 350]
+assert res19 == [400, 200, 350, 100]
+# REMOVE_END
+
+# STEP_START tdigest
+res20 = r.tdigest().create("male_heights")
+print(res20)  # >>> True
+
+res21 = r.tdigest().add(
+    "male_heights",
+    [175.5, 181, 160.8, 152, 177, 196, 164]
+)
+print(res21)  # >>> OK
+
+res22 = r.tdigest().min("male_heights")
+print(res22)  # >>> 152.0
+
+res23 = r.tdigest().max("male_heights")
+print(res23)  # >>> 196.0
+
+res24 = r.tdigest().quantile("male_heights", 0.75)
+print(res24)  # >>> 181
+
+# Note that the CDF value for 181 is not exactly
+# 0.75. Both values are estimates.
+res25 = r.tdigest().cdf("male_heights", 181)
+print(res25)  # >>> [0.7857142857142857]
+
+res26 = r.tdigest().create("female_heights")
+print(res26)  # >>> True
+
+res27 = r.tdigest().add(
+    "female_heights",
+    [155.5, 161, 168.5, 170, 157.5, 163, 171]
+)
+print(res27)  # >>> OK
+
+res28 = r.tdigest().quantile("female_heights", 0.75)
+print(res28)  # >>> [170]
+
+res29 = r.tdigest().merge(
+    "all_heights", 2, "male_heights", "female_heights"
+)
+print(res29)  # >>> OK
+
+res30 = r.tdigest().quantile("all_heights", 0.75)
+print(res30)  # >>> [175.5]
+# STEP_END
+# REMOVE_START
+assert res20
+assert res21 == "OK"
+assert res22 == 152.0
+assert res23 == 196.0
+assert res24 == [181]
+assert res25 == [0.7857142857142857]
+assert res26
+assert res27 == "OK"
+assert res28 == [170]
+assert res29 == "OK"
+assert res30 == [175.5]
+# REMOVE_END
+
+# STEP_START topk
+# The `reserve()` method creates the Top-K object with
+# the given key. The parameters are the number of items
+# in the ranking and values for `width`, `depth`, and
+# `decay`, described in the Top-K reference page.
+res31 = r.topk().reserve("top_3_songs", 3, 7, 8, 0.9)
+print(res31)  # >>> True
+
+# The parameters for `incrby()` are two lists. The count
+# for each item in the first list is incremented by the
+# value at the same index in the second list.
+res32 = r.topk().incrby(
+    "top_3_songs",
+    [
+        "Starfish Trooper",
+        "Only one more time",
+        "Rock me, Handel",
+        "How will anyone know?",
+        "Average lover",
+        "Road to everywhere"
+    ],
+    [
+        3000,
+        1850,
+        1325,
+        3890,
+        4098,
+        770
+    ]
+)
+print(res32)
+# >>> [None, None, None, 'Rock me, Handel', 'Only one more time', None]
+
+res33 = r.topk().list("top_3_songs")
+print(res33)
+# >>> ['Average lover', 'How will anyone know?', 'Starfish Trooper']
+
+res34 = r.topk().query(
+    "top_3_songs", "Starfish Trooper", "Road to everywhere"
+)
+print(res34)  # >>> [1, 0]
+# STEP_END
+# REMOVE_START
+assert res31
+assert res32 == [None, None, None, 'Rock me, Handel', 'Only one more time', None]
+assert res33 == ['Average lover', 'How will anyone know?', 'Starfish Trooper']
+assert res34 == [1, 0]
+# REMOVE_END

From 07b0e2c84ad9aa6a31b4c5baa58ff3f6f5c605ab Mon Sep 17 00:00:00 2001
From: AmirHossein <2002gholami@gmail.com>
Date: Tue, 8 Jul 2025 15:18:55 +0330
Subject: [PATCH 1088/1164] Update README.md (#3699)

Co-authored-by: petyaslavova <petya.slavova@redis.com>
---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 1c4dfc0f11..97afa2f9bc 100644
--- a/README.md
+++ b/README.md
@@ -41,7 +41,7 @@ Start a redis via docker (for Redis versions < 8.0):
 
 ``` bash
 docker run -p 6379:6379 -it redis/redis-stack:latest
-
+```
 To install redis-py, simply:
 
 ``` bash
@@ -209,4 +209,4 @@ Special thanks to:
     system.
 -   Paul Hubbard for initial packaging support.
 
-[![Redis](./docs/_static/logo-redis.svg)](https://redis.io)
\ No newline at end of file
+[![Redis](./docs/_static/logo-redis.svg)](https://redis.io)

From 310813aae8d1e27aa492c5b6b292276b0f331593 Mon Sep 17 00:00:00 2001
From: Mitch Harding <mitchell.harding@hpe.com>
Date: Wed, 9 Jul 2025 08:32:25 -0400
Subject: [PATCH 1089/1164] Annotate deprecated_args decorator to preserve
 wrapped function type signature (#3701)

---
 redis/utils.py | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/redis/utils.py b/redis/utils.py
index 715913e914..79c23c8bda 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -1,9 +1,10 @@
 import datetime
 import logging
 import textwrap
+from collections.abc import Callable
 from contextlib import contextmanager
 from functools import wraps
-from typing import Any, Dict, List, Mapping, Optional, Union
+from typing import Any, Dict, List, Mapping, Optional, TypeVar, Union
 
 from redis.exceptions import DataError
 from redis.typing import AbsExpiryT, EncodableT, ExpiryT
@@ -150,18 +151,21 @@ def warn_deprecated_arg_usage(
     warnings.warn(msg, category=DeprecationWarning, stacklevel=stacklevel)
 
 
+C = TypeVar("C", bound=Callable)
+
+
 def deprecated_args(
     args_to_warn: list = ["*"],
     allowed_args: list = [],
     reason: str = "",
     version: str = "",
-):
+) -> Callable[[C], C]:
     """
     Decorator to mark specified args of a function as deprecated.
     If '*' is in args_to_warn, all arguments will be marked as deprecated.
     """
 
-    def decorator(func):
+    def decorator(func: C) -> C:
         @wraps(func)
         def wrapper(*args, **kwargs):
             # Get function argument names

From ce56d1cb0d214c86c3bd3e8348510889aa6e6f0c Mon Sep 17 00:00:00 2001
From: hulk <hulk.website@gmail.com>
Date: Fri, 11 Jul 2025 19:41:47 +0800
Subject: [PATCH 1090/1164] Convert the value to int type only if it exists in
 CLIENT INFO (#3688)

Currently, client info will try to convert the set of keys to the int type
without checking if it exists or not. For example, both `argv-mem` and `tot-mem`
are introduced in 6.2, and force converting an non-existent value might
cause an exception in older or newer versions. To keep the compatibility with the older/newer
Redis server, we could just convert it only if the key exists.
---
 redis/_parsers/helpers.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/redis/_parsers/helpers.py b/redis/_parsers/helpers.py
index 5468addf62..154dc66dfb 100644
--- a/redis/_parsers/helpers.py
+++ b/redis/_parsers/helpers.py
@@ -676,7 +676,8 @@ def parse_client_info(value):
         "omem",
         "tot-mem",
     }:
-        client_info[int_key] = int(client_info[int_key])
+        if int_key in client_info:
+            client_info[int_key] = int(client_info[int_key])
     return client_info
 
 

From a757bad78bf18869cdceb370ca8d05d3a7c96942 Mon Sep 17 00:00:00 2001
From: ofekshenawa <104765379+ofekshenawa@users.noreply.github.com>
Date: Mon, 14 Jul 2025 10:31:47 +0300
Subject: [PATCH 1091/1164] Support new VAMANA vector type (#3702)

* Support new  vector type

* Skip VAMANA tests is redis versin is not 8.2

* Add async tests

* Fix resp 3 errors
---
 redis/commands/search/field.py    |   8 +-
 tests/test_asyncio/test_search.py | 178 +++++++
 tests/test_search.py              | 840 +++++++++++++++++++++++++++++-
 3 files changed, 1020 insertions(+), 6 deletions(-)

diff --git a/redis/commands/search/field.py b/redis/commands/search/field.py
index 8af7777f19..45cd403e49 100644
--- a/redis/commands/search/field.py
+++ b/redis/commands/search/field.py
@@ -181,7 +181,7 @@ def __init__(self, name: str, algorithm: str, attributes: dict, **kwargs):
 
         ``name`` is the name of the field.
 
-        ``algorithm`` can be "FLAT" or "HNSW".
+        ``algorithm`` can be "FLAT", "HNSW", or "SVS-VAMANA".
 
         ``attributes`` each algorithm can have specific attributes. Some of them
         are mandatory and some of them are optional. See
@@ -194,10 +194,10 @@ def __init__(self, name: str, algorithm: str, attributes: dict, **kwargs):
         if sort or noindex:
             raise DataError("Cannot set 'sortable' or 'no_index' in Vector fields.")
 
-        if algorithm.upper() not in ["FLAT", "HNSW"]:
+        if algorithm.upper() not in ["FLAT", "HNSW", "SVS-VAMANA"]:
             raise DataError(
-                "Realtime vector indexing supporting 2 Indexing Methods:"
-                "'FLAT' and 'HNSW'."
+                "Realtime vector indexing supporting 3 Indexing Methods:"
+                "'FLAT', 'HNSW', and 'SVS-VAMANA'."
             )
 
         attr_li = []
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 932ece59b8..0004f9ba75 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -1815,3 +1815,181 @@ async def test_binary_and_text_fields(decoded_r: redis.Redis):
     assert docs[0]["first_name"] == mixed_data["first_name"], (
         "The text field is not decoded correctly"
     )
+
+
+# SVS-VAMANA Async Tests
+@pytest.mark.redismod
+@skip_if_server_version_lt("8.1.224")
+async def test_async_svs_vamana_basic_functionality(decoded_r: redis.Redis):
+    await decoded_r.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {"TYPE": "FLOAT32", "DIM": 4, "DISTANCE_METRIC": "L2"},
+            ),
+        )
+    )
+
+    vectors = [
+        [1.0, 2.0, 3.0, 4.0],
+        [2.0, 3.0, 4.0, 5.0],
+        [3.0, 4.0, 5.0, 6.0],
+        [10.0, 11.0, 12.0, 13.0],
+    ]
+
+    for i, vec in enumerate(vectors):
+        await decoded_r.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+    query = "*=>[KNN 3 @v $vec]"
+    q = Query(query).return_field("__v_score").sort_by("__v_score", True)
+    res = await decoded_r.ft().search(
+        q, query_params={"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+    )
+
+    if is_resp2_connection(decoded_r):
+        assert res.total == 3
+        assert "doc0" == res.docs[0].id
+    else:
+        assert res["total_results"] == 3
+        assert "doc0" == res["results"][0]["id"]
+
+
+@pytest.mark.redismod
+@skip_if_server_version_lt("8.1.224")
+async def test_async_svs_vamana_distance_metrics(decoded_r: redis.Redis):
+    # Test COSINE distance
+    await decoded_r.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {"TYPE": "FLOAT32", "DIM": 3, "DISTANCE_METRIC": "COSINE"},
+            ),
+        )
+    )
+
+    vectors = [[1.0, 0.0, 0.0], [0.707, 0.707, 0.0], [0.0, 1.0, 0.0], [-1.0, 0.0, 0.0]]
+
+    for i, vec in enumerate(vectors):
+        await decoded_r.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+    query = Query("*=>[KNN 2 @v $vec as score]").sort_by("score").no_content()
+    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+    res = await decoded_r.ft().search(query, query_params=query_params)
+    if is_resp2_connection(decoded_r):
+        assert res.total == 2
+        assert "doc0" == res.docs[0].id
+    else:
+        assert res["total_results"] == 2
+        assert "doc0" == res["results"][0]["id"]
+
+
+@pytest.mark.redismod
+@skip_if_server_version_lt("8.1.224")
+async def test_async_svs_vamana_vector_types(decoded_r: redis.Redis):
+    # Test FLOAT16
+    await decoded_r.ft("idx16").create_index(
+        (
+            VectorField(
+                "v16",
+                "SVS-VAMANA",
+                {"TYPE": "FLOAT16", "DIM": 4, "DISTANCE_METRIC": "L2"},
+            ),
+        )
+    )
+
+    vectors = [[1.5, 2.5, 3.5, 4.5], [2.5, 3.5, 4.5, 5.5], [3.5, 4.5, 5.5, 6.5]]
+
+    for i, vec in enumerate(vectors):
+        await decoded_r.hset(
+            f"doc16_{i}", "v16", np.array(vec, dtype=np.float16).tobytes()
+        )
+
+    query = Query("*=>[KNN 2 @v16 $vec as score]").no_content()
+    query_params = {"vec": np.array(vectors[0], dtype=np.float16).tobytes()}
+
+    res = await decoded_r.ft("idx16").search(query, query_params=query_params)
+    if is_resp2_connection(decoded_r):
+        assert res.total == 2
+        assert "doc16_0" == res.docs[0].id
+    else:
+        assert res["total_results"] == 2
+        assert "doc16_0" == res["results"][0]["id"]
+
+
+@pytest.mark.redismod
+@skip_if_server_version_lt("8.1.224")
+async def test_async_svs_vamana_compression(decoded_r: redis.Redis):
+    await decoded_r.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {
+                    "TYPE": "FLOAT32",
+                    "DIM": 8,
+                    "DISTANCE_METRIC": "L2",
+                    "COMPRESSION": "LVQ8",
+                    "TRAINING_THRESHOLD": 1024,
+                },
+            ),
+        )
+    )
+
+    vectors = []
+    for i in range(20):
+        vec = [float(i + j) for j in range(8)]
+        vectors.append(vec)
+        await decoded_r.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+    query = Query("*=>[KNN 5 @v $vec as score]").no_content()
+    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+    res = await decoded_r.ft().search(query, query_params=query_params)
+    if is_resp2_connection(decoded_r):
+        assert res.total == 5
+        assert "doc0" == res.docs[0].id
+    else:
+        assert res["total_results"] == 5
+        assert "doc0" == res["results"][0]["id"]
+
+
+@pytest.mark.redismod
+@skip_if_server_version_lt("8.1.224")
+async def test_async_svs_vamana_build_parameters(decoded_r: redis.Redis):
+    await decoded_r.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {
+                    "TYPE": "FLOAT32",
+                    "DIM": 6,
+                    "DISTANCE_METRIC": "COSINE",
+                    "CONSTRUCTION_WINDOW_SIZE": 300,
+                    "GRAPH_MAX_DEGREE": 64,
+                    "SEARCH_WINDOW_SIZE": 20,
+                    "EPSILON": 0.05,
+                },
+            ),
+        )
+    )
+
+    vectors = []
+    for i in range(15):
+        vec = [float(i + j) for j in range(6)]
+        vectors.append(vec)
+        await decoded_r.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+    query = Query("*=>[KNN 3 @v $vec as score]").no_content()
+    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+    res = await decoded_r.ft().search(query, query_params=query_params)
+    if is_resp2_connection(decoded_r):
+        assert res.total == 3
+        assert "doc0" == res.docs[0].id
+    else:
+        assert res["total_results"] == 3
+        assert "doc0" == res["results"][0]["id"]
diff --git a/tests/test_search.py b/tests/test_search.py
index 4af55e8a17..3460b56ca1 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -2863,6 +2863,100 @@ def test_vector_search_with_default_dialect(client):
         assert res["total_results"] == 2
 
 
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_l2_distance_metric(client):
+    client.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {"TYPE": "FLOAT32", "DIM": 3, "DISTANCE_METRIC": "L2"},
+            ),
+        )
+    )
+
+    # L2 distance test vectors
+    vectors = [[1.0, 0.0, 0.0], [2.0, 0.0, 0.0], [0.0, 1.0, 0.0], [5.0, 0.0, 0.0]]
+
+    for i, vec in enumerate(vectors):
+        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+    query = Query("*=>[KNN 3 @v $vec as score]").sort_by("score").no_content()
+    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+    res = client.ft().search(query, query_params=query_params)
+    if is_resp2_connection(client):
+        assert res.total == 3
+        assert "doc0" == res.docs[0].id
+    else:
+        assert res["total_results"] == 3
+        assert "doc0" == res["results"][0]["id"]
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_cosine_distance_metric(client):
+    client.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {"TYPE": "FLOAT32", "DIM": 3, "DISTANCE_METRIC": "COSINE"},
+            ),
+        )
+    )
+
+    vectors = [[1.0, 0.0, 0.0], [0.707, 0.707, 0.0], [0.0, 1.0, 0.0], [-1.0, 0.0, 0.0]]
+
+    for i, vec in enumerate(vectors):
+        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+    query = Query("*=>[KNN 3 @v $vec as score]").sort_by("score").no_content()
+    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+    res = client.ft().search(query, query_params=query_params)
+    if is_resp2_connection(client):
+        assert res.total == 3
+        assert "doc0" == res.docs[0].id
+    else:
+        assert res["total_results"] == 3
+        assert "doc0" == res["results"][0]["id"]
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_ip_distance_metric(client):
+    client.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {"TYPE": "FLOAT32", "DIM": 3, "DISTANCE_METRIC": "IP"},
+            ),
+        )
+    )
+
+    vectors = [[1.0, 2.0, 3.0], [2.0, 1.0, 1.0], [3.0, 3.0, 3.0], [0.1, 0.1, 0.1]]
+
+    for i, vec in enumerate(vectors):
+        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+    query = Query("*=>[KNN 3 @v $vec as score]").sort_by("score").no_content()
+    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+    res = client.ft().search(query, query_params=query_params)
+    if is_resp2_connection(client):
+        assert res.total == 3
+        assert "doc2" == res.docs[0].id
+    else:
+        assert res["total_results"] == 3
+        assert "doc2" == res["results"][0]["id"]
+
+
 @pytest.mark.redismod
 @skip_if_server_version_lt("7.9.0")
 def test_vector_search_with_int8_type(client):
@@ -2878,7 +2972,7 @@ def test_vector_search_with_int8_type(client):
     client.hset("b", "v", np.array(b, dtype=np.int8).tobytes())
     client.hset("c", "v", np.array(c, dtype=np.int8).tobytes())
 
-    query = Query("*=>[KNN 2 @v $vec as score]")
+    query = Query("*=>[KNN 2 @v $vec as score]").no_content()
     query_params = {"vec": np.array(a, dtype=np.int8).tobytes()}
 
     assert 2 in query.get_args()
@@ -2909,7 +3003,7 @@ def test_vector_search_with_uint8_type(client):
     client.hset("b", "v", np.array(b, dtype=np.uint8).tobytes())
     client.hset("c", "v", np.array(c, dtype=np.uint8).tobytes())
 
-    query = Query("*=>[KNN 2 @v $vec as score]")
+    query = Query("*=>[KNN 2 @v $vec as score]").no_content()
     query_params = {"vec": np.array(a, dtype=np.uint8).tobytes()}
 
     assert 2 in query.get_args()
@@ -2966,3 +3060,745 @@ def _assert_search_result(client, result, expected_doc_ids):
         assert set([doc.id for doc in result.docs]) == set(expected_doc_ids)
     else:
         assert set([doc["id"] for doc in result["results"]]) == set(expected_doc_ids)
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_basic_functionality(client):
+    client.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {"TYPE": "FLOAT32", "DIM": 4, "DISTANCE_METRIC": "L2"},
+            ),
+        )
+    )
+
+    vectors = [
+        [1.0, 2.0, 3.0, 4.0],
+        [2.0, 3.0, 4.0, 5.0],
+        [3.0, 4.0, 5.0, 6.0],
+        [10.0, 11.0, 12.0, 13.0],
+    ]
+
+    for i, vec in enumerate(vectors):
+        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+    query = "*=>[KNN 3 @v $vec]"
+    q = Query(query).return_field("__v_score").sort_by("__v_score", True)
+    res = client.ft().search(
+        q, query_params={"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+    )
+
+    if is_resp2_connection(client):
+        assert res.total == 3
+        assert "doc0" == res.docs[0].id  # Should be closest to itself
+        assert "0" == res.docs[0].__getattribute__("__v_score")
+    else:
+        assert res["total_results"] == 3
+        assert "doc0" == res["results"][0]["id"]
+        assert "0" == res["results"][0]["extra_attributes"]["__v_score"]
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_float16_type(client):
+    client.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {"TYPE": "FLOAT16", "DIM": 4, "DISTANCE_METRIC": "L2"},
+            ),
+        )
+    )
+
+    vectors = [[1.5, 2.5, 3.5, 4.5], [2.5, 3.5, 4.5, 5.5], [3.5, 4.5, 5.5, 6.5]]
+
+    for i, vec in enumerate(vectors):
+        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float16).tobytes())
+
+    query = Query("*=>[KNN 2 @v $vec as score]").no_content()
+    query_params = {"vec": np.array(vectors[0], dtype=np.float16).tobytes()}
+
+    res = client.ft().search(query, query_params=query_params)
+    if is_resp2_connection(client):
+        assert res.total == 2
+        assert "doc0" == res.docs[0].id
+    else:
+        assert res["total_results"] == 2
+        assert "doc0" == res["results"][0]["id"]
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_float32_type(client):
+    client.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {"TYPE": "FLOAT32", "DIM": 4, "DISTANCE_METRIC": "L2"},
+            ),
+        )
+    )
+
+    vectors = [[1.0, 2.0, 3.0, 4.0], [2.0, 3.0, 4.0, 5.0], [3.0, 4.0, 5.0, 6.0]]
+
+    for i, vec in enumerate(vectors):
+        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+    query = Query("*=>[KNN 2 @v $vec as score]").no_content()
+    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+    res = client.ft().search(query, query_params=query_params)
+    if is_resp2_connection(client):
+        assert res.total == 2
+        assert "doc0" == res.docs[0].id
+    else:
+        assert res["total_results"] == 2
+        assert "doc0" == res["results"][0]["id"]
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_vector_search_with_default_dialect(client):
+    client.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {"TYPE": "FLOAT32", "DIM": 2, "DISTANCE_METRIC": "L2"},
+            ),
+        )
+    )
+
+    client.hset("a", "v", "aaaaaaaa")
+    client.hset("b", "v", "aaaabaaa")
+    client.hset("c", "v", "aaaaabaa")
+
+    query = "*=>[KNN 2 @v $vec]"
+    q = Query(query).return_field("__v_score").sort_by("__v_score", True)
+    res = client.ft().search(q, query_params={"vec": "aaaaaaaa"})
+
+    if is_resp2_connection(client):
+        assert res.total == 2
+    else:
+        assert res["total_results"] == 2
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_vector_field_basic():
+    field = VectorField(
+        "v", "SVS-VAMANA", {"TYPE": "FLOAT32", "DIM": 128, "DISTANCE_METRIC": "COSINE"}
+    )
+
+    # Check that the field was created successfully
+    assert field.name == "v"
+    assert field.args[0] == "VECTOR"
+    assert field.args[1] == "SVS-VAMANA"
+    assert field.args[2] == 6
+    assert "TYPE" in field.args
+    assert "FLOAT32" in field.args
+    assert "DIM" in field.args
+    assert 128 in field.args
+    assert "DISTANCE_METRIC" in field.args
+    assert "COSINE" in field.args
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_lvq8_compression(client):
+    client.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {
+                    "TYPE": "FLOAT32",
+                    "DIM": 8,
+                    "DISTANCE_METRIC": "L2",
+                    "COMPRESSION": "LVQ8",
+                    "TRAINING_THRESHOLD": 1024,
+                },
+            ),
+        )
+    )
+
+    vectors = []
+    for i in range(20):
+        vec = [float(i + j) for j in range(8)]
+        vectors.append(vec)
+        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+    query = Query("*=>[KNN 5 @v $vec as score]").no_content()
+    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+    res = client.ft().search(query, query_params=query_params)
+    if is_resp2_connection(client):
+        assert res.total == 5
+        assert "doc0" == res.docs[0].id
+    else:
+        assert res["total_results"] == 5
+        assert "doc0" == res["results"][0]["id"]
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_compression_with_both_vector_types(client):
+    # Test FLOAT16 with LVQ8
+    client.ft("idx16").create_index(
+        (
+            VectorField(
+                "v16",
+                "SVS-VAMANA",
+                {
+                    "TYPE": "FLOAT16",
+                    "DIM": 8,
+                    "DISTANCE_METRIC": "L2",
+                    "COMPRESSION": "LVQ8",
+                    "TRAINING_THRESHOLD": 1024,
+                },
+            ),
+        )
+    )
+
+    # Test FLOAT32 with LVQ8
+    client.ft("idx32").create_index(
+        (
+            VectorField(
+                "v32",
+                "SVS-VAMANA",
+                {
+                    "TYPE": "FLOAT32",
+                    "DIM": 8,
+                    "DISTANCE_METRIC": "L2",
+                    "COMPRESSION": "LVQ8",
+                    "TRAINING_THRESHOLD": 1024,
+                },
+            ),
+        )
+    )
+
+    # Add data to both indices
+    for i in range(15):
+        vec = [float(i + j) for j in range(8)]
+        client.hset(f"doc16_{i}", "v16", np.array(vec, dtype=np.float16).tobytes())
+        client.hset(f"doc32_{i}", "v32", np.array(vec, dtype=np.float32).tobytes())
+
+    # Test both indices
+    query = Query("*=>[KNN 3 @v16 $vec as score]").no_content()
+    res16 = client.ft("idx16").search(
+        query,
+        query_params={
+            "vec": np.array(
+                [1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0], dtype=np.float16
+            ).tobytes()
+        },
+    )
+
+    query = Query("*=>[KNN 3 @v32 $vec as score]").no_content()
+    res32 = client.ft("idx32").search(
+        query,
+        query_params={
+            "vec": np.array(
+                [1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0], dtype=np.float32
+            ).tobytes()
+        },
+    )
+
+    if is_resp2_connection(client):
+        assert res16.total == 3
+        assert res32.total == 3
+    else:
+        assert res16["total_results"] == 3
+        assert res32["total_results"] == 3
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_construction_window_size(client):
+    client.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {
+                    "TYPE": "FLOAT32",
+                    "DIM": 6,
+                    "DISTANCE_METRIC": "L2",
+                    "CONSTRUCTION_WINDOW_SIZE": 300,
+                },
+            ),
+        )
+    )
+
+    vectors = []
+    for i in range(20):
+        vec = [float(i + j) for j in range(6)]
+        vectors.append(vec)
+        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+    query = Query("*=>[KNN 5 @v $vec as score]").no_content()
+    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+    res = client.ft().search(query, query_params=query_params)
+    if is_resp2_connection(client):
+        assert res.total == 5
+        assert "doc0" == res.docs[0].id
+    else:
+        assert res["total_results"] == 5
+        assert "doc0" == res["results"][0]["id"]
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_graph_max_degree(client):
+    client.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {
+                    "TYPE": "FLOAT32",
+                    "DIM": 6,
+                    "DISTANCE_METRIC": "COSINE",
+                    "GRAPH_MAX_DEGREE": 64,
+                },
+            ),
+        )
+    )
+
+    vectors = []
+    for i in range(25):
+        vec = [float(i + j) for j in range(6)]
+        vectors.append(vec)
+        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+    query = Query("*=>[KNN 6 @v $vec as score]").no_content()
+    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+    res = client.ft().search(query, query_params=query_params)
+    if is_resp2_connection(client):
+        assert res.total == 6
+        assert "doc0" == res.docs[0].id
+    else:
+        assert res["total_results"] == 6
+        assert "doc0" == res["results"][0]["id"]
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_search_window_size(client):
+    client.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {
+                    "TYPE": "FLOAT32",
+                    "DIM": 6,
+                    "DISTANCE_METRIC": "L2",
+                    "SEARCH_WINDOW_SIZE": 20,
+                },
+            ),
+        )
+    )
+
+    vectors = []
+    for i in range(30):
+        vec = [float(i + j) for j in range(6)]
+        vectors.append(vec)
+        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+    query = Query("*=>[KNN 8 @v $vec as score]").no_content()
+    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+    res = client.ft().search(query, query_params=query_params)
+    if is_resp2_connection(client):
+        assert res.total == 8
+        assert "doc0" == res.docs[0].id
+    else:
+        assert res["total_results"] == 8
+        assert "doc0" == res["results"][0]["id"]
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_epsilon_parameter(client):
+    client.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {"TYPE": "FLOAT32", "DIM": 6, "DISTANCE_METRIC": "L2", "EPSILON": 0.05},
+            ),
+        )
+    )
+
+    vectors = []
+    for i in range(20):
+        vec = [float(i + j) for j in range(6)]
+        vectors.append(vec)
+        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+    query = Query("*=>[KNN 5 @v $vec as score]").no_content()
+    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+    res = client.ft().search(query, query_params=query_params)
+    if is_resp2_connection(client):
+        assert res.total == 5
+        assert "doc0" == res.docs[0].id
+    else:
+        assert res["total_results"] == 5
+        assert "doc0" == res["results"][0]["id"]
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_all_build_parameters_combined(client):
+    client.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {
+                    "TYPE": "FLOAT32",
+                    "DIM": 8,
+                    "DISTANCE_METRIC": "IP",
+                    "CONSTRUCTION_WINDOW_SIZE": 250,
+                    "GRAPH_MAX_DEGREE": 48,
+                    "SEARCH_WINDOW_SIZE": 15,
+                    "EPSILON": 0.02,
+                },
+            ),
+        )
+    )
+
+    vectors = []
+    for i in range(35):
+        vec = [float(i + j) for j in range(8)]
+        vectors.append(vec)
+        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+    query = Query("*=>[KNN 7 @v $vec as score]").no_content()
+    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+    res = client.ft().search(query, query_params=query_params)
+    if is_resp2_connection(client):
+        assert res.total == 7
+        doc_ids = [doc.id for doc in res.docs]
+        assert len(doc_ids) == 7
+    else:
+        assert res["total_results"] == 7
+        doc_ids = [doc["id"] for doc in res["results"]]
+        assert len(doc_ids) == 7
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_comprehensive_configuration(client):
+    client.flushdb()
+    client.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {
+                    "TYPE": "FLOAT16",
+                    "DIM": 32,
+                    "DISTANCE_METRIC": "COSINE",
+                    "COMPRESSION": "LVQ8",
+                    "CONSTRUCTION_WINDOW_SIZE": 400,
+                    "GRAPH_MAX_DEGREE": 96,
+                    "SEARCH_WINDOW_SIZE": 25,
+                    "EPSILON": 0.03,
+                    "TRAINING_THRESHOLD": 2048,
+                },
+            ),
+        )
+    )
+
+    vectors = []
+    for i in range(60):
+        vec = [float(i + j) for j in range(32)]
+        vectors.append(vec)
+        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float16).tobytes())
+
+    query = Query("*=>[KNN 10 @v $vec as score]").no_content()
+    query_params = {"vec": np.array(vectors[0], dtype=np.float16).tobytes()}
+
+    res = client.ft().search(query, query_params=query_params)
+    if is_resp2_connection(client):
+        assert res.total == 10
+        assert "doc0" == res.docs[0].id
+    else:
+        assert res["total_results"] == 10
+        assert "doc0" == res["results"][0]["id"]
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_hybrid_text_vector_search(client):
+    client.flushdb()
+    client.ft().create_index(
+        (
+            TextField("title"),
+            TextField("content"),
+            VectorField(
+                "embedding",
+                "SVS-VAMANA",
+                {
+                    "TYPE": "FLOAT32",
+                    "DIM": 6,
+                    "DISTANCE_METRIC": "COSINE",
+                    "SEARCH_WINDOW_SIZE": 20,
+                },
+            ),
+        )
+    )
+
+    docs = [
+        {
+            "title": "AI Research",
+            "content": "machine learning algorithms",
+            "embedding": [1.0, 2.0, 3.0, 4.0, 5.0, 6.0],
+        },
+        {
+            "title": "Data Science",
+            "content": "statistical analysis methods",
+            "embedding": [2.0, 3.0, 4.0, 5.0, 6.0, 7.0],
+        },
+        {
+            "title": "Deep Learning",
+            "content": "neural network architectures",
+            "embedding": [3.0, 4.0, 5.0, 6.0, 7.0, 8.0],
+        },
+        {
+            "title": "Computer Vision",
+            "content": "image processing techniques",
+            "embedding": [10.0, 11.0, 12.0, 13.0, 14.0, 15.0],
+        },
+    ]
+
+    for i, doc in enumerate(docs):
+        client.hset(
+            f"doc{i}",
+            mapping={
+                "title": doc["title"],
+                "content": doc["content"],
+                "embedding": np.array(doc["embedding"], dtype=np.float32).tobytes(),
+            },
+        )
+
+    # Hybrid query - text filter + vector similarity
+    query = "(@title:AI|@content:machine)=>[KNN 2 @embedding $vec]"
+    q = (
+        Query(query)
+        .return_field("__embedding_score")
+        .sort_by("__embedding_score", True)
+    )
+    res = client.ft().search(
+        q,
+        query_params={
+            "vec": np.array([1.0, 2.0, 3.0, 4.0, 5.0, 6.0], dtype=np.float32).tobytes()
+        },
+    )
+
+    if is_resp2_connection(client):
+        assert res.total >= 1
+        doc_ids = [doc.id for doc in res.docs]
+        assert "doc0" in doc_ids
+    else:
+        assert res["total_results"] >= 1
+        doc_ids = [doc["id"] for doc in res["results"]]
+        assert "doc0" in doc_ids
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_large_dimension_vectors(client):
+    client.flushdb()
+    client.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {
+                    "TYPE": "FLOAT32",
+                    "DIM": 512,
+                    "DISTANCE_METRIC": "L2",
+                    "CONSTRUCTION_WINDOW_SIZE": 300,
+                    "GRAPH_MAX_DEGREE": 64,
+                },
+            ),
+        )
+    )
+
+    vectors = []
+    for i in range(10):
+        vec = [float(i + j) for j in range(512)]
+        vectors.append(vec)
+        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+    query = Query("*=>[KNN 5 @v $vec as score]").no_content()
+    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+    res = client.ft().search(query, query_params=query_params)
+    if is_resp2_connection(client):
+        assert res.total == 5
+        assert "doc0" == res.docs[0].id
+    else:
+        assert res["total_results"] == 5
+        assert "doc0" == res["results"][0]["id"]
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_training_threshold_behavior(client):
+    client.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {
+                    "TYPE": "FLOAT32",
+                    "DIM": 8,
+                    "DISTANCE_METRIC": "L2",
+                    "COMPRESSION": "LVQ8",
+                    "TRAINING_THRESHOLD": 1024,
+                },
+            ),
+        )
+    )
+
+    vectors = []
+    for i in range(20):
+        vec = [float(i + j) for j in range(8)]
+        vectors.append(vec)
+        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+        if i >= 5:
+            query = Query("*=>[KNN 3 @v $vec as score]").no_content()
+            query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+            res = client.ft().search(query, query_params=query_params)
+
+            if is_resp2_connection(client):
+                assert res.total >= 1
+            else:
+                assert res["total_results"] >= 1
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_different_k_values(client):
+    client.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {
+                    "TYPE": "FLOAT32",
+                    "DIM": 6,
+                    "DISTANCE_METRIC": "L2",
+                    "SEARCH_WINDOW_SIZE": 15,
+                },
+            ),
+        )
+    )
+
+    vectors = []
+    for i in range(25):
+        vec = [float(i + j) for j in range(6)]
+        vectors.append(vec)
+        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+    for k in [1, 3, 5, 10, 15]:
+        query = Query(f"*=>[KNN {k} @v $vec as score]").no_content()
+        query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+        res = client.ft().search(query, query_params=query_params)
+
+        if is_resp2_connection(client):
+            assert res.total == k
+            assert "doc0" == res.docs[0].id
+        else:
+            assert res["total_results"] == k
+            assert "doc0" == res["results"][0]["id"]
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_vector_field_error(client):
+    # sortable tag
+    with pytest.raises(Exception):
+        client.ft().create_index((VectorField("v", "SVS-VAMANA", {}, sortable=True),))
+
+    # no_index tag
+    with pytest.raises(Exception):
+        client.ft().create_index((VectorField("v", "SVS-VAMANA", {}, no_index=True),))
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_vector_search_with_parameters(client):
+    client.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {
+                    "TYPE": "FLOAT32",
+                    "DIM": 4,
+                    "DISTANCE_METRIC": "L2",
+                    "CONSTRUCTION_WINDOW_SIZE": 200,
+                    "GRAPH_MAX_DEGREE": 64,
+                    "SEARCH_WINDOW_SIZE": 40,
+                    "EPSILON": 0.01,
+                },
+            ),
+        )
+    )
+
+    # Create test vectors
+    vectors = [
+        [1.0, 2.0, 3.0, 4.0],
+        [2.0, 3.0, 4.0, 5.0],
+        [3.0, 4.0, 5.0, 6.0],
+        [4.0, 5.0, 6.0, 7.0],
+        [5.0, 6.0, 7.0, 8.0],
+    ]
+
+    for i, vec in enumerate(vectors):
+        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+    query = Query("*=>[KNN 3 @v $vec as score]").no_content()
+    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+    res = client.ft().search(query, query_params=query_params)
+    if is_resp2_connection(client):
+        assert res.total == 3
+        assert "doc0" == res.docs[0].id
+    else:
+        assert res["total_results"] == 3
+        assert "doc0" == res["results"][0]["id"]

From 2b1ff5363715c8ba0043314a8b4bcbbc1ba741f5 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 17 Jul 2025 07:50:48 +0300
Subject: [PATCH 1092/1164] Fix compatibility with latest pytest-asyncio
 version(1.1.0) (#3708)

---
 tests/test_asyncio/test_sentinel.py | 2 +-
 tests/test_cluster.py               | 8 ++++++--
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/tests/test_asyncio/test_sentinel.py b/tests/test_asyncio/test_sentinel.py
index 8d8b8f512c..867ff15405 100644
--- a/tests/test_asyncio/test_sentinel.py
+++ b/tests/test_asyncio/test_sentinel.py
@@ -13,7 +13,7 @@
 )
 
 
-@pytest_asyncio.fixture(scope="module")
+@pytest_asyncio.fixture(scope="module", loop_scope="module")
 def master_ip(master_host):
     yield socket.gethostbyname(master_host[0])
 
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index d360ab07f7..4883ba66c9 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -111,9 +111,13 @@ class NodeProxy:
     def __init__(self, addr, redis_addr):
         self.addr = addr
         self.redis_addr = redis_addr
-        self.server = socketserver.ThreadingTCPServer(self.addr, ProxyRequestHandler)
+        self.server = socketserver.ThreadingTCPServer(
+            self.addr, ProxyRequestHandler, bind_and_activate=False
+        )
         self.server.proxy = self
-        self.server.socket_reuse_address = True
+        self.server.allow_reuse_address = True
+        self.server.server_bind()
+        self.server.server_activate()
         self.thread = None
         self.n_connections = 0
 

From a00141618572764821bbe6bd74e025536e061587 Mon Sep 17 00:00:00 2001
From: andy-stark-redis <164213578+andy-stark-redis@users.noreply.github.com>
Date: Thu, 17 Jul 2025 12:27:01 +0100
Subject: [PATCH 1093/1164] DOC-5424 time series examples (#3705)

* DOC-5424 creation and query examples

* DOC-5424 aggregation examples

* DOC-5424 remaining examples

---------

Co-authored-by: petyaslavova <petya.slavova@redis.com>
---
 doctests/dt_time_series.py | 517 +++++++++++++++++++++++++++++++++++++
 1 file changed, 517 insertions(+)
 create mode 100644 doctests/dt_time_series.py

diff --git a/doctests/dt_time_series.py b/doctests/dt_time_series.py
new file mode 100644
index 0000000000..98a2a923cf
--- /dev/null
+++ b/doctests/dt_time_series.py
@@ -0,0 +1,517 @@
+# EXAMPLE: time_series_tutorial
+# HIDE_START
+"""
+Code samples for time series page:
+    https://redis.io/docs/latest/develop/data-types/timeseries/
+"""
+
+import redis
+
+r = redis.Redis(decode_responses=True)
+# HIDE_END
+
+# REMOVE_START
+r.delete(
+    "thermometer:1", "thermometer:2", "thermometer:3",
+    "rg:1", "rg:2", "rg:3", "rg:4",
+    "sensor3",
+    "wind:1", "wind:2", "wind:3", "wind:4",
+    "hyg:1", "hyg:compacted"
+)
+# REMOVE_END
+
+# STEP_START create
+res1 = r.ts().create("thermometer:1")
+print(res1)  # >>> True
+
+res2 = r.type("thermometer:1")
+print(res2)  # >>> TSDB-TYPE
+
+res3 = r.ts().info("thermometer:1")
+print(res3)
+# >>> {'rules': [], ... 'total_samples': 0, ...
+# STEP_END
+# REMOVE_START
+assert res1 is True
+assert res2 == "TSDB-TYPE"
+assert res3["total_samples"] == 0
+# REMOVE_END
+
+# STEP_START create_retention
+res4 = r.ts().add("thermometer:2", 1, 10.8, retention_msecs=100)
+print(res4)  # >>> 1
+
+res5 = r.ts().info("thermometer:2")
+print(res5)
+# >>> {'rules': [], ... 'retention_msecs': 100, ...
+# STEP_END
+# REMOVE_START
+assert res4 == 1
+assert res5["retention_msecs"] == 100
+# REMOVE_END
+
+# STEP_START create_labels
+res6 = r.ts().create(
+    "thermometer:3", 1, 10.4,
+    labels={"location": "UK", "type": "Mercury"}
+)
+print(res6)  # >>> 1
+
+res7 = r.ts().info("thermometer:3")
+print(res7)
+# >>> {'rules': [], ... 'labels': {'location': 'UK', 'type': 'Mercury'}, ...
+# STEP_END
+# REMOVE_START
+assert res6 == 1
+assert res7["labels"] == {"location": "UK", "type": "Mercury"}
+# REMOVE_END
+
+# STEP_START madd
+res8 = r.ts().madd([
+    ("thermometer:1", 1, 9.2),
+    ("thermometer:1", 2, 9.9),
+    ("thermometer:2", 2, 10.3)
+])
+print(res8)  # >>> [1, 2, 2]
+# STEP_END
+# REMOVE_START
+assert res8 == [1, 2, 2]
+# REMOVE_END
+
+# STEP_START get
+# The last recorded temperature for thermometer:2
+# was 10.3 at time 2.
+res9 = r.ts().get("thermometer:2")
+print(res9)  # >>> (2, 10.3)
+# STEP_END
+# REMOVE_START
+assert res9 == (2, 10.3)
+# REMOVE_END
+
+# STEP_START range
+# Add 5 data points to a time series named "rg:1".
+res10 = r.ts().create("rg:1")
+print(res10)  # >>> True
+
+res11 = r.ts().madd([
+        ("rg:1", 0, 18),
+        ("rg:1", 1, 14),
+        ("rg:1", 2, 22),
+        ("rg:1", 3, 18),
+        ("rg:1", 4, 24),
+])
+print(res11)  # >>> [0, 1, 2, 3, 4]
+
+# Retrieve all the data points in ascending order.
+res12 = r.ts().range("rg:1", "-", "+")
+print(res12)  # >>> [(0, 18.0), (1, 14.0), (2, 22.0), (3, 18.0), (4, 24.0)]
+
+# Retrieve data points up to time 1 (inclusive).
+res13 = r.ts().range("rg:1", "-", 1)
+print(res13)  # >>> [(0, 18.0), (1, 14.0)]
+
+# Retrieve data points from time 3 onwards.
+res14 = r.ts().range("rg:1", 3, "+")
+print(res14)  # >>> [(3, 18.0), (4, 24.0)]
+
+# Retrieve all the data points in descending order.
+res15 = r.ts().revrange("rg:1", "-", "+")
+print(res15)  # >>> [(4, 24.0), (3, 18.0), (2, 22.0), (1, 14.0), (0, 18.0)]
+
+# Retrieve data points up to time 1 (inclusive), but return them
+# in descending order.
+res16 = r.ts().revrange("rg:1", "-", 1)
+print(res16)  # >>> [(1, 14.0), (0, 18.0)]
+# STEP_END
+# REMOVE_START
+assert res10 is True
+assert res11 == [0, 1, 2, 3, 4]
+assert res12 == [(0, 18.0), (1, 14.0), (2, 22.0), (3, 18.0), (4, 24.0)]
+assert res13 == [(0, 18.0), (1, 14.0)]
+assert res14 == [(3, 18.0), (4, 24.0)]
+assert res15 == [(4, 24.0), (3, 18.0), (2, 22.0), (1, 14.0), (0, 18.0)]
+assert res16 == [(1, 14.0), (0, 18.0)]
+# REMOVE_END
+
+# STEP_START range_filter
+res17 = r.ts().range("rg:1", "-", "+", filter_by_ts=[0, 2, 4])
+print(res17)  # >>> [(0, 18.0), (2, 22.0), (4, 24.0)]
+
+res18 = r.ts().revrange(
+    "rg:1", "-", "+",
+    filter_by_ts=[0, 2, 4],
+    filter_by_min_value=20,
+    filter_by_max_value=25,
+)
+print(res18)  # >>> [(4, 24.0), (2, 22.0)]
+
+res19 = r.ts().revrange(
+    "rg:1", "-", "+",
+    filter_by_ts=[0, 2, 4],
+    filter_by_min_value=22,
+    filter_by_max_value=22,
+    count=1,
+)
+print(res19)  # >>> [(2, 22.0)]
+# STEP_END
+# REMOVE_START
+assert res17 == [(0, 18.0), (2, 22.0), (4, 24.0)]
+assert res18 == [(4, 24.0), (2, 22.0)]
+assert res19 == [(2, 22.0)]
+# REMOVE_END
+
+# STEP_START query_multi
+# Create three new "rg:" time series (two in the US
+# and one in the UK, with different units) and add some
+# data points.
+res20 = r.ts().create(
+    "rg:2",
+    labels={"location": "us", "unit": "cm"},
+)
+print(res20)  # >>> True
+
+res21 = r.ts().create(
+    "rg:3",
+    labels={"location": "us", "unit": "in"},
+)
+print(res21)  # >>> True
+
+res22 = r.ts().create(
+    "rg:4",
+    labels={"location": "uk", "unit": "mm"},
+)
+print(res22)  # >>> True
+
+res23 = r.ts().madd([
+        ("rg:2", 0, 1.8),
+        ("rg:3", 0, 0.9),
+        ("rg:4", 0, 25),
+])
+print(res23)  # >>> [0, 0, 0]
+
+res24 = r.ts().madd([
+        ("rg:2", 1, 2.1),
+        ("rg:3", 1, 0.77),
+        ("rg:4", 1, 18),
+])
+print(res24)  # >>> [1, 1, 1]
+
+res25 = r.ts().madd([
+        ("rg:2", 2, 2.3),
+        ("rg:3", 2, 1.1),
+        ("rg:4", 2, 21),
+])
+print(res25)  # >>> [2, 2, 2]
+
+res26 = r.ts().madd([
+        ("rg:2", 3, 1.9),
+        ("rg:3", 3, 0.81),
+        ("rg:4", 3, 19),
+])
+print(res26)  # >>> [3, 3, 3]
+
+res27 = r.ts().madd([
+        ("rg:2", 4, 1.78),
+        ("rg:3", 4, 0.74),
+        ("rg:4", 4, 23),
+])
+print(res27)  # >>> [4, 4, 4]
+
+# Retrieve the last data point from each US time series. If
+# you don't specify any labels, an empty array is returned
+# for the labels.
+res28 = r.ts().mget(["location=us"])
+print(res28)  # >>> [{'rg:2': [{}, 4, 1.78]}, {'rg:3': [{}, 4, 0.74]}]
+
+# Retrieve the same data points, but include the `unit`
+# label in the results.
+res29 = r.ts().mget(["location=us"], select_labels=["unit"])
+print(res29)  # >>> [{'unit': 'cm'}, (4, 1.78), {'unit': 'in'}, (4, 0.74)]
+
+# Retrieve data points up to time 2 (inclusive) from all
+# time series that use millimeters as the unit. Include all
+# labels in the results.
+res30 = r.ts().mrange(
+    "-", 2, filters=["unit=mm"], with_labels=True
+)
+print(res30)
+# >>> [{'rg:4': [{'location': 'uk', 'unit': 'mm'}, [(0, 25.4),...
+
+# Retrieve data points from time 1 to time 3 (inclusive) from
+# all time series that use centimeters or millimeters as the unit,
+# but only return the `location` label. Return the results
+# in descending order of timestamp.
+res31 = r.ts().mrevrange(
+    1, 3, filters=["unit=(cm,mm)"], select_labels=["location"]
+)
+print(res31)
+# >>> [[{'location': 'uk'}, (3, 19.0), (2, 21.0), (1, 18.0)],...
+# STEP_END
+# REMOVE_START
+assert res20 is True
+assert res21 is True
+assert res22 is True
+assert res23 == [0, 0, 0]
+assert res24 == [1, 1, 1]
+assert res25 == [2, 2, 2]
+assert res26 == [3, 3, 3]
+assert res27 == [4, 4, 4]
+assert res28 == [{'rg:2': [{}, 4, 1.78]}, {'rg:3': [{}, 4, 0.74]}]
+assert res29 == [
+    {'rg:2': [{'unit': 'cm'}, 4, 1.78]},
+    {'rg:3': [{'unit': 'in'}, 4, 0.74]}
+]
+assert res30 == [
+    {
+        'rg:4': [
+            {'location': 'uk', 'unit': 'mm'},
+            [(0, 25), (1, 18.0), (2, 21.0)]
+        ]
+    }
+]
+assert res31 == [
+    {'rg:2': [{'location': 'us'}, [(3, 1.9), (2, 2.3), (1, 2.1)]]},
+    {'rg:4': [{'location': 'uk'}, [(3, 19.0), (2, 21.0), (1, 18.0)]]}
+]
+# REMOVE_END
+
+# STEP_START agg
+res32 = r.ts().range(
+    "rg:2", "-", "+",
+    aggregation_type="avg",
+    bucket_size_msec=2
+)
+print(res32)
+# >>> [(0, 1.9500000000000002), (2, 2.0999999999999996), (4, 1.78)]
+# STEP_END
+# REMOVE_START
+assert res32 == [
+    (0, 1.9500000000000002), (2, 2.0999999999999996),
+    (4, 1.78)
+]
+# REMOVE_END
+
+# STEP_START agg_bucket
+res33 = r.ts().create("sensor3")
+print(res33)  # >>> True
+
+res34 = r.ts().madd([
+    ("sensor3", 10, 1000),
+    ("sensor3", 20, 2000),
+    ("sensor3", 30, 3000),
+    ("sensor3", 40, 4000),
+    ("sensor3", 50, 5000),
+    ("sensor3", 60, 6000),
+    ("sensor3", 70, 7000),
+])
+print(res34)  # >>> [10, 20, 30, 40, 50, 60, 70]
+
+res35 = r.ts().range(
+    "sensor3", 10, 70,
+    aggregation_type="min",
+    bucket_size_msec=25
+)
+print(res35)
+# >>> [(0, 1000.0), (25, 3000.0), (50, 5000.0)]
+# STEP_END
+# REMOVE_START
+assert res33 is True
+assert res34 == [10, 20, 30, 40, 50, 60, 70]
+assert res35 == [(0, 1000.0), (25, 3000.0), (50, 5000.0)]
+# REMOVE_END
+
+# STEP_START agg_align
+res36 = r.ts().range(
+    "sensor3", 10, 70,
+    aggregation_type="min",
+    bucket_size_msec=25,
+    align="START"
+)
+print(res36)
+# >>> [(10, 1000.0), (35, 4000.0), (60, 6000.0)]
+# STEP_END
+# REMOVE_START
+assert res36 == [(10, 1000.0), (35, 4000.0), (60, 6000.0)]
+# REMOVE_END
+
+# STEP_START agg_multi
+res37 = r.ts().create(
+    "wind:1",
+    labels={"country": "uk"}
+)
+print(res37)  # >>> True
+
+res38 = r.ts().create(
+    "wind:2",
+    labels={"country": "uk"}
+)
+print(res38)  # >>> True
+
+res39 = r.ts().create(
+    "wind:3",
+    labels={"country": "us"}
+)
+print(res39)  # >>> True
+
+res40 = r.ts().create(
+    "wind:4",
+    labels={"country": "us"}
+)
+print(res40)  # >>> True
+
+res41 = r.ts().madd([
+        ("wind:1", 1, 12),
+        ("wind:2", 1, 18),
+        ("wind:3", 1, 5),
+        ("wind:4", 1, 20),
+])
+print(res41)  # >>> [1, 1, 1, 1]
+
+res42 = r.ts().madd([
+        ("wind:1", 2, 14),
+        ("wind:2", 2, 21),
+        ("wind:3", 2, 4),
+        ("wind:4", 2, 25),
+])
+print(res42)  # >>> [2, 2, 2, 2]
+
+res43 = r.ts().madd([
+        ("wind:1", 3, 10),
+        ("wind:2", 3, 24),
+        ("wind:3", 3, 8),
+        ("wind:4", 3, 18),
+])
+print(res43)  # >>> [3, 3, 3, 3]
+
+# The result pairs contain the timestamp and the maximum sample value
+# for the country at that timestamp.
+res44 = r.ts().mrange(
+    "-", "+",
+    filters=["country=(us,uk)"],
+    groupby="country",
+    reduce="max"
+)
+print(res44)
+# >>> [{'country=uk': [{}, [(1, 18.0), (2, 21.0), (3, 24.0)]]}, ...
+
+# The result pairs contain the timestamp and the average sample value
+# for the country at that timestamp.
+res45 = r.ts().mrange(
+    "-", "+",
+    filters=["country=(us,uk)"],
+    groupby="country",
+    reduce="avg"
+)
+print(res45)
+# >>> [{'country=uk': [{}, [(1, 15.0), (2, 17.5), (3, 17.0)]]}, ...
+# STEP_END
+# REMOVE_START
+assert res37 is True
+assert res38 is True
+assert res39 is True
+assert res40 is True
+assert res41 == [1, 1, 1, 1]
+assert res42 == [2, 2, 2, 2]
+assert res43 == [3, 3, 3, 3]
+assert res44 == [
+    {'country=uk': [{}, [(1, 18.0), (2, 21.0), (3, 24.0)]]},
+    {'country=us': [{}, [(1, 20.0), (2, 25.0), (3, 18.0)]]}
+]
+assert res45 == [
+    {'country=uk': [{}, [(1, 15.0), (2, 17.5), (3, 17.0)]]},
+    {'country=us': [{}, [(1, 12.5), (2, 14.5), (3, 13.0)]]}
+]
+# REMOVE_END
+
+# STEP_START create_compaction
+res45 = r.ts().create("hyg:1")
+print(res45)  # >>> True
+
+res46 = r.ts().create("hyg:compacted")
+print(res46)  # >>> True
+
+res47 = r.ts().createrule("hyg:1", "hyg:compacted", "min", 3)
+print(res47)  # >>> True
+
+res48 = r.ts().info("hyg:1")
+print(res48.rules)
+# >>> [['hyg:compacted', 3, 'MIN', 0]]
+
+res49 = r.ts().info("hyg:compacted")
+print(res49.source_key)  # >>> 'hyg:1'
+# STEP_END
+# REMOVE_START
+assert res45 is True
+assert res46 is True
+assert res47 is True
+assert res48.rules == [['hyg:compacted', 3, 'MIN', 0]]
+assert res49.source_key == 'hyg:1'
+# REMOVE_END
+
+# STEP_START comp_add
+res50 = r.ts().madd([
+    ("hyg:1", 0, 75),
+    ("hyg:1", 1, 77),
+    ("hyg:1", 2, 78),
+])
+print(res50)  # >>> [0, 1, 2]
+
+res51 = r.ts().range("hyg:compacted", "-", "+")
+print(res51)  # >>> []
+
+res52 = r.ts().add("hyg:1", 3, 79)
+print(res52)  # >>> 3
+
+res53 = r.ts().range("hyg:compacted", "-", "+")
+print(res53)  # >>> [(0, 75.0)]
+# STEP_END
+# REMOVE_START
+assert res50 == [0, 1, 2]
+assert res51 == []
+assert res52 == 3
+assert res53 == [(0, 75.0)]
+# REMOVE_END
+
+# STEP_START del
+res54 = r.ts().info("thermometer:1")
+print(res54.total_samples)  # >>> 2
+print(res54.first_timestamp)  # >>> 1
+print(res54.last_timestamp)  # >>> 2
+
+res55 = r.ts().add("thermometer:1", 3, 9.7)
+print(res55)  # >>> 3
+
+res56 = r.ts().info("thermometer:1")
+print(res56.total_samples)  # >>> 3
+print(res56.first_timestamp)  # >>> 1
+print(res56.last_timestamp)  # >>> 3
+
+res57 = r.ts().delete("thermometer:1", 1, 2)
+print(res57)  # >>> 2
+
+res58 = r.ts().info("thermometer:1")
+print(res58.total_samples)  # >>> 1
+print(res58.first_timestamp)  # >>> 3
+print(res58.last_timestamp)  # >>> 3
+
+res59 = r.ts().delete("thermometer:1", 3, 3)
+print(res59)  # >>> 1
+
+res60 = r.ts().info("thermometer:1")
+print(res60.total_samples)  # >>> 0
+# STEP_END
+# REMOVE_START
+assert res54.total_samples == 2
+assert res54.first_timestamp == 1
+assert res54.last_timestamp == 2
+assert res55 == 3
+assert res56.total_samples == 3
+assert res56.first_timestamp == 1
+assert res56.last_timestamp == 3
+assert res57 == 2
+assert res58.total_samples == 1
+assert res58.first_timestamp == 3
+assert res58.last_timestamp == 3
+assert res59 == 1
+assert res60.total_samples == 0
+# REMOVE_END

From 4cf094fdd2c1f2ce335e671af3fad7ad0a48f309 Mon Sep 17 00:00:00 2001
From: ngabhanenetskope <ngabhane@netskope.com>
Date: Tue, 22 Jul 2025 22:40:58 +0530
Subject: [PATCH 1094/1164] =?UTF-8?q?Fix=20ConnectionPool=20to=20raise=20M?=
 =?UTF-8?q?axConnectionsError=20instead=20of=20Connection=E2=80=A6=20(#369?=
 =?UTF-8?q?8)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Fix ConnectionPool to raise MaxConnectionsError instead of ConnectionError

- Added MaxConnectionsError class as a subclass of ConnectionError
- Updated connection.py to raise the more specific error
- Updated cluster.py to handle this specific error type
- Added tests to verify the behavior

Fixes #3684

* Update async cluster to handle MaxConnectionsError separately

Add an explanatory comment to the exception handling for MaxConnectionsError in the
async cluster implementation, matching the synchronous version.
This ensures consistent behavior between sync and async implementations when
connection pool is exhausted, preventing unnecessary cluster reinitialization.
---------
---
 redis/__init__.py                   |   2 +
 redis/asyncio/cluster.py            |   8 +-
 redis/cluster.py                    |   7 ++
 redis/connection.py                 |   3 +-
 redis/exceptions.py                 |   8 +-
 tests/test_connection_pool.py       |   8 +-
 tests/test_max_connections_error.py | 112 ++++++++++++++++++++++++++++
 7 files changed, 142 insertions(+), 6 deletions(-)
 create mode 100644 tests/test_max_connections_error.py

diff --git a/redis/__init__.py b/redis/__init__.py
index c75d853bc6..67f165d9fe 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -20,6 +20,7 @@
     DataError,
     InvalidPipelineStack,
     InvalidResponse,
+    MaxConnectionsError,
     OutOfMemoryError,
     PubSubError,
     ReadOnlyError,
@@ -65,6 +66,7 @@ def int_or_str(value):
     "default_backoff",
     "InvalidPipelineStack",
     "InvalidResponse",
+    "MaxConnectionsError",
     "OutOfMemoryError",
     "PubSubError",
     "ReadOnlyError",
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 956262696a..e8434d04a5 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -814,7 +814,13 @@ async def _execute_command(
                     moved = False
 
                 return await target_node.execute_command(*args, **kwargs)
-            except (BusyLoadingError, MaxConnectionsError):
+            except BusyLoadingError:
+                raise
+            except MaxConnectionsError:
+                # MaxConnectionsError indicates client-side resource exhaustion
+                # (too many connections in the pool), not a node failure.
+                # Don't treat this as a node failure - just re-raise the error
+                # without reinitializing the cluster.
                 raise
             except (ConnectionError, TimeoutError):
                 # Connection retries are being handled in the node's
diff --git a/redis/cluster.py b/redis/cluster.py
index dbcf5cc2b7..4b971cf86d 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -39,6 +39,7 @@
     DataError,
     ExecAbortError,
     InvalidPipelineStack,
+    MaxConnectionsError,
     MovedError,
     RedisClusterException,
     RedisError,
@@ -1235,6 +1236,12 @@ def _execute_command(self, target_node, *args, **kwargs):
                 return response
             except AuthenticationError:
                 raise
+            except MaxConnectionsError:
+                # MaxConnectionsError indicates client-side resource exhaustion
+                # (too many connections in the pool), not a node failure.
+                # Don't treat this as a node failure - just re-raise the error
+                # without reinitializing the cluster.
+                raise
             except (ConnectionError, TimeoutError) as e:
                 # ConnectionError can also be raised if we couldn't get a
                 # connection from the pool before timing out, so check that
diff --git a/redis/connection.py b/redis/connection.py
index d457b1015c..1821292770 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -31,6 +31,7 @@
     ChildDeadlockedError,
     ConnectionError,
     DataError,
+    MaxConnectionsError,
     RedisError,
     ResponseError,
     TimeoutError,
@@ -1556,7 +1557,7 @@ def get_encoder(self) -> Encoder:
     def make_connection(self) -> "ConnectionInterface":
         "Create a new connection"
         if self._created_connections >= self.max_connections:
-            raise ConnectionError("Too many connections")
+            raise MaxConnectionsError("Too many connections")
         self._created_connections += 1
 
         if self.cache is not None:
diff --git a/redis/exceptions.py b/redis/exceptions.py
index a00ac65ac1..643444986b 100644
--- a/redis/exceptions.py
+++ b/redis/exceptions.py
@@ -220,7 +220,13 @@ class SlotNotCoveredError(RedisClusterException):
     pass
 
 
-class MaxConnectionsError(ConnectionError): ...
+class MaxConnectionsError(ConnectionError):
+    """
+    Raised when a connection pool has reached its max_connections limit.
+    This indicates pool exhaustion rather than an actual connection failure.
+    """
+
+    pass
 
 
 class CrossSlotTransactionError(RedisClusterException):
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 67b2fd5030..3a4896f2a3 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -76,11 +76,13 @@ def test_multiple_connections(self, master_host):
         assert c1 != c2
 
     def test_max_connections(self, master_host):
-        connection_kwargs = {"host": master_host[0], "port": master_host[1]}
-        pool = self.get_pool(max_connections=2, connection_kwargs=connection_kwargs)
+        # Use DummyConnection to avoid actual connection to Redis
+        # This prevents authentication issues and makes the test more reliable
+        # while still properly testing the MaxConnectionsError behavior
+        pool = self.get_pool(max_connections=2, connection_class=DummyConnection)
         pool.get_connection()
         pool.get_connection()
-        with pytest.raises(redis.ConnectionError):
+        with pytest.raises(redis.MaxConnectionsError):
             pool.get_connection()
 
     def test_reuse_previously_released_connection(self, master_host):
diff --git a/tests/test_max_connections_error.py b/tests/test_max_connections_error.py
new file mode 100644
index 0000000000..4a4e09f8f8
--- /dev/null
+++ b/tests/test_max_connections_error.py
@@ -0,0 +1,112 @@
+import pytest
+import redis
+from unittest import mock
+from redis.connection import ConnectionInterface
+
+
+class DummyConnection(ConnectionInterface):
+    """A dummy connection class for testing that doesn't actually connect to Redis"""
+
+    def __init__(self, *args, **kwargs):
+        self.connected = False
+
+    def connect(self):
+        self.connected = True
+
+    def disconnect(self):
+        self.connected = False
+
+    def register_connect_callback(self, callback):
+        pass
+
+    def deregister_connect_callback(self, callback):
+        pass
+
+    def set_parser(self, parser_class):
+        pass
+
+    def get_protocol(self):
+        return 2
+
+    def on_connect(self):
+        pass
+
+    def check_health(self):
+        return True
+
+    def send_packed_command(self, command, check_health=True):
+        pass
+
+    def send_command(self, *args, **kwargs):
+        pass
+
+    def can_read(self, timeout=0):
+        return False
+
+    def read_response(self, disable_decoding=False, **kwargs):
+        return "PONG"
+
+
+@pytest.mark.onlynoncluster
+def test_max_connections_error_inheritance():
+    """Test that MaxConnectionsError is a subclass of ConnectionError"""
+    assert issubclass(redis.MaxConnectionsError, redis.ConnectionError)
+
+
+@pytest.mark.onlynoncluster
+def test_connection_pool_raises_max_connections_error():
+    """Test that ConnectionPool raises MaxConnectionsError and not ConnectionError"""
+    # Use a dummy connection class that doesn't try to connect to a real Redis server
+    pool = redis.ConnectionPool(max_connections=1, connection_class=DummyConnection)
+    pool.get_connection()
+
+    with pytest.raises(redis.MaxConnectionsError):
+        pool.get_connection()
+
+
+@pytest.mark.skipif(
+    not hasattr(redis, "RedisCluster"), reason="RedisCluster not available"
+)
+def test_cluster_handles_max_connections_error():
+    """
+    Test that RedisCluster doesn't reinitialize when MaxConnectionsError is raised
+    """
+    # Create a more complete mock cluster
+    cluster = mock.MagicMock(spec=redis.RedisCluster)
+    cluster.cluster_response_callbacks = {}
+    cluster.RedisClusterRequestTTL = 3  # Set the TTL to avoid infinite loops
+    cluster.nodes_manager = mock.MagicMock()
+    node = mock.MagicMock()
+
+    # Mock get_redis_connection to return a mock Redis client
+    redis_conn = mock.MagicMock()
+    cluster.get_redis_connection.return_value = redis_conn
+
+    # Setup get_connection to be called and return a connection that will raise
+    connection = mock.MagicMock()
+
+    # Patch the get_connection function in the cluster module
+    with mock.patch("redis.cluster.get_connection", return_value=connection):
+        # Test MaxConnectionsError
+        connection.send_command.side_effect = redis.MaxConnectionsError(
+            "Too many connections"
+        )
+
+        # Call the method and check that the exception is raised
+        with pytest.raises(redis.MaxConnectionsError):
+            redis.RedisCluster._execute_command(cluster, node, "GET", "key")
+
+        # Verify nodes_manager.initialize was NOT called
+        cluster.nodes_manager.initialize.assert_not_called()
+
+        # Reset the mock for the next test
+        cluster.nodes_manager.initialize.reset_mock()
+
+        # Now test with regular ConnectionError to ensure it DOES reinitialize
+        connection.send_command.side_effect = redis.ConnectionError("Connection lost")
+
+        with pytest.raises(redis.ConnectionError):
+            redis.RedisCluster._execute_command(cluster, node, "GET", "key")
+
+        # Verify nodes_manager.initialize WAS called
+        cluster.nodes_manager.initialize.assert_called_once()

From 7291deb5eb8054a0dc915a8bf499a17498bc5968 Mon Sep 17 00:00:00 2001
From: Terence Honles <terence@honles.com>
Date: Wed, 23 Jul 2025 12:56:09 +0200
Subject: [PATCH 1095/1164] add async Retry ``__eq__`` and ``__hash__`` & fix
 ExponentialWithJitterBackoff ``__eq__`` (#3668)

* fix ExponentialWithJitterBackoff ``__eq__``

This change fixes a typo in `ExponentialWithJitterBackoff`'s `__eq__` method.

* create abstract retry class to share methods between retry implementations

* update retry classes: remove slots & move `__eq__` to concrete classes

* implement __init__ methods in retry subclasses to make the supported errors more obvious
---
 redis/asyncio/retry.py | 49 +++++++++++---------------------------
 redis/backoff.py       |  2 +-
 redis/retry.py         | 54 ++++++++++++++++++++++++++++--------------
 tests/test_retry.py    | 22 +++++++++++++----
 4 files changed, 68 insertions(+), 59 deletions(-)

diff --git a/redis/asyncio/retry.py b/redis/asyncio/retry.py
index a20f8b4849..98b2d9c6f8 100644
--- a/redis/asyncio/retry.py
+++ b/redis/asyncio/retry.py
@@ -2,18 +2,16 @@
 from typing import TYPE_CHECKING, Any, Awaitable, Callable, Tuple, Type, TypeVar
 
 from redis.exceptions import ConnectionError, RedisError, TimeoutError
-
-if TYPE_CHECKING:
-    from redis.backoff import AbstractBackoff
-
+from redis.retry import AbstractRetry
 
 T = TypeVar("T")
 
+if TYPE_CHECKING:
+    from redis.backoff import AbstractBackoff
 
-class Retry:
-    """Retry a specific number of times after a failure"""
 
-    __slots__ = "_backoff", "_retries", "_supported_errors"
+class Retry(AbstractRetry[RedisError]):
+    __hash__ = AbstractRetry.__hash__
 
     def __init__(
         self,
@@ -24,36 +22,17 @@ def __init__(
             TimeoutError,
         ),
     ):
-        """
-        Initialize a `Retry` object with a `Backoff` object
-        that retries a maximum of `retries` times.
-        `retries` can be negative to retry forever.
-        You can specify the types of supported errors which trigger
-        a retry with the `supported_errors` parameter.
-        """
-        self._backoff = backoff
-        self._retries = retries
-        self._supported_errors = supported_errors
+        super().__init__(backoff, retries, supported_errors)
 
-    def update_supported_errors(self, specified_errors: list):
-        """
-        Updates the supported errors with the specified error types
-        """
-        self._supported_errors = tuple(
-            set(self._supported_errors + tuple(specified_errors))
-        )
-
-    def get_retries(self) -> int:
-        """
-        Get the number of retries.
-        """
-        return self._retries
+    def __eq__(self, other: Any) -> bool:
+        if not isinstance(other, Retry):
+            return NotImplemented
 
-    def update_retries(self, value: int) -> None:
-        """
-        Set the number of retries.
-        """
-        self._retries = value
+        return (
+            self._backoff == other._backoff
+            and self._retries == other._retries
+            and set(self._supported_errors) == set(other._supported_errors)
+        )
 
     async def call_with_retry(
         self, do: Callable[[], Awaitable[T]], fail: Callable[[RedisError], Any]
diff --git a/redis/backoff.py b/redis/backoff.py
index 22a3ed0abb..6e1f68a7ba 100644
--- a/redis/backoff.py
+++ b/redis/backoff.py
@@ -170,7 +170,7 @@ def __hash__(self) -> int:
         return hash((self._base, self._cap))
 
     def __eq__(self, other) -> bool:
-        if not isinstance(other, EqualJitterBackoff):
+        if not isinstance(other, ExponentialWithJitterBackoff):
             return NotImplemented
 
         return self._base == other._base and self._cap == other._cap
diff --git a/redis/retry.py b/redis/retry.py
index c93f34e65f..75778635e8 100644
--- a/redis/retry.py
+++ b/redis/retry.py
@@ -1,27 +1,27 @@
+import abc
 import socket
 from time import sleep
-from typing import TYPE_CHECKING, Any, Callable, Iterable, Tuple, Type, TypeVar
+from typing import TYPE_CHECKING, Any, Callable, Generic, Iterable, Tuple, Type, TypeVar
 
 from redis.exceptions import ConnectionError, TimeoutError
 
 T = TypeVar("T")
+E = TypeVar("E", bound=Exception, covariant=True)
 
 if TYPE_CHECKING:
     from redis.backoff import AbstractBackoff
 
 
-class Retry:
+class AbstractRetry(Generic[E], abc.ABC):
     """Retry a specific number of times after a failure"""
 
+    _supported_errors: Tuple[Type[E], ...]
+
     def __init__(
         self,
         backoff: "AbstractBackoff",
         retries: int,
-        supported_errors: Tuple[Type[Exception], ...] = (
-            ConnectionError,
-            TimeoutError,
-            socket.timeout,
-        ),
+        supported_errors: Tuple[Type[E], ...],
     ):
         """
         Initialize a `Retry` object with a `Backoff` object
@@ -34,22 +34,14 @@ def __init__(
         self._retries = retries
         self._supported_errors = supported_errors
 
+    @abc.abstractmethod
     def __eq__(self, other: Any) -> bool:
-        if not isinstance(other, Retry):
-            return NotImplemented
-
-        return (
-            self._backoff == other._backoff
-            and self._retries == other._retries
-            and set(self._supported_errors) == set(other._supported_errors)
-        )
+        return NotImplemented
 
     def __hash__(self) -> int:
         return hash((self._backoff, self._retries, frozenset(self._supported_errors)))
 
-    def update_supported_errors(
-        self, specified_errors: Iterable[Type[Exception]]
-    ) -> None:
+    def update_supported_errors(self, specified_errors: Iterable[Type[E]]) -> None:
         """
         Updates the supported errors with the specified error types
         """
@@ -69,6 +61,32 @@ def update_retries(self, value: int) -> None:
         """
         self._retries = value
 
+
+class Retry(AbstractRetry[Exception]):
+    __hash__ = AbstractRetry.__hash__
+
+    def __init__(
+        self,
+        backoff: "AbstractBackoff",
+        retries: int,
+        supported_errors: Tuple[Type[Exception], ...] = (
+            ConnectionError,
+            TimeoutError,
+            socket.timeout,
+        ),
+    ):
+        super().__init__(backoff, retries, supported_errors)
+
+    def __eq__(self, other: Any) -> bool:
+        if not isinstance(other, Retry):
+            return NotImplemented
+
+        return (
+            self._backoff == other._backoff
+            and self._retries == other._retries
+            and set(self._supported_errors) == set(other._supported_errors)
+        )
+
     def call_with_retry(
         self,
         do: Callable[[], T],
diff --git a/tests/test_retry.py b/tests/test_retry.py
index 4f4f04caca..9c0ca65d81 100644
--- a/tests/test_retry.py
+++ b/tests/test_retry.py
@@ -1,6 +1,7 @@
 from unittest.mock import patch
 
 import pytest
+from redis.asyncio.retry import Retry as AsyncRetry
 from redis.backoff import (
     AbstractBackoff,
     ConstantBackoff,
@@ -89,6 +90,7 @@ def test_retry_on_error_retry(self, Class, retries):
         assert c.retry._retries == retries
 
 
+@pytest.mark.parametrize("retry_class", [Retry, AsyncRetry])
 @pytest.mark.parametrize(
     "args",
     [
@@ -108,8 +110,8 @@ def test_retry_on_error_retry(self, Class, retries):
         for backoff in ((Backoff(), 2), (Backoff(25), 5), (Backoff(25, 5), 5))
     ],
 )
-def test_retry_eq_and_hashable(args):
-    assert Retry(*args) == Retry(*args)
+def test_retry_eq_and_hashable(retry_class, args):
+    assert retry_class(*args) == retry_class(*args)
 
     # create another retry object with different parameters
     copy = list(args)
@@ -118,9 +120,19 @@ def test_retry_eq_and_hashable(args):
     else:
         copy[0] = ConstantBackoff(9000)
 
-    assert Retry(*args) != Retry(*copy)
-    assert Retry(*copy) != Retry(*args)
-    assert len({Retry(*args), Retry(*args), Retry(*copy), Retry(*copy)}) == 2
+    assert retry_class(*args) != retry_class(*copy)
+    assert retry_class(*copy) != retry_class(*args)
+    assert (
+        len(
+            {
+                retry_class(*args),
+                retry_class(*args),
+                retry_class(*copy),
+                retry_class(*copy),
+            }
+        )
+        == 2
+    )
 
 
 class TestRetry:

From 31399ed43588840bbbfdbbf0e8260d1b989b49ce Mon Sep 17 00:00:00 2001
From: ManelCoutinhoSensei <mcoutinho@sensei.tech>
Date: Wed, 23 Jul 2025 14:13:40 +0100
Subject: [PATCH 1096/1164] SentinelManagedConnection searches for new master
 upon connection failure (#3560) (#3601)

---
 redis/asyncio/connection.py                   | 13 ++++---
 redis/asyncio/sentinel.py                     | 17 ++++++----
 redis/connection.py                           | 13 ++++---
 redis/sentinel.py                             | 18 ++++++----
 .../test_sentinel_managed_connection.py       |  1 +
 tests/test_sentinel_managed_connection.py     | 34 +++++++++++++++++++
 6 files changed, 74 insertions(+), 22 deletions(-)
 create mode 100644 tests/test_sentinel_managed_connection.py

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 95390bd66c..db8025b6f2 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -295,13 +295,18 @@ async def connect(self):
         """Connects to the Redis server if not already connected"""
         await self.connect_check_health(check_health=True)
 
-    async def connect_check_health(self, check_health: bool = True):
+    async def connect_check_health(
+        self, check_health: bool = True, retry_socket_connect: bool = True
+    ):
         if self.is_connected:
             return
         try:
-            await self.retry.call_with_retry(
-                lambda: self._connect(), lambda error: self.disconnect()
-            )
+            if retry_socket_connect:
+                await self.retry.call_with_retry(
+                    lambda: self._connect(), lambda error: self.disconnect()
+                )
+            else:
+                await self._connect()
         except asyncio.CancelledError:
             raise  # in 3.7 and earlier, this is an Exception, not BaseException
         except (socket.timeout, asyncio.TimeoutError):
diff --git a/redis/asyncio/sentinel.py b/redis/asyncio/sentinel.py
index 0bf7086555..d0455ab6eb 100644
--- a/redis/asyncio/sentinel.py
+++ b/redis/asyncio/sentinel.py
@@ -11,8 +11,12 @@
     SSLConnection,
 )
 from redis.commands import AsyncSentinelCommands
-from redis.exceptions import ConnectionError, ReadOnlyError, ResponseError, TimeoutError
-from redis.utils import str_if_bytes
+from redis.exceptions import (
+    ConnectionError,
+    ReadOnlyError,
+    ResponseError,
+    TimeoutError,
+)
 
 
 class MasterNotFoundError(ConnectionError):
@@ -37,11 +41,10 @@ def __repr__(self):
 
     async def connect_to(self, address):
         self.host, self.port = address
-        await super().connect()
-        if self.connection_pool.check_connection:
-            await self.send_command("PING")
-            if str_if_bytes(await self.read_response()) != "PONG":
-                raise ConnectionError("PING failed")
+        await self.connect_check_health(
+            check_health=self.connection_pool.check_connection,
+            retry_socket_connect=False,
+        )
 
     async def _connect_retry(self):
         if self._reader:
diff --git a/redis/connection.py b/redis/connection.py
index 1821292770..52a402a20a 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -379,13 +379,18 @@ def connect(self):
         "Connects to the Redis server if not already connected"
         self.connect_check_health(check_health=True)
 
-    def connect_check_health(self, check_health: bool = True):
+    def connect_check_health(
+        self, check_health: bool = True, retry_socket_connect: bool = True
+    ):
         if self._sock:
             return
         try:
-            sock = self.retry.call_with_retry(
-                lambda: self._connect(), lambda error: self.disconnect(error)
-            )
+            if retry_socket_connect:
+                sock = self.retry.call_with_retry(
+                    lambda: self._connect(), lambda error: self.disconnect(error)
+                )
+            else:
+                sock = self._connect()
         except socket.timeout:
             raise TimeoutError("Timeout connecting to server")
         except OSError as e:
diff --git a/redis/sentinel.py b/redis/sentinel.py
index 198639c932..f12bd8dd5d 100644
--- a/redis/sentinel.py
+++ b/redis/sentinel.py
@@ -5,8 +5,12 @@
 from redis.client import Redis
 from redis.commands import SentinelCommands
 from redis.connection import Connection, ConnectionPool, SSLConnection
-from redis.exceptions import ConnectionError, ReadOnlyError, ResponseError, TimeoutError
-from redis.utils import str_if_bytes
+from redis.exceptions import (
+    ConnectionError,
+    ReadOnlyError,
+    ResponseError,
+    TimeoutError,
+)
 
 
 class MasterNotFoundError(ConnectionError):
@@ -35,11 +39,11 @@ def __repr__(self):
 
     def connect_to(self, address):
         self.host, self.port = address
-        super().connect()
-        if self.connection_pool.check_connection:
-            self.send_command("PING")
-            if str_if_bytes(self.read_response()) != "PONG":
-                raise ConnectionError("PING failed")
+
+        self.connect_check_health(
+            check_health=self.connection_pool.check_connection,
+            retry_socket_connect=False,
+        )
 
     def _connect_retry(self):
         if self._sock:
diff --git a/tests/test_asyncio/test_sentinel_managed_connection.py b/tests/test_asyncio/test_sentinel_managed_connection.py
index 01f717ee38..5a511b2793 100644
--- a/tests/test_asyncio/test_sentinel_managed_connection.py
+++ b/tests/test_asyncio/test_sentinel_managed_connection.py
@@ -33,4 +33,5 @@ async def mock_connect():
     conn._connect.side_effect = mock_connect
     await conn.connect()
     assert conn._connect.call_count == 3
+    assert connection_pool.get_master_address.call_count == 3
     await conn.disconnect()
diff --git a/tests/test_sentinel_managed_connection.py b/tests/test_sentinel_managed_connection.py
new file mode 100644
index 0000000000..6fe5f7cd5b
--- /dev/null
+++ b/tests/test_sentinel_managed_connection.py
@@ -0,0 +1,34 @@
+import socket
+
+from redis.retry import Retry
+from redis.sentinel import SentinelManagedConnection
+from redis.backoff import NoBackoff
+from unittest import mock
+
+
+def test_connect_retry_on_timeout_error(master_host):
+    """Test that the _connect function is retried in case of a timeout"""
+    connection_pool = mock.Mock()
+    connection_pool.get_master_address = mock.Mock(
+        return_value=(master_host[0], master_host[1])
+    )
+    conn = SentinelManagedConnection(
+        retry_on_timeout=True,
+        retry=Retry(NoBackoff(), 3),
+        connection_pool=connection_pool,
+    )
+    origin_connect = conn._connect
+    conn._connect = mock.Mock()
+
+    def mock_connect():
+        # connect only on the last retry
+        if conn._connect.call_count <= 2:
+            raise socket.timeout
+        else:
+            return origin_connect()
+
+    conn._connect.side_effect = mock_connect
+    conn.connect()
+    assert conn._connect.call_count == 3
+    assert connection_pool.get_master_address.call_count == 3
+    conn.disconnect()

From 4c9512b1fe592dc9becebe9e5f053b0184b47f2c Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Wed, 23 Jul 2025 18:20:50 +0300
Subject: [PATCH 1097/1164] Adding information in connection pool class doc
 string for available SSLConnection class, that can be used for SSL
 connections (#3710)

---
 redis/asyncio/connection.py | 1 +
 redis/connection.py         | 1 +
 2 files changed, 2 insertions(+)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index db8025b6f2..4efd868f6f 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -1042,6 +1042,7 @@ class ConnectionPool:
     By default, TCP connections are created unless ``connection_class``
     is specified. Use :py:class:`~redis.UnixDomainSocketConnection` for
     unix sockets.
+    :py:class:`~redis.SSLConnection` can be used for SSL enabled connections.
 
     Any additional keyword arguments are passed to the constructor of
     ``connection_class``.
diff --git a/redis/connection.py b/redis/connection.py
index 52a402a20a..47cb589569 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1321,6 +1321,7 @@ class ConnectionPool:
     By default, TCP connections are created unless ``connection_class``
     is specified. Use class:`.UnixDomainSocketConnection` for
     unix sockets.
+    :py:class:`~redis.SSLConnection` can be used for SSL enabled connections.
 
     Any additional keyword arguments are passed to the constructor of
     ``connection_class``.

From 67ab74d705b4c1d00d600c500596af7a68abfd56 Mon Sep 17 00:00:00 2001
From: ofekshenawa <104765379+ofekshenawa@users.noreply.github.com>
Date: Thu, 24 Jul 2025 19:46:04 +0300
Subject: [PATCH 1098/1164] Add new stream commands (#3711)

* Add new stream commands

* optimization changes
---
 redis/commands/core.py              |  62 ++++++++++++
 tests/test_asyncio/test_commands.py | 150 ++++++++++++++++++++++++++++
 tests/test_commands.py              | 139 ++++++++++++++++++++++++++
 3 files changed, 351 insertions(+)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index fa448aaac3..d6fb550724 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -3484,6 +3484,28 @@ def xack(self, name: KeyT, groupname: GroupT, *ids: StreamIdT) -> ResponseT:
         """
         return self.execute_command("XACK", name, groupname, *ids)
 
+    def xackdel(
+        self,
+        name: KeyT,
+        groupname: GroupT,
+        *ids: StreamIdT,
+        ref_policy: Literal["KEEPREF", "DELREF", "ACKED"] = "KEEPREF",
+    ) -> ResponseT:
+        """
+        Combines the functionality of XACK and XDEL. Acknowledges the specified
+        message IDs in the given consumer group and simultaneously attempts to
+        delete the corresponding entries from the stream.
+        """
+        if not ids:
+            raise DataError("XACKDEL requires at least one message ID")
+
+        if ref_policy not in {"KEEPREF", "DELREF", "ACKED"}:
+            raise DataError("XACKDEL ref_policy must be one of: KEEPREF, DELREF, ACKED")
+
+        pieces = [name, groupname, ref_policy, "IDS", len(ids)]
+        pieces.extend(ids)
+        return self.execute_command("XACKDEL", *pieces)
+
     def xadd(
         self,
         name: KeyT,
@@ -3494,6 +3516,7 @@ def xadd(
         nomkstream: bool = False,
         minid: Union[StreamIdT, None] = None,
         limit: Optional[int] = None,
+        ref_policy: Optional[Literal["KEEPREF", "DELREF", "ACKED"]] = None,
     ) -> ResponseT:
         """
         Add to a stream.
@@ -3507,6 +3530,10 @@ def xadd(
         minid: the minimum id in the stream to query.
         Can't be specified with maxlen.
         limit: specifies the maximum number of entries to retrieve
+        ref_policy: optional reference policy for consumer groups when trimming:
+            - KEEPREF (default): When trimming, preserves references in consumer groups' PEL
+            - DELREF: When trimming, removes all references from consumer groups' PEL
+            - ACKED: When trimming, only removes entries acknowledged by all consumer groups
 
         For more information see https://redis.io/commands/xadd
         """
@@ -3514,6 +3541,9 @@ def xadd(
         if maxlen is not None and minid is not None:
             raise DataError("Only one of ```maxlen``` or ```minid``` may be specified")
 
+        if ref_policy is not None and ref_policy not in {"KEEPREF", "DELREF", "ACKED"}:
+            raise DataError("XADD ref_policy must be one of: KEEPREF, DELREF, ACKED")
+
         if maxlen is not None:
             if not isinstance(maxlen, int) or maxlen < 0:
                 raise DataError("XADD maxlen must be non-negative integer")
@@ -3530,6 +3560,8 @@ def xadd(
             pieces.extend([b"LIMIT", limit])
         if nomkstream:
             pieces.append(b"NOMKSTREAM")
+        if ref_policy is not None:
+            pieces.append(ref_policy)
         pieces.append(id)
         if not isinstance(fields, dict) or len(fields) == 0:
             raise DataError("XADD fields must be a non-empty dict")
@@ -3683,6 +3715,26 @@ def xdel(self, name: KeyT, *ids: StreamIdT) -> ResponseT:
         """
         return self.execute_command("XDEL", name, *ids)
 
+    def xdelex(
+        self,
+        name: KeyT,
+        *ids: StreamIdT,
+        ref_policy: Literal["KEEPREF", "DELREF", "ACKED"] = "KEEPREF",
+    ) -> ResponseT:
+        """
+        Extended version of XDEL that provides more control over how message entries
+        are deleted concerning consumer groups.
+        """
+        if not ids:
+            raise DataError("XDELEX requires at least one message ID")
+
+        if ref_policy not in {"KEEPREF", "DELREF", "ACKED"}:
+            raise DataError("XDELEX ref_policy must be one of: KEEPREF, DELREF, ACKED")
+
+        pieces = [name, ref_policy, "IDS", len(ids)]
+        pieces.extend(ids)
+        return self.execute_command("XDELEX", *pieces)
+
     def xgroup_create(
         self,
         name: KeyT,
@@ -4034,6 +4086,7 @@ def xtrim(
         approximate: bool = True,
         minid: Union[StreamIdT, None] = None,
         limit: Optional[int] = None,
+        ref_policy: Optional[Literal["KEEPREF", "DELREF", "ACKED"]] = None,
     ) -> ResponseT:
         """
         Trims old messages from a stream.
@@ -4044,6 +4097,10 @@ def xtrim(
         minid: the minimum id in the stream to query
         Can't be specified with maxlen.
         limit: specifies the maximum number of entries to retrieve
+        ref_policy: optional reference policy for consumer groups:
+            - KEEPREF (default): Trims entries but preserves references in consumer groups' PEL
+            - DELREF: Trims entries and removes all references from consumer groups' PEL
+            - ACKED: Only trims entries that were read and acknowledged by all consumer groups
 
         For more information see https://redis.io/commands/xtrim
         """
@@ -4054,6 +4111,9 @@ def xtrim(
         if maxlen is None and minid is None:
             raise DataError("One of ``maxlen`` or ``minid`` must be specified")
 
+        if ref_policy is not None and ref_policy not in {"KEEPREF", "DELREF", "ACKED"}:
+            raise DataError("XTRIM ref_policy must be one of: KEEPREF, DELREF, ACKED")
+
         if maxlen is not None:
             pieces.append(b"MAXLEN")
         if minid is not None:
@@ -4067,6 +4127,8 @@ def xtrim(
         if limit is not None:
             pieces.append(b"LIMIT")
             pieces.append(limit)
+        if ref_policy is not None:
+            pieces.append(ref_policy)
 
         return self.execute_command("XTRIM", name, *pieces)
 
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index bf65210f31..9db7d200e6 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -3465,6 +3465,156 @@ async def test_xtrim(self, r: redis.Redis):
         # 1 message is trimmed
         assert await r.xtrim(stream, 3, approximate=False) == 1
 
+    @skip_if_server_version_lt("8.1.224")
+    async def test_xdelex(self, r: redis.Redis):
+        stream = "stream"
+
+        m1 = await r.xadd(stream, {"foo": "bar"})
+        m2 = await r.xadd(stream, {"foo": "bar"})
+        m3 = await r.xadd(stream, {"foo": "bar"})
+        m4 = await r.xadd(stream, {"foo": "bar"})
+
+        # Test XDELEX with default ref_policy (KEEPREF)
+        result = await r.xdelex(stream, m1)
+        assert result == [1]
+
+        # Test XDELEX with explicit KEEPREF
+        result = await r.xdelex(stream, m2, ref_policy="KEEPREF")
+        assert result == [1]
+
+        # Test XDELEX with DELREF
+        result = await r.xdelex(stream, m3, ref_policy="DELREF")
+        assert result == [1]
+
+        # Test XDELEX with ACKED
+        result = await r.xdelex(stream, m4, ref_policy="ACKED")
+        assert result == [1]
+
+        # Test with non-existent ID
+        result = await r.xdelex(stream, "999999-0", ref_policy="KEEPREF")
+        assert result == [-1]
+
+        # Test with multiple IDs
+        m5 = await r.xadd(stream, {"foo": "bar"})
+        m6 = await r.xadd(stream, {"foo": "bar"})
+        result = await r.xdelex(stream, m5, m6, ref_policy="KEEPREF")
+        assert result == [1, 1]
+
+        # Test error cases
+        with pytest.raises(redis.DataError):
+            await r.xdelex(stream, "123-0", ref_policy="INVALID")
+
+        with pytest.raises(redis.DataError):
+            await r.xdelex(stream)  # No IDs provided
+
+    @skip_if_server_version_lt("8.1.224")
+    async def test_xackdel(self, r: redis.Redis):
+        stream = "stream"
+        group = "group"
+        consumer = "consumer"
+
+        m1 = await r.xadd(stream, {"foo": "bar"})
+        m2 = await r.xadd(stream, {"foo": "bar"})
+        m3 = await r.xadd(stream, {"foo": "bar"})
+        m4 = await r.xadd(stream, {"foo": "bar"})
+        await r.xgroup_create(stream, group, 0)
+
+        await r.xreadgroup(group, consumer, streams={stream: ">"})
+
+        # Test XACKDEL with default ref_policy (KEEPREF)
+        result = await r.xackdel(stream, group, m1)
+        assert result == [1]
+
+        # Test XACKDEL with explicit KEEPREF
+        result = await r.xackdel(stream, group, m2, ref_policy="KEEPREF")
+        assert result == [1]
+
+        # Test XACKDEL with DELREF
+        result = await r.xackdel(stream, group, m3, ref_policy="DELREF")
+        assert result == [1]
+
+        # Test XACKDEL with ACKED
+        result = await r.xackdel(stream, group, m4, ref_policy="ACKED")
+        assert result == [1]
+
+        # Test with non-existent ID
+        result = await r.xackdel(stream, group, "999999-0", ref_policy="KEEPREF")
+        assert result == [-1]
+
+        # Test error cases
+        with pytest.raises(redis.DataError):
+            await r.xackdel(stream, group, m1, ref_policy="INVALID")
+
+        with pytest.raises(redis.DataError):
+            await r.xackdel(stream, group)  # No IDs provided
+
+    @skip_if_server_version_lt("8.1.224")
+    async def test_xtrim_with_options(self, r: redis.Redis):
+        stream = "stream"
+
+        await r.xadd(stream, {"foo": "bar"})
+        await r.xadd(stream, {"foo": "bar"})
+        await r.xadd(stream, {"foo": "bar"})
+        await r.xadd(stream, {"foo": "bar"})
+
+        # Test XTRIM with KEEPREF ref_policy
+        assert (
+            await r.xtrim(stream, maxlen=2, approximate=False, ref_policy="KEEPREF")
+            == 2
+        )
+
+        await r.xadd(stream, {"foo": "bar"})
+        await r.xadd(stream, {"foo": "bar"})
+
+        # Test XTRIM with DELREF ref_policy
+        assert (
+            await r.xtrim(stream, maxlen=2, approximate=False, ref_policy="DELREF") == 2
+        )
+
+        await r.xadd(stream, {"foo": "bar"})
+        await r.xadd(stream, {"foo": "bar"})
+
+        # Test XTRIM with ACKED ref_policy
+        assert (
+            await r.xtrim(stream, maxlen=2, approximate=False, ref_policy="ACKED") == 2
+        )
+
+        # Test error case
+        with pytest.raises(redis.DataError):
+            await r.xtrim(stream, maxlen=2, ref_policy="INVALID")
+
+    @skip_if_server_version_lt("8.1.224")
+    async def test_xadd_with_options(self, r: redis.Redis):
+        stream = "stream"
+
+        # Test XADD with KEEPREF ref_policy
+        await r.xadd(
+            stream, {"foo": "bar"}, maxlen=2, approximate=False, ref_policy="KEEPREF"
+        )
+        await r.xadd(
+            stream, {"foo": "bar"}, maxlen=2, approximate=False, ref_policy="KEEPREF"
+        )
+        await r.xadd(
+            stream, {"foo": "bar"}, maxlen=2, approximate=False, ref_policy="KEEPREF"
+        )
+        assert await r.xlen(stream) == 2
+
+        # Test XADD with DELREF ref_policy
+        await r.xadd(
+            stream, {"foo": "bar"}, maxlen=2, approximate=False, ref_policy="DELREF"
+        )
+        assert await r.xlen(stream) == 2
+
+        # Test XADD with ACKED ref_policy
+        await r.xadd(
+            stream, {"foo": "bar"}, maxlen=2, approximate=False, ref_policy="ACKED"
+        )
+        assert await r.xlen(stream) == 2
+
+        # Test error case
+        with pytest.raises(redis.DataError):
+            await r.xadd(stream, {"foo": "bar"}, ref_policy="INVALID")
+
     @pytest.mark.onlynoncluster
     async def test_bitfield_operations(self, r: redis.Redis):
         # comments show affected bits
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 9ac8ee4933..42530a47d2 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -5096,6 +5096,145 @@ def test_xtrim_minlen_and_length_args(self, r):
         r.xadd(stream, {"foo": "bar"})
         assert r.xtrim(stream, None, approximate=True, minid=m3) == 0
 
+    @skip_if_server_version_lt("8.1.224")
+    def test_xdelex(self, r):
+        stream = "stream"
+
+        m1 = r.xadd(stream, {"foo": "bar"})
+        m2 = r.xadd(stream, {"foo": "bar"})
+        m3 = r.xadd(stream, {"foo": "bar"})
+        m4 = r.xadd(stream, {"foo": "bar"})
+
+        # Test XDELEX with default ref_policy (KEEPREF)
+        result = r.xdelex(stream, m1)
+        assert result == [1]
+
+        # Test XDELEX with explicit KEEPREF
+        result = r.xdelex(stream, m2, ref_policy="KEEPREF")
+        assert result == [1]
+
+        # Test XDELEX with DELREF
+        result = r.xdelex(stream, m3, ref_policy="DELREF")
+        assert result == [1]
+
+        # Test XDELEX with ACKED
+        result = r.xdelex(stream, m4, ref_policy="ACKED")
+        assert result == [1]
+
+        # Test with non-existent ID
+        result = r.xdelex(stream, "999999-0", ref_policy="KEEPREF")
+        assert result == [-1]
+
+        # Test with multiple IDs
+        m5 = r.xadd(stream, {"foo": "bar"})
+        m6 = r.xadd(stream, {"foo": "bar"})
+        result = r.xdelex(stream, m5, m6, ref_policy="KEEPREF")
+        assert result == [1, 1]  # Both entries deleted
+
+        # Test error cases
+        with pytest.raises(redis.DataError):
+            r.xdelex(stream, "123-0", ref_policy="INVALID")
+
+        with pytest.raises(redis.DataError):
+            r.xdelex(stream)  # No IDs provided
+
+    @skip_if_server_version_lt("8.1.224")
+    def test_xackdel(self, r):
+        stream = "stream"
+        group = "group"
+        consumer = "consumer"
+
+        m1 = r.xadd(stream, {"foo": "bar"})
+        m2 = r.xadd(stream, {"foo": "bar"})
+        m3 = r.xadd(stream, {"foo": "bar"})
+        m4 = r.xadd(stream, {"foo": "bar"})
+        r.xgroup_create(stream, group, 0)
+
+        r.xreadgroup(group, consumer, streams={stream: ">"})
+
+        # Test XACKDEL with default ref_policy (KEEPREF)
+        result = r.xackdel(stream, group, m1)
+        assert result == [1]
+
+        # Test XACKDEL with explicit KEEPREF
+        result = r.xackdel(stream, group, m2, ref_policy="KEEPREF")
+        assert result == [1]
+
+        # Test XACKDEL with DELREF
+        result = r.xackdel(stream, group, m3, ref_policy="DELREF")
+        assert result == [1]
+
+        # Test XACKDEL with ACKED
+        result = r.xackdel(stream, group, m4, ref_policy="ACKED")
+        assert result == [1]
+
+        # Test with non-existent ID
+        result = r.xackdel(stream, group, "999999-0", ref_policy="KEEPREF")
+        assert result == [-1]
+
+        # Test error cases
+        with pytest.raises(redis.DataError):
+            r.xackdel(stream, group, m1, ref_policy="INVALID")
+
+        with pytest.raises(redis.DataError):
+            r.xackdel(stream, group)  # No IDs provided
+
+    @skip_if_server_version_lt("8.1.224")
+    def test_xtrim_with_options(self, r):
+        stream = "stream"
+
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+
+        # Test XTRIM with KEEPREF ref_policy
+        assert r.xtrim(stream, maxlen=2, approximate=False, ref_policy="KEEPREF") == 2
+
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+
+        # Test XTRIM with DELREF ref_policy
+        assert r.xtrim(stream, maxlen=2, approximate=False, ref_policy="DELREF") == 2
+
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo": "bar"})
+
+        # Test XTRIM with ACKED ref_policy
+        assert r.xtrim(stream, maxlen=2, approximate=False, ref_policy="ACKED") == 2
+
+        # Test error case
+        with pytest.raises(redis.DataError):
+            r.xtrim(stream, maxlen=2, ref_policy="INVALID")
+
+    @skip_if_server_version_lt("8.1.224")
+    def test_xadd_with_options(self, r):
+        stream = "stream"
+
+        # Test XADD with KEEPREF ref_policy
+        r.xadd(
+            stream, {"foo": "bar"}, maxlen=2, approximate=False, ref_policy="KEEPREF"
+        )
+        r.xadd(
+            stream, {"foo": "bar"}, maxlen=2, approximate=False, ref_policy="KEEPREF"
+        )
+        r.xadd(
+            stream, {"foo": "bar"}, maxlen=2, approximate=False, ref_policy="KEEPREF"
+        )
+        assert r.xlen(stream) == 2
+
+        # Test XADD with DELREF ref_policy
+        r.xadd(stream, {"foo": "bar"}, maxlen=2, approximate=False, ref_policy="DELREF")
+        assert r.xlen(stream) == 2
+
+        # Test XADD with ACKED ref_policy
+        r.xadd(stream, {"foo": "bar"}, maxlen=2, approximate=False, ref_policy="ACKED")
+        assert r.xlen(stream) == 2
+
+        # Test error case
+        with pytest.raises(redis.DataError):
+            r.xadd(stream, {"foo": "bar"}, ref_policy="INVALID")
+
     def test_bitfield_operations(self, r):
         # comments show affected bits
         bf = r.bitfield("a")

From 64426cbdd43153b70b0e29d9d7b3ab2c63760359 Mon Sep 17 00:00:00 2001
From: Hristo Temelski <hristo.temelski@redis.com>
Date: Tue, 5 Aug 2025 13:30:09 +0300
Subject: [PATCH 1099/1164] Added epsilon property to the vsim command (#3723)

* added epsilon property to the vsim command

* fixed linter errors

* added async client test

* modified test to use async
---
 redis/commands/vectorset/commands.py |  7 +++++++
 tests/test_asyncio/test_vsets.py     | 15 +++++++++++++++
 tests/test_vsets.py                  | 15 +++++++++++++++
 3 files changed, 37 insertions(+)

diff --git a/redis/commands/vectorset/commands.py b/redis/commands/vectorset/commands.py
index c24bd200ce..0f23dba10d 100644
--- a/redis/commands/vectorset/commands.py
+++ b/redis/commands/vectorset/commands.py
@@ -129,6 +129,7 @@ def vsim(
         filter_ef: Optional[str] = None,
         truth: Optional[bool] = False,
         no_thread: Optional[bool] = False,
+        epsilon: Optional[Number] = None,
     ) -> Union[
         Awaitable[Optional[List[Union[List[EncodableT], Dict[EncodableT, Number]]]]],
         Optional[List[Union[List[EncodableT], Dict[EncodableT, Number]]]],
@@ -152,6 +153,9 @@ def vsim(
         ``no_thread`` when enabled forces the command to execute the search
                 on the data structure in the main thread.
 
+        ``epsilon`` floating point between 0 and 1, if specified will return
+                only elements with distance no further than the specified one.
+
         For more information see https://redis.io/commands/vsim
         """
 
@@ -176,6 +180,9 @@ def vsim(
         if count:
             pieces.extend(["COUNT", count])
 
+        if epsilon:
+            pieces.extend(["EPSILON", epsilon])
+
         if ef:
             pieces.extend(["EF", ef])
 
diff --git a/tests/test_asyncio/test_vsets.py b/tests/test_asyncio/test_vsets.py
index 4ae336acf8..01c2f3c95a 100644
--- a/tests/test_asyncio/test_vsets.py
+++ b/tests/test_asyncio/test_vsets.py
@@ -423,6 +423,21 @@ async def test_vsim_truth_no_thread_enabled(d_client):
     assert isinstance(sim_no_thread, dict)
 
 
+@skip_if_server_version_lt("8.2.0")
+async def test_vsim_epsilon(d_client):
+    await d_client.vset().vadd("myset", [2, 1, 1], "a")
+    await d_client.vset().vadd("myset", [2, 0, 1], "b")
+    await d_client.vset().vadd("myset", [2, 0, 0], "c")
+    await d_client.vset().vadd("myset", [2, 0, -1], "d")
+    await d_client.vset().vadd("myset", [2, -1, -1], "e")
+
+    res1 = await d_client.vset().vsim("myset", [2, 1, 1])
+    assert 5 == len(res1)
+
+    res2 = await d_client.vset().vsim("myset", [2, 1, 1], epsilon=0.5)
+    assert 3 == len(res2)
+
+
 @skip_if_server_version_lt("7.9.0")
 async def test_vdim(d_client):
     float_array = [1, 4.32, 0.11, 0.5, 0.9, 0.1, 0.2]
diff --git a/tests/test_vsets.py b/tests/test_vsets.py
index 4a9d95bc1f..38776cc102 100644
--- a/tests/test_vsets.py
+++ b/tests/test_vsets.py
@@ -425,6 +425,21 @@ def test_vsim_truth_no_thread_enabled(d_client):
     assert isinstance(sim_no_thread, dict)
 
 
+@skip_if_server_version_lt("8.2.0")
+def test_vsim_epsilon(d_client):
+    d_client.vset().vadd("myset", [2, 1, 1], "a")
+    d_client.vset().vadd("myset", [2, 0, 1], "b")
+    d_client.vset().vadd("myset", [2, 0, 0], "c")
+    d_client.vset().vadd("myset", [2, 0, -1], "d")
+    d_client.vset().vadd("myset", [2, -1, -1], "e")
+
+    res1 = d_client.vset().vsim("myset", [2, 1, 1])
+    assert 5 == len(res1)
+
+    res2 = d_client.vset().vsim("myset", [2, 1, 1], epsilon=0.5)
+    assert 3 == len(res2)
+
+
 @skip_if_server_version_lt("7.9.0")
 def test_vdim(d_client):
     float_array = [1, 4.32, 0.11, 0.5, 0.9, 0.1, 0.2]

From 43ce2a4025c020bd26e401371c16ca4920b470a5 Mon Sep 17 00:00:00 2001
From: Elena Kolevska <elena-kolevska@users.noreply.github.com>
Date: Wed, 6 Aug 2025 09:27:45 +0100
Subject: [PATCH 1100/1164] Updating the latest Redis image for github pipeline
 testing (#3726)

* Updates test image

Signed-off-by: Elena Kolevska <elena@kolevska.com>

* Adds testcase for RECUCE and COMPRESSION in ft.createindex

Signed-off-by: Elena Kolevska <elena@kolevska.com>

* linter

Signed-off-by: Elena Kolevska <elena@kolevska.com>

* case sensitive imnage name

Signed-off-by: Elena Kolevska <elena@kolevska.com>

* Updates compression

Signed-off-by: Elena Kolevska <elena@kolevska.com>

* Removed already covered Python version from matrix

* Updated test image

* Updated test cases

---------

Signed-off-by: Elena Kolevska <elena@kolevska.com>
Co-authored-by: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Co-authored-by: vladvildanov <vladyslav.vildanov@redis.com>
---
 .github/workflows/integration.yaml |  4 +--
 tests/test_asyncio/test_vsets.py   |  2 +-
 tests/test_search.py               | 49 ++++++++++++++++++++++++++++++
 tests/test_vsets.py                |  2 +-
 4 files changed, 53 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index b720e1d99c..43766b072b 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -74,7 +74,7 @@ jobs:
       max-parallel: 15
       fail-fast: false
       matrix:
-        redis-version: ['8.2-RC1-pre', '${{ needs.redis_version.outputs.CURRENT }}', '7.4.4', '7.2.9']
+        redis-version: ['8.2', '${{ needs.redis_version.outputs.CURRENT }}', '7.4.4', '7.2.9']
         python-version: ['3.9', '3.13']
         parser-backend: ['plain']
         event-loop: ['asyncio']
@@ -99,7 +99,7 @@ jobs:
       fail-fast: false
       matrix:
         redis-version: [ '${{ needs.redis_version.outputs.CURRENT }}' ]
-        python-version: ['3.9', '3.10', '3.11', '3.12', 'pypy-3.9', 'pypy-3.10']
+        python-version: ['3.10', '3.11', '3.12', 'pypy-3.9', 'pypy-3.10']
         parser-backend: [ 'plain' ]
         event-loop: [ 'asyncio' ]
     env:
diff --git a/tests/test_asyncio/test_vsets.py b/tests/test_asyncio/test_vsets.py
index 01c2f3c95a..8294d8aff4 100644
--- a/tests/test_asyncio/test_vsets.py
+++ b/tests/test_asyncio/test_vsets.py
@@ -435,7 +435,7 @@ async def test_vsim_epsilon(d_client):
     assert 5 == len(res1)
 
     res2 = await d_client.vset().vsim("myset", [2, 1, 1], epsilon=0.5)
-    assert 3 == len(res2)
+    assert 4 == len(res2)
 
 
 @skip_if_server_version_lt("7.9.0")
diff --git a/tests/test_search.py b/tests/test_search.py
index 3460b56ca1..c28b4aa932 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -3802,3 +3802,52 @@ def test_svs_vamana_vector_search_with_parameters(client):
     else:
         assert res["total_results"] == 3
         assert "doc0" == res["results"][0]["id"]
+
+
+@pytest.mark.redismod
+@skip_ifmodversion_lt("2.4.3", "search")
+@skip_if_server_version_lt("8.1.224")
+def test_svs_vamana_vector_search_with_parameters_leanvec(client):
+    client.ft().create_index(
+        (
+            VectorField(
+                "v",
+                "SVS-VAMANA",
+                {
+                    "TYPE": "FLOAT32",
+                    "DIM": 8,
+                    "DISTANCE_METRIC": "L2",
+                    "COMPRESSION": "LeanVec8x8",  # LeanVec compression required for REDUCE
+                    "CONSTRUCTION_WINDOW_SIZE": 200,
+                    "GRAPH_MAX_DEGREE": 32,
+                    "SEARCH_WINDOW_SIZE": 15,
+                    "EPSILON": 0.01,
+                    "TRAINING_THRESHOLD": 1024,
+                    "REDUCE": 4,  # Half of DIM (8/2 = 4)
+                },
+            ),
+        )
+    )
+
+    # Create test vectors (8-dimensional to match DIM)
+    vectors = [
+        [1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0],
+        [2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0],
+        [3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0],
+        [4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0, 11.0],
+        [5.0, 6.0, 7.0, 8.0, 9.0, 10.0, 11.0, 12.0],
+    ]
+
+    for i, vec in enumerate(vectors):
+        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+    query = Query("*=>[KNN 3 @v $vec as score]").no_content()
+    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+    res = client.ft().search(query, query_params=query_params)
+    if is_resp2_connection(client):
+        assert res.total == 3
+        assert "doc0" == res.docs[0].id
+    else:
+        assert res["total_results"] == 3
+        assert "doc0" == res["results"][0]["id"]
diff --git a/tests/test_vsets.py b/tests/test_vsets.py
index 38776cc102..e212b1b286 100644
--- a/tests/test_vsets.py
+++ b/tests/test_vsets.py
@@ -437,7 +437,7 @@ def test_vsim_epsilon(d_client):
     assert 5 == len(res1)
 
     res2 = d_client.vset().vsim("myset", [2, 1, 1], epsilon=0.5)
-    assert 3 == len(res2)
+    assert 4 == len(res2)
 
 
 @skip_if_server_version_lt("7.9.0")

From 755a4213c45bf4ac607e79026cc36a2c362e9193 Mon Sep 17 00:00:00 2001
From: sobolevn <mail@sobolevn.me>
Date: Thu, 7 Aug 2025 12:09:54 +0300
Subject: [PATCH 1101/1164] docs: fix `zadd` command parameter description
 (#3727)

I changed: the case, because they are all in lower-case as parameters of `zadd()`. And fixed the description to be in style with others.
---
 redis/commands/core.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index d6fb550724..9fcb38883a 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -4172,17 +4172,17 @@ def zadd(
         the existing score will be incremented by. When using this mode the
         return value of ZADD will be the new score of the element.
 
-        ``LT`` Only update existing elements if the new score is less than
+        ``lt`` only updates existing elements if the new score is less than
         the current score. This flag doesn't prevent adding new elements.
 
-        ``GT`` Only update existing elements if the new score is greater than
+        ``gt`` only updates existing elements if the new score is greater than
         the current score. This flag doesn't prevent adding new elements.
 
         The return value of ZADD varies based on the mode specified. With no
         options, ZADD returns the number of new elements added to the sorted
         set.
 
-        ``NX``, ``LT``, and ``GT`` are mutually exclusive options.
+        ``nx``, ``lt``, and ``gt`` are mutually exclusive options.
 
         See: https://redis.io/commands/ZADD
         """

From 0d3a97442c3047af9f16ee7d83386ec26b10895f Mon Sep 17 00:00:00 2001
From: Hunter Hogan <hunterhogan@users.noreply.github.com>
Date: Thu, 7 Aug 2025 07:09:07 -0500
Subject: [PATCH 1102/1164] Fixing typos in core.py (#3720)

---
 redis/commands/core.py | 564 ++++++++++++++++++++---------------------
 1 file changed, 282 insertions(+), 282 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index 9fcb38883a..737b09811e 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -71,7 +71,7 @@ def acl_cat(self, category: Optional[str] = None, **kwargs) -> ResponseT:
         If ``category`` is supplied, returns a list of all commands within
         that category.
 
-        For more information see https://redis.io/commands/acl-cat
+        For more information, see https://redis.io/commands/acl-cat
         """
         pieces: list[EncodableT] = [category] if category else []
         return self.execute_command("ACL CAT", *pieces, **kwargs)
@@ -80,7 +80,7 @@ def acl_dryrun(self, username, *args, **kwargs):
         """
         Simulate the execution of a given command by a given ``username``.
 
-        For more information see https://redis.io/commands/acl-dryrun
+        For more information, see https://redis.io/commands/acl-dryrun
         """
         return self.execute_command("ACL DRYRUN", username, *args, **kwargs)
 
@@ -88,7 +88,7 @@ def acl_deluser(self, *username: str, **kwargs) -> ResponseT:
         """
         Delete the ACL for the specified ``username``\\s
 
-        For more information see https://redis.io/commands/acl-deluser
+        For more information, see https://redis.io/commands/acl-deluser
         """
         return self.execute_command("ACL DELUSER", *username, **kwargs)
 
@@ -117,7 +117,7 @@ def acl_getuser(self, username: str, **kwargs) -> ResponseT:
 
         If ``username`` does not exist, return None
 
-        For more information see https://redis.io/commands/acl-getuser
+        For more information, see https://redis.io/commands/acl-getuser
         """
         return self.execute_command("ACL GETUSER", username, **kwargs)
 
@@ -125,7 +125,7 @@ def acl_help(self, **kwargs) -> ResponseT:
         """The ACL HELP command returns helpful text describing
         the different subcommands.
 
-        For more information see https://redis.io/commands/acl-help
+        For more information, see https://redis.io/commands/acl-help
         """
         return self.execute_command("ACL HELP", **kwargs)
 
@@ -133,7 +133,7 @@ def acl_list(self, **kwargs) -> ResponseT:
         """
         Return a list of all ACLs on the server
 
-        For more information see https://redis.io/commands/acl-list
+        For more information, see https://redis.io/commands/acl-list
         """
         return self.execute_command("ACL LIST", **kwargs)
 
@@ -143,7 +143,7 @@ def acl_log(self, count: Optional[int] = None, **kwargs) -> ResponseT:
         :param int count: Get logs[0:count].
         :rtype: List.
 
-        For more information see https://redis.io/commands/acl-log
+        For more information, see https://redis.io/commands/acl-log
         """
         args = []
         if count is not None:
@@ -158,7 +158,7 @@ def acl_log_reset(self, **kwargs) -> ResponseT:
         Reset ACL logs.
         :rtype: Boolean.
 
-        For more information see https://redis.io/commands/acl-log
+        For more information, see https://redis.io/commands/acl-log
         """
         args = [b"RESET"]
         return self.execute_command("ACL LOG", *args, **kwargs)
@@ -170,7 +170,7 @@ def acl_load(self, **kwargs) -> ResponseT:
         Note that the server must be configured with the ``aclfile``
         directive to be able to load ACL rules from an aclfile.
 
-        For more information see https://redis.io/commands/acl-load
+        For more information, see https://redis.io/commands/acl-load
         """
         return self.execute_command("ACL LOAD", **kwargs)
 
@@ -181,7 +181,7 @@ def acl_save(self, **kwargs) -> ResponseT:
         Note that the server must be configured with the ``aclfile``
         directive to be able to save ACL rules to an aclfile.
 
-        For more information see https://redis.io/commands/acl-save
+        For more information, see https://redis.io/commands/acl-save
         """
         return self.execute_command("ACL SAVE", **kwargs)
 
@@ -379,14 +379,14 @@ def acl_setuser(
     def acl_users(self, **kwargs) -> ResponseT:
         """Returns a list of all registered users on the server.
 
-        For more information see https://redis.io/commands/acl-users
+        For more information, see https://redis.io/commands/acl-users
         """
         return self.execute_command("ACL USERS", **kwargs)
 
     def acl_whoami(self, **kwargs) -> ResponseT:
         """Get the username for the current connection
 
-        For more information see https://redis.io/commands/acl-whoami
+        For more information, see https://redis.io/commands/acl-whoami
         """
         return self.execute_command("ACL WHOAMI", **kwargs)
 
@@ -404,7 +404,7 @@ def auth(self, password: str, username: Optional[str] = None, **kwargs):
         Authenticates the user. If you do not pass username, Redis will try to
         authenticate for the "default" user. If you do pass username, it will
         authenticate for the given user.
-        For more information see https://redis.io/commands/auth
+        For more information, see https://redis.io/commands/auth
         """
         pieces = []
         if username is not None:
@@ -415,7 +415,7 @@ def auth(self, password: str, username: Optional[str] = None, **kwargs):
     def bgrewriteaof(self, **kwargs):
         """Tell the Redis server to rewrite the AOF file from data in memory.
 
-        For more information see https://redis.io/commands/bgrewriteaof
+        For more information, see https://redis.io/commands/bgrewriteaof
         """
         return self.execute_command("BGREWRITEAOF", **kwargs)
 
@@ -424,7 +424,7 @@ def bgsave(self, schedule: bool = True, **kwargs) -> ResponseT:
         Tell the Redis server to save its data to disk.  Unlike save(),
         this method is asynchronous and returns immediately.
 
-        For more information see https://redis.io/commands/bgsave
+        For more information, see https://redis.io/commands/bgsave
         """
         pieces = []
         if schedule:
@@ -437,14 +437,14 @@ def role(self) -> ResponseT:
         the context of replication, by returning if the instance
         is currently a master, slave, or sentinel.
 
-        For more information see https://redis.io/commands/role
+        For more information, see https://redis.io/commands/role
         """
         return self.execute_command("ROLE")
 
     def client_kill(self, address: str, **kwargs) -> ResponseT:
         """Disconnects the client at ``address`` (ip:port)
 
-        For more information see https://redis.io/commands/client-kill
+        For more information, see https://redis.io/commands/client-kill
         """
         return self.execute_command("CLIENT KILL", address, **kwargs)
 
@@ -507,7 +507,7 @@ def client_info(self, **kwargs) -> ResponseT:
         Returns information and statistics about the current
         client connection.
 
-        For more information see https://redis.io/commands/client-info
+        For more information, see https://redis.io/commands/client-info
         """
         return self.execute_command("CLIENT INFO", **kwargs)
 
@@ -522,7 +522,7 @@ def client_list(
          replica, pubsub)
         :param client_id: optional. a list of client ids
 
-        For more information see https://redis.io/commands/client-list
+        For more information, see https://redis.io/commands/client-list
         """
         args = []
         if _type is not None:
@@ -542,7 +542,7 @@ def client_getname(self, **kwargs) -> ResponseT:
         """
         Returns the current connection name
 
-        For more information see https://redis.io/commands/client-getname
+        For more information, see https://redis.io/commands/client-getname
         """
         return self.execute_command("CLIENT GETNAME", **kwargs)
 
@@ -583,7 +583,7 @@ def client_id(self, **kwargs) -> ResponseT:
         """
         Returns the current connection id
 
-        For more information see https://redis.io/commands/client-id
+        For more information, see https://redis.io/commands/client-id
         """
         return self.execute_command("CLIENT ID", **kwargs)
 
@@ -598,7 +598,7 @@ def client_tracking_on(
     ) -> ResponseT:
         """
         Turn on the tracking mode.
-        For more information about the options look at client_tracking func.
+        For more information, about the options look at client_tracking func.
 
         See https://redis.io/commands/client-tracking
         """
@@ -617,7 +617,7 @@ def client_tracking_off(
     ) -> ResponseT:
         """
         Turn off the tracking mode.
-        For more information about the options look at client_tracking func.
+        For more information, about the options look at client_tracking func.
 
         See https://redis.io/commands/client-tracking
         """
@@ -640,7 +640,7 @@ def client_tracking(
         Enables the tracking feature of the Redis server, that is used
         for server assisted client side caching.
 
-        ``on`` indicate for tracking on or tracking off. The dafualt is on.
+        ``on`` indicate for tracking on or tracking off. The default is on.
 
         ``clientid`` send invalidation messages to the connection with
         the specified ID.
@@ -698,7 +698,7 @@ def client_setname(self, name: str, **kwargs) -> ResponseT:
         """
         Sets the current connection name
 
-        For more information see https://redis.io/commands/client-setname
+        For more information, see https://redis.io/commands/client-setname
 
         .. note::
            This method sets client name only for **current** connection.
@@ -724,7 +724,7 @@ def client_unblock(
         If ``error`` is False (default), the client is unblocked using the
         regular timeout mechanism.
 
-        For more information see https://redis.io/commands/client-unblock
+        For more information, see https://redis.io/commands/client-unblock
         """
         args = ["CLIENT UNBLOCK", int(client_id)]
         if error:
@@ -736,7 +736,7 @@ def client_pause(self, timeout: int, all: bool = True, **kwargs) -> ResponseT:
         Suspend all the Redis clients for the specified amount of time.
 
 
-        For more information see https://redis.io/commands/client-pause
+        For more information, see https://redis.io/commands/client-pause
 
         Args:
             timeout: milliseconds to pause clients
@@ -763,7 +763,7 @@ def client_unpause(self, **kwargs) -> ResponseT:
         """
         Unpause all redis clients
 
-        For more information see https://redis.io/commands/client-unpause
+        For more information, see https://redis.io/commands/client-unpause
         """
         return self.execute_command("CLIENT UNPAUSE", **kwargs)
 
@@ -771,7 +771,7 @@ def client_no_evict(self, mode: str) -> Union[Awaitable[str], str]:
         """
         Sets the client eviction mode for the current connection.
 
-        For more information see https://redis.io/commands/client-no-evict
+        For more information, see https://redis.io/commands/client-no-evict
         """
         return self.execute_command("CLIENT NO-EVICT", mode)
 
@@ -782,7 +782,7 @@ def client_no_touch(self, mode: str) -> Union[Awaitable[str], str]:
         # When turned on, the current client will not change LFU/LRU stats,
         # unless it sends the TOUCH command.
 
-        For more information see https://redis.io/commands/client-no-touch
+        For more information, see https://redis.io/commands/client-no-touch
         """
         return self.execute_command("CLIENT NO-TOUCH", mode)
 
@@ -790,7 +790,7 @@ def command(self, **kwargs):
         """
         Returns dict reply of details about all Redis commands.
 
-        For more information see https://redis.io/commands/command
+        For more information, see https://redis.io/commands/command
         """
         return self.execute_command("COMMAND", **kwargs)
 
@@ -815,7 +815,7 @@ def command_list(
         ``category``: get the commands in the ACL category
         ``pattern``: get the commands that match the given pattern
 
-        For more information see https://redis.io/commands/command-list/
+        For more information, see https://redis.io/commands/command-list/
         """
         pieces = []
         if module is not None:
@@ -834,7 +834,7 @@ def command_getkeysandflags(self, *args: List[str]) -> List[Union[str, List[str]
         """
         Returns array of keys from a full Redis command and their usage flags.
 
-        For more information see https://redis.io/commands/command-getkeysandflags
+        For more information, see https://redis.io/commands/command-getkeysandflags
         """
         return self.execute_command("COMMAND GETKEYSANDFLAGS", *args)
 
@@ -853,7 +853,7 @@ def config_get(
         """
         Return a dictionary of configuration based on the ``pattern``
 
-        For more information see https://redis.io/commands/config-get
+        For more information, see https://redis.io/commands/config-get
         """
         return self.execute_command("CONFIG GET", pattern, *args, **kwargs)
 
@@ -866,7 +866,7 @@ def config_set(
     ) -> ResponseT:
         """Set config item ``name`` with ``value``
 
-        For more information see https://redis.io/commands/config-set
+        For more information, see https://redis.io/commands/config-set
         """
         return self.execute_command("CONFIG SET", name, value, *args, **kwargs)
 
@@ -874,7 +874,7 @@ def config_resetstat(self, **kwargs) -> ResponseT:
         """
         Reset runtime statistics
 
-        For more information see https://redis.io/commands/config-resetstat
+        For more information, see https://redis.io/commands/config-resetstat
         """
         return self.execute_command("CONFIG RESETSTAT", **kwargs)
 
@@ -882,7 +882,7 @@ def config_rewrite(self, **kwargs) -> ResponseT:
         """
         Rewrite config file with the minimal change to reflect running config.
 
-        For more information see https://redis.io/commands/config-rewrite
+        For more information, see https://redis.io/commands/config-rewrite
         """
         return self.execute_command("CONFIG REWRITE", **kwargs)
 
@@ -890,7 +890,7 @@ def dbsize(self, **kwargs) -> ResponseT:
         """
         Returns the number of keys in the current database
 
-        For more information see https://redis.io/commands/dbsize
+        For more information, see https://redis.io/commands/dbsize
         """
         return self.execute_command("DBSIZE", **kwargs)
 
@@ -898,7 +898,7 @@ def debug_object(self, key: KeyT, **kwargs) -> ResponseT:
         """
         Returns version specific meta information about a given key
 
-        For more information see https://redis.io/commands/debug-object
+        For more information, see https://redis.io/commands/debug-object
         """
         return self.execute_command("DEBUG OBJECT", key, **kwargs)
 
@@ -907,7 +907,7 @@ def debug_segfault(self, **kwargs) -> None:
             """
             DEBUG SEGFAULT is intentionally not implemented in the client.
 
-            For more information see https://redis.io/commands/debug-segfault
+            For more information, see https://redis.io/commands/debug-segfault
             """
         )
 
@@ -915,7 +915,7 @@ def echo(self, value: EncodableT, **kwargs) -> ResponseT:
         """
         Echo the string back from the server
 
-        For more information see https://redis.io/commands/echo
+        For more information, see https://redis.io/commands/echo
         """
         return self.execute_command("ECHO", value, **kwargs)
 
@@ -926,7 +926,7 @@ def flushall(self, asynchronous: bool = False, **kwargs) -> ResponseT:
         ``asynchronous`` indicates whether the operation is
         executed asynchronously by the server.
 
-        For more information see https://redis.io/commands/flushall
+        For more information, see https://redis.io/commands/flushall
         """
         args = []
         if asynchronous:
@@ -940,7 +940,7 @@ def flushdb(self, asynchronous: bool = False, **kwargs) -> ResponseT:
         ``asynchronous`` indicates whether the operation is
         executed asynchronously by the server.
 
-        For more information see https://redis.io/commands/flushdb
+        For more information, see https://redis.io/commands/flushdb
         """
         args = []
         if asynchronous:
@@ -951,7 +951,7 @@ def sync(self) -> ResponseT:
         """
         Initiates a replication stream from the master.
 
-        For more information see https://redis.io/commands/sync
+        For more information, see https://redis.io/commands/sync
         """
         from redis.client import NEVER_DECODE
 
@@ -964,7 +964,7 @@ def psync(self, replicationid: str, offset: int):
         Initiates a replication stream from the master.
         Newer version for `sync`.
 
-        For more information see https://redis.io/commands/sync
+        For more information, see https://redis.io/commands/sync
         """
         from redis.client import NEVER_DECODE
 
@@ -976,7 +976,7 @@ def swapdb(self, first: int, second: int, **kwargs) -> ResponseT:
         """
         Swap two databases
 
-        For more information see https://redis.io/commands/swapdb
+        For more information, see https://redis.io/commands/swapdb
         """
         return self.execute_command("SWAPDB", first, second, **kwargs)
 
@@ -999,7 +999,7 @@ def info(
         The section option is not supported by older versions of Redis Server,
         and will generate ResponseError
 
-        For more information see https://redis.io/commands/info
+        For more information, see https://redis.io/commands/info
         """
         if section is None:
             return self.execute_command("INFO", **kwargs)
@@ -1011,35 +1011,35 @@ def lastsave(self, **kwargs) -> ResponseT:
         Return a Python datetime object representing the last time the
         Redis database was saved to disk
 
-        For more information see https://redis.io/commands/lastsave
+        For more information, see https://redis.io/commands/lastsave
         """
         return self.execute_command("LASTSAVE", **kwargs)
 
     def latency_doctor(self):
         """Raise a NotImplementedError, as the client will not support LATENCY DOCTOR.
-        This funcion is best used within the redis-cli.
+        This function is best used within the redis-cli.
 
-        For more information see https://redis.io/commands/latency-doctor
+        For more information, see https://redis.io/commands/latency-doctor
         """
         raise NotImplementedError(
             """
             LATENCY DOCTOR is intentionally not implemented in the client.
 
-            For more information see https://redis.io/commands/latency-doctor
+            For more information, see https://redis.io/commands/latency-doctor
             """
         )
 
     def latency_graph(self):
         """Raise a NotImplementedError, as the client will not support LATENCY GRAPH.
-        This funcion is best used within the redis-cli.
+        This function is best used within the redis-cli.
 
-        For more information see https://redis.io/commands/latency-graph.
+        For more information, see https://redis.io/commands/latency-graph.
         """
         raise NotImplementedError(
             """
             LATENCY GRAPH is intentionally not implemented in the client.
 
-            For more information see https://redis.io/commands/latency-graph
+            For more information, see https://redis.io/commands/latency-graph
             """
         )
 
@@ -1055,7 +1055,7 @@ def lolwut(self, *version_numbers: Union[str, float], **kwargs) -> ResponseT:
             return self.execute_command("LOLWUT", **kwargs)
 
     def reset(self) -> ResponseT:
-        """Perform a full reset on the connection's server side contenxt.
+        """Perform a full reset on the connection's server-side context.
 
         See: https://redis.io/commands/reset
         """
@@ -1090,7 +1090,7 @@ def migrate(
         If ``auth`` is specified, authenticate to the destination server with
         the password provided.
 
-        For more information see https://redis.io/commands/migrate
+        For more information, see https://redis.io/commands/migrate
         """
         keys = list_or_args(keys, [])
         if not keys:
@@ -1122,7 +1122,7 @@ def memory_doctor(self, **kwargs) -> None:
             """
             MEMORY DOCTOR is intentionally not implemented in the client.
 
-            For more information see https://redis.io/commands/memory-doctor
+            For more information, see https://redis.io/commands/memory-doctor
             """
         )
 
@@ -1131,7 +1131,7 @@ def memory_help(self, **kwargs) -> None:
             """
             MEMORY HELP is intentionally not implemented in the client.
 
-            For more information see https://redis.io/commands/memory-help
+            For more information, see https://redis.io/commands/memory-help
             """
         )
 
@@ -1139,7 +1139,7 @@ def memory_stats(self, **kwargs) -> ResponseT:
         """
         Return a dictionary of memory stats
 
-        For more information see https://redis.io/commands/memory-stats
+        For more information, see https://redis.io/commands/memory-stats
         """
         return self.execute_command("MEMORY STATS", **kwargs)
 
@@ -1162,7 +1162,7 @@ def memory_usage(
         sample. If left unspecified, the server's default is 5. Use 0 to sample
         all elements.
 
-        For more information see https://redis.io/commands/memory-usage
+        For more information, see https://redis.io/commands/memory-usage
         """
         args = []
         if isinstance(samples, int):
@@ -1173,7 +1173,7 @@ def memory_purge(self, **kwargs) -> ResponseT:
         """
         Attempts to purge dirty pages for reclamation by allocator
 
-        For more information see https://redis.io/commands/memory-purge
+        For more information, see https://redis.io/commands/memory-purge
         """
         return self.execute_command("MEMORY PURGE", **kwargs)
 
@@ -1190,7 +1190,7 @@ def latency_history(self, event: str) -> ResponseT:
         """
         Returns the raw data of the ``event``'s latency spikes time series.
 
-        For more information see https://redis.io/commands/latency-history
+        For more information, see https://redis.io/commands/latency-history
         """
         return self.execute_command("LATENCY HISTORY", event)
 
@@ -1198,7 +1198,7 @@ def latency_latest(self) -> ResponseT:
         """
         Reports the latest latency events logged.
 
-        For more information see https://redis.io/commands/latency-latest
+        For more information, see https://redis.io/commands/latency-latest
         """
         return self.execute_command("LATENCY LATEST")
 
@@ -1206,7 +1206,7 @@ def latency_reset(self, *events: str) -> ResponseT:
         """
         Resets the latency spikes time series of all, or only some, events.
 
-        For more information see https://redis.io/commands/latency-reset
+        For more information, see https://redis.io/commands/latency-reset
         """
         return self.execute_command("LATENCY RESET", *events)
 
@@ -1214,7 +1214,7 @@ def ping(self, **kwargs) -> ResponseT:
         """
         Ping the Redis server
 
-        For more information see https://redis.io/commands/ping
+        For more information, see https://redis.io/commands/ping
         """
         return self.execute_command("PING", **kwargs)
 
@@ -1222,7 +1222,7 @@ def quit(self, **kwargs) -> ResponseT:
         """
         Ask the server to close the connection.
 
-        For more information see https://redis.io/commands/quit
+        For more information, see https://redis.io/commands/quit
         """
         return self.execute_command("QUIT", **kwargs)
 
@@ -1235,7 +1235,7 @@ def replicaof(self, *args, **kwargs) -> ResponseT:
         NO ONE (set no replication)
         host port (set to the host and port of a redis server)
 
-        For more information see  https://redis.io/commands/replicaof
+        For more information, see  https://redis.io/commands/replicaof
         """
         return self.execute_command("REPLICAOF", *args, **kwargs)
 
@@ -1244,7 +1244,7 @@ def save(self, **kwargs) -> ResponseT:
         Tell the Redis server to save its data to disk,
         blocking until the save is complete
 
-        For more information see https://redis.io/commands/save
+        For more information, see https://redis.io/commands/save
         """
         return self.execute_command("SAVE", **kwargs)
 
@@ -1268,7 +1268,7 @@ def shutdown(
         ``force`` ignores any errors that would normally prevent the server from exiting
         ``abort`` cancels an ongoing shutdown and cannot be combined with other flags.
 
-        For more information see https://redis.io/commands/shutdown
+        For more information, see https://redis.io/commands/shutdown
         """
         if save and nosave:
             raise DataError("SHUTDOWN save and nosave cannot both be set")
@@ -1298,7 +1298,7 @@ def slaveof(
         by the ``host`` and ``port``. If called without arguments, the
         instance is promoted to a master instead.
 
-        For more information see https://redis.io/commands/slaveof
+        For more information, see https://redis.io/commands/slaveof
         """
         if host is None and port is None:
             return self.execute_command("SLAVEOF", b"NO", b"ONE", **kwargs)
@@ -1309,7 +1309,7 @@ def slowlog_get(self, num: Optional[int] = None, **kwargs) -> ResponseT:
         Get the entries from the slowlog. If ``num`` is specified, get the
         most recent ``num`` items.
 
-        For more information see https://redis.io/commands/slowlog-get
+        For more information, see https://redis.io/commands/slowlog-get
         """
         from redis.client import NEVER_DECODE
 
@@ -1325,7 +1325,7 @@ def slowlog_len(self, **kwargs) -> ResponseT:
         """
         Get the number of items in the slowlog
 
-        For more information see https://redis.io/commands/slowlog-len
+        For more information, see https://redis.io/commands/slowlog-len
         """
         return self.execute_command("SLOWLOG LEN", **kwargs)
 
@@ -1333,7 +1333,7 @@ def slowlog_reset(self, **kwargs) -> ResponseT:
         """
         Remove all items in the slowlog
 
-        For more information see https://redis.io/commands/slowlog-reset
+        For more information, see https://redis.io/commands/slowlog-reset
         """
         return self.execute_command("SLOWLOG RESET", **kwargs)
 
@@ -1342,7 +1342,7 @@ def time(self, **kwargs) -> ResponseT:
         Returns the server time as a 2-item tuple of ints:
         (seconds since epoch, microseconds into this second).
 
-        For more information see https://redis.io/commands/time
+        For more information, see https://redis.io/commands/time
         """
         return self.execute_command("TIME", **kwargs)
 
@@ -1353,7 +1353,7 @@ def wait(self, num_replicas: int, timeout: int, **kwargs) -> ResponseT:
         we finally have at least ``num_replicas``, or when the ``timeout`` was
         reached.
 
-        For more information see https://redis.io/commands/wait
+        For more information, see https://redis.io/commands/wait
         """
         return self.execute_command("WAIT", num_replicas, timeout, **kwargs)
 
@@ -1366,7 +1366,7 @@ def waitaof(
         to the AOF of the local Redis and/or at least the specified number
         of replicas.
 
-        For more information see https://redis.io/commands/waitaof
+        For more information, see https://redis.io/commands/waitaof
         """
         return self.execute_command(
             "WAITAOF", num_local, num_replicas, timeout, **kwargs
@@ -1419,7 +1419,7 @@ async def shutdown(
         configured.  If the "nosave" option is set, no data flush will be
         attempted.  The "save" and "nosave" options cannot both be set.
 
-        For more information see https://redis.io/commands/shutdown
+        For more information, see https://redis.io/commands/shutdown
         """
         if save and nosave:
             raise DataError("SHUTDOWN save and nosave cannot both be set")
@@ -1565,7 +1565,7 @@ def append(self, key: KeyT, value: EncodableT) -> ResponseT:
         doesn't already exist, create it with a value of ``value``.
         Returns the new length of the value at ``key``.
 
-        For more information see https://redis.io/commands/append
+        For more information, see https://redis.io/commands/append
         """
         return self.execute_command("APPEND", key, value)
 
@@ -1580,7 +1580,7 @@ def bitcount(
         Returns the count of set bits in the value of ``key``.  Optional
         ``start`` and ``end`` parameters indicate which bytes to consider
 
-        For more information see https://redis.io/commands/bitcount
+        For more information, see https://redis.io/commands/bitcount
         """
         params = [key]
         if start is not None and end is not None:
@@ -1601,7 +1601,7 @@ def bitfield(
         Return a BitFieldOperation instance to conveniently construct one or
         more bitfield operations on ``key``.
 
-        For more information see https://redis.io/commands/bitfield
+        For more information, see https://redis.io/commands/bitfield
         """
         return BitFieldOperation(self, key, default_overflow=default_overflow)
 
@@ -1619,7 +1619,7 @@ def bitfield_ro(
         encoding/offset pairs in optional list ``items``
         Read-only variant of the BITFIELD command.
 
-        For more information see https://redis.io/commands/bitfield_ro
+        For more information, see https://redis.io/commands/bitfield_ro
         """
         params = [key, "GET", encoding, offset]
 
@@ -1633,7 +1633,7 @@ def bitop(self, operation: str, dest: KeyT, *keys: KeyT) -> ResponseT:
         Perform a bitwise operation using ``operation`` between ``keys`` and
         store the result in ``dest``.
 
-        For more information see https://redis.io/commands/bitop
+        For more information, see https://redis.io/commands/bitop
         """
         return self.execute_command("BITOP", operation, dest, *keys)
 
@@ -1651,7 +1651,7 @@ def bitpos(
         as a range of bytes and not a range of bits, so start=0 and end=2
         means to look at the first three bytes.
 
-        For more information see https://redis.io/commands/bitpos
+        For more information, see https://redis.io/commands/bitpos
         """
         if bit not in (0, 1):
             raise DataError("bit must be 0 or 1")
@@ -1685,7 +1685,7 @@ def copy(
         copying the value to it. By default, the value is not copied if
         the ``destination`` key already exists.
 
-        For more information see https://redis.io/commands/copy
+        For more information, see https://redis.io/commands/copy
         """
         params = [source, destination]
         if destination_db is not None:
@@ -1699,7 +1699,7 @@ def decrby(self, name: KeyT, amount: int = 1) -> ResponseT:
         Decrements the value of ``key`` by ``amount``.  If no key exists,
         the value will be initialized as 0 - ``amount``
 
-        For more information see https://redis.io/commands/decrby
+        For more information, see https://redis.io/commands/decrby
         """
         return self.execute_command("DECRBY", name, amount)
 
@@ -1719,7 +1719,7 @@ def dump(self, name: KeyT) -> ResponseT:
         Return a serialized version of the value stored at the specified key.
         If key does not exist a nil bulk reply is returned.
 
-        For more information see https://redis.io/commands/dump
+        For more information, see https://redis.io/commands/dump
         """
         from redis.client import NEVER_DECODE
 
@@ -1731,7 +1731,7 @@ def exists(self, *names: KeyT) -> ResponseT:
         """
         Returns the number of ``names`` that exist
 
-        For more information see https://redis.io/commands/exists
+        For more information, see https://redis.io/commands/exists
         """
         return self.execute_command("EXISTS", *names, keys=names)
 
@@ -1757,7 +1757,7 @@ def expire(
             GT -> Set expiry only when the new expiry is greater than current one
             LT -> Set expiry only when the new expiry is less than current one
 
-        For more information see https://redis.io/commands/expire
+        For more information, see https://redis.io/commands/expire
         """
         if isinstance(time, datetime.timedelta):
             time = int(time.total_seconds())
@@ -1794,7 +1794,7 @@ def expireat(
             -> GT -- Set expiry only when the new expiry is greater than current one
             -> LT -- Set expiry only when the new expiry is less than current one
 
-        For more information see https://redis.io/commands/expireat
+        For more information, see https://redis.io/commands/expireat
         """
         if isinstance(when, datetime.datetime):
             when = int(when.timestamp())
@@ -1816,7 +1816,7 @@ def expiretime(self, key: str) -> int:
         Returns the absolute Unix timestamp (since January 1, 1970) in seconds
         at which the given key will expire.
 
-        For more information see https://redis.io/commands/expiretime
+        For more information, see https://redis.io/commands/expiretime
         """
         return self.execute_command("EXPIRETIME", key)
 
@@ -1824,7 +1824,7 @@ def get(self, name: KeyT) -> ResponseT:
         """
         Return the value at key ``name``, or None if the key doesn't exist
 
-        For more information see https://redis.io/commands/get
+        For more information, see https://redis.io/commands/get
         """
         return self.execute_command("GET", name, keys=[name])
 
@@ -1835,7 +1835,7 @@ def getdel(self, name: KeyT) -> ResponseT:
         the key on success (if and only if the key's value type
         is a string).
 
-        For more information see https://redis.io/commands/getdel
+        For more information, see https://redis.io/commands/getdel
         """
         return self.execute_command("GETDEL", name)
 
@@ -1866,7 +1866,7 @@ def getex(
 
         ``persist`` remove the time to live associated with ``name``.
 
-        For more information see https://redis.io/commands/getex
+        For more information, see https://redis.io/commands/getex
         """
         opset = {ex, px, exat, pxat}
         if len(opset) > 2 or len(opset) > 1 and persist:
@@ -1896,7 +1896,7 @@ def getbit(self, name: KeyT, offset: int) -> ResponseT:
         """
         Returns an integer indicating the value of ``offset`` in ``name``
 
-        For more information see https://redis.io/commands/getbit
+        For more information, see https://redis.io/commands/getbit
         """
         return self.execute_command("GETBIT", name, offset, keys=[name])
 
@@ -1905,7 +1905,7 @@ def getrange(self, key: KeyT, start: int, end: int) -> ResponseT:
         Returns the substring of the string value stored at ``key``,
         determined by the offsets ``start`` and ``end`` (both are inclusive)
 
-        For more information see https://redis.io/commands/getrange
+        For more information, see https://redis.io/commands/getrange
         """
         return self.execute_command("GETRANGE", key, start, end, keys=[key])
 
@@ -1917,7 +1917,7 @@ def getset(self, name: KeyT, value: EncodableT) -> ResponseT:
         As per Redis 6.2, GETSET is considered deprecated.
         Please use SET with GET parameter in new code.
 
-        For more information see https://redis.io/commands/getset
+        For more information, see https://redis.io/commands/getset
         """
         return self.execute_command("GETSET", name, value)
 
@@ -1926,7 +1926,7 @@ def incrby(self, name: KeyT, amount: int = 1) -> ResponseT:
         Increments the value of ``key`` by ``amount``.  If no key exists,
         the value will be initialized as ``amount``
 
-        For more information see https://redis.io/commands/incrby
+        For more information, see https://redis.io/commands/incrby
         """
         return self.execute_command("INCRBY", name, amount)
 
@@ -1937,7 +1937,7 @@ def incrbyfloat(self, name: KeyT, amount: float = 1.0) -> ResponseT:
         Increments the value at key ``name`` by floating ``amount``.
         If no key exists, the value will be initialized as ``amount``
 
-        For more information see https://redis.io/commands/incrbyfloat
+        For more information, see https://redis.io/commands/incrbyfloat
         """
         return self.execute_command("INCRBYFLOAT", name, amount)
 
@@ -1945,7 +1945,7 @@ def keys(self, pattern: PatternT = "*", **kwargs) -> ResponseT:
         """
         Returns a list of keys matching ``pattern``
 
-        For more information see https://redis.io/commands/keys
+        For more information, see https://redis.io/commands/keys
         """
         return self.execute_command("KEYS", pattern, **kwargs)
 
@@ -1957,7 +1957,7 @@ def lmove(
         pushing it as the first/last element on the destination list.
         Returns the element being popped and pushed.
 
-        For more information see https://redis.io/commands/lmove
+        For more information, see https://redis.io/commands/lmove
         """
         params = [first_list, second_list, src, dest]
         return self.execute_command("LMOVE", *params)
@@ -1973,7 +1973,7 @@ def blmove(
         """
         Blocking version of lmove.
 
-        For more information see https://redis.io/commands/blmove
+        For more information, see https://redis.io/commands/blmove
         """
         params = [first_list, second_list, src, dest, timeout]
         return self.execute_command("BLMOVE", *params)
@@ -1982,7 +1982,7 @@ def mget(self, keys: KeysT, *args: EncodableT) -> ResponseT:
         """
         Returns a list of values ordered identically to ``keys``
 
-        For more information see https://redis.io/commands/mget
+        For more information, see https://redis.io/commands/mget
         """
         from redis.client import EMPTY_RESPONSE
 
@@ -1999,7 +1999,7 @@ def mset(self, mapping: Mapping[AnyKeyT, EncodableT]) -> ResponseT:
         key/value pairs. Both keys and values should be strings or types that
         can be cast to a string via str().
 
-        For more information see https://redis.io/commands/mset
+        For more information, see https://redis.io/commands/mset
         """
         items = []
         for pair in mapping.items():
@@ -2013,7 +2013,7 @@ def msetnx(self, mapping: Mapping[AnyKeyT, EncodableT]) -> ResponseT:
         should be strings or types that can be cast to a string via str().
         Returns a boolean indicating if the operation was successful.
 
-        For more information see https://redis.io/commands/msetnx
+        For more information, see https://redis.io/commands/msetnx
         """
         items = []
         for pair in mapping.items():
@@ -2024,7 +2024,7 @@ def move(self, name: KeyT, db: int) -> ResponseT:
         """
         Moves the key ``name`` to a different Redis database ``db``
 
-        For more information see https://redis.io/commands/move
+        For more information, see https://redis.io/commands/move
         """
         return self.execute_command("MOVE", name, db)
 
@@ -2032,7 +2032,7 @@ def persist(self, name: KeyT) -> ResponseT:
         """
         Removes an expiration on ``name``
 
-        For more information see https://redis.io/commands/persist
+        For more information, see https://redis.io/commands/persist
         """
         return self.execute_command("PERSIST", name)
 
@@ -2056,7 +2056,7 @@ def pexpire(
             GT -> Set expiry only when the new expiry is greater than current one
             LT -> Set expiry only when the new expiry is less than current one
 
-        For more information see https://redis.io/commands/pexpire
+        For more information, see https://redis.io/commands/pexpire
         """
         if isinstance(time, datetime.timedelta):
             time = int(time.total_seconds() * 1000)
@@ -2092,7 +2092,7 @@ def pexpireat(
             GT -> Set expiry only when the new expiry is greater than current one
             LT -> Set expiry only when the new expiry is less than current one
 
-        For more information see https://redis.io/commands/pexpireat
+        For more information, see https://redis.io/commands/pexpireat
         """
         if isinstance(when, datetime.datetime):
             when = int(when.timestamp() * 1000)
@@ -2112,7 +2112,7 @@ def pexpiretime(self, key: str) -> int:
         Returns the absolute Unix timestamp (since January 1, 1970) in milliseconds
         at which the given key will expire.
 
-        For more information see https://redis.io/commands/pexpiretime
+        For more information, see https://redis.io/commands/pexpiretime
         """
         return self.execute_command("PEXPIRETIME", key)
 
@@ -2122,7 +2122,7 @@ def psetex(self, name: KeyT, time_ms: ExpiryT, value: EncodableT):
         milliseconds. ``time_ms`` can be represented by an integer or a Python
         timedelta object
 
-        For more information see https://redis.io/commands/psetex
+        For more information, see https://redis.io/commands/psetex
         """
         if isinstance(time_ms, datetime.timedelta):
             time_ms = int(time_ms.total_seconds() * 1000)
@@ -2132,7 +2132,7 @@ def pttl(self, name: KeyT) -> ResponseT:
         """
         Returns the number of milliseconds until the key ``name`` will expire
 
-        For more information see https://redis.io/commands/pttl
+        For more information, see https://redis.io/commands/pttl
         """
         return self.execute_command("PTTL", name)
 
@@ -2150,7 +2150,7 @@ def hrandfield(
         withvalues: The optional WITHVALUES modifier changes the reply so it
         includes the respective values of the randomly selected hash fields.
 
-        For more information see https://redis.io/commands/hrandfield
+        For more information, see https://redis.io/commands/hrandfield
         """
         params = []
         if count is not None:
@@ -2164,7 +2164,7 @@ def randomkey(self, **kwargs) -> ResponseT:
         """
         Returns the name of a random key
 
-        For more information see https://redis.io/commands/randomkey
+        For more information, see https://redis.io/commands/randomkey
         """
         return self.execute_command("RANDOMKEY", **kwargs)
 
@@ -2172,7 +2172,7 @@ def rename(self, src: KeyT, dst: KeyT) -> ResponseT:
         """
         Rename key ``src`` to ``dst``
 
-        For more information see https://redis.io/commands/rename
+        For more information, see https://redis.io/commands/rename
         """
         return self.execute_command("RENAME", src, dst)
 
@@ -2180,7 +2180,7 @@ def renamenx(self, src: KeyT, dst: KeyT):
         """
         Rename key ``src`` to ``dst`` if ``dst`` doesn't already exist
 
-        For more information see https://redis.io/commands/renamenx
+        For more information, see https://redis.io/commands/renamenx
         """
         return self.execute_command("RENAMENX", src, dst)
 
@@ -2211,7 +2211,7 @@ def restore(
         ``frequency`` Used for eviction, this is the frequency counter of
         the object stored at the key, prior to execution.
 
-        For more information see https://redis.io/commands/restore
+        For more information, see https://redis.io/commands/restore
         """
         params = [name, ttl, value]
         if replace:
@@ -2273,7 +2273,7 @@ def set(
         ``pxat`` sets an expire flag on key ``name`` for ``ex`` milliseconds,
             specified in unix time.
 
-        For more information see https://redis.io/commands/set
+        For more information, see https://redis.io/commands/set
         """
         opset = {ex, px, exat, pxat}
         if len(opset) > 2 or len(opset) > 1 and keepttl:
@@ -2312,7 +2312,7 @@ def setbit(self, name: KeyT, offset: int, value: int) -> ResponseT:
         Flag the ``offset`` in ``name`` as ``value``. Returns an integer
         indicating the previous value of ``offset``.
 
-        For more information see https://redis.io/commands/setbit
+        For more information, see https://redis.io/commands/setbit
         """
         value = value and 1 or 0
         return self.execute_command("SETBIT", name, offset, value)
@@ -2323,7 +2323,7 @@ def setex(self, name: KeyT, time: ExpiryT, value: EncodableT) -> ResponseT:
         seconds. ``time`` can be represented by an integer or a Python
         timedelta object.
 
-        For more information see https://redis.io/commands/setex
+        For more information, see https://redis.io/commands/setex
         """
         if isinstance(time, datetime.timedelta):
             time = int(time.total_seconds())
@@ -2333,7 +2333,7 @@ def setnx(self, name: KeyT, value: EncodableT) -> ResponseT:
         """
         Set the value of key ``name`` to ``value`` if key doesn't exist
 
-        For more information see https://redis.io/commands/setnx
+        For more information, see https://redis.io/commands/setnx
         """
         return self.execute_command("SETNX", name, value)
 
@@ -2348,7 +2348,7 @@ def setrange(self, name: KeyT, offset: int, value: EncodableT) -> ResponseT:
 
         Returns the length of the new string.
 
-        For more information see https://redis.io/commands/setrange
+        For more information, see https://redis.io/commands/setrange
         """
         return self.execute_command("SETRANGE", name, offset, value)
 
@@ -2381,7 +2381,7 @@ def stralgo(
         ``withmatchlen`` Returns the matches with the len of the match.
         Can be provided only when ``idx`` set to True.
 
-        For more information see https://redis.io/commands/stralgo
+        For more information, see https://redis.io/commands/stralgo
         """
         # check validity
         supported_algo = ["LCS"]
@@ -2420,7 +2420,7 @@ def strlen(self, name: KeyT) -> ResponseT:
         """
         Return the number of bytes stored in the value of ``name``
 
-        For more information see https://redis.io/commands/strlen
+        For more information, see https://redis.io/commands/strlen
         """
         return self.execute_command("STRLEN", name, keys=[name])
 
@@ -2436,7 +2436,7 @@ def touch(self, *args: KeyT) -> ResponseT:
         Alters the last access time of a key(s) ``*args``. A key is ignored
         if it does not exist.
 
-        For more information see https://redis.io/commands/touch
+        For more information, see https://redis.io/commands/touch
         """
         return self.execute_command("TOUCH", *args)
 
@@ -2444,7 +2444,7 @@ def ttl(self, name: KeyT) -> ResponseT:
         """
         Returns the number of seconds until the key ``name`` will expire
 
-        For more information see https://redis.io/commands/ttl
+        For more information, see https://redis.io/commands/ttl
         """
         return self.execute_command("TTL", name)
 
@@ -2452,7 +2452,7 @@ def type(self, name: KeyT) -> ResponseT:
         """
         Returns the type of key ``name``
 
-        For more information see https://redis.io/commands/type
+        For more information, see https://redis.io/commands/type
         """
         return self.execute_command("TYPE", name, keys=[name])
 
@@ -2460,7 +2460,7 @@ def watch(self, *names: KeyT) -> None:
         """
         Watches the values at keys ``names``, or None if the key doesn't exist
 
-        For more information see https://redis.io/commands/watch
+        For more information, see https://redis.io/commands/watch
         """
         warnings.warn(DeprecationWarning("Call WATCH from a Pipeline object"))
 
@@ -2468,7 +2468,7 @@ def unwatch(self) -> None:
         """
         Unwatches all previously watched keys for a transaction
 
-        For more information see https://redis.io/commands/unwatch
+        For more information, see https://redis.io/commands/unwatch
         """
         warnings.warn(DeprecationWarning("Call UNWATCH from a Pipeline object"))
 
@@ -2476,7 +2476,7 @@ def unlink(self, *names: KeyT) -> ResponseT:
         """
         Unlink one or more keys specified by ``names``
 
-        For more information see https://redis.io/commands/unlink
+        For more information, see https://redis.io/commands/unlink
         """
         return self.execute_command("UNLINK", *names)
 
@@ -2496,7 +2496,7 @@ def lcs(
         ``minmatchlen`` restrict the list of matches to the ones of
         the given ``minmatchlen``.
         If ``withmatchlen`` the length of the match also will be returned.
-        For more information see https://redis.io/commands/lcs
+        For more information, see https://redis.io/commands/lcs
         """
         pieces = [key1, key2]
         if len:
@@ -2549,7 +2549,7 @@ def blpop(
 
         If timeout is 0, then block indefinitely.
 
-        For more information see https://redis.io/commands/blpop
+        For more information, see https://redis.io/commands/blpop
         """
         if timeout is None:
             timeout = 0
@@ -2570,7 +2570,7 @@ def brpop(
 
         If timeout is 0, then block indefinitely.
 
-        For more information see https://redis.io/commands/brpop
+        For more information, see https://redis.io/commands/brpop
         """
         if timeout is None:
             timeout = 0
@@ -2589,7 +2589,7 @@ def brpoplpush(
         seconds elapse, whichever is first. A ``timeout`` value of 0 blocks
         forever.
 
-        For more information see https://redis.io/commands/brpoplpush
+        For more information, see https://redis.io/commands/brpoplpush
         """
         if timeout is None:
             timeout = 0
@@ -2610,7 +2610,7 @@ def blmpop(
         When all lists are empty this command blocks the connection until another
         client pushes to it or until the timeout, timeout of 0 blocks indefinitely
 
-        For more information see https://redis.io/commands/blmpop
+        For more information, see https://redis.io/commands/blmpop
         """
         args = [timeout, numkeys, *args, direction, "COUNT", count]
 
@@ -2627,7 +2627,7 @@ def lmpop(
         Pop ``count`` values (default 1) first non-empty list key from the list
         of args provided key names.
 
-        For more information see https://redis.io/commands/lmpop
+        For more information, see https://redis.io/commands/lmpop
         """
         args = [num_keys] + list(args) + [direction]
         if count != 1:
@@ -2644,7 +2644,7 @@ def lindex(
         Negative indexes are supported and will return an item at the
         end of the list
 
-        For more information see https://redis.io/commands/lindex
+        For more information, see https://redis.io/commands/lindex
         """
         return self.execute_command("LINDEX", name, index, keys=[name])
 
@@ -2658,7 +2658,7 @@ def linsert(
         Returns the new length of the list on success or -1 if ``refvalue``
         is not in the list.
 
-        For more information see https://redis.io/commands/linsert
+        For more information, see https://redis.io/commands/linsert
         """
         return self.execute_command("LINSERT", name, where, refvalue, value)
 
@@ -2666,7 +2666,7 @@ def llen(self, name: str) -> Union[Awaitable[int], int]:
         """
         Return the length of the list ``name``
 
-        For more information see https://redis.io/commands/llen
+        For more information, see https://redis.io/commands/llen
         """
         return self.execute_command("LLEN", name, keys=[name])
 
@@ -2682,7 +2682,7 @@ def lpop(
         the list. When provided with the optional ``count`` argument, the reply
         will consist of up to count elements, depending on the list's length.
 
-        For more information see https://redis.io/commands/lpop
+        For more information, see https://redis.io/commands/lpop
         """
         if count is not None:
             return self.execute_command("LPOP", name, count)
@@ -2693,7 +2693,7 @@ def lpush(self, name: str, *values: FieldT) -> Union[Awaitable[int], int]:
         """
         Push ``values`` onto the head of the list ``name``
 
-        For more information see https://redis.io/commands/lpush
+        For more information, see https://redis.io/commands/lpush
         """
         return self.execute_command("LPUSH", name, *values)
 
@@ -2701,7 +2701,7 @@ def lpushx(self, name: str, *values: FieldT) -> Union[Awaitable[int], int]:
         """
         Push ``value`` onto the head of the list ``name`` if ``name`` exists
 
-        For more information see https://redis.io/commands/lpushx
+        For more information, see https://redis.io/commands/lpushx
         """
         return self.execute_command("LPUSHX", name, *values)
 
@@ -2713,7 +2713,7 @@ def lrange(self, name: str, start: int, end: int) -> Union[Awaitable[list], list
         ``start`` and ``end`` can be negative numbers just like
         Python slicing notation
 
-        For more information see https://redis.io/commands/lrange
+        For more information, see https://redis.io/commands/lrange
         """
         return self.execute_command("LRANGE", name, start, end, keys=[name])
 
@@ -2727,7 +2727,7 @@ def lrem(self, name: str, count: int, value: str) -> Union[Awaitable[int], int]:
             count < 0: Remove elements equal to value moving from tail to head.
             count = 0: Remove all elements equal to value.
 
-            For more information see https://redis.io/commands/lrem
+            For more information, see https://redis.io/commands/lrem
         """
         return self.execute_command("LREM", name, count, value)
 
@@ -2735,7 +2735,7 @@ def lset(self, name: str, index: int, value: str) -> Union[Awaitable[str], str]:
         """
         Set element at ``index`` of list ``name`` to ``value``
 
-        For more information see https://redis.io/commands/lset
+        For more information, see https://redis.io/commands/lset
         """
         return self.execute_command("LSET", name, index, value)
 
@@ -2747,7 +2747,7 @@ def ltrim(self, name: str, start: int, end: int) -> Union[Awaitable[str], str]:
         ``start`` and ``end`` can be negative numbers just like
         Python slicing notation
 
-        For more information see https://redis.io/commands/ltrim
+        For more information, see https://redis.io/commands/ltrim
         """
         return self.execute_command("LTRIM", name, start, end)
 
@@ -2763,7 +2763,7 @@ def rpop(
         When provided with the optional ``count`` argument, the reply will
         consist of up to count elements, depending on the list's length.
 
-        For more information see https://redis.io/commands/rpop
+        For more information, see https://redis.io/commands/rpop
         """
         if count is not None:
             return self.execute_command("RPOP", name, count)
@@ -2775,7 +2775,7 @@ def rpoplpush(self, src: str, dst: str) -> Union[Awaitable[str], str]:
         RPOP a value off of the ``src`` list and atomically LPUSH it
         on to the ``dst`` list.  Returns the value.
 
-        For more information see https://redis.io/commands/rpoplpush
+        For more information, see https://redis.io/commands/rpoplpush
         """
         return self.execute_command("RPOPLPUSH", src, dst)
 
@@ -2783,7 +2783,7 @@ def rpush(self, name: str, *values: FieldT) -> Union[Awaitable[int], int]:
         """
         Push ``values`` onto the tail of the list ``name``
 
-        For more information see https://redis.io/commands/rpush
+        For more information, see https://redis.io/commands/rpush
         """
         return self.execute_command("RPUSH", name, *values)
 
@@ -2791,7 +2791,7 @@ def rpushx(self, name: str, *values: str) -> Union[Awaitable[int], int]:
         """
         Push ``value`` onto the tail of the list ``name`` if ``name`` exists
 
-        For more information see https://redis.io/commands/rpushx
+        For more information, see https://redis.io/commands/rpushx
         """
         return self.execute_command("RPUSHX", name, *values)
 
@@ -2826,7 +2826,7 @@ def lpos(
          position(s) of items within the first 1000 entries in the list.
          A ``maxlen`` of 0 (the default) will scan the entire list.
 
-         For more information see https://redis.io/commands/lpos
+         For more information, see https://redis.io/commands/lpos
         """
         pieces: list[EncodableT] = [name, value]
         if rank is not None:
@@ -2875,7 +2875,7 @@ def sort(
             elements, sort will return a list of tuples, each containing the
             values fetched from the arguments to ``get``.
 
-        For more information see https://redis.io/commands/sort
+        For more information, see https://redis.io/commands/sort
         """
         if (start is not None and num is None) or (num is not None and start is None):
             raise DataError("``start`` and ``num`` must both be specified")
@@ -2940,7 +2940,7 @@ def sort_ro(
 
         ``alpha`` allows for sorting lexicographically rather than numerically
 
-        For more information see https://redis.io/commands/sort_ro
+        For more information, see https://redis.io/commands/sort_ro
         """
         return self.sort(
             key, start=start, num=num, by=by, get=get, desc=desc, alpha=alpha
@@ -2978,7 +2978,7 @@ def scan(
             HASH, LIST, SET, STREAM, STRING, ZSET
             Additionally, Redis modules can expose other types as well.
 
-        For more information see https://redis.io/commands/scan
+        For more information, see https://redis.io/commands/scan
         """
         pieces: list[EncodableT] = [cursor]
         if match is not None:
@@ -3032,7 +3032,7 @@ def sscan(
 
         ``count`` allows for hint the minimum number of returns
 
-        For more information see https://redis.io/commands/sscan
+        For more information, see https://redis.io/commands/sscan
         """
         pieces: list[EncodableT] = [name, cursor]
         if match is not None:
@@ -3078,7 +3078,7 @@ def hscan(
 
         ``no_values`` indicates to return only the keys, without values.
 
-        For more information see https://redis.io/commands/hscan
+        For more information, see https://redis.io/commands/hscan
         """
         pieces: list[EncodableT] = [name, cursor]
         if match is not None:
@@ -3134,7 +3134,7 @@ def zscan(
 
         ``score_cast_func`` a callable used to cast the score return value
 
-        For more information see https://redis.io/commands/zscan
+        For more information, see https://redis.io/commands/zscan
         """
         pieces = [name, cursor]
         if match is not None:
@@ -3294,7 +3294,7 @@ def sadd(self, name: KeyT, *values: FieldT) -> Union[Awaitable[int], int]:
         """
         Add ``value(s)`` to set ``name``
 
-        For more information see https://redis.io/commands/sadd
+        For more information, see https://redis.io/commands/sadd
         """
         return self.execute_command("SADD", name, *values)
 
@@ -3302,7 +3302,7 @@ def scard(self, name: KeyT) -> Union[Awaitable[int], int]:
         """
         Return the number of elements in set ``name``
 
-        For more information see https://redis.io/commands/scard
+        For more information, see https://redis.io/commands/scard
         """
         return self.execute_command("SCARD", name, keys=[name])
 
@@ -3310,7 +3310,7 @@ def sdiff(self, keys: List, *args: List) -> Union[Awaitable[list], list]:
         """
         Return the difference of sets specified by ``keys``
 
-        For more information see https://redis.io/commands/sdiff
+        For more information, see https://redis.io/commands/sdiff
         """
         args = list_or_args(keys, args)
         return self.execute_command("SDIFF", *args, keys=args)
@@ -3322,7 +3322,7 @@ def sdiffstore(
         Store the difference of sets specified by ``keys`` into a new
         set named ``dest``.  Returns the number of keys in the new set.
 
-        For more information see https://redis.io/commands/sdiffstore
+        For more information, see https://redis.io/commands/sdiffstore
         """
         args = list_or_args(keys, args)
         return self.execute_command("SDIFFSTORE", dest, *args)
@@ -3331,7 +3331,7 @@ def sinter(self, keys: List, *args: List) -> Union[Awaitable[list], list]:
         """
         Return the intersection of sets specified by ``keys``
 
-        For more information see https://redis.io/commands/sinter
+        For more information, see https://redis.io/commands/sinter
         """
         args = list_or_args(keys, args)
         return self.execute_command("SINTER", *args, keys=args)
@@ -3346,7 +3346,7 @@ def sintercard(
         cardinality reaches limit partway through the computation, the algorithm will
         exit and yield limit as the cardinality
 
-        For more information see https://redis.io/commands/sintercard
+        For more information, see https://redis.io/commands/sintercard
         """
         args = [numkeys, *keys, "LIMIT", limit]
         return self.execute_command("SINTERCARD", *args, keys=keys)
@@ -3358,7 +3358,7 @@ def sinterstore(
         Store the intersection of sets specified by ``keys`` into a new
         set named ``dest``.  Returns the number of keys in the new set.
 
-        For more information see https://redis.io/commands/sinterstore
+        For more information, see https://redis.io/commands/sinterstore
         """
         args = list_or_args(keys, args)
         return self.execute_command("SINTERSTORE", dest, *args)
@@ -3371,7 +3371,7 @@ def sismember(
         - 1 if the value is a member of the set.
         - 0 if the value is not a member of the set or if key does not exist.
 
-        For more information see https://redis.io/commands/sismember
+        For more information, see https://redis.io/commands/sismember
         """
         return self.execute_command("SISMEMBER", name, value, keys=[name])
 
@@ -3379,7 +3379,7 @@ def smembers(self, name: KeyT) -> Union[Awaitable[Set], Set]:
         """
         Return all members of the set ``name``
 
-        For more information see https://redis.io/commands/smembers
+        For more information, see https://redis.io/commands/smembers
         """
         return self.execute_command("SMEMBERS", name, keys=[name])
 
@@ -3395,7 +3395,7 @@ def smismember(
         - 1 if the value is a member of the set.
         - 0 if the value is not a member of the set or if key does not exist.
 
-        For more information see https://redis.io/commands/smismember
+        For more information, see https://redis.io/commands/smismember
         """
         args = list_or_args(values, args)
         return self.execute_command("SMISMEMBER", name, *args, keys=[name])
@@ -3404,7 +3404,7 @@ def smove(self, src: KeyT, dst: KeyT, value: str) -> Union[Awaitable[bool], bool
         """
         Move ``value`` from set ``src`` to set ``dst`` atomically
 
-        For more information see https://redis.io/commands/smove
+        For more information, see https://redis.io/commands/smove
         """
         return self.execute_command("SMOVE", src, dst, value)
 
@@ -3412,7 +3412,7 @@ def spop(self, name: KeyT, count: Optional[int] = None) -> Union[str, List, None
         """
         Remove and return a random member of set ``name``
 
-        For more information see https://redis.io/commands/spop
+        For more information, see https://redis.io/commands/spop
         """
         args = (count is not None) and [count] or []
         return self.execute_command("SPOP", name, *args)
@@ -3427,7 +3427,7 @@ def srandmember(
         members of set ``name``. Note this is only available when running
         Redis 2.6+.
 
-        For more information see https://redis.io/commands/srandmember
+        For more information, see https://redis.io/commands/srandmember
         """
         args = (number is not None) and [number] or []
         return self.execute_command("SRANDMEMBER", name, *args)
@@ -3436,7 +3436,7 @@ def srem(self, name: KeyT, *values: FieldT) -> Union[Awaitable[int], int]:
         """
         Remove ``values`` from set ``name``
 
-        For more information see https://redis.io/commands/srem
+        For more information, see https://redis.io/commands/srem
         """
         return self.execute_command("SREM", name, *values)
 
@@ -3444,7 +3444,7 @@ def sunion(self, keys: List, *args: List) -> Union[Awaitable[List], List]:
         """
         Return the union of sets specified by ``keys``
 
-        For more information see https://redis.io/commands/sunion
+        For more information, see https://redis.io/commands/sunion
         """
         args = list_or_args(keys, args)
         return self.execute_command("SUNION", *args, keys=args)
@@ -3456,7 +3456,7 @@ def sunionstore(
         Store the union of sets specified by ``keys`` into a new
         set named ``dest``.  Returns the number of keys in the new set.
 
-        For more information see https://redis.io/commands/sunionstore
+        For more information, see https://redis.io/commands/sunionstore
         """
         args = list_or_args(keys, args)
         return self.execute_command("SUNIONSTORE", dest, *args)
@@ -3480,7 +3480,7 @@ def xack(self, name: KeyT, groupname: GroupT, *ids: StreamIdT) -> ResponseT:
             groupname: name of the consumer group.
             *ids: message ids to acknowledge.
 
-        For more information see https://redis.io/commands/xack
+        For more information, see https://redis.io/commands/xack
         """
         return self.execute_command("XACK", name, groupname, *ids)
 
@@ -3535,7 +3535,7 @@ def xadd(
             - DELREF: When trimming, removes all references from consumer groups' PEL
             - ACKED: When trimming, only removes entries acknowledged by all consumer groups
 
-        For more information see https://redis.io/commands/xadd
+        For more information, see https://redis.io/commands/xadd
         """
         pieces: list[EncodableT] = []
         if maxlen is not None and minid is not None:
@@ -3595,7 +3595,7 @@ def xautoclaim(
         justid: optional boolean, false by default. Return just an array of IDs
         of messages successfully claimed, without returning the actual message
 
-        For more information see https://redis.io/commands/xautoclaim
+        For more information, see https://redis.io/commands/xautoclaim
         """
         try:
             if int(min_idle_time) < 0:
@@ -3665,7 +3665,7 @@ def xclaim(
         justid: optional boolean, false by default. Return just an array of IDs
         of messages successfully claimed, without returning the actual message
 
-        For more information see https://redis.io/commands/xclaim
+        For more information, see https://redis.io/commands/xclaim
         """
         if not isinstance(min_idle_time, int) or min_idle_time < 0:
             raise DataError("XCLAIM min_idle_time must be a non negative integer")
@@ -3711,7 +3711,7 @@ def xdel(self, name: KeyT, *ids: StreamIdT) -> ResponseT:
             name: name of the stream.
             *ids: message ids to delete.
 
-        For more information see https://redis.io/commands/xdel
+        For more information, see https://redis.io/commands/xdel
         """
         return self.execute_command("XDEL", name, *ids)
 
@@ -3749,7 +3749,7 @@ def xgroup_create(
         groupname: name of the consumer group.
         id: ID of the last item in the stream to consider already delivered.
 
-        For more information see https://redis.io/commands/xgroup-create
+        For more information, see https://redis.io/commands/xgroup-create
         """
         pieces: list[EncodableT] = ["XGROUP CREATE", name, groupname, id]
         if mkstream:
@@ -3770,7 +3770,7 @@ def xgroup_delconsumer(
         groupname: name of the consumer group.
         consumername: name of consumer to delete
 
-        For more information see https://redis.io/commands/xgroup-delconsumer
+        For more information, see https://redis.io/commands/xgroup-delconsumer
         """
         return self.execute_command("XGROUP DELCONSUMER", name, groupname, consumername)
 
@@ -3780,7 +3780,7 @@ def xgroup_destroy(self, name: KeyT, groupname: GroupT) -> ResponseT:
         name: name of the stream.
         groupname: name of the consumer group.
 
-        For more information see https://redis.io/commands/xgroup-destroy
+        For more information, see https://redis.io/commands/xgroup-destroy
         """
         return self.execute_command("XGROUP DESTROY", name, groupname)
 
@@ -3814,7 +3814,7 @@ def xgroup_setid(
         groupname: name of the consumer group.
         id: ID of the last item in the stream to consider already delivered.
 
-        For more information see https://redis.io/commands/xgroup-setid
+        For more information, see https://redis.io/commands/xgroup-setid
         """
         pieces = [name, groupname, id]
         if entries_read is not None:
@@ -3827,7 +3827,7 @@ def xinfo_consumers(self, name: KeyT, groupname: GroupT) -> ResponseT:
         name: name of the stream.
         groupname: name of the consumer group.
 
-        For more information see https://redis.io/commands/xinfo-consumers
+        For more information, see https://redis.io/commands/xinfo-consumers
         """
         return self.execute_command("XINFO CONSUMERS", name, groupname)
 
@@ -3836,7 +3836,7 @@ def xinfo_groups(self, name: KeyT) -> ResponseT:
         Returns general information about the consumer groups of the stream.
         name: name of the stream.
 
-        For more information see https://redis.io/commands/xinfo-groups
+        For more information, see https://redis.io/commands/xinfo-groups
         """
         return self.execute_command("XINFO GROUPS", name)
 
@@ -3846,7 +3846,7 @@ def xinfo_stream(self, name: KeyT, full: bool = False) -> ResponseT:
         name: name of the stream.
         full: optional boolean, false by default. Return full summary
 
-        For more information see https://redis.io/commands/xinfo-stream
+        For more information, see https://redis.io/commands/xinfo-stream
         """
         pieces = [name]
         options = {}
@@ -3859,7 +3859,7 @@ def xlen(self, name: KeyT) -> ResponseT:
         """
         Returns the number of elements in a given stream.
 
-        For more information see https://redis.io/commands/xlen
+        For more information, see https://redis.io/commands/xlen
         """
         return self.execute_command("XLEN", name, keys=[name])
 
@@ -3869,7 +3869,7 @@ def xpending(self, name: KeyT, groupname: GroupT) -> ResponseT:
         name: name of the stream.
         groupname: name of the consumer group.
 
-        For more information see https://redis.io/commands/xpending
+        For more information, see https://redis.io/commands/xpending
         """
         return self.execute_command("XPENDING", name, groupname, keys=[name])
 
@@ -3951,7 +3951,7 @@ def xrange(
         count: if set, only return this many items, beginning with the
                earliest available.
 
-        For more information see https://redis.io/commands/xrange
+        For more information, see https://redis.io/commands/xrange
         """
         pieces = [min, max]
         if count is not None:
@@ -3979,7 +3979,7 @@ def xread(
 
         block: number of milliseconds to wait, if nothing already present.
 
-        For more information see https://redis.io/commands/xread
+        For more information, see https://redis.io/commands/xread
         """
         pieces = []
         if block is not None:
@@ -4025,7 +4025,7 @@ def xreadgroup(
         block: number of milliseconds to wait, if nothing already present.
         noack: do not add messages to the PEL
 
-        For more information see https://redis.io/commands/xreadgroup
+        For more information, see https://redis.io/commands/xreadgroup
         """
         pieces: list[EncodableT] = [b"GROUP", groupname, consumername]
         if count is not None:
@@ -4068,7 +4068,7 @@ def xrevrange(
         count: if set, only return this many items, beginning with the
                latest available.
 
-        For more information see https://redis.io/commands/xrevrange
+        For more information, see https://redis.io/commands/xrevrange
         """
         pieces: list[EncodableT] = [max, min]
         if count is not None:
@@ -4102,7 +4102,7 @@ def xtrim(
             - DELREF: Trims entries and removes all references from consumer groups' PEL
             - ACKED: Only trims entries that were read and acknowledged by all consumer groups
 
-        For more information see https://redis.io/commands/xtrim
+        For more information, see https://redis.io/commands/xtrim
         """
         pieces: list[EncodableT] = []
         if maxlen is not None and minid is not None:
@@ -4223,7 +4223,7 @@ def zcard(self, name: KeyT) -> ResponseT:
         """
         Return the number of elements in the sorted set ``name``
 
-        For more information see https://redis.io/commands/zcard
+        For more information, see https://redis.io/commands/zcard
         """
         return self.execute_command("ZCARD", name, keys=[name])
 
@@ -4232,7 +4232,7 @@ def zcount(self, name: KeyT, min: ZScoreBoundT, max: ZScoreBoundT) -> ResponseT:
         Returns the number of elements in the sorted set at key ``name`` with
         a score between ``min`` and ``max``.
 
-        For more information see https://redis.io/commands/zcount
+        For more information, see https://redis.io/commands/zcount
         """
         return self.execute_command("ZCOUNT", name, min, max, keys=[name])
 
@@ -4241,7 +4241,7 @@ def zdiff(self, keys: KeysT, withscores: bool = False) -> ResponseT:
         Returns the difference between the first and all successive input
         sorted sets provided in ``keys``.
 
-        For more information see https://redis.io/commands/zdiff
+        For more information, see https://redis.io/commands/zdiff
         """
         pieces = [len(keys), *keys]
         if withscores:
@@ -4253,7 +4253,7 @@ def zdiffstore(self, dest: KeyT, keys: KeysT) -> ResponseT:
         Computes the difference between the first and all successive input
         sorted sets provided in ``keys`` and stores the result in ``dest``.
 
-        For more information see https://redis.io/commands/zdiffstore
+        For more information, see https://redis.io/commands/zdiffstore
         """
         pieces = [len(keys), *keys]
         return self.execute_command("ZDIFFSTORE", dest, *pieces)
@@ -4262,7 +4262,7 @@ def zincrby(self, name: KeyT, amount: float, value: EncodableT) -> ResponseT:
         """
         Increment the score of ``value`` in sorted set ``name`` by ``amount``
 
-        For more information see https://redis.io/commands/zincrby
+        For more information, see https://redis.io/commands/zincrby
         """
         return self.execute_command("ZINCRBY", name, amount, value)
 
@@ -4278,7 +4278,7 @@ def zinter(
         set will contain the minimum or maximum score of an element across
         the inputs where it exists.
 
-        For more information see https://redis.io/commands/zinter
+        For more information, see https://redis.io/commands/zinter
         """
         return self._zaggregate("ZINTER", None, keys, aggregate, withscores=withscores)
 
@@ -4297,7 +4297,7 @@ def zinterstore(
         contain the minimum or maximum score of an element across the inputs
         where it exists.
 
-        For more information see https://redis.io/commands/zinterstore
+        For more information, see https://redis.io/commands/zinterstore
         """
         return self._zaggregate("ZINTERSTORE", dest, keys, aggregate)
 
@@ -4311,7 +4311,7 @@ def zintercard(
         cardinality reaches limit partway through the computation, the algorithm will
         exit and yield limit as the cardinality
 
-        For more information see https://redis.io/commands/zintercard
+        For more information, see https://redis.io/commands/zintercard
         """
         args = [numkeys, *keys, "LIMIT", limit]
         return self.execute_command("ZINTERCARD", *args, keys=keys)
@@ -4321,7 +4321,7 @@ def zlexcount(self, name, min, max):
         Return the number of items in the sorted set ``name`` between the
         lexicographical range ``min`` and ``max``.
 
-        For more information see https://redis.io/commands/zlexcount
+        For more information, see https://redis.io/commands/zlexcount
         """
         return self.execute_command("ZLEXCOUNT", name, min, max, keys=[name])
 
@@ -4330,7 +4330,7 @@ def zpopmax(self, name: KeyT, count: Optional[int] = None) -> ResponseT:
         Remove and return up to ``count`` members with the highest scores
         from the sorted set ``name``.
 
-        For more information see https://redis.io/commands/zpopmax
+        For more information, see https://redis.io/commands/zpopmax
         """
         args = (count is not None) and [count] or []
         options = {"withscores": True}
@@ -4341,7 +4341,7 @@ def zpopmin(self, name: KeyT, count: Optional[int] = None) -> ResponseT:
         Remove and return up to ``count`` members with the lowest scores
         from the sorted set ``name``.
 
-        For more information see https://redis.io/commands/zpopmin
+        For more information, see https://redis.io/commands/zpopmin
         """
         args = (count is not None) and [count] or []
         options = {"withscores": True}
@@ -4363,7 +4363,7 @@ def zrandmember(
         includes the respective scores of the randomly selected elements from
         the sorted set.
 
-        For more information see https://redis.io/commands/zrandmember
+        For more information, see https://redis.io/commands/zrandmember
         """
         params = []
         if count is not None:
@@ -4384,7 +4384,7 @@ def bzpopmax(self, keys: KeysT, timeout: TimeoutSecT = 0) -> ResponseT:
 
         If timeout is 0, then block indefinitely.
 
-        For more information see https://redis.io/commands/bzpopmax
+        For more information, see https://redis.io/commands/bzpopmax
         """
         if timeout is None:
             timeout = 0
@@ -4403,7 +4403,7 @@ def bzpopmin(self, keys: KeysT, timeout: TimeoutSecT = 0) -> ResponseT:
 
         If timeout is 0, then block indefinitely.
 
-        For more information see https://redis.io/commands/bzpopmin
+        For more information, see https://redis.io/commands/bzpopmin
         """
         if timeout is None:
             timeout = 0
@@ -4422,7 +4422,7 @@ def zmpop(
         """
         Pop ``count`` values (default 1) off of the first non-empty sorted set
         named in the ``keys`` list.
-        For more information see https://redis.io/commands/zmpop
+        For more information, see https://redis.io/commands/zmpop
         """
         args = [num_keys] + keys
         if (min and max) or (not min and not max):
@@ -4455,7 +4455,7 @@ def bzmpop(
 
         If timeout is 0, then block indefinitely.
 
-        For more information see https://redis.io/commands/bzmpop
+        For more information, see https://redis.io/commands/bzmpop
         """
         args = [timeout, numkeys, *keys]
         if (min and max) or (not min and not max):
@@ -4548,7 +4548,7 @@ def zrange(
         ``offset`` and ``num`` are specified, then return a slice of the range.
         Can't be provided when using ``bylex``.
 
-        For more information see https://redis.io/commands/zrange
+        For more information, see https://redis.io/commands/zrange
         """
         # Need to support ``desc`` also when using old redis version
         # because it was supported in 3.5.3 (of redis-py)
@@ -4589,7 +4589,7 @@ def zrevrange(
 
         ``score_cast_func`` a callable used to cast the score return value
 
-        For more information see https://redis.io/commands/zrevrange
+        For more information, see https://redis.io/commands/zrevrange
         """
         pieces = ["ZREVRANGE", name, start, end]
         if withscores:
@@ -4631,7 +4631,7 @@ def zrangestore(
         ``offset`` and ``num`` are specified, then return a slice of the range.
         Can't be provided when using ``bylex``.
 
-        For more information see https://redis.io/commands/zrangestore
+        For more information, see https://redis.io/commands/zrangestore
         """
         return self._zrange(
             "ZRANGESTORE",
@@ -4663,7 +4663,7 @@ def zrangebylex(
         If ``start`` and ``num`` are specified, then return a slice of the
         range.
 
-        For more information see https://redis.io/commands/zrangebylex
+        For more information, see https://redis.io/commands/zrangebylex
         """
         if (start is not None and num is None) or (num is not None and start is None):
             raise DataError("``start`` and ``num`` must both be specified")
@@ -4687,7 +4687,7 @@ def zrevrangebylex(
         If ``start`` and ``num`` are specified, then return a slice of the
         range.
 
-        For more information see https://redis.io/commands/zrevrangebylex
+        For more information, see https://redis.io/commands/zrevrangebylex
         """
         if (start is not None and num is None) or (num is not None and start is None):
             raise DataError("``start`` and ``num`` must both be specified")
@@ -4718,7 +4718,7 @@ def zrangebyscore(
 
         `score_cast_func`` a callable used to cast the score return value
 
-        For more information see https://redis.io/commands/zrangebyscore
+        For more information, see https://redis.io/commands/zrangebyscore
         """
         if (start is not None and num is None) or (num is not None and start is None):
             raise DataError("``start`` and ``num`` must both be specified")
@@ -4753,7 +4753,7 @@ def zrevrangebyscore(
 
         ``score_cast_func`` a callable used to cast the score return value
 
-        For more information see https://redis.io/commands/zrevrangebyscore
+        For more information, see https://redis.io/commands/zrevrangebyscore
         """
         if (start is not None and num is None) or (num is not None and start is None):
             raise DataError("``start`` and ``num`` must both be specified")
@@ -4778,7 +4778,7 @@ def zrank(
         The optional WITHSCORE argument supplements the command's
         reply with the score of the element returned.
 
-        For more information see https://redis.io/commands/zrank
+        For more information, see https://redis.io/commands/zrank
         """
         if withscore:
             return self.execute_command("ZRANK", name, value, "WITHSCORE", keys=[name])
@@ -4788,7 +4788,7 @@ def zrem(self, name: KeyT, *values: FieldT) -> ResponseT:
         """
         Remove member ``values`` from sorted set ``name``
 
-        For more information see https://redis.io/commands/zrem
+        For more information, see https://redis.io/commands/zrem
         """
         return self.execute_command("ZREM", name, *values)
 
@@ -4799,7 +4799,7 @@ def zremrangebylex(self, name: KeyT, min: EncodableT, max: EncodableT) -> Respon
 
         Returns the number of elements removed.
 
-        For more information see https://redis.io/commands/zremrangebylex
+        For more information, see https://redis.io/commands/zremrangebylex
         """
         return self.execute_command("ZREMRANGEBYLEX", name, min, max)
 
@@ -4810,7 +4810,7 @@ def zremrangebyrank(self, name: KeyT, min: int, max: int) -> ResponseT:
         to largest. Values can be negative indicating the highest scores.
         Returns the number of elements removed
 
-        For more information see https://redis.io/commands/zremrangebyrank
+        For more information, see https://redis.io/commands/zremrangebyrank
         """
         return self.execute_command("ZREMRANGEBYRANK", name, min, max)
 
@@ -4821,7 +4821,7 @@ def zremrangebyscore(
         Remove all elements in the sorted set ``name`` with scores
         between ``min`` and ``max``. Returns the number of elements removed.
 
-        For more information see https://redis.io/commands/zremrangebyscore
+        For more information, see https://redis.io/commands/zremrangebyscore
         """
         return self.execute_command("ZREMRANGEBYSCORE", name, min, max)
 
@@ -4837,7 +4837,7 @@ def zrevrank(
         The optional ``withscore`` argument supplements the command's
         reply with the score of the element returned.
 
-        For more information see https://redis.io/commands/zrevrank
+        For more information, see https://redis.io/commands/zrevrank
         """
         if withscore:
             return self.execute_command(
@@ -4849,7 +4849,7 @@ def zscore(self, name: KeyT, value: EncodableT) -> ResponseT:
         """
         Return the score of element ``value`` in sorted set ``name``
 
-        For more information see https://redis.io/commands/zscore
+        For more information, see https://redis.io/commands/zscore
         """
         return self.execute_command("ZSCORE", name, value, keys=[name])
 
@@ -4865,7 +4865,7 @@ def zunion(
         Scores will be aggregated based on the ``aggregate``, or SUM if
         none is provided.
 
-        For more information see https://redis.io/commands/zunion
+        For more information, see https://redis.io/commands/zunion
         """
         return self._zaggregate("ZUNION", None, keys, aggregate, withscores=withscores)
 
@@ -4880,7 +4880,7 @@ def zunionstore(
         a new sorted set, ``dest``. Scores in the destination will be
         aggregated based on the ``aggregate``, or SUM if none is provided.
 
-        For more information see https://redis.io/commands/zunionstore
+        For more information, see https://redis.io/commands/zunionstore
         """
         return self._zaggregate("ZUNIONSTORE", dest, keys, aggregate)
 
@@ -4893,7 +4893,7 @@ def zmscore(self, key: KeyT, members: List[str]) -> ResponseT:
         If the member does not exist, a None will be returned
         in corresponding position.
 
-        For more information see https://redis.io/commands/zmscore
+        For more information, see https://redis.io/commands/zmscore
         """
         if not members:
             raise DataError("ZMSCORE members must be a non-empty list")
@@ -4945,7 +4945,7 @@ def pfadd(self, name: KeyT, *values: FieldT) -> ResponseT:
         """
         Adds the specified elements to the specified HyperLogLog.
 
-        For more information see https://redis.io/commands/pfadd
+        For more information, see https://redis.io/commands/pfadd
         """
         return self.execute_command("PFADD", name, *values)
 
@@ -4954,7 +4954,7 @@ def pfcount(self, *sources: KeyT) -> ResponseT:
         Return the approximated cardinality of
         the set observed by the HyperLogLog at key(s).
 
-        For more information see https://redis.io/commands/pfcount
+        For more information, see https://redis.io/commands/pfcount
         """
         return self.execute_command("PFCOUNT", *sources)
 
@@ -4962,7 +4962,7 @@ def pfmerge(self, dest: KeyT, *sources: KeyT) -> ResponseT:
         """
         Merge N different HyperLogLogs into a single one.
 
-        For more information see https://redis.io/commands/pfmerge
+        For more information, see https://redis.io/commands/pfmerge
         """
         return self.execute_command("PFMERGE", dest, *sources)
 
@@ -4990,7 +4990,7 @@ def hdel(self, name: str, *keys: str) -> Union[Awaitable[int], int]:
         """
         Delete ``keys`` from hash ``name``
 
-        For more information see https://redis.io/commands/hdel
+        For more information, see https://redis.io/commands/hdel
         """
         return self.execute_command("HDEL", name, *keys)
 
@@ -4998,7 +4998,7 @@ def hexists(self, name: str, key: str) -> Union[Awaitable[bool], bool]:
         """
         Returns a boolean indicating if ``key`` exists within hash ``name``
 
-        For more information see https://redis.io/commands/hexists
+        For more information, see https://redis.io/commands/hexists
         """
         return self.execute_command("HEXISTS", name, key, keys=[name])
 
@@ -5008,7 +5008,7 @@ def hget(
         """
         Return the value of ``key`` within the hash ``name``
 
-        For more information see https://redis.io/commands/hget
+        For more information, see https://redis.io/commands/hget
         """
         return self.execute_command("HGET", name, key, keys=[name])
 
@@ -5016,7 +5016,7 @@ def hgetall(self, name: str) -> Union[Awaitable[dict], dict]:
         """
         Return a Python dict of the hash's name/value pairs
 
-        For more information see https://redis.io/commands/hgetall
+        For more information, see https://redis.io/commands/hgetall
         """
         return self.execute_command("HGETALL", name, keys=[name])
 
@@ -5032,7 +5032,7 @@ def hgetdel(
         the key on success from the hash with the provided ```name```.
 
         Available since Redis 8.0
-        For more information see https://redis.io/commands/hgetdel
+        For more information, see https://redis.io/commands/hgetdel
         """
         if len(keys) == 0:
             raise DataError("'hgetdel' should have at least one key provided")
@@ -5068,7 +5068,7 @@ def hgetex(
         ``persist`` remove the time to live associated with the ``keys``.
 
         Available since Redis 8.0
-        For more information see https://redis.io/commands/hgetex
+        For more information, see https://redis.io/commands/hgetex
         """
         if not keys:
             raise DataError("'hgetex' should have at least one key provided")
@@ -5100,7 +5100,7 @@ def hincrby(
         """
         Increment the value of ``key`` in hash ``name`` by ``amount``
 
-        For more information see https://redis.io/commands/hincrby
+        For more information, see https://redis.io/commands/hincrby
         """
         return self.execute_command("HINCRBY", name, key, amount)
 
@@ -5110,7 +5110,7 @@ def hincrbyfloat(
         """
         Increment the value of ``key`` in hash ``name`` by floating ``amount``
 
-        For more information see https://redis.io/commands/hincrbyfloat
+        For more information, see https://redis.io/commands/hincrbyfloat
         """
         return self.execute_command("HINCRBYFLOAT", name, key, amount)
 
@@ -5118,7 +5118,7 @@ def hkeys(self, name: str) -> Union[Awaitable[List], List]:
         """
         Return the list of keys within hash ``name``
 
-        For more information see https://redis.io/commands/hkeys
+        For more information, see https://redis.io/commands/hkeys
         """
         return self.execute_command("HKEYS", name, keys=[name])
 
@@ -5126,7 +5126,7 @@ def hlen(self, name: str) -> Union[Awaitable[int], int]:
         """
         Return the number of elements in hash ``name``
 
-        For more information see https://redis.io/commands/hlen
+        For more information, see https://redis.io/commands/hlen
         """
         return self.execute_command("HLEN", name, keys=[name])
 
@@ -5146,7 +5146,7 @@ def hset(
         added to hash ``name``.
         Returns the number of fields that were added.
 
-        For more information see https://redis.io/commands/hset
+        For more information, see https://redis.io/commands/hset
         """
 
         if key is None and not mapping and not items:
@@ -5208,7 +5208,7 @@ def hsetex(
         Returns the number of fields that were added.
 
         Available since Redis 8.0
-        For more information see https://redis.io/commands/hsetex
+        For more information, see https://redis.io/commands/hsetex
         """
         if key is None and not mapping and not items:
             raise DataError("'hsetex' with no key value pairs")
@@ -5251,7 +5251,7 @@ def hsetnx(self, name: str, key: str, value: str) -> Union[Awaitable[bool], bool
         Set ``key`` to ``value`` within hash ``name`` if ``key`` does not
         exist.  Returns 1 if HSETNX created a field, otherwise 0.
 
-        For more information see https://redis.io/commands/hsetnx
+        For more information, see https://redis.io/commands/hsetnx
         """
         return self.execute_command("HSETNX", name, key, value)
 
@@ -5265,7 +5265,7 @@ def hmset(self, name: str, mapping: dict) -> Union[Awaitable[str], str]:
         Set key to value within hash ``name`` for each corresponding
         key and value from the ``mapping`` dict.
 
-        For more information see https://redis.io/commands/hmset
+        For more information, see https://redis.io/commands/hmset
         """
         if not mapping:
             raise DataError("'hmset' with 'mapping' of length 0")
@@ -5278,7 +5278,7 @@ def hmget(self, name: str, keys: List, *args: List) -> Union[Awaitable[List], Li
         """
         Returns a list of values ordered identically to ``keys``
 
-        For more information see https://redis.io/commands/hmget
+        For more information, see https://redis.io/commands/hmget
         """
         args = list_or_args(keys, args)
         return self.execute_command("HMGET", name, *args, keys=[name])
@@ -5287,7 +5287,7 @@ def hvals(self, name: str) -> Union[Awaitable[List], List]:
         """
         Return the list of values within hash ``name``
 
-        For more information see https://redis.io/commands/hvals
+        For more information, see https://redis.io/commands/hvals
         """
         return self.execute_command("HVALS", name, keys=[name])
 
@@ -5296,7 +5296,7 @@ def hstrlen(self, name: str, key: str) -> Union[Awaitable[int], int]:
         Return the number of bytes stored in the value of ``key``
         within hash ``name``
 
-        For more information see https://redis.io/commands/hstrlen
+        For more information, see https://redis.io/commands/hstrlen
         """
         return self.execute_command("HSTRLEN", name, key, keys=[name])
 
@@ -5790,7 +5790,7 @@ def publish(self, channel: ChannelT, message: EncodableT, **kwargs) -> ResponseT
         Publish ``message`` on ``channel``.
         Returns the number of subscribers the message was delivered to.
 
-        For more information see https://redis.io/commands/publish
+        For more information, see https://redis.io/commands/publish
         """
         return self.execute_command("PUBLISH", channel, message, **kwargs)
 
@@ -5799,7 +5799,7 @@ def spublish(self, shard_channel: ChannelT, message: EncodableT) -> ResponseT:
         Posts a message to the given shard channel.
         Returns the number of clients that received the message
 
-        For more information see https://redis.io/commands/spublish
+        For more information, see https://redis.io/commands/spublish
         """
         return self.execute_command("SPUBLISH", shard_channel, message)
 
@@ -5807,7 +5807,7 @@ def pubsub_channels(self, pattern: PatternT = "*", **kwargs) -> ResponseT:
         """
         Return a list of channels that have at least one subscriber
 
-        For more information see https://redis.io/commands/pubsub-channels
+        For more information, see https://redis.io/commands/pubsub-channels
         """
         return self.execute_command("PUBSUB CHANNELS", pattern, **kwargs)
 
@@ -5815,7 +5815,7 @@ def pubsub_shardchannels(self, pattern: PatternT = "*", **kwargs) -> ResponseT:
         """
         Return a list of shard_channels that have at least one subscriber
 
-        For more information see https://redis.io/commands/pubsub-shardchannels
+        For more information, see https://redis.io/commands/pubsub-shardchannels
         """
         return self.execute_command("PUBSUB SHARDCHANNELS", pattern, **kwargs)
 
@@ -5823,7 +5823,7 @@ def pubsub_numpat(self, **kwargs) -> ResponseT:
         """
         Returns the number of subscriptions to patterns
 
-        For more information see https://redis.io/commands/pubsub-numpat
+        For more information, see https://redis.io/commands/pubsub-numpat
         """
         return self.execute_command("PUBSUB NUMPAT", **kwargs)
 
@@ -5832,7 +5832,7 @@ def pubsub_numsub(self, *args: ChannelT, **kwargs) -> ResponseT:
         Return a list of (channel, number of subscribers) tuples
         for each channel given in ``*args``
 
-        For more information see https://redis.io/commands/pubsub-numsub
+        For more information, see https://redis.io/commands/pubsub-numsub
         """
         return self.execute_command("PUBSUB NUMSUB", *args, **kwargs)
 
@@ -5841,7 +5841,7 @@ def pubsub_shardnumsub(self, *args: ChannelT, **kwargs) -> ResponseT:
         Return a list of (shard_channel, number of subscribers) tuples
         for each channel given in ``*args``
 
-        For more information see https://redis.io/commands/pubsub-shardnumsub
+        For more information, see https://redis.io/commands/pubsub-shardnumsub
         """
         return self.execute_command("PUBSUB SHARDNUMSUB", *args, **kwargs)
 
@@ -5871,7 +5871,7 @@ def eval(
         In practice, use the object returned by ``register_script``. This
         function exists purely for Redis API completion.
 
-        For more information see  https://redis.io/commands/eval
+        For more information, see  https://redis.io/commands/eval
         """
         return self._eval("EVAL", script, numkeys, *keys_and_args)
 
@@ -5885,7 +5885,7 @@ def eval_ro(
         will touch and the key names and argument values in ``keys_and_args``.
         Returns the result of the script.
 
-        For more information see  https://redis.io/commands/eval_ro
+        For more information, see  https://redis.io/commands/eval_ro
         """
         return self._eval("EVAL_RO", script, numkeys, *keys_and_args)
 
@@ -5906,7 +5906,7 @@ def evalsha(
         In practice, use the object returned by ``register_script``. This
         function exists purely for Redis API completion.
 
-        For more information see  https://redis.io/commands/evalsha
+        For more information, see  https://redis.io/commands/evalsha
         """
         return self._evalsha("EVALSHA", sha, numkeys, *keys_and_args)
 
@@ -5921,7 +5921,7 @@ def evalsha_ro(
         key names and argument values in ``keys_and_args``. Returns the result
         of the script.
 
-        For more information see  https://redis.io/commands/evalsha_ro
+        For more information, see  https://redis.io/commands/evalsha_ro
         """
         return self._evalsha("EVALSHA_RO", sha, numkeys, *keys_and_args)
 
@@ -5931,7 +5931,7 @@ def script_exists(self, *args: str) -> ResponseT:
         each script as ``args``. Returns a list of boolean values indicating if
         if each already script exists in the cache_data.
 
-        For more information see  https://redis.io/commands/script-exists
+        For more information, see  https://redis.io/commands/script-exists
         """
         return self.execute_command("SCRIPT EXISTS", *args)
 
@@ -5948,7 +5948,7 @@ def script_flush(
         ``sync_type`` is by default SYNC (synchronous) but it can also be
                       ASYNC.
 
-        For more information see  https://redis.io/commands/script-flush
+        For more information, see  https://redis.io/commands/script-flush
         """
 
         # Redis pre 6 had no sync_type.
@@ -5968,7 +5968,7 @@ def script_kill(self) -> ResponseT:
         """
         Kill the currently executing Lua script
 
-        For more information see https://redis.io/commands/script-kill
+        For more information, see https://redis.io/commands/script-kill
         """
         return self.execute_command("SCRIPT KILL")
 
@@ -5976,7 +5976,7 @@ def script_load(self, script: ScriptTextT) -> ResponseT:
         """
         Load a Lua ``script`` into the script cache_data. Returns the SHA.
 
-        For more information see https://redis.io/commands/script-load
+        For more information, see https://redis.io/commands/script-load
         """
         return self.execute_command("SCRIPT LOAD", script)
 
@@ -6039,7 +6039,7 @@ def geoadd(
         Changed elements include new elements that were added and elements
         whose scores changed.
 
-        For more information see https://redis.io/commands/geoadd
+        For more information, see https://redis.io/commands/geoadd
         """
         if nx and xx:
             raise DataError("GEOADD allows either 'nx' or 'xx', not both")
@@ -6064,7 +6064,7 @@ def geodist(
         The units must be one of the following : m, km mi, ft. By default
         meters are used.
 
-        For more information see https://redis.io/commands/geodist
+        For more information, see https://redis.io/commands/geodist
         """
         pieces: list[EncodableT] = [name, place1, place2]
         if unit and unit not in ("m", "km", "mi", "ft"):
@@ -6078,7 +6078,7 @@ def geohash(self, name: KeyT, *values: FieldT) -> ResponseT:
         Return the geo hash string for each item of ``values`` members of
         the specified key identified by the ``name`` argument.
 
-        For more information see https://redis.io/commands/geohash
+        For more information, see https://redis.io/commands/geohash
         """
         return self.execute_command("GEOHASH", name, *values, keys=[name])
 
@@ -6088,7 +6088,7 @@ def geopos(self, name: KeyT, *values: FieldT) -> ResponseT:
         the specified key identified by the ``name`` argument. Each position
         is represented by the pairs lon and lat.
 
-        For more information see https://redis.io/commands/geopos
+        For more information, see https://redis.io/commands/geopos
         """
         return self.execute_command("GEOPOS", name, *values, keys=[name])
 
@@ -6136,7 +6136,7 @@ def georadius(
         named with a specific key, instead of ``store`` the sorted set
         destination score is set with the distance.
 
-        For more information see https://redis.io/commands/georadius
+        For more information, see https://redis.io/commands/georadius
         """
         return self._georadiusgeneric(
             "GEORADIUS",
@@ -6176,7 +6176,7 @@ def georadiusbymember(
         and latitude value, it takes the name of a member already existing
         inside the geospatial index represented by the sorted set.
 
-        For more information see https://redis.io/commands/georadiusbymember
+        For more information, see https://redis.io/commands/georadiusbymember
         """
         return self._georadiusgeneric(
             "GEORADIUSBYMEMBER",
@@ -6298,7 +6298,7 @@ def geosearch(
 
         ``withhash`` indicates to return the geohash string of each place.
 
-        For more information see https://redis.io/commands/geosearch
+        For more information, see https://redis.io/commands/geosearch
         """
 
         return self._geosearchgeneric(
@@ -6345,7 +6345,7 @@ def geosearchstore(
         items in a sorted set populated with their distance from the
         center of the circle or box, as a floating-point number.
 
-        For more information see https://redis.io/commands/geosearchstore
+        For more information, see https://redis.io/commands/geosearchstore
         """
         return self._geosearchgeneric(
             "GEOSEARCHSTORE",
@@ -6450,7 +6450,7 @@ def module_load(self, path, *args) -> ResponseT:
         Passes all ``*args`` to the module, during loading.
         Raises ``ModuleError`` if a module is not found at ``path``.
 
-        For more information see https://redis.io/commands/module-load
+        For more information, see https://redis.io/commands/module-load
         """
         return self.execute_command("MODULE LOAD", path, *args)
 
@@ -6463,7 +6463,7 @@ def module_loadex(
         """
         Loads a module from a dynamic library at runtime with configuration directives.
 
-        For more information see https://redis.io/commands/module-loadex
+        For more information, see https://redis.io/commands/module-loadex
         """
         pieces = []
         if options is not None:
@@ -6480,7 +6480,7 @@ def module_unload(self, name) -> ResponseT:
         Unloads the module ``name``.
         Raises ``ModuleError`` if ``name`` is not in loaded modules.
 
-        For more information see https://redis.io/commands/module-unload
+        For more information, see https://redis.io/commands/module-unload
         """
         return self.execute_command("MODULE UNLOAD", name)
 
@@ -6489,7 +6489,7 @@ def module_list(self) -> ResponseT:
         Returns a list of dictionaries containing the name and version of
         all loaded modules.
 
-        For more information see https://redis.io/commands/module-list
+        For more information, see https://redis.io/commands/module-list
         """
         return self.execute_command("MODULE LIST")
 
@@ -6525,7 +6525,7 @@ def readwrite(self, **kwargs) -> ResponseT:
         """
         Disables read queries for a connection to a Redis Cluster slave node.
 
-        For more information see https://redis.io/commands/readwrite
+        For more information, see https://redis.io/commands/readwrite
         """
         return self.execute_command("READWRITE", **kwargs)
 
@@ -6533,7 +6533,7 @@ def readonly(self, **kwargs) -> ResponseT:
         """
         Enables read queries for a connection to a Redis Cluster replica node.
 
-        For more information see https://redis.io/commands/readonly
+        For more information, see https://redis.io/commands/readonly
         """
         return self.execute_command("READONLY", **kwargs)
 
@@ -6557,7 +6557,7 @@ def function_load(
         with the new contents.
         Return the library name that was loaded.
 
-        For more information see https://redis.io/commands/function-load
+        For more information, see https://redis.io/commands/function-load
         """
         pieces = ["REPLACE"] if replace else []
         pieces.append(code)
@@ -6567,7 +6567,7 @@ def function_delete(self, library: str) -> Union[Awaitable[str], str]:
         """
         Delete the library called ``library`` and all its functions.
 
-        For more information see https://redis.io/commands/function-delete
+        For more information, see https://redis.io/commands/function-delete
         """
         return self.execute_command("FUNCTION DELETE", library)
 
@@ -6575,7 +6575,7 @@ def function_flush(self, mode: str = "SYNC") -> Union[Awaitable[str], str]:
         """
         Deletes all the libraries.
 
-        For more information see https://redis.io/commands/function-flush
+        For more information, see https://redis.io/commands/function-flush
         """
         return self.execute_command("FUNCTION FLUSH", mode)
 
@@ -6607,7 +6607,7 @@ def fcall(
         """
         Invoke a function.
 
-        For more information see https://redis.io/commands/fcall
+        For more information, see https://redis.io/commands/fcall
         """
         return self._fcall("FCALL", function, numkeys, *keys_and_args)
 
@@ -6618,7 +6618,7 @@ def fcall_ro(
         This is a read-only variant of the FCALL command that cannot
         execute commands that modify data.
 
-        For more information see https://redis.io/commands/fcall_ro
+        For more information, see https://redis.io/commands/fcall_ro
         """
         return self._fcall("FCALL_RO", function, numkeys, *keys_and_args)
 
@@ -6626,7 +6626,7 @@ def function_dump(self) -> Union[Awaitable[str], str]:
         """
         Return the serialized payload of loaded libraries.
 
-        For more information see https://redis.io/commands/function-dump
+        For more information, see https://redis.io/commands/function-dump
         """
         from redis.client import NEVER_DECODE
 
@@ -6643,7 +6643,7 @@ def function_restore(
         You can use the optional policy argument to provide a policy
         for handling existing libraries.
 
-        For more information see https://redis.io/commands/function-restore
+        For more information, see https://redis.io/commands/function-restore
         """
         return self.execute_command("FUNCTION RESTORE", payload, policy)
 
@@ -6651,7 +6651,7 @@ def function_kill(self) -> Union[Awaitable[str], str]:
         """
         Kill a function that is currently executing.
 
-        For more information see https://redis.io/commands/function-kill
+        For more information, see https://redis.io/commands/function-kill
         """
         return self.execute_command("FUNCTION KILL")
 
@@ -6660,7 +6660,7 @@ def function_stats(self) -> Union[Awaitable[List], List]:
         Return information about the function that's currently running
         and information about the available execution engines.
 
-        For more information see https://redis.io/commands/function-stats
+        For more information, see https://redis.io/commands/function-stats
         """
         return self.execute_command("FUNCTION STATS")
 

From fe54bc5985dcbad5c7e4648ab2b48f68220532c2 Mon Sep 17 00:00:00 2001
From: Hunter Hogan <hunterhogan@users.noreply.github.com>
Date: Thu, 7 Aug 2025 08:48:10 -0500
Subject: [PATCH 1103/1164] Typos in cluster.py (#3717)

---
 redis/cluster.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index 4b971cf86d..a51fe9c722 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -2716,8 +2716,8 @@ def send_cluster_commands(
 
         If one of the retryable exceptions has been thrown we assume that:
          - connection_pool was disconnected
-         - connection_pool was reseted
-         - refereh_table_asap set to True
+         - connection_pool was reset
+         - refresh_table_asap set to True
 
         It will try the number of times specified by
         the retries in config option "self.retry"

From 78c354ac522ea56d56fe943820739dc099ab9840 Mon Sep 17 00:00:00 2001
From: VincentHokie <VincentHokie@users.noreply.github.com>
Date: Thu, 7 Aug 2025 17:31:44 +0200
Subject: [PATCH 1104/1164] Support the customization of the timeout parameter
 when using a blocking connection pool with a redis cluster (#3724)

---
 redis/cluster.py      |  1 +
 tests/test_cluster.py | 16 ++++++++++++++++
 2 files changed, 17 insertions(+)

diff --git a/redis/cluster.py b/redis/cluster.py
index a51fe9c722..7c645be755 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -170,6 +170,7 @@ def parse_cluster_myshardid(resp, **options):
     "redis_connect_func",
     "password",
     "port",
+    "timeout",
     "queue_class",
     "retry",
     "retry_on_timeout",
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 4883ba66c9..2936bb0024 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -783,6 +783,22 @@ def on_connect(connection):
         _get_client(RedisCluster, request, redis_connect_func=mock)
         assert mock.called is True
 
+    def test_user_connection_pool_timeout(self, request):
+        """
+        Test support in passing timeout value by the user when setting
+        up a RedisCluster with a BlockingConnectionPool
+        """
+
+        timeout = 3
+        client = _get_client(
+            RedisCluster,
+            request,
+            timeout=timeout,
+            connection_pool_class=redis.BlockingConnectionPool,
+        )
+        for _, node_config in client.nodes_manager.startup_nodes.items():
+            assert node_config.redis_connection.connection_pool.timeout == timeout
+
     def test_set_default_node_success(self, r):
         """
         test successful replacement of the default cluster node

From 808350529181518b4caed97bae5d8aea4e307c5f Mon Sep 17 00:00:00 2001
From: Hunter Hogan <hunterhogan@users.noreply.github.com>
Date: Thu, 7 Aug 2025 12:23:13 -0500
Subject: [PATCH 1105/1164] Fixing typos in query.py (#3718)

---
 redis/commands/search/query.py | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/redis/commands/search/query.py b/redis/commands/search/query.py
index a8312a2ad2..ee281fafd0 100644
--- a/redis/commands/search/query.py
+++ b/redis/commands/search/query.py
@@ -9,7 +9,7 @@ class Query:
     the query string. The query string is set in the constructor, and other
     options have setter functions.
 
-    The setter functions return the query object, so they can be chained,
+    The setter functions return the query object so they can be chained.
     i.e. `Query("foo").verbatim().filter(...)` etc.
     """
 
@@ -95,12 +95,12 @@ def summarize(
     ) -> "Query":
         """
         Return an abridged format of the field, containing only the segments of
-        the field which contain the matching term(s).
+        the field that contain the matching term(s).
 
         If `fields` is specified, then only the mentioned fields are
-        summarized; otherwise all results are summarized.
+        summarized; otherwise, all results are summarized.
 
-        Server side defaults are used for each option (except `fields`)
+        Server-side defaults are used for each option (except `fields`)
         if not specified
 
         - **fields** List of fields to summarize. All fields are summarized
@@ -130,7 +130,7 @@ def highlight(
         """
         Apply specified markup to matched term(s) within the returned field(s).
 
-        - **fields** If specified then only those mentioned fields are
+        - **fields** If specified, then only those mentioned fields are
         highlighted, otherwise all fields are highlighted
         - **tags** A list of two strings to surround the match.
         """
@@ -154,7 +154,7 @@ def language(self, language: str) -> "Query":
         return self
 
     def slop(self, slop: int) -> "Query":
-        """Allow a maximum of N intervening non matched terms between
+        """Allow a maximum of N intervening non-matched terms between
         phrase terms (0 means exact phrase).
         """
         self._slop = slop
@@ -169,7 +169,7 @@ def in_order(self) -> "Query":
         """
         Match only documents where the query terms appear in
         the same order in the document.
-        i.e. for the query "hello world", we do not match "world hello"
+        i.e., for the query "hello world", we do not match "world hello"
         """
         self._in_order = True
         return self
@@ -258,7 +258,7 @@ def paging(self, offset: int, num: int) -> "Query":
         return self
 
     def verbatim(self) -> "Query":
-        """Set the query to be verbatim, i.e. use no query expansion
+        """Set the query to be verbatim, i.e., use no query expansion
         or stemming.
         """
         self._verbatim = True
@@ -292,7 +292,7 @@ def limit_fields(self, *fields: List[str]) -> "Query":
         """
         Limit the search to specific TEXT fields only.
 
-        - **fields**: A list of strings, case sensitive field names
+        - **fields**: A list of strings; case-sensitive field names
         from the defined schema.
         """
         self._fields = fields
@@ -301,7 +301,7 @@ def limit_fields(self, *fields: List[str]) -> "Query":
     def add_filter(self, flt: "Filter") -> "Query":
         """
         Add a numeric or geo filter to the query.
-        **Currently only one of each filter is supported by the engine**
+        **Currently, only one of each filter is supported by the engine**
 
         - **flt**: A NumericFilter or GeoFilter object, used on a
         corresponding field
@@ -315,14 +315,14 @@ def sort_by(self, field: str, asc: bool = True) -> "Query":
         Add a sortby field to the query.
 
         - **field** - the name of the field to sort by
-        - **asc** - when `True`, sorting will be done in asceding order
+        - **asc** - when `True`, sorting will be done in ascending order
         """
         self._sortby = SortbyField(field, asc)
         return self
 
     def expander(self, expander: str) -> "Query":
         """
-        Add a expander field to the query.
+        Add an expander field to the query.
 
         - **expander** - the name of the expander
         """

From 2d0c9ba189bbd8730779b380c994f210a78a7d3b Mon Sep 17 00:00:00 2001
From: mengxun <30499307+mengxunQAQ@users.noreply.github.com>
Date: Tue, 12 Aug 2025 17:55:11 +0800
Subject: [PATCH 1106/1164] Remove unused parse_list_to_dict function from
 helpers (#3733)

---
 redis/commands/helpers.py | 20 --------------------
 1 file changed, 20 deletions(-)

diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
index 859a43aea9..8fd2b9527e 100644
--- a/redis/commands/helpers.py
+++ b/redis/commands/helpers.py
@@ -72,26 +72,6 @@ def parse_to_list(response):
     return res
 
 
-def parse_list_to_dict(response):
-    res = {}
-    for i in range(0, len(response), 2):
-        if isinstance(response[i], list):
-            res["Child iterators"].append(parse_list_to_dict(response[i]))
-            try:
-                if isinstance(response[i + 1], list):
-                    res["Child iterators"].append(parse_list_to_dict(response[i + 1]))
-            except IndexError:
-                pass
-        elif isinstance(response[i + 1], list):
-            res["Child iterators"] = [parse_list_to_dict(response[i + 1])]
-        else:
-            try:
-                res[response[i]] = float(response[i + 1])
-            except (TypeError, ValueError):
-                res[response[i]] = response[i + 1]
-    return res
-
-
 def random_string(length=10):
     """
     Returns a random N character long string.

From 60fd6f98bfc33bcf777a891c38e07b6808ab32e2 Mon Sep 17 00:00:00 2001
From: Hunter Hogan <hunterhogan@users.noreply.github.com>
Date: Tue, 12 Aug 2025 06:22:06 -0500
Subject: [PATCH 1107/1164] Typos in vectorset commands.py (#3719)

* Typos in commands.py

* Correct URL in vectorset commands.py
---
 redis/commands/vectorset/commands.py | 30 ++++++++++++++--------------
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/redis/commands/vectorset/commands.py b/redis/commands/vectorset/commands.py
index 0f23dba10d..6123b3e7f5 100644
--- a/redis/commands/vectorset/commands.py
+++ b/redis/commands/vectorset/commands.py
@@ -77,7 +77,7 @@ def vadd(
         ``numlinks`` sets the number of links to create for the vector.
                 If not provided, the default number of links is used.
 
-        For more information see https://redis.io/commands/vadd
+        For more information, see https://redis.io/commands/vadd.
         """
         if not vector or not element:
             raise DataError("Both vector and element must be provided")
@@ -144,11 +144,11 @@ def vsim(
 
         ``ef`` sets the exploration factor.
 
-        ``filter`` sets filter that should be applied for the search.
+        ``filter`` sets the filter that should be applied for the search.
 
         ``filter_ef`` sets the max filtering effort.
 
-        ``truth`` when enabled forces the command to perform linear scan.
+        ``truth`` when enabled, forces the command to perform a linear scan.
 
         ``no_thread`` when enabled forces the command to execute the search
                 on the data structure in the main thread.
@@ -156,7 +156,7 @@ def vsim(
         ``epsilon`` floating point between 0 and 1, if specified will return
                 only elements with distance no further than the specified one.
 
-        For more information see https://redis.io/commands/vsim
+        For more information, see https://redis.io/commands/vsim.
         """
 
         if not input:
@@ -210,7 +210,7 @@ def vdim(self, key: KeyT) -> Union[Awaitable[int], int]:
 
         Raises `redis.exceptions.ResponseError` if the vector set doesn't exist.
 
-        For more information see https://redis.io/commands/vdim
+        For more information, see https://redis.io/commands/vdim.
         """
         return self.execute_command(VDIM_CMD, key)
 
@@ -220,7 +220,7 @@ def vcard(self, key: KeyT) -> Union[Awaitable[int], int]:
 
         Raises `redis.exceptions.ResponseError` if the vector set doesn't exist.
 
-        For more information see https://redis.io/commands/vcard
+        For more information, see https://redis.io/commands/vcard.
         """
         return self.execute_command(VCARD_CMD, key)
 
@@ -228,7 +228,7 @@ def vrem(self, key: KeyT, element: str) -> Union[Awaitable[int], int]:
         """
         Remove an element from a vector set.
 
-        For more information see https://redis.io/commands/vrem
+        For more information, see https://redis.io/commands/vrem.
         """
         return self.execute_command(VREM_CMD, key, element)
 
@@ -242,10 +242,10 @@ def vemb(
         Get the approximated vector of an element ``element`` from vector set ``key``.
 
         ``raw`` is a boolean flag that indicates whether to return the
-                interal representation used by the vector.
+                internal representation used by the vector.
 
 
-        For more information see https://redis.io/commands/vembed
+        For more information, see https://redis.io/commands/vemb.
         """
         options = {}
         pieces = []
@@ -293,7 +293,7 @@ def vlinks(
         If the ``WITHSCORES`` option is provided, the result is a list of dicts,
         where each dict contains the neighbors for one level, with the scores as values.
 
-        For more information see https://redis.io/commands/vlinks
+        For more information, see https://redis.io/commands/vlinks
         """
         options = {}
         pieces = []
@@ -309,7 +309,7 @@ def vinfo(self, key: KeyT) -> Union[Awaitable[dict], dict]:
         """
         Get information about a vector set.
 
-        For more information see https://redis.io/commands/vinfo
+        For more information, see https://redis.io/commands/vinfo.
         """
         return self.execute_command(VINFO_CMD, key)
 
@@ -320,7 +320,7 @@ def vsetattr(
         Associate or remove JSON attributes ``attributes`` of element ``element``
         for vector set ``key``.
 
-        For more information see https://redis.io/commands/vsetattr
+        For more information, see https://redis.io/commands/vsetattr
         """
         if attributes is None:
             attributes_json = "{}"
@@ -336,12 +336,12 @@ def vgetattr(
         self, key: KeyT, element: str
     ) -> Union[Optional[Awaitable[dict]], Optional[dict]]:
         """
-        Retrieve the JSON attributes of an element ``elemet`` for vector set ``key``.
+        Retrieve the JSON attributes of an element ``element `` for vector set ``key``.
 
         If the element does not exist, or if the vector set does not exist, None is
         returned.
 
-        For more information see https://redis.io/commands/vgetattr
+        For more information, see https://redis.io/commands/vgetattr.
         """
         return self.execute_command(VGETATTR_CMD, key, element)
 
@@ -365,7 +365,7 @@ def vrandmember(
 
         If the vector set does not exist, ``None`` is returned.
 
-        For more information see https://redis.io/commands/vrandmember
+        For more information, see https://redis.io/commands/vrandmember.
         """
         pieces = []
         pieces.append(key)

From 349d761a5b5c6096ec4ec5c531c5483cc15e8d6b Mon Sep 17 00:00:00 2001
From: mengxun <30499307+mengxunQAQ@users.noreply.github.com>
Date: Tue, 12 Aug 2025 22:25:01 +0800
Subject: [PATCH 1108/1164] Adding abstractmethod declaration for cache
 property setter in EvictionPolicyInterface(#3732)

---
 redis/cache.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/redis/cache.py b/redis/cache.py
index 9971edd256..cb29ffe785 100644
--- a/redis/cache.py
+++ b/redis/cache.py
@@ -50,6 +50,7 @@ def cache(self):
         pass
 
     @cache.setter
+    @abstractmethod
     def cache(self, value):
         pass
 

From 688c2b0aa78c6aaae3b8dc932e217f3adf0f553a Mon Sep 17 00:00:00 2001
From: Andrew Brookins <a.m.brookins@gmail.com>
Date: Fri, 15 Aug 2025 01:18:56 -0700
Subject: [PATCH 1109/1164] Fix async clients safety when used as an async
 context manager (#3512)

* Fix async safety when Redis client is used as an async context manager

When the async Redis client is used as an async context manager and
called from different corotuines, one coroutine can exit, shutting
down the client's connection pool, while another coroutine is
attempting to use a connection. This results in a connection error,
such as:

redis.exceptions.ConnectionError: Connection closed by server.

Additional locking in `ConnectionPool` resolves the problem but
introduces extreme latency due to the locking. Instead, this PR
implements a shielded counter that increments as callers enter the async
context manager and decrements when they exit. The client then closes
its connection pool only after all active contexts exit.

Performance is on par with use of the client without a context manager.
---
 CONTRIBUTING.md                          |  4 ++
 redis/asyncio/client.py                  | 47 ++++++++++++++++++++++-
 redis/asyncio/cluster.py                 | 49 ++++++++++++++++++++++--
 tests/test_asyncio/test_usage_counter.py | 16 ++++++++
 4 files changed, 111 insertions(+), 5 deletions(-)
 create mode 100644 tests/test_asyncio/test_usage_counter.py

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index eb333f644f..f9b53ac4b6 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -81,6 +81,10 @@ using `invoke standalone-tests`; similarly, RedisCluster tests can be run by usi
 Each run of tests starts and stops the various dockers required. Sometimes
 things get stuck, an `invoke clean` can help.
 
+## Linting
+
+Call `invoke linters` to run linters without also running tests.
+
 ## Documentation
 
 If relevant, update the code documentation, via docstrings, or in `/docs`.
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index aac409073f..d4650e1791 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -387,6 +387,12 @@ def __init__(
         # on a set of redis commands
         self._single_conn_lock = asyncio.Lock()
 
+        # When used as an async context manager, we need to increment and decrement
+        # a usage counter so that we can close the connection pool when no one is
+        # using the client.
+        self._usage_counter = 0
+        self._usage_lock = asyncio.Lock()
+
     def __repr__(self):
         return (
             f"<{self.__class__.__module__}.{self.__class__.__name__}"
@@ -594,10 +600,47 @@ def client(self) -> "Redis":
         )
 
     async def __aenter__(self: _RedisT) -> _RedisT:
-        return await self.initialize()
+        """
+        Async context manager entry. Increments a usage counter so that the
+        connection pool is only closed (via aclose()) when no context is using
+        the client.
+        """
+        await self._increment_usage()
+        try:
+            # Initialize the client (i.e. establish connection, etc.)
+            return await self.initialize()
+        except Exception:
+            # If initialization fails, decrement the counter to keep it in sync
+            await self._decrement_usage()
+            raise
+
+    async def _increment_usage(self) -> int:
+        """
+        Helper coroutine to increment the usage counter while holding the lock.
+        Returns the new value of the usage counter.
+        """
+        async with self._usage_lock:
+            self._usage_counter += 1
+            return self._usage_counter
+
+    async def _decrement_usage(self) -> int:
+        """
+        Helper coroutine to decrement the usage counter while holding the lock.
+        Returns the new value of the usage counter.
+        """
+        async with self._usage_lock:
+            self._usage_counter -= 1
+            return self._usage_counter
 
     async def __aexit__(self, exc_type, exc_value, traceback):
-        await self.aclose()
+        """
+        Async context manager exit. Decrements a usage counter. If this is the
+        last exit (counter becomes zero), the client closes its connection pool.
+        """
+        current_usage = await asyncio.shield(self._decrement_usage())
+        if current_usage == 0:
+            # This was the last active context, so disconnect the pool.
+            await asyncio.shield(self.aclose())
 
     _DEL_MESSAGE = "Unclosed Redis client"
 
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index e8434d04a5..dd68f388b2 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -431,6 +431,12 @@ def __init__(
         self._initialize = True
         self._lock: Optional[asyncio.Lock] = None
 
+        # When used as an async context manager, we need to increment and decrement
+        # a usage counter so that we can close the connection pool when no one is
+        # using the client.
+        self._usage_counter = 0
+        self._usage_lock = asyncio.Lock()
+
     async def initialize(self) -> "RedisCluster":
         """Get all nodes from startup nodes & creates connections if not initialized."""
         if self._initialize:
@@ -467,10 +473,47 @@ async def close(self) -> None:
         await self.aclose()
 
     async def __aenter__(self) -> "RedisCluster":
-        return await self.initialize()
+        """
+        Async context manager entry. Increments a usage counter so that the
+        connection pool is only closed (via aclose()) when no context is using
+        the client.
+        """
+        await self._increment_usage()
+        try:
+            # Initialize the client (i.e. establish connection, etc.)
+            return await self.initialize()
+        except Exception:
+            # If initialization fails, decrement the counter to keep it in sync
+            await self._decrement_usage()
+            raise
 
-    async def __aexit__(self, exc_type: None, exc_value: None, traceback: None) -> None:
-        await self.aclose()
+    async def _increment_usage(self) -> int:
+        """
+        Helper coroutine to increment the usage counter while holding the lock.
+        Returns the new value of the usage counter.
+        """
+        async with self._usage_lock:
+            self._usage_counter += 1
+            return self._usage_counter
+
+    async def _decrement_usage(self) -> int:
+        """
+        Helper coroutine to decrement the usage counter while holding the lock.
+        Returns the new value of the usage counter.
+        """
+        async with self._usage_lock:
+            self._usage_counter -= 1
+            return self._usage_counter
+
+    async def __aexit__(self, exc_type, exc_value, traceback):
+        """
+        Async context manager exit. Decrements a usage counter. If this is the
+        last exit (counter becomes zero), the client closes its connection pool.
+        """
+        current_usage = await asyncio.shield(self._decrement_usage())
+        if current_usage == 0:
+            # This was the last active context, so disconnect the pool.
+            await asyncio.shield(self.aclose())
 
     def __await__(self) -> Generator[Any, None, "RedisCluster"]:
         return self.initialize().__await__()
diff --git a/tests/test_asyncio/test_usage_counter.py b/tests/test_asyncio/test_usage_counter.py
new file mode 100644
index 0000000000..566ec6b4d3
--- /dev/null
+++ b/tests/test_asyncio/test_usage_counter.py
@@ -0,0 +1,16 @@
+import asyncio
+
+import pytest
+
+
+@pytest.mark.asyncio
+async def test_usage_counter(r):
+    async def dummy_task():
+        async with r:
+            await asyncio.sleep(0.01)
+
+    tasks = [dummy_task() for _ in range(20)]
+    await asyncio.gather(*tasks)
+
+    # After all tasks have completed, the usage counter should be back to zero.
+    assert r._usage_counter == 0

From 78fb85e0a839f5a95b7b9e478dc004816ec8a67d Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 21 Aug 2025 16:02:12 +0300
Subject: [PATCH 1110/1164] Update Redis image versions for GH pipeline
 actions. (#3740)

---
 .github/workflows/integration.yaml | 6 +++---
 docker-compose.yml                 | 4 ++--
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 43766b072b..4046763250 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -27,8 +27,8 @@ env:
   CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
   # this speeds up coverage with Python 3.12: https://github.com/nedbat/coveragepy/issues/1665
   COVERAGE_CORE: sysmon
-  CURRENT_CLIENT_LIBS_TEST_STACK_IMAGE_TAG: '8.0.2'
-  CURRENT_REDIS_VERSION: '8.0.2'
+  CURRENT_CLIENT_LIBS_TEST_STACK_IMAGE_TAG: '8.2'
+  CURRENT_REDIS_VERSION: '8.2'
 
 jobs:
   dependency-audit:
@@ -74,7 +74,7 @@ jobs:
       max-parallel: 15
       fail-fast: false
       matrix:
-        redis-version: ['8.2', '${{ needs.redis_version.outputs.CURRENT }}', '7.4.4', '7.2.9']
+        redis-version: ['8.2.1-pre', '${{ needs.redis_version.outputs.CURRENT }}', '8.0.2' ,'7.4.4', '7.2.9']
         python-version: ['3.9', '3.13']
         parser-backend: ['plain']
         event-loop: ['asyncio']
diff --git a/docker-compose.yml b/docker-compose.yml
index 1428e6f96b..46c70ba5a9 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,10 +1,10 @@
 ---
 # image tag 8.0-RC2-pre is the one matching the 8.0 GA release
 x-client-libs-stack-image: &client-libs-stack-image
-  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_STACK_IMAGE_TAG:-8.0.2}"
+  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_STACK_IMAGE_TAG:-8.2}"
 
 x-client-libs-image: &client-libs-image
-  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_IMAGE_TAG:-8.0.2}"
+  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_IMAGE_TAG:-8.2}"
 
 services:
 

From d24c9c9a00139c6d1baa477cc9f84570416b4b82 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 21 Aug 2025 21:38:31 +0300
Subject: [PATCH 1111/1164] Adding WITHATTRIBS option to vector set's vsim
 command. (#3746)

---
 redis/commands/vectorset/__init__.py |   2 +-
 redis/commands/vectorset/commands.py |  38 ++++++---
 redis/commands/vectorset/utils.py    |  44 ++++++++++-
 tests/test_asyncio/test_vsets.py     | 114 ++++++++++++++++++++++++++-
 tests/test_vsets.py                  | 112 +++++++++++++++++++++++++-
 5 files changed, 293 insertions(+), 17 deletions(-)

diff --git a/redis/commands/vectorset/__init__.py b/redis/commands/vectorset/__init__.py
index d78580a73b..590f238370 100644
--- a/redis/commands/vectorset/__init__.py
+++ b/redis/commands/vectorset/__init__.py
@@ -24,12 +24,12 @@ def __init__(self, client, **kwargs):
         # Set the module commands' callbacks
         self._MODULE_CALLBACKS = {
             VEMB_CMD: parse_vemb_result,
+            VSIM_CMD: parse_vsim_result,
             VGETATTR_CMD: lambda r: r and json.loads(r) or None,
         }
 
         self._RESP2_MODULE_CALLBACKS = {
             VINFO_CMD: lambda r: r and pairs_to_dict(r) or None,
-            VSIM_CMD: parse_vsim_result,
             VLINKS_CMD: parse_vlinks_result,
         }
         self._RESP3_MODULE_CALLBACKS = {}
diff --git a/redis/commands/vectorset/commands.py b/redis/commands/vectorset/commands.py
index 6123b3e7f5..4ef769d71f 100644
--- a/redis/commands/vectorset/commands.py
+++ b/redis/commands/vectorset/commands.py
@@ -1,6 +1,6 @@
 import json
 from enum import Enum
-from typing import Awaitable, Dict, List, Optional, Union
+from typing import Any, Awaitable, Dict, List, Optional, Union
 
 from redis.client import NEVER_DECODE
 from redis.commands.helpers import get_protocol_version
@@ -19,6 +19,15 @@
 VGETATTR_CMD = "VGETATTR"
 VRANDMEMBER_CMD = "VRANDMEMBER"
 
+# Return type for vsim command
+VSimResult = Optional[
+    List[
+        Union[
+            List[EncodableT], Dict[EncodableT, Number], Dict[EncodableT, Dict[str, Any]]
+        ]
+    ]
+]
+
 
 class QuantizationOptions(Enum):
     """Quantization options for the VADD command."""
@@ -33,6 +42,7 @@ class CallbacksOptions(Enum):
 
     RAW = "RAW"
     WITHSCORES = "WITHSCORES"
+    WITHATTRIBS = "WITHATTRIBS"
     ALLOW_DECODING = "ALLOW_DECODING"
     RESP3 = "RESP3"
 
@@ -123,6 +133,7 @@ def vsim(
         key: KeyT,
         input: Union[List[float], bytes, str],
         with_scores: Optional[bool] = False,
+        with_attribs: Optional[bool] = False,
         count: Optional[int] = None,
         ef: Optional[Number] = None,
         filter: Optional[str] = None,
@@ -130,15 +141,14 @@ def vsim(
         truth: Optional[bool] = False,
         no_thread: Optional[bool] = False,
         epsilon: Optional[Number] = None,
-    ) -> Union[
-        Awaitable[Optional[List[Union[List[EncodableT], Dict[EncodableT, Number]]]]],
-        Optional[List[Union[List[EncodableT], Dict[EncodableT, Number]]]],
-    ]:
+    ) -> Union[Awaitable[VSimResult], VSimResult]:
         """
         Compare a vector or element ``input``  with the other vectors in a vector set ``key``.
 
-        ``with_scores`` sets if the results should be returned with the
-                similarity scores of the elements in the result.
+        ``with_scores`` sets if similarity scores should be returned for each element in the result.
+
+        ``with_attribs`` ``with_attribs`` sets if the results should be returned with the
+                attributes of the elements in the result, or None when no attributes are present.
 
         ``count`` sets the number of results to return.
 
@@ -173,9 +183,17 @@ def vsim(
         else:
             pieces.extend(["ELE", input])
 
-        if with_scores:
-            pieces.append("WITHSCORES")
-            options[CallbacksOptions.WITHSCORES.value] = True
+        if with_scores or with_attribs:
+            if get_protocol_version(self.client) in ["3", 3]:
+                options[CallbacksOptions.RESP3.value] = True
+
+            if with_scores:
+                pieces.append("WITHSCORES")
+                options[CallbacksOptions.WITHSCORES.value] = True
+
+            if with_attribs:
+                pieces.append("WITHATTRIBS")
+                options[CallbacksOptions.WITHATTRIBS.value] = True
 
         if count:
             pieces.extend(["COUNT", count])
diff --git a/redis/commands/vectorset/utils.py b/redis/commands/vectorset/utils.py
index ed6d194ae0..61ad1eba51 100644
--- a/redis/commands/vectorset/utils.py
+++ b/redis/commands/vectorset/utils.py
@@ -1,3 +1,5 @@
+import json
+
 from redis._parsers.helpers import pairs_to_dict
 from redis.commands.vectorset.commands import CallbacksOptions
 
@@ -75,19 +77,53 @@ def parse_vsim_result(response, **options):
     structures depending on input options.
     Parsing VSIM result into:
     - List[List[str]]
-    - List[Dict[str, Number]]
+    - List[Dict[str, Number]] - when with_scores is used (without attributes)
+    - List[Dict[str, Mapping[str, Any]]] - when with_attribs is used (without scores)
+    - List[Dict[str, Union[Number, Mapping[str, Any]]]] - when with_scores and with_attribs are used
+
     """
     if response is None:
         return response
 
-    if options.get(CallbacksOptions.WITHSCORES.value):
+    withscores = bool(options.get(CallbacksOptions.WITHSCORES.value))
+    withattribs = bool(options.get(CallbacksOptions.WITHATTRIBS.value))
+
+    # Exactly one of withscores or withattribs is True
+    if (withscores and not withattribs) or (not withscores and withattribs):
         # Redis will return a list of list of pairs.
         # This list have to be transformed to dict
         result_dict = {}
-        for key, value in pairs_to_dict(response).items():
-            value = float(value)
+        if options.get(CallbacksOptions.RESP3.value):
+            resp_dict = response
+        else:
+            resp_dict = pairs_to_dict(response)
+        for key, value in resp_dict.items():
+            if withscores:
+                value = float(value)
+            else:
+                value = json.loads(value) if value else None
+
             result_dict[key] = value
         return result_dict
+    elif withscores and withattribs:
+        it = iter(response)
+        result_dict = {}
+        if options.get(CallbacksOptions.RESP3.value):
+            for elem, data in response.items():
+                if data[1] is not None:
+                    attribs_dict = json.loads(data[1])
+                else:
+                    attribs_dict = None
+                result_dict[elem] = {"score": data[0], "attributes": attribs_dict}
+        else:
+            for elem, score, attribs in zip(it, it, it):
+                if attribs is not None:
+                    attribs_dict = json.loads(attribs)
+                else:
+                    attribs_dict = None
+
+                result_dict[elem] = {"score": float(score), "attributes": attribs_dict}
+        return result_dict
     else:
         # return the list of elements for each level
         # list of lists
diff --git a/tests/test_asyncio/test_vsets.py b/tests/test_asyncio/test_vsets.py
index 8294d8aff4..e2b2bc1d4f 100644
--- a/tests/test_asyncio/test_vsets.py
+++ b/tests/test_asyncio/test_vsets.py
@@ -262,6 +262,80 @@ async def test_vsim_with_scores(d_client):
     assert 0 <= vsim["elem1"] <= 1
 
 
+@skip_if_server_version_lt("8.2.0")
+async def test_vsim_with_attribs_attribs_set(d_client):
+    elements_count = 5
+    vector_dim = 10
+    attrs_dict = {"key1": "value1", "key2": "value2"}
+    for i in range(elements_count):
+        float_array = [random.uniform(0, 5) for x in range(vector_dim)]
+        await d_client.vset().vadd(
+            "myset",
+            float_array,
+            f"elem{i}",
+            numlinks=64,
+            attributes=attrs_dict if i % 2 == 0 else None,
+        )
+
+    vsim = await d_client.vset().vsim("myset", input="elem1", with_attribs=True)
+    assert len(vsim) == 5
+    assert isinstance(vsim, dict)
+    assert vsim["elem1"] is None
+    assert vsim["elem2"] == attrs_dict
+
+
+@skip_if_server_version_lt("8.2.0")
+async def test_vsim_with_scores_and_attribs_attribs_set(d_client):
+    elements_count = 5
+    vector_dim = 10
+    attrs_dict = {"key1": "value1", "key2": "value2"}
+    for i in range(elements_count):
+        float_array = [random.uniform(0, 5) for x in range(vector_dim)]
+        await d_client.vset().vadd(
+            "myset",
+            float_array,
+            f"elem{i}",
+            numlinks=64,
+            attributes=attrs_dict if i % 2 == 0 else None,
+        )
+
+    vsim = await d_client.vset().vsim(
+        "myset", input="elem1", with_scores=True, with_attribs=True
+    )
+    assert len(vsim) == 5
+    assert isinstance(vsim, dict)
+    assert isinstance(vsim["elem1"], dict)
+    assert "score" in vsim["elem1"]
+    assert "attributes" in vsim["elem1"]
+    assert isinstance(vsim["elem1"]["score"], float)
+    assert vsim["elem1"]["attributes"] is None
+
+    assert isinstance(vsim["elem2"], dict)
+    assert "score" in vsim["elem2"]
+    assert "attributes" in vsim["elem2"]
+    assert isinstance(vsim["elem2"]["score"], float)
+    assert vsim["elem2"]["attributes"] == attrs_dict
+
+
+@skip_if_server_version_lt("8.2.0")
+async def test_vsim_with_attribs_attribs_not_set(d_client):
+    elements_count = 20
+    vector_dim = 50
+    for i in range(elements_count):
+        float_array = [random.uniform(0, 10) for x in range(vector_dim)]
+        await d_client.vset().vadd(
+            "myset",
+            float_array,
+            f"elem{i}",
+            numlinks=64,
+        )
+
+    vsim = await d_client.vset().vsim("myset", input="elem1", with_attribs=True)
+    assert len(vsim) == 10
+    assert isinstance(vsim, dict)
+    assert vsim["elem1"] is None
+
+
 @skip_if_server_version_lt("7.9.0")
 async def test_vsim_with_different_vector_input_types(d_client):
     elements_count = 10
@@ -785,13 +859,51 @@ async def test_vrandmember(d_client):
     assert members_list == []
 
 
+@skip_if_server_version_lt("8.2.0")
+async def test_8_2_new_vset_features_without_decoding_responces(client):
+    # test vadd
+    elements = ["elem1", "elem2", "elem3"]
+    attrs_dict = {"key1": "value1", "key2": "value2"}
+    for elem in elements:
+        float_array = [random.uniform(0.5, 10) for x in range(0, 8)]
+        resp = await client.vset().vadd(
+            "myset", float_array, element=elem, attributes=attrs_dict
+        )
+        assert resp == 1
+
+    # test vsim with attributes
+    vsim_with_attribs = await client.vset().vsim(
+        "myset", input="elem1", with_attribs=True
+    )
+    assert len(vsim_with_attribs) == 3
+    assert isinstance(vsim_with_attribs, dict)
+    assert isinstance(vsim_with_attribs[b"elem1"], dict)
+    assert vsim_with_attribs[b"elem1"] == attrs_dict
+
+    # test vsim with score and attributes
+    vsim_with_scores_and_attribs = await client.vset().vsim(
+        "myset", input="elem1", with_scores=True, with_attribs=True
+    )
+    assert len(vsim_with_scores_and_attribs) == 3
+    assert isinstance(vsim_with_scores_and_attribs, dict)
+    assert isinstance(vsim_with_scores_and_attribs[b"elem1"], dict)
+    assert "score" in vsim_with_scores_and_attribs[b"elem1"]
+    assert "attributes" in vsim_with_scores_and_attribs[b"elem1"]
+    assert isinstance(vsim_with_scores_and_attribs[b"elem1"]["score"], float)
+    assert isinstance(vsim_with_scores_and_attribs[b"elem1"]["attributes"], dict)
+    assert vsim_with_scores_and_attribs[b"elem1"]["attributes"] == attrs_dict
+
+
 @skip_if_server_version_lt("7.9.0")
 async def test_vset_commands_without_decoding_responces(client):
     # test vadd
     elements = ["elem1", "elem2", "elem3"]
+    attrs_dict = {"key1": "value1", "key2": "value2"}
     for elem in elements:
         float_array = [random.uniform(0.5, 10) for x in range(0, 8)]
-        resp = await client.vset().vadd("myset", float_array, element=elem)
+        resp = await client.vset().vadd(
+            "myset", float_array, element=elem, attributes=attrs_dict
+        )
         assert resp == 1
 
     # test vemb
diff --git a/tests/test_vsets.py b/tests/test_vsets.py
index e212b1b286..cba7115bf1 100644
--- a/tests/test_vsets.py
+++ b/tests/test_vsets.py
@@ -264,6 +264,80 @@ def test_vsim_with_scores(d_client):
     assert 0 <= vsim["elem1"] <= 1
 
 
+@skip_if_server_version_lt("8.2.0")
+def test_vsim_with_attribs_attribs_set(d_client):
+    elements_count = 5
+    vector_dim = 10
+    attrs_dict = {"key1": "value1", "key2": "value2"}
+    for i in range(elements_count):
+        float_array = [random.uniform(0, 5) for x in range(vector_dim)]
+        d_client.vset().vadd(
+            "myset",
+            float_array,
+            f"elem{i}",
+            numlinks=64,
+            attributes=attrs_dict if i % 2 == 0 else None,
+        )
+
+    vsim = d_client.vset().vsim("myset", input="elem1", with_attribs=True)
+    assert len(vsim) == 5
+    assert isinstance(vsim, dict)
+    assert vsim["elem1"] is None
+    assert vsim["elem2"] == attrs_dict
+
+
+@skip_if_server_version_lt("8.2.0")
+def test_vsim_with_scores_and_attribs_attribs_set(d_client):
+    elements_count = 5
+    vector_dim = 10
+    attrs_dict = {"key1": "value1", "key2": "value2"}
+    for i in range(elements_count):
+        float_array = [random.uniform(0, 5) for x in range(vector_dim)]
+        d_client.vset().vadd(
+            "myset",
+            float_array,
+            f"elem{i}",
+            numlinks=64,
+            attributes=attrs_dict if i % 2 == 0 else None,
+        )
+
+    vsim = d_client.vset().vsim(
+        "myset", input="elem1", with_scores=True, with_attribs=True
+    )
+    assert len(vsim) == 5
+    assert isinstance(vsim, dict)
+    assert isinstance(vsim["elem1"], dict)
+    assert "score" in vsim["elem1"]
+    assert "attributes" in vsim["elem1"]
+    assert isinstance(vsim["elem1"]["score"], float)
+    assert vsim["elem1"]["attributes"] is None
+
+    assert isinstance(vsim["elem2"], dict)
+    assert "score" in vsim["elem2"]
+    assert "attributes" in vsim["elem2"]
+    assert isinstance(vsim["elem2"]["score"], float)
+    assert vsim["elem2"]["attributes"] == attrs_dict
+
+
+@skip_if_server_version_lt("8.2.0")
+def test_vsim_with_attribs_attribs_not_set(d_client):
+    elements_count = 20
+    vector_dim = 50
+    for i in range(elements_count):
+        float_array = [random.uniform(0, 10) for x in range(vector_dim)]
+        d_client.vset().vadd(
+            "myset",
+            float_array,
+            f"elem{i}",
+            numlinks=64,
+        )
+
+    vsim = d_client.vset().vsim("myset", input="elem1", with_attribs=True)
+    assert len(vsim) == 10
+    assert isinstance(vsim, dict)
+    assert vsim["elem1"] is None
+
+
 @skip_if_server_version_lt("7.9.0")
 def test_vsim_with_different_vector_input_types(d_client):
     elements_count = 10
@@ -785,13 +859,49 @@ def test_vrandmember(d_client):
     assert members_list == []
 
 
+@skip_if_server_version_lt("8.2.0")
+def test_8_2_new_vset_features_without_decoding_responces(client):
+    # test vadd
+    elements = ["elem1", "elem2", "elem3"]
+    attrs_dict = {"key1": "value1", "key2": "value2"}
+    for elem in elements:
+        float_array = [random.uniform(0.5, 10) for x in range(0, 8)]
+        resp = client.vset().vadd(
+            "myset", float_array, element=elem, attributes=attrs_dict
+        )
+        assert resp == 1
+
+    # test vsim with attributes
+    vsim_with_attribs = client.vset().vsim("myset", input="elem1", with_attribs=True)
+    assert len(vsim_with_attribs) == 3
+    assert isinstance(vsim_with_attribs, dict)
+    assert isinstance(vsim_with_attribs[b"elem1"], dict)
+    assert vsim_with_attribs[b"elem1"] == attrs_dict
+
+    # test vsim with score and attributes
+    vsim_with_scores_and_attribs = client.vset().vsim(
+        "myset", input="elem1", with_scores=True, with_attribs=True
+    )
+    assert len(vsim_with_scores_and_attribs) == 3
+    assert isinstance(vsim_with_scores_and_attribs, dict)
+    assert isinstance(vsim_with_scores_and_attribs[b"elem1"], dict)
+    assert "score" in vsim_with_scores_and_attribs[b"elem1"]
+    assert "attributes" in vsim_with_scores_and_attribs[b"elem1"]
+    assert isinstance(vsim_with_scores_and_attribs[b"elem1"]["score"], float)
+    assert isinstance(vsim_with_scores_and_attribs[b"elem1"]["attributes"], dict)
+    assert vsim_with_scores_and_attribs[b"elem1"]["attributes"] == attrs_dict
+
+
 @skip_if_server_version_lt("7.9.0")
 def test_vset_commands_without_decoding_responces(client):
     # test vadd
     elements = ["elem1", "elem2", "elem3"]
+    attrs_dict = {"key1": "value1", "key2": "value2"}
     for elem in elements:
         float_array = [random.uniform(0.5, 10) for x in range(0, 8)]
-        resp = client.vset().vadd("myset", float_array, element=elem)
+        resp = client.vset().vadd(
+            "myset", float_array, element=elem, attributes=attrs_dict
+        )
         assert resp == 1
 
     # test vemb

From b5a8ef0a681dccd71aeb961023958b6ca66ed965 Mon Sep 17 00:00:00 2001
From: kiryazovi-redis <ivaylo.kiryazov@redis.com>
Date: Mon, 25 Aug 2025 09:41:23 +0300
Subject: [PATCH 1112/1164] Fault injector boilerplate (#3749)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Add fault injector client for Redis Enterprise testing

This commit introduces a comprehensive fault injector client that provides
a Python interface for interacting with Redis Enterprise fault injection
services. The client supports:

- Multiple action types (DMC restart, failover, reshard, network failure)
- Direct rladmin command execution
- Sequence of actions for complex testing scenarios
- Full HTTP API integration with proper error handling
- Debug output for troubleshooting test scenarios

The fault injector client enables automated testing of Redis Enterprise
cluster resilience and failover scenarios, supporting the CAE client
testing framework approach for real enterprise server integration.

* Apply linting fixes to fault injector client

- Fixed whitespace in blank lines (W293)
- Added trailing newline at end of file (W292)
- Applied ruff formatting for consistent code style:
  * Improved line breaks for long function signatures
  * Consistent quote style (single to double quotes)
  * Proper parameter alignment and indentation

All linting checks now pass:
- ruff check: ✅ All checks passed
- ruff format: ✅ Code properly formatted
- vulture: ✅ No dead code detected

* take care of review issues
---
 tests/test_scenario/__init__.py              |   0
 tests/test_scenario/fault_injector_client.py | 105 +++++++++++++++++++
 2 files changed, 105 insertions(+)
 create mode 100644 tests/test_scenario/__init__.py
 create mode 100644 tests/test_scenario/fault_injector_client.py

diff --git a/tests/test_scenario/__init__.py b/tests/test_scenario/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/tests/test_scenario/fault_injector_client.py b/tests/test_scenario/fault_injector_client.py
new file mode 100644
index 0000000000..9cb35b24b6
--- /dev/null
+++ b/tests/test_scenario/fault_injector_client.py
@@ -0,0 +1,105 @@
+import json
+import urllib.request
+from typing import Dict, Any, Optional, Union
+from enum import Enum
+
+
+class ActionType(str, Enum):
+    DMC_RESTART = "dmc_restart"
+    FAILOVER = "failover"
+    RESHARD = "reshard"
+    SEQUENCE_OF_ACTIONS = "sequence_of_actions"
+    NETWORK_FAILURE = "network_failure"
+    EXECUTE_RLUTIL_COMMAND = "execute_rlutil_command"
+    EXECUTE_RLADMIN_COMMAND = "execute_rladmin_command"
+
+
+class RestartDmcParams:
+    def __init__(self, bdb_id: str):
+        self.bdb_id = bdb_id
+
+    def to_dict(self) -> Dict[str, str]:
+        return {"bdb_id": self.bdb_id}
+
+
+class ActionRequest:
+    def __init__(
+        self,
+        action_type: ActionType,
+        parameters: Union[Dict[str, Any], RestartDmcParams],
+    ):
+        self.type = action_type
+        self.parameters = parameters
+
+    def to_dict(self) -> Dict[str, Any]:
+        return {
+            "type": self.type.value,  # Use the string value of the enum
+            "parameters": self.parameters.to_dict()
+            if isinstance(self.parameters, RestartDmcParams)
+            else self.parameters,
+        }
+
+
+class FaultInjectorClient:
+    def __init__(self, base_url: str):
+        self.base_url = base_url.rstrip("/")
+
+    def _make_request(
+        self, method: str, path: str, data: Optional[Dict] = None
+    ) -> Dict[str, Any]:
+        url = f"{self.base_url}{path}"
+        headers = {"Content-Type": "application/json"} if data else {}
+
+        request_data = json.dumps(data).encode("utf-8") if data else None
+
+        request = urllib.request.Request(
+            url, method=method, data=request_data, headers=headers
+        )
+
+        try:
+            with urllib.request.urlopen(request) as response:
+                return json.loads(response.read().decode("utf-8"))
+        except urllib.error.HTTPError as e:
+            if e.code == 422:
+                error_body = json.loads(e.read().decode("utf-8"))
+                raise ValueError(f"Validation Error: {error_body}")
+            raise
+
+    def list_actions(self) -> Dict[str, Any]:
+        """List all available actions"""
+        return self._make_request("GET", "/action")
+
+    def trigger_action(self, action_request: ActionRequest) -> Dict[str, Any]:
+        """Trigger a new action"""
+        request_data = action_request.to_dict()
+        return self._make_request("POST", "/action", request_data)
+
+    def get_action_status(self, action_id: str) -> Dict[str, Any]:
+        """Get the status of a specific action"""
+        return self._make_request("GET", f"/action/{action_id}")
+
+    def execute_rladmin_command(
+        self, command: str, bdb_id: str = None
+    ) -> Dict[str, Any]:
+        """Execute rladmin command directly as string"""
+        url = f"{self.base_url}/rladmin"
+
+        # The fault injector expects the raw command string
+        command_string = f"rladmin {command}"
+        if bdb_id:
+            command_string = f"rladmin -b {bdb_id} {command}"
+
+        headers = {"Content-Type": "text/plain"}
+
+        request = urllib.request.Request(
+            url, method="POST", data=command_string.encode("utf-8"), headers=headers
+        )
+
+        try:
+            with urllib.request.urlopen(request) as response:
+                return json.loads(response.read().decode("utf-8"))
+        except urllib.error.HTTPError as e:
+            if e.code == 422:
+                error_body = json.loads(e.read().decode("utf-8"))
+                raise ValueError(f"Validation Error: {error_body}")
+            raise

From 4cdf0829a8fd25a818293c2ffb7bf6769d9a866d Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Fri, 29 Aug 2025 14:06:20 +0300
Subject: [PATCH 1113/1164] Support for maintenance push notifications handling
 during server upgrade or maintenance procedures. (#3756)

* Hitless upgrade: Support initial implementation for synchronous Redis client - no handshake, no failing over notifications support. (#3713)

* Adding handling of FAILING_OVER and FAILED_OVER events/push notifications (#3716)

* Hitless upgrade: Adding handshake command to enable the notifications after connection is established (#3735)

* Hitless-Upgrade: Add handling of MOVING push notification with "null" host:port info. (#3751)

---------

Co-authored-by: Elena Kolevska <elena-kolevska@users.noreply.github.com>
---
 redis/_parsers/base.py                    |  181 +-
 redis/_parsers/hiredis.py                 |   26 +-
 redis/_parsers/resp3.py                   |   16 +-
 redis/client.py                           |   81 +-
 redis/connection.py                       |  875 ++++++++-
 redis/maintenance_events.py               |  785 ++++++++
 tests/test_connection_pool.py             |   10 +-
 tests/test_maintenance_events.py          |  869 ++++++++
 tests/test_maintenance_events_handling.py | 2177 +++++++++++++++++++++
 9 files changed, 4926 insertions(+), 94 deletions(-)
 create mode 100644 redis/maintenance_events.py
 create mode 100644 tests/test_maintenance_events.py
 create mode 100644 tests/test_maintenance_events_handling.py

diff --git a/redis/_parsers/base.py b/redis/_parsers/base.py
index 69d7b585dd..9fe77bcd3b 100644
--- a/redis/_parsers/base.py
+++ b/redis/_parsers/base.py
@@ -1,7 +1,17 @@
+import logging
 import sys
 from abc import ABC
 from asyncio import IncompleteReadError, StreamReader, TimeoutError
-from typing import Callable, List, Optional, Protocol, Union
+from typing import Awaitable, Callable, List, Optional, Protocol, Union
+
+from redis.maintenance_events import (
+    MaintenanceEvent,
+    NodeFailedOverEvent,
+    NodeFailingOverEvent,
+    NodeMigratedEvent,
+    NodeMigratingEvent,
+    NodeMovingEvent,
+)
 
 if sys.version_info.major >= 3 and sys.version_info.minor >= 11:
     from asyncio import timeout as async_timeout
@@ -50,6 +60,8 @@
     "Client sent AUTH, but no password is set": AuthenticationError,
 }
 
+logger = logging.getLogger(__name__)
+
 
 class BaseParser(ABC):
     EXCEPTION_CLASSES = {
@@ -158,7 +170,75 @@ async def read_response(
         raise NotImplementedError()
 
 
-_INVALIDATION_MESSAGE = [b"invalidate", "invalidate"]
+class MaintenanceNotificationsParser:
+    """Protocol defining maintenance push notification parsing functionality"""
+
+    @staticmethod
+    def parse_maintenance_start_msg(response, notification_type):
+        # Expected message format is: <event_type> <seq_number> <time>
+        id = response[1]
+        ttl = response[2]
+        return notification_type(id, ttl)
+
+    @staticmethod
+    def parse_maintenance_completed_msg(response, notification_type):
+        # Expected message format is: <event_type> <seq_number>
+        id = response[1]
+        return notification_type(id)
+
+    @staticmethod
+    def parse_moving_msg(response):
+        # Expected message format is: MOVING <seq_number> <time> <endpoint>
+        id = response[1]
+        ttl = response[2]
+        if response[3] in [b"null", "null"]:
+            host, port = None, None
+        else:
+            value = response[3]
+            if isinstance(value, bytes):
+                value = value.decode()
+            host, port = value.split(":")
+            port = int(port) if port is not None else None
+
+        return NodeMovingEvent(id, host, port, ttl)
+
+
+_INVALIDATION_MESSAGE = "invalidate"
+_MOVING_MESSAGE = "MOVING"
+_MIGRATING_MESSAGE = "MIGRATING"
+_MIGRATED_MESSAGE = "MIGRATED"
+_FAILING_OVER_MESSAGE = "FAILING_OVER"
+_FAILED_OVER_MESSAGE = "FAILED_OVER"
+
+_MAINTENANCE_MESSAGES = (
+    _MIGRATING_MESSAGE,
+    _MIGRATED_MESSAGE,
+    _FAILING_OVER_MESSAGE,
+    _FAILED_OVER_MESSAGE,
+)
+
+MSG_TYPE_TO_EVENT_PARSER_MAPPING: dict[str, tuple[type[MaintenanceEvent], Callable]] = {
+    _MIGRATING_MESSAGE: (
+        NodeMigratingEvent,
+        MaintenanceNotificationsParser.parse_maintenance_start_msg,
+    ),
+    _MIGRATED_MESSAGE: (
+        NodeMigratedEvent,
+        MaintenanceNotificationsParser.parse_maintenance_completed_msg,
+    ),
+    _FAILING_OVER_MESSAGE: (
+        NodeFailingOverEvent,
+        MaintenanceNotificationsParser.parse_maintenance_start_msg,
+    ),
+    _FAILED_OVER_MESSAGE: (
+        NodeFailedOverEvent,
+        MaintenanceNotificationsParser.parse_maintenance_completed_msg,
+    ),
+    _MOVING_MESSAGE: (
+        NodeMovingEvent,
+        MaintenanceNotificationsParser.parse_moving_msg,
+    ),
+}
 
 
 class PushNotificationsParser(Protocol):
@@ -166,16 +246,51 @@ class PushNotificationsParser(Protocol):
 
     pubsub_push_handler_func: Callable
     invalidation_push_handler_func: Optional[Callable] = None
+    node_moving_push_handler_func: Optional[Callable] = None
+    maintenance_push_handler_func: Optional[Callable] = None
 
     def handle_pubsub_push_response(self, response):
         """Handle pubsub push responses"""
         raise NotImplementedError()
 
     def handle_push_response(self, response, **kwargs):
-        if response[0] not in _INVALIDATION_MESSAGE:
+        msg_type = response[0]
+        if isinstance(msg_type, bytes):
+            msg_type = msg_type.decode()
+
+        if msg_type not in (
+            _INVALIDATION_MESSAGE,
+            *_MAINTENANCE_MESSAGES,
+            _MOVING_MESSAGE,
+        ):
             return self.pubsub_push_handler_func(response)
-        if self.invalidation_push_handler_func:
-            return self.invalidation_push_handler_func(response)
+
+        try:
+            if (
+                msg_type == _INVALIDATION_MESSAGE
+                and self.invalidation_push_handler_func
+            ):
+                return self.invalidation_push_handler_func(response)
+
+            if msg_type == _MOVING_MESSAGE and self.node_moving_push_handler_func:
+                parser_function = MSG_TYPE_TO_EVENT_PARSER_MAPPING[msg_type][1]
+
+                notification = parser_function(response)
+                return self.node_moving_push_handler_func(notification)
+
+            if msg_type in _MAINTENANCE_MESSAGES and self.maintenance_push_handler_func:
+                parser_function = MSG_TYPE_TO_EVENT_PARSER_MAPPING[msg_type][1]
+                notification_type = MSG_TYPE_TO_EVENT_PARSER_MAPPING[msg_type][0]
+                notification = parser_function(response, notification_type)
+
+                if notification is not None:
+                    return self.maintenance_push_handler_func(notification)
+        except Exception as e:
+            logger.error(
+                "Error handling {} message ({}): {}".format(msg_type, response, e)
+            )
+
+        return None
 
     def set_pubsub_push_handler(self, pubsub_push_handler_func):
         self.pubsub_push_handler_func = pubsub_push_handler_func
@@ -183,12 +298,20 @@ def set_pubsub_push_handler(self, pubsub_push_handler_func):
     def set_invalidation_push_handler(self, invalidation_push_handler_func):
         self.invalidation_push_handler_func = invalidation_push_handler_func
 
+    def set_node_moving_push_handler(self, node_moving_push_handler_func):
+        self.node_moving_push_handler_func = node_moving_push_handler_func
+
+    def set_maintenance_push_handler(self, maintenance_push_handler_func):
+        self.maintenance_push_handler_func = maintenance_push_handler_func
+
 
 class AsyncPushNotificationsParser(Protocol):
     """Protocol defining async RESP3-specific parsing functionality"""
 
     pubsub_push_handler_func: Callable
     invalidation_push_handler_func: Optional[Callable] = None
+    node_moving_push_handler_func: Optional[Callable[..., Awaitable[None]]] = None
+    maintenance_push_handler_func: Optional[Callable[..., Awaitable[None]]] = None
 
     async def handle_pubsub_push_response(self, response):
         """Handle pubsub push responses asynchronously"""
@@ -196,10 +319,46 @@ async def handle_pubsub_push_response(self, response):
 
     async def handle_push_response(self, response, **kwargs):
         """Handle push responses asynchronously"""
-        if response[0] not in _INVALIDATION_MESSAGE:
+
+        msg_type = response[0]
+        if isinstance(msg_type, bytes):
+            msg_type = msg_type.decode()
+
+        if msg_type not in (
+            _INVALIDATION_MESSAGE,
+            *_MAINTENANCE_MESSAGES,
+            _MOVING_MESSAGE,
+        ):
             return await self.pubsub_push_handler_func(response)
-        if self.invalidation_push_handler_func:
-            return await self.invalidation_push_handler_func(response)
+
+        try:
+            if (
+                msg_type == _INVALIDATION_MESSAGE
+                and self.invalidation_push_handler_func
+            ):
+                return await self.invalidation_push_handler_func(response)
+
+            if isinstance(msg_type, bytes):
+                msg_type = msg_type.decode()
+
+            if msg_type == _MOVING_MESSAGE and self.node_moving_push_handler_func:
+                parser_function = MSG_TYPE_TO_EVENT_PARSER_MAPPING[msg_type][1]
+                notification = parser_function(response)
+                return await self.node_moving_push_handler_func(notification)
+
+            if msg_type in _MAINTENANCE_MESSAGES and self.maintenance_push_handler_func:
+                parser_function = MSG_TYPE_TO_EVENT_PARSER_MAPPING[msg_type][1]
+                notification_type = MSG_TYPE_TO_EVENT_PARSER_MAPPING[msg_type][0]
+                notification = parser_function(response, notification_type)
+
+                if notification is not None:
+                    return await self.maintenance_push_handler_func(notification)
+        except Exception as e:
+            logger.error(
+                "Error handling {} message ({}): {}".format(msg_type, response, e)
+            )
+
+        return None
 
     def set_pubsub_push_handler(self, pubsub_push_handler_func):
         """Set the pubsub push handler function"""
@@ -209,6 +368,12 @@ def set_invalidation_push_handler(self, invalidation_push_handler_func):
         """Set the invalidation push handler function"""
         self.invalidation_push_handler_func = invalidation_push_handler_func
 
+    def set_node_moving_push_handler(self, node_moving_push_handler_func):
+        self.node_moving_push_handler_func = node_moving_push_handler_func
+
+    def set_maintenance_push_handler(self, maintenance_push_handler_func):
+        self.maintenance_push_handler_func = maintenance_push_handler_func
+
 
 class _AsyncRESPBase(AsyncBaseParser):
     """Base class for async resp parsing"""
diff --git a/redis/_parsers/hiredis.py b/redis/_parsers/hiredis.py
index 521a58b26c..d82fe99cd9 100644
--- a/redis/_parsers/hiredis.py
+++ b/redis/_parsers/hiredis.py
@@ -47,6 +47,8 @@ def __init__(self, socket_read_size):
         self.socket_read_size = socket_read_size
         self._buffer = bytearray(socket_read_size)
         self.pubsub_push_handler_func = self.handle_pubsub_push_response
+        self.node_moving_push_handler_func = None
+        self.maintenance_push_handler_func = None
         self.invalidation_push_handler_func = None
         self._hiredis_PushNotificationType = None
 
@@ -141,12 +143,15 @@ def read_response(self, disable_decoding=False, push_request=False):
                 response, self._hiredis_PushNotificationType
             ):
                 response = self.handle_push_response(response)
-                if not push_request:
-                    return self.read_response(
-                        disable_decoding=disable_decoding, push_request=push_request
-                    )
-                else:
+
+                # if this is a push request return the push response
+                if push_request:
                     return response
+
+                return self.read_response(
+                    disable_decoding=disable_decoding,
+                    push_request=push_request,
+                )
             return response
 
         if disable_decoding:
@@ -169,12 +174,13 @@ def read_response(self, disable_decoding=False, push_request=False):
             response, self._hiredis_PushNotificationType
         ):
             response = self.handle_push_response(response)
-            if not push_request:
-                return self.read_response(
-                    disable_decoding=disable_decoding, push_request=push_request
-                )
-            else:
+            if push_request:
                 return response
+            return self.read_response(
+                disable_decoding=disable_decoding,
+                push_request=push_request,
+            )
+
         elif (
             isinstance(response, list)
             and response
diff --git a/redis/_parsers/resp3.py b/redis/_parsers/resp3.py
index 42c6652e31..72957b464c 100644
--- a/redis/_parsers/resp3.py
+++ b/redis/_parsers/resp3.py
@@ -18,6 +18,8 @@ class _RESP3Parser(_RESPBase, PushNotificationsParser):
     def __init__(self, socket_read_size):
         super().__init__(socket_read_size)
         self.pubsub_push_handler_func = self.handle_pubsub_push_response
+        self.node_moving_push_handler_func = None
+        self.maintenance_push_handler_func = None
         self.invalidation_push_handler_func = None
 
     def handle_pubsub_push_response(self, response):
@@ -117,17 +119,21 @@ def _read_response(self, disable_decoding=False, push_request=False):
                 for _ in range(int(response))
             ]
             response = self.handle_push_response(response)
-            if not push_request:
-                return self._read_response(
-                    disable_decoding=disable_decoding, push_request=push_request
-                )
-            else:
+
+            # if this is a push request return the push response
+            if push_request:
                 return response
+
+            return self._read_response(
+                disable_decoding=disable_decoding,
+                push_request=push_request,
+            )
         else:
             raise InvalidResponse(f"Protocol Error: {raw!r}")
 
         if isinstance(response, bytes) and disable_decoding is False:
             response = self.encoder.decode(response)
+
         return response
 
 
diff --git a/redis/client.py b/redis/client.py
index 0e05b6f542..26837b673b 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -56,6 +56,10 @@
     WatchError,
 )
 from redis.lock import Lock
+from redis.maintenance_events import (
+    MaintenanceEventPoolHandler,
+    MaintenanceEventsConfig,
+)
 from redis.retry import Retry
 from redis.utils import (
     _set_info_logger,
@@ -244,6 +248,7 @@ def __init__(
         cache: Optional[CacheInterface] = None,
         cache_config: Optional[CacheConfig] = None,
         event_dispatcher: Optional[EventDispatcher] = None,
+        maintenance_events_config: Optional[MaintenanceEventsConfig] = None,
     ) -> None:
         """
         Initialize a new Redis client.
@@ -368,6 +373,23 @@ def __init__(
         ]:
             raise RedisError("Client caching is only supported with RESP version 3")
 
+        if maintenance_events_config and self.connection_pool.get_protocol() not in [
+            3,
+            "3",
+        ]:
+            raise RedisError(
+                "Push handlers on connection are only supported with RESP version 3"
+            )
+        if maintenance_events_config and maintenance_events_config.enabled:
+            self.maintenance_events_pool_handler = MaintenanceEventPoolHandler(
+                self.connection_pool, maintenance_events_config
+            )
+            self.connection_pool.set_maintenance_events_pool_handler(
+                self.maintenance_events_pool_handler
+            )
+        else:
+            self.maintenance_events_pool_handler = None
+
         self.single_connection_lock = threading.RLock()
         self.connection = None
         self._single_connection_client = single_connection_client
@@ -565,8 +587,15 @@ def monitor(self):
         return Monitor(self.connection_pool)
 
     def client(self):
+        maintenance_events_config = (
+            None
+            if self.maintenance_events_pool_handler is None
+            else self.maintenance_events_pool_handler.config
+        )
         return self.__class__(
-            connection_pool=self.connection_pool, single_connection_client=True
+            connection_pool=self.connection_pool,
+            single_connection_client=True,
+            maintenance_events_config=maintenance_events_config,
         )
 
     def __enter__(self):
@@ -635,7 +664,11 @@ def _execute_command(self, *args, **options):
                 ),
                 lambda _: self._close_connection(conn),
             )
+
         finally:
+            if conn and conn.should_reconnect():
+                self._close_connection(conn)
+                conn.connect()
             if self._single_connection_client:
                 self.single_connection_lock.release()
             if not self.connection:
@@ -686,11 +719,7 @@ def __init__(self, connection_pool):
         self.connection = self.connection_pool.get_connection()
 
     def __enter__(self):
-        self.connection.send_command("MONITOR")
-        # check that monitor returns 'OK', but don't return it to user
-        response = self.connection.read_response()
-        if not bool_ok(response):
-            raise RedisError(f"MONITOR failed: {response}")
+        self._start_monitor()
         return self
 
     def __exit__(self, *args):
@@ -700,8 +729,13 @@ def __exit__(self, *args):
     def next_command(self):
         """Parse the response from a monitor command"""
         response = self.connection.read_response()
+
+        if response is None:
+            return None
+
         if isinstance(response, bytes):
             response = self.connection.encoder.decode(response, force=True)
+
         command_time, command_data = response.split(" ", 1)
         m = self.monitor_re.match(command_data)
         db_id, client_info, command = m.groups()
@@ -737,6 +771,14 @@ def listen(self):
         while True:
             yield self.next_command()
 
+    def _start_monitor(self):
+        self.connection.send_command("MONITOR")
+        # check that monitor returns 'OK', but don't return it to user
+        response = self.connection.read_response()
+
+        if not bool_ok(response):
+            raise RedisError(f"MONITOR failed: {response}")
+
 
 class PubSub:
     """
@@ -881,7 +923,7 @@ def clean_health_check_responses(self) -> None:
         """
         ttl = 10
         conn = self.connection
-        while self.health_check_response_counter > 0 and ttl > 0:
+        while conn and self.health_check_response_counter > 0 and ttl > 0:
             if self._execute(conn, conn.can_read, timeout=conn.socket_timeout):
                 response = self._execute(conn, conn.read_response)
                 if self.is_health_check_response(response):
@@ -911,11 +953,17 @@ def _execute(self, conn, command, *args, **kwargs):
         called by the # connection to resubscribe us to any channels and
         patterns we were previously listening to
         """
-        return conn.retry.call_with_retry(
+
+        if conn.should_reconnect():
+            self._reconnect(conn)
+
+        response = conn.retry.call_with_retry(
             lambda: command(*args, **kwargs),
             lambda _: self._reconnect(conn),
         )
 
+        return response
+
     def parse_response(self, block=True, timeout=0):
         """Parse the response from a publish/subscribe command"""
         conn = self.connection
@@ -1125,6 +1173,7 @@ def get_message(
                 return None
 
         response = self.parse_response(block=(timeout is None), timeout=timeout)
+
         if response:
             return self.handle_message(response, ignore_subscribe_messages)
         return None
@@ -1148,6 +1197,7 @@ def handle_message(self, response, ignore_subscribe_messages=False):
             return None
         if isinstance(response, bytes):
             response = [b"pong", response] if response != b"PONG" else [b"pong", b""]
+
         message_type = str_if_bytes(response[0])
         if message_type == "pmessage":
             message = {
@@ -1351,6 +1401,7 @@ def reset(self) -> None:
         # clean up the other instance attributes
         self.watching = False
         self.explicit_transaction = False
+
         # we can safely return the connection to the pool here since we're
         # sure we're no longer WATCHing anything
         if self.connection:
@@ -1510,6 +1561,7 @@ def _execute_transaction(
                 if command_name in self.response_callbacks:
                     r = self.response_callbacks[command_name](r, **options)
             data.append(r)
+
         return data
 
     def _execute_pipeline(self, connection, commands, raise_on_error):
@@ -1517,16 +1569,17 @@ def _execute_pipeline(self, connection, commands, raise_on_error):
         all_cmds = connection.pack_commands([args for args, _ in commands])
         connection.send_packed_command(all_cmds)
 
-        response = []
+        responses = []
         for args, options in commands:
             try:
-                response.append(self.parse_response(connection, args[0], **options))
+                responses.append(self.parse_response(connection, args[0], **options))
             except ResponseError as e:
-                response.append(e)
+                responses.append(e)
 
         if raise_on_error:
-            self.raise_first_error(commands, response)
-        return response
+            self.raise_first_error(commands, responses)
+
+        return responses
 
     def raise_first_error(self, commands, response):
         for i, r in enumerate(response):
@@ -1611,6 +1664,8 @@ def execute(self, raise_on_error: bool = True) -> List[Any]:
                 lambda error: self._disconnect_raise_on_watching(conn, error),
             )
         finally:
+            # in reset() the connection is disconnected before returned to the pool if
+            # it is marked for reconnect.
             self.reset()
 
     def discard(self):
diff --git a/redis/connection.py b/redis/connection.py
index 47cb589569..0e7de5a584 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -8,7 +8,18 @@
 from abc import abstractmethod
 from itertools import chain
 from queue import Empty, Full, LifoQueue
-from typing import Any, Callable, Dict, List, Optional, Type, TypeVar, Union
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Literal,
+    Optional,
+    Type,
+    TypeVar,
+    Union,
+)
 from urllib.parse import parse_qs, unquote, urlparse
 
 from redis.cache import (
@@ -36,6 +47,12 @@
     ResponseError,
     TimeoutError,
 )
+from .maintenance_events import (
+    MaintenanceEventConnectionHandler,
+    MaintenanceEventPoolHandler,
+    MaintenanceEventsConfig,
+    MaintenanceState,
+)
 from .retry import Retry
 from .utils import (
     CRYPTOGRAPHY_AVAILABLE,
@@ -159,6 +176,10 @@ def deregister_connect_callback(self, callback):
     def set_parser(self, parser_class):
         pass
 
+    @abstractmethod
+    def set_maintenance_event_pool_handler(self, maintenance_event_pool_handler):
+        pass
+
     @abstractmethod
     def get_protocol(self):
         pass
@@ -222,6 +243,80 @@ def set_re_auth_token(self, token: TokenInterface):
     def re_auth(self):
         pass
 
+    @property
+    @abstractmethod
+    def maintenance_state(self) -> MaintenanceState:
+        """
+        Returns the current maintenance state of the connection.
+        """
+        pass
+
+    @maintenance_state.setter
+    @abstractmethod
+    def maintenance_state(self, state: "MaintenanceState"):
+        """
+        Sets the current maintenance state of the connection.
+        """
+        pass
+
+    @abstractmethod
+    def getpeername(self):
+        """
+        Returns the peer name of the connection.
+        """
+        pass
+
+    @abstractmethod
+    def mark_for_reconnect(self):
+        """
+        Mark the connection to be reconnected on the next command.
+        This is useful when a connection is moved to a different node.
+        """
+        pass
+
+    @abstractmethod
+    def should_reconnect(self):
+        """
+        Returns True if the connection should be reconnected.
+        """
+        pass
+
+    @abstractmethod
+    def get_resolved_ip(self):
+        """
+        Get resolved ip address for the connection.
+        """
+        pass
+
+    @abstractmethod
+    def update_current_socket_timeout(self, relax_timeout: Optional[float] = None):
+        """
+        Update the timeout for the current socket.
+        """
+        pass
+
+    @abstractmethod
+    def set_tmp_settings(
+        self,
+        tmp_host_address: Optional[str] = None,
+        tmp_relax_timeout: Optional[float] = None,
+    ):
+        """
+        Updates temporary host address and timeout settings for the connection.
+        """
+        pass
+
+    @abstractmethod
+    def reset_tmp_settings(
+        self,
+        reset_host_address: bool = False,
+        reset_relax_timeout: bool = False,
+    ):
+        """
+        Resets temporary host address and timeout settings for the connection.
+        """
+        pass
+
 
 class AbstractConnection(ConnectionInterface):
     "Manages communication to and from a Redis server"
@@ -233,7 +328,7 @@ def __init__(
         socket_timeout: Optional[float] = None,
         socket_connect_timeout: Optional[float] = None,
         retry_on_timeout: bool = False,
-        retry_on_error=SENTINEL,
+        retry_on_error: Union[Iterable[Type[Exception]], object] = SENTINEL,
         encoding: str = "utf-8",
         encoding_errors: str = "strict",
         decode_responses: bool = False,
@@ -250,6 +345,13 @@ def __init__(
         protocol: Optional[int] = 2,
         command_packer: Optional[Callable[[], None]] = None,
         event_dispatcher: Optional[EventDispatcher] = None,
+        maintenance_events_pool_handler: Optional[MaintenanceEventPoolHandler] = None,
+        maintenance_events_config: Optional[MaintenanceEventsConfig] = None,
+        maintenance_state: "MaintenanceState" = MaintenanceState.NONE,
+        maintenance_event_hash: Optional[int] = None,
+        orig_host_address: Optional[str] = None,
+        orig_socket_timeout: Optional[float] = None,
+        orig_socket_connect_timeout: Optional[float] = None,
     ):
         """
         Initialize a new Connection.
@@ -283,19 +385,22 @@ def __init__(
         self.socket_connect_timeout = socket_connect_timeout
         self.retry_on_timeout = retry_on_timeout
         if retry_on_error is SENTINEL:
-            retry_on_error = []
+            retry_on_errors_list = []
+        else:
+            retry_on_errors_list = list(retry_on_error)
         if retry_on_timeout:
             # Add TimeoutError to the errors list to retry on
-            retry_on_error.append(TimeoutError)
-        self.retry_on_error = retry_on_error
-        if retry or retry_on_error:
+            retry_on_errors_list.append(TimeoutError)
+        self.retry_on_error = retry_on_errors_list
+        if retry or self.retry_on_error:
             if retry is None:
                 self.retry = Retry(NoBackoff(), 1)
             else:
                 # deep-copy the Retry object as it is mutable
                 self.retry = copy.deepcopy(retry)
-            # Update the retry's supported errors with the specified errors
-            self.retry.update_supported_errors(retry_on_error)
+            if self.retry_on_error:
+                # Update the retry's supported errors with the specified errors
+                self.retry.update_supported_errors(self.retry_on_error)
         else:
             self.retry = Retry(NoBackoff(), 0)
         self.health_check_interval = health_check_interval
@@ -305,7 +410,6 @@ def __init__(
         self.handshake_metadata = None
         self._sock = None
         self._socket_read_size = socket_read_size
-        self.set_parser(parser_class)
         self._connect_callbacks = []
         self._buffer_cutoff = 6000
         self._re_auth_token: Optional[TokenInterface] = None
@@ -320,6 +424,24 @@ def __init__(
                 raise ConnectionError("protocol must be either 2 or 3")
                 # p = DEFAULT_RESP_VERSION
             self.protocol = p
+        if self.protocol == 3 and parser_class == DefaultParser:
+            parser_class = _RESP3Parser
+        self.set_parser(parser_class)
+
+        self.maintenance_events_config = maintenance_events_config
+
+        # Set up maintenance events if enabled
+        self._configure_maintenance_events(
+            maintenance_events_pool_handler,
+            orig_host_address,
+            orig_socket_timeout,
+            orig_socket_connect_timeout,
+        )
+
+        self._should_reconnect = False
+        self.maintenance_state = maintenance_state
+        self.maintenance_event_hash = maintenance_event_hash
+
         self._command_packer = self._construct_command_packer(command_packer)
 
     def __repr__(self):
@@ -375,6 +497,69 @@ def set_parser(self, parser_class):
         """
         self._parser = parser_class(socket_read_size=self._socket_read_size)
 
+    def _configure_maintenance_events(
+        self,
+        maintenance_events_pool_handler=None,
+        orig_host_address=None,
+        orig_socket_timeout=None,
+        orig_socket_connect_timeout=None,
+    ):
+        """Enable maintenance events by setting up handlers and storing original connection parameters."""
+        if (
+            not self.maintenance_events_config
+            or not self.maintenance_events_config.enabled
+        ):
+            self._maintenance_event_connection_handler = None
+            return
+
+        # Set up pool handler if available
+        if maintenance_events_pool_handler:
+            self._parser.set_node_moving_push_handler(
+                maintenance_events_pool_handler.handle_event
+            )
+
+        # Set up connection handler
+        self._maintenance_event_connection_handler = MaintenanceEventConnectionHandler(
+            self, self.maintenance_events_config
+        )
+        self._parser.set_maintenance_push_handler(
+            self._maintenance_event_connection_handler.handle_event
+        )
+
+        # Store original connection parameters
+        self.orig_host_address = orig_host_address if orig_host_address else self.host
+        self.orig_socket_timeout = (
+            orig_socket_timeout if orig_socket_timeout else self.socket_timeout
+        )
+        self.orig_socket_connect_timeout = (
+            orig_socket_connect_timeout
+            if orig_socket_connect_timeout
+            else self.socket_connect_timeout
+        )
+
+    def set_maintenance_event_pool_handler(
+        self, maintenance_event_pool_handler: MaintenanceEventPoolHandler
+    ):
+        maintenance_event_pool_handler.set_connection(self)
+        self._parser.set_node_moving_push_handler(
+            maintenance_event_pool_handler.handle_event
+        )
+
+        # Update maintenance event connection handler if it doesn't exist
+        if not self._maintenance_event_connection_handler:
+            self._maintenance_event_connection_handler = (
+                MaintenanceEventConnectionHandler(
+                    self, maintenance_event_pool_handler.config
+                )
+            )
+            self._parser.set_maintenance_push_handler(
+                self._maintenance_event_connection_handler.handle_event
+            )
+        else:
+            self._maintenance_event_connection_handler.config = (
+                maintenance_event_pool_handler.config
+            )
+
     def connect(self):
         "Connects to the Redis server if not already connected"
         self.connect_check_health(check_health=True)
@@ -499,6 +684,39 @@ def on_connect_check_health(self, check_health: bool = True):
             ):
                 raise ConnectionError("Invalid RESP version")
 
+        # Send maintenance notifications handshake if RESP3 is active and maintenance events are enabled
+        # and we have a host to determine the endpoint type from
+        if (
+            self.protocol not in [2, "2"]
+            and self.maintenance_events_config
+            and self.maintenance_events_config.enabled
+            and self._maintenance_event_connection_handler
+            and hasattr(self, "host")
+        ):
+            try:
+                endpoint_type = self.maintenance_events_config.get_endpoint_type(
+                    self.host, self
+                )
+                self.send_command(
+                    "CLIENT",
+                    "MAINT_NOTIFICATIONS",
+                    "ON",
+                    "moving-endpoint-type",
+                    endpoint_type.value,
+                    check_health=check_health,
+                )
+                response = self.read_response()
+                if str_if_bytes(response) != "OK":
+                    raise ConnectionError(
+                        "The server doesn't support maintenance notifications"
+                    )
+            except Exception as e:
+                # Log warning but don't fail the connection
+                import logging
+
+                logger = logging.getLogger(__name__)
+                logger.warning(f"Failed to enable maintenance notifications: {e}")
+
         # if a client_name is given, set it
         if self.client_name:
             self.send_command(
@@ -549,6 +767,8 @@ def disconnect(self, *args):
 
         conn_sock = self._sock
         self._sock = None
+        # reset the reconnect flag
+        self._should_reconnect = False
         if conn_sock is None:
             return
 
@@ -626,6 +846,7 @@ def can_read(self, timeout=0):
 
         try:
             return self._parser.can_read(timeout)
+
         except OSError as e:
             self.disconnect()
             raise ConnectionError(f"Error while reading from {host_error}: {e.args}")
@@ -732,6 +953,110 @@ def re_auth(self):
             self.read_response()
             self._re_auth_token = None
 
+    def get_resolved_ip(self) -> Optional[str]:
+        """
+        Extract the resolved IP address from an
+        established connection or resolve it from the host.
+
+        First tries to get the actual IP from the socket (most accurate),
+        then falls back to DNS resolution if needed.
+
+        Args:
+            connection: The connection object to extract the IP from
+
+        Returns:
+            str: The resolved IP address, or None if it cannot be determined
+        """
+
+        # Method 1: Try to get the actual IP from the established socket connection
+        # This is most accurate as it shows the exact IP being used
+        try:
+            if self._sock is not None:
+                peer_addr = self._sock.getpeername()
+                if peer_addr and len(peer_addr) >= 1:
+                    # For TCP sockets, peer_addr is typically (host, port) tuple
+                    # Return just the host part
+                    return peer_addr[0]
+        except (AttributeError, OSError):
+            # Socket might not be connected or getpeername() might fail
+            pass
+
+        # Method 2: Fallback to DNS resolution of the host
+        # This is less accurate but works when socket is not available
+        try:
+            host = getattr(self, "host", "localhost")
+            port = getattr(self, "port", 6379)
+            if host:
+                # Use getaddrinfo to resolve the hostname to IP
+                # This mimics what the connection would do during _connect()
+                addr_info = socket.getaddrinfo(
+                    host, port, socket.AF_UNSPEC, socket.SOCK_STREAM
+                )
+                if addr_info:
+                    # Return the IP from the first result
+                    # addr_info[0] is (family, socktype, proto, canonname, sockaddr)
+                    # sockaddr[0] is the IP address
+                    return addr_info[0][4][0]
+        except (AttributeError, OSError, socket.gaierror):
+            # DNS resolution might fail
+            pass
+
+        return None
+
+    @property
+    def maintenance_state(self) -> MaintenanceState:
+        return self._maintenance_state
+
+    @maintenance_state.setter
+    def maintenance_state(self, state: "MaintenanceState"):
+        self._maintenance_state = state
+
+    def getpeername(self):
+        if not self._sock:
+            return None
+        return self._sock.getpeername()[0]
+
+    def mark_for_reconnect(self):
+        self._should_reconnect = True
+
+    def should_reconnect(self):
+        return self._should_reconnect
+
+    def update_current_socket_timeout(self, relax_timeout: Optional[float] = None):
+        if self._sock:
+            timeout = relax_timeout if relax_timeout != -1 else self.socket_timeout
+            self._sock.settimeout(timeout)
+            self.update_parser_buffer_timeout(timeout)
+
+    def update_parser_buffer_timeout(self, timeout: Optional[float] = None):
+        if self._parser and self._parser._buffer:
+            self._parser._buffer.socket_timeout = timeout
+
+    def set_tmp_settings(
+        self,
+        tmp_host_address: Optional[Union[str, object]] = SENTINEL,
+        tmp_relax_timeout: Optional[float] = None,
+    ):
+        """
+        The value of SENTINEL is used to indicate that the property should not be updated.
+        """
+        if tmp_host_address is not SENTINEL:
+            self.host = tmp_host_address
+        if tmp_relax_timeout != -1:
+            self.socket_timeout = tmp_relax_timeout
+            self.socket_connect_timeout = tmp_relax_timeout
+
+    def reset_tmp_settings(
+        self,
+        reset_host_address: bool = False,
+        reset_relax_timeout: bool = False,
+    ):
+        if reset_host_address:
+            self.host = self.orig_host_address
+        if reset_relax_timeout:
+            self.socket_timeout = self.orig_socket_timeout
+            self.socket_connect_timeout = self.orig_socket_connect_timeout
+
 
 class Connection(AbstractConnection):
     "Manages TCP communication to and from a Redis server"
@@ -764,6 +1089,7 @@ def _connect(self):
         # ipv4/ipv6, but we want to set options prior to calling
         # socket.connect()
         err = None
+
         for res in socket.getaddrinfo(
             self.host, self.port, self.socket_type, socket.SOCK_STREAM
         ):
@@ -1415,6 +1741,32 @@ def __init__(
         connection_kwargs.pop("cache", None)
         connection_kwargs.pop("cache_config", None)
 
+        if connection_kwargs.get(
+            "maintenance_events_pool_handler"
+        ) or connection_kwargs.get("maintenance_events_config"):
+            if connection_kwargs.get("protocol") not in [3, "3"]:
+                raise RedisError(
+                    "Push handlers on connection are only supported with RESP version 3"
+                )
+            config = connection_kwargs.get("maintenance_events_config", None) or (
+                connection_kwargs.get("maintenance_events_pool_handler").config
+                if connection_kwargs.get("maintenance_events_pool_handler")
+                else None
+            )
+
+            if config and config.enabled:
+                connection_kwargs.update(
+                    {
+                        "orig_host_address": connection_kwargs.get("host"),
+                        "orig_socket_timeout": connection_kwargs.get(
+                            "socket_timeout", None
+                        ),
+                        "orig_socket_connect_timeout": connection_kwargs.get(
+                            "socket_connect_timeout", None
+                        ),
+                    }
+                )
+
         self._event_dispatcher = self.connection_kwargs.get("event_dispatcher", None)
         if self._event_dispatcher is None:
             self._event_dispatcher = EventDispatcher()
@@ -1449,6 +1801,43 @@ def get_protocol(self):
         """
         return self.connection_kwargs.get("protocol", None)
 
+    def maintenance_events_pool_handler_enabled(self):
+        """
+        Returns:
+            True if the maintenance events pool handler is enabled, False otherwise.
+        """
+        maintenance_events_config = self.connection_kwargs.get(
+            "maintenance_events_config", None
+        )
+
+        return maintenance_events_config and maintenance_events_config.enabled
+
+    def set_maintenance_events_pool_handler(
+        self, maintenance_events_pool_handler: MaintenanceEventPoolHandler
+    ):
+        self.connection_kwargs.update(
+            {
+                "maintenance_events_pool_handler": maintenance_events_pool_handler,
+                "maintenance_events_config": maintenance_events_pool_handler.config,
+            }
+        )
+
+        self._update_maintenance_events_configs_for_connections(
+            maintenance_events_pool_handler
+        )
+
+    def _update_maintenance_events_configs_for_connections(
+        self, maintenance_events_pool_handler
+    ):
+        """Update the maintenance events config for all connections in the pool."""
+        with self._lock:
+            for conn in self._available_connections:
+                conn.set_maintenance_event_pool_handler(maintenance_events_pool_handler)
+                conn.maintenance_events_config = maintenance_events_pool_handler.config
+            for conn in self._in_use_connections:
+                conn.set_maintenance_event_pool_handler(maintenance_events_pool_handler)
+                conn.maintenance_events_config = maintenance_events_pool_handler.config
+
     def reset(self) -> None:
         self._created_connections = 0
         self._available_connections = []
@@ -1536,7 +1925,11 @@ def get_connection(self, command_name=None, *keys, **options) -> "Connection":
             # pool before all data has been read or the socket has been
             # closed. either way, reconnect and verify everything is good.
             try:
-                if connection.can_read() and self.cache is None:
+                if (
+                    connection.can_read()
+                    and self.cache is None
+                    and not self.maintenance_events_pool_handler_enabled()
+                ):
                     raise ConnectionError("Connection has data")
             except (ConnectionError, TimeoutError, OSError):
                 connection.disconnect()
@@ -1548,7 +1941,6 @@ def get_connection(self, command_name=None, *keys, **options) -> "Connection":
             # leak it
             self.release(connection)
             raise
-
         return connection
 
     def get_encoder(self) -> Encoder:
@@ -1566,12 +1958,13 @@ def make_connection(self) -> "ConnectionInterface":
             raise MaxConnectionsError("Too many connections")
         self._created_connections += 1
 
+        kwargs = dict(self.connection_kwargs)
+
         if self.cache is not None:
             return CacheProxyConnection(
-                self.connection_class(**self.connection_kwargs), self.cache, self._lock
+                self.connection_class(**kwargs), self.cache, self._lock
             )
-
-        return self.connection_class(**self.connection_kwargs)
+        return self.connection_class(**kwargs)
 
     def release(self, connection: "Connection") -> None:
         "Releases the connection back to the pool"
@@ -1585,6 +1978,8 @@ def release(self, connection: "Connection") -> None:
                 return
 
             if self.owns_connection(connection):
+                if connection.should_reconnect():
+                    connection.disconnect()
                 self._available_connections.append(connection)
                 self._event_dispatcher.dispatch(
                     AfterConnectionReleasedEvent(connection)
@@ -1646,6 +2041,186 @@ def re_auth_callback(self, token: TokenInterface):
             for conn in self._in_use_connections:
                 conn.set_re_auth_token(token)
 
+    def _should_update_connection(
+        self,
+        conn: "Connection",
+        matching_pattern: Literal[
+            "connected_address", "configured_address", "event_hash"
+        ] = "connected_address",
+        matching_address: Optional[str] = None,
+        matching_event_hash: Optional[int] = None,
+    ) -> bool:
+        """
+        Check if the connection should be updated based on the matching address.
+        """
+        if matching_pattern == "connected_address":
+            if matching_address and conn.getpeername() != matching_address:
+                return False
+        elif matching_pattern == "configured_address":
+            if matching_address and conn.host != matching_address:
+                return False
+        elif matching_pattern == "event_hash":
+            if (
+                matching_event_hash
+                and conn.maintenance_event_hash != matching_event_hash
+            ):
+                return False
+        return True
+
+    def update_connection_settings(
+        self,
+        conn: "Connection",
+        state: Optional["MaintenanceState"] = None,
+        maintenance_event_hash: Optional[int] = None,
+        host_address: Optional[str] = None,
+        relax_timeout: Optional[float] = None,
+        update_event_hash: bool = False,
+        reset_host_address: bool = False,
+        reset_relax_timeout: bool = False,
+    ):
+        """
+        Update the settings for a single connection.
+        """
+        if state:
+            conn.maintenance_state = state
+
+        if update_event_hash:
+            # update the event hash only if requested
+            conn.maintenance_event_hash = maintenance_event_hash
+
+        if host_address is not None:
+            conn.set_tmp_settings(tmp_host_address=host_address)
+
+        if relax_timeout is not None:
+            conn.set_tmp_settings(tmp_relax_timeout=relax_timeout)
+
+        if reset_relax_timeout or reset_host_address:
+            conn.reset_tmp_settings(
+                reset_host_address=reset_host_address,
+                reset_relax_timeout=reset_relax_timeout,
+            )
+
+        conn.update_current_socket_timeout(relax_timeout)
+
+    def update_connections_settings(
+        self,
+        state: Optional["MaintenanceState"] = None,
+        maintenance_event_hash: Optional[int] = None,
+        host_address: Optional[str] = None,
+        relax_timeout: Optional[float] = None,
+        matching_address: Optional[str] = None,
+        matching_event_hash: Optional[int] = None,
+        matching_pattern: Literal[
+            "connected_address", "configured_address", "event_hash"
+        ] = "connected_address",
+        update_event_hash: bool = False,
+        reset_host_address: bool = False,
+        reset_relax_timeout: bool = False,
+        include_free_connections: bool = True,
+    ):
+        """
+        Update the settings for all matching connections in the pool.
+
+        This method does not create new connections.
+        This method does not affect the connection kwargs.
+
+        :param state: The maintenance state to set for the connection.
+        :param maintenance_event_hash: The hash of the maintenance event
+                                        to set for the connection.
+        :param host_address: The host address to set for the connection.
+        :param relax_timeout: The relax timeout to set for the connection.
+        :param matching_address: The address to match for the connection.
+        :param matching_event_hash: The event hash to match for the connection.
+        :param matching_pattern: The pattern to match for the connection.
+        :param update_event_hash: Whether to update the event hash for the connection.
+        :param reset_host_address: Whether to reset the host address to the original address.
+        :param reset_relax_timeout: Whether to reset the relax timeout to the original timeout.
+        :param include_free_connections: Whether to include free/available connections.
+        """
+        with self._lock:
+            for conn in self._in_use_connections:
+                if self._should_update_connection(
+                    conn,
+                    matching_pattern,
+                    matching_address,
+                    matching_event_hash,
+                ):
+                    self.update_connection_settings(
+                        conn,
+                        state=state,
+                        maintenance_event_hash=maintenance_event_hash,
+                        host_address=host_address,
+                        relax_timeout=relax_timeout,
+                        update_event_hash=update_event_hash,
+                        reset_host_address=reset_host_address,
+                        reset_relax_timeout=reset_relax_timeout,
+                    )
+
+            if include_free_connections:
+                for conn in self._available_connections:
+                    if self._should_update_connection(
+                        conn,
+                        matching_pattern,
+                        matching_address,
+                        matching_event_hash,
+                    ):
+                        self.update_connection_settings(
+                            conn,
+                            state=state,
+                            maintenance_event_hash=maintenance_event_hash,
+                            host_address=host_address,
+                            relax_timeout=relax_timeout,
+                            update_event_hash=update_event_hash,
+                            reset_host_address=reset_host_address,
+                            reset_relax_timeout=reset_relax_timeout,
+                        )
+
+    def update_connection_kwargs(
+        self,
+        **kwargs,
+    ):
+        """
+        Update the connection kwargs for all future connections.
+
+        This method updates the connection kwargs for all future connections created by the pool.
+        Existing connections are not affected.
+        """
+        self.connection_kwargs.update(kwargs)
+
+    def update_active_connections_for_reconnect(
+        self,
+        moving_address_src: Optional[str] = None,
+    ):
+        """
+        Mark all active connections for reconnect.
+        This is used when a cluster node is migrated to a different address.
+
+        :param moving_address_src: The address of the node that is being moved.
+        """
+        with self._lock:
+            for conn in self._in_use_connections:
+                if self._should_update_connection(
+                    conn, "connected_address", moving_address_src
+                ):
+                    conn.mark_for_reconnect()
+
+    def disconnect_free_connections(
+        self,
+        moving_address_src: Optional[str] = None,
+    ):
+        """
+        Disconnect all free/available connections.
+        This is used when a cluster node is migrated to a different address.
+
+        :param moving_address_src: The address of the node that is being moved.
+        """
+        with self._lock:
+            for conn in self._available_connections:
+                if self._should_update_connection(
+                    conn, "connected_address", moving_address_src
+                ):
+                    conn.disconnect()
+
     async def _mock(self, error: RedisError):
         """
         Dummy functions, needs to be passed as error callback to retry object.
@@ -1699,6 +2274,8 @@ def __init__(
     ):
         self.queue_class = queue_class
         self.timeout = timeout
+        self._in_maintenance = False
+        self._locked = False
         super().__init__(
             connection_class=connection_class,
             max_connections=max_connections,
@@ -1707,16 +2284,27 @@ def __init__(
 
     def reset(self):
         # Create and fill up a thread safe queue with ``None`` values.
-        self.pool = self.queue_class(self.max_connections)
-        while True:
-            try:
-                self.pool.put_nowait(None)
-            except Full:
-                break
+        try:
+            if self._in_maintenance:
+                self._lock.acquire()
+                self._locked = True
+            self.pool = self.queue_class(self.max_connections)
+            while True:
+                try:
+                    self.pool.put_nowait(None)
+                except Full:
+                    break
 
-        # Keep a list of actual connection instances so that we can
-        # disconnect them later.
-        self._connections = []
+            # Keep a list of actual connection instances so that we can
+            # disconnect them later.
+            self._connections = []
+        finally:
+            if self._locked:
+                try:
+                    self._lock.release()
+                except Exception:
+                    pass
+                self._locked = False
 
         # this must be the last operation in this method. while reset() is
         # called when holding _fork_lock, other threads in this process
@@ -1731,14 +2319,28 @@ def reset(self):
 
     def make_connection(self):
         "Make a fresh connection."
-        if self.cache is not None:
-            connection = CacheProxyConnection(
-                self.connection_class(**self.connection_kwargs), self.cache, self._lock
-            )
-        else:
-            connection = self.connection_class(**self.connection_kwargs)
-        self._connections.append(connection)
-        return connection
+        try:
+            if self._in_maintenance:
+                self._lock.acquire()
+                self._locked = True
+
+            if self.cache is not None:
+                connection = CacheProxyConnection(
+                    self.connection_class(**self.connection_kwargs),
+                    self.cache,
+                    self._lock,
+                )
+            else:
+                connection = self.connection_class(**self.connection_kwargs)
+                self._connections.append(connection)
+            return connection
+        finally:
+            if self._locked:
+                try:
+                    self._lock.release()
+                except Exception:
+                    pass
+                self._locked = False
 
     @deprecated_args(
         args_to_warn=["*"],
@@ -1764,16 +2366,27 @@ def get_connection(self, command_name=None, *keys, **options):
         # self.timeout then raise a ``ConnectionError``.
         connection = None
         try:
-            connection = self.pool.get(block=True, timeout=self.timeout)
-        except Empty:
-            # Note that this is not caught by the redis client and will be
-            # raised unless handled by application code. If you want never to
-            raise ConnectionError("No connection available.")
-
-        # If the ``connection`` is actually ``None`` then that's a cue to make
-        # a new connection to add to the pool.
-        if connection is None:
-            connection = self.make_connection()
+            if self._in_maintenance:
+                self._lock.acquire()
+                self._locked = True
+            try:
+                connection = self.pool.get(block=True, timeout=self.timeout)
+            except Empty:
+                # Note that this is not caught by the redis client and will be
+                # raised unless handled by application code. If you want never to
+                raise ConnectionError("No connection available.")
+
+            # If the ``connection`` is actually ``None`` then that's a cue to make
+            # a new connection to add to the pool.
+            if connection is None:
+                connection = self.make_connection()
+        finally:
+            if self._locked:
+                try:
+                    self._lock.release()
+                except Exception:
+                    pass
+                self._locked = False
 
         try:
             # ensure this connection is connected to Redis
@@ -1801,25 +2414,173 @@ def release(self, connection):
         "Releases the connection back to the pool."
         # Make sure we haven't changed process.
         self._checkpid()
-        if not self.owns_connection(connection):
-            # pool doesn't own this connection. do not add it back
-            # to the pool. instead add a None value which is a placeholder
-            # that will cause the pool to recreate the connection if
-            # its needed.
-            connection.disconnect()
-            self.pool.put_nowait(None)
-            return
 
-        # Put the connection back into the pool.
         try:
-            self.pool.put_nowait(connection)
-        except Full:
-            # perhaps the pool has been reset() after a fork? regardless,
-            # we don't want this connection
-            pass
+            if self._in_maintenance:
+                self._lock.acquire()
+                self._locked = True
+            if not self.owns_connection(connection):
+                # pool doesn't own this connection. do not add it back
+                # to the pool. instead add a None value which is a placeholder
+                # that will cause the pool to recreate the connection if
+                # its needed.
+                connection.disconnect()
+                self.pool.put_nowait(None)
+                return
+            if connection.should_reconnect():
+                connection.disconnect()
+            # Put the connection back into the pool.
+            try:
+                self.pool.put_nowait(connection)
+            except Full:
+                # perhaps the pool has been reset() after a fork? regardless,
+                # we don't want this connection
+                pass
+        finally:
+            if self._locked:
+                try:
+                    self._lock.release()
+                except Exception:
+                    pass
+                self._locked = False
 
     def disconnect(self):
         "Disconnects all connections in the pool."
         self._checkpid()
-        for connection in self._connections:
-            connection.disconnect()
+        try:
+            if self._in_maintenance:
+                self._lock.acquire()
+                self._locked = True
+            for connection in self._connections:
+                connection.disconnect()
+        finally:
+            if self._locked:
+                try:
+                    self._lock.release()
+                except Exception:
+                    pass
+                self._locked = False
+
+    def update_connections_settings(
+        self,
+        state: Optional["MaintenanceState"] = None,
+        maintenance_event_hash: Optional[int] = None,
+        relax_timeout: Optional[float] = None,
+        host_address: Optional[str] = None,
+        matching_address: Optional[str] = None,
+        matching_event_hash: Optional[int] = None,
+        matching_pattern: Literal[
+            "connected_address", "configured_address", "event_hash"
+        ] = "connected_address",
+        update_event_hash: bool = False,
+        reset_host_address: bool = False,
+        reset_relax_timeout: bool = False,
+        include_free_connections: bool = True,
+    ):
+        """
+        Override base class method to work with BlockingConnectionPool's structure.
+        """
+        with self._lock:
+            if include_free_connections:
+                for conn in tuple(self._connections):
+                    if self._should_update_connection(
+                        conn,
+                        matching_pattern,
+                        matching_address,
+                        matching_event_hash,
+                    ):
+                        self.update_connection_settings(
+                            conn,
+                            state=state,
+                            maintenance_event_hash=maintenance_event_hash,
+                            host_address=host_address,
+                            relax_timeout=relax_timeout,
+                            update_event_hash=update_event_hash,
+                            reset_host_address=reset_host_address,
+                            reset_relax_timeout=reset_relax_timeout,
+                        )
+            else:
+                connections_in_queue = {conn for conn in self.pool.queue if conn}
+                for conn in self._connections:
+                    if conn not in connections_in_queue:
+                        if self._should_update_connection(
+                            conn,
+                            matching_pattern,
+                            matching_address,
+                            matching_event_hash,
+                        ):
+                            self.update_connection_settings(
+                                conn,
+                                state=state,
+                                maintenance_event_hash=maintenance_event_hash,
+                                host_address=host_address,
+                                relax_timeout=relax_timeout,
+                                update_event_hash=update_event_hash,
+                                reset_host_address=reset_host_address,
+                                reset_relax_timeout=reset_relax_timeout,
+                            )
+
+    def update_active_connections_for_reconnect(
+        self,
+        moving_address_src: Optional[str] = None,
+    ):
+        """
+        Mark all active connections for reconnect.
+        This is used when a cluster node is migrated to a different address.
+
+        :param moving_address_src: The address of the node that is being moved.
+        """
+        with self._lock:
+            connections_in_queue = {conn for conn in self.pool.queue if conn}
+            for conn in self._connections:
+                if conn not in connections_in_queue:
+                    if self._should_update_connection(
+                        conn,
+                        matching_pattern="connected_address",
+                        matching_address=moving_address_src,
+                    ):
+                        conn.mark_for_reconnect()
+
+    def disconnect_free_connections(
+        self,
+        moving_address_src: Optional[str] = None,
+    ):
+        """
+        Disconnect all free/available connections.
+        This is used when a cluster node is migrated to a different address.
+
+        :param moving_address_src: The address of the node that is being moved.
+        """
+        with self._lock:
+            existing_connections = self.pool.queue
+
+            for conn in existing_connections:
+                if conn:
+                    if self._should_update_connection(
+                        conn, "connected_address", moving_address_src
+                    ):
+                        conn.disconnect()
+
+    def _update_maintenance_events_config_for_connections(
+        self, maintenance_events_config
+    ):
+        for conn in tuple(self._connections):
+            conn.maintenance_events_config = maintenance_events_config
+
+    def _update_maintenance_events_configs_for_connections(
+        self, maintenance_events_pool_handler
+    ):
+        """Update the maintenance events config for all connections in the pool."""
+        with self._lock:
+            for conn in tuple(self._connections):
+                conn.set_maintenance_event_pool_handler(maintenance_events_pool_handler)
+                conn.maintenance_events_config = maintenance_events_pool_handler.config
+
+    def set_in_maintenance(self, in_maintenance: bool):
+        """
+        Sets a flag that this Blocking ConnectionPool is in maintenance mode.
+
+        This is used to prevent new connections from being created while we are in maintenance mode.
+        The pool will be in maintenance mode only when we are processing a MOVING event.
+        """
+        self._in_maintenance = in_maintenance
diff --git a/redis/maintenance_events.py b/redis/maintenance_events.py
new file mode 100644
index 0000000000..cd22d29ed5
--- /dev/null
+++ b/redis/maintenance_events.py
@@ -0,0 +1,785 @@
+import enum
+import ipaddress
+import logging
+import re
+import threading
+import time
+from abc import ABC, abstractmethod
+from typing import TYPE_CHECKING, Optional, Union
+
+from redis.typing import Number
+
+
+class MaintenanceState(enum.Enum):
+    NONE = "none"
+    MOVING = "moving"
+    MAINTENANCE = "maintenance"
+
+
+class EndpointType(enum.Enum):
+    """Valid endpoint types used in CLIENT MAINT_NOTIFICATIONS command."""
+
+    INTERNAL_IP = "internal-ip"
+    INTERNAL_FQDN = "internal-fqdn"
+    EXTERNAL_IP = "external-ip"
+    EXTERNAL_FQDN = "external-fqdn"
+    NONE = "none"
+
+    def __str__(self):
+        """Return the string value of the enum."""
+        return self.value
+
+
+if TYPE_CHECKING:
+    from redis.connection import (
+        BlockingConnectionPool,
+        ConnectionInterface,
+        ConnectionPool,
+    )
+
+
+class MaintenanceEvent(ABC):
+    """
+    Base class for maintenance events sent through push messages by Redis server.
+
+    This class provides common functionality for all maintenance events including
+    unique identification and TTL (Time-To-Live) functionality.
+
+    Attributes:
+        id (int): Unique identifier for this event
+        ttl (int): Time-to-live in seconds for this notification
+        creation_time (float): Timestamp when the notification was created/read
+    """
+
+    def __init__(self, id: int, ttl: int):
+        """
+        Initialize a new MaintenanceEvent with unique ID and TTL functionality.
+
+        Args:
+            id (int): Unique identifier for this event
+            ttl (int): Time-to-live in seconds for this notification
+        """
+        self.id = id
+        self.ttl = ttl
+        self.creation_time = time.monotonic()
+        self.expire_at = self.creation_time + self.ttl
+
+    def is_expired(self) -> bool:
+        """
+        Check if this event has expired based on its TTL
+        and creation time.
+
+        Returns:
+            bool: True if the event has expired, False otherwise
+        """
+        return time.monotonic() > (self.creation_time + self.ttl)
+
+    @abstractmethod
+    def __repr__(self) -> str:
+        """
+        Return a string representation of the maintenance event.
+
+        This method must be implemented by all concrete subclasses.
+
+        Returns:
+            str: String representation of the event
+        """
+        pass
+
+    @abstractmethod
+    def __eq__(self, other) -> bool:
+        """
+        Compare two maintenance events for equality.
+
+        This method must be implemented by all concrete subclasses.
+        Events are typically considered equal if they have the same id
+        and are of the same type.
+
+        Args:
+            other: The other object to compare with
+
+        Returns:
+            bool: True if the events are equal, False otherwise
+        """
+        pass
+
+    @abstractmethod
+    def __hash__(self) -> int:
+        """
+        Return a hash value for the maintenance event.
+
+        This method must be implemented by all concrete subclasses to allow
+        instances to be used in sets and as dictionary keys.
+
+        Returns:
+            int: Hash value for the event
+        """
+        pass
+
+
+class NodeMovingEvent(MaintenanceEvent):
+    """
+    This event is received when a node is replaced with a new node
+    during cluster rebalancing or maintenance operations.
+    """
+
+    def __init__(
+        self,
+        id: int,
+        new_node_host: Optional[str],
+        new_node_port: Optional[int],
+        ttl: int,
+    ):
+        """
+        Initialize a new NodeMovingEvent.
+
+        Args:
+            id (int): Unique identifier for this event
+            new_node_host (str): Hostname or IP address of the new replacement node
+            new_node_port (int): Port number of the new replacement node
+            ttl (int): Time-to-live in seconds for this notification
+        """
+        super().__init__(id, ttl)
+        self.new_node_host = new_node_host
+        self.new_node_port = new_node_port
+
+    def __repr__(self) -> str:
+        expiry_time = self.expire_at
+        remaining = max(0, expiry_time - time.monotonic())
+
+        return (
+            f"{self.__class__.__name__}("
+            f"id={self.id}, "
+            f"new_node_host='{self.new_node_host}', "
+            f"new_node_port={self.new_node_port}, "
+            f"ttl={self.ttl}, "
+            f"creation_time={self.creation_time}, "
+            f"expires_at={expiry_time}, "
+            f"remaining={remaining:.1f}s, "
+            f"expired={self.is_expired()}"
+            f")"
+        )
+
+    def __eq__(self, other) -> bool:
+        """
+        Two NodeMovingEvent events are considered equal if they have the same
+        id, new_node_host, and new_node_port.
+        """
+        if not isinstance(other, NodeMovingEvent):
+            return False
+        return (
+            self.id == other.id
+            and self.new_node_host == other.new_node_host
+            and self.new_node_port == other.new_node_port
+        )
+
+    def __hash__(self) -> int:
+        """
+        Return a hash value for the event to allow
+        instances to be used in sets and as dictionary keys.
+
+        Returns:
+            int: Hash value based on event type class name, id,
+            new_node_host and new_node_port
+        """
+        try:
+            node_port = int(self.new_node_port) if self.new_node_port else None
+        except ValueError:
+            node_port = 0
+
+        return hash(
+            (
+                self.__class__.__name__,
+                int(self.id),
+                str(self.new_node_host),
+                node_port,
+            )
+        )
+
+
+class NodeMigratingEvent(MaintenanceEvent):
+    """
+    Event for when a Redis cluster node is in the process of migrating slots.
+
+    This event is received when a node starts migrating its slots to another node
+    during cluster rebalancing or maintenance operations.
+
+    Args:
+        id (int): Unique identifier for this event
+        ttl (int): Time-to-live in seconds for this notification
+    """
+
+    def __init__(self, id: int, ttl: int):
+        super().__init__(id, ttl)
+
+    def __repr__(self) -> str:
+        expiry_time = self.creation_time + self.ttl
+        remaining = max(0, expiry_time - time.monotonic())
+        return (
+            f"{self.__class__.__name__}("
+            f"id={self.id}, "
+            f"ttl={self.ttl}, "
+            f"creation_time={self.creation_time}, "
+            f"expires_at={expiry_time}, "
+            f"remaining={remaining:.1f}s, "
+            f"expired={self.is_expired()}"
+            f")"
+        )
+
+    def __eq__(self, other) -> bool:
+        """
+        Two NodeMigratingEvent events are considered equal if they have the same
+        id and are of the same type.
+        """
+        if not isinstance(other, NodeMigratingEvent):
+            return False
+        return self.id == other.id and type(self) is type(other)
+
+    def __hash__(self) -> int:
+        """
+        Return a hash value for the event to allow
+        instances to be used in sets and as dictionary keys.
+
+        Returns:
+            int: Hash value based on event type and id
+        """
+        return hash((self.__class__.__name__, int(self.id)))
+
+
+class NodeMigratedEvent(MaintenanceEvent):
+    """
+    Event for when a Redis cluster node has completed migrating slots.
+
+    This event is received when a node has finished migrating all its slots
+    to other nodes during cluster rebalancing or maintenance operations.
+
+    Args:
+        id (int): Unique identifier for this event
+    """
+
+    DEFAULT_TTL = 5
+
+    def __init__(self, id: int):
+        super().__init__(id, NodeMigratedEvent.DEFAULT_TTL)
+
+    def __repr__(self) -> str:
+        expiry_time = self.creation_time + self.ttl
+        remaining = max(0, expiry_time - time.monotonic())
+        return (
+            f"{self.__class__.__name__}("
+            f"id={self.id}, "
+            f"ttl={self.ttl}, "
+            f"creation_time={self.creation_time}, "
+            f"expires_at={expiry_time}, "
+            f"remaining={remaining:.1f}s, "
+            f"expired={self.is_expired()}"
+            f")"
+        )
+
+    def __eq__(self, other) -> bool:
+        """
+        Two NodeMigratedEvent events are considered equal if they have the same
+        id and are of the same type.
+        """
+        if not isinstance(other, NodeMigratedEvent):
+            return False
+        return self.id == other.id and type(self) is type(other)
+
+    def __hash__(self) -> int:
+        """
+        Return a hash value for the event to allow
+        instances to be used in sets and as dictionary keys.
+
+        Returns:
+            int: Hash value based on event type and id
+        """
+        return hash((self.__class__.__name__, int(self.id)))
+
+
+class NodeFailingOverEvent(MaintenanceEvent):
+    """
+    Event for when a Redis cluster node is in the process of failing over.
+
+    This event is received when a node starts a failover process during
+    cluster maintenance operations or when handling node failures.
+
+    Args:
+        id (int): Unique identifier for this event
+        ttl (int): Time-to-live in seconds for this notification
+    """
+
+    def __init__(self, id: int, ttl: int):
+        super().__init__(id, ttl)
+
+    def __repr__(self) -> str:
+        expiry_time = self.creation_time + self.ttl
+        remaining = max(0, expiry_time - time.monotonic())
+        return (
+            f"{self.__class__.__name__}("
+            f"id={self.id}, "
+            f"ttl={self.ttl}, "
+            f"creation_time={self.creation_time}, "
+            f"expires_at={expiry_time}, "
+            f"remaining={remaining:.1f}s, "
+            f"expired={self.is_expired()}"
+            f")"
+        )
+
+    def __eq__(self, other) -> bool:
+        """
+        Two NodeFailingOverEvent events are considered equal if they have the same
+        id and are of the same type.
+        """
+        if not isinstance(other, NodeFailingOverEvent):
+            return False
+        return self.id == other.id and type(self) is type(other)
+
+    def __hash__(self) -> int:
+        """
+        Return a hash value for the event to allow
+        instances to be used in sets and as dictionary keys.
+
+        Returns:
+            int: Hash value based on event type and id
+        """
+        return hash((self.__class__.__name__, int(self.id)))
+
+
+class NodeFailedOverEvent(MaintenanceEvent):
+    """
+    Event for when a Redis cluster node has completed a failover.
+
+    This event is received when a node has finished the failover process
+    during cluster maintenance operations or after handling node failures.
+
+    Args:
+        id (int): Unique identifier for this event
+    """
+
+    DEFAULT_TTL = 5
+
+    def __init__(self, id: int):
+        super().__init__(id, NodeFailedOverEvent.DEFAULT_TTL)
+
+    def __repr__(self) -> str:
+        expiry_time = self.creation_time + self.ttl
+        remaining = max(0, expiry_time - time.monotonic())
+        return (
+            f"{self.__class__.__name__}("
+            f"id={self.id}, "
+            f"ttl={self.ttl}, "
+            f"creation_time={self.creation_time}, "
+            f"expires_at={expiry_time}, "
+            f"remaining={remaining:.1f}s, "
+            f"expired={self.is_expired()}"
+            f")"
+        )
+
+    def __eq__(self, other) -> bool:
+        """
+        Two NodeFailedOverEvent events are considered equal if they have the same
+        id and are of the same type.
+        """
+        if not isinstance(other, NodeFailedOverEvent):
+            return False
+        return self.id == other.id and type(self) is type(other)
+
+    def __hash__(self) -> int:
+        """
+        Return a hash value for the event to allow
+        instances to be used in sets and as dictionary keys.
+
+        Returns:
+            int: Hash value based on event type and id
+        """
+        return hash((self.__class__.__name__, int(self.id)))
+
+
+def _is_private_fqdn(host: str) -> bool:
+    """
+    Determine if an FQDN is likely to be internal/private.
+
+    This uses heuristics based on RFC 952 and RFC 1123 standards:
+    - .local domains (RFC 6762 - Multicast DNS)
+    - .internal domains (common internal convention)
+    - Single-label hostnames (no dots)
+    - Common internal TLDs
+
+    Args:
+        host (str): The FQDN to check
+
+    Returns:
+        bool: True if the FQDN appears to be internal/private
+    """
+    host_lower = host.lower().rstrip(".")
+
+    # Single-label hostnames (no dots) are typically internal
+    if "." not in host_lower:
+        return True
+
+    # Common internal/private domain patterns
+    internal_patterns = [
+        r"\.local$",  # mDNS/Bonjour domains
+        r"\.internal$",  # Common internal convention
+        r"\.corp$",  # Corporate domains
+        r"\.lan$",  # Local area network
+        r"\.intranet$",  # Intranet domains
+        r"\.private$",  # Private domains
+    ]
+
+    for pattern in internal_patterns:
+        if re.search(pattern, host_lower):
+            return True
+
+    # If none of the internal patterns match, assume it's external
+    return False
+
+
+class MaintenanceEventsConfig:
+    """
+    Configuration class for maintenance events handling behaviour. Events are received through
+    push notifications.
+
+    This class defines how the Redis client should react to different push notifications
+    such as node moving, migrations, etc. in a Redis cluster.
+
+    """
+
+    def __init__(
+        self,
+        enabled: bool = True,
+        proactive_reconnect: bool = True,
+        relax_timeout: Optional[Number] = 20,
+        endpoint_type: Optional[EndpointType] = None,
+    ):
+        """
+        Initialize a new MaintenanceEventsConfig.
+
+        Args:
+            enabled (bool): Whether to enable maintenance events handling.
+                Defaults to False.
+            proactive_reconnect (bool): Whether to proactively reconnect when a node is replaced.
+                Defaults to True.
+            relax_timeout (Number): The relax timeout to use for the connection during maintenance.
+                If -1 is provided - the relax timeout is disabled. Defaults to 20.
+            endpoint_type (Optional[EndpointType]): Override for the endpoint type to use in CLIENT MAINT_NOTIFICATIONS.
+                If None, the endpoint type will be automatically determined based on the host and TLS configuration.
+                Defaults to None.
+
+        Raises:
+            ValueError: If endpoint_type is provided but is not a valid endpoint type.
+        """
+        self.enabled = enabled
+        self.relax_timeout = relax_timeout
+        self.proactive_reconnect = proactive_reconnect
+        self.endpoint_type = endpoint_type
+
+    def __repr__(self) -> str:
+        return (
+            f"{self.__class__.__name__}("
+            f"enabled={self.enabled}, "
+            f"proactive_reconnect={self.proactive_reconnect}, "
+            f"relax_timeout={self.relax_timeout}, "
+            f"endpoint_type={self.endpoint_type!r}"
+            f")"
+        )
+
+    def is_relax_timeouts_enabled(self) -> bool:
+        """
+        Check if the relax_timeout is enabled. The '-1' value is used to disable the relax_timeout.
+        If relax_timeout is set to None, it will make the operation blocking
+        and waiting until any response is received.
+
+        Returns:
+            True if the relax_timeout is enabled, False otherwise.
+        """
+        return self.relax_timeout != -1
+
+    def get_endpoint_type(
+        self, host: str, connection: "ConnectionInterface"
+    ) -> EndpointType:
+        """
+        Determine the appropriate endpoint type for CLIENT MAINT_NOTIFICATIONS command.
+
+        Logic:
+        1. If endpoint_type is explicitly set, use it
+        2. Otherwise, check the original host from connection.host:
+           - If host is an IP address, use it directly to determine internal-ip vs external-ip
+           - If host is an FQDN, get the resolved IP to determine internal-fqdn vs external-fqdn
+
+        Args:
+            host: User provided hostname to analyze
+            connection: The connection object to analyze for endpoint type determination
+
+        Returns:
+        """
+
+        # If endpoint_type is explicitly set, use it
+        if self.endpoint_type is not None:
+            return self.endpoint_type
+
+        # Check if the host is an IP address
+        try:
+            ip_addr = ipaddress.ip_address(host)
+            # Host is an IP address - use it directly
+            is_private = ip_addr.is_private
+            return EndpointType.INTERNAL_IP if is_private else EndpointType.EXTERNAL_IP
+        except ValueError:
+            # Host is an FQDN - need to check resolved IP to determine internal vs external
+            pass
+
+        # Host is an FQDN, get the resolved IP to determine if it's internal or external
+        resolved_ip = connection.get_resolved_ip()
+
+        if resolved_ip:
+            try:
+                ip_addr = ipaddress.ip_address(resolved_ip)
+                is_private = ip_addr.is_private
+                # Use FQDN types since the original host was an FQDN
+                return (
+                    EndpointType.INTERNAL_FQDN
+                    if is_private
+                    else EndpointType.EXTERNAL_FQDN
+                )
+            except ValueError:
+                # This shouldn't happen since we got the IP from the socket, but fallback
+                pass
+
+        # Final fallback: use heuristics on the FQDN itself
+        is_private = _is_private_fqdn(host)
+        return EndpointType.INTERNAL_FQDN if is_private else EndpointType.EXTERNAL_FQDN
+
+
+class MaintenanceEventPoolHandler:
+    def __init__(
+        self,
+        pool: Union["ConnectionPool", "BlockingConnectionPool"],
+        config: MaintenanceEventsConfig,
+    ) -> None:
+        self.pool = pool
+        self.config = config
+        self._processed_events = set()
+        self._lock = threading.RLock()
+        self.connection = None
+
+    def set_connection(self, connection: "ConnectionInterface"):
+        self.connection = connection
+
+    def remove_expired_notifications(self):
+        with self._lock:
+            for notification in tuple(self._processed_events):
+                if notification.is_expired():
+                    self._processed_events.remove(notification)
+
+    def handle_event(self, notification: MaintenanceEvent):
+        self.remove_expired_notifications()
+
+        if isinstance(notification, NodeMovingEvent):
+            return self.handle_node_moving_event(notification)
+        else:
+            logging.error(f"Unhandled notification type: {notification}")
+
+    def handle_node_moving_event(self, event: NodeMovingEvent):
+        if (
+            not self.config.proactive_reconnect
+            and not self.config.is_relax_timeouts_enabled()
+        ):
+            return
+        with self._lock:
+            if event in self._processed_events:
+                # nothing to do in the connection pool handling
+                # the event has already been handled or is expired
+                # just return
+                return
+
+            with self.pool._lock:
+                if (
+                    self.config.proactive_reconnect
+                    or self.config.is_relax_timeouts_enabled()
+                ):
+                    # Get the current connected address - if any
+                    # This is the address that is being moved
+                    # and we need to handle only connections
+                    # connected to the same address
+                    moving_address_src = (
+                        self.connection.getpeername() if self.connection else None
+                    )
+
+                    if getattr(self.pool, "set_in_maintenance", False):
+                        # Set pool in maintenance mode - executed only if
+                        # BlockingConnectionPool is used
+                        self.pool.set_in_maintenance(True)
+
+                    # Update maintenance state, timeout and optionally host address
+                    # connection settings for matching connections
+                    self.pool.update_connections_settings(
+                        state=MaintenanceState.MOVING,
+                        maintenance_event_hash=hash(event),
+                        relax_timeout=self.config.relax_timeout,
+                        host_address=event.new_node_host,
+                        matching_address=moving_address_src,
+                        matching_pattern="connected_address",
+                        update_event_hash=True,
+                        include_free_connections=True,
+                    )
+
+                    if self.config.proactive_reconnect:
+                        if event.new_node_host is not None:
+                            self.run_proactive_reconnect(moving_address_src)
+                        else:
+                            threading.Timer(
+                                event.ttl / 2,
+                                self.run_proactive_reconnect,
+                                args=(moving_address_src,),
+                            ).start()
+
+                    # Update config for new connections:
+                    # Set state to MOVING
+                    # update host
+                    # if relax timeouts are enabled - update timeouts
+                    kwargs: dict = {
+                        "maintenance_state": MaintenanceState.MOVING,
+                        "maintenance_event_hash": hash(event),
+                    }
+                    if event.new_node_host is not None:
+                        # the host is not updated if the new node host is None
+                        # this happens when the MOVING push notification does not contain
+                        # the new node host - in this case we only update the timeouts
+                        kwargs.update(
+                            {
+                                "host": event.new_node_host,
+                            }
+                        )
+                    if self.config.is_relax_timeouts_enabled():
+                        kwargs.update(
+                            {
+                                "socket_timeout": self.config.relax_timeout,
+                                "socket_connect_timeout": self.config.relax_timeout,
+                            }
+                        )
+                    self.pool.update_connection_kwargs(**kwargs)
+
+                    if getattr(self.pool, "set_in_maintenance", False):
+                        self.pool.set_in_maintenance(False)
+
+            threading.Timer(
+                event.ttl, self.handle_node_moved_event, args=(event,)
+            ).start()
+
+            self._processed_events.add(event)
+
+    def run_proactive_reconnect(self, moving_address_src: Optional[str] = None):
+        """
+        Run proactive reconnect for the pool.
+        Active connections are marked for reconnect after they complete the current command.
+        Inactive connections are disconnected and will be connected on next use.
+        """
+        with self._lock:
+            with self.pool._lock:
+                # take care for the active connections in the pool
+                # mark them for reconnect after they complete the current command
+                self.pool.update_active_connections_for_reconnect(
+                    moving_address_src=moving_address_src,
+                )
+                # take care for the inactive connections in the pool
+                # delete them and create new ones
+                self.pool.disconnect_free_connections(
+                    moving_address_src=moving_address_src,
+                )
+
+    def handle_node_moved_event(self, event: NodeMovingEvent):
+        """
+        Handle the cleanup after a node moving event expires.
+        """
+        event_hash = hash(event)
+
+        with self._lock:
+            # if the current maintenance_event_hash in kwargs is not matching the event
+            # it means there has been a new moving event after this one
+            # and we don't need to revert the kwargs yet
+            if self.pool.connection_kwargs.get("maintenance_event_hash") == event_hash:
+                orig_host = self.pool.connection_kwargs.get("orig_host_address")
+                orig_socket_timeout = self.pool.connection_kwargs.get(
+                    "orig_socket_timeout"
+                )
+                orig_connect_timeout = self.pool.connection_kwargs.get(
+                    "orig_socket_connect_timeout"
+                )
+                kwargs: dict = {
+                    "maintenance_state": MaintenanceState.NONE,
+                    "maintenance_event_hash": None,
+                    "host": orig_host,
+                    "socket_timeout": orig_socket_timeout,
+                    "socket_connect_timeout": orig_connect_timeout,
+                }
+                self.pool.update_connection_kwargs(**kwargs)
+
+            with self.pool._lock:
+                reset_relax_timeout = self.config.is_relax_timeouts_enabled()
+                reset_host_address = self.config.proactive_reconnect
+
+                self.pool.update_connections_settings(
+                    relax_timeout=-1,
+                    state=MaintenanceState.NONE,
+                    maintenance_event_hash=None,
+                    matching_event_hash=event_hash,
+                    matching_pattern="event_hash",
+                    update_event_hash=True,
+                    reset_relax_timeout=reset_relax_timeout,
+                    reset_host_address=reset_host_address,
+                    include_free_connections=True,
+                )
+
+
+class MaintenanceEventConnectionHandler:
+    # 1 = "starting maintenance" events, 0 = "completed maintenance" events
+    _EVENT_TYPES: dict[type["MaintenanceEvent"], int] = {
+        NodeMigratingEvent: 1,
+        NodeFailingOverEvent: 1,
+        NodeMigratedEvent: 0,
+        NodeFailedOverEvent: 0,
+    }
+
+    def __init__(
+        self, connection: "ConnectionInterface", config: MaintenanceEventsConfig
+    ) -> None:
+        self.connection = connection
+        self.config = config
+
+    def handle_event(self, event: MaintenanceEvent):
+        # get the event type by checking its class in the _EVENT_TYPES dict
+        event_type = self._EVENT_TYPES.get(event.__class__, None)
+
+        if event_type is None:
+            logging.error(f"Unhandled event type: {event}")
+            return
+
+        if event_type:
+            self.handle_maintenance_start_event(MaintenanceState.MAINTENANCE)
+        else:
+            self.handle_maintenance_completed_event()
+
+    def handle_maintenance_start_event(self, maintenance_state: MaintenanceState):
+        if (
+            self.connection.maintenance_state == MaintenanceState.MOVING
+            or not self.config.is_relax_timeouts_enabled()
+        ):
+            return
+
+        self.connection.maintenance_state = maintenance_state
+        self.connection.set_tmp_settings(tmp_relax_timeout=self.config.relax_timeout)
+        # extend the timeout for all created connections
+        self.connection.update_current_socket_timeout(self.config.relax_timeout)
+
+    def handle_maintenance_completed_event(self):
+        # Only reset timeouts if state is not MOVING and relax timeouts are enabled
+        if (
+            self.connection.maintenance_state == MaintenanceState.MOVING
+            or not self.config.is_relax_timeouts_enabled()
+        ):
+            return
+        self.connection.reset_tmp_settings(reset_relax_timeout=True)
+        # Maintenance completed - reset the connection
+        # timeouts by providing -1 as the relax timeout
+        self.connection.update_current_socket_timeout(-1)
+        self.connection.maintenance_state = MaintenanceState.NONE
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 3a4896f2a3..1eb68d3775 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -33,6 +33,9 @@ def connect(self):
     def can_read(self):
         return False
 
+    def should_reconnect(self):
+        return False
+
 
 class TestConnectionPool:
     def get_pool(
@@ -50,10 +53,14 @@ def get_pool(
         return pool
 
     def test_connection_creation(self):
-        connection_kwargs = {"foo": "bar", "biz": "baz"}
+        connection_kwargs = {
+            "foo": "bar",
+            "biz": "baz",
+        }
         pool = self.get_pool(
             connection_kwargs=connection_kwargs, connection_class=DummyConnection
         )
+
         connection = pool.get_connection()
         assert isinstance(connection, DummyConnection)
         assert connection.kwargs == connection_kwargs
@@ -149,6 +156,7 @@ def test_connection_creation(self, master_host):
             "host": master_host[0],
             "port": master_host[1],
         }
+
         pool = self.get_pool(connection_kwargs=connection_kwargs)
         connection = pool.get_connection()
         assert isinstance(connection, DummyConnection)
diff --git a/tests/test_maintenance_events.py b/tests/test_maintenance_events.py
new file mode 100644
index 0000000000..916c93b9ad
--- /dev/null
+++ b/tests/test_maintenance_events.py
@@ -0,0 +1,869 @@
+import threading
+from unittest.mock import Mock, call, patch, MagicMock
+import pytest
+
+from redis.connection import ConnectionInterface
+
+from redis.maintenance_events import (
+    MaintenanceEvent,
+    NodeMovingEvent,
+    NodeMigratingEvent,
+    NodeMigratedEvent,
+    NodeFailingOverEvent,
+    NodeFailedOverEvent,
+    MaintenanceEventsConfig,
+    MaintenanceEventPoolHandler,
+    MaintenanceEventConnectionHandler,
+    MaintenanceState,
+    EndpointType,
+)
+
+
+class TestMaintenanceEvent:
+    """Test the base MaintenanceEvent class functionality through concrete subclasses."""
+
+    def test_abstract_class_cannot_be_instantiated(self):
+        """Test that MaintenanceEvent cannot be instantiated directly."""
+        with patch("time.monotonic", return_value=1000):
+            with pytest.raises(TypeError):
+                MaintenanceEvent(id=1, ttl=10)  # type: ignore
+
+    def test_init_through_subclass(self):
+        """Test MaintenanceEvent initialization through concrete subclass."""
+        with patch("time.monotonic", return_value=1000):
+            event = NodeMovingEvent(
+                id=1, new_node_host="localhost", new_node_port=6379, ttl=10
+            )
+            assert event.id == 1
+            assert event.ttl == 10
+            assert event.creation_time == 1000
+            assert event.expire_at == 1010
+
+    @pytest.mark.parametrize(
+        ("current_time", "expected_expired_state"),
+        [
+            (1005, False),
+            (1015, True),
+        ],
+    )
+    def test_is_expired(self, current_time, expected_expired_state):
+        """Test is_expired returns False for non-expired event."""
+        with patch("time.monotonic", return_value=1000):
+            event = NodeMovingEvent(
+                id=1, new_node_host="localhost", new_node_port=6379, ttl=10
+            )
+
+        with patch("time.monotonic", return_value=current_time):
+            assert event.is_expired() == expected_expired_state
+
+    def test_is_expired_exact_boundary(self):
+        """Test is_expired at exact expiration boundary."""
+        with patch("time.monotonic", return_value=1000):
+            event = NodeMovingEvent(
+                id=1, new_node_host="localhost", new_node_port=6379, ttl=10
+            )
+
+        with patch("time.monotonic", return_value=1010):  # Exactly at expiration
+            assert not event.is_expired()
+
+        with patch("time.monotonic", return_value=1011):  # 1 second past expiration
+            assert event.is_expired()
+
+
+class TestNodeMovingEvent:
+    """Test the NodeMovingEvent class."""
+
+    def test_init(self):
+        """Test NodeMovingEvent initialization."""
+        with patch("time.monotonic", return_value=1000):
+            event = NodeMovingEvent(
+                id=1, new_node_host="localhost", new_node_port=6379, ttl=10
+            )
+            assert event.id == 1
+            assert event.new_node_host == "localhost"
+            assert event.new_node_port == 6379
+            assert event.ttl == 10
+            assert event.creation_time == 1000
+
+    def test_repr(self):
+        """Test NodeMovingEvent string representation."""
+        with patch("time.monotonic", return_value=1000):
+            event = NodeMovingEvent(
+                id=1, new_node_host="localhost", new_node_port=6379, ttl=10
+            )
+
+        with patch("time.monotonic", return_value=1005):  # 5 seconds later
+            repr_str = repr(event)
+            assert "NodeMovingEvent" in repr_str
+            assert "id=1" in repr_str
+            assert "new_node_host='localhost'" in repr_str
+            assert "new_node_port=6379" in repr_str
+            assert "ttl=10" in repr_str
+            assert "remaining=5.0s" in repr_str
+            assert "expired=False" in repr_str
+
+    def test_equality_none_id_none_port(self):
+        """Test equality for events with same id and host and port - None."""
+        event1 = NodeMovingEvent(id=1, new_node_host=None, new_node_port=None, ttl=10)
+        event2 = NodeMovingEvent(
+            id=1, new_node_host=None, new_node_port=None, ttl=20
+        )  # Different TTL
+        assert event1 == event2
+
+    def test_equality_same_id_host_port(self):
+        """Test equality for events with same id, host, and port."""
+        event1 = NodeMovingEvent(
+            id=1, new_node_host="localhost", new_node_port=6379, ttl=10
+        )
+        event2 = NodeMovingEvent(
+            id=1, new_node_host="localhost", new_node_port=6379, ttl=20
+        )  # Different TTL
+        assert event1 == event2
+
+    def test_equality_same_id_different_host(self):
+        """Test inequality for events with same id but different host."""
+        event1 = NodeMovingEvent(
+            id=1, new_node_host="host1", new_node_port=6379, ttl=10
+        )
+        event2 = NodeMovingEvent(
+            id=1, new_node_host="host2", new_node_port=6379, ttl=10
+        )
+        assert event1 != event2
+
+    def test_equality_same_id_different_port(self):
+        """Test inequality for events with same id but different port."""
+        event1 = NodeMovingEvent(
+            id=1, new_node_host="localhost", new_node_port=6379, ttl=10
+        )
+        event2 = NodeMovingEvent(
+            id=1, new_node_host="localhost", new_node_port=6380, ttl=10
+        )
+        assert event1 != event2
+
+    def test_equality_different_id(self):
+        """Test inequality for events with different id."""
+        event1 = NodeMovingEvent(
+            id=1, new_node_host="localhost", new_node_port=6379, ttl=10
+        )
+        event2 = NodeMovingEvent(
+            id=2, new_node_host="localhost", new_node_port=6379, ttl=10
+        )
+        assert event1 != event2
+
+    def test_equality_different_type(self):
+        """Test inequality for events of different types."""
+        event1 = NodeMovingEvent(
+            id=1, new_node_host="localhost", new_node_port=6379, ttl=10
+        )
+        event2 = NodeMigratingEvent(id=1, ttl=10)
+        assert event1 != event2
+
+    def test_hash_same_id_host_port(self):
+        """Test hash consistency for events with same id, host, and port."""
+        event1 = NodeMovingEvent(
+            id=1, new_node_host="localhost", new_node_port=6379, ttl=10
+        )
+        event2 = NodeMovingEvent(
+            id=1, new_node_host="localhost", new_node_port=6379, ttl=20
+        )  # Different TTL
+        assert hash(event1) == hash(event2)
+
+    def test_hash_different_host(self):
+        """Test hash difference for events with different host."""
+        event1 = NodeMovingEvent(
+            id=1, new_node_host="host1", new_node_port=6379, ttl=10
+        )
+        event2 = NodeMovingEvent(
+            id=1, new_node_host="host2", new_node_port=6379, ttl=10
+        )
+        assert hash(event1) != hash(event2)
+
+    def test_hash_different_port(self):
+        """Test hash difference for events with different port."""
+        event1 = NodeMovingEvent(
+            id=1, new_node_host="localhost", new_node_port=6379, ttl=10
+        )
+        event2 = NodeMovingEvent(
+            id=1, new_node_host="localhost", new_node_port=6380, ttl=10
+        )
+        assert hash(event1) != hash(event2)
+
+    def test_hash_different_id(self):
+        """Test hash difference for events with different id."""
+        event1 = NodeMovingEvent(
+            id=1, new_node_host="localhost", new_node_port=6379, ttl=10
+        )
+        event2 = NodeMovingEvent(
+            id=2, new_node_host="localhost", new_node_port=6379, ttl=10
+        )
+        assert hash(event1) != hash(event2)
+
+    def test_set_functionality(self):
+        """Test that events can be used in sets correctly."""
+        event1 = NodeMovingEvent(
+            id=1, new_node_host="localhost", new_node_port=6379, ttl=10
+        )
+        event2 = NodeMovingEvent(
+            id=1, new_node_host="localhost", new_node_port=6379, ttl=20
+        )  # Same id, host, port - should be considered the same
+        event3 = NodeMovingEvent(
+            id=1, new_node_host="host2", new_node_port=6380, ttl=10
+        )  # Same id but different host/port - should be different
+        event4 = NodeMovingEvent(
+            id=2, new_node_host="localhost", new_node_port=6379, ttl=10
+        )  # Different id - should be different
+
+        event_set = {event1, event2, event3, event4}
+        assert len(event_set) == 3  # event1 and event2 should be considered the same
+
+
+class TestNodeMigratingEvent:
+    """Test the NodeMigratingEvent class."""
+
+    def test_init(self):
+        """Test NodeMigratingEvent initialization."""
+        with patch("time.monotonic", return_value=1000):
+            event = NodeMigratingEvent(id=1, ttl=5)
+            assert event.id == 1
+            assert event.ttl == 5
+            assert event.creation_time == 1000
+
+    def test_repr(self):
+        """Test NodeMigratingEvent string representation."""
+        with patch("time.monotonic", return_value=1000):
+            event = NodeMigratingEvent(id=1, ttl=5)
+
+        with patch("time.monotonic", return_value=1002):  # 2 seconds later
+            repr_str = repr(event)
+            assert "NodeMigratingEvent" in repr_str
+            assert "id=1" in repr_str
+            assert "ttl=5" in repr_str
+            assert "remaining=3.0s" in repr_str
+            assert "expired=False" in repr_str
+
+    def test_equality_and_hash(self):
+        """Test equality and hash for NodeMigratingEvent."""
+        event1 = NodeMigratingEvent(id=1, ttl=5)
+        event2 = NodeMigratingEvent(id=1, ttl=10)  # Same id, different ttl
+        event3 = NodeMigratingEvent(id=2, ttl=5)  # Different id
+
+        assert event1 == event2
+        assert event1 != event3
+        assert hash(event1) == hash(event2)
+        assert hash(event1) != hash(event3)
+
+
+class TestNodeMigratedEvent:
+    """Test the NodeMigratedEvent class."""
+
+    def test_init(self):
+        """Test NodeMigratedEvent initialization."""
+        with patch("time.monotonic", return_value=1000):
+            event = NodeMigratedEvent(id=1)
+            assert event.id == 1
+            assert event.ttl == NodeMigratedEvent.DEFAULT_TTL
+            assert event.creation_time == 1000
+
+    def test_default_ttl(self):
+        """Test that DEFAULT_TTL is used correctly."""
+        assert NodeMigratedEvent.DEFAULT_TTL == 5
+        event = NodeMigratedEvent(id=1)
+        assert event.ttl == 5
+
+    def test_repr(self):
+        """Test NodeMigratedEvent string representation."""
+        with patch("time.monotonic", return_value=1000):
+            event = NodeMigratedEvent(id=1)
+
+        with patch("time.monotonic", return_value=1001):  # 1 second later
+            repr_str = repr(event)
+            assert "NodeMigratedEvent" in repr_str
+            assert "id=1" in repr_str
+            assert "ttl=5" in repr_str
+            assert "remaining=4.0s" in repr_str
+            assert "expired=False" in repr_str
+
+    def test_equality_and_hash(self):
+        """Test equality and hash for NodeMigratedEvent."""
+        event1 = NodeMigratedEvent(id=1)
+        event2 = NodeMigratedEvent(id=1)  # Same id
+        event3 = NodeMigratedEvent(id=2)  # Different id
+
+        assert event1 == event2
+        assert event1 != event3
+        assert hash(event1) == hash(event2)
+        assert hash(event1) != hash(event3)
+
+
+class TestNodeFailingOverEvent:
+    """Test the NodeFailingOverEvent class."""
+
+    def test_init(self):
+        """Test NodeFailingOverEvent initialization."""
+        with patch("time.monotonic", return_value=1000):
+            event = NodeFailingOverEvent(id=1, ttl=5)
+            assert event.id == 1
+            assert event.ttl == 5
+            assert event.creation_time == 1000
+
+    def test_repr(self):
+        """Test NodeFailingOverEvent string representation."""
+        with patch("time.monotonic", return_value=1000):
+            event = NodeFailingOverEvent(id=1, ttl=5)
+
+        with patch("time.monotonic", return_value=1002):  # 2 seconds later
+            repr_str = repr(event)
+            assert "NodeFailingOverEvent" in repr_str
+            assert "id=1" in repr_str
+            assert "ttl=5" in repr_str
+            assert "remaining=3.0s" in repr_str
+            assert "expired=False" in repr_str
+
+    def test_equality_and_hash(self):
+        """Test equality and hash for NodeFailingOverEvent."""
+        event1 = NodeFailingOverEvent(id=1, ttl=5)
+        event2 = NodeFailingOverEvent(id=1, ttl=10)  # Same id, different ttl
+        event3 = NodeFailingOverEvent(id=2, ttl=5)  # Different id
+
+        assert event1 == event2
+        assert event1 != event3
+        assert hash(event1) == hash(event2)
+        assert hash(event1) != hash(event3)
+
+
+class TestNodeFailedOverEvent:
+    """Test the NodeFailedOverEvent class."""
+
+    def test_init(self):
+        """Test NodeFailedOverEvent initialization."""
+        with patch("time.monotonic", return_value=1000):
+            event = NodeFailedOverEvent(id=1)
+            assert event.id == 1
+            assert event.ttl == NodeFailedOverEvent.DEFAULT_TTL
+            assert event.creation_time == 1000
+
+    def test_default_ttl(self):
+        """Test that DEFAULT_TTL is used correctly."""
+        assert NodeFailedOverEvent.DEFAULT_TTL == 5
+        event = NodeFailedOverEvent(id=1)
+        assert event.ttl == 5
+
+    def test_repr(self):
+        """Test NodeFailedOverEvent string representation."""
+        with patch("time.monotonic", return_value=1000):
+            event = NodeFailedOverEvent(id=1)
+
+        with patch("time.monotonic", return_value=1001):  # 1 second later
+            repr_str = repr(event)
+            assert "NodeFailedOverEvent" in repr_str
+            assert "id=1" in repr_str
+            assert "ttl=5" in repr_str
+            assert "remaining=4.0s" in repr_str
+            assert "expired=False" in repr_str
+
+    def test_equality_and_hash(self):
+        """Test equality and hash for NodeFailedOverEvent."""
+        event1 = NodeFailedOverEvent(id=1)
+        event2 = NodeFailedOverEvent(id=1)  # Same id
+        event3 = NodeFailedOverEvent(id=2)  # Different id
+
+        assert event1 == event2
+        assert event1 != event3
+        assert hash(event1) == hash(event2)
+        assert hash(event1) != hash(event3)
+
+
+class TestMaintenanceEventsConfig:
+    """Test the MaintenanceEventsConfig class."""
+
+    def test_init_defaults(self):
+        """Test MaintenanceEventsConfig initialization with defaults."""
+        config = MaintenanceEventsConfig()
+        assert config.enabled is True
+        assert config.proactive_reconnect is True
+        assert config.relax_timeout == 20
+
+    def test_init_custom_values(self):
+        """Test MaintenanceEventsConfig initialization with custom values."""
+        config = MaintenanceEventsConfig(
+            enabled=True, proactive_reconnect=False, relax_timeout=30
+        )
+        assert config.enabled is True
+        assert config.proactive_reconnect is False
+        assert config.relax_timeout == 30
+
+    def test_repr(self):
+        """Test MaintenanceEventsConfig string representation."""
+        config = MaintenanceEventsConfig(
+            enabled=True, proactive_reconnect=False, relax_timeout=30
+        )
+        repr_str = repr(config)
+        assert "MaintenanceEventsConfig" in repr_str
+        assert "enabled=True" in repr_str
+        assert "proactive_reconnect=False" in repr_str
+        assert "relax_timeout=30" in repr_str
+
+    def test_is_relax_timeouts_enabled_true(self):
+        """Test is_relax_timeouts_enabled returns True for positive timeout."""
+        config = MaintenanceEventsConfig(relax_timeout=20)
+        assert config.is_relax_timeouts_enabled() is True
+
+    def test_is_relax_timeouts_enabled_false(self):
+        """Test is_relax_timeouts_enabled returns False for -1 timeout."""
+        config = MaintenanceEventsConfig(relax_timeout=-1)
+        assert config.is_relax_timeouts_enabled() is False
+
+    def test_is_relax_timeouts_enabled_zero(self):
+        """Test is_relax_timeouts_enabled returns True for zero timeout."""
+        config = MaintenanceEventsConfig(relax_timeout=0)
+        assert config.is_relax_timeouts_enabled() is True
+
+    def test_is_relax_timeouts_enabled_none(self):
+        """Test is_relax_timeouts_enabled returns True for None timeout."""
+        config = MaintenanceEventsConfig(relax_timeout=None)
+        assert config.is_relax_timeouts_enabled() is True
+
+    def test_relax_timeout_none_is_saved_as_none(self):
+        """Test that None value for relax_timeout is saved as None."""
+        config = MaintenanceEventsConfig(relax_timeout=None)
+        assert config.relax_timeout is None
+
+
+class TestMaintenanceEventPoolHandler:
+    """Test the MaintenanceEventPoolHandler class."""
+
+    def setup_method(self):
+        """Set up test fixtures."""
+        self.mock_pool = Mock()
+        self.mock_pool._lock = MagicMock()
+        self.mock_pool._lock.__enter__.return_value = None
+        self.mock_pool._lock.__exit__.return_value = None
+        self.config = MaintenanceEventsConfig(
+            enabled=True, proactive_reconnect=True, relax_timeout=20
+        )
+        self.handler = MaintenanceEventPoolHandler(self.mock_pool, self.config)
+
+    def test_init(self):
+        """Test MaintenanceEventPoolHandler initialization."""
+        assert self.handler.pool == self.mock_pool
+        assert self.handler.config == self.config
+        assert isinstance(self.handler._processed_events, set)
+        assert isinstance(self.handler._lock, type(threading.RLock()))
+
+    def test_remove_expired_notifications(self):
+        """Test removal of expired notifications."""
+        with patch("time.monotonic", return_value=1000):
+            event1 = NodeMovingEvent(
+                id=1, new_node_host="host1", new_node_port=6379, ttl=10
+            )
+            event2 = NodeMovingEvent(
+                id=2, new_node_host="host2", new_node_port=6380, ttl=5
+            )
+            self.handler._processed_events.add(event1)
+            self.handler._processed_events.add(event2)
+
+        # Move time forward but not enough to expire event2 (expires at 1005)
+        with patch("time.monotonic", return_value=1003):
+            self.handler.remove_expired_notifications()
+            assert event1 in self.handler._processed_events
+            assert event2 in self.handler._processed_events  # Not expired yet
+
+        # Move time forward to expire event2 but not event1
+        with patch("time.monotonic", return_value=1006):
+            self.handler.remove_expired_notifications()
+            assert event1 in self.handler._processed_events
+            assert event2 not in self.handler._processed_events  # Now expired
+
+    def test_handle_event_node_moving(self):
+        """Test handling of NodeMovingEvent."""
+        event = NodeMovingEvent(
+            id=1, new_node_host="localhost", new_node_port=6379, ttl=10
+        )
+
+        with patch.object(self.handler, "handle_node_moving_event") as mock_handle:
+            self.handler.handle_event(event)
+            mock_handle.assert_called_once_with(event)
+
+    def test_handle_event_unknown_type(self):
+        """Test handling of unknown event type."""
+        event = NodeMigratingEvent(id=1, ttl=5)  # Not handled by pool handler
+
+        result = self.handler.handle_event(event)
+        assert result is None
+
+    def test_handle_node_moving_event_disabled_config(self):
+        """Test node moving event handling when both features are disabled."""
+        config = MaintenanceEventsConfig(proactive_reconnect=False, relax_timeout=-1)
+        handler = MaintenanceEventPoolHandler(self.mock_pool, config)
+        event = NodeMovingEvent(
+            id=1, new_node_host="localhost", new_node_port=6379, ttl=10
+        )
+
+        result = handler.handle_node_moving_event(event)
+        assert result is None
+        assert event not in handler._processed_events
+
+    def test_handle_node_moving_event_already_processed(self):
+        """Test node moving event handling when event already processed."""
+        event = NodeMovingEvent(
+            id=1, new_node_host="localhost", new_node_port=6379, ttl=10
+        )
+        self.handler._processed_events.add(event)
+
+        result = self.handler.handle_node_moving_event(event)
+        assert result is None
+
+    def test_handle_node_moving_event_success(self):
+        """Test successful node moving event handling."""
+        event = NodeMovingEvent(
+            id=1, new_node_host="localhost", new_node_port=6379, ttl=10
+        )
+
+        with (
+            patch("threading.Timer") as mock_timer,
+            patch("time.monotonic", return_value=1000),
+        ):
+            self.handler.handle_node_moving_event(event)
+
+            # Verify timer was started
+            mock_timer.assert_called_once_with(
+                event.ttl, self.handler.handle_node_moved_event, args=(event,)
+            )
+            mock_timer.return_value.start.assert_called_once()
+
+            # Verify event was added to processed set
+            assert event in self.handler._processed_events
+
+            # Verify pool methods were called
+            self.mock_pool.update_connections_settings.assert_called_once()
+
+    def test_handle_node_moving_event_with_no_host_and_port(self):
+        """Test successful node moving event handling."""
+        event = NodeMovingEvent(id=1, new_node_host=None, new_node_port=None, ttl=2)
+
+        with (
+            patch("threading.Timer") as mock_timer,
+            patch("time.monotonic", return_value=1000),
+        ):
+            self.handler.handle_node_moving_event(event)
+
+            # Verify timer was started
+            mock_timer.assert_has_calls(
+                [
+                    call(
+                        event.ttl / 2,
+                        self.handler.run_proactive_reconnect,
+                        args=(None,),
+                    ),
+                    call().start(),
+                    call(
+                        event.ttl, self.handler.handle_node_moved_event, args=(event,)
+                    ),
+                    call().start(),
+                ]
+            )
+
+            # Verify event was added to processed set
+            assert event in self.handler._processed_events
+
+            # Verify pool methods were called
+            self.mock_pool.update_connections_settings.assert_called_once()
+
+    def test_handle_node_moved_event(self):
+        """Test handling of node moved event (cleanup)."""
+        event = NodeMovingEvent(
+            id=1, new_node_host="localhost", new_node_port=6379, ttl=10
+        )
+        self.mock_pool.connection_kwargs = {"host": "localhost"}
+        self.handler.handle_node_moved_event(event)
+
+        # Verify cleanup methods were called
+        self.mock_pool.update_connections_settings.assert_called_once()
+
+
+class TestMaintenanceEventConnectionHandler:
+    """Test the MaintenanceEventConnectionHandler class."""
+
+    def setup_method(self):
+        """Set up test fixtures."""
+        self.mock_connection = Mock()
+        self.config = MaintenanceEventsConfig(enabled=True, relax_timeout=20)
+        self.handler = MaintenanceEventConnectionHandler(
+            self.mock_connection, self.config
+        )
+
+    def test_init(self):
+        """Test MaintenanceEventConnectionHandler initialization."""
+        assert self.handler.connection == self.mock_connection
+        assert self.handler.config == self.config
+
+    def test_handle_event_migrating(self):
+        """Test handling of NodeMigratingEvent."""
+        event = NodeMigratingEvent(id=1, ttl=5)
+
+        with patch.object(
+            self.handler, "handle_maintenance_start_event"
+        ) as mock_handle:
+            self.handler.handle_event(event)
+            mock_handle.assert_called_once_with(MaintenanceState.MAINTENANCE)
+
+    def test_handle_event_migrated(self):
+        """Test handling of NodeMigratedEvent."""
+        event = NodeMigratedEvent(id=1)
+
+        with patch.object(
+            self.handler, "handle_maintenance_completed_event"
+        ) as mock_handle:
+            self.handler.handle_event(event)
+            mock_handle.assert_called_once_with()
+
+    def test_handle_event_failing_over(self):
+        """Test handling of NodeFailingOverEvent."""
+        event = NodeFailingOverEvent(id=1, ttl=5)
+
+        with patch.object(
+            self.handler, "handle_maintenance_start_event"
+        ) as mock_handle:
+            self.handler.handle_event(event)
+            mock_handle.assert_called_once_with(MaintenanceState.MAINTENANCE)
+
+    def test_handle_event_failed_over(self):
+        """Test handling of NodeFailedOverEvent."""
+        event = NodeFailedOverEvent(id=1)
+
+        with patch.object(
+            self.handler, "handle_maintenance_completed_event"
+        ) as mock_handle:
+            self.handler.handle_event(event)
+            mock_handle.assert_called_once_with()
+
+    def test_handle_event_unknown_type(self):
+        """Test handling of unknown event type."""
+        event = NodeMovingEvent(
+            id=1, new_node_host="localhost", new_node_port=6379, ttl=10
+        )
+
+        result = self.handler.handle_event(event)
+        assert result is None
+
+    def test_handle_maintenance_start_event_disabled(self):
+        """Test maintenance start event handling when relax timeouts are disabled."""
+        config = MaintenanceEventsConfig(relax_timeout=-1)
+        handler = MaintenanceEventConnectionHandler(self.mock_connection, config)
+
+        result = handler.handle_maintenance_start_event(MaintenanceState.MAINTENANCE)
+
+        assert result is None
+        self.mock_connection.update_current_socket_timeout.assert_not_called()
+
+    def test_handle_maintenance_start_event_moving_state(self):
+        """Test maintenance start event handling when connection is in MOVING state."""
+        self.mock_connection.maintenance_state = MaintenanceState.MOVING
+
+        result = self.handler.handle_maintenance_start_event(
+            MaintenanceState.MAINTENANCE
+        )
+        assert result is None
+        self.mock_connection.update_current_socket_timeout.assert_not_called()
+
+    def test_handle_maintenance_start_event_success(self):
+        """Test successful maintenance start event handling for migrating."""
+        self.mock_connection.maintenance_state = MaintenanceState.NONE
+
+        self.handler.handle_maintenance_start_event(MaintenanceState.MAINTENANCE)
+
+        assert self.mock_connection.maintenance_state == MaintenanceState.MAINTENANCE
+        self.mock_connection.update_current_socket_timeout.assert_called_once_with(20)
+        self.mock_connection.set_tmp_settings.assert_called_once_with(
+            tmp_relax_timeout=20
+        )
+
+    def test_handle_maintenance_completed_event_disabled(self):
+        """Test maintenance completed event handling when relax timeouts are disabled."""
+        config = MaintenanceEventsConfig(relax_timeout=-1)
+        handler = MaintenanceEventConnectionHandler(self.mock_connection, config)
+
+        result = handler.handle_maintenance_completed_event()
+        assert result is None
+        self.mock_connection.update_current_socket_timeout.assert_not_called()
+
+    def test_handle_maintenance_completed_event_moving_state(self):
+        """Test maintenance completed event handling when connection is in MOVING state."""
+        self.mock_connection.maintenance_state = MaintenanceState.MOVING
+
+        result = self.handler.handle_maintenance_completed_event()
+        assert result is None
+        self.mock_connection.update_current_socket_timeout.assert_not_called()
+
+    def test_handle_maintenance_completed_event_success(self):
+        """Test successful maintenance completed event handling."""
+        self.mock_connection.maintenance_state = MaintenanceState.MAINTENANCE
+
+        self.handler.handle_maintenance_completed_event()
+
+        assert self.mock_connection.maintenance_state == MaintenanceState.NONE
+
+        self.mock_connection.update_current_socket_timeout.assert_called_once_with(-1)
+        self.mock_connection.reset_tmp_settings.assert_called_once_with(
+            reset_relax_timeout=True
+        )
+
+
+class TestEndpointType:
+    """Test the EndpointType class functionality."""
+
+    def test_endpoint_type_constants(self):
+        """Test that the EndpointType constants are correct."""
+        assert EndpointType.INTERNAL_IP.value == "internal-ip"
+        assert EndpointType.INTERNAL_FQDN.value == "internal-fqdn"
+        assert EndpointType.EXTERNAL_IP.value == "external-ip"
+        assert EndpointType.EXTERNAL_FQDN.value == "external-fqdn"
+        assert EndpointType.NONE.value == "none"
+
+
+class TestMaintenanceEventsConfigEndpointType:
+    """Test MaintenanceEventsConfig endpoint type functionality."""
+
+    def setup_method(self):
+        """Set up common mock classes for all tests."""
+
+        class MockSocket:
+            def __init__(self, resolved_ip):
+                self.resolved_ip = resolved_ip
+
+            def getpeername(self):
+                return (self.resolved_ip, 6379)
+
+        class MockConnection(ConnectionInterface):
+            def __init__(self, host, resolved_ip=None, is_ssl=False):
+                self.host = host
+                self.port = 6379
+                self._sock = MockSocket(resolved_ip) if resolved_ip else None
+                self.__class__.__name__ = "SSLConnection" if is_ssl else "Connection"
+
+            def get_resolved_ip(self):
+                # Call the actual method from AbstractConnection
+                from redis.connection import AbstractConnection
+
+                return AbstractConnection.get_resolved_ip(self)  # type: ignore
+
+        self.MockSocket = MockSocket
+        self.MockConnection = MockConnection
+
+    def test_config_validation_valid_endpoint_types(self):
+        """Test that MaintenanceEventsConfig accepts valid endpoint types."""
+        for endpoint_type in EndpointType:
+            config = MaintenanceEventsConfig(endpoint_type=endpoint_type)
+            assert config.endpoint_type == endpoint_type
+
+    def test_config_validation_none_endpoint_type(self):
+        """Test that MaintenanceEventsConfig accepts None as endpoint type."""
+        config = MaintenanceEventsConfig(endpoint_type=None)
+        assert config.endpoint_type is None
+
+    def test_endpoint_type_detection_ip_addresses(self):
+        """Test endpoint type detection for IP addresses."""
+        config = MaintenanceEventsConfig()
+
+        # Test private IPv4 addresses
+        conn1 = self.MockConnection("192.168.1.1", resolved_ip="192.168.1.1")
+        assert (
+            config.get_endpoint_type("192.168.1.1", conn1) == EndpointType.INTERNAL_IP
+        )
+
+        # Test public IPv4 addresses
+        conn2 = self.MockConnection("8.8.8.8", resolved_ip="8.8.8.8")
+        assert config.get_endpoint_type("8.8.8.8", conn2) == EndpointType.EXTERNAL_IP
+
+        # Test IPv6 loopback
+        conn3 = self.MockConnection("::1")
+        assert config.get_endpoint_type("::1", conn3) == EndpointType.INTERNAL_IP
+
+        # Test IPv6 public address
+        conn4 = self.MockConnection("2001:4860:4860::8888")
+        assert (
+            config.get_endpoint_type("2001:4860:4860::8888", conn4)
+            == EndpointType.EXTERNAL_IP
+        )
+
+    def test_endpoint_type_detection_fqdn_with_resolved_ip(self):
+        """Test endpoint type detection for FQDNs with resolved IP addresses."""
+        config = MaintenanceEventsConfig()
+
+        # Test FQDN resolving to private IP
+        conn1 = self.MockConnection(
+            "redis.internal.company.com", resolved_ip="192.168.1.1"
+        )
+        assert (
+            config.get_endpoint_type("redis.internal.company.com", conn1)
+            == EndpointType.INTERNAL_FQDN
+        )
+
+        # Test FQDN resolving to public IP
+        conn2 = self.MockConnection("db123.redis.com", resolved_ip="8.8.8.8")
+        assert (
+            config.get_endpoint_type("db123.redis.com", conn2)
+            == EndpointType.EXTERNAL_FQDN
+        )
+
+        # Test internal FQDN resolving to public IP (should use resolved IP)
+        conn3 = self.MockConnection(
+            "redis.internal.company.com", resolved_ip="10.8.8.8"
+        )
+        assert (
+            config.get_endpoint_type("redis.internal.company.com", conn3)
+            == EndpointType.INTERNAL_FQDN
+        )
+
+        # Test FQDN with TLS
+        conn4 = self.MockConnection(
+            "redis.internal.company.com", resolved_ip="192.168.1.1", is_ssl=True
+        )
+        assert (
+            config.get_endpoint_type("redis.internal.company.com", conn4)
+            == EndpointType.INTERNAL_FQDN
+        )
+
+        conn5 = self.MockConnection(
+            "db123.redis.com", resolved_ip="8.8.8.8", is_ssl=True
+        )
+        assert (
+            config.get_endpoint_type("db123.redis.com", conn5)
+            == EndpointType.EXTERNAL_FQDN
+        )
+
+    def test_endpoint_type_detection_fqdn_heuristics(self):
+        """Test endpoint type detection using FQDN heuristics when no resolved IP is available."""
+        config = MaintenanceEventsConfig()
+
+        # Test localhost (should be internal)
+        conn1 = self.MockConnection("localhost")
+        assert (
+            config.get_endpoint_type("localhost", conn1) == EndpointType.INTERNAL_FQDN
+        )
+
+        # Test .local domain (should be internal)
+        conn2 = self.MockConnection("server.local")
+        assert (
+            config.get_endpoint_type("server.local", conn2)
+            == EndpointType.INTERNAL_FQDN
+        )
+
+        # Test public domain (should be external)
+        conn3 = self.MockConnection("example.com")
+        assert (
+            config.get_endpoint_type("example.com", conn3) == EndpointType.EXTERNAL_FQDN
+        )
+
+    def test_endpoint_type_override(self):
+        """Test that configured endpoint_type overrides detection."""
+
+        # Test with endpoint_type set to NONE
+        config = MaintenanceEventsConfig(endpoint_type=EndpointType.NONE)
+        conn = self.MockConnection("localhost")
+
+        assert config.get_endpoint_type("localhost", conn) == EndpointType.NONE
+
+        # Test with endpoint_type set to EXTERNAL_IP
+        config = MaintenanceEventsConfig(endpoint_type=EndpointType.EXTERNAL_IP)
+        assert config.get_endpoint_type("localhost", conn) == EndpointType.EXTERNAL_IP
diff --git a/tests/test_maintenance_events_handling.py b/tests/test_maintenance_events_handling.py
new file mode 100644
index 0000000000..8cbaba5edc
--- /dev/null
+++ b/tests/test_maintenance_events_handling.py
@@ -0,0 +1,2177 @@
+import socket
+import threading
+from typing import List, Union
+from unittest.mock import patch
+
+import pytest
+from time import sleep
+
+from redis import Redis
+from redis.connection import (
+    AbstractConnection,
+    ConnectionPool,
+    BlockingConnectionPool,
+    MaintenanceState,
+)
+from redis.maintenance_events import (
+    MaintenanceEventsConfig,
+    NodeMigratingEvent,
+    NodeMigratedEvent,
+    NodeFailingOverEvent,
+    NodeFailedOverEvent,
+    MaintenanceEventPoolHandler,
+    NodeMovingEvent,
+)
+
+
+AFTER_MOVING_ADDRESS = "1.2.3.4:6379"
+DEFAULT_ADDRESS = "12.45.34.56:6379"
+MOVING_TIMEOUT = 1
+
+MOVING_EVENT = NodeMovingEvent(
+    id=1,
+    new_node_host=AFTER_MOVING_ADDRESS.split(":")[0],
+    new_node_port=int(AFTER_MOVING_ADDRESS.split(":")[1]),
+    ttl=MOVING_TIMEOUT,
+)
+
+MOVING_NONE_EVENT = NodeMovingEvent(
+    id=1,
+    new_node_host=None,
+    new_node_port=None,
+    ttl=MOVING_TIMEOUT,
+)
+
+
+class Helpers:
+    """Helper class containing static methods for validation in maintenance events tests."""
+
+    @staticmethod
+    def validate_in_use_connections_state(
+        in_use_connections: List[AbstractConnection],
+        expected_state=MaintenanceState.NONE,
+        expected_should_reconnect: Union[bool, str] = True,
+        expected_host_address=DEFAULT_ADDRESS.split(":")[0],
+        expected_socket_timeout=None,
+        expected_socket_connect_timeout=None,
+        expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+        expected_orig_socket_timeout=None,
+        expected_orig_socket_connect_timeout=None,
+        expected_current_socket_timeout=None,
+        expected_current_peername=DEFAULT_ADDRESS.split(":")[0],
+    ):
+        """Helper method to validate state of in-use connections."""
+
+        # validate in use connections are still working with set flag for reconnect
+        # and timeout is updated
+        for connection in in_use_connections:
+            if expected_should_reconnect != "any":
+                assert connection._should_reconnect == expected_should_reconnect
+            assert connection.host == expected_host_address
+            assert connection.socket_timeout == expected_socket_timeout
+            assert connection.socket_connect_timeout == expected_socket_connect_timeout
+            assert connection.orig_host_address == expected_orig_host_address
+            assert connection.orig_socket_timeout == expected_orig_socket_timeout
+            assert (
+                connection.orig_socket_connect_timeout
+                == expected_orig_socket_connect_timeout
+            )
+            if connection._sock is not None:
+                assert connection._sock.gettimeout() == expected_current_socket_timeout
+                assert connection._sock.connected is True
+                if expected_current_peername != "any":
+                    assert (
+                        connection._sock.getpeername()[0] == expected_current_peername
+                    )
+            assert connection.maintenance_state == expected_state
+
+    @staticmethod
+    def validate_free_connections_state(
+        pool,
+        should_be_connected_count=0,
+        connected_to_tmp_address=False,
+        tmp_address=AFTER_MOVING_ADDRESS.split(":")[0],
+        expected_state=MaintenanceState.MOVING,
+        expected_host_address=DEFAULT_ADDRESS.split(":")[0],
+        expected_socket_timeout=None,
+        expected_socket_connect_timeout=None,
+        expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+        expected_orig_socket_timeout=None,
+        expected_orig_socket_connect_timeout=None,
+    ):
+        """Helper method to validate state of free/available connections."""
+
+        if isinstance(pool, BlockingConnectionPool):
+            free_connections = [conn for conn in pool.pool.queue if conn is not None]
+        elif isinstance(pool, ConnectionPool):
+            free_connections = pool._available_connections
+        else:
+            raise ValueError(f"Unsupported pool type: {type(pool)}")
+
+        connected_count = 0
+        for connection in free_connections:
+            assert connection._should_reconnect is False
+            assert connection.host == expected_host_address
+            assert connection.socket_timeout == expected_socket_timeout
+            assert connection.socket_connect_timeout == expected_socket_connect_timeout
+            assert connection.orig_host_address == expected_orig_host_address
+            assert connection.orig_socket_timeout == expected_orig_socket_timeout
+            assert (
+                connection.orig_socket_connect_timeout
+                == expected_orig_socket_connect_timeout
+            )
+            assert connection.maintenance_state == expected_state
+            if expected_state == MaintenanceState.NONE:
+                assert connection.maintenance_event_hash is None
+
+            if connection._sock is not None:
+                assert connection._sock.connected is True
+                if connected_to_tmp_address and tmp_address != "any":
+                    assert connection._sock.getpeername()[0] == tmp_address
+                connected_count += 1
+        assert connected_count == should_be_connected_count
+
+    @staticmethod
+    def validate_conn_kwargs(
+        pool,
+        expected_maintenance_state,
+        expected_maintenance_event_hash,
+        expected_host_address,
+        expected_port,
+        expected_socket_timeout,
+        expected_socket_connect_timeout,
+        expected_orig_host_address,
+        expected_orig_socket_timeout,
+        expected_orig_socket_connect_timeout,
+    ):
+        """Helper method to validate connection kwargs."""
+        assert pool.connection_kwargs["maintenance_state"] == expected_maintenance_state
+        assert (
+            pool.connection_kwargs["maintenance_event_hash"]
+            == expected_maintenance_event_hash
+        )
+        assert pool.connection_kwargs["host"] == expected_host_address
+        assert pool.connection_kwargs["port"] == expected_port
+        assert pool.connection_kwargs["socket_timeout"] == expected_socket_timeout
+        assert (
+            pool.connection_kwargs["socket_connect_timeout"]
+            == expected_socket_connect_timeout
+        )
+        assert (
+            pool.connection_kwargs.get("orig_host_address", None)
+            == expected_orig_host_address
+        )
+        assert (
+            pool.connection_kwargs.get("orig_socket_timeout", None)
+            == expected_orig_socket_timeout
+        )
+        assert (
+            pool.connection_kwargs.get("orig_socket_connect_timeout", None)
+            == expected_orig_socket_connect_timeout
+        )
+
+
+class MockSocket:
+    """Mock socket that simulates Redis protocol responses."""
+
+    def __init__(self):
+        self.connected = False
+        self.address = None
+        self.sent_data = []
+        self.closed = False
+        self.command_count = 0
+        self.pending_responses = []
+        # Track socket timeout changes for maintenance events validation
+        self.timeout = None
+        self.thread_timeouts = {}  # Track last applied timeout per thread
+        self.moving_sent = False
+
+    def connect(self, address):
+        """Simulate socket connection."""
+        self.connected = True
+        self.address = address
+
+    def send(self, data):
+        """Simulate sending data to Redis."""
+        if self.closed:
+            raise ConnectionError("Socket is closed")
+        self.sent_data.append(data)
+
+        # Analyze the command and prepare appropriate response
+        if b"HELLO" in data:
+            response = b"%7\r\n$6\r\nserver\r\n$5\r\nredis\r\n$7\r\nversion\r\n$5\r\n7.0.0\r\n$5\r\nproto\r\n:3\r\n$2\r\nid\r\n:1\r\n$4\r\nmode\r\n$10\r\nstandalone\r\n$4\r\nrole\r\n$6\r\nmaster\r\n$7\r\nmodules\r\n*0\r\n"
+            self.pending_responses.append(response)
+        elif b"SET" in data:
+            response = b"+OK\r\n"
+
+            # Check if this is a key that should trigger a push message
+            if b"key_receive_migrating_" in data or b"key_receive_migrating" in data:
+                # MIGRATING push message before SET key_receive_migrating_X response
+                # Format: >3\r\n$9\r\nMIGRATING\r\n:1\r\n:10\r\n (3 elements: MIGRATING, id, ttl)
+                migrating_push = ">3\r\n$9\r\nMIGRATING\r\n:1\r\n:10\r\n"
+                response = migrating_push.encode() + response
+            elif b"key_receive_migrated_" in data or b"key_receive_migrated" in data:
+                # MIGRATED push message before SET key_receive_migrated_X response
+                # Format: >2\r\n$8\r\nMIGRATED\r\n:1\r\n (2 elements: MIGRATED, id)
+                migrated_push = ">2\r\n$8\r\nMIGRATED\r\n:1\r\n"
+                response = migrated_push.encode() + response
+            elif (
+                b"key_receive_failing_over_" in data
+                or b"key_receive_failing_over" in data
+            ):
+                # FAILING_OVER push message before SET key_receive_failing_over_X response
+                # Format: >3\r\n$12\r\nFAILING_OVER\r\n:1\r\n:10\r\n (3 elements: FAILING_OVER, id, ttl)
+                failing_over_push = ">3\r\n$12\r\nFAILING_OVER\r\n:1\r\n:10\r\n"
+
+                response = failing_over_push.encode() + response
+            elif (
+                b"key_receive_failed_over_" in data
+                or b"key_receive_failed_over" in data
+            ):
+                # FAILED_OVER push message before SET key_receive_failed_over_X response
+                # Format: >2\r\n$11\r\nFAILED_OVER\r\n:1\r\n (2 elements: FAILED_OVER, id)
+                failed_over_push = ">2\r\n$11\r\nFAILED_OVER\r\n:1\r\n"
+                response = failed_over_push.encode() + response
+            elif b"key_receive_moving_none_" in data:
+                # MOVING push message before SET key_receive_moving_none_X response
+                # Format: >4\r\n$6\r\nMOVING\r\n:1\r\n:1\r\n+null\r\n (4 elements: MOVING, id, ttl, null)
+                # Note: Using + instead of $ to send as simple string instead of bulk string
+                moving_push = (
+                    f">4\r\n$6\r\nMOVING\r\n:1\r\n:{MOVING_TIMEOUT}\r\n+null\r\n"
+                )
+                response = moving_push.encode() + response
+            elif b"key_receive_moving_" in data:
+                # MOVING push message before SET key_receive_moving_X response
+                # Format: >4\r\n$6\r\nMOVING\r\n:1\r\n:1\r\n+1.2.3.4:6379\r\n (4 elements: MOVING, id, ttl, host:port)
+                # Note: Using + instead of $ to send as simple string instead of bulk string
+                moving_push = f">4\r\n$6\r\nMOVING\r\n:1\r\n:{MOVING_TIMEOUT}\r\n+{AFTER_MOVING_ADDRESS}\r\n"
+                response = moving_push.encode() + response
+
+            self.pending_responses.append(response)
+        elif b"GET" in data:
+            # Extract key and provide appropriate response
+            if b"hello" in data:
+                response = b"$5\r\nworld\r\n"
+                self.pending_responses.append(response)
+            # Handle specific keys used in tests
+            elif b"key_receive_moving_0" in data:
+                self.pending_responses.append(b"$8\r\nvalue3_0\r\n")
+            elif b"key_receive_migrated_0" in data:
+                self.pending_responses.append(b"$13\r\nmigrated_value\r\n")
+            elif b"key_receive_migrating" in data:
+                self.pending_responses.append(b"$6\r\nvalue2\r\n")
+            elif b"key_receive_migrated" in data:
+                self.pending_responses.append(b"$6\r\nvalue3\r\n")
+            elif b"key_receive_failing_over" in data:
+                self.pending_responses.append(b"$6\r\nvalue4\r\n")
+            elif b"key_receive_failed_over" in data:
+                self.pending_responses.append(b"$6\r\nvalue5\r\n")
+            elif b"key1" in data:
+                self.pending_responses.append(b"$6\r\nvalue1\r\n")
+            else:
+                self.pending_responses.append(b"$-1\r\n")  # NULL response
+        else:
+            self.pending_responses.append(b"+OK\r\n")  # Default response
+
+        self.command_count += 1
+        return len(data)
+
+    def sendall(self, data):
+        """Simulate sending all data to Redis."""
+        return self.send(data)
+
+    def recv(self, bufsize):
+        """Simulate receiving data from Redis."""
+        if self.closed:
+            raise ConnectionError("Socket is closed")
+
+        # Use pending responses that were prepared when commands were sent
+        if self.pending_responses:
+            response = self.pending_responses.pop(0)
+            if b"MOVING" in response:
+                self.moving_sent = True
+            return response[:bufsize]  # Respect buffer size
+        else:
+            # No data available - this should block or raise an exception
+            # For can_read checks, we should indicate no data is available
+            import errno
+
+            raise BlockingIOError(errno.EAGAIN, "Resource temporarily unavailable")
+
+    def fileno(self):
+        """Return a fake file descriptor for select/poll operations."""
+        return 1  # Fake file descriptor
+
+    def close(self):
+        """Simulate closing the socket."""
+        self.closed = True
+        self.connected = False
+        self.address = None
+        self.timeout = None
+        self.thread_timeouts = {}
+
+    def settimeout(self, timeout):
+        """Simulate setting socket timeout and track changes per thread."""
+        self.timeout = timeout
+
+        # Track last applied timeout with thread_id information added
+        thread_id = threading.current_thread().ident
+        self.thread_timeouts[thread_id] = timeout
+
+    def gettimeout(self):
+        """Simulate getting socket timeout."""
+        return self.timeout
+
+    def setsockopt(self, level, optname, value):
+        """Simulate setting socket options."""
+        pass
+
+    def getpeername(self):
+        """Simulate getting peer name."""
+        return self.address
+
+    def getsockname(self):
+        """Simulate getting socket name."""
+        return (self.address.split(":")[0], 12345)
+
+    def shutdown(self, how):
+        """Simulate socket shutdown."""
+        pass
+
+
+class TestMaintenanceEventsHandlingSingleProxy:
+    """Integration tests for maintenance events handling with real connection pool."""
+
+    def setup_method(self):
+        """Set up test fixtures with mocked sockets."""
+        self.mock_sockets = []
+        self.original_socket = socket.socket
+
+        # Mock socket creation to return our mock sockets
+        def mock_socket_factory(*args, **kwargs):
+            mock_sock = MockSocket()
+            self.mock_sockets.append(mock_sock)
+            return mock_sock
+
+        self.socket_patcher = patch("socket.socket", side_effect=mock_socket_factory)
+        self.socket_patcher.start()
+
+        # Mock select.select to simulate data availability for reading
+        def mock_select(rlist, wlist, xlist, timeout=0):
+            # Check if any of the sockets in rlist have data available
+            ready_sockets = []
+            for sock in rlist:
+                if hasattr(sock, "connected") and sock.connected and not sock.closed:
+                    # Only return socket as ready if it actually has data to read
+                    if hasattr(sock, "pending_responses") and sock.pending_responses:
+                        ready_sockets.append(sock)
+                    # Don't return socket as ready just because it received commands
+                    # Only when there are actual responses available
+            return (ready_sockets, [], [])
+
+        self.select_patcher = patch("select.select", side_effect=mock_select)
+        self.select_patcher.start()
+
+        # Create maintenance events config
+        self.config = MaintenanceEventsConfig(
+            enabled=True, proactive_reconnect=True, relax_timeout=30
+        )
+
+    def teardown_method(self):
+        """Clean up test fixtures."""
+        self.socket_patcher.stop()
+        self.select_patcher.stop()
+
+    def _get_client(
+        self,
+        pool_class,
+        max_connections=10,
+        maintenance_events_config=None,
+        setup_pool_handler=False,
+    ):
+        """Helper method to create a pool and Redis client with maintenance events configuration.
+
+        Args:
+            pool_class: The connection pool class (ConnectionPool or BlockingConnectionPool)
+            max_connections: Maximum number of connections in the pool (default: 10)
+            maintenance_events_config: Optional MaintenanceEventsConfig to use. If not provided,
+                                     uses self.config from setup_method (default: None)
+            setup_pool_handler: Whether to set up pool handler for moving events (default: False)
+
+        Returns:
+            tuple: (test_pool, test_redis_client)
+        """
+        config = (
+            maintenance_events_config
+            if maintenance_events_config is not None
+            else self.config
+        )
+
+        test_pool = pool_class(
+            host=DEFAULT_ADDRESS.split(":")[0],
+            port=int(DEFAULT_ADDRESS.split(":")[1]),
+            max_connections=max_connections,
+            protocol=3,  # Required for maintenance events
+            maintenance_events_config=config,
+        )
+        test_redis_client = Redis(connection_pool=test_pool)
+
+        # Set up pool handler for moving events if requested
+        if setup_pool_handler:
+            pool_handler = MaintenanceEventPoolHandler(
+                test_redis_client.connection_pool, config
+            )
+            test_redis_client.connection_pool.set_maintenance_events_pool_handler(
+                pool_handler
+            )
+
+        return test_redis_client
+
+    def _validate_connection_handlers(self, conn, pool_handler, config):
+        """Helper method to validate connection handlers are properly set."""
+        # Test that the node moving handler function is correctly set
+        parser_handler = conn._parser.node_moving_push_handler_func
+        assert parser_handler is not None
+        assert hasattr(parser_handler, "__self__")
+        assert hasattr(parser_handler, "__func__")
+        assert parser_handler.__self__ is pool_handler
+        assert parser_handler.__func__ is pool_handler.handle_event.__func__
+
+        # Test that the maintenance handler function is correctly set
+        maintenance_handler = conn._parser.maintenance_push_handler_func
+        assert maintenance_handler is not None
+        assert hasattr(maintenance_handler, "__self__")
+        assert hasattr(maintenance_handler, "__func__")
+        # The maintenance handler should be bound to the connection's
+        # maintenance event connection handler
+        assert (
+            maintenance_handler.__self__ is conn._maintenance_event_connection_handler
+        )
+        assert (
+            maintenance_handler.__func__
+            is conn._maintenance_event_connection_handler.handle_event.__func__
+        )
+
+        # Validate that the connection's maintenance handler has the same config object
+        assert conn._maintenance_event_connection_handler.config is config
+
+    def _validate_current_timeout(self, expected_timeout, error_msg=None):
+        """Helper method to validate the current timeout for the calling thread."""
+        actual_timeout = None
+        # Get the actual thread ID from the current thread
+        current_thread_id = threading.current_thread().ident
+        for sock in self.mock_sockets:
+            if current_thread_id in sock.thread_timeouts:
+                actual_timeout = sock.thread_timeouts[current_thread_id]
+                break
+
+        assert actual_timeout == expected_timeout, (
+            f"{error_msg or ''}"
+            f"Expected timeout ({expected_timeout}), "
+            f"but found timeout: {actual_timeout}. "
+            f"All thread timeouts: {[sock.thread_timeouts for sock in self.mock_sockets]}",
+        )
+
+    def _validate_disconnected(self, expected_count):
+        """Helper method to validate all socket timeouts"""
+        disconnected_sockets_count = 0
+        for sock in self.mock_sockets:
+            if sock.closed:
+                disconnected_sockets_count += 1
+        assert disconnected_sockets_count == expected_count
+
+    def _validate_connected(self, expected_count):
+        """Helper method to validate all socket timeouts"""
+        connected_sockets_count = 0
+        for sock in self.mock_sockets:
+            if sock.connected:
+                connected_sockets_count += 1
+        assert connected_sockets_count == expected_count
+
+    def test_client_initialization(self):
+        """Test that Redis client is created with maintenance events configuration."""
+        # Create a pool and Redis client with maintenance events
+
+        test_redis_client = Redis(
+            protocol=3,  # Required for maintenance events
+            maintenance_events_config=self.config,
+        )
+
+        pool_handler = test_redis_client.connection_pool.connection_kwargs.get(
+            "maintenance_events_pool_handler"
+        )
+        assert pool_handler is not None
+        assert pool_handler.config == self.config
+
+        conn = test_redis_client.connection_pool.get_connection()
+        assert conn._should_reconnect is False
+        assert conn.orig_host_address == "localhost"
+        assert conn.orig_socket_timeout is None
+
+        # Test that the node moving handler function is correctly set by
+        # comparing the underlying function and instance
+        parser_handler = conn._parser.node_moving_push_handler_func
+        assert parser_handler is not None
+        assert hasattr(parser_handler, "__self__")
+        assert hasattr(parser_handler, "__func__")
+        assert parser_handler.__self__ is pool_handler
+        assert parser_handler.__func__ is pool_handler.handle_event.__func__
+
+        # Test that the maintenance handler function is correctly set
+        maintenance_handler = conn._parser.maintenance_push_handler_func
+        assert maintenance_handler is not None
+        assert hasattr(maintenance_handler, "__self__")
+        assert hasattr(maintenance_handler, "__func__")
+        # The maintenance handler should be bound to the connection's
+        # maintenance event connection handler
+        assert (
+            maintenance_handler.__self__ is conn._maintenance_event_connection_handler
+        )
+        assert (
+            maintenance_handler.__func__
+            is conn._maintenance_event_connection_handler.handle_event.__func__
+        )
+
+        # Validate that the connection's maintenance handler has the same config object
+        assert conn._maintenance_event_connection_handler.config is self.config
+
+    def test_maint_handler_init_for_existing_connections(self):
+        """Test that maintenance event handlers are properly set on existing and new connections
+        when configuration is enabled after client creation."""
+
+        # Create a Redis client with disabled maintenance events configuration
+        disabled_config = MaintenanceEventsConfig(enabled=False)
+        test_redis_client = Redis(
+            protocol=3,  # Required for maintenance events
+            maintenance_events_config=disabled_config,
+        )
+
+        # Extract an existing connection before enabling maintenance events
+        existing_conn = test_redis_client.connection_pool.get_connection()
+
+        # Verify that maintenance events are initially disabled
+        assert existing_conn._parser.node_moving_push_handler_func is None
+        assert existing_conn._maintenance_event_connection_handler is None
+        assert existing_conn._parser.maintenance_push_handler_func is None
+
+        # Create a new enabled configuration and set up pool handler
+        enabled_config = MaintenanceEventsConfig(
+            enabled=True, proactive_reconnect=True, relax_timeout=30
+        )
+        pool_handler = MaintenanceEventPoolHandler(
+            test_redis_client.connection_pool, enabled_config
+        )
+        test_redis_client.connection_pool.set_maintenance_events_pool_handler(
+            pool_handler
+        )
+
+        # Validate the existing connection after enabling maintenance events
+        # Both existing and new connections should now have full handler setup
+        self._validate_connection_handlers(existing_conn, pool_handler, enabled_config)
+
+        # Create a new connection and validate it has full handlers
+        new_conn = test_redis_client.connection_pool.get_connection()
+        self._validate_connection_handlers(new_conn, pool_handler, enabled_config)
+
+        # Clean up connections
+        test_redis_client.connection_pool.release(existing_conn)
+        test_redis_client.connection_pool.release(new_conn)
+
+    @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
+    def test_connection_pool_creation_with_maintenance_events(self, pool_class):
+        """Test that connection pools are created with maintenance events configuration."""
+        # Create a pool and Redis client with maintenance events
+        max_connections = 3 if pool_class == BlockingConnectionPool else 10
+        test_redis_client = self._get_client(
+            pool_class, max_connections=max_connections
+        )
+        test_pool = test_redis_client.connection_pool
+
+        try:
+            assert (
+                test_pool.connection_kwargs.get("maintenance_events_config")
+                == self.config
+            )
+            # Pool should have maintenance events enabled
+            assert test_pool.maintenance_events_pool_handler_enabled() is True
+
+            # Create and set a pool handler
+            pool_handler = MaintenanceEventPoolHandler(test_pool, self.config)
+            test_pool.set_maintenance_events_pool_handler(pool_handler)
+
+            # Validate that the handler is properly set on the pool
+            assert (
+                test_pool.connection_kwargs.get("maintenance_events_pool_handler")
+                == pool_handler
+            )
+            assert (
+                test_pool.connection_kwargs.get("maintenance_events_config")
+                == pool_handler.config
+            )
+
+            # Verify that the pool handler has the correct configuration
+            assert pool_handler.pool == test_pool
+            assert pool_handler.config == self.config
+
+        finally:
+            if hasattr(test_pool, "disconnect"):
+                test_pool.disconnect()
+
+    @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
+    def test_redis_operations_with_mock_sockets(self, pool_class):
+        """
+        Test basic Redis operations work with mocked sockets and proper response parsing.
+        Basically with test - the mocked socket is validated.
+        """
+        # Create a pool and Redis client with maintenance events
+        test_redis_client = self._get_client(pool_class, max_connections=5)
+
+        try:
+            # Perform Redis operations that should work with our improved mock responses
+            result_set = test_redis_client.set("hello", "world")
+            result_get = test_redis_client.get("hello")
+
+            # Verify operations completed successfully
+            assert result_set is True
+            assert result_get == b"world"
+
+            # Verify socket interactions
+            assert len(self.mock_sockets) >= 1
+            assert self.mock_sockets[0].connected
+            assert len(self.mock_sockets[0].sent_data) >= 2  # HELLO, SET, GET commands
+
+            # Verify that the connection has maintenance event handler
+            connection = test_redis_client.connection_pool.get_connection()
+            assert hasattr(connection, "_maintenance_event_connection_handler")
+            test_redis_client.connection_pool.release(connection)
+
+        finally:
+            if hasattr(test_redis_client.connection_pool, "disconnect"):
+                test_redis_client.connection_pool.disconnect()
+
+    def test_pool_handler_with_migrating_event(self):
+        """Test that pool handler correctly handles migrating events."""
+        # Create a pool and Redis client with maintenance events
+        test_redis_client = self._get_client(ConnectionPool)
+        test_pool = test_redis_client.connection_pool
+
+        try:
+            # Create and set a pool handler
+            pool_handler = MaintenanceEventPoolHandler(test_pool, self.config)
+
+            # Create a migrating event (not handled by pool handler)
+            migrating_event = NodeMigratingEvent(id=1, ttl=5)
+
+            # Mock the required functions
+            with (
+                patch.object(
+                    pool_handler, "remove_expired_notifications"
+                ) as mock_remove_expired,
+                patch.object(
+                    pool_handler, "handle_node_moving_event"
+                ) as mock_handle_moving,
+                patch("redis.maintenance_events.logging.error") as mock_logging_error,
+            ):
+                # Pool handler should return None for migrating events (not its responsibility)
+                pool_handler.handle_event(migrating_event)
+
+                # Validate that remove_expired_notifications has been called once
+                mock_remove_expired.assert_called_once()
+
+                # Validate that handle_node_moving_event hasn't been called
+                mock_handle_moving.assert_not_called()
+
+                # Validate that logging.error has been called once
+                mock_logging_error.assert_called_once()
+
+        finally:
+            if hasattr(test_pool, "disconnect"):
+                test_pool.disconnect()
+
+    @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
+    def test_migration_related_events_handling_integration(self, pool_class):
+        """
+        Test full integration of migration-related events (MIGRATING/MIGRATED) handling.
+
+        This test validates the complete migration lifecycle:
+        1. Executes 5 Redis commands sequentially
+        2. Injects MIGRATING push message before command 2 (SET key_receive_migrating)
+        3. Validates socket timeout is updated to relaxed value (30s) after MIGRATING
+        4. Executes commands 3-4 while timeout remains relaxed
+        5. Injects MIGRATED push message before command 5 (SET key_receive_migrated)
+        6. Validates socket timeout is restored after MIGRATED
+        7. Tests both ConnectionPool and BlockingConnectionPool implementations
+        8. Uses proper RESP3 push message format for realistic protocol simulation
+        """
+        # Create a pool and Redis client with maintenance events
+        test_redis_client = self._get_client(pool_class, max_connections=10)
+
+        try:
+            # Command 1: Initial command
+            key1 = "key1"
+            value1 = "value1"
+            result1 = test_redis_client.set(key1, value1)
+
+            # Validate Command 1 result
+            assert result1 is True, "Command 1 (SET key1) failed"
+
+            # Command 2: This SET command will receive MIGRATING push message before response
+            key_migrating = "key_receive_migrating"
+            value_migrating = "value2"
+            result2 = test_redis_client.set(key_migrating, value_migrating)
+
+            # Validate Command 2 result
+            assert result2 is True, "Command 2 (SET key_receive_migrating) failed"
+
+            # Step 4: Validate timeout was updated to relaxed value after MIGRATING
+            self._validate_current_timeout(30, "Right after MIGRATING is received. ")
+
+            # Command 3: Another command while timeout is still relaxed
+            result3 = test_redis_client.get(key1)
+
+            # Validate Command 3 result
+            expected_value3 = value1.encode()
+            assert result3 == expected_value3, (
+                f"Command 3 (GET key1) failed. Expected {expected_value3}, got {result3}"
+            )
+
+            # Command 4: Execute command (step 5)
+            result4 = test_redis_client.get(key_migrating)
+
+            # Validate Command 4 result
+            expected_value4 = value_migrating.encode()
+            assert result4 == expected_value4, (
+                f"Command 4 (GET key_receive_migrating) failed. Expected {expected_value4}, got {result4}"
+            )
+
+            # Step 6: Validate socket timeout is still relaxed during commands 3-4
+            self._validate_current_timeout(
+                30,
+                "Execute a command with a connection extracted from the pool (after it has received MIGRATING)",
+            )
+
+            # Command 5: This SET command will receive
+            # MIGRATED push message before actual response
+            key_migrated = "key_receive_migrated"
+            value_migrated = "value3"
+            result5 = test_redis_client.set(key_migrated, value_migrated)
+
+            # Validate Command 5 result
+            assert result5 is True, "Command 5 (SET key_receive_migrated) failed"
+
+            # Step 8: Validate socket timeout is reversed back to original after MIGRATED
+            self._validate_current_timeout(None)
+
+            # Verify maintenance events were processed correctly
+            # The key is that we have at least 1 socket and all operations succeeded
+            assert len(self.mock_sockets) >= 1, (
+                f"Expected at least 1 socket for operations, got {len(self.mock_sockets)}"
+            )
+
+        finally:
+            if hasattr(test_redis_client.connection_pool, "disconnect"):
+                test_redis_client.connection_pool.disconnect()
+
+    @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
+    def test_migrating_event_with_disabled_relax_timeout(self, pool_class):
+        """
+        Test maintenance events handling when relax timeout is disabled.
+
+        This test validates that when relax_timeout is disabled (-1):
+        1. MIGRATING, MIGRATED, FAILING_OVER, and FAILED_OVER events are received and processed
+        2. No timeout updates are applied to connections
+        3. Socket timeouts remain unchanged during all maintenance events
+        4. Tests both ConnectionPool and BlockingConnectionPool implementations
+        5. Tests the complete lifecycle: MIGRATING -> MIGRATED -> FAILING_OVER -> FAILED_OVER
+        """
+        # Create config with disabled relax timeout
+        disabled_config = MaintenanceEventsConfig(
+            enabled=True,
+            relax_timeout=-1,  # This means the relax timeout is Disabled
+        )
+
+        # Create a pool and Redis client with disabled relax timeout config
+        test_redis_client = self._get_client(
+            pool_class, max_connections=5, maintenance_events_config=disabled_config
+        )
+
+        try:
+            # Command 1: Initial command
+            key1 = "key1"
+            value1 = "value1"
+            result1 = test_redis_client.set(key1, value1)
+
+            # Validate Command 1 result
+            assert result1 is True, "Command 1 (SET key1) failed"
+
+            # Command 2: This SET command will receive MIGRATING push message before response
+            key_migrating = "key_receive_migrating"
+            value_migrating = "value2"
+            result2 = test_redis_client.set(key_migrating, value_migrating)
+
+            # Validate Command 2 result
+            assert result2 is True, "Command 2 (SET key_receive_migrating) failed"
+
+            # Validate timeout was NOT updated (relax is disabled)
+            # Should remain at default timeout (None), not relaxed to 30s
+            self._validate_current_timeout(None)
+
+            # Command 3: Another command to verify timeout remains unchanged
+            result3 = test_redis_client.get(key1)
+
+            # Validate Command 3 result
+            expected_value3 = value1.encode()
+            assert result3 == expected_value3, (
+                f"Command 3 (GET key1) failed. Expected: {expected_value3}, Got: {result3}"
+            )
+
+            # Command 4: This SET command will receive MIGRATED push message before response
+            key_migrated = "key_receive_migrated"
+            value_migrated = "value3"
+            result4 = test_redis_client.set(key_migrated, value_migrated)
+
+            # Validate Command 4 result
+            assert result4 is True, "Command 4 (SET key_receive_migrated) failed"
+
+            # Validate timeout is still NOT updated after MIGRATED (relax is disabled)
+            self._validate_current_timeout(None)
+
+            # Command 5: This SET command will receive FAILING_OVER push message before response
+            key_failing_over = "key_receive_failing_over"
+            value_failing_over = "value4"
+            result5 = test_redis_client.set(key_failing_over, value_failing_over)
+
+            # Validate Command 5 result
+            assert result5 is True, "Command 5 (SET key_receive_failing_over) failed"
+
+            # Validate timeout is still NOT updated after FAILING_OVER (relax is disabled)
+            self._validate_current_timeout(None)
+
+            # Command 6: Another command to verify timeout remains unchanged during failover
+            result6 = test_redis_client.get(key_failing_over)
+
+            # Validate Command 6 result
+            expected_value6 = value_failing_over.encode()
+            assert result6 == expected_value6, (
+                f"Command 6 (GET key_receive_failing_over) failed. Expected: {expected_value6}, Got: {result6}"
+            )
+
+            # Command 7: This SET command will receive FAILED_OVER push message before response
+            key_failed_over = "key_receive_failed_over"
+            value_failed_over = "value5"
+            result7 = test_redis_client.set(key_failed_over, value_failed_over)
+
+            # Validate Command 7 result
+            assert result7 is True, "Command 7 (SET key_receive_failed_over) failed"
+
+            # Validate timeout is still NOT updated after FAILED_OVER (relax is disabled)
+            self._validate_current_timeout(None)
+
+            # Command 8: Final command to verify timeout remains unchanged after all events
+            result8 = test_redis_client.get(key_failed_over)
+
+            # Validate Command 8 result
+            expected_value8 = value_failed_over.encode()
+            assert result8 == expected_value8, (
+                f"Command 8 (GET key_receive_failed_over) failed. Expected: {expected_value8}, Got: {result8}"
+            )
+
+            # Verify maintenance events were processed correctly
+            # The key is that we have at least 1 socket and all operations succeeded
+            assert len(self.mock_sockets) >= 1, (
+                f"Expected at least 1 socket for operations, got {len(self.mock_sockets)}"
+            )
+
+        finally:
+            if hasattr(test_redis_client.connection_pool, "disconnect"):
+                test_redis_client.connection_pool.disconnect()
+
+    @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
+    def test_failing_over_related_events_handling_integration(self, pool_class):
+        """
+        Test full integration of failing-over-related events (FAILING_OVER/FAILED_OVER) handling.
+
+        This test validates the complete FAILING_OVER -> FAILED_OVER lifecycle:
+        1. Executes 5 Redis commands sequentially
+        2. Injects FAILING_OVER push message before command 2 (SET key_receive_failing_over)
+        3. Validates socket timeout is updated to relaxed value (30s) after FAILING_OVER
+        4. Executes commands 3-4 while timeout remains relaxed
+        5. Injects FAILED_OVER push message before command 5 (SET key_receive_failed_over)
+        6. Validates socket timeout is restored after FAILED_OVER
+        7. Tests both ConnectionPool and BlockingConnectionPool implementations
+        8. Uses proper RESP3 push message format for realistic protocol simulation
+        """
+        # Create a pool and Redis client with maintenance events
+        test_redis_client = self._get_client(pool_class, max_connections=10)
+
+        try:
+            # Command 1: Initial command
+            key1 = "key1"
+            value1 = "value1"
+            result1 = test_redis_client.set(key1, value1)
+
+            # Validate Command 1 result
+            assert result1 is True, "Command 1 (SET key1) failed"
+
+            # Command 2: This SET command will receive FAILING_OVER push message before response
+            key_failing_over = "key_receive_failing_over"
+            value_failing_over = "value4"
+            result2 = test_redis_client.set(key_failing_over, value_failing_over)
+
+            # Validate Command 2 result
+            assert result2 is True, "Command 2 (SET key_receive_failing_over) failed"
+
+            # Step 4: Validate timeout was updated to relaxed value after MIGRATING
+            self._validate_current_timeout(30, "Right after FAILING_OVER is received. ")
+
+            # Command 3: Another command while timeout is still relaxed
+            result3 = test_redis_client.get(key1)
+
+            # Validate Command 3 result
+            expected_value3 = value1.encode()
+            assert result3 == expected_value3, (
+                f"Command 3 (GET key1) failed. Expected {expected_value3}, got {result3}"
+            )
+
+            # Command 4: Execute command (step 5)
+            result4 = test_redis_client.get(key_failing_over)
+
+            # Validate Command 4 result
+            expected_value4 = value_failing_over.encode()
+            assert result4 == expected_value4, (
+                f"Command 4 (GET key_receive_failing_over) failed. Expected {expected_value4}, got {result4}"
+            )
+
+            # Step 6: Validate socket timeout is still relaxed during commands 3-4
+            self._validate_current_timeout(
+                30,
+                "Execute a command with a connection extracted from the pool (after it has received FAILING_OVER)",
+            )
+
+            # Command 5: This SET command will receive
+            # FAILED_OVER push message before actual response
+            key_failed_over = "key_receive_failed_over"
+            value_migrated = "value3"
+            result5 = test_redis_client.set(key_failed_over, value_migrated)
+
+            # Validate Command 5 result
+            assert result5 is True, "Command 5 (SET key_receive_failed_over) failed"
+
+            # Step 8: Validate socket timeout is reversed back to original after FAILED_OVER
+            self._validate_current_timeout(None)
+
+            # Verify maintenance events were processed correctly
+            # The key is that we have at least 1 socket and all operations succeeded
+            assert len(self.mock_sockets) >= 1, (
+                f"Expected at least 1 socket for operations, got {len(self.mock_sockets)}"
+            )
+
+        finally:
+            if hasattr(test_redis_client.connection_pool, "disconnect"):
+                test_redis_client.connection_pool.disconnect()
+
+    @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
+    def test_moving_related_events_handling_integration(self, pool_class):
+        """
+        Test full integration of moving-related events (MOVING) handling with Redis commands.
+
+        This test validates the complete MOVING event lifecycle:
+        1. Creates multiple connections in the pool
+        2. Executes a Redis command that triggers a MOVING push message
+        3. Validates that pool configuration is updated with temporary
+           address and timeout - for new connections creation
+        4. Validates that existing connections are marked for disconnection
+        5. Tests both ConnectionPool and BlockingConnectionPool implementations
+        """
+        # Create a pool and Redis client with maintenance events and pool handler
+        test_redis_client = self._get_client(
+            pool_class, max_connections=10, setup_pool_handler=True
+        )
+
+        try:
+            # Create several connections and return them in the pool
+            connections = []
+            for _ in range(10):
+                connection = test_redis_client.connection_pool.get_connection()
+                connections.append(connection)
+
+            for connection in connections:
+                test_redis_client.connection_pool.release(connection)
+
+            # Take 5 connections to be "in use"
+            in_use_connections = []
+            for _ in range(5):
+                connection = test_redis_client.connection_pool.get_connection()
+                in_use_connections.append(connection)
+
+            # Validate all connections are connected prior MOVING event
+            self._validate_disconnected(0)
+
+            # Run command that will receive and handle MOVING event
+            key_moving = "key_receive_moving_0"
+            value_moving = "value3_0"
+            # the connection used for the command is expected to be reconnected to the new address
+            # before it is returned to the pool
+            result2 = test_redis_client.set(key_moving, value_moving)
+
+            # Validate Command 2 result
+            assert result2 is True, "Command 2 (SET key_receive_moving) failed"
+
+            # Validate pool and connections settings were updated according to MOVING event
+            expected_event_hash = hash(MOVING_EVENT)
+
+            Helpers.validate_conn_kwargs(
+                pool=test_redis_client.connection_pool,
+                expected_maintenance_state=MaintenanceState.MOVING,
+                expected_maintenance_event_hash=expected_event_hash,
+                expected_host_address=AFTER_MOVING_ADDRESS.split(":")[0],
+                expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
+                expected_socket_timeout=self.config.relax_timeout,
+                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_orig_socket_timeout=None,
+                expected_orig_socket_connect_timeout=None,
+            )
+            self._validate_disconnected(5)
+            self._validate_connected(6)
+            Helpers.validate_in_use_connections_state(
+                in_use_connections,
+                expected_state=MaintenanceState.MOVING,
+                expected_host_address=AFTER_MOVING_ADDRESS.split(":")[0],
+                expected_socket_timeout=self.config.relax_timeout,
+                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_orig_socket_timeout=None,
+                expected_orig_socket_connect_timeout=None,
+                expected_current_socket_timeout=self.config.relax_timeout,
+                expected_current_peername=DEFAULT_ADDRESS.split(":")[
+                    0
+                ],  # the in use connections reconnect when they complete their current task
+            )
+            Helpers.validate_free_connections_state(
+                pool=test_redis_client.connection_pool,
+                expected_state=MaintenanceState.MOVING,
+                expected_host_address=AFTER_MOVING_ADDRESS.split(":")[0],
+                expected_socket_timeout=self.config.relax_timeout,
+                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_orig_socket_timeout=None,
+                expected_orig_socket_connect_timeout=None,
+                should_be_connected_count=1,
+                connected_to_tmp_address=True,
+            )
+            # Wait for MOVING timeout to expire and the moving completed handler to run
+            sleep(MOVING_TIMEOUT + 0.5)
+
+            Helpers.validate_in_use_connections_state(
+                in_use_connections,
+                expected_state=MaintenanceState.NONE,
+                expected_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_socket_timeout=None,
+                expected_socket_connect_timeout=None,
+                expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_orig_socket_timeout=None,
+                expected_orig_socket_connect_timeout=None,
+                expected_current_socket_timeout=None,
+                expected_current_peername=DEFAULT_ADDRESS.split(":")[0],
+            )
+            Helpers.validate_conn_kwargs(
+                pool=test_redis_client.connection_pool,
+                expected_maintenance_state=MaintenanceState.NONE,
+                expected_maintenance_event_hash=None,
+                expected_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
+                expected_socket_timeout=None,
+                expected_socket_connect_timeout=None,
+                expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_orig_socket_timeout=None,
+                expected_orig_socket_connect_timeout=None,
+            )
+            Helpers.validate_free_connections_state(
+                pool=test_redis_client.connection_pool,
+                expected_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_socket_timeout=None,
+                expected_socket_connect_timeout=None,
+                expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_orig_socket_timeout=None,
+                expected_orig_socket_connect_timeout=None,
+                should_be_connected_count=1,
+                connected_to_tmp_address=True,
+                expected_state=MaintenanceState.NONE,
+            )
+        finally:
+            if hasattr(test_redis_client.connection_pool, "disconnect"):
+                test_redis_client.connection_pool.disconnect()
+
+    @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
+    def test_moving_none_events_handling_integration(self, pool_class):
+        """
+        Test full integration of moving-related events (MOVING) handling with Redis commands.
+
+        This test validates the complete MOVING event lifecycle,
+        when the push notification doesn't contain host and port:
+        1. Creates multiple connections in the pool
+        2. Executes a Redis command that triggers a MOVING with "null" push message
+        3. Validates that pool configuration is updated with temporary
+           address and timeout - for new connections creation
+        4. Validates that existing connections are marked for disconnection after ttl/2 seconds
+        5. Tests both ConnectionPool and BlockingConnectionPool implementations
+        """
+        # Create a pool and Redis client with maintenance events and pool handler
+        test_redis_client = self._get_client(
+            pool_class, max_connections=10, setup_pool_handler=True
+        )
+
+        try:
+            # Create several connections and return them in the pool
+            connections = []
+            for _ in range(10):
+                connection = test_redis_client.connection_pool.get_connection()
+                connections.append(connection)
+
+            for connection in connections:
+                test_redis_client.connection_pool.release(connection)
+
+            # Take 5 connections to be "in use"
+            in_use_connections = []
+            for _ in range(5):
+                connection = test_redis_client.connection_pool.get_connection()
+                in_use_connections.append(connection)
+
+            # Validate all connections are connected prior MOVING event
+            self._validate_disconnected(0)
+
+            # Run command that will receive and handle MOVING event
+            key_moving = "key_receive_moving_none_0"
+            value_moving = "value3_0"
+
+            # the connection used for the command is expected to be reconnected to the new address
+            # before it is returned to the pool
+            result2 = test_redis_client.set(key_moving, value_moving)
+
+            # Validate Command 2 result
+            assert result2 is True, "Command 2 (SET key_receive_moving) failed"
+
+            # Validate pool and connections settings were updated according to MOVING event
+            Helpers.validate_conn_kwargs(
+                pool=test_redis_client.connection_pool,
+                expected_maintenance_state=MaintenanceState.MOVING,
+                expected_maintenance_event_hash=hash(MOVING_NONE_EVENT),
+                expected_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
+                expected_socket_timeout=self.config.relax_timeout,
+                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_orig_socket_timeout=None,
+                expected_orig_socket_connect_timeout=None,
+            )
+            self._validate_disconnected(0)
+            self._validate_connected(10)
+            Helpers.validate_in_use_connections_state(
+                in_use_connections,
+                expected_should_reconnect=False,
+                expected_state=MaintenanceState.MOVING,
+                expected_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_socket_timeout=self.config.relax_timeout,
+                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_orig_socket_timeout=None,
+                expected_orig_socket_connect_timeout=None,
+                expected_current_socket_timeout=self.config.relax_timeout,
+                expected_current_peername=DEFAULT_ADDRESS.split(":")[
+                    0
+                ],  # the in use connections reconnect when they complete their current task
+            )
+            Helpers.validate_free_connections_state(
+                pool=test_redis_client.connection_pool,
+                expected_state=MaintenanceState.MOVING,
+                expected_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_socket_timeout=self.config.relax_timeout,
+                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_orig_socket_timeout=None,
+                expected_orig_socket_connect_timeout=None,
+                should_be_connected_count=5,
+                connected_to_tmp_address=False,
+            )
+            # Wait for half of MOVING timeout to expire and the proactive reconnect to run
+            sleep(MOVING_TIMEOUT / 2 + 0.2)
+            Helpers.validate_in_use_connections_state(
+                in_use_connections,
+                expected_should_reconnect=True,
+                expected_state=MaintenanceState.MOVING,
+                expected_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_socket_timeout=self.config.relax_timeout,
+                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_orig_socket_timeout=None,
+                expected_orig_socket_connect_timeout=None,
+                expected_current_socket_timeout=self.config.relax_timeout,
+                expected_current_peername=DEFAULT_ADDRESS.split(":")[
+                    0
+                ],  # the in use connections reconnect when they complete their current task
+            )
+            self._validate_disconnected(5)
+            self._validate_connected(5)
+
+            # Wait for MOVING timeout to expire and the moving completed handler to run
+            sleep(MOVING_TIMEOUT / 2 + 0.2)
+            Helpers.validate_in_use_connections_state(
+                in_use_connections,
+                expected_state=MaintenanceState.NONE,
+                expected_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_socket_timeout=None,
+                expected_socket_connect_timeout=None,
+                expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_orig_socket_timeout=None,
+                expected_orig_socket_connect_timeout=None,
+                expected_current_socket_timeout=None,
+                expected_current_peername=DEFAULT_ADDRESS.split(":")[0],
+            )
+            Helpers.validate_conn_kwargs(
+                pool=test_redis_client.connection_pool,
+                expected_maintenance_state=MaintenanceState.NONE,
+                expected_maintenance_event_hash=None,
+                expected_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
+                expected_socket_timeout=None,
+                expected_socket_connect_timeout=None,
+                expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_orig_socket_timeout=None,
+                expected_orig_socket_connect_timeout=None,
+            )
+            Helpers.validate_free_connections_state(
+                pool=test_redis_client.connection_pool,
+                expected_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_socket_timeout=None,
+                expected_socket_connect_timeout=None,
+                expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_orig_socket_timeout=None,
+                expected_orig_socket_connect_timeout=None,
+                should_be_connected_count=0,
+                connected_to_tmp_address=True,
+                expected_state=MaintenanceState.NONE,
+            )
+        finally:
+            if hasattr(test_redis_client.connection_pool, "disconnect"):
+                test_redis_client.connection_pool.disconnect()
+
+    @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
+    def test_create_new_conn_while_moving_not_expired(self, pool_class):
+        """
+        Test creating new connections while MOVING event is active (not expired).
+
+        This test validates that:
+        1. After MOVING event is processed, new connections are created with temporary address
+        2. New connections inherit the relaxed timeout settings
+        3. Pool configuration is properly applied to newly created connections
+        """
+        # Create a pool and Redis client with maintenance events and pool handler
+        test_redis_client = self._get_client(
+            pool_class, max_connections=10, setup_pool_handler=True
+        )
+
+        try:
+            # Create several connections and return them in the pool
+            connections = []
+            for _ in range(5):
+                connection = test_redis_client.connection_pool.get_connection()
+                connections.append(connection)
+
+            for connection in connections:
+                test_redis_client.connection_pool.release(connection)
+
+            # Take 3 connections to be "in use"
+            in_use_connections = []
+            for _ in range(3):
+                connection = test_redis_client.connection_pool.get_connection()
+                in_use_connections.append(connection)
+
+            # Validate all connections are connected prior MOVING event
+            self._validate_disconnected(0)
+
+            # Run command that will receive and handle MOVING event
+            key_moving = "key_receive_moving_0"
+            value_moving = "value3_0"
+            result = test_redis_client.set(key_moving, value_moving)
+
+            # Validate command result
+            assert result is True, "SET key_receive_moving command failed"
+
+            # Validate pool and connections settings were updated according to MOVING event
+            Helpers.validate_conn_kwargs(
+                pool=test_redis_client.connection_pool,
+                expected_maintenance_state=MaintenanceState.MOVING,
+                expected_maintenance_event_hash=hash(MOVING_EVENT),
+                expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
+                expected_orig_socket_timeout=None,
+                expected_orig_socket_connect_timeout=None,
+                expected_host_address=AFTER_MOVING_ADDRESS.split(":")[0],
+                expected_socket_timeout=self.config.relax_timeout,
+                expected_socket_connect_timeout=self.config.relax_timeout,
+            )
+
+            # Now get several more connections to force creation of new ones
+            # This should create new connections with the temporary address
+            old_connections = []
+            for _ in range(2):
+                connection = test_redis_client.connection_pool.get_connection()
+                old_connections.append(connection)
+
+            new_connection = test_redis_client.connection_pool.get_connection()
+
+            # Validate that new connections are created with temporary address and relax timeout
+            # and when connecting those configs are used
+            # get_connection() returns a connection that is already connected
+            assert new_connection.host == AFTER_MOVING_ADDRESS.split(":")[0]
+            assert new_connection.socket_timeout is self.config.relax_timeout
+            # New connections should be connected to the temporary address
+            assert new_connection._sock is not None
+            assert new_connection._sock.connected is True
+            assert (
+                new_connection._sock.getpeername()[0]
+                == AFTER_MOVING_ADDRESS.split(":")[0]
+            )
+            assert new_connection._sock.gettimeout() == self.config.relax_timeout
+
+        finally:
+            if hasattr(test_redis_client.connection_pool, "disconnect"):
+                test_redis_client.connection_pool.disconnect()
+
+    @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
+    def test_create_new_conn_after_moving_expires(self, pool_class):
+        """
+        Test creating new connections after MOVING event expires.
+
+        This test validates that:
+        1. After MOVING timeout expires, new connections use original address
+        2. Pool configuration is reset to original values
+        3. New connections don't inherit temporary settings
+        """
+        # Create a pool and Redis client with maintenance events and pool handler
+        test_redis_client = self._get_client(
+            pool_class, max_connections=10, setup_pool_handler=True
+        )
+
+        try:
+            # Create several connections and return them in the pool
+            connections = []
+            for _ in range(5):
+                connection = test_redis_client.connection_pool.get_connection()
+                connections.append(connection)
+
+            for connection in connections:
+                test_redis_client.connection_pool.release(connection)
+
+            # Take 3 connections to be "in use"
+            in_use_connections = []
+            for _ in range(3):
+                connection = test_redis_client.connection_pool.get_connection()
+                in_use_connections.append(connection)
+
+            # Run command that will receive and handle MOVING event
+            key_moving = "key_receive_moving_0"
+            value_moving = "value3_0"
+            result = test_redis_client.set(key_moving, value_moving)
+
+            # Validate command result
+            assert result is True, "SET key_receive_moving command failed"
+
+            # Wait for MOVING timeout to expire
+            sleep(MOVING_TIMEOUT + 0.5)
+
+            # Now get several new connections after expiration
+            old_connections = []
+            for _ in range(2):
+                connection = test_redis_client.connection_pool.get_connection()
+                old_connections.append(connection)
+
+            new_connection = test_redis_client.connection_pool.get_connection()
+
+            # Validate that new connections are created with original address (no temporary settings)
+            assert new_connection.orig_host_address == DEFAULT_ADDRESS.split(":")[0]
+            assert new_connection.orig_socket_timeout is None
+            # New connections should be connected to the original address
+            assert new_connection._sock is not None
+            assert new_connection._sock.connected is True
+            # Socket timeout should be None (original timeout)
+            assert new_connection._sock.gettimeout() is None
+
+        finally:
+            if hasattr(test_redis_client.connection_pool, "disconnect"):
+                test_redis_client.connection_pool.disconnect()
+
+    @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
+    def test_receive_migrated_after_moving(self, pool_class):
+        """
+        Test receiving MIGRATED event after MOVING event.
+
+        This test validates the complete MOVING -> MIGRATED lifecycle:
+        1. MOVING event is processed and temporary settings are applied
+        2. MIGRATED event is received during command execution
+        3. Temporary settings are cleared after MIGRATED
+        4. Pool configuration is restored to original values
+
+        Note: When MIGRATED comes after MOVING and MOVING hasn't yet expired,
+        it should not decrease timeouts (future refactoring consideration).
+        """
+        # Create a pool and Redis client with maintenance events and pool handler
+        test_redis_client = self._get_client(
+            pool_class, max_connections=10, setup_pool_handler=True
+        )
+
+        try:
+            # Create several connections and return them in the pool
+            connections = []
+            for _ in range(5):
+                connection = test_redis_client.connection_pool.get_connection()
+                connections.append(connection)
+
+            for connection in connections:
+                test_redis_client.connection_pool.release(connection)
+
+            # Take 3 connections to be "in use"
+            in_use_connections = []
+            for _ in range(3):
+                connection = test_redis_client.connection_pool.get_connection()
+                in_use_connections.append(connection)
+
+            # Validate all connections are connected prior MOVING event
+            self._validate_disconnected(0)
+
+            # Step 1: Run command that will receive and handle MOVING event
+            key_moving = "key_receive_moving_0"
+            value_moving = "value3_0"
+            result_moving = test_redis_client.set(key_moving, value_moving)
+
+            # Validate MOVING command result
+            assert result_moving is True, "SET key_receive_moving command failed"
+
+            # Validate pool and connections settings were updated according to MOVING event
+            Helpers.validate_conn_kwargs(
+                pool=test_redis_client.connection_pool,
+                expected_maintenance_state=MaintenanceState.MOVING,
+                expected_maintenance_event_hash=hash(MOVING_EVENT),
+                expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
+                expected_orig_socket_timeout=None,
+                expected_orig_socket_connect_timeout=None,
+                expected_host_address=AFTER_MOVING_ADDRESS.split(":")[0],
+                expected_socket_timeout=self.config.relax_timeout,
+                expected_socket_connect_timeout=self.config.relax_timeout,
+            )
+
+            # TODO validate current socket timeout
+
+            # Step 2: Run command that will receive and handle MIGRATED event
+            # This should clear the temporary settings
+            key_migrated = "key_receive_migrated_0"
+            value_migrated = "migrated_value"
+            result_migrated = test_redis_client.set(key_migrated, value_migrated)
+
+            # Validate MIGRATED command result
+            assert result_migrated is True, "SET key_receive_migrated command failed"
+
+            # Step 3: Validate that MIGRATED event was processed but MOVING settings remain
+            # (MIGRATED doesn't automatically clear MOVING settings - they are separate events)
+            # MOVING settings should still be active
+            # MOVING timeout should still be active
+            Helpers.validate_conn_kwargs(
+                pool=test_redis_client.connection_pool,
+                expected_maintenance_state=MaintenanceState.MOVING,
+                expected_maintenance_event_hash=hash(MOVING_EVENT),
+                expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
+                expected_orig_socket_timeout=None,
+                expected_orig_socket_connect_timeout=None,
+                expected_host_address=AFTER_MOVING_ADDRESS.split(":")[0],
+                expected_socket_timeout=self.config.relax_timeout,
+                expected_socket_connect_timeout=self.config.relax_timeout,
+            )
+
+            # Step 4: Create new connections after MIGRATED to verify they still use MOVING settings
+            # (since MOVING settings are still active)
+            new_connections = []
+            for _ in range(2):
+                connection = test_redis_client.connection_pool.get_connection()
+                new_connections.append(connection)
+
+            # Validate that new connections are created with MOVING settings (still active)
+            for connection in new_connections:
+                assert connection.host == AFTER_MOVING_ADDRESS.split(":")[0]
+                # Note: New connections may not inherit the exact relax timeout value
+                # but they should have the temporary host address
+                # New connections should be connected
+                if connection._sock is not None:
+                    assert connection._sock.connected is True
+
+            # Release the new connections
+            for connection in new_connections:
+                test_redis_client.connection_pool.release(connection)
+
+            # Validate free connections state with MOVING settings still active
+            # Note: We'll validate with the pool's current settings rather than individual connection settings
+            # since new connections may have different timeout values but still use the temporary address
+
+        finally:
+            if hasattr(test_redis_client.connection_pool, "disconnect"):
+                test_redis_client.connection_pool.disconnect()
+
+    @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
+    def test_overlapping_moving_events(self, pool_class):
+        """
+        Test handling of overlapping/duplicate MOVING events (e.g., two MOVING events before the first expires).
+        Ensures that the second MOVING event updates the pool and connections as expected, and that expiry/cleanup works.
+        """
+        global AFTER_MOVING_ADDRESS
+        test_redis_client = self._get_client(
+            pool_class, max_connections=5, setup_pool_handler=True
+        )
+        try:
+            # Create and release some connections
+            in_use_connections = []
+            for _ in range(3):
+                in_use_connections.append(
+                    test_redis_client.connection_pool.get_connection()
+                )
+
+            for conn in in_use_connections:
+                test_redis_client.connection_pool.release(conn)
+
+            # Take 2 connections to be in use
+            in_use_connections = []
+            for _ in range(2):
+                conn = test_redis_client.connection_pool.get_connection()
+                in_use_connections.append(conn)
+
+            # Trigger first MOVING event
+            key_moving1 = "key_receive_moving_0"
+            value_moving1 = "value3_0"
+            result1 = test_redis_client.set(key_moving1, value_moving1)
+            assert result1 is True
+            Helpers.validate_conn_kwargs(
+                pool=test_redis_client.connection_pool,
+                expected_maintenance_state=MaintenanceState.MOVING,
+                expected_maintenance_event_hash=hash(MOVING_EVENT),
+                expected_host_address=AFTER_MOVING_ADDRESS.split(":")[0],
+                expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
+                expected_socket_timeout=self.config.relax_timeout,
+                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_orig_socket_timeout=None,
+                expected_orig_socket_connect_timeout=None,
+            )
+            # Validate all connections reflect the first MOVING event
+            Helpers.validate_in_use_connections_state(
+                in_use_connections,
+                expected_state=MaintenanceState.MOVING,
+                expected_host_address=AFTER_MOVING_ADDRESS.split(":")[0],
+                expected_socket_timeout=self.config.relax_timeout,
+                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_orig_socket_timeout=None,
+                expected_orig_socket_connect_timeout=None,
+                expected_current_socket_timeout=self.config.relax_timeout,
+                expected_current_peername=DEFAULT_ADDRESS.split(":")[0],
+            )
+            Helpers.validate_free_connections_state(
+                pool=test_redis_client.connection_pool,
+                should_be_connected_count=1,
+                connected_to_tmp_address=True,
+                expected_state=MaintenanceState.MOVING,
+                expected_host_address=AFTER_MOVING_ADDRESS.split(":")[0],
+                expected_socket_timeout=self.config.relax_timeout,
+                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_orig_socket_timeout=None,
+                expected_orig_socket_connect_timeout=None,
+            )
+            # Reconnect in use connections
+            for conn in in_use_connections:
+                conn.disconnect()
+                conn.connect()
+
+            # Before the first MOVING expires, trigger a second MOVING event (simulate new address)
+            # Validate the orig properties are not changed!
+            second_moving_address = "5.6.7.8:6380"
+            orig_after_moving = AFTER_MOVING_ADDRESS
+            # Temporarily modify the global constant for this test
+            AFTER_MOVING_ADDRESS = second_moving_address
+            second_moving_event = NodeMovingEvent(
+                id=1,
+                new_node_host=second_moving_address.split(":")[0],
+                new_node_port=int(second_moving_address.split(":")[1]),
+                ttl=MOVING_TIMEOUT,
+            )
+            try:
+                key_moving2 = "key_receive_moving_1"
+                value_moving2 = "value3_1"
+                result2 = test_redis_client.set(key_moving2, value_moving2)
+                assert result2 is True
+                Helpers.validate_conn_kwargs(
+                    pool=test_redis_client.connection_pool,
+                    expected_maintenance_state=MaintenanceState.MOVING,
+                    expected_maintenance_event_hash=hash(second_moving_event),
+                    expected_host_address=second_moving_address.split(":")[0],
+                    expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
+                    expected_socket_timeout=self.config.relax_timeout,
+                    expected_socket_connect_timeout=self.config.relax_timeout,
+                    expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                    expected_orig_socket_timeout=None,
+                    expected_orig_socket_connect_timeout=None,
+                )
+                # Validate all connections reflect the second MOVING event
+                Helpers.validate_in_use_connections_state(
+                    in_use_connections,
+                    expected_state=MaintenanceState.MOVING,
+                    expected_host_address=second_moving_address.split(":")[0],
+                    expected_socket_timeout=self.config.relax_timeout,
+                    expected_socket_connect_timeout=self.config.relax_timeout,
+                    expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                    expected_orig_socket_timeout=None,
+                    expected_orig_socket_connect_timeout=None,
+                    expected_current_socket_timeout=self.config.relax_timeout,
+                    expected_current_peername=orig_after_moving.split(":")[0],
+                )
+                # print(test_redis_client.connection_pool._available_connections)
+                Helpers.validate_free_connections_state(
+                    test_redis_client.connection_pool,
+                    should_be_connected_count=1,
+                    connected_to_tmp_address=True,
+                    tmp_address=second_moving_address.split(":")[0],
+                    expected_state=MaintenanceState.MOVING,
+                    expected_host_address=second_moving_address.split(":")[0],
+                    expected_socket_timeout=self.config.relax_timeout,
+                    expected_socket_connect_timeout=self.config.relax_timeout,
+                    expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                    expected_orig_socket_timeout=None,
+                    expected_orig_socket_connect_timeout=None,
+                )
+            finally:
+                AFTER_MOVING_ADDRESS = orig_after_moving
+
+            # Wait for both MOVING timeouts to expire
+            sleep(MOVING_TIMEOUT + 0.5)
+            Helpers.validate_conn_kwargs(
+                pool=test_redis_client.connection_pool,
+                expected_maintenance_state=MaintenanceState.NONE,
+                expected_maintenance_event_hash=None,
+                expected_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
+                expected_socket_timeout=None,
+                expected_socket_connect_timeout=None,
+                expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+                expected_orig_socket_timeout=None,
+                expected_orig_socket_connect_timeout=None,
+            )
+        finally:
+            if hasattr(test_redis_client.connection_pool, "disconnect"):
+                test_redis_client.connection_pool.disconnect()
+
+    @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
+    def test_thread_safety_concurrent_event_handling(self, pool_class):
+        """
+        Test thread-safety under concurrent maintenance event handling.
+        Simulates multiple threads triggering MOVING events and performing operations concurrently.
+        """
+        import threading
+
+        test_redis_client = self._get_client(
+            pool_class, max_connections=5, setup_pool_handler=True
+        )
+        results = []
+        errors = []
+
+        def worker(idx):
+            try:
+                key = f"key_receive_moving_{idx}"
+                value = f"value3_{idx}"
+                result = test_redis_client.set(key, value)
+                results.append(result)
+            except Exception as e:
+                errors.append(e)
+
+        threads = [threading.Thread(target=worker, args=(i,)) for i in range(5)]
+        for t in threads:
+            t.start()
+        for t in threads:
+            t.join()
+        assert all(results), f"Not all threads succeeded: {results}"
+        assert not errors, f"Errors occurred in threads: {errors}"
+        # After all threads, MOVING event should have been handled safely
+        Helpers.validate_conn_kwargs(
+            pool=test_redis_client.connection_pool,
+            expected_maintenance_state=MaintenanceState.MOVING,
+            expected_maintenance_event_hash=hash(MOVING_EVENT),
+            expected_host_address=AFTER_MOVING_ADDRESS.split(":")[0],
+            expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
+            expected_socket_timeout=self.config.relax_timeout,
+            expected_socket_connect_timeout=self.config.relax_timeout,
+            expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+            expected_orig_socket_timeout=None,
+            expected_orig_socket_connect_timeout=None,
+        )
+
+        if hasattr(test_redis_client.connection_pool, "disconnect"):
+            test_redis_client.connection_pool.disconnect()
+
+    @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
+    def test_moving_migrating_migrated_moved_state_transitions(self, pool_class):
+        """
+        Test moving configs are not lost if the per connection events get picked up after moving is handled.
+        Sequence of events: MOVING, MIGRATING, MIGRATED, FAILING_OVER, FAILED_OVER, MOVED.
+        Note: FAILING_OVER and FAILED_OVER events do not change the connection state when already in MOVING state.
+        Checks the state after each event for all connections and for new connections created during each state.
+        """
+        # Setup
+        test_redis_client = self._get_client(
+            pool_class, max_connections=5, setup_pool_handler=True
+        )
+        pool = test_redis_client.connection_pool
+        pool_handler = pool.connection_kwargs["maintenance_events_pool_handler"]
+
+        # Create and release some connections
+        in_use_connections = []
+        for _ in range(3):
+            in_use_connections.append(pool.get_connection())
+
+        pool_handler.set_connection(in_use_connections[0])
+
+        while len(in_use_connections) > 0:
+            pool.release(in_use_connections.pop())
+
+        # Take 2 connections to be in use
+        in_use_connections = []
+        for _ in range(2):
+            conn = pool.get_connection()
+            in_use_connections.append(conn)
+
+        # 1. MOVING event
+        tmp_address = "22.23.24.25"
+        moving_event = NodeMovingEvent(
+            id=1, new_node_host=tmp_address, new_node_port=6379, ttl=1
+        )
+        pool_handler.handle_event(moving_event)
+
+        Helpers.validate_in_use_connections_state(
+            in_use_connections,
+            expected_state=MaintenanceState.MOVING,
+            expected_host_address=tmp_address,
+            expected_socket_timeout=self.config.relax_timeout,
+            expected_socket_connect_timeout=self.config.relax_timeout,
+            expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+            expected_orig_socket_timeout=None,
+            expected_orig_socket_connect_timeout=None,
+            expected_current_socket_timeout=self.config.relax_timeout,
+            expected_current_peername=DEFAULT_ADDRESS.split(":")[0],
+        )
+        Helpers.validate_free_connections_state(
+            pool=pool,
+            should_be_connected_count=0,
+            connected_to_tmp_address=False,
+            expected_state=MaintenanceState.MOVING,
+            expected_host_address=tmp_address,
+            expected_socket_timeout=self.config.relax_timeout,
+            expected_socket_connect_timeout=self.config.relax_timeout,
+            expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+            expected_orig_socket_timeout=None,
+            expected_orig_socket_connect_timeout=None,
+        )
+
+        # 2. MIGRATING event (simulate direct connection handler call)
+        for conn in in_use_connections:
+            conn._maintenance_event_connection_handler.handle_event(
+                NodeMigratingEvent(id=2, ttl=1)
+            )
+        Helpers.validate_in_use_connections_state(
+            in_use_connections,
+            expected_state=MaintenanceState.MOVING,
+            expected_host_address=tmp_address,
+            expected_socket_timeout=self.config.relax_timeout,
+            expected_socket_connect_timeout=self.config.relax_timeout,
+            expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+            expected_orig_socket_timeout=None,
+            expected_orig_socket_connect_timeout=None,
+            expected_current_socket_timeout=self.config.relax_timeout,
+            expected_current_peername=DEFAULT_ADDRESS.split(":")[0],
+        )
+
+        # 3. MIGRATED event (simulate direct connection handler call)
+        for conn in in_use_connections:
+            conn._maintenance_event_connection_handler.handle_event(
+                NodeMigratedEvent(id=2)
+            )
+        # State should not change for connections that are in MOVING state
+        Helpers.validate_in_use_connections_state(
+            in_use_connections,
+            expected_state=MaintenanceState.MOVING,
+            expected_host_address=tmp_address,
+            expected_socket_timeout=self.config.relax_timeout,
+            expected_socket_connect_timeout=self.config.relax_timeout,
+            expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+            expected_orig_socket_timeout=None,
+            expected_orig_socket_connect_timeout=None,
+            expected_current_socket_timeout=self.config.relax_timeout,
+            expected_current_peername=DEFAULT_ADDRESS.split(":")[0],
+        )
+
+        # 4. FAILING_OVER event (simulate direct connection handler call)
+        for conn in in_use_connections:
+            conn._maintenance_event_connection_handler.handle_event(
+                NodeFailingOverEvent(id=3, ttl=1)
+            )
+        # State should not change for connections that are in MOVING state
+        Helpers.validate_in_use_connections_state(
+            in_use_connections,
+            expected_state=MaintenanceState.MOVING,
+            expected_host_address=tmp_address,
+            expected_socket_timeout=self.config.relax_timeout,
+            expected_socket_connect_timeout=self.config.relax_timeout,
+            expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+            expected_orig_socket_timeout=None,
+            expected_orig_socket_connect_timeout=None,
+            expected_current_socket_timeout=self.config.relax_timeout,
+            expected_current_peername=DEFAULT_ADDRESS.split(":")[0],
+        )
+
+        # 5. FAILED_OVER event (simulate direct connection handler call)
+        for conn in in_use_connections:
+            conn._maintenance_event_connection_handler.handle_event(
+                NodeFailedOverEvent(id=3)
+            )
+        # State should not change for connections that are in MOVING state
+        Helpers.validate_in_use_connections_state(
+            in_use_connections,
+            expected_state=MaintenanceState.MOVING,
+            expected_host_address=tmp_address,
+            expected_socket_timeout=self.config.relax_timeout,
+            expected_socket_connect_timeout=self.config.relax_timeout,
+            expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+            expected_orig_socket_timeout=None,
+            expected_orig_socket_connect_timeout=None,
+            expected_current_socket_timeout=self.config.relax_timeout,
+            expected_current_peername=DEFAULT_ADDRESS.split(":")[0],
+        )
+
+        # 6. MOVED event (simulate timer expiry)
+        pool_handler.handle_node_moved_event(moving_event)
+        Helpers.validate_in_use_connections_state(
+            in_use_connections,
+            expected_state=MaintenanceState.NONE,
+            expected_host_address=DEFAULT_ADDRESS.split(":")[0],
+            expected_socket_timeout=None,
+            expected_socket_connect_timeout=None,
+            expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+            expected_orig_socket_timeout=None,
+            expected_orig_socket_connect_timeout=None,
+            expected_current_socket_timeout=None,
+            expected_current_peername=DEFAULT_ADDRESS.split(":")[0],
+        )
+        Helpers.validate_free_connections_state(
+            pool=pool,
+            should_be_connected_count=0,
+            connected_to_tmp_address=False,
+            expected_state=MaintenanceState.NONE,
+            expected_host_address=DEFAULT_ADDRESS.split(":")[0],
+            expected_socket_timeout=None,
+            expected_socket_connect_timeout=None,
+            expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
+            expected_orig_socket_timeout=None,
+            expected_orig_socket_connect_timeout=None,
+        )
+        # New connection after MOVED
+        new_conn_none = pool.get_connection()
+        assert new_conn_none.maintenance_state == MaintenanceState.NONE
+        pool.release(new_conn_none)
+        # Cleanup
+        for conn in in_use_connections:
+            pool.release(conn)
+        if hasattr(pool, "disconnect"):
+            pool.disconnect()
+
+
+class TestMaintenanceEventsHandlingMultipleProxies:
+    """Integration tests for maintenance events handling with real connection pool."""
+
+    def setup_method(self):
+        """Set up test fixtures with mocked sockets."""
+        self.mock_sockets = []
+        self.original_socket = socket.socket
+        self.orig_host = "test.address.com"
+
+        # Mock socket creation to return our mock sockets
+        def mock_socket_factory(*args, **kwargs):
+            mock_sock = MockSocket()
+            self.mock_sockets.append(mock_sock)
+            return mock_sock
+
+        self.socket_patcher = patch("socket.socket", side_effect=mock_socket_factory)
+        self.socket_patcher.start()
+
+        # Mock select.select to simulate data availability for reading
+        def mock_select(rlist, wlist, xlist, timeout=0):
+            # Check if any of the sockets in rlist have data available
+            ready_sockets = []
+            for sock in rlist:
+                if hasattr(sock, "connected") and sock.connected and not sock.closed:
+                    # Only return socket as ready if it actually has data to read
+                    if hasattr(sock, "pending_responses") and sock.pending_responses:
+                        ready_sockets.append(sock)
+                    # Don't return socket as ready just because it received commands
+                    # Only when there are actual responses available
+            return (ready_sockets, [], [])
+
+        self.select_patcher = patch("select.select", side_effect=mock_select)
+        self.select_patcher.start()
+
+        ips = ["1.2.3.4", "5.6.7.8", "9.10.11.12"]
+        ips = ips * 3
+
+        # Mock socket creation to return our mock sockets
+        def mock_socket_getaddrinfo(host, port, family=0, type=0, proto=0, flags=0):
+            if host == self.orig_host:
+                ip_address = ips.pop(0)
+            else:
+                ip_address = host
+
+            # Return the standard getaddrinfo format
+            # (family, type, proto, canonname, sockaddr)
+            return [
+                (
+                    socket.AF_INET,
+                    socket.SOCK_STREAM,
+                    socket.IPPROTO_TCP,
+                    "",
+                    (ip_address, port),
+                )
+            ]
+
+        self.getaddrinfo_patcher = patch(
+            "socket.getaddrinfo", side_effect=mock_socket_getaddrinfo
+        )
+        self.getaddrinfo_patcher.start()
+
+        # Create maintenance events config
+        self.config = MaintenanceEventsConfig(
+            enabled=True, proactive_reconnect=True, relax_timeout=30
+        )
+
+    def teardown_method(self):
+        """Clean up test fixtures."""
+        self.socket_patcher.stop()
+        self.select_patcher.stop()
+        self.getaddrinfo_patcher.stop()
+
+    @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
+    def test_migrating_after_moving_multiple_proxies(self, pool_class):
+        """ """
+        # Setup
+
+        pool = pool_class(
+            host=self.orig_host,
+            port=12345,
+            max_connections=10,
+            protocol=3,  # Required for maintenance events
+            maintenance_events_config=self.config,
+        )
+        pool.set_maintenance_events_pool_handler(
+            MaintenanceEventPoolHandler(pool, self.config)
+        )
+        pool_handler = pool.connection_kwargs["maintenance_events_pool_handler"]
+
+        # Create and release some connections
+        key1 = "1.2.3.4"
+        key2 = "5.6.7.8"
+        key3 = "9.10.11.12"
+        in_use_connections = {key1: [], key2: [], key3: []}
+        # Create 7 connections
+        for _ in range(7):
+            conn = pool.get_connection()
+            in_use_connections[conn.getpeername()].append(conn)
+
+        for _, conns in in_use_connections.items():
+            while len(conns) > 1:
+                pool.release(conns.pop())
+
+        # Send MOVING event to con with ip = key1
+        conn = in_use_connections[key1][0]
+        pool_handler.set_connection(conn)
+        new_ip = "13.14.15.16"
+        pool_handler.handle_event(
+            NodeMovingEvent(id=1, new_node_host=new_ip, new_node_port=6379, ttl=1)
+        )
+
+        # validate in use connection and ip1
+        Helpers.validate_in_use_connections_state(
+            in_use_connections[key1],
+            expected_state=MaintenanceState.MOVING,
+            expected_host_address=new_ip,
+            expected_socket_timeout=self.config.relax_timeout,
+            expected_socket_connect_timeout=self.config.relax_timeout,
+            expected_orig_host_address=self.orig_host,
+            expected_orig_socket_timeout=None,
+            expected_orig_socket_connect_timeout=None,
+            expected_current_socket_timeout=self.config.relax_timeout,
+            expected_current_peername=key1,
+        )
+        # validate free connections for ip1
+        changed_free_connections = 0
+        if isinstance(pool, BlockingConnectionPool):
+            free_connections = [conn for conn in pool.pool.queue if conn is not None]
+        elif isinstance(pool, ConnectionPool):
+            free_connections = pool._available_connections
+        for conn in free_connections:
+            if conn.host == new_ip:
+                changed_free_connections += 1
+                assert conn.maintenance_state == MaintenanceState.MOVING
+                assert conn.host == new_ip
+                assert conn.socket_timeout == self.config.relax_timeout
+                assert conn.socket_connect_timeout == self.config.relax_timeout
+                assert conn.orig_host_address == self.orig_host
+                assert conn.orig_socket_timeout is None
+                assert conn.orig_socket_connect_timeout is None
+            else:
+                assert conn.maintenance_state == MaintenanceState.NONE
+                assert conn.host == self.orig_host
+                assert conn.socket_timeout is None
+                assert conn.socket_connect_timeout is None
+                assert conn.orig_host_address == self.orig_host
+                assert conn.orig_socket_timeout is None
+                assert conn.orig_socket_connect_timeout is None
+        assert changed_free_connections == 2
+        assert len(free_connections) == 4
+
+        # Send second MOVING event to con with ip = key2
+        conn = in_use_connections[key2][0]
+        pool_handler.set_connection(conn)
+        new_ip_2 = "17.18.19.20"
+        pool_handler.handle_event(
+            NodeMovingEvent(id=2, new_node_host=new_ip_2, new_node_port=6379, ttl=2)
+        )
+
+        # validate in use connection and ip2
+        Helpers.validate_in_use_connections_state(
+            in_use_connections[key2],
+            expected_state=MaintenanceState.MOVING,
+            expected_host_address=new_ip_2,
+            expected_socket_timeout=self.config.relax_timeout,
+            expected_socket_connect_timeout=self.config.relax_timeout,
+            expected_orig_host_address=self.orig_host,
+            expected_orig_socket_timeout=None,
+            expected_orig_socket_connect_timeout=None,
+            expected_current_socket_timeout=self.config.relax_timeout,
+            expected_current_peername=key2,
+        )
+        # validate free connections for ip2
+        changed_free_connections = 0
+        if isinstance(pool, BlockingConnectionPool):
+            free_connections = [conn for conn in pool.pool.queue if conn is not None]
+        elif isinstance(pool, ConnectionPool):
+            free_connections = pool._available_connections
+        for conn in free_connections:
+            if conn.host == new_ip_2:
+                changed_free_connections += 1
+                assert conn.maintenance_state == MaintenanceState.MOVING
+                assert conn.host == new_ip_2
+                assert conn.socket_timeout == self.config.relax_timeout
+                assert conn.socket_connect_timeout == self.config.relax_timeout
+                assert conn.orig_host_address == self.orig_host
+                assert conn.orig_socket_timeout is None
+                assert conn.orig_socket_connect_timeout is None
+            # here I can't validate the other connections since some of
+            # them are in MOVING state from the first event
+            # and some are in NONE state
+        assert changed_free_connections == 1
+
+        # MIGRATING event on connection that has already been marked as MOVING
+        conn = in_use_connections[key2][0]
+        conn_event_handler = conn._maintenance_event_connection_handler
+        conn_event_handler.handle_event(NodeMigratingEvent(id=3, ttl=1))
+        # validate connection does not lose its MOVING state
+        assert conn.maintenance_state == MaintenanceState.MOVING
+        # MIGRATED event
+        conn_event_handler.handle_event(NodeMigratedEvent(id=3))
+        # validate connection does not lose its MOVING state and relax timeout
+        assert conn.maintenance_state == MaintenanceState.MOVING
+        assert conn.socket_timeout == self.config.relax_timeout
+
+        # Send Migrating event to con with ip = key3
+        conn = in_use_connections[key3][0]
+        conn_event_handler = conn._maintenance_event_connection_handler
+        conn_event_handler.handle_event(NodeMigratingEvent(id=3, ttl=1))
+        # validate connection is in MIGRATING state
+        assert conn.maintenance_state == MaintenanceState.MAINTENANCE
+
+        assert conn.socket_timeout == self.config.relax_timeout
+
+        # Send MIGRATED event to con with ip = key3
+        conn_event_handler.handle_event(NodeMigratedEvent(id=3))
+        # validate connection is in MOVING state
+        assert conn.maintenance_state == MaintenanceState.NONE
+        assert conn.socket_timeout is None
+
+        # sleep to expire only the first MOVING events
+        sleep(1.3)
+        # validate only the connections affected by the first MOVING event
+        # have lost their MOVING state
+        Helpers.validate_in_use_connections_state(
+            in_use_connections[key1],
+            expected_state=MaintenanceState.NONE,
+            expected_host_address=self.orig_host,
+            expected_socket_timeout=None,
+            expected_socket_connect_timeout=None,
+            expected_orig_host_address=self.orig_host,
+            expected_orig_socket_timeout=None,
+            expected_orig_socket_connect_timeout=None,
+            expected_current_socket_timeout=None,
+            expected_current_peername=key1,
+        )
+        Helpers.validate_in_use_connections_state(
+            in_use_connections[key2],
+            expected_state=MaintenanceState.MOVING,
+            expected_host_address=new_ip_2,
+            expected_socket_timeout=self.config.relax_timeout,
+            expected_socket_connect_timeout=self.config.relax_timeout,
+            expected_orig_host_address=self.orig_host,
+            expected_orig_socket_timeout=None,
+            expected_orig_socket_connect_timeout=None,
+            expected_current_socket_timeout=self.config.relax_timeout,
+            expected_current_peername=key2,
+        )
+        Helpers.validate_in_use_connections_state(
+            in_use_connections[key3],
+            expected_state=MaintenanceState.NONE,
+            expected_should_reconnect=False,
+            expected_host_address=self.orig_host,
+            expected_socket_timeout=None,
+            expected_socket_connect_timeout=None,
+            expected_orig_host_address=self.orig_host,
+            expected_orig_socket_timeout=None,
+            expected_orig_socket_connect_timeout=None,
+            expected_current_socket_timeout=None,
+            expected_current_peername=key3,
+        )
+        # TODO validate free connections
+
+        # sleep to expire the second MOVING events
+        sleep(1)
+        # validate all connections have lost their MOVING state
+        Helpers.validate_in_use_connections_state(
+            [
+                *in_use_connections[key1],
+                *in_use_connections[key2],
+                *in_use_connections[key3],
+            ],
+            expected_state=MaintenanceState.NONE,
+            expected_should_reconnect="any",
+            expected_host_address=self.orig_host,
+            expected_socket_timeout=None,
+            expected_socket_connect_timeout=None,
+            expected_orig_host_address=self.orig_host,
+            expected_orig_socket_timeout=None,
+            expected_orig_socket_connect_timeout=None,
+            expected_current_socket_timeout=None,
+            expected_current_peername="any",
+        )
+        # TODO validate free connections

From 03f4125afbd514a1e766124b92ec6d15f0347615 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Mon, 8 Sep 2025 10:55:14 +0300
Subject: [PATCH 1114/1164] Adding e2e scenario tests for maintenance push
 notifications handling. (#3758)

---
 .github/workflows/install_and_test.sh         |   6 +-
 redis/_parsers/base.py                        |   2 +-
 redis/connection.py                           |  44 +-
 redis/maintenance_events.py                   |   2 +-
 tasks.py                                      |   8 +-
 tests/test_maintenance_events.py              |   2 +-
 tests/test_maintenance_events_handling.py     |   4 +-
 tests/test_scenario/conftest.py               | 120 +++
 tests/test_scenario/fault_injector_client.py  |  44 +
 .../test_scenario/hitless_upgrade_helpers.py  | 287 +++++++
 tests/test_scenario/test_hitless_upgrade.py   | 795 ++++++++++++++++++
 11 files changed, 1284 insertions(+), 30 deletions(-)
 create mode 100644 tests/test_scenario/conftest.py
 create mode 100644 tests/test_scenario/hitless_upgrade_helpers.py
 create mode 100644 tests/test_scenario/test_hitless_upgrade.py

diff --git a/.github/workflows/install_and_test.sh b/.github/workflows/install_and_test.sh
index e647126539..c90027389c 100755
--- a/.github/workflows/install_and_test.sh
+++ b/.github/workflows/install_and_test.sh
@@ -40,9 +40,11 @@ cd ${TESTDIR}
 # install, run tests
 pip install ${PKG}
 # Redis tests
-pytest -m 'not onlycluster'
+pytest -m 'not onlycluster' --ignore=tests/test_scenario
 # RedisCluster tests
 CLUSTER_URL="redis://localhost:16379/0"
 CLUSTER_SSL_URL="rediss://localhost:27379/0"
 pytest -m 'not onlynoncluster and not redismod and not ssl' \
-  --redis-url="${CLUSTER_URL}" --redis-ssl-url="${CLUSTER_SSL_URL}"
+  --ignore=tests/test_scenario \
+  --redis-url="${CLUSTER_URL}" \
+  --redis-ssl-url="${CLUSTER_SSL_URL}"
diff --git a/redis/_parsers/base.py b/redis/_parsers/base.py
index 9fe77bcd3b..be7b5cf1d0 100644
--- a/redis/_parsers/base.py
+++ b/redis/_parsers/base.py
@@ -191,7 +191,7 @@ def parse_moving_msg(response):
         # Expected message format is: MOVING <seq_number> <time> <endpoint>
         id = response[1]
         ttl = response[2]
-        if response[3] in [b"null", "null"]:
+        if response[3] is None:
             host, port = None, None
         else:
             value = response[3]
diff --git a/redis/connection.py b/redis/connection.py
index 0e7de5a584..2c1a985638 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1720,7 +1720,7 @@ def __init__(
         self._cache_factory = cache_factory
 
         if connection_kwargs.get("cache_config") or connection_kwargs.get("cache"):
-            if connection_kwargs.get("protocol") not in [3, "3"]:
+            if self.connection_kwargs.get("protocol") not in [3, "3"]:
                 raise RedisError("Client caching is only supported with RESP version 3")
 
             cache = self.connection_kwargs.get("cache")
@@ -1741,31 +1741,21 @@ def __init__(
         connection_kwargs.pop("cache", None)
         connection_kwargs.pop("cache_config", None)
 
-        if connection_kwargs.get(
+        if self.connection_kwargs.get(
             "maintenance_events_pool_handler"
-        ) or connection_kwargs.get("maintenance_events_config"):
-            if connection_kwargs.get("protocol") not in [3, "3"]:
+        ) or self.connection_kwargs.get("maintenance_events_config"):
+            if self.connection_kwargs.get("protocol") not in [3, "3"]:
                 raise RedisError(
                     "Push handlers on connection are only supported with RESP version 3"
                 )
-            config = connection_kwargs.get("maintenance_events_config", None) or (
-                connection_kwargs.get("maintenance_events_pool_handler").config
-                if connection_kwargs.get("maintenance_events_pool_handler")
+            config = self.connection_kwargs.get("maintenance_events_config", None) or (
+                self.connection_kwargs.get("maintenance_events_pool_handler").config
+                if self.connection_kwargs.get("maintenance_events_pool_handler")
                 else None
             )
 
             if config and config.enabled:
-                connection_kwargs.update(
-                    {
-                        "orig_host_address": connection_kwargs.get("host"),
-                        "orig_socket_timeout": connection_kwargs.get(
-                            "socket_timeout", None
-                        ),
-                        "orig_socket_connect_timeout": connection_kwargs.get(
-                            "socket_connect_timeout", None
-                        ),
-                    }
-                )
+                self._update_connection_kwargs_for_maintenance_events()
 
         self._event_dispatcher = self.connection_kwargs.get("event_dispatcher", None)
         if self._event_dispatcher is None:
@@ -1821,6 +1811,7 @@ def set_maintenance_events_pool_handler(
                 "maintenance_events_config": maintenance_events_pool_handler.config,
             }
         )
+        self._update_connection_kwargs_for_maintenance_events()
 
         self._update_maintenance_events_configs_for_connections(
             maintenance_events_pool_handler
@@ -1838,6 +1829,23 @@ def _update_maintenance_events_configs_for_connections(
                 conn.set_maintenance_event_pool_handler(maintenance_events_pool_handler)
                 conn.maintenance_events_config = maintenance_events_pool_handler.config
 
+    def _update_connection_kwargs_for_maintenance_events(self):
+        """Store original connection parameters for maintenance events."""
+        if self.connection_kwargs.get("orig_host_address", None) is None:
+            # If orig_host_address is None it means we haven't
+            # configured the original values yet
+            self.connection_kwargs.update(
+                {
+                    "orig_host_address": self.connection_kwargs.get("host"),
+                    "orig_socket_timeout": self.connection_kwargs.get(
+                        "socket_timeout", None
+                    ),
+                    "orig_socket_connect_timeout": self.connection_kwargs.get(
+                        "socket_connect_timeout", None
+                    ),
+                }
+            )
+
     def reset(self) -> None:
         self._created_connections = 0
         self._available_connections = []
diff --git a/redis/maintenance_events.py b/redis/maintenance_events.py
index cd22d29ed5..a3636019ed 100644
--- a/redis/maintenance_events.py
+++ b/redis/maintenance_events.py
@@ -449,7 +449,7 @@ def __init__(
         self,
         enabled: bool = True,
         proactive_reconnect: bool = True,
-        relax_timeout: Optional[Number] = 20,
+        relax_timeout: Optional[Number] = 10,
         endpoint_type: Optional[EndpointType] = None,
     ):
         """
diff --git a/tasks.py b/tasks.py
index 52decf08e7..20f9f245aa 100644
--- a/tasks.py
+++ b/tasks.py
@@ -58,11 +58,11 @@ def standalone_tests(
 
     if uvloop:
         run(
-            f"pytest {profile_arg} --protocol={protocol} {redis_mod_url} --cov=./ --cov-report=xml:coverage_resp{protocol}_uvloop.xml -m 'not onlycluster{extra_markers}' --uvloop --junit-xml=standalone-resp{protocol}-uvloop-results.xml"
+            f"pytest {profile_arg} --protocol={protocol} {redis_mod_url}  --ignore=tests/test_scenario --cov=./ --cov-report=xml:coverage_resp{protocol}_uvloop.xml -m 'not onlycluster{extra_markers}' --uvloop --junit-xml=standalone-resp{protocol}-uvloop-results.xml"
         )
     else:
         run(
-            f"pytest {profile_arg} --protocol={protocol} {redis_mod_url} --cov=./ --cov-report=xml:coverage_resp{protocol}.xml -m 'not onlycluster{extra_markers}' --junit-xml=standalone-resp{protocol}-results.xml"
+            f"pytest {profile_arg} --protocol={protocol} {redis_mod_url}  --ignore=tests/test_scenario --cov=./ --cov-report=xml:coverage_resp{protocol}.xml -m 'not onlycluster{extra_markers}' --junit-xml=standalone-resp{protocol}-results.xml"
         )
 
 
@@ -74,11 +74,11 @@ def cluster_tests(c, uvloop=False, protocol=2, profile=False):
     cluster_tls_url = "rediss://localhost:27379/0"
     if uvloop:
         run(
-            f"pytest {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_cluster_resp{protocol}_uvloop.xml -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --redis-ssl-url={cluster_tls_url} --junit-xml=cluster-resp{protocol}-uvloop-results.xml --uvloop"
+            f"pytest {profile_arg} --protocol={protocol}  --ignore=tests/test_scenario  --cov=./ --cov-report=xml:coverage_cluster_resp{protocol}_uvloop.xml -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --redis-ssl-url={cluster_tls_url} --junit-xml=cluster-resp{protocol}-uvloop-results.xml --uvloop"
         )
     else:
         run(
-            f"pytest  {profile_arg} --protocol={protocol} --cov=./ --cov-report=xml:coverage_cluster_resp{protocol}.xml -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --redis-ssl-url={cluster_tls_url} --junit-xml=cluster-resp{protocol}-results.xml"
+            f"pytest  {profile_arg} --protocol={protocol}  --ignore=tests/test_scenario  --cov=./ --cov-report=xml:coverage_cluster_resp{protocol}.xml -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --redis-ssl-url={cluster_tls_url} --junit-xml=cluster-resp{protocol}-results.xml"
         )
 
 
diff --git a/tests/test_maintenance_events.py b/tests/test_maintenance_events.py
index 916c93b9ad..69bdad2947 100644
--- a/tests/test_maintenance_events.py
+++ b/tests/test_maintenance_events.py
@@ -381,7 +381,7 @@ def test_init_defaults(self):
         config = MaintenanceEventsConfig()
         assert config.enabled is True
         assert config.proactive_reconnect is True
-        assert config.relax_timeout == 20
+        assert config.relax_timeout == 10
 
     def test_init_custom_values(self):
         """Test MaintenanceEventsConfig initialization with custom values."""
diff --git a/tests/test_maintenance_events_handling.py b/tests/test_maintenance_events_handling.py
index 8cbaba5edc..06c607b552 100644
--- a/tests/test_maintenance_events_handling.py
+++ b/tests/test_maintenance_events_handling.py
@@ -236,9 +236,7 @@ def send(self, data):
                 # MOVING push message before SET key_receive_moving_none_X response
                 # Format: >4\r\n$6\r\nMOVING\r\n:1\r\n:1\r\n+null\r\n (4 elements: MOVING, id, ttl, null)
                 # Note: Using + instead of $ to send as simple string instead of bulk string
-                moving_push = (
-                    f">4\r\n$6\r\nMOVING\r\n:1\r\n:{MOVING_TIMEOUT}\r\n+null\r\n"
-                )
+                moving_push = f">4\r\n$6\r\nMOVING\r\n:1\r\n:{MOVING_TIMEOUT}\r\n_\r\n"
                 response = moving_push.encode() + response
             elif b"key_receive_moving_" in data:
                 # MOVING push message before SET key_receive_moving_X response
diff --git a/tests/test_scenario/conftest.py b/tests/test_scenario/conftest.py
new file mode 100644
index 0000000000..2ea572c93e
--- /dev/null
+++ b/tests/test_scenario/conftest.py
@@ -0,0 +1,120 @@
+import json
+import logging
+import os
+from typing import Optional
+from urllib.parse import urlparse
+import pytest
+
+from redis.backoff import ExponentialWithJitterBackoff, NoBackoff
+from redis.client import Redis
+from redis.maintenance_events import EndpointType, MaintenanceEventsConfig
+from redis.retry import Retry
+from tests.test_scenario.fault_injector_client import FaultInjectorClient
+
+RELAX_TIMEOUT = 30
+CLIENT_TIMEOUT = 5
+
+DEFAULT_ENDPOINT_NAME = "m-standard"
+
+
+@pytest.fixture()
+def endpoint_name(request):
+    return request.config.getoption("--endpoint-name") or os.getenv(
+        "REDIS_ENDPOINT_NAME", DEFAULT_ENDPOINT_NAME
+    )
+
+
+@pytest.fixture()
+def endpoints_config(endpoint_name: str):
+    endpoints_config = os.getenv("REDIS_ENDPOINTS_CONFIG_PATH", None)
+
+    if not (endpoints_config and os.path.exists(endpoints_config)):
+        raise FileNotFoundError(f"Endpoints config file not found: {endpoints_config}")
+
+    try:
+        with open(endpoints_config, "r") as f:
+            data = json.load(f)
+            db = data[endpoint_name]
+            return db
+    except Exception as e:
+        raise ValueError(
+            f"Failed to load endpoints config file: {endpoints_config}"
+        ) from e
+
+
+@pytest.fixture()
+def fault_injector_client():
+    url = os.getenv("FAULT_INJECTION_API_URL", "http://127.0.0.1:20324")
+    return FaultInjectorClient(url)
+
+
+@pytest.fixture()
+def client_maint_events(endpoints_config):
+    return _get_client_maint_events(endpoints_config)
+
+
+def _get_client_maint_events(
+    endpoints_config,
+    enable_maintenance_events: bool = True,
+    endpoint_type: Optional[EndpointType] = None,
+    enable_relax_timeout: bool = True,
+    enable_proactive_reconnect: bool = True,
+    disable_retries: bool = False,
+    socket_timeout: Optional[float] = None,
+):
+    """Create Redis client with maintenance events enabled."""
+
+    # Get credentials from the configuration
+    username = endpoints_config.get("username")
+    password = endpoints_config.get("password")
+
+    # Parse host and port from endpoints URL
+    endpoints = endpoints_config.get("endpoints", [])
+    if not endpoints:
+        raise ValueError("No endpoints found in configuration")
+
+    parsed = urlparse(endpoints[0])
+    host = parsed.hostname
+    port = parsed.port
+
+    tls_enabled = True if parsed.scheme == "rediss" else False
+
+    if not host:
+        raise ValueError(f"Could not parse host from endpoint URL: {endpoints[0]}")
+
+    logging.info(f"Connecting to Redis Enterprise: {host}:{port} with user: {username}")
+
+    # Configure maintenance events
+    maintenance_config = MaintenanceEventsConfig(
+        enabled=enable_maintenance_events,
+        proactive_reconnect=enable_proactive_reconnect,
+        relax_timeout=RELAX_TIMEOUT if enable_relax_timeout else -1,
+        endpoint_type=endpoint_type,
+    )
+
+    # Create Redis client with maintenance events config
+    # This will automatically create the MaintenanceEventPoolHandler
+    if disable_retries:
+        retry = Retry(NoBackoff(), 0)
+    else:
+        retry = Retry(backoff=ExponentialWithJitterBackoff(base=1, cap=10), retries=3)
+
+    client = Redis(
+        host=host,
+        port=port,
+        socket_timeout=CLIENT_TIMEOUT if socket_timeout is None else socket_timeout,
+        username=username,
+        password=password,
+        ssl=tls_enabled,
+        ssl_cert_reqs="none",
+        ssl_check_hostname=False,
+        protocol=3,  # RESP3 required for push notifications
+        maintenance_events_config=maintenance_config,
+        retry=retry,
+    )
+    logging.info("Redis client created with maintenance events enabled")
+    logging.info(f"Client uses Protocol: {client.connection_pool.get_protocol()}")
+    maintenance_handler_exists = client.maintenance_events_pool_handler is not None
+    logging.info(f"Maintenance events pool handler: {maintenance_handler_exists}")
+
+    return client
diff --git a/tests/test_scenario/fault_injector_client.py b/tests/test_scenario/fault_injector_client.py
index 9cb35b24b6..fffda9ac01 100644
--- a/tests/test_scenario/fault_injector_client.py
+++ b/tests/test_scenario/fault_injector_client.py
@@ -1,8 +1,23 @@
 import json
+import logging
+import time
 import urllib.request
 from typing import Dict, Any, Optional, Union
 from enum import Enum
 
+import pytest
+
+
+class TaskStatuses:
+    """Class to hold completed statuses constants."""
+
+    FAILED = "failed"
+    FINISHED = "finished"
+    SUCCESS = "success"
+    RUNNING = "running"
+
+    COMPLETED_STATUSES = [FAILED, FINISHED, SUCCESS]
+
 
 class ActionType(str, Enum):
     DMC_RESTART = "dmc_restart"
@@ -103,3 +118,32 @@ def execute_rladmin_command(
                 error_body = json.loads(e.read().decode("utf-8"))
                 raise ValueError(f"Validation Error: {error_body}")
             raise
+
+    def get_operation_result(
+        self,
+        action_id: str,
+        timeout: int = 60,
+    ) -> Dict[str, Any]:
+        """Get the result of a specific action"""
+        start_time = time.time()
+        check_interval = 3
+        while time.time() - start_time < timeout:
+            try:
+                status_result = self.get_action_status(action_id)
+                operation_status = status_result.get("status", "unknown")
+
+                if operation_status in TaskStatuses.COMPLETED_STATUSES:
+                    logging.debug(
+                        f"Operation {action_id} completed with status: "
+                        f"{operation_status}"
+                    )
+                    if operation_status != TaskStatuses.SUCCESS:
+                        pytest.fail(f"Operation {action_id} failed: {status_result}")
+                    return status_result
+
+                time.sleep(check_interval)
+            except Exception as e:
+                logging.warning(f"Error checking operation status: {e}")
+                time.sleep(check_interval)
+        else:
+            raise TimeoutError(f"Timeout waiting for operation {action_id}")
diff --git a/tests/test_scenario/hitless_upgrade_helpers.py b/tests/test_scenario/hitless_upgrade_helpers.py
new file mode 100644
index 0000000000..3997d557cd
--- /dev/null
+++ b/tests/test_scenario/hitless_upgrade_helpers.py
@@ -0,0 +1,287 @@
+import logging
+import time
+from typing import Any, Dict, Optional, Tuple
+import pytest
+
+from redis.client import Redis
+from redis.connection import Connection
+from tests.test_scenario.fault_injector_client import (
+    ActionRequest,
+    ActionType,
+    FaultInjectorClient,
+)
+
+
+class ClientValidations:
+    @staticmethod
+    def wait_push_notification(
+        redis_client: Redis,
+        timeout: int = 120,
+        connection: Optional[Connection] = None,
+    ):
+        """Wait for a push notification to be received."""
+        start_time = time.time()
+        check_interval = 0.2  # Check more frequently during operations
+        test_conn = (
+            connection if connection else redis_client.connection_pool.get_connection()
+        )
+
+        try:
+            while time.time() - start_time < timeout:
+                try:
+                    if test_conn.can_read(timeout=0.2):
+                        # reading is important, it triggers the push notification
+                        push_response = test_conn.read_response(push_request=True)
+                        logging.debug(
+                            f"Push notification has been received. Response: {push_response}"
+                        )
+                        return
+                except Exception as e:
+                    logging.error(f"Error reading push notification: {e}")
+                    break
+                time.sleep(check_interval)
+        finally:
+            # Release the connection back to the pool
+            try:
+                if not connection:
+                    redis_client.connection_pool.release(test_conn)
+            except Exception as e:
+                logging.error(f"Error releasing connection: {e}")
+
+
+class ClusterOperations:
+    @staticmethod
+    def get_cluster_nodes_info(
+        fault_injector: FaultInjectorClient,
+        endpoint_config: Dict[str, Any],
+        timeout: int = 60,
+    ) -> Dict[str, Any]:
+        """Get cluster nodes information from Redis Enterprise."""
+        try:
+            # Use rladmin status to get node information
+            bdb_id = endpoint_config.get("bdb_id")
+            get_status_action = ActionRequest(
+                action_type=ActionType.EXECUTE_RLADMIN_COMMAND,
+                parameters={
+                    "rladmin_command": "status",
+                    "bdb_id": bdb_id,
+                },
+            )
+            trigger_action_result = fault_injector.trigger_action(get_status_action)
+            action_id = trigger_action_result.get("action_id")
+            if not action_id:
+                raise ValueError(
+                    f"Failed to trigger get cluster status action for bdb_id {bdb_id}: {trigger_action_result}"
+                )
+
+            action_status_check_response = fault_injector.get_operation_result(
+                action_id, timeout=timeout
+            )
+            logging.info(
+                f"Completed cluster nodes info reading: {action_status_check_response}"
+            )
+            return action_status_check_response
+
+        except Exception as e:
+            pytest.fail(f"Failed to get cluster nodes info: {e}")
+
+    @staticmethod
+    def find_target_node_and_empty_node(
+        fault_injector: FaultInjectorClient,
+        endpoint_config: Dict[str, Any],
+    ) -> Tuple[str, str]:
+        """Find the node with master shards and the node with no shards.
+
+        Returns:
+            tuple: (target_node, empty_node) where target_node has master shards
+                   and empty_node has no shards
+        """
+        cluster_info = ClusterOperations.get_cluster_nodes_info(
+            fault_injector, endpoint_config
+        )
+        output = cluster_info.get("output", {}).get("output", "")
+
+        if not output:
+            raise ValueError("No cluster status output found")
+
+        # Parse the sections to find nodes with master shards and nodes with no shards
+        lines = output.split("\n")
+        shards_section_started = False
+        nodes_section_started = False
+
+        # Get all node IDs from CLUSTER NODES section
+        all_nodes = set()
+        nodes_with_shards = set()
+        master_nodes = set()
+
+        for line in lines:
+            line = line.strip()
+
+            # Start of CLUSTER NODES section
+            if line.startswith("CLUSTER NODES:"):
+                nodes_section_started = True
+                continue
+            elif line.startswith("DATABASES:"):
+                nodes_section_started = False
+                continue
+            elif nodes_section_started and line and not line.startswith("NODE:ID"):
+                # Parse node line: node:1  master 10.0.101.206 ... (ignore the role)
+                parts = line.split()
+                if len(parts) >= 1:
+                    node_id = parts[0].replace("*", "")  # Remove * prefix if present
+                    all_nodes.add(node_id)
+
+            # Start of SHARDS section - only care about shard roles here
+            if line.startswith("SHARDS:"):
+                shards_section_started = True
+                continue
+            elif shards_section_started and line.startswith("DB:ID"):
+                continue
+            elif shards_section_started and line and not line.startswith("ENDPOINTS:"):
+                # Parse shard line: db:1  m-standard  redis:1  node:2  master  0-8191  1.4MB  OK
+                parts = line.split()
+                if len(parts) >= 5:
+                    node_id = parts[3]  # node:2
+                    shard_role = parts[4]  # master/slave - this is what matters
+
+                    nodes_with_shards.add(node_id)
+                    if shard_role == "master":
+                        master_nodes.add(node_id)
+            elif line.startswith("ENDPOINTS:") or not line:
+                shards_section_started = False
+
+        # Find empty node (node with no shards)
+        empty_nodes = all_nodes - nodes_with_shards
+
+        logging.debug(f"All nodes: {all_nodes}")
+        logging.debug(f"Nodes with shards: {nodes_with_shards}")
+        logging.debug(f"Master nodes: {master_nodes}")
+        logging.debug(f"Empty nodes: {empty_nodes}")
+
+        if not empty_nodes:
+            raise ValueError("No empty nodes (nodes without shards) found")
+
+        if not master_nodes:
+            raise ValueError("No nodes with master shards found")
+
+        # Return the first available empty node and master node (numeric part only)
+        empty_node = next(iter(empty_nodes)).split(":")[1]  # node:1 -> 1
+        target_node = next(iter(master_nodes)).split(":")[1]  # node:2 -> 2
+
+        return target_node, empty_node
+
+    @staticmethod
+    def find_endpoint_for_bind(
+        fault_injector: FaultInjectorClient,
+        endpoint_config: Dict[str, Any],
+        endpoint_name: str,
+        timeout: int = 60,
+    ) -> str:
+        """Find the endpoint ID from cluster status.
+
+        Returns:
+            str: The endpoint ID (e.g., "1:1")
+        """
+        cluster_info = ClusterOperations.get_cluster_nodes_info(
+            fault_injector, endpoint_config, timeout
+        )
+        output = cluster_info.get("output", {}).get("output", "")
+
+        if not output:
+            raise ValueError("No cluster status output found")
+
+        # Parse the ENDPOINTS section to find endpoint ID
+        lines = output.split("\n")
+        endpoints_section_started = False
+
+        for line in lines:
+            line = line.strip()
+
+            # Start of ENDPOINTS section
+            if line.startswith("ENDPOINTS:"):
+                endpoints_section_started = True
+                continue
+            elif line.startswith("SHARDS:"):
+                endpoints_section_started = False
+                break
+            elif endpoints_section_started and line and not line.startswith("DB:ID"):
+                # Parse endpoint line: db:1  m-standard  endpoint:1:1  node:2  single  No
+                parts = line.split()
+                if len(parts) >= 3 and parts[1] == endpoint_name:
+                    endpoint_full = parts[2]  # endpoint:1:1
+                    if endpoint_full.startswith("endpoint:"):
+                        endpoint_id = endpoint_full.replace("endpoint:", "")  # 1:1
+                        return endpoint_id
+
+        raise ValueError(f"No endpoint ID for {endpoint_name} found in cluster status")
+
+    @staticmethod
+    def execute_rladmin_migrate(
+        fault_injector: FaultInjectorClient,
+        endpoint_config: Dict[str, Any],
+        target_node: str,
+        empty_node: str,
+    ) -> str:
+        """Execute rladmin migrate command and wait for completion."""
+        command = f"migrate node {target_node} all_shards target_node {empty_node}"
+
+        # Get bdb_id from endpoint configuration
+        bdb_id = endpoint_config.get("bdb_id")
+
+        try:
+            # Correct parameter format for fault injector
+            parameters = {
+                "bdb_id": bdb_id,
+                "rladmin_command": command,  # Just the command without "rladmin" prefix
+            }
+
+            logging.debug(f"Executing rladmin_command with parameter: {parameters}")
+
+            action = ActionRequest(
+                action_type=ActionType.EXECUTE_RLADMIN_COMMAND, parameters=parameters
+            )
+            result = fault_injector.trigger_action(action)
+
+            logging.debug(f"Migrate command action result: {result}")
+
+            action_id = result.get("action_id")
+
+            if not action_id:
+                raise Exception(f"Failed to trigger migrate action: {result}")
+            return action_id
+        except Exception as e:
+            raise Exception(f"Failed to execute rladmin migrate: {e}")
+
+    @staticmethod
+    def execute_rladmin_bind_endpoint(
+        fault_injector: FaultInjectorClient,
+        endpoint_config: Dict[str, Any],
+        endpoint_id: str,
+    ) -> str:
+        """Execute rladmin bind endpoint command and wait for completion."""
+        command = f"bind endpoint {endpoint_id} policy single"
+
+        bdb_id = endpoint_config.get("bdb_id")
+
+        try:
+            parameters = {
+                "rladmin_command": command,  # Just the command without "rladmin" prefix
+                "bdb_id": bdb_id,
+            }
+
+            logging.info(f"Executing rladmin_command with parameter: {parameters}")
+            action = ActionRequest(
+                action_type=ActionType.EXECUTE_RLADMIN_COMMAND, parameters=parameters
+            )
+            result = fault_injector.trigger_action(action)
+            logging.info(
+                f"Migrate command {command} with parameters {parameters} trigger result: {result}"
+            )
+
+            action_id = result.get("action_id")
+
+            if not action_id:
+                raise Exception(f"Failed to trigger bind endpoint action: {result}")
+            return action_id
+        except Exception as e:
+            raise Exception(f"Failed to execute rladmin bind endpoint: {e}")
diff --git a/tests/test_scenario/test_hitless_upgrade.py b/tests/test_scenario/test_hitless_upgrade.py
new file mode 100644
index 0000000000..c902d7d37f
--- /dev/null
+++ b/tests/test_scenario/test_hitless_upgrade.py
@@ -0,0 +1,795 @@
+"""Tests for Redis Enterprise moving push notifications with real cluster operations."""
+
+import logging
+from queue import Queue
+from threading import Thread
+import threading
+import time
+from typing import Any, Dict
+
+import pytest
+
+from redis import Redis
+from redis.maintenance_events import EndpointType, MaintenanceState
+from tests.test_scenario.conftest import (
+    CLIENT_TIMEOUT,
+    RELAX_TIMEOUT,
+    _get_client_maint_events,
+)
+from tests.test_scenario.fault_injector_client import (
+    FaultInjectorClient,
+)
+from tests.test_scenario.hitless_upgrade_helpers import (
+    ClientValidations,
+    ClusterOperations,
+)
+
+logging.basicConfig(
+    level=logging.DEBUG,
+    format="%(asctime)s %(levelname)s %(message)s",
+    filemode="w",
+    filename="./test_hitless_upgrade.log",
+)
+
+BIND_TIMEOUT = 60
+MIGRATE_TIMEOUT = 120
+
+
+class TestPushNotifications:
+    """
+    Test Redis Enterprise maintenance push notifications with real cluster
+    operations.
+    """
+
+    @pytest.fixture(autouse=True)
+    def setup_and_cleanup(
+        self,
+        client_maint_events: Redis,
+        fault_injector_client: FaultInjectorClient,
+        endpoints_config: Dict[str, Any],
+        endpoint_name: str,
+    ):
+        # Initialize cleanup flags first to ensure they exist even if setup fails
+        self._migration_executed = False
+        self._bind_executed = False
+        self.target_node = None
+        self.empty_node = None
+        self.endpoint_id = None
+
+        try:
+            self.target_node, self.empty_node = (
+                ClusterOperations.find_target_node_and_empty_node(
+                    fault_injector_client, endpoints_config
+                )
+            )
+            logging.info(
+                f"Using target_node: {self.target_node}, empty_node: {self.empty_node}"
+            )
+        except Exception as e:
+            pytest.fail(f"Failed to find target and empty nodes: {e}")
+
+        try:
+            self.endpoint_id = ClusterOperations.find_endpoint_for_bind(
+                fault_injector_client, endpoints_config, endpoint_name
+            )
+            logging.info(f"Using endpoint: {self.endpoint_id}")
+        except Exception as e:
+            pytest.fail(f"Failed to find endpoint for bind operation: {e}")
+
+        # Ensure setup completed successfully
+        if not self.target_node or not self.empty_node:
+            pytest.fail("Setup failed: target_node or empty_node not available")
+        if not self.endpoint_id:
+            pytest.fail("Setup failed: endpoint_id not available")
+
+        # Yield control to the test
+        yield
+
+        # Cleanup code - this will run even if the test fails
+        logging.info("Starting cleanup...")
+        try:
+            client_maint_events.close()
+        except Exception as e:
+            logging.error(f"Failed to close client: {e}")
+
+        # Only attempt cleanup if we have the necessary attributes and they were executed
+        if self._migration_executed:
+            try:
+                if self.target_node and self.empty_node:
+                    self._execute_migration(
+                        fault_injector_client=fault_injector_client,
+                        endpoints_config=endpoints_config,
+                        target_node=self.empty_node,
+                        empty_node=self.target_node,
+                    )
+                    logging.info("Migration cleanup completed")
+            except Exception as e:
+                logging.error(f"Failed to revert migration: {e}")
+
+        if self._bind_executed:
+            try:
+                if self.endpoint_id:
+                    self._execute_bind(
+                        fault_injector_client, endpoints_config, self.endpoint_id
+                    )
+                    logging.info("Bind cleanup completed")
+            except Exception as e:
+                logging.error(f"Failed to revert bind endpoint: {e}")
+
+        logging.info("Cleanup finished")
+
+    def _execute_migration(
+        self,
+        fault_injector_client: FaultInjectorClient,
+        endpoints_config: Dict[str, Any],
+        target_node: str,
+        empty_node: str,
+    ):
+        migrate_action_id = ClusterOperations.execute_rladmin_migrate(
+            fault_injector=fault_injector_client,
+            endpoint_config=endpoints_config,
+            target_node=target_node,
+            empty_node=empty_node,
+        )
+
+        self._migration_executed = True
+
+        migrate_result = fault_injector_client.get_operation_result(
+            migrate_action_id, timeout=MIGRATE_TIMEOUT
+        )
+        logging.debug(f"Migration result: {migrate_result}")
+
+    def _execute_bind(
+        self,
+        fault_injector_client: FaultInjectorClient,
+        endpoints_config: Dict[str, Any],
+        endpoint_id: str,
+    ):
+        bind_action_id = ClusterOperations.execute_rladmin_bind_endpoint(
+            fault_injector_client, endpoints_config, endpoint_id
+        )
+
+        self._bind_executed = True
+
+        bind_result = fault_injector_client.get_operation_result(
+            bind_action_id, timeout=BIND_TIMEOUT
+        )
+        logging.debug(f"Bind result: {bind_result}")
+
+    def _execute_migrate_bind_flow(
+        self,
+        fault_injector_client: FaultInjectorClient,
+        endpoints_config: Dict[str, Any],
+        target_node: str,
+        empty_node: str,
+        endpoint_id: str,
+    ):
+        self._execute_migration(
+            fault_injector_client=fault_injector_client,
+            endpoints_config=endpoints_config,
+            target_node=target_node,
+            empty_node=empty_node,
+        )
+        self._execute_bind(
+            fault_injector_client=fault_injector_client,
+            endpoints_config=endpoints_config,
+            endpoint_id=endpoint_id,
+        )
+
+    def _get_all_connections_in_pool(self, client: Redis):
+        connections = []
+        if hasattr(client.connection_pool, "_available_connections"):
+            for conn in client.connection_pool._available_connections:
+                connections.append(conn)
+        if hasattr(client.connection_pool, "_in_use_connections"):
+            for conn in client.connection_pool._in_use_connections:
+                connections.append(conn)
+        if hasattr(client.connection_pool, "_connections"):
+            # This is the case for BlockingConnectionPool
+            for conn in client.connection_pool._connections:
+                connections.append(conn)
+        return connections
+
+    def _validate_maintenance_state(
+        self, client: Redis, expected_matching_conns_count: int
+    ):
+        """Validate the client connections are in the expected state after migration."""
+        matching_conns_count = 0
+        connections = self._get_all_connections_in_pool(client)
+
+        for conn in connections:
+            if (
+                conn._sock is not None
+                and conn._sock.gettimeout() == RELAX_TIMEOUT
+                and conn.maintenance_state == MaintenanceState.MAINTENANCE
+            ):
+                matching_conns_count += 1
+        assert matching_conns_count == expected_matching_conns_count
+
+    def _validate_moving_state(
+        self,
+        client: Redis,
+        configured_endpoint_type: EndpointType,
+        expected_matching_connected_conns_count: int,
+        expected_matching_disconnected_conns_count: int,
+    ):
+        """Validate the client connections are in the expected state after migration."""
+        matching_connected_conns_count = 0
+        matching_disconnected_conns_count = 0
+        connections = self._get_all_connections_in_pool(client)
+        for conn in connections:
+            endpoint_configured_correctly = bool(
+                (
+                    configured_endpoint_type == EndpointType.NONE
+                    and conn.host == conn.orig_host_address
+                )
+                or (
+                    configured_endpoint_type != EndpointType.NONE
+                    and conn.host != conn.orig_host_address
+                )
+            )
+            if (
+                conn._sock is not None
+                and conn._sock.gettimeout() == RELAX_TIMEOUT
+                and conn.maintenance_state == MaintenanceState.MOVING
+                and endpoint_configured_correctly
+            ):
+                matching_connected_conns_count += 1
+            elif (
+                conn._sock is None
+                and conn.maintenance_state == MaintenanceState.MOVING
+                and conn.socket_timeout == RELAX_TIMEOUT
+                and endpoint_configured_correctly
+            ):
+                matching_disconnected_conns_count += 1
+            else:
+                pass
+        assert matching_connected_conns_count == expected_matching_connected_conns_count
+        assert (
+            matching_disconnected_conns_count
+            == expected_matching_disconnected_conns_count
+        )
+
+    def _validate_default_state(
+        self, client: Redis, expected_matching_conns_count: int
+    ):
+        """Validate the client connections are in the expected state after migration."""
+        matching_conns_count = 0
+        connections = self._get_all_connections_in_pool(client)
+
+        for conn in connections:
+            if conn._sock is None:
+                if (
+                    conn.maintenance_state == MaintenanceState.NONE
+                    and conn.socket_timeout == CLIENT_TIMEOUT
+                    and conn.host == conn.orig_host_address
+                ):
+                    matching_conns_count += 1
+            elif (
+                conn._sock.gettimeout() == CLIENT_TIMEOUT
+                and conn.maintenance_state == MaintenanceState.NONE
+                and conn.host == conn.orig_host_address
+            ):
+                matching_conns_count += 1
+        assert matching_conns_count == expected_matching_conns_count
+
+    def _validate_default_notif_disabled_state(
+        self, client: Redis, expected_matching_conns_count: int
+    ):
+        """Validate the client connections are in the expected state after migration."""
+        matching_conns_count = 0
+        connections = self._get_all_connections_in_pool(client)
+
+        for conn in connections:
+            if conn._sock is None:
+                if (
+                    conn.maintenance_state == MaintenanceState.NONE
+                    and conn.socket_timeout == CLIENT_TIMEOUT
+                    and not hasattr(conn, "orig_host_address")
+                ):
+                    matching_conns_count += 1
+            elif (
+                conn._sock.gettimeout() == CLIENT_TIMEOUT
+                and conn.maintenance_state == MaintenanceState.NONE
+                and not hasattr(conn, "orig_host_address")
+            ):
+                matching_conns_count += 1
+        assert matching_conns_count == expected_matching_conns_count
+
+    @pytest.mark.timeout(300)  # 5 minutes timeout for this test
+    def test_receive_migrating_and_moving_push_notification(
+        self,
+        client_maint_events: Redis,
+        fault_injector_client: FaultInjectorClient,
+        endpoints_config: Dict[str, Any],
+    ):
+        """
+        Test the push notifications are received when executing cluster operations.
+
+        """
+
+        logging.info("Executing rladmin migrate command...")
+        migrate_thread = Thread(
+            target=self._execute_migration,
+            name="migrate_thread",
+            args=(
+                fault_injector_client,
+                endpoints_config,
+                self.target_node,
+                self.empty_node,
+            ),
+        )
+        migrate_thread.start()
+
+        logging.info("Waiting for MIGRATING push notifications...")
+        ClientValidations.wait_push_notification(
+            client_maint_events, timeout=MIGRATE_TIMEOUT
+        )
+
+        logging.info("Validating connection migrating state...")
+        conn = client_maint_events.connection_pool.get_connection()
+        assert conn.maintenance_state == MaintenanceState.MAINTENANCE
+        assert conn._sock.gettimeout() == RELAX_TIMEOUT
+        client_maint_events.connection_pool.release(conn)
+
+        logging.info("Waiting for MIGRATED push notifications...")
+        ClientValidations.wait_push_notification(
+            client_maint_events, timeout=MIGRATE_TIMEOUT
+        )
+
+        logging.info("Validating connection states...")
+        conn = client_maint_events.connection_pool.get_connection()
+        assert conn.maintenance_state == MaintenanceState.NONE
+        assert conn._sock.gettimeout() == CLIENT_TIMEOUT
+        client_maint_events.connection_pool.release(conn)
+
+        migrate_thread.join()
+
+        logging.info("Executing rladmin bind endpoint command...")
+
+        bind_thread = Thread(
+            target=self._execute_bind,
+            name="bind_thread",
+            args=(fault_injector_client, endpoints_config, self.endpoint_id),
+        )
+        bind_thread.start()
+
+        logging.info("Waiting for MOVING push notifications...")
+        ClientValidations.wait_push_notification(
+            client_maint_events, timeout=BIND_TIMEOUT
+        )
+
+        logging.info("Validating connection states...")
+        conn = client_maint_events.connection_pool.get_connection()
+        assert conn.maintenance_state == MaintenanceState.MOVING
+        assert conn._sock.gettimeout() == RELAX_TIMEOUT
+
+        logging.info("Waiting for moving ttl to expire")
+        time.sleep(BIND_TIMEOUT)
+
+        logging.info("Validating connection states...")
+        assert conn.maintenance_state == MaintenanceState.NONE
+        assert conn.socket_timeout == CLIENT_TIMEOUT
+        assert conn._sock.gettimeout() == CLIENT_TIMEOUT
+        client_maint_events.connection_pool.release(conn)
+        bind_thread.join()
+
+    @pytest.mark.timeout(300)  # 5 minutes timeout
+    @pytest.mark.parametrize(
+        "endpoint_type",
+        [
+            EndpointType.EXTERNAL_FQDN,
+            EndpointType.EXTERNAL_IP,
+            EndpointType.NONE,
+        ],
+    )
+    def test_timeout_handling_during_migrating_and_moving(
+        self,
+        endpoint_type: EndpointType,
+        fault_injector_client: FaultInjectorClient,
+        endpoints_config: Dict[str, Any],
+    ):
+        """
+        Test the push notifications are received when executing cluster operations.
+
+        """
+        logging.info(f"Testing timeout handling for endpoint type: {endpoint_type}")
+        client = _get_client_maint_events(
+            endpoints_config=endpoints_config, endpoint_type=endpoint_type
+        )
+
+        # Create three connections in the pool
+        logging.info("Creating three connections in the pool.")
+        conns = []
+        for _ in range(3):
+            conns.append(client.connection_pool.get_connection())
+        # Release the connections
+        for conn in conns:
+            client.connection_pool.release(conn)
+
+        logging.info("Executing rladmin migrate command...")
+        migrate_thread = Thread(
+            target=self._execute_migration,
+            name="migrate_thread",
+            args=(
+                fault_injector_client,
+                endpoints_config,
+                self.target_node,
+                self.empty_node,
+            ),
+        )
+        migrate_thread.start()
+
+        logging.info("Waiting for MIGRATING push notifications...")
+        # this will consume the notification in one of the connections
+        ClientValidations.wait_push_notification(client, timeout=MIGRATE_TIMEOUT)
+
+        self._validate_maintenance_state(client, expected_matching_conns_count=1)
+        self._validate_default_state(client, expected_matching_conns_count=2)
+
+        logging.info("Waiting for MIGRATED push notifications...")
+        ClientValidations.wait_push_notification(client, timeout=MIGRATE_TIMEOUT)
+
+        logging.info("Validating connection states after MIGRATED ...")
+        self._validate_default_state(client, expected_matching_conns_count=3)
+
+        migrate_thread.join()
+
+        logging.info("Executing rladmin bind endpoint command...")
+
+        bind_thread = Thread(
+            target=self._execute_bind,
+            name="bind_thread",
+            args=(fault_injector_client, endpoints_config, self.endpoint_id),
+        )
+        bind_thread.start()
+
+        logging.info("Waiting for MOVING push notifications...")
+        # this will consume the notification in one of the connections
+        # and will handle the states of the rest
+        # the consumed connection will be disconnected during
+        # releasing it back to the pool and as a result we will have
+        # 3 disconnected connections in the pool
+        ClientValidations.wait_push_notification(client, timeout=BIND_TIMEOUT)
+
+        if endpoint_type == EndpointType.NONE:
+            logging.info(
+                "Waiting for moving ttl/2 to expire to validate proactive reconnection"
+            )
+            time.sleep(8)
+
+        logging.info("Validating connections states...")
+        self._validate_moving_state(
+            client,
+            endpoint_type,
+            expected_matching_connected_conns_count=0,
+            expected_matching_disconnected_conns_count=3,
+        )
+        # during get_connection() the connection will be reconnected
+        # either to the address provided in the moving event or to the original address
+        # depending on the configured endpoint type
+        # with this call we test if we are able to connect to the new address
+        conn = client.connection_pool.get_connection()
+        self._validate_moving_state(
+            client,
+            endpoint_type,
+            expected_matching_connected_conns_count=1,
+            expected_matching_disconnected_conns_count=2,
+        )
+        client.connection_pool.release(conn)
+
+        logging.info("Waiting for moving ttl to expire")
+        time.sleep(BIND_TIMEOUT)
+
+        logging.info("Validating connection states...")
+        self._validate_default_state(client, expected_matching_conns_count=3)
+        bind_thread.join()
+
+    @pytest.mark.timeout(300)  # 5 minutes timeout
+    @pytest.mark.parametrize(
+        "endpoint_type",
+        [
+            EndpointType.EXTERNAL_FQDN,
+            EndpointType.EXTERNAL_IP,
+            EndpointType.NONE,
+        ],
+    )
+    def test_new_connection_handling_during_migrating_and_moving(
+        self,
+        endpoint_type: EndpointType,
+        fault_injector_client: FaultInjectorClient,
+        endpoints_config: Dict[str, Any],
+    ):
+        logging.info(f"Testing timeout handling for endpoint type: {endpoint_type}")
+        client = _get_client_maint_events(
+            endpoints_config=endpoints_config, endpoint_type=endpoint_type
+        )
+
+        logging.info("Creating one connection in the pool.")
+        first_conn = client.connection_pool.get_connection()
+
+        logging.info("Executing rladmin migrate command...")
+        migrate_thread = Thread(
+            target=self._execute_migration,
+            name="migrate_thread",
+            args=(
+                fault_injector_client,
+                endpoints_config,
+                self.target_node,
+                self.empty_node,
+            ),
+        )
+        migrate_thread.start()
+
+        logging.info("Waiting for MIGRATING push notifications...")
+        # this will consume the notification in the provided connection
+        ClientValidations.wait_push_notification(
+            client, timeout=MIGRATE_TIMEOUT, connection=first_conn
+        )
+
+        self._validate_maintenance_state(client, expected_matching_conns_count=1)
+
+        # validate that new connections will also receive the moving event
+        logging.info(
+            "Creating second connection in the pool"
+            " and expect it to receive the migrating as well."
+        )
+
+        second_connection = client.connection_pool.get_connection()
+        ClientValidations.wait_push_notification(
+            client, timeout=MIGRATE_TIMEOUT, connection=second_connection
+        )
+
+        logging.info(
+            "Validating connection states after MIGRATING for both connections ..."
+        )
+        self._validate_maintenance_state(client, expected_matching_conns_count=2)
+
+        logging.info("Waiting for MIGRATED push notifications on both connections ...")
+        ClientValidations.wait_push_notification(
+            client, timeout=MIGRATE_TIMEOUT, connection=first_conn
+        )
+        ClientValidations.wait_push_notification(
+            client, timeout=MIGRATE_TIMEOUT, connection=second_connection
+        )
+
+        client.connection_pool.release(first_conn)
+        client.connection_pool.release(second_connection)
+
+        migrate_thread.join()
+
+        logging.info("Executing rladmin bind endpoint command...")
+
+        bind_thread = Thread(
+            target=self._execute_bind,
+            name="bind_thread",
+            args=(fault_injector_client, endpoints_config, self.endpoint_id),
+        )
+        bind_thread.start()
+
+        logging.info("Waiting for MOVING push notifications on random connection ...")
+        # this will consume the notification in one of the connections
+        # and will handle the states of the rest
+        # the consumed connection will be disconnected during
+        # releasing it back to the pool and as a result we will have
+        # 3 disconnected connections in the pool
+        ClientValidations.wait_push_notification(client, timeout=BIND_TIMEOUT)
+
+        if endpoint_type == EndpointType.NONE:
+            logging.info(
+                "Waiting for moving ttl/2 to expire to validate proactive reconnection"
+            )
+            time.sleep(8)
+
+        # validate that new connections will also receive the moving event
+        connections = []
+        for _ in range(3):
+            connections.append(client.connection_pool.get_connection())
+        for conn in connections:
+            client.connection_pool.release(conn)
+
+        logging.info("Validating connections states during MOVING ...")
+        # during get_connection() the existing connection will be reconnected
+        # either to the address provided in the moving event or to the original address
+        # depending on the configured endpoint type
+        # with this call we test if we are able to connect to the new address
+        # new connection should also be marked as moving
+        self._validate_moving_state(
+            client,
+            endpoint_type,
+            expected_matching_connected_conns_count=3,
+            expected_matching_disconnected_conns_count=0,
+        )
+
+        logging.info("Waiting for moving ttl to expire")
+        time.sleep(BIND_TIMEOUT)
+
+        logging.info("Validating connection states after MOVING has expired ...")
+        self._validate_default_state(client, expected_matching_conns_count=3)
+        bind_thread.join()
+
+    @pytest.mark.timeout(300)
+    def test_disabled_handling_during_migrating_and_moving(
+        self,
+        fault_injector_client: FaultInjectorClient,
+        endpoints_config: Dict[str, Any],
+    ):
+        logging.info("Creating client with disabled notifications.")
+        client = _get_client_maint_events(
+            endpoints_config=endpoints_config,
+            enable_maintenance_events=False,
+        )
+
+        logging.info("Creating one connection in the pool.")
+        first_conn = client.connection_pool.get_connection()
+
+        logging.info("Executing rladmin migrate command...")
+        migrate_thread = Thread(
+            target=self._execute_migration,
+            name="migrate_thread",
+            args=(
+                fault_injector_client,
+                endpoints_config,
+                self.target_node,
+                self.empty_node,
+            ),
+        )
+        migrate_thread.start()
+
+        logging.info("Waiting for MIGRATING push notifications...")
+        # this will consume the notification in the provided connection
+        ClientValidations.wait_push_notification(
+            client, timeout=5, connection=first_conn
+        )
+
+        self._validate_default_notif_disabled_state(
+            client, expected_matching_conns_count=1
+        )
+
+        # validate that new connections will also receive the moving event
+        logging.info(
+            "Creating second connection in the pool"
+            " and expect it to receive the migrating as well."
+        )
+
+        second_connection = client.connection_pool.get_connection()
+        ClientValidations.wait_push_notification(
+            client, timeout=5, connection=second_connection
+        )
+
+        logging.info(
+            "Validating connection states after MIGRATING for both connections ..."
+        )
+        self._validate_default_notif_disabled_state(
+            client, expected_matching_conns_count=2
+        )
+
+        logging.info("Waiting for MIGRATED push notifications on both connections ...")
+        ClientValidations.wait_push_notification(
+            client, timeout=5, connection=first_conn
+        )
+        ClientValidations.wait_push_notification(
+            client, timeout=5, connection=second_connection
+        )
+
+        client.connection_pool.release(first_conn)
+        client.connection_pool.release(second_connection)
+
+        migrate_thread.join()
+
+        logging.info("Executing rladmin bind endpoint command...")
+
+        bind_thread = Thread(
+            target=self._execute_bind,
+            name="bind_thread",
+            args=(fault_injector_client, endpoints_config, self.endpoint_id),
+        )
+        bind_thread.start()
+
+        logging.info("Waiting for MOVING push notifications on random connection ...")
+        # this will consume the notification in one of the connections
+        # and will handle the states of the rest
+        # the consumed connection will be disconnected during
+        # releasing it back to the pool and as a result we will have
+        # 3 disconnected connections in the pool
+        ClientValidations.wait_push_notification(client, timeout=10)
+
+        # validate that new connections will also receive the moving event
+        connections = []
+        for _ in range(3):
+            connections.append(client.connection_pool.get_connection())
+        for conn in connections:
+            client.connection_pool.release(conn)
+
+        logging.info("Validating connections states during MOVING ...")
+        self._validate_default_notif_disabled_state(
+            client, expected_matching_conns_count=3
+        )
+
+        logging.info("Waiting for moving ttl to expire")
+        time.sleep(30)
+
+        logging.info("Validating connection states after MOVING has expired ...")
+        self._validate_default_notif_disabled_state(
+            client, expected_matching_conns_count=3
+        )
+        bind_thread.join()
+
+    @pytest.mark.timeout(300)
+    @pytest.mark.parametrize(
+        "endpoint_type",
+        [
+            EndpointType.EXTERNAL_FQDN,
+            EndpointType.EXTERNAL_IP,
+            EndpointType.NONE,
+        ],
+    )
+    def test_command_execution_during_migrating_and_moving(
+        self,
+        fault_injector_client: FaultInjectorClient,
+        endpoints_config: Dict[str, Any],
+        endpoint_type: EndpointType,
+    ):
+        """
+        Test command execution during migrating and moving events.
+
+        This test validates that:
+        1. Commands can be executed during MIGRATING and MOVING events
+        2. Commands are not blocked by the events
+        3. Commands are executed successfully
+        """
+        errors = Queue()
+        execution_duration = 180
+        socket_timeout = 0.5
+
+        client = _get_client_maint_events(
+            endpoints_config=endpoints_config,
+            endpoint_type=endpoint_type,
+            disable_retries=True,
+            socket_timeout=socket_timeout,
+            enable_maintenance_events=True,
+        )
+
+        migrate_and_bind_thread = Thread(
+            target=self._execute_migrate_bind_flow,
+            name="migrate_and_bind_thread",
+            args=(
+                fault_injector_client,
+                endpoints_config,
+                self.target_node,
+                self.empty_node,
+                self.endpoint_id,
+            ),
+        )
+        migrate_and_bind_thread.start()
+
+        def execute_commands(duration: int, errors: Queue):
+            start = time.time()
+            while time.time() - start < duration:
+                try:
+                    client.set("key", "value")
+                    client.get("key")
+                except Exception as e:
+                    errors.put(
+                        f"Command failed in thread {threading.current_thread().name}: {e}"
+                    )
+
+        threads = []
+        for _ in range(10):
+            thread = Thread(
+                target=execute_commands,
+                name="command_execution_thread",
+                args=(
+                    execution_duration,
+                    errors,
+                ),
+            )
+            thread.start()
+            threads.append(thread)
+
+        for thread in threads:
+            thread.join()
+
+        migrate_and_bind_thread.join()
+
+        assert errors.empty(), f"Errors occurred in threads: {errors.queue}"

From ea22b12c64e99c0379562a5e1da94b0882507dd3 Mon Sep 17 00:00:00 2001
From: Michael Scovetta <michael.scovetta@gmail.com>
Date: Tue, 9 Sep 2025 05:32:43 -0400
Subject: [PATCH 1115/1164] Fix docstring for ssl_check_hostname (#3761)

The default value of `ssl_check_hostname` was changed in #3626 but the docstring still stated the default was `False`. This PR just changes that docstring text to match the new default.
---
 redis/connection.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/connection.py b/redis/connection.py
index 2c1a985638..226d22539c 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -1379,7 +1379,7 @@ def __init__(
             ssl_cert_reqs: The string value for the SSLContext.verify_mode (none, optional, required), or an ssl.VerifyMode. Defaults to "required".
             ssl_ca_certs: The path to a file of concatenated CA certificates in PEM format. Defaults to None.
             ssl_ca_data: Either an ASCII string of one or more PEM-encoded certificates or a bytes-like object of DER-encoded certificates.
-            ssl_check_hostname: If set, match the hostname during the SSL handshake. Defaults to False.
+            ssl_check_hostname: If set, match the hostname during the SSL handshake. Defaults to True.
             ssl_ca_path: The path to a directory containing several CA certificates in PEM format. Defaults to None.
             ssl_password: Password for unlocking an encrypted private key. Defaults to None.
 

From 8403ddcfcf16c95baab330076b4905483e44fbb7 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 9 Sep 2025 16:08:53 +0300
Subject: [PATCH 1116/1164] Bump actions/checkout from 4 to 5 (#3760)

Bumps [actions/checkout](https://github.com/actions/checkout) from 4 to 5.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v4...v5)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '5'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: petyaslavova <petya.slavova@redis.com>
---
 .github/workflows/codeql-analysis.yml         |  2 +-
 .github/workflows/docs.yaml                   |  2 +-
 .github/workflows/hiredis-py-integration.yaml |  2 +-
 .github/workflows/integration.yaml            | 16 ++++++++--------
 .github/workflows/pypi-publish.yaml           |  2 +-
 .github/workflows/spellcheck.yml              |  2 +-
 6 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/.github/workflows/codeql-analysis.yml b/.github/workflows/codeql-analysis.yml
index 4670c55b0f..abd3198edf 100644
--- a/.github/workflows/codeql-analysis.yml
+++ b/.github/workflows/codeql-analysis.yml
@@ -36,7 +36,7 @@ jobs:
 
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
 
     # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL
diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml
index 747b3b6d76..26e32f1dde 100644
--- a/.github/workflows/docs.yaml
+++ b/.github/workflows/docs.yaml
@@ -25,7 +25,7 @@ jobs:
      name: Build docs
      runs-on: ubuntu-latest
      steps:
-       - uses: actions/checkout@v4
+       - uses: actions/checkout@v5
        - uses: actions/setup-python@v5
          with:
            python-version: 3.9
diff --git a/.github/workflows/hiredis-py-integration.yaml b/.github/workflows/hiredis-py-integration.yaml
index 855e9aa8f2..e2cb03c4a6 100644
--- a/.github/workflows/hiredis-py-integration.yaml
+++ b/.github/workflows/hiredis-py-integration.yaml
@@ -53,7 +53,7 @@ jobs:
       ACTIONS_ALLOW_UNSECURE_COMMANDS: true
     name: Redis ${{ matrix.redis-version }}; Python ${{ matrix.python-version }}; RESP Parser:${{matrix.parser-backend}} (${{ matrix.hiredis-version }}); EL:${{matrix.event-loop}}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           ref: ${{ inputs.redis-py-branch }}
       - name: Run tests
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 4046763250..718702161b 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -35,7 +35,7 @@ jobs:
     name: Dependency audit
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: pypa/gh-action-pip-audit@v1.0.8
         with:
           inputs: dev_requirements.txt
@@ -46,7 +46,7 @@ jobs:
     name: Code linters
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: actions/setup-python@v5
         with:
           python-version: 3.9
@@ -82,7 +82,7 @@ jobs:
       ACTIONS_ALLOW_UNSECURE_COMMANDS: true
     name: Redis ${{ matrix.redis-version }}; Python ${{ matrix.python-version }}; RESP Parser:${{matrix.parser-backend}}; EL:${{matrix.event-loop}}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Run tests
         uses: ./.github/actions/run-tests
         with:
@@ -106,7 +106,7 @@ jobs:
       ACTIONS_ALLOW_UNSECURE_COMMANDS: true
     name: Redis ${{ matrix.redis-version }}; Python ${{ matrix.python-version }}; RESP Parser:${{matrix.parser-backend}}; EL:${{matrix.event-loop}}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Run tests
         uses: ./.github/actions/run-tests
         with:
@@ -131,7 +131,7 @@ jobs:
       ACTIONS_ALLOW_UNSECURE_COMMANDS: true
     name: Redis ${{ matrix.redis-version }}; Python ${{ matrix.python-version }}; RESP Parser:${{matrix.parser-backend}} (${{ matrix.hiredis-version }}); EL:${{matrix.event-loop}}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Run tests
         uses: ./.github/actions/run-tests
         with:
@@ -156,7 +156,7 @@ jobs:
       ACTIONS_ALLOW_UNSECURE_COMMANDS: true
     name: Redis ${{ matrix.redis-version }}; Python ${{ matrix.python-version }}; RESP Parser:${{matrix.parser-backend}}; EL:${{matrix.event-loop}}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Run tests
         uses: ./.github/actions/run-tests
         with:
@@ -174,7 +174,7 @@ jobs:
       matrix:
         extension: ['tar.gz', 'whl']
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: actions/setup-python@v5
         with:
           python-version: 3.9
@@ -193,7 +193,7 @@ jobs:
       matrix:
         python-version: ['3.9', '3.10', '3.11', '3.12', '3.13', 'pypy-3.9', 'pypy-3.10']
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
diff --git a/.github/workflows/pypi-publish.yaml b/.github/workflows/pypi-publish.yaml
index 048d06c53c..6b7e4dc800 100644
--- a/.github/workflows/pypi-publish.yaml
+++ b/.github/workflows/pypi-publish.yaml
@@ -13,7 +13,7 @@ jobs:
   build_and_package:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: install python
         uses: actions/setup-python@v5
         with:
diff --git a/.github/workflows/spellcheck.yml b/.github/workflows/spellcheck.yml
index 81e73cd4ba..9daecbc5e4 100644
--- a/.github/workflows/spellcheck.yml
+++ b/.github/workflows/spellcheck.yml
@@ -6,7 +6,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: Check Spelling
         uses: rojopolis/spellcheck-github-actions@0.51.0
         with:

From 9aa987d9e46f51364541a6777fb75ad6d8883a08 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Wed, 24 Sep 2025 11:10:22 +0300
Subject: [PATCH 1117/1164] Adding more e2e tests related to maintenance
 notifications. Extracting specific tests that validate notifications are
 received in new connections (#3770)

---
 tests/test_scenario/conftest.py               |  11 +-
 tests/test_scenario/fault_injector_client.py  |   5 +-
 .../test_scenario/hitless_upgrade_helpers.py  |  39 ++
 tests/test_scenario/test_hitless_upgrade.py   | 393 ++++++++++++++++--
 4 files changed, 402 insertions(+), 46 deletions(-)

diff --git a/tests/test_scenario/conftest.py b/tests/test_scenario/conftest.py
index 2ea572c93e..805941bbaf 100644
--- a/tests/test_scenario/conftest.py
+++ b/tests/test_scenario/conftest.py
@@ -55,12 +55,14 @@ def client_maint_events(endpoints_config):
 
 def _get_client_maint_events(
     endpoints_config,
+    protocol: int = 3,
     enable_maintenance_events: bool = True,
     endpoint_type: Optional[EndpointType] = None,
     enable_relax_timeout: bool = True,
     enable_proactive_reconnect: bool = True,
     disable_retries: bool = False,
     socket_timeout: Optional[float] = None,
+    host_config: Optional[str] = None,
 ):
     """Create Redis client with maintenance events enabled."""
 
@@ -74,11 +76,9 @@ def _get_client_maint_events(
         raise ValueError("No endpoints found in configuration")
 
     parsed = urlparse(endpoints[0])
-    host = parsed.hostname
+    host = parsed.hostname if host_config is None else host_config
     port = parsed.port
 
-    tls_enabled = True if parsed.scheme == "rediss" else False
-
     if not host:
         raise ValueError(f"Could not parse host from endpoint URL: {endpoints[0]}")
 
@@ -99,6 +99,9 @@ def _get_client_maint_events(
     else:
         retry = Retry(backoff=ExponentialWithJitterBackoff(base=1, cap=10), retries=3)
 
+    tls_enabled = True if parsed.scheme == "rediss" else False
+    logging.info(f"TLS enabled: {tls_enabled}")
+
     client = Redis(
         host=host,
         port=port,
@@ -108,7 +111,7 @@ def _get_client_maint_events(
         ssl=tls_enabled,
         ssl_cert_reqs="none",
         ssl_check_hostname=False,
-        protocol=3,  # RESP3 required for push notifications
+        protocol=protocol,  # RESP3 required for push notifications
         maintenance_events_config=maintenance_config,
         retry=retry,
     )
diff --git a/tests/test_scenario/fault_injector_client.py b/tests/test_scenario/fault_injector_client.py
index fffda9ac01..8bce3a19e7 100644
--- a/tests/test_scenario/fault_injector_client.py
+++ b/tests/test_scenario/fault_injector_client.py
@@ -2,6 +2,7 @@
 import logging
 import time
 import urllib.request
+import urllib.error
 from typing import Dict, Any, Optional, Union
 from enum import Enum
 
@@ -94,7 +95,7 @@ def get_action_status(self, action_id: str) -> Dict[str, Any]:
         return self._make_request("GET", f"/action/{action_id}")
 
     def execute_rladmin_command(
-        self, command: str, bdb_id: str = None
+        self, command: str, bdb_id: Optional[str] = None
     ) -> Dict[str, Any]:
         """Execute rladmin command directly as string"""
         url = f"{self.base_url}/rladmin"
@@ -146,4 +147,4 @@ def get_operation_result(
                 logging.warning(f"Error checking operation status: {e}")
                 time.sleep(check_interval)
         else:
-            raise TimeoutError(f"Timeout waiting for operation {action_id}")
+            pytest.fail(f"Timeout waiting for operation {action_id}")
diff --git a/tests/test_scenario/hitless_upgrade_helpers.py b/tests/test_scenario/hitless_upgrade_helpers.py
index 3997d557cd..0abc0e067c 100644
--- a/tests/test_scenario/hitless_upgrade_helpers.py
+++ b/tests/test_scenario/hitless_upgrade_helpers.py
@@ -17,6 +17,7 @@ class ClientValidations:
     def wait_push_notification(
         redis_client: Redis,
         timeout: int = 120,
+        fail_on_timeout: bool = True,
         connection: Optional[Connection] = None,
     ):
         """Wait for a push notification to be received."""
@@ -35,11 +36,15 @@ def wait_push_notification(
                         logging.debug(
                             f"Push notification has been received. Response: {push_response}"
                         )
+                        if test_conn.should_reconnect():
+                            logging.debug("Connection is marked for reconnect")
                         return
                 except Exception as e:
                     logging.error(f"Error reading push notification: {e}")
                     break
                 time.sleep(check_interval)
+            if fail_on_timeout:
+                pytest.fail("Timeout waiting for push notification")
         finally:
             # Release the connection back to the pool
             try:
@@ -215,6 +220,40 @@ def find_endpoint_for_bind(
 
         raise ValueError(f"No endpoint ID for {endpoint_name} found in cluster status")
 
+    @staticmethod
+    def execute_failover(
+        fault_injector: FaultInjectorClient,
+        endpoint_config: Dict[str, Any],
+        timeout: int = 60,
+    ) -> Dict[str, Any]:
+        """Execute failover command and wait for completion."""
+
+        try:
+            bdb_id = endpoint_config.get("bdb_id")
+            failover_action = ActionRequest(
+                action_type=ActionType.FAILOVER,
+                parameters={
+                    "bdb_id": bdb_id,
+                },
+            )
+            trigger_action_result = fault_injector.trigger_action(failover_action)
+            action_id = trigger_action_result.get("action_id")
+            if not action_id:
+                raise ValueError(
+                    f"Failed to trigger fail over action for bdb_id {bdb_id}: {trigger_action_result}"
+                )
+
+            action_status_check_response = fault_injector.get_operation_result(
+                action_id, timeout=timeout
+            )
+            logging.info(
+                f"Completed cluster nodes info reading: {action_status_check_response}"
+            )
+            return action_status_check_response
+
+        except Exception as e:
+            pytest.fail(f"Failed to get cluster nodes info: {e}")
+
     @staticmethod
     def execute_rladmin_migrate(
         fault_injector: FaultInjectorClient,
diff --git a/tests/test_scenario/test_hitless_upgrade.py b/tests/test_scenario/test_hitless_upgrade.py
index c902d7d37f..f23be4d4b2 100644
--- a/tests/test_scenario/test_hitless_upgrade.py
+++ b/tests/test_scenario/test_hitless_upgrade.py
@@ -1,16 +1,22 @@
 """Tests for Redis Enterprise moving push notifications with real cluster operations."""
 
+from concurrent.futures import ThreadPoolExecutor
 import logging
 from queue import Queue
 from threading import Thread
 import threading
 import time
-from typing import Any, Dict
+from typing import Any, Dict, List
 
 import pytest
 
 from redis import Redis
-from redis.maintenance_events import EndpointType, MaintenanceState
+from redis.connection import ConnectionInterface
+from redis.maintenance_events import (
+    EndpointType,
+    MaintenanceEventsConfig,
+    MaintenanceState,
+)
 from tests.test_scenario.conftest import (
     CLIENT_TIMEOUT,
     RELAX_TIMEOUT,
@@ -25,14 +31,15 @@
 )
 
 logging.basicConfig(
-    level=logging.DEBUG,
+    level=logging.INFO,
     format="%(asctime)s %(levelname)s %(message)s",
-    filemode="w",
-    filename="./test_hitless_upgrade.log",
 )
 
-BIND_TIMEOUT = 60
-MIGRATE_TIMEOUT = 120
+BIND_TIMEOUT = 30
+MIGRATE_TIMEOUT = 60
+FAILOVER_TIMEOUT = 15
+
+DEFAULT_BIND_TTL = 15
 
 
 class TestPushNotifications:
@@ -50,6 +57,7 @@ def setup_and_cleanup(
         endpoint_name: str,
     ):
         # Initialize cleanup flags first to ensure they exist even if setup fails
+        self._failover_executed = False
         self._migration_executed = False
         self._bind_executed = False
         self.target_node = None
@@ -93,6 +101,13 @@ def setup_and_cleanup(
             logging.error(f"Failed to close client: {e}")
 
         # Only attempt cleanup if we have the necessary attributes and they were executed
+        if self._failover_executed:
+            try:
+                self._execute_failover(fault_injector_client, endpoints_config)
+                logging.info("Failover cleanup completed")
+            except Exception as e:
+                logging.error(f"Failed to revert failover: {e}")
+
         if self._migration_executed:
             try:
                 if self.target_node and self.empty_node:
@@ -118,6 +133,18 @@ def setup_and_cleanup(
 
         logging.info("Cleanup finished")
 
+    def _execute_failover(
+        self,
+        fault_injector_client: FaultInjectorClient,
+        endpoints_config: Dict[str, Any],
+    ):
+        failover_result = ClusterOperations.execute_failover(
+            fault_injector_client, endpoints_config
+        )
+        self._failover_executed = True
+
+        logging.debug(f"Failover result: {failover_result}")
+
     def _execute_migration(
         self,
         fault_injector_client: FaultInjectorClient,
@@ -176,7 +203,7 @@ def _execute_migrate_bind_flow(
             endpoint_id=endpoint_id,
         )
 
-    def _get_all_connections_in_pool(self, client: Redis):
+    def _get_all_connections_in_pool(self, client: Redis) -> List[ConnectionInterface]:
         connections = []
         if hasattr(client.connection_pool, "_available_connections"):
             for conn in client.connection_pool._available_connections:
@@ -226,6 +253,10 @@ def _validate_moving_state(
                 or (
                     configured_endpoint_type != EndpointType.NONE
                     and conn.host != conn.orig_host_address
+                    and (
+                        configured_endpoint_type
+                        == MaintenanceEventsConfig().get_endpoint_type(conn.host, conn)
+                    )
                 )
             )
             if (
@@ -296,6 +327,51 @@ def _validate_default_notif_disabled_state(
                 matching_conns_count += 1
         assert matching_conns_count == expected_matching_conns_count
 
+    @pytest.mark.timeout(300)  # 5 minutes timeout for this test
+    def test_receive_failing_over_and_failed_over_push_notification(
+        self,
+        client_maint_events: Redis,
+        fault_injector_client: FaultInjectorClient,
+        endpoints_config: Dict[str, Any],
+    ):
+        """
+        Test the push notifications are received when executing cluster operations.
+
+        """
+        logging.info("Creating one connection in the pool.")
+        conn = client_maint_events.connection_pool.get_connection()
+
+        logging.info("Executing failover command...")
+        failover_thread = Thread(
+            target=self._execute_failover,
+            name="failover_thread",
+            args=(fault_injector_client, endpoints_config),
+        )
+        failover_thread.start()
+
+        logging.info("Waiting for FAILING_OVER push notifications...")
+        ClientValidations.wait_push_notification(
+            client_maint_events, timeout=FAILOVER_TIMEOUT, connection=conn
+        )
+
+        logging.info("Validating connection maintenance state...")
+        assert conn.maintenance_state == MaintenanceState.MAINTENANCE
+        assert conn._sock.gettimeout() == RELAX_TIMEOUT
+
+        logging.info("Waiting for FAILED_OVER push notifications...")
+        ClientValidations.wait_push_notification(
+            client_maint_events, timeout=FAILOVER_TIMEOUT, connection=conn
+        )
+
+        logging.info("Validating connection default states is restored...")
+        assert conn.maintenance_state == MaintenanceState.NONE
+        assert conn._sock.gettimeout() == CLIENT_TIMEOUT
+
+        logging.info("Releasing connection back to the pool...")
+        client_maint_events.connection_pool.release(conn)
+
+        failover_thread.join()
+
     @pytest.mark.timeout(300)  # 5 minutes timeout for this test
     def test_receive_migrating_and_moving_push_notification(
         self,
@@ -494,7 +570,7 @@ def test_timeout_handling_during_migrating_and_moving(
             EndpointType.NONE,
         ],
     )
-    def test_new_connection_handling_during_migrating_and_moving(
+    def test_connection_handling_during_moving(
         self,
         endpoint_type: EndpointType,
         fault_injector_client: FaultInjectorClient,
@@ -529,32 +605,12 @@ def test_new_connection_handling_during_migrating_and_moving(
 
         self._validate_maintenance_state(client, expected_matching_conns_count=1)
 
-        # validate that new connections will also receive the moving event
-        logging.info(
-            "Creating second connection in the pool"
-            " and expect it to receive the migrating as well."
-        )
-
-        second_connection = client.connection_pool.get_connection()
-        ClientValidations.wait_push_notification(
-            client, timeout=MIGRATE_TIMEOUT, connection=second_connection
-        )
-
-        logging.info(
-            "Validating connection states after MIGRATING for both connections ..."
-        )
-        self._validate_maintenance_state(client, expected_matching_conns_count=2)
-
-        logging.info("Waiting for MIGRATED push notifications on both connections ...")
+        logging.info("Waiting for MIGRATED push notification ...")
         ClientValidations.wait_push_notification(
             client, timeout=MIGRATE_TIMEOUT, connection=first_conn
         )
-        ClientValidations.wait_push_notification(
-            client, timeout=MIGRATE_TIMEOUT, connection=second_connection
-        )
 
         client.connection_pool.release(first_conn)
-        client.connection_pool.release(second_connection)
 
         migrate_thread.join()
 
@@ -608,6 +664,259 @@ def test_new_connection_handling_during_migrating_and_moving(
         self._validate_default_state(client, expected_matching_conns_count=3)
         bind_thread.join()
 
+    @pytest.mark.timeout(300)  # 5 minutes timeout
+    def test_old_connection_shutdown_during_moving(
+        self,
+        fault_injector_client: FaultInjectorClient,
+        endpoints_config: Dict[str, Any],
+    ):
+        # it is better to use ip for this test - enables validation that
+        # the connection is disconnected from the original address
+        # and connected to the new address
+        endpoint_type = EndpointType.EXTERNAL_IP
+        logging.info("Testing old connection shutdown during MOVING")
+        client = _get_client_maint_events(
+            endpoints_config=endpoints_config, endpoint_type=endpoint_type
+        )
+
+        logging.info("Starting migration ...")
+        migrate_thread = Thread(
+            target=self._execute_migration,
+            name="migrate_thread",
+            args=(
+                fault_injector_client,
+                endpoints_config,
+                self.target_node,
+                self.empty_node,
+            ),
+        )
+        migrate_thread.start()
+
+        logging.info("Waiting for MIGRATING push notifications...")
+        ClientValidations.wait_push_notification(client, timeout=MIGRATE_TIMEOUT)
+        self._validate_maintenance_state(client, expected_matching_conns_count=1)
+
+        logging.info("Waiting for MIGRATED push notification ...")
+        ClientValidations.wait_push_notification(client, timeout=MIGRATE_TIMEOUT)
+        self._validate_default_state(client, expected_matching_conns_count=1)
+        migrate_thread.join()
+
+        moving_event = threading.Event()
+
+        def execute_commands(moving_event: threading.Event, errors: Queue):
+            while not moving_event.is_set():
+                try:
+                    client.set("key", "value")
+                    client.get("key")
+                except Exception as e:
+                    errors.put(
+                        f"Command failed in thread {threading.current_thread().name}: {e}"
+                    )
+
+        logging.info("Starting rebind...")
+        bind_thread = Thread(
+            target=self._execute_bind,
+            name="bind_thread",
+            args=(fault_injector_client, endpoints_config, self.endpoint_id),
+        )
+        bind_thread.start()
+
+        errors = Queue()
+        threads_count = 10
+        futures = []
+
+        logging.info(f"Starting {threads_count} command execution threads...")
+        # Start the worker pool and submit N identical worker tasks
+        with ThreadPoolExecutor(
+            max_workers=threads_count, thread_name_prefix="command_execution_thread"
+        ) as executor:
+            futures = [
+                executor.submit(execute_commands, moving_event, errors)
+                for _ in range(threads_count)
+            ]
+
+            logging.info("Waiting for MOVING push notification ...")
+            # this will consume the notification in one of the connections
+            # and will handle the states of the rest
+            ClientValidations.wait_push_notification(client, timeout=BIND_TIMEOUT)
+            # set the event to stop the command execution threads
+            moving_event.set()
+
+            # Wait for all workers to finish and propagate any exceptions
+            for f in futures:
+                f.result()
+
+        # validate that all connections are either disconnected
+        # or connected to the new address
+        connections = self._get_all_connections_in_pool(client)
+        for conn in connections:
+            if conn._sock is not None:
+                assert conn.get_resolved_ip() == conn.host
+                assert conn.maintenance_state == MaintenanceState.MOVING
+                assert conn._sock.gettimeout() == RELAX_TIMEOUT
+                assert conn.host != conn.orig_host_address
+                assert not conn.should_reconnect()
+            else:
+                assert conn.maintenance_state == MaintenanceState.MOVING
+                assert conn.socket_timeout == RELAX_TIMEOUT
+                assert conn.host != conn.orig_host_address
+                assert not conn.should_reconnect()
+
+        # validate no errors were raised in the command execution threads
+        assert errors.empty(), f"Errors occurred in threads: {errors.queue}"
+
+        logging.info("Waiting for moving ttl to expire")
+        time.sleep(DEFAULT_BIND_TTL)
+        bind_thread.join()
+
+    @pytest.mark.timeout(300)  # 5 minutes timeout
+    def test_new_connections_receive_moving(
+        self,
+        client_maint_events: Redis,
+        fault_injector_client: FaultInjectorClient,
+        endpoints_config: Dict[str, Any],
+    ):
+        logging.info("Creating one connection in the pool.")
+        first_conn = client_maint_events.connection_pool.get_connection()
+
+        logging.info("Executing rladmin migrate command...")
+        migrate_thread = Thread(
+            target=self._execute_migration,
+            name="migrate_thread",
+            args=(
+                fault_injector_client,
+                endpoints_config,
+                self.target_node,
+                self.empty_node,
+            ),
+        )
+        migrate_thread.start()
+
+        logging.info("Waiting for MIGRATING push notifications...")
+        # this will consume the notification in the provided connection
+        ClientValidations.wait_push_notification(
+            client_maint_events, timeout=MIGRATE_TIMEOUT, connection=first_conn
+        )
+
+        self._validate_maintenance_state(
+            client_maint_events, expected_matching_conns_count=1
+        )
+
+        logging.info("Waiting for MIGRATED push notifications on both connections ...")
+        ClientValidations.wait_push_notification(
+            client_maint_events, timeout=MIGRATE_TIMEOUT, connection=first_conn
+        )
+
+        migrate_thread.join()
+
+        logging.info("Executing rladmin bind endpoint command...")
+
+        bind_thread = Thread(
+            target=self._execute_bind,
+            name="bind_thread",
+            args=(fault_injector_client, endpoints_config, self.endpoint_id),
+        )
+        bind_thread.start()
+
+        logging.info("Waiting for MOVING push notifications on random connection ...")
+        ClientValidations.wait_push_notification(
+            client_maint_events, timeout=BIND_TIMEOUT, connection=first_conn
+        )
+
+        old_address = first_conn._sock.getpeername()[0]
+        logging.info(f"The node address before bind: {old_address}")
+        logging.info(
+            "Creating new client to connect to the same node - new connections to this node should receive the moving event..."
+        )
+
+        endpoint_type = EndpointType.EXTERNAL_IP
+        # create new client with new pool that should also receive the moving event
+        new_client = _get_client_maint_events(
+            endpoints_config=endpoints_config,
+            endpoint_type=endpoint_type,
+            host_config=old_address,
+        )
+
+        # the moving notification will be consumed as
+        # part of the client connection setup, so we don't need
+        # to wait for it explicitly with wait_push_notification
+        logging.info(
+            "Creating one connection in the new pool that should receive the moving event."
+        )
+        new_client_conn = new_client.connection_pool.get_connection()
+
+        logging.info("Validating connections states during MOVING ...")
+        self._validate_moving_state(
+            new_client,
+            endpoint_type,
+            expected_matching_connected_conns_count=1,
+            expected_matching_disconnected_conns_count=0,
+        )
+
+        logging.info("Waiting for moving thread to be completed ...")
+        bind_thread.join()
+
+        new_client.connection_pool.release(new_client_conn)
+        new_client.close()
+
+        client_maint_events.connection_pool.release(first_conn)
+
+    @pytest.mark.timeout(300)  # 5 minutes timeout
+    def test_new_connections_receive_migrating(
+        self,
+        client_maint_events: Redis,
+        fault_injector_client: FaultInjectorClient,
+        endpoints_config: Dict[str, Any],
+    ):
+        logging.info("Creating one connection in the pool.")
+        first_conn = client_maint_events.connection_pool.get_connection()
+
+        logging.info("Executing rladmin migrate command...")
+        migrate_thread = Thread(
+            target=self._execute_migration,
+            name="migrate_thread",
+            args=(
+                fault_injector_client,
+                endpoints_config,
+                self.target_node,
+                self.empty_node,
+            ),
+        )
+        migrate_thread.start()
+
+        logging.info("Waiting for MIGRATING push notifications...")
+        # this will consume the notification in the provided connection
+        ClientValidations.wait_push_notification(
+            client_maint_events, timeout=MIGRATE_TIMEOUT, connection=first_conn
+        )
+
+        self._validate_maintenance_state(
+            client_maint_events, expected_matching_conns_count=1
+        )
+
+        # validate that new connections will also receive the migrating event
+        # it should be received as part of the client connection setup flow
+        logging.info(
+            "Creating second connection that should receive the migrating event as well."
+        )
+        second_connection = client_maint_events.connection_pool.get_connection()
+        self._validate_maintenance_state(
+            client_maint_events, expected_matching_conns_count=2
+        )
+
+        logging.info("Waiting for MIGRATED push notifications on both connections ...")
+        ClientValidations.wait_push_notification(
+            client_maint_events, timeout=MIGRATE_TIMEOUT, connection=first_conn
+        )
+        ClientValidations.wait_push_notification(
+            client_maint_events, timeout=MIGRATE_TIMEOUT, connection=second_connection
+        )
+
+        migrate_thread.join()
+
+        client_maint_events.connection_pool.release(first_conn)
+        client_maint_events.connection_pool.release(second_connection)
+
     @pytest.mark.timeout(300)
     def test_disabled_handling_during_migrating_and_moving(
         self,
@@ -637,24 +946,24 @@ def test_disabled_handling_during_migrating_and_moving(
         migrate_thread.start()
 
         logging.info("Waiting for MIGRATING push notifications...")
-        # this will consume the notification in the provided connection
+        # this will consume the notification in the provided connection if it arrives
         ClientValidations.wait_push_notification(
-            client, timeout=5, connection=first_conn
+            client, timeout=5, fail_on_timeout=False, connection=first_conn
         )
 
         self._validate_default_notif_disabled_state(
             client, expected_matching_conns_count=1
         )
 
-        # validate that new connections will also receive the moving event
+        # validate that new connections will not receive the migrating event
         logging.info(
             "Creating second connection in the pool"
-            " and expect it to receive the migrating as well."
+            " and expect it not to receive the migrating as well."
         )
 
         second_connection = client.connection_pool.get_connection()
         ClientValidations.wait_push_notification(
-            client, timeout=5, connection=second_connection
+            client, timeout=5, fail_on_timeout=False, connection=second_connection
         )
 
         logging.info(
@@ -666,10 +975,10 @@ def test_disabled_handling_during_migrating_and_moving(
 
         logging.info("Waiting for MIGRATED push notifications on both connections ...")
         ClientValidations.wait_push_notification(
-            client, timeout=5, connection=first_conn
+            client, timeout=5, fail_on_timeout=False, connection=first_conn
         )
         ClientValidations.wait_push_notification(
-            client, timeout=5, connection=second_connection
+            client, timeout=5, fail_on_timeout=False, connection=second_connection
         )
 
         client.connection_pool.release(first_conn)
@@ -687,12 +996,16 @@ def test_disabled_handling_during_migrating_and_moving(
         bind_thread.start()
 
         logging.info("Waiting for MOVING push notifications on random connection ...")
-        # this will consume the notification in one of the connections
+        # this will consume the notification if it arrives in one of the connections
         # and will handle the states of the rest
         # the consumed connection will be disconnected during
         # releasing it back to the pool and as a result we will have
         # 3 disconnected connections in the pool
-        ClientValidations.wait_push_notification(client, timeout=10)
+        ClientValidations.wait_push_notification(
+            client,
+            timeout=10,
+            fail_on_timeout=False,
+        )
 
         # validate that new connections will also receive the moving event
         connections = []
@@ -707,7 +1020,7 @@ def test_disabled_handling_during_migrating_and_moving(
         )
 
         logging.info("Waiting for moving ttl to expire")
-        time.sleep(30)
+        time.sleep(DEFAULT_BIND_TTL)
 
         logging.info("Validating connection states after MOVING has expired ...")
         self._validate_default_notif_disabled_state(

From a0e4d3f34876c0016ccf22b045a2a192b81fe249 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Wed, 24 Sep 2025 16:17:13 +0300
Subject: [PATCH 1118/1164] Rename maintenance events to maintenance
 notifications. (#3777)

* Rename relax_timeout to relaxed_timeout

* Rename to MaintNotificationsConnectionHandler, MaintNotificationsPoolHandler and MaintNotificationsConfig

* Completing renames - all tests are included as well as the rest of the class and object/field/args names

* Fixing errors after rebase.

* Fixing linters error related to too long arg name in abstract method
---
 redis/_parsers/base.py                      |  56 +-
 redis/client.py                             |  28 +-
 redis/connection.py                         | 302 ++++-----
 redis/maintenance_events.py                 | 283 +++++----
 tests/test_maintenance_events.py            | 672 ++++++++++----------
 tests/test_maintenance_events_handling.py   | 592 ++++++++---------
 tests/test_scenario/conftest.py             |  38 +-
 tests/test_scenario/test_hitless_upgrade.py | 136 ++--
 8 files changed, 1091 insertions(+), 1016 deletions(-)

diff --git a/redis/_parsers/base.py b/redis/_parsers/base.py
index be7b5cf1d0..928ec0c201 100644
--- a/redis/_parsers/base.py
+++ b/redis/_parsers/base.py
@@ -5,12 +5,12 @@
 from typing import Awaitable, Callable, List, Optional, Protocol, Union
 
 from redis.maintenance_events import (
-    MaintenanceEvent,
-    NodeFailedOverEvent,
-    NodeFailingOverEvent,
-    NodeMigratedEvent,
-    NodeMigratingEvent,
-    NodeMovingEvent,
+    MaintenanceNotification,
+    NodeFailedOverNotification,
+    NodeFailingOverNotification,
+    NodeMigratedNotification,
+    NodeMigratingNotification,
+    NodeMovingNotification,
 )
 
 if sys.version_info.major >= 3 and sys.version_info.minor >= 11:
@@ -175,14 +175,14 @@ class MaintenanceNotificationsParser:
 
     @staticmethod
     def parse_maintenance_start_msg(response, notification_type):
-        # Expected message format is: <event_type> <seq_number> <time>
+        # Expected message format is: <notification_type> <seq_number> <time>
         id = response[1]
         ttl = response[2]
         return notification_type(id, ttl)
 
     @staticmethod
     def parse_maintenance_completed_msg(response, notification_type):
-        # Expected message format is: <event_type> <seq_number>
+        # Expected message format is: <notification_type> <seq_number>
         id = response[1]
         return notification_type(id)
 
@@ -200,7 +200,7 @@ def parse_moving_msg(response):
             host, port = value.split(":")
             port = int(port) if port is not None else None
 
-        return NodeMovingEvent(id, host, port, ttl)
+        return NodeMovingNotification(id, host, port, ttl)
 
 
 _INVALIDATION_MESSAGE = "invalidate"
@@ -217,25 +217,27 @@ def parse_moving_msg(response):
     _FAILED_OVER_MESSAGE,
 )
 
-MSG_TYPE_TO_EVENT_PARSER_MAPPING: dict[str, tuple[type[MaintenanceEvent], Callable]] = {
+MSG_TYPE_TO_MAINT_NOTIFICATION_PARSER_MAPPING: dict[
+    str, tuple[type[MaintenanceNotification], Callable]
+] = {
     _MIGRATING_MESSAGE: (
-        NodeMigratingEvent,
+        NodeMigratingNotification,
         MaintenanceNotificationsParser.parse_maintenance_start_msg,
     ),
     _MIGRATED_MESSAGE: (
-        NodeMigratedEvent,
+        NodeMigratedNotification,
         MaintenanceNotificationsParser.parse_maintenance_completed_msg,
     ),
     _FAILING_OVER_MESSAGE: (
-        NodeFailingOverEvent,
+        NodeFailingOverNotification,
         MaintenanceNotificationsParser.parse_maintenance_start_msg,
     ),
     _FAILED_OVER_MESSAGE: (
-        NodeFailedOverEvent,
+        NodeFailedOverNotification,
         MaintenanceNotificationsParser.parse_maintenance_completed_msg,
     ),
     _MOVING_MESSAGE: (
-        NodeMovingEvent,
+        NodeMovingNotification,
         MaintenanceNotificationsParser.parse_moving_msg,
     ),
 }
@@ -273,14 +275,20 @@ def handle_push_response(self, response, **kwargs):
                 return self.invalidation_push_handler_func(response)
 
             if msg_type == _MOVING_MESSAGE and self.node_moving_push_handler_func:
-                parser_function = MSG_TYPE_TO_EVENT_PARSER_MAPPING[msg_type][1]
+                parser_function = MSG_TYPE_TO_MAINT_NOTIFICATION_PARSER_MAPPING[
+                    msg_type
+                ][1]
 
                 notification = parser_function(response)
                 return self.node_moving_push_handler_func(notification)
 
             if msg_type in _MAINTENANCE_MESSAGES and self.maintenance_push_handler_func:
-                parser_function = MSG_TYPE_TO_EVENT_PARSER_MAPPING[msg_type][1]
-                notification_type = MSG_TYPE_TO_EVENT_PARSER_MAPPING[msg_type][0]
+                parser_function = MSG_TYPE_TO_MAINT_NOTIFICATION_PARSER_MAPPING[
+                    msg_type
+                ][1]
+                notification_type = MSG_TYPE_TO_MAINT_NOTIFICATION_PARSER_MAPPING[
+                    msg_type
+                ][0]
                 notification = parser_function(response, notification_type)
 
                 if notification is not None:
@@ -342,13 +350,19 @@ async def handle_push_response(self, response, **kwargs):
                 msg_type = msg_type.decode()
 
             if msg_type == _MOVING_MESSAGE and self.node_moving_push_handler_func:
-                parser_function = MSG_TYPE_TO_EVENT_PARSER_MAPPING[msg_type][1]
+                parser_function = MSG_TYPE_TO_MAINT_NOTIFICATION_PARSER_MAPPING[
+                    msg_type
+                ][1]
                 notification = parser_function(response)
                 return await self.node_moving_push_handler_func(notification)
 
             if msg_type in _MAINTENANCE_MESSAGES and self.maintenance_push_handler_func:
-                parser_function = MSG_TYPE_TO_EVENT_PARSER_MAPPING[msg_type][1]
-                notification_type = MSG_TYPE_TO_EVENT_PARSER_MAPPING[msg_type][0]
+                parser_function = MSG_TYPE_TO_MAINT_NOTIFICATION_PARSER_MAPPING[
+                    msg_type
+                ][1]
+                notification_type = MSG_TYPE_TO_MAINT_NOTIFICATION_PARSER_MAPPING[
+                    msg_type
+                ][0]
                 notification = parser_function(response, notification_type)
 
                 if notification is not None:
diff --git a/redis/client.py b/redis/client.py
index 26837b673b..ff92955917 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -57,8 +57,8 @@
 )
 from redis.lock import Lock
 from redis.maintenance_events import (
-    MaintenanceEventPoolHandler,
-    MaintenanceEventsConfig,
+    MaintNotificationsConfig,
+    MaintNotificationsPoolHandler,
 )
 from redis.retry import Retry
 from redis.utils import (
@@ -248,7 +248,7 @@ def __init__(
         cache: Optional[CacheInterface] = None,
         cache_config: Optional[CacheConfig] = None,
         event_dispatcher: Optional[EventDispatcher] = None,
-        maintenance_events_config: Optional[MaintenanceEventsConfig] = None,
+        maint_notifications_config: Optional[MaintNotificationsConfig] = None,
     ) -> None:
         """
         Initialize a new Redis client.
@@ -373,22 +373,22 @@ def __init__(
         ]:
             raise RedisError("Client caching is only supported with RESP version 3")
 
-        if maintenance_events_config and self.connection_pool.get_protocol() not in [
+        if maint_notifications_config and self.connection_pool.get_protocol() not in [
             3,
             "3",
         ]:
             raise RedisError(
                 "Push handlers on connection are only supported with RESP version 3"
             )
-        if maintenance_events_config and maintenance_events_config.enabled:
-            self.maintenance_events_pool_handler = MaintenanceEventPoolHandler(
-                self.connection_pool, maintenance_events_config
+        if maint_notifications_config and maint_notifications_config.enabled:
+            self.maint_notifications_pool_handler = MaintNotificationsPoolHandler(
+                self.connection_pool, maint_notifications_config
             )
-            self.connection_pool.set_maintenance_events_pool_handler(
-                self.maintenance_events_pool_handler
+            self.connection_pool.set_maint_notifications_pool_handler(
+                self.maint_notifications_pool_handler
             )
         else:
-            self.maintenance_events_pool_handler = None
+            self.maint_notifications_pool_handler = None
 
         self.single_connection_lock = threading.RLock()
         self.connection = None
@@ -587,15 +587,15 @@ def monitor(self):
         return Monitor(self.connection_pool)
 
     def client(self):
-        maintenance_events_config = (
+        maint_notifications_config = (
             None
-            if self.maintenance_events_pool_handler is None
-            else self.maintenance_events_pool_handler.config
+            if self.maint_notifications_pool_handler is None
+            else self.maint_notifications_pool_handler.config
         )
         return self.__class__(
             connection_pool=self.connection_pool,
             single_connection_client=True,
-            maintenance_events_config=maintenance_events_config,
+            maint_notifications_config=maint_notifications_config,
         )
 
     def __enter__(self):
diff --git a/redis/connection.py b/redis/connection.py
index 226d22539c..e31e946d66 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -48,10 +48,10 @@
     TimeoutError,
 )
 from .maintenance_events import (
-    MaintenanceEventConnectionHandler,
-    MaintenanceEventPoolHandler,
-    MaintenanceEventsConfig,
     MaintenanceState,
+    MaintNotificationsConfig,
+    MaintNotificationsConnectionHandler,
+    MaintNotificationsPoolHandler,
 )
 from .retry import Retry
 from .utils import (
@@ -177,7 +177,7 @@ def set_parser(self, parser_class):
         pass
 
     @abstractmethod
-    def set_maintenance_event_pool_handler(self, maintenance_event_pool_handler):
+    def set_maint_notifications_pool_handler(self, maint_notifications_pool_handler):
         pass
 
     @abstractmethod
@@ -289,7 +289,7 @@ def get_resolved_ip(self):
         pass
 
     @abstractmethod
-    def update_current_socket_timeout(self, relax_timeout: Optional[float] = None):
+    def update_current_socket_timeout(self, relaxed_timeout: Optional[float] = None):
         """
         Update the timeout for the current socket.
         """
@@ -299,7 +299,7 @@ def update_current_socket_timeout(self, relax_timeout: Optional[float] = None):
     def set_tmp_settings(
         self,
         tmp_host_address: Optional[str] = None,
-        tmp_relax_timeout: Optional[float] = None,
+        tmp_relaxed_timeout: Optional[float] = None,
     ):
         """
         Updates temporary host address and timeout settings for the connection.
@@ -310,7 +310,7 @@ def set_tmp_settings(
     def reset_tmp_settings(
         self,
         reset_host_address: bool = False,
-        reset_relax_timeout: bool = False,
+        reset_relaxed_timeout: bool = False,
     ):
         """
         Resets temporary host address and timeout settings for the connection.
@@ -345,10 +345,12 @@ def __init__(
         protocol: Optional[int] = 2,
         command_packer: Optional[Callable[[], None]] = None,
         event_dispatcher: Optional[EventDispatcher] = None,
-        maintenance_events_pool_handler: Optional[MaintenanceEventPoolHandler] = None,
-        maintenance_events_config: Optional[MaintenanceEventsConfig] = None,
+        maint_notifications_pool_handler: Optional[
+            MaintNotificationsPoolHandler
+        ] = None,
+        maint_notifications_config: Optional[MaintNotificationsConfig] = None,
         maintenance_state: "MaintenanceState" = MaintenanceState.NONE,
-        maintenance_event_hash: Optional[int] = None,
+        maintenance_notification_hash: Optional[int] = None,
         orig_host_address: Optional[str] = None,
         orig_socket_timeout: Optional[float] = None,
         orig_socket_connect_timeout: Optional[float] = None,
@@ -428,11 +430,11 @@ def __init__(
             parser_class = _RESP3Parser
         self.set_parser(parser_class)
 
-        self.maintenance_events_config = maintenance_events_config
+        self.maint_notifications_config = maint_notifications_config
 
-        # Set up maintenance events if enabled
-        self._configure_maintenance_events(
-            maintenance_events_pool_handler,
+        # Set up maintenance notifications if enabled
+        self._configure_maintenance_notifications(
+            maint_notifications_pool_handler,
             orig_host_address,
             orig_socket_timeout,
             orig_socket_connect_timeout,
@@ -440,7 +442,7 @@ def __init__(
 
         self._should_reconnect = False
         self.maintenance_state = maintenance_state
-        self.maintenance_event_hash = maintenance_event_hash
+        self.maintenance_notification_hash = maintenance_notification_hash
 
         self._command_packer = self._construct_command_packer(command_packer)
 
@@ -497,33 +499,33 @@ def set_parser(self, parser_class):
         """
         self._parser = parser_class(socket_read_size=self._socket_read_size)
 
-    def _configure_maintenance_events(
+    def _configure_maintenance_notifications(
         self,
-        maintenance_events_pool_handler=None,
+        maint_notifications_pool_handler=None,
         orig_host_address=None,
         orig_socket_timeout=None,
         orig_socket_connect_timeout=None,
     ):
-        """Enable maintenance events by setting up handlers and storing original connection parameters."""
+        """Enable maintenance notifications by setting up handlers and storing original connection parameters."""
         if (
-            not self.maintenance_events_config
-            or not self.maintenance_events_config.enabled
+            not self.maint_notifications_config
+            or not self.maint_notifications_config.enabled
         ):
-            self._maintenance_event_connection_handler = None
+            self._maint_notifications_connection_handler = None
             return
 
         # Set up pool handler if available
-        if maintenance_events_pool_handler:
+        if maint_notifications_pool_handler:
             self._parser.set_node_moving_push_handler(
-                maintenance_events_pool_handler.handle_event
+                maint_notifications_pool_handler.handle_notification
             )
 
         # Set up connection handler
-        self._maintenance_event_connection_handler = MaintenanceEventConnectionHandler(
-            self, self.maintenance_events_config
+        self._maint_notifications_connection_handler = (
+            MaintNotificationsConnectionHandler(self, self.maint_notifications_config)
         )
         self._parser.set_maintenance_push_handler(
-            self._maintenance_event_connection_handler.handle_event
+            self._maint_notifications_connection_handler.handle_notification
         )
 
         # Store original connection parameters
@@ -537,27 +539,27 @@ def _configure_maintenance_events(
             else self.socket_connect_timeout
         )
 
-    def set_maintenance_event_pool_handler(
-        self, maintenance_event_pool_handler: MaintenanceEventPoolHandler
+    def set_maint_notifications_pool_handler(
+        self, maint_notifications_pool_handler: MaintNotificationsPoolHandler
     ):
-        maintenance_event_pool_handler.set_connection(self)
+        maint_notifications_pool_handler.set_connection(self)
         self._parser.set_node_moving_push_handler(
-            maintenance_event_pool_handler.handle_event
+            maint_notifications_pool_handler.handle_notification
         )
 
-        # Update maintenance event connection handler if it doesn't exist
-        if not self._maintenance_event_connection_handler:
-            self._maintenance_event_connection_handler = (
-                MaintenanceEventConnectionHandler(
-                    self, maintenance_event_pool_handler.config
+        # Update maintenance notification connection handler if it doesn't exist
+        if not self._maint_notifications_connection_handler:
+            self._maint_notifications_connection_handler = (
+                MaintNotificationsConnectionHandler(
+                    self, maint_notifications_pool_handler.config
                 )
             )
             self._parser.set_maintenance_push_handler(
-                self._maintenance_event_connection_handler.handle_event
+                self._maint_notifications_connection_handler.handle_notification
             )
         else:
-            self._maintenance_event_connection_handler.config = (
-                maintenance_event_pool_handler.config
+            self._maint_notifications_connection_handler.config = (
+                maint_notifications_pool_handler.config
             )
 
     def connect(self):
@@ -684,17 +686,17 @@ def on_connect_check_health(self, check_health: bool = True):
             ):
                 raise ConnectionError("Invalid RESP version")
 
-        # Send maintenance notifications handshake if RESP3 is active and maintenance events are enabled
+        # Send maintenance notifications handshake if RESP3 is active and maintenance notifications are enabled
         # and we have a host to determine the endpoint type from
         if (
             self.protocol not in [2, "2"]
-            and self.maintenance_events_config
-            and self.maintenance_events_config.enabled
-            and self._maintenance_event_connection_handler
+            and self.maint_notifications_config
+            and self.maint_notifications_config.enabled
+            and self._maint_notifications_connection_handler
             and hasattr(self, "host")
         ):
             try:
-                endpoint_type = self.maintenance_events_config.get_endpoint_type(
+                endpoint_type = self.maint_notifications_config.get_endpoint_type(
                     self.host, self
                 )
                 self.send_command(
@@ -1022,9 +1024,9 @@ def mark_for_reconnect(self):
     def should_reconnect(self):
         return self._should_reconnect
 
-    def update_current_socket_timeout(self, relax_timeout: Optional[float] = None):
+    def update_current_socket_timeout(self, relaxed_timeout: Optional[float] = None):
         if self._sock:
-            timeout = relax_timeout if relax_timeout != -1 else self.socket_timeout
+            timeout = relaxed_timeout if relaxed_timeout != -1 else self.socket_timeout
             self._sock.settimeout(timeout)
             self.update_parser_buffer_timeout(timeout)
 
@@ -1035,25 +1037,25 @@ def update_parser_buffer_timeout(self, timeout: Optional[float] = None):
     def set_tmp_settings(
         self,
         tmp_host_address: Optional[Union[str, object]] = SENTINEL,
-        tmp_relax_timeout: Optional[float] = None,
+        tmp_relaxed_timeout: Optional[float] = None,
     ):
         """
         The value of SENTINEL is used to indicate that the property should not be updated.
         """
         if tmp_host_address is not SENTINEL:
             self.host = tmp_host_address
-        if tmp_relax_timeout != -1:
-            self.socket_timeout = tmp_relax_timeout
-            self.socket_connect_timeout = tmp_relax_timeout
+        if tmp_relaxed_timeout != -1:
+            self.socket_timeout = tmp_relaxed_timeout
+            self.socket_connect_timeout = tmp_relaxed_timeout
 
     def reset_tmp_settings(
         self,
         reset_host_address: bool = False,
-        reset_relax_timeout: bool = False,
+        reset_relaxed_timeout: bool = False,
     ):
         if reset_host_address:
             self.host = self.orig_host_address
-        if reset_relax_timeout:
+        if reset_relaxed_timeout:
             self.socket_timeout = self.orig_socket_timeout
             self.socket_connect_timeout = self.orig_socket_connect_timeout
 
@@ -1742,20 +1744,20 @@ def __init__(
         connection_kwargs.pop("cache_config", None)
 
         if self.connection_kwargs.get(
-            "maintenance_events_pool_handler"
-        ) or self.connection_kwargs.get("maintenance_events_config"):
+            "maint_notifications_pool_handler"
+        ) or self.connection_kwargs.get("maint_notifications_config"):
             if self.connection_kwargs.get("protocol") not in [3, "3"]:
                 raise RedisError(
                     "Push handlers on connection are only supported with RESP version 3"
                 )
-            config = self.connection_kwargs.get("maintenance_events_config", None) or (
-                self.connection_kwargs.get("maintenance_events_pool_handler").config
-                if self.connection_kwargs.get("maintenance_events_pool_handler")
+            config = self.connection_kwargs.get("maint_notifications_config", None) or (
+                self.connection_kwargs.get("maint_notifications_pool_handler").config
+                if self.connection_kwargs.get("maint_notifications_pool_handler")
                 else None
             )
 
             if config and config.enabled:
-                self._update_connection_kwargs_for_maintenance_events()
+                self._update_connection_kwargs_for_maint_notifications()
 
         self._event_dispatcher = self.connection_kwargs.get("event_dispatcher", None)
         if self._event_dispatcher is None:
@@ -1791,46 +1793,54 @@ def get_protocol(self):
         """
         return self.connection_kwargs.get("protocol", None)
 
-    def maintenance_events_pool_handler_enabled(self):
+    def maint_notifications_pool_handler_enabled(self):
         """
         Returns:
-            True if the maintenance events pool handler is enabled, False otherwise.
+            True if the maintenance notifications pool handler is enabled, False otherwise.
         """
-        maintenance_events_config = self.connection_kwargs.get(
-            "maintenance_events_config", None
+        maint_notifications_config = self.connection_kwargs.get(
+            "maint_notifications_config", None
         )
 
-        return maintenance_events_config and maintenance_events_config.enabled
+        return maint_notifications_config and maint_notifications_config.enabled
 
-    def set_maintenance_events_pool_handler(
-        self, maintenance_events_pool_handler: MaintenanceEventPoolHandler
+    def set_maint_notifications_pool_handler(
+        self, maint_notifications_pool_handler: MaintNotificationsPoolHandler
     ):
         self.connection_kwargs.update(
             {
-                "maintenance_events_pool_handler": maintenance_events_pool_handler,
-                "maintenance_events_config": maintenance_events_pool_handler.config,
+                "maint_notifications_pool_handler": maint_notifications_pool_handler,
+                "maint_notifications_config": maint_notifications_pool_handler.config,
             }
         )
-        self._update_connection_kwargs_for_maintenance_events()
+        self._update_connection_kwargs_for_maint_notifications()
 
-        self._update_maintenance_events_configs_for_connections(
-            maintenance_events_pool_handler
+        self._update_maint_notifications_configs_for_connections(
+            maint_notifications_pool_handler
         )
 
-    def _update_maintenance_events_configs_for_connections(
-        self, maintenance_events_pool_handler
+    def _update_maint_notifications_configs_for_connections(
+        self, maint_notifications_pool_handler
     ):
-        """Update the maintenance events config for all connections in the pool."""
+        """Update the maintenance notifications config for all connections in the pool."""
         with self._lock:
             for conn in self._available_connections:
-                conn.set_maintenance_event_pool_handler(maintenance_events_pool_handler)
-                conn.maintenance_events_config = maintenance_events_pool_handler.config
+                conn.set_maint_notifications_pool_handler(
+                    maint_notifications_pool_handler
+                )
+                conn.maint_notifications_config = (
+                    maint_notifications_pool_handler.config
+                )
             for conn in self._in_use_connections:
-                conn.set_maintenance_event_pool_handler(maintenance_events_pool_handler)
-                conn.maintenance_events_config = maintenance_events_pool_handler.config
+                conn.set_maint_notifications_pool_handler(
+                    maint_notifications_pool_handler
+                )
+                conn.maint_notifications_config = (
+                    maint_notifications_pool_handler.config
+                )
 
-    def _update_connection_kwargs_for_maintenance_events(self):
-        """Store original connection parameters for maintenance events."""
+    def _update_connection_kwargs_for_maint_notifications(self):
+        """Store original connection parameters for maintenance notifications."""
         if self.connection_kwargs.get("orig_host_address", None) is None:
             # If orig_host_address is None it means we haven't
             # configured the original values yet
@@ -1936,7 +1946,7 @@ def get_connection(self, command_name=None, *keys, **options) -> "Connection":
                 if (
                     connection.can_read()
                     and self.cache is None
-                    and not self.maintenance_events_pool_handler_enabled()
+                    and not self.maint_notifications_pool_handler_enabled()
                 ):
                     raise ConnectionError("Connection has data")
             except (ConnectionError, TimeoutError, OSError):
@@ -2053,13 +2063,13 @@ def _should_update_connection(
         self,
         conn: "Connection",
         matching_pattern: Literal[
-            "connected_address", "configured_address", "event_hash"
+            "connected_address", "configured_address", "notification_hash"
         ] = "connected_address",
         matching_address: Optional[str] = None,
-        matching_event_hash: Optional[int] = None,
+        matching_notification_hash: Optional[int] = None,
     ) -> bool:
         """
-        Check if the connection should be updated based on the matching address.
+        Check if the connection should be updated based on the matching criteria.
         """
         if matching_pattern == "connected_address":
             if matching_address and conn.getpeername() != matching_address:
@@ -2067,10 +2077,10 @@ def _should_update_connection(
         elif matching_pattern == "configured_address":
             if matching_address and conn.host != matching_address:
                 return False
-        elif matching_pattern == "event_hash":
+        elif matching_pattern == "notification_hash":
             if (
-                matching_event_hash
-                and conn.maintenance_event_hash != matching_event_hash
+                matching_notification_hash
+                and conn.maintenance_notification_hash != matching_notification_hash
             ):
                 return False
         return True
@@ -2079,12 +2089,12 @@ def update_connection_settings(
         self,
         conn: "Connection",
         state: Optional["MaintenanceState"] = None,
-        maintenance_event_hash: Optional[int] = None,
+        maintenance_notification_hash: Optional[int] = None,
         host_address: Optional[str] = None,
-        relax_timeout: Optional[float] = None,
-        update_event_hash: bool = False,
+        relaxed_timeout: Optional[float] = None,
+        update_notification_hash: bool = False,
         reset_host_address: bool = False,
-        reset_relax_timeout: bool = False,
+        reset_relaxed_timeout: bool = False,
     ):
         """
         Update the settings for a single connection.
@@ -2092,38 +2102,38 @@ def update_connection_settings(
         if state:
             conn.maintenance_state = state
 
-        if update_event_hash:
-            # update the event hash only if requested
-            conn.maintenance_event_hash = maintenance_event_hash
+        if update_notification_hash:
+            # update the notification hash only if requested
+            conn.maintenance_notification_hash = maintenance_notification_hash
 
         if host_address is not None:
             conn.set_tmp_settings(tmp_host_address=host_address)
 
-        if relax_timeout is not None:
-            conn.set_tmp_settings(tmp_relax_timeout=relax_timeout)
+        if relaxed_timeout is not None:
+            conn.set_tmp_settings(tmp_relaxed_timeout=relaxed_timeout)
 
-        if reset_relax_timeout or reset_host_address:
+        if reset_relaxed_timeout or reset_host_address:
             conn.reset_tmp_settings(
                 reset_host_address=reset_host_address,
-                reset_relax_timeout=reset_relax_timeout,
+                reset_relaxed_timeout=reset_relaxed_timeout,
             )
 
-        conn.update_current_socket_timeout(relax_timeout)
+        conn.update_current_socket_timeout(relaxed_timeout)
 
     def update_connections_settings(
         self,
         state: Optional["MaintenanceState"] = None,
-        maintenance_event_hash: Optional[int] = None,
+        maintenance_notification_hash: Optional[int] = None,
         host_address: Optional[str] = None,
-        relax_timeout: Optional[float] = None,
+        relaxed_timeout: Optional[float] = None,
         matching_address: Optional[str] = None,
-        matching_event_hash: Optional[int] = None,
+        matching_notification_hash: Optional[int] = None,
         matching_pattern: Literal[
-            "connected_address", "configured_address", "event_hash"
+            "connected_address", "configured_address", "notification_hash"
         ] = "connected_address",
-        update_event_hash: bool = False,
+        update_notification_hash: bool = False,
         reset_host_address: bool = False,
-        reset_relax_timeout: bool = False,
+        reset_relaxed_timeout: bool = False,
         include_free_connections: bool = True,
     ):
         """
@@ -2133,16 +2143,16 @@ def update_connections_settings(
         This method does not affect the connection kwargs.
 
         :param state: The maintenance state to set for the connection.
-        :param maintenance_event_hash: The hash of the maintenance event
-                                        to set for the connection.
+        :param maintenance_notification_hash: The hash of the maintenance notification
+                                               to set for the connection.
         :param host_address: The host address to set for the connection.
-        :param relax_timeout: The relax timeout to set for the connection.
+        :param relaxed_timeout: The relaxed timeout to set for the connection.
         :param matching_address: The address to match for the connection.
-        :param matching_event_hash: The event hash to match for the connection.
+        :param matching_notification_hash: The notification hash to match for the connection.
         :param matching_pattern: The pattern to match for the connection.
-        :param update_event_hash: Whether to update the event hash for the connection.
+        :param update_notification_hash: Whether to update the notification hash for the connection.
         :param reset_host_address: Whether to reset the host address to the original address.
-        :param reset_relax_timeout: Whether to reset the relax timeout to the original timeout.
+        :param reset_relaxed_timeout: Whether to reset the relaxed timeout to the original timeout.
         :param include_free_connections: Whether to include free/available connections.
         """
         with self._lock:
@@ -2151,17 +2161,17 @@ def update_connections_settings(
                     conn,
                     matching_pattern,
                     matching_address,
-                    matching_event_hash,
+                    matching_notification_hash,
                 ):
                     self.update_connection_settings(
                         conn,
                         state=state,
-                        maintenance_event_hash=maintenance_event_hash,
+                        maintenance_notification_hash=maintenance_notification_hash,
                         host_address=host_address,
-                        relax_timeout=relax_timeout,
-                        update_event_hash=update_event_hash,
+                        relaxed_timeout=relaxed_timeout,
+                        update_notification_hash=update_notification_hash,
                         reset_host_address=reset_host_address,
-                        reset_relax_timeout=reset_relax_timeout,
+                        reset_relaxed_timeout=reset_relaxed_timeout,
                     )
 
             if include_free_connections:
@@ -2170,17 +2180,17 @@ def update_connections_settings(
                         conn,
                         matching_pattern,
                         matching_address,
-                        matching_event_hash,
+                        matching_notification_hash,
                     ):
                         self.update_connection_settings(
                             conn,
                             state=state,
-                            maintenance_event_hash=maintenance_event_hash,
+                            maintenance_notification_hash=maintenance_notification_hash,
                             host_address=host_address,
-                            relax_timeout=relax_timeout,
-                            update_event_hash=update_event_hash,
+                            relaxed_timeout=relaxed_timeout,
+                            update_notification_hash=update_notification_hash,
                             reset_host_address=reset_host_address,
-                            reset_relax_timeout=reset_relax_timeout,
+                            reset_relaxed_timeout=reset_relaxed_timeout,
                         )
 
     def update_connection_kwargs(
@@ -2472,17 +2482,17 @@ def disconnect(self):
     def update_connections_settings(
         self,
         state: Optional["MaintenanceState"] = None,
-        maintenance_event_hash: Optional[int] = None,
-        relax_timeout: Optional[float] = None,
+        maintenance_notification_hash: Optional[int] = None,
+        relaxed_timeout: Optional[float] = None,
         host_address: Optional[str] = None,
         matching_address: Optional[str] = None,
-        matching_event_hash: Optional[int] = None,
+        matching_notification_hash: Optional[int] = None,
         matching_pattern: Literal[
-            "connected_address", "configured_address", "event_hash"
+            "connected_address", "configured_address", "notification_hash"
         ] = "connected_address",
-        update_event_hash: bool = False,
+        update_notification_hash: bool = False,
         reset_host_address: bool = False,
-        reset_relax_timeout: bool = False,
+        reset_relaxed_timeout: bool = False,
         include_free_connections: bool = True,
     ):
         """
@@ -2495,17 +2505,17 @@ def update_connections_settings(
                         conn,
                         matching_pattern,
                         matching_address,
-                        matching_event_hash,
+                        matching_notification_hash,
                     ):
                         self.update_connection_settings(
                             conn,
                             state=state,
-                            maintenance_event_hash=maintenance_event_hash,
+                            maintenance_notification_hash=maintenance_notification_hash,
                             host_address=host_address,
-                            relax_timeout=relax_timeout,
-                            update_event_hash=update_event_hash,
+                            relaxed_timeout=relaxed_timeout,
+                            update_notification_hash=update_notification_hash,
                             reset_host_address=reset_host_address,
-                            reset_relax_timeout=reset_relax_timeout,
+                            reset_relaxed_timeout=reset_relaxed_timeout,
                         )
             else:
                 connections_in_queue = {conn for conn in self.pool.queue if conn}
@@ -2515,17 +2525,17 @@ def update_connections_settings(
                             conn,
                             matching_pattern,
                             matching_address,
-                            matching_event_hash,
+                            matching_notification_hash,
                         ):
                             self.update_connection_settings(
                                 conn,
                                 state=state,
-                                maintenance_event_hash=maintenance_event_hash,
+                                maintenance_notification_hash=maintenance_notification_hash,
                                 host_address=host_address,
-                                relax_timeout=relax_timeout,
-                                update_event_hash=update_event_hash,
+                                relaxed_timeout=relaxed_timeout,
+                                update_notification_hash=update_notification_hash,
                                 reset_host_address=reset_host_address,
-                                reset_relax_timeout=reset_relax_timeout,
+                                reset_relaxed_timeout=reset_relaxed_timeout,
                             )
 
     def update_active_connections_for_reconnect(
@@ -2569,26 +2579,30 @@ def disconnect_free_connections(
                     ):
                         conn.disconnect()
 
-    def _update_maintenance_events_config_for_connections(
-        self, maintenance_events_config
+    def _update_maint_notifications_config_for_connections(
+        self, maint_notifications_config
     ):
         for conn in tuple(self._connections):
-            conn.maintenance_events_config = maintenance_events_config
+            conn.maint_notifications_config = maint_notifications_config
 
-    def _update_maintenance_events_configs_for_connections(
-        self, maintenance_events_pool_handler
+    def _update_maint_notifications_configs_for_connections(
+        self, maint_notifications_pool_handler
     ):
-        """Update the maintenance events config for all connections in the pool."""
+        """Update the maintenance notifications config for all connections in the pool."""
         with self._lock:
             for conn in tuple(self._connections):
-                conn.set_maintenance_event_pool_handler(maintenance_events_pool_handler)
-                conn.maintenance_events_config = maintenance_events_pool_handler.config
+                conn.set_maint_notifications_pool_handler(
+                    maint_notifications_pool_handler
+                )
+                conn.maint_notifications_config = (
+                    maint_notifications_pool_handler.config
+                )
 
     def set_in_maintenance(self, in_maintenance: bool):
         """
         Sets a flag that this Blocking ConnectionPool is in maintenance mode.
 
         This is used to prevent new connections from being created while we are in maintenance mode.
-        The pool will be in maintenance mode only when we are processing a MOVING event.
+        The pool will be in maintenance mode only when we are processing a MOVING notification.
         """
         self._in_maintenance = in_maintenance
diff --git a/redis/maintenance_events.py b/redis/maintenance_events.py
index a3636019ed..eeb77299ef 100644
--- a/redis/maintenance_events.py
+++ b/redis/maintenance_events.py
@@ -38,25 +38,25 @@ def __str__(self):
     )
 
 
-class MaintenanceEvent(ABC):
+class MaintenanceNotification(ABC):
     """
-    Base class for maintenance events sent through push messages by Redis server.
+    Base class for maintenance notifications sent through push messages by Redis server.
 
-    This class provides common functionality for all maintenance events including
+    This class provides common functionality for all maintenance notifications including
     unique identification and TTL (Time-To-Live) functionality.
 
     Attributes:
-        id (int): Unique identifier for this event
+        id (int): Unique identifier for this notification
         ttl (int): Time-to-live in seconds for this notification
         creation_time (float): Timestamp when the notification was created/read
     """
 
     def __init__(self, id: int, ttl: int):
         """
-        Initialize a new MaintenanceEvent with unique ID and TTL functionality.
+        Initialize a new MaintenanceNotification with unique ID and TTL functionality.
 
         Args:
-            id (int): Unique identifier for this event
+            id (int): Unique identifier for this notification
             ttl (int): Time-to-live in seconds for this notification
         """
         self.id = id
@@ -66,60 +66,60 @@ def __init__(self, id: int, ttl: int):
 
     def is_expired(self) -> bool:
         """
-        Check if this event has expired based on its TTL
+        Check if this notification has expired based on its TTL
         and creation time.
 
         Returns:
-            bool: True if the event has expired, False otherwise
+            bool: True if the notification has expired, False otherwise
         """
         return time.monotonic() > (self.creation_time + self.ttl)
 
     @abstractmethod
     def __repr__(self) -> str:
         """
-        Return a string representation of the maintenance event.
+        Return a string representation of the maintenance notification.
 
         This method must be implemented by all concrete subclasses.
 
         Returns:
-            str: String representation of the event
+            str: String representation of the notification
         """
         pass
 
     @abstractmethod
     def __eq__(self, other) -> bool:
         """
-        Compare two maintenance events for equality.
+        Compare two maintenance notifications for equality.
 
         This method must be implemented by all concrete subclasses.
-        Events are typically considered equal if they have the same id
+        Notifications are typically considered equal if they have the same id
         and are of the same type.
 
         Args:
             other: The other object to compare with
 
         Returns:
-            bool: True if the events are equal, False otherwise
+            bool: True if the notifications are equal, False otherwise
         """
         pass
 
     @abstractmethod
     def __hash__(self) -> int:
         """
-        Return a hash value for the maintenance event.
+        Return a hash value for the maintenance notification.
 
         This method must be implemented by all concrete subclasses to allow
         instances to be used in sets and as dictionary keys.
 
         Returns:
-            int: Hash value for the event
+            int: Hash value for the notification
         """
         pass
 
 
-class NodeMovingEvent(MaintenanceEvent):
+class NodeMovingNotification(MaintenanceNotification):
     """
-    This event is received when a node is replaced with a new node
+    This notification is received when a node is replaced with a new node
     during cluster rebalancing or maintenance operations.
     """
 
@@ -131,10 +131,10 @@ def __init__(
         ttl: int,
     ):
         """
-        Initialize a new NodeMovingEvent.
+        Initialize a new NodeMovingNotification.
 
         Args:
-            id (int): Unique identifier for this event
+            id (int): Unique identifier for this notification
             new_node_host (str): Hostname or IP address of the new replacement node
             new_node_port (int): Port number of the new replacement node
             ttl (int): Time-to-live in seconds for this notification
@@ -162,10 +162,10 @@ def __repr__(self) -> str:
 
     def __eq__(self, other) -> bool:
         """
-        Two NodeMovingEvent events are considered equal if they have the same
+        Two NodeMovingNotification notifications are considered equal if they have the same
         id, new_node_host, and new_node_port.
         """
-        if not isinstance(other, NodeMovingEvent):
+        if not isinstance(other, NodeMovingNotification):
             return False
         return (
             self.id == other.id
@@ -175,11 +175,11 @@ def __eq__(self, other) -> bool:
 
     def __hash__(self) -> int:
         """
-        Return a hash value for the event to allow
+        Return a hash value for the notification to allow
         instances to be used in sets and as dictionary keys.
 
         Returns:
-            int: Hash value based on event type class name, id,
+            int: Hash value based on notification type class name, id,
             new_node_host and new_node_port
         """
         try:
@@ -197,15 +197,15 @@ def __hash__(self) -> int:
         )
 
 
-class NodeMigratingEvent(MaintenanceEvent):
+class NodeMigratingNotification(MaintenanceNotification):
     """
-    Event for when a Redis cluster node is in the process of migrating slots.
+    Notification for when a Redis cluster node is in the process of migrating slots.
 
-    This event is received when a node starts migrating its slots to another node
+    This notification is received when a node starts migrating its slots to another node
     during cluster rebalancing or maintenance operations.
 
     Args:
-        id (int): Unique identifier for this event
+        id (int): Unique identifier for this notification
         ttl (int): Time-to-live in seconds for this notification
     """
 
@@ -228,39 +228,39 @@ def __repr__(self) -> str:
 
     def __eq__(self, other) -> bool:
         """
-        Two NodeMigratingEvent events are considered equal if they have the same
+        Two NodeMigratingNotification notifications are considered equal if they have the same
         id and are of the same type.
         """
-        if not isinstance(other, NodeMigratingEvent):
+        if not isinstance(other, NodeMigratingNotification):
             return False
         return self.id == other.id and type(self) is type(other)
 
     def __hash__(self) -> int:
         """
-        Return a hash value for the event to allow
+        Return a hash value for the notification to allow
         instances to be used in sets and as dictionary keys.
 
         Returns:
-            int: Hash value based on event type and id
+            int: Hash value based on notification type and id
         """
         return hash((self.__class__.__name__, int(self.id)))
 
 
-class NodeMigratedEvent(MaintenanceEvent):
+class NodeMigratedNotification(MaintenanceNotification):
     """
-    Event for when a Redis cluster node has completed migrating slots.
+    Notification for when a Redis cluster node has completed migrating slots.
 
-    This event is received when a node has finished migrating all its slots
+    This notification is received when a node has finished migrating all its slots
     to other nodes during cluster rebalancing or maintenance operations.
 
     Args:
-        id (int): Unique identifier for this event
+        id (int): Unique identifier for this notification
     """
 
     DEFAULT_TTL = 5
 
     def __init__(self, id: int):
-        super().__init__(id, NodeMigratedEvent.DEFAULT_TTL)
+        super().__init__(id, NodeMigratedNotification.DEFAULT_TTL)
 
     def __repr__(self) -> str:
         expiry_time = self.creation_time + self.ttl
@@ -278,33 +278,33 @@ def __repr__(self) -> str:
 
     def __eq__(self, other) -> bool:
         """
-        Two NodeMigratedEvent events are considered equal if they have the same
+        Two NodeMigratedNotification notifications are considered equal if they have the same
         id and are of the same type.
         """
-        if not isinstance(other, NodeMigratedEvent):
+        if not isinstance(other, NodeMigratedNotification):
             return False
         return self.id == other.id and type(self) is type(other)
 
     def __hash__(self) -> int:
         """
-        Return a hash value for the event to allow
+        Return a hash value for the notification to allow
         instances to be used in sets and as dictionary keys.
 
         Returns:
-            int: Hash value based on event type and id
+            int: Hash value based on notification type and id
         """
         return hash((self.__class__.__name__, int(self.id)))
 
 
-class NodeFailingOverEvent(MaintenanceEvent):
+class NodeFailingOverNotification(MaintenanceNotification):
     """
-    Event for when a Redis cluster node is in the process of failing over.
+    Notification for when a Redis cluster node is in the process of failing over.
 
-    This event is received when a node starts a failover process during
+    This notification is received when a node starts a failover process during
     cluster maintenance operations or when handling node failures.
 
     Args:
-        id (int): Unique identifier for this event
+        id (int): Unique identifier for this notification
         ttl (int): Time-to-live in seconds for this notification
     """
 
@@ -327,39 +327,39 @@ def __repr__(self) -> str:
 
     def __eq__(self, other) -> bool:
         """
-        Two NodeFailingOverEvent events are considered equal if they have the same
+        Two NodeFailingOverNotification notifications are considered equal if they have the same
         id and are of the same type.
         """
-        if not isinstance(other, NodeFailingOverEvent):
+        if not isinstance(other, NodeFailingOverNotification):
             return False
         return self.id == other.id and type(self) is type(other)
 
     def __hash__(self) -> int:
         """
-        Return a hash value for the event to allow
+        Return a hash value for the notification to allow
         instances to be used in sets and as dictionary keys.
 
         Returns:
-            int: Hash value based on event type and id
+            int: Hash value based on notification type and id
         """
         return hash((self.__class__.__name__, int(self.id)))
 
 
-class NodeFailedOverEvent(MaintenanceEvent):
+class NodeFailedOverNotification(MaintenanceNotification):
     """
-    Event for when a Redis cluster node has completed a failover.
+    Notification for when a Redis cluster node has completed a failover.
 
-    This event is received when a node has finished the failover process
+    This notification is received when a node has finished the failover process
     during cluster maintenance operations or after handling node failures.
 
     Args:
-        id (int): Unique identifier for this event
+        id (int): Unique identifier for this notification
     """
 
     DEFAULT_TTL = 5
 
     def __init__(self, id: int):
-        super().__init__(id, NodeFailedOverEvent.DEFAULT_TTL)
+        super().__init__(id, NodeFailedOverNotification.DEFAULT_TTL)
 
     def __repr__(self) -> str:
         expiry_time = self.creation_time + self.ttl
@@ -377,20 +377,20 @@ def __repr__(self) -> str:
 
     def __eq__(self, other) -> bool:
         """
-        Two NodeFailedOverEvent events are considered equal if they have the same
+        Two NodeFailedOverNotification notifications are considered equal if they have the same
         id and are of the same type.
         """
-        if not isinstance(other, NodeFailedOverEvent):
+        if not isinstance(other, NodeFailedOverNotification):
             return False
         return self.id == other.id and type(self) is type(other)
 
     def __hash__(self) -> int:
         """
-        Return a hash value for the event to allow
+        Return a hash value for the notification to allow
         instances to be used in sets and as dictionary keys.
 
         Returns:
-            int: Hash value based on event type and id
+            int: Hash value based on notification type and id
         """
         return hash((self.__class__.__name__, int(self.id)))
 
@@ -435,9 +435,9 @@ def _is_private_fqdn(host: str) -> bool:
     return False
 
 
-class MaintenanceEventsConfig:
+class MaintNotificationsConfig:
     """
-    Configuration class for maintenance events handling behaviour. Events are received through
+    Configuration class for maintenance notifications handling behaviour. Notifications are received through
     push notifications.
 
     This class defines how the Redis client should react to different push notifications
@@ -449,19 +449,19 @@ def __init__(
         self,
         enabled: bool = True,
         proactive_reconnect: bool = True,
-        relax_timeout: Optional[Number] = 10,
+        relaxed_timeout: Optional[Number] = 10,
         endpoint_type: Optional[EndpointType] = None,
     ):
         """
-        Initialize a new MaintenanceEventsConfig.
+        Initialize a new MaintNotificationsConfig.
 
         Args:
-            enabled (bool): Whether to enable maintenance events handling.
+            enabled (bool): Whether to enable maintenance notifications handling.
                 Defaults to False.
             proactive_reconnect (bool): Whether to proactively reconnect when a node is replaced.
                 Defaults to True.
-            relax_timeout (Number): The relax timeout to use for the connection during maintenance.
-                If -1 is provided - the relax timeout is disabled. Defaults to 20.
+            relaxed_timeout (Number): The relaxed timeout to use for the connection during maintenance.
+                If -1 is provided - the relaxed timeout is disabled. Defaults to 20.
             endpoint_type (Optional[EndpointType]): Override for the endpoint type to use in CLIENT MAINT_NOTIFICATIONS.
                 If None, the endpoint type will be automatically determined based on the host and TLS configuration.
                 Defaults to None.
@@ -470,7 +470,7 @@ def __init__(
             ValueError: If endpoint_type is provided but is not a valid endpoint type.
         """
         self.enabled = enabled
-        self.relax_timeout = relax_timeout
+        self.relaxed_timeout = relaxed_timeout
         self.proactive_reconnect = proactive_reconnect
         self.endpoint_type = endpoint_type
 
@@ -479,21 +479,21 @@ def __repr__(self) -> str:
             f"{self.__class__.__name__}("
             f"enabled={self.enabled}, "
             f"proactive_reconnect={self.proactive_reconnect}, "
-            f"relax_timeout={self.relax_timeout}, "
+            f"relaxed_timeout={self.relaxed_timeout}, "
             f"endpoint_type={self.endpoint_type!r}"
             f")"
         )
 
-    def is_relax_timeouts_enabled(self) -> bool:
+    def is_relaxed_timeouts_enabled(self) -> bool:
         """
-        Check if the relax_timeout is enabled. The '-1' value is used to disable the relax_timeout.
-        If relax_timeout is set to None, it will make the operation blocking
+        Check if the relaxed_timeout is enabled. The '-1' value is used to disable the relaxed_timeout.
+        If relaxed_timeout is set to None, it will make the operation blocking
         and waiting until any response is received.
 
         Returns:
-            True if the relax_timeout is enabled, False otherwise.
+            True if the relaxed_timeout is enabled, False otherwise.
         """
-        return self.relax_timeout != -1
+        return self.relaxed_timeout != -1
 
     def get_endpoint_type(
         self, host: str, connection: "ConnectionInterface"
@@ -550,15 +550,15 @@ def get_endpoint_type(
         return EndpointType.INTERNAL_FQDN if is_private else EndpointType.EXTERNAL_FQDN
 
 
-class MaintenanceEventPoolHandler:
+class MaintNotificationsPoolHandler:
     def __init__(
         self,
         pool: Union["ConnectionPool", "BlockingConnectionPool"],
-        config: MaintenanceEventsConfig,
+        config: MaintNotificationsConfig,
     ) -> None:
         self.pool = pool
         self.config = config
-        self._processed_events = set()
+        self._processed_notifications = set()
         self._lock = threading.RLock()
         self.connection = None
 
@@ -567,35 +567,35 @@ def set_connection(self, connection: "ConnectionInterface"):
 
     def remove_expired_notifications(self):
         with self._lock:
-            for notification in tuple(self._processed_events):
+            for notification in tuple(self._processed_notifications):
                 if notification.is_expired():
-                    self._processed_events.remove(notification)
+                    self._processed_notifications.remove(notification)
 
-    def handle_event(self, notification: MaintenanceEvent):
+    def handle_notification(self, notification: MaintenanceNotification):
         self.remove_expired_notifications()
 
-        if isinstance(notification, NodeMovingEvent):
-            return self.handle_node_moving_event(notification)
+        if isinstance(notification, NodeMovingNotification):
+            return self.handle_node_moving_notification(notification)
         else:
             logging.error(f"Unhandled notification type: {notification}")
 
-    def handle_node_moving_event(self, event: NodeMovingEvent):
+    def handle_node_moving_notification(self, notification: NodeMovingNotification):
         if (
             not self.config.proactive_reconnect
-            and not self.config.is_relax_timeouts_enabled()
+            and not self.config.is_relaxed_timeouts_enabled()
         ):
             return
         with self._lock:
-            if event in self._processed_events:
+            if notification in self._processed_notifications:
                 # nothing to do in the connection pool handling
-                # the event has already been handled or is expired
+                # the notification has already been handled or is expired
                 # just return
                 return
 
             with self.pool._lock:
                 if (
                     self.config.proactive_reconnect
-                    or self.config.is_relax_timeouts_enabled()
+                    or self.config.is_relaxed_timeouts_enabled()
                 ):
                     # Get the current connected address - if any
                     # This is the address that is being moved
@@ -614,21 +614,21 @@ def handle_node_moving_event(self, event: NodeMovingEvent):
                     # connection settings for matching connections
                     self.pool.update_connections_settings(
                         state=MaintenanceState.MOVING,
-                        maintenance_event_hash=hash(event),
-                        relax_timeout=self.config.relax_timeout,
-                        host_address=event.new_node_host,
+                        maintenance_notification_hash=hash(notification),
+                        relaxed_timeout=self.config.relaxed_timeout,
+                        host_address=notification.new_node_host,
                         matching_address=moving_address_src,
                         matching_pattern="connected_address",
-                        update_event_hash=True,
+                        update_notification_hash=True,
                         include_free_connections=True,
                     )
 
                     if self.config.proactive_reconnect:
-                        if event.new_node_host is not None:
+                        if notification.new_node_host is not None:
                             self.run_proactive_reconnect(moving_address_src)
                         else:
                             threading.Timer(
-                                event.ttl / 2,
+                                notification.ttl / 2,
                                 self.run_proactive_reconnect,
                                 args=(moving_address_src,),
                             ).start()
@@ -639,22 +639,22 @@ def handle_node_moving_event(self, event: NodeMovingEvent):
                     # if relax timeouts are enabled - update timeouts
                     kwargs: dict = {
                         "maintenance_state": MaintenanceState.MOVING,
-                        "maintenance_event_hash": hash(event),
+                        "maintenance_notification_hash": hash(notification),
                     }
-                    if event.new_node_host is not None:
+                    if notification.new_node_host is not None:
                         # the host is not updated if the new node host is None
                         # this happens when the MOVING push notification does not contain
                         # the new node host - in this case we only update the timeouts
                         kwargs.update(
                             {
-                                "host": event.new_node_host,
+                                "host": notification.new_node_host,
                             }
                         )
-                    if self.config.is_relax_timeouts_enabled():
+                    if self.config.is_relaxed_timeouts_enabled():
                         kwargs.update(
                             {
-                                "socket_timeout": self.config.relax_timeout,
-                                "socket_connect_timeout": self.config.relax_timeout,
+                                "socket_timeout": self.config.relaxed_timeout,
+                                "socket_connect_timeout": self.config.relaxed_timeout,
                             }
                         )
                     self.pool.update_connection_kwargs(**kwargs)
@@ -663,10 +663,12 @@ def handle_node_moving_event(self, event: NodeMovingEvent):
                         self.pool.set_in_maintenance(False)
 
             threading.Timer(
-                event.ttl, self.handle_node_moved_event, args=(event,)
+                notification.ttl,
+                self.handle_node_moved_notification,
+                args=(notification,),
             ).start()
 
-            self._processed_events.add(event)
+            self._processed_notifications.add(notification)
 
     def run_proactive_reconnect(self, moving_address_src: Optional[str] = None):
         """
@@ -687,17 +689,20 @@ def run_proactive_reconnect(self, moving_address_src: Optional[str] = None):
                     moving_address_src=moving_address_src,
                 )
 
-    def handle_node_moved_event(self, event: NodeMovingEvent):
+    def handle_node_moved_notification(self, notification: NodeMovingNotification):
         """
-        Handle the cleanup after a node moving event expires.
+        Handle the cleanup after a node moving notification expires.
         """
-        event_hash = hash(event)
+        notification_hash = hash(notification)
 
         with self._lock:
-            # if the current maintenance_event_hash in kwargs is not matching the event
-            # it means there has been a new moving event after this one
+            # if the current maintenance_notification_hash in kwargs is not matching the notification
+            # it means there has been a new moving notification after this one
             # and we don't need to revert the kwargs yet
-            if self.pool.connection_kwargs.get("maintenance_event_hash") == event_hash:
+            if (
+                self.pool.connection_kwargs.get("maintenance_notification_hash")
+                == notification_hash
+            ):
                 orig_host = self.pool.connection_kwargs.get("orig_host_address")
                 orig_socket_timeout = self.pool.connection_kwargs.get(
                     "orig_socket_timeout"
@@ -707,7 +712,7 @@ def handle_node_moved_event(self, event: NodeMovingEvent):
                 )
                 kwargs: dict = {
                     "maintenance_state": MaintenanceState.NONE,
-                    "maintenance_event_hash": None,
+                    "maintenance_notification_hash": None,
                     "host": orig_host,
                     "socket_timeout": orig_socket_timeout,
                     "socket_connect_timeout": orig_connect_timeout,
@@ -715,71 +720,75 @@ def handle_node_moved_event(self, event: NodeMovingEvent):
                 self.pool.update_connection_kwargs(**kwargs)
 
             with self.pool._lock:
-                reset_relax_timeout = self.config.is_relax_timeouts_enabled()
+                reset_relaxed_timeout = self.config.is_relaxed_timeouts_enabled()
                 reset_host_address = self.config.proactive_reconnect
 
                 self.pool.update_connections_settings(
-                    relax_timeout=-1,
+                    relaxed_timeout=-1,
                     state=MaintenanceState.NONE,
-                    maintenance_event_hash=None,
-                    matching_event_hash=event_hash,
-                    matching_pattern="event_hash",
-                    update_event_hash=True,
-                    reset_relax_timeout=reset_relax_timeout,
+                    maintenance_notification_hash=None,
+                    matching_notification_hash=notification_hash,
+                    matching_pattern="notification_hash",
+                    update_notification_hash=True,
+                    reset_relaxed_timeout=reset_relaxed_timeout,
                     reset_host_address=reset_host_address,
                     include_free_connections=True,
                 )
 
 
-class MaintenanceEventConnectionHandler:
-    # 1 = "starting maintenance" events, 0 = "completed maintenance" events
-    _EVENT_TYPES: dict[type["MaintenanceEvent"], int] = {
-        NodeMigratingEvent: 1,
-        NodeFailingOverEvent: 1,
-        NodeMigratedEvent: 0,
-        NodeFailedOverEvent: 0,
+class MaintNotificationsConnectionHandler:
+    # 1 = "starting maintenance" notifications, 0 = "completed maintenance" notifications
+    _NOTIFICATION_TYPES: dict[type["MaintenanceNotification"], int] = {
+        NodeMigratingNotification: 1,
+        NodeFailingOverNotification: 1,
+        NodeMigratedNotification: 0,
+        NodeFailedOverNotification: 0,
     }
 
     def __init__(
-        self, connection: "ConnectionInterface", config: MaintenanceEventsConfig
+        self, connection: "ConnectionInterface", config: MaintNotificationsConfig
     ) -> None:
         self.connection = connection
         self.config = config
 
-    def handle_event(self, event: MaintenanceEvent):
-        # get the event type by checking its class in the _EVENT_TYPES dict
-        event_type = self._EVENT_TYPES.get(event.__class__, None)
+    def handle_notification(self, notification: MaintenanceNotification):
+        # get the notification type by checking its class in the _NOTIFICATION_TYPES dict
+        notification_type = self._NOTIFICATION_TYPES.get(notification.__class__, None)
 
-        if event_type is None:
-            logging.error(f"Unhandled event type: {event}")
+        if notification_type is None:
+            logging.error(f"Unhandled notification type: {notification}")
             return
 
-        if event_type:
-            self.handle_maintenance_start_event(MaintenanceState.MAINTENANCE)
+        if notification_type:
+            self.handle_maintenance_start_notification(MaintenanceState.MAINTENANCE)
         else:
-            self.handle_maintenance_completed_event()
+            self.handle_maintenance_completed_notification()
 
-    def handle_maintenance_start_event(self, maintenance_state: MaintenanceState):
+    def handle_maintenance_start_notification(
+        self, maintenance_state: MaintenanceState
+    ):
         if (
             self.connection.maintenance_state == MaintenanceState.MOVING
-            or not self.config.is_relax_timeouts_enabled()
+            or not self.config.is_relaxed_timeouts_enabled()
         ):
             return
 
         self.connection.maintenance_state = maintenance_state
-        self.connection.set_tmp_settings(tmp_relax_timeout=self.config.relax_timeout)
+        self.connection.set_tmp_settings(
+            tmp_relaxed_timeout=self.config.relaxed_timeout
+        )
         # extend the timeout for all created connections
-        self.connection.update_current_socket_timeout(self.config.relax_timeout)
+        self.connection.update_current_socket_timeout(self.config.relaxed_timeout)
 
-    def handle_maintenance_completed_event(self):
-        # Only reset timeouts if state is not MOVING and relax timeouts are enabled
+    def handle_maintenance_completed_notification(self):
+        # Only reset timeouts if state is not MOVING and relaxed timeouts are enabled
         if (
             self.connection.maintenance_state == MaintenanceState.MOVING
-            or not self.config.is_relax_timeouts_enabled()
+            or not self.config.is_relaxed_timeouts_enabled()
         ):
             return
-        self.connection.reset_tmp_settings(reset_relax_timeout=True)
+        self.connection.reset_tmp_settings(reset_relaxed_timeout=True)
         # Maintenance completed - reset the connection
-        # timeouts by providing -1 as the relax timeout
+        # timeouts by providing -1 as the relaxed timeout
         self.connection.update_current_socket_timeout(-1)
         self.connection.maintenance_state = MaintenanceState.NONE
diff --git a/tests/test_maintenance_events.py b/tests/test_maintenance_events.py
index 69bdad2947..60a85c7bea 100644
--- a/tests/test_maintenance_events.py
+++ b/tests/test_maintenance_events.py
@@ -5,39 +5,39 @@
 from redis.connection import ConnectionInterface
 
 from redis.maintenance_events import (
-    MaintenanceEvent,
-    NodeMovingEvent,
-    NodeMigratingEvent,
-    NodeMigratedEvent,
-    NodeFailingOverEvent,
-    NodeFailedOverEvent,
-    MaintenanceEventsConfig,
-    MaintenanceEventPoolHandler,
-    MaintenanceEventConnectionHandler,
+    MaintenanceNotification,
+    NodeMovingNotification,
+    NodeMigratingNotification,
+    NodeMigratedNotification,
+    NodeFailingOverNotification,
+    NodeFailedOverNotification,
+    MaintNotificationsConfig,
+    MaintNotificationsPoolHandler,
+    MaintNotificationsConnectionHandler,
     MaintenanceState,
     EndpointType,
 )
 
 
-class TestMaintenanceEvent:
-    """Test the base MaintenanceEvent class functionality through concrete subclasses."""
+class TestMaintenanceNotification:
+    """Test the base MaintenanceNotification class functionality through concrete subclasses."""
 
     def test_abstract_class_cannot_be_instantiated(self):
-        """Test that MaintenanceEvent cannot be instantiated directly."""
+        """Test that MaintenanceNotification cannot be instantiated directly."""
         with patch("time.monotonic", return_value=1000):
             with pytest.raises(TypeError):
-                MaintenanceEvent(id=1, ttl=10)  # type: ignore
+                MaintenanceNotification(id=1, ttl=10)  # type: ignore
 
     def test_init_through_subclass(self):
-        """Test MaintenanceEvent initialization through concrete subclass."""
+        """Test MaintenanceNotification initialization through concrete subclass."""
         with patch("time.monotonic", return_value=1000):
-            event = NodeMovingEvent(
+            notification = NodeMovingNotification(
                 id=1, new_node_host="localhost", new_node_port=6379, ttl=10
             )
-            assert event.id == 1
-            assert event.ttl == 10
-            assert event.creation_time == 1000
-            assert event.expire_at == 1010
+            assert notification.id == 1
+            assert notification.ttl == 10
+            assert notification.creation_time == 1000
+            assert notification.expire_at == 1010
 
     @pytest.mark.parametrize(
         ("current_time", "expected_expired_state"),
@@ -47,54 +47,54 @@ def test_init_through_subclass(self):
         ],
     )
     def test_is_expired(self, current_time, expected_expired_state):
-        """Test is_expired returns False for non-expired event."""
+        """Test is_expired returns False for non-expired notification."""
         with patch("time.monotonic", return_value=1000):
-            event = NodeMovingEvent(
+            notification = NodeMovingNotification(
                 id=1, new_node_host="localhost", new_node_port=6379, ttl=10
             )
 
         with patch("time.monotonic", return_value=current_time):
-            assert event.is_expired() == expected_expired_state
+            assert notification.is_expired() == expected_expired_state
 
     def test_is_expired_exact_boundary(self):
         """Test is_expired at exact expiration boundary."""
         with patch("time.monotonic", return_value=1000):
-            event = NodeMovingEvent(
+            notification = NodeMovingNotification(
                 id=1, new_node_host="localhost", new_node_port=6379, ttl=10
             )
 
         with patch("time.monotonic", return_value=1010):  # Exactly at expiration
-            assert not event.is_expired()
+            assert not notification.is_expired()
 
         with patch("time.monotonic", return_value=1011):  # 1 second past expiration
-            assert event.is_expired()
+            assert notification.is_expired()
 
 
-class TestNodeMovingEvent:
-    """Test the NodeMovingEvent class."""
+class TestNodeMovingNotification:
+    """Test the NodeMovingNotification class."""
 
     def test_init(self):
-        """Test NodeMovingEvent initialization."""
+        """Test NodeMovingNotification initialization."""
         with patch("time.monotonic", return_value=1000):
-            event = NodeMovingEvent(
+            notification = NodeMovingNotification(
                 id=1, new_node_host="localhost", new_node_port=6379, ttl=10
             )
-            assert event.id == 1
-            assert event.new_node_host == "localhost"
-            assert event.new_node_port == 6379
-            assert event.ttl == 10
-            assert event.creation_time == 1000
+            assert notification.id == 1
+            assert notification.new_node_host == "localhost"
+            assert notification.new_node_port == 6379
+            assert notification.ttl == 10
+            assert notification.creation_time == 1000
 
     def test_repr(self):
-        """Test NodeMovingEvent string representation."""
+        """Test NodeMovingNotification string representation."""
         with patch("time.monotonic", return_value=1000):
-            event = NodeMovingEvent(
+            notification = NodeMovingNotification(
                 id=1, new_node_host="localhost", new_node_port=6379, ttl=10
             )
 
         with patch("time.monotonic", return_value=1005):  # 5 seconds later
-            repr_str = repr(event)
-            assert "NodeMovingEvent" in repr_str
+            repr_str = repr(notification)
+            assert "NodeMovingNotification" in repr_str
             assert "id=1" in repr_str
             assert "new_node_host='localhost'" in repr_str
             assert "new_node_port=6379" in repr_str
@@ -103,334 +103,342 @@ def test_repr(self):
             assert "expired=False" in repr_str
 
     def test_equality_none_id_none_port(self):
-        """Test equality for events with same id and host and port - None."""
-        event1 = NodeMovingEvent(id=1, new_node_host=None, new_node_port=None, ttl=10)
-        event2 = NodeMovingEvent(
+        """Test equality for notifications with same id and host and port - None."""
+        notification1 = NodeMovingNotification(
+            id=1, new_node_host=None, new_node_port=None, ttl=10
+        )
+        notification2 = NodeMovingNotification(
             id=1, new_node_host=None, new_node_port=None, ttl=20
         )  # Different TTL
-        assert event1 == event2
+        assert notification1 == notification2
 
     def test_equality_same_id_host_port(self):
-        """Test equality for events with same id, host, and port."""
-        event1 = NodeMovingEvent(
+        """Test equality for notifications with same id, host, and port."""
+        notification1 = NodeMovingNotification(
             id=1, new_node_host="localhost", new_node_port=6379, ttl=10
         )
-        event2 = NodeMovingEvent(
+        notification2 = NodeMovingNotification(
             id=1, new_node_host="localhost", new_node_port=6379, ttl=20
         )  # Different TTL
-        assert event1 == event2
+        assert notification1 == notification2
 
     def test_equality_same_id_different_host(self):
-        """Test inequality for events with same id but different host."""
-        event1 = NodeMovingEvent(
+        """Test inequality for notifications with same id but different host."""
+        notification1 = NodeMovingNotification(
             id=1, new_node_host="host1", new_node_port=6379, ttl=10
         )
-        event2 = NodeMovingEvent(
+        notification2 = NodeMovingNotification(
             id=1, new_node_host="host2", new_node_port=6379, ttl=10
         )
-        assert event1 != event2
+        assert notification1 != notification2
 
     def test_equality_same_id_different_port(self):
-        """Test inequality for events with same id but different port."""
-        event1 = NodeMovingEvent(
+        """Test inequality for notifications with same id but different port."""
+        notification1 = NodeMovingNotification(
             id=1, new_node_host="localhost", new_node_port=6379, ttl=10
         )
-        event2 = NodeMovingEvent(
+        notification2 = NodeMovingNotification(
             id=1, new_node_host="localhost", new_node_port=6380, ttl=10
         )
-        assert event1 != event2
+        assert notification1 != notification2
 
     def test_equality_different_id(self):
-        """Test inequality for events with different id."""
-        event1 = NodeMovingEvent(
+        """Test inequality for notifications with different id."""
+        notification1 = NodeMovingNotification(
             id=1, new_node_host="localhost", new_node_port=6379, ttl=10
         )
-        event2 = NodeMovingEvent(
+        notification2 = NodeMovingNotification(
             id=2, new_node_host="localhost", new_node_port=6379, ttl=10
         )
-        assert event1 != event2
+        assert notification1 != notification2
 
     def test_equality_different_type(self):
-        """Test inequality for events of different types."""
-        event1 = NodeMovingEvent(
+        """Test inequality for notifications of different types."""
+        notification1 = NodeMovingNotification(
             id=1, new_node_host="localhost", new_node_port=6379, ttl=10
         )
-        event2 = NodeMigratingEvent(id=1, ttl=10)
-        assert event1 != event2
+        notification2 = NodeMigratingNotification(id=1, ttl=10)
+        assert notification1 != notification2
 
     def test_hash_same_id_host_port(self):
-        """Test hash consistency for events with same id, host, and port."""
-        event1 = NodeMovingEvent(
+        """Test hash consistency for notifications with same id, host, and port."""
+        notification1 = NodeMovingNotification(
             id=1, new_node_host="localhost", new_node_port=6379, ttl=10
         )
-        event2 = NodeMovingEvent(
+        notification2 = NodeMovingNotification(
             id=1, new_node_host="localhost", new_node_port=6379, ttl=20
         )  # Different TTL
-        assert hash(event1) == hash(event2)
+        assert hash(notification1) == hash(notification2)
 
     def test_hash_different_host(self):
-        """Test hash difference for events with different host."""
-        event1 = NodeMovingEvent(
+        """Test hash difference for notifications with different host."""
+        notification1 = NodeMovingNotification(
             id=1, new_node_host="host1", new_node_port=6379, ttl=10
         )
-        event2 = NodeMovingEvent(
+        notification2 = NodeMovingNotification(
             id=1, new_node_host="host2", new_node_port=6379, ttl=10
         )
-        assert hash(event1) != hash(event2)
+        assert hash(notification1) != hash(notification2)
 
     def test_hash_different_port(self):
-        """Test hash difference for events with different port."""
-        event1 = NodeMovingEvent(
+        """Test hash difference for notifications with different port."""
+        notification1 = NodeMovingNotification(
             id=1, new_node_host="localhost", new_node_port=6379, ttl=10
         )
-        event2 = NodeMovingEvent(
+        notification2 = NodeMovingNotification(
             id=1, new_node_host="localhost", new_node_port=6380, ttl=10
         )
-        assert hash(event1) != hash(event2)
+        assert hash(notification1) != hash(notification2)
 
     def test_hash_different_id(self):
-        """Test hash difference for events with different id."""
-        event1 = NodeMovingEvent(
+        """Test hash difference for notifications with different id."""
+        notification1 = NodeMovingNotification(
             id=1, new_node_host="localhost", new_node_port=6379, ttl=10
         )
-        event2 = NodeMovingEvent(
+        notification2 = NodeMovingNotification(
             id=2, new_node_host="localhost", new_node_port=6379, ttl=10
         )
-        assert hash(event1) != hash(event2)
+        assert hash(notification1) != hash(notification2)
 
     def test_set_functionality(self):
-        """Test that events can be used in sets correctly."""
-        event1 = NodeMovingEvent(
+        """Test that notifications can be used in sets correctly."""
+        notification1 = NodeMovingNotification(
             id=1, new_node_host="localhost", new_node_port=6379, ttl=10
         )
-        event2 = NodeMovingEvent(
+        notification2 = NodeMovingNotification(
             id=1, new_node_host="localhost", new_node_port=6379, ttl=20
         )  # Same id, host, port - should be considered the same
-        event3 = NodeMovingEvent(
+        notification3 = NodeMovingNotification(
             id=1, new_node_host="host2", new_node_port=6380, ttl=10
         )  # Same id but different host/port - should be different
-        event4 = NodeMovingEvent(
+        notification4 = NodeMovingNotification(
             id=2, new_node_host="localhost", new_node_port=6379, ttl=10
         )  # Different id - should be different
 
-        event_set = {event1, event2, event3, event4}
-        assert len(event_set) == 3  # event1 and event2 should be considered the same
+        notification_set = {notification1, notification2, notification3, notification4}
+        assert (
+            len(notification_set) == 3
+        )  # notification1 and notification2 should be considered the same
 
 
-class TestNodeMigratingEvent:
-    """Test the NodeMigratingEvent class."""
+class TestNodeMigratingNotification:
+    """Test the NodeMigratingNotification class."""
 
     def test_init(self):
-        """Test NodeMigratingEvent initialization."""
+        """Test NodeMigratingNotification initialization."""
         with patch("time.monotonic", return_value=1000):
-            event = NodeMigratingEvent(id=1, ttl=5)
-            assert event.id == 1
-            assert event.ttl == 5
-            assert event.creation_time == 1000
+            notification = NodeMigratingNotification(id=1, ttl=5)
+            assert notification.id == 1
+            assert notification.ttl == 5
+            assert notification.creation_time == 1000
 
     def test_repr(self):
-        """Test NodeMigratingEvent string representation."""
+        """Test NodeMigratingNotification string representation."""
         with patch("time.monotonic", return_value=1000):
-            event = NodeMigratingEvent(id=1, ttl=5)
+            notification = NodeMigratingNotification(id=1, ttl=5)
 
         with patch("time.monotonic", return_value=1002):  # 2 seconds later
-            repr_str = repr(event)
-            assert "NodeMigratingEvent" in repr_str
+            repr_str = repr(notification)
+            assert "NodeMigratingNotification" in repr_str
             assert "id=1" in repr_str
             assert "ttl=5" in repr_str
             assert "remaining=3.0s" in repr_str
             assert "expired=False" in repr_str
 
     def test_equality_and_hash(self):
-        """Test equality and hash for NodeMigratingEvent."""
-        event1 = NodeMigratingEvent(id=1, ttl=5)
-        event2 = NodeMigratingEvent(id=1, ttl=10)  # Same id, different ttl
-        event3 = NodeMigratingEvent(id=2, ttl=5)  # Different id
+        """Test equality and hash for NodeMigratingNotification."""
+        notification1 = NodeMigratingNotification(id=1, ttl=5)
+        notification2 = NodeMigratingNotification(
+            id=1, ttl=10
+        )  # Same id, different ttl
+        notification3 = NodeMigratingNotification(id=2, ttl=5)  # Different id
 
-        assert event1 == event2
-        assert event1 != event3
-        assert hash(event1) == hash(event2)
-        assert hash(event1) != hash(event3)
+        assert notification1 == notification2
+        assert notification1 != notification3
+        assert hash(notification1) == hash(notification2)
+        assert hash(notification1) != hash(notification3)
 
 
-class TestNodeMigratedEvent:
-    """Test the NodeMigratedEvent class."""
+class TestNodeMigratedNotification:
+    """Test the NodeMigratedNotification class."""
 
     def test_init(self):
-        """Test NodeMigratedEvent initialization."""
+        """Test NodeMigratedNotification initialization."""
         with patch("time.monotonic", return_value=1000):
-            event = NodeMigratedEvent(id=1)
-            assert event.id == 1
-            assert event.ttl == NodeMigratedEvent.DEFAULT_TTL
-            assert event.creation_time == 1000
+            notification = NodeMigratedNotification(id=1)
+            assert notification.id == 1
+            assert notification.ttl == NodeMigratedNotification.DEFAULT_TTL
+            assert notification.creation_time == 1000
 
     def test_default_ttl(self):
         """Test that DEFAULT_TTL is used correctly."""
-        assert NodeMigratedEvent.DEFAULT_TTL == 5
-        event = NodeMigratedEvent(id=1)
-        assert event.ttl == 5
+        assert NodeMigratedNotification.DEFAULT_TTL == 5
+        notification = NodeMigratedNotification(id=1)
+        assert notification.ttl == 5
 
     def test_repr(self):
-        """Test NodeMigratedEvent string representation."""
+        """Test NodeMigratedNotification string representation."""
         with patch("time.monotonic", return_value=1000):
-            event = NodeMigratedEvent(id=1)
+            notification = NodeMigratedNotification(id=1)
 
         with patch("time.monotonic", return_value=1001):  # 1 second later
-            repr_str = repr(event)
-            assert "NodeMigratedEvent" in repr_str
+            repr_str = repr(notification)
+            assert "NodeMigratedNotification" in repr_str
             assert "id=1" in repr_str
             assert "ttl=5" in repr_str
             assert "remaining=4.0s" in repr_str
             assert "expired=False" in repr_str
 
     def test_equality_and_hash(self):
-        """Test equality and hash for NodeMigratedEvent."""
-        event1 = NodeMigratedEvent(id=1)
-        event2 = NodeMigratedEvent(id=1)  # Same id
-        event3 = NodeMigratedEvent(id=2)  # Different id
+        """Test equality and hash for NodeMigratedNotification."""
+        notification1 = NodeMigratedNotification(id=1)
+        notification2 = NodeMigratedNotification(id=1)  # Same id
+        notification3 = NodeMigratedNotification(id=2)  # Different id
 
-        assert event1 == event2
-        assert event1 != event3
-        assert hash(event1) == hash(event2)
-        assert hash(event1) != hash(event3)
+        assert notification1 == notification2
+        assert notification1 != notification3
+        assert hash(notification1) == hash(notification2)
+        assert hash(notification1) != hash(notification3)
 
 
-class TestNodeFailingOverEvent:
-    """Test the NodeFailingOverEvent class."""
+class TestNodeFailingOverNotification:
+    """Test the NodeFailingOverNotification class."""
 
     def test_init(self):
-        """Test NodeFailingOverEvent initialization."""
+        """Test NodeFailingOverNotification initialization."""
         with patch("time.monotonic", return_value=1000):
-            event = NodeFailingOverEvent(id=1, ttl=5)
-            assert event.id == 1
-            assert event.ttl == 5
-            assert event.creation_time == 1000
+            notification = NodeFailingOverNotification(id=1, ttl=5)
+            assert notification.id == 1
+            assert notification.ttl == 5
+            assert notification.creation_time == 1000
 
     def test_repr(self):
-        """Test NodeFailingOverEvent string representation."""
+        """Test NodeFailingOverNotification string representation."""
         with patch("time.monotonic", return_value=1000):
-            event = NodeFailingOverEvent(id=1, ttl=5)
+            notification = NodeFailingOverNotification(id=1, ttl=5)
 
         with patch("time.monotonic", return_value=1002):  # 2 seconds later
-            repr_str = repr(event)
-            assert "NodeFailingOverEvent" in repr_str
+            repr_str = repr(notification)
+            assert "NodeFailingOverNotification" in repr_str
             assert "id=1" in repr_str
             assert "ttl=5" in repr_str
             assert "remaining=3.0s" in repr_str
             assert "expired=False" in repr_str
 
     def test_equality_and_hash(self):
-        """Test equality and hash for NodeFailingOverEvent."""
-        event1 = NodeFailingOverEvent(id=1, ttl=5)
-        event2 = NodeFailingOverEvent(id=1, ttl=10)  # Same id, different ttl
-        event3 = NodeFailingOverEvent(id=2, ttl=5)  # Different id
+        """Test equality and hash for NodeFailingOverNotification."""
+        notification1 = NodeFailingOverNotification(id=1, ttl=5)
+        notification2 = NodeFailingOverNotification(
+            id=1, ttl=10
+        )  # Same id, different ttl
+        notification3 = NodeFailingOverNotification(id=2, ttl=5)  # Different id
 
-        assert event1 == event2
-        assert event1 != event3
-        assert hash(event1) == hash(event2)
-        assert hash(event1) != hash(event3)
+        assert notification1 == notification2
+        assert notification1 != notification3
+        assert hash(notification1) == hash(notification2)
+        assert hash(notification1) != hash(notification3)
 
 
-class TestNodeFailedOverEvent:
-    """Test the NodeFailedOverEvent class."""
+class TestNodeFailedOverNotification:
+    """Test the NodeFailedOverNotification class."""
 
     def test_init(self):
-        """Test NodeFailedOverEvent initialization."""
+        """Test NodeFailedOverNotification initialization."""
         with patch("time.monotonic", return_value=1000):
-            event = NodeFailedOverEvent(id=1)
-            assert event.id == 1
-            assert event.ttl == NodeFailedOverEvent.DEFAULT_TTL
-            assert event.creation_time == 1000
+            notification = NodeFailedOverNotification(id=1)
+            assert notification.id == 1
+            assert notification.ttl == NodeFailedOverNotification.DEFAULT_TTL
+            assert notification.creation_time == 1000
 
     def test_default_ttl(self):
         """Test that DEFAULT_TTL is used correctly."""
-        assert NodeFailedOverEvent.DEFAULT_TTL == 5
-        event = NodeFailedOverEvent(id=1)
-        assert event.ttl == 5
+        assert NodeFailedOverNotification.DEFAULT_TTL == 5
+        notification = NodeFailedOverNotification(id=1)
+        assert notification.ttl == 5
 
     def test_repr(self):
-        """Test NodeFailedOverEvent string representation."""
+        """Test NodeFailedOverNotification string representation."""
         with patch("time.monotonic", return_value=1000):
-            event = NodeFailedOverEvent(id=1)
+            notification = NodeFailedOverNotification(id=1)
 
         with patch("time.monotonic", return_value=1001):  # 1 second later
-            repr_str = repr(event)
-            assert "NodeFailedOverEvent" in repr_str
+            repr_str = repr(notification)
+            assert "NodeFailedOverNotification" in repr_str
             assert "id=1" in repr_str
             assert "ttl=5" in repr_str
             assert "remaining=4.0s" in repr_str
             assert "expired=False" in repr_str
 
     def test_equality_and_hash(self):
-        """Test equality and hash for NodeFailedOverEvent."""
-        event1 = NodeFailedOverEvent(id=1)
-        event2 = NodeFailedOverEvent(id=1)  # Same id
-        event3 = NodeFailedOverEvent(id=2)  # Different id
+        """Test equality and hash for NodeFailedOverNotification."""
+        notification1 = NodeFailedOverNotification(id=1)
+        notification2 = NodeFailedOverNotification(id=1)  # Same id
+        notification3 = NodeFailedOverNotification(id=2)  # Different id
 
-        assert event1 == event2
-        assert event1 != event3
-        assert hash(event1) == hash(event2)
-        assert hash(event1) != hash(event3)
+        assert notification1 == notification2
+        assert notification1 != notification3
+        assert hash(notification1) == hash(notification2)
+        assert hash(notification1) != hash(notification3)
 
 
-class TestMaintenanceEventsConfig:
-    """Test the MaintenanceEventsConfig class."""
+class TestMaintNotificationsConfig:
+    """Test the MaintNotificationsConfig class."""
 
     def test_init_defaults(self):
-        """Test MaintenanceEventsConfig initialization with defaults."""
-        config = MaintenanceEventsConfig()
+        """Test MaintNotificationsConfig initialization with defaults."""
+        config = MaintNotificationsConfig()
         assert config.enabled is True
         assert config.proactive_reconnect is True
-        assert config.relax_timeout == 10
+        assert config.relaxed_timeout == 10
 
     def test_init_custom_values(self):
-        """Test MaintenanceEventsConfig initialization with custom values."""
-        config = MaintenanceEventsConfig(
-            enabled=True, proactive_reconnect=False, relax_timeout=30
+        """Test MaintNotificationsConfig initialization with custom values."""
+        config = MaintNotificationsConfig(
+            enabled=True, proactive_reconnect=False, relaxed_timeout=30
         )
         assert config.enabled is True
         assert config.proactive_reconnect is False
-        assert config.relax_timeout == 30
+        assert config.relaxed_timeout == 30
 
     def test_repr(self):
-        """Test MaintenanceEventsConfig string representation."""
-        config = MaintenanceEventsConfig(
-            enabled=True, proactive_reconnect=False, relax_timeout=30
+        """Test MaintNotificationsConfig string representation."""
+        config = MaintNotificationsConfig(
+            enabled=True, proactive_reconnect=False, relaxed_timeout=30
         )
         repr_str = repr(config)
-        assert "MaintenanceEventsConfig" in repr_str
+        assert "MaintNotificationsConfig" in repr_str
         assert "enabled=True" in repr_str
         assert "proactive_reconnect=False" in repr_str
-        assert "relax_timeout=30" in repr_str
+        assert "relaxed_timeout=30" in repr_str
 
-    def test_is_relax_timeouts_enabled_true(self):
-        """Test is_relax_timeouts_enabled returns True for positive timeout."""
-        config = MaintenanceEventsConfig(relax_timeout=20)
-        assert config.is_relax_timeouts_enabled() is True
+    def test_is_relaxed_timeouts_enabled_true(self):
+        """Test is_relaxed_timeouts_enabled returns True for positive timeout."""
+        config = MaintNotificationsConfig(relaxed_timeout=20)
+        assert config.is_relaxed_timeouts_enabled() is True
 
-    def test_is_relax_timeouts_enabled_false(self):
-        """Test is_relax_timeouts_enabled returns False for -1 timeout."""
-        config = MaintenanceEventsConfig(relax_timeout=-1)
-        assert config.is_relax_timeouts_enabled() is False
+    def test_is_relaxed_timeouts_enabled_false(self):
+        """Test is_relaxed_timeouts_enabled returns False for -1 timeout."""
+        config = MaintNotificationsConfig(relaxed_timeout=-1)
+        assert config.is_relaxed_timeouts_enabled() is False
 
-    def test_is_relax_timeouts_enabled_zero(self):
-        """Test is_relax_timeouts_enabled returns True for zero timeout."""
-        config = MaintenanceEventsConfig(relax_timeout=0)
-        assert config.is_relax_timeouts_enabled() is True
+    def test_is_relaxed_timeouts_enabled_zero(self):
+        """Test is_relaxed_timeouts_enabled returns True for zero timeout."""
+        config = MaintNotificationsConfig(relaxed_timeout=0)
+        assert config.is_relaxed_timeouts_enabled() is True
 
-    def test_is_relax_timeouts_enabled_none(self):
-        """Test is_relax_timeouts_enabled returns True for None timeout."""
-        config = MaintenanceEventsConfig(relax_timeout=None)
-        assert config.is_relax_timeouts_enabled() is True
+    def test_is_relaxed_timeouts_enabled_none(self):
+        """Test is_relaxed_timeouts_enabled returns True for None timeout."""
+        config = MaintNotificationsConfig(relaxed_timeout=None)
+        assert config.is_relaxed_timeouts_enabled() is True
 
-    def test_relax_timeout_none_is_saved_as_none(self):
-        """Test that None value for relax_timeout is saved as None."""
-        config = MaintenanceEventsConfig(relax_timeout=None)
-        assert config.relax_timeout is None
+    def test_relaxed_timeout_none_is_saved_as_none(self):
+        """Test that None value for relaxed_timeout is saved as None."""
+        config = MaintNotificationsConfig(relaxed_timeout=None)
+        assert config.relaxed_timeout is None
 
 
-class TestMaintenanceEventPoolHandler:
-    """Test the MaintenanceEventPoolHandler class."""
+class TestMaintNotificationsPoolHandler:
+    """Test the MaintNotificationsPoolHandler class."""
 
     def setup_method(self):
         """Set up test fixtures."""
@@ -438,84 +446,92 @@ def setup_method(self):
         self.mock_pool._lock = MagicMock()
         self.mock_pool._lock.__enter__.return_value = None
         self.mock_pool._lock.__exit__.return_value = None
-        self.config = MaintenanceEventsConfig(
-            enabled=True, proactive_reconnect=True, relax_timeout=20
+        self.config = MaintNotificationsConfig(
+            enabled=True, proactive_reconnect=True, relaxed_timeout=20
         )
-        self.handler = MaintenanceEventPoolHandler(self.mock_pool, self.config)
+        self.handler = MaintNotificationsPoolHandler(self.mock_pool, self.config)
 
     def test_init(self):
-        """Test MaintenanceEventPoolHandler initialization."""
+        """Test MaintNotificationsPoolHandler initialization."""
         assert self.handler.pool == self.mock_pool
         assert self.handler.config == self.config
-        assert isinstance(self.handler._processed_events, set)
+        assert isinstance(self.handler._processed_notifications, set)
         assert isinstance(self.handler._lock, type(threading.RLock()))
 
     def test_remove_expired_notifications(self):
         """Test removal of expired notifications."""
         with patch("time.monotonic", return_value=1000):
-            event1 = NodeMovingEvent(
+            notification1 = NodeMovingNotification(
                 id=1, new_node_host="host1", new_node_port=6379, ttl=10
             )
-            event2 = NodeMovingEvent(
+            notification2 = NodeMovingNotification(
                 id=2, new_node_host="host2", new_node_port=6380, ttl=5
             )
-            self.handler._processed_events.add(event1)
-            self.handler._processed_events.add(event2)
+            self.handler._processed_notifications.add(notification1)
+            self.handler._processed_notifications.add(notification2)
 
-        # Move time forward but not enough to expire event2 (expires at 1005)
+        # Move time forward but not enough to expire notification2 (expires at 1005)
         with patch("time.monotonic", return_value=1003):
             self.handler.remove_expired_notifications()
-            assert event1 in self.handler._processed_events
-            assert event2 in self.handler._processed_events  # Not expired yet
+            assert notification1 in self.handler._processed_notifications
+            assert (
+                notification2 in self.handler._processed_notifications
+            )  # Not expired yet
 
-        # Move time forward to expire event2 but not event1
+        # Move time forward to expire notification2 but not notification1
         with patch("time.monotonic", return_value=1006):
             self.handler.remove_expired_notifications()
-            assert event1 in self.handler._processed_events
-            assert event2 not in self.handler._processed_events  # Now expired
-
-    def test_handle_event_node_moving(self):
-        """Test handling of NodeMovingEvent."""
-        event = NodeMovingEvent(
+            assert notification1 in self.handler._processed_notifications
+            assert (
+                notification2 not in self.handler._processed_notifications
+            )  # Now expired
+
+    def test_handle_notification_node_moving(self):
+        """Test handling of NodeMovingNotification."""
+        notification = NodeMovingNotification(
             id=1, new_node_host="localhost", new_node_port=6379, ttl=10
         )
 
-        with patch.object(self.handler, "handle_node_moving_event") as mock_handle:
-            self.handler.handle_event(event)
-            mock_handle.assert_called_once_with(event)
+        with patch.object(
+            self.handler, "handle_node_moving_notification"
+        ) as mock_handle:
+            self.handler.handle_notification(notification)
+            mock_handle.assert_called_once_with(notification)
 
-    def test_handle_event_unknown_type(self):
-        """Test handling of unknown event type."""
-        event = NodeMigratingEvent(id=1, ttl=5)  # Not handled by pool handler
+    def test_handle_notification_unknown_type(self):
+        """Test handling of unknown notification type."""
+        notification = NodeMigratingNotification(
+            id=1, ttl=5
+        )  # Not handled by pool handler
 
-        result = self.handler.handle_event(event)
+        result = self.handler.handle_notification(notification)
         assert result is None
 
-    def test_handle_node_moving_event_disabled_config(self):
-        """Test node moving event handling when both features are disabled."""
-        config = MaintenanceEventsConfig(proactive_reconnect=False, relax_timeout=-1)
-        handler = MaintenanceEventPoolHandler(self.mock_pool, config)
-        event = NodeMovingEvent(
+    def test_handle_node_moving_notification_disabled_config(self):
+        """Test node moving notification handling when both features are disabled."""
+        config = MaintNotificationsConfig(proactive_reconnect=False, relaxed_timeout=-1)
+        handler = MaintNotificationsPoolHandler(self.mock_pool, config)
+        notification = NodeMovingNotification(
             id=1, new_node_host="localhost", new_node_port=6379, ttl=10
         )
 
-        result = handler.handle_node_moving_event(event)
+        result = handler.handle_node_moving_notification(notification)
         assert result is None
-        assert event not in handler._processed_events
+        assert notification not in handler._processed_notifications
 
-    def test_handle_node_moving_event_already_processed(self):
-        """Test node moving event handling when event already processed."""
-        event = NodeMovingEvent(
+    def test_handle_node_moving_notification_already_processed(self):
+        """Test node moving notification handling when notification already processed."""
+        notification = NodeMovingNotification(
             id=1, new_node_host="localhost", new_node_port=6379, ttl=10
         )
-        self.handler._processed_events.add(event)
+        self.handler._processed_notifications.add(notification)
 
-        result = self.handler.handle_node_moving_event(event)
+        result = self.handler.handle_node_moving_notification(notification)
         assert result is None
 
-    def test_handle_node_moving_event_success(self):
-        """Test successful node moving event handling."""
-        event = NodeMovingEvent(
+    def test_handle_node_moving_notification_success(self):
+        """Test successful node moving notification handling."""
+        notification = NodeMovingNotification(
             id=1, new_node_host="localhost", new_node_port=6379, ttl=10
         )
 
@@ -523,189 +539,197 @@ def test_handle_node_moving_event_success(self):
             patch("threading.Timer") as mock_timer,
             patch("time.monotonic", return_value=1000),
         ):
-            self.handler.handle_node_moving_event(event)
+            self.handler.handle_node_moving_notification(notification)
 
             # Verify timer was started
             mock_timer.assert_called_once_with(
-                event.ttl, self.handler.handle_node_moved_event, args=(event,)
+                notification.ttl,
+                self.handler.handle_node_moved_notification,
+                args=(notification,),
             )
             mock_timer.return_value.start.assert_called_once()
 
-            # Verify event was added to processed set
-            assert event in self.handler._processed_events
+            # Verify notification was added to processed set
+            assert notification in self.handler._processed_notifications
 
             # Verify pool methods were called
             self.mock_pool.update_connections_settings.assert_called_once()
 
-    def test_handle_node_moving_event_with_no_host_and_port(self):
-        """Test successful node moving event handling."""
-        event = NodeMovingEvent(id=1, new_node_host=None, new_node_port=None, ttl=2)
+    def test_handle_node_moving_notification_with_no_host_and_port(self):
+        """Test successful node moving notification handling."""
+        notification = NodeMovingNotification(
+            id=1, new_node_host=None, new_node_port=None, ttl=2
+        )
 
         with (
             patch("threading.Timer") as mock_timer,
             patch("time.monotonic", return_value=1000),
         ):
-            self.handler.handle_node_moving_event(event)
+            self.handler.handle_node_moving_notification(notification)
 
             # Verify timer was started
             mock_timer.assert_has_calls(
                 [
                     call(
-                        event.ttl / 2,
+                        notification.ttl / 2,
                         self.handler.run_proactive_reconnect,
                         args=(None,),
                     ),
                     call().start(),
                     call(
-                        event.ttl, self.handler.handle_node_moved_event, args=(event,)
+                        notification.ttl,
+                        self.handler.handle_node_moved_notification,
+                        args=(notification,),
                     ),
                     call().start(),
                 ]
             )
 
-            # Verify event was added to processed set
-            assert event in self.handler._processed_events
+            # Verify notification was added to processed set
+            assert notification in self.handler._processed_notifications
 
             # Verify pool methods were called
             self.mock_pool.update_connections_settings.assert_called_once()
 
-    def test_handle_node_moved_event(self):
-        """Test handling of node moved event (cleanup)."""
-        event = NodeMovingEvent(
+    def test_handle_node_moved_notification(self):
+        """Test handling of node moved notification (cleanup)."""
+        notification = NodeMovingNotification(
             id=1, new_node_host="localhost", new_node_port=6379, ttl=10
         )
         self.mock_pool.connection_kwargs = {"host": "localhost"}
-        self.handler.handle_node_moved_event(event)
+        self.handler.handle_node_moved_notification(notification)
 
         # Verify cleanup methods were called
         self.mock_pool.update_connections_settings.assert_called_once()
 
 
-class TestMaintenanceEventConnectionHandler:
-    """Test the MaintenanceEventConnectionHandler class."""
+class TestMaintNotificationsConnectionHandler:
+    """Test the MaintNotificationsConnectionHandler class."""
 
     def setup_method(self):
         """Set up test fixtures."""
         self.mock_connection = Mock()
-        self.config = MaintenanceEventsConfig(enabled=True, relax_timeout=20)
-        self.handler = MaintenanceEventConnectionHandler(
+        self.config = MaintNotificationsConfig(enabled=True, relaxed_timeout=20)
+        self.handler = MaintNotificationsConnectionHandler(
             self.mock_connection, self.config
         )
 
     def test_init(self):
-        """Test MaintenanceEventConnectionHandler initialization."""
+        """Test MaintNotificationsConnectionHandler initialization."""
         assert self.handler.connection == self.mock_connection
         assert self.handler.config == self.config
 
-    def test_handle_event_migrating(self):
-        """Test handling of NodeMigratingEvent."""
-        event = NodeMigratingEvent(id=1, ttl=5)
+    def test_handle_notification_migrating(self):
+        """Test handling of NodeMigratingNotification."""
+        notification = NodeMigratingNotification(id=1, ttl=5)
 
         with patch.object(
-            self.handler, "handle_maintenance_start_event"
+            self.handler, "handle_maintenance_start_notification"
         ) as mock_handle:
-            self.handler.handle_event(event)
+            self.handler.handle_notification(notification)
             mock_handle.assert_called_once_with(MaintenanceState.MAINTENANCE)
 
-    def test_handle_event_migrated(self):
-        """Test handling of NodeMigratedEvent."""
-        event = NodeMigratedEvent(id=1)
+    def test_handle_notification_migrated(self):
+        """Test handling of NodeMigratedNotification."""
+        notification = NodeMigratedNotification(id=1)
 
         with patch.object(
-            self.handler, "handle_maintenance_completed_event"
+            self.handler, "handle_maintenance_completed_notification"
         ) as mock_handle:
-            self.handler.handle_event(event)
+            self.handler.handle_notification(notification)
             mock_handle.assert_called_once_with()
 
-    def test_handle_event_failing_over(self):
-        """Test handling of NodeFailingOverEvent."""
-        event = NodeFailingOverEvent(id=1, ttl=5)
+    def test_handle_notification_failing_over(self):
+        """Test handling of NodeFailingOverNotification."""
+        notification = NodeFailingOverNotification(id=1, ttl=5)
 
         with patch.object(
-            self.handler, "handle_maintenance_start_event"
+            self.handler, "handle_maintenance_start_notification"
         ) as mock_handle:
-            self.handler.handle_event(event)
+            self.handler.handle_notification(notification)
             mock_handle.assert_called_once_with(MaintenanceState.MAINTENANCE)
 
-    def test_handle_event_failed_over(self):
-        """Test handling of NodeFailedOverEvent."""
-        event = NodeFailedOverEvent(id=1)
+    def test_handle_notification_failed_over(self):
+        """Test handling of NodeFailedOverNotification."""
+        notification = NodeFailedOverNotification(id=1)
 
         with patch.object(
-            self.handler, "handle_maintenance_completed_event"
+            self.handler, "handle_maintenance_completed_notification"
         ) as mock_handle:
-            self.handler.handle_event(event)
+            self.handler.handle_notification(notification)
             mock_handle.assert_called_once_with()
 
-    def test_handle_event_unknown_type(self):
-        """Test handling of unknown event type."""
-        event = NodeMovingEvent(
+    def test_handle_notification_unknown_type(self):
+        """Test handling of unknown notification type."""
+        notification = NodeMovingNotification(
             id=1, new_node_host="localhost", new_node_port=6379, ttl=10
         )
 
-        result = self.handler.handle_event(event)
+        result = self.handler.handle_notification(notification)
         assert result is None
 
-    def test_handle_maintenance_start_event_disabled(self):
-        """Test maintenance start event handling when relax timeouts are disabled."""
-        config = MaintenanceEventsConfig(relax_timeout=-1)
-        handler = MaintenanceEventConnectionHandler(self.mock_connection, config)
+    def test_handle_maintenance_start_notification_disabled(self):
+        """Test maintenance start notification handling when relaxed timeouts are disabled."""
+        config = MaintNotificationsConfig(relaxed_timeout=-1)
+        handler = MaintNotificationsConnectionHandler(self.mock_connection, config)
 
-        result = handler.handle_maintenance_start_event(MaintenanceState.MAINTENANCE)
+        result = handler.handle_maintenance_start_notification(
+            MaintenanceState.MAINTENANCE
+        )
 
         assert result is None
         self.mock_connection.update_current_socket_timeout.assert_not_called()
 
-    def test_handle_maintenance_start_event_moving_state(self):
-        """Test maintenance start event handling when connection is in MOVING state."""
+    def test_handle_maintenance_start_notification_moving_state(self):
+        """Test maintenance start notification handling when connection is in MOVING state."""
         self.mock_connection.maintenance_state = MaintenanceState.MOVING
 
-        result = self.handler.handle_maintenance_start_event(
+        result = self.handler.handle_maintenance_start_notification(
             MaintenanceState.MAINTENANCE
         )
         assert result is None
         self.mock_connection.update_current_socket_timeout.assert_not_called()
 
-    def test_handle_maintenance_start_event_success(self):
-        """Test successful maintenance start event handling for migrating."""
+    def test_handle_maintenance_start_notification_success(self):
+        """Test successful maintenance start notification handling for migrating."""
         self.mock_connection.maintenance_state = MaintenanceState.NONE
 
-        self.handler.handle_maintenance_start_event(MaintenanceState.MAINTENANCE)
+        self.handler.handle_maintenance_start_notification(MaintenanceState.MAINTENANCE)
 
         assert self.mock_connection.maintenance_state == MaintenanceState.MAINTENANCE
         self.mock_connection.update_current_socket_timeout.assert_called_once_with(20)
         self.mock_connection.set_tmp_settings.assert_called_once_with(
-            tmp_relax_timeout=20
+            tmp_relaxed_timeout=20
         )
 
-    def test_handle_maintenance_completed_event_disabled(self):
-        """Test maintenance completed event handling when relax timeouts are disabled."""
-        config = MaintenanceEventsConfig(relax_timeout=-1)
-        handler = MaintenanceEventConnectionHandler(self.mock_connection, config)
+    def test_handle_maintenance_completed_notification_disabled(self):
+        """Test maintenance completed notification handling when relaxed timeouts are disabled."""
+        config = MaintNotificationsConfig(relaxed_timeout=-1)
+        handler = MaintNotificationsConnectionHandler(self.mock_connection, config)
 
-        result = handler.handle_maintenance_completed_event()
+        result = handler.handle_maintenance_completed_notification()
         assert result is None
         self.mock_connection.update_current_socket_timeout.assert_not_called()
 
-    def test_handle_maintenance_completed_event_moving_state(self):
-        """Test maintenance completed event handling when connection is in MOVING state."""
+    def test_handle_maintenance_completed_notification_moving_state(self):
+        """Test maintenance completed notification handling when connection is in MOVING state."""
         self.mock_connection.maintenance_state = MaintenanceState.MOVING
 
-        result = self.handler.handle_maintenance_completed_event()
+        result = self.handler.handle_maintenance_completed_notification()
         assert result is None
         self.mock_connection.update_current_socket_timeout.assert_not_called()
 
-    def test_handle_maintenance_completed_event_success(self):
-        """Test successful maintenance completed event handling."""
+    def test_handle_maintenance_completed_notification_success(self):
+        """Test successful maintenance completed notification handling."""
         self.mock_connection.maintenance_state = MaintenanceState.MAINTENANCE
 
-        self.handler.handle_maintenance_completed_event()
+        self.handler.handle_maintenance_completed_notification()
 
         assert self.mock_connection.maintenance_state == MaintenanceState.NONE
 
         self.mock_connection.update_current_socket_timeout.assert_called_once_with(-1)
         self.mock_connection.reset_tmp_settings.assert_called_once_with(
-            reset_relax_timeout=True
+            reset_relaxed_timeout=True
         )
 
 
@@ -721,8 +745,8 @@ def test_endpoint_type_constants(self):
         assert EndpointType.NONE.value == "none"
 
 
-class TestMaintenanceEventsConfigEndpointType:
-    """Test MaintenanceEventsConfig endpoint type functionality."""
+class TestMaintNotificationsConfigEndpointType:
+    """Test MaintNotificationsConfig endpoint type functionality."""
 
     def setup_method(self):
         """Set up common mock classes for all tests."""
@@ -751,19 +775,19 @@ def get_resolved_ip(self):
         self.MockConnection = MockConnection
 
     def test_config_validation_valid_endpoint_types(self):
-        """Test that MaintenanceEventsConfig accepts valid endpoint types."""
+        """Test that MaintNotificationsConfig accepts valid endpoint types."""
         for endpoint_type in EndpointType:
-            config = MaintenanceEventsConfig(endpoint_type=endpoint_type)
+            config = MaintNotificationsConfig(endpoint_type=endpoint_type)
             assert config.endpoint_type == endpoint_type
 
     def test_config_validation_none_endpoint_type(self):
-        """Test that MaintenanceEventsConfig accepts None as endpoint type."""
-        config = MaintenanceEventsConfig(endpoint_type=None)
+        """Test that MaintNotificationsConfig accepts None as endpoint type."""
+        config = MaintNotificationsConfig(endpoint_type=None)
         assert config.endpoint_type is None
 
     def test_endpoint_type_detection_ip_addresses(self):
         """Test endpoint type detection for IP addresses."""
-        config = MaintenanceEventsConfig()
+        config = MaintNotificationsConfig()
 
         # Test private IPv4 addresses
         conn1 = self.MockConnection("192.168.1.1", resolved_ip="192.168.1.1")
@@ -788,7 +812,7 @@ def test_endpoint_type_detection_ip_addresses(self):
 
     def test_endpoint_type_detection_fqdn_with_resolved_ip(self):
         """Test endpoint type detection for FQDNs with resolved IP addresses."""
-        config = MaintenanceEventsConfig()
+        config = MaintNotificationsConfig()
 
         # Test FQDN resolving to private IP
         conn1 = self.MockConnection(
@@ -834,7 +858,7 @@ def test_endpoint_type_detection_fqdn_with_resolved_ip(self):
 
     def test_endpoint_type_detection_fqdn_heuristics(self):
         """Test endpoint type detection using FQDN heuristics when no resolved IP is available."""
-        config = MaintenanceEventsConfig()
+        config = MaintNotificationsConfig()
 
         # Test localhost (should be internal)
         conn1 = self.MockConnection("localhost")
@@ -859,11 +883,11 @@ def test_endpoint_type_override(self):
         """Test that configured endpoint_type overrides detection."""
 
         # Test with endpoint_type set to NONE
-        config = MaintenanceEventsConfig(endpoint_type=EndpointType.NONE)
+        config = MaintNotificationsConfig(endpoint_type=EndpointType.NONE)
         conn = self.MockConnection("localhost")
 
         assert config.get_endpoint_type("localhost", conn) == EndpointType.NONE
 
         # Test with endpoint_type set to EXTERNAL_IP
-        config = MaintenanceEventsConfig(endpoint_type=EndpointType.EXTERNAL_IP)
+        config = MaintNotificationsConfig(endpoint_type=EndpointType.EXTERNAL_IP)
         assert config.get_endpoint_type("localhost", conn) == EndpointType.EXTERNAL_IP
diff --git a/tests/test_maintenance_events_handling.py b/tests/test_maintenance_events_handling.py
index 06c607b552..c974eaaef7 100644
--- a/tests/test_maintenance_events_handling.py
+++ b/tests/test_maintenance_events_handling.py
@@ -14,13 +14,13 @@
     MaintenanceState,
 )
 from redis.maintenance_events import (
-    MaintenanceEventsConfig,
-    NodeMigratingEvent,
-    NodeMigratedEvent,
-    NodeFailingOverEvent,
-    NodeFailedOverEvent,
-    MaintenanceEventPoolHandler,
-    NodeMovingEvent,
+    MaintNotificationsConfig,
+    NodeMigratingNotification,
+    NodeMigratedNotification,
+    NodeFailingOverNotification,
+    NodeFailedOverNotification,
+    MaintNotificationsPoolHandler,
+    NodeMovingNotification,
 )
 
 
@@ -28,14 +28,14 @@
 DEFAULT_ADDRESS = "12.45.34.56:6379"
 MOVING_TIMEOUT = 1
 
-MOVING_EVENT = NodeMovingEvent(
+MOVING_NOTIFICATION = NodeMovingNotification(
     id=1,
     new_node_host=AFTER_MOVING_ADDRESS.split(":")[0],
     new_node_port=int(AFTER_MOVING_ADDRESS.split(":")[1]),
     ttl=MOVING_TIMEOUT,
 )
 
-MOVING_NONE_EVENT = NodeMovingEvent(
+MOVING_NONE_NOTIFICATION = NodeMovingNotification(
     id=1,
     new_node_host=None,
     new_node_port=None,
@@ -44,7 +44,7 @@
 
 
 class Helpers:
-    """Helper class containing static methods for validation in maintenance events tests."""
+    """Helper class containing static methods for validation in maintenance notifications tests."""
 
     @staticmethod
     def validate_in_use_connections_state(
@@ -122,7 +122,7 @@ def validate_free_connections_state(
             )
             assert connection.maintenance_state == expected_state
             if expected_state == MaintenanceState.NONE:
-                assert connection.maintenance_event_hash is None
+                assert connection.maintenance_notification_hash is None
 
             if connection._sock is not None:
                 assert connection._sock.connected is True
@@ -135,7 +135,7 @@ def validate_free_connections_state(
     def validate_conn_kwargs(
         pool,
         expected_maintenance_state,
-        expected_maintenance_event_hash,
+        expected_maintenance_notification_hash,
         expected_host_address,
         expected_port,
         expected_socket_timeout,
@@ -147,8 +147,8 @@ def validate_conn_kwargs(
         """Helper method to validate connection kwargs."""
         assert pool.connection_kwargs["maintenance_state"] == expected_maintenance_state
         assert (
-            pool.connection_kwargs["maintenance_event_hash"]
-            == expected_maintenance_event_hash
+            pool.connection_kwargs["maintenance_notification_hash"]
+            == expected_maintenance_notification_hash
         )
         assert pool.connection_kwargs["host"] == expected_host_address
         assert pool.connection_kwargs["port"] == expected_port
@@ -181,7 +181,7 @@ def __init__(self):
         self.closed = False
         self.command_count = 0
         self.pending_responses = []
-        # Track socket timeout changes for maintenance events validation
+        # Track socket timeout changes for maintenance notifications validation
         self.timeout = None
         self.thread_timeouts = {}  # Track last applied timeout per thread
         self.moving_sent = False
@@ -337,8 +337,8 @@ def shutdown(self, how):
         pass
 
 
-class TestMaintenanceEventsHandlingSingleProxy:
-    """Integration tests for maintenance events handling with real connection pool."""
+class TestMaintenanceNotificationsHandlingSingleProxy:
+    """Integration tests for maintenance notifications handling with real connection pool."""
 
     def setup_method(self):
         """Set up test fixtures with mocked sockets."""
@@ -370,9 +370,9 @@ def mock_select(rlist, wlist, xlist, timeout=0):
         self.select_patcher = patch("select.select", side_effect=mock_select)
         self.select_patcher.start()
 
-        # Create maintenance events config
-        self.config = MaintenanceEventsConfig(
-            enabled=True, proactive_reconnect=True, relax_timeout=30
+        # Create maintenance notifications config
+        self.config = MaintNotificationsConfig(
+            enabled=True, proactive_reconnect=True, relaxed_timeout=30
         )
 
     def teardown_method(self):
@@ -384,24 +384,24 @@ def _get_client(
         self,
         pool_class,
         max_connections=10,
-        maintenance_events_config=None,
+        maint_notifications_config=None,
         setup_pool_handler=False,
     ):
-        """Helper method to create a pool and Redis client with maintenance events configuration.
+        """Helper method to create a pool and Redis client with maintenance notifications configuration.
 
         Args:
             pool_class: The connection pool class (ConnectionPool or BlockingConnectionPool)
             max_connections: Maximum number of connections in the pool (default: 10)
-            maintenance_events_config: Optional MaintenanceEventsConfig to use. If not provided,
+            maint_notifications_config: Optional MaintNotificationsConfig to use. If not provided,
                                      uses self.config from setup_method (default: None)
-            setup_pool_handler: Whether to set up pool handler for moving events (default: False)
+            setup_pool_handler: Whether to set up pool handler for moving notifications (default: False)
 
         Returns:
             tuple: (test_pool, test_redis_client)
         """
         config = (
-            maintenance_events_config
-            if maintenance_events_config is not None
+            maint_notifications_config
+            if maint_notifications_config is not None
             else self.config
         )
 
@@ -409,17 +409,17 @@ def _get_client(
             host=DEFAULT_ADDRESS.split(":")[0],
             port=int(DEFAULT_ADDRESS.split(":")[1]),
             max_connections=max_connections,
-            protocol=3,  # Required for maintenance events
-            maintenance_events_config=config,
+            protocol=3,  # Required for maintenance notifications
+            maint_notifications_config=config,
         )
         test_redis_client = Redis(connection_pool=test_pool)
 
-        # Set up pool handler for moving events if requested
+        # Set up pool handler for moving notifications if requested
         if setup_pool_handler:
-            pool_handler = MaintenanceEventPoolHandler(
+            pool_handler = MaintNotificationsPoolHandler(
                 test_redis_client.connection_pool, config
             )
-            test_redis_client.connection_pool.set_maintenance_events_pool_handler(
+            test_redis_client.connection_pool.set_maint_notifications_pool_handler(
                 pool_handler
             )
 
@@ -433,7 +433,7 @@ def _validate_connection_handlers(self, conn, pool_handler, config):
         assert hasattr(parser_handler, "__self__")
         assert hasattr(parser_handler, "__func__")
         assert parser_handler.__self__ is pool_handler
-        assert parser_handler.__func__ is pool_handler.handle_event.__func__
+        assert parser_handler.__func__ is pool_handler.handle_notification.__func__
 
         # Test that the maintenance handler function is correctly set
         maintenance_handler = conn._parser.maintenance_push_handler_func
@@ -441,17 +441,17 @@ def _validate_connection_handlers(self, conn, pool_handler, config):
         assert hasattr(maintenance_handler, "__self__")
         assert hasattr(maintenance_handler, "__func__")
         # The maintenance handler should be bound to the connection's
-        # maintenance event connection handler
+        # maintenance notification connection handler
         assert (
-            maintenance_handler.__self__ is conn._maintenance_event_connection_handler
+            maintenance_handler.__self__ is conn._maint_notifications_connection_handler
         )
         assert (
             maintenance_handler.__func__
-            is conn._maintenance_event_connection_handler.handle_event.__func__
+            is conn._maint_notifications_connection_handler.handle_notification.__func__
         )
 
         # Validate that the connection's maintenance handler has the same config object
-        assert conn._maintenance_event_connection_handler.config is config
+        assert conn._maint_notifications_connection_handler.config is config
 
     def _validate_current_timeout(self, expected_timeout, error_msg=None):
         """Helper method to validate the current timeout for the calling thread."""
@@ -487,16 +487,16 @@ def _validate_connected(self, expected_count):
         assert connected_sockets_count == expected_count
 
     def test_client_initialization(self):
-        """Test that Redis client is created with maintenance events configuration."""
-        # Create a pool and Redis client with maintenance events
+        """Test that Redis client is created with maintenance notifications configuration."""
+        # Create a pool and Redis client with maintenance notifications
 
         test_redis_client = Redis(
-            protocol=3,  # Required for maintenance events
-            maintenance_events_config=self.config,
+            protocol=3,  # Required for maintenance notifications
+            maint_notifications_config=self.config,
         )
 
         pool_handler = test_redis_client.connection_pool.connection_kwargs.get(
-            "maintenance_events_pool_handler"
+            "maint_notifications_pool_handler"
         )
         assert pool_handler is not None
         assert pool_handler.config == self.config
@@ -513,7 +513,7 @@ def test_client_initialization(self):
         assert hasattr(parser_handler, "__self__")
         assert hasattr(parser_handler, "__func__")
         assert parser_handler.__self__ is pool_handler
-        assert parser_handler.__func__ is pool_handler.handle_event.__func__
+        assert parser_handler.__func__ is pool_handler.handle_notification.__func__
 
         # Test that the maintenance handler function is correctly set
         maintenance_handler = conn._parser.maintenance_push_handler_func
@@ -521,49 +521,49 @@ def test_client_initialization(self):
         assert hasattr(maintenance_handler, "__self__")
         assert hasattr(maintenance_handler, "__func__")
         # The maintenance handler should be bound to the connection's
-        # maintenance event connection handler
+        # maintenance notification connection handler
         assert (
-            maintenance_handler.__self__ is conn._maintenance_event_connection_handler
+            maintenance_handler.__self__ is conn._maint_notifications_connection_handler
         )
         assert (
             maintenance_handler.__func__
-            is conn._maintenance_event_connection_handler.handle_event.__func__
+            is conn._maint_notifications_connection_handler.handle_notification.__func__
         )
 
         # Validate that the connection's maintenance handler has the same config object
-        assert conn._maintenance_event_connection_handler.config is self.config
+        assert conn._maint_notifications_connection_handler.config is self.config
 
     def test_maint_handler_init_for_existing_connections(self):
-        """Test that maintenance event handlers are properly set on existing and new connections
+        """Test that maintenance notification handlers are properly set on existing and new connections
         when configuration is enabled after client creation."""
 
-        # Create a Redis client with disabled maintenance events configuration
-        disabled_config = MaintenanceEventsConfig(enabled=False)
+        # Create a Redis client with disabled maintenance notifications configuration
+        disabled_config = MaintNotificationsConfig(enabled=False)
         test_redis_client = Redis(
-            protocol=3,  # Required for maintenance events
-            maintenance_events_config=disabled_config,
+            protocol=3,  # Required for maintenance notifications
+            maint_notifications_config=disabled_config,
         )
 
-        # Extract an existing connection before enabling maintenance events
+        # Extract an existing connection before enabling maintenance notifications
         existing_conn = test_redis_client.connection_pool.get_connection()
 
-        # Verify that maintenance events are initially disabled
+        # Verify that maintenance notifications are initially disabled
         assert existing_conn._parser.node_moving_push_handler_func is None
-        assert existing_conn._maintenance_event_connection_handler is None
+        assert existing_conn._maint_notifications_connection_handler is None
         assert existing_conn._parser.maintenance_push_handler_func is None
 
         # Create a new enabled configuration and set up pool handler
-        enabled_config = MaintenanceEventsConfig(
-            enabled=True, proactive_reconnect=True, relax_timeout=30
+        enabled_config = MaintNotificationsConfig(
+            enabled=True, proactive_reconnect=True, relaxed_timeout=30
         )
-        pool_handler = MaintenanceEventPoolHandler(
+        pool_handler = MaintNotificationsPoolHandler(
             test_redis_client.connection_pool, enabled_config
         )
-        test_redis_client.connection_pool.set_maintenance_events_pool_handler(
+        test_redis_client.connection_pool.set_maint_notifications_pool_handler(
             pool_handler
         )
 
-        # Validate the existing connection after enabling maintenance events
+        # Validate the existing connection after enabling maintenance notifications
         # Both existing and new connections should now have full handler setup
         self._validate_connection_handlers(existing_conn, pool_handler, enabled_config)
 
@@ -576,9 +576,9 @@ def test_maint_handler_init_for_existing_connections(self):
         test_redis_client.connection_pool.release(new_conn)
 
     @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
-    def test_connection_pool_creation_with_maintenance_events(self, pool_class):
-        """Test that connection pools are created with maintenance events configuration."""
-        # Create a pool and Redis client with maintenance events
+    def test_connection_pool_creation_with_maintenance_notifications(self, pool_class):
+        """Test that connection pools are created with maintenance notifications configuration."""
+        # Create a pool and Redis client with maintenance notifications
         max_connections = 3 if pool_class == BlockingConnectionPool else 10
         test_redis_client = self._get_client(
             pool_class, max_connections=max_connections
@@ -587,23 +587,23 @@ def test_connection_pool_creation_with_maintenance_events(self, pool_class):
 
         try:
             assert (
-                test_pool.connection_kwargs.get("maintenance_events_config")
+                test_pool.connection_kwargs.get("maint_notifications_config")
                 == self.config
             )
-            # Pool should have maintenance events enabled
-            assert test_pool.maintenance_events_pool_handler_enabled() is True
+            # Pool should have maintenance notifications enabled
+            assert test_pool.maint_notifications_pool_handler_enabled() is True
 
             # Create and set a pool handler
-            pool_handler = MaintenanceEventPoolHandler(test_pool, self.config)
-            test_pool.set_maintenance_events_pool_handler(pool_handler)
+            pool_handler = MaintNotificationsPoolHandler(test_pool, self.config)
+            test_pool.set_maint_notifications_pool_handler(pool_handler)
 
             # Validate that the handler is properly set on the pool
             assert (
-                test_pool.connection_kwargs.get("maintenance_events_pool_handler")
+                test_pool.connection_kwargs.get("maint_notifications_pool_handler")
                 == pool_handler
             )
             assert (
-                test_pool.connection_kwargs.get("maintenance_events_config")
+                test_pool.connection_kwargs.get("maint_notifications_config")
                 == pool_handler.config
             )
 
@@ -621,7 +621,7 @@ def test_redis_operations_with_mock_sockets(self, pool_class):
         Test basic Redis operations work with mocked sockets and proper response parsing.
         Basically with test - the mocked socket is validated.
         """
-        # Create a pool and Redis client with maintenance events
+        # Create a pool and Redis client with maintenance notifications
         test_redis_client = self._get_client(pool_class, max_connections=5)
 
         try:
@@ -638,27 +638,27 @@ def test_redis_operations_with_mock_sockets(self, pool_class):
             assert self.mock_sockets[0].connected
             assert len(self.mock_sockets[0].sent_data) >= 2  # HELLO, SET, GET commands
 
-            # Verify that the connection has maintenance event handler
+            # Verify that the connection has maintenance notification handler
             connection = test_redis_client.connection_pool.get_connection()
-            assert hasattr(connection, "_maintenance_event_connection_handler")
+            assert hasattr(connection, "_maint_notifications_connection_handler")
             test_redis_client.connection_pool.release(connection)
 
         finally:
             if hasattr(test_redis_client.connection_pool, "disconnect"):
                 test_redis_client.connection_pool.disconnect()
 
-    def test_pool_handler_with_migrating_event(self):
-        """Test that pool handler correctly handles migrating events."""
-        # Create a pool and Redis client with maintenance events
+    def test_pool_handler_with_migrating_notification(self):
+        """Test that pool handler correctly handles migrating notifications."""
+        # Create a pool and Redis client with maintenance notifications
         test_redis_client = self._get_client(ConnectionPool)
         test_pool = test_redis_client.connection_pool
 
         try:
             # Create and set a pool handler
-            pool_handler = MaintenanceEventPoolHandler(test_pool, self.config)
+            pool_handler = MaintNotificationsPoolHandler(test_pool, self.config)
 
-            # Create a migrating event (not handled by pool handler)
-            migrating_event = NodeMigratingEvent(id=1, ttl=5)
+            # Create a migrating notification (not handled by pool handler)
+            migrating_notification = NodeMigratingNotification(id=1, ttl=5)
 
             # Mock the required functions
             with (
@@ -666,17 +666,17 @@ def test_pool_handler_with_migrating_event(self):
                     pool_handler, "remove_expired_notifications"
                 ) as mock_remove_expired,
                 patch.object(
-                    pool_handler, "handle_node_moving_event"
+                    pool_handler, "handle_node_moving_notification"
                 ) as mock_handle_moving,
                 patch("redis.maintenance_events.logging.error") as mock_logging_error,
             ):
-                # Pool handler should return None for migrating events (not its responsibility)
-                pool_handler.handle_event(migrating_event)
+                # Pool handler should return None for migrating notifications (not its responsibility)
+                pool_handler.handle_notification(migrating_notification)
 
                 # Validate that remove_expired_notifications has been called once
                 mock_remove_expired.assert_called_once()
 
-                # Validate that handle_node_moving_event hasn't been called
+                # Validate that handle_node_moving_notification hasn't been called
                 mock_handle_moving.assert_not_called()
 
                 # Validate that logging.error has been called once
@@ -687,9 +687,9 @@ def test_pool_handler_with_migrating_event(self):
                 test_pool.disconnect()
 
     @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
-    def test_migration_related_events_handling_integration(self, pool_class):
+    def test_migration_related_notifications_handling_integration(self, pool_class):
         """
-        Test full integration of migration-related events (MIGRATING/MIGRATED) handling.
+        Test full integration of migration-related notifications (MIGRATING/MIGRATED) handling.
 
         This test validates the complete migration lifecycle:
         1. Executes 5 Redis commands sequentially
@@ -701,7 +701,7 @@ def test_migration_related_events_handling_integration(self, pool_class):
         7. Tests both ConnectionPool and BlockingConnectionPool implementations
         8. Uses proper RESP3 push message format for realistic protocol simulation
         """
-        # Create a pool and Redis client with maintenance events
+        # Create a pool and Redis client with maintenance notifications
         test_redis_client = self._get_client(pool_class, max_connections=10)
 
         try:
@@ -760,7 +760,7 @@ def test_migration_related_events_handling_integration(self, pool_class):
             # Step 8: Validate socket timeout is reversed back to original after MIGRATED
             self._validate_current_timeout(None)
 
-            # Verify maintenance events were processed correctly
+            # Verify maintenance notifications were processed correctly
             # The key is that we have at least 1 socket and all operations succeeded
             assert len(self.mock_sockets) >= 1, (
                 f"Expected at least 1 socket for operations, got {len(self.mock_sockets)}"
@@ -771,26 +771,26 @@ def test_migration_related_events_handling_integration(self, pool_class):
                 test_redis_client.connection_pool.disconnect()
 
     @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
-    def test_migrating_event_with_disabled_relax_timeout(self, pool_class):
+    def test_migrating_notification_with_disabled_relaxed_timeout(self, pool_class):
         """
-        Test maintenance events handling when relax timeout is disabled.
+        Test maintenance notifications handling when relaxed timeout is disabled.
 
-        This test validates that when relax_timeout is disabled (-1):
-        1. MIGRATING, MIGRATED, FAILING_OVER, and FAILED_OVER events are received and processed
+        This test validates that when relaxed_timeout is disabled (-1):
+        1. MIGRATING, MIGRATED, FAILING_OVER, and FAILED_OVER notifications are received and processed
         2. No timeout updates are applied to connections
-        3. Socket timeouts remain unchanged during all maintenance events
+        3. Socket timeouts remain unchanged during all maintenance notifications
         4. Tests both ConnectionPool and BlockingConnectionPool implementations
         5. Tests the complete lifecycle: MIGRATING -> MIGRATED -> FAILING_OVER -> FAILED_OVER
         """
-        # Create config with disabled relax timeout
-        disabled_config = MaintenanceEventsConfig(
+        # Create config with disabled relaxed timeout
+        disabled_config = MaintNotificationsConfig(
             enabled=True,
-            relax_timeout=-1,  # This means the relax timeout is Disabled
+            relaxed_timeout=-1,  # This means the relaxed timeout is Disabled
         )
 
-        # Create a pool and Redis client with disabled relax timeout config
+        # Create a pool and Redis client with disabled relaxed timeout config
         test_redis_client = self._get_client(
-            pool_class, max_connections=5, maintenance_events_config=disabled_config
+            pool_class, max_connections=5, maint_notifications_config=disabled_config
         )
 
         try:
@@ -810,7 +810,7 @@ def test_migrating_event_with_disabled_relax_timeout(self, pool_class):
             # Validate Command 2 result
             assert result2 is True, "Command 2 (SET key_receive_migrating) failed"
 
-            # Validate timeout was NOT updated (relax is disabled)
+            # Validate timeout was NOT updated (relaxed is disabled)
             # Should remain at default timeout (None), not relaxed to 30s
             self._validate_current_timeout(None)
 
@@ -831,7 +831,7 @@ def test_migrating_event_with_disabled_relax_timeout(self, pool_class):
             # Validate Command 4 result
             assert result4 is True, "Command 4 (SET key_receive_migrated) failed"
 
-            # Validate timeout is still NOT updated after MIGRATED (relax is disabled)
+            # Validate timeout is still NOT updated after MIGRATED (relaxed is disabled)
             self._validate_current_timeout(None)
 
             # Command 5: This SET command will receive FAILING_OVER push message before response
@@ -842,7 +842,7 @@ def test_migrating_event_with_disabled_relax_timeout(self, pool_class):
             # Validate Command 5 result
             assert result5 is True, "Command 5 (SET key_receive_failing_over) failed"
 
-            # Validate timeout is still NOT updated after FAILING_OVER (relax is disabled)
+            # Validate timeout is still NOT updated after FAILING_OVER (relaxed is disabled)
             self._validate_current_timeout(None)
 
             # Command 6: Another command to verify timeout remains unchanged during failover
@@ -862,10 +862,10 @@ def test_migrating_event_with_disabled_relax_timeout(self, pool_class):
             # Validate Command 7 result
             assert result7 is True, "Command 7 (SET key_receive_failed_over) failed"
 
-            # Validate timeout is still NOT updated after FAILED_OVER (relax is disabled)
+            # Validate timeout is still NOT updated after FAILED_OVER (relaxed is disabled)
             self._validate_current_timeout(None)
 
-            # Command 8: Final command to verify timeout remains unchanged after all events
+            # Command 8: Final command to verify timeout remains unchanged after all notifications
             result8 = test_redis_client.get(key_failed_over)
 
             # Validate Command 8 result
@@ -874,7 +874,7 @@ def test_migrating_event_with_disabled_relax_timeout(self, pool_class):
                 f"Command 8 (GET key_receive_failed_over) failed. Expected: {expected_value8}, Got: {result8}"
             )
 
-            # Verify maintenance events were processed correctly
+            # Verify maintenance notifications were processed correctly
             # The key is that we have at least 1 socket and all operations succeeded
             assert len(self.mock_sockets) >= 1, (
                 f"Expected at least 1 socket for operations, got {len(self.mock_sockets)}"
@@ -885,9 +885,9 @@ def test_migrating_event_with_disabled_relax_timeout(self, pool_class):
                 test_redis_client.connection_pool.disconnect()
 
     @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
-    def test_failing_over_related_events_handling_integration(self, pool_class):
+    def test_failing_over_related_notifications_handling_integration(self, pool_class):
         """
-        Test full integration of failing-over-related events (FAILING_OVER/FAILED_OVER) handling.
+        Test full integration of failing-over-related notifications (FAILING_OVER/FAILED_OVER) handling.
 
         This test validates the complete FAILING_OVER -> FAILED_OVER lifecycle:
         1. Executes 5 Redis commands sequentially
@@ -899,7 +899,7 @@ def test_failing_over_related_events_handling_integration(self, pool_class):
         7. Tests both ConnectionPool and BlockingConnectionPool implementations
         8. Uses proper RESP3 push message format for realistic protocol simulation
         """
-        # Create a pool and Redis client with maintenance events
+        # Create a pool and Redis client with maintenance notifications
         test_redis_client = self._get_client(pool_class, max_connections=10)
 
         try:
@@ -958,7 +958,7 @@ def test_failing_over_related_events_handling_integration(self, pool_class):
             # Step 8: Validate socket timeout is reversed back to original after FAILED_OVER
             self._validate_current_timeout(None)
 
-            # Verify maintenance events were processed correctly
+            # Verify maintenance notifications were processed correctly
             # The key is that we have at least 1 socket and all operations succeeded
             assert len(self.mock_sockets) >= 1, (
                 f"Expected at least 1 socket for operations, got {len(self.mock_sockets)}"
@@ -969,11 +969,11 @@ def test_failing_over_related_events_handling_integration(self, pool_class):
                 test_redis_client.connection_pool.disconnect()
 
     @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
-    def test_moving_related_events_handling_integration(self, pool_class):
+    def test_moving_related_notifications_handling_integration(self, pool_class):
         """
-        Test full integration of moving-related events (MOVING) handling with Redis commands.
+        Test full integration of moving-related notifications (MOVING) handling with Redis commands.
 
-        This test validates the complete MOVING event lifecycle:
+        This test validates the complete MOVING notification lifecycle:
         1. Creates multiple connections in the pool
         2. Executes a Redis command that triggers a MOVING push message
         3. Validates that pool configuration is updated with temporary
@@ -981,7 +981,7 @@ def test_moving_related_events_handling_integration(self, pool_class):
         4. Validates that existing connections are marked for disconnection
         5. Tests both ConnectionPool and BlockingConnectionPool implementations
         """
-        # Create a pool and Redis client with maintenance events and pool handler
+        # Create a pool and Redis client with maintenance notifications and pool handler
         test_redis_client = self._get_client(
             pool_class, max_connections=10, setup_pool_handler=True
         )
@@ -1002,10 +1002,10 @@ def test_moving_related_events_handling_integration(self, pool_class):
                 connection = test_redis_client.connection_pool.get_connection()
                 in_use_connections.append(connection)
 
-            # Validate all connections are connected prior MOVING event
+            # Validate all connections are connected prior MOVING notification
             self._validate_disconnected(0)
 
-            # Run command that will receive and handle MOVING event
+            # Run command that will receive and handle MOVING notification
             key_moving = "key_receive_moving_0"
             value_moving = "value3_0"
             # the connection used for the command is expected to be reconnected to the new address
@@ -1015,17 +1015,17 @@ def test_moving_related_events_handling_integration(self, pool_class):
             # Validate Command 2 result
             assert result2 is True, "Command 2 (SET key_receive_moving) failed"
 
-            # Validate pool and connections settings were updated according to MOVING event
-            expected_event_hash = hash(MOVING_EVENT)
+            # Validate pool and connections settings were updated according to MOVING notification
+            expected_notification_hash = hash(MOVING_NOTIFICATION)
 
             Helpers.validate_conn_kwargs(
                 pool=test_redis_client.connection_pool,
                 expected_maintenance_state=MaintenanceState.MOVING,
-                expected_maintenance_event_hash=expected_event_hash,
+                expected_maintenance_notification_hash=expected_notification_hash,
                 expected_host_address=AFTER_MOVING_ADDRESS.split(":")[0],
                 expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
-                expected_socket_timeout=self.config.relax_timeout,
-                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_socket_timeout=self.config.relaxed_timeout,
+                expected_socket_connect_timeout=self.config.relaxed_timeout,
                 expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
                 expected_orig_socket_timeout=None,
                 expected_orig_socket_connect_timeout=None,
@@ -1036,12 +1036,12 @@ def test_moving_related_events_handling_integration(self, pool_class):
                 in_use_connections,
                 expected_state=MaintenanceState.MOVING,
                 expected_host_address=AFTER_MOVING_ADDRESS.split(":")[0],
-                expected_socket_timeout=self.config.relax_timeout,
-                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_socket_timeout=self.config.relaxed_timeout,
+                expected_socket_connect_timeout=self.config.relaxed_timeout,
                 expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
                 expected_orig_socket_timeout=None,
                 expected_orig_socket_connect_timeout=None,
-                expected_current_socket_timeout=self.config.relax_timeout,
+                expected_current_socket_timeout=self.config.relaxed_timeout,
                 expected_current_peername=DEFAULT_ADDRESS.split(":")[
                     0
                 ],  # the in use connections reconnect when they complete their current task
@@ -1050,8 +1050,8 @@ def test_moving_related_events_handling_integration(self, pool_class):
                 pool=test_redis_client.connection_pool,
                 expected_state=MaintenanceState.MOVING,
                 expected_host_address=AFTER_MOVING_ADDRESS.split(":")[0],
-                expected_socket_timeout=self.config.relax_timeout,
-                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_socket_timeout=self.config.relaxed_timeout,
+                expected_socket_connect_timeout=self.config.relaxed_timeout,
                 expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
                 expected_orig_socket_timeout=None,
                 expected_orig_socket_connect_timeout=None,
@@ -1076,7 +1076,7 @@ def test_moving_related_events_handling_integration(self, pool_class):
             Helpers.validate_conn_kwargs(
                 pool=test_redis_client.connection_pool,
                 expected_maintenance_state=MaintenanceState.NONE,
-                expected_maintenance_event_hash=None,
+                expected_maintenance_notification_hash=None,
                 expected_host_address=DEFAULT_ADDRESS.split(":")[0],
                 expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
                 expected_socket_timeout=None,
@@ -1102,11 +1102,11 @@ def test_moving_related_events_handling_integration(self, pool_class):
                 test_redis_client.connection_pool.disconnect()
 
     @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
-    def test_moving_none_events_handling_integration(self, pool_class):
+    def test_moving_none_notifications_handling_integration(self, pool_class):
         """
-        Test full integration of moving-related events (MOVING) handling with Redis commands.
+        Test full integration of moving-related notifications (MOVING) handling with Redis commands.
 
-        This test validates the complete MOVING event lifecycle,
+        This test validates the complete MOVING notification lifecycle,
         when the push notification doesn't contain host and port:
         1. Creates multiple connections in the pool
         2. Executes a Redis command that triggers a MOVING with "null" push message
@@ -1115,7 +1115,7 @@ def test_moving_none_events_handling_integration(self, pool_class):
         4. Validates that existing connections are marked for disconnection after ttl/2 seconds
         5. Tests both ConnectionPool and BlockingConnectionPool implementations
         """
-        # Create a pool and Redis client with maintenance events and pool handler
+        # Create a pool and Redis client with maintenance notifications and pool handler
         test_redis_client = self._get_client(
             pool_class, max_connections=10, setup_pool_handler=True
         )
@@ -1136,10 +1136,10 @@ def test_moving_none_events_handling_integration(self, pool_class):
                 connection = test_redis_client.connection_pool.get_connection()
                 in_use_connections.append(connection)
 
-            # Validate all connections are connected prior MOVING event
+            # Validate all connections are connected prior MOVING notification
             self._validate_disconnected(0)
 
-            # Run command that will receive and handle MOVING event
+            # Run command that will receive and handle MOVING notification
             key_moving = "key_receive_moving_none_0"
             value_moving = "value3_0"
 
@@ -1150,15 +1150,15 @@ def test_moving_none_events_handling_integration(self, pool_class):
             # Validate Command 2 result
             assert result2 is True, "Command 2 (SET key_receive_moving) failed"
 
-            # Validate pool and connections settings were updated according to MOVING event
+            # Validate pool and connections settings were updated according to MOVING notification
             Helpers.validate_conn_kwargs(
                 pool=test_redis_client.connection_pool,
                 expected_maintenance_state=MaintenanceState.MOVING,
-                expected_maintenance_event_hash=hash(MOVING_NONE_EVENT),
+                expected_maintenance_notification_hash=hash(MOVING_NONE_NOTIFICATION),
                 expected_host_address=DEFAULT_ADDRESS.split(":")[0],
                 expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
-                expected_socket_timeout=self.config.relax_timeout,
-                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_socket_timeout=self.config.relaxed_timeout,
+                expected_socket_connect_timeout=self.config.relaxed_timeout,
                 expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
                 expected_orig_socket_timeout=None,
                 expected_orig_socket_connect_timeout=None,
@@ -1170,12 +1170,12 @@ def test_moving_none_events_handling_integration(self, pool_class):
                 expected_should_reconnect=False,
                 expected_state=MaintenanceState.MOVING,
                 expected_host_address=DEFAULT_ADDRESS.split(":")[0],
-                expected_socket_timeout=self.config.relax_timeout,
-                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_socket_timeout=self.config.relaxed_timeout,
+                expected_socket_connect_timeout=self.config.relaxed_timeout,
                 expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
                 expected_orig_socket_timeout=None,
                 expected_orig_socket_connect_timeout=None,
-                expected_current_socket_timeout=self.config.relax_timeout,
+                expected_current_socket_timeout=self.config.relaxed_timeout,
                 expected_current_peername=DEFAULT_ADDRESS.split(":")[
                     0
                 ],  # the in use connections reconnect when they complete their current task
@@ -1184,8 +1184,8 @@ def test_moving_none_events_handling_integration(self, pool_class):
                 pool=test_redis_client.connection_pool,
                 expected_state=MaintenanceState.MOVING,
                 expected_host_address=DEFAULT_ADDRESS.split(":")[0],
-                expected_socket_timeout=self.config.relax_timeout,
-                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_socket_timeout=self.config.relaxed_timeout,
+                expected_socket_connect_timeout=self.config.relaxed_timeout,
                 expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
                 expected_orig_socket_timeout=None,
                 expected_orig_socket_connect_timeout=None,
@@ -1199,12 +1199,12 @@ def test_moving_none_events_handling_integration(self, pool_class):
                 expected_should_reconnect=True,
                 expected_state=MaintenanceState.MOVING,
                 expected_host_address=DEFAULT_ADDRESS.split(":")[0],
-                expected_socket_timeout=self.config.relax_timeout,
-                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_socket_timeout=self.config.relaxed_timeout,
+                expected_socket_connect_timeout=self.config.relaxed_timeout,
                 expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
                 expected_orig_socket_timeout=None,
                 expected_orig_socket_connect_timeout=None,
-                expected_current_socket_timeout=self.config.relax_timeout,
+                expected_current_socket_timeout=self.config.relaxed_timeout,
                 expected_current_peername=DEFAULT_ADDRESS.split(":")[
                     0
                 ],  # the in use connections reconnect when they complete their current task
@@ -1229,7 +1229,7 @@ def test_moving_none_events_handling_integration(self, pool_class):
             Helpers.validate_conn_kwargs(
                 pool=test_redis_client.connection_pool,
                 expected_maintenance_state=MaintenanceState.NONE,
-                expected_maintenance_event_hash=None,
+                expected_maintenance_notification_hash=None,
                 expected_host_address=DEFAULT_ADDRESS.split(":")[0],
                 expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
                 expected_socket_timeout=None,
@@ -1257,14 +1257,14 @@ def test_moving_none_events_handling_integration(self, pool_class):
     @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
     def test_create_new_conn_while_moving_not_expired(self, pool_class):
         """
-        Test creating new connections while MOVING event is active (not expired).
+        Test creating new connections while MOVING notification is active (not expired).
 
         This test validates that:
-        1. After MOVING event is processed, new connections are created with temporary address
+        1. After MOVING notification is processed, new connections are created with temporary address
         2. New connections inherit the relaxed timeout settings
         3. Pool configuration is properly applied to newly created connections
         """
-        # Create a pool and Redis client with maintenance events and pool handler
+        # Create a pool and Redis client with maintenance notifications and pool handler
         test_redis_client = self._get_client(
             pool_class, max_connections=10, setup_pool_handler=True
         )
@@ -1285,10 +1285,10 @@ def test_create_new_conn_while_moving_not_expired(self, pool_class):
                 connection = test_redis_client.connection_pool.get_connection()
                 in_use_connections.append(connection)
 
-            # Validate all connections are connected prior MOVING event
+            # Validate all connections are connected prior MOVING notification
             self._validate_disconnected(0)
 
-            # Run command that will receive and handle MOVING event
+            # Run command that will receive and handle MOVING notification
             key_moving = "key_receive_moving_0"
             value_moving = "value3_0"
             result = test_redis_client.set(key_moving, value_moving)
@@ -1296,18 +1296,18 @@ def test_create_new_conn_while_moving_not_expired(self, pool_class):
             # Validate command result
             assert result is True, "SET key_receive_moving command failed"
 
-            # Validate pool and connections settings were updated according to MOVING event
+            # Validate pool and connections settings were updated according to MOVING notification
             Helpers.validate_conn_kwargs(
                 pool=test_redis_client.connection_pool,
                 expected_maintenance_state=MaintenanceState.MOVING,
-                expected_maintenance_event_hash=hash(MOVING_EVENT),
+                expected_maintenance_notification_hash=hash(MOVING_NOTIFICATION),
                 expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
                 expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
                 expected_orig_socket_timeout=None,
                 expected_orig_socket_connect_timeout=None,
                 expected_host_address=AFTER_MOVING_ADDRESS.split(":")[0],
-                expected_socket_timeout=self.config.relax_timeout,
-                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_socket_timeout=self.config.relaxed_timeout,
+                expected_socket_connect_timeout=self.config.relaxed_timeout,
             )
 
             # Now get several more connections to force creation of new ones
@@ -1319,11 +1319,11 @@ def test_create_new_conn_while_moving_not_expired(self, pool_class):
 
             new_connection = test_redis_client.connection_pool.get_connection()
 
-            # Validate that new connections are created with temporary address and relax timeout
+            # Validate that new connections are created with temporary address and relaxed timeout
             # and when connecting those configs are used
             # get_connection() returns a connection that is already connected
             assert new_connection.host == AFTER_MOVING_ADDRESS.split(":")[0]
-            assert new_connection.socket_timeout is self.config.relax_timeout
+            assert new_connection.socket_timeout is self.config.relaxed_timeout
             # New connections should be connected to the temporary address
             assert new_connection._sock is not None
             assert new_connection._sock.connected is True
@@ -1331,7 +1331,7 @@ def test_create_new_conn_while_moving_not_expired(self, pool_class):
                 new_connection._sock.getpeername()[0]
                 == AFTER_MOVING_ADDRESS.split(":")[0]
             )
-            assert new_connection._sock.gettimeout() == self.config.relax_timeout
+            assert new_connection._sock.gettimeout() == self.config.relaxed_timeout
 
         finally:
             if hasattr(test_redis_client.connection_pool, "disconnect"):
@@ -1340,14 +1340,14 @@ def test_create_new_conn_while_moving_not_expired(self, pool_class):
     @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
     def test_create_new_conn_after_moving_expires(self, pool_class):
         """
-        Test creating new connections after MOVING event expires.
+        Test creating new connections after MOVING notification expires.
 
         This test validates that:
         1. After MOVING timeout expires, new connections use original address
         2. Pool configuration is reset to original values
         3. New connections don't inherit temporary settings
         """
-        # Create a pool and Redis client with maintenance events and pool handler
+        # Create a pool and Redis client with maintenance notifications and pool handler
         test_redis_client = self._get_client(
             pool_class, max_connections=10, setup_pool_handler=True
         )
@@ -1368,7 +1368,7 @@ def test_create_new_conn_after_moving_expires(self, pool_class):
                 connection = test_redis_client.connection_pool.get_connection()
                 in_use_connections.append(connection)
 
-            # Run command that will receive and handle MOVING event
+            # Run command that will receive and handle MOVING notification
             key_moving = "key_receive_moving_0"
             value_moving = "value3_0"
             result = test_redis_client.set(key_moving, value_moving)
@@ -1403,18 +1403,18 @@ def test_create_new_conn_after_moving_expires(self, pool_class):
     @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
     def test_receive_migrated_after_moving(self, pool_class):
         """
-        Test receiving MIGRATED event after MOVING event.
+        Test receiving MIGRATED notification after MOVING notification.
 
         This test validates the complete MOVING -> MIGRATED lifecycle:
-        1. MOVING event is processed and temporary settings are applied
-        2. MIGRATED event is received during command execution
+        1. MOVING notification is processed and temporary settings are applied
+        2. MIGRATED notification is received during command execution
         3. Temporary settings are cleared after MIGRATED
         4. Pool configuration is restored to original values
 
         Note: When MIGRATED comes after MOVING and MOVING hasn't yet expired,
         it should not decrease timeouts (future refactoring consideration).
         """
-        # Create a pool and Redis client with maintenance events and pool handler
+        # Create a pool and Redis client with maintenance notifications and pool handler
         test_redis_client = self._get_client(
             pool_class, max_connections=10, setup_pool_handler=True
         )
@@ -1435,10 +1435,10 @@ def test_receive_migrated_after_moving(self, pool_class):
                 connection = test_redis_client.connection_pool.get_connection()
                 in_use_connections.append(connection)
 
-            # Validate all connections are connected prior MOVING event
+            # Validate all connections are connected prior MOVING notification
             self._validate_disconnected(0)
 
-            # Step 1: Run command that will receive and handle MOVING event
+            # Step 1: Run command that will receive and handle MOVING notification
             key_moving = "key_receive_moving_0"
             value_moving = "value3_0"
             result_moving = test_redis_client.set(key_moving, value_moving)
@@ -1446,23 +1446,23 @@ def test_receive_migrated_after_moving(self, pool_class):
             # Validate MOVING command result
             assert result_moving is True, "SET key_receive_moving command failed"
 
-            # Validate pool and connections settings were updated according to MOVING event
+            # Validate pool and connections settings were updated according to MOVING notification
             Helpers.validate_conn_kwargs(
                 pool=test_redis_client.connection_pool,
                 expected_maintenance_state=MaintenanceState.MOVING,
-                expected_maintenance_event_hash=hash(MOVING_EVENT),
+                expected_maintenance_notification_hash=hash(MOVING_NOTIFICATION),
                 expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
                 expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
                 expected_orig_socket_timeout=None,
                 expected_orig_socket_connect_timeout=None,
                 expected_host_address=AFTER_MOVING_ADDRESS.split(":")[0],
-                expected_socket_timeout=self.config.relax_timeout,
-                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_socket_timeout=self.config.relaxed_timeout,
+                expected_socket_connect_timeout=self.config.relaxed_timeout,
             )
 
             # TODO validate current socket timeout
 
-            # Step 2: Run command that will receive and handle MIGRATED event
+            # Step 2: Run command that will receive and handle MIGRATED notification
             # This should clear the temporary settings
             key_migrated = "key_receive_migrated_0"
             value_migrated = "migrated_value"
@@ -1471,21 +1471,21 @@ def test_receive_migrated_after_moving(self, pool_class):
             # Validate MIGRATED command result
             assert result_migrated is True, "SET key_receive_migrated command failed"
 
-            # Step 3: Validate that MIGRATED event was processed but MOVING settings remain
-            # (MIGRATED doesn't automatically clear MOVING settings - they are separate events)
+            # Step 3: Validate that MIGRATED notification was processed but MOVING settings remain
+            # (MIGRATED doesn't automatically clear MOVING settings - they are separate notifications)
             # MOVING settings should still be active
             # MOVING timeout should still be active
             Helpers.validate_conn_kwargs(
                 pool=test_redis_client.connection_pool,
                 expected_maintenance_state=MaintenanceState.MOVING,
-                expected_maintenance_event_hash=hash(MOVING_EVENT),
+                expected_maintenance_notification_hash=hash(MOVING_NOTIFICATION),
                 expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
                 expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
                 expected_orig_socket_timeout=None,
                 expected_orig_socket_connect_timeout=None,
                 expected_host_address=AFTER_MOVING_ADDRESS.split(":")[0],
-                expected_socket_timeout=self.config.relax_timeout,
-                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_socket_timeout=self.config.relaxed_timeout,
+                expected_socket_connect_timeout=self.config.relaxed_timeout,
             )
 
             # Step 4: Create new connections after MIGRATED to verify they still use MOVING settings
@@ -1498,7 +1498,7 @@ def test_receive_migrated_after_moving(self, pool_class):
             # Validate that new connections are created with MOVING settings (still active)
             for connection in new_connections:
                 assert connection.host == AFTER_MOVING_ADDRESS.split(":")[0]
-                # Note: New connections may not inherit the exact relax timeout value
+                # Note: New connections may not inherit the exact relaxed timeout value
                 # but they should have the temporary host address
                 # New connections should be connected
                 if connection._sock is not None:
@@ -1517,10 +1517,10 @@ def test_receive_migrated_after_moving(self, pool_class):
                 test_redis_client.connection_pool.disconnect()
 
     @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
-    def test_overlapping_moving_events(self, pool_class):
+    def test_overlapping_moving_notifications(self, pool_class):
         """
-        Test handling of overlapping/duplicate MOVING events (e.g., two MOVING events before the first expires).
-        Ensures that the second MOVING event updates the pool and connections as expected, and that expiry/cleanup works.
+        Test handling of overlapping/duplicate MOVING notifications (e.g., two MOVING notifications before the first expires).
+        Ensures that the second MOVING notification updates the pool and connections as expected, and that expiry/cleanup works.
         """
         global AFTER_MOVING_ADDRESS
         test_redis_client = self._get_client(
@@ -1543,7 +1543,7 @@ def test_overlapping_moving_events(self, pool_class):
                 conn = test_redis_client.connection_pool.get_connection()
                 in_use_connections.append(conn)
 
-            # Trigger first MOVING event
+            # Trigger first MOVING notification
             key_moving1 = "key_receive_moving_0"
             value_moving1 = "value3_0"
             result1 = test_redis_client.set(key_moving1, value_moving1)
@@ -1551,26 +1551,26 @@ def test_overlapping_moving_events(self, pool_class):
             Helpers.validate_conn_kwargs(
                 pool=test_redis_client.connection_pool,
                 expected_maintenance_state=MaintenanceState.MOVING,
-                expected_maintenance_event_hash=hash(MOVING_EVENT),
+                expected_maintenance_notification_hash=hash(MOVING_NOTIFICATION),
                 expected_host_address=AFTER_MOVING_ADDRESS.split(":")[0],
                 expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
-                expected_socket_timeout=self.config.relax_timeout,
-                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_socket_timeout=self.config.relaxed_timeout,
+                expected_socket_connect_timeout=self.config.relaxed_timeout,
                 expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
                 expected_orig_socket_timeout=None,
                 expected_orig_socket_connect_timeout=None,
             )
-            # Validate all connections reflect the first MOVING event
+            # Validate all connections reflect the first MOVING notification
             Helpers.validate_in_use_connections_state(
                 in_use_connections,
                 expected_state=MaintenanceState.MOVING,
                 expected_host_address=AFTER_MOVING_ADDRESS.split(":")[0],
-                expected_socket_timeout=self.config.relax_timeout,
-                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_socket_timeout=self.config.relaxed_timeout,
+                expected_socket_connect_timeout=self.config.relaxed_timeout,
                 expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
                 expected_orig_socket_timeout=None,
                 expected_orig_socket_connect_timeout=None,
-                expected_current_socket_timeout=self.config.relax_timeout,
+                expected_current_socket_timeout=self.config.relaxed_timeout,
                 expected_current_peername=DEFAULT_ADDRESS.split(":")[0],
             )
             Helpers.validate_free_connections_state(
@@ -1579,8 +1579,8 @@ def test_overlapping_moving_events(self, pool_class):
                 connected_to_tmp_address=True,
                 expected_state=MaintenanceState.MOVING,
                 expected_host_address=AFTER_MOVING_ADDRESS.split(":")[0],
-                expected_socket_timeout=self.config.relax_timeout,
-                expected_socket_connect_timeout=self.config.relax_timeout,
+                expected_socket_timeout=self.config.relaxed_timeout,
+                expected_socket_connect_timeout=self.config.relaxed_timeout,
                 expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
                 expected_orig_socket_timeout=None,
                 expected_orig_socket_connect_timeout=None,
@@ -1590,13 +1590,13 @@ def test_overlapping_moving_events(self, pool_class):
                 conn.disconnect()
                 conn.connect()
 
-            # Before the first MOVING expires, trigger a second MOVING event (simulate new address)
+            # Before the first MOVING expires, trigger a second MOVING notification (simulate new address)
             # Validate the orig properties are not changed!
             second_moving_address = "5.6.7.8:6380"
             orig_after_moving = AFTER_MOVING_ADDRESS
             # Temporarily modify the global constant for this test
             AFTER_MOVING_ADDRESS = second_moving_address
-            second_moving_event = NodeMovingEvent(
+            second_moving_notification = NodeMovingNotification(
                 id=1,
                 new_node_host=second_moving_address.split(":")[0],
                 new_node_port=int(second_moving_address.split(":")[1]),
@@ -1610,26 +1610,28 @@ def test_overlapping_moving_events(self, pool_class):
                 Helpers.validate_conn_kwargs(
                     pool=test_redis_client.connection_pool,
                     expected_maintenance_state=MaintenanceState.MOVING,
-                    expected_maintenance_event_hash=hash(second_moving_event),
+                    expected_maintenance_notification_hash=hash(
+                        second_moving_notification
+                    ),
                     expected_host_address=second_moving_address.split(":")[0],
                     expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
-                    expected_socket_timeout=self.config.relax_timeout,
-                    expected_socket_connect_timeout=self.config.relax_timeout,
+                    expected_socket_timeout=self.config.relaxed_timeout,
+                    expected_socket_connect_timeout=self.config.relaxed_timeout,
                     expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
                     expected_orig_socket_timeout=None,
                     expected_orig_socket_connect_timeout=None,
                 )
-                # Validate all connections reflect the second MOVING event
+                # Validate all connections reflect the second MOVING notification
                 Helpers.validate_in_use_connections_state(
                     in_use_connections,
                     expected_state=MaintenanceState.MOVING,
                     expected_host_address=second_moving_address.split(":")[0],
-                    expected_socket_timeout=self.config.relax_timeout,
-                    expected_socket_connect_timeout=self.config.relax_timeout,
+                    expected_socket_timeout=self.config.relaxed_timeout,
+                    expected_socket_connect_timeout=self.config.relaxed_timeout,
                     expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
                     expected_orig_socket_timeout=None,
                     expected_orig_socket_connect_timeout=None,
-                    expected_current_socket_timeout=self.config.relax_timeout,
+                    expected_current_socket_timeout=self.config.relaxed_timeout,
                     expected_current_peername=orig_after_moving.split(":")[0],
                 )
                 # print(test_redis_client.connection_pool._available_connections)
@@ -1640,8 +1642,8 @@ def test_overlapping_moving_events(self, pool_class):
                     tmp_address=second_moving_address.split(":")[0],
                     expected_state=MaintenanceState.MOVING,
                     expected_host_address=second_moving_address.split(":")[0],
-                    expected_socket_timeout=self.config.relax_timeout,
-                    expected_socket_connect_timeout=self.config.relax_timeout,
+                    expected_socket_timeout=self.config.relaxed_timeout,
+                    expected_socket_connect_timeout=self.config.relaxed_timeout,
                     expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
                     expected_orig_socket_timeout=None,
                     expected_orig_socket_connect_timeout=None,
@@ -1654,7 +1656,7 @@ def test_overlapping_moving_events(self, pool_class):
             Helpers.validate_conn_kwargs(
                 pool=test_redis_client.connection_pool,
                 expected_maintenance_state=MaintenanceState.NONE,
-                expected_maintenance_event_hash=None,
+                expected_maintenance_notification_hash=None,
                 expected_host_address=DEFAULT_ADDRESS.split(":")[0],
                 expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
                 expected_socket_timeout=None,
@@ -1668,10 +1670,10 @@ def test_overlapping_moving_events(self, pool_class):
                 test_redis_client.connection_pool.disconnect()
 
     @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
-    def test_thread_safety_concurrent_event_handling(self, pool_class):
+    def test_thread_safety_concurrent_notification_handling(self, pool_class):
         """
-        Test thread-safety under concurrent maintenance event handling.
-        Simulates multiple threads triggering MOVING events and performing operations concurrently.
+        Test thread-safety under concurrent maintenance notification handling.
+        Simulates multiple threads triggering MOVING notifications and performing operations concurrently.
         """
         import threading
 
@@ -1697,15 +1699,15 @@ def worker(idx):
             t.join()
         assert all(results), f"Not all threads succeeded: {results}"
         assert not errors, f"Errors occurred in threads: {errors}"
-        # After all threads, MOVING event should have been handled safely
+        # After all threads, MOVING notification should have been handled safely
         Helpers.validate_conn_kwargs(
             pool=test_redis_client.connection_pool,
             expected_maintenance_state=MaintenanceState.MOVING,
-            expected_maintenance_event_hash=hash(MOVING_EVENT),
+            expected_maintenance_notification_hash=hash(MOVING_NOTIFICATION),
             expected_host_address=AFTER_MOVING_ADDRESS.split(":")[0],
             expected_port=int(DEFAULT_ADDRESS.split(":")[1]),
-            expected_socket_timeout=self.config.relax_timeout,
-            expected_socket_connect_timeout=self.config.relax_timeout,
+            expected_socket_timeout=self.config.relaxed_timeout,
+            expected_socket_connect_timeout=self.config.relaxed_timeout,
             expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
             expected_orig_socket_timeout=None,
             expected_orig_socket_connect_timeout=None,
@@ -1717,17 +1719,17 @@ def worker(idx):
     @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
     def test_moving_migrating_migrated_moved_state_transitions(self, pool_class):
         """
-        Test moving configs are not lost if the per connection events get picked up after moving is handled.
-        Sequence of events: MOVING, MIGRATING, MIGRATED, FAILING_OVER, FAILED_OVER, MOVED.
-        Note: FAILING_OVER and FAILED_OVER events do not change the connection state when already in MOVING state.
-        Checks the state after each event for all connections and for new connections created during each state.
+        Test moving configs are not lost if the per connection notifications get picked up after moving is handled.
+        Sequence of notifications: MOVING, MIGRATING, MIGRATED, FAILING_OVER, FAILED_OVER, MOVED.
+        Note: FAILING_OVER and FAILED_OVER notifications do not change the connection state when already in MOVING state.
+        Checks the state after each notification for all connections and for new connections created during each state.
         """
         # Setup
         test_redis_client = self._get_client(
             pool_class, max_connections=5, setup_pool_handler=True
         )
         pool = test_redis_client.connection_pool
-        pool_handler = pool.connection_kwargs["maintenance_events_pool_handler"]
+        pool_handler = pool.connection_kwargs["maint_notifications_pool_handler"]
 
         # Create and release some connections
         in_use_connections = []
@@ -1745,23 +1747,23 @@ def test_moving_migrating_migrated_moved_state_transitions(self, pool_class):
             conn = pool.get_connection()
             in_use_connections.append(conn)
 
-        # 1. MOVING event
+        # 1. MOVING notification
         tmp_address = "22.23.24.25"
-        moving_event = NodeMovingEvent(
+        moving_notification = NodeMovingNotification(
             id=1, new_node_host=tmp_address, new_node_port=6379, ttl=1
         )
-        pool_handler.handle_event(moving_event)
+        pool_handler.handle_notification(moving_notification)
 
         Helpers.validate_in_use_connections_state(
             in_use_connections,
             expected_state=MaintenanceState.MOVING,
             expected_host_address=tmp_address,
-            expected_socket_timeout=self.config.relax_timeout,
-            expected_socket_connect_timeout=self.config.relax_timeout,
+            expected_socket_timeout=self.config.relaxed_timeout,
+            expected_socket_connect_timeout=self.config.relaxed_timeout,
             expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
             expected_orig_socket_timeout=None,
             expected_orig_socket_connect_timeout=None,
-            expected_current_socket_timeout=self.config.relax_timeout,
+            expected_current_socket_timeout=self.config.relaxed_timeout,
             expected_current_peername=DEFAULT_ADDRESS.split(":")[0],
         )
         Helpers.validate_free_connections_state(
@@ -1770,90 +1772,90 @@ def test_moving_migrating_migrated_moved_state_transitions(self, pool_class):
             connected_to_tmp_address=False,
             expected_state=MaintenanceState.MOVING,
             expected_host_address=tmp_address,
-            expected_socket_timeout=self.config.relax_timeout,
-            expected_socket_connect_timeout=self.config.relax_timeout,
+            expected_socket_timeout=self.config.relaxed_timeout,
+            expected_socket_connect_timeout=self.config.relaxed_timeout,
             expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
             expected_orig_socket_timeout=None,
             expected_orig_socket_connect_timeout=None,
         )
 
-        # 2. MIGRATING event (simulate direct connection handler call)
+        # 2. MIGRATING notification (simulate direct connection handler call)
         for conn in in_use_connections:
-            conn._maintenance_event_connection_handler.handle_event(
-                NodeMigratingEvent(id=2, ttl=1)
+            conn._maint_notifications_connection_handler.handle_notification(
+                NodeMigratingNotification(id=2, ttl=1)
             )
         Helpers.validate_in_use_connections_state(
             in_use_connections,
             expected_state=MaintenanceState.MOVING,
             expected_host_address=tmp_address,
-            expected_socket_timeout=self.config.relax_timeout,
-            expected_socket_connect_timeout=self.config.relax_timeout,
+            expected_socket_timeout=self.config.relaxed_timeout,
+            expected_socket_connect_timeout=self.config.relaxed_timeout,
             expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
             expected_orig_socket_timeout=None,
             expected_orig_socket_connect_timeout=None,
-            expected_current_socket_timeout=self.config.relax_timeout,
+            expected_current_socket_timeout=self.config.relaxed_timeout,
             expected_current_peername=DEFAULT_ADDRESS.split(":")[0],
         )
 
-        # 3. MIGRATED event (simulate direct connection handler call)
+        # 3. MIGRATED notification (simulate direct connection handler call)
         for conn in in_use_connections:
-            conn._maintenance_event_connection_handler.handle_event(
-                NodeMigratedEvent(id=2)
+            conn._maint_notifications_connection_handler.handle_notification(
+                NodeMigratedNotification(id=2)
             )
         # State should not change for connections that are in MOVING state
         Helpers.validate_in_use_connections_state(
             in_use_connections,
             expected_state=MaintenanceState.MOVING,
             expected_host_address=tmp_address,
-            expected_socket_timeout=self.config.relax_timeout,
-            expected_socket_connect_timeout=self.config.relax_timeout,
+            expected_socket_timeout=self.config.relaxed_timeout,
+            expected_socket_connect_timeout=self.config.relaxed_timeout,
             expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
             expected_orig_socket_timeout=None,
             expected_orig_socket_connect_timeout=None,
-            expected_current_socket_timeout=self.config.relax_timeout,
+            expected_current_socket_timeout=self.config.relaxed_timeout,
             expected_current_peername=DEFAULT_ADDRESS.split(":")[0],
         )
 
-        # 4. FAILING_OVER event (simulate direct connection handler call)
+        # 4. FAILING_OVER notification (simulate direct connection handler call)
         for conn in in_use_connections:
-            conn._maintenance_event_connection_handler.handle_event(
-                NodeFailingOverEvent(id=3, ttl=1)
+            conn._maint_notifications_connection_handler.handle_notification(
+                NodeFailingOverNotification(id=3, ttl=1)
             )
         # State should not change for connections that are in MOVING state
         Helpers.validate_in_use_connections_state(
             in_use_connections,
             expected_state=MaintenanceState.MOVING,
             expected_host_address=tmp_address,
-            expected_socket_timeout=self.config.relax_timeout,
-            expected_socket_connect_timeout=self.config.relax_timeout,
+            expected_socket_timeout=self.config.relaxed_timeout,
+            expected_socket_connect_timeout=self.config.relaxed_timeout,
             expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
             expected_orig_socket_timeout=None,
             expected_orig_socket_connect_timeout=None,
-            expected_current_socket_timeout=self.config.relax_timeout,
+            expected_current_socket_timeout=self.config.relaxed_timeout,
             expected_current_peername=DEFAULT_ADDRESS.split(":")[0],
         )
 
-        # 5. FAILED_OVER event (simulate direct connection handler call)
+        # 5. FAILED_OVER notification (simulate direct connection handler call)
         for conn in in_use_connections:
-            conn._maintenance_event_connection_handler.handle_event(
-                NodeFailedOverEvent(id=3)
+            conn._maint_notifications_connection_handler.handle_notification(
+                NodeFailedOverNotification(id=3)
             )
         # State should not change for connections that are in MOVING state
         Helpers.validate_in_use_connections_state(
             in_use_connections,
             expected_state=MaintenanceState.MOVING,
             expected_host_address=tmp_address,
-            expected_socket_timeout=self.config.relax_timeout,
-            expected_socket_connect_timeout=self.config.relax_timeout,
+            expected_socket_timeout=self.config.relaxed_timeout,
+            expected_socket_connect_timeout=self.config.relaxed_timeout,
             expected_orig_host_address=DEFAULT_ADDRESS.split(":")[0],
             expected_orig_socket_timeout=None,
             expected_orig_socket_connect_timeout=None,
-            expected_current_socket_timeout=self.config.relax_timeout,
+            expected_current_socket_timeout=self.config.relaxed_timeout,
             expected_current_peername=DEFAULT_ADDRESS.split(":")[0],
         )
 
-        # 6. MOVED event (simulate timer expiry)
-        pool_handler.handle_node_moved_event(moving_event)
+        # 6. MOVED notification (simulate timer expiry)
+        pool_handler.handle_node_moved_notification(moving_notification)
         Helpers.validate_in_use_connections_state(
             in_use_connections,
             expected_state=MaintenanceState.NONE,
@@ -1889,8 +1891,8 @@ def test_moving_migrating_migrated_moved_state_transitions(self, pool_class):
             pool.disconnect()
 
 
-class TestMaintenanceEventsHandlingMultipleProxies:
-    """Integration tests for maintenance events handling with real connection pool."""
+class TestMaintenanceNotificationsHandlingMultipleProxies:
+    """Integration tests for maintenance notifications handling with real connection pool."""
 
     def setup_method(self):
         """Set up test fixtures with mocked sockets."""
@@ -1950,9 +1952,9 @@ def mock_socket_getaddrinfo(host, port, family=0, type=0, proto=0, flags=0):
         )
         self.getaddrinfo_patcher.start()
 
-        # Create maintenance events config
-        self.config = MaintenanceEventsConfig(
-            enabled=True, proactive_reconnect=True, relax_timeout=30
+        # Create maintenance notifications config
+        self.config = MaintNotificationsConfig(
+            enabled=True, proactive_reconnect=True, relaxed_timeout=30
         )
 
     def teardown_method(self):
@@ -1970,13 +1972,13 @@ def test_migrating_after_moving_multiple_proxies(self, pool_class):
             host=self.orig_host,
             port=12345,
             max_connections=10,
-            protocol=3,  # Required for maintenance events
-            maintenance_events_config=self.config,
+            protocol=3,  # Required for maintenance notifications
+            maint_notifications_config=self.config,
         )
-        pool.set_maintenance_events_pool_handler(
-            MaintenanceEventPoolHandler(pool, self.config)
+        pool.set_maint_notifications_pool_handler(
+            MaintNotificationsPoolHandler(pool, self.config)
         )
-        pool_handler = pool.connection_kwargs["maintenance_events_pool_handler"]
+        pool_handler = pool.connection_kwargs["maint_notifications_pool_handler"]
 
         # Create and release some connections
         key1 = "1.2.3.4"
@@ -1992,12 +1994,14 @@ def test_migrating_after_moving_multiple_proxies(self, pool_class):
             while len(conns) > 1:
                 pool.release(conns.pop())
 
-        # Send MOVING event to con with ip = key1
+        # Send MOVING notification to con with ip = key1
         conn = in_use_connections[key1][0]
         pool_handler.set_connection(conn)
         new_ip = "13.14.15.16"
-        pool_handler.handle_event(
-            NodeMovingEvent(id=1, new_node_host=new_ip, new_node_port=6379, ttl=1)
+        pool_handler.handle_notification(
+            NodeMovingNotification(
+                id=1, new_node_host=new_ip, new_node_port=6379, ttl=1
+            )
         )
 
         # validate in use connection and ip1
@@ -2005,12 +2009,12 @@ def test_migrating_after_moving_multiple_proxies(self, pool_class):
             in_use_connections[key1],
             expected_state=MaintenanceState.MOVING,
             expected_host_address=new_ip,
-            expected_socket_timeout=self.config.relax_timeout,
-            expected_socket_connect_timeout=self.config.relax_timeout,
+            expected_socket_timeout=self.config.relaxed_timeout,
+            expected_socket_connect_timeout=self.config.relaxed_timeout,
             expected_orig_host_address=self.orig_host,
             expected_orig_socket_timeout=None,
             expected_orig_socket_connect_timeout=None,
-            expected_current_socket_timeout=self.config.relax_timeout,
+            expected_current_socket_timeout=self.config.relaxed_timeout,
             expected_current_peername=key1,
         )
         # validate free connections for ip1
@@ -2024,8 +2028,8 @@ def test_migrating_after_moving_multiple_proxies(self, pool_class):
                 changed_free_connections += 1
                 assert conn.maintenance_state == MaintenanceState.MOVING
                 assert conn.host == new_ip
-                assert conn.socket_timeout == self.config.relax_timeout
-                assert conn.socket_connect_timeout == self.config.relax_timeout
+                assert conn.socket_timeout == self.config.relaxed_timeout
+                assert conn.socket_connect_timeout == self.config.relaxed_timeout
                 assert conn.orig_host_address == self.orig_host
                 assert conn.orig_socket_timeout is None
                 assert conn.orig_socket_connect_timeout is None
@@ -2040,12 +2044,14 @@ def test_migrating_after_moving_multiple_proxies(self, pool_class):
         assert changed_free_connections == 2
         assert len(free_connections) == 4
 
-        # Send second MOVING event to con with ip = key2
+        # Send second MOVING notification to con with ip = key2
         conn = in_use_connections[key2][0]
         pool_handler.set_connection(conn)
         new_ip_2 = "17.18.19.20"
-        pool_handler.handle_event(
-            NodeMovingEvent(id=2, new_node_host=new_ip_2, new_node_port=6379, ttl=2)
+        pool_handler.handle_notification(
+            NodeMovingNotification(
+                id=2, new_node_host=new_ip_2, new_node_port=6379, ttl=2
+            )
         )
 
         # validate in use connection and ip2
@@ -2053,12 +2059,12 @@ def test_migrating_after_moving_multiple_proxies(self, pool_class):
             in_use_connections[key2],
             expected_state=MaintenanceState.MOVING,
             expected_host_address=new_ip_2,
-            expected_socket_timeout=self.config.relax_timeout,
-            expected_socket_connect_timeout=self.config.relax_timeout,
+            expected_socket_timeout=self.config.relaxed_timeout,
+            expected_socket_connect_timeout=self.config.relaxed_timeout,
             expected_orig_host_address=self.orig_host,
             expected_orig_socket_timeout=None,
             expected_orig_socket_connect_timeout=None,
-            expected_current_socket_timeout=self.config.relax_timeout,
+            expected_current_socket_timeout=self.config.relaxed_timeout,
             expected_current_peername=key2,
         )
         # validate free connections for ip2
@@ -2072,46 +2078,50 @@ def test_migrating_after_moving_multiple_proxies(self, pool_class):
                 changed_free_connections += 1
                 assert conn.maintenance_state == MaintenanceState.MOVING
                 assert conn.host == new_ip_2
-                assert conn.socket_timeout == self.config.relax_timeout
-                assert conn.socket_connect_timeout == self.config.relax_timeout
+                assert conn.socket_timeout == self.config.relaxed_timeout
+                assert conn.socket_connect_timeout == self.config.relaxed_timeout
                 assert conn.orig_host_address == self.orig_host
                 assert conn.orig_socket_timeout is None
                 assert conn.orig_socket_connect_timeout is None
             # here I can't validate the other connections since some of
-            # them are in MOVING state from the first event
+            # them are in MOVING state from the first notification
             # and some are in NONE state
         assert changed_free_connections == 1
 
-        # MIGRATING event on connection that has already been marked as MOVING
+        # MIGRATING notification on connection that has already been marked as MOVING
         conn = in_use_connections[key2][0]
-        conn_event_handler = conn._maintenance_event_connection_handler
-        conn_event_handler.handle_event(NodeMigratingEvent(id=3, ttl=1))
+        conn_notification_handler = conn._maint_notifications_connection_handler
+        conn_notification_handler.handle_notification(
+            NodeMigratingNotification(id=3, ttl=1)
+        )
         # validate connection does not lose its MOVING state
         assert conn.maintenance_state == MaintenanceState.MOVING
-        # MIGRATED event
-        conn_event_handler.handle_event(NodeMigratedEvent(id=3))
-        # validate connection does not lose its MOVING state and relax timeout
+        # MIGRATED notification
+        conn_notification_handler.handle_notification(NodeMigratedNotification(id=3))
+        # validate connection does not lose its MOVING state and relaxed timeout
         assert conn.maintenance_state == MaintenanceState.MOVING
-        assert conn.socket_timeout == self.config.relax_timeout
+        assert conn.socket_timeout == self.config.relaxed_timeout
 
-        # Send Migrating event to con with ip = key3
+        # Send Migrating notification to con with ip = key3
         conn = in_use_connections[key3][0]
-        conn_event_handler = conn._maintenance_event_connection_handler
-        conn_event_handler.handle_event(NodeMigratingEvent(id=3, ttl=1))
+        conn_notification_handler = conn._maint_notifications_connection_handler
+        conn_notification_handler.handle_notification(
+            NodeMigratingNotification(id=3, ttl=1)
+        )
         # validate connection is in MIGRATING state
         assert conn.maintenance_state == MaintenanceState.MAINTENANCE
 
-        assert conn.socket_timeout == self.config.relax_timeout
+        assert conn.socket_timeout == self.config.relaxed_timeout
 
-        # Send MIGRATED event to con with ip = key3
-        conn_event_handler.handle_event(NodeMigratedEvent(id=3))
+        # Send MIGRATED notification to con with ip = key3
+        conn_notification_handler.handle_notification(NodeMigratedNotification(id=3))
         # validate connection is in MOVING state
         assert conn.maintenance_state == MaintenanceState.NONE
         assert conn.socket_timeout is None
 
-        # sleep to expire only the first MOVING events
+        # sleep to expire only the first MOVING notifications
         sleep(1.3)
-        # validate only the connections affected by the first MOVING event
+        # validate only the connections affected by the first MOVING notification
         # have lost their MOVING state
         Helpers.validate_in_use_connections_state(
             in_use_connections[key1],
@@ -2129,12 +2139,12 @@ def test_migrating_after_moving_multiple_proxies(self, pool_class):
             in_use_connections[key2],
             expected_state=MaintenanceState.MOVING,
             expected_host_address=new_ip_2,
-            expected_socket_timeout=self.config.relax_timeout,
-            expected_socket_connect_timeout=self.config.relax_timeout,
+            expected_socket_timeout=self.config.relaxed_timeout,
+            expected_socket_connect_timeout=self.config.relaxed_timeout,
             expected_orig_host_address=self.orig_host,
             expected_orig_socket_timeout=None,
             expected_orig_socket_connect_timeout=None,
-            expected_current_socket_timeout=self.config.relax_timeout,
+            expected_current_socket_timeout=self.config.relaxed_timeout,
             expected_current_peername=key2,
         )
         Helpers.validate_in_use_connections_state(
@@ -2152,7 +2162,7 @@ def test_migrating_after_moving_multiple_proxies(self, pool_class):
         )
         # TODO validate free connections
 
-        # sleep to expire the second MOVING events
+        # sleep to expire the second MOVING notifications
         sleep(1)
         # validate all connections have lost their MOVING state
         Helpers.validate_in_use_connections_state(
diff --git a/tests/test_scenario/conftest.py b/tests/test_scenario/conftest.py
index 805941bbaf..afc4f5df1c 100644
--- a/tests/test_scenario/conftest.py
+++ b/tests/test_scenario/conftest.py
@@ -7,11 +7,11 @@
 
 from redis.backoff import ExponentialWithJitterBackoff, NoBackoff
 from redis.client import Redis
-from redis.maintenance_events import EndpointType, MaintenanceEventsConfig
+from redis.maintenance_events import EndpointType, MaintNotificationsConfig
 from redis.retry import Retry
 from tests.test_scenario.fault_injector_client import FaultInjectorClient
 
-RELAX_TIMEOUT = 30
+RELAXED_TIMEOUT = 30
 CLIENT_TIMEOUT = 5
 
 DEFAULT_ENDPOINT_NAME = "m-standard"
@@ -49,22 +49,22 @@ def fault_injector_client():
 
 
 @pytest.fixture()
-def client_maint_events(endpoints_config):
-    return _get_client_maint_events(endpoints_config)
+def client_maint_notifications(endpoints_config):
+    return _get_client_maint_notifications(endpoints_config)
 
 
-def _get_client_maint_events(
+def _get_client_maint_notifications(
     endpoints_config,
     protocol: int = 3,
-    enable_maintenance_events: bool = True,
+    enable_maintenance_notifications: bool = True,
     endpoint_type: Optional[EndpointType] = None,
-    enable_relax_timeout: bool = True,
+    enable_relaxed_timeout: bool = True,
     enable_proactive_reconnect: bool = True,
     disable_retries: bool = False,
     socket_timeout: Optional[float] = None,
     host_config: Optional[str] = None,
 ):
-    """Create Redis client with maintenance events enabled."""
+    """Create Redis client with maintenance notifications enabled."""
 
     # Get credentials from the configuration
     username = endpoints_config.get("username")
@@ -84,16 +84,16 @@ def _get_client_maint_events(
 
     logging.info(f"Connecting to Redis Enterprise: {host}:{port} with user: {username}")
 
-    # Configure maintenance events
-    maintenance_config = MaintenanceEventsConfig(
-        enabled=enable_maintenance_events,
+    # Configure maintenance notifications
+    maintenance_config = MaintNotificationsConfig(
+        enabled=enable_maintenance_notifications,
         proactive_reconnect=enable_proactive_reconnect,
-        relax_timeout=RELAX_TIMEOUT if enable_relax_timeout else -1,
+        relaxed_timeout=RELAXED_TIMEOUT if enable_relaxed_timeout else -1,
         endpoint_type=endpoint_type,
     )
 
-    # Create Redis client with maintenance events config
-    # This will automatically create the MaintenanceEventPoolHandler
+    # Create Redis client with maintenance notifications config
+    # This will automatically create the MaintNotificationsPoolHandler
     if disable_retries:
         retry = Retry(NoBackoff(), 0)
     else:
@@ -112,12 +112,14 @@ def _get_client_maint_events(
         ssl_cert_reqs="none",
         ssl_check_hostname=False,
         protocol=protocol,  # RESP3 required for push notifications
-        maintenance_events_config=maintenance_config,
+        maint_notifications_config=maintenance_config,
         retry=retry,
     )
-    logging.info("Redis client created with maintenance events enabled")
+    logging.info("Redis client created with maintenance notifications enabled")
     logging.info(f"Client uses Protocol: {client.connection_pool.get_protocol()}")
-    maintenance_handler_exists = client.maintenance_events_pool_handler is not None
-    logging.info(f"Maintenance events pool handler: {maintenance_handler_exists}")
+    maintenance_handler_exists = client.maint_notifications_pool_handler is not None
+    logging.info(
+        f"Maintenance notifications pool handler: {maintenance_handler_exists}"
+    )
 
     return client
diff --git a/tests/test_scenario/test_hitless_upgrade.py b/tests/test_scenario/test_hitless_upgrade.py
index f23be4d4b2..601b4b5a18 100644
--- a/tests/test_scenario/test_hitless_upgrade.py
+++ b/tests/test_scenario/test_hitless_upgrade.py
@@ -14,13 +14,13 @@
 from redis.connection import ConnectionInterface
 from redis.maintenance_events import (
     EndpointType,
-    MaintenanceEventsConfig,
+    MaintNotificationsConfig,
     MaintenanceState,
 )
 from tests.test_scenario.conftest import (
     CLIENT_TIMEOUT,
-    RELAX_TIMEOUT,
-    _get_client_maint_events,
+    RELAXED_TIMEOUT,
+    _get_client_maint_notifications,
 )
 from tests.test_scenario.fault_injector_client import (
     FaultInjectorClient,
@@ -51,7 +51,7 @@ class TestPushNotifications:
     @pytest.fixture(autouse=True)
     def setup_and_cleanup(
         self,
-        client_maint_events: Redis,
+        client_maint_notifications: Redis,
         fault_injector_client: FaultInjectorClient,
         endpoints_config: Dict[str, Any],
         endpoint_name: str,
@@ -96,7 +96,7 @@ def setup_and_cleanup(
         # Cleanup code - this will run even if the test fails
         logging.info("Starting cleanup...")
         try:
-            client_maint_events.close()
+            client_maint_notifications.close()
         except Exception as e:
             logging.error(f"Failed to close client: {e}")
 
@@ -227,7 +227,7 @@ def _validate_maintenance_state(
         for conn in connections:
             if (
                 conn._sock is not None
-                and conn._sock.gettimeout() == RELAX_TIMEOUT
+                and conn._sock.gettimeout() == RELAXED_TIMEOUT
                 and conn.maintenance_state == MaintenanceState.MAINTENANCE
             ):
                 matching_conns_count += 1
@@ -255,13 +255,13 @@ def _validate_moving_state(
                     and conn.host != conn.orig_host_address
                     and (
                         configured_endpoint_type
-                        == MaintenanceEventsConfig().get_endpoint_type(conn.host, conn)
+                        == MaintNotificationsConfig().get_endpoint_type(conn.host, conn)
                     )
                 )
             )
             if (
                 conn._sock is not None
-                and conn._sock.gettimeout() == RELAX_TIMEOUT
+                and conn._sock.gettimeout() == RELAXED_TIMEOUT
                 and conn.maintenance_state == MaintenanceState.MOVING
                 and endpoint_configured_correctly
             ):
@@ -269,7 +269,7 @@ def _validate_moving_state(
             elif (
                 conn._sock is None
                 and conn.maintenance_state == MaintenanceState.MOVING
-                and conn.socket_timeout == RELAX_TIMEOUT
+                and conn.socket_timeout == RELAXED_TIMEOUT
                 and endpoint_configured_correctly
             ):
                 matching_disconnected_conns_count += 1
@@ -330,7 +330,7 @@ def _validate_default_notif_disabled_state(
     @pytest.mark.timeout(300)  # 5 minutes timeout for this test
     def test_receive_failing_over_and_failed_over_push_notification(
         self,
-        client_maint_events: Redis,
+        client_maint_notifications: Redis,
         fault_injector_client: FaultInjectorClient,
         endpoints_config: Dict[str, Any],
     ):
@@ -339,7 +339,7 @@ def test_receive_failing_over_and_failed_over_push_notification(
 
         """
         logging.info("Creating one connection in the pool.")
-        conn = client_maint_events.connection_pool.get_connection()
+        conn = client_maint_notifications.connection_pool.get_connection()
 
         logging.info("Executing failover command...")
         failover_thread = Thread(
@@ -351,16 +351,16 @@ def test_receive_failing_over_and_failed_over_push_notification(
 
         logging.info("Waiting for FAILING_OVER push notifications...")
         ClientValidations.wait_push_notification(
-            client_maint_events, timeout=FAILOVER_TIMEOUT, connection=conn
+            client_maint_notifications, timeout=FAILOVER_TIMEOUT, connection=conn
         )
 
         logging.info("Validating connection maintenance state...")
         assert conn.maintenance_state == MaintenanceState.MAINTENANCE
-        assert conn._sock.gettimeout() == RELAX_TIMEOUT
+        assert conn._sock.gettimeout() == RELAXED_TIMEOUT
 
         logging.info("Waiting for FAILED_OVER push notifications...")
         ClientValidations.wait_push_notification(
-            client_maint_events, timeout=FAILOVER_TIMEOUT, connection=conn
+            client_maint_notifications, timeout=FAILOVER_TIMEOUT, connection=conn
         )
 
         logging.info("Validating connection default states is restored...")
@@ -368,14 +368,14 @@ def test_receive_failing_over_and_failed_over_push_notification(
         assert conn._sock.gettimeout() == CLIENT_TIMEOUT
 
         logging.info("Releasing connection back to the pool...")
-        client_maint_events.connection_pool.release(conn)
+        client_maint_notifications.connection_pool.release(conn)
 
         failover_thread.join()
 
     @pytest.mark.timeout(300)  # 5 minutes timeout for this test
     def test_receive_migrating_and_moving_push_notification(
         self,
-        client_maint_events: Redis,
+        client_maint_notifications: Redis,
         fault_injector_client: FaultInjectorClient,
         endpoints_config: Dict[str, Any],
     ):
@@ -399,25 +399,25 @@ def test_receive_migrating_and_moving_push_notification(
 
         logging.info("Waiting for MIGRATING push notifications...")
         ClientValidations.wait_push_notification(
-            client_maint_events, timeout=MIGRATE_TIMEOUT
+            client_maint_notifications, timeout=MIGRATE_TIMEOUT
         )
 
         logging.info("Validating connection migrating state...")
-        conn = client_maint_events.connection_pool.get_connection()
+        conn = client_maint_notifications.connection_pool.get_connection()
         assert conn.maintenance_state == MaintenanceState.MAINTENANCE
-        assert conn._sock.gettimeout() == RELAX_TIMEOUT
-        client_maint_events.connection_pool.release(conn)
+        assert conn._sock.gettimeout() == RELAXED_TIMEOUT
+        client_maint_notifications.connection_pool.release(conn)
 
         logging.info("Waiting for MIGRATED push notifications...")
         ClientValidations.wait_push_notification(
-            client_maint_events, timeout=MIGRATE_TIMEOUT
+            client_maint_notifications, timeout=MIGRATE_TIMEOUT
         )
 
         logging.info("Validating connection states...")
-        conn = client_maint_events.connection_pool.get_connection()
+        conn = client_maint_notifications.connection_pool.get_connection()
         assert conn.maintenance_state == MaintenanceState.NONE
         assert conn._sock.gettimeout() == CLIENT_TIMEOUT
-        client_maint_events.connection_pool.release(conn)
+        client_maint_notifications.connection_pool.release(conn)
 
         migrate_thread.join()
 
@@ -432,13 +432,13 @@ def test_receive_migrating_and_moving_push_notification(
 
         logging.info("Waiting for MOVING push notifications...")
         ClientValidations.wait_push_notification(
-            client_maint_events, timeout=BIND_TIMEOUT
+            client_maint_notifications, timeout=BIND_TIMEOUT
         )
 
         logging.info("Validating connection states...")
-        conn = client_maint_events.connection_pool.get_connection()
+        conn = client_maint_notifications.connection_pool.get_connection()
         assert conn.maintenance_state == MaintenanceState.MOVING
-        assert conn._sock.gettimeout() == RELAX_TIMEOUT
+        assert conn._sock.gettimeout() == RELAXED_TIMEOUT
 
         logging.info("Waiting for moving ttl to expire")
         time.sleep(BIND_TIMEOUT)
@@ -447,7 +447,7 @@ def test_receive_migrating_and_moving_push_notification(
         assert conn.maintenance_state == MaintenanceState.NONE
         assert conn.socket_timeout == CLIENT_TIMEOUT
         assert conn._sock.gettimeout() == CLIENT_TIMEOUT
-        client_maint_events.connection_pool.release(conn)
+        client_maint_notifications.connection_pool.release(conn)
         bind_thread.join()
 
     @pytest.mark.timeout(300)  # 5 minutes timeout
@@ -470,7 +470,7 @@ def test_timeout_handling_during_migrating_and_moving(
 
         """
         logging.info(f"Testing timeout handling for endpoint type: {endpoint_type}")
-        client = _get_client_maint_events(
+        client = _get_client_maint_notifications(
             endpoints_config=endpoints_config, endpoint_type=endpoint_type
         )
 
@@ -542,7 +542,7 @@ def test_timeout_handling_during_migrating_and_moving(
             expected_matching_disconnected_conns_count=3,
         )
         # during get_connection() the connection will be reconnected
-        # either to the address provided in the moving event or to the original address
+        # either to the address provided in the moving notification or to the original address
         # depending on the configured endpoint type
         # with this call we test if we are able to connect to the new address
         conn = client.connection_pool.get_connection()
@@ -577,7 +577,7 @@ def test_connection_handling_during_moving(
         endpoints_config: Dict[str, Any],
     ):
         logging.info(f"Testing timeout handling for endpoint type: {endpoint_type}")
-        client = _get_client_maint_events(
+        client = _get_client_maint_notifications(
             endpoints_config=endpoints_config, endpoint_type=endpoint_type
         )
 
@@ -637,7 +637,7 @@ def test_connection_handling_during_moving(
             )
             time.sleep(8)
 
-        # validate that new connections will also receive the moving event
+        # validate that new connections will also receive the moving notification
         connections = []
         for _ in range(3):
             connections.append(client.connection_pool.get_connection())
@@ -646,7 +646,7 @@ def test_connection_handling_during_moving(
 
         logging.info("Validating connections states during MOVING ...")
         # during get_connection() the existing connection will be reconnected
-        # either to the address provided in the moving event or to the original address
+        # either to the address provided in the moving notification or to the original address
         # depending on the configured endpoint type
         # with this call we test if we are able to connect to the new address
         # new connection should also be marked as moving
@@ -675,7 +675,7 @@ def test_old_connection_shutdown_during_moving(
         # and connected to the new address
         endpoint_type = EndpointType.EXTERNAL_IP
         logging.info("Testing old connection shutdown during MOVING")
-        client = _get_client_maint_events(
+        client = _get_client_maint_notifications(
             endpoints_config=endpoints_config, endpoint_type=endpoint_type
         )
 
@@ -753,12 +753,12 @@ def execute_commands(moving_event: threading.Event, errors: Queue):
             if conn._sock is not None:
                 assert conn.get_resolved_ip() == conn.host
                 assert conn.maintenance_state == MaintenanceState.MOVING
-                assert conn._sock.gettimeout() == RELAX_TIMEOUT
+                assert conn._sock.gettimeout() == RELAXED_TIMEOUT
                 assert conn.host != conn.orig_host_address
                 assert not conn.should_reconnect()
             else:
                 assert conn.maintenance_state == MaintenanceState.MOVING
-                assert conn.socket_timeout == RELAX_TIMEOUT
+                assert conn.socket_timeout == RELAXED_TIMEOUT
                 assert conn.host != conn.orig_host_address
                 assert not conn.should_reconnect()
 
@@ -772,12 +772,12 @@ def execute_commands(moving_event: threading.Event, errors: Queue):
     @pytest.mark.timeout(300)  # 5 minutes timeout
     def test_new_connections_receive_moving(
         self,
-        client_maint_events: Redis,
+        client_maint_notifications: Redis,
         fault_injector_client: FaultInjectorClient,
         endpoints_config: Dict[str, Any],
     ):
         logging.info("Creating one connection in the pool.")
-        first_conn = client_maint_events.connection_pool.get_connection()
+        first_conn = client_maint_notifications.connection_pool.get_connection()
 
         logging.info("Executing rladmin migrate command...")
         migrate_thread = Thread(
@@ -795,16 +795,16 @@ def test_new_connections_receive_moving(
         logging.info("Waiting for MIGRATING push notifications...")
         # this will consume the notification in the provided connection
         ClientValidations.wait_push_notification(
-            client_maint_events, timeout=MIGRATE_TIMEOUT, connection=first_conn
+            client_maint_notifications, timeout=MIGRATE_TIMEOUT, connection=first_conn
         )
 
         self._validate_maintenance_state(
-            client_maint_events, expected_matching_conns_count=1
+            client_maint_notifications, expected_matching_conns_count=1
         )
 
         logging.info("Waiting for MIGRATED push notifications on both connections ...")
         ClientValidations.wait_push_notification(
-            client_maint_events, timeout=MIGRATE_TIMEOUT, connection=first_conn
+            client_maint_notifications, timeout=MIGRATE_TIMEOUT, connection=first_conn
         )
 
         migrate_thread.join()
@@ -820,18 +820,18 @@ def test_new_connections_receive_moving(
 
         logging.info("Waiting for MOVING push notifications on random connection ...")
         ClientValidations.wait_push_notification(
-            client_maint_events, timeout=BIND_TIMEOUT, connection=first_conn
+            client_maint_notifications, timeout=BIND_TIMEOUT, connection=first_conn
         )
 
         old_address = first_conn._sock.getpeername()[0]
         logging.info(f"The node address before bind: {old_address}")
         logging.info(
-            "Creating new client to connect to the same node - new connections to this node should receive the moving event..."
+            "Creating new client to connect to the same node - new connections to this node should receive the moving notification..."
         )
 
         endpoint_type = EndpointType.EXTERNAL_IP
-        # create new client with new pool that should also receive the moving event
-        new_client = _get_client_maint_events(
+        # create new client with new pool that should also receive the moving notification
+        new_client = _get_client_maint_notifications(
             endpoints_config=endpoints_config,
             endpoint_type=endpoint_type,
             host_config=old_address,
@@ -841,7 +841,7 @@ def test_new_connections_receive_moving(
         # part of the client connection setup, so we don't need
         # to wait for it explicitly with wait_push_notification
         logging.info(
-            "Creating one connection in the new pool that should receive the moving event."
+            "Creating one connection in the new pool that should receive the moving notification."
         )
         new_client_conn = new_client.connection_pool.get_connection()
 
@@ -859,17 +859,17 @@ def test_new_connections_receive_moving(
         new_client.connection_pool.release(new_client_conn)
         new_client.close()
 
-        client_maint_events.connection_pool.release(first_conn)
+        client_maint_notifications.connection_pool.release(first_conn)
 
     @pytest.mark.timeout(300)  # 5 minutes timeout
     def test_new_connections_receive_migrating(
         self,
-        client_maint_events: Redis,
+        client_maint_notifications: Redis,
         fault_injector_client: FaultInjectorClient,
         endpoints_config: Dict[str, Any],
     ):
         logging.info("Creating one connection in the pool.")
-        first_conn = client_maint_events.connection_pool.get_connection()
+        first_conn = client_maint_notifications.connection_pool.get_connection()
 
         logging.info("Executing rladmin migrate command...")
         migrate_thread = Thread(
@@ -887,35 +887,37 @@ def test_new_connections_receive_migrating(
         logging.info("Waiting for MIGRATING push notifications...")
         # this will consume the notification in the provided connection
         ClientValidations.wait_push_notification(
-            client_maint_events, timeout=MIGRATE_TIMEOUT, connection=first_conn
+            client_maint_notifications, timeout=MIGRATE_TIMEOUT, connection=first_conn
         )
 
         self._validate_maintenance_state(
-            client_maint_events, expected_matching_conns_count=1
+            client_maint_notifications, expected_matching_conns_count=1
         )
 
-        # validate that new connections will also receive the migrating event
+        # validate that new connections will also receive the migrating notification
         # it should be received as part of the client connection setup flow
         logging.info(
-            "Creating second connection that should receive the migrating event as well."
+            "Creating second connection that should receive the migrating notification as well."
         )
-        second_connection = client_maint_events.connection_pool.get_connection()
+        second_connection = client_maint_notifications.connection_pool.get_connection()
         self._validate_maintenance_state(
-            client_maint_events, expected_matching_conns_count=2
+            client_maint_notifications, expected_matching_conns_count=2
         )
 
         logging.info("Waiting for MIGRATED push notifications on both connections ...")
         ClientValidations.wait_push_notification(
-            client_maint_events, timeout=MIGRATE_TIMEOUT, connection=first_conn
+            client_maint_notifications, timeout=MIGRATE_TIMEOUT, connection=first_conn
         )
         ClientValidations.wait_push_notification(
-            client_maint_events, timeout=MIGRATE_TIMEOUT, connection=second_connection
+            client_maint_notifications,
+            timeout=MIGRATE_TIMEOUT,
+            connection=second_connection,
         )
 
         migrate_thread.join()
 
-        client_maint_events.connection_pool.release(first_conn)
-        client_maint_events.connection_pool.release(second_connection)
+        client_maint_notifications.connection_pool.release(first_conn)
+        client_maint_notifications.connection_pool.release(second_connection)
 
     @pytest.mark.timeout(300)
     def test_disabled_handling_during_migrating_and_moving(
@@ -924,9 +926,9 @@ def test_disabled_handling_during_migrating_and_moving(
         endpoints_config: Dict[str, Any],
     ):
         logging.info("Creating client with disabled notifications.")
-        client = _get_client_maint_events(
+        client = _get_client_maint_notifications(
             endpoints_config=endpoints_config,
-            enable_maintenance_events=False,
+            enable_maintenance_notifications=False,
         )
 
         logging.info("Creating one connection in the pool.")
@@ -955,7 +957,7 @@ def test_disabled_handling_during_migrating_and_moving(
             client, expected_matching_conns_count=1
         )
 
-        # validate that new connections will not receive the migrating event
+        # validate that new connections will also receive the moving notification
         logging.info(
             "Creating second connection in the pool"
             " and expect it not to receive the migrating as well."
@@ -1007,7 +1009,7 @@ def test_disabled_handling_during_migrating_and_moving(
             fail_on_timeout=False,
         )
 
-        # validate that new connections will also receive the moving event
+        # validate that new connections will also receive the moving notification
         connections = []
         for _ in range(3):
             connections.append(client.connection_pool.get_connection())
@@ -1044,23 +1046,23 @@ def test_command_execution_during_migrating_and_moving(
         endpoint_type: EndpointType,
     ):
         """
-        Test command execution during migrating and moving events.
+        Test command execution during migrating and moving notifications.
 
         This test validates that:
-        1. Commands can be executed during MIGRATING and MOVING events
-        2. Commands are not blocked by the events
+        1. Commands can be executed during MIGRATING and MOVING notifications
+        2. Commands are not blocked by the notifications
         3. Commands are executed successfully
         """
         errors = Queue()
         execution_duration = 180
         socket_timeout = 0.5
 
-        client = _get_client_maint_events(
+        client = _get_client_maint_notifications(
             endpoints_config=endpoints_config,
             endpoint_type=endpoint_type,
             disable_retries=True,
             socket_timeout=socket_timeout,
-            enable_maintenance_events=True,
+            enable_maintenance_notifications=True,
         )
 
         migrate_and_bind_thread = Thread(

From 2a464328b8fa1d4785d782b41e7fd630c5f63893 Mon Sep 17 00:00:00 2001
From: andy-stark-redis <164213578+andy-stark-redis@users.noreply.github.com>
Date: Wed, 24 Sep 2025 17:59:34 +0100
Subject: [PATCH 1119/1164] DOC-5743 BITOP examples (#3776)

Co-authored-by: petyaslavova <petya.slavova@redis.com>
---
 doctests/dt_bitmap.py | 119 +++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 117 insertions(+), 2 deletions(-)

diff --git a/doctests/dt_bitmap.py b/doctests/dt_bitmap.py
index a769c96863..056bf55515 100644
--- a/doctests/dt_bitmap.py
+++ b/doctests/dt_bitmap.py
@@ -6,11 +6,13 @@
 """
 import redis
 
-r = redis.Redis(decode_responses=True)
+# Connect without the usual `decode_responses=True` to
+# see the binary values in the responses more easily.
+r = redis.Redis()
 # HIDE_END
 
 # REMOVE_START
-r.delete("pings:2024-01-01-00:00")
+r.delete("pings:2024-01-01-00:00", "A", "B", "C", "R")
 # REMOVE_END
 
 # STEP_START ping
@@ -38,3 +40,116 @@
 # REMOVE_START
 assert res4 == 1
 # REMOVE_END
+
+# STEP_START bitop_setup
+r.setbit("A", 0, 1)
+r.setbit("A", 1, 1)
+r.setbit("A", 3, 1)
+r.setbit("A", 4, 1)
+
+res5 = r.get("A")
+print("{:08b}".format(int.from_bytes(res5, "big")))
+# >>> 11011000
+
+r.setbit("B", 3, 1)
+r.setbit("B", 4, 1)
+r.setbit("B", 7, 1)
+
+res6 = r.get("B")
+print("{:08b}".format(int.from_bytes(res6, "big")))
+# >>> 00011001
+
+r.setbit("C", 1, 1)
+r.setbit("C", 2, 1)
+r.setbit("C", 4, 1)
+r.setbit("C", 5, 1)
+
+res7 = r.get("C")
+print("{:08b}".format(int.from_bytes(res7, "big")))
+# >>> 01101100
+# STEP_END
+# REMOVE_START
+assert int.from_bytes(res5, "big") == 0b11011000
+assert int.from_bytes(res6, "big") == 0b00011001
+assert int.from_bytes(res7, "big") == 0b01101100
+# REMOVE_END
+
+# STEP_START bitop_and
+r.bitop("AND", "R", "A", "B", "C")
+res8 = r.get("R")
+print("{:08b}".format(int.from_bytes(res8, "big")))
+# >>> 00001000
+# STEP_END
+# REMOVE_START
+assert int.from_bytes(res8, "big") == 0b00001000
+# REMOVE_END
+
+# STEP_START bitop_or
+r.bitop("OR", "R", "A", "B", "C")
+res9 = r.get("R")
+print("{:08b}".format(int.from_bytes(res9, "big")))
+# >>> 11111101
+# STEP_END
+# REMOVE_START
+assert int.from_bytes(res9, "big") == 0b11111101
+# REMOVE_END
+
+# STEP_START bitop_xor
+r.bitop("XOR", "R", "A", "B")
+res10 = r.get("R")
+print("{:08b}".format(int.from_bytes(res10, "big")))
+# >>> 11000001
+# STEP_END
+# REMOVE_START
+assert int.from_bytes(res10, "big") == 0b11000001
+# REMOVE_END
+
+# STEP_START bitop_not
+r.bitop("NOT", "R", "A")
+res11 = r.get("R")
+print("{:08b}".format(int.from_bytes(res11, "big")))
+# >>> 00100111
+# STEP_END
+# REMOVE_START
+assert int.from_bytes(res11, "big") == 0b00100111
+# REMOVE_END
+
+# STEP_START bitop_diff
+r.bitop("DIFF", "R", "A", "B", "C")
+res12 = r.get("R")
+print("{:08b}".format(int.from_bytes(res12, "big")))
+# >>> 10000000
+# STEP_END
+# REMOVE_START
+assert int.from_bytes(res12, "big") == 0b10000000
+# REMOVE_END
+
+# STEP_START bitop_diff1
+r.bitop("DIFF1", "R", "A", "B", "C")
+res13 = r.get("R")
+print("{:08b}".format(int.from_bytes(res13, "big")))
+# >>> 00100101
+# STEP_END
+# REMOVE_START
+assert int.from_bytes(res13, "big") == 0b00100101
+# REMOVE_END
+
+# STEP_START bitop_andor
+r.bitop("ANDOR", "R", "A", "B", "C")
+res14 = r.get("R")
+print("{:08b}".format(int.from_bytes(res14, "big")))
+# >>> 01011000
+# STEP_END
+# REMOVE_START
+assert int.from_bytes(res14, "big") == 0b01011000
+# REMOVE_END
+
+# STEP_START bitop_one
+r.bitop("ONE", "R", "A", "B", "C")
+res15 = r.get("R")
+print("{:08b}".format(int.from_bytes(res15, "big")))
+# >>> 10100101
+# STEP_END
+# REMOVE_START
+assert int.from_bytes(res15, "big") == 0b10100101
+# REMOVE_END

From 1bc95998d8d2e4a6b29651bf7a050469ce7754c2 Mon Sep 17 00:00:00 2001
From: Elena Kolevska <elena-kolevska@users.noreply.github.com>
Date: Wed, 24 Sep 2025 19:26:41 +0100
Subject: [PATCH 1120/1164] Improve stale issue management workflow (#3773)

---
 .github/workflows/stale-issues.yml | 106 ++++++++++++++++++++++++-----
 1 file changed, 88 insertions(+), 18 deletions(-)

diff --git a/.github/workflows/stale-issues.yml b/.github/workflows/stale-issues.yml
index f3bc21bbf3..ba0fb5587e 100644
--- a/.github/workflows/stale-issues.yml
+++ b/.github/workflows/stale-issues.yml
@@ -1,25 +1,95 @@
-name: "Close stale issues"
+name: "Stale Issue Management"
 on:
   schedule:
-  - cron: "0 0 * * *"
+    # Run daily at midnight UTC
+    - cron: "0 0 * * *"
+  workflow_dispatch: # Allow manual triggering
+
+env:
+  # Default stale policy timeframes
+  DAYS_BEFORE_STALE: 365
+  DAYS_BEFORE_CLOSE: 30
+
+  # Accelerated timeline for needs-information issues
+  NEEDS_INFO_DAYS_BEFORE_STALE: 30
+  NEEDS_INFO_DAYS_BEFORE_CLOSE: 7
 
-permissions: {}
 jobs:
   stale:
-    permissions:
-      issues: write  #  to close stale issues (actions/stale)
-      pull-requests: write  #  to close stale PRs (actions/stale)
-
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/stale@v9
-      with:
-        repo-token: ${{ secrets.GITHUB_TOKEN }}
-        stale-issue-message: 'This issue is marked stale. It will be closed in 30 days if it is not updated.'
-        stale-pr-message: 'This pull request is marked stale. It will be closed in 30 days if it is not updated.'
-        days-before-stale: 365
-        days-before-close: 30
-        stale-issue-label: "Stale"
-        stale-pr-label: "Stale"
-        operations-per-run: 20
-        remove-stale-when-updated: true
+      # First step: Handle regular issues (excluding needs-information)
+      - name: Mark regular issues as stale
+        uses: actions/stale@v9
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+
+          # Default stale policy
+          days-before-stale: ${{ env.DAYS_BEFORE_STALE }}
+          days-before-close: ${{ env.DAYS_BEFORE_CLOSE }}
+
+          # Explicit stale label configuration
+          stale-issue-label: "stale"
+          stale-pr-label: "stale"
+
+          stale-issue-message: |
+            This issue has been automatically marked as stale due to inactivity.
+            It will be closed in 30 days if no further activity occurs.
+            If you believe this issue is still relevant, please add a comment to keep it open.
+
+          close-issue-message: |
+            This issue has been automatically closed due to inactivity.
+            If you believe this issue is still relevant, please reopen it or create a new issue with updated information.
+
+          # Exclude needs-information issues from this step
+          exempt-issue-labels: 'no-stale,needs-information'
+
+          # Remove stale label when issue/PR becomes active again
+          remove-stale-when-updated: true
+
+          # Apply to pull requests with same timeline
+          days-before-pr-stale: ${{ env.DAYS_BEFORE_STALE }}
+          days-before-pr-close: ${{ env.DAYS_BEFORE_CLOSE }}
+
+          stale-pr-message: |
+            This pull request has been automatically marked as stale due to inactivity.
+            It will be closed in 30 days if no further activity occurs.
+
+          close-pr-message: |
+            This pull request has been automatically closed due to inactivity.
+            If you would like to continue this work, please reopen the PR or create a new one.
+
+          # Only exclude no-stale PRs (needs-information PRs follow standard timeline)
+          exempt-pr-labels: 'no-stale'
+
+      # Second step: Handle needs-information issues with accelerated timeline
+      - name: Mark needs-information issues as stale
+        uses: actions/stale@v9
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+
+          # Accelerated timeline for needs-information
+          days-before-stale: ${{ env.NEEDS_INFO_DAYS_BEFORE_STALE }}
+          days-before-close: ${{ env.NEEDS_INFO_DAYS_BEFORE_CLOSE }}
+
+          # Explicit stale label configuration
+          stale-issue-label: "stale"
+
+          # Only target ISSUES with needs-information label (not PRs)
+          only-issue-labels: 'needs-information'
+
+          stale-issue-message: |
+            This issue has been marked as stale because it requires additional information
+            that has not been provided for 30 days. It will be closed in 7 days if the
+            requested information is not provided.
+
+          close-issue-message: |
+            This issue has been closed because the requested information was not provided within the specified timeframe.
+            If you can provide the missing information, please reopen this issue or create a new one.
+
+          # Disable PR processing for this step
+          days-before-pr-stale: -1
+          days-before-pr-close: -1
+
+          # Remove stale label when issue becomes active again
+          remove-stale-when-updated: true

From e138000aa9678a07d6550d3e0624093cfa3de12c Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 25 Sep 2025 08:52:42 +0300
Subject: [PATCH 1121/1164] Renaming maintenance_events to maint_notifications
 part 2: renaming the files. (#3778)

---
 redis/_parsers/base.py                                       | 2 +-
 redis/client.py                                              | 2 +-
 redis/connection.py                                          | 2 +-
 redis/{maintenance_events.py => maint_notifications.py}      | 0
 ...est_maintenance_events.py => test_maint_notifications.py} | 2 +-
 ...ents_handling.py => test_maint_notifications_handling.py} | 4 ++--
 tests/test_scenario/conftest.py                              | 2 +-
 ...ess_upgrade_helpers.py => maint_notifications_helpers.py} | 0
 .../{test_hitless_upgrade.py => test_maint_notifications.py} | 5 +++--
 9 files changed, 10 insertions(+), 9 deletions(-)
 rename redis/{maintenance_events.py => maint_notifications.py} (100%)
 rename tests/{test_maintenance_events.py => test_maint_notifications.py} (99%)
 rename tests/{test_maintenance_events_handling.py => test_maint_notifications_handling.py} (99%)
 rename tests/test_scenario/{hitless_upgrade_helpers.py => maint_notifications_helpers.py} (100%)
 rename tests/test_scenario/{test_hitless_upgrade.py => test_maint_notifications.py} (99%)

diff --git a/redis/_parsers/base.py b/redis/_parsers/base.py
index 928ec0c201..4c83495a61 100644
--- a/redis/_parsers/base.py
+++ b/redis/_parsers/base.py
@@ -4,7 +4,7 @@
 from asyncio import IncompleteReadError, StreamReader, TimeoutError
 from typing import Awaitable, Callable, List, Optional, Protocol, Union
 
-from redis.maintenance_events import (
+from redis.maint_notifications import (
     MaintenanceNotification,
     NodeFailedOverNotification,
     NodeFailingOverNotification,
diff --git a/redis/client.py b/redis/client.py
index ff92955917..163ef3fedc 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -56,7 +56,7 @@
     WatchError,
 )
 from redis.lock import Lock
-from redis.maintenance_events import (
+from redis.maint_notifications import (
     MaintNotificationsConfig,
     MaintNotificationsPoolHandler,
 )
diff --git a/redis/connection.py b/redis/connection.py
index e31e946d66..7c7071f635 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -47,7 +47,7 @@
     ResponseError,
     TimeoutError,
 )
-from .maintenance_events import (
+from .maint_notifications import (
     MaintenanceState,
     MaintNotificationsConfig,
     MaintNotificationsConnectionHandler,
diff --git a/redis/maintenance_events.py b/redis/maint_notifications.py
similarity index 100%
rename from redis/maintenance_events.py
rename to redis/maint_notifications.py
diff --git a/tests/test_maintenance_events.py b/tests/test_maint_notifications.py
similarity index 99%
rename from tests/test_maintenance_events.py
rename to tests/test_maint_notifications.py
index 60a85c7bea..b365189b7b 100644
--- a/tests/test_maintenance_events.py
+++ b/tests/test_maint_notifications.py
@@ -4,7 +4,7 @@
 
 from redis.connection import ConnectionInterface
 
-from redis.maintenance_events import (
+from redis.maint_notifications import (
     MaintenanceNotification,
     NodeMovingNotification,
     NodeMigratingNotification,
diff --git a/tests/test_maintenance_events_handling.py b/tests/test_maint_notifications_handling.py
similarity index 99%
rename from tests/test_maintenance_events_handling.py
rename to tests/test_maint_notifications_handling.py
index c974eaaef7..38f614bb90 100644
--- a/tests/test_maintenance_events_handling.py
+++ b/tests/test_maint_notifications_handling.py
@@ -13,7 +13,7 @@
     BlockingConnectionPool,
     MaintenanceState,
 )
-from redis.maintenance_events import (
+from redis.maint_notifications import (
     MaintNotificationsConfig,
     NodeMigratingNotification,
     NodeMigratedNotification,
@@ -668,7 +668,7 @@ def test_pool_handler_with_migrating_notification(self):
                 patch.object(
                     pool_handler, "handle_node_moving_notification"
                 ) as mock_handle_moving,
-                patch("redis.maintenance_events.logging.error") as mock_logging_error,
+                patch("redis.maint_notifications.logging.error") as mock_logging_error,
             ):
                 # Pool handler should return None for migrating notifications (not its responsibility)
                 pool_handler.handle_notification(migrating_notification)
diff --git a/tests/test_scenario/conftest.py b/tests/test_scenario/conftest.py
index afc4f5df1c..531d09baa4 100644
--- a/tests/test_scenario/conftest.py
+++ b/tests/test_scenario/conftest.py
@@ -7,7 +7,7 @@
 
 from redis.backoff import ExponentialWithJitterBackoff, NoBackoff
 from redis.client import Redis
-from redis.maintenance_events import EndpointType, MaintNotificationsConfig
+from redis.maint_notifications import EndpointType, MaintNotificationsConfig
 from redis.retry import Retry
 from tests.test_scenario.fault_injector_client import FaultInjectorClient
 
diff --git a/tests/test_scenario/hitless_upgrade_helpers.py b/tests/test_scenario/maint_notifications_helpers.py
similarity index 100%
rename from tests/test_scenario/hitless_upgrade_helpers.py
rename to tests/test_scenario/maint_notifications_helpers.py
diff --git a/tests/test_scenario/test_hitless_upgrade.py b/tests/test_scenario/test_maint_notifications.py
similarity index 99%
rename from tests/test_scenario/test_hitless_upgrade.py
rename to tests/test_scenario/test_maint_notifications.py
index 601b4b5a18..a13299bfb7 100644
--- a/tests/test_scenario/test_hitless_upgrade.py
+++ b/tests/test_scenario/test_maint_notifications.py
@@ -12,7 +12,7 @@
 
 from redis import Redis
 from redis.connection import ConnectionInterface
-from redis.maintenance_events import (
+from redis.maint_notifications import (
     EndpointType,
     MaintNotificationsConfig,
     MaintenanceState,
@@ -25,7 +25,7 @@
 from tests.test_scenario.fault_injector_client import (
     FaultInjectorClient,
 )
-from tests.test_scenario.hitless_upgrade_helpers import (
+from tests.test_scenario.maint_notifications_helpers import (
     ClientValidations,
     ClusterOperations,
 )
@@ -33,6 +33,7 @@
 logging.basicConfig(
     level=logging.INFO,
     format="%(asctime)s %(levelname)s %(message)s",
+    datefmt="%Y-%m-%d %H:%M:%S:%f",
 )
 
 BIND_TIMEOUT = 30

From 89dbc2f8b9b4792404f21f18bc1b9e9693938c41 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Fri, 26 Sep 2025 14:32:06 +0300
Subject: [PATCH 1122/1164] Adding ssl_verify_flags_config argument for ssl
 connection configuration (#3772)

---
 redis/asyncio/client.py        |  7 ++-
 redis/asyncio/cluster.py       |  7 ++-
 redis/asyncio/connection.py    | 44 ++++++++++++++-
 redis/client.py                |  4 ++
 redis/cluster.py               |  2 +
 redis/connection.py            | 33 +++++++++++-
 tests/test_asyncio/test_ssl.py | 87 ++++++++++++++++++++++++++++++
 tests/test_connection_pool.py  | 64 +++++++++++++++++++++-
 tests/test_ssl.py              | 97 ++++++++++++++++++++++++++++++++++
 9 files changed, 339 insertions(+), 6 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index d4650e1791..3defeceead 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -81,10 +81,11 @@
 )
 
 if TYPE_CHECKING and SSL_AVAILABLE:
-    from ssl import TLSVersion, VerifyMode
+    from ssl import TLSVersion, VerifyFlags, VerifyMode
 else:
     TLSVersion = None
     VerifyMode = None
+    VerifyFlags = None
 
 PubSubHandler = Callable[[Dict[str, str]], Awaitable[None]]
 _KeyT = TypeVar("_KeyT", bound=KeyT)
@@ -238,6 +239,8 @@ def __init__(
         ssl_keyfile: Optional[str] = None,
         ssl_certfile: Optional[str] = None,
         ssl_cert_reqs: Union[str, VerifyMode] = "required",
+        ssl_include_verify_flags: Optional[List[VerifyFlags]] = None,
+        ssl_exclude_verify_flags: Optional[List[VerifyFlags]] = None,
         ssl_ca_certs: Optional[str] = None,
         ssl_ca_data: Optional[str] = None,
         ssl_check_hostname: bool = True,
@@ -347,6 +350,8 @@ def __init__(
                             "ssl_keyfile": ssl_keyfile,
                             "ssl_certfile": ssl_certfile,
                             "ssl_cert_reqs": ssl_cert_reqs,
+                            "ssl_include_verify_flags": ssl_include_verify_flags,
+                            "ssl_exclude_verify_flags": ssl_exclude_verify_flags,
                             "ssl_ca_certs": ssl_ca_certs,
                             "ssl_ca_data": ssl_ca_data,
                             "ssl_check_hostname": ssl_check_hostname,
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index dd68f388b2..4e0e06517d 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -86,10 +86,11 @@
 )
 
 if SSL_AVAILABLE:
-    from ssl import TLSVersion, VerifyMode
+    from ssl import TLSVersion, VerifyFlags, VerifyMode
 else:
     TLSVersion = None
     VerifyMode = None
+    VerifyFlags = None
 
 TargetNodesT = TypeVar(
     "TargetNodesT", str, "ClusterNode", List["ClusterNode"], Dict[Any, "ClusterNode"]
@@ -299,6 +300,8 @@ def __init__(
         ssl_ca_certs: Optional[str] = None,
         ssl_ca_data: Optional[str] = None,
         ssl_cert_reqs: Union[str, VerifyMode] = "required",
+        ssl_include_verify_flags: Optional[List[VerifyFlags]] = None,
+        ssl_exclude_verify_flags: Optional[List[VerifyFlags]] = None,
         ssl_certfile: Optional[str] = None,
         ssl_check_hostname: bool = True,
         ssl_keyfile: Optional[str] = None,
@@ -358,6 +361,8 @@ def __init__(
                     "ssl_ca_certs": ssl_ca_certs,
                     "ssl_ca_data": ssl_ca_data,
                     "ssl_cert_reqs": ssl_cert_reqs,
+                    "ssl_include_verify_flags": ssl_include_verify_flags,
+                    "ssl_exclude_verify_flags": ssl_exclude_verify_flags,
                     "ssl_certfile": ssl_certfile,
                     "ssl_check_hostname": ssl_check_hostname,
                     "ssl_keyfile": ssl_keyfile,
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index 4efd868f6f..e3eb3bd9f1 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -30,11 +30,12 @@
 
 if SSL_AVAILABLE:
     import ssl
-    from ssl import SSLContext, TLSVersion
+    from ssl import SSLContext, TLSVersion, VerifyFlags
 else:
     ssl = None
     TLSVersion = None
     SSLContext = None
+    VerifyFlags = None
 
 from ..auth.token import TokenInterface
 from ..event import AsyncAfterConnectionReleasedEvent, EventDispatcher
@@ -793,6 +794,8 @@ def __init__(
         ssl_keyfile: Optional[str] = None,
         ssl_certfile: Optional[str] = None,
         ssl_cert_reqs: Union[str, ssl.VerifyMode] = "required",
+        ssl_include_verify_flags: Optional[List["ssl.VerifyFlags"]] = None,
+        ssl_exclude_verify_flags: Optional[List["ssl.VerifyFlags"]] = None,
         ssl_ca_certs: Optional[str] = None,
         ssl_ca_data: Optional[str] = None,
         ssl_check_hostname: bool = True,
@@ -807,6 +810,8 @@ def __init__(
             keyfile=ssl_keyfile,
             certfile=ssl_certfile,
             cert_reqs=ssl_cert_reqs,
+            include_verify_flags=ssl_include_verify_flags,
+            exclude_verify_flags=ssl_exclude_verify_flags,
             ca_certs=ssl_ca_certs,
             ca_data=ssl_ca_data,
             check_hostname=ssl_check_hostname,
@@ -832,6 +837,14 @@ def certfile(self):
     def cert_reqs(self):
         return self.ssl_context.cert_reqs
 
+    @property
+    def include_verify_flags(self):
+        return self.ssl_context.include_verify_flags
+
+    @property
+    def exclude_verify_flags(self):
+        return self.ssl_context.exclude_verify_flags
+
     @property
     def ca_certs(self):
         return self.ssl_context.ca_certs
@@ -854,6 +867,8 @@ class RedisSSLContext:
         "keyfile",
         "certfile",
         "cert_reqs",
+        "include_verify_flags",
+        "exclude_verify_flags",
         "ca_certs",
         "ca_data",
         "context",
@@ -867,6 +882,8 @@ def __init__(
         keyfile: Optional[str] = None,
         certfile: Optional[str] = None,
         cert_reqs: Optional[Union[str, ssl.VerifyMode]] = None,
+        include_verify_flags: Optional[List["ssl.VerifyFlags"]] = None,
+        exclude_verify_flags: Optional[List["ssl.VerifyFlags"]] = None,
         ca_certs: Optional[str] = None,
         ca_data: Optional[str] = None,
         check_hostname: bool = False,
@@ -892,6 +909,8 @@ def __init__(
                 )
             cert_reqs = CERT_REQS[cert_reqs]
         self.cert_reqs = cert_reqs
+        self.include_verify_flags = include_verify_flags
+        self.exclude_verify_flags = exclude_verify_flags
         self.ca_certs = ca_certs
         self.ca_data = ca_data
         self.check_hostname = (
@@ -906,6 +925,12 @@ def get(self) -> SSLContext:
             context = ssl.create_default_context()
             context.check_hostname = self.check_hostname
             context.verify_mode = self.cert_reqs
+            if self.include_verify_flags:
+                for flag in self.include_verify_flags:
+                    context.verify_flags |= flag
+            if self.exclude_verify_flags:
+                for flag in self.exclude_verify_flags:
+                    context.verify_flags &= ~flag
             if self.certfile and self.keyfile:
                 context.load_cert_chain(certfile=self.certfile, keyfile=self.keyfile)
             if self.ca_certs or self.ca_data:
@@ -953,6 +978,20 @@ def to_bool(value) -> Optional[bool]:
     return bool(value)
 
 
+def parse_ssl_verify_flags(value):
+    # flags are passed in as a string representation of a list,
+    # e.g. VERIFY_X509_STRICT, VERIFY_X509_PARTIAL_CHAIN
+    verify_flags_str = value.replace("[", "").replace("]", "")
+
+    verify_flags = []
+    for flag in verify_flags_str.split(","):
+        flag = flag.strip()
+        if not hasattr(VerifyFlags, flag):
+            raise ValueError(f"Invalid ssl verify flag: {flag}")
+        verify_flags.append(getattr(VerifyFlags, flag))
+    return verify_flags
+
+
 URL_QUERY_ARGUMENT_PARSERS: Mapping[str, Callable[..., object]] = MappingProxyType(
     {
         "db": int,
@@ -963,6 +1002,8 @@ def to_bool(value) -> Optional[bool]:
         "max_connections": int,
         "health_check_interval": int,
         "ssl_check_hostname": to_bool,
+        "ssl_include_verify_flags": parse_ssl_verify_flags,
+        "ssl_exclude_verify_flags": parse_ssl_verify_flags,
         "timeout": float,
     }
 )
@@ -1021,6 +1062,7 @@ def parse_url(url: str) -> ConnectKwargs:
 
         if parsed.scheme == "rediss":
             kwargs["connection_class"] = SSLConnection
+
     else:
         valid_schemes = "redis://, rediss://, unix://"
         raise ValueError(
diff --git a/redis/client.py b/redis/client.py
index 163ef3fedc..cf4d77950f 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -224,6 +224,8 @@ def __init__(
         ssl_keyfile: Optional[str] = None,
         ssl_certfile: Optional[str] = None,
         ssl_cert_reqs: Union[str, "ssl.VerifyMode"] = "required",
+        ssl_include_verify_flags: Optional[List["ssl.VerifyFlags"]] = None,
+        ssl_exclude_verify_flags: Optional[List["ssl.VerifyFlags"]] = None,
         ssl_ca_certs: Optional[str] = None,
         ssl_ca_path: Optional[str] = None,
         ssl_ca_data: Optional[str] = None,
@@ -330,6 +332,8 @@ def __init__(
                             "ssl_keyfile": ssl_keyfile,
                             "ssl_certfile": ssl_certfile,
                             "ssl_cert_reqs": ssl_cert_reqs,
+                            "ssl_include_verify_flags": ssl_include_verify_flags,
+                            "ssl_exclude_verify_flags": ssl_exclude_verify_flags,
                             "ssl_ca_certs": ssl_ca_certs,
                             "ssl_ca_data": ssl_ca_data,
                             "ssl_check_hostname": ssl_check_hostname,
diff --git a/redis/cluster.py b/redis/cluster.py
index 7c645be755..839721edf1 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -184,6 +184,8 @@ def parse_cluster_myshardid(resp, **options):
     "ssl_ca_data",
     "ssl_certfile",
     "ssl_cert_reqs",
+    "ssl_include_verify_flags",
+    "ssl_exclude_verify_flags",
     "ssl_keyfile",
     "ssl_password",
     "ssl_check_hostname",
diff --git a/redis/connection.py b/redis/connection.py
index 7c7071f635..a09156b0f3 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -68,8 +68,10 @@
 
 if SSL_AVAILABLE:
     import ssl
+    from ssl import VerifyFlags
 else:
     ssl = None
+    VerifyFlags = None
 
 if HIREDIS_AVAILABLE:
     import hiredis
@@ -1360,6 +1362,8 @@ def __init__(
         ssl_keyfile=None,
         ssl_certfile=None,
         ssl_cert_reqs="required",
+        ssl_include_verify_flags: Optional[List["VerifyFlags"]] = None,
+        ssl_exclude_verify_flags: Optional[List["VerifyFlags"]] = None,
         ssl_ca_certs=None,
         ssl_ca_data=None,
         ssl_check_hostname=True,
@@ -1378,7 +1382,10 @@ def __init__(
         Args:
             ssl_keyfile: Path to an ssl private key. Defaults to None.
             ssl_certfile: Path to an ssl certificate. Defaults to None.
-            ssl_cert_reqs: The string value for the SSLContext.verify_mode (none, optional, required), or an ssl.VerifyMode. Defaults to "required".
+            ssl_cert_reqs: The string value for the SSLContext.verify_mode (none, optional, required),
+                           or an ssl.VerifyMode. Defaults to "required".
+            ssl_include_verify_flags: A list of flags to be included in the SSLContext.verify_flags. Defaults to None.
+            ssl_exclude_verify_flags: A list of flags to be excluded from the SSLContext.verify_flags. Defaults to None.
             ssl_ca_certs: The path to a file of concatenated CA certificates in PEM format. Defaults to None.
             ssl_ca_data: Either an ASCII string of one or more PEM-encoded certificates or a bytes-like object of DER-encoded certificates.
             ssl_check_hostname: If set, match the hostname during the SSL handshake. Defaults to True.
@@ -1414,6 +1421,8 @@ def __init__(
                 )
             ssl_cert_reqs = CERT_REQS[ssl_cert_reqs]
         self.cert_reqs = ssl_cert_reqs
+        self.ssl_include_verify_flags = ssl_include_verify_flags
+        self.ssl_exclude_verify_flags = ssl_exclude_verify_flags
         self.ca_certs = ssl_ca_certs
         self.ca_data = ssl_ca_data
         self.ca_path = ssl_ca_path
@@ -1453,6 +1462,12 @@ def _wrap_socket_with_ssl(self, sock):
         context = ssl.create_default_context()
         context.check_hostname = self.check_hostname
         context.verify_mode = self.cert_reqs
+        if self.ssl_include_verify_flags:
+            for flag in self.ssl_include_verify_flags:
+                context.verify_flags |= flag
+        if self.ssl_exclude_verify_flags:
+            for flag in self.ssl_exclude_verify_flags:
+                context.verify_flags &= ~flag
         if self.certfile or self.keyfile:
             context.load_cert_chain(
                 certfile=self.certfile,
@@ -1566,6 +1581,20 @@ def to_bool(value):
     return bool(value)
 
 
+def parse_ssl_verify_flags(value):
+    # flags are passed in as a string representation of a list,
+    # e.g. VERIFY_X509_STRICT, VERIFY_X509_PARTIAL_CHAIN
+    verify_flags_str = value.replace("[", "").replace("]", "")
+
+    verify_flags = []
+    for flag in verify_flags_str.split(","):
+        flag = flag.strip()
+        if not hasattr(VerifyFlags, flag):
+            raise ValueError(f"Invalid ssl verify flag: {flag}")
+        verify_flags.append(getattr(VerifyFlags, flag))
+    return verify_flags
+
+
 URL_QUERY_ARGUMENT_PARSERS = {
     "db": int,
     "socket_timeout": float,
@@ -1576,6 +1605,8 @@ def to_bool(value):
     "max_connections": int,
     "health_check_interval": int,
     "ssl_check_hostname": to_bool,
+    "ssl_include_verify_flags": parse_ssl_verify_flags,
+    "ssl_exclude_verify_flags": parse_ssl_verify_flags,
     "timeout": float,
 }
 
diff --git a/tests/test_asyncio/test_ssl.py b/tests/test_asyncio/test_ssl.py
index 75800f22de..154d20a9ea 100644
--- a/tests/test_asyncio/test_ssl.py
+++ b/tests/test_asyncio/test_ssl.py
@@ -1,3 +1,5 @@
+import ssl
+import unittest.mock
 from urllib.parse import urlparse
 import pytest
 import pytest_asyncio
@@ -54,3 +56,88 @@ async def test_cert_reqs_none_with_check_hostname(self, request):
             assert conn.check_hostname is False
         finally:
             await r.aclose()
+
+    async def test_ssl_flags_applied_to_context(self, request):
+        """
+        Test that ssl_include_verify_flags and ssl_exclude_verify_flags
+        are properly applied to the SSL context
+        """
+        ssl_url = request.config.option.redis_ssl_url
+        parsed_url = urlparse(ssl_url)
+
+        # Test with specific SSL verify flags
+        ssl_include_verify_flags = [
+            ssl.VerifyFlags.VERIFY_CRL_CHECK_LEAF,  # Disable strict verification
+            ssl.VerifyFlags.VERIFY_CRL_CHECK_CHAIN,  # Enable partial chain
+        ]
+
+        ssl_exclude_verify_flags = [
+            ssl.VerifyFlags.VERIFY_X509_STRICT,  # Disable trusted first
+        ]
+
+        r = redis.Redis(
+            host=parsed_url.hostname,
+            port=parsed_url.port,
+            ssl=True,
+            ssl_cert_reqs="none",
+            ssl_include_verify_flags=ssl_include_verify_flags,
+            ssl_exclude_verify_flags=ssl_exclude_verify_flags,
+        )
+
+        try:
+            # Get the connection to trigger SSL context creation
+            conn = r.connection_pool.make_connection()
+            assert isinstance(conn, redis.SSLConnection)
+
+            # Verify the flags were processed by checking they're stored in connection
+            assert conn.include_verify_flags is not None
+            assert len(conn.include_verify_flags) == 2
+
+            assert conn.exclude_verify_flags is not None
+            assert len(conn.exclude_verify_flags) == 1
+
+            # Check each flag individually
+            for flag in ssl_include_verify_flags:
+                assert flag in conn.include_verify_flags, (
+                    f"Flag {flag} not found in stored ssl_include_verify_flags"
+                )
+            for flag in ssl_exclude_verify_flags:
+                assert flag in conn.exclude_verify_flags, (
+                    f"Flag {flag} not found in stored ssl_exclude_verify_flags"
+                )
+
+            # Test the actual SSL context created by the connection's RedisSSLContext
+            # We need to mock the ssl.create_default_context to capture the context
+            captured_context = None
+            original_create_default_context = ssl.create_default_context
+
+            def capture_context_create_default():
+                nonlocal captured_context
+                captured_context = original_create_default_context()
+                return captured_context
+
+            with unittest.mock.patch(
+                "ssl.create_default_context", capture_context_create_default
+            ):
+                # Trigger SSL context creation by calling get() on the RedisSSLContext
+                ssl_context = conn.ssl_context.get()
+
+                # Validate that we captured a context and it has the correct flags applied
+                assert captured_context is not None, "SSL context was not captured"
+                assert ssl_context is captured_context, (
+                    "Returned context should be the captured one"
+                )
+
+                # Verify that VERIFY_X509_STRICT was disabled (bit cleared)
+                assert not (
+                    captured_context.verify_flags & ssl.VerifyFlags.VERIFY_X509_STRICT
+                ), "VERIFY_X509_STRICT should be disabled but is enabled"
+
+                # Verify that VERIFY_CRL_CHECK_CHAIN was enabled (bit set)
+                assert (
+                    captured_context.verify_flags
+                    & ssl.VerifyFlags.VERIFY_CRL_CHECK_CHAIN
+                ), "VERIFY_CRL_CHECK_CHAIN should be enabled but is disabled"
+
+        finally:
+            await r.aclose()
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 1eb68d3775..2397f15600 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -19,6 +19,9 @@
 )
 from .test_pubsub import wait_for_message
 
+if SSL_AVAILABLE:
+    import ssl
+
 
 class DummyConnection:
     description_format = "DummyConnection<>"
@@ -511,8 +514,6 @@ class MyConnection(redis.SSLConnection):
         assert pool.connection_class == MyConnection
 
     def test_cert_reqs_options(self):
-        import ssl
-
         class DummyConnectionPool(redis.ConnectionPool):
             def get_connection(self):
                 return self.make_connection()
@@ -532,6 +533,65 @@ def get_connection(self):
         pool = DummyConnectionPool.from_url("rediss://?ssl_check_hostname=True")
         assert pool.get_connection().check_hostname is True
 
+    def test_ssl_flags_config_parsing(self):
+        class DummyConnectionPool(redis.ConnectionPool):
+            def get_connection(self):
+                return self.make_connection()
+
+        pool = DummyConnectionPool.from_url(
+            "rediss://?ssl_include_verify_flags=VERIFY_X509_STRICT,VERIFY_CRL_CHECK_CHAIN"
+        )
+
+        assert pool.get_connection().ssl_include_verify_flags == [
+            ssl.VerifyFlags.VERIFY_X509_STRICT,
+            ssl.VerifyFlags.VERIFY_CRL_CHECK_CHAIN,
+        ]
+
+        pool = DummyConnectionPool.from_url(
+            "rediss://?ssl_include_verify_flags=[VERIFY_X509_STRICT, VERIFY_CRL_CHECK_CHAIN]"
+        )
+
+        assert pool.get_connection().ssl_include_verify_flags == [
+            ssl.VerifyFlags.VERIFY_X509_STRICT,
+            ssl.VerifyFlags.VERIFY_CRL_CHECK_CHAIN,
+        ]
+
+        pool = DummyConnectionPool.from_url(
+            "rediss://?ssl_exclude_verify_flags=VERIFY_X509_STRICT, VERIFY_CRL_CHECK_CHAIN"
+        )
+
+        assert pool.get_connection().ssl_exclude_verify_flags == [
+            ssl.VerifyFlags.VERIFY_X509_STRICT,
+            ssl.VerifyFlags.VERIFY_CRL_CHECK_CHAIN,
+        ]
+
+        pool = DummyConnectionPool.from_url(
+            "rediss://?ssl_include_verify_flags=VERIFY_X509_STRICT, VERIFY_CRL_CHECK_CHAIN&ssl_exclude_verify_flags=VERIFY_CRL_CHECK_LEAF"
+        )
+
+        assert pool.get_connection().ssl_include_verify_flags == [
+            ssl.VerifyFlags.VERIFY_X509_STRICT,
+            ssl.VerifyFlags.VERIFY_CRL_CHECK_CHAIN,
+        ]
+        assert pool.get_connection().ssl_exclude_verify_flags == [
+            ssl.VerifyFlags.VERIFY_CRL_CHECK_LEAF,
+        ]
+
+    def test_ssl_flags_config_invalid_flag(self):
+        class DummyConnectionPool(redis.ConnectionPool):
+            def get_connection(self):
+                return self.make_connection()
+
+        with pytest.raises(ValueError):
+            DummyConnectionPool.from_url(
+                "rediss://?ssl_include_verify_flags=[VERIFY_X509,VERIFY_CRL_CHECK_CHAIN]"
+            )
+
+        with pytest.raises(ValueError):
+            DummyConnectionPool.from_url(
+                "rediss://?ssl_exclude_verify_flags=[VERIFY_X509_STRICT1, VERIFY_CRL_CHECK_CHAIN]"
+            )
+
 
 class TestConnection:
     def test_on_connect_error(self):
diff --git a/tests/test_ssl.py b/tests/test_ssl.py
index cb3f227629..96175d681f 100644
--- a/tests/test_ssl.py
+++ b/tests/test_ssl.py
@@ -328,3 +328,100 @@ def test_cert_reqs_none_with_check_hostname(self, request):
             assert conn.check_hostname is False
         finally:
             r.close()
+
+    def test_ssl_verify_flags_applied_to_context(self, request):
+        """
+        Test that ssl_include_verify_flags and ssl_exclude_verify_flags
+        are properly applied to the SSL context
+        """
+        ssl_url = request.config.option.redis_ssl_url
+        parsed_url = urlparse(ssl_url)
+
+        # Test with specific SSL verify flags
+        ssl_include_verify_flags = [
+            ssl.VerifyFlags.VERIFY_CRL_CHECK_LEAF,  # Disable strict verification
+            ssl.VerifyFlags.VERIFY_CRL_CHECK_CHAIN,  # Enable partial chain
+        ]
+
+        ssl_exclude_verify_flags = [
+            ssl.VerifyFlags.VERIFY_X509_STRICT,  # Disable trusted first
+        ]
+
+        r = redis.Redis(
+            host=parsed_url.hostname,
+            port=parsed_url.port,
+            ssl=True,
+            ssl_cert_reqs="none",
+            ssl_include_verify_flags=ssl_include_verify_flags,
+            ssl_exclude_verify_flags=ssl_exclude_verify_flags,
+        )
+
+        try:
+            # Get the connection to trigger SSL context creation
+            conn = r.connection_pool.get_connection()
+            assert isinstance(conn, redis.SSLConnection)
+
+            # Verify the flags were processed by checking they're stored in connection
+            assert conn.ssl_include_verify_flags is not None
+            assert len(conn.ssl_include_verify_flags) == 2
+
+            assert conn.ssl_exclude_verify_flags is not None
+            assert len(conn.ssl_exclude_verify_flags) == 1
+
+            # Check each flag individually
+            for flag in ssl_include_verify_flags:
+                assert flag in conn.ssl_include_verify_flags, (
+                    f"Flag {flag} not found in stored ssl_include_verify_flags"
+                )
+            for flag in ssl_exclude_verify_flags:
+                assert flag in conn.ssl_exclude_verify_flags, (
+                    f"Flag {flag} not found in stored ssl_exclude_verify_flags"
+                )
+
+            # Test the actual SSL context created by the connection
+            # We need to create a mock socket and call _wrap_socket_with_ssl to get the context
+            import socket
+            import unittest.mock
+
+            mock_sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+
+            try:
+                # Mock the wrap_socket method to capture the context
+                captured_context = None
+
+                def capture_context_wrap_socket(context_self, sock, **_kwargs):
+                    nonlocal captured_context
+                    captured_context = context_self
+                    # Don't actually wrap the socket, just return the original socket
+                    # to avoid connection errors
+                    return sock
+
+                with unittest.mock.patch.object(
+                    ssl.SSLContext, "wrap_socket", capture_context_wrap_socket
+                ):
+                    try:
+                        conn._wrap_socket_with_ssl(mock_sock)
+                    except Exception:
+                        # We expect this to potentially fail since we're not actually connecting
+                        # but we should have captured the context
+                        pass
+
+                # Validate that we captured a context and it has the correct flags applied
+                assert captured_context is not None, "SSL context was not captured"
+
+                # Verify that VERIFY_X509_STRICT was disabled (bit cleared)
+                assert not (
+                    captured_context.verify_flags & ssl.VerifyFlags.VERIFY_X509_STRICT
+                ), "VERIFY_X509_STRICT should be disabled but is enabled"
+
+                # Verify that VERIFY_CRL_CHECK_CHAIN was enabled (bit set)
+                assert (
+                    captured_context.verify_flags
+                    & ssl.VerifyFlags.VERIFY_CRL_CHECK_CHAIN
+                ), "VERIFY_CRL_CHECK_CHAIN should be enabled but is disabled"
+
+            finally:
+                mock_sock.close()
+
+        finally:
+            r.close()

From b102c3bee0fe84765296491aa2bdd2476982d168 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Fri, 26 Sep 2025 17:48:14 +0300
Subject: [PATCH 1123/1164] Adding 'auto' option to
 MaintNotificationsConfig.enabled (#3779)

---
 redis/connection.py                        |  22 ++--
 redis/maint_notifications.py               |  13 ++-
 tests/test_maint_notifications.py          |   2 +-
 tests/test_maint_notifications_handling.py | 117 ++++++++++++++-------
 4 files changed, 105 insertions(+), 49 deletions(-)

diff --git a/redis/connection.py b/redis/connection.py
index a09156b0f3..837fccd40e 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -688,8 +688,12 @@ def on_connect_check_health(self, check_health: bool = True):
             ):
                 raise ConnectionError("Invalid RESP version")
 
-        # Send maintenance notifications handshake if RESP3 is active and maintenance notifications are enabled
+        # Send maintenance notifications handshake if RESP3 is active
+        # and maintenance notifications are enabled
         # and we have a host to determine the endpoint type from
+        # When the maint_notifications_config enabled mode is "auto",
+        # we just log a warning if the handshake fails
+        # When the mode is enabled=True, we raise an exception in case of failure
         if (
             self.protocol not in [2, "2"]
             and self.maint_notifications_config
@@ -711,15 +715,21 @@ def on_connect_check_health(self, check_health: bool = True):
                 )
                 response = self.read_response()
                 if str_if_bytes(response) != "OK":
-                    raise ConnectionError(
+                    raise ResponseError(
                         "The server doesn't support maintenance notifications"
                     )
             except Exception as e:
-                # Log warning but don't fail the connection
-                import logging
+                if (
+                    isinstance(e, ResponseError)
+                    and self.maint_notifications_config.enabled == "auto"
+                ):
+                    # Log warning but don't fail the connection
+                    import logging
 
-                logger = logging.getLogger(__name__)
-                logger.warning(f"Failed to enable maintenance notifications: {e}")
+                    logger = logging.getLogger(__name__)
+                    logger.warning(f"Failed to enable maintenance notifications: {e}")
+                else:
+                    raise
 
         # if a client_name is given, set it
         if self.client_name:
diff --git a/redis/maint_notifications.py b/redis/maint_notifications.py
index eeb77299ef..37e4f93a3f 100644
--- a/redis/maint_notifications.py
+++ b/redis/maint_notifications.py
@@ -5,7 +5,7 @@
 import threading
 import time
 from abc import ABC, abstractmethod
-from typing import TYPE_CHECKING, Optional, Union
+from typing import TYPE_CHECKING, Literal, Optional, Union
 
 from redis.typing import Number
 
@@ -447,7 +447,7 @@ class MaintNotificationsConfig:
 
     def __init__(
         self,
-        enabled: bool = True,
+        enabled: Union[bool, Literal["auto"]] = "auto",
         proactive_reconnect: bool = True,
         relaxed_timeout: Optional[Number] = 10,
         endpoint_type: Optional[EndpointType] = None,
@@ -456,8 +456,13 @@ def __init__(
         Initialize a new MaintNotificationsConfig.
 
         Args:
-            enabled (bool): Whether to enable maintenance notifications handling.
-                Defaults to False.
+            enabled (bool | "auto"): Controls maintenance notifications handling behavior.
+                - True: The CLIENT MAINT_NOTIFICATIONS command must succeed during connection setup,
+                otherwise a ResponseError is raised.
+                - "auto": The CLIENT MAINT_NOTIFICATIONS command is attempted but failures are
+                gracefully handled - a warning is logged and normal operation continues.
+                - False: Maintenance notifications are completely disabled.
+                Defaults to "auto".
             proactive_reconnect (bool): Whether to proactively reconnect when a node is replaced.
                 Defaults to True.
             relaxed_timeout (Number): The relaxed timeout to use for the connection during maintenance.
diff --git a/tests/test_maint_notifications.py b/tests/test_maint_notifications.py
index b365189b7b..08ac15368f 100644
--- a/tests/test_maint_notifications.py
+++ b/tests/test_maint_notifications.py
@@ -387,7 +387,7 @@ class TestMaintNotificationsConfig:
     def test_init_defaults(self):
         """Test MaintNotificationsConfig initialization with defaults."""
         config = MaintNotificationsConfig()
-        assert config.enabled is True
+        assert config.enabled == "auto"
         assert config.proactive_reconnect is True
         assert config.relaxed_timeout == 10
 
diff --git a/tests/test_maint_notifications_handling.py b/tests/test_maint_notifications_handling.py
index 38f614bb90..baa7d601fa 100644
--- a/tests/test_maint_notifications_handling.py
+++ b/tests/test_maint_notifications_handling.py
@@ -13,7 +13,9 @@
     BlockingConnectionPool,
     MaintenanceState,
 )
+from redis.exceptions import ResponseError
 from redis.maint_notifications import (
+    EndpointType,
     MaintNotificationsConfig,
     NodeMigratingNotification,
     NodeMigratedNotification,
@@ -201,6 +203,10 @@ def send(self, data):
         if b"HELLO" in data:
             response = b"%7\r\n$6\r\nserver\r\n$5\r\nredis\r\n$7\r\nversion\r\n$5\r\n7.0.0\r\n$5\r\nproto\r\n:3\r\n$2\r\nid\r\n:1\r\n$4\r\nmode\r\n$10\r\nstandalone\r\n$4\r\nrole\r\n$6\r\nmaster\r\n$7\r\nmodules\r\n*0\r\n"
             self.pending_responses.append(response)
+        elif b"MAINT_NOTIFICATIONS" in data and b"internal-ip" in data:
+            # Simulate error response - activate it only for internal-ip tests
+            response = b"+ERROR\r\n"
+            self.pending_responses.append(response)
         elif b"SET" in data:
             response = b"+OK\r\n"
 
@@ -337,8 +343,8 @@ def shutdown(self, how):
         pass
 
 
-class TestMaintenanceNotificationsHandlingSingleProxy:
-    """Integration tests for maintenance notifications handling with real connection pool."""
+class TestMaintenanceNotificationsBase:
+    """Base class for maintenance notifications handling tests."""
 
     def setup_method(self):
         """Set up test fixtures with mocked sockets."""
@@ -393,7 +399,7 @@ def _get_client(
             pool_class: The connection pool class (ConnectionPool or BlockingConnectionPool)
             max_connections: Maximum number of connections in the pool (default: 10)
             maint_notifications_config: Optional MaintNotificationsConfig to use. If not provided,
-                                     uses self.config from setup_method (default: None)
+                                    uses self.config from setup_method (default: None)
             setup_pool_handler: Whether to set up pool handler for moving notifications (default: False)
 
         Returns:
@@ -425,6 +431,71 @@ def _get_client(
 
         return test_redis_client
 
+
+class TestMaintenanceNotificationsHandshake(TestMaintenanceNotificationsBase):
+    """Integration tests for maintenance notifications handling with real connection pool."""
+
+    def test_handshake_success_when_enabled(self):
+        """Test that handshake is performed correctly."""
+        maint_notifications_config = MaintNotificationsConfig(
+            enabled=True, endpoint_type=EndpointType.EXTERNAL_IP
+        )
+        test_redis_client = self._get_client(
+            ConnectionPool, maint_notifications_config=maint_notifications_config
+        )
+
+        try:
+            # Perform Redis operations that should work with our improved mock responses
+            result_set = test_redis_client.set("hello", "world")
+            result_get = test_redis_client.get("hello")
+
+            # Verify operations completed successfully
+            assert result_set is True
+            assert result_get == b"world"
+
+        finally:
+            test_redis_client.close()
+
+    def test_handshake_success_when_auto_and_command_not_supported(self):
+        """Test that when maintenance notifications are set to 'auto', the client gracefully handles unsupported MAINT_NOTIFICATIONS commands and normal Redis operations succeed."""
+        maint_notifications_config = MaintNotificationsConfig(
+            enabled="auto", endpoint_type=EndpointType.INTERNAL_IP
+        )
+        test_redis_client = self._get_client(
+            ConnectionPool, maint_notifications_config=maint_notifications_config
+        )
+
+        try:
+            # Perform Redis operations that should work with our improved mock responses
+            result_set = test_redis_client.set("hello", "world")
+            result_get = test_redis_client.get("hello")
+
+            # Verify operations completed successfully
+            assert result_set is True
+            assert result_get == b"world"
+
+        finally:
+            test_redis_client.close()
+
+    def test_handshake_failure_when_enabled(self):
+        """Test that handshake is performed correctly."""
+        maint_notifications_config = MaintNotificationsConfig(
+            enabled=True, endpoint_type=EndpointType.INTERNAL_IP
+        )
+        test_redis_client = self._get_client(
+            ConnectionPool, maint_notifications_config=maint_notifications_config
+        )
+        try:
+            with pytest.raises(ResponseError):
+                test_redis_client.set("hello", "world")
+
+        finally:
+            test_redis_client.close()
+
+
+class TestMaintenanceNotificationsHandlingSingleProxy(TestMaintenanceNotificationsBase):
+    """Integration tests for maintenance notifications handling with real connection pool."""
+
     def _validate_connection_handlers(self, conn, pool_handler, config):
         """Helper method to validate connection handlers are properly set."""
         # Test that the node moving handler function is correctly set
@@ -1891,40 +1962,16 @@ def test_moving_migrating_migrated_moved_state_transitions(self, pool_class):
             pool.disconnect()
 
 
-class TestMaintenanceNotificationsHandlingMultipleProxies:
+class TestMaintenanceNotificationsHandlingMultipleProxies(
+    TestMaintenanceNotificationsBase
+):
     """Integration tests for maintenance notifications handling with real connection pool."""
 
     def setup_method(self):
         """Set up test fixtures with mocked sockets."""
-        self.mock_sockets = []
-        self.original_socket = socket.socket
+        super().setup_method()
         self.orig_host = "test.address.com"
 
-        # Mock socket creation to return our mock sockets
-        def mock_socket_factory(*args, **kwargs):
-            mock_sock = MockSocket()
-            self.mock_sockets.append(mock_sock)
-            return mock_sock
-
-        self.socket_patcher = patch("socket.socket", side_effect=mock_socket_factory)
-        self.socket_patcher.start()
-
-        # Mock select.select to simulate data availability for reading
-        def mock_select(rlist, wlist, xlist, timeout=0):
-            # Check if any of the sockets in rlist have data available
-            ready_sockets = []
-            for sock in rlist:
-                if hasattr(sock, "connected") and sock.connected and not sock.closed:
-                    # Only return socket as ready if it actually has data to read
-                    if hasattr(sock, "pending_responses") and sock.pending_responses:
-                        ready_sockets.append(sock)
-                    # Don't return socket as ready just because it received commands
-                    # Only when there are actual responses available
-            return (ready_sockets, [], [])
-
-        self.select_patcher = patch("select.select", side_effect=mock_select)
-        self.select_patcher.start()
-
         ips = ["1.2.3.4", "5.6.7.8", "9.10.11.12"]
         ips = ips * 3
 
@@ -1952,15 +1999,9 @@ def mock_socket_getaddrinfo(host, port, family=0, type=0, proto=0, flags=0):
         )
         self.getaddrinfo_patcher.start()
 
-        # Create maintenance notifications config
-        self.config = MaintNotificationsConfig(
-            enabled=True, proactive_reconnect=True, relaxed_timeout=30
-        )
-
     def teardown_method(self):
         """Clean up test fixtures."""
-        self.socket_patcher.stop()
-        self.select_patcher.stop()
+        super().teardown_method()
         self.getaddrinfo_patcher.stop()
 
     @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])

From 8f56b52162fbf636cad3bd861d06b79cf7a71b48 Mon Sep 17 00:00:00 2001
From: atib jawad zion <atibjawad@gmail.com>
Date: Mon, 29 Sep 2025 16:15:39 +0600
Subject: [PATCH 1124/1164] Adding complex chaining example using pipelines
 with builder pattern (#3774)

---
 docs/examples/pipeline_examples.ipynb | 61 +++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)

diff --git a/docs/examples/pipeline_examples.ipynb b/docs/examples/pipeline_examples.ipynb
index 36ce31d708..72cdab9e38 100644
--- a/docs/examples/pipeline_examples.ipynb
+++ b/docs/examples/pipeline_examples.ipynb
@@ -156,6 +156,67 @@
     "pipe.set(\"a\", \"a value\").set(\"b\", \"b value\").get(\"a\").execute()"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Here's a slightly more advanced example for chaining complex operations using the builder pattern."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from dataclasses import dataclass\n",
+    "from typing import Optional\n",
+    "\n",
+    "@dataclass\n",
+    "class User:\n",
+    "    email: str\n",
+    "    username: Optional[str] = None\n",
+    "\n",
+    "@dataclass\n",
+    "class Post:\n",
+    "    title: str\n",
+    "    body: str\n",
+    "    author: Optional[str] = None\n",
+    "\n",
+    "class RedisRepository:\n",
+    "    def __init__(self):\n",
+    "        self.pipeline = r.pipeline()\n",
+    "\n",
+    "    def add_user(self, user: User):\n",
+    "        if not user.username:\n",
+    "            user.username = user.email.split(\"@\")[0]\n",
+    "        self.pipeline.hset(f\"user:{user.username}\", mapping={\"username\": user.username, \"email\": user.email})\n",
+    "        return self\n",
+    "    \n",
+    "    def add_post(self, post: Post):\n",
+    "        self.pipeline.hset(f\"post:#{post.title}#\", mapping={\"title\": post.title, \"body\": post.body, \"author\": post.author})\n",
+    "        if post.author:\n",
+    "            self.pipeline.sadd(f\"user:{post.author}:posts\", f\"post:#{post.title}#\")\n",
+    "        return self\n",
+    "\n",
+    "    def add_follow(self, follower: str, following: str):\n",
+    "        self.pipeline.sadd(f\"user:{follower}:following\", following)\n",
+    "        self.pipeline.sadd(f\"user:{following}:followers\", follower)\n",
+    "        return self\n",
+    "\n",
+    "    def execute(self):\n",
+    "        return self.pipeline.execute()\n",
+    "\n",
+    "pipe = RedisRepository()\n",
+    "results = (pipe\n",
+    "    .add_user(User(email=\"alice@example.com\"))\n",
+    "    .add_user(User(email=\"bob@example.com\"))\n",
+    "    .add_follow(\"alice\", \"bob\")\n",
+    "    .add_post(Post(title=\"Hello World\", body=\"I'm using Redis!\", author=\"alice\"))\n",
+    "    .execute()\n",
+    ")"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},

From e8317f0d8cc3fa625a3b0616e904ef9930489ba8 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Oct 2025 09:42:43 +0300
Subject: [PATCH 1125/1164] Bump actions/setup-python from 5 to 6 (#3781)

Bumps [actions/setup-python](https://github.com/actions/setup-python) from 5 to 6.
- [Release notes](https://github.com/actions/setup-python/releases)
- [Commits](https://github.com/actions/setup-python/compare/v5...v6)

---
updated-dependencies:
- dependency-name: actions/setup-python
  dependency-version: '6'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/docs.yaml         | 2 +-
 .github/workflows/integration.yaml  | 6 +++---
 .github/workflows/pypi-publish.yaml | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml
index 26e32f1dde..757a5898ff 100644
--- a/.github/workflows/docs.yaml
+++ b/.github/workflows/docs.yaml
@@ -26,7 +26,7 @@ jobs:
      runs-on: ubuntu-latest
      steps:
        - uses: actions/checkout@v5
-       - uses: actions/setup-python@v5
+       - uses: actions/setup-python@v6
          with:
            python-version: 3.9
            cache: 'pip'
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 718702161b..cca7fbb793 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -47,7 +47,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v5
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: 3.9
           cache: 'pip'
@@ -175,7 +175,7 @@ jobs:
         extension: ['tar.gz', 'whl']
     steps:
       - uses: actions/checkout@v5
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: 3.9
       - name: Run installed unit tests
@@ -194,7 +194,7 @@ jobs:
         python-version: ['3.9', '3.10', '3.11', '3.12', '3.13', 'pypy-3.9', 'pypy-3.10']
     steps:
       - uses: actions/checkout@v5
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
           cache: 'pip'
diff --git a/.github/workflows/pypi-publish.yaml b/.github/workflows/pypi-publish.yaml
index 6b7e4dc800..77bbfa9962 100644
--- a/.github/workflows/pypi-publish.yaml
+++ b/.github/workflows/pypi-publish.yaml
@@ -15,7 +15,7 @@ jobs:
     steps:
       - uses: actions/checkout@v5
       - name: install python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: 3.9
       - run: pip install build twine

From eeb4c08cef5f27f16b165e558570921c7b9f3cfc Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Oct 2025 16:00:44 +0300
Subject: [PATCH 1126/1164] Bump rojopolis/spellcheck-github-actions from
 0.51.0 to 0.52.0 (#3782)

Bumps [rojopolis/spellcheck-github-actions](https://github.com/rojopolis/spellcheck-github-actions) from 0.51.0 to 0.52.0.
- [Release notes](https://github.com/rojopolis/spellcheck-github-actions/releases)
- [Changelog](https://github.com/rojopolis/spellcheck-github-actions/blob/master/CHANGELOG.md)
- [Commits](https://github.com/rojopolis/spellcheck-github-actions/compare/0.51.0...0.52.0)

---
updated-dependencies:
- dependency-name: rojopolis/spellcheck-github-actions
  dependency-version: 0.52.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: petyaslavova <petya.slavova@redis.com>
---
 .github/workflows/spellcheck.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/spellcheck.yml b/.github/workflows/spellcheck.yml
index 9daecbc5e4..1517c33947 100644
--- a/.github/workflows/spellcheck.yml
+++ b/.github/workflows/spellcheck.yml
@@ -8,7 +8,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v5
       - name: Check Spelling
-        uses: rojopolis/spellcheck-github-actions@0.51.0
+        uses: rojopolis/spellcheck-github-actions@0.52.0
         with:
           config_path: .github/spellcheck-settings.yml
           task_name: Markdown

From 74f2ede7aa816e6143668095aae30f006bfb7dc1 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Oct 2025 20:58:59 +0300
Subject: [PATCH 1127/1164] Bump actions/stale from 9 to 10 (#3783)

Bumps [actions/stale](https://github.com/actions/stale) from 9 to 10.
- [Release notes](https://github.com/actions/stale/releases)
- [Changelog](https://github.com/actions/stale/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/stale/compare/v9...v10)

---
updated-dependencies:
- dependency-name: actions/stale
  dependency-version: '10'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: petyaslavova <petya.slavova@redis.com>
---
 .github/workflows/stale-issues.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/stale-issues.yml b/.github/workflows/stale-issues.yml
index ba0fb5587e..04fce61c76 100644
--- a/.github/workflows/stale-issues.yml
+++ b/.github/workflows/stale-issues.yml
@@ -20,7 +20,7 @@ jobs:
     steps:
       # First step: Handle regular issues (excluding needs-information)
       - name: Mark regular issues as stale
-        uses: actions/stale@v9
+        uses: actions/stale@v10
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
 
@@ -64,7 +64,7 @@ jobs:
 
       # Second step: Handle needs-information issues with accelerated timeline
       - name: Mark needs-information issues as stale
-        uses: actions/stale@v9
+        uses: actions/stale@v10
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
 

From 028245c73dc0d3e86ef200d3e23af9112939b1c8 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Fri, 3 Oct 2025 17:08:03 +0300
Subject: [PATCH 1128/1164] Update ping command docstrings and method return
 type hint. (#3789)

---
 redis/asyncio/client.py |  7 +++++--
 redis/client.py         |  5 ++++-
 redis/commands/core.py  | 13 ++++++++++---
 3 files changed, 19 insertions(+), 6 deletions(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 3defeceead..0b42ade606 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -1161,9 +1161,12 @@ async def get_message(
             return await self.handle_message(response, ignore_subscribe_messages)
         return None
 
-    def ping(self, message=None) -> Awaitable:
+    def ping(self, message=None) -> Awaitable[bool]:
         """
-        Ping the Redis server
+        Ping the Redis server to test connectivity.
+
+        Sends a PING command to the Redis server and returns True if the server
+        responds with "PONG".
         """
         args = ["PING", message] if message is not None else ["PING"]
         return self.execute_command(*args)
diff --git a/redis/client.py b/redis/client.py
index cf4d77950f..df9a55092d 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1186,7 +1186,10 @@ def get_message(
 
     def ping(self, message: Union[str, None] = None) -> bool:
         """
-        Ping the Redis server
+        Ping the Redis server to test connectivity.
+
+        Sends a PING command to the Redis server and returns True if the server
+        responds with "PONG".
         """
         args = ["PING", message] if message is not None else ["PING"]
         return self.execute_command(*args)
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 737b09811e..ad21885b3d 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1210,11 +1210,18 @@ def latency_reset(self, *events: str) -> ResponseT:
         """
         return self.execute_command("LATENCY RESET", *events)
 
-    def ping(self, **kwargs) -> ResponseT:
+    def ping(self, **kwargs) -> Union[Awaitable[bool], bool]:
         """
-        Ping the Redis server
+        Ping the Redis server to test connectivity.
 
-        For more information, see https://redis.io/commands/ping
+        Sends a PING command to the Redis server and returns True if the server
+        responds with "PONG".
+
+        This command is useful for:
+        - Testing whether a connection is still alive
+        - Verifying the server's ability to serve data
+
+        For more information on the underlying ping command see https://redis.io/commands/ping
         """
         return self.execute_command("PING", **kwargs)
 

From b96d29c40ffa96e75330a933023f2f8eacd5ce64 Mon Sep 17 00:00:00 2001
From: kiryazovi-redis <ivaylo.kiryazov@redis.com>
Date: Mon, 6 Oct 2025 13:05:11 +0300
Subject: [PATCH 1129/1164] Fix automation scenarion maint notification (#3788)

* fix up migrate issues

* fix case where all nodes are full with shards

* fix review issues, add linter fixes

---------

Co-authored-by: petyaslavova <petya.slavova@redis.com>
---
 pyproject.toml                                |  6 +++
 .../maint_notifications_helpers.py            | 43 +++++++++++++------
 .../test_scenario/test_maint_notifications.py | 33 ++++----------
 3 files changed, 44 insertions(+), 38 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index ee061953c5..c95656580a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -80,6 +80,12 @@ filterwarnings = [
     # Ignore a coverage warning when COVERAGE_CORE=sysmon for Pythons < 3.12.
     "ignore:sys.monitoring isn't available:coverage.exceptions.CoverageWarning",
 ]
+log_cli_level = "INFO"
+log_cli_date_format = "%H:%M:%S:%f"
+log_cli = false
+log_cli_format = "%(asctime)s %(levelname)s %(threadName)s: %(message)s"
+log_level = "INFO"
+capture = "yes"
 
 [tool.ruff]
 target-version = "py39"
diff --git a/tests/test_scenario/maint_notifications_helpers.py b/tests/test_scenario/maint_notifications_helpers.py
index 0abc0e067c..f7fb640274 100644
--- a/tests/test_scenario/maint_notifications_helpers.py
+++ b/tests/test_scenario/maint_notifications_helpers.py
@@ -116,8 +116,9 @@ def find_target_node_and_empty_node(
 
         # Get all node IDs from CLUSTER NODES section
         all_nodes = set()
-        nodes_with_shards = set()
-        master_nodes = set()
+        nodes_with_any_shards = set()  # Nodes with shards from ANY database
+        nodes_with_target_db_shards = set()  # Nodes with shards from target database
+        master_nodes = set()  # Master nodes for target database only
 
         for line in lines:
             line = line.strip()
@@ -146,31 +147,45 @@ def find_target_node_and_empty_node(
                 # Parse shard line: db:1  m-standard  redis:1  node:2  master  0-8191  1.4MB  OK
                 parts = line.split()
                 if len(parts) >= 5:
+                    db_id = parts[0]  # db:1, db:2, etc.
                     node_id = parts[3]  # node:2
                     shard_role = parts[4]  # master/slave - this is what matters
 
-                    nodes_with_shards.add(node_id)
-                    if shard_role == "master":
-                        master_nodes.add(node_id)
+                    # Track ALL nodes with shards (for finding truly empty nodes)
+                    nodes_with_any_shards.add(node_id)
+
+                    # Only track master nodes for the specific database we're testing
+                    bdb_id = endpoint_config.get("bdb_id")
+                    if db_id == f"db:{bdb_id}":
+                        nodes_with_target_db_shards.add(node_id)
+                        if shard_role == "master":
+                            master_nodes.add(node_id)
             elif line.startswith("ENDPOINTS:") or not line:
                 shards_section_started = False
 
-        # Find empty node (node with no shards)
-        empty_nodes = all_nodes - nodes_with_shards
+        # Find empty node (node with no shards from ANY database)
+        nodes_with_no_shards_target_bdb = all_nodes - nodes_with_target_db_shards
 
         logging.debug(f"All nodes: {all_nodes}")
-        logging.debug(f"Nodes with shards: {nodes_with_shards}")
-        logging.debug(f"Master nodes: {master_nodes}")
-        logging.debug(f"Empty nodes: {empty_nodes}")
+        logging.debug(f"Nodes with shards from any database: {nodes_with_any_shards}")
+        logging.debug(
+            f"Nodes with target database shards: {nodes_with_target_db_shards}"
+        )
+        logging.debug(f"Master nodes (target database only): {master_nodes}")
+        logging.debug(
+            f"Nodes with no shards from target database: {nodes_with_no_shards_target_bdb}"
+        )
 
-        if not empty_nodes:
-            raise ValueError("No empty nodes (nodes without shards) found")
+        if not nodes_with_no_shards_target_bdb:
+            raise ValueError("All nodes have shards from target database")
 
         if not master_nodes:
-            raise ValueError("No nodes with master shards found")
+            raise ValueError("No nodes with master shards from target database found")
 
         # Return the first available empty node and master node (numeric part only)
-        empty_node = next(iter(empty_nodes)).split(":")[1]  # node:1 -> 1
+        empty_node = next(iter(nodes_with_no_shards_target_bdb)).split(":")[
+            1
+        ]  # node:1 -> 1
         target_node = next(iter(master_nodes)).split(":")[1]  # node:2 -> 2
 
         return target_node, empty_node
diff --git a/tests/test_scenario/test_maint_notifications.py b/tests/test_scenario/test_maint_notifications.py
index a13299bfb7..7d99bfe8ae 100644
--- a/tests/test_scenario/test_maint_notifications.py
+++ b/tests/test_scenario/test_maint_notifications.py
@@ -36,7 +36,7 @@
     datefmt="%Y-%m-%d %H:%M:%S:%f",
 )
 
-BIND_TIMEOUT = 30
+BIND_TIMEOUT = 60
 MIGRATE_TIMEOUT = 60
 FAILOVER_TIMEOUT = 15
 
@@ -109,29 +109,6 @@ def setup_and_cleanup(
             except Exception as e:
                 logging.error(f"Failed to revert failover: {e}")
 
-        if self._migration_executed:
-            try:
-                if self.target_node and self.empty_node:
-                    self._execute_migration(
-                        fault_injector_client=fault_injector_client,
-                        endpoints_config=endpoints_config,
-                        target_node=self.empty_node,
-                        empty_node=self.target_node,
-                    )
-                    logging.info("Migration cleanup completed")
-            except Exception as e:
-                logging.error(f"Failed to revert migration: {e}")
-
-        if self._bind_executed:
-            try:
-                if self.endpoint_id:
-                    self._execute_bind(
-                        fault_injector_client, endpoints_config, self.endpoint_id
-                    )
-                    logging.info("Bind cleanup completed")
-            except Exception as e:
-                logging.error(f"Failed to revert bind endpoint: {e}")
-
         logging.info("Cleanup finished")
 
     def _execute_failover(
@@ -916,7 +893,15 @@ def test_new_connections_receive_migrating(
         )
 
         migrate_thread.join()
+        logging.info("Executing rladmin bind endpoint command for cleanup...")
 
+        bind_thread = Thread(
+            target=self._execute_bind,
+            name="bind_thread",
+            args=(fault_injector_client, endpoints_config, self.endpoint_id),
+        )
+        bind_thread.start()
+        bind_thread.join()
         client_maint_notifications.connection_pool.release(first_conn)
         client_maint_notifications.connection_pool.release(second_connection)
 

From 3471e08ab8af0e972833d1f34564c7fe573c1e98 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Mon, 6 Oct 2025 18:21:49 +0300
Subject: [PATCH 1130/1164] Add redis 8.4-M01-pre to tested redis versions.
 (#3790)

* Updating cicd tests to run against client tests image 8.2.2-pre

* Print version validation details - tmp debug info to investigate why pipeline is not skipping a test

* Skipping tests based on 8.2.2 version comparison.

* Adding 8.4-M01-pre

* Fix skip test condition
---
 .github/workflows/integration.yaml  |  4 ++-
 tests/test_asyncio/test_commands.py | 23 +++++++++++++
 tests/test_asyncio/test_vsets.py    |  4 +--
 tests/test_commands.py              | 51 +++++++++++++++++++++++++++++
 tests/test_vsets.py                 |  4 +--
 5 files changed, 81 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index cca7fbb793..cbd210c14a 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -27,6 +27,8 @@ env:
   CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
   # this speeds up coverage with Python 3.12: https://github.com/nedbat/coveragepy/issues/1665
   COVERAGE_CORE: sysmon
+  # patch releases get included in the base version image when they are published
+  # for example after 8.2.1 is published, 8.2 image contains 8.2.1 content
   CURRENT_CLIENT_LIBS_TEST_STACK_IMAGE_TAG: '8.2'
   CURRENT_REDIS_VERSION: '8.2'
 
@@ -74,7 +76,7 @@ jobs:
       max-parallel: 15
       fail-fast: false
       matrix:
-        redis-version: ['8.2.1-pre', '${{ needs.redis_version.outputs.CURRENT }}', '8.0.2' ,'7.4.4', '7.2.9']
+        redis-version: ['8.4-M01-pre', '${{ needs.redis_version.outputs.CURRENT }}', '8.0.2' ,'7.4.4', '7.2.9']
         python-version: ['3.9', '3.13']
         parser-backend: ['plain']
         event-loop: ['asyncio']
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 9db7d200e6..dda4dc2a1c 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -3158,6 +3158,7 @@ async def test_xgroup_destroy(self, r: redis.Redis):
         assert await r.xgroup_destroy(stream, group)
 
     @skip_if_server_version_lt("7.0.0")
+    @skip_if_server_version_gte("8.2.2")
     async def test_xgroup_setid(self, r: redis.Redis):
         stream = "stream"
         group = "group"
@@ -3178,6 +3179,28 @@ async def test_xgroup_setid(self, r: redis.Redis):
         ]
         assert await r.xinfo_groups(stream) == expected
 
+    @skip_if_server_version_lt("8.2.2")
+    async def test_xgroup_setid_fixed_max_entries_read(self, r):
+        stream = "stream"
+        group = "group"
+        message_id = await r.xadd(stream, {"foo": "bar"})
+        await r.xadd(stream, {"foo1": "bar1"})
+
+        await r.xgroup_create(stream, group, 0)
+        # advance the last_delivered_id to the message_id
+        await r.xgroup_setid(stream, group, message_id, entries_read=2)
+        expected = [
+            {
+                "name": group.encode(),
+                "consumers": 0,
+                "pending": 0,
+                "last-delivered-id": message_id,
+                "entries-read": 2,
+                "lag": 0,
+            }
+        ]
+        assert await r.xinfo_groups(stream) == expected
+
     @skip_if_server_version_lt("7.2.0")
     async def test_xinfo_consumers(self, r: redis.Redis):
         stream = "stream"
diff --git a/tests/test_asyncio/test_vsets.py b/tests/test_asyncio/test_vsets.py
index e2b2bc1d4f..896d98b192 100644
--- a/tests/test_asyncio/test_vsets.py
+++ b/tests/test_asyncio/test_vsets.py
@@ -502,8 +502,8 @@ async def test_vsim_epsilon(d_client):
     await d_client.vset().vadd("myset", [2, 1, 1], "a")
     await d_client.vset().vadd("myset", [2, 0, 1], "b")
     await d_client.vset().vadd("myset", [2, 0, 0], "c")
-    await d_client.vset().vadd("myset", [2, 0, -1], "d")
-    await d_client.vset().vadd("myset", [2, -1, -1], "e")
+    await d_client.vset().vadd("myset", [2, 0, 2], "d")
+    await d_client.vset().vadd("myset", [-2, -1, -1], "e")
 
     res1 = await d_client.vset().vsim("myset", [2, 1, 1])
     assert 5 == len(res1)
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 42530a47d2..2871dc45bf 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -4607,6 +4607,7 @@ def test_xgroup_create_mkstream(self, r):
         assert r.xinfo_groups(stream) == expected
 
     @skip_if_server_version_lt("7.0.0")
+    @skip_if_server_version_gte("8.2.2")
     def test_xgroup_create_entriesread(self, r: redis.Redis):
         stream = "stream"
         group = "group"
@@ -4628,6 +4629,33 @@ def test_xgroup_create_entriesread(self, r: redis.Redis):
         ]
         assert r.xinfo_groups(stream) == expected
 
+    @skip_if_server_version_lt("8.2.2")
+    def test_xgroup_create_entriesread_fixed_max_entries_read(self, r: redis.Redis):
+        stream = "stream"
+        group = "group"
+        r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo1": "bar1"})
+        r.xadd(stream, {"foo2": "bar2"})
+
+        # no group is setup yet, no info to obtain
+        assert r.xinfo_groups(stream) == []
+
+        assert r.xgroup_create(stream, group, 0, entries_read=7)
+        # validate the entries-read is max the number of entries
+        # in the stream and lag shows the entries between
+        # last_delivered_id and entries_added
+        expected = [
+            {
+                "name": group.encode(),
+                "consumers": 0,
+                "pending": 0,
+                "last-delivered-id": b"0-0",
+                "entries-read": 3,
+                "lag": 3,
+            }
+        ]
+        assert r.xinfo_groups(stream) == expected
+
     @skip_if_server_version_lt("5.0.0")
     def test_xgroup_delconsumer(self, r):
         stream = "stream"
@@ -4675,6 +4703,7 @@ def test_xgroup_destroy(self, r):
         assert r.xgroup_destroy(stream, group)
 
     @skip_if_server_version_lt("7.0.0")
+    @skip_if_server_version_gte("8.2.2")
     def test_xgroup_setid(self, r):
         stream = "stream"
         group = "group"
@@ -4695,6 +4724,28 @@ def test_xgroup_setid(self, r):
         ]
         assert r.xinfo_groups(stream) == expected
 
+    @skip_if_server_version_lt("8.2.2")
+    def test_xgroup_setid_fixed_max_entries_read(self, r):
+        stream = "stream"
+        group = "group"
+        message_id = r.xadd(stream, {"foo": "bar"})
+        r.xadd(stream, {"foo1": "bar1"})
+
+        r.xgroup_create(stream, group, 0)
+        # advance the last_delivered_id to the message_id
+        r.xgroup_setid(stream, group, message_id, entries_read=5)
+        expected = [
+            {
+                "name": group.encode(),
+                "consumers": 0,
+                "pending": 0,
+                "last-delivered-id": message_id,
+                "entries-read": 2,
+                "lag": 0,
+            }
+        ]
+        assert r.xinfo_groups(stream) == expected
+
     @skip_if_server_version_lt("7.2.0")
     def test_xinfo_consumers(self, r):
         stream = "stream"
diff --git a/tests/test_vsets.py b/tests/test_vsets.py
index cba7115bf1..36295201e7 100644
--- a/tests/test_vsets.py
+++ b/tests/test_vsets.py
@@ -504,8 +504,8 @@ def test_vsim_epsilon(d_client):
     d_client.vset().vadd("myset", [2, 1, 1], "a")
     d_client.vset().vadd("myset", [2, 0, 1], "b")
     d_client.vset().vadd("myset", [2, 0, 0], "c")
-    d_client.vset().vadd("myset", [2, 0, -1], "d")
-    d_client.vset().vadd("myset", [2, -1, -1], "e")
+    d_client.vset().vadd("myset", [2, 0, 2], "d")
+    d_client.vset().vadd("myset", [-2, -1, -1], "e")
 
     res1 = d_client.vset().vsim("myset", [2, 1, 1])
     assert 5 == len(res1)

From f3806fad528052c7aad202c356fdcf9668ef9ec1 Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Tue, 7 Oct 2025 21:00:14 +0300
Subject: [PATCH 1131/1164] Multi-database client implementation (#3784)

* MultiDbClient implementation (#3696)

* Added Database, Healthcheck, CircuitBreaker, FailureDetector

* Added DatabaseSelector, exceptions, refactored existing entities

* Added MultiDbConfig

* Added DatabaseConfig

* Added DatabaseConfig test coverage

* Renamed DatabaseSelector into FailoverStrategy

* Added CommandExecutor

* Updated healthcheck to close circuit on success

* Added thread-safeness

* Added missing thread-safeness

* Added missing thread-safenes for dispatcher

* Refactored client to keep databases in WeightedList

* Added database CRUD operations

* Added on-fly configuration

* Added background health checks

* Added background healthcheck + half-open event

* Refactored background scheduling

* Refactored healthchecks

* Removed code repetitions, fixed weight assignment, added loops enhancement, fixed data structure

* Refactored configuration

* Refactored failure detector

* Refactored retry logic

* Added scenario tests

* Added pybreaker optional dependency

* Added pybreaker to dev dependencies

* Rename tests directory

* Remove redundant checks

* Handle retries if default is not set

* Removed all Sentinel related

* Added support for Pipeline and transactions (#3707)

* Added Database, Healthcheck, CircuitBreaker, FailureDetector

* Added DatabaseSelector, exceptions, refactored existing entities

* Added MultiDbConfig

* Added DatabaseConfig

* Added DatabaseConfig test coverage

* Renamed DatabaseSelector into FailoverStrategy

* Added CommandExecutor

* Updated healthcheck to close circuit on success

* Added thread-safeness

* Added missing thread-safeness

* Added missing thread-safenes for dispatcher

* Refactored client to keep databases in WeightedList

* Added database CRUD operations

* Added on-fly configuration

* Added background health checks

* Added background healthcheck + half-open event

* Refactored background scheduling

* Added support for Active-Active pipeline

* Refactored healthchecks

* Added Pipeline testing

* Added support for transactions

* Removed code repetitions, fixed weight assignment, added loops enhancement, fixed data structure

* Added missing doc blocks

* Refactored configuration

* Refactored failure detector

* Refactored retry logic

* Added scenario tests

* Added pybreaker optional dependency

* Added pybreaker to dev dependencies

* Rename tests directory

* Added scenario tests for Pipeline and Transaction

* Added handling of ConnectionRefusedError, added timeouts so cluster could recover

* Increased timeouts

* Refactored integration tests

* Fixed property name

* Removed sentinels

* Removed unused method

* Added support for Pub/Sub mode in MultiDbClient (#3722)

* Added Database, Healthcheck, CircuitBreaker, FailureDetector

* Added DatabaseSelector, exceptions, refactored existing entities

* Added MultiDbConfig

* Added DatabaseConfig

* Added DatabaseConfig test coverage

* Renamed DatabaseSelector into FailoverStrategy

* Added CommandExecutor

* Updated healthcheck to close circuit on success

* Added thread-safeness

* Added missing thread-safeness

* Added missing thread-safenes for dispatcher

* Refactored client to keep databases in WeightedList

* Added database CRUD operations

* Added on-fly configuration

* Added background health checks

* Added background healthcheck + half-open event

* Refactored background scheduling

* Added support for Active-Active pipeline

* Refactored healthchecks

* Added Pipeline testing

* Added support for transactions

* Removed code repetitions, fixed weight assignment, added loops enhancement, fixed data structure

* Added missing doc blocks

* Added support for Pub/Sub in MultiDBClient

* Refactored configuration

* Refactored failure detector

* Refactored retry logic

* Added scenario tests

* Added pybreaker optional dependency

* Added pybreaker to dev dependencies

* Rename tests directory

* Added scenario tests for Pipeline and Transaction

* Added handling of ConnectionRefusedError, added timeouts so cluster could recover

* Increased timeouts

* Refactored integration tests

* Added scenario tests for Pub/Sub

* Updated healthcheck retry

* Increased timeout to avoid unprepared state before tests

* Added backoff retry and changed timeouts

* Added retry for healthchecks to avoid fluctuations

* Changed retry configuration for healthchecks

* Fixed property name

* Added check for thread results

* Refactored docblocks (#3744)

* Refactored healthcheck and failure detector to extend default one (#3747)

* Added MultiDbClient support with OSS Cluster API (#3734)

* Added Database, Healthcheck, CircuitBreaker, FailureDetector

* Added DatabaseSelector, exceptions, refactored existing entities

* Added MultiDbConfig

* Added DatabaseConfig

* Added DatabaseConfig test coverage

* Renamed DatabaseSelector into FailoverStrategy

* Added CommandExecutor

* Updated healthcheck to close circuit on success

* Added thread-safeness

* Added missing thread-safeness

* Added missing thread-safenes for dispatcher

* Refactored client to keep databases in WeightedList

* Added database CRUD operations

* Added on-fly configuration

* Added background health checks

* Added background healthcheck + half-open event

* Refactored background scheduling

* Added support for Active-Active pipeline

* Refactored healthchecks

* Added Pipeline testing

* Added support for transactions

* Removed code repetitions, fixed weight assignment, added loops enhancement, fixed data structure

* Added missing doc blocks

* Added support for Pub/Sub in MultiDBClient

* Refactored configuration

* Refactored failure detector

* Refactored retry logic

* Added scenario tests

* Added pybreaker optional dependency

* Added pybreaker to dev dependencies

* Rename tests directory

* Added scenario tests for Pipeline and Transaction

* Added handling of ConnectionRefusedError, added timeouts so cluster could recover

* Increased timeouts

* Refactored integration tests

* Added scenario tests for Pub/Sub

* Updated healthcheck retry

* Increased timeout to avoid unprepared state before tests

* Added backoff retry and changed timeouts

* Added retry for healthchecks to avoid fluctuations

* Changed retry configuration for healthchecks

* Fixed property name

* Added check for thread results

* Added MultiDbClient support with OSS Cluster API

* Removed database statuses

* Increased test timeouts

* Increased retry timeout

* Increased timeout retries

* Updated base threshold for retries

* Fixed flacky tests

* Added missing docblocks

* Added LagAwareHealthCheck for MultiDBClient (#3737)

* Added LagAwareHealthcheck

* Added testing for LagAwareHealthCheck

* Fixed timeouts

* Added lag tollerance parameter

* Decreased messages_count due to increased timeouts

* Added docblocks

* Added missing type hints

* Fixed url

* Refactored tests, URL and cluster support

* Use primary node to send an API request

* Added comment about RE bug

* Moved None type to the beginning

* Added health_check_url property to Database class

* Added lag_aware_tolerance parameter to LagAwareHealthcheck (#3752)

* Extract additional interfaces and abstract classes (#3754)

* Added async implementation of MultiDBClient (#3762)

* Extract additional interfaces and abstract classes

* Added base async components

* Added command executor

* Added recurring background tasks with event loop only

* Added MultiDBClient

* Added scenario and config tests

* Update redis/asyncio/multidb/healthcheck.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update tests/test_asyncio/test_scenario/test_active_active.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Added pipeline and transaction support for MultiDBClient (#3763)

* Extract additional interfaces and abstract classes

* Added base async components

* Added command executor

* Added recurring background tasks with event loop only

* Added MultiDBClient

* Added scenario and config tests

* Added pipeline and transaction support for MultiDBClient

* Updated scenario tests to check failover

* Added pub/sub support for MultiDBClient (#3764)

* Extract additional interfaces and abstract classes

* Added base async components

* Added command executor

* Added recurring background tasks with event loop only

* Added MultiDBClient

* Added scenario and config tests

* Added pipeline and transaction support for MultiDBClient

* Added pub/sub support for MultiDBClient

* Added check for couroutines methods for pub/sub

* Added support for Lag-Aware Healthcheck and OSS Cluster API (#3768)

* Extract additional interfaces and abstract classes

* Added base async components

* Added command executor

* Added recurring background tasks with event loop only

* Added MultiDBClient

* Added scenario and config tests

* Added pipeline and transaction support for MultiDBClient

* Added pub/sub support for MultiDBClient

* Added check for couroutines methods for pub/sub

* Added OSS Cluster API support for MultiDBCLient

* Added support for Lag-Aware Healthcheck and OSS Cluster API

* Increased timeouts between tests

* Fixed space

* Refactored Healthcheck and Failover strategy logic (#3771)

* Extract additional interfaces and abstract classes

* Added base async components

* Added command executor

* Added recurring background tasks with event loop only

* Added MultiDBClient

* Added scenario and config tests

* Added pipeline and transaction support for MultiDBClient

* Added pub/sub support for MultiDBClient

* Added check for couroutines methods for pub/sub

* Added OSS Cluster API support for MultiDBCLient

* Added support for Lag-Aware Healthcheck and OSS Cluster API

* Increased timeouts between tests

* [Sync] Refactored healthcheck

* [Async] Refactored healthcheck

* [Sync] Refactored Failover Strategy

* [Async] Refactored Failover Strategy

* Changed default values according to a design doc

* [Async] Added Strategy Executor

* [Sync] Added Strategy Executor

* Apply comments

* Removed redundant dependency

* Fixed async tests

* Increased lag-aware tolerance

* Fixed typing issue, increase health_check_interval, added timeout handling

* Decreased retry cap, increased failure delay

* Fixed async teardown

* Fixed tests

* Added graceful connection closing, added graceful hc tasks termination

* Make sure active connection will be disconnected on failover

* Close cluster connection on failover

* Refactored Failure Detector (#3775)

* Decreased timeouts

* Added missing fixture

* Fixed None exception

* Codestyle changes

* Codestyle changes

* Skip async scenario tests

* Codestyle change

* Fixed unused arguments

* Refactored bg scheduler

* Fixed tests

* Fixed tests

* Codestyle fixes

* Reduce timeouts to avoid overlaping with healthcheck

* Marked tests non-clsuter only

* Update timeouts

* Skip scenario tests

* Updated timeouts

* Increased timeout

* Refactored tests

* Codestyle changes

* Added documentation for Active-Active (#3753)

* Added Active-Active documentation page

* Added documentation for Active-Active

* Refactored docs

* Refactored pipeline and transaction section

* Updated docs

* Extended list of words

* Re-write documentation

* Fixed spelling

* Update docs/multi_database.rst

Co-authored-by: Elena Kolevska <elena-kolevska@users.noreply.github.com>

* Apply suggested comments

* Fixed spelling

* Update docs/multi_database.rst

Co-authored-by: Elena Kolevska <elena-kolevska@users.noreply.github.com>

* Update docs/multi_database.rst

Co-authored-by: Elena Kolevska <elena-kolevska@users.noreply.github.com>

* Update docs/multi_database.rst

Co-authored-by: Elena Kolevska <elena-kolevska@users.noreply.github.com>

---------

Co-authored-by: Elena Kolevska <elena-kolevska@users.noreply.github.com>

* Refactor unstable tests

* Marked tests as non-clustered

* Codestyle changes

* Skipped tests in validating workflow

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: petyaslavova <petya.slavova@redis.com>
Co-authored-by: Elena Kolevska <elena-kolevska@users.noreply.github.com>
---
 .github/wordlist.txt                          |  19 +
 .github/workflows/install_and_test.sh         |   3 +-
 dev_requirements.txt                          |   1 +
 docs/multi_database.rst                       | 521 +++++++++++++++
 pyproject.toml                                |   3 +
 redis/asyncio/client.py                       |  12 +-
 redis/asyncio/cluster.py                      |   6 +-
 redis/asyncio/connection.py                   |  18 +
 redis/asyncio/http/__init__.py                |   0
 redis/asyncio/http/http_client.py             | 265 ++++++++
 redis/asyncio/multidb/__init__.py             |   0
 redis/asyncio/multidb/client.py               | 528 +++++++++++++++
 redis/asyncio/multidb/command_executor.py     | 339 ++++++++++
 redis/asyncio/multidb/config.py               | 210 ++++++
 redis/asyncio/multidb/database.py             |  69 ++
 redis/asyncio/multidb/event.py                |  84 +++
 redis/asyncio/multidb/failover.py             | 125 ++++
 redis/asyncio/multidb/failure_detector.py     |  38 ++
 redis/asyncio/multidb/healthcheck.py          | 292 ++++++++
 redis/background.py                           | 204 ++++++
 redis/client.py                               |  20 +-
 redis/cluster.py                              |   4 +-
 redis/data_structure.py                       |  81 +++
 redis/event.py                                |  94 ++-
 redis/http/__init__.py                        |   0
 redis/http/http_client.py                     | 425 ++++++++++++
 redis/multidb/__init__.py                     |   0
 redis/multidb/circuit.py                      | 144 ++++
 redis/multidb/client.py                       | 524 +++++++++++++++
 redis/multidb/command_executor.py             | 350 ++++++++++
 redis/multidb/config.py                       | 207 ++++++
 redis/multidb/database.py                     | 130 ++++
 redis/multidb/event.py                        |  89 +++
 redis/multidb/exception.py                    |  17 +
 redis/multidb/failover.py                     | 125 ++++
 redis/multidb/failure_detector.py             | 104 +++
 redis/multidb/healthcheck.py                  | 289 ++++++++
 redis/retry.py                                |  15 +-
 redis/utils.py                                |  14 +
 tasks.py                                      |   8 +-
 tests/conftest.py                             |   7 +
 tests/test_asyncio/test_connection_pool.py    |   3 +
 tests/test_asyncio/test_multidb/__init__.py   |   0
 tests/test_asyncio/test_multidb/conftest.py   | 131 ++++
 .../test_asyncio/test_multidb/test_client.py  | 628 ++++++++++++++++++
 .../test_multidb/test_command_executor.py     | 181 +++++
 .../test_asyncio/test_multidb/test_config.py  | 166 +++++
 .../test_multidb/test_failover.py             | 169 +++++
 .../test_multidb/test_failure_detector.py     | 128 ++++
 .../test_multidb/test_healthcheck.py          | 401 +++++++++++
 .../test_multidb/test_pipeline.py             | 488 ++++++++++++++
 tests/test_asyncio/test_scenario/__init__.py  |   0
 tests/test_asyncio/test_scenario/conftest.py  | 116 ++++
 .../test_scenario/test_active_active.py       | 420 ++++++++++++
 tests/test_background.py                      |  94 +++
 tests/test_data_structure.py                  |  94 +++
 tests/test_event.py                           |  67 ++
 tests/test_http/__init__.py                   |   0
 tests/test_http/test_http_client.py           | 371 +++++++++++
 tests/test_maint_notifications_handling.py    |   3 +
 tests/test_multidb/__init__.py                |   0
 tests/test_multidb/conftest.py                | 131 ++++
 tests/test_multidb/test_circuit.py            |  57 ++
 tests/test_multidb/test_client.py             | 615 +++++++++++++++++
 tests/test_multidb/test_command_executor.py   | 173 +++++
 tests/test_multidb/test_config.py             | 161 +++++
 tests/test_multidb/test_failover.py           | 161 +++++
 tests/test_multidb/test_failure_detector.py   | 117 ++++
 tests/test_multidb/test_healthcheck.py        | 385 +++++++++++
 tests/test_multidb/test_pipeline.py           | 489 ++++++++++++++
 tests/test_scenario/conftest.py               | 122 +++-
 tests/test_scenario/test_active_active.py     | 460 +++++++++++++
 72 files changed, 11689 insertions(+), 26 deletions(-)
 create mode 100644 docs/multi_database.rst
 create mode 100644 redis/asyncio/http/__init__.py
 create mode 100644 redis/asyncio/http/http_client.py
 create mode 100644 redis/asyncio/multidb/__init__.py
 create mode 100644 redis/asyncio/multidb/client.py
 create mode 100644 redis/asyncio/multidb/command_executor.py
 create mode 100644 redis/asyncio/multidb/config.py
 create mode 100644 redis/asyncio/multidb/database.py
 create mode 100644 redis/asyncio/multidb/event.py
 create mode 100644 redis/asyncio/multidb/failover.py
 create mode 100644 redis/asyncio/multidb/failure_detector.py
 create mode 100644 redis/asyncio/multidb/healthcheck.py
 create mode 100644 redis/background.py
 create mode 100644 redis/data_structure.py
 create mode 100644 redis/http/__init__.py
 create mode 100644 redis/http/http_client.py
 create mode 100644 redis/multidb/__init__.py
 create mode 100644 redis/multidb/circuit.py
 create mode 100644 redis/multidb/client.py
 create mode 100644 redis/multidb/command_executor.py
 create mode 100644 redis/multidb/config.py
 create mode 100644 redis/multidb/database.py
 create mode 100644 redis/multidb/event.py
 create mode 100644 redis/multidb/exception.py
 create mode 100644 redis/multidb/failover.py
 create mode 100644 redis/multidb/failure_detector.py
 create mode 100644 redis/multidb/healthcheck.py
 create mode 100644 tests/test_asyncio/test_multidb/__init__.py
 create mode 100644 tests/test_asyncio/test_multidb/conftest.py
 create mode 100644 tests/test_asyncio/test_multidb/test_client.py
 create mode 100644 tests/test_asyncio/test_multidb/test_command_executor.py
 create mode 100644 tests/test_asyncio/test_multidb/test_config.py
 create mode 100644 tests/test_asyncio/test_multidb/test_failover.py
 create mode 100644 tests/test_asyncio/test_multidb/test_failure_detector.py
 create mode 100644 tests/test_asyncio/test_multidb/test_healthcheck.py
 create mode 100644 tests/test_asyncio/test_multidb/test_pipeline.py
 create mode 100644 tests/test_asyncio/test_scenario/__init__.py
 create mode 100644 tests/test_asyncio/test_scenario/conftest.py
 create mode 100644 tests/test_asyncio/test_scenario/test_active_active.py
 create mode 100644 tests/test_background.py
 create mode 100644 tests/test_data_structure.py
 create mode 100644 tests/test_event.py
 create mode 100644 tests/test_http/__init__.py
 create mode 100644 tests/test_http/test_http_client.py
 create mode 100644 tests/test_multidb/__init__.py
 create mode 100644 tests/test_multidb/conftest.py
 create mode 100644 tests/test_multidb/test_circuit.py
 create mode 100644 tests/test_multidb/test_client.py
 create mode 100644 tests/test_multidb/test_command_executor.py
 create mode 100644 tests/test_multidb/test_config.py
 create mode 100644 tests/test_multidb/test_failover.py
 create mode 100644 tests/test_multidb/test_failure_detector.py
 create mode 100644 tests/test_multidb/test_healthcheck.py
 create mode 100644 tests/test_multidb/test_pipeline.py
 create mode 100644 tests/test_scenario/test_active_active.py

diff --git a/.github/wordlist.txt b/.github/wordlist.txt
index 150f96a624..0a69b9092a 100644
--- a/.github/wordlist.txt
+++ b/.github/wordlist.txt
@@ -1,7 +1,9 @@
 APM
 ARGV
 BFCommands
+balancer
 CacheImpl
+cancelling
 CAS
 CFCommands
 CMSCommands
@@ -10,10 +12,20 @@ ClusterNodes
 ClusterPipeline
 ClusterPubSub
 ConnectionPool
+config
 CoreCommands
+DatabaseConfig
+DNS
+EchoHealthCheck
 EVAL
 EVALSHA
+failover
+FQDN
 Grokzen's
+Healthcheck
+HealthCheckPolicies
+healthcheck
+healthchecks
 INCR
 IOError
 Instrumentations
@@ -21,8 +33,11 @@ JSONCommands
 Jaeger
 Ludovico
 Magnocavallo
+MultiDbConfig
+MultiDBClient
 McCurdy
 NOSCRIPT
+NoValidDatabaseException
 NUMPAT
 NUMPT
 NUMSUB
@@ -43,6 +58,7 @@ RedisInstrumentor
 RedisJSON
 RedisTimeSeries
 SHA
+SLA
 SearchCommands
 SentinelCommands
 SentinelConnectionPool
@@ -52,6 +68,8 @@ SpanKind
 Specfiying
 StatusCode
 TCP
+TemporaryUnavailableException
+TLS
 TOPKCommands
 TimeSeriesCommands
 Uptrace
@@ -91,6 +109,7 @@ json
 keyslot
 keyspace
 kwarg
+kwargs
 linters
 localhost
 lua
diff --git a/.github/workflows/install_and_test.sh b/.github/workflows/install_and_test.sh
index c90027389c..a83cef4089 100755
--- a/.github/workflows/install_and_test.sh
+++ b/.github/workflows/install_and_test.sh
@@ -40,11 +40,12 @@ cd ${TESTDIR}
 # install, run tests
 pip install ${PKG}
 # Redis tests
-pytest -m 'not onlycluster' --ignore=tests/test_scenario
+pytest -m 'not onlycluster' --ignore=tests/test_scenario --ignore=tests/test_asyncio/test_scenario
 # RedisCluster tests
 CLUSTER_URL="redis://localhost:16379/0"
 CLUSTER_SSL_URL="rediss://localhost:27379/0"
 pytest -m 'not onlynoncluster and not redismod and not ssl' \
   --ignore=tests/test_scenario \
+  --ignore=tests/test_asyncio/test_scenario \
   --redis-url="${CLUSTER_URL}" \
   --redis-ssl-url="${CLUSTER_SSL_URL}"
diff --git a/dev_requirements.txt b/dev_requirements.txt
index 848d6207c4..e61f37f101 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -14,3 +14,4 @@ uvloop
 vulture>=2.3.0
 numpy>=1.24.0
 redis-entraid==1.0.0
+pybreaker>=1.4.0
diff --git a/docs/multi_database.rst b/docs/multi_database.rst
new file mode 100644
index 0000000000..6906b09e4d
--- /dev/null
+++ b/docs/multi_database.rst
@@ -0,0 +1,521 @@
+Multi-database client (Active-Active)
+=====================================
+
+The multi-database client lets you connect your application to multiple logical Redis databases at once
+and operate them as a single, resilient endpoint. It continuously monitors health, detects failures,
+and fails over to the next healthy database using a configurable strategy. When the previous primary
+becomes healthy again, the client can automatically fall back to it.
+
+Key concepts
+------------
+
+- Database and weight:
+  Each database has a weight indicating its priority. The failover strategy chooses the highest-weight
+  healthy database as the active one.
+
+- Circuit breaker:
+  Each database is guarded by a circuit breaker with states CLOSED (healthy), OPEN (unhealthy),
+  and HALF_OPEN (probing). Health checks toggle these states to avoid hammering a downed database.
+
+- Health checks:
+  A set of checks determines whether a database is healthy in proactive manner.
+  By default, an "ECHO" check runs against the database (all cluster nodes must
+  pass for a cluster). You can add custom checks. A Redis Enterprise specific
+  "lag-aware" health check is also available.
+
+- Failure detector:
+  A detector observes command failures over a moving window (reactive monitoring).
+  You can specify an exact number of failures and failures rate to have more
+  fine-grain tuned configuration of triggering fail over based on organic traffic.
+
+- Failover strategy:
+  The default strategy is weight-based. It prefers the highest-weight healthy database.
+
+- Command retry:
+  Command execution supports retry with backoff. Low-level client retries are disabled and a global retry
+  setting is applied at the multi-database layer.
+
+- Auto fallback:
+  If configured with a positive interval, the client periodically attempts to fall back to a higher-priority
+  healthy database.
+
+- Events:
+  The client emits events like "active database changed" and "commands failed". Pub/Sub re-subscription
+  on database switch is handled automatically.
+
+Synchronous usage
+-----------------
+
+Minimal example
+^^^^^^^^^^^^^^^
+
+.. code-block:: python
+
+    from redis.multidb.client import MultiDBClient
+    from redis.multidb.config import MultiDbConfig, DatabaseConfig
+
+    # Two databases. The first has higher weight -> preferred when healthy.
+    cfg = MultiDbConfig(
+        databases_config=[
+            DatabaseConfig(from_url="redis://db-primary:6379/0", weight=1.0),
+            DatabaseConfig(from_url="redis://db-secondary:6379/0", weight=0.5),
+        ]
+    )
+
+    client = MultiDBClient(cfg)
+
+    # First call triggers initialization and health checks.
+    client.set("key", "value")
+    print(client.get("key"))
+
+    # Pipeline
+    with client.pipeline() as pipe:
+        pipe.set("a", 1)
+        pipe.incrby("a", 2)
+        values = pipe.execute()
+        print(values)
+
+    # Transaction
+    def txn(pipe):
+        current = pipe.get("balance")
+        current = int(current or 0)
+        pipe.multi()  # mark transaction
+        pipe.set("balance", current + 100)
+
+    client.transaction(txn)
+
+    # Pub/Sub usage - will automatically re-subscribe on database switch
+    pubsub = client.pubsub()
+    pubsub.subscribe("events")
+
+    # In your loop:
+    message = pubsub.get_message(timeout=1.0)
+    if message:
+        print(message)
+
+Asyncio usage
+-------------
+
+The asyncio API mirrors the synchronous one and provides async/await semantics.
+
+.. code-block:: python
+
+    import asyncio
+    from redis.asyncio.multidb.client import MultiDBClient
+    from redis.asyncio.multidb.config import MultiDbConfig, DatabaseConfig
+
+    async def main():
+        cfg = MultiDbConfig(
+            databases_config=[
+                DatabaseConfig(from_url="redis://db-primary:6379/0", weight=1.0),
+                DatabaseConfig(from_url="redis://db-secondary:6379/0", weight=0.5),
+            ]
+        )
+
+        # Context-manager approach for graceful client termination when exits.
+        # client = MultiDBClient(cfg) could be used instead
+        async with MultiDBClient(cfg) as client:
+            await client.set("key", "value")
+            print(await client.get("key"))
+
+        # Pipeline
+        async with client.pipeline() as pipe:
+            pipe.set("a", 1)
+            pipe.incrby("a", 2)
+            values = await pipe.execute()
+            print(values)
+
+        # Transaction
+        async def txn(pipe):
+            current = await pipe.get("balance")
+            current = int(current or 0)
+            await pipe.multi()
+            await pipe.set("balance", current + 100)
+
+        await client.transaction(txn)
+
+        # Pub/Sub
+        pubsub = client.pubsub()
+        await pubsub.subscribe("events")
+        message = await pubsub.get_message(timeout=1.0)
+        if message:
+            print(message)
+
+    asyncio.run(main())
+
+
+MultiDBClient
+^^^^^^^^^^^^^
+
+The client exposes the same API as the `Redis` or `RedisCluster` client, making it fully interchangeable and ensuring a seamless upgrade for your application. Additionally, it supports runtime reconfiguration, allowing you to add features such as health checks, failure detectors, or even new databases without restarting.
+
+Configuration
+-------------
+
+MultiDbConfig
+^^^^^^^^^^^^^
+
+.. code-block:: python
+
+    from redis.multidb.config import (
+        MultiDbConfig, DatabaseConfig,
+        DEFAULT_HEALTH_CHECK_INTERVAL, DEFAULT_GRACE_PERIOD
+    )
+    from redis.retry import Retry
+    from redis.backoff import ExponentialWithJitterBackoff
+
+    cfg = MultiDbConfig(
+        databases_config=[
+            # Construct via URL
+            DatabaseConfig(
+                from_url="redis://db-a:6379/0",
+                weight=1.0,
+                # Optional: use a custom circuit breaker grace period
+                grace_period=DEFAULT_GRACE_PERIOD,
+                # Optional: Redis Enterprise cluster FQDN for REST health checks
+                health_check_url="https://cluster.example.com",
+                # Optional: Underlying Redis client related configuration
+                client_kwargs={"socket_timeout": 5}
+            ),
+            # Or construct via ConnectionPool
+            # DatabaseConfig(from_pool=my_pool, weight=1.0),
+        ],
+
+        # Global command retry policy (applied at multi-db layer)
+        command_retry=Retry(
+            retries=3,
+            backoff=ExponentialWithJitterBackoff(base=1, cap=10),
+        ),
+
+        # Health checks
+        health_check_interval: float = DEFAULT_HEALTH_CHECK_INTERVAL # seconds
+        health_check_probes: int = DEFAULT_HEALTH_CHECK_PROBES
+        health_check_delay: float = DEFAULT_HEALTH_CHECK_DELAY # seconds
+        health_check_policy: HealthCheckPolicies = DEFAULT_HEALTH_CHECK_POLICY,
+
+        # Failure detector
+        min_num_failures: int = DEFAULT_MIN_NUM_FAILURES
+        failure_rate_threshold: float = DEFAULT_FAILURE_RATE_THRESHOLD
+        failures_detection_window: float = DEFAULT_FAILURES_DETECTION_WINDOW # seconds
+
+        # Failover behavior
+        failover_attempts: int = DEFAULT_FAILOVER_ATTEMPTS
+        failover_delay: float = DEFAULT_FAILOVER_DELAY # seconds
+    )
+
+Notes:
+
+- Low-level client retries are disabled automatically per database. The multi-database layer handles retries.
+- For clusters, health checks validate all nodes.
+
+DatabaseConfig
+^^^^^^^^^^^^^^
+
+Each database needs a `DatabaseConfig` that specifies how to connect.
+
+Method 1: Using client_kwargs (most flexible)
+~~~~~~~~~~~~~~~~~~~~~
+There's an underlying instance of `Redis` or `RedisCluster` client for each database,
+so you can pass all the arguments related to them via `client_kwargs` argument:
+
+.. code:: python
+    database_config = DatabaseConfig(
+        weight=1.0,
+        client_kwargs={
+            'host': 'localhost',
+            'port': 6379,
+            'username': "username",
+            'password': "password",
+        }
+    )
+
+Method 2: Using Redis URL
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code:: python
+    database_config1 = DatabaseConfig(
+        weight=1.0,
+        from_url="redis://host1:port1",
+        client_kwargs={
+            'username': "username",
+            'password': "password",
+        }
+    )
+
+Method 3: Using Custom Connection Pool
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code:: python
+  database_config2 = DatabaseConfig(
+      weight=0.9,
+      from_pool=connection_pool,
+  )
+
+**Important**: Don't pass `Retry` objects in `client_kwargs`. `MultiDBClient`
+handles all retries at the top level through the `command_retry` configuration.
+
+Health Monitoring
+-----------------
+The `MultiDBClient` uses two complementary mechanisms to ensure database availability:
+- Health Checks (Proactive Monitoring)
+- Failure Detection (Reactive Monitoring)
+
+
+Health Checks (Proactive Monitoring)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+These checks run continuously in the background at configured intervals to proactively
+detect database issues. They run in the background with a given interval and
+configuration defined in the `MultiDBConfig` class.
+
+To avoid false positives, you can configure amount of health check probes and also
+define one of the health check policies to evaluate probes result.
+
+**HealthCheckPolicies.HEALTHY_ALL** - (default) All probes should be successful. 
+**HealthCheckPolicies.HEALTHY_MAJORITY** - Majority of probes should be successful. 
+**HealthCheckPolicies.HEALTHY_ANY** - Any of probes should be successful. 
+
+EchoHealthCheck (default)
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The default health check sends the [ECHO](https://redis.io/docs/latest/commands/echo/) command
+to the database (and to all nodes for clusters).
+
+Lag-Aware Healthcheck (Redis Enterprise Only)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+This is a special type of healthcheck available for Redis Software and Redis Cloud
+that utilizes a REST API endpoint to obtain information about the synchronization
+lag between a given database and all other databases in an Active-Active setup.
+
+To use this healthcheck, first you need to adjust your `DatabaseConfig`
+to expose `health_check_url` used by your deployment. By default, your
+Cluster FQDN should be used as URL, unless you have some kind of
+reverse proxy behind an actual REST API endpoint.
+
+.. code-block:: python
+
+    from redis.multidb.client import MultiDBClient
+    from redis.multidb.config import MultiDbConfig, DatabaseConfig
+    from redis.multidb.healthcheck import EchoHealthCheck, LagAwareHealthCheck
+    from redis.retry import Retry
+    from redis.backoff import ExponentialWithJitterBackoff
+
+    cfg = MultiDbConfig(
+        databases_config=[
+            DatabaseConfig(
+                from_url="redis://db-primary:6379/0",
+                weight=1.0,
+                health_check_url="https://cluster.example.com",  # optional for LagAware
+            ),
+            DatabaseConfig(
+                from_url="redis://db-secondary:6379/0",
+                weight=0.5,
+                health_check_url="https://cluster.example.com",
+            ),
+        ],
+        # Add custom checks (in addition to default EchoHealthCheck)
+        health_checks=[
+            # Redis Enterprise REST-based lag-aware check
+            LagAwareHealthCheck(
+                # Customize REST port, lag tolerance, TLS, etc.
+                rest_api_port=9443,
+                lag_aware_tolerance=100,  # ms
+                verify_tls=True,
+                # auth_basic=("user", "pass"),
+                # ca_file="/path/ca.pem",
+                # client_cert_file="/path/cert.pem",
+                # client_key_file="/path/key.pem",
+            ),
+        ],
+    )
+
+    client = MultiDBClient(cfg)
+
+
+**Custom Health Checks**
+~~~~~~~~~~~~~~~~~~~~~
+You can add custom health checks for specific requirements:
+
+.. code-block:: python
+
+    from redis.multidb.healthcheck import AbstractHealthCheck
+    from redis.retry import Retry
+    from redis.utils import dummy_fail
+    class PingHealthCheck(AbstractHealthCheck):
+        def __init__(self, retry: Retry):
+            super().__init__(retry=retry)
+        def check_health(self, database) -> bool:
+            return self._retry.call_with_retry(
+                lambda: self._returns_pong(database),
+                lambda _: dummy_fail()
+            )
+        def _returns_pong(self, database) -> bool:
+            expected_message = ["PONG", b"PONG"]
+            actual_message = database.client.execute_command("PING")
+            return actual_message in expected_message
+
+
+Failure Detection (Reactive Monitoring)
+-----------------
+
+The failure detector monitor actual command failures and marks databases as unhealthy
+when failures count and failure rate exceed thresholds within a sliding time window
+of a few seconds. This catches issues that proactive health checks might miss during
+real traffic. You can extend the list of failure detectors by providing your own
+implementation, configuration defined in the `MultiDBConfig` class.
+
+By default failure detector is configured for 1000 failures and 10% failure rate
+threshold within a 2 seconds sliding window, this could be adjusted regarding
+your application specifics and traffic.
+
+.. code-block:: python
+
+    from redis.multidb.config import MultiDbConfig, DatabaseConfig
+    from redis.multidb.client import MultiDBClient
+
+    cfg = MultiDbConfig(
+        databases_config=[
+            DatabaseConfig(from_url="redis://db-a:6379/0", weight=1.0),
+            DatabaseConfig(from_url="redis://db-b:6379/0", weight=0.5),
+        ],
+        # Default detector also created from config values
+    )
+
+    client = MultiDBClient(cfg)
+
+    # Add an additional detector, optionally limited to specific exception types:
+    client.add_failure_detector(
+        CustomFailureDetector()
+    )
+
+Failover and auto fallback
+--------------------------
+
+Weight-based failover chooses the highest-weight database whose circuit is CLOSED. If no database is
+healthy it returns `TemporaryUnavailableException`. This exception indicates that application can
+still send requests for some time (depends on configuration (`failover_attempts` * `failover_delay`)
+120 seconds by default) until `NoValidDatabaseException` will be thrown.
+
+To enable periodic fallback to a higher-priority healthy database, set `auto_fallback_interval` (seconds):
+
+.. code-block:: python
+
+    from redis.multidb.config import MultiDbConfig, DatabaseConfig
+
+    cfg = MultiDbConfig(
+        databases_config=[
+            DatabaseConfig(from_url="redis://db-primary:6379/0", weight=1.0),
+            DatabaseConfig(from_url="redis://db-secondary:6379/0", weight=0.5),
+        ],
+        # Try to fallback to higher-weight healthy database every 30 seconds
+        auto_fallback_interval=30.0,
+    )
+    client = MultiDBClient(cfg)
+
+Managing databases at runtime
+-----------------------------
+
+You can manually add/remove databases, update weights, and promote a database if it’s healthy.
+
+.. code-block:: python
+
+    from redis.multidb.client import MultiDBClient
+    from redis.multidb.config import MultiDbConfig, DatabaseConfig
+    from redis.multidb.database import Database
+    from redis.multidb.circuit import PBCircuitBreakerAdapter
+    import pybreaker
+    from redis import Redis
+
+    cfg = MultiDbConfig(
+        databases_config=[DatabaseConfig(from_url="redis://db-a:6379/0", weight=1.0)]
+    )
+    client = MultiDBClient(cfg)
+
+    # Add a database programmatically
+    other = Database(
+        client=Redis.from_url("redis://db-b:6379/0"),
+        circuit=PBCircuitBreakerAdapter(pybreaker.CircuitBreaker(reset_timeout=5.0)),
+        weight=0.5,
+        health_check_url=None,
+    )
+    client.add_database(other)
+
+    # Update weight; if it becomes the highest and healthy, it may become active
+    client.update_database_weight(other, 0.9)
+
+    # Promote a specific healthy database to active
+    client.set_active_database(other)
+
+    # Remove a database
+    client.remove_database(other)
+
+Pub/Sub and re-subscription
+--------------------------
+
+The MultiDBClient offers Pub/Sub functionality with automatic re-subscription
+to channels during failover events. For optimal failover handling,
+both publishers and subscribers should use MultiDBClient instances.
+
+1. **Subscriber failover**: Automatically reconnects to an alternative database
+and re-subscribes to the same channels
+2. **Publisher failover**: Seamlessly switches to an alternative database and
+continues publishing to the same channels
+**Note**: Message loss may occur if failover events happen in reverse order
+(publisher fails before subscriber).
+
+.. code-block:: python
+
+    pubsub = client.pubsub()
+    pubsub.subscribe("news", "alerts")
+    # If failover happens here, subscriptions are re-established on the new active DB.
+    msg = pubsub.get_message(timeout=1.0)
+    if msg:
+        print(msg)
+
+Pipelines and transactions
+--------------------------
+
+Pipelines and transactions are executed against the active database at execution time. The client ensures
+the active database is healthy and up-to-date before running the stack.
+
+.. code-block:: python
+
+    with client.pipeline() as pipe:
+        pipe.set("x", 1)
+        pipe.incr("x")
+        results = pipe.execute()
+
+    def txn(pipe):
+        pipe.multi()
+        pipe.set("y", "42")
+
+    client.transaction(txn)
+
+Best practices
+--------------
+
+- Assign the highest weight to your primary database and lower weights to replicas or disaster recovery sites.
+- Keep `health_check_interval` short enough to promptly detect failures but avoid excessive load.
+- Tune `command_retry` and failover attempts to your SLA and workload profile.
+- Use `auto_fallback_interval` if you want the client to fail over back to your primary automatically.
+- Handle `TemporaryUnavailableException` to be able to recover before giving up. In the meantime, you
+can switch the data source (e.g. cache). `NoValidDatabaseException` indicates that there are no healthy
+databases to operate.
+
+Troubleshooting
+---------------
+
+- NoValidDatabaseException:
+  Indicates no healthy database is available. Check circuit breaker states and health checks.
+
+- TemporaryUnavailableException
+  Indicates that currently there are no healthy databases, but you can still send requests until
+  `NoValidDatabaseException` is thrown. Probe interval is configured with `failure_attemtps`
+
+- Health checks always failing:
+  Verify connectivity and, for clusters, that all nodes are reachable. For `LagAwareHealthCheck`,
+  ensure `health_check_url` points to your Redis Enterprise endpoint and authentication/TLS options
+  are configured properly.
+
+- Pub/Sub not receiving messages after failover:
+  Ensure you are using the client’s Pub/Sub helper. The client re-subscribes automatically on switch.
\ No newline at end of file
diff --git a/pyproject.toml b/pyproject.toml
index c95656580a..7888b5f70c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -42,6 +42,9 @@ ocsp = [
 jwt = [
     "PyJWT>=2.9.0",
 ]
+circuit_breaker = [
+    "pybreaker>=1.4.0"
+]
 
 [project.urls]
 Changes = "https://github.com/redis/redis-py/releases"
diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 0b42ade606..1cc0365a7b 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -1242,6 +1242,7 @@ async def run(
         *,
         exception_handler: Optional["PSWorkerThreadExcHandlerT"] = None,
         poll_timeout: float = 1.0,
+        pubsub=None,
     ) -> None:
         """Process pub/sub messages using registered callbacks.
 
@@ -1266,9 +1267,14 @@ async def run(
         await self.connect()
         while True:
             try:
-                await self.get_message(
-                    ignore_subscribe_messages=True, timeout=poll_timeout
-                )
+                if pubsub is None:
+                    await self.get_message(
+                        ignore_subscribe_messages=True, timeout=poll_timeout
+                    )
+                else:
+                    await pubsub.get_message(
+                        ignore_subscribe_messages=True, timeout=poll_timeout
+                    )
             except asyncio.CancelledError:
                 raise
             except BaseException as e:
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 4e0e06517d..225fd3b79f 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -409,6 +409,7 @@ def __init__(
         else:
             self._event_dispatcher = event_dispatcher
 
+        self.startup_nodes = startup_nodes
         self.nodes_manager = NodesManager(
             startup_nodes,
             require_full_coverage,
@@ -2253,7 +2254,10 @@ async def _reinitialize_on_error(self, error):
                 await self._pipe.cluster_client.nodes_manager.initialize()
                 self.reinitialize_counter = 0
             else:
-                self._pipe.cluster_client.nodes_manager.update_moved_exception(error)
+                if isinstance(error, AskError):
+                    self._pipe.cluster_client.nodes_manager.update_moved_exception(
+                        error
+                    )
 
         self._executing = False
 
diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index e3eb3bd9f1..c79ed690d9 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -213,6 +213,7 @@ def __init__(
         self._connect_callbacks: List[weakref.WeakMethod[ConnectCallbackT]] = []
         self._buffer_cutoff = 6000
         self._re_auth_token: Optional[TokenInterface] = None
+        self._should_reconnect = False
 
         try:
             p = int(protocol)
@@ -343,6 +344,12 @@ async def connect_check_health(
             if task and inspect.isawaitable(task):
                 await task
 
+    def mark_for_reconnect(self):
+        self._should_reconnect = True
+
+    def should_reconnect(self):
+        return self._should_reconnect
+
     @abstractmethod
     async def _connect(self):
         pass
@@ -1240,6 +1247,9 @@ async def release(self, connection: AbstractConnection):
         # Connections should always be returned to the correct pool,
         # not doing so is an error that will cause an exception here.
         self._in_use_connections.remove(connection)
+        if connection.should_reconnect():
+            await connection.disconnect()
+
         self._available_connections.append(connection)
         await self._event_dispatcher.dispatch_async(
             AsyncAfterConnectionReleasedEvent(connection)
@@ -1267,6 +1277,14 @@ async def disconnect(self, inuse_connections: bool = True):
         if exc:
             raise exc
 
+    async def update_active_connections_for_reconnect(self):
+        """
+        Mark all active connections for reconnect.
+        """
+        async with self._lock:
+            for conn in self._in_use_connections:
+                conn.mark_for_reconnect()
+
     async def aclose(self) -> None:
         """Close the pool, disconnecting all connections"""
         await self.disconnect()
diff --git a/redis/asyncio/http/__init__.py b/redis/asyncio/http/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/redis/asyncio/http/http_client.py b/redis/asyncio/http/http_client.py
new file mode 100644
index 0000000000..688b33b2e3
--- /dev/null
+++ b/redis/asyncio/http/http_client.py
@@ -0,0 +1,265 @@
+import asyncio
+from abc import ABC, abstractmethod
+from concurrent.futures import ThreadPoolExecutor
+from typing import Any, Mapping, Optional, Union
+
+from redis.http.http_client import HttpClient, HttpResponse
+
+DEFAULT_USER_AGENT = "HttpClient/1.0 (+https://example.invalid)"
+DEFAULT_TIMEOUT = 30.0
+RETRY_STATUS_CODES = {429, 500, 502, 503, 504}
+
+
+class AsyncHTTPClient(ABC):
+    @abstractmethod
+    async def get(
+        self,
+        path: str,
+        params: Optional[
+            Mapping[str, Union[None, str, int, float, bool, list, tuple]]
+        ] = None,
+        headers: Optional[Mapping[str, str]] = None,
+        timeout: Optional[float] = None,
+        expect_json: bool = True,
+    ) -> Union[HttpResponse, Any]:
+        """
+        Invoke HTTP GET request."""
+        pass
+
+    @abstractmethod
+    async def delete(
+        self,
+        path: str,
+        params: Optional[
+            Mapping[str, Union[None, str, int, float, bool, list, tuple]]
+        ] = None,
+        headers: Optional[Mapping[str, str]] = None,
+        timeout: Optional[float] = None,
+        expect_json: bool = True,
+    ) -> Union[HttpResponse, Any]:
+        """
+        Invoke HTTP DELETE request."""
+        pass
+
+    @abstractmethod
+    async def post(
+        self,
+        path: str,
+        json_body: Optional[Any] = None,
+        data: Optional[Union[bytes, str]] = None,
+        params: Optional[
+            Mapping[str, Union[None, str, int, float, bool, list, tuple]]
+        ] = None,
+        headers: Optional[Mapping[str, str]] = None,
+        timeout: Optional[float] = None,
+        expect_json: bool = True,
+    ) -> Union[HttpResponse, Any]:
+        """
+        Invoke HTTP POST request."""
+        pass
+
+    @abstractmethod
+    async def put(
+        self,
+        path: str,
+        json_body: Optional[Any] = None,
+        data: Optional[Union[bytes, str]] = None,
+        params: Optional[
+            Mapping[str, Union[None, str, int, float, bool, list, tuple]]
+        ] = None,
+        headers: Optional[Mapping[str, str]] = None,
+        timeout: Optional[float] = None,
+        expect_json: bool = True,
+    ) -> Union[HttpResponse, Any]:
+        """
+        Invoke HTTP PUT request."""
+        pass
+
+    @abstractmethod
+    async def patch(
+        self,
+        path: str,
+        json_body: Optional[Any] = None,
+        data: Optional[Union[bytes, str]] = None,
+        params: Optional[
+            Mapping[str, Union[None, str, int, float, bool, list, tuple]]
+        ] = None,
+        headers: Optional[Mapping[str, str]] = None,
+        timeout: Optional[float] = None,
+        expect_json: bool = True,
+    ) -> Union[HttpResponse, Any]:
+        """
+        Invoke HTTP PATCH request."""
+        pass
+
+    @abstractmethod
+    async def request(
+        self,
+        method: str,
+        path: str,
+        params: Optional[
+            Mapping[str, Union[None, str, int, float, bool, list, tuple]]
+        ] = None,
+        headers: Optional[Mapping[str, str]] = None,
+        body: Optional[Union[bytes, str]] = None,
+        timeout: Optional[float] = None,
+    ) -> HttpResponse:
+        """
+        Invoke HTTP request with given method."""
+        pass
+
+
+class AsyncHTTPClientWrapper(AsyncHTTPClient):
+    """
+    An async wrapper around sync HTTP client with thread pool execution.
+    """
+
+    def __init__(self, client: HttpClient, max_workers: int = 10) -> None:
+        """
+        Initialize a new HTTP client instance.
+
+        Args:
+            client: Sync HTTP client instance.
+            max_workers: Maximum number of concurrent requests.
+
+        The client supports both regular HTTPS with server verification and mutual TLS
+        authentication. For server verification, provide CA certificate information via
+        ca_file, ca_path or ca_data. For mutual TLS, additionally provide a client
+        certificate and key via client_cert_file and client_key_file.
+        """
+        self.client = client
+        self._executor = ThreadPoolExecutor(max_workers=max_workers)
+
+    async def get(
+        self,
+        path: str,
+        params: Optional[
+            Mapping[str, Union[None, str, int, float, bool, list, tuple]]
+        ] = None,
+        headers: Optional[Mapping[str, str]] = None,
+        timeout: Optional[float] = None,
+        expect_json: bool = True,
+    ) -> Union[HttpResponse, Any]:
+        loop = asyncio.get_event_loop()
+        return await loop.run_in_executor(
+            self._executor, self.client.get, path, params, headers, timeout, expect_json
+        )
+
+    async def delete(
+        self,
+        path: str,
+        params: Optional[
+            Mapping[str, Union[None, str, int, float, bool, list, tuple]]
+        ] = None,
+        headers: Optional[Mapping[str, str]] = None,
+        timeout: Optional[float] = None,
+        expect_json: bool = True,
+    ) -> Union[HttpResponse, Any]:
+        loop = asyncio.get_event_loop()
+        return await loop.run_in_executor(
+            self._executor,
+            self.client.delete,
+            path,
+            params,
+            headers,
+            timeout,
+            expect_json,
+        )
+
+    async def post(
+        self,
+        path: str,
+        json_body: Optional[Any] = None,
+        data: Optional[Union[bytes, str]] = None,
+        params: Optional[
+            Mapping[str, Union[None, str, int, float, bool, list, tuple]]
+        ] = None,
+        headers: Optional[Mapping[str, str]] = None,
+        timeout: Optional[float] = None,
+        expect_json: bool = True,
+    ) -> Union[HttpResponse, Any]:
+        loop = asyncio.get_event_loop()
+        return await loop.run_in_executor(
+            self._executor,
+            self.client.post,
+            path,
+            json_body,
+            data,
+            params,
+            headers,
+            timeout,
+            expect_json,
+        )
+
+    async def put(
+        self,
+        path: str,
+        json_body: Optional[Any] = None,
+        data: Optional[Union[bytes, str]] = None,
+        params: Optional[
+            Mapping[str, Union[None, str, int, float, bool, list, tuple]]
+        ] = None,
+        headers: Optional[Mapping[str, str]] = None,
+        timeout: Optional[float] = None,
+        expect_json: bool = True,
+    ) -> Union[HttpResponse, Any]:
+        loop = asyncio.get_event_loop()
+        return await loop.run_in_executor(
+            self._executor,
+            self.client.put,
+            path,
+            json_body,
+            data,
+            params,
+            headers,
+            timeout,
+            expect_json,
+        )
+
+    async def patch(
+        self,
+        path: str,
+        json_body: Optional[Any] = None,
+        data: Optional[Union[bytes, str]] = None,
+        params: Optional[
+            Mapping[str, Union[None, str, int, float, bool, list, tuple]]
+        ] = None,
+        headers: Optional[Mapping[str, str]] = None,
+        timeout: Optional[float] = None,
+        expect_json: bool = True,
+    ) -> Union[HttpResponse, Any]:
+        loop = asyncio.get_event_loop()
+        return await loop.run_in_executor(
+            self._executor,
+            self.client.patch,
+            path,
+            json_body,
+            data,
+            params,
+            headers,
+            timeout,
+            expect_json,
+        )
+
+    async def request(
+        self,
+        method: str,
+        path: str,
+        params: Optional[
+            Mapping[str, Union[None, str, int, float, bool, list, tuple]]
+        ] = None,
+        headers: Optional[Mapping[str, str]] = None,
+        body: Optional[Union[bytes, str]] = None,
+        timeout: Optional[float] = None,
+    ) -> HttpResponse:
+        loop = asyncio.get_event_loop()
+        return await loop.run_in_executor(
+            self._executor,
+            self.client.request,
+            method,
+            path,
+            params,
+            headers,
+            body,
+            timeout,
+        )
diff --git a/redis/asyncio/multidb/__init__.py b/redis/asyncio/multidb/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/redis/asyncio/multidb/client.py b/redis/asyncio/multidb/client.py
new file mode 100644
index 0000000000..6bea588196
--- /dev/null
+++ b/redis/asyncio/multidb/client.py
@@ -0,0 +1,528 @@
+import asyncio
+import logging
+from typing import Any, Awaitable, Callable, Coroutine, List, Optional, Union
+
+from redis.asyncio.client import PubSubHandler
+from redis.asyncio.multidb.command_executor import DefaultCommandExecutor
+from redis.asyncio.multidb.config import DEFAULT_GRACE_PERIOD, MultiDbConfig
+from redis.asyncio.multidb.database import AsyncDatabase, Databases
+from redis.asyncio.multidb.failure_detector import AsyncFailureDetector
+from redis.asyncio.multidb.healthcheck import HealthCheck, HealthCheckPolicy
+from redis.background import BackgroundScheduler
+from redis.commands import AsyncCoreCommands, AsyncRedisModuleCommands
+from redis.multidb.circuit import CircuitBreaker
+from redis.multidb.circuit import State as CBState
+from redis.multidb.exception import NoValidDatabaseException, UnhealthyDatabaseException
+from redis.typing import ChannelT, EncodableT, KeyT
+
+logger = logging.getLogger(__name__)
+
+
+class MultiDBClient(AsyncRedisModuleCommands, AsyncCoreCommands):
+    """
+    Client that operates on multiple logical Redis databases.
+    Should be used in Active-Active database setups.
+    """
+
+    def __init__(self, config: MultiDbConfig):
+        self._databases = config.databases()
+        self._health_checks = config.default_health_checks()
+
+        if config.health_checks is not None:
+            self._health_checks.extend(config.health_checks)
+
+        self._health_check_interval = config.health_check_interval
+        self._health_check_policy: HealthCheckPolicy = config.health_check_policy.value(
+            config.health_check_probes, config.health_check_delay
+        )
+        self._failure_detectors = config.default_failure_detectors()
+
+        if config.failure_detectors is not None:
+            self._failure_detectors.extend(config.failure_detectors)
+
+        self._failover_strategy = (
+            config.default_failover_strategy()
+            if config.failover_strategy is None
+            else config.failover_strategy
+        )
+        self._failover_strategy.set_databases(self._databases)
+        self._auto_fallback_interval = config.auto_fallback_interval
+        self._event_dispatcher = config.event_dispatcher
+        self._command_retry = config.command_retry
+        self._command_retry.update_supported_errors([ConnectionRefusedError])
+        self.command_executor = DefaultCommandExecutor(
+            failure_detectors=self._failure_detectors,
+            databases=self._databases,
+            command_retry=self._command_retry,
+            failover_strategy=self._failover_strategy,
+            failover_attempts=config.failover_attempts,
+            failover_delay=config.failover_delay,
+            event_dispatcher=self._event_dispatcher,
+            auto_fallback_interval=self._auto_fallback_interval,
+        )
+        self.initialized = False
+        self._hc_lock = asyncio.Lock()
+        self._bg_scheduler = BackgroundScheduler()
+        self._config = config
+        self._recurring_hc_task = None
+        self._hc_tasks = []
+        self._half_open_state_task = None
+
+    async def __aenter__(self: "MultiDBClient") -> "MultiDBClient":
+        if not self.initialized:
+            await self.initialize()
+        return self
+
+    async def __aexit__(self, exc_type, exc_value, traceback):
+        if self._recurring_hc_task:
+            self._recurring_hc_task.cancel()
+        if self._half_open_state_task:
+            self._half_open_state_task.cancel()
+        for hc_task in self._hc_tasks:
+            hc_task.cancel()
+
+    async def initialize(self):
+        """
+        Perform initialization of databases to define their initial state.
+        """
+
+        async def raise_exception_on_failed_hc(error):
+            raise error
+
+        # Initial databases check to define initial state
+        await self._check_databases_health(on_error=raise_exception_on_failed_hc)
+
+        # Starts recurring health checks on the background.
+        self._recurring_hc_task = asyncio.create_task(
+            self._bg_scheduler.run_recurring_async(
+                self._health_check_interval,
+                self._check_databases_health,
+            )
+        )
+
+        is_active_db_found = False
+
+        for database, weight in self._databases:
+            # Set on state changed callback for each circuit.
+            database.circuit.on_state_changed(self._on_circuit_state_change_callback)
+
+            # Set states according to a weights and circuit state
+            if database.circuit.state == CBState.CLOSED and not is_active_db_found:
+                await self.command_executor.set_active_database(database)
+                is_active_db_found = True
+
+        if not is_active_db_found:
+            raise NoValidDatabaseException(
+                "Initial connection failed - no active database found"
+            )
+
+        self.initialized = True
+
+    def get_databases(self) -> Databases:
+        """
+        Returns a sorted (by weight) list of all databases.
+        """
+        return self._databases
+
+    async def set_active_database(self, database: AsyncDatabase) -> None:
+        """
+        Promote one of the existing databases to become an active.
+        """
+        exists = None
+
+        for existing_db, _ in self._databases:
+            if existing_db == database:
+                exists = True
+                break
+
+        if not exists:
+            raise ValueError("Given database is not a member of database list")
+
+        await self._check_db_health(database)
+
+        if database.circuit.state == CBState.CLOSED:
+            highest_weighted_db, _ = self._databases.get_top_n(1)[0]
+            await self.command_executor.set_active_database(database)
+            return
+
+        raise NoValidDatabaseException(
+            "Cannot set active database, database is unhealthy"
+        )
+
+    async def add_database(self, database: AsyncDatabase):
+        """
+        Adds a new database to the database list.
+        """
+        for existing_db, _ in self._databases:
+            if existing_db == database:
+                raise ValueError("Given database already exists")
+
+        await self._check_db_health(database)
+
+        highest_weighted_db, highest_weight = self._databases.get_top_n(1)[0]
+        self._databases.add(database, database.weight)
+        await self._change_active_database(database, highest_weighted_db)
+
+    async def _change_active_database(
+        self, new_database: AsyncDatabase, highest_weight_database: AsyncDatabase
+    ):
+        if (
+            new_database.weight > highest_weight_database.weight
+            and new_database.circuit.state == CBState.CLOSED
+        ):
+            await self.command_executor.set_active_database(new_database)
+
+    async def remove_database(self, database: AsyncDatabase):
+        """
+        Removes a database from the database list.
+        """
+        weight = self._databases.remove(database)
+        highest_weighted_db, highest_weight = self._databases.get_top_n(1)[0]
+
+        if (
+            highest_weight <= weight
+            and highest_weighted_db.circuit.state == CBState.CLOSED
+        ):
+            await self.command_executor.set_active_database(highest_weighted_db)
+
+    async def update_database_weight(self, database: AsyncDatabase, weight: float):
+        """
+        Updates a database from the database list.
+        """
+        exists = None
+
+        for existing_db, _ in self._databases:
+            if existing_db == database:
+                exists = True
+                break
+
+        if not exists:
+            raise ValueError("Given database is not a member of database list")
+
+        highest_weighted_db, highest_weight = self._databases.get_top_n(1)[0]
+        self._databases.update_weight(database, weight)
+        database.weight = weight
+        await self._change_active_database(database, highest_weighted_db)
+
+    def add_failure_detector(self, failure_detector: AsyncFailureDetector):
+        """
+        Adds a new failure detector to the database.
+        """
+        self._failure_detectors.append(failure_detector)
+
+    async def add_health_check(self, healthcheck: HealthCheck):
+        """
+        Adds a new health check to the database.
+        """
+        async with self._hc_lock:
+            self._health_checks.append(healthcheck)
+
+    async def execute_command(self, *args, **options):
+        """
+        Executes a single command and return its result.
+        """
+        if not self.initialized:
+            await self.initialize()
+
+        return await self.command_executor.execute_command(*args, **options)
+
+    def pipeline(self):
+        """
+        Enters into pipeline mode of the client.
+        """
+        return Pipeline(self)
+
+    async def transaction(
+        self,
+        func: Callable[["Pipeline"], Union[Any, Awaitable[Any]]],
+        *watches: KeyT,
+        shard_hint: Optional[str] = None,
+        value_from_callable: bool = False,
+        watch_delay: Optional[float] = None,
+    ):
+        """
+        Executes callable as transaction.
+        """
+        if not self.initialized:
+            await self.initialize()
+
+        return await self.command_executor.execute_transaction(
+            func,
+            *watches,
+            shard_hint=shard_hint,
+            value_from_callable=value_from_callable,
+            watch_delay=watch_delay,
+        )
+
+    async def pubsub(self, **kwargs):
+        """
+        Return a Publish/Subscribe object. With this object, you can
+        subscribe to channels and listen for messages that get published to
+        them.
+        """
+        if not self.initialized:
+            await self.initialize()
+
+        return PubSub(self, **kwargs)
+
+    async def _check_databases_health(
+        self,
+        on_error: Optional[Callable[[Exception], Coroutine[Any, Any, None]]] = None,
+    ):
+        """
+        Runs health checks as a recurring task.
+        Runs health checks against all databases.
+        """
+        try:
+            self._hc_tasks = [
+                asyncio.create_task(self._check_db_health(database))
+                for database, _ in self._databases
+            ]
+            results = await asyncio.wait_for(
+                asyncio.gather(
+                    *self._hc_tasks,
+                    return_exceptions=True,
+                ),
+                timeout=self._health_check_interval,
+            )
+        except asyncio.TimeoutError:
+            raise asyncio.TimeoutError(
+                "Health check execution exceeds health_check_interval"
+            )
+
+        for result in results:
+            if isinstance(result, UnhealthyDatabaseException):
+                unhealthy_db = result.database
+                unhealthy_db.circuit.state = CBState.OPEN
+
+                logger.exception(
+                    "Health check failed, due to exception",
+                    exc_info=result.original_exception,
+                )
+
+                if on_error:
+                    on_error(result.original_exception)
+
+    async def _check_db_health(self, database: AsyncDatabase) -> bool:
+        """
+        Runs health checks on the given database until first failure.
+        """
+        # Health check will setup circuit state
+        is_healthy = await self._health_check_policy.execute(
+            self._health_checks, database
+        )
+
+        if not is_healthy:
+            if database.circuit.state != CBState.OPEN:
+                database.circuit.state = CBState.OPEN
+            return is_healthy
+        elif is_healthy and database.circuit.state != CBState.CLOSED:
+            database.circuit.state = CBState.CLOSED
+
+        return is_healthy
+
+    def _on_circuit_state_change_callback(
+        self, circuit: CircuitBreaker, old_state: CBState, new_state: CBState
+    ):
+        loop = asyncio.get_running_loop()
+
+        if new_state == CBState.HALF_OPEN:
+            self._half_open_state_task = asyncio.create_task(
+                self._check_db_health(circuit.database)
+            )
+            return
+
+        if old_state == CBState.CLOSED and new_state == CBState.OPEN:
+            loop.call_later(DEFAULT_GRACE_PERIOD, _half_open_circuit, circuit)
+
+    async def aclose(self):
+        if self.command_executor.active_database:
+            await self.command_executor.active_database.client.aclose()
+
+
+def _half_open_circuit(circuit: CircuitBreaker):
+    circuit.state = CBState.HALF_OPEN
+
+
+class Pipeline(AsyncRedisModuleCommands, AsyncCoreCommands):
+    """
+    Pipeline implementation for multiple logical Redis databases.
+    """
+
+    def __init__(self, client: MultiDBClient):
+        self._command_stack = []
+        self._client = client
+
+    async def __aenter__(self: "Pipeline") -> "Pipeline":
+        return self
+
+    async def __aexit__(self, exc_type, exc_value, traceback):
+        await self.reset()
+        await self._client.__aexit__(exc_type, exc_value, traceback)
+
+    def __await__(self):
+        return self._async_self().__await__()
+
+    async def _async_self(self):
+        return self
+
+    def __len__(self) -> int:
+        return len(self._command_stack)
+
+    def __bool__(self) -> bool:
+        """Pipeline instances should always evaluate to True"""
+        return True
+
+    async def reset(self) -> None:
+        self._command_stack = []
+
+    async def aclose(self) -> None:
+        """Close the pipeline"""
+        await self.reset()
+
+    def pipeline_execute_command(self, *args, **options) -> "Pipeline":
+        """
+        Stage a command to be executed when execute() is next called
+
+        Returns the current Pipeline object back so commands can be
+        chained together, such as:
+
+        pipe = pipe.set('foo', 'bar').incr('baz').decr('bang')
+
+        At some other point, you can then run: pipe.execute(),
+        which will execute all commands queued in the pipe.
+        """
+        self._command_stack.append((args, options))
+        return self
+
+    def execute_command(self, *args, **kwargs):
+        """Adds a command to the stack"""
+        return self.pipeline_execute_command(*args, **kwargs)
+
+    async def execute(self) -> List[Any]:
+        """Execute all the commands in the current pipeline"""
+        if not self._client.initialized:
+            await self._client.initialize()
+
+        try:
+            return await self._client.command_executor.execute_pipeline(
+                tuple(self._command_stack)
+            )
+        finally:
+            await self.reset()
+
+
+class PubSub:
+    """
+    PubSub object for multi database client.
+    """
+
+    def __init__(self, client: MultiDBClient, **kwargs):
+        """Initialize the PubSub object for a multi-database client.
+
+        Args:
+            client: MultiDBClient instance to use for pub/sub operations
+            **kwargs: Additional keyword arguments to pass to the underlying pubsub implementation
+        """
+
+        self._client = client
+        self._client.command_executor.pubsub(**kwargs)
+
+    async def __aenter__(self) -> "PubSub":
+        return self
+
+    async def __aexit__(self, exc_type, exc_value, traceback) -> None:
+        await self.aclose()
+
+    async def aclose(self):
+        return await self._client.command_executor.execute_pubsub_method("aclose")
+
+    @property
+    def subscribed(self) -> bool:
+        return self._client.command_executor.active_pubsub.subscribed
+
+    async def execute_command(self, *args: EncodableT):
+        return await self._client.command_executor.execute_pubsub_method(
+            "execute_command", *args
+        )
+
+    async def psubscribe(self, *args: ChannelT, **kwargs: PubSubHandler):
+        """
+        Subscribe to channel patterns. Patterns supplied as keyword arguments
+        expect a pattern name as the key and a callable as the value. A
+        pattern's callable will be invoked automatically when a message is
+        received on that pattern rather than producing a message via
+        ``listen()``.
+        """
+        return await self._client.command_executor.execute_pubsub_method(
+            "psubscribe", *args, **kwargs
+        )
+
+    async def punsubscribe(self, *args: ChannelT):
+        """
+        Unsubscribe from the supplied patterns. If empty, unsubscribe from
+        all patterns.
+        """
+        return await self._client.command_executor.execute_pubsub_method(
+            "punsubscribe", *args
+        )
+
+    async def subscribe(self, *args: ChannelT, **kwargs: Callable):
+        """
+        Subscribe to channels. Channels supplied as keyword arguments expect
+        a channel name as the key and a callable as the value. A channel's
+        callable will be invoked automatically when a message is received on
+        that channel rather than producing a message via ``listen()`` or
+        ``get_message()``.
+        """
+        return await self._client.command_executor.execute_pubsub_method(
+            "subscribe", *args, **kwargs
+        )
+
+    async def unsubscribe(self, *args):
+        """
+        Unsubscribe from the supplied channels. If empty, unsubscribe from
+        all channels
+        """
+        return await self._client.command_executor.execute_pubsub_method(
+            "unsubscribe", *args
+        )
+
+    async def get_message(
+        self, ignore_subscribe_messages: bool = False, timeout: Optional[float] = 0.0
+    ):
+        """
+        Get the next message if one is available, otherwise None.
+
+        If timeout is specified, the system will wait for `timeout` seconds
+        before returning. Timeout should be specified as a floating point
+        number or None to wait indefinitely.
+        """
+        return await self._client.command_executor.execute_pubsub_method(
+            "get_message",
+            ignore_subscribe_messages=ignore_subscribe_messages,
+            timeout=timeout,
+        )
+
+    async def run(
+        self,
+        *,
+        exception_handler=None,
+        poll_timeout: float = 1.0,
+    ) -> None:
+        """Process pub/sub messages using registered callbacks.
+
+        This is the equivalent of :py:meth:`redis.PubSub.run_in_thread` in
+        redis-py, but it is a coroutine. To launch it as a separate task, use
+        ``asyncio.create_task``:
+
+            >>> task = asyncio.create_task(pubsub.run())
+
+        To shut it down, use asyncio cancellation:
+
+            >>> task.cancel()
+            >>> await task
+        """
+        return await self._client.command_executor.execute_pubsub_run(
+            sleep_time=poll_timeout, exception_handler=exception_handler, pubsub=self
+        )
diff --git a/redis/asyncio/multidb/command_executor.py b/redis/asyncio/multidb/command_executor.py
new file mode 100644
index 0000000000..c09b8b9969
--- /dev/null
+++ b/redis/asyncio/multidb/command_executor.py
@@ -0,0 +1,339 @@
+from abc import abstractmethod
+from asyncio import iscoroutinefunction
+from datetime import datetime
+from typing import Any, Awaitable, Callable, List, Optional, Union
+
+from redis.asyncio import RedisCluster
+from redis.asyncio.client import Pipeline, PubSub
+from redis.asyncio.multidb.database import AsyncDatabase, Database, Databases
+from redis.asyncio.multidb.event import (
+    AsyncActiveDatabaseChanged,
+    CloseConnectionOnActiveDatabaseChanged,
+    RegisterCommandFailure,
+    ResubscribeOnActiveDatabaseChanged,
+)
+from redis.asyncio.multidb.failover import (
+    DEFAULT_FAILOVER_ATTEMPTS,
+    DEFAULT_FAILOVER_DELAY,
+    AsyncFailoverStrategy,
+    DefaultFailoverStrategyExecutor,
+    FailoverStrategyExecutor,
+)
+from redis.asyncio.multidb.failure_detector import AsyncFailureDetector
+from redis.asyncio.retry import Retry
+from redis.event import AsyncOnCommandsFailEvent, EventDispatcherInterface
+from redis.multidb.circuit import State as CBState
+from redis.multidb.command_executor import BaseCommandExecutor, CommandExecutor
+from redis.multidb.config import DEFAULT_AUTO_FALLBACK_INTERVAL
+from redis.typing import KeyT
+
+
+class AsyncCommandExecutor(CommandExecutor):
+    @property
+    @abstractmethod
+    def databases(self) -> Databases:
+        """Returns a list of databases."""
+        pass
+
+    @property
+    @abstractmethod
+    def failure_detectors(self) -> List[AsyncFailureDetector]:
+        """Returns a list of failure detectors."""
+        pass
+
+    @abstractmethod
+    def add_failure_detector(self, failure_detector: AsyncFailureDetector) -> None:
+        """Adds a new failure detector to the list of failure detectors."""
+        pass
+
+    @property
+    @abstractmethod
+    def active_database(self) -> Optional[AsyncDatabase]:
+        """Returns currently active database."""
+        pass
+
+    @abstractmethod
+    async def set_active_database(self, database: AsyncDatabase) -> None:
+        """Sets the currently active database."""
+        pass
+
+    @property
+    @abstractmethod
+    def active_pubsub(self) -> Optional[PubSub]:
+        """Returns currently active pubsub."""
+        pass
+
+    @active_pubsub.setter
+    @abstractmethod
+    def active_pubsub(self, pubsub: PubSub) -> None:
+        """Sets currently active pubsub."""
+        pass
+
+    @property
+    @abstractmethod
+    def failover_strategy_executor(self) -> FailoverStrategyExecutor:
+        """Returns failover strategy executor."""
+        pass
+
+    @property
+    @abstractmethod
+    def command_retry(self) -> Retry:
+        """Returns command retry object."""
+        pass
+
+    @abstractmethod
+    async def pubsub(self, **kwargs):
+        """Initializes a PubSub object on a currently active database"""
+        pass
+
+    @abstractmethod
+    async def execute_command(self, *args, **options):
+        """Executes a command and returns the result."""
+        pass
+
+    @abstractmethod
+    async def execute_pipeline(self, command_stack: tuple):
+        """Executes a stack of commands in pipeline."""
+        pass
+
+    @abstractmethod
+    async def execute_transaction(
+        self, transaction: Callable[[Pipeline], None], *watches, **options
+    ):
+        """Executes a transaction block wrapped in callback."""
+        pass
+
+    @abstractmethod
+    async def execute_pubsub_method(self, method_name: str, *args, **kwargs):
+        """Executes a given method on active pub/sub."""
+        pass
+
+    @abstractmethod
+    async def execute_pubsub_run(self, sleep_time: float, **kwargs) -> Any:
+        """Executes pub/sub run in a thread."""
+        pass
+
+
+class DefaultCommandExecutor(BaseCommandExecutor, AsyncCommandExecutor):
+    def __init__(
+        self,
+        failure_detectors: List[AsyncFailureDetector],
+        databases: Databases,
+        command_retry: Retry,
+        failover_strategy: AsyncFailoverStrategy,
+        event_dispatcher: EventDispatcherInterface,
+        failover_attempts: int = DEFAULT_FAILOVER_ATTEMPTS,
+        failover_delay: float = DEFAULT_FAILOVER_DELAY,
+        auto_fallback_interval: float = DEFAULT_AUTO_FALLBACK_INTERVAL,
+    ):
+        """
+        Initialize the DefaultCommandExecutor instance.
+
+        Args:
+            failure_detectors: List of failure detector instances to monitor database health
+            databases: Collection of available databases to execute commands on
+            command_retry: Retry policy for failed command execution
+            failover_strategy: Strategy for handling database failover
+            event_dispatcher: Interface for dispatching events
+            failover_attempts: Number of failover attempts
+            failover_delay: Delay between failover attempts
+            auto_fallback_interval: Time interval in seconds between attempts to fall back to a primary database
+        """
+        super().__init__(auto_fallback_interval)
+
+        for fd in failure_detectors:
+            fd.set_command_executor(command_executor=self)
+
+        self._databases = databases
+        self._failure_detectors = failure_detectors
+        self._command_retry = command_retry
+        self._failover_strategy_executor = DefaultFailoverStrategyExecutor(
+            failover_strategy, failover_attempts, failover_delay
+        )
+        self._event_dispatcher = event_dispatcher
+        self._active_database: Optional[Database] = None
+        self._active_pubsub: Optional[PubSub] = None
+        self._active_pubsub_kwargs = {}
+        self._setup_event_dispatcher()
+        self._schedule_next_fallback()
+
+    @property
+    def databases(self) -> Databases:
+        return self._databases
+
+    @property
+    def failure_detectors(self) -> List[AsyncFailureDetector]:
+        return self._failure_detectors
+
+    def add_failure_detector(self, failure_detector: AsyncFailureDetector) -> None:
+        self._failure_detectors.append(failure_detector)
+
+    @property
+    def active_database(self) -> Optional[AsyncDatabase]:
+        return self._active_database
+
+    async def set_active_database(self, database: AsyncDatabase) -> None:
+        old_active = self._active_database
+        self._active_database = database
+
+        if old_active is not None and old_active is not database:
+            await self._event_dispatcher.dispatch_async(
+                AsyncActiveDatabaseChanged(
+                    old_active,
+                    self._active_database,
+                    self,
+                    **self._active_pubsub_kwargs,
+                )
+            )
+
+    @property
+    def active_pubsub(self) -> Optional[PubSub]:
+        return self._active_pubsub
+
+    @active_pubsub.setter
+    def active_pubsub(self, pubsub: PubSub) -> None:
+        self._active_pubsub = pubsub
+
+    @property
+    def failover_strategy_executor(self) -> FailoverStrategyExecutor:
+        return self._failover_strategy_executor
+
+    @property
+    def command_retry(self) -> Retry:
+        return self._command_retry
+
+    def pubsub(self, **kwargs):
+        if self._active_pubsub is None:
+            if isinstance(self._active_database.client, RedisCluster):
+                raise ValueError("PubSub is not supported for RedisCluster")
+
+            self._active_pubsub = self._active_database.client.pubsub(**kwargs)
+            self._active_pubsub_kwargs = kwargs
+
+    async def execute_command(self, *args, **options):
+        async def callback():
+            response = await self._active_database.client.execute_command(
+                *args, **options
+            )
+            await self._register_command_execution(args)
+            return response
+
+        return await self._execute_with_failure_detection(callback, args)
+
+    async def execute_pipeline(self, command_stack: tuple):
+        async def callback():
+            async with self._active_database.client.pipeline() as pipe:
+                for command, options in command_stack:
+                    pipe.execute_command(*command, **options)
+
+                response = await pipe.execute()
+                await self._register_command_execution(command_stack)
+                return response
+
+        return await self._execute_with_failure_detection(callback, command_stack)
+
+    async def execute_transaction(
+        self,
+        func: Callable[["Pipeline"], Union[Any, Awaitable[Any]]],
+        *watches: KeyT,
+        shard_hint: Optional[str] = None,
+        value_from_callable: bool = False,
+        watch_delay: Optional[float] = None,
+    ):
+        async def callback():
+            response = await self._active_database.client.transaction(
+                func,
+                *watches,
+                shard_hint=shard_hint,
+                value_from_callable=value_from_callable,
+                watch_delay=watch_delay,
+            )
+            await self._register_command_execution(())
+            return response
+
+        return await self._execute_with_failure_detection(callback)
+
+    async def execute_pubsub_method(self, method_name: str, *args, **kwargs):
+        async def callback():
+            method = getattr(self.active_pubsub, method_name)
+            if iscoroutinefunction(method):
+                response = await method(*args, **kwargs)
+            else:
+                response = method(*args, **kwargs)
+
+            await self._register_command_execution(args)
+            return response
+
+        return await self._execute_with_failure_detection(callback, *args)
+
+    async def execute_pubsub_run(
+        self, sleep_time: float, exception_handler=None, pubsub=None
+    ) -> Any:
+        async def callback():
+            return await self._active_pubsub.run(
+                poll_timeout=sleep_time,
+                exception_handler=exception_handler,
+                pubsub=pubsub,
+            )
+
+        return await self._execute_with_failure_detection(callback)
+
+    async def _execute_with_failure_detection(
+        self, callback: Callable, cmds: tuple = ()
+    ):
+        """
+        Execute a commands execution callback with failure detection.
+        """
+
+        async def wrapper():
+            # On each retry we need to check active database as it might change.
+            await self._check_active_database()
+            return await callback()
+
+        return await self._command_retry.call_with_retry(
+            lambda: wrapper(),
+            lambda error: self._on_command_fail(error, *cmds),
+        )
+
+    async def _check_active_database(self):
+        """
+        Checks if active a database needs to be updated.
+        """
+        if (
+            self._active_database is None
+            or self._active_database.circuit.state != CBState.CLOSED
+            or (
+                self._auto_fallback_interval != DEFAULT_AUTO_FALLBACK_INTERVAL
+                and self._next_fallback_attempt <= datetime.now()
+            )
+        ):
+            await self.set_active_database(
+                await self._failover_strategy_executor.execute()
+            )
+            self._schedule_next_fallback()
+
+    async def _on_command_fail(self, error, *args):
+        await self._event_dispatcher.dispatch_async(
+            AsyncOnCommandsFailEvent(args, error)
+        )
+
+    async def _register_command_execution(self, cmd: tuple):
+        for detector in self._failure_detectors:
+            await detector.register_command_execution(cmd)
+
+    def _setup_event_dispatcher(self):
+        """
+        Registers necessary listeners.
+        """
+        failure_listener = RegisterCommandFailure(self._failure_detectors)
+        resubscribe_listener = ResubscribeOnActiveDatabaseChanged()
+        close_connection_listener = CloseConnectionOnActiveDatabaseChanged()
+        self._event_dispatcher.register_listeners(
+            {
+                AsyncOnCommandsFailEvent: [failure_listener],
+                AsyncActiveDatabaseChanged: [
+                    close_connection_listener,
+                    resubscribe_listener,
+                ],
+            }
+        )
diff --git a/redis/asyncio/multidb/config.py b/redis/asyncio/multidb/config.py
new file mode 100644
index 0000000000..71f69ad133
--- /dev/null
+++ b/redis/asyncio/multidb/config.py
@@ -0,0 +1,210 @@
+from dataclasses import dataclass, field
+from typing import List, Optional, Type, Union
+
+import pybreaker
+
+from redis.asyncio import ConnectionPool, Redis, RedisCluster
+from redis.asyncio.multidb.database import Database, Databases
+from redis.asyncio.multidb.failover import (
+    DEFAULT_FAILOVER_ATTEMPTS,
+    DEFAULT_FAILOVER_DELAY,
+    AsyncFailoverStrategy,
+    WeightBasedFailoverStrategy,
+)
+from redis.asyncio.multidb.failure_detector import (
+    AsyncFailureDetector,
+    FailureDetectorAsyncWrapper,
+)
+from redis.asyncio.multidb.healthcheck import (
+    DEFAULT_HEALTH_CHECK_DELAY,
+    DEFAULT_HEALTH_CHECK_INTERVAL,
+    DEFAULT_HEALTH_CHECK_POLICY,
+    DEFAULT_HEALTH_CHECK_PROBES,
+    EchoHealthCheck,
+    HealthCheck,
+    HealthCheckPolicies,
+)
+from redis.asyncio.retry import Retry
+from redis.backoff import ExponentialWithJitterBackoff, NoBackoff
+from redis.data_structure import WeightedList
+from redis.event import EventDispatcher, EventDispatcherInterface
+from redis.multidb.circuit import (
+    DEFAULT_GRACE_PERIOD,
+    CircuitBreaker,
+    PBCircuitBreakerAdapter,
+)
+from redis.multidb.failure_detector import (
+    DEFAULT_FAILURE_RATE_THRESHOLD,
+    DEFAULT_FAILURES_DETECTION_WINDOW,
+    DEFAULT_MIN_NUM_FAILURES,
+    CommandFailureDetector,
+)
+
+DEFAULT_AUTO_FALLBACK_INTERVAL = 120
+
+
+def default_event_dispatcher() -> EventDispatcherInterface:
+    return EventDispatcher()
+
+
+@dataclass
+class DatabaseConfig:
+    """
+    Dataclass representing the configuration for a database connection.
+
+    This class is used to store configuration settings for a database connection,
+    including client options, connection sourcing details, circuit breaker settings,
+    and cluster-specific properties. It provides a structure for defining these
+    attributes and allows for the creation of customized configurations for various
+    database setups.
+
+    Attributes:
+        weight (float): Weight of the database to define the active one.
+        client_kwargs (dict): Additional parameters for the database client connection.
+        from_url (Optional[str]): Redis URL way of connecting to the database.
+        from_pool (Optional[ConnectionPool]): A pre-configured connection pool to use.
+        circuit (Optional[CircuitBreaker]): Custom circuit breaker implementation.
+        grace_period (float): Grace period after which we need to check if the circuit could be closed again.
+        health_check_url (Optional[str]): URL for health checks. Cluster FQDN is typically used
+            on public Redis Enterprise endpoints.
+
+    Methods:
+        default_circuit_breaker:
+            Generates and returns a default CircuitBreaker instance adapted for use.
+    """
+
+    weight: float = 1.0
+    client_kwargs: dict = field(default_factory=dict)
+    from_url: Optional[str] = None
+    from_pool: Optional[ConnectionPool] = None
+    circuit: Optional[CircuitBreaker] = None
+    grace_period: float = DEFAULT_GRACE_PERIOD
+    health_check_url: Optional[str] = None
+
+    def default_circuit_breaker(self) -> CircuitBreaker:
+        circuit_breaker = pybreaker.CircuitBreaker(reset_timeout=self.grace_period)
+        return PBCircuitBreakerAdapter(circuit_breaker)
+
+
+@dataclass
+class MultiDbConfig:
+    """
+    Configuration class for managing multiple database connections in a resilient and fail-safe manner.
+
+    Attributes:
+        databases_config: A list of database configurations.
+        client_class: The client class used to manage database connections.
+        command_retry: Retry strategy for executing database commands.
+        failure_detectors: Optional list of additional failure detectors for monitoring database failures.
+        min_num_failures: Minimal count of failures required for failover
+        failure_rate_threshold: Percentage of failures required for failover
+        failures_detection_window: Time interval for tracking database failures.
+        health_checks: Optional list of additional health checks performed on databases.
+        health_check_interval: Time interval for executing health checks.
+        health_check_probes: Number of attempts to evaluate the health of a database.
+        health_check_delay: Delay between health check attempts.
+        failover_strategy: Optional strategy for handling database failover scenarios.
+        failover_attempts: Number of retries allowed for failover operations.
+        failover_delay: Delay between failover attempts.
+        auto_fallback_interval: Time interval to trigger automatic fallback.
+        event_dispatcher: Interface for dispatching events related to database operations.
+
+    Methods:
+        databases:
+            Retrieves a collection of database clients managed by weighted configurations.
+            Initializes database clients based on the provided configuration and removes
+            redundant retry objects for lower-level clients to rely on global retry logic.
+
+        default_failure_detectors:
+            Returns the default list of failure detectors used to monitor database failures.
+
+        default_health_checks:
+            Returns the default list of health checks used to monitor database health
+            with specific retry and backoff strategies.
+
+        default_failover_strategy:
+            Provides the default failover strategy used for handling failover scenarios
+            with defined retry and backoff configurations.
+    """
+
+    databases_config: List[DatabaseConfig]
+    client_class: Type[Union[Redis, RedisCluster]] = Redis
+    command_retry: Retry = Retry(
+        backoff=ExponentialWithJitterBackoff(base=1, cap=10), retries=3
+    )
+    failure_detectors: Optional[List[AsyncFailureDetector]] = None
+    min_num_failures: int = DEFAULT_MIN_NUM_FAILURES
+    failure_rate_threshold: float = DEFAULT_FAILURE_RATE_THRESHOLD
+    failures_detection_window: float = DEFAULT_FAILURES_DETECTION_WINDOW
+    health_checks: Optional[List[HealthCheck]] = None
+    health_check_interval: float = DEFAULT_HEALTH_CHECK_INTERVAL
+    health_check_probes: int = DEFAULT_HEALTH_CHECK_PROBES
+    health_check_delay: float = DEFAULT_HEALTH_CHECK_DELAY
+    health_check_policy: HealthCheckPolicies = DEFAULT_HEALTH_CHECK_POLICY
+    failover_strategy: Optional[AsyncFailoverStrategy] = None
+    failover_attempts: int = DEFAULT_FAILOVER_ATTEMPTS
+    failover_delay: float = DEFAULT_FAILOVER_DELAY
+    auto_fallback_interval: float = DEFAULT_AUTO_FALLBACK_INTERVAL
+    event_dispatcher: EventDispatcherInterface = field(
+        default_factory=default_event_dispatcher
+    )
+
+    def databases(self) -> Databases:
+        databases = WeightedList()
+
+        for database_config in self.databases_config:
+            # The retry object is not used in the lower level clients, so we can safely remove it.
+            # We rely on command_retry in terms of global retries.
+            database_config.client_kwargs.update(
+                {"retry": Retry(retries=0, backoff=NoBackoff())}
+            )
+
+            if database_config.from_url:
+                client = self.client_class.from_url(
+                    database_config.from_url, **database_config.client_kwargs
+                )
+            elif database_config.from_pool:
+                database_config.from_pool.set_retry(
+                    Retry(retries=0, backoff=NoBackoff())
+                )
+                client = self.client_class.from_pool(
+                    connection_pool=database_config.from_pool
+                )
+            else:
+                client = self.client_class(**database_config.client_kwargs)
+
+            circuit = (
+                database_config.default_circuit_breaker()
+                if database_config.circuit is None
+                else database_config.circuit
+            )
+            databases.add(
+                Database(
+                    client=client,
+                    circuit=circuit,
+                    weight=database_config.weight,
+                    health_check_url=database_config.health_check_url,
+                ),
+                database_config.weight,
+            )
+
+        return databases
+
+    def default_failure_detectors(self) -> List[AsyncFailureDetector]:
+        return [
+            FailureDetectorAsyncWrapper(
+                CommandFailureDetector(
+                    min_num_failures=self.min_num_failures,
+                    failure_rate_threshold=self.failure_rate_threshold,
+                    failure_detection_window=self.failures_detection_window,
+                )
+            ),
+        ]
+
+    def default_health_checks(self) -> List[HealthCheck]:
+        return [
+            EchoHealthCheck(),
+        ]
+
+    def default_failover_strategy(self) -> AsyncFailoverStrategy:
+        return WeightBasedFailoverStrategy()
diff --git a/redis/asyncio/multidb/database.py b/redis/asyncio/multidb/database.py
new file mode 100644
index 0000000000..ecf7a1b972
--- /dev/null
+++ b/redis/asyncio/multidb/database.py
@@ -0,0 +1,69 @@
+from abc import abstractmethod
+from typing import Optional, Union
+
+from redis.asyncio import Redis, RedisCluster
+from redis.data_structure import WeightedList
+from redis.multidb.circuit import CircuitBreaker
+from redis.multidb.database import AbstractDatabase, BaseDatabase
+from redis.typing import Number
+
+
+class AsyncDatabase(AbstractDatabase):
+    """Database with an underlying asynchronous redis client."""
+
+    @property
+    @abstractmethod
+    def client(self) -> Union[Redis, RedisCluster]:
+        """The underlying redis client."""
+        pass
+
+    @client.setter
+    @abstractmethod
+    def client(self, client: Union[Redis, RedisCluster]):
+        """Set the underlying redis client."""
+        pass
+
+    @property
+    @abstractmethod
+    def circuit(self) -> CircuitBreaker:
+        """Circuit breaker for the current database."""
+        pass
+
+    @circuit.setter
+    @abstractmethod
+    def circuit(self, circuit: CircuitBreaker):
+        """Set the circuit breaker for the current database."""
+        pass
+
+
+Databases = WeightedList[tuple[AsyncDatabase, Number]]
+
+
+class Database(BaseDatabase, AsyncDatabase):
+    def __init__(
+        self,
+        client: Union[Redis, RedisCluster],
+        circuit: CircuitBreaker,
+        weight: float,
+        health_check_url: Optional[str] = None,
+    ):
+        self._client = client
+        self._cb = circuit
+        self._cb.database = self
+        super().__init__(weight, health_check_url)
+
+    @property
+    def client(self) -> Union[Redis, RedisCluster]:
+        return self._client
+
+    @client.setter
+    def client(self, client: Union[Redis, RedisCluster]):
+        self._client = client
+
+    @property
+    def circuit(self) -> CircuitBreaker:
+        return self._cb
+
+    @circuit.setter
+    def circuit(self, circuit: CircuitBreaker):
+        self._cb = circuit
diff --git a/redis/asyncio/multidb/event.py b/redis/asyncio/multidb/event.py
new file mode 100644
index 0000000000..ae25f1e37c
--- /dev/null
+++ b/redis/asyncio/multidb/event.py
@@ -0,0 +1,84 @@
+from typing import List
+
+from redis.asyncio import Redis
+from redis.asyncio.multidb.database import AsyncDatabase
+from redis.asyncio.multidb.failure_detector import AsyncFailureDetector
+from redis.event import AsyncEventListenerInterface, AsyncOnCommandsFailEvent
+
+
+class AsyncActiveDatabaseChanged:
+    """
+    Event fired when an async active database has been changed.
+    """
+
+    def __init__(
+        self,
+        old_database: AsyncDatabase,
+        new_database: AsyncDatabase,
+        command_executor,
+        **kwargs,
+    ):
+        self._old_database = old_database
+        self._new_database = new_database
+        self._command_executor = command_executor
+        self._kwargs = kwargs
+
+    @property
+    def old_database(self) -> AsyncDatabase:
+        return self._old_database
+
+    @property
+    def new_database(self) -> AsyncDatabase:
+        return self._new_database
+
+    @property
+    def command_executor(self):
+        return self._command_executor
+
+    @property
+    def kwargs(self):
+        return self._kwargs
+
+
+class ResubscribeOnActiveDatabaseChanged(AsyncEventListenerInterface):
+    """
+    Re-subscribe the currently active pub / sub to a new active database.
+    """
+
+    async def listen(self, event: AsyncActiveDatabaseChanged):
+        old_pubsub = event.command_executor.active_pubsub
+
+        if old_pubsub is not None:
+            # Re-assign old channels and patterns so they will be automatically subscribed on connection.
+            new_pubsub = event.new_database.client.pubsub(**event.kwargs)
+            new_pubsub.channels = old_pubsub.channels
+            new_pubsub.patterns = old_pubsub.patterns
+            await new_pubsub.on_connect(None)
+            event.command_executor.active_pubsub = new_pubsub
+            await old_pubsub.aclose()
+
+
+class CloseConnectionOnActiveDatabaseChanged(AsyncEventListenerInterface):
+    """
+    Close connection to the old active database.
+    """
+
+    async def listen(self, event: AsyncActiveDatabaseChanged):
+        await event.old_database.client.aclose()
+
+        if isinstance(event.old_database.client, Redis):
+            await event.old_database.client.connection_pool.update_active_connections_for_reconnect()
+            await event.old_database.client.connection_pool.disconnect()
+
+
+class RegisterCommandFailure(AsyncEventListenerInterface):
+    """
+    Event listener that registers command failures and passing it to the failure detectors.
+    """
+
+    def __init__(self, failure_detectors: List[AsyncFailureDetector]):
+        self._failure_detectors = failure_detectors
+
+    async def listen(self, event: AsyncOnCommandsFailEvent) -> None:
+        for failure_detector in self._failure_detectors:
+            await failure_detector.register_failure(event.exception, event.commands)
diff --git a/redis/asyncio/multidb/failover.py b/redis/asyncio/multidb/failover.py
new file mode 100644
index 0000000000..5b9202111e
--- /dev/null
+++ b/redis/asyncio/multidb/failover.py
@@ -0,0 +1,125 @@
+import time
+from abc import ABC, abstractmethod
+
+from redis.asyncio.multidb.database import AsyncDatabase, Databases
+from redis.data_structure import WeightedList
+from redis.multidb.circuit import State as CBState
+from redis.multidb.exception import (
+    NoValidDatabaseException,
+    TemporaryUnavailableException,
+)
+
+DEFAULT_FAILOVER_ATTEMPTS = 10
+DEFAULT_FAILOVER_DELAY = 12
+
+
+class AsyncFailoverStrategy(ABC):
+    @abstractmethod
+    async def database(self) -> AsyncDatabase:
+        """Select the database according to the strategy."""
+        pass
+
+    @abstractmethod
+    def set_databases(self, databases: Databases) -> None:
+        """Set the database strategy operates on."""
+        pass
+
+
+class FailoverStrategyExecutor(ABC):
+    @property
+    @abstractmethod
+    def failover_attempts(self) -> int:
+        """The number of failover attempts."""
+        pass
+
+    @property
+    @abstractmethod
+    def failover_delay(self) -> float:
+        """The delay between failover attempts."""
+        pass
+
+    @property
+    @abstractmethod
+    def strategy(self) -> AsyncFailoverStrategy:
+        """The strategy to execute."""
+        pass
+
+    @abstractmethod
+    async def execute(self) -> AsyncDatabase:
+        """Execute the failover strategy."""
+        pass
+
+
+class WeightBasedFailoverStrategy(AsyncFailoverStrategy):
+    """
+    Failover strategy based on database weights.
+    """
+
+    def __init__(self):
+        self._databases = WeightedList()
+
+    async def database(self) -> AsyncDatabase:
+        for database, _ in self._databases:
+            if database.circuit.state == CBState.CLOSED:
+                return database
+
+        raise NoValidDatabaseException("No valid database available for communication")
+
+    def set_databases(self, databases: Databases) -> None:
+        self._databases = databases
+
+
+class DefaultFailoverStrategyExecutor(FailoverStrategyExecutor):
+    """
+    Executes given failover strategy.
+    """
+
+    def __init__(
+        self,
+        strategy: AsyncFailoverStrategy,
+        failover_attempts: int = DEFAULT_FAILOVER_ATTEMPTS,
+        failover_delay: float = DEFAULT_FAILOVER_DELAY,
+    ):
+        self._strategy = strategy
+        self._failover_attempts = failover_attempts
+        self._failover_delay = failover_delay
+        self._next_attempt_ts: int = 0
+        self._failover_counter: int = 0
+
+    @property
+    def failover_attempts(self) -> int:
+        return self._failover_attempts
+
+    @property
+    def failover_delay(self) -> float:
+        return self._failover_delay
+
+    @property
+    def strategy(self) -> AsyncFailoverStrategy:
+        return self._strategy
+
+    async def execute(self) -> AsyncDatabase:
+        try:
+            database = await self._strategy.database()
+            self._reset()
+            return database
+        except NoValidDatabaseException as e:
+            if self._next_attempt_ts == 0:
+                self._next_attempt_ts = time.time() + self._failover_delay
+                self._failover_counter += 1
+            elif time.time() >= self._next_attempt_ts:
+                self._next_attempt_ts += self._failover_delay
+                self._failover_counter += 1
+
+            if self._failover_counter > self._failover_attempts:
+                self._reset()
+                raise e
+            else:
+                raise TemporaryUnavailableException(
+                    "No database connections currently available. "
+                    "This is a temporary condition - please retry the operation."
+                )
+
+    def _reset(self) -> None:
+        self._next_attempt_ts = 0
+        self._failover_counter = 0
diff --git a/redis/asyncio/multidb/failure_detector.py b/redis/asyncio/multidb/failure_detector.py
new file mode 100644
index 0000000000..9c6b61f591
--- /dev/null
+++ b/redis/asyncio/multidb/failure_detector.py
@@ -0,0 +1,38 @@
+from abc import ABC, abstractmethod
+
+from redis.multidb.failure_detector import FailureDetector
+
+
+class AsyncFailureDetector(ABC):
+    @abstractmethod
+    async def register_failure(self, exception: Exception, cmd: tuple) -> None:
+        """Register a failure that occurred during command execution."""
+        pass
+
+    @abstractmethod
+    async def register_command_execution(self, cmd: tuple) -> None:
+        """Register a command execution."""
+        pass
+
+    @abstractmethod
+    def set_command_executor(self, command_executor) -> None:
+        """Set the command executor for this failure."""
+        pass
+
+
+class FailureDetectorAsyncWrapper(AsyncFailureDetector):
+    """
+    Async wrapper for the failure detector.
+    """
+
+    def __init__(self, failure_detector: FailureDetector) -> None:
+        self._failure_detector = failure_detector
+
+    async def register_failure(self, exception: Exception, cmd: tuple) -> None:
+        self._failure_detector.register_failure(exception, cmd)
+
+    async def register_command_execution(self, cmd: tuple) -> None:
+        self._failure_detector.register_command_execution(cmd)
+
+    def set_command_executor(self, command_executor) -> None:
+        self._failure_detector.set_command_executor(command_executor)
diff --git a/redis/asyncio/multidb/healthcheck.py b/redis/asyncio/multidb/healthcheck.py
new file mode 100644
index 0000000000..dcb787f6ed
--- /dev/null
+++ b/redis/asyncio/multidb/healthcheck.py
@@ -0,0 +1,292 @@
+import asyncio
+import logging
+from abc import ABC, abstractmethod
+from enum import Enum
+from typing import List, Optional, Tuple, Union
+
+from redis.asyncio import Redis
+from redis.asyncio.http.http_client import DEFAULT_TIMEOUT, AsyncHTTPClientWrapper
+from redis.backoff import NoBackoff
+from redis.http.http_client import HttpClient
+from redis.multidb.exception import UnhealthyDatabaseException
+from redis.retry import Retry
+
+DEFAULT_HEALTH_CHECK_PROBES = 3
+DEFAULT_HEALTH_CHECK_INTERVAL = 5
+DEFAULT_HEALTH_CHECK_DELAY = 0.5
+DEFAULT_LAG_AWARE_TOLERANCE = 5000
+
+logger = logging.getLogger(__name__)
+
+
+class HealthCheck(ABC):
+    @abstractmethod
+    async def check_health(self, database) -> bool:
+        """Function to determine the health status."""
+        pass
+
+
+class HealthCheckPolicy(ABC):
+    """
+    Health checks execution policy.
+    """
+
+    @property
+    @abstractmethod
+    def health_check_probes(self) -> int:
+        """Number of probes to execute health checks."""
+        pass
+
+    @property
+    @abstractmethod
+    def health_check_delay(self) -> float:
+        """Delay between health check probes."""
+        pass
+
+    @abstractmethod
+    async def execute(self, health_checks: List[HealthCheck], database) -> bool:
+        """Execute health checks and return database health status."""
+        pass
+
+
+class AbstractHealthCheckPolicy(HealthCheckPolicy):
+    def __init__(self, health_check_probes: int, health_check_delay: float):
+        if health_check_probes < 1:
+            raise ValueError("health_check_probes must be greater than 0")
+        self._health_check_probes = health_check_probes
+        self._health_check_delay = health_check_delay
+
+    @property
+    def health_check_probes(self) -> int:
+        return self._health_check_probes
+
+    @property
+    def health_check_delay(self) -> float:
+        return self._health_check_delay
+
+    @abstractmethod
+    async def execute(self, health_checks: List[HealthCheck], database) -> bool:
+        pass
+
+
+class HealthyAllPolicy(AbstractHealthCheckPolicy):
+    """
+    Policy that returns True if all health check probes are successful.
+    """
+
+    def __init__(self, health_check_probes: int, health_check_delay: float):
+        super().__init__(health_check_probes, health_check_delay)
+
+    async def execute(self, health_checks: List[HealthCheck], database) -> bool:
+        for health_check in health_checks:
+            for attempt in range(self.health_check_probes):
+                try:
+                    if not await health_check.check_health(database):
+                        return False
+                except Exception as e:
+                    raise UnhealthyDatabaseException("Unhealthy database", database, e)
+
+                if attempt < self.health_check_probes - 1:
+                    await asyncio.sleep(self._health_check_delay)
+        return True
+
+
+class HealthyMajorityPolicy(AbstractHealthCheckPolicy):
+    """
+    Policy that returns True if a majority of health check probes are successful.
+    """
+
+    def __init__(self, health_check_probes: int, health_check_delay: float):
+        super().__init__(health_check_probes, health_check_delay)
+
+    async def execute(self, health_checks: List[HealthCheck], database) -> bool:
+        for health_check in health_checks:
+            if self.health_check_probes % 2 == 0:
+                allowed_unsuccessful_probes = self.health_check_probes / 2
+            else:
+                allowed_unsuccessful_probes = (self.health_check_probes + 1) / 2
+
+            for attempt in range(self.health_check_probes):
+                try:
+                    if not await health_check.check_health(database):
+                        allowed_unsuccessful_probes -= 1
+                        if allowed_unsuccessful_probes <= 0:
+                            return False
+                except Exception as e:
+                    allowed_unsuccessful_probes -= 1
+                    if allowed_unsuccessful_probes <= 0:
+                        raise UnhealthyDatabaseException(
+                            "Unhealthy database", database, e
+                        )
+
+                if attempt < self.health_check_probes - 1:
+                    await asyncio.sleep(self._health_check_delay)
+        return True
+
+
+class HealthyAnyPolicy(AbstractHealthCheckPolicy):
+    """
+    Policy that returns True if at least one health check probe is successful.
+    """
+
+    def __init__(self, health_check_probes: int, health_check_delay: float):
+        super().__init__(health_check_probes, health_check_delay)
+
+    async def execute(self, health_checks: List[HealthCheck], database) -> bool:
+        is_healthy = False
+
+        for health_check in health_checks:
+            exception = None
+
+            for attempt in range(self.health_check_probes):
+                try:
+                    if await health_check.check_health(database):
+                        is_healthy = True
+                        break
+                    else:
+                        is_healthy = False
+                except Exception as e:
+                    exception = UnhealthyDatabaseException(
+                        "Unhealthy database", database, e
+                    )
+
+                if attempt < self.health_check_probes - 1:
+                    await asyncio.sleep(self._health_check_delay)
+
+            if not is_healthy and not exception:
+                return is_healthy
+            elif not is_healthy and exception:
+                raise exception
+
+        return is_healthy
+
+
+class HealthCheckPolicies(Enum):
+    HEALTHY_ALL = HealthyAllPolicy
+    HEALTHY_MAJORITY = HealthyMajorityPolicy
+    HEALTHY_ANY = HealthyAnyPolicy
+
+
+DEFAULT_HEALTH_CHECK_POLICY: HealthCheckPolicies = HealthCheckPolicies.HEALTHY_ALL
+
+
+class EchoHealthCheck(HealthCheck):
+    """
+    Health check based on ECHO command.
+    """
+
+    async def check_health(self, database) -> bool:
+        expected_message = ["healthcheck", b"healthcheck"]
+
+        if isinstance(database.client, Redis):
+            actual_message = await database.client.execute_command(
+                "ECHO", "healthcheck"
+            )
+            return actual_message in expected_message
+        else:
+            # For a cluster checks if all nodes are healthy.
+            all_nodes = database.client.get_nodes()
+            for node in all_nodes:
+                actual_message = await node.execute_command("ECHO", "healthcheck")
+
+                if actual_message not in expected_message:
+                    return False
+
+            return True
+
+
+class LagAwareHealthCheck(HealthCheck):
+    """
+    Health check available for Redis Enterprise deployments.
+    Verify via REST API that the database is healthy based on different lags.
+    """
+
+    def __init__(
+        self,
+        rest_api_port: int = 9443,
+        lag_aware_tolerance: int = DEFAULT_LAG_AWARE_TOLERANCE,
+        timeout: float = DEFAULT_TIMEOUT,
+        auth_basic: Optional[Tuple[str, str]] = None,
+        verify_tls: bool = True,
+        # TLS verification (server) options
+        ca_file: Optional[str] = None,
+        ca_path: Optional[str] = None,
+        ca_data: Optional[Union[str, bytes]] = None,
+        # Mutual TLS (client cert) options
+        client_cert_file: Optional[str] = None,
+        client_key_file: Optional[str] = None,
+        client_key_password: Optional[str] = None,
+    ):
+        """
+        Initialize LagAwareHealthCheck with the specified parameters.
+
+        Args:
+            rest_api_port: Port number for Redis Enterprise REST API (default: 9443)
+            lag_aware_tolerance: Tolerance in lag between databases in MS (default: 100)
+            timeout: Request timeout in seconds (default: DEFAULT_TIMEOUT)
+            auth_basic: Tuple of (username, password) for basic authentication
+            verify_tls: Whether to verify TLS certificates (default: True)
+            ca_file: Path to CA certificate file for TLS verification
+            ca_path: Path to CA certificates directory for TLS verification
+            ca_data: CA certificate data as string or bytes
+            client_cert_file: Path to client certificate file for mutual TLS
+            client_key_file: Path to client private key file for mutual TLS
+            client_key_password: Password for encrypted client private key
+        """
+        self._http_client = AsyncHTTPClientWrapper(
+            HttpClient(
+                timeout=timeout,
+                auth_basic=auth_basic,
+                retry=Retry(NoBackoff(), retries=0),
+                verify_tls=verify_tls,
+                ca_file=ca_file,
+                ca_path=ca_path,
+                ca_data=ca_data,
+                client_cert_file=client_cert_file,
+                client_key_file=client_key_file,
+                client_key_password=client_key_password,
+            )
+        )
+        self._rest_api_port = rest_api_port
+        self._lag_aware_tolerance = lag_aware_tolerance
+
+    async def check_health(self, database) -> bool:
+        if database.health_check_url is None:
+            raise ValueError(
+                "Database health check url is not set. Please check DatabaseConfig for the current database."
+            )
+
+        if isinstance(database.client, Redis):
+            db_host = database.client.get_connection_kwargs()["host"]
+        else:
+            db_host = database.client.startup_nodes[0].host
+
+        base_url = f"{database.health_check_url}:{self._rest_api_port}"
+        self._http_client.client.base_url = base_url
+
+        # Find bdb matching to the current database host
+        matching_bdb = None
+        for bdb in await self._http_client.get("/v1/bdbs"):
+            for endpoint in bdb["endpoints"]:
+                if endpoint["dns_name"] == db_host:
+                    matching_bdb = bdb
+                    break
+
+                # In case if the host was set as public IP
+                for addr in endpoint["addr"]:
+                    if addr == db_host:
+                        matching_bdb = bdb
+                        break
+
+        if matching_bdb is None:
+            logger.warning("LagAwareHealthCheck failed: Couldn't find a matching bdb")
+            raise ValueError("Could not find a matching bdb")
+
+        url = (
+            f"/v1/bdbs/{matching_bdb['uid']}/availability"
+            f"?extend_check=lag&availability_lag_tolerance_ms={self._lag_aware_tolerance}"
+        )
+        await self._http_client.get(url, expect_json=False)
+
+        # Status checked in an http client, otherwise HttpError will be raised
+        return True
diff --git a/redis/background.py b/redis/background.py
new file mode 100644
index 0000000000..7d0eead11e
--- /dev/null
+++ b/redis/background.py
@@ -0,0 +1,204 @@
+import asyncio
+import threading
+from typing import Any, Callable, Coroutine
+
+
+class BackgroundScheduler:
+    """
+    Schedules background tasks execution either in separate thread or in the running event loop.
+    """
+
+    def __init__(self):
+        self._next_timer = None
+        self._event_loops = []
+        self._lock = threading.Lock()
+        self._stopped = False
+
+    def __del__(self):
+        self.stop()
+
+    def stop(self):
+        """
+        Stop all scheduled tasks and clean up resources.
+        """
+        with self._lock:
+            if self._stopped:
+                return
+            self._stopped = True
+
+            if self._next_timer:
+                self._next_timer.cancel()
+                self._next_timer = None
+
+            # Stop all event loops
+            for loop in self._event_loops:
+                if loop.is_running():
+                    loop.call_soon_threadsafe(loop.stop)
+
+            self._event_loops.clear()
+
+    def run_once(self, delay: float, callback: Callable, *args):
+        """
+        Runs callable task once after certain delay in seconds.
+        """
+        with self._lock:
+            if self._stopped:
+                return
+
+        # Run loop in a separate thread to unblock main thread.
+        loop = asyncio.new_event_loop()
+
+        with self._lock:
+            self._event_loops.append(loop)
+
+        thread = threading.Thread(
+            target=_start_event_loop_in_thread,
+            args=(loop, self._call_later, delay, callback, *args),
+            daemon=True,
+        )
+        thread.start()
+
+    def run_recurring(self, interval: float, callback: Callable, *args):
+        """
+        Runs recurring callable task with given interval in seconds.
+        """
+        with self._lock:
+            if self._stopped:
+                return
+
+        # Run loop in a separate thread to unblock main thread.
+        loop = asyncio.new_event_loop()
+
+        with self._lock:
+            self._event_loops.append(loop)
+
+        thread = threading.Thread(
+            target=_start_event_loop_in_thread,
+            args=(loop, self._call_later_recurring, interval, callback, *args),
+            daemon=True,
+        )
+        thread.start()
+
+    async def run_recurring_async(
+        self, interval: float, coro: Callable[..., Coroutine[Any, Any, Any]], *args
+    ):
+        """
+        Runs recurring coroutine with given interval in seconds in the current event loop.
+        To be used only from an async context. No additional threads are created.
+        """
+        with self._lock:
+            if self._stopped:
+                return
+
+        loop = asyncio.get_running_loop()
+        wrapped = _async_to_sync_wrapper(loop, coro, *args)
+
+        def tick():
+            with self._lock:
+                if self._stopped:
+                    return
+            # Schedule the coroutine
+            wrapped()
+            # Schedule next tick
+            self._next_timer = loop.call_later(interval, tick)
+
+        # Schedule first tick
+        self._next_timer = loop.call_later(interval, tick)
+
+    def _call_later(
+        self, loop: asyncio.AbstractEventLoop, delay: float, callback: Callable, *args
+    ):
+        with self._lock:
+            if self._stopped:
+                return
+        self._next_timer = loop.call_later(delay, callback, *args)
+
+    def _call_later_recurring(
+        self,
+        loop: asyncio.AbstractEventLoop,
+        interval: float,
+        callback: Callable,
+        *args,
+    ):
+        with self._lock:
+            if self._stopped:
+                return
+        self._call_later(
+            loop, interval, self._execute_recurring, loop, interval, callback, *args
+        )
+
+    def _execute_recurring(
+        self,
+        loop: asyncio.AbstractEventLoop,
+        interval: float,
+        callback: Callable,
+        *args,
+    ):
+        """
+        Executes recurring callable task with given interval in seconds.
+        """
+        with self._lock:
+            if self._stopped:
+                return
+
+        try:
+            callback(*args)
+        except Exception:
+            # Silently ignore exceptions during shutdown
+            pass
+
+        with self._lock:
+            if self._stopped:
+                return
+
+        self._call_later(
+            loop, interval, self._execute_recurring, loop, interval, callback, *args
+        )
+
+
+def _start_event_loop_in_thread(
+    event_loop: asyncio.AbstractEventLoop, call_soon_cb: Callable, *args
+):
+    """
+    Starts event loop in a thread and schedule callback as soon as event loop is ready.
+    Used to be able to schedule tasks using loop.call_later.
+
+    :param event_loop:
+    :return:
+    """
+    asyncio.set_event_loop(event_loop)
+    event_loop.call_soon(call_soon_cb, event_loop, *args)
+    try:
+        event_loop.run_forever()
+    finally:
+        try:
+            # Clean up pending tasks
+            pending = asyncio.all_tasks(event_loop)
+            for task in pending:
+                task.cancel()
+            # Run loop once more to process cancellations
+            event_loop.run_until_complete(
+                asyncio.gather(*pending, return_exceptions=True)
+            )
+        except Exception:
+            pass
+        finally:
+            event_loop.close()
+
+
+def _async_to_sync_wrapper(loop, coro_func, *args, **kwargs):
+    """
+    Wraps an asynchronous function so it can be used with loop.call_later.
+
+    :param loop: The event loop in which the coroutine will be executed.
+    :param coro_func: The coroutine function to wrap.
+    :param args: Positional arguments to pass to the coroutine function.
+    :param kwargs: Keyword arguments to pass to the coroutine function.
+    :return: A regular function suitable for loop.call_later.
+    """
+
+    def wrapped():
+        # Schedule the coroutine in the event loop
+        asyncio.ensure_future(coro_func(*args, **kwargs), loop=loop)
+
+    return wrapped
diff --git a/redis/client.py b/redis/client.py
index df9a55092d..b8d2e8af5d 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -1274,6 +1274,8 @@ def run_in_thread(
         sleep_time: float = 0.0,
         daemon: bool = False,
         exception_handler: Optional[Callable] = None,
+        pubsub=None,
+        sharded_pubsub: bool = False,
     ) -> "PubSubWorkerThread":
         for channel, handler in self.channels.items():
             if handler is None:
@@ -1287,8 +1289,13 @@ def run_in_thread(
                     f"Shard Channel: '{s_channel}' has no handler registered"
                 )
 
+        pubsub = self if pubsub is None else pubsub
         thread = PubSubWorkerThread(
-            self, sleep_time, daemon=daemon, exception_handler=exception_handler
+            pubsub,
+            sleep_time,
+            daemon=daemon,
+            exception_handler=exception_handler,
+            sharded_pubsub=sharded_pubsub,
         )
         thread.start()
         return thread
@@ -1303,12 +1310,14 @@ def __init__(
         exception_handler: Union[
             Callable[[Exception, "PubSub", "PubSubWorkerThread"], None], None
         ] = None,
+        sharded_pubsub: bool = False,
     ):
         super().__init__()
         self.daemon = daemon
         self.pubsub = pubsub
         self.sleep_time = sleep_time
         self.exception_handler = exception_handler
+        self.sharded_pubsub = sharded_pubsub
         self._running = threading.Event()
 
     def run(self) -> None:
@@ -1319,7 +1328,14 @@ def run(self) -> None:
         sleep_time = self.sleep_time
         while self._running.is_set():
             try:
-                pubsub.get_message(ignore_subscribe_messages=True, timeout=sleep_time)
+                if not self.sharded_pubsub:
+                    pubsub.get_message(
+                        ignore_subscribe_messages=True, timeout=sleep_time
+                    )
+                else:
+                    pubsub.get_sharded_message(
+                        ignore_subscribe_messages=True, timeout=sleep_time
+                    )
             except BaseException as e:
                 if self.exception_handler is None:
                     raise
diff --git a/redis/cluster.py b/redis/cluster.py
index 839721edf1..1d4a3e0d0c 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -695,6 +695,7 @@ def __init__(
             self._event_dispatcher = EventDispatcher()
         else:
             self._event_dispatcher = event_dispatcher
+        self.startup_nodes = startup_nodes
         self.nodes_manager = NodesManager(
             startup_nodes=startup_nodes,
             from_url=from_url,
@@ -3164,7 +3165,8 @@ def _reinitialize_on_error(self, error):
                 self._nodes_manager.initialize()
                 self.reinitialize_counter = 0
             else:
-                self._nodes_manager.update_moved_exception(error)
+                if isinstance(error, AskError):
+                    self._nodes_manager.update_moved_exception(error)
 
         self._executing = False
 
diff --git a/redis/data_structure.py b/redis/data_structure.py
new file mode 100644
index 0000000000..0571e223ad
--- /dev/null
+++ b/redis/data_structure.py
@@ -0,0 +1,81 @@
+import threading
+from typing import Any, Generic, List, TypeVar
+
+from redis.typing import Number
+
+T = TypeVar("T")
+
+
+class WeightedList(Generic[T]):
+    """
+    Thread-safe weighted list.
+    """
+
+    def __init__(self):
+        self._items: List[tuple[Any, Number]] = []
+        self._lock = threading.RLock()
+
+    def add(self, item: Any, weight: float) -> None:
+        """Add item with weight, maintaining sorted order"""
+        with self._lock:
+            # Find insertion point using binary search
+            left, right = 0, len(self._items)
+            while left < right:
+                mid = (left + right) // 2
+                if self._items[mid][1] < weight:
+                    right = mid
+                else:
+                    left = mid + 1
+
+            self._items.insert(left, (item, weight))
+
+    def remove(self, item):
+        """Remove first occurrence of item"""
+        with self._lock:
+            for i, (stored_item, weight) in enumerate(self._items):
+                if stored_item == item:
+                    self._items.pop(i)
+                    return weight
+            raise ValueError("Item not found")
+
+    def get_by_weight_range(
+        self, min_weight: float, max_weight: float
+    ) -> List[tuple[Any, Number]]:
+        """Get all items within weight range"""
+        with self._lock:
+            result = []
+            for item, weight in self._items:
+                if min_weight <= weight <= max_weight:
+                    result.append((item, weight))
+            return result
+
+    def get_top_n(self, n: int) -> List[tuple[Any, Number]]:
+        """Get top N the highest weighted items"""
+        with self._lock:
+            return [(item, weight) for item, weight in self._items[:n]]
+
+    def update_weight(self, item, new_weight: float):
+        with self._lock:
+            """Update weight of an item"""
+            old_weight = self.remove(item)
+            self.add(item, new_weight)
+            return old_weight
+
+    def __iter__(self):
+        """Iterate in descending weight order"""
+        with self._lock:
+            items_copy = (
+                self._items.copy()
+            )  # Create snapshot as lock released after each 'yield'
+
+        for item, weight in items_copy:
+            yield item, weight
+
+    def __len__(self):
+        with self._lock:
+            return len(self._items)
+
+    def __getitem__(self, index) -> tuple[Any, Number]:
+        with self._lock:
+            item, weight = self._items[index]
+            return item, weight
diff --git a/redis/event.py b/redis/event.py
index b86c66b082..03c72c6370 100644
--- a/redis/event.py
+++ b/redis/event.py
@@ -2,7 +2,7 @@
 import threading
 from abc import ABC, abstractmethod
 from enum import Enum
-from typing import List, Optional, Union
+from typing import Dict, List, Optional, Type, Union
 
 from redis.auth.token import TokenInterface
 from redis.credentials import CredentialProvider, StreamingCredentialProvider
@@ -42,6 +42,17 @@ def dispatch(self, event: object):
     async def dispatch_async(self, event: object):
         pass
 
+    @abstractmethod
+    def register_listeners(
+        self,
+        mappings: Dict[
+            Type[object],
+            List[Union[EventListenerInterface, AsyncEventListenerInterface]],
+        ],
+    ):
+        """Register additional listeners."""
+        pass
+
 
 class EventException(Exception):
     """
@@ -56,11 +67,18 @@ def __init__(self, exception: Exception, event: object):
 
 class EventDispatcher(EventDispatcherInterface):
     # TODO: Make dispatcher to accept external mappings.
-    def __init__(self):
+    def __init__(
+        self,
+        event_listeners: Optional[
+            Dict[Type[object], List[EventListenerInterface]]
+        ] = None,
+    ):
         """
-        Mapping should be extended for any new events or listeners to be added.
+        Dispatcher that dispatches events to listeners associated with given event.
         """
-        self._event_listeners_mapping = {
+        self._event_listeners_mapping: Dict[
+            Type[object], List[EventListenerInterface]
+        ] = {
             AfterConnectionReleasedEvent: [
                 ReAuthConnectionListener(),
             ],
@@ -77,17 +95,47 @@ def __init__(self):
             ],
         }
 
+        self._lock = threading.Lock()
+        self._async_lock = None
+
+        if event_listeners:
+            self.register_listeners(event_listeners)
+
     def dispatch(self, event: object):
-        listeners = self._event_listeners_mapping.get(type(event))
+        with self._lock:
+            listeners = self._event_listeners_mapping.get(type(event), [])
 
-        for listener in listeners:
-            listener.listen(event)
+            for listener in listeners:
+                listener.listen(event)
 
     async def dispatch_async(self, event: object):
-        listeners = self._event_listeners_mapping.get(type(event))
+        if self._async_lock is None:
+            self._async_lock = asyncio.Lock()
+
+        async with self._async_lock:
+            listeners = self._event_listeners_mapping.get(type(event), [])
 
-        for listener in listeners:
-            await listener.listen(event)
+            for listener in listeners:
+                await listener.listen(event)
+
+    def register_listeners(
+        self,
+        mappings: Dict[
+            Type[object],
+            List[Union[EventListenerInterface, AsyncEventListenerInterface]],
+        ],
+    ):
+        with self._lock:
+            for event_type in mappings:
+                if event_type in self._event_listeners_mapping:
+                    self._event_listeners_mapping[event_type] = list(
+                        set(
+                            self._event_listeners_mapping[event_type]
+                            + mappings[event_type]
+                        )
+                    )
+                else:
+                    self._event_listeners_mapping[event_type] = mappings[event_type]
 
 
 class AfterConnectionReleasedEvent:
@@ -226,6 +274,32 @@ def credential_provider(self) -> Union[CredentialProvider, None]:
         return self._credential_provider
 
 
+class OnCommandsFailEvent:
+    """
+    Event fired whenever a command fails during the execution.
+    """
+
+    def __init__(
+        self,
+        commands: tuple,
+        exception: Exception,
+    ):
+        self._commands = commands
+        self._exception = exception
+
+    @property
+    def commands(self) -> tuple:
+        return self._commands
+
+    @property
+    def exception(self) -> Exception:
+        return self._exception
+
+
+class AsyncOnCommandsFailEvent(OnCommandsFailEvent):
+    pass
+
+
 class ReAuthConnectionListener(EventListenerInterface):
     """
     Listener that performs re-authentication of given connection.
diff --git a/redis/http/__init__.py b/redis/http/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/redis/http/http_client.py b/redis/http/http_client.py
new file mode 100644
index 0000000000..7d9d5c4ad4
--- /dev/null
+++ b/redis/http/http_client.py
@@ -0,0 +1,425 @@
+from __future__ import annotations
+
+import base64
+import gzip
+import json
+import ssl
+import zlib
+from dataclasses import dataclass
+from typing import Any, Dict, Mapping, Optional, Tuple, Union
+from urllib.error import HTTPError, URLError
+from urllib.parse import urlencode, urljoin
+from urllib.request import Request, urlopen
+
+__all__ = ["HttpClient", "HttpResponse", "HttpError", "DEFAULT_TIMEOUT"]
+
+from redis.backoff import ExponentialWithJitterBackoff
+from redis.retry import Retry
+from redis.utils import dummy_fail
+
+DEFAULT_USER_AGENT = "HttpClient/1.0 (+https://example.invalid)"
+DEFAULT_TIMEOUT = 30.0
+RETRY_STATUS_CODES = {429, 500, 502, 503, 504}
+
+
+@dataclass
+class HttpResponse:
+    status: int
+    headers: Dict[str, str]
+    url: str
+    content: bytes
+
+    def text(self, encoding: Optional[str] = None) -> str:
+        enc = encoding or self._get_encoding()
+        return self.content.decode(enc, errors="replace")
+
+    def json(self) -> Any:
+        return json.loads(self.text(encoding=self._get_encoding()))
+
+    def _get_encoding(self) -> str:
+        # Try to infer encoding from headers; default to utf-8
+        ctype = self.headers.get("content-type", "")
+        # Example: application/json; charset=utf-8
+        for part in ctype.split(";"):
+            p = part.strip()
+            if p.lower().startswith("charset="):
+                return p.split("=", 1)[1].strip() or "utf-8"
+        return "utf-8"
+
+
+class HttpError(Exception):
+    def __init__(self, status: int, url: str, message: Optional[str] = None):
+        self.status = status
+        self.url = url
+        self.message = message or f"HTTP {status} for {url}"
+        super().__init__(self.message)
+
+
+class HttpClient:
+    """
+    A lightweight HTTP client for REST API calls.
+    """
+
+    def __init__(
+        self,
+        base_url: str = "",
+        headers: Optional[Mapping[str, str]] = None,
+        timeout: float = DEFAULT_TIMEOUT,
+        retry: Retry = Retry(
+            backoff=ExponentialWithJitterBackoff(base=1, cap=10), retries=3
+        ),
+        verify_tls: bool = True,
+        # TLS verification (server) options
+        ca_file: Optional[str] = None,
+        ca_path: Optional[str] = None,
+        ca_data: Optional[Union[str, bytes]] = None,
+        # Mutual TLS (client cert) options
+        client_cert_file: Optional[str] = None,
+        client_key_file: Optional[str] = None,
+        client_key_password: Optional[str] = None,
+        auth_basic: Optional[Tuple[str, str]] = None,  # (username, password)
+        user_agent: str = DEFAULT_USER_AGENT,
+    ) -> None:
+        """
+        Initialize a new HTTP client instance.
+
+        Args:
+            base_url: Base URL for all requests. Will be prefixed to all paths.
+            headers: Default headers to include in all requests.
+            timeout: Default timeout in seconds for requests.
+            retry: Retry configuration for failed requests.
+            verify_tls: Whether to verify TLS certificates.
+            ca_file: Path to CA certificate file for TLS verification.
+            ca_path: Path to a directory containing CA certificates.
+            ca_data: CA certificate data as string or bytes.
+            client_cert_file: Path to client certificate for mutual TLS.
+            client_key_file: Path to a client private key for mutual TLS.
+            client_key_password: Password for an encrypted client private key.
+            auth_basic: Tuple of (username, password) for HTTP basic auth.
+            user_agent: User-Agent header value for requests.
+
+        The client supports both regular HTTPS with server verification and mutual TLS
+        authentication. For server verification, provide CA certificate information via
+        ca_file, ca_path or ca_data. For mutual TLS, additionally provide a client
+        certificate and key via client_cert_file and client_key_file.
+        """
+        self.base_url = (
+            base_url.rstrip() + "/"
+            if base_url and not base_url.endswith("/")
+            else base_url
+        )
+        self._default_headers = {k.lower(): v for k, v in (headers or {}).items()}
+        self.timeout = timeout
+        self.retry = retry
+        self.retry.update_supported_errors((HTTPError, URLError, ssl.SSLError))
+        self.verify_tls = verify_tls
+
+        # TLS settings
+        self.ca_file = ca_file
+        self.ca_path = ca_path
+        self.ca_data = ca_data
+        self.client_cert_file = client_cert_file
+        self.client_key_file = client_key_file
+        self.client_key_password = client_key_password
+
+        self.auth_basic = auth_basic
+        self.user_agent = user_agent
+
+    # Public JSON-centric helpers
+    def get(
+        self,
+        path: str,
+        params: Optional[
+            Mapping[str, Union[None, str, int, float, bool, list, tuple]]
+        ] = None,
+        headers: Optional[Mapping[str, str]] = None,
+        timeout: Optional[float] = None,
+        expect_json: bool = True,
+    ) -> Union[HttpResponse, Any]:
+        return self._json_call(
+            "GET",
+            path,
+            params=params,
+            headers=headers,
+            timeout=timeout,
+            body=None,
+            expect_json=expect_json,
+        )
+
+    def delete(
+        self,
+        path: str,
+        params: Optional[
+            Mapping[str, Union[None, str, int, float, bool, list, tuple]]
+        ] = None,
+        headers: Optional[Mapping[str, str]] = None,
+        timeout: Optional[float] = None,
+        expect_json: bool = True,
+    ) -> Union[HttpResponse, Any]:
+        return self._json_call(
+            "DELETE",
+            path,
+            params=params,
+            headers=headers,
+            timeout=timeout,
+            body=None,
+            expect_json=expect_json,
+        )
+
+    def post(
+        self,
+        path: str,
+        json_body: Optional[Any] = None,
+        data: Optional[Union[bytes, str]] = None,
+        params: Optional[
+            Mapping[str, Union[None, str, int, float, bool, list, tuple]]
+        ] = None,
+        headers: Optional[Mapping[str, str]] = None,
+        timeout: Optional[float] = None,
+        expect_json: bool = True,
+    ) -> Union[HttpResponse, Any]:
+        return self._json_call(
+            "POST",
+            path,
+            params=params,
+            headers=headers,
+            timeout=timeout,
+            body=self._prepare_body(json_body=json_body, data=data),
+            expect_json=expect_json,
+        )
+
+    def put(
+        self,
+        path: str,
+        json_body: Optional[Any] = None,
+        data: Optional[Union[bytes, str]] = None,
+        params: Optional[
+            Mapping[str, Union[None, str, int, float, bool, list, tuple]]
+        ] = None,
+        headers: Optional[Mapping[str, str]] = None,
+        timeout: Optional[float] = None,
+        expect_json: bool = True,
+    ) -> Union[HttpResponse, Any]:
+        return self._json_call(
+            "PUT",
+            path,
+            params=params,
+            headers=headers,
+            timeout=timeout,
+            body=self._prepare_body(json_body=json_body, data=data),
+            expect_json=expect_json,
+        )
+
+    def patch(
+        self,
+        path: str,
+        json_body: Optional[Any] = None,
+        data: Optional[Union[bytes, str]] = None,
+        params: Optional[
+            Mapping[str, Union[None, str, int, float, bool, list, tuple]]
+        ] = None,
+        headers: Optional[Mapping[str, str]] = None,
+        timeout: Optional[float] = None,
+        expect_json: bool = True,
+    ) -> Union[HttpResponse, Any]:
+        return self._json_call(
+            "PATCH",
+            path,
+            params=params,
+            headers=headers,
+            timeout=timeout,
+            body=self._prepare_body(json_body=json_body, data=data),
+            expect_json=expect_json,
+        )
+
+    # Low-level request
+    def request(
+        self,
+        method: str,
+        path: str,
+        params: Optional[
+            Mapping[str, Union[None, str, int, float, bool, list, tuple]]
+        ] = None,
+        headers: Optional[Mapping[str, str]] = None,
+        body: Optional[Union[bytes, str]] = None,
+        timeout: Optional[float] = None,
+    ) -> HttpResponse:
+        url = self._build_url(path, params)
+        all_headers = self._prepare_headers(headers, body)
+        data = body.encode("utf-8") if isinstance(body, str) else body
+
+        req = Request(url=url, method=method.upper(), data=data, headers=all_headers)
+
+        context: Optional[ssl.SSLContext] = None
+        if url.lower().startswith("https"):
+            if self.verify_tls:
+                # Use provided CA material if any; fall back to system defaults
+                context = ssl.create_default_context(
+                    cafile=self.ca_file,
+                    capath=self.ca_path,
+                    cadata=self.ca_data,
+                )
+                # Load client certificate for mTLS if configured
+                if self.client_cert_file:
+                    context.load_cert_chain(
+                        certfile=self.client_cert_file,
+                        keyfile=self.client_key_file,
+                        password=self.client_key_password,
+                    )
+            else:
+                # Verification disabled
+                context = ssl.create_default_context()
+                context.check_hostname = False
+                context.verify_mode = ssl.CERT_NONE
+
+        try:
+            return self.retry.call_with_retry(
+                lambda: self._make_request(req, context=context, timeout=timeout),
+                lambda _: dummy_fail(),
+                lambda error: self._is_retryable_http_error(error),
+            )
+        except HTTPError as e:
+            # Read error body, build response, and decide on retry
+            err_body = b""
+            try:
+                err_body = e.read()
+            except Exception:
+                pass
+            headers_map = {k.lower(): v for k, v in (e.headers or {}).items()}
+            err_body = self._maybe_decompress(err_body, headers_map)
+            status = getattr(e, "code", 0) or 0
+            response = HttpResponse(
+                status=status,
+                headers=headers_map,
+                url=url,
+                content=err_body,
+            )
+            return response
+
+    def _make_request(
+        self,
+        request: Request,
+        context: Optional[ssl.SSLContext] = None,
+        timeout: Optional[float] = None,
+    ):
+        with urlopen(request, timeout=timeout or self.timeout, context=context) as resp:
+            raw = resp.read()
+            headers_map = {k.lower(): v for k, v in resp.headers.items()}
+            raw = self._maybe_decompress(raw, headers_map)
+            return HttpResponse(
+                status=resp.status,
+                headers=headers_map,
+                url=resp.geturl(),
+                content=raw,
+            )
+
+    def _is_retryable_http_error(self, error: Exception) -> bool:
+        if isinstance(error, HTTPError):
+            return self._should_retry_status(error.code)
+        return False
+
+    # Internal utilities
+    def _json_call(
+        self,
+        method: str,
+        path: str,
+        params: Optional[
+            Mapping[str, Union[None, str, int, float, bool, list, tuple]]
+        ] = None,
+        headers: Optional[Mapping[str, str]] = None,
+        timeout: Optional[float] = None,
+        body: Optional[Union[bytes, str]] = None,
+        expect_json: bool = True,
+    ) -> Union[HttpResponse, Any]:
+        resp = self.request(
+            method=method,
+            path=path,
+            params=params,
+            headers=headers,
+            body=body,
+            timeout=timeout,
+        )
+        if not (200 <= resp.status < 400):
+            raise HttpError(resp.status, resp.url, resp.text())
+        if expect_json:
+            return resp.json()
+        return resp
+
+    def _prepare_body(
+        self, json_body: Optional[Any] = None, data: Optional[Union[bytes, str]] = None
+    ) -> Optional[Union[bytes, str]]:
+        if json_body is not None and data is not None:
+            raise ValueError("Provide either json_body or data, not both.")
+        if json_body is not None:
+            return json.dumps(json_body, ensure_ascii=False, separators=(",", ":"))
+        return data
+
+    def _build_url(
+        self,
+        path: str,
+        params: Optional[
+            Mapping[str, Union[None, str, int, float, bool, list, tuple]]
+        ] = None,
+    ) -> str:
+        url = urljoin(self.base_url or "", path)
+        if params:
+            # urlencode with doseq=True supports list/tuple values
+            query = urlencode(
+                {k: v for k, v in params.items() if v is not None}, doseq=True
+            )
+            separator = "&" if ("?" in url) else "?"
+            url = f"{url}{separator}{query}" if query else url
+        return url
+
+    def _prepare_headers(
+        self, headers: Optional[Mapping[str, str]], body: Optional[Union[bytes, str]]
+    ) -> Dict[str, str]:
+        # Start with defaults
+        prepared: Dict[str, str] = {}
+        prepared.update(self._default_headers)
+
+        # Standard defaults for JSON REST usage
+        prepared.setdefault("accept", "application/json")
+        prepared.setdefault("user-agent", self.user_agent)
+        # We will send gzip accept-encoding; handle decompression manually
+        prepared.setdefault("accept-encoding", "gzip, deflate")
+
+        # If we have a string body and content-type not specified, assume JSON
+        if body is not None and isinstance(body, str):
+            prepared.setdefault("content-type", "application/json; charset=utf-8")
+
+        # Basic authentication if provided and not overridden
+        if self.auth_basic and "authorization" not in prepared:
+            user, pwd = self.auth_basic
+            token = base64.b64encode(f"{user}:{pwd}".encode("utf-8")).decode("ascii")
+            prepared["authorization"] = f"Basic {token}"
+
+        # Merge per-call headers (case-insensitive)
+        if headers:
+            for k, v in headers.items():
+                prepared[k.lower()] = v
+
+        # urllib expects header keys in canonical capitalization sometimes; but it’s tolerant.
+        # We'll return as provided; urllib will handle it.
+        return prepared
+
+    def _should_retry_status(self, status: int) -> bool:
+        return status in RETRY_STATUS_CODES
+
+    def _maybe_decompress(self, content: bytes, headers: Mapping[str, str]) -> bytes:
+        if not content:
+            return content
+        encoding = (headers.get("content-encoding") or "").lower()
+        try:
+            if "gzip" in encoding:
+                return gzip.decompress(content)
+            if "deflate" in encoding:
+                # Try raw deflate, then zlib-wrapped
+                try:
+                    return zlib.decompress(content, -zlib.MAX_WBITS)
+                except zlib.error:
+                    return zlib.decompress(content)
+        except Exception:
+            # If decompression fails, return original bytes
+            return content
+        return content
diff --git a/redis/multidb/__init__.py b/redis/multidb/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/redis/multidb/circuit.py b/redis/multidb/circuit.py
new file mode 100644
index 0000000000..8af6cc32de
--- /dev/null
+++ b/redis/multidb/circuit.py
@@ -0,0 +1,144 @@
+from abc import ABC, abstractmethod
+from enum import Enum
+from typing import Callable
+
+import pybreaker
+
+DEFAULT_GRACE_PERIOD = 60
+
+
+class State(Enum):
+    CLOSED = "closed"
+    OPEN = "open"
+    HALF_OPEN = "half-open"
+
+
+class CircuitBreaker(ABC):
+    @property
+    @abstractmethod
+    def grace_period(self) -> float:
+        """The grace period in seconds when the circle should be kept open."""
+        pass
+
+    @grace_period.setter
+    @abstractmethod
+    def grace_period(self, grace_period: float):
+        """Set the grace period in seconds."""
+
+    @property
+    @abstractmethod
+    def state(self) -> State:
+        """The current state of the circuit."""
+        pass
+
+    @state.setter
+    @abstractmethod
+    def state(self, state: State):
+        """Set current state of the circuit."""
+        pass
+
+    @property
+    @abstractmethod
+    def database(self):
+        """Database associated with this circuit."""
+        pass
+
+    @database.setter
+    @abstractmethod
+    def database(self, database):
+        """Set database associated with this circuit."""
+        pass
+
+    @abstractmethod
+    def on_state_changed(self, cb: Callable[["CircuitBreaker", State, State], None]):
+        """Callback called when the state of the circuit changes."""
+        pass
+
+
+class BaseCircuitBreaker(CircuitBreaker):
+    """
+    Base implementation of Circuit Breaker interface.
+    """
+
+    def __init__(self, cb: pybreaker.CircuitBreaker):
+        self._cb = cb
+        self._state_pb_mapper = {
+            State.CLOSED: self._cb.close,
+            State.OPEN: self._cb.open,
+            State.HALF_OPEN: self._cb.half_open,
+        }
+        self._database = None
+
+    @property
+    def grace_period(self) -> float:
+        return self._cb.reset_timeout
+
+    @grace_period.setter
+    def grace_period(self, grace_period: float):
+        self._cb.reset_timeout = grace_period
+
+    @property
+    def state(self) -> State:
+        return State(value=self._cb.state.name)
+
+    @state.setter
+    def state(self, state: State):
+        self._state_pb_mapper[state]()
+
+    @property
+    def database(self):
+        return self._database
+
+    @database.setter
+    def database(self, database):
+        self._database = database
+
+    @abstractmethod
+    def on_state_changed(self, cb: Callable[["CircuitBreaker", State, State], None]):
+        """Callback called when the state of the circuit changes."""
+        pass
+
+
+class PBListener(pybreaker.CircuitBreakerListener):
+    """Wrapper for callback to be compatible with pybreaker implementation."""
+
+    def __init__(
+        self,
+        cb: Callable[[CircuitBreaker, State, State], None],
+        database,
+    ):
+        """
+        Initialize a PBListener instance.
+
+        Args:
+            cb: Callback function that will be called when the circuit breaker state changes.
+            database: Database instance associated with this circuit breaker.
+        """
+
+        self._cb = cb
+        self._database = database
+
+    def state_change(self, cb, old_state, new_state):
+        cb = PBCircuitBreakerAdapter(cb)
+        cb.database = self._database
+        old_state = State(value=old_state.name)
+        new_state = State(value=new_state.name)
+        self._cb(cb, old_state, new_state)
+
+
+class PBCircuitBreakerAdapter(BaseCircuitBreaker):
+    def __init__(self, cb: pybreaker.CircuitBreaker):
+        """
+        Initialize a PBCircuitBreakerAdapter instance.
+
+        This adapter wraps pybreaker's CircuitBreaker implementation to make it compatible
+        with our CircuitBreaker interface.
+
+        Args:
+            cb: A pybreaker CircuitBreaker instance to be adapted.
+        """
+        super().__init__(cb)
+
+    def on_state_changed(self, cb: Callable[["CircuitBreaker", State, State], None]):
+        listener = PBListener(cb, self.database)
+        self._cb.add_listener(listener)
diff --git a/redis/multidb/client.py b/redis/multidb/client.py
new file mode 100644
index 0000000000..02c3516eee
--- /dev/null
+++ b/redis/multidb/client.py
@@ -0,0 +1,524 @@
+import logging
+import threading
+from concurrent.futures import as_completed
+from concurrent.futures.thread import ThreadPoolExecutor
+from typing import Any, Callable, List, Optional
+
+from redis.background import BackgroundScheduler
+from redis.client import PubSubWorkerThread
+from redis.commands import CoreCommands, RedisModuleCommands
+from redis.multidb.circuit import CircuitBreaker
+from redis.multidb.circuit import State as CBState
+from redis.multidb.command_executor import DefaultCommandExecutor
+from redis.multidb.config import DEFAULT_GRACE_PERIOD, MultiDbConfig
+from redis.multidb.database import Database, Databases, SyncDatabase
+from redis.multidb.exception import NoValidDatabaseException, UnhealthyDatabaseException
+from redis.multidb.failure_detector import FailureDetector
+from redis.multidb.healthcheck import HealthCheck, HealthCheckPolicy
+
+logger = logging.getLogger(__name__)
+
+
+class MultiDBClient(RedisModuleCommands, CoreCommands):
+    """
+    Client that operates on multiple logical Redis databases.
+    Should be used in Active-Active database setups.
+    """
+
+    def __init__(self, config: MultiDbConfig):
+        self._databases = config.databases()
+        self._health_checks = config.default_health_checks()
+
+        if config.health_checks is not None:
+            self._health_checks.extend(config.health_checks)
+
+        self._health_check_interval = config.health_check_interval
+        self._health_check_policy: HealthCheckPolicy = config.health_check_policy.value(
+            config.health_check_probes, config.health_check_probes_delay
+        )
+        self._failure_detectors = config.default_failure_detectors()
+
+        if config.failure_detectors is not None:
+            self._failure_detectors.extend(config.failure_detectors)
+
+        self._failover_strategy = (
+            config.default_failover_strategy()
+            if config.failover_strategy is None
+            else config.failover_strategy
+        )
+        self._failover_strategy.set_databases(self._databases)
+        self._auto_fallback_interval = config.auto_fallback_interval
+        self._event_dispatcher = config.event_dispatcher
+        self._command_retry = config.command_retry
+        self._command_retry.update_supported_errors((ConnectionRefusedError,))
+        self.command_executor = DefaultCommandExecutor(
+            failure_detectors=self._failure_detectors,
+            databases=self._databases,
+            command_retry=self._command_retry,
+            failover_strategy=self._failover_strategy,
+            failover_attempts=config.failover_attempts,
+            failover_delay=config.failover_delay,
+            event_dispatcher=self._event_dispatcher,
+            auto_fallback_interval=self._auto_fallback_interval,
+        )
+        self.initialized = False
+        self._hc_lock = threading.RLock()
+        self._bg_scheduler = BackgroundScheduler()
+        self._config = config
+
+    def initialize(self):
+        """
+        Perform initialization of databases to define their initial state.
+        """
+
+        def raise_exception_on_failed_hc(error):
+            raise error
+
+        # Initial databases check to define initial state
+        self._check_databases_health(on_error=raise_exception_on_failed_hc)
+
+        # Starts recurring health checks on the background.
+        self._bg_scheduler.run_recurring(
+            self._health_check_interval,
+            self._check_databases_health,
+        )
+
+        is_active_db_found = False
+
+        for database, weight in self._databases:
+            # Set on state changed callback for each circuit.
+            database.circuit.on_state_changed(self._on_circuit_state_change_callback)
+
+            # Set states according to a weights and circuit state
+            if database.circuit.state == CBState.CLOSED and not is_active_db_found:
+                self.command_executor.active_database = database
+                is_active_db_found = True
+
+        if not is_active_db_found:
+            raise NoValidDatabaseException(
+                "Initial connection failed - no active database found"
+            )
+
+        self.initialized = True
+
+    def get_databases(self) -> Databases:
+        """
+        Returns a sorted (by weight) list of all databases.
+        """
+        return self._databases
+
+    def set_active_database(self, database: SyncDatabase) -> None:
+        """
+        Promote one of the existing databases to become an active.
+        """
+        exists = None
+
+        for existing_db, _ in self._databases:
+            if existing_db == database:
+                exists = True
+                break
+
+        if not exists:
+            raise ValueError("Given database is not a member of database list")
+
+        self._check_db_health(database)
+
+        if database.circuit.state == CBState.CLOSED:
+            highest_weighted_db, _ = self._databases.get_top_n(1)[0]
+            self.command_executor.active_database = database
+            return
+
+        raise NoValidDatabaseException(
+            "Cannot set active database, database is unhealthy"
+        )
+
+    def add_database(self, database: SyncDatabase):
+        """
+        Adds a new database to the database list.
+        """
+        for existing_db, _ in self._databases:
+            if existing_db == database:
+                raise ValueError("Given database already exists")
+
+        self._check_db_health(database)
+
+        highest_weighted_db, highest_weight = self._databases.get_top_n(1)[0]
+        self._databases.add(database, database.weight)
+        self._change_active_database(database, highest_weighted_db)
+
+    def _change_active_database(
+        self, new_database: SyncDatabase, highest_weight_database: SyncDatabase
+    ):
+        if (
+            new_database.weight > highest_weight_database.weight
+            and new_database.circuit.state == CBState.CLOSED
+        ):
+            self.command_executor.active_database = new_database
+
+    def remove_database(self, database: Database):
+        """
+        Removes a database from the database list.
+        """
+        weight = self._databases.remove(database)
+        highest_weighted_db, highest_weight = self._databases.get_top_n(1)[0]
+
+        if (
+            highest_weight <= weight
+            and highest_weighted_db.circuit.state == CBState.CLOSED
+        ):
+            self.command_executor.active_database = highest_weighted_db
+
+    def update_database_weight(self, database: SyncDatabase, weight: float):
+        """
+        Updates a database from the database list.
+        """
+        exists = None
+
+        for existing_db, _ in self._databases:
+            if existing_db == database:
+                exists = True
+                break
+
+        if not exists:
+            raise ValueError("Given database is not a member of database list")
+
+        highest_weighted_db, highest_weight = self._databases.get_top_n(1)[0]
+        self._databases.update_weight(database, weight)
+        database.weight = weight
+        self._change_active_database(database, highest_weighted_db)
+
+    def add_failure_detector(self, failure_detector: FailureDetector):
+        """
+        Adds a new failure detector to the database.
+        """
+        self._failure_detectors.append(failure_detector)
+
+    def add_health_check(self, healthcheck: HealthCheck):
+        """
+        Adds a new health check to the database.
+        """
+        with self._hc_lock:
+            self._health_checks.append(healthcheck)
+
+    def execute_command(self, *args, **options):
+        """
+        Executes a single command and return its result.
+        """
+        if not self.initialized:
+            self.initialize()
+
+        return self.command_executor.execute_command(*args, **options)
+
+    def pipeline(self):
+        """
+        Enters into pipeline mode of the client.
+        """
+        return Pipeline(self)
+
+    def transaction(self, func: Callable[["Pipeline"], None], *watches, **options):
+        """
+        Executes callable as transaction.
+        """
+        if not self.initialized:
+            self.initialize()
+
+        return self.command_executor.execute_transaction(func, *watches, *options)
+
+    def pubsub(self, **kwargs):
+        """
+        Return a Publish/Subscribe object. With this object, you can
+        subscribe to channels and listen for messages that get published to
+        them.
+        """
+        if not self.initialized:
+            self.initialize()
+
+        return PubSub(self, **kwargs)
+
+    def _check_db_health(self, database: SyncDatabase) -> bool:
+        """
+        Runs health checks on the given database until first failure.
+        """
+        # Health check will setup circuit state
+        is_healthy = self._health_check_policy.execute(self._health_checks, database)
+
+        if not is_healthy:
+            if database.circuit.state != CBState.OPEN:
+                database.circuit.state = CBState.OPEN
+            return is_healthy
+        elif is_healthy and database.circuit.state != CBState.CLOSED:
+            database.circuit.state = CBState.CLOSED
+
+        return is_healthy
+
+    def _check_databases_health(self, on_error: Callable[[Exception], None] = None):
+        """
+        Runs health checks as a recurring task.
+        Runs health checks against all databases.
+        """
+        with ThreadPoolExecutor(max_workers=len(self._databases)) as executor:
+            # Submit all health checks
+            futures = {
+                executor.submit(self._check_db_health, database)
+                for database, _ in self._databases
+            }
+
+            try:
+                for future in as_completed(
+                    futures, timeout=self._health_check_interval
+                ):
+                    try:
+                        future.result()
+                    except UnhealthyDatabaseException as e:
+                        unhealthy_db = e.database
+                        unhealthy_db.circuit.state = CBState.OPEN
+
+                        logger.exception(
+                            "Health check failed, due to exception",
+                            exc_info=e.original_exception,
+                        )
+
+                        if on_error:
+                            on_error(e.original_exception)
+            except TimeoutError:
+                raise TimeoutError(
+                    "Health check execution exceeds health_check_interval"
+                )
+
+    def _on_circuit_state_change_callback(
+        self, circuit: CircuitBreaker, old_state: CBState, new_state: CBState
+    ):
+        if new_state == CBState.HALF_OPEN:
+            self._check_db_health(circuit.database)
+            return
+
+        if old_state == CBState.CLOSED and new_state == CBState.OPEN:
+            self._bg_scheduler.run_once(
+                DEFAULT_GRACE_PERIOD, _half_open_circuit, circuit
+            )
+
+    def close(self):
+        self.command_executor.active_database.client.close()
+
+
+def _half_open_circuit(circuit: CircuitBreaker):
+    circuit.state = CBState.HALF_OPEN
+
+
+class Pipeline(RedisModuleCommands, CoreCommands):
+    """
+    Pipeline implementation for multiple logical Redis databases.
+    """
+
+    def __init__(self, client: MultiDBClient):
+        self._command_stack = []
+        self._client = client
+
+    def __enter__(self) -> "Pipeline":
+        return self
+
+    def __exit__(self, exc_type, exc_value, traceback):
+        self.reset()
+
+    def __del__(self):
+        try:
+            self.reset()
+        except Exception:
+            pass
+
+    def __len__(self) -> int:
+        return len(self._command_stack)
+
+    def __bool__(self) -> bool:
+        """Pipeline instances should always evaluate to True"""
+        return True
+
+    def reset(self) -> None:
+        self._command_stack = []
+
+    def close(self) -> None:
+        """Close the pipeline"""
+        self.reset()
+
+    def pipeline_execute_command(self, *args, **options) -> "Pipeline":
+        """
+        Stage a command to be executed when execute() is next called
+
+        Returns the current Pipeline object back so commands can be
+        chained together, such as:
+
+        pipe = pipe.set('foo', 'bar').incr('baz').decr('bang')
+
+        At some other point, you can then run: pipe.execute(),
+        which will execute all commands queued in the pipe.
+        """
+        self._command_stack.append((args, options))
+        return self
+
+    def execute_command(self, *args, **kwargs):
+        """Adds a command to the stack"""
+        return self.pipeline_execute_command(*args, **kwargs)
+
+    def execute(self) -> List[Any]:
+        """Execute all the commands in the current pipeline"""
+        if not self._client.initialized:
+            self._client.initialize()
+
+        try:
+            return self._client.command_executor.execute_pipeline(
+                tuple(self._command_stack)
+            )
+        finally:
+            self.reset()
+
+
+class PubSub:
+    """
+    PubSub object for multi database client.
+    """
+
+    def __init__(self, client: MultiDBClient, **kwargs):
+        """Initialize the PubSub object for a multi-database client.
+
+        Args:
+            client: MultiDBClient instance to use for pub/sub operations
+            **kwargs: Additional keyword arguments to pass to the underlying pubsub implementation
+        """
+
+        self._client = client
+        self._client.command_executor.pubsub(**kwargs)
+
+    def __enter__(self) -> "PubSub":
+        return self
+
+    def __del__(self) -> None:
+        try:
+            # if this object went out of scope prior to shutting down
+            # subscriptions, close the connection manually before
+            # returning it to the connection pool
+            self.reset()
+        except Exception:
+            pass
+
+    def reset(self) -> None:
+        return self._client.command_executor.execute_pubsub_method("reset")
+
+    def close(self) -> None:
+        self.reset()
+
+    @property
+    def subscribed(self) -> bool:
+        return self._client.command_executor.active_pubsub.subscribed
+
+    def execute_command(self, *args):
+        return self._client.command_executor.execute_pubsub_method(
+            "execute_command", *args
+        )
+
+    def psubscribe(self, *args, **kwargs):
+        """
+        Subscribe to channel patterns. Patterns supplied as keyword arguments
+        expect a pattern name as the key and a callable as the value. A
+        pattern's callable will be invoked automatically when a message is
+        received on that pattern rather than producing a message via
+        ``listen()``.
+        """
+        return self._client.command_executor.execute_pubsub_method(
+            "psubscribe", *args, **kwargs
+        )
+
+    def punsubscribe(self, *args):
+        """
+        Unsubscribe from the supplied patterns. If empty, unsubscribe from
+        all patterns.
+        """
+        return self._client.command_executor.execute_pubsub_method(
+            "punsubscribe", *args
+        )
+
+    def subscribe(self, *args, **kwargs):
+        """
+        Subscribe to channels. Channels supplied as keyword arguments expect
+        a channel name as the key and a callable as the value. A channel's
+        callable will be invoked automatically when a message is received on
+        that channel rather than producing a message via ``listen()`` or
+        ``get_message()``.
+        """
+        return self._client.command_executor.execute_pubsub_method(
+            "subscribe", *args, **kwargs
+        )
+
+    def unsubscribe(self, *args):
+        """
+        Unsubscribe from the supplied channels. If empty, unsubscribe from
+        all channels
+        """
+        return self._client.command_executor.execute_pubsub_method("unsubscribe", *args)
+
+    def ssubscribe(self, *args, **kwargs):
+        """
+        Subscribes the client to the specified shard channels.
+        Channels supplied as keyword arguments expect a channel name as the key
+        and a callable as the value. A channel's callable will be invoked automatically
+        when a message is received on that channel rather than producing a message via
+        ``listen()`` or ``get_sharded_message()``.
+        """
+        return self._client.command_executor.execute_pubsub_method(
+            "ssubscribe", *args, **kwargs
+        )
+
+    def sunsubscribe(self, *args):
+        """
+        Unsubscribe from the supplied shard_channels. If empty, unsubscribe from
+        all shard_channels
+        """
+        return self._client.command_executor.execute_pubsub_method(
+            "sunsubscribe", *args
+        )
+
+    def get_message(
+        self, ignore_subscribe_messages: bool = False, timeout: float = 0.0
+    ):
+        """
+        Get the next message if one is available, otherwise None.
+
+        If timeout is specified, the system will wait for `timeout` seconds
+        before returning. Timeout should be specified as a floating point
+        number, or None, to wait indefinitely.
+        """
+        return self._client.command_executor.execute_pubsub_method(
+            "get_message",
+            ignore_subscribe_messages=ignore_subscribe_messages,
+            timeout=timeout,
+        )
+
+    def get_sharded_message(
+        self, ignore_subscribe_messages: bool = False, timeout: float = 0.0
+    ):
+        """
+        Get the next message if one is available in a sharded channel, otherwise None.
+
+        If timeout is specified, the system will wait for `timeout` seconds
+        before returning. Timeout should be specified as a floating point
+        number, or None, to wait indefinitely.
+        """
+        return self._client.command_executor.execute_pubsub_method(
+            "get_sharded_message",
+            ignore_subscribe_messages=ignore_subscribe_messages,
+            timeout=timeout,
+        )
+
+    def run_in_thread(
+        self,
+        sleep_time: float = 0.0,
+        daemon: bool = False,
+        exception_handler: Optional[Callable] = None,
+        sharded_pubsub: bool = False,
+    ) -> "PubSubWorkerThread":
+        return self._client.command_executor.execute_pubsub_run(
+            sleep_time,
+            daemon=daemon,
+            exception_handler=exception_handler,
+            pubsub=self,
+            sharded_pubsub=sharded_pubsub,
+        )
diff --git a/redis/multidb/command_executor.py b/redis/multidb/command_executor.py
new file mode 100644
index 0000000000..f8e6171bc8
--- /dev/null
+++ b/redis/multidb/command_executor.py
@@ -0,0 +1,350 @@
+from abc import ABC, abstractmethod
+from datetime import datetime, timedelta
+from typing import Any, Callable, List, Optional
+
+from redis.client import Pipeline, PubSub, PubSubWorkerThread
+from redis.event import EventDispatcherInterface, OnCommandsFailEvent
+from redis.multidb.circuit import State as CBState
+from redis.multidb.config import DEFAULT_AUTO_FALLBACK_INTERVAL
+from redis.multidb.database import Database, Databases, SyncDatabase
+from redis.multidb.event import (
+    ActiveDatabaseChanged,
+    CloseConnectionOnActiveDatabaseChanged,
+    RegisterCommandFailure,
+    ResubscribeOnActiveDatabaseChanged,
+)
+from redis.multidb.failover import (
+    DEFAULT_FAILOVER_ATTEMPTS,
+    DEFAULT_FAILOVER_DELAY,
+    DefaultFailoverStrategyExecutor,
+    FailoverStrategy,
+    FailoverStrategyExecutor,
+)
+from redis.multidb.failure_detector import FailureDetector
+from redis.retry import Retry
+
+
+class CommandExecutor(ABC):
+    @property
+    @abstractmethod
+    def auto_fallback_interval(self) -> float:
+        """Returns auto-fallback interval."""
+        pass
+
+    @auto_fallback_interval.setter
+    @abstractmethod
+    def auto_fallback_interval(self, auto_fallback_interval: float) -> None:
+        """Sets auto-fallback interval."""
+        pass
+
+
+class BaseCommandExecutor(CommandExecutor):
+    def __init__(
+        self,
+        auto_fallback_interval: float = DEFAULT_AUTO_FALLBACK_INTERVAL,
+    ):
+        self._auto_fallback_interval = auto_fallback_interval
+        self._next_fallback_attempt: datetime
+
+    @property
+    def auto_fallback_interval(self) -> float:
+        return self._auto_fallback_interval
+
+    @auto_fallback_interval.setter
+    def auto_fallback_interval(self, auto_fallback_interval: int) -> None:
+        self._auto_fallback_interval = auto_fallback_interval
+
+    def _schedule_next_fallback(self) -> None:
+        if self._auto_fallback_interval == DEFAULT_AUTO_FALLBACK_INTERVAL:
+            return
+
+        self._next_fallback_attempt = datetime.now() + timedelta(
+            seconds=self._auto_fallback_interval
+        )
+
+
+class SyncCommandExecutor(CommandExecutor):
+    @property
+    @abstractmethod
+    def databases(self) -> Databases:
+        """Returns a list of databases."""
+        pass
+
+    @property
+    @abstractmethod
+    def failure_detectors(self) -> List[FailureDetector]:
+        """Returns a list of failure detectors."""
+        pass
+
+    @abstractmethod
+    def add_failure_detector(self, failure_detector: FailureDetector) -> None:
+        """Adds a new failure detector to the list of failure detectors."""
+        pass
+
+    @property
+    @abstractmethod
+    def active_database(self) -> Optional[Database]:
+        """Returns currently active database."""
+        pass
+
+    @active_database.setter
+    @abstractmethod
+    def active_database(self, database: SyncDatabase) -> None:
+        """Sets the currently active database."""
+        pass
+
+    @property
+    @abstractmethod
+    def active_pubsub(self) -> Optional[PubSub]:
+        """Returns currently active pubsub."""
+        pass
+
+    @active_pubsub.setter
+    @abstractmethod
+    def active_pubsub(self, pubsub: PubSub) -> None:
+        """Sets currently active pubsub."""
+        pass
+
+    @property
+    @abstractmethod
+    def failover_strategy_executor(self) -> FailoverStrategyExecutor:
+        """Returns failover strategy executor."""
+        pass
+
+    @property
+    @abstractmethod
+    def command_retry(self) -> Retry:
+        """Returns command retry object."""
+        pass
+
+    @abstractmethod
+    def pubsub(self, **kwargs):
+        """Initializes a PubSub object on a currently active database"""
+        pass
+
+    @abstractmethod
+    def execute_command(self, *args, **options):
+        """Executes a command and returns the result."""
+        pass
+
+    @abstractmethod
+    def execute_pipeline(self, command_stack: tuple):
+        """Executes a stack of commands in pipeline."""
+        pass
+
+    @abstractmethod
+    def execute_transaction(
+        self, transaction: Callable[[Pipeline], None], *watches, **options
+    ):
+        """Executes a transaction block wrapped in callback."""
+        pass
+
+    @abstractmethod
+    def execute_pubsub_method(self, method_name: str, *args, **kwargs):
+        """Executes a given method on active pub/sub."""
+        pass
+
+    @abstractmethod
+    def execute_pubsub_run(self, sleep_time: float, **kwargs) -> Any:
+        """Executes pub/sub run in a thread."""
+        pass
+
+
+class DefaultCommandExecutor(SyncCommandExecutor, BaseCommandExecutor):
+    def __init__(
+        self,
+        failure_detectors: List[FailureDetector],
+        databases: Databases,
+        command_retry: Retry,
+        failover_strategy: FailoverStrategy,
+        event_dispatcher: EventDispatcherInterface,
+        failover_attempts: int = DEFAULT_FAILOVER_ATTEMPTS,
+        failover_delay: float = DEFAULT_FAILOVER_DELAY,
+        auto_fallback_interval: float = DEFAULT_AUTO_FALLBACK_INTERVAL,
+    ):
+        """
+        Initialize the DefaultCommandExecutor instance.
+
+        Args:
+            failure_detectors: List of failure detector instances to monitor database health
+            databases: Collection of available databases to execute commands on
+            command_retry: Retry policy for failed command execution
+            failover_strategy: Strategy for handling database failover
+            event_dispatcher: Interface for dispatching events
+            failover_attempts: Number of failover attempts
+            failover_delay: Delay between failover attempts
+            auto_fallback_interval: Time interval in seconds between attempts to fall back to a primary database
+        """
+        super().__init__(auto_fallback_interval)
+
+        for fd in failure_detectors:
+            fd.set_command_executor(command_executor=self)
+
+        self._databases = databases
+        self._failure_detectors = failure_detectors
+        self._command_retry = command_retry
+        self._failover_strategy_executor = DefaultFailoverStrategyExecutor(
+            failover_strategy, failover_attempts, failover_delay
+        )
+        self._event_dispatcher = event_dispatcher
+        self._active_database: Optional[Database] = None
+        self._active_pubsub: Optional[PubSub] = None
+        self._active_pubsub_kwargs = {}
+        self._setup_event_dispatcher()
+        self._schedule_next_fallback()
+
+    @property
+    def databases(self) -> Databases:
+        return self._databases
+
+    @property
+    def failure_detectors(self) -> List[FailureDetector]:
+        return self._failure_detectors
+
+    def add_failure_detector(self, failure_detector: FailureDetector) -> None:
+        self._failure_detectors.append(failure_detector)
+
+    @property
+    def command_retry(self) -> Retry:
+        return self._command_retry
+
+    @property
+    def active_database(self) -> Optional[SyncDatabase]:
+        return self._active_database
+
+    @active_database.setter
+    def active_database(self, database: SyncDatabase) -> None:
+        old_active = self._active_database
+        self._active_database = database
+
+        if old_active is not None and old_active is not database:
+            self._event_dispatcher.dispatch(
+                ActiveDatabaseChanged(
+                    old_active,
+                    self._active_database,
+                    self,
+                    **self._active_pubsub_kwargs,
+                )
+            )
+
+    @property
+    def active_pubsub(self) -> Optional[PubSub]:
+        return self._active_pubsub
+
+    @active_pubsub.setter
+    def active_pubsub(self, pubsub: PubSub) -> None:
+        self._active_pubsub = pubsub
+
+    @property
+    def failover_strategy_executor(self) -> FailoverStrategyExecutor:
+        return self._failover_strategy_executor
+
+    def execute_command(self, *args, **options):
+        def callback():
+            response = self._active_database.client.execute_command(*args, **options)
+            self._register_command_execution(args)
+            return response
+
+        return self._execute_with_failure_detection(callback, args)
+
+    def execute_pipeline(self, command_stack: tuple):
+        def callback():
+            with self._active_database.client.pipeline() as pipe:
+                for command, options in command_stack:
+                    pipe.execute_command(*command, **options)
+
+                response = pipe.execute()
+                self._register_command_execution(command_stack)
+                return response
+
+        return self._execute_with_failure_detection(callback, command_stack)
+
+    def execute_transaction(
+        self, transaction: Callable[[Pipeline], None], *watches, **options
+    ):
+        def callback():
+            response = self._active_database.client.transaction(
+                transaction, *watches, **options
+            )
+            self._register_command_execution(())
+            return response
+
+        return self._execute_with_failure_detection(callback)
+
+    def pubsub(self, **kwargs):
+        def callback():
+            if self._active_pubsub is None:
+                self._active_pubsub = self._active_database.client.pubsub(**kwargs)
+                self._active_pubsub_kwargs = kwargs
+            return None
+
+        return self._execute_with_failure_detection(callback)
+
+    def execute_pubsub_method(self, method_name: str, *args, **kwargs):
+        def callback():
+            method = getattr(self.active_pubsub, method_name)
+            response = method(*args, **kwargs)
+            self._register_command_execution(args)
+            return response
+
+        return self._execute_with_failure_detection(callback, *args)
+
+    def execute_pubsub_run(self, sleep_time, **kwargs) -> "PubSubWorkerThread":
+        def callback():
+            return self._active_pubsub.run_in_thread(sleep_time, **kwargs)
+
+        return self._execute_with_failure_detection(callback)
+
+    def _execute_with_failure_detection(self, callback: Callable, cmds: tuple = ()):
+        """
+        Execute a commands execution callback with failure detection.
+        """
+
+        def wrapper():
+            # On each retry we need to check active database as it might change.
+            self._check_active_database()
+            return callback()
+
+        return self._command_retry.call_with_retry(
+            lambda: wrapper(),
+            lambda error: self._on_command_fail(error, *cmds),
+        )
+
+    def _on_command_fail(self, error, *args):
+        self._event_dispatcher.dispatch(OnCommandsFailEvent(args, error))
+
+    def _check_active_database(self):
+        """
+        Checks if active a database needs to be updated.
+        """
+        if (
+            self._active_database is None
+            or self._active_database.circuit.state != CBState.CLOSED
+            or (
+                self._auto_fallback_interval != DEFAULT_AUTO_FALLBACK_INTERVAL
+                and self._next_fallback_attempt <= datetime.now()
+            )
+        ):
+            self.active_database = self._failover_strategy_executor.execute()
+            self._schedule_next_fallback()
+
+    def _register_command_execution(self, cmd: tuple):
+        for detector in self._failure_detectors:
+            detector.register_command_execution(cmd)
+
+    def _setup_event_dispatcher(self):
+        """
+        Registers necessary listeners.
+        """
+        failure_listener = RegisterCommandFailure(self._failure_detectors)
+        resubscribe_listener = ResubscribeOnActiveDatabaseChanged()
+        close_connection_listener = CloseConnectionOnActiveDatabaseChanged()
+        self._event_dispatcher.register_listeners(
+            {
+                OnCommandsFailEvent: [failure_listener],
+                ActiveDatabaseChanged: [
+                    close_connection_listener,
+                    resubscribe_listener,
+                ],
+            }
+        )
diff --git a/redis/multidb/config.py b/redis/multidb/config.py
new file mode 100644
index 0000000000..8ce960c2dc
--- /dev/null
+++ b/redis/multidb/config.py
@@ -0,0 +1,207 @@
+from dataclasses import dataclass, field
+from typing import List, Type, Union
+
+import pybreaker
+from typing_extensions import Optional
+
+from redis import ConnectionPool, Redis, RedisCluster
+from redis.backoff import ExponentialWithJitterBackoff, NoBackoff
+from redis.data_structure import WeightedList
+from redis.event import EventDispatcher, EventDispatcherInterface
+from redis.multidb.circuit import (
+    DEFAULT_GRACE_PERIOD,
+    CircuitBreaker,
+    PBCircuitBreakerAdapter,
+)
+from redis.multidb.database import Database, Databases
+from redis.multidb.failover import (
+    DEFAULT_FAILOVER_ATTEMPTS,
+    DEFAULT_FAILOVER_DELAY,
+    FailoverStrategy,
+    WeightBasedFailoverStrategy,
+)
+from redis.multidb.failure_detector import (
+    DEFAULT_FAILURE_RATE_THRESHOLD,
+    DEFAULT_FAILURES_DETECTION_WINDOW,
+    DEFAULT_MIN_NUM_FAILURES,
+    CommandFailureDetector,
+    FailureDetector,
+)
+from redis.multidb.healthcheck import (
+    DEFAULT_HEALTH_CHECK_DELAY,
+    DEFAULT_HEALTH_CHECK_INTERVAL,
+    DEFAULT_HEALTH_CHECK_POLICY,
+    DEFAULT_HEALTH_CHECK_PROBES,
+    EchoHealthCheck,
+    HealthCheck,
+    HealthCheckPolicies,
+)
+from redis.retry import Retry
+
+DEFAULT_AUTO_FALLBACK_INTERVAL = 120
+
+
+def default_event_dispatcher() -> EventDispatcherInterface:
+    return EventDispatcher()
+
+
+@dataclass
+class DatabaseConfig:
+    """
+    Dataclass representing the configuration for a database connection.
+
+    This class is used to store configuration settings for a database connection,
+    including client options, connection sourcing details, circuit breaker settings,
+    and cluster-specific properties. It provides a structure for defining these
+    attributes and allows for the creation of customized configurations for various
+    database setups.
+
+    Attributes:
+        weight (float): Weight of the database to define the active one.
+        client_kwargs (dict): Additional parameters for the database client connection.
+        from_url (Optional[str]): Redis URL way of connecting to the database.
+        from_pool (Optional[ConnectionPool]): A pre-configured connection pool to use.
+        circuit (Optional[CircuitBreaker]): Custom circuit breaker implementation.
+        grace_period (float): Grace period after which we need to check if the circuit could be closed again.
+        health_check_url (Optional[str]): URL for health checks. Cluster FQDN is typically used
+            on public Redis Enterprise endpoints.
+
+    Methods:
+        default_circuit_breaker:
+            Generates and returns a default CircuitBreaker instance adapted for use.
+    """
+
+    weight: float = 1.0
+    client_kwargs: dict = field(default_factory=dict)
+    from_url: Optional[str] = None
+    from_pool: Optional[ConnectionPool] = None
+    circuit: Optional[CircuitBreaker] = None
+    grace_period: float = DEFAULT_GRACE_PERIOD
+    health_check_url: Optional[str] = None
+
+    def default_circuit_breaker(self) -> CircuitBreaker:
+        circuit_breaker = pybreaker.CircuitBreaker(reset_timeout=self.grace_period)
+        return PBCircuitBreakerAdapter(circuit_breaker)
+
+
+@dataclass
+class MultiDbConfig:
+    """
+    Configuration class for managing multiple database connections in a resilient and fail-safe manner.
+
+    Attributes:
+        databases_config: A list of database configurations.
+        client_class: The client class used to manage database connections.
+        command_retry: Retry strategy for executing database commands.
+        failure_detectors: Optional list of additional failure detectors for monitoring database failures.
+        min_num_failures: Minimal count of failures required for failover
+        failure_rate_threshold: Percentage of failures required for failover
+        failures_detection_window: Time interval for tracking database failures.
+        health_checks: Optional list of additional health checks performed on databases.
+        health_check_interval: Time interval for executing health checks.
+        health_check_probes: Number of attempts to evaluate the health of a database.
+        health_check_probes_delay: Delay between health check attempts.
+        health_check_policy: Policy for determining database health based on health checks.
+        failover_strategy: Optional strategy for handling database failover scenarios.
+        failover_attempts: Number of retries allowed for failover operations.
+        failover_delay: Delay between failover attempts.
+        auto_fallback_interval: Time interval to trigger automatic fallback.
+        event_dispatcher: Interface for dispatching events related to database operations.
+
+    Methods:
+        databases:
+            Retrieves a collection of database clients managed by weighted configurations.
+            Initializes database clients based on the provided configuration and removes
+            redundant retry objects for lower-level clients to rely on global retry logic.
+
+        default_failure_detectors:
+            Returns the default list of failure detectors used to monitor database failures.
+
+        default_health_checks:
+            Returns the default list of health checks used to monitor database health
+            with specific retry and backoff strategies.
+
+        default_failover_strategy:
+            Provides the default failover strategy used for handling failover scenarios
+            with defined retry and backoff configurations.
+    """
+
+    databases_config: List[DatabaseConfig]
+    client_class: Type[Union[Redis, RedisCluster]] = Redis
+    command_retry: Retry = Retry(
+        backoff=ExponentialWithJitterBackoff(base=1, cap=10), retries=3
+    )
+    failure_detectors: Optional[List[FailureDetector]] = None
+    min_num_failures: int = DEFAULT_MIN_NUM_FAILURES
+    failure_rate_threshold: float = DEFAULT_FAILURE_RATE_THRESHOLD
+    failures_detection_window: float = DEFAULT_FAILURES_DETECTION_WINDOW
+    health_checks: Optional[List[HealthCheck]] = None
+    health_check_interval: float = DEFAULT_HEALTH_CHECK_INTERVAL
+    health_check_probes: int = DEFAULT_HEALTH_CHECK_PROBES
+    health_check_probes_delay: float = DEFAULT_HEALTH_CHECK_DELAY
+    health_check_policy: HealthCheckPolicies = DEFAULT_HEALTH_CHECK_POLICY
+    failover_strategy: Optional[FailoverStrategy] = None
+    failover_attempts: int = DEFAULT_FAILOVER_ATTEMPTS
+    failover_delay: float = DEFAULT_FAILOVER_DELAY
+    auto_fallback_interval: float = DEFAULT_AUTO_FALLBACK_INTERVAL
+    event_dispatcher: EventDispatcherInterface = field(
+        default_factory=default_event_dispatcher
+    )
+
+    def databases(self) -> Databases:
+        databases = WeightedList()
+
+        for database_config in self.databases_config:
+            # The retry object is not used in the lower level clients, so we can safely remove it.
+            # We rely on command_retry in terms of global retries.
+            database_config.client_kwargs.update(
+                {"retry": Retry(retries=0, backoff=NoBackoff())}
+            )
+
+            if database_config.from_url:
+                client = self.client_class.from_url(
+                    database_config.from_url, **database_config.client_kwargs
+                )
+            elif database_config.from_pool:
+                database_config.from_pool.set_retry(
+                    Retry(retries=0, backoff=NoBackoff())
+                )
+                client = self.client_class.from_pool(
+                    connection_pool=database_config.from_pool
+                )
+            else:
+                client = self.client_class(**database_config.client_kwargs)
+
+            circuit = (
+                database_config.default_circuit_breaker()
+                if database_config.circuit is None
+                else database_config.circuit
+            )
+            databases.add(
+                Database(
+                    client=client,
+                    circuit=circuit,
+                    weight=database_config.weight,
+                    health_check_url=database_config.health_check_url,
+                ),
+                database_config.weight,
+            )
+
+        return databases
+
+    def default_failure_detectors(self) -> List[FailureDetector]:
+        return [
+            CommandFailureDetector(
+                min_num_failures=self.min_num_failures,
+                failure_rate_threshold=self.failure_rate_threshold,
+                failure_detection_window=self.failures_detection_window,
+            ),
+        ]
+
+    def default_health_checks(self) -> List[HealthCheck]:
+        return [
+            EchoHealthCheck(),
+        ]
+
+    def default_failover_strategy(self) -> FailoverStrategy:
+        return WeightBasedFailoverStrategy()
diff --git a/redis/multidb/database.py b/redis/multidb/database.py
new file mode 100644
index 0000000000..d46de99e2d
--- /dev/null
+++ b/redis/multidb/database.py
@@ -0,0 +1,130 @@
+from abc import ABC, abstractmethod
+from typing import Optional, Union
+
+import redis
+from redis import RedisCluster
+from redis.data_structure import WeightedList
+from redis.multidb.circuit import CircuitBreaker
+from redis.typing import Number
+
+
+class AbstractDatabase(ABC):
+    @property
+    @abstractmethod
+    def weight(self) -> float:
+        """The weight of this database in compare to others. Used to determine the database failover to."""
+        pass
+
+    @weight.setter
+    @abstractmethod
+    def weight(self, weight: float):
+        """Set the weight of this database in compare to others."""
+        pass
+
+    @property
+    @abstractmethod
+    def health_check_url(self) -> Optional[str]:
+        """Health check URL associated with the current database."""
+        pass
+
+    @health_check_url.setter
+    @abstractmethod
+    def health_check_url(self, health_check_url: Optional[str]):
+        """Set the health check URL associated with the current database."""
+        pass
+
+
+class BaseDatabase(AbstractDatabase):
+    def __init__(
+        self,
+        weight: float,
+        health_check_url: Optional[str] = None,
+    ):
+        self._weight = weight
+        self._health_check_url = health_check_url
+
+    @property
+    def weight(self) -> float:
+        return self._weight
+
+    @weight.setter
+    def weight(self, weight: float):
+        self._weight = weight
+
+    @property
+    def health_check_url(self) -> Optional[str]:
+        return self._health_check_url
+
+    @health_check_url.setter
+    def health_check_url(self, health_check_url: Optional[str]):
+        self._health_check_url = health_check_url
+
+
+class SyncDatabase(AbstractDatabase):
+    """Database with an underlying synchronous redis client."""
+
+    @property
+    @abstractmethod
+    def client(self) -> Union[redis.Redis, RedisCluster]:
+        """The underlying redis client."""
+        pass
+
+    @client.setter
+    @abstractmethod
+    def client(self, client: Union[redis.Redis, RedisCluster]):
+        """Set the underlying redis client."""
+        pass
+
+    @property
+    @abstractmethod
+    def circuit(self) -> CircuitBreaker:
+        """Circuit breaker for the current database."""
+        pass
+
+    @circuit.setter
+    @abstractmethod
+    def circuit(self, circuit: CircuitBreaker):
+        """Set the circuit breaker for the current database."""
+        pass
+
+
+Databases = WeightedList[tuple[SyncDatabase, Number]]
+
+
+class Database(BaseDatabase, SyncDatabase):
+    def __init__(
+        self,
+        client: Union[redis.Redis, RedisCluster],
+        circuit: CircuitBreaker,
+        weight: float,
+        health_check_url: Optional[str] = None,
+    ):
+        """
+        Initialize a new Database instance.
+
+        Args:
+            client: Underlying Redis client instance for database operations
+            circuit: Circuit breaker for handling database failures
+            weight: Weight value used for database failover prioritization
+            health_check_url: Health check URL associated with the current database
+        """
+        self._client = client
+        self._cb = circuit
+        self._cb.database = self
+        super().__init__(weight, health_check_url)
+
+    @property
+    def client(self) -> Union[redis.Redis, RedisCluster]:
+        return self._client
+
+    @client.setter
+    def client(self, client: Union[redis.Redis, RedisCluster]):
+        self._client = client
+
+    @property
+    def circuit(self) -> CircuitBreaker:
+        return self._cb
+
+    @circuit.setter
+    def circuit(self, circuit: CircuitBreaker):
+        self._cb = circuit
diff --git a/redis/multidb/event.py b/redis/multidb/event.py
new file mode 100644
index 0000000000..0ffeb7f66e
--- /dev/null
+++ b/redis/multidb/event.py
@@ -0,0 +1,89 @@
+from typing import List
+
+from redis.client import Redis
+from redis.event import EventListenerInterface, OnCommandsFailEvent
+from redis.multidb.database import SyncDatabase
+from redis.multidb.failure_detector import FailureDetector
+
+
+class ActiveDatabaseChanged:
+    """
+    Event fired when an active database has been changed.
+    """
+
+    def __init__(
+        self,
+        old_database: SyncDatabase,
+        new_database: SyncDatabase,
+        command_executor,
+        **kwargs,
+    ):
+        self._old_database = old_database
+        self._new_database = new_database
+        self._command_executor = command_executor
+        self._kwargs = kwargs
+
+    @property
+    def old_database(self) -> SyncDatabase:
+        return self._old_database
+
+    @property
+    def new_database(self) -> SyncDatabase:
+        return self._new_database
+
+    @property
+    def command_executor(self):
+        return self._command_executor
+
+    @property
+    def kwargs(self):
+        return self._kwargs
+
+
+class ResubscribeOnActiveDatabaseChanged(EventListenerInterface):
+    """
+    Re-subscribe the currently active pub / sub to a new active database.
+    """
+
+    def listen(self, event: ActiveDatabaseChanged):
+        old_pubsub = event.command_executor.active_pubsub
+
+        if old_pubsub is not None:
+            # Re-assign old channels and patterns so they will be automatically subscribed on connection.
+            new_pubsub = event.new_database.client.pubsub(**event.kwargs)
+            new_pubsub.channels = old_pubsub.channels
+            new_pubsub.patterns = old_pubsub.patterns
+            new_pubsub.shard_channels = old_pubsub.shard_channels
+            new_pubsub.on_connect(None)
+            event.command_executor.active_pubsub = new_pubsub
+            old_pubsub.close()
+
+
+class CloseConnectionOnActiveDatabaseChanged(EventListenerInterface):
+    """
+    Close connection to the old active database.
+    """
+
+    def listen(self, event: ActiveDatabaseChanged):
+        event.old_database.client.close()
+
+        if isinstance(event.old_database.client, Redis):
+            event.old_database.client.connection_pool.update_active_connections_for_reconnect()
+            event.old_database.client.connection_pool.disconnect()
+        else:
+            for node in event.old_database.client.nodes_manager.nodes_cache.values():
+                node.redis_connection.connection_pool.update_active_connections_for_reconnect()
+                node.redis_connection.connection_pool.disconnect()
+
+
+class RegisterCommandFailure(EventListenerInterface):
+    """
+    Event listener that registers command failures and passing it to the failure detectors.
+    """
+
+    def __init__(self, failure_detectors: List[FailureDetector]):
+        self._failure_detectors = failure_detectors
+
+    def listen(self, event: OnCommandsFailEvent) -> None:
+        for failure_detector in self._failure_detectors:
+            failure_detector.register_failure(event.exception, event.commands)
diff --git a/redis/multidb/exception.py b/redis/multidb/exception.py
new file mode 100644
index 0000000000..8c08c4b540
--- /dev/null
+++ b/redis/multidb/exception.py
@@ -0,0 +1,17 @@
+class NoValidDatabaseException(Exception):
+    pass
+
+
+class UnhealthyDatabaseException(Exception):
+    """Exception raised when a database is unhealthy due to an underlying exception."""
+
+    def __init__(self, message, database, original_exception):
+        super().__init__(message)
+        self.database = database
+        self.original_exception = original_exception
+
+
+class TemporaryUnavailableException(Exception):
+    """Exception raised when all databases in setup are temporary unavailable."""
+
+    pass
diff --git a/redis/multidb/failover.py b/redis/multidb/failover.py
new file mode 100644
index 0000000000..c660eddbd3
--- /dev/null
+++ b/redis/multidb/failover.py
@@ -0,0 +1,125 @@
+import time
+from abc import ABC, abstractmethod
+
+from redis.data_structure import WeightedList
+from redis.multidb.circuit import State as CBState
+from redis.multidb.database import Databases, SyncDatabase
+from redis.multidb.exception import (
+    NoValidDatabaseException,
+    TemporaryUnavailableException,
+)
+
+DEFAULT_FAILOVER_ATTEMPTS = 10
+DEFAULT_FAILOVER_DELAY = 12
+
+
+class FailoverStrategy(ABC):
+    @abstractmethod
+    def database(self) -> SyncDatabase:
+        """Select the database according to the strategy."""
+        pass
+
+    @abstractmethod
+    def set_databases(self, databases: Databases) -> None:
+        """Set the database strategy operates on."""
+        pass
+
+
+class FailoverStrategyExecutor(ABC):
+    @property
+    @abstractmethod
+    def failover_attempts(self) -> int:
+        """The number of failover attempts."""
+        pass
+
+    @property
+    @abstractmethod
+    def failover_delay(self) -> float:
+        """The delay between failover attempts."""
+        pass
+
+    @property
+    @abstractmethod
+    def strategy(self) -> FailoverStrategy:
+        """The strategy to execute."""
+        pass
+
+    @abstractmethod
+    def execute(self) -> SyncDatabase:
+        """Execute the failover strategy."""
+        pass
+
+
+class WeightBasedFailoverStrategy(FailoverStrategy):
+    """
+    Failover strategy based on database weights.
+    """
+
+    def __init__(self) -> None:
+        self._databases = WeightedList()
+
+    def database(self) -> SyncDatabase:
+        for database, _ in self._databases:
+            if database.circuit.state == CBState.CLOSED:
+                return database
+
+        raise NoValidDatabaseException("No valid database available for communication")
+
+    def set_databases(self, databases: Databases) -> None:
+        self._databases = databases
+
+
+class DefaultFailoverStrategyExecutor(FailoverStrategyExecutor):
+    """
+    Executes given failover strategy.
+    """
+
+    def __init__(
+        self,
+        strategy: FailoverStrategy,
+        failover_attempts: int = DEFAULT_FAILOVER_ATTEMPTS,
+        failover_delay: float = DEFAULT_FAILOVER_DELAY,
+    ):
+        self._strategy = strategy
+        self._failover_attempts = failover_attempts
+        self._failover_delay = failover_delay
+        self._next_attempt_ts: int = 0
+        self._failover_counter: int = 0
+
+    @property
+    def failover_attempts(self) -> int:
+        return self._failover_attempts
+
+    @property
+    def failover_delay(self) -> float:
+        return self._failover_delay
+
+    @property
+    def strategy(self) -> FailoverStrategy:
+        return self._strategy
+
+    def execute(self) -> SyncDatabase:
+        try:
+            database = self._strategy.database()
+            self._reset()
+            return database
+        except NoValidDatabaseException as e:
+            if self._next_attempt_ts == 0:
+                self._next_attempt_ts = time.time() + self._failover_delay
+                self._failover_counter += 1
+            elif time.time() >= self._next_attempt_ts:
+                self._next_attempt_ts += self._failover_delay
+                self._failover_counter += 1
+
+            if self._failover_counter > self._failover_attempts:
+                self._reset()
+                raise e
+            else:
+                raise TemporaryUnavailableException(
+                    "No database connections currently available. "
+                    "This is a temporary condition - please retry the operation."
+                )
+
+    def _reset(self) -> None:
+        self._next_attempt_ts = 0
+        self._failover_counter = 0
diff --git a/redis/multidb/failure_detector.py b/redis/multidb/failure_detector.py
new file mode 100644
index 0000000000..f1be28788e
--- /dev/null
+++ b/redis/multidb/failure_detector.py
@@ -0,0 +1,104 @@
+import math
+import threading
+from abc import ABC, abstractmethod
+from datetime import datetime, timedelta
+from typing import List, Type
+
+from typing_extensions import Optional
+
+from redis.multidb.circuit import State as CBState
+
+DEFAULT_MIN_NUM_FAILURES = 1000
+DEFAULT_FAILURE_RATE_THRESHOLD = 0.1
+DEFAULT_FAILURES_DETECTION_WINDOW = 2
+
+
+class FailureDetector(ABC):
+    @abstractmethod
+    def register_failure(self, exception: Exception, cmd: tuple) -> None:
+        """Register a failure that occurred during command execution."""
+        pass
+
+    @abstractmethod
+    def register_command_execution(self, cmd: tuple) -> None:
+        """Register a command execution."""
+        pass
+
+    @abstractmethod
+    def set_command_executor(self, command_executor) -> None:
+        """Set the command executor for this failure."""
+        pass
+
+
+class CommandFailureDetector(FailureDetector):
+    """
+    Detects a failure based on a threshold of failed commands during a specific period of time.
+    """
+
+    def __init__(
+        self,
+        min_num_failures: int = DEFAULT_MIN_NUM_FAILURES,
+        failure_rate_threshold: float = DEFAULT_FAILURE_RATE_THRESHOLD,
+        failure_detection_window: float = DEFAULT_FAILURES_DETECTION_WINDOW,
+        error_types: Optional[List[Type[Exception]]] = None,
+    ) -> None:
+        """
+        Initialize a new CommandFailureDetector instance.
+
+        Args:
+            min_num_failures: Minimal count of failures required for failover
+            failure_rate_threshold: Percentage of failures required for failover
+            failure_detection_window: Time interval for executing health checks.
+            error_types: Optional list of exception types to trigger failover. If None, all exceptions are counted.
+
+        The detector tracks command failures within a sliding time window. When the number of failures
+        exceeds the threshold within the specified duration, it triggers failure detection.
+        """
+        self._command_executor = None
+        self._min_num_failures = min_num_failures
+        self._failure_rate_threshold = failure_rate_threshold
+        self._failure_detection_window = failure_detection_window
+        self._error_types = error_types
+        self._commands_executed: int = 0
+        self._start_time: datetime = datetime.now()
+        self._end_time: datetime = self._start_time + timedelta(
+            seconds=self._failure_detection_window
+        )
+        self._failures_count: int = 0
+        self._lock = threading.RLock()
+
+    def register_failure(self, exception: Exception, cmd: tuple) -> None:
+        with self._lock:
+            if self._error_types:
+                if type(exception) in self._error_types:
+                    self._failures_count += 1
+            else:
+                self._failures_count += 1
+
+            self._check_threshold()
+
+    def set_command_executor(self, command_executor) -> None:
+        self._command_executor = command_executor
+
+    def register_command_execution(self, cmd: tuple) -> None:
+        with self._lock:
+            if not self._start_time < datetime.now() < self._end_time:
+                self._reset()
+
+            self._commands_executed += 1
+
+    def _check_threshold(self):
+        if self._failures_count >= self._min_num_failures and self._failures_count >= (
+            math.ceil(self._commands_executed * self._failure_rate_threshold)
+        ):
+            self._command_executor.active_database.circuit.state = CBState.OPEN
+            self._reset()
+
+    def _reset(self) -> None:
+        with self._lock:
+            self._start_time = datetime.now()
+            self._end_time = self._start_time + timedelta(
+                seconds=self._failure_detection_window
+            )
+            self._failures_count = 0
+            self._commands_executed = 0
diff --git a/redis/multidb/healthcheck.py b/redis/multidb/healthcheck.py
new file mode 100644
index 0000000000..5deda82f24
--- /dev/null
+++ b/redis/multidb/healthcheck.py
@@ -0,0 +1,289 @@
+import logging
+from abc import ABC, abstractmethod
+from enum import Enum
+from time import sleep
+from typing import List, Optional, Tuple, Union
+
+from redis import Redis
+from redis.backoff import NoBackoff
+from redis.http.http_client import DEFAULT_TIMEOUT, HttpClient
+from redis.multidb.exception import UnhealthyDatabaseException
+from redis.retry import Retry
+
+DEFAULT_HEALTH_CHECK_PROBES = 3
+DEFAULT_HEALTH_CHECK_INTERVAL = 5
+DEFAULT_HEALTH_CHECK_DELAY = 0.5
+DEFAULT_LAG_AWARE_TOLERANCE = 5000
+
+logger = logging.getLogger(__name__)
+
+
+class HealthCheck(ABC):
+    @abstractmethod
+    def check_health(self, database) -> bool:
+        """Function to determine the health status."""
+        pass
+
+
+class HealthCheckPolicy(ABC):
+    """
+    Health checks execution policy.
+    """
+
+    @property
+    @abstractmethod
+    def health_check_probes(self) -> int:
+        """Number of probes to execute health checks."""
+        pass
+
+    @property
+    @abstractmethod
+    def health_check_delay(self) -> float:
+        """Delay between health check probes."""
+        pass
+
+    @abstractmethod
+    def execute(self, health_checks: List[HealthCheck], database) -> bool:
+        """Execute health checks and return database health status."""
+        pass
+
+
+class AbstractHealthCheckPolicy(HealthCheckPolicy):
+    def __init__(self, health_check_probes: int, health_check_delay: float):
+        if health_check_probes < 1:
+            raise ValueError("health_check_probes must be greater than 0")
+        self._health_check_probes = health_check_probes
+        self._health_check_delay = health_check_delay
+
+    @property
+    def health_check_probes(self) -> int:
+        return self._health_check_probes
+
+    @property
+    def health_check_delay(self) -> float:
+        return self._health_check_delay
+
+    @abstractmethod
+    def execute(self, health_checks: List[HealthCheck], database) -> bool:
+        pass
+
+
+class HealthyAllPolicy(AbstractHealthCheckPolicy):
+    """
+    Policy that returns True if all health check probes are successful.
+    """
+
+    def __init__(self, health_check_probes: int, health_check_delay: float):
+        super().__init__(health_check_probes, health_check_delay)
+
+    def execute(self, health_checks: List[HealthCheck], database) -> bool:
+        for health_check in health_checks:
+            for attempt in range(self.health_check_probes):
+                try:
+                    if not health_check.check_health(database):
+                        return False
+                except Exception as e:
+                    raise UnhealthyDatabaseException("Unhealthy database", database, e)
+
+                if attempt < self.health_check_probes - 1:
+                    sleep(self._health_check_delay)
+        return True
+
+
+class HealthyMajorityPolicy(AbstractHealthCheckPolicy):
+    """
+    Policy that returns True if a majority of health check probes are successful.
+    """
+
+    def __init__(self, health_check_probes: int, health_check_delay: float):
+        super().__init__(health_check_probes, health_check_delay)
+
+    def execute(self, health_checks: List[HealthCheck], database) -> bool:
+        for health_check in health_checks:
+            if self.health_check_probes % 2 == 0:
+                allowed_unsuccessful_probes = self.health_check_probes / 2
+            else:
+                allowed_unsuccessful_probes = (self.health_check_probes + 1) / 2
+
+            for attempt in range(self.health_check_probes):
+                try:
+                    if not health_check.check_health(database):
+                        allowed_unsuccessful_probes -= 1
+                        if allowed_unsuccessful_probes <= 0:
+                            return False
+                except Exception as e:
+                    allowed_unsuccessful_probes -= 1
+                    if allowed_unsuccessful_probes <= 0:
+                        raise UnhealthyDatabaseException(
+                            "Unhealthy database", database, e
+                        )
+
+                if attempt < self.health_check_probes - 1:
+                    sleep(self._health_check_delay)
+        return True
+
+
+class HealthyAnyPolicy(AbstractHealthCheckPolicy):
+    """
+    Policy that returns True if at least one health check probe is successful.
+    """
+
+    def __init__(self, health_check_probes: int, health_check_delay: float):
+        super().__init__(health_check_probes, health_check_delay)
+
+    def execute(self, health_checks: List[HealthCheck], database) -> bool:
+        is_healthy = False
+
+        for health_check in health_checks:
+            exception = None
+
+            for attempt in range(self.health_check_probes):
+                try:
+                    if health_check.check_health(database):
+                        is_healthy = True
+                        break
+                    else:
+                        is_healthy = False
+                except Exception as e:
+                    exception = UnhealthyDatabaseException(
+                        "Unhealthy database", database, e
+                    )
+
+                if attempt < self.health_check_probes - 1:
+                    sleep(self._health_check_delay)
+
+            if not is_healthy and not exception:
+                return is_healthy
+            elif not is_healthy and exception:
+                raise exception
+
+        return is_healthy
+
+
+class HealthCheckPolicies(Enum):
+    HEALTHY_ALL = HealthyAllPolicy
+    HEALTHY_MAJORITY = HealthyMajorityPolicy
+    HEALTHY_ANY = HealthyAnyPolicy
+
+
+DEFAULT_HEALTH_CHECK_POLICY: HealthCheckPolicies = HealthCheckPolicies.HEALTHY_ALL
+
+
+class EchoHealthCheck(HealthCheck):
+    """
+    Health check based on ECHO command.
+    """
+
+    def check_health(self, database) -> bool:
+        expected_message = ["healthcheck", b"healthcheck"]
+
+        if isinstance(database.client, Redis):
+            actual_message = database.client.execute_command("ECHO", "healthcheck")
+            return actual_message in expected_message
+        else:
+            # For a cluster checks if all nodes are healthy.
+            all_nodes = database.client.get_nodes()
+            for node in all_nodes:
+                actual_message = node.redis_connection.execute_command(
+                    "ECHO", "healthcheck"
+                )
+
+                if actual_message not in expected_message:
+                    return False
+
+            return True
+
+
+class LagAwareHealthCheck(HealthCheck):
+    """
+    Health check available for Redis Enterprise deployments.
+    Verify via REST API that the database is healthy based on different lags.
+    """
+
+    def __init__(
+        self,
+        rest_api_port: int = 9443,
+        lag_aware_tolerance: int = DEFAULT_LAG_AWARE_TOLERANCE,
+        timeout: float = DEFAULT_TIMEOUT,
+        auth_basic: Optional[Tuple[str, str]] = None,
+        verify_tls: bool = True,
+        # TLS verification (server) options
+        ca_file: Optional[str] = None,
+        ca_path: Optional[str] = None,
+        ca_data: Optional[Union[str, bytes]] = None,
+        # Mutual TLS (client cert) options
+        client_cert_file: Optional[str] = None,
+        client_key_file: Optional[str] = None,
+        client_key_password: Optional[str] = None,
+    ):
+        """
+        Initialize LagAwareHealthCheck with the specified parameters.
+
+        Args:
+            rest_api_port: Port number for Redis Enterprise REST API (default: 9443)
+            lag_aware_tolerance: Tolerance in lag between databases in MS (default: 100)
+            timeout: Request timeout in seconds (default: DEFAULT_TIMEOUT)
+            auth_basic: Tuple of (username, password) for basic authentication
+            verify_tls: Whether to verify TLS certificates (default: True)
+            ca_file: Path to CA certificate file for TLS verification
+            ca_path: Path to CA certificates directory for TLS verification
+            ca_data: CA certificate data as string or bytes
+            client_cert_file: Path to client certificate file for mutual TLS
+            client_key_file: Path to client private key file for mutual TLS
+            client_key_password: Password for encrypted client private key
+        """
+        self._http_client = HttpClient(
+            timeout=timeout,
+            auth_basic=auth_basic,
+            retry=Retry(NoBackoff(), retries=0),
+            verify_tls=verify_tls,
+            ca_file=ca_file,
+            ca_path=ca_path,
+            ca_data=ca_data,
+            client_cert_file=client_cert_file,
+            client_key_file=client_key_file,
+            client_key_password=client_key_password,
+        )
+        self._rest_api_port = rest_api_port
+        self._lag_aware_tolerance = lag_aware_tolerance
+
+    def check_health(self, database) -> bool:
+        if database.health_check_url is None:
+            raise ValueError(
+                "Database health check url is not set. Please check DatabaseConfig for the current database."
+            )
+
+        if isinstance(database.client, Redis):
+            db_host = database.client.get_connection_kwargs()["host"]
+        else:
+            db_host = database.client.startup_nodes[0].host
+
+        base_url = f"{database.health_check_url}:{self._rest_api_port}"
+        self._http_client.base_url = base_url
+
+        # Find bdb matching to the current database host
+        matching_bdb = None
+        for bdb in self._http_client.get("/v1/bdbs"):
+            for endpoint in bdb["endpoints"]:
+                if endpoint["dns_name"] == db_host:
+                    matching_bdb = bdb
+                    break
+
+                # In case if the host was set as public IP
+                for addr in endpoint["addr"]:
+                    if addr == db_host:
+                        matching_bdb = bdb
+                        break
+
+        if matching_bdb is None:
+            logger.warning("LagAwareHealthCheck failed: Couldn't find a matching bdb")
+            raise ValueError("Could not find a matching bdb")
+
+        url = (
+            f"/v1/bdbs/{matching_bdb['uid']}/availability"
+            f"?extend_check=lag&availability_lag_tolerance_ms={self._lag_aware_tolerance}"
+        )
+        self._http_client.get(url, expect_json=False)
+
+        # Status checked in an http client, otherwise HttpError will be raised
+        return True
diff --git a/redis/retry.py b/redis/retry.py
index 75778635e8..225e431eb2 100644
--- a/redis/retry.py
+++ b/redis/retry.py
@@ -1,7 +1,17 @@
 import abc
 import socket
 from time import sleep
-from typing import TYPE_CHECKING, Any, Callable, Generic, Iterable, Tuple, Type, TypeVar
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Generic,
+    Iterable,
+    Optional,
+    Tuple,
+    Type,
+    TypeVar,
+)
 
 from redis.exceptions import ConnectionError, TimeoutError
 
@@ -91,6 +101,7 @@ def call_with_retry(
         self,
         do: Callable[[], T],
         fail: Callable[[Exception], Any],
+        is_retryable: Optional[Callable[[Exception], bool]] = None,
     ) -> T:
         """
         Execute an operation that might fail and returns its result, or
@@ -104,6 +115,8 @@ def call_with_retry(
             try:
                 return do()
             except self._supported_errors as error:
+                if is_retryable and not is_retryable(error):
+                    raise
                 failures += 1
                 fail(error)
                 if self._retries >= 0 and failures > self._retries:
diff --git a/redis/utils.py b/redis/utils.py
index 79c23c8bda..5ae8fb25fc 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -312,3 +312,17 @@ def truncate_text(txt, max_length=100):
     return textwrap.shorten(
         text=txt, width=max_length, placeholder="...", break_long_words=True
     )
+
+
+def dummy_fail():
+    """
+    Fake function for a Retry object if you don't need to handle each failure.
+    """
+    pass
+
+
+async def dummy_fail_async():
+    """
+    Async fake function for a Retry object if you don't need to handle each failure.
+    """
+    pass
diff --git a/tasks.py b/tasks.py
index 20f9f245aa..d63bd8c92d 100644
--- a/tasks.py
+++ b/tasks.py
@@ -58,11 +58,11 @@ def standalone_tests(
 
     if uvloop:
         run(
-            f"pytest {profile_arg} --protocol={protocol} {redis_mod_url}  --ignore=tests/test_scenario --cov=./ --cov-report=xml:coverage_resp{protocol}_uvloop.xml -m 'not onlycluster{extra_markers}' --uvloop --junit-xml=standalone-resp{protocol}-uvloop-results.xml"
+            f"pytest {profile_arg} --protocol={protocol} {redis_mod_url}  --ignore=tests/test_scenario --ignore=tests/test_asyncio/test_scenario --cov=./ --cov-report=xml:coverage_resp{protocol}_uvloop.xml -m 'not onlycluster{extra_markers}' --uvloop --junit-xml=standalone-resp{protocol}-uvloop-results.xml"
         )
     else:
         run(
-            f"pytest {profile_arg} --protocol={protocol} {redis_mod_url}  --ignore=tests/test_scenario --cov=./ --cov-report=xml:coverage_resp{protocol}.xml -m 'not onlycluster{extra_markers}' --junit-xml=standalone-resp{protocol}-results.xml"
+            f"pytest {profile_arg} --protocol={protocol} {redis_mod_url}  --ignore=tests/test_scenario --ignore=tests/test_asyncio/test_scenario --cov=./ --cov-report=xml:coverage_resp{protocol}.xml -m 'not onlycluster{extra_markers}' --junit-xml=standalone-resp{protocol}-results.xml"
         )
 
 
@@ -74,11 +74,11 @@ def cluster_tests(c, uvloop=False, protocol=2, profile=False):
     cluster_tls_url = "rediss://localhost:27379/0"
     if uvloop:
         run(
-            f"pytest {profile_arg} --protocol={protocol}  --ignore=tests/test_scenario  --cov=./ --cov-report=xml:coverage_cluster_resp{protocol}_uvloop.xml -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --redis-ssl-url={cluster_tls_url} --junit-xml=cluster-resp{protocol}-uvloop-results.xml --uvloop"
+            f"pytest {profile_arg} --protocol={protocol}  --ignore=tests/test_scenario --ignore=tests/test_asyncio/test_scenario  --cov=./ --cov-report=xml:coverage_cluster_resp{protocol}_uvloop.xml -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --redis-ssl-url={cluster_tls_url} --junit-xml=cluster-resp{protocol}-uvloop-results.xml --uvloop"
         )
     else:
         run(
-            f"pytest  {profile_arg} --protocol={protocol}  --ignore=tests/test_scenario  --cov=./ --cov-report=xml:coverage_cluster_resp{protocol}.xml -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --redis-ssl-url={cluster_tls_url} --junit-xml=cluster-resp{protocol}-results.xml"
+            f"pytest  {profile_arg} --protocol={protocol}  --ignore=tests/test_scenario --ignore=tests/test_asyncio/test_scenario  --cov=./ --cov-report=xml:coverage_cluster_resp{protocol}.xml -m 'not onlynoncluster and not redismod' --redis-url={cluster_url} --redis-ssl-url={cluster_tls_url} --junit-xml=cluster-resp{protocol}-results.xml"
         )
 
 
diff --git a/tests/conftest.py b/tests/conftest.py
index 7eaccb1acb..af2681732b 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -25,6 +25,7 @@
 )
 from redis.connection import Connection, ConnectionInterface, SSLConnection, parse_url
 from redis.credentials import CredentialProvider
+from redis.event import EventDispatcherInterface
 from redis.exceptions import RedisClusterException
 from redis.retry import Retry
 from tests.ssl_utils import get_tls_certificates
@@ -582,6 +583,12 @@ def mock_connection() -> ConnectionInterface:
     return mock_connection
 
 
+@pytest.fixture()
+def mock_ed() -> EventDispatcherInterface:
+    mock_ed = Mock(spec=EventDispatcherInterface)
+    return mock_ed
+
+
 @pytest.fixture()
 def cache_key(request) -> CacheKey:
     command = request.param.get("command")
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
index c30220fb1d..cb3dac9604 100644
--- a/tests/test_asyncio/test_connection_pool.py
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -114,6 +114,9 @@ def set_re_auth_token(self, token: TokenInterface):
     async def re_auth(self):
         pass
 
+    def should_reconnect(self):
+        return False
+
 
 class TestConnectionPool:
     @asynccontextmanager
diff --git a/tests/test_asyncio/test_multidb/__init__.py b/tests/test_asyncio/test_multidb/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/tests/test_asyncio/test_multidb/conftest.py b/tests/test_asyncio/test_multidb/conftest.py
new file mode 100644
index 0000000000..0666dc527a
--- /dev/null
+++ b/tests/test_asyncio/test_multidb/conftest.py
@@ -0,0 +1,131 @@
+from unittest.mock import Mock
+
+import pytest
+
+from redis.asyncio.multidb.config import (
+    MultiDbConfig,
+    DatabaseConfig,
+    DEFAULT_AUTO_FALLBACK_INTERVAL,
+)
+from redis.asyncio.multidb.failover import AsyncFailoverStrategy
+from redis.asyncio.multidb.failure_detector import AsyncFailureDetector
+from redis.asyncio.multidb.healthcheck import (
+    HealthCheck,
+    DEFAULT_HEALTH_CHECK_PROBES,
+    DEFAULT_HEALTH_CHECK_INTERVAL,
+    DEFAULT_HEALTH_CHECK_POLICY,
+)
+from redis.data_structure import WeightedList
+from redis.multidb.circuit import State as CBState, CircuitBreaker
+from redis.asyncio import Redis, ConnectionPool
+from redis.asyncio.multidb.database import Database, Databases
+
+
+@pytest.fixture()
+def mock_client() -> Redis:
+    return Mock(spec=Redis)
+
+
+@pytest.fixture()
+def mock_cb() -> CircuitBreaker:
+    return Mock(spec=CircuitBreaker)
+
+
+@pytest.fixture()
+def mock_fd() -> AsyncFailureDetector:
+    return Mock(spec=AsyncFailureDetector)
+
+
+@pytest.fixture()
+def mock_fs() -> AsyncFailoverStrategy:
+    return Mock(spec=AsyncFailoverStrategy)
+
+
+@pytest.fixture()
+def mock_hc() -> HealthCheck:
+    return Mock(spec=HealthCheck)
+
+
+@pytest.fixture()
+def mock_db(request) -> Database:
+    db = Mock(spec=Database)
+    db.weight = request.param.get("weight", 1.0)
+    db.client = Mock(spec=Redis)
+    db.client.connection_pool = Mock(spec=ConnectionPool)
+
+    cb = request.param.get("circuit", {})
+    mock_cb = Mock(spec=CircuitBreaker)
+    mock_cb.grace_period = cb.get("grace_period", 1.0)
+    mock_cb.state = cb.get("state", CBState.CLOSED)
+
+    db.circuit = mock_cb
+    return db
+
+
+@pytest.fixture()
+def mock_db1(request) -> Database:
+    db = Mock(spec=Database)
+    db.weight = request.param.get("weight", 1.0)
+    db.client = Mock(spec=Redis)
+    db.client.connection_pool = Mock(spec=ConnectionPool)
+
+    cb = request.param.get("circuit", {})
+    mock_cb = Mock(spec=CircuitBreaker)
+    mock_cb.grace_period = cb.get("grace_period", 1.0)
+    mock_cb.state = cb.get("state", CBState.CLOSED)
+
+    db.circuit = mock_cb
+    return db
+
+
+@pytest.fixture()
+def mock_db2(request) -> Database:
+    db = Mock(spec=Database)
+    db.weight = request.param.get("weight", 1.0)
+    db.client = Mock(spec=Redis)
+    db.client.connection_pool = Mock(spec=ConnectionPool)
+
+    cb = request.param.get("circuit", {})
+    mock_cb = Mock(spec=CircuitBreaker)
+    mock_cb.grace_period = cb.get("grace_period", 1.0)
+    mock_cb.state = cb.get("state", CBState.CLOSED)
+
+    db.circuit = mock_cb
+    return db
+
+
+@pytest.fixture()
+def mock_multi_db_config(request, mock_fd, mock_fs, mock_hc, mock_ed) -> MultiDbConfig:
+    hc_interval = request.param.get("hc_interval", DEFAULT_HEALTH_CHECK_INTERVAL)
+    auto_fallback_interval = request.param.get(
+        "auto_fallback_interval", DEFAULT_AUTO_FALLBACK_INTERVAL
+    )
+    health_check_policy = request.param.get(
+        "health_check_policy", DEFAULT_HEALTH_CHECK_POLICY
+    )
+    health_check_probes = request.param.get(
+        "health_check_probes", DEFAULT_HEALTH_CHECK_PROBES
+    )
+
+    config = MultiDbConfig(
+        databases_config=[Mock(spec=DatabaseConfig)],
+        failure_detectors=[mock_fd],
+        health_check_interval=hc_interval,
+        health_check_delay=0.05,
+        health_check_policy=health_check_policy,
+        health_check_probes=health_check_probes,
+        failover_strategy=mock_fs,
+        auto_fallback_interval=auto_fallback_interval,
+        event_dispatcher=mock_ed,
+    )
+
+    return config
+
+
+def create_weighted_list(*databases) -> Databases:
+    dbs = WeightedList()
+
+    for db in databases:
+        dbs.add(db, db.weight)
+
+    return dbs
diff --git a/tests/test_asyncio/test_multidb/test_client.py b/tests/test_asyncio/test_multidb/test_client.py
new file mode 100644
index 0000000000..e912a00466
--- /dev/null
+++ b/tests/test_asyncio/test_multidb/test_client.py
@@ -0,0 +1,628 @@
+import asyncio
+from unittest.mock import patch, AsyncMock, Mock
+
+import pybreaker
+import pytest
+
+from redis.asyncio.multidb.client import MultiDBClient
+from redis.asyncio.multidb.database import AsyncDatabase
+from redis.asyncio.multidb.failover import WeightBasedFailoverStrategy
+from redis.asyncio.multidb.failure_detector import AsyncFailureDetector
+from redis.asyncio.multidb.healthcheck import HealthCheck
+from redis.event import EventDispatcher, AsyncOnCommandsFailEvent
+from redis.multidb.circuit import State as CBState, PBCircuitBreakerAdapter
+from redis.multidb.exception import NoValidDatabaseException
+from tests.test_asyncio.test_multidb.conftest import create_weighted_list
+
+
+@pytest.mark.onlynoncluster
+class TestMultiDbClient:
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_execute_command_against_correct_db_on_successful_initialization(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_db1.client.execute_command = AsyncMock(return_value="OK1")
+
+            mock_hc.check_health.return_value = True
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            assert await client.set("key", "value") == "OK1"
+            assert mock_hc.check_health.call_count == 9
+
+            assert mock_db.circuit.state == CBState.CLOSED
+            assert mock_db1.circuit.state == CBState.CLOSED
+            assert mock_db2.circuit.state == CBState.CLOSED
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.OPEN}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_execute_command_against_correct_db_and_closed_circuit(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_db1.client.execute_command = AsyncMock(return_value="OK1")
+
+            mock_hc.check_health.side_effect = [
+                False,
+                True,
+                True,
+                True,
+                True,
+                True,
+                True,
+            ]
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            assert await client.set("key", "value") == "OK1"
+            assert mock_hc.check_health.call_count == 7
+
+            assert mock_db.circuit.state == CBState.CLOSED
+            assert mock_db1.circuit.state == CBState.CLOSED
+            assert mock_db2.circuit.state == CBState.OPEN
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {"health_check_probes": 1},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_execute_command_against_correct_db_on_background_health_check_determine_active_db_unhealthy(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        cb = PBCircuitBreakerAdapter(pybreaker.CircuitBreaker(reset_timeout=5))
+        cb.database = mock_db
+        mock_db.circuit = cb
+
+        cb1 = PBCircuitBreakerAdapter(pybreaker.CircuitBreaker(reset_timeout=5))
+        cb1.database = mock_db1
+        mock_db1.circuit = cb1
+
+        cb2 = PBCircuitBreakerAdapter(pybreaker.CircuitBreaker(reset_timeout=5))
+        cb2.database = mock_db2
+        mock_db2.circuit = cb2
+
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        # Track health check runs across all databases
+        health_check_run = 0
+
+        # Create events for each failover scenario
+        db1_became_unhealthy = asyncio.Event()
+        db2_became_unhealthy = asyncio.Event()
+        db_became_unhealthy = asyncio.Event()
+        counter_lock = asyncio.Lock()
+
+        async def mock_check_health(database):
+            nonlocal health_check_run
+
+            # Increment run counter for each health check call
+            async with counter_lock:
+                health_check_run += 1
+                current_run = health_check_run
+
+            # Run 1 (health_check_run 1-3): All databases healthy
+            if current_run <= 3:
+                return True
+
+            # Run 2 (health_check_run 4-6): mock_db1 unhealthy, others healthy
+            elif current_run <= 6:
+                if database == mock_db1:
+                    if current_run == 6:
+                        db1_became_unhealthy.set()
+                    return False
+
+                # Signal that db1 has become unhealthy after all 3 checks
+                if current_run == 6:
+                    db1_became_unhealthy.set()
+                return True
+
+            # Run 3 (health_check_run 7-9): mock_db1 and mock_db2 unhealthy, mock_db healthy
+            elif current_run <= 9:
+                if database == mock_db1 or database == mock_db2:
+                    if current_run == 9:
+                        db2_became_unhealthy.set()
+                    return False
+
+                # Signal that db2 has become unhealthy after all 3 checks
+                if current_run == 9:
+                    db2_became_unhealthy.set()
+                return True
+
+            # Run 4 (health_check_run 10-12): mock_db unhealthy, others healthy
+            else:
+                if database == mock_db:
+                    if current_run >= 12:
+                        db_became_unhealthy.set()
+                    return False
+
+                # Signal that db has become unhealthy after all 3 checks
+                if current_run >= 12:
+                    db_became_unhealthy.set()
+                return True
+
+        mock_hc.check_health.side_effect = mock_check_health
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config,
+                "default_health_checks",
+                return_value=[mock_hc],
+            ),
+        ):
+            mock_db.client.execute_command.return_value = "OK"
+            mock_db1.client.execute_command.return_value = "OK1"
+            mock_db2.client.execute_command.return_value = "OK2"
+            mock_multi_db_config.health_check_interval = 0.1
+            mock_multi_db_config.failover_strategy = WeightBasedFailoverStrategy()
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert await client.set("key", "value") == "OK1"
+
+            # Wait for mock_db1 to become unhealthy
+            assert await db1_became_unhealthy.wait(), (
+                "Timeout waiting for mock_db1 to become unhealthy"
+            )
+            await asyncio.sleep(0.01)
+
+            assert await client.set("key", "value") == "OK2"
+
+            # Wait for mock_db2 to become unhealthy
+            assert await db2_became_unhealthy.wait(), (
+                "Timeout waiting for mock_db2 to become unhealthy"
+            )
+            await asyncio.sleep(0.01)
+
+            assert await client.set("key", "value") == "OK"
+
+            # Wait for mock_db to become unhealthy
+            assert await db_became_unhealthy.wait(), (
+                "Timeout waiting for mock_db to become unhealthy"
+            )
+            await asyncio.sleep(0.01)
+
+            assert await client.set("key", "value") == "OK1"
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {"health_check_probes": 1},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_execute_command_auto_fallback_to_highest_weight_db(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        db1_counter = 0
+        error_event = asyncio.Event()
+        check = False
+
+        async def mock_check_health(database):
+            nonlocal db1_counter, check
+
+            if database == mock_db1 and not check:
+                db1_counter += 1
+
+                if db1_counter > 1:
+                    error_event.set()
+                    check = True
+                    return False
+
+            return True
+
+        mock_hc.check_health.side_effect = mock_check_health
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config,
+                "default_health_checks",
+                return_value=[mock_hc],
+            ),
+        ):
+            mock_db.client.execute_command.return_value = "OK"
+            mock_db1.client.execute_command.return_value = "OK1"
+            mock_db2.client.execute_command.return_value = "OK2"
+            mock_multi_db_config.health_check_interval = 0.1
+            mock_multi_db_config.auto_fallback_interval = 0.2
+            mock_multi_db_config.failover_strategy = WeightBasedFailoverStrategy()
+
+            async with MultiDBClient(mock_multi_db_config) as client:
+                assert await client.set("key", "value") == "OK1"
+                await error_event.wait()
+                assert await client.set("key", "value") == "OK2"
+                await asyncio.sleep(0.5)
+                assert await client.set("key", "value") == "OK1"
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.OPEN}},
+                {"weight": 0.7, "circuit": {"state": CBState.OPEN}},
+                {"weight": 0.5, "circuit": {"state": CBState.OPEN}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_execute_command_throws_exception_on_failed_initialization(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_hc.check_health.return_value = False
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+
+            with pytest.raises(
+                NoValidDatabaseException,
+                match="Initial connection failed - no active database found",
+            ):
+                await client.set("key", "value")
+                assert mock_hc.check_health.call_count == 9
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_add_database_throws_exception_on_same_database(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_hc.check_health.return_value = False
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+
+            with pytest.raises(ValueError, match="Given database already exists"):
+                await client.add_database(mock_db)
+                assert mock_hc.check_health.call_count == 9
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_add_database_makes_new_database_active(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_db1.client.execute_command.return_value = "OK1"
+            mock_db2.client.execute_command.return_value = "OK2"
+
+            mock_hc.check_health.return_value = True
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+
+            assert await client.set("key", "value") == "OK2"
+            assert mock_hc.check_health.call_count == 6
+
+            await client.add_database(mock_db1)
+            assert mock_hc.check_health.call_count == 9
+
+            assert await client.set("key", "value") == "OK1"
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_remove_highest_weighted_database(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_db1.client.execute_command.return_value = "OK1"
+            mock_db2.client.execute_command.return_value = "OK2"
+
+            mock_hc.check_health.return_value = True
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+
+            assert await client.set("key", "value") == "OK1"
+            assert mock_hc.check_health.call_count == 9
+
+            await client.remove_database(mock_db1)
+            assert await client.set("key", "value") == "OK2"
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_update_database_weight_to_be_highest(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_db1.client.execute_command.return_value = "OK1"
+            mock_db2.client.execute_command.return_value = "OK2"
+
+            mock_hc.check_health.return_value = True
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+
+            assert await client.set("key", "value") == "OK1"
+            assert mock_hc.check_health.call_count == 9
+
+            await client.update_database_weight(mock_db2, 0.8)
+            assert mock_db2.weight == 0.8
+
+            assert await client.set("key", "value") == "OK2"
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_add_new_failure_detector(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_db1.client.execute_command.return_value = "OK1"
+            mock_multi_db_config.event_dispatcher = EventDispatcher()
+            mock_fd = mock_multi_db_config.failure_detectors[0]
+
+            # Event fired if command against mock_db1 would fail
+            command_fail_event = AsyncOnCommandsFailEvent(
+                commands=("SET", "key", "value"),
+                exception=Exception(),
+            )
+
+            mock_hc.check_health.return_value = True
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            assert await client.set("key", "value") == "OK1"
+            assert mock_hc.check_health.call_count == 9
+
+            # Simulate failing command events that lead to a failure detection
+            for i in range(5):
+                await mock_multi_db_config.event_dispatcher.dispatch_async(
+                    command_fail_event
+                )
+
+            assert mock_fd.register_failure.call_count == 5
+
+            another_fd = Mock(spec=AsyncFailureDetector)
+            client.add_failure_detector(another_fd)
+
+            # Simulate failing command events that lead to a failure detection
+            for i in range(5):
+                await mock_multi_db_config.event_dispatcher.dispatch_async(
+                    command_fail_event
+                )
+
+            assert mock_fd.register_failure.call_count == 10
+            assert another_fd.register_failure.call_count == 5
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_add_new_health_check(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_db1.client.execute_command.return_value = "OK1"
+
+            mock_hc.check_health.return_value = True
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            assert await client.set("key", "value") == "OK1"
+            assert mock_hc.check_health.call_count == 9
+
+            another_hc = Mock(spec=HealthCheck)
+            another_hc.check_health.return_value = True
+
+            await client.add_health_check(another_hc)
+            await client._check_db_health(mock_db1)
+
+            assert mock_hc.check_health.call_count == 12
+            assert another_hc.check_health.call_count == 3
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_set_active_database(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_db1.client.execute_command.return_value = "OK1"
+            mock_db.client.execute_command.return_value = "OK"
+
+            mock_hc.check_health.return_value = True
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            assert await client.set("key", "value") == "OK1"
+            assert mock_hc.check_health.call_count == 9
+
+            await client.set_active_database(mock_db)
+            assert await client.set("key", "value") == "OK"
+
+            with pytest.raises(
+                ValueError, match="Given database is not a member of database list"
+            ):
+                await client.set_active_database(Mock(spec=AsyncDatabase))
+
+            mock_hc.check_health.return_value = False
+
+            with pytest.raises(
+                NoValidDatabaseException,
+                match="Cannot set active database, database is unhealthy",
+            ):
+                await client.set_active_database(mock_db1)
diff --git a/tests/test_asyncio/test_multidb/test_command_executor.py b/tests/test_asyncio/test_multidb/test_command_executor.py
new file mode 100644
index 0000000000..e0ac80a56a
--- /dev/null
+++ b/tests/test_asyncio/test_multidb/test_command_executor.py
@@ -0,0 +1,181 @@
+import asyncio
+from unittest.mock import AsyncMock
+
+import pytest
+
+from redis.asyncio.multidb.failure_detector import FailureDetectorAsyncWrapper
+from redis.event import EventDispatcher
+from redis.exceptions import ConnectionError
+from redis.asyncio.multidb.command_executor import DefaultCommandExecutor
+from redis.asyncio.retry import Retry
+from redis.backoff import NoBackoff
+from redis.multidb.circuit import State as CBState
+from redis.multidb.failure_detector import CommandFailureDetector
+from tests.test_asyncio.test_multidb.conftest import create_weighted_list
+
+
+@pytest.mark.onlynoncluster
+class TestDefaultCommandExecutor:
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_db,mock_db1,mock_db2",
+        [
+            (
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_execute_command_on_active_database(
+        self, mock_db, mock_db1, mock_db2, mock_fd, mock_fs, mock_ed
+    ):
+        mock_db1.client.execute_command = AsyncMock(return_value="OK1")
+        mock_db2.client.execute_command = AsyncMock(return_value="OK2")
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        executor = DefaultCommandExecutor(
+            failure_detectors=[mock_fd],
+            databases=databases,
+            failover_strategy=mock_fs,
+            event_dispatcher=mock_ed,
+            command_retry=Retry(NoBackoff(), 0),
+        )
+
+        await executor.set_active_database(mock_db1)
+        assert await executor.execute_command("SET", "key", "value") == "OK1"
+
+        await executor.set_active_database(mock_db2)
+        assert await executor.execute_command("SET", "key", "value") == "OK2"
+        assert mock_ed.register_listeners.call_count == 1
+        assert mock_fd.register_command_execution.call_count == 2
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_db,mock_db1,mock_db2",
+        [
+            (
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_execute_command_automatically_select_active_database(
+        self, mock_db, mock_db1, mock_db2, mock_fd, mock_fs, mock_ed
+    ):
+        mock_db1.client.execute_command = AsyncMock(return_value="OK1")
+        mock_db2.client.execute_command = AsyncMock(return_value="OK2")
+        mock_selector = AsyncMock(side_effect=[mock_db1, mock_db2])
+        type(mock_fs).database = mock_selector
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        executor = DefaultCommandExecutor(
+            failure_detectors=[mock_fd],
+            databases=databases,
+            failover_strategy=mock_fs,
+            event_dispatcher=mock_ed,
+            command_retry=Retry(NoBackoff(), 0),
+        )
+
+        assert await executor.execute_command("SET", "key", "value") == "OK1"
+        mock_db1.circuit.state = CBState.OPEN
+
+        assert await executor.execute_command("SET", "key", "value") == "OK2"
+        assert mock_ed.register_listeners.call_count == 1
+        assert mock_selector.call_count == 2
+        assert mock_fd.register_command_execution.call_count == 2
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_db,mock_db1,mock_db2",
+        [
+            (
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_execute_command_fallback_to_another_db_after_fallback_interval(
+        self, mock_db, mock_db1, mock_db2, mock_fd, mock_fs, mock_ed
+    ):
+        mock_db1.client.execute_command = AsyncMock(return_value="OK1")
+        mock_db2.client.execute_command = AsyncMock(return_value="OK2")
+        mock_selector = AsyncMock(side_effect=[mock_db1, mock_db2, mock_db1])
+        type(mock_fs).database = mock_selector
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        executor = DefaultCommandExecutor(
+            failure_detectors=[mock_fd],
+            databases=databases,
+            failover_strategy=mock_fs,
+            event_dispatcher=mock_ed,
+            auto_fallback_interval=0.1,
+            command_retry=Retry(NoBackoff(), 0),
+        )
+
+        assert await executor.execute_command("SET", "key", "value") == "OK1"
+        mock_db1.weight = 0.1
+        await asyncio.sleep(0.15)
+
+        assert await executor.execute_command("SET", "key", "value") == "OK2"
+        mock_db1.weight = 0.7
+        await asyncio.sleep(0.15)
+
+        assert await executor.execute_command("SET", "key", "value") == "OK1"
+        assert mock_ed.register_listeners.call_count == 1
+        assert mock_selector.call_count == 3
+        assert mock_fd.register_command_execution.call_count == 3
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_db,mock_db1,mock_db2",
+        [
+            (
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_execute_command_fallback_to_another_db_after_failure_detection(
+        self, mock_db, mock_db1, mock_db2, mock_fs
+    ):
+        mock_db1.client.execute_command = AsyncMock(
+            side_effect=[
+                "OK1",
+                ConnectionError,
+                ConnectionError,
+                ConnectionError,
+                "OK1",
+            ]
+        )
+        mock_db2.client.execute_command = AsyncMock(
+            side_effect=["OK2", ConnectionError, ConnectionError, ConnectionError]
+        )
+        mock_selector = AsyncMock(side_effect=[mock_db1, mock_db2, mock_db1])
+        type(mock_fs).database = mock_selector
+        threshold = 3
+        fd = FailureDetectorAsyncWrapper(CommandFailureDetector(threshold, 1))
+        ed = EventDispatcher()
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        executor = DefaultCommandExecutor(
+            failure_detectors=[fd],
+            databases=databases,
+            failover_strategy=mock_fs,
+            event_dispatcher=ed,
+            auto_fallback_interval=0.1,
+            command_retry=Retry(NoBackoff(), threshold),
+        )
+        fd.set_command_executor(command_executor=executor)
+
+        assert await executor.execute_command("SET", "key", "value") == "OK1"
+        assert await executor.execute_command("SET", "key", "value") == "OK2"
+        assert await executor.execute_command("SET", "key", "value") == "OK1"
+        assert mock_selector.call_count == 3
diff --git a/tests/test_asyncio/test_multidb/test_config.py b/tests/test_asyncio/test_multidb/test_config.py
new file mode 100644
index 0000000000..d05c7a8a12
--- /dev/null
+++ b/tests/test_asyncio/test_multidb/test_config.py
@@ -0,0 +1,166 @@
+from unittest.mock import Mock
+
+import pytest
+
+from redis.asyncio import ConnectionPool
+from redis.asyncio.multidb.config import (
+    DatabaseConfig,
+    MultiDbConfig,
+    DEFAULT_GRACE_PERIOD,
+    DEFAULT_HEALTH_CHECK_INTERVAL,
+    DEFAULT_AUTO_FALLBACK_INTERVAL,
+)
+from redis.asyncio.multidb.database import Database
+from redis.asyncio.multidb.failover import (
+    WeightBasedFailoverStrategy,
+    AsyncFailoverStrategy,
+)
+from redis.asyncio.multidb.failure_detector import (
+    FailureDetectorAsyncWrapper,
+    AsyncFailureDetector,
+)
+from redis.asyncio.multidb.healthcheck import EchoHealthCheck, HealthCheck
+from redis.asyncio.retry import Retry
+from redis.multidb.circuit import CircuitBreaker
+
+
+@pytest.mark.onlynoncluster
+class TestMultiDbConfig:
+    def test_default_config(self):
+        db_configs = [
+            DatabaseConfig(
+                client_kwargs={"host": "host1", "port": "port1"}, weight=1.0
+            ),
+            DatabaseConfig(
+                client_kwargs={"host": "host2", "port": "port2"}, weight=0.9
+            ),
+            DatabaseConfig(
+                client_kwargs={"host": "host3", "port": "port3"}, weight=0.8
+            ),
+        ]
+
+        config = MultiDbConfig(databases_config=db_configs)
+
+        assert config.databases_config == db_configs
+        databases = config.databases()
+        assert len(databases) == 3
+
+        i = 0
+        for db, weight in databases:
+            assert isinstance(db, Database)
+            assert weight == db_configs[i].weight
+            assert db.circuit.grace_period == DEFAULT_GRACE_PERIOD
+            assert db.client.get_retry() is not config.command_retry
+            i += 1
+
+        assert len(config.default_failure_detectors()) == 1
+        assert isinstance(
+            config.default_failure_detectors()[0], FailureDetectorAsyncWrapper
+        )
+        assert len(config.default_health_checks()) == 1
+        assert isinstance(config.default_health_checks()[0], EchoHealthCheck)
+        assert config.health_check_interval == DEFAULT_HEALTH_CHECK_INTERVAL
+        assert isinstance(
+            config.default_failover_strategy(), WeightBasedFailoverStrategy
+        )
+        assert config.auto_fallback_interval == DEFAULT_AUTO_FALLBACK_INTERVAL
+        assert isinstance(config.command_retry, Retry)
+
+    def test_overridden_config(self):
+        grace_period = 2
+        mock_connection_pools = [
+            Mock(spec=ConnectionPool),
+            Mock(spec=ConnectionPool),
+            Mock(spec=ConnectionPool),
+        ]
+        mock_connection_pools[0].connection_kwargs = {}
+        mock_connection_pools[1].connection_kwargs = {}
+        mock_connection_pools[2].connection_kwargs = {}
+        mock_cb1 = Mock(spec=CircuitBreaker)
+        mock_cb1.grace_period = grace_period
+        mock_cb2 = Mock(spec=CircuitBreaker)
+        mock_cb2.grace_period = grace_period
+        mock_cb3 = Mock(spec=CircuitBreaker)
+        mock_cb3.grace_period = grace_period
+        mock_failure_detectors = [
+            Mock(spec=AsyncFailureDetector),
+            Mock(spec=AsyncFailureDetector),
+        ]
+        mock_health_checks = [Mock(spec=HealthCheck), Mock(spec=HealthCheck)]
+        health_check_interval = 10
+        mock_failover_strategy = Mock(spec=AsyncFailoverStrategy)
+        auto_fallback_interval = 10
+        db_configs = [
+            DatabaseConfig(
+                client_kwargs={"connection_pool": mock_connection_pools[0]},
+                weight=1.0,
+                circuit=mock_cb1,
+            ),
+            DatabaseConfig(
+                client_kwargs={"connection_pool": mock_connection_pools[1]},
+                weight=0.9,
+                circuit=mock_cb2,
+            ),
+            DatabaseConfig(
+                client_kwargs={"connection_pool": mock_connection_pools[2]},
+                weight=0.8,
+                circuit=mock_cb3,
+            ),
+        ]
+
+        config = MultiDbConfig(
+            databases_config=db_configs,
+            failure_detectors=mock_failure_detectors,
+            health_checks=mock_health_checks,
+            health_check_interval=health_check_interval,
+            failover_strategy=mock_failover_strategy,
+            auto_fallback_interval=auto_fallback_interval,
+        )
+
+        assert config.databases_config == db_configs
+        databases = config.databases()
+        assert len(databases) == 3
+
+        i = 0
+        for db, weight in databases:
+            assert isinstance(db, Database)
+            assert weight == db_configs[i].weight
+            assert db.client.connection_pool == mock_connection_pools[i]
+            assert db.circuit.grace_period == grace_period
+            i += 1
+
+        assert len(config.failure_detectors) == 2
+        assert config.failure_detectors[0] == mock_failure_detectors[0]
+        assert config.failure_detectors[1] == mock_failure_detectors[1]
+        assert len(config.health_checks) == 2
+        assert config.health_checks[0] == mock_health_checks[0]
+        assert config.health_checks[1] == mock_health_checks[1]
+        assert config.health_check_interval == health_check_interval
+        assert config.failover_strategy == mock_failover_strategy
+        assert config.auto_fallback_interval == auto_fallback_interval
+
+
+@pytest.mark.onlynoncluster
+class TestDatabaseConfig:
+    def test_default_config(self):
+        config = DatabaseConfig(
+            client_kwargs={"host": "host1", "port": "port1"}, weight=1.0
+        )
+
+        assert config.client_kwargs == {"host": "host1", "port": "port1"}
+        assert config.weight == 1.0
+        assert isinstance(config.default_circuit_breaker(), CircuitBreaker)
+
+    def test_overridden_config(self):
+        mock_connection_pool = Mock(spec=ConnectionPool)
+        mock_circuit = Mock(spec=CircuitBreaker)
+
+        config = DatabaseConfig(
+            client_kwargs={"connection_pool": mock_connection_pool},
+            weight=1.0,
+            circuit=mock_circuit,
+        )
+
+        assert config.client_kwargs == {"connection_pool": mock_connection_pool}
+        assert config.weight == 1.0
+        assert config.circuit == mock_circuit
diff --git a/tests/test_asyncio/test_multidb/test_failover.py b/tests/test_asyncio/test_multidb/test_failover.py
new file mode 100644
index 0000000000..a34bb368c8
--- /dev/null
+++ b/tests/test_asyncio/test_multidb/test_failover.py
@@ -0,0 +1,169 @@
+import asyncio
+
+import pytest
+
+from redis.data_structure import WeightedList
+from redis.multidb.circuit import State as CBState
+from redis.multidb.exception import (
+    NoValidDatabaseException,
+    TemporaryUnavailableException,
+)
+from redis.asyncio.multidb.failover import (
+    WeightBasedFailoverStrategy,
+    DefaultFailoverStrategyExecutor,
+)
+
+
+@pytest.mark.onlynoncluster
+class TestAsyncWeightBasedFailoverStrategy:
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_db,mock_db1,mock_db2",
+        [
+            (
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+            (
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.OPEN}},
+            ),
+        ],
+        ids=["all closed - highest weight", "highest weight - open"],
+        indirect=True,
+    )
+    async def test_get_valid_database(self, mock_db, mock_db1, mock_db2):
+        databases = WeightedList()
+        databases.add(mock_db, mock_db.weight)
+        databases.add(mock_db1, mock_db1.weight)
+        databases.add(mock_db2, mock_db2.weight)
+
+        strategy = WeightBasedFailoverStrategy()
+        strategy.set_databases(databases)
+
+        assert await strategy.database() == mock_db1
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_db,mock_db1,mock_db2",
+        [
+            (
+                {"weight": 0.2, "circuit": {"state": CBState.OPEN}},
+                {"weight": 0.7, "circuit": {"state": CBState.OPEN}},
+                {"weight": 0.5, "circuit": {"state": CBState.OPEN}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_throws_exception_on_empty_databases(
+        self, mock_db, mock_db1, mock_db2
+    ):
+        failover_strategy = WeightBasedFailoverStrategy()
+
+        with pytest.raises(
+            NoValidDatabaseException,
+            match="No valid database available for communication",
+        ):
+            assert await failover_strategy.database()
+
+
+class TestDefaultStrategyExecutor:
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_db",
+        [
+            {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+        ],
+        indirect=True,
+    )
+    async def test_execute_returns_valid_database_with_failover_attempts(
+        self, mock_db, mock_fs
+    ):
+        failover_attempts = 3
+        mock_fs.database.side_effect = [
+            NoValidDatabaseException,
+            NoValidDatabaseException,
+            NoValidDatabaseException,
+            mock_db,
+        ]
+        executor = DefaultFailoverStrategyExecutor(
+            mock_fs, failover_attempts=failover_attempts, failover_delay=0.1
+        )
+
+        for i in range(failover_attempts + 1):
+            try:
+                database = await executor.execute()
+                assert database == mock_db
+            except TemporaryUnavailableException as e:
+                assert e.args[0] == (
+                    "No database connections currently available. "
+                    "This is a temporary condition - please retry the operation."
+                )
+                await asyncio.sleep(0.11)
+                pass
+
+        assert mock_fs.database.call_count == 4
+
+    @pytest.mark.asyncio
+    async def test_execute_throws_exception_on_attempts_exceed(self, mock_fs):
+        failover_attempts = 3
+        mock_fs.database.side_effect = [
+            NoValidDatabaseException,
+            NoValidDatabaseException,
+            NoValidDatabaseException,
+            NoValidDatabaseException,
+        ]
+        executor = DefaultFailoverStrategyExecutor(
+            mock_fs, failover_attempts=failover_attempts, failover_delay=0.1
+        )
+
+        with pytest.raises(NoValidDatabaseException):
+            for i in range(failover_attempts + 1):
+                try:
+                    await executor.execute()
+                except TemporaryUnavailableException as e:
+                    assert e.args[0] == (
+                        "No database connections currently available. "
+                        "This is a temporary condition - please retry the operation."
+                    )
+                    await asyncio.sleep(0.11)
+                    pass
+
+            assert mock_fs.database.call_count == 4
+
+    @pytest.mark.asyncio
+    async def test_execute_throws_exception_on_attempts_does_not_exceed_delay(
+        self, mock_fs
+    ):
+        failover_attempts = 3
+        mock_fs.database.side_effect = [
+            NoValidDatabaseException,
+            NoValidDatabaseException,
+            NoValidDatabaseException,
+            NoValidDatabaseException,
+        ]
+        executor = DefaultFailoverStrategyExecutor(
+            mock_fs, failover_attempts=failover_attempts, failover_delay=0.1
+        )
+
+        with pytest.raises(
+            TemporaryUnavailableException,
+            match=(
+                "No database connections currently available. "
+                "This is a temporary condition - please retry the operation."
+            ),
+        ):
+            for i in range(failover_attempts + 1):
+                try:
+                    await executor.execute()
+                except TemporaryUnavailableException as e:
+                    assert e.args[0] == (
+                        "No database connections currently available. "
+                        "This is a temporary condition - please retry the operation."
+                    )
+                    if i == failover_attempts:
+                        raise e
+
+            assert mock_fs.database.call_count == 4
diff --git a/tests/test_asyncio/test_multidb/test_failure_detector.py b/tests/test_asyncio/test_multidb/test_failure_detector.py
new file mode 100644
index 0000000000..279bda9605
--- /dev/null
+++ b/tests/test_asyncio/test_multidb/test_failure_detector.py
@@ -0,0 +1,128 @@
+import asyncio
+from unittest.mock import Mock
+
+import pytest
+
+from redis.asyncio.multidb.command_executor import AsyncCommandExecutor
+from redis.asyncio.multidb.database import Database
+from redis.asyncio.multidb.failure_detector import FailureDetectorAsyncWrapper
+from redis.multidb.circuit import State as CBState
+from redis.multidb.failure_detector import CommandFailureDetector
+
+
+@pytest.mark.onlynoncluster
+class TestFailureDetectorAsyncWrapper:
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "min_num_failures,failure_rate_threshold,circuit_state",
+        [
+            (2, 0.4, CBState.OPEN),
+            (2, 0, CBState.OPEN),
+            (0, 0.4, CBState.OPEN),
+            (3, 0.4, CBState.CLOSED),
+            (2, 0.41, CBState.CLOSED),
+        ],
+        ids=[
+            "exceeds min num failures AND failures rate",
+            "exceeds min num failures AND failures rate == 0",
+            "min num failures == 0 AND exceeds failures rate",
+            "do not exceeds min num failures",
+            "do not exceeds failures rate",
+        ],
+    )
+    async def test_failure_detector_correctly_reacts_to_failures(
+        self, min_num_failures, failure_rate_threshold, circuit_state
+    ):
+        fd = FailureDetectorAsyncWrapper(
+            CommandFailureDetector(min_num_failures, failure_rate_threshold)
+        )
+        mock_db = Mock(spec=Database)
+        mock_db.circuit.state = CBState.CLOSED
+        mock_ce = Mock(spec=AsyncCommandExecutor)
+        mock_ce.active_database = mock_db
+        fd.set_command_executor(mock_ce)
+
+        await fd.register_command_execution(("GET", "key"))
+        await fd.register_command_execution(("GET", "key"))
+        await fd.register_failure(Exception(), ("GET", "key"))
+
+        await fd.register_command_execution(("GET", "key"))
+        await fd.register_command_execution(("GET", "key"))
+        await fd.register_command_execution(("GET", "key"))
+        await fd.register_failure(Exception(), ("GET", "key"))
+
+        assert mock_db.circuit.state == circuit_state
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "min_num_failures,failure_rate_threshold",
+        [
+            (3, 0.0),
+            (3, 0.6),
+        ],
+        ids=[
+            "do not exceeds min num failures, during interval",
+            "do not exceeds min num failures AND failure rate, during interval",
+        ],
+    )
+    async def test_failure_detector_do_not_open_circuit_on_interval_exceed(
+        self, min_num_failures, failure_rate_threshold
+    ):
+        fd = FailureDetectorAsyncWrapper(
+            CommandFailureDetector(min_num_failures, failure_rate_threshold, 0.3)
+        )
+        mock_db = Mock(spec=Database)
+        mock_db.circuit.state = CBState.CLOSED
+        mock_ce = Mock(spec=AsyncCommandExecutor)
+        mock_ce.active_database = mock_db
+        fd.set_command_executor(mock_ce)
+        assert mock_db.circuit.state == CBState.CLOSED
+
+        await fd.register_command_execution(("GET", "key"))
+        await fd.register_failure(Exception(), ("GET", "key"))
+        await asyncio.sleep(0.16)
+        await fd.register_command_execution(("GET", "key"))
+        await fd.register_command_execution(("GET", "key"))
+        await fd.register_command_execution(("GET", "key"))
+        await fd.register_failure(Exception(), ("GET", "key"))
+        await asyncio.sleep(0.16)
+        await fd.register_command_execution(("GET", "key"))
+        await fd.register_failure(Exception(), ("GET", "key"))
+
+        assert mock_db.circuit.state == CBState.CLOSED
+
+        # 2 more failure as last one already refreshed timer
+        await fd.register_command_execution(("GET", "key"))
+        await fd.register_failure(Exception(), ("GET", "key"))
+        await fd.register_command_execution(("GET", "key"))
+        await fd.register_failure(Exception(), ("GET", "key"))
+
+        assert mock_db.circuit.state == CBState.OPEN
+
+    @pytest.mark.asyncio
+    async def test_failure_detector_open_circuit_on_specific_exception_threshold_exceed(
+        self,
+    ):
+        fd = FailureDetectorAsyncWrapper(
+            CommandFailureDetector(5, 1, error_types=[ConnectionError])
+        )
+        mock_db = Mock(spec=Database)
+        mock_db.circuit.state = CBState.CLOSED
+        mock_ce = Mock(spec=AsyncCommandExecutor)
+        mock_ce.active_database = mock_db
+        fd.set_command_executor(mock_ce)
+        assert mock_db.circuit.state == CBState.CLOSED
+
+        await fd.register_failure(Exception(), ("SET", "key1", "value1"))
+        await fd.register_failure(ConnectionError(), ("SET", "key1", "value1"))
+        await fd.register_failure(ConnectionError(), ("SET", "key1", "value1"))
+        await fd.register_failure(Exception(), ("SET", "key1", "value1"))
+        await fd.register_failure(Exception(), ("SET", "key1", "value1"))
+
+        assert mock_db.circuit.state == CBState.CLOSED
+
+        await fd.register_failure(ConnectionError(), ("SET", "key1", "value1"))
+        await fd.register_failure(ConnectionError(), ("SET", "key1", "value1"))
+        await fd.register_failure(ConnectionError(), ("SET", "key1", "value1"))
+
+        assert mock_db.circuit.state == CBState.OPEN
diff --git a/tests/test_asyncio/test_multidb/test_healthcheck.py b/tests/test_asyncio/test_multidb/test_healthcheck.py
new file mode 100644
index 0000000000..3e7ac42cd9
--- /dev/null
+++ b/tests/test_asyncio/test_multidb/test_healthcheck.py
@@ -0,0 +1,401 @@
+import pytest
+from mock.mock import AsyncMock, Mock
+
+from redis.asyncio.multidb.database import Database
+from redis.asyncio.multidb.healthcheck import (
+    EchoHealthCheck,
+    LagAwareHealthCheck,
+    HealthCheck,
+    HealthyAllPolicy,
+    HealthyMajorityPolicy,
+    HealthyAnyPolicy,
+)
+from redis.http.http_client import HttpError
+from redis.multidb.circuit import State as CBState
+from redis.exceptions import ConnectionError
+from redis.multidb.exception import UnhealthyDatabaseException
+
+
+@pytest.mark.onlynoncluster
+class TestHealthyAllPolicy:
+    @pytest.mark.asyncio
+    async def test_policy_returns_true_for_all_successful_probes(self):
+        mock_hc1 = Mock(spec=HealthCheck)
+        mock_hc2 = Mock(spec=HealthCheck)
+        mock_hc1.check_health.return_value = True
+        mock_hc2.check_health.return_value = True
+        mock_db = Mock(spec=Database)
+
+        policy = HealthyAllPolicy(3, 0.01)
+        assert await policy.execute([mock_hc1, mock_hc2], mock_db)
+        assert mock_hc1.check_health.call_count == 3
+        assert mock_hc2.check_health.call_count == 3
+
+    @pytest.mark.asyncio
+    async def test_policy_returns_false_on_first_failed_probe(self):
+        mock_hc1 = Mock(spec=HealthCheck)
+        mock_hc2 = Mock(spec=HealthCheck)
+        mock_hc1.check_health.side_effect = [True, True, False]
+        mock_hc2.check_health.return_value = True
+        mock_db = Mock(spec=Database)
+
+        policy = HealthyAllPolicy(3, 0.01)
+        assert not await policy.execute([mock_hc1, mock_hc2], mock_db)
+        assert mock_hc1.check_health.call_count == 3
+        assert mock_hc2.check_health.call_count == 0
+
+    @pytest.mark.asyncio
+    async def test_policy_raise_unhealthy_database_exception(self):
+        mock_hc1 = Mock(spec=HealthCheck)
+        mock_hc2 = Mock(spec=HealthCheck)
+        mock_hc1.check_health.side_effect = [True, True, ConnectionError]
+        mock_hc2.check_health.return_value = True
+        mock_db = Mock(spec=Database)
+
+        policy = HealthyAllPolicy(3, 0.01)
+        with pytest.raises(UnhealthyDatabaseException, match="Unhealthy database"):
+            await policy.execute([mock_hc1, mock_hc2], mock_db)
+            assert mock_hc1.check_health.call_count == 3
+            assert mock_hc2.check_health.call_count == 0
+
+
+@pytest.mark.onlynoncluster
+class TestHealthyMajorityPolicy:
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "probes,hc1_side_effect,hc2_side_effect,hc1_call_count,hc2_call_count,expected_result",
+        [
+            (3, [True, False, False], [True, True, True], 3, 0, False),
+            (3, [True, True, True], [True, False, False], 3, 3, False),
+            (3, [True, False, True], [True, True, True], 3, 3, True),
+            (3, [True, True, True], [True, False, True], 3, 3, True),
+            (3, [True, True, False], [True, False, True], 3, 3, True),
+            (4, [True, True, False, False], [True, True, True, True], 4, 0, False),
+            (4, [True, True, True, True], [True, True, False, False], 4, 4, False),
+            (4, [False, True, True, True], [True, True, True, True], 4, 4, True),
+            (4, [True, True, True, True], [True, False, True, True], 4, 4, True),
+            (4, [False, True, True, True], [True, True, False, True], 4, 4, True),
+        ],
+        ids=[
+            "HC1 - no majority - odd",
+            "HC2 - no majority - odd",
+            "HC1 - majority- odd",
+            "HC2 - majority - odd",
+            "HC1 + HC2 - majority - odd",
+            "HC1 - no majority - even",
+            "HC2 - no majority - even",
+            "HC1 - majority - even",
+            "HC2 - majority - even",
+            "HC1 + HC2 - majority - even",
+        ],
+    )
+    async def test_policy_returns_true_for_majority_successful_probes(
+        self,
+        probes,
+        hc1_side_effect,
+        hc2_side_effect,
+        hc1_call_count,
+        hc2_call_count,
+        expected_result,
+    ):
+        mock_hc1 = Mock(spec=HealthCheck)
+        mock_hc2 = Mock(spec=HealthCheck)
+        mock_hc1.check_health.side_effect = hc1_side_effect
+        mock_hc2.check_health.side_effect = hc2_side_effect
+        mock_db = Mock(spec=Database)
+
+        policy = HealthyMajorityPolicy(probes, 0.01)
+        assert await policy.execute([mock_hc1, mock_hc2], mock_db) == expected_result
+        assert mock_hc1.check_health.call_count == hc1_call_count
+        assert mock_hc2.check_health.call_count == hc2_call_count
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "probes,hc1_side_effect,hc2_side_effect,hc1_call_count,hc2_call_count",
+        [
+            (3, [True, ConnectionError, ConnectionError], [True, True, True], 3, 0),
+            (3, [True, True, True], [True, ConnectionError, ConnectionError], 3, 3),
+            (
+                4,
+                [True, ConnectionError, ConnectionError, True],
+                [True, True, True, True],
+                3,
+                0,
+            ),
+            (
+                4,
+                [True, True, True, True],
+                [True, ConnectionError, ConnectionError, False],
+                4,
+                3,
+            ),
+        ],
+        ids=[
+            "HC1 - majority- odd",
+            "HC2 - majority - odd",
+            "HC1 - majority - even",
+            "HC2 - majority - even",
+        ],
+    )
+    async def test_policy_raise_unhealthy_database_exception_on_majority_probes_exceptions(
+        self, probes, hc1_side_effect, hc2_side_effect, hc1_call_count, hc2_call_count
+    ):
+        mock_hc1 = Mock(spec=HealthCheck)
+        mock_hc2 = Mock(spec=HealthCheck)
+        mock_hc1.check_health.side_effect = hc1_side_effect
+        mock_hc2.check_health.side_effect = hc2_side_effect
+        mock_db = Mock(spec=Database)
+
+        policy = HealthyAllPolicy(3, 0.01)
+        with pytest.raises(UnhealthyDatabaseException, match="Unhealthy database"):
+            await policy.execute([mock_hc1, mock_hc2], mock_db)
+            assert mock_hc1.check_health.call_count == hc1_call_count
+            assert mock_hc2.check_health.call_count == hc2_call_count
+
+
+@pytest.mark.onlynoncluster
+class TestHealthyAnyPolicy:
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "hc1_side_effect,hc2_side_effect,hc1_call_count,hc2_call_count,expected_result",
+        [
+            ([False, False, False], [True, True, True], 3, 0, False),
+            ([False, False, True], [False, False, False], 3, 3, False),
+            ([False, True, True], [False, False, True], 2, 3, True),
+            ([True, True, True], [False, True, False], 1, 2, True),
+        ],
+        ids=[
+            "HC1 - no successful",
+            "HC2 - no successful",
+            "HC1 - successful",
+            "HC2 - successful",
+        ],
+    )
+    async def test_policy_returns_true_for_any_successful_probe(
+        self,
+        hc1_side_effect,
+        hc2_side_effect,
+        hc1_call_count,
+        hc2_call_count,
+        expected_result,
+    ):
+        mock_hc1 = Mock(spec=HealthCheck)
+        mock_hc2 = Mock(spec=HealthCheck)
+        mock_hc1.check_health.side_effect = hc1_side_effect
+        mock_hc2.check_health.side_effect = hc2_side_effect
+        mock_db = Mock(spec=Database)
+
+        policy = HealthyAnyPolicy(3, 0.01)
+        assert await policy.execute([mock_hc1, mock_hc2], mock_db) == expected_result
+        assert mock_hc1.check_health.call_count == hc1_call_count
+        assert mock_hc2.check_health.call_count == hc2_call_count
+
+    @pytest.mark.asyncio
+    async def test_policy_raise_unhealthy_database_exception_if_exception_occurs_on_failed_health_check(
+        self,
+    ):
+        mock_hc1 = Mock(spec=HealthCheck)
+        mock_hc2 = Mock(spec=HealthCheck)
+        mock_hc1.check_health.side_effect = [False, False, ConnectionError]
+        mock_hc2.check_health.side_effect = [True, True, True]
+        mock_db = Mock(spec=Database)
+
+        policy = HealthyAnyPolicy(3, 0.01)
+        with pytest.raises(UnhealthyDatabaseException, match="Unhealthy database"):
+            await policy.execute([mock_hc1, mock_hc2], mock_db)
+            assert mock_hc1.check_health.call_count == 3
+            assert mock_hc2.check_health.call_count == 0
+
+
+@pytest.mark.onlynoncluster
+class TestEchoHealthCheck:
+    @pytest.mark.asyncio
+    async def test_database_is_healthy_on_echo_response(self, mock_client, mock_cb):
+        """
+        Mocking responses to mix error and actual responses to ensure that health check retry
+        according to given configuration.
+        """
+        mock_client.execute_command = AsyncMock(side_effect=["healthcheck"])
+        hc = EchoHealthCheck()
+        db = Database(mock_client, mock_cb, 0.9)
+
+        assert await hc.check_health(db)
+        assert mock_client.execute_command.call_count == 1
+
+    @pytest.mark.asyncio
+    async def test_database_is_unhealthy_on_incorrect_echo_response(
+        self, mock_client, mock_cb
+    ):
+        """
+        Mocking responses to mix error and actual responses to ensure that health check retry
+        according to given configuration.
+        """
+        mock_client.execute_command = AsyncMock(side_effect=["wrong"])
+        hc = EchoHealthCheck()
+        db = Database(mock_client, mock_cb, 0.9)
+
+        assert not await hc.check_health(db)
+        assert mock_client.execute_command.call_count == 1
+
+    @pytest.mark.asyncio
+    async def test_database_close_circuit_on_successful_healthcheck(
+        self, mock_client, mock_cb
+    ):
+        mock_client.execute_command = AsyncMock(side_effect=["healthcheck"])
+        mock_cb.state = CBState.HALF_OPEN
+        hc = EchoHealthCheck()
+        db = Database(mock_client, mock_cb, 0.9)
+
+        assert await hc.check_health(db)
+        assert mock_client.execute_command.call_count == 1
+
+
+@pytest.mark.onlynoncluster
+class TestLagAwareHealthCheck:
+    @pytest.mark.asyncio
+    async def test_database_is_healthy_when_bdb_matches_by_dns_name(
+        self, mock_client, mock_cb
+    ):
+        """
+        Ensures health check succeeds when /v1/bdbs contains an endpoint whose dns_name
+        matches database host, and availability endpoint returns success.
+        """
+        host = "db1.example.com"
+        mock_client.get_connection_kwargs.return_value = {"host": host}
+
+        # Mock HttpClient used inside LagAwareHealthCheck
+        mock_http = AsyncMock()
+        mock_http.get.side_effect = [
+            # First call: list of bdbs
+            [
+                {
+                    "uid": "bdb-1",
+                    "endpoints": [
+                        {"dns_name": host, "addr": ["10.0.0.1", "10.0.0.2"]},
+                    ],
+                }
+            ],
+            # Second call: availability check (no JSON expected)
+            None,
+        ]
+
+        hc = LagAwareHealthCheck(rest_api_port=1234, lag_aware_tolerance=150)
+        # Inject our mocked http client
+        hc._http_client = mock_http
+
+        db = Database(mock_client, mock_cb, 1.0, "https://healthcheck.example.com")
+
+        assert await hc.check_health(db) is True
+        # Base URL must be set correctly
+        assert hc._http_client.client.base_url == "https://healthcheck.example.com:1234"
+        # Calls: first to list bdbs, then to availability
+        assert mock_http.get.call_count == 2
+        first_call = mock_http.get.call_args_list[0]
+        second_call = mock_http.get.call_args_list[1]
+        assert first_call.args[0] == "/v1/bdbs"
+        assert (
+            second_call.args[0]
+            == "/v1/bdbs/bdb-1/availability?extend_check=lag&availability_lag_tolerance_ms=150"
+        )
+        assert second_call.kwargs.get("expect_json") is False
+
+    @pytest.mark.asyncio
+    async def test_database_is_healthy_when_bdb_matches_by_addr(
+        self, mock_client, mock_cb
+    ):
+        """
+        Ensures health check succeeds when endpoint addr list contains the database host.
+        """
+        host_ip = "203.0.113.5"
+        mock_client.get_connection_kwargs.return_value = {"host": host_ip}
+
+        mock_http = AsyncMock()
+        mock_http.get.side_effect = [
+            [
+                {
+                    "uid": "bdb-42",
+                    "endpoints": [
+                        {"dns_name": "not-matching.example.com", "addr": [host_ip]},
+                    ],
+                }
+            ],
+            None,
+        ]
+
+        hc = LagAwareHealthCheck()
+        hc._http_client = mock_http
+
+        db = Database(mock_client, mock_cb, 1.0, "https://healthcheck.example.com")
+
+        assert await hc.check_health(db) is True
+        assert mock_http.get.call_count == 2
+        assert (
+            mock_http.get.call_args_list[1].args[0]
+            == "/v1/bdbs/bdb-42/availability?extend_check=lag&availability_lag_tolerance_ms=5000"
+        )
+
+    @pytest.mark.asyncio
+    async def test_raises_value_error_when_no_matching_bdb(self, mock_client, mock_cb):
+        """
+        Ensures health check raises ValueError when there's no bdb matching the database host.
+        """
+        host = "db2.example.com"
+        mock_client.get_connection_kwargs.return_value = {"host": host}
+
+        mock_http = AsyncMock()
+        # Return bdbs that do not match host by dns_name nor addr
+        mock_http.get.return_value = [
+            {
+                "uid": "a",
+                "endpoints": [{"dns_name": "other.example.com", "addr": ["10.0.0.9"]}],
+            },
+            {
+                "uid": "b",
+                "endpoints": [
+                    {"dns_name": "another.example.com", "addr": ["10.0.0.10"]}
+                ],
+            },
+        ]
+
+        hc = LagAwareHealthCheck()
+        hc._http_client = mock_http
+
+        db = Database(mock_client, mock_cb, 1.0, "https://healthcheck.example.com")
+
+        with pytest.raises(ValueError, match="Could not find a matching bdb"):
+            await hc.check_health(db)
+
+        # Only the listing call should have happened
+        mock_http.get.assert_called_once_with("/v1/bdbs")
+
+    @pytest.mark.asyncio
+    async def test_propagates_http_error_from_availability(self, mock_client, mock_cb):
+        """
+        Ensures that any HTTP error raised by the availability endpoint is propagated.
+        """
+        host = "db3.example.com"
+        mock_client.get_connection_kwargs.return_value = {"host": host}
+
+        mock_http = AsyncMock()
+        # First: list bdbs -> match by dns_name
+        mock_http.get.side_effect = [
+            [{"uid": "bdb-err", "endpoints": [{"dns_name": host, "addr": []}]}],
+            # Second: availability -> raise HttpError
+            HttpError(
+                url=f"https://{host}:9443/v1/bdbs/bdb-err/availability",
+                status=503,
+                message="busy",
+            ),
+        ]
+
+        hc = LagAwareHealthCheck()
+        hc._http_client = mock_http
+
+        db = Database(mock_client, mock_cb, 1.0, "https://healthcheck.example.com")
+
+        with pytest.raises(HttpError, match="busy") as e:
+            await hc.check_health(db)
+            assert e.status == 503
+
+        # Ensure both calls were attempted
+        assert mock_http.get.call_count == 2
diff --git a/tests/test_asyncio/test_multidb/test_pipeline.py b/tests/test_asyncio/test_multidb/test_pipeline.py
new file mode 100644
index 0000000000..528f8e813b
--- /dev/null
+++ b/tests/test_asyncio/test_multidb/test_pipeline.py
@@ -0,0 +1,488 @@
+import asyncio
+from unittest.mock import Mock, AsyncMock, patch
+
+import pybreaker
+import pytest
+
+from redis.asyncio.client import Pipeline
+from redis.asyncio.multidb.client import MultiDBClient
+from redis.asyncio.multidb.failover import WeightBasedFailoverStrategy
+from redis.multidb.circuit import State as CBState, PBCircuitBreakerAdapter
+from tests.test_asyncio.test_multidb.conftest import create_weighted_list
+
+
+def mock_pipe() -> Pipeline:
+    mock_pipe = Mock(spec=Pipeline)
+    mock_pipe.__aenter__ = AsyncMock(return_value=mock_pipe)
+    mock_pipe.__aexit__ = AsyncMock(return_value=None)
+    return mock_pipe
+
+
+@pytest.mark.onlynoncluster
+class TestPipeline:
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_executes_pipeline_against_correct_db(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            pipe = mock_pipe()
+            pipe.execute.return_value = ["OK1", "value1"]
+            mock_db1.client.pipeline.return_value = pipe
+
+            mock_hc.check_health.return_value = True
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+
+            pipe = client.pipeline()
+            pipe.set("key1", "value1")
+            pipe.get("key1")
+
+            assert await pipe.execute() == ["OK1", "value1"]
+            assert mock_hc.check_health.call_count == 9
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.OPEN}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_execute_pipeline_against_correct_db_and_closed_circuit(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            pipe = mock_pipe()
+            pipe.execute.return_value = ["OK1", "value1"]
+            mock_db1.client.pipeline.return_value = pipe
+
+            mock_hc.check_health.side_effect = [
+                False,
+                True,
+                True,
+                True,
+                True,
+                True,
+                True,
+            ]
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+
+            async with client.pipeline() as pipe:
+                pipe.set("key1", "value1")
+                pipe.get("key1")
+
+            assert await pipe.execute() == ["OK1", "value1"]
+            assert mock_hc.check_health.call_count == 7
+
+            assert mock_db.circuit.state == CBState.CLOSED
+            assert mock_db1.circuit.state == CBState.CLOSED
+            assert mock_db2.circuit.state == CBState.OPEN
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {"health_check_probes": 1},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_execute_pipeline_against_correct_db_on_background_health_check_determine_active_db_unhealthy(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        cb = PBCircuitBreakerAdapter(pybreaker.CircuitBreaker(reset_timeout=5))
+        cb.database = mock_db
+        mock_db.circuit = cb
+
+        cb1 = PBCircuitBreakerAdapter(pybreaker.CircuitBreaker(reset_timeout=5))
+        cb1.database = mock_db1
+        mock_db1.circuit = cb1
+
+        cb2 = PBCircuitBreakerAdapter(pybreaker.CircuitBreaker(reset_timeout=5))
+        cb2.database = mock_db2
+        mock_db2.circuit = cb2
+
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        # Track health check runs across all databases
+        health_check_run = 0
+
+        # Create events for each failover scenario
+        db1_became_unhealthy = asyncio.Event()
+        db2_became_unhealthy = asyncio.Event()
+        db_became_unhealthy = asyncio.Event()
+        counter_lock = asyncio.Lock()
+
+        async def mock_check_health(database):
+            nonlocal health_check_run
+
+            # Increment run counter for each health check call
+            async with counter_lock:
+                health_check_run += 1
+                current_run = health_check_run
+
+            # Run 1 (health_check_run 1-3): All databases healthy
+            if current_run <= 3:
+                return True
+
+            # Run 2 (health_check_run 4-6): mock_db1 unhealthy, others healthy
+            elif current_run <= 6:
+                if database == mock_db1:
+                    if current_run == 6:
+                        db1_became_unhealthy.set()
+                    return False
+
+                # Signal that db1 has become unhealthy after all 3 checks
+                if current_run == 6:
+                    db1_became_unhealthy.set()
+                return True
+
+            # Run 3 (health_check_run 7-9): mock_db1 and mock_db2 unhealthy, mock_db healthy
+            elif current_run <= 9:
+                if database == mock_db1 or database == mock_db2:
+                    if current_run == 9:
+                        db2_became_unhealthy.set()
+                    return False
+
+                # Signal that db2 has become unhealthy after all 3 checks
+                if current_run == 9:
+                    db2_became_unhealthy.set()
+                return True
+
+            # Run 4 (health_check_run 10-12): mock_db unhealthy, others healthy
+            else:
+                if database == mock_db:
+                    if current_run >= 12:
+                        db_became_unhealthy.set()
+                    return False
+
+                # Signal that db has become unhealthy after all 3 checks
+                if current_run >= 12:
+                    db_became_unhealthy.set()
+                return True
+
+        mock_hc.check_health.side_effect = mock_check_health
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config,
+                "default_health_checks",
+                return_value=[mock_hc],
+            ),
+        ):
+            pipe = mock_pipe()
+            pipe.execute.return_value = ["OK", "value"]
+            mock_db.client.pipeline.return_value = pipe
+
+            pipe1 = mock_pipe()
+            pipe1.execute.return_value = ["OK1", "value"]
+            mock_db1.client.pipeline.return_value = pipe1
+
+            pipe2 = mock_pipe()
+            pipe2.execute.return_value = ["OK2", "value"]
+            mock_db2.client.pipeline.return_value = pipe2
+
+            mock_multi_db_config.health_check_interval = 0.1
+            mock_multi_db_config.failover_strategy = WeightBasedFailoverStrategy()
+
+            client = MultiDBClient(mock_multi_db_config)
+
+            async with client.pipeline() as pipe:
+                pipe.set("key1", "value")
+                pipe.get("key1")
+
+            # Run 1: All databases healthy - should use mock_db1 (highest weight 0.7)
+            assert await pipe.execute() == ["OK1", "value"]
+
+            # Wait for mock_db1 to become unhealthy
+            assert await db1_became_unhealthy.wait(), (
+                "Timeout waiting for mock_db1 to become unhealthy"
+            )
+            await asyncio.sleep(0.01)
+
+            # Run 2: mock_db1 unhealthy - should failover to mock_db2 (weight 0.5)
+            assert await pipe.execute() == ["OK2", "value"]
+
+            # Wait for mock_db2 to become unhealthy
+            assert await db2_became_unhealthy.wait(), (
+                "Timeout waiting for mock_db2 to become unhealthy"
+            )
+            await asyncio.sleep(0.01)
+
+            # Run 3: mock_db1 and mock_db2 unhealthy - should use mock_db (weight 0.2)
+            assert await pipe.execute() == ["OK", "value"]
+
+            # Wait for mock_db to become unhealthy
+            assert await db_became_unhealthy.wait(), (
+                "Timeout waiting for mock_db to become unhealthy"
+            )
+            await asyncio.sleep(0.01)
+
+            # Run 4: mock_db unhealthy, others healthy - should use mock_db1 (highest weight)
+            assert await pipe.execute() == ["OK1", "value"]
+
+
+@pytest.mark.onlynoncluster
+class TestTransaction:
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_executes_transaction_against_correct_db(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_db1.client.transaction.return_value = ["OK1", "value1"]
+
+            mock_hc.check_health.return_value = True
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+
+            async def callback(pipe: Pipeline):
+                pipe.set("key1", "value1")
+                pipe.get("key1")
+
+            assert await client.transaction(callback) == ["OK1", "value1"]
+            assert mock_hc.check_health.call_count == 9
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.OPEN}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_execute_transaction_against_correct_db_and_closed_circuit(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_db1.client.transaction.return_value = ["OK1", "value1"]
+
+            mock_hc.check_health.side_effect = [
+                False,
+                True,
+                True,
+                True,
+                True,
+                True,
+                True,
+            ]
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+
+            async def callback(pipe: Pipeline):
+                pipe.set("key1", "value1")
+                pipe.get("key1")
+
+            assert await client.transaction(callback) == ["OK1", "value1"]
+            assert mock_hc.check_health.call_count == 7
+
+            assert mock_db.circuit.state == CBState.CLOSED
+            assert mock_db1.circuit.state == CBState.CLOSED
+            assert mock_db2.circuit.state == CBState.OPEN
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {"health_check_probes": 1},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_execute_transaction_against_correct_db_on_background_health_check_determine_active_db_unhealthy(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        cb = PBCircuitBreakerAdapter(pybreaker.CircuitBreaker(reset_timeout=5))
+        cb.database = mock_db
+        mock_db.circuit = cb
+
+        cb1 = PBCircuitBreakerAdapter(pybreaker.CircuitBreaker(reset_timeout=5))
+        cb1.database = mock_db1
+        mock_db1.circuit = cb1
+
+        cb2 = PBCircuitBreakerAdapter(pybreaker.CircuitBreaker(reset_timeout=5))
+        cb2.database = mock_db2
+        mock_db2.circuit = cb2
+
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        # Track health check runs across all databases
+        health_check_run = 0
+
+        # Create events for each failover scenario
+        db1_became_unhealthy = asyncio.Event()
+        db2_became_unhealthy = asyncio.Event()
+        db_became_unhealthy = asyncio.Event()
+        counter_lock = asyncio.Lock()
+
+        async def mock_check_health(database):
+            nonlocal health_check_run
+
+            # Increment run counter for each health check call
+            async with counter_lock:
+                health_check_run += 1
+                current_run = health_check_run
+
+            # Run 1 (health_check_run 1-3): All databases healthy
+            if current_run <= 3:
+                return True
+
+            # Run 2 (health_check_run 4-6): mock_db1 unhealthy, others healthy
+            elif current_run <= 6:
+                if database == mock_db1:
+                    if current_run == 6:
+                        db1_became_unhealthy.set()
+                    return False
+
+                # Signal that db1 has become unhealthy after all 3 checks
+                if current_run == 6:
+                    db1_became_unhealthy.set()
+                return True
+
+            # Run 3 (health_check_run 7-9): mock_db1 and mock_db2 unhealthy, mock_db healthy
+            elif current_run <= 9:
+                if database == mock_db1 or database == mock_db2:
+                    if current_run == 9:
+                        db2_became_unhealthy.set()
+                    return False
+
+                # Signal that db2 has become unhealthy after all 3 checks
+                if current_run == 9:
+                    db2_became_unhealthy.set()
+                return True
+
+            # Run 4 (health_check_run 10-12): mock_db unhealthy, others healthy
+            else:
+                if database == mock_db:
+                    if current_run >= 12:
+                        db_became_unhealthy.set()
+                    return False
+
+                # Signal that db has become unhealthy after all 3 checks
+                if current_run >= 12:
+                    db_became_unhealthy.set()
+                return True
+
+        mock_hc.check_health.side_effect = mock_check_health
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config,
+                "default_health_checks",
+                return_value=[mock_hc],
+            ),
+        ):
+            mock_db.client.transaction.return_value = ["OK", "value"]
+            mock_db1.client.transaction.return_value = ["OK1", "value"]
+            mock_db2.client.transaction.return_value = ["OK2", "value"]
+
+            mock_multi_db_config.health_check_interval = 0.1
+            mock_multi_db_config.failover_strategy = WeightBasedFailoverStrategy()
+
+            client = MultiDBClient(mock_multi_db_config)
+
+            async def callback(pipe: Pipeline):
+                pipe.set("key1", "value1")
+                pipe.get("key1")
+
+            assert await client.transaction(callback) == ["OK1", "value"]
+
+            # Wait for mock_db1 to become unhealthy
+            assert await db1_became_unhealthy.wait(), (
+                "Timeout waiting for mock_db1 to become unhealthy"
+            )
+            await asyncio.sleep(0.01)
+
+            assert await client.transaction(callback) == ["OK2", "value"]
+
+            # Wait for mock_db2 to become unhealthy
+            assert await db2_became_unhealthy.wait(), (
+                "Timeout waiting for mock_db1 to become unhealthy"
+            )
+            await asyncio.sleep(0.01)
+
+            assert await client.transaction(callback) == ["OK", "value"]
+
+            # Wait for mock_db to become unhealthy
+            assert await db_became_unhealthy.wait(), (
+                "Timeout waiting for mock_db1 to become unhealthy"
+            )
+            await asyncio.sleep(0.01)
+
+            assert await client.transaction(callback) == ["OK1", "value"]
diff --git a/tests/test_asyncio/test_scenario/__init__.py b/tests/test_asyncio/test_scenario/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/tests/test_asyncio/test_scenario/conftest.py b/tests/test_asyncio/test_scenario/conftest.py
new file mode 100644
index 0000000000..803445f508
--- /dev/null
+++ b/tests/test_asyncio/test_scenario/conftest.py
@@ -0,0 +1,116 @@
+import asyncio
+import os
+from typing import Any, AsyncGenerator
+
+import pytest
+import pytest_asyncio
+
+from redis.asyncio import Redis
+from redis.asyncio.multidb.client import MultiDBClient
+from redis.asyncio.multidb.config import (
+    DatabaseConfig,
+    MultiDbConfig,
+)
+from redis.asyncio.multidb.event import AsyncActiveDatabaseChanged
+from redis.asyncio.retry import Retry
+from redis.backoff import ExponentialBackoff
+from redis.event import AsyncEventListenerInterface, EventDispatcher
+from redis.multidb.failure_detector import DEFAULT_MIN_NUM_FAILURES
+from tests.test_scenario.conftest import get_endpoints_config, extract_cluster_fqdn
+from tests.test_scenario.fault_injector_client import FaultInjectorClient
+
+
+class CheckActiveDatabaseChangedListener(AsyncEventListenerInterface):
+    def __init__(self):
+        self.is_changed_flag = False
+
+    async def listen(self, event: AsyncActiveDatabaseChanged):
+        self.is_changed_flag = True
+
+
+@pytest.fixture()
+def fault_injector_client():
+    url = os.getenv("FAULT_INJECTION_API_URL", "http://127.0.0.1:20324")
+    return FaultInjectorClient(url)
+
+
+@pytest_asyncio.fixture()
+async def r_multi_db(
+    request,
+) -> AsyncGenerator[tuple[MultiDBClient, CheckActiveDatabaseChangedListener, Any], Any]:
+    client_class = request.param.get("client_class", Redis)
+
+    if client_class == Redis:
+        endpoint_config = get_endpoints_config("re-active-active")
+    else:
+        endpoint_config = get_endpoints_config("re-active-active-oss-cluster")
+
+    username = endpoint_config.get("username", None)
+    password = endpoint_config.get("password", None)
+    min_num_failures = request.param.get("min_num_failures", DEFAULT_MIN_NUM_FAILURES)
+    command_retry = request.param.get(
+        "command_retry", Retry(ExponentialBackoff(cap=0.1, base=0.01), retries=10)
+    )
+
+    # Retry configuration different for health checks as initial health check require more time in case
+    # if infrastructure wasn't restored from the previous test.
+    health_check_interval = request.param.get("health_check_interval", 10)
+    health_checks = request.param.get("health_checks", [])
+    event_dispatcher = EventDispatcher()
+    listener = CheckActiveDatabaseChangedListener()
+    event_dispatcher.register_listeners(
+        {
+            AsyncActiveDatabaseChanged: [listener],
+        }
+    )
+    db_configs = []
+
+    db_config = DatabaseConfig(
+        weight=1.0,
+        from_url=endpoint_config["endpoints"][0],
+        client_kwargs={
+            "username": username,
+            "password": password,
+            "decode_responses": True,
+        },
+        health_check_url=extract_cluster_fqdn(endpoint_config["endpoints"][0]),
+    )
+    db_configs.append(db_config)
+
+    db_config1 = DatabaseConfig(
+        weight=0.9,
+        from_url=endpoint_config["endpoints"][1],
+        client_kwargs={
+            "username": username,
+            "password": password,
+            "decode_responses": True,
+        },
+        health_check_url=extract_cluster_fqdn(endpoint_config["endpoints"][1]),
+    )
+    db_configs.append(db_config1)
+
+    config = MultiDbConfig(
+        client_class=client_class,
+        databases_config=db_configs,
+        command_retry=command_retry,
+        min_num_failures=min_num_failures,
+        health_checks=health_checks,
+        health_check_probes=3,
+        health_check_interval=health_check_interval,
+        event_dispatcher=event_dispatcher,
+    )
+
+    client = MultiDBClient(config)
+
+    async def teardown():
+        await client.aclose()
+
+        if client.command_executor.active_database and isinstance(
+            client.command_executor.active_database.client, Redis
+        ):
+            await client.command_executor.active_database.client.connection_pool.disconnect()
+
+        await asyncio.sleep(10)
+
+    yield client, listener, endpoint_config
+    await teardown()
diff --git a/tests/test_asyncio/test_scenario/test_active_active.py b/tests/test_asyncio/test_scenario/test_active_active.py
new file mode 100644
index 0000000000..c33e482050
--- /dev/null
+++ b/tests/test_asyncio/test_scenario/test_active_active.py
@@ -0,0 +1,420 @@
+import asyncio
+import json
+import logging
+import os
+
+import pytest
+
+from redis.asyncio import RedisCluster
+from redis.asyncio.client import Pipeline, Redis
+from redis.asyncio.multidb.failover import (
+    DEFAULT_FAILOVER_ATTEMPTS,
+    DEFAULT_FAILOVER_DELAY,
+)
+from redis.asyncio.multidb.healthcheck import LagAwareHealthCheck
+from redis.asyncio.retry import Retry
+from redis.backoff import ConstantBackoff
+from redis.multidb.exception import TemporaryUnavailableException
+from redis.utils import dummy_fail_async
+from tests.test_scenario.fault_injector_client import ActionRequest, ActionType
+
+logger = logging.getLogger(__name__)
+
+
+async def trigger_network_failure_action(
+    fault_injector_client, config, event: asyncio.Event = None
+):
+    action_request = ActionRequest(
+        action_type=ActionType.NETWORK_FAILURE,
+        parameters={"bdb_id": config["bdb_id"], "delay": 3, "cluster_index": 0},
+    )
+
+    result = fault_injector_client.trigger_action(action_request)
+    status_result = fault_injector_client.get_action_status(result["action_id"])
+
+    while status_result["status"] != "success":
+        await asyncio.sleep(0.1)
+        status_result = fault_injector_client.get_action_status(result["action_id"])
+        logger.info(
+            f"Waiting for action to complete. Status: {status_result['status']}"
+        )
+
+    if event:
+        event.set()
+
+    logger.info(f"Action completed. Status: {status_result['status']}")
+
+
+class TestActiveActive:
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "r_multi_db",
+        [
+            {"client_class": Redis, "min_num_failures": 2},
+            {"client_class": RedisCluster, "min_num_failures": 2},
+        ],
+        ids=["standalone", "cluster"],
+        indirect=True,
+    )
+    @pytest.mark.timeout(200)
+    async def test_multi_db_client_failover_to_another_db(
+        self, r_multi_db, fault_injector_client
+    ):
+        client, listener, endpoint_config = r_multi_db
+
+        # Handle unavailable databases from previous test.
+        retry = Retry(
+            supported_errors=(TemporaryUnavailableException,),
+            retries=DEFAULT_FAILOVER_ATTEMPTS,
+            backoff=ConstantBackoff(backoff=DEFAULT_FAILOVER_DELAY),
+        )
+
+        async with client as r_multi_db:
+            event = asyncio.Event()
+            asyncio.create_task(
+                trigger_network_failure_action(
+                    fault_injector_client, endpoint_config, event
+                )
+            )
+
+            await retry.call_with_retry(
+                lambda: r_multi_db.set("key", "value"), lambda _: dummy_fail_async()
+            )
+
+            # Execute commands before network failure
+            while not event.is_set():
+                assert (
+                    await retry.call_with_retry(
+                        lambda: r_multi_db.get("key"), lambda _: dummy_fail_async()
+                    )
+                    == "value"
+                )
+                await asyncio.sleep(0.5)
+
+            # Execute commands until database failover
+            while not listener.is_changed_flag:
+                assert (
+                    await retry.call_with_retry(
+                        lambda: r_multi_db.get("key"), lambda _: dummy_fail_async()
+                    )
+                    == "value"
+                )
+                await asyncio.sleep(0.5)
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "r_multi_db",
+        [
+            {
+                "client_class": Redis,
+                "min_num_failures": 2,
+                "health_checks": [
+                    LagAwareHealthCheck(
+                        verify_tls=False,
+                        auth_basic=(
+                            os.getenv("ENV0_USERNAME"),
+                            os.getenv("ENV0_PASSWORD"),
+                        ),
+                    )
+                ],
+                "health_check_interval": 20,
+            },
+            {
+                "client_class": RedisCluster,
+                "min_num_failures": 2,
+                "health_checks": [
+                    LagAwareHealthCheck(
+                        verify_tls=False,
+                        auth_basic=(
+                            os.getenv("ENV0_USERNAME"),
+                            os.getenv("ENV0_PASSWORD"),
+                        ),
+                    )
+                ],
+                "health_check_interval": 20,
+            },
+        ],
+        ids=["standalone", "cluster"],
+        indirect=True,
+    )
+    @pytest.mark.timeout(200)
+    async def test_multi_db_client_uses_lag_aware_health_check(
+        self, r_multi_db, fault_injector_client
+    ):
+        client, listener, endpoint_config = r_multi_db
+        retry = Retry(
+            supported_errors=(TemporaryUnavailableException,),
+            retries=DEFAULT_FAILOVER_ATTEMPTS,
+            backoff=ConstantBackoff(backoff=DEFAULT_FAILOVER_DELAY),
+        )
+
+        async with client as r_multi_db:
+            event = asyncio.Event()
+            asyncio.create_task(
+                trigger_network_failure_action(
+                    fault_injector_client, endpoint_config, event
+                )
+            )
+
+            await retry.call_with_retry(
+                lambda: r_multi_db.set("key", "value"), lambda _: dummy_fail_async()
+            )
+
+            # Execute commands before network failure
+            while not event.is_set():
+                assert (
+                    await retry.call_with_retry(
+                        lambda: r_multi_db.get("key"), lambda _: dummy_fail_async()
+                    )
+                    == "value"
+                )
+                await asyncio.sleep(0.5)
+
+            # Execute commands after network failure
+            while not listener.is_changed_flag:
+                assert (
+                    await retry.call_with_retry(
+                        lambda: r_multi_db.get("key"), lambda _: dummy_fail_async()
+                    )
+                    == "value"
+                )
+                await asyncio.sleep(0.5)
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "r_multi_db",
+        [
+            {"client_class": Redis, "min_num_failures": 2},
+            {"client_class": RedisCluster, "min_num_failures": 2},
+        ],
+        ids=["standalone", "cluster"],
+        indirect=True,
+    )
+    @pytest.mark.timeout(200)
+    async def test_context_manager_pipeline_failover_to_another_db(
+        self, r_multi_db, fault_injector_client
+    ):
+        client, listener, endpoint_config = r_multi_db
+        retry = Retry(
+            supported_errors=(TemporaryUnavailableException,),
+            retries=DEFAULT_FAILOVER_ATTEMPTS,
+            backoff=ConstantBackoff(backoff=DEFAULT_FAILOVER_DELAY),
+        )
+
+        async def callback():
+            async with r_multi_db.pipeline() as pipe:
+                pipe.set("{hash}key1", "value1")
+                pipe.set("{hash}key2", "value2")
+                pipe.set("{hash}key3", "value3")
+                pipe.get("{hash}key1")
+                pipe.get("{hash}key2")
+                pipe.get("{hash}key3")
+                assert await pipe.execute() == [
+                    True,
+                    True,
+                    True,
+                    "value1",
+                    "value2",
+                    "value3",
+                ]
+
+        async with client as r_multi_db:
+            event = asyncio.Event()
+            asyncio.create_task(
+                trigger_network_failure_action(
+                    fault_injector_client, endpoint_config, event
+                )
+            )
+
+            # Execute pipeline before network failure
+            while not event.is_set():
+                await retry.call_with_retry(
+                    lambda: callback(), lambda _: dummy_fail_async()
+                )
+                await asyncio.sleep(0.5)
+
+            # Execute commands until database failover
+            while not listener.is_changed_flag:
+                await retry.call_with_retry(
+                    lambda: callback(), lambda _: dummy_fail_async()
+                )
+                await asyncio.sleep(0.5)
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "r_multi_db",
+        [
+            {"client_class": Redis, "min_num_failures": 2},
+            {"client_class": RedisCluster, "min_num_failures": 2},
+        ],
+        ids=["standalone", "cluster"],
+        indirect=True,
+    )
+    @pytest.mark.timeout(200)
+    async def test_chaining_pipeline_failover_to_another_db(
+        self, r_multi_db, fault_injector_client
+    ):
+        client, listener, endpoint_config = r_multi_db
+        retry = Retry(
+            supported_errors=(TemporaryUnavailableException,),
+            retries=DEFAULT_FAILOVER_ATTEMPTS,
+            backoff=ConstantBackoff(backoff=DEFAULT_FAILOVER_DELAY),
+        )
+
+        async def callback():
+            pipe = r_multi_db.pipeline()
+            pipe.set("{hash}key1", "value1")
+            pipe.set("{hash}key2", "value2")
+            pipe.set("{hash}key3", "value3")
+            pipe.get("{hash}key1")
+            pipe.get("{hash}key2")
+            pipe.get("{hash}key3")
+            assert await pipe.execute() == [
+                True,
+                True,
+                True,
+                "value1",
+                "value2",
+                "value3",
+            ]
+
+        async with client as r_multi_db:
+            event = asyncio.Event()
+            asyncio.create_task(
+                trigger_network_failure_action(
+                    fault_injector_client, endpoint_config, event
+                )
+            )
+
+            # Execute pipeline before network failure
+            while not event.is_set():
+                await retry.call_with_retry(
+                    lambda: callback(), lambda _: dummy_fail_async()
+                )
+                await asyncio.sleep(0.5)
+
+            # Execute pipeline until database failover
+            while not listener.is_changed_flag:
+                await retry.call_with_retry(
+                    lambda: callback(), lambda _: dummy_fail_async()
+                )
+                await asyncio.sleep(0.5)
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "r_multi_db",
+        [
+            {"client_class": Redis, "min_num_failures": 2},
+            {"client_class": RedisCluster, "min_num_failures": 2},
+        ],
+        ids=["standalone", "cluster"],
+        indirect=True,
+    )
+    @pytest.mark.timeout(200)
+    async def test_transaction_failover_to_another_db(
+        self, r_multi_db, fault_injector_client
+    ):
+        client, listener, endpoint_config = r_multi_db
+
+        retry = Retry(
+            supported_errors=(TemporaryUnavailableException,),
+            retries=DEFAULT_FAILOVER_ATTEMPTS,
+            backoff=ConstantBackoff(backoff=DEFAULT_FAILOVER_DELAY),
+        )
+
+        async def callback(pipe: Pipeline):
+            pipe.set("{hash}key1", "value1")
+            pipe.set("{hash}key2", "value2")
+            pipe.set("{hash}key3", "value3")
+            pipe.get("{hash}key1")
+            pipe.get("{hash}key2")
+            pipe.get("{hash}key3")
+
+        async with client as r_multi_db:
+            event = asyncio.Event()
+            asyncio.create_task(
+                trigger_network_failure_action(
+                    fault_injector_client, endpoint_config, event
+                )
+            )
+
+            # Execute transaction before network failure
+            while not event.is_set():
+                await retry.call_with_retry(
+                    lambda: r_multi_db.transaction(callback),
+                    lambda _: dummy_fail_async(),
+                )
+                await asyncio.sleep(0.5)
+
+            # Execute transaction until database failover
+            while not listener.is_changed_flag:
+                assert await retry.call_with_retry(
+                    lambda: r_multi_db.transaction(callback),
+                    lambda _: dummy_fail_async(),
+                ) == [True, True, True, "value1", "value2", "value3"]
+                await asyncio.sleep(0.5)
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize("r_multi_db", [{"min_num_failures": 2}], indirect=True)
+    @pytest.mark.timeout(200)
+    async def test_pubsub_failover_to_another_db(
+        self, r_multi_db, fault_injector_client
+    ):
+        client, listener, endpoint_config = r_multi_db
+        retry = Retry(
+            supported_errors=(TemporaryUnavailableException,),
+            retries=DEFAULT_FAILOVER_ATTEMPTS,
+            backoff=ConstantBackoff(backoff=DEFAULT_FAILOVER_DELAY),
+        )
+
+        data = json.dumps({"message": "test"})
+        messages_count = 0
+
+        async def handler(message):
+            nonlocal messages_count
+            messages_count += 1
+
+        async with client as r_multi_db:
+            event = asyncio.Event()
+            asyncio.create_task(
+                trigger_network_failure_action(
+                    fault_injector_client, endpoint_config, event
+                )
+            )
+
+            pubsub = await r_multi_db.pubsub()
+
+            # Assign a handler and run in a separate thread.
+            await retry.call_with_retry(
+                lambda: pubsub.subscribe(**{"test-channel": handler}),
+                lambda _: dummy_fail_async(),
+            )
+            task = asyncio.create_task(pubsub.run(poll_timeout=0.1))
+
+            # Execute publish before network failure
+            while not event.is_set():
+                await retry.call_with_retry(
+                    lambda: r_multi_db.publish("test-channel", data),
+                    lambda _: dummy_fail_async(),
+                )
+                await asyncio.sleep(0.5)
+
+            # Execute publish until database failover
+            while not listener.is_changed_flag:
+                await retry.call_with_retry(
+                    lambda: r_multi_db.publish("test-channel", data),
+                    lambda _: dummy_fail_async(),
+                )
+                await asyncio.sleep(0.5)
+
+            # After db changed still generates some traffic.
+            for _ in range(5):
+                await retry.call_with_retry(
+                    lambda: r_multi_db.publish("test-channel", data),
+                    lambda _: dummy_fail_async(),
+                )
+
+            # A timeout to ensure that an async handler will handle all previous messages.
+            await asyncio.sleep(0.1)
+            task.cancel()
+            assert messages_count >= 2
diff --git a/tests/test_background.py b/tests/test_background.py
new file mode 100644
index 0000000000..bac9c1eef6
--- /dev/null
+++ b/tests/test_background.py
@@ -0,0 +1,94 @@
+import asyncio
+from time import sleep
+
+import pytest
+
+from redis.background import BackgroundScheduler
+
+
+class TestBackgroundScheduler:
+    def test_run_once(self):
+        execute_counter = 0
+        one = "arg1"
+        two = 9999
+
+        def callback(arg1: str, arg2: int):
+            nonlocal execute_counter
+            nonlocal one
+            nonlocal two
+
+            execute_counter += 1
+
+            assert arg1 == one
+            assert arg2 == two
+
+        scheduler = BackgroundScheduler()
+        scheduler.run_once(0.1, callback, one, two)
+        assert execute_counter == 0
+
+        sleep(0.15)
+
+        assert execute_counter == 1
+
+    @pytest.mark.parametrize(
+        "interval,timeout,call_count",
+        [
+            (0.012, 0.04, 3),
+            (0.035, 0.04, 1),
+            (0.045, 0.04, 0),
+        ],
+    )
+    def test_run_recurring(self, interval, timeout, call_count):
+        execute_counter = 0
+        one = "arg1"
+        two = 9999
+
+        def callback(arg1: str, arg2: int):
+            nonlocal execute_counter
+            nonlocal one
+            nonlocal two
+
+            execute_counter += 1
+
+            assert arg1 == one
+            assert arg2 == two
+
+        scheduler = BackgroundScheduler()
+        scheduler.run_recurring(interval, callback, one, two)
+        assert execute_counter == 0
+
+        sleep(timeout)
+
+        assert execute_counter == call_count
+
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "interval,timeout,call_count",
+        [
+            (0.012, 0.04, 3),
+            (0.035, 0.04, 1),
+            (0.045, 0.04, 0),
+        ],
+    )
+    async def test_run_recurring_async(self, interval, timeout, call_count):
+        execute_counter = 0
+        one = "arg1"
+        two = 9999
+
+        async def callback(arg1: str, arg2: int):
+            nonlocal execute_counter
+            nonlocal one
+            nonlocal two
+
+            execute_counter += 1
+
+            assert arg1 == one
+            assert arg2 == two
+
+        scheduler = BackgroundScheduler()
+        await scheduler.run_recurring_async(interval, callback, one, two)
+        assert execute_counter == 0
+
+        await asyncio.sleep(timeout)
+
+        assert execute_counter == call_count
diff --git a/tests/test_data_structure.py b/tests/test_data_structure.py
new file mode 100644
index 0000000000..0911466e58
--- /dev/null
+++ b/tests/test_data_structure.py
@@ -0,0 +1,94 @@
+import concurrent
+import random
+from concurrent.futures import ThreadPoolExecutor
+from time import sleep
+
+from redis.data_structure import WeightedList
+
+
+class TestWeightedList:
+    def test_add_items(self):
+        wlist = WeightedList()
+
+        wlist.add("item1", 3.0)
+        wlist.add("item2", 2.0)
+        wlist.add("item3", 4.0)
+        wlist.add("item4", 4.0)
+
+        assert wlist.get_top_n(4) == [
+            ("item3", 4.0),
+            ("item4", 4.0),
+            ("item1", 3.0),
+            ("item2", 2.0),
+        ]
+
+    def test_remove_items(self):
+        wlist = WeightedList()
+        wlist.add("item1", 3.0)
+        wlist.add("item2", 2.0)
+        wlist.add("item3", 4.0)
+        wlist.add("item4", 4.0)
+
+        assert wlist.remove("item2") == 2.0
+        assert wlist.remove("item4") == 4.0
+
+        assert wlist.get_top_n(4) == [("item3", 4.0), ("item1", 3.0)]
+
+    def test_get_by_weight_range(self):
+        wlist = WeightedList()
+        wlist.add("item1", 3.0)
+        wlist.add("item2", 2.0)
+        wlist.add("item3", 4.0)
+        wlist.add("item4", 4.0)
+
+        assert wlist.get_by_weight_range(2.0, 3.0) == [("item1", 3.0), ("item2", 2.0)]
+
+    def test_update_weights(self):
+        wlist = WeightedList()
+        wlist.add("item1", 3.0)
+        wlist.add("item2", 2.0)
+        wlist.add("item3", 4.0)
+        wlist.add("item4", 4.0)
+
+        assert wlist.get_top_n(4) == [
+            ("item3", 4.0),
+            ("item4", 4.0),
+            ("item1", 3.0),
+            ("item2", 2.0),
+        ]
+
+        wlist.update_weight("item2", 5.0)
+
+        assert wlist.get_top_n(4) == [
+            ("item2", 5.0),
+            ("item3", 4.0),
+            ("item4", 4.0),
+            ("item1", 3.0),
+        ]
+
+    def test_thread_safety(self) -> None:
+        """Test thread safety with concurrent operations"""
+        wl = WeightedList()
+
+        def worker(worker_id):
+            for i in range(100):
+                # Add items
+                wl.add(f"item_{worker_id}_{i}", random.uniform(0, 100))
+
+                # Read operations
+                try:
+                    length = len(wl)
+                    if length > 0:
+                        wl.get_top_n(min(5, length))
+                        wl.get_by_weight_range(20, 80)
+                except Exception as e:
+                    print(f"Error in worker {worker_id}: {e}")
+
+                sleep(0.001)  # Small delay
+
+        # Run multiple workers concurrently
+        with ThreadPoolExecutor(max_workers=5) as executor:
+            futures = [executor.submit(worker, i) for i in range(5)]
+            concurrent.futures.wait(futures)
+
+        assert len(wl) == 500
diff --git a/tests/test_event.py b/tests/test_event.py
new file mode 100644
index 0000000000..0caab04e78
--- /dev/null
+++ b/tests/test_event.py
@@ -0,0 +1,67 @@
+from unittest.mock import Mock, AsyncMock
+
+from redis.event import (
+    EventListenerInterface,
+    EventDispatcher,
+    AsyncEventListenerInterface,
+)
+
+
+class TestEventDispatcher:
+    def test_register_listeners(self):
+        mock_event = Mock(spec=object)
+        mock_event_listener = Mock(spec=EventListenerInterface)
+        listener_called = 0
+
+        def callback(event):
+            nonlocal listener_called
+            listener_called += 1
+
+        mock_event_listener.listen = callback
+
+        # Register via constructor
+        dispatcher = EventDispatcher(
+            event_listeners={type(mock_event): [mock_event_listener]}
+        )
+        dispatcher.dispatch(mock_event)
+
+        assert listener_called == 1
+
+        # Register additional listener for the same event
+        mock_another_event_listener = Mock(spec=EventListenerInterface)
+        mock_another_event_listener.listen = callback
+        dispatcher.register_listeners(
+            mappings={type(mock_event): [mock_another_event_listener]}
+        )
+        dispatcher.dispatch(mock_event)
+
+        assert listener_called == 3
+
+    async def test_register_listeners_async(self):
+        mock_event = Mock(spec=object)
+        mock_event_listener = AsyncMock(spec=AsyncEventListenerInterface)
+        listener_called = 0
+
+        async def callback(event):
+            nonlocal listener_called
+            listener_called += 1
+
+        mock_event_listener.listen = callback
+
+        # Register via constructor
+        dispatcher = EventDispatcher(
+            event_listeners={type(mock_event): [mock_event_listener]}
+        )
+        await dispatcher.dispatch_async(mock_event)
+
+        assert listener_called == 1
+
+        # Register additional listener for the same event
+        mock_another_event_listener = Mock(spec=AsyncEventListenerInterface)
+        mock_another_event_listener.listen = callback
+        dispatcher.register_listeners(
+            mappings={type(mock_event): [mock_another_event_listener]}
+        )
+        await dispatcher.dispatch_async(mock_event)
+
+        assert listener_called == 3
diff --git a/tests/test_http/__init__.py b/tests/test_http/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/tests/test_http/test_http_client.py b/tests/test_http/test_http_client.py
new file mode 100644
index 0000000000..5dc1cf1631
--- /dev/null
+++ b/tests/test_http/test_http_client.py
@@ -0,0 +1,371 @@
+import json
+import gzip
+from io import BytesIO
+from typing import Any, Dict
+from urllib.error import HTTPError
+from urllib.parse import urlparse, parse_qs
+
+import pytest
+
+from redis.backoff import ExponentialWithJitterBackoff
+from redis.http.http_client import HttpClient, HttpError
+from redis.retry import Retry
+
+
+class FakeResponse:
+    def __init__(
+        self, *, status: int, headers: Dict[str, str], url: str, content: bytes
+    ):
+        self.status = status
+        self.headers = headers
+        self._url = url
+        self._content = content
+
+    def read(self) -> bytes:
+        return self._content
+
+    def geturl(self) -> str:
+        return self._url
+
+    # Support context manager used by urlopen
+    def __enter__(self) -> "FakeResponse":
+        return self
+
+    def __exit__(self, exc_type, exc, tb) -> None:
+        return None
+
+
+class TestHttpClient:
+    def test_get_returns_parsed_json_and_uses_timeout(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        # Arrange
+        base_url = "https://api.example.com/"
+        path = "v1/items"
+        params = {"limit": 5, "q": "hello world"}
+        expected_url = f"{base_url}{path}?limit=5&q=hello+world"
+        payload: Dict[str, Any] = {"items": [1, 2, 3], "ok": True}
+        content = json.dumps(payload).encode("utf-8")
+
+        captured_kwargs = {}
+
+        def fake_urlopen(request, *, timeout=None, context=None):
+            # Capture call details for assertions
+            captured_kwargs["timeout"] = timeout
+            captured_kwargs["context"] = context
+            # Assert the request was constructed correctly
+            assert getattr(request, "method", "").upper() == "GET"
+            assert request.full_url == expected_url
+            # Return a successful response
+            return FakeResponse(
+                status=200,
+                headers={"Content-Type": "application/json; charset=utf-8"},
+                url=expected_url,
+                content=content,
+            )
+
+        # Patch the urlopen used inside HttpClient
+        monkeypatch.setattr("redis.http.http_client.urlopen", fake_urlopen)
+
+        client = HttpClient(base_url=base_url)
+
+        # Act
+        result = client.get(
+            path, params=params, timeout=12.34
+        )  # default expect_json=True
+
+        # Assert
+        assert result == payload
+        assert pytest.approx(captured_kwargs["timeout"], rel=1e-6) == 12.34
+        # HTTPS -> a context should be provided (created by ssl.create_default_context)
+        assert captured_kwargs["context"] is not None
+
+    def test_get_handles_gzip_response(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        # Arrange
+        base_url = "https://api.example.com/"
+        path = "gzip-endpoint"
+        expected_url = f"{base_url}{path}"
+        payload = {"message": "compressed ok"}
+        raw = json.dumps(payload).encode("utf-8")
+        gzipped = gzip.compress(raw)
+
+        def fake_urlopen(request, *, timeout=None, context=None):
+            # Return gzipped content with appropriate header
+            return FakeResponse(
+                status=200,
+                headers={
+                    "Content-Type": "application/json; charset=utf-8",
+                    "Content-Encoding": "gzip",
+                },
+                url=expected_url,
+                content=gzipped,
+            )
+
+        monkeypatch.setattr("redis.http.http_client.urlopen", fake_urlopen)
+
+        client = HttpClient(base_url=base_url)
+
+        # Act
+        result = client.get(path)  # expect_json=True by default
+
+        # Assert
+        assert result == payload
+
+    def test_get_retries_on_retryable_http_errors_and_succeeds(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        # Arrange: configure limited retries so we can assert attempts
+        retry_policy = Retry(
+            backoff=ExponentialWithJitterBackoff(base=0, cap=0), retries=2
+        )  # 2 retries -> up to 3 attempts
+        base_url = "https://api.example.com/"
+        path = "sometimes-busy"
+        expected_url = f"{base_url}{path}"
+        payload = {"ok": True}
+        success_content = json.dumps(payload).encode("utf-8")
+
+        call_count = {"n": 0}
+
+        def make_http_error(url: str, code: int, body: bytes = b"busy"):
+            # Provide a file-like object for .read() when HttpClient tries to read error content
+            fp = BytesIO(body)
+            return HTTPError(
+                url=url,
+                code=code,
+                msg="Service Unavailable",
+                hdrs={"Content-Type": "text/plain"},
+                fp=fp,
+            )
+
+        def flaky_urlopen(request, *, timeout=None, context=None):
+            call_count["n"] += 1
+            # Fail with a retryable status (503) for the first two calls, then succeed
+            if call_count["n"] <= 2:
+                raise make_http_error(expected_url, 503)
+            return FakeResponse(
+                status=200,
+                headers={"Content-Type": "application/json; charset=utf-8"},
+                url=expected_url,
+                content=success_content,
+            )
+
+        monkeypatch.setattr("redis.http.http_client.urlopen", flaky_urlopen)
+
+        client = HttpClient(base_url=base_url, retry=retry_policy)
+
+        # Act
+        result = client.get(path)
+
+        # Assert: should have retried twice (total 3 attempts) and finally returned parsed JSON
+        assert result == payload
+        assert call_count["n"] == retry_policy.get_retries() + 1
+
+    def test_post_sends_json_body_and_parses_response(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        # Arrange
+        base_url = "https://api.example.com/"
+        path = "v1/create"
+        expected_url = f"{base_url}{path}"
+        send_payload = {"a": 1, "b": "x"}
+        recv_payload = {"id": 10, "ok": True}
+        recv_content = json.dumps(recv_payload, separators=(",", ":")).encode("utf-8")
+
+        def fake_urlopen(request, *, timeout=None, context=None):
+            # Verify method, URL and headers
+            assert getattr(request, "method", "").upper() == "POST"
+            assert request.full_url == expected_url
+            # Content-Type should be auto-set for string JSON body
+            assert (
+                request.headers.get("Content-type") == "application/json; charset=utf-8"
+            )
+            # Body should be already UTF-8 encoded JSON with no spaces
+            assert request.data == json.dumps(
+                send_payload, ensure_ascii=False, separators=(",", ":")
+            ).encode("utf-8")
+            return FakeResponse(
+                status=200,
+                headers={"Content-Type": "application/json; charset=utf-8"},
+                url=expected_url,
+                content=recv_content,
+            )
+
+        monkeypatch.setattr("redis.http.http_client.urlopen", fake_urlopen)
+
+        client = HttpClient(base_url=base_url)
+
+        # Act
+        result = client.post(path, json_body=send_payload)
+
+        # Assert
+        assert result == recv_payload
+
+    def test_post_with_raw_data_and_custom_headers(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        # Arrange
+        base_url = "https://api.example.com/"
+        path = "upload"
+        expected_url = f"{base_url}{path}"
+        raw_data = b"\x00\x01BINARY"
+        custom_headers = {"Content-type": "application/octet-stream", "X-extra": "1"}
+        recv_payload = {"status": "ok"}
+
+        def fake_urlopen(request, *, timeout=None, context=None):
+            assert getattr(request, "method", "").upper() == "POST"
+            assert request.full_url == expected_url
+            # Ensure our provided headers are present
+            assert request.headers.get("Content-type") == "application/octet-stream"
+            assert request.headers.get("X-extra") == "1"
+            assert request.data == raw_data
+            return FakeResponse(
+                status=200,
+                headers={"Content-Type": "application/json"},
+                url=expected_url,
+                content=json.dumps(recv_payload).encode("utf-8"),
+            )
+
+        monkeypatch.setattr("redis.http.http_client.urlopen", fake_urlopen)
+
+        client = HttpClient(base_url=base_url)
+        # Act
+        result = client.post(path, data=raw_data, headers=custom_headers)
+
+        # Assert
+        assert result == recv_payload
+
+    def test_delete_returns_http_response_when_expect_json_false(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        # Arrange
+        base_url = "https://api.example.com/"
+        path = "v1/resource/42"
+        expected_url = f"{base_url}{path}"
+        body = b"deleted"
+
+        def fake_urlopen(request, *, timeout=None, context=None):
+            assert getattr(request, "method", "").upper() == "DELETE"
+            assert request.full_url == expected_url
+            return FakeResponse(
+                status=204,
+                headers={"Content-Type": "text/plain"},
+                url=expected_url,
+                content=body,
+            )
+
+        monkeypatch.setattr("redis.http.http_client.urlopen", fake_urlopen)
+        client = HttpClient(base_url=base_url)
+
+        # Act
+        resp = client.delete(path, expect_json=False)
+
+        # Assert
+        assert resp.status == 204
+        assert resp.url == expected_url
+        assert resp.content == body
+
+    def test_put_raises_http_error_on_non_success(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        # Arrange
+        base_url = "https://api.example.com/"
+        path = "v1/update/1"
+        expected_url = f"{base_url}{path}"
+
+        def make_http_error(url: str, code: int, body: bytes = b"not found"):
+            fp = BytesIO(body)
+            return HTTPError(
+                url=url,
+                code=code,
+                msg="Not Found",
+                hdrs={"Content-Type": "text/plain"},
+                fp=fp,
+            )
+
+        def fake_urlopen(request, *, timeout=None, context=None):
+            raise make_http_error(expected_url, 404)
+
+        monkeypatch.setattr("redis.http.http_client.urlopen", fake_urlopen)
+        client = HttpClient(base_url=base_url)
+
+        # Act / Assert
+        with pytest.raises(HttpError) as exc:
+            client.put(path, json_body={"x": 1})
+        assert exc.value.status == 404
+        assert exc.value.url == expected_url
+
+    def test_patch_with_params_encodes_query(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        # Arrange
+        base_url = "https://api.example.com/"
+        path = "v1/edit"
+        params = {"tag": ["a", "b"], "q": "hello world"}
+
+        captured_url = {"u": None}
+
+        def fake_urlopen(request, *, timeout=None, context=None):
+            captured_url["u"] = request.full_url
+            return FakeResponse(
+                status=200,
+                headers={"Content-Type": "application/json"},
+                url=request.full_url,
+                content=json.dumps({"ok": True}).encode("utf-8"),
+            )
+
+        monkeypatch.setattr("redis.http.http_client.urlopen", fake_urlopen)
+
+        client = HttpClient(base_url=base_url)
+        client.patch(path, params=params)  # We don't care about response here
+
+        # Assert query parameters regardless of ordering
+        parsed = urlparse(captured_url["u"])
+        qs = parse_qs(parsed.query)
+        assert qs["q"] == ["hello world"]
+        assert qs["tag"] == ["a", "b"]
+
+    def test_request_low_level_headers_auth_and_timeout_default(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        # Arrange: use plain HTTP to verify no TLS context, and check default timeout used
+        base_url = "http://example.com/"
+        path = "ping"
+        captured = {
+            "timeout": None,
+            "context": "unset",
+            "headers": None,
+            "method": None,
+        }
+
+        def fake_urlopen(request, *, timeout=None, context=None):
+            captured["timeout"] = timeout
+            captured["context"] = context
+            captured["headers"] = dict(request.headers)
+            captured["method"] = getattr(request, "method", "").upper()
+            return FakeResponse(
+                status=200,
+                headers={"Content-Type": "application/json"},
+                url=request.full_url,
+                content=json.dumps({"pong": True}).encode("utf-8"),
+            )
+
+        monkeypatch.setattr("redis.http.http_client.urlopen", fake_urlopen)
+
+        client = HttpClient(base_url=base_url, auth_basic=("user", "pass"))
+        resp = client.request("GET", path)
+
+        # Assert
+        assert resp.status == 200
+        assert captured["method"] == "GET"
+        assert captured["context"] is None  # no TLS for http
+        assert (
+            pytest.approx(captured["timeout"], rel=1e-6) == client.timeout
+        )  # default used
+        # Check some default headers and Authorization presence
+        headers = {k.lower(): v for k, v in captured["headers"].items()}
+        assert "authorization" in headers and headers["authorization"].startswith(
+            "Basic "
+        )
+        assert headers.get("accept") == "application/json"
+        assert "gzip" in headers.get("accept-encoding", "").lower()
+        assert "user-agent" in headers
diff --git a/tests/test_maint_notifications_handling.py b/tests/test_maint_notifications_handling.py
index baa7d601fa..54b6e2dff7 100644
--- a/tests/test_maint_notifications_handling.py
+++ b/tests/test_maint_notifications_handling.py
@@ -330,6 +330,9 @@ def setsockopt(self, level, optname, value):
         """Simulate setting socket options."""
         pass
 
+    def setblocking(self, blocking):
+        pass
+
     def getpeername(self):
         """Simulate getting peer name."""
         return self.address
diff --git a/tests/test_multidb/__init__.py b/tests/test_multidb/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/tests/test_multidb/conftest.py b/tests/test_multidb/conftest.py
new file mode 100644
index 0000000000..76990aecaa
--- /dev/null
+++ b/tests/test_multidb/conftest.py
@@ -0,0 +1,131 @@
+from unittest.mock import Mock
+
+import pytest
+
+from redis import Redis, ConnectionPool
+from redis.data_structure import WeightedList
+from redis.multidb.circuit import State as CBState, CircuitBreaker
+from redis.multidb.config import (
+    MultiDbConfig,
+    DatabaseConfig,
+    DEFAULT_HEALTH_CHECK_INTERVAL,
+    DEFAULT_AUTO_FALLBACK_INTERVAL,
+)
+from redis.multidb.database import Database, Databases
+from redis.multidb.failover import FailoverStrategy
+from redis.multidb.failure_detector import FailureDetector
+from redis.multidb.healthcheck import (
+    HealthCheck,
+    DEFAULT_HEALTH_CHECK_PROBES,
+    DEFAULT_HEALTH_CHECK_POLICY,
+)
+
+
+@pytest.fixture()
+def mock_client() -> Redis:
+    return Mock(spec=Redis)
+
+
+@pytest.fixture()
+def mock_cb() -> CircuitBreaker:
+    return Mock(spec=CircuitBreaker)
+
+
+@pytest.fixture()
+def mock_fd() -> FailureDetector:
+    return Mock(spec=FailureDetector)
+
+
+@pytest.fixture()
+def mock_fs() -> FailoverStrategy:
+    return Mock(spec=FailoverStrategy)
+
+
+@pytest.fixture()
+def mock_hc() -> HealthCheck:
+    return Mock(spec=HealthCheck)
+
+
+@pytest.fixture()
+def mock_db(request) -> Database:
+    db = Mock(spec=Database)
+    db.weight = request.param.get("weight", 1.0)
+    db.client = Mock(spec=Redis)
+    db.client.connection_pool = Mock(spec=ConnectionPool)
+
+    cb = request.param.get("circuit", {})
+    mock_cb = Mock(spec=CircuitBreaker)
+    mock_cb.grace_period = cb.get("grace_period", 1.0)
+    mock_cb.state = cb.get("state", CBState.CLOSED)
+
+    db.circuit = mock_cb
+    return db
+
+
+@pytest.fixture()
+def mock_db1(request) -> Database:
+    db = Mock(spec=Database)
+    db.weight = request.param.get("weight", 1.0)
+    db.client = Mock(spec=Redis)
+    db.client.connection_pool = Mock(spec=ConnectionPool)
+
+    cb = request.param.get("circuit", {})
+    mock_cb = Mock(spec=CircuitBreaker)
+    mock_cb.grace_period = cb.get("grace_period", 1.0)
+    mock_cb.state = cb.get("state", CBState.CLOSED)
+
+    db.circuit = mock_cb
+    return db
+
+
+@pytest.fixture()
+def mock_db2(request) -> Database:
+    db = Mock(spec=Database)
+    db.weight = request.param.get("weight", 1.0)
+    db.client = Mock(spec=Redis)
+    db.client.connection_pool = Mock(spec=ConnectionPool)
+
+    cb = request.param.get("circuit", {})
+    mock_cb = Mock(spec=CircuitBreaker)
+    mock_cb.grace_period = cb.get("grace_period", 1.0)
+    mock_cb.state = cb.get("state", CBState.CLOSED)
+
+    db.circuit = mock_cb
+    return db
+
+
+@pytest.fixture()
+def mock_multi_db_config(request, mock_fd, mock_fs, mock_hc, mock_ed) -> MultiDbConfig:
+    hc_interval = request.param.get("hc_interval", DEFAULT_HEALTH_CHECK_INTERVAL)
+    auto_fallback_interval = request.param.get(
+        "auto_fallback_interval", DEFAULT_AUTO_FALLBACK_INTERVAL
+    )
+    health_check_policy = request.param.get(
+        "health_check_policy", DEFAULT_HEALTH_CHECK_POLICY
+    )
+    health_check_probes = request.param.get(
+        "health_check_probes", DEFAULT_HEALTH_CHECK_PROBES
+    )
+
+    config = MultiDbConfig(
+        databases_config=[Mock(spec=DatabaseConfig)],
+        failure_detectors=[mock_fd],
+        health_check_interval=hc_interval,
+        health_check_probes_delay=0.05,
+        health_check_policy=health_check_policy,
+        health_check_probes=health_check_probes,
+        failover_strategy=mock_fs,
+        auto_fallback_interval=auto_fallback_interval,
+        event_dispatcher=mock_ed,
+    )
+
+    return config
+
+
+def create_weighted_list(*databases) -> Databases:
+    dbs = WeightedList()
+
+    for db in databases:
+        dbs.add(db, db.weight)
+
+    return dbs
diff --git a/tests/test_multidb/test_circuit.py b/tests/test_multidb/test_circuit.py
new file mode 100644
index 0000000000..7d0f2cb700
--- /dev/null
+++ b/tests/test_multidb/test_circuit.py
@@ -0,0 +1,57 @@
+import pybreaker
+import pytest
+
+from redis.multidb.circuit import (
+    PBCircuitBreakerAdapter,
+    State as CbState,
+    CircuitBreaker,
+)
+
+
+@pytest.mark.onlynoncluster
+class TestPBCircuitBreaker:
+    @pytest.mark.parametrize(
+        "mock_db",
+        [
+            {"weight": 0.7, "circuit": {"state": CbState.CLOSED}},
+        ],
+        indirect=True,
+    )
+    def test_cb_correctly_configured(self, mock_db):
+        pb_circuit = pybreaker.CircuitBreaker(reset_timeout=5)
+        adapter = PBCircuitBreakerAdapter(cb=pb_circuit)
+        assert adapter.state == CbState.CLOSED
+
+        adapter.state = CbState.OPEN
+        assert adapter.state == CbState.OPEN
+
+        adapter.state = CbState.HALF_OPEN
+        assert adapter.state == CbState.HALF_OPEN
+
+        adapter.state = CbState.CLOSED
+        assert adapter.state == CbState.CLOSED
+
+        assert adapter.grace_period == 5
+        adapter.grace_period = 10
+
+        assert adapter.grace_period == 10
+
+        adapter.database = mock_db
+        assert adapter.database == mock_db
+
+    def test_cb_executes_callback_on_state_changed(self):
+        pb_circuit = pybreaker.CircuitBreaker(reset_timeout=5)
+        adapter = PBCircuitBreakerAdapter(cb=pb_circuit)
+        called_count = 0
+
+        def callback(cb: CircuitBreaker, old_state: CbState, new_state: CbState):
+            nonlocal called_count
+            assert old_state == CbState.CLOSED
+            assert new_state == CbState.HALF_OPEN
+            assert isinstance(cb, PBCircuitBreakerAdapter)
+            called_count += 1
+
+        adapter.on_state_changed(callback)
+        adapter.state = CbState.HALF_OPEN
+
+        assert called_count == 1
diff --git a/tests/test_multidb/test_client.py b/tests/test_multidb/test_client.py
new file mode 100644
index 0000000000..cbc81b15ed
--- /dev/null
+++ b/tests/test_multidb/test_client.py
@@ -0,0 +1,615 @@
+import threading
+from time import sleep
+from unittest.mock import patch, Mock
+
+import pybreaker
+import pytest
+
+from redis.event import EventDispatcher, OnCommandsFailEvent
+from redis.multidb.circuit import State as CBState, PBCircuitBreakerAdapter
+from redis.multidb.database import SyncDatabase
+from redis.multidb.client import MultiDBClient
+from redis.multidb.exception import NoValidDatabaseException
+from redis.multidb.failover import WeightBasedFailoverStrategy
+from redis.multidb.failure_detector import FailureDetector
+from redis.multidb.healthcheck import HealthCheck
+from tests.test_multidb.conftest import create_weighted_list
+
+
+@pytest.mark.onlynoncluster
+class TestMultiDbClient:
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_execute_command_against_correct_db_on_successful_initialization(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_db1.client.execute_command.return_value = "OK1"
+
+            mock_hc.check_health.return_value = True
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            assert client.set("key", "value") == "OK1"
+            assert mock_hc.check_health.call_count == 9
+
+            assert mock_db.circuit.state == CBState.CLOSED
+            assert mock_db1.circuit.state == CBState.CLOSED
+            assert mock_db2.circuit.state == CBState.CLOSED
+
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.OPEN}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_execute_command_against_correct_db_and_closed_circuit(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_db1.client.execute_command.return_value = "OK1"
+
+            mock_hc.check_health.side_effect = [
+                False,
+                True,
+                True,
+                True,
+                True,
+                True,
+                True,
+            ]
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            assert client.set("key", "value") == "OK1"
+            assert mock_hc.check_health.call_count == 7
+
+            assert mock_db.circuit.state == CBState.CLOSED
+            assert mock_db1.circuit.state == CBState.CLOSED
+            assert mock_db2.circuit.state == CBState.OPEN
+
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {"health_check_probes": 1},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_execute_command_against_correct_db_on_background_health_check_determine_active_db_unhealthy(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        cb = PBCircuitBreakerAdapter(pybreaker.CircuitBreaker(reset_timeout=5))
+        cb.database = mock_db
+        mock_db.circuit = cb
+
+        cb1 = PBCircuitBreakerAdapter(pybreaker.CircuitBreaker(reset_timeout=5))
+        cb1.database = mock_db1
+        mock_db1.circuit = cb1
+
+        cb2 = PBCircuitBreakerAdapter(pybreaker.CircuitBreaker(reset_timeout=5))
+        cb2.database = mock_db2
+        mock_db2.circuit = cb2
+
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        # Track health check runs across all databases
+        health_check_run = 0
+
+        # Create events for each failover scenario
+        db1_became_unhealthy = threading.Event()
+        db2_became_unhealthy = threading.Event()
+        db_became_unhealthy = threading.Event()
+        counter_lock = threading.Lock()
+
+        def mock_check_health(database):
+            nonlocal health_check_run
+
+            # Increment run counter for each health check call
+            with counter_lock:
+                health_check_run += 1
+                current_run = health_check_run
+
+            # Run 1 (health_check_run 1-3): All databases healthy
+            if current_run <= 3:
+                return True
+
+            # Run 2 (health_check_run 4-6): mock_db1 unhealthy, others healthy
+            elif current_run <= 6:
+                if database == mock_db1:
+                    if current_run == 6:
+                        db1_became_unhealthy.set()
+                    return False
+
+                # Signal that db1 has become unhealthy after all 3 checks
+                if current_run == 6:
+                    db1_became_unhealthy.set()
+                return True
+
+            # Run 3 (health_check_run 7-9): mock_db1 and mock_db2 unhealthy, mock_db healthy
+            elif current_run <= 9:
+                if database == mock_db1 or database == mock_db2:
+                    if current_run == 9:
+                        db2_became_unhealthy.set()
+                    return False
+
+                # Signal that db2 has become unhealthy after all 3 checks
+                if current_run == 9:
+                    db2_became_unhealthy.set()
+                return True
+
+            # Run 4 (health_check_run 10-12): mock_db unhealthy, others healthy
+            else:
+                if database == mock_db:
+                    if current_run >= 12:
+                        db_became_unhealthy.set()
+                    return False
+
+                # Signal that db has become unhealthy after all 3 checks
+                if current_run >= 12:
+                    db_became_unhealthy.set()
+                return True
+
+        mock_hc.check_health.side_effect = mock_check_health
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config,
+                "default_health_checks",
+                return_value=[mock_hc],
+            ),
+        ):
+            mock_multi_db_config.health_check_interval = 0.1
+            mock_multi_db_config.failover_strategy = WeightBasedFailoverStrategy()
+            mock_db.client.execute_command.return_value = "OK"
+            mock_db1.client.execute_command.return_value = "OK1"
+            mock_db2.client.execute_command.return_value = "OK2"
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert client.set("key", "value") == "OK1"
+
+            # Wait for mock_db1 to become unhealthy
+            assert db1_became_unhealthy.wait(timeout=1.0), (
+                "Timeout waiting for mock_db1 to become unhealthy"
+            )
+            sleep(0.01)
+
+            assert client.set("key", "value") == "OK2"
+
+            # Wait for mock_db2 to become unhealthy
+            assert db2_became_unhealthy.wait(timeout=1.0), (
+                "Timeout waiting for mock_db2 to become unhealthy"
+            )
+            sleep(0.01)
+
+            assert client.set("key", "value") == "OK"
+
+            # Wait for mock_db to become unhealthy
+            assert db_became_unhealthy.wait(timeout=1.0), (
+                "Timeout waiting for mock_db to become unhealthy"
+            )
+            sleep(0.01)
+
+            assert client.set("key", "value") == "OK1"
+
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {"health_check_probes": 1},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_execute_command_auto_fallback_to_highest_weight_db(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        db1_counter = 0
+        error_event = threading.Event()
+        check = False
+
+        def mock_check_health(database):
+            nonlocal db1_counter, check
+
+            if database == mock_db1 and not check:
+                db1_counter += 1
+
+                if db1_counter > 1:
+                    error_event.set()
+                    check = True
+                    return False
+
+            return True
+
+        mock_hc.check_health.side_effect = mock_check_health
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config,
+                "default_health_checks",
+                return_value=[mock_hc],
+            ),
+        ):
+            mock_db.client.execute_command.return_value = "OK"
+            mock_db1.client.execute_command.return_value = "OK1"
+            mock_db2.client.execute_command.return_value = "OK2"
+            mock_multi_db_config.health_check_interval = 0.1
+            mock_multi_db_config.auto_fallback_interval = 0.2
+            mock_multi_db_config.failover_strategy = WeightBasedFailoverStrategy()
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert client.set("key", "value") == "OK1"
+            error_event.wait(timeout=0.5)
+            assert client.set("key", "value") == "OK2"
+            sleep(0.5)
+            assert client.set("key", "value") == "OK1"
+
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.OPEN}},
+                {"weight": 0.7, "circuit": {"state": CBState.OPEN}},
+                {"weight": 0.5, "circuit": {"state": CBState.OPEN}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_execute_command_throws_exception_on_failed_initialization(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_hc.check_health.return_value = False
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+
+            with pytest.raises(
+                NoValidDatabaseException,
+                match="Initial connection failed - no active database found",
+            ):
+                client.set("key", "value")
+
+                assert mock_hc.check_health.call_count == 3
+
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_add_database_throws_exception_on_same_database(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_hc.check_health.return_value = False
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+
+            with pytest.raises(ValueError, match="Given database already exists"):
+                client.add_database(mock_db)
+                assert mock_hc.check_health.call_count == 3
+
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_add_database_makes_new_database_active(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_db1.client.execute_command.return_value = "OK1"
+            mock_db2.client.execute_command.return_value = "OK2"
+
+            mock_hc.check_health.return_value = True
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+
+            assert client.set("key", "value") == "OK2"
+            assert mock_hc.check_health.call_count == 6
+
+            client.add_database(mock_db1)
+            assert mock_hc.check_health.call_count == 9
+
+            assert client.set("key", "value") == "OK1"
+
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_remove_highest_weighted_database(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_db1.client.execute_command.return_value = "OK1"
+            mock_db2.client.execute_command.return_value = "OK2"
+
+            mock_hc.check_health.return_value = True
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+
+            assert client.set("key", "value") == "OK1"
+            assert mock_hc.check_health.call_count == 9
+
+            client.remove_database(mock_db1)
+
+            assert client.set("key", "value") == "OK2"
+
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_update_database_weight_to_be_highest(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_db1.client.execute_command.return_value = "OK1"
+            mock_db2.client.execute_command.return_value = "OK2"
+
+            mock_hc.check_health.return_value = True
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+
+            assert client.set("key", "value") == "OK1"
+            assert mock_hc.check_health.call_count == 9
+
+            client.update_database_weight(mock_db2, 0.8)
+            assert mock_db2.weight == 0.8
+
+            assert client.set("key", "value") == "OK2"
+
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_add_new_failure_detector(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_db1.client.execute_command.return_value = "OK1"
+            mock_multi_db_config.event_dispatcher = EventDispatcher()
+            mock_fd = mock_multi_db_config.failure_detectors[0]
+
+            # Event fired if command against mock_db1 would fail
+            command_fail_event = OnCommandsFailEvent(
+                commands=("SET", "key", "value"),
+                exception=Exception(),
+            )
+
+            mock_hc.check_health.return_value = True
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            assert client.set("key", "value") == "OK1"
+            assert mock_hc.check_health.call_count == 9
+
+            # Simulate failing command events that lead to a failure detection
+            for i in range(5):
+                mock_multi_db_config.event_dispatcher.dispatch(command_fail_event)
+
+            assert mock_fd.register_failure.call_count == 5
+
+            another_fd = Mock(spec=FailureDetector)
+            client.add_failure_detector(another_fd)
+
+            # Simulate failing command events that lead to a failure detection
+            for i in range(5):
+                mock_multi_db_config.event_dispatcher.dispatch(command_fail_event)
+
+            assert mock_fd.register_failure.call_count == 10
+            assert another_fd.register_failure.call_count == 5
+
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_add_new_health_check(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_db1.client.execute_command.return_value = "OK1"
+
+            mock_hc.check_health.return_value = True
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            assert client.set("key", "value") == "OK1"
+            assert mock_hc.check_health.call_count == 9
+
+            another_hc = Mock(spec=HealthCheck)
+            another_hc.check_health.return_value = True
+
+            client.add_health_check(another_hc)
+            client._check_db_health(mock_db1)
+
+            assert mock_hc.check_health.call_count == 12
+            assert another_hc.check_health.call_count == 3
+
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_set_active_database(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_db1.client.execute_command.return_value = "OK1"
+            mock_db.client.execute_command.return_value = "OK"
+
+            mock_hc.check_health.return_value = True
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            assert client.set("key", "value") == "OK1"
+            assert mock_hc.check_health.call_count == 9
+
+            client.set_active_database(mock_db)
+            assert client.set("key", "value") == "OK"
+
+            with pytest.raises(
+                ValueError, match="Given database is not a member of database list"
+            ):
+                client.set_active_database(Mock(spec=SyncDatabase))
+
+            mock_hc.check_health.return_value = False
+
+            with pytest.raises(
+                NoValidDatabaseException,
+                match="Cannot set active database, database is unhealthy",
+            ):
+                client.set_active_database(mock_db1)
diff --git a/tests/test_multidb/test_command_executor.py b/tests/test_multidb/test_command_executor.py
new file mode 100644
index 0000000000..43e5f47344
--- /dev/null
+++ b/tests/test_multidb/test_command_executor.py
@@ -0,0 +1,173 @@
+from time import sleep
+
+import pytest
+
+from redis.exceptions import ConnectionError
+from redis.backoff import NoBackoff
+from redis.event import EventDispatcher
+from redis.multidb.circuit import State as CBState
+from redis.multidb.command_executor import DefaultCommandExecutor
+from redis.multidb.failure_detector import CommandFailureDetector
+from redis.retry import Retry
+from tests.test_multidb.conftest import create_weighted_list
+
+
+@pytest.mark.onlynoncluster
+class TestDefaultCommandExecutor:
+    @pytest.mark.parametrize(
+        "mock_db,mock_db1,mock_db2",
+        [
+            (
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_execute_command_on_active_database(
+        self, mock_db, mock_db1, mock_db2, mock_fd, mock_fs, mock_ed
+    ):
+        mock_db1.client.execute_command.return_value = "OK1"
+        mock_db2.client.execute_command.return_value = "OK2"
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        executor = DefaultCommandExecutor(
+            failure_detectors=[mock_fd],
+            databases=databases,
+            failover_strategy=mock_fs,
+            event_dispatcher=mock_ed,
+            command_retry=Retry(NoBackoff(), 0),
+        )
+
+        executor.active_database = mock_db1
+        assert executor.execute_command("SET", "key", "value") == "OK1"
+
+        executor.active_database = mock_db2
+        assert executor.execute_command("SET", "key", "value") == "OK2"
+        assert mock_ed.register_listeners.call_count == 1
+        assert mock_fd.register_command_execution.call_count == 2
+
+    @pytest.mark.parametrize(
+        "mock_db,mock_db1,mock_db2",
+        [
+            (
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_execute_command_automatically_select_active_database(
+        self, mock_db, mock_db1, mock_db2, mock_fd, mock_fs, mock_ed
+    ):
+        mock_db1.client.execute_command.return_value = "OK1"
+        mock_db2.client.execute_command.return_value = "OK2"
+        mock_fs.database.side_effect = [mock_db1, mock_db2]
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        executor = DefaultCommandExecutor(
+            failure_detectors=[mock_fd],
+            databases=databases,
+            failover_strategy=mock_fs,
+            event_dispatcher=mock_ed,
+            command_retry=Retry(NoBackoff(), 0),
+        )
+
+        assert executor.execute_command("SET", "key", "value") == "OK1"
+        mock_db1.circuit.state = CBState.OPEN
+
+        assert executor.execute_command("SET", "key", "value") == "OK2"
+        assert mock_ed.register_listeners.call_count == 1
+        assert mock_fs.database.call_count == 2
+        assert mock_fd.register_command_execution.call_count == 2
+
+    @pytest.mark.parametrize(
+        "mock_db,mock_db1,mock_db2",
+        [
+            (
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_execute_command_fallback_to_another_db_after_fallback_interval(
+        self, mock_db, mock_db1, mock_db2, mock_fd, mock_fs, mock_ed
+    ):
+        mock_db1.client.execute_command.return_value = "OK1"
+        mock_db2.client.execute_command.return_value = "OK2"
+        mock_fs.database.side_effect = [mock_db1, mock_db2, mock_db1]
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        executor = DefaultCommandExecutor(
+            failure_detectors=[mock_fd],
+            databases=databases,
+            failover_strategy=mock_fs,
+            event_dispatcher=mock_ed,
+            auto_fallback_interval=0.1,
+            command_retry=Retry(NoBackoff(), 0),
+        )
+
+        assert executor.execute_command("SET", "key", "value") == "OK1"
+        mock_db1.weight = 0.1
+        sleep(0.15)
+
+        assert executor.execute_command("SET", "key", "value") == "OK2"
+        mock_db1.weight = 0.7
+        sleep(0.15)
+
+        assert executor.execute_command("SET", "key", "value") == "OK1"
+        assert mock_ed.register_listeners.call_count == 1
+        assert mock_fs.database.call_count == 3
+        assert mock_fd.register_command_execution.call_count == 3
+
+    @pytest.mark.parametrize(
+        "mock_db,mock_db1,mock_db2",
+        [
+            (
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_execute_command_fallback_to_another_db_after_failure_detection(
+        self, mock_db, mock_db1, mock_db2, mock_fs
+    ):
+        mock_db1.client.execute_command.side_effect = [
+            "OK1",
+            ConnectionError,
+            ConnectionError,
+            ConnectionError,
+            "OK1",
+        ]
+        mock_db2.client.execute_command.side_effect = [
+            "OK2",
+            ConnectionError,
+            ConnectionError,
+            ConnectionError,
+        ]
+        mock_fs.database.side_effect = [mock_db1, mock_db2, mock_db1]
+        threshold = 3
+        fd = CommandFailureDetector(threshold, 0.0, 1)
+        ed = EventDispatcher()
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        executor = DefaultCommandExecutor(
+            failure_detectors=[fd],
+            databases=databases,
+            failover_strategy=mock_fs,
+            event_dispatcher=ed,
+            auto_fallback_interval=0.1,
+            command_retry=Retry(NoBackoff(), threshold),
+        )
+        fd.set_command_executor(command_executor=executor)
+
+        assert executor.execute_command("SET", "key", "value") == "OK1"
+        assert executor.execute_command("SET", "key", "value") == "OK2"
+        assert executor.execute_command("SET", "key", "value") == "OK1"
+        assert mock_fs.database.call_count == 3
diff --git a/tests/test_multidb/test_config.py b/tests/test_multidb/test_config.py
new file mode 100644
index 0000000000..351f789971
--- /dev/null
+++ b/tests/test_multidb/test_config.py
@@ -0,0 +1,161 @@
+from unittest.mock import Mock
+
+import pytest
+
+from redis.connection import ConnectionPool
+from redis.multidb.circuit import (
+    PBCircuitBreakerAdapter,
+    CircuitBreaker,
+    DEFAULT_GRACE_PERIOD,
+)
+from redis.multidb.config import (
+    MultiDbConfig,
+    DEFAULT_HEALTH_CHECK_INTERVAL,
+    DEFAULT_AUTO_FALLBACK_INTERVAL,
+    DatabaseConfig,
+)
+from redis.multidb.database import Database
+from redis.multidb.failure_detector import CommandFailureDetector, FailureDetector
+from redis.multidb.healthcheck import EchoHealthCheck, HealthCheck
+from redis.multidb.failover import WeightBasedFailoverStrategy, FailoverStrategy
+from redis.retry import Retry
+
+
+@pytest.mark.onlynoncluster
+class TestMultiDbConfig:
+    def test_default_config(self):
+        db_configs = [
+            DatabaseConfig(
+                client_kwargs={"host": "host1", "port": "port1"}, weight=1.0
+            ),
+            DatabaseConfig(
+                client_kwargs={"host": "host2", "port": "port2"}, weight=0.9
+            ),
+            DatabaseConfig(
+                client_kwargs={"host": "host3", "port": "port3"}, weight=0.8
+            ),
+        ]
+
+        config = MultiDbConfig(databases_config=db_configs)
+
+        assert config.databases_config == db_configs
+        databases = config.databases()
+        assert len(databases) == 3
+
+        i = 0
+        for db, weight in databases:
+            assert isinstance(db, Database)
+            assert weight == db_configs[i].weight
+            assert db.circuit.grace_period == DEFAULT_GRACE_PERIOD
+            assert db.client.get_retry() is not config.command_retry
+            i += 1
+
+        assert len(config.default_failure_detectors()) == 1
+        assert isinstance(config.default_failure_detectors()[0], CommandFailureDetector)
+        assert len(config.default_health_checks()) == 1
+        assert isinstance(config.default_health_checks()[0], EchoHealthCheck)
+        assert config.health_check_interval == DEFAULT_HEALTH_CHECK_INTERVAL
+        assert isinstance(
+            config.default_failover_strategy(), WeightBasedFailoverStrategy
+        )
+        assert config.auto_fallback_interval == DEFAULT_AUTO_FALLBACK_INTERVAL
+        assert isinstance(config.command_retry, Retry)
+
+    def test_overridden_config(self):
+        grace_period = 2
+        mock_connection_pools = [
+            Mock(spec=ConnectionPool),
+            Mock(spec=ConnectionPool),
+            Mock(spec=ConnectionPool),
+        ]
+        mock_connection_pools[0].connection_kwargs = {}
+        mock_connection_pools[1].connection_kwargs = {}
+        mock_connection_pools[2].connection_kwargs = {}
+        mock_cb1 = Mock(spec=CircuitBreaker)
+        mock_cb1.grace_period = grace_period
+        mock_cb2 = Mock(spec=CircuitBreaker)
+        mock_cb2.grace_period = grace_period
+        mock_cb3 = Mock(spec=CircuitBreaker)
+        mock_cb3.grace_period = grace_period
+        mock_failure_detectors = [
+            Mock(spec=FailureDetector),
+            Mock(spec=FailureDetector),
+        ]
+        mock_health_checks = [Mock(spec=HealthCheck), Mock(spec=HealthCheck)]
+        health_check_interval = 10
+        mock_failover_strategy = Mock(spec=FailoverStrategy)
+        auto_fallback_interval = 10
+        db_configs = [
+            DatabaseConfig(
+                client_kwargs={"connection_pool": mock_connection_pools[0]},
+                weight=1.0,
+                circuit=mock_cb1,
+            ),
+            DatabaseConfig(
+                client_kwargs={"connection_pool": mock_connection_pools[1]},
+                weight=0.9,
+                circuit=mock_cb2,
+            ),
+            DatabaseConfig(
+                client_kwargs={"connection_pool": mock_connection_pools[2]},
+                weight=0.8,
+                circuit=mock_cb3,
+            ),
+        ]
+
+        config = MultiDbConfig(
+            databases_config=db_configs,
+            failure_detectors=mock_failure_detectors,
+            health_checks=mock_health_checks,
+            health_check_interval=health_check_interval,
+            failover_strategy=mock_failover_strategy,
+            auto_fallback_interval=auto_fallback_interval,
+        )
+
+        assert config.databases_config == db_configs
+        databases = config.databases()
+        assert len(databases) == 3
+
+        i = 0
+        for db, weight in databases:
+            assert isinstance(db, Database)
+            assert weight == db_configs[i].weight
+            assert db.client.connection_pool == mock_connection_pools[i]
+            assert db.circuit.grace_period == grace_period
+            i += 1
+
+        assert len(config.failure_detectors) == 2
+        assert config.failure_detectors[0] == mock_failure_detectors[0]
+        assert config.failure_detectors[1] == mock_failure_detectors[1]
+        assert len(config.health_checks) == 2
+        assert config.health_checks[0] == mock_health_checks[0]
+        assert config.health_checks[1] == mock_health_checks[1]
+        assert config.health_check_interval == health_check_interval
+        assert config.failover_strategy == mock_failover_strategy
+        assert config.auto_fallback_interval == auto_fallback_interval
+
+
+@pytest.mark.onlynoncluster
+class TestDatabaseConfig:
+    def test_default_config(self):
+        config = DatabaseConfig(
+            client_kwargs={"host": "host1", "port": "port1"}, weight=1.0
+        )
+
+        assert config.client_kwargs == {"host": "host1", "port": "port1"}
+        assert config.weight == 1.0
+        assert isinstance(config.default_circuit_breaker(), PBCircuitBreakerAdapter)
+
+    def test_overridden_config(self):
+        mock_connection_pool = Mock(spec=ConnectionPool)
+        mock_circuit = Mock(spec=CircuitBreaker)
+
+        config = DatabaseConfig(
+            client_kwargs={"connection_pool": mock_connection_pool},
+            weight=1.0,
+            circuit=mock_circuit,
+        )
+
+        assert config.client_kwargs == {"connection_pool": mock_connection_pool}
+        assert config.weight == 1.0
+        assert config.circuit == mock_circuit
diff --git a/tests/test_multidb/test_failover.py b/tests/test_multidb/test_failover.py
new file mode 100644
index 0000000000..60b231ab40
--- /dev/null
+++ b/tests/test_multidb/test_failover.py
@@ -0,0 +1,161 @@
+from time import sleep
+
+import pytest
+
+from redis.data_structure import WeightedList
+from redis.multidb.circuit import State as CBState
+from redis.multidb.exception import (
+    NoValidDatabaseException,
+    TemporaryUnavailableException,
+)
+from redis.multidb.failover import (
+    WeightBasedFailoverStrategy,
+    DefaultFailoverStrategyExecutor,
+)
+
+
+@pytest.mark.onlynoncluster
+class TestWeightBasedFailoverStrategy:
+    @pytest.mark.parametrize(
+        "mock_db,mock_db1,mock_db2",
+        [
+            (
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+            (
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.OPEN}},
+            ),
+        ],
+        ids=["all closed - highest weight", "highest weight - open"],
+        indirect=True,
+    )
+    def test_get_valid_database(self, mock_db, mock_db1, mock_db2):
+        databases = WeightedList()
+        databases.add(mock_db, mock_db.weight)
+        databases.add(mock_db1, mock_db1.weight)
+        databases.add(mock_db2, mock_db2.weight)
+
+        failover_strategy = WeightBasedFailoverStrategy()
+        failover_strategy.set_databases(databases)
+
+        assert failover_strategy.database() == mock_db1
+
+    @pytest.mark.parametrize(
+        "mock_db,mock_db1,mock_db2",
+        [
+            (
+                {"weight": 0.2, "circuit": {"state": CBState.OPEN}},
+                {"weight": 0.7, "circuit": {"state": CBState.OPEN}},
+                {"weight": 0.5, "circuit": {"state": CBState.OPEN}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_throws_exception_on_empty_databases(self, mock_db, mock_db1, mock_db2):
+        failover_strategy = WeightBasedFailoverStrategy()
+
+        with pytest.raises(
+            NoValidDatabaseException,
+            match="No valid database available for communication",
+        ):
+            assert failover_strategy.database()
+
+
+@pytest.mark.onlynoncluster
+class TestDefaultStrategyExecutor:
+    @pytest.mark.parametrize(
+        "mock_db",
+        [
+            {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+        ],
+        indirect=True,
+    )
+    def test_execute_returns_valid_database_with_failover_attempts(
+        self, mock_db, mock_fs
+    ):
+        failover_attempts = 3
+        mock_fs.database.side_effect = [
+            NoValidDatabaseException,
+            NoValidDatabaseException,
+            NoValidDatabaseException,
+            mock_db,
+        ]
+        executor = DefaultFailoverStrategyExecutor(
+            mock_fs, failover_attempts=failover_attempts, failover_delay=0.1
+        )
+
+        for i in range(failover_attempts + 1):
+            try:
+                database = executor.execute()
+                assert database == mock_db
+            except TemporaryUnavailableException as e:
+                assert e.args[0] == (
+                    "No database connections currently available. "
+                    "This is a temporary condition - please retry the operation."
+                )
+                sleep(0.11)
+                pass
+
+        assert mock_fs.database.call_count == 4
+
+    def test_execute_throws_exception_on_attempts_exceed(self, mock_fs):
+        failover_attempts = 3
+        mock_fs.database.side_effect = [
+            NoValidDatabaseException,
+            NoValidDatabaseException,
+            NoValidDatabaseException,
+            NoValidDatabaseException,
+        ]
+        executor = DefaultFailoverStrategyExecutor(
+            mock_fs, failover_attempts=failover_attempts, failover_delay=0.1
+        )
+
+        with pytest.raises(NoValidDatabaseException):
+            for i in range(failover_attempts + 1):
+                try:
+                    executor.execute()
+                except TemporaryUnavailableException as e:
+                    assert e.args[0] == (
+                        "No database connections currently available. "
+                        "This is a temporary condition - please retry the operation."
+                    )
+                    sleep(0.11)
+                    pass
+
+            assert mock_fs.database.call_count == 4
+
+    def test_execute_throws_exception_on_attempts_does_not_exceed_delay(self, mock_fs):
+        failover_attempts = 3
+        mock_fs.database.side_effect = [
+            NoValidDatabaseException,
+            NoValidDatabaseException,
+            NoValidDatabaseException,
+            NoValidDatabaseException,
+        ]
+        executor = DefaultFailoverStrategyExecutor(
+            mock_fs, failover_attempts=failover_attempts, failover_delay=0.1
+        )
+
+        with pytest.raises(
+            TemporaryUnavailableException,
+            match=(
+                "No database connections currently available. "
+                "This is a temporary condition - please retry the operation."
+            ),
+        ):
+            for i in range(failover_attempts + 1):
+                try:
+                    executor.execute()
+                except TemporaryUnavailableException as e:
+                    assert e.args[0] == (
+                        "No database connections currently available. "
+                        "This is a temporary condition - please retry the operation."
+                    )
+                    if i == failover_attempts:
+                        raise e
+
+            assert mock_fs.database.call_count == 4
diff --git a/tests/test_multidb/test_failure_detector.py b/tests/test_multidb/test_failure_detector.py
new file mode 100644
index 0000000000..b64ff601d2
--- /dev/null
+++ b/tests/test_multidb/test_failure_detector.py
@@ -0,0 +1,117 @@
+from time import sleep
+from unittest.mock import Mock
+
+import pytest
+
+from redis.multidb.command_executor import SyncCommandExecutor
+from redis.multidb.database import Database
+from redis.multidb.failure_detector import CommandFailureDetector
+from redis.multidb.circuit import State as CBState
+from redis.exceptions import ConnectionError
+
+
+@pytest.mark.onlynoncluster
+class TestCommandFailureDetector:
+    @pytest.mark.parametrize(
+        "min_num_failures,failure_rate_threshold,circuit_state",
+        [
+            (2, 0.4, CBState.OPEN),
+            (2, 0, CBState.OPEN),
+            (0, 0.4, CBState.OPEN),
+            (3, 0.4, CBState.CLOSED),
+            (2, 0.41, CBState.CLOSED),
+        ],
+        ids=[
+            "exceeds min num failures AND failures rate",
+            "exceeds min num failures AND failures rate == 0",
+            "min num failures == 0 AND exceeds failures rate",
+            "do not exceeds min num failures",
+            "do not exceeds failures rate",
+        ],
+    )
+    def test_failure_detector_correctly_reacts_to_failures(
+        self, min_num_failures, failure_rate_threshold, circuit_state
+    ):
+        fd = CommandFailureDetector(min_num_failures, failure_rate_threshold)
+        mock_db = Mock(spec=Database)
+        mock_db.circuit.state = CBState.CLOSED
+        mock_ce = Mock(spec=SyncCommandExecutor)
+        mock_ce.active_database = mock_db
+        fd.set_command_executor(mock_ce)
+
+        fd.register_command_execution(("GET", "key"))
+        fd.register_command_execution(("GET", "key"))
+        fd.register_failure(Exception(), ("GET", "key"))
+
+        fd.register_command_execution(("GET", "key"))
+        fd.register_command_execution(("GET", "key"))
+        fd.register_command_execution(("GET", "key"))
+        fd.register_failure(Exception(), ("GET", "key"))
+
+        assert mock_db.circuit.state == circuit_state
+
+    @pytest.mark.parametrize(
+        "min_num_failures,failure_rate_threshold",
+        [
+            (3, 0.0),
+            (3, 0.6),
+        ],
+        ids=[
+            "do not exceeds min num failures, during interval",
+            "do not exceeds min num failures AND failure rate, during interval",
+        ],
+    )
+    def test_failure_detector_do_not_open_circuit_on_interval_exceed(
+        self, min_num_failures, failure_rate_threshold
+    ):
+        fd = CommandFailureDetector(min_num_failures, failure_rate_threshold, 0.3)
+        mock_db = Mock(spec=Database)
+        mock_db.circuit.state = CBState.CLOSED
+        mock_ce = Mock(spec=SyncCommandExecutor)
+        mock_ce.active_database = mock_db
+        fd.set_command_executor(mock_ce)
+        assert mock_db.circuit.state == CBState.CLOSED
+
+        fd.register_command_execution(("GET", "key"))
+        fd.register_failure(Exception(), ("GET", "key"))
+        sleep(0.16)
+        fd.register_command_execution(("GET", "key"))
+        fd.register_command_execution(("GET", "key"))
+        fd.register_command_execution(("GET", "key"))
+        fd.register_failure(Exception(), ("GET", "key"))
+        sleep(0.16)
+        fd.register_command_execution(("GET", "key"))
+        fd.register_failure(Exception(), ("GET", "key"))
+
+        assert mock_db.circuit.state == CBState.CLOSED
+
+        # 2 more failure as last one already refreshed timer
+        fd.register_command_execution(("GET", "key"))
+        fd.register_failure(Exception(), ("GET", "key"))
+        fd.register_command_execution(("GET", "key"))
+        fd.register_failure(Exception(), ("GET", "key"))
+
+        assert mock_db.circuit.state == CBState.OPEN
+
+    def test_failure_detector_open_circuit_on_specific_exception_threshold_exceed(self):
+        fd = CommandFailureDetector(5, 1, error_types=[ConnectionError])
+        mock_db = Mock(spec=Database)
+        mock_db.circuit.state = CBState.CLOSED
+        mock_ce = Mock(spec=SyncCommandExecutor)
+        mock_ce.active_database = mock_db
+        fd.set_command_executor(mock_ce)
+        assert mock_db.circuit.state == CBState.CLOSED
+
+        fd.register_failure(Exception(), ("SET", "key1", "value1"))
+        fd.register_failure(ConnectionError(), ("SET", "key1", "value1"))
+        fd.register_failure(ConnectionError(), ("SET", "key1", "value1"))
+        fd.register_failure(Exception(), ("SET", "key1", "value1"))
+        fd.register_failure(Exception(), ("SET", "key1", "value1"))
+
+        assert mock_db.circuit.state == CBState.CLOSED
+
+        fd.register_failure(ConnectionError(), ("SET", "key1", "value1"))
+        fd.register_failure(ConnectionError(), ("SET", "key1", "value1"))
+        fd.register_failure(ConnectionError(), ("SET", "key1", "value1"))
+
+        assert mock_db.circuit.state == CBState.OPEN
diff --git a/tests/test_multidb/test_healthcheck.py b/tests/test_multidb/test_healthcheck.py
new file mode 100644
index 0000000000..fb1f1e4148
--- /dev/null
+++ b/tests/test_multidb/test_healthcheck.py
@@ -0,0 +1,385 @@
+from unittest.mock import MagicMock, Mock
+
+import pytest
+
+from redis.multidb.database import Database
+from redis.http.http_client import HttpError
+from redis.multidb.healthcheck import (
+    EchoHealthCheck,
+    LagAwareHealthCheck,
+    HealthCheck,
+    HealthyAllPolicy,
+    UnhealthyDatabaseException,
+    HealthyMajorityPolicy,
+    HealthyAnyPolicy,
+)
+from redis.multidb.circuit import State as CBState
+
+
+@pytest.mark.onlynoncluster
+class TestHealthyAllPolicy:
+    def test_policy_returns_true_for_all_successful_probes(self):
+        mock_hc1 = Mock(spec=HealthCheck)
+        mock_hc2 = Mock(spec=HealthCheck)
+        mock_hc1.check_health.return_value = True
+        mock_hc2.check_health.return_value = True
+        mock_db = Mock(spec=Database)
+
+        policy = HealthyAllPolicy(3, 0.01)
+        assert policy.execute([mock_hc1, mock_hc2], mock_db)
+        assert mock_hc1.check_health.call_count == 3
+        assert mock_hc2.check_health.call_count == 3
+
+    def test_policy_returns_false_on_first_failed_probe(self):
+        mock_hc1 = Mock(spec=HealthCheck)
+        mock_hc2 = Mock(spec=HealthCheck)
+        mock_hc1.check_health.side_effect = [True, True, False]
+        mock_hc2.check_health.return_value = True
+        mock_db = Mock(spec=Database)
+
+        policy = HealthyAllPolicy(3, 0.01)
+        assert not policy.execute([mock_hc1, mock_hc2], mock_db)
+        assert mock_hc1.check_health.call_count == 3
+        assert mock_hc2.check_health.call_count == 0
+
+    def test_policy_raise_unhealthy_database_exception(self):
+        mock_hc1 = Mock(spec=HealthCheck)
+        mock_hc2 = Mock(spec=HealthCheck)
+        mock_hc1.check_health.side_effect = [True, True, ConnectionError]
+        mock_hc2.check_health.return_value = True
+        mock_db = Mock(spec=Database)
+
+        policy = HealthyAllPolicy(3, 0.01)
+        with pytest.raises(UnhealthyDatabaseException, match="Unhealthy database"):
+            policy.execute([mock_hc1, mock_hc2], mock_db)
+            assert mock_hc1.check_health.call_count == 3
+            assert mock_hc2.check_health.call_count == 0
+
+
+@pytest.mark.onlynoncluster
+class TestHealthyMajorityPolicy:
+    @pytest.mark.parametrize(
+        "probes,hc1_side_effect,hc2_side_effect,hc1_call_count,hc2_call_count,expected_result",
+        [
+            (3, [True, False, False], [True, True, True], 3, 0, False),
+            (3, [True, True, True], [True, False, False], 3, 3, False),
+            (3, [True, False, True], [True, True, True], 3, 3, True),
+            (3, [True, True, True], [True, False, True], 3, 3, True),
+            (3, [True, True, False], [True, False, True], 3, 3, True),
+            (4, [True, True, False, False], [True, True, True, True], 4, 0, False),
+            (4, [True, True, True, True], [True, True, False, False], 4, 4, False),
+            (4, [False, True, True, True], [True, True, True, True], 4, 4, True),
+            (4, [True, True, True, True], [True, False, True, True], 4, 4, True),
+            (4, [False, True, True, True], [True, True, False, True], 4, 4, True),
+        ],
+        ids=[
+            "HC1 - no majority - odd",
+            "HC2 - no majority - odd",
+            "HC1 - majority- odd",
+            "HC2 - majority - odd",
+            "HC1 + HC2 - majority - odd",
+            "HC1 - no majority - even",
+            "HC2 - no majority - even",
+            "HC1 - majority - even",
+            "HC2 - majority - even",
+            "HC1 + HC2 - majority - even",
+        ],
+    )
+    def test_policy_returns_true_for_majority_successful_probes(
+        self,
+        probes,
+        hc1_side_effect,
+        hc2_side_effect,
+        hc1_call_count,
+        hc2_call_count,
+        expected_result,
+    ):
+        mock_hc1 = Mock(spec=HealthCheck)
+        mock_hc2 = Mock(spec=HealthCheck)
+        mock_hc1.check_health.side_effect = hc1_side_effect
+        mock_hc2.check_health.side_effect = hc2_side_effect
+        mock_db = Mock(spec=Database)
+
+        policy = HealthyMajorityPolicy(probes, 0.01)
+        assert policy.execute([mock_hc1, mock_hc2], mock_db) == expected_result
+        assert mock_hc1.check_health.call_count == hc1_call_count
+        assert mock_hc2.check_health.call_count == hc2_call_count
+
+    @pytest.mark.parametrize(
+        "probes,hc1_side_effect,hc2_side_effect,hc1_call_count,hc2_call_count",
+        [
+            (3, [True, ConnectionError, ConnectionError], [True, True, True], 3, 0),
+            (3, [True, True, True], [True, ConnectionError, ConnectionError], 3, 3),
+            (
+                4,
+                [True, ConnectionError, ConnectionError, True],
+                [True, True, True, True],
+                3,
+                0,
+            ),
+            (
+                4,
+                [True, True, True, True],
+                [True, ConnectionError, ConnectionError, False],
+                4,
+                3,
+            ),
+        ],
+        ids=[
+            "HC1 - majority- odd",
+            "HC2 - majority - odd",
+            "HC1 - majority - even",
+            "HC2 - majority - even",
+        ],
+    )
+    def test_policy_raise_unhealthy_database_exception_on_majority_probes_exceptions(
+        self, probes, hc1_side_effect, hc2_side_effect, hc1_call_count, hc2_call_count
+    ):
+        mock_hc1 = Mock(spec=HealthCheck)
+        mock_hc2 = Mock(spec=HealthCheck)
+        mock_hc1.check_health.side_effect = hc1_side_effect
+        mock_hc2.check_health.side_effect = hc2_side_effect
+        mock_db = Mock(spec=Database)
+
+        policy = HealthyAllPolicy(3, 0.01)
+        with pytest.raises(UnhealthyDatabaseException, match="Unhealthy database"):
+            policy.execute([mock_hc1, mock_hc2], mock_db)
+            assert mock_hc1.check_health.call_count == hc1_call_count
+            assert mock_hc2.check_health.call_count == hc2_call_count
+
+
+@pytest.mark.onlynoncluster
+class TestHealthyAnyPolicy:
+    @pytest.mark.parametrize(
+        "hc1_side_effect,hc2_side_effect,hc1_call_count,hc2_call_count,expected_result",
+        [
+            ([False, False, False], [True, True, True], 3, 0, False),
+            ([False, False, True], [False, False, False], 3, 3, False),
+            ([False, True, True], [False, False, True], 2, 3, True),
+            ([True, True, True], [False, True, False], 1, 2, True),
+        ],
+        ids=[
+            "HC1 - no successful",
+            "HC2 - no successful",
+            "HC1 - successful",
+            "HC2 - successful",
+        ],
+    )
+    def test_policy_returns_true_for_any_successful_probe(
+        self,
+        hc1_side_effect,
+        hc2_side_effect,
+        hc1_call_count,
+        hc2_call_count,
+        expected_result,
+    ):
+        mock_hc1 = Mock(spec=HealthCheck)
+        mock_hc2 = Mock(spec=HealthCheck)
+        mock_hc1.check_health.side_effect = hc1_side_effect
+        mock_hc2.check_health.side_effect = hc2_side_effect
+        mock_db = Mock(spec=Database)
+
+        policy = HealthyAnyPolicy(3, 0.01)
+        assert policy.execute([mock_hc1, mock_hc2], mock_db) == expected_result
+        assert mock_hc1.check_health.call_count == hc1_call_count
+        assert mock_hc2.check_health.call_count == hc2_call_count
+
+    def test_policy_raise_unhealthy_database_exception_if_exception_occurs_on_failed_health_check(
+        self,
+    ):
+        mock_hc1 = Mock(spec=HealthCheck)
+        mock_hc2 = Mock(spec=HealthCheck)
+        mock_hc1.check_health.side_effect = [False, False, ConnectionError]
+        mock_hc2.check_health.side_effect = [True, True, True]
+        mock_db = Mock(spec=Database)
+
+        policy = HealthyAnyPolicy(3, 0.01)
+        with pytest.raises(UnhealthyDatabaseException, match="Unhealthy database"):
+            policy.execute([mock_hc1, mock_hc2], mock_db)
+            assert mock_hc1.check_health.call_count == 3
+            assert mock_hc2.check_health.call_count == 0
+
+
+@pytest.mark.onlynoncluster
+class TestEchoHealthCheck:
+    def test_database_is_healthy_on_echo_response(self, mock_client, mock_cb):
+        """
+        Mocking responses to mix error and actual responses to ensure that health check retry
+        according to given configuration.
+        """
+        mock_client.execute_command.return_value = "healthcheck"
+        hc = EchoHealthCheck()
+        db = Database(mock_client, mock_cb, 0.9)
+
+        assert hc.check_health(db)
+        assert mock_client.execute_command.call_count == 1
+
+    def test_database_is_unhealthy_on_incorrect_echo_response(
+        self, mock_client, mock_cb
+    ):
+        """
+        Mocking responses to mix error and actual responses to ensure that health check retry
+        according to given configuration.
+        """
+        mock_client.execute_command.return_value = "wrong"
+        hc = EchoHealthCheck()
+        db = Database(mock_client, mock_cb, 0.9)
+
+        assert not hc.check_health(db)
+        assert mock_client.execute_command.call_count == 1
+
+    def test_database_close_circuit_on_successful_healthcheck(
+        self, mock_client, mock_cb
+    ):
+        mock_client.execute_command.return_value = "healthcheck"
+        mock_cb.state = CBState.HALF_OPEN
+        hc = EchoHealthCheck()
+        db = Database(mock_client, mock_cb, 0.9)
+
+        assert hc.check_health(db)
+        assert mock_client.execute_command.call_count == 1
+
+
+@pytest.mark.onlynoncluster
+class TestLagAwareHealthCheck:
+    def test_database_is_healthy_when_bdb_matches_by_dns_name(
+        self, mock_client, mock_cb
+    ):
+        """
+        Ensures health check succeeds when /v1/bdbs contains an endpoint whose dns_name
+        matches database host, and availability endpoint returns success.
+        """
+        host = "db1.example.com"
+        mock_client.get_connection_kwargs.return_value = {"host": host}
+
+        # Mock HttpClient used inside LagAwareHealthCheck
+        mock_http = MagicMock()
+        mock_http.get.side_effect = [
+            # First call: list of bdbs
+            [
+                {
+                    "uid": "bdb-1",
+                    "endpoints": [
+                        {"dns_name": host, "addr": ["10.0.0.1", "10.0.0.2"]},
+                    ],
+                }
+            ],
+            # Second call: availability check (no JSON expected)
+            None,
+        ]
+
+        hc = LagAwareHealthCheck(rest_api_port=1234, lag_aware_tolerance=150)
+        # Inject our mocked http client
+        hc._http_client = mock_http
+
+        db = Database(mock_client, mock_cb, 1.0, "https://healthcheck.example.com")
+
+        assert hc.check_health(db) is True
+        # Base URL must be set correctly
+        assert hc._http_client.base_url == "https://healthcheck.example.com:1234"
+        # Calls: first to list bdbs, then to availability
+        assert mock_http.get.call_count == 2
+        first_call = mock_http.get.call_args_list[0]
+        second_call = mock_http.get.call_args_list[1]
+        assert first_call.args[0] == "/v1/bdbs"
+        assert (
+            second_call.args[0]
+            == "/v1/bdbs/bdb-1/availability?extend_check=lag&availability_lag_tolerance_ms=150"
+        )
+        assert second_call.kwargs.get("expect_json") is False
+
+    def test_database_is_healthy_when_bdb_matches_by_addr(self, mock_client, mock_cb):
+        """
+        Ensures health check succeeds when endpoint addr list contains the database host.
+        """
+        host_ip = "203.0.113.5"
+        mock_client.get_connection_kwargs.return_value = {"host": host_ip}
+
+        mock_http = MagicMock()
+        mock_http.get.side_effect = [
+            [
+                {
+                    "uid": "bdb-42",
+                    "endpoints": [
+                        {"dns_name": "not-matching.example.com", "addr": [host_ip]},
+                    ],
+                }
+            ],
+            None,
+        ]
+
+        hc = LagAwareHealthCheck()
+        hc._http_client = mock_http
+
+        db = Database(mock_client, mock_cb, 1.0, "https://healthcheck.example.com")
+
+        assert hc.check_health(db) is True
+        assert mock_http.get.call_count == 2
+        assert (
+            mock_http.get.call_args_list[1].args[0]
+            == "/v1/bdbs/bdb-42/availability?extend_check=lag&availability_lag_tolerance_ms=5000"
+        )
+
+    def test_raises_value_error_when_no_matching_bdb(self, mock_client, mock_cb):
+        """
+        Ensures health check raises ValueError when there's no bdb matching the database host.
+        """
+        host = "db2.example.com"
+        mock_client.get_connection_kwargs.return_value = {"host": host}
+
+        mock_http = MagicMock()
+        # Return bdbs that do not match host by dns_name nor addr
+        mock_http.get.return_value = [
+            {
+                "uid": "a",
+                "endpoints": [{"dns_name": "other.example.com", "addr": ["10.0.0.9"]}],
+            },
+            {
+                "uid": "b",
+                "endpoints": [
+                    {"dns_name": "another.example.com", "addr": ["10.0.0.10"]}
+                ],
+            },
+        ]
+
+        hc = LagAwareHealthCheck()
+        hc._http_client = mock_http
+
+        db = Database(mock_client, mock_cb, 1.0, "https://healthcheck.example.com")
+
+        with pytest.raises(ValueError, match="Could not find a matching bdb"):
+            hc.check_health(db)
+
+        # Only the listing call should have happened
+        mock_http.get.assert_called_once_with("/v1/bdbs")
+
+    def test_propagates_http_error_from_availability(self, mock_client, mock_cb):
+        """
+        Ensures that any HTTP error raised by the availability endpoint is propagated.
+        """
+        host = "db3.example.com"
+        mock_client.get_connection_kwargs.return_value = {"host": host}
+
+        mock_http = MagicMock()
+        # First: list bdbs -> match by dns_name
+        mock_http.get.side_effect = [
+            [{"uid": "bdb-err", "endpoints": [{"dns_name": host, "addr": []}]}],
+            # Second: availability -> raise HttpError
+            HttpError(
+                url=f"https://{host}:9443/v1/bdbs/bdb-err/availability",
+                status=503,
+                message="busy",
+            ),
+        ]
+
+        hc = LagAwareHealthCheck()
+        hc._http_client = mock_http
+
+        db = Database(mock_client, mock_cb, 1.0, "https://healthcheck.example.com")
+
+        with pytest.raises(HttpError, match="busy") as e:
+            hc.check_health(db)
+            assert e.status == 503
+
+        # Ensure both calls were attempted
+        assert mock_http.get.call_count == 2
diff --git a/tests/test_multidb/test_pipeline.py b/tests/test_multidb/test_pipeline.py
new file mode 100644
index 0000000000..0055718d4f
--- /dev/null
+++ b/tests/test_multidb/test_pipeline.py
@@ -0,0 +1,489 @@
+import threading
+from time import sleep
+from unittest.mock import patch, Mock
+
+import pybreaker
+import pytest
+
+from redis.client import Pipeline
+from redis.multidb.circuit import State as CBState, PBCircuitBreakerAdapter
+from redis.multidb.client import MultiDBClient
+from redis.multidb.failover import (
+    WeightBasedFailoverStrategy,
+)
+from tests.test_multidb.conftest import create_weighted_list
+
+
+def mock_pipe() -> Pipeline:
+    mock_pipe = Mock(spec=Pipeline)
+    mock_pipe.__enter__ = Mock(return_value=mock_pipe)
+    mock_pipe.__exit__ = Mock(return_value=None)
+    return mock_pipe
+
+
+@pytest.mark.onlynoncluster
+class TestPipeline:
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_executes_pipeline_against_correct_db(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            pipe = mock_pipe()
+            pipe.execute.return_value = ["OK1", "value1"]
+            mock_db1.client.pipeline.return_value = pipe
+
+            mock_hc.check_health.return_value = True
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+
+            pipe = client.pipeline()
+            pipe.set("key1", "value1")
+            pipe.get("key1")
+
+            assert pipe.execute() == ["OK1", "value1"]
+            assert mock_hc.check_health.call_count == 9
+
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.OPEN}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_execute_pipeline_against_correct_db_and_closed_circuit(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            pipe = mock_pipe()
+            pipe.execute.return_value = ["OK1", "value1"]
+            mock_db1.client.pipeline.return_value = pipe
+
+            mock_hc.check_health.side_effect = [
+                False,
+                True,
+                True,
+                True,
+                True,
+                True,
+                True,
+            ]
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+
+            with client.pipeline() as pipe:
+                pipe.set("key1", "value1")
+                pipe.get("key1")
+
+            assert pipe.execute() == ["OK1", "value1"]
+            assert mock_hc.check_health.call_count == 7
+
+            assert mock_db.circuit.state == CBState.CLOSED
+            assert mock_db1.circuit.state == CBState.CLOSED
+            assert mock_db2.circuit.state == CBState.OPEN
+
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {"health_check_probes": 1},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_execute_pipeline_against_correct_db_on_background_health_check_determine_active_db_unhealthy(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        cb = PBCircuitBreakerAdapter(pybreaker.CircuitBreaker(reset_timeout=5))
+        cb.database = mock_db
+        mock_db.circuit = cb
+
+        cb1 = PBCircuitBreakerAdapter(pybreaker.CircuitBreaker(reset_timeout=5))
+        cb1.database = mock_db1
+        mock_db1.circuit = cb1
+
+        cb2 = PBCircuitBreakerAdapter(pybreaker.CircuitBreaker(reset_timeout=5))
+        cb2.database = mock_db2
+        mock_db2.circuit = cb2
+
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        # Track health check runs across all databases
+        health_check_run = 0
+
+        # Create events for each failover scenario
+        db1_became_unhealthy = threading.Event()
+        db2_became_unhealthy = threading.Event()
+        db_became_unhealthy = threading.Event()
+        counter_lock = threading.Lock()
+
+        def mock_check_health(database):
+            nonlocal health_check_run
+
+            # Increment run counter for each health check call
+            with counter_lock:
+                health_check_run += 1
+                current_run = health_check_run
+
+            # Run 1 (health_check_run 1-3): All databases healthy
+            if current_run <= 3:
+                return True
+
+            # Run 2 (health_check_run 4-6): mock_db1 unhealthy, others healthy
+            elif current_run <= 6:
+                if database == mock_db1:
+                    if current_run == 6:
+                        db1_became_unhealthy.set()
+                    return False
+
+                # Signal that db1 has become unhealthy after all 3 checks
+                if current_run == 6:
+                    db1_became_unhealthy.set()
+                return True
+
+            # Run 3 (health_check_run 7-9): mock_db1 and mock_db2 unhealthy, mock_db healthy
+            elif current_run <= 9:
+                if database == mock_db1 or database == mock_db2:
+                    if current_run == 9:
+                        db2_became_unhealthy.set()
+                    return False
+
+                # Signal that db2 has become unhealthy after all 3 checks
+                if current_run == 9:
+                    db2_became_unhealthy.set()
+                return True
+
+            # Run 4 (health_check_run 10-12): mock_db unhealthy, others healthy
+            else:
+                if database == mock_db:
+                    if current_run >= 12:
+                        db_became_unhealthy.set()
+                    return False
+
+                # Signal that db has become unhealthy after all 3 checks
+                if current_run >= 12:
+                    db_became_unhealthy.set()
+                return True
+
+        mock_hc.check_health.side_effect = mock_check_health
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config,
+                "default_health_checks",
+                return_value=[mock_hc],
+            ),
+        ):
+            pipe = mock_pipe()
+            pipe.execute.return_value = ["OK", "value"]
+            mock_db.client.pipeline.return_value = pipe
+
+            pipe1 = mock_pipe()
+            pipe1.execute.return_value = ["OK1", "value"]
+            mock_db1.client.pipeline.return_value = pipe1
+
+            pipe2 = mock_pipe()
+            pipe2.execute.return_value = ["OK2", "value"]
+            mock_db2.client.pipeline.return_value = pipe2
+
+            mock_multi_db_config.health_check_interval = 0.1
+            mock_multi_db_config.failover_strategy = WeightBasedFailoverStrategy()
+
+            client = MultiDBClient(mock_multi_db_config)
+
+            with client.pipeline() as pipe:
+                pipe.set("key1", "value")
+                pipe.get("key1")
+
+                # Run 1: All databases healthy - should use mock_db1 (highest weight 0.7)
+                assert pipe.execute() == ["OK1", "value"]
+
+                # Wait for mock_db1 to become unhealthy
+                assert db1_became_unhealthy.wait(timeout=1.0), (
+                    "Timeout waiting for mock_db1 to become unhealthy"
+                )
+                sleep(0.01)
+
+                # Run 2: mock_db1 unhealthy - should failover to mock_db2 (weight 0.5)
+                assert pipe.execute() == ["OK2", "value"]
+
+                # Wait for mock_db2 to become unhealthy
+                assert db2_became_unhealthy.wait(timeout=1.0), (
+                    "Timeout waiting for mock_db2 to become unhealthy"
+                )
+                sleep(0.01)
+
+                # Run 3: mock_db1 and mock_db2 unhealthy - should use mock_db (weight 0.2)
+                assert pipe.execute() == ["OK", "value"]
+
+                # Wait for mock_db to become unhealthy
+                assert db_became_unhealthy.wait(timeout=1.0), (
+                    "Timeout waiting for mock_db to become unhealthy"
+                )
+                sleep(0.01)
+
+                # Run 4: mock_db unhealthy, others healthy - should use mock_db1 (highest weight)
+                assert pipe.execute() == ["OK1", "value"]
+
+
+@pytest.mark.onlynoncluster
+class TestTransaction:
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_executes_transaction_against_correct_db(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_db1.client.transaction.return_value = ["OK1", "value1"]
+
+            mock_hc.check_health.return_value = True
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+
+            def callback(pipe: Pipeline):
+                pipe.set("key1", "value1")
+                pipe.get("key1")
+
+            assert client.transaction(callback) == ["OK1", "value1"]
+            assert mock_hc.check_health.call_count == 9
+
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.OPEN}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_execute_transaction_against_correct_db_and_closed_circuit(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
+            ),
+        ):
+            mock_db1.client.transaction.return_value = ["OK1", "value1"]
+
+            mock_hc.check_health.side_effect = [
+                False,
+                True,
+                True,
+                True,
+                True,
+                True,
+                True,
+            ]
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+
+            def callback(pipe: Pipeline):
+                pipe.set("key1", "value1")
+                pipe.get("key1")
+
+            assert client.transaction(callback) == ["OK1", "value1"]
+            assert mock_hc.check_health.call_count == 7
+
+            assert mock_db.circuit.state == CBState.CLOSED
+            assert mock_db1.circuit.state == CBState.CLOSED
+            assert mock_db2.circuit.state == CBState.OPEN
+
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {"health_check_probes": 1},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_execute_transaction_against_correct_db_on_background_health_check_determine_active_db_unhealthy(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        cb = PBCircuitBreakerAdapter(pybreaker.CircuitBreaker(reset_timeout=5))
+        cb.database = mock_db
+        mock_db.circuit = cb
+
+        cb1 = PBCircuitBreakerAdapter(pybreaker.CircuitBreaker(reset_timeout=5))
+        cb1.database = mock_db1
+        mock_db1.circuit = cb1
+
+        cb2 = PBCircuitBreakerAdapter(pybreaker.CircuitBreaker(reset_timeout=5))
+        cb2.database = mock_db2
+        mock_db2.circuit = cb2
+
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+
+        # Track health check runs across all databases
+        health_check_run = 0
+
+        # Create events for each failover scenario
+        db1_became_unhealthy = threading.Event()
+        db2_became_unhealthy = threading.Event()
+        db_became_unhealthy = threading.Event()
+        counter_lock = threading.Lock()
+
+        def mock_check_health(database):
+            nonlocal health_check_run
+
+            # Increment run counter for each health check call
+            with counter_lock:
+                health_check_run += 1
+                current_run = health_check_run
+
+            # Run 1 (health_check_run 1-3): All databases healthy
+            if current_run <= 3:
+                return True
+
+            # Run 2 (health_check_run 4-6): mock_db1 unhealthy, others healthy
+            elif current_run <= 6:
+                if database == mock_db1:
+                    if current_run == 6:
+                        db1_became_unhealthy.set()
+                    return False
+
+                # Signal that db1 has become unhealthy after all 3 checks
+                if current_run == 6:
+                    db1_became_unhealthy.set()
+                return True
+
+            # Run 3 (health_check_run 7-9): mock_db1 and mock_db2 unhealthy, mock_db healthy
+            elif current_run <= 9:
+                if database == mock_db1 or database == mock_db2:
+                    if current_run == 9:
+                        db2_became_unhealthy.set()
+                    return False
+
+                # Signal that db2 has become unhealthy after all 3 checks
+                if current_run == 9:
+                    db2_became_unhealthy.set()
+                return True
+
+            # Run 4 (health_check_run 10-12): mock_db unhealthy, others healthy
+            else:
+                if database == mock_db:
+                    if current_run >= 12:
+                        db_became_unhealthy.set()
+                    return False
+
+                # Signal that db has become unhealthy after all 3 checks
+                if current_run >= 12:
+                    db_became_unhealthy.set()
+                return True
+
+        mock_hc.check_health.side_effect = mock_check_health
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+            patch.object(
+                mock_multi_db_config,
+                "default_health_checks",
+                return_value=[mock_hc],
+            ),
+        ):
+            mock_db.client.transaction.return_value = ["OK", "value"]
+            mock_db1.client.transaction.return_value = ["OK1", "value"]
+            mock_db2.client.transaction.return_value = ["OK2", "value"]
+
+            mock_multi_db_config.health_check_interval = 0.1
+            mock_multi_db_config.failover_strategy = WeightBasedFailoverStrategy()
+
+            client = MultiDBClient(mock_multi_db_config)
+
+            def callback(pipe: Pipeline):
+                pipe.set("key1", "value1")
+                pipe.get("key1")
+
+            # Run 1: All databases healthy - should use mock_db1 (highest weight 0.7)
+            assert client.transaction(callback) == ["OK1", "value"]
+
+            # Wait for mock_db1 to become unhealthy
+            assert db1_became_unhealthy.wait(timeout=1.0), (
+                "Timeout waiting for mock_db1 to become unhealthy"
+            )
+            sleep(0.01)
+
+            # Run 2: mock_db1 unhealthy - should failover to mock_db2 (weight 0.5)
+            assert client.transaction(callback) == ["OK2", "value"]
+
+            # Wait for mock_db2 to become unhealthy
+            assert db2_became_unhealthy.wait(timeout=1.0), (
+                "Timeout waiting for mock_db2 to become unhealthy"
+            )
+            sleep(0.01)
+
+            # Run 3: mock_db1 and mock_db2 unhealthy - should use mock_db (weight 0.2)
+            assert client.transaction(callback) == ["OK", "value"]
+
+            # Wait for mock_db to become unhealthy
+            assert db_became_unhealthy.wait(timeout=1.0), (
+                "Timeout waiting for mock_db to become unhealthy"
+            )
+            sleep(0.01)
+
+            # Run 4: mock_db unhealthy, others healthy - should use mock_db1 (highest weight)
+            assert client.transaction(callback) == ["OK1", "value"]
diff --git a/tests/test_scenario/conftest.py b/tests/test_scenario/conftest.py
index 531d09baa4..409f3088ca 100644
--- a/tests/test_scenario/conftest.py
+++ b/tests/test_scenario/conftest.py
@@ -1,11 +1,24 @@
 import json
 import logging
 import os
+import re
 from typing import Optional
 from urllib.parse import urlparse
+
 import pytest
 
-from redis.backoff import ExponentialWithJitterBackoff, NoBackoff
+from redis.backoff import NoBackoff, ExponentialBackoff
+from redis.event import EventDispatcher, EventListenerInterface
+from redis.multidb.client import MultiDBClient
+from redis.multidb.config import (
+    DatabaseConfig,
+    MultiDbConfig,
+    DEFAULT_HEALTH_CHECK_INTERVAL,
+)
+from redis.multidb.event import ActiveDatabaseChanged
+from redis.multidb.failure_detector import DEFAULT_MIN_NUM_FAILURES
+from redis.multidb.healthcheck import DEFAULT_HEALTH_CHECK_DELAY
+from redis.backoff import ExponentialWithJitterBackoff
 from redis.client import Redis
 from redis.maint_notifications import EndpointType, MaintNotificationsConfig
 from redis.retry import Retry
@@ -17,6 +30,14 @@
 DEFAULT_ENDPOINT_NAME = "m-standard"
 
 
+class CheckActiveDatabaseChangedListener(EventListenerInterface):
+    def __init__(self):
+        self.is_changed_flag = False
+
+    def listen(self, event: ActiveDatabaseChanged):
+        self.is_changed_flag = True
+
+
 @pytest.fixture()
 def endpoint_name(request):
     return request.config.getoption("--endpoint-name") or os.getenv(
@@ -24,8 +45,7 @@ def endpoint_name(request):
     )
 
 
-@pytest.fixture()
-def endpoints_config(endpoint_name: str):
+def get_endpoints_config(endpoint_name: str):
     endpoints_config = os.getenv("REDIS_ENDPOINTS_CONFIG_PATH", None)
 
     if not (endpoints_config and os.path.exists(endpoints_config)):
@@ -42,12 +62,108 @@ def endpoints_config(endpoint_name: str):
         ) from e
 
 
+@pytest.fixture()
+def endpoints_config(endpoint_name: str):
+    return get_endpoints_config(endpoint_name)
+
+
 @pytest.fixture()
 def fault_injector_client():
     url = os.getenv("FAULT_INJECTION_API_URL", "http://127.0.0.1:20324")
     return FaultInjectorClient(url)
 
 
+@pytest.fixture()
+def r_multi_db(
+    request,
+) -> tuple[MultiDBClient, CheckActiveDatabaseChangedListener, dict]:
+    client_class = request.param.get("client_class", Redis)
+
+    if client_class == Redis:
+        endpoint_config = get_endpoints_config("re-active-active")
+    else:
+        endpoint_config = get_endpoints_config("re-active-active-oss-cluster")
+
+    username = endpoint_config.get("username", None)
+    password = endpoint_config.get("password", None)
+    min_num_failures = request.param.get("min_num_failures", DEFAULT_MIN_NUM_FAILURES)
+    command_retry = request.param.get(
+        "command_retry", Retry(ExponentialBackoff(cap=0.1, base=0.01), retries=10)
+    )
+
+    # Retry configuration different for health checks as initial health check require more time in case
+    # if infrastructure wasn't restored from the previous test.
+    health_check_interval = request.param.get(
+        "health_check_interval", DEFAULT_HEALTH_CHECK_INTERVAL
+    )
+    health_check_delay = request.param.get(
+        "health_check_delay", DEFAULT_HEALTH_CHECK_DELAY
+    )
+    event_dispatcher = EventDispatcher()
+    listener = CheckActiveDatabaseChangedListener()
+    event_dispatcher.register_listeners(
+        {
+            ActiveDatabaseChanged: [listener],
+        }
+    )
+    db_configs = []
+
+    db_config = DatabaseConfig(
+        weight=1.0,
+        from_url=endpoint_config["endpoints"][0],
+        client_kwargs={
+            "username": username,
+            "password": password,
+            "decode_responses": True,
+        },
+        health_check_url=extract_cluster_fqdn(endpoint_config["endpoints"][0]),
+    )
+    db_configs.append(db_config)
+
+    db_config1 = DatabaseConfig(
+        weight=0.9,
+        from_url=endpoint_config["endpoints"][1],
+        client_kwargs={
+            "username": username,
+            "password": password,
+            "decode_responses": True,
+        },
+        health_check_url=extract_cluster_fqdn(endpoint_config["endpoints"][1]),
+    )
+    db_configs.append(db_config1)
+
+    config = MultiDbConfig(
+        client_class=client_class,
+        databases_config=db_configs,
+        command_retry=command_retry,
+        min_num_failures=min_num_failures,
+        health_check_probes=3,
+        health_check_interval=health_check_interval,
+        event_dispatcher=event_dispatcher,
+        health_check_probes_delay=health_check_delay,
+    )
+
+    return MultiDBClient(config), listener, endpoint_config
+
+
+def extract_cluster_fqdn(url):
+    """
+    Extract Cluster FQDN from Redis URL
+    """
+    # Parse the URL
+    parsed = urlparse(url)
+
+    # Extract hostname and port
+    hostname = parsed.hostname
+
+    # Remove the 'redis-XXXX.' prefix using regex
+    # This pattern matches 'redis-' followed by digits and a dot
+    cleaned_hostname = re.sub(r"^redis-\d+\.", "", hostname)
+
+    # Reconstruct the URL
+    return f"https://{cleaned_hostname}"
+
+
 @pytest.fixture()
 def client_maint_notifications(endpoints_config):
     return _get_client_maint_notifications(endpoints_config)
diff --git a/tests/test_scenario/test_active_active.py b/tests/test_scenario/test_active_active.py
new file mode 100644
index 0000000000..59524ab5c1
--- /dev/null
+++ b/tests/test_scenario/test_active_active.py
@@ -0,0 +1,460 @@
+import json
+import logging
+import os
+import threading
+from time import sleep
+
+import pytest
+
+from redis import Redis, RedisCluster
+from redis.backoff import ConstantBackoff
+from redis.client import Pipeline
+from redis.multidb.exception import TemporaryUnavailableException
+from redis.multidb.failover import DEFAULT_FAILOVER_ATTEMPTS, DEFAULT_FAILOVER_DELAY
+from redis.multidb.healthcheck import LagAwareHealthCheck
+from redis.retry import Retry
+from redis.utils import dummy_fail
+from tests.test_scenario.fault_injector_client import ActionRequest, ActionType
+
+logger = logging.getLogger(__name__)
+
+
+def trigger_network_failure_action(
+    fault_injector_client, config, event: threading.Event = None
+):
+    action_request = ActionRequest(
+        action_type=ActionType.NETWORK_FAILURE,
+        parameters={"bdb_id": config["bdb_id"], "delay": 3, "cluster_index": 0},
+    )
+
+    result = fault_injector_client.trigger_action(action_request)
+    status_result = fault_injector_client.get_action_status(result["action_id"])
+
+    while status_result["status"] != "success":
+        sleep(0.1)
+        status_result = fault_injector_client.get_action_status(result["action_id"])
+        logger.info(
+            f"Waiting for action to complete. Status: {status_result['status']}"
+        )
+
+    if event:
+        event.set()
+
+    logger.info(f"Action completed. Status: {status_result['status']}")
+
+
+class TestActiveActive:
+    def teardown_method(self, method):
+        # Timeout so the cluster could recover from network failure.
+        sleep(10)
+
+    @pytest.mark.parametrize(
+        "r_multi_db",
+        [
+            {"client_class": Redis, "min_num_failures": 2},
+            {"client_class": RedisCluster, "min_num_failures": 2},
+        ],
+        ids=["standalone", "cluster"],
+        indirect=True,
+    )
+    @pytest.mark.timeout(100)
+    def test_multi_db_client_failover_to_another_db(
+        self, r_multi_db, fault_injector_client
+    ):
+        r_multi_db, listener, config = r_multi_db
+
+        # Handle unavailable databases from previous test.
+        retry = Retry(
+            supported_errors=(TemporaryUnavailableException,),
+            retries=DEFAULT_FAILOVER_ATTEMPTS,
+            backoff=ConstantBackoff(backoff=DEFAULT_FAILOVER_DELAY),
+        )
+
+        event = threading.Event()
+        thread = threading.Thread(
+            target=trigger_network_failure_action,
+            daemon=True,
+            args=(fault_injector_client, config, event),
+        )
+
+        # Client initialized on the first command.
+        retry.call_with_retry(
+            lambda: r_multi_db.set("key", "value"), lambda _: dummy_fail()
+        )
+        thread.start()
+
+        # Execute commands before network failure
+        while not event.is_set():
+            assert (
+                retry.call_with_retry(
+                    lambda: r_multi_db.get("key"), lambda _: dummy_fail()
+                )
+                == "value"
+            )
+            sleep(0.5)
+
+        # Execute commands until database failover
+        while not listener.is_changed_flag:
+            assert (
+                retry.call_with_retry(
+                    lambda: r_multi_db.get("key"), lambda _: dummy_fail()
+                )
+                == "value"
+            )
+            sleep(0.5)
+
+    @pytest.mark.parametrize(
+        "r_multi_db",
+        [
+            {"client_class": Redis, "min_num_failures": 2, "health_check_interval": 20},
+            {
+                "client_class": RedisCluster,
+                "min_num_failures": 2,
+                "health_check_interval": 20,
+            },
+        ],
+        ids=["standalone", "cluster"],
+        indirect=True,
+    )
+    @pytest.mark.timeout(100)
+    def test_multi_db_client_uses_lag_aware_health_check(
+        self, r_multi_db, fault_injector_client
+    ):
+        r_multi_db, listener, config = r_multi_db
+        retry = Retry(
+            supported_errors=(TemporaryUnavailableException,),
+            retries=DEFAULT_FAILOVER_ATTEMPTS,
+            backoff=ConstantBackoff(backoff=DEFAULT_FAILOVER_DELAY),
+        )
+
+        event = threading.Event()
+        thread = threading.Thread(
+            target=trigger_network_failure_action,
+            daemon=True,
+            args=(fault_injector_client, config, event),
+        )
+
+        env0_username = os.getenv("ENV0_USERNAME")
+        env0_password = os.getenv("ENV0_PASSWORD")
+
+        # Adding additional health check to the client.
+        r_multi_db.add_health_check(
+            LagAwareHealthCheck(
+                verify_tls=False,
+                auth_basic=(env0_username, env0_password),
+                lag_aware_tolerance=10000,
+            )
+        )
+
+        # Client initialized on the first command.
+        retry.call_with_retry(
+            lambda: r_multi_db.set("key", "value"), lambda _: dummy_fail()
+        )
+        thread.start()
+
+        # Execute commands before network failure
+        while not event.is_set():
+            assert (
+                retry.call_with_retry(
+                    lambda: r_multi_db.get("key"), lambda _: dummy_fail()
+                )
+                == "value"
+            )
+            sleep(0.5)
+
+        # Execute commands after network failure
+        while not listener.is_changed_flag:
+            assert (
+                retry.call_with_retry(
+                    lambda: r_multi_db.get("key"), lambda _: dummy_fail()
+                )
+                == "value"
+            )
+            sleep(0.5)
+
+    @pytest.mark.parametrize(
+        "r_multi_db",
+        [
+            {"client_class": Redis, "min_num_failures": 2},
+            {"client_class": RedisCluster, "min_num_failures": 2},
+        ],
+        ids=["standalone", "cluster"],
+        indirect=True,
+    )
+    @pytest.mark.timeout(100)
+    def test_context_manager_pipeline_failover_to_another_db(
+        self, r_multi_db, fault_injector_client
+    ):
+        r_multi_db, listener, config = r_multi_db
+        retry = Retry(
+            supported_errors=(TemporaryUnavailableException,),
+            retries=DEFAULT_FAILOVER_ATTEMPTS,
+            backoff=ConstantBackoff(backoff=DEFAULT_FAILOVER_DELAY),
+        )
+
+        event = threading.Event()
+        thread = threading.Thread(
+            target=trigger_network_failure_action,
+            daemon=True,
+            args=(fault_injector_client, config, event),
+        )
+
+        def callback():
+            with r_multi_db.pipeline() as pipe:
+                pipe.set("{hash}key1", "value1")
+                pipe.set("{hash}key2", "value2")
+                pipe.set("{hash}key3", "value3")
+                pipe.get("{hash}key1")
+                pipe.get("{hash}key2")
+                pipe.get("{hash}key3")
+                assert pipe.execute() == [
+                    True,
+                    True,
+                    True,
+                    "value1",
+                    "value2",
+                    "value3",
+                ]
+
+        # Client initialized on first pipe execution.
+        retry.call_with_retry(lambda: callback(), lambda _: dummy_fail())
+        thread.start()
+
+        # Execute pipeline before network failure
+        while not event.is_set():
+            retry.call_with_retry(lambda: callback(), lambda _: dummy_fail())
+            sleep(0.5)
+
+        # Execute pipeline until database failover
+        for _ in range(5):
+            retry.call_with_retry(lambda: callback(), lambda _: dummy_fail())
+            sleep(0.5)
+
+    @pytest.mark.parametrize(
+        "r_multi_db",
+        [
+            {"client_class": Redis, "min_num_failures": 2},
+            {"client_class": RedisCluster, "min_num_failures": 2},
+        ],
+        ids=["standalone", "cluster"],
+        indirect=True,
+    )
+    @pytest.mark.timeout(100)
+    def test_chaining_pipeline_failover_to_another_db(
+        self, r_multi_db, fault_injector_client
+    ):
+        r_multi_db, listener, config = r_multi_db
+        retry = Retry(
+            supported_errors=(TemporaryUnavailableException,),
+            retries=DEFAULT_FAILOVER_ATTEMPTS,
+            backoff=ConstantBackoff(backoff=DEFAULT_FAILOVER_DELAY),
+        )
+
+        event = threading.Event()
+        thread = threading.Thread(
+            target=trigger_network_failure_action,
+            daemon=True,
+            args=(fault_injector_client, config, event),
+        )
+
+        def callback():
+            pipe = r_multi_db.pipeline()
+            pipe.set("{hash}key1", "value1")
+            pipe.set("{hash}key2", "value2")
+            pipe.set("{hash}key3", "value3")
+            pipe.get("{hash}key1")
+            pipe.get("{hash}key2")
+            pipe.get("{hash}key3")
+            assert pipe.execute() == [True, True, True, "value1", "value2", "value3"]
+
+        # Client initialized on first pipe execution.
+        retry.call_with_retry(lambda: callback(), lambda _: dummy_fail())
+
+        thread.start()
+
+        # Execute pipeline before network failure
+        while not event.is_set():
+            retry.call_with_retry(lambda: callback(), lambda _: dummy_fail())
+        sleep(0.5)
+
+        # Execute pipeline until database failover
+        for _ in range(5):
+            retry.call_with_retry(lambda: callback(), lambda _: dummy_fail())
+        sleep(0.5)
+
+    @pytest.mark.parametrize(
+        "r_multi_db",
+        [
+            {"client_class": Redis, "min_num_failures": 2},
+            {"client_class": RedisCluster, "min_num_failures": 2},
+        ],
+        ids=["standalone", "cluster"],
+        indirect=True,
+    )
+    @pytest.mark.timeout(100)
+    def test_transaction_failover_to_another_db(
+        self, r_multi_db, fault_injector_client
+    ):
+        r_multi_db, listener, config = r_multi_db
+        retry = Retry(
+            supported_errors=(TemporaryUnavailableException,),
+            retries=DEFAULT_FAILOVER_ATTEMPTS,
+            backoff=ConstantBackoff(backoff=DEFAULT_FAILOVER_DELAY),
+        )
+
+        event = threading.Event()
+        thread = threading.Thread(
+            target=trigger_network_failure_action,
+            daemon=True,
+            args=(fault_injector_client, config, event),
+        )
+
+        def callback(pipe: Pipeline):
+            pipe.set("{hash}key1", "value1")
+            pipe.set("{hash}key2", "value2")
+            pipe.set("{hash}key3", "value3")
+            pipe.get("{hash}key1")
+            pipe.get("{hash}key2")
+            pipe.get("{hash}key3")
+
+        # Client initialized on first transaction execution.
+        retry.call_with_retry(
+            lambda: r_multi_db.transaction(callback), lambda _: dummy_fail()
+        )
+        thread.start()
+
+        # Execute transaction before network failure
+        while not event.is_set():
+            retry.call_with_retry(
+                lambda: r_multi_db.transaction(callback), lambda _: dummy_fail()
+            )
+            sleep(0.5)
+
+        # Execute transaction until database failover
+        while not listener.is_changed_flag:
+            retry.call_with_retry(
+                lambda: r_multi_db.transaction(callback), lambda _: dummy_fail()
+            )
+            sleep(0.5)
+
+    @pytest.mark.parametrize(
+        "r_multi_db",
+        [
+            {"client_class": Redis, "min_num_failures": 2},
+            {"client_class": RedisCluster, "min_num_failures": 2},
+        ],
+        ids=["standalone", "cluster"],
+        indirect=True,
+    )
+    @pytest.mark.timeout(100)
+    def test_pubsub_failover_to_another_db(self, r_multi_db, fault_injector_client):
+        r_multi_db, listener, config = r_multi_db
+        retry = Retry(
+            supported_errors=(TemporaryUnavailableException,),
+            retries=DEFAULT_FAILOVER_ATTEMPTS,
+            backoff=ConstantBackoff(backoff=DEFAULT_FAILOVER_DELAY),
+        )
+
+        event = threading.Event()
+        thread = threading.Thread(
+            target=trigger_network_failure_action,
+            daemon=True,
+            args=(fault_injector_client, config, event),
+        )
+        data = json.dumps({"message": "test"})
+        messages_count = 0
+
+        def handler(message):
+            nonlocal messages_count
+            messages_count += 1
+
+        pubsub = r_multi_db.pubsub()
+
+        # Assign a handler and run in a separate thread.
+        retry.call_with_retry(
+            lambda: pubsub.subscribe(**{"test-channel": handler}),
+            lambda _: dummy_fail(),
+        )
+        pubsub_thread = pubsub.run_in_thread(sleep_time=0.1, daemon=True)
+        thread.start()
+
+        # Execute publish before network failure
+        while not event.is_set():
+            retry.call_with_retry(
+                lambda: r_multi_db.publish("test-channel", data), lambda _: dummy_fail()
+            )
+            sleep(0.5)
+
+        # Execute publish until database failover
+        while not listener.is_changed_flag:
+            retry.call_with_retry(
+                lambda: r_multi_db.publish("test-channel", data), lambda _: dummy_fail()
+            )
+            sleep(0.5)
+
+        pubsub_thread.stop()
+        assert messages_count > 2
+
+    @pytest.mark.parametrize(
+        "r_multi_db",
+        [
+            {"client_class": Redis, "min_num_failures": 2},
+            {"client_class": RedisCluster, "min_num_failures": 2},
+        ],
+        ids=["standalone", "cluster"],
+        indirect=True,
+    )
+    @pytest.mark.timeout(100)
+    def test_sharded_pubsub_failover_to_another_db(
+        self, r_multi_db, fault_injector_client
+    ):
+        r_multi_db, listener, config = r_multi_db
+        retry = Retry(
+            supported_errors=(TemporaryUnavailableException,),
+            retries=DEFAULT_FAILOVER_ATTEMPTS,
+            backoff=ConstantBackoff(backoff=DEFAULT_FAILOVER_DELAY),
+        )
+
+        event = threading.Event()
+        thread = threading.Thread(
+            target=trigger_network_failure_action,
+            daemon=True,
+            args=(fault_injector_client, config, event),
+        )
+        data = json.dumps({"message": "test"})
+        messages_count = 0
+
+        def handler(message):
+            nonlocal messages_count
+            messages_count += 1
+
+        pubsub = r_multi_db.pubsub()
+
+        # Assign a handler and run in a separate thread.
+        retry.call_with_retry(
+            lambda: pubsub.ssubscribe(**{"test-channel": handler}),
+            lambda _: dummy_fail(),
+        )
+        pubsub_thread = pubsub.run_in_thread(
+            sleep_time=0.1, daemon=True, sharded_pubsub=True
+        )
+        thread.start()
+
+        # Execute publish before network failure
+        while not event.is_set():
+            retry.call_with_retry(
+                lambda: r_multi_db.spublish("test-channel", data),
+                lambda _: dummy_fail(),
+            )
+            sleep(0.5)
+
+        # Execute publish until database failover
+        while not listener.is_changed_flag:
+            retry.call_with_retry(
+                lambda: r_multi_db.spublish("test-channel", data),
+                lambda _: dummy_fail(),
+            )
+            sleep(0.5)
+
+        pubsub_thread.stop()
+        assert messages_count > 2

From 6520b7bbaaf6fe0c86509a394420d0430ec20876 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 14 Oct 2025 17:59:59 +0300
Subject: [PATCH 1132/1164] Fixing several *arg type hints in core.py and json
 module commands (#3793)

---
 redis/commands/core.py          | 24 +++++++++++-------------
 redis/commands/json/commands.py |  4 ++--
 2 files changed, 13 insertions(+), 15 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index ad21885b3d..d3d802dfb7 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -830,7 +830,7 @@ def command_list(
 
         return self.execute_command("COMMAND LIST", *pieces)
 
-    def command_getkeysandflags(self, *args: List[str]) -> List[Union[str, List[str]]]:
+    def command_getkeysandflags(self, *args: str) -> List[Union[str, List[str]]]:
         """
         Returns array of keys from a full Redis command and their usage flags.
 
@@ -848,7 +848,7 @@ def command_docs(self, *args):
         )
 
     def config_get(
-        self, pattern: PatternT = "*", *args: List[PatternT], **kwargs
+        self, pattern: PatternT = "*", *args: PatternT, **kwargs
     ) -> ResponseT:
         """
         Return a dictionary of configuration based on the ``pattern``
@@ -861,7 +861,7 @@ def config_set(
         self,
         name: KeyT,
         value: EncodableT,
-        *args: List[Union[KeyT, EncodableT]],
+        *args: Union[KeyT, EncodableT],
         **kwargs,
     ) -> ResponseT:
         """Set config item ``name`` with ``value``
@@ -987,9 +987,7 @@ def select(self, index: int, **kwargs) -> ResponseT:
         """
         return self.execute_command("SELECT", index, **kwargs)
 
-    def info(
-        self, section: Optional[str] = None, *args: List[str], **kwargs
-    ) -> ResponseT:
+    def info(self, section: Optional[str] = None, *args: str, **kwargs) -> ResponseT:
         """
         Returns a dictionary containing information about the Redis server
 
@@ -2606,7 +2604,7 @@ def blmpop(
         self,
         timeout: float,
         numkeys: int,
-        *args: List[str],
+        *args: str,
         direction: str,
         count: Optional[int] = 1,
     ) -> Optional[list]:
@@ -2619,14 +2617,14 @@ def blmpop(
 
         For more information, see https://redis.io/commands/blmpop
         """
-        args = [timeout, numkeys, *args, direction, "COUNT", count]
+        cmd_args = [timeout, numkeys, *args, direction, "COUNT", count]
 
-        return self.execute_command("BLMPOP", *args)
+        return self.execute_command("BLMPOP", *cmd_args)
 
     def lmpop(
         self,
         num_keys: int,
-        *args: List[str],
+        *args: str,
         direction: str,
         count: Optional[int] = 1,
     ) -> Union[Awaitable[list], list]:
@@ -2636,11 +2634,11 @@ def lmpop(
 
         For more information, see https://redis.io/commands/lmpop
         """
-        args = [num_keys] + list(args) + [direction]
+        cmd_args = [num_keys] + list(args) + [direction]
         if count != 1:
-            args.extend(["COUNT", count])
+            cmd_args.extend(["COUNT", count])
 
-        return self.execute_command("LMPOP", *args)
+        return self.execute_command("LMPOP", *cmd_args)
 
     def lindex(
         self, name: str, index: int
diff --git a/redis/commands/json/commands.py b/redis/commands/json/commands.py
index 48849e1888..f278daf7a7 100644
--- a/redis/commands/json/commands.py
+++ b/redis/commands/json/commands.py
@@ -14,7 +14,7 @@ class JSONCommands:
     """json commands."""
 
     def arrappend(
-        self, name: str, path: Optional[str] = Path.root_path(), *args: List[JsonType]
+        self, name: str, path: Optional[str] = Path.root_path(), *args: JsonType
     ) -> List[Optional[int]]:
         """Append the objects ``args`` to the array under the
         ``path` in key ``name``.
@@ -52,7 +52,7 @@ def arrindex(
         return self.execute_command("JSON.ARRINDEX", *pieces, keys=[name])
 
     def arrinsert(
-        self, name: str, path: str, index: int, *args: List[JsonType]
+        self, name: str, path: str, index: int, *args: JsonType
     ) -> List[Optional[int]]:
         """Insert the objects ``args`` to the array at index ``index``
         under the ``path` in key ``name``.

From 768ad9c3fdfb4f46a03b64d5b57ce4ff745f19b8 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Wed, 15 Oct 2025 12:04:44 +0300
Subject: [PATCH 1133/1164] Fixing errors reported by mypy in search module
 files - query.py,  commands.py and aggregation.py. (#3666)

---
 redis/commands/search/__init__.py    |  4 +--
 redis/commands/search/aggregation.py | 50 +++++++++++++---------------
 redis/commands/search/commands.py    | 20 +++++------
 redis/commands/search/query.py       | 24 ++++++-------
 4 files changed, 48 insertions(+), 50 deletions(-)

diff --git a/redis/commands/search/__init__.py b/redis/commands/search/__init__.py
index a2bb23b76d..9fda9ee4d6 100644
--- a/redis/commands/search/__init__.py
+++ b/redis/commands/search/__init__.py
@@ -1,4 +1,4 @@
-import redis
+from redis.client import Pipeline as RedisPipeline
 
 from ...asyncio.client import Pipeline as AsyncioPipeline
 from .commands import (
@@ -181,7 +181,7 @@ def pipeline(self, transaction=True, shard_hint=None):
         return p
 
 
-class Pipeline(SearchCommands, redis.client.Pipeline):
+class Pipeline(SearchCommands, RedisPipeline):
     """Pipeline for the module."""
 
 
diff --git a/redis/commands/search/aggregation.py b/redis/commands/search/aggregation.py
index 00435f626b..b3f5895816 100644
--- a/redis/commands/search/aggregation.py
+++ b/redis/commands/search/aggregation.py
@@ -1,4 +1,4 @@
-from typing import List, Union
+from typing import List, Optional, Tuple, Union
 
 from redis.commands.search.dialect import DEFAULT_DIALECT
 
@@ -27,9 +27,9 @@ class Reducer:
     NAME = None
 
     def __init__(self, *args: str) -> None:
-        self._args = args
-        self._field = None
-        self._alias = None
+        self._args: Tuple[str, ...] = args
+        self._field: Optional[str] = None
+        self._alias: Optional[str] = None
 
     def alias(self, alias: str) -> "Reducer":
         """
@@ -49,13 +49,14 @@ def alias(self, alias: str) -> "Reducer":
         if alias is FIELDNAME:
             if not self._field:
                 raise ValueError("Cannot use FIELDNAME alias with no field")
-            # Chop off initial '@'
-            alias = self._field[1:]
+            else:
+                # Chop off initial '@'
+                alias = self._field[1:]
         self._alias = alias
         return self
 
     @property
-    def args(self) -> List[str]:
+    def args(self) -> Tuple[str, ...]:
         return self._args
 
 
@@ -64,7 +65,7 @@ class SortDirection:
     This special class is used to indicate sort direction.
     """
 
-    DIRSTRING = None
+    DIRSTRING: Optional[str] = None
 
     def __init__(self, field: str) -> None:
         self.field = field
@@ -104,17 +105,17 @@ def __init__(self, query: str = "*") -> None:
         All member methods (except `build_args()`)
         return the object itself, making them useful for chaining.
         """
-        self._query = query
-        self._aggregateplan = []
-        self._loadfields = []
-        self._loadall = False
-        self._max = 0
-        self._with_schema = False
-        self._verbatim = False
-        self._cursor = []
-        self._dialect = DEFAULT_DIALECT
-        self._add_scores = False
-        self._scorer = "TFIDF"
+        self._query: str = query
+        self._aggregateplan: List[str] = []
+        self._loadfields: List[str] = []
+        self._loadall: bool = False
+        self._max: int = 0
+        self._with_schema: bool = False
+        self._verbatim: bool = False
+        self._cursor: List[str] = []
+        self._dialect: int = DEFAULT_DIALECT
+        self._add_scores: bool = False
+        self._scorer: str = "TFIDF"
 
     def load(self, *fields: str) -> "AggregateRequest":
         """
@@ -133,7 +134,7 @@ def load(self, *fields: str) -> "AggregateRequest":
         return self
 
     def group_by(
-        self, fields: List[str], *reducers: Union[Reducer, List[Reducer]]
+        self, fields: Union[str, List[str]], *reducers: Reducer
     ) -> "AggregateRequest":
         """
         Specify by which fields to group the aggregation.
@@ -147,7 +148,6 @@ def group_by(
             `aggregation` module.
         """
         fields = [fields] if isinstance(fields, str) else fields
-        reducers = [reducers] if isinstance(reducers, Reducer) else reducers
 
         ret = ["GROUPBY", str(len(fields)), *fields]
         for reducer in reducers:
@@ -251,12 +251,10 @@ def sort_by(self, *fields: str, **kwargs) -> "AggregateRequest":
             .sort_by(Desc("@paid"), max=10)
         ```
         """
-        if isinstance(fields, (str, SortDirection)):
-            fields = [fields]
 
         fields_args = []
         for f in fields:
-            if isinstance(f, SortDirection):
+            if isinstance(f, (Asc, Desc)):
                 fields_args += [f.field, f.DIRSTRING]
             else:
                 fields_args += [f]
@@ -356,7 +354,7 @@ def build_args(self) -> List[str]:
             ret.extend(self._loadfields)
 
         if self._dialect:
-            ret.extend(["DIALECT", self._dialect])
+            ret.extend(["DIALECT", str(self._dialect)])
 
         ret.extend(self._aggregateplan)
 
@@ -393,7 +391,7 @@ def __init__(self, rows, cursor: Cursor, schema) -> None:
         self.cursor = cursor
         self.schema = schema
 
-    def __repr__(self) -> (str, str):
+    def __repr__(self) -> str:
         cid = self.cursor.cid if self.cursor else -1
         return (
             f"<{self.__class__.__name__} at 0x{id(self):x} "
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index 80d9b35728..afe5d1c684 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -221,7 +221,7 @@ def create_index(
 
         return self.execute_command(*args)
 
-    def alter_schema_add(self, fields: List[str]):
+    def alter_schema_add(self, fields: Union[Field, List[Field]]):
         """
         Alter the existing search index by adding new fields. The index
         must already exist.
@@ -336,11 +336,11 @@ def add_document(
         doc_id: str,
         nosave: bool = False,
         score: float = 1.0,
-        payload: bool = None,
+        payload: Optional[bool] = None,
         replace: bool = False,
         partial: bool = False,
         language: Optional[str] = None,
-        no_create: str = False,
+        no_create: bool = False,
         **fields: List[str],
     ):
         """
@@ -464,7 +464,7 @@ def info(self):
         return self._parse_results(INFO_CMD, res)
 
     def get_params_args(
-        self, query_params: Union[Dict[str, Union[str, int, float, bytes]], None]
+        self, query_params: Optional[Dict[str, Union[str, int, float, bytes]]]
     ):
         if query_params is None:
             return []
@@ -478,7 +478,7 @@ def get_params_args(
         return args
 
     def _mk_query_args(
-        self, query, query_params: Union[Dict[str, Union[str, int, float, bytes]], None]
+        self, query, query_params: Optional[Dict[str, Union[str, int, float, bytes]]]
     ):
         args = [self.index_name]
 
@@ -528,7 +528,7 @@ def search(
     def explain(
         self,
         query: Union[str, Query],
-        query_params: Dict[str, Union[str, int, float]] = None,
+        query_params: Optional[Dict[str, Union[str, int, float, bytes]]] = None,
     ):
         """Returns the execution plan for a complex query.
 
@@ -543,7 +543,7 @@ def explain_cli(self, query: Union[str, Query]):  # noqa
     def aggregate(
         self,
         query: Union[AggregateRequest, Cursor],
-        query_params: Dict[str, Union[str, int, float]] = None,
+        query_params: Optional[Dict[str, Union[str, int, float, bytes]]] = None,
     ):
         """
         Issue an aggregation query.
@@ -598,7 +598,7 @@ def profile(
         self,
         query: Union[Query, AggregateRequest],
         limited: bool = False,
-        query_params: Optional[Dict[str, Union[str, int, float]]] = None,
+        query_params: Optional[Dict[str, Union[str, int, float, bytes]]] = None,
     ):
         """
         Performs a search or aggregate command and collects performance
@@ -936,7 +936,7 @@ async def info(self):
     async def search(
         self,
         query: Union[str, Query],
-        query_params: Dict[str, Union[str, int, float]] = None,
+        query_params: Optional[Dict[str, Union[str, int, float, bytes]]] = None,
     ):
         """
         Search the index for a given query, and return a result of documents
@@ -968,7 +968,7 @@ async def search(
     async def aggregate(
         self,
         query: Union[AggregateResult, Cursor],
-        query_params: Dict[str, Union[str, int, float]] = None,
+        query_params: Optional[Dict[str, Union[str, int, float, bytes]]] = None,
     ):
         """
         Issue an aggregation query.
diff --git a/redis/commands/search/query.py b/redis/commands/search/query.py
index ee281fafd0..86d93b8f8a 100644
--- a/redis/commands/search/query.py
+++ b/redis/commands/search/query.py
@@ -1,4 +1,4 @@
-from typing import List, Optional, Union
+from typing import List, Optional, Tuple, Union
 
 from redis.commands.search.dialect import DEFAULT_DIALECT
 
@@ -31,7 +31,7 @@ def __init__(self, query_string: str) -> None:
         self._with_scores: bool = False
         self._scorer: Optional[str] = None
         self._filters: List = list()
-        self._ids: Optional[List[str]] = None
+        self._ids: Optional[Tuple[str, ...]] = None
         self._slop: int = -1
         self._timeout: Optional[float] = None
         self._in_order: bool = False
@@ -81,7 +81,7 @@ def return_field(
             self._return_fields += ("AS", as_field)
         return self
 
-    def _mk_field_list(self, fields: List[str]) -> List:
+    def _mk_field_list(self, fields: Optional[Union[List[str], str]]) -> List:
         if not fields:
             return []
         return [fields] if isinstance(fields, str) else list(fields)
@@ -126,7 +126,7 @@ def summarize(
 
     def highlight(
         self, fields: Optional[List[str]] = None, tags: Optional[List[str]] = None
-    ) -> None:
+    ) -> "Query":
         """
         Apply specified markup to matched term(s) within the returned field(s).
 
@@ -187,16 +187,16 @@ def scorer(self, scorer: str) -> "Query":
         self._scorer = scorer
         return self
 
-    def get_args(self) -> List[str]:
+    def get_args(self) -> List[Union[str, int, float]]:
         """Format the redis arguments for this query and return them."""
-        args = [self._query_string]
+        args: List[Union[str, int, float]] = [self._query_string]
         args += self._get_args_tags()
         args += self._summarize_fields + self._highlight_fields
         args += ["LIMIT", self._offset, self._num]
         return args
 
-    def _get_args_tags(self) -> List[str]:
-        args = []
+    def _get_args_tags(self) -> List[Union[str, int, float]]:
+        args: List[Union[str, int, float]] = []
         if self._no_content:
             args.append("NOCONTENT")
         if self._fields:
@@ -288,14 +288,14 @@ def with_scores(self) -> "Query":
         self._with_scores = True
         return self
 
-    def limit_fields(self, *fields: List[str]) -> "Query":
+    def limit_fields(self, *fields: str) -> "Query":
         """
         Limit the search to specific TEXT fields only.
 
-        - **fields**: A list of strings; case-sensitive field names
+        - **fields**: Each element should be a string, case sensitive field name
         from the defined schema.
         """
-        self._fields = fields
+        self._fields = list(fields)
         return self
 
     def add_filter(self, flt: "Filter") -> "Query":
@@ -340,7 +340,7 @@ def dialect(self, dialect: int) -> "Query":
 
 
 class Filter:
-    def __init__(self, keyword: str, field: str, *args: List[str]) -> None:
+    def __init__(self, keyword: str, field: str, *args: Union[str, float]) -> None:
         self.args = [keyword, field] + list(args)
 
 

From d0e92c67f0733064001190aa55cd30935e5e691d Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 16 Oct 2025 12:51:00 +0300
Subject: [PATCH 1134/1164] Reorganizing the code related to maintenance push
 notifications. (#3785)

* Extracting maintenance push notifications logic in separate abstract classes. Usingle multiple inheritance for Connection and ConnectionPool classes to expose the maintenance push notifications for the existing connections.

* Fixing credential tests and linters errors

* Adding better handling of configs and fixing tests

* Fixing linter- unused import,  and a docstring

* Fixing check for correct parser when protocol is 3

* Moving _should_reconnect related code back to generic ConnectionInterface as it is also used by AA

* Fixing e2e tests redis client setup

* Applying review comments
---
 redis/client.py                            |   51 +-
 redis/cluster.py                           |    6 +
 redis/connection.py                        | 2872 +++++++++++---------
 redis/maint_notifications.py               |   25 +-
 tests/test_credentials.py                  |    7 +-
 tests/test_maint_notifications.py          |    7 +-
 tests/test_maint_notifications_handling.py |  209 +-
 tests/test_scenario/conftest.py            |    4 -
 8 files changed, 1782 insertions(+), 1399 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index b8d2e8af5d..51b699721e 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -58,7 +58,6 @@
 from redis.lock import Lock
 from redis.maint_notifications import (
     MaintNotificationsConfig,
-    MaintNotificationsPoolHandler,
 )
 from redis.retry import Retry
 from redis.utils import (
@@ -278,6 +277,17 @@ def __init__(
         single_connection_client:
             if `True`, connection pool is not used. In that case `Redis`
             instance use is not thread safe.
+        decode_responses:
+            if `True`, the response will be decoded to utf-8.
+            Argument is ignored when connection_pool is provided.
+        maint_notifications_config:
+            configuration the pool to support maintenance notifications - see
+            `redis.maint_notifications.MaintNotificationsConfig` for details.
+            Only supported with RESP3
+            If not provided and protocol is RESP3, the maintenance notifications
+            will be enabled by default (logic is included in the connection pool
+            initialization).
+            Argument is ignored when connection_pool is provided.
         """
         if event_dispatcher is None:
             self._event_dispatcher = EventDispatcher()
@@ -354,6 +364,22 @@ def __init__(
                             "cache_config": cache_config,
                         }
                     )
+                maint_notifications_enabled = (
+                    maint_notifications_config and maint_notifications_config.enabled
+                )
+                if maint_notifications_enabled and protocol not in [
+                    3,
+                    "3",
+                ]:
+                    raise RedisError(
+                        "Maintenance notifications handlers on connection are only supported with RESP version 3"
+                    )
+                if maint_notifications_config:
+                    kwargs.update(
+                        {
+                            "maint_notifications_config": maint_notifications_config,
+                        }
+                    )
             connection_pool = ConnectionPool(**kwargs)
             self._event_dispatcher.dispatch(
                 AfterPooledConnectionsInstantiationEvent(
@@ -377,23 +403,6 @@ def __init__(
         ]:
             raise RedisError("Client caching is only supported with RESP version 3")
 
-        if maint_notifications_config and self.connection_pool.get_protocol() not in [
-            3,
-            "3",
-        ]:
-            raise RedisError(
-                "Push handlers on connection are only supported with RESP version 3"
-            )
-        if maint_notifications_config and maint_notifications_config.enabled:
-            self.maint_notifications_pool_handler = MaintNotificationsPoolHandler(
-                self.connection_pool, maint_notifications_config
-            )
-            self.connection_pool.set_maint_notifications_pool_handler(
-                self.maint_notifications_pool_handler
-            )
-        else:
-            self.maint_notifications_pool_handler = None
-
         self.single_connection_lock = threading.RLock()
         self.connection = None
         self._single_connection_client = single_connection_client
@@ -591,15 +600,9 @@ def monitor(self):
         return Monitor(self.connection_pool)
 
     def client(self):
-        maint_notifications_config = (
-            None
-            if self.maint_notifications_pool_handler is None
-            else self.maint_notifications_pool_handler.config
-        )
         return self.__class__(
             connection_pool=self.connection_pool,
             single_connection_client=True,
-            maint_notifications_config=maint_notifications_config,
         )
 
     def __enter__(self):
diff --git a/redis/cluster.py b/redis/cluster.py
index 1d4a3e0d0c..c238c171be 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -50,6 +50,7 @@
     WatchError,
 )
 from redis.lock import Lock
+from redis.maint_notifications import MaintNotificationsConfig
 from redis.retry import Retry
 from redis.utils import (
     deprecated_args,
@@ -1663,6 +1664,11 @@ def create_redis_node(self, host, port, **kwargs):
             backoff=NoBackoff(), retries=0, supported_errors=(ConnectionError,)
         )
 
+        protocol = kwargs.get("protocol", None)
+        if protocol in [3, "3"]:
+            kwargs.update(
+                {"maint_notifications_config": MaintNotificationsConfig(enabled=False)}
+            )
         if self.from_url:
             # Create a redis node with a costumed connection pool
             kwargs.update({"host": host})
diff --git a/redis/connection.py b/redis/connection.py
index 837fccd40e..35e2bdf9ce 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -5,7 +5,7 @@
 import threading
 import time
 import weakref
-from abc import abstractmethod
+from abc import ABC, abstractmethod
 from itertools import chain
 from queue import Empty, Full, LifoQueue
 from typing import (
@@ -178,10 +178,6 @@ def deregister_connect_callback(self, callback):
     def set_parser(self, parser_class):
         pass
 
-    @abstractmethod
-    def set_maint_notifications_pool_handler(self, maint_notifications_pool_handler):
-        pass
-
     @abstractmethod
     def get_protocol(self):
         pass
@@ -245,29 +241,6 @@ def set_re_auth_token(self, token: TokenInterface):
     def re_auth(self):
         pass
 
-    @property
-    @abstractmethod
-    def maintenance_state(self) -> MaintenanceState:
-        """
-        Returns the current maintenance state of the connection.
-        """
-        pass
-
-    @maintenance_state.setter
-    @abstractmethod
-    def maintenance_state(self, state: "MaintenanceState"):
-        """
-        Sets the current maintenance state of the connection.
-        """
-        pass
-
-    @abstractmethod
-    def getpeername(self):
-        """
-        Returns the peer name of the connection.
-        """
-        pass
-
     @abstractmethod
     def mark_for_reconnect(self):
         """
@@ -284,250 +257,189 @@ def should_reconnect(self):
         pass
 
     @abstractmethod
-    def get_resolved_ip(self):
-        """
-        Get resolved ip address for the connection.
-        """
-        pass
-
-    @abstractmethod
-    def update_current_socket_timeout(self, relaxed_timeout: Optional[float] = None):
+    def reset_should_reconnect(self):
         """
-        Update the timeout for the current socket.
+        Reset the internal flag to False.
         """
         pass
 
-    @abstractmethod
-    def set_tmp_settings(
-        self,
-        tmp_host_address: Optional[str] = None,
-        tmp_relaxed_timeout: Optional[float] = None,
-    ):
-        """
-        Updates temporary host address and timeout settings for the connection.
-        """
-        pass
 
-    @abstractmethod
-    def reset_tmp_settings(
-        self,
-        reset_host_address: bool = False,
-        reset_relaxed_timeout: bool = False,
-    ):
-        """
-        Resets temporary host address and timeout settings for the connection.
-        """
-        pass
+class MaintNotificationsAbstractConnection:
+    """
+    Abstract class for handling maintenance notifications logic.
+    This class is expected to be used as base class together with ConnectionInterface.
 
+    This class is intended to be used with multiple inheritance!
 
-class AbstractConnection(ConnectionInterface):
-    "Manages communication to and from a Redis server"
+    All logic related to maintenance notifications is encapsulated in this class.
+    """
 
     def __init__(
         self,
-        db: int = 0,
-        password: Optional[str] = None,
-        socket_timeout: Optional[float] = None,
-        socket_connect_timeout: Optional[float] = None,
-        retry_on_timeout: bool = False,
-        retry_on_error: Union[Iterable[Type[Exception]], object] = SENTINEL,
-        encoding: str = "utf-8",
-        encoding_errors: str = "strict",
-        decode_responses: bool = False,
-        parser_class=DefaultParser,
-        socket_read_size: int = 65536,
-        health_check_interval: int = 0,
-        client_name: Optional[str] = None,
-        lib_name: Optional[str] = "redis-py",
-        lib_version: Optional[str] = get_lib_version(),
-        username: Optional[str] = None,
-        retry: Union[Any, None] = None,
-        redis_connect_func: Optional[Callable[[], None]] = None,
-        credential_provider: Optional[CredentialProvider] = None,
-        protocol: Optional[int] = 2,
-        command_packer: Optional[Callable[[], None]] = None,
-        event_dispatcher: Optional[EventDispatcher] = None,
+        maint_notifications_config: Optional[MaintNotificationsConfig],
         maint_notifications_pool_handler: Optional[
             MaintNotificationsPoolHandler
         ] = None,
-        maint_notifications_config: Optional[MaintNotificationsConfig] = None,
         maintenance_state: "MaintenanceState" = MaintenanceState.NONE,
         maintenance_notification_hash: Optional[int] = None,
         orig_host_address: Optional[str] = None,
         orig_socket_timeout: Optional[float] = None,
         orig_socket_connect_timeout: Optional[float] = None,
+        parser: Optional[Union[_HiredisParser, _RESP3Parser]] = None,
     ):
         """
-        Initialize a new Connection.
-        To specify a retry policy for specific errors, first set
-        `retry_on_error` to a list of the error/s to retry on, then set
-        `retry` to a valid `Retry` object.
-        To retry on TimeoutError, `retry_on_timeout` can also be set to `True`.
-        """
-        if (username or password) and credential_provider is not None:
-            raise DataError(
-                "'username' and 'password' cannot be passed along with 'credential_"
-                "provider'. Please provide only one of the following arguments: \n"
-                "1. 'password' and (optional) 'username'\n"
-                "2. 'credential_provider'"
-            )
-        if event_dispatcher is None:
-            self._event_dispatcher = EventDispatcher()
-        else:
-            self._event_dispatcher = event_dispatcher
-        self.pid = os.getpid()
-        self.db = db
-        self.client_name = client_name
-        self.lib_name = lib_name
-        self.lib_version = lib_version
-        self.credential_provider = credential_provider
-        self.password = password
-        self.username = username
-        self.socket_timeout = socket_timeout
-        if socket_connect_timeout is None:
-            socket_connect_timeout = socket_timeout
-        self.socket_connect_timeout = socket_connect_timeout
-        self.retry_on_timeout = retry_on_timeout
-        if retry_on_error is SENTINEL:
-            retry_on_errors_list = []
-        else:
-            retry_on_errors_list = list(retry_on_error)
-        if retry_on_timeout:
-            # Add TimeoutError to the errors list to retry on
-            retry_on_errors_list.append(TimeoutError)
-        self.retry_on_error = retry_on_errors_list
-        if retry or self.retry_on_error:
-            if retry is None:
-                self.retry = Retry(NoBackoff(), 1)
-            else:
-                # deep-copy the Retry object as it is mutable
-                self.retry = copy.deepcopy(retry)
-            if self.retry_on_error:
-                # Update the retry's supported errors with the specified errors
-                self.retry.update_supported_errors(self.retry_on_error)
-        else:
-            self.retry = Retry(NoBackoff(), 0)
-        self.health_check_interval = health_check_interval
-        self.next_health_check = 0
-        self.redis_connect_func = redis_connect_func
-        self.encoder = Encoder(encoding, encoding_errors, decode_responses)
-        self.handshake_metadata = None
-        self._sock = None
-        self._socket_read_size = socket_read_size
-        self._connect_callbacks = []
-        self._buffer_cutoff = 6000
-        self._re_auth_token: Optional[TokenInterface] = None
-        try:
-            p = int(protocol)
-        except TypeError:
-            p = DEFAULT_RESP_VERSION
-        except ValueError:
-            raise ConnectionError("protocol must be an integer")
-        finally:
-            if p < 2 or p > 3:
-                raise ConnectionError("protocol must be either 2 or 3")
-                # p = DEFAULT_RESP_VERSION
-            self.protocol = p
-        if self.protocol == 3 and parser_class == DefaultParser:
-            parser_class = _RESP3Parser
-        self.set_parser(parser_class)
+        Initialize the maintenance notifications for the connection.
 
+        Args:
+            maint_notifications_config (MaintNotificationsConfig): The configuration for maintenance notifications.
+            maint_notifications_pool_handler (Optional[MaintNotificationsPoolHandler]): The pool handler for maintenance notifications.
+            maintenance_state (MaintenanceState): The current maintenance state of the connection.
+            maintenance_notification_hash (Optional[int]): The current maintenance notification hash of the connection.
+            orig_host_address (Optional[str]): The original host address of the connection.
+            orig_socket_timeout (Optional[float]): The original socket timeout of the connection.
+            orig_socket_connect_timeout (Optional[float]): The original socket connect timeout of the connection.
+            parser (Optional[Union[_HiredisParser, _RESP3Parser]]): The parser to use for maintenance notifications.
+                    If not provided, the parser from the connection is used.
+                    This is useful when the parser is created after this object.
+        """
         self.maint_notifications_config = maint_notifications_config
-
-        # Set up maintenance notifications if enabled
+        self.maintenance_state = maintenance_state
+        self.maintenance_notification_hash = maintenance_notification_hash
         self._configure_maintenance_notifications(
             maint_notifications_pool_handler,
             orig_host_address,
             orig_socket_timeout,
             orig_socket_connect_timeout,
+            parser,
         )
 
-        self._should_reconnect = False
-        self.maintenance_state = maintenance_state
-        self.maintenance_notification_hash = maintenance_notification_hash
+    @abstractmethod
+    def _get_parser(self) -> Union[_HiredisParser, _RESP3Parser]:
+        pass
 
-        self._command_packer = self._construct_command_packer(command_packer)
+    @abstractmethod
+    def _get_socket(self) -> Optional[socket.socket]:
+        pass
 
-    def __repr__(self):
-        repr_args = ",".join([f"{k}={v}" for k, v in self.repr_pieces()])
-        return f"<{self.__class__.__module__}.{self.__class__.__name__}({repr_args})>"
+    @abstractmethod
+    def get_protocol(self) -> Union[int, str]:
+        """
+        Returns:
+            The RESP protocol version, or ``None`` if the protocol is not specified,
+            in which case the server default will be used.
+        """
+        pass
 
+    @property
     @abstractmethod
-    def repr_pieces(self):
+    def host(self) -> str:
         pass
 
-    def __del__(self):
-        try:
-            self.disconnect()
-        except Exception:
-            pass
+    @host.setter
+    @abstractmethod
+    def host(self, value: str):
+        pass
 
-    def _construct_command_packer(self, packer):
-        if packer is not None:
-            return packer
-        elif HIREDIS_AVAILABLE:
-            return HiredisRespSerializer()
-        else:
-            return PythonRespSerializer(self._buffer_cutoff, self.encoder.encode)
+    @property
+    @abstractmethod
+    def socket_timeout(self) -> Optional[Union[float, int]]:
+        pass
 
-    def register_connect_callback(self, callback):
-        """
-        Register a callback to be called when the connection is established either
-        initially or reconnected.  This allows listeners to issue commands that
-        are ephemeral to the connection, for example pub/sub subscription or
-        key tracking.  The callback must be a _method_ and will be kept as
-        a weak reference.
-        """
-        wm = weakref.WeakMethod(callback)
-        if wm not in self._connect_callbacks:
-            self._connect_callbacks.append(wm)
+    @socket_timeout.setter
+    @abstractmethod
+    def socket_timeout(self, value: Optional[Union[float, int]]):
+        pass
 
-    def deregister_connect_callback(self, callback):
-        """
-        De-register a previously registered callback.  It will no-longer receive
-        notifications on connection events.  Calling this is not required when the
-        listener goes away, since the callbacks are kept as weak methods.
-        """
-        try:
-            self._connect_callbacks.remove(weakref.WeakMethod(callback))
-        except ValueError:
-            pass
+    @property
+    @abstractmethod
+    def socket_connect_timeout(self) -> Optional[Union[float, int]]:
+        pass
 
-    def set_parser(self, parser_class):
-        """
-        Creates a new instance of parser_class with socket size:
-        _socket_read_size and assigns it to the parser for the connection
-        :param parser_class: The required parser class
-        """
-        self._parser = parser_class(socket_read_size=self._socket_read_size)
+    @socket_connect_timeout.setter
+    @abstractmethod
+    def socket_connect_timeout(self, value: Optional[Union[float, int]]):
+        pass
+
+    @abstractmethod
+    def send_command(self, *args, **kwargs):
+        pass
+
+    @abstractmethod
+    def read_response(
+        self,
+        disable_decoding=False,
+        *,
+        disconnect_on_error=True,
+        push_request=False,
+    ):
+        pass
+
+    @abstractmethod
+    def disconnect(self, *args):
+        pass
 
     def _configure_maintenance_notifications(
         self,
-        maint_notifications_pool_handler=None,
+        maint_notifications_pool_handler: Optional[
+            MaintNotificationsPoolHandler
+        ] = None,
         orig_host_address=None,
         orig_socket_timeout=None,
         orig_socket_connect_timeout=None,
+        parser: Optional[Union[_HiredisParser, _RESP3Parser]] = None,
     ):
-        """Enable maintenance notifications by setting up handlers and storing original connection parameters."""
+        """
+        Enable maintenance notifications by setting up
+        handlers and storing original connection parameters.
+
+        Should be used ONLY with parsers that support push notifications.
+        """
         if (
             not self.maint_notifications_config
             or not self.maint_notifications_config.enabled
         ):
+            self._maint_notifications_pool_handler = None
             self._maint_notifications_connection_handler = None
             return
 
-        # Set up pool handler if available
-        if maint_notifications_pool_handler:
-            self._parser.set_node_moving_push_handler(
-                maint_notifications_pool_handler.handle_notification
+        if not parser:
+            raise RedisError(
+                "To configure maintenance notifications, a parser must be provided!"
             )
 
-        # Set up connection handler
-        self._maint_notifications_connection_handler = (
-            MaintNotificationsConnectionHandler(self, self.maint_notifications_config)
-        )
-        self._parser.set_maintenance_push_handler(
-            self._maint_notifications_connection_handler.handle_notification
+        if not isinstance(parser, _HiredisParser) and not isinstance(
+            parser, _RESP3Parser
+        ):
+            raise RedisError(
+                "Maintenance notifications are only supported with hiredis and RESP3 parsers!"
+            )
+
+        if maint_notifications_pool_handler:
+            # Extract a reference to a new pool handler that copies all properties
+            # of the original one and has a different connection reference
+            # This is needed because when we attach the handler to the parser
+            # we need to make sure that the handler has a reference to the
+            # connection that the parser is attached to.
+            self._maint_notifications_pool_handler = (
+                maint_notifications_pool_handler.get_handler_for_connection()
+            )
+            self._maint_notifications_pool_handler.set_connection(self)
+        else:
+            self._maint_notifications_pool_handler = None
+
+        self._maint_notifications_connection_handler = (
+            MaintNotificationsConnectionHandler(self, self.maint_notifications_config)
+        )
+
+        # Set up pool handler if available
+        if self._maint_notifications_pool_handler:
+            parser.set_node_moving_push_handler(
+                self._maint_notifications_pool_handler.handle_notification
+            )
+
+        # Set up connection handler
+        parser.set_maintenance_push_handler(
+            self._maint_notifications_connection_handler.handle_notification
         )
 
         # Store original connection parameters
@@ -541,14 +453,24 @@ def _configure_maintenance_notifications(
             else self.socket_connect_timeout
         )
 
-    def set_maint_notifications_pool_handler(
+    def set_maint_notifications_pool_handler_for_connection(
         self, maint_notifications_pool_handler: MaintNotificationsPoolHandler
     ):
-        maint_notifications_pool_handler.set_connection(self)
-        self._parser.set_node_moving_push_handler(
-            maint_notifications_pool_handler.handle_notification
+        # Deep copy the pool handler to avoid sharing the same pool handler
+        # between multiple connections, because otherwise each connection will override
+        # the connection reference and the pool handler will only hold a reference
+        # to the last connection that was set.
+        maint_notifications_pool_handler_copy = (
+            maint_notifications_pool_handler.get_handler_for_connection()
+        )
+
+        maint_notifications_pool_handler_copy.set_connection(self)
+        self._get_parser().set_node_moving_push_handler(
+            maint_notifications_pool_handler_copy.handle_notification
         )
 
+        self._maint_notifications_pool_handler = maint_notifications_pool_handler_copy
+
         # Update maintenance notification connection handler if it doesn't exist
         if not self._maint_notifications_connection_handler:
             self._maint_notifications_connection_handler = (
@@ -556,7 +478,7 @@ def set_maint_notifications_pool_handler(
                     self, maint_notifications_pool_handler.config
                 )
             )
-            self._parser.set_maintenance_push_handler(
+            self._get_parser().set_maintenance_push_handler(
                 self._maint_notifications_connection_handler.handle_notification
             )
         else:
@@ -564,130 +486,7 @@ def set_maint_notifications_pool_handler(
                 maint_notifications_pool_handler.config
             )
 
-    def connect(self):
-        "Connects to the Redis server if not already connected"
-        self.connect_check_health(check_health=True)
-
-    def connect_check_health(
-        self, check_health: bool = True, retry_socket_connect: bool = True
-    ):
-        if self._sock:
-            return
-        try:
-            if retry_socket_connect:
-                sock = self.retry.call_with_retry(
-                    lambda: self._connect(), lambda error: self.disconnect(error)
-                )
-            else:
-                sock = self._connect()
-        except socket.timeout:
-            raise TimeoutError("Timeout connecting to server")
-        except OSError as e:
-            raise ConnectionError(self._error_message(e))
-
-        self._sock = sock
-        try:
-            if self.redis_connect_func is None:
-                # Use the default on_connect function
-                self.on_connect_check_health(check_health=check_health)
-            else:
-                # Use the passed function redis_connect_func
-                self.redis_connect_func(self)
-        except RedisError:
-            # clean up after any error in on_connect
-            self.disconnect()
-            raise
-
-        # run any user callbacks. right now the only internal callback
-        # is for pubsub channel/pattern resubscription
-        # first, remove any dead weakrefs
-        self._connect_callbacks = [ref for ref in self._connect_callbacks if ref()]
-        for ref in self._connect_callbacks:
-            callback = ref()
-            if callback:
-                callback(self)
-
-    @abstractmethod
-    def _connect(self):
-        pass
-
-    @abstractmethod
-    def _host_error(self):
-        pass
-
-    def _error_message(self, exception):
-        return format_error_message(self._host_error(), exception)
-
-    def on_connect(self):
-        self.on_connect_check_health(check_health=True)
-
-    def on_connect_check_health(self, check_health: bool = True):
-        "Initialize the connection, authenticate and select a database"
-        self._parser.on_connect(self)
-        parser = self._parser
-
-        auth_args = None
-        # if credential provider or username and/or password are set, authenticate
-        if self.credential_provider or (self.username or self.password):
-            cred_provider = (
-                self.credential_provider
-                or UsernamePasswordCredentialProvider(self.username, self.password)
-            )
-            auth_args = cred_provider.get_credentials()
-
-        # if resp version is specified and we have auth args,
-        # we need to send them via HELLO
-        if auth_args and self.protocol not in [2, "2"]:
-            if isinstance(self._parser, _RESP2Parser):
-                self.set_parser(_RESP3Parser)
-                # update cluster exception classes
-                self._parser.EXCEPTION_CLASSES = parser.EXCEPTION_CLASSES
-                self._parser.on_connect(self)
-            if len(auth_args) == 1:
-                auth_args = ["default", auth_args[0]]
-            # avoid checking health here -- PING will fail if we try
-            # to check the health prior to the AUTH
-            self.send_command(
-                "HELLO", self.protocol, "AUTH", *auth_args, check_health=False
-            )
-            self.handshake_metadata = self.read_response()
-            # if response.get(b"proto") != self.protocol and response.get(
-            #     "proto"
-            # ) != self.protocol:
-            #     raise ConnectionError("Invalid RESP version")
-        elif auth_args:
-            # avoid checking health here -- PING will fail if we try
-            # to check the health prior to the AUTH
-            self.send_command("AUTH", *auth_args, check_health=False)
-
-            try:
-                auth_response = self.read_response()
-            except AuthenticationWrongNumberOfArgsError:
-                # a username and password were specified but the Redis
-                # server seems to be < 6.0.0 which expects a single password
-                # arg. retry auth with just the password.
-                # https://github.com/andymccurdy/redis-py/issues/1274
-                self.send_command("AUTH", auth_args[-1], check_health=False)
-                auth_response = self.read_response()
-
-            if str_if_bytes(auth_response) != "OK":
-                raise AuthenticationError("Invalid Username or Password")
-
-        # if resp version is specified, switch to it
-        elif self.protocol not in [2, "2"]:
-            if isinstance(self._parser, _RESP2Parser):
-                self.set_parser(_RESP3Parser)
-                # update cluster exception classes
-                self._parser.EXCEPTION_CLASSES = parser.EXCEPTION_CLASSES
-                self._parser.on_connect(self)
-            self.send_command("HELLO", self.protocol, check_health=check_health)
-            self.handshake_metadata = self.read_response()
-            if (
-                self.handshake_metadata.get(b"proto") != self.protocol
-                and self.handshake_metadata.get("proto") != self.protocol
-            ):
-                raise ConnectionError("Invalid RESP version")
-
+    def activate_maint_notifications_handling_if_enabled(self, check_health=True):
         # Send maintenance notifications handshake if RESP3 is active
         # and maintenance notifications are enabled
         # and we have a host to determine the endpoint type from
@@ -695,16 +494,29 @@ def on_connect_check_health(self, check_health: bool = True):
         # we just log a warning if the handshake fails
         # When the mode is enabled=True, we raise an exception in case of failure
         if (
-            self.protocol not in [2, "2"]
+            self.get_protocol() not in [2, "2"]
             and self.maint_notifications_config
             and self.maint_notifications_config.enabled
             and self._maint_notifications_connection_handler
             and hasattr(self, "host")
         ):
-            try:
-                endpoint_type = self.maint_notifications_config.get_endpoint_type(
-                    self.host, self
+            self._enable_maintenance_notifications(
+                maint_notifications_config=self.maint_notifications_config,
+                check_health=check_health,
+            )
+
+    def _enable_maintenance_notifications(
+        self, maint_notifications_config: MaintNotificationsConfig, check_health=True
+    ):
+        try:
+            host = getattr(self, "host", None)
+            if host is None:
+                raise ValueError(
+                    "Cannot enable maintenance notifications for connection"
+                    " object that doesn't have a host attribute."
                 )
+            else:
+                endpoint_type = maint_notifications_config.get_endpoint_type(host, self)
                 self.send_command(
                     "CLIENT",
                     "MAINT_NOTIFICATIONS",
@@ -714,337 +526,105 @@ def on_connect_check_health(self, check_health: bool = True):
                     check_health=check_health,
                 )
                 response = self.read_response()
-                if str_if_bytes(response) != "OK":
+                if not response or str_if_bytes(response) != "OK":
                     raise ResponseError(
                         "The server doesn't support maintenance notifications"
                     )
-            except Exception as e:
-                if (
-                    isinstance(e, ResponseError)
-                    and self.maint_notifications_config.enabled == "auto"
-                ):
-                    # Log warning but don't fail the connection
-                    import logging
+        except Exception as e:
+            if (
+                isinstance(e, ResponseError)
+                and maint_notifications_config.enabled == "auto"
+            ):
+                # Log warning but don't fail the connection
+                import logging
 
-                    logger = logging.getLogger(__name__)
-                    logger.warning(f"Failed to enable maintenance notifications: {e}")
-                else:
-                    raise
+                logger = logging.getLogger(__name__)
+                logger.warning(f"Failed to enable maintenance notifications: {e}")
+            else:
+                raise
 
-        # if a client_name is given, set it
-        if self.client_name:
-            self.send_command(
-                "CLIENT",
-                "SETNAME",
-                self.client_name,
-                check_health=check_health,
-            )
-            if str_if_bytes(self.read_response()) != "OK":
-                raise ConnectionError("Error setting client name")
+    def get_resolved_ip(self) -> Optional[str]:
+        """
+        Extract the resolved IP address from an
+        established connection or resolve it from the host.
+
+        First tries to get the actual IP from the socket (most accurate),
+        then falls back to DNS resolution if needed.
+
+        Args:
+            connection: The connection object to extract the IP from
+
+        Returns:
+            str: The resolved IP address, or None if it cannot be determined
+        """
 
+        # Method 1: Try to get the actual IP from the established socket connection
+        # This is most accurate as it shows the exact IP being used
         try:
-            # set the library name and version
-            if self.lib_name:
-                self.send_command(
-                    "CLIENT",
-                    "SETINFO",
-                    "LIB-NAME",
-                    self.lib_name,
-                    check_health=check_health,
-                )
-                self.read_response()
-        except ResponseError:
+            conn_socket = self._get_socket()
+            if conn_socket is not None:
+                peer_addr = conn_socket.getpeername()
+                if peer_addr and len(peer_addr) >= 1:
+                    # For TCP sockets, peer_addr is typically (host, port) tuple
+                    # Return just the host part
+                    return peer_addr[0]
+        except (AttributeError, OSError):
+            # Socket might not be connected or getpeername() might fail
             pass
 
+        # Method 2: Fallback to DNS resolution of the host
+        # This is less accurate but works when socket is not available
         try:
-            if self.lib_version:
-                self.send_command(
-                    "CLIENT",
-                    "SETINFO",
-                    "LIB-VER",
-                    self.lib_version,
-                    check_health=check_health,
+            host = getattr(self, "host", "localhost")
+            port = getattr(self, "port", 6379)
+            if host:
+                # Use getaddrinfo to resolve the hostname to IP
+                # This mimics what the connection would do during _connect()
+                addr_info = socket.getaddrinfo(
+                    host, port, socket.AF_UNSPEC, socket.SOCK_STREAM
                 )
-                self.read_response()
-        except ResponseError:
+                if addr_info:
+                    # Return the IP from the first result
+                    # addr_info[0] is (family, socktype, proto, canonname, sockaddr)
+                    # sockaddr[0] is the IP address
+                    return str(addr_info[0][4][0])
+        except (AttributeError, OSError, socket.gaierror):
+            # DNS resolution might fail
             pass
 
-        # if a database is specified, switch to it
-        if self.db:
-            self.send_command("SELECT", self.db, check_health=check_health)
-            if str_if_bytes(self.read_response()) != "OK":
-                raise ConnectionError("Invalid Database")
+        return None
 
-    def disconnect(self, *args):
-        "Disconnects from the Redis server"
-        self._parser.on_disconnect()
+    @property
+    def maintenance_state(self) -> MaintenanceState:
+        return self._maintenance_state
 
-        conn_sock = self._sock
-        self._sock = None
-        # reset the reconnect flag
-        self._should_reconnect = False
-        if conn_sock is None:
-            return
+    @maintenance_state.setter
+    def maintenance_state(self, state: "MaintenanceState"):
+        self._maintenance_state = state
 
-        if os.getpid() == self.pid:
-            try:
-                conn_sock.shutdown(socket.SHUT_RDWR)
-            except (OSError, TypeError):
-                pass
-
-        try:
-            conn_sock.close()
-        except OSError:
-            pass
-
-    def _send_ping(self):
-        """Send PING, expect PONG in return"""
-        self.send_command("PING", check_health=False)
-        if str_if_bytes(self.read_response()) != "PONG":
-            raise ConnectionError("Bad response from PING health check")
-
-    def _ping_failed(self, error):
-        """Function to call when PING fails"""
-        self.disconnect()
-
-    def check_health(self):
-        """Check the health of the connection with a PING/PONG"""
-        if self.health_check_interval and time.monotonic() > self.next_health_check:
-            self.retry.call_with_retry(self._send_ping, self._ping_failed)
-
-    def send_packed_command(self, command, check_health=True):
-        """Send an already packed command to the Redis server"""
-        if not self._sock:
-            self.connect_check_health(check_health=False)
-        # guard against health check recursion
-        if check_health:
-            self.check_health()
-        try:
-            if isinstance(command, str):
-                command = [command]
-            for item in command:
-                self._sock.sendall(item)
-        except socket.timeout:
-            self.disconnect()
-            raise TimeoutError("Timeout writing to socket")
-        except OSError as e:
-            self.disconnect()
-            if len(e.args) == 1:
-                errno, errmsg = "UNKNOWN", e.args[0]
-            else:
-                errno = e.args[0]
-                errmsg = e.args[1]
-            raise ConnectionError(f"Error {errno} while writing to socket. {errmsg}.")
-        except BaseException:
-            # BaseExceptions can be raised when a socket send operation is not
-            # finished, e.g. due to a timeout.  Ideally, a caller could then re-try
-            # to send un-sent data. However, the send_packed_command() API
-            # does not support it so there is no point in keeping the connection open.
-            self.disconnect()
-            raise
-
-    def send_command(self, *args, **kwargs):
-        """Pack and send a command to the Redis server"""
-        self.send_packed_command(
-            self._command_packer.pack(*args),
-            check_health=kwargs.get("check_health", True),
-        )
-
-    def can_read(self, timeout=0):
-        """Poll the socket to see if there's data that can be read."""
-        sock = self._sock
-        if not sock:
-            self.connect()
-
-        host_error = self._host_error()
-
-        try:
-            return self._parser.can_read(timeout)
-
-        except OSError as e:
-            self.disconnect()
-            raise ConnectionError(f"Error while reading from {host_error}: {e.args}")
-
-    def read_response(
-        self,
-        disable_decoding=False,
-        *,
-        disconnect_on_error=True,
-        push_request=False,
-    ):
-        """Read the response from a previously sent command"""
-
-        host_error = self._host_error()
-
-        try:
-            if self.protocol in ["3", 3]:
-                response = self._parser.read_response(
-                    disable_decoding=disable_decoding, push_request=push_request
-                )
-            else:
-                response = self._parser.read_response(disable_decoding=disable_decoding)
-        except socket.timeout:
-            if disconnect_on_error:
-                self.disconnect()
-            raise TimeoutError(f"Timeout reading from {host_error}")
-        except OSError as e:
-            if disconnect_on_error:
-                self.disconnect()
-            raise ConnectionError(f"Error while reading from {host_error} : {e.args}")
-        except BaseException:
-            # Also by default close in case of BaseException.  A lot of code
-            # relies on this behaviour when doing Command/Response pairs.
-            # See #1128.
-            if disconnect_on_error:
-                self.disconnect()
-            raise
-
-        if self.health_check_interval:
-            self.next_health_check = time.monotonic() + self.health_check_interval
-
-        if isinstance(response, ResponseError):
-            try:
-                raise response
-            finally:
-                del response  # avoid creating ref cycles
-        return response
-
-    def pack_command(self, *args):
-        """Pack a series of arguments into the Redis protocol"""
-        return self._command_packer.pack(*args)
-
-    def pack_commands(self, commands):
-        """Pack multiple commands into the Redis protocol"""
-        output = []
-        pieces = []
-        buffer_length = 0
-        buffer_cutoff = self._buffer_cutoff
-
-        for cmd in commands:
-            for chunk in self._command_packer.pack(*cmd):
-                chunklen = len(chunk)
-                if (
-                    buffer_length > buffer_cutoff
-                    or chunklen > buffer_cutoff
-                    or isinstance(chunk, memoryview)
-                ):
-                    if pieces:
-                        output.append(SYM_EMPTY.join(pieces))
-                    buffer_length = 0
-                    pieces = []
-
-                if chunklen > buffer_cutoff or isinstance(chunk, memoryview):
-                    output.append(chunk)
-                else:
-                    pieces.append(chunk)
-                    buffer_length += chunklen
-
-        if pieces:
-            output.append(SYM_EMPTY.join(pieces))
-        return output
-
-    def get_protocol(self) -> Union[int, str]:
-        return self.protocol
-
-    @property
-    def handshake_metadata(self) -> Union[Dict[bytes, bytes], Dict[str, str]]:
-        return self._handshake_metadata
-
-    @handshake_metadata.setter
-    def handshake_metadata(self, value: Union[Dict[bytes, bytes], Dict[str, str]]):
-        self._handshake_metadata = value
-
-    def set_re_auth_token(self, token: TokenInterface):
-        self._re_auth_token = token
-
-    def re_auth(self):
-        if self._re_auth_token is not None:
-            self.send_command(
-                "AUTH",
-                self._re_auth_token.try_get("oid"),
-                self._re_auth_token.get_value(),
-            )
-            self.read_response()
-            self._re_auth_token = None
-
-    def get_resolved_ip(self) -> Optional[str]:
-        """
-        Extract the resolved IP address from an
-        established connection or resolve it from the host.
-
-        First tries to get the actual IP from the socket (most accurate),
-        then falls back to DNS resolution if needed.
-
-        Args:
-            connection: The connection object to extract the IP from
-
-        Returns:
-            str: The resolved IP address, or None if it cannot be determined
-        """
-
-        # Method 1: Try to get the actual IP from the established socket connection
-        # This is most accurate as it shows the exact IP being used
-        try:
-            if self._sock is not None:
-                peer_addr = self._sock.getpeername()
-                if peer_addr and len(peer_addr) >= 1:
-                    # For TCP sockets, peer_addr is typically (host, port) tuple
-                    # Return just the host part
-                    return peer_addr[0]
-        except (AttributeError, OSError):
-            # Socket might not be connected or getpeername() might fail
-            pass
-
-        # Method 2: Fallback to DNS resolution of the host
-        # This is less accurate but works when socket is not available
-        try:
-            host = getattr(self, "host", "localhost")
-            port = getattr(self, "port", 6379)
-            if host:
-                # Use getaddrinfo to resolve the hostname to IP
-                # This mimics what the connection would do during _connect()
-                addr_info = socket.getaddrinfo(
-                    host, port, socket.AF_UNSPEC, socket.SOCK_STREAM
-                )
-                if addr_info:
-                    # Return the IP from the first result
-                    # addr_info[0] is (family, socktype, proto, canonname, sockaddr)
-                    # sockaddr[0] is the IP address
-                    return addr_info[0][4][0]
-        except (AttributeError, OSError, socket.gaierror):
-            # DNS resolution might fail
-            pass
-
-        return None
-
-    @property
-    def maintenance_state(self) -> MaintenanceState:
-        return self._maintenance_state
-
-    @maintenance_state.setter
-    def maintenance_state(self, state: "MaintenanceState"):
-        self._maintenance_state = state
-
-    def getpeername(self):
-        if not self._sock:
-            return None
-        return self._sock.getpeername()[0]
-
-    def mark_for_reconnect(self):
-        self._should_reconnect = True
-
-    def should_reconnect(self):
-        return self._should_reconnect
+    def getpeername(self):
+        """
+        Returns the peer name of the connection.
+        """
+        conn_socket = self._get_socket()
+        if conn_socket:
+            return conn_socket.getpeername()[0]
+        return None
 
     def update_current_socket_timeout(self, relaxed_timeout: Optional[float] = None):
-        if self._sock:
+        conn_socket = self._get_socket()
+        if conn_socket:
             timeout = relaxed_timeout if relaxed_timeout != -1 else self.socket_timeout
-            self._sock.settimeout(timeout)
-            self.update_parser_buffer_timeout(timeout)
+            conn_socket.settimeout(timeout)
+            self.update_parser_timeout(timeout)
 
-    def update_parser_buffer_timeout(self, timeout: Optional[float] = None):
-        if self._parser and self._parser._buffer:
-            self._parser._buffer.socket_timeout = timeout
+    def update_parser_timeout(self, timeout: Optional[float] = None):
+        parser = self._get_parser()
+        if parser and parser._buffer:
+            if isinstance(parser, _RESP3Parser) and timeout:
+                parser._buffer.socket_timeout = timeout
+            elif isinstance(parser, _HiredisParser):
+                parser._socket_timeout = timeout
 
     def set_tmp_settings(
         self,
@@ -1054,8 +634,8 @@ def set_tmp_settings(
         """
         The value of SENTINEL is used to indicate that the property should not be updated.
         """
-        if tmp_host_address is not SENTINEL:
-            self.host = tmp_host_address
+        if tmp_host_address and tmp_host_address != SENTINEL:
+            self.host = str(tmp_host_address)
         if tmp_relaxed_timeout != -1:
             self.socket_timeout = tmp_relaxed_timeout
             self.socket_connect_timeout = tmp_relaxed_timeout
@@ -1072,26 +652,609 @@ def reset_tmp_settings(
             self.socket_connect_timeout = self.orig_socket_connect_timeout
 
 
-class Connection(AbstractConnection):
-    "Manages TCP communication to and from a Redis server"
+class AbstractConnection(MaintNotificationsAbstractConnection, ConnectionInterface):
+    "Manages communication to and from a Redis server"
 
     def __init__(
         self,
-        host="localhost",
-        port=6379,
-        socket_keepalive=False,
-        socket_keepalive_options=None,
-        socket_type=0,
-        **kwargs,
-    ):
-        self.host = host
-        self.port = int(port)
-        self.socket_keepalive = socket_keepalive
-        self.socket_keepalive_options = socket_keepalive_options or {}
-        self.socket_type = socket_type
-        super().__init__(**kwargs)
-
-    def repr_pieces(self):
+        db: int = 0,
+        password: Optional[str] = None,
+        socket_timeout: Optional[float] = None,
+        socket_connect_timeout: Optional[float] = None,
+        retry_on_timeout: bool = False,
+        retry_on_error: Union[Iterable[Type[Exception]], object] = SENTINEL,
+        encoding: str = "utf-8",
+        encoding_errors: str = "strict",
+        decode_responses: bool = False,
+        parser_class=DefaultParser,
+        socket_read_size: int = 65536,
+        health_check_interval: int = 0,
+        client_name: Optional[str] = None,
+        lib_name: Optional[str] = "redis-py",
+        lib_version: Optional[str] = get_lib_version(),
+        username: Optional[str] = None,
+        retry: Union[Any, None] = None,
+        redis_connect_func: Optional[Callable[[], None]] = None,
+        credential_provider: Optional[CredentialProvider] = None,
+        protocol: Optional[int] = 2,
+        command_packer: Optional[Callable[[], None]] = None,
+        event_dispatcher: Optional[EventDispatcher] = None,
+        maint_notifications_config: Optional[MaintNotificationsConfig] = None,
+        maint_notifications_pool_handler: Optional[
+            MaintNotificationsPoolHandler
+        ] = None,
+        maintenance_state: "MaintenanceState" = MaintenanceState.NONE,
+        maintenance_notification_hash: Optional[int] = None,
+        orig_host_address: Optional[str] = None,
+        orig_socket_timeout: Optional[float] = None,
+        orig_socket_connect_timeout: Optional[float] = None,
+    ):
+        """
+        Initialize a new Connection.
+        To specify a retry policy for specific errors, first set
+        `retry_on_error` to a list of the error/s to retry on, then set
+        `retry` to a valid `Retry` object.
+        To retry on TimeoutError, `retry_on_timeout` can also be set to `True`.
+        """
+        if (username or password) and credential_provider is not None:
+            raise DataError(
+                "'username' and 'password' cannot be passed along with 'credential_"
+                "provider'. Please provide only one of the following arguments: \n"
+                "1. 'password' and (optional) 'username'\n"
+                "2. 'credential_provider'"
+            )
+        if event_dispatcher is None:
+            self._event_dispatcher = EventDispatcher()
+        else:
+            self._event_dispatcher = event_dispatcher
+        self.pid = os.getpid()
+        self.db = db
+        self.client_name = client_name
+        self.lib_name = lib_name
+        self.lib_version = lib_version
+        self.credential_provider = credential_provider
+        self.password = password
+        self.username = username
+        self._socket_timeout = socket_timeout
+        if socket_connect_timeout is None:
+            socket_connect_timeout = socket_timeout
+        self._socket_connect_timeout = socket_connect_timeout
+        self.retry_on_timeout = retry_on_timeout
+        if retry_on_error is SENTINEL:
+            retry_on_errors_list = []
+        else:
+            retry_on_errors_list = list(retry_on_error)
+        if retry_on_timeout:
+            # Add TimeoutError to the errors list to retry on
+            retry_on_errors_list.append(TimeoutError)
+        self.retry_on_error = retry_on_errors_list
+        if retry or self.retry_on_error:
+            if retry is None:
+                self.retry = Retry(NoBackoff(), 1)
+            else:
+                # deep-copy the Retry object as it is mutable
+                self.retry = copy.deepcopy(retry)
+            if self.retry_on_error:
+                # Update the retry's supported errors with the specified errors
+                self.retry.update_supported_errors(self.retry_on_error)
+        else:
+            self.retry = Retry(NoBackoff(), 0)
+        self.health_check_interval = health_check_interval
+        self.next_health_check = 0
+        self.redis_connect_func = redis_connect_func
+        self.encoder = Encoder(encoding, encoding_errors, decode_responses)
+        self.handshake_metadata = None
+        self._sock = None
+        self._socket_read_size = socket_read_size
+        self._connect_callbacks = []
+        self._buffer_cutoff = 6000
+        self._re_auth_token: Optional[TokenInterface] = None
+        try:
+            p = int(protocol)
+        except TypeError:
+            p = DEFAULT_RESP_VERSION
+        except ValueError:
+            raise ConnectionError("protocol must be an integer")
+        finally:
+            if p < 2 or p > 3:
+                raise ConnectionError("protocol must be either 2 or 3")
+                # p = DEFAULT_RESP_VERSION
+            self.protocol = p
+        if self.protocol == 3 and parser_class == _RESP2Parser:
+            # If the protocol is 3 but the parser is RESP2, change it to RESP3
+            # This is needed because the parser might be set before the protocol
+            # or might be provided as a kwarg to the constructor
+            # We need to react on discrepancy only for RESP2 and RESP3
+            # as hiredis supports both
+            parser_class = _RESP3Parser
+        self.set_parser(parser_class)
+
+        self._command_packer = self._construct_command_packer(command_packer)
+        self._should_reconnect = False
+
+        # Set up maintenance notifications
+        MaintNotificationsAbstractConnection.__init__(
+            self,
+            maint_notifications_config,
+            maint_notifications_pool_handler,
+            maintenance_state,
+            maintenance_notification_hash,
+            orig_host_address,
+            orig_socket_timeout,
+            orig_socket_connect_timeout,
+            self._parser,
+        )
+
+    def __repr__(self):
+        repr_args = ",".join([f"{k}={v}" for k, v in self.repr_pieces()])
+        return f"<{self.__class__.__module__}.{self.__class__.__name__}({repr_args})>"
+
+    @abstractmethod
+    def repr_pieces(self):
+        pass
+
+    def __del__(self):
+        try:
+            self.disconnect()
+        except Exception:
+            pass
+
+    def _construct_command_packer(self, packer):
+        if packer is not None:
+            return packer
+        elif HIREDIS_AVAILABLE:
+            return HiredisRespSerializer()
+        else:
+            return PythonRespSerializer(self._buffer_cutoff, self.encoder.encode)
+
+    def register_connect_callback(self, callback):
+        """
+        Register a callback to be called when the connection is established either
+        initially or reconnected.  This allows listeners to issue commands that
+        are ephemeral to the connection, for example pub/sub subscription or
+        key tracking.  The callback must be a _method_ and will be kept as
+        a weak reference.
+        """
+        wm = weakref.WeakMethod(callback)
+        if wm not in self._connect_callbacks:
+            self._connect_callbacks.append(wm)
+
+    def deregister_connect_callback(self, callback):
+        """
+        De-register a previously registered callback.  It will no-longer receive
+        notifications on connection events.  Calling this is not required when the
+        listener goes away, since the callbacks are kept as weak methods.
+        """
+        try:
+            self._connect_callbacks.remove(weakref.WeakMethod(callback))
+        except ValueError:
+            pass
+
+    def set_parser(self, parser_class):
+        """
+        Creates a new instance of parser_class with socket size:
+        _socket_read_size and assigns it to the parser for the connection
+        :param parser_class: The required parser class
+        """
+        self._parser = parser_class(socket_read_size=self._socket_read_size)
+
+    def _get_parser(self) -> Union[_HiredisParser, _RESP3Parser, _RESP2Parser]:
+        return self._parser
+
+    def connect(self):
+        "Connects to the Redis server if not already connected"
+        self.connect_check_health(check_health=True)
+
+    def connect_check_health(
+        self, check_health: bool = True, retry_socket_connect: bool = True
+    ):
+        if self._sock:
+            return
+        try:
+            if retry_socket_connect:
+                sock = self.retry.call_with_retry(
+                    lambda: self._connect(), lambda error: self.disconnect(error)
+                )
+            else:
+                sock = self._connect()
+        except socket.timeout:
+            raise TimeoutError("Timeout connecting to server")
+        except OSError as e:
+            raise ConnectionError(self._error_message(e))
+
+        self._sock = sock
+        try:
+            if self.redis_connect_func is None:
+                # Use the default on_connect function
+                self.on_connect_check_health(check_health=check_health)
+            else:
+                # Use the passed function redis_connect_func
+                self.redis_connect_func(self)
+        except RedisError:
+            # clean up after any error in on_connect
+            self.disconnect()
+            raise
+
+        # run any user callbacks. right now the only internal callback
+        # is for pubsub channel/pattern resubscription
+        # first, remove any dead weakrefs
+        self._connect_callbacks = [ref for ref in self._connect_callbacks if ref()]
+        for ref in self._connect_callbacks:
+            callback = ref()
+            if callback:
+                callback(self)
+
+    @abstractmethod
+    def _connect(self):
+        pass
+
+    @abstractmethod
+    def _host_error(self):
+        pass
+
+    def _error_message(self, exception):
+        return format_error_message(self._host_error(), exception)
+
+    def on_connect(self):
+        self.on_connect_check_health(check_health=True)
+
+    def on_connect_check_health(self, check_health: bool = True):
+        "Initialize the connection, authenticate and select a database"
+        self._parser.on_connect(self)
+        parser = self._parser
+
+        auth_args = None
+        # if credential provider or username and/or password are set, authenticate
+        if self.credential_provider or (self.username or self.password):
+            cred_provider = (
+                self.credential_provider
+                or UsernamePasswordCredentialProvider(self.username, self.password)
+            )
+            auth_args = cred_provider.get_credentials()
+
+        # if resp version is specified and we have auth args,
+        # we need to send them via HELLO
+        if auth_args and self.protocol not in [2, "2"]:
+            if isinstance(self._parser, _RESP2Parser):
+                self.set_parser(_RESP3Parser)
+                # update cluster exception classes
+                self._parser.EXCEPTION_CLASSES = parser.EXCEPTION_CLASSES
+                self._parser.on_connect(self)
+            if len(auth_args) == 1:
+                auth_args = ["default", auth_args[0]]
+            # avoid checking health here -- PING will fail if we try
+            # to check the health prior to the AUTH
+            self.send_command(
+                "HELLO", self.protocol, "AUTH", *auth_args, check_health=False
+            )
+            self.handshake_metadata = self.read_response()
+            # if response.get(b"proto") != self.protocol and response.get(
+            #     "proto"
+            # ) != self.protocol:
+            #     raise ConnectionError("Invalid RESP version")
+        elif auth_args:
+            # avoid checking health here -- PING will fail if we try
+            # to check the health prior to the AUTH
+            self.send_command("AUTH", *auth_args, check_health=False)
+
+            try:
+                auth_response = self.read_response()
+            except AuthenticationWrongNumberOfArgsError:
+                # a username and password were specified but the Redis
+                # server seems to be < 6.0.0 which expects a single password
+                # arg. retry auth with just the password.
+                # https://github.com/andymccurdy/redis-py/issues/1274
+                self.send_command("AUTH", auth_args[-1], check_health=False)
+                auth_response = self.read_response()
+
+            if str_if_bytes(auth_response) != "OK":
+                raise AuthenticationError("Invalid Username or Password")
+
+        # if resp version is specified, switch to it
+        elif self.protocol not in [2, "2"]:
+            if isinstance(self._parser, _RESP2Parser):
+                self.set_parser(_RESP3Parser)
+                # update cluster exception classes
+                self._parser.EXCEPTION_CLASSES = parser.EXCEPTION_CLASSES
+                self._parser.on_connect(self)
+            self.send_command("HELLO", self.protocol, check_health=check_health)
+            self.handshake_metadata = self.read_response()
+            if (
+                self.handshake_metadata.get(b"proto") != self.protocol
+                and self.handshake_metadata.get("proto") != self.protocol
+            ):
+                raise ConnectionError("Invalid RESP version")
+
+        # Activate maintenance notifications for this connection
+        # if enabled in the configuration
+        # This is a no-op if maintenance notifications are not enabled
+        self.activate_maint_notifications_handling_if_enabled(check_health=check_health)
+
+        # if a client_name is given, set it
+        if self.client_name:
+            self.send_command(
+                "CLIENT",
+                "SETNAME",
+                self.client_name,
+                check_health=check_health,
+            )
+            if str_if_bytes(self.read_response()) != "OK":
+                raise ConnectionError("Error setting client name")
+
+        try:
+            # set the library name and version
+            if self.lib_name:
+                self.send_command(
+                    "CLIENT",
+                    "SETINFO",
+                    "LIB-NAME",
+                    self.lib_name,
+                    check_health=check_health,
+                )
+                self.read_response()
+        except ResponseError:
+            pass
+
+        try:
+            if self.lib_version:
+                self.send_command(
+                    "CLIENT",
+                    "SETINFO",
+                    "LIB-VER",
+                    self.lib_version,
+                    check_health=check_health,
+                )
+                self.read_response()
+        except ResponseError:
+            pass
+
+        # if a database is specified, switch to it
+        if self.db:
+            self.send_command("SELECT", self.db, check_health=check_health)
+            if str_if_bytes(self.read_response()) != "OK":
+                raise ConnectionError("Invalid Database")
+
+    def disconnect(self, *args):
+        "Disconnects from the Redis server"
+        self._parser.on_disconnect()
+
+        conn_sock = self._sock
+        self._sock = None
+        # reset the reconnect flag
+        self.reset_should_reconnect()
+        if conn_sock is None:
+            return
+
+        if os.getpid() == self.pid:
+            try:
+                conn_sock.shutdown(socket.SHUT_RDWR)
+            except (OSError, TypeError):
+                pass
+
+        try:
+            conn_sock.close()
+        except OSError:
+            pass
+
+    def mark_for_reconnect(self):
+        self._should_reconnect = True
+
+    def should_reconnect(self):
+        return self._should_reconnect
+
+    def reset_should_reconnect(self):
+        self._should_reconnect = False
+
+    def _send_ping(self):
+        """Send PING, expect PONG in return"""
+        self.send_command("PING", check_health=False)
+        if str_if_bytes(self.read_response()) != "PONG":
+            raise ConnectionError("Bad response from PING health check")
+
+    def _ping_failed(self, error):
+        """Function to call when PING fails"""
+        self.disconnect()
+
+    def check_health(self):
+        """Check the health of the connection with a PING/PONG"""
+        if self.health_check_interval and time.monotonic() > self.next_health_check:
+            self.retry.call_with_retry(self._send_ping, self._ping_failed)
+
+    def send_packed_command(self, command, check_health=True):
+        """Send an already packed command to the Redis server"""
+        if not self._sock:
+            self.connect_check_health(check_health=False)
+        # guard against health check recursion
+        if check_health:
+            self.check_health()
+        try:
+            if isinstance(command, str):
+                command = [command]
+            for item in command:
+                self._sock.sendall(item)
+        except socket.timeout:
+            self.disconnect()
+            raise TimeoutError("Timeout writing to socket")
+        except OSError as e:
+            self.disconnect()
+            if len(e.args) == 1:
+                errno, errmsg = "UNKNOWN", e.args[0]
+            else:
+                errno = e.args[0]
+                errmsg = e.args[1]
+            raise ConnectionError(f"Error {errno} while writing to socket. {errmsg}.")
+        except BaseException:
+            # BaseExceptions can be raised when a socket send operation is not
+            # finished, e.g. due to a timeout.  Ideally, a caller could then re-try
+            # to send un-sent data. However, the send_packed_command() API
+            # does not support it so there is no point in keeping the connection open.
+            self.disconnect()
+            raise
+
+    def send_command(self, *args, **kwargs):
+        """Pack and send a command to the Redis server"""
+        self.send_packed_command(
+            self._command_packer.pack(*args),
+            check_health=kwargs.get("check_health", True),
+        )
+
+    def can_read(self, timeout=0):
+        """Poll the socket to see if there's data that can be read."""
+        sock = self._sock
+        if not sock:
+            self.connect()
+
+        host_error = self._host_error()
+
+        try:
+            return self._parser.can_read(timeout)
+
+        except OSError as e:
+            self.disconnect()
+            raise ConnectionError(f"Error while reading from {host_error}: {e.args}")
+
+    def read_response(
+        self,
+        disable_decoding=False,
+        *,
+        disconnect_on_error=True,
+        push_request=False,
+    ):
+        """Read the response from a previously sent command"""
+
+        host_error = self._host_error()
+
+        try:
+            if self.protocol in ["3", 3]:
+                response = self._parser.read_response(
+                    disable_decoding=disable_decoding, push_request=push_request
+                )
+            else:
+                response = self._parser.read_response(disable_decoding=disable_decoding)
+        except socket.timeout:
+            if disconnect_on_error:
+                self.disconnect()
+            raise TimeoutError(f"Timeout reading from {host_error}")
+        except OSError as e:
+            if disconnect_on_error:
+                self.disconnect()
+            raise ConnectionError(f"Error while reading from {host_error} : {e.args}")
+        except BaseException:
+            # Also by default close in case of BaseException.  A lot of code
+            # relies on this behaviour when doing Command/Response pairs.
+            # See #1128.
+            if disconnect_on_error:
+                self.disconnect()
+            raise
+
+        if self.health_check_interval:
+            self.next_health_check = time.monotonic() + self.health_check_interval
+
+        if isinstance(response, ResponseError):
+            try:
+                raise response
+            finally:
+                del response  # avoid creating ref cycles
+        return response
+
+    def pack_command(self, *args):
+        """Pack a series of arguments into the Redis protocol"""
+        return self._command_packer.pack(*args)
+
+    def pack_commands(self, commands):
+        """Pack multiple commands into the Redis protocol"""
+        output = []
+        pieces = []
+        buffer_length = 0
+        buffer_cutoff = self._buffer_cutoff
+
+        for cmd in commands:
+            for chunk in self._command_packer.pack(*cmd):
+                chunklen = len(chunk)
+                if (
+                    buffer_length > buffer_cutoff
+                    or chunklen > buffer_cutoff
+                    or isinstance(chunk, memoryview)
+                ):
+                    if pieces:
+                        output.append(SYM_EMPTY.join(pieces))
+                    buffer_length = 0
+                    pieces = []
+
+                if chunklen > buffer_cutoff or isinstance(chunk, memoryview):
+                    output.append(chunk)
+                else:
+                    pieces.append(chunk)
+                    buffer_length += chunklen
+
+        if pieces:
+            output.append(SYM_EMPTY.join(pieces))
+        return output
+
+    def get_protocol(self) -> Union[int, str]:
+        return self.protocol
+
+    @property
+    def handshake_metadata(self) -> Union[Dict[bytes, bytes], Dict[str, str]]:
+        return self._handshake_metadata
+
+    @handshake_metadata.setter
+    def handshake_metadata(self, value: Union[Dict[bytes, bytes], Dict[str, str]]):
+        self._handshake_metadata = value
+
+    def set_re_auth_token(self, token: TokenInterface):
+        self._re_auth_token = token
+
+    def re_auth(self):
+        if self._re_auth_token is not None:
+            self.send_command(
+                "AUTH",
+                self._re_auth_token.try_get("oid"),
+                self._re_auth_token.get_value(),
+            )
+            self.read_response()
+            self._re_auth_token = None
+
+    def _get_socket(self) -> Optional[socket.socket]:
+        return self._sock
+
+    @property
+    def socket_timeout(self) -> Optional[Union[float, int]]:
+        return self._socket_timeout
+
+    @socket_timeout.setter
+    def socket_timeout(self, value: Optional[Union[float, int]]):
+        self._socket_timeout = value
+
+    @property
+    def socket_connect_timeout(self) -> Optional[Union[float, int]]:
+        return self._socket_connect_timeout
+
+    @socket_connect_timeout.setter
+    def socket_connect_timeout(self, value: Optional[Union[float, int]]):
+        self._socket_connect_timeout = value
+
+
+class Connection(AbstractConnection):
+    "Manages TCP communication to and from a Redis server"
+
+    def __init__(
+        self,
+        host="localhost",
+        port=6379,
+        socket_keepalive=False,
+        socket_keepalive_options=None,
+        socket_type=0,
+        **kwargs,
+    ):
+        self._host = host
+        self.port = int(port)
+        self.socket_keepalive = socket_keepalive
+        self.socket_keepalive_options = socket_keepalive_options or {}
+        self.socket_type = socket_type
+        super().__init__(**kwargs)
+
+    def repr_pieces(self):
         pieces = [("host", self.host), ("port", self.port), ("db", self.db)]
         if self.client_name:
             pieces.append(("client_name", self.client_name))
@@ -1146,8 +1309,16 @@ def _connect(self):
     def _host_error(self):
         return f"{self.host}:{self.port}"
 
+    @property
+    def host(self) -> str:
+        return self._host
+
+    @host.setter
+    def host(self, value: str):
+        self._host = value
 
-class CacheProxyConnection(ConnectionInterface):
+
+class CacheProxyConnection(MaintNotificationsAbstractConnection, ConnectionInterface):
     DUMMY_CACHE_VALUE = b"foo"
     MIN_ALLOWED_VERSION = "7.4.0"
     DEFAULT_SERVER_NAME = "redis"
@@ -1171,6 +1342,19 @@ def __init__(
         self._current_options = None
         self.register_connect_callback(self._enable_tracking_callback)
 
+        if isinstance(self._conn, MaintNotificationsAbstractConnection):
+            MaintNotificationsAbstractConnection.__init__(
+                self,
+                self._conn.maint_notifications_config,
+                self._conn._maint_notifications_pool_handler,
+                self._conn.maintenance_state,
+                self._conn.maintenance_notification_hash,
+                self._conn.host,
+                self._conn.socket_timeout,
+                self._conn.socket_connect_timeout,
+                self._conn._get_parser(),
+            )
+
     def repr_pieces(self):
         return self._conn.repr_pieces()
 
@@ -1183,6 +1367,17 @@ def deregister_connect_callback(self, callback):
     def set_parser(self, parser_class):
         self._conn.set_parser(parser_class)
 
+    def set_maint_notifications_pool_handler_for_connection(
+        self, maint_notifications_pool_handler
+    ):
+        if isinstance(self._conn, MaintNotificationsAbstractConnection):
+            self._conn.set_maint_notifications_pool_handler_for_connection(
+                maint_notifications_pool_handler
+            )
+
+    def get_protocol(self):
+        return self._conn.get_protocol()
+
     def connect(self):
         self._conn.connect()
 
@@ -1328,6 +1523,109 @@ def pack_commands(self, commands):
     def handshake_metadata(self) -> Union[Dict[bytes, bytes], Dict[str, str]]:
         return self._conn.handshake_metadata
 
+    def set_re_auth_token(self, token: TokenInterface):
+        self._conn.set_re_auth_token(token)
+
+    def re_auth(self):
+        self._conn.re_auth()
+
+    def mark_for_reconnect(self):
+        self._conn.mark_for_reconnect()
+
+    def should_reconnect(self):
+        return self._conn.should_reconnect()
+
+    def reset_should_reconnect(self):
+        self._conn.reset_should_reconnect()
+
+    @property
+    def host(self) -> str:
+        return self._conn.host
+
+    @host.setter
+    def host(self, value: str):
+        self._conn.host = value
+
+    @property
+    def socket_timeout(self) -> Optional[Union[float, int]]:
+        return self._conn.socket_timeout
+
+    @socket_timeout.setter
+    def socket_timeout(self, value: Optional[Union[float, int]]):
+        self._conn.socket_timeout = value
+
+    @property
+    def socket_connect_timeout(self) -> Optional[Union[float, int]]:
+        return self._conn.socket_connect_timeout
+
+    @socket_connect_timeout.setter
+    def socket_connect_timeout(self, value: Optional[Union[float, int]]):
+        self._conn.socket_connect_timeout = value
+
+    def _get_socket(self) -> Optional[socket.socket]:
+        if isinstance(self._conn, MaintNotificationsAbstractConnection):
+            return self._conn._get_socket()
+        else:
+            raise NotImplementedError(
+                "Maintenance notifications are not supported by this connection type"
+            )
+
+    def _get_maint_notifications_connection_instance(
+        self, connection
+    ) -> MaintNotificationsAbstractConnection:
+        """
+        Validate that connection instance supports maintenance notifications.
+        With this helper method we ensure that we are working
+        with the correct connection type.
+        After twe validate that connection instance supports maintenance notifications
+        we can safely return the connection instance
+        as MaintNotificationsAbstractConnection.
+        """
+        if not isinstance(connection, MaintNotificationsAbstractConnection):
+            raise NotImplementedError(
+                "Maintenance notifications are not supported by this connection type"
+            )
+        else:
+            return connection
+
+    @property
+    def maintenance_state(self) -> MaintenanceState:
+        con = self._get_maint_notifications_connection_instance(self._conn)
+        return con.maintenance_state
+
+    @maintenance_state.setter
+    def maintenance_state(self, state: MaintenanceState):
+        con = self._get_maint_notifications_connection_instance(self._conn)
+        con.maintenance_state = state
+
+    def getpeername(self):
+        con = self._get_maint_notifications_connection_instance(self._conn)
+        return con.getpeername()
+
+    def get_resolved_ip(self):
+        con = self._get_maint_notifications_connection_instance(self._conn)
+        return con.get_resolved_ip()
+
+    def update_current_socket_timeout(self, relaxed_timeout: Optional[float] = None):
+        con = self._get_maint_notifications_connection_instance(self._conn)
+        con.update_current_socket_timeout(relaxed_timeout)
+
+    def set_tmp_settings(
+        self,
+        tmp_host_address: Optional[str] = None,
+        tmp_relaxed_timeout: Optional[float] = None,
+    ):
+        con = self._get_maint_notifications_connection_instance(self._conn)
+        con.set_tmp_settings(tmp_host_address, tmp_relaxed_timeout)
+
+    def reset_tmp_settings(
+        self,
+        reset_host_address: bool = False,
+        reset_relaxed_timeout: bool = False,
+    ):
+        con = self._get_maint_notifications_connection_instance(self._conn)
+        con.reset_tmp_settings(reset_host_address, reset_relaxed_timeout)
+
     def _connect(self):
         self._conn._connect()
 
@@ -1351,15 +1649,6 @@ def _on_invalidation_callback(self, data: List[Union[str, Optional[List[bytes]]]
             else:
                 self._cache.delete_by_redis_keys(data[1])
 
-    def get_protocol(self):
-        return self._conn.get_protocol()
-
-    def set_re_auth_token(self, token: TokenInterface):
-        self._conn.set_re_auth_token(token)
-
-    def re_auth(self):
-        self._conn.re_auth()
-
 
 class SSLConnection(Connection):
     """Manages SSL connections to and from the Redis server(s).
@@ -1448,240 +1737,629 @@ def __init__(
         self.ssl_ciphers = ssl_ciphers
         super().__init__(**kwargs)
 
-    def _connect(self):
-        """
-        Wrap the socket with SSL support, handling potential errors.
-        """
-        sock = super()._connect()
-        try:
-            return self._wrap_socket_with_ssl(sock)
-        except (OSError, RedisError):
-            sock.close()
-            raise
+    def _connect(self):
+        """
+        Wrap the socket with SSL support, handling potential errors.
+        """
+        sock = super()._connect()
+        try:
+            return self._wrap_socket_with_ssl(sock)
+        except (OSError, RedisError):
+            sock.close()
+            raise
+
+    def _wrap_socket_with_ssl(self, sock):
+        """
+        Wraps the socket with SSL support.
+
+        Args:
+            sock: The plain socket to wrap with SSL.
+
+        Returns:
+            An SSL wrapped socket.
+        """
+        context = ssl.create_default_context()
+        context.check_hostname = self.check_hostname
+        context.verify_mode = self.cert_reqs
+        if self.ssl_include_verify_flags:
+            for flag in self.ssl_include_verify_flags:
+                context.verify_flags |= flag
+        if self.ssl_exclude_verify_flags:
+            for flag in self.ssl_exclude_verify_flags:
+                context.verify_flags &= ~flag
+        if self.certfile or self.keyfile:
+            context.load_cert_chain(
+                certfile=self.certfile,
+                keyfile=self.keyfile,
+                password=self.certificate_password,
+            )
+        if (
+            self.ca_certs is not None
+            or self.ca_path is not None
+            or self.ca_data is not None
+        ):
+            context.load_verify_locations(
+                cafile=self.ca_certs, capath=self.ca_path, cadata=self.ca_data
+            )
+        if self.ssl_min_version is not None:
+            context.minimum_version = self.ssl_min_version
+        if self.ssl_ciphers:
+            context.set_ciphers(self.ssl_ciphers)
+        if self.ssl_validate_ocsp is True and CRYPTOGRAPHY_AVAILABLE is False:
+            raise RedisError("cryptography is not installed.")
+
+        if self.ssl_validate_ocsp_stapled and self.ssl_validate_ocsp:
+            raise RedisError(
+                "Either an OCSP staple or pure OCSP connection must be validated "
+                "- not both."
+            )
+
+        sslsock = context.wrap_socket(sock, server_hostname=self.host)
+
+        # validation for the stapled case
+        if self.ssl_validate_ocsp_stapled:
+            import OpenSSL
+
+            from .ocsp import ocsp_staple_verifier
+
+            # if a context is provided use it - otherwise, a basic context
+            if self.ssl_ocsp_context is None:
+                staple_ctx = OpenSSL.SSL.Context(OpenSSL.SSL.SSLv23_METHOD)
+                staple_ctx.use_certificate_file(self.certfile)
+                staple_ctx.use_privatekey_file(self.keyfile)
+            else:
+                staple_ctx = self.ssl_ocsp_context
+
+            staple_ctx.set_ocsp_client_callback(
+                ocsp_staple_verifier, self.ssl_ocsp_expected_cert
+            )
+
+            #  need another socket
+            con = OpenSSL.SSL.Connection(staple_ctx, socket.socket())
+            con.request_ocsp()
+            con.connect((self.host, self.port))
+            con.do_handshake()
+            con.shutdown()
+            return sslsock
+
+        # pure ocsp validation
+        if self.ssl_validate_ocsp is True and CRYPTOGRAPHY_AVAILABLE:
+            from .ocsp import OCSPVerifier
+
+            o = OCSPVerifier(sslsock, self.host, self.port, self.ca_certs)
+            if o.is_valid():
+                return sslsock
+            else:
+                raise ConnectionError("ocsp validation error")
+        return sslsock
+
+
+class UnixDomainSocketConnection(AbstractConnection):
+    "Manages UDS communication to and from a Redis server"
+
+    def __init__(self, path="", socket_timeout=None, **kwargs):
+        super().__init__(**kwargs)
+        self.path = path
+        self.socket_timeout = socket_timeout
+
+    def repr_pieces(self):
+        pieces = [("path", self.path), ("db", self.db)]
+        if self.client_name:
+            pieces.append(("client_name", self.client_name))
+        return pieces
+
+    def _connect(self):
+        "Create a Unix domain socket connection"
+        sock = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
+        sock.settimeout(self.socket_connect_timeout)
+        try:
+            sock.connect(self.path)
+        except OSError:
+            # Prevent ResourceWarnings for unclosed sockets.
+            try:
+                sock.shutdown(socket.SHUT_RDWR)  # ensure a clean close
+            except OSError:
+                pass
+            sock.close()
+            raise
+        sock.settimeout(self.socket_timeout)
+        return sock
+
+    def _host_error(self):
+        return self.path
+
+
+FALSE_STRINGS = ("0", "F", "FALSE", "N", "NO")
+
+
+def to_bool(value):
+    if value is None or value == "":
+        return None
+    if isinstance(value, str) and value.upper() in FALSE_STRINGS:
+        return False
+    return bool(value)
+
+
+def parse_ssl_verify_flags(value):
+    # flags are passed in as a string representation of a list,
+    # e.g. VERIFY_X509_STRICT, VERIFY_X509_PARTIAL_CHAIN
+    verify_flags_str = value.replace("[", "").replace("]", "")
+
+    verify_flags = []
+    for flag in verify_flags_str.split(","):
+        flag = flag.strip()
+        if not hasattr(VerifyFlags, flag):
+            raise ValueError(f"Invalid ssl verify flag: {flag}")
+        verify_flags.append(getattr(VerifyFlags, flag))
+    return verify_flags
+
+
+URL_QUERY_ARGUMENT_PARSERS = {
+    "db": int,
+    "socket_timeout": float,
+    "socket_connect_timeout": float,
+    "socket_keepalive": to_bool,
+    "retry_on_timeout": to_bool,
+    "retry_on_error": list,
+    "max_connections": int,
+    "health_check_interval": int,
+    "ssl_check_hostname": to_bool,
+    "ssl_include_verify_flags": parse_ssl_verify_flags,
+    "ssl_exclude_verify_flags": parse_ssl_verify_flags,
+    "timeout": float,
+}
+
+
+def parse_url(url):
+    if not (
+        url.startswith("redis://")
+        or url.startswith("rediss://")
+        or url.startswith("unix://")
+    ):
+        raise ValueError(
+            "Redis URL must specify one of the following "
+            "schemes (redis://, rediss://, unix://)"
+        )
+
+    url = urlparse(url)
+    kwargs = {}
+
+    for name, value in parse_qs(url.query).items():
+        if value and len(value) > 0:
+            value = unquote(value[0])
+            parser = URL_QUERY_ARGUMENT_PARSERS.get(name)
+            if parser:
+                try:
+                    kwargs[name] = parser(value)
+                except (TypeError, ValueError):
+                    raise ValueError(f"Invalid value for '{name}' in connection URL.")
+            else:
+                kwargs[name] = value
+
+    if url.username:
+        kwargs["username"] = unquote(url.username)
+    if url.password:
+        kwargs["password"] = unquote(url.password)
+
+    # We only support redis://, rediss:// and unix:// schemes.
+    if url.scheme == "unix":
+        if url.path:
+            kwargs["path"] = unquote(url.path)
+        kwargs["connection_class"] = UnixDomainSocketConnection
+
+    else:  # implied:  url.scheme in ("redis", "rediss"):
+        if url.hostname:
+            kwargs["host"] = unquote(url.hostname)
+        if url.port:
+            kwargs["port"] = int(url.port)
+
+        # If there's a path argument, use it as the db argument if a
+        # querystring value wasn't specified
+        if url.path and "db" not in kwargs:
+            try:
+                kwargs["db"] = int(unquote(url.path).replace("/", ""))
+            except (AttributeError, ValueError):
+                pass
+
+        if url.scheme == "rediss":
+            kwargs["connection_class"] = SSLConnection
+
+    return kwargs
+
+
+_CP = TypeVar("_CP", bound="ConnectionPool")
+
+
+class ConnectionPoolInterface(ABC):
+    @abstractmethod
+    def get_protocol(self):
+        pass
+
+    @abstractmethod
+    def reset(self):
+        pass
+
+    @abstractmethod
+    @deprecated_args(
+        args_to_warn=["*"],
+        reason="Use get_connection() without args instead",
+        version="5.3.0",
+    )
+    def get_connection(
+        self, command_name: Optional[str], *keys, **options
+    ) -> ConnectionInterface:
+        pass
+
+    @abstractmethod
+    def get_encoder(self):
+        pass
 
-    def _wrap_socket_with_ssl(self, sock):
-        """
-        Wraps the socket with SSL support.
+    @abstractmethod
+    def release(self, connection: ConnectionInterface):
+        pass
 
-        Args:
-            sock: The plain socket to wrap with SSL.
+    @abstractmethod
+    def disconnect(self, inuse_connections: bool = True):
+        pass
 
-        Returns:
-            An SSL wrapped socket.
-        """
-        context = ssl.create_default_context()
-        context.check_hostname = self.check_hostname
-        context.verify_mode = self.cert_reqs
-        if self.ssl_include_verify_flags:
-            for flag in self.ssl_include_verify_flags:
-                context.verify_flags |= flag
-        if self.ssl_exclude_verify_flags:
-            for flag in self.ssl_exclude_verify_flags:
-                context.verify_flags &= ~flag
-        if self.certfile or self.keyfile:
-            context.load_cert_chain(
-                certfile=self.certfile,
-                keyfile=self.keyfile,
-                password=self.certificate_password,
-            )
-        if (
-            self.ca_certs is not None
-            or self.ca_path is not None
-            or self.ca_data is not None
-        ):
-            context.load_verify_locations(
-                cafile=self.ca_certs, capath=self.ca_path, cadata=self.ca_data
-            )
-        if self.ssl_min_version is not None:
-            context.minimum_version = self.ssl_min_version
-        if self.ssl_ciphers:
-            context.set_ciphers(self.ssl_ciphers)
-        if self.ssl_validate_ocsp is True and CRYPTOGRAPHY_AVAILABLE is False:
-            raise RedisError("cryptography is not installed.")
+    @abstractmethod
+    def close(self):
+        pass
 
-        if self.ssl_validate_ocsp_stapled and self.ssl_validate_ocsp:
-            raise RedisError(
-                "Either an OCSP staple or pure OCSP connection must be validated "
-                "- not both."
-            )
+    @abstractmethod
+    def set_retry(self, retry: Retry):
+        pass
 
-        sslsock = context.wrap_socket(sock, server_hostname=self.host)
+    @abstractmethod
+    def re_auth_callback(self, token: TokenInterface):
+        pass
 
-        # validation for the stapled case
-        if self.ssl_validate_ocsp_stapled:
-            import OpenSSL
 
-            from .ocsp import ocsp_staple_verifier
+class MaintNotificationsAbstractConnectionPool:
+    """
+    Abstract class for handling maintenance notifications logic.
+    This class is mixed into the ConnectionPool classes.
 
-            # if a context is provided use it - otherwise, a basic context
-            if self.ssl_ocsp_context is None:
-                staple_ctx = OpenSSL.SSL.Context(OpenSSL.SSL.SSLv23_METHOD)
-                staple_ctx.use_certificate_file(self.certfile)
-                staple_ctx.use_privatekey_file(self.keyfile)
-            else:
-                staple_ctx = self.ssl_ocsp_context
+    This class is not intended to be used directly!
 
-            staple_ctx.set_ocsp_client_callback(
-                ocsp_staple_verifier, self.ssl_ocsp_expected_cert
+    All logic related to maintenance notifications and
+    connection pool handling is encapsulated in this class.
+    """
+
+    def __init__(
+        self,
+        maint_notifications_config: Optional[MaintNotificationsConfig] = None,
+        **kwargs,
+    ):
+        # Initialize maintenance notifications
+        is_protocol_supported = kwargs.get("protocol") in [3, "3"]
+        if maint_notifications_config is None and is_protocol_supported:
+            maint_notifications_config = MaintNotificationsConfig()
+
+        if maint_notifications_config and maint_notifications_config.enabled:
+            if not is_protocol_supported:
+                raise RedisError(
+                    "Maintenance notifications handlers on connection are only supported with RESP version 3"
+                )
+
+            self._maint_notifications_pool_handler = MaintNotificationsPoolHandler(
+                self, maint_notifications_config
             )
 
-            #  need another socket
-            con = OpenSSL.SSL.Connection(staple_ctx, socket.socket())
-            con.request_ocsp()
-            con.connect((self.host, self.port))
-            con.do_handshake()
-            con.shutdown()
-            return sslsock
+            self._update_connection_kwargs_for_maint_notifications(
+                self._maint_notifications_pool_handler
+            )
+        else:
+            self._maint_notifications_pool_handler = None
 
-        # pure ocsp validation
-        if self.ssl_validate_ocsp is True and CRYPTOGRAPHY_AVAILABLE:
-            from .ocsp import OCSPVerifier
+    @property
+    @abstractmethod
+    def connection_kwargs(self) -> Dict[str, Any]:
+        pass
 
-            o = OCSPVerifier(sslsock, self.host, self.port, self.ca_certs)
-            if o.is_valid():
-                return sslsock
-            else:
-                raise ConnectionError("ocsp validation error")
-        return sslsock
+    @connection_kwargs.setter
+    @abstractmethod
+    def connection_kwargs(self, value: Dict[str, Any]):
+        pass
 
+    @abstractmethod
+    def _get_pool_lock(self) -> threading.RLock:
+        pass
 
-class UnixDomainSocketConnection(AbstractConnection):
-    "Manages UDS communication to and from a Redis server"
+    @abstractmethod
+    def _get_free_connections(self) -> Iterable["MaintNotificationsAbstractConnection"]:
+        pass
 
-    def __init__(self, path="", socket_timeout=None, **kwargs):
-        super().__init__(**kwargs)
-        self.path = path
-        self.socket_timeout = socket_timeout
+    @abstractmethod
+    def _get_in_use_connections(
+        self,
+    ) -> Iterable["MaintNotificationsAbstractConnection"]:
+        pass
 
-    def repr_pieces(self):
-        pieces = [("path", self.path), ("db", self.db)]
-        if self.client_name:
-            pieces.append(("client_name", self.client_name))
-        return pieces
+    def maint_notifications_enabled(self):
+        """
+        Returns:
+            True if the maintenance notifications are enabled, False otherwise.
+            The maintenance notifications config is stored in the pool handler.
+            If the pool handler is not set, the maintenance notifications are not enabled.
+        """
+        maint_notifications_config = (
+            self._maint_notifications_pool_handler.config
+            if self._maint_notifications_pool_handler
+            else None
+        )
 
-    def _connect(self):
-        "Create a Unix domain socket connection"
-        sock = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
-        sock.settimeout(self.socket_connect_timeout)
-        try:
-            sock.connect(self.path)
-        except OSError:
-            # Prevent ResourceWarnings for unclosed sockets.
-            try:
-                sock.shutdown(socket.SHUT_RDWR)  # ensure a clean close
-            except OSError:
-                pass
-            sock.close()
-            raise
-        sock.settimeout(self.socket_timeout)
-        return sock
+        return maint_notifications_config and maint_notifications_config.enabled
 
-    def _host_error(self):
-        return self.path
+    def update_maint_notifications_config(
+        self, maint_notifications_config: MaintNotificationsConfig
+    ):
+        """
+        Updates the maintenance notifications configuration.
+        This method should be called only if the pool was created
+        without enabling the maintenance notifications and
+        in a later point in time maintenance notifications
+        are requested to be enabled.
+        """
+        if (
+            self.maint_notifications_enabled()
+            and not maint_notifications_config.enabled
+        ):
+            raise ValueError(
+                "Cannot disable maintenance notifications after enabling them"
+            )
+        # first update pool settings
+        if not self._maint_notifications_pool_handler:
+            self._maint_notifications_pool_handler = MaintNotificationsPoolHandler(
+                self, maint_notifications_config
+            )
+        else:
+            self._maint_notifications_pool_handler.config = maint_notifications_config
 
+        # then update connection kwargs and existing connections
+        self._update_connection_kwargs_for_maint_notifications(
+            self._maint_notifications_pool_handler
+        )
+        self._update_maint_notifications_configs_for_connections(
+            self._maint_notifications_pool_handler
+        )
 
-FALSE_STRINGS = ("0", "F", "FALSE", "N", "NO")
+    def _update_connection_kwargs_for_maint_notifications(
+        self, maint_notifications_pool_handler: MaintNotificationsPoolHandler
+    ):
+        """
+        Update the connection kwargs for all future connections.
+        """
+        if not self.maint_notifications_enabled():
+            return
 
+        self.connection_kwargs.update(
+            {
+                "maint_notifications_pool_handler": maint_notifications_pool_handler,
+                "maint_notifications_config": maint_notifications_pool_handler.config,
+            }
+        )
 
-def to_bool(value):
-    if value is None or value == "":
-        return None
-    if isinstance(value, str) and value.upper() in FALSE_STRINGS:
-        return False
-    return bool(value)
+        # Store original connection parameters for maintenance notifications.
+        if self.connection_kwargs.get("orig_host_address", None) is None:
+            # If orig_host_address is None it means we haven't
+            # configured the original values yet
+            self.connection_kwargs.update(
+                {
+                    "orig_host_address": self.connection_kwargs.get("host"),
+                    "orig_socket_timeout": self.connection_kwargs.get(
+                        "socket_timeout", None
+                    ),
+                    "orig_socket_connect_timeout": self.connection_kwargs.get(
+                        "socket_connect_timeout", None
+                    ),
+                }
+            )
 
+    def _update_maint_notifications_configs_for_connections(
+        self, maint_notifications_pool_handler: MaintNotificationsPoolHandler
+    ):
+        """Update the maintenance notifications config for all connections in the pool."""
+        with self._get_pool_lock():
+            for conn in self._get_free_connections():
+                conn.set_maint_notifications_pool_handler_for_connection(
+                    maint_notifications_pool_handler
+                )
+                conn.maint_notifications_config = (
+                    maint_notifications_pool_handler.config
+                )
+                conn.disconnect()
+            for conn in self._get_in_use_connections():
+                conn.set_maint_notifications_pool_handler_for_connection(
+                    maint_notifications_pool_handler
+                )
+                conn.maint_notifications_config = (
+                    maint_notifications_pool_handler.config
+                )
+                conn.mark_for_reconnect()
 
-def parse_ssl_verify_flags(value):
-    # flags are passed in as a string representation of a list,
-    # e.g. VERIFY_X509_STRICT, VERIFY_X509_PARTIAL_CHAIN
-    verify_flags_str = value.replace("[", "").replace("]", "")
+    def _should_update_connection(
+        self,
+        conn: "MaintNotificationsAbstractConnection",
+        matching_pattern: Literal[
+            "connected_address", "configured_address", "notification_hash"
+        ] = "connected_address",
+        matching_address: Optional[str] = None,
+        matching_notification_hash: Optional[int] = None,
+    ) -> bool:
+        """
+        Check if the connection should be updated based on the matching criteria.
+        """
+        if matching_pattern == "connected_address":
+            if matching_address and conn.getpeername() != matching_address:
+                return False
+        elif matching_pattern == "configured_address":
+            if matching_address and conn.host != matching_address:
+                return False
+        elif matching_pattern == "notification_hash":
+            if (
+                matching_notification_hash
+                and conn.maintenance_notification_hash != matching_notification_hash
+            ):
+                return False
+        return True
+
+    def update_connection_settings(
+        self,
+        conn: "MaintNotificationsAbstractConnection",
+        state: Optional["MaintenanceState"] = None,
+        maintenance_notification_hash: Optional[int] = None,
+        host_address: Optional[str] = None,
+        relaxed_timeout: Optional[float] = None,
+        update_notification_hash: bool = False,
+        reset_host_address: bool = False,
+        reset_relaxed_timeout: bool = False,
+    ):
+        """
+        Update the settings for a single connection.
+        """
+        if state:
+            conn.maintenance_state = state
 
-    verify_flags = []
-    for flag in verify_flags_str.split(","):
-        flag = flag.strip()
-        if not hasattr(VerifyFlags, flag):
-            raise ValueError(f"Invalid ssl verify flag: {flag}")
-        verify_flags.append(getattr(VerifyFlags, flag))
-    return verify_flags
+        if update_notification_hash:
+            # update the notification hash only if requested
+            conn.maintenance_notification_hash = maintenance_notification_hash
 
+        if host_address is not None:
+            conn.set_tmp_settings(tmp_host_address=host_address)
 
-URL_QUERY_ARGUMENT_PARSERS = {
-    "db": int,
-    "socket_timeout": float,
-    "socket_connect_timeout": float,
-    "socket_keepalive": to_bool,
-    "retry_on_timeout": to_bool,
-    "retry_on_error": list,
-    "max_connections": int,
-    "health_check_interval": int,
-    "ssl_check_hostname": to_bool,
-    "ssl_include_verify_flags": parse_ssl_verify_flags,
-    "ssl_exclude_verify_flags": parse_ssl_verify_flags,
-    "timeout": float,
-}
+        if relaxed_timeout is not None:
+            conn.set_tmp_settings(tmp_relaxed_timeout=relaxed_timeout)
+
+        if reset_relaxed_timeout or reset_host_address:
+            conn.reset_tmp_settings(
+                reset_host_address=reset_host_address,
+                reset_relaxed_timeout=reset_relaxed_timeout,
+            )
 
+        conn.update_current_socket_timeout(relaxed_timeout)
 
-def parse_url(url):
-    if not (
-        url.startswith("redis://")
-        or url.startswith("rediss://")
-        or url.startswith("unix://")
+    def update_connections_settings(
+        self,
+        state: Optional["MaintenanceState"] = None,
+        maintenance_notification_hash: Optional[int] = None,
+        host_address: Optional[str] = None,
+        relaxed_timeout: Optional[float] = None,
+        matching_address: Optional[str] = None,
+        matching_notification_hash: Optional[int] = None,
+        matching_pattern: Literal[
+            "connected_address", "configured_address", "notification_hash"
+        ] = "connected_address",
+        update_notification_hash: bool = False,
+        reset_host_address: bool = False,
+        reset_relaxed_timeout: bool = False,
+        include_free_connections: bool = True,
     ):
-        raise ValueError(
-            "Redis URL must specify one of the following "
-            "schemes (redis://, rediss://, unix://)"
-        )
-
-    url = urlparse(url)
-    kwargs = {}
+        """
+        Update the settings for all matching connections in the pool.
 
-    for name, value in parse_qs(url.query).items():
-        if value and len(value) > 0:
-            value = unquote(value[0])
-            parser = URL_QUERY_ARGUMENT_PARSERS.get(name)
-            if parser:
-                try:
-                    kwargs[name] = parser(value)
-                except (TypeError, ValueError):
-                    raise ValueError(f"Invalid value for '{name}' in connection URL.")
-            else:
-                kwargs[name] = value
+        This method does not create new connections.
+        This method does not affect the connection kwargs.
 
-    if url.username:
-        kwargs["username"] = unquote(url.username)
-    if url.password:
-        kwargs["password"] = unquote(url.password)
+        :param state: The maintenance state to set for the connection.
+        :param maintenance_notification_hash: The hash of the maintenance notification
+                                               to set for the connection.
+        :param host_address: The host address to set for the connection.
+        :param relaxed_timeout: The relaxed timeout to set for the connection.
+        :param matching_address: The address to match for the connection.
+        :param matching_notification_hash: The notification hash to match for the connection.
+        :param matching_pattern: The pattern to match for the connection.
+        :param update_notification_hash: Whether to update the notification hash for the connection.
+        :param reset_host_address: Whether to reset the host address to the original address.
+        :param reset_relaxed_timeout: Whether to reset the relaxed timeout to the original timeout.
+        :param include_free_connections: Whether to include free/available connections.
+        """
+        with self._get_pool_lock():
+            for conn in self._get_in_use_connections():
+                if self._should_update_connection(
+                    conn,
+                    matching_pattern,
+                    matching_address,
+                    matching_notification_hash,
+                ):
+                    self.update_connection_settings(
+                        conn,
+                        state=state,
+                        maintenance_notification_hash=maintenance_notification_hash,
+                        host_address=host_address,
+                        relaxed_timeout=relaxed_timeout,
+                        update_notification_hash=update_notification_hash,
+                        reset_host_address=reset_host_address,
+                        reset_relaxed_timeout=reset_relaxed_timeout,
+                    )
 
-    # We only support redis://, rediss:// and unix:// schemes.
-    if url.scheme == "unix":
-        if url.path:
-            kwargs["path"] = unquote(url.path)
-        kwargs["connection_class"] = UnixDomainSocketConnection
+            if include_free_connections:
+                for conn in self._get_free_connections():
+                    if self._should_update_connection(
+                        conn,
+                        matching_pattern,
+                        matching_address,
+                        matching_notification_hash,
+                    ):
+                        self.update_connection_settings(
+                            conn,
+                            state=state,
+                            maintenance_notification_hash=maintenance_notification_hash,
+                            host_address=host_address,
+                            relaxed_timeout=relaxed_timeout,
+                            update_notification_hash=update_notification_hash,
+                            reset_host_address=reset_host_address,
+                            reset_relaxed_timeout=reset_relaxed_timeout,
+                        )
 
-    else:  # implied:  url.scheme in ("redis", "rediss"):
-        if url.hostname:
-            kwargs["host"] = unquote(url.hostname)
-        if url.port:
-            kwargs["port"] = int(url.port)
+    def update_connection_kwargs(
+        self,
+        **kwargs,
+    ):
+        """
+        Update the connection kwargs for all future connections.
 
-        # If there's a path argument, use it as the db argument if a
-        # querystring value wasn't specified
-        if url.path and "db" not in kwargs:
-            try:
-                kwargs["db"] = int(unquote(url.path).replace("/", ""))
-            except (AttributeError, ValueError):
-                pass
+        This method updates the connection kwargs for all future connections created by the pool.
+        Existing connections are not affected.
+        """
+        self.connection_kwargs.update(kwargs)
 
-        if url.scheme == "rediss":
-            kwargs["connection_class"] = SSLConnection
+    def update_active_connections_for_reconnect(
+        self,
+        moving_address_src: Optional[str] = None,
+    ):
+        """
+        Mark all active connections for reconnect.
+        This is used when a cluster node is migrated to a different address.
 
-    return kwargs
+        :param moving_address_src: The address of the node that is being moved.
+        """
+        with self._get_pool_lock():
+            for conn in self._get_in_use_connections():
+                if self._should_update_connection(
+                    conn, "connected_address", moving_address_src
+                ):
+                    conn.mark_for_reconnect()
 
+    def disconnect_free_connections(
+        self,
+        moving_address_src: Optional[str] = None,
+    ):
+        """
+        Disconnect all free/available connections.
+        This is used when a cluster node is migrated to a different address.
 
-_CP = TypeVar("_CP", bound="ConnectionPool")
+        :param moving_address_src: The address of the node that is being moved.
+        """
+        with self._get_pool_lock():
+            for conn in self._get_free_connections():
+                if self._should_update_connection(
+                    conn, "connected_address", moving_address_src
+                ):
+                    conn.disconnect()
 
 
-class ConnectionPool:
+class ConnectionPool(MaintNotificationsAbstractConnectionPool, ConnectionPoolInterface):
     """
     Create a connection pool. ``If max_connections`` is set, then this
     object raises :py:class:`~redis.exceptions.ConnectionError` when the pool's
@@ -1692,6 +2370,12 @@ class ConnectionPool:
     unix sockets.
     :py:class:`~redis.SSLConnection` can be used for SSL enabled connections.
 
+    If ``maint_notifications_config`` is provided, the connection pool will support
+    maintenance notifications.
+    Maintenance notifications are supported only with RESP3.
+    If the ``maint_notifications_config`` is not provided but the ``protocol`` is 3,
+    the maintenance notifications will be enabled by default.
+
     Any additional keyword arguments are passed to the constructor of
     ``connection_class``.
     """
@@ -1750,6 +2434,7 @@ def __init__(
         connection_class=Connection,
         max_connections: Optional[int] = None,
         cache_factory: Optional[CacheFactoryInterface] = None,
+        maint_notifications_config: Optional[MaintNotificationsConfig] = None,
         **connection_kwargs,
     ):
         max_connections = max_connections or 2**31
@@ -1757,16 +2442,16 @@ def __init__(
             raise ValueError('"max_connections" must be a positive integer')
 
         self.connection_class = connection_class
-        self.connection_kwargs = connection_kwargs
+        self._connection_kwargs = connection_kwargs
         self.max_connections = max_connections
         self.cache = None
         self._cache_factory = cache_factory
 
         if connection_kwargs.get("cache_config") or connection_kwargs.get("cache"):
-            if self.connection_kwargs.get("protocol") not in [3, "3"]:
+            if self._connection_kwargs.get("protocol") not in [3, "3"]:
                 raise RedisError("Client caching is only supported with RESP version 3")
 
-            cache = self.connection_kwargs.get("cache")
+            cache = self._connection_kwargs.get("cache")
 
             if cache is not None:
                 if not isinstance(cache, CacheInterface):
@@ -1778,29 +2463,13 @@ def __init__(
                     self.cache = self._cache_factory.get_cache()
                 else:
                     self.cache = CacheFactory(
-                        self.connection_kwargs.get("cache_config")
+                        self._connection_kwargs.get("cache_config")
                     ).get_cache()
 
         connection_kwargs.pop("cache", None)
         connection_kwargs.pop("cache_config", None)
 
-        if self.connection_kwargs.get(
-            "maint_notifications_pool_handler"
-        ) or self.connection_kwargs.get("maint_notifications_config"):
-            if self.connection_kwargs.get("protocol") not in [3, "3"]:
-                raise RedisError(
-                    "Push handlers on connection are only supported with RESP version 3"
-                )
-            config = self.connection_kwargs.get("maint_notifications_config", None) or (
-                self.connection_kwargs.get("maint_notifications_pool_handler").config
-                if self.connection_kwargs.get("maint_notifications_pool_handler")
-                else None
-            )
-
-            if config and config.enabled:
-                self._update_connection_kwargs_for_maint_notifications()
-
-        self._event_dispatcher = self.connection_kwargs.get("event_dispatcher", None)
+        self._event_dispatcher = self._connection_kwargs.get("event_dispatcher", None)
         if self._event_dispatcher is None:
             self._event_dispatcher = EventDispatcher()
 
@@ -1816,6 +2485,12 @@ def __init__(
         self._fork_lock = threading.RLock()
         self._lock = threading.RLock()
 
+        MaintNotificationsAbstractConnectionPool.__init__(
+            self,
+            maint_notifications_config=maint_notifications_config,
+            **connection_kwargs,
+        )
+
         self.reset()
 
     def __repr__(self) -> str:
@@ -1826,76 +2501,21 @@ def __repr__(self) -> str:
             f"({conn_kwargs})>)>"
         )
 
-    def get_protocol(self):
-        """
-        Returns:
-            The RESP protocol version, or ``None`` if the protocol is not specified,
-            in which case the server default will be used.
-        """
-        return self.connection_kwargs.get("protocol", None)
-
-    def maint_notifications_pool_handler_enabled(self):
-        """
-        Returns:
-            True if the maintenance notifications pool handler is enabled, False otherwise.
-        """
-        maint_notifications_config = self.connection_kwargs.get(
-            "maint_notifications_config", None
-        )
-
-        return maint_notifications_config and maint_notifications_config.enabled
-
-    def set_maint_notifications_pool_handler(
-        self, maint_notifications_pool_handler: MaintNotificationsPoolHandler
-    ):
-        self.connection_kwargs.update(
-            {
-                "maint_notifications_pool_handler": maint_notifications_pool_handler,
-                "maint_notifications_config": maint_notifications_pool_handler.config,
-            }
-        )
-        self._update_connection_kwargs_for_maint_notifications()
-
-        self._update_maint_notifications_configs_for_connections(
-            maint_notifications_pool_handler
-        )
+    @property
+    def connection_kwargs(self) -> Dict[str, Any]:
+        return self._connection_kwargs
 
-    def _update_maint_notifications_configs_for_connections(
-        self, maint_notifications_pool_handler
-    ):
-        """Update the maintenance notifications config for all connections in the pool."""
-        with self._lock:
-            for conn in self._available_connections:
-                conn.set_maint_notifications_pool_handler(
-                    maint_notifications_pool_handler
-                )
-                conn.maint_notifications_config = (
-                    maint_notifications_pool_handler.config
-                )
-            for conn in self._in_use_connections:
-                conn.set_maint_notifications_pool_handler(
-                    maint_notifications_pool_handler
-                )
-                conn.maint_notifications_config = (
-                    maint_notifications_pool_handler.config
-                )
+    @connection_kwargs.setter
+    def connection_kwargs(self, value: Dict[str, Any]):
+        self._connection_kwargs = value
 
-    def _update_connection_kwargs_for_maint_notifications(self):
-        """Store original connection parameters for maintenance notifications."""
-        if self.connection_kwargs.get("orig_host_address", None) is None:
-            # If orig_host_address is None it means we haven't
-            # configured the original values yet
-            self.connection_kwargs.update(
-                {
-                    "orig_host_address": self.connection_kwargs.get("host"),
-                    "orig_socket_timeout": self.connection_kwargs.get(
-                        "socket_timeout", None
-                    ),
-                    "orig_socket_connect_timeout": self.connection_kwargs.get(
-                        "socket_connect_timeout", None
-                    ),
-                }
-            )
+    def get_protocol(self):
+        """
+        Returns:
+            The RESP protocol version, or ``None`` if the protocol is not specified,
+            in which case the server default will be used.
+        """
+        return self.connection_kwargs.get("protocol", None)
 
     def reset(self) -> None:
         self._created_connections = 0
@@ -1987,7 +2607,7 @@ def get_connection(self, command_name=None, *keys, **options) -> "Connection":
                 if (
                     connection.can_read()
                     and self.cache is None
-                    and not self.maint_notifications_pool_handler_enabled()
+                    and not self.maint_notifications_enabled()
                 ):
                     raise ConnectionError("Connection has data")
             except (ConnectionError, TimeoutError, OSError):
@@ -2059,7 +2679,7 @@ def disconnect(self, inuse_connections: bool = True) -> None:
         Disconnects connections in the pool
 
         If ``inuse_connections`` is True, disconnect connections that are
-        current in use, potentially by other threads. Otherwise only disconnect
+        currently in use, potentially by other threads. Otherwise only disconnect
         connections that are idle in the pool.
         """
         self._checkpid()
@@ -2100,185 +2720,16 @@ def re_auth_callback(self, token: TokenInterface):
             for conn in self._in_use_connections:
                 conn.set_re_auth_token(token)
 
-    def _should_update_connection(
-        self,
-        conn: "Connection",
-        matching_pattern: Literal[
-            "connected_address", "configured_address", "notification_hash"
-        ] = "connected_address",
-        matching_address: Optional[str] = None,
-        matching_notification_hash: Optional[int] = None,
-    ) -> bool:
-        """
-        Check if the connection should be updated based on the matching criteria.
-        """
-        if matching_pattern == "connected_address":
-            if matching_address and conn.getpeername() != matching_address:
-                return False
-        elif matching_pattern == "configured_address":
-            if matching_address and conn.host != matching_address:
-                return False
-        elif matching_pattern == "notification_hash":
-            if (
-                matching_notification_hash
-                and conn.maintenance_notification_hash != matching_notification_hash
-            ):
-                return False
-        return True
-
-    def update_connection_settings(
-        self,
-        conn: "Connection",
-        state: Optional["MaintenanceState"] = None,
-        maintenance_notification_hash: Optional[int] = None,
-        host_address: Optional[str] = None,
-        relaxed_timeout: Optional[float] = None,
-        update_notification_hash: bool = False,
-        reset_host_address: bool = False,
-        reset_relaxed_timeout: bool = False,
-    ):
-        """
-        Update the settings for a single connection.
-        """
-        if state:
-            conn.maintenance_state = state
-
-        if update_notification_hash:
-            # update the notification hash only if requested
-            conn.maintenance_notification_hash = maintenance_notification_hash
-
-        if host_address is not None:
-            conn.set_tmp_settings(tmp_host_address=host_address)
-
-        if relaxed_timeout is not None:
-            conn.set_tmp_settings(tmp_relaxed_timeout=relaxed_timeout)
-
-        if reset_relaxed_timeout or reset_host_address:
-            conn.reset_tmp_settings(
-                reset_host_address=reset_host_address,
-                reset_relaxed_timeout=reset_relaxed_timeout,
-            )
-
-        conn.update_current_socket_timeout(relaxed_timeout)
-
-    def update_connections_settings(
-        self,
-        state: Optional["MaintenanceState"] = None,
-        maintenance_notification_hash: Optional[int] = None,
-        host_address: Optional[str] = None,
-        relaxed_timeout: Optional[float] = None,
-        matching_address: Optional[str] = None,
-        matching_notification_hash: Optional[int] = None,
-        matching_pattern: Literal[
-            "connected_address", "configured_address", "notification_hash"
-        ] = "connected_address",
-        update_notification_hash: bool = False,
-        reset_host_address: bool = False,
-        reset_relaxed_timeout: bool = False,
-        include_free_connections: bool = True,
-    ):
-        """
-        Update the settings for all matching connections in the pool.
-
-        This method does not create new connections.
-        This method does not affect the connection kwargs.
-
-        :param state: The maintenance state to set for the connection.
-        :param maintenance_notification_hash: The hash of the maintenance notification
-                                               to set for the connection.
-        :param host_address: The host address to set for the connection.
-        :param relaxed_timeout: The relaxed timeout to set for the connection.
-        :param matching_address: The address to match for the connection.
-        :param matching_notification_hash: The notification hash to match for the connection.
-        :param matching_pattern: The pattern to match for the connection.
-        :param update_notification_hash: Whether to update the notification hash for the connection.
-        :param reset_host_address: Whether to reset the host address to the original address.
-        :param reset_relaxed_timeout: Whether to reset the relaxed timeout to the original timeout.
-        :param include_free_connections: Whether to include free/available connections.
-        """
-        with self._lock:
-            for conn in self._in_use_connections:
-                if self._should_update_connection(
-                    conn,
-                    matching_pattern,
-                    matching_address,
-                    matching_notification_hash,
-                ):
-                    self.update_connection_settings(
-                        conn,
-                        state=state,
-                        maintenance_notification_hash=maintenance_notification_hash,
-                        host_address=host_address,
-                        relaxed_timeout=relaxed_timeout,
-                        update_notification_hash=update_notification_hash,
-                        reset_host_address=reset_host_address,
-                        reset_relaxed_timeout=reset_relaxed_timeout,
-                    )
-
-            if include_free_connections:
-                for conn in self._available_connections:
-                    if self._should_update_connection(
-                        conn,
-                        matching_pattern,
-                        matching_address,
-                        matching_notification_hash,
-                    ):
-                        self.update_connection_settings(
-                            conn,
-                            state=state,
-                            maintenance_notification_hash=maintenance_notification_hash,
-                            host_address=host_address,
-                            relaxed_timeout=relaxed_timeout,
-                            update_notification_hash=update_notification_hash,
-                            reset_host_address=reset_host_address,
-                            reset_relaxed_timeout=reset_relaxed_timeout,
-                        )
-
-    def update_connection_kwargs(
-        self,
-        **kwargs,
-    ):
-        """
-        Update the connection kwargs for all future connections.
-
-        This method updates the connection kwargs for all future connections created by the pool.
-        Existing connections are not affected.
-        """
-        self.connection_kwargs.update(kwargs)
-
-    def update_active_connections_for_reconnect(
-        self,
-        moving_address_src: Optional[str] = None,
-    ):
-        """
-        Mark all active connections for reconnect.
-        This is used when a cluster node is migrated to a different address.
+    def _get_pool_lock(self):
+        return self._lock
 
-        :param moving_address_src: The address of the node that is being moved.
-        """
+    def _get_free_connections(self):
         with self._lock:
-            for conn in self._in_use_connections:
-                if self._should_update_connection(
-                    conn, "connected_address", moving_address_src
-                ):
-                    conn.mark_for_reconnect()
-
-    def disconnect_free_connections(
-        self,
-        moving_address_src: Optional[str] = None,
-    ):
-        """
-        Disconnect all free/available connections.
-        This is used when a cluster node is migrated to a different address.
+            return self._available_connections
 
-        :param moving_address_src: The address of the node that is being moved.
-        """
+    def _get_in_use_connections(self):
         with self._lock:
-            for conn in self._available_connections:
-                if self._should_update_connection(
-                    conn, "connected_address", moving_address_src
-                ):
-                    conn.disconnect()
+            return self._in_use_connections
 
     async def _mock(self, error: RedisError):
         """
@@ -2391,7 +2842,7 @@ def make_connection(self):
                 )
             else:
                 connection = self.connection_class(**self.connection_kwargs)
-                self._connections.append(connection)
+            self._connections.append(connection)
             return connection
         finally:
             if self._locked:
@@ -2520,124 +2971,19 @@ def disconnect(self):
                     pass
                 self._locked = False
 
-    def update_connections_settings(
-        self,
-        state: Optional["MaintenanceState"] = None,
-        maintenance_notification_hash: Optional[int] = None,
-        relaxed_timeout: Optional[float] = None,
-        host_address: Optional[str] = None,
-        matching_address: Optional[str] = None,
-        matching_notification_hash: Optional[int] = None,
-        matching_pattern: Literal[
-            "connected_address", "configured_address", "notification_hash"
-        ] = "connected_address",
-        update_notification_hash: bool = False,
-        reset_host_address: bool = False,
-        reset_relaxed_timeout: bool = False,
-        include_free_connections: bool = True,
-    ):
-        """
-        Override base class method to work with BlockingConnectionPool's structure.
-        """
+    def _get_free_connections(self):
         with self._lock:
-            if include_free_connections:
-                for conn in tuple(self._connections):
-                    if self._should_update_connection(
-                        conn,
-                        matching_pattern,
-                        matching_address,
-                        matching_notification_hash,
-                    ):
-                        self.update_connection_settings(
-                            conn,
-                            state=state,
-                            maintenance_notification_hash=maintenance_notification_hash,
-                            host_address=host_address,
-                            relaxed_timeout=relaxed_timeout,
-                            update_notification_hash=update_notification_hash,
-                            reset_host_address=reset_host_address,
-                            reset_relaxed_timeout=reset_relaxed_timeout,
-                        )
-            else:
-                connections_in_queue = {conn for conn in self.pool.queue if conn}
-                for conn in self._connections:
-                    if conn not in connections_in_queue:
-                        if self._should_update_connection(
-                            conn,
-                            matching_pattern,
-                            matching_address,
-                            matching_notification_hash,
-                        ):
-                            self.update_connection_settings(
-                                conn,
-                                state=state,
-                                maintenance_notification_hash=maintenance_notification_hash,
-                                host_address=host_address,
-                                relaxed_timeout=relaxed_timeout,
-                                update_notification_hash=update_notification_hash,
-                                reset_host_address=reset_host_address,
-                                reset_relaxed_timeout=reset_relaxed_timeout,
-                            )
-
-    def update_active_connections_for_reconnect(
-        self,
-        moving_address_src: Optional[str] = None,
-    ):
-        """
-        Mark all active connections for reconnect.
-        This is used when a cluster node is migrated to a different address.
+            return {conn for conn in self.pool.queue if conn}
 
-        :param moving_address_src: The address of the node that is being moved.
-        """
+    def _get_in_use_connections(self):
         with self._lock:
+            # free connections
             connections_in_queue = {conn for conn in self.pool.queue if conn}
-            for conn in self._connections:
-                if conn not in connections_in_queue:
-                    if self._should_update_connection(
-                        conn,
-                        matching_pattern="connected_address",
-                        matching_address=moving_address_src,
-                    ):
-                        conn.mark_for_reconnect()
-
-    def disconnect_free_connections(
-        self,
-        moving_address_src: Optional[str] = None,
-    ):
-        """
-        Disconnect all free/available connections.
-        This is used when a cluster node is migrated to a different address.
-
-        :param moving_address_src: The address of the node that is being moved.
-        """
-        with self._lock:
-            existing_connections = self.pool.queue
-
-            for conn in existing_connections:
-                if conn:
-                    if self._should_update_connection(
-                        conn, "connected_address", moving_address_src
-                    ):
-                        conn.disconnect()
-
-    def _update_maint_notifications_config_for_connections(
-        self, maint_notifications_config
-    ):
-        for conn in tuple(self._connections):
-            conn.maint_notifications_config = maint_notifications_config
-
-    def _update_maint_notifications_configs_for_connections(
-        self, maint_notifications_pool_handler
-    ):
-        """Update the maintenance notifications config for all connections in the pool."""
-        with self._lock:
-            for conn in tuple(self._connections):
-                conn.set_maint_notifications_pool_handler(
-                    maint_notifications_pool_handler
-                )
-                conn.maint_notifications_config = (
-                    maint_notifications_pool_handler.config
-                )
+            # in self._connections we keep all created connections
+            # so the ones that are not in the queue are the in use ones
+            return {
+                conn for conn in self._connections if conn not in connections_in_queue
+            }
 
     def set_in_maintenance(self, in_maintenance: bool):
         """
diff --git a/redis/maint_notifications.py b/redis/maint_notifications.py
index 37e4f93a3f..5b8b08c1be 100644
--- a/redis/maint_notifications.py
+++ b/redis/maint_notifications.py
@@ -32,9 +32,8 @@ def __str__(self):
 
 if TYPE_CHECKING:
     from redis.connection import (
-        BlockingConnectionPool,
-        ConnectionInterface,
-        ConnectionPool,
+        MaintNotificationsAbstractConnection,
+        MaintNotificationsAbstractConnectionPool,
     )
 
 
@@ -501,7 +500,7 @@ def is_relaxed_timeouts_enabled(self) -> bool:
         return self.relaxed_timeout != -1
 
     def get_endpoint_type(
-        self, host: str, connection: "ConnectionInterface"
+        self, host: str, connection: "MaintNotificationsAbstractConnection"
     ) -> EndpointType:
         """
         Determine the appropriate endpoint type for CLIENT MAINT_NOTIFICATIONS command.
@@ -558,7 +557,7 @@ def get_endpoint_type(
 class MaintNotificationsPoolHandler:
     def __init__(
         self,
-        pool: Union["ConnectionPool", "BlockingConnectionPool"],
+        pool: "MaintNotificationsAbstractConnectionPool",
         config: MaintNotificationsConfig,
     ) -> None:
         self.pool = pool
@@ -567,9 +566,19 @@ def __init__(
         self._lock = threading.RLock()
         self.connection = None
 
-    def set_connection(self, connection: "ConnectionInterface"):
+    def set_connection(self, connection: "MaintNotificationsAbstractConnection"):
         self.connection = connection
 
+    def get_handler_for_connection(self):
+        # Copy all data that should be shared between connections
+        # but each connection should have its own pool handler
+        # since each connection can be in a different state
+        copy = MaintNotificationsPoolHandler(self.pool, self.config)
+        copy._processed_notifications = self._processed_notifications
+        copy._lock = self._lock
+        copy.connection = None
+        return copy
+
     def remove_expired_notifications(self):
         with self._lock:
             for notification in tuple(self._processed_notifications):
@@ -751,7 +760,9 @@ class MaintNotificationsConnectionHandler:
     }
 
     def __init__(
-        self, connection: "ConnectionInterface", config: MaintNotificationsConfig
+        self,
+        connection: "MaintNotificationsAbstractConnection",
+        config: MaintNotificationsConfig,
     ) -> None:
         self.connection = connection
         self.config = config
diff --git a/tests/test_credentials.py b/tests/test_credentials.py
index 8b8e0cfc2c..29140b9e05 100644
--- a/tests/test_credentials.py
+++ b/tests/test_credentials.py
@@ -11,7 +11,10 @@
 from redis import AuthenticationError, DataError, Redis, ResponseError
 from redis.auth.err import RequestTokenErr
 from redis.backoff import NoBackoff
-from redis.connection import ConnectionInterface, ConnectionPool
+from redis.connection import (
+    ConnectionInterface,
+    ConnectionPool,
+)
 from redis.credentials import CredentialProvider, UsernamePasswordCredentialProvider
 from redis.exceptions import ConnectionError, RedisError
 from redis.retry import Retry
@@ -428,6 +431,7 @@ def re_auth_callback(token):
     def test_re_auth_pub_sub_in_resp3(self, credential_provider):
         mock_pubsub_connection = Mock(spec=ConnectionInterface)
         mock_pubsub_connection.get_protocol.return_value = 3
+        mock_pubsub_connection.should_reconnect = Mock(return_value=False)
         mock_pubsub_connection.credential_provider = credential_provider
         mock_pubsub_connection.retry = Retry(NoBackoff(), 3)
         mock_another_connection = Mock(spec=ConnectionInterface)
@@ -488,6 +492,7 @@ def re_auth_callback(token):
     def test_do_not_re_auth_pub_sub_in_resp2(self, credential_provider):
         mock_pubsub_connection = Mock(spec=ConnectionInterface)
         mock_pubsub_connection.get_protocol.return_value = 2
+        mock_pubsub_connection.should_reconnect = Mock(return_value=False)
         mock_pubsub_connection.credential_provider = credential_provider
         mock_pubsub_connection.retry = Retry(NoBackoff(), 3)
         mock_another_connection = Mock(spec=ConnectionInterface)
diff --git a/tests/test_maint_notifications.py b/tests/test_maint_notifications.py
index 08ac15368f..85aa671390 100644
--- a/tests/test_maint_notifications.py
+++ b/tests/test_maint_notifications.py
@@ -2,7 +2,7 @@
 from unittest.mock import Mock, call, patch, MagicMock
 import pytest
 
-from redis.connection import ConnectionInterface
+from redis.connection import ConnectionInterface, MaintNotificationsAbstractConnection
 
 from redis.maint_notifications import (
     MaintenanceNotification,
@@ -758,13 +758,16 @@ def __init__(self, resolved_ip):
             def getpeername(self):
                 return (self.resolved_ip, 6379)
 
-        class MockConnection(ConnectionInterface):
+        class MockConnection(MaintNotificationsAbstractConnection, ConnectionInterface):
             def __init__(self, host, resolved_ip=None, is_ssl=False):
                 self.host = host
                 self.port = 6379
                 self._sock = MockSocket(resolved_ip) if resolved_ip else None
                 self.__class__.__name__ = "SSLConnection" if is_ssl else "Connection"
 
+            def _get_socket(self):
+                return self._sock
+
             def get_resolved_ip(self):
                 # Call the actual method from AbstractConnection
                 from redis.connection import AbstractConnection
diff --git a/tests/test_maint_notifications_handling.py b/tests/test_maint_notifications_handling.py
index 54b6e2dff7..556b63d7e1 100644
--- a/tests/test_maint_notifications_handling.py
+++ b/tests/test_maint_notifications_handling.py
@@ -7,8 +7,10 @@
 from time import sleep
 
 from redis import Redis
+from redis.cache import CacheConfig
 from redis.connection import (
     AbstractConnection,
+    Connection,
     ConnectionPool,
     BlockingConnectionPool,
     MaintenanceState,
@@ -68,7 +70,7 @@ def validate_in_use_connections_state(
         # and timeout is updated
         for connection in in_use_connections:
             if expected_should_reconnect != "any":
-                assert connection._should_reconnect == expected_should_reconnect
+                assert connection.should_reconnect() == expected_should_reconnect
             assert connection.host == expected_host_address
             assert connection.socket_timeout == expected_socket_timeout
             assert connection.socket_connect_timeout == expected_socket_connect_timeout
@@ -78,13 +80,12 @@ def validate_in_use_connections_state(
                 connection.orig_socket_connect_timeout
                 == expected_orig_socket_connect_timeout
             )
-            if connection._sock is not None:
-                assert connection._sock.gettimeout() == expected_current_socket_timeout
-                assert connection._sock.connected is True
+            conn_socket = connection._get_socket()
+            if conn_socket is not None:
+                assert conn_socket.gettimeout() == expected_current_socket_timeout
+                assert conn_socket.connected is True
                 if expected_current_peername != "any":
-                    assert (
-                        connection._sock.getpeername()[0] == expected_current_peername
-                    )
+                    assert conn_socket.getpeername()[0] == expected_current_peername
             assert connection.maintenance_state == expected_state
 
     @staticmethod
@@ -112,7 +113,7 @@ def validate_free_connections_state(
 
         connected_count = 0
         for connection in free_connections:
-            assert connection._should_reconnect is False
+            assert connection.should_reconnect() is False
             assert connection.host == expected_host_address
             assert connection.socket_timeout == expected_socket_timeout
             assert connection.socket_connect_timeout == expected_socket_connect_timeout
@@ -126,10 +127,11 @@ def validate_free_connections_state(
             if expected_state == MaintenanceState.NONE:
                 assert connection.maintenance_notification_hash is None
 
-            if connection._sock is not None:
-                assert connection._sock.connected is True
+            conn_socket = connection._get_socket()
+            if conn_socket is not None:
+                assert conn_socket.connected is True
                 if connected_to_tmp_address and tmp_address != "any":
-                    assert connection._sock.getpeername()[0] == tmp_address
+                    assert conn_socket.getpeername()[0] == tmp_address
                 connected_count += 1
         assert connected_count == should_be_connected_count
 
@@ -201,7 +203,7 @@ def send(self, data):
 
         # Analyze the command and prepare appropriate response
         if b"HELLO" in data:
-            response = b"%7\r\n$6\r\nserver\r\n$5\r\nredis\r\n$7\r\nversion\r\n$5\r\n7.0.0\r\n$5\r\nproto\r\n:3\r\n$2\r\nid\r\n:1\r\n$4\r\nmode\r\n$10\r\nstandalone\r\n$4\r\nrole\r\n$6\r\nmaster\r\n$7\r\nmodules\r\n*0\r\n"
+            response = b"%7\r\n$6\r\nserver\r\n$5\r\nredis\r\n$7\r\nversion\r\n$5\r\n7.4.0\r\n$5\r\nproto\r\n:3\r\n$2\r\nid\r\n:1\r\n$4\r\nmode\r\n$10\r\nstandalone\r\n$4\r\nrole\r\n$6\r\nmaster\r\n$7\r\nmodules\r\n*0\r\n"
             self.pending_responses.append(response)
         elif b"MAINT_NOTIFICATIONS" in data and b"internal-ip" in data:
             # Simulate error response - activate it only for internal-ip tests
@@ -302,6 +304,38 @@ def recv(self, bufsize):
 
             raise BlockingIOError(errno.EAGAIN, "Resource temporarily unavailable")
 
+    def recv_into(self, buffer, nbytes=0):
+        """
+        Receive data from Redis and write it into the provided buffer.
+        Returns the number of bytes written.
+
+        This method is used by the hiredis parser for efficient data reading.
+        """
+        if self.closed:
+            raise ConnectionError("Socket is closed")
+
+        # Use pending responses that were prepared when commands were sent
+        if self.pending_responses:
+            response = self.pending_responses.pop(0)
+            if b"MOVING" in response:
+                self.moving_sent = True
+
+            # Determine how many bytes to write
+            if nbytes == 0:
+                nbytes = len(buffer)
+
+            # Write data into the buffer (up to nbytes or response length)
+            bytes_to_write = min(len(response), nbytes, len(buffer))
+            buffer[:bytes_to_write] = response[:bytes_to_write]
+
+            return bytes_to_write
+        else:
+            # No data available - this should block or raise an exception
+            # For can_read checks, we should indicate no data is available
+            import errno
+
+            raise BlockingIOError(errno.EAGAIN, "Resource temporarily unavailable")
+
     def fileno(self):
         """Return a fake file descriptor for select/poll operations."""
         return 1  # Fake file descriptor
@@ -392,9 +426,10 @@ def teardown_method(self):
     def _get_client(
         self,
         pool_class,
+        connection_class=Connection,
+        enable_cache=False,
         max_connections=10,
         maint_notifications_config=None,
-        setup_pool_handler=False,
     ):
         """Helper method to create a pool and Redis client with maintenance notifications configuration.
 
@@ -413,25 +448,21 @@ def _get_client(
             if maint_notifications_config is not None
             else self.config
         )
+        pool_kwargs = {}
+        if enable_cache:
+            pool_kwargs = {"cache_config": CacheConfig()}
 
         test_pool = pool_class(
+            connection_class=connection_class,
             host=DEFAULT_ADDRESS.split(":")[0],
             port=int(DEFAULT_ADDRESS.split(":")[1]),
             max_connections=max_connections,
             protocol=3,  # Required for maintenance notifications
             maint_notifications_config=config,
+            **pool_kwargs,
         )
         test_redis_client = Redis(connection_pool=test_pool)
 
-        # Set up pool handler for moving notifications if requested
-        if setup_pool_handler:
-            pool_handler = MaintNotificationsPoolHandler(
-                test_redis_client.connection_pool, config
-            )
-            test_redis_client.connection_pool.set_maint_notifications_pool_handler(
-                pool_handler
-            )
-
         return test_redis_client
 
 
@@ -490,6 +521,9 @@ def test_handshake_failure_when_enabled(self):
         )
         try:
             with pytest.raises(ResponseError):
+                # handshake should fail
+                # socket mock will return error when enabling maint notifications
+                # for internal-ip
                 test_redis_client.set("hello", "world")
 
         finally:
@@ -506,7 +540,13 @@ def _validate_connection_handlers(self, conn, pool_handler, config):
         assert parser_handler is not None
         assert hasattr(parser_handler, "__self__")
         assert hasattr(parser_handler, "__func__")
-        assert parser_handler.__self__ is pool_handler
+        assert parser_handler.__self__.connection is conn
+        assert parser_handler.__self__.pool is pool_handler.pool
+        assert parser_handler.__self__._lock is pool_handler._lock
+        assert (
+            parser_handler.__self__._processed_notifications
+            is pool_handler._processed_notifications
+        )
         assert parser_handler.__func__ is pool_handler.handle_notification.__func__
 
         # Test that the maintenance handler function is correctly set
@@ -576,36 +616,12 @@ def test_client_initialization(self):
         assert pool_handler.config == self.config
 
         conn = test_redis_client.connection_pool.get_connection()
-        assert conn._should_reconnect is False
+
+        assert conn.should_reconnect() is False
         assert conn.orig_host_address == "localhost"
         assert conn.orig_socket_timeout is None
 
-        # Test that the node moving handler function is correctly set by
-        # comparing the underlying function and instance
-        parser_handler = conn._parser.node_moving_push_handler_func
-        assert parser_handler is not None
-        assert hasattr(parser_handler, "__self__")
-        assert hasattr(parser_handler, "__func__")
-        assert parser_handler.__self__ is pool_handler
-        assert parser_handler.__func__ is pool_handler.handle_notification.__func__
-
-        # Test that the maintenance handler function is correctly set
-        maintenance_handler = conn._parser.maintenance_push_handler_func
-        assert maintenance_handler is not None
-        assert hasattr(maintenance_handler, "__self__")
-        assert hasattr(maintenance_handler, "__func__")
-        # The maintenance handler should be bound to the connection's
-        # maintenance notification connection handler
-        assert (
-            maintenance_handler.__self__ is conn._maint_notifications_connection_handler
-        )
-        assert (
-            maintenance_handler.__func__
-            is conn._maint_notifications_connection_handler.handle_notification.__func__
-        )
-
-        # Validate that the connection's maintenance handler has the same config object
-        assert conn._maint_notifications_connection_handler.config is self.config
+        self._validate_connection_handlers(conn, pool_handler, self.config)
 
     def test_maint_handler_init_for_existing_connections(self):
         """Test that maintenance notification handlers are properly set on existing and new connections
@@ -630,13 +646,13 @@ def test_maint_handler_init_for_existing_connections(self):
         enabled_config = MaintNotificationsConfig(
             enabled=True, proactive_reconnect=True, relaxed_timeout=30
         )
-        pool_handler = MaintNotificationsPoolHandler(
-            test_redis_client.connection_pool, enabled_config
-        )
-        test_redis_client.connection_pool.set_maint_notifications_pool_handler(
-            pool_handler
+        test_redis_client.connection_pool.update_maint_notifications_config(
+            enabled_config
         )
 
+        pool_handler = (
+            test_redis_client.connection_pool._maint_notifications_pool_handler
+        )
         # Validate the existing connection after enabling maintenance notifications
         # Both existing and new connections should now have full handler setup
         self._validate_connection_handlers(existing_conn, pool_handler, enabled_config)
@@ -644,6 +660,7 @@ def test_maint_handler_init_for_existing_connections(self):
         # Create a new connection and validate it has full handlers
         new_conn = test_redis_client.connection_pool.get_connection()
         self._validate_connection_handlers(new_conn, pool_handler, enabled_config)
+        self._validate_connection_handlers(existing_conn, pool_handler, enabled_config)
 
         # Clean up connections
         test_redis_client.connection_pool.release(existing_conn)
@@ -665,11 +682,11 @@ def test_connection_pool_creation_with_maintenance_notifications(self, pool_clas
                 == self.config
             )
             # Pool should have maintenance notifications enabled
-            assert test_pool.maint_notifications_pool_handler_enabled() is True
+            assert test_pool.maint_notifications_enabled() is True
 
             # Create and set a pool handler
-            pool_handler = MaintNotificationsPoolHandler(test_pool, self.config)
-            test_pool.set_maint_notifications_pool_handler(pool_handler)
+            test_pool.update_maint_notifications_config(self.config)
+            pool_handler = test_pool._maint_notifications_pool_handler
 
             # Validate that the handler is properly set on the pool
             assert (
@@ -1056,9 +1073,7 @@ def test_moving_related_notifications_handling_integration(self, pool_class):
         5. Tests both ConnectionPool and BlockingConnectionPool implementations
         """
         # Create a pool and Redis client with maintenance notifications and pool handler
-        test_redis_client = self._get_client(
-            pool_class, max_connections=10, setup_pool_handler=True
-        )
+        test_redis_client = self._get_client(pool_class, max_connections=10)
 
         try:
             # Create several connections and return them in the pool
@@ -1190,9 +1205,7 @@ def test_moving_none_notifications_handling_integration(self, pool_class):
         5. Tests both ConnectionPool and BlockingConnectionPool implementations
         """
         # Create a pool and Redis client with maintenance notifications and pool handler
-        test_redis_client = self._get_client(
-            pool_class, max_connections=10, setup_pool_handler=True
-        )
+        test_redis_client = self._get_client(pool_class, max_connections=10)
 
         try:
             # Create several connections and return them in the pool
@@ -1339,9 +1352,7 @@ def test_create_new_conn_while_moving_not_expired(self, pool_class):
         3. Pool configuration is properly applied to newly created connections
         """
         # Create a pool and Redis client with maintenance notifications and pool handler
-        test_redis_client = self._get_client(
-            pool_class, max_connections=10, setup_pool_handler=True
-        )
+        test_redis_client = self._get_client(pool_class, max_connections=10)
 
         try:
             # Create several connections and return them in the pool
@@ -1399,13 +1410,15 @@ def test_create_new_conn_while_moving_not_expired(self, pool_class):
             assert new_connection.host == AFTER_MOVING_ADDRESS.split(":")[0]
             assert new_connection.socket_timeout is self.config.relaxed_timeout
             # New connections should be connected to the temporary address
-            assert new_connection._sock is not None
-            assert new_connection._sock.connected is True
+            assert new_connection._get_socket() is not None
+            assert new_connection._get_socket().connected is True
             assert (
-                new_connection._sock.getpeername()[0]
+                new_connection._get_socket().getpeername()[0]
                 == AFTER_MOVING_ADDRESS.split(":")[0]
             )
-            assert new_connection._sock.gettimeout() == self.config.relaxed_timeout
+            assert (
+                new_connection._get_socket().gettimeout() == self.config.relaxed_timeout
+            )
 
         finally:
             if hasattr(test_redis_client.connection_pool, "disconnect"):
@@ -1422,9 +1435,7 @@ def test_create_new_conn_after_moving_expires(self, pool_class):
         3. New connections don't inherit temporary settings
         """
         # Create a pool and Redis client with maintenance notifications and pool handler
-        test_redis_client = self._get_client(
-            pool_class, max_connections=10, setup_pool_handler=True
-        )
+        test_redis_client = self._get_client(pool_class, max_connections=10)
 
         try:
             # Create several connections and return them in the pool
@@ -1465,10 +1476,10 @@ def test_create_new_conn_after_moving_expires(self, pool_class):
             assert new_connection.orig_host_address == DEFAULT_ADDRESS.split(":")[0]
             assert new_connection.orig_socket_timeout is None
             # New connections should be connected to the original address
-            assert new_connection._sock is not None
-            assert new_connection._sock.connected is True
+            assert new_connection._get_socket() is not None
+            assert new_connection._get_socket().connected is True
             # Socket timeout should be None (original timeout)
-            assert new_connection._sock.gettimeout() is None
+            assert new_connection._get_socket().gettimeout() is None
 
         finally:
             if hasattr(test_redis_client.connection_pool, "disconnect"):
@@ -1489,9 +1500,7 @@ def test_receive_migrated_after_moving(self, pool_class):
         it should not decrease timeouts (future refactoring consideration).
         """
         # Create a pool and Redis client with maintenance notifications and pool handler
-        test_redis_client = self._get_client(
-            pool_class, max_connections=10, setup_pool_handler=True
-        )
+        test_redis_client = self._get_client(pool_class, max_connections=10)
 
         try:
             # Create several connections and return them in the pool
@@ -1575,8 +1584,8 @@ def test_receive_migrated_after_moving(self, pool_class):
                 # Note: New connections may not inherit the exact relaxed timeout value
                 # but they should have the temporary host address
                 # New connections should be connected
-                if connection._sock is not None:
-                    assert connection._sock.connected is True
+                if connection._get_socket() is not None:
+                    assert connection._get_socket().connected is True
 
             # Release the new connections
             for connection in new_connections:
@@ -1597,9 +1606,7 @@ def test_overlapping_moving_notifications(self, pool_class):
         Ensures that the second MOVING notification updates the pool and connections as expected, and that expiry/cleanup works.
         """
         global AFTER_MOVING_ADDRESS
-        test_redis_client = self._get_client(
-            pool_class, max_connections=5, setup_pool_handler=True
-        )
+        test_redis_client = self._get_client(pool_class, max_connections=5)
         try:
             # Create and release some connections
             in_use_connections = []
@@ -1708,7 +1715,6 @@ def test_overlapping_moving_notifications(self, pool_class):
                     expected_current_socket_timeout=self.config.relaxed_timeout,
                     expected_current_peername=orig_after_moving.split(":")[0],
                 )
-                # print(test_redis_client.connection_pool._available_connections)
                 Helpers.validate_free_connections_state(
                     test_redis_client.connection_pool,
                     should_be_connected_count=1,
@@ -1751,9 +1757,7 @@ def test_thread_safety_concurrent_notification_handling(self, pool_class):
         """
         import threading
 
-        test_redis_client = self._get_client(
-            pool_class, max_connections=5, setup_pool_handler=True
-        )
+        test_redis_client = self._get_client(pool_class, max_connections=5)
         results = []
         errors = []
 
@@ -1790,8 +1794,18 @@ def worker(idx):
         if hasattr(test_redis_client.connection_pool, "disconnect"):
             test_redis_client.connection_pool.disconnect()
 
-    @pytest.mark.parametrize("pool_class", [ConnectionPool, BlockingConnectionPool])
-    def test_moving_migrating_migrated_moved_state_transitions(self, pool_class):
+    @pytest.mark.parametrize(
+        "pool_class,enable_cache",
+        [
+            (ConnectionPool, False),
+            (ConnectionPool, True),
+            (BlockingConnectionPool, False),
+            (BlockingConnectionPool, True),
+        ],
+    )
+    def test_moving_migrating_migrated_moved_state_transitions(
+        self, pool_class, enable_cache
+    ):
         """
         Test moving configs are not lost if the per connection notifications get picked up after moving is handled.
         Sequence of notifications: MOVING, MIGRATING, MIGRATED, FAILING_OVER, FAILED_OVER, MOVED.
@@ -1800,17 +1814,18 @@ def test_moving_migrating_migrated_moved_state_transitions(self, pool_class):
         """
         # Setup
         test_redis_client = self._get_client(
-            pool_class, max_connections=5, setup_pool_handler=True
+            pool_class,
+            max_connections=5,
+            enable_cache=enable_cache,
         )
         pool = test_redis_client.connection_pool
-        pool_handler = pool.connection_kwargs["maint_notifications_pool_handler"]
 
         # Create and release some connections
         in_use_connections = []
         for _ in range(3):
             in_use_connections.append(pool.get_connection())
 
-        pool_handler.set_connection(in_use_connections[0])
+        pool_handler = in_use_connections[0]._maint_notifications_pool_handler
 
         while len(in_use_connections) > 0:
             pool.release(in_use_connections.pop())
@@ -2019,10 +2034,8 @@ def test_migrating_after_moving_multiple_proxies(self, pool_class):
             protocol=3,  # Required for maintenance notifications
             maint_notifications_config=self.config,
         )
-        pool.set_maint_notifications_pool_handler(
-            MaintNotificationsPoolHandler(pool, self.config)
-        )
-        pool_handler = pool.connection_kwargs["maint_notifications_pool_handler"]
+
+        pool_handler = pool._maint_notifications_pool_handler
 
         # Create and release some connections
         key1 = "1.2.3.4"
diff --git a/tests/test_scenario/conftest.py b/tests/test_scenario/conftest.py
index 409f3088ca..a7bdb61b07 100644
--- a/tests/test_scenario/conftest.py
+++ b/tests/test_scenario/conftest.py
@@ -233,9 +233,5 @@ def _get_client_maint_notifications(
     )
     logging.info("Redis client created with maintenance notifications enabled")
     logging.info(f"Client uses Protocol: {client.connection_pool.get_protocol()}")
-    maintenance_handler_exists = client.maint_notifications_pool_handler is not None
-    logging.info(
-        f"Maintenance notifications pool handler: {maintenance_handler_exists}"
-    )
 
     return client

From 1c474e5057f7583e4ef8434f6df8e508f774d8c4 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 16 Oct 2025 19:17:28 +0300
Subject: [PATCH 1135/1164] Fixing argument type hints for evalsha and similar
 commands. (#3794)

---
 redis/commands/core.py | 20 ++++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/redis/commands/core.py b/redis/commands/core.py
index d3d802dfb7..11667efa65 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -5861,12 +5861,16 @@ class ScriptCommands(CommandsProtocol):
     """
 
     def _eval(
-        self, command: str, script: str, numkeys: int, *keys_and_args: str
+        self,
+        command: str,
+        script: str,
+        numkeys: int,
+        *keys_and_args: Union[KeyT, EncodableT],
     ) -> Union[Awaitable[str], str]:
         return self.execute_command(command, script, numkeys, *keys_and_args)
 
     def eval(
-        self, script: str, numkeys: int, *keys_and_args: str
+        self, script: str, numkeys: int, *keys_and_args: Union[KeyT, EncodableT]
     ) -> Union[Awaitable[str], str]:
         """
         Execute the Lua ``script``, specifying the ``numkeys`` the script
@@ -5881,7 +5885,7 @@ def eval(
         return self._eval("EVAL", script, numkeys, *keys_and_args)
 
     def eval_ro(
-        self, script: str, numkeys: int, *keys_and_args: str
+        self, script: str, numkeys: int, *keys_and_args: Union[KeyT, EncodableT]
     ) -> Union[Awaitable[str], str]:
         """
         The read-only variant of the EVAL command
@@ -5895,12 +5899,16 @@ def eval_ro(
         return self._eval("EVAL_RO", script, numkeys, *keys_and_args)
 
     def _evalsha(
-        self, command: str, sha: str, numkeys: int, *keys_and_args: list
+        self,
+        command: str,
+        sha: str,
+        numkeys: int,
+        *keys_and_args: Union[KeyT, EncodableT],
     ) -> Union[Awaitable[str], str]:
         return self.execute_command(command, sha, numkeys, *keys_and_args)
 
     def evalsha(
-        self, sha: str, numkeys: int, *keys_and_args: str
+        self, sha: str, numkeys: int, *keys_and_args: Union[KeyT, EncodableT]
     ) -> Union[Awaitable[str], str]:
         """
         Use the ``sha`` to execute a Lua script already registered via EVAL
@@ -5916,7 +5924,7 @@ def evalsha(
         return self._evalsha("EVALSHA", sha, numkeys, *keys_and_args)
 
     def evalsha_ro(
-        self, sha: str, numkeys: int, *keys_and_args: str
+        self, sha: str, numkeys: int, *keys_and_args: Union[KeyT, EncodableT]
     ) -> Union[Awaitable[str], str]:
         """
         The read-only variant of the EVALSHA command

From 7f0808716f53ddf42557b5057e689286a72e451f Mon Sep 17 00:00:00 2001
From: Igor Malinovskiy <u.glide@gmail.com>
Date: Fri, 17 Oct 2025 13:38:53 +0200
Subject: [PATCH 1136/1164] Update Python version to 3.14 in hiredis CI
 workflow (#3798)

---
 .github/workflows/hiredis-py-integration.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/hiredis-py-integration.yaml b/.github/workflows/hiredis-py-integration.yaml
index e2cb03c4a6..9b5220ab12 100644
--- a/.github/workflows/hiredis-py-integration.yaml
+++ b/.github/workflows/hiredis-py-integration.yaml
@@ -45,7 +45,7 @@ jobs:
       fail-fast: false
       matrix:
         redis-version: [ '${{ needs.redis_version.outputs.CURRENT }}' ]
-        python-version: [ '3.9', '3.13']
+        python-version: [ '3.9', '3.14']
         parser-backend: [ 'hiredis' ]
         hiredis-version: [ 'unstable' ]
         event-loop: [ 'asyncio' ]
@@ -63,4 +63,4 @@ jobs:
           parser-backend: ${{ matrix.parser-backend }}
           redis-version: ${{ matrix.redis-version }}
           hiredis-version: ${{ matrix.hiredis-version }}
-          hiredis-branch: ${{ inputs.hiredis-branch }}
\ No newline at end of file
+          hiredis-branch: ${{ inputs.hiredis-branch }}

From 5ee081d0473d5c543aecf4cb11112570f614b3bc Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 21 Oct 2025 13:35:21 +0300
Subject: [PATCH 1137/1164] Adding score_cast_func argument to zrank, zrevrank
 and zunion - for consistency with the other sorted sets commands (#3795)

* Adding score_cast_func argument to zrank, zrevrank and zunion - for consistency with the other sorted sets commands

* Adding async tests; Add docstrings info for the new arg; removed unused option

* Applying review comments

* Try to fix the failing tests with Python 3.9 - it looks like a new dep version problem

* Restricting some lib versions for tests with PyPy Python - with newer versions we have hanging multiprocessing tests

* Restricting all test deps to specific versions for PyPy tests

* Skipping multiprocessing tests with PyPY Python due to unstable behavior - sometimes processes hang and cause action timeouts. Enabling all long running pipeline jobs to be started after the initial fast checks.

* Restricting lib requirements for Python 3.9 and fix an pubsub flaky test
---
 .github/workflows/integration.yaml  |  8 ++--
 dev_requirements.txt                | 17 ++++++-
 redis/_parsers/helpers.py           | 52 +++++++++++++++++++--
 redis/commands/core.py              | 36 ++++++++++++---
 tests/test_asyncio/test_commands.py | 44 +++++++++++++++---
 tests/test_commands.py              | 70 +++++++++++++++++++++++------
 tests/test_multiprocessing.py       |  8 ++++
 tests/test_pubsub.py                | 12 ++++-
 8 files changed, 208 insertions(+), 39 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index cbd210c14a..5adf7f41ac 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -94,7 +94,7 @@ jobs:
 
   python-compatibility-tests:
     runs-on: ubuntu-latest
-    needs: [ redis_version, tests ]
+    needs: [ redis_version ]
     timeout-minutes: 60
     strategy:
       max-parallel: 15
@@ -118,7 +118,7 @@ jobs:
 
   hiredis-tests:
     runs-on: ubuntu-latest
-    needs: [redis_version, tests]
+    needs: [redis_version]
     timeout-minutes: 60
     strategy:
       max-parallel: 15
@@ -144,7 +144,7 @@ jobs:
 
   uvloop-tests:
     runs-on: ubuntu-latest
-    needs: [redis_version, tests]
+    needs: [redis_version]
     timeout-minutes: 60
     strategy:
       max-parallel: 15
@@ -170,7 +170,7 @@ jobs:
   build-and-test-package:
     name: Validate building and installing the package
     runs-on: ubuntu-latest
-    needs: [tests]
+    needs: [redis_version]
     strategy:
       fail-fast: false
       matrix:
diff --git a/dev_requirements.txt b/dev_requirements.txt
index e61f37f101..7758a1839e 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -1,17 +1,30 @@
 build
+build==1.2.2.post1 ; platform_python_implementation == "PyPy" or python_version < "3.10"
 click==8.0.4
 invoke==2.2.0
 mock
+mock==5.1.0 ; platform_python_implementation == "PyPy" or python_version < "3.10"
 packaging>=20.4
+packaging==24.2 ; platform_python_implementation == "PyPy" or python_version < "3.10"
+
 pytest
+pytest==8.3.4 ; platform_python_implementation == "PyPy" or python_version < "3.10"
 pytest-asyncio>=0.23.0
+pytest-asyncio==1.1.0 ; platform_python_implementation == "PyPy" or python_version < "3.10"
 pytest-cov
+pytest-cov==6.0.0 ; platform_python_implementation == "PyPy" or python_version < "3.10"
+coverage==7.6.12 ; platform_python_implementation == "PyPy" or python_version < "3.10"
 pytest-profiling==1.8.1
 pytest-timeout
+pytest-timeout==2.3.1 ; platform_python_implementation == "PyPy" or python_version < "3.10"
+
 ruff==0.9.6
 ujson>=4.2.0
-uvloop
+uvloop<=0.21.0; platform_python_implementation == "CPython"
 vulture>=2.3.0
-numpy>=1.24.0
+
+numpy>=1.24.0 ; platform_python_implementation == "CPython"
+numpy>=1.24.0,<2.0 ; platform_python_implementation == "PyPy" or python_version < "3.10"
+
 redis-entraid==1.0.0
 pybreaker>=1.4.0
diff --git a/redis/_parsers/helpers.py b/redis/_parsers/helpers.py
index 154dc66dfb..5dfa8ee707 100644
--- a/redis/_parsers/helpers.py
+++ b/redis/_parsers/helpers.py
@@ -224,6 +224,39 @@ def zset_score_pairs(response, **options):
     return list(zip(it, map(score_cast_func, it)))
 
 
+def zset_score_for_rank(response, **options):
+    """
+    If ``withscores`` is specified in the options, return the response as
+    a [value, score] pair
+    """
+    if not response or not options.get("withscore"):
+        return response
+    score_cast_func = options.get("score_cast_func", float)
+    return [response[0], score_cast_func(response[1])]
+
+
+def zset_score_pairs_resp3(response, **options):
+    """
+    If ``withscores`` is specified in the options, return the response as
+    a list of [value, score] pairs
+    """
+    if not response or not options.get("withscores"):
+        return response
+    score_cast_func = options.get("score_cast_func", float)
+    return [[name, score_cast_func(val)] for name, val in response]
+
+
+def zset_score_for_rank_resp3(response, **options):
+    """
+    If ``withscores`` is specified in the options, return the response as
+    a [value, score] pair
+    """
+    if not response or not options.get("withscore"):
+        return response
+    score_cast_func = options.get("score_cast_func", float)
+    return [response[0], score_cast_func(response[1])]
+
+
 def sort_return_tuples(response, **options):
     """
     If ``groups`` is specified, return the response as a list of
@@ -797,10 +830,14 @@ def string_keys_to_dict(key_string, callback):
         "SDIFF SINTER SMEMBERS SUNION", lambda r: r and set(r) or set()
     ),
     **string_keys_to_dict(
-        "ZDIFF ZINTER ZPOPMAX ZPOPMIN ZRANGE ZRANGEBYSCORE ZRANK ZREVRANGE "
-        "ZREVRANGEBYSCORE ZREVRANK ZUNION",
+        "ZDIFF ZINTER ZPOPMAX ZPOPMIN ZRANGE ZRANGEBYSCORE ZREVRANGE "
+        "ZREVRANGEBYSCORE ZUNION",
         zset_score_pairs,
     ),
+    **string_keys_to_dict(
+        "ZREVRANK ZRANK",
+        zset_score_for_rank,
+    ),
     **string_keys_to_dict("ZINCRBY ZSCORE", float_or_none),
     **string_keys_to_dict("BGREWRITEAOF BGSAVE", lambda r: True),
     **string_keys_to_dict("BLPOP BRPOP", lambda r: r and tuple(r) or None),
@@ -844,10 +881,17 @@ def string_keys_to_dict(key_string, callback):
         "SDIFF SINTER SMEMBERS SUNION", lambda r: r and set(r) or set()
     ),
     **string_keys_to_dict(
-        "ZRANGE ZINTER ZPOPMAX ZPOPMIN ZRANGEBYSCORE ZREVRANGE ZREVRANGEBYSCORE "
-        "ZUNION HGETALL XREADGROUP",
+        "ZRANGE ZINTER ZPOPMAX ZPOPMIN HGETALL XREADGROUP",
         lambda r, **kwargs: r,
     ),
+    **string_keys_to_dict(
+        "ZRANGE ZRANGEBYSCORE ZREVRANGE ZREVRANGEBYSCORE ZUNION",
+        zset_score_pairs_resp3,
+    ),
+    **string_keys_to_dict(
+        "ZREVRANK ZRANK",
+        zset_score_for_rank_resp3,
+    ),
     **string_keys_to_dict("XREAD XREADGROUP", parse_xread_resp3),
     "ACL LOG": lambda r: (
         [
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 11667efa65..34086e3c09 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -4776,6 +4776,7 @@ def zrank(
         name: KeyT,
         value: EncodableT,
         withscore: bool = False,
+        score_cast_func: Union[type, Callable] = float,
     ) -> ResponseT:
         """
         Returns a 0-based value indicating the rank of ``value`` in sorted set
@@ -4783,11 +4784,17 @@ def zrank(
         The optional WITHSCORE argument supplements the command's
         reply with the score of the element returned.
 
+        ``score_cast_func`` a callable used to cast the score return value
+
         For more information, see https://redis.io/commands/zrank
         """
+        pieces = ["ZRANK", name, value]
         if withscore:
-            return self.execute_command("ZRANK", name, value, "WITHSCORE", keys=[name])
-        return self.execute_command("ZRANK", name, value, keys=[name])
+            pieces.append("WITHSCORE")
+
+        options = {"withscore": withscore, "score_cast_func": score_cast_func}
+
+        return self.execute_command(*pieces, **options)
 
     def zrem(self, name: KeyT, *values: FieldT) -> ResponseT:
         """
@@ -4835,6 +4842,7 @@ def zrevrank(
         name: KeyT,
         value: EncodableT,
         withscore: bool = False,
+        score_cast_func: Union[type, Callable] = float,
     ) -> ResponseT:
         """
         Returns a 0-based value indicating the descending rank of
@@ -4842,13 +4850,17 @@ def zrevrank(
         The optional ``withscore`` argument supplements the command's
         reply with the score of the element returned.
 
+        ``score_cast_func`` a callable used to cast the score return value
+
         For more information, see https://redis.io/commands/zrevrank
         """
+        pieces = ["ZREVRANK", name, value]
         if withscore:
-            return self.execute_command(
-                "ZREVRANK", name, value, "WITHSCORE", keys=[name]
-            )
-        return self.execute_command("ZREVRANK", name, value, keys=[name])
+            pieces.append("WITHSCORE")
+
+        options = {"withscore": withscore, "score_cast_func": score_cast_func}
+
+        return self.execute_command(*pieces, **options)
 
     def zscore(self, name: KeyT, value: EncodableT) -> ResponseT:
         """
@@ -4863,6 +4875,7 @@ def zunion(
         keys: Union[Sequence[KeyT], Mapping[AnyKeyT, float]],
         aggregate: Optional[str] = None,
         withscores: bool = False,
+        score_cast_func: Union[type, Callable] = float,
     ) -> ResponseT:
         """
         Return the union of multiple sorted sets specified by ``keys``.
@@ -4870,9 +4883,18 @@ def zunion(
         Scores will be aggregated based on the ``aggregate``, or SUM if
         none is provided.
 
+        ``score_cast_func`` a callable used to cast the score return value
+
         For more information, see https://redis.io/commands/zunion
         """
-        return self._zaggregate("ZUNION", None, keys, aggregate, withscores=withscores)
+        return self._zaggregate(
+            "ZUNION",
+            None,
+            keys,
+            aggregate,
+            withscores=withscores,
+            score_cast_func=score_cast_func,
+        )
 
     def zunionstore(
         self,
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index dda4dc2a1c..14690ef6e6 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -23,6 +23,7 @@
 from redis.commands.json.path import Path
 from redis.commands.search.field import TextField
 from redis.commands.search.query import Query
+from redis.utils import safe_str
 from tests.conftest import (
     assert_resp_response,
     assert_resp_response_in,
@@ -2071,11 +2072,14 @@ async def test_zrange(self, r: redis.Redis):
             r, response, [(b"a2", 2.0), (b"a3", 3.0)], [[b"a2", 2.0], [b"a3", 3.0]]
         )
 
-        # custom score function
-        # assert await r.zrange("a", 0, 1, withscores=True, score_cast_func=int) == [
-        #     (b"a1", 1),
-        #     (b"a2", 2),
-        # ]
+        # custom score cast function
+        response = await r.zrange("a", 0, 1, withscores=True, score_cast_func=safe_str)
+        assert_resp_response(
+            r,
+            response,
+            [(b"a1", "1"), (b"a2", "2")],
+            [[b"a1", "1.0"], [b"a2", "2.0"]],
+        )
 
     @skip_if_server_version_lt("2.8.9")
     async def test_zrangebylex(self, r: redis.Redis):
@@ -2127,6 +2131,15 @@ async def test_zrangebyscore(self, r: redis.Redis):
             [(b"a2", 2), (b"a3", 3), (b"a4", 4)],
             [[b"a2", 2], [b"a3", 3], [b"a4", 4]],
         )
+        response = await r.zrangebyscore(
+            "a", 2, 4, withscores=True, score_cast_func=safe_str
+        )
+        assert_resp_response(
+            r,
+            response,
+            [(b"a2", "2"), (b"a3", "3"), (b"a4", "4")],
+            [[b"a2", "2.0"], [b"a3", "3.0"], [b"a4", "4.0"]],
+        )
 
     async def test_zrank(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
@@ -2141,10 +2154,14 @@ async def test_zrank_withscore(self, r: redis.Redis):
         assert await r.zrank("a", "a2") == 1
         assert await r.zrank("a", "a6") is None
         assert_resp_response(
-            r, await r.zrank("a", "a3", withscore=True), [2, b"3"], [2, 3.0]
+            r, await r.zrank("a", "a3", withscore=True), [2, 3.0], [2, 3.0]
         )
         assert await r.zrank("a", "a6", withscore=True) is None
 
+        # custom score cast function
+        response = await r.zrank("a", "a3", withscore=True, score_cast_func=safe_str)
+        assert_resp_response(r, response, [2, "3"], [2, "3.0"])
+
     async def test_zrem(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
         assert await r.zrem("a", "a2") == 1
@@ -2200,6 +2217,19 @@ async def test_zrevrange(self, r: redis.Redis):
             r, response, [(b"a3", 3), (b"a2", 2)], [[b"a3", 3], [b"a2", 2]]
         )
 
+        # custom score cast function
+        # should be applied to resp2 and resp3
+        # responses
+        response = await r.zrevrange(
+            "a", 0, 1, withscores=True, score_cast_func=safe_str
+        )
+        assert_resp_response(
+            r,
+            response,
+            [(b"a3", "3"), (b"a2", "2")],
+            [[b"a3", "3.0"], [b"a2", "2.0"]],
+        )
+
     async def test_zrevrangebyscore(self, r: redis.Redis):
         await r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
         assert await r.zrevrangebyscore("a", 4, 2) == [b"a4", b"a3", b"a2"]
@@ -2240,7 +2270,7 @@ async def test_zrevrank_withscore(self, r: redis.Redis):
         assert await r.zrevrank("a", "a2") == 3
         assert await r.zrevrank("a", "a6") is None
         assert_resp_response(
-            r, await r.zrevrank("a", "a3", withscore=True), [2, b"3"], [2, 3.0]
+            r, await r.zrevrank("a", "a3", withscore=True), [2, 3.0], [2, 3.0]
         )
         assert await r.zrevrank("a", "a6", withscore=True) is None
 
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 2871dc45bf..c5974ea0fc 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -21,6 +21,7 @@
 from redis.commands.json.path import Path
 from redis.commands.search.field import TextField
 from redis.commands.search.query import Query
+from redis.utils import safe_str
 from tests.test_utils import redis_server_time
 
 from .conftest import (
@@ -3039,11 +3040,13 @@ def test_zrange(self, r):
             [[b"a2", 2.0], [b"a3", 3.0]],
         )
 
-        # # custom score function
-        # assert r.zrange("a", 0, 1, withscores=True, score_cast_func=int) == [
-        #     (b"a1", 1),
-        #     (b"a2", 2),
-        # ]
+        # custom score cast function
+        assert_resp_response(
+            r,
+            r.zrange("a", 0, 1, withscores=True, score_cast_func=safe_str),
+            [(b"a1", "1"), (b"a2", "2")],
+            [[b"a1", "1.0"], [b"a2", "2.0"]],
+        )
 
     def test_zrange_errors(self, r):
         with pytest.raises(exceptions.DataError):
@@ -3153,6 +3156,13 @@ def test_zrangebyscore(self, r):
             [(b"a2", 2), (b"a3", 3), (b"a4", 4)],
             [[b"a2", 2], [b"a3", 3], [b"a4", 4]],
         )
+        # custom score cast function
+        assert_resp_response(
+            r,
+            r.zrangebyscore("a", 2, 4, withscores=True, score_cast_func=safe_str),
+            [(b"a2", "2"), (b"a3", "3"), (b"a4", "4")],
+            [[b"a2", "2.0"], [b"a3", "3.0"], [b"a4", "4.0"]],
+        )
 
     def test_zrank(self, r):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
@@ -3166,9 +3176,17 @@ def test_zrank_withscore(self, r: redis.Redis):
         assert r.zrank("a", "a1") == 0
         assert r.zrank("a", "a2") == 1
         assert r.zrank("a", "a6") is None
-        assert_resp_response(r, r.zrank("a", "a3", withscore=True), [2, b"3"], [2, 3.0])
+        assert_resp_response(r, r.zrank("a", "a3", withscore=True), [2, 3.0], [2, 3.0])
         assert r.zrank("a", "a6", withscore=True) is None
 
+        # custom score cast function
+        assert_resp_response(
+            r,
+            r.zrank("a", "a3", withscore=True, score_cast_func=safe_str),
+            [2, "3"],
+            [2, "3.0"],
+        )
+
     def test_zrem(self, r):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
         assert r.zrem("a", "a2") == 1
@@ -3222,11 +3240,15 @@ def test_zrevrange(self, r):
             [[b"a2", 2.0], [b"a1", 1.0]],
         )
 
-        # # custom score function
-        # assert r.zrevrange("a", 0, 1, withscores=True, score_cast_func=int) == [
-        #     (b"a3", 3.0),
-        #     (b"a2", 2.0),
-        # ]
+        # custom score cast function
+        # should be applied to resp2 and resp3
+        # responses
+        assert_resp_response(
+            r,
+            r.zrevrange("a", 0, 1, withscores=True, score_cast_func=safe_str),
+            [(b"a3", "3"), (b"a2", "2")],
+            [[b"a3", "3.0"], [b"a2", "2.0"]],
+        )
 
     def test_zrevrangebyscore(self, r):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
@@ -3241,13 +3263,20 @@ def test_zrevrangebyscore(self, r):
             [(b"a4", 4.0), (b"a3", 3.0), (b"a2", 2.0)],
             [[b"a4", 4.0], [b"a3", 3.0], [b"a2", 2.0]],
         )
-        # custom score function
+        # custom score type cast function
         assert_resp_response(
             r,
             r.zrevrangebyscore("a", 4, 2, withscores=True, score_cast_func=int),
             [(b"a4", 4.0), (b"a3", 3.0), (b"a2", 2.0)],
             [[b"a4", 4.0], [b"a3", 3.0], [b"a2", 2.0]],
         )
+        # custom score cast function
+        assert_resp_response(
+            r,
+            r.zrevrangebyscore("a", 4, 2, withscores=True, score_cast_func=safe_str),
+            [(b"a4", "4"), (b"a3", "3"), (b"a2", "2")],
+            [[b"a4", "4.0"], [b"a3", "3.0"], [b"a2", "2.0"]],
+        )
 
     def test_zrevrank(self, r):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3, "a4": 4, "a5": 5})
@@ -3262,10 +3291,18 @@ def test_zrevrank_withscore(self, r):
         assert r.zrevrank("a", "a2") == 3
         assert r.zrevrank("a", "a6") is None
         assert_resp_response(
-            r, r.zrevrank("a", "a3", withscore=True), [2, b"3"], [2, 3.0]
+            r, r.zrevrank("a", "a3", withscore=True), [2, 3.0], [2, 3.0]
         )
         assert r.zrevrank("a", "a6", withscore=True) is None
 
+        # custom score cast function
+        assert_resp_response(
+            r,
+            r.zrevrank("a", "a3", withscore=True, score_cast_func=safe_str),
+            [2, "3"],
+            [2, "3.0"],
+        )
+
     def test_zscore(self, r):
         r.zadd("a", {"a1": 1, "a2": 2, "a3": 3})
         assert r.zscore("a", "a1") == 1.0
@@ -3307,6 +3344,13 @@ def test_zunion(self, r):
             [(b"a2", 5), (b"a4", 12), (b"a3", 20), (b"a1", 23)],
             [[b"a2", 5], [b"a4", 12], [b"a3", 20], [b"a1", 23]],
         )
+        # with custom score cast function
+        assert_resp_response(
+            r,
+            r.zunion(["a", "b", "c"], withscores=True, score_cast_func=safe_str),
+            [(b"a2", "3"), (b"a4", "4"), (b"a3", "8"), (b"a1", "9")],
+            [[b"a2", "3.0"], [b"a4", "4.0"], [b"a3", "8.0"], [b"a1", "9.0"]],
+        )
 
     @pytest.mark.onlynoncluster
     def test_zunionstore_sum(self, r):
diff --git a/tests/test_multiprocessing.py b/tests/test_multiprocessing.py
index 549eeb49a2..6a90d55cc6 100644
--- a/tests/test_multiprocessing.py
+++ b/tests/test_multiprocessing.py
@@ -1,5 +1,6 @@
 import contextlib
 import multiprocessing
+import platform
 
 import pytest
 import redis
@@ -17,6 +18,13 @@ def exit_callback(callback, *args):
         callback(*args)
 
 
+@pytest.mark.skipif(
+    platform.python_implementation() == "PyPy",
+    reason=(
+        "Pypy has issues with multiprocessing using fork as start method. "
+        "Causes processes to hang quite often"
+    ),
+)
 class TestMultiprocessing:
     # On macOS and newly non-macOS POSIX systems (since Python 3.14),
     # the default method has been changed to forkserver.
diff --git a/tests/test_pubsub.py b/tests/test_pubsub.py
index 3dc07caf51..db313e2437 100644
--- a/tests/test_pubsub.py
+++ b/tests/test_pubsub.py
@@ -942,8 +942,16 @@ def poll(ps, expected_res):
     def test_get_message_wait_for_subscription_not_being_called(self, r):
         p = r.pubsub()
         p.subscribe("foo")
-        with patch.object(threading.Event, "wait") as mock:
-            assert p.subscribed is True
+        assert p.subscribed is True
+
+        # Ensure p has the event attribute your wait_for_message would call:
+        ev = getattr(p, "subscribed_event", None)
+
+        assert ev is not None, (
+            "PubSub event attribute not found (check redis-py version)"
+        )
+
+        with patch.object(ev, "wait") as mock:
             assert wait_for_message(p) == make_message("subscribe", "foo", 1)
             assert mock.called is False
 

From 55c67135f837f761fdefa070133485dff091c08b Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 21 Oct 2025 16:43:35 +0300
Subject: [PATCH 1138/1164] Changing the timeout typehint in async
 BlockingConnectionPool from int to float (#3801)

---
 redis/asyncio/connection.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/asyncio/connection.py b/redis/asyncio/connection.py
index c79ed690d9..b819836af6 100644
--- a/redis/asyncio/connection.py
+++ b/redis/asyncio/connection.py
@@ -1356,7 +1356,7 @@ class BlockingConnectionPool(ConnectionPool):
     def __init__(
         self,
         max_connections: int = 50,
-        timeout: Optional[int] = 20,
+        timeout: Optional[float] = 20,
         connection_class: Type[AbstractConnection] = Connection,
         queue_class: Type[asyncio.Queue] = asyncio.LifoQueue,  # deprecated
         **connection_kwargs,

From f2d97b21069406efc00e25ed5a09a2c11d5e2754 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 21 Oct 2025 17:31:53 +0300
Subject: [PATCH 1139/1164] Fixing sync BlockingConnectionPool's disconnect
 method to follow the definition in ConnectionPoolInterface (#3802)

* Fixing sync BlockingConnectionPool's disconnect method to follow the definition of the interface

* Fixing linter errors
---
 redis/connection.py                        | 10 ++++--
 tests/test_asyncio/test_connection_pool.py | 33 ++++++++++++++++---
 tests/test_connection_pool.py              | 38 +++++++++++++++++++++-
 3 files changed, 72 insertions(+), 9 deletions(-)

diff --git a/redis/connection.py b/redis/connection.py
index 35e2bdf9ce..389529a1a7 100644
--- a/redis/connection.py
+++ b/redis/connection.py
@@ -2954,14 +2954,18 @@ def release(self, connection):
                     pass
                 self._locked = False
 
-    def disconnect(self):
-        "Disconnects all connections in the pool."
+    def disconnect(self, inuse_connections: bool = True):
+        "Disconnects either all connections in the pool or just the free connections."
         self._checkpid()
         try:
             if self._in_maintenance:
                 self._lock.acquire()
                 self._locked = True
-            for connection in self._connections:
+            if inuse_connections:
+                connections = self._connections
+            else:
+                connections = self._get_free_connections()
+            for connection in connections:
                 connection.disconnect()
         finally:
             if self._locked:
diff --git a/tests/test_asyncio/test_connection_pool.py b/tests/test_asyncio/test_connection_pool.py
index cb3dac9604..e658c14188 100644
--- a/tests/test_asyncio/test_connection_pool.py
+++ b/tests/test_asyncio/test_connection_pool.py
@@ -95,15 +95,20 @@ class DummyConnection(Connection):
 
     def __init__(self, **kwargs):
         self.kwargs = kwargs
+        self._connected = False
 
     def repr_pieces(self):
         return [("id", id(self)), ("kwargs", self.kwargs)]
 
     async def connect(self):
-        pass
+        self._connected = True
 
     async def disconnect(self):
-        pass
+        self._connected = False
+
+    @property
+    def is_connected(self):
+        return self._connected
 
     async def can_read_destructive(self, timeout: float = 0):
         return False
@@ -203,6 +208,20 @@ async def test_repr_contains_db_info_unix(self):
             expected = "path=/abc,db=1,client_name=test-client"
             assert expected in repr(pool)
 
+    async def test_pool_disconnect(self, master_host):
+        connection_kwargs = {
+            "host": master_host[0],
+            "port": master_host[1],
+        }
+        async with self.get_pool(connection_kwargs=connection_kwargs) as pool:
+            conn = await pool.get_connection()
+            await pool.disconnect(inuse_connections=True)
+            assert not conn.is_connected
+
+            await conn.connect()
+            await pool.disconnect(inuse_connections=False)
+            assert conn.is_connected
+
 
 class TestBlockingConnectionPool:
     @asynccontextmanager
@@ -231,8 +250,7 @@ async def test_connection_creation(self, master_host):
             assert isinstance(connection, DummyConnection)
             assert connection.kwargs == connection_kwargs
 
-    async def test_disconnect(self, master_host):
-        """A regression test for #1047"""
+    async def test_pool_disconnect(self, master_host):
         connection_kwargs = {
             "foo": "bar",
             "biz": "baz",
@@ -240,8 +258,13 @@ async def test_disconnect(self, master_host):
             "port": master_host[1],
         }
         async with self.get_pool(connection_kwargs=connection_kwargs) as pool:
-            await pool.get_connection()
+            conn = await pool.get_connection()
             await pool.disconnect()
+            assert not conn.is_connected
+
+            await conn.connect()
+            await pool.disconnect(inuse_connections=False)
+            assert conn.is_connected
 
     async def test_multiple_connections(self, master_host):
         connection_kwargs = {"host": master_host[0], "port": master_host[1]}
diff --git a/tests/test_connection_pool.py b/tests/test_connection_pool.py
index 2397f15600..7365c6ff13 100644
--- a/tests/test_connection_pool.py
+++ b/tests/test_connection_pool.py
@@ -29,9 +29,13 @@ class DummyConnection:
     def __init__(self, **kwargs):
         self.kwargs = kwargs
         self.pid = os.getpid()
+        self._sock = None
 
     def connect(self):
-        pass
+        self._sock = mock.Mock()
+
+    def disconnect(self):
+        self._sock = None
 
     def can_read(self):
         return False
@@ -140,6 +144,21 @@ def test_repr_contains_db_info_unix(self):
         expected = "path=/abc,db=1,client_name=test-client"
         assert expected in repr(pool)
 
+    def test_pool_disconnect(self, master_host):
+        connection_kwargs = {
+            "host": master_host[0],
+            "port": master_host[1],
+        }
+        pool = self.get_pool(connection_kwargs=connection_kwargs)
+
+        conn = pool.get_connection()
+        pool.disconnect()
+        assert not conn._sock
+
+        conn.connect()
+        pool.disconnect(inuse_connections=False)
+        assert conn._sock
+
 
 class TestBlockingConnectionPool:
     def get_pool(self, connection_kwargs=None, max_connections=10, timeout=20):
@@ -244,6 +263,23 @@ def test_initialise_pool_with_cache(self, master_host):
         )
         assert isinstance(pool.get_connection(), CacheProxyConnection)
 
+    def test_pool_disconnect(self, master_host):
+        connection_kwargs = {
+            "foo": "bar",
+            "biz": "baz",
+            "host": master_host[0],
+            "port": master_host[1],
+        }
+        pool = self.get_pool(connection_kwargs=connection_kwargs)
+
+        conn = pool.get_connection()
+        pool.disconnect()
+        assert not conn._sock
+
+        conn.connect()
+        pool.disconnect(inuse_connections=False)
+        assert conn._sock
+
 
 class TestConnectionPoolURLParsing:
     def test_hostname(self):

From 68483c138ce8e2ceba2bd123ee3d7490c8af4acf Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 21 Oct 2025 19:45:03 +0300
Subject: [PATCH 1140/1164] Adding new ExternalAuthProviderError that will be
 raised when we receive 'problem with LDAP service' response from server.
 (#3808)

---
 redis/_parsers/base.py            |   6 ++
 redis/exceptions.py               |   8 ++
 tests/conftest.py                 |   9 ++
 tests/test_parsers/test_errors.py | 167 ++++++++++++++++++++++++++++++
 4 files changed, 190 insertions(+)
 create mode 100644 tests/test_parsers/test_errors.py

diff --git a/redis/_parsers/base.py b/redis/_parsers/base.py
index 4c83495a61..63bf5d7795 100644
--- a/redis/_parsers/base.py
+++ b/redis/_parsers/base.py
@@ -27,6 +27,7 @@
     ClusterDownError,
     ConnectionError,
     ExecAbortError,
+    ExternalAuthProviderError,
     MasterDownError,
     ModuleError,
     MovedError,
@@ -60,6 +61,10 @@
     "Client sent AUTH, but no password is set": AuthenticationError,
 }
 
+EXTERNAL_AUTH_PROVIDER_ERROR = {
+    "problem with LDAP service": ExternalAuthProviderError,
+}
+
 logger = logging.getLogger(__name__)
 
 
@@ -81,6 +86,7 @@ class BaseParser(ABC):
             NO_SUCH_MODULE_ERROR: ModuleError,
             MODULE_UNLOAD_NOT_POSSIBLE_ERROR: ModuleError,
             **NO_AUTH_SET_ERROR,
+            **EXTERNAL_AUTH_PROVIDER_ERROR,
         },
         "OOM": OutOfMemoryError,
         "WRONGPASS": AuthenticationError,
diff --git a/redis/exceptions.py b/redis/exceptions.py
index 643444986b..1e21265524 100644
--- a/redis/exceptions.py
+++ b/redis/exceptions.py
@@ -245,3 +245,11 @@ class InvalidPipelineStack(RedisClusterException):
     """
 
     pass
+
+
+class ExternalAuthProviderError(ConnectionError):
+    """
+    Raised when an external authentication provider returns an error.
+    """
+
+    pass
diff --git a/tests/conftest.py b/tests/conftest.py
index af2681732b..9d2f51795a 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -334,6 +334,15 @@ def skip_if_resp_version(resp_version) -> _TestDecorator:
     return pytest.mark.skipif(check, reason=f"RESP version required != {resp_version}")
 
 
+def skip_if_hiredis_parser() -> _TestDecorator:
+    try:
+        import hiredis  # noqa
+
+        return pytest.mark.skipif(True, reason="hiredis dependency found")
+    except ImportError:
+        return pytest.mark.skipif(False, reason="No hiredis dependency")
+
+
 def _get_client(
     cls, request, single_connection_client=True, flushdb=True, from_url=None, **kwargs
 ):
diff --git a/tests/test_parsers/test_errors.py b/tests/test_parsers/test_errors.py
new file mode 100644
index 0000000000..8081e6481b
--- /dev/null
+++ b/tests/test_parsers/test_errors.py
@@ -0,0 +1,167 @@
+import socket
+from unittest.mock import patch
+
+import pytest
+from redis.client import Redis
+from redis.exceptions import ExternalAuthProviderError
+from tests.conftest import skip_if_hiredis_parser
+
+
+class MockSocket:
+    """Mock socket that simulates Redis protocol responses."""
+
+    def __init__(self):
+        self.sent_data = []
+        self.closed = False
+        self.pending_responses = []
+
+    def connect(self, address):
+        pass
+
+    def send(self, data):
+        """Simulate sending data to Redis."""
+        if self.closed:
+            raise ConnectionError("Socket is closed")
+        self.sent_data.append(data)
+
+        # Analyze the command and prepare appropriate response
+        if b"HELLO" in data:
+            response = b"%7\r\n$6\r\nserver\r\n$5\r\nredis\r\n$7\r\nversion\r\n$5\r\n7.4.0\r\n$5\r\nproto\r\n:3\r\n$2\r\nid\r\n:1\r\n$4\r\nmode\r\n$10\r\nstandalone\r\n$4\r\nrole\r\n$6\r\nmaster\r\n$7\r\nmodules\r\n*0\r\n"
+            self.pending_responses.append(response)
+        elif b"SET" in data:
+            response = b"+OK\r\n"
+            self.pending_responses.append(response)
+        elif b"GET" in data:
+            # Extract key and provide appropriate response
+            if b"hello" in data:
+                response = b"$5\r\nworld\r\n"
+                self.pending_responses.append(response)
+            # Handle specific keys used in tests
+            elif b"ldap_error" in data:
+                self.pending_responses.append(b"-ERR problem with LDAP service\r\n")
+            else:
+                self.pending_responses.append(b"$-1\r\n")  # NULL response
+        else:
+            self.pending_responses.append(b"+OK\r\n")  # Default response
+
+        return len(data)
+
+    def sendall(self, data):
+        """Simulate sending all data to Redis."""
+        return self.send(data)
+
+    def recv(self, bufsize):
+        """Simulate receiving data from Redis."""
+        if self.closed:
+            raise ConnectionError("Socket is closed")
+
+        # Use pending responses that were prepared when commands were sent
+        if self.pending_responses:
+            response = self.pending_responses.pop(0)
+            return response[:bufsize]  # Respect buffer size
+        else:
+            # No data available - this should block or raise an exception
+            # For can_read checks, we should indicate no data is available
+            import errno
+
+            raise BlockingIOError(errno.EAGAIN, "Resource temporarily unavailable")
+
+    def recv_into(self, buffer, nbytes=0):
+        """
+        Receive data from Redis and write it into the provided buffer.
+        Returns the number of bytes written.
+
+        This method is used by the hiredis parser for efficient data reading.
+        """
+        if self.closed:
+            raise ConnectionError("Socket is closed")
+
+        # Use pending responses that were prepared when commands were sent
+        if self.pending_responses:
+            response = self.pending_responses.pop(0)
+
+            # Determine how many bytes to write
+            if nbytes == 0:
+                nbytes = len(buffer)
+
+            # Write data into the buffer (up to nbytes or response length)
+            bytes_to_write = min(len(response), nbytes, len(buffer))
+            buffer[:bytes_to_write] = response[:bytes_to_write]
+
+            return bytes_to_write
+        else:
+            # No data available - this should block or raise an exception
+            # For can_read checks, we should indicate no data is available
+            import errno
+
+            raise BlockingIOError(errno.EAGAIN, "Resource temporarily unavailable")
+
+    def fileno(self):
+        """Return a fake file descriptor for select/poll operations."""
+        return 1  # Fake file descriptor
+
+    def close(self):
+        """Simulate closing the socket."""
+        self.closed = True
+        self.address = None
+        self.timeout = None
+
+    def settimeout(self, timeout):
+        pass
+
+    def setsockopt(self, level, optname, value):
+        pass
+
+    def setblocking(self, blocking):
+        pass
+
+    def shutdown(self, how):
+        pass
+
+
+class TestErrorParsing:
+    def setup_method(self):
+        """Set up test fixtures with mocked sockets."""
+        self.mock_sockets = []
+        self.original_socket = socket.socket
+
+        # Mock socket creation to return our mock sockets
+        def mock_socket_factory(*args, **kwargs):
+            mock_sock = MockSocket()
+            self.mock_sockets.append(mock_sock)
+            return mock_sock
+
+        self.socket_patcher = patch("socket.socket", side_effect=mock_socket_factory)
+        self.socket_patcher.start()
+
+        # Mock select.select to simulate data availability for reading
+        def mock_select(rlist, wlist, xlist, timeout=0):
+            # Check if any of the sockets in rlist have data available
+            ready_sockets = []
+            for sock in rlist:
+                if hasattr(sock, "connected") and sock.connected and not sock.closed:
+                    # Only return socket as ready if it actually has data to read
+                    if hasattr(sock, "pending_responses") and sock.pending_responses:
+                        ready_sockets.append(sock)
+                    # Don't return socket as ready just because it received commands
+                    # Only when there are actual responses available
+            return (ready_sockets, [], [])
+
+        self.select_patcher = patch("select.select", side_effect=mock_select)
+        self.select_patcher.start()
+
+    def teardown_method(self):
+        """Clean up test fixtures."""
+        self.socket_patcher.stop()
+        self.select_patcher.stop()
+
+    @skip_if_hiredis_parser()
+    @pytest.mark.parametrize("protocol_version", [2, 3])
+    def test_external_auth_provider_error(self, protocol_version):
+        client = Redis(
+            protocol=protocol_version,
+        )
+        client.set("hello", "world")
+
+        with pytest.raises(ExternalAuthProviderError):
+            client.get("ldap_error")

From 7339c87e4de82d7000306eeb76a4d4d8ae8a4c1d Mon Sep 17 00:00:00 2001
From: Petar Kostov <petar.kostov@redis.com>
Date: Wed, 22 Oct 2025 06:42:26 +0300
Subject: [PATCH 1141/1164] Add handling of empty spaces during CLIENT LIST
 response parsing (#3797)

---
 redis/_parsers/helpers.py          | 18 ++++++++++++++++--
 tests/test_parsers/test_helpers.py | 22 +++++++++++++++++++++-
 2 files changed, 37 insertions(+), 3 deletions(-)

diff --git a/redis/_parsers/helpers.py b/redis/_parsers/helpers.py
index 5dfa8ee707..80531bb249 100644
--- a/redis/_parsers/helpers.py
+++ b/redis/_parsers/helpers.py
@@ -382,8 +382,22 @@ def parse_zadd(response, **options):
 def parse_client_list(response, **options):
     clients = []
     for c in str_if_bytes(response).splitlines():
-        # Values might contain '='
-        clients.append(dict(pair.split("=", 1) for pair in c.split(" ")))
+        client_dict = {}
+        tokens = c.split(" ")
+        last_key = None
+        for token in tokens:
+            if "=" in token:
+                # Values might contain '='
+                key, value = token.split("=", 1)
+                client_dict[key] = value
+                last_key = key
+            else:
+                # Values may include spaces. For instance, when running Redis via a Unix socket — such as
+                # "/tmp/redis sock/redis.sock" — the addr or laddr field will include a space.
+                client_dict[last_key] += " " + token
+
+        if client_dict:
+            clients.append(client_dict)
     return clients
 
 
diff --git a/tests/test_parsers/test_helpers.py b/tests/test_parsers/test_helpers.py
index 383b9de794..0ab5a49083 100644
--- a/tests/test_parsers/test_helpers.py
+++ b/tests/test_parsers/test_helpers.py
@@ -1,4 +1,4 @@
-from redis._parsers.helpers import parse_info
+from redis._parsers.helpers import parse_info, parse_client_list
 
 
 def test_parse_info():
@@ -61,3 +61,23 @@ def test_parse_info_list_dict_mixed():
 
     assert isinstance(info["list_two"], dict)
     assert info["list_two"] == {"a b": "foo", "c": True, "d": "bar", "e": True}
+
+
+def test_parse_client_list():
+    response = "id=7 addr=/tmp/redis sock/redis.sock:0 fd=9 name=test=_complex_[name] age=-1 idle=0 cmd=client|list user=default lib-name=go-redis(,go1.24.4) lib-ver="
+    expected = [
+        {
+            "id": "7",
+            "addr": "/tmp/redis sock/redis.sock:0",
+            "fd": "9",
+            "name": "test=_complex_[name]",
+            "age": "-1",
+            "idle": "0",
+            "cmd": "client|list",
+            "user": "default",
+            "lib-name": "go-redis(,go1.24.4)",
+            "lib-ver": "",
+        }
+    ]
+    clients = parse_client_list(response)
+    assert clients == expected

From 29b4d5d3489c22c6358d98852ade352804459ae2 Mon Sep 17 00:00:00 2001
From: andy-stark-redis <164213578+andy-stark-redis@users.noreply.github.com>
Date: Wed, 22 Oct 2025 08:17:22 +0100
Subject: [PATCH 1142/1164] DOC-5821 update index/query example for runnable
 notebook (#3807)

---
 doctests/home_json.py | 45 ++++++++++++++++++++++---------------------
 1 file changed, 23 insertions(+), 22 deletions(-)

diff --git a/doctests/home_json.py b/doctests/home_json.py
index 794f844034..2bd6d4ea70 100644
--- a/doctests/home_json.py
+++ b/doctests/home_json.py
@@ -1,4 +1,5 @@
 # EXAMPLE: py_home_json
+# BINDER_ID python-py_home_json
 """
 JSON examples from redis-py "home" page"
  https://redis.io/docs/latest/develop/connect/clients/python/redis-py/#example-indexing-and-querying-json-documents
@@ -15,23 +16,6 @@
 import redis.exceptions
 # STEP_END
 
-# STEP_START connect
-r = redis.Redis(decode_responses=True)
-# STEP_END
-
-# REMOVE_START
-try:
-    r.ft("idx:users").dropindex(True)
-except redis.exceptions.ResponseError:
-    pass
-
-try:
-    r.ft("hash-idx:users").dropindex(True)
-except redis.exceptions.ResponseError:
-    pass
-
-r.delete("user:1", "user:2", "user:3", "huser:1", "huser:2", "huser:3")
-# REMOVE_END
 # STEP_START create_data
 user1 = {
     "name": "Paul John",
@@ -55,6 +39,19 @@
 }
 # STEP_END
 
+# STEP_START connect
+r = redis.Redis(decode_responses=True)
+# STEP_END
+
+# STEP_START cleanup_json
+try:
+    r.ft("idx:users").dropindex(True)
+except redis.exceptions.ResponseError:
+    pass
+
+r.delete("user:1", "user:2", "user:3")
+# STEP_END
+
 # STEP_START make_index
 schema = (
     TextField("$.name", as_name="name"),
@@ -69,7 +66,6 @@
     )
 )
 # STEP_END
-# Tests for 'make_index' step.
 # REMOVE_START
 assert indexCreated
 # REMOVE_END
@@ -79,7 +75,6 @@
 user2Set = r.json().set("user:2", Path.root_path(), user2)
 user3Set = r.json().set("user:3", Path.root_path(), user3)
 # STEP_END
-# Tests for 'add_data' step.
 # REMOVE_START
 assert user1Set
 assert user2Set
@@ -94,7 +89,6 @@
 print(findPaulResult)
 # >>> Result{1 total, docs: [Document {'id': 'user:3', ...
 # STEP_END
-# Tests for 'query1' step.
 # REMOVE_START
 assert str(findPaulResult) == (
     "Result{1 total, docs: [Document {'id': 'user:3', 'payload': None, "
@@ -111,7 +105,6 @@
 print(citiesResult)
 # >>> [Document {'id': 'user:1', 'payload': None, ...
 # STEP_END
-# Tests for 'query2' step.
 # REMOVE_START
 citiesResult.sort(key=lambda doc: doc['id'])
 
@@ -130,7 +123,6 @@
 print(aggResult)
 # >>> [['city', 'London', 'count', '1'], ['city', 'Tel Aviv', 'count', '2']]
 # STEP_END
-# Tests for 'query3' step.
 # REMOVE_START
 aggResult.sort(key=lambda row: row[1])
 
@@ -139,6 +131,15 @@
 )
 # REMOVE_END
 
+# STEP_START cleanup_hash
+try:
+    r.ft("hash-idx:users").dropindex(True)
+except redis.exceptions.ResponseError:
+    pass
+
+r.delete("huser:1", "huser:2", "huser:3")
+# STEP_END
+
 # STEP_START make_hash_index
 hashSchema = (
     TextField("name"),

From 20bdf4db9bc99dcf37af54e5a663c91deb177724 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Wed, 22 Oct 2025 13:01:38 +0300
Subject: [PATCH 1143/1164] Fixing SORTABLE, INDEXEMPTY and INDEXMISSING order
 when using RediSearch fields (#3810)

---
 redis/commands/search/field.py    |  4 ++--
 tests/test_asyncio/test_search.py | 17 +++++++++++++++++
 tests/test_search.py              | 15 +++++++++++++++
 3 files changed, 34 insertions(+), 2 deletions(-)

diff --git a/redis/commands/search/field.py b/redis/commands/search/field.py
index 45cd403e49..b66b1bc3a0 100644
--- a/redis/commands/search/field.py
+++ b/redis/commands/search/field.py
@@ -52,14 +52,14 @@ def __init__(
         self.args_suffix = list()
         self.as_name = as_name
 
-        if sortable:
-            self.args_suffix.append(Field.SORTABLE)
         if no_index:
             self.args_suffix.append(Field.NOINDEX)
         if index_missing:
             self.args_suffix.append(Field.INDEX_MISSING)
         if index_empty:
             self.args_suffix.append(Field.INDEX_EMPTY)
+        if sortable:
+            self.args_suffix.append(Field.SORTABLE)
 
         if no_index and not sortable:
             raise ValueError("Non-Sortable non-Indexable fields are ignored")
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 0004f9ba75..7f11710cc4 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -671,6 +671,23 @@ async def test_no_index(decoded_r: redis.Redis):
         TagField("name", no_index=True, sortable=False)
 
 
+@pytest.mark.redismod
+@skip_if_server_version_lt("7.4.0")
+@skip_ifmodversion_lt("2.10.0", "search")
+async def test_create_index_empty_or_missing_fields_with_sortable(
+    decoded_r: redis.Redis,
+):
+    definition = IndexDefinition(prefix=["property:"], index_type=IndexType.HASH)
+
+    fields = [
+        TextField("title", sortable=True, index_empty=True),
+        TagField("features", index_missing=True, sortable=True),
+        TextField("description", no_index=True, sortable=True),
+    ]
+
+    await decoded_r.ft().create_index(fields, definition=definition)
+
+
 @pytest.mark.redismod
 async def test_explain(decoded_r: redis.Redis):
     await decoded_r.ft().create_index(
diff --git a/tests/test_search.py b/tests/test_search.py
index c28b4aa932..b76baf10aa 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -2710,6 +2710,21 @@ def test_search_missing_fields(client):
     _assert_search_result(client, res, ["property:1", "property:2"])
 
 
+@pytest.mark.redismod
+@skip_if_server_version_lt("7.4.0")
+@skip_ifmodversion_lt("2.10.0", "search")
+def test_create_index_empty_or_missing_fields_with_sortable(client):
+    definition = IndexDefinition(prefix=["property:"], index_type=IndexType.HASH)
+
+    fields = [
+        TextField("title", sortable=True, index_empty=True),
+        TagField("features", index_missing=True, sortable=True),
+        TextField("description", no_index=True, sortable=True),
+    ]
+
+    client.ft().create_index(fields, definition=definition)
+
+
 @pytest.mark.redismod
 @skip_if_server_version_lt("7.4.0")
 @skip_ifmodversion_lt("2.10.0", "search")

From 0debe43c0c3638f16e0916e74ca9889282937021 Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Wed, 22 Oct 2025 17:43:39 +0300
Subject: [PATCH 1144/1164] Refactor healthcheck to use PING instead of ECHO
 (#3811)

---
 redis/asyncio/multidb/client.py               |  2 ++
 redis/asyncio/multidb/config.py               |  4 ++--
 redis/asyncio/multidb/healthcheck.py          | 15 ++++----------
 redis/multidb/client.py                       |  2 ++
 redis/multidb/config.py                       |  4 ++--
 redis/multidb/healthcheck.py                  | 15 ++++----------
 redis/utils.py                                | 20 +++++++++++++++++++
 .../test_asyncio/test_multidb/test_config.py  |  4 ++--
 .../test_multidb/test_healthcheck.py          | 16 +++++++--------
 tests/test_multidb/test_config.py             |  4 ++--
 tests/test_multidb/test_healthcheck.py        | 16 +++++++--------
 11 files changed, 56 insertions(+), 46 deletions(-)

diff --git a/redis/asyncio/multidb/client.py b/redis/asyncio/multidb/client.py
index 6bea588196..d3e3f241d2 100644
--- a/redis/asyncio/multidb/client.py
+++ b/redis/asyncio/multidb/client.py
@@ -14,10 +14,12 @@
 from redis.multidb.circuit import State as CBState
 from redis.multidb.exception import NoValidDatabaseException, UnhealthyDatabaseException
 from redis.typing import ChannelT, EncodableT, KeyT
+from redis.utils import experimental
 
 logger = logging.getLogger(__name__)
 
 
+@experimental
 class MultiDBClient(AsyncRedisModuleCommands, AsyncCoreCommands):
     """
     Client that operates on multiple logical Redis databases.
diff --git a/redis/asyncio/multidb/config.py b/redis/asyncio/multidb/config.py
index 71f69ad133..cd0675baeb 100644
--- a/redis/asyncio/multidb/config.py
+++ b/redis/asyncio/multidb/config.py
@@ -20,9 +20,9 @@
     DEFAULT_HEALTH_CHECK_INTERVAL,
     DEFAULT_HEALTH_CHECK_POLICY,
     DEFAULT_HEALTH_CHECK_PROBES,
-    EchoHealthCheck,
     HealthCheck,
     HealthCheckPolicies,
+    PingHealthCheck,
 )
 from redis.asyncio.retry import Retry
 from redis.backoff import ExponentialWithJitterBackoff, NoBackoff
@@ -203,7 +203,7 @@ def default_failure_detectors(self) -> List[AsyncFailureDetector]:
 
     def default_health_checks(self) -> List[HealthCheck]:
         return [
-            EchoHealthCheck(),
+            PingHealthCheck(),
         ]
 
     def default_failover_strategy(self) -> AsyncFailoverStrategy:
diff --git a/redis/asyncio/multidb/healthcheck.py b/redis/asyncio/multidb/healthcheck.py
index dcb787f6ed..d2269f707d 100644
--- a/redis/asyncio/multidb/healthcheck.py
+++ b/redis/asyncio/multidb/healthcheck.py
@@ -170,26 +170,19 @@ class HealthCheckPolicies(Enum):
 DEFAULT_HEALTH_CHECK_POLICY: HealthCheckPolicies = HealthCheckPolicies.HEALTHY_ALL
 
 
-class EchoHealthCheck(HealthCheck):
+class PingHealthCheck(HealthCheck):
     """
-    Health check based on ECHO command.
+    Health check based on PING command.
     """
 
     async def check_health(self, database) -> bool:
-        expected_message = ["healthcheck", b"healthcheck"]
-
         if isinstance(database.client, Redis):
-            actual_message = await database.client.execute_command(
-                "ECHO", "healthcheck"
-            )
-            return actual_message in expected_message
+            return await database.client.execute_command("PING")
         else:
             # For a cluster checks if all nodes are healthy.
             all_nodes = database.client.get_nodes()
             for node in all_nodes:
-                actual_message = await node.execute_command("ECHO", "healthcheck")
-
-                if actual_message not in expected_message:
+                if not await node.redis_connection.execute_command("PING"):
                     return False
 
             return True
diff --git a/redis/multidb/client.py b/redis/multidb/client.py
index 02c3516eee..c46a53af32 100644
--- a/redis/multidb/client.py
+++ b/redis/multidb/client.py
@@ -15,10 +15,12 @@
 from redis.multidb.exception import NoValidDatabaseException, UnhealthyDatabaseException
 from redis.multidb.failure_detector import FailureDetector
 from redis.multidb.healthcheck import HealthCheck, HealthCheckPolicy
+from redis.utils import experimental
 
 logger = logging.getLogger(__name__)
 
 
+@experimental
 class MultiDBClient(RedisModuleCommands, CoreCommands):
     """
     Client that operates on multiple logical Redis databases.
diff --git a/redis/multidb/config.py b/redis/multidb/config.py
index 8ce960c2dc..b3187c79fb 100644
--- a/redis/multidb/config.py
+++ b/redis/multidb/config.py
@@ -32,9 +32,9 @@
     DEFAULT_HEALTH_CHECK_INTERVAL,
     DEFAULT_HEALTH_CHECK_POLICY,
     DEFAULT_HEALTH_CHECK_PROBES,
-    EchoHealthCheck,
     HealthCheck,
     HealthCheckPolicies,
+    PingHealthCheck,
 )
 from redis.retry import Retry
 
@@ -200,7 +200,7 @@ def default_failure_detectors(self) -> List[FailureDetector]:
 
     def default_health_checks(self) -> List[HealthCheck]:
         return [
-            EchoHealthCheck(),
+            PingHealthCheck(),
         ]
 
     def default_failover_strategy(self) -> FailoverStrategy:
diff --git a/redis/multidb/healthcheck.py b/redis/multidb/healthcheck.py
index 5deda82f24..43440d5518 100644
--- a/redis/multidb/healthcheck.py
+++ b/redis/multidb/healthcheck.py
@@ -169,26 +169,19 @@ class HealthCheckPolicies(Enum):
 DEFAULT_HEALTH_CHECK_POLICY: HealthCheckPolicies = HealthCheckPolicies.HEALTHY_ALL
 
 
-class EchoHealthCheck(HealthCheck):
+class PingHealthCheck(HealthCheck):
     """
-    Health check based on ECHO command.
+    Health check based on PING command.
     """
 
     def check_health(self, database) -> bool:
-        expected_message = ["healthcheck", b"healthcheck"]
-
         if isinstance(database.client, Redis):
-            actual_message = database.client.execute_command("ECHO", "healthcheck")
-            return actual_message in expected_message
+            return database.client.execute_command("PING")
         else:
             # For a cluster checks if all nodes are healthy.
             all_nodes = database.client.get_nodes()
             for node in all_nodes:
-                actual_message = node.redis_connection.execute_command(
-                    "ECHO", "healthcheck"
-                )
-
-                if actual_message not in expected_message:
+                if not node.redis_connection.execute_command("PING"):
                     return False
 
             return True
diff --git a/redis/utils.py b/redis/utils.py
index 5ae8fb25fc..66c1480a9b 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -1,6 +1,7 @@
 import datetime
 import logging
 import textwrap
+import warnings
 from collections.abc import Callable
 from contextlib import contextmanager
 from functools import wraps
@@ -326,3 +327,22 @@ async def dummy_fail_async():
     Async fake function for a Retry object if you don't need to handle each failure.
     """
     pass
+
+
+def experimental(cls):
+    """
+    Decorator to mark a class as experimental.
+    """
+    original_init = cls.__init__
+
+    @wraps(original_init)
+    def new_init(self, *args, **kwargs):
+        warnings.warn(
+            f"{cls.__name__} is an experimental and may change or be removed in future versions.",
+            category=UserWarning,
+            stacklevel=2,
+        )
+        original_init(self, *args, **kwargs)
+
+    cls.__init__ = new_init
+    return cls
diff --git a/tests/test_asyncio/test_multidb/test_config.py b/tests/test_asyncio/test_multidb/test_config.py
index d05c7a8a12..5ffeb97e06 100644
--- a/tests/test_asyncio/test_multidb/test_config.py
+++ b/tests/test_asyncio/test_multidb/test_config.py
@@ -19,7 +19,7 @@
     FailureDetectorAsyncWrapper,
     AsyncFailureDetector,
 )
-from redis.asyncio.multidb.healthcheck import EchoHealthCheck, HealthCheck
+from redis.asyncio.multidb.healthcheck import PingHealthCheck, HealthCheck
 from redis.asyncio.retry import Retry
 from redis.multidb.circuit import CircuitBreaker
 
@@ -58,7 +58,7 @@ def test_default_config(self):
             config.default_failure_detectors()[0], FailureDetectorAsyncWrapper
         )
         assert len(config.default_health_checks()) == 1
-        assert isinstance(config.default_health_checks()[0], EchoHealthCheck)
+        assert isinstance(config.default_health_checks()[0], PingHealthCheck)
         assert config.health_check_interval == DEFAULT_HEALTH_CHECK_INTERVAL
         assert isinstance(
             config.default_failover_strategy(), WeightBasedFailoverStrategy
diff --git a/tests/test_asyncio/test_multidb/test_healthcheck.py b/tests/test_asyncio/test_multidb/test_healthcheck.py
index 3e7ac42cd9..5a08f21a68 100644
--- a/tests/test_asyncio/test_multidb/test_healthcheck.py
+++ b/tests/test_asyncio/test_multidb/test_healthcheck.py
@@ -3,7 +3,7 @@
 
 from redis.asyncio.multidb.database import Database
 from redis.asyncio.multidb.healthcheck import (
-    EchoHealthCheck,
+    PingHealthCheck,
     LagAwareHealthCheck,
     HealthCheck,
     HealthyAllPolicy,
@@ -208,15 +208,15 @@ async def test_policy_raise_unhealthy_database_exception_if_exception_occurs_on_
 
 
 @pytest.mark.onlynoncluster
-class TestEchoHealthCheck:
+class TestPingHealthCheck:
     @pytest.mark.asyncio
     async def test_database_is_healthy_on_echo_response(self, mock_client, mock_cb):
         """
         Mocking responses to mix error and actual responses to ensure that health check retry
         according to given configuration.
         """
-        mock_client.execute_command = AsyncMock(side_effect=["healthcheck"])
-        hc = EchoHealthCheck()
+        mock_client.execute_command = AsyncMock(side_effect=["PONG"])
+        hc = PingHealthCheck()
         db = Database(mock_client, mock_cb, 0.9)
 
         assert await hc.check_health(db)
@@ -230,8 +230,8 @@ async def test_database_is_unhealthy_on_incorrect_echo_response(
         Mocking responses to mix error and actual responses to ensure that health check retry
         according to given configuration.
         """
-        mock_client.execute_command = AsyncMock(side_effect=["wrong"])
-        hc = EchoHealthCheck()
+        mock_client.execute_command = AsyncMock(side_effect=[False])
+        hc = PingHealthCheck()
         db = Database(mock_client, mock_cb, 0.9)
 
         assert not await hc.check_health(db)
@@ -241,9 +241,9 @@ async def test_database_is_unhealthy_on_incorrect_echo_response(
     async def test_database_close_circuit_on_successful_healthcheck(
         self, mock_client, mock_cb
     ):
-        mock_client.execute_command = AsyncMock(side_effect=["healthcheck"])
+        mock_client.execute_command = AsyncMock(side_effect=["PONG"])
         mock_cb.state = CBState.HALF_OPEN
-        hc = EchoHealthCheck()
+        hc = PingHealthCheck()
         db = Database(mock_client, mock_cb, 0.9)
 
         assert await hc.check_health(db)
diff --git a/tests/test_multidb/test_config.py b/tests/test_multidb/test_config.py
index 351f789971..0683e9e9f6 100644
--- a/tests/test_multidb/test_config.py
+++ b/tests/test_multidb/test_config.py
@@ -16,7 +16,7 @@
 )
 from redis.multidb.database import Database
 from redis.multidb.failure_detector import CommandFailureDetector, FailureDetector
-from redis.multidb.healthcheck import EchoHealthCheck, HealthCheck
+from redis.multidb.healthcheck import PingHealthCheck, HealthCheck
 from redis.multidb.failover import WeightBasedFailoverStrategy, FailoverStrategy
 from redis.retry import Retry
 
@@ -53,7 +53,7 @@ def test_default_config(self):
         assert len(config.default_failure_detectors()) == 1
         assert isinstance(config.default_failure_detectors()[0], CommandFailureDetector)
         assert len(config.default_health_checks()) == 1
-        assert isinstance(config.default_health_checks()[0], EchoHealthCheck)
+        assert isinstance(config.default_health_checks()[0], PingHealthCheck)
         assert config.health_check_interval == DEFAULT_HEALTH_CHECK_INTERVAL
         assert isinstance(
             config.default_failover_strategy(), WeightBasedFailoverStrategy
diff --git a/tests/test_multidb/test_healthcheck.py b/tests/test_multidb/test_healthcheck.py
index fb1f1e4148..b70da06091 100644
--- a/tests/test_multidb/test_healthcheck.py
+++ b/tests/test_multidb/test_healthcheck.py
@@ -5,7 +5,7 @@
 from redis.multidb.database import Database
 from redis.http.http_client import HttpError
 from redis.multidb.healthcheck import (
-    EchoHealthCheck,
+    PingHealthCheck,
     LagAwareHealthCheck,
     HealthCheck,
     HealthyAllPolicy,
@@ -201,14 +201,14 @@ def test_policy_raise_unhealthy_database_exception_if_exception_occurs_on_failed
 
 
 @pytest.mark.onlynoncluster
-class TestEchoHealthCheck:
+class TestPingHealthCheck:
     def test_database_is_healthy_on_echo_response(self, mock_client, mock_cb):
         """
         Mocking responses to mix error and actual responses to ensure that health check retry
         according to given configuration.
         """
-        mock_client.execute_command.return_value = "healthcheck"
-        hc = EchoHealthCheck()
+        mock_client.execute_command.return_value = "PONG"
+        hc = PingHealthCheck()
         db = Database(mock_client, mock_cb, 0.9)
 
         assert hc.check_health(db)
@@ -221,8 +221,8 @@ def test_database_is_unhealthy_on_incorrect_echo_response(
         Mocking responses to mix error and actual responses to ensure that health check retry
         according to given configuration.
         """
-        mock_client.execute_command.return_value = "wrong"
-        hc = EchoHealthCheck()
+        mock_client.execute_command.return_value = False
+        hc = PingHealthCheck()
         db = Database(mock_client, mock_cb, 0.9)
 
         assert not hc.check_health(db)
@@ -231,9 +231,9 @@ def test_database_is_unhealthy_on_incorrect_echo_response(
     def test_database_close_circuit_on_successful_healthcheck(
         self, mock_client, mock_cb
     ):
-        mock_client.execute_command.return_value = "healthcheck"
+        mock_client.execute_command.return_value = "PONG"
         mock_cb.state = CBState.HALF_OPEN
-        hc = EchoHealthCheck()
+        hc = PingHealthCheck()
         db = Database(mock_client, mock_cb, 0.9)
 
         assert hc.check_health(db)

From 12395db6964b13992e413736ebb8f86fde20aba9 Mon Sep 17 00:00:00 2001
From: David Maier <60782329+dmaier-redislabs@users.noreply.github.com>
Date: Fri, 24 Oct 2025 10:19:33 +0200
Subject: [PATCH 1145/1164] Revised multi-database client documentation

Updated the multi-database client documentation for clarity and accuracy, including changes to health check terminology and descriptions of failover behavior.
---
 docs/multi_database.rst | 55 +++++++++++++++++++----------------------
 1 file changed, 26 insertions(+), 29 deletions(-)

diff --git a/docs/multi_database.rst b/docs/multi_database.rst
index 6906b09e4d..2eb1b2cdb2 100644
--- a/docs/multi_database.rst
+++ b/docs/multi_database.rst
@@ -1,10 +1,10 @@
 Multi-database client (Active-Active)
 =====================================
 
-The multi-database client lets you connect your application to multiple logical Redis databases at once
-and operate them as a single, resilient endpoint. It continuously monitors health, detects failures,
-and fails over to the next healthy database using a configurable strategy. When the previous primary
-becomes healthy again, the client can automatically fall back to it.
+The multi-database client allows your application to connect to multiple Redis databases, which are typically replicas of each other. 
+It is designed to work with Redis Software and Redis Cloud Active-Active setups. 
+The client continuously monitors database health, detects failures, and automatically fails over to the next healthy database using a configurable strategy. 
+When the original database becomes healthy again, the client can automatically switch back to it.
 
 Key concepts
 ------------
@@ -19,7 +19,7 @@ Key concepts
 
 - Health checks:
   A set of checks determines whether a database is healthy in proactive manner.
-  By default, an "ECHO" check runs against the database (all cluster nodes must
+  By default, an "PING" check runs against the database (all cluster nodes must
   pass for a cluster). You can add custom checks. A Redis Enterprise specific
   "lag-aware" health check is also available.
 
@@ -29,19 +29,18 @@ Key concepts
   fine-grain tuned configuration of triggering fail over based on organic traffic.
 
 - Failover strategy:
-  The default strategy is weight-based. It prefers the highest-weight healthy database.
+  The default strategy is based on staticly configured weights. It prefers the highest weighted healthy database.
 
 - Command retry:
   Command execution supports retry with backoff. Low-level client retries are disabled and a global retry
   setting is applied at the multi-database layer.
 
 - Auto fallback:
-  If configured with a positive interval, the client periodically attempts to fall back to a higher-priority
+  If configured with a positive interval, the client periodically attempts to fall back to a higher-weighted
   healthy database.
 
 - Events:
-  The client emits events like "active database changed" and "commands failed". Pub/Sub re-subscription
-  on database switch is handled automatically.
+  The client emits events like "active database changed" and "commands failed". In addition it resubscribes to Pub/Sub channels automatically.
 
 Synchronous usage
 -----------------
@@ -147,7 +146,7 @@ The asyncio API mirrors the synchronous one and provides async/await semantics.
 MultiDBClient
 ^^^^^^^^^^^^^
 
-The client exposes the same API as the `Redis` or `RedisCluster` client, making it fully interchangeable and ensuring a seamless upgrade for your application. Additionally, it supports runtime reconfiguration, allowing you to add features such as health checks, failure detectors, or even new databases without restarting.
+The client exposes the same API as the `Redis` or `RedisCluster` client, making it fully interchangeable and ensuring a simple migration of your application code. Additionally, it supports runtime reconfiguration, allowing you to add features such as health checks, failure detectors, or even new databases without restarting.
 
 Configuration
 -------------
@@ -274,16 +273,16 @@ define one of the health check policies to evaluate probes result.
 **HealthCheckPolicies.HEALTHY_MAJORITY** - Majority of probes should be successful. 
 **HealthCheckPolicies.HEALTHY_ANY** - Any of probes should be successful. 
 
-EchoHealthCheck (default)
+PingHealthCheck (default)
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
-The default health check sends the [ECHO](https://redis.io/docs/latest/commands/echo/) command
+The default health check sends the [PING](https://redis.io/docs/latest/commands/ping/) command
 to the database (and to all nodes for clusters).
 
 Lag-Aware Healthcheck (Redis Enterprise Only)
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-This is a special type of healthcheck available for Redis Software and Redis Cloud
+This is a special type of healthcheck available for Redis (Enterprise) Software
 that utilizes a REST API endpoint to obtain information about the synchronization
 lag between a given database and all other databases in an Active-Active setup.
 
@@ -296,7 +295,7 @@ reverse proxy behind an actual REST API endpoint.
 
     from redis.multidb.client import MultiDBClient
     from redis.multidb.config import MultiDbConfig, DatabaseConfig
-    from redis.multidb.healthcheck import EchoHealthCheck, LagAwareHealthCheck
+    from redis.multidb.healthcheck import PingHealthCheck, LagAwareHealthCheck
     from redis.retry import Retry
     from redis.backoff import ExponentialWithJitterBackoff
 
@@ -313,7 +312,7 @@ reverse proxy behind an actual REST API endpoint.
                 health_check_url="https://cluster.example.com",
             ),
         ],
-        # Add custom checks (in addition to default EchoHealthCheck)
+        # Add custom checks (in addition to default PingHealthCheck)
         health_checks=[
             # Redis Enterprise REST-based lag-aware check
             LagAwareHealthCheck(
@@ -358,15 +357,13 @@ You can add custom health checks for specific requirements:
 Failure Detection (Reactive Monitoring)
 -----------------
 
-The failure detector monitor actual command failures and marks databases as unhealthy
-when failures count and failure rate exceed thresholds within a sliding time window
-of a few seconds. This catches issues that proactive health checks might miss during
-real traffic. You can extend the list of failure detectors by providing your own
-implementation, configuration defined in the `MultiDBConfig` class.
+The failure detector monitors command failures and marks a database as unhealthy when its failure rate exceeds a defined threshold within a sliding time window. 
+Under real traffic conditions, this reactive detection mechanism likely triggers earlier than proactive health checks. 
+You can extend the set of failure detectors by implementing your own and configuring it through the `MultiDBConfig` class.
 
-By default failure detector is configured for 1000 failures and 10% failure rate
-threshold within a 2 seconds sliding window, this could be adjusted regarding
-your application specifics and traffic.
+By default the failure detector is configured for 1000 failures and a 10% failure rate
+threshold within a 2 seconds sliding window. This could be adjusted regarding
+your application specifics and traffic pattern.
 
 .. code-block:: python
 
@@ -388,13 +385,13 @@ your application specifics and traffic.
         CustomFailureDetector()
     )
 
-Failover and auto fallback
+Failover and automatic fallback
 --------------------------
 
-Weight-based failover chooses the highest-weight database whose circuit is CLOSED. If no database is
-healthy it returns `TemporaryUnavailableException`. This exception indicates that application can
-still send requests for some time (depends on configuration (`failover_attempts` * `failover_delay`)
-120 seconds by default) until `NoValidDatabaseException` will be thrown.
+Weight-based failover chooses the highest-weighted database with a CLOSED circuit. If no database is
+healthy it returns `TemporaryUnavailableException`. This exception indicates that the application should
+retry sending requests for a configurable period of time (the configuration (`failover_attempts` * `failover_delay`)
+defaults to 120 seconds). If none of the databases became available, then a `NoValidDatabaseException` is thrown.
 
 To enable periodic fallback to a higher-priority healthy database, set `auto_fallback_interval` (seconds):
 
@@ -518,4 +515,4 @@ Troubleshooting
   are configured properly.
 
 - Pub/Sub not receiving messages after failover:
-  Ensure you are using the client’s Pub/Sub helper. The client re-subscribes automatically on switch.
\ No newline at end of file
+  Ensure you are using the client’s Pub/Sub helper. The client re-subscribes automatically on switch.

From c62050333b0e562c7d00e0777f67f8714fc4d9d0 Mon Sep 17 00:00:00 2001
From: David Maier <60782329+dmaier-redislabs@users.noreply.github.com>
Date: Fri, 24 Oct 2025 10:31:41 +0200
Subject: [PATCH 1146/1164] Add 'multi_database' section to documentation index

---
 docs/index.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/index.rst b/docs/index.rst
index 2c0557cbbe..06d0387418 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -66,6 +66,7 @@ Module Documentation
 
    connections
    clustering
+   multi_database
    exceptions
    backoff
    lock

From fa6633cb41bb0323a19a37d25ce9574c004c842a Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Wed, 29 Oct 2025 17:39:31 +0200
Subject: [PATCH 1147/1164] Adding Redis 8.4 RC1 image to test matrix. (#3820)

* Adding Redis 8.4 RC1 image to test matrix.

* Fix spelling error.
---
 .github/workflows/integration.yaml |  2 +-
 docs/multi_database.rst            | 18 +++++++++---------
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 5adf7f41ac..36a1de0d63 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -76,7 +76,7 @@ jobs:
       max-parallel: 15
       fail-fast: false
       matrix:
-        redis-version: ['8.4-M01-pre', '${{ needs.redis_version.outputs.CURRENT }}', '8.0.2' ,'7.4.4', '7.2.9']
+        redis-version: ['8.4-RC1-pre', '${{ needs.redis_version.outputs.CURRENT }}', '8.0.2' ,'7.4.4', '7.2.9']
         python-version: ['3.9', '3.13']
         parser-backend: ['plain']
         event-loop: ['asyncio']
diff --git a/docs/multi_database.rst b/docs/multi_database.rst
index 2eb1b2cdb2..97becef27c 100644
--- a/docs/multi_database.rst
+++ b/docs/multi_database.rst
@@ -1,9 +1,9 @@
 Multi-database client (Active-Active)
 =====================================
 
-The multi-database client allows your application to connect to multiple Redis databases, which are typically replicas of each other. 
-It is designed to work with Redis Software and Redis Cloud Active-Active setups. 
-The client continuously monitors database health, detects failures, and automatically fails over to the next healthy database using a configurable strategy. 
+The multi-database client allows your application to connect to multiple Redis databases, which are typically replicas of each other.
+It is designed to work with Redis Software and Redis Cloud Active-Active setups.
+The client continuously monitors database health, detects failures, and automatically fails over to the next healthy database using a configurable strategy.
 When the original database becomes healthy again, the client can automatically switch back to it.
 
 Key concepts
@@ -29,7 +29,7 @@ Key concepts
   fine-grain tuned configuration of triggering fail over based on organic traffic.
 
 - Failover strategy:
-  The default strategy is based on staticly configured weights. It prefers the highest weighted healthy database.
+  The default strategy is based on statically configured weights. It prefers the highest weighted healthy database.
 
 - Command retry:
   Command execution supports retry with backoff. Low-level client retries are disabled and a global retry
@@ -269,9 +269,9 @@ configuration defined in the `MultiDBConfig` class.
 To avoid false positives, you can configure amount of health check probes and also
 define one of the health check policies to evaluate probes result.
 
-**HealthCheckPolicies.HEALTHY_ALL** - (default) All probes should be successful. 
-**HealthCheckPolicies.HEALTHY_MAJORITY** - Majority of probes should be successful. 
-**HealthCheckPolicies.HEALTHY_ANY** - Any of probes should be successful. 
+**HealthCheckPolicies.HEALTHY_ALL** - (default) All probes should be successful.
+**HealthCheckPolicies.HEALTHY_MAJORITY** - Majority of probes should be successful.
+**HealthCheckPolicies.HEALTHY_ANY** - Any of probes should be successful.
 
 PingHealthCheck (default)
 ^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -357,8 +357,8 @@ You can add custom health checks for specific requirements:
 Failure Detection (Reactive Monitoring)
 -----------------
 
-The failure detector monitors command failures and marks a database as unhealthy when its failure rate exceeds a defined threshold within a sliding time window. 
-Under real traffic conditions, this reactive detection mechanism likely triggers earlier than proactive health checks. 
+The failure detector monitors command failures and marks a database as unhealthy when its failure rate exceeds a defined threshold within a sliding time window.
+Under real traffic conditions, this reactive detection mechanism likely triggers earlier than proactive health checks.
 You can extend the set of failure detectors by implementing your own and configuring it through the `MultiDBConfig` class.
 
 By default the failure detector is configured for 1000 failures and a 10% failure rate

From 0959a4088baf079e69af40b72d53e520c3bba46d Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Wed, 29 Oct 2025 19:34:09 +0200
Subject: [PATCH 1148/1164] Remove Python 3.9 support. Add Python 3.14 support.
 (#3814)

---
 .github/workflows/docs.yaml                   |  2 +-
 .github/workflows/hiredis-py-integration.yaml |  2 +-
 .github/workflows/integration.yaml            | 14 ++++++-------
 .github/workflows/pypi-publish.yaml           |  2 +-
 .readthedocs.yml                              |  2 +-
 dev_requirements.txt                          | 21 ++++++++++---------
 pyproject.toml                                |  6 +++---
 redis/__init__.py                             |  2 +-
 8 files changed, 26 insertions(+), 25 deletions(-)

diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml
index 757a5898ff..b8ca616844 100644
--- a/.github/workflows/docs.yaml
+++ b/.github/workflows/docs.yaml
@@ -28,7 +28,7 @@ jobs:
        - uses: actions/checkout@v5
        - uses: actions/setup-python@v6
          with:
-           python-version: 3.9
+           python-version: "3.10"
            cache: 'pip'
        - name: install deps
          run: |
diff --git a/.github/workflows/hiredis-py-integration.yaml b/.github/workflows/hiredis-py-integration.yaml
index 9b5220ab12..a780c4d32c 100644
--- a/.github/workflows/hiredis-py-integration.yaml
+++ b/.github/workflows/hiredis-py-integration.yaml
@@ -45,7 +45,7 @@ jobs:
       fail-fast: false
       matrix:
         redis-version: [ '${{ needs.redis_version.outputs.CURRENT }}' ]
-        python-version: [ '3.9', '3.14']
+        python-version: [ '3.10', '3.14']
         parser-backend: [ 'hiredis' ]
         hiredis-version: [ 'unstable' ]
         event-loop: [ 'asyncio' ]
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 36a1de0d63..16b4fb406f 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -51,7 +51,7 @@ jobs:
       - uses: actions/checkout@v5
       - uses: actions/setup-python@v6
         with:
-          python-version: 3.9
+          python-version: "3.10"
           cache: 'pip'
       - name: run code linters
         run: |
@@ -77,7 +77,7 @@ jobs:
       fail-fast: false
       matrix:
         redis-version: ['8.4-RC1-pre', '${{ needs.redis_version.outputs.CURRENT }}', '8.0.2' ,'7.4.4', '7.2.9']
-        python-version: ['3.9', '3.13']
+        python-version: ['3.10', '3.14']
         parser-backend: ['plain']
         event-loop: ['asyncio']
     env:
@@ -101,7 +101,7 @@ jobs:
       fail-fast: false
       matrix:
         redis-version: [ '${{ needs.redis_version.outputs.CURRENT }}' ]
-        python-version: ['3.10', '3.11', '3.12', 'pypy-3.9', 'pypy-3.10']
+        python-version: ['3.11', '3.12', '3.13', 'pypy-3.10', 'pypy-3.11']
         parser-backend: [ 'plain' ]
         event-loop: [ 'asyncio' ]
     env:
@@ -125,7 +125,7 @@ jobs:
       fail-fast: false
       matrix:
         redis-version: [ '${{ needs.redis_version.outputs.CURRENT }}' ]
-        python-version: [ '3.9', '3.13']
+        python-version: [ '3.10', '3.14']
         parser-backend: [ 'hiredis' ]
         hiredis-version: [ '>=3.2.0', '<3.0.0' ]
         event-loop: [ 'asyncio' ]
@@ -151,7 +151,7 @@ jobs:
       fail-fast: false
       matrix:
         redis-version: [ '${{ needs.redis_version.outputs.CURRENT }}' ]
-        python-version: [ '3.9', '3.13' ]
+        python-version: [ '3.10', '3.14' ]
         parser-backend: [ 'plain' ]
         event-loop: [ 'uvloop' ]
     env:
@@ -179,7 +179,7 @@ jobs:
       - uses: actions/checkout@v5
       - uses: actions/setup-python@v6
         with:
-          python-version: 3.9
+          python-version: "3.10"
       - name: Run installed unit tests
         env:
           CLIENT_LIBS_TEST_IMAGE_TAG: ${{ env.CURRENT_REDIS_VERSION }}
@@ -193,7 +193,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13', 'pypy-3.9', 'pypy-3.10']
+        python-version: ['3.10', '3.11', '3.12', '3.13', '3.14', 'pypy-3.10', 'pypy-3.11']
     steps:
       - uses: actions/checkout@v5
       - uses: actions/setup-python@v6
diff --git a/.github/workflows/pypi-publish.yaml b/.github/workflows/pypi-publish.yaml
index 77bbfa9962..27e07ca901 100644
--- a/.github/workflows/pypi-publish.yaml
+++ b/.github/workflows/pypi-publish.yaml
@@ -17,7 +17,7 @@ jobs:
       - name: install python
         uses: actions/setup-python@v6
         with:
-          python-version: 3.9
+          python-version: "3.10"
       - run: pip install build twine
 
       - name: Build package
diff --git a/.readthedocs.yml b/.readthedocs.yml
index 17bfa9d47c..0600219e1c 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -9,7 +9,7 @@ python:
 build:
   os: ubuntu-20.04
   tools:
-    python: "3.9"
+    python: "3.10"
 
 sphinx:
   configuration: docs/conf.py
diff --git a/dev_requirements.txt b/dev_requirements.txt
index 7758a1839e..f201098a14 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -1,30 +1,31 @@
 build
-build==1.2.2.post1 ; platform_python_implementation == "PyPy" or python_version < "3.10"
+build==1.2.2.post1 ; platform_python_implementation == "PyPy"
 click==8.0.4
 invoke==2.2.0
 mock
-mock==5.1.0 ; platform_python_implementation == "PyPy" or python_version < "3.10"
+mock==5.1.0 ; platform_python_implementation == "PyPy"
 packaging>=20.4
-packaging==24.2 ; platform_python_implementation == "PyPy" or python_version < "3.10"
+packaging==24.2 ; platform_python_implementation == "PyPy"
 
 pytest
-pytest==8.3.4 ; platform_python_implementation == "PyPy" or python_version < "3.10"
+pytest==8.3.4 ; platform_python_implementation == "PyPy"
 pytest-asyncio>=0.23.0
-pytest-asyncio==1.1.0 ; platform_python_implementation == "PyPy" or python_version < "3.10"
+pytest-asyncio==1.1.0 ; platform_python_implementation == "PyPy"
 pytest-cov
-pytest-cov==6.0.0 ; platform_python_implementation == "PyPy" or python_version < "3.10"
-coverage==7.6.12 ; platform_python_implementation == "PyPy" or python_version < "3.10"
+pytest-cov==6.0.0 ; platform_python_implementation == "PyPy"
+coverage==7.6.12 ; platform_python_implementation == "PyPy"
 pytest-profiling==1.8.1
 pytest-timeout
-pytest-timeout==2.3.1 ; platform_python_implementation == "PyPy" or python_version < "3.10"
+pytest-timeout==2.3.1 ; platform_python_implementation == "PyPy"
 
 ruff==0.9.6
 ujson>=4.2.0
-uvloop<=0.21.0; platform_python_implementation == "CPython"
+uvloop<=0.21.0; platform_python_implementation == "CPython" and python_version < "3.14"
+uvloop>=0.22; platform_python_implementation == "CPython" and python_version >= "3.14"
 vulture>=2.3.0
 
 numpy>=1.24.0 ; platform_python_implementation == "CPython"
-numpy>=1.24.0,<2.0 ; platform_python_implementation == "PyPy" or python_version < "3.10"
+numpy>=1.24.0,<2.0 ; platform_python_implementation == "PyPy"
 
 redis-entraid==1.0.0
 pybreaker>=1.4.0
diff --git a/pyproject.toml b/pyproject.toml
index 7888b5f70c..f1cedefead 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -8,7 +8,7 @@ dynamic = ["version"]
 description = "Python client for Redis database and key-value store"
 readme = "README.md"
 license = "MIT"
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 authors = [{ name = "Redis Inc.", email = "oss@redis.com" }]
 keywords = ["Redis", "database", "key-value-store"]
 classifiers = [
@@ -20,11 +20,11 @@ classifiers = [
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Programming Language :: Python :: Implementation :: CPython",
     "Programming Language :: Python :: Implementation :: PyPy",
 ]
@@ -91,7 +91,7 @@ log_level = "INFO"
 capture = "yes"
 
 [tool.ruff]
-target-version = "py39"
+target-version = "py310"
 line-length = 88
 exclude = [
     "*.egg-info",
diff --git a/redis/__init__.py b/redis/__init__.py
index 67f165d9fe..669779c6b9 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -46,7 +46,7 @@ def int_or_str(value):
         return value
 
 
-__version__ = "6.2.0"
+__version__ = "7.0.0"
 VERSION = tuple(map(int_or_str, __version__.split(".")))
 
 

From 50f1a57ea53f7e56d7df8d0c7353a1d21625b730 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 30 Oct 2025 10:30:42 +0200
Subject: [PATCH 1149/1164] Sync readme with 7.0.1 and update lib version to
 latest stable released version - 7.0.1 (#3821)

* Adding info about Multi-database client in README.md

* Adding changes in README.md pushed to 7.0 into master. Updating lib version to the stable version - 7.0.1
---
 README.md         | 17 ++++++++++++++---
 redis/__init__.py |  3 ++-
 2 files changed, 16 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 97afa2f9bc..614f79f592 100644
--- a/README.md
+++ b/README.md
@@ -13,8 +13,9 @@ The Python interface to the Redis key-value store.
 
 ---------------------------------------------
 
-**Note:** redis-py 5.0 will be the last version of redis-py to support Python 3.7, as it has reached [end of life](https://devguide.python.org/versions/). redis-py 5.1 will support Python 3.8+.
-**Note:** redis-py 6.1.0 will be the last version of redis-py to support Python 3.8, as it has reached [end of life](https://devguide.python.org/versions/). redis-py 6.2.0 will support Python 3.9+.
+**Note:** redis-py 5.0 is the last version of redis-py that supports Python 3.7, as it has reached [end of life](https://devguide.python.org/versions/). redis-py 5.1 supports Python 3.8+.<br>
+**Note:** redis-py 6.1.0 is the last version of redis-py that supports Python 3.8, as it has reached [end of life](https://devguide.python.org/versions/). redis-py 6.2.0 supports Python 3.9+.
+
 ---------------------------------------------
 
 ## How do I Redis?
@@ -59,7 +60,7 @@ Looking for a high-level library to handle object mapping? See [redis-om-python]
 
 ## Supported Redis Versions
 
-The most recent version of this library supports Redis version [7.2](https://github.com/redis/redis/blob/7.2/00-RELEASENOTES), [7.4](https://github.com/redis/redis/blob/7.4/00-RELEASENOTES) and [8.0](https://github.com/redis/redis/blob/8.0/00-RELEASENOTES).
+The most recent version of this library supports Redis version [7.2](https://github.com/redis/redis/blob/7.2/00-RELEASENOTES), [7.4](https://github.com/redis/redis/blob/7.4/00-RELEASENOTES), [8.0](https://github.com/redis/redis/blob/8.0/00-RELEASENOTES) and [8.2](https://github.com/redis/redis/blob/8.2/00-RELEASENOTES).
 
 The table below highlights version compatibility of the most-recent library versions and redis versions.
 
@@ -193,6 +194,16 @@ By default, the client now overrides the server-side dialect with version 2, aut
 
 You can find further details in the [query dialect documentation](https://redis.io/docs/latest/develop/interact/search-and-query/advanced-concepts/dialects/).
 
+### Multi-database client (Active-Active)
+
+The multi-database client allows your application to connect to multiple Redis databases, which are typically replicas of each other. It is designed to work with Redis Software and Redis Cloud Active-Active setups. The client continuously monitors database health, detects failures, and automatically fails over to the next healthy database using a configurable strategy. When the original database becomes healthy again, the client can automatically switch back to it.<br>
+This is useful when:
+
+1. You have more than one Redis deployment. This might include two independent Redis servers or two or more Redis databases replicated across multiple [active-active Redis Enterprise](https://redis.io/docs/latest/operate/rs/databases/active-active/) clusters.
+2. You want your application to connect to one deployment at a time and to fail over to the next available deployment if the first deployment becomes unavailable.
+
+For the complete failover configuration options and examples, see the [Multi-database client docs](https://redis.readthedocs.io/en/latest/multi_database.html).
+
 ---------------------------------------------
 
 ### Author
diff --git a/redis/__init__.py b/redis/__init__.py
index 669779c6b9..fd90163c30 100644
--- a/redis/__init__.py
+++ b/redis/__init__.py
@@ -46,7 +46,8 @@ def int_or_str(value):
         return value
 
 
-__version__ = "7.0.0"
+__version__ = "7.0.1"
+
 VERSION = tuple(map(int_or_str, __version__.split(".")))
 
 

From 440465bb2904e2b90993f9c8733360479e95dd81 Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Fri, 31 Oct 2025 15:00:16 +0200
Subject: [PATCH 1150/1164] Replace default health check and failure detector
 with custom (#3822)

* Replace default health check and failure detector with custom

* Codestyle changes

* Fixed bug with disabled auto_fallback_interval

---------

Co-authored-by: petyaslavova <petya.slavova@redis.com>
---
 docs/multi_database.rst                       |   5 +-
 redis/asyncio/multidb/client.py               |  18 +--
 redis/asyncio/multidb/command_executor.py     |   2 +-
 redis/multidb/client.py                       |  19 ++--
 redis/multidb/command_executor.py             |   4 +-
 .../test_asyncio/test_multidb/test_client.py  | 106 +++++++++++-------
 tests/test_multidb/test_client.py             | 105 ++++++++++-------
 7 files changed, 158 insertions(+), 101 deletions(-)

diff --git a/docs/multi_database.rst b/docs/multi_database.rst
index 97becef27c..88ec21a2fb 100644
--- a/docs/multi_database.rst
+++ b/docs/multi_database.rst
@@ -20,13 +20,16 @@ Key concepts
 - Health checks:
   A set of checks determines whether a database is healthy in proactive manner.
   By default, an "PING" check runs against the database (all cluster nodes must
-  pass for a cluster). You can add custom checks. A Redis Enterprise specific
+  pass for a cluster). You can provide your own set of health checks or add an
+  additional health check on top of the default one. A Redis Enterprise specific
   "lag-aware" health check is also available.
 
 - Failure detector:
   A detector observes command failures over a moving window (reactive monitoring).
   You can specify an exact number of failures and failures rate to have more
   fine-grain tuned configuration of triggering fail over based on organic traffic.
+  You can provide your own set of custom failure detectors or add an additional
+  detector on top of the default one.
 
 - Failover strategy:
   The default strategy is based on statically configured weights. It prefers the highest weighted healthy database.
diff --git a/redis/asyncio/multidb/client.py b/redis/asyncio/multidb/client.py
index d3e3f241d2..f6385e46ea 100644
--- a/redis/asyncio/multidb/client.py
+++ b/redis/asyncio/multidb/client.py
@@ -28,19 +28,21 @@ class MultiDBClient(AsyncRedisModuleCommands, AsyncCoreCommands):
 
     def __init__(self, config: MultiDbConfig):
         self._databases = config.databases()
-        self._health_checks = config.default_health_checks()
-
-        if config.health_checks is not None:
-            self._health_checks.extend(config.health_checks)
+        self._health_checks = (
+            config.default_health_checks()
+            if not config.health_checks
+            else config.health_checks
+        )
 
         self._health_check_interval = config.health_check_interval
         self._health_check_policy: HealthCheckPolicy = config.health_check_policy.value(
             config.health_check_probes, config.health_check_delay
         )
-        self._failure_detectors = config.default_failure_detectors()
-
-        if config.failure_detectors is not None:
-            self._failure_detectors.extend(config.failure_detectors)
+        self._failure_detectors = (
+            config.default_failure_detectors()
+            if not config.failure_detectors
+            else config.failure_detectors
+        )
 
         self._failover_strategy = (
             config.default_failover_strategy()
diff --git a/redis/asyncio/multidb/command_executor.py b/redis/asyncio/multidb/command_executor.py
index c09b8b9969..51c50c223a 100644
--- a/redis/asyncio/multidb/command_executor.py
+++ b/redis/asyncio/multidb/command_executor.py
@@ -303,7 +303,7 @@ async def _check_active_database(self):
             self._active_database is None
             or self._active_database.circuit.state != CBState.CLOSED
             or (
-                self._auto_fallback_interval != DEFAULT_AUTO_FALLBACK_INTERVAL
+                self._auto_fallback_interval > 0
                 and self._next_fallback_attempt <= datetime.now()
             )
         ):
diff --git a/redis/multidb/client.py b/redis/multidb/client.py
index c46a53af32..272064453a 100644
--- a/redis/multidb/client.py
+++ b/redis/multidb/client.py
@@ -29,19 +29,20 @@ class MultiDBClient(RedisModuleCommands, CoreCommands):
 
     def __init__(self, config: MultiDbConfig):
         self._databases = config.databases()
-        self._health_checks = config.default_health_checks()
-
-        if config.health_checks is not None:
-            self._health_checks.extend(config.health_checks)
-
+        self._health_checks = (
+            config.default_health_checks()
+            if not config.health_checks
+            else config.health_checks
+        )
         self._health_check_interval = config.health_check_interval
         self._health_check_policy: HealthCheckPolicy = config.health_check_policy.value(
             config.health_check_probes, config.health_check_probes_delay
         )
-        self._failure_detectors = config.default_failure_detectors()
-
-        if config.failure_detectors is not None:
-            self._failure_detectors.extend(config.failure_detectors)
+        self._failure_detectors = (
+            config.default_failure_detectors()
+            if not config.failure_detectors
+            else config.failure_detectors
+        )
 
         self._failover_strategy = (
             config.default_failover_strategy()
diff --git a/redis/multidb/command_executor.py b/redis/multidb/command_executor.py
index f8e6171bc8..202bf723fe 100644
--- a/redis/multidb/command_executor.py
+++ b/redis/multidb/command_executor.py
@@ -55,7 +55,7 @@ def auto_fallback_interval(self, auto_fallback_interval: int) -> None:
         self._auto_fallback_interval = auto_fallback_interval
 
     def _schedule_next_fallback(self) -> None:
-        if self._auto_fallback_interval == DEFAULT_AUTO_FALLBACK_INTERVAL:
+        if self._auto_fallback_interval < 0:
             return
 
         self._next_fallback_attempt = datetime.now() + timedelta(
@@ -321,7 +321,7 @@ def _check_active_database(self):
             self._active_database is None
             or self._active_database.circuit.state != CBState.CLOSED
             or (
-                self._auto_fallback_interval != DEFAULT_AUTO_FALLBACK_INTERVAL
+                self._auto_fallback_interval > 0
                 and self._next_fallback_attempt <= datetime.now()
             )
         ):
diff --git a/tests/test_asyncio/test_multidb/test_client.py b/tests/test_asyncio/test_multidb/test_client.py
index e912a00466..e028655c38 100644
--- a/tests/test_asyncio/test_multidb/test_client.py
+++ b/tests/test_asyncio/test_multidb/test_client.py
@@ -34,12 +34,10 @@ async def test_execute_command_against_correct_db_on_successful_initialization(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
-            ),
         ):
             mock_db1.client.execute_command = AsyncMock(return_value="OK1")
 
@@ -71,12 +69,10 @@ async def test_execute_command_against_correct_db_and_closed_circuit(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
-            ),
         ):
             mock_db1.client.execute_command = AsyncMock(return_value="OK1")
 
@@ -187,14 +183,10 @@ async def mock_check_health(database):
                 return True
 
         mock_hc.check_health.side_effect = mock_check_health
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config,
-                "default_health_checks",
-                return_value=[mock_hc],
-            ),
         ):
             mock_db.client.execute_command.return_value = "OK"
             mock_db1.client.execute_command.return_value = "OK1"
@@ -264,14 +256,10 @@ async def mock_check_health(database):
             return True
 
         mock_hc.check_health.side_effect = mock_check_health
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config,
-                "default_health_checks",
-                return_value=[mock_hc],
-            ),
         ):
             mock_db.client.execute_command.return_value = "OK"
             mock_db1.client.execute_command.return_value = "OK1"
@@ -287,6 +275,60 @@ async def mock_check_health(database):
                 await asyncio.sleep(0.5)
                 assert await client.set("key", "value") == "OK1"
 
+    @pytest.mark.asyncio
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {"health_check_probes": 1},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    async def test_execute_command_do_not_auto_fallback_to_highest_weight_db(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        db1_counter = 0
+        error_event = asyncio.Event()
+        check = False
+
+        async def mock_check_health(database):
+            nonlocal db1_counter, check
+
+            if database == mock_db1 and not check:
+                db1_counter += 1
+
+                if db1_counter > 1:
+                    error_event.set()
+                    check = True
+                    return False
+
+            return True
+
+        mock_hc.check_health.side_effect = mock_check_health
+        mock_multi_db_config.health_checks = [mock_hc]
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+        ):
+            mock_db.client.execute_command.return_value = "OK"
+            mock_db1.client.execute_command.return_value = "OK1"
+            mock_db2.client.execute_command.return_value = "OK2"
+            mock_multi_db_config.health_check_interval = 0.1
+            mock_multi_db_config.auto_fallback_interval = -1
+            mock_multi_db_config.failover_strategy = WeightBasedFailoverStrategy()
+
+            async with MultiDBClient(mock_multi_db_config) as client:
+                assert await client.set("key", "value") == "OK1"
+                await error_event.wait()
+                assert await client.set("key", "value") == "OK2"
+                await asyncio.sleep(0.5)
+                assert await client.set("key", "value") == "OK2"
+
     @pytest.mark.asyncio
     @pytest.mark.parametrize(
         "mock_multi_db_config,mock_db, mock_db1, mock_db2",
@@ -304,12 +346,10 @@ async def test_execute_command_throws_exception_on_failed_initialization(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
-            ),
         ):
             mock_hc.check_health.return_value = False
 
@@ -340,12 +380,10 @@ async def test_add_database_throws_exception_on_same_database(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
-            ),
         ):
             mock_hc.check_health.return_value = False
 
@@ -373,12 +411,10 @@ async def test_add_database_makes_new_database_active(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
         databases = create_weighted_list(mock_db, mock_db2)
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
-            ),
         ):
             mock_db1.client.execute_command.return_value = "OK1"
             mock_db2.client.execute_command.return_value = "OK2"
@@ -413,12 +449,10 @@ async def test_remove_highest_weighted_database(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
-            ),
         ):
             mock_db1.client.execute_command.return_value = "OK1"
             mock_db2.client.execute_command.return_value = "OK2"
@@ -451,12 +485,10 @@ async def test_update_database_weight_to_be_highest(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
-            ),
         ):
             mock_db1.client.execute_command.return_value = "OK1"
             mock_db2.client.execute_command.return_value = "OK2"
@@ -491,12 +523,10 @@ async def test_add_new_failure_detector(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
-            ),
         ):
             mock_db1.client.execute_command.return_value = "OK1"
             mock_multi_db_config.event_dispatcher = EventDispatcher()
@@ -552,12 +582,10 @@ async def test_add_new_health_check(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
-            ),
         ):
             mock_db1.client.execute_command.return_value = "OK1"
 
@@ -594,12 +622,10 @@ async def test_set_active_database(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
-            ),
         ):
             mock_db1.client.execute_command.return_value = "OK1"
             mock_db.client.execute_command.return_value = "OK"
diff --git a/tests/test_multidb/test_client.py b/tests/test_multidb/test_client.py
index cbc81b15ed..b342b4b91b 100644
--- a/tests/test_multidb/test_client.py
+++ b/tests/test_multidb/test_client.py
@@ -34,12 +34,10 @@ def test_execute_command_against_correct_db_on_successful_initialization(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
-            ),
         ):
             mock_db1.client.execute_command.return_value = "OK1"
 
@@ -70,12 +68,10 @@ def test_execute_command_against_correct_db_and_closed_circuit(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
-            ),
         ):
             mock_db1.client.execute_command.return_value = "OK1"
 
@@ -185,14 +181,10 @@ def mock_check_health(database):
                 return True
 
         mock_hc.check_health.side_effect = mock_check_health
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config,
-                "default_health_checks",
-                return_value=[mock_hc],
-            ),
         ):
             mock_multi_db_config.health_check_interval = 0.1
             mock_multi_db_config.failover_strategy = WeightBasedFailoverStrategy()
@@ -261,14 +253,10 @@ def mock_check_health(database):
             return True
 
         mock_hc.check_health.side_effect = mock_check_health
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config,
-                "default_health_checks",
-                return_value=[mock_hc],
-            ),
         ):
             mock_db.client.execute_command.return_value = "OK"
             mock_db1.client.execute_command.return_value = "OK1"
@@ -284,6 +272,59 @@ def mock_check_health(database):
             sleep(0.5)
             assert client.set("key", "value") == "OK1"
 
+    @pytest.mark.parametrize(
+        "mock_multi_db_config,mock_db, mock_db1, mock_db2",
+        [
+            (
+                {"health_check_probes": 1},
+                {"weight": 0.2, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.7, "circuit": {"state": CBState.CLOSED}},
+                {"weight": 0.5, "circuit": {"state": CBState.CLOSED}},
+            ),
+        ],
+        indirect=True,
+    )
+    def test_execute_command_do_not_auto_fallback_to_highest_weight_db(
+        self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
+    ):
+        databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        db1_counter = 0
+        error_event = threading.Event()
+        check = False
+
+        def mock_check_health(database):
+            nonlocal db1_counter, check
+
+            if database == mock_db1 and not check:
+                db1_counter += 1
+
+                if db1_counter > 1:
+                    error_event.set()
+                    check = True
+                    return False
+
+            return True
+
+        mock_hc.check_health.side_effect = mock_check_health
+        mock_multi_db_config.health_checks = [mock_hc]
+
+        with (
+            patch.object(mock_multi_db_config, "databases", return_value=databases),
+        ):
+            mock_db.client.execute_command.return_value = "OK"
+            mock_db1.client.execute_command.return_value = "OK1"
+            mock_db2.client.execute_command.return_value = "OK2"
+            mock_multi_db_config.health_check_interval = 0.1
+            mock_multi_db_config.auto_fallback_interval = -1
+            mock_multi_db_config.failover_strategy = WeightBasedFailoverStrategy()
+
+            client = MultiDBClient(mock_multi_db_config)
+            assert client.set("key", "value") == "OK1"
+            error_event.wait(timeout=0.5)
+            assert client.set("key", "value") == "OK2"
+            sleep(0.5)
+            assert client.set("key", "value") == "OK2"
+
     @pytest.mark.parametrize(
         "mock_multi_db_config,mock_db, mock_db1, mock_db2",
         [
@@ -300,12 +341,10 @@ def test_execute_command_throws_exception_on_failed_initialization(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
-            ),
         ):
             mock_hc.check_health.return_value = False
 
@@ -336,12 +375,10 @@ def test_add_database_throws_exception_on_same_database(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
-            ),
         ):
             mock_hc.check_health.return_value = False
 
@@ -368,12 +405,10 @@ def test_add_database_makes_new_database_active(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
         databases = create_weighted_list(mock_db, mock_db2)
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
-            ),
         ):
             mock_db1.client.execute_command.return_value = "OK1"
             mock_db2.client.execute_command.return_value = "OK2"
@@ -407,12 +442,10 @@ def test_remove_highest_weighted_database(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
-            ),
         ):
             mock_db1.client.execute_command.return_value = "OK1"
             mock_db2.client.execute_command.return_value = "OK2"
@@ -445,12 +478,10 @@ def test_update_database_weight_to_be_highest(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
-            ),
         ):
             mock_db1.client.execute_command.return_value = "OK1"
             mock_db2.client.execute_command.return_value = "OK2"
@@ -484,12 +515,10 @@ def test_add_new_failure_detector(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
-            ),
         ):
             mock_db1.client.execute_command.return_value = "OK1"
             mock_multi_db_config.event_dispatcher = EventDispatcher()
@@ -540,12 +569,10 @@ def test_add_new_health_check(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
-            ),
         ):
             mock_db1.client.execute_command.return_value = "OK1"
 
@@ -581,12 +608,10 @@ def test_set_active_database(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
+        mock_multi_db_config.health_checks = [mock_hc]
 
         with (
             patch.object(mock_multi_db_config, "databases", return_value=databases),
-            patch.object(
-                mock_multi_db_config, "default_health_checks", return_value=[mock_hc]
-            ),
         ):
             mock_db1.client.execute_command.return_value = "OK1"
             mock_db.client.execute_command.return_value = "OK"

From 1c73570855b81960b695e4501c7c367e765ef5a4 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 3 Nov 2025 09:07:51 +0200
Subject: [PATCH 1151/1164] Bump rojopolis/spellcheck-github-actions from
 0.52.0 to 0.53.0 (#3827)

Bumps [rojopolis/spellcheck-github-actions](https://github.com/rojopolis/spellcheck-github-actions) from 0.52.0 to 0.53.0.
- [Release notes](https://github.com/rojopolis/spellcheck-github-actions/releases)
- [Changelog](https://github.com/rojopolis/spellcheck-github-actions/blob/master/CHANGELOG.md)
- [Commits](https://github.com/rojopolis/spellcheck-github-actions/compare/0.52.0...0.53.0)

---
updated-dependencies:
- dependency-name: rojopolis/spellcheck-github-actions
  dependency-version: 0.53.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/spellcheck.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/spellcheck.yml b/.github/workflows/spellcheck.yml
index 1517c33947..12902ba2e1 100644
--- a/.github/workflows/spellcheck.yml
+++ b/.github/workflows/spellcheck.yml
@@ -8,7 +8,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v5
       - name: Check Spelling
-        uses: rojopolis/spellcheck-github-actions@0.52.0
+        uses: rojopolis/spellcheck-github-actions@0.53.0
         with:
           config_path: .github/spellcheck-settings.yml
           task_name: Markdown

From 75b99f9c4c9186c3cdbf7bc155b823dfb2a4600f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 3 Nov 2025 13:46:56 +0200
Subject: [PATCH 1152/1164] Bump actions/upload-artifact from 4 to 5 (#3828)

Bumps [actions/upload-artifact](https://github.com/actions/upload-artifact) from 4 to 5.
- [Release notes](https://github.com/actions/upload-artifact/releases)
- [Commits](https://github.com/actions/upload-artifact/compare/v4...v5)

---
updated-dependencies:
- dependency-name: actions/upload-artifact
  dependency-version: '5'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: petyaslavova <petya.slavova@redis.com>
---
 .github/workflows/docs.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml
index b8ca616844..272f90838a 100644
--- a/.github/workflows/docs.yaml
+++ b/.github/workflows/docs.yaml
@@ -40,7 +40,7 @@ jobs:
            invoke build-docs
 
        - name: upload docs
-         uses: actions/upload-artifact@v4
+         uses: actions/upload-artifact@v5
          with:
            name: redis-py-docs
            path: |

From e911e514db8367b44e87eb6d934d863fe458b81d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 3 Nov 2025 17:12:56 +0200
Subject: [PATCH 1153/1164] Bump github/codeql-action from 3 to 4 (#3829)

Bumps [github/codeql-action](https://github.com/github/codeql-action) from 3 to 4.
- [Release notes](https://github.com/github/codeql-action/releases)
- [Changelog](https://github.com/github/codeql-action/blob/main/CHANGELOG.md)
- [Commits](https://github.com/github/codeql-action/compare/v3...v4)

---
updated-dependencies:
- dependency-name: github/codeql-action
  dependency-version: '4'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: petyaslavova <petya.slavova@redis.com>
---
 .github/workflows/codeql-analysis.yml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/codeql-analysis.yml b/.github/workflows/codeql-analysis.yml
index abd3198edf..bd6e6b9132 100644
--- a/.github/workflows/codeql-analysis.yml
+++ b/.github/workflows/codeql-analysis.yml
@@ -40,7 +40,7 @@ jobs:
 
     # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL
-      uses: github/codeql-action/init@v3
+      uses: github/codeql-action/init@v4
       with:
         languages: ${{ matrix.language }}
         # If you wish to specify custom queries, you can do so here or in a config file.
@@ -51,7 +51,7 @@ jobs:
     # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
     # If this step fails, then you should remove it and run the build manually (see below)
     - name: Autobuild
-      uses: github/codeql-action/autobuild@v3
+      uses: github/codeql-action/autobuild@v4
 
     # ℹ️ Command-line programs to run using the OS shell.
     # 📚 https://git.io/JvXDl
@@ -65,4 +65,4 @@ jobs:
     #   make release
 
     - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@v3
+      uses: github/codeql-action/analyze@v4

From 6b848e127743270608e76a42543490de8228f806 Mon Sep 17 00:00:00 2001
From: Petar Kostov <petar.kostov@redis.com>
Date: Mon, 3 Nov 2025 18:55:15 +0200
Subject: [PATCH 1154/1164] Add **options to parse functions for sentinel
 (#3831)

* Add **options to parse functions for sentinel

* Add unit tests

* Fixed the tests and the resp parser
---
 redis/_parsers/helpers.py           | 18 ++++++++--------
 tests/test_asyncio/test_sentinel.py | 33 +++++++++++++++++++++++++++++
 tests/test_sentinel.py              | 31 +++++++++++++++++++++++++++
 3 files changed, 73 insertions(+), 9 deletions(-)

diff --git a/redis/_parsers/helpers.py b/redis/_parsers/helpers.py
index 80531bb249..bf3b2ee2f2 100644
--- a/redis/_parsers/helpers.py
+++ b/redis/_parsers/helpers.py
@@ -137,11 +137,11 @@ def parse_sentinel_state(item):
     return result
 
 
-def parse_sentinel_master(response):
+def parse_sentinel_master(response, **options):
     return parse_sentinel_state(map(str_if_bytes, response))
 
 
-def parse_sentinel_state_resp3(response):
+def parse_sentinel_state_resp3(response, **options):
     result = {}
     for key in response:
         try:
@@ -154,7 +154,7 @@ def parse_sentinel_state_resp3(response):
     return result
 
 
-def parse_sentinel_masters(response):
+def parse_sentinel_masters(response, **options):
     result = {}
     for item in response:
         state = parse_sentinel_state(map(str_if_bytes, item))
@@ -162,19 +162,19 @@ def parse_sentinel_masters(response):
     return result
 
 
-def parse_sentinel_masters_resp3(response):
-    return [parse_sentinel_state(master) for master in response]
+def parse_sentinel_masters_resp3(response, **options):
+    return [parse_sentinel_state_resp3(master) for master in response]
 
 
-def parse_sentinel_slaves_and_sentinels(response):
+def parse_sentinel_slaves_and_sentinels(response, **options):
     return [parse_sentinel_state(map(str_if_bytes, item)) for item in response]
 
 
-def parse_sentinel_slaves_and_sentinels_resp3(response):
-    return [parse_sentinel_state_resp3(item) for item in response]
+def parse_sentinel_slaves_and_sentinels_resp3(response, **options):
+    return [parse_sentinel_state_resp3(item, **options) for item in response]
 
 
-def parse_sentinel_get_master(response):
+def parse_sentinel_get_master(response, **options):
     return response and (response[0], int(response[1])) or None
 
 
diff --git a/tests/test_asyncio/test_sentinel.py b/tests/test_asyncio/test_sentinel.py
index 867ff15405..87532ae5d5 100644
--- a/tests/test_asyncio/test_sentinel.py
+++ b/tests/test_asyncio/test_sentinel.py
@@ -3,6 +3,8 @@
 
 import pytest
 import pytest_asyncio
+from redis.asyncio.client import StrictRedis
+
 import redis.asyncio.sentinel
 from redis import exceptions
 from redis.asyncio.sentinel import (
@@ -11,6 +13,7 @@
     SentinelConnectionPool,
     SlaveNotFoundError,
 )
+from tests.conftest import is_resp2_connection
 
 
 @pytest_asyncio.fixture(scope="module", loop_scope="module")
@@ -363,3 +366,33 @@ async def test_redis_master_usage(deployed_sentinel):
     r = await deployed_sentinel.master_for("redis-py-test", db=0)
     await r.set("foo", "bar")
     assert (await r.get("foo")) == "bar"
+
+
+@pytest.mark.onlynoncluster
+async def test_sentinel_commands_with_strict_redis_client(request):
+    sentinel_ips = request.config.getoption("--sentinels")
+    sentinel_host, sentinel_port = sentinel_ips.split(",")[0].split(":")
+    protocol = request.config.getoption("--protocol", 2)
+
+    client = StrictRedis(
+        host=sentinel_host, port=sentinel_port, decode_responses=True, protocol=protocol
+    )
+    # skipping commands that change the state of the sentinel setup
+    assert isinstance(
+        await client.sentinel_get_master_addr_by_name("redis-py-test"), tuple
+    )
+    assert isinstance(await client.sentinel_master("redis-py-test"), dict)
+    if is_resp2_connection(client):
+        assert isinstance(await client.sentinel_masters(), dict)
+    else:
+        masters = await client.sentinel_masters()
+        assert isinstance(masters, list)
+        for master in masters:
+            assert isinstance(master, dict)
+
+    assert isinstance(await client.sentinel_sentinels("redis-py-test"), list)
+    assert isinstance(await client.sentinel_slaves("redis-py-test"), list)
+
+    assert isinstance(await client.sentinel_ckquorum("redis-py-test"), bool)
+
+    await client.close()
diff --git a/tests/test_sentinel.py b/tests/test_sentinel.py
index 0e7624c836..fb4a2d4056 100644
--- a/tests/test_sentinel.py
+++ b/tests/test_sentinel.py
@@ -2,6 +2,8 @@
 from unittest import mock
 
 import pytest
+from redis.client import StrictRedis
+
 import redis.sentinel
 from redis import exceptions
 from redis.sentinel import (
@@ -10,6 +12,7 @@
     SentinelConnectionPool,
     SlaveNotFoundError,
 )
+from tests.conftest import is_resp2_connection
 
 
 @pytest.fixture(scope="module")
@@ -342,3 +345,31 @@ def test_redis_master_usage(deployed_sentinel):
     r = deployed_sentinel.master_for("redis-py-test", db=0)
     r.set("foo", "bar")
     assert r.get("foo") == "bar"
+
+
+@pytest.mark.onlynoncluster
+def test_sentinel_commands_with_strict_redis_client(request):
+    sentinel_ips = request.config.getoption("--sentinels")
+    sentinel_host, sentinel_port = sentinel_ips.split(",")[0].split(":")
+    protocol = request.config.getoption("--protocol", 2)
+
+    client = StrictRedis(
+        host=sentinel_host, port=sentinel_port, decode_responses=True, protocol=protocol
+    )
+    # skipping commands that change the state of the sentinel setup
+    assert isinstance(client.sentinel_get_master_addr_by_name("redis-py-test"), tuple)
+    assert isinstance(client.sentinel_master("redis-py-test"), dict)
+    if is_resp2_connection(client):
+        assert isinstance(client.sentinel_masters(), dict)
+    else:
+        masters = client.sentinel_masters()
+        assert isinstance(masters, list)
+        for master in masters:
+            assert isinstance(master, dict)
+
+    assert isinstance(client.sentinel_sentinels("redis-py-test"), list)
+    assert isinstance(client.sentinel_slaves("redis-py-test"), list)
+
+    assert isinstance(client.sentinel_ckquorum("redis-py-test"), bool)
+
+    client.close()

From 489932d97b438d05d656f1c1fea4950fb48189a9 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Mon, 3 Nov 2025 21:32:58 +0200
Subject: [PATCH 1155/1164] Adding MSETEX command support. (#3823)

* Adding MSETEX command support.

* Adding tests to validate msetex command behavior for cluster clients and pipelines in clusters

* applying review comments
---
 redis/cluster.py                    |   1 +
 redis/commands/core.py              |  88 +++++++
 tests/test_asyncio/test_commands.py | 345 ++++++++++++++++++++++++++++
 tests/test_asyncio/test_pipeline.py |  14 ++
 tests/test_commands.py              | 332 ++++++++++++++++++++++++++
 tests/test_parsers/test_errors.py   |   2 -
 tests/test_pipeline.py              |  16 ++
 7 files changed, 796 insertions(+), 2 deletions(-)

diff --git a/redis/cluster.py b/redis/cluster.py
index c238c171be..b34f3ea9da 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -2358,6 +2358,7 @@ def inner(*args, **kwargs):
     "MGET NONATOMIC",
     "MOVE",
     "MSET",
+    "MSETEX",
     "MSET NONATOMIC",
     "MSETNX",
     "PFCOUNT",
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 34086e3c09..8f3be68f32 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -1559,6 +1559,16 @@ def execute(self) -> ResponseT:
         return self.client.execute_command(*command)
 
 
+class DataPersistOptions(Enum):
+    # set the value for each provided key to each
+    # provided value only if all do not already exist.
+    NX = "NX"
+
+    # set the value for each provided key to each
+    # provided value only if all already exist.
+    XX = "XX"
+
+
 class BasicKeyCommands(CommandsProtocol):
     """
     Redis basic key-based commands
@@ -1987,6 +1997,10 @@ def mget(self, keys: KeysT, *args: EncodableT) -> ResponseT:
         """
         Returns a list of values ordered identically to ``keys``
 
+        ** Important ** When this method is used with Cluster clients, all keys
+                must be in the same hash slot, otherwise a RedisClusterException
+                will be raised.
+
         For more information, see https://redis.io/commands/mget
         """
         from redis.client import EMPTY_RESPONSE
@@ -2004,6 +2018,10 @@ def mset(self, mapping: Mapping[AnyKeyT, EncodableT]) -> ResponseT:
         key/value pairs. Both keys and values should be strings or types that
         can be cast to a string via str().
 
+        ** Important ** When this method is used with Cluster clients, all keys
+                must be in the same hash slot, otherwise a RedisClusterException
+                will be raised.
+
         For more information, see https://redis.io/commands/mset
         """
         items = []
@@ -2011,6 +2029,72 @@ def mset(self, mapping: Mapping[AnyKeyT, EncodableT]) -> ResponseT:
             items.extend(pair)
         return self.execute_command("MSET", *items)
 
+    def msetex(
+        self,
+        mapping: Mapping[AnyKeyT, EncodableT],
+        data_persist_option: Optional[DataPersistOptions] = None,
+        ex: Optional[ExpiryT] = None,
+        px: Optional[ExpiryT] = None,
+        exat: Optional[AbsExpiryT] = None,
+        pxat: Optional[AbsExpiryT] = None,
+        keepttl: bool = False,
+    ) -> Union[Awaitable[int], int]:
+        """
+        Sets key/values based on the provided ``mapping`` items.
+
+        ** Important ** When this method is used with Cluster clients, all keys
+                        must be in the same hash slot, otherwise a RedisClusterException
+                        will be raised.
+
+        ``mapping`` accepts a dict of key/value pairs that will be added to the database.
+
+        ``data_persist_option`` can be set to ``NX`` or ``XX`` to control the
+            behavior of the command.
+            ``NX`` will set the value for each provided key to each
+                provided value only if all do not already exist.
+            ``XX`` will set the value for each provided key to each
+                provided value only if all already exist.
+
+        ``ex`` sets an expire flag on the keys in ``mapping`` for ``ex`` seconds.
+
+        ``px`` sets an expire flag on the keys in ``mapping`` for ``px`` milliseconds.
+
+        ``exat`` sets an expire flag on the keys in ``mapping`` for ``exat`` seconds,
+            specified in unix time.
+
+        ``pxat`` sets an expire flag on the keys in ``mapping`` for ``pxat`` milliseconds,
+            specified in unix time.
+
+        ``keepttl`` if True, retain the time to live associated with the keys.
+
+        Returns the number of fields that were added.
+
+        Available since Redis 8.4
+        For more information, see https://redis.io/commands/msetex
+        """
+        opset = {ex, px, exat, pxat}
+        if len(opset) > 2 or len(opset) > 1 and keepttl:
+            raise DataError(
+                "``ex``, ``px``, ``exat``, ``pxat``, "
+                "and ``keepttl`` are mutually exclusive."
+            )
+
+        exp_options: list[EncodableT] = []
+        if data_persist_option:
+            exp_options.append(data_persist_option.value)
+
+        exp_options.extend(extract_expire_flags(ex, px, exat, pxat))
+
+        if keepttl:
+            exp_options.append("KEEPTTL")
+
+        pieces = ["MSETEX", len(mapping)]
+
+        for pair in mapping.items():
+            pieces.extend(pair)
+
+        return self.execute_command(*pieces, *exp_options)
+
     def msetnx(self, mapping: Mapping[AnyKeyT, EncodableT]) -> ResponseT:
         """
         Sets key/values based on a mapping if none of the keys are already set.
@@ -2018,6 +2102,10 @@ def msetnx(self, mapping: Mapping[AnyKeyT, EncodableT]) -> ResponseT:
         should be strings or types that can be cast to a string via str().
         Returns a boolean indicating if the operation was successful.
 
+        ** Important ** When this method is used with Cluster clients, all keys
+                        must be in the same hash slot, otherwise a RedisClusterException
+                        will be raised.
+
         For more information, see https://redis.io/commands/msetnx
         """
         items = []
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 14690ef6e6..cf25118022 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -11,6 +11,7 @@
 
 import pytest
 import pytest_asyncio
+from redis import RedisClusterException
 import redis
 from redis import exceptions
 from redis._parsers.helpers import (
@@ -20,6 +21,7 @@
     parse_info,
 )
 from redis.client import EMPTY_RESPONSE, NEVER_DECODE
+from redis.commands.core import DataPersistOptions
 from redis.commands.json.path import Path
 from redis.commands.search.field import TextField
 from redis.commands.search.query import Query
@@ -1199,6 +1201,349 @@ async def test_mset(self, r: redis.Redis):
         for k, v in d.items():
             assert await r.get(k) == v
 
+    @pytest.mark.onlycluster
+    async def test_mset_on_cluster(self, r):
+        # validate that mset command works in cluster client
+        # when the keys are in the same slot
+        d = {"a:{test:1}": b"1", "b:{test:1}": b"2", "c:{test:1}": b"3"}
+        assert await r.mset(d)
+        for k, v in d.items():
+            assert await r.get(k) == v
+
+    @pytest.mark.onlycluster
+    async def test_mset_on_cluster_multiple_slots(self, r):
+        d = {"a": b"1", "b": b"2", "c": b"3"}
+        with pytest.raises(RedisClusterException):
+            assert await r.mset(d)
+
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("8.3.224")
+    async def test_msetex_no_expiration_with_cluster_client(self, r):
+        all_test_keys = ["1:{test:1}", "2:{test:1}"]
+        for key in all_test_keys:
+            await r.delete(key)
+
+        # set items from mapping without expiration
+        assert await r.msetex(mapping={"1:{test:1}": 1, "2:{test:1}": b"four"}) == 1
+        assert await r.mget("1:{test:1}", "2:{test:1}") == [b"1", b"four"]
+        assert await r.ttl("1:{test:1}") == -1
+        assert await r.ttl("2:{test:1}") == -1
+
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("8.3.224")
+    async def test_msetex_expiration_ex_and_keepttl_with_cluster_client(self, r):
+        all_test_keys = ["1:{test:1}", "2:{test:1}"]
+        for key in all_test_keys:
+            await r.delete(key)
+
+        # set items from mapping with expiration - testing ex field
+        assert (
+            await r.msetex(
+                mapping={"1:{test:1}": 1, "2:{test:1}": "2"},
+                ex=10,
+            )
+            == 1
+        )
+        ttls = await asyncio.gather(*[r.ttl(key) for key in all_test_keys])
+        for ttl in ttls:
+            assert pytest.approx(ttl) == 10
+
+        assert await r.mget(*all_test_keys) == [b"1", b"2"]
+        await asyncio.sleep(1.1)
+        # validate keepttl
+        assert await r.msetex(mapping={"1:{test:1}": 11}, keepttl=True) == 1
+        assert await r.ttl("1:{test:1}") < 10
+
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("8.3.224")
+    async def test_msetex_expiration_px_with_cluster_client(self, r):
+        all_test_keys = ["1:{test:1}", "2:{test:1}"]
+        for key in all_test_keys:
+            await r.delete(key)
+
+        mapping = {"1:{test:1}": 1, "2:{test:1}": "2"}
+        # set key/value pairs provided in mapping
+        # with expiration - testing px field
+        assert await r.msetex(mapping=mapping, px=60000) == 1
+
+        ttls = await asyncio.gather(*[r.ttl(key) for key in mapping.keys()])
+        for ttl in ttls:
+            assert pytest.approx(ttl) == 60
+        assert await r.mget(*mapping.keys()) == [b"1", b"2"]
+
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("8.3.224")
+    async def test_msetex_expiration_pxat_and_nx_with_cluster_client(self, r):
+        all_test_keys = [
+            "1:{test:1}",
+            "2:{test:1}",
+            "3:{test:1}",
+            "new:{test:1}",
+            "new_2:{test:1}",
+        ]
+        for key in all_test_keys:
+            await r.delete(key)
+
+        mapping = {"1:{test:1}": 1, "2:{test:1}": "2", "3:{test:1}": "three"}
+        assert await r.msetex(mapping=mapping, ex=30) == 1
+
+        # NX is set with existing keys - nothing should be saved or updated
+        expire_at = await redis_server_time(r) + datetime.timedelta(seconds=10)
+        assert (
+            await r.msetex(
+                mapping={"1:{test:1}": "new_value", "new:{test:1}": "ok"},
+                pxat=expire_at,
+                data_persist_option=DataPersistOptions.NX,
+            )
+            == 0
+        )
+        ttls = await asyncio.gather(*[r.ttl(key) for key in mapping.keys()])
+        for ttl in ttls:
+            assert 10 < ttl <= 30
+        assert await r.mget(*mapping.keys(), "new:{test:1}") == [
+            b"1",
+            b"2",
+            b"three",
+            None,
+        ]
+
+        # NX is set with non existing keys - values should be set
+        assert (
+            await r.msetex(
+                mapping={"new:{test:1}": "ok", "new_2:{test:1}": "ok_2"},
+                pxat=expire_at,
+                data_persist_option=DataPersistOptions.NX,
+            )
+            == 1
+        )
+        old_ttls = await asyncio.gather(*[r.ttl(key) for key in mapping.keys()])
+        new_ttls = await asyncio.gather(*(r.ttl(key) for key in ["new", "new_2"]))
+        for ttl in old_ttls:
+            assert 10 < ttl <= 30
+        for ttl in new_ttls:
+            assert ttl <= 10
+        assert await r.mget(*mapping.keys(), "new:{test:1}", "new_2:{test:1}") == [
+            b"1",
+            b"2",
+            b"three",
+            b"ok",
+            b"ok_2",
+        ]
+
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("8.3.224")
+    async def test_msetex_expiration_exat_and_xx_with_cluster_client(self, r):
+        all_test_keys = ["1:{test:1}", "2:{test:1}", "3:{test:1}", "new:{test:1}"]
+        for key in all_test_keys:
+            await r.delete(key)
+
+        mapping = {"1:{test:1}": 1, "2:{test:1}": "2", "3:{test:1}": "three"}
+        assert await r.msetex(mapping, ex=30) == 1
+
+        expire_at = await redis_server_time(r) + datetime.timedelta(seconds=10)
+        ## XX is set with unexisting key - nothing should be saved or updated
+        assert (
+            await r.msetex(
+                mapping={"1:{test:1}": "new_value", "new:{test:1}": "ok"},
+                exat=expire_at,
+                data_persist_option=DataPersistOptions.XX,
+            )
+            == 0
+        )
+        ttls = await asyncio.gather(*[r.ttl(key) for key in mapping.keys()])
+        for ttl in ttls:
+            assert 10 < ttl <= 30
+        assert await r.mget(*mapping.keys(), "new:{test:1}") == [
+            b"1",
+            b"2",
+            b"three",
+            None,
+        ]
+
+        # XX is set with existing keys - values should be updated
+        assert (
+            await r.msetex(
+                mapping={"1:{test:1}": "new_value", "2:{test:1}": "new_value_2"},
+                exat=expire_at,
+                data_persist_option=DataPersistOptions.XX,
+            )
+            == 1
+        )
+        ttls = await asyncio.gather(*[r.ttl(key) for key in mapping.keys()])
+        assert ttls[0] <= 10
+        assert ttls[1] <= 10
+        assert 10 < ttls[2] <= 30
+        assert await r.mget(
+            "1:{test:1}", "2:{test:1}", "3:{test:1}", "new:{test:1}"
+        ) == [
+            b"new_value",
+            b"new_value_2",
+            b"three",
+            None,
+        ]
+
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("8.3.224")
+    async def test_msetex_invalid_inputs_with_cluster_client(self, r):
+        mapping = {"1": 1, "2": "2", "3": "three"}
+        with pytest.raises(exceptions.RedisClusterException):
+            await r.msetex(mapping)
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.3.224")
+    async def test_msetex_no_expiration(self, r):
+        all_test_keys = ["1", "2"]
+        for key in all_test_keys:
+            await r.delete(key)
+
+        # # set items from mapping without expiration
+        assert await r.msetex(mapping={"1": 1, "2": b"four"}) == 1
+        assert await r.mget("1", "2") == [b"1", b"four"]
+        assert await r.ttl("1") == -1
+        assert await r.ttl("2") == -1
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.3.224")
+    async def test_msetex_expiration_ex_and_keepttl(self, r):
+        all_test_keys = ["1", "2"]
+        for key in all_test_keys:
+            await r.delete(key)
+
+        # set items from mapping with expiration - testing ex field
+        assert (
+            await r.msetex(
+                mapping={"1": 1, "2": "2"},
+                ex=10,
+            )
+            == 1
+        )
+        ttls = await asyncio.gather(*[r.ttl(key) for key in all_test_keys])
+        for ttl in ttls:
+            assert pytest.approx(ttl) == 10
+
+        assert await r.mget(*all_test_keys) == [b"1", b"2"]
+        await asyncio.sleep(1.1)
+        # validate keepttl
+        assert await r.msetex(mapping={"1": 11}, keepttl=True) == 1
+        assert await r.ttl("1") < 10
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.3.224")
+    async def test_msetex_expiration_px(self, r):
+        all_test_keys = ["1", "2"]
+        for key in all_test_keys:
+            await r.delete(key)
+
+        mapping = {"1": 1, "2": "2"}
+        # set key/value pairs provided in mapping
+        # with expiration - testing px field
+        assert await r.msetex(mapping=mapping, px=60000) == 1
+
+        ttls = await asyncio.gather(*[r.ttl(key) for key in mapping.keys()])
+        for ttl in ttls:
+            assert pytest.approx(ttl) == 60
+        assert await r.mget(*mapping.keys()) == [b"1", b"2"]
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.3.224")
+    async def test_msetex_expiration_pxat_and_nx(self, r):
+        all_test_keys = ["1", "2", "3", "new", "new_2"]
+        for key in all_test_keys:
+            await r.delete(key)
+
+        mapping = {"1": 1, "2": "2", "3": "three"}
+        assert await r.msetex(mapping=mapping, ex=30) == 1
+
+        # NX is set with existing keys - nothing should be saved or updated
+        expire_at = await redis_server_time(r) + datetime.timedelta(seconds=10)
+        assert (
+            await r.msetex(
+                mapping={"1": "new_value", "new": "ok"},
+                pxat=expire_at,
+                data_persist_option=DataPersistOptions.NX,
+            )
+            == 0
+        )
+        ttls = await asyncio.gather(*[r.ttl(key) for key in mapping.keys()])
+        for ttl in ttls:
+            assert 10 < ttl <= 30
+        assert await r.mget(*mapping.keys(), "new") == [b"1", b"2", b"three", None]
+
+        # NX is set with non existing keys - values should be set
+        assert (
+            await r.msetex(
+                mapping={"new": "ok", "new_2": "ok_2"},
+                pxat=expire_at,
+                data_persist_option=DataPersistOptions.NX,
+            )
+            == 1
+        )
+        old_ttls = await asyncio.gather(*[r.ttl(key) for key in mapping.keys()])
+        new_ttls = await asyncio.gather(*(r.ttl(key) for key in ["new", "new_2"]))
+        for ttl in old_ttls:
+            assert 10 < ttl <= 30
+        for ttl in new_ttls:
+            assert ttl <= 10
+        assert await r.mget(*mapping.keys(), "new", "new_2") == [
+            b"1",
+            b"2",
+            b"three",
+            b"ok",
+            b"ok_2",
+        ]
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.3.224")
+    async def test_msetex_expiration_exat_and_xx(self, r):
+        all_test_keys = ["1", "2", "3", "new"]
+        for key in all_test_keys:
+            await r.delete(key)
+
+        mapping = {"1": 1, "2": "2", "3": "three"}
+        assert await r.msetex(mapping, ex=30) == 1
+
+        expire_at = await redis_server_time(r) + datetime.timedelta(seconds=10)
+        ## XX is set with unexisting key - nothing should be saved or updated
+        assert (
+            await r.msetex(
+                mapping={"1": "new_value", "new": "ok"},
+                exat=expire_at,
+                data_persist_option=DataPersistOptions.XX,
+            )
+            == 0
+        )
+        ttls = await asyncio.gather(*[r.ttl(key) for key in mapping.keys()])
+        for ttl in ttls:
+            assert 10 < ttl <= 30
+        assert await r.mget(*mapping.keys(), "new") == [b"1", b"2", b"three", None]
+
+        # XX is set with existing keys - values should be updated
+        assert (
+            await r.msetex(
+                mapping={"1": "new_value", "2": "new_value_2"},
+                exat=expire_at,
+                data_persist_option=DataPersistOptions.XX,
+            )
+            == 1
+        )
+        ttls = await asyncio.gather(*[r.ttl(key) for key in mapping.keys()])
+        assert ttls[0] <= 10
+        assert ttls[1] <= 10
+        assert 10 < ttls[2] <= 30
+        assert await r.mget("1", "2", "3", "new") == [
+            b"new_value",
+            b"new_value_2",
+            b"three",
+            None,
+        ]
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.3.224")
+    async def test_msetex_invalid_inputs(self, r):
+        mapping = {"1": 1, "2": "2"}
+        with pytest.raises(exceptions.DataError):
+            await r.msetex(mapping, ex=10, keepttl=True)
+
     @pytest.mark.onlynoncluster
     async def test_msetnx(self, r: redis.Redis):
         d = {"a": b"1", "b": b"2", "c": b"3"}
diff --git a/tests/test_asyncio/test_pipeline.py b/tests/test_asyncio/test_pipeline.py
index 1f8c743b48..65c8860026 100644
--- a/tests/test_asyncio/test_pipeline.py
+++ b/tests/test_asyncio/test_pipeline.py
@@ -1,6 +1,7 @@
 from unittest import mock
 
 import pytest
+from redis import RedisClusterException
 import redis
 from tests.conftest import skip_if_server_version_lt
 
@@ -445,3 +446,16 @@ async def test_send_set_commands_over_async_pipeline(self, r: redis.asyncio.Redi
         pipe.hgetall("hash:1")
         resp = await pipe.execute()
         assert resp == [1, 1, 1, {b"bar": b"foo", b"baz": b"bar", b"foo": b"bar"}]
+
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("8.3.224")
+    async def test_pipeline_with_msetex(self, r):
+        p = r.pipeline()
+        with pytest.raises(RedisClusterException):
+            p.msetex({"key1": "value1", "key2": "value2"}, ex=1000)
+
+        p_transaction = r.pipeline(transaction=True)
+        with pytest.raises(RedisClusterException):
+            p_transaction.msetex(
+                {"key1_transaction": "value1", "key2_transaction": "value2"}, ex=10
+            )
diff --git a/tests/test_commands.py b/tests/test_commands.py
index c5974ea0fc..68017236ee 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -9,6 +9,7 @@
 from unittest.mock import patch
 
 import pytest
+from redis import RedisClusterException
 import redis
 from redis import exceptions
 from redis._parsers.helpers import (
@@ -18,6 +19,7 @@
     parse_info,
 )
 from redis.client import EMPTY_RESPONSE, NEVER_DECODE
+from redis.commands.core import DataPersistOptions
 from redis.commands.json.path import Path
 from redis.commands.search.field import TextField
 from redis.commands.search.query import Query
@@ -1798,6 +1800,336 @@ def test_mset(self, r):
         for k, v in d.items():
             assert r[k] == v
 
+    @pytest.mark.onlycluster
+    def test_mset_on_cluster(self, r):
+        # validate that mset command works in cluster client
+        # when the keys are in the same slot
+        d = {"a:{test:1}": b"1", "b:{test:1}": b"2", "c:{test:1}": b"3"}
+        assert r.mset(d)
+        for k, v in d.items():
+            assert r[k] == v
+
+    @pytest.mark.onlycluster
+    def test_mset_on_cluster_multiple_slots(self, r):
+        d = {"a": b"1", "b": b"2", "c": b"3"}
+        with pytest.raises(RedisClusterException):
+            assert r.mset(d)
+
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("8.3.224")
+    def test_msetex_no_expiration_with_cluster_client(self, r):
+        all_test_keys = ["1:{test:1}", "2:{test:1}"]
+        for key in all_test_keys:
+            r.delete(key)
+
+        # set items from mapping without expiration
+        assert r.msetex(mapping={"1:{test:1}": 1, "2:{test:1}": b"four"}) == 1
+        assert r.mget("1:{test:1}", "2:{test:1}") == [b"1", b"four"]
+        assert r.ttl("1:{test:1}") == -1
+        assert r.ttl("2:{test:1}") == -1
+
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("8.3.224")
+    def test_msetex_expiration_ex_and_keepttl_with_cluster_client(self, r):
+        all_test_keys = ["1:{test:1}", "2:{test:1}"]
+        for key in all_test_keys:
+            r.delete(key)
+
+        # set items from mapping with expiration - testing ex field
+        assert (
+            r.msetex(
+                mapping={"1:{test:1}": 1, "2:{test:1}": "2"},
+                ex=10,
+            )
+            == 1
+        )
+        ttls = [r.ttl(key) for key in all_test_keys]
+        for ttl in ttls:
+            assert pytest.approx(ttl) == 10
+
+        assert r.mget(*all_test_keys) == [b"1", b"2"]
+        time.sleep(1.1)
+        # validate keepttl
+        assert r.msetex(mapping={"1:{test:1}": 11}, keepttl=True) == 1
+        assert r.ttl("1:{test:1}") < 10
+
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("8.3.224")
+    def test_msetex_expiration_px_with_cluster_client(self, r):
+        all_test_keys = ["1:{test:1}", "2:{test:1}"]
+        for key in all_test_keys:
+            r.delete(key)
+
+        mapping = {"1:{test:1}": 1, "2:{test:1}": "2"}
+        # set key/value pairs provided in mapping
+        # with expiration - testing px field
+        assert r.msetex(mapping=mapping, px=60000) == 1
+
+        ttls = [r.ttl(key) for key in mapping.keys()]
+        for ttl in ttls:
+            assert pytest.approx(ttl) == 60
+        assert r.mget(*mapping.keys()) == [b"1", b"2"]
+
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("8.3.224")
+    def test_msetex_expiration_pxat_and_nx_with_cluster_client(self, r):
+        all_test_keys = [
+            "1:{test:1}",
+            "2:{test:1}",
+            "3:{test:1}",
+            "new:{test:1}",
+            "new_2:{test:1}",
+        ]
+        for key in all_test_keys:
+            r.delete(key)
+
+        mapping = {"1:{test:1}": 1, "2:{test:1}": "2", "3:{test:1}": "three"}
+        assert r.msetex(mapping=mapping, ex=30) == 1
+
+        # NX is set with existing keys - nothing should be saved or updated
+        expire_at = redis_server_time(r) + datetime.timedelta(seconds=10)
+        assert (
+            r.msetex(
+                mapping={"1:{test:1}": "new_value", "new:{test:1}": "ok"},
+                pxat=expire_at,
+                data_persist_option=DataPersistOptions.NX,
+            )
+            == 0
+        )
+        ttls = [r.ttl(key) for key in mapping.keys()]
+        for ttl in ttls:
+            assert 10 < ttl <= 30
+        assert r.mget(*mapping.keys(), "new:{test:1}") == [b"1", b"2", b"three", None]
+
+        # NX is set with non existing keys - values should be set
+        assert (
+            r.msetex(
+                mapping={"new:{test:1}": "ok", "new_2:{test:1}": "ok_2"},
+                pxat=expire_at,
+                data_persist_option=DataPersistOptions.NX,
+            )
+            == 1
+        )
+        old_ttls = [r.ttl(key) for key in mapping.keys()]
+        new_ttls = [r.ttl(key) for key in ["new:{test:1}", "new_2:{test:1}"]]
+        for ttl in old_ttls:
+            assert 10 < ttl <= 30
+        for ttl in new_ttls:
+            assert ttl <= 10
+        assert r.mget(*mapping.keys(), "new:{test:1}", "new_2:{test:1}") == [
+            b"1",
+            b"2",
+            b"three",
+            b"ok",
+            b"ok_2",
+        ]
+
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("8.3.224")
+    def test_msetex_expiration_exat_and_xx_with_cluster_client(self, r):
+        all_test_keys = ["1:{test:1}", "2:{test:1}", "3:{test:1}", "new:{test:1}"]
+        for key in all_test_keys:
+            r.delete(key)
+
+        mapping = {"1:{test:1}": 1, "2:{test:1}": "2", "3:{test:1}": "three"}
+        assert r.msetex(mapping, ex=30) == 1
+
+        expire_at = redis_server_time(r) + datetime.timedelta(seconds=10)
+        ## XX is set with unexisting key - nothing should be saved or updated
+        assert (
+            r.msetex(
+                mapping={"1:{test:1}": "new_value", "new:{test:1}": "ok"},
+                exat=expire_at,
+                data_persist_option=DataPersistOptions.XX,
+            )
+            == 0
+        )
+        ttls = [r.ttl(key) for key in mapping.keys()]
+        for ttl in ttls:
+            assert 10 < ttl <= 30
+        assert r.mget(*mapping.keys(), "new:{test:1}") == [b"1", b"2", b"three", None]
+
+        # XX is set with existing keys - values should be updated
+        assert (
+            r.msetex(
+                mapping={"1:{test:1}": "new_value", "2:{test:1}": "new_value_2"},
+                exat=expire_at,
+                data_persist_option=DataPersistOptions.XX,
+            )
+            == 1
+        )
+        ttls = [r.ttl(key) for key in mapping.keys()]
+        assert ttls[0] <= 10
+        assert ttls[1] <= 10
+        assert 10 < ttls[2] <= 30
+        assert r.mget("1:{test:1}", "2:{test:1}", "3:{test:1}", "new:{test:1}") == [
+            b"new_value",
+            b"new_value_2",
+            b"three",
+            None,
+        ]
+
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("8.3.224")
+    def test_msetex_invalid_inputs_with_cluster_client(self, r):
+        mapping = {"1": 1, "2": "2", "3": "three"}
+        with pytest.raises(exceptions.RedisClusterException):
+            r.msetex(mapping)
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.3.224")
+    def test_msetex_no_expiration(self, r):
+        all_test_keys = ["1", "2"]
+        for key in all_test_keys:
+            r.delete(key)
+
+        # # set items from mapping without expiration
+        assert r.msetex(mapping={"1": 1, "2": b"four"}) == 1
+        assert r.mget("1", "2") == [b"1", b"four"]
+        assert r.ttl("1") == -1
+        assert r.ttl("2") == -1
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.3.224")
+    def test_msetex_expiration_ex_and_keepttl(self, r):
+        all_test_keys = ["1", "2"]
+        for key in all_test_keys:
+            r.delete(key)
+
+        # set items from mapping with expiration - testing ex field
+        assert (
+            r.msetex(
+                mapping={"1": 1, "2": "2"},
+                ex=10,
+            )
+            == 1
+        )
+        ttls = [r.ttl(key) for key in all_test_keys]
+        for ttl in ttls:
+            assert pytest.approx(ttl) == 10
+
+        assert r.mget(*all_test_keys) == [b"1", b"2"]
+        time.sleep(1.1)
+        # validate keepttl
+        assert r.msetex(mapping={"1": 11}, keepttl=True) == 1
+        assert r.ttl("1") < 10
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.3.224")
+    def test_msetex_expiration_px(self, r):
+        all_test_keys = ["1", "2"]
+        for key in all_test_keys:
+            r.delete(key)
+
+        mapping = {"1": 1, "2": "2"}
+        # set key/value pairs provided in mapping
+        # with expiration - testing px field
+        assert r.msetex(mapping=mapping, px=60000) == 1
+
+        ttls = [r.ttl(key) for key in mapping.keys()]
+        for ttl in ttls:
+            assert pytest.approx(ttl) == 60
+        assert r.mget(*mapping.keys()) == [b"1", b"2"]
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.3.224")
+    def test_msetex_expiration_pxat_and_nx(self, r):
+        all_test_keys = ["1", "2", "3", "new", "new_2"]
+        for key in all_test_keys:
+            r.delete(key)
+
+        mapping = {"1": 1, "2": "2", "3": "three"}
+        assert r.msetex(mapping=mapping, ex=30) == 1
+
+        # NX is set with existing keys - nothing should be saved or updated
+        expire_at = redis_server_time(r) + datetime.timedelta(seconds=10)
+        assert (
+            r.msetex(
+                mapping={"1": "new_value", "new": "ok"},
+                pxat=expire_at,
+                data_persist_option=DataPersistOptions.NX,
+            )
+            == 0
+        )
+        ttls = [r.ttl(key) for key in mapping.keys()]
+        for ttl in ttls:
+            assert 10 < ttl <= 30
+        assert r.mget(*mapping.keys(), "new") == [b"1", b"2", b"three", None]
+
+        # NX is set with non existing keys - values should be set
+        assert (
+            r.msetex(
+                mapping={"new": "ok", "new_2": "ok_2"},
+                pxat=expire_at,
+                data_persist_option=DataPersistOptions.NX,
+            )
+            == 1
+        )
+        old_ttls = [r.ttl(key) for key in mapping.keys()]
+        new_ttls = [r.ttl(key) for key in ["new", "new_2"]]
+        for ttl in old_ttls:
+            assert 10 < ttl <= 30
+        for ttl in new_ttls:
+            assert ttl <= 10
+        assert r.mget(*mapping.keys(), "new", "new_2") == [
+            b"1",
+            b"2",
+            b"three",
+            b"ok",
+            b"ok_2",
+        ]
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.3.224")
+    def test_msetex_expiration_exat_and_xx(self, r):
+        all_test_keys = ["1", "2", "3", "new"]
+        for key in all_test_keys:
+            r.delete(key)
+
+        mapping = {"1": 1, "2": "2", "3": "three"}
+        assert r.msetex(mapping, ex=30) == 1
+
+        expire_at = redis_server_time(r) + datetime.timedelta(seconds=10)
+        ## XX is set with unexisting key - nothing should be saved or updated
+        assert (
+            r.msetex(
+                mapping={"1": "new_value", "new": "ok"},
+                exat=expire_at,
+                data_persist_option=DataPersistOptions.XX,
+            )
+            == 0
+        )
+        ttls = [r.ttl(key) for key in mapping.keys()]
+        for ttl in ttls:
+            assert 10 < ttl <= 30
+        assert r.mget(*mapping.keys(), "new") == [b"1", b"2", b"three", None]
+
+        # XX is set with existing keys - values should be updated
+        assert (
+            r.msetex(
+                mapping={"1": "new_value", "2": "new_value_2"},
+                exat=expire_at,
+                data_persist_option=DataPersistOptions.XX,
+            )
+            == 1
+        )
+        ttls = [r.ttl(key) for key in mapping.keys()]
+        assert ttls[0] <= 10
+        assert ttls[1] <= 10
+        assert 10 < ttls[2] <= 30
+        assert r.mget("1", "2", "3", "new") == [
+            b"new_value",
+            b"new_value_2",
+            b"three",
+            None,
+        ]
+
+    @skip_if_server_version_lt("8.3.224")
+    def test_msetex_invalid_inputs(self, r):
+        mapping = {"1": 1, "2": "2"}
+        with pytest.raises(exceptions.DataError):
+            r.msetex(mapping, ex=10, keepttl=True)
+
     @pytest.mark.onlynoncluster
     def test_msetnx(self, r):
         d = {"a": b"1", "b": b"2", "c": b"3"}
diff --git a/tests/test_parsers/test_errors.py b/tests/test_parsers/test_errors.py
index 8081e6481b..295aa21e42 100644
--- a/tests/test_parsers/test_errors.py
+++ b/tests/test_parsers/test_errors.py
@@ -4,7 +4,6 @@
 import pytest
 from redis.client import Redis
 from redis.exceptions import ExternalAuthProviderError
-from tests.conftest import skip_if_hiredis_parser
 
 
 class MockSocket:
@@ -155,7 +154,6 @@ def teardown_method(self):
         self.socket_patcher.stop()
         self.select_patcher.stop()
 
-    @skip_if_hiredis_parser()
     @pytest.mark.parametrize("protocol_version", [2, 3])
     def test_external_auth_provider_error(self, protocol_version):
         client = Redis(
diff --git a/tests/test_pipeline.py b/tests/test_pipeline.py
index bbf1ec9eb5..a395934920 100644
--- a/tests/test_pipeline.py
+++ b/tests/test_pipeline.py
@@ -2,6 +2,7 @@
 from unittest import mock
 
 import pytest
+from redis import RedisClusterException
 import redis
 
 from .conftest import skip_if_server_version_lt, wait_for_command
@@ -438,3 +439,18 @@ def test_send_set_commands_over_pipeline(self, r: redis.Redis):
         pipe.hgetall("hash:1")
         resp = pipe.execute()
         assert resp == [1, 1, 1, {b"bar": b"foo", b"baz": b"bar", b"foo": b"bar"}]
+
+    @pytest.mark.onlycluster
+    @skip_if_server_version_lt("8.3.224")
+    def test_pipeline_with_msetex(self, r):
+        r.delete("key1", "key2", "key1_transaction", "key2_transaction")
+
+        p = r.pipeline()
+        with pytest.raises(RedisClusterException):
+            p.msetex({"key1": "value1", "key2": "value2"}, ex=1000)
+
+        p_transaction = r.pipeline(transaction=True)
+        with pytest.raises(RedisClusterException):
+            p_transaction.msetex(
+                {"key1_transaction": "value1", "key2_transaction": "value2"}, ex=10
+            )

From bb7ae745abecc9c6237c1d24e907d3d31cc12a68 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 4 Nov 2025 09:52:46 +0200
Subject: [PATCH 1156/1164] Adding CLAIM option to XREADGROUP command + unit
 tests (#3825)

---
 redis/_parsers/helpers.py           |  17 +-
 redis/commands/core.py              |  15 +-
 tests/test_asyncio/test_commands.py | 356 +++++++++++++++++++++++++++-
 tests/test_commands.py              | 318 ++++++++++++++++++++++++-
 4 files changed, 697 insertions(+), 9 deletions(-)

diff --git a/redis/_parsers/helpers.py b/redis/_parsers/helpers.py
index bf3b2ee2f2..b6c3feb877 100644
--- a/redis/_parsers/helpers.py
+++ b/redis/_parsers/helpers.py
@@ -268,13 +268,16 @@ def sort_return_tuples(response, **options):
     return list(zip(*[response[i::n] for i in range(n)]))
 
 
-def parse_stream_list(response):
+def parse_stream_list(response, **options):
     if response is None:
         return None
     data = []
     for r in response:
         if r is not None:
-            data.append((r[0], pairs_to_dict(r[1])))
+            if "claim_min_idle_time" in options:
+                data.append((r[0], pairs_to_dict(r[1]), *r[2:]))
+            else:
+                data.append((r[0], pairs_to_dict(r[1])))
         else:
             data.append((None, None))
     return data
@@ -332,16 +335,18 @@ def parse_xinfo_stream(response, **options):
     return data
 
 
-def parse_xread(response):
+def parse_xread(response, **options):
     if response is None:
         return []
-    return [[r[0], parse_stream_list(r[1])] for r in response]
+    return [[r[0], parse_stream_list(r[1], **options)] for r in response]
 
 
-def parse_xread_resp3(response):
+def parse_xread_resp3(response, **options):
     if response is None:
         return {}
-    return {key: [parse_stream_list(value)] for key, value in response.items()}
+    return {
+        key: [parse_stream_list(value, **options)] for key, value in response.items()
+    }
 
 
 def parse_xpending(response, **options):
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 8f3be68f32..7b9ba7295c 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -4101,6 +4101,7 @@ def xreadgroup(
         count: Optional[int] = None,
         block: Optional[int] = None,
         noack: bool = False,
+        claim_min_idle_time: Optional[int] = None,
     ) -> ResponseT:
         """
         Read from a stream via a consumer group.
@@ -4118,8 +4119,12 @@ def xreadgroup(
         block: number of milliseconds to wait, if nothing already present.
         noack: do not add messages to the PEL
 
+        claim_min_idle_time: accepts an integer type and represents a
+                             time interval in milliseconds
+
         For more information, see https://redis.io/commands/xreadgroup
         """
+        options = {}
         pieces: list[EncodableT] = [b"GROUP", groupname, consumername]
         if count is not None:
             if not isinstance(count, int) or count < 1:
@@ -4133,12 +4138,20 @@ def xreadgroup(
             pieces.append(str(block))
         if noack:
             pieces.append(b"NOACK")
+        if claim_min_idle_time is not None:
+            if not isinstance(claim_min_idle_time, int) or claim_min_idle_time < 0:
+                raise DataError(
+                    "XREADGROUP claim_min_idle_time must be a non-negative integer"
+                )
+            pieces.append(b"CLAIM")
+            pieces.append(claim_min_idle_time)
+            options["claim_min_idle_time"] = claim_min_idle_time
         if not isinstance(streams, dict) or len(streams) == 0:
             raise DataError("XREADGROUP streams must be a non empty dict")
         pieces.append(b"STREAMS")
         pieces.extend(streams.keys())
         pieces.extend(streams.values())
-        return self.execute_command("XREADGROUP", *pieces)
+        return self.execute_command("XREADGROUP", *pieces, **options)
 
     def xrevrange(
         self,
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index cf25118022..1072779192 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -11,7 +11,7 @@
 
 import pytest
 import pytest_asyncio
-from redis import RedisClusterException
+from redis import RedisClusterException, ResponseError
 import redis
 from redis import exceptions
 from redis._parsers.helpers import (
@@ -3821,6 +3821,360 @@ async def test_xreadgroup(self, r: redis.Redis):
             r, res, [[strem_name, expected_entries]], {strem_name: [expected_entries]}
         )
 
+    def _validate_xreadgroup_with_claim_min_idle_time_response(
+        self, r, response, expected_entries
+    ):
+        # validate the number of streams
+        assert len(response) == len(expected_entries)
+
+        expected_streams = expected_entries.keys()
+        for str_index, expected_stream in enumerate(expected_streams):
+            expected_entries_per_stream = expected_entries[expected_stream]
+
+            if is_resp2_connection(r):
+                actual_entries_per_stream = response[str_index][1]
+                actual_stream = response[str_index][0]
+                assert actual_stream == expected_stream
+            else:
+                actual_entries_per_stream = response[expected_stream][0]
+
+            # validate the number of entries
+            assert len(actual_entries_per_stream) == len(expected_entries_per_stream)
+
+            for i, entry in enumerate(actual_entries_per_stream):
+                message = (entry[0], entry[1])
+                message_idle = int(entry[2])
+                message_delivered_count = int(entry[3])
+
+                expected_idle = expected_entries_per_stream[i]["min_idle_time"]
+
+                assert message == expected_entries_per_stream[i]["msg"]
+                if expected_idle == 0:
+                    assert message_idle == 0
+                    assert message_delivered_count == 0
+                else:
+                    assert message_idle >= expected_idle
+                    assert message_delivered_count > 0
+
+    @skip_if_server_version_lt("8.3.224")
+    async def test_xreadgroup_with_claim_min_idle_time(self, r):
+        stream = "stream"
+        group = "group"
+        consumer_1 = "c1"
+        stream_name = stream.encode()
+
+        try:
+            # before test cleanup
+            await r.xgroup_destroy(stream, group)
+        except ResponseError:
+            pass
+
+        m1 = await r.xadd(stream, {"key_m1": "val_m1"})
+        m2 = await r.xadd(stream, {"key_m2": "val_m2"})
+
+        await r.xgroup_create(stream, group, 0)
+
+        # read all the messages - this will save the msgs in PEL
+        await r.xreadgroup(group, consumer_1, streams={stream: ">"})
+
+        # wait for 100ms - so that the messages would have been in the PEL for long enough
+        await asyncio.sleep(0.1)
+
+        m3 = await r.xadd(stream, {"key_m3": "val_m3"})
+        m4 = await r.xadd(stream, {"key_m4": "val_m4"})
+
+        expected_entries = {
+            stream_name: [
+                {"msg": await get_stream_message(r, stream, m1), "min_idle_time": 100},
+                {"msg": await get_stream_message(r, stream, m2), "min_idle_time": 100},
+                {"msg": await get_stream_message(r, stream, m3), "min_idle_time": 0},
+                {"msg": await get_stream_message(r, stream, m4), "min_idle_time": 0},
+            ]
+        }
+
+        res = await r.xreadgroup(
+            group, consumer_1, streams={stream: ">"}, claim_min_idle_time=100
+        )
+
+        self._validate_xreadgroup_with_claim_min_idle_time_response(
+            r, res, expected_entries
+        )
+
+        # validate PEL still holds the messages until they are acknowledged
+        response = await r.xpending_range(stream, group, min="-", max="+", count=5)
+        assert len(response) == 4
+
+        # add 2 more messages
+        m5 = await r.xadd(stream, {"key_m5": "val_m5"})
+        m6 = await r.xadd(stream, {"key_m6": "val_m6"})
+
+        expected_entries = [
+            await get_stream_message(r, stream, m5),
+            await get_stream_message(r, stream, m6),
+        ]
+        # read all the messages - this will save the msgs in PEL
+        res = await r.xreadgroup(group, consumer_1, streams={stream: ">"})
+        assert_resp_response(
+            r,
+            res,
+            [[stream_name, expected_entries]],
+            {stream_name: [expected_entries]},
+        )
+
+        # add 2 more messages
+        m7 = await r.xadd(stream, {"key_m7": "val_m7"})
+        m8 = await r.xadd(stream, {"key_m8": "val_m8"})
+        # read the messages with claim_min_idle_time=1000
+        # only m7 and m8 should be returned
+        # because the other messages have not been in the PEL for long enough
+        expected_entries = {
+            stream_name: [
+                {"msg": await get_stream_message(r, stream, m7), "min_idle_time": 0},
+                {"msg": await get_stream_message(r, stream, m8), "min_idle_time": 0},
+            ]
+        }
+        res = await r.xreadgroup(
+            group, consumer_1, streams={stream: ">"}, claim_min_idle_time=100
+        )
+        self._validate_xreadgroup_with_claim_min_idle_time_response(
+            r, res, expected_entries
+        )
+
+    @skip_if_server_version_lt("8.3.224")
+    async def test_xreadgroup_with_claim_min_idle_time_multiple_streams_same_slots(
+        self, r
+    ):
+        stream_1 = "stream1:{same_slot:42}"
+        stream_2 = "stream2:{same_slot:42}"
+        group = "group"
+        consumer_1 = "c1"
+
+        stream_1_name = stream_1.encode()
+        stream_2_name = stream_2.encode()
+
+        # before test cleanup
+        try:
+            await r.xgroup_destroy(stream_1, group)
+        except ResponseError:
+            pass
+        try:
+            await r.xgroup_destroy(stream_2, group)
+        except ResponseError:
+            pass
+
+        m1_s1 = await r.xadd(stream_1, {"key_m1_s1": "val_m1"})
+        m2_s1 = await r.xadd(stream_1, {"key_m2_s1": "val_m2"})
+        await r.xgroup_create(stream_1, group, 0)
+
+        m1_s2 = await r.xadd(stream_2, {"key_m1_s2": "val_m1"})
+        m2_s2 = await r.xadd(stream_2, {"key_m2_s2": "val_m2"})
+        await r.xgroup_create(stream_2, group, 0)
+
+        # read all the messages - this will save the msgs in PEL
+        await r.xreadgroup(group, consumer_1, streams={stream_1: ">", stream_2: ">"})
+
+        # wait for 100ms - so that the messages would have been in the PEL for long enough
+        await asyncio.sleep(0.1)
+
+        m3_s1 = await r.xadd(stream_1, {"key_m3_s1": "val_m3"})
+        m4_s2 = await r.xadd(stream_2, {"key_m4_s2": "val_m4"})
+
+        expected_entries = {
+            stream_1_name: [
+                {
+                    "msg": await get_stream_message(r, stream_1, m1_s1),
+                    "min_idle_time": 100,
+                },
+                {
+                    "msg": await get_stream_message(r, stream_1, m2_s1),
+                    "min_idle_time": 100,
+                },
+                {
+                    "msg": await get_stream_message(r, stream_1, m3_s1),
+                    "min_idle_time": 0,
+                },
+            ],
+            stream_2_name: [
+                {
+                    "msg": await get_stream_message(r, stream_2, m1_s2),
+                    "min_idle_time": 100,
+                },
+                {
+                    "msg": await get_stream_message(r, stream_2, m2_s2),
+                    "min_idle_time": 100,
+                },
+                {
+                    "msg": await get_stream_message(r, stream_2, m4_s2),
+                    "min_idle_time": 0,
+                },
+            ],
+        }
+
+        res = await r.xreadgroup(
+            group,
+            consumer_1,
+            streams={stream_1: ">", stream_2: ">"},
+            claim_min_idle_time=100,
+        )
+
+        self._validate_xreadgroup_with_claim_min_idle_time_response(
+            r, res, expected_entries
+        )
+
+        # validate PEL still holds the messages until they are acknowledged
+        response = await r.xpending_range(stream_1, group, min="-", max="+", count=5)
+        assert len(response) == 3
+        response = await r.xpending_range(stream_2, group, min="-", max="+", count=5)
+        assert len(response) == 3
+
+        # add 2 more messages
+        await r.xadd(stream_1, {"key_m5": "val_m5"})
+        await r.xadd(stream_2, {"key_m6": "val_m6"})
+
+        # read all the messages - this will save the msgs in PEL
+        await r.xreadgroup(group, consumer_1, streams={stream_1: ">", stream_2: ">"})
+
+        # add 2 more messages
+        m7 = await r.xadd(stream_1, {"key_m7": "val_m7"})
+        m8 = await r.xadd(stream_2, {"key_m8": "val_m8"})
+        # read the messages with claim_min_idle_time=1000
+        # only m7 and m8 should be returned
+        # because the other messages have not been in the PEL for long enough
+        expected_entries = {
+            stream_1_name: [
+                {"msg": await get_stream_message(r, stream_1, m7), "min_idle_time": 0}
+            ],
+            stream_2_name: [
+                {"msg": await get_stream_message(r, stream_2, m8), "min_idle_time": 0}
+            ],
+        }
+        res = await r.xreadgroup(
+            group,
+            consumer_1,
+            streams={stream_1: ">", stream_2: ">"},
+            claim_min_idle_time=100,
+        )
+        self._validate_xreadgroup_with_claim_min_idle_time_response(
+            r, res, expected_entries
+        )
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.3.224")
+    async def test_xreadgroup_with_claim_min_idle_time_multiple_streams(self, r):
+        stream_1 = "stream1"
+        stream_2 = "stream2"
+        group = "group"
+        consumer_1 = "c1"
+
+        stream_1_name = stream_1.encode()
+        stream_2_name = stream_2.encode()
+
+        # before test cleanup
+        try:
+            await r.xgroup_destroy(stream_1, group)
+        except ResponseError:
+            pass
+        try:
+            await r.xgroup_destroy(stream_2, group)
+        except ResponseError:
+            pass
+
+        m1_s1 = await r.xadd(stream_1, {"key_m1_s1": "val_m1"})
+        m2_s1 = await r.xadd(stream_1, {"key_m2_s1": "val_m2"})
+        await r.xgroup_create(stream_1, group, 0)
+
+        m1_s2 = await r.xadd(stream_2, {"key_m1_s2": "val_m1"})
+        m2_s2 = await r.xadd(stream_2, {"key_m2_s2": "val_m2"})
+        await r.xgroup_create(stream_2, group, 0)
+
+        # read all the messages - this will save the msgs in PEL
+        await r.xreadgroup(group, consumer_1, streams={stream_1: ">", stream_2: ">"})
+
+        # wait for 100ms - so that the messages would have been in the PEL for long enough
+        await asyncio.sleep(0.1)
+
+        m3_s1 = await r.xadd(stream_1, {"key_m3_s1": "val_m3"})
+        m4_s2 = await r.xadd(stream_2, {"key_m4_s2": "val_m4"})
+
+        expected_entries = {
+            stream_1_name: [
+                {
+                    "msg": await get_stream_message(r, stream_1, m1_s1),
+                    "min_idle_time": 100,
+                },
+                {
+                    "msg": await get_stream_message(r, stream_1, m2_s1),
+                    "min_idle_time": 100,
+                },
+                {
+                    "msg": await get_stream_message(r, stream_1, m3_s1),
+                    "min_idle_time": 0,
+                },
+            ],
+            stream_2_name: [
+                {
+                    "msg": await get_stream_message(r, stream_2, m1_s2),
+                    "min_idle_time": 100,
+                },
+                {
+                    "msg": await get_stream_message(r, stream_2, m2_s2),
+                    "min_idle_time": 100,
+                },
+                {
+                    "msg": await get_stream_message(r, stream_2, m4_s2),
+                    "min_idle_time": 0,
+                },
+            ],
+        }
+
+        res = await r.xreadgroup(
+            group,
+            consumer_1,
+            streams={stream_1: ">", stream_2: ">"},
+            claim_min_idle_time=100,
+        )
+
+        self._validate_xreadgroup_with_claim_min_idle_time_response(
+            r, res, expected_entries
+        )
+
+        # validate PEL still holds the messages until they are acknowledged
+        response = await r.xpending_range(stream_1, group, min="-", max="+", count=5)
+        assert len(response) == 3
+        response = await r.xpending_range(stream_2, group, min="-", max="+", count=5)
+        assert len(response) == 3
+
+        # add 2 more messages
+        await r.xadd(stream_1, {"key_m5": "val_m5"})
+        await r.xadd(stream_2, {"key_m6": "val_m6"})
+
+        # read all the messages - this will save the msgs in PEL
+        await r.xreadgroup(group, consumer_1, streams={stream_1: ">", stream_2: ">"})
+
+        # add 2 more messages
+        m7 = await r.xadd(stream_1, {"key_m7": "val_m7"})
+        m8 = await r.xadd(stream_2, {"key_m8": "val_m8"})
+        # read the messages with claim_min_idle_time=1000
+        # only m7 and m8 should be returned
+        # because the other messages have not been in the PEL for long enough
+        expected_entries = {
+            stream_1_name: [
+                {"msg": await get_stream_message(r, stream_1, m7), "min_idle_time": 0}
+            ],
+            stream_2_name: [
+                {"msg": await get_stream_message(r, stream_2, m8), "min_idle_time": 0}
+            ],
+        }
+        res = await r.xreadgroup(
+            group,
+            consumer_1,
+            streams={stream_1: ">", stream_2: ">"},
+            claim_min_idle_time=100,
+        )
+        self._validate_xreadgroup_with_claim_min_idle_time_response(
+            r, res, expected_entries
+        )
+
     @skip_if_server_version_lt("5.0.0")
     async def test_xrevrange(self, r: redis.Redis):
         stream = "stream"
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 68017236ee..cd427ef62f 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -9,7 +9,7 @@
 from unittest.mock import patch
 
 import pytest
-from redis import RedisClusterException
+from redis import RedisClusterException, ResponseError
 import redis
 from redis import exceptions
 from redis._parsers.helpers import (
@@ -5440,6 +5440,322 @@ def test_xreadgroup(self, r):
             {stream_name: [expected_entries]},
         )
 
+    def _validate_xreadgroup_with_claim_min_idle_time_response(
+        self, r, response, expected_entries
+    ):
+        # validate the number of streams
+        assert len(response) == len(expected_entries)
+
+        expected_streams = expected_entries.keys()
+        for str_index, expected_stream in enumerate(expected_streams):
+            expected_entries_per_stream = expected_entries[expected_stream]
+
+            if is_resp2_connection(r):
+                actual_entries_per_stream = response[str_index][1]
+                actual_stream = response[str_index][0]
+                assert actual_stream == expected_stream
+            else:
+                actual_entries_per_stream = response[expected_stream][0]
+
+            # validate the number of entries
+            assert len(actual_entries_per_stream) == len(expected_entries_per_stream)
+
+            for i, entry in enumerate(actual_entries_per_stream):
+                message = (entry[0], entry[1])
+                message_idle = int(entry[2])
+                message_delivered_count = int(entry[3])
+
+                expected_idle = expected_entries_per_stream[i]["min_idle_time"]
+
+                assert message == expected_entries_per_stream[i]["msg"]
+                if expected_idle == 0:
+                    assert message_idle == 0
+                    assert message_delivered_count == 0
+                else:
+                    assert message_idle >= expected_idle
+                    assert message_delivered_count > 0
+
+    @skip_if_server_version_lt("8.3.224")
+    def test_xreadgroup_with_claim_min_idle_time(self, r):
+        stream = "stream"
+        group = "group"
+        consumer_1 = "c1"
+        stream_name = stream.encode()
+
+        try:
+            # before test cleanup
+            r.xgroup_destroy(stream, group)
+        except ResponseError:
+            pass
+
+        m1 = r.xadd(stream, {"key_m1": "val_m1"})
+        m2 = r.xadd(stream, {"key_m2": "val_m2"})
+
+        r.xgroup_create(stream, group, 0)
+
+        # read all the messages - this will save the msgs in PEL
+        r.xreadgroup(group, consumer_1, streams={stream: ">"})
+
+        # wait for 100ms - so that the messages would have been in the PEL for long enough
+        time.sleep(0.1)
+
+        m3 = r.xadd(stream, {"key_m3": "val_m3"})
+        m4 = r.xadd(stream, {"key_m4": "val_m4"})
+
+        expected_entries = {
+            stream_name: [
+                {"msg": get_stream_message(r, stream, m1), "min_idle_time": 100},
+                {"msg": get_stream_message(r, stream, m2), "min_idle_time": 100},
+                {"msg": get_stream_message(r, stream, m3), "min_idle_time": 0},
+                {"msg": get_stream_message(r, stream, m4), "min_idle_time": 0},
+            ]
+        }
+
+        res = r.xreadgroup(
+            group, consumer_1, streams={stream: ">"}, claim_min_idle_time=100
+        )
+
+        self._validate_xreadgroup_with_claim_min_idle_time_response(
+            r, res, expected_entries
+        )
+
+        # validate PEL still holds the messages until they are acknowledged
+        response = r.xpending_range(stream, group, min="-", max="+", count=5)
+        assert len(response) == 4
+
+        # add 2 more messages
+        m5 = r.xadd(stream, {"key_m5": "val_m5"})
+        m6 = r.xadd(stream, {"key_m6": "val_m6"})
+
+        expected_entries = [
+            get_stream_message(r, stream, m5),
+            get_stream_message(r, stream, m6),
+        ]
+        # read all the messages - this will save the msgs in PEL
+        res = r.xreadgroup(group, consumer_1, streams={stream: ">"})
+        assert_resp_response(
+            r,
+            res,
+            [[stream_name, expected_entries]],
+            {stream_name: [expected_entries]},
+        )
+
+        # add 2 more messages
+        m7 = r.xadd(stream, {"key_m7": "val_m7"})
+        m8 = r.xadd(stream, {"key_m8": "val_m8"})
+        # read the messages with claim_min_idle_time=1000
+        # only m7 and m8 should be returned
+        # because the other messages have not been in the PEL for long enough
+        expected_entries = {
+            stream_name: [
+                {"msg": get_stream_message(r, stream, m7), "min_idle_time": 0},
+                {"msg": get_stream_message(r, stream, m8), "min_idle_time": 0},
+            ]
+        }
+        res = r.xreadgroup(
+            group, consumer_1, streams={stream: ">"}, claim_min_idle_time=100
+        )
+        self._validate_xreadgroup_with_claim_min_idle_time_response(
+            r, res, expected_entries
+        )
+
+    @skip_if_server_version_lt("8.3.224")
+    def test_xreadgroup_with_claim_min_idle_time_multiple_streams_same_slots(self, r):
+        stream_1 = "stream1:{same_slot:42}"
+        stream_2 = "stream2:{same_slot:42}"
+        group = "group"
+        consumer_1 = "c1"
+
+        stream_1_name = stream_1.encode()
+        stream_2_name = stream_2.encode()
+
+        # before test cleanup
+        try:
+            r.xgroup_destroy(stream_1, group)
+        except ResponseError:
+            pass
+        try:
+            r.xgroup_destroy(stream_2, group)
+        except ResponseError:
+            pass
+
+        m1_s1 = r.xadd(stream_1, {"key_m1_s1": "val_m1"})
+        m2_s1 = r.xadd(stream_1, {"key_m2_s1": "val_m2"})
+        r.xgroup_create(stream_1, group, 0)
+
+        m1_s2 = r.xadd(stream_2, {"key_m1_s2": "val_m1"})
+        m2_s2 = r.xadd(stream_2, {"key_m2_s2": "val_m2"})
+        r.xgroup_create(stream_2, group, 0)
+
+        # read all the messages - this will save the msgs in PEL
+        r.xreadgroup(group, consumer_1, streams={stream_1: ">", stream_2: ">"})
+
+        # wait for 100ms - so that the messages would have been in the PEL for long enough
+        time.sleep(0.1)
+
+        m3_s1 = r.xadd(stream_1, {"key_m3_s1": "val_m3"})
+        m4_s2 = r.xadd(stream_2, {"key_m4_s2": "val_m4"})
+
+        expected_entries = {
+            stream_1_name: [
+                {"msg": get_stream_message(r, stream_1, m1_s1), "min_idle_time": 100},
+                {"msg": get_stream_message(r, stream_1, m2_s1), "min_idle_time": 100},
+                {"msg": get_stream_message(r, stream_1, m3_s1), "min_idle_time": 0},
+            ],
+            stream_2_name: [
+                {"msg": get_stream_message(r, stream_2, m1_s2), "min_idle_time": 100},
+                {"msg": get_stream_message(r, stream_2, m2_s2), "min_idle_time": 100},
+                {"msg": get_stream_message(r, stream_2, m4_s2), "min_idle_time": 0},
+            ],
+        }
+
+        res = r.xreadgroup(
+            group,
+            consumer_1,
+            streams={stream_1: ">", stream_2: ">"},
+            claim_min_idle_time=100,
+        )
+
+        self._validate_xreadgroup_with_claim_min_idle_time_response(
+            r, res, expected_entries
+        )
+
+        # validate PEL still holds the messages until they are acknowledged
+        response = r.xpending_range(stream_1, group, min="-", max="+", count=5)
+        assert len(response) == 3
+        response = r.xpending_range(stream_2, group, min="-", max="+", count=5)
+        assert len(response) == 3
+
+        # add 2 more messages
+        r.xadd(stream_1, {"key_m5": "val_m5"})
+        r.xadd(stream_2, {"key_m6": "val_m6"})
+
+        # read all the messages - this will save the msgs in PEL
+        r.xreadgroup(group, consumer_1, streams={stream_1: ">", stream_2: ">"})
+
+        # add 2 more messages
+        m7 = r.xadd(stream_1, {"key_m7": "val_m7"})
+        m8 = r.xadd(stream_2, {"key_m8": "val_m8"})
+        # read the messages with claim_min_idle_time=1000
+        # only m7 and m8 should be returned
+        # because the other messages have not been in the PEL for long enough
+        expected_entries = {
+            stream_1_name: [
+                {"msg": get_stream_message(r, stream_1, m7), "min_idle_time": 0}
+            ],
+            stream_2_name: [
+                {"msg": get_stream_message(r, stream_2, m8), "min_idle_time": 0}
+            ],
+        }
+        res = r.xreadgroup(
+            group,
+            consumer_1,
+            streams={stream_1: ">", stream_2: ">"},
+            claim_min_idle_time=100,
+        )
+        self._validate_xreadgroup_with_claim_min_idle_time_response(
+            r, res, expected_entries
+        )
+
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("8.3.224")
+    def test_xreadgroup_with_claim_min_idle_time_multiple_streams(self, r):
+        stream_1 = "stream1"
+        stream_2 = "stream2"
+        group = "group"
+        consumer_1 = "c1"
+
+        stream_1_name = stream_1.encode()
+        stream_2_name = stream_2.encode()
+
+        # before test cleanup
+        try:
+            r.xgroup_destroy(stream_1, group)
+        except ResponseError:
+            pass
+        try:
+            r.xgroup_destroy(stream_2, group)
+        except ResponseError:
+            pass
+
+        m1_s1 = r.xadd(stream_1, {"key_m1_s1": "val_m1"})
+        m2_s1 = r.xadd(stream_1, {"key_m2_s1": "val_m2"})
+        r.xgroup_create(stream_1, group, 0)
+
+        m1_s2 = r.xadd(stream_2, {"key_m1_s2": "val_m1"})
+        m2_s2 = r.xadd(stream_2, {"key_m2_s2": "val_m2"})
+        r.xgroup_create(stream_2, group, 0)
+
+        # read all the messages - this will save the msgs in PEL
+        r.xreadgroup(group, consumer_1, streams={stream_1: ">", stream_2: ">"})
+
+        # wait for 100ms - so that the messages would have been in the PEL for long enough
+        time.sleep(0.1)
+
+        m3_s1 = r.xadd(stream_1, {"key_m3_s1": "val_m3"})
+        m4_s2 = r.xadd(stream_2, {"key_m4_s2": "val_m4"})
+
+        expected_entries = {
+            stream_1_name: [
+                {"msg": get_stream_message(r, stream_1, m1_s1), "min_idle_time": 100},
+                {"msg": get_stream_message(r, stream_1, m2_s1), "min_idle_time": 100},
+                {"msg": get_stream_message(r, stream_1, m3_s1), "min_idle_time": 0},
+            ],
+            stream_2_name: [
+                {"msg": get_stream_message(r, stream_2, m1_s2), "min_idle_time": 100},
+                {"msg": get_stream_message(r, stream_2, m2_s2), "min_idle_time": 100},
+                {"msg": get_stream_message(r, stream_2, m4_s2), "min_idle_time": 0},
+            ],
+        }
+
+        res = r.xreadgroup(
+            group,
+            consumer_1,
+            streams={stream_1: ">", stream_2: ">"},
+            claim_min_idle_time=100,
+        )
+
+        self._validate_xreadgroup_with_claim_min_idle_time_response(
+            r, res, expected_entries
+        )
+
+        # validate PEL still holds the messages until they are acknowledged
+        response = r.xpending_range(stream_1, group, min="-", max="+", count=5)
+        assert len(response) == 3
+        response = r.xpending_range(stream_2, group, min="-", max="+", count=5)
+        assert len(response) == 3
+
+        # add 2 more messages
+        r.xadd(stream_1, {"key_m5": "val_m5"})
+        r.xadd(stream_2, {"key_m6": "val_m6"})
+
+        # read all the messages - this will save the msgs in PEL
+        r.xreadgroup(group, consumer_1, streams={stream_1: ">", stream_2: ">"})
+
+        # add 2 more messages
+        m7 = r.xadd(stream_1, {"key_m7": "val_m7"})
+        m8 = r.xadd(stream_2, {"key_m8": "val_m8"})
+        # read the messages with claim_min_idle_time=1000
+        # only m7 and m8 should be returned
+        # because the other messages have not been in the PEL for long enough
+        expected_entries = {
+            stream_1_name: [
+                {"msg": get_stream_message(r, stream_1, m7), "min_idle_time": 0}
+            ],
+            stream_2_name: [
+                {"msg": get_stream_message(r, stream_2, m8), "min_idle_time": 0}
+            ],
+        }
+        res = r.xreadgroup(
+            group,
+            consumer_1,
+            streams={stream_1: ">", stream_2: ">"},
+            claim_min_idle_time=100,
+        )
+        self._validate_xreadgroup_with_claim_min_idle_time_response(
+            r, res, expected_entries
+        )
+
     @skip_if_server_version_lt("5.0.0")
     def test_xrevrange(self, r):
         stream = "stream"

From 526466f36a129f24af24ee76601c8a4265fda8de Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 4 Nov 2025 12:37:56 +0200
Subject: [PATCH 1157/1164] Fixing flaky tests (#3833)

* Fixing flaky tests

* Fixing flaky vset test.

* Fixing test_execute_command_against_correct_db_on_background_health_check_determine_active_db_unhealthy

* Fixing with patch + one more test

* Fixing MSETEX tests - time set with pxat might be approximated to 1 sec higher than it was set as test expectation

* Fix Monitor's next_command parsing for CLUSTER SHARDS command - issue catched by a flaky test behavior
---
 redis/client.py                               | 11 ++-
 tests/test_asyncio/test_commands.py           | 12 +--
 .../test_asyncio/test_multidb/test_client.py  | 86 +++++++++----------
 tests/test_asyncio/test_vsets.py              |  2 +-
 tests/test_commands.py                        | 13 +--
 tests/test_multidb/test_client.py             | 77 ++++++++---------
 tests/test_vsets.py                           |  2 +-
 7 files changed, 101 insertions(+), 102 deletions(-)

diff --git a/redis/client.py b/redis/client.py
index 51b699721e..d3ab3cfcfe 100755
--- a/redis/client.py
+++ b/redis/client.py
@@ -761,9 +761,14 @@ def next_command(self):
             client_port = client_info[5:]
             client_type = "unix"
         else:
-            # use rsplit as ipv6 addresses contain colons
-            client_address, client_port = client_info.rsplit(":", 1)
-            client_type = "tcp"
+            if client_info == "":
+                client_address = ""
+                client_port = ""
+                client_type = "unknown"
+            else:
+                # use rsplit as ipv6 addresses contain colons
+                client_address, client_port = client_info.rsplit(":", 1)
+                client_type = "tcp"
         return {
             "time": float(command_time),
             "db": int(db_id),
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 1072779192..3a10a50b93 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -1321,7 +1321,7 @@ async def test_msetex_expiration_pxat_and_nx_with_cluster_client(self, r):
         for ttl in old_ttls:
             assert 10 < ttl <= 30
         for ttl in new_ttls:
-            assert ttl <= 10
+            assert ttl <= 11
         assert await r.mget(*mapping.keys(), "new:{test:1}", "new_2:{test:1}") == [
             b"1",
             b"2",
@@ -1370,8 +1370,8 @@ async def test_msetex_expiration_exat_and_xx_with_cluster_client(self, r):
             == 1
         )
         ttls = await asyncio.gather(*[r.ttl(key) for key in mapping.keys()])
-        assert ttls[0] <= 10
-        assert ttls[1] <= 10
+        assert ttls[0] <= 11
+        assert ttls[1] <= 11
         assert 10 < ttls[2] <= 30
         assert await r.mget(
             "1:{test:1}", "2:{test:1}", "3:{test:1}", "new:{test:1}"
@@ -1483,7 +1483,7 @@ async def test_msetex_expiration_pxat_and_nx(self, r):
         for ttl in old_ttls:
             assert 10 < ttl <= 30
         for ttl in new_ttls:
-            assert ttl <= 10
+            assert ttl <= 11
         assert await r.mget(*mapping.keys(), "new", "new_2") == [
             b"1",
             b"2",
@@ -1527,8 +1527,8 @@ async def test_msetex_expiration_exat_and_xx(self, r):
             == 1
         )
         ttls = await asyncio.gather(*[r.ttl(key) for key in mapping.keys()])
-        assert ttls[0] <= 10
-        assert ttls[1] <= 10
+        assert ttls[0] <= 11
+        assert ttls[1] <= 11
         assert 10 < ttls[2] <= 30
         assert await r.mget("1", "2", "3", "new") == [
             b"new_value",
diff --git a/tests/test_asyncio/test_multidb/test_client.py b/tests/test_asyncio/test_multidb/test_client.py
index e028655c38..537fdb0c82 100644
--- a/tests/test_asyncio/test_multidb/test_client.py
+++ b/tests/test_asyncio/test_multidb/test_client.py
@@ -36,9 +36,7 @@ async def test_execute_command_against_correct_db_on_successful_initialization(
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_db1.client.execute_command = AsyncMock(return_value="OK1")
 
             mock_hc.check_health.return_value = True
@@ -71,9 +69,7 @@ async def test_execute_command_against_correct_db_and_closed_circuit(
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_db1.client.execute_command = AsyncMock(return_value="OK1")
 
             mock_hc.check_health.side_effect = [
@@ -88,7 +84,8 @@ async def test_execute_command_against_correct_db_and_closed_circuit(
 
             client = MultiDBClient(mock_multi_db_config)
             assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
-            assert await client.set("key", "value") == "OK1"
+            result = await client.set("key", "value")
+            assert result == "OK1"
             assert mock_hc.check_health.call_count == 7
 
             assert mock_db.circuit.state == CBState.CLOSED
@@ -185,9 +182,7 @@ async def mock_check_health(database):
         mock_hc.check_health.side_effect = mock_check_health
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_db.client.execute_command.return_value = "OK"
             mock_db1.client.execute_command.return_value = "OK1"
             mock_db2.client.execute_command.return_value = "OK2"
@@ -201,6 +196,7 @@ async def mock_check_health(database):
             assert await db1_became_unhealthy.wait(), (
                 "Timeout waiting for mock_db1 to become unhealthy"
             )
+
             await asyncio.sleep(0.01)
 
             assert await client.set("key", "value") == "OK2"
@@ -209,7 +205,14 @@ async def mock_check_health(database):
             assert await db2_became_unhealthy.wait(), (
                 "Timeout waiting for mock_db2 to become unhealthy"
             )
-            await asyncio.sleep(0.01)
+
+            # Wait for circuit breaker state to actually reflect the unhealthy status
+            # (instead of just sleeping)
+            max_retries = 20
+            for _ in range(max_retries):
+                if cb2.state == CBState.OPEN:  # Circuit is open (unhealthy)
+                    break
+                await asyncio.sleep(0.01)
 
             assert await client.set("key", "value") == "OK"
 
@@ -258,9 +261,7 @@ async def mock_check_health(database):
         mock_hc.check_health.side_effect = mock_check_health
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_db.client.execute_command.return_value = "OK"
             mock_db1.client.execute_command.return_value = "OK1"
             mock_db2.client.execute_command.return_value = "OK2"
@@ -271,6 +272,14 @@ async def mock_check_health(database):
             async with MultiDBClient(mock_multi_db_config) as client:
                 assert await client.set("key", "value") == "OK1"
                 await error_event.wait()
+                # Wait for circuit breaker to actually open (not just the event)
+                max_retries = 20
+                for _ in range(max_retries):
+                    if mock_db1.circuit.state == CBState.OPEN:  # Circuit is open
+                        break
+                    await asyncio.sleep(0.01)
+
+                # Now the failover strategy will select mock_db2
                 assert await client.set("key", "value") == "OK2"
                 await asyncio.sleep(0.5)
                 assert await client.set("key", "value") == "OK1"
@@ -312,9 +321,7 @@ async def mock_check_health(database):
         mock_hc.check_health.side_effect = mock_check_health
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_db.client.execute_command.return_value = "OK"
             mock_db1.client.execute_command.return_value = "OK1"
             mock_db2.client.execute_command.return_value = "OK2"
@@ -325,6 +332,15 @@ async def mock_check_health(database):
             async with MultiDBClient(mock_multi_db_config) as client:
                 assert await client.set("key", "value") == "OK1"
                 await error_event.wait()
+                # Wait for circuit breaker state to actually reflect the unhealthy status
+                # (instead of just sleeping)
+                max_retries = 20
+                for _ in range(max_retries):
+                    if (
+                        mock_db1.circuit.state == CBState.OPEN
+                    ):  # Circuit is open (unhealthy)
+                        break
+                    await asyncio.sleep(0.01)
                 assert await client.set("key", "value") == "OK2"
                 await asyncio.sleep(0.5)
                 assert await client.set("key", "value") == "OK2"
@@ -348,9 +364,7 @@ async def test_execute_command_throws_exception_on_failed_initialization(
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_hc.check_health.return_value = False
 
             client = MultiDBClient(mock_multi_db_config)
@@ -382,9 +396,7 @@ async def test_add_database_throws_exception_on_same_database(
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_hc.check_health.return_value = False
 
             client = MultiDBClient(mock_multi_db_config)
@@ -413,9 +425,7 @@ async def test_add_database_makes_new_database_active(
         databases = create_weighted_list(mock_db, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_db1.client.execute_command.return_value = "OK1"
             mock_db2.client.execute_command.return_value = "OK2"
 
@@ -451,9 +461,7 @@ async def test_remove_highest_weighted_database(
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_db1.client.execute_command.return_value = "OK1"
             mock_db2.client.execute_command.return_value = "OK2"
 
@@ -487,9 +495,7 @@ async def test_update_database_weight_to_be_highest(
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_db1.client.execute_command.return_value = "OK1"
             mock_db2.client.execute_command.return_value = "OK2"
 
@@ -525,9 +531,7 @@ async def test_add_new_failure_detector(
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_db1.client.execute_command.return_value = "OK1"
             mock_multi_db_config.event_dispatcher = EventDispatcher()
             mock_fd = mock_multi_db_config.failure_detectors[0]
@@ -546,7 +550,7 @@ async def test_add_new_failure_detector(
             assert mock_hc.check_health.call_count == 9
 
             # Simulate failing command events that lead to a failure detection
-            for i in range(5):
+            for _ in range(5):
                 await mock_multi_db_config.event_dispatcher.dispatch_async(
                     command_fail_event
                 )
@@ -557,7 +561,7 @@ async def test_add_new_failure_detector(
             client.add_failure_detector(another_fd)
 
             # Simulate failing command events that lead to a failure detection
-            for i in range(5):
+            for _ in range(5):
                 await mock_multi_db_config.event_dispatcher.dispatch_async(
                     command_fail_event
                 )
@@ -584,9 +588,7 @@ async def test_add_new_health_check(
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_db1.client.execute_command.return_value = "OK1"
 
             mock_hc.check_health.return_value = True
@@ -624,9 +626,7 @@ async def test_set_active_database(
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_db1.client.execute_command.return_value = "OK1"
             mock_db.client.execute_command.return_value = "OK"
 
diff --git a/tests/test_asyncio/test_vsets.py b/tests/test_asyncio/test_vsets.py
index 896d98b192..447e474e9c 100644
--- a/tests/test_asyncio/test_vsets.py
+++ b/tests/test_asyncio/test_vsets.py
@@ -454,7 +454,7 @@ async def test_vsim_truth_no_thread_enabled(d_client):
     elements_count = 5000
     vector_dim = 50
     for i in range(1, elements_count + 1):
-        float_array = [random.uniform(10 * i, 1000 * i) for x in range(vector_dim)]
+        float_array = [i for _ in range(vector_dim)]
         await d_client.vset().vadd("myset", float_array, f"elem_{i}")
 
     await d_client.vset().vadd("myset", [-22 for _ in range(vector_dim)], "elem_man_2")
diff --git a/tests/test_commands.py b/tests/test_commands.py
index cd427ef62f..4925329a21 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1896,6 +1896,7 @@ def test_msetex_expiration_pxat_and_nx_with_cluster_client(self, r):
             )
             == 0
         )
+
         ttls = [r.ttl(key) for key in mapping.keys()]
         for ttl in ttls:
             assert 10 < ttl <= 30
@@ -1915,7 +1916,7 @@ def test_msetex_expiration_pxat_and_nx_with_cluster_client(self, r):
         for ttl in old_ttls:
             assert 10 < ttl <= 30
         for ttl in new_ttls:
-            assert ttl <= 10
+            assert ttl <= 11
         assert r.mget(*mapping.keys(), "new:{test:1}", "new_2:{test:1}") == [
             b"1",
             b"2",
@@ -1959,8 +1960,8 @@ def test_msetex_expiration_exat_and_xx_with_cluster_client(self, r):
             == 1
         )
         ttls = [r.ttl(key) for key in mapping.keys()]
-        assert ttls[0] <= 10
-        assert ttls[1] <= 10
+        assert ttls[0] <= 11
+        assert ttls[1] <= 11
         assert 10 < ttls[2] <= 30
         assert r.mget("1:{test:1}", "2:{test:1}", "3:{test:1}", "new:{test:1}") == [
             b"new_value",
@@ -2070,7 +2071,7 @@ def test_msetex_expiration_pxat_and_nx(self, r):
         for ttl in old_ttls:
             assert 10 < ttl <= 30
         for ttl in new_ttls:
-            assert ttl <= 10
+            assert ttl <= 11
         assert r.mget(*mapping.keys(), "new", "new_2") == [
             b"1",
             b"2",
@@ -2114,8 +2115,8 @@ def test_msetex_expiration_exat_and_xx(self, r):
             == 1
         )
         ttls = [r.ttl(key) for key in mapping.keys()]
-        assert ttls[0] <= 10
-        assert ttls[1] <= 10
+        assert ttls[0] <= 11
+        assert ttls[1] <= 11
         assert 10 < ttls[2] <= 30
         assert r.mget("1", "2", "3", "new") == [
             b"new_value",
diff --git a/tests/test_multidb/test_client.py b/tests/test_multidb/test_client.py
index b342b4b91b..490126fdf2 100644
--- a/tests/test_multidb/test_client.py
+++ b/tests/test_multidb/test_client.py
@@ -1,6 +1,6 @@
 import threading
 from time import sleep
-from unittest.mock import patch, Mock
+from unittest.mock import MagicMock, patch, Mock
 
 import pybreaker
 import pytest
@@ -36,9 +36,7 @@ def test_execute_command_against_correct_db_on_successful_initialization(
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_db1.client.execute_command.return_value = "OK1"
 
             mock_hc.check_health.return_value = True
@@ -70,10 +68,8 @@ def test_execute_command_against_correct_db_and_closed_circuit(
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
-            mock_db1.client.execute_command.return_value = "OK1"
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
+            mock_db1.client.execute_command = MagicMock(return_value="OK1")
 
             mock_hc.check_health.side_effect = [
                 False,
@@ -87,7 +83,8 @@ def test_execute_command_against_correct_db_and_closed_circuit(
 
             client = MultiDBClient(mock_multi_db_config)
             assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
-            assert client.set("key", "value") == "OK1"
+            result = client.set("key", "value")
+            assert result == "OK1"
             assert mock_hc.check_health.call_count == 7
 
             assert mock_db.circuit.state == CBState.CLOSED
@@ -183,9 +180,7 @@ def mock_check_health(database):
         mock_hc.check_health.side_effect = mock_check_health
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_multi_db_config.health_check_interval = 0.1
             mock_multi_db_config.failover_strategy = WeightBasedFailoverStrategy()
             mock_db.client.execute_command.return_value = "OK"
@@ -255,9 +250,7 @@ def mock_check_health(database):
         mock_hc.check_health.side_effect = mock_check_health
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_db.client.execute_command.return_value = "OK"
             mock_db1.client.execute_command.return_value = "OK1"
             mock_db2.client.execute_command.return_value = "OK2"
@@ -268,6 +261,15 @@ def mock_check_health(database):
             client = MultiDBClient(mock_multi_db_config)
             assert client.set("key", "value") == "OK1"
             error_event.wait(timeout=0.5)
+
+            # Wait for circuit breaker to actually open (not just the event)
+            max_retries = 20
+            for _ in range(max_retries):
+                if mock_db1.circuit.state == CBState.OPEN:  # Circuit is open
+                    break
+                sleep(0.01)
+
+            # Now the failover strategy will select mock_db2
             assert client.set("key", "value") == "OK2"
             sleep(0.5)
             assert client.set("key", "value") == "OK1"
@@ -308,9 +310,7 @@ def mock_check_health(database):
         mock_hc.check_health.side_effect = mock_check_health
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_db.client.execute_command.return_value = "OK"
             mock_db1.client.execute_command.return_value = "OK1"
             mock_db2.client.execute_command.return_value = "OK2"
@@ -321,6 +321,15 @@ def mock_check_health(database):
             client = MultiDBClient(mock_multi_db_config)
             assert client.set("key", "value") == "OK1"
             error_event.wait(timeout=0.5)
+            # Wait for circuit breaker state to actually reflect the unhealthy status
+            # (instead of just sleeping)
+            max_retries = 20
+            for _ in range(max_retries):
+                if (
+                    mock_db1.circuit.state == CBState.OPEN
+                ):  # Circuit is open (unhealthy)
+                    break
+                sleep(0.01)
             assert client.set("key", "value") == "OK2"
             sleep(0.5)
             assert client.set("key", "value") == "OK2"
@@ -343,9 +352,7 @@ def test_execute_command_throws_exception_on_failed_initialization(
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_hc.check_health.return_value = False
 
             client = MultiDBClient(mock_multi_db_config)
@@ -377,9 +384,7 @@ def test_add_database_throws_exception_on_same_database(
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_hc.check_health.return_value = False
 
             client = MultiDBClient(mock_multi_db_config)
@@ -407,9 +412,7 @@ def test_add_database_makes_new_database_active(
         databases = create_weighted_list(mock_db, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_db1.client.execute_command.return_value = "OK1"
             mock_db2.client.execute_command.return_value = "OK2"
 
@@ -444,9 +447,7 @@ def test_remove_highest_weighted_database(
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_db1.client.execute_command.return_value = "OK1"
             mock_db2.client.execute_command.return_value = "OK2"
 
@@ -480,9 +481,7 @@ def test_update_database_weight_to_be_highest(
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_db1.client.execute_command.return_value = "OK1"
             mock_db2.client.execute_command.return_value = "OK2"
 
@@ -517,9 +516,7 @@ def test_add_new_failure_detector(
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_db1.client.execute_command.return_value = "OK1"
             mock_multi_db_config.event_dispatcher = EventDispatcher()
             mock_fd = mock_multi_db_config.failure_detectors[0]
@@ -571,9 +568,7 @@ def test_add_new_health_check(
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_db1.client.execute_command.return_value = "OK1"
 
             mock_hc.check_health.return_value = True
@@ -610,9 +605,7 @@ def test_set_active_database(
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
-        with (
-            patch.object(mock_multi_db_config, "databases", return_value=databases),
-        ):
+        with patch.object(mock_multi_db_config, "databases", return_value=databases):
             mock_db1.client.execute_command.return_value = "OK1"
             mock_db.client.execute_command.return_value = "OK"
 
diff --git a/tests/test_vsets.py b/tests/test_vsets.py
index 36295201e7..6376eeb898 100644
--- a/tests/test_vsets.py
+++ b/tests/test_vsets.py
@@ -456,7 +456,7 @@ def test_vsim_truth_no_thread_enabled(d_client):
     elements_count = 5000
     vector_dim = 50
     for i in range(1, elements_count + 1):
-        float_array = [random.uniform(10 * i, 1000 * i) for x in range(vector_dim)]
+        float_array = [i for _ in range(vector_dim)]
         d_client.vset().vadd("myset", float_array, f"elem_{i}")
 
     d_client.vset().vadd("myset", [-22 for _ in range(vector_dim)], "elem_man_2")

From 1340ff184b22bb1f731d32e3a4ce62e64647e8d0 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 4 Nov 2025 13:24:37 +0200
Subject: [PATCH 1158/1164] Update 8.4 RC image tag to 8.4-RC1-pre.2 for
 pipeline test matrix (#3832)

---
 .github/workflows/integration.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 16b4fb406f..9971cf103c 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -76,7 +76,7 @@ jobs:
       max-parallel: 15
       fail-fast: false
       matrix:
-        redis-version: ['8.4-RC1-pre', '${{ needs.redis_version.outputs.CURRENT }}', '8.0.2' ,'7.4.4', '7.2.9']
+        redis-version: ['8.4-RC1-pre.2', '${{ needs.redis_version.outputs.CURRENT }}', '8.0.2' ,'7.4.4', '7.2.9']
         python-version: ['3.10', '3.14']
         parser-backend: ['plain']
         event-loop: ['asyncio']

From 6bbc5c74715d13f155c8a323561bc4d1a2b2a1e9 Mon Sep 17 00:00:00 2001
From: Vladyslav Vildanov <117659936+vladvildanov@users.noreply.github.com>
Date: Tue, 4 Nov 2025 17:55:23 +0200
Subject: [PATCH 1159/1164] Apply routing and response aggregation policies in
 OSS Cluster mode (#3834)

* Added policies parsing and policies resolving (#3805)

* Added poilcy resolution method

* Moved main command proceessing on top

* Fixed return type and keyless detection

* Added Dynamic and Static policies

* Added coverage for policy resolvers

* Removed all policies except search (phase 1)

* Applied comments

* Apply policies for normal and pipeline mode (#3818)

* Added poilcy resolution method

* Moved main command proceessing on top

* Fixed return type and keyless detection

* Added Dynamic and Static policies

* Added coverage for policy resolvers

* Applied request policies

* Removed all policies except search (phase 1)

* Policy applied for normal and pipeline mode

* Added assertion with core command

* Applied comments

* Renamed method

* Added async implementation for Request-Response policies (#3824)

* Added poilcy resolution method

* Moved main command proceessing on top

* Fixed return type and keyless detection

* Added Dynamic and Static policies

* Added coverage for policy resolvers

* Applied request policies

* Removed all policies except search (phase 1)

* Policy applied for normal and pipeline mode

* Added assertion with core command

* Applied comments

* Added async support for Request/Responce policies

* Fixed method name

* Updated async to sync

* Codestyle changes

* Codestyle changes

* Codestyle changes

* Revert changes

* Marked tests with Redis 8.0

* Added timeouts for index creation

* Codestyle changes

* Fixed RESP3 responses

* Codestyle changes

* Added additional option for cluster
---
 docker-compose.yml                          |   4 +-
 redis/_parsers/commands.py                  | 421 +++++++++++++++++++-
 redis/asyncio/cluster.py                    | 201 ++++++++--
 redis/cluster.py                            | 362 ++++++++++++++---
 redis/commands/policies.py                  | 330 +++++++++++++++
 redis/exceptions.py                         |   8 +
 tests/test_asyncio/test_command_parser.py   | 161 ++++++++
 tests/test_asyncio/test_command_policies.py | 184 +++++++++
 tests/test_cluster.py                       |  23 +-
 tests/test_command_parser.py                | 153 +++++++
 tests/test_command_policies.py              | 183 +++++++++
 11 files changed, 1923 insertions(+), 107 deletions(-)
 create mode 100644 redis/commands/policies.py
 create mode 100644 tests/test_asyncio/test_command_parser.py
 create mode 100644 tests/test_asyncio/test_command_policies.py
 create mode 100644 tests/test_command_policies.py

diff --git a/docker-compose.yml b/docker-compose.yml
index 46c70ba5a9..ef7fd813b3 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -4,7 +4,7 @@ x-client-libs-stack-image: &client-libs-stack-image
   image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_STACK_IMAGE_TAG:-8.2}"
 
 x-client-libs-image: &client-libs-image
-  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_IMAGE_TAG:-8.2}"
+  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_IMAGE_TAG:-8.4-RC1-pre.2}"
 
 services:
 
@@ -58,7 +58,7 @@ services:
       - TLS_ENABLED=yes
       - PORT=16379
       - TLS_PORT=27379
-    command: ${REDIS_EXTRA_ARGS:---enable-debug-command yes --enable-module-command yes --tls-auth-clients optional --save ""}
+    command: ${REDIS_EXTRA_ARGS:---enable-debug-command yes --enable-module-command yes --tls-auth-clients optional --save "" --tls-cluster yes}
     ports:
       - "16379-16384:16379-16384"
       - "27379-27384:27379-27384"
diff --git a/redis/_parsers/commands.py b/redis/_parsers/commands.py
index b5109252ae..9ec50a240f 100644
--- a/redis/_parsers/commands.py
+++ b/redis/_parsers/commands.py
@@ -1,12 +1,50 @@
-from typing import TYPE_CHECKING, Any, Dict, Optional, Tuple, Union
+from enum import Enum
+from typing import TYPE_CHECKING, Any, Awaitable, Dict, Optional, Tuple, Union
 
-from redis.exceptions import RedisError, ResponseError
+from redis.exceptions import IncorrectPolicyType, RedisError, ResponseError
 from redis.utils import str_if_bytes
 
 if TYPE_CHECKING:
     from redis.asyncio.cluster import ClusterNode
 
 
+class RequestPolicy(Enum):
+    ALL_NODES = "all_nodes"
+    ALL_SHARDS = "all_shards"
+    ALL_REPLICAS = "all_replicas"
+    MULTI_SHARD = "multi_shard"
+    SPECIAL = "special"
+    DEFAULT_KEYLESS = "default_keyless"
+    DEFAULT_KEYED = "default_keyed"
+    DEFAULT_NODE = "default_node"
+
+
+class ResponsePolicy(Enum):
+    ONE_SUCCEEDED = "one_succeeded"
+    ALL_SUCCEEDED = "all_succeeded"
+    AGG_LOGICAL_AND = "agg_logical_and"
+    AGG_LOGICAL_OR = "agg_logical_or"
+    AGG_MIN = "agg_min"
+    AGG_MAX = "agg_max"
+    AGG_SUM = "agg_sum"
+    SPECIAL = "special"
+    DEFAULT_KEYLESS = "default_keyless"
+    DEFAULT_KEYED = "default_keyed"
+
+
+class CommandPolicies:
+    def __init__(
+        self,
+        request_policy: RequestPolicy = RequestPolicy.DEFAULT_KEYLESS,
+        response_policy: ResponsePolicy = ResponsePolicy.DEFAULT_KEYLESS,
+    ):
+        self.request_policy = request_policy
+        self.response_policy = response_policy
+
+
+PolicyRecords = dict[str, dict[str, CommandPolicies]]
+
+
 class AbstractCommandsParser:
     def _get_pubsub_keys(self, *args):
         """
@@ -64,7 +102,8 @@ class CommandsParser(AbstractCommandsParser):
 
     def __init__(self, redis_connection):
         self.commands = {}
-        self.initialize(redis_connection)
+        self.redis_connection = redis_connection
+        self.initialize(self.redis_connection)
 
     def initialize(self, r):
         commands = r.command()
@@ -129,7 +168,9 @@ def get_keys(self, redis_conn, *args):
                     for subcmd in command["subcommands"]:
                         if str_if_bytes(subcmd[0]) == subcmd_name:
                             command = self.parse_subcommand(subcmd)
-                            is_subcmd = True
+
+                            if command["first_key_pos"] > 0:
+                                is_subcmd = True
 
                 # The command doesn't have keys in it
                 if not is_subcmd:
@@ -169,6 +210,190 @@ def _get_moveable_keys(self, redis_conn, *args):
                 raise e
         return keys
 
+    def _is_keyless_command(
+        self, command_name: str, subcommand_name: Optional[str] = None
+    ) -> bool:
+        """
+        Determines whether a given command or subcommand is considered "keyless".
+
+        A keyless command does not operate on specific keys, which is determined based
+        on the first key position in the command or subcommand details. If the command
+        or subcommand's first key position is zero or negative, it is treated as keyless.
+
+        Parameters:
+            command_name: str
+                The name of the command to check.
+            subcommand_name: Optional[str], default=None
+                The name of the subcommand to check, if applicable. If not provided,
+                the check is performed only on the command.
+
+        Returns:
+            bool
+                True if the specified command or subcommand is considered keyless,
+                False otherwise.
+
+        Raises:
+            ValueError
+                If the specified subcommand is not found within the command or the
+                specified command does not exist in the available commands.
+        """
+        if subcommand_name:
+            for subcommand in self.commands.get(command_name)["subcommands"]:
+                if str_if_bytes(subcommand[0]) == subcommand_name:
+                    parsed_subcmd = self.parse_subcommand(subcommand)
+                    return parsed_subcmd["first_key_pos"] <= 0
+            raise ValueError(
+                f"Subcommand {subcommand_name} not found in command {command_name}"
+            )
+        else:
+            command_details = self.commands.get(command_name, None)
+            if command_details is not None:
+                return command_details["first_key_pos"] <= 0
+
+            raise ValueError(f"Command {command_name} not found in commands")
+
+    def get_command_policies(self) -> PolicyRecords:
+        """
+        Retrieve and process the command policies for all commands and subcommands.
+
+        This method traverses through commands and subcommands, extracting policy details
+        from associated data structures and constructing a dictionary of commands with their
+        associated policies. It supports nested data structures and handles both main commands
+        and their subcommands.
+
+        Returns:
+            PolicyRecords: A collection of commands and subcommands associated with their
+            respective policies.
+
+        Raises:
+            IncorrectPolicyType: If an invalid policy type is encountered during policy extraction.
+        """
+        command_with_policies = {}
+
+        def extract_policies(data, module_name, command_name):
+            """
+            Recursively extract policies from nested data structures.
+
+            Args:
+                data: The data structure to search (can be list, dict, str, bytes, etc.)
+                command_name: The command name to associate with found policies
+            """
+            if isinstance(data, (str, bytes)):
+                # Decode bytes to string if needed
+                policy = str_if_bytes(data.decode())
+
+                # Check if this is a policy string
+                if policy.startswith("request_policy") or policy.startswith(
+                    "response_policy"
+                ):
+                    if policy.startswith("request_policy"):
+                        policy_type = policy.split(":")[1]
+
+                        try:
+                            command_with_policies[module_name][
+                                command_name
+                            ].request_policy = RequestPolicy(policy_type)
+                        except ValueError:
+                            raise IncorrectPolicyType(
+                                f"Incorrect request policy type: {policy_type}"
+                            )
+
+                    if policy.startswith("response_policy"):
+                        policy_type = policy.split(":")[1]
+
+                        try:
+                            command_with_policies[module_name][
+                                command_name
+                            ].response_policy = ResponsePolicy(policy_type)
+                        except ValueError:
+                            raise IncorrectPolicyType(
+                                f"Incorrect response policy type: {policy_type}"
+                            )
+
+            elif isinstance(data, list):
+                # For lists, recursively process each element
+                for item in data:
+                    extract_policies(item, module_name, command_name)
+
+            elif isinstance(data, dict):
+                # For dictionaries, recursively process each value
+                for value in data.values():
+                    extract_policies(value, module_name, command_name)
+
+        for command, details in self.commands.items():
+            # Check whether the command has keys
+            is_keyless = self._is_keyless_command(command)
+
+            if is_keyless:
+                default_request_policy = RequestPolicy.DEFAULT_KEYLESS
+                default_response_policy = ResponsePolicy.DEFAULT_KEYLESS
+            else:
+                default_request_policy = RequestPolicy.DEFAULT_KEYED
+                default_response_policy = ResponsePolicy.DEFAULT_KEYED
+
+            # Check if it's a core or module command
+            split_name = command.split(".")
+
+            if len(split_name) > 1:
+                module_name = split_name[0]
+                command_name = split_name[1]
+            else:
+                module_name = "core"
+                command_name = split_name[0]
+
+            # Create a CommandPolicies object with default policies on the new command.
+            if command_with_policies.get(module_name, None) is None:
+                command_with_policies[module_name] = {
+                    command_name: CommandPolicies(
+                        request_policy=default_request_policy,
+                        response_policy=default_response_policy,
+                    )
+                }
+            else:
+                command_with_policies[module_name][command_name] = CommandPolicies(
+                    request_policy=default_request_policy,
+                    response_policy=default_response_policy,
+                )
+
+            tips = details.get("tips")
+            subcommands = details.get("subcommands")
+
+            # Process tips for the main command
+            if tips:
+                extract_policies(tips, module_name, command_name)
+
+            # Process subcommands
+            if subcommands:
+                for subcommand_details in subcommands:
+                    # Get the subcommand name (first element)
+                    subcmd_name = subcommand_details[0]
+                    if isinstance(subcmd_name, bytes):
+                        subcmd_name = subcmd_name.decode()
+
+                    # Check whether the subcommand has keys
+                    is_keyless = self._is_keyless_command(command, subcmd_name)
+
+                    if is_keyless:
+                        default_request_policy = RequestPolicy.DEFAULT_KEYLESS
+                        default_response_policy = ResponsePolicy.DEFAULT_KEYLESS
+                    else:
+                        default_request_policy = RequestPolicy.DEFAULT_KEYED
+                        default_response_policy = ResponsePolicy.DEFAULT_KEYED
+
+                    subcmd_name = subcmd_name.replace("|", " ")
+
+                    # Create a CommandPolicies object with default policies on the new command.
+                    command_with_policies[module_name][subcmd_name] = CommandPolicies(
+                        request_policy=default_request_policy,
+                        response_policy=default_response_policy,
+                    )
+
+                    # Recursively extract policies from the rest of the subcommand details
+                    for subcommand_detail in subcommand_details[1:]:
+                        extract_policies(subcommand_detail, module_name, subcmd_name)
+
+        return command_with_policies
+
 
 class AsyncCommandsParser(AbstractCommandsParser):
     """
@@ -251,7 +476,9 @@ async def get_keys(self, *args: Any) -> Optional[Tuple[str, ...]]:
                     for subcmd in command["subcommands"]:
                         if str_if_bytes(subcmd[0]) == subcmd_name:
                             command = self.parse_subcommand(subcmd)
-                            is_subcmd = True
+
+                            if command["first_key_pos"] > 0:
+                                is_subcmd = True
 
                 # The command doesn't have keys in it
                 if not is_subcmd:
@@ -279,3 +506,187 @@ async def _get_moveable_keys(self, *args: Any) -> Optional[Tuple[str, ...]]:
             else:
                 raise e
         return keys
+
+    async def _is_keyless_command(
+        self, command_name: str, subcommand_name: Optional[str] = None
+    ) -> bool:
+        """
+        Determines whether a given command or subcommand is considered "keyless".
+
+        A keyless command does not operate on specific keys, which is determined based
+        on the first key position in the command or subcommand details. If the command
+        or subcommand's first key position is zero or negative, it is treated as keyless.
+
+        Parameters:
+            command_name: str
+                The name of the command to check.
+            subcommand_name: Optional[str], default=None
+                The name of the subcommand to check, if applicable. If not provided,
+                the check is performed only on the command.
+
+        Returns:
+            bool
+                True if the specified command or subcommand is considered keyless,
+                False otherwise.
+
+        Raises:
+            ValueError
+                If the specified subcommand is not found within the command or the
+                specified command does not exist in the available commands.
+        """
+        if subcommand_name:
+            for subcommand in self.commands.get(command_name)["subcommands"]:
+                if str_if_bytes(subcommand[0]) == subcommand_name:
+                    parsed_subcmd = self.parse_subcommand(subcommand)
+                    return parsed_subcmd["first_key_pos"] <= 0
+            raise ValueError(
+                f"Subcommand {subcommand_name} not found in command {command_name}"
+            )
+        else:
+            command_details = self.commands.get(command_name, None)
+            if command_details is not None:
+                return command_details["first_key_pos"] <= 0
+
+            raise ValueError(f"Command {command_name} not found in commands")
+
+    async def get_command_policies(self) -> Awaitable[PolicyRecords]:
+        """
+        Retrieve and process the command policies for all commands and subcommands.
+
+        This method traverses through commands and subcommands, extracting policy details
+        from associated data structures and constructing a dictionary of commands with their
+        associated policies. It supports nested data structures and handles both main commands
+        and their subcommands.
+
+        Returns:
+            PolicyRecords: A collection of commands and subcommands associated with their
+            respective policies.
+
+        Raises:
+            IncorrectPolicyType: If an invalid policy type is encountered during policy extraction.
+        """
+        command_with_policies = {}
+
+        def extract_policies(data, module_name, command_name):
+            """
+            Recursively extract policies from nested data structures.
+
+            Args:
+                data: The data structure to search (can be list, dict, str, bytes, etc.)
+                command_name: The command name to associate with found policies
+            """
+            if isinstance(data, (str, bytes)):
+                # Decode bytes to string if needed
+                policy = str_if_bytes(data.decode())
+
+                # Check if this is a policy string
+                if policy.startswith("request_policy") or policy.startswith(
+                    "response_policy"
+                ):
+                    if policy.startswith("request_policy"):
+                        policy_type = policy.split(":")[1]
+
+                        try:
+                            command_with_policies[module_name][
+                                command_name
+                            ].request_policy = RequestPolicy(policy_type)
+                        except ValueError:
+                            raise IncorrectPolicyType(
+                                f"Incorrect request policy type: {policy_type}"
+                            )
+
+                    if policy.startswith("response_policy"):
+                        policy_type = policy.split(":")[1]
+
+                        try:
+                            command_with_policies[module_name][
+                                command_name
+                            ].response_policy = ResponsePolicy(policy_type)
+                        except ValueError:
+                            raise IncorrectPolicyType(
+                                f"Incorrect response policy type: {policy_type}"
+                            )
+
+            elif isinstance(data, list):
+                # For lists, recursively process each element
+                for item in data:
+                    extract_policies(item, module_name, command_name)
+
+            elif isinstance(data, dict):
+                # For dictionaries, recursively process each value
+                for value in data.values():
+                    extract_policies(value, module_name, command_name)
+
+        for command, details in self.commands.items():
+            # Check whether the command has keys
+            is_keyless = await self._is_keyless_command(command)
+
+            if is_keyless:
+                default_request_policy = RequestPolicy.DEFAULT_KEYLESS
+                default_response_policy = ResponsePolicy.DEFAULT_KEYLESS
+            else:
+                default_request_policy = RequestPolicy.DEFAULT_KEYED
+                default_response_policy = ResponsePolicy.DEFAULT_KEYED
+
+            # Check if it's a core or module command
+            split_name = command.split(".")
+
+            if len(split_name) > 1:
+                module_name = split_name[0]
+                command_name = split_name[1]
+            else:
+                module_name = "core"
+                command_name = split_name[0]
+
+            # Create a CommandPolicies object with default policies on the new command.
+            if command_with_policies.get(module_name, None) is None:
+                command_with_policies[module_name] = {
+                    command_name: CommandPolicies(
+                        request_policy=default_request_policy,
+                        response_policy=default_response_policy,
+                    )
+                }
+            else:
+                command_with_policies[module_name][command_name] = CommandPolicies(
+                    request_policy=default_request_policy,
+                    response_policy=default_response_policy,
+                )
+
+            tips = details.get("tips")
+            subcommands = details.get("subcommands")
+
+            # Process tips for the main command
+            if tips:
+                extract_policies(tips, module_name, command_name)
+
+            # Process subcommands
+            if subcommands:
+                for subcommand_details in subcommands:
+                    # Get the subcommand name (first element)
+                    subcmd_name = subcommand_details[0]
+                    if isinstance(subcmd_name, bytes):
+                        subcmd_name = subcmd_name.decode()
+
+                    # Check whether the subcommand has keys
+                    is_keyless = await self._is_keyless_command(command, subcmd_name)
+
+                    if is_keyless:
+                        default_request_policy = RequestPolicy.DEFAULT_KEYLESS
+                        default_response_policy = ResponsePolicy.DEFAULT_KEYLESS
+                    else:
+                        default_request_policy = RequestPolicy.DEFAULT_KEYED
+                        default_response_policy = ResponsePolicy.DEFAULT_KEYED
+
+                    subcmd_name = subcmd_name.replace("|", " ")
+
+                    # Create a CommandPolicies object with default policies on the new command.
+                    command_with_policies[module_name][subcmd_name] = CommandPolicies(
+                        request_policy=default_request_policy,
+                        response_policy=default_response_policy,
+                    )
+
+                    # Recursively extract policies from the rest of the subcommand details
+                    for subcommand_detail in subcommand_details[1:]:
+                        extract_policies(subcommand_detail, module_name, subcmd_name)
+
+        return command_with_policies
diff --git a/redis/asyncio/cluster.py b/redis/asyncio/cluster.py
index 225fd3b79f..d70569bb95 100644
--- a/redis/asyncio/cluster.py
+++ b/redis/asyncio/cluster.py
@@ -26,6 +26,7 @@
 )
 
 from redis._parsers import AsyncCommandsParser, Encoder
+from redis._parsers.commands import CommandPolicies, RequestPolicy, ResponsePolicy
 from redis._parsers.helpers import (
     _RedisCallbacks,
     _RedisCallbacksRESP2,
@@ -51,6 +52,7 @@
     parse_cluster_slots,
 )
 from redis.commands import READ_COMMANDS, AsyncRedisClusterCommands
+from redis.commands.policies import AsyncPolicyResolver, AsyncStaticPolicyResolver
 from redis.crc import REDIS_CLUSTER_HASH_SLOTS, key_slot
 from redis.credentials import CredentialProvider
 from redis.event import AfterAsyncClusterInstantiationEvent, EventDispatcher
@@ -310,6 +312,7 @@ def __init__(
         protocol: Optional[int] = 2,
         address_remap: Optional[Callable[[Tuple[str, int]], Tuple[str, int]]] = None,
         event_dispatcher: Optional[EventDispatcher] = None,
+        policy_resolver: AsyncPolicyResolver = AsyncStaticPolicyResolver(),
     ) -> None:
         if db:
             raise RedisClusterException(
@@ -423,7 +426,36 @@ def __init__(
         self.load_balancing_strategy = load_balancing_strategy
         self.reinitialize_steps = reinitialize_steps
         self.reinitialize_counter = 0
+
+        # For backward compatibility, mapping from existing policies to new one
+        self._command_flags_mapping: dict[str, Union[RequestPolicy, ResponsePolicy]] = {
+            self.__class__.RANDOM: RequestPolicy.DEFAULT_KEYLESS,
+            self.__class__.PRIMARIES: RequestPolicy.ALL_SHARDS,
+            self.__class__.ALL_NODES: RequestPolicy.ALL_NODES,
+            self.__class__.REPLICAS: RequestPolicy.ALL_REPLICAS,
+            self.__class__.DEFAULT_NODE: RequestPolicy.DEFAULT_NODE,
+            SLOT_ID: RequestPolicy.DEFAULT_KEYED,
+        }
+
+        self._policies_callback_mapping: dict[
+            Union[RequestPolicy, ResponsePolicy], Callable
+        ] = {
+            RequestPolicy.DEFAULT_KEYLESS: lambda command_name: [
+                self.get_random_primary_or_all_nodes(command_name)
+            ],
+            RequestPolicy.DEFAULT_KEYED: self.get_nodes_from_slot,
+            RequestPolicy.DEFAULT_NODE: lambda: [self.get_default_node()],
+            RequestPolicy.ALL_SHARDS: self.get_primaries,
+            RequestPolicy.ALL_NODES: self.get_nodes,
+            RequestPolicy.ALL_REPLICAS: self.get_replicas,
+            RequestPolicy.SPECIAL: self.get_special_nodes,
+            ResponsePolicy.DEFAULT_KEYLESS: lambda res: res,
+            ResponsePolicy.DEFAULT_KEYED: lambda res: res,
+        }
+
+        self._policy_resolver = policy_resolver
         self.commands_parser = AsyncCommandsParser()
+        self._aggregate_nodes = None
         self.node_flags = self.__class__.NODE_FLAGS.copy()
         self.command_flags = self.__class__.COMMAND_FLAGS.copy()
         self.response_callbacks = kwargs["response_callbacks"]
@@ -619,6 +651,45 @@ def get_node_from_key(
 
         return slot_cache[node_idx]
 
+    def get_random_primary_or_all_nodes(self, command_name):
+        """
+        Returns random primary or all nodes depends on READONLY mode.
+        """
+        if self.read_from_replicas and command_name in READ_COMMANDS:
+            return self.get_random_node()
+
+        return self.get_random_primary_node()
+
+    def get_random_primary_node(self) -> "ClusterNode":
+        """
+        Returns a random primary node
+        """
+        return random.choice(self.get_primaries())
+
+    async def get_nodes_from_slot(self, command: str, *args):
+        """
+        Returns a list of nodes that hold the specified keys' slots.
+        """
+        # get the node that holds the key's slot
+        return [
+            self.nodes_manager.get_node_from_slot(
+                await self._determine_slot(command, *args),
+                self.read_from_replicas and command in READ_COMMANDS,
+                self.load_balancing_strategy if command in READ_COMMANDS else None,
+            )
+        ]
+
+    def get_special_nodes(self) -> Optional[list["ClusterNode"]]:
+        """
+        Returns a list of nodes for commands with a special policy.
+        """
+        if not self._aggregate_nodes:
+            raise RedisClusterException(
+                "Cannot execute FT.CURSOR commands without FT.AGGREGATE"
+            )
+
+        return self._aggregate_nodes
+
     def keyslot(self, key: EncodableT) -> int:
         """
         Find the keyslot for a given key.
@@ -643,7 +714,11 @@ def set_response_callback(self, command: str, callback: ResponseCallbackT) -> No
         self.response_callbacks[command] = callback
 
     async def _determine_nodes(
-        self, command: str, *args: Any, node_flag: Optional[str] = None
+        self,
+        command: str,
+        *args: Any,
+        request_policy: RequestPolicy,
+        node_flag: Optional[str] = None,
     ) -> List["ClusterNode"]:
         # Determine which nodes should be executed the command on.
         # Returns a list of target nodes.
@@ -651,31 +726,22 @@ async def _determine_nodes(
             # get the nodes group for this command if it was predefined
             node_flag = self.command_flags.get(command)
 
-        if node_flag in self.node_flags:
-            if node_flag == self.__class__.DEFAULT_NODE:
-                # return the cluster's default node
-                return [self.nodes_manager.default_node]
-            if node_flag == self.__class__.PRIMARIES:
-                # return all primaries
-                return self.nodes_manager.get_nodes_by_server_type(PRIMARY)
-            if node_flag == self.__class__.REPLICAS:
-                # return all replicas
-                return self.nodes_manager.get_nodes_by_server_type(REPLICA)
-            if node_flag == self.__class__.ALL_NODES:
-                # return all nodes
-                return list(self.nodes_manager.nodes_cache.values())
-            if node_flag == self.__class__.RANDOM:
-                # return a random node
-                return [random.choice(list(self.nodes_manager.nodes_cache.values()))]
+        if node_flag in self._command_flags_mapping:
+            request_policy = self._command_flags_mapping[node_flag]
 
-        # get the node that holds the key's slot
-        return [
-            self.nodes_manager.get_node_from_slot(
-                await self._determine_slot(command, *args),
-                self.read_from_replicas and command in READ_COMMANDS,
-                self.load_balancing_strategy if command in READ_COMMANDS else None,
-            )
-        ]
+        policy_callback = self._policies_callback_mapping[request_policy]
+
+        if request_policy == RequestPolicy.DEFAULT_KEYED:
+            nodes = await policy_callback(command, *args)
+        elif request_policy == RequestPolicy.DEFAULT_KEYLESS:
+            nodes = policy_callback(command)
+        else:
+            nodes = policy_callback()
+
+        if command.lower() == "ft.aggregate":
+            self._aggregate_nodes = nodes
+
+        return nodes
 
     async def _determine_slot(self, command: str, *args: Any) -> int:
         if self.command_flags.get(command) == SLOT_ID:
@@ -780,6 +846,33 @@ async def execute_command(self, *args: EncodableT, **kwargs: Any) -> Any:
             target_nodes_specified = True
             retry_attempts = 0
 
+        command_policies = await self._policy_resolver.resolve(args[0].lower())
+
+        if not command_policies and not target_nodes_specified:
+            command_flag = self.command_flags.get(command)
+            if not command_flag:
+                # Fallback to default policy
+                if not self.get_default_node():
+                    slot = None
+                else:
+                    slot = await self._determine_slot(*args)
+                if not slot:
+                    command_policies = CommandPolicies()
+                else:
+                    command_policies = CommandPolicies(
+                        request_policy=RequestPolicy.DEFAULT_KEYED,
+                        response_policy=ResponsePolicy.DEFAULT_KEYED,
+                    )
+            else:
+                if command_flag in self._command_flags_mapping:
+                    command_policies = CommandPolicies(
+                        request_policy=self._command_flags_mapping[command_flag]
+                    )
+                else:
+                    command_policies = CommandPolicies()
+        elif not command_policies and target_nodes_specified:
+            command_policies = CommandPolicies()
+
         # Add one for the first execution
         execute_attempts = 1 + retry_attempts
         for _ in range(execute_attempts):
@@ -795,7 +888,9 @@ async def execute_command(self, *args: EncodableT, **kwargs: Any) -> Any:
                 if not target_nodes_specified:
                     # Determine the nodes to execute the command on
                     target_nodes = await self._determine_nodes(
-                        *args, node_flag=passed_targets
+                        *args,
+                        request_policy=command_policies.request_policy,
+                        node_flag=passed_targets,
                     )
                     if not target_nodes:
                         raise RedisClusterException(
@@ -806,10 +901,12 @@ async def execute_command(self, *args: EncodableT, **kwargs: Any) -> Any:
                     # Return the processed result
                     ret = await self._execute_command(target_nodes[0], *args, **kwargs)
                     if command in self.result_callbacks:
-                        return self.result_callbacks[command](
+                        ret = self.result_callbacks[command](
                             command, {target_nodes[0].name: ret}, **kwargs
                         )
-                    return ret
+                    return self._policies_callback_mapping[
+                        command_policies.response_policy
+                    ](ret)
                 else:
                     keys = [node.name for node in target_nodes]
                     values = await asyncio.gather(
@@ -824,7 +921,9 @@ async def execute_command(self, *args: EncodableT, **kwargs: Any) -> Any:
                         return self.result_callbacks[command](
                             command, dict(zip(keys, values)), **kwargs
                         )
-                    return dict(zip(keys, values))
+                    return self._policies_callback_mapping[
+                        command_policies.response_policy
+                    ](dict(zip(keys, values)))
             except Exception as e:
                 if retry_attempts > 0 and type(e) in self.__class__.ERRORS_ALLOW_RETRY:
                     # The nodes and slots cache were should be reinitialized.
@@ -1740,6 +1839,7 @@ def __init__(self, position: int, *args: Any, **kwargs: Any) -> None:
         self.kwargs = kwargs
         self.position = position
         self.result: Union[Any, Exception] = None
+        self.command_policies: Optional[CommandPolicies] = None
 
     def __repr__(self) -> str:
         return f"[{self.position}] {self.args} ({self.kwargs})"
@@ -1980,16 +2080,51 @@ async def _execute(
         nodes = {}
         for cmd in todo:
             passed_targets = cmd.kwargs.pop("target_nodes", None)
+            command_policies = await client._policy_resolver.resolve(
+                cmd.args[0].lower()
+            )
+
             if passed_targets and not client._is_node_flag(passed_targets):
                 target_nodes = client._parse_target_nodes(passed_targets)
+
+                if not command_policies:
+                    command_policies = CommandPolicies()
             else:
+                if not command_policies:
+                    command_flag = client.command_flags.get(cmd.args[0])
+                    if not command_flag:
+                        # Fallback to default policy
+                        if not client.get_default_node():
+                            slot = None
+                        else:
+                            slot = await client._determine_slot(*cmd.args)
+                        if not slot:
+                            command_policies = CommandPolicies()
+                        else:
+                            command_policies = CommandPolicies(
+                                request_policy=RequestPolicy.DEFAULT_KEYED,
+                                response_policy=ResponsePolicy.DEFAULT_KEYED,
+                            )
+                    else:
+                        if command_flag in client._command_flags_mapping:
+                            command_policies = CommandPolicies(
+                                request_policy=client._command_flags_mapping[
+                                    command_flag
+                                ]
+                            )
+                        else:
+                            command_policies = CommandPolicies()
+
                 target_nodes = await client._determine_nodes(
-                    *cmd.args, node_flag=passed_targets
+                    *cmd.args,
+                    request_policy=command_policies.request_policy,
+                    node_flag=passed_targets,
                 )
                 if not target_nodes:
                     raise RedisClusterException(
                         f"No targets were found to execute {cmd.args} command on"
                     )
+            cmd.command_policies = command_policies
             if len(target_nodes) > 1:
                 raise RedisClusterException(f"Too many targets for command {cmd.args}")
             node = target_nodes[0]
@@ -2010,9 +2145,9 @@ async def _execute(
                 for cmd in todo:
                     if isinstance(cmd.result, (TryAgainError, MovedError, AskError)):
                         try:
-                            cmd.result = await client.execute_command(
-                                *cmd.args, **cmd.kwargs
-                            )
+                            cmd.result = client._policies_callback_mapping[
+                                cmd.command_policies.response_policy
+                            ](await client.execute_command(*cmd.args, **cmd.kwargs))
                         except Exception as e:
                             cmd.result = e
 
diff --git a/redis/cluster.py b/redis/cluster.py
index b34f3ea9da..33b54b1bed 100644
--- a/redis/cluster.py
+++ b/redis/cluster.py
@@ -11,12 +11,14 @@
 from typing import Any, Callable, Dict, List, Optional, Set, Tuple, Union
 
 from redis._parsers import CommandsParser, Encoder
+from redis._parsers.commands import CommandPolicies, RequestPolicy, ResponsePolicy
 from redis._parsers.helpers import parse_scan
 from redis.backoff import ExponentialWithJitterBackoff, NoBackoff
 from redis.cache import CacheConfig, CacheFactory, CacheFactoryInterface, CacheInterface
 from redis.client import EMPTY_RESPONSE, CaseInsensitiveDict, PubSub, Redis
 from redis.commands import READ_COMMANDS, RedisClusterCommands
 from redis.commands.helpers import list_or_args
+from redis.commands.policies import PolicyResolver, StaticPolicyResolver
 from redis.connection import (
     Connection,
     ConnectionPool,
@@ -532,6 +534,7 @@ def __init__(
         cache: Optional[CacheInterface] = None,
         cache_config: Optional[CacheConfig] = None,
         event_dispatcher: Optional[EventDispatcher] = None,
+        policy_resolver: PolicyResolver = StaticPolicyResolver(),
         **kwargs,
     ):
         """
@@ -714,7 +717,40 @@ def __init__(
         )
         self.result_callbacks = CaseInsensitiveDict(self.__class__.RESULT_CALLBACKS)
 
+        # For backward compatibility, mapping from existing policies to new one
+        self._command_flags_mapping: dict[str, Union[RequestPolicy, ResponsePolicy]] = {
+            self.__class__.RANDOM: RequestPolicy.DEFAULT_KEYLESS,
+            self.__class__.PRIMARIES: RequestPolicy.ALL_SHARDS,
+            self.__class__.ALL_NODES: RequestPolicy.ALL_NODES,
+            self.__class__.REPLICAS: RequestPolicy.ALL_REPLICAS,
+            self.__class__.DEFAULT_NODE: RequestPolicy.DEFAULT_NODE,
+            SLOT_ID: RequestPolicy.DEFAULT_KEYED,
+        }
+
+        self._policies_callback_mapping: dict[
+            Union[RequestPolicy, ResponsePolicy], Callable
+        ] = {
+            RequestPolicy.DEFAULT_KEYLESS: lambda command_name: [
+                self.get_random_primary_or_all_nodes(command_name)
+            ],
+            RequestPolicy.DEFAULT_KEYED: lambda command,
+            *args: self.get_nodes_from_slot(command, *args),
+            RequestPolicy.DEFAULT_NODE: lambda: [self.get_default_node()],
+            RequestPolicy.ALL_SHARDS: self.get_primaries,
+            RequestPolicy.ALL_NODES: self.get_nodes,
+            RequestPolicy.ALL_REPLICAS: self.get_replicas,
+            RequestPolicy.MULTI_SHARD: lambda *args,
+            **kwargs: self._split_multi_shard_command(*args, **kwargs),
+            RequestPolicy.SPECIAL: self.get_special_nodes,
+            ResponsePolicy.DEFAULT_KEYLESS: lambda res: res,
+            ResponsePolicy.DEFAULT_KEYED: lambda res: res,
+        }
+
+        self._policy_resolver = policy_resolver
         self.commands_parser = CommandsParser(self)
+
+        # Node where FT.AGGREGATE command is executed.
+        self._aggregate_nodes = None
         self._lock = threading.RLock()
 
     def __enter__(self):
@@ -777,6 +813,15 @@ def get_replicas(self):
     def get_random_node(self):
         return random.choice(list(self.nodes_manager.nodes_cache.values()))
 
+    def get_random_primary_or_all_nodes(self, command_name):
+        """
+        Returns random primary or all nodes depends on READONLY mode.
+        """
+        if self.read_from_replicas and command_name in READ_COMMANDS:
+            return self.get_random_node()
+
+        return self.get_random_primary_node()
+
     def get_nodes(self):
         return list(self.nodes_manager.nodes_cache.values())
 
@@ -806,6 +851,77 @@ def get_default_node(self):
         """
         return self.nodes_manager.default_node
 
+    def get_nodes_from_slot(self, command: str, *args):
+        """
+        Returns a list of nodes that hold the specified keys' slots.
+        """
+        # get the node that holds the key's slot
+        slot = self.determine_slot(*args)
+        node = self.nodes_manager.get_node_from_slot(
+            slot,
+            self.read_from_replicas and command in READ_COMMANDS,
+            self.load_balancing_strategy if command in READ_COMMANDS else None,
+        )
+        return [node]
+
+    def _split_multi_shard_command(self, *args, **kwargs) -> list[dict]:
+        """
+        Splits the command with Multi-Shard policy, to the multiple commands
+        """
+        keys = self._get_command_keys(*args)
+        commands = []
+
+        for key in keys:
+            commands.append(
+                {
+                    "args": (args[0], key),
+                    "kwargs": kwargs,
+                }
+            )
+
+        return commands
+
+    def get_special_nodes(self) -> Optional[list["ClusterNode"]]:
+        """
+        Returns a list of nodes for commands with a special policy.
+        """
+        if not self._aggregate_nodes:
+            raise RedisClusterException(
+                "Cannot execute FT.CURSOR commands without FT.AGGREGATE"
+            )
+
+        return self._aggregate_nodes
+
+    def get_random_primary_node(self) -> "ClusterNode":
+        """
+        Returns a random primary node
+        """
+        return random.choice(self.get_primaries())
+
+    def _evaluate_all_succeeded(self, res):
+        """
+        Evaluate the result of a command with ResponsePolicy.ALL_SUCCEEDED
+        """
+        first_successful_response = None
+
+        if isinstance(res, dict):
+            for key, value in res.items():
+                if value:
+                    if first_successful_response is None:
+                        first_successful_response = {key: value}
+                else:
+                    return {key: False}
+        else:
+            for response in res:
+                if response:
+                    if first_successful_response is None:
+                        # Dynamically resolve type
+                        first_successful_response = type(response)(response)
+                else:
+                    return type(response)(False)
+
+        return first_successful_response
+
     def set_default_node(self, node):
         """
         Set the default node of the cluster.
@@ -955,9 +1071,12 @@ def set_response_callback(self, command, callback):
         """Set a custom Response Callback"""
         self.cluster_response_callbacks[command] = callback
 
-    def _determine_nodes(self, *args, **kwargs) -> List["ClusterNode"]:
-        # Determine which nodes should be executed the command on.
-        # Returns a list of target nodes.
+    def _determine_nodes(
+        self, *args, request_policy: RequestPolicy, **kwargs
+    ) -> List["ClusterNode"]:
+        """
+        Determines a nodes the command should be executed on.
+        """
         command = args[0].upper()
         if len(args) >= 2 and f"{args[0]} {args[1]}".upper() in self.command_flags:
             command = f"{args[0]} {args[1]}".upper()
@@ -969,32 +1088,25 @@ def _determine_nodes(self, *args, **kwargs) -> List["ClusterNode"]:
         else:
             # get the nodes group for this command if it was predefined
             command_flag = self.command_flags.get(command)
-        if command_flag == self.__class__.RANDOM:
-            # return a random node
-            return [self.get_random_node()]
-        elif command_flag == self.__class__.PRIMARIES:
-            # return all primaries
-            return self.get_primaries()
-        elif command_flag == self.__class__.REPLICAS:
-            # return all replicas
-            return self.get_replicas()
-        elif command_flag == self.__class__.ALL_NODES:
-            # return all nodes
-            return self.get_nodes()
-        elif command_flag == self.__class__.DEFAULT_NODE:
-            # return the cluster's default node
-            return [self.nodes_manager.default_node]
-        elif command in self.__class__.SEARCH_COMMANDS[0]:
-            return [self.nodes_manager.default_node]
+
+        if command_flag in self._command_flags_mapping:
+            request_policy = self._command_flags_mapping[command_flag]
+
+        policy_callback = self._policies_callback_mapping[request_policy]
+
+        if request_policy == RequestPolicy.DEFAULT_KEYED:
+            nodes = policy_callback(command, *args)
+        elif request_policy == RequestPolicy.MULTI_SHARD:
+            nodes = policy_callback(*args, **kwargs)
+        elif request_policy == RequestPolicy.DEFAULT_KEYLESS:
+            nodes = policy_callback(args[0])
         else:
-            # get the node that holds the key's slot
-            slot = self.determine_slot(*args)
-            node = self.nodes_manager.get_node_from_slot(
-                slot,
-                self.read_from_replicas and command in READ_COMMANDS,
-                self.load_balancing_strategy if command in READ_COMMANDS else None,
-            )
-            return [node]
+            nodes = policy_callback()
+
+        if args[0].lower() == "ft.aggregate":
+            self._aggregate_nodes = nodes
+
+        return nodes
 
     def _should_reinitialized(self):
         # To reinitialize the cluster on every MOVED error,
@@ -1144,9 +1256,43 @@ def _internal_execute_command(self, *args, **kwargs):
         is_default_node = False
         target_nodes = None
         passed_targets = kwargs.pop("target_nodes", None)
+        command_policies = self._policy_resolver.resolve(args[0].lower())
+
         if passed_targets is not None and not self._is_nodes_flag(passed_targets):
             target_nodes = self._parse_target_nodes(passed_targets)
             target_nodes_specified = True
+
+        if not command_policies and not target_nodes_specified:
+            command = args[0].upper()
+            if len(args) >= 2 and f"{args[0]} {args[1]}".upper() in self.command_flags:
+                command = f"{args[0]} {args[1]}".upper()
+
+            # We only could resolve key properties if command is not
+            # in a list of pre-defined request policies
+            command_flag = self.command_flags.get(command)
+            if not command_flag:
+                # Fallback to default policy
+                if not self.get_default_node():
+                    slot = None
+                else:
+                    slot = self.determine_slot(*args)
+                if not slot:
+                    command_policies = CommandPolicies()
+                else:
+                    command_policies = CommandPolicies(
+                        request_policy=RequestPolicy.DEFAULT_KEYED,
+                        response_policy=ResponsePolicy.DEFAULT_KEYED,
+                    )
+            else:
+                if command_flag in self._command_flags_mapping:
+                    command_policies = CommandPolicies(
+                        request_policy=self._command_flags_mapping[command_flag]
+                    )
+                else:
+                    command_policies = CommandPolicies()
+        elif not command_policies and target_nodes_specified:
+            command_policies = CommandPolicies()
+
         # If an error that allows retrying was thrown, the nodes and slots
         # cache were reinitialized. We will retry executing the command with
         # the updated cluster setup only when the target nodes can be
@@ -1164,7 +1310,9 @@ def _internal_execute_command(self, *args, **kwargs):
                 if not target_nodes_specified:
                     # Determine the nodes to execute the command on
                     target_nodes = self._determine_nodes(
-                        *args, **kwargs, nodes_flag=passed_targets
+                        *args,
+                        request_policy=command_policies.request_policy,
+                        nodes_flag=passed_targets,
                     )
                     if not target_nodes:
                         raise RedisClusterException(
@@ -1177,8 +1325,17 @@ def _internal_execute_command(self, *args, **kwargs):
                         is_default_node = True
                 for node in target_nodes:
                     res[node.name] = self._execute_command(node, *args, **kwargs)
+
+                    if command_policies.response_policy == ResponsePolicy.ONE_SUCCEEDED:
+                        break
+
                 # Return the processed result
-                return self._process_result(args[0], res, **kwargs)
+                return self._process_result(
+                    args[0],
+                    res,
+                    response_policy=command_policies.response_policy,
+                    **kwargs,
+                )
             except Exception as e:
                 if retry_attempts > 0 and type(e) in self.__class__.ERRORS_ALLOW_RETRY:
                     if is_default_node:
@@ -1318,7 +1475,7 @@ def close(self) -> None:
             # RedisCluster's __init__ can fail before nodes_manager is set
             pass
 
-    def _process_result(self, command, res, **kwargs):
+    def _process_result(self, command, res, response_policy: ResponsePolicy, **kwargs):
         """
         Process the result of the executed command.
         The function would return a dict or a single value.
@@ -1330,13 +1487,13 @@ def _process_result(self, command, res, **kwargs):
             Dict<node_name, command_result>
         """
         if command in self.result_callbacks:
-            return self.result_callbacks[command](command, res, **kwargs)
+            res = self.result_callbacks[command](command, res, **kwargs)
         elif len(res) == 1:
             # When we execute the command on a single node, we can
             # remove the dictionary and return a single response
-            return list(res.values())[0]
-        else:
-            return res
+            res = list(res.values())[0]
+
+        return self._policies_callback_mapping[response_policy](res)
 
     def load_external_module(self, funcname, func):
         """
@@ -2162,6 +2319,7 @@ def __init__(
         retry: Optional[Retry] = None,
         lock=None,
         transaction=False,
+        policy_resolver: PolicyResolver = StaticPolicyResolver(),
         **kwargs,
     ):
         """ """
@@ -2200,6 +2358,37 @@ def __init__(
             PipelineStrategy(self) if not transaction else TransactionStrategy(self)
         )
 
+        # For backward compatibility, mapping from existing policies to new one
+        self._command_flags_mapping: dict[str, Union[RequestPolicy, ResponsePolicy]] = {
+            self.__class__.RANDOM: RequestPolicy.DEFAULT_KEYLESS,
+            self.__class__.PRIMARIES: RequestPolicy.ALL_SHARDS,
+            self.__class__.ALL_NODES: RequestPolicy.ALL_NODES,
+            self.__class__.REPLICAS: RequestPolicy.ALL_REPLICAS,
+            self.__class__.DEFAULT_NODE: RequestPolicy.DEFAULT_NODE,
+            SLOT_ID: RequestPolicy.DEFAULT_KEYED,
+        }
+
+        self._policies_callback_mapping: dict[
+            Union[RequestPolicy, ResponsePolicy], Callable
+        ] = {
+            RequestPolicy.DEFAULT_KEYLESS: lambda command_name: [
+                self.get_random_primary_or_all_nodes(command_name)
+            ],
+            RequestPolicy.DEFAULT_KEYED: lambda command,
+            *args: self.get_nodes_from_slot(command, *args),
+            RequestPolicy.DEFAULT_NODE: lambda: [self.get_default_node()],
+            RequestPolicy.ALL_SHARDS: self.get_primaries,
+            RequestPolicy.ALL_NODES: self.get_nodes,
+            RequestPolicy.ALL_REPLICAS: self.get_replicas,
+            RequestPolicy.MULTI_SHARD: lambda *args,
+            **kwargs: self._split_multi_shard_command(*args, **kwargs),
+            RequestPolicy.SPECIAL: self.get_special_nodes,
+            ResponsePolicy.DEFAULT_KEYLESS: lambda res: res,
+            ResponsePolicy.DEFAULT_KEYED: lambda res: res,
+        }
+
+        self._policy_resolver = policy_resolver
+
     def __repr__(self):
         """ """
         return f"{type(self).__name__}"
@@ -2421,6 +2610,7 @@ def __init__(self, args, options=None, position=None):
         self.result = None
         self.node = None
         self.asking = False
+        self.command_policies: Optional[CommandPolicies] = None
 
 
 class NodeCommands:
@@ -2779,6 +2969,8 @@ def _send_cluster_commands(
         # we figure out the slot number that command maps to, then from
         # the slot determine the node.
         for c in attempt:
+            command_policies = self._pipe._policy_resolver.resolve(c.args[0].lower())
+
             while True:
                 # refer to our internal node -> slot table that
                 # tells us where a given command should route to.
@@ -2787,14 +2979,55 @@ def _send_cluster_commands(
                 passed_targets = c.options.pop("target_nodes", None)
                 if passed_targets and not self._is_nodes_flag(passed_targets):
                     target_nodes = self._parse_target_nodes(passed_targets)
+
+                    if not command_policies:
+                        command_policies = CommandPolicies()
                 else:
+                    if not command_policies:
+                        command = c.args[0].upper()
+                        if (
+                            len(c.args) >= 2
+                            and f"{c.args[0]} {c.args[1]}".upper()
+                            in self._pipe.command_flags
+                        ):
+                            command = f"{c.args[0]} {c.args[1]}".upper()
+
+                        # We only could resolve key properties if command is not
+                        # in a list of pre-defined request policies
+                        command_flag = self.command_flags.get(command)
+                        if not command_flag:
+                            # Fallback to default policy
+                            if not self._pipe.get_default_node():
+                                keys = None
+                            else:
+                                keys = self._pipe._get_command_keys(*c.args)
+                            if not keys or len(keys) == 0:
+                                command_policies = CommandPolicies()
+                            else:
+                                command_policies = CommandPolicies(
+                                    request_policy=RequestPolicy.DEFAULT_KEYED,
+                                    response_policy=ResponsePolicy.DEFAULT_KEYED,
+                                )
+                        else:
+                            if command_flag in self._pipe._command_flags_mapping:
+                                command_policies = CommandPolicies(
+                                    request_policy=self._pipe._command_flags_mapping[
+                                        command_flag
+                                    ]
+                                )
+                            else:
+                                command_policies = CommandPolicies()
+
                     target_nodes = self._determine_nodes(
-                        *c.args, node_flag=passed_targets
+                        *c.args,
+                        request_policy=command_policies.request_policy,
+                        node_flag=passed_targets,
                     )
                     if not target_nodes:
                         raise RedisClusterException(
                             f"No targets were found to execute {c.args} command on"
                         )
+                c.command_policies = command_policies
                 if len(target_nodes) > 1:
                     raise RedisClusterException(
                         f"Too many targets for command {c.args}"
@@ -2919,8 +3152,12 @@ def _send_cluster_commands(
             if c.args[0] in self._pipe.cluster_response_callbacks:
                 # Remove keys entry, it needs only for cache.
                 c.options.pop("keys", None)
-                c.result = self._pipe.cluster_response_callbacks[c.args[0]](
-                    c.result, **c.options
+                c.result = self._pipe._policies_callback_mapping[
+                    c.command_policies.response_policy
+                ](
+                    self._pipe.cluster_response_callbacks[c.args[0]](
+                        c.result, **c.options
+                    )
                 )
             response.append(c.result)
 
@@ -2952,7 +3189,9 @@ def _parse_target_nodes(self, target_nodes):
             )
         return nodes
 
-    def _determine_nodes(self, *args, **kwargs) -> List["ClusterNode"]:
+    def _determine_nodes(
+        self, *args, request_policy: RequestPolicy, **kwargs
+    ) -> List["ClusterNode"]:
         # Determine which nodes should be executed the command on.
         # Returns a list of target nodes.
         command = args[0].upper()
@@ -2969,34 +3208,25 @@ def _determine_nodes(self, *args, **kwargs) -> List["ClusterNode"]:
         else:
             # get the nodes group for this command if it was predefined
             command_flag = self._pipe.command_flags.get(command)
-        if command_flag == self._pipe.RANDOM:
-            # return a random node
-            return [self._pipe.get_random_node()]
-        elif command_flag == self._pipe.PRIMARIES:
-            # return all primaries
-            return self._pipe.get_primaries()
-        elif command_flag == self._pipe.REPLICAS:
-            # return all replicas
-            return self._pipe.get_replicas()
-        elif command_flag == self._pipe.ALL_NODES:
-            # return all nodes
-            return self._pipe.get_nodes()
-        elif command_flag == self._pipe.DEFAULT_NODE:
-            # return the cluster's default node
-            return [self._nodes_manager.default_node]
-        elif command in self._pipe.SEARCH_COMMANDS[0]:
-            return [self._nodes_manager.default_node]
+
+        if command_flag in self._pipe._command_flags_mapping:
+            request_policy = self._pipe._command_flags_mapping[command_flag]
+
+        policy_callback = self._pipe._policies_callback_mapping[request_policy]
+
+        if request_policy == RequestPolicy.DEFAULT_KEYED:
+            nodes = policy_callback(command, *args)
+        elif request_policy == RequestPolicy.MULTI_SHARD:
+            nodes = policy_callback(*args, **kwargs)
+        elif request_policy == RequestPolicy.DEFAULT_KEYLESS:
+            nodes = policy_callback(args[0])
         else:
-            # get the node that holds the key's slot
-            slot = self._pipe.determine_slot(*args)
-            node = self._nodes_manager.get_node_from_slot(
-                slot,
-                self._pipe.read_from_replicas and command in READ_COMMANDS,
-                self._pipe.load_balancing_strategy
-                if command in READ_COMMANDS
-                else None,
-            )
-            return [node]
+            nodes = policy_callback()
+
+        if args[0].lower() == "ft.aggregate":
+            self._aggregate_nodes = nodes
+
+        return nodes
 
     def multi(self):
         raise RedisClusterException(
diff --git a/redis/commands/policies.py b/redis/commands/policies.py
new file mode 100644
index 0000000000..c0c98d37f1
--- /dev/null
+++ b/redis/commands/policies.py
@@ -0,0 +1,330 @@
+from abc import ABC, abstractmethod
+from typing import Optional
+
+from redis._parsers.commands import (
+    CommandPolicies,
+    CommandsParser,
+    PolicyRecords,
+    RequestPolicy,
+    ResponsePolicy,
+)
+
+STATIC_POLICIES: PolicyRecords = {
+    "ft": {
+        "explaincli": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+        "suglen": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYED,
+            response_policy=ResponsePolicy.DEFAULT_KEYED,
+        ),
+        "profile": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+        "dropindex": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+        "aliasupdate": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+        "alter": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+        "aggregate": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+        "syndump": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+        "create": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+        "explain": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+        "sugget": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYED,
+            response_policy=ResponsePolicy.DEFAULT_KEYED,
+        ),
+        "dictdel": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+        "aliasadd": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+        "dictadd": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+        "synupdate": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+        "drop": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+        "info": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+        "sugadd": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYED,
+            response_policy=ResponsePolicy.DEFAULT_KEYED,
+        ),
+        "dictdump": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+        "cursor": CommandPolicies(
+            request_policy=RequestPolicy.SPECIAL,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+        "search": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+        "tagvals": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+        "aliasdel": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+        "sugdel": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYED,
+            response_policy=ResponsePolicy.DEFAULT_KEYED,
+        ),
+        "spellcheck": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+    },
+    "core": {
+        "command": CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        ),
+    },
+}
+
+
+class PolicyResolver(ABC):
+    @abstractmethod
+    def resolve(self, command_name: str) -> Optional[CommandPolicies]:
+        """
+        Resolves the command name and determines the associated command policies.
+
+        Args:
+            command_name: The name of the command to resolve.
+
+        Returns:
+            CommandPolicies: The policies associated with the specified command.
+        """
+        pass
+
+    @abstractmethod
+    def with_fallback(self, fallback: "PolicyResolver") -> "PolicyResolver":
+        """
+        Factory method to instantiate a policy resolver with a fallback resolver.
+
+        Args:
+            fallback: Fallback resolver
+
+        Returns:
+            PolicyResolver: Returns a new policy resolver with the specified fallback resolver.
+        """
+        pass
+
+
+class AsyncPolicyResolver(ABC):
+    @abstractmethod
+    async def resolve(self, command_name: str) -> Optional[CommandPolicies]:
+        """
+        Resolves the command name and determines the associated command policies.
+
+        Args:
+            command_name: The name of the command to resolve.
+
+        Returns:
+            CommandPolicies: The policies associated with the specified command.
+        """
+        pass
+
+    @abstractmethod
+    def with_fallback(self, fallback: "AsyncPolicyResolver") -> "AsyncPolicyResolver":
+        """
+        Factory method to instantiate an async policy resolver with a fallback resolver.
+
+        Args:
+            fallback: Fallback resolver
+
+        Returns:
+            AsyncPolicyResolver: Returns a new policy resolver with the specified fallback resolver.
+        """
+        pass
+
+
+class BasePolicyResolver(PolicyResolver):
+    """
+    Base class for policy resolvers.
+    """
+
+    def __init__(
+        self, policies: PolicyRecords, fallback: Optional[PolicyResolver] = None
+    ) -> None:
+        self._policies = policies
+        self._fallback = fallback
+
+    def resolve(self, command_name: str) -> Optional[CommandPolicies]:
+        parts = command_name.split(".")
+
+        if len(parts) > 2:
+            raise ValueError(f"Wrong command or module name: {command_name}")
+
+        module, command = parts if len(parts) == 2 else ("core", parts[0])
+
+        if self._policies.get(module, None) is None:
+            if self._fallback is not None:
+                return self._fallback.resolve(command_name)
+            else:
+                return None
+
+        if self._policies.get(module).get(command, None) is None:
+            if self._fallback is not None:
+                return self._fallback.resolve(command_name)
+            else:
+                return None
+
+        return self._policies.get(module).get(command)
+
+    @abstractmethod
+    def with_fallback(self, fallback: "PolicyResolver") -> "PolicyResolver":
+        pass
+
+
+class AsyncBasePolicyResolver(AsyncPolicyResolver):
+    """
+    Async base class for policy resolvers.
+    """
+
+    def __init__(
+        self, policies: PolicyRecords, fallback: Optional[AsyncPolicyResolver] = None
+    ) -> None:
+        self._policies = policies
+        self._fallback = fallback
+
+    async def resolve(self, command_name: str) -> Optional[CommandPolicies]:
+        parts = command_name.split(".")
+
+        if len(parts) > 2:
+            raise ValueError(f"Wrong command or module name: {command_name}")
+
+        module, command = parts if len(parts) == 2 else ("core", parts[0])
+
+        if self._policies.get(module, None) is None:
+            if self._fallback is not None:
+                return await self._fallback.resolve(command_name)
+            else:
+                return None
+
+        if self._policies.get(module).get(command, None) is None:
+            if self._fallback is not None:
+                return await self._fallback.resolve(command_name)
+            else:
+                return None
+
+        return self._policies.get(module).get(command)
+
+    @abstractmethod
+    def with_fallback(self, fallback: "AsyncPolicyResolver") -> "AsyncPolicyResolver":
+        pass
+
+
+class DynamicPolicyResolver(BasePolicyResolver):
+    """
+    Resolves policy dynamically based on the COMMAND output.
+    """
+
+    def __init__(
+        self, commands_parser: CommandsParser, fallback: Optional[PolicyResolver] = None
+    ) -> None:
+        """
+        Parameters:
+            commands_parser (CommandsParser): COMMAND output parser.
+            fallback (Optional[PolicyResolver]): An optional resolver to be used when the
+                primary policies cannot handle a specific request.
+        """
+        self._commands_parser = commands_parser
+        super().__init__(commands_parser.get_command_policies(), fallback)
+
+    def with_fallback(self, fallback: "PolicyResolver") -> "PolicyResolver":
+        return DynamicPolicyResolver(self._commands_parser, fallback)
+
+
+class StaticPolicyResolver(BasePolicyResolver):
+    """
+    Resolves policy from a static list of policy records.
+    """
+
+    def __init__(self, fallback: Optional[PolicyResolver] = None) -> None:
+        """
+        Parameters:
+            fallback (Optional[PolicyResolver]): An optional fallback policy resolver
+            used for resolving policies if static policies are inadequate.
+        """
+        super().__init__(STATIC_POLICIES, fallback)
+
+    def with_fallback(self, fallback: "PolicyResolver") -> "PolicyResolver":
+        return StaticPolicyResolver(fallback)
+
+
+class AsyncDynamicPolicyResolver(AsyncBasePolicyResolver):
+    """
+    Async version of DynamicPolicyResolver.
+    """
+
+    def __init__(
+        self,
+        policy_records: PolicyRecords,
+        fallback: Optional[AsyncPolicyResolver] = None,
+    ) -> None:
+        """
+        Parameters:
+            policy_records (PolicyRecords): Policy records.
+            fallback (Optional[AsyncPolicyResolver]): An optional resolver to be used when the
+                primary policies cannot handle a specific request.
+        """
+        super().__init__(policy_records, fallback)
+
+    def with_fallback(self, fallback: "AsyncPolicyResolver") -> "AsyncPolicyResolver":
+        return AsyncDynamicPolicyResolver(self._policies, fallback)
+
+
+class AsyncStaticPolicyResolver(AsyncBasePolicyResolver):
+    """
+    Async version of StaticPolicyResolver.
+    """
+
+    def __init__(self, fallback: Optional[AsyncPolicyResolver] = None) -> None:
+        """
+        Parameters:
+            fallback (Optional[AsyncPolicyResolver]): An optional fallback policy resolver
+            used for resolving policies if static policies are inadequate.
+        """
+        super().__init__(STATIC_POLICIES, fallback)
+
+    def with_fallback(self, fallback: "AsyncPolicyResolver") -> "AsyncPolicyResolver":
+        return AsyncStaticPolicyResolver(fallback)
diff --git a/redis/exceptions.py b/redis/exceptions.py
index 1e21265524..dab17c5c1f 100644
--- a/redis/exceptions.py
+++ b/redis/exceptions.py
@@ -253,3 +253,11 @@ class ExternalAuthProviderError(ConnectionError):
     """
 
     pass
+
+
+class IncorrectPolicyType(Exception):
+    """
+    Raised when a policy type isn't matching to any known policy types.
+    """
+
+    pass
diff --git a/tests/test_asyncio/test_command_parser.py b/tests/test_asyncio/test_command_parser.py
new file mode 100644
index 0000000000..430a72f885
--- /dev/null
+++ b/tests/test_asyncio/test_command_parser.py
@@ -0,0 +1,161 @@
+import pytest
+
+from redis._parsers import AsyncCommandsParser
+from redis._parsers.commands import RequestPolicy, ResponsePolicy
+from tests.conftest import skip_if_server_version_lt
+
+
+@pytest.mark.onlycluster
+@skip_if_server_version_lt("8.0.0")
+class TestAsyncCommandParser:
+    @pytest.mark.asyncio
+    async def test_get_command_policies(self, r):
+        commands_parser = AsyncCommandsParser()
+        await commands_parser.initialize(node=r.get_default_node())
+        expected_command_policies = {
+            "core": {
+                "keys": [
+                    "keys",
+                    RequestPolicy.ALL_SHARDS,
+                    ResponsePolicy.DEFAULT_KEYLESS,
+                ],
+                "acl setuser": [
+                    "acl setuser",
+                    RequestPolicy.ALL_NODES,
+                    ResponsePolicy.ALL_SUCCEEDED,
+                ],
+                "exists": ["exists", RequestPolicy.MULTI_SHARD, ResponsePolicy.AGG_SUM],
+                "config resetstat": [
+                    "config resetstat",
+                    RequestPolicy.ALL_NODES,
+                    ResponsePolicy.ALL_SUCCEEDED,
+                ],
+                "slowlog len": [
+                    "slowlog len",
+                    RequestPolicy.ALL_NODES,
+                    ResponsePolicy.AGG_SUM,
+                ],
+                "scan": ["scan", RequestPolicy.SPECIAL, ResponsePolicy.SPECIAL],
+                "latency history": [
+                    "latency history",
+                    RequestPolicy.ALL_NODES,
+                    ResponsePolicy.SPECIAL,
+                ],
+                "memory doctor": [
+                    "memory doctor",
+                    RequestPolicy.ALL_SHARDS,
+                    ResponsePolicy.SPECIAL,
+                ],
+                "randomkey": [
+                    "randomkey",
+                    RequestPolicy.ALL_SHARDS,
+                    ResponsePolicy.SPECIAL,
+                ],
+                "mget": [
+                    "mget",
+                    RequestPolicy.MULTI_SHARD,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+                "function restore": [
+                    "function restore",
+                    RequestPolicy.ALL_SHARDS,
+                    ResponsePolicy.ALL_SUCCEEDED,
+                ],
+            },
+            "json": {
+                "debug": [
+                    "debug",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+                "get": [
+                    "get",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+            },
+            "ft": {
+                "search": [
+                    "search",
+                    RequestPolicy.DEFAULT_KEYLESS,
+                    ResponsePolicy.DEFAULT_KEYLESS,
+                ],
+                "create": [
+                    "create",
+                    RequestPolicy.DEFAULT_KEYLESS,
+                    ResponsePolicy.DEFAULT_KEYLESS,
+                ],
+            },
+            "bf": {
+                "add": [
+                    "add",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+                "madd": [
+                    "madd",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+            },
+            "cf": {
+                "add": [
+                    "add",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+                "mexists": [
+                    "mexists",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+            },
+            "tdigest": {
+                "add": [
+                    "add",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+                "min": [
+                    "min",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+            },
+            "ts": {
+                "create": [
+                    "create",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+                "info": [
+                    "info",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+            },
+            "topk": {
+                "list": [
+                    "list",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+                "query": [
+                    "query",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+            },
+        }
+
+        actual_policies = await commands_parser.get_command_policies()
+        assert len(actual_policies) > 0
+
+        for module_name, commands in expected_command_policies.items():
+            for command, command_policies in commands.items():
+                assert command in actual_policies[module_name]
+                assert command_policies == [
+                    command,
+                    actual_policies[module_name][command].request_policy,
+                    actual_policies[module_name][command].response_policy,
+                ]
diff --git a/tests/test_asyncio/test_command_policies.py b/tests/test_asyncio/test_command_policies.py
new file mode 100644
index 0000000000..7a52f256c9
--- /dev/null
+++ b/tests/test_asyncio/test_command_policies.py
@@ -0,0 +1,184 @@
+import random
+
+import pytest
+from mock import patch
+
+from redis import ResponseError
+from redis._parsers.commands import CommandPolicies, RequestPolicy, ResponsePolicy
+from redis.asyncio import RedisCluster
+from redis.commands.policies import (
+    AsyncDynamicPolicyResolver,
+    AsyncStaticPolicyResolver,
+)
+from redis.commands.search.aggregation import AggregateRequest, Cursor
+from redis.commands.search.field import NumericField, TextField
+from tests.conftest import skip_if_server_version_lt, is_resp2_connection
+
+
+@pytest.mark.asyncio
+@pytest.mark.onlycluster
+class TestBasePolicyResolver:
+    async def test_resolve(self):
+        zcount_policy = CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYED,
+            response_policy=ResponsePolicy.DEFAULT_KEYED,
+        )
+        rpoplpush_policy = CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYED,
+            response_policy=ResponsePolicy.DEFAULT_KEYED,
+        )
+
+        dynamic_resolver = AsyncDynamicPolicyResolver(
+            {
+                "core": {
+                    "zcount": zcount_policy,
+                    "rpoplpush": rpoplpush_policy,
+                }
+            }
+        )
+        assert await dynamic_resolver.resolve("zcount") == zcount_policy
+        assert await dynamic_resolver.resolve("rpoplpush") == rpoplpush_policy
+
+        with pytest.raises(
+            ValueError, match="Wrong command or module name: foo.bar.baz"
+        ):
+            await dynamic_resolver.resolve("foo.bar.baz")
+
+        assert await dynamic_resolver.resolve("foo.bar") is None
+        assert await dynamic_resolver.resolve("core.foo") is None
+
+        # Test that policy fallback correctly
+        static_resolver = AsyncStaticPolicyResolver()
+        with_fallback_dynamic_resolver = dynamic_resolver.with_fallback(static_resolver)
+        resolved_policies = await with_fallback_dynamic_resolver.resolve("ft.aggregate")
+
+        assert resolved_policies.request_policy == RequestPolicy.DEFAULT_KEYLESS
+        assert resolved_policies.response_policy == ResponsePolicy.DEFAULT_KEYLESS
+
+        # Extended chain with one more resolver
+        foo_bar_policy = CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        )
+
+        another_dynamic_resolver = AsyncDynamicPolicyResolver(
+            {
+                "foo": {
+                    "bar": foo_bar_policy,
+                }
+            }
+        )
+        with_fallback_static_resolver = static_resolver.with_fallback(
+            another_dynamic_resolver
+        )
+        with_double_fallback_dynamic_resolver = dynamic_resolver.with_fallback(
+            with_fallback_static_resolver
+        )
+
+        assert (
+            await with_double_fallback_dynamic_resolver.resolve("foo.bar")
+            == foo_bar_policy
+        )
+
+
+@pytest.mark.onlycluster
+@pytest.mark.asyncio
+@skip_if_server_version_lt("8.0.0")
+class TestClusterWithPolicies:
+    async def test_resolves_correctly_policies(self, r: RedisCluster, monkeypatch):
+        # original nodes selection method
+        determine_nodes = r._determine_nodes
+        determined_nodes = []
+        primary_nodes = r.get_primaries()
+        calls = iter(list(range(len(primary_nodes))))
+
+        async def wrapper(*args, request_policy: RequestPolicy, **kwargs):
+            nonlocal determined_nodes
+            determined_nodes = await determine_nodes(
+                *args, request_policy=request_policy, **kwargs
+            )
+            return determined_nodes
+
+        # Mock random.choice to always return a pre-defined sequence of nodes
+        monkeypatch.setattr(random, "choice", lambda seq: seq[next(calls)])
+
+        with patch.object(r, "_determine_nodes", side_effect=wrapper, autospec=True):
+            # Routed to a random primary node
+            await r.ft().create_index(
+                [
+                    NumericField("random_num"),
+                    TextField("title"),
+                    TextField("body"),
+                    TextField("parent"),
+                ]
+            )
+            assert determined_nodes[0] == primary_nodes[0]
+
+            # Routed to another random primary node
+            info = await r.ft().info()
+
+            if is_resp2_connection(r):
+                assert info["index_name"] == "idx"
+            else:
+                assert info[b"index_name"] == b"idx"
+
+            assert determined_nodes[0] == primary_nodes[1]
+
+            expected_node = await r.get_nodes_from_slot("FT.SUGLEN", *["foo"])
+            await r.ft().suglen("foo")
+            assert determined_nodes[0] == expected_node[0]
+
+            # Indexing a document
+            await r.hset(
+                "search",
+                mapping={
+                    "title": "RediSearch",
+                    "body": "Redisearch impements a search engine on top of redis",
+                    "parent": "redis",
+                    "random_num": 10,
+                },
+            )
+            await r.hset(
+                "ai",
+                mapping={
+                    "title": "RedisAI",
+                    "body": "RedisAI executes Deep Learning/Machine Learning models and managing their data.",  # noqa
+                    "parent": "redis",
+                    "random_num": 3,
+                },
+            )
+            await r.hset(
+                "json",
+                mapping={
+                    "title": "RedisJson",
+                    "body": "RedisJSON implements ECMA-404 The JSON Data Interchange Standard as a native data type.",  # noqa
+                    "parent": "redis",
+                    "random_num": 8,
+                },
+            )
+
+            req = AggregateRequest("redis").group_by("@parent").cursor(1)
+            res = await r.ft().aggregate(req)
+
+            if is_resp2_connection(r):
+                cursor = res.cursor
+            else:
+                cursor = Cursor(res[1])
+
+            # Ensure that aggregate node was cached.
+            assert determined_nodes[0] == r._aggregate_nodes[0]
+
+            await r.ft().aggregate(cursor)
+
+            # Verify that FT.CURSOR dispatched to the same node.
+            assert determined_nodes[0] == r._aggregate_nodes[0]
+
+            # Error propagates to a user
+            with pytest.raises(ResponseError, match="Cursor not found, id:"):
+                await r.ft().aggregate(cursor)
+
+            assert determined_nodes[0] == primary_nodes[2]
+
+            # Core commands also randomly distributed across masters
+            await r.randomkey()
+            assert determined_nodes[0] == primary_nodes[0]
diff --git a/tests/test_cluster.py b/tests/test_cluster.py
index 2936bb0024..759c93ffc6 100644
--- a/tests/test_cluster.py
+++ b/tests/test_cluster.py
@@ -207,7 +207,28 @@ def cmd_init_mock(self, r):
                         "first_key_pos": 1,
                         "last_key_pos": 1,
                         "step_count": 1,
-                    }
+                    },
+                    "cluster delslots": {
+                        "name": "cluster delslots",
+                        "flags": ["readonly", "fast"],
+                        "first_key_pos": 0,
+                        "last_key_pos": 0,
+                        "step_count": 0,
+                    },
+                    "cluster delslotsrange": {
+                        "name": "cluster delslotsrange",
+                        "flags": ["readonly", "fast"],
+                        "first_key_pos": 0,
+                        "last_key_pos": 0,
+                        "step_count": 0,
+                    },
+                    "cluster addslots": {
+                        "name": "cluster delslotsrange",
+                        "flags": ["readonly", "fast"],
+                        "first_key_pos": 0,
+                        "last_key_pos": 0,
+                        "step_count": 0,
+                    },
                 }
 
             cmd_parser_initialize.side_effect = cmd_init_mock
diff --git a/tests/test_command_parser.py b/tests/test_command_parser.py
index e3b44a147f..26b0edc238 100644
--- a/tests/test_command_parser.py
+++ b/tests/test_command_parser.py
@@ -1,5 +1,6 @@
 import pytest
 from redis._parsers import CommandsParser
+from redis._parsers.commands import RequestPolicy, ResponsePolicy
 
 from .conftest import (
     assert_resp_response,
@@ -106,3 +107,155 @@ def test_get_pubsub_keys(self, r):
         assert commands_parser.get_keys(r, *args2) == ["foo1", "foo2", "foo3"]
         assert commands_parser.get_keys(r, *args3) == ["*"]
         assert commands_parser.get_keys(r, *args4) == ["foo1", "foo2", "foo3"]
+
+    @skip_if_server_version_lt("8.0.0")
+    @pytest.mark.onlycluster
+    def test_get_command_policies(self, r):
+        commands_parser = CommandsParser(r)
+        expected_command_policies = {
+            "core": {
+                "keys": [
+                    "keys",
+                    RequestPolicy.ALL_SHARDS,
+                    ResponsePolicy.DEFAULT_KEYLESS,
+                ],
+                "acl setuser": [
+                    "acl setuser",
+                    RequestPolicy.ALL_NODES,
+                    ResponsePolicy.ALL_SUCCEEDED,
+                ],
+                "exists": ["exists", RequestPolicy.MULTI_SHARD, ResponsePolicy.AGG_SUM],
+                "config resetstat": [
+                    "config resetstat",
+                    RequestPolicy.ALL_NODES,
+                    ResponsePolicy.ALL_SUCCEEDED,
+                ],
+                "slowlog len": [
+                    "slowlog len",
+                    RequestPolicy.ALL_NODES,
+                    ResponsePolicy.AGG_SUM,
+                ],
+                "scan": ["scan", RequestPolicy.SPECIAL, ResponsePolicy.SPECIAL],
+                "latency history": [
+                    "latency history",
+                    RequestPolicy.ALL_NODES,
+                    ResponsePolicy.SPECIAL,
+                ],
+                "memory doctor": [
+                    "memory doctor",
+                    RequestPolicy.ALL_SHARDS,
+                    ResponsePolicy.SPECIAL,
+                ],
+                "randomkey": [
+                    "randomkey",
+                    RequestPolicy.ALL_SHARDS,
+                    ResponsePolicy.SPECIAL,
+                ],
+                "mget": [
+                    "mget",
+                    RequestPolicy.MULTI_SHARD,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+                "function restore": [
+                    "function restore",
+                    RequestPolicy.ALL_SHARDS,
+                    ResponsePolicy.ALL_SUCCEEDED,
+                ],
+            },
+            "json": {
+                "debug": [
+                    "debug",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+                "get": [
+                    "get",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+            },
+            "ft": {
+                "search": [
+                    "search",
+                    RequestPolicy.DEFAULT_KEYLESS,
+                    ResponsePolicy.DEFAULT_KEYLESS,
+                ],
+                "create": [
+                    "create",
+                    RequestPolicy.DEFAULT_KEYLESS,
+                    ResponsePolicy.DEFAULT_KEYLESS,
+                ],
+            },
+            "bf": {
+                "add": [
+                    "add",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+                "madd": [
+                    "madd",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+            },
+            "cf": {
+                "add": [
+                    "add",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+                "mexists": [
+                    "mexists",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+            },
+            "tdigest": {
+                "add": [
+                    "add",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+                "min": [
+                    "min",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+            },
+            "ts": {
+                "create": [
+                    "create",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+                "info": [
+                    "info",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+            },
+            "topk": {
+                "list": [
+                    "list",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+                "query": [
+                    "query",
+                    RequestPolicy.DEFAULT_KEYED,
+                    ResponsePolicy.DEFAULT_KEYED,
+                ],
+            },
+        }
+
+        actual_policies = commands_parser.get_command_policies()
+        assert len(actual_policies) > 0
+
+        for module_name, commands in expected_command_policies.items():
+            for command, command_policies in commands.items():
+                assert command in actual_policies[module_name]
+                assert command_policies == [
+                    command,
+                    actual_policies[module_name][command].request_policy,
+                    actual_policies[module_name][command].response_policy,
+                ]
diff --git a/tests/test_command_policies.py b/tests/test_command_policies.py
new file mode 100644
index 0000000000..633134a1b6
--- /dev/null
+++ b/tests/test_command_policies.py
@@ -0,0 +1,183 @@
+import random
+from unittest.mock import Mock, patch
+
+import pytest
+
+from redis import ResponseError
+
+from redis._parsers import CommandsParser
+from redis._parsers.commands import CommandPolicies, RequestPolicy, ResponsePolicy
+from redis.commands.policies import DynamicPolicyResolver, StaticPolicyResolver
+from redis.commands.search.aggregation import AggregateRequest, Cursor
+from redis.commands.search.field import TextField, NumericField
+from tests.conftest import skip_if_server_version_lt, is_resp2_connection
+
+
+@pytest.mark.onlycluster
+class TestBasePolicyResolver:
+    def test_resolve(self):
+        mock_command_parser = Mock(spec=CommandsParser)
+        zcount_policy = CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYED,
+            response_policy=ResponsePolicy.DEFAULT_KEYED,
+        )
+        rpoplpush_policy = CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYED,
+            response_policy=ResponsePolicy.DEFAULT_KEYED,
+        )
+
+        mock_command_parser.get_command_policies.return_value = {
+            "core": {
+                "zcount": zcount_policy,
+                "rpoplpush": rpoplpush_policy,
+            }
+        }
+
+        dynamic_resolver = DynamicPolicyResolver(mock_command_parser)
+        assert dynamic_resolver.resolve("zcount") == zcount_policy
+        assert dynamic_resolver.resolve("rpoplpush") == rpoplpush_policy
+
+        with pytest.raises(
+            ValueError, match="Wrong command or module name: foo.bar.baz"
+        ):
+            dynamic_resolver.resolve("foo.bar.baz")
+
+        assert dynamic_resolver.resolve("foo.bar") is None
+        assert dynamic_resolver.resolve("core.foo") is None
+
+        # Test that policy fallback correctly
+        static_resolver = StaticPolicyResolver()
+        with_fallback_dynamic_resolver = dynamic_resolver.with_fallback(static_resolver)
+
+        assert (
+            with_fallback_dynamic_resolver.resolve("ft.aggregate").request_policy
+            == RequestPolicy.DEFAULT_KEYLESS
+        )
+        assert (
+            with_fallback_dynamic_resolver.resolve("ft.aggregate").response_policy
+            == ResponsePolicy.DEFAULT_KEYLESS
+        )
+
+        # Extended chain with one more resolver
+        mock_command_parser = Mock(spec=CommandsParser)
+        foo_bar_policy = CommandPolicies(
+            request_policy=RequestPolicy.DEFAULT_KEYLESS,
+            response_policy=ResponsePolicy.DEFAULT_KEYLESS,
+        )
+
+        mock_command_parser.get_command_policies.return_value = {
+            "foo": {
+                "bar": foo_bar_policy,
+            }
+        }
+        another_dynamic_resolver = DynamicPolicyResolver(mock_command_parser)
+        with_fallback_static_resolver = static_resolver.with_fallback(
+            another_dynamic_resolver
+        )
+        with_double_fallback_dynamic_resolver = dynamic_resolver.with_fallback(
+            with_fallback_static_resolver
+        )
+
+        assert (
+            with_double_fallback_dynamic_resolver.resolve("foo.bar") == foo_bar_policy
+        )
+
+
+@pytest.mark.onlycluster
+@skip_if_server_version_lt("8.0.0")
+class TestClusterWithPolicies:
+    def test_resolves_correctly_policies(self, r, monkeypatch):
+        # original nodes selection method
+        determine_nodes = r._determine_nodes
+        determined_nodes = []
+        primary_nodes = r.get_primaries()
+        calls = iter(list(range(len(primary_nodes))))
+
+        def wrapper(*args, request_policy: RequestPolicy, **kwargs):
+            nonlocal determined_nodes
+            determined_nodes = determine_nodes(
+                *args, request_policy=request_policy, **kwargs
+            )
+            return determined_nodes
+
+        # Mock random.choice to always return a pre-defined sequence of nodes
+        monkeypatch.setattr(random, "choice", lambda seq: seq[next(calls)])
+
+        with patch.object(r, "_determine_nodes", side_effect=wrapper, autospec=True):
+            # Routed to a random primary node
+            r.ft().create_index(
+                (
+                    NumericField("random_num"),
+                    TextField("title"),
+                    TextField("body"),
+                    TextField("parent"),
+                )
+            )
+            assert determined_nodes[0] == primary_nodes[0]
+
+            # Routed to another random primary node
+            info = r.ft().info()
+            if is_resp2_connection(r):
+                assert info["index_name"] == "idx"
+            else:
+                assert info[b"index_name"] == b"idx"
+
+            assert determined_nodes[0] == primary_nodes[1]
+
+            expected_node = r.get_nodes_from_slot("ft.suglen", *["FT.SUGLEN", "foo"])
+            r.ft().suglen("foo")
+            assert determined_nodes[0] == expected_node[0]
+
+            # Indexing a document
+            r.hset(
+                "search",
+                mapping={
+                    "title": "RediSearch",
+                    "body": "Redisearch impements a search engine on top of redis",
+                    "parent": "redis",
+                    "random_num": 10,
+                },
+            )
+            r.hset(
+                "ai",
+                mapping={
+                    "title": "RedisAI",
+                    "body": "RedisAI executes Deep Learning/Machine Learning models and managing their data.",  # noqa
+                    "parent": "redis",
+                    "random_num": 3,
+                },
+            )
+            r.hset(
+                "json",
+                mapping={
+                    "title": "RedisJson",
+                    "body": "RedisJSON implements ECMA-404 The JSON Data Interchange Standard as a native data type.",  # noqa
+                    "parent": "redis",
+                    "random_num": 8,
+                },
+            )
+
+            req = AggregateRequest("redis").group_by("@parent").cursor(1)
+
+            if is_resp2_connection(r):
+                cursor = r.ft().aggregate(req).cursor
+            else:
+                cursor = Cursor(r.ft().aggregate(req)[1])
+
+            # Ensure that aggregate node was cached.
+            assert determined_nodes[0] == r._aggregate_nodes[0]
+
+            r.ft().aggregate(cursor)
+
+            # Verify that FT.CURSOR dispatched to the same node.
+            assert determined_nodes[0] == r._aggregate_nodes[0]
+
+            # Error propagates to a user
+            with pytest.raises(ResponseError, match="Cursor not found, id:"):
+                r.ft().aggregate(cursor)
+
+            assert determined_nodes[0] == primary_nodes[2]
+
+            # Core commands also randomly distributed across masters
+            r.randomkey()
+            assert determined_nodes[0] == primary_nodes[0]

From 92ea9e286d04e80703e0c843413000fde3ef94c4 Mon Sep 17 00:00:00 2001
From: matt <matthewwiese@users.noreply.github.com>
Date: Mon, 10 Nov 2025 06:26:50 -0500
Subject: [PATCH 1160/1164] Add missing f-string when returning an error.
 (#3841)

---
 redis/asyncio/client.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/redis/asyncio/client.py b/redis/asyncio/client.py
index 1cc0365a7b..77afeb3cdd 100644
--- a/redis/asyncio/client.py
+++ b/redis/asyncio/client.py
@@ -1584,7 +1584,7 @@ def annotate_exception(
         cmd = " ".join(map(safe_str, command))
         msg = (
             f"Command # {number} ({truncate_text(cmd)}) "
-            "of pipeline caused error: {exception.args}"
+            f"of pipeline caused error: {exception.args}"
         )
         exception.args = (msg,) + exception.args[1:]
 

From b74bc522e685f355d0286f6f1cf39f60cc6a4571 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Mon, 10 Nov 2025 15:32:27 +0200
Subject: [PATCH 1161/1164] Fixing flaky tests - part 2 (#3838)

---
 dev_requirements.txt                          |   1 +
 redis/multidb/client.py                       |   8 +-
 tests/helpers.py                              |  47 ++
 tests/test_asyncio/helpers.py                 |  47 ++
 .../test_asyncio/test_multidb/test_client.py  | 292 +++++++------
 .../test_multidb/test_pipeline.py             | 202 +++++----
 tests/test_auth/test_token_manager.py         |  25 +-
 tests/test_background.py                      |  16 +-
 tests/test_multidb/test_client.py             | 400 +++++++++++-------
 tests/test_multidb/test_pipeline.py           | 262 +++++++-----
 10 files changed, 804 insertions(+), 496 deletions(-)
 create mode 100644 tests/helpers.py
 create mode 100644 tests/test_asyncio/helpers.py

diff --git a/dev_requirements.txt b/dev_requirements.txt
index f201098a14..0f6be6e848 100644
--- a/dev_requirements.txt
+++ b/dev_requirements.txt
@@ -12,6 +12,7 @@ pytest==8.3.4 ; platform_python_implementation == "PyPy"
 pytest-asyncio>=0.23.0
 pytest-asyncio==1.1.0 ; platform_python_implementation == "PyPy"
 pytest-cov
+coverage<7.11.1
 pytest-cov==6.0.0 ; platform_python_implementation == "PyPy"
 coverage==7.6.12 ; platform_python_implementation == "PyPy"
 pytest-profiling==1.8.1
diff --git a/redis/multidb/client.py b/redis/multidb/client.py
index 272064453a..af38b1e0c4 100644
--- a/redis/multidb/client.py
+++ b/redis/multidb/client.py
@@ -301,7 +301,13 @@ def _on_circuit_state_change_callback(
             )
 
     def close(self):
-        self.command_executor.active_database.client.close()
+        """
+        Closes the client and all its resources.
+        """
+        if self._bg_scheduler:
+            self._bg_scheduler.stop()
+        if self.command_executor.active_database:
+            self.command_executor.active_database.client.close()
 
 
 def _half_open_circuit(circuit: CircuitBreaker):
diff --git a/tests/helpers.py b/tests/helpers.py
new file mode 100644
index 0000000000..f9259731d1
--- /dev/null
+++ b/tests/helpers.py
@@ -0,0 +1,47 @@
+import logging
+from time import sleep
+from typing import Callable
+
+
+def wait_for_condition(
+    predicate: Callable[[], bool],
+    timeout: float = 0.2,
+    check_interval: float = 0.01,
+    error_message: str = "Timeout waiting for condition",
+) -> None:
+    """
+    Poll a condition until it becomes True or timeout is reached.
+
+    Args:
+        predicate: A callable that returns True when the condition is met
+        timeout: Maximum time to wait in seconds (default: 0.2s = 20 * 0.01s)
+        check_interval: Time to sleep between checks in seconds (default: 0.01s)
+        error_message: Error message to raise if timeout occurs
+
+    Raises:
+        AssertionError: If the condition is not met within the timeout period
+
+    Example:
+        # Wait for circuit breaker to open
+        wait_for_condition(
+            lambda: cb2.state == CBState.OPEN,
+            timeout=0.2,
+            error_message="Timeout waiting for cb2 to open"
+        )
+
+        # Wait for failover strategy to select a specific database
+        wait_for_condition(
+            lambda: client.command_executor.active_database is mock_db,
+            timeout=0.2,
+            error_message="Timeout waiting for active database to change"
+        )
+    """
+    max_retries = int(timeout / check_interval)
+
+    for attempt in range(max_retries):
+        if predicate():
+            logging.debug(f"Condition met after {attempt} attempts")
+            return
+        sleep(check_interval)
+
+    raise AssertionError(error_message)
diff --git a/tests/test_asyncio/helpers.py b/tests/test_asyncio/helpers.py
new file mode 100644
index 0000000000..3365dc9fce
--- /dev/null
+++ b/tests/test_asyncio/helpers.py
@@ -0,0 +1,47 @@
+import asyncio
+import logging
+from typing import Callable
+
+
+async def wait_for_condition(
+    predicate: Callable[[], bool],
+    timeout: float = 0.2,
+    check_interval: float = 0.01,
+    error_message: str = "Timeout waiting for condition",
+) -> None:
+    """
+    Poll a condition until it becomes True or timeout is reached.
+
+    Args:
+        predicate: A callable that returns True when the condition is met
+        timeout: Maximum time to wait in seconds (default: 0.2s = 20 * 0.01s)
+        check_interval: Time to sleep between checks in seconds (default: 0.01s)
+        error_message: Error message to raise if timeout occurs
+
+    Raises:
+        AssertionError: If the condition is not met within the timeout period
+
+    Example:
+        # Wait for circuit breaker to open
+        await wait_for_condition(
+            lambda: cb2.state == CBState.OPEN,
+            timeout=0.2,
+            error_message="Timeout waiting for cb2 to open"
+        )
+
+        # Wait for failover strategy to select a specific database
+        await wait_for_condition(
+            lambda: client.command_executor.active_database is mock_db,
+            timeout=0.2,
+            error_message="Timeout waiting for active database to change"
+        )
+    """
+    max_retries = int(timeout / check_interval)
+
+    for attempt in range(max_retries):
+        if predicate():
+            logging.debug(f"Condition met after {attempt} attempts")
+            return
+        await asyncio.sleep(check_interval)
+
+    raise AssertionError(error_message)
diff --git a/tests/test_asyncio/test_multidb/test_client.py b/tests/test_asyncio/test_multidb/test_client.py
index 537fdb0c82..c3eb4f3226 100644
--- a/tests/test_asyncio/test_multidb/test_client.py
+++ b/tests/test_asyncio/test_multidb/test_client.py
@@ -12,6 +12,7 @@
 from redis.event import EventDispatcher, AsyncOnCommandsFailEvent
 from redis.multidb.circuit import State as CBState, PBCircuitBreakerAdapter
 from redis.multidb.exception import NoValidDatabaseException
+from tests.test_asyncio.helpers import wait_for_condition
 from tests.test_asyncio.test_multidb.conftest import create_weighted_list
 
 
@@ -41,14 +42,16 @@ async def test_execute_command_against_correct_db_on_successful_initialization(
 
             mock_hc.check_health.return_value = True
 
-            client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
-            assert await client.set("key", "value") == "OK1"
-            assert mock_hc.check_health.call_count == 9
+            async with MultiDBClient(mock_multi_db_config) as client:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
+                assert await client.set("key", "value") == "OK1"
+                assert len(mock_hc.check_health.call_args_list) == 9
 
-            assert mock_db.circuit.state == CBState.CLOSED
-            assert mock_db1.circuit.state == CBState.CLOSED
-            assert mock_db2.circuit.state == CBState.CLOSED
+                assert mock_db.circuit.state == CBState.CLOSED
+                assert mock_db1.circuit.state == CBState.CLOSED
+                assert mock_db2.circuit.state == CBState.CLOSED
 
     @pytest.mark.asyncio
     @pytest.mark.parametrize(
@@ -66,31 +69,44 @@ async def test_execute_command_against_correct_db_on_successful_initialization(
     async def test_execute_command_against_correct_db_and_closed_circuit(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
+        """
+        Validates that commands are executed against the correct
+        database when one database becomes unhealthy during initialization.
+        Ensures the client selects the highest-weighted
+        healthy database (mock_db1) and executes commands against it
+        with a CLOSED circuit.
+        """
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
         with patch.object(mock_multi_db_config, "databases", return_value=databases):
+            mock_db.client.execute_command = AsyncMock(
+                return_value="NOT_OK-->Response from unexpected db - mock_db"
+            )
             mock_db1.client.execute_command = AsyncMock(return_value="OK1")
+            mock_db2.client.execute_command = AsyncMock(
+                return_value="NOT_OK-->Response from unexpected db - mock_db2"
+            )
 
-            mock_hc.check_health.side_effect = [
-                False,
-                True,
-                True,
-                True,
-                True,
-                True,
-                True,
-            ]
+            async def mock_check_health(database):
+                if database == mock_db2:
+                    return False
+                else:
+                    return True
 
-            client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
-            result = await client.set("key", "value")
-            assert result == "OK1"
-            assert mock_hc.check_health.call_count == 7
+            mock_hc.check_health.side_effect = mock_check_health
 
-            assert mock_db.circuit.state == CBState.CLOSED
-            assert mock_db1.circuit.state == CBState.CLOSED
-            assert mock_db2.circuit.state == CBState.OPEN
+            async with MultiDBClient(mock_multi_db_config) as client:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
+                result = await client.set("key", "value")
+                assert result == "OK1"
+                assert len(mock_hc.check_health.call_args_list) >= 7
+
+                assert mock_db.circuit.state == CBState.CLOSED
+                assert mock_db1.circuit.state == CBState.CLOSED
+                assert mock_db2.circuit.state == CBState.OPEN
 
     @pytest.mark.asyncio
     @pytest.mark.parametrize(
@@ -189,40 +205,46 @@ async def mock_check_health(database):
             mock_multi_db_config.health_check_interval = 0.1
             mock_multi_db_config.failover_strategy = WeightBasedFailoverStrategy()
 
-            client = MultiDBClient(mock_multi_db_config)
-            assert await client.set("key", "value") == "OK1"
-
-            # Wait for mock_db1 to become unhealthy
-            assert await db1_became_unhealthy.wait(), (
-                "Timeout waiting for mock_db1 to become unhealthy"
-            )
+            async with MultiDBClient(mock_multi_db_config) as client:
+                assert await client.set("key", "value") == "OK1"
 
-            await asyncio.sleep(0.01)
+                # Wait for mock_db1 to become unhealthy
+                assert await db1_became_unhealthy.wait(), (
+                    "Timeout waiting for mock_db1 to become unhealthy"
+                )
+                await wait_for_condition(
+                    lambda: cb1.state == CBState.OPEN,
+                    timeout=0.2,
+                    error_message="Timeout waiting for cb1 to open",
+                )
 
-            assert await client.set("key", "value") == "OK2"
+                assert await client.set("key", "value") == "OK2"
 
-            # Wait for mock_db2 to become unhealthy
-            assert await db2_became_unhealthy.wait(), (
-                "Timeout waiting for mock_db2 to become unhealthy"
-            )
+                # Wait for mock_db2 to become unhealthy
+                assert await db2_became_unhealthy.wait(), (
+                    "Timeout waiting for mock_db2 to become unhealthy"
+                )
 
-            # Wait for circuit breaker state to actually reflect the unhealthy status
-            # (instead of just sleeping)
-            max_retries = 20
-            for _ in range(max_retries):
-                if cb2.state == CBState.OPEN:  # Circuit is open (unhealthy)
-                    break
-                await asyncio.sleep(0.01)
+                # Wait for circuit breaker state to actually reflect the unhealthy status
+                await wait_for_condition(
+                    lambda: cb2.state == CBState.OPEN,
+                    timeout=0.2,
+                    error_message="Timeout waiting for cb2 to open",
+                )
 
-            assert await client.set("key", "value") == "OK"
+                assert await client.set("key", "value") == "OK"
 
-            # Wait for mock_db to become unhealthy
-            assert await db_became_unhealthy.wait(), (
-                "Timeout waiting for mock_db to become unhealthy"
-            )
-            await asyncio.sleep(0.01)
+                # Wait for mock_db to become unhealthy
+                assert await db_became_unhealthy.wait(), (
+                    "Timeout waiting for mock_db to become unhealthy"
+                )
+                await wait_for_condition(
+                    lambda: cb.state == CBState.OPEN,
+                    timeout=0.2,
+                    error_message="Timeout waiting for cb to open",
+                )
 
-            assert await client.set("key", "value") == "OK1"
+                assert await client.set("key", "value") == "OK1"
 
     @pytest.mark.asyncio
     @pytest.mark.parametrize(
@@ -273,11 +295,11 @@ async def mock_check_health(database):
                 assert await client.set("key", "value") == "OK1"
                 await error_event.wait()
                 # Wait for circuit breaker to actually open (not just the event)
-                max_retries = 20
-                for _ in range(max_retries):
-                    if mock_db1.circuit.state == CBState.OPEN:  # Circuit is open
-                        break
-                    await asyncio.sleep(0.01)
+                await wait_for_condition(
+                    lambda: mock_db1.circuit.state == CBState.OPEN,
+                    timeout=0.2,
+                    error_message="Timeout waiting for cb1 to open after error event.",
+                )
 
                 # Now the failover strategy will select mock_db2
                 assert await client.set("key", "value") == "OK2"
@@ -334,13 +356,12 @@ async def mock_check_health(database):
                 await error_event.wait()
                 # Wait for circuit breaker state to actually reflect the unhealthy status
                 # (instead of just sleeping)
-                max_retries = 20
-                for _ in range(max_retries):
-                    if (
-                        mock_db1.circuit.state == CBState.OPEN
-                    ):  # Circuit is open (unhealthy)
-                        break
-                    await asyncio.sleep(0.01)
+                await wait_for_condition(
+                    lambda: mock_db1.circuit.state == CBState.OPEN,
+                    timeout=0.2,
+                    error_message="Timeout waiting for cb1 to open after error event.",
+                )
+
                 assert await client.set("key", "value") == "OK2"
                 await asyncio.sleep(0.5)
                 assert await client.set("key", "value") == "OK2"
@@ -375,7 +396,7 @@ async def test_execute_command_throws_exception_on_failed_initialization(
                 match="Initial connection failed - no active database found",
             ):
                 await client.set("key", "value")
-                assert mock_hc.check_health.call_count == 9
+                assert len(mock_hc.check_health.call_args_list) == 9
 
     @pytest.mark.asyncio
     @pytest.mark.parametrize(
@@ -404,7 +425,6 @@ async def test_add_database_throws_exception_on_same_database(
 
             with pytest.raises(ValueError, match="Given database already exists"):
                 await client.add_database(mock_db)
-                assert mock_hc.check_health.call_count == 9
 
     @pytest.mark.asyncio
     @pytest.mark.parametrize(
@@ -431,16 +451,18 @@ async def test_add_database_makes_new_database_active(
 
             mock_hc.check_health.return_value = True
 
-            client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            async with MultiDBClient(mock_multi_db_config) as client:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
 
-            assert await client.set("key", "value") == "OK2"
-            assert mock_hc.check_health.call_count == 6
+                assert await client.set("key", "value") == "OK2"
+                assert len(mock_hc.check_health.call_args_list) == 6
 
-            await client.add_database(mock_db1)
-            assert mock_hc.check_health.call_count == 9
+                await client.add_database(mock_db1)
+                assert len(mock_hc.check_health.call_args_list) == 9
 
-            assert await client.set("key", "value") == "OK1"
+                assert await client.set("key", "value") == "OK1"
 
     @pytest.mark.asyncio
     @pytest.mark.parametrize(
@@ -467,14 +489,16 @@ async def test_remove_highest_weighted_database(
 
             mock_hc.check_health.return_value = True
 
-            client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            async with MultiDBClient(mock_multi_db_config) as client:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
 
-            assert await client.set("key", "value") == "OK1"
-            assert mock_hc.check_health.call_count == 9
+                assert await client.set("key", "value") == "OK1"
+                assert len(mock_hc.check_health.call_args_list) == 9
 
-            await client.remove_database(mock_db1)
-            assert await client.set("key", "value") == "OK2"
+                await client.remove_database(mock_db1)
+                assert await client.set("key", "value") == "OK2"
 
     @pytest.mark.asyncio
     @pytest.mark.parametrize(
@@ -501,16 +525,18 @@ async def test_update_database_weight_to_be_highest(
 
             mock_hc.check_health.return_value = True
 
-            client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            async with MultiDBClient(mock_multi_db_config) as client:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
 
-            assert await client.set("key", "value") == "OK1"
-            assert mock_hc.check_health.call_count == 9
+                assert await client.set("key", "value") == "OK1"
+                assert len(mock_hc.check_health.call_args_list) == 9
 
-            await client.update_database_weight(mock_db2, 0.8)
-            assert mock_db2.weight == 0.8
+                await client.update_database_weight(mock_db2, 0.8)
+                assert mock_db2.weight == 0.8
 
-            assert await client.set("key", "value") == "OK2"
+                assert await client.set("key", "value") == "OK2"
 
     @pytest.mark.asyncio
     @pytest.mark.parametrize(
@@ -544,30 +570,32 @@ async def test_add_new_failure_detector(
 
             mock_hc.check_health.return_value = True
 
-            client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
-            assert await client.set("key", "value") == "OK1"
-            assert mock_hc.check_health.call_count == 9
-
-            # Simulate failing command events that lead to a failure detection
-            for _ in range(5):
-                await mock_multi_db_config.event_dispatcher.dispatch_async(
-                    command_fail_event
+            async with MultiDBClient(mock_multi_db_config) as client:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
                 )
+                assert await client.set("key", "value") == "OK1"
+                assert len(mock_hc.check_health.call_args_list) == 9
 
-            assert mock_fd.register_failure.call_count == 5
+                # Simulate failing command events that lead to a failure detection
+                for _ in range(5):
+                    await mock_multi_db_config.event_dispatcher.dispatch_async(
+                        command_fail_event
+                    )
 
-            another_fd = Mock(spec=AsyncFailureDetector)
-            client.add_failure_detector(another_fd)
+                assert mock_fd.register_failure.call_count == 5
 
-            # Simulate failing command events that lead to a failure detection
-            for _ in range(5):
-                await mock_multi_db_config.event_dispatcher.dispatch_async(
-                    command_fail_event
-                )
+                another_fd = Mock(spec=AsyncFailureDetector)
+                client.add_failure_detector(another_fd)
+
+                # Simulate failing command events that lead to a failure detection
+                for _ in range(5):
+                    await mock_multi_db_config.event_dispatcher.dispatch_async(
+                        command_fail_event
+                    )
 
-            assert mock_fd.register_failure.call_count == 10
-            assert another_fd.register_failure.call_count == 5
+                assert mock_fd.register_failure.call_count == 10
+                assert another_fd.register_failure.call_count == 5
 
     @pytest.mark.asyncio
     @pytest.mark.parametrize(
@@ -593,19 +621,21 @@ async def test_add_new_health_check(
 
             mock_hc.check_health.return_value = True
 
-            client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
-            assert await client.set("key", "value") == "OK1"
-            assert mock_hc.check_health.call_count == 9
+            async with MultiDBClient(mock_multi_db_config) as client:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
+                assert await client.set("key", "value") == "OK1"
+                assert len(mock_hc.check_health.call_args_list) == 9
 
-            another_hc = Mock(spec=HealthCheck)
-            another_hc.check_health.return_value = True
+                another_hc = Mock(spec=HealthCheck)
+                another_hc.check_health.return_value = True
 
-            await client.add_health_check(another_hc)
-            await client._check_db_health(mock_db1)
+                await client.add_health_check(another_hc)
+                await client._check_db_health(mock_db1)
 
-            assert mock_hc.check_health.call_count == 12
-            assert another_hc.check_health.call_count == 3
+                assert len(mock_hc.check_health.call_args_list) == 12
+                assert len(another_hc.check_health.call_args_list) == 3
 
     @pytest.mark.asyncio
     @pytest.mark.parametrize(
@@ -632,23 +662,25 @@ async def test_set_active_database(
 
             mock_hc.check_health.return_value = True
 
-            client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
-            assert await client.set("key", "value") == "OK1"
-            assert mock_hc.check_health.call_count == 9
+            async with MultiDBClient(mock_multi_db_config) as client:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
+                assert await client.set("key", "value") == "OK1"
+                assert len(mock_hc.check_health.call_args_list) >= 9
 
-            await client.set_active_database(mock_db)
-            assert await client.set("key", "value") == "OK"
+                await client.set_active_database(mock_db)
+                assert await client.set("key", "value") == "OK"
 
-            with pytest.raises(
-                ValueError, match="Given database is not a member of database list"
-            ):
-                await client.set_active_database(Mock(spec=AsyncDatabase))
+                with pytest.raises(
+                    ValueError, match="Given database is not a member of database list"
+                ):
+                    await client.set_active_database(Mock(spec=AsyncDatabase))
 
-            mock_hc.check_health.return_value = False
+                mock_hc.check_health.return_value = False
 
-            with pytest.raises(
-                NoValidDatabaseException,
-                match="Cannot set active database, database is unhealthy",
-            ):
-                await client.set_active_database(mock_db1)
+                with pytest.raises(
+                    NoValidDatabaseException,
+                    match="Cannot set active database, database is unhealthy",
+                ):
+                    await client.set_active_database(mock_db1)
diff --git a/tests/test_asyncio/test_multidb/test_pipeline.py b/tests/test_asyncio/test_multidb/test_pipeline.py
index 528f8e813b..f9c2c7c59d 100644
--- a/tests/test_asyncio/test_multidb/test_pipeline.py
+++ b/tests/test_asyncio/test_multidb/test_pipeline.py
@@ -8,6 +8,7 @@
 from redis.asyncio.multidb.client import MultiDBClient
 from redis.asyncio.multidb.failover import WeightBasedFailoverStrategy
 from redis.multidb.circuit import State as CBState, PBCircuitBreakerAdapter
+from tests.test_asyncio.helpers import wait_for_condition
 from tests.test_asyncio.test_multidb.conftest import create_weighted_list
 
 
@@ -50,15 +51,17 @@ async def test_executes_pipeline_against_correct_db(
 
             mock_hc.check_health.return_value = True
 
-            client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            async with MultiDBClient(mock_multi_db_config) as client:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
 
-            pipe = client.pipeline()
-            pipe.set("key1", "value1")
-            pipe.get("key1")
+                pipe = client.pipeline()
+                pipe.set("key1", "value1")
+                pipe.get("key1")
 
-            assert await pipe.execute() == ["OK1", "value1"]
-            assert mock_hc.check_health.call_count == 9
+                assert await pipe.execute() == ["OK1", "value1"]
+                assert len(mock_hc.check_health.call_args_list) >= 9
 
     @pytest.mark.asyncio
     @pytest.mark.parametrize(
@@ -88,29 +91,28 @@ async def test_execute_pipeline_against_correct_db_and_closed_circuit(
             pipe.execute.return_value = ["OK1", "value1"]
             mock_db1.client.pipeline.return_value = pipe
 
-            mock_hc.check_health.side_effect = [
-                False,
-                True,
-                True,
-                True,
-                True,
-                True,
-                True,
-            ]
+            async def mock_check_health(database):
+                if database == mock_db2:
+                    return False
+                else:
+                    return True
 
-            client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            mock_hc.check_health.side_effect = mock_check_health
+            async with MultiDBClient(mock_multi_db_config) as client:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
 
-            async with client.pipeline() as pipe:
-                pipe.set("key1", "value1")
-                pipe.get("key1")
+                async with client.pipeline() as pipe:
+                    pipe.set("key1", "value1")
+                    pipe.get("key1")
 
-            assert await pipe.execute() == ["OK1", "value1"]
-            assert mock_hc.check_health.call_count == 7
+                assert await pipe.execute() == ["OK1", "value1"]
+                assert len(mock_hc.check_health.call_args_list) >= 7
 
-            assert mock_db.circuit.state == CBState.CLOSED
-            assert mock_db1.circuit.state == CBState.CLOSED
-            assert mock_db2.circuit.state == CBState.OPEN
+                assert mock_db.circuit.state == CBState.CLOSED
+                assert mock_db1.circuit.state == CBState.CLOSED
+                assert mock_db2.circuit.state == CBState.OPEN
 
     @pytest.mark.asyncio
     @pytest.mark.parametrize(
@@ -237,7 +239,11 @@ async def mock_check_health(database):
             assert await db1_became_unhealthy.wait(), (
                 "Timeout waiting for mock_db1 to become unhealthy"
             )
-            await asyncio.sleep(0.01)
+            await wait_for_condition(
+                lambda: cb1.state == CBState.OPEN,
+                timeout=0.2,
+                error_message="Timeout waiting for cb1 to open",
+            )
 
             # Run 2: mock_db1 unhealthy - should failover to mock_db2 (weight 0.5)
             assert await pipe.execute() == ["OK2", "value"]
@@ -246,7 +252,11 @@ async def mock_check_health(database):
             assert await db2_became_unhealthy.wait(), (
                 "Timeout waiting for mock_db2 to become unhealthy"
             )
-            await asyncio.sleep(0.01)
+            await wait_for_condition(
+                lambda: cb2.state == CBState.OPEN,
+                timeout=0.2,
+                error_message="Timeout waiting for cb2 to open",
+            )
 
             # Run 3: mock_db1 and mock_db2 unhealthy - should use mock_db (weight 0.2)
             assert await pipe.execute() == ["OK", "value"]
@@ -255,7 +265,11 @@ async def mock_check_health(database):
             assert await db_became_unhealthy.wait(), (
                 "Timeout waiting for mock_db to become unhealthy"
             )
-            await asyncio.sleep(0.01)
+            await wait_for_condition(
+                lambda: cb.state == CBState.OPEN,
+                timeout=0.2,
+                error_message="Timeout waiting for cb to open",
+            )
 
             # Run 4: mock_db unhealthy, others healthy - should use mock_db1 (highest weight)
             assert await pipe.execute() == ["OK1", "value"]
@@ -291,15 +305,19 @@ async def test_executes_transaction_against_correct_db(
 
             mock_hc.check_health.return_value = True
 
-            client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            async with MultiDBClient(mock_multi_db_config) as client:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
 
-            async def callback(pipe: Pipeline):
-                pipe.set("key1", "value1")
-                pipe.get("key1")
+                async def callback(pipe: Pipeline):
+                    pipe.set("key1", "value1")
+                    pipe.get("key1")
 
-            assert await client.transaction(callback) == ["OK1", "value1"]
-            assert mock_hc.check_health.call_count == 9
+                assert await client.transaction(callback) == ["OK1", "value1"]
+                # if we assume at least 3 health checks have run per each database
+                # we should have at least 9 total calls
+                assert len(mock_hc.check_health.call_args_list) >= 9
 
     @pytest.mark.asyncio
     @pytest.mark.parametrize(
@@ -327,29 +345,29 @@ async def test_execute_transaction_against_correct_db_and_closed_circuit(
         ):
             mock_db1.client.transaction.return_value = ["OK1", "value1"]
 
-            mock_hc.check_health.side_effect = [
-                False,
-                True,
-                True,
-                True,
-                True,
-                True,
-                True,
-            ]
+            async def mock_check_health(database):
+                if database == mock_db2:
+                    return False
+                else:
+                    return True
 
-            client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            mock_hc.check_health.side_effect = mock_check_health
 
-            async def callback(pipe: Pipeline):
-                pipe.set("key1", "value1")
-                pipe.get("key1")
+            async with MultiDBClient(mock_multi_db_config) as client:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
+
+                async def callback(pipe: Pipeline):
+                    pipe.set("key1", "value1")
+                    pipe.get("key1")
 
-            assert await client.transaction(callback) == ["OK1", "value1"]
-            assert mock_hc.check_health.call_count == 7
+                assert await client.transaction(callback) == ["OK1", "value1"]
+                assert len(mock_hc.check_health.call_args_list) >= 7
 
-            assert mock_db.circuit.state == CBState.CLOSED
-            assert mock_db1.circuit.state == CBState.CLOSED
-            assert mock_db2.circuit.state == CBState.OPEN
+                assert mock_db.circuit.state == CBState.CLOSED
+                assert mock_db1.circuit.state == CBState.CLOSED
+                assert mock_db2.circuit.state == CBState.OPEN
 
     @pytest.mark.asyncio
     @pytest.mark.parametrize(
@@ -455,34 +473,46 @@ async def mock_check_health(database):
             mock_multi_db_config.health_check_interval = 0.1
             mock_multi_db_config.failover_strategy = WeightBasedFailoverStrategy()
 
-            client = MultiDBClient(mock_multi_db_config)
-
-            async def callback(pipe: Pipeline):
-                pipe.set("key1", "value1")
-                pipe.get("key1")
-
-            assert await client.transaction(callback) == ["OK1", "value"]
-
-            # Wait for mock_db1 to become unhealthy
-            assert await db1_became_unhealthy.wait(), (
-                "Timeout waiting for mock_db1 to become unhealthy"
-            )
-            await asyncio.sleep(0.01)
-
-            assert await client.transaction(callback) == ["OK2", "value"]
-
-            # Wait for mock_db2 to become unhealthy
-            assert await db2_became_unhealthy.wait(), (
-                "Timeout waiting for mock_db1 to become unhealthy"
-            )
-            await asyncio.sleep(0.01)
-
-            assert await client.transaction(callback) == ["OK", "value"]
-
-            # Wait for mock_db to become unhealthy
-            assert await db_became_unhealthy.wait(), (
-                "Timeout waiting for mock_db1 to become unhealthy"
-            )
-            await asyncio.sleep(0.01)
-
-            assert await client.transaction(callback) == ["OK1", "value"]
+            async with MultiDBClient(mock_multi_db_config) as client:
+
+                async def callback(pipe: Pipeline):
+                    pipe.set("key1", "value1")
+                    pipe.get("key1")
+
+                assert await client.transaction(callback) == ["OK1", "value"]
+
+                # Wait for mock_db1 to become unhealthy
+                assert await db1_became_unhealthy.wait(), (
+                    "Timeout waiting for mock_db1 to become unhealthy"
+                )
+                await wait_for_condition(
+                    lambda: cb1.state == CBState.OPEN,
+                    timeout=0.2,
+                    error_message="Timeout waiting for cb1 to open",
+                )
+
+                assert await client.transaction(callback) == ["OK2", "value"]
+
+                # Wait for mock_db2 to become unhealthy
+                assert await db2_became_unhealthy.wait(), (
+                    "Timeout waiting for mock_db1 to become unhealthy"
+                )
+                await wait_for_condition(
+                    lambda: cb2.state == CBState.OPEN,
+                    timeout=0.2,
+                    error_message="Timeout waiting for cb2 to open",
+                )
+
+                assert await client.transaction(callback) == ["OK", "value"]
+
+                # Wait for mock_db to become unhealthy
+                assert await db_became_unhealthy.wait(), (
+                    "Timeout waiting for mock_db1 to become unhealthy"
+                )
+                await wait_for_condition(
+                    lambda: cb.state == CBState.OPEN,
+                    timeout=0.2,
+                    error_message="Timeout waiting for cb to open",
+                )
+
+                assert await client.transaction(callback) == ["OK1", "value"]
diff --git a/tests/test_auth/test_token_manager.py b/tests/test_auth/test_token_manager.py
index f675c125dd..f9fdf2f14b 100644
--- a/tests/test_auth/test_token_manager.py
+++ b/tests/test_auth/test_token_manager.py
@@ -174,13 +174,13 @@ def test_token_renewal_with_skip_initial(self):
         mock_provider.request_token.side_effect = [
             SimpleToken(
                 "value",
-                (datetime.now(timezone.utc).timestamp() * 1000) + 50,
+                (datetime.now(timezone.utc).timestamp() * 1000) + 1000,
                 (datetime.now(timezone.utc).timestamp() * 1000),
                 {"oid": "test"},
             ),
             SimpleToken(
                 "value",
-                (datetime.now(timezone.utc).timestamp() * 1000) + 150,
+                (datetime.now(timezone.utc).timestamp() * 1000) + 1500,
                 (datetime.now(timezone.utc).timestamp() * 1000),
                 {"oid": "test"},
             ),
@@ -194,12 +194,12 @@ def on_next(token):
         mock_listener.on_next = on_next
 
         retry_policy = RetryPolicy(3, 10)
-        config = TokenManagerConfig(1, 0, 1000, retry_policy)
+        config = TokenManagerConfig(0.5, 0, 1000, retry_policy)
         mgr = TokenManager(mock_provider, config)
         mgr.start(mock_listener, skip_initial=True)
-        # Should be less than a 0.1, or it will be flacky due to
-        # additional token renewal.
-        sleep(0.1)
+        assert len(tokens) == 0
+
+        sleep(0.6)
 
         assert len(tokens) > 0
 
@@ -210,19 +210,19 @@ async def test_async_token_renewal_with_skip_initial(self):
         mock_provider.request_token.side_effect = [
             SimpleToken(
                 "value",
-                (datetime.now(timezone.utc).timestamp() * 1000) + 100,
+                (datetime.now(timezone.utc).timestamp() * 1000) + 1000,
                 (datetime.now(timezone.utc).timestamp() * 1000),
                 {"oid": "test"},
             ),
             SimpleToken(
                 "value",
-                (datetime.now(timezone.utc).timestamp() * 1000) + 120,
+                (datetime.now(timezone.utc).timestamp() * 1000) + 1200,
                 (datetime.now(timezone.utc).timestamp() * 1000),
                 {"oid": "test"},
             ),
             SimpleToken(
                 "value",
-                (datetime.now(timezone.utc).timestamp() * 1000) + 140,
+                (datetime.now(timezone.utc).timestamp() * 1000) + 1400,
                 (datetime.now(timezone.utc).timestamp() * 1000),
                 {"oid": "test"},
             ),
@@ -236,13 +236,12 @@ async def on_next(token):
         mock_listener.on_next = on_next
 
         retry_policy = RetryPolicy(3, 10)
-        config = TokenManagerConfig(1, 0, 1000, retry_policy)
+        config = TokenManagerConfig(0.5, 0, 1000, retry_policy)
         mgr = TokenManager(mock_provider, config)
         await mgr.start_async(mock_listener, skip_initial=True)
-        # Should be less than a 0.1, or it will be flacky
-        # due to additional token renewal.
-        await asyncio.sleep(0.2)
+        assert len(tokens) == 0
 
+        await asyncio.sleep(0.6)
         assert len(tokens) > 0
 
     def test_success_token_renewal_with_retry(self):
diff --git a/tests/test_background.py b/tests/test_background.py
index bac9c1eef6..dbd7ad58d6 100644
--- a/tests/test_background.py
+++ b/tests/test_background.py
@@ -39,7 +39,7 @@ def callback(arg1: str, arg2: int):
         ],
     )
     def test_run_recurring(self, interval, timeout, call_count):
-        execute_counter = 0
+        execute_counter = []
         one = "arg1"
         two = 9999
 
@@ -48,18 +48,18 @@ def callback(arg1: str, arg2: int):
             nonlocal one
             nonlocal two
 
-            execute_counter += 1
+            execute_counter.append(1)
 
             assert arg1 == one
             assert arg2 == two
 
         scheduler = BackgroundScheduler()
         scheduler.run_recurring(interval, callback, one, two)
-        assert execute_counter == 0
+        assert len(execute_counter) == 0
 
         sleep(timeout)
 
-        assert execute_counter == call_count
+        assert len(execute_counter) == call_count
 
     @pytest.mark.asyncio
     @pytest.mark.parametrize(
@@ -71,7 +71,7 @@ def callback(arg1: str, arg2: int):
         ],
     )
     async def test_run_recurring_async(self, interval, timeout, call_count):
-        execute_counter = 0
+        execute_counter = []
         one = "arg1"
         two = 9999
 
@@ -80,15 +80,15 @@ async def callback(arg1: str, arg2: int):
             nonlocal one
             nonlocal two
 
-            execute_counter += 1
+            execute_counter.append(1)
 
             assert arg1 == one
             assert arg2 == two
 
         scheduler = BackgroundScheduler()
         await scheduler.run_recurring_async(interval, callback, one, two)
-        assert execute_counter == 0
+        assert len(execute_counter) == 0
 
         await asyncio.sleep(timeout)
 
-        assert execute_counter == call_count
+        assert len(execute_counter) == call_count
diff --git a/tests/test_multidb/test_client.py b/tests/test_multidb/test_client.py
index 490126fdf2..41b5eebb1e 100644
--- a/tests/test_multidb/test_client.py
+++ b/tests/test_multidb/test_client.py
@@ -13,6 +13,7 @@
 from redis.multidb.failover import WeightBasedFailoverStrategy
 from redis.multidb.failure_detector import FailureDetector
 from redis.multidb.healthcheck import HealthCheck
+from tests.helpers import wait_for_condition
 from tests.test_multidb.conftest import create_weighted_list
 
 
@@ -42,13 +43,18 @@ def test_execute_command_against_correct_db_on_successful_initialization(
             mock_hc.check_health.return_value = True
 
             client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
-            assert client.set("key", "value") == "OK1"
-            assert mock_hc.check_health.call_count == 9
-
-            assert mock_db.circuit.state == CBState.CLOSED
-            assert mock_db1.circuit.state == CBState.CLOSED
-            assert mock_db2.circuit.state == CBState.CLOSED
+            try:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
+                assert client.set("key", "value") == "OK1"
+                assert len(mock_hc.check_health.call_args_list) >= 9
+
+                assert mock_db.circuit.state == CBState.CLOSED
+                assert mock_db1.circuit.state == CBState.CLOSED
+                assert mock_db2.circuit.state == CBState.CLOSED
+            finally:
+                client.close()
 
     @pytest.mark.parametrize(
         "mock_multi_db_config,mock_db, mock_db1, mock_db2",
@@ -65,31 +71,47 @@ def test_execute_command_against_correct_db_on_successful_initialization(
     def test_execute_command_against_correct_db_and_closed_circuit(
         self, mock_multi_db_config, mock_db, mock_db1, mock_db2, mock_hc
     ):
+        """
+        Validates that commands are executed against the correct
+        database when one database becomes unhealthy during initialization.
+        Ensures the client selects the highest-weighted
+        healthy database (mock_db1) and executes commands against it
+        with a CLOSED circuit.
+        """
         databases = create_weighted_list(mock_db, mock_db1, mock_db2)
         mock_multi_db_config.health_checks = [mock_hc]
 
         with patch.object(mock_multi_db_config, "databases", return_value=databases):
+            mock_db.client.execute_command = MagicMock(
+                return_value="NOT_OK-->Response from unexpected db - mock_db"
+            )
             mock_db1.client.execute_command = MagicMock(return_value="OK1")
+            mock_db2.client.execute_command = MagicMock(
+                return_value="NOT_OK-->Response from unexpected db - mock_db2"
+            )
 
-            mock_hc.check_health.side_effect = [
-                False,
-                True,
-                True,
-                True,
-                True,
-                True,
-                True,
-            ]
+            def mock_check_health(database):
+                if database == mock_db2:
+                    return False
+                else:
+                    return True
 
-            client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
-            result = client.set("key", "value")
-            assert result == "OK1"
-            assert mock_hc.check_health.call_count == 7
+            mock_hc.check_health.side_effect = mock_check_health
 
-            assert mock_db.circuit.state == CBState.CLOSED
-            assert mock_db1.circuit.state == CBState.CLOSED
-            assert mock_db2.circuit.state == CBState.OPEN
+            client = MultiDBClient(mock_multi_db_config)
+            try:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
+                result = client.set("key", "value")
+                assert result == "OK1"
+                assert len(mock_hc.check_health.call_args_list) >= 7
+
+                assert mock_db.circuit.state == CBState.CLOSED
+                assert mock_db1.circuit.state == CBState.CLOSED
+                assert mock_db2.circuit.state == CBState.OPEN
+            finally:
+                client.close()
 
     @pytest.mark.parametrize(
         "mock_multi_db_config,mock_db, mock_db1, mock_db2",
@@ -188,31 +210,52 @@ def mock_check_health(database):
             mock_db2.client.execute_command.return_value = "OK2"
 
             client = MultiDBClient(mock_multi_db_config)
-            assert client.set("key", "value") == "OK1"
-
-            # Wait for mock_db1 to become unhealthy
-            assert db1_became_unhealthy.wait(timeout=1.0), (
-                "Timeout waiting for mock_db1 to become unhealthy"
-            )
-            sleep(0.01)
-
-            assert client.set("key", "value") == "OK2"
-
-            # Wait for mock_db2 to become unhealthy
-            assert db2_became_unhealthy.wait(timeout=1.0), (
-                "Timeout waiting for mock_db2 to become unhealthy"
-            )
-            sleep(0.01)
-
-            assert client.set("key", "value") == "OK"
-
-            # Wait for mock_db to become unhealthy
-            assert db_became_unhealthy.wait(timeout=1.0), (
-                "Timeout waiting for mock_db to become unhealthy"
-            )
-            sleep(0.01)
-
-            assert client.set("key", "value") == "OK1"
+            try:
+                assert client.set("key", "value") == "OK1"
+
+                # Wait for mock_db1 to become unhealthy
+                assert db1_became_unhealthy.wait(timeout=1.0), (
+                    "Timeout waiting for mock_db1 to become unhealthy"
+                )
+
+                # Wait for circuit breaker state to actually reflect the unhealthy status
+                # (instead of just sleeping)
+                wait_for_condition(
+                    lambda: cb1.state == CBState.OPEN,
+                    timeout=0.2,
+                    error_message="Timeout waiting for cb1 to open",
+                )
+
+                assert client.set("key", "value") == "OK2"
+
+                # Wait for mock_db2 to become unhealthy
+                assert db2_became_unhealthy.wait(timeout=1.0), (
+                    "Timeout waiting for mock_db2 to become unhealthy"
+                )
+
+                # Wait for circuit breaker state to actually reflect the unhealthy status
+                # (instead of just sleeping)
+                wait_for_condition(
+                    lambda: cb2.state == CBState.OPEN,
+                    timeout=0.2,
+                    error_message="Timeout waiting for cb2 to open",
+                )
+
+                assert client.set("key", "value") == "OK"
+
+                # Wait for mock_db to become unhealthy
+                assert db_became_unhealthy.wait(timeout=1.0), (
+                    "Timeout waiting for mock_db to become unhealthy"
+                )
+                wait_for_condition(
+                    lambda: cb.state == CBState.OPEN,
+                    timeout=0.2,
+                    error_message="Timeout waiting for cb to open",
+                )
+
+                assert client.set("key", "value") == "OK1"
+            finally:
+                client.close()
 
     @pytest.mark.parametrize(
         "mock_multi_db_config,mock_db, mock_db1, mock_db2",
@@ -259,20 +302,35 @@ def mock_check_health(database):
             mock_multi_db_config.failover_strategy = WeightBasedFailoverStrategy()
 
             client = MultiDBClient(mock_multi_db_config)
-            assert client.set("key", "value") == "OK1"
-            error_event.wait(timeout=0.5)
-
-            # Wait for circuit breaker to actually open (not just the event)
-            max_retries = 20
-            for _ in range(max_retries):
-                if mock_db1.circuit.state == CBState.OPEN:  # Circuit is open
-                    break
-                sleep(0.01)
-
-            # Now the failover strategy will select mock_db2
-            assert client.set("key", "value") == "OK2"
-            sleep(0.5)
-            assert client.set("key", "value") == "OK1"
+            try:
+                assert client.set("key", "value") == "OK1"
+                error_event.wait(timeout=0.5)
+
+                # Wait for circuit breaker to actually open (not just the event)
+                wait_for_condition(
+                    lambda: mock_db1.circuit.state == CBState.OPEN,
+                    timeout=0.2,
+                    error_message="Timeout waiting for cb1 to open after error event.",
+                )
+
+                # Now the failover strategy will select mock_db2
+                assert client.set("key", "value") == "OK2"
+
+                # Wait for auto fallback interval to pass
+                wait_for_condition(
+                    lambda: mock_db1.circuit.state == CBState.CLOSED,
+                    timeout=0.2,
+                    error_message="Timeout waiting for mock_db1 to be healthy again.",
+                )
+
+                # Wait for auto fallback time to pass - this way on next command execution
+                # the active database will be re-evaluated
+                sleep(0.2)
+
+                # Now the failover strategy will select mock_db1 again
+                assert client.set("key", "value") == "OK1"
+            finally:
+                client.close()
 
     @pytest.mark.parametrize(
         "mock_multi_db_config,mock_db, mock_db1, mock_db2",
@@ -319,20 +377,24 @@ def mock_check_health(database):
             mock_multi_db_config.failover_strategy = WeightBasedFailoverStrategy()
 
             client = MultiDBClient(mock_multi_db_config)
-            assert client.set("key", "value") == "OK1"
-            error_event.wait(timeout=0.5)
-            # Wait for circuit breaker state to actually reflect the unhealthy status
-            # (instead of just sleeping)
-            max_retries = 20
-            for _ in range(max_retries):
-                if (
-                    mock_db1.circuit.state == CBState.OPEN
-                ):  # Circuit is open (unhealthy)
-                    break
-                sleep(0.01)
-            assert client.set("key", "value") == "OK2"
-            sleep(0.5)
-            assert client.set("key", "value") == "OK2"
+            try:
+                assert client.set("key", "value") == "OK1"
+                error_event.wait(timeout=0.5)
+                # Wait for circuit breaker state to actually reflect the unhealthy status
+                # (instead of just sleeping)
+                wait_for_condition(
+                    lambda: mock_db1.circuit.state == CBState.OPEN,
+                    timeout=0.2,
+                    error_message="Timeout waiting for cb1 to open after error event.",
+                )
+
+                assert client.set("key", "value") == "OK2"
+                # Wait half a second - the active database should not change on command
+                # execution even with higher waits, because auto fallback is disabled
+                sleep(0.5)
+                assert client.set("key", "value") == "OK2"
+            finally:
+                client.close()
 
     @pytest.mark.parametrize(
         "mock_multi_db_config,mock_db, mock_db1, mock_db2",
@@ -356,15 +418,18 @@ def test_execute_command_throws_exception_on_failed_initialization(
             mock_hc.check_health.return_value = False
 
             client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
-
-            with pytest.raises(
-                NoValidDatabaseException,
-                match="Initial connection failed - no active database found",
-            ):
-                client.set("key", "value")
-
-                assert mock_hc.check_health.call_count == 3
+            try:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
+
+                with pytest.raises(
+                    NoValidDatabaseException,
+                    match="Initial connection failed - no active database found",
+                ):
+                    client.set("key", "value")
+            finally:
+                client.close()
 
     @pytest.mark.parametrize(
         "mock_multi_db_config,mock_db, mock_db1, mock_db2",
@@ -388,11 +453,17 @@ def test_add_database_throws_exception_on_same_database(
             mock_hc.check_health.return_value = False
 
             client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            try:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
+
+                with pytest.raises(ValueError, match="Given database already exists"):
+                    client.add_database(mock_db)
+                    assert len(mock_hc.check_health.call_args_list) == 3
 
-            with pytest.raises(ValueError, match="Given database already exists"):
-                client.add_database(mock_db)
-                assert mock_hc.check_health.call_count == 3
+            finally:
+                client.close()
 
     @pytest.mark.parametrize(
         "mock_multi_db_config,mock_db, mock_db1, mock_db2",
@@ -419,15 +490,20 @@ def test_add_database_makes_new_database_active(
             mock_hc.check_health.return_value = True
 
             client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            try:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
 
-            assert client.set("key", "value") == "OK2"
-            assert mock_hc.check_health.call_count == 6
+                assert client.set("key", "value") == "OK2"
+                assert len(mock_hc.check_health.call_args_list) == 6
 
-            client.add_database(mock_db1)
-            assert mock_hc.check_health.call_count == 9
+                client.add_database(mock_db1)
+                assert len(mock_hc.check_health.call_args_list) == 9
 
-            assert client.set("key", "value") == "OK1"
+                assert client.set("key", "value") == "OK1"
+            finally:
+                client.close()
 
     @pytest.mark.parametrize(
         "mock_multi_db_config,mock_db, mock_db1, mock_db2",
@@ -454,14 +530,19 @@ def test_remove_highest_weighted_database(
             mock_hc.check_health.return_value = True
 
             client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            try:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
 
-            assert client.set("key", "value") == "OK1"
-            assert mock_hc.check_health.call_count == 9
+                assert client.set("key", "value") == "OK1"
+                assert len(mock_hc.check_health.call_args_list) >= 9
 
-            client.remove_database(mock_db1)
+                client.remove_database(mock_db1)
 
-            assert client.set("key", "value") == "OK2"
+                assert client.set("key", "value") == "OK2"
+            finally:
+                client.close()
 
     @pytest.mark.parametrize(
         "mock_multi_db_config,mock_db, mock_db1, mock_db2",
@@ -488,15 +569,20 @@ def test_update_database_weight_to_be_highest(
             mock_hc.check_health.return_value = True
 
             client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            try:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
 
-            assert client.set("key", "value") == "OK1"
-            assert mock_hc.check_health.call_count == 9
+                assert client.set("key", "value") == "OK1"
+                assert len(mock_hc.check_health.call_args_list) >= 9
 
-            client.update_database_weight(mock_db2, 0.8)
-            assert mock_db2.weight == 0.8
+                client.update_database_weight(mock_db2, 0.8)
+                assert mock_db2.weight == 0.8
 
-            assert client.set("key", "value") == "OK2"
+                assert client.set("key", "value") == "OK2"
+            finally:
+                client.close()
 
     @pytest.mark.parametrize(
         "mock_multi_db_config,mock_db, mock_db1, mock_db2",
@@ -530,25 +616,30 @@ def test_add_new_failure_detector(
             mock_hc.check_health.return_value = True
 
             client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
-            assert client.set("key", "value") == "OK1"
-            assert mock_hc.check_health.call_count == 9
+            try:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
+                assert client.set("key", "value") == "OK1"
+                assert len(mock_hc.check_health.call_args_list) >= 9
 
-            # Simulate failing command events that lead to a failure detection
-            for i in range(5):
-                mock_multi_db_config.event_dispatcher.dispatch(command_fail_event)
+                # Simulate failing command events that lead to a failure detection
+                for i in range(5):
+                    mock_multi_db_config.event_dispatcher.dispatch(command_fail_event)
 
-            assert mock_fd.register_failure.call_count == 5
+                assert mock_fd.register_failure.call_count == 5
 
-            another_fd = Mock(spec=FailureDetector)
-            client.add_failure_detector(another_fd)
+                another_fd = Mock(spec=FailureDetector)
+                client.add_failure_detector(another_fd)
 
-            # Simulate failing command events that lead to a failure detection
-            for i in range(5):
-                mock_multi_db_config.event_dispatcher.dispatch(command_fail_event)
+                # Simulate failing command events that lead to a failure detection
+                for i in range(5):
+                    mock_multi_db_config.event_dispatcher.dispatch(command_fail_event)
 
-            assert mock_fd.register_failure.call_count == 10
-            assert another_fd.register_failure.call_count == 5
+                assert mock_fd.register_failure.call_count == 10
+                assert another_fd.register_failure.call_count == 5
+            finally:
+                client.close()
 
     @pytest.mark.parametrize(
         "mock_multi_db_config,mock_db, mock_db1, mock_db2",
@@ -574,18 +665,24 @@ def test_add_new_health_check(
             mock_hc.check_health.return_value = True
 
             client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
-            assert client.set("key", "value") == "OK1"
-            assert mock_hc.check_health.call_count == 9
+            try:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
+                assert client.set("key", "value") == "OK1"
+                assert len(mock_hc.check_health.call_args_list) == 9
 
-            another_hc = Mock(spec=HealthCheck)
-            another_hc.check_health.return_value = True
+                another_hc = Mock(spec=HealthCheck)
+                another_hc.check_health.return_value = True
 
-            client.add_health_check(another_hc)
-            client._check_db_health(mock_db1)
+                client.add_health_check(another_hc)
+                client._check_db_health(mock_db1)
 
-            assert mock_hc.check_health.call_count == 12
-            assert another_hc.check_health.call_count == 3
+                assert len(mock_hc.check_health.call_args_list) == 12
+                assert len(another_hc.check_health.call_args_list) == 3
+
+            finally:
+                client.close()
 
     @pytest.mark.parametrize(
         "mock_multi_db_config,mock_db, mock_db1, mock_db2",
@@ -612,22 +709,27 @@ def test_set_active_database(
             mock_hc.check_health.return_value = True
 
             client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
-            assert client.set("key", "value") == "OK1"
-            assert mock_hc.check_health.call_count == 9
-
-            client.set_active_database(mock_db)
-            assert client.set("key", "value") == "OK"
-
-            with pytest.raises(
-                ValueError, match="Given database is not a member of database list"
-            ):
-                client.set_active_database(Mock(spec=SyncDatabase))
-
-            mock_hc.check_health.return_value = False
-
-            with pytest.raises(
-                NoValidDatabaseException,
-                match="Cannot set active database, database is unhealthy",
-            ):
-                client.set_active_database(mock_db1)
+            try:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
+                assert client.set("key", "value") == "OK1"
+                assert len(mock_hc.check_health.call_args_list) == 9
+
+                client.set_active_database(mock_db)
+                assert client.set("key", "value") == "OK"
+
+                with pytest.raises(
+                    ValueError, match="Given database is not a member of database list"
+                ):
+                    client.set_active_database(Mock(spec=SyncDatabase))
+
+                mock_hc.check_health.return_value = False
+
+                with pytest.raises(
+                    NoValidDatabaseException,
+                    match="Cannot set active database, database is unhealthy",
+                ):
+                    client.set_active_database(mock_db1)
+            finally:
+                client.close()
diff --git a/tests/test_multidb/test_pipeline.py b/tests/test_multidb/test_pipeline.py
index 0055718d4f..b88872b64b 100644
--- a/tests/test_multidb/test_pipeline.py
+++ b/tests/test_multidb/test_pipeline.py
@@ -1,5 +1,4 @@
 import threading
-from time import sleep
 from unittest.mock import patch, Mock
 
 import pybreaker
@@ -11,6 +10,7 @@
 from redis.multidb.failover import (
     WeightBasedFailoverStrategy,
 )
+from tests.helpers import wait_for_condition
 from tests.test_multidb.conftest import create_weighted_list
 
 
@@ -53,14 +53,19 @@ def test_executes_pipeline_against_correct_db(
             mock_hc.check_health.return_value = True
 
             client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            try:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
 
-            pipe = client.pipeline()
-            pipe.set("key1", "value1")
-            pipe.get("key1")
+                pipe = client.pipeline()
+                pipe.set("key1", "value1")
+                pipe.get("key1")
 
-            assert pipe.execute() == ["OK1", "value1"]
-            assert mock_hc.check_health.call_count == 9
+                assert pipe.execute() == ["OK1", "value1"]
+                assert len(mock_hc.check_health.call_args_list) == 9
+            finally:
+                client.close()
 
     @pytest.mark.parametrize(
         "mock_multi_db_config,mock_db, mock_db1, mock_db2",
@@ -89,29 +94,31 @@ def test_execute_pipeline_against_correct_db_and_closed_circuit(
             pipe.execute.return_value = ["OK1", "value1"]
             mock_db1.client.pipeline.return_value = pipe
 
-            mock_hc.check_health.side_effect = [
-                False,
-                True,
-                True,
-                True,
-                True,
-                True,
-                True,
-            ]
+            def mock_check_health(database):
+                if database == mock_db2:
+                    return False
+                else:
+                    return True
+
+            mock_hc.check_health.side_effect = mock_check_health
 
             client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            try:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
 
-            with client.pipeline() as pipe:
-                pipe.set("key1", "value1")
-                pipe.get("key1")
+                with client.pipeline() as pipe:
+                    pipe.set("key1", "value1")
+                    pipe.get("key1")
 
-            assert pipe.execute() == ["OK1", "value1"]
-            assert mock_hc.check_health.call_count == 7
+                assert pipe.execute() == ["OK1", "value1"]
 
-            assert mock_db.circuit.state == CBState.CLOSED
-            assert mock_db1.circuit.state == CBState.CLOSED
-            assert mock_db2.circuit.state == CBState.OPEN
+                assert mock_db.circuit.state == CBState.CLOSED
+                assert mock_db1.circuit.state == CBState.CLOSED
+                assert mock_db2.circuit.state == CBState.OPEN
+            finally:
+                client.close()
 
     @pytest.mark.parametrize(
         "mock_multi_db_config,mock_db, mock_db1, mock_db2",
@@ -225,40 +232,54 @@ def mock_check_health(database):
             mock_multi_db_config.failover_strategy = WeightBasedFailoverStrategy()
 
             client = MultiDBClient(mock_multi_db_config)
-
-            with client.pipeline() as pipe:
-                pipe.set("key1", "value")
-                pipe.get("key1")
-
-                # Run 1: All databases healthy - should use mock_db1 (highest weight 0.7)
-                assert pipe.execute() == ["OK1", "value"]
-
-                # Wait for mock_db1 to become unhealthy
-                assert db1_became_unhealthy.wait(timeout=1.0), (
-                    "Timeout waiting for mock_db1 to become unhealthy"
-                )
-                sleep(0.01)
-
-                # Run 2: mock_db1 unhealthy - should failover to mock_db2 (weight 0.5)
-                assert pipe.execute() == ["OK2", "value"]
-
-                # Wait for mock_db2 to become unhealthy
-                assert db2_became_unhealthy.wait(timeout=1.0), (
-                    "Timeout waiting for mock_db2 to become unhealthy"
-                )
-                sleep(0.01)
-
-                # Run 3: mock_db1 and mock_db2 unhealthy - should use mock_db (weight 0.2)
-                assert pipe.execute() == ["OK", "value"]
-
-                # Wait for mock_db to become unhealthy
-                assert db_became_unhealthy.wait(timeout=1.0), (
-                    "Timeout waiting for mock_db to become unhealthy"
-                )
-                sleep(0.01)
-
-                # Run 4: mock_db unhealthy, others healthy - should use mock_db1 (highest weight)
-                assert pipe.execute() == ["OK1", "value"]
+            try:
+                with client.pipeline() as pipe:
+                    pipe.set("key1", "value")
+                    pipe.get("key1")
+
+                    # Run 1: All databases healthy - should use mock_db1 (highest weight 0.7)
+                    assert pipe.execute() == ["OK1", "value"]
+
+                    # Wait for mock_db1 to become unhealthy
+                    assert db1_became_unhealthy.wait(timeout=1.0), (
+                        "Timeout waiting for mock_db1 to become unhealthy"
+                    )
+                    wait_for_condition(
+                        lambda: cb1.state == CBState.OPEN,
+                        timeout=0.2,
+                        error_message="Timeout waiting for cb1 to open",
+                    )
+
+                    # Run 2: mock_db1 unhealthy - should failover to mock_db2 (weight 0.5)
+                    assert pipe.execute() == ["OK2", "value"]
+
+                    # Wait for mock_db2 to become unhealthy
+                    assert db2_became_unhealthy.wait(timeout=1.0), (
+                        "Timeout waiting for mock_db2 to become unhealthy"
+                    )
+                    wait_for_condition(
+                        lambda: cb2.state == CBState.OPEN,
+                        timeout=0.2,
+                        error_message="Timeout waiting for cb2 to open",
+                    )
+
+                    # Run 3: mock_db1 and mock_db2 unhealthy - should use mock_db (weight 0.2)
+                    assert pipe.execute() == ["OK", "value"]
+
+                    # Wait for mock_db to become unhealthy
+                    assert db_became_unhealthy.wait(timeout=1.0), (
+                        "Timeout waiting for mock_db to become unhealthy"
+                    )
+                    wait_for_condition(
+                        lambda: cb.state == CBState.OPEN,
+                        timeout=0.2,
+                        error_message="Timeout waiting for cb to open",
+                    )
+
+                    # Run 4: mock_db unhealthy, others healthy - should use mock_db1 (highest weight)
+                    assert pipe.execute() == ["OK1", "value"]
+            finally:
+                client.close()
 
 
 @pytest.mark.onlynoncluster
@@ -291,14 +312,19 @@ def test_executes_transaction_against_correct_db(
             mock_hc.check_health.return_value = True
 
             client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            try:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
 
-            def callback(pipe: Pipeline):
-                pipe.set("key1", "value1")
-                pipe.get("key1")
+                def callback(pipe: Pipeline):
+                    pipe.set("key1", "value1")
+                    pipe.get("key1")
 
-            assert client.transaction(callback) == ["OK1", "value1"]
-            assert mock_hc.check_health.call_count == 9
+                assert client.transaction(callback) == ["OK1", "value1"]
+                assert len(mock_hc.check_health.call_args_list) >= 9
+            finally:
+                client.close()
 
     @pytest.mark.parametrize(
         "mock_multi_db_config,mock_db, mock_db1, mock_db2",
@@ -325,29 +351,32 @@ def test_execute_transaction_against_correct_db_and_closed_circuit(
         ):
             mock_db1.client.transaction.return_value = ["OK1", "value1"]
 
-            mock_hc.check_health.side_effect = [
-                False,
-                True,
-                True,
-                True,
-                True,
-                True,
-                True,
-            ]
+            def mock_check_health(database):
+                if database == mock_db2:
+                    return False
+                else:
+                    return True
+
+            mock_hc.check_health.side_effect = mock_check_health
 
             client = MultiDBClient(mock_multi_db_config)
-            assert mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+            try:
+                assert (
+                    mock_multi_db_config.failover_strategy.set_databases.call_count == 1
+                )
 
-            def callback(pipe: Pipeline):
-                pipe.set("key1", "value1")
-                pipe.get("key1")
+                def callback(pipe: Pipeline):
+                    pipe.set("key1", "value1")
+                    pipe.get("key1")
 
-            assert client.transaction(callback) == ["OK1", "value1"]
-            assert mock_hc.check_health.call_count == 7
+                assert client.transaction(callback) == ["OK1", "value1"]
+                assert len(mock_hc.check_health.call_args_list) >= 7
 
-            assert mock_db.circuit.state == CBState.CLOSED
-            assert mock_db1.circuit.state == CBState.CLOSED
-            assert mock_db2.circuit.state == CBState.OPEN
+                assert mock_db.circuit.state == CBState.CLOSED
+                assert mock_db1.circuit.state == CBState.CLOSED
+                assert mock_db2.circuit.state == CBState.OPEN
+            finally:
+                client.close()
 
     @pytest.mark.parametrize(
         "mock_multi_db_config,mock_db, mock_db1, mock_db2",
@@ -453,37 +482,52 @@ def mock_check_health(database):
             mock_multi_db_config.failover_strategy = WeightBasedFailoverStrategy()
 
             client = MultiDBClient(mock_multi_db_config)
+            try:
 
-            def callback(pipe: Pipeline):
-                pipe.set("key1", "value1")
-                pipe.get("key1")
+                def callback(pipe: Pipeline):
+                    pipe.set("key1", "value1")
+                    pipe.get("key1")
 
-            # Run 1: All databases healthy - should use mock_db1 (highest weight 0.7)
-            assert client.transaction(callback) == ["OK1", "value"]
+                # Run 1: All databases healthy - should use mock_db1 (highest weight 0.7)
+                assert client.transaction(callback) == ["OK1", "value"]
 
-            # Wait for mock_db1 to become unhealthy
-            assert db1_became_unhealthy.wait(timeout=1.0), (
-                "Timeout waiting for mock_db1 to become unhealthy"
-            )
-            sleep(0.01)
+                # Wait for mock_db1 to become unhealthy
+                assert db1_became_unhealthy.wait(timeout=1.0), (
+                    "Timeout waiting for mock_db1 to become unhealthy"
+                )
+                wait_for_condition(
+                    lambda: cb1.state == CBState.OPEN,
+                    timeout=0.2,
+                    error_message="Timeout waiting for cb1 to open",
+                )
 
-            # Run 2: mock_db1 unhealthy - should failover to mock_db2 (weight 0.5)
-            assert client.transaction(callback) == ["OK2", "value"]
+                # Run 2: mock_db1 unhealthy - should failover to mock_db2 (weight 0.5)
+                assert client.transaction(callback) == ["OK2", "value"]
 
-            # Wait for mock_db2 to become unhealthy
-            assert db2_became_unhealthy.wait(timeout=1.0), (
-                "Timeout waiting for mock_db2 to become unhealthy"
-            )
-            sleep(0.01)
+                # Wait for mock_db2 to become unhealthy
+                assert db2_became_unhealthy.wait(timeout=1.0), (
+                    "Timeout waiting for mock_db2 to become unhealthy"
+                )
+                wait_for_condition(
+                    lambda: cb2.state == CBState.OPEN,
+                    timeout=0.2,
+                    error_message="Timeout waiting for cb2 to open",
+                )
 
-            # Run 3: mock_db1 and mock_db2 unhealthy - should use mock_db (weight 0.2)
-            assert client.transaction(callback) == ["OK", "value"]
+                # Run 3: mock_db1 and mock_db2 unhealthy - should use mock_db (weight 0.2)
+                assert client.transaction(callback) == ["OK", "value"]
 
-            # Wait for mock_db to become unhealthy
-            assert db_became_unhealthy.wait(timeout=1.0), (
-                "Timeout waiting for mock_db to become unhealthy"
-            )
-            sleep(0.01)
+                # Wait for mock_db to become unhealthy
+                assert db_became_unhealthy.wait(timeout=1.0), (
+                    "Timeout waiting for mock_db to become unhealthy"
+                )
+                wait_for_condition(
+                    lambda: cb.state == CBState.OPEN,
+                    timeout=0.2,
+                    error_message="Timeout waiting for cb to open",
+                )
 
-            # Run 4: mock_db unhealthy, others healthy - should use mock_db1 (highest weight)
-            assert client.transaction(callback) == ["OK1", "value"]
+                # Run 4: mock_db unhealthy, others healthy - should use mock_db1 (highest weight)
+                assert client.transaction(callback) == ["OK1", "value"]
+            finally:
+                client.close()

From e6fb50506967dbdd6e8c334190c32651ebea1506 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Tue, 11 Nov 2025 15:31:15 +0200
Subject: [PATCH 1162/1164] Adding support for CAS/CAD commands. (#3837)

* Add DIGEST command support with tests

* Add DELEX command support with tests

* Adding changes related to SET command

* Add experimental annotations for the CAS/CAD methods and new args
---
 redis/commands/cluster.py           |   1 +
 redis/commands/core.py              | 156 ++++++++++++++---
 redis/commands/helpers.py           |  21 ++-
 redis/utils.py                      |  73 ++++++++
 tests/test_asyncio/test_commands.py | 248 +++++++++++++++++++++++++++-
 tests/test_commands.py              | 244 ++++++++++++++++++++++++++-
 6 files changed, 721 insertions(+), 22 deletions(-)

diff --git a/redis/commands/cluster.py b/redis/commands/cluster.py
index 13f2035265..81883b67b4 100644
--- a/redis/commands/cluster.py
+++ b/redis/commands/cluster.py
@@ -61,6 +61,7 @@
         "GEOPOS",
         "GEORADIUS",
         "GEORADIUSBYMEMBER",
+        "DIGEST",
         "GET",
         "GETBIT",
         "GETRANGE",
diff --git a/redis/commands/core.py b/redis/commands/core.py
index 7b9ba7295c..d9e8b577f1 100644
--- a/redis/commands/core.py
+++ b/redis/commands/core.py
@@ -47,10 +47,12 @@
 )
 from redis.utils import (
     deprecated_function,
+    experimental_args,
+    experimental_method,
     extract_expire_flags,
 )
 
-from .helpers import list_or_args
+from .helpers import at_most_one_value_set, list_or_args
 
 if TYPE_CHECKING:
     import redis.asyncio.client
@@ -1729,6 +1731,57 @@ def delete(self, *names: KeyT) -> ResponseT:
     def __delitem__(self, name: KeyT):
         self.delete(name)
 
+    @experimental_method()
+    def delex(
+        self,
+        name: KeyT,
+        ifeq: Optional[Union[bytes, str]] = None,
+        ifne: Optional[Union[bytes, str]] = None,
+        ifdeq: Optional[str] = None,  # hex digest
+        ifdne: Optional[str] = None,  # hex digest
+    ) -> int:
+        """
+        Conditionally removes the specified key.
+
+        Warning:
+        **Experimental** since 7.1.
+        This API may change or be removed without notice.
+        The API may change based on feedback.
+
+        Arguments:
+            name: KeyT - the key to delete
+            ifeq match-valu: Optional[Union[bytes, str]] - Delete the key only if its value is equal to match-value
+            ifne match-value: Optional[Union[bytes, str]] - Delete the key only if its value is not equal to match-value
+            ifdeq match-digest: Optional[str] - Delete the key only if the digest of its value is equal to match-digest
+            ifdne match-digest: Optional[str] - Delete the key only if the digest of its value is not equal to match-digest
+
+        Returns:
+            int: 1 if the key was deleted, 0 otherwise.
+        Raises:
+            redis.exceptions.ResponseError: if key exists but is not a string
+                                            and a condition is specified.
+            ValueError: if more than one condition is provided.
+
+
+        Requires Redis 8.4 or greater.
+        For more information, see https://redis.io/commands/delex
+        """
+        conds = [x is not None for x in (ifeq, ifne, ifdeq, ifdne)]
+        if sum(conds) > 1:
+            raise ValueError("Only one of IFEQ/IFNE/IFDEQ/IFDNE may be specified")
+
+        pieces = ["DELEX", name]
+        if ifeq is not None:
+            pieces += ["IFEQ", ifeq]
+        elif ifne is not None:
+            pieces += ["IFNE", ifne]
+        elif ifdeq is not None:
+            pieces += ["IFDEQ", ifdeq]
+        elif ifdne is not None:
+            pieces += ["IFDNE", ifdne]
+
+        return self.execute_command(*pieces)
+
     def dump(self, name: KeyT) -> ResponseT:
         """
         Return a serialized version of the value stored at the specified key.
@@ -1835,6 +1888,32 @@ def expiretime(self, key: str) -> int:
         """
         return self.execute_command("EXPIRETIME", key)
 
+    @experimental_method()
+    def digest(self, name: KeyT) -> Optional[str]:
+        """
+        Return the digest of the value stored at the specified key.
+
+        Warning:
+        **Experimental** since 7.1.
+        This API may change or be removed without notice.
+        The API may change based on feedback.
+
+        Arguments:
+          - name: KeyT - the key to get the digest of
+
+        Returns:
+          - None if the key does not exist
+          - (bulk string) the XXH3 digest of the value as a hex string
+        Raises:
+          - ResponseError if key exists but is not a string
+
+
+        Requires Redis 8.4 or greater.
+        For more information, see https://redis.io/commands/digest
+        """
+        # Bulk string response is already handled (bytes/str based on decode_responses)
+        return self.execute_command("DIGEST", name)
+
     def get(self, name: KeyT) -> ResponseT:
         """
         Return the value at key ``name``, or None if the key doesn't exist
@@ -1883,8 +1962,7 @@ def getex(
 
         For more information, see https://redis.io/commands/getex
         """
-        opset = {ex, px, exat, pxat}
-        if len(opset) > 2 or len(opset) > 1 and persist:
+        if not at_most_one_value_set((ex, px, exat, pxat, persist)):
             raise DataError(
                 "``ex``, ``px``, ``exat``, ``pxat``, "
                 "and ``persist`` are mutually exclusive."
@@ -2072,8 +2150,7 @@ def msetex(
         Available since Redis 8.4
         For more information, see https://redis.io/commands/msetex
         """
-        opset = {ex, px, exat, pxat}
-        if len(opset) > 2 or len(opset) > 1 and keepttl:
+        if not at_most_one_value_set((ex, px, exat, pxat, keepttl)):
             raise DataError(
                 "``ex``, ``px``, ``exat``, ``pxat``, "
                 "and ``keepttl`` are mutually exclusive."
@@ -2327,6 +2404,7 @@ def restore(
 
         return self.execute_command("RESTORE", *params)
 
+    @experimental_args(["ifeq", "ifne", "ifdeq", "ifdne"])
     def set(
         self,
         name: KeyT,
@@ -2339,10 +2417,20 @@ def set(
         get: bool = False,
         exat: Optional[AbsExpiryT] = None,
         pxat: Optional[AbsExpiryT] = None,
+        ifeq: Optional[Union[bytes, str]] = None,
+        ifne: Optional[Union[bytes, str]] = None,
+        ifdeq: Optional[str] = None,  # hex digest of current value
+        ifdne: Optional[str] = None,  # hex digest of current value
     ) -> ResponseT:
         """
         Set the value at key ``name`` to ``value``
 
+        Warning:
+        **Experimental** since 7.1.
+        The usage of the arguments ``ifeq``, ``ifne``, ``ifdeq``, and ``ifdne``
+        is experimental. The API or returned results when those parameters are used
+        may change based on feedback.
+
         ``ex`` sets an expire flag on key ``name`` for ``ex`` seconds.
 
         ``px`` sets an expire flag on key ``name`` for ``px`` milliseconds.
@@ -2366,35 +2454,67 @@ def set(
         ``pxat`` sets an expire flag on key ``name`` for ``ex`` milliseconds,
             specified in unix time.
 
+        ``ifeq`` set the value at key ``name`` to ``value`` only if the current
+            value exactly matches the argument.
+            If key doesn’t exist - it won’t be created.
+            (Requires Redis 8.4 or greater)
+
+        ``ifne`` set the value at key ``name`` to ``value`` only if the current
+            value does not exactly match the argument.
+            If key doesn’t exist - it will be created.
+            (Requires Redis 8.4 or greater)
+
+        ``ifdeq`` set the value at key ``name`` to ``value`` only if the current
+            value XXH3 hex digest exactly matches the argument.
+            If key doesn’t exist - it won’t be created.
+            (Requires Redis 8.4 or greater)
+
+        ``ifdne`` set the value at key ``name`` to ``value`` only if the current
+            value XXH3 hex digest does not exactly match the argument.
+            If key doesn’t exist - it will be created.
+            (Requires Redis 8.4 or greater)
+
         For more information, see https://redis.io/commands/set
         """
-        opset = {ex, px, exat, pxat}
-        if len(opset) > 2 or len(opset) > 1 and keepttl:
+
+        if not at_most_one_value_set((ex, px, exat, pxat, keepttl)):
             raise DataError(
                 "``ex``, ``px``, ``exat``, ``pxat``, "
                 "and ``keepttl`` are mutually exclusive."
             )
 
-        if nx and xx:
-            raise DataError("``nx`` and ``xx`` are mutually exclusive.")
+        # Enforce mutual exclusivity among all conditional switches.
+        if not at_most_one_value_set((nx, xx, ifeq, ifne, ifdeq, ifdne)):
+            raise DataError(
+                "``nx``, ``xx``, ``ifeq``, ``ifne``, ``ifdeq``, ``ifdne`` are mutually exclusive."
+            )
 
         pieces: list[EncodableT] = [name, value]
         options = {}
 
-        pieces.extend(extract_expire_flags(ex, px, exat, pxat))
-
-        if keepttl:
-            pieces.append("KEEPTTL")
-
+        # Conditional modifier (exactly one at most)
         if nx:
             pieces.append("NX")
-        if xx:
+        elif xx:
             pieces.append("XX")
+        elif ifeq is not None:
+            pieces.extend(("IFEQ", ifeq))
+        elif ifne is not None:
+            pieces.extend(("IFNE", ifne))
+        elif ifdeq is not None:
+            pieces.extend(("IFDEQ", ifdeq))
+        elif ifdne is not None:
+            pieces.extend(("IFDNE", ifdne))
 
         if get:
             pieces.append("GET")
             options["get"] = True
 
+        pieces.extend(extract_expire_flags(ex, px, exat, pxat))
+
+        if keepttl:
+            pieces.append("KEEPTTL")
+
         return self.execute_command("SET", *pieces, **options)
 
     def __setitem__(self, name: KeyT, value: EncodableT):
@@ -5201,8 +5321,7 @@ def hgetex(
         if not keys:
             raise DataError("'hgetex' should have at least one key provided")
 
-        opset = {ex, px, exat, pxat}
-        if len(opset) > 2 or len(opset) > 1 and persist:
+        if not at_most_one_value_set((ex, px, exat, pxat, persist)):
             raise DataError(
                 "``ex``, ``px``, ``exat``, ``pxat``, "
                 "and ``persist`` are mutually exclusive."
@@ -5347,8 +5466,7 @@ def hsetex(
                 "'items' must contain a list of key/value pairs."
             )
 
-        opset = {ex, px, exat, pxat}
-        if len(opset) > 2 or len(opset) > 1 and keepttl:
+        if not at_most_one_value_set((ex, px, exat, pxat, keepttl)):
             raise DataError(
                 "``ex``, ``px``, ``exat``, ``pxat``, "
                 "and ``keepttl`` are mutually exclusive."
diff --git a/redis/commands/helpers.py b/redis/commands/helpers.py
index 8fd2b9527e..4a57591f04 100644
--- a/redis/commands/helpers.py
+++ b/redis/commands/helpers.py
@@ -1,7 +1,7 @@
 import copy
 import random
 import string
-from typing import List, Tuple
+from typing import Any, Iterable, List, Tuple
 
 import redis
 from redis.typing import KeysT, KeyT
@@ -96,3 +96,22 @@ def get_protocol_version(client):
         return client.connection_pool.connection_kwargs.get("protocol")
     elif isinstance(client, redis.cluster.AbstractRedisCluster):
         return client.nodes_manager.connection_kwargs.get("protocol")
+
+
+def at_most_one_value_set(iterable: Iterable[Any]):
+    """
+    Checks that at most one of the values in the iterable is truthy.
+
+    Args:
+        iterable: An iterable of values to check.
+
+    Returns:
+        True if at most one value is truthy, False otherwise.
+
+    Raises:
+        Might raise an error if the values in iterable are not boolean-compatible.
+        For example if the type of the values implement
+        __len__ or __bool__ methods and they raise an error.
+    """
+    values = (bool(x) for x in iterable)
+    return sum(values) <= 1
diff --git a/redis/utils.py b/redis/utils.py
index 66c1480a9b..37a11a74f5 100644
--- a/redis/utils.py
+++ b/redis/utils.py
@@ -346,3 +346,76 @@ def new_init(self, *args, **kwargs):
 
     cls.__init__ = new_init
     return cls
+
+
+def warn_experimental(name, stacklevel=2):
+    import warnings
+
+    msg = (
+        f"Call to experimental method {name}. "
+        "Be aware that the function arguments can "
+        "change or be removed in future versions."
+    )
+    warnings.warn(msg, category=UserWarning, stacklevel=stacklevel)
+
+
+def experimental_method() -> Callable[[C], C]:
+    """
+    Decorator to mark a function as experimental.
+    """
+
+    def decorator(func: C) -> C:
+        @wraps(func)
+        def wrapper(*args, **kwargs):
+            warn_experimental(func.__name__, stacklevel=2)
+            return func(*args, **kwargs)
+
+        return wrapper
+
+    return decorator
+
+
+def warn_experimental_arg_usage(
+    arg_name: Union[list, str],
+    function_name: str,
+    stacklevel: int = 2,
+):
+    import warnings
+
+    msg = (
+        f"Call to '{function_name}' method with experimental"
+        f" usage of input argument/s '{arg_name}'."
+    )
+    warnings.warn(msg, category=UserWarning, stacklevel=stacklevel)
+
+
+def experimental_args(
+    args_to_warn: list = ["*"],
+) -> Callable[[C], C]:
+    """
+    Decorator to mark specified args of a function as experimental.
+    """
+
+    def decorator(func: C) -> C:
+        @wraps(func)
+        def wrapper(*args, **kwargs):
+            # Get function argument names
+            arg_names = func.__code__.co_varnames[: func.__code__.co_argcount]
+
+            provided_args = dict(zip(arg_names, args))
+            provided_args.update(kwargs)
+
+            provided_args.pop("self", None)
+
+            if len(provided_args) == 0:
+                return func(*args, **kwargs)
+
+            for arg in args_to_warn:
+                if arg in provided_args:
+                    warn_experimental_arg_usage(arg, func.__name__, stacklevel=3)
+
+            return func(*args, **kwargs)
+
+        return wrapper
+
+    return decorator
diff --git a/tests/test_asyncio/test_commands.py b/tests/test_asyncio/test_commands.py
index 3a10a50b93..47d8893743 100644
--- a/tests/test_asyncio/test_commands.py
+++ b/tests/test_asyncio/test_commands.py
@@ -11,7 +11,7 @@
 
 import pytest
 import pytest_asyncio
-from redis import RedisClusterException, ResponseError
+from redis import DataError, RedisClusterException, ResponseError
 import redis
 from redis import exceptions
 from redis._parsers.helpers import (
@@ -1032,6 +1032,114 @@ async def test_delitem(self, r: redis.Redis):
         await r.delete("a")
         assert await r.get("a") is None
 
+    def _ensure_str(self, x):
+        return x.decode("ascii") if isinstance(x, (bytes, bytearray)) else x
+
+    async def _server_xxh3_digest(self, r, key):
+        """
+        Get the server-computed XXH3 hex digest for the key's value.
+        Requires the DIGEST command implemented on the server.
+        """
+        d = await r.execute_command("DIGEST", key)
+        return None if d is None else self._ensure_str(d).lower()
+
+    @skip_if_server_version_lt("8.3.224")
+    async def test_delex_nonexistent(self, r):
+        await r.delete("nope")
+        assert await r.delex("nope") == 0
+
+    @skip_if_server_version_lt("8.3.224")
+    async def test_delex_unconditional_delete_string(self, r):
+        await r.set("k", b"v")
+        assert await r.exists("k") == 1
+        assert await r.delex("k") == 1
+        assert await r.exists("k") == 0
+
+    @skip_if_server_version_lt("8.3.224")
+    async def test_delex_unconditional_delete_nonstring_allowed(self, r):
+        # Spec: error happens only when a condition is specified on a non-string key.
+        await r.lpush("lst", "a")
+        assert await r.delex("lst") == 1
+        assert await r.exists("lst") == 0
+
+        await r.lpush("lst", "a")
+
+        with pytest.raises(redis.ResponseError):
+            await r.delex("lst", ifeq=b"a")
+        assert await r.exists("lst") == 1
+
+    @skip_if_server_version_lt("8.3.224")
+    async def test_delex_ifeq(self, r):
+        await r.set("k", b"abc")
+        assert await r.delex("k", ifeq=b"abc") == 1  # matches → deleted
+        assert await r.exists("k") == 0
+
+        await r.set("k", b"abc")
+        assert await r.delex("k", ifeq=b"zzz") == 0  # not match → not deleted
+        assert await r.get("k") == b"abc"  # still there
+
+    @skip_if_server_version_lt("8.3.224")
+    async def test_delex_ifne(self, r):
+        await r.set("k2", b"abc")
+        assert await r.delex("k2", ifne=b"zzz") == 1  # different → deleted
+        assert await r.exists("k2") == 0
+
+        await r.set("k2", b"abc")
+        assert await r.delex("k2", ifne=b"abc") == 0  # equal → not deleted
+        assert await r.get("k2") == b"abc"
+
+    @skip_if_server_version_lt("8.3.224")
+    async def test_delex_with_conditionon_nonstring_values(self, r):
+        await r.lpush("nk", "x")
+        with pytest.raises(redis.ResponseError):
+            await r.delex("nk", ifeq=b"x")
+        with pytest.raises(redis.ResponseError):
+            await r.delex("nk", ifne=b"x")
+        with pytest.raises(redis.ResponseError):
+            await r.delex("nk", ifdeq="deadbeef")
+
+    @skip_if_server_version_lt("8.3.224")
+    @pytest.mark.parametrize("val", [b"", b"abc", b"The quick brown fox"])
+    async def test_delex_ifdeq_and_ifdne(self, r, val):
+        await r.set("h", val)
+        d = await self._server_xxh3_digest(r, "h")
+        assert d is not None
+
+        # IFDEQ should delete with exact digest
+        await r.set("h", val)
+        assert await r.delex("h", ifdeq=d) == 1
+        assert await r.exists("h") == 0
+
+        # IFDNE should NOT delete when digest matches
+        await r.set("h", val)
+        assert await r.delex("h", ifdne=d) == 0
+        assert await r.get("h") == val
+
+        # IFDNE should delete when digest doesn't match
+        await r.set("h", val)
+        wrong = "0" * len(d)
+        if wrong == d:
+            wrong = "f" * len(d)
+        assert await r.delex("h", ifdne=wrong) == 1
+        assert await r.exists("h") == 0
+
+    @skip_if_server_version_lt("8.3.224")
+    async def test_delex_pipeline(self, r):
+        await r.mset({"p1{45}": b"A", "p2{45}": b"B"})
+        p = r.pipeline()
+        p.delex("p1{45}", ifeq=b"A")
+        p.delex("p2{45}", ifne=b"B")  # false → 0
+        p.delex("nope")  # nonexistent → 0
+        out = await p.execute()
+        assert out == [1, 0, 0]
+
+    @skip_if_server_version_lt("8.3.224")
+    async def test_delex_mutual_exclusion_client_side(self, r):
+        with pytest.raises(ValueError):
+            await r.delex("k", ifeq=b"A", ifne=b"B")
+        with pytest.raises(ValueError):
+            await r.delex("k", ifdeq="aa", ifdne="bb")
+
     @skip_if_server_version_lt("4.0.0")
     async def test_unlink(self, r: redis.Redis):
         assert await r.unlink("a") == 0
@@ -1115,6 +1223,48 @@ async def test_expireat_unixtime(self, r: redis.Redis):
         assert await r.expireat("a", expire_at_seconds)
         assert 0 < await r.ttl("a") <= 61
 
+    @skip_if_server_version_lt("8.3.224")
+    async def test_digest_nonexistent_returns_none(self, r):
+        assert await r.digest("no:such:key") is None
+
+    @skip_if_server_version_lt("8.3.224")
+    async def test_digest_wrong_type_raises(self, r):
+        await r.lpush("alist", "x")
+        with pytest.raises(Exception):  # or redis.exceptions.ResponseError
+            await r.digest("alist")
+
+    @skip_if_server_version_lt("8.3.224")
+    @pytest.mark.parametrize(
+        "value", [b"", b"abc", b"The quick brown fox jumps over the lazy dog"]
+    )
+    async def test_digest_response_when_available(self, r, value):
+        key = "k:digest"
+        await r.delete(key)
+        await r.set(key, value)
+
+        res = await r.digest(key)
+        # got is str if decode_responses=True; ensure bytes->str for comparison
+        if isinstance(res, bytes):
+            res = res.decode()
+        assert res is not None
+        assert all(c in "0123456789abcdefABCDEF" for c in res)
+
+        assert len(res) == 16
+
+    @skip_if_server_version_lt("8.3.224")
+    async def test_pipeline_digest(self, r):
+        k1, k2 = "k:d1{42}", "k:d2{42}"
+        await r.mset({k1: b"A", k2: b"B"})
+        p = r.pipeline()
+        p.digest(k1)
+        p.digest(k2)
+        out = await p.execute()
+        assert len(out) == 2
+        for d in out:
+            if isinstance(d, bytes):
+                d = d.decode()
+            assert d is None or len(d) == 16
+
     async def test_get_and_set(self, r: redis.Redis):
         # get and set can't be tested independently of each other
         assert await r.get("a") is None
@@ -1699,6 +1849,102 @@ async def test_set_keepttl(self, r: redis.Redis):
         assert await r.get("a") == b"2"
         assert 0 < await r.ttl("a") <= 10
 
+    @skip_if_server_version_lt("8.3.224")
+    async def test_set_ifeq_true_sets_and_returns_true(self, r):
+        await r.delete("k")
+        await r.set("k", b"foo")
+        assert await r.set("k", b"bar", ifeq=b"foo") is True
+        assert await r.get("k") == b"bar"
+
+    @skip_if_server_version_lt("8.3.224")
+    async def test_set_ifeq_false_does_not_set_returns_none(self, r):
+        await r.delete("k")
+        await r.set("k", b"foo")
+        assert await r.set("k", b"bar", ifeq=b"nope") is None
+        assert await r.get("k") == b"foo"
+
+    @skip_if_server_version_lt("8.3.224")
+    async def test_set_ifne_true_sets(self, r):
+        await r.delete("k")
+        await r.set("k", b"foo")
+        assert await r.set("k", b"bar", ifne=b"zzz") is True
+        assert await r.get("k") == b"bar"
+
+    @skip_if_server_version_lt("8.3.224")
+    async def test_set_ifne_false_does_not_set(self, r):
+        await r.delete("k")
+        await r.set("k", b"foo")
+        assert await r.set("k", b"bar", ifne=b"foo") is None
+        assert await r.get("k") == b"foo"
+
+    @skip_if_server_version_lt("8.3.224")
+    async def test_set_ifeq_when_key_missing_does_not_create(self, r):
+        await r.delete("k")
+        assert await r.set("k", b"bar", ifeq=b"foo") is None
+        assert await r.exists("k") == 0
+
+    @skip_if_server_version_lt("8.3.224")
+    async def test_set_ifne_when_key_missing_creates(self, r):
+        await r.delete("k")
+        assert await r.set("k", b"bar", ifne=b"foo") is True
+        assert await r.get("k") == b"bar"
+
+    @skip_if_server_version_lt("8.3.224")
+    @pytest.mark.parametrize("val", [b"", b"abc", b"The quick brown fox"])
+    async def test_set_ifdeq_and_ifdne(self, r, val):
+        await r.delete("k")
+        await r.set("k", val)
+        d = await self._server_xxh3_digest(r, "k")
+        assert d is not None
+
+        # IFDEQ must match to set; if key missing => won't create
+        assert await r.set("k", b"X", ifdeq=d) is True
+        assert await r.get("k") == b"X"
+
+        await r.delete("k")
+        # key missing + IFDEQ => not created
+        assert await r.set("k", b"Y", ifdeq=d) is None
+        assert await r.exists("k") == 0
+
+        # IFDNE: create when missing, and set when digest differs
+        assert await r.set("k", b"bar", ifdne=d) is True
+        prev_d = await self._server_xxh3_digest(r, "k")
+        assert prev_d is not None
+        # If digest equal → do not set
+        assert await r.set("k", b"zzz", ifdne=prev_d) is None
+        assert await r.get("k") == b"bar"
+
+    @skip_if_server_version_lt("8.3.224")
+    async def test_set_with_get_returns_previous_value(self, r):
+        await r.delete("k")
+        # when key didn’t exist → returns None, and key is created if condition allows it
+        prev = await r.set("k", b"v1", get=True, ifne=b"any")  # IFNE on missing creates
+        assert prev is None
+        # subsequent GET returns previous value, regardless of whether set occurs
+        prev2 = await r.set(
+            "k", b"v2", get=True, ifeq=b"v1"
+        )  # matches → set; returns "v1"
+        assert prev2 == b"v1"
+        prev3 = await r.set(
+            "k", b"v3", get=True, ifeq=b"no"
+        )  # no set; returns previous "v2"
+        assert prev3 == b"v2"
+        assert await r.get("k") == b"v2"
+
+    @skip_if_server_version_lt("8.3.224")
+    async def test_set_mutual_exclusion_client_side(self, r):
+        await r.delete("k")
+        with pytest.raises(DataError):
+            await r.set("k", b"v", nx=True, ifeq=b"x")
+        with pytest.raises(DataError):
+            await r.set("k", b"v", ifdeq="aa", ifdne="bb")
+        with pytest.raises(DataError):
+            await r.set("k", b"v", ex=1, px=1)
+        with pytest.raises(DataError):
+            await r.set("k", b"v", exat=1, pxat=1)
+        with pytest.raises(DataError):
+            await r.set("k", b"v", ex=1, exat=1)
+
     async def test_setex(self, r: redis.Redis):
         assert await r.setex("a", 60, "1")
         assert await r.get("a") == b"1"
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 4925329a21..d10e45f88f 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -9,7 +9,7 @@
 from unittest.mock import patch
 
 import pytest
-from redis import RedisClusterException, ResponseError
+from redis import DataError, RedisClusterException, ResponseError
 import redis
 from redis import exceptions
 from redis._parsers.helpers import (
@@ -1501,6 +1501,114 @@ def test_delitem(self, r):
         del r["a"]
         assert r.get("a") is None
 
+    def _ensure_str(self, x):
+        return x.decode("ascii") if isinstance(x, (bytes, bytearray)) else x
+
+    def _server_xxh3_digest(self, r, key):
+        """
+        Get the server-computed XXH3 hex digest for the key's value.
+        Requires the DIGEST command implemented on the server.
+        """
+        d = r.execute_command("DIGEST", key)
+        return None if d is None else self._ensure_str(d).lower()
+
+    @skip_if_server_version_lt("8.3.224")
+    def test_delex_nonexistent(self, r):
+        r.delete("nope")
+        assert r.delex("nope") == 0
+
+    @skip_if_server_version_lt("8.3.224")
+    def test_delex_unconditional_delete_string(self, r):
+        r.set("k", b"v")
+        assert r.exists("k") == 1
+        assert r.delex("k") == 1
+        assert r.exists("k") == 0
+
+    @skip_if_server_version_lt("8.3.224")
+    def test_delex_unconditional_delete_nonstring_allowed(self, r):
+        # Spec: error happens only when a condition is specified on a non-string key.
+        r.lpush("lst", "a")
+        assert r.delex("lst") == 1
+        assert r.exists("lst") == 0
+
+        r.lpush("lst", "a")
+
+        with pytest.raises(redis.ResponseError):
+            r.delex("lst", ifeq=b"a")
+        assert r.exists("lst") == 1
+
+    @skip_if_server_version_lt("8.3.224")
+    def test_delex_ifeq(self, r):
+        r.set("k", b"abc")
+        assert r.delex("k", ifeq=b"abc") == 1  # matches → deleted
+        assert r.exists("k") == 0
+
+        r.set("k", b"abc")
+        assert r.delex("k", ifeq=b"zzz") == 0  # not match → not deleted
+        assert r.get("k") == b"abc"  # still there
+
+    @skip_if_server_version_lt("8.3.224")
+    def test_delex_ifne(self, r):
+        r.set("k2", b"abc")
+        assert r.delex("k2", ifne=b"zzz") == 1  # different → deleted
+        assert r.exists("k2") == 0
+
+        r.set("k2", b"abc")
+        assert r.delex("k2", ifne=b"abc") == 0  # equal → not deleted
+        assert r.get("k2") == b"abc"
+
+    @skip_if_server_version_lt("8.3.224")
+    def test_delex_with_conditionon_nonstring_values(self, r):
+        r.lpush("nk", "x")
+        with pytest.raises(redis.ResponseError):
+            r.delex("nk", ifeq=b"x")
+        with pytest.raises(redis.ResponseError):
+            r.delex("nk", ifne=b"x")
+        with pytest.raises(redis.ResponseError):
+            r.delex("nk", ifdeq="deadbeef")
+
+    @skip_if_server_version_lt("8.3.224")
+    @pytest.mark.parametrize("val", [b"", b"abc", b"The quick brown fox"])
+    def test_delex_ifdeq_and_ifdne(self, r, val):
+        r.set("h", val)
+        d = self._server_xxh3_digest(r, "h")
+        assert d is not None
+
+        # IFDEQ should delete with exact digest
+        r.set("h", val)
+        assert r.delex("h", ifdeq=d) == 1
+        assert r.exists("h") == 0
+
+        # IFDNE should NOT delete when digest matches
+        r.set("h", val)
+        assert r.delex("h", ifdne=d) == 0
+        assert r.get("h") == val
+
+        # IFDNE should delete when digest doesn't match
+        r.set("h", val)
+        wrong = "0" * len(d)
+        if wrong == d:
+            wrong = "f" * len(d)
+        assert r.delex("h", ifdne=wrong) == 1
+        assert r.exists("h") == 0
+
+    @skip_if_server_version_lt("8.3.224")
+    def test_delex_pipeline(self, r):
+        r.mset({"p1{45}": b"A", "p2{45}": b"B"})
+        p = r.pipeline()
+        p.delex("p1{45}", ifeq=b"A")
+        p.delex("p2{45}", ifne=b"B")  # false → 0
+        p.delex("nope")  # nonexistent → 0
+        out = p.execute()
+        assert out == [1, 0, 0]
+
+    @skip_if_server_version_lt("8.3.224")
+    def test_delex_mutual_exclusion_client_side(self, r):
+        with pytest.raises(ValueError):
+            r.delex("k", ifeq=b"A", ifne=b"B")
+        with pytest.raises(ValueError):
+            r.delex("k", ifdeq="aa", ifdne="bb")
+
     @skip_if_server_version_lt("4.0.0")
     def test_unlink(self, r):
         assert r.unlink("a") == 0
@@ -1666,6 +1774,48 @@ def test_expireat_option_lt(self, r):
         expire_at = redis_server_time(r) + datetime.timedelta(minutes=1)
         assert r.expireat("key", expire_at, lt=True) is True
 
+    @skip_if_server_version_lt("8.3.224")
+    def test_digest_nonexistent_returns_none(self, r):
+        assert r.digest("no:such:key") is None
+
+    @skip_if_server_version_lt("8.3.224")
+    def test_digest_wrong_type_raises(self, r):
+        r.lpush("alist", "x")
+        with pytest.raises(Exception):  # or redis.exceptions.ResponseError
+            r.digest("alist")
+
+    @skip_if_server_version_lt("8.3.224")
+    @pytest.mark.parametrize(
+        "value", [b"", b"abc", b"The quick brown fox jumps over the lazy dog"]
+    )
+    def test_digest_response_when_available(self, r, value):
+        key = "k:digest"
+        r.delete(key)
+        r.set(key, value)
+
+        res = r.digest(key)
+        # got is str if decode_responses=True; ensure bytes->str for comparison
+        if isinstance(res, bytes):
+            res = res.decode()
+        assert res is not None
+        assert all(c in "0123456789abcdefABCDEF" for c in res)
+
+        assert len(res) == 16
+
+    @skip_if_server_version_lt("8.3.224")
+    def test_pipeline_digest(self, r):
+        k1, k2 = "k:d1{42}", "k:d2{42}"
+        r.mset({k1: b"A", k2: b"B"})
+        p = r.pipeline()
+        p.digest(k1)
+        p.digest(k2)
+        out = p.execute()
+        assert len(out) == 2
+        for d in out:
+            if isinstance(d, bytes):
+                d = d.decode()
+            assert d is None or len(d) == 16
+
     def test_get_and_set(self, r):
         # get and set can't be tested independently of each other
         assert r.get("a") is None
@@ -2377,6 +2527,98 @@ def test_set_keepttl(self, r):
         assert r.get("a") == b"2"
         assert 0 < r.ttl("a") <= 10
 
+    @skip_if_server_version_lt("8.3.224")
+    def test_set_ifeq_true_sets_and_returns_true(self, r):
+        r.delete("k")
+        r.set("k", b"foo")
+        assert r.set("k", b"bar", ifeq=b"foo") is True
+        assert r.get("k") == b"bar"
+
+    @skip_if_server_version_lt("8.3.224")
+    def test_set_ifeq_false_does_not_set_returns_none(self, r):
+        r.delete("k")
+        r.set("k", b"foo")
+        assert r.set("k", b"bar", ifeq=b"nope") is None
+        assert r.get("k") == b"foo"
+
+    @skip_if_server_version_lt("8.3.224")
+    def test_set_ifne_true_sets(self, r):
+        r.delete("k")
+        r.set("k", b"foo")
+        assert r.set("k", b"bar", ifne=b"zzz") is True
+        assert r.get("k") == b"bar"
+
+    @skip_if_server_version_lt("8.3.224")
+    def test_set_ifne_false_does_not_set(self, r):
+        r.delete("k")
+        r.set("k", b"foo")
+        assert r.set("k", b"bar", ifne=b"foo") is None
+        assert r.get("k") == b"foo"
+
+    @skip_if_server_version_lt("8.3.224")
+    def test_set_ifeq_when_key_missing_does_not_create(self, r):
+        r.delete("k")
+        assert r.set("k", b"bar", ifeq=b"foo") is None
+        assert r.exists("k") == 0
+
+    @skip_if_server_version_lt("8.3.224")
+    def test_set_ifne_when_key_missing_creates(self, r):
+        r.delete("k")
+        assert r.set("k", b"bar", ifne=b"foo") is True
+        assert r.get("k") == b"bar"
+
+    @skip_if_server_version_lt("8.3.224")
+    @pytest.mark.parametrize("val", [b"", b"abc", b"The quick brown fox"])
+    def test_set_ifdeq_and_ifdne(self, r, val):
+        r.delete("k")
+        r.set("k", val)
+        d = self._server_xxh3_digest(r, "k")
+        assert d is not None
+
+        # IFDEQ must match to set; if key missing => won't create
+        assert r.set("k", b"X", ifdeq=d) is True
+        assert r.get("k") == b"X"
+
+        r.delete("k")
+        # key missing + IFDEQ => not created
+        assert r.set("k", b"Y", ifdeq=d) is None
+        assert r.exists("k") == 0
+
+        # IFDNE: create when missing, and set when digest differs
+        assert r.set("k", b"bar", ifdne=d) is True
+        prev_d = self._server_xxh3_digest(r, "k")
+        assert prev_d is not None
+        # If digest equal → do not set
+        assert r.set("k", b"zzz", ifdne=prev_d) is None
+        assert r.get("k") == b"bar"
+
+    @skip_if_server_version_lt("8.3.224")
+    def test_set_with_get_returns_previous_value(self, r):
+        r.delete("k")
+        # when key didn’t exist → returns None, and key is created if condition allows it
+        prev = r.set("k", b"v1", get=True, ifne=b"any")  # IFNE on missing creates
+        assert prev is None
+        # subsequent GET returns previous value, regardless of whether set occurs
+        prev2 = r.set("k", b"v2", get=True, ifeq=b"v1")  # matches → set; returns "v1"
+        assert prev2 == b"v1"
+        prev3 = r.set("k", b"v3", get=True, ifeq=b"no")  # no set; returns previous "v2"
+        assert prev3 == b"v2"
+        assert r.get("k") == b"v2"
+
+    @skip_if_server_version_lt("8.3.224")
+    def test_set_mutual_exclusion_client_side(self, r):
+        r.delete("k")
+        with pytest.raises(DataError):
+            r.set("k", b"v", nx=True, ifeq=b"x")
+        with pytest.raises(DataError):
+            r.set("k", b"v", ifdeq="aa", ifdne="bb")
+        with pytest.raises(DataError):
+            r.set("k", b"v", ex=1, px=1)
+        with pytest.raises(DataError):
+            r.set("k", b"v", exat=1, pxat=1)
+        with pytest.raises(DataError):
+            r.set("k", b"v", ex=1, exat=1)
+
     @skip_if_server_version_lt("6.2.0")
     def test_set_get(self, r):
         assert r.set("a", "True", get=True) is None

From a5ab18fb76522cb1341c81e0032d29df87c85013 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Wed, 12 Nov 2025 15:34:51 +0200
Subject: [PATCH 1163/1164] Adding support for HYBRID search. (#3813)

* Adding support for hybrid search.

* Adding YIELD_SCORE_AS tests and clearing up support for the keyword

* Removing commented test code.

* Applying review comments - part 1

* Fixing linters

* vset test causes crashes of the test servers in pipeline - changing the problematic tests to use less data(sync and async tests)

* Update list concatenation to use extend. Fix spelling error in tests.Extend a test to use two reducers.

* Investigate server failures during 8.4 tests

* Updating docstrings for combine and scorer

* MArking hybrid query related classes as experimental

* Allowing multiple load and apply statements
---
 .github/actions/run-tests/action.yml   |    1 +
 docker-compose.yml                     |    2 +-
 dockers/sentinel.conf                  |    7 +-
 redis/commands/search/__init__.py      |    2 +
 redis/commands/search/commands.py      |  147 +-
 redis/commands/search/hybrid_query.py  |  373 ++
 redis/commands/search/hybrid_result.py |   27 +
 tests/test_asyncio/test_search.py      | 4947 ++++++++------
 tests/test_asyncio/test_vsets.py       |   12 +-
 tests/test_search.py                   | 8240 ++++++++++++++----------
 tests/test_vsets.py                    |   12 +-
 11 files changed, 8524 insertions(+), 5246 deletions(-)
 create mode 100644 redis/commands/search/hybrid_query.py
 create mode 100644 redis/commands/search/hybrid_result.py

diff --git a/.github/actions/run-tests/action.yml b/.github/actions/run-tests/action.yml
index f2331a92a5..5f801c894b 100644
--- a/.github/actions/run-tests/action.yml
+++ b/.github/actions/run-tests/action.yml
@@ -142,6 +142,7 @@ runs:
         sudo apt-get install -y redis-tools
         echo "Docker Containers:"
         docker ps
+        echo "Cluster nodes:"
         redis-cli -p 16379 CLUSTER NODES
       shell: bash
 
diff --git a/docker-compose.yml b/docker-compose.yml
index ef7fd813b3..1699cf61af 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,7 +1,7 @@
 ---
 # image tag 8.0-RC2-pre is the one matching the 8.0 GA release
 x-client-libs-stack-image: &client-libs-stack-image
-  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_STACK_IMAGE_TAG:-8.2}"
+  image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_STACK_IMAGE_TAG:-8.4-RC1-pre.2}"
 
 x-client-libs-image: &client-libs-image
   image: "redislabs/client-libs-test:${CLIENT_LIBS_TEST_IMAGE_TAG:-8.4-RC1-pre.2}"
diff --git a/dockers/sentinel.conf b/dockers/sentinel.conf
index 75f711e5d4..817a528765 100644
--- a/dockers/sentinel.conf
+++ b/dockers/sentinel.conf
@@ -1,5 +1,8 @@
 sentinel resolve-hostnames yes
 sentinel monitor redis-py-test redis 6379 2
-sentinel down-after-milliseconds redis-py-test 5000
-sentinel failover-timeout redis-py-test 60000
+# Be much more tolerant to transient stalls (index builds, GC, I/O)
+sentinel down-after-milliseconds redis-py-test 60000
+# Avoid rapid repeated failover attempts
+sentinel failover-timeout redis-py-test 180000
+# Keep it conservative: sync one replica at a time
 sentinel parallel-syncs redis-py-test 1
\ No newline at end of file
diff --git a/redis/commands/search/__init__.py b/redis/commands/search/__init__.py
index 9fda9ee4d6..ff14077021 100644
--- a/redis/commands/search/__init__.py
+++ b/redis/commands/search/__init__.py
@@ -4,6 +4,7 @@
 from .commands import (
     AGGREGATE_CMD,
     CONFIG_CMD,
+    HYBRID_CMD,
     INFO_CMD,
     PROFILE_CMD,
     SEARCH_CMD,
@@ -102,6 +103,7 @@ def __init__(self, client, index_name="idx"):
         self._RESP2_MODULE_CALLBACKS = {
             INFO_CMD: self._parse_info,
             SEARCH_CMD: self._parse_search,
+            HYBRID_CMD: self._parse_hybrid_search,
             AGGREGATE_CMD: self._parse_aggregate,
             PROFILE_CMD: self._parse_profile,
             SPELLCHECK_CMD: self._parse_spellcheck,
diff --git a/redis/commands/search/commands.py b/redis/commands/search/commands.py
index afe5d1c684..9064f8b7ee 100644
--- a/redis/commands/search/commands.py
+++ b/redis/commands/search/commands.py
@@ -1,13 +1,25 @@
 import itertools
 import time
-from typing import Dict, List, Optional, Union
+from typing import Any, Dict, List, Optional, Union
 
+from redis._parsers.helpers import pairs_to_dict
 from redis.client import NEVER_DECODE, Pipeline
+from redis.commands.search.hybrid_query import (
+    CombineResultsMethod,
+    HybridCursorQuery,
+    HybridPostProcessingConfig,
+    HybridQuery,
+)
+from redis.commands.search.hybrid_result import HybridCursorResult, HybridResult
 from redis.utils import deprecated_function
 
 from ..helpers import get_protocol_version
 from ._util import to_string
-from .aggregation import AggregateRequest, AggregateResult, Cursor
+from .aggregation import (
+    AggregateRequest,
+    AggregateResult,
+    Cursor,
+)
 from .document import Document
 from .field import Field
 from .index_definition import IndexDefinition
@@ -47,6 +59,7 @@
 SUGGET_COMMAND = "FT.SUGGET"
 SYNUPDATE_CMD = "FT.SYNUPDATE"
 SYNDUMP_CMD = "FT.SYNDUMP"
+HYBRID_CMD = "FT.HYBRID"
 
 NOOFFSETS = "NOOFFSETS"
 NOFIELDS = "NOFIELDS"
@@ -84,6 +97,28 @@ def _parse_search(self, res, **kwargs):
             field_encodings=kwargs["query"]._return_fields_decode_as,
         )
 
+    def _parse_hybrid_search(self, res, **kwargs):
+        res_dict = pairs_to_dict(res, decode_keys=True)
+        if "cursor" in kwargs:
+            return HybridCursorResult(
+                search_cursor_id=int(res_dict["SEARCH"]),
+                vsim_cursor_id=int(res_dict["VSIM"]),
+            )
+
+        results: List[Dict[str, Any]] = []
+        # the original results are a list of lists
+        # we convert them to a list of dicts
+        for res_item in res_dict["results"]:
+            item_dict = pairs_to_dict(res_item, decode_keys=True)
+            results.append(item_dict)
+
+        return HybridResult(
+            total_results=int(res_dict["total_results"]),
+            results=results,
+            warnings=res_dict["warnings"],
+            execution_time=float(res_dict["execution_time"]),
+        )
+
     def _parse_aggregate(self, res, **kwargs):
         return self._get_aggregate_result(res, kwargs["query"], kwargs["has_cursor"])
 
@@ -470,7 +505,7 @@ def get_params_args(
             return []
         args = []
         if len(query_params) > 0:
-            args.append("params")
+            args.append("PARAMS")
             args.append(len(query_params) * 2)
             for key, value in query_params.items():
                 args.append(key)
@@ -525,6 +560,59 @@ def search(
             SEARCH_CMD, res, query=query, duration=(time.monotonic() - st) * 1000.0
         )
 
+    def hybrid_search(
+        self,
+        query: HybridQuery,
+        combine_method: Optional[CombineResultsMethod] = None,
+        post_processing: Optional[HybridPostProcessingConfig] = None,
+        params_substitution: Optional[Dict[str, Union[str, int, float, bytes]]] = None,
+        timeout: Optional[int] = None,
+        cursor: Optional[HybridCursorQuery] = None,
+    ) -> Union[HybridResult, HybridCursorResult, Pipeline]:
+        """
+        Execute a hybrid search using both text and vector queries
+
+        Args:
+            - **query**: HybridQuery object
+                        Contains the text and vector queries
+            - **combine_method**: CombineResultsMethod object
+                        Contains the combine method and parameters
+            - **post_processing**: HybridPostProcessingConfig object
+                        Contains the post processing configuration
+            - **params_substitution**: Dict[str, Union[str, int, float, bytes]]
+                        Contains the parameters substitution
+            - **timeout**: int - contains the timeout in milliseconds
+            - **cursor**: HybridCursorQuery object - contains the cursor configuration
+
+
+        For more information see `FT.SEARCH <https://redis.io/commands/ft.hybrid>`.
+        """
+        index = self.index_name
+        options = {}
+        pieces = [HYBRID_CMD, index]
+        pieces.extend(query.get_args())
+        if combine_method:
+            pieces.extend(combine_method.get_args())
+        if post_processing:
+            pieces.extend(post_processing.build_args())
+        if params_substitution:
+            pieces.extend(self.get_params_args(params_substitution))
+        if timeout:
+            pieces.extend(("TIMEOUT", timeout))
+        if cursor:
+            options["cursor"] = True
+            pieces.extend(cursor.build_args())
+
+        if get_protocol_version(self.client) not in ["3", 3]:
+            options[NEVER_DECODE] = True
+
+        res = self.execute_command(*pieces, **options)
+
+        if isinstance(res, Pipeline):
+            return res
+
+        return self._parse_results(HYBRID_CMD, res, **options)
+
     def explain(
         self,
         query: Union[str, Query],
@@ -965,6 +1053,59 @@ async def search(
             SEARCH_CMD, res, query=query, duration=(time.monotonic() - st) * 1000.0
         )
 
+    async def hybrid_search(
+        self,
+        query: HybridQuery,
+        combine_method: Optional[CombineResultsMethod] = None,
+        post_processing: Optional[HybridPostProcessingConfig] = None,
+        params_substitution: Optional[Dict[str, Union[str, int, float, bytes]]] = None,
+        timeout: Optional[int] = None,
+        cursor: Optional[HybridCursorQuery] = None,
+    ) -> Union[HybridResult, HybridCursorResult, Pipeline]:
+        """
+        Execute a hybrid search using both text and vector queries
+
+        Args:
+            - **query**: HybridQuery object
+                        Contains the text and vector queries
+            - **combine_method**: CombineResultsMethod object
+                        Contains the combine method and parameters
+            - **post_processing**: HybridPostProcessingConfig object
+                        Contains the post processing configuration
+            - **params_substitution**: Dict[str, Union[str, int, float, bytes]]
+                        Contains the parameters substitution
+            - **timeout**: int - contains the timeout in milliseconds
+            - **cursor**: HybridCursorQuery object - contains the cursor configuration
+
+
+        For more information see `FT.SEARCH <https://redis.io/commands/ft.hybrid>`.
+        """
+        index = self.index_name
+        options = {}
+        pieces = [HYBRID_CMD, index]
+        pieces.extend(query.get_args())
+        if combine_method:
+            pieces.extend(combine_method.get_args())
+        if post_processing:
+            pieces.extend(post_processing.build_args())
+        if params_substitution:
+            pieces.extend(self.get_params_args(params_substitution))
+        if timeout:
+            pieces.extend(("TIMEOUT", timeout))
+        if cursor:
+            options["cursor"] = True
+            pieces.extend(cursor.build_args())
+
+        if get_protocol_version(self.client) not in ["3", 3]:
+            options[NEVER_DECODE] = True
+
+        res = await self.execute_command(*pieces, **options)
+
+        if isinstance(res, Pipeline):
+            return res
+
+        return self._parse_results(HYBRID_CMD, res, **options)
+
     async def aggregate(
         self,
         query: Union[AggregateResult, Cursor],
diff --git a/redis/commands/search/hybrid_query.py b/redis/commands/search/hybrid_query.py
new file mode 100644
index 0000000000..1607f1ded2
--- /dev/null
+++ b/redis/commands/search/hybrid_query.py
@@ -0,0 +1,373 @@
+from enum import Enum
+from typing import Any, Dict, List, Optional, Union
+
+from redis.utils import experimental
+
+try:
+    from typing import Self  # Py 3.11+
+except ImportError:
+    from typing_extensions import Self
+
+from redis.commands.search.aggregation import Limit, Reducer
+from redis.commands.search.query import Filter, SortbyField
+
+
+@experimental
+class HybridSearchQuery:
+    def __init__(
+        self,
+        query_string: str,
+        scorer: Optional[str] = None,
+        yield_score_as: Optional[str] = None,
+    ) -> None:
+        """
+        Create a new hybrid search query object.
+
+        Args:
+            query_string: The query string.
+            scorer: The scorer to use. Allowed values are "TFIDF" or "BM25".
+            yield_score_as: The name of the field to yield the score as.
+        """
+        self._query_string = query_string
+        self._scorer = scorer
+        self._yield_score_as = yield_score_as
+
+    def query_string(self) -> str:
+        """Return the query string of this query object."""
+        return self._query_string
+
+    def scorer(self, scorer: str) -> "HybridSearchQuery":
+        """
+        Scoring algorithm for text search query.
+        Allowed values are "TFIDF", "DISMAX", "DOCSCORE", "BM25", etc.
+
+        For more information about supported scroring algorithms,
+        see https://redis.io/docs/latest/develop/ai/search-and-query/advanced-concepts/scoring/
+        """
+        self._scorer = scorer
+        return self
+
+    def yield_score_as(self, alias: str) -> "HybridSearchQuery":
+        """
+        Yield the score as a field.
+        """
+        self._yield_score_as = alias
+        return self
+
+    def get_args(self) -> List[str]:
+        args = ["SEARCH", self._query_string]
+        if self._scorer:
+            args.extend(("SCORER", self._scorer))
+        if self._yield_score_as:
+            args.extend(("YIELD_SCORE_AS", self._yield_score_as))
+        return args
+
+
+class VectorSearchMethods(Enum):
+    KNN = "KNN"
+    RANGE = "RANGE"
+
+
+@experimental
+class HybridVsimQuery:
+    def __init__(
+        self,
+        vector_field_name: str,
+        vector_data: Union[bytes, str],
+        vsim_search_method: Optional[VectorSearchMethods] = None,
+        vsim_search_method_params: Optional[Dict[str, Any]] = None,
+        filter: Optional["Filter"] = None,
+    ) -> None:
+        """
+        Create a new hybrid vsim query object.
+
+        Args:
+            vector_field_name: Vector field name.
+
+            vector_data: Vector data for the search.
+
+            vsim_search_method: Search method that will be used for the vsim search.
+
+            vsim_search_method_params: Search method parameters. Use the param names
+                for keys and the values for the values.
+                Example for KNN: {"K": 10, "EF_RUNTIME": 100}
+                                    where K is mandatory and defines the number of results
+                                    and EF_RUNTIME is optional and definesthe exploration factor.
+                Example for RANGE: {"RADIUS": 10, "EPSILON": 0.1}
+                                    where RADIUS is mandatory and defines the radius of the search
+                                    and EPSILON is optional and defines the accuracy of the search.
+                For both KNN and RANGE, the following parameter is optional:
+                    YIELD_SCORE_AS: The name of the field to yield the calculated score as.
+
+            filter: If defined, a filter will be applied on the vsim query results.
+        """
+        self._vector_field = vector_field_name
+        self._vector_data = vector_data
+        if vsim_search_method and vsim_search_method_params:
+            self.vsim_method_params(vsim_search_method, **vsim_search_method_params)
+        else:
+            self._vsim_method_params = None
+        self._filter = filter
+
+    def vector_field(self) -> str:
+        """Return the vector field name of this query object."""
+        return self._vector_field
+
+    def vector_data(self) -> Union[bytes, str]:
+        """Return the vector data of this query object."""
+        return self._vector_data
+
+    def vsim_method_params(
+        self,
+        method: VectorSearchMethods,
+        **kwargs,
+    ) -> "HybridVsimQuery":
+        """
+        Add search method parameters to the query.
+
+        Args:
+            method: Vector search method name. Supported values are "KNN" or "RANGE".
+            kwargs: Search method parameters. Use the param names for keys and the
+                values for the values. Example: {"K": 10, "EF_RUNTIME": 100}.
+        """
+        vsim_method_params: List[Union[str, int]] = [method.value]
+        if kwargs:
+            vsim_method_params.append(len(kwargs.items()) * 2)
+            for key, value in kwargs.items():
+                vsim_method_params.extend((key, value))
+        self._vsim_method_params = vsim_method_params
+
+        return self
+
+    def filter(self, flt: "HybridFilter") -> "HybridVsimQuery":
+        """
+        Add a filter to the query.
+
+        Args:
+            flt: A HybridFilter object, used on a corresponding field.
+        """
+        self._filter = flt
+        return self
+
+    def get_args(self) -> List[str]:
+        args = ["VSIM", self._vector_field, self._vector_data]
+        if self._vsim_method_params:
+            args.extend(self._vsim_method_params)
+        if self._filter:
+            args.extend(self._filter.args)
+
+        return args
+
+
+class HybridQuery:
+    def __init__(
+        self,
+        search_query: HybridSearchQuery,
+        vector_similarity_query: HybridVsimQuery,
+    ) -> None:
+        """
+        Create a new hybrid query object.
+
+        Args:
+            search_query: HybridSearchQuery object containing the text query.
+            vector_similarity_query: HybridVsimQuery object containing the vector similarity query.
+        """
+        self._search_query = search_query
+        self._vector_similarity_query = vector_similarity_query
+
+    def get_args(self) -> List[str]:
+        args = []
+        args.extend(self._search_query.get_args())
+        args.extend(self._vector_similarity_query.get_args())
+        return args
+
+
+class CombinationMethods(Enum):
+    RRF = "RRF"
+    LINEAR = "LINEAR"
+
+
+@experimental
+class CombineResultsMethod:
+    def __init__(self, method: CombinationMethods, **kwargs) -> None:
+        """
+        Create a new combine results method object.
+
+        Args:
+            method: The combine method to use - RRF or LINEAR.
+            kwargs: Additional combine parameters.
+                    For RRF, the following parameters are supported(at least one should be provided):
+                                WINDOW: Limits fusion scopeLimits fusion scope.
+                                CONSTANT: Controls decay of rank influence.
+                                YIELD_SCORE_AS: The name of the field to yield the calculated score as.
+                    For LINEAR, supported parameters (at least one should be provided):
+                                ALPHA: The weight of the first query.
+                                BETA: The weight of the second query.
+                                YIELD_SCORE_AS: The name of the field to yield the calculated score as.
+
+                    The additional parameters are not validated and are passed as is to the server.
+                    The supported format is to provide the parameter names and values like the following:
+                        CombineResultsMethod(CombinationMethods.RRF, WINDOW=3, CONSTANT=0.5)
+                        CombineResultsMethod(CombinationMethods.LINEAR, ALPHA=0.5, BETA=0.5)
+        """
+        self._method = method
+        self._kwargs = kwargs
+
+    def get_args(self) -> List[Union[str, int]]:
+        args: List[Union[str, int]] = ["COMBINE", self._method.value]
+        if self._kwargs:
+            args.append(len(self._kwargs.items()) * 2)
+            for key, value in self._kwargs.items():
+                args.extend((key, value))
+        return args
+
+
+@experimental
+class HybridPostProcessingConfig:
+    def __init__(self) -> None:
+        """
+        Create a new hybrid post processing configuration object.
+        """
+        self._load_statements = []
+        self._apply_statements = []
+        self._groupby_statements = []
+        self._sortby_fields = []
+        self._filter = None
+        self._limit = None
+
+    def load(self, *fields: str) -> Self:
+        """
+        Add load statement parameters to the query.
+        """
+        if fields:
+            fields_str = " ".join(fields)
+            fields_list = fields_str.split(" ")
+            self._load_statements.extend(("LOAD", len(fields_list), *fields_list))
+        return self
+
+    def group_by(self, fields: List[str], *reducers: Reducer) -> Self:
+        """
+        Specify by which fields to group the aggregation.
+
+        Args:
+            fields: Fields to group by. This can either be a single string or a list
+                of strings. In both cases, the field should be specified as `@field`.
+            reducers: One or more reducers. Reducers may be found in the
+                `aggregation` module.
+        """
+
+        fields = [fields] if isinstance(fields, str) else fields
+
+        ret = ["GROUPBY", str(len(fields)), *fields]
+        for reducer in reducers:
+            ret.extend(("REDUCE", reducer.NAME, str(len(reducer.args))))
+            ret.extend(reducer.args)
+            if reducer._alias is not None:
+                ret.extend(("AS", reducer._alias))
+
+        self._groupby_statements.extend(ret)
+        return self
+
+    def apply(self, **kwexpr) -> Self:
+        """
+        Specify one or more projection expressions to add to each result.
+
+        Args:
+            kwexpr: One or more key-value pairs for a projection. The key is
+                the alias for the projection, and the value is the projection
+                expression itself, for example `apply(square_root="sqrt(@foo)")`.
+        """
+        apply_args = []
+        for alias, expr in kwexpr.items():
+            ret = ["APPLY", expr]
+            if alias is not None:
+                ret.extend(("AS", alias))
+            apply_args.extend(ret)
+
+        self._apply_statements.extend(apply_args)
+
+        return self
+
+    def sort_by(self, *sortby: "SortbyField") -> Self:
+        """
+        Add sortby parameters to the query.
+        """
+        self._sortby_fields = [*sortby]
+        return self
+
+    def filter(self, filter: "HybridFilter") -> Self:
+        """
+        Add a numeric or string filter to the query.
+
+        Currently, only one of each filter is supported by the engine.
+
+        Args:
+            filter: A NumericFilter or GeoFilter object, used on a corresponding field.
+        """
+        self._filter = filter
+        return self
+
+    def limit(self, offset: int, num: int) -> Self:
+        """
+        Add limit parameters to the query.
+        """
+        self._limit = Limit(offset, num)
+        return self
+
+    def build_args(self) -> List[str]:
+        args = []
+        if self._load_statements:
+            args.extend(self._load_statements)
+        if self._groupby_statements:
+            args.extend(self._groupby_statements)
+        if self._apply_statements:
+            args.extend(self._apply_statements)
+        if self._sortby_fields:
+            sortby_args = []
+            for f in self._sortby_fields:
+                sortby_args.extend(f.args)
+            args.extend(("SORTBY", len(sortby_args), *sortby_args))
+        if self._filter:
+            args.extend(self._filter.args)
+        if self._limit:
+            args.extend(self._limit.build_args())
+
+        return args
+
+
+@experimental
+class HybridFilter(Filter):
+    def __init__(
+        self,
+        conditions: str,
+    ) -> None:
+        """
+        Create a new hybrid filter object.
+
+        Args:
+            conditions: Filter conditions.
+        """
+        args = [conditions]
+        Filter.__init__(self, "FILTER", *args)
+
+
+@experimental
+class HybridCursorQuery:
+    def __init__(self, count: int = 0, max_idle: int = 0) -> None:
+        """
+        Create a new hybrid cursor query object.
+
+        Args:
+            count: Number of results to return per cursor iteration.
+            max_idle: Maximum idle time for the cursor.
+        """
+        self.count = count
+        self.max_idle = max_idle
+
+    def build_args(self):
+        args = ["WITHCURSOR"]
+        if self.count:
+            args += ["COUNT", str(self.count)]
+        if self.max_idle:
+            args += ["MAXIDLE", str(self.max_idle)]
+        return args
diff --git a/redis/commands/search/hybrid_result.py b/redis/commands/search/hybrid_result.py
new file mode 100644
index 0000000000..1154fc040d
--- /dev/null
+++ b/redis/commands/search/hybrid_result.py
@@ -0,0 +1,27 @@
+from dataclasses import dataclass
+from typing import Any, Dict, List, Union
+
+
+@dataclass
+class HybridResult:
+    """
+    Represents the result of a hybrid search query execution
+    Returned by the `hybrid_search` command, when using RESP version 2.
+    """
+
+    total_results: int
+    results: List[Dict[str, Any]]
+    warnings: List[Union[str, bytes]]
+    execution_time: float
+
+
+class HybridCursorResult:
+    def __init__(self, search_cursor_id: int, vsim_cursor_id: int) -> None:
+        """
+        Represents the result of a hybrid search query execution with cursor
+
+        search_cursor_id: int - cursor id for the search query
+        vsim_cursor_id: int - cursor id for the vector similarity query
+        """
+        self.search_cursor_id = search_cursor_id
+        self.vsim_cursor_id = vsim_cursor_id
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index 7f11710cc4..f4b26ae82c 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -3,6 +3,7 @@
 import os
 import asyncio
 from io import TextIOWrapper
+import random
 
 import numpy as np
 import pytest
@@ -10,6 +11,18 @@
 from redis import ResponseError
 import redis.asyncio as redis
 import redis.commands.search.aggregation as aggregations
+from redis.commands.search.hybrid_query import (
+    CombinationMethods,
+    CombineResultsMethod,
+    HybridCursorQuery,
+    HybridFilter,
+    HybridPostProcessingConfig,
+    HybridQuery,
+    HybridSearchQuery,
+    HybridVsimQuery,
+    VectorSearchMethods,
+)
+from redis.commands.search.hybrid_result import HybridCursorResult
 import redis.commands.search.reducers as reducers
 from redis.commands.search import AsyncSearch
 from redis.commands.search.field import (
@@ -20,9 +33,10 @@
     VectorField,
 )
 from redis.commands.search.index_definition import IndexDefinition, IndexType
-from redis.commands.search.query import GeoFilter, NumericFilter, Query
+from redis.commands.search.query import GeoFilter, NumericFilter, Query, SortbyField
 from redis.commands.search.result import Result
 from redis.commands.search.suggestion import Suggestion
+from redis.utils import safe_str
 from tests.conftest import (
     is_resp2_connection,
     skip_if_redis_enterprise,
@@ -41,1972 +55,3239 @@
 )
 
 
-@pytest_asyncio.fixture()
-async def decoded_r(create_redis, stack_url):
-    return await create_redis(decode_responses=True, url=stack_url)
-
+class AsyncSearchTestsBase:
+    @pytest_asyncio.fixture()
+    async def decoded_r(self, create_redis, stack_url):
+        return await create_redis(decode_responses=True, url=stack_url)
 
-async def waitForIndex(env, idx, timeout=None):
-    delay = 0.1
-    while True:
-        try:
-            res = await env.execute_command("FT.INFO", idx)
-            if int(res[res.index("indexing") + 1]) == 0:
-                break
-        except ValueError:
-            break
-        except AttributeError:
+    @staticmethod
+    async def waitForIndex(env, idx, timeout=None):
+        delay = 0.1
+        while True:
             try:
-                if int(res["indexing"]) == 0:
+                res = await env.execute_command("FT.INFO", idx)
+                if int(res[res.index("indexing") + 1]) == 0:
                     break
             except ValueError:
                 break
-        except ResponseError:
-            # index doesn't exist yet
-            # continue to sleep and try again
-            pass
-
-        await asyncio.sleep(delay)
-        if timeout is not None:
-            timeout -= delay
-            if timeout <= 0:
-                break
-
-
-def getClient(decoded_r: redis.Redis):
-    """
-    Gets a client client attached to an index name which is ready to be
-    created
-    """
-    return decoded_r
-
-
-async def createIndex(decoded_r, num_docs=100, definition=None):
-    try:
-        await decoded_r.create_index(
-            (TextField("play", weight=5.0), TextField("txt"), NumericField("chapter")),
-            definition=definition,
-        )
-    except redis.ResponseError:
-        await decoded_r.dropindex(delete_documents=True)
-        return createIndex(decoded_r, num_docs=num_docs, definition=definition)
-
-    chapters = {}
-    bzfp = TextIOWrapper(bz2.BZ2File(WILL_PLAY_TEXT), encoding="utf8")
-
-    r = csv.reader(bzfp, delimiter=";")
-    for n, line in enumerate(r):
-        play, chapter, _, text = line[1], line[2], line[4], line[5]
-
-        key = f"{play}:{chapter}".lower()
-        d = chapters.setdefault(key, {})
-        d["play"] = play
-        d["txt"] = d.get("txt", "") + " " + text
-        d["chapter"] = int(chapter or 0)
-        if len(chapters) == num_docs:
-            break
-
-    indexer = decoded_r.batch_indexer(chunk_size=50)
-    assert isinstance(indexer, AsyncSearch.BatchIndexer)
-    assert 50 == indexer.chunk_size
-
-    for key, doc in chapters.items():
-        await indexer.client.client.hset(key, mapping=doc)
-    await indexer.commit()
-
-
-@pytest.mark.redismod
-async def test_client(decoded_r: redis.Redis):
-    num_docs = 500
-    await createIndex(decoded_r.ft(), num_docs=num_docs)
-    await waitForIndex(decoded_r, "idx")
-    # verify info
-    info = await decoded_r.ft().info()
-    for k in [
-        "index_name",
-        "index_options",
-        "attributes",
-        "num_docs",
-        "max_doc_id",
-        "num_terms",
-        "num_records",
-        "inverted_sz_mb",
-        "offset_vectors_sz_mb",
-        "doc_table_size_mb",
-        "key_table_size_mb",
-        "records_per_doc_avg",
-        "bytes_per_record_avg",
-        "offsets_per_term_avg",
-        "offset_bits_per_record_avg",
-    ]:
-        assert k in info
-
-    assert decoded_r.ft().index_name == info["index_name"]
-    assert num_docs == int(info["num_docs"])
-
-    res = await decoded_r.ft().search("henry iv")
-    if is_resp2_connection(decoded_r):
-        assert isinstance(res, Result)
-        assert 225 == res.total
-        assert 10 == len(res.docs)
-        assert res.duration > 0
-
-        for doc in res.docs:
-            assert doc.id
-            assert doc.play == "Henry IV"
-            assert len(doc.txt) > 0
-
-        # test no content
-        res = await decoded_r.ft().search(Query("king").no_content())
-        assert 194 == res.total
-        assert 10 == len(res.docs)
-        for doc in res.docs:
-            assert "txt" not in doc.__dict__
-            assert "play" not in doc.__dict__
-
-        # test verbatim vs no verbatim
-        total = (await decoded_r.ft().search(Query("kings").no_content())).total
-        vtotal = (
-            await decoded_r.ft().search(Query("kings").no_content().verbatim())
-        ).total
-        assert total > vtotal
-
-        # test in fields
-        txt_total = (
-            await decoded_r.ft().search(Query("henry").no_content().limit_fields("txt"))
-        ).total
-        play_total = (
-            await decoded_r.ft().search(
-                Query("henry").no_content().limit_fields("play")
-            )
-        ).total
-        both_total = (
-            await decoded_r.ft().search(
-                Query("henry").no_content().limit_fields("play", "txt")
-            )
-        ).total
-        assert 129 == txt_total
-        assert 494 == play_total
-        assert 494 == both_total
-
-        # test load_document
-        doc = await decoded_r.ft().load_document("henry vi part 3:62")
-        assert doc is not None
-        assert "henry vi part 3:62" == doc.id
-        assert doc.play == "Henry VI Part 3"
-        assert len(doc.txt) > 0
-
-        # test in-keys
-        ids = [x.id for x in (await decoded_r.ft().search(Query("henry"))).docs]
-        assert 10 == len(ids)
-        subset = ids[:5]
-        docs = await decoded_r.ft().search(Query("henry").limit_ids(*subset))
-        assert len(subset) == docs.total
-        ids = [x.id for x in docs.docs]
-        assert set(ids) == set(subset)
-
-        # test slop and in order
-        assert 193 == (await decoded_r.ft().search(Query("henry king"))).total
-        assert (
-            3
-            == (
-                await decoded_r.ft().search(Query("henry king").slop(0).in_order())
-            ).total
-        )
-        assert (
-            52
-            == (
-                await decoded_r.ft().search(Query("king henry").slop(0).in_order())
-            ).total
-        )
-        assert 53 == (await decoded_r.ft().search(Query("henry king").slop(0))).total
-        assert 167 == (await decoded_r.ft().search(Query("henry king").slop(100))).total
-
-        # test delete document
-        await decoded_r.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
-        res = await decoded_r.ft().search(Query("death of a salesman"))
-        assert 1 == res.total
-
-        assert 1 == await decoded_r.ft().delete_document("doc-5ghs2")
-        res = await decoded_r.ft().search(Query("death of a salesman"))
-        assert 0 == res.total
-        assert 0 == await decoded_r.ft().delete_document("doc-5ghs2")
-
-        await decoded_r.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
-        res = await decoded_r.ft().search(Query("death of a salesman"))
-        assert 1 == res.total
-        await decoded_r.ft().delete_document("doc-5ghs2")
-    else:
-        assert isinstance(res, dict)
-        assert 225 == res["total_results"]
-        assert 10 == len(res["results"])
-
-        for doc in res["results"]:
-            assert doc["id"]
-            assert doc["extra_attributes"]["play"] == "Henry IV"
-            assert len(doc["extra_attributes"]["txt"]) > 0
-
-        # test no content
-        res = await decoded_r.ft().search(Query("king").no_content())
-        assert 194 == res["total_results"]
-        assert 10 == len(res["results"])
-        for doc in res["results"]:
-            assert "extra_attributes" not in doc.keys()
-
-        # test verbatim vs no verbatim
-        total = (await decoded_r.ft().search(Query("kings").no_content()))[
-            "total_results"
-        ]
-        vtotal = (await decoded_r.ft().search(Query("kings").no_content().verbatim()))[
-            "total_results"
-        ]
-        assert total > vtotal
-
-        # test in fields
-        txt_total = (
-            await decoded_r.ft().search(Query("henry").no_content().limit_fields("txt"))
-        )["total_results"]
-        play_total = (
-            await decoded_r.ft().search(
-                Query("henry").no_content().limit_fields("play")
-            )
-        )["total_results"]
-        both_total = (
-            await decoded_r.ft().search(
-                Query("henry").no_content().limit_fields("play", "txt")
-            )
-        )["total_results"]
-        assert 129 == txt_total
-        assert 494 == play_total
-        assert 494 == both_total
-
-        # test load_document
-        doc = await decoded_r.ft().load_document("henry vi part 3:62")
-        assert doc is not None
-        assert "henry vi part 3:62" == doc.id
-        assert doc.play == "Henry VI Part 3"
-        assert len(doc.txt) > 0
-
-        # test in-keys
-        ids = [
-            x["id"] for x in (await decoded_r.ft().search(Query("henry")))["results"]
-        ]
-        assert 10 == len(ids)
-        subset = ids[:5]
-        docs = await decoded_r.ft().search(Query("henry").limit_ids(*subset))
-        assert len(subset) == docs["total_results"]
-        ids = [x["id"] for x in docs["results"]]
-        assert set(ids) == set(subset)
-
-        # test slop and in order
-        assert (
-            193 == (await decoded_r.ft().search(Query("henry king")))["total_results"]
-        )
-        assert (
-            3
-            == (await decoded_r.ft().search(Query("henry king").slop(0).in_order()))[
-                "total_results"
-            ]
-        )
-        assert (
-            52
-            == (await decoded_r.ft().search(Query("king henry").slop(0).in_order()))[
-                "total_results"
-            ]
-        )
-        assert (
-            53
-            == (await decoded_r.ft().search(Query("henry king").slop(0)))[
-                "total_results"
-            ]
-        )
-        assert (
-            167
-            == (await decoded_r.ft().search(Query("henry king").slop(100)))[
-                "total_results"
-            ]
-        )
-
-        # test delete document
-        await decoded_r.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
-        res = await decoded_r.ft().search(Query("death of a salesman"))
-        assert 1 == res["total_results"]
-
-        assert 1 == await decoded_r.ft().delete_document("doc-5ghs2")
-        res = await decoded_r.ft().search(Query("death of a salesman"))
-        assert 0 == res["total_results"]
-        assert 0 == await decoded_r.ft().delete_document("doc-5ghs2")
-
-        await decoded_r.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
-        res = await decoded_r.ft().search(Query("death of a salesman"))
-        assert 1 == res["total_results"]
-        await decoded_r.ft().delete_document("doc-5ghs2")
-
-
-@pytest.mark.redismod
-@pytest.mark.onlynoncluster
-@skip_if_server_version_gte("7.9.0")
-async def test_scores(decoded_r: redis.Redis):
-    await decoded_r.ft().create_index((TextField("txt"),))
-
-    await decoded_r.hset("doc1", mapping={"txt": "foo baz"})
-    await decoded_r.hset("doc2", mapping={"txt": "foo bar"})
-
-    q = Query("foo ~bar").with_scores()
-    res = await decoded_r.ft().search(q)
-    if is_resp2_connection(decoded_r):
-        assert 2 == res.total
-        assert "doc2" == res.docs[0].id
-        assert 3.0 == res.docs[0].score
-        assert "doc1" == res.docs[1].id
-    else:
-        assert 2 == res["total_results"]
-        assert "doc2" == res["results"][0]["id"]
-        assert 3.0 == res["results"][0]["score"]
-        assert "doc1" == res["results"][1]["id"]
-
-
-@pytest.mark.redismod
-@pytest.mark.onlynoncluster
-@skip_if_server_version_lt("7.9.0")
-async def test_scores_with_new_default_scorer(decoded_r: redis.Redis):
-    await decoded_r.ft().create_index((TextField("txt"),))
-
-    await decoded_r.hset("doc1", mapping={"txt": "foo baz"})
-    await decoded_r.hset("doc2", mapping={"txt": "foo bar"})
-
-    q = Query("foo ~bar").with_scores()
-    res = await decoded_r.ft().search(q)
-    if is_resp2_connection(decoded_r):
-        assert 2 == res.total
-        assert "doc2" == res.docs[0].id
-        assert 0.87 == pytest.approx(res.docs[0].score, 0.01)
-        assert "doc1" == res.docs[1].id
-    else:
-        assert 2 == res["total_results"]
-        assert "doc2" == res["results"][0]["id"]
-        assert 0.87 == pytest.approx(res["results"][0]["score"], 0.01)
-        assert "doc1" == res["results"][1]["id"]
-
-
-@pytest.mark.redismod
-async def test_stopwords(decoded_r: redis.Redis):
-    stopwords = ["foo", "bar", "baz"]
-    await decoded_r.ft().create_index((TextField("txt"),), stopwords=stopwords)
-    await decoded_r.hset("doc1", mapping={"txt": "foo bar"})
-    await decoded_r.hset("doc2", mapping={"txt": "hello world"})
-    await waitForIndex(decoded_r, "idx")
-
-    q1 = Query("foo bar").no_content()
-    q2 = Query("foo bar hello world").no_content()
-    res1, res2 = await decoded_r.ft().search(q1), await decoded_r.ft().search(q2)
-    if is_resp2_connection(decoded_r):
-        assert 0 == res1.total
-        assert 1 == res2.total
-    else:
-        assert 0 == res1["total_results"]
-        assert 1 == res2["total_results"]
-
-
-@pytest.mark.redismod
-async def test_filters(decoded_r: redis.Redis):
-    await decoded_r.ft().create_index(
-        (TextField("txt"), NumericField("num"), GeoField("loc"))
-    )
-    await decoded_r.hset(
-        "doc1", mapping={"txt": "foo bar", "num": 3.141, "loc": "-0.441,51.458"}
-    )
-    await decoded_r.hset(
-        "doc2", mapping={"txt": "foo baz", "num": 2, "loc": "-0.1,51.2"}
-    )
-
-    await waitForIndex(decoded_r, "idx")
-    # Test numerical filter
-    q1 = Query("foo").add_filter(NumericFilter("num", 0, 2)).no_content()
-    q2 = (
-        Query("foo")
-        .add_filter(NumericFilter("num", 2, NumericFilter.INF, minExclusive=True))
-        .no_content()
-    )
-    res1, res2 = await decoded_r.ft().search(q1), await decoded_r.ft().search(q2)
-
-    if is_resp2_connection(decoded_r):
-        assert 1 == res1.total
-        assert 1 == res2.total
-        assert "doc2" == res1.docs[0].id
-        assert "doc1" == res2.docs[0].id
-    else:
-        assert 1 == res1["total_results"]
-        assert 1 == res2["total_results"]
-        assert "doc2" == res1["results"][0]["id"]
-        assert "doc1" == res2["results"][0]["id"]
-
-    # Test geo filter
-    q1 = Query("foo").add_filter(GeoFilter("loc", -0.44, 51.45, 10)).no_content()
-    q2 = Query("foo").add_filter(GeoFilter("loc", -0.44, 51.45, 100)).no_content()
-    res1, res2 = await decoded_r.ft().search(q1), await decoded_r.ft().search(q2)
-
-    if is_resp2_connection(decoded_r):
-        assert 1 == res1.total
-        assert 2 == res2.total
-        assert "doc1" == res1.docs[0].id
-
-        # Sort results, after RDB reload order may change
-        res = [res2.docs[0].id, res2.docs[1].id]
-        res.sort()
-        assert ["doc1", "doc2"] == res
-    else:
-        assert 1 == res1["total_results"]
-        assert 2 == res2["total_results"]
-        assert "doc1" == res1["results"][0]["id"]
-
-        # Sort results, after RDB reload order may change
-        res = [res2["results"][0]["id"], res2["results"][1]["id"]]
-        res.sort()
-        assert ["doc1", "doc2"] == res
-
-
-@pytest.mark.redismod
-async def test_sort_by(decoded_r: redis.Redis):
-    await decoded_r.ft().create_index(
-        (TextField("txt"), NumericField("num", sortable=True))
-    )
-    await decoded_r.hset("doc1", mapping={"txt": "foo bar", "num": 1})
-    await decoded_r.hset("doc2", mapping={"txt": "foo baz", "num": 2})
-    await decoded_r.hset("doc3", mapping={"txt": "foo qux", "num": 3})
-
-    # Test sort
-    q1 = Query("foo").sort_by("num", asc=True).no_content()
-    q2 = Query("foo").sort_by("num", asc=False).no_content()
-    res1, res2 = await decoded_r.ft().search(q1), await decoded_r.ft().search(q2)
-
-    if is_resp2_connection(decoded_r):
-        assert 3 == res1.total
-        assert "doc1" == res1.docs[0].id
-        assert "doc2" == res1.docs[1].id
-        assert "doc3" == res1.docs[2].id
-        assert 3 == res2.total
-        assert "doc1" == res2.docs[2].id
-        assert "doc2" == res2.docs[1].id
-        assert "doc3" == res2.docs[0].id
-    else:
-        assert 3 == res1["total_results"]
-        assert "doc1" == res1["results"][0]["id"]
-        assert "doc2" == res1["results"][1]["id"]
-        assert "doc3" == res1["results"][2]["id"]
-        assert 3 == res2["total_results"]
-        assert "doc1" == res2["results"][2]["id"]
-        assert "doc2" == res2["results"][1]["id"]
-        assert "doc3" == res2["results"][0]["id"]
-
-
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.0.0", "search")
-async def test_drop_index(decoded_r: redis.Redis):
-    """
-    Ensure the index gets dropped by data remains by default
-    """
-    for x in range(20):
-        for keep_docs in [[True, {}], [False, {"name": "haveit"}]]:
-            idx = "HaveIt"
-            index = getClient(decoded_r)
-            await index.hset("index:haveit", mapping={"name": "haveit"})
-            idef = IndexDefinition(prefix=["index:"])
-            await index.ft(idx).create_index((TextField("name"),), definition=idef)
-            await waitForIndex(index, idx)
-            await index.ft(idx).dropindex(delete_documents=keep_docs[0])
-            i = await index.hgetall("index:haveit")
-            assert i == keep_docs[1]
-
-
-@pytest.mark.redismod
-async def test_example(decoded_r: redis.Redis):
-    # Creating the index definition and schema
-    await decoded_r.ft().create_index(
-        (TextField("title", weight=5.0), TextField("body"))
-    )
-
-    # Indexing a document
-    await decoded_r.hset(
-        "doc1",
-        mapping={
-            "title": "RediSearch",
-            "body": "Redisearch impements a search engine on top of redis",
-        },
-    )
-
-    # Searching with complex parameters:
-    q = Query("search engine").verbatim().no_content().paging(0, 5)
-
-    res = await decoded_r.ft().search(q)
-    assert res is not None
-
-
-@pytest.mark.redismod
-async def test_auto_complete(decoded_r: redis.Redis):
-    n = 0
-    with open(TITLES_CSV) as f:
-        cr = csv.reader(f)
-
-        for row in cr:
-            n += 1
-            term, score = row[0], float(row[1])
-            assert n == await decoded_r.ft().sugadd("ac", Suggestion(term, score=score))
-
-    assert n == await decoded_r.ft().suglen("ac")
-    ret = await decoded_r.ft().sugget("ac", "bad", with_scores=True)
-    assert 2 == len(ret)
-    assert "badger" == ret[0].string
-    assert isinstance(ret[0].score, float)
-    assert 1.0 != ret[0].score
-    assert "badalte rishtey" == ret[1].string
-    assert isinstance(ret[1].score, float)
-    assert 1.0 != ret[1].score
-
-    ret = await decoded_r.ft().sugget("ac", "bad", fuzzy=True, num=10)
-    assert 10 == len(ret)
-    assert 1.0 == ret[0].score
-    strs = {x.string for x in ret}
-
-    for sug in strs:
-        assert 1 == await decoded_r.ft().sugdel("ac", sug)
-    # make sure a second delete returns 0
-    for sug in strs:
-        assert 0 == await decoded_r.ft().sugdel("ac", sug)
-
-    # make sure they were actually deleted
-    ret2 = await decoded_r.ft().sugget("ac", "bad", fuzzy=True, num=10)
-    for sug in ret2:
-        assert sug.string not in strs
-
-    # Test with payload
-    await decoded_r.ft().sugadd("ac", Suggestion("pay1", payload="pl1"))
-    await decoded_r.ft().sugadd("ac", Suggestion("pay2", payload="pl2"))
-    await decoded_r.ft().sugadd("ac", Suggestion("pay3", payload="pl3"))
-
-    sugs = await decoded_r.ft().sugget(
-        "ac", "pay", with_payloads=True, with_scores=True
-    )
-    assert 3 == len(sugs)
-    for sug in sugs:
-        assert sug.payload
-        assert sug.payload.startswith("pl")
-
-
-@pytest.mark.redismod
-async def test_no_index(decoded_r: redis.Redis):
-    await decoded_r.ft().create_index(
-        (
-            TextField("field"),
-            TextField("text", no_index=True, sortable=True),
-            NumericField("numeric", no_index=True, sortable=True),
-            GeoField("geo", no_index=True, sortable=True),
-            TagField("tag", no_index=True, sortable=True),
-        )
-    )
-
-    await decoded_r.hset(
-        "doc1",
-        mapping={"field": "aaa", "text": "1", "numeric": "1", "geo": "1,1", "tag": "1"},
-    )
-    await decoded_r.hset(
-        "doc2",
-        mapping={"field": "aab", "text": "2", "numeric": "2", "geo": "2,2", "tag": "2"},
-    )
-    await waitForIndex(decoded_r, "idx")
-
-    if is_resp2_connection(decoded_r):
-        res = await decoded_r.ft().search(Query("@text:aa*"))
-        assert 0 == res.total
-
-        res = await decoded_r.ft().search(Query("@field:aa*"))
-        assert 2 == res.total
-
-        res = await decoded_r.ft().search(Query("*").sort_by("text", asc=False))
-        assert 2 == res.total
-        assert "doc2" == res.docs[0].id
-
-        res = await decoded_r.ft().search(Query("*").sort_by("text", asc=True))
-        assert "doc1" == res.docs[0].id
-
-        res = await decoded_r.ft().search(Query("*").sort_by("numeric", asc=True))
-        assert "doc1" == res.docs[0].id
-
-        res = await decoded_r.ft().search(Query("*").sort_by("geo", asc=True))
-        assert "doc1" == res.docs[0].id
-
-        res = await decoded_r.ft().search(Query("*").sort_by("tag", asc=True))
-        assert "doc1" == res.docs[0].id
-    else:
-        res = await decoded_r.ft().search(Query("@text:aa*"))
-        assert 0 == res["total_results"]
-
-        res = await decoded_r.ft().search(Query("@field:aa*"))
-        assert 2 == res["total_results"]
-
-        res = await decoded_r.ft().search(Query("*").sort_by("text", asc=False))
-        assert 2 == res["total_results"]
-        assert "doc2" == res["results"][0]["id"]
-
-        res = await decoded_r.ft().search(Query("*").sort_by("text", asc=True))
-        assert "doc1" == res["results"][0]["id"]
-
-        res = await decoded_r.ft().search(Query("*").sort_by("numeric", asc=True))
-        assert "doc1" == res["results"][0]["id"]
-
-        res = await decoded_r.ft().search(Query("*").sort_by("geo", asc=True))
-        assert "doc1" == res["results"][0]["id"]
-
-        res = await decoded_r.ft().search(Query("*").sort_by("tag", asc=True))
-        assert "doc1" == res["results"][0]["id"]
-
-    # Ensure exception is raised for non-indexable, non-sortable fields
-    with pytest.raises(Exception):
-        TextField("name", no_index=True, sortable=False)
-    with pytest.raises(Exception):
-        NumericField("name", no_index=True, sortable=False)
-    with pytest.raises(Exception):
-        GeoField("name", no_index=True, sortable=False)
-    with pytest.raises(Exception):
-        TagField("name", no_index=True, sortable=False)
-
-
-@pytest.mark.redismod
-@skip_if_server_version_lt("7.4.0")
-@skip_ifmodversion_lt("2.10.0", "search")
-async def test_create_index_empty_or_missing_fields_with_sortable(
-    decoded_r: redis.Redis,
-):
-    definition = IndexDefinition(prefix=["property:"], index_type=IndexType.HASH)
-
-    fields = [
-        TextField("title", sortable=True, index_empty=True),
-        TagField("features", index_missing=True, sortable=True),
-        TextField("description", no_index=True, sortable=True),
-    ]
-
-    await decoded_r.ft().create_index(fields, definition=definition)
-
-
-@pytest.mark.redismod
-async def test_explain(decoded_r: redis.Redis):
-    await decoded_r.ft().create_index(
-        (TextField("f1"), TextField("f2"), TextField("f3"))
-    )
-    res = await decoded_r.ft().explain("@f3:f3_val @f2:f2_val @f1:f1_val")
-    assert res
-
-
-@pytest.mark.redismod
-async def test_explaincli(decoded_r: redis.Redis):
-    with pytest.raises(NotImplementedError):
-        await decoded_r.ft().explain_cli("foo")
-
-
-@pytest.mark.redismod
-async def test_summarize(decoded_r: redis.Redis):
-    await createIndex(decoded_r.ft())
-    await waitForIndex(decoded_r, "idx")
-
-    q = Query('"king henry"').paging(0, 1)
-    q.highlight(fields=("play", "txt"), tags=("<b>", "</b>"))
-    q.summarize("txt")
-
-    if is_resp2_connection(decoded_r):
-        doc = sorted((await decoded_r.ft().search(q)).docs)[0]
-        assert "<b>Henry</b> IV" == doc.play
-        assert (
-            "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
-            == doc.txt
-        )
-
-        q = Query('"king henry"').paging(0, 1).summarize().highlight()
+            except AttributeError:
+                try:
+                    if int(res["indexing"]) == 0:
+                        break
+                except ValueError:
+                    break
+            except ResponseError:
+                # index doesn't exist yet
+                # continue to sleep and try again
+                pass
+
+            await asyncio.sleep(delay)
+            if timeout is not None:
+                timeout -= delay
+                if timeout <= 0:
+                    break
 
-        doc = sorted((await decoded_r.ft().search(q)).docs)[0]
-        assert "<b>Henry</b> ... " == doc.play
-        assert (
-            "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
-            == doc.txt
-        )
-    else:
-        doc = sorted((await decoded_r.ft().search(q))["results"])[0]
-        assert "<b>Henry</b> IV" == doc["extra_attributes"]["play"]
-        assert (
-            "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
-            == doc["extra_attributes"]["txt"]
-        )
+    @staticmethod
+    def getClient(decoded_r: redis.Redis):
+        """
+        Gets a client client attached to an index name which is ready to be
+        created
+        """
+        return decoded_r
 
-        q = Query('"king henry"').paging(0, 1).summarize().highlight()
+    @staticmethod
+    async def createIndex(decoded_r, num_docs=100, definition=None):
+        try:
+            await decoded_r.create_index(
+                (
+                    TextField("play", weight=5.0),
+                    TextField("txt"),
+                    NumericField("chapter"),
+                ),
+                definition=definition,
+            )
+        except redis.ResponseError:
+            await decoded_r.dropindex(delete_documents=True)
+            return await AsyncSearchTestsBase.createIndex(
+                decoded_r, num_docs=num_docs, definition=definition
+            )
 
-        doc = sorted((await decoded_r.ft().search(q))["results"])[0]
-        assert "<b>Henry</b> ... " == doc["extra_attributes"]["play"]
-        assert (
-            "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
-            == doc["extra_attributes"]["txt"]
-        )
+        chapters = {}
+        bzfp = TextIOWrapper(bz2.BZ2File(WILL_PLAY_TEXT), encoding="utf8")
 
+        r = csv.reader(bzfp, delimiter=";")
+        for n, line in enumerate(r):
+            play, chapter, _, text = line[1], line[2], line[4], line[5]
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.0.0", "search")
-async def test_alias(decoded_r: redis.Redis):
-    index1 = getClient(decoded_r)
-    index2 = getClient(decoded_r)
+            key = f"{play}:{chapter}".lower()
+            d = chapters.setdefault(key, {})
+            d["play"] = play
+            d["txt"] = d.get("txt", "") + " " + text
+            d["chapter"] = int(chapter or 0)
+            if len(chapters) == num_docs:
+                break
 
-    def1 = IndexDefinition(prefix=["index1:"])
-    def2 = IndexDefinition(prefix=["index2:"])
+        indexer = decoded_r.batch_indexer(chunk_size=50)
+        assert isinstance(indexer, AsyncSearch.BatchIndexer)
+        assert 50 == indexer.chunk_size
 
-    ftindex1 = index1.ft("testAlias")
-    ftindex2 = index2.ft("testAlias2")
-    await ftindex1.create_index((TextField("name"),), definition=def1)
-    await ftindex2.create_index((TextField("name"),), definition=def2)
+        for key, doc in chapters.items():
+            await indexer.client.client.hset(key, mapping=doc)
+        await indexer.commit()
 
-    await index1.hset("index1:lonestar", mapping={"name": "lonestar"})
-    await index2.hset("index2:yogurt", mapping={"name": "yogurt"})
 
-    if is_resp2_connection(decoded_r):
-        res = (await ftindex1.search("*")).docs[0]
-        assert "index1:lonestar" == res.id
+class TestBaseSearchFunctionality(AsyncSearchTestsBase):
+    @pytest.mark.redismod
+    async def test_client(self, decoded_r: redis.Redis):
+        num_docs = 500
+        await self.createIndex(decoded_r.ft(), num_docs=num_docs)
+        await self.waitForIndex(decoded_r, "idx")
+        # verify info
+        info = await decoded_r.ft().info()
+        for k in [
+            "index_name",
+            "index_options",
+            "attributes",
+            "num_docs",
+            "max_doc_id",
+            "num_terms",
+            "num_records",
+            "inverted_sz_mb",
+            "offset_vectors_sz_mb",
+            "doc_table_size_mb",
+            "key_table_size_mb",
+            "records_per_doc_avg",
+            "bytes_per_record_avg",
+            "offsets_per_term_avg",
+            "offset_bits_per_record_avg",
+        ]:
+            assert k in info
+
+        assert decoded_r.ft().index_name == info["index_name"]
+        assert num_docs == int(info["num_docs"])
+
+        res = await decoded_r.ft().search("henry iv")
+        if is_resp2_connection(decoded_r):
+            assert isinstance(res, Result)
+            assert 225 == res.total
+            assert 10 == len(res.docs)
+            assert res.duration > 0
+
+            for doc in res.docs:
+                assert doc.id
+                assert doc.play == "Henry IV"
+                assert len(doc.txt) > 0
+
+            # test no content
+            res = await decoded_r.ft().search(Query("king").no_content())
+            assert 194 == res.total
+            assert 10 == len(res.docs)
+            for doc in res.docs:
+                assert "txt" not in doc.__dict__
+                assert "play" not in doc.__dict__
+
+            # test verbatim vs no verbatim
+            total = (await decoded_r.ft().search(Query("kings").no_content())).total
+            vtotal = (
+                await decoded_r.ft().search(Query("kings").no_content().verbatim())
+            ).total
+            assert total > vtotal
 
-        # create alias and check for results
-        await ftindex1.aliasadd("spaceballs")
-        alias_client = getClient(decoded_r).ft("spaceballs")
-        res = (await alias_client.search("*")).docs[0]
-        assert "index1:lonestar" == res.id
+            # test in fields
+            txt_total = (
+                await decoded_r.ft().search(
+                    Query("henry").no_content().limit_fields("txt")
+                )
+            ).total
+            play_total = (
+                await decoded_r.ft().search(
+                    Query("henry").no_content().limit_fields("play")
+                )
+            ).total
+            both_total = (
+                await decoded_r.ft().search(
+                    Query("henry").no_content().limit_fields("play", "txt")
+                )
+            ).total
+            assert 129 == txt_total
+            assert 494 == play_total
+            assert 494 == both_total
+
+            # test load_document
+            doc = await decoded_r.ft().load_document("henry vi part 3:62")
+            assert doc is not None
+            assert "henry vi part 3:62" == doc.id
+            assert doc.play == "Henry VI Part 3"
+            assert len(doc.txt) > 0
 
-        # Throw an exception when trying to add an alias that already exists
-        with pytest.raises(Exception):
-            await ftindex2.aliasadd("spaceballs")
+            # test in-keys
+            ids = [x.id for x in (await decoded_r.ft().search(Query("henry"))).docs]
+            assert 10 == len(ids)
+            subset = ids[:5]
+            docs = await decoded_r.ft().search(Query("henry").limit_ids(*subset))
+            assert len(subset) == docs.total
+            ids = [x.id for x in docs.docs]
+            assert set(ids) == set(subset)
+
+            # test slop and in order
+            assert 193 == (await decoded_r.ft().search(Query("henry king"))).total
+            assert (
+                3
+                == (
+                    await decoded_r.ft().search(Query("henry king").slop(0).in_order())
+                ).total
+            )
+            assert (
+                52
+                == (
+                    await decoded_r.ft().search(Query("king henry").slop(0).in_order())
+                ).total
+            )
+            assert (
+                53 == (await decoded_r.ft().search(Query("henry king").slop(0))).total
+            )
+            assert (
+                167
+                == (await decoded_r.ft().search(Query("henry king").slop(100))).total
+            )
 
-        # update alias and ensure new results
-        await ftindex2.aliasupdate("spaceballs")
-        alias_client2 = getClient(decoded_r).ft("spaceballs")
+            # test delete document
+            await decoded_r.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
+            res = await decoded_r.ft().search(Query("death of a salesman"))
+            assert 1 == res.total
 
-        res = (await alias_client2.search("*")).docs[0]
-        assert "index2:yogurt" == res.id
-    else:
-        res = (await ftindex1.search("*"))["results"][0]
-        assert "index1:lonestar" == res["id"]
+            assert 1 == await decoded_r.ft().delete_document("doc-5ghs2")
+            res = await decoded_r.ft().search(Query("death of a salesman"))
+            assert 0 == res.total
+            assert 0 == await decoded_r.ft().delete_document("doc-5ghs2")
 
-        # create alias and check for results
-        await ftindex1.aliasadd("spaceballs")
-        alias_client = getClient(await decoded_r).ft("spaceballs")
-        res = (await alias_client.search("*"))["results"][0]
-        assert "index1:lonestar" == res["id"]
+            await decoded_r.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
+            res = await decoded_r.ft().search(Query("death of a salesman"))
+            assert 1 == res.total
+            await decoded_r.ft().delete_document("doc-5ghs2")
+        else:
+            assert isinstance(res, dict)
+            assert 225 == res["total_results"]
+            assert 10 == len(res["results"])
+
+            for doc in res["results"]:
+                assert doc["id"]
+                assert doc["extra_attributes"]["play"] == "Henry IV"
+                assert len(doc["extra_attributes"]["txt"]) > 0
+
+            # test no content
+            res = await decoded_r.ft().search(Query("king").no_content())
+            assert 194 == res["total_results"]
+            assert 10 == len(res["results"])
+            for doc in res["results"]:
+                assert "extra_attributes" not in doc.keys()
+
+            # test verbatim vs no verbatim
+            total = (await decoded_r.ft().search(Query("kings").no_content()))[
+                "total_results"
+            ]
+            vtotal = (
+                await decoded_r.ft().search(Query("kings").no_content().verbatim())
+            )["total_results"]
+            assert total > vtotal
+
+            # test in fields
+            txt_total = (
+                await decoded_r.ft().search(
+                    Query("henry").no_content().limit_fields("txt")
+                )
+            )["total_results"]
+            play_total = (
+                await decoded_r.ft().search(
+                    Query("henry").no_content().limit_fields("play")
+                )
+            )["total_results"]
+            both_total = (
+                await decoded_r.ft().search(
+                    Query("henry").no_content().limit_fields("play", "txt")
+                )
+            )["total_results"]
+            assert 129 == txt_total
+            assert 494 == play_total
+            assert 494 == both_total
+
+            # test load_document
+            doc = await decoded_r.ft().load_document("henry vi part 3:62")
+            assert doc is not None
+            assert "henry vi part 3:62" == doc.id
+            assert doc.play == "Henry VI Part 3"
+            assert len(doc.txt) > 0
 
-        # Throw an exception when trying to add an alias that already exists
-        with pytest.raises(Exception):
-            await ftindex2.aliasadd("spaceballs")
+            # test in-keys
+            ids = [
+                x["id"]
+                for x in (await decoded_r.ft().search(Query("henry")))["results"]
+            ]
+            assert 10 == len(ids)
+            subset = ids[:5]
+            docs = await decoded_r.ft().search(Query("henry").limit_ids(*subset))
+            assert len(subset) == docs["total_results"]
+            ids = [x["id"] for x in docs["results"]]
+            assert set(ids) == set(subset)
+
+            # test slop and in order
+            assert (
+                193
+                == (await decoded_r.ft().search(Query("henry king")))["total_results"]
+            )
+            assert (
+                3
+                == (
+                    await decoded_r.ft().search(Query("henry king").slop(0).in_order())
+                )["total_results"]
+            )
+            assert (
+                52
+                == (
+                    await decoded_r.ft().search(Query("king henry").slop(0).in_order())
+                )["total_results"]
+            )
+            assert (
+                53
+                == (await decoded_r.ft().search(Query("henry king").slop(0)))[
+                    "total_results"
+                ]
+            )
+            assert (
+                167
+                == (await decoded_r.ft().search(Query("henry king").slop(100)))[
+                    "total_results"
+                ]
+            )
 
-        # update alias and ensure new results
-        await ftindex2.aliasupdate("spaceballs")
-        alias_client2 = getClient(await decoded_r).ft("spaceballs")
+            # test delete document
+            await decoded_r.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
+            res = await decoded_r.ft().search(Query("death of a salesman"))
+            assert 1 == res["total_results"]
 
-        res = (await alias_client2.search("*"))["results"][0]
-        assert "index2:yogurt" == res["id"]
+            assert 1 == await decoded_r.ft().delete_document("doc-5ghs2")
+            res = await decoded_r.ft().search(Query("death of a salesman"))
+            assert 0 == res["total_results"]
+            assert 0 == await decoded_r.ft().delete_document("doc-5ghs2")
 
-    await ftindex2.aliasdel("spaceballs")
-    with pytest.raises(Exception):
-        (await alias_client2.search("*")).docs[0]
+            await decoded_r.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
+            res = await decoded_r.ft().search(Query("death of a salesman"))
+            assert 1 == res["total_results"]
+            await decoded_r.ft().delete_document("doc-5ghs2")
 
+    @pytest.mark.redismod
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_gte("7.9.0")
+    async def test_scores(self, decoded_r: redis.Redis):
+        await decoded_r.ft().create_index((TextField("txt"),))
 
-@pytest.mark.redismod
-@pytest.mark.xfail(strict=False)
-async def test_alias_basic(decoded_r: redis.Redis):
-    # Creating a client with one index
-    client = getClient(decoded_r)
-    await client.flushdb()
-    index1 = getClient(decoded_r).ft("testAlias")
+        await decoded_r.hset("doc1", mapping={"txt": "foo baz"})
+        await decoded_r.hset("doc2", mapping={"txt": "foo bar"})
 
-    await index1.create_index((TextField("txt"),))
-    await index1.client.hset("doc1", mapping={"txt": "text goes here"})
+        q = Query("foo ~bar").with_scores()
+        res = await decoded_r.ft().search(q)
+        if is_resp2_connection(decoded_r):
+            assert 2 == res.total
+            assert "doc2" == res.docs[0].id
+            assert 3.0 == res.docs[0].score
+            assert "doc1" == res.docs[1].id
+        else:
+            assert 2 == res["total_results"]
+            assert "doc2" == res["results"][0]["id"]
+            assert 3.0 == res["results"][0]["score"]
+            assert "doc1" == res["results"][1]["id"]
 
-    index2 = getClient(decoded_r).ft("testAlias2")
-    await index2.create_index((TextField("txt"),))
-    await index2.client.hset("doc2", mapping={"txt": "text goes here"})
+    @pytest.mark.redismod
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("7.9.0")
+    async def test_scores_with_new_default_scorer(self, decoded_r: redis.Redis):
+        await decoded_r.ft().create_index((TextField("txt"),))
 
-    # add the actual alias and check
-    await index1.aliasadd("myalias")
-    alias_client = getClient(decoded_r).ft("myalias")
-    if is_resp2_connection(decoded_r):
-        res = sorted((await alias_client.search("*")).docs, key=lambda x: x.id)
-        assert "doc1" == res[0].id
+        await decoded_r.hset("doc1", mapping={"txt": "foo baz"})
+        await decoded_r.hset("doc2", mapping={"txt": "foo bar"})
 
-        # Throw an exception when trying to add an alias that already exists
-        with pytest.raises(Exception):
-            await index2.aliasadd("myalias")
-
-        # update the alias and ensure we get doc2
-        await index2.aliasupdate("myalias")
-        alias_client2 = getClient(decoded_r).ft("myalias")
-        res = sorted((await alias_client2.search("*")).docs, key=lambda x: x.id)
-        assert "doc1" == res[0].id
-    else:
-        res = sorted((await alias_client.search("*"))["results"], key=lambda x: x["id"])
-        assert "doc1" == res[0]["id"]
-
-        # Throw an exception when trying to add an alias that already exists
-        with pytest.raises(Exception):
-            await index2.aliasadd("myalias")
+        q = Query("foo ~bar").with_scores()
+        res = await decoded_r.ft().search(q)
+        if is_resp2_connection(decoded_r):
+            assert 2 == res.total
+            assert "doc2" == res.docs[0].id
+            assert 0.87 == pytest.approx(res.docs[0].score, 0.01)
+            assert "doc1" == res.docs[1].id
+        else:
+            assert 2 == res["total_results"]
+            assert "doc2" == res["results"][0]["id"]
+            assert 0.87 == pytest.approx(res["results"][0]["score"], 0.01)
+            assert "doc1" == res["results"][1]["id"]
+
+    @pytest.mark.redismod
+    async def test_stopwords(self, decoded_r: redis.Redis):
+        stopwords = ["foo", "bar", "baz"]
+        await decoded_r.ft().create_index((TextField("txt"),), stopwords=stopwords)
+        await decoded_r.hset("doc1", mapping={"txt": "foo bar"})
+        await decoded_r.hset("doc2", mapping={"txt": "hello world"})
+        await self.waitForIndex(decoded_r, "idx")
+
+        q1 = Query("foo bar").no_content()
+        q2 = Query("foo bar hello world").no_content()
+        res1, res2 = await decoded_r.ft().search(q1), await decoded_r.ft().search(q2)
+        if is_resp2_connection(decoded_r):
+            assert 0 == res1.total
+            assert 1 == res2.total
+        else:
+            assert 0 == res1["total_results"]
+            assert 1 == res2["total_results"]
 
-        # update the alias and ensure we get doc2
-        await index2.aliasupdate("myalias")
-        alias_client2 = getClient(client).ft("myalias")
-        res = sorted(
-            (await alias_client2.search("*"))["results"], key=lambda x: x["id"]
+    @pytest.mark.redismod
+    async def test_filters(self, decoded_r: redis.Redis):
+        await decoded_r.ft().create_index(
+            (TextField("txt"), NumericField("num"), GeoField("loc"))
+        )
+        await decoded_r.hset(
+            "doc1", mapping={"txt": "foo bar", "num": 3.141, "loc": "-0.441,51.458"}
+        )
+        await decoded_r.hset(
+            "doc2", mapping={"txt": "foo baz", "num": 2, "loc": "-0.1,51.2"}
         )
-        assert "doc1" == res[0]["id"]
-
-    # delete the alias and expect an error if we try to query again
-    await index2.aliasdel("myalias")
-    with pytest.raises(Exception):
-        _ = (await alias_client2.search("*")).docs[0]
-
 
-@pytest.mark.redismod
-async def test_tags(decoded_r: redis.Redis):
-    await decoded_r.ft().create_index((TextField("txt"), TagField("tags")))
-    tags = "foo,foo bar,hello;world"
-    tags2 = "soba,ramen"
+        await self.waitForIndex(decoded_r, "idx")
+        # Test numerical filter
+        q1 = Query("foo").add_filter(NumericFilter("num", 0, 2)).no_content()
+        q2 = (
+            Query("foo")
+            .add_filter(NumericFilter("num", 2, NumericFilter.INF, minExclusive=True))
+            .no_content()
+        )
+        res1, res2 = await decoded_r.ft().search(q1), await decoded_r.ft().search(q2)
 
-    await decoded_r.hset("doc1", mapping={"txt": "fooz barz", "tags": tags})
-    await decoded_r.hset("doc2", mapping={"txt": "noodles", "tags": tags2})
-    await waitForIndex(decoded_r, "idx")
+        if is_resp2_connection(decoded_r):
+            assert 1 == res1.total
+            assert 1 == res2.total
+            assert "doc2" == res1.docs[0].id
+            assert "doc1" == res2.docs[0].id
+        else:
+            assert 1 == res1["total_results"]
+            assert 1 == res2["total_results"]
+            assert "doc2" == res1["results"][0]["id"]
+            assert "doc1" == res2["results"][0]["id"]
 
-    q = Query("@tags:{foo}")
-    if is_resp2_connection(decoded_r):
-        res = await decoded_r.ft().search(q)
-        assert 1 == res.total
+        # Test geo filter
+        q1 = Query("foo").add_filter(GeoFilter("loc", -0.44, 51.45, 10)).no_content()
+        q2 = Query("foo").add_filter(GeoFilter("loc", -0.44, 51.45, 100)).no_content()
+        res1, res2 = await decoded_r.ft().search(q1), await decoded_r.ft().search(q2)
 
-        q = Query("@tags:{foo bar}")
-        res = await decoded_r.ft().search(q)
-        assert 1 == res.total
+        if is_resp2_connection(decoded_r):
+            assert 1 == res1.total
+            assert 2 == res2.total
+            assert "doc1" == res1.docs[0].id
+
+            # Sort results, after RDB reload order may change
+            res = [res2.docs[0].id, res2.docs[1].id]
+            res.sort()
+            assert ["doc1", "doc2"] == res
+        else:
+            assert 1 == res1["total_results"]
+            assert 2 == res2["total_results"]
+            assert "doc1" == res1["results"][0]["id"]
+
+            # Sort results, after RDB reload order may change
+            res = [res2["results"][0]["id"], res2["results"][1]["id"]]
+            res.sort()
+            assert ["doc1", "doc2"] == res
+
+    @pytest.mark.redismod
+    async def test_sort_by(self, decoded_r: redis.Redis):
+        await decoded_r.ft().create_index(
+            (TextField("txt"), NumericField("num", sortable=True))
+        )
+        await decoded_r.hset("doc1", mapping={"txt": "foo bar", "num": 1})
+        await decoded_r.hset("doc2", mapping={"txt": "foo baz", "num": 2})
+        await decoded_r.hset("doc3", mapping={"txt": "foo qux", "num": 3})
 
-        q = Query("@tags:{foo\\ bar}")
-        res = await decoded_r.ft().search(q)
-        assert 1 == res.total
+        # Test sort
+        q1 = Query("foo").sort_by("num", asc=True).no_content()
+        q2 = Query("foo").sort_by("num", asc=False).no_content()
+        res1, res2 = await decoded_r.ft().search(q1), await decoded_r.ft().search(q2)
 
-        q = Query("@tags:{hello\\;world}")
-        res = await decoded_r.ft().search(q)
-        assert 1 == res.total
+        if is_resp2_connection(decoded_r):
+            assert 3 == res1.total
+            assert "doc1" == res1.docs[0].id
+            assert "doc2" == res1.docs[1].id
+            assert "doc3" == res1.docs[2].id
+            assert 3 == res2.total
+            assert "doc1" == res2.docs[2].id
+            assert "doc2" == res2.docs[1].id
+            assert "doc3" == res2.docs[0].id
+        else:
+            assert 3 == res1["total_results"]
+            assert "doc1" == res1["results"][0]["id"]
+            assert "doc2" == res1["results"][1]["id"]
+            assert "doc3" == res1["results"][2]["id"]
+            assert 3 == res2["total_results"]
+            assert "doc1" == res2["results"][2]["id"]
+            assert "doc2" == res2["results"][1]["id"]
+            assert "doc3" == res2["results"][0]["id"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.0.0", "search")
+    async def test_drop_index(self, decoded_r: redis.Redis):
+        """
+        Ensure the index gets dropped by data remains by default
+        """
+        for x in range(20):
+            for keep_docs in [[True, {}], [False, {"name": "haveit"}]]:
+                idx = "HaveIt"
+                index = self.getClient(decoded_r)
+                await index.hset("index:haveit", mapping={"name": "haveit"})
+                idef = IndexDefinition(prefix=["index:"])
+                await index.ft(idx).create_index((TextField("name"),), definition=idef)
+                await self.waitForIndex(index, idx)
+                await index.ft(idx).dropindex(delete_documents=keep_docs[0])
+                i = await index.hgetall("index:haveit")
+                assert i == keep_docs[1]
+
+    @pytest.mark.redismod
+    async def test_example(self, decoded_r: redis.Redis):
+        # Creating the index definition and schema
+        await decoded_r.ft().create_index(
+            (TextField("title", weight=5.0), TextField("body"))
+        )
 
-        q2 = await decoded_r.ft().tagvals("tags")
-        assert (tags.split(",") + tags2.split(",")).sort() == q2.sort()
-    else:
-        res = await decoded_r.ft().search(q)
-        assert 1 == res["total_results"]
+        # Indexing a document
+        await decoded_r.hset(
+            "doc1",
+            mapping={
+                "title": "RediSearch",
+                "body": "Redisearch impements a search engine on top of redis",
+            },
+        )
 
-        q = Query("@tags:{foo bar}")
-        res = await decoded_r.ft().search(q)
-        assert 1 == res["total_results"]
+        # Searching with complex parameters:
+        q = Query("search engine").verbatim().no_content().paging(0, 5)
 
-        q = Query("@tags:{foo\\ bar}")
         res = await decoded_r.ft().search(q)
-        assert 1 == res["total_results"]
+        assert res is not None
+
+    @pytest.mark.redismod
+    async def test_auto_complete(self, decoded_r: redis.Redis):
+        n = 0
+        with open(TITLES_CSV) as f:
+            cr = csv.reader(f)
+
+            for row in cr:
+                n += 1
+                term, score = row[0], float(row[1])
+                assert n == await decoded_r.ft().sugadd(
+                    "ac", Suggestion(term, score=score)
+                )
 
-        q = Query("@tags:{hello\\;world}")
-        res = await decoded_r.ft().search(q)
-        assert 1 == res["total_results"]
-
-        q2 = await decoded_r.ft().tagvals("tags")
-        assert set(tags.split(",") + tags2.split(",")) == set(q2)
-
-
-@pytest.mark.redismod
-async def test_textfield_sortable_nostem(decoded_r: redis.Redis):
-    # Creating the index definition with sortable and no_stem
-    await decoded_r.ft().create_index((TextField("txt", sortable=True, no_stem=True),))
-
-    # Now get the index info to confirm its contents
-    response = await decoded_r.ft().info()
-    if is_resp2_connection(decoded_r):
-        assert "SORTABLE" in response["attributes"][0]
-        assert "NOSTEM" in response["attributes"][0]
-    else:
-        assert "SORTABLE" in response["attributes"][0]["flags"]
-        assert "NOSTEM" in response["attributes"][0]["flags"]
-
-
-@pytest.mark.redismod
-async def test_alter_schema_add(decoded_r: redis.Redis):
-    # Creating the index definition and schema
-    await decoded_r.ft().create_index(TextField("title"))
-
-    # Using alter to add a field
-    await decoded_r.ft().alter_schema_add(TextField("body"))
-
-    # Indexing a document
-    await decoded_r.hset(
-        "doc1", mapping={"title": "MyTitle", "body": "Some content only in the body"}
-    )
-
-    # Searching with parameter only in the body (the added field)
-    q = Query("only in the body")
-
-    # Ensure we find the result searching on the added body field
-    res = await decoded_r.ft().search(q)
-    if is_resp2_connection(decoded_r):
-        assert 1 == res.total
-    else:
-        assert 1 == res["total_results"]
-
-
-@pytest.mark.redismod
-async def test_spell_check(decoded_r: redis.Redis):
-    await decoded_r.ft().create_index((TextField("f1"), TextField("f2")))
-
-    await decoded_r.hset(
-        "doc1", mapping={"f1": "some valid content", "f2": "this is sample text"}
-    )
-    await decoded_r.hset("doc2", mapping={"f1": "very important", "f2": "lorem ipsum"})
-    await waitForIndex(decoded_r, "idx")
-
-    if is_resp2_connection(decoded_r):
-        # test spellcheck
-        res = await decoded_r.ft().spellcheck("impornant")
-        assert "important" == res["impornant"][0]["suggestion"]
-
-        res = await decoded_r.ft().spellcheck("contnt")
-        assert "content" == res["contnt"][0]["suggestion"]
-
-        # test spellcheck with Levenshtein distance
-        res = await decoded_r.ft().spellcheck("vlis")
-        assert res == {}
-        res = await decoded_r.ft().spellcheck("vlis", distance=2)
-        assert "valid" == res["vlis"][0]["suggestion"]
-
-        # test spellcheck include
-        await decoded_r.ft().dict_add("dict", "lore", "lorem", "lorm")
-        res = await decoded_r.ft().spellcheck("lorm", include="dict")
-        assert len(res["lorm"]) == 3
-        assert (
-            res["lorm"][0]["suggestion"],
-            res["lorm"][1]["suggestion"],
-            res["lorm"][2]["suggestion"],
-        ) == ("lorem", "lore", "lorm")
-        assert (res["lorm"][0]["score"], res["lorm"][1]["score"]) == ("0.5", "0")
-
-        # test spellcheck exclude
-        res = await decoded_r.ft().spellcheck("lorm", exclude="dict")
-        assert res == {}
-    else:
-        # test spellcheck
-        res = await decoded_r.ft().spellcheck("impornant")
-        assert "important" in res["results"]["impornant"][0].keys()
-
-        res = await decoded_r.ft().spellcheck("contnt")
-        assert "content" in res["results"]["contnt"][0].keys()
-
-        # test spellcheck with Levenshtein distance
-        res = await decoded_r.ft().spellcheck("vlis")
-        assert res == {"results": {"vlis": []}}
-        res = await decoded_r.ft().spellcheck("vlis", distance=2)
-        assert "valid" in res["results"]["vlis"][0].keys()
-
-        # test spellcheck include
-        await decoded_r.ft().dict_add("dict", "lore", "lorem", "lorm")
-        res = await decoded_r.ft().spellcheck("lorm", include="dict")
-        assert len(res["results"]["lorm"]) == 3
-        assert "lorem" in res["results"]["lorm"][0].keys()
-        assert "lore" in res["results"]["lorm"][1].keys()
-        assert "lorm" in res["results"]["lorm"][2].keys()
-        assert (
-            res["results"]["lorm"][0]["lorem"],
-            res["results"]["lorm"][1]["lore"],
-        ) == (0.5, 0)
-
-        # test spellcheck exclude
-        res = await decoded_r.ft().spellcheck("lorm", exclude="dict")
-        assert res == {"results": {}}
-
-
-@pytest.mark.redismod
-async def test_dict_operations(decoded_r: redis.Redis):
-    await decoded_r.ft().create_index((TextField("f1"), TextField("f2")))
-    # Add three items
-    res = await decoded_r.ft().dict_add("custom_dict", "item1", "item2", "item3")
-    assert 3 == res
-
-    # Remove one item
-    res = await decoded_r.ft().dict_del("custom_dict", "item2")
-    assert 1 == res
-
-    # Dump dict and inspect content
-    res = await decoded_r.ft().dict_dump("custom_dict")
-    assert res == ["item1", "item3"]
-
-    # Remove rest of the items before reload
-    await decoded_r.ft().dict_del("custom_dict", *res)
-
-
-@pytest.mark.redismod
-async def test_phonetic_matcher(decoded_r: redis.Redis):
-    await decoded_r.ft().create_index((TextField("name"),))
-    await decoded_r.hset("doc1", mapping={"name": "Jon"})
-    await decoded_r.hset("doc2", mapping={"name": "John"})
-
-    res = await decoded_r.ft().search(Query("Jon"))
-    if is_resp2_connection(decoded_r):
-        assert 1 == len(res.docs)
-        assert "Jon" == res.docs[0].name
-    else:
-        assert 1 == res["total_results"]
-        assert "Jon" == res["results"][0]["extra_attributes"]["name"]
-
-    # Drop and create index with phonetic matcher
-    await decoded_r.flushdb()
-
-    await decoded_r.ft().create_index((TextField("name", phonetic_matcher="dm:en"),))
-    await decoded_r.hset("doc1", mapping={"name": "Jon"})
-    await decoded_r.hset("doc2", mapping={"name": "John"})
-
-    res = await decoded_r.ft().search(Query("Jon"))
-    if is_resp2_connection(decoded_r):
-        assert 2 == len(res.docs)
-        assert ["John", "Jon"] == sorted(d.name for d in res.docs)
-    else:
-        assert 2 == res["total_results"]
-        assert ["John", "Jon"] == sorted(
-            d["extra_attributes"]["name"] for d in res["results"]
-        )
-
-
-@pytest.mark.redismod
-@pytest.mark.onlynoncluster
-# NOTE(imalinovskyi): This test contains hardcoded scores valid only for RediSearch 2.8+
-@skip_ifmodversion_lt("2.8.0", "search")
-@skip_if_server_version_gte("7.9.0")
-async def test_scorer(decoded_r: redis.Redis):
-    await decoded_r.ft().create_index((TextField("description"),))
-
-    await decoded_r.hset(
-        "doc1", mapping={"description": "The quick brown fox jumps over the lazy dog"}
-    )
-    await decoded_r.hset(
-        "doc2",
-        mapping={
-            "description": "Quick alice was beginning to get very tired of sitting by her quick sister on the bank, and of having nothing to do."  # noqa
-        },
-    )
-
-    if is_resp2_connection(decoded_r):
-        # default scorer is TFIDF
-        res = await decoded_r.ft().search(Query("quick").with_scores())
-        assert 1.0 == res.docs[0].score
-        res = await decoded_r.ft().search(Query("quick").scorer("TFIDF").with_scores())
-        assert 1.0 == res.docs[0].score
-        res = await decoded_r.ft().search(
-            Query("quick").scorer("TFIDF.DOCNORM").with_scores()
-        )
-        assert 0.14285714285714285 == res.docs[0].score
-        res = await decoded_r.ft().search(Query("quick").scorer("BM25").with_scores())
-        assert 0.22471909420069797 == res.docs[0].score
-        res = await decoded_r.ft().search(Query("quick").scorer("DISMAX").with_scores())
-        assert 2.0 == res.docs[0].score
-        res = await decoded_r.ft().search(
-            Query("quick").scorer("DOCSCORE").with_scores()
-        )
-        assert 1.0 == res.docs[0].score
-        res = await decoded_r.ft().search(
-            Query("quick").scorer("HAMMING").with_scores()
-        )
-        assert 0.0 == res.docs[0].score
-    else:
-        res = await decoded_r.ft().search(Query("quick").with_scores())
-        assert 1.0 == res["results"][0]["score"]
-        res = await decoded_r.ft().search(Query("quick").scorer("TFIDF").with_scores())
-        assert 1.0 == res["results"][0]["score"]
-        res = await decoded_r.ft().search(
-            Query("quick").scorer("TFIDF.DOCNORM").with_scores()
-        )
-        assert 0.14285714285714285 == res["results"][0]["score"]
-        res = await decoded_r.ft().search(Query("quick").scorer("BM25").with_scores())
-        assert 0.22471909420069797 == res["results"][0]["score"]
-        res = await decoded_r.ft().search(Query("quick").scorer("DISMAX").with_scores())
-        assert 2.0 == res["results"][0]["score"]
-        res = await decoded_r.ft().search(
-            Query("quick").scorer("DOCSCORE").with_scores()
-        )
-        assert 1.0 == res["results"][0]["score"]
-        res = await decoded_r.ft().search(
-            Query("quick").scorer("HAMMING").with_scores()
-        )
-        assert 0.0 == res["results"][0]["score"]
-
-
-@pytest.mark.redismod
-@pytest.mark.onlynoncluster
-# NOTE(imalinovskyi): This test contains hardcoded scores valid only for RediSearch 2.8+
-@skip_ifmodversion_lt("2.8.0", "search")
-@skip_if_server_version_lt("7.9.0")
-async def test_scorer_with_new_default_scorer(decoded_r: redis.Redis):
-    await decoded_r.ft().create_index((TextField("description"),))
-
-    await decoded_r.hset(
-        "doc1", mapping={"description": "The quick brown fox jumps over the lazy dog"}
-    )
-    await decoded_r.hset(
-        "doc2",
-        mapping={
-            "description": "Quick alice was beginning to get very tired of sitting by her quick sister on the bank, and of having nothing to do."  # noqa
-        },
-    )
-
-    if is_resp2_connection(decoded_r):
-        # default scorer is BM25STD
-        res = await decoded_r.ft().search(Query("quick").with_scores())
-        assert 0.23 == pytest.approx(res.docs[0].score, 0.05)
-        res = await decoded_r.ft().search(Query("quick").scorer("TFIDF").with_scores())
-        assert 1.0 == res.docs[0].score
-        res = await decoded_r.ft().search(
-            Query("quick").scorer("TFIDF.DOCNORM").with_scores()
+        assert n == await decoded_r.ft().suglen("ac")
+        ret = await decoded_r.ft().sugget("ac", "bad", with_scores=True)
+        assert 2 == len(ret)
+        assert "badger" == ret[0].string
+        assert isinstance(ret[0].score, float)
+        assert 1.0 != ret[0].score
+        assert "badalte rishtey" == ret[1].string
+        assert isinstance(ret[1].score, float)
+        assert 1.0 != ret[1].score
+
+        ret = await decoded_r.ft().sugget("ac", "bad", fuzzy=True, num=10)
+        assert 10 == len(ret)
+        assert 1.0 == ret[0].score
+        strs = {x.string for x in ret}
+
+        for sug in strs:
+            assert 1 == await decoded_r.ft().sugdel("ac", sug)
+        # make sure a second delete returns 0
+        for sug in strs:
+            assert 0 == await decoded_r.ft().sugdel("ac", sug)
+
+        # make sure they were actually deleted
+        ret2 = await decoded_r.ft().sugget("ac", "bad", fuzzy=True, num=10)
+        for sug in ret2:
+            assert sug.string not in strs
+
+        # Test with payload
+        await decoded_r.ft().sugadd("ac", Suggestion("pay1", payload="pl1"))
+        await decoded_r.ft().sugadd("ac", Suggestion("pay2", payload="pl2"))
+        await decoded_r.ft().sugadd("ac", Suggestion("pay3", payload="pl3"))
+
+        sugs = await decoded_r.ft().sugget(
+            "ac", "pay", with_payloads=True, with_scores=True
         )
-        assert 0.14285714285714285 == res.docs[0].score
-        res = await decoded_r.ft().search(Query("quick").scorer("BM25").with_scores())
-        assert 0.22471909420069797 == res.docs[0].score
-        res = await decoded_r.ft().search(Query("quick").scorer("DISMAX").with_scores())
-        assert 2.0 == res.docs[0].score
-        res = await decoded_r.ft().search(
-            Query("quick").scorer("DOCSCORE").with_scores()
+        assert 3 == len(sugs)
+        for sug in sugs:
+            assert sug.payload
+            assert sug.payload.startswith("pl")
+
+    @pytest.mark.redismod
+    async def test_no_index(self, decoded_r: redis.Redis):
+        await decoded_r.ft().create_index(
+            (
+                TextField("field"),
+                TextField("text", no_index=True, sortable=True),
+                NumericField("numeric", no_index=True, sortable=True),
+                GeoField("geo", no_index=True, sortable=True),
+                TagField("tag", no_index=True, sortable=True),
+            )
         )
-        assert 1.0 == res.docs[0].score
-        res = await decoded_r.ft().search(
-            Query("quick").scorer("HAMMING").with_scores()
-        )
-        assert 0.0 == res.docs[0].score
-    else:
-        res = await decoded_r.ft().search(Query("quick").with_scores())
-        assert 0.23 == pytest.approx(res["results"][0]["score"], 0.05)
-        res = await decoded_r.ft().search(Query("quick").scorer("TFIDF").with_scores())
-        assert 1.0 == res["results"][0]["score"]
-        res = await decoded_r.ft().search(
-            Query("quick").scorer("TFIDF.DOCNORM").with_scores()
+
+        await decoded_r.hset(
+            "doc1",
+            mapping={
+                "field": "aaa",
+                "text": "1",
+                "numeric": "1",
+                "geo": "1,1",
+                "tag": "1",
+            },
         )
-        assert 0.14285714285714285 == res["results"][0]["score"]
-        res = await decoded_r.ft().search(Query("quick").scorer("BM25").with_scores())
-        assert 0.22471909420069797 == res["results"][0]["score"]
-        res = await decoded_r.ft().search(Query("quick").scorer("DISMAX").with_scores())
-        assert 2.0 == res["results"][0]["score"]
-        res = await decoded_r.ft().search(
-            Query("quick").scorer("DOCSCORE").with_scores()
+        await decoded_r.hset(
+            "doc2",
+            mapping={
+                "field": "aab",
+                "text": "2",
+                "numeric": "2",
+                "geo": "2,2",
+                "tag": "2",
+            },
         )
-        assert 1.0 == res["results"][0]["score"]
-        res = await decoded_r.ft().search(
-            Query("quick").scorer("HAMMING").with_scores()
-        )
-        assert 0.0 == res["results"][0]["score"]
-
-
-@pytest.mark.redismod
-async def test_get(decoded_r: redis.Redis):
-    await decoded_r.ft().create_index((TextField("f1"), TextField("f2")))
-
-    assert [None] == await decoded_r.ft().get("doc1")
-    assert [None, None] == await decoded_r.ft().get("doc2", "doc1")
-
-    await decoded_r.hset(
-        "doc1", mapping={"f1": "some valid content dd1", "f2": "this is sample text f1"}
-    )
-    await decoded_r.hset(
-        "doc2", mapping={"f1": "some valid content dd2", "f2": "this is sample text f2"}
-    )
-
-    assert [
-        ["f1", "some valid content dd2", "f2", "this is sample text f2"]
-    ] == await decoded_r.ft().get("doc2")
-    assert [
-        ["f1", "some valid content dd1", "f2", "this is sample text f1"],
-        ["f1", "some valid content dd2", "f2", "this is sample text f2"],
-    ] == await decoded_r.ft().get("doc1", "doc2")
-
-
-@pytest.mark.redismod
-@pytest.mark.onlynoncluster
-@skip_ifmodversion_lt("2.2.0", "search")
-@skip_if_server_version_gte("7.9.0")
-async def test_config(decoded_r: redis.Redis):
-    assert await decoded_r.ft().config_set("TIMEOUT", "100")
-    with pytest.raises(redis.ResponseError):
-        await decoded_r.ft().config_set("TIMEOUT", "null")
-    res = await decoded_r.ft().config_get("*")
-    assert "100" == res["TIMEOUT"]
-    res = await decoded_r.ft().config_get("TIMEOUT")
-    assert "100" == res["TIMEOUT"]
-
-
-@pytest.mark.redismod
-@pytest.mark.onlynoncluster
-@skip_if_server_version_lt("7.9.0")
-async def test_config_with_removed_ftconfig(decoded_r: redis.Redis):
-    assert await decoded_r.config_set("timeout", "100")
-    with pytest.raises(redis.ResponseError):
-        await decoded_r.config_set("timeout", "null")
-    res = await decoded_r.config_get("*")
-    assert "100" == res["timeout"]
-    res = await decoded_r.config_get("timeout")
-    assert "100" == res["timeout"]
-
-
-@pytest.mark.redismod
-@pytest.mark.onlynoncluster
-async def test_aggregations_groupby(decoded_r: redis.Redis):
-    # Creating the index definition and schema
-    await decoded_r.ft().create_index(
-        (
-            NumericField("random_num"),
-            TextField("title"),
-            TextField("body"),
-            TextField("parent"),
-        )
-    )
-
-    # Indexing a document
-    await decoded_r.hset(
-        "search",
-        mapping={
-            "title": "RediSearch",
-            "body": "Redisearch impements a search engine on top of redis",
-            "parent": "redis",
-            "random_num": 10,
-        },
-    )
-    await decoded_r.hset(
-        "ai",
-        mapping={
-            "title": "RedisAI",
-            "body": "RedisAI executes Deep Learning/Machine Learning models and managing their data.",  # noqa
-            "parent": "redis",
-            "random_num": 3,
-        },
-    )
-    await decoded_r.hset(
-        "json",
-        mapping={
-            "title": "RedisJson",
-            "body": "RedisJSON implements ECMA-404 The JSON Data Interchange Standard as a native data type.",  # noqa
-            "parent": "redis",
-            "random_num": 8,
-        },
-    )
-
-    for dialect in [1, 2]:
-        if is_resp2_connection(decoded_r):
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.count())
-                .dialect(dialect)
-            )
+        await self.waitForIndex(decoded_r, "idx")
 
-            res = (await decoded_r.ft().aggregate(req)).rows[0]
-            assert res[1] == "redis"
-            assert res[3] == "3"
+        if is_resp2_connection(decoded_r):
+            res = await decoded_r.ft().search(Query("@text:aa*"))
+            assert 0 == res.total
 
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.count_distinct("@title"))
-                .dialect(dialect)
-            )
+            res = await decoded_r.ft().search(Query("@field:aa*"))
+            assert 2 == res.total
 
-            res = (await decoded_r.ft().aggregate(req)).rows[0]
-            assert res[1] == "redis"
-            assert res[3] == "3"
+            res = await decoded_r.ft().search(Query("*").sort_by("text", asc=False))
+            assert 2 == res.total
+            assert "doc2" == res.docs[0].id
 
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.count_distinctish("@title"))
-                .dialect(dialect)
-            )
+            res = await decoded_r.ft().search(Query("*").sort_by("text", asc=True))
+            assert "doc1" == res.docs[0].id
 
-            res = (await decoded_r.ft().aggregate(req)).rows[0]
-            assert res[1] == "redis"
-            assert res[3] == "3"
+            res = await decoded_r.ft().search(Query("*").sort_by("numeric", asc=True))
+            assert "doc1" == res.docs[0].id
 
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.sum("@random_num"))
-                .dialect(dialect)
-            )
+            res = await decoded_r.ft().search(Query("*").sort_by("geo", asc=True))
+            assert "doc1" == res.docs[0].id
 
-            res = (await decoded_r.ft().aggregate(req)).rows[0]
-            assert res[1] == "redis"
-            assert res[3] == "21"  # 10+8+3
+            res = await decoded_r.ft().search(Query("*").sort_by("tag", asc=True))
+            assert "doc1" == res.docs[0].id
+        else:
+            res = await decoded_r.ft().search(Query("@text:aa*"))
+            assert 0 == res["total_results"]
 
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.min("@random_num"))
-                .dialect(dialect)
-            )
+            res = await decoded_r.ft().search(Query("@field:aa*"))
+            assert 2 == res["total_results"]
 
-            res = (await decoded_r.ft().aggregate(req)).rows[0]
-            assert res[1] == "redis"
-            assert res[3] == "3"  # min(10,8,3)
+            res = await decoded_r.ft().search(Query("*").sort_by("text", asc=False))
+            assert 2 == res["total_results"]
+            assert "doc2" == res["results"][0]["id"]
 
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.max("@random_num"))
-                .dialect(dialect)
-            )
+            res = await decoded_r.ft().search(Query("*").sort_by("text", asc=True))
+            assert "doc1" == res["results"][0]["id"]
 
-            res = (await decoded_r.ft().aggregate(req)).rows[0]
-            assert res[1] == "redis"
-            assert res[3] == "10"  # max(10,8,3)
+            res = await decoded_r.ft().search(Query("*").sort_by("numeric", asc=True))
+            assert "doc1" == res["results"][0]["id"]
 
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.avg("@random_num"))
-                .dialect(dialect)
-            )
+            res = await decoded_r.ft().search(Query("*").sort_by("geo", asc=True))
+            assert "doc1" == res["results"][0]["id"]
 
-            res = (await decoded_r.ft().aggregate(req)).rows[0]
-            assert res[1] == "redis"
-            assert res[3] == "7"  # (10+3+8)/3
+            res = await decoded_r.ft().search(Query("*").sort_by("tag", asc=True))
+            assert "doc1" == res["results"][0]["id"]
 
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.stddev("random_num"))
-                .dialect(dialect)
-            )
+        # Ensure exception is raised for non-indexable, non-sortable fields
+        with pytest.raises(Exception):
+            TextField("name", no_index=True, sortable=False)
+        with pytest.raises(Exception):
+            NumericField("name", no_index=True, sortable=False)
+        with pytest.raises(Exception):
+            GeoField("name", no_index=True, sortable=False)
+        with pytest.raises(Exception):
+            TagField("name", no_index=True, sortable=False)
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.4.0")
+    @skip_ifmodversion_lt("2.10.0", "search")
+    async def test_create_index_empty_or_missing_fields_with_sortable(
+        self,
+        decoded_r: redis.Redis,
+    ):
+        definition = IndexDefinition(prefix=["property:"], index_type=IndexType.HASH)
+
+        fields = [
+            TextField("title", sortable=True, index_empty=True),
+            TagField("features", index_missing=True, sortable=True),
+            TextField("description", no_index=True, sortable=True),
+        ]
 
-            res = (await decoded_r.ft().aggregate(req)).rows[0]
-            assert res[1] == "redis"
-            assert res[3] == "3.60555127546"
+        await decoded_r.ft().create_index(fields, definition=definition)
 
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.quantile("@random_num", 0.5))
-                .dialect(dialect)
-            )
+    @pytest.mark.redismod
+    async def test_explain(self, decoded_r: redis.Redis):
+        await decoded_r.ft().create_index(
+            (TextField("f1"), TextField("f2"), TextField("f3"))
+        )
+        res = await decoded_r.ft().explain("@f3:f3_val @f2:f2_val @f1:f1_val")
+        assert res
 
-            res = (await decoded_r.ft().aggregate(req)).rows[0]
-            assert res[1] == "redis"
-            assert res[3] == "8"  # median of 3,8,10
+    @pytest.mark.redismod
+    async def test_explaincli(self, decoded_r: redis.Redis):
+        with pytest.raises(NotImplementedError):
+            await decoded_r.ft().explain_cli("foo")
 
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.tolist("@title"))
-                .dialect(dialect)
-            )
+    @pytest.mark.redismod
+    async def test_summarize(self, decoded_r: redis.Redis):
+        await self.createIndex(decoded_r.ft())
+        await self.waitForIndex(decoded_r, "idx")
 
-            res = (await decoded_r.ft().aggregate(req)).rows[0]
-            assert res[1] == "redis"
-            assert set(res[3]) == {"RediSearch", "RedisAI", "RedisJson"}
+        q = Query('"king henry"').paging(0, 1)
+        q.highlight(fields=("play", "txt"), tags=("<b>", "</b>"))
+        q.summarize("txt")
 
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.first_value("@title").alias("first"))
-                .dialect(dialect)
+        if is_resp2_connection(decoded_r):
+            doc = sorted((await decoded_r.ft().search(q)).docs)[0]
+            assert "<b>Henry</b> IV" == doc.play
+            assert (
+                "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+                == doc.txt
             )
 
-            res = (await decoded_r.ft().aggregate(req)).rows[0]
-            assert res == ["parent", "redis", "first", "RediSearch"]
+            q = Query('"king henry"').paging(0, 1).summarize().highlight()
 
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by(
-                    "@parent", reducers.random_sample("@title", 2).alias("random")
-                )
-                .dialect(dialect)
+            doc = sorted((await decoded_r.ft().search(q)).docs)[0]
+            assert "<b>Henry</b> ... " == doc.play
+            assert (
+                "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+                == doc.txt
             )
-
-            res = (await decoded_r.ft().aggregate(req)).rows[0]
-            assert res[1] == "redis"
-            assert res[2] == "random"
-            assert len(res[3]) == 2
-            assert res[3][0] in ["RediSearch", "RedisAI", "RedisJson"]
         else:
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.count())
-                .dialect(dialect)
-            )
-
-            res = (await decoded_r.ft().aggregate(req))["results"][0]
-            assert res["extra_attributes"]["parent"] == "redis"
-            assert res["extra_attributes"]["__generated_aliascount"] == "3"
-
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.count_distinct("@title"))
-                .dialect(dialect)
-            )
-
-            res = (await decoded_r.ft().aggregate(req))["results"][0]
-            assert res["extra_attributes"]["parent"] == "redis"
+            doc = sorted((await decoded_r.ft().search(q))["results"])[0]
+            assert "<b>Henry</b> IV" == doc["extra_attributes"]["play"]
             assert (
-                res["extra_attributes"]["__generated_aliascount_distincttitle"] == "3"
+                "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+                == doc["extra_attributes"]["txt"]
             )
 
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.count_distinctish("@title"))
-                .dialect(dialect)
-            )
+            q = Query('"king henry"').paging(0, 1).summarize().highlight()
 
-            res = (await decoded_r.ft().aggregate(req))["results"][0]
-            assert res["extra_attributes"]["parent"] == "redis"
+            doc = sorted((await decoded_r.ft().search(q))["results"])[0]
+            assert "<b>Henry</b> ... " == doc["extra_attributes"]["play"]
             assert (
-                res["extra_attributes"]["__generated_aliascount_distinctishtitle"]
-                == "3"
-            )
-
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.sum("@random_num"))
-                .dialect(dialect)
+                "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+                == doc["extra_attributes"]["txt"]
             )
 
-            res = (await decoded_r.ft().aggregate(req))["results"][0]
-            assert res["extra_attributes"]["parent"] == "redis"
-            assert res["extra_attributes"]["__generated_aliassumrandom_num"] == "21"
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.0.0", "search")
+    async def test_alias(self, decoded_r: redis.Redis):
+        index1 = self.getClient(decoded_r)
+        index2 = self.getClient(decoded_r)
 
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.min("@random_num"))
-                .dialect(dialect)
-            )
+        def1 = IndexDefinition(prefix=["index1:"])
+        def2 = IndexDefinition(prefix=["index2:"])
 
-            res = (await decoded_r.ft().aggregate(req))["results"][0]
-            assert res["extra_attributes"]["parent"] == "redis"
-            assert res["extra_attributes"]["__generated_aliasminrandom_num"] == "3"
+        ftindex1 = index1.ft("testAlias")
+        ftindex2 = index2.ft("testAlias2")
+        await ftindex1.create_index((TextField("name"),), definition=def1)
+        await ftindex2.create_index((TextField("name"),), definition=def2)
 
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.max("@random_num"))
-                .dialect(dialect)
-            )
+        await index1.hset("index1:lonestar", mapping={"name": "lonestar"})
+        await index2.hset("index2:yogurt", mapping={"name": "yogurt"})
 
-            res = (await decoded_r.ft().aggregate(req))["results"][0]
-            assert res["extra_attributes"]["parent"] == "redis"
-            assert res["extra_attributes"]["__generated_aliasmaxrandom_num"] == "10"
+        if is_resp2_connection(decoded_r):
+            res = (await ftindex1.search("*")).docs[0]
+            assert "index1:lonestar" == res.id
 
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.avg("@random_num"))
-                .dialect(dialect)
-            )
+            # create alias and check for results
+            await ftindex1.aliasadd("spaceballs")
+            alias_client = self.getClient(decoded_r).ft("spaceballs")
+            res = (await alias_client.search("*")).docs[0]
+            assert "index1:lonestar" == res.id
 
-            res = (await decoded_r.ft().aggregate(req))["results"][0]
-            assert res["extra_attributes"]["parent"] == "redis"
-            assert res["extra_attributes"]["__generated_aliasavgrandom_num"] == "7"
+            # Throw an exception when trying to add an alias that already exists
+            with pytest.raises(Exception):
+                await ftindex2.aliasadd("spaceballs")
 
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.stddev("random_num"))
-                .dialect(dialect)
-            )
+            # update alias and ensure new results
+            await ftindex2.aliasupdate("spaceballs")
+            alias_client2 = self.getClient(decoded_r).ft("spaceballs")
 
-            res = (await decoded_r.ft().aggregate(req))["results"][0]
-            assert res["extra_attributes"]["parent"] == "redis"
-            assert (
-                res["extra_attributes"]["__generated_aliasstddevrandom_num"]
-                == "3.60555127546"
-            )
+            res = (await alias_client2.search("*")).docs[0]
+            assert "index2:yogurt" == res.id
+        else:
+            res = (await ftindex1.search("*"))["results"][0]
+            assert "index1:lonestar" == res["id"]
 
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.quantile("@random_num", 0.5))
-                .dialect(dialect)
-            )
+            # create alias and check for results
+            await ftindex1.aliasadd("spaceballs")
+            alias_client = self.getClient(await decoded_r).ft("spaceballs")
+            res = (await alias_client.search("*"))["results"][0]
+            assert "index1:lonestar" == res["id"]
 
-            res = (await decoded_r.ft().aggregate(req))["results"][0]
-            assert res["extra_attributes"]["parent"] == "redis"
-            assert (
-                res["extra_attributes"]["__generated_aliasquantilerandom_num,0.5"]
-                == "8"
-            )
+            # Throw an exception when trying to add an alias that already exists
+            with pytest.raises(Exception):
+                await ftindex2.aliasadd("spaceballs")
 
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.tolist("@title"))
-                .dialect(dialect)
-            )
+            # update alias and ensure new results
+            await ftindex2.aliasupdate("spaceballs")
+            alias_client2 = self.getClient(await decoded_r).ft("spaceballs")
 
-            res = (await decoded_r.ft().aggregate(req))["results"][0]
-            assert res["extra_attributes"]["parent"] == "redis"
-            assert set(res["extra_attributes"]["__generated_aliastolisttitle"]) == {
-                "RediSearch",
-                "RedisAI",
-                "RedisJson",
-            }
+            res = (await alias_client2.search("*"))["results"][0]
+            assert "index2:yogurt" == res["id"]
 
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by("@parent", reducers.first_value("@title").alias("first"))
-                .dialect(dialect)
+        await ftindex2.aliasdel("spaceballs")
+        with pytest.raises(Exception):
+            (await alias_client2.search("*")).docs[0]
+
+    @pytest.mark.redismod
+    @pytest.mark.xfail(strict=False)
+    async def test_alias_basic(self, decoded_r: redis.Redis):
+        # Creating a client with one index
+        client = self.getClient(decoded_r)
+        await client.flushdb()
+        index1 = self.getClient(decoded_r).ft("testAlias")
+
+        await index1.create_index((TextField("txt"),))
+        await index1.client.hset("doc1", mapping={"txt": "text goes here"})
+
+        index2 = self.getClient(decoded_r).ft("testAlias2")
+        await index2.create_index((TextField("txt"),))
+        await index2.client.hset("doc2", mapping={"txt": "text goes here"})
+
+        # add the actual alias and check
+        await index1.aliasadd("myalias")
+        alias_client = self.getClient(decoded_r).ft("myalias")
+        if is_resp2_connection(decoded_r):
+            res = sorted((await alias_client.search("*")).docs, key=lambda x: x.id)
+            assert "doc1" == res[0].id
+
+            # Throw an exception when trying to add an alias that already exists
+            with pytest.raises(Exception):
+                await index2.aliasadd("myalias")
+
+            # update the alias and ensure we get doc2
+            await index2.aliasupdate("myalias")
+            alias_client2 = self.getClient(decoded_r).ft("myalias")
+            res = sorted((await alias_client2.search("*")).docs, key=lambda x: x.id)
+            assert "doc1" == res[0].id
+        else:
+            res = sorted(
+                (await alias_client.search("*"))["results"], key=lambda x: x["id"]
             )
+            assert "doc1" == res[0]["id"]
 
-            res = (await decoded_r.ft().aggregate(req))["results"][0]
-            assert res["extra_attributes"] == {"parent": "redis", "first": "RediSearch"}
+            # Throw an exception when trying to add an alias that already exists
+            with pytest.raises(Exception):
+                await index2.aliasadd("myalias")
 
-            req = (
-                aggregations.AggregateRequest("redis")
-                .group_by(
-                    "@parent", reducers.random_sample("@title", 2).alias("random")
-                )
-                .dialect(dialect)
+            # update the alias and ensure we get doc2
+            await index2.aliasupdate("myalias")
+            alias_client2 = self.getClient(client).ft("myalias")
+            res = sorted(
+                (await alias_client2.search("*"))["results"], key=lambda x: x["id"]
             )
+            assert "doc1" == res[0]["id"]
 
-            res = (await decoded_r.ft().aggregate(req))["results"][0]
-            assert res["extra_attributes"]["parent"] == "redis"
-            assert "random" in res["extra_attributes"].keys()
-            assert len(res["extra_attributes"]["random"]) == 2
-            assert res["extra_attributes"]["random"][0] in [
-                "RediSearch",
-                "RedisAI",
-                "RedisJson",
-            ]
-
-
-@pytest.mark.redismod
-async def test_aggregations_sort_by_and_limit(decoded_r: redis.Redis):
-    await decoded_r.ft().create_index((TextField("t1"), TextField("t2")))
+        # delete the alias and expect an error if we try to query again
+        await index2.aliasdel("myalias")
+        with pytest.raises(Exception):
+            _ = (await alias_client2.search("*")).docs[0]
 
-    await decoded_r.ft().client.hset("doc1", mapping={"t1": "a", "t2": "b"})
-    await decoded_r.ft().client.hset("doc2", mapping={"t1": "b", "t2": "a"})
+    @pytest.mark.redismod
+    async def test_tags(self, decoded_r: redis.Redis):
+        await decoded_r.ft().create_index((TextField("txt"), TagField("tags")))
+        tags = "foo,foo bar,hello;world"
+        tags2 = "soba,ramen"
 
-    if is_resp2_connection(decoded_r):
-        # test sort_by using SortDirection
-        req = aggregations.AggregateRequest("*").sort_by(
-            aggregations.Asc("@t2"), aggregations.Desc("@t1")
-        )
-        res = await decoded_r.ft().aggregate(req)
-        assert res.rows[0] == ["t2", "a", "t1", "b"]
-        assert res.rows[1] == ["t2", "b", "t1", "a"]
+        await decoded_r.hset("doc1", mapping={"txt": "fooz barz", "tags": tags})
+        await decoded_r.hset("doc2", mapping={"txt": "noodles", "tags": tags2})
+        await self.waitForIndex(decoded_r, "idx")
 
-        # test sort_by without SortDirection
-        req = aggregations.AggregateRequest("*").sort_by("@t1")
-        res = await decoded_r.ft().aggregate(req)
-        assert res.rows[0] == ["t1", "a"]
-        assert res.rows[1] == ["t1", "b"]
+        q = Query("@tags:{foo}")
+        if is_resp2_connection(decoded_r):
+            res = await decoded_r.ft().search(q)
+            assert 1 == res.total
 
-        # test sort_by with max
-        req = aggregations.AggregateRequest("*").sort_by("@t1", max=1)
-        res = await decoded_r.ft().aggregate(req)
-        assert len(res.rows) == 1
+            q = Query("@tags:{foo bar}")
+            res = await decoded_r.ft().search(q)
+            assert 1 == res.total
 
-        # test limit
-        req = aggregations.AggregateRequest("*").sort_by("@t1").limit(1, 1)
-        res = await decoded_r.ft().aggregate(req)
-        assert len(res.rows) == 1
-        assert res.rows[0] == ["t1", "b"]
-    else:
-        # test sort_by using SortDirection
-        req = aggregations.AggregateRequest("*").sort_by(
-            aggregations.Asc("@t2"), aggregations.Desc("@t1")
-        )
-        res = (await decoded_r.ft().aggregate(req))["results"]
-        assert res[0]["extra_attributes"] == {"t2": "a", "t1": "b"}
-        assert res[1]["extra_attributes"] == {"t2": "b", "t1": "a"}
-
-        # test sort_by without SortDirection
-        req = aggregations.AggregateRequest("*").sort_by("@t1")
-        res = (await decoded_r.ft().aggregate(req))["results"]
-        assert res[0]["extra_attributes"] == {"t1": "a"}
-        assert res[1]["extra_attributes"] == {"t1": "b"}
-
-        # test sort_by with max
-        req = aggregations.AggregateRequest("*").sort_by("@t1", max=1)
-        res = await decoded_r.ft().aggregate(req)
-        assert len(res["results"]) == 1
+            q = Query("@tags:{foo\\ bar}")
+            res = await decoded_r.ft().search(q)
+            assert 1 == res.total
 
-        # test limit
-        req = aggregations.AggregateRequest("*").sort_by("@t1").limit(1, 1)
-        res = await decoded_r.ft().aggregate(req)
-        assert len(res["results"]) == 1
-        assert res["results"][0]["extra_attributes"] == {"t1": "b"}
+            q = Query("@tags:{hello\\;world}")
+            res = await decoded_r.ft().search(q)
+            assert 1 == res.total
 
+            q2 = await decoded_r.ft().tagvals("tags")
+            assert (tags.split(",") + tags2.split(",")).sort() == q2.sort()
+        else:
+            res = await decoded_r.ft().search(q)
+            assert 1 == res["total_results"]
 
-@pytest.mark.redismod
-@pytest.mark.experimental
-async def test_withsuffixtrie(decoded_r: redis.Redis):
-    # create index
-    assert await decoded_r.ft().create_index((TextField("txt"),))
-    await waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
-    if is_resp2_connection(decoded_r):
-        info = await decoded_r.ft().info()
-        assert "WITHSUFFIXTRIE" not in info["attributes"][0]
-        assert await decoded_r.ft().dropindex()
+            q = Query("@tags:{foo bar}")
+            res = await decoded_r.ft().search(q)
+            assert 1 == res["total_results"]
 
-        # create withsuffixtrie index (text field)
-        assert await decoded_r.ft().create_index(TextField("t", withsuffixtrie=True))
-        await waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
-        info = await decoded_r.ft().info()
-        assert "WITHSUFFIXTRIE" in info["attributes"][0]
-        assert await decoded_r.ft().dropindex()
+            q = Query("@tags:{foo\\ bar}")
+            res = await decoded_r.ft().search(q)
+            assert 1 == res["total_results"]
 
-        # create withsuffixtrie index (tag field)
-        assert await decoded_r.ft().create_index(TagField("t", withsuffixtrie=True))
-        await waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
-        info = await decoded_r.ft().info()
-        assert "WITHSUFFIXTRIE" in info["attributes"][0]
-    else:
-        info = await decoded_r.ft().info()
-        assert "WITHSUFFIXTRIE" not in info["attributes"][0]["flags"]
-        assert await decoded_r.ft().dropindex()
+            q = Query("@tags:{hello\\;world}")
+            res = await decoded_r.ft().search(q)
+            assert 1 == res["total_results"]
 
-        # create withsuffixtrie index (text fields)
-        assert await decoded_r.ft().create_index(TextField("t", withsuffixtrie=True))
-        await waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
-        info = await decoded_r.ft().info()
-        assert "WITHSUFFIXTRIE" in info["attributes"][0]["flags"]
-        assert await decoded_r.ft().dropindex()
+            q2 = await decoded_r.ft().tagvals("tags")
+            assert set(tags.split(",") + tags2.split(",")) == set(q2)
 
-        # create withsuffixtrie index (tag field)
-        assert await decoded_r.ft().create_index(TagField("t", withsuffixtrie=True))
-        await waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
-        info = await decoded_r.ft().info()
-        assert "WITHSUFFIXTRIE" in info["attributes"][0]["flags"]
-
-
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.10.05", "search")
-async def test_aggregations_add_scores(decoded_r: redis.Redis):
-    assert await decoded_r.ft().create_index(
-        (
-            TextField("name", sortable=True, weight=5.0),
-            NumericField("age", sortable=True),
-        )
-    )
-
-    assert await decoded_r.hset("doc1", mapping={"name": "bar", "age": "25"})
-    assert await decoded_r.hset("doc2", mapping={"name": "foo", "age": "19"})
-
-    req = aggregations.AggregateRequest("*").add_scores()
-    res = await decoded_r.ft().aggregate(req)
-
-    if isinstance(res, dict):
-        assert len(res["results"]) == 2
-        assert res["results"][0]["extra_attributes"] == {"__score": "0.2"}
-        assert res["results"][1]["extra_attributes"] == {"__score": "0.2"}
-    else:
-        assert len(res.rows) == 2
-        assert res.rows[0] == ["__score", "0.2"]
-        assert res.rows[1] == ["__score", "0.2"]
-
-
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.10.05", "search")
-async def test_aggregations_hybrid_scoring(decoded_r: redis.Redis):
-    assert await decoded_r.ft().create_index(
-        (
-            TextField("name", sortable=True, weight=5.0),
-            TextField("description", sortable=True, weight=5.0),
-            VectorField(
-                "vector",
-                "HNSW",
-                {"TYPE": "FLOAT32", "DIM": 2, "DISTANCE_METRIC": "COSINE"},
-            ),
-        )
-    )
-
-    assert await decoded_r.hset(
-        "doc1",
-        mapping={
-            "name": "cat book",
-            "description": "an animal book about cats",
-            "vector": np.array([0.1, 0.2]).astype(np.float32).tobytes(),
-        },
-    )
-    assert await decoded_r.hset(
-        "doc2",
-        mapping={
-            "name": "dog book",
-            "description": "an animal book about dogs",
-            "vector": np.array([0.2, 0.1]).astype(np.float32).tobytes(),
-        },
-    )
-
-    query_string = "(@description:animal)=>[KNN 3 @vector $vec_param AS dist]"
-    req = (
-        aggregations.AggregateRequest(query_string)
-        .scorer("BM25")
-        .add_scores()
-        .apply(hybrid_score="@__score + @dist")
-        .load("*")
-        .dialect(4)
-    )
-
-    res = await decoded_r.ft().aggregate(
-        req,
-        query_params={"vec_param": np.array([0.11, 0.22]).astype(np.float32).tobytes()},
-    )
-
-    if isinstance(res, dict):
-        assert len(res["results"]) == 2
-    else:
-        assert len(res.rows) == 2
-        for row in res.rows:
-            len(row) == 6
-
-
-@pytest.mark.redismod
-@skip_if_redis_enterprise()
-async def test_search_commands_in_pipeline(decoded_r: redis.Redis):
-    p = await decoded_r.ft().pipeline()
-    p.create_index((TextField("txt"),))
-    p.hset("doc1", mapping={"txt": "foo bar"})
-    p.hset("doc2", mapping={"txt": "foo bar"})
-    q = Query("foo bar").with_payloads()
-    await p.search(q)
-    res = await p.execute()
-    if is_resp2_connection(decoded_r):
-        assert res[:3] == ["OK", True, True]
-        assert 2 == res[3][0]
-        assert "doc1" == res[3][1]
-        assert "doc2" == res[3][4]
-        assert res[3][5] is None
-        assert res[3][3] == res[3][6] == ["txt", "foo bar"]
-    else:
-        assert res[:3] == ["OK", True, True]
-        assert 2 == res[3]["total_results"]
-        assert "doc1" == res[3]["results"][0]["id"]
-        assert "doc2" == res[3]["results"][1]["id"]
-        assert res[3]["results"][0]["payload"] is None
-        assert (
-            res[3]["results"][0]["extra_attributes"]
-            == res[3]["results"][1]["extra_attributes"]
-            == {"txt": "foo bar"}
-        )
-
-
-@pytest.mark.redismod
-async def test_query_timeout(decoded_r: redis.Redis):
-    q1 = Query("foo").timeout(5000)
-    assert q1.get_args() == ["foo", "TIMEOUT", 5000, "DIALECT", 2, "LIMIT", 0, 10]
-    q2 = Query("foo").timeout("not_a_number")
-    with pytest.raises(redis.ResponseError):
-        await decoded_r.ft().search(q2)
-
-
-@pytest.mark.redismod
-@skip_if_resp_version(3)
-async def test_binary_and_text_fields(decoded_r: redis.Redis):
-    fake_vec = np.array([0.1, 0.2, 0.3, 0.4], dtype=np.float32)
-
-    index_name = "mixed_index"
-    mixed_data = {"first_name": "🐍python", "vector_emb": fake_vec.tobytes()}
-    await decoded_r.hset(f"{index_name}:1", mapping=mixed_data)
-
-    schema = [
-        TagField("first_name"),
-        VectorField(
-            "embeddings_bio",
-            algorithm="HNSW",
-            attributes={
-                "TYPE": "FLOAT32",
-                "DIM": 4,
-                "DISTANCE_METRIC": "COSINE",
-            },
-        ),
-    ]
-
-    await decoded_r.ft(index_name).create_index(
-        fields=schema,
-        definition=IndexDefinition(
-            prefix=[f"{index_name}:"], index_type=IndexType.HASH
-        ),
-    )
-    await waitForIndex(decoded_r, index_name)
-
-    query = (
-        Query("*")
-        .return_field("vector_emb", decode_field=False)
-        .return_field("first_name")
-    )
-    result = await decoded_r.ft(index_name).search(query=query, query_params={})
-    docs = result.docs
-
-    if len(docs) == 0:
-        hash_content = await decoded_r.hget(f"{index_name}:1", "first_name")
-    assert len(docs) > 0, (
-        f"Returned search results are empty. Result: {result}; Hash: {hash_content}"
-    )
-
-    decoded_vec_from_search_results = np.frombuffer(
-        docs[0]["vector_emb"], dtype=np.float32
-    )
-
-    assert np.array_equal(decoded_vec_from_search_results, fake_vec), (
-        "The vectors are not equal"
-    )
-
-    assert docs[0]["first_name"] == mixed_data["first_name"], (
-        "The text field is not decoded correctly"
-    )
-
-
-# SVS-VAMANA Async Tests
-@pytest.mark.redismod
-@skip_if_server_version_lt("8.1.224")
-async def test_async_svs_vamana_basic_functionality(decoded_r: redis.Redis):
-    await decoded_r.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {"TYPE": "FLOAT32", "DIM": 4, "DISTANCE_METRIC": "L2"},
-            ),
-        )
-    )
-
-    vectors = [
-        [1.0, 2.0, 3.0, 4.0],
-        [2.0, 3.0, 4.0, 5.0],
-        [3.0, 4.0, 5.0, 6.0],
-        [10.0, 11.0, 12.0, 13.0],
-    ]
-
-    for i, vec in enumerate(vectors):
-        await decoded_r.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
-
-    query = "*=>[KNN 3 @v $vec]"
-    q = Query(query).return_field("__v_score").sort_by("__v_score", True)
-    res = await decoded_r.ft().search(
-        q, query_params={"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
-    )
-
-    if is_resp2_connection(decoded_r):
-        assert res.total == 3
-        assert "doc0" == res.docs[0].id
-    else:
-        assert res["total_results"] == 3
-        assert "doc0" == res["results"][0]["id"]
-
-
-@pytest.mark.redismod
-@skip_if_server_version_lt("8.1.224")
-async def test_async_svs_vamana_distance_metrics(decoded_r: redis.Redis):
-    # Test COSINE distance
-    await decoded_r.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {"TYPE": "FLOAT32", "DIM": 3, "DISTANCE_METRIC": "COSINE"},
-            ),
+    @pytest.mark.redismod
+    async def test_textfield_sortable_nostem(self, decoded_r: redis.Redis):
+        # Creating the index definition with sortable and no_stem
+        await decoded_r.ft().create_index(
+            (TextField("txt", sortable=True, no_stem=True),)
         )
-    )
 
-    vectors = [[1.0, 0.0, 0.0], [0.707, 0.707, 0.0], [0.0, 1.0, 0.0], [-1.0, 0.0, 0.0]]
+        # Now get the index info to confirm its contents
+        response = await decoded_r.ft().info()
+        if is_resp2_connection(decoded_r):
+            assert "SORTABLE" in response["attributes"][0]
+            assert "NOSTEM" in response["attributes"][0]
+        else:
+            assert "SORTABLE" in response["attributes"][0]["flags"]
+            assert "NOSTEM" in response["attributes"][0]["flags"]
 
-    for i, vec in enumerate(vectors):
-        await decoded_r.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+    @pytest.mark.redismod
+    async def test_alter_schema_add(self, decoded_r: redis.Redis):
+        # Creating the index definition and schema
+        await decoded_r.ft().create_index(TextField("title"))
 
-    query = Query("*=>[KNN 2 @v $vec as score]").sort_by("score").no_content()
-    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+        # Using alter to add a field
+        await decoded_r.ft().alter_schema_add(TextField("body"))
 
-    res = await decoded_r.ft().search(query, query_params=query_params)
-    if is_resp2_connection(decoded_r):
-        assert res.total == 2
-        assert "doc0" == res.docs[0].id
-    else:
-        assert res["total_results"] == 2
-        assert "doc0" == res["results"][0]["id"]
+        # Indexing a document
+        await decoded_r.hset(
+            "doc1",
+            mapping={"title": "MyTitle", "body": "Some content only in the body"},
+        )
 
+        # Searching with parameter only in the body (the added field)
+        q = Query("only in the body")
 
-@pytest.mark.redismod
-@skip_if_server_version_lt("8.1.224")
-async def test_async_svs_vamana_vector_types(decoded_r: redis.Redis):
-    # Test FLOAT16
-    await decoded_r.ft("idx16").create_index(
-        (
-            VectorField(
-                "v16",
-                "SVS-VAMANA",
-                {"TYPE": "FLOAT16", "DIM": 4, "DISTANCE_METRIC": "L2"},
-            ),
-        )
-    )
+        # Ensure we find the result searching on the added body field
+        res = await decoded_r.ft().search(q)
+        if is_resp2_connection(decoded_r):
+            assert 1 == res.total
+        else:
+            assert 1 == res["total_results"]
 
-    vectors = [[1.5, 2.5, 3.5, 4.5], [2.5, 3.5, 4.5, 5.5], [3.5, 4.5, 5.5, 6.5]]
+    @pytest.mark.redismod
+    async def test_spell_check(self, decoded_r: redis.Redis):
+        await decoded_r.ft().create_index((TextField("f1"), TextField("f2")))
 
-    for i, vec in enumerate(vectors):
         await decoded_r.hset(
-            f"doc16_{i}", "v16", np.array(vec, dtype=np.float16).tobytes()
+            "doc1", mapping={"f1": "some valid content", "f2": "this is sample text"}
         )
+        await decoded_r.hset(
+            "doc2", mapping={"f1": "very important", "f2": "lorem ipsum"}
+        )
+        await self.waitForIndex(decoded_r, "idx")
 
-    query = Query("*=>[KNN 2 @v16 $vec as score]").no_content()
-    query_params = {"vec": np.array(vectors[0], dtype=np.float16).tobytes()}
-
-    res = await decoded_r.ft("idx16").search(query, query_params=query_params)
-    if is_resp2_connection(decoded_r):
-        assert res.total == 2
-        assert "doc16_0" == res.docs[0].id
-    else:
-        assert res["total_results"] == 2
-        assert "doc16_0" == res["results"][0]["id"]
+        if is_resp2_connection(decoded_r):
+            # test spellcheck
+            res = await decoded_r.ft().spellcheck("impornant")
+            assert "important" == res["impornant"][0]["suggestion"]
+
+            res = await decoded_r.ft().spellcheck("contnt")
+            assert "content" == res["contnt"][0]["suggestion"]
+
+            # test spellcheck with Levenshtein distance
+            res = await decoded_r.ft().spellcheck("vlis")
+            assert res == {}
+            res = await decoded_r.ft().spellcheck("vlis", distance=2)
+            assert "valid" == res["vlis"][0]["suggestion"]
+
+            # test spellcheck include
+            await decoded_r.ft().dict_add("dict", "lore", "lorem", "lorm")
+            res = await decoded_r.ft().spellcheck("lorm", include="dict")
+            assert len(res["lorm"]) == 3
+            assert (
+                res["lorm"][0]["suggestion"],
+                res["lorm"][1]["suggestion"],
+                res["lorm"][2]["suggestion"],
+            ) == ("lorem", "lore", "lorm")
+            assert (res["lorm"][0]["score"], res["lorm"][1]["score"]) == ("0.5", "0")
+
+            # test spellcheck exclude
+            res = await decoded_r.ft().spellcheck("lorm", exclude="dict")
+            assert res == {}
+        else:
+            # test spellcheck
+            res = await decoded_r.ft().spellcheck("impornant")
+            assert "important" in res["results"]["impornant"][0].keys()
+
+            res = await decoded_r.ft().spellcheck("contnt")
+            assert "content" in res["results"]["contnt"][0].keys()
+
+            # test spellcheck with Levenshtein distance
+            res = await decoded_r.ft().spellcheck("vlis")
+            assert res == {"results": {"vlis": []}}
+            res = await decoded_r.ft().spellcheck("vlis", distance=2)
+            assert "valid" in res["results"]["vlis"][0].keys()
+
+            # test spellcheck include
+            await decoded_r.ft().dict_add("dict", "lore", "lorem", "lorm")
+            res = await decoded_r.ft().spellcheck("lorm", include="dict")
+            assert len(res["results"]["lorm"]) == 3
+            assert "lorem" in res["results"]["lorm"][0].keys()
+            assert "lore" in res["results"]["lorm"][1].keys()
+            assert "lorm" in res["results"]["lorm"][2].keys()
+            assert (
+                res["results"]["lorm"][0]["lorem"],
+                res["results"]["lorm"][1]["lore"],
+            ) == (0.5, 0)
+
+            # test spellcheck exclude
+            res = await decoded_r.ft().spellcheck("lorm", exclude="dict")
+            assert res == {"results": {}}
+
+    @pytest.mark.redismod
+    async def test_dict_operations(self, decoded_r: redis.Redis):
+        await decoded_r.ft().create_index((TextField("f1"), TextField("f2")))
+        # Add three items
+        res = await decoded_r.ft().dict_add("custom_dict", "item1", "item2", "item3")
+        assert 3 == res
+
+        # Remove one item
+        res = await decoded_r.ft().dict_del("custom_dict", "item2")
+        assert 1 == res
+
+        # Dump dict and inspect content
+        res = await decoded_r.ft().dict_dump("custom_dict")
+        assert res == ["item1", "item3"]
+
+        # Remove rest of the items before reload
+        await decoded_r.ft().dict_del("custom_dict", *res)
+
+    @pytest.mark.redismod
+    async def test_phonetic_matcher(self, decoded_r: redis.Redis):
+        await decoded_r.ft().create_index((TextField("name"),))
+        await decoded_r.hset("doc1", mapping={"name": "Jon"})
+        await decoded_r.hset("doc2", mapping={"name": "John"})
+
+        res = await decoded_r.ft().search(Query("Jon"))
+        if is_resp2_connection(decoded_r):
+            assert 1 == len(res.docs)
+            assert "Jon" == res.docs[0].name
+        else:
+            assert 1 == res["total_results"]
+            assert "Jon" == res["results"][0]["extra_attributes"]["name"]
 
+        # Drop and create index with phonetic matcher
+        await decoded_r.flushdb()
 
-@pytest.mark.redismod
-@skip_if_server_version_lt("8.1.224")
-async def test_async_svs_vamana_compression(decoded_r: redis.Redis):
-    await decoded_r.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {
-                    "TYPE": "FLOAT32",
-                    "DIM": 8,
-                    "DISTANCE_METRIC": "L2",
-                    "COMPRESSION": "LVQ8",
-                    "TRAINING_THRESHOLD": 1024,
-                },
-            ),
+        await decoded_r.ft().create_index(
+            (TextField("name", phonetic_matcher="dm:en"),)
         )
-    )
+        await decoded_r.hset("doc1", mapping={"name": "Jon"})
+        await decoded_r.hset("doc2", mapping={"name": "John"})
 
-    vectors = []
-    for i in range(20):
-        vec = [float(i + j) for j in range(8)]
-        vectors.append(vec)
-        await decoded_r.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+        res = await decoded_r.ft().search(Query("Jon"))
+        if is_resp2_connection(decoded_r):
+            assert 2 == len(res.docs)
+            assert ["John", "Jon"] == sorted(d.name for d in res.docs)
+        else:
+            assert 2 == res["total_results"]
+            assert ["John", "Jon"] == sorted(
+                d["extra_attributes"]["name"] for d in res["results"]
+            )
 
-    query = Query("*=>[KNN 5 @v $vec as score]").no_content()
-    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+    @pytest.mark.redismod
+    async def test_get(self, decoded_r: redis.Redis):
+        await decoded_r.ft().create_index((TextField("f1"), TextField("f2")))
 
-    res = await decoded_r.ft().search(query, query_params=query_params)
-    if is_resp2_connection(decoded_r):
-        assert res.total == 5
-        assert "doc0" == res.docs[0].id
-    else:
-        assert res["total_results"] == 5
-        assert "doc0" == res["results"][0]["id"]
+        assert [None] == await decoded_r.ft().get("doc1")
+        assert [None, None] == await decoded_r.ft().get("doc2", "doc1")
 
+        await decoded_r.hset(
+            "doc1",
+            mapping={"f1": "some valid content dd1", "f2": "this is sample text f1"},
+        )
+        await decoded_r.hset(
+            "doc2",
+            mapping={"f1": "some valid content dd2", "f2": "this is sample text f2"},
+        )
 
-@pytest.mark.redismod
-@skip_if_server_version_lt("8.1.224")
-async def test_async_svs_vamana_build_parameters(decoded_r: redis.Redis):
-    await decoded_r.ft().create_index(
-        (
+        assert [
+            ["f1", "some valid content dd2", "f2", "this is sample text f2"]
+        ] == await decoded_r.ft().get("doc2")
+        assert [
+            ["f1", "some valid content dd1", "f2", "this is sample text f1"],
+            ["f1", "some valid content dd2", "f2", "this is sample text f2"],
+        ] == await decoded_r.ft().get("doc1", "doc2")
+
+    @pytest.mark.redismod
+    async def test_query_timeout(self, decoded_r: redis.Redis):
+        q1 = Query("foo").timeout(5000)
+        assert q1.get_args() == ["foo", "TIMEOUT", 5000, "DIALECT", 2, "LIMIT", 0, 10]
+        q2 = Query("foo").timeout("not_a_number")
+        with pytest.raises(redis.ResponseError):
+            await decoded_r.ft().search(q2)
+
+    @pytest.mark.redismod
+    @skip_if_resp_version(3)
+    async def test_binary_and_text_fields(self, decoded_r: redis.Redis):
+        fake_vec = np.array([0.1, 0.2, 0.3, 0.4], dtype=np.float32)
+
+        index_name = "mixed_index"
+        mixed_data = {"first_name": "🐍python", "vector_emb": fake_vec.tobytes()}
+        await decoded_r.hset(f"{index_name}:1", mapping=mixed_data)
+
+        schema = [
+            TagField("first_name"),
             VectorField(
-                "v",
-                "SVS-VAMANA",
-                {
+                "embeddings_bio",
+                algorithm="HNSW",
+                attributes={
                     "TYPE": "FLOAT32",
-                    "DIM": 6,
+                    "DIM": 4,
                     "DISTANCE_METRIC": "COSINE",
-                    "CONSTRUCTION_WINDOW_SIZE": 300,
-                    "GRAPH_MAX_DEGREE": 64,
-                    "SEARCH_WINDOW_SIZE": 20,
-                    "EPSILON": 0.05,
                 },
             ),
+        ]
+
+        await decoded_r.ft(index_name).create_index(
+            fields=schema,
+            definition=IndexDefinition(
+                prefix=[f"{index_name}:"], index_type=IndexType.HASH
+            ),
         )
-    )
+        await self.waitForIndex(decoded_r, index_name)
 
-    vectors = []
-    for i in range(15):
-        vec = [float(i + j) for j in range(6)]
-        vectors.append(vec)
-        await decoded_r.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+        query = (
+            Query("*")
+            .return_field("vector_emb", decode_field=False)
+            .return_field("first_name")
+        )
+        result = await decoded_r.ft(index_name).search(query=query, query_params={})
+        docs = result.docs
 
-    query = Query("*=>[KNN 3 @v $vec as score]").no_content()
-    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+        if len(docs) == 0:
+            hash_content = await decoded_r.hget(f"{index_name}:1", "first_name")
+        assert len(docs) > 0, (
+            f"Returned search results are empty. Result: {result}; Hash: {hash_content}"
+        )
 
-    res = await decoded_r.ft().search(query, query_params=query_params)
-    if is_resp2_connection(decoded_r):
-        assert res.total == 3
-        assert "doc0" == res.docs[0].id
-    else:
-        assert res["total_results"] == 3
-        assert "doc0" == res["results"][0]["id"]
+        decoded_vec_from_search_results = np.frombuffer(
+            docs[0]["vector_emb"], dtype=np.float32
+        )
+
+        assert np.array_equal(decoded_vec_from_search_results, fake_vec), (
+            "The vectors are not equal"
+        )
+
+        assert docs[0]["first_name"] == mixed_data["first_name"], (
+            "The text field is not decoded correctly"
+        )
+
+
+class TestScorers(AsyncSearchTestsBase):
+    @pytest.mark.redismod
+    @pytest.mark.onlynoncluster
+    # NOTE(imalinovskyi): This test contains hardcoded scores valid only for RediSearch 2.8+
+    @skip_ifmodversion_lt("2.8.0", "search")
+    @skip_if_server_version_gte("7.9.0")
+    async def test_scorer(self, decoded_r: redis.Redis):
+        await decoded_r.ft().create_index((TextField("description"),))
+
+        await decoded_r.hset(
+            "doc1",
+            mapping={"description": "The quick brown fox jumps over the lazy dog"},
+        )
+        await decoded_r.hset(
+            "doc2",
+            mapping={
+                "description": "Quick alice was beginning to get very tired of sitting by her quick sister on the bank, and of having nothing to do."  # noqa
+            },
+        )
+
+        if is_resp2_connection(decoded_r):
+            # default scorer is TFIDF
+            res = await decoded_r.ft().search(Query("quick").with_scores())
+            assert 1.0 == res.docs[0].score
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("TFIDF").with_scores()
+            )
+            assert 1.0 == res.docs[0].score
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("TFIDF.DOCNORM").with_scores()
+            )
+            assert 0.14285714285714285 == res.docs[0].score
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("BM25").with_scores()
+            )
+            assert 0.22471909420069797 == res.docs[0].score
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("DISMAX").with_scores()
+            )
+            assert 2.0 == res.docs[0].score
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("DOCSCORE").with_scores()
+            )
+            assert 1.0 == res.docs[0].score
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("HAMMING").with_scores()
+            )
+            assert 0.0 == res.docs[0].score
+        else:
+            res = await decoded_r.ft().search(Query("quick").with_scores())
+            assert 1.0 == res["results"][0]["score"]
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("TFIDF").with_scores()
+            )
+            assert 1.0 == res["results"][0]["score"]
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("TFIDF.DOCNORM").with_scores()
+            )
+            assert 0.14285714285714285 == res["results"][0]["score"]
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("BM25").with_scores()
+            )
+            assert 0.22471909420069797 == res["results"][0]["score"]
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("DISMAX").with_scores()
+            )
+            assert 2.0 == res["results"][0]["score"]
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("DOCSCORE").with_scores()
+            )
+            assert 1.0 == res["results"][0]["score"]
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("HAMMING").with_scores()
+            )
+            assert 0.0 == res["results"][0]["score"]
+
+    @pytest.mark.redismod
+    @pytest.mark.onlynoncluster
+    # NOTE(imalinovskyi): This test contains hardcoded scores valid only for RediSearch 2.8+
+    @skip_ifmodversion_lt("2.8.0", "search")
+    @skip_if_server_version_lt("7.9.0")
+    async def test_scorer_with_new_default_scorer(self, decoded_r: redis.Redis):
+        await decoded_r.ft().create_index((TextField("description"),))
+
+        await decoded_r.hset(
+            "doc1",
+            mapping={"description": "The quick brown fox jumps over the lazy dog"},
+        )
+        await decoded_r.hset(
+            "doc2",
+            mapping={
+                "description": "Quick alice was beginning to get very tired of sitting by her quick sister on the bank, and of having nothing to do."  # noqa
+            },
+        )
+
+        if is_resp2_connection(decoded_r):
+            # default scorer is BM25STD
+            res = await decoded_r.ft().search(Query("quick").with_scores())
+            assert 0.23 == pytest.approx(res.docs[0].score, 0.05)
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("TFIDF").with_scores()
+            )
+            assert 1.0 == res.docs[0].score
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("TFIDF.DOCNORM").with_scores()
+            )
+            assert 0.14285714285714285 == res.docs[0].score
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("BM25").with_scores()
+            )
+            assert 0.22471909420069797 == res.docs[0].score
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("DISMAX").with_scores()
+            )
+            assert 2.0 == res.docs[0].score
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("DOCSCORE").with_scores()
+            )
+            assert 1.0 == res.docs[0].score
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("HAMMING").with_scores()
+            )
+            assert 0.0 == res.docs[0].score
+        else:
+            res = await decoded_r.ft().search(Query("quick").with_scores())
+            assert 0.23 == pytest.approx(res["results"][0]["score"], 0.05)
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("TFIDF").with_scores()
+            )
+            assert 1.0 == res["results"][0]["score"]
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("TFIDF.DOCNORM").with_scores()
+            )
+            assert 0.14285714285714285 == res["results"][0]["score"]
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("BM25").with_scores()
+            )
+            assert 0.22471909420069797 == res["results"][0]["score"]
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("DISMAX").with_scores()
+            )
+            assert 2.0 == res["results"][0]["score"]
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("DOCSCORE").with_scores()
+            )
+            assert 1.0 == res["results"][0]["score"]
+            res = await decoded_r.ft().search(
+                Query("quick").scorer("HAMMING").with_scores()
+            )
+            assert 0.0 == res["results"][0]["score"]
+
+
+class TestConfig(AsyncSearchTestsBase):
+    @pytest.mark.redismod
+    @pytest.mark.onlynoncluster
+    @skip_ifmodversion_lt("2.2.0", "search")
+    @skip_if_server_version_gte("7.9.0")
+    async def test_config(self, decoded_r: redis.Redis):
+        assert await decoded_r.ft().config_set("TIMEOUT", "100")
+        with pytest.raises(redis.ResponseError):
+            await decoded_r.ft().config_set("TIMEOUT", "null")
+        res = await decoded_r.ft().config_get("*")
+        assert "100" == res["TIMEOUT"]
+        res = await decoded_r.ft().config_get("TIMEOUT")
+        assert "100" == res["TIMEOUT"]
+
+    @pytest.mark.redismod
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("7.9.0")
+    async def test_config_with_removed_ftconfig(self, decoded_r: redis.Redis):
+        assert await decoded_r.config_set("timeout", "100")
+        with pytest.raises(redis.ResponseError):
+            await decoded_r.config_set("timeout", "null")
+        res = await decoded_r.config_get("*")
+        assert "100" == res["timeout"]
+        res = await decoded_r.config_get("timeout")
+        assert "100" == res["timeout"]
+
+
+class TestAggregations(AsyncSearchTestsBase):
+    @pytest.mark.redismod
+    @pytest.mark.onlynoncluster
+    async def test_aggregations_groupby(self, decoded_r: redis.Redis):
+        # Creating the index definition and schema
+        await decoded_r.ft().create_index(
+            (
+                NumericField("random_num"),
+                TextField("title"),
+                TextField("body"),
+                TextField("parent"),
+            )
+        )
+
+        # Indexing a document
+        await decoded_r.hset(
+            "search",
+            mapping={
+                "title": "RediSearch",
+                "body": "Redisearch impements a search engine on top of redis",
+                "parent": "redis",
+                "random_num": 10,
+            },
+        )
+        await decoded_r.hset(
+            "ai",
+            mapping={
+                "title": "RedisAI",
+                "body": "RedisAI executes Deep Learning/Machine Learning models and managing their data.",  # noqa
+                "parent": "redis",
+                "random_num": 3,
+            },
+        )
+        await decoded_r.hset(
+            "json",
+            mapping={
+                "title": "RedisJson",
+                "body": "RedisJSON implements ECMA-404 The JSON Data Interchange Standard as a native data type.",  # noqa
+                "parent": "redis",
+                "random_num": 8,
+            },
+        )
+
+        for dialect in [1, 2]:
+            if is_resp2_connection(decoded_r):
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.count())
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req)).rows[0]
+                assert res[1] == "redis"
+                assert res[3] == "3"
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.count_distinct("@title"))
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req)).rows[0]
+                assert res[1] == "redis"
+                assert res[3] == "3"
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.count_distinctish("@title"))
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req)).rows[0]
+                assert res[1] == "redis"
+                assert res[3] == "3"
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.sum("@random_num"))
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req)).rows[0]
+                assert res[1] == "redis"
+                assert res[3] == "21"  # 10+8+3
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.min("@random_num"))
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req)).rows[0]
+                assert res[1] == "redis"
+                assert res[3] == "3"  # min(10,8,3)
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.max("@random_num"))
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req)).rows[0]
+                assert res[1] == "redis"
+                assert res[3] == "10"  # max(10,8,3)
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.avg("@random_num"))
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req)).rows[0]
+                assert res[1] == "redis"
+                assert res[3] == "7"  # (10+3+8)/3
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.stddev("random_num"))
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req)).rows[0]
+                assert res[1] == "redis"
+                assert res[3] == "3.60555127546"
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.quantile("@random_num", 0.5))
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req)).rows[0]
+                assert res[1] == "redis"
+                assert res[3] == "8"  # median of 3,8,10
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.tolist("@title"))
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req)).rows[0]
+                assert res[1] == "redis"
+                assert set(res[3]) == {"RediSearch", "RedisAI", "RedisJson"}
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.first_value("@title").alias("first"))
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req)).rows[0]
+                assert res == ["parent", "redis", "first", "RediSearch"]
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by(
+                        "@parent", reducers.random_sample("@title", 2).alias("random")
+                    )
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req)).rows[0]
+                assert res[1] == "redis"
+                assert res[2] == "random"
+                assert len(res[3]) == 2
+                assert res[3][0] in ["RediSearch", "RedisAI", "RedisJson"]
+            else:
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.count())
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req))["results"][0]
+                assert res["extra_attributes"]["parent"] == "redis"
+                assert res["extra_attributes"]["__generated_aliascount"] == "3"
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.count_distinct("@title"))
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req))["results"][0]
+                assert res["extra_attributes"]["parent"] == "redis"
+                assert (
+                    res["extra_attributes"]["__generated_aliascount_distincttitle"]
+                    == "3"
+                )
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.count_distinctish("@title"))
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req))["results"][0]
+                assert res["extra_attributes"]["parent"] == "redis"
+                assert (
+                    res["extra_attributes"]["__generated_aliascount_distinctishtitle"]
+                    == "3"
+                )
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.sum("@random_num"))
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req))["results"][0]
+                assert res["extra_attributes"]["parent"] == "redis"
+                assert res["extra_attributes"]["__generated_aliassumrandom_num"] == "21"
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.min("@random_num"))
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req))["results"][0]
+                assert res["extra_attributes"]["parent"] == "redis"
+                assert res["extra_attributes"]["__generated_aliasminrandom_num"] == "3"
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.max("@random_num"))
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req))["results"][0]
+                assert res["extra_attributes"]["parent"] == "redis"
+                assert res["extra_attributes"]["__generated_aliasmaxrandom_num"] == "10"
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.avg("@random_num"))
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req))["results"][0]
+                assert res["extra_attributes"]["parent"] == "redis"
+                assert res["extra_attributes"]["__generated_aliasavgrandom_num"] == "7"
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.stddev("random_num"))
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req))["results"][0]
+                assert res["extra_attributes"]["parent"] == "redis"
+                assert (
+                    res["extra_attributes"]["__generated_aliasstddevrandom_num"]
+                    == "3.60555127546"
+                )
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.quantile("@random_num", 0.5))
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req))["results"][0]
+                assert res["extra_attributes"]["parent"] == "redis"
+                assert (
+                    res["extra_attributes"]["__generated_aliasquantilerandom_num,0.5"]
+                    == "8"
+                )
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.tolist("@title"))
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req))["results"][0]
+                assert res["extra_attributes"]["parent"] == "redis"
+                assert set(res["extra_attributes"]["__generated_aliastolisttitle"]) == {
+                    "RediSearch",
+                    "RedisAI",
+                    "RedisJson",
+                }
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by("@parent", reducers.first_value("@title").alias("first"))
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req))["results"][0]
+                assert res["extra_attributes"] == {
+                    "parent": "redis",
+                    "first": "RediSearch",
+                }
+
+                req = (
+                    aggregations.AggregateRequest("redis")
+                    .group_by(
+                        "@parent", reducers.random_sample("@title", 2).alias("random")
+                    )
+                    .dialect(dialect)
+                )
+
+                res = (await decoded_r.ft().aggregate(req))["results"][0]
+                assert res["extra_attributes"]["parent"] == "redis"
+                assert "random" in res["extra_attributes"].keys()
+                assert len(res["extra_attributes"]["random"]) == 2
+                assert res["extra_attributes"]["random"][0] in [
+                    "RediSearch",
+                    "RedisAI",
+                    "RedisJson",
+                ]
+
+    @pytest.mark.redismod
+    async def test_aggregations_sort_by_and_limit(self, decoded_r: redis.Redis):
+        await decoded_r.ft().create_index((TextField("t1"), TextField("t2")))
+
+        await decoded_r.ft().client.hset("doc1", mapping={"t1": "a", "t2": "b"})
+        await decoded_r.ft().client.hset("doc2", mapping={"t1": "b", "t2": "a"})
+
+        if is_resp2_connection(decoded_r):
+            # test sort_by using SortDirection
+            req = aggregations.AggregateRequest("*").sort_by(
+                aggregations.Asc("@t2"), aggregations.Desc("@t1")
+            )
+            res = await decoded_r.ft().aggregate(req)
+            assert res.rows[0] == ["t2", "a", "t1", "b"]
+            assert res.rows[1] == ["t2", "b", "t1", "a"]
+
+            # test sort_by without SortDirection
+            req = aggregations.AggregateRequest("*").sort_by("@t1")
+            res = await decoded_r.ft().aggregate(req)
+            assert res.rows[0] == ["t1", "a"]
+            assert res.rows[1] == ["t1", "b"]
+
+            # test sort_by with max
+            req = aggregations.AggregateRequest("*").sort_by("@t1", max=1)
+            res = await decoded_r.ft().aggregate(req)
+            assert len(res.rows) == 1
+
+            # test limit
+            req = aggregations.AggregateRequest("*").sort_by("@t1").limit(1, 1)
+            res = await decoded_r.ft().aggregate(req)
+            assert len(res.rows) == 1
+            assert res.rows[0] == ["t1", "b"]
+        else:
+            # test sort_by using SortDirection
+            req = aggregations.AggregateRequest("*").sort_by(
+                aggregations.Asc("@t2"), aggregations.Desc("@t1")
+            )
+            res = (await decoded_r.ft().aggregate(req))["results"]
+            assert res[0]["extra_attributes"] == {"t2": "a", "t1": "b"}
+            assert res[1]["extra_attributes"] == {"t2": "b", "t1": "a"}
+
+            # test sort_by without SortDirection
+            req = aggregations.AggregateRequest("*").sort_by("@t1")
+            res = (await decoded_r.ft().aggregate(req))["results"]
+            assert res[0]["extra_attributes"] == {"t1": "a"}
+            assert res[1]["extra_attributes"] == {"t1": "b"}
+
+            # test sort_by with max
+            req = aggregations.AggregateRequest("*").sort_by("@t1", max=1)
+            res = await decoded_r.ft().aggregate(req)
+            assert len(res["results"]) == 1
+
+            # test limit
+            req = aggregations.AggregateRequest("*").sort_by("@t1").limit(1, 1)
+            res = await decoded_r.ft().aggregate(req)
+            assert len(res["results"]) == 1
+            assert res["results"][0]["extra_attributes"] == {"t1": "b"}
+
+    @pytest.mark.redismod
+    @pytest.mark.experimental
+    async def test_withsuffixtrie(self, decoded_r: redis.Redis):
+        # create index
+        assert await decoded_r.ft().create_index((TextField("txt"),))
+        await self.waitForIndex(decoded_r, getattr(decoded_r.ft(), "index_name", "idx"))
+        if is_resp2_connection(decoded_r):
+            info = await decoded_r.ft().info()
+            assert "WITHSUFFIXTRIE" not in info["attributes"][0]
+            assert await decoded_r.ft().dropindex()
+
+            # create withsuffixtrie index (text field)
+            assert await decoded_r.ft().create_index(
+                TextField("t", withsuffixtrie=True)
+            )
+            await self.waitForIndex(
+                decoded_r, getattr(decoded_r.ft(), "index_name", "idx")
+            )
+            info = await decoded_r.ft().info()
+            assert "WITHSUFFIXTRIE" in info["attributes"][0]
+            assert await decoded_r.ft().dropindex()
+
+            # create withsuffixtrie index (tag field)
+            assert await decoded_r.ft().create_index(TagField("t", withsuffixtrie=True))
+            await self.waitForIndex(
+                decoded_r, getattr(decoded_r.ft(), "index_name", "idx")
+            )
+            info = await decoded_r.ft().info()
+            assert "WITHSUFFIXTRIE" in info["attributes"][0]
+        else:
+            info = await decoded_r.ft().info()
+            assert "WITHSUFFIXTRIE" not in info["attributes"][0]["flags"]
+            assert await decoded_r.ft().dropindex()
+
+            # create withsuffixtrie index (text fields)
+            assert await decoded_r.ft().create_index(
+                TextField("t", withsuffixtrie=True)
+            )
+            await self.waitForIndex(
+                decoded_r, getattr(decoded_r.ft(), "index_name", "idx")
+            )
+            info = await decoded_r.ft().info()
+            assert "WITHSUFFIXTRIE" in info["attributes"][0]["flags"]
+            assert await decoded_r.ft().dropindex()
+
+            # create withsuffixtrie index (tag field)
+            assert await decoded_r.ft().create_index(TagField("t", withsuffixtrie=True))
+            await self.waitForIndex(
+                decoded_r, getattr(decoded_r.ft(), "index_name", "idx")
+            )
+            info = await decoded_r.ft().info()
+            assert "WITHSUFFIXTRIE" in info["attributes"][0]["flags"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.10.05", "search")
+    async def test_aggregations_add_scores(self, decoded_r: redis.Redis):
+        assert await decoded_r.ft().create_index(
+            (
+                TextField("name", sortable=True, weight=5.0),
+                NumericField("age", sortable=True),
+            )
+        )
+
+        assert await decoded_r.hset("doc1", mapping={"name": "bar", "age": "25"})
+        assert await decoded_r.hset("doc2", mapping={"name": "foo", "age": "19"})
+
+        req = aggregations.AggregateRequest("*").add_scores()
+        res = await decoded_r.ft().aggregate(req)
+
+        if isinstance(res, dict):
+            assert len(res["results"]) == 2
+            assert res["results"][0]["extra_attributes"] == {"__score": "0.2"}
+            assert res["results"][1]["extra_attributes"] == {"__score": "0.2"}
+        else:
+            assert len(res.rows) == 2
+            assert res.rows[0] == ["__score", "0.2"]
+            assert res.rows[1] == ["__score", "0.2"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.10.05", "search")
+    async def test_aggregations_hybrid_scoring(self, decoded_r: redis.Redis):
+        assert await decoded_r.ft().create_index(
+            (
+                TextField("name", sortable=True, weight=5.0),
+                TextField("description", sortable=True, weight=5.0),
+                VectorField(
+                    "vector",
+                    "HNSW",
+                    {"TYPE": "FLOAT32", "DIM": 2, "DISTANCE_METRIC": "COSINE"},
+                ),
+            )
+        )
+
+        assert await decoded_r.hset(
+            "doc1",
+            mapping={
+                "name": "cat book",
+                "description": "an animal book about cats",
+                "vector": np.array([0.1, 0.2]).astype(np.float32).tobytes(),
+            },
+        )
+        assert await decoded_r.hset(
+            "doc2",
+            mapping={
+                "name": "dog book",
+                "description": "an animal book about dogs",
+                "vector": np.array([0.2, 0.1]).astype(np.float32).tobytes(),
+            },
+        )
+
+        query_string = "(@description:animal)=>[KNN 3 @vector $vec_param AS dist]"
+        req = (
+            aggregations.AggregateRequest(query_string)
+            .scorer("BM25")
+            .add_scores()
+            .apply(hybrid_score="@__score + @dist")
+            .load("*")
+            .dialect(4)
+        )
+
+        res = await decoded_r.ft().aggregate(
+            req,
+            query_params={
+                "vec_param": np.array([0.11, 0.22]).astype(np.float32).tobytes()
+            },
+        )
+
+        if isinstance(res, dict):
+            assert len(res["results"]) == 2
+        else:
+            assert len(res.rows) == 2
+            for row in res.rows:
+                len(row) == 6
+
+
+class TestPipeline(AsyncSearchTestsBase):
+    @pytest.mark.redismod
+    @skip_if_redis_enterprise()
+    async def test_search_commands_in_pipeline(self, decoded_r: redis.Redis):
+        p = await decoded_r.ft().pipeline()
+        p.create_index((TextField("txt"),))
+        p.hset("doc1", mapping={"txt": "foo bar"})
+        p.hset("doc2", mapping={"txt": "foo bar"})
+        q = Query("foo bar").with_payloads()
+        await p.search(q)
+        res = await p.execute()
+        if is_resp2_connection(decoded_r):
+            assert res[:3] == ["OK", True, True]
+            assert 2 == res[3][0]
+            assert "doc1" == res[3][1]
+            assert "doc2" == res[3][4]
+            assert res[3][5] is None
+            assert res[3][3] == res[3][6] == ["txt", "foo bar"]
+        else:
+            assert res[:3] == ["OK", True, True]
+            assert 2 == res[3]["total_results"]
+            assert "doc1" == res[3]["results"][0]["id"]
+            assert "doc2" == res[3]["results"][1]["id"]
+            assert res[3]["results"][0]["payload"] is None
+            assert (
+                res[3]["results"][0]["extra_attributes"]
+                == res[3]["results"][1]["extra_attributes"]
+                == {"txt": "foo bar"}
+            )
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    async def test_hybrid_search_query_with_pipeline(self, decoded_r: redis.Redis):
+        p = decoded_r.ft().pipeline()
+        p.create_index(
+            (
+                TextField("txt"),
+                VectorField(
+                    "embedding",
+                    "FLAT",
+                    {"TYPE": "FLOAT32", "DIM": 4, "DISTANCE_METRIC": "L2"},
+                ),
+            )
+        )
+
+        p.hset(
+            "doc1",
+            mapping={
+                "txt": "foo bar",
+                "embedding": np.array([1, 2, 3, 4], dtype=np.float32).tobytes(),
+            },
+        )
+        p.hset(
+            "doc2",
+            mapping={
+                "txt": "foo bar",
+                "embedding": np.array([1, 2, 2, 3], dtype=np.float32).tobytes(),
+            },
+        )
+
+        # set search query
+        search_query = HybridSearchQuery("foo")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([2, 2, 3, 3], dtype=np.float32).tobytes(),
+        )
+
+        hybrid_query = HybridQuery(search_query, vsim_query)
+
+        await p.hybrid_search(query=hybrid_query)
+        res = await p.execute()
+
+        # the default results count limit is 10
+        assert res[:3] == ["OK", 2, 2]
+        hybrid_search_res = res[3]
+        if is_resp2_connection(decoded_r):
+            # it doesn't get parsed to object in pipeline
+            assert hybrid_search_res[0] == "total_results"
+            assert hybrid_search_res[1] == 2
+            assert hybrid_search_res[2] == "results"
+            assert len(hybrid_search_res[3]) == 2
+            assert hybrid_search_res[4] == "warnings"
+            assert hybrid_search_res[5] == []
+            assert hybrid_search_res[6] == "execution_time"
+            assert float(hybrid_search_res[7]) > 0
+        else:
+            assert hybrid_search_res["total_results"] == 2
+            assert len(hybrid_search_res["results"]) == 2
+            assert hybrid_search_res["warnings"] == []
+            assert hybrid_search_res["execution_time"] > 0
+
+
+class TestSearchWithVamana(AsyncSearchTestsBase):
+    # SVS-VAMANA Async Tests
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.1.224")
+    async def test_async_svs_vamana_basic_functionality(self, decoded_r: redis.Redis):
+        await decoded_r.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {"TYPE": "FLOAT32", "DIM": 4, "DISTANCE_METRIC": "L2"},
+                ),
+            )
+        )
+
+        vectors = [
+            [1.0, 2.0, 3.0, 4.0],
+            [2.0, 3.0, 4.0, 5.0],
+            [3.0, 4.0, 5.0, 6.0],
+            [10.0, 11.0, 12.0, 13.0],
+        ]
+
+        for i, vec in enumerate(vectors):
+            await decoded_r.hset(
+                f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes()
+            )
+
+        query = "*=>[KNN 3 @v $vec]"
+        q = Query(query).return_field("__v_score").sort_by("__v_score", True)
+        res = await decoded_r.ft().search(
+            q, query_params={"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+        )
+
+        if is_resp2_connection(decoded_r):
+            assert res.total == 3
+            assert "doc0" == res.docs[0].id
+        else:
+            assert res["total_results"] == 3
+            assert "doc0" == res["results"][0]["id"]
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.1.224")
+    async def test_async_svs_vamana_distance_metrics(self, decoded_r: redis.Redis):
+        # Test COSINE distance
+        await decoded_r.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {"TYPE": "FLOAT32", "DIM": 3, "DISTANCE_METRIC": "COSINE"},
+                ),
+            )
+        )
+
+        vectors = [
+            [1.0, 0.0, 0.0],
+            [0.707, 0.707, 0.0],
+            [0.0, 1.0, 0.0],
+            [-1.0, 0.0, 0.0],
+        ]
+
+        for i, vec in enumerate(vectors):
+            await decoded_r.hset(
+                f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes()
+            )
+
+        query = Query("*=>[KNN 2 @v $vec as score]").sort_by("score").no_content()
+        query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+        res = await decoded_r.ft().search(query, query_params=query_params)
+        if is_resp2_connection(decoded_r):
+            assert res.total == 2
+            assert "doc0" == res.docs[0].id
+        else:
+            assert res["total_results"] == 2
+            assert "doc0" == res["results"][0]["id"]
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.1.224")
+    async def test_async_svs_vamana_vector_types(self, decoded_r: redis.Redis):
+        # Test FLOAT16
+        await decoded_r.ft("idx16").create_index(
+            (
+                VectorField(
+                    "v16",
+                    "SVS-VAMANA",
+                    {"TYPE": "FLOAT16", "DIM": 4, "DISTANCE_METRIC": "L2"},
+                ),
+            )
+        )
+
+        vectors = [[1.5, 2.5, 3.5, 4.5], [2.5, 3.5, 4.5, 5.5], [3.5, 4.5, 5.5, 6.5]]
+
+        for i, vec in enumerate(vectors):
+            await decoded_r.hset(
+                f"doc16_{i}", "v16", np.array(vec, dtype=np.float16).tobytes()
+            )
+
+        query = Query("*=>[KNN 2 @v16 $vec as score]").no_content()
+        query_params = {"vec": np.array(vectors[0], dtype=np.float16).tobytes()}
+
+        res = await decoded_r.ft("idx16").search(query, query_params=query_params)
+        if is_resp2_connection(decoded_r):
+            assert res.total == 2
+            assert "doc16_0" == res.docs[0].id
+        else:
+            assert res["total_results"] == 2
+            assert "doc16_0" == res["results"][0]["id"]
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.1.224")
+    async def test_async_svs_vamana_compression(self, decoded_r: redis.Redis):
+        await decoded_r.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {
+                        "TYPE": "FLOAT32",
+                        "DIM": 8,
+                        "DISTANCE_METRIC": "L2",
+                        "COMPRESSION": "LVQ8",
+                        "TRAINING_THRESHOLD": 1024,
+                    },
+                ),
+            )
+        )
+
+        vectors = []
+        for i in range(20):
+            vec = [float(i + j) for j in range(8)]
+            vectors.append(vec)
+            await decoded_r.hset(
+                f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes()
+            )
+
+        query = Query("*=>[KNN 5 @v $vec as score]").no_content()
+        query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+        res = await decoded_r.ft().search(query, query_params=query_params)
+        if is_resp2_connection(decoded_r):
+            assert res.total == 5
+            assert "doc0" == res.docs[0].id
+        else:
+            assert res["total_results"] == 5
+            assert "doc0" == res["results"][0]["id"]
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.1.224")
+    async def test_async_svs_vamana_build_parameters(self, decoded_r: redis.Redis):
+        await decoded_r.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {
+                        "TYPE": "FLOAT32",
+                        "DIM": 6,
+                        "DISTANCE_METRIC": "COSINE",
+                        "CONSTRUCTION_WINDOW_SIZE": 300,
+                        "GRAPH_MAX_DEGREE": 64,
+                        "SEARCH_WINDOW_SIZE": 20,
+                        "EPSILON": 0.05,
+                    },
+                ),
+            )
+        )
+
+        vectors = []
+        for i in range(15):
+            vec = [float(i + j) for j in range(6)]
+            vectors.append(vec)
+            await decoded_r.hset(
+                f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes()
+            )
+
+        query = Query("*=>[KNN 3 @v $vec as score]").no_content()
+        query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+        res = await decoded_r.ft().search(query, query_params=query_params)
+        if is_resp2_connection(decoded_r):
+            assert res.total == 3
+            assert "doc0" == res.docs[0].id
+        else:
+            assert res["total_results"] == 3
+            assert "doc0" == res["results"][0]["id"]
+
+
+class TestHybridSearch(AsyncSearchTestsBase):
+    async def _create_hybrid_search_index(self, decoded_r: redis.Redis, dim=4):
+        await decoded_r.ft().create_index(
+            (
+                TextField("description"),
+                NumericField("price"),
+                TagField("color"),
+                TagField("item_type"),
+                NumericField("size"),
+                VectorField(
+                    "embedding",
+                    "FLAT",
+                    {
+                        "TYPE": "FLOAT32",
+                        "DIM": dim,
+                        "DISTANCE_METRIC": "L2",
+                    },
+                ),
+                VectorField(
+                    "embedding-hnsw",
+                    "HNSW",
+                    {
+                        "TYPE": "FLOAT32",
+                        "DIM": dim,
+                        "DISTANCE_METRIC": "L2",
+                    },
+                ),
+            ),
+            definition=IndexDefinition(prefix=["item:"]),
+        )
+        await AsyncSearchTestsBase.waitForIndex(decoded_r, "idx")
+
+    @staticmethod
+    def _generate_random_vector(dim):
+        return [random.random() for _ in range(dim)]
+
+    @staticmethod
+    def _generate_random_str_data(dim):
+        chars = "abcdefgh12345678"
+        return "".join(random.choice(chars) for _ in range(dim))
+
+    @staticmethod
+    async def _add_data_for_hybrid_search(
+        client: redis.Redis,
+        items_sets=1,
+        randomize_data=False,
+        dim_for_random_data=4,
+        use_random_str_data=False,
+    ):
+        if randomize_data or use_random_str_data:
+            generate_data_func = (
+                TestHybridSearch._generate_random_str_data
+                if use_random_str_data
+                else TestHybridSearch._generate_random_vector
+            )
+
+            dim_for_random_data = (
+                dim_for_random_data * 4 if use_random_str_data else dim_for_random_data
+            )
+
+            items = [
+                (generate_data_func(dim_for_random_data), "red shoes"),
+                (generate_data_func(dim_for_random_data), "green shoes with red laces"),
+                (generate_data_func(dim_for_random_data), "red dress"),
+                (generate_data_func(dim_for_random_data), "orange dress"),
+                (generate_data_func(dim_for_random_data), "black shoes"),
+            ]
+        else:
+            items = [
+                ([1.0, 2.0, 7.0, 8.0], "red shoes"),
+                ([1.0, 4.0, 7.0, 8.0], "green shoes with red laces"),
+                ([1.0, 2.0, 6.0, 5.0], "red dress"),
+                ([2.0, 3.0, 6.0, 5.0], "orange dress"),
+                ([5.0, 6.0, 7.0, 8.0], "black shoes"),
+            ]
+        items = items * items_sets
+        pipeline = client.pipeline()
+        for i, vec in enumerate(items):
+            vec, description = vec
+            mapping = {
+                "description": description,
+                "embedding": np.array(vec, dtype=np.float32).tobytes()
+                if not use_random_str_data
+                else vec,
+                "embedding-hnsw": np.array(vec, dtype=np.float32).tobytes()
+                if not use_random_str_data
+                else vec,
+                "price": 15 + i % 4,
+                "color": description.split(" ")[0],
+                "item_type": description.split(" ")[1],
+                "size": 10 + i % 3,
+            }
+            pipeline.hset(f"item:{i}", mapping=mapping)
+        await pipeline.execute()  # Execute all at once
+
+    @staticmethod
+    def _convert_dict_values_to_str(list_of_dicts):
+        res = []
+        for d in list_of_dicts:
+            res_dict = {}
+            for k, v in d.items():
+                if isinstance(v, list):
+                    res_dict[k] = [safe_str(x) for x in v]
+                else:
+                    res_dict[k] = safe_str(v)
+            res.append(res_dict)
+        return res
+
+    @staticmethod
+    def compare_list_of_dicts(actual, expected):
+        assert len(actual) == len(expected), (
+            f"List of dicts length mismatch: {len(actual)} != {len(expected)}. "
+            f"Full dicts: actual:{actual}; expected:{expected}"
+        )
+        for expected_dict_item in expected:
+            found = False
+            for actual_dict_item in actual:
+                if actual_dict_item == expected_dict_item:
+                    found = True
+                    break
+            if not found:
+                assert False, (
+                    f"Dict {expected_dict_item} not found in actual list of dicts: {actual}. "
+                    f"All expected:{expected}"
+                )
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    async def test_basic_hybrid_search(self, decoded_r):
+        # Create index and add data
+        await self._create_hybrid_search_index(decoded_r)
+        await self._add_data_for_hybrid_search(decoded_r, items_sets=5)
+
+        # set search query
+        search_query = HybridSearchQuery("@color:{red} @color:{green}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([-100, -200, -200, -300], dtype=np.float32).tobytes(),
+        )
+
+        hybrid_query = HybridQuery(search_query, vsim_query)
+
+        res = await decoded_r.ft().hybrid_search(query=hybrid_query)
+
+        # the default results count limit is 10
+        if is_resp2_connection(decoded_r):
+            assert res.total_results == 10
+            assert len(res.results) == 10
+            assert res.warnings == []
+            assert res.execution_time > 0
+            assert all(isinstance(res.results[i]["__score"], bytes) for i in range(10))
+            assert all(isinstance(res.results[i]["__key"], bytes) for i in range(10))
+        else:
+            assert res["total_results"] == 10
+            assert len(res["results"]) == 10
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+            assert all(isinstance(res["results"][i]["__score"], str) for i in range(10))
+            assert all(isinstance(res["results"][i]["__key"], str) for i in range(10))
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    async def test_hybrid_search_query_with_scorer(self, decoded_r):
+        # Create index and add data
+        await self._create_hybrid_search_index(decoded_r)
+        await self._add_data_for_hybrid_search(decoded_r, items_sets=10)
+
+        # set search query
+        search_query = HybridSearchQuery("shoes")
+        search_query.scorer("TFIDF")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 2, 3], dtype=np.float32).tobytes(),
+        )
+
+        hybrid_query = HybridQuery(search_query, vsim_query)
+
+        combine_method = CombineResultsMethod(
+            CombinationMethods.LINEAR, ALPHA=1, BETA=0
+        )
+
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.load(
+            "@description", "@color", "@price", "@size", "@__score", "@__item"
+        )
+        postprocessing_config.limit(0, 2)
+
+        res = await decoded_r.ft().hybrid_search(
+            query=hybrid_query,
+            combine_method=combine_method,
+            post_processing=postprocessing_config,
+            timeout=10,
+        )
+
+        expected_results_tfidf = [
+            {
+                "description": b"red shoes",
+                "color": b"red",
+                "price": b"15",
+                "size": b"10",
+                "__score": b"2",
+            },
+            {
+                "description": b"green shoes with red laces",
+                "color": b"green",
+                "price": b"16",
+                "size": b"11",
+                "__score": b"2",
+            },
+        ]
+
+        if is_resp2_connection(decoded_r):
+            assert res.total_results >= 2
+            assert len(res.results) == 2
+            assert res.results == expected_results_tfidf
+            assert res.warnings == []
+        else:
+            assert res["total_results"] >= 2
+            assert len(res["results"]) == 2
+            assert res["results"] == self._convert_dict_values_to_str(
+                expected_results_tfidf
+            )
+            assert res["warnings"] == []
+
+        search_query.scorer("BM25")
+        res = await decoded_r.ft().hybrid_search(
+            query=hybrid_query,
+            combine_method=combine_method,
+            post_processing=postprocessing_config,
+            timeout=10,
+        )
+        expected_results_bm25 = [
+            {
+                "description": b"red shoes",
+                "color": b"red",
+                "price": b"15",
+                "size": b"10",
+                "__score": b"0.657894719299",
+            },
+            {
+                "description": b"green shoes with red laces",
+                "color": b"green",
+                "price": b"16",
+                "size": b"11",
+                "__score": b"0.657894719299",
+            },
+        ]
+        if is_resp2_connection(decoded_r):
+            assert res.total_results >= 2
+            assert len(res.results) == 2
+            assert res.results == expected_results_bm25
+            assert res.warnings == []
+        else:
+            assert res["total_results"] >= 2
+            assert len(res["results"]) == 2
+            assert res["results"] == self._convert_dict_values_to_str(
+                expected_results_bm25
+            )
+            assert res["warnings"] == []
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    async def test_hybrid_search_query_with_vsim_filter(self, decoded_r):
+        # Create index and add data
+        await self._create_hybrid_search_index(decoded_r)
+        await self._add_data_for_hybrid_search(
+            decoded_r, items_sets=5, use_random_str_data=True
+        )
+
+        search_query = HybridSearchQuery("@color:{missing}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data="abcd1234efgh5678",
+        )
+        vsim_query.filter(HybridFilter("@price:[15 16] @size:[10 11]"))
+
+        hybrid_query = HybridQuery(search_query, vsim_query)
+
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.load("@price", "@size")
+
+        res = await decoded_r.ft().hybrid_search(
+            query=hybrid_query, post_processing=postprocessing_config, timeout=10
+        )
+        if is_resp2_connection(decoded_r):
+            assert len(res.results) > 0
+            assert res.warnings == []
+            for item in res.results:
+                assert item["price"] in [b"15", b"16"]
+                assert item["size"] in [b"10", b"11"]
+        else:
+            assert len(res["results"]) > 0
+            assert res["warnings"] == []
+            for item in res["results"]:
+                assert item["price"] in ["15", "16"]
+                assert item["size"] in ["10", "11"]
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    async def test_hybrid_search_query_with_vsim_knn(self, decoded_r):
+        # Create index and add data
+        await self._create_hybrid_search_index(decoded_r)
+        await self._add_data_for_hybrid_search(decoded_r, items_sets=10)
+
+        # set search query
+        # this query won't have results, so we will be able to validate vsim results
+        search_query = HybridSearchQuery("@color:{none}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 2, 3], dtype=np.float32).tobytes(),
+        )
+
+        vsim_query.vsim_method_params(VectorSearchMethods.KNN, K=3)
+
+        hybrid_query = HybridQuery(search_query, vsim_query)
+
+        postprocessing_config = HybridPostProcessingConfig()
+
+        res = await decoded_r.ft().hybrid_search(
+            query=hybrid_query, post_processing=postprocessing_config, timeout=10
+        )
+        expected_results = [
+            {"__key": b"item:2", "__score": b"0.016393442623"},
+            {"__key": b"item:7", "__score": b"0.0161290322581"},
+            {"__key": b"item:12", "__score": b"0.015873015873"},
+        ]
+        if is_resp2_connection(decoded_r):
+            assert res.total_results == 3  # KNN top-k value
+            assert len(res.results) == 3
+            assert res.results == expected_results
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert res["total_results"] == 3  # KNN top-k value
+            assert len(res["results"]) == 3
+            assert res["results"] == self._convert_dict_values_to_str(expected_results)
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+        vsim_query_with_hnsw = HybridVsimQuery(
+            vector_field_name="@embedding-hnsw",
+            vector_data=np.array([1, 2, 2, 3], dtype=np.float32).tobytes(),
+        )
+        vsim_query_with_hnsw.vsim_method_params(
+            VectorSearchMethods.KNN, K=3, EF_RUNTIME=1
+        )
+        hybrid_query_with_hnsw = HybridQuery(search_query, vsim_query_with_hnsw)
+
+        res2 = await decoded_r.ft().hybrid_search(
+            query=hybrid_query_with_hnsw, timeout=10
+        )
+
+        expected_results2 = [
+            {"__key": b"item:12", "__score": b"0.016393442623"},
+            {"__key": b"item:22", "__score": b"0.0161290322581"},
+            {"__key": b"item:27", "__score": b"0.015873015873"},
+        ]
+        if is_resp2_connection(decoded_r):
+            assert res2.total_results == 3  # KNN top-k value
+            assert len(res2.results) == 3
+            assert res2.results == expected_results2
+            assert res2.warnings == []
+            assert res2.execution_time > 0
+        else:
+            assert res2["total_results"] == 3  # KNN top-k value
+            assert len(res2["results"]) == 3
+            assert res2["results"] == self._convert_dict_values_to_str(
+                expected_results2
+            )
+            assert res2["warnings"] == []
+            assert res2["execution_time"] > 0
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    async def test_hybrid_search_query_with_vsim_range(self, decoded_r):
+        # Create index and add data
+        await self._create_hybrid_search_index(decoded_r)
+        await self._add_data_for_hybrid_search(decoded_r, items_sets=10)
+
+        # set search query
+        # this query won't have results, so we will be able to validate vsim results
+        search_query = HybridSearchQuery("@color:{none}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 7, 6], dtype=np.float32).tobytes(),
+        )
+
+        vsim_query.vsim_method_params(VectorSearchMethods.RANGE, RADIUS=2)
+
+        hybrid_query = HybridQuery(search_query, vsim_query)
+
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.limit(0, 3)
+
+        res = await decoded_r.ft().hybrid_search(
+            query=hybrid_query, post_processing=postprocessing_config, timeout=10
+        )
+
+        expected_results = [
+            {"__key": b"item:2", "__score": b"0.016393442623"},
+            {"__key": b"item:7", "__score": b"0.0161290322581"},
+            {"__key": b"item:12", "__score": b"0.015873015873"},
+        ]
+        if is_resp2_connection(decoded_r):
+            assert res.total_results >= 3  # at least 3 results
+            assert len(res.results) == 3
+            assert res.results == expected_results
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert res["total_results"] >= 3
+            assert len(res["results"]) == 3
+            assert res["results"] == self._convert_dict_values_to_str(expected_results)
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+        vsim_query_with_hnsw = HybridVsimQuery(
+            vector_field_name="@embedding-hnsw",
+            vector_data=np.array([1, 2, 7, 6], dtype=np.float32).tobytes(),
+        )
+
+        vsim_query_with_hnsw.vsim_method_params(
+            VectorSearchMethods.RANGE, RADIUS=2, EPSILON=0.5
+        )
+
+        hybrid_query_with_hnsw = HybridQuery(search_query, vsim_query_with_hnsw)
+
+        res = await decoded_r.ft().hybrid_search(
+            query=hybrid_query_with_hnsw,
+            post_processing=postprocessing_config,
+            timeout=10,
+        )
+
+        expected_results_hnsw = [
+            {"__key": b"item:27", "__score": b"0.016393442623"},
+            {"__key": b"item:12", "__score": b"0.0161290322581"},
+            {"__key": b"item:22", "__score": b"0.015873015873"},
+        ]
+
+        if is_resp2_connection(decoded_r):
+            assert res.total_results >= 3
+            assert len(res.results) == 3
+            assert res.results == expected_results_hnsw
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert res["total_results"] >= 3
+            assert len(res["results"]) == 3
+            assert res["results"] == self._convert_dict_values_to_str(
+                expected_results_hnsw
+            )
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    async def test_hybrid_search_query_with_combine_all_score_aliases(self, decoded_r):
+        # Create index and add data
+        await self._create_hybrid_search_index(decoded_r)
+        await self._add_data_for_hybrid_search(
+            decoded_r, items_sets=1, use_random_str_data=True
+        )
+
+        search_query = HybridSearchQuery("shoes")
+        search_query.yield_score_as("search_score")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding-hnsw",
+            vector_data="abcd1234efgh5678",
+            vsim_search_method=VectorSearchMethods.KNN,
+            vsim_search_method_params={
+                "K": 3,
+                "EF_RUNTIME": 1,
+                "YIELD_SCORE_AS": "vsim_score",
+            },
+        )
+
+        hybrid_query = HybridQuery(search_query, vsim_query)
+
+        combine_method = CombineResultsMethod(
+            CombinationMethods.LINEAR,
+            ALPHA=0.5,
+            BETA=0.5,
+            YIELD_SCORE_AS="combined_score",
+        )
+
+        res = await decoded_r.ft().hybrid_search(
+            query=hybrid_query, combine_method=combine_method, timeout=10
+        )
+
+        if is_resp2_connection(decoded_r):
+            assert len(res.results) > 0
+            assert res.warnings == []
+            for item in res.results:
+                assert item["combined_score"] is not None
+                assert "__score" not in item
+                if item["__key"] in [b"item:0", b"item:1", b"item:4"]:
+                    assert item["search_score"] is not None
+                else:
+                    assert "search_score" not in item
+                if item["__key"] in [b"item:0", b"item:1", b"item:2"]:
+                    assert item["vsim_score"] is not None
+                else:
+                    assert "vsim_score" not in item
+
+        else:
+            assert len(res["results"]) > 0
+            assert res["warnings"] == []
+            for item in res["results"]:
+                assert item["combined_score"] is not None
+                assert "__score" not in item
+                if item["__key"] in ["item:0", "item:1", "item:4"]:
+                    assert item["search_score"] is not None
+                else:
+                    assert "search_score" not in item
+                if item["__key"] in ["item:0", "item:1", "item:2"]:
+                    assert item["vsim_score"] is not None
+                else:
+                    assert "vsim_score" not in item
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    async def test_hybrid_search_query_with_combine(self, decoded_r):
+        # Create index and add data
+        await self._create_hybrid_search_index(decoded_r)
+        await self._add_data_for_hybrid_search(decoded_r, items_sets=10)
+
+        # set search query
+        search_query = HybridSearchQuery("@color:{red}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 7, 6], dtype=np.float32).tobytes(),
+        )
+
+        hybrid_query = HybridQuery(search_query, vsim_query)
+
+        combine_method_linear = CombineResultsMethod(
+            CombinationMethods.LINEAR, ALPHA=0.5, BETA=0.5
+        )
+
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.limit(0, 3)
+
+        res = await decoded_r.ft().hybrid_search(
+            query=hybrid_query,
+            combine_method=combine_method_linear,
+            post_processing=postprocessing_config,
+            timeout=10,
+        )
+
+        expected_results = [
+            {"__key": b"item:2", "__score": b"0.166666666667"},
+            {"__key": b"item:7", "__score": b"0.166666666667"},
+            {"__key": b"item:12", "__score": b"0.166666666667"},
+        ]
+        if is_resp2_connection(decoded_r):
+            assert res.total_results >= 3
+            assert len(res.results) == 3
+            assert res.results == expected_results
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert res["total_results"] >= 3
+            assert len(res["results"]) == 3
+            assert res["results"] == self._convert_dict_values_to_str(expected_results)
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+        # combine with RRF and WINDOW + CONSTANT
+        combine_method_rrf = CombineResultsMethod(
+            CombinationMethods.RRF, WINDOW=3, CONSTANT=0.5
+        )
+        res = await decoded_r.ft().hybrid_search(
+            query=hybrid_query,
+            combine_method=combine_method_rrf,
+            post_processing=postprocessing_config,
+            timeout=10,
+        )
+
+        expected_results = [
+            {"__key": b"item:2", "__score": b"1.06666666667"},
+            {"__key": b"item:0", "__score": b"0.666666666667"},
+            {"__key": b"item:7", "__score": b"0.4"},
+        ]
+        if is_resp2_connection(decoded_r):
+            assert res.total_results >= 3
+            assert len(res.results) == 3
+            assert res.results == expected_results
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert res["total_results"] >= 3
+            assert len(res["results"]) == 3
+            assert res["results"] == self._convert_dict_values_to_str(expected_results)
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+        # combine with RRF, not all possible params provided
+        combine_method_rrf_2 = CombineResultsMethod(CombinationMethods.RRF, WINDOW=3)
+        res = await decoded_r.ft().hybrid_search(
+            query=hybrid_query,
+            combine_method=combine_method_rrf_2,
+            post_processing=postprocessing_config,
+            timeout=10,
+        )
+
+        expected_results = [
+            {"__key": b"item:2", "__score": b"0.032522474881"},
+            {"__key": b"item:0", "__score": b"0.016393442623"},
+            {"__key": b"item:7", "__score": b"0.0161290322581"},
+        ]
+        if is_resp2_connection(decoded_r):
+            assert res.total_results >= 3
+            assert len(res.results) == 3
+            assert res.results == expected_results
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert res["total_results"] >= 3
+            assert len(res["results"]) == 3
+            assert res["results"] == self._convert_dict_values_to_str(expected_results)
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    async def test_hybrid_search_query_with_load(self, decoded_r):
+        # Create index and add data
+        await self._create_hybrid_search_index(decoded_r)
+        await self._add_data_for_hybrid_search(decoded_r, items_sets=10)
+
+        # set search query
+        search_query = HybridSearchQuery("@color:{red|green|black}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 7, 6], dtype=np.float32).tobytes(),
+        )
+
+        hybrid_query = HybridQuery(search_query, vsim_query)
+
+        combine_method = CombineResultsMethod(
+            CombinationMethods.LINEAR, ALPHA=0.5, BETA=0.5
+        )
+
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.load(
+            "@description", "@color", "@price", "@size", "@__key AS item_key"
+        )
+        postprocessing_config.limit(0, 1)
+
+        res = await decoded_r.ft().hybrid_search(
+            query=hybrid_query,
+            combine_method=combine_method,
+            post_processing=postprocessing_config,
+            timeout=10,
+        )
+
+        expected_results = [
+            {
+                "description": b"red dress",
+                "color": b"red",
+                "price": b"17",
+                "size": b"12",
+                "item_key": b"item:2",
+            }
+        ]
+        if is_resp2_connection(decoded_r):
+            assert res.total_results >= 1
+            assert len(res.results) == 1
+            self.compare_list_of_dicts(res.results, expected_results)
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert res["total_results"] >= 1
+            assert len(res["results"]) == 1
+            self.compare_list_of_dicts(
+                res["results"], self._convert_dict_values_to_str(expected_results)
+            )
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    async def test_hybrid_search_query_with_load_and_apply(self, decoded_r):
+        # Create index and add data
+        await self._create_hybrid_search_index(decoded_r)
+        await self._add_data_for_hybrid_search(decoded_r, items_sets=10)
+
+        # set search query
+        search_query = HybridSearchQuery("@color:{red}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 7, 6], dtype=np.float32).tobytes(),
+        )
+
+        hybrid_query = HybridQuery(search_query, vsim_query)
+
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.load("@color", "@price", "@size")
+        postprocessing_config.apply(
+            price_discount="@price - (@price * 0.1)",
+            tax_discount="@price_discount * 0.2",
+        )
+        postprocessing_config.limit(0, 3)
+
+        res = await decoded_r.ft().hybrid_search(
+            query=hybrid_query, post_processing=postprocessing_config, timeout=10
+        )
+
+        expected_results = [
+            {
+                "color": b"red",
+                "price": b"15",
+                "size": b"10",
+                "price_discount": b"13.5",
+                "tax_discount": b"2.7",
+            },
+            {
+                "color": b"red",
+                "price": b"17",
+                "size": b"12",
+                "price_discount": b"15.3",
+                "tax_discount": b"3.06",
+            },
+            {
+                "color": b"red",
+                "price": b"18",
+                "size": b"11",
+                "price_discount": b"16.2",
+                "tax_discount": b"3.24",
+            },
+        ]
+        if is_resp2_connection(decoded_r):
+            assert len(res.results) == 3
+            self.compare_list_of_dicts(res.results, expected_results)
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert len(res["results"]) == 3
+            self.compare_list_of_dicts(
+                res["results"], self._convert_dict_values_to_str(expected_results)
+            )
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    async def test_hybrid_search_query_with_load_and_filter(self, decoded_r):
+        # Create index and add data
+        await self._create_hybrid_search_index(decoded_r)
+        await self._add_data_for_hybrid_search(decoded_r, items_sets=10)
+
+        # set search query
+        search_query = HybridSearchQuery("@color:{red|green|black}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 7, 6], dtype=np.float32).tobytes(),
+        )
+
+        hybrid_query = HybridQuery(search_query, vsim_query)
+
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.load("@description", "@color", "@price", "@size")
+        # for the postprocessing filter we need to filter on the loaded fields
+        # expecting all of them to be interpreted as strings - the initial filed types
+        # are not preserved
+        postprocessing_config.filter(HybridFilter('@price=="15"'))
+        postprocessing_config.limit(0, 3)
+
+        res = await decoded_r.ft().hybrid_search(
+            query=hybrid_query, post_processing=postprocessing_config, timeout=10
+        )
+
+        if is_resp2_connection(decoded_r):
+            assert len(res.results) == 3
+            for item in res.results:
+                assert item["price"] == b"15"
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert len(res["results"]) == 3
+            for item in res["results"]:
+                assert item["price"] == "15"
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    async def test_hybrid_search_query_with_load_apply_and_params(self, decoded_r):
+        # Create index and add data
+        await self._create_hybrid_search_index(decoded_r)
+        await self._add_data_for_hybrid_search(
+            decoded_r, items_sets=5, use_random_str_data=True
+        )
+
+        # set search query
+        search_query = HybridSearchQuery("@color:{$color_criteria}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data="$vector",
+        )
+
+        hybrid_query = HybridQuery(search_query, vsim_query)
+
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.load("@description", "@color", "@price")
+        postprocessing_config.apply(price_discount="@price - (@price * 0.1)")
+        postprocessing_config.limit(0, 3)
+
+        params_substitution = {
+            "vector": "abcd1234abcd5678",
+            "color_criteria": "red",
+        }
+
+        res = await decoded_r.ft().hybrid_search(
+            query=hybrid_query,
+            post_processing=postprocessing_config,
+            params_substitution=params_substitution,
+            timeout=10,
+        )
+
+        expected_results = [
+            {
+                "description": b"red shoes",
+                "color": b"red",
+                "price": b"15",
+                "price_discount": b"13.5",
+            },
+            {
+                "description": b"red dress",
+                "color": b"red",
+                "price": b"17",
+                "price_discount": b"15.3",
+            },
+            {
+                "description": b"red shoes",
+                "color": b"red",
+                "price": b"16",
+                "price_discount": b"14.4",
+            },
+        ]
+        if is_resp2_connection(decoded_r):
+            assert len(res.results) == 3
+            assert res.results == expected_results
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert len(res["results"]) == 3
+            assert res["results"] == self._convert_dict_values_to_str(expected_results)
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    async def test_hybrid_search_query_with_limit(self, decoded_r):
+        # Create index and add data
+        await self._create_hybrid_search_index(decoded_r)
+        await self._add_data_for_hybrid_search(decoded_r, items_sets=10)
+
+        # set search query
+        search_query = HybridSearchQuery("@color:{red}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 7, 6], dtype=np.float32).tobytes(),
+        )
+
+        hybrid_query = HybridQuery(search_query, vsim_query)
+
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.limit(0, 3)
+
+        res = await decoded_r.ft().hybrid_search(
+            query=hybrid_query, post_processing=postprocessing_config, timeout=10
+        )
+
+        if is_resp2_connection(decoded_r):
+            assert len(res.results) == 3
+            assert res.warnings == []
+        else:
+            assert len(res["results"]) == 3
+            assert res["warnings"] == []
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    async def test_hybrid_search_query_with_load_apply_and_sortby(self, decoded_r):
+        # Create index and add data
+        await self._create_hybrid_search_index(decoded_r)
+        await self._add_data_for_hybrid_search(decoded_r, items_sets=1)
+
+        # set search query
+        search_query = HybridSearchQuery("@color:{red|green}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 7, 6], dtype=np.float32).tobytes(),
+        )
+
+        hybrid_query = HybridQuery(search_query, vsim_query)
+
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.load("@color", "@price")
+        postprocessing_config.apply(price_discount="@price - (@price * 0.1)")
+        postprocessing_config.sort_by(
+            SortbyField("@price_discount", asc=False), SortbyField("@color", asc=True)
+        )
+        postprocessing_config.limit(0, 5)
+
+        res = await decoded_r.ft().hybrid_search(
+            query=hybrid_query, post_processing=postprocessing_config, timeout=10
+        )
+
+        expected_results = [
+            {"color": b"orange", "price": b"18", "price_discount": b"16.2"},
+            {"color": b"red", "price": b"17", "price_discount": b"15.3"},
+            {"color": b"green", "price": b"16", "price_discount": b"14.4"},
+            {"color": b"black", "price": b"15", "price_discount": b"13.5"},
+            {"color": b"red", "price": b"15", "price_discount": b"13.5"},
+        ]
+        if is_resp2_connection(decoded_r):
+            assert res.total_results >= 5
+            assert len(res.results) == 5
+            # the order here should match because of the sort
+            assert res.results == expected_results
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert res["total_results"] >= 5
+            assert len(res["results"]) == 5
+            # the order here should match because of the sort
+            assert res["results"] == self._convert_dict_values_to_str(expected_results)
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    async def test_hybrid_search_query_with_timeout(self, decoded_r):
+        dim = 128
+        # Create index and add data
+        await self._create_hybrid_search_index(decoded_r, dim=dim)
+        await self._add_data_for_hybrid_search(
+            decoded_r,
+            items_sets=5000,
+            dim_for_random_data=dim,
+            use_random_str_data=True,
+        )
+
+        # set search query
+        search_query = HybridSearchQuery("*")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding-hnsw",
+            vector_data="abcd" * dim,
+        )
+        vsim_query.vsim_method_params(VectorSearchMethods.KNN, K=1000)
+        vsim_query.filter(
+            HybridFilter(
+                "((@price:[15 16] @size:[10 11]) | (@price:[13 15] @size:[11 12])) @description:(shoes) -@description:(green)"
+            )
+        )
+
+        hybrid_query = HybridQuery(search_query, vsim_query)
+
+        combine_method = CombineResultsMethod(CombinationMethods.RRF, WINDOW=1000)
+
+        timeout = 5000  # 5 second timeout
+        res = await decoded_r.ft().hybrid_search(
+            query=hybrid_query, combine_method=combine_method, timeout=timeout
+        )
+
+        if is_resp2_connection(decoded_r):
+            assert len(res.results) > 0
+            assert res.warnings == []
+            assert res.execution_time > 0 and res.execution_time < timeout
+        else:
+            assert len(res["results"]) > 0
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0 and res["execution_time"] < timeout
+
+        res = await decoded_r.ft().hybrid_search(
+            query=hybrid_query, timeout=1
+        )  # 1 ms timeout
+        if is_resp2_connection(decoded_r):
+            assert (
+                b"Timeout limit was reached (VSIM)" in res.warnings
+                or b"Timeout limit was reached (SEARCH)" in res.warnings
+            )
+        else:
+            assert (
+                "Timeout limit was reached (VSIM)" in res["warnings"]
+                or "Timeout limit was reached (SEARCH)" in res["warnings"]
+            )
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    async def test_hybrid_search_query_with_load_and_groupby(self, decoded_r):
+        # Create index and add data
+        await self._create_hybrid_search_index(decoded_r)
+        await self._add_data_for_hybrid_search(decoded_r, items_sets=10)
+
+        # set search query
+        search_query = HybridSearchQuery("@color:{red|green}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 7, 6], dtype=np.float32).tobytes(),
+        )
+
+        hybrid_query = HybridQuery(search_query, vsim_query)
+
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.load("@color", "@price", "@size", "@item_type")
+        postprocessing_config.limit(0, 4)
+
+        postprocessing_config.group_by(
+            ["@price"],
+            reducers.count_distinct("@color").alias("colors_count"),
+        )
+
+        postprocessing_config.sort_by(SortbyField("@price", asc=True))
+
+        res = await decoded_r.ft().hybrid_search(
+            query=hybrid_query, post_processing=postprocessing_config, timeout=10
+        )
+
+        expected_results = [
+            {"price": b"15", "colors_count": b"2"},
+            {"price": b"16", "colors_count": b"2"},
+            {"price": b"17", "colors_count": b"2"},
+            {"price": b"18", "colors_count": b"2"},
+        ]
+
+        if is_resp2_connection(decoded_r):
+            assert len(res.results) == 4
+            assert res.results == expected_results
+            assert res.warnings == []
+        else:
+            assert len(res["results"]) == 4
+            assert res["results"] == self._convert_dict_values_to_str(expected_results)
+            assert res["warnings"] == []
+
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.load("@color", "@price", "@size", "@item_type")
+        postprocessing_config.limit(0, 6)
+        postprocessing_config.sort_by(
+            SortbyField("@price", asc=True),
+            SortbyField("@item_type", asc=True),
+        )
+
+        postprocessing_config.group_by(
+            ["@price", "@item_type"],
+            reducers.count_distinct("@color").alias("unique_colors_count"),
+        )
+
+        res = await decoded_r.ft().hybrid_search(
+            query=hybrid_query, post_processing=postprocessing_config, timeout=1000
+        )
+
+        expected_results = [
+            {"price": b"15", "item_type": b"dress", "unique_colors_count": b"1"},
+            {"price": b"15", "item_type": b"shoes", "unique_colors_count": b"2"},
+            {"price": b"16", "item_type": b"dress", "unique_colors_count": b"1"},
+            {"price": b"16", "item_type": b"shoes", "unique_colors_count": b"2"},
+            {"price": b"17", "item_type": b"dress", "unique_colors_count": b"1"},
+            {"price": b"17", "item_type": b"shoes", "unique_colors_count": b"2"},
+        ]
+        if is_resp2_connection(decoded_r):
+            assert len(res.results) == 6
+            assert res.results == expected_results
+            assert res.warnings == []
+        else:
+            assert len(res["results"]) == 6
+            assert res["results"] == self._convert_dict_values_to_str(expected_results)
+            assert res["warnings"] == []
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    async def test_hybrid_search_query_with_cursor(self, decoded_r):
+        # Create index and add data
+        await self._create_hybrid_search_index(decoded_r)
+        await self._add_data_for_hybrid_search(decoded_r, items_sets=10)
+
+        # set search query
+        search_query = HybridSearchQuery("@color:{red|green}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 7, 6], dtype=np.float32).tobytes(),
+        )
+
+        hybrid_query = HybridQuery(search_query, vsim_query)
+
+        res = await decoded_r.ft().hybrid_search(
+            query=hybrid_query,
+            cursor=HybridCursorQuery(count=5, max_idle=100),
+            timeout=10,
+        )
+        if is_resp2_connection(decoded_r):
+            assert isinstance(res, HybridCursorResult)
+            assert res.search_cursor_id > 0
+            assert res.vsim_cursor_id > 0
+            search_cursor = aggregations.Cursor(res.search_cursor_id)
+            vsim_cursor = aggregations.Cursor(res.vsim_cursor_id)
+        else:
+            assert res["SEARCH"] > 0
+            assert res["VSIM"] > 0
+            search_cursor = aggregations.Cursor(res["SEARCH"])
+            vsim_cursor = aggregations.Cursor(res["VSIM"])
+
+        search_res_from_cursor = await decoded_r.ft().aggregate(query=search_cursor)
+        if is_resp2_connection(decoded_r):
+            assert len(search_res_from_cursor.rows) == 5
+        else:
+            assert len(search_res_from_cursor[0]["results"]) == 5
+
+        vsim_res_from_cursor = await decoded_r.ft().aggregate(query=vsim_cursor)
+        if is_resp2_connection(decoded_r):
+            assert len(vsim_res_from_cursor.rows) == 5
+        else:
+            assert len(vsim_res_from_cursor[0]["results"]) == 5
diff --git a/tests/test_asyncio/test_vsets.py b/tests/test_asyncio/test_vsets.py
index 447e474e9c..fa37a517c7 100644
--- a/tests/test_asyncio/test_vsets.py
+++ b/tests/test_asyncio/test_vsets.py
@@ -451,23 +451,23 @@ async def test_vsim_with_filter(d_client):
 
 @skip_if_server_version_lt("7.9.0")
 async def test_vsim_truth_no_thread_enabled(d_client):
-    elements_count = 5000
+    elements_count = 1000
     vector_dim = 50
     for i in range(1, elements_count + 1):
-        float_array = [i for _ in range(vector_dim)]
+        float_array = [i * vector_dim for _ in range(vector_dim)]
         await d_client.vset().vadd("myset", float_array, f"elem_{i}")
 
     await d_client.vset().vadd("myset", [-22 for _ in range(vector_dim)], "elem_man_2")
 
     sim_without_truth = await d_client.vset().vsim(
-        "myset", input="elem_man_2", with_scores=True
+        "myset", input="elem_man_2", count=30, with_scores=True
     )
     sim_truth = await d_client.vset().vsim(
-        "myset", input="elem_man_2", with_scores=True, truth=True
+        "myset", input="elem_man_2", count=30, with_scores=True, truth=True
     )
 
-    assert len(sim_without_truth) == 10
-    assert len(sim_truth) == 10
+    assert len(sim_without_truth) == 30
+    assert len(sim_truth) == 30
 
     assert isinstance(sim_without_truth, dict)
     assert isinstance(sim_truth, dict)
diff --git a/tests/test_search.py b/tests/test_search.py
index b76baf10aa..27f97d8ca8 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -1,6 +1,7 @@
 import bz2
 import csv
 import os
+import random
 import time
 from io import TextIOWrapper
 
@@ -8,8 +9,20 @@
 import pytest
 from redis import ResponseError
 import redis
-import redis.commands.search
+
 import redis.commands.search.aggregation as aggregations
+from redis.commands.search.hybrid_query import (
+    CombinationMethods,
+    CombineResultsMethod,
+    HybridCursorQuery,
+    HybridFilter,
+    HybridPostProcessingConfig,
+    HybridQuery,
+    HybridSearchQuery,
+    HybridVsimQuery,
+    VectorSearchMethods,
+)
+from redis.commands.search.hybrid_result import HybridCursorResult
 import redis.commands.search.reducers as reducers
 from redis.commands.json.path import Path
 from redis.commands.search import Search
@@ -22,9 +35,15 @@
     VectorField,
 )
 from redis.commands.search.index_definition import IndexDefinition, IndexType
-from redis.commands.search.query import GeoFilter, NumericFilter, Query
+from redis.commands.search.query import (
+    GeoFilter,
+    NumericFilter,
+    Query,
+    SortbyField,
+)
 from redis.commands.search.result import Result
 from redis.commands.search.suggestion import Suggestion
+from redis.utils import safe_str
 
 from .conftest import (
     _get_client,
@@ -45,3824 +64,5255 @@
 )
 
 
-def waitForIndex(env, idx, timeout=None):
-    delay = 0.1
-    while True:
-        try:
-            res = env.execute_command("FT.INFO", idx)
-            if int(res[res.index("indexing") + 1]) == 0:
-                break
-        except ValueError:
-            break
-        except AttributeError:
+def _assert_search_result(client, result, expected_doc_ids):
+    """
+    Make sure the result of a geo search is as expected, taking into account the RESP
+    version being used.
+    """
+    if is_resp2_connection(client):
+        assert set([doc.id for doc in result.docs]) == set(expected_doc_ids)
+    else:
+        assert set([doc["id"] for doc in result["results"]]) == set(expected_doc_ids)
+
+
+class SearchTestsBase:
+    @staticmethod
+    def waitForIndex(env, idx, timeout=None):
+        delay = 0.1
+        while True:
             try:
-                if int(res["indexing"]) == 0:
+                res = env.execute_command("FT.INFO", idx)
+                if int(res[res.index("indexing") + 1]) == 0:
                     break
             except ValueError:
                 break
-        except ResponseError:
-            # index doesn't exist yet
-            # continue to sleep and try again
-            pass
-
-        time.sleep(delay)
-        if timeout is not None:
-            timeout -= delay
-            if timeout <= 0:
+            except AttributeError:
+                try:
+                    if int(res["indexing"]) == 0:
+                        break
+                except ValueError:
+                    break
+            except ResponseError:
+                # index doesn't exist yet
+                # continue to sleep and try again
+                pass
+
+            time.sleep(delay)
+            if timeout is not None:
+                timeout -= delay
+                if timeout <= 0:
+                    break
+
+    @staticmethod
+    def getClient(client):
+        """
+        Gets a client client attached to an index name which is ready to be
+        created
+        """
+        return client
+
+    @staticmethod
+    def createIndex(client, num_docs=100, definition=None):
+        try:
+            client.create_index(
+                (
+                    TextField("play", weight=5.0),
+                    TextField("txt"),
+                    NumericField("chapter"),
+                ),
+                definition=definition,
+            )
+        except redis.ResponseError:
+            client.dropindex(delete_documents=True)
+            return SearchTestsBase.createIndex(
+                client, num_docs=num_docs, definition=definition
+            )
+
+        chapters = {}
+        bzfp = TextIOWrapper(bz2.BZ2File(WILL_PLAY_TEXT), encoding="utf8")
+
+        r = csv.reader(bzfp, delimiter=";")
+        for n, line in enumerate(r):
+            play, chapter, _, text = line[1], line[2], line[4], line[5]
+
+            key = f"{play}:{chapter}".lower()
+            d = chapters.setdefault(key, {})
+            d["play"] = play
+            d["txt"] = d.get("txt", "") + " " + text
+            d["chapter"] = int(chapter or 0)
+            if len(chapters) == num_docs:
                 break
 
+        indexer = client.batch_indexer(chunk_size=50)
+        assert isinstance(indexer, Search.BatchIndexer)
+        assert 50 == indexer.chunk_size
 
-def getClient(client):
-    """
-    Gets a client client attached to an index name which is ready to be
-    created
-    """
-    return client
+        for key, doc in chapters.items():
+            indexer.client.client.hset(key, mapping=doc)
+        indexer.commit()
 
+    @pytest.fixture
+    def client(self, request, stack_url):
+        r = _get_client(redis.Redis, request, decode_responses=True, from_url=stack_url)
+        r.flushdb()
+        return r
 
-def createIndex(client, num_docs=100, definition=None):
-    try:
-        client.create_index(
-            (TextField("play", weight=5.0), TextField("txt"), NumericField("chapter")),
-            definition=definition,
-        )
-    except redis.ResponseError:
-        client.dropindex(delete_documents=True)
-        return createIndex(client, num_docs=num_docs, definition=definition)
-
-    chapters = {}
-    bzfp = TextIOWrapper(bz2.BZ2File(WILL_PLAY_TEXT), encoding="utf8")
-
-    r = csv.reader(bzfp, delimiter=";")
-    for n, line in enumerate(r):
-        play, chapter, _, text = line[1], line[2], line[4], line[5]
-
-        key = f"{play}:{chapter}".lower()
-        d = chapters.setdefault(key, {})
-        d["play"] = play
-        d["txt"] = d.get("txt", "") + " " + text
-        d["chapter"] = int(chapter or 0)
-        if len(chapters) == num_docs:
-            break
-
-    indexer = client.batch_indexer(chunk_size=50)
-    assert isinstance(indexer, Search.BatchIndexer)
-    assert 50 == indexer.chunk_size
-
-    for key, doc in chapters.items():
-        indexer.client.client.hset(key, mapping=doc)
-    indexer.commit()
-
-
-@pytest.fixture
-def client(request, stack_url):
-    r = _get_client(redis.Redis, request, decode_responses=True, from_url=stack_url)
-    r.flushdb()
-    return r
-
-
-@pytest.mark.redismod
-def test_client(client):
-    num_docs = 500
-    createIndex(client.ft(), num_docs=num_docs)
-    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
-    # verify info
-    info = client.ft().info()
-    for k in [
-        "index_name",
-        "index_options",
-        "attributes",
-        "num_docs",
-        "max_doc_id",
-        "num_terms",
-        "num_records",
-        "inverted_sz_mb",
-        "offset_vectors_sz_mb",
-        "doc_table_size_mb",
-        "key_table_size_mb",
-        "records_per_doc_avg",
-        "bytes_per_record_avg",
-        "offsets_per_term_avg",
-        "offset_bits_per_record_avg",
-    ]:
-        assert k in info
-
-    assert client.ft().index_name == info["index_name"]
-    assert num_docs == int(info["num_docs"])
-
-    res = client.ft().search("henry iv")
-    if is_resp2_connection(client):
-        assert isinstance(res, Result)
-        assert 225 == res.total
-        assert 10 == len(res.docs)
-        assert res.duration > 0
-
-        for doc in res.docs:
-            assert doc.id
-            assert doc["id"]
-            assert doc.play == "Henry IV"
-            assert doc["play"] == "Henry IV"
-            assert len(doc.txt) > 0
 
-        # test no content
-        res = client.ft().search(Query("king").no_content())
-        assert 194 == res.total
-        assert 10 == len(res.docs)
-        for doc in res.docs:
-            assert "txt" not in doc.__dict__
-            assert "play" not in doc.__dict__
-
-        # test verbatim vs no verbatim
-        total = client.ft().search(Query("kings").no_content()).total
-        vtotal = client.ft().search(Query("kings").no_content().verbatim()).total
-        assert total > vtotal
-
-        # test in fields
-        txt_total = (
-            client.ft().search(Query("henry").no_content().limit_fields("txt")).total
-        )
-        play_total = (
-            client.ft().search(Query("henry").no_content().limit_fields("play")).total
-        )
-        both_total = (
-            client.ft()
-            .search(Query("henry").no_content().limit_fields("play", "txt"))
-            .total
-        )
-        assert 129 == txt_total
-        assert 494 == play_total
-        assert 494 == both_total
-
-        # test load_document
-        doc = client.ft().load_document("henry vi part 3:62")
-        assert doc is not None
-        assert "henry vi part 3:62" == doc.id
-        assert doc.play == "Henry VI Part 3"
-        assert len(doc.txt) > 0
-
-        # test in-keys
-        ids = [x.id for x in client.ft().search(Query("henry")).docs]
-        assert 10 == len(ids)
-        subset = ids[:5]
-        docs = client.ft().search(Query("henry").limit_ids(*subset))
-        assert len(subset) == docs.total
-        ids = [x.id for x in docs.docs]
-        assert set(ids) == set(subset)
-
-        # test slop and in order
-        assert 193 == client.ft().search(Query("henry king")).total
-        assert 3 == client.ft().search(Query("henry king").slop(0).in_order()).total
-        assert 52 == client.ft().search(Query("king henry").slop(0).in_order()).total
-        assert 53 == client.ft().search(Query("henry king").slop(0)).total
-        assert 167 == client.ft().search(Query("henry king").slop(100)).total
-
-        # test delete document
-        client.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
-        res = client.ft().search(Query("death of a salesman"))
-        assert 1 == res.total
-
-        assert 1 == client.ft().delete_document("doc-5ghs2")
-        res = client.ft().search(Query("death of a salesman"))
-        assert 0 == res.total
-        assert 0 == client.ft().delete_document("doc-5ghs2")
-
-        client.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
-        res = client.ft().search(Query("death of a salesman"))
-        assert 1 == res.total
-        client.ft().delete_document("doc-5ghs2")
-    else:
-        assert isinstance(res, dict)
-        assert 225 == res["total_results"]
-        assert 10 == len(res["results"])
-
-        for doc in res["results"]:
-            assert doc["id"]
-            assert doc["extra_attributes"]["play"] == "Henry IV"
-            assert len(doc["extra_attributes"]["txt"]) > 0
-
-        # test no content
-        res = client.ft().search(Query("king").no_content())
-        assert 194 == res["total_results"]
-        assert 10 == len(res["results"])
-        for doc in res["results"]:
-            assert "extra_attributes" not in doc.keys()
-
-        # test verbatim vs no verbatim
-        total = client.ft().search(Query("kings").no_content())["total_results"]
-        vtotal = client.ft().search(Query("kings").no_content().verbatim())[
-            "total_results"
-        ]
-        assert total > vtotal
+class TestBaseSearchFunctionality(SearchTestsBase):
+    @pytest.mark.redismod
+    def test_client(self, client):
+        num_docs = 500
+        self.createIndex(client.ft(), num_docs=num_docs)
+        self.waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
+        # verify info
+        info = client.ft().info()
+        for k in [
+            "index_name",
+            "index_options",
+            "attributes",
+            "num_docs",
+            "max_doc_id",
+            "num_terms",
+            "num_records",
+            "inverted_sz_mb",
+            "offset_vectors_sz_mb",
+            "doc_table_size_mb",
+            "key_table_size_mb",
+            "records_per_doc_avg",
+            "bytes_per_record_avg",
+            "offsets_per_term_avg",
+            "offset_bits_per_record_avg",
+        ]:
+            assert k in info
+
+        assert client.ft().index_name == info["index_name"]
+        assert num_docs == int(info["num_docs"])
+
+        res = client.ft().search("henry iv")
+        if is_resp2_connection(client):
+            assert isinstance(res, Result)
+            assert 225 == res.total
+            assert 10 == len(res.docs)
+            assert res.duration > 0
+
+            for doc in res.docs:
+                assert doc.id
+                assert doc["id"]
+                assert doc.play == "Henry IV"
+                assert doc["play"] == "Henry IV"
+                assert len(doc.txt) > 0
+
+            # test no content
+            res = client.ft().search(Query("king").no_content())
+            assert 194 == res.total
+            assert 10 == len(res.docs)
+            for doc in res.docs:
+                assert "txt" not in doc.__dict__
+                assert "play" not in doc.__dict__
+
+            # test verbatim vs no verbatim
+            total = client.ft().search(Query("kings").no_content()).total
+            vtotal = client.ft().search(Query("kings").no_content().verbatim()).total
+            assert total > vtotal
+
+            # test in fields
+            txt_total = (
+                client.ft()
+                .search(Query("henry").no_content().limit_fields("txt"))
+                .total
+            )
+            play_total = (
+                client.ft()
+                .search(Query("henry").no_content().limit_fields("play"))
+                .total
+            )
+            both_total = (
+                client.ft()
+                .search(Query("henry").no_content().limit_fields("play", "txt"))
+                .total
+            )
+            assert 129 == txt_total
+            assert 494 == play_total
+            assert 494 == both_total
+
+            # test load_document
+            doc = client.ft().load_document("henry vi part 3:62")
+            assert doc is not None
+            assert "henry vi part 3:62" == doc.id
+            assert doc.play == "Henry VI Part 3"
+            assert len(doc.txt) > 0
 
-        # test in fields
-        txt_total = client.ft().search(Query("henry").no_content().limit_fields("txt"))[
-            "total_results"
-        ]
-        play_total = client.ft().search(
-            Query("henry").no_content().limit_fields("play")
-        )["total_results"]
-        both_total = client.ft().search(
-            Query("henry").no_content().limit_fields("play", "txt")
-        )["total_results"]
-        assert 129 == txt_total
-        assert 494 == play_total
-        assert 494 == both_total
-
-        # test load_document
-        doc = client.ft().load_document("henry vi part 3:62")
-        assert doc is not None
-        assert "henry vi part 3:62" == doc.id
-        assert doc.play == "Henry VI Part 3"
-        assert len(doc.txt) > 0
-
-        # test in-keys
-        ids = [x["id"] for x in client.ft().search(Query("henry"))["results"]]
-        assert 10 == len(ids)
-        subset = ids[:5]
-        docs = client.ft().search(Query("henry").limit_ids(*subset))
-        assert len(subset) == docs["total_results"]
-        ids = [x["id"] for x in docs["results"]]
-        assert set(ids) == set(subset)
-
-        # test slop and in order
-        assert 193 == client.ft().search(Query("henry king"))["total_results"]
-        assert (
-            3
-            == client.ft().search(Query("henry king").slop(0).in_order())[
-                "total_results"
-            ]
-        )
-        assert (
-            52
-            == client.ft().search(Query("king henry").slop(0).in_order())[
+            # test in-keys
+            ids = [x.id for x in client.ft().search(Query("henry")).docs]
+            assert 10 == len(ids)
+            subset = ids[:5]
+            docs = client.ft().search(Query("henry").limit_ids(*subset))
+            assert len(subset) == docs.total
+            ids = [x.id for x in docs.docs]
+            assert set(ids) == set(subset)
+
+            # test slop and in order
+            assert 193 == client.ft().search(Query("henry king")).total
+            assert 3 == client.ft().search(Query("henry king").slop(0).in_order()).total
+            assert (
+                52 == client.ft().search(Query("king henry").slop(0).in_order()).total
+            )
+            assert 53 == client.ft().search(Query("henry king").slop(0)).total
+            assert 167 == client.ft().search(Query("henry king").slop(100)).total
+
+            # test delete document
+            client.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
+            res = client.ft().search(Query("death of a salesman"))
+            assert 1 == res.total
+
+            assert 1 == client.ft().delete_document("doc-5ghs2")
+            res = client.ft().search(Query("death of a salesman"))
+            assert 0 == res.total
+            assert 0 == client.ft().delete_document("doc-5ghs2")
+
+            client.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
+            res = client.ft().search(Query("death of a salesman"))
+            assert 1 == res.total
+            client.ft().delete_document("doc-5ghs2")
+        else:
+            assert isinstance(res, dict)
+            assert 225 == res["total_results"]
+            assert 10 == len(res["results"])
+
+            for doc in res["results"]:
+                assert doc["id"]
+                assert doc["extra_attributes"]["play"] == "Henry IV"
+                assert len(doc["extra_attributes"]["txt"]) > 0
+
+            # test no content
+            res = client.ft().search(Query("king").no_content())
+            assert 194 == res["total_results"]
+            assert 10 == len(res["results"])
+            for doc in res["results"]:
+                assert "extra_attributes" not in doc.keys()
+
+            # test verbatim vs no verbatim
+            total = client.ft().search(Query("kings").no_content())["total_results"]
+            vtotal = client.ft().search(Query("kings").no_content().verbatim())[
                 "total_results"
             ]
-        )
-        assert 53 == client.ft().search(Query("henry king").slop(0))["total_results"]
-        assert 167 == client.ft().search(Query("henry king").slop(100))["total_results"]
+            assert total > vtotal
+
+            # test in fields
+            txt_total = client.ft().search(
+                Query("henry").no_content().limit_fields("txt")
+            )["total_results"]
+            play_total = client.ft().search(
+                Query("henry").no_content().limit_fields("play")
+            )["total_results"]
+            both_total = client.ft().search(
+                Query("henry").no_content().limit_fields("play", "txt")
+            )["total_results"]
+            assert 129 == txt_total
+            assert 494 == play_total
+            assert 494 == both_total
+
+            # test load_document
+            doc = client.ft().load_document("henry vi part 3:62")
+            assert doc is not None
+            assert "henry vi part 3:62" == doc.id
+            assert doc.play == "Henry VI Part 3"
+            assert len(doc.txt) > 0
 
-        # test delete document
-        client.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
-        res = client.ft().search(Query("death of a salesman"))
-        assert 1 == res["total_results"]
+            # test in-keys
+            ids = [x["id"] for x in client.ft().search(Query("henry"))["results"]]
+            assert 10 == len(ids)
+            subset = ids[:5]
+            docs = client.ft().search(Query("henry").limit_ids(*subset))
+            assert len(subset) == docs["total_results"]
+            ids = [x["id"] for x in docs["results"]]
+            assert set(ids) == set(subset)
+
+            # test slop and in order
+            assert 193 == client.ft().search(Query("henry king"))["total_results"]
+            assert (
+                3
+                == client.ft().search(Query("henry king").slop(0).in_order())[
+                    "total_results"
+                ]
+            )
+            assert (
+                52
+                == client.ft().search(Query("king henry").slop(0).in_order())[
+                    "total_results"
+                ]
+            )
+            assert (
+                53 == client.ft().search(Query("henry king").slop(0))["total_results"]
+            )
+            assert (
+                167
+                == client.ft().search(Query("henry king").slop(100))["total_results"]
+            )
 
-        assert 1 == client.ft().delete_document("doc-5ghs2")
-        res = client.ft().search(Query("death of a salesman"))
-        assert 0 == res["total_results"]
-        assert 0 == client.ft().delete_document("doc-5ghs2")
+            # test delete document
+            client.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
+            res = client.ft().search(Query("death of a salesman"))
+            assert 1 == res["total_results"]
 
-        client.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
-        res = client.ft().search(Query("death of a salesman"))
-        assert 1 == res["total_results"]
-        client.ft().delete_document("doc-5ghs2")
+            assert 1 == client.ft().delete_document("doc-5ghs2")
+            res = client.ft().search(Query("death of a salesman"))
+            assert 0 == res["total_results"]
+            assert 0 == client.ft().delete_document("doc-5ghs2")
 
+            client.hset("doc-5ghs2", mapping={"play": "Death of a Salesman"})
+            res = client.ft().search(Query("death of a salesman"))
+            assert 1 == res["total_results"]
+            client.ft().delete_document("doc-5ghs2")
 
-@pytest.mark.redismod
-@pytest.mark.onlynoncluster
-@skip_if_server_version_gte("7.9.0")
-def test_scores(client):
-    client.ft().create_index((TextField("txt"),))
+    @pytest.mark.redismod
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_gte("7.9.0")
+    def test_scores(self, client):
+        client.ft().create_index((TextField("txt"),))
 
-    client.hset("doc1", mapping={"txt": "foo baz"})
-    client.hset("doc2", mapping={"txt": "foo bar"})
+        client.hset("doc1", mapping={"txt": "foo baz"})
+        client.hset("doc2", mapping={"txt": "foo bar"})
 
-    q = Query("foo ~bar").with_scores()
-    res = client.ft().search(q)
-    if is_resp2_connection(client):
-        assert 2 == res.total
-        assert "doc2" == res.docs[0].id
-        assert 3.0 == res.docs[0].score
-        assert "doc1" == res.docs[1].id
-    else:
-        assert 2 == res["total_results"]
-        assert "doc2" == res["results"][0]["id"]
-        assert 3.0 == res["results"][0]["score"]
-        assert "doc1" == res["results"][1]["id"]
+        q = Query("foo ~bar").with_scores()
+        res = client.ft().search(q)
+        if is_resp2_connection(client):
+            assert 2 == res.total
+            assert "doc2" == res.docs[0].id
+            assert 3.0 == res.docs[0].score
+            assert "doc1" == res.docs[1].id
+        else:
+            assert 2 == res["total_results"]
+            assert "doc2" == res["results"][0]["id"]
+            assert 3.0 == res["results"][0]["score"]
+            assert "doc1" == res["results"][1]["id"]
+
+    @pytest.mark.redismod
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("7.9.0")
+    def test_scores_with_new_default_scorer(self, client):
+        client.ft().create_index((TextField("txt"),))
+
+        client.hset("doc1", mapping={"txt": "foo baz"})
+        client.hset("doc2", mapping={"txt": "foo bar"})
+
+        q = Query("foo ~bar").with_scores()
+        res = client.ft().search(q)
+        if is_resp2_connection(client):
+            assert 2 == res.total
+            assert "doc2" == res.docs[0].id
+            assert 0.87 == pytest.approx(res.docs[0].score, 0.01)
+            assert "doc1" == res.docs[1].id
+        else:
+            assert 2 == res["total_results"]
+            assert "doc2" == res["results"][0]["id"]
+            assert 0.87 == pytest.approx(res["results"][0]["score"], 0.01)
+            assert "doc1" == res["results"][1]["id"]
+
+    @pytest.mark.redismod
+    def test_stopwords(self, client):
+        client.ft().create_index((TextField("txt"),), stopwords=["foo", "bar", "baz"])
+        client.hset("doc1", mapping={"txt": "foo bar"})
+        client.hset("doc2", mapping={"txt": "hello world"})
+        self.waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
+
+        q1 = Query("foo bar").no_content()
+        q2 = Query("foo bar hello world").no_content()
+        res1, res2 = client.ft().search(q1), client.ft().search(q2)
+        if is_resp2_connection(client):
+            assert 0 == res1.total
+            assert 1 == res2.total
+        else:
+            assert 0 == res1["total_results"]
+            assert 1 == res2["total_results"]
+
+    @pytest.mark.redismod
+    def test_filters(self, client):
+        client.ft().create_index(
+            (TextField("txt"), NumericField("num"), GeoField("loc"))
+        )
+        client.hset(
+            "doc1", mapping={"txt": "foo bar", "num": 3.141, "loc": "-0.441,51.458"}
+        )
+        client.hset("doc2", mapping={"txt": "foo baz", "num": 2, "loc": "-0.1,51.2"})
+
+        self.waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
+        # Test numerical filter
+        q1 = Query("foo").add_filter(NumericFilter("num", 0, 2)).no_content()
+        q2 = (
+            Query("foo")
+            .add_filter(NumericFilter("num", 2, NumericFilter.INF, minExclusive=True))
+            .no_content()
+        )
+        res1, res2 = client.ft().search(q1), client.ft().search(q2)
+        if is_resp2_connection(client):
+            assert 1 == res1.total
+            assert 1 == res2.total
+            assert "doc2" == res1.docs[0].id
+            assert "doc1" == res2.docs[0].id
+        else:
+            assert 1 == res1["total_results"]
+            assert 1 == res2["total_results"]
+            assert "doc2" == res1["results"][0]["id"]
+            assert "doc1" == res2["results"][0]["id"]
 
+        # Test geo filter
+        q1 = Query("foo").add_filter(GeoFilter("loc", -0.44, 51.45, 10)).no_content()
+        q2 = Query("foo").add_filter(GeoFilter("loc", -0.44, 51.45, 100)).no_content()
+        res1, res2 = client.ft().search(q1), client.ft().search(q2)
 
-@pytest.mark.redismod
-@pytest.mark.onlynoncluster
-@skip_if_server_version_lt("7.9.0")
-def test_scores_with_new_default_scorer(client):
-    client.ft().create_index((TextField("txt"),))
+        if is_resp2_connection(client):
+            assert 1 == res1.total
+            assert 2 == res2.total
+            assert "doc1" == res1.docs[0].id
+
+            # Sort results, after RDB reload order may change
+            res = [res2.docs[0].id, res2.docs[1].id]
+            res.sort()
+            assert ["doc1", "doc2"] == res
+        else:
+            assert 1 == res1["total_results"]
+            assert 2 == res2["total_results"]
+            assert "doc1" == res1["results"][0]["id"]
+
+            # Sort results, after RDB reload order may change
+            res = [res2["results"][0]["id"], res2["results"][1]["id"]]
+            res.sort()
+            assert ["doc1", "doc2"] == res
+
+    @pytest.mark.redismod
+    def test_sort_by(self, client):
+        client.ft().create_index((TextField("txt"), NumericField("num", sortable=True)))
+        client.hset("doc1", mapping={"txt": "foo bar", "num": 1})
+        client.hset("doc2", mapping={"txt": "foo baz", "num": 2})
+        client.hset("doc3", mapping={"txt": "foo qux", "num": 3})
+
+        # Test sort
+        q1 = Query("foo").sort_by("num", asc=True).no_content()
+        q2 = Query("foo").sort_by("num", asc=False).no_content()
+        res1, res2 = client.ft().search(q1), client.ft().search(q2)
 
-    client.hset("doc1", mapping={"txt": "foo baz"})
-    client.hset("doc2", mapping={"txt": "foo bar"})
+        if is_resp2_connection(client):
+            assert 3 == res1.total
+            assert "doc1" == res1.docs[0].id
+            assert "doc2" == res1.docs[1].id
+            assert "doc3" == res1.docs[2].id
+            assert 3 == res2.total
+            assert "doc1" == res2.docs[2].id
+            assert "doc2" == res2.docs[1].id
+            assert "doc3" == res2.docs[0].id
+        else:
+            assert 3 == res1["total_results"]
+            assert "doc1" == res1["results"][0]["id"]
+            assert "doc2" == res1["results"][1]["id"]
+            assert "doc3" == res1["results"][2]["id"]
+            assert 3 == res2["total_results"]
+            assert "doc1" == res2["results"][2]["id"]
+            assert "doc2" == res2["results"][1]["id"]
+            assert "doc3" == res2["results"][0]["id"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.0.0", "search")
+    def test_drop_index(self, client):
+        """
+        Ensure the index gets dropped by data remains by default
+        """
+        for x in range(20):
+            for keep_docs in [[True, {}], [False, {"name": "haveit"}]]:
+                idx = "HaveIt"
+                index = self.getClient(client)
+                index.hset("index:haveit", mapping={"name": "haveit"})
+                idef = IndexDefinition(prefix=["index:"])
+                index.ft(idx).create_index((TextField("name"),), definition=idef)
+                self.waitForIndex(index, idx)
+                index.ft(idx).dropindex(delete_documents=keep_docs[0])
+                i = index.hgetall("index:haveit")
+                assert i == keep_docs[1]
+
+    @pytest.mark.redismod
+    def test_example(self, client):
+        # Creating the index definition and schema
+        client.ft().create_index((TextField("title", weight=5.0), TextField("body")))
+
+        # Indexing a document
+        client.hset(
+            "doc1",
+            mapping={
+                "title": "RediSearch",
+                "body": "Redisearch impements a search engine on top of redis",
+            },
+        )
 
-    q = Query("foo ~bar").with_scores()
-    res = client.ft().search(q)
-    if is_resp2_connection(client):
-        assert 2 == res.total
-        assert "doc2" == res.docs[0].id
-        assert 0.87 == pytest.approx(res.docs[0].score, 0.01)
-        assert "doc1" == res.docs[1].id
-    else:
-        assert 2 == res["total_results"]
-        assert "doc2" == res["results"][0]["id"]
-        assert 0.87 == pytest.approx(res["results"][0]["score"], 0.01)
-        assert "doc1" == res["results"][1]["id"]
-
-
-@pytest.mark.redismod
-def test_stopwords(client):
-    client.ft().create_index((TextField("txt"),), stopwords=["foo", "bar", "baz"])
-    client.hset("doc1", mapping={"txt": "foo bar"})
-    client.hset("doc2", mapping={"txt": "hello world"})
-    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
-
-    q1 = Query("foo bar").no_content()
-    q2 = Query("foo bar hello world").no_content()
-    res1, res2 = client.ft().search(q1), client.ft().search(q2)
-    if is_resp2_connection(client):
-        assert 0 == res1.total
-        assert 1 == res2.total
-    else:
-        assert 0 == res1["total_results"]
-        assert 1 == res2["total_results"]
-
-
-@pytest.mark.redismod
-def test_filters(client):
-    client.ft().create_index((TextField("txt"), NumericField("num"), GeoField("loc")))
-    client.hset(
-        "doc1", mapping={"txt": "foo bar", "num": 3.141, "loc": "-0.441,51.458"}
-    )
-    client.hset("doc2", mapping={"txt": "foo baz", "num": 2, "loc": "-0.1,51.2"})
-
-    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
-    # Test numerical filter
-    q1 = Query("foo").add_filter(NumericFilter("num", 0, 2)).no_content()
-    q2 = (
-        Query("foo")
-        .add_filter(NumericFilter("num", 2, NumericFilter.INF, minExclusive=True))
-        .no_content()
-    )
-    res1, res2 = client.ft().search(q1), client.ft().search(q2)
-    if is_resp2_connection(client):
-        assert 1 == res1.total
-        assert 1 == res2.total
-        assert "doc2" == res1.docs[0].id
-        assert "doc1" == res2.docs[0].id
-    else:
-        assert 1 == res1["total_results"]
-        assert 1 == res2["total_results"]
-        assert "doc2" == res1["results"][0]["id"]
-        assert "doc1" == res2["results"][0]["id"]
+        # Searching with complex parameters:
+        q = Query("search engine").verbatim().no_content().paging(0, 5)
+
+        res = client.ft().search(q)
+        assert res is not None
+
+    @pytest.mark.redismod
+    @skip_if_redis_enterprise()
+    def test_auto_complete(self, client):
+        n = 0
+        with open(TITLES_CSV) as f:
+            cr = csv.reader(f)
+
+            for row in cr:
+                n += 1
+                term, score = row[0], float(row[1])
+                assert n == client.ft().sugadd("ac", Suggestion(term, score=score))
+
+        assert n == client.ft().suglen("ac")
+        ret = client.ft().sugget("ac", "bad", with_scores=True)
+        assert 2 == len(ret)
+        assert "badger" == ret[0].string
+        assert isinstance(ret[0].score, float)
+        assert 1.0 != ret[0].score
+        assert "badalte rishtey" == ret[1].string
+        assert isinstance(ret[1].score, float)
+        assert 1.0 != ret[1].score
+
+        ret = client.ft().sugget("ac", "bad", fuzzy=True, num=10)
+        assert 10 == len(ret)
+        assert 1.0 == ret[0].score
+        strs = {x.string for x in ret}
+
+        for sug in strs:
+            assert 1 == client.ft().sugdel("ac", sug)
+        # make sure a second delete returns 0
+        for sug in strs:
+            assert 0 == client.ft().sugdel("ac", sug)
+
+        # make sure they were actually deleted
+        ret2 = client.ft().sugget("ac", "bad", fuzzy=True, num=10)
+        for sug in ret2:
+            assert sug.string not in strs
+
+        # Test with payload
+        client.ft().sugadd("ac", Suggestion("pay1", payload="pl1"))
+        client.ft().sugadd("ac", Suggestion("pay2", payload="pl2"))
+        client.ft().sugadd("ac", Suggestion("pay3", payload="pl3"))
+
+        sugs = client.ft().sugget("ac", "pay", with_payloads=True, with_scores=True)
+        assert 3 == len(sugs)
+        for sug in sugs:
+            assert sug.payload
+            assert sug.payload.startswith("pl")
+
+    @pytest.mark.redismod
+    def test_no_index(self, client):
+        client.ft().create_index(
+            (
+                TextField("field"),
+                TextField("text", no_index=True, sortable=True),
+                NumericField("numeric", no_index=True, sortable=True),
+                GeoField("geo", no_index=True, sortable=True),
+                TagField("tag", no_index=True, sortable=True),
+            )
+        )
 
-    # Test geo filter
-    q1 = Query("foo").add_filter(GeoFilter("loc", -0.44, 51.45, 10)).no_content()
-    q2 = Query("foo").add_filter(GeoFilter("loc", -0.44, 51.45, 100)).no_content()
-    res1, res2 = client.ft().search(q1), client.ft().search(q2)
+        client.hset(
+            "doc1",
+            mapping={
+                "field": "aaa",
+                "text": "1",
+                "numeric": "1",
+                "geo": "1,1",
+                "tag": "1",
+            },
+        )
+        client.hset(
+            "doc2",
+            mapping={
+                "field": "aab",
+                "text": "2",
+                "numeric": "2",
+                "geo": "2,2",
+                "tag": "2",
+            },
+        )
+        self.waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
-    if is_resp2_connection(client):
-        assert 1 == res1.total
-        assert 2 == res2.total
-        assert "doc1" == res1.docs[0].id
-
-        # Sort results, after RDB reload order may change
-        res = [res2.docs[0].id, res2.docs[1].id]
-        res.sort()
-        assert ["doc1", "doc2"] == res
-    else:
-        assert 1 == res1["total_results"]
-        assert 2 == res2["total_results"]
-        assert "doc1" == res1["results"][0]["id"]
+        if is_resp2_connection(client):
+            res = client.ft().search(Query("@text:aa*"))
+            assert 0 == res.total
 
-        # Sort results, after RDB reload order may change
-        res = [res2["results"][0]["id"], res2["results"][1]["id"]]
-        res.sort()
-        assert ["doc1", "doc2"] == res
+            res = client.ft().search(Query("@field:aa*"))
+            assert 2 == res.total
 
+            res = client.ft().search(Query("*").sort_by("text", asc=False))
+            assert 2 == res.total
+            assert "doc2" == res.docs[0].id
 
-@pytest.mark.redismod
-def test_sort_by(client):
-    client.ft().create_index((TextField("txt"), NumericField("num", sortable=True)))
-    client.hset("doc1", mapping={"txt": "foo bar", "num": 1})
-    client.hset("doc2", mapping={"txt": "foo baz", "num": 2})
-    client.hset("doc3", mapping={"txt": "foo qux", "num": 3})
+            res = client.ft().search(Query("*").sort_by("text", asc=True))
+            assert "doc1" == res.docs[0].id
 
-    # Test sort
-    q1 = Query("foo").sort_by("num", asc=True).no_content()
-    q2 = Query("foo").sort_by("num", asc=False).no_content()
-    res1, res2 = client.ft().search(q1), client.ft().search(q2)
+            res = client.ft().search(Query("*").sort_by("numeric", asc=True))
+            assert "doc1" == res.docs[0].id
 
-    if is_resp2_connection(client):
-        assert 3 == res1.total
-        assert "doc1" == res1.docs[0].id
-        assert "doc2" == res1.docs[1].id
-        assert "doc3" == res1.docs[2].id
-        assert 3 == res2.total
-        assert "doc1" == res2.docs[2].id
-        assert "doc2" == res2.docs[1].id
-        assert "doc3" == res2.docs[0].id
-    else:
-        assert 3 == res1["total_results"]
-        assert "doc1" == res1["results"][0]["id"]
-        assert "doc2" == res1["results"][1]["id"]
-        assert "doc3" == res1["results"][2]["id"]
-        assert 3 == res2["total_results"]
-        assert "doc1" == res2["results"][2]["id"]
-        assert "doc2" == res2["results"][1]["id"]
-        assert "doc3" == res2["results"][0]["id"]
-
-
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.0.0", "search")
-def test_drop_index(client):
-    """
-    Ensure the index gets dropped by data remains by default
-    """
-    for x in range(20):
-        for keep_docs in [[True, {}], [False, {"name": "haveit"}]]:
-            idx = "HaveIt"
-            index = getClient(client)
-            index.hset("index:haveit", mapping={"name": "haveit"})
-            idef = IndexDefinition(prefix=["index:"])
-            index.ft(idx).create_index((TextField("name"),), definition=idef)
-            waitForIndex(index, idx)
-            index.ft(idx).dropindex(delete_documents=keep_docs[0])
-            i = index.hgetall("index:haveit")
-            assert i == keep_docs[1]
-
-
-@pytest.mark.redismod
-def test_example(client):
-    # Creating the index definition and schema
-    client.ft().create_index((TextField("title", weight=5.0), TextField("body")))
-
-    # Indexing a document
-    client.hset(
-        "doc1",
-        mapping={
-            "title": "RediSearch",
-            "body": "Redisearch impements a search engine on top of redis",
-        },
-    )
-
-    # Searching with complex parameters:
-    q = Query("search engine").verbatim().no_content().paging(0, 5)
-
-    res = client.ft().search(q)
-    assert res is not None
-
-
-@pytest.mark.redismod
-@skip_if_redis_enterprise()
-def test_auto_complete(client):
-    n = 0
-    with open(TITLES_CSV) as f:
-        cr = csv.reader(f)
-
-        for row in cr:
-            n += 1
-            term, score = row[0], float(row[1])
-            assert n == client.ft().sugadd("ac", Suggestion(term, score=score))
-
-    assert n == client.ft().suglen("ac")
-    ret = client.ft().sugget("ac", "bad", with_scores=True)
-    assert 2 == len(ret)
-    assert "badger" == ret[0].string
-    assert isinstance(ret[0].score, float)
-    assert 1.0 != ret[0].score
-    assert "badalte rishtey" == ret[1].string
-    assert isinstance(ret[1].score, float)
-    assert 1.0 != ret[1].score
-
-    ret = client.ft().sugget("ac", "bad", fuzzy=True, num=10)
-    assert 10 == len(ret)
-    assert 1.0 == ret[0].score
-    strs = {x.string for x in ret}
-
-    for sug in strs:
-        assert 1 == client.ft().sugdel("ac", sug)
-    # make sure a second delete returns 0
-    for sug in strs:
-        assert 0 == client.ft().sugdel("ac", sug)
-
-    # make sure they were actually deleted
-    ret2 = client.ft().sugget("ac", "bad", fuzzy=True, num=10)
-    for sug in ret2:
-        assert sug.string not in strs
-
-    # Test with payload
-    client.ft().sugadd("ac", Suggestion("pay1", payload="pl1"))
-    client.ft().sugadd("ac", Suggestion("pay2", payload="pl2"))
-    client.ft().sugadd("ac", Suggestion("pay3", payload="pl3"))
-
-    sugs = client.ft().sugget("ac", "pay", with_payloads=True, with_scores=True)
-    assert 3 == len(sugs)
-    for sug in sugs:
-        assert sug.payload
-        assert sug.payload.startswith("pl")
-
-
-@pytest.mark.redismod
-def test_no_index(client):
-    client.ft().create_index(
-        (
-            TextField("field"),
-            TextField("text", no_index=True, sortable=True),
-            NumericField("numeric", no_index=True, sortable=True),
-            GeoField("geo", no_index=True, sortable=True),
-            TagField("tag", no_index=True, sortable=True),
-        )
-    )
-
-    client.hset(
-        "doc1",
-        mapping={"field": "aaa", "text": "1", "numeric": "1", "geo": "1,1", "tag": "1"},
-    )
-    client.hset(
-        "doc2",
-        mapping={"field": "aab", "text": "2", "numeric": "2", "geo": "2,2", "tag": "2"},
-    )
-    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
+            res = client.ft().search(Query("*").sort_by("geo", asc=True))
+            assert "doc1" == res.docs[0].id
 
-    if is_resp2_connection(client):
-        res = client.ft().search(Query("@text:aa*"))
-        assert 0 == res.total
+            res = client.ft().search(Query("*").sort_by("tag", asc=True))
+            assert "doc1" == res.docs[0].id
+        else:
+            res = client.ft().search(Query("@text:aa*"))
+            assert 0 == res["total_results"]
 
-        res = client.ft().search(Query("@field:aa*"))
-        assert 2 == res.total
+            res = client.ft().search(Query("@field:aa*"))
+            assert 2 == res["total_results"]
 
-        res = client.ft().search(Query("*").sort_by("text", asc=False))
-        assert 2 == res.total
-        assert "doc2" == res.docs[0].id
+            res = client.ft().search(Query("*").sort_by("text", asc=False))
+            assert 2 == res["total_results"]
+            assert "doc2" == res["results"][0]["id"]
 
-        res = client.ft().search(Query("*").sort_by("text", asc=True))
-        assert "doc1" == res.docs[0].id
+            res = client.ft().search(Query("*").sort_by("text", asc=True))
+            assert "doc1" == res["results"][0]["id"]
 
-        res = client.ft().search(Query("*").sort_by("numeric", asc=True))
-        assert "doc1" == res.docs[0].id
+            res = client.ft().search(Query("*").sort_by("numeric", asc=True))
+            assert "doc1" == res["results"][0]["id"]
 
-        res = client.ft().search(Query("*").sort_by("geo", asc=True))
-        assert "doc1" == res.docs[0].id
+            res = client.ft().search(Query("*").sort_by("geo", asc=True))
+            assert "doc1" == res["results"][0]["id"]
 
-        res = client.ft().search(Query("*").sort_by("tag", asc=True))
-        assert "doc1" == res.docs[0].id
-    else:
-        res = client.ft().search(Query("@text:aa*"))
-        assert 0 == res["total_results"]
+            res = client.ft().search(Query("*").sort_by("tag", asc=True))
+            assert "doc1" == res["results"][0]["id"]
 
-        res = client.ft().search(Query("@field:aa*"))
-        assert 2 == res["total_results"]
+        # Ensure exception is raised for non-indexable, non-sortable fields
+        with pytest.raises(Exception):
+            TextField("name", no_index=True, sortable=False)
+        with pytest.raises(Exception):
+            NumericField("name", no_index=True, sortable=False)
+        with pytest.raises(Exception):
+            GeoField("name", no_index=True, sortable=False)
+        with pytest.raises(Exception):
+            TagField("name", no_index=True, sortable=False)
 
-        res = client.ft().search(Query("*").sort_by("text", asc=False))
-        assert 2 == res["total_results"]
-        assert "doc2" == res["results"][0]["id"]
+    @pytest.mark.redismod
+    def test_explain(self, client):
+        client.ft().create_index((TextField("f1"), TextField("f2"), TextField("f3")))
+        res = client.ft().explain("@f3:f3_val @f2:f2_val @f1:f1_val")
+        assert res
 
-        res = client.ft().search(Query("*").sort_by("text", asc=True))
-        assert "doc1" == res["results"][0]["id"]
+    @pytest.mark.redismod
+    def test_explaincli(self, client):
+        with pytest.raises(NotImplementedError):
+            client.ft().explain_cli("foo")
 
-        res = client.ft().search(Query("*").sort_by("numeric", asc=True))
-        assert "doc1" == res["results"][0]["id"]
+    @pytest.mark.redismod
+    def test_summarize(self, client):
+        self.createIndex(client.ft())
+        self.waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
-        res = client.ft().search(Query("*").sort_by("geo", asc=True))
-        assert "doc1" == res["results"][0]["id"]
+        q = Query('"king henry"').paging(0, 1)
+        q.highlight(fields=("play", "txt"), tags=("<b>", "</b>"))
+        q.summarize("txt")
 
-        res = client.ft().search(Query("*").sort_by("tag", asc=True))
-        assert "doc1" == res["results"][0]["id"]
+        if is_resp2_connection(client):
+            doc = sorted(client.ft().search(q).docs)[0]
+            assert "<b>Henry</b> IV" == doc.play
+            assert (
+                "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+                == doc.txt
+            )
 
-    # Ensure exception is raised for non-indexable, non-sortable fields
-    with pytest.raises(Exception):
-        TextField("name", no_index=True, sortable=False)
-    with pytest.raises(Exception):
-        NumericField("name", no_index=True, sortable=False)
-    with pytest.raises(Exception):
-        GeoField("name", no_index=True, sortable=False)
-    with pytest.raises(Exception):
-        TagField("name", no_index=True, sortable=False)
+            q = Query('"king henry"').paging(0, 1).summarize().highlight()
 
+            doc = sorted(client.ft().search(q).docs)[0]
+            assert "<b>Henry</b> ... " == doc.play
+            assert (
+                "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+                == doc.txt
+            )
+        else:
+            doc = sorted(client.ft().search(q)["results"])[0]
+            assert "<b>Henry</b> IV" == doc["extra_attributes"]["play"]
+            assert (
+                "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+                == doc["extra_attributes"]["txt"]
+            )
 
-@pytest.mark.redismod
-def test_explain(client):
-    client.ft().create_index((TextField("f1"), TextField("f2"), TextField("f3")))
-    res = client.ft().explain("@f3:f3_val @f2:f2_val @f1:f1_val")
-    assert res
+            q = Query('"king henry"').paging(0, 1).summarize().highlight()
 
+            doc = sorted(client.ft().search(q)["results"])[0]
+            assert "<b>Henry</b> ... " == doc["extra_attributes"]["play"]
+            assert (
+                "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
+                == doc["extra_attributes"]["txt"]
+            )
 
-@pytest.mark.redismod
-def test_explaincli(client):
-    with pytest.raises(NotImplementedError):
-        client.ft().explain_cli("foo")
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.0.0", "search")
+    def test_alias(self, client):
+        index1 = self.getClient(client)
+        index2 = self.getClient(client)
 
+        def1 = IndexDefinition(prefix=["index1:"])
+        def2 = IndexDefinition(prefix=["index2:"])
 
-@pytest.mark.redismod
-def test_summarize(client):
-    createIndex(client.ft())
-    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
+        ftindex1 = index1.ft("testAlias")
+        ftindex2 = index2.ft("testAlias2")
+        ftindex1.create_index((TextField("name"),), definition=def1)
+        ftindex2.create_index((TextField("name"),), definition=def2)
 
-    q = Query('"king henry"').paging(0, 1)
-    q.highlight(fields=("play", "txt"), tags=("<b>", "</b>"))
-    q.summarize("txt")
+        index1.hset("index1:lonestar", mapping={"name": "lonestar"})
+        index2.hset("index2:yogurt", mapping={"name": "yogurt"})
 
-    if is_resp2_connection(client):
-        doc = sorted(client.ft().search(q).docs)[0]
-        assert "<b>Henry</b> IV" == doc.play
-        assert (
-            "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
-            == doc.txt
-        )
+        if is_resp2_connection(client):
+            res = ftindex1.search("*").docs[0]
+            assert "index1:lonestar" == res.id
 
-        q = Query('"king henry"').paging(0, 1).summarize().highlight()
+            # create alias and check for results
+            ftindex1.aliasadd("spaceballs")
+            alias_client = self.getClient(client).ft("spaceballs")
+            res = alias_client.search("*").docs[0]
+            assert "index1:lonestar" == res.id
 
-        doc = sorted(client.ft().search(q).docs)[0]
-        assert "<b>Henry</b> ... " == doc.play
-        assert (
-            "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
-            == doc.txt
-        )
-    else:
-        doc = sorted(client.ft().search(q)["results"])[0]
-        assert "<b>Henry</b> IV" == doc["extra_attributes"]["play"]
-        assert (
-            "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
-            == doc["extra_attributes"]["txt"]
-        )
+            # Throw an exception when trying to add an alias that already exists
+            with pytest.raises(Exception):
+                ftindex2.aliasadd("spaceballs")
 
-        q = Query('"king henry"').paging(0, 1).summarize().highlight()
+            # update alias and ensure new results
+            ftindex2.aliasupdate("spaceballs")
+            alias_client2 = self.getClient(client).ft("spaceballs")
 
-        doc = sorted(client.ft().search(q)["results"])[0]
-        assert "<b>Henry</b> ... " == doc["extra_attributes"]["play"]
-        assert (
-            "ACT I SCENE I. London. The palace. Enter <b>KING</b> <b>HENRY</b>, LORD JOHN OF LANCASTER, the EARL of WESTMORELAND, SIR... "  # noqa
-            == doc["extra_attributes"]["txt"]
-        )
+            res = alias_client2.search("*").docs[0]
+            assert "index2:yogurt" == res.id
+        else:
+            res = ftindex1.search("*")["results"][0]
+            assert "index1:lonestar" == res["id"]
 
+            # create alias and check for results
+            ftindex1.aliasadd("spaceballs")
+            alias_client = self.getClient(client).ft("spaceballs")
+            res = alias_client.search("*")["results"][0]
+            assert "index1:lonestar" == res["id"]
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.0.0", "search")
-def test_alias(client):
-    index1 = getClient(client)
-    index2 = getClient(client)
+            # Throw an exception when trying to add an alias that already exists
+            with pytest.raises(Exception):
+                ftindex2.aliasadd("spaceballs")
 
-    def1 = IndexDefinition(prefix=["index1:"])
-    def2 = IndexDefinition(prefix=["index2:"])
+            # update alias and ensure new results
+            ftindex2.aliasupdate("spaceballs")
+            alias_client2 = self.getClient(client).ft("spaceballs")
 
-    ftindex1 = index1.ft("testAlias")
-    ftindex2 = index2.ft("testAlias2")
-    ftindex1.create_index((TextField("name"),), definition=def1)
-    ftindex2.create_index((TextField("name"),), definition=def2)
+            res = alias_client2.search("*")["results"][0]
+            assert "index2:yogurt" == res["id"]
 
-    index1.hset("index1:lonestar", mapping={"name": "lonestar"})
-    index2.hset("index2:yogurt", mapping={"name": "yogurt"})
+        ftindex2.aliasdel("spaceballs")
+        with pytest.raises(Exception):
+            alias_client2.search("*").docs[0]
 
-    if is_resp2_connection(client):
-        res = ftindex1.search("*").docs[0]
-        assert "index1:lonestar" == res.id
+    @pytest.mark.redismod
+    @pytest.mark.xfail(strict=False)
+    def test_alias_basic(self, client):
+        # Creating a client with one index
+        index1 = self.getClient(client).ft("testAlias")
 
-        # create alias and check for results
-        ftindex1.aliasadd("spaceballs")
-        alias_client = getClient(client).ft("spaceballs")
-        res = alias_client.search("*").docs[0]
-        assert "index1:lonestar" == res.id
+        index1.create_index((TextField("txt"),))
+        index1.client.hset("doc1", mapping={"txt": "text goes here"})
 
-        # Throw an exception when trying to add an alias that already exists
-        with pytest.raises(Exception):
-            ftindex2.aliasadd("spaceballs")
+        index2 = self.getClient(client).ft("testAlias2")
+        index2.create_index((TextField("txt"),))
+        index2.client.hset("doc2", mapping={"txt": "text goes here"})
 
-        # update alias and ensure new results
-        ftindex2.aliasupdate("spaceballs")
-        alias_client2 = getClient(client).ft("spaceballs")
+        # add the actual alias and check
+        index1.aliasadd("myalias")
+        alias_client = self.getClient(client).ft("myalias")
+        if is_resp2_connection(client):
+            res = sorted(alias_client.search("*").docs, key=lambda x: x.id)
+            assert "doc1" == res[0].id
+
+            # Throw an exception when trying to add an alias that already exists
+            with pytest.raises(Exception):
+                index2.aliasadd("myalias")
+
+            # update the alias and ensure we get doc2
+            index2.aliasupdate("myalias")
+            alias_client2 = self.getClient(client).ft("myalias")
+            res = sorted(alias_client2.search("*").docs, key=lambda x: x.id)
+            assert "doc1" == res[0].id
+        else:
+            res = sorted(alias_client.search("*")["results"], key=lambda x: x["id"])
+            assert "doc1" == res[0]["id"]
 
-        res = alias_client2.search("*").docs[0]
-        assert "index2:yogurt" == res.id
-    else:
-        res = ftindex1.search("*")["results"][0]
-        assert "index1:lonestar" == res["id"]
+            # Throw an exception when trying to add an alias that already exists
+            with pytest.raises(Exception):
+                index2.aliasadd("myalias")
 
-        # create alias and check for results
-        ftindex1.aliasadd("spaceballs")
-        alias_client = getClient(client).ft("spaceballs")
-        res = alias_client.search("*")["results"][0]
-        assert "index1:lonestar" == res["id"]
+            # update the alias and ensure we get doc2
+            index2.aliasupdate("myalias")
+            alias_client2 = self.getClient(client).ft("myalias")
+            res = sorted(alias_client2.search("*")["results"], key=lambda x: x["id"])
+            assert "doc1" == res[0]["id"]
 
-        # Throw an exception when trying to add an alias that already exists
+        # delete the alias and expect an error if we try to query again
+        index2.aliasdel("myalias")
         with pytest.raises(Exception):
-            ftindex2.aliasadd("spaceballs")
+            _ = alias_client2.search("*").docs[0]
+
+    @pytest.mark.redismod
+    def test_textfield_sortable_nostem(self, client):
+        # Creating the index definition with sortable and no_stem
+        client.ft().create_index((TextField("txt", sortable=True, no_stem=True),))
+
+        # Now get the index info to confirm its contents
+        response = client.ft().info()
+        if is_resp2_connection(client):
+            assert "SORTABLE" in response["attributes"][0]
+            assert "NOSTEM" in response["attributes"][0]
+        else:
+            assert "SORTABLE" in response["attributes"][0]["flags"]
+            assert "NOSTEM" in response["attributes"][0]["flags"]
 
-        # update alias and ensure new results
-        ftindex2.aliasupdate("spaceballs")
-        alias_client2 = getClient(client).ft("spaceballs")
+    @pytest.mark.redismod
+    def test_alter_schema_add(self, client):
+        # Creating the index definition and schema
+        client.ft().create_index(TextField("title"))
 
-        res = alias_client2.search("*")["results"][0]
-        assert "index2:yogurt" == res["id"]
+        # Using alter to add a field
+        client.ft().alter_schema_add(TextField("body"))
 
-    ftindex2.aliasdel("spaceballs")
-    with pytest.raises(Exception):
-        alias_client2.search("*").docs[0]
+        # Indexing a document
+        client.hset(
+            "doc1",
+            mapping={"title": "MyTitle", "body": "Some content only in the body"},
+        )
 
+        # Searching with parameter only in the body (the added field)
+        q = Query("only in the body")
 
-@pytest.mark.redismod
-@pytest.mark.xfail(strict=False)
-def test_alias_basic(client):
-    # Creating a client with one index
-    index1 = getClient(client).ft("testAlias")
+        # Ensure we find the result searching on the added body field
+        res = client.ft().search(q)
+        if is_resp2_connection(client):
+            assert 1 == res.total
+        else:
+            assert 1 == res["total_results"]
 
-    index1.create_index((TextField("txt"),))
-    index1.client.hset("doc1", mapping={"txt": "text goes here"})
+    @pytest.mark.redismod
+    def test_spell_check(self, client):
+        client.ft().create_index((TextField("f1"), TextField("f2")))
 
-    index2 = getClient(client).ft("testAlias2")
-    index2.create_index((TextField("txt"),))
-    index2.client.hset("doc2", mapping={"txt": "text goes here"})
+        client.hset(
+            "doc1", mapping={"f1": "some valid content", "f2": "this is sample text"}
+        )
+        client.hset("doc2", mapping={"f1": "very important", "f2": "lorem ipsum"})
+        self.waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
-    # add the actual alias and check
-    index1.aliasadd("myalias")
-    alias_client = getClient(client).ft("myalias")
-    if is_resp2_connection(client):
-        res = sorted(alias_client.search("*").docs, key=lambda x: x.id)
-        assert "doc1" == res[0].id
+        if is_resp2_connection(client):
+            # test spellcheck
+            res = client.ft().spellcheck("impornant")
+            assert "important" == res["impornant"][0]["suggestion"]
+
+            res = client.ft().spellcheck("contnt")
+            assert "content" == res["contnt"][0]["suggestion"]
+
+            # test spellcheck with Levenshtein distance
+            res = client.ft().spellcheck("vlis")
+            assert res == {}
+            res = client.ft().spellcheck("vlis", distance=2)
+            assert "valid" == res["vlis"][0]["suggestion"]
+
+            # test spellcheck include
+            client.ft().dict_add("dict", "lore", "lorem", "lorm")
+            res = client.ft().spellcheck("lorm", include="dict")
+            assert len(res["lorm"]) == 3
+            assert (
+                res["lorm"][0]["suggestion"],
+                res["lorm"][1]["suggestion"],
+                res["lorm"][2]["suggestion"],
+            ) == ("lorem", "lore", "lorm")
+            assert (res["lorm"][0]["score"], res["lorm"][1]["score"]) == ("0.5", "0")
+
+            # test spellcheck exclude
+            res = client.ft().spellcheck("lorm", exclude="dict")
+            assert res == {}
+        else:
+            # test spellcheck
+            res = client.ft().spellcheck("impornant")
+            assert "important" in res["results"]["impornant"][0].keys()
+
+            res = client.ft().spellcheck("contnt")
+            assert "content" in res["results"]["contnt"][0].keys()
+
+            # test spellcheck with Levenshtein distance
+            res = client.ft().spellcheck("vlis")
+            assert res == {"results": {"vlis": []}}
+            res = client.ft().spellcheck("vlis", distance=2)
+            assert "valid" in res["results"]["vlis"][0].keys()
+
+            # test spellcheck include
+            client.ft().dict_add("dict", "lore", "lorem", "lorm")
+            res = client.ft().spellcheck("lorm", include="dict")
+            assert len(res["results"]["lorm"]) == 3
+            assert "lorem" in res["results"]["lorm"][0].keys()
+            assert "lore" in res["results"]["lorm"][1].keys()
+            assert "lorm" in res["results"]["lorm"][2].keys()
+            assert (
+                res["results"]["lorm"][0]["lorem"],
+                res["results"]["lorm"][1]["lore"],
+            ) == (0.5, 0)
+
+            # test spellcheck exclude
+            res = client.ft().spellcheck("lorm", exclude="dict")
+            assert res == {"results": {}}
+
+    @pytest.mark.redismod
+    def test_dict_operations(self, client):
+        client.ft().create_index((TextField("f1"), TextField("f2")))
+        # Add three items
+        res = client.ft().dict_add("custom_dict", "item1", "item2", "item3")
+        assert 3 == res
+
+        # Remove one item
+        res = client.ft().dict_del("custom_dict", "item2")
+        assert 1 == res
+
+        # Dump dict and inspect content
+        res = client.ft().dict_dump("custom_dict")
+        assert res == ["item1", "item3"]
+
+        # Remove rest of the items before reload
+        client.ft().dict_del("custom_dict", *res)
+
+    @pytest.mark.redismod
+    def test_phonetic_matcher(self, client):
+        client.ft().create_index((TextField("name"),))
+        client.hset("doc1", mapping={"name": "Jon"})
+        client.hset("doc2", mapping={"name": "John"})
+
+        res = client.ft().search(Query("Jon"))
+        if is_resp2_connection(client):
+            assert 1 == len(res.docs)
+            assert "Jon" == res.docs[0].name
+        else:
+            assert 1 == res["total_results"]
+            assert "Jon" == res["results"][0]["extra_attributes"]["name"]
 
-        # Throw an exception when trying to add an alias that already exists
-        with pytest.raises(Exception):
-            index2.aliasadd("myalias")
+        # Drop and create index with phonetic matcher
+        client.flushdb()
 
-        # update the alias and ensure we get doc2
-        index2.aliasupdate("myalias")
-        alias_client2 = getClient(client).ft("myalias")
-        res = sorted(alias_client2.search("*").docs, key=lambda x: x.id)
-        assert "doc1" == res[0].id
-    else:
-        res = sorted(alias_client.search("*")["results"], key=lambda x: x["id"])
-        assert "doc1" == res[0]["id"]
+        client.ft().create_index((TextField("name", phonetic_matcher="dm:en"),))
+        client.hset("doc1", mapping={"name": "Jon"})
+        client.hset("doc2", mapping={"name": "John"})
 
-        # Throw an exception when trying to add an alias that already exists
-        with pytest.raises(Exception):
-            index2.aliasadd("myalias")
+        res = client.ft().search(Query("Jon"))
+        if is_resp2_connection(client):
+            assert 2 == len(res.docs)
+            assert ["John", "Jon"] == sorted(d.name for d in res.docs)
+        else:
+            assert 2 == res["total_results"]
+            assert ["John", "Jon"] == sorted(
+                d["extra_attributes"]["name"] for d in res["results"]
+            )
 
-        # update the alias and ensure we get doc2
-        index2.aliasupdate("myalias")
-        alias_client2 = getClient(client).ft("myalias")
-        res = sorted(alias_client2.search("*")["results"], key=lambda x: x["id"])
-        assert "doc1" == res[0]["id"]
+    @pytest.mark.redismod
+    def test_get(self, client):
+        client.ft().create_index((TextField("f1"), TextField("f2")))
 
-    # delete the alias and expect an error if we try to query again
-    index2.aliasdel("myalias")
-    with pytest.raises(Exception):
-        _ = alias_client2.search("*").docs[0]
+        assert [None] == client.ft().get("doc1")
+        assert [None, None] == client.ft().get("doc2", "doc1")
 
+        client.hset(
+            "doc1",
+            mapping={"f1": "some valid content dd1", "f2": "this is sample text f1"},
+        )
+        client.hset(
+            "doc2",
+            mapping={"f1": "some valid content dd2", "f2": "this is sample text f2"},
+        )
 
-@pytest.mark.redismod
-def test_textfield_sortable_nostem(client):
-    # Creating the index definition with sortable and no_stem
-    client.ft().create_index((TextField("txt", sortable=True, no_stem=True),))
+        assert [
+            ["f1", "some valid content dd2", "f2", "this is sample text f2"]
+        ] == client.ft().get("doc2")
+        assert [
+            ["f1", "some valid content dd1", "f2", "this is sample text f1"],
+            ["f1", "some valid content dd2", "f2", "this is sample text f2"],
+        ] == client.ft().get("doc1", "doc2")
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.0.0", "search")
+    def test_index_definition(self, client):
+        """
+        Create definition and test its args
+        """
+        with pytest.raises(RuntimeError):
+            IndexDefinition(prefix=["hset:", "henry"], index_type="json")
+
+        definition = IndexDefinition(
+            prefix=["hset:", "henry"],
+            filter="@f1==32",
+            language="English",
+            language_field="play",
+            score_field="chapter",
+            score=0.5,
+            payload_field="txt",
+            index_type=IndexType.JSON,
+        )
 
-    # Now get the index info to confirm its contents
-    response = client.ft().info()
-    if is_resp2_connection(client):
-        assert "SORTABLE" in response["attributes"][0]
-        assert "NOSTEM" in response["attributes"][0]
-    else:
-        assert "SORTABLE" in response["attributes"][0]["flags"]
-        assert "NOSTEM" in response["attributes"][0]["flags"]
+        assert [
+            "ON",
+            "JSON",
+            "PREFIX",
+            2,
+            "hset:",
+            "henry",
+            "FILTER",
+            "@f1==32",
+            "LANGUAGE_FIELD",
+            "play",
+            "LANGUAGE",
+            "English",
+            "SCORE_FIELD",
+            "chapter",
+            "SCORE",
+            0.5,
+            "PAYLOAD_FIELD",
+            "txt",
+        ] == definition.args
+
+        self.createIndex(client.ft(), num_docs=500, definition=definition)
+
+    @pytest.mark.redismod
+    @pytest.mark.onlynoncluster
+    @skip_if_redis_enterprise()
+    @skip_if_server_version_gte("7.9.0")
+    def test_expire(self, client):
+        client.ft().create_index((TextField("txt", sortable=True),), temporary=4)
+        ttl = client.execute_command("ft.debug", "TTL", "idx")
+        assert ttl > 2
 
+        while ttl > 2:
+            ttl = client.execute_command("ft.debug", "TTL", "idx")
+            time.sleep(0.01)
 
-@pytest.mark.redismod
-def test_alter_schema_add(client):
-    # Creating the index definition and schema
-    client.ft().create_index(TextField("title"))
+    @pytest.mark.redismod
+    def test_skip_initial_scan(self, client):
+        client.hset("doc1", "foo", "bar")
+        q = Query("@foo:bar")
 
-    # Using alter to add a field
-    client.ft().alter_schema_add(TextField("body"))
+        client.ft().create_index((TextField("foo"),), skip_initial_scan=True)
+        res = client.ft().search(q)
+        if is_resp2_connection(client):
+            assert res.total == 0
+        else:
+            assert res["total_results"] == 0
 
-    # Indexing a document
-    client.hset(
-        "doc1", mapping={"title": "MyTitle", "body": "Some content only in the body"}
-    )
+    @pytest.mark.redismod
+    def test_summarize_disabled_nooffset(self, client):
+        client.ft().create_index((TextField("txt"),), no_term_offsets=True)
+        client.hset("doc1", mapping={"txt": "foo bar"})
+        with pytest.raises(Exception):
+            client.ft().search(Query("foo").summarize(fields=["txt"]))
 
-    # Searching with parameter only in the body (the added field)
-    q = Query("only in the body")
+    @pytest.mark.redismod
+    def test_summarize_disabled_nohl(self, client):
+        client.ft().create_index((TextField("txt"),), no_highlight=True)
+        client.hset("doc1", mapping={"txt": "foo bar"})
+        with pytest.raises(Exception):
+            client.ft().search(Query("foo").summarize(fields=["txt"]))
+
+    @pytest.mark.redismod
+    def test_max_text_fields(self, client):
+        # Creating the index definition
+        client.ft().create_index((TextField("f0"),))
+        for x in range(1, 32):
+            client.ft().alter_schema_add((TextField(f"f{x}"),))
+
+        # Should be too many indexes
+        with pytest.raises(redis.ResponseError):
+            client.ft().alter_schema_add((TextField(f"f{x}"),))
+
+        client.ft().dropindex()
+        # Creating the index definition
+        client.ft().create_index((TextField("f0"),), max_text_fields=True)
+        # Fill the index with fields
+        for x in range(1, 50):
+            client.ft().alter_schema_add((TextField(f"f{x}"),))
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.0.0", "search")
+    def test_create_client_definition(self, client):
+        """
+        Create definition with no index type provided,
+        and use hset to test the client definition (the default is HASH).
+        """
+        definition = IndexDefinition(prefix=["hset:", "henry"])
+        self.createIndex(client.ft(), num_docs=500, definition=definition)
 
-    # Ensure we find the result searching on the added body field
-    res = client.ft().search(q)
-    if is_resp2_connection(client):
-        assert 1 == res.total
-    else:
-        assert 1 == res["total_results"]
+        info = client.ft().info()
+        assert 494 == int(info["num_docs"])
 
+        client.ft().client.hset("hset:1", "f1", "v1")
+        info = client.ft().info()
+        assert 495 == int(info["num_docs"])
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.0.0", "search")
+    def test_create_client_definition_hash(self, client):
+        """
+        Create definition with IndexType.HASH as index type (ON HASH),
+        and use hset to test the client definition.
+        """
+        definition = IndexDefinition(
+            prefix=["hset:", "henry"], index_type=IndexType.HASH
+        )
+        self.createIndex(client.ft(), num_docs=500, definition=definition)
 
-@pytest.mark.redismod
-def test_spell_check(client):
-    client.ft().create_index((TextField("f1"), TextField("f2")))
+        info = client.ft().info()
+        assert 494 == int(info["num_docs"])
 
-    client.hset(
-        "doc1", mapping={"f1": "some valid content", "f2": "this is sample text"}
-    )
-    client.hset("doc2", mapping={"f1": "very important", "f2": "lorem ipsum"})
-    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
+        client.ft().client.hset("hset:1", "f1", "v1")
+        info = client.ft().info()
+        assert 495 == int(info["num_docs"])
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.2.0", "search")
+    def test_create_client_definition_json(self, client):
+        """
+        Create definition with IndexType.JSON as index type (ON JSON),
+        and use json client to test it.
+        """
+        definition = IndexDefinition(prefix=["king:"], index_type=IndexType.JSON)
+        client.ft().create_index((TextField("$.name"),), definition=definition)
+
+        client.json().set("king:1", Path.root_path(), {"name": "henry"})
+        client.json().set("king:2", Path.root_path(), {"name": "james"})
+
+        res = client.ft().search("henry")
+        if is_resp2_connection(client):
+            assert res.docs[0].id == "king:1"
+            assert res.docs[0].payload is None
+            assert res.docs[0].json == '{"name":"henry"}'
+            assert res.total == 1
+        else:
+            assert res["results"][0]["id"] == "king:1"
+            assert res["results"][0]["extra_attributes"]["$"] == '{"name":"henry"}'
+            assert res["total_results"] == 1
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.2.0", "search")
+    def test_fields_as_name(self, client):
+        # create index
+        SCHEMA = (
+            TextField("$.name", sortable=True, as_name="name"),
+            NumericField("$.age", as_name="just_a_number"),
+        )
+        definition = IndexDefinition(index_type=IndexType.JSON)
+        client.ft().create_index(SCHEMA, definition=definition)
 
-    if is_resp2_connection(client):
-        # test spellcheck
-        res = client.ft().spellcheck("impornant")
-        assert "important" == res["impornant"][0]["suggestion"]
-
-        res = client.ft().spellcheck("contnt")
-        assert "content" == res["contnt"][0]["suggestion"]
-
-        # test spellcheck with Levenshtein distance
-        res = client.ft().spellcheck("vlis")
-        assert res == {}
-        res = client.ft().spellcheck("vlis", distance=2)
-        assert "valid" == res["vlis"][0]["suggestion"]
-
-        # test spellcheck include
-        client.ft().dict_add("dict", "lore", "lorem", "lorm")
-        res = client.ft().spellcheck("lorm", include="dict")
-        assert len(res["lorm"]) == 3
-        assert (
-            res["lorm"][0]["suggestion"],
-            res["lorm"][1]["suggestion"],
-            res["lorm"][2]["suggestion"],
-        ) == ("lorem", "lore", "lorm")
-        assert (res["lorm"][0]["score"], res["lorm"][1]["score"]) == ("0.5", "0")
-
-        # test spellcheck exclude
-        res = client.ft().spellcheck("lorm", exclude="dict")
-        assert res == {}
-    else:
-        # test spellcheck
-        res = client.ft().spellcheck("impornant")
-        assert "important" in res["results"]["impornant"][0].keys()
-
-        res = client.ft().spellcheck("contnt")
-        assert "content" in res["results"]["contnt"][0].keys()
-
-        # test spellcheck with Levenshtein distance
-        res = client.ft().spellcheck("vlis")
-        assert res == {"results": {"vlis": []}}
-        res = client.ft().spellcheck("vlis", distance=2)
-        assert "valid" in res["results"]["vlis"][0].keys()
-
-        # test spellcheck include
-        client.ft().dict_add("dict", "lore", "lorem", "lorm")
-        res = client.ft().spellcheck("lorm", include="dict")
-        assert len(res["results"]["lorm"]) == 3
-        assert "lorem" in res["results"]["lorm"][0].keys()
-        assert "lore" in res["results"]["lorm"][1].keys()
-        assert "lorm" in res["results"]["lorm"][2].keys()
-        assert (
-            res["results"]["lorm"][0]["lorem"],
-            res["results"]["lorm"][1]["lore"],
-        ) == (0.5, 0)
-
-        # test spellcheck exclude
-        res = client.ft().spellcheck("lorm", exclude="dict")
-        assert res == {"results": {}}
-
-
-@pytest.mark.redismod
-def test_dict_operations(client):
-    client.ft().create_index((TextField("f1"), TextField("f2")))
-    # Add three items
-    res = client.ft().dict_add("custom_dict", "item1", "item2", "item3")
-    assert 3 == res
-
-    # Remove one item
-    res = client.ft().dict_del("custom_dict", "item2")
-    assert 1 == res
-
-    # Dump dict and inspect content
-    res = client.ft().dict_dump("custom_dict")
-    assert res == ["item1", "item3"]
-
-    # Remove rest of the items before reload
-    client.ft().dict_del("custom_dict", *res)
-
-
-@pytest.mark.redismod
-def test_phonetic_matcher(client):
-    client.ft().create_index((TextField("name"),))
-    client.hset("doc1", mapping={"name": "Jon"})
-    client.hset("doc2", mapping={"name": "John"})
-
-    res = client.ft().search(Query("Jon"))
-    if is_resp2_connection(client):
-        assert 1 == len(res.docs)
-        assert "Jon" == res.docs[0].name
-    else:
-        assert 1 == res["total_results"]
-        assert "Jon" == res["results"][0]["extra_attributes"]["name"]
+        # insert json data
+        res = client.json().set("doc:1", Path.root_path(), {"name": "Jon", "age": 25})
+        assert res
 
-    # Drop and create index with phonetic matcher
-    client.flushdb()
+        res = client.ft().search(Query("Jon").return_fields("name", "just_a_number"))
+        if is_resp2_connection(client):
+            assert 1 == len(res.docs)
+            assert "doc:1" == res.docs[0].id
+            assert "Jon" == res.docs[0].name
+            assert "25" == res.docs[0].just_a_number
+        else:
+            assert 1 == len(res["results"])
+            assert "doc:1" == res["results"][0]["id"]
+            assert "Jon" == res["results"][0]["extra_attributes"]["name"]
+            assert "25" == res["results"][0]["extra_attributes"]["just_a_number"]
 
-    client.ft().create_index((TextField("name", phonetic_matcher="dm:en"),))
-    client.hset("doc1", mapping={"name": "Jon"})
-    client.hset("doc2", mapping={"name": "John"})
+    @pytest.mark.redismod
+    def test_casesensitive(self, client):
+        # create index
+        SCHEMA = (TagField("t", case_sensitive=False),)
+        client.ft().create_index(SCHEMA)
+        client.ft().client.hset("1", "t", "HELLO")
+        client.ft().client.hset("2", "t", "hello")
 
-    res = client.ft().search(Query("Jon"))
-    if is_resp2_connection(client):
-        assert 2 == len(res.docs)
-        assert ["John", "Jon"] == sorted(d.name for d in res.docs)
-    else:
-        assert 2 == res["total_results"]
-        assert ["John", "Jon"] == sorted(
-            d["extra_attributes"]["name"] for d in res["results"]
-        )
-
-
-@pytest.mark.redismod
-@pytest.mark.onlynoncluster
-# NOTE(imalinovskyi): This test contains hardcoded scores valid only for RediSearch 2.8+
-@skip_ifmodversion_lt("2.8.0", "search")
-@skip_if_server_version_gte("7.9.0")
-def test_scorer(client):
-    client.ft().create_index((TextField("description"),))
-
-    client.hset(
-        "doc1", mapping={"description": "The quick brown fox jumps over the lazy dog"}
-    )
-    client.hset(
-        "doc2",
-        mapping={
-            "description": "Quick alice was beginning to get very tired of sitting by her quick sister on the bank, and of having nothing to do."  # noqa
-        },
-    )
-
-    # default scorer is TFIDF
-    if is_resp2_connection(client):
-        res = client.ft().search(Query("quick").with_scores())
-        assert 1.0 == res.docs[0].score
-        res = client.ft().search(Query("quick").scorer("TFIDF").with_scores())
-        assert 1.0 == res.docs[0].score
-        res = client.ft().search(Query("quick").scorer("TFIDF.DOCNORM").with_scores())
-        assert 0.14285714285714285 == res.docs[0].score
-        res = client.ft().search(Query("quick").scorer("BM25").with_scores())
-        assert 0.22471909420069797 == res.docs[0].score
-        res = client.ft().search(Query("quick").scorer("DISMAX").with_scores())
-        assert 2.0 == res.docs[0].score
-        res = client.ft().search(Query("quick").scorer("DOCSCORE").with_scores())
-        assert 1.0 == res.docs[0].score
-        res = client.ft().search(Query("quick").scorer("HAMMING").with_scores())
-        assert 0.0 == res.docs[0].score
-    else:
-        res = client.ft().search(Query("quick").with_scores())
-        assert 1.0 == res["results"][0]["score"]
-        res = client.ft().search(Query("quick").scorer("TFIDF").with_scores())
-        assert 1.0 == res["results"][0]["score"]
-        res = client.ft().search(Query("quick").scorer("TFIDF.DOCNORM").with_scores())
-        assert 0.14285714285714285 == res["results"][0]["score"]
-        res = client.ft().search(Query("quick").scorer("BM25").with_scores())
-        assert 0.22471909420069797 == res["results"][0]["score"]
-        res = client.ft().search(Query("quick").scorer("DISMAX").with_scores())
-        assert 2.0 == res["results"][0]["score"]
-        res = client.ft().search(Query("quick").scorer("DOCSCORE").with_scores())
-        assert 1.0 == res["results"][0]["score"]
-        res = client.ft().search(Query("quick").scorer("HAMMING").with_scores())
-        assert 0.0 == res["results"][0]["score"]
-
-
-@pytest.mark.redismod
-@pytest.mark.onlynoncluster
-@skip_if_server_version_lt("7.9.0")
-def test_scorer_with_new_default_scorer(client):
-    client.ft().create_index((TextField("description"),))
-
-    client.hset(
-        "doc1", mapping={"description": "The quick brown fox jumps over the lazy dog"}
-    )
-    client.hset(
-        "doc2",
-        mapping={
-            "description": "Quick alice was beginning to get very tired of sitting by her quick sister on the bank, and of having nothing to do."  # noqa
-        },
-    )
-
-    # default scorer is BM25STD
-    if is_resp2_connection(client):
-        res = client.ft().search(Query("quick").with_scores())
-        assert 0.23 == pytest.approx(res.docs[0].score, 0.05)
-        res = client.ft().search(Query("quick").scorer("TFIDF").with_scores())
-        assert 1.0 == res.docs[0].score
-        res = client.ft().search(Query("quick").scorer("TFIDF.DOCNORM").with_scores())
-        assert 0.14285714285714285 == res.docs[0].score
-        res = client.ft().search(Query("quick").scorer("BM25").with_scores())
-        assert 0.22471909420069797 == res.docs[0].score
-        res = client.ft().search(Query("quick").scorer("DISMAX").with_scores())
-        assert 2.0 == res.docs[0].score
-        res = client.ft().search(Query("quick").scorer("DOCSCORE").with_scores())
-        assert 1.0 == res.docs[0].score
-        res = client.ft().search(Query("quick").scorer("HAMMING").with_scores())
-        assert 0.0 == res.docs[0].score
-    else:
-        res = client.ft().search(Query("quick").with_scores())
-        assert 0.23 == pytest.approx(res["results"][0]["score"], 0.05)
-        res = client.ft().search(Query("quick").scorer("TFIDF").with_scores())
-        assert 1.0 == res["results"][0]["score"]
-        res = client.ft().search(Query("quick").scorer("TFIDF.DOCNORM").with_scores())
-        assert 0.14285714285714285 == res["results"][0]["score"]
-        res = client.ft().search(Query("quick").scorer("BM25").with_scores())
-        assert 0.22471909420069797 == res["results"][0]["score"]
-        res = client.ft().search(Query("quick").scorer("DISMAX").with_scores())
-        assert 2.0 == res["results"][0]["score"]
-        res = client.ft().search(Query("quick").scorer("DOCSCORE").with_scores())
-        assert 1.0 == res["results"][0]["score"]
-        res = client.ft().search(Query("quick").scorer("HAMMING").with_scores())
-        assert 0.0 == res["results"][0]["score"]
-
-
-@pytest.mark.redismod
-def test_get(client):
-    client.ft().create_index((TextField("f1"), TextField("f2")))
-
-    assert [None] == client.ft().get("doc1")
-    assert [None, None] == client.ft().get("doc2", "doc1")
-
-    client.hset(
-        "doc1", mapping={"f1": "some valid content dd1", "f2": "this is sample text f1"}
-    )
-    client.hset(
-        "doc2", mapping={"f1": "some valid content dd2", "f2": "this is sample text f2"}
-    )
-
-    assert [
-        ["f1", "some valid content dd2", "f2", "this is sample text f2"]
-    ] == client.ft().get("doc2")
-    assert [
-        ["f1", "some valid content dd1", "f2", "this is sample text f1"],
-        ["f1", "some valid content dd2", "f2", "this is sample text f2"],
-    ] == client.ft().get("doc1", "doc2")
-
-
-@pytest.mark.redismod
-@pytest.mark.onlynoncluster
-@skip_ifmodversion_lt("2.2.0", "search")
-@skip_if_server_version_gte("7.9.0")
-def test_config(client):
-    assert client.ft().config_set("TIMEOUT", "100")
-    with pytest.raises(redis.ResponseError):
-        client.ft().config_set("TIMEOUT", "null")
-    res = client.ft().config_get("*")
-    assert "100" == res["TIMEOUT"]
-    res = client.ft().config_get("TIMEOUT")
-    assert "100" == res["TIMEOUT"]
-
-
-@pytest.mark.redismod
-@pytest.mark.onlynoncluster
-@skip_if_server_version_lt("7.9.0")
-def test_config_with_removed_ftconfig(client):
-    assert client.config_set("timeout", "100")
-    with pytest.raises(redis.ResponseError):
-        client.config_set("timeout", "null")
-    res = client.config_get("*")
-    assert "100" == res["timeout"]
-    res = client.config_get("timeout")
-    assert "100" == res["timeout"]
-
-
-@pytest.mark.redismod
-@pytest.mark.onlynoncluster
-def test_aggregations_groupby(client):
-    # Creating the index definition and schema
-    client.ft().create_index(
-        (
-            NumericField("random_num"),
-            TextField("title"),
-            TextField("body"),
-            TextField("parent"),
-        )
-    )
-
-    # Indexing a document
-    client.hset(
-        "search",
-        mapping={
-            "title": "RediSearch",
-            "body": "Redisearch impements a search engine on top of redis",
-            "parent": "redis",
-            "random_num": 10,
-        },
-    )
-    client.hset(
-        "ai",
-        mapping={
-            "title": "RedisAI",
-            "body": "RedisAI executes Deep Learning/Machine Learning models and managing their data.",  # noqa
-            "parent": "redis",
-            "random_num": 3,
-        },
-    )
-    client.hset(
-        "json",
-        mapping={
-            "title": "RedisJson",
-            "body": "RedisJSON implements ECMA-404 The JSON Data Interchange Standard as a native data type.",  # noqa
-            "parent": "redis",
-            "random_num": 8,
-        },
-    )
+        res = client.ft().search("@t:{HELLO}")
 
-    if is_resp2_connection(client):
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.count()
-        )
+        if is_resp2_connection(client):
+            assert 2 == len(res.docs)
+            assert "1" == res.docs[0].id
+            assert "2" == res.docs[1].id
+        else:
+            assert 2 == len(res["results"])
+            assert "1" == res["results"][0]["id"]
+            assert "2" == res["results"][1]["id"]
 
-        res = client.ft().aggregate(req).rows[0]
-        assert res[1] == "redis"
-        assert res[3] == "3"
+        # create casesensitive index
+        client.ft().dropindex()
+        SCHEMA = (TagField("t", case_sensitive=True),)
+        client.ft().create_index(SCHEMA)
+        self.waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.count_distinct("@title")
+        res = client.ft().search("@t:{HELLO}")
+        if is_resp2_connection(client):
+            assert 1 == len(res.docs)
+            assert "1" == res.docs[0].id
+        else:
+            assert 1 == len(res["results"])
+            assert "1" == res["results"][0]["id"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.2.0", "search")
+    def test_search_return_fields(self, client):
+        res = client.json().set(
+            "doc:1",
+            Path.root_path(),
+            {"t": "riceratops", "t2": "telmatosaurus", "n": 9072, "flt": 97.2},
         )
+        assert res
 
-        res = client.ft().aggregate(req).rows[0]
-        assert res[1] == "redis"
-        assert res[3] == "3"
+        # create index on
+        definition = IndexDefinition(index_type=IndexType.JSON)
+        SCHEMA = (TextField("$.t"), NumericField("$.flt"))
+        client.ft().create_index(SCHEMA, definition=definition)
+        self.waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
 
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.count_distinctish("@title")
-        )
+        if is_resp2_connection(client):
+            total = (
+                client.ft().search(Query("*").return_field("$.t", as_field="txt")).docs
+            )
+            assert 1 == len(total)
+            assert "doc:1" == total[0].id
+            assert "riceratops" == total[0].txt
 
-        res = client.ft().aggregate(req).rows[0]
-        assert res[1] == "redis"
-        assert res[3] == "3"
+            total = (
+                client.ft().search(Query("*").return_field("$.t2", as_field="txt")).docs
+            )
+            assert 1 == len(total)
+            assert "doc:1" == total[0].id
+            assert "telmatosaurus" == total[0].txt
+        else:
+            total = client.ft().search(Query("*").return_field("$.t", as_field="txt"))
+            assert 1 == len(total["results"])
+            assert "doc:1" == total["results"][0]["id"]
+            assert "riceratops" == total["results"][0]["extra_attributes"]["txt"]
+
+            total = client.ft().search(Query("*").return_field("$.t2", as_field="txt"))
+            assert 1 == len(total["results"])
+            assert "doc:1" == total["results"][0]["id"]
+            assert "telmatosaurus" == total["results"][0]["extra_attributes"]["txt"]
+
+    @pytest.mark.redismod
+    @skip_if_resp_version(3)
+    def test_binary_and_text_fields(self, client):
+        fake_vec = np.array([0.1, 0.2, 0.3, 0.4], dtype=np.float32)
+
+        index_name = "mixed_index"
+        mixed_data = {"first_name": "🐍python", "vector_emb": fake_vec.tobytes()}
+        client.hset(f"{index_name}:1", mapping=mixed_data)
+
+        schema = (
+            TagField("first_name"),
+            VectorField(
+                "embeddings_bio",
+                algorithm="HNSW",
+                attributes={
+                    "TYPE": "FLOAT32",
+                    "DIM": 4,
+                    "DISTANCE_METRIC": "COSINE",
+                },
+            ),
+        )
 
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.sum("@random_num")
+        client.ft(index_name).create_index(
+            fields=schema,
+            definition=IndexDefinition(
+                prefix=[f"{index_name}:"], index_type=IndexType.HASH
+            ),
         )
 
-        res = client.ft().aggregate(req).rows[0]
-        assert res[1] == "redis"
-        assert res[3] == "21"  # 10+8+3
+        self.waitForIndex(client, index_name)
 
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.min("@random_num")
+        query = (
+            Query("*")
+            .return_field("vector_emb", decode_field=False)
+            .return_field("first_name")
+        )
+        docs = client.ft(index_name).search(query=query, query_params={}).docs
+        decoded_vec_from_search_results = np.frombuffer(
+            docs[0]["vector_emb"], dtype=np.float32
         )
 
-        res = client.ft().aggregate(req).rows[0]
-        assert res[1] == "redis"
-        assert res[3] == "3"  # min(10,8,3)
-
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.max("@random_num")
+        assert np.array_equal(decoded_vec_from_search_results, fake_vec), (
+            "The vectors are not equal"
         )
 
-        res = client.ft().aggregate(req).rows[0]
-        assert res[1] == "redis"
-        assert res[3] == "10"  # max(10,8,3)
+        assert docs[0]["first_name"] == mixed_data["first_name"], (
+            "The text field is not decoded correctly"
+        )
 
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.avg("@random_num")
+    @pytest.mark.redismod
+    def test_synupdate(self, client):
+        definition = IndexDefinition(index_type=IndexType.HASH)
+        client.ft().create_index(
+            (TextField("title"), TextField("body")), definition=definition
         )
 
-        res = client.ft().aggregate(req).rows[0]
-        assert res[1] == "redis"
-        index = res.index("__generated_aliasavgrandom_num")
-        assert res[index + 1] == "7"  # (10+3+8)/3
+        client.ft().synupdate("id1", True, "boy", "child", "offspring")
+        client.hset("doc1", mapping={"title": "he is a baby", "body": "this is a test"})
 
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.stddev("random_num")
+        client.ft().synupdate("id1", True, "baby")
+        client.hset(
+            "doc2", mapping={"title": "he is another baby", "body": "another test"}
         )
 
-        res = client.ft().aggregate(req).rows[0]
-        assert res[1] == "redis"
-        assert res[3] == "3.60555127546"
+        res = client.ft().search(Query("child").expander("SYNONYM"))
+        if is_resp2_connection(client):
+            assert res.docs[0].id == "doc2"
+            assert res.docs[0].title == "he is another baby"
+            assert res.docs[0].body == "another test"
+        else:
+            assert res["results"][0]["id"] == "doc2"
+            assert (
+                res["results"][0]["extra_attributes"]["title"] == "he is another baby"
+            )
+            assert res["results"][0]["extra_attributes"]["body"] == "another test"
 
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.quantile("@random_num", 0.5)
+    @pytest.mark.redismod
+    def test_syndump(self, client):
+        definition = IndexDefinition(index_type=IndexType.HASH)
+        client.ft().create_index(
+            (TextField("title"), TextField("body")), definition=definition
         )
 
-        res = client.ft().aggregate(req).rows[0]
-        assert res[1] == "redis"
-        assert res[3] == "8"  # median of 3,8,10
+        client.ft().synupdate("id1", False, "boy", "child", "offspring")
+        client.ft().synupdate("id2", False, "baby", "child")
+        client.ft().synupdate("id3", False, "tree", "wood")
+        res = client.ft().syndump()
+        assert res == {
+            "boy": ["id1"],
+            "tree": ["id3"],
+            "wood": ["id3"],
+            "child": ["id1", "id2"],
+            "baby": ["id2"],
+            "offspring": ["id1"],
+        }
 
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.tolist("@title")
-        )
+    @pytest.mark.redismod
+    def test_expire_while_search(self, client: redis.Redis):
+        client.ft().create_index((TextField("txt"),))
+        client.hset("hset:1", "txt", "a")
+        client.hset("hset:2", "txt", "b")
+        client.hset("hset:3", "txt", "c")
+        if is_resp2_connection(client):
+            assert 3 == client.ft().search(Query("*")).total
+            client.pexpire("hset:2", 300)
+            for _ in range(500):
+                client.ft().search(Query("*")).docs[1]
+            time.sleep(1)
+            assert 2 == client.ft().search(Query("*")).total
+        else:
+            assert 3 == client.ft().search(Query("*"))["total_results"]
+            client.pexpire("hset:2", 300)
+            for _ in range(500):
+                client.ft().search(Query("*"))["results"][1]
+            time.sleep(1)
+            assert 2 == client.ft().search(Query("*"))["total_results"]
+
+    @pytest.mark.redismod
+    @pytest.mark.experimental
+    def test_withsuffixtrie(self, client: redis.Redis):
+        # create index
+        assert client.ft().create_index((TextField("txt"),))
+        self.waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
+        if is_resp2_connection(client):
+            info = client.ft().info()
+            assert "WITHSUFFIXTRIE" not in info["attributes"][0]
+            assert client.ft().dropindex()
+
+            # create withsuffixtrie index (text fields)
+            assert client.ft().create_index(TextField("t", withsuffixtrie=True))
+            self.waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
+            info = client.ft().info()
+            assert "WITHSUFFIXTRIE" in info["attributes"][0]
+            assert client.ft().dropindex()
+
+            # create withsuffixtrie index (tag field)
+            assert client.ft().create_index(TagField("t", withsuffixtrie=True))
+            self.waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
+            info = client.ft().info()
+            assert "WITHSUFFIXTRIE" in info["attributes"][0]
+        else:
+            info = client.ft().info()
+            assert "WITHSUFFIXTRIE" not in info["attributes"][0]["flags"]
+            assert client.ft().dropindex()
+
+            # create withsuffixtrie index (text fields)
+            assert client.ft().create_index(TextField("t", withsuffixtrie=True))
+            self.waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
+            info = client.ft().info()
+            assert "WITHSUFFIXTRIE" in info["attributes"][0]["flags"]
+            assert client.ft().dropindex()
+
+            # create withsuffixtrie index (tag field)
+            assert client.ft().create_index(TagField("t", withsuffixtrie=True))
+            self.waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
+            info = client.ft().info()
+            assert "WITHSUFFIXTRIE" in info["attributes"][0]["flags"]
+
+    @pytest.mark.redismod
+    def test_query_timeout(self, r: redis.Redis):
+        q1 = Query("foo").timeout(5000)
+        assert q1.get_args() == ["foo", "TIMEOUT", 5000, "DIALECT", 2, "LIMIT", 0, 10]
+        q1 = Query("foo").timeout(0)
+        assert q1.get_args() == ["foo", "TIMEOUT", 0, "DIALECT", 2, "LIMIT", 0, 10]
+        q2 = Query("foo").timeout("not_a_number")
+        with pytest.raises(redis.ResponseError):
+            r.ft().search(q2)
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.2.0")
+    @skip_ifmodversion_lt("2.8.4", "search")
+    def test_geoshape(self, client: redis.Redis):
+        client.ft().create_index(GeoShapeField("geom", GeoShapeField.FLAT))
+        self.waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
+        client.hset("small", "geom", "POLYGON((1 1, 1 100, 100 100, 100 1, 1 1))")
+        client.hset("large", "geom", "POLYGON((1 1, 1 200, 200 200, 200 1, 1 1))")
+        q1 = Query("@geom:[WITHIN $poly]").dialect(3)
+        qp1 = {"poly": "POLYGON((0 0, 0 150, 150 150, 150 0, 0 0))"}
+        q2 = Query("@geom:[CONTAINS $poly]").dialect(3)
+        qp2 = {"poly": "POLYGON((2 2, 2 50, 50 50, 50 2, 2 2))"}
+        result = client.ft().search(q1, query_params=qp1)
+        _assert_search_result(client, result, ["small"])
+        result = client.ft().search(q2, query_params=qp2)
+        _assert_search_result(client, result, ["small", "large"])
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.4.0")
+    @skip_ifmodversion_lt("2.10.0", "search")
+    def test_search_missing_fields(self, client):
+        definition = IndexDefinition(prefix=["property:"], index_type=IndexType.HASH)
+
+        fields = [
+            TextField("title", sortable=True),
+            TagField("features", index_missing=True),
+            TextField("description", index_missing=True),
+        ]
 
-        res = client.ft().aggregate(req).rows[0]
-        assert res[1] == "redis"
-        assert set(res[3]) == {"RediSearch", "RedisAI", "RedisJson"}
+        client.ft().create_index(fields, definition=definition)
 
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.first_value("@title").alias("first")
+        # All fields present
+        client.hset(
+            "property:1",
+            mapping={
+                "title": "Luxury Villa in Malibu",
+                "features": "pool,sea view,modern",
+                "description": "A stunning modern villa overlooking the Pacific Ocean.",
+            },
         )
 
-        res = client.ft().aggregate(req).rows[0]
-        assert res == ["parent", "redis", "first", "RediSearch"]
-
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.random_sample("@title", 2).alias("random")
+        # Missing features
+        client.hset(
+            "property:2",
+            mapping={
+                "title": "Downtown Flat",
+                "description": "Modern flat in central Paris with easy access to metro.",
+            },
         )
 
-        res = client.ft().aggregate(req).rows[0]
-        assert res[1] == "redis"
-        assert res[2] == "random"
-        assert len(res[3]) == 2
-        assert res[3][0] in ["RediSearch", "RedisAI", "RedisJson"]
-    else:
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.count()
+        # Missing description
+        client.hset(
+            "property:3",
+            mapping={
+                "title": "Beachfront Bungalow",
+                "features": "beachfront,sun deck",
+            },
         )
 
-        res = client.ft().aggregate(req)["results"][0]
-        assert res["extra_attributes"]["parent"] == "redis"
-        assert res["extra_attributes"]["__generated_aliascount"] == "3"
+        with pytest.raises(redis.exceptions.ResponseError):
+            client.ft().search(
+                Query("ismissing(@title)").return_field("id").no_content()
+            )
 
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.count_distinct("@title")
+        res = client.ft().search(
+            Query("ismissing(@features)").return_field("id").no_content()
         )
+        _assert_search_result(client, res, ["property:2"])
 
-        res = client.ft().aggregate(req)["results"][0]
-        assert res["extra_attributes"]["parent"] == "redis"
-        assert res["extra_attributes"]["__generated_aliascount_distincttitle"] == "3"
-
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.count_distinctish("@title")
+        res = client.ft().search(
+            Query("-ismissing(@features)").return_field("id").no_content()
         )
+        _assert_search_result(client, res, ["property:1", "property:3"])
 
-        res = client.ft().aggregate(req)["results"][0]
-        assert res["extra_attributes"]["parent"] == "redis"
-        assert res["extra_attributes"]["__generated_aliascount_distinctishtitle"] == "3"
+        res = client.ft().search(
+            Query("ismissing(@description)").return_field("id").no_content()
+        )
+        _assert_search_result(client, res, ["property:3"])
 
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.sum("@random_num")
+        res = client.ft().search(
+            Query("-ismissing(@description)").return_field("id").no_content()
         )
+        _assert_search_result(client, res, ["property:1", "property:2"])
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.4.0")
+    @skip_ifmodversion_lt("2.10.0", "search")
+    def test_create_index_empty_or_missing_fields_with_sortable(self, client):
+        definition = IndexDefinition(prefix=["property:"], index_type=IndexType.HASH)
+
+        fields = [
+            TextField("title", sortable=True, index_empty=True),
+            TagField("features", index_missing=True, sortable=True),
+            TextField("description", no_index=True, sortable=True),
+        ]
 
-        res = client.ft().aggregate(req)["results"][0]
-        assert res["extra_attributes"]["parent"] == "redis"
-        assert res["extra_attributes"]["__generated_aliassumrandom_num"] == "21"
+        client.ft().create_index(fields, definition=definition)
 
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.min("@random_num")
-        )
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.4.0")
+    @skip_ifmodversion_lt("2.10.0", "search")
+    def test_search_empty_fields(self, client):
+        definition = IndexDefinition(prefix=["property:"], index_type=IndexType.HASH)
+
+        fields = [
+            TextField("title", sortable=True),
+            TagField("features", index_empty=True),
+            TextField("description", index_empty=True),
+        ]
 
-        res = client.ft().aggregate(req)["results"][0]
-        assert res["extra_attributes"]["parent"] == "redis"
-        assert res["extra_attributes"]["__generated_aliasminrandom_num"] == "3"
+        client.ft().create_index(fields, definition=definition)
 
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.max("@random_num")
+        # All fields present
+        client.hset(
+            "property:1",
+            mapping={
+                "title": "Luxury Villa in Malibu",
+                "features": "pool,sea view,modern",
+                "description": "A stunning modern villa overlooking the Pacific Ocean.",
+            },
         )
 
-        res = client.ft().aggregate(req)["results"][0]
-        assert res["extra_attributes"]["parent"] == "redis"
-        assert res["extra_attributes"]["__generated_aliasmaxrandom_num"] == "10"
+        # Empty features
+        client.hset(
+            "property:2",
+            mapping={
+                "title": "Downtown Flat",
+                "features": "",
+                "description": "Modern flat in central Paris with easy access to metro.",
+            },
+        )
 
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.avg("@random_num")
+        # Empty description
+        client.hset(
+            "property:3",
+            mapping={
+                "title": "Beachfront Bungalow",
+                "features": "beachfront,sun deck",
+                "description": "",
+            },
         )
 
-        res = client.ft().aggregate(req)["results"][0]
-        assert res["extra_attributes"]["parent"] == "redis"
-        assert res["extra_attributes"]["__generated_aliasavgrandom_num"] == "7"
+        with pytest.raises(redis.exceptions.ResponseError) as e:
+            client.ft().search(Query("@title:''").return_field("id").no_content())
+        assert "Use `INDEXEMPTY` in field creation" in e.value.args[0]
 
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.stddev("random_num")
+        res = client.ft().search(
+            Query("@features:{$empty}").return_field("id").no_content(),
+            query_params={"empty": ""},
         )
+        _assert_search_result(client, res, ["property:2"])
 
-        res = client.ft().aggregate(req)["results"][0]
-        assert res["extra_attributes"]["parent"] == "redis"
-        assert (
-            res["extra_attributes"]["__generated_aliasstddevrandom_num"]
-            == "3.60555127546"
+        res = client.ft().search(
+            Query("-@features:{$empty}").return_field("id").no_content(),
+            query_params={"empty": ""},
         )
+        _assert_search_result(client, res, ["property:1", "property:3"])
 
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.quantile("@random_num", 0.5)
+        res = client.ft().search(
+            Query("@description:''").return_field("id").no_content()
         )
+        _assert_search_result(client, res, ["property:3"])
 
-        res = client.ft().aggregate(req)["results"][0]
-        assert res["extra_attributes"]["parent"] == "redis"
-        assert res["extra_attributes"]["__generated_aliasquantilerandom_num,0.5"] == "8"
-
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.tolist("@title")
+        res = client.ft().search(
+            Query("-@description:''").return_field("id").no_content()
         )
+        _assert_search_result(client, res, ["property:1", "property:2"])
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.4.0")
+    @skip_ifmodversion_lt("2.10.0", "search")
+    def test_special_characters_in_fields(self, client):
+        definition = IndexDefinition(prefix=["resource:"], index_type=IndexType.HASH)
+
+        fields = [
+            TagField("uuid"),
+            TagField("tags", separator="|"),
+            TextField("description"),
+            NumericField("rating"),
+        ]
 
-        res = client.ft().aggregate(req)["results"][0]
-        assert res["extra_attributes"]["parent"] == "redis"
-        assert set(res["extra_attributes"]["__generated_aliastolisttitle"]) == {
-            "RediSearch",
-            "RedisAI",
-            "RedisJson",
-        }
+        client.ft().create_index(fields, definition=definition)
 
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.first_value("@title").alias("first")
+        client.hset(
+            "resource:1",
+            mapping={
+                "uuid": "123e4567-e89b-12d3-a456-426614174000",
+                "tags": "finance|crypto|$btc|blockchain",
+                "description": "Analysis of blockchain technologies & Bitcoin's potential.",
+                "rating": 5,
+            },
         )
 
-        res = client.ft().aggregate(req)["results"][0]
-        assert res["extra_attributes"] == {"parent": "redis", "first": "RediSearch"}
+        client.hset(
+            "resource:2",
+            mapping={
+                "uuid": "987e6543-e21c-12d3-a456-426614174999",
+                "tags": "health|well-being|fitness|new-year's-resolutions",
+                "description": "Health trends for the new year, including fitness regimes.",
+                "rating": 4,
+            },
+        )
 
-        req = aggregations.AggregateRequest("redis").group_by(
-            "@parent", reducers.random_sample("@title", 2).alias("random")
+        # no need to escape - when using params
+        res = client.ft().search(
+            Query("@uuid:{$uuid}"),
+            query_params={"uuid": "123e4567-e89b-12d3-a456-426614174000"},
         )
+        _assert_search_result(client, res, ["resource:1"])
 
-        res = client.ft().aggregate(req)["results"][0]
-        assert res["extra_attributes"]["parent"] == "redis"
-        assert "random" in res["extra_attributes"].keys()
-        assert len(res["extra_attributes"]["random"]) == 2
-        assert res["extra_attributes"]["random"][0] in [
-            "RediSearch",
-            "RedisAI",
-            "RedisJson",
-        ]
+        # with double quotes exact match no need to escape the - even without params
+        res = client.ft().search(
+            Query('@uuid:{"123e4567-e89b-12d3-a456-426614174000"}')
+        )
+        _assert_search_result(client, res, ["resource:1"])
+
+        res = client.ft().search(Query('@tags:{"new-year\'s-resolutions"}'))
+        _assert_search_result(client, res, ["resource:2"])
+
+        # possible to search numeric fields by single value
+        res = client.ft().search(Query("@rating:[4]"))
+        _assert_search_result(client, res, ["resource:2"])
+
+        # some chars still need escaping
+        res = client.ft().search(Query(r"@tags:{\$btc}"))
+        _assert_search_result(client, res, ["resource:1"])
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    def test_vector_search_with_default_dialect(self, client):
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v", "HNSW", {"TYPE": "FLOAT32", "DIM": 2, "DISTANCE_METRIC": "L2"}
+                ),
+            )
+        )
 
+        client.hset("a", "v", "aaaaaaaa")
+        client.hset("b", "v", "aaaabaaa")
+        client.hset("c", "v", "aaaaabaa")
 
-@pytest.mark.redismod
-def test_aggregations_sort_by_and_limit(client):
-    client.ft().create_index((TextField("t1"), TextField("t2")))
+        query = "*=>[KNN 2 @v $vec]"
+        q = Query(query)
 
-    client.ft().client.hset("doc1", mapping={"t1": "a", "t2": "b"})
-    client.ft().client.hset("doc2", mapping={"t1": "b", "t2": "a"})
+        assert "DIALECT" in q.get_args()
+        assert 2 in q.get_args()
 
-    if is_resp2_connection(client):
-        # test sort_by using SortDirection
-        req = aggregations.AggregateRequest("*").sort_by(
-            aggregations.Asc("@t2"), aggregations.Desc("@t1")
+        res = client.ft().search(q, query_params={"vec": "aaaaaaaa"})
+        if is_resp2_connection(client):
+            assert res.total == 2
+        else:
+            assert res["total_results"] == 2
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    def test_search_query_with_different_dialects(self, client):
+        client.ft().create_index(
+            (TextField("name"), TextField("lastname")),
+            definition=IndexDefinition(prefix=["test:"]),
         )
-        res = client.ft().aggregate(req)
-        assert res.rows[0] == ["t2", "a", "t1", "b"]
-        assert res.rows[1] == ["t2", "b", "t1", "a"]
-
-        # test sort_by without SortDirection
-        req = aggregations.AggregateRequest("*").sort_by("@t1")
-        res = client.ft().aggregate(req)
-        assert res.rows[0] == ["t1", "a"]
-        assert res.rows[1] == ["t1", "b"]
 
-        # test sort_by with max
-        req = aggregations.AggregateRequest("*").sort_by("@t1", max=1)
-        res = client.ft().aggregate(req)
-        assert len(res.rows) == 1
+        client.hset("test:1", "name", "James")
+        client.hset("test:1", "lastname", "Brown")
 
-        # test limit
-        req = aggregations.AggregateRequest("*").sort_by("@t1").limit(1, 1)
-        res = client.ft().aggregate(req)
-        assert len(res.rows) == 1
-        assert res.rows[0] == ["t1", "b"]
-    else:
-        # test sort_by using SortDirection
-        req = aggregations.AggregateRequest("*").sort_by(
-            aggregations.Asc("@t2"), aggregations.Desc("@t1")
-        )
-        res = client.ft().aggregate(req)["results"]
-        assert res[0]["extra_attributes"] == {"t2": "a", "t1": "b"}
-        assert res[1]["extra_attributes"] == {"t2": "b", "t1": "a"}
-
-        # test sort_by without SortDirection
-        req = aggregations.AggregateRequest("*").sort_by("@t1")
-        res = client.ft().aggregate(req)["results"]
-        assert res[0]["extra_attributes"] == {"t1": "a"}
-        assert res[1]["extra_attributes"] == {"t1": "b"}
-
-        # test sort_by with max
-        req = aggregations.AggregateRequest("*").sort_by("@t1", max=1)
-        res = client.ft().aggregate(req)
-        assert len(res["results"]) == 1
+        # Query with default DIALECT 2
+        query = "@name: James Brown"
+        q = Query(query)
+        res = client.ft().search(q)
+        if is_resp2_connection(client):
+            assert res.total == 1
+        else:
+            assert res["total_results"] == 1
 
-        # test limit
-        req = aggregations.AggregateRequest("*").sort_by("@t1").limit(1, 1)
-        res = client.ft().aggregate(req)
-        assert len(res["results"]) == 1
-        assert res["results"][0]["extra_attributes"] == {"t1": "b"}
+        # Query with explicit DIALECT 1
+        query = "@name: James Brown"
+        q = Query(query).dialect(1)
+        res = client.ft().search(q)
+        if is_resp2_connection(client):
+            assert res.total == 0
+        else:
+            assert res["total_results"] == 0
 
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.9.0")
+    def test_info_exposes_search_info(self, client):
+        assert len(client.info("search")) > 0
 
-@pytest.mark.redismod
-def test_aggregations_load(client):
-    client.ft().create_index((TextField("t1"), TextField("t2")))
 
-    client.ft().client.hset("doc1", mapping={"t1": "hello", "t2": "world"})
+class TestScorers(SearchTestsBase):
+    @pytest.mark.redismod
+    @pytest.mark.onlynoncluster
+    # NOTE(imalinovskyi): This test contains hardcoded scores valid only for RediSearch 2.8+
+    @skip_ifmodversion_lt("2.8.0", "search")
+    @skip_if_server_version_gte("7.9.0")
+    def test_scorer(self, client):
+        client.ft().create_index((TextField("description"),))
 
-    if is_resp2_connection(client):
-        # load t1
-        req = aggregations.AggregateRequest("*").load("t1")
-        res = client.ft().aggregate(req)
-        assert res.rows[0] == ["t1", "hello"]
+        client.hset(
+            "doc1",
+            mapping={"description": "The quick brown fox jumps over the lazy dog"},
+        )
+        client.hset(
+            "doc2",
+            mapping={
+                "description": "Quick alice was beginning to get very tired of sitting by her quick sister on the bank, and of having nothing to do."  # noqa
+            },
+        )
 
-        # load t2
-        req = aggregations.AggregateRequest("*").load("t2")
-        res = client.ft().aggregate(req)
-        assert res.rows[0] == ["t2", "world"]
+        # default scorer is TFIDF
+        if is_resp2_connection(client):
+            res = client.ft().search(Query("quick").with_scores())
+            assert 1.0 == res.docs[0].score
+            res = client.ft().search(Query("quick").scorer("TFIDF").with_scores())
+            assert 1.0 == res.docs[0].score
+            res = client.ft().search(
+                Query("quick").scorer("TFIDF.DOCNORM").with_scores()
+            )
+            assert 0.14285714285714285 == res.docs[0].score
+            res = client.ft().search(Query("quick").scorer("BM25").with_scores())
+            assert 0.22471909420069797 == res.docs[0].score
+            res = client.ft().search(Query("quick").scorer("DISMAX").with_scores())
+            assert 2.0 == res.docs[0].score
+            res = client.ft().search(Query("quick").scorer("DOCSCORE").with_scores())
+            assert 1.0 == res.docs[0].score
+            res = client.ft().search(Query("quick").scorer("HAMMING").with_scores())
+            assert 0.0 == res.docs[0].score
+        else:
+            res = client.ft().search(Query("quick").with_scores())
+            assert 1.0 == res["results"][0]["score"]
+            res = client.ft().search(Query("quick").scorer("TFIDF").with_scores())
+            assert 1.0 == res["results"][0]["score"]
+            res = client.ft().search(
+                Query("quick").scorer("TFIDF.DOCNORM").with_scores()
+            )
+            assert 0.14285714285714285 == res["results"][0]["score"]
+            res = client.ft().search(Query("quick").scorer("BM25").with_scores())
+            assert 0.22471909420069797 == res["results"][0]["score"]
+            res = client.ft().search(Query("quick").scorer("DISMAX").with_scores())
+            assert 2.0 == res["results"][0]["score"]
+            res = client.ft().search(Query("quick").scorer("DOCSCORE").with_scores())
+            assert 1.0 == res["results"][0]["score"]
+            res = client.ft().search(Query("quick").scorer("HAMMING").with_scores())
+            assert 0.0 == res["results"][0]["score"]
+
+    @pytest.mark.redismod
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("7.9.0")
+    def test_scorer_with_new_default_scorer(self, client):
+        client.ft().create_index((TextField("description"),))
 
-        # load all
-        req = aggregations.AggregateRequest("*").load()
-        res = client.ft().aggregate(req)
-        assert res.rows[0] == ["t1", "hello", "t2", "world"]
-    else:
-        # load t1
-        req = aggregations.AggregateRequest("*").load("t1")
-        res = client.ft().aggregate(req)
-        assert res["results"][0]["extra_attributes"] == {"t1": "hello"}
+        client.hset(
+            "doc1",
+            mapping={"description": "The quick brown fox jumps over the lazy dog"},
+        )
+        client.hset(
+            "doc2",
+            mapping={
+                "description": "Quick alice was beginning to get very tired of sitting by her quick sister on the bank, and of having nothing to do."  # noqa
+            },
+        )
 
-        # load t2
-        req = aggregations.AggregateRequest("*").load("t2")
-        res = client.ft().aggregate(req)
-        assert res["results"][0]["extra_attributes"] == {"t2": "world"}
+        # default scorer is BM25STD
+        if is_resp2_connection(client):
+            res = client.ft().search(Query("quick").with_scores())
+            assert 0.23 == pytest.approx(res.docs[0].score, 0.05)
+            res = client.ft().search(Query("quick").scorer("TFIDF").with_scores())
+            assert 1.0 == res.docs[0].score
+            res = client.ft().search(
+                Query("quick").scorer("TFIDF.DOCNORM").with_scores()
+            )
+            assert 0.14285714285714285 == res.docs[0].score
+            res = client.ft().search(Query("quick").scorer("BM25").with_scores())
+            assert 0.22471909420069797 == res.docs[0].score
+            res = client.ft().search(Query("quick").scorer("DISMAX").with_scores())
+            assert 2.0 == res.docs[0].score
+            res = client.ft().search(Query("quick").scorer("DOCSCORE").with_scores())
+            assert 1.0 == res.docs[0].score
+            res = client.ft().search(Query("quick").scorer("HAMMING").with_scores())
+            assert 0.0 == res.docs[0].score
+        else:
+            res = client.ft().search(Query("quick").with_scores())
+            assert 0.23 == pytest.approx(res["results"][0]["score"], 0.05)
+            res = client.ft().search(Query("quick").scorer("TFIDF").with_scores())
+            assert 1.0 == res["results"][0]["score"]
+            res = client.ft().search(
+                Query("quick").scorer("TFIDF.DOCNORM").with_scores()
+            )
+            assert 0.14285714285714285 == res["results"][0]["score"]
+            res = client.ft().search(Query("quick").scorer("BM25").with_scores())
+            assert 0.22471909420069797 == res["results"][0]["score"]
+            res = client.ft().search(Query("quick").scorer("DISMAX").with_scores())
+            assert 2.0 == res["results"][0]["score"]
+            res = client.ft().search(Query("quick").scorer("DOCSCORE").with_scores())
+            assert 1.0 == res["results"][0]["score"]
+            res = client.ft().search(Query("quick").scorer("HAMMING").with_scores())
+            assert 0.0 == res["results"][0]["score"]
+
+
+class TestConfig(SearchTestsBase):
+    @pytest.mark.redismod
+    @pytest.mark.onlynoncluster
+    @skip_ifmodversion_lt("2.2.0", "search")
+    @skip_if_server_version_gte("7.9.0")
+    def test_config(self, client):
+        assert client.ft().config_set("TIMEOUT", "100")
+        with pytest.raises(redis.ResponseError):
+            client.ft().config_set("TIMEOUT", "null")
+        res = client.ft().config_get("*")
+        assert "100" == res["TIMEOUT"]
+        res = client.ft().config_get("TIMEOUT")
+        assert "100" == res["TIMEOUT"]
+
+    @pytest.mark.redismod
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_lt("7.9.0")
+    def test_config_with_removed_ftconfig(self, client):
+        assert client.config_set("timeout", "100")
+        with pytest.raises(redis.ResponseError):
+            client.config_set("timeout", "null")
+        res = client.config_get("*")
+        assert "100" == res["timeout"]
+        res = client.config_get("timeout")
+        assert "100" == res["timeout"]
+
+    @pytest.mark.redismod
+    @pytest.mark.onlynoncluster
+    @skip_ifmodversion_lt("2.4.3", "search")
+    def test_dialect_config(self, client):
+        assert client.ft().config_get("DEFAULT_DIALECT")
+        client.ft().config_set("DEFAULT_DIALECT", 2)
+        assert client.ft().config_get("DEFAULT_DIALECT") == {"DEFAULT_DIALECT": "2"}
+        with pytest.raises(redis.ResponseError):
+            client.ft().config_set("DEFAULT_DIALECT", 0)
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    def test_dialect(self, client):
+        client.ft().create_index(
+            (
+                TagField("title"),
+                TextField("t1"),
+                TextField("t2"),
+                NumericField("num"),
+                VectorField(
+                    "v",
+                    "HNSW",
+                    {"TYPE": "FLOAT32", "DIM": 1, "DISTANCE_METRIC": "COSINE"},
+                ),
+            )
+        )
+        client.hset("h", "t1", "hello")
+        with pytest.raises(redis.ResponseError) as err:
+            client.ft().explain(Query("(*)").dialect(1))
+        assert "Syntax error" in str(err)
+        assert "WILDCARD" in client.ft().explain(Query("(*)"))
+
+        with pytest.raises(redis.ResponseError) as err:
+            client.ft().explain(Query("$hello").dialect(1))
+        assert "Syntax error" in str(err)
+        q = Query("$hello")
+        expected = "UNION {\n  hello\n  +hello(expanded)\n}\n"
+        assert expected in client.ft().explain(q, query_params={"hello": "hello"})
+
+        expected = "NUMERIC {0.000000 <= @num <= 10.000000}\n"
+        assert expected in client.ft().explain(Query("@title:(@num:[0 10])").dialect(1))
+        with pytest.raises(redis.ResponseError) as err:
+            client.ft().explain(Query("@title:(@num:[0 10])"))
+        assert "Syntax error" in str(err)
+
+
+class TestAggregations(SearchTestsBase):
+    @pytest.mark.redismod
+    @pytest.mark.onlynoncluster
+    def test_aggregations_groupby(self, client):
+        # Creating the index definition and schema
+        client.ft().create_index(
+            (
+                NumericField("random_num"),
+                TextField("title"),
+                TextField("body"),
+                TextField("parent"),
+            )
+        )
 
-        # load all
-        req = aggregations.AggregateRequest("*").load()
-        res = client.ft().aggregate(req)
-        assert res["results"][0]["extra_attributes"] == {"t1": "hello", "t2": "world"}
-
-
-@pytest.mark.redismod
-def test_aggregations_apply(client):
-    client.ft().create_index(
-        (
-            TextField("PrimaryKey", sortable=True),
-            NumericField("CreatedDateTimeUTC", sortable=True),
-        )
-    )
-
-    client.ft().client.hset(
-        "doc1",
-        mapping={"PrimaryKey": "9::362330", "CreatedDateTimeUTC": "637387878524969984"},
-    )
-    client.ft().client.hset(
-        "doc2",
-        mapping={"PrimaryKey": "9::362329", "CreatedDateTimeUTC": "637387875859270016"},
-    )
-
-    req = aggregations.AggregateRequest("*").apply(
-        CreatedDateTimeUTC="@CreatedDateTimeUTC * 10"
-    )
-    res = client.ft().aggregate(req)
-    if is_resp2_connection(client):
-        res_set = {res.rows[0][1], res.rows[1][1]}
-        assert res_set == {"6373878785249699840", "6373878758592700416"}
-    else:
-        res_set = {
-            res["results"][0]["extra_attributes"]["CreatedDateTimeUTC"],
-            res["results"][1]["extra_attributes"]["CreatedDateTimeUTC"],
-        }
-        assert res_set == {"6373878785249699840", "6373878758592700416"}
+        # Indexing a document
+        client.hset(
+            "search",
+            mapping={
+                "title": "RediSearch",
+                "body": "Redisearch impements a search engine on top of redis",
+                "parent": "redis",
+                "random_num": 10,
+            },
+        )
+        client.hset(
+            "ai",
+            mapping={
+                "title": "RedisAI",
+                "body": "RedisAI executes Deep Learning/Machine Learning models and managing their data.",  # noqa
+                "parent": "redis",
+                "random_num": 3,
+            },
+        )
+        client.hset(
+            "json",
+            mapping={
+                "title": "RedisJson",
+                "body": "RedisJSON implements ECMA-404 The JSON Data Interchange Standard as a native data type.",  # noqa
+                "parent": "redis",
+                "random_num": 8,
+            },
+        )
 
+        if is_resp2_connection(client):
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.count()
+            )
 
-@pytest.mark.redismod
-def test_aggregations_filter(client):
-    client.ft().create_index(
-        (TextField("name", sortable=True), NumericField("age", sortable=True))
-    )
+            res = client.ft().aggregate(req).rows[0]
+            assert res[1] == "redis"
+            assert res[3] == "3"
 
-    client.ft().client.hset("doc1", mapping={"name": "bar", "age": "25"})
-    client.ft().client.hset("doc2", mapping={"name": "foo", "age": "19"})
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.count_distinct("@title")
+            )
 
-    for dialect in [1, 2]:
-        req = (
-            aggregations.AggregateRequest("*")
-            .filter("@name=='foo' && @age < 20")
-            .dialect(dialect)
-        )
-        res = client.ft().aggregate(req)
-        if is_resp2_connection(client):
-            assert len(res.rows) == 1
-            assert res.rows[0] == ["name", "foo", "age", "19"]
+            res = client.ft().aggregate(req).rows[0]
+            assert res[1] == "redis"
+            assert res[3] == "3"
 
-            req = (
-                aggregations.AggregateRequest("*")
-                .filter("@age > 15")
-                .sort_by("@age")
-                .dialect(dialect)
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.count_distinctish("@title")
             )
-            res = client.ft().aggregate(req)
-            assert len(res.rows) == 2
-            assert res.rows[0] == ["age", "19"]
-            assert res.rows[1] == ["age", "25"]
-        else:
-            assert len(res["results"]) == 1
-            assert res["results"][0]["extra_attributes"] == {"name": "foo", "age": "19"}
 
-            req = (
-                aggregations.AggregateRequest("*")
-                .filter("@age > 15")
-                .sort_by("@age")
-                .dialect(dialect)
+            res = client.ft().aggregate(req).rows[0]
+            assert res[1] == "redis"
+            assert res[3] == "3"
+
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.sum("@random_num")
             )
-            res = client.ft().aggregate(req)
-            assert len(res["results"]) == 2
-            assert res["results"][0]["extra_attributes"] == {"age": "19"}
-            assert res["results"][1]["extra_attributes"] == {"age": "25"}
 
+            res = client.ft().aggregate(req).rows[0]
+            assert res[1] == "redis"
+            assert res[3] == "21"  # 10+8+3
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.10.05", "search")
-def test_aggregations_add_scores(client):
-    client.ft().create_index(
-        (
-            TextField("name", sortable=True, weight=5.0),
-            NumericField("age", sortable=True),
-        )
-    )
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.min("@random_num")
+            )
 
-    client.hset("doc1", mapping={"name": "bar", "age": "25"})
-    client.hset("doc2", mapping={"name": "foo", "age": "19"})
+            res = client.ft().aggregate(req).rows[0]
+            assert res[1] == "redis"
+            assert res[3] == "3"  # min(10,8,3)
 
-    req = aggregations.AggregateRequest("*").add_scores()
-    res = client.ft().aggregate(req)
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.max("@random_num")
+            )
 
-    if isinstance(res, dict):
-        assert len(res["results"]) == 2
-        assert res["results"][0]["extra_attributes"] == {"__score": "0.2"}
-        assert res["results"][1]["extra_attributes"] == {"__score": "0.2"}
-    else:
-        assert len(res.rows) == 2
-        assert res.rows[0] == ["__score", "0.2"]
-        assert res.rows[1] == ["__score", "0.2"]
-
-
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.10.05", "search")
-async def test_aggregations_hybrid_scoring(client):
-    client.ft().create_index(
-        (
-            TextField("name", sortable=True, weight=5.0),
-            TextField("description", sortable=True, weight=5.0),
-            VectorField(
-                "vector",
-                "HNSW",
-                {"TYPE": "FLOAT32", "DIM": 2, "DISTANCE_METRIC": "COSINE"},
-            ),
-        )
-    )
-
-    client.hset(
-        "doc1",
-        mapping={
-            "name": "cat book",
-            "description": "an animal book about cats",
-            "vector": np.array([0.1, 0.2]).astype(np.float32).tobytes(),
-        },
-    )
-    client.hset(
-        "doc2",
-        mapping={
-            "name": "dog book",
-            "description": "an animal book about dogs",
-            "vector": np.array([0.2, 0.1]).astype(np.float32).tobytes(),
-        },
-    )
-
-    query_string = "(@description:animal)=>[KNN 3 @vector $vec_param AS dist]"
-    req = (
-        aggregations.AggregateRequest(query_string)
-        .scorer("BM25")
-        .add_scores()
-        .apply(hybrid_score="@__score + @dist")
-        .load("*")
-        .dialect(4)
-    )
-
-    res = client.ft().aggregate(
-        req,
-        query_params={"vec_param": np.array([0.11, 0.21]).astype(np.float32).tobytes()},
-    )
-
-    if isinstance(res, dict):
-        assert len(res["results"]) == 2
-    else:
-        assert len(res.rows) == 2
-        for row in res.rows:
-            len(row) == 6
+            res = client.ft().aggregate(req).rows[0]
+            assert res[1] == "redis"
+            assert res[3] == "10"  # max(10,8,3)
 
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.avg("@random_num")
+            )
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.0.0", "search")
-def test_index_definition(client):
-    """
-    Create definition and test its args
-    """
-    with pytest.raises(RuntimeError):
-        IndexDefinition(prefix=["hset:", "henry"], index_type="json")
-
-    definition = IndexDefinition(
-        prefix=["hset:", "henry"],
-        filter="@f1==32",
-        language="English",
-        language_field="play",
-        score_field="chapter",
-        score=0.5,
-        payload_field="txt",
-        index_type=IndexType.JSON,
-    )
-
-    assert [
-        "ON",
-        "JSON",
-        "PREFIX",
-        2,
-        "hset:",
-        "henry",
-        "FILTER",
-        "@f1==32",
-        "LANGUAGE_FIELD",
-        "play",
-        "LANGUAGE",
-        "English",
-        "SCORE_FIELD",
-        "chapter",
-        "SCORE",
-        0.5,
-        "PAYLOAD_FIELD",
-        "txt",
-    ] == definition.args
-
-    createIndex(client.ft(), num_docs=500, definition=definition)
-
-
-@pytest.mark.redismod
-@pytest.mark.onlynoncluster
-@skip_if_redis_enterprise()
-@skip_if_server_version_gte("7.9.0")
-def test_expire(client):
-    client.ft().create_index((TextField("txt", sortable=True),), temporary=4)
-    ttl = client.execute_command("ft.debug", "TTL", "idx")
-    assert ttl > 2
-
-    while ttl > 2:
-        ttl = client.execute_command("ft.debug", "TTL", "idx")
-        time.sleep(0.01)
+            res = client.ft().aggregate(req).rows[0]
+            assert res[1] == "redis"
+            index = res.index("__generated_aliasavgrandom_num")
+            assert res[index + 1] == "7"  # (10+3+8)/3
 
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.stddev("random_num")
+            )
 
-@pytest.mark.redismod
-def test_skip_initial_scan(client):
-    client.hset("doc1", "foo", "bar")
-    q = Query("@foo:bar")
+            res = client.ft().aggregate(req).rows[0]
+            assert res[1] == "redis"
+            assert res[3] == "3.60555127546"
 
-    client.ft().create_index((TextField("foo"),), skip_initial_scan=True)
-    res = client.ft().search(q)
-    if is_resp2_connection(client):
-        assert res.total == 0
-    else:
-        assert res["total_results"] == 0
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.quantile("@random_num", 0.5)
+            )
 
+            res = client.ft().aggregate(req).rows[0]
+            assert res[1] == "redis"
+            assert res[3] == "8"  # median of 3,8,10
 
-@pytest.mark.redismod
-def test_summarize_disabled_nooffset(client):
-    client.ft().create_index((TextField("txt"),), no_term_offsets=True)
-    client.hset("doc1", mapping={"txt": "foo bar"})
-    with pytest.raises(Exception):
-        client.ft().search(Query("foo").summarize(fields=["txt"]))
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.tolist("@title")
+            )
 
+            res = client.ft().aggregate(req).rows[0]
+            assert res[1] == "redis"
+            assert set(res[3]) == {"RediSearch", "RedisAI", "RedisJson"}
 
-@pytest.mark.redismod
-def test_summarize_disabled_nohl(client):
-    client.ft().create_index((TextField("txt"),), no_highlight=True)
-    client.hset("doc1", mapping={"txt": "foo bar"})
-    with pytest.raises(Exception):
-        client.ft().search(Query("foo").summarize(fields=["txt"]))
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.first_value("@title").alias("first")
+            )
 
+            res = client.ft().aggregate(req).rows[0]
+            assert res == ["parent", "redis", "first", "RediSearch"]
 
-@pytest.mark.redismod
-def test_max_text_fields(client):
-    # Creating the index definition
-    client.ft().create_index((TextField("f0"),))
-    for x in range(1, 32):
-        client.ft().alter_schema_add((TextField(f"f{x}"),))
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.random_sample("@title", 2).alias("random")
+            )
 
-    # Should be too many indexes
-    with pytest.raises(redis.ResponseError):
-        client.ft().alter_schema_add((TextField(f"f{x}"),))
+            res = client.ft().aggregate(req).rows[0]
+            assert res[1] == "redis"
+            assert res[2] == "random"
+            assert len(res[3]) == 2
+            assert res[3][0] in ["RediSearch", "RedisAI", "RedisJson"]
+        else:
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.count()
+            )
 
-    client.ft().dropindex()
-    # Creating the index definition
-    client.ft().create_index((TextField("f0"),), max_text_fields=True)
-    # Fill the index with fields
-    for x in range(1, 50):
-        client.ft().alter_schema_add((TextField(f"f{x}"),))
+            res = client.ft().aggregate(req)["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert res["extra_attributes"]["__generated_aliascount"] == "3"
 
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.count_distinct("@title")
+            )
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.0.0", "search")
-def test_create_client_definition(client):
-    """
-    Create definition with no index type provided,
-    and use hset to test the client definition (the default is HASH).
-    """
-    definition = IndexDefinition(prefix=["hset:", "henry"])
-    createIndex(client.ft(), num_docs=500, definition=definition)
+            res = client.ft().aggregate(req)["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert (
+                res["extra_attributes"]["__generated_aliascount_distincttitle"] == "3"
+            )
 
-    info = client.ft().info()
-    assert 494 == int(info["num_docs"])
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.count_distinctish("@title")
+            )
 
-    client.ft().client.hset("hset:1", "f1", "v1")
-    info = client.ft().info()
-    assert 495 == int(info["num_docs"])
+            res = client.ft().aggregate(req)["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert (
+                res["extra_attributes"]["__generated_aliascount_distinctishtitle"]
+                == "3"
+            )
 
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.sum("@random_num")
+            )
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.0.0", "search")
-def test_create_client_definition_hash(client):
-    """
-    Create definition with IndexType.HASH as index type (ON HASH),
-    and use hset to test the client definition.
-    """
-    definition = IndexDefinition(prefix=["hset:", "henry"], index_type=IndexType.HASH)
-    createIndex(client.ft(), num_docs=500, definition=definition)
+            res = client.ft().aggregate(req)["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert res["extra_attributes"]["__generated_aliassumrandom_num"] == "21"
 
-    info = client.ft().info()
-    assert 494 == int(info["num_docs"])
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.min("@random_num")
+            )
 
-    client.ft().client.hset("hset:1", "f1", "v1")
-    info = client.ft().info()
-    assert 495 == int(info["num_docs"])
+            res = client.ft().aggregate(req)["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert res["extra_attributes"]["__generated_aliasminrandom_num"] == "3"
 
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.max("@random_num")
+            )
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.2.0", "search")
-def test_create_client_definition_json(client):
-    """
-    Create definition with IndexType.JSON as index type (ON JSON),
-    and use json client to test it.
-    """
-    definition = IndexDefinition(prefix=["king:"], index_type=IndexType.JSON)
-    client.ft().create_index((TextField("$.name"),), definition=definition)
+            res = client.ft().aggregate(req)["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert res["extra_attributes"]["__generated_aliasmaxrandom_num"] == "10"
 
-    client.json().set("king:1", Path.root_path(), {"name": "henry"})
-    client.json().set("king:2", Path.root_path(), {"name": "james"})
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.avg("@random_num")
+            )
 
-    res = client.ft().search("henry")
-    if is_resp2_connection(client):
-        assert res.docs[0].id == "king:1"
-        assert res.docs[0].payload is None
-        assert res.docs[0].json == '{"name":"henry"}'
-        assert res.total == 1
-    else:
-        assert res["results"][0]["id"] == "king:1"
-        assert res["results"][0]["extra_attributes"]["$"] == '{"name":"henry"}'
-        assert res["total_results"] == 1
-
-
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.2.0", "search")
-def test_fields_as_name(client):
-    # create index
-    SCHEMA = (
-        TextField("$.name", sortable=True, as_name="name"),
-        NumericField("$.age", as_name="just_a_number"),
-    )
-    definition = IndexDefinition(index_type=IndexType.JSON)
-    client.ft().create_index(SCHEMA, definition=definition)
-
-    # insert json data
-    res = client.json().set("doc:1", Path.root_path(), {"name": "Jon", "age": 25})
-    assert res
-
-    res = client.ft().search(Query("Jon").return_fields("name", "just_a_number"))
-    if is_resp2_connection(client):
-        assert 1 == len(res.docs)
-        assert "doc:1" == res.docs[0].id
-        assert "Jon" == res.docs[0].name
-        assert "25" == res.docs[0].just_a_number
-    else:
-        assert 1 == len(res["results"])
-        assert "doc:1" == res["results"][0]["id"]
-        assert "Jon" == res["results"][0]["extra_attributes"]["name"]
-        assert "25" == res["results"][0]["extra_attributes"]["just_a_number"]
+            res = client.ft().aggregate(req)["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert res["extra_attributes"]["__generated_aliasavgrandom_num"] == "7"
+
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.stddev("random_num")
+            )
 
+            res = client.ft().aggregate(req)["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert (
+                res["extra_attributes"]["__generated_aliasstddevrandom_num"]
+                == "3.60555127546"
+            )
 
-@pytest.mark.redismod
-def test_casesensitive(client):
-    # create index
-    SCHEMA = (TagField("t", case_sensitive=False),)
-    client.ft().create_index(SCHEMA)
-    client.ft().client.hset("1", "t", "HELLO")
-    client.ft().client.hset("2", "t", "hello")
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.quantile("@random_num", 0.5)
+            )
 
-    res = client.ft().search("@t:{HELLO}")
+            res = client.ft().aggregate(req)["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert (
+                res["extra_attributes"]["__generated_aliasquantilerandom_num,0.5"]
+                == "8"
+            )
 
-    if is_resp2_connection(client):
-        assert 2 == len(res.docs)
-        assert "1" == res.docs[0].id
-        assert "2" == res.docs[1].id
-    else:
-        assert 2 == len(res["results"])
-        assert "1" == res["results"][0]["id"]
-        assert "2" == res["results"][1]["id"]
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.tolist("@title")
+            )
 
-    # create casesensitive index
-    client.ft().dropindex()
-    SCHEMA = (TagField("t", case_sensitive=True),)
-    client.ft().create_index(SCHEMA)
-    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
+            res = client.ft().aggregate(req)["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert set(res["extra_attributes"]["__generated_aliastolisttitle"]) == {
+                "RediSearch",
+                "RedisAI",
+                "RedisJson",
+            }
 
-    res = client.ft().search("@t:{HELLO}")
-    if is_resp2_connection(client):
-        assert 1 == len(res.docs)
-        assert "1" == res.docs[0].id
-    else:
-        assert 1 == len(res["results"])
-        assert "1" == res["results"][0]["id"]
-
-
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.2.0", "search")
-def test_search_return_fields(client):
-    res = client.json().set(
-        "doc:1",
-        Path.root_path(),
-        {"t": "riceratops", "t2": "telmatosaurus", "n": 9072, "flt": 97.2},
-    )
-    assert res
-
-    # create index on
-    definition = IndexDefinition(index_type=IndexType.JSON)
-    SCHEMA = (TextField("$.t"), NumericField("$.flt"))
-    client.ft().create_index(SCHEMA, definition=definition)
-    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.first_value("@title").alias("first")
+            )
 
-    if is_resp2_connection(client):
-        total = client.ft().search(Query("*").return_field("$.t", as_field="txt")).docs
-        assert 1 == len(total)
-        assert "doc:1" == total[0].id
-        assert "riceratops" == total[0].txt
-
-        total = client.ft().search(Query("*").return_field("$.t2", as_field="txt")).docs
-        assert 1 == len(total)
-        assert "doc:1" == total[0].id
-        assert "telmatosaurus" == total[0].txt
-    else:
-        total = client.ft().search(Query("*").return_field("$.t", as_field="txt"))
-        assert 1 == len(total["results"])
-        assert "doc:1" == total["results"][0]["id"]
-        assert "riceratops" == total["results"][0]["extra_attributes"]["txt"]
-
-        total = client.ft().search(Query("*").return_field("$.t2", as_field="txt"))
-        assert 1 == len(total["results"])
-        assert "doc:1" == total["results"][0]["id"]
-        assert "telmatosaurus" == total["results"][0]["extra_attributes"]["txt"]
-
-
-@pytest.mark.redismod
-@skip_if_resp_version(3)
-def test_binary_and_text_fields(client):
-    fake_vec = np.array([0.1, 0.2, 0.3, 0.4], dtype=np.float32)
-
-    index_name = "mixed_index"
-    mixed_data = {"first_name": "🐍python", "vector_emb": fake_vec.tobytes()}
-    client.hset(f"{index_name}:1", mapping=mixed_data)
-
-    schema = (
-        TagField("first_name"),
-        VectorField(
-            "embeddings_bio",
-            algorithm="HNSW",
-            attributes={
-                "TYPE": "FLOAT32",
-                "DIM": 4,
-                "DISTANCE_METRIC": "COSINE",
-            },
-        ),
-    )
-
-    client.ft(index_name).create_index(
-        fields=schema,
-        definition=IndexDefinition(
-            prefix=[f"{index_name}:"], index_type=IndexType.HASH
-        ),
-    )
-
-    waitForIndex(client, index_name)
-
-    query = (
-        Query("*")
-        .return_field("vector_emb", decode_field=False)
-        .return_field("first_name")
-    )
-    docs = client.ft(index_name).search(query=query, query_params={}).docs
-    decoded_vec_from_search_results = np.frombuffer(
-        docs[0]["vector_emb"], dtype=np.float32
-    )
-
-    assert np.array_equal(decoded_vec_from_search_results, fake_vec), (
-        "The vectors are not equal"
-    )
-
-    assert docs[0]["first_name"] == mixed_data["first_name"], (
-        "The text field is not decoded correctly"
-    )
-
-
-@pytest.mark.redismod
-def test_synupdate(client):
-    definition = IndexDefinition(index_type=IndexType.HASH)
-    client.ft().create_index(
-        (TextField("title"), TextField("body")), definition=definition
-    )
-
-    client.ft().synupdate("id1", True, "boy", "child", "offspring")
-    client.hset("doc1", mapping={"title": "he is a baby", "body": "this is a test"})
-
-    client.ft().synupdate("id1", True, "baby")
-    client.hset("doc2", mapping={"title": "he is another baby", "body": "another test"})
-
-    res = client.ft().search(Query("child").expander("SYNONYM"))
-    if is_resp2_connection(client):
-        assert res.docs[0].id == "doc2"
-        assert res.docs[0].title == "he is another baby"
-        assert res.docs[0].body == "another test"
-    else:
-        assert res["results"][0]["id"] == "doc2"
-        assert res["results"][0]["extra_attributes"]["title"] == "he is another baby"
-        assert res["results"][0]["extra_attributes"]["body"] == "another test"
-
-
-@pytest.mark.redismod
-def test_syndump(client):
-    definition = IndexDefinition(index_type=IndexType.HASH)
-    client.ft().create_index(
-        (TextField("title"), TextField("body")), definition=definition
-    )
-
-    client.ft().synupdate("id1", False, "boy", "child", "offspring")
-    client.ft().synupdate("id2", False, "baby", "child")
-    client.ft().synupdate("id3", False, "tree", "wood")
-    res = client.ft().syndump()
-    assert res == {
-        "boy": ["id1"],
-        "tree": ["id3"],
-        "wood": ["id3"],
-        "child": ["id1", "id2"],
-        "baby": ["id2"],
-        "offspring": ["id1"],
-    }
-
-
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.2.0", "search")
-def test_create_json_with_alias(client):
-    """
-    Create definition with IndexType.JSON as index type (ON JSON) with two
-    fields with aliases, and use json client to test it.
-    """
-    definition = IndexDefinition(prefix=["king:"], index_type=IndexType.JSON)
-    client.ft().create_index(
-        (TextField("$.name", as_name="name"), NumericField("$.num", as_name="num")),
-        definition=definition,
-    )
+            res = client.ft().aggregate(req)["results"][0]
+            assert res["extra_attributes"] == {"parent": "redis", "first": "RediSearch"}
 
-    client.json().set("king:1", Path.root_path(), {"name": "henry", "num": 42})
-    client.json().set("king:2", Path.root_path(), {"name": "james", "num": 3.14})
+            req = aggregations.AggregateRequest("redis").group_by(
+                "@parent", reducers.random_sample("@title", 2).alias("random")
+            )
 
-    if is_resp2_connection(client):
-        res = client.ft().search("@name:henry")
-        assert res.docs[0].id == "king:1"
-        assert res.docs[0].json == '{"name":"henry","num":42}'
-        assert res.total == 1
-
-        res = client.ft().search("@num:[0 10]")
-        assert res.docs[0].id == "king:2"
-        assert res.docs[0].json == '{"name":"james","num":3.14}'
-        assert res.total == 1
-    else:
-        res = client.ft().search("@name:henry")
-        assert res["results"][0]["id"] == "king:1"
-        assert res["results"][0]["extra_attributes"]["$"] == '{"name":"henry","num":42}'
-        assert res["total_results"] == 1
+            res = client.ft().aggregate(req)["results"][0]
+            assert res["extra_attributes"]["parent"] == "redis"
+            assert "random" in res["extra_attributes"].keys()
+            assert len(res["extra_attributes"]["random"]) == 2
+            assert res["extra_attributes"]["random"][0] in [
+                "RediSearch",
+                "RedisAI",
+                "RedisJson",
+            ]
 
-        res = client.ft().search("@num:[0 10]")
-        assert res["results"][0]["id"] == "king:2"
-        assert (
-            res["results"][0]["extra_attributes"]["$"] == '{"name":"james","num":3.14}'
-        )
-        assert res["total_results"] == 1
+    @pytest.mark.redismod
+    def test_aggregations_sort_by_and_limit(self, client):
+        client.ft().create_index((TextField("t1"), TextField("t2")))
 
-    # Tests returns an error if path contain special characters (user should
-    # use an alias)
-    with pytest.raises(Exception):
-        client.ft().search("@$.name:henry")
+        client.ft().client.hset("doc1", mapping={"t1": "a", "t2": "b"})
+        client.ft().client.hset("doc2", mapping={"t1": "b", "t2": "a"})
 
+        if is_resp2_connection(client):
+            # test sort_by using SortDirection
+            req = aggregations.AggregateRequest("*").sort_by(
+                aggregations.Asc("@t2"), aggregations.Desc("@t1")
+            )
+            res = client.ft().aggregate(req)
+            assert res.rows[0] == ["t2", "a", "t1", "b"]
+            assert res.rows[1] == ["t2", "b", "t1", "a"]
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.2.0", "search")
-def test_json_with_multipath(client):
-    """
-    Create definition with IndexType.JSON as index type (ON JSON),
-    and use json client to test it.
-    """
-    definition = IndexDefinition(prefix=["king:"], index_type=IndexType.JSON)
-    client.ft().create_index(
-        (TagField("$..name", as_name="name")), definition=definition
-    )
+            # test sort_by without SortDirection
+            req = aggregations.AggregateRequest("*").sort_by("@t1")
+            res = client.ft().aggregate(req)
+            assert res.rows[0] == ["t1", "a"]
+            assert res.rows[1] == ["t1", "b"]
 
-    client.json().set(
-        "king:1", Path.root_path(), {"name": "henry", "country": {"name": "england"}}
-    )
+            # test sort_by with max
+            req = aggregations.AggregateRequest("*").sort_by("@t1", max=1)
+            res = client.ft().aggregate(req)
+            assert len(res.rows) == 1
 
-    if is_resp2_connection(client):
-        res = client.ft().search("@name:{henry}")
-        assert res.docs[0].id == "king:1"
-        assert res.docs[0].json == '{"name":"henry","country":{"name":"england"}}'
-        assert res.total == 1
-
-        res = client.ft().search("@name:{england}")
-        assert res.docs[0].id == "king:1"
-        assert res.docs[0].json == '{"name":"henry","country":{"name":"england"}}'
-        assert res.total == 1
-    else:
-        res = client.ft().search("@name:{henry}")
-        assert res["results"][0]["id"] == "king:1"
-        assert (
-            res["results"][0]["extra_attributes"]["$"]
-            == '{"name":"henry","country":{"name":"england"}}'
-        )
-        assert res["total_results"] == 1
+            # test limit
+            req = aggregations.AggregateRequest("*").sort_by("@t1").limit(1, 1)
+            res = client.ft().aggregate(req)
+            assert len(res.rows) == 1
+            assert res.rows[0] == ["t1", "b"]
+        else:
+            # test sort_by using SortDirection
+            req = aggregations.AggregateRequest("*").sort_by(
+                aggregations.Asc("@t2"), aggregations.Desc("@t1")
+            )
+            res = client.ft().aggregate(req)["results"]
+            assert res[0]["extra_attributes"] == {"t2": "a", "t1": "b"}
+            assert res[1]["extra_attributes"] == {"t2": "b", "t1": "a"}
+
+            # test sort_by without SortDirection
+            req = aggregations.AggregateRequest("*").sort_by("@t1")
+            res = client.ft().aggregate(req)["results"]
+            assert res[0]["extra_attributes"] == {"t1": "a"}
+            assert res[1]["extra_attributes"] == {"t1": "b"}
+
+            # test sort_by with max
+            req = aggregations.AggregateRequest("*").sort_by("@t1", max=1)
+            res = client.ft().aggregate(req)
+            assert len(res["results"]) == 1
 
-        res = client.ft().search("@name:{england}")
-        assert res["results"][0]["id"] == "king:1"
-        assert (
-            res["results"][0]["extra_attributes"]["$"]
-            == '{"name":"henry","country":{"name":"england"}}'
-        )
-        assert res["total_results"] == 1
+            # test limit
+            req = aggregations.AggregateRequest("*").sort_by("@t1").limit(1, 1)
+            res = client.ft().aggregate(req)
+            assert len(res["results"]) == 1
+            assert res["results"][0]["extra_attributes"] == {"t1": "b"}
 
+    @pytest.mark.redismod
+    def test_aggregations_load(self, client):
+        client.ft().create_index((TextField("t1"), TextField("t2")))
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.2.0", "search")
-def test_json_with_jsonpath(client):
-    definition = IndexDefinition(index_type=IndexType.JSON)
-    client.ft().create_index(
-        (
-            TextField('$["prod:name"]', as_name="name"),
-            TextField("$.prod:name", as_name="name_unsupported"),
-        ),
-        definition=definition,
-    )
+        client.ft().client.hset("doc1", mapping={"t1": "hello", "t2": "world"})
 
-    client.json().set("doc:1", Path.root_path(), {"prod:name": "RediSearch"})
+        if is_resp2_connection(client):
+            # load t1
+            req = aggregations.AggregateRequest("*").load("t1")
+            res = client.ft().aggregate(req)
+            assert res.rows[0] == ["t1", "hello"]
 
-    if is_resp2_connection(client):
-        # query for a supported field succeeds
-        res = client.ft().search(Query("@name:RediSearch"))
-        assert res.total == 1
-        assert res.docs[0].id == "doc:1"
-        assert res.docs[0].json == '{"prod:name":"RediSearch"}'
-
-        # query for an unsupported field
-        res = client.ft().search("@name_unsupported:RediSearch")
-        assert res.total == 1
-
-        # return of a supported field succeeds
-        res = client.ft().search(Query("@name:RediSearch").return_field("name"))
-        assert res.total == 1
-        assert res.docs[0].id == "doc:1"
-        assert res.docs[0].name == "RediSearch"
-    else:
-        # query for a supported field succeeds
-        res = client.ft().search(Query("@name:RediSearch"))
-        assert res["total_results"] == 1
-        assert res["results"][0]["id"] == "doc:1"
-        assert (
-            res["results"][0]["extra_attributes"]["$"] == '{"prod:name":"RediSearch"}'
-        )
-
-        # query for an unsupported field
-        res = client.ft().search("@name_unsupported:RediSearch")
-        assert res["total_results"] == 1
-
-        # return of a supported field succeeds
-        res = client.ft().search(Query("@name:RediSearch").return_field("name"))
-        assert res["total_results"] == 1
-        assert res["results"][0]["id"] == "doc:1"
-        assert res["results"][0]["extra_attributes"]["name"] == "RediSearch"
-
-
-@pytest.mark.redismod
-@pytest.mark.onlynoncluster
-@skip_if_redis_enterprise()
-@skip_if_server_version_gte("7.9.0")
-@skip_if_server_version_lt("6.3.0")
-def test_profile(client):
-    client.ft().create_index((TextField("t"),))
-    client.ft().client.hset("1", "t", "hello")
-    client.ft().client.hset("2", "t", "world")
-
-    # check using Query
-    q = Query("hello|world").no_content()
-    if is_resp2_connection(client):
-        res, det = client.ft().profile(q)
-        det = det.info
+            # load t2
+            req = aggregations.AggregateRequest("*").load("t2")
+            res = client.ft().aggregate(req)
+            assert res.rows[0] == ["t2", "world"]
 
-        assert isinstance(det, list)
-        assert len(res.docs) == 2  # check also the search result
+            # load all
+            req = aggregations.AggregateRequest("*").load()
+            res = client.ft().aggregate(req)
+            assert res.rows[0] == ["t1", "hello", "t2", "world"]
+        else:
+            # load t1
+            req = aggregations.AggregateRequest("*").load("t1")
+            res = client.ft().aggregate(req)
+            assert res["results"][0]["extra_attributes"] == {"t1": "hello"}
 
-        # check using AggregateRequest
-        req = (
-            aggregations.AggregateRequest("*")
-            .load("t")
-            .apply(prefix="startswith(@t, 'hel')")
-        )
-        res, det = client.ft().profile(req)
-        det = det.info
-        assert isinstance(det, list)
-        assert len(res.rows) == 2  # check also the search result
-    else:
-        res = client.ft().profile(q)
-        res = res.info
+            # load t2
+            req = aggregations.AggregateRequest("*").load("t2")
+            res = client.ft().aggregate(req)
+            assert res["results"][0]["extra_attributes"] == {"t2": "world"}
 
-        assert isinstance(res, dict)
-        assert len(res["results"]) == 2  # check also the search result
+            # load all
+            req = aggregations.AggregateRequest("*").load()
+            res = client.ft().aggregate(req)
+            assert res["results"][0]["extra_attributes"] == {
+                "t1": "hello",
+                "t2": "world",
+            }
+
+    @pytest.mark.redismod
+    def test_aggregations_apply(self, client):
+        client.ft().create_index(
+            (
+                TextField("PrimaryKey", sortable=True),
+                NumericField("CreatedDateTimeUTC", sortable=True),
+            )
+        )
 
-        # check using AggregateRequest
-        req = (
-            aggregations.AggregateRequest("*")
-            .load("t")
-            .apply(prefix="startswith(@t, 'hel')")
+        client.ft().client.hset(
+            "doc1",
+            mapping={
+                "PrimaryKey": "9::362330",
+                "CreatedDateTimeUTC": "637387878524969984",
+            },
+        )
+        client.ft().client.hset(
+            "doc2",
+            mapping={
+                "PrimaryKey": "9::362329",
+                "CreatedDateTimeUTC": "637387875859270016",
+            },
         )
-        res = client.ft().profile(req)
-        res = res.info
 
-        assert isinstance(res, dict)
-        assert len(res["results"]) == 2  # check also the search result
+        req = aggregations.AggregateRequest("*").apply(
+            CreatedDateTimeUTC="@CreatedDateTimeUTC * 10"
+        )
+        res = client.ft().aggregate(req)
+        if is_resp2_connection(client):
+            res_set = {res.rows[0][1], res.rows[1][1]}
+            assert res_set == {"6373878785249699840", "6373878758592700416"}
+        else:
+            res_set = {
+                res["results"][0]["extra_attributes"]["CreatedDateTimeUTC"],
+                res["results"][1]["extra_attributes"]["CreatedDateTimeUTC"],
+            }
+            assert res_set == {"6373878785249699840", "6373878758592700416"}
+
+    @pytest.mark.redismod
+    def test_aggregations_filter(self, client):
+        client.ft().create_index(
+            (TextField("name", sortable=True), NumericField("age", sortable=True))
+        )
 
+        client.ft().client.hset("doc1", mapping={"name": "bar", "age": "25"})
+        client.ft().client.hset("doc2", mapping={"name": "foo", "age": "19"})
 
-@pytest.mark.redismod
-@pytest.mark.onlynoncluster
-@skip_if_redis_enterprise()
-@skip_if_server_version_lt("7.9.0")
-def test_profile_with_coordinator(client):
-    client.ft().create_index((TextField("t"),))
-    client.ft().client.hset("1", "t", "hello")
-    client.ft().client.hset("2", "t", "world")
+        for dialect in [1, 2]:
+            req = (
+                aggregations.AggregateRequest("*")
+                .filter("@name=='foo' && @age < 20")
+                .dialect(dialect)
+            )
+            res = client.ft().aggregate(req)
+            if is_resp2_connection(client):
+                assert len(res.rows) == 1
+                assert res.rows[0] == ["name", "foo", "age", "19"]
+
+                req = (
+                    aggregations.AggregateRequest("*")
+                    .filter("@age > 15")
+                    .sort_by("@age")
+                    .dialect(dialect)
+                )
+                res = client.ft().aggregate(req)
+                assert len(res.rows) == 2
+                assert res.rows[0] == ["age", "19"]
+                assert res.rows[1] == ["age", "25"]
+            else:
+                assert len(res["results"]) == 1
+                assert res["results"][0]["extra_attributes"] == {
+                    "name": "foo",
+                    "age": "19",
+                }
+
+                req = (
+                    aggregations.AggregateRequest("*")
+                    .filter("@age > 15")
+                    .sort_by("@age")
+                    .dialect(dialect)
+                )
+                res = client.ft().aggregate(req)
+                assert len(res["results"]) == 2
+                assert res["results"][0]["extra_attributes"] == {"age": "19"}
+                assert res["results"][1]["extra_attributes"] == {"age": "25"}
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.10.05", "search")
+    def test_aggregations_add_scores(self, client):
+        client.ft().create_index(
+            (
+                TextField("name", sortable=True, weight=5.0),
+                NumericField("age", sortable=True),
+            )
+        )
 
-    # check using Query
-    q = Query("hello|world").no_content()
-    if is_resp2_connection(client):
-        res, det = client.ft().profile(q)
-        det = det.info
+        client.hset("doc1", mapping={"name": "bar", "age": "25"})
+        client.hset("doc2", mapping={"name": "foo", "age": "19"})
 
-        assert isinstance(det, list)
-        assert len(res.docs) == 2  # check also the search result
+        req = aggregations.AggregateRequest("*").add_scores()
+        res = client.ft().aggregate(req)
 
-        # check using AggregateRequest
-        req = (
-            aggregations.AggregateRequest("*")
-            .load("t")
-            .apply(prefix="startswith(@t, 'hel')")
+        if isinstance(res, dict):
+            assert len(res["results"]) == 2
+            assert res["results"][0]["extra_attributes"] == {"__score": "0.2"}
+            assert res["results"][1]["extra_attributes"] == {"__score": "0.2"}
+        else:
+            assert len(res.rows) == 2
+            assert res.rows[0] == ["__score", "0.2"]
+            assert res.rows[1] == ["__score", "0.2"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.10.05", "search")
+    async def test_aggregations_hybrid_scoring(self, client):
+        client.ft().create_index(
+            (
+                TextField("name", sortable=True, weight=5.0),
+                TextField("description", sortable=True, weight=5.0),
+                VectorField(
+                    "vector",
+                    "HNSW",
+                    {"TYPE": "FLOAT32", "DIM": 2, "DISTANCE_METRIC": "COSINE"},
+                ),
+            )
         )
-        res, det = client.ft().profile(req)
-        det = det.info
-
-        assert isinstance(det, list)
-        assert det[0] == "Shards"
-        assert det[2] == "Coordinator"
-        assert len(res.rows) == 2  # check also the search result
-    else:
-        res = client.ft().profile(q)
-        res = res.info
 
-        assert isinstance(res, dict)
-        assert len(res["Results"]["results"]) == 2  # check also the search result
-
-        # check using AggregateRequest
-        req = (
-            aggregations.AggregateRequest("*")
-            .load("t")
-            .apply(prefix="startswith(@t, 'hel')")
-        )
-        res = client.ft().profile(req)
-        res = res.info
-
-        assert isinstance(res, dict)
-        assert len(res["Results"]["results"]) == 2  # check also the search result
-
-
-@pytest.mark.redismod
-@pytest.mark.onlynoncluster
-@skip_if_redis_enterprise()
-@skip_if_server_version_gte("6.3.0")
-def test_profile_with_no_warnings(client):
-    client.ft().create_index((TextField("t"),))
-    client.ft().client.hset("1", "t", "hello")
-    client.ft().client.hset("2", "t", "world")
-
-    # check using Query
-    q = Query("hello|world").no_content()
-    res, det = client.ft().profile(q)
-    det = det.info
-
-    assert isinstance(det, list)
-    assert len(res.docs) == 2  # check also the search result
-
-    # check using AggregateRequest
-    req = (
-        aggregations.AggregateRequest("*")
-        .load("t")
-        .apply(prefix="startswith(@t, 'hel')")
-    )
-    res, det = client.ft().profile(req)
-    det = det.info
-
-    assert isinstance(det, list)
-    assert len(res.rows) == 2  # check also the search result
-
-
-@pytest.mark.redismod
-@pytest.mark.onlynoncluster
-@skip_if_server_version_gte("7.9.0")
-@skip_if_server_version_lt("6.3.0")
-def test_profile_limited(client):
-    client.ft().create_index((TextField("t"),))
-    client.ft().client.hset("1", "t", "hello")
-    client.ft().client.hset("2", "t", "hell")
-    client.ft().client.hset("3", "t", "help")
-    client.ft().client.hset("4", "t", "helowa")
-
-    q = Query("%hell% hel*")
-    if is_resp2_connection(client):
-        res, det = client.ft().profile(q, limited=True)
-        det = det.info
-        assert det[4][1][7][9] == "The number of iterators in the union is 3"
-        assert det[4][1][8][9] == "The number of iterators in the union is 4"
-        assert det[4][1][1] == "INTERSECT"
-        assert len(res.docs) == 3  # check also the search result
-    else:
-        res = client.ft().profile(q, limited=True)
-        res = res.info
-        iterators_profile = res["profile"]["Iterators profile"]
-        assert (
-            iterators_profile[0]["Child iterators"][0]["Child iterators"]
-            == "The number of iterators in the union is 3"
-        )
-        assert (
-            iterators_profile[0]["Child iterators"][1]["Child iterators"]
-            == "The number of iterators in the union is 4"
-        )
-        assert iterators_profile[0]["Type"] == "INTERSECT"
-        assert len(res["results"]) == 3  # check also the search result
-
-
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_gte("7.9.0")
-@skip_if_server_version_lt("6.3.0")
-def test_profile_query_params(client):
-    client.ft().create_index(
-        (
-            VectorField(
-                "v", "HNSW", {"TYPE": "FLOAT32", "DIM": 2, "DISTANCE_METRIC": "L2"}
-            ),
+        client.hset(
+            "doc1",
+            mapping={
+                "name": "cat book",
+                "description": "an animal book about cats",
+                "vector": np.array([0.1, 0.2]).astype(np.float32).tobytes(),
+            },
         )
-    )
-    client.hset("a", "v", "aaaaaaaa")
-    client.hset("b", "v", "aaaabaaa")
-    client.hset("c", "v", "aaaaabaa")
-    query = "*=>[KNN 2 @v $vec]"
-    q = Query(query).return_field("__v_score").sort_by("__v_score", True)
-    if is_resp2_connection(client):
-        res, det = client.ft().profile(q, query_params={"vec": "aaaaaaaa"})
-        det = det.info
-        assert det[4][1][5] == 2.0
-        assert det[4][1][1] == "VECTOR"
-        assert res.total == 2
-        assert "a" == res.docs[0].id
-        assert "0" == res.docs[0].__getattribute__("__v_score")
-    else:
-        res = client.ft().profile(q, query_params={"vec": "aaaaaaaa"})
-        res = res.info
-        assert res["profile"]["Iterators profile"][0]["Counter"] == 2
-        assert res["profile"]["Iterators profile"][0]["Type"] == "VECTOR"
-        assert res["total_results"] == 2
-        assert "a" == res["results"][0]["id"]
-        assert "0" == res["results"][0]["extra_attributes"]["__v_score"]
-
-
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-def test_vector_field(client):
-    client.flushdb()
-    client.ft().create_index(
-        (
-            VectorField(
-                "v", "HNSW", {"TYPE": "FLOAT32", "DIM": 2, "DISTANCE_METRIC": "L2"}
-            ),
+        client.hset(
+            "doc2",
+            mapping={
+                "name": "dog book",
+                "description": "an animal book about dogs",
+                "vector": np.array([0.2, 0.1]).astype(np.float32).tobytes(),
+            },
         )
-    )
-    client.hset("a", "v", "aaaaaaaa")
-    client.hset("b", "v", "aaaabaaa")
-    client.hset("c", "v", "aaaaabaa")
 
-    query = "*=>[KNN 2 @v $vec]"
-    q = Query(query).return_field("__v_score").sort_by("__v_score", True)
-    res = client.ft().search(q, query_params={"vec": "aaaaaaaa"})
+        query_string = "(@description:animal)=>[KNN 3 @vector $vec_param AS dist]"
+        req = (
+            aggregations.AggregateRequest(query_string)
+            .scorer("BM25")
+            .add_scores()
+            .apply(hybrid_score="@__score + @dist")
+            .load("*")
+            .dialect(4)
+        )
 
-    if is_resp2_connection(client):
-        assert "a" == res.docs[0].id
-        assert "0" == res.docs[0].__getattribute__("__v_score")
-    else:
-        assert "a" == res["results"][0]["id"]
-        assert "0" == res["results"][0]["extra_attributes"]["__v_score"]
+        res = client.ft().aggregate(
+            req,
+            query_params={
+                "vec_param": np.array([0.11, 0.21]).astype(np.float32).tobytes()
+            },
+        )
 
+        if isinstance(res, dict):
+            assert len(res["results"]) == 2
+        else:
+            assert len(res.rows) == 2
+            for row in res.rows:
+                len(row) == 6
+
+
+class TestSearchWithJsonIndex(SearchTestsBase):
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.2.0", "search")
+    def test_create_json_with_alias(self, client):
+        """
+        Create definition with IndexType.JSON as index type (ON JSON) with two
+        fields with aliases, and use json client to test it.
+        """
+        definition = IndexDefinition(prefix=["king:"], index_type=IndexType.JSON)
+        client.ft().create_index(
+            (TextField("$.name", as_name="name"), NumericField("$.num", as_name="num")),
+            definition=definition,
+        )
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-def test_vector_field_error(r):
-    r.flushdb()
+        client.json().set("king:1", Path.root_path(), {"name": "henry", "num": 42})
+        client.json().set("king:2", Path.root_path(), {"name": "james", "num": 3.14})
 
-    # sortable tag
-    with pytest.raises(Exception):
-        r.ft().create_index((VectorField("v", "HNSW", {}, sortable=True),))
+        if is_resp2_connection(client):
+            res = client.ft().search("@name:henry")
+            assert res.docs[0].id == "king:1"
+            assert res.docs[0].json == '{"name":"henry","num":42}'
+            assert res.total == 1
+
+            res = client.ft().search("@num:[0 10]")
+            assert res.docs[0].id == "king:2"
+            assert res.docs[0].json == '{"name":"james","num":3.14}'
+            assert res.total == 1
+        else:
+            res = client.ft().search("@name:henry")
+            assert res["results"][0]["id"] == "king:1"
+            assert (
+                res["results"][0]["extra_attributes"]["$"]
+                == '{"name":"henry","num":42}'
+            )
+            assert res["total_results"] == 1
 
-    # not supported algorithm
-    with pytest.raises(Exception):
-        r.ft().create_index((VectorField("v", "SORT", {}),))
+            res = client.ft().search("@num:[0 10]")
+            assert res["results"][0]["id"] == "king:2"
+            assert (
+                res["results"][0]["extra_attributes"]["$"]
+                == '{"name":"james","num":3.14}'
+            )
+            assert res["total_results"] == 1
 
+        # Tests returns an error if path contain special characters (user should
+        # use an alias)
+        with pytest.raises(Exception):
+            client.ft().search("@$.name:henry")
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.2.0", "search")
+    def test_json_with_multipath(self, client):
+        """
+        Create definition with IndexType.JSON as index type (ON JSON),
+        and use json client to test it.
+        """
+        definition = IndexDefinition(prefix=["king:"], index_type=IndexType.JSON)
+        client.ft().create_index(
+            (TagField("$..name", as_name="name")), definition=definition
+        )
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-def test_text_params(client):
-    client.flushdb()
-    client.ft().create_index((TextField("name"),))
+        client.json().set(
+            "king:1",
+            Path.root_path(),
+            {"name": "henry", "country": {"name": "england"}},
+        )
 
-    client.hset("doc1", mapping={"name": "Alice"})
-    client.hset("doc2", mapping={"name": "Bob"})
-    client.hset("doc3", mapping={"name": "Carol"})
+        if is_resp2_connection(client):
+            res = client.ft().search("@name:{henry}")
+            assert res.docs[0].id == "king:1"
+            assert res.docs[0].json == '{"name":"henry","country":{"name":"england"}}'
+            assert res.total == 1
+
+            res = client.ft().search("@name:{england}")
+            assert res.docs[0].id == "king:1"
+            assert res.docs[0].json == '{"name":"henry","country":{"name":"england"}}'
+            assert res.total == 1
+        else:
+            res = client.ft().search("@name:{henry}")
+            assert res["results"][0]["id"] == "king:1"
+            assert (
+                res["results"][0]["extra_attributes"]["$"]
+                == '{"name":"henry","country":{"name":"england"}}'
+            )
+            assert res["total_results"] == 1
 
-    params_dict = {"name1": "Alice", "name2": "Bob"}
-    q = Query("@name:($name1 | $name2 )")
-    res = client.ft().search(q, query_params=params_dict)
-    if is_resp2_connection(client):
-        assert 2 == res.total
-        assert "doc1" == res.docs[0].id
-        assert "doc2" == res.docs[1].id
-    else:
-        assert 2 == res["total_results"]
-        assert "doc1" == res["results"][0]["id"]
-        assert "doc2" == res["results"][1]["id"]
+            res = client.ft().search("@name:{england}")
+            assert res["results"][0]["id"] == "king:1"
+            assert (
+                res["results"][0]["extra_attributes"]["$"]
+                == '{"name":"henry","country":{"name":"england"}}'
+            )
+            assert res["total_results"] == 1
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.2.0", "search")
+    def test_json_with_jsonpath(self, client):
+        definition = IndexDefinition(index_type=IndexType.JSON)
+        client.ft().create_index(
+            (
+                TextField('$["prod:name"]', as_name="name"),
+                TextField("$.prod:name", as_name="name_unsupported"),
+            ),
+            definition=definition,
+        )
 
+        client.json().set("doc:1", Path.root_path(), {"prod:name": "RediSearch"})
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-def test_numeric_params(client):
-    client.flushdb()
-    client.ft().create_index((NumericField("numval"),))
+        if is_resp2_connection(client):
+            # query for a supported field succeeds
+            res = client.ft().search(Query("@name:RediSearch"))
+            assert res.total == 1
+            assert res.docs[0].id == "doc:1"
+            assert res.docs[0].json == '{"prod:name":"RediSearch"}'
+
+            # query for an unsupported field
+            res = client.ft().search("@name_unsupported:RediSearch")
+            assert res.total == 1
+
+            # return of a supported field succeeds
+            res = client.ft().search(Query("@name:RediSearch").return_field("name"))
+            assert res.total == 1
+            assert res.docs[0].id == "doc:1"
+            assert res.docs[0].name == "RediSearch"
+        else:
+            # query for a supported field succeeds
+            res = client.ft().search(Query("@name:RediSearch"))
+            assert res["total_results"] == 1
+            assert res["results"][0]["id"] == "doc:1"
+            assert (
+                res["results"][0]["extra_attributes"]["$"]
+                == '{"prod:name":"RediSearch"}'
+            )
 
-    client.hset("doc1", mapping={"numval": 101})
-    client.hset("doc2", mapping={"numval": 102})
-    client.hset("doc3", mapping={"numval": 103})
+            # query for an unsupported field
+            res = client.ft().search("@name_unsupported:RediSearch")
+            assert res["total_results"] == 1
+
+            # return of a supported field succeeds
+            res = client.ft().search(Query("@name:RediSearch").return_field("name"))
+            assert res["total_results"] == 1
+            assert res["results"][0]["id"] == "doc:1"
+            assert res["results"][0]["extra_attributes"]["name"] == "RediSearch"
+
+
+class TestProfile(SearchTestsBase):
+    @pytest.mark.redismod
+    @pytest.mark.onlynoncluster
+    @skip_if_redis_enterprise()
+    @skip_if_server_version_gte("7.9.0")
+    @skip_if_server_version_lt("6.3.0")
+    def test_profile(self, client):
+        client.ft().create_index((TextField("t"),))
+        client.ft().client.hset("1", "t", "hello")
+        client.ft().client.hset("2", "t", "world")
+
+        # check using Query
+        q = Query("hello|world").no_content()
+        if is_resp2_connection(client):
+            res, det = client.ft().profile(q)
+            det = det.info
 
-    params_dict = {"min": 101, "max": 102}
-    q = Query("@numval:[$min $max]")
-    res = client.ft().search(q, query_params=params_dict)
+            assert isinstance(det, list)
+            assert len(res.docs) == 2  # check also the search result
 
-    if is_resp2_connection(client):
-        assert 2 == res.total
-        assert "doc1" == res.docs[0].id
-        assert "doc2" == res.docs[1].id
-    else:
-        assert 2 == res["total_results"]
-        assert "doc1" == res["results"][0]["id"]
-        assert "doc2" == res["results"][1]["id"]
-
-
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-def test_geo_params(client):
-    client.ft().create_index(GeoField("g"))
-    client.hset("doc1", mapping={"g": "29.69465, 34.95126"})
-    client.hset("doc2", mapping={"g": "29.69350, 34.94737"})
-    client.hset("doc3", mapping={"g": "29.68746, 34.94882"})
-
-    params_dict = {"lat": "34.95126", "lon": "29.69465", "radius": 1000, "units": "km"}
-    q = Query("@g:[$lon $lat $radius $units]")
-    res = client.ft().search(q, query_params=params_dict)
-    _assert_search_result(client, res, ["doc1", "doc2", "doc3"])
-
-
-@pytest.mark.redismod
-@skip_if_server_version_lt("7.4.0")
-@skip_ifmodversion_lt("2.10.0", "search")
-def test_geoshapes_query_intersects_and_disjoint(client):
-    client.ft().create_index((GeoShapeField("g", coord_system=GeoShapeField.FLAT)))
-    client.hset("doc_point1", mapping={"g": "POINT (10 10)"})
-    client.hset("doc_point2", mapping={"g": "POINT (50 50)"})
-    client.hset("doc_polygon1", mapping={"g": "POLYGON ((20 20, 25 35, 35 25, 20 20))"})
-    client.hset(
-        "doc_polygon2", mapping={"g": "POLYGON ((60 60, 65 75, 70 70, 65 55, 60 60))"}
-    )
-
-    intersection = client.ft().search(
-        Query("@g:[intersects $shape]").dialect(3),
-        query_params={"shape": "POLYGON((15 15, 75 15, 50 70, 20 40, 15 15))"},
-    )
-    _assert_search_result(client, intersection, ["doc_point2", "doc_polygon1"])
-
-    disjunction = client.ft().search(
-        Query("@g:[disjoint $shape]").dialect(3),
-        query_params={"shape": "POLYGON((15 15, 75 15, 50 70, 20 40, 15 15))"},
-    )
-    _assert_search_result(client, disjunction, ["doc_point1", "doc_polygon2"])
-
-
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.10.0", "search")
-def test_geoshapes_query_contains_and_within(client):
-    client.ft().create_index((GeoShapeField("g", coord_system=GeoShapeField.FLAT)))
-    client.hset("doc_point1", mapping={"g": "POINT (10 10)"})
-    client.hset("doc_point2", mapping={"g": "POINT (50 50)"})
-    client.hset("doc_polygon1", mapping={"g": "POLYGON ((20 20, 25 35, 35 25, 20 20))"})
-    client.hset(
-        "doc_polygon2", mapping={"g": "POLYGON ((60 60, 65 75, 70 70, 65 55, 60 60))"}
-    )
-
-    contains_a = client.ft().search(
-        Query("@g:[contains $shape]").dialect(3),
-        query_params={"shape": "POINT(25 25)"},
-    )
-    _assert_search_result(client, contains_a, ["doc_polygon1"])
-
-    contains_b = client.ft().search(
-        Query("@g:[contains $shape]").dialect(3),
-        query_params={"shape": "POLYGON((24 24, 24 26, 25 25, 24 24))"},
-    )
-    _assert_search_result(client, contains_b, ["doc_polygon1"])
-
-    within = client.ft().search(
-        Query("@g:[within $shape]").dialect(3),
-        query_params={"shape": "POLYGON((15 15, 75 15, 50 70, 20 40, 15 15))"},
-    )
-    _assert_search_result(client, within, ["doc_point2", "doc_polygon1"])
-
-
-@pytest.mark.redismod
-@skip_if_redis_enterprise()
-def test_search_commands_in_pipeline(client):
-    p = client.ft().pipeline()
-    p.create_index((TextField("txt"),))
-    p.hset("doc1", mapping={"txt": "foo bar"})
-    p.hset("doc2", mapping={"txt": "foo bar"})
-    q = Query("foo bar").with_payloads()
-    p.search(q)
-    res = p.execute()
-    if is_resp2_connection(client):
-        assert res[:3] == ["OK", True, True]
-        assert 2 == res[3][0]
-        assert "doc1" == res[3][1]
-        assert "doc2" == res[3][4]
-        assert res[3][5] is None
-        assert res[3][3] == res[3][6] == ["txt", "foo bar"]
-    else:
-        assert res[:3] == ["OK", True, True]
-        assert 2 == res[3]["total_results"]
-        assert "doc1" == res[3]["results"][0]["id"]
-        assert "doc2" == res[3]["results"][1]["id"]
-        assert res[3]["results"][0]["payload"] is None
-        assert (
-            res[3]["results"][0]["extra_attributes"]
-            == res[3]["results"][1]["extra_attributes"]
-            == {"txt": "foo bar"}
-        )
-
-
-@pytest.mark.redismod
-@pytest.mark.onlynoncluster
-@skip_ifmodversion_lt("2.4.3", "search")
-def test_dialect_config(client):
-    assert client.ft().config_get("DEFAULT_DIALECT")
-    client.ft().config_set("DEFAULT_DIALECT", 2)
-    assert client.ft().config_get("DEFAULT_DIALECT") == {"DEFAULT_DIALECT": "2"}
-    with pytest.raises(redis.ResponseError):
-        client.ft().config_set("DEFAULT_DIALECT", 0)
-
-
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-def test_dialect(client):
-    client.ft().create_index(
-        (
-            TagField("title"),
-            TextField("t1"),
-            TextField("t2"),
-            NumericField("num"),
-            VectorField(
-                "v", "HNSW", {"TYPE": "FLOAT32", "DIM": 1, "DISTANCE_METRIC": "COSINE"}
-            ),
+            # check using AggregateRequest
+            req = (
+                aggregations.AggregateRequest("*")
+                .load("t")
+                .apply(prefix="startswith(@t, 'hel')")
+            )
+            res, det = client.ft().profile(req)
+            det = det.info
+            assert isinstance(det, list)
+            assert len(res.rows) == 2  # check also the search result
+        else:
+            res = client.ft().profile(q)
+            res = res.info
+
+            assert isinstance(res, dict)
+            assert len(res["results"]) == 2  # check also the search result
+
+            # check using AggregateRequest
+            req = (
+                aggregations.AggregateRequest("*")
+                .load("t")
+                .apply(prefix="startswith(@t, 'hel')")
+            )
+            res = client.ft().profile(req)
+            res = res.info
+
+            assert isinstance(res, dict)
+            assert len(res["results"]) == 2  # check also the search result
+
+    @pytest.mark.redismod
+    @pytest.mark.onlynoncluster
+    @skip_if_redis_enterprise()
+    @skip_if_server_version_lt("7.9.0")
+    def test_profile_with_coordinator(self, client):
+        client.ft().create_index((TextField("t"),))
+        client.ft().client.hset("1", "t", "hello")
+        client.ft().client.hset("2", "t", "world")
+
+        # check using Query
+        q = Query("hello|world").no_content()
+        if is_resp2_connection(client):
+            res, det = client.ft().profile(q)
+            det = det.info
+
+            assert isinstance(det, list)
+            assert len(res.docs) == 2  # check also the search result
+
+            # check using AggregateRequest
+            req = (
+                aggregations.AggregateRequest("*")
+                .load("t")
+                .apply(prefix="startswith(@t, 'hel')")
+            )
+            res, det = client.ft().profile(req)
+            det = det.info
+
+            assert isinstance(det, list)
+            assert det[0] == "Shards"
+            assert det[2] == "Coordinator"
+            assert len(res.rows) == 2  # check also the search result
+        else:
+            res = client.ft().profile(q)
+            res = res.info
+
+            assert isinstance(res, dict)
+            assert len(res["Results"]["results"]) == 2  # check also the search result
+
+            # check using AggregateRequest
+            req = (
+                aggregations.AggregateRequest("*")
+                .load("t")
+                .apply(prefix="startswith(@t, 'hel')")
+            )
+            res = client.ft().profile(req)
+            res = res.info
+
+            assert isinstance(res, dict)
+            assert len(res["Results"]["results"]) == 2  # check also the search result
+
+    @pytest.mark.redismod
+    @pytest.mark.onlynoncluster
+    @skip_if_server_version_gte("7.9.0")
+    @skip_if_server_version_lt("6.3.0")
+    def test_profile_limited(self, client):
+        client.ft().create_index((TextField("t"),))
+        client.ft().client.hset("1", "t", "hello")
+        client.ft().client.hset("2", "t", "hell")
+        client.ft().client.hset("3", "t", "help")
+        client.ft().client.hset("4", "t", "helowa")
+
+        q = Query("%hell% hel*")
+        if is_resp2_connection(client):
+            res, det = client.ft().profile(q, limited=True)
+            det = det.info
+            assert det[4][1][7][9] == "The number of iterators in the union is 3"
+            assert det[4][1][8][9] == "The number of iterators in the union is 4"
+            assert det[4][1][1] == "INTERSECT"
+            assert len(res.docs) == 3  # check also the search result
+        else:
+            res = client.ft().profile(q, limited=True)
+            res = res.info
+            iterators_profile = res["profile"]["Iterators profile"]
+            assert (
+                iterators_profile[0]["Child iterators"][0]["Child iterators"]
+                == "The number of iterators in the union is 3"
+            )
+            assert (
+                iterators_profile[0]["Child iterators"][1]["Child iterators"]
+                == "The number of iterators in the union is 4"
+            )
+            assert iterators_profile[0]["Type"] == "INTERSECT"
+            assert len(res["results"]) == 3  # check also the search result
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_gte("7.9.0")
+    @skip_if_server_version_lt("6.3.0")
+    def test_profile_query_params(self, client):
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v", "HNSW", {"TYPE": "FLOAT32", "DIM": 2, "DISTANCE_METRIC": "L2"}
+                ),
+            )
         )
-    )
-    client.hset("h", "t1", "hello")
-    with pytest.raises(redis.ResponseError) as err:
-        client.ft().explain(Query("(*)").dialect(1))
-    assert "Syntax error" in str(err)
-    assert "WILDCARD" in client.ft().explain(Query("(*)"))
-
-    with pytest.raises(redis.ResponseError) as err:
-        client.ft().explain(Query("$hello").dialect(1))
-    assert "Syntax error" in str(err)
-    q = Query("$hello")
-    expected = "UNION {\n  hello\n  +hello(expanded)\n}\n"
-    assert expected in client.ft().explain(q, query_params={"hello": "hello"})
-
-    expected = "NUMERIC {0.000000 <= @num <= 10.000000}\n"
-    assert expected in client.ft().explain(Query("@title:(@num:[0 10])").dialect(1))
-    with pytest.raises(redis.ResponseError) as err:
-        client.ft().explain(Query("@title:(@num:[0 10])"))
-    assert "Syntax error" in str(err)
-
-
-@pytest.mark.redismod
-def test_expire_while_search(client: redis.Redis):
-    client.ft().create_index((TextField("txt"),))
-    client.hset("hset:1", "txt", "a")
-    client.hset("hset:2", "txt", "b")
-    client.hset("hset:3", "txt", "c")
-    if is_resp2_connection(client):
-        assert 3 == client.ft().search(Query("*")).total
-        client.pexpire("hset:2", 300)
-        for _ in range(500):
-            client.ft().search(Query("*")).docs[1]
-        time.sleep(1)
-        assert 2 == client.ft().search(Query("*")).total
-    else:
-        assert 3 == client.ft().search(Query("*"))["total_results"]
-        client.pexpire("hset:2", 300)
-        for _ in range(500):
-            client.ft().search(Query("*"))["results"][1]
-        time.sleep(1)
-        assert 2 == client.ft().search(Query("*"))["total_results"]
-
-
-@pytest.mark.redismod
-@pytest.mark.experimental
-def test_withsuffixtrie(client: redis.Redis):
-    # create index
-    assert client.ft().create_index((TextField("txt"),))
-    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
-    if is_resp2_connection(client):
-        info = client.ft().info()
-        assert "WITHSUFFIXTRIE" not in info["attributes"][0]
-        assert client.ft().dropindex()
+        client.hset("a", "v", "aaaaaaaa")
+        client.hset("b", "v", "aaaabaaa")
+        client.hset("c", "v", "aaaaabaa")
+        query = "*=>[KNN 2 @v $vec]"
+        q = Query(query).return_field("__v_score").sort_by("__v_score", True)
+        if is_resp2_connection(client):
+            res, det = client.ft().profile(q, query_params={"vec": "aaaaaaaa"})
+            det = det.info
+            assert det[4][1][5] == 2.0
+            assert det[4][1][1] == "VECTOR"
+            assert res.total == 2
+            assert "a" == res.docs[0].id
+            assert "0" == res.docs[0].__getattribute__("__v_score")
+        else:
+            res = client.ft().profile(q, query_params={"vec": "aaaaaaaa"})
+            res = res.info
+            assert res["profile"]["Iterators profile"][0]["Counter"] == 2
+            assert res["profile"]["Iterators profile"][0]["Type"] == "VECTOR"
+            assert res["total_results"] == 2
+            assert "a" == res["results"][0]["id"]
+            assert "0" == res["results"][0]["extra_attributes"]["__v_score"]
+
+
+class TestDifferentFieldTypesSearch(SearchTestsBase):
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    def test_vector_field(self, client):
+        client.flushdb()
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v", "HNSW", {"TYPE": "FLOAT32", "DIM": 2, "DISTANCE_METRIC": "L2"}
+                ),
+            )
+        )
+        client.hset("a", "v", "aaaaaaaa")
+        client.hset("b", "v", "aaaabaaa")
+        client.hset("c", "v", "aaaaabaa")
 
-        # create withsuffixtrie index (text fields)
-        assert client.ft().create_index(TextField("t", withsuffixtrie=True))
-        waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
-        info = client.ft().info()
-        assert "WITHSUFFIXTRIE" in info["attributes"][0]
-        assert client.ft().dropindex()
+        query = "*=>[KNN 2 @v $vec]"
+        q = Query(query).return_field("__v_score").sort_by("__v_score", True)
+        res = client.ft().search(q, query_params={"vec": "aaaaaaaa"})
 
-        # create withsuffixtrie index (tag field)
-        assert client.ft().create_index(TagField("t", withsuffixtrie=True))
-        waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
-        info = client.ft().info()
-        assert "WITHSUFFIXTRIE" in info["attributes"][0]
-    else:
-        info = client.ft().info()
-        assert "WITHSUFFIXTRIE" not in info["attributes"][0]["flags"]
-        assert client.ft().dropindex()
+        if is_resp2_connection(client):
+            assert "a" == res.docs[0].id
+            assert "0" == res.docs[0].__getattribute__("__v_score")
+        else:
+            assert "a" == res["results"][0]["id"]
+            assert "0" == res["results"][0]["extra_attributes"]["__v_score"]
 
-        # create withsuffixtrie index (text fields)
-        assert client.ft().create_index(TextField("t", withsuffixtrie=True))
-        waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
-        info = client.ft().info()
-        assert "WITHSUFFIXTRIE" in info["attributes"][0]["flags"]
-        assert client.ft().dropindex()
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    def test_vector_field_error(self, r):
+        r.flushdb()
 
-        # create withsuffixtrie index (tag field)
-        assert client.ft().create_index(TagField("t", withsuffixtrie=True))
-        waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
-        info = client.ft().info()
-        assert "WITHSUFFIXTRIE" in info["attributes"][0]["flags"]
-
-
-@pytest.mark.redismod
-def test_query_timeout(r: redis.Redis):
-    q1 = Query("foo").timeout(5000)
-    assert q1.get_args() == ["foo", "TIMEOUT", 5000, "DIALECT", 2, "LIMIT", 0, 10]
-    q1 = Query("foo").timeout(0)
-    assert q1.get_args() == ["foo", "TIMEOUT", 0, "DIALECT", 2, "LIMIT", 0, 10]
-    q2 = Query("foo").timeout("not_a_number")
-    with pytest.raises(redis.ResponseError):
-        r.ft().search(q2)
-
-
-@pytest.mark.redismod
-@skip_if_server_version_lt("7.2.0")
-@skip_ifmodversion_lt("2.8.4", "search")
-def test_geoshape(client: redis.Redis):
-    client.ft().create_index(GeoShapeField("geom", GeoShapeField.FLAT))
-    waitForIndex(client, getattr(client.ft(), "index_name", "idx"))
-    client.hset("small", "geom", "POLYGON((1 1, 1 100, 100 100, 100 1, 1 1))")
-    client.hset("large", "geom", "POLYGON((1 1, 1 200, 200 200, 200 1, 1 1))")
-    q1 = Query("@geom:[WITHIN $poly]").dialect(3)
-    qp1 = {"poly": "POLYGON((0 0, 0 150, 150 150, 150 0, 0 0))"}
-    q2 = Query("@geom:[CONTAINS $poly]").dialect(3)
-    qp2 = {"poly": "POLYGON((2 2, 2 50, 50 50, 50 2, 2 2))"}
-    result = client.ft().search(q1, query_params=qp1)
-    _assert_search_result(client, result, ["small"])
-    result = client.ft().search(q2, query_params=qp2)
-    _assert_search_result(client, result, ["small", "large"])
-
-
-@pytest.mark.redismod
-@skip_if_server_version_lt("7.4.0")
-@skip_ifmodversion_lt("2.10.0", "search")
-def test_search_missing_fields(client):
-    definition = IndexDefinition(prefix=["property:"], index_type=IndexType.HASH)
-
-    fields = [
-        TextField("title", sortable=True),
-        TagField("features", index_missing=True),
-        TextField("description", index_missing=True),
-    ]
-
-    client.ft().create_index(fields, definition=definition)
-
-    # All fields present
-    client.hset(
-        "property:1",
-        mapping={
-            "title": "Luxury Villa in Malibu",
-            "features": "pool,sea view,modern",
-            "description": "A stunning modern villa overlooking the Pacific Ocean.",
-        },
-    )
-
-    # Missing features
-    client.hset(
-        "property:2",
-        mapping={
-            "title": "Downtown Flat",
-            "description": "Modern flat in central Paris with easy access to metro.",
-        },
-    )
-
-    # Missing description
-    client.hset(
-        "property:3",
-        mapping={
-            "title": "Beachfront Bungalow",
-            "features": "beachfront,sun deck",
-        },
-    )
-
-    with pytest.raises(redis.exceptions.ResponseError):
-        client.ft().search(Query("ismissing(@title)").return_field("id").no_content())
-
-    res = client.ft().search(
-        Query("ismissing(@features)").return_field("id").no_content()
-    )
-    _assert_search_result(client, res, ["property:2"])
-
-    res = client.ft().search(
-        Query("-ismissing(@features)").return_field("id").no_content()
-    )
-    _assert_search_result(client, res, ["property:1", "property:3"])
-
-    res = client.ft().search(
-        Query("ismissing(@description)").return_field("id").no_content()
-    )
-    _assert_search_result(client, res, ["property:3"])
-
-    res = client.ft().search(
-        Query("-ismissing(@description)").return_field("id").no_content()
-    )
-    _assert_search_result(client, res, ["property:1", "property:2"])
-
-
-@pytest.mark.redismod
-@skip_if_server_version_lt("7.4.0")
-@skip_ifmodversion_lt("2.10.0", "search")
-def test_create_index_empty_or_missing_fields_with_sortable(client):
-    definition = IndexDefinition(prefix=["property:"], index_type=IndexType.HASH)
-
-    fields = [
-        TextField("title", sortable=True, index_empty=True),
-        TagField("features", index_missing=True, sortable=True),
-        TextField("description", no_index=True, sortable=True),
-    ]
-
-    client.ft().create_index(fields, definition=definition)
-
-
-@pytest.mark.redismod
-@skip_if_server_version_lt("7.4.0")
-@skip_ifmodversion_lt("2.10.0", "search")
-def test_search_empty_fields(client):
-    definition = IndexDefinition(prefix=["property:"], index_type=IndexType.HASH)
-
-    fields = [
-        TextField("title", sortable=True),
-        TagField("features", index_empty=True),
-        TextField("description", index_empty=True),
-    ]
-
-    client.ft().create_index(fields, definition=definition)
-
-    # All fields present
-    client.hset(
-        "property:1",
-        mapping={
-            "title": "Luxury Villa in Malibu",
-            "features": "pool,sea view,modern",
-            "description": "A stunning modern villa overlooking the Pacific Ocean.",
-        },
-    )
-
-    # Empty features
-    client.hset(
-        "property:2",
-        mapping={
-            "title": "Downtown Flat",
-            "features": "",
-            "description": "Modern flat in central Paris with easy access to metro.",
-        },
-    )
-
-    # Empty description
-    client.hset(
-        "property:3",
-        mapping={
-            "title": "Beachfront Bungalow",
-            "features": "beachfront,sun deck",
-            "description": "",
-        },
-    )
-
-    with pytest.raises(redis.exceptions.ResponseError) as e:
-        client.ft().search(Query("@title:''").return_field("id").no_content())
-    assert "Use `INDEXEMPTY` in field creation" in e.value.args[0]
-
-    res = client.ft().search(
-        Query("@features:{$empty}").return_field("id").no_content(),
-        query_params={"empty": ""},
-    )
-    _assert_search_result(client, res, ["property:2"])
-
-    res = client.ft().search(
-        Query("-@features:{$empty}").return_field("id").no_content(),
-        query_params={"empty": ""},
-    )
-    _assert_search_result(client, res, ["property:1", "property:3"])
-
-    res = client.ft().search(Query("@description:''").return_field("id").no_content())
-    _assert_search_result(client, res, ["property:3"])
-
-    res = client.ft().search(Query("-@description:''").return_field("id").no_content())
-    _assert_search_result(client, res, ["property:1", "property:2"])
-
-
-@pytest.mark.redismod
-@skip_if_server_version_lt("7.4.0")
-@skip_ifmodversion_lt("2.10.0", "search")
-def test_special_characters_in_fields(client):
-    definition = IndexDefinition(prefix=["resource:"], index_type=IndexType.HASH)
-
-    fields = [
-        TagField("uuid"),
-        TagField("tags", separator="|"),
-        TextField("description"),
-        NumericField("rating"),
-    ]
-
-    client.ft().create_index(fields, definition=definition)
-
-    client.hset(
-        "resource:1",
-        mapping={
-            "uuid": "123e4567-e89b-12d3-a456-426614174000",
-            "tags": "finance|crypto|$btc|blockchain",
-            "description": "Analysis of blockchain technologies & Bitcoin's potential.",
-            "rating": 5,
-        },
-    )
-
-    client.hset(
-        "resource:2",
-        mapping={
-            "uuid": "987e6543-e21c-12d3-a456-426614174999",
-            "tags": "health|well-being|fitness|new-year's-resolutions",
-            "description": "Health trends for the new year, including fitness regimes.",
-            "rating": 4,
-        },
-    )
-
-    # no need to escape - when using params
-    res = client.ft().search(
-        Query("@uuid:{$uuid}"),
-        query_params={"uuid": "123e4567-e89b-12d3-a456-426614174000"},
-    )
-    _assert_search_result(client, res, ["resource:1"])
-
-    # with double quotes exact match no need to escape the - even without params
-    res = client.ft().search(Query('@uuid:{"123e4567-e89b-12d3-a456-426614174000"}'))
-    _assert_search_result(client, res, ["resource:1"])
-
-    res = client.ft().search(Query('@tags:{"new-year\'s-resolutions"}'))
-    _assert_search_result(client, res, ["resource:2"])
-
-    # possible to search numeric fields by single value
-    res = client.ft().search(Query("@rating:[4]"))
-    _assert_search_result(client, res, ["resource:2"])
-
-    # some chars still need escaping
-    res = client.ft().search(Query(r"@tags:{\$btc}"))
-    _assert_search_result(client, res, ["resource:1"])
-
-
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-def test_vector_search_with_default_dialect(client):
-    client.ft().create_index(
-        (
-            VectorField(
-                "v", "HNSW", {"TYPE": "FLOAT32", "DIM": 2, "DISTANCE_METRIC": "L2"}
-            ),
+        # sortable tag
+        with pytest.raises(Exception):
+            r.ft().create_index((VectorField("v", "HNSW", {}, sortable=True),))
+
+        # not supported algorithm
+        with pytest.raises(Exception):
+            r.ft().create_index((VectorField("v", "SORT", {}),))
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    def test_text_params(self, client):
+        client.flushdb()
+        client.ft().create_index((TextField("name"),))
+
+        client.hset("doc1", mapping={"name": "Alice"})
+        client.hset("doc2", mapping={"name": "Bob"})
+        client.hset("doc3", mapping={"name": "Carol"})
+
+        params_dict = {"name1": "Alice", "name2": "Bob"}
+        q = Query("@name:($name1 | $name2 )")
+        res = client.ft().search(q, query_params=params_dict)
+        if is_resp2_connection(client):
+            assert 2 == res.total
+            assert "doc1" == res.docs[0].id
+            assert "doc2" == res.docs[1].id
+        else:
+            assert 2 == res["total_results"]
+            assert "doc1" == res["results"][0]["id"]
+            assert "doc2" == res["results"][1]["id"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    def test_numeric_params(self, client):
+        client.flushdb()
+        client.ft().create_index((NumericField("numval"),))
+
+        client.hset("doc1", mapping={"numval": 101})
+        client.hset("doc2", mapping={"numval": 102})
+        client.hset("doc3", mapping={"numval": 103})
+
+        params_dict = {"min": 101, "max": 102}
+        q = Query("@numval:[$min $max]")
+        res = client.ft().search(q, query_params=params_dict)
+
+        if is_resp2_connection(client):
+            assert 2 == res.total
+            assert "doc1" == res.docs[0].id
+            assert "doc2" == res.docs[1].id
+        else:
+            assert 2 == res["total_results"]
+            assert "doc1" == res["results"][0]["id"]
+            assert "doc2" == res["results"][1]["id"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    def test_geo_params(self, client):
+        client.ft().create_index(GeoField("g"))
+        client.hset("doc1", mapping={"g": "29.69465, 34.95126"})
+        client.hset("doc2", mapping={"g": "29.69350, 34.94737"})
+        client.hset("doc3", mapping={"g": "29.68746, 34.94882"})
+
+        params_dict = {
+            "lat": "34.95126",
+            "lon": "29.69465",
+            "radius": 1000,
+            "units": "km",
+        }
+        q = Query("@g:[$lon $lat $radius $units]")
+        res = client.ft().search(q, query_params=params_dict)
+        _assert_search_result(client, res, ["doc1", "doc2", "doc3"])
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.4.0")
+    @skip_ifmodversion_lt("2.10.0", "search")
+    def test_geoshapes_query_intersects_and_disjoint(self, client):
+        client.ft().create_index((GeoShapeField("g", coord_system=GeoShapeField.FLAT)))
+        client.hset("doc_point1", mapping={"g": "POINT (10 10)"})
+        client.hset("doc_point2", mapping={"g": "POINT (50 50)"})
+        client.hset(
+            "doc_polygon1", mapping={"g": "POLYGON ((20 20, 25 35, 35 25, 20 20))"}
+        )
+        client.hset(
+            "doc_polygon2",
+            mapping={"g": "POLYGON ((60 60, 65 75, 70 70, 65 55, 60 60))"},
         )
-    )
 
-    client.hset("a", "v", "aaaaaaaa")
-    client.hset("b", "v", "aaaabaaa")
-    client.hset("c", "v", "aaaaabaa")
+        intersection = client.ft().search(
+            Query("@g:[intersects $shape]").dialect(3),
+            query_params={"shape": "POLYGON((15 15, 75 15, 50 70, 20 40, 15 15))"},
+        )
+        _assert_search_result(client, intersection, ["doc_point2", "doc_polygon1"])
 
-    query = "*=>[KNN 2 @v $vec]"
-    q = Query(query)
+        disjunction = client.ft().search(
+            Query("@g:[disjoint $shape]").dialect(3),
+            query_params={"shape": "POLYGON((15 15, 75 15, 50 70, 20 40, 15 15))"},
+        )
+        _assert_search_result(client, disjunction, ["doc_point1", "doc_polygon2"])
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.10.0", "search")
+    def test_geoshapes_query_contains_and_within(self, client):
+        client.ft().create_index((GeoShapeField("g", coord_system=GeoShapeField.FLAT)))
+        client.hset("doc_point1", mapping={"g": "POINT (10 10)"})
+        client.hset("doc_point2", mapping={"g": "POINT (50 50)"})
+        client.hset(
+            "doc_polygon1", mapping={"g": "POLYGON ((20 20, 25 35, 35 25, 20 20))"}
+        )
+        client.hset(
+            "doc_polygon2",
+            mapping={"g": "POLYGON ((60 60, 65 75, 70 70, 65 55, 60 60))"},
+        )
 
-    assert "DIALECT" in q.get_args()
-    assert 2 in q.get_args()
+        contains_a = client.ft().search(
+            Query("@g:[contains $shape]").dialect(3),
+            query_params={"shape": "POINT(25 25)"},
+        )
+        _assert_search_result(client, contains_a, ["doc_polygon1"])
 
-    res = client.ft().search(q, query_params={"vec": "aaaaaaaa"})
-    if is_resp2_connection(client):
-        assert res.total == 2
-    else:
-        assert res["total_results"] == 2
+        contains_b = client.ft().search(
+            Query("@g:[contains $shape]").dialect(3),
+            query_params={"shape": "POLYGON((24 24, 24 26, 25 25, 24 24))"},
+        )
+        _assert_search_result(client, contains_b, ["doc_polygon1"])
 
+        within = client.ft().search(
+            Query("@g:[within $shape]").dialect(3),
+            query_params={"shape": "POLYGON((15 15, 75 15, 50 70, 20 40, 15 15))"},
+        )
+        _assert_search_result(client, within, ["doc_point2", "doc_polygon1"])
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.9.0")
+    def test_vector_search_with_int8_type(self, client):
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v", "FLAT", {"TYPE": "INT8", "DIM": 2, "DISTANCE_METRIC": "L2"}
+                ),
+            )
+        )
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_l2_distance_metric(client):
-    client.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {"TYPE": "FLOAT32", "DIM": 3, "DISTANCE_METRIC": "L2"},
-            ),
+        a = [1.5, 10]
+        b = [123, 100]
+        c = [1, 1]
+
+        client.hset("a", "v", np.array(a, dtype=np.int8).tobytes())
+        client.hset("b", "v", np.array(b, dtype=np.int8).tobytes())
+        client.hset("c", "v", np.array(c, dtype=np.int8).tobytes())
+
+        query = Query("*=>[KNN 2 @v $vec as score]").no_content()
+        query_params = {"vec": np.array(a, dtype=np.int8).tobytes()}
+
+        assert 2 in query.get_args()
+
+        res = client.ft().search(query, query_params=query_params)
+        if is_resp2_connection(client):
+            assert res.total == 2
+        else:
+            assert res["total_results"] == 2
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("7.9.0")
+    def test_vector_search_with_uint8_type(self, client):
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v", "FLAT", {"TYPE": "UINT8", "DIM": 2, "DISTANCE_METRIC": "L2"}
+                ),
+            )
         )
-    )
 
-    # L2 distance test vectors
-    vectors = [[1.0, 0.0, 0.0], [2.0, 0.0, 0.0], [0.0, 1.0, 0.0], [5.0, 0.0, 0.0]]
+        a = [1.5, 10]
+        b = [123, 100]
+        c = [1, 1]
 
-    for i, vec in enumerate(vectors):
-        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+        client.hset("a", "v", np.array(a, dtype=np.uint8).tobytes())
+        client.hset("b", "v", np.array(b, dtype=np.uint8).tobytes())
+        client.hset("c", "v", np.array(c, dtype=np.uint8).tobytes())
 
-    query = Query("*=>[KNN 3 @v $vec as score]").sort_by("score").no_content()
-    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+        query = Query("*=>[KNN 2 @v $vec as score]").no_content()
+        query_params = {"vec": np.array(a, dtype=np.uint8).tobytes()}
 
-    res = client.ft().search(query, query_params=query_params)
-    if is_resp2_connection(client):
-        assert res.total == 3
-        assert "doc0" == res.docs[0].id
-    else:
-        assert res["total_results"] == 3
-        assert "doc0" == res["results"][0]["id"]
+        assert 2 in query.get_args()
 
+        res = client.ft().search(query, query_params=query_params)
+        if is_resp2_connection(client):
+            assert res.total == 2
+        else:
+            assert res["total_results"] == 2
+
+
+class TestPipeline(SearchTestsBase):
+    @pytest.mark.redismod
+    @skip_if_redis_enterprise()
+    def test_search_commands_in_pipeline(self, client):
+        p = client.ft().pipeline()
+        p.create_index((TextField("txt"),))
+        p.hset("doc1", mapping={"txt": "foo bar"})
+        p.hset("doc2", mapping={"txt": "foo bar"})
+        q = Query("foo bar").with_payloads()
+        p.search(q)
+        res = p.execute()
+        if is_resp2_connection(client):
+            assert res[:3] == ["OK", True, True]
+            assert 2 == res[3][0]
+            assert "doc1" == res[3][1]
+            assert "doc2" == res[3][4]
+            assert res[3][5] is None
+            assert res[3][3] == res[3][6] == ["txt", "foo bar"]
+        else:
+            assert res[:3] == ["OK", True, True]
+            assert 2 == res[3]["total_results"]
+            assert "doc1" == res[3]["results"][0]["id"]
+            assert "doc2" == res[3]["results"][1]["id"]
+            assert res[3]["results"][0]["payload"] is None
+            assert (
+                res[3]["results"][0]["extra_attributes"]
+                == res[3]["results"][1]["extra_attributes"]
+                == {"txt": "foo bar"}
+            )
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_cosine_distance_metric(client):
-    client.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {"TYPE": "FLOAT32", "DIM": 3, "DISTANCE_METRIC": "COSINE"},
-            ),
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    def test_hybrid_search_query_with_pipeline(self, client):
+        p = client.ft().pipeline()
+        p.create_index(
+            (
+                TextField("txt"),
+                VectorField(
+                    "embedding",
+                    "FLAT",
+                    {"TYPE": "FLOAT32", "DIM": 4, "DISTANCE_METRIC": "L2"},
+                ),
+            )
         )
-    )
 
-    vectors = [[1.0, 0.0, 0.0], [0.707, 0.707, 0.0], [0.0, 1.0, 0.0], [-1.0, 0.0, 0.0]]
+        p.hset(
+            "doc1",
+            mapping={
+                "txt": "foo bar",
+                "embedding": np.array([1, 2, 3, 4], dtype=np.float32).tobytes(),
+            },
+        )
+        p.hset(
+            "doc2",
+            mapping={
+                "txt": "foo bar",
+                "embedding": np.array([1, 2, 2, 3], dtype=np.float32).tobytes(),
+            },
+        )
 
-    for i, vec in enumerate(vectors):
-        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+        # set search query
+        search_query = HybridSearchQuery("foo")
 
-    query = Query("*=>[KNN 3 @v $vec as score]").sort_by("score").no_content()
-    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([2, 2, 3, 3], dtype=np.float32).tobytes(),
+        )
 
-    res = client.ft().search(query, query_params=query_params)
-    if is_resp2_connection(client):
-        assert res.total == 3
-        assert "doc0" == res.docs[0].id
-    else:
-        assert res["total_results"] == 3
-        assert "doc0" == res["results"][0]["id"]
+        hybrid_query = HybridQuery(search_query, vsim_query)
 
+        p.hybrid_search(query=hybrid_query)
+        res = p.execute()
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_ip_distance_metric(client):
-    client.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {"TYPE": "FLOAT32", "DIM": 3, "DISTANCE_METRIC": "IP"},
+        # the default results count limit is 10
+        assert res[:3] == ["OK", 2, 2]
+        hybrid_search_res = res[3]
+        if is_resp2_connection(client):
+            # it doesn't get parsed to object in pipeline
+            assert hybrid_search_res[0] == "total_results"
+            assert hybrid_search_res[1] == 2
+            assert hybrid_search_res[2] == "results"
+            assert len(hybrid_search_res[3]) == 2
+            assert hybrid_search_res[4] == "warnings"
+            assert hybrid_search_res[5] == []
+            assert hybrid_search_res[6] == "execution_time"
+            assert float(hybrid_search_res[7]) > 0
+        else:
+            assert hybrid_search_res["total_results"] == 2
+            assert len(hybrid_search_res["results"]) == 2
+            assert hybrid_search_res["warnings"] == []
+            assert hybrid_search_res["execution_time"] > 0
+
+
+class TestSearchWithVamana(SearchTestsBase):
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_l2_distance_metric(self, client):
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {"TYPE": "FLOAT32", "DIM": 3, "DISTANCE_METRIC": "L2"},
+                ),
+            )
+        )
+
+        # L2 distance test vectors
+        vectors = [[1.0, 0.0, 0.0], [2.0, 0.0, 0.0], [0.0, 1.0, 0.0], [5.0, 0.0, 0.0]]
+
+        for i, vec in enumerate(vectors):
+            client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+        query = Query("*=>[KNN 3 @v $vec as score]").sort_by("score").no_content()
+        query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+        res = client.ft().search(query, query_params=query_params)
+        if is_resp2_connection(client):
+            assert res.total == 3
+            assert "doc0" == res.docs[0].id
+        else:
+            assert res["total_results"] == 3
+            assert "doc0" == res["results"][0]["id"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_cosine_distance_metric(self, client):
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {"TYPE": "FLOAT32", "DIM": 3, "DISTANCE_METRIC": "COSINE"},
+                ),
+            )
+        )
+
+        vectors = [
+            [1.0, 0.0, 0.0],
+            [0.707, 0.707, 0.0],
+            [0.0, 1.0, 0.0],
+            [-1.0, 0.0, 0.0],
+        ]
+
+        for i, vec in enumerate(vectors):
+            client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+        query = Query("*=>[KNN 3 @v $vec as score]").sort_by("score").no_content()
+        query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+        res = client.ft().search(query, query_params=query_params)
+        if is_resp2_connection(client):
+            assert res.total == 3
+            assert "doc0" == res.docs[0].id
+        else:
+            assert res["total_results"] == 3
+            assert "doc0" == res["results"][0]["id"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_ip_distance_metric(self, client):
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {"TYPE": "FLOAT32", "DIM": 3, "DISTANCE_METRIC": "IP"},
+                ),
+            )
+        )
+
+        vectors = [[1.0, 2.0, 3.0], [2.0, 1.0, 1.0], [3.0, 3.0, 3.0], [0.1, 0.1, 0.1]]
+
+        for i, vec in enumerate(vectors):
+            client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+        query = Query("*=>[KNN 3 @v $vec as score]").sort_by("score").no_content()
+        query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+        res = client.ft().search(query, query_params=query_params)
+        if is_resp2_connection(client):
+            assert res.total == 3
+            assert "doc2" == res.docs[0].id
+        else:
+            assert res["total_results"] == 3
+            assert "doc2" == res["results"][0]["id"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_basic_functionality(self, client):
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {"TYPE": "FLOAT32", "DIM": 4, "DISTANCE_METRIC": "L2"},
+                ),
+            )
+        )
+
+        vectors = [
+            [1.0, 2.0, 3.0, 4.0],
+            [2.0, 3.0, 4.0, 5.0],
+            [3.0, 4.0, 5.0, 6.0],
+            [10.0, 11.0, 12.0, 13.0],
+        ]
+
+        for i, vec in enumerate(vectors):
+            client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+        query = "*=>[KNN 3 @v $vec]"
+        q = Query(query).return_field("__v_score").sort_by("__v_score", True)
+        res = client.ft().search(
+            q, query_params={"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+        )
+
+        if is_resp2_connection(client):
+            assert res.total == 3
+            assert "doc0" == res.docs[0].id  # Should be closest to itself
+            assert "0" == res.docs[0].__getattribute__("__v_score")
+        else:
+            assert res["total_results"] == 3
+            assert "doc0" == res["results"][0]["id"]
+            assert "0" == res["results"][0]["extra_attributes"]["__v_score"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_float16_type(self, client):
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {"TYPE": "FLOAT16", "DIM": 4, "DISTANCE_METRIC": "L2"},
+                ),
+            )
+        )
+
+        vectors = [[1.5, 2.5, 3.5, 4.5], [2.5, 3.5, 4.5, 5.5], [3.5, 4.5, 5.5, 6.5]]
+
+        for i, vec in enumerate(vectors):
+            client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float16).tobytes())
+
+        query = Query("*=>[KNN 2 @v $vec as score]").no_content()
+        query_params = {"vec": np.array(vectors[0], dtype=np.float16).tobytes()}
+
+        res = client.ft().search(query, query_params=query_params)
+        if is_resp2_connection(client):
+            assert res.total == 2
+            assert "doc0" == res.docs[0].id
+        else:
+            assert res["total_results"] == 2
+            assert "doc0" == res["results"][0]["id"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_float32_type(self, client):
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {"TYPE": "FLOAT32", "DIM": 4, "DISTANCE_METRIC": "L2"},
+                ),
+            )
+        )
+
+        vectors = [[1.0, 2.0, 3.0, 4.0], [2.0, 3.0, 4.0, 5.0], [3.0, 4.0, 5.0, 6.0]]
+
+        for i, vec in enumerate(vectors):
+            client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+        query = Query("*=>[KNN 2 @v $vec as score]").no_content()
+        query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+        res = client.ft().search(query, query_params=query_params)
+        if is_resp2_connection(client):
+            assert res.total == 2
+            assert "doc0" == res.docs[0].id
+        else:
+            assert res["total_results"] == 2
+            assert "doc0" == res["results"][0]["id"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_vector_search_with_default_dialect(self, client):
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {"TYPE": "FLOAT32", "DIM": 2, "DISTANCE_METRIC": "L2"},
+                ),
+            )
+        )
+
+        client.hset("a", "v", "aaaaaaaa")
+        client.hset("b", "v", "aaaabaaa")
+        client.hset("c", "v", "aaaaabaa")
+
+        query = "*=>[KNN 2 @v $vec]"
+        q = Query(query).return_field("__v_score").sort_by("__v_score", True)
+        res = client.ft().search(q, query_params={"vec": "aaaaaaaa"})
+
+        if is_resp2_connection(client):
+            assert res.total == 2
+        else:
+            assert res["total_results"] == 2
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_vector_field_basic(self):
+        field = VectorField(
+            "v",
+            "SVS-VAMANA",
+            {"TYPE": "FLOAT32", "DIM": 128, "DISTANCE_METRIC": "COSINE"},
+        )
+
+        # Check that the field was created successfully
+        assert field.name == "v"
+        assert field.args[0] == "VECTOR"
+        assert field.args[1] == "SVS-VAMANA"
+        assert field.args[2] == 6
+        assert "TYPE" in field.args
+        assert "FLOAT32" in field.args
+        assert "DIM" in field.args
+        assert 128 in field.args
+        assert "DISTANCE_METRIC" in field.args
+        assert "COSINE" in field.args
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_lvq8_compression(self, client):
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {
+                        "TYPE": "FLOAT32",
+                        "DIM": 8,
+                        "DISTANCE_METRIC": "L2",
+                        "COMPRESSION": "LVQ8",
+                        "TRAINING_THRESHOLD": 1024,
+                    },
+                ),
+            )
+        )
+
+        vectors = []
+        for i in range(20):
+            vec = [float(i + j) for j in range(8)]
+            vectors.append(vec)
+            client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+        query = Query("*=>[KNN 5 @v $vec as score]").no_content()
+        query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+        res = client.ft().search(query, query_params=query_params)
+        if is_resp2_connection(client):
+            assert res.total == 5
+            assert "doc0" == res.docs[0].id
+        else:
+            assert res["total_results"] == 5
+            assert "doc0" == res["results"][0]["id"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_compression_with_both_vector_types(self, client):
+        # Test FLOAT16 with LVQ8
+        client.ft("idx16").create_index(
+            (
+                VectorField(
+                    "v16",
+                    "SVS-VAMANA",
+                    {
+                        "TYPE": "FLOAT16",
+                        "DIM": 8,
+                        "DISTANCE_METRIC": "L2",
+                        "COMPRESSION": "LVQ8",
+                        "TRAINING_THRESHOLD": 1024,
+                    },
+                ),
+            )
+        )
+
+        # Test FLOAT32 with LVQ8
+        client.ft("idx32").create_index(
+            (
+                VectorField(
+                    "v32",
+                    "SVS-VAMANA",
+                    {
+                        "TYPE": "FLOAT32",
+                        "DIM": 8,
+                        "DISTANCE_METRIC": "L2",
+                        "COMPRESSION": "LVQ8",
+                        "TRAINING_THRESHOLD": 1024,
+                    },
+                ),
+            )
+        )
+
+        # Add data to both indices
+        for i in range(15):
+            vec = [float(i + j) for j in range(8)]
+            client.hset(f"doc16_{i}", "v16", np.array(vec, dtype=np.float16).tobytes())
+            client.hset(f"doc32_{i}", "v32", np.array(vec, dtype=np.float32).tobytes())
+
+        # Test both indices
+        query = Query("*=>[KNN 3 @v16 $vec as score]").no_content()
+        res16 = client.ft("idx16").search(
+            query,
+            query_params={
+                "vec": np.array(
+                    [1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0], dtype=np.float16
+                ).tobytes()
+            },
+        )
+
+        query = Query("*=>[KNN 3 @v32 $vec as score]").no_content()
+        res32 = client.ft("idx32").search(
+            query,
+            query_params={
+                "vec": np.array(
+                    [1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0], dtype=np.float32
+                ).tobytes()
+            },
+        )
+
+        if is_resp2_connection(client):
+            assert res16.total == 3
+            assert res32.total == 3
+        else:
+            assert res16["total_results"] == 3
+            assert res32["total_results"] == 3
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_construction_window_size(self, client):
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {
+                        "TYPE": "FLOAT32",
+                        "DIM": 6,
+                        "DISTANCE_METRIC": "L2",
+                        "CONSTRUCTION_WINDOW_SIZE": 300,
+                    },
+                ),
+            )
+        )
+
+        vectors = []
+        for i in range(20):
+            vec = [float(i + j) for j in range(6)]
+            vectors.append(vec)
+            client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+        query = Query("*=>[KNN 5 @v $vec as score]").no_content()
+        query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+        res = client.ft().search(query, query_params=query_params)
+        if is_resp2_connection(client):
+            assert res.total == 5
+            assert "doc0" == res.docs[0].id
+        else:
+            assert res["total_results"] == 5
+            assert "doc0" == res["results"][0]["id"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_graph_max_degree(self, client):
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {
+                        "TYPE": "FLOAT32",
+                        "DIM": 6,
+                        "DISTANCE_METRIC": "COSINE",
+                        "GRAPH_MAX_DEGREE": 64,
+                    },
+                ),
+            )
+        )
+
+        vectors = []
+        for i in range(25):
+            vec = [float(i + j) for j in range(6)]
+            vectors.append(vec)
+            client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+        query = Query("*=>[KNN 6 @v $vec as score]").no_content()
+        query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+        res = client.ft().search(query, query_params=query_params)
+        if is_resp2_connection(client):
+            assert res.total == 6
+            assert "doc0" == res.docs[0].id
+        else:
+            assert res["total_results"] == 6
+            assert "doc0" == res["results"][0]["id"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_search_window_size(self, client):
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {
+                        "TYPE": "FLOAT32",
+                        "DIM": 6,
+                        "DISTANCE_METRIC": "L2",
+                        "SEARCH_WINDOW_SIZE": 20,
+                    },
+                ),
+            )
+        )
+
+        vectors = []
+        for i in range(30):
+            vec = [float(i + j) for j in range(6)]
+            vectors.append(vec)
+            client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+        query = Query("*=>[KNN 8 @v $vec as score]").no_content()
+        query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+        res = client.ft().search(query, query_params=query_params)
+        if is_resp2_connection(client):
+            assert res.total == 8
+            assert "doc0" == res.docs[0].id
+        else:
+            assert res["total_results"] == 8
+            assert "doc0" == res["results"][0]["id"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_epsilon_parameter(self, client):
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {
+                        "TYPE": "FLOAT32",
+                        "DIM": 6,
+                        "DISTANCE_METRIC": "L2",
+                        "EPSILON": 0.05,
+                    },
+                ),
+            )
+        )
+
+        vectors = []
+        for i in range(20):
+            vec = [float(i + j) for j in range(6)]
+            vectors.append(vec)
+            client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+        query = Query("*=>[KNN 5 @v $vec as score]").no_content()
+        query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+        res = client.ft().search(query, query_params=query_params)
+        if is_resp2_connection(client):
+            assert res.total == 5
+            assert "doc0" == res.docs[0].id
+        else:
+            assert res["total_results"] == 5
+            assert "doc0" == res["results"][0]["id"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_all_build_parameters_combined(self, client):
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {
+                        "TYPE": "FLOAT32",
+                        "DIM": 8,
+                        "DISTANCE_METRIC": "IP",
+                        "CONSTRUCTION_WINDOW_SIZE": 250,
+                        "GRAPH_MAX_DEGREE": 48,
+                        "SEARCH_WINDOW_SIZE": 15,
+                        "EPSILON": 0.02,
+                    },
+                ),
+            )
+        )
+
+        vectors = []
+        for i in range(35):
+            vec = [float(i + j) for j in range(8)]
+            vectors.append(vec)
+            client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+        query = Query("*=>[KNN 7 @v $vec as score]").no_content()
+        query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+        res = client.ft().search(query, query_params=query_params)
+        if is_resp2_connection(client):
+            assert res.total == 7
+            doc_ids = [doc.id for doc in res.docs]
+            assert len(doc_ids) == 7
+        else:
+            assert res["total_results"] == 7
+            doc_ids = [doc["id"] for doc in res["results"]]
+            assert len(doc_ids) == 7
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_comprehensive_configuration(self, client):
+        client.flushdb()
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {
+                        "TYPE": "FLOAT16",
+                        "DIM": 32,
+                        "DISTANCE_METRIC": "COSINE",
+                        "COMPRESSION": "LVQ8",
+                        "CONSTRUCTION_WINDOW_SIZE": 400,
+                        "GRAPH_MAX_DEGREE": 96,
+                        "SEARCH_WINDOW_SIZE": 25,
+                        "EPSILON": 0.03,
+                        "TRAINING_THRESHOLD": 2048,
+                    },
+                ),
+            )
+        )
+
+        vectors = []
+        for i in range(60):
+            vec = [float(i + j) for j in range(32)]
+            vectors.append(vec)
+            client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float16).tobytes())
+
+        query = Query("*=>[KNN 10 @v $vec as score]").no_content()
+        query_params = {"vec": np.array(vectors[0], dtype=np.float16).tobytes()}
+
+        res = client.ft().search(query, query_params=query_params)
+        if is_resp2_connection(client):
+            assert res.total == 10
+            assert "doc0" == res.docs[0].id
+        else:
+            assert res["total_results"] == 10
+            assert "doc0" == res["results"][0]["id"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_hybrid_text_vector_search(self, client):
+        client.flushdb()
+        client.ft().create_index(
+            (
+                TextField("title"),
+                TextField("content"),
+                VectorField(
+                    "embedding",
+                    "SVS-VAMANA",
+                    {
+                        "TYPE": "FLOAT32",
+                        "DIM": 6,
+                        "DISTANCE_METRIC": "COSINE",
+                        "SEARCH_WINDOW_SIZE": 20,
+                    },
+                ),
+            )
+        )
+
+        docs = [
+            {
+                "title": "AI Research",
+                "content": "machine learning algorithms",
+                "embedding": [1.0, 2.0, 3.0, 4.0, 5.0, 6.0],
+            },
+            {
+                "title": "Data Science",
+                "content": "statistical analysis methods",
+                "embedding": [2.0, 3.0, 4.0, 5.0, 6.0, 7.0],
+            },
+            {
+                "title": "Deep Learning",
+                "content": "neural network architectures",
+                "embedding": [3.0, 4.0, 5.0, 6.0, 7.0, 8.0],
+            },
+            {
+                "title": "Computer Vision",
+                "content": "image processing techniques",
+                "embedding": [10.0, 11.0, 12.0, 13.0, 14.0, 15.0],
+            },
+        ]
+
+        for i, doc in enumerate(docs):
+            client.hset(
+                f"doc{i}",
+                mapping={
+                    "title": doc["title"],
+                    "content": doc["content"],
+                    "embedding": np.array(doc["embedding"], dtype=np.float32).tobytes(),
+                },
+            )
+
+        # Hybrid query - text filter + vector similarity
+        query = "(@title:AI|@content:machine)=>[KNN 2 @embedding $vec]"
+        q = (
+            Query(query)
+            .return_field("__embedding_score")
+            .sort_by("__embedding_score", True)
+        )
+        res = client.ft().search(
+            q,
+            query_params={
+                "vec": np.array(
+                    [1.0, 2.0, 3.0, 4.0, 5.0, 6.0], dtype=np.float32
+                ).tobytes()
+            },
+        )
+
+        if is_resp2_connection(client):
+            assert res.total >= 1
+            doc_ids = [doc.id for doc in res.docs]
+            assert "doc0" in doc_ids
+        else:
+            assert res["total_results"] >= 1
+            doc_ids = [doc["id"] for doc in res["results"]]
+            assert "doc0" in doc_ids
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_large_dimension_vectors(self, client):
+        client.flushdb()
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {
+                        "TYPE": "FLOAT32",
+                        "DIM": 512,
+                        "DISTANCE_METRIC": "L2",
+                        "CONSTRUCTION_WINDOW_SIZE": 300,
+                        "GRAPH_MAX_DEGREE": 64,
+                    },
+                ),
+            )
+        )
+
+        vectors = []
+        for i in range(10):
+            vec = [float(i + j) for j in range(512)]
+            vectors.append(vec)
+            client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+        query = Query("*=>[KNN 5 @v $vec as score]").no_content()
+        query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+        res = client.ft().search(query, query_params=query_params)
+        if is_resp2_connection(client):
+            assert res.total == 5
+            assert "doc0" == res.docs[0].id
+        else:
+            assert res["total_results"] == 5
+            assert "doc0" == res["results"][0]["id"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_training_threshold_behavior(self, client):
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {
+                        "TYPE": "FLOAT32",
+                        "DIM": 8,
+                        "DISTANCE_METRIC": "L2",
+                        "COMPRESSION": "LVQ8",
+                        "TRAINING_THRESHOLD": 1024,
+                    },
+                ),
+            )
+        )
+
+        vectors = []
+        for i in range(20):
+            vec = [float(i + j) for j in range(8)]
+            vectors.append(vec)
+            client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+            if i >= 5:
+                query = Query("*=>[KNN 3 @v $vec as score]").no_content()
+                query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+                res = client.ft().search(query, query_params=query_params)
+
+                if is_resp2_connection(client):
+                    assert res.total >= 1
+                else:
+                    assert res["total_results"] >= 1
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_different_k_values(self, client):
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {
+                        "TYPE": "FLOAT32",
+                        "DIM": 6,
+                        "DISTANCE_METRIC": "L2",
+                        "SEARCH_WINDOW_SIZE": 15,
+                    },
+                ),
+            )
+        )
+
+        vectors = []
+        for i in range(25):
+            vec = [float(i + j) for j in range(6)]
+            vectors.append(vec)
+            client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+        for k in [1, 3, 5, 10, 15]:
+            query = Query(f"*=>[KNN {k} @v $vec as score]").no_content()
+            query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+            res = client.ft().search(query, query_params=query_params)
+
+            if is_resp2_connection(client):
+                assert res.total == k
+                assert "doc0" == res.docs[0].id
+            else:
+                assert res["total_results"] == k
+                assert "doc0" == res["results"][0]["id"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_vector_field_error(self, client):
+        # sortable tag
+        with pytest.raises(Exception):
+            client.ft().create_index(
+                (VectorField("v", "SVS-VAMANA", {}, sortable=True),)
+            )
+
+        # no_index tag
+        with pytest.raises(Exception):
+            client.ft().create_index(
+                (VectorField("v", "SVS-VAMANA", {}, no_index=True),)
+            )
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_vector_search_with_parameters(self, client):
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {
+                        "TYPE": "FLOAT32",
+                        "DIM": 4,
+                        "DISTANCE_METRIC": "L2",
+                        "CONSTRUCTION_WINDOW_SIZE": 200,
+                        "GRAPH_MAX_DEGREE": 64,
+                        "SEARCH_WINDOW_SIZE": 40,
+                        "EPSILON": 0.01,
+                    },
+                ),
+            )
+        )
+
+        # Create test vectors
+        vectors = [
+            [1.0, 2.0, 3.0, 4.0],
+            [2.0, 3.0, 4.0, 5.0],
+            [3.0, 4.0, 5.0, 6.0],
+            [4.0, 5.0, 6.0, 7.0],
+            [5.0, 6.0, 7.0, 8.0],
+        ]
+
+        for i, vec in enumerate(vectors):
+            client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+        query = Query("*=>[KNN 3 @v $vec as score]").no_content()
+        query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+        res = client.ft().search(query, query_params=query_params)
+        if is_resp2_connection(client):
+            assert res.total == 3
+            assert "doc0" == res.docs[0].id
+        else:
+            assert res["total_results"] == 3
+            assert "doc0" == res["results"][0]["id"]
+
+    @pytest.mark.redismod
+    @skip_ifmodversion_lt("2.4.3", "search")
+    @skip_if_server_version_lt("8.1.224")
+    def test_svs_vamana_vector_search_with_parameters_leanvec(self, client):
+        client.ft().create_index(
+            (
+                VectorField(
+                    "v",
+                    "SVS-VAMANA",
+                    {
+                        "TYPE": "FLOAT32",
+                        "DIM": 8,
+                        "DISTANCE_METRIC": "L2",
+                        "COMPRESSION": "LeanVec8x8",  # LeanVec compression required for REDUCE
+                        "CONSTRUCTION_WINDOW_SIZE": 200,
+                        "GRAPH_MAX_DEGREE": 32,
+                        "SEARCH_WINDOW_SIZE": 15,
+                        "EPSILON": 0.01,
+                        "TRAINING_THRESHOLD": 1024,
+                        "REDUCE": 4,  # Half of DIM (8/2 = 4)
+                    },
+                ),
+            )
+        )
+
+        # Create test vectors (8-dimensional to match DIM)
+        vectors = [
+            [1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0],
+            [2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0],
+            [3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0],
+            [4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0, 11.0],
+            [5.0, 6.0, 7.0, 8.0, 9.0, 10.0, 11.0, 12.0],
+        ]
+
+        for i, vec in enumerate(vectors):
+            client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+
+        query = Query("*=>[KNN 3 @v $vec as score]").no_content()
+        query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+
+        res = client.ft().search(query, query_params=query_params)
+        if is_resp2_connection(client):
+            assert res.total == 3
+            assert "doc0" == res.docs[0].id
+        else:
+            assert res["total_results"] == 3
+            assert "doc0" == res["results"][0]["id"]
+
+
+class TestHybridSearch(SearchTestsBase):
+    def _create_hybrid_search_index(self, client, dim=4):
+        client.ft().create_index(
+            (
+                TextField("description"),
+                NumericField("price"),
+                TagField("color"),
+                TagField("item_type"),
+                NumericField("size"),
+                VectorField(
+                    "embedding",
+                    "FLAT",
+                    {
+                        "TYPE": "FLOAT32",
+                        "DIM": dim,
+                        "DISTANCE_METRIC": "L2",
+                    },
+                ),
+                VectorField(
+                    "embedding-hnsw",
+                    "HNSW",
+                    {
+                        "TYPE": "FLOAT32",
+                        "DIM": dim,
+                        "DISTANCE_METRIC": "L2",
+                    },
+                ),
             ),
+            definition=IndexDefinition(prefix=["item:"]),
         )
-    )
+        SearchTestsBase.waitForIndex(client, "idx")
+
+    @staticmethod
+    def _generate_random_vector(dim):
+        return [random.random() for _ in range(dim)]
+
+    @staticmethod
+    def _generate_random_str_data(dim):
+        chars = "abcdefgh12345678"
+        return "".join(random.choice(chars) for _ in range(dim))
+
+    @staticmethod
+    def _add_data_for_hybrid_search(
+        client,
+        items_sets=1,
+        randomize_data=False,
+        dim_for_random_data=4,
+        use_random_str_data=False,
+    ):
+        if randomize_data or use_random_str_data:
+            generate_data_func = (
+                TestHybridSearch._generate_random_str_data
+                if use_random_str_data
+                else TestHybridSearch._generate_random_vector
+            )
 
-    vectors = [[1.0, 2.0, 3.0], [2.0, 1.0, 1.0], [3.0, 3.0, 3.0], [0.1, 0.1, 0.1]]
+            dim_for_random_data = (
+                dim_for_random_data * 4 if use_random_str_data else dim_for_random_data
+            )
 
-    for i, vec in enumerate(vectors):
-        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+            items = [
+                (generate_data_func(dim_for_random_data), "red shoes"),
+                (generate_data_func(dim_for_random_data), "green shoes with red laces"),
+                (generate_data_func(dim_for_random_data), "red dress"),
+                (generate_data_func(dim_for_random_data), "orange dress"),
+                (generate_data_func(dim_for_random_data), "black shoes"),
+            ]
+        else:
+            items = [
+                ([1.0, 2.0, 7.0, 8.0], "red shoes"),
+                ([1.0, 4.0, 7.0, 8.0], "green shoes with red laces"),
+                ([1.0, 2.0, 6.0, 5.0], "red dress"),
+                ([2.0, 3.0, 6.0, 5.0], "orange dress"),
+                ([5.0, 6.0, 7.0, 8.0], "black shoes"),
+            ]
+        items = items * items_sets
+
+        pipeline = client.pipeline()
+        for i, vec in enumerate(items):
+            vec, description = vec
+            mapping = {
+                "description": description,
+                "embedding": np.array(vec, dtype=np.float32).tobytes()
+                if not use_random_str_data
+                else vec,
+                "embedding-hnsw": np.array(vec, dtype=np.float32).tobytes()
+                if not use_random_str_data
+                else vec,
+                "price": 15 + i % 4,
+                "color": description.split(" ")[0],
+                "item_type": description.split(" ")[1],
+                "size": 10 + i % 3,
+            }
+
+            pipeline.hset(
+                f"item:{i}",
+                mapping=mapping,
+            )
+        pipeline.execute()  # Execute all at once
+
+    @staticmethod
+    def _convert_dict_values_to_str(list_of_dicts):
+        res = []
+        for d in list_of_dicts:
+            res_dict = {}
+            for k, v in d.items():
+                if isinstance(v, list):
+                    res_dict[k] = [safe_str(x) for x in v]
+                else:
+                    res_dict[k] = safe_str(v)
+            res.append(res_dict)
+        return res
+
+    @staticmethod
+    def compare_list_of_dicts(actual, expected):
+        assert len(actual) == len(expected), (
+            f"List of dicts length mismatch: {len(actual)} != {len(expected)}. "
+            f"Full dicts: actual:{actual}; expected:{expected}"
+        )
+        for expected_dict_item in expected:
+            found = False
+            for actual_dict_item in actual:
+                if actual_dict_item == expected_dict_item:
+                    found = True
+                    break
+            if not found:
+                assert False, (
+                    f"Dict {expected_dict_item} not found in actual list of dicts: {actual}. "
+                    f"All expected:{expected}"
+                )
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    def test_basic_hybrid_search(self, client):
+        # Create index and add data
+        self._create_hybrid_search_index(client)
+        self._add_data_for_hybrid_search(client, items_sets=5)
+
+        # set search query
+        search_query = HybridSearchQuery("@color:{red} @color:{green}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([-100, -200, -200, -300], dtype=np.float32).tobytes(),
+        )
 
-    query = Query("*=>[KNN 3 @v $vec as score]").sort_by("score").no_content()
-    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+        hybrid_query = HybridQuery(search_query, vsim_query)
 
-    res = client.ft().search(query, query_params=query_params)
-    if is_resp2_connection(client):
-        assert res.total == 3
-        assert "doc2" == res.docs[0].id
-    else:
-        assert res["total_results"] == 3
-        assert "doc2" == res["results"][0]["id"]
+        res = client.ft().hybrid_search(query=hybrid_query)
+
+        # the default results count limit is 10
+        if is_resp2_connection(client):
+            assert res.total_results == 10
+            assert len(res.results) == 10
+            assert res.warnings == []
+            assert res.execution_time > 0
+            assert all(isinstance(res.results[i]["__score"], bytes) for i in range(10))
+            assert all(isinstance(res.results[i]["__key"], bytes) for i in range(10))
+        else:
+            assert res["total_results"] == 10
+            assert len(res["results"]) == 10
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+            assert all(isinstance(res["results"][i]["__score"], str) for i in range(10))
+            assert all(isinstance(res["results"][i]["__key"], str) for i in range(10))
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    def test_hybrid_search_query_with_scorer(self, client):
+        # Create index and add data
+        self._create_hybrid_search_index(client)
+        self._add_data_for_hybrid_search(client, items_sets=10)
+
+        # set search query
+        search_query = HybridSearchQuery("shoes")
+        search_query.scorer("TFIDF")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 2, 3], dtype=np.float32).tobytes(),
+        )
 
+        hybrid_query = HybridQuery(search_query, vsim_query)
 
-@pytest.mark.redismod
-@skip_if_server_version_lt("7.9.0")
-def test_vector_search_with_int8_type(client):
-    client.ft().create_index(
-        (VectorField("v", "FLAT", {"TYPE": "INT8", "DIM": 2, "DISTANCE_METRIC": "L2"}),)
-    )
+        combine_config = CombineResultsMethod(
+            CombinationMethods.LINEAR, ALPHA=1, BETA=0
+        )
 
-    a = [1.5, 10]
-    b = [123, 100]
-    c = [1, 1]
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.load(
+            "@description", "@color", "@price", "@size", "@__score", "@__item"
+        )
+        postprocessing_config.limit(0, 2)
 
-    client.hset("a", "v", np.array(a, dtype=np.int8).tobytes())
-    client.hset("b", "v", np.array(b, dtype=np.int8).tobytes())
-    client.hset("c", "v", np.array(c, dtype=np.int8).tobytes())
+        res = client.ft().hybrid_search(
+            query=hybrid_query,
+            combine_method=combine_config,
+            post_processing=postprocessing_config,
+            timeout=10,
+        )
 
-    query = Query("*=>[KNN 2 @v $vec as score]").no_content()
-    query_params = {"vec": np.array(a, dtype=np.int8).tobytes()}
+        expected_results_tfidf = [
+            {
+                "description": b"red shoes",
+                "color": b"red",
+                "price": b"15",
+                "size": b"10",
+                "__score": b"2",
+            },
+            {
+                "description": b"green shoes with red laces",
+                "color": b"green",
+                "price": b"16",
+                "size": b"11",
+                "__score": b"2",
+            },
+        ]
 
-    assert 2 in query.get_args()
+        if is_resp2_connection(client):
+            assert res.total_results >= 2
+            assert len(res.results) == 2
+            assert res.results == expected_results_tfidf
+            assert res.warnings == []
+        else:
+            assert res["total_results"] >= 2
+            assert len(res["results"]) == 2
+            assert res["results"] == self._convert_dict_values_to_str(
+                expected_results_tfidf
+            )
+            assert res["warnings"] == []
+
+        search_query.scorer("BM25")
+        res = client.ft().hybrid_search(
+            query=hybrid_query,
+            combine_method=combine_config,
+            post_processing=postprocessing_config,
+            timeout=10,
+        )
+        expected_results_bm25 = [
+            {
+                "description": b"red shoes",
+                "color": b"red",
+                "price": b"15",
+                "size": b"10",
+                "__score": b"0.657894719299",
+            },
+            {
+                "description": b"green shoes with red laces",
+                "color": b"green",
+                "price": b"16",
+                "size": b"11",
+                "__score": b"0.657894719299",
+            },
+        ]
+        if is_resp2_connection(client):
+            assert res.total_results >= 2
+            assert len(res.results) == 2
+            assert res.results == expected_results_bm25
+            assert res.warnings == []
+        else:
+            assert res["total_results"] >= 2
+            assert len(res["results"]) == 2
+            assert res["results"] == self._convert_dict_values_to_str(
+                expected_results_bm25
+            )
+            assert res["warnings"] == []
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    def test_hybrid_search_query_with_vsim_method_defined_query_init(self, client):
+        # Create index and add data
+        self._create_hybrid_search_index(client)
+        self._add_data_for_hybrid_search(client, items_sets=5, use_random_str_data=True)
+        # set search query
+        search_query = HybridSearchQuery("shoes")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding-hnsw",
+            vector_data="abcd1234efgh5678",
+            vsim_search_method=VectorSearchMethods.KNN,
+            vsim_search_method_params={"K": 3, "EF_RUNTIME": 1},
+        )
 
-    res = client.ft().search(query, query_params=query_params)
-    if is_resp2_connection(client):
-        assert res.total == 2
-    else:
-        assert res["total_results"] == 2
+        hybrid_query = HybridQuery(search_query, vsim_query)
+
+        res = client.ft().hybrid_search(query=hybrid_query, timeout=10)
+        if is_resp2_connection(client):
+            assert len(res.results) > 0
+            assert res.warnings == []
+        else:
+            assert len(res["results"]) > 0
+            assert res["warnings"] == []
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    def test_hybrid_search_query_with_vsim_filter(self, client):
+        # Create index and add data
+        self._create_hybrid_search_index(client)
+        self._add_data_for_hybrid_search(client, items_sets=5, use_random_str_data=True)
 
+        search_query = HybridSearchQuery("@color:{missing}")
 
-@pytest.mark.redismod
-@skip_if_server_version_lt("7.9.0")
-def test_vector_search_with_uint8_type(client):
-    client.ft().create_index(
-        (
-            VectorField(
-                "v", "FLAT", {"TYPE": "UINT8", "DIM": 2, "DISTANCE_METRIC": "L2"}
-            ),
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data="abcd1234efgh5678",
         )
-    )
+        vsim_query.filter(HybridFilter("@price:[15 16] @size:[10 11]"))
 
-    a = [1.5, 10]
-    b = [123, 100]
-    c = [1, 1]
+        hybrid_query = HybridQuery(search_query, vsim_query)
 
-    client.hset("a", "v", np.array(a, dtype=np.uint8).tobytes())
-    client.hset("b", "v", np.array(b, dtype=np.uint8).tobytes())
-    client.hset("c", "v", np.array(c, dtype=np.uint8).tobytes())
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.load("@price", "@size")
 
-    query = Query("*=>[KNN 2 @v $vec as score]").no_content()
-    query_params = {"vec": np.array(a, dtype=np.uint8).tobytes()}
-
-    assert 2 in query.get_args()
+        res = client.ft().hybrid_search(
+            query=hybrid_query, post_processing=postprocessing_config, timeout=10
+        )
+        if is_resp2_connection(client):
+            assert len(res.results) > 0
+            assert res.warnings == []
+            for item in res.results:
+                assert item["price"] in [b"15", b"16"]
+                assert item["size"] in [b"10", b"11"]
+        else:
+            assert len(res["results"]) > 0
+            assert res["warnings"] == []
+            for item in res["results"]:
+                assert item["price"] in ["15", "16"]
+                assert item["size"] in ["10", "11"]
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    def test_hybrid_search_query_with_search_score_aliases(self, client):
+        # Create index and add data
+        self._create_hybrid_search_index(client)
+        self._add_data_for_hybrid_search(client, items_sets=1, use_random_str_data=True)
+
+        search_query = HybridSearchQuery("shoes")
+        search_query.yield_score_as("search_score")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data="abcd1234efgh5678",
+        )
 
-    res = client.ft().search(query, query_params=query_params)
-    if is_resp2_connection(client):
-        assert res.total == 2
-    else:
-        assert res["total_results"] == 2
+        hybrid_query = HybridQuery(search_query, vsim_query)
 
+        res = client.ft().hybrid_search(query=hybrid_query, timeout=10)
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-def test_search_query_with_different_dialects(client):
-    client.ft().create_index(
-        (TextField("name"), TextField("lastname")),
-        definition=IndexDefinition(prefix=["test:"]),
-    )
+        if is_resp2_connection(client):
+            assert len(res.results) > 0
+            assert res.warnings == []
+            for item in res.results:
+                if item["__key"] in [b"item:0", b"item:1", b"item:4"]:
+                    assert item["search_score"] is not None
+                    assert item["__score"] is not None
+                else:
+                    assert "search_score" not in item
+                    assert item["__score"] is not None
 
-    client.hset("test:1", "name", "James")
-    client.hset("test:1", "lastname", "Brown")
+        else:
+            assert len(res["results"]) > 0
+            assert res["warnings"] == []
+            for item in res["results"]:
+                if item["__key"] in ["item:0", "item:1", "item:4"]:
+                    assert item["search_score"] is not None
+                    assert item["__score"] is not None
+                else:
+                    assert "search_score" not in item
+                    assert item["__score"] is not None
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    def test_hybrid_search_query_with_vsim_score_aliases(self, client):
+        # Create index and add data
+        self._create_hybrid_search_index(client)
+        self._add_data_for_hybrid_search(client, items_sets=1, use_random_str_data=True)
+
+        search_query = HybridSearchQuery("shoes")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding-hnsw",
+            vector_data="abcd1234efgh5678",
+            vsim_search_method=VectorSearchMethods.KNN,
+            vsim_search_method_params={
+                "K": 3,
+                "EF_RUNTIME": 1,
+                "YIELD_SCORE_AS": "vsim_score",
+            },
+        )
 
-    # Query with default DIALECT 2
-    query = "@name: James Brown"
-    q = Query(query)
-    res = client.ft().search(q)
-    if is_resp2_connection(client):
-        assert res.total == 1
-    else:
-        assert res["total_results"] == 1
+        hybrid_query = HybridQuery(search_query, vsim_query)
 
-    # Query with explicit DIALECT 1
-    query = "@name: James Brown"
-    q = Query(query).dialect(1)
-    res = client.ft().search(q)
-    if is_resp2_connection(client):
-        assert res.total == 0
-    else:
-        assert res["total_results"] == 0
+        res = client.ft().hybrid_search(query=hybrid_query, timeout=10)
 
+        if is_resp2_connection(client):
+            assert len(res.results) > 0
+            assert res.warnings == []
+            for item in res.results:
+                if item["__key"] in [b"item:0", b"item:1", b"item:2"]:
+                    assert item["vsim_score"] is not None
+                    assert item["__score"] is not None
+                else:
+                    assert "vsim_score" not in item
+                    assert item["__score"] is not None
 
-@pytest.mark.redismod
-@skip_if_server_version_lt("7.9.0")
-def test_info_exposes_search_info(client):
-    assert len(client.info("search")) > 0
+        else:
+            assert len(res["results"]) > 0
+            assert res["warnings"] == []
+            for item in res["results"]:
+                if item["__key"] in ["item:0", "item:1", "item:2"]:
+                    assert item["vsim_score"] is not None
+                    assert item["__score"] is not None
+                else:
+                    assert "vsim_score" not in item
+                    assert item["__score"] is not None
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    def test_hybrid_search_query_with_combine_score_aliases(self, client):
+        # Create index and add data
+        self._create_hybrid_search_index(client)
+        self._add_data_for_hybrid_search(client, items_sets=1, use_random_str_data=True)
+
+        search_query = HybridSearchQuery("shoes")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding-hnsw", vector_data="abcd1234efgh5678"
+        )
 
+        hybrid_query = HybridQuery(search_query, vsim_query)
+        combine_method = CombineResultsMethod(
+            CombinationMethods.LINEAR,
+            ALPHA=0.5,
+            BETA=0.5,
+            YIELD_SCORE_AS="combined_score",
+        )
 
-def _assert_search_result(client, result, expected_doc_ids):
-    """
-    Make sure the result of a geo search is as expected, taking into account the RESP
-    version being used.
-    """
-    if is_resp2_connection(client):
-        assert set([doc.id for doc in result.docs]) == set(expected_doc_ids)
-    else:
-        assert set([doc["id"] for doc in result["results"]]) == set(expected_doc_ids)
+        res = client.ft().hybrid_search(
+            query=hybrid_query, combine_method=combine_method, timeout=10
+        )
 
+        if is_resp2_connection(client):
+            assert len(res.results) > 0
+            assert res.warnings == []
+            for item in res.results:
+                assert item["combined_score"] is not None
+                assert "__score" not in item
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_basic_functionality(client):
-    client.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {"TYPE": "FLOAT32", "DIM": 4, "DISTANCE_METRIC": "L2"},
-            ),
+        else:
+            assert len(res["results"]) > 0
+            assert res["warnings"] == []
+            for item in res["results"]:
+                assert item["combined_score"] is not None
+                assert "__score" not in item
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    def test_hybrid_search_query_with_combine_all_score_aliases(self, client):
+        # Create index and add data
+        self._create_hybrid_search_index(client)
+        self._add_data_for_hybrid_search(client, items_sets=1, use_random_str_data=True)
+
+        search_query = HybridSearchQuery("shoes")
+        search_query.yield_score_as("search_score")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding-hnsw",
+            vector_data="abcd1234efgh5678",
+            vsim_search_method=VectorSearchMethods.KNN,
+            vsim_search_method_params={
+                "K": 3,
+                "EF_RUNTIME": 1,
+                "YIELD_SCORE_AS": "vsim_score",
+            },
         )
-    )
 
-    vectors = [
-        [1.0, 2.0, 3.0, 4.0],
-        [2.0, 3.0, 4.0, 5.0],
-        [3.0, 4.0, 5.0, 6.0],
-        [10.0, 11.0, 12.0, 13.0],
-    ]
+        hybrid_query = HybridQuery(search_query, vsim_query)
 
-    for i, vec in enumerate(vectors):
-        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
-
-    query = "*=>[KNN 3 @v $vec]"
-    q = Query(query).return_field("__v_score").sort_by("__v_score", True)
-    res = client.ft().search(
-        q, query_params={"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
-    )
+        combine_method = CombineResultsMethod(
+            CombinationMethods.LINEAR,
+            ALPHA=0.5,
+            BETA=0.5,
+            YIELD_SCORE_AS="combined_score",
+        )
 
-    if is_resp2_connection(client):
-        assert res.total == 3
-        assert "doc0" == res.docs[0].id  # Should be closest to itself
-        assert "0" == res.docs[0].__getattribute__("__v_score")
-    else:
-        assert res["total_results"] == 3
-        assert "doc0" == res["results"][0]["id"]
-        assert "0" == res["results"][0]["extra_attributes"]["__v_score"]
+        res = client.ft().hybrid_search(
+            query=hybrid_query, combine_method=combine_method, timeout=10
+        )
 
+        if is_resp2_connection(client):
+            assert len(res.results) > 0
+            assert res.warnings == []
+            for item in res.results:
+                assert item["combined_score"] is not None
+                assert "__score" not in item
+                if item["__key"] in [b"item:0", b"item:1", b"item:4"]:
+                    assert item["search_score"] is not None
+                else:
+                    assert "search_score" not in item
+                if item["__key"] in [b"item:0", b"item:1", b"item:2"]:
+                    assert item["vsim_score"] is not None
+                else:
+                    assert "vsim_score" not in item
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_float16_type(client):
-    client.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {"TYPE": "FLOAT16", "DIM": 4, "DISTANCE_METRIC": "L2"},
-            ),
+        else:
+            assert len(res["results"]) > 0
+            assert res["warnings"] == []
+            for item in res["results"]:
+                assert item["combined_score"] is not None
+                assert "__score" not in item
+                if item["__key"] in ["item:0", "item:1", "item:4"]:
+                    assert item["search_score"] is not None
+                else:
+                    assert "search_score" not in item
+                if item["__key"] in ["item:0", "item:1", "item:2"]:
+                    assert item["vsim_score"] is not None
+                else:
+                    assert "vsim_score" not in item
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    def test_hybrid_search_query_with_vsim_knn(self, client):
+        # Create index and add data
+        self._create_hybrid_search_index(client)
+        self._add_data_for_hybrid_search(client, items_sets=10)
+
+        # set search query
+        # this query won't have results, so we will be able to validate vsim results
+        search_query = HybridSearchQuery("@color:{none}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 2, 3], dtype=np.float32).tobytes(),
         )
-    )
 
-    vectors = [[1.5, 2.5, 3.5, 4.5], [2.5, 3.5, 4.5, 5.5], [3.5, 4.5, 5.5, 6.5]]
+        vsim_query.vsim_method_params(VectorSearchMethods.KNN, K=3)
 
-    for i, vec in enumerate(vectors):
-        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float16).tobytes())
+        hybrid_query = HybridQuery(search_query, vsim_query)
 
-    query = Query("*=>[KNN 2 @v $vec as score]").no_content()
-    query_params = {"vec": np.array(vectors[0], dtype=np.float16).tobytes()}
+        postprocessing_config = HybridPostProcessingConfig()
 
-    res = client.ft().search(query, query_params=query_params)
-    if is_resp2_connection(client):
-        assert res.total == 2
-        assert "doc0" == res.docs[0].id
-    else:
-        assert res["total_results"] == 2
-        assert "doc0" == res["results"][0]["id"]
+        res = client.ft().hybrid_search(
+            query=hybrid_query, post_processing=postprocessing_config, timeout=10
+        )
+        expected_results = [
+            {"__key": b"item:2", "__score": b"0.016393442623"},
+            {"__key": b"item:7", "__score": b"0.0161290322581"},
+            {"__key": b"item:12", "__score": b"0.015873015873"},
+        ]
+        if is_resp2_connection(client):
+            assert res.total_results == 3  # KNN top-k value
+            assert len(res.results) == 3
+            assert res.results == expected_results
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert res["total_results"] == 3  # KNN top-k value
+            assert len(res["results"]) == 3
+            assert res["results"] == self._convert_dict_values_to_str(expected_results)
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+        vsim_query_with_hnsw = HybridVsimQuery(
+            vector_field_name="@embedding-hnsw",
+            vector_data=np.array([1, 2, 2, 3], dtype=np.float32).tobytes(),
+        )
+        vsim_query_with_hnsw.vsim_method_params(
+            VectorSearchMethods.KNN, K=3, EF_RUNTIME=1
+        )
+        hybrid_query_with_hnsw = HybridQuery(search_query, vsim_query_with_hnsw)
 
+        res2 = client.ft().hybrid_search(query=hybrid_query_with_hnsw, timeout=10)
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_float32_type(client):
-    client.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {"TYPE": "FLOAT32", "DIM": 4, "DISTANCE_METRIC": "L2"},
-            ),
+        expected_results2 = [
+            {"__key": b"item:12", "__score": b"0.016393442623"},
+            {"__key": b"item:22", "__score": b"0.0161290322581"},
+            {"__key": b"item:27", "__score": b"0.015873015873"},
+        ]
+        if is_resp2_connection(client):
+            assert res2.total_results == 3  # KNN top-k value
+            assert len(res2.results) == 3
+            assert res2.results == expected_results2
+            assert res2.warnings == []
+            assert res2.execution_time > 0
+        else:
+            assert res2["total_results"] == 3  # KNN top-k value
+            assert len(res2["results"]) == 3
+            assert res2["results"] == self._convert_dict_values_to_str(
+                expected_results2
+            )
+            assert res2["warnings"] == []
+            assert res2["execution_time"] > 0
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    def test_hybrid_search_query_with_vsim_range(self, client):
+        # Create index and add data
+        self._create_hybrid_search_index(client)
+        self._add_data_for_hybrid_search(client, items_sets=10)
+
+        # set search query
+        # this query won't have results, so we will be able to validate vsim results
+        search_query = HybridSearchQuery("@color:{none}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 7, 6], dtype=np.float32).tobytes(),
         )
-    )
 
-    vectors = [[1.0, 2.0, 3.0, 4.0], [2.0, 3.0, 4.0, 5.0], [3.0, 4.0, 5.0, 6.0]]
+        vsim_query.vsim_method_params(VectorSearchMethods.RANGE, RADIUS=2)
 
-    for i, vec in enumerate(vectors):
-        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+        hybrid_query = HybridQuery(search_query, vsim_query)
 
-    query = Query("*=>[KNN 2 @v $vec as score]").no_content()
-    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.limit(0, 3)
 
-    res = client.ft().search(query, query_params=query_params)
-    if is_resp2_connection(client):
-        assert res.total == 2
-        assert "doc0" == res.docs[0].id
-    else:
-        assert res["total_results"] == 2
-        assert "doc0" == res["results"][0]["id"]
+        res = client.ft().hybrid_search(
+            query=hybrid_query, post_processing=postprocessing_config, timeout=10
+        )
 
+        expected_results = [
+            {"__key": b"item:2", "__score": b"0.016393442623"},
+            {"__key": b"item:7", "__score": b"0.0161290322581"},
+            {"__key": b"item:12", "__score": b"0.015873015873"},
+        ]
+        if is_resp2_connection(client):
+            assert res.total_results >= 3  # at least 3 results
+            assert len(res.results) == 3
+            assert res.results == expected_results
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert res["total_results"] >= 3
+            assert len(res["results"]) == 3
+            assert res["results"] == self._convert_dict_values_to_str(expected_results)
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+        vsim_query_with_hnsw = HybridVsimQuery(
+            vector_field_name="@embedding-hnsw",
+            vector_data=np.array([1, 2, 7, 6], dtype=np.float32).tobytes(),
+        )
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_vector_search_with_default_dialect(client):
-    client.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {"TYPE": "FLOAT32", "DIM": 2, "DISTANCE_METRIC": "L2"},
-            ),
+        vsim_query_with_hnsw.vsim_method_params(
+            VectorSearchMethods.RANGE, RADIUS=2, EPSILON=0.5
         )
-    )
 
-    client.hset("a", "v", "aaaaaaaa")
-    client.hset("b", "v", "aaaabaaa")
-    client.hset("c", "v", "aaaaabaa")
+        hybrid_query_with_hnsw = HybridQuery(search_query, vsim_query_with_hnsw)
 
-    query = "*=>[KNN 2 @v $vec]"
-    q = Query(query).return_field("__v_score").sort_by("__v_score", True)
-    res = client.ft().search(q, query_params={"vec": "aaaaaaaa"})
+        res = client.ft().hybrid_search(
+            query=hybrid_query_with_hnsw,
+            post_processing=postprocessing_config,
+            timeout=10,
+        )
 
-    if is_resp2_connection(client):
-        assert res.total == 2
-    else:
-        assert res["total_results"] == 2
-
-
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_vector_field_basic():
-    field = VectorField(
-        "v", "SVS-VAMANA", {"TYPE": "FLOAT32", "DIM": 128, "DISTANCE_METRIC": "COSINE"}
-    )
-
-    # Check that the field was created successfully
-    assert field.name == "v"
-    assert field.args[0] == "VECTOR"
-    assert field.args[1] == "SVS-VAMANA"
-    assert field.args[2] == 6
-    assert "TYPE" in field.args
-    assert "FLOAT32" in field.args
-    assert "DIM" in field.args
-    assert 128 in field.args
-    assert "DISTANCE_METRIC" in field.args
-    assert "COSINE" in field.args
-
-
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_lvq8_compression(client):
-    client.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {
-                    "TYPE": "FLOAT32",
-                    "DIM": 8,
-                    "DISTANCE_METRIC": "L2",
-                    "COMPRESSION": "LVQ8",
-                    "TRAINING_THRESHOLD": 1024,
-                },
-            ),
+        expected_results_hnsw = [
+            {"__key": b"item:27", "__score": b"0.016393442623"},
+            {"__key": b"item:12", "__score": b"0.0161290322581"},
+            {"__key": b"item:22", "__score": b"0.015873015873"},
+        ]
+
+        if is_resp2_connection(client):
+            assert res.total_results >= 3
+            assert len(res.results) == 3
+            assert res.results == expected_results_hnsw
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert res["total_results"] >= 3
+            assert len(res["results"]) == 3
+            assert res["results"] == self._convert_dict_values_to_str(
+                expected_results_hnsw
+            )
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    def test_hybrid_search_query_with_combine(self, client):
+        # Create index and add data
+        self._create_hybrid_search_index(client)
+        self._add_data_for_hybrid_search(client, items_sets=10)
+
+        # set search query
+        search_query = HybridSearchQuery("@color:{red}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 7, 6], dtype=np.float32).tobytes(),
         )
-    )
 
-    vectors = []
-    for i in range(20):
-        vec = [float(i + j) for j in range(8)]
-        vectors.append(vec)
-        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+        hybrid_query = HybridQuery(search_query, vsim_query)
 
-    query = Query("*=>[KNN 5 @v $vec as score]").no_content()
-    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+        combine_method_linear = CombineResultsMethod(
+            CombinationMethods.LINEAR, ALPHA=0.5, BETA=0.5
+        )
 
-    res = client.ft().search(query, query_params=query_params)
-    if is_resp2_connection(client):
-        assert res.total == 5
-        assert "doc0" == res.docs[0].id
-    else:
-        assert res["total_results"] == 5
-        assert "doc0" == res["results"][0]["id"]
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.limit(0, 3)
 
+        res = client.ft().hybrid_search(
+            query=hybrid_query,
+            combine_method=combine_method_linear,
+            post_processing=postprocessing_config,
+            timeout=10,
+        )
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_compression_with_both_vector_types(client):
-    # Test FLOAT16 with LVQ8
-    client.ft("idx16").create_index(
-        (
-            VectorField(
-                "v16",
-                "SVS-VAMANA",
-                {
-                    "TYPE": "FLOAT16",
-                    "DIM": 8,
-                    "DISTANCE_METRIC": "L2",
-                    "COMPRESSION": "LVQ8",
-                    "TRAINING_THRESHOLD": 1024,
-                },
-            ),
+        expected_results = [
+            {"__key": b"item:2", "__score": b"0.166666666667"},
+            {"__key": b"item:7", "__score": b"0.166666666667"},
+            {"__key": b"item:12", "__score": b"0.166666666667"},
+        ]
+        if is_resp2_connection(client):
+            assert res.total_results >= 3
+            assert len(res.results) == 3
+            assert res.results == expected_results
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert res["total_results"] >= 3
+            assert len(res["results"]) == 3
+            assert res["results"] == self._convert_dict_values_to_str(expected_results)
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+        # combine with RRF and WINDOW + CONSTANT
+        combine_method_rrf = CombineResultsMethod(
+            CombinationMethods.RRF, WINDOW=3, CONSTANT=0.5
+        )
+        res = client.ft().hybrid_search(
+            query=hybrid_query,
+            combine_method=combine_method_rrf,
+            post_processing=postprocessing_config,
+            timeout=10,
         )
-    )
 
-    # Test FLOAT32 with LVQ8
-    client.ft("idx32").create_index(
-        (
-            VectorField(
-                "v32",
-                "SVS-VAMANA",
-                {
-                    "TYPE": "FLOAT32",
-                    "DIM": 8,
-                    "DISTANCE_METRIC": "L2",
-                    "COMPRESSION": "LVQ8",
-                    "TRAINING_THRESHOLD": 1024,
-                },
-            ),
+        expected_results = [
+            {"__key": b"item:2", "__score": b"1.06666666667"},
+            {"__key": b"item:0", "__score": b"0.666666666667"},
+            {"__key": b"item:7", "__score": b"0.4"},
+        ]
+        if is_resp2_connection(client):
+            assert res.total_results >= 3
+            assert len(res.results) == 3
+            assert res.results == expected_results
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert res["total_results"] >= 3
+            assert len(res["results"]) == 3
+            assert res["results"] == self._convert_dict_values_to_str(expected_results)
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+        # combine with RRF, not all possible params provided
+        combine_method_rrf_2 = CombineResultsMethod(CombinationMethods.RRF, WINDOW=3)
+        res = client.ft().hybrid_search(
+            query=hybrid_query,
+            combine_method=combine_method_rrf_2,
+            post_processing=postprocessing_config,
+            timeout=10,
         )
-    )
-
-    # Add data to both indices
-    for i in range(15):
-        vec = [float(i + j) for j in range(8)]
-        client.hset(f"doc16_{i}", "v16", np.array(vec, dtype=np.float16).tobytes())
-        client.hset(f"doc32_{i}", "v32", np.array(vec, dtype=np.float32).tobytes())
-
-    # Test both indices
-    query = Query("*=>[KNN 3 @v16 $vec as score]").no_content()
-    res16 = client.ft("idx16").search(
-        query,
-        query_params={
-            "vec": np.array(
-                [1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0], dtype=np.float16
-            ).tobytes()
-        },
-    )
-
-    query = Query("*=>[KNN 3 @v32 $vec as score]").no_content()
-    res32 = client.ft("idx32").search(
-        query,
-        query_params={
-            "vec": np.array(
-                [1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0], dtype=np.float32
-            ).tobytes()
-        },
-    )
 
-    if is_resp2_connection(client):
-        assert res16.total == 3
-        assert res32.total == 3
-    else:
-        assert res16["total_results"] == 3
-        assert res32["total_results"] == 3
+        expected_results = [
+            {"__key": b"item:2", "__score": b"0.032522474881"},
+            {"__key": b"item:0", "__score": b"0.016393442623"},
+            {"__key": b"item:7", "__score": b"0.0161290322581"},
+        ]
+        if is_resp2_connection(client):
+            assert res.total_results >= 3
+            assert len(res.results) == 3
+            assert res.results == expected_results
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert res["total_results"] >= 3
+            assert len(res["results"]) == 3
+            assert res["results"] == self._convert_dict_values_to_str(expected_results)
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    def test_hybrid_search_query_with_load(self, client):
+        # Create index and add data
+        self._create_hybrid_search_index(client)
+        self._add_data_for_hybrid_search(client, items_sets=10)
+
+        # set search query
+        search_query = HybridSearchQuery("@color:{red|green|black}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 7, 6], dtype=np.float32).tobytes(),
+        )
 
+        hybrid_query = HybridQuery(search_query, vsim_query)
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_construction_window_size(client):
-    client.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {
-                    "TYPE": "FLOAT32",
-                    "DIM": 6,
-                    "DISTANCE_METRIC": "L2",
-                    "CONSTRUCTION_WINDOW_SIZE": 300,
-                },
-            ),
+        combine_method = CombineResultsMethod(
+            CombinationMethods.LINEAR, ALPHA=0.5, BETA=0.5
         )
-    )
 
-    vectors = []
-    for i in range(20):
-        vec = [float(i + j) for j in range(6)]
-        vectors.append(vec)
-        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.load(
+            "@description", "@color", "@price", "@size", "@__key AS item_key"
+        )
+        postprocessing_config.limit(0, 1)
 
-    query = Query("*=>[KNN 5 @v $vec as score]").no_content()
-    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+        res = client.ft().hybrid_search(
+            query=hybrid_query,
+            combine_method=combine_method,
+            post_processing=postprocessing_config,
+            timeout=10,
+        )
 
-    res = client.ft().search(query, query_params=query_params)
-    if is_resp2_connection(client):
-        assert res.total == 5
-        assert "doc0" == res.docs[0].id
-    else:
-        assert res["total_results"] == 5
-        assert "doc0" == res["results"][0]["id"]
+        expected_results = [
+            {
+                "description": b"red dress",
+                "color": b"red",
+                "price": b"17",
+                "size": b"12",
+                "item_key": b"item:2",
+            }
+        ]
+        if is_resp2_connection(client):
+            assert res.total_results >= 1
+            assert len(res.results) == 1
+            self.compare_list_of_dicts(res.results, expected_results)
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert res["total_results"] >= 1
+            assert len(res["results"]) == 1
+            self.compare_list_of_dicts(
+                res["results"], self._convert_dict_values_to_str(expected_results)
+            )
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    # @pytest.mark.repeat(6)
+    def test_hybrid_search_query_with_load_and_apply(self, client):
+        # Create index and add data
+        self._create_hybrid_search_index(client)
+        self._add_data_for_hybrid_search(client, items_sets=10)
+
+        # set search query
+        search_query = HybridSearchQuery("@color:{red}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 7, 6], dtype=np.float32).tobytes(),
+        )
 
+        hybrid_query = HybridQuery(search_query, vsim_query)
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_graph_max_degree(client):
-    client.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {
-                    "TYPE": "FLOAT32",
-                    "DIM": 6,
-                    "DISTANCE_METRIC": "COSINE",
-                    "GRAPH_MAX_DEGREE": 64,
-                },
-            ),
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.load("@color", "@price", "@size")
+        postprocessing_config.apply(
+            price_discount="@price - (@price * 0.1)",
+            tax_discount="@price_discount * 0.2",
         )
-    )
+        postprocessing_config.limit(0, 3)
 
-    vectors = []
-    for i in range(25):
-        vec = [float(i + j) for j in range(6)]
-        vectors.append(vec)
-        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+        res = client.ft().hybrid_search(
+            query=hybrid_query, post_processing=postprocessing_config, timeout=10
+        )
 
-    query = Query("*=>[KNN 6 @v $vec as score]").no_content()
-    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+        expected_results = [
+            {
+                "color": b"red",
+                "price": b"15",
+                "size": b"10",
+                "price_discount": b"13.5",
+                "tax_discount": b"2.7",
+            },
+            {
+                "color": b"red",
+                "price": b"17",
+                "size": b"12",
+                "price_discount": b"15.3",
+                "tax_discount": b"3.06",
+            },
+            {
+                "color": b"red",
+                "price": b"18",
+                "size": b"11",
+                "price_discount": b"16.2",
+                "tax_discount": b"3.24",
+            },
+        ]
+        if is_resp2_connection(client):
+            assert len(res.results) == 3
+            self.compare_list_of_dicts(res.results, expected_results)
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert len(res["results"]) == 3
+            self.compare_list_of_dicts(
+                res["results"], self._convert_dict_values_to_str(expected_results)
+            )
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    def test_hybrid_search_query_with_load_and_filter(self, client):
+        # Create index and add data
+        self._create_hybrid_search_index(client)
+        self._add_data_for_hybrid_search(client, items_sets=10)
+
+        # set search query
+        search_query = HybridSearchQuery("@color:{red|green|black}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 7, 6], dtype=np.float32).tobytes(),
+        )
 
-    res = client.ft().search(query, query_params=query_params)
-    if is_resp2_connection(client):
-        assert res.total == 6
-        assert "doc0" == res.docs[0].id
-    else:
-        assert res["total_results"] == 6
-        assert "doc0" == res["results"][0]["id"]
+        hybrid_query = HybridQuery(search_query, vsim_query)
 
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.load("@description", "@color", "@price", "@size")
+        # for the postprocessing filter we need to filter on the loaded fields
+        # expecting all of them to be interpreted as strings - the initial filed types
+        # are not preserved
+        postprocessing_config.filter(HybridFilter('@price=="15"'))
+        postprocessing_config.limit(0, 3)
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_search_window_size(client):
-    client.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {
-                    "TYPE": "FLOAT32",
-                    "DIM": 6,
-                    "DISTANCE_METRIC": "L2",
-                    "SEARCH_WINDOW_SIZE": 20,
-                },
-            ),
+        res = client.ft().hybrid_search(
+            query=hybrid_query, post_processing=postprocessing_config, timeout=10
         )
-    )
 
-    vectors = []
-    for i in range(30):
-        vec = [float(i + j) for j in range(6)]
-        vectors.append(vec)
-        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+        if is_resp2_connection(client):
+            assert len(res.results) == 3
+            for item in res.results:
+                assert item["price"] == b"15"
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert len(res["results"]) == 3
+            for item in res["results"]:
+                assert item["price"] == "15"
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    def test_hybrid_search_query_with_load_apply_and_params(self, client):
+        # Create index and add data
+        self._create_hybrid_search_index(client)
+        self._add_data_for_hybrid_search(client, items_sets=5, use_random_str_data=True)
+
+        # set search query
+        search_query = HybridSearchQuery("@color:{$color_criteria}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data="$vector",
+        )
 
-    query = Query("*=>[KNN 8 @v $vec as score]").no_content()
-    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+        hybrid_query = HybridQuery(search_query, vsim_query)
 
-    res = client.ft().search(query, query_params=query_params)
-    if is_resp2_connection(client):
-        assert res.total == 8
-        assert "doc0" == res.docs[0].id
-    else:
-        assert res["total_results"] == 8
-        assert "doc0" == res["results"][0]["id"]
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.load("@description", "@color", "@price")
+        postprocessing_config.apply(price_discount="@price - (@price * 0.1)")
+        postprocessing_config.limit(0, 3)
 
+        params_substitution = {
+            "vector": "abcd1234abcd5678",
+            "color_criteria": "red",
+        }
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_epsilon_parameter(client):
-    client.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {"TYPE": "FLOAT32", "DIM": 6, "DISTANCE_METRIC": "L2", "EPSILON": 0.05},
-            ),
+        res = client.ft().hybrid_search(
+            query=hybrid_query,
+            post_processing=postprocessing_config,
+            params_substitution=params_substitution,
+            timeout=10,
         )
-    )
 
-    vectors = []
-    for i in range(20):
-        vec = [float(i + j) for j in range(6)]
-        vectors.append(vec)
-        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+        expected_results = [
+            {
+                "description": b"red shoes",
+                "color": b"red",
+                "price": b"15",
+                "price_discount": b"13.5",
+            },
+            {
+                "description": b"red dress",
+                "color": b"red",
+                "price": b"17",
+                "price_discount": b"15.3",
+            },
+            {
+                "description": b"red shoes",
+                "color": b"red",
+                "price": b"16",
+                "price_discount": b"14.4",
+            },
+        ]
+        if is_resp2_connection(client):
+            assert len(res.results) == 3
+            assert res.results == expected_results
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert len(res["results"]) == 3
+            assert res["results"] == self._convert_dict_values_to_str(expected_results)
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    def test_hybrid_search_query_with_limit(self, client):
+        # Create index and add data
+        self._create_hybrid_search_index(client)
+        self._add_data_for_hybrid_search(client, items_sets=10)
+
+        # set search query
+        search_query = HybridSearchQuery("@color:{red}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 7, 6], dtype=np.float32).tobytes(),
+        )
 
-    query = Query("*=>[KNN 5 @v $vec as score]").no_content()
-    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+        hybrid_query = HybridQuery(search_query, vsim_query)
 
-    res = client.ft().search(query, query_params=query_params)
-    if is_resp2_connection(client):
-        assert res.total == 5
-        assert "doc0" == res.docs[0].id
-    else:
-        assert res["total_results"] == 5
-        assert "doc0" == res["results"][0]["id"]
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.limit(0, 3)
 
+        res = client.ft().hybrid_search(
+            query=hybrid_query, post_processing=postprocessing_config, timeout=10
+        )
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_all_build_parameters_combined(client):
-    client.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {
-                    "TYPE": "FLOAT32",
-                    "DIM": 8,
-                    "DISTANCE_METRIC": "IP",
-                    "CONSTRUCTION_WINDOW_SIZE": 250,
-                    "GRAPH_MAX_DEGREE": 48,
-                    "SEARCH_WINDOW_SIZE": 15,
-                    "EPSILON": 0.02,
-                },
-            ),
+        if is_resp2_connection(client):
+            assert len(res.results) == 3
+            assert res.warnings == []
+        else:
+            assert len(res["results"]) == 3
+            assert res["warnings"] == []
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    def test_hybrid_search_query_with_load_apply_and_sortby(self, client):
+        # Create index and add data
+        self._create_hybrid_search_index(client)
+        self._add_data_for_hybrid_search(client, items_sets=1)
+
+        # set search query
+        search_query = HybridSearchQuery("@color:{red|green}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 7, 6], dtype=np.float32).tobytes(),
         )
-    )
 
-    vectors = []
-    for i in range(35):
-        vec = [float(i + j) for j in range(8)]
-        vectors.append(vec)
-        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+        hybrid_query = HybridQuery(search_query, vsim_query)
 
-    query = Query("*=>[KNN 7 @v $vec as score]").no_content()
-    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.load("@color", "@price")
+        postprocessing_config.apply(price_discount="@price - (@price * 0.1)")
+        postprocessing_config.sort_by(
+            SortbyField("@price_discount", asc=False), SortbyField("@color", asc=True)
+        )
+        postprocessing_config.limit(0, 5)
 
-    res = client.ft().search(query, query_params=query_params)
-    if is_resp2_connection(client):
-        assert res.total == 7
-        doc_ids = [doc.id for doc in res.docs]
-        assert len(doc_ids) == 7
-    else:
-        assert res["total_results"] == 7
-        doc_ids = [doc["id"] for doc in res["results"]]
-        assert len(doc_ids) == 7
-
-
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_comprehensive_configuration(client):
-    client.flushdb()
-    client.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {
-                    "TYPE": "FLOAT16",
-                    "DIM": 32,
-                    "DISTANCE_METRIC": "COSINE",
-                    "COMPRESSION": "LVQ8",
-                    "CONSTRUCTION_WINDOW_SIZE": 400,
-                    "GRAPH_MAX_DEGREE": 96,
-                    "SEARCH_WINDOW_SIZE": 25,
-                    "EPSILON": 0.03,
-                    "TRAINING_THRESHOLD": 2048,
-                },
-            ),
+        res = client.ft().hybrid_search(
+            query=hybrid_query, post_processing=postprocessing_config, timeout=10
         )
-    )
 
-    vectors = []
-    for i in range(60):
-        vec = [float(i + j) for j in range(32)]
-        vectors.append(vec)
-        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float16).tobytes())
+        expected_results = [
+            {"color": b"orange", "price": b"18", "price_discount": b"16.2"},
+            {"color": b"red", "price": b"17", "price_discount": b"15.3"},
+            {"color": b"green", "price": b"16", "price_discount": b"14.4"},
+            {"color": b"black", "price": b"15", "price_discount": b"13.5"},
+            {"color": b"red", "price": b"15", "price_discount": b"13.5"},
+        ]
+        if is_resp2_connection(client):
+            assert res.total_results >= 5
+            assert len(res.results) == 5
+            # the order here should match because of the sort
+            assert res.results == expected_results
+            assert res.warnings == []
+            assert res.execution_time > 0
+        else:
+            assert res["total_results"] >= 5
+            assert len(res["results"]) == 5
+            # the order here should match because of the sort
+            assert res["results"] == self._convert_dict_values_to_str(expected_results)
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    def test_hybrid_search_query_with_timeout(self, client):
+        dim = 128
+        # Create index and add data
+        self._create_hybrid_search_index(client, dim=dim)
+        self._add_data_for_hybrid_search(
+            client,
+            items_sets=5000,
+            dim_for_random_data=dim,
+            use_random_str_data=True,
+        )
 
-    query = Query("*=>[KNN 10 @v $vec as score]").no_content()
-    query_params = {"vec": np.array(vectors[0], dtype=np.float16).tobytes()}
+        # set search query
+        search_query = HybridSearchQuery("*")
 
-    res = client.ft().search(query, query_params=query_params)
-    if is_resp2_connection(client):
-        assert res.total == 10
-        assert "doc0" == res.docs[0].id
-    else:
-        assert res["total_results"] == 10
-        assert "doc0" == res["results"][0]["id"]
-
-
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_hybrid_text_vector_search(client):
-    client.flushdb()
-    client.ft().create_index(
-        (
-            TextField("title"),
-            TextField("content"),
-            VectorField(
-                "embedding",
-                "SVS-VAMANA",
-                {
-                    "TYPE": "FLOAT32",
-                    "DIM": 6,
-                    "DISTANCE_METRIC": "COSINE",
-                    "SEARCH_WINDOW_SIZE": 20,
-                },
-            ),
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding-hnsw",
+            vector_data="abcd" * dim,
         )
-    )
-
-    docs = [
-        {
-            "title": "AI Research",
-            "content": "machine learning algorithms",
-            "embedding": [1.0, 2.0, 3.0, 4.0, 5.0, 6.0],
-        },
-        {
-            "title": "Data Science",
-            "content": "statistical analysis methods",
-            "embedding": [2.0, 3.0, 4.0, 5.0, 6.0, 7.0],
-        },
-        {
-            "title": "Deep Learning",
-            "content": "neural network architectures",
-            "embedding": [3.0, 4.0, 5.0, 6.0, 7.0, 8.0],
-        },
-        {
-            "title": "Computer Vision",
-            "content": "image processing techniques",
-            "embedding": [10.0, 11.0, 12.0, 13.0, 14.0, 15.0],
-        },
-    ]
-
-    for i, doc in enumerate(docs):
-        client.hset(
-            f"doc{i}",
-            mapping={
-                "title": doc["title"],
-                "content": doc["content"],
-                "embedding": np.array(doc["embedding"], dtype=np.float32).tobytes(),
-            },
+        vsim_query.vsim_method_params(VectorSearchMethods.KNN, K=1000)
+        vsim_query.filter(
+            HybridFilter(
+                "((@price:[15 16] @size:[10 11]) | (@price:[13 15] @size:[11 12])) @description:(shoes) -@description:(green)"
+            )
         )
 
-    # Hybrid query - text filter + vector similarity
-    query = "(@title:AI|@content:machine)=>[KNN 2 @embedding $vec]"
-    q = (
-        Query(query)
-        .return_field("__embedding_score")
-        .sort_by("__embedding_score", True)
-    )
-    res = client.ft().search(
-        q,
-        query_params={
-            "vec": np.array([1.0, 2.0, 3.0, 4.0, 5.0, 6.0], dtype=np.float32).tobytes()
-        },
-    )
+        hybrid_query = HybridQuery(search_query, vsim_query)
 
-    if is_resp2_connection(client):
-        assert res.total >= 1
-        doc_ids = [doc.id for doc in res.docs]
-        assert "doc0" in doc_ids
-    else:
-        assert res["total_results"] >= 1
-        doc_ids = [doc["id"] for doc in res["results"]]
-        assert "doc0" in doc_ids
-
-
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_large_dimension_vectors(client):
-    client.flushdb()
-    client.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {
-                    "TYPE": "FLOAT32",
-                    "DIM": 512,
-                    "DISTANCE_METRIC": "L2",
-                    "CONSTRUCTION_WINDOW_SIZE": 300,
-                    "GRAPH_MAX_DEGREE": 64,
-                },
-            ),
+        combine_method = CombineResultsMethod(CombinationMethods.RRF, WINDOW=1000)
+
+        timeout = 5000  # 5 second timeout
+        res = client.ft().hybrid_search(
+            query=hybrid_query, combine_method=combine_method, timeout=timeout
         )
-    )
 
-    vectors = []
-    for i in range(10):
-        vec = [float(i + j) for j in range(512)]
-        vectors.append(vec)
-        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+        if is_resp2_connection(client):
+            assert len(res.results) > 0
+            assert res.warnings == []
+            assert res.execution_time > 0 and res.execution_time < timeout
+        else:
+            assert len(res["results"]) > 0
+            assert res["warnings"] == []
+            assert res["execution_time"] > 0 and res["execution_time"] < timeout
 
-    query = Query("*=>[KNN 5 @v $vec as score]").no_content()
-    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+        res = client.ft().hybrid_search(query=hybrid_query, timeout=1)  # 1 ms timeout
+        if is_resp2_connection(client):
+            assert (
+                b"Timeout limit was reached (VSIM)" in res.warnings
+                or b"Timeout limit was reached (SEARCH)" in res.warnings
+            )
+        else:
+            assert (
+                "Timeout limit was reached (VSIM)" in res["warnings"]
+                or "Timeout limit was reached (SEARCH)" in res["warnings"]
+            )
 
-    res = client.ft().search(query, query_params=query_params)
-    if is_resp2_connection(client):
-        assert res.total == 5
-        assert "doc0" == res.docs[0].id
-    else:
-        assert res["total_results"] == 5
-        assert "doc0" == res["results"][0]["id"]
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    def test_hybrid_search_query_with_load_and_groupby(self, client):
+        # Create index and add data
+        self._create_hybrid_search_index(client)
+        self._add_data_for_hybrid_search(client, items_sets=10)
 
+        # set search query
+        search_query = HybridSearchQuery("@color:{red|green}")
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_training_threshold_behavior(client):
-    client.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {
-                    "TYPE": "FLOAT32",
-                    "DIM": 8,
-                    "DISTANCE_METRIC": "L2",
-                    "COMPRESSION": "LVQ8",
-                    "TRAINING_THRESHOLD": 1024,
-                },
-            ),
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 7, 6], dtype=np.float32).tobytes(),
         )
-    )
 
-    vectors = []
-    for i in range(20):
-        vec = [float(i + j) for j in range(8)]
-        vectors.append(vec)
-        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+        hybrid_query = HybridQuery(search_query, vsim_query)
 
-        if i >= 5:
-            query = Query("*=>[KNN 3 @v $vec as score]").no_content()
-            query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
-            res = client.ft().search(query, query_params=query_params)
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.load("@color", "@price", "@size", "@item_type")
+        postprocessing_config.limit(0, 4)
 
-            if is_resp2_connection(client):
-                assert res.total >= 1
-            else:
-                assert res["total_results"] >= 1
+        postprocessing_config.group_by(
+            ["@item_type", "@price"],
+            reducers.count_distinct("@color").alias("colors_count"),
+            reducers.min("@size"),
+        )
 
+        postprocessing_config.sort_by(SortbyField("@price", asc=True))
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_different_k_values(client):
-    client.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {
-                    "TYPE": "FLOAT32",
-                    "DIM": 6,
-                    "DISTANCE_METRIC": "L2",
-                    "SEARCH_WINDOW_SIZE": 15,
-                },
-            ),
+        res = client.ft().hybrid_search(
+            query=hybrid_query, post_processing=postprocessing_config, timeout=10
         )
-    )
 
-    vectors = []
-    for i in range(25):
-        vec = [float(i + j) for j in range(6)]
-        vectors.append(vec)
-        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
-
-    for k in [1, 3, 5, 10, 15]:
-        query = Query(f"*=>[KNN {k} @v $vec as score]").no_content()
-        query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
-        res = client.ft().search(query, query_params=query_params)
+        expected_results = [
+            {
+                "item_type": b"dress",
+                "price": b"15",
+                "colors_count": b"1",
+                "__generated_aliasminsize": b"10",
+            },
+            {
+                "item_type": b"shoes",
+                "price": b"15",
+                "colors_count": b"2",
+                "__generated_aliasminsize": b"10",
+            },
+            {
+                "item_type": b"shoes",
+                "price": b"16",
+                "colors_count": b"2",
+                "__generated_aliasminsize": b"10",
+            },
+            {
+                "item_type": b"dress",
+                "price": b"16",
+                "colors_count": b"1",
+                "__generated_aliasminsize": b"11",
+            },
+        ]
 
         if is_resp2_connection(client):
-            assert res.total == k
-            assert "doc0" == res.docs[0].id
+            assert len(res.results) == 4
+            assert res.results == expected_results
+            assert res.warnings == []
         else:
-            assert res["total_results"] == k
-            assert "doc0" == res["results"][0]["id"]
+            assert len(res["results"]) == 4
+            assert res["results"] == self._convert_dict_values_to_str(expected_results)
+            assert res["warnings"] == []
+
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.load("@color", "@price", "@size", "@item_type")
+        postprocessing_config.limit(0, 6)
+        postprocessing_config.sort_by(
+            SortbyField("@price", asc=True),
+            SortbyField("@item_type", asc=True),
+        )
 
+        postprocessing_config.group_by(
+            ["@price", "@item_type"],
+            reducers.count_distinct("@color").alias("unique_colors_count"),
+        )
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_vector_field_error(client):
-    # sortable tag
-    with pytest.raises(Exception):
-        client.ft().create_index((VectorField("v", "SVS-VAMANA", {}, sortable=True),))
+        res = client.ft().hybrid_search(
+            query=hybrid_query, post_processing=postprocessing_config, timeout=1000
+        )
 
-    # no_index tag
-    with pytest.raises(Exception):
-        client.ft().create_index((VectorField("v", "SVS-VAMANA", {}, no_index=True),))
+        expected_results = [
+            {"price": b"15", "item_type": b"dress", "unique_colors_count": b"1"},
+            {"price": b"15", "item_type": b"shoes", "unique_colors_count": b"2"},
+            {"price": b"16", "item_type": b"dress", "unique_colors_count": b"1"},
+            {"price": b"16", "item_type": b"shoes", "unique_colors_count": b"2"},
+            {"price": b"17", "item_type": b"dress", "unique_colors_count": b"1"},
+            {"price": b"17", "item_type": b"shoes", "unique_colors_count": b"2"},
+        ]
+        if is_resp2_connection(client):
+            assert len(res.results) == 6
+            assert res.results == expected_results
+            assert res.warnings == []
+        else:
+            assert len(res["results"]) == 6
+            assert res["results"] == self._convert_dict_values_to_str(expected_results)
+            assert res["warnings"] == []
+
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    def test_hybrid_search_query_with_cursor(self, client):
+        # Create index and add data
+        self._create_hybrid_search_index(client)
+        self._add_data_for_hybrid_search(client, items_sets=10)
+
+        # set search query
+        search_query = HybridSearchQuery("@color:{red|green}")
+
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 7, 6], dtype=np.float32).tobytes(),
+        )
 
+        hybrid_query = HybridQuery(search_query, vsim_query)
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_vector_search_with_parameters(client):
-    client.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {
-                    "TYPE": "FLOAT32",
-                    "DIM": 4,
-                    "DISTANCE_METRIC": "L2",
-                    "CONSTRUCTION_WINDOW_SIZE": 200,
-                    "GRAPH_MAX_DEGREE": 64,
-                    "SEARCH_WINDOW_SIZE": 40,
-                    "EPSILON": 0.01,
-                },
-            ),
+        res = client.ft().hybrid_search(
+            query=hybrid_query,
+            cursor=HybridCursorQuery(count=5, max_idle=100),
+            timeout=10,
         )
-    )
-
-    # Create test vectors
-    vectors = [
-        [1.0, 2.0, 3.0, 4.0],
-        [2.0, 3.0, 4.0, 5.0],
-        [3.0, 4.0, 5.0, 6.0],
-        [4.0, 5.0, 6.0, 7.0],
-        [5.0, 6.0, 7.0, 8.0],
-    ]
+        if is_resp2_connection(client):
+            assert isinstance(res, HybridCursorResult)
+            assert res.search_cursor_id > 0
+            assert res.vsim_cursor_id > 0
+            search_cursor = aggregations.Cursor(res.search_cursor_id)
+            vsim_cursor = aggregations.Cursor(res.vsim_cursor_id)
+        else:
+            assert res["SEARCH"] > 0
+            assert res["VSIM"] > 0
+            search_cursor = aggregations.Cursor(res["SEARCH"])
+            vsim_cursor = aggregations.Cursor(res["VSIM"])
 
-    for i, vec in enumerate(vectors):
-        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+        search_res_from_cursor = client.ft().aggregate(query=search_cursor)
+        if is_resp2_connection(client):
+            assert len(search_res_from_cursor.rows) == 5
+        else:
+            assert len(search_res_from_cursor[0]["results"]) == 5
 
-    query = Query("*=>[KNN 3 @v $vec as score]").no_content()
-    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+        vsim_res_from_cursor = client.ft().aggregate(query=vsim_cursor)
+        if is_resp2_connection(client):
+            assert len(vsim_res_from_cursor.rows) == 5
+        else:
+            assert len(vsim_res_from_cursor[0]["results"]) == 5
 
-    res = client.ft().search(query, query_params=query_params)
-    if is_resp2_connection(client):
-        assert res.total == 3
-        assert "doc0" == res.docs[0].id
-    else:
-        assert res["total_results"] == 3
-        assert "doc0" == res["results"][0]["id"]
+    @pytest.mark.redismod
+    @skip_if_server_version_lt("8.3.224")
+    def test_hybrid_search_query_with_multiple_loads_and_applies(self, client):
+        # Create index and add data
+        self._create_hybrid_search_index(client)
+        self._add_data_for_hybrid_search(client, items_sets=1)
 
+        # set search query
+        search_query = HybridSearchQuery("@color:{red|green}")
 
-@pytest.mark.redismod
-@skip_ifmodversion_lt("2.4.3", "search")
-@skip_if_server_version_lt("8.1.224")
-def test_svs_vamana_vector_search_with_parameters_leanvec(client):
-    client.ft().create_index(
-        (
-            VectorField(
-                "v",
-                "SVS-VAMANA",
-                {
-                    "TYPE": "FLOAT32",
-                    "DIM": 8,
-                    "DISTANCE_METRIC": "L2",
-                    "COMPRESSION": "LeanVec8x8",  # LeanVec compression required for REDUCE
-                    "CONSTRUCTION_WINDOW_SIZE": 200,
-                    "GRAPH_MAX_DEGREE": 32,
-                    "SEARCH_WINDOW_SIZE": 15,
-                    "EPSILON": 0.01,
-                    "TRAINING_THRESHOLD": 1024,
-                    "REDUCE": 4,  # Half of DIM (8/2 = 4)
-                },
-            ),
+        vsim_query = HybridVsimQuery(
+            vector_field_name="@embedding",
+            vector_data=np.array([1, 2, 7, 6], dtype=np.float32).tobytes(),
         )
-    )
-
-    # Create test vectors (8-dimensional to match DIM)
-    vectors = [
-        [1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0],
-        [2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0],
-        [3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0],
-        [4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0, 11.0],
-        [5.0, 6.0, 7.0, 8.0, 9.0, 10.0, 11.0, 12.0],
-    ]
 
-    for i, vec in enumerate(vectors):
-        client.hset(f"doc{i}", "v", np.array(vec, dtype=np.float32).tobytes())
+        hybrid_query = HybridQuery(search_query, vsim_query)
 
-    query = Query("*=>[KNN 3 @v $vec as score]").no_content()
-    query_params = {"vec": np.array(vectors[0], dtype=np.float32).tobytes()}
+        postprocessing_config = HybridPostProcessingConfig()
+        postprocessing_config.load("@color", "@price")
+        postprocessing_config.load("@description")
+        postprocessing_config.apply(discount_10_percents="@price - (@price * 0.1)")
+        postprocessing_config.apply(
+            additional_discount="@discount_10_percents - (@discount_10_percents * 0.1)"
+        )
+        postprocessing_config.filter(HybridFilter('@price=="15"'))
+        postprocessing_config.load("@description")
+        postprocessing_config.sort_by(
+            SortbyField("@discount_10_percents", asc=False),
+            SortbyField("@color", asc=True),
+        )
+        postprocessing_config.limit(0, 5)
 
-    res = client.ft().search(query, query_params=query_params)
-    if is_resp2_connection(client):
-        assert res.total == 3
-        assert "doc0" == res.docs[0].id
-    else:
-        assert res["total_results"] == 3
-        assert "doc0" == res["results"][0]["id"]
+        res = client.ft().hybrid_search(
+            query=hybrid_query, post_processing=postprocessing_config, timeout=10
+        )
+        print(res)
+        if is_resp2_connection(client):
+            assert len(res.results) == 2
+            for item in res.results:
+                assert item["color"] is not None
+                assert item["price"] is not None
+                assert item["description"] is not None
+                assert item["discount_10_percents"] is not None
+                assert item["additional_discount"] is not None
+        else:
+            assert len(res["results"]) == 2
+            for item in res["results"]:
+                assert item["color"] is not None
+                assert item["price"] is not None
+                assert item["description"] is not None
+                assert item["discount_10_percents"] is not None
+                assert item["additional_discount"] is not None
diff --git a/tests/test_vsets.py b/tests/test_vsets.py
index 6376eeb898..bb1ed269a0 100644
--- a/tests/test_vsets.py
+++ b/tests/test_vsets.py
@@ -453,23 +453,23 @@ def test_vsim_with_filter(d_client):
 
 @skip_if_server_version_lt("7.9.0")
 def test_vsim_truth_no_thread_enabled(d_client):
-    elements_count = 5000
+    elements_count = 1000
     vector_dim = 50
     for i in range(1, elements_count + 1):
-        float_array = [i for _ in range(vector_dim)]
+        float_array = [i * vector_dim for _ in range(vector_dim)]
         d_client.vset().vadd("myset", float_array, f"elem_{i}")
 
     d_client.vset().vadd("myset", [-22 for _ in range(vector_dim)], "elem_man_2")
 
     sim_without_truth = d_client.vset().vsim(
-        "myset", input="elem_man_2", with_scores=True
+        "myset", input="elem_man_2", with_scores=True, count=30
     )
     sim_truth = d_client.vset().vsim(
-        "myset", input="elem_man_2", with_scores=True, truth=True
+        "myset", input="elem_man_2", with_scores=True, count=30, truth=True
     )
 
-    assert len(sim_without_truth) == 10
-    assert len(sim_truth) == 10
+    assert len(sim_without_truth) == 30
+    assert len(sim_truth) == 30
 
     assert isinstance(sim_without_truth, dict)
     assert isinstance(sim_truth, dict)

From f026c1e66be68dc18d89e60bd54c5032bd927680 Mon Sep 17 00:00:00 2001
From: petyaslavova <petya.slavova@redis.com>
Date: Thu, 13 Nov 2025 14:58:40 +0200
Subject: [PATCH 1164/1164] Adding latest 8.4 image to test matrix. Updating
 the Hybrid VSIM query format to be in sync with spec after srv issue was
 fixed. (#3843)

---
 .github/workflows/integration.yaml    |  2 +-
 redis/commands/search/hybrid_query.py | 14 ++++++++++++--
 tests/test_asyncio/test_search.py     |  7 ++-----
 tests/test_search.py                  | 14 ++++----------
 4 files changed, 19 insertions(+), 18 deletions(-)

diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index 9971cf103c..cb614d499e 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -76,7 +76,7 @@ jobs:
       max-parallel: 15
       fail-fast: false
       matrix:
-        redis-version: ['8.4-RC1-pre.2', '${{ needs.redis_version.outputs.CURRENT }}', '8.0.2' ,'7.4.4', '7.2.9']
+        redis-version: ['8.4-GA-pre.2', '${{ needs.redis_version.outputs.CURRENT }}', '8.0.2' ,'7.4.4', '7.2.9']
         python-version: ['3.10', '3.14']
         parser-backend: ['plain']
         event-loop: ['asyncio']
diff --git a/redis/commands/search/hybrid_query.py b/redis/commands/search/hybrid_query.py
index 1607f1ded2..3b072082b2 100644
--- a/redis/commands/search/hybrid_query.py
+++ b/redis/commands/search/hybrid_query.py
@@ -77,6 +77,7 @@ def __init__(
         vsim_search_method: Optional[VectorSearchMethods] = None,
         vsim_search_method_params: Optional[Dict[str, Any]] = None,
         filter: Optional["Filter"] = None,
+        yield_score_as: Optional[str] = None,
     ) -> None:
         """
         Create a new hybrid vsim query object.
@@ -96,8 +97,7 @@ def __init__(
                 Example for RANGE: {"RADIUS": 10, "EPSILON": 0.1}
                                     where RADIUS is mandatory and defines the radius of the search
                                     and EPSILON is optional and defines the accuracy of the search.
-                For both KNN and RANGE, the following parameter is optional:
-                    YIELD_SCORE_AS: The name of the field to yield the calculated score as.
+            yield_score_as: The name of the field to yield the score as.
 
             filter: If defined, a filter will be applied on the vsim query results.
         """
@@ -108,6 +108,7 @@ def __init__(
         else:
             self._vsim_method_params = None
         self._filter = filter
+        self._yield_score_as = yield_score_as
 
     def vector_field(self) -> str:
         """Return the vector field name of this query object."""
@@ -149,12 +150,21 @@ def filter(self, flt: "HybridFilter") -> "HybridVsimQuery":
         self._filter = flt
         return self
 
+    def yield_score_as(self, alias: str) -> "HybridVsimQuery":
+        """
+        Return the score as a field with name `alias`.
+        """
+        self._yield_score_as = alias
+        return self
+
     def get_args(self) -> List[str]:
         args = ["VSIM", self._vector_field, self._vector_data]
         if self._vsim_method_params:
             args.extend(self._vsim_method_params)
         if self._filter:
             args.extend(self._filter.args)
+        if self._yield_score_as:
+            args.extend(("YIELD_SCORE_AS", self._yield_score_as))
 
         return args
 
diff --git a/tests/test_asyncio/test_search.py b/tests/test_asyncio/test_search.py
index f4b26ae82c..276c8a37c8 100644
--- a/tests/test_asyncio/test_search.py
+++ b/tests/test_asyncio/test_search.py
@@ -2636,11 +2636,8 @@ async def test_hybrid_search_query_with_combine_all_score_aliases(self, decoded_
             vector_field_name="@embedding-hnsw",
             vector_data="abcd1234efgh5678",
             vsim_search_method=VectorSearchMethods.KNN,
-            vsim_search_method_params={
-                "K": 3,
-                "EF_RUNTIME": 1,
-                "YIELD_SCORE_AS": "vsim_score",
-            },
+            vsim_search_method_params={"K": 3, "EF_RUNTIME": 1},
+            yield_score_as="vsim_score",
         )
 
         hybrid_query = HybridQuery(search_query, vsim_query)
diff --git a/tests/test_search.py b/tests/test_search.py
index 27f97d8ca8..1b12dc45fc 100644
--- a/tests/test_search.py
+++ b/tests/test_search.py
@@ -4347,11 +4347,8 @@ def test_hybrid_search_query_with_vsim_score_aliases(self, client):
             vector_field_name="@embedding-hnsw",
             vector_data="abcd1234efgh5678",
             vsim_search_method=VectorSearchMethods.KNN,
-            vsim_search_method_params={
-                "K": 3,
-                "EF_RUNTIME": 1,
-                "YIELD_SCORE_AS": "vsim_score",
-            },
+            vsim_search_method_params={"K": 3, "EF_RUNTIME": 1},
+            yield_score_as="vsim_score",
         )
 
         hybrid_query = HybridQuery(search_query, vsim_query)
@@ -4433,11 +4430,8 @@ def test_hybrid_search_query_with_combine_all_score_aliases(self, client):
             vector_field_name="@embedding-hnsw",
             vector_data="abcd1234efgh5678",
             vsim_search_method=VectorSearchMethods.KNN,
-            vsim_search_method_params={
-                "K": 3,
-                "EF_RUNTIME": 1,
-                "YIELD_SCORE_AS": "vsim_score",
-            },
+            vsim_search_method_params={"K": 3, "EF_RUNTIME": 1},
+            yield_score_as="vsim_score",
         )
 
         hybrid_query = HybridQuery(search_query, vsim_query)